agent-framework-core 1.17.0__tar.gz → 1.18.0__tar.gz

{agent_framework_core-1.17.0 → agent_framework_core-1.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-framework-core
-Version: 1.17.0
+Version: 1.18.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
@@ -41,8 +41,7 @@ Requires-Dist: agent-framework-foundry-hosting ; extra == "all"
 Requires-Dist: agent-framework-foundry-local ; extra == "all"
 Requires-Dist: agent-framework-gemini ; extra == "all"
 Requires-Dist: agent-framework-github-copilot ; extra == "all" and ( python_version >= '3.11')
-Requires-Dist: agent-framework-hyperlight ; extra == "all" and ( ((sys_platform == 'linux' and platform_machine == 'x86_64') or (sys_platform == 'win32' and platform_machine == 'AMD64')) and python_version < '3.14')
-Requires-Dist: agent-framework-lab ; extra == "all"
+Requires-Dist: agent-framework-hyperlight ; extra == "all" and ( (sys_platform == 'linux' and platform_machine == 'x86_64') or (sys_platform == 'win32' and platform_machine == 'AMD64'))
 Requires-Dist: agent-framework-mem0 ; extra == "all"
 Requires-Dist: agent-framework-mistral ; extra == "all"
 Requires-Dist: agent-framework-monty ; extra == "all"

{agent_framework_core-1.17.0 → agent_framework_core-1.18.0}/agent_framework/__init__.py

@@ -284,6 +284,37 @@ _LAZY_MODULE_EXPORTS: Final[Mapping[str, tuple[str, ...]]] = {
         "validate_tool_mode",
         "validate_tools",
     ),
+    "._in_memory": (
+        "InMemoryCollection",
+        "InMemoryStore",
+    ),
+    "._vector_filters": (
+        "Filter",
+        "FilterGroup",
+        "FilterGroupOperator",
+        "FilterOperator",
+        "Param",
+    ),
+    "._vectors": (
+        "DISTANCE_FUNCTION_DIRECTION_HELPER",
+        "BaseVectorCollection",
+        "BaseVectorSearch",
+        "BaseVectorStore",
+        "DistanceFunction",
+        "FieldTypes",
+        "GenerateVectors",
+        "IndexKind",
+        "SearchResponse",
+        "SearchResults",
+        "SearchType",
+        "SupportsVectorSearch",
+        "SupportsVectorUpsert",
+        "VectorStoreCollectionDefinition",
+        "VectorStoreField",
+        "create_vector_search_tool",
+        "register_vectorstoremodel",
+        "vectorstoremodel",
+    ),
     "._workflows._agent": ("WorkflowAgent",),
     "._workflows._agent_executor": ("AgentExecutor", "AgentExecutorRequest", "AgentExecutorResponse"),
     "._workflows._agent_utils": ("resolve_agent_id",),
@@ -343,7 +374,7 @@ _LAZY_MODULE_EXPORTS: Final[Mapping[str, tuple[str, ...]]] = {
         "validate_workflow_graph",
     ),
     "._workflows._viz": ("WorkflowViz",),
-    "._workflows._workflow": ("Workflow", "WorkflowRunResult"),
+    "._workflows._workflow": ("Workflow", "WorkflowInvocationKwargs", "WorkflowRunResult"),
     "._workflows._workflow_builder": ("WorkflowBuilder",),
     "._workflows._workflow_context": ("WorkflowContext",),
     "._workflows._workflow_executor": (
@@ -371,6 +402,7 @@ __all__ = [
     "DEFAULT_MODE_SOURCE_ID",
     "DEFAULT_TODO_SOURCE_ID",
     "DEFAULT_TOOL_APPROVAL_SOURCE_ID",
+    "DISTANCE_FUNCTION_DIRECTION_HELPER",
     "EXCLUDED_KEY",
     "EXCLUDE_REASON_KEY",
     "GROUP_ANNOTATION_KEY",
@@ -412,6 +444,9 @@ __all__ = [
     "BaseAgent",
     "BaseChatClient",
     "BaseEmbeddingClient",
+    "BaseVectorCollection",
+    "BaseVectorSearch",
+    "BaseVectorStore",
     "CachingSkillsSource",
     "Case",
     "CharacterEstimatorTokenizer",
@@ -438,6 +473,7 @@ __all__ = [
     "DeduplicatingSkillsSource",
     "Default",
     "DelegatingSkillsSource",
+    "DistanceFunction",
     "Edge",
     "EdgeCondition",
     "EdgeDuplicationError",
@@ -456,6 +492,7 @@ __all__ = [
     "ExperimentalFeature",
     "FanInEdgeGroup",
     "FanOutEdgeGroup",
+    "FieldTypes",
     "FileAccessProvider",
     "FileCheckpointStorage",
     "FileHistoryProvider",
@@ -468,6 +505,10 @@ __all__ = [
     "FileSkillsSource",
     "FileStoreEntry",
     "FileSystemAgentFileStore",
+    "Filter",
+    "FilterGroup",
+    "FilterGroupOperator",
+    "FilterOperator",
     "FilteringSkillsSource",
     "FinalT",
     "FinishReason",
@@ -482,14 +523,18 @@ __all__ = [
     "FunctionalWorkflow",
     "FunctionalWorkflowAgent",
     "FunctionalWorkflowDefinition",
+    "GenerateVectors",
     "GeneratedEmbeddings",
     "GraphConnectivityError",
     "HistoryProvider",
     "InMemoryAgentFileStore",
     "InMemoryCheckpointStorage",
+    "InMemoryCollection",
     "InMemoryHistoryProvider",
     "InMemorySkillsSource",
+    "InMemoryStore",
     "InProcRunnerContext",
+    "IndexKind",
     "InlineSkill",
     "InlineSkillResource",
     "InlineSkillScript",
@@ -517,6 +562,7 @@ __all__ = [
     "MiddlewareTypes",
     "OuterFinalT",
     "OuterUpdateT",
+    "Param",
     "RawAgent",
     "ReleaseCandidateFeature",
     "ResponseStream",
@@ -527,6 +573,9 @@ __all__ = [
     "Runner",
     "RunnerContext",
     "SamplingApprovalCallback",
+    "SearchResponse",
+    "SearchResults",
+    "SearchType",
     "SecretString",
     "SelectiveToolCallCompactionStrategy",
     "ServiceSessionId",
@@ -555,6 +604,8 @@ __all__ = [
     "SupportsImageGenerationTool",
     "SupportsMCPTool",
     "SupportsShellTool",
+    "SupportsVectorSearch",
+    "SupportsVectorUpsert",
     "SupportsWebSearchTool",
     "SwitchCaseEdgeGroup",
     "SwitchCaseEdgeGroupCase",
@@ -580,6 +631,8 @@ __all__ = [
     "UsageDetails",
     "UserInputRequiredException",
     "ValidationTypeEnum",
+    "VectorStoreCollectionDefinition",
+    "VectorStoreField",
     "Workflow",
     "WorkflowAgent",
     "WorkflowBuilder",
@@ -593,6 +646,7 @@ __all__ = [
     "WorkflowEventType",
     "WorkflowException",
     "WorkflowExecutor",
+    "WorkflowInvocationKwargs",
     "WorkflowMessage",
     "WorkflowRunResult",
     "WorkflowRunState",
@@ -613,6 +667,7 @@ __all__ = [
     "create_always_approve_tool_with_arguments_response",
     "create_edge_runner",
     "create_harness_agent",
+    "create_vector_search_tool",
     "detect_media_type_from_base64",
     "enqueue_messages",
     "evaluate_agent",
@@ -636,6 +691,7 @@ __all__ = [
     "prepend_instructions_to_messages",
     "register_checkpoint_type",
     "register_state_type",
+    "register_vectorstoremodel",
     "resolve_agent_id",
     "response_handler",
     "set_agent_mode",
@@ -650,6 +706,7 @@ __all__ = [
     "validate_tool_mode",
     "validate_tools",
     "validate_workflow_graph",
+    "vectorstoremodel",
     "workflow",
 ]
 

{agent_framework_core-1.17.0 → agent_framework_core-1.18.0}/agent_framework/__init__.pyi

@@ -123,6 +123,7 @@ from ._harness._tool_approval import (
     create_always_approve_tool_response,
     create_always_approve_tool_with_arguments_response,
 )
+from ._in_memory import InMemoryCollection, InMemoryStore
 from ._mcp import (
     MCPStdioTool,
     MCPStreamableHTTPTool,
@@ -250,6 +251,27 @@ from ._types import (
     validate_tool_mode,
     validate_tools,
 )
+from ._vector_filters import Filter, FilterGroup, FilterGroupOperator, FilterOperator, Param
+from ._vectors import (
+    DISTANCE_FUNCTION_DIRECTION_HELPER,
+    BaseVectorCollection,
+    BaseVectorSearch,
+    BaseVectorStore,
+    DistanceFunction,
+    FieldTypes,
+    GenerateVectors,
+    IndexKind,
+    SearchResponse,
+    SearchResults,
+    SearchType,
+    SupportsVectorSearch,
+    SupportsVectorUpsert,
+    VectorStoreCollectionDefinition,
+    VectorStoreField,
+    create_vector_search_tool,
+    register_vectorstoremodel,
+    vectorstoremodel,
+)
 from ._workflows._agent import WorkflowAgent
 from ._workflows._agent_executor import AgentExecutor, AgentExecutorRequest, AgentExecutorResponse
 from ._workflows._agent_utils import resolve_agent_id
@@ -306,7 +328,7 @@ from ._workflows._validation import (
     validate_workflow_graph,
 )
 from ._workflows._viz import WorkflowViz
-from ._workflows._workflow import Workflow, WorkflowRunResult
+from ._workflows._workflow import Workflow, WorkflowInvocationKwargs, WorkflowRunResult
 from ._workflows._workflow_builder import WorkflowBuilder
 from ._workflows._workflow_context import WorkflowContext
 from ._workflows._workflow_executor import SubWorkflowRequestMessage, SubWorkflowResponseMessage, WorkflowExecutor
@@ -335,6 +357,7 @@ __all__ = [
     "DEFAULT_MODE_SOURCE_ID",
     "DEFAULT_TODO_SOURCE_ID",
     "DEFAULT_TOOL_APPROVAL_SOURCE_ID",
+    "DISTANCE_FUNCTION_DIRECTION_HELPER",
     "EXCLUDED_KEY",
     "EXCLUDE_REASON_KEY",
     "GROUP_ANNOTATION_KEY",
@@ -376,6 +399,9 @@ __all__ = [
     "BaseAgent",
     "BaseChatClient",
     "BaseEmbeddingClient",
+    "BaseVectorCollection",
+    "BaseVectorSearch",
+    "BaseVectorStore",
     "CachingSkillsSource",
     "Case",
     "CharacterEstimatorTokenizer",
@@ -402,6 +428,7 @@ __all__ = [
     "DeduplicatingSkillsSource",
     "Default",
     "DelegatingSkillsSource",
+    "DistanceFunction",
     "Edge",
     "EdgeCondition",
     "EdgeDuplicationError",
@@ -420,6 +447,7 @@ __all__ = [
     "ExperimentalFeature",
     "FanInEdgeGroup",
     "FanOutEdgeGroup",
+    "FieldTypes",
     "FileAccessProvider",
     "FileCheckpointStorage",
     "FileHistoryProvider",
@@ -432,6 +460,10 @@ __all__ = [
     "FileSkillsSource",
     "FileStoreEntry",
     "FileSystemAgentFileStore",
+    "Filter",
+    "FilterGroup",
+    "FilterGroupOperator",
+    "FilterOperator",
     "FilteringSkillsSource",
     "FinalT",
     "FinishReason",
@@ -446,14 +478,18 @@ __all__ = [
     "FunctionalWorkflow",
     "FunctionalWorkflowAgent",
     "FunctionalWorkflowDefinition",
+    "GenerateVectors",
     "GeneratedEmbeddings",
     "GraphConnectivityError",
     "HistoryProvider",
     "InMemoryAgentFileStore",
     "InMemoryCheckpointStorage",
+    "InMemoryCollection",
     "InMemoryHistoryProvider",
     "InMemorySkillsSource",
+    "InMemoryStore",
     "InProcRunnerContext",
+    "IndexKind",
     "InlineSkill",
     "InlineSkillResource",
     "InlineSkillScript",
@@ -481,6 +517,7 @@ __all__ = [
     "MiddlewareTypes",
     "OuterFinalT",
     "OuterUpdateT",
+    "Param",
     "RawAgent",
     "ReleaseCandidateFeature",
     "ResponseStream",
@@ -491,6 +528,9 @@ __all__ = [
     "Runner",
     "RunnerContext",
     "SamplingApprovalCallback",
+    "SearchResponse",
+    "SearchResults",
+    "SearchType",
     "SecretString",
     "SelectiveToolCallCompactionStrategy",
     "ServiceSessionId",
@@ -519,6 +559,8 @@ __all__ = [
     "SupportsImageGenerationTool",
     "SupportsMCPTool",
     "SupportsShellTool",
+    "SupportsVectorSearch",
+    "SupportsVectorUpsert",
     "SupportsWebSearchTool",
     "SwitchCaseEdgeGroup",
     "SwitchCaseEdgeGroupCase",
@@ -544,6 +586,8 @@ __all__ = [
     "UsageDetails",
     "UserInputRequiredException",
     "ValidationTypeEnum",
+    "VectorStoreCollectionDefinition",
+    "VectorStoreField",
     "Workflow",
     "WorkflowAgent",
     "WorkflowBuilder",
@@ -557,6 +601,7 @@ __all__ = [
     "WorkflowEventType",
     "WorkflowException",
     "WorkflowExecutor",
+    "WorkflowInvocationKwargs",
     "WorkflowMessage",
     "WorkflowRunResult",
     "WorkflowRunState",
@@ -577,6 +622,7 @@ __all__ = [
     "create_always_approve_tool_with_arguments_response",
     "create_edge_runner",
     "create_harness_agent",
+    "create_vector_search_tool",
     "detect_media_type_from_base64",
     "enqueue_messages",
     "evaluate_agent",
@@ -600,6 +646,7 @@ __all__ = [
     "prepend_instructions_to_messages",
     "register_checkpoint_type",
     "register_state_type",
+    "register_vectorstoremodel",
     "resolve_agent_id",
     "response_handler",
     "set_agent_mode",
@@ -614,5 +661,6 @@ __all__ = [
     "validate_tool_mode",
     "validate_tools",
     "validate_workflow_graph",
+    "vectorstoremodel",
     "workflow",
 ]

{agent_framework_core-1.17.0 → agent_framework_core-1.18.0}/agent_framework/_compaction.py

@@ -1198,12 +1198,123 @@ def _tool_result_text(value: Any) -> str:
         if text_parts:
             return "\n".join(text_parts)
     if isinstance(value, Mapping):
-        return json.dumps(cast(Mapping[str, object], value), ensure_ascii=False)
+        try:
+            return json.dumps(cast(Mapping[str, object], value), ensure_ascii=False, default=str)
+        except (TypeError, ValueError):
+            return str(cast(object, value))
     return str(cast(object, value))
 
 
+def _format_summary_item_metadata(item: Content) -> str:
+    """Render safe metadata for non-text rich result items.
+
+    Never embeds binary payloads: data contents carry their bytes as a
+    base64 data URI and are represented by media type and path only.
+    """
+    details: list[str] = []
+    if item.media_type:
+        details.append(f"media_type={item.media_type}")
+    if item.type == "uri" and item.uri:
+        details.append(f"uri={item.uri}")
+    if item.type == "data":
+        path = item.additional_properties.get("path")
+        if isinstance(path, str) and path:
+            details.append(f"path={path}")
+    if item.file_id:
+        details.append(f"file_id={item.file_id}")
+    if item.name:
+        details.append(f"name={item.name}")
+    return f"{item.type} content" + (f" ({', '.join(details)})" if details else "")
+
+
+def _format_summary_result_items(items: Sequence[Content]) -> str:
+    """Render function_result items (text and error contents) for the summarizer transcript.
+
+    Rich results store their payload in ``items`` (for example the error
+    contents emitted by Monty and Hyperlight) while ``result`` only carries
+    the concatenated text. Returns an empty string when nothing is renderable
+    so callers can fall back to ``result``.
+    """
+    parts: list[str] = []
+    for item in items:
+        if item.type == "text" and item.text:
+            parts.append(item.text)
+        elif item.type == "error":
+            label = item.message or ""
+            if item.error_details:
+                label = f"{label}: {item.error_details}" if label else item.error_details
+            if item.error_code:
+                label = f"error({item.error_code}): {label}"
+            if label:
+                parts.append(label)
+        else:
+            label = _format_summary_item_metadata(item)
+            if label:
+                parts.append(label)
+    return "\n".join(parts)
+
+
+def _format_summary_content(content: Content) -> str:
+    """Render one content item for the summarizer input transcript.
+
+    Tool calls and results are rendered with their name, arguments, result
+    text, and call id so the summarizer sees the tool trajectory instead of a
+    bare content type. Text contents are aggregated via ``Message.text``
+    instead. Returns an empty string when the item has no structured rendering
+    of its own, so callers can fall back to the legacy rendering.
+    """
+    if content.type == "function_call":
+        arguments = _tool_result_text(content.arguments) if content.arguments is not None else ""
+        call = f"function_call {content.name or ''}({arguments})"
+        if content.call_id:
+            call += f" [call_id={content.call_id}]"
+        return call
+    if content.type == "function_result":
+        result_text = _format_summary_result_items(content.items) if content.items else ""
+        if not result_text:
+            result_text = _tool_result_text(content.result) if content.result is not None else "no result"
+        if content.exception:
+            result_text = f"error({content.exception}): {result_text}"
+        call_id_suffix = f" [call_id={content.call_id}]" if content.call_id else ""
+        return f"function_result: {result_text}{call_id_suffix}"
+    if content.type == "mcp_server_tool_call":
+        arguments = _tool_result_text(content.arguments) if content.arguments is not None else ""
+        call = f"mcp_tool_call {content.tool_name or ''}({arguments})"
+        if content.call_id:
+            call += f" [call_id={content.call_id}]"
+        return call
+    if content.type == "mcp_server_tool_result":
+        result_text = _tool_result_text(content.output)
+        if content.exception:
+            result_text = f"error({content.exception}): {result_text}"
+        call_id_suffix = f" [call_id={content.call_id}]" if content.call_id else ""
+        return f"mcp_tool_result: {result_text}{call_id_suffix}"
+    if content.type in ("function_approval_request", "function_approval_response"):
+        nested_call = content.function_call
+        name = "" if nested_call is None else nested_call.name or nested_call.tool_name or ""
+        label = "approval_request" if content.type == "function_approval_request" else "approval_response"
+        rendered = f"{label}: {name} [id={content.id}]"
+        if content.type == "function_approval_response":
+            rendered += f" approved={content.approved}"
+        return rendered
+    return ""
+
+
 def _format_summary_message(index: int, message: Message) -> str:
-    content_text = message.text
+    parts: list[str] = []
+    pending_text: list[str] = []
+    for content in message.contents:
+        rendered = _format_summary_content(content)
+        if rendered:
+            if pending_text:
+                parts.append(" ".join(pending_text))
+                pending_text = []
+            parts.append(rendered)
+        elif content.type == "text" and content.text:
+            pending_text.append(content.text)
+    if pending_text:
+        parts.append(" ".join(pending_text))
+    content_text = "; ".join(parts)
     if not content_text:
         content_text = ", ".join(content.type for content in message.contents)
     return f"{index}. [{message.role}] {content_text}"