[BREAKING] Python: Migrate FHA to responses==2.0.0b1 and add Foundry state store

[Tao Chen (TaoChenOSU)]

Motivation & Context

Closes #7532

FoundryStateStore is recently introduced in the latest azure.ai.agentserver SDK, which allows us to durably save data within Foundry Hosted Agent sessions. See the "Durable state storage" section here: https://pypi.org/project/azure-ai-agentserver-core/

Due to the package version bump, this PR also contains a lot of changes to accommodate the breaking changes introduced by the azure.ai.agentserver SDK.

Description & Review Guide

• What are the major changes?
  • Remove FoundrySessionStore, which is an implementation of the SessionStore that persists MAF agent sessions in FHA sessions' file system.
  • Replace FoundrySessionStore with a new FoundryAgentSessionStore that is backed by the FoundryStateStore.
  • Introduce StoreProvider and the default implementations, including AgentSessionStoreProvider, CheckpointStoreProvider, and FunctionApprovalStoreProvider, which will provide the actual store instance based on the environment (i.e. if the agent is hosted vs local). This also allows customers to customize FHA to use their storage solution.
  • Migrate all existing file-based store solutions to using FoundryStateStore, including FoundryAgentSessionStore, FoundryCheckpointStore, and FoundryFunctionApprovalStore.
  • Remove the non-streaming path of the inner agent, since Foundry manages streaming vs. non-streaming.
  • Changes across the board to match the breaking changes introduced by the new version.
• What is the impact of these changes?
  • This is a breaking change in how MAF FHA persists states. No API surface change.
• What do you want reviewers to focus on?
  • The provider pattern that switches between different underlying stores based on the runtime env.

Related Issue

Fixes #7352

Contribution Checklist

• The code builds clean without any errors or warnings
• All unit tests pass, and I have added new tests where possible
• The PR follows the Contribution Guidelines
• This PR is linked to an issue and there is no other open PR for this issue (see Related Issue above).
• This is not a breaking change. If it is a breaking change, add the breaking change label (or add "[BREAKING]" to the title prefix, before or after any language prefix) — a workflow keeps the label and title prefix in sync automatically.

[Copilot]

Pull request overview

Updates the Python Foundry Hosting integration to the azure-ai-agentserver-responses 2.0.0b1 API and replaces prior file-based persistence with Foundry State Store–backed implementations for hosted scenarios, aligning with the new storage API direction (Issue #7532).

Changes:

• Migrate ResponsesHostServer integration to azure-ai-agentserver-responses==2.0.0b1 (including streaming/event API adjustments).
• Introduce Foundry State Store–backed persistence for agent sessions, workflow checkpoints, and function approvals (with providers for hosted vs local).
• Update public exports/docs and add targeted unit tests for the new state store behaviors.

Reviewed changes

Copilot reviewed 12 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
python/uv.lock	Updates locked dependency graph for new agentserver package versions.
python/packages/foundry_hosting/pyproject.toml	Adjusts declared dependencies to the new azure-ai-agentserver-responses version line.
python/packages/foundry_hosting/README.md	Re-documents state store behavior for sessions/checkpoints/approvals.
python/packages/foundry_hosting/agent_framework_foundry_hosting/_state_store.py	Adds FoundryStateStore-backed session/checkpoint/approval stores + provider abstractions.
python/packages/foundry_hosting/agent_framework_foundry_hosting/_session_store.py	Removes the previous file-backed FoundrySessionStore implementation.
python/packages/foundry_hosting/agent_framework_foundry_hosting/_responses.py	Migrates host implementation to Responses 2.0 APIs and wires in new storage providers.
python/packages/foundry_hosting/agent_framework_foundry_hosting/init.py	Re-exports new state store types/providers as public surface area.
python/packages/foundry_hosting/tests/test_state_store.py	Adds unit coverage for the new Foundry-backed stores and providers.
python/packages/foundry_hosting/tests/test_responses.py	Updates/extends host tests for Responses 2.0 behavior and new storage/provider wiring.
python/packages/core/tests/core/test_foundry_namespace.py	Updates Foundry namespace exposure test for renamed session store symbol.
python/packages/core/AGENTS.md	Updates documentation for the Foundry session store symbol and backing implementation.
python/packages/core/agent_framework/foundry/init.pyi	Updates typing exports to include new hosting storage/provider symbols.
python/packages/core/agent_framework/foundry/init.py	Updates lazy re-export map for new hosting storage/provider symbols.
python/PACKAGE_STATUS.md	Updates package status references to the new hosted session store symbol/file.

[github-actions]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/foundry_hosting/agent_framework_foundry_hosting
_responses.py	711	95	86%	144–145, 159, 162–163, 213, 228, 290, 349–352, 388–389, 392, 396, 428, 507, 510, 514, 580, 642–643, 982, 994, 1446–1447, 1451, 1496, 1498, 1500, 1502, 1506, 1514, 1517–1521, 1523, 1533, 1537, 1550, 1584–1589, 1593–1594, 1602–1608, 1638–1639, 1641–1642, 1644, 1649, 1657–1658, 1660, 1665–1669, 1671, 1678–1679, 1681–1682, 1688, 1690–1694, 1704, 1710, 1734, 1740, 1746, 1748, 1750–1753, 1761, 1763
_state_store.py	154	0	100%
TOTAL	45618	4253	90%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
9240	36 💤	0 ❌	0 🔥	2m 29s ⏱️

[github-actions]

Automated Code Review

Reviewers: 2 | Confidence: 95% | Result: All clear

Reviewed: Correctness, Test Coverage

---

Automated review by TaoChenOSU's agents

[Evan Mattson (moonbox3)]

/review

[github-actions]

Agent Framework Review — Iteration 1

Completed passes: 4

Scope: full PR (4 commit(s)): ff8450b9fe0f, 4cf73d533ca7, 14cf002f7a00, 3df40fd8b17f

Review passes

• Correctness (gpt-5.6-sol) — The request path permits both conversation_id and previous_response_id, which can restore one session and persist it under another conversation, potentially overwriting unrelated state.
• Test Coverage (gpt-5.6-sol) — Two high-severity test coverage gaps could allow regressions in durable state storage to pass unnoticed: checkpoint backend selection is not asserted, and Foundry agent-session writes are not tested.
• Failure Modes (claude-opus-4.8) — No high-confidence issues found in this pass.
• Design Approach (claude-opus-4.8) — No high-confidence issues found in this pass.

[Evan Mattson (moonbox3)]

Shouldn't ContextScopedStoreProvider be included in the namespace shim too? It is exported from agent_framework_foundry_hosting/__init__.py, but it is missing from _IMPORTS here and from foundry/__init__.pyi (line 43 region), while StoreProvider and CheckpointStoreProvider are both there. An import agent_framework.foundry.ContextScopedStoreProvider would raises an error.