Skip to content

WorkflowRunStartOptions

WorkflowRunStartOptions = object

Defined in: packages/core/src/workflow/types.ts:87

Optional start parameters for Workflow.run. Hosts (e.g. inspection UI) may attach per-run observers for in-process event tails; persisted history still goes through WorkflowStore on the runtime.

optional extraObservers?: object

Defined in: packages/core/src/workflow/types.ts:97

Merged with runtime observers for this invocation only.

optional agents?: AgentObservers

optional workflows?: WorkflowObservers


optional parentCtx?: WorkflowContext

Defined in: packages/core/src/workflow/types.ts:95

Nest under an existing workflow run (shared workflowRunId, step cache, event stream). When omitted inside a workflow body or step, the active WorkflowContext is read from the runtime’s scoped ALS — same pattern as agent.run workflow linkage.


optional workflowRunId?: string

Defined in: packages/core/src/workflow/types.ts:89

Pre-allocate a run id so subscribers can connect before execution finishes.