agent-framework-core 1.21.0__tar.gz → 1.22.0__tar.gz

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: agent-framework-core
-Version: 1.21.0
+Version: 1.22.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
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Typing :: Typed
 License-File: LICENSE
 Requires-Dist: msgspec>=0.20.0,<0.23
@@ -24,40 +25,41 @@ Requires-Dist: opentelemetry-api>=1.39.0,<2
 Requires-Dist: pyyaml>=6.0,<7.0
 Requires-Dist: regex>=2024.11.6
 Requires-Dist: mcp>=1.24.0,<2 ; extra == "all"
-Requires-Dist: agent-framework-a2a>=1.0.0b261002,<2 ; extra == "all"
-Requires-Dist: agent-framework-ag-ui>=1.5.1,<2 ; extra == "all"
-Requires-Dist: agent-framework-anthropic>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-azure-ai-search>=1.0.0b261002,<2 ; extra == "all"
-Requires-Dist: agent-framework-azure-contentunderstanding>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-azure-cosmos>=1.0.0b261002,<2 ; extra == "all"
+Requires-Dist: agent-framework-a2a>=1.0.0b261015,<2 ; extra == "all"
+Requires-Dist: agent-framework-ag-ui>=1.6.0,<2 ; extra == "all"
+Requires-Dist: agent-framework-anthropic>=1.0.0b261015,<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-azurefunctions>=1.0.0b260922,<2 ; extra == "all"
-Requires-Dist: agent-framework-bedrock>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-chatkit>=1.0.0b261002,<2 ; extra == "all"
-Requires-Dist: agent-framework-claude>=1.0.0b261002,<2 ; extra == "all"
-Requires-Dist: agent-framework-copilotstudio>=1.0.0b261002,<2 ; extra == "all"
-Requires-Dist: agent-framework-declarative>=1.2.1,<2 ; extra == "all"
-Requires-Dist: agent-framework-devui>=1.0.0b261008,<2 ; extra == "all"
+Requires-Dist: agent-framework-bedrock>=1.0.0b261015,<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.3.0,<2 ; extra == "all"
+Requires-Dist: agent-framework-devui>=1.0.0b261015,<2 ; extra == "all"
 Requires-Dist: agent-framework-durabletask>=1.0.0b260922,<2 ; extra == "all"
-Requires-Dist: agent-framework-foundry>=1.14.1,<2 ; extra == "all"
-Requires-Dist: agent-framework-foundry-hosting>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-foundry-local>=1.0.0b260730,<2 ; extra == "all"
-Requires-Dist: agent-framework-gemini>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-github-copilot>=2.0.2,<3 ; extra == "all" and ( python_version >= '3.11')
-Requires-Dist: agent-framework-hyperlight>=1.0.0b261008,<2 ; extra == "all" and ( python_version < '3.15' and ((sys_platform == 'linux' and platform_machine == 'x86_64') or (sys_platform == 'win32' and platform_machine == 'AMD64')))
-Requires-Dist: agent-framework-mem0>=1.0.0b261002,<2 ; extra == "all"
-Requires-Dist: agent-framework-mistral>=1.0.0b260918,<2 ; extra == "all"
-Requires-Dist: agent-framework-monty>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-ollama>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-openai>=1.16.0,<2 ; extra == "all"
-Requires-Dist: agent-framework-orchestrations>=1.3.1,<2 ; extra == "all"
-Requires-Dist: agent-framework-purview>=1.0.0b261008,<2 ; extra == "all"
-Requires-Dist: agent-framework-redis>=1.0.0b261002,<2 ; extra == "all" and ( python_version < '3.15')
-Requires-Dist: agent-framework-tools>=1.0.0b261008,<2 ; extra == "all"
+Requires-Dist: agent-framework-foundry>=1.15.0,<2 ; extra == "all"
+Requires-Dist: agent-framework-foundry-hosting>=1.0.0b261015,<2 ; extra == "all"
+Requires-Dist: agent-framework-foundry-local>=1.0.0b261015,<2 ; extra == "all"
+Requires-Dist: agent-framework-gemini>=1.0.0b261015,<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.0b261015,<2 ; extra == "all" and ( python_version < '3.15' 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.0b261015,<2 ; extra == "all"
+Requires-Dist: agent-framework-openai>=1.17.0,<2 ; extra == "all"
+Requires-Dist: agent-framework-orchestrations>=1.3.2,<2 ; extra == "all"
+Requires-Dist: agent-framework-purview>=1.0.0b261015,<2 ; extra == "all"
+Requires-Dist: agent-framework-redis>=1.0.0b261015,<2 ; extra == "all" and ( python_version < '3.15')
+Requires-Dist: agent-framework-tools>=1.0.0b261015,<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
 Project-URL: source, https://github.com/microsoft/agent-framework/tree/main/python
 Provides-Extra: all
+Import-Name: agent_framework
 
 # Get Started with Microsoft Agent Framework
 
@@ -83,9 +85,14 @@ pip install agent-framework-openai
 
 Supported Platforms:
 
-- Python: 3.10+
+- Python: 3.10–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.
+
 ## 1. Setup API Keys
 
 Depending on the client you want to use, there are various environment variables you can set to configure the chat clients. This can be done in the environment itself, or with a `.env` file in your project root, some examples of environment variables include:

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/README.md

@@ -22,9 +22,14 @@ pip install agent-framework-openai
 
 Supported Platforms:
 
-- Python: 3.10+
+- Python: 3.10–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.
+
 ## 1. Setup API Keys
 
 Depending on the client you want to use, there are various environment variables you can set to configure the chat clients. This can be done in the environment itself, or with a `.env` file in your project root, some examples of environment variables include:

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/agent_framework/__init__.py

@@ -277,12 +277,15 @@ _LAZY_MODULE_EXPORTS: Final[Mapping[str, tuple[str, ...]]] = {
         "UsageDetails",
         "add_usage_details",
         "detect_media_type_from_base64",
+        "get_namespaced_value",
         "map_chat_to_agent_update",
+        "merge_additional_properties",
         "merge_chat_options",
         "normalize_messages",
         "normalize_tools",
         "prepend_instructions_to_messages",
         "validate_chat_options",
+        "with_namespaced_value",
         "validate_tool_mode",
         "validate_tools",
     ),
@@ -696,6 +699,7 @@ __all__ = [
     "executor",
     "function_middleware",
     "get_agent_mode",
+    "get_namespaced_value",
     "get_run_context",
     "handler",
     "included_messages",
@@ -703,6 +707,7 @@ __all__ = [
     "keyword_check",
     "load_settings",
     "map_chat_to_agent_update",
+    "merge_additional_properties",
     "merge_chat_options",
     "normalize_function_invocation_configuration",
     "normalize_messages",
@@ -727,6 +732,7 @@ __all__ = [
     "validate_tools",
     "validate_workflow_graph",
     "vectorstoremodel",
+    "with_namespaced_value",
     "workflow",
 ]
 

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/agent_framework/__init__.pyi

@@ -243,7 +243,9 @@ from ._types import (
     UsageDetails,
     add_usage_details,
     detect_media_type_from_base64,
+    get_namespaced_value,
     map_chat_to_agent_update,
+    merge_additional_properties,
     merge_chat_options,
     normalize_messages,
     normalize_tools,
@@ -251,6 +253,7 @@ from ._types import (
     validate_chat_options,
     validate_tool_mode,
     validate_tools,
+    with_namespaced_value,
 )
 from ._vector_filters import Filter, FilterGroup, FilterGroupOperator, FilterOperator, Param
 from ._vectors import (
@@ -651,6 +654,7 @@ __all__ = [
     "executor",
     "function_middleware",
     "get_agent_mode",
+    "get_namespaced_value",
     "get_run_context",
     "handler",
     "included_messages",
@@ -658,6 +662,7 @@ __all__ = [
     "keyword_check",
     "load_settings",
     "map_chat_to_agent_update",
+    "merge_additional_properties",
     "merge_chat_options",
     "normalize_function_invocation_configuration",
     "normalize_messages",
@@ -682,5 +687,6 @@ __all__ = [
     "validate_tools",
     "validate_workflow_graph",
     "vectorstoremodel",
+    "with_namespaced_value",
     "workflow",
 ]

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/agent_framework/_agents.py

@@ -995,7 +995,7 @@ class RawAgent(BaseAgent, Generic[OptionsCoT]):
         tokenizer: TokenizerProtocol | None = None,
         additional_properties: MutableMapping[str, Any] | None = None,
     ) -> None:
-        """Initialize a Agent instance.
+        """Initialize an Agent instance.
 
         Args:
             client: The chat client to use for the agent.
@@ -2104,7 +2104,7 @@ class Agent(
         tokenizer: TokenizerProtocol | None = None,
         additional_properties: MutableMapping[str, Any] | None = None,
     ) -> None:
-        """Initialize a Agent instance."""
+        """Initialize an Agent instance."""
         super().__init__(
             client=client,
             instructions=instructions,

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/agent_framework/_compaction.py

@@ -1013,11 +1013,9 @@ def _serialize_content(content: Content) -> dict[str, Any]:
     else:
         payload.pop("protected_data", None)
     additional_properties = payload.get("additional_properties")
-    if isinstance(additional_properties, dict) and "encrypted_content" in additional_properties:
-        typed_properties = cast("dict[str, Any]", additional_properties)
-        payload["additional_properties"] = {
-            key: value for key, value in typed_properties.items() if key != "encrypted_content"
-        }
+    if isinstance(additional_properties, dict) and additional_properties:
+        filtered_properties = _strip_opaque_reasoning_payload(additional_properties)
+        payload["additional_properties"] = filtered_properties or {}
     return payload
 
 

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/agent_framework/_harness/_file_access.py

@@ -1961,15 +1961,14 @@ class FileAccessProvider(ContextProvider):
     def _is_local_tool_call(function_call: Content) -> bool:
         """Return whether a function call targets this provider's local tools.
 
-        Hosted-tool calls carry a ``server_label`` in their
-        ``additional_properties`` and are a separate server-scoped approval
+        Hosted-tool calls set ``hosted=True`` and are a separate server-scoped approval
         boundary that must be passed through untouched (see
         :func:`agent_framework._tools._is_hosted_tool_approval`). These rules
         only ever auto-approve the provider's own local tools, so any call that
-        carries a ``server_label`` is rejected even if its name collides with a
+        is hosted is rejected even if its name collides with a
         file-access tool name.
         """
-        return not function_call.additional_properties.get("server_label")
+        return not function_call.hosted
 
     @staticmethod
     def read_only_tools_auto_approval_rule(function_call: Content) -> bool:
@@ -1983,7 +1982,7 @@ class FileAccessProvider(ContextProvider):
         the tools that modify it (``file_access_write``, ``file_access_delete``,
         ``file_access_replace``, and ``file_access_replace_lines``).
 
-        Hosted-tool calls (those carrying a ``server_label``) are never
+        Hosted-tool calls are never
         auto-approved, even when their name matches a file-access tool, so the
         rule stays scoped to this provider's local tools.
 
@@ -2020,7 +2019,7 @@ class FileAccessProvider(ContextProvider):
         ``file_access_delete``, ``file_access_replace``, and
         ``file_access_replace_lines``).
 
-        Hosted-tool calls (those carrying a ``server_label``) are never
+        Hosted-tool calls are never
         auto-approved, even when their name matches a file-access tool, so the
         rule stays scoped to this provider's local tools.
 

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/agent_framework/_harness/_memory.py

@@ -506,10 +506,10 @@ class MemoryTopicRecord:
                 topic = stripped[2:].strip()
                 current_section = None
                 continue
-            if stripped.startswith("Updated: "):
+            if current_section is None and stripped.startswith("Updated: "):
                 updated_at = stripped.removeprefix("Updated: ").strip()
                 continue
-            if stripped.startswith("Sessions: "):
+            if current_section is None and stripped.startswith("Sessions: "):
                 raw_sessions = stripped.removeprefix("Sessions: ").strip()
                 session_ids = (
                     []

{agent_framework_core-1.21.0 → agent_framework_core-1.22.0}/agent_framework/_harness/_tool_approval.py

@@ -58,9 +58,12 @@ def _serialize_arguments(function_call: Content) -> dict[str, str]:
 
 
 def _server_label(function_call: Content) -> str | None:
-    """Return the hosted-tool server boundary for a function call, if present."""
-    value = function_call.additional_properties.get("server_label")
-    return value if isinstance(value, str) else None
+    """Return the hosted-tool server boundary for a function call, if present.
+
+    Legacy ``additional_properties["server_label"]`` is normalized into first-class
+    ``hosted`` and ``server_name`` by Content construction and restoration.
+    """
+    return function_call.server_name if function_call.hosted else None
 
 
 def _content_from_state(value: Any) -> Content:
@@ -236,6 +239,13 @@ class ToolApprovalState(SerializationMixin):
 def create_always_approve_tool_response(request: Content, *, reason: str | None = None) -> Content:
     """Create an approval response that records a standing rule for the whole tool.
 
+    .. warning::
+        Standing rules are stored in the supplied :class:`AgentSession` and are
+        not tied to the agent or tool instance that created the request. Before
+        reusing the session with a different agent or tool set, especially one
+        that can load tools from an outside source such as MCP, ensure the rule
+        is still appropriate for every matching tool name.
+
     Args:
         request: The ``function_approval_request`` content to approve.
 
@@ -250,7 +260,15 @@ def create_always_approve_tool_response(request: Content, *, reason: str | None
 
 
 def create_always_approve_tool_with_arguments_response(request: Content, *, reason: str | None = None) -> Content:
-    """Create an approval response that records a standing rule for the tool and exact arguments."""
+    """Create an approval response that records a standing rule for the tool and exact arguments.
+
+    .. warning::
+        Standing rules are stored in the supplied :class:`AgentSession` and are
+        not tied to the agent or tool instance that created the request. Before
+        reusing the session with a different agent or tool set, especially one
+        that can load tools from an outside source such as MCP, ensure the rule
+        is still appropriate for every matching tool name and argument set.
+    """
     return _create_always_approve_response(request, ALWAYS_APPROVE_TOOL_WITH_ARGUMENTS, reason=reason)
 
 
@@ -364,6 +382,19 @@ class ToolApprovalMiddleware(AgentMiddleware):
     This middleware is opt-in and requires callers to run the agent with an
     :class:`AgentSession`, because approval rules and queued requests are stored
     in session state.
+
+    .. warning::
+        **Security.** Standing approval rules persist in the supplied session
+        and are not tied to the agent or tool instance that recorded them.
+        Reusing the session with a different or rebuilt agent, or with a changed
+        tool set, can let another tool with the same name match an earlier rule.
+        This is especially important when tools can come from an outside source
+        such as MCP. Before passing such a session to the agent, ensure its
+        standing approvals are still valid for all tools the agent can use. A
+        changed tool does not always require a new approval. For example, an
+        upgraded agent may use an improved version of a tool for which the old
+        approval is still appropriate. The developer must decide whether each
+        standing approval should carry over to the changed tool.
     """
 
     def __init__(