agent-framework-ag-ui 1.2.0__tar.gz → 1.2.2__tar.gz

{agent_framework_ag_ui-1.2.0 → agent_framework_ag_ui-1.2.2}/.gitignore

@@ -207,6 +207,10 @@ temp*/
 
 # AI
 **/.checkpoints/
+# Local AgentServer file store + crash-recovery HOME roots used by hosted samples
+**/.agentserver-state/
+**/.agentserver-state-*/
+**/.home-*/
 .claude/
 .omc/
 .omx/
@@ -245,6 +249,9 @@ python/dotnet-ref
 dotnet/filtered-*.slnx
 **/*.lscache
 
+# Local .NET build overrides
+/dotnet/Directory.Build.rsp
+
 # Local tool state
 .omc/
 .omx/

{agent_framework_ag_ui-1.2.0 → agent_framework_ag_ui-1.2.2}/AGENTS.md

@@ -40,9 +40,16 @@ AG-UI protocol integration for building agent UIs with the AG-UI standard.
 - `_approval_lifecycle.py` is the sole owner of approval occurrence registration, trusted aliases, authority
   validation, claims, terminal outcomes, and retry deduplication. Runner code normalizes AG-UI protocol values and
   projects lifecycle outcomes but must not maintain a parallel pending-approval registry.
+- Local tool-approval interrupt ids use the Agent Framework `function_call.id` occurrence identity; `toolCallId`
+  remains the provider/service `call_id`. Hosted approvals preserve the provider-issued approval request id. The
+  lifecycle stores these identities separately so resume responses carry the authoritative approval occurrence id
+  without rewriting tool-result correlation ids.
 - Default stateless conversation history is client-controlled, including historical tool calls and results. Never
   document conversational tool results as authorization or policy evidence; use deterministic server-side checks,
   server-validated approvals, or scoped authoritative snapshots.
+- AG-UI Thread and Run ids are client-owned protocol correlation ids. Service-session mode stores provider conversation
+  or response ids privately in the thread snapshot. Set `service_session_id_from_thread_id=True` only for compatibility
+  when the application intentionally uses a provider continuation id as its AG-UI Thread id.
 - `confirm_changes` snapshot cleanup resolves the synthetic confirmation back to its original `function_call_id`;
   it must never concatenate unrelated tool results or record accepted changes without a matching real result.
 - SSE keepalive is endpoint-owned transport behavior configured through

{agent_framework_ag_ui-1.2.0 → agent_framework_ag_ui-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-framework-ag-ui
-Version: 1.2.0
+Version: 1.2.2
 Summary: AG-UI protocol integration for Agent Framework
 Project-URL: homepage, https://aka.ms/agent-framework
 Project-URL: source, https://github.com/microsoft/agent-framework/tree/main/python
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: ag-ui-protocol<0.2,>=0.1.19
-Requires-Dist: agent-framework-core<2,>=1.15.0
+Requires-Dist: agent-framework-core<2,>=1.17.0
 Requires-Dist: fastapi<0.140.0,>=0.121.0
 Requires-Dist: httpx<1,>=0.28.1
 Requires-Dist: sse-starlette<4,>=3.4.5

{agent_framework_ag_ui-1.2.0 → agent_framework_ag_ui-1.2.2}/agent_framework_ag_ui/_a2ui/_agent.py

@@ -351,6 +351,15 @@ class A2UIAgent:
     def context_providers(self) -> Any:
         return getattr(self.inner_agent, "context_providers", [])
 
+    @property
+    def service_session_state_keys(self) -> Any:
+        return getattr(self.inner_agent, "service_session_state_keys", ())
+
+    def __getattr__(self, name: str) -> Any:
+        if name == "create_conversation":
+            return getattr(self.inner_agent, name)
+        raise AttributeError(name)
+
     # -- public run -------------------------------------------------------
 
     def run(self, messages: Any = None, *, stream: bool = False, **kwargs: Any) -> Any:

{agent_framework_ag_ui-1.2.0 → agent_framework_ag_ui-1.2.2}/agent_framework_ag_ui/_agent.py

@@ -26,6 +26,7 @@ class AgentConfig:
         require_confirmation: bool = True,
         snapshot_store: AGUIThreadSnapshotStore | None = None,
         a2ui_config: dict[str, Any] | None = None,
+        service_session_id_from_thread_id: bool = False,
     ):
         """Initialize agent configuration.
 
@@ -33,6 +34,8 @@ class AgentConfig:
             state_schema: Optional state schema for state management; accepts dict or Pydantic model/class
             predict_state_config: Configuration for predictive state updates
             use_service_session: Whether the agent session is service-managed
+            service_session_id_from_thread_id: Compatibility option that treats the
+                client-owned AG-UI Thread id as the provider service-session id.
             require_confirmation: When True (default), emit a ``confirm_changes`` tool call for
                 approval-gated tools so a human-in-the-loop frontend can prompt for approval, and require
                 confirmation for predictive state updates. When False, no ``confirm_changes`` call is
@@ -46,6 +49,7 @@ class AgentConfig:
         self.state_schema = self._normalize_state_schema(state_schema)
         self.predict_state_config = predict_state_config or {}
         self.use_service_session = use_service_session
+        self.service_session_id_from_thread_id = service_session_id_from_thread_id
         self.require_confirmation = require_confirmation
         self.snapshot_store = snapshot_store
         self.a2ui_config = a2ui_config
@@ -96,6 +100,7 @@ class AgentFrameworkAgent:
         use_service_session: bool = False,
         snapshot_store: AGUIThreadSnapshotStore | None = None,
         a2ui_config: dict[str, Any] | None = None,
+        service_session_id_from_thread_id: bool = False,
     ):
         """Initialize the AG-UI compatible agent wrapper.
 
@@ -110,6 +115,8 @@ class AgentFrameworkAgent:
                 confirmation for predictive state updates. When False, no ``confirm_changes`` call is
                 emitted; tools remain gated server-side.
             use_service_session: Whether the agent session is service-managed
+            service_session_id_from_thread_id: Compatibility option that treats the
+                client-owned AG-UI Thread id as the provider service-session id.
             snapshot_store: Optional AG-UI Thread Snapshot store. Snapshot persistence remains inactive unless
                 endpoint setup also provides an explicit Snapshot Scope resolver.
             a2ui_config: Optional backend A2UI config consumed by auto-injection.
@@ -122,6 +129,7 @@ class AgentFrameworkAgent:
             state_schema=state_schema,
             predict_state_config=predict_state_config,
             use_service_session=use_service_session,
+            service_session_id_from_thread_id=service_session_id_from_thread_id,
             require_confirmation=require_confirmation,
             snapshot_store=snapshot_store,
             a2ui_config=a2ui_config,