agent-framework 1.22.0__tar.gz → 1.24.0__tar.gz

{agent_framework-1.22.0 → agent_framework-1.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-framework
-Version: 1.22.0
+Version: 1.24.0
 Summary: Microsoft Agent Framework for building AI Agents with Python. This package contains core and a curated set of optional integrations.
 Author-email: Microsoft <af-support@microsoft.com>
 Requires-Python: >=3.10
@@ -9,7 +9,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -17,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
 Classifier: Typing :: Typed
 License-File: LICENSE
-Requires-Dist: agent-framework-core[all]==1.22.0
+Requires-Dist: agent-framework-core[all]==1.24.0
 Project-URL: homepage, https://aka.ms/agent-framework
 Project-URL: issues, https://github.com/microsoft/agent-framework/issues
 Project-URL: release_notes, https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true
@@ -65,14 +64,14 @@ This selective approach is useful when you know which integrations you need, and
 
 Supported Platforms:
 
-- Python: 3.10–3.15
+- Python: 3.11–3.15
 - OS: Windows, macOS, Linux
 
-Python 3.10 remains supported and tested for this release, but it is deprecated
-because upstream Python 3.10 has reached end of life. New environments should
-use Python 3.11 or later. A future Agent Framework release will raise the
-minimum version separately; this release does not remove Python 3.10 from
-package metadata or CI.
+Python 3.10 is no longer supported because it has reached upstream end of life.
+Package metadata still permits Python 3.10 installation, but CI no longer runs
+unit or integration tests on it and compatibility is not guaranteed. Use
+Python 3.11–3.15 for supported environments, subject to integration-specific
+limits below. Raising the installation minimum will be handled separately.
 
 ### Python 3.15 limitations
 
@@ -83,8 +82,6 @@ not provide exactly the same feature set as Python 3.14:
 | --- | --- |
 | Declarative Power Fx | `agent-framework-declarative` is installed, but its `powerfx` dependency is not. YAML values beginning with `=` produce a warning and remain unchanged instead of being evaluated. Declarative agents or workflows that rely on expressions may therefore use invalid literal values or fail later. |
 | Redis | `agent-framework-redis` is omitted from the standard install because RedisVL declares `Requires-Python <3.15`. Redis imports and Redis-backed history, context, and vector storage are unavailable. |
-| Hyperlight | `agent-framework-hyperlight` is omitted because no compatible Python 3.15 sandbox backend wheel is published. Hyperlight CodeAct and its `execute_code` tool are unavailable. |
-| AG-UI A2UI | The base `agent-framework-ag-ui` package works, but pip cannot install its optional `a2ui` extra because `ag-ui-a2ui-toolkit` declares `Requires-Python <3.15`. |
 
 ## 1. Setup API Keys
 
@@ -186,6 +183,46 @@ async def main():
 asyncio.run(main())
 ```
 
+### Connection and credential lifetimes
+
+Chat clients support async context managers for deterministic cleanup:
+
+```python
+from agent_framework import Agent, Message
+from agent_framework.openai import OpenAIChatClient
+
+async with OpenAIChatClient() as client:
+    response = await client.get_response([Message("user", ["Hello!"])])
+
+# Alternatively, let the agent enter and exit its chat client's context.
+async with Agent(client=OpenAIChatClient(), instructions="Be helpful.") as agent:
+    response = await agent.run("Hello!")
+```
+
+Calling clients without a context manager remains supported; use `await client.close()` when finished.
+Context exit releases connections created by the connector, including on exceptions. Caller-supplied SDK clients,
+HTTP transports, and credentials remain caller-owned. In particular, closing an Azure SDK connection does not
+close the credential supplied to it. Scope credentials outside the agent or client that uses them:
+
+```python
+from azure.identity.aio import AzureCliCredential
+
+async with AzureCliCredential() as credential:
+    async with OpenAIChatClient(
+        azure_endpoint="https://YOUR-RESOURCE.openai.azure.com",
+        model="YOUR-DEPLOYMENT",
+        credential=credential,
+    ) as client:
+        response = await client.get_response([Message("user", ["Hello!"])])
+```
+
+Treat closing a resource-owning client as the end of its lifetime; reopening is SDK-dependent. Avoid overlapping
+agent contexts sharing a connector-owned connection, since exiting either agent closes that connection. To share
+an SDK client across agents, inject it into their chat clients and manage its lifetime outside those agent contexts.
+`BaseChatClient` provides default context methods and a no-op `close()`, so custom subclasses do not need to
+implement lifecycle methods unless they own resources. Protocol-only chat clients do not need context methods.
+Inherited context exit also supports existing subclasses whose `close()` is synchronous.
+
 ## 4. Build an Agent with Tools and Functions
 
 Enhance your agent with custom tools and function calling:

{agent_framework-1.22.0 → agent_framework-1.24.0}/README.md

@@ -39,14 +39,14 @@ This selective approach is useful when you know which integrations you need, and
 
 Supported Platforms:
 
-- Python: 3.10–3.15
+- Python: 3.11–3.15
 - OS: Windows, macOS, Linux
 
-Python 3.10 remains supported and tested for this release, but it is deprecated
-because upstream Python 3.10 has reached end of life. New environments should
-use Python 3.11 or later. A future Agent Framework release will raise the
-minimum version separately; this release does not remove Python 3.10 from
-package metadata or CI.
+Python 3.10 is no longer supported because it has reached upstream end of life.
+Package metadata still permits Python 3.10 installation, but CI no longer runs
+unit or integration tests on it and compatibility is not guaranteed. Use
+Python 3.11–3.15 for supported environments, subject to integration-specific
+limits below. Raising the installation minimum will be handled separately.
 
 ### Python 3.15 limitations
 
@@ -57,8 +57,6 @@ not provide exactly the same feature set as Python 3.14:
 | --- | --- |
 | Declarative Power Fx | `agent-framework-declarative` is installed, but its `powerfx` dependency is not. YAML values beginning with `=` produce a warning and remain unchanged instead of being evaluated. Declarative agents or workflows that rely on expressions may therefore use invalid literal values or fail later. |
 | Redis | `agent-framework-redis` is omitted from the standard install because RedisVL declares `Requires-Python <3.15`. Redis imports and Redis-backed history, context, and vector storage are unavailable. |
-| Hyperlight | `agent-framework-hyperlight` is omitted because no compatible Python 3.15 sandbox backend wheel is published. Hyperlight CodeAct and its `execute_code` tool are unavailable. |
-| AG-UI A2UI | The base `agent-framework-ag-ui` package works, but pip cannot install its optional `a2ui` extra because `ag-ui-a2ui-toolkit` declares `Requires-Python <3.15`. |
 
 ## 1. Setup API Keys
 
@@ -160,6 +158,46 @@ async def main():
 asyncio.run(main())
 ```
 
+### Connection and credential lifetimes
+
+Chat clients support async context managers for deterministic cleanup:
+
+```python
+from agent_framework import Agent, Message
+from agent_framework.openai import OpenAIChatClient
+
+async with OpenAIChatClient() as client:
+    response = await client.get_response([Message("user", ["Hello!"])])
+
+# Alternatively, let the agent enter and exit its chat client's context.
+async with Agent(client=OpenAIChatClient(), instructions="Be helpful.") as agent:
+    response = await agent.run("Hello!")
+```
+
+Calling clients without a context manager remains supported; use `await client.close()` when finished.
+Context exit releases connections created by the connector, including on exceptions. Caller-supplied SDK clients,
+HTTP transports, and credentials remain caller-owned. In particular, closing an Azure SDK connection does not
+close the credential supplied to it. Scope credentials outside the agent or client that uses them:
+
+```python
+from azure.identity.aio import AzureCliCredential
+
+async with AzureCliCredential() as credential:
+    async with OpenAIChatClient(
+        azure_endpoint="https://YOUR-RESOURCE.openai.azure.com",
+        model="YOUR-DEPLOYMENT",
+        credential=credential,
+    ) as client:
+        response = await client.get_response([Message("user", ["Hello!"])])
+```
+
+Treat closing a resource-owning client as the end of its lifetime; reopening is SDK-dependent. Avoid overlapping
+agent contexts sharing a connector-owned connection, since exiting either agent closes that connection. To share
+an SDK client across agents, inject it into their chat clients and manage its lifetime outside those agent contexts.
+`BaseChatClient` provides default context methods and a no-op `close()`, so custom subclasses do not need to
+implement lifecycle methods unless they own resources. Protocol-only chat clients do not need context methods.
+Inherited context exit also supports existing subclasses whose `close()` is synchronous.
+
 ## 4. Build an Agent with Tools and Functions
 
 Enhance your agent with custom tools and function calling:

{agent_framework-1.22.0 → agent_framework-1.24.0}/pyproject.toml

@@ -4,7 +4,7 @@ description = "Microsoft Agent Framework for building AI Agents with Python. Thi
 authors = [{ name = "Microsoft", email = "af-support@microsoft.com"}]
 readme = "README.md"
 requires-python = ">=3.10"
-version = "1.22.0"
+version = "1.24.0"
 license-files = ["LICENSE"]
 urls.homepage = "https://aka.ms/agent-framework"
 urls.source = "https://github.com/microsoft/agent-framework/tree/main/python"
@@ -15,7 +15,6 @@ classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
@@ -24,12 +23,12 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-    "agent-framework-core[all]==1.22.0",
+    "agent-framework-core[all]==1.24.0",
 ]
 
 [dependency-groups]
 dev = [
-    "uv==0.13.1",
+    "uv==0.13.5",
     "pytest==9.1.1",
     "pytest-asyncio==1.4.0",
     "pytest-cov==7.1.0",
@@ -37,12 +36,12 @@ dev = [
     "pytest-timeout==2.4.0",
     "pytest-retry==1.7.0",
     "azure-monitor-opentelemetry>=1.8.10,<2",
-    "mcp[ws]",
+    "mcp",
     # Optional SDK used by the agent-hooks tests and isolated source checks.
-    "agent-hooks-sdk>=0.1.0a4,<0.2",
+    "agent-hooks-sdk>=0.1.0b2,<0.2",
     "opentelemetry-sdk",
     # Task runtime used by every supported Python version.
-    "poethepoet==0.48.0",
+    "poethepoet==0.49.0",
 ]
 tool-runtime = [
     "packaging==26.3",
@@ -50,7 +49,7 @@ tool-runtime = [
     'tomli==2.5.0; python_version < "3.11"',
 ]
 tool-hooks = [
-    "prek==0.5.5",
+    "prek==0.5.7",
 ]
 tool-markdown = [
     "pygments==2.21.0",
@@ -59,9 +58,14 @@ tool-markdown = [
 [tool.uv]
 package = false
 prerelease = "if-necessary"
-required-version = "==0.13.1"
+required-version = "==0.13.5"
 # Security floors for transitive dependencies.
-override-dependencies = ["mcp[ws]>=1.27.0,<2", "uvicorn[standard]>=0.34.0", "python-multipart>=0.0.31"]
+override-dependencies = [
+    "certifi>=2026.10.19",
+    "mcp>=2.2.0,<3",
+    "uvicorn[standard]>=0.34.0",
+    "python-multipart>=0.0.31",
+]
 environments = [
     "sys_platform == 'darwin'",
     "sys_platform == 'linux'",
@@ -103,6 +107,7 @@ agent-framework-mem0 = { workspace = true }
 agent-framework-mistral = { workspace = true }
 agent-framework-mongodb = { workspace = true }
 agent-framework-monty = { workspace = true }
+agent-framework-nvidia = { workspace = true }
 agent-framework-ollama = { workspace = true }
 agent-framework-openai = { workspace = true }
 agent-framework-oracle = { workspace = true }
@@ -349,10 +354,6 @@ sequence = [
 ]
 args = [{ name = "project", default = "*", options = ["-P", "--package"] }]
 
-[tool.poe.tasks.publish]
-help = "Publish built distributions with uv."
-cmd = "uv publish"
-
 # Dependency maintenance
 [tool.poe.tasks.upgrade-dev-dependency-pins]
 help = "Repin exact workspace development dependencies and on-demand tool requirements."
@@ -384,6 +385,14 @@ help = "Run the exhaustive workspace dependency-bound test+typing matrix, option
 shell = "python -m scripts.dependencies.validate_dependency_bounds --mode test --package \"$project\""
 args = [{ name = "project", default = "*", options = ["-P", "--package"] }]
 
+[tool.poe.tasks.prepare-python-release]
+help = "Generate .github/release-<fulltag>.json from version changes against the same base as release validation."
+cmd = "python -m scripts.prepare_release --base-ref ${base_ref} --tag ${tag}"
+args = [
+    { name = "base_ref", options = ["-B", "--base-ref"] },
+    { name = "tag", options = ["--tag"] },
+]
+
 [tool.poe.tasks.validate-python-release]
 help = "Refresh uv.lock, then run lower/upper import probes for changed package metadata on each package closure's minimum Python."
 executor = "simple"