Skip to content

Add experimental Event Groups support - #1784

Draft
mjameswh wants to merge 1 commit into
mainfrom
event-groups-feature
Draft

Add experimental Event Groups support#1784
mjameswh wants to merge 1 commit into
mainfrom
event-groups-feature

Conversation

@mjameswh

@mjameswh mjameswh commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Summary

Add experimental support for Event Groups.

Event Groups is a new form of Workflow-level metadata that allows for improved visibility into a Workflow execution's history by grouping logically related Events together based on user-defined or system-inferred criteria.

  • Explicit markers: create_event_group(label) returns a marker attachable to commands via a event_groups=[...] option or an execution scope (with group.scope():, propagated through coroutines via contextvars). Nested scopes compose; markers dedupe by id.
  • Implicit markers: automatically wrap signal and update handlers.
  • Markers are serialized onto outgoing commands as eventGroupMarkers. Explicit label marker ids are derived deterministically as SHA1(originalExecutionRunId + label) (sandbox-safe SHA-1 in sha1.ts).
  • Exposes WorkflowInfo.originalExecutionRunId (plumbed core → lang) and bumps the sdk-core submodule to the matching build.

Testing

Event Groups support requires Server v1.32.0-158.0, which has not yet been included in a published CLI release. In the mean time, tests can be run using the following CLI specifier:

TESTS_CLI_VERSION=v1.7.4-standalone-nexus-operations

@mjameswh
mjameswh force-pushed the event-groups-feature branch from 09293a3 to 426d273 Compare August 25, 2026 02:59
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.

1 participant