Skip to main content

Interface: RunRedriveCommand

Defined in: packages/workflow-engine/src/kernel/commands.ts:478

Re-drives a terminal run. Unlike the run.rerunFrom it replaces, the superseded attempt is preserved: every stage record it removes is first archived as a stage-scoped annotation carrying its status, error, timings and output, so the failed attempt survives the retry.

Step Functions' model: the same run id, an incremented redriveCount, no branching into a new execution.

Properties​

definitionVersion?​

readonly optional definitionVersion?: string

Defined in: packages/workflow-engine/src/kernel/commands.ts:493

Move the run onto a different definition version — DBOS's fork-onto-a- new-application-version, which is the answer to "we shipped a bug, patch it and re-run".

  • omitted: keep the run's pinned version (the default).
  • "latest": re-pin to the version this process currently serves.
  • an explicit version string: re-pin to that version, which must already be registered for this workflow.

from?​

readonly optional from?: RunRedriveFrom

Defined in: packages/workflow-engine/src/kernel/commands.ts:482

Defaults to { kind: "lastFailure" }.

idempotencyKey?​

readonly optional idempotencyKey?: string

Defined in: packages/workflow-engine/src/kernel/commands.ts:495

Optional idempotency key — a replayed call returns the cached result.

type​

readonly type: "run.redrive"

Defined in: packages/workflow-engine/src/kernel/commands.ts:479

workflowRunId​

readonly workflowRunId: string

Defined in: packages/workflow-engine/src/kernel/commands.ts:480