Skip to content

[Fix #1151] Replace output with outputUri in lifecycle completed events#1172

Open
ricardozanini wants to merge 6 commits into
open-workflow-specification:mainfrom
ricardozanini:fix/1151-lifecycle-event-output-reference
Open

[Fix #1151] Replace output with outputUri in lifecycle completed events#1172
ricardozanini wants to merge 6 commits into
open-workflow-specification:mainfrom
ricardozanini:fix/1151-lifecycle-event-output-reference

Conversation

@ricardozanini

Copy link
Copy Markdown
Collaborator

Summary

  • Replace output (map) with outputUri (uri) in both Workflow Completed and Task Completed lifecycle events
  • Adopts the Claim Check pattern: instead of embedding potentially large payloads, events carry a URI pointing to where the output can be fetched
  • This prevents exceeding the CloudEvents 64KB size limit which could cause intermediaries to drop or truncate events

Breaking change

This removes the output property from completed lifecycle events. Runtime implementations must emit outputUri instead.

Fixes #1151

…in lifecycle completed events

Replace the output map property with an outputUri in both Workflow
Completed and Task Completed lifecycle events. This adopts the Claim
Check pattern to avoid exceeding CloudEvents 64KB size limits.

Signed-off-by: Ricardo Zanini <[email protected]>
Copilot AI review requested due to automatic review settings July 23, 2026 19:04
@ricardozanini
ricardozanini requested a review from cdavernas as a code owner July 23, 2026 19:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the lifecycle event documentation to stop embedding potentially large output payloads in Workflow Completed and Task Completed events, replacing them with an outputUri reference aligned with the Claim Check pattern to avoid CloudEvents size-limit issues.

Changes:

  • Replaces output (map) with outputUri (uri) for Workflow Completed event properties and example.
  • Replaces output (map) with outputUri (uri) for Task Completed event properties and example.
Comments suppressed due to low confidence (1)

dsl-reference.md:1641

  • Same as above: this description suggests output could still be embedded ("instead of embedding the output directly"), but the spec here removes the embedded output field. Rephrase to explicitly describe the Claim Check intent (reference-only) to avoid confusion for implementers.
| outputUri | `uri` | `no` | A URI pointing to the task's output data, if any. Implementations **should** use this [Claim Check](https://www.enterpriseintegrationpatterns.com/patterns/messaging/StoreInLibrary.html) approach instead of embedding the output directly, to avoid exceeding [CloudEvents size limits](https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#size-limits). |

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread dsl-reference.md Outdated
Co-authored-by: Copilot Autofix powered by AI <[email protected]>
Copilot AI review requested due to automatic review settings July 23, 2026 19:30

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

dsl-reference.md:1641

  • This text says implementations should use the Claim Check approach "instead of embedding the output directly", but output has been removed from this event. Rewording to match the Workflow Completed Event phrasing would avoid implying an alternative embedding mechanism exists.
| outputUri | `uri` | `no` | A URI pointing to the task's output data, if any. Implementations **should** use this [Claim Check](https://www.enterpriseintegrationpatterns.com/patterns/messaging/StoreInLibrary.html) approach instead of embedding the output directly, to avoid exceeding [CloudEvents size limits](https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#size-limits). |

Comment thread dsl-reference.md Outdated
Co-authored-by: Copilot Autofix powered by AI <[email protected]>
Copilot AI review requested due to automatic review settings July 23, 2026 19:34

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread dsl-reference.md Outdated
Co-authored-by: Copilot Autofix powered by AI <[email protected]>
Copilot AI review requested due to automatic review settings July 23, 2026 19:40

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

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.

Consider removing output from Workflow Completed Lifecycle event

2 participants