Skip to content

Deprecate ai, openai, mcpplugin, and a2a packages#406

Merged
heyitsaamir merged 2 commits into
mainfrom
deprecate/ai-mcp-a2a-openai-packages
Apr 25, 2026
Merged

Deprecate ai, openai, mcpplugin, and a2a packages#406
heyitsaamir merged 2 commits into
mainfrom
deprecate/ai-mcp-a2a-openai-packages

Conversation

@heyitsaamir

Copy link
Copy Markdown
Collaborator

Summary

  • These packages were in preview but we've decided to stop maintaining them before GA
  • Added [!WARNING] deprecation banners to each package's README with links to recommended replacements
  • Added runtime DeprecationWarning on import so users get notified in their terminal
  • Added Development Status :: 7 - Inactive trove classifier to each pyproject.toml

Recommended replacements:

Test plan

  • poe check passes (ruff + format)
  • pyright passes
  • Verify deprecation warnings show when importing any of the four packages
  • Verify README banners render correctly on GitHub

These packages were in preview but won't be maintained to GA.
Added README warnings, runtime DeprecationWarnings on import,
and "Development Status :: 7 - Inactive" classifiers pointing
users to the recommended replacements.

Co-Authored-By: Claude <[email protected]>
Copilot AI review requested due to automatic review settings April 24, 2026 23:57

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR deprecates the preview microsoft-teams-ai, microsoft-teams-openai, microsoft-teams-mcpplugin, and microsoft-teams-a2a packages by adding user-facing deprecation notices in docs, runtime import warnings, and packaging metadata to signal inactive status.

Changes:

  • Added import-time deprecation warnings to each package’s __init__.py.
  • Added [!WARNING] deprecation banners to each package README with links to recommended replacements.
  • Added Development Status :: 7 - Inactive trove classifier to each affected package’s pyproject.toml.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
packages/openai/src/microsoft_teams/openai/init.py Emits a deprecation warning on import for microsoft-teams-openai.
packages/openai/pyproject.toml Marks package as inactive via trove classifier.
packages/openai/README.md Adds a deprecation banner and replacement guidance.
packages/mcpplugin/src/microsoft_teams/mcpplugin/init.py Emits a deprecation warning on import for microsoft-teams-mcpplugin.
packages/mcpplugin/pyproject.toml Marks package as inactive via trove classifier.
packages/mcpplugin/README.md Adds a deprecation banner and replacement guidance.
packages/ai/src/microsoft_teams/ai/init.py Emits a deprecation warning on import for microsoft-teams-ai.
packages/ai/pyproject.toml Marks package as inactive via trove classifier.
packages/ai/README.md Adds a deprecation banner and replacement guidance.
packages/a2aprotocol/src/microsoft_teams/a2a/init.py Emits a deprecation warning on import for microsoft-teams-a2a.
packages/a2aprotocol/pyproject.toml Marks package as inactive via trove classifier.
packages/a2aprotocol/README.md Adds a deprecation banner and replacement guidance.

Comment thread packages/mcpplugin/src/microsoft_teams/mcpplugin/__init__.py
Comment thread packages/ai/src/microsoft_teams/ai/__init__.py
Comment thread packages/ai/src/microsoft_teams/ai/__init__.py
Comment thread packages/a2aprotocol/src/microsoft_teams/a2a/__init__.py
Comment thread packages/openai/src/microsoft_teams/openai/__init__.py
Comment thread packages/openai/src/microsoft_teams/openai/__init__.py
Comment thread packages/mcpplugin/src/microsoft_teams/mcpplugin/__init__.py
Switched from DeprecationWarning to FutureWarning so warnings
are visible by default. Updated Agent Framework link to official
Microsoft Learn docs.

Co-Authored-By: Claude <[email protected]>
@heyitsaamir
heyitsaamir merged commit 28c7439 into main Apr 25, 2026
7 checks passed
@heyitsaamir
heyitsaamir deleted the deprecate/ai-mcp-a2a-openai-packages branch April 25, 2026 00:09
heyitsaamir pushed a commit that referenced this pull request Apr 29, 2026
follow-up to the deprecations in #406 and #410: 

- fully delete the 5 packages along with their workspace, pyright, and
ADO publish wiring
- refresh the package lists in README, CLAUDE.md, copilot-instructions,
and RELEASE.md.

Co-authored-by: lilydu <[email protected]>
Co-authored-by: Claude Opus 4.7 (1M context) <[email protected]>
corinagum added a commit that referenced this pull request May 27, 2026
## Summary

Brings `origin/main` into `release` for the **2.0.12** release. **No
carve-outs this time** — Quoted Replies (PR #321) is included.

`version.json`: `2.0.11` → `2.0.12`.

Aligns with teams.ts/teams.net cadence.

## What's in this release (delta from 2.0.11)

**Features**
- Quoted Replies & new quotes features (#321) — previously held back
- SuggestedActionSubmitActivity for `suggestedAction/submit` invoke
(#434)
- Default targeted replies for targeted inbound messages (#439)
- Reactions API marked GA (#427) — already shipped in 2.0.11 actually,
ignore if duplicate
- Prompt Preview support (#397)
- Sample: opt targeted-messages into slash commands (#430)
- Sample: a2a-in-teams (#401)
- Sample: proactive message update (#405)
- Allow custom HTTP client via `AppOptions` (#416)

**Security & fixes**
- Lock JsonWebToken trust-boundary contract (#432)
- Bump starlette 1.0.0 -> 1.1.0 for PYSEC-2026-161 / BadHost (#441)
- warn when bot starts without credentials (#435)
- fix(apps): support AAD v1 issuers in Entra token validation (#422)
- fix(apps): log inbound activities at info, warn on missing
Authorization (#425)
- fix(http-stream): wait for in-flight flush before sending final close
(#419)
- Mark reactions API as GA and fix sample remove flow (#427)
- Revert serviceUrl allowlist (ADO 5310460) (#415)
- Route `app.get_app_graph` + `ctx.*_graph` to sovereign endpoints via
`cloud.graph_scope` (#402)

**Deprecations / package changes**
- Remove ai, openai, mcpplugin, a2a, and devtools packages (#413)
- Restore and deprecate devtools package (#410)
- Deprecate ai, openai, mcpplugin, a2a packages (#406)
- Add agent framework example, remove chatprompt/mcp client samples
(#386)

**Dependency bumps**
- urllib3 2.6.3 → 2.7.0 (#426)
- python-multipart 0.0.26 → 0.0.27 (#424)
- microsoft-kiota-http 1.9.7 → 1.9.9 (#423)
- idna 3.11 → 3.15 (#431)
- starlette 1.0.0 → 1.1.0 (#441, security)
- /examples/tab/Web: qs, postcss, uuid, follow-redirects bumps

## Quoted Replies inclusion notes

- Teams client rendering is in-sync with the wire format as of
2026-05-06.
- APX QR rollout completed: Public 2026-04-10, GCCH/DoD/Gallatin
2026-04-14.
- Builder methods (`prepend_quote()`, `add_quote()`), `ctx.quote()`, and
the quote-aware `ctx.reply()` behavior are all present in this release.
- `examples/quoting` is included.

## Conflict resolution

The 2.0.11 release branch had the QR-removed shape for four files; took
`main`'s (QR-included) version for all of them:
- `examples/targeted-messages/src/main.py`
- `packages/api/src/microsoft_teams/api/activities/message/message.py`
- `packages/apps/src/microsoft_teams/apps/routing/activity_context.py`
- `packages/apps/tests/test_activity_context.py`

`version.json` conflict resolved to `2.0.12`.

## Test plan

- [x] `uv sync` clean
- [x] `poe check` (ruff format + lint) — clean
- [x] `poe test` — 609 passed
- [x] `pyright` — 0 errors, 0 warnings
- [ ] Pipeline build + test stages green on `release` after merge
- [ ] Publish pipeline run with **Public** → ESRP approval → PyPI
- [ ] `pip install microsoft-teams-apps==2.0.12` smoke install

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: Aamir Jawaid <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
Co-authored-by: Shanmathi Mayuram Krithivasan <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants