botmux 2.111.0 → 2.112.0

package/dist/workflows/trigger-run.d.ts

@@ -1,70 +0,0 @@
-/**
- * Shared workflow trigger — used by the dashboard catalog `POST .../run`
- * route on the daemon side.  Wraps the load/coerce/createRun/drive sequence
- * with injectable deps so the orchestration can be unit-tested without the
- * full daemon process.
- *
- * IM `/workflow run` still goes through `executeWorkflowCommand`; this helper
- * is the dashboard-trigger path that consumes pre-decoded JSON params and
- * fires the workflow loop in the background.
- */
-import { type RawParamInput } from './params.js';
-import { EventLog } from './events/append.js';
-import { type BotResolver } from './run-init.js';
-import type { WorkflowDefinition } from './definition.js';
-import type { WorkflowRuntimeContext, WorkerSpawnFn } from './runtime.js';
-export type TriggerInput = {
-    workflowId: string;
-    rawParams: Record<string, RawParamInput>;
-    chatBinding: {
-        chatId: string;
-        larkAppId: string;
-    };
-    initiator: string;
-};
-export type TriggerDeps = {
-    spawnSubagent: WorkerSpawnFn;
-    botResolver: BotResolver;
-    /** Build the ctx scaffolding (hostExecutors, reconcilers, loadEffectInput). */
-    makeRuntimeContext: (log: EventLog, def: WorkflowDefinition, spawnSubagent: WorkerSpawnFn) => WorkflowRuntimeContext;
-    /** Daemon side registers the ctx so future cancel/approve can find it. */
-    attachRuntime: (runId: string, ctx: WorkflowRuntimeContext) => {
-        ready?: Promise<unknown>;
-    };
-    /** Fire-and-forget loop drive — daemon owns the actual scheduling. */
-    driveRun: (runId: string) => void;
-    /** Test seam: override the file lookup. */
-    loadWorkflowDefinition?: (workflowId: string) => Promise<WorkflowDefinition>;
-    /** Test seam: deterministic run id. */
-    makeRunId?: (def: WorkflowDefinition) => string;
-    /** Test seam: explicit runs dir override. */
-    makeEventLog?: (runId: string) => EventLog;
-};
-export type TriggerSuccess = {
-    ok: true;
-    runId: string;
-    workflowId: string;
-    status: string;
-    lastSeq: number;
-};
-export type TriggerFailure = {
-    ok: false;
-    error: 'unknown_workflow';
-    message: string;
-} | {
-    ok: false;
-    error: 'invalid_params';
-    message: string;
-    issues: Array<{
-        path: string[];
-        code: string;
-        message: string;
-    }>;
-} | {
-    ok: false;
-    error: 'load_definition_failed' | 'internal_error';
-    message: string;
-};
-export type TriggerResult = TriggerSuccess | TriggerFailure;
-export declare function triggerWorkflowRun(input: TriggerInput, deps: TriggerDeps): Promise<TriggerResult>;
-//# sourceMappingURL=trigger-run.d.ts.map

package/dist/workflows/trigger-run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trigger-run.d.ts","sourceRoot":"","sources":["../../src/workflows/trigger-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,+EAA+E;IAC/E,kBAAkB,EAAE,CAClB,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,kBAAkB,EACvB,aAAa,EAAE,aAAa,KACzB,sBAAsB,CAAC;IAC5B,0EAA0E;IAC1E,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,KAAK;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC5F,sEAAsE;IACtE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7E,uCAAuC;IACvC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,MAAM,CAAC;IAChD,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,wBAAwB,GAAG,gBAAgB,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AAE5D,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CAmExB"}

package/dist/workflows/trigger-run.js

@@ -1,88 +0,0 @@
-/**
- * Shared workflow trigger — used by the dashboard catalog `POST .../run`
- * route on the daemon side.  Wraps the load/coerce/createRun/drive sequence
- * with injectable deps so the orchestration can be unit-tested without the
- * full daemon process.
- *
- * IM `/workflow run` still goes through `executeWorkflowCommand`; this helper
- * is the dashboard-trigger path that consumes pre-decoded JSON params and
- * fires the workflow loop in the background.
- */
-import { coerceWorkflowParams, ParamCoerceFailure } from './params.js';
-import { EventLog } from './events/append.js';
-import { loadWorkflowDefinition as defaultLoadWorkflowDefinition } from './loader.js';
-import { mintWorkflowRunId } from './run-id.js';
-import { createRun } from './run-init.js';
-import { replay } from './events/replay.js';
-import { getRunsDir } from './runs-dir.js';
-export async function triggerWorkflowRun(input, deps) {
-    const loadDef = deps.loadWorkflowDefinition ?? defaultLoadWorkflowDefinition;
-    let def;
-    try {
-        def = await loadDef(input.workflowId);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        if (message.startsWith(`Workflow '${input.workflowId}' not found`)) {
-            return { ok: false, error: 'unknown_workflow', message };
-        }
-        return { ok: false, error: 'load_definition_failed', message };
-    }
-    let coerced;
-    try {
-        coerced = coerceWorkflowParams(def, input.rawParams);
-    }
-    catch (err) {
-        if (err instanceof ParamCoerceFailure) {
-            return {
-                ok: false,
-                error: 'invalid_params',
-                message: err.message,
-                issues: err.issues.map((i) => ({
-                    path: i.name ? [i.name] : [],
-                    code: i.code,
-                    message: i.message,
-                })),
-            };
-        }
-        const message = err instanceof Error ? err.message : String(err);
-        return { ok: false, error: 'internal_error', message };
-    }
-    try {
-        const runId = (deps.makeRunId ?? ((d) => mintWorkflowRunId(d.workflowId, Date.now())))(def);
-        const log = deps.makeEventLog ? deps.makeEventLog(runId) : new EventLog(runId, getRunsDir());
-        const ctx = deps.makeRuntimeContext(log, def, deps.spawnSubagent);
-        await createRun(log, {
-            def,
-            params: coerced,
-            initiator: input.initiator,
-            botResolver: deps.botResolver,
-            chatBinding: input.chatBinding,
-        });
-        const watcher = deps.attachRuntime(runId, ctx);
-        if (watcher.ready) {
-            try {
-                await watcher.ready;
-            }
-            catch {
-                // watcher start failures are logged by the daemon; the run is still
-                // valid and will keep producing events the watcher can re-pick on
-                // restart, so don't abort the trigger here.
-            }
-        }
-        deps.driveRun(runId);
-        const snapshot = replay(await log.readAll());
-        return {
-            ok: true,
-            runId,
-            workflowId: def.workflowId,
-            status: snapshot.run.status,
-            lastSeq: snapshot.lastSeq,
-        };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { ok: false, error: 'internal_error', message };
-    }
-}
-//# sourceMappingURL=trigger-run.js.map

package/dist/workflows/trigger-run.js.map

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

package/dist/workflows/wait.d.ts

@@ -1,141 +0,0 @@
-/**
- * Wait / human-gate host API (events doc v0.1.2 §2.4, Step 8 of 10).
- *
- * Three operations:
- *   - `createWait`  — declares a wait activity; writes `waitCreated`.
- *   - `resolveWait` — closes a wait by external decision; writes
- *                     `waitResolved` + activity terminal.
- *   - `expireWait`  — closes a wait by deadline; writes
- *                     `waitDeadlineExceeded` + activity terminal.
- *
- * Spec contract (§2.4):
- *   - `waitResolved` is NOT a terminal event; activity terminal follows.
- *   - `approved` resolution → `activitySucceeded`.
- *   - `rejected` resolution → `activityFailed { WaitDeadlineExceeded?, userFault }`.
- *     Per spec the errorCode for rejection isn't explicitly enumerated;
- *     v0 picks `userFault` class with a reusable code so dashboards can
- *     filter.  We use `InputValidationFailed` — closest fit from the
- *     existing enum (rejection is "input not accepted").
- *   - `external` resolution → `activitySucceeded` with the resolution
- *     reflected in `externalRefs.resolution = 'external'`.
- *   - `waitDeadlineExceeded` → either `activityFailed` ({WaitDeadlineExceeded,
- *     userFault}) when `onTimeout='fail'` (default), or
- *     `activitySucceeded { externalRefs.defaultedToTimeout=true }` when
- *     `onTimeout='success'` (spec §6 open Q7 resolved at Step 8).
- *
- * Step 8 does NOT:
- *   - schedule deadline timers (caller wires them up; we just write the
- *     event when the timer fires);
- *   - implement cancel propagation (Step 9).
- */
-import type { EventLog } from './events/append.js';
-import type { OutputRef } from './events/payloads.js';
-import type { ActivityFailedEvent, ActivitySucceededEvent, WaitCreatedEvent, WaitDeadlineExceededEvent, WaitResolvedEvent } from './events/types.js';
-import type { WorkflowDefinition } from './definition.js';
-export type WaitKind = 'human-gate' | 'time' | 'condition';
-export type WaitResolution = 'approved' | 'rejected' | 'external';
-export type WaitOnTimeout = 'fail' | 'success';
-export type CreateWaitInput = {
-    activityId: string;
-    attemptId: string;
-    nodeId: string;
-    waitKind: WaitKind;
-    /** Wall-clock ms epoch.  Required for `time` kind, optional otherwise. */
-    deadlineAt?: number;
-    /** Human-readable prompt (rendered to approvers / dashboards).  Small
-     *  prompts go here inline; large ones spill to `promptRef` per
-     *  `checkWaitCreatedPromptInvariant` (mutually exclusive). */
-    prompt?: string;
-    /** Blob spill for prompts that don't fit in the inline envelope.
-     *  Consumers (card-builder / dashboard) read the blob on demand;
-     *  replay never touches it. */
-    promptRef?: OutputRef;
-    /** Required short preview when `promptRef` is set so cards / dashboards
-     *  can render without reading the blob.  Up to 500 chars (schema cap);
-     *  producer is responsible for keeping bytes reasonable for UTF-8. */
-    promptPreview?: string;
-    /** Optional open_id allow list for human-gate card actions. */
-    approvers?: string[];
-    /** What to write as the activity terminal when the deadline fires
-     *  without resolution.  Default `fail` (spec default). */
-    onTimeout?: WaitOnTimeout;
-};
-export type ResolveWaitInput = {
-    activityId: string;
-    attemptId: string;
-    resolution: WaitResolution;
-    /** Identifier of the resolver — open_id / system actor name. */
-    by: string;
-    comment?: string;
-    /**
-     * Extra business output to record in the resulting
-     * `activitySucceeded.externalRefs` (only used when the resolution
-     * leads to success — approved / external).  Ignored for rejected.
-     */
-    output?: Record<string, unknown>;
-};
-export type ExpireWaitInput = {
-    activityId: string;
-    attemptId: string;
-    /** Wall-clock ms at which the deadline was scheduled. */
-    deadlineAt: number;
-    /** Wall-clock ms when the timer actually fired (may be slightly later
-     *  due to scheduler latency). */
-    exceededAtMs: number;
-    /** Policy for the resulting activity terminal.  Default `fail`. */
-    onTimeout?: WaitOnTimeout;
-};
-export type ResolveWaitResult = {
-    resolutionEvent: WaitResolvedEvent;
-    terminalEvent: ActivitySucceededEvent | ActivityFailedEvent;
-    /** Convenience surface of the resolution event's eventId — useful as
-     *  the loop runtime's `waitResolvedEventId` audit anchor without
-     *  reaching into `.resolutionEvent.eventId`. */
-    waitResolvedEventId: string;
-};
-/**
- * Optional context for resolveWait.  When `def` is supplied, resolveWait
- * recognises `decision` nodes (v0.2 loop terminators) and writes their
- * terminal as `activitySucceeded` with a fixed `{resolution, by, comment?}`
- * output blob — including the `rejected` case, which for plain nodes
- * still maps to `activityFailed`.  See /tmp/wf-loop-v02.md §4.3 N2.
- */
-export type ResolveWaitContext = {
-    def?: WorkflowDefinition;
-};
-export type ExpireWaitResult = {
-    deadlineEvent: WaitDeadlineExceededEvent;
-    terminalEvent: ActivitySucceededEvent | ActivityFailedEvent;
-};
-/**
- * Declare a wait activity.  Writes `waitCreated`.  The caller is
- * responsible for advancing the parent node into `waiting` via
- * `nodeWaiting` (scheduling concern, not host-API).
- */
-export declare function createWait(log: EventLog, input: CreateWaitInput): Promise<WaitCreatedEvent>;
-/**
- * Close a wait via external decision.  Writes `waitResolved` followed
- * by the activity terminal.  The terminal mapping is fixed by spec
- * §2.4 for plain nodes:
- *   - approved → activitySucceeded
- *   - rejected → activityFailed { InputValidationFailed, userFault }
- *   - external → activitySucceeded { externalRefs.resolution='external' }
- *
- * For v0.2 `decision` nodes (loop terminators), the mapping is different:
- * BOTH approve and reject resolve to `activitySucceeded` with a fixed
- * `{resolution, by, comment?}` output blob — rejection is a legal
- * decision output, not a failure.  Pass `ctx.def` so resolveWait can
- * look up the node type via `parseActivityId(activityId).nodeId`.
- */
-export declare function resolveWait(log: EventLog, input: ResolveWaitInput, ctx?: ResolveWaitContext): Promise<ResolveWaitResult>;
-/**
- * Close a wait via deadline expiry.  Writes `waitDeadlineExceeded`
- * followed by the activity terminal driven by `onTimeout` (default
- * `fail`).
- *
- * The terminal policy:
- *   - fail (default) → activityFailed { WaitDeadlineExceeded, userFault }
- *   - success        → activitySucceeded { externalRefs.defaultedToTimeout=true }
- */
-export declare function expireWait(log: EventLog, input: ExpireWaitInput): Promise<ExpireWaitResult>;
-//# sourceMappingURL=wait.d.ts.map

package/dist/workflows/wait.d.ts.map

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

package/dist/workflows/wait.js

@@ -1,203 +0,0 @@
-/**
- * Wait / human-gate host API (events doc v0.1.2 §2.4, Step 8 of 10).
- *
- * Three operations:
- *   - `createWait`  — declares a wait activity; writes `waitCreated`.
- *   - `resolveWait` — closes a wait by external decision; writes
- *                     `waitResolved` + activity terminal.
- *   - `expireWait`  — closes a wait by deadline; writes
- *                     `waitDeadlineExceeded` + activity terminal.
- *
- * Spec contract (§2.4):
- *   - `waitResolved` is NOT a terminal event; activity terminal follows.
- *   - `approved` resolution → `activitySucceeded`.
- *   - `rejected` resolution → `activityFailed { WaitDeadlineExceeded?, userFault }`.
- *     Per spec the errorCode for rejection isn't explicitly enumerated;
- *     v0 picks `userFault` class with a reusable code so dashboards can
- *     filter.  We use `InputValidationFailed` — closest fit from the
- *     existing enum (rejection is "input not accepted").
- *   - `external` resolution → `activitySucceeded` with the resolution
- *     reflected in `externalRefs.resolution = 'external'`.
- *   - `waitDeadlineExceeded` → either `activityFailed` ({WaitDeadlineExceeded,
- *     userFault}) when `onTimeout='fail'` (default), or
- *     `activitySucceeded { externalRefs.defaultedToTimeout=true }` when
- *     `onTimeout='success'` (spec §6 open Q7 resolved at Step 8).
- *
- * Step 8 does NOT:
- *   - schedule deadline timers (caller wires them up; we just write the
- *     event when the timer fires);
- *   - implement cancel propagation (Step 9).
- */
-import { parseActivityId } from './orchestrator.js';
-import { writeJsonBlob } from './blob.js';
-// ─── createWait ────────────────────────────────────────────────────────────
-/**
- * Declare a wait activity.  Writes `waitCreated`.  The caller is
- * responsible for advancing the parent node into `waiting` via
- * `nodeWaiting` (scheduling concern, not host-API).
- */
-export async function createWait(log, input) {
-    if (input.waitKind === 'time' && input.deadlineAt === undefined) {
-        throw new Error(`createWait(${input.activityId}): waitKind='time' requires deadlineAt`);
-    }
-    return (await log.append({
-        runId: log.runId,
-        type: 'waitCreated',
-        actor: 'scheduler',
-        payload: {
-            activityId: input.activityId,
-            nodeId: input.nodeId,
-            waitKind: input.waitKind,
-            deadlineAt: input.deadlineAt,
-            prompt: input.prompt,
-            promptRef: input.promptRef,
-            promptPreview: input.promptPreview,
-            approvers: input.approvers,
-            onTimeout: input.onTimeout,
-        },
-    }));
-}
-// ─── resolveWait ───────────────────────────────────────────────────────────
-/**
- * Close a wait via external decision.  Writes `waitResolved` followed
- * by the activity terminal.  The terminal mapping is fixed by spec
- * §2.4 for plain nodes:
- *   - approved → activitySucceeded
- *   - rejected → activityFailed { InputValidationFailed, userFault }
- *   - external → activitySucceeded { externalRefs.resolution='external' }
- *
- * For v0.2 `decision` nodes (loop terminators), the mapping is different:
- * BOTH approve and reject resolve to `activitySucceeded` with a fixed
- * `{resolution, by, comment?}` output blob — rejection is a legal
- * decision output, not a failure.  Pass `ctx.def` so resolveWait can
- * look up the node type via `parseActivityId(activityId).nodeId`.
- */
-export async function resolveWait(log, input, ctx) {
-    const resolutionEvent = (await log.append({
-        runId: log.runId,
-        type: 'waitResolved',
-        actor: input.resolution === 'external' ? 'system' : 'human',
-        payload: {
-            activityId: input.activityId,
-            resolution: input.resolution,
-            by: input.by,
-            comment: input.comment,
-        },
-    }));
-    // v0.2: detect decision node so reject doesn't go through activityFailed.
-    const isDecisionNode = (() => {
-        if (!ctx?.def)
-            return false;
-        const parsed = parseActivityId(input.activityId);
-        if (!parsed)
-            return false;
-        return ctx.def.nodes[parsed.nodeId]?.type === 'decision';
-    })();
-    const terminalEvent = await writeWaitTerminal(log, {
-        activityId: input.activityId,
-        attemptId: input.attemptId,
-        kind: input.resolution === 'rejected' && !isDecisionNode
-            ? {
-                tag: 'failed',
-                errorCode: 'InputValidationFailed',
-                errorClass: 'userFault',
-                errorMessage: `Wait resolved with rejected by ${input.by}${input.comment ? `: ${input.comment}` : ''}`,
-            }
-            : {
-                tag: 'succeeded',
-                externalRefs: {
-                    resolution: input.resolution,
-                    by: input.by,
-                    // Always materialize `comment` (empty string when missing) so
-                    // downstream `${node.output.comment}` / `${node.previous.comment}`
-                    // bindings don't hit BindingError on the natural "approve/reject
-                    // without note" interaction. input.output may override.
-                    comment: input.comment ?? '',
-                    ...(input.output ?? {}),
-                },
-            },
-    });
-    return {
-        resolutionEvent,
-        terminalEvent,
-        waitResolvedEventId: resolutionEvent.eventId,
-    };
-}
-// ─── expireWait ────────────────────────────────────────────────────────────
-/**
- * Close a wait via deadline expiry.  Writes `waitDeadlineExceeded`
- * followed by the activity terminal driven by `onTimeout` (default
- * `fail`).
- *
- * The terminal policy:
- *   - fail (default) → activityFailed { WaitDeadlineExceeded, userFault }
- *   - success        → activitySucceeded { externalRefs.defaultedToTimeout=true }
- */
-export async function expireWait(log, input) {
-    const deadlineEvent = (await log.append({
-        runId: log.runId,
-        type: 'waitDeadlineExceeded',
-        actor: 'scheduler',
-        payload: {
-            activityId: input.activityId,
-            deadlineAt: input.deadlineAt,
-            exceededAtMs: input.exceededAtMs,
-        },
-    }));
-    const policy = input.onTimeout ?? 'fail';
-    const terminalEvent = await writeWaitTerminal(log, {
-        activityId: input.activityId,
-        attemptId: input.attemptId,
-        kind: policy === 'success'
-            ? {
-                tag: 'succeeded',
-                externalRefs: { defaultedToTimeout: true, deadlineAt: input.deadlineAt },
-            }
-            : {
-                tag: 'failed',
-                errorCode: 'WaitDeadlineExceeded',
-                errorClass: 'userFault',
-                errorMessage: `Wait deadline (${input.deadlineAt}) exceeded at ${input.exceededAtMs}`,
-            },
-    });
-    return { deadlineEvent, terminalEvent };
-}
-async function writeWaitTerminal(log, spec) {
-    if (spec.kind.tag === 'succeeded') {
-        const externalRefs = spec.kind.externalRefs;
-        // Persist externalRefs as a real blob so `${node.output.x}` /
-        // `${node.previous.x}` binding can read the resolution payload.
-        // Plain wait approve also benefits — downstream nodes can now read
-        // `${gate.output.resolution}` without falling back to externalRefs.
-        // (Previously we hand-rolled an OutputRef without `outputPath`,
-        // which made the binding layer fail-loud on decision `previous`
-        // references — codex Step 3 review Blocker 1.)
-        const outputRef = await writeJsonBlob(log, externalRefs);
-        return (await log.append({
-            runId: log.runId,
-            type: 'activitySucceeded',
-            actor: 'scheduler',
-            payload: {
-                activityId: spec.activityId,
-                attemptId: spec.attemptId,
-                outputRef,
-                externalRefs,
-            },
-        }));
-    }
-    return (await log.append({
-        runId: log.runId,
-        type: 'activityFailed',
-        actor: 'scheduler',
-        payload: {
-            activityId: spec.activityId,
-            attemptId: spec.attemptId,
-            error: {
-                errorCode: spec.kind.errorCode,
-                errorClass: spec.kind.errorClass,
-                errorMessage: spec.kind.errorMessage,
-            },
-        },
-    }));
-}
-//# sourceMappingURL=wait.js.map

package/dist/workflows/wait.js.map

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