@nodetool-ai/execution 0.8.1

package/dist/debug/collector.js

@@ -0,0 +1,284 @@
+import { isNumber, isObjectLike, isString } from "../predicates.js";
+/**
+ * The deciders a `supervisor_decision` may name. Written as a total record so
+ * a new value in the protocol enum fails this file rather than slipping
+ * through as an unrecognized string.
+ */
+const DECIDED_BY = {
+    agent: true,
+    sticky: true,
+    bounds: true,
+    default: true,
+    kernel: true
+};
+const MAX_STRING_PREVIEW = 2000;
+const MAX_ARRAY_PREVIEW = 50;
+/** Fields that commonly carry base64 / data-URI payloads worth collapsing. */
+const BLOB_KEYS = new Set(["data", "uri", "b64_json", "base64"]);
+const BLOB_KEEP = 64;
+export function previewValue(value, maxLen = MAX_STRING_PREVIEW) {
+    if (isString(value)) {
+        return value.length > maxLen
+            ? `${value.slice(0, maxLen)}…[${value.length} chars]`
+            : value;
+    }
+    if (value instanceof Uint8Array) {
+        return `<binary ${value.byteLength} bytes>`;
+    }
+    if (Array.isArray(value)) {
+        const head = value
+            .slice(0, MAX_ARRAY_PREVIEW)
+            .map((v) => previewValue(v, maxLen));
+        return value.length > MAX_ARRAY_PREVIEW
+            ? [...head, `…[${value.length - MAX_ARRAY_PREVIEW} more]`]
+            : head;
+    }
+    if (isObjectLike(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (BLOB_KEYS.has(k) && isString(v) && v.length > 256) {
+                out[k] = `${v.slice(0, BLOB_KEEP)}…[${v.length} chars]`;
+            }
+            else {
+                out[k] = previewValue(v, maxLen);
+            }
+        }
+        return out;
+    }
+    // SAFETY: strings, binary, arrays and objects are handled above; what is
+    // left is a JSON scalar the report can carry as it stands.
+    return value;
+}
+function emptyNode(nodeId) {
+    return {
+        nodeId,
+        nodeType: null,
+        nodeName: null,
+        status: "pending",
+        error: null,
+        outputs: [],
+        cost: null
+    };
+}
+/**
+ * Reduce a processing-message stream into a structured execution summary.
+ *
+ * Accepts loosely-typed messages (the browser harness decodes JSON into bags of
+ * unknown fields) and reads only the fields each `type` is known to carry.
+ */
+export function collectExecutionSummary(messages) {
+    const nodes = new Map();
+    const logs = [];
+    const edges = new Map();
+    const llmCalls = [];
+    const outputs = [];
+    const interventions = [];
+    let status = "unknown";
+    let error = null;
+    const node = (id) => {
+        let n = nodes.get(id);
+        if (!n) {
+            n = emptyNode(id);
+            nodes.set(id, n);
+        }
+        return n;
+    };
+    const str = (v) => (isString(v) ? v : null);
+    const num = (v) => (isNumber(v) ? v : null);
+    for (const raw of messages) {
+        const msg = raw;
+        switch (msg.type) {
+            case "job_update": {
+                status = str(msg.status) ?? status;
+                const e = str(msg.error);
+                if (e)
+                    error = e;
+                break;
+            }
+            case "node_update": {
+                const id = str(msg.node_id);
+                if (!id)
+                    break;
+                const n = node(id);
+                n.nodeType = str(msg.node_type) ?? n.nodeType;
+                n.nodeName = str(msg.node_name) ?? n.nodeName;
+                const s = str(msg.status);
+                if (s)
+                    n.status = s;
+                // A node_update can carry a stale/empty error field while completing —
+                // only record an error when the status itself says so.
+                if (s === "error" || s === "failed") {
+                    n.error = str(msg.error) || s;
+                }
+                const cost = msg.provider_cost;
+                if (isObjectLike(cost)) {
+                    n.cost = {
+                        provider: str(cost.provider) ?? "",
+                        amount: num(cost.amount) ?? 0,
+                        unit: str(cost.unit) ?? "",
+                        currency: str(cost.currency)
+                    };
+                }
+                break;
+            }
+            case "generation_complete": {
+                const id = str(msg.node_id);
+                if (!id)
+                    break;
+                const n = node(id);
+                n.nodeType = str(msg.node_type) ?? n.nodeType;
+                n.nodeName = str(msg.node_name) ?? n.nodeName;
+                const out = msg.outputs ?? {};
+                for (const [name, v] of Object.entries(out)) {
+                    n.outputs.push({
+                        outputName: name,
+                        outputType: typeof v,
+                        value: previewValue(v)
+                    });
+                }
+                break;
+            }
+            case "output_update": {
+                const id = str(msg.node_id) ?? undefined;
+                const o = {
+                    nodeId: id,
+                    outputName: str(msg.output_name) ?? "output",
+                    outputType: str(msg.output_type) ?? typeof msg.value,
+                    value: previewValue(msg.value)
+                };
+                outputs.push(o);
+                if (id) {
+                    const n = node(id);
+                    n.nodeName = str(msg.node_name) ?? n.nodeName;
+                }
+                break;
+            }
+            case "node_progress": {
+                const id = str(msg.node_id);
+                if (!id)
+                    break;
+                node(id).progress = {
+                    progress: num(msg.progress) ?? 0,
+                    total: num(msg.total) ?? 0
+                };
+                break;
+            }
+            case "edge_update": {
+                const id = str(msg.edge_id);
+                if (!id)
+                    break;
+                edges.set(id, {
+                    edgeId: id,
+                    status: str(msg.status) ?? "",
+                    counter: num(msg.counter)
+                });
+                break;
+            }
+            case "log_update": {
+                logs.push({
+                    nodeId: str(msg.node_id),
+                    nodeName: str(msg.node_name),
+                    severity: str(msg.severity) ?? "info",
+                    content: str(msg.content) ?? ""
+                });
+                break;
+            }
+            case "error": {
+                const message = str(msg.message) ?? "unknown error";
+                if (!error)
+                    error = message;
+                logs.push({ nodeId: null, severity: "error", content: message });
+                break;
+            }
+            case "supervisor_decision": {
+                const intervention = readIntervention(msg);
+                if (intervention)
+                    interventions.push(intervention);
+                break;
+            }
+            case "llm_call": {
+                llmCalls.push({
+                    nodeId: str(msg.node_id) ?? "",
+                    provider: str(msg.provider) ?? "",
+                    model: str(msg.model) ?? "",
+                    tokensInput: num(msg.tokens_input),
+                    tokensOutput: num(msg.tokens_output),
+                    cost: num(msg.cost),
+                    durationMs: num(msg.duration_ms) ?? 0,
+                    error: str(msg.error)
+                });
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    const nodeList = [...nodes.values()];
+    const errored = nodeList.filter((n) => n.error);
+    const errors = errored.map((n) => ({
+        nodeId: n.nodeId,
+        nodeType: n.nodeType,
+        message: n.error
+    }));
+    if (error && !errors.some((e) => e.message === error)) {
+        errors.unshift({ nodeId: null, nodeType: null, message: error });
+    }
+    return {
+        status,
+        error,
+        nodes: nodeList,
+        logs,
+        edges: [...edges.values()],
+        llmCalls,
+        outputs,
+        interventions,
+        counts: {
+            nodes: nodeList.length,
+            completed: nodeList.filter((n) => n.status === "completed").length,
+            errored: errored.length,
+            logs: logs.length,
+            outputs: outputs.length,
+            llmCalls: llmCalls.length,
+            interventions: interventions.length
+        },
+        errors
+    };
+}
+/**
+ * Read a `supervisor_decision` message as an `Intervention`.
+ *
+ * Structural rather than schema-validated: this module stays free of runtime
+ * imports (the browser harness feeds it decoded JSON bags), so it checks the
+ * fields the record is keyed on and drops anything else. A message the kernel
+ * emitted always passes.
+ */
+function readIntervention(msg) {
+    const escalation = msg.escalation;
+    const verdict = msg.verdict;
+    if (!isObjectLike(escalation))
+        return null;
+    if (!isObjectLike(verdict))
+        return null;
+    if (!isString(verdict.action))
+        return null;
+    const decidedBy = msg.decided_by;
+    // `decided_by` is required by the message schema, and only `"agent"` means a
+    // model was involved. Guessing it would misreport who decided — and inflate
+    // the agent-decision count the cost rollup reads — so an unrecognized value
+    // drops the record rather than defaulting.
+    if (!isString(decidedBy))
+        return null;
+    if (!Object.prototype.hasOwnProperty.call(DECIDED_BY, decidedBy))
+        return null;
+    const cost = msg.cost;
+    const intervention = {
+        escalation: escalation,
+        verdict: verdict,
+        decidedBy: decidedBy
+    };
+    if (isNumber(cost)) {
+        intervention.costUsd = cost;
+    }
+    return intervention;
+}
+//# sourceMappingURL=collector.js.map

package/dist/debug/collector.js.map

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

package/dist/debug/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Debug surface: one execution-summary vocabulary and one triage pass for
+ * every host that reports on a workflow run — the CLI debug harness, the HTTP
+ * debug endpoint, and the agent-facing `debug_workflow` tool.
+ *
+ * Deliberately free of runtime dependencies (only `import type` crosses the
+ * package boundary), so a host can pull the reducer in without booting a
+ * session.
+ */
+export { collectExecutionSummary, previewValue } from "./collector.js";
+export { INTERVENTION_MARK, formatInterventionLine, formatSupervisedSummary, summarizeInterventions } from "../supervisor.js";
+export type { SupervisedRunSummary } from "../supervisor.js";
+export { buildRunVerdict, collectInterventionWarnings, collectRunIssues, describeErrors } from "./verdict.js";
+export type { DebugError, DebugGraph, DebugTargetInfo, DebugVerdict, EdgeDebug, ExecutionSummary, LlmCallDebug, LogEntry, NodeDebug, NodeOutput, RunVerdict, ServerRunReport, TraceSummary } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAIvE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,gBAAgB,EAChB,cAAc,EACf,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC"}

package/dist/debug/index.js

@@ -0,0 +1,16 @@
+/**
+ * Debug surface: one execution-summary vocabulary and one triage pass for
+ * every host that reports on a workflow run — the CLI debug harness, the HTTP
+ * debug endpoint, and the agent-facing `debug_workflow` tool.
+ *
+ * Deliberately free of runtime dependencies (only `import type` crosses the
+ * package boundary), so a host can pull the reducer in without booting a
+ * session.
+ */
+export { collectExecutionSummary, previewValue } from "./collector.js";
+// Intervention reporting lives one level up (it is not debug-only) but is
+// re-exported here so a host on this dependency-free subpath can print a
+// supervised run without pulling the session facade's runtime deps.
+export { INTERVENTION_MARK, formatInterventionLine, formatSupervisedSummary, summarizeInterventions } from "../supervisor.js";
+export { buildRunVerdict, collectInterventionWarnings, collectRunIssues, describeErrors } from "./verdict.js";
+//# sourceMappingURL=index.js.map

package/dist/debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AACpE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,gBAAgB,EAChB,cAAc,EACf,MAAM,cAAc,CAAC"}

package/dist/debug/types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Shared debug-summary types.
+ *
+ * One vocabulary for "what happened in this run", used by every surface that
+ * reports on a workflow execution: the CLI debug harness, the HTTP debug
+ * endpoint the MCP `debug_workflow` tool calls, and the app-debug harness.
+ * They used to live in the CLI alone, so the agent-facing tool reported a
+ * different, thinner shape than the CLI did for the same run.
+ */
+import type { Intervention } from "@nodetool-ai/protocol";
+import type { SupervisedRunSummary } from "../supervisor.js";
+/** A single value emitted by a node (output_update / generation_complete). */
+export interface NodeOutput {
+    nodeId?: string;
+    outputName: string;
+    outputType: string;
+    /** Preview-safe value: long strings + base64 blobs are truncated. */
+    value: unknown;
+}
+/** Per-node distilled execution state. */
+export interface NodeDebug {
+    nodeId: string;
+    nodeType: string | null;
+    nodeName: string | null;
+    /** Last status seen for the node (pending | running | completed | error …). */
+    status: string;
+    error: string | null;
+    outputs: NodeOutput[];
+    progress?: {
+        progress: number;
+        total: number;
+    };
+    cost?: {
+        provider: string;
+        amount: number;
+        unit: string;
+        currency: string | null;
+    } | null;
+}
+export interface LogEntry {
+    nodeId: string | null;
+    nodeName?: string | null;
+    severity: string;
+    content: string;
+}
+export interface EdgeDebug {
+    edgeId: string;
+    status: string;
+    counter: number | null;
+}
+export interface LlmCallDebug {
+    nodeId: string;
+    provider: string;
+    model: string;
+    tokensInput: number | null;
+    tokensOutput: number | null;
+    cost: number | null;
+    durationMs: number;
+    error: string | null;
+}
+/** A collated error for quick triage. */
+export interface DebugError {
+    nodeId: string | null;
+    nodeType?: string | null;
+    message: string;
+}
+/** Everything distilled from a run's processing-message stream. */
+export interface ExecutionSummary {
+    /** Final job status (completed | failed | cancelled | …). */
+    status: string;
+    error: string | null;
+    nodes: NodeDebug[];
+    logs: LogEntry[];
+    edges: EdgeDebug[];
+    llmCalls: LlmCallDebug[];
+    /** Workflow-level outputs (Output / Preview nodes). */
+    outputs: NodeOutput[];
+    /**
+     * Supervisor decisions, in decision order — empty on an unsupervised run.
+     * Folded from `supervisor_decision` messages, so it is the same record the
+     * kernel puts on `RunResult.interventions`.
+     */
+    interventions: Intervention[];
+    counts: {
+        nodes: number;
+        completed: number;
+        errored: number;
+        logs: number;
+        outputs: number;
+        llmCalls: number;
+        interventions: number;
+    };
+    errors: DebugError[];
+}
+/** Pass/fail plus the ordered, actionable issues behind it. */
+export interface RunVerdict {
+    ok: boolean;
+    headline: string;
+    issues: string[];
+}
+/** A workflow graph in kernel/runner shape (properties, not data). */
+export interface DebugGraph {
+    nodes: Array<Record<string, unknown>>;
+    edges: Array<Record<string, unknown>>;
+}
+/** How the workflow target was provided and what it resolved to. */
+export interface DebugTargetInfo {
+    /** Original CLI argument (id, path/to/file.json, or path/to/file.ts). */
+    ref: string;
+    /**
+     * How `ref` was interpreted. `application` and `bundle` only occur for app
+     * targets: an application row read from the database, and an
+     * `ApplicationBundle` JSON file.
+     */
+    source: "id" | "json" | "dsl" | "application" | "bundle";
+    /** Workflow id when known (DB id, or `id`/`workflow_id` field in a file). */
+    workflowId: string | null;
+    nodeCount: number;
+    edgeCount: number;
+}
+/** Rolled-up OpenTelemetry spans for the run. */
+export interface TraceSummary {
+    spanCount: number;
+    /** Wall-clock span over all spans (max end − min start), ms. */
+    totalDurationMs: number | null;
+    tokens: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    costUsd: number;
+    /** Count + total self-time by span name (llm.chat, node.process, …). */
+    byName: Record<string, {
+        count: number;
+        totalDurationMs: number;
+    }>;
+    /** Slowest spans, descending. */
+    slowest: Array<{
+        name: string;
+        durationMs: number;
+        status: string;
+    }>;
+}
+export interface ServerRunReport {
+    surface: "server";
+    /** True when the job reached the `completed` status. */
+    ok: boolean;
+    status: string;
+    error: string | null;
+    durationMs: number;
+    summary: ExecutionSummary;
+    trace: TraceSummary | null;
+    /** Bundle-relative path to the raw messages JSONL. */
+    messagesFile?: string;
+    /** Bundle-relative path to the raw trace JSONL. */
+    traceFile?: string;
+    /**
+     * Present only on a supervised run: who supervised it and the rollup of what
+     * they decided. The decisions themselves are `summary.interventions`.
+     */
+    supervised?: {
+        provider: string;
+        model: string;
+        summary: SupervisedRunSummary;
+    };
+}
+/** A verdict that can also carry non-fatal observations. */
+export interface DebugVerdict {
+    ok: boolean;
+    headline: string;
+    /** Human-readable problems found, ordered most-actionable first. */
+    issues: string[];
+    /**
+     * Things worth looking at that are not failures — a run cannot decide them
+     * either way. Unlike `issues`, these do not clear `ok`.
+     */
+    warnings?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/debug/types.d.ts.map

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

package/dist/debug/types.js

@@ -0,0 +1,11 @@
+/**
+ * Shared debug-summary types.
+ *
+ * One vocabulary for "what happened in this run", used by every surface that
+ * reports on a workflow execution: the CLI debug harness, the HTTP debug
+ * endpoint the MCP `debug_workflow` tool calls, and the app-debug harness.
+ * They used to live in the CLI alone, so the agent-facing tool reported a
+ * different, thinner shape than the CLI did for the same run.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/debug/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/debug/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/debug/verdict.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Turns one run's execution summary into a pass/fail verdict plus the ordered
+ * issues behind it. Shared so the CLI harness and the HTTP debug endpoint
+ * (which the agent-facing `debug_workflow` tool calls) triage a run the same
+ * way instead of each host inventing its own idea of "clean".
+ */
+import type { DebugError, ExecutionSummary, RunVerdict } from "./types.js";
+export declare function describeErrors(prefix: string, errors: ReadonlyArray<DebugError>, limit?: number): string[];
+/** Issues found in a single surface's run, in triage order. */
+export declare function collectRunIssues(prefix: string, summary: ExecutionSummary, outcome: {
+    ok: boolean;
+    status: string;
+    error?: string | null;
+}): string[];
+/**
+ * What supervision decided, as things worth reading but not failures — a
+ * skipped invocation leaves the run `completed` with less output than the
+ * graph promised, which no status field says out loud.
+ */
+export declare function collectInterventionWarnings(prefix: string, summary: ExecutionSummary, limit?: number): string[];
+/** Verdict for a single-surface run. */
+export declare function buildRunVerdict(summary: ExecutionSummary, outcome: {
+    ok: boolean;
+    status: string;
+    error?: string | null;
+}, surface?: string): RunVerdict;
+//# sourceMappingURL=verdict.d.ts.map

package/dist/debug/verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/debug/verdict.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,KAAK,SAAI,GACR,MAAM,EAAE,CAKV;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9D,MAAM,EAAE,CAcV;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,KAAK,SAAI,GACR,MAAM,EAAE,CAaV;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC/D,OAAO,SAAa,GACnB,UAAU,CAUZ"}

package/dist/debug/verdict.js

@@ -0,0 +1,51 @@
+export function describeErrors(prefix, errors, limit = 5) {
+    return errors.slice(0, limit).map((e) => {
+        const where = e.nodeType ?? e.nodeId ?? "workflow";
+        return `${prefix} ${where}: ${e.message.replace(/\s+/g, " ").slice(0, 200)}`;
+    });
+}
+/** Issues found in a single surface's run, in triage order. */
+export function collectRunIssues(prefix, summary, outcome) {
+    const issues = [];
+    if (!outcome.ok) {
+        issues.push(`${prefix} run ended ${outcome.status}${outcome.error ? `: ${outcome.error}` : ""}`);
+    }
+    issues.push(...describeErrors(`${prefix} node`, summary.errors));
+    for (const call of summary.llmCalls) {
+        if (call.error) {
+            issues.push(`${prefix} LLM ${call.provider}/${call.model}: ${call.error}`);
+        }
+    }
+    return issues;
+}
+/**
+ * What supervision decided, as things worth reading but not failures — a
+ * skipped invocation leaves the run `completed` with less output than the
+ * graph promised, which no status field says out loud.
+ */
+export function collectInterventionWarnings(prefix, summary, limit = 5) {
+    if (summary.interventions.length === 0)
+        return [];
+    const warnings = summary.interventions
+        .slice(0, limit)
+        .map((i) => `${prefix} supervisor ${i.verdict.action} on ${i.escalation.nodeId}` +
+        `${i.escalation.invocationKey ? ` [${i.escalation.invocationKey}]` : ""}` +
+        `: ${i.escalation.detail.replace(/\s+/g, " ").slice(0, 200)}`);
+    const rest = summary.interventions.length - warnings.length;
+    if (rest > 0)
+        warnings.push(`${prefix} …${rest} more supervisor decision(s)`);
+    return warnings;
+}
+/** Verdict for a single-surface run. */
+export function buildRunVerdict(summary, outcome, surface = "Workflow") {
+    const issues = collectRunIssues(surface, summary, outcome);
+    const ok = outcome.ok && issues.length === 0;
+    return {
+        ok,
+        headline: ok
+            ? `Workflow ran clean (${outcome.status}).`
+            : `Workflow has issues — ${issues[0] ?? "unknown failure"}`,
+        issues
+    };
+}
+//# sourceMappingURL=verdict.js.map

package/dist/debug/verdict.js.map

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

package/dist/executor-resolver.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The three-branch executor resolver: registry → Python bridge → throw.
+ * Copy-pasted, before this package, in `packages/cli/src/nodetool.ts`,
+ * `packages/cli/src/debug/server-runner.ts`, and
+ * `packages/websocket/src/headless-job-runner.ts`. See the package README's
+ * inventory table (row "Executor resolution").
+ */
+import type { NodeExecutor } from "@nodetool-ai/kernel";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { type PythonBridgeBase } from "@nodetool-ai/runtime";
+import type { NodeDescriptor } from "@nodetool-ai/protocol";
+export declare function createExecutorResolver(registry: NodeRegistry, bridge: PythonBridgeBase | null): (node: NodeDescriptor) => NodeExecutor;
+//# sourceMappingURL=executor-resolver.d.ts.map

package/dist/executor-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-resolver.d.ts","sourceRoot":"","sources":["../src/executor-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAC9B,CAAC,IAAI,EAAE,cAAc,KAAK,YAAY,CASxC"}