botmux 2.93.1 → 2.95.0

package/dist/workflows/v3/manifest.js

@@ -0,0 +1,266 @@
+/**
+ * v3 node manifest validator.
+ *
+ * Goal-mode workers write `manifest.json` at BOTMUX_GOAL_MANIFEST_PATH.
+ * The runtime treats that file as untrusted agent output: this module checks
+ * the shape, status invariants, path containment, file metadata, and hashes
+ * before downstream nodes receive any file paths.
+ */
+import { createHash } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { MANIFEST_FILE_KINDS, MANIFEST_PREVIEW_MAX_BYTES, MANIFEST_SCHEMA_VERSION, MANIFEST_SUMMARY_MAX_BYTES, MANIFEST_STATUSES, } from './contract.js';
+export class ManifestValidationError extends Error {
+    problems;
+    constructor(problems) {
+        super(`Invalid v3 manifest:\n  - ${problems.join('\n  - ')}`);
+        this.problems = problems;
+        this.name = 'ManifestValidationError';
+    }
+}
+export async function readAndValidateManifest(manifestPath, outputDir) {
+    let raw;
+    try {
+        raw = await fs.readFile(manifestPath, 'utf-8');
+    }
+    catch (err) {
+        throw new ManifestValidationError([
+            `manifest not readable at ${manifestPath}: ${err instanceof Error ? err.message : String(err)}`,
+        ]);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new ManifestValidationError([
+            `manifest is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,
+        ]);
+    }
+    return validateManifest(parsed, outputDir);
+}
+export async function validateManifest(value, outputDir) {
+    const problems = [];
+    const outputRoot = await canonicalDir(outputDir, problems, 'outputDir');
+    if (!isRecord(value)) {
+        throw new ManifestValidationError(['manifest root must be an object']);
+    }
+    const schemaVersion = value.schemaVersion;
+    if (schemaVersion !== MANIFEST_SCHEMA_VERSION) {
+        problems.push(`schemaVersion must be ${MANIFEST_SCHEMA_VERSION} (got ${JSON.stringify(schemaVersion)})`);
+    }
+    const status = value.status;
+    if (typeof status !== 'string' || !isManifestStatus(status)) {
+        problems.push(`status must be one of ${MANIFEST_STATUSES.join(' | ')} (got ${JSON.stringify(status)})`);
+    }
+    const summary = normalizeString(value.summary, 'summary', MANIFEST_SUMMARY_MAX_BYTES, problems);
+    const filesRaw = value.files;
+    if (!Array.isArray(filesRaw)) {
+        problems.push('files must be an array');
+    }
+    const error = normalizeError(value.error, problems);
+    const files = [];
+    if (Array.isArray(filesRaw)) {
+        for (let i = 0; i < filesRaw.length; i++) {
+            const file = await normalizeFile(filesRaw[i], i, outputRoot, problems);
+            if (file)
+                files.push(file);
+        }
+    }
+    if (status === 'ok') {
+        if (files.length < 1)
+            problems.push('status "ok" requires at least one file');
+        if (value.error !== undefined)
+            problems.push('status "ok" must not include error');
+    }
+    else if (status === 'fail') {
+        if (!error)
+            problems.push('status "fail" requires error');
+    }
+    if (problems.length > 0)
+        throw new ManifestValidationError(problems);
+    return {
+        schemaVersion: MANIFEST_SCHEMA_VERSION,
+        status: status,
+        summary,
+        ...(error ? { error } : {}),
+        files,
+    };
+}
+export function resolveManifestFilePath(outputDir, relativePath) {
+    return resolve(outputDir, relativePath);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+async function canonicalDir(path, problems, label) {
+    try {
+        const st = await fs.stat(path);
+        if (!st.isDirectory()) {
+            problems.push(`${label} is not a directory: ${path}`);
+            return resolve(path);
+        }
+        return await fs.realpath(path);
+    }
+    catch (err) {
+        problems.push(`${label} is not accessible at ${path}: ${err instanceof Error ? err.message : String(err)}`);
+        return resolve(path);
+    }
+}
+function normalizeString(value, field, maxBytes, problems) {
+    if (typeof value !== 'string') {
+        problems.push(`${field} must be a string`);
+        return '';
+    }
+    return truncateUtf8(value, maxBytes);
+}
+function normalizeError(value, problems) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        problems.push('error must be an object when present');
+        return undefined;
+    }
+    const code = value.code;
+    const message = value.message;
+    const retryable = value.retryable;
+    if (typeof code !== 'string' || code.trim() === '')
+        problems.push('error.code must be a non-empty string');
+    if (typeof message !== 'string' || message.trim() === '')
+        problems.push('error.message must be a non-empty string');
+    if (retryable !== undefined && typeof retryable !== 'boolean')
+        problems.push('error.retryable must be boolean when present');
+    if (typeof code !== 'string' || typeof message !== 'string')
+        return undefined;
+    return {
+        code,
+        message,
+        ...(typeof retryable === 'boolean' ? { retryable } : {}),
+    };
+}
+async function normalizeFile(value, index, outputRoot, problems) {
+    const prefix = `files[${index}]`;
+    if (!isRecord(value)) {
+        problems.push(`${prefix} must be an object`);
+        return undefined;
+    }
+    const name = value.name;
+    const path = value.path;
+    const kind = value.kind;
+    const bytes = value.bytes;
+    const sha256 = value.sha256;
+    const mime = value.mime;
+    if (typeof name !== 'string' || name.trim() === '')
+        problems.push(`${prefix}.name must be a non-empty string`);
+    if (typeof path !== 'string' || path.trim() === '')
+        problems.push(`${prefix}.path must be a non-empty relative string`);
+    if (typeof kind !== 'string' || !isManifestFileKind(kind)) {
+        problems.push(`${prefix}.kind must be one of ${MANIFEST_FILE_KINDS.join(' | ')}`);
+    }
+    if (typeof bytes !== 'number' || !Number.isInteger(bytes) || bytes < 0) {
+        problems.push(`${prefix}.bytes must be a non-negative integer`);
+    }
+    if (typeof sha256 !== 'string')
+        problems.push(`${prefix}.sha256 must be a string`);
+    if (typeof mime !== 'string' || mime.trim() === '')
+        problems.push(`${prefix}.mime must be a non-empty string`);
+    const preview = value.preview === undefined
+        ? undefined
+        : normalizeString(value.preview, `${prefix}.preview`, MANIFEST_PREVIEW_MAX_BYTES, problems);
+    if (typeof path === 'string') {
+        await validateFileOnDisk(prefix, outputRoot, path, kind, bytes, sha256, problems);
+    }
+    if (typeof name !== 'string' ||
+        typeof path !== 'string' ||
+        typeof kind !== 'string' ||
+        !isManifestFileKind(kind) ||
+        typeof bytes !== 'number' ||
+        typeof sha256 !== 'string' ||
+        typeof mime !== 'string') {
+        return undefined;
+    }
+    return {
+        name,
+        path,
+        kind,
+        bytes,
+        sha256,
+        mime,
+        ...(preview !== undefined ? { preview } : {}),
+    };
+}
+async function validateFileOnDisk(prefix, outputRoot, relativePath, kind, bytes, sha256, problems) {
+    if (isAbsolute(relativePath)) {
+        problems.push(`${prefix}.path must be relative to outputDir`);
+        return;
+    }
+    if (relativePath.includes('\0')) {
+        problems.push(`${prefix}.path must not contain NUL bytes`);
+        return;
+    }
+    const candidate = resolveManifestFilePath(outputRoot, relativePath);
+    let real;
+    try {
+        real = await fs.realpath(candidate);
+    }
+    catch (err) {
+        problems.push(`${prefix}.path does not exist under outputDir: ${relativePath} (${err instanceof Error ? err.message : String(err)})`);
+        return;
+    }
+    if (!isPathInside(outputRoot, real)) {
+        problems.push(`${prefix}.path escapes outputDir: ${relativePath}`);
+        return;
+    }
+    let st;
+    try {
+        st = await fs.stat(real);
+    }
+    catch (err) {
+        problems.push(`${prefix}.path is not stat-able: ${relativePath} (${err instanceof Error ? err.message : String(err)})`);
+        return;
+    }
+    if (kind === 'directory') {
+        if (!st.isDirectory())
+            problems.push(`${prefix}.kind is directory but path is not a directory`);
+        if (sha256 !== '')
+            problems.push(`${prefix}.sha256 must be "" for directory entries`);
+        return;
+    }
+    if (st.isDirectory()) {
+        problems.push(`${prefix}.path is a directory but kind is ${JSON.stringify(kind)}`);
+        return;
+    }
+    if (!st.isFile()) {
+        problems.push(`${prefix}.path must be a regular file or directory`);
+        return;
+    }
+    if (typeof bytes === 'number' && st.size !== bytes) {
+        problems.push(`${prefix}.bytes mismatch: manifest=${bytes}, actual=${st.size}`);
+    }
+    if (typeof sha256 === 'string') {
+        const actual = await sha256File(real);
+        if (actual !== sha256)
+            problems.push(`${prefix}.sha256 mismatch`);
+    }
+}
+function isManifestFileKind(value) {
+    return MANIFEST_FILE_KINDS.includes(value);
+}
+function isManifestStatus(value) {
+    return MANIFEST_STATUSES.includes(value);
+}
+function isPathInside(parentReal, childReal) {
+    const parent = parentReal.endsWith('/') ? parentReal : `${parentReal}/`;
+    return childReal === parentReal || childReal.startsWith(parent);
+}
+async function sha256File(path) {
+    const buf = await fs.readFile(path);
+    return createHash('sha256').update(buf).digest('hex');
+}
+function truncateUtf8(value, maxBytes) {
+    const buf = Buffer.from(value, 'utf-8');
+    if (buf.length <= maxBytes)
+        return value;
+    return buf.subarray(0, maxBytes).toString('utf-8').replace(/\uFFFD+$/g, '');
+}
+//# sourceMappingURL=manifest.js.map

package/dist/workflows/v3/manifest.js.map

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

package/dist/workflows/v3/ops-projection.d.ts

@@ -0,0 +1,110 @@
+import { type V3RunStatus } from './state.js';
+import type { V3NodeStatus } from './orchestrator.js';
+export declare function isValidRunId(runId: string): boolean;
+export declare function isValidWaitId(waitId: string): boolean;
+/** Default run root, aligned with cli-run.ts / grill-state.ts. */
+export declare function defaultRunsDir(): string;
+export interface WebTerminalView {
+    sessionId: string;
+    webPort?: number;
+    /** `live` while the node's work worker is in flight; `closed` once the node
+     *  reached a terminal verdict (then replay via the pty-log endpoint). */
+    status: 'live' | 'closed';
+}
+export interface RunNodeView {
+    id: string;
+    status: V3NodeStatus;
+    /** Upstream node ids (graph edges) — from the persisted dag.json. */
+    depends: string[];
+    goal?: string;
+    attemptId?: string;
+    /** Present once the node's worker reported `nodeSessionReady`. */
+    webTerminal?: WebTerminalView;
+    /** Whether a raw PTY log exists for replay.  The absolute path is NOT exposed
+     *  to the frontend (codex review) — a replay endpoint locates it server-side
+     *  via `ptyLogPathFor(runsDir, runId, nodeId)`. */
+    hasPtyLog: boolean;
+    /** Whether the node produced a manifest (i.e. succeeded with a recorded
+     *  manifest).  The raw fs path is NOT exposed — same rationale as `hasPtyLog`:
+     *  `GET /api/v3/runs/:id` is link-shareable public-read, so a public reader
+     *  must never see absolute `/root/.botmux/...` paths (codex security review
+     *  2026-06-02).  A download, if ever needed, goes through a cookie-auth
+     *  endpoint that locates the file server-side via runId/nodeId. */
+    hasManifest: boolean;
+    /** For blocked/failed nodes: the coarse error class + the node's
+     *  self-reported `manifest.error.code` (e.g. AUTH_REQUIRED).  The free-text
+     *  `message` is deliberately NOT projected — it can quote validator problems
+     *  containing absolute paths, and this view is link-shareable public-read. */
+    errorClass?: string;
+    errorCode?: string;
+    /** True for composite loop nodes (from dag.json). */
+    isLoop?: boolean;
+    /** Composite loop progress (loop nodes only, once started).  `lastDecision`
+     *  is the coarse enum; the free-text decision `detail` is deliberately NOT
+     *  projected (it can quote agent-written result strings) — same public-read
+     *  rationale as `message`. */
+    loopState?: {
+        iteration: number;
+        maxIterations?: number;
+        granted: number;
+        lastDecision?: 'exit' | 'continue' | 'exhausted';
+        /** Per-iteration verdict history (enum ONLY — same no-detail rationale).
+         *  Lets the dashboard draw an honest round timeline instead of guessing
+         *  past verdicts from `lastDecision`. */
+        decisions: Array<{
+            iteration: number;
+            decision: 'exit' | 'continue' | 'exhausted';
+        }>;
+        /** Body template shape (authored ids + body-internal depends) — the
+         *  dashboard lays every round's mini-dag on this skeleton, so a round
+         *  whose later nodes have not dispatched yet still shows its full shape
+         *  (undispatched slots render as pending ghosts). */
+        bodyTemplate: Array<{
+            id: string;
+            depends: string[];
+        }>;
+    };
+    /** For loop BODY INSTANCE nodes (`repairLoop.i001.code`): the structured
+     *  membership ref from the dispatch event.  The id stays opaque — group by
+     *  THIS, never parse the id string. */
+    loop?: {
+        loopId: string;
+        iteration: number;
+        bodyNodeId: string;
+    };
+}
+export interface RunView {
+    runId: string;
+    runStatus: V3RunStatus;
+    failedNodeId?: string;
+    blockedNodeId?: string;
+    nodes: RunNodeView[];
+}
+/**
+ * Project an already-resolved run dir into a `RunView`.  Read-only + defensive:
+ * a missing journal / dag still yields a (possibly sparse) view rather than
+ * throwing — the dashboard polls this while a run is mid-flight.
+ */
+export declare function projectRun(runId: string, runDir: string): RunView;
+/**
+ * Validate a caller-supplied `runId`, resolve it under `runsDir` (re-checking
+ * the join stays inside runsDir — defense in depth), and project.  Returns
+ * `undefined` for an invalid id / traversal attempt / missing run.
+ */
+export declare function projectRunById(runsDir: string, runId: string): RunView | undefined;
+/**
+ * Server-side resolver for a node's raw PTY log path (for the replay endpoint).
+ * The absolute path is NEVER in the public RunView — callers locate it here by
+ * runId/nodeId, and it's re-validated to be inside the run dir (defense in
+ * depth) before any read.  Returns undefined for invalid id / traversal / no log.
+ */
+export declare function ptyLogPathFor(runsDir: string, runId: string, nodeId: string): string | undefined;
+export interface RunSummary {
+    runId: string;
+    runStatus: V3RunStatus;
+    nodeCount: number;
+}
+/** List runs under `runsDir` (dirs that have a journal.ndjson), newest-first by
+ *  name (runIds carry a `<slug>-<yymmdd-hhmm>` stamp so name sort ≈ time sort). */
+export declare function listRuns(runsDir: string): RunSummary[];
+//# sourceMappingURL=ops-projection.d.ts.map

package/dist/workflows/v3/ops-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-projection.d.ts","sourceRoot":"","sources":["../../../src/workflows/v3/ops-projection.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAQD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB;6EACyE;IACzE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;uDAEmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;uEAKmE;IACnE,WAAW,EAAE,OAAO,CAAC;IACrB;;;kFAG8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;kCAG8B;IAC9B,SAAS,CAAC,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;QACjD;;iDAEyC;QACzC,SAAS,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;SAAE,CAAC,CAAC;QACrF;;;6DAGqD;QACrD,YAAY,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;KACxD,CAAC;IACF;;2CAEuC;IACvC,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AA+DD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAuHjE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAOlF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAyBhG;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;mFACmF;AACnF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAUtD"}

package/dist/workflows/v3/ops-projection.js.map

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

package/dist/workflows/v3/orchestrator.d.ts

@@ -0,0 +1,168 @@
+/**
+ * v3 orchestrator — pure decision layer.
+ *
+ * Mirrors v0.2's `orchestrator.ts` pattern: a pure function maps the current
+ * run state + DAG to a list of action descriptors.  The runtime (`runtime.ts`)
+ * owns every side effect — journal/STATE writes, ephemeral-worker dispatch via
+ * `runNode`, humanGate card posting — and the per-bot/per-CLI/global
+ * concurrency caps.  Keeping the decision pure makes the critical-path
+ * semantics testable without spawning workers or touching the filesystem.
+ *
+ * MVP scope: static DAG, fail-fast.  No loops / decisions / dynamic expand
+ * (those are deferred — design Q3/§7).  Gate set is frozen at authoring time;
+ * the orchestrator never invents or skips a gate (design Q10).
+ */
+import { type V3Dag } from './dag.js';
+import type { V3RunFailureReason } from './journal.js';
+import type { V3LoopRef } from './journal.js';
+export type V3NodeStatus = 'pending' | 'gateWaiting' | 'running' | 'done' | 'skipped' | 'cancelled' | 'blocked' | 'superseded' | 'failed';
+export interface V3NodeState {
+    status: V3NodeStatus;
+    /** True once an approved humanGate cleared this node — so after approval the
+     *  next tick dispatches work instead of re-dispatching the gate.  A rejected
+     *  gate transitions the node straight to `failed` (set by the runtime), so
+     *  this flag only ever records the approved case. */
+    gateCleared?: boolean;
+    /** The current live runtime instance of this DEFINITION node (`A#002`).
+     *  Set on dispatch; cleared when a revisit supersedes it (the node then
+     *  re-dispatches a fresh instance).  Absent on the pre-instance-layer path
+     *  (plain nodeId-keyed events) and loop body expansions. */
+    effectiveInstanceId?: string;
+}
+/** nodeId → state.  A node absent from the map is treated as `pending`. */
+export type V3RunState = Map<string, V3NodeState>;
+/**
+ * Per-loop composite state, folded from the loop lifecycle events.  A loop
+ * absent from the map has not started.  The loop's coarse status (running /
+ * blocked / done) lives in the regular node-state map under the loop's id;
+ * this struct carries what that one enum can't: where the iteration cursor is
+ * and what the last decision said.
+ */
+export interface V3LoopState {
+    /** Current iteration, 1-based; 0 between loopStarted and the first
+     *  loopIterationStarted. */
+    iteration: number;
+    /** True once the CURRENT iteration's decision event is recorded (reset by
+     *  the next loopIterationStarted). */
+    decided: boolean;
+    /** The latest decision — drives what the orchestrator does next. */
+    lastDecision?: 'exit' | 'continue' | 'exhausted';
+    /** Extra iterations granted (each loopIterationGranted adds one); the
+     *  effective budget is maxIterations + granted. */
+    granted: number;
+    /** An appended-but-unconsumed grant (cleared by the next
+     *  loopIterationStarted) — the idempotency key for "already granted". */
+    pendingGrant: boolean;
+}
+/** loopId → loop state. */
+export type V3LoopRunState = Map<string, V3LoopState>;
+export interface V3EdgeState {
+    active: boolean;
+    sourceAttemptId: string;
+}
+/** `${from}->${to}` → conditional edge state. */
+export type V3EdgeRunState = Map<string, V3EdgeState>;
+export interface V3OmittedInput {
+    from: string;
+    reason: 'edgeInactive' | 'sourceSkipped' | 'sourceCancelled' | 'earlyRelease';
+}
+export type V3Action = 
+/** Read one source result.json once and append edgeResolved. */
+{
+    kind: 'resolveEdge';
+    from: string;
+    to: string;
+}
+/** Mark a node skipped because its triggerRule cannot be satisfied. */
+ | {
+    kind: 'skipNode';
+    nodeId: string;
+    detail?: string;
+}
+/** Abort an early-release loser whose remaining products are no longer used. */
+ | {
+    kind: 'cancelNode';
+    nodeId: string;
+    byNodeId: string;
+    detail?: string;
+}
+/** Post the humanGate approval card + persist a `waits/<id>.json` (Q10). */
+ | {
+    kind: 'dispatchGate';
+    nodeId: string;
+    instanceId?: string;
+}
+/** Spawn an ephemeral worker via `runNode` for this node's goal.  `loop` is
+ *  set for body-instance dispatches (the runtime synthesizes the instance
+ *  node from the loop's body definition).  `instanceId` is set when this is a
+ *  cross-node-revisit RE-DISPATCH (`A#002`): the prior instance was
+ *  superseded, so decideNext computes the next instance number deterministically
+ *  from `state.instances` (constraint 4 — the action carries it, the runtime
+ *  does not guess).  Absent on a first dispatch / loop body (those keep the
+ *  pre-instance-layer path until the runtime brick threads instances through). */
+ | {
+    kind: 'dispatchWork';
+    nodeId: string;
+    instanceId?: string;
+    loop?: V3LoopRef;
+    omitted?: V3OmittedInput[];
+}
+/** Outer deps of a loop are done → append loopStarted. */
+ | {
+    kind: 'startLoop';
+    loopId: string;
+}
+/** Begin iteration N (first, after a continue-decision, or after a grant). */
+ | {
+    kind: 'startLoopIteration';
+    loopId: string;
+    iteration: number;
+}
+/** Current iteration's body is fully done and undecided → the runtime reads
+ *  the exit node's result.json, evaluates exit.when, appends the decision. */
+ | {
+    kind: 'evaluateLoopIteration';
+    loopId: string;
+    iteration: number;
+}
+/** Decision was 'exit' → seal the loop with a nodeSucceeded on the LOOP id
+ *  carrying the output projection's manifest (downstream inputs/deps then
+ *  treat the loop like any done node — zero special-casing). */
+ | {
+    kind: 'completeLoop';
+    loopId: string;
+    iteration: number;
+}
+/** Terminal: every node done; the run's product is the sink set. */
+ | {
+    kind: 'completeRunSucceeded';
+}
+/** Terminal (fail-fast): a node failed, so the run cannot proceed. */
+ | {
+    kind: 'completeRunFailed';
+    failedNodeId?: string;
+    reason?: V3RunFailureReason;
+    detail?: string;
+}
+/** Terminal-for-now: a node is blocked (contract failure, recoverable).
+ *  Halts dispatch like failed, but the run can resume via a retry event. */
+ | {
+    kind: 'completeRunBlocked';
+    blockedNodeId: string;
+};
+/**
+ * Pure decision: given the current `state`, return every action that can be
+ * taken *now*.  The runtime applies concurrency caps by acting on a prefix of
+ * the returned dispatch actions and re-invoking on the next tick — this
+ * function intentionally returns ALL ready dispatches (it does not throttle).
+ *
+ * Ordering follows topological order so callers see deps-ready nodes first.
+ * Fail-fast: the moment any node is `failed`, the only action is
+ * `completeRunFailed` (in-flight peers are torn down by the runtime / cancel).
+ * When no dispatch is possible and nothing is pending, the run is complete.
+ */
+export declare function decideNext(dag: V3Dag, state: V3RunState, loops?: V3LoopRunState, edges?: V3EdgeRunState, instances?: V3RunState): V3Action[];
+/** Sink nodes — no other node depends on them.  Their products are the run's
+ *  output.  Pure helper for the runtime's success path. */
+export declare function findSinks(dag: V3Dag): string[];
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/workflows/v3/orchestrator.d.ts.map

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