Skip to main content
Defined in: core/provider.ts:1361 Saved position of a conversation (flow id, step and c.state), written by .persistent() flows so they can resume after a restart.

Properties

flowId

Defined in: core/provider.ts:1362

step

Defined in: core/provider.ts:1363

state

Defined in: core/provider.ts:1364

updatedAt

Defined in: core/provider.ts:1365

parked?

Defined in: core/provider.ts:1371 Multi-replica coordination only: true while the flow is parked on the FIRST wait of step with its prompt already sent, so the replica that resumes it takes the waking message as that wait’s answer. Absent or false: the step re-runs from its start.

inboundId?

Defined in: core/provider.ts:1378 Durability (BotConfig.durability): id of the inbound journal record whose effects this checkpoint captures (the message that entered the flow or that the step consumed). A replay of that record after a crash resumes the flow’s pending steps without delivering the message to it again. Stores persist it opaquely with the rest of the checkpoint.

cause?

Defined in: core/provider.ts:1384 Durability: the causation (inbound record id + send sequence) the next step’s sends continue from. A step re-run on replay re-derives the same outbox keys, so a prompt that already went out is not sent twice.

id

seq


answer?

Defined in: core/provider.ts:1392 Multi-replica coordination: the message the FIRST wait of step consumed while the step had not completed yet (a slow validator, a .do() running after its first c.ask). The replica that resumes the flow feeds it to that wait instead of asking again. The next step’s checkpoint drops it; a later wait of the same step parking drops it too (the step then re-runs from its start, as without it).

handover?

Defined in: core/provider.ts:1394 Multi-replica hand-over metadata (coordination.handover): an ephemeral checkpoint or a stub.

trace?

Defined in: core/provider.ts:1402 Tracing (BotConfig.telemetry) only: the W3C trace context of the conversation turn that wrote this checkpoint. The replica (or restarted process) that resumes it LINKS its first turn to that span (the resumed turn’s parent stays the waking message’s dispatch). Absent without telemetry or when the tracer’s ids are not W3C-shaped. Stores persist it opaquely, as JSON.

revision?

Defined in: core/provider.ts:1410 Store revision of this checkpoint row (compare-and-set writes only, see IStore.setCheckpointIf). Set by the runtime: the revision it last read or wrote for the key, plus one. Absent on rows written with setCheckpoint() (treated as revision 0 by the conditional writes). Stores persist it opaquely with the rest of the checkpoint and never interpret it beyond the comparison.