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

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

@@ -1,15 +1,14 @@
 Metadata-Version: 2.5
 Name: agent-framework
-Version: 1.23.0
+Version: 1.25.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
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 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.25.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,11 @@ 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.11 or later is required. Supported environments are subject to the
+integration-specific limits below.
 
 ### Python 3.15 limitations
 
@@ -82,7 +78,6 @@ not provide exactly the same feature set as Python 3.14:
 | Area | Python 3.15 impact |
 | --- | --- |
 | 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. |
 
 ## 1. Setup API Keys
 
@@ -184,6 +179,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.25.0}/README.md

@@ -39,14 +39,11 @@ 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.11 or later is required. Supported environments are subject to the
+integration-specific limits below.
 
 ### Python 3.15 limitations
 
@@ -56,7 +53,6 @@ not provide exactly the same feature set as Python 3.14:
 | Area | Python 3.15 impact |
 | --- | --- |
 | 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. |
 
 ## 1. Setup API Keys
 
@@ -158,6 +154,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.25.0}/agent_framework_meta/__init__.py

@@ -1,18 +1,16 @@
 # Copyright (c) Microsoft. All rights reserved.
 
+from __future__ import annotations
+
+import tomllib as _toml
 from importlib import metadata as _metadata
 from pathlib import Path as _Path
 from typing import Any, cast
 
-try:
-    import tomllib as _toml  # type: ignore # Python 3.11+
-except ModuleNotFoundError:  # Python 3.10
-    import tomli as _toml  # type: ignore
-
 
 def _load_pyproject() -> dict[str, Any]:
     pyproject = (_Path(__file__).resolve().parents[1] / "pyproject.toml").read_text("utf-8")
-    return cast(dict[str, Any], _toml.loads(pyproject))  # type: ignore
+    return _toml.loads(pyproject)
 
 
 def _version() -> str:

{agent_framework-1.23.0 → agent_framework-1.25.0}/pyproject.toml

@@ -3,8 +3,8 @@ name = "agent-framework"
 description = "Microsoft Agent Framework for building AI Agents with Python. This package contains core and a curated set of optional integrations."
 authors = [{ name = "Microsoft", email = "af-support@microsoft.com"}]
 readme = "README.md"
-requires-python = ">=3.10"
-version = "1.23.0"
+requires-python = ">=3.11"
+version = "1.25.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,14 +23,14 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-    "agent-framework-core[all]==1.23.0",
+    "agent-framework-core[all]==1.25.0",
 ]
 
 [dependency-groups]
 dev = [
     "uv==0.13.5",
-    "pytest==9.1.1",
-    "pytest-asyncio==1.4.0",
+    "pytest==9.2.0",
+    "pytest-asyncio==1.4.1",
     "pytest-cov==7.1.0",
     "pytest-xdist[psutil]==3.8.0",
     "pytest-timeout==2.4.0",
@@ -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",
@@ -47,7 +46,6 @@ dev = [
 tool-runtime = [
     "packaging==26.3",
     "rich>=13.7.1,<16.0.0",
-    'tomli==2.5.0; python_version < "3.11"',
 ]
 tool-hooks = [
     "prek==0.5.7",
@@ -108,6 +106,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 }
@@ -123,7 +122,7 @@ agent-framework-typesafe = { workspace = true }
 
 [tool.ruff]
 line-length = 120
-target-version = "py310"
+target-version = "py311"
 fix = true
 include = ["*.py", "*.pyi", "**/pyproject.toml", "*.ipynb"]
 exclude = ["scripts"]
@@ -159,6 +158,7 @@ select = [
     "W", # pycodestyle warning checks
 ]
 ignore = [
+    "ASYNC109", # timeout parameters are intentional API contracts
     "D100", # allow missing docstring in public module
     "D104", # allow missing docstring in public package
     "D421", # allow property docstrings that start with a verb
@@ -228,7 +228,7 @@ reportUnnecessaryTypeIgnoreComment = "error"
 # annotating every function. See docs/skills/python-code-quality.
 [tool.mypy]
 plugins = ['pydantic.mypy']
-python_version = "3.10"
+python_version = "3.11"
 ignore_missing_imports = true
 check_untyped_defs = true
 disallow_untyped_defs = false
@@ -240,7 +240,7 @@ warn_unused_ignores = false
 show_error_codes = true
 
 # NumPy 2.5 stubs use Python 3.12 type-statement syntax while mypy intentionally
-# targets Python 3.10 for test typing; skip parsing NumPy internals.
+# targets Python 3.11 for test typing; skip parsing NumPy internals.
 [[tool.mypy.overrides]]
 module = ["numpy", "numpy.*"]
 follow_imports = "skip"
@@ -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"