Skip to content

.NET: Decouple Checkpointing from Run/StreamAsync APIs#4037

Draft
lokitoth wants to merge 7 commits intomainfrom
dev/dotnet_workflow/decouple_checkpointing
Draft

.NET: Decouple Checkpointing from Run/StreamAsync APIs#4037
lokitoth wants to merge 7 commits intomainfrom
dev/dotnet_workflow/decouple_checkpointing

Conversation

@lokitoth
Copy link
Member

Motivation and Context

To support execution environments that do not support bring-your-own Checkpointing, we need to remove the ability to introduce CheckpointManager during a RunAsync / StreamAsync call.

Description

Change Checkpointing to be a configuration of IWorkflowExecutionEnvironment intrinsically. This changes how checkpointing is configured for InProcessExecutionEnvironment (now using WithCheckpointing)

BREAKING: Changes how Checkpointing is attached for InMemory execution.

Currently in draft form pending #3792

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.

* Adds annotations to Declarative workflow executors
* Implicit filter in collection loops
* Remove debug / usused / superfluous code
* Fix ProtocolBuilder implicit output registrations
* Fix logic error in ExecuteRouteGeneratorTests.ClassWithManualConfigureProtocol_DoesNotGenerate
…ecutor

* Fixes an issue where ConcurrentEndExecutor is not expecting TurnTokens.
* Updates Declarative pacakge to rely on chained-delegation Send/Yield registration
* Renames DeclarativeActionExectuor's new ExecuteAsync to ExecuteActionAsync to avoid colliding with Executor.ExecutoeAsync
With this change, Checkpointing becomes an property of an IWorkflowExecutionEnvironment. This lets environments that are tightly-coupled to their CheckpointManager avoid needing to present APIs that would not work (e.g. taking in an InMemory CheckpointManager for Durable Tasks, for example)
@lokitoth lokitoth added the .NET label Feb 18, 2026
@lokitoth lokitoth added workflows Related to Workflows in agent-framework breaking change Introduces changes that are not backward compatible and may require updates to dependent code. labels Feb 18, 2026
@github-actions github-actions bot changed the title Decouple Checkpointing from Run/StreamAsync APIs .NET: Decouple Checkpointing from Run/StreamAsync APIs Feb 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

breaking change Introduces changes that are not backward compatible and may require updates to dependent code. .NET workflows Related to Workflows in agent-framework

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant

Comments