microsoft / microsoft/agent-framework
Python: Support recursive checkpointing for nested sub-workflows
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 13.6k
- Forks
- 2.3k
- Avg merge
- 2d 45m
- Merged PRs (30d)
- 358
Description
## Summary
Extend workflow checkpointing to recursively checkpoint sub-workflows at arbitrary nesting depth. Currently, checkpointing only works one sub-layer deep.
## Problem
A workflow can contain sub-workflows, which can themselves contain further sub-workflows. The current checkpointing implementation only captures state for one level of sub-workflow nesting. If a sub-workflow contains its own sub-workflows, those deeper layers are not checkpointed, meaning pause/resume will not correctly restore state for deeply nested workflow graphs.
## Expected behavior
Checkpointing should recursively traverse the full sub-workflow tree, capturing and restoring state at every nesting level.
## Scope
- `packages/core/agent_framework/_workflows/_checkpoint.py` and related checkpoint logic
- Sub-workflow execution and rehydration paths
- Tests covering multi-level nested sub-workflows with checkpoint/resume
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.