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

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

@@ -1,15 +1,14 @@
 Metadata-Version: 2.5
 Name: agent-framework-core
-Version: 1.23.0
+Version: 1.25.0
 Summary: Microsoft Agent Framework for building AI Agents with Python. This is the core package that has all the core abstractions and implementations.
 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
@@ -26,35 +25,35 @@ Requires-Dist: pyyaml>=6.0,<7.0
 Requires-Dist: regex>=2024.11.6
 Requires-Dist: mcp>=2.2.0,<3 ; extra == "all"
 Requires-Dist: tenacity>=9.1.4,<9.2.0 ; extra == "all"
-Requires-Dist: agent-framework-a2a>=1.0.0b261022,<2 ; extra == "all"
-Requires-Dist: agent-framework-ag-ui>=1.7.0,<2 ; extra == "all"
-Requires-Dist: agent-framework-anthropic>=1.0.0b261022,<2 ; extra == "all"
-Requires-Dist: agent-framework-azure-ai-search>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-azure-contentunderstanding>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-azure-cosmos>=1.0.0b261015,<2 ; extra == "all"
+Requires-Dist: agent-framework-a2a>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-ag-ui>=1.8.0,<2 ; extra == "all"
+Requires-Dist: agent-framework-anthropic>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-azure-ai-search>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-azure-contentunderstanding>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-azure-cosmos>=1.0.0b261106,<2 ; extra == "all"
 Requires-Dist: agent-framework-azurefunctions>=1.0.0b260922,<2 ; extra == "all"
-Requires-Dist: agent-framework-bedrock>=1.0.0b261022,<2 ; extra == "all"
-Requires-Dist: agent-framework-chatkit>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-claude>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-copilotstudio>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-declarative>=1.4.0,<2 ; extra == "all"
-Requires-Dist: agent-framework-devui>=1.0.0b261022,<2 ; extra == "all"
+Requires-Dist: agent-framework-bedrock>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-chatkit>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-claude>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-copilotstudio>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-declarative>=1.5.0,<2 ; extra == "all"
+Requires-Dist: agent-framework-devui>=1.0.0b261106,<2 ; extra == "all"
 Requires-Dist: agent-framework-durabletask>=1.0.0b260922,<2 ; extra == "all"
-Requires-Dist: agent-framework-foundry>=1.15.0,<2 ; extra == "all"
-Requires-Dist: agent-framework-foundry-hosting>=1.0.0b261022,<2 ; extra == "all"
-Requires-Dist: agent-framework-foundry-local>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-gemini>=1.0.0b261022,<2 ; extra == "all"
-Requires-Dist: agent-framework-github-copilot>=2.1.0,<3 ; extra == "all" and ( python_version >= '3.11')
-Requires-Dist: agent-framework-hyperlight>=1.0.0b261022,<2 ; extra == "all" and ( (sys_platform == 'linux' and platform_machine == 'x86_64') or (sys_platform == 'win32' and platform_machine == 'AMD64'))
-Requires-Dist: agent-framework-mem0>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-mistral>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-monty>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-ollama>=1.0.0b261022,<2 ; extra == "all"
-Requires-Dist: agent-framework-openai>=1.17.0,<2 ; extra == "all"
-Requires-Dist: agent-framework-orchestrations>=1.4.0,<2 ; extra == "all"
-Requires-Dist: agent-framework-purview>=1.0.0b261015,<2 ; extra == "all"
-Requires-Dist: agent-framework-redis>=1.0.0b261022,<2 ; extra == "all" and ( python_version < '3.15')
-Requires-Dist: agent-framework-tools>=1.0.0b261022,<2 ; extra == "all"
+Requires-Dist: agent-framework-foundry>=1.16.1,<2 ; extra == "all"
+Requires-Dist: agent-framework-foundry-hosting>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-foundry-local>=1.0.0b261106,<2 ; extra == "all" and ( python_version >= '3.11' and python_version < '3.15' and ((sys_platform == 'darwin' and platform_machine == 'arm64') or (sys_platform == 'linux' and (platform_machine == 'x86_64' or platform_machine == 'aarch64')) or (sys_platform == 'win32' and (platform_machine == 'AMD64' or platform_machine == 'ARM64' or platform_machine == 'x86_64' or platform_machine == 'aarch64'))))
+Requires-Dist: agent-framework-gemini>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-github-copilot>=2.1.2,<3 ; extra == "all"
+Requires-Dist: agent-framework-hyperlight>=1.0.0b261106,<2 ; extra == "all" and ( (sys_platform == 'linux' and platform_machine == 'x86_64') or (sys_platform == 'win32' and platform_machine == 'AMD64'))
+Requires-Dist: agent-framework-mem0>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-mistral>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-monty>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-ollama>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-openai>=1.18.1,<2 ; extra == "all"
+Requires-Dist: agent-framework-orchestrations>=1.4.2,<2 ; extra == "all"
+Requires-Dist: agent-framework-purview>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-redis>=1.0.0b261106,<2 ; extra == "all"
+Requires-Dist: agent-framework-tools>=1.0.0b261106,<2 ; extra == "all"
 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
@@ -86,13 +85,11 @@ pip install agent-framework-openai
 
 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. Removing Python 3.10 support will be handled in a
-future release rather than by this compatibility update.
+Python 3.11 or later is required. Supported environments are subject to
+[integration-specific limits](../../README.md#python-315-limitations).
 
 ## 1. Setup API Keys
 
@@ -133,6 +130,14 @@ carry a documented feature-usage token.
 - `AGENT_FRAMEWORK_USER_AGENT_DISABLED=true` disables the entire Agent Framework
   User-Agent contribution, including the feature token.
 
+OpenTelemetry providers configured through `configure_otel_providers()` share a
+resource containing `"microsoft.agent-framework": "True"` (a string) by default. This
+resource attribute applies to logs, traces, and metrics, including other
+instrumentation using those providers. Existing environment and explicit resource
+attribute overrides retain their precedence. If you configure providers yourself,
+use `agent_framework.observability.create_resource()` for each provider or add the
+attribute to your own shared resource.
+
 See the following [getting started samples](https://github.com/microsoft/agent-framework/tree/main/python/samples/01-get-started) for more information.
 
 ## 2. Create a Simple Agent
@@ -252,6 +257,34 @@ cookie-bearing clients and MCP tool sessions to one authenticated principal; do
 share a user-specific cookie jar across users. Rejecting cookies does not partition
 MCP protocol sessions or other server-side state between principals.
 
+### MCP HTTP concurrency and timeouts
+
+`MCPStreamableHTTPTool` and `FoundryToolbox` attach a separate header snapshot to each
+outgoing HTTP request. Calls with identical effective static and dynamic headers can
+overlap on one MCP session. A different identity waits for active operations before
+reconnecting and refreshing discovery. Discovery, reset, close, and recovery are
+exclusive against active network attempts on framework-owned MCP connections, with
+or without a header provider. Same-identity Agent run preparation does not drain
+active calls. Direct prompt calls resolve current headers rather than reusing an
+inherited invocation snapshot; generated prompts resolve host runtime kwargs
+separately from model arguments. Calls still share server-side session state;
+applications must order state-dependent operations themselves.
+
+Resource reads wait for replacement initialization before requiring the connection.
+Catalog discovery restarts the complete snapshot once after a connection replacement,
+without reusing old pages or cursors. A second replacement fails explicitly.
+
+`request_timeout` bounds header admission and session reconciliation together, and
+connection recovery separately from the RPC timeout. These are separate budgets,
+not an end-to-end deadline. `None` disables these budgets. An admission timeout does
+not cancel another caller's active operation. Cleanup may continue after a timeout
+or cancellation so the lifecycle owner can finish releasing resources safely.
+Caller-owned MCP clients retain their own RPC timeout policy and are not recreated.
+
+Concurrent failures of the same connection share its replacement. Calling `close()`
+interrupts older recovery so it cannot reopen the connection or retry the failed
+operation after shutdown. A later explicit `connect()` remains supported.
+
 ## 5. Multi-Agent Orchestration
 
 Coordinate multiple agents to collaborate on complex tasks using orchestration patterns:

{agent_framework_core-1.23.0 → agent_framework_core-1.25.0}/README.md

@@ -22,13 +22,11 @@ pip install agent-framework-openai
 
 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. Removing Python 3.10 support will be handled in a
-future release rather than by this compatibility update.
+Python 3.11 or later is required. Supported environments are subject to
+[integration-specific limits](../../README.md#python-315-limitations).
 
 ## 1. Setup API Keys
 
@@ -69,6 +67,14 @@ carry a documented feature-usage token.
 - `AGENT_FRAMEWORK_USER_AGENT_DISABLED=true` disables the entire Agent Framework
   User-Agent contribution, including the feature token.
 
+OpenTelemetry providers configured through `configure_otel_providers()` share a
+resource containing `"microsoft.agent-framework": "True"` (a string) by default. This
+resource attribute applies to logs, traces, and metrics, including other
+instrumentation using those providers. Existing environment and explicit resource
+attribute overrides retain their precedence. If you configure providers yourself,
+use `agent_framework.observability.create_resource()` for each provider or add the
+attribute to your own shared resource.
+
 See the following [getting started samples](https://github.com/microsoft/agent-framework/tree/main/python/samples/01-get-started) for more information.
 
 ## 2. Create a Simple Agent
@@ -188,6 +194,34 @@ cookie-bearing clients and MCP tool sessions to one authenticated principal; do
 share a user-specific cookie jar across users. Rejecting cookies does not partition
 MCP protocol sessions or other server-side state between principals.
 
+### MCP HTTP concurrency and timeouts
+
+`MCPStreamableHTTPTool` and `FoundryToolbox` attach a separate header snapshot to each
+outgoing HTTP request. Calls with identical effective static and dynamic headers can
+overlap on one MCP session. A different identity waits for active operations before
+reconnecting and refreshing discovery. Discovery, reset, close, and recovery are
+exclusive against active network attempts on framework-owned MCP connections, with
+or without a header provider. Same-identity Agent run preparation does not drain
+active calls. Direct prompt calls resolve current headers rather than reusing an
+inherited invocation snapshot; generated prompts resolve host runtime kwargs
+separately from model arguments. Calls still share server-side session state;
+applications must order state-dependent operations themselves.
+
+Resource reads wait for replacement initialization before requiring the connection.
+Catalog discovery restarts the complete snapshot once after a connection replacement,
+without reusing old pages or cursors. A second replacement fails explicitly.
+
+`request_timeout` bounds header admission and session reconciliation together, and
+connection recovery separately from the RPC timeout. These are separate budgets,
+not an end-to-end deadline. `None` disables these budgets. An admission timeout does
+not cancel another caller's active operation. Cleanup may continue after a timeout
+or cancellation so the lifecycle owner can finish releasing resources safely.
+Caller-owned MCP clients retain their own RPC timeout policy and are not recreated.
+
+Concurrent failures of the same connection share its replacement. Calling `close()`
+interrupts older recovery so it cannot reopen the connection or retry the failed
+operation after shutdown. A later explicit `connect()` remains supported.
+
 ## 5. Multi-Agent Orchestration
 
 Coordinate multiple agents to collaborate on complex tasks using orchestration patterns:

{agent_framework_core-1.23.0 → agent_framework_core-1.25.0}/agent_framework/__init__.py

@@ -42,7 +42,11 @@ from .exceptions import (
 )
 
 _LAZY_MODULE_EXPORTS: Final[Mapping[str, tuple[str, ...]]] = {
-    "._agent_hooks": ("create_agent_hooks_middleware", "create_agent_hooks_middleware_from_emitter"),
+    "._agent_hooks": (
+        "create_agent_hooks_middleware",
+        "create_agent_hooks_middleware_from_declaration",
+        "create_agent_hooks_middleware_from_emitter",
+    ),
     "._agents": ("Agent", "BaseAgent", "RawAgent", "SupportsAgentRun"),
     "._clients": (
         "BaseChatClient",
@@ -69,6 +73,7 @@ _LAZY_MODULE_EXPORTS: Final[Mapping[str, tuple[str, ...]]] = {
         "SUMMARIZED_BY_SUMMARY_ID_KEY",
         "SUMMARY_OF_GROUP_IDS_KEY",
         "SUMMARY_OF_MESSAGE_IDS_KEY",
+        "AgentTriggeredCompactionStrategy",
         "CharacterEstimatorTokenizer",
         "CompactionProvider",
         "CompactionStrategy",
@@ -80,6 +85,7 @@ _LAZY_MODULE_EXPORTS: Final[Mapping[str, tuple[str, ...]]] = {
         "TokenizerProtocol",
         "ToolResultCompactionStrategy",
         "TruncationStrategy",
+        "UnloadSkillsCompactionStrategy",
         "annotate_message_groups",
         "apply_compaction",
         "included_messages",
@@ -452,6 +458,7 @@ __all__ = [
     "AgentResponseUpdate",
     "AgentRunInputs",
     "AgentSession",
+    "AgentTriggeredCompactionStrategy",
     "AggregatingSkillsSource",
     "Annotation",
     "BackgroundAgentsProvider",
@@ -645,6 +652,7 @@ __all__ = [
     "ToolTypes",
     "TruncationStrategy",
     "TypeCompatibilityError",
+    "UnloadSkillsCompactionStrategy",
     "UpdateT",
     "UsageDetails",
     "UserInputRequiredException",
@@ -682,6 +690,7 @@ __all__ = [
     "background_tasks_running_message",
     "chat_middleware",
     "create_agent_hooks_middleware",
+    "create_agent_hooks_middleware_from_declaration",
     "create_agent_hooks_middleware_from_emitter",
     "create_always_approve_tool_response",
     "create_always_approve_tool_with_arguments_response",

{agent_framework_core-1.23.0 → agent_framework_core-1.25.0}/agent_framework/__init__.pyi

@@ -4,7 +4,11 @@ from typing import Final
 
 __version__: Final[str]
 
-from ._agent_hooks import create_agent_hooks_middleware, create_agent_hooks_middleware_from_emitter
+from ._agent_hooks import (
+    create_agent_hooks_middleware,
+    create_agent_hooks_middleware_from_declaration,
+    create_agent_hooks_middleware_from_emitter,
+)
 from ._agents import Agent, BaseAgent, RawAgent, SupportsAgentRun
 from ._clients import (
     BaseChatClient,
@@ -31,6 +35,7 @@ from ._compaction import (
     SUMMARIZED_BY_SUMMARY_ID_KEY,
     SUMMARY_OF_GROUP_IDS_KEY,
     SUMMARY_OF_MESSAGE_IDS_KEY,
+    AgentTriggeredCompactionStrategy,
     CharacterEstimatorTokenizer,
     CompactionProvider,
     CompactionStrategy,
@@ -42,6 +47,7 @@ from ._compaction import (
     TokenizerProtocol,
     ToolResultCompactionStrategy,
     TruncationStrategy,
+    UnloadSkillsCompactionStrategy,
     annotate_message_groups,
     apply_compaction,
     included_messages,
@@ -407,6 +413,7 @@ __all__ = [
     "AgentResponseUpdate",
     "AgentRunInputs",
     "AgentSession",
+    "AgentTriggeredCompactionStrategy",
     "AggregatingSkillsSource",
     "Annotation",
     "BackgroundAgentsProvider",
@@ -600,6 +607,7 @@ __all__ = [
     "ToolTypes",
     "TruncationStrategy",
     "TypeCompatibilityError",
+    "UnloadSkillsCompactionStrategy",
     "UpdateT",
     "UsageDetails",
     "UserInputRequiredException",
@@ -637,6 +645,7 @@ __all__ = [
     "background_tasks_running_message",
     "chat_middleware",
     "create_agent_hooks_middleware",
+    "create_agent_hooks_middleware_from_declaration",
     "create_agent_hooks_middleware_from_emitter",
     "create_always_approve_tool_response",
     "create_always_approve_tool_with_arguments_response",