b55992bb67
Selective, CHANGELOG-driven version bumps for the 2026-06-18 release. Released tier: agent-framework-core and the root agent-framework go to 1.9.0 (minor). Core ships new public APIs (agent-loop middleware, tool-approval middleware and harness integration, shell-tool harness integration, AG-UI thread snapshot persistence, context-provider telemetry) plus two behavioral breaking changes on evolving surfaces: MCP sampling now denies server-initiated requests by default, and the FileAccess tools were aligned with the .NET implementation. These are treated as within-1.x changes because every package caps core at <2; a major bump would require rewriting those caps. The foundry and openai packages go to 1.8.2 (patch, bug fixes only). The root agent-framework-core[all] pin was moved to 1.9.0 in lockstep with core. Release-candidate tier: ag-ui to 1.0.0rc5 and declarative to 1.0.0rc2 for their respective changes. orchestrations is promoted to stable 1.0.0; PACKAGE_STATUS and the README install hint were updated accordingly. Prerelease tier (new Pacific date stamp 260618): anthropic (beta), azure-contentunderstanding (alpha) and foundry-hosting (alpha). No beta cohort bump was applied; only packages with changes this cycle were stamped. Dependency floors: following the established convention, the core floor was raised to >=1.9.0 on every non-core package bumped this cycle, preserving the existing <2 upper bound. Also resolves two pre-existing failures in the dependency-bounds validator that are unrelated to the version bumps. Hosted-environment detection now catches a bare ImportError so optional Foundry hosting probing cannot crash user-agent setup. The harness shell-tool integration, which lazily imports the separate agent-framework-tools package to avoid a circular runtime dependency, is now type-checked and tested in isolated environments via a core dev dependency-group, with the shell-tool tests guarded to skip when that package is absent.
84 lines
4.5 KiB
Markdown
84 lines
4.5 KiB
Markdown
# Python Package Status
|
|
|
|
This file tracks the current lifecycle state of the Python packages in this workspace. Some packages at later stages might have features within them that are not ready yet, these have feature stage decorators on the relevant APIs, and for `experimental` features warnings are raised. See the [Feature-level staged APIs](#feature-level-staged-apis) section below for details on which features are in which stage and where to find them.
|
|
|
|
Status is grouped into these buckets:
|
|
|
|
- `alpha` - initial release and early development packages that are not yet ready for general use
|
|
- `beta` - prerelease packages that are not currently release candidates
|
|
- `rc` - release candidate packages, these are close to ready for release but may still have some breaking changes before the final release
|
|
- `released` - stable packages without a prerelease suffix, these are stable packages that should not have breaking changes between versions
|
|
- `deprecated` - removed or deprecated packages that should not be used for new work
|
|
|
|
## Current packages
|
|
|
|
| Package | Path | State |
|
|
| --- | --- | --- |
|
|
| `agent-framework` | `python/` | `released` |
|
|
| `agent-framework-a2a` | `python/packages/a2a` | `beta` |
|
|
| `agent-framework-ag-ui` | `python/packages/ag-ui` | `rc` |
|
|
| `agent-framework-anthropic` | `python/packages/anthropic` | `beta` |
|
|
| `agent-framework-azure-contentunderstanding` | `python/packages/azure-contentunderstanding` | `alpha` |
|
|
| `agent-framework-azure-ai-search` | `python/packages/azure-ai-search` | `beta` |
|
|
| `agent-framework-azure-cosmos` | `python/packages/azure-cosmos` | `beta` |
|
|
| `agent-framework-azurefunctions` | `python/packages/azurefunctions` | `beta` |
|
|
| `agent-framework-bedrock` | `python/packages/bedrock` | `beta` |
|
|
| `agent-framework-chatkit` | `python/packages/chatkit` | `beta` |
|
|
| `agent-framework-claude` | `python/packages/claude` | `beta` |
|
|
| `agent-framework-copilotstudio` | `python/packages/copilotstudio` | `beta` |
|
|
| `agent-framework-core` | `python/packages/core` | `released` |
|
|
| `agent-framework-declarative` | `python/packages/declarative` | `rc` |
|
|
| `agent-framework-devui` | `python/packages/devui` | `beta` |
|
|
| `agent-framework-durabletask` | `python/packages/durabletask` | `beta` |
|
|
| `agent-framework-foundry` | `python/packages/foundry` | `released` |
|
|
| `agent-framework-foundry-local` | `python/packages/foundry_local` | `beta` |
|
|
| `agent-framework-gemini` | `python/packages/gemini` | `alpha` |
|
|
| `agent-framework-github-copilot` | `python/packages/github_copilot` | `rc` |
|
|
| `agent-framework-hyperlight` | `python/packages/hyperlight` | `beta` |
|
|
| `agent-framework-lab` | `python/packages/lab` | `beta` |
|
|
| `agent-framework-mem0` | `python/packages/mem0` | `beta` |
|
|
| `agent-framework-mistral` | `python/packages/mistral` | `alpha` |
|
|
| `agent-framework-monty` | `python/packages/monty` | `alpha` |
|
|
| `agent-framework-ollama` | `python/packages/ollama` | `beta` |
|
|
| `agent-framework-openai` | `python/packages/openai` | `released` |
|
|
| `agent-framework-orchestrations` | `python/packages/orchestrations` | `released` |
|
|
| `agent-framework-purview` | `python/packages/purview` | `beta` |
|
|
| `agent-framework-redis` | `python/packages/redis` | `beta` |
|
|
|
|
## Deprecated / removed packages
|
|
|
|
| Package | Previous path | State | Notes |
|
|
| --- | --- | --- | --- |
|
|
| `agent-framework-azure-ai` | `python/packages/azure-ai` | `deprecated` | The client classes within the `azure-ai` package were renamed, sometimes changed, and moved to `agent-framework-foundry`. |
|
|
|
|
## Feature-level staged APIs
|
|
|
|
The following feature IDs have explicit feature-stage decorators on public APIs in the packages
|
|
listed below.
|
|
|
|
### Experimental features
|
|
|
|
#### `DECLARATIVE_AGENTS`
|
|
|
|
- `agent-framework-declarative`: declarative agent loading APIs from
|
|
`agent_framework_declarative`, including `AgentFactory`,
|
|
`DeclarativeLoaderError`, `ProviderLookupError`, and `ProviderTypeMapping`
|
|
from `agent_framework_declarative/_loader.py`
|
|
|
|
#### `EVALS`
|
|
|
|
- `agent-framework-core`: exported evaluation APIs from `agent_framework`, including
|
|
`LocalEvaluator`, `evaluate_agent`, `evaluate_workflow`, and the related evaluation types and
|
|
helper checks defined in `agent_framework/_evaluation.py`
|
|
- `agent-framework-foundry`: `FoundryEvals`, `evaluate_traces`, and `evaluate_foundry_target`
|
|
|
|
#### `SKILLS`
|
|
|
|
- `agent-framework-core`: exported skills APIs from `agent_framework`, including `Skill`,
|
|
`SkillResource`, `SkillScript`, `SkillScriptRunner`, and `SkillsProvider` from
|
|
`agent_framework/_skills.py`
|
|
|
|
### Release-candidate features
|
|
|
|
There are currently no feature-level `rc` APIs.
|