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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-framework
-Version: 1.23.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.23.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
 
@@ -184,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.23.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
 
@@ -158,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.23.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.23.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,7 +23,7 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-    "agent-framework-core[all]==1.23.0",
+    "agent-framework-core[all]==1.24.0",
 ]
 
 [dependency-groups]
@@ -39,7 +38,7 @@ dev = [
     "azure-monitor-opentelemetry>=1.8.10,<2",
     "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.49.0",
@@ -108,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 }
@@ -354,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."
@@ -389,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"