Skip to content

Add child workflow versioning overrides - #3117

Merged
Quinn-With-Two-Ns merged 2 commits into
mainfrom
quinn/child-workflow-versioning-override
Oct 2, 2026
Merged

Quinn-With-Two-Ns merged 2 commits into
mainfrom
quinn/child-workflow-versioning-override

Conversation

@Quinn-With-Two-Ns

@Quinn-With-Two-Ns Quinn-With-Two-Ns commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

What was changed

Add child workflow versioning overrides

Why?

Match Go SDK temporalio/sdk-go#2707

Checklist

  1. Closes

  2. How was this tested:

  1. Any docs updates needed?

Note

Medium Risk
Changes worker-deployment routing for child starts and introduces new failure semantics; behavior depends on server 1.32+ and is marked experimental, but existing callers are unaffected unless they opt in.

Overview
Adds experimental child workflow versioning overrides so a parent can route a child independently of its own deployment/versioning settings, aligning with the Go SDK.

ChildWorkflowOptions.Builder.setVersioningOverride accepts existing pinned and auto-upgrade overrides plus a new VersioningOverride.OneTimeVersioningOverride (initial target build until one workflow task completes, then behavior follows the completing worker). Overrides are serialized on the start-child command via ProtoConverters and SyncWorkflowContext.

When the server rejects an override, child start failure is surfaced as ChildWorkflowFailure with cause InvalidVersioningOverrideFailure (mapped from START_CHILD_WORKFLOW_EXECUTION_FAILED_CAUSE_INVALID_VERSIONING_OVERRIDE in ChildWorkflowStateMachine). Temporal Server ≥ 1.32.0 is required for overrides and one-time routing.

Integration tests in WorkerVersioningTest cover pinned, auto-upgrade, and one-time child override routing across multiple worker build IDs.

Reviewed by Cursor Bugbot for commit 4986cb8. Bugbot is set up for automated code reviews on this repo. Configure here.

@Quinn-With-Two-Ns
Quinn-With-Two-Ns requested a review from a team as a code owner October 2, 2026 16:07

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 4986cb8. Configure here.

@Quinn-With-Two-Ns
Quinn-With-Two-Ns merged commit be01e60 into main Oct 2, 2026
20 checks passed
@Quinn-With-Two-Ns
Quinn-With-Two-Ns deleted the quinn/child-workflow-versioning-override branch October 2, 2026 21:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants