Skip to content

Workflow Command Pagination API#800

Open
simvlad wants to merge 1 commit into
mainfrom
simvlad/workflow-task-completion-pagination
Open

Workflow Command Pagination API#800
simvlad wants to merge 1 commit into
mainfrom
simvlad/workflow-task-completion-pagination

Conversation

@simvlad

@simvlad simvlad commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

What changed?
Added a paginated workflow task completion API:

  • page_number and intermediate_page fields on RespondWorkflowTaskCompletedRequest, letting a workflow task completion be split across multiple "page" requests sharing one task token.
  • workflow_task_completion_pagination namespace capability flag that SDKs must check before sending paginated requests.
  • WorkflowTaskCompletionBufferLostFailure signaling the server dropped buffered pages and the client should resend all pages from page 0.

Why?
Large workflow task completions can exceed request size limits. Pagination lets workers split a single completion across multiple requests.

Breaking changes
None. New fields/messages are additive; pagination is gated behind the namespace capability.

Server PR
TODO

@simvlad simvlad requested review from a team June 11, 2026 17:06
@simvlad simvlad marked this pull request as draft June 11, 2026 17:06
@simvlad simvlad marked this pull request as ready for review June 17, 2026 21:45
@simvlad simvlad force-pushed the simvlad/workflow-task-completion-pagination branch from 351022e to f8bb481 Compare June 17, 2026 21:57
bool poller_autoscaling_auto_enroll = 13;
// True if the namespace supports paginated workflow task completion, i.e.
// `RespondWorkflowTaskCompleted` requests split across multiple pages. SDKs must check this
// capability before sending a request with `intermediate_page` set to true.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
// capability before sending a request with `intermediate_page` set to true.
// capability before sending a request with `intermediate_page` set to true or with a nonzero value in `page_number`.

To be complete

Alternatively you could just remove this bit since I think the documentation on the actual fields is more important.

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.

3 participants