botmux 2.33.0 → 2.33.1

package/dist/workflows/events/payloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../../../src/workflows/events/payloads.ts"],"names":[],"mappings":"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"}

package/dist/workflows/events/payloads.js

@@ -0,0 +1,337 @@
+import { z } from 'zod';
+// ─── Shared primitives ──────────────────────────────────────────────────────
+export const Sha256Pattern = /^sha256:[0-9a-f]{64}$/;
+export const Sha256Schema = z.string().regex(Sha256Pattern, 'must be sha256:<64-hex>');
+export const ActorEnum = z.enum([
+    'scheduler',
+    'worker',
+    'hostExecutor',
+    'human',
+    'supervisor',
+    'system',
+]);
+export const ErrorClassEnum = z.enum(['retryable', 'fatal', 'userFault', 'manual']);
+export const ErrorCodeEnum = z.enum([
+    'LeaseExpired',
+    'WorkerCrashed',
+    'NetworkError',
+    'ProviderRateLimited',
+    'IdempotencyInputMismatch',
+    'IdempotencyConflict',
+    'InputValidationFailed',
+    // Author wrote a `{ "$ref": ... }` that couldn't be resolved against
+    // upstream output at dispatch time — missing node, not-yet-succeeded,
+    // path-not-found, missing output blob.  Always userFault: it's a
+    // workflow definition / authoring mistake, not a provider issue.
+    'InputBindingFailed',
+    'OutputSchemaViolation',
+    'WaitDeadlineExceeded',
+    'TtlExpired',
+    'UnknownProviderError',
+    // Step 7 round 1 recovery codes:
+    //  InputUnrecoverable — reconciler requires the original effect input
+    //    to re-submit, but the daemon cannot load it (no callback, callback
+    //    threw, or returned undefined).  Always manual class.
+    //  CorruptLog — replay/recovery detected an inconsistent event log
+    //    (e.g. reconcileResult{decision=replayed} but no terminal event
+    //    found).  Always manual class.
+    'InputUnrecoverable',
+    'CorruptLog',
+]);
+export const ErrorPayloadSchema = z.object({
+    errorCode: ErrorCodeEnum,
+    errorClass: ErrorClassEnum,
+    errorMessage: z.string().max(4096),
+    stackRef: z.string().optional(),
+});
+export const OutputRefSchema = z.object({
+    outputHash: Sha256Schema,
+    outputPath: z.string().optional(),
+    outputBytes: z.number().int().nonnegative(),
+    outputSchemaVersion: z.number().int().positive(),
+    contentType: z.string().optional(),
+});
+export const ReconcileCapabilityEnum = z.enum(['readOnlyLookup', 'idempotentSubmit', 'none']);
+export const ReconcileDecisionEnum = z.enum([
+    'replayed',
+    'completedByIdempotentSubmit',
+    'manual',
+    'freshRetry',
+]);
+export const WaitKindEnum = z.enum(['human-gate', 'time', 'condition']);
+export const WaitResolutionEnum = z.enum(['approved', 'rejected', 'external']);
+export const CancelTargetSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('run'), runId: z.string() }),
+    z.object({ kind: z.literal('node'), nodeId: z.string() }),
+    z.object({ kind: z.literal('activity'), activityId: z.string() }),
+]);
+export const BackoffPolicySchema = z.object({
+    kind: z.enum(['fixed', 'exponential']),
+    baseMs: z.number().int().positive(),
+    factor: z.number().positive().optional(),
+    jitter: z.boolean().optional(),
+});
+// ─── Group 1 — Lifecycle (14) ───────────────────────────────────────────────
+/**
+ * Immutable identity snapshot of a workflow bot at run-creation time.
+ * Frozen here so subsequent rename / re-wire in bots.json doesn't drift
+ * the historical run view (UI doc §3.4).  All fields optional so a bot
+ * with partial registry data still serializes cleanly.
+ */
+export const BotSnapshotSchema = z.object({
+    larkAppId: z.string().optional(),
+    cliId: z.string().optional(),
+    displayName: z.string().optional(),
+    workingDir: z.string().optional(),
+});
+export const RunCreatedPayload = z.object({
+    workflowId: z.string(),
+    revisionId: z.string(),
+    inputRef: OutputRefSchema,
+    initiator: z.string(),
+    // Non-breaking extension (UI doc §11): bot name → identity snapshot
+    // for every subagent bot referenced in the workflow definition.
+    botSnapshots: z.record(BotSnapshotSchema).optional(),
+});
+export const RunStartedPayload = z.object({}).strict();
+export const RunSucceededPayload = z.object({
+    outputRef: OutputRefSchema,
+});
+export const RunFailedPayload = z.object({
+    failedNodeId: z.string(),
+    rootCauseEventId: z.string(),
+});
+export const RunCanceledPayload = z.object({
+    cancelOriginEventId: z.string(),
+});
+export const NodeWaitingPayload = z.object({
+    nodeId: z.string(),
+    waitReason: z.string(),
+    deadlineAt: z.number().int().positive().optional(),
+});
+export const NodeRetryingPayload = z.object({
+    nodeId: z.string(),
+    lastAttemptId: z.string(),
+    nextBackoffMs: z.number().int().nonnegative(),
+});
+export const NodeSucceededPayload = z.object({
+    nodeId: z.string(),
+    lastActivityId: z.string(),
+});
+export const NodeFailedPayload = z.object({
+    nodeId: z.string(),
+    lastActivityId: z.string(),
+    errorClass: ErrorClassEnum,
+});
+export const NodeSkippedPayload = z.object({
+    nodeId: z.string(),
+    conditionEventId: z.string(),
+});
+export const NodeCanceledPayload = z.object({
+    nodeId: z.string(),
+    cancelOriginEventId: z.string(),
+});
+export const ActivityRunningPayload = z.object({
+    activityId: z.string(),
+    attemptId: z.string(),
+    leaseId: z.string(),
+});
+export const ActivityWaitingPayload = z.object({
+    activityId: z.string(),
+    reason: z.string(),
+});
+export const ActivityTimedOutPayload = z.object({
+    activityId: z.string(),
+    attemptId: z.string(),
+    runningMs: z.number().int().nonnegative(),
+    reason: z.literal('LeaseExpired'),
+    errorClass: z.literal('retryable'),
+});
+// ─── Group 2 — Scheduling (5) ───────────────────────────────────────────────
+export const ConditionEvaluatedPayload = z.object({
+    nodeId: z.string(),
+    conditionExpr: z.string(),
+    resultTrue: z.boolean(),
+    evaluatedInputs: z.record(z.unknown()).optional(),
+});
+export const LeaseSignedPayload = z.object({
+    activityId: z.string(),
+    attemptId: z.string(),
+    leaseId: z.string(),
+    timeoutMs: z.number().int().positive(),
+    maxOutputBytes: z.number().int().positive(),
+});
+export const AttemptCreatedPayload = z.object({
+    // Codex round 4 finding 3: nodeId is REQUIRED.  Without it, replay
+    // can't project node.status idle→triggered when the first attempt is
+    // created, so node state stays idle until an explicit terminal
+    // node event arrives — and no event in the schema covers
+    // "triggered/running" entry.  attemptCreated.nodeId fills that gap.
+    nodeId: z.string(),
+    activityId: z.string(),
+    attemptId: z.string(),
+    attemptNumber: z.number().int().positive(),
+    inputRef: OutputRefSchema,
+});
+export const BackoffScheduledPayload = z.object({
+    nodeId: z.string(),
+    lastAttemptId: z.string(),
+    nextAttemptAt: z.number().int().positive(),
+    backoffPolicy: BackoffPolicySchema,
+});
+export const BackoffElapsedPayload = z.object({
+    nodeId: z.string(),
+    scheduledAttemptId: z.string(),
+});
+// ─── Group 3 — Side Effect (3) ──────────────────────────────────────────────
+export const EffectAttemptedPayload = z.object({
+    activityId: z.string(),
+    attemptId: z.string(),
+    // idempotencyKey is the 50-char-bounded provider uuid derived from
+    // hash(workflowId:revisionId:runId:nodeId:attemptId). Feishu uuid field
+    // accepts ≤ 50 chars; spike report Section 1.6.
+    idempotencyKey: z.string().min(1).max(50),
+    inputHash: Sha256Schema,
+    idempotencyTtlMs: z.number().int().positive(),
+    provider: z.string(),
+});
+export const ActivitySucceededPayload = z.object({
+    activityId: z.string(),
+    attemptId: z.string(),
+    outputRef: OutputRefSchema,
+    // type-specific external refs returned by provider on side-effecting
+    // succeeded events: send/reply → { messageId }, schedule → { taskId },
+    // pure skills omit. v0 keeps the shape open; v0.x+ standardizes per provider.
+    externalRefs: z.record(z.unknown()).optional(),
+});
+export const ActivityFailedPayload = z.object({
+    activityId: z.string(),
+    attemptId: z.string(),
+    error: ErrorPayloadSchema,
+});
+// ─── Group 4 — Wait / Human (3) ─────────────────────────────────────────────
+/**
+ * Spec §6 open question #7 resolved at Step 8: `onTimeout` is part of
+ * the wait creation payload, not external node IR.  Recording it on the
+ * event lets resume materialize the right terminal for a dangling
+ * `waitDeadlineExceeded` without consulting external workflow state.
+ * Default is `fail` at the consumer (matches spec default behavior).
+ */
+export const WaitOnTimeoutEnum = z.enum(['fail', 'success']);
+export const WaitCreatedPayload = z.object({
+    activityId: z.string(),
+    nodeId: z.string(),
+    waitKind: WaitKindEnum,
+    deadlineAt: z.number().int().positive().optional(),
+    // `prompt` is the inline form: small prompts (producer policy ≤1024B) live
+    // here directly. NO `.max()` on the schema — historical waitCreated events
+    // wrote 2-3KB inline prompts and must still replay/parse. The producer
+    // strategy split is enforced in `runtime.dispatchGate`, not the wire format.
+    prompt: z.string().optional(),
+    // Blob-spill form: large prompts go to a content-addressed file via
+    // `writeBlob`, and the event carries the resulting `OutputRef` plus a short
+    // preview for cards / dashboard. Mutual exclusion with `prompt` is enforced
+    // by `checkWaitCreatedPromptInvariant`.
+    promptRef: OutputRefSchema.optional(),
+    promptPreview: z.string().max(500).optional(),
+    approvers: z.array(z.string()).optional(),
+    onTimeout: WaitOnTimeoutEnum.optional(),
+});
+export const WaitResolvedPayload = z.object({
+    activityId: z.string(),
+    resolution: WaitResolutionEnum,
+    by: z.string(),
+    comment: z.string().optional(),
+});
+export const WaitDeadlineExceededPayload = z.object({
+    activityId: z.string(),
+    deadlineAt: z.number().int().positive(),
+    exceededAtMs: z.number().int().positive(),
+});
+// ─── Group 5 — Control (3) ──────────────────────────────────────────────────
+export const CancelRequestedPayload = z.object({
+    target: CancelTargetSchema,
+    reason: z.string(),
+    by: z.string(),
+});
+export const CancelDeliveredPayload = z.object({
+    target: CancelTargetSchema,
+    activityId: z.string(),
+});
+export const ActivityCanceledPayload = z.object({
+    activityId: z.string(),
+    attemptId: z.string(),
+    cancelOriginEventId: z.string(),
+});
+// ─── Group 6 — System / Recovery (3) ────────────────────────────────────────
+export const WorkerLostPayload = z.object({
+    workerId: z.string(),
+    lostActivityIds: z.array(z.string()).min(1),
+});
+export const ResumeStartedPayload = z.object({
+    daemonId: z.string(),
+    lastSeenEventId: z.string(),
+});
+/**
+ * `reconcileResult.evidence` v0 convention (spec §6 Q4 — standardization
+ * deferred to v0.x+, but the per-provider shape used by the v0 runtime
+ * is fixed here so dashboards and resume recovery can parse it without
+ * provider-specific knowledge).
+ *
+ * Common keys (any provider, any decision):
+ *   - `externalRefs`?: Record<string, unknown>
+ *       Provider-returned ref (messageId / taskId / ...) — required
+ *       for `completedByIdempotentSubmit` decisions, recovery uses it
+ *       to materialize `activitySucceeded.payload.externalRefs`.
+ *   - `errorCode`?: string
+ *       Recorded errorCode for `manual` decisions — recovery uses it
+ *       to materialize `activityFailed.payload.error.errorCode`.
+ *
+ * Manual-only keys (decision='manual'):
+ *   - `reason`?: 'ttl_expired' | 'no_reconciler' | 'no_capability'
+ *                | 'input_unrecoverable' | 'missing_external_refs'
+ *   - `attemptedAtMs`, `nowMs`, `idempotencyTtlMs`?: number
+ *       Populated when reason='ttl_expired' for forensics.
+ *   - `originalDecision`?: ReconcileDecision
+ *       When recovery escalates from a corrupt prior decision (e.g.
+ *       replayed/manual without terminal), the original decision the
+ *       prior reconcile wrote is preserved here.
+ *   - `corruptReason`?: 'missing_external_refs'
+ *   - `reconcileEventId`?: string
+ *       eventId of the originating reconcileResult (recovery cross-ref).
+ *
+ * Cancel-coupled keys (Step 9 round 2 — when reconcile fires under
+ * cancel, any decision):
+ *   - `cancelOriginEventId`?: string  — eventId of the originating
+ *     `cancelRequested` so dashboard / forensics can correlate the
+ *     cancel × reconcile pair structurally instead of parsing
+ *     `activityFailed.errorMessage`.
+ *   - `cancelReason`?: string         — `cancelRequested.payload.reason`
+ *   - `cancelRequestedBy`?: string    — `cancelRequested.payload.by`
+ *
+ * These keys are written ONLY by `recoverCancelWithReconcile`'s fresh
+ * reconcile cycle; they are absent on regular reconciles and on F1
+ * recovery (the prior reconcileResult was written before cancel
+ * landed and is immutable).
+ *
+ * `freshRetry` evidence is provider-specific; v0 puts whatever the
+ * reconciler returned from `readOnlyLookup({ found: false })` here.
+ *
+ * Per-provider conventions (v0):
+ *   - `botmux-schedule` readOnlyLookup: `{ source: 'getTask',
+ *     returned: 'task' | 'undefined' }`
+ *   - `feishu-im` idempotentSubmit: `{ source: 'create-or-reply' }` or
+ *     similar; provider just returns externalRefs on success.
+ *
+ * Future work: lock these per-provider shapes via discriminated
+ * schemas keyed on `(decision, capability, provider)`.  Tracked in
+ * spec §6 Q4.
+ */
+export const ReconcileResultPayload = z.object({
+    activityId: z.string(),
+    idempotencyKey: z.string().min(1).max(50),
+    capability: ReconcileCapabilityEnum,
+    decision: ReconcileDecisionEnum,
+    evidence: z.record(z.unknown()),
+});
+//# sourceMappingURL=payloads.js.map

package/dist/workflows/events/payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../../../src/workflows/events/payloads.ts"],"names":[],"mappings":"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"}

package/dist/workflows/events/replay.d.ts

@@ -0,0 +1,238 @@
+import type { WorkflowEvent } from './schema.js';
+import type { ErrorClass, ErrorPayload, OutputRef } from './payloads.js';
+export type RunStatus = 'pending' | 'running' | 'waiting' | 'succeeded' | 'failed' | 'cancelled';
+export type NodeStatus = 'idle' | 'triggered' | 'running' | 'waiting' | 'retrying' | 'succeeded' | 'failed' | 'skipped' | 'cancelled';
+export type ActivityStatus = 'pending' | 'acquired' | 'running' | 'waiting' | 'effectAttempting' | 'succeeded' | 'failed' | 'timedOut' | 'cancelled';
+export type AttemptState = {
+    attemptId: string;
+    attemptNumber: number;
+    inputRef: OutputRef;
+    status: ActivityStatus;
+    leaseId?: string;
+    timeoutMs?: number;
+    maxOutputBytes?: number;
+    effectAttempted?: {
+        idempotencyKey: string;
+        inputHash: string;
+        idempotencyTtlMs: number;
+        provider: string;
+        attemptedAtEventId: string;
+        /** Wall-clock timestamp the effectAttempted envelope landed (ms epoch).
+         *  Resume uses this to evaluate the TTL boundary against `now()` —
+         *  cheaper and more deterministic than re-deriving the time from
+         *  `eventId` parsing. */
+        attemptedAtMs: number;
+    };
+    /**
+     * Latest reconcileResult matched to this attempt by idempotencyKey.
+     * Resume consults this BEFORE re-running the decision tree: if a
+     * previous resume crashed between writing reconcileResult and the
+     * terminal event, replay surfaces the prior decision so the next
+     * resume can finish what the first started (codex Step 7 round 1
+     * finding 1).  reconcileResult.payload doesn't carry attemptId — we
+     * match by idempotencyKey, which uniquely identifies the attempt.
+     */
+    latestReconcileResult?: {
+        decision: 'replayed' | 'completedByIdempotentSubmit' | 'manual' | 'freshRetry';
+        capability: 'readOnlyLookup' | 'idempotentSubmit' | 'none';
+        evidence: Record<string, unknown>;
+        eventId: string;
+    };
+    /**
+     * Cancel-in-flight marker (Step 9).  Populated when a `cancelRequested`
+     * targets this activity (directly via `kind=activity`, or — Step 10
+     * scheduler concern — fan-out from node/run cancel).  Resume reads
+     * this to detect dangling cancels (cancelRequested written, terminal
+     * missing) and complete them with `activityCanceled`.
+     *
+     * Cleared / superseded once `activityCanceled` writes a terminal —
+     * but we keep `cancelOriginEventId` recoverable from the request
+     * event itself, so resume doesn't need an in-flight pointer post-
+     * terminal.
+     */
+    cancelRequest?: {
+        cancelOriginEventId: string;
+        requestedBy: string;
+        reason: string;
+        delivered: boolean;
+    };
+    /**
+     * Wait state for human-gate / time / condition activities (Step 8).
+     * Populated by `waitCreated` and updated by `waitResolved` /
+     * `waitDeadlineExceeded`.  Resume reads this to recover dangling
+     * wait resolutions (resolved/exceeded but no terminal written).
+     */
+    wait?: {
+        waitKind: 'human-gate' | 'time' | 'condition';
+        deadlineAt?: number;
+        /** Inline prompt — only set for small prompts (≤1 KiB producer policy)
+         *  AND for historical pre-v0.1.3 events.  When the prompt was spilled
+         *  to a blob, `prompt` is undefined and consumers must use `promptRef`
+         *  (full text on demand) or `promptPreview` (cheap, card-safe). */
+        prompt?: string;
+        /** Blob spill ref (v0.1.3+).  Replay never reads the blob; cards
+         *  must render `promptPreview` only and dashboard reads on demand. */
+        promptRef?: OutputRef;
+        /** Short preview carried inline on waitCreated when promptRef is set;
+         *  ≤500 chars by schema, byte-budgeted by the producer. */
+        promptPreview?: string;
+        /** Default `fail` at the consumer.  Recorded only when waitCreated
+         *  carries the field; absent means caller never specified. */
+        onTimeout?: 'fail' | 'success';
+        /** Open when neither resolution nor deadline event has landed. */
+        resolution?: {
+            kind: 'resolved';
+            resolution: 'approved' | 'rejected' | 'external';
+            by: string;
+            comment?: string;
+            eventId: string;
+        } | {
+            kind: 'deadlineExceeded';
+            deadlineAt: number;
+            exceededAtMs: number;
+            eventId: string;
+        };
+    };
+    output?: OutputRef;
+    externalRefs?: Record<string, unknown>;
+    error?: ErrorPayload;
+    runningMs?: number;
+    cancelOriginEventId?: string;
+};
+export type ActivityState = {
+    activityId: string;
+    attempts: AttemptState[];
+    status: ActivityStatus;
+    currentAttemptId?: string;
+    /**
+     * Node that owns this Activity (recorded from `attemptCreated.nodeId`).
+     * Lets us project node.status when activity-level events arrive
+     * (e.g. activityRunning → node.status = 'running').
+     */
+    ownerNodeId?: string;
+};
+export type NodeState = {
+    nodeId: string;
+    status: NodeStatus;
+    activityId?: string;
+    retryCount: number;
+    nextAttemptAt?: number;
+    errorClass?: ErrorClass;
+    conditionEventId?: string;
+    cancelOriginEventId?: string;
+};
+export type RunState = {
+    runId: string;
+    status: RunStatus;
+    workflowId?: string;
+    revisionId?: string;
+    initiator?: string;
+    input?: OutputRef;
+    output?: OutputRef;
+    failedNodeId?: string;
+    rootCauseEventId?: string;
+    cancelOriginEventId?: string;
+    /**
+     * Immutable bot identity snapshot captured at runCreated time
+     * (UI doc §3.4).  Read by the runtime when spawning workers so that
+     * subsequent bot-registry rename / re-wire doesn't drift execution
+     * away from what was authored.  Absent on legacy runs created before
+     * v0.1.3 introduced the field.
+     */
+    botSnapshots?: Record<string, {
+        larkAppId?: string;
+        cliId?: string;
+        displayName?: string;
+        workingDir?: string;
+    }>;
+};
+export type Snapshot = {
+    run: RunState;
+    nodes: Map<string, NodeState>;
+    activities: Map<string, ActivityState>;
+    /** Convenience: terminal outputs by activityId (succeeded events only). */
+    outputs: Map<string, OutputRef>;
+    /** Last seq seen.  0 if the log is empty. */
+    lastSeq: number;
+    /**
+     * activityIds with attemptCreated but whose latest attempt has no terminal
+     * event (succeeded/failed/timedOut/cancelled).  Consumed by resume in
+     * Step 7 to drive reconcile decisions.
+     */
+    danglingActivities: string[];
+    /**
+     * activityIds whose latest attempt wrote effectAttempted but never reached
+     * a terminal event for that attempt.  Subset of danglingActivities.
+     */
+    danglingEffectAttempted: string[];
+    /**
+     * activityIds with waitCreated but no waitResolved / waitDeadlineExceeded.
+     */
+    danglingWaits: string[];
+    /**
+     * activityIds whose wait was resolved (either by waitResolved or by
+     * waitDeadlineExceeded) but whose attempt never reached a terminal
+     * event.  Step 8 resume recovery materializes the terminal from the
+     * recorded resolution.  Disjoint from `danglingWaits`.
+     */
+    danglingWaitResolutions: string[];
+    /**
+     * activityIds with a `cancelRequested` targeting them (directly or
+     * via fan-out — Step 10 scheduler concern), but no terminal yet.
+     *
+     * NOT disjoint from `danglingEffectAttempted` (Step 9 round 1
+     * finding 1):  cancel + effectAttempted is the central case that
+     * `recoverCancelWithReconcile` handles — reconcile fires FIRST to
+     * capture provider evidence, then writes the cancel-flavored
+     * terminal (`activityCanceled` for completedByIdempotentSubmit /
+     * freshRetry; `activityFailed{manual}` when reconcile is
+     * inconclusive).  The orchestrator routes the intersection through
+     * the cancel-with-reconcile path; remaining cancels (no effect)
+     * go through plain `recoverCancel`.
+     *
+     * Disjoint from `danglingWaitResolutions` is still upheld — cancel
+     * + wait combinations are skipped by wait recovery; cancel wins.
+     */
+    danglingCancels: string[];
+    /**
+     * Run-level cancel intent (Step 9 codex round 1 finding 3).  Set when
+     * a `cancelRequested{kind:run}` lands and not yet `runCanceled`.  Replay
+     * surfaces it so schedulers / dashboards can see "this run is being
+     * cancelled" without re-scanning the event list.  Cleared when
+     * `runCanceled` lands (run.status === 'cancelled').
+     */
+    cancelledRunIntent?: {
+        cancelOriginEventId: string;
+        requestedBy: string;
+        reason: string;
+    };
+    /**
+     * Per-node cancel intents.  Same shape and role as `cancelledRunIntent`
+     * but scoped to a node — set when `cancelRequested{kind:node}` lands
+     * and the node hasn't yet reached `nodeCanceled`.  First request wins
+     * on overlap (consistent with the activity-level fan-out semantics).
+     */
+    cancelledNodeIntents: Map<string, {
+        cancelOriginEventId: string;
+        requestedBy: string;
+        reason: string;
+    }>;
+};
+/**
+ * Fold an event log into a state snapshot.  Read-only — never executes
+ * activity logic, never calls providers, never writes to the log.  Events
+ * doc §5.2.
+ *
+ * Throws on:
+ *   - empty event list (caller must supply at least the runCreated event
+ *     to derive runId)
+ *   - first event is not runCreated (state machine forbids — events doc §2.1)
+ *   - event.runId mismatch (cross-contamination)
+ *
+ * Does NOT validate state-machine transitions semantically — the log is
+ * authoritative.  If transitions look wrong (e.g. activitySucceeded without
+ * attemptCreated), the resulting snapshot will simply have weird state;
+ * verification is the producer's job.
+ */
+export declare function replay(events: WorkflowEvent[]): Snapshot;
+//# sourceMappingURL=replay.d.ts.map

package/dist/workflows/events/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/workflows/events/replay.ts"],"names":[],"mappings":"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"}