vercel__workflow/packages/errors/CHANGELOG.md

@workflow/errors

4.2.1

Patch Changes

• #2986 72ea6c8 Thanks @shalabhc! - Enforce a server-supplied per-run event limit (default 25K)

4.2.0

Minor Changes

• #3079 12e4ef7 Thanks @VaguelySerious! - Add an optimistic-concurrency guard for event creation (on by default; opt out with WORKFLOW_PRECONDITION_GUARD=0): replay-context event creations send a stateUpdatedAt snapshot timestamp, and the runtime reloads the event log and retries (then falls back to a fresh re-invocation) when the backend reports a newer out-of-band event with a 412 PreconditionFailedError. Backends without guard support ignore the snapshot, so this is backward-compatible and fails open.

4.1.5

Patch Changes

• Updated dependencies [2213c91]:
  • @workflow/utils@4.1.4

4.1.4

Patch Changes

• #2012 326d93a Thanks @pranaygp! - Expose the active run ID on hook token conflict errors.

• #2145 b385a2d Thanks @TooTallNate! - Classify SDK-level AES-GCM encryption failures as RUNTIME_ERROR instead of USER_ERROR via a new RuntimeDecryptionError.

• #1799 eca3b51 Thanks @TooTallNate! - Use inline sourcemaps for all workspace packages; published packages no longer ship external .js.map files.

• Updated dependencies [eca3b51]:

  • @workflow/utils@4.1.3

4.1.3

Patch Changes

• #2208 5fd7d9c Thanks @pranaygp! - Retry transient workflow replay divergence before classifying repeated divergence as a corrupted event log.

4.1.2

Patch Changes

• #2046 8407c1e Thanks @pranaygp! - Report corrupted event logs with a distinct CorruptedEventLogError type and CORRUPTED_EVENT_LOG run error code.

• #2060 ca5f355 Thanks @pranaygp! - Record fatal world response contract failures as non-retryable workflow errors.

• Updated dependencies [16f2c23]:

  • @workflow/utils@4.1.2

4.1.1

Patch Changes

• #1726 6f48e9e Thanks @workflow-devkit-release-bot! - Embed source content in published sourcemaps.

• Updated dependencies [6f48e9e]:

  • @workflow/utils@4.1.1

4.1.0

Patch Changes

• #1640 8890b33 Thanks @VaguelySerious! - Stable release

• Updated dependencies [8890b33]:

  • @workflow/utils@4.1.0

4.1.0-beta.20

Patch Changes

• #1567 6dc1b78 Thanks @VaguelySerious! - Increase flow route limit to max fluid duration and fail run if a single replay takes too long

4.1.0-beta.19

Patch Changes

• #1448 73a851a Thanks @pranaygp! - Add HookConflictError to @workflow/errors and use it for hook token conflicts instead of WorkflowRuntimeError

• #1340 84599b7 Thanks @pranaygp! - Add error code classification (USER_ERROR, RUNTIME_ERROR) to run_failed events, improve queue and schema validation error logging

• #1447 2ef33d2 Thanks @pranaygp! - Export semantic error types from workflow/internal/errors and add API reference documentation

• #1452 672d919 Thanks @pranaygp! - Fix workflow/step not found errors to fail gracefully instead of causing infinite queue retries

• #1344 beccbc4 Thanks @pranaygp! - Remove VQS maxDeliveries cap and enforce max delivery limit in workflow/step handlers with graceful failure

• #1342 aee035f Thanks @pranaygp! - Replace HTTP status code checks with semantic error types (EntityConflictError, RunExpiredError, ThrottleError, TooEarlyError). BREAKING CHANGE: WorkflowAPIError renamed to WorkflowWorldError.

4.1.0-beta.18

Patch Changes

• #1270 adfe8b6 Thanks @pranaygp! - Add HookNotFoundError to @workflow/errors and adopt it across all world backends

4.1.0-beta.17

Patch Changes

• Updated dependencies [e55c636]:
  • @workflow/utils@4.1.0-beta.13

4.1.0-beta.16

Patch Changes

• #1055 c2b4fe9 Thanks @pranaygp! - Detect and fatal error on orphaned/invalid events in the event log instead of silently hanging

4.1.0-beta.15

Patch Changes

• #966 56f2221 Thanks @VaguelySerious! - Add 429 throttle retry handling and 500 server error retry with exponential backoff to the workflow and step runtimes

• Updated dependencies [3d770d5]:

  • @workflow/utils@4.1.0-beta.12

4.1.0-beta.14

Minor Changes

• #621 4966b72 Thanks @pranaygp! - BREAKING: Storage interface is now read-only; all mutations go through events.create()
  • Remove cancel, pause, resume from runs
  • Remove create, update from runs, steps, hooks
  • Add run lifecycle events: run_created, run_started, run_completed, run_failed, run_cancelled
  • Add step_created event type
  • Remove fatal field from step_failed (terminal failure is now implicit)
  • Add step_retrying event with error info for retriable failures

Patch Changes

• #621 4966b72 Thanks @pranaygp! - Add backwards compatibility for runs created with different spec versions

  • Add RunNotSupportedError for runs requiring newer world versions
  • Add semver-based version comparison utilities
  • Legacy runs (< 4.1): route to legacy handlers
  • run_cancelled: skip event storage, directly update run
  • wait_completed: store event only (no entity mutation)
  • Unknown legacy events: throw error

• #621 4966b72 Thanks @pranaygp! - Add hook_conflict event type for duplicate token detection

  • World returns hook_conflict event when hook_created uses an existing token
  • Add HOOK_CONFLICT error slug

• Updated dependencies [4966b72, b16a682]:

  • @workflow/utils@4.1.0-beta.11

4.0.1-beta.13

Patch Changes

• Updated dependencies [9b1640d]:
  • @workflow/utils@4.0.1-beta.10

4.0.1-beta.12

Patch Changes

• Updated dependencies [e3f0390]:
  • @workflow/utils@4.0.1-beta.9

4.0.1-beta.11

Patch Changes

• Updated dependencies [0cf0ac3]:
  • @workflow/utils@4.0.1-beta.8

4.0.1-beta.10

Patch Changes

• #638 4bdd3e5 Thanks @VaguelySerious! - Move auth error messages into @workflow/errors package

4.0.1-beta.9

Patch Changes

• #505 b56aae3 Thanks @copilot-swe-agent! - Override setTimeout, setInterval, and related functions in workflow VM context to throw helpful errors suggesting to use sleep instead

• Updated dependencies [1ef6b2f]:

  • @workflow/utils@4.0.1-beta.7

4.0.1-beta.8

Patch Changes

• Updated dependencies [c9b8d84]:
  • @workflow/utils@4.0.1-beta.6

4.0.1-beta.7

Patch Changes

• Updated dependencies [bc9b628]
• Updated dependencies [34f3f86]
• Updated dependencies [cd451e0]
  • @workflow/utils@4.0.1-beta.5

4.0.1-beta.6

Patch Changes

• Updated dependencies [edb69c3]
  • @workflow/utils@4.0.1-beta.4

4.0.1-beta.5

Patch Changes

• b97b6bf: Lock all dependencies in our packages
• 00b0bb9: Wire through world's structured errors in WorkflowRunFailedError
• Updated dependencies [b97b6bf]
  • @workflow/utils@4.0.1-beta.3

4.0.1-beta.4

Patch Changes

• Updated dependencies [bf170ad]
• Updated dependencies [adf0cfe]
  • @workflow/utils@4.0.1-beta.2

4.0.1-beta.3

Patch Changes

• f973954: Update license to Apache 2.0

4.0.1-beta.2

Patch Changes

• 796fafd: Add static is() methods to all Error subclasses

4.0.1-beta.1

Patch Changes

• 1408293: Add "description" field to package.json file
• 8422a32: Update Workflow naming convention
• e46294f: Add "license" and "repository" fields to package.json file

4.0.1-beta.0

Patch Changes

• fcf63d0: Initial publish