[BREAKING] Python: Refactor SharedState to State with sync methods and superstep caching

[Evan Mattson (moonbox3)]

Motivation and Context

Refactors the workflow state management system with breaking changes:

• Rename SharedState -> State class and _shared_state.py -> _state.py
• Convert all async methods to sync (Python dicts are thread-safe; async was unnecessary overhead)
• Implement superstep caching: writes go to pending cache, committed at superstep boundary via commit(), which is now consistent with the .NET behavior.
• Add get(key, default=None) API that returns default instead of raising KeyError
• Add has(key) method for existence checks
• Rename WorkflowCheckpoint.shared_state → WorkflowCheckpoint.state
• Remove State from public exports (internal implementation detail)

Breaking Changes

Before	After
SharedState	State
ctx.shared_state	ctx.state
await ctx.get_shared_state(key)	ctx.get_state(key, default=None)
await ctx.set_shared_state(key, value)	ctx.set_state(key, value)
checkpoint.shared_state	checkpoint.state

Description

• Closes Python: Refactor State class - rename, simplify, and implement superstep caching #3525
• Closes Python: Clean up public API surface and kwargs propagation #3526

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the Contribution Guidelines
• All unit tests pass, and I have added new tests where possible
• Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

[Mark Wallace (markwallace-microsoft)]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/core/agent_framework/_workflows
_agent_executor.py	160	22	86%	98, 146, 164–165, 216–217, 219–220, 252–254, 262–264, 274–276, 278, 282, 286, 290–291
_checkpoint.py	121	2	98%	184–185
_checkpoint_summary.py	27	4	85%	36–39
_const.py	6	0	100%
_edge_runner.py	162	13	91%	53, 58, 71, 138–139, 143, 150, 206, 211, 355–356, 360, 401
_executor.py	173	10	94%	212, 334, 336, 345, 365, 368, 475, 480, 490, 649
_runner.py	218	32	85%	132–133, 176–179, 183, 224–226, 251–252, 254, 289–291, 315–319, 323, 358, 362, 364, 370, 378–381, 394, 430
_runner_context.py	168	6	96%	84, 87, 383, 403, 491, 495
_state.py	43	0	100%
_workflow.py	268	19	92%	89, 267–269, 271–272, 290, 294, 322, 424, 705, 747, 752, 755, 774–776, 789, 857
_workflow_context.py	157	9	94%	62–63, 71, 75, 89, 165, 190, 308, 427
_workflow_executor.py	173	43	75%	96, 445, 456, 468–471, 474–476, 479–480, 482, 485–487, 490–494, 498–499, 508, 513, 547, 573–578, 581, 584, 592, 597, 608, 618, 622, 628, 632, 642, 646
TOTAL	16362	1913	88%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
3989	221 💤	0 ❌	0 🔥	1m 5s ⏱️

[Copilot]

Pull request overview

This PR implements a breaking refactoring of workflow state management, renaming SharedState to State, converting all async methods to sync, and implementing superstep caching semantics to align with .NET behavior.

Changes:

• Renamed SharedState class to State and file _shared_state.py to _state.py
• Converted all state methods from async to sync (removing asyncio.Lock)
• Implemented superstep caching: writes go to pending buffer, committed at boundaries via commit()
• Added get(key, default=None) API and has(key) method
• Renamed WorkflowCheckpoint.shared_state → WorkflowCheckpoint.state
• Updated all references across codebase (workflow context, runner, executors, tests, samples)

Reviewed changes

Copilot reviewed 47 out of 47 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
_state.py	New State class with sync methods and superstep caching implementation
_workflow.py	Updated to use State with commit() call after kwargs initialization
_runner.py	Integrated commit() at superstep boundaries
_workflow_context.py	Changed to sync get_state/set_state methods
_checkpoint.py	Renamed shared_state field to state
__init__.py	Updated exports (but State still exported - should be removed)
Test files	Updated all test mocks and assertions to use State
Sample files	Updated comments and documentation references
Frontend	Updated TypeScript interfaces and references