Python: [BREAKING] Update functional workflow continuation handling - #7521
Open
moonbox3 wants to merge 7 commits into
Open
Python: [BREAKING] Update functional workflow continuation handling#7521moonbox3 wants to merge 7 commits into
moonbox3 wants to merge 7 commits into
Conversation
Use a versioned opaque single-use token on WorkflowRunResult, validate it before request correlation, consume it immediately before replayed user code, and rotate it on each pause. Carry the same explicit authority through streaming and non-streaming FunctionalWorkflowAgent responses. Files changed: functional workflow/runtime result APIs, functional HITL regression tests, core agent guidance, and the functional HITL sample. Next iteration: enforce pending-state overlap and token-authorized abandonment, then document and test checkpoint authorization boundaries. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Reject fresh messages and checkpoint restores while an in-memory continuation is pending. Add token-authorized abandonment on FunctionalWorkflow and FunctionalWorkflowAgent, and clear retained replay state atomically when authority is consumed while preserving the active message for token rotation and checkpoints. Files changed: functional workflow runtime and agent adapter, functional lifecycle regression tests, and core workflow guidance. Next iteration: preserve and document authorized checkpoint continuation boundaries. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Treat checkpoint restore as a host- and storage-authorized path independent of process-local continuation tokens, and issue fresh authority whenever restored execution pauses again. Cover default and per-run storage, deterministic and custom request IDs, token rotation, and checkpoint-plus-response restore. Files changed: functional workflow and checkpoint interface guidance, functional checkpoint lifecycle tests, the functional HITL sample, and core workflow guidance. Next iteration: run the final repository-wide Python validation gates. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Run the complete Python workspace checks, aggregate coverage suite, repository hooks, and core package build from the final combined worktree. Keep the validation iteration code-neutral because all gates pass without corrective changes. Files changed: none; this commit records the final validation gate. Blockers: none. Next iteration: no remaining AFK tasks. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Publish retained continuation state only after checkpoint persistence succeeds, and cover reuse after a transient save failure. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78
moonbox3
temporarily deployed
to
github-app-auth
August 5, 2026 04:49 — with 
GitHub Actions
Inactive
moonbox3
temporarily deployed
to
github-app-auth
August 5, 2026 04:49 — with
GitHub Actions
Inactive
moonbox3
temporarily deployed
to
github-app-auth
August 5, 2026 04:49 — with
GitHub Actions
Inactive
moonbox3
marked this pull request as ready for review
August 5, 2026 04:50
moonbox3
temporarily deployed
to
github-app-auth
August 5, 2026 04:50 — with
GitHub Actions
Inactive
moonbox3
commented
Aug 5, 2026
Contributor
Python Test Coverage Report •
Python Unit Test Overview
|
||||||||||||||||||||||||||||||||||||||||
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the Python functional workflow “HITL” (human-in-the-loop) continuation model so that response-only resumes require an explicit, single-use continuation token, aligning behavior across pause, retry, and checkpoint-restore flows.
Changes:
- Introduces and plumbs an opaque
continuation_tokenthrough functional workflow results and the functional workflow agent surface to authorize response-only in-memory resumes. - Tightens functional workflow state transitions by rejecting fresh input / checkpoint-restore while an in-memory continuation is pending, and adds explicit
abandon_continuation(...)support. - Updates docs, samples, and test coverage to reflect the new continuation-token behavior (including streaming final responses carrying the token).
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| python/samples/03-workflows/functional/hitl_review.py | Updates the HITL sample to resume using the returned continuation token. |
| python/packages/core/tests/workflow/test_functional_workflow.py | Adds/updates unit tests covering token-required resume, rejection paths, abandon behavior, and streaming token propagation. |
| python/packages/core/AGENTS.md | Documents the new functional workflow continuation token semantics and constraints. |
| python/packages/core/agent_framework/_workflows/_workflow.py | Extends WorkflowRunResult to carry an optional continuation_token. |
| python/packages/core/agent_framework/_workflows/_functional.py | Implements functional continuation authority (issue/validate/consume), state clearing, abandon support, and agent propagation. |
| python/packages/core/agent_framework/_workflows/_checkpoint.py | Clarifies that checkpoint IDs are locators, not authorization credentials. |
Contributor
There was a problem hiding this comment.
Automated Code Review
Reviewers: 2 | Confidence: 86%
✓ Correctness
Found one cancellation-path correctness issue that can permanently lock the workflow after consuming its continuation token.
✓ Test Coverage
No actionable test-coverage gaps identified in the provided diff.
Automated review by moonbox3's agents
Add owner recovery for lost tokens, harden malformed token validation, preserve consistent failure surfaces, and keep agent pending state aligned with resumable workflow state. Document process-local single-use continuation semantics and extend regression coverage across direct, streaming, checkpoint, and agent paths. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78
moonbox3
temporarily deployed
to
github-app-auth
August 5, 2026 05:44 — with
GitHub Actions
Inactive
Release the workflow run guard when cancellation interrupts resumed user code while keeping the single-use continuation token consumed. Replace sample assertions with explicit runtime checks and add cancellation regression coverage. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78
moonbox3
temporarily deployed
to
github-app-auth
August 5, 2026 06:10 — with
GitHub Actions
Inactive
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation & Context
Align functional workflow continuation behavior across pause, retry, and restore paths.
Description & Review Guide
Related Issue
Internal tracking.
Contribution Checklist
breaking changelabel (or add "[BREAKING]" in the title prefix, before or after a language prefix) — a workflow keeps the label and title prefix in sync automatically.