diff --git a/python/CHANGELOG.md b/python/CHANGELOG.md index 8f65d561389..8faae3f090b 100644 --- a/python/CHANGELOG.md +++ b/python/CHANGELOG.md @@ -19,9 +19,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - **agent-framework-github-copilot**: [BREAKING] Require GitHub Copilot CLI 1.0.85 or later and fail startup when its version is older or cannot be determined ([#10156](https://github.com/microsoft/agent-framework/pull/10156)) **Migration:** Upgrade custom runtimes selected by `cli_path`, `GITHUB_COPILOT_CLI_PATH`, or `COPILOT_CLI_PATH` to CLI 1.0.85 or later. Default SDK installations already meet this minimum: the existing SDK floor, 1.0.16, bundles CLI 1.0.90. This integration releases as 2.2.0 with the additive structured-output support. -- **agent-framework-hyperlight**: [BREAKING] Interrupt cancelled guest execution and apply a finite 30-second execution budget by default, using the released Hyperlight SDK 0.9.0 interruption API ([#10152](https://github.com/microsoft/agent-framework/pull/10152)) +- **agent-framework-hyperlight**: [BREAKING] Interrupt cancelled guest execution and apply a finite 30-second execution budget by default, using the Hyperlight SDK interruption API ([#10152](https://github.com/microsoft/agent-framework/pull/10152)) - **Migration:** Set a larger positive, finite `execution_timeout_seconds` on `HyperlightCodeActProvider` or `HyperlightExecuteCodeTool` when workloads need more than 30 seconds. Timeouts return error content; caller cancellation propagates `asyncio.CancelledError`. Runtime initialization and host callbacks cannot be interrupted and must enforce their own limits. + **Migration:** Guest execution requires an SDK that provides `Sandbox.interrupt_handle()`, documented for Hyperlight SDK 0.9.0 or later. Installation permits SDK 0.8.0 but does not add a fallback for older SDKs. Set a larger positive, finite `execution_timeout_seconds` on `HyperlightCodeActProvider` or `HyperlightExecuteCodeTool` when workloads need more than 30 seconds. Timeouts return error content; caller cancellation propagates `asyncio.CancelledError`. Runtime initialization and host callbacks cannot be interrupted and must enforce their own limits. - **agent-framework-declarative**: Create the experimental default `AgentFactory` only when a workflow needs an agent, while retaining environment-file loading during workflow-factory initialization ([#10114](https://github.com/microsoft/agent-framework/pull/10114)) - **agent-framework**, **agent-framework-core**: Advance the exact Core pin and standard-install dependency cohort to the versions in this release, including GitHub Copilot 2.2. - **agent-framework-ag-ui**, **agent-framework-github-copilot**, **agent-framework-openai**, **agent-framework-redis**: Require Core 1.26 for FIDES replay-provenance hooks, alias-aware structured output, service-history continuation checks, or atomic approval-message grouping. Retain other Core floors under the strict API-usage policy. @@ -31,6 +31,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - **agent-framework-devui**, **tests**: Refresh exact development and tool dependencies, including uv, pytest-asyncio, prek, Ruff, pyrefly, PyYAML stubs, and the DevUI watchdog extra. Update the standalone Lab development dependencies separately; Lab remains outside this release batch. - **tests**: Apply minimal lint cleanups and exercise prepared OpenAI shell tools through the public SDK API instead of a removed private helper. The Cosmos Memory cleanup only removes a stale lint suppression and does not require a package release. - **agent-framework-core**, **docs**, **samples**: Correct workflow and sample docstrings, remove an unused telemetry sentinel, add the agent-framework-dxmt community project, and clarify the consumer-skill maintenance scope ([#10168](https://github.com/microsoft/agent-framework/pull/10168), [#10203](https://github.com/microsoft/agent-framework/pull/10203), [#10233](https://github.com/microsoft/agent-framework/pull/10233), [#10239](https://github.com/microsoft/agent-framework/pull/10239), [#10160](https://github.com/microsoft/agent-framework/pull/10160), [#10185](https://github.com/microsoft/agent-framework/pull/10185)) +- **docs**: Require Python draft release titles to exactly match the full release tag, including the `python-` prefix ([#10311](https://github.com/microsoft/agent-framework/pull/10311)) - **tests**: Remove a nonexistent console entry point from the excluded standalone Lab project ([#10169](https://github.com/microsoft/agent-framework/pull/10169)) ### Deprecated @@ -39,6 +40,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 **Migration:** Use `FileMemoryProvider` with an `AgentFileStore`, such as `FileSystemAgentFileStore`, for new file-based memory. This is not a drop-in replacement: it uses a different storage layout, does not automatically extract memories or provide transcript history, and does not migrate existing files. Configure an explicit scope when memory must span sessions; the default is session-scoped. ### Fixed +- **agent-framework-hyperlight**: Restore the minimum versions of `hyperlight-sandbox`, `hyperlight-sandbox-backend-wasm`, and `hyperlight-sandbox-python-guest` to 0.8.0, allowing installation with 0.8 or 0.9 packages while retaining the `<0.10` upper bounds ([#10313](https://github.com/microsoft/agent-framework/pull/10313)) - **agent-framework-ag-ui**, **agent-framework-core**: Preserve backend Thread Snapshot provenance through AG-UI history normalization, keep fresh client results outside restored FIDES coverage, and fold new replay data before confirmation or approval safe-point snapshots. Retain authenticated approval-result authority and fail closed when service-owned history is unavailable ([#9878](https://github.com/microsoft/agent-framework/pull/9878)) - **agent-framework-core**, **agent-framework-openai**: Bind FIDES policy state to the effective service-history continuation, require exact local-history coverage, and reject opaque, changed, malformed, or partially archived continuations before approval execution or model dispatch ([#9877](https://github.com/microsoft/agent-framework/pull/9877)) - **agent-framework-core**: Classify unstamped replay conservatively, authenticate session-owned hidden placeholders, and bind approvals to canonical stored calls, exact live controls, and pending session snapshots ([#9876](https://github.com/microsoft/agent-framework/pull/9876))