@nodetool-ai/cli 0.7.0-rc.23 → 0.8.2

package/dist/debug/server-runner.js

@@ -0,0 +1,197 @@
+/**
+ * Headless ("server") debug surface: runs a workflow through
+ * `@nodetool-ai/execution`'s `ExecutionSession` exactly as
+ * `nodetool workflows run` does, but captures the full processing-message
+ * stream and the OpenTelemetry trace instead of just the final outputs.
+ *
+ * This is integration code — it pulls in the node registries, runtime context,
+ * and Python bridge — so it is exercised end-to-end rather than unit-tested.
+ */
+import { getDefaultAssetsPath } from "@nodetool-ai/config";
+import { getSecret, Project, Workflow } from "@nodetool-ai/models";
+import { ExecutionSession, isExecutionPreflightError } from "@nodetool-ai/execution";
+import { ProcessingContext } from "@nodetool-ai/runtime";
+import { FileStorageAdapter } from "@nodetool-ai/storage";
+import { summarizeInterventions } from "@nodetool-ai/execution/debug";
+import { createGraphNodeTypeResolver } from "@nodetool-ai/node-sdk";
+import { buildFullRegistry } from "../node-registry.js";
+import { createSupervisorHandle, recordSupervisorCost, streamInterventionLines } from "../supervisor.js";
+import { isRecord } from "../predicates.js";
+import { collectExecutionSummary } from "./collector.js";
+import { readTraceSummary } from "./trace.js";
+/** An output_update carrying a streamed audio chunk's samples. */
+const isAudioChunkOutputUpdate = (message) => {
+    if (message.type !== "output_update")
+        return false;
+    const value = message.value;
+    return (isRecord(value) &&
+        value.type === "chunk" &&
+        value.content_type === "audio");
+};
+/**
+ * The project a server run of this workflow uses: the stored workflow's
+ * project, else the user's Personal project, where uploads land. Without it
+ * project-scoped capabilities such as `get_asset` reject every asset.
+ */
+async function resolveRunProjectId(workflowId) {
+    const workflow = workflowId ? await Workflow.find("1", workflowId) : null;
+    return workflow?.project_id ?? (await Project.ensurePersonal("1")).id;
+}
+export async function runOnServer(input) {
+    const { graph, workflowId, params } = input;
+    const startedAt = Date.now();
+    const registry = buildFullRegistry();
+    const jobId = `debug-${Date.now()}`;
+    // Match a server run's workspace assignment so file/workspace nodes land in
+    // the same place a real run would.
+    const { resolveWorkflowWorkspace } = await import("@nodetool-ai/websocket");
+    const workspace = await resolveWorkflowWorkspace(workflowId ?? null, "1");
+    const contextInit = {
+        jobId,
+        workflowId,
+        userId: "1",
+        projectId: await resolveRunProjectId(workflowId),
+        secretResolver: getSecret,
+        storage: new FileStorageAdapter(getDefaultAssetsPath()),
+        workspace,
+        // The debug bundle crosses a JSON boundary. Store generated media so raw
+        // RGBA frames and image collections remain encoded, compact references.
+        assetOutputMode: "storage_url"
+    };
+    const context = input.context ? input.context.copy({ jobId, workflowId, workspace }) : new ProcessingContext(contextInit);
+    // ExecutionSession owns editor-only-node pruning (Comment/Group/Reroute —
+    // the web editor prunes them at serialize time; without this every
+    // commented example would die with "Unknown node type"), graph hydration,
+    // Python-bridge connection, and executor resolution (registry → Python
+    // bridge → throw) — the three steps this surface used to hand-roll.
+    // `limits.runTimeoutMs` replaces the old `withTimeout` race: instead of
+    // resolving a synthetic result while abandoning a still-running kernel, the
+    // facade calls `session.cancel("timeout")`, which actually tears the run
+    // down, and `session.result` only settles once that teardown completes.
+    // Supervision plumbs through the facade — the one integration point every
+    // surface shares (docs/workflow-supervisor-design.md §7).
+    const supervisor = input.supervisor
+        ? await createSupervisorHandle({ config: input.supervisor, context })
+        : null;
+    const sessionOptions = {
+        graph,
+        registry,
+        // Registry alone hydrates node flags but not `propertyTypes`, and
+        // correlation analysis reads list-ness only from that map — so every
+        // `list[...]` handle read as non-list here and a stream arriving on one
+        // collapsed to empty scope, keeping the last value. `Directed Film to
+        // Timeline` animated one shot of N under `debug` and all N under
+        // `workflows run`, which is backwards for a harness whose whole job is
+        // to reproduce a run. Same resolver `workflows run` and the websocket
+        // runner already pass.
+        resolveNodeType: createGraphNodeTypeResolver(registry).resolveNodeType,
+        jobId,
+        workflowId,
+        params,
+        context,
+        limits: { runTimeoutMs: input.timeoutMs }
+    };
+    // Capture is retention, so it stays off unless a supervised run needs the
+    // stream to print its `⛨` lines as they happen.
+    if (supervisor) {
+        sessionOptions.supervisor = supervisor.handle;
+        sessionOptions.captureMessages = true;
+    }
+    // A live host relays everything emitted on the run's context. That is a
+    // superset of RunResult.messages: a node can emit on its own, and an Agent
+    // node's tool calls (what a mini app's Agent Activity widget shows) only
+    // ever travel that way. The realtime-audio firehose stays out, as it does
+    // from the runner's own retention.
+    const relayed = [];
+    const detachRelay = context.addMessageListener((message) => {
+        if (!isAudioChunkOutputUpdate(message))
+            relayed.push(message);
+    });
+    // A run this runtime cannot honour (unknown model, unregistered provider,
+    // missing credential) is refused by `create()` before the kernel starts.
+    // The harness's job is to report why a run did not happen, so the refusal
+    // becomes a failed report rather than a thrown stack.
+    let session;
+    try {
+        session = await ExecutionSession.create(sessionOptions);
+    }
+    catch (err) {
+        detachRelay();
+        if (!isExecutionPreflightError(err))
+            throw err;
+        supervisor?.handle.close();
+        const summary = collectExecutionSummary([]);
+        summary.status = "failed";
+        summary.error = err.message;
+        return {
+            report: {
+                surface: "server",
+                ok: false,
+                status: "failed",
+                error: err.message,
+                durationMs: Date.now() - startedAt,
+                summary,
+                trace: null
+            },
+            rawMessages: []
+        };
+    }
+    const interventionLines = supervisor
+        ? streamInterventionLines(session.messages, input.onInterventionLine ?? ((line) => console.error(line)))
+        : Promise.resolve();
+    // `session.result` never rejects — kernel failures (including an unknown
+    // node type surfaced during executor resolution) resolve as `status:
+    // "failed"` instead of throwing, so no try/catch is needed here.
+    const result = await session.result;
+    await interventionLines;
+    supervisor?.handle.close();
+    const timedOut = session.cancelReason === "timeout";
+    detachRelay();
+    const messages = relayed.length > 0 ? relayed : (result.messages ?? []);
+    const summary = collectExecutionSummary(messages);
+    // The runner's RunResult status is authoritative; fall back to the message
+    // stream's view if it's missing.
+    summary.status = result.status ?? summary.status;
+    const error = result.error ??
+        (timedOut
+            ? `Debug server run exceeded timeout (${input.timeoutMs}ms)`
+            : undefined);
+    if (error && !summary.error)
+        summary.error = error;
+    // Spans are written eagerly via SimpleSpanProcessor, but the underlying
+    // WriteStream flushes async — give it a beat before reading the file back.
+    let trace = null;
+    if (input.tracePath) {
+        await new Promise((r) => setTimeout(r, 250));
+        trace = await readTraceSummary(input.tracePath);
+    }
+    const interventions = result.interventions ?? [];
+    if (supervisor && interventions.length > 0) {
+        await recordSupervisorCost({
+            interventions,
+            jobId,
+            workflowId,
+            userId: "1",
+            providerId: supervisor.providerId,
+            model: supervisor.model
+        });
+    }
+    const report = {
+        surface: "server",
+        ok: result.status === "completed",
+        status: result.status ?? summary.status,
+        error: error ?? summary.error,
+        durationMs: Date.now() - startedAt,
+        summary,
+        trace
+    };
+    if (supervisor) {
+        report.supervised = {
+            provider: supervisor.providerId,
+            model: supervisor.model,
+            summary: summarizeInterventions(interventions)
+        };
+    }
+    return { report, rawMessages: messages };
+}
+//# sourceMappingURL=server-runner.js.map

package/dist/debug/server-runner.js.map

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

package/dist/debug/target.d.ts

@@ -0,0 +1,34 @@
+import type { DebugGraph, DebugTargetInfo } from "./types.js";
+export interface ResolvedTarget {
+    info: DebugTargetInfo;
+    graph: DebugGraph;
+    /** Params discovered in a file's `params` field, merged under caller params. */
+    fileParams: Record<string, unknown>;
+    /** The workflow's app-builder document (`app_doc`), when present. */
+    appDoc: unknown;
+}
+/** A path-shaped ref, as opposed to a database id. */
+export declare function looksLikeFile(ref: string): boolean;
+/** A DSL ref, which has to be executed rather than read. */
+export declare function looksLikeDsl(ref: string): boolean;
+/**
+ * Read a file target's JSON: a `.json` file straight off disk, or the JSON a
+ * DSL file prints when executed.
+ */
+export declare function readFileTarget(ref: string): Promise<{
+    raw: unknown;
+    source: "json" | "dsl";
+}>;
+/** Convert ReactFlow `node.data` to kernel `node.properties` in place. */
+export declare function normalizeGraph(graph: DebugGraph): DebugGraph;
+/**
+ * Load a workflow from a file (JSON or DSL) or the local DB.
+ *
+ * `loadFromDb` is injected so this module stays free of a hard `@nodetool-ai/models`
+ * import at module load (keeps it light for the command-registration test path).
+ */
+export declare function resolveTarget(ref: string, loadFromDb: (id: string) => Promise<{
+    graph: DebugGraph;
+    app_doc?: unknown;
+} | null>): Promise<ResolvedTarget>;
+//# sourceMappingURL=target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/debug/target.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQlD;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,CAAC,CAcnD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAW5D;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,GACnF,OAAO,CAAC,cAAc,CAAC,CA2CzB"}

package/dist/debug/target.js

@@ -0,0 +1,104 @@
+/**
+ * Resolves a workflow debug target (DB id, JSON file, or TypeScript DSL file)
+ * into a normalized runner-shape graph plus metadata.
+ *
+ * Mirrors the resolution + normalization the `workflows run` command does so the
+ * debug harness executes the exact same graph the runner would.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+/** A path-shaped ref, as opposed to a database id. */
+export function looksLikeFile(ref) {
+    return (ref.endsWith(".json") ||
+        ref.endsWith(".ts") ||
+        ref.endsWith(".tsx") ||
+        ref.includes("/") ||
+        ref.includes("\\"));
+}
+/** A DSL ref, which has to be executed rather than read. */
+export function looksLikeDsl(ref) {
+    return ref.endsWith(".ts") || ref.endsWith(".tsx");
+}
+/**
+ * Read a file target's JSON: a `.json` file straight off disk, or the JSON a
+ * DSL file prints when executed.
+ */
+export async function readFileTarget(ref) {
+    if (looksLikeDsl(ref)) {
+        // DSL file: execute via tsx and capture the emitted JSON workflow.
+        // execFileSync, not execSync: the path goes through argv, so quotes or
+        // `$(...)` in a file name stay a file name instead of becoming shell.
+        const { execFileSync } = await import("node:child_process");
+        const output = execFileSync("npx", ["tsx", resolve(ref)], {
+            encoding: "utf8",
+            cwd: dirname(resolve(ref)),
+            timeout: 30000
+        });
+        return { raw: JSON.parse(output.trim()), source: "dsl" };
+    }
+    return { raw: JSON.parse(readFileSync(ref, "utf8")), source: "json" };
+}
+/** Convert ReactFlow `node.data` to kernel `node.properties` in place. */
+export function normalizeGraph(graph) {
+    return {
+        nodes: (graph.nodes ?? []).map((n) => {
+            if (n.properties === undefined && n.data !== undefined) {
+                const { data, ...rest } = n;
+                return { ...rest, properties: data };
+            }
+            return n;
+        }),
+        edges: graph.edges ?? []
+    };
+}
+/**
+ * Load a workflow from a file (JSON or DSL) or the local DB.
+ *
+ * `loadFromDb` is injected so this module stays free of a hard `@nodetool-ai/models`
+ * import at module load (keeps it light for the command-registration test path).
+ */
+export async function resolveTarget(ref, loadFromDb) {
+    let raw;
+    let source;
+    let workflowId;
+    const fileParams = {};
+    if (looksLikeFile(ref)) {
+        const file = await readFileTarget(ref);
+        raw = file.raw;
+        source = file.source;
+        workflowId = raw.workflow_id ?? raw.id ?? null;
+        if (raw.params)
+            Object.assign(fileParams, raw.params);
+    }
+    else {
+        const wf = await loadFromDb(ref);
+        if (!wf)
+            throw new Error(`Workflow not found: ${ref}`);
+        raw = wf;
+        workflowId = ref;
+        source = "id";
+    }
+    const rawGraph = raw.graph ?? raw;
+    if (!rawGraph?.nodes || !rawGraph?.edges) {
+        throw new Error("Invalid workflow: missing nodes or edges");
+    }
+    // A truthy non-array (`"nodes": 3`, `"edges": {}`) clears the check above and
+    // used to reach `.map()` below as a raw TypeError.
+    if (!Array.isArray(rawGraph.nodes) || !Array.isArray(rawGraph.edges)) {
+        throw new Error("Invalid workflow: nodes and edges must be arrays");
+    }
+    const graph = normalizeGraph(rawGraph);
+    return {
+        info: {
+            ref,
+            source,
+            workflowId,
+            nodeCount: graph.nodes.length,
+            edgeCount: graph.edges.length
+        },
+        graph,
+        fileParams,
+        appDoc: raw.app_doc ?? null
+    };
+}
+//# sourceMappingURL=target.js.map

package/dist/debug/target.js.map

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

package/dist/debug/trace.d.ts

@@ -0,0 +1,30 @@
+import type { TraceSummary } from "./types.js";
+/** One span as serialized by the JSONL trace exporter. */
+export interface TraceSpan {
+    trace_id: string;
+    span_id: string;
+    parent_span_id: string | null;
+    name: string;
+    kind: string;
+    start_time_ms: number;
+    end_time_ms: number;
+    duration_ms: number;
+    status: {
+        code: string;
+        message?: string;
+    };
+    attributes: Record<string, unknown>;
+    events: Array<{
+        name: string;
+        time_ms: number;
+        attributes?: Record<string, unknown>;
+    }>;
+    resource: Record<string, unknown>;
+}
+/** Parse a JSONL trace file body, skipping blank/corrupt lines. */
+export declare function parseTraceJsonl(text: string): TraceSpan[];
+/** Roll spans up into a `TraceSummary`. */
+export declare function summarizeSpans(spans: TraceSpan[]): TraceSummary;
+/** Read + summarize a trace file. Returns null when the file is missing/empty. */
+export declare function readTraceSummary(path: string): Promise<TraceSummary | null>;
+//# sourceMappingURL=trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/debug/trace.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACvF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAID,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAYzD;AAOD,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,YAAY,CA2C/D;AAED,kFAAkF;AAClF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAUjF"}

package/dist/debug/trace.js

@@ -0,0 +1,87 @@
+/**
+ * Reads and summarizes the OpenTelemetry JSONL trace a debug run produces.
+ *
+ * The runtime's `JsonlFileSpanExporter` writes one span per line in the shape
+ * documented in AGENTS.md (workflow.run → node.process → agent.* → llm.*). We
+ * roll those up into per-name timing plus token/cost totals from the
+ * `gen_ai.usage.*` attributes carried by every llm.chat / llm.stream span.
+ */
+import { readFile } from "node:fs/promises";
+import { isNumber } from "../predicates.js";
+const SLOWEST_LIMIT = 10;
+/** Parse a JSONL trace file body, skipping blank/corrupt lines. */
+export function parseTraceJsonl(text) {
+    const spans = [];
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            spans.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Ignore partial/corrupt lines (e.g. a crash mid-write).
+        }
+    }
+    return spans;
+}
+function numAttr(attrs, key) {
+    const v = attrs[key];
+    return isNumber(v) ? v : 0;
+}
+/** Roll spans up into a `TraceSummary`. */
+export function summarizeSpans(spans) {
+    const byName = {};
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let totalTokens = 0;
+    let costUsd = 0;
+    let minStart = Number.POSITIVE_INFINITY;
+    let maxEnd = Number.NEGATIVE_INFINITY;
+    for (const span of spans) {
+        const bucket = (byName[span.name] ??= { count: 0, totalDurationMs: 0 });
+        bucket.count += 1;
+        bucket.totalDurationMs += span.duration_ms;
+        if (Number.isFinite(span.start_time_ms))
+            minStart = Math.min(minStart, span.start_time_ms);
+        if (Number.isFinite(span.end_time_ms))
+            maxEnd = Math.max(maxEnd, span.end_time_ms);
+        const a = span.attributes ?? {};
+        inputTokens += numAttr(a, "gen_ai.usage.input_tokens");
+        outputTokens += numAttr(a, "gen_ai.usage.output_tokens");
+        totalTokens += numAttr(a, "gen_ai.usage.total_tokens");
+        costUsd += numAttr(a, "gen_ai.usage.cost_usd");
+    }
+    const slowest = spans
+        .slice()
+        .sort((x, y) => y.duration_ms - x.duration_ms)
+        .slice(0, SLOWEST_LIMIT)
+        .map((s) => ({ name: s.name, durationMs: s.duration_ms, status: s.status?.code ?? "UNSET" }));
+    return {
+        spanCount: spans.length,
+        totalDurationMs: spans.length > 0 && minStart !== Number.POSITIVE_INFINITY ? maxEnd - minStart : null,
+        tokens: {
+            input: inputTokens,
+            output: outputTokens,
+            total: totalTokens || inputTokens + outputTokens
+        },
+        costUsd,
+        byName,
+        slowest
+    };
+}
+/** Read + summarize a trace file. Returns null when the file is missing/empty. */
+export async function readTraceSummary(path) {
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const spans = parseTraceJsonl(text);
+    if (spans.length === 0)
+        return null;
+    return summarizeSpans(spans);
+}
+//# sourceMappingURL=trace.js.map

package/dist/debug/trace.js.map

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

package/dist/debug/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Shared types for the workflow debug harness.
+ *
+ * The harness runs a workflow end-to-end on two surfaces — the headless server
+ * (kernel `WorkflowRunner`) and a real browser (the `e2e_runner` page driven by
+ * Playwright) — and folds everything worth inspecting into a single
+ * `DebugReport`: the workflow graph JSON, every processing message (logs, node
+ * IO, outputs, edges, LLM calls), an OpenTelemetry span summary, browser console
+ * errors and a screenshot. The report is written to a bundle directory and also
+ * returned so an agent can iterate without re-parsing files.
+ */
+import type { DebugGraph, DebugTargetInfo, DebugVerdict, ExecutionSummary, ServerRunReport } from "@nodetool-ai/execution/debug";
+import type { SupervisorRunConfig } from "../supervisor.js";
+export type { DebugError, DebugGraph, DebugTargetInfo, DebugVerdict, EdgeDebug, ExecutionSummary, LlmCallDebug, LogEntry, NodeDebug, NodeOutput, RunVerdict, ServerRunReport, TraceSummary } from "@nodetool-ai/execution/debug";
+/** A canvas screenshot captured at one stage of the browser run. */
+interface BrowserStageShot {
+    /** 0-based capture order. */
+    index: number;
+    /** Run status at capture time (running until the final frame). */
+    status: string;
+    /** Bundle-relative path to the screenshot. */
+    file: string;
+}
+export interface BrowserRunReport {
+    surface: "browser";
+    ok: boolean;
+    status: string;
+    error: string | null;
+    durationMs: number | null;
+    summary: ExecutionSummary;
+    consoleErrors: string[];
+    /** Bundle-relative path to the final settled screenshot. */
+    screenshotFile?: string;
+    /** Canvas screenshots captured at successive stages of the run. */
+    stages?: BrowserStageShot[];
+    /** Bundle-relative path to the raw browser RunRecord JSON. */
+    recordFile?: string;
+    /** Set when the browser surface could not run (missing deps / browser). */
+    unavailableReason?: string;
+}
+export interface DebugReport {
+    generatedAt: string;
+    target: DebugTargetInfo;
+    /** The workflow graph JSON (runner shape). */
+    workflow: DebugGraph;
+    server: ServerRunReport | null;
+    browser: BrowserRunReport | null;
+    verdict: DebugVerdict;
+    /** Absolute path to the on-disk bundle, when one was written. */
+    bundleDir: string | null;
+}
+/** Options that drive a debug run. */
+export interface DebugOptions {
+    /** Run the headless server surface. Default true. */
+    server?: boolean;
+    /** Run the real-browser surface (Playwright). Expensive; default false. */
+    browser?: boolean;
+    /**
+     * Capture an OpenTelemetry trace of the server run (timing/tokens/cost).
+     * Expensive — loads the OTel SDK and adds per-span overhead. Default false.
+     */
+    trace?: boolean;
+    /**
+     * On the browser surface, capture a canvas screenshot at every stage of the
+     * run instead of only the final frame. Expensive; implies `browser`. Default
+     * false.
+     */
+    stages?: boolean;
+    /** Input params keyed by input-node name. */
+    params?: Record<string, unknown>;
+    /** Bundle output directory. When omitted a timestamped dir is generated. */
+    outDir?: string;
+    /** Per-surface run timeout, ms. */
+    timeoutMs?: number;
+    /**
+     * Supervise the server surface (`--supervise` and its bounds). The browser
+     * surface runs the workflow through the web runtime, which has no supervisor
+     * of its own until the editor toggle ships, so it is unaffected.
+     */
+    supervisor?: SupervisorRunConfig;
+}
+//# 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":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,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,8BAA8B,CAAC;AAEtC,oEAAoE;AACpE,UAAU,gBAAgB;IACxB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,SAAS,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB,iEAAiE;IACjE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/debug/types.js

@@ -0,0 +1,13 @@
+/**
+ * Shared types for the workflow debug harness.
+ *
+ * The harness runs a workflow end-to-end on two surfaces — the headless server
+ * (kernel `WorkflowRunner`) and a real browser (the `e2e_runner` page driven by
+ * Playwright) — and folds everything worth inspecting into a single
+ * `DebugReport`: the workflow graph JSON, every processing message (logs, node
+ * IO, outputs, edges, LLM calls), an OpenTelemetry span summary, browser console
+ * errors and a screenshot. The report is written to a bundle directory and also
+ * returned so an agent can iterate without re-parsing files.
+ */
+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;;;;;;;;;;GAUG"}

package/dist/debug/verdict.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserRunReport, DebugVerdict, ServerRunReport } from "./types.js";
+export declare function buildVerdict(server: ServerRunReport | null, browser: BrowserRunReport | null): DebugVerdict;
+//# 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,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAC/B,YAAY,CAgFd"}