microsoft · Tao Chen (TaoChenOSU) · Aug 10, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026
diff --git a/python/PACKAGE_STATUS.md b/python/PACKAGE_STATUS.md
@@ -140,8 +140,8 @@ listed below.
 
 - `agent-framework-core`: `SessionStore` and `FileSessionStore` from
   `agent_framework/_sessions.py`
-- `agent-framework-foundry-hosting`: `FoundrySessionStore` from
-  `agent_framework_foundry_hosting/_session_store.py`
+- `agent-framework-foundry-hosting`: `FoundryAgentSessionStore` from
+  `agent_framework_foundry_hosting/_state_store.py`
 
 #### `TO_PROMPT_AGENT`
 

diff --git a/python/packages/core/AGENTS.md b/python/packages/core/AGENTS.md
@@ -213,8 +213,8 @@ agent_framework/
 ### Foundry (`foundry/`)
 
 - **`FoundryChatClient`** - Chat client for Microsoft Foundry project endpoints
-- **`FoundrySessionStore`** - Experimental Foundry-hosting session store, lazily re-exported from
-  `agent-framework-foundry-hosting`; currently file-backed and scoped by Agent Server request context
+- **`FoundryAgentSessionStore`** - Experimental Foundry-hosting session store, lazily re-exported from
+  `agent-framework-foundry-hosting`; currently backed by `azure.ai.agentserver.core.storage.FoundryStateStore`
 
 ## Key Patterns
 

diff --git a/python/packages/core/agent_framework/foundry/__init__.py b/python/packages/core/agent_framework/foundry/__init__.py
@@ -32,7 +32,15 @@
     "FoundryEmbeddingSettings": ("agent_framework_foundry", "agent-framework-foundry"),
     "FoundryEvals": ("agent_framework_foundry", "agent-framework-foundry"),
     "FoundryMemoryProvider": ("agent_framework_foundry", "agent-framework-foundry"),
-    "FoundrySessionStore": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "FoundryAgentSessionStore": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "StoreProvider": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "AgentSessionStoreProvider": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "CheckpointStoreProvider": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "FoundryCheckpointStore": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "ContextScopedStoreProvider": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "FoundryFunctionApprovalStore": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "FunctionApprovalStore": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
+    "FunctionApprovalStoreProvider": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
     "FoundryToolbox": ("agent_framework_foundry_hosting", "agent-framework-foundry-hosting"),
     "FoundryLocalChatOptions": ("agent_framework_foundry_local", "agent-framework-foundry-local"),
     "FoundryLocalClient": ("agent_framework_foundry_local", "agent-framework-foundry-local"),

diff --git a/python/packages/core/agent_framework/foundry/__init__.pyi b/python/packages/core/agent_framework/foundry/__init__.pyi
@@ -30,10 +30,18 @@ from agent_framework_foundry import (
     to_prompt_agent,
 )
 from agent_framework_foundry_hosting import (
-    FoundrySessionStore,
+    AgentSessionStoreProvider,
+    CheckpointStoreProvider,
+    ContextScopedStoreProvider,
+    FoundryAgentSessionStore,
+    FoundryCheckpointStore,
+    FoundryFunctionApprovalStore,
     FoundryToolbox,
+    FunctionApprovalStore,
+    FunctionApprovalStoreProvider,
     InvocationsHostServer,
     ResponsesHostServer,
+    StoreProvider,
 )
 from agent_framework_foundry_local import (
     FoundryLocalChatOptions,
@@ -42,25 +50,32 @@ from agent_framework_foundry_local import (
 )
 
 __all__ = [
+    "AgentSessionStoreProvider",
     "AnalysisSection",
     "AnthropicFoundryClient",
+    "CheckpointStoreProvider",
     "ContentUnderstandingContextProvider",
+    "ContextScopedStoreProvider",
     "DocumentStatus",
     "FileSearchBackend",
     "FileSearchConfig",
     "FoundryAgent",
+    "FoundryAgentSessionStore",
     "FoundryChatClient",
     "FoundryChatOptions",
+    "FoundryCheckpointStore",
     "FoundryEmbeddingClient",
     "FoundryEmbeddingOptions",
     "FoundryEmbeddingSettings",
     "FoundryEvals",
+    "FoundryFunctionApprovalStore",
     "FoundryLocalChatOptions",
     "FoundryLocalClient",
     "FoundryLocalSettings",
     "FoundryMemoryProvider",
-    "FoundrySessionStore",
     "FoundryToolbox",
+    "FunctionApprovalStore",
+    "FunctionApprovalStoreProvider",
     "GeneratedEvaluatorRef",
     "InvocationsHostServer",
     "RawAnthropicFoundryClient",
@@ -69,6 +84,7 @@ __all__ = [
     "RawFoundryChatClient",
     "RawFoundryEmbeddingClient",
     "ResponsesHostServer",
+    "StoreProvider",
     "evaluate_foundry_target",
     "evaluate_traces",
     "to_prompt_agent",

diff --git a/python/packages/core/tests/core/test_foundry_namespace.py b/python/packages/core/tests/core/test_foundry_namespace.py
@@ -11,20 +11,20 @@
 
 FoundryChatClient = _foundry.FoundryChatClient
 FoundryMemoryProvider = _foundry.FoundryMemoryProvider
-FoundrySessionStore = _foundry_hosting.FoundrySessionStore
+FoundryAgentSessionStore = _foundry_hosting.FoundryAgentSessionStore
 ResponsesHostServer = _foundry_hosting.ResponsesHostServer
 FoundryLocalClient = _foundry_local.FoundryLocalClient
 
 
 def test_foundry_namespace_exposes_cloud_and_local_symbols() -> None:
     assert foundry.FoundryChatClient is FoundryChatClient
     assert foundry.FoundryMemoryProvider is FoundryMemoryProvider
-    assert foundry.FoundrySessionStore is FoundrySessionStore
+    assert foundry.FoundryAgentSessionStore is FoundryAgentSessionStore
     assert foundry.ResponsesHostServer is ResponsesHostServer
     assert foundry.FoundryLocalClient is FoundryLocalClient
     assert "FoundryChatClient" in dir(foundry)
     assert "FoundryLocalClient" in dir(foundry)
-    assert "FoundrySessionStore" in dir(foundry)
+    assert "FoundryAgentSessionStore" in dir(foundry)
     assert "ResponsesHostServer" in dir(foundry)
 
 

diff --git a/python/packages/foundry_hosting/README.md b/python/packages/foundry_hosting/README.md
@@ -2,67 +2,23 @@
 
 This package provides the integration of Agent Framework agents and workflows with the Foundry Agent Server, which can be hosted on Foundry infrastructure.
 
-`ResponsesHostServer` persists the Agent Framework `AgentSession` used by regular
-agents in addition to the Responses provider's message history. By default it
-uses the experimental `FoundrySessionStore` under `/.sessions` when hosted and
-an in-memory `SessionStore` locally. Hosted snapshots are partitioned by the
-Agent Server request context's platform user ID. Snapshot filenames use the
-Responses `conversation_id` or `response_id`, depending on the continuation
-mode.
+## State store
 
-Foundry's session file API exposes the hosted `$HOME` directory as `/`, so the
-API path `/.sessions` is stored on disk at `$HOME/.sessions`.
+### Agent Sessions
 
-Workflow agents continue to use their existing checkpoint storage layout.
+`ResponsesHostServer` persists the Agent Framework `AgentSession` durably. By default it
+uses the `FoundryAgentSessionStore` when hosted and an in-memory `SessionStore` locally.
+When hosted, the stored sessions will be isolated by the platform user ID and scoped
+under `agent_sessions`.
 
-## Foundry session isolation
+### Workflow checkpoints
 
-`FoundrySessionStore` currently subclasses core's `FileSessionStore`. It reads
-the active request through `azure.ai.agentserver.core.get_request_context()` and
-validates the platform `user_id` (the same `x-agent-user-id` value exposed as
-`ResponseContext.platform_context.user_id_key`) before selecting its on-disk
-directory.
+`ResponsesHostServer` persists workflow checkpoints durably. By default, it uses the
+`FoundryCheckpointStore` when hosted and an in-memory `InMemoryCheckpointStorage` locally.
+When hosted, the stored checkpoints will be isolated by the platform user ID and scoped
+under `checkpoints`.
 
-Regular-agent session snapshots use the platform user ID and a Responses key:
+### Function approvals
 
-```text
-/.sessions/<user-id>/<conversation-id-or-response-id>.json
-```
-
-A Foundry session controls hosted compute and filesystem lifetime and may host
-multiple users and Responses conversations. The Foundry session ID is not used
-as the MAF session identifier.
-
-When `conversation_id` is used, the host reads and writes the same snapshot
-under that ID. When `previous_response_id` is used, the host reads that response
-snapshot, runs the loaded MAF session, and writes the updated snapshot under the
-current response's `response_id`. Multiple responses can therefore branch from
-one prior response without overwriting its snapshot.
-
-Foundry does not infer the hosted `agent_session_id` from
-`previous_response_id`. Callers using response chains must also reuse the
-`agent_session_id` returned by the previous response so the request reaches the
-same sandbox and `$HOME/.sessions` filesystem. Conversation objects bind to a
-stable hosted session automatically.
-
-Workflow checkpoints and function approvals preserve the existing Foundry
-Hosting layout. Hosted paths insert the validated raw platform user ID:
-
-```text
-/.checkpoints/<user-id>/<context-id>/
-/.function_approvals/<user-id>/approval_requests.json
-```
-
-Local workflow checkpoints use `{cwd}/.checkpoints/<context-id>/`, and local
-function approvals remain in memory.
-
-Hosted requests require container protocol `2.0.0`. The v2-only request
-`call_id` is checked before session, checkpoint, or approval storage is used,
-and a missing platform user ID fails closed. Regular agents also require the
-normal Responses continuation ID for restoration. Local requests may remain
-unscoped.
-
-The Foundry-specific store type intentionally hides the current filesystem
-implementation from `ResponsesHostServer` setup. A future version may move
-`FoundrySessionStore` to a Foundry storage API without changing the host's
-default configuration.
+`ResponsesHostServer` persists function approvals durably. By default, it uses the
+`FoundryFunctionApprovalStore` when hosted and an in-memory `InMemoryFunctionApprovalStore` locally. When hosted, the stored approvals will be isolated by the platform user ID and scoped under `function_approvals`.
diff --git a/python/packages/foundry_hosting/agent_framework_foundry_hosting/__init__.py b/python/packages/foundry_hosting/agent_framework_foundry_hosting/__init__.py
@@ -4,7 +4,17 @@
 
 from ._invocations import InvocationsHostServer
 from ._responses import ResponsesHostServer
-from ._session_store import FoundrySessionStore
+from ._state_store import (
+    AgentSessionStoreProvider,
+    CheckpointStoreProvider,
+    ContextScopedStoreProvider,
+    FoundryAgentSessionStore,
+    FoundryCheckpointStore,
+    FoundryFunctionApprovalStore,
+    FunctionApprovalStore,
+    FunctionApprovalStoreProvider,
+    StoreProvider,
+)
 from ._toolbox import FoundryToolbox
 
 try:
@@ -13,8 +23,16 @@
     __version__ = "0.0.0"
 
 __all__ = [
-    "FoundrySessionStore",
+    "AgentSessionStoreProvider",
+    "CheckpointStoreProvider",
+    "ContextScopedStoreProvider",
+    "FoundryAgentSessionStore",
+    "FoundryCheckpointStore",
+    "FoundryFunctionApprovalStore",
     "FoundryToolbox",
+    "FunctionApprovalStore",
+    "FunctionApprovalStoreProvider",
     "InvocationsHostServer",
     "ResponsesHostServer",
+    "StoreProvider",
 ]