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

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

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/debug/collector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,uBAAuB,EACvB,YAAY,EACb,MAAM,8BAA8B,CAAC"}

package/dist/debug/collector.js

@@ -0,0 +1,9 @@
+/**
+ * Re-export of the shared execution-summary collector.
+ *
+ * The reducer lives in `@nodetool-ai/execution` so the CLI harness, the HTTP
+ * debug endpoint and the agent-facing `debug_workflow` tool all distill a run
+ * the same way. This module keeps the CLI's original import path.
+ */
+export { collectExecutionSummary, previewValue } from "@nodetool-ai/execution/debug";
+//# 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":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,uBAAuB,EACvB,YAAY,EACb,MAAM,8BAA8B,CAAC"}

package/dist/debug/diff.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Diffs two harness runs so watch mode can show only what changed between
+ * edits: status transitions, newly-appeared and resolved issues, and token/cost
+ * movement.
+ *
+ * The diff works on a {@link RunSnapshot} — ok, issues, one status word, and
+ * the run's totals — so every watchable harness shares one differ. `debug`
+ * projects a {@link DebugReport} into it; `app build` projects a `BuildReport`.
+ * Pure (types only), so it is unit-tested directly.
+ */
+import type { DebugReport } from "./types.js";
+/** What a differ needs from a run, whatever harness produced it. */
+export interface RunSnapshot {
+    ok: boolean;
+    /** Everything wrong right now, not a delta. */
+    issues: string[];
+    /** One word for the run's main surface, e.g. `completed` or `run/failed`. */
+    status: string | null;
+    tokens: number | null;
+    costUsd: number | null;
+}
+export interface DebugDiff {
+    /** Verdict ok transition, when it changed. */
+    okChanged: {
+        from: boolean;
+        to: boolean;
+    } | null;
+    /** Status transition, when it changed. */
+    serverStatusChanged: {
+        from: string | null;
+        to: string | null;
+    } | null;
+    /** Issues present now but not before. */
+    newIssues: string[];
+    /** Issues present before but not now. */
+    resolvedIssues: string[];
+    /** Token/cost deltas, when both runs reported them. */
+    tokenDelta: number | null;
+    costDelta: number | null;
+}
+/** Project a workflow debug report into the shape the differ reads. */
+export declare function snapshotDebugReport(report: DebugReport): RunSnapshot;
+export declare function diffRuns(prev: RunSnapshot, next: RunSnapshot): DebugDiff;
+export declare function diffReports(prev: DebugReport, next: DebugReport): DebugDiff;
+/** True when nothing an agent would act on changed between two runs. */
+export declare function diffIsEmpty(diff: DebugDiff): boolean;
+export declare function formatDiff(diff: DebugDiff, statusLabel?: string): string;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/debug/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,+CAA+C;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,SAAS,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,0CAA0C;IAC1C,mBAAmB,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,yCAAyC;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yCAAyC;IACzC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CASpE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,CAwBxE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,CAE3E;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAOpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,SAAW,GAAG,MAAM,CA0B1E"}

package/dist/debug/diff.js

@@ -0,0 +1,68 @@
+/** Project a workflow debug report into the shape the differ reads. */
+export function snapshotDebugReport(report) {
+    const trace = report.server?.trace;
+    return {
+        ok: report.verdict.ok,
+        issues: report.verdict.issues,
+        status: report.server ? report.server.status : null,
+        tokens: trace ? trace.tokens.total : null,
+        costUsd: trace ? trace.costUsd : null
+    };
+}
+export function diffRuns(prev, next) {
+    const prevIssues = new Set(prev.issues);
+    const nextIssues = new Set(next.issues);
+    // Tokens and cost move independently: a build reports what it spent without
+    // counting tokens, so one being absent must not suppress the other.
+    const tokenDelta = prev.tokens != null && next.tokens != null ? next.tokens - prev.tokens : null;
+    const costDelta = prev.costUsd != null && next.costUsd != null
+        ? next.costUsd - prev.costUsd
+        : null;
+    return {
+        okChanged: prev.ok !== next.ok ? { from: prev.ok, to: next.ok } : null,
+        serverStatusChanged: prev.status !== next.status
+            ? { from: prev.status, to: next.status }
+            : null,
+        newIssues: next.issues.filter((i) => !prevIssues.has(i)),
+        resolvedIssues: prev.issues.filter((i) => !nextIssues.has(i)),
+        tokenDelta,
+        costDelta
+    };
+}
+export function diffReports(prev, next) {
+    return diffRuns(snapshotDebugReport(prev), snapshotDebugReport(next));
+}
+/** True when nothing an agent would act on changed between two runs. */
+export function diffIsEmpty(diff) {
+    return (diff.okChanged === null &&
+        diff.serverStatusChanged === null &&
+        diff.newIssues.length === 0 &&
+        diff.resolvedIssues.length === 0);
+}
+export function formatDiff(diff, statusLabel = "server") {
+    if (diffIsEmpty(diff))
+        return "No change since last run.";
+    const lines = [];
+    if (diff.okChanged) {
+        lines.push(diff.okChanged.to
+            ? "✅ Now passing (was failing)"
+            : "❌ Now failing (was passing)");
+    }
+    if (diff.serverStatusChanged) {
+        lines.push(`${statusLabel}: ${diff.serverStatusChanged.from ?? "—"} → ${diff.serverStatusChanged.to ?? "—"}`);
+    }
+    for (const issue of diff.resolvedIssues)
+        lines.push(`  - resolved: ${issue}`);
+    for (const issue of diff.newIssues)
+        lines.push(`  + new: ${issue}`);
+    if (diff.tokenDelta != null && diff.tokenDelta !== 0) {
+        const sign = diff.tokenDelta > 0 ? "+" : "";
+        lines.push(`tokens: ${sign}${diff.tokenDelta}`);
+    }
+    if (diff.costDelta != null && Math.abs(diff.costDelta) > 1e-9) {
+        const sign = diff.costDelta > 0 ? "+" : "";
+        lines.push(`cost: ${sign}$${diff.costDelta.toFixed(4)}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/debug/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/debug/diff.ts"],"names":[],"mappings":"AAqCA,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QACnD,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACzC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAiB,EAAE,IAAiB;IAC3D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExC,4EAA4E;IAC5E,oEAAoE;IACpE,MAAM,UAAU,GACd,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,MAAM,SAAS,GACb,IAAI,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;QAC1C,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;QAC7B,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;QACtE,mBAAmB,EACjB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YACzB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;YACxC,CAAC,CAAC,IAAI;QACV,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxD,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7D,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAiB,EAAE,IAAiB;IAC9D,OAAO,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,OAAO,CACL,IAAI,CAAC,SAAS,KAAK,IAAI;QACvB,IAAI,CAAC,mBAAmB,KAAK,IAAI;QACjC,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAC3B,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,WAAW,GAAG,QAAQ;IAChE,IAAI,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,2BAA2B,CAAC;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,SAAS,CAAC,EAAE;YACf,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,6BAA6B,CAClC,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,GAAG,WAAW,KAAK,IAAI,CAAC,mBAAmB,CAAC,IAAI,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,EAAE,IAAI,GAAG,EAAE,CAClG,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;IAC9E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/debug/harness.d.ts

@@ -0,0 +1,11 @@
+import type { DebugGraph, DebugOptions, DebugReport } from "./types.js";
+export interface DebugHarnessDeps {
+    /** Load a workflow graph by DB id (injected to keep models out of light paths). */
+    loadFromDb: (id: string) => Promise<{
+        graph: DebugGraph;
+    } | null>;
+    /** Progress/log sink for surfacing child-process output. */
+    onLog?: (line: string) => void;
+}
+export declare function runDebug(ref: string, options: DebugOptions, deps: DebugHarnessDeps): Promise<DebugReport>;
+//# sourceMappingURL=harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/debug/harness.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAClE,4DAA4D;IAC5D,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAYD,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,WAAW,CAAC,CA8GtB"}

package/dist/debug/harness.js

@@ -0,0 +1,103 @@
+/**
+ * The workflow debug harness orchestrator.
+ *
+ * Resolves a target workflow, runs it on the requested surfaces (headless server
+ * and/or real browser), folds everything into a `DebugReport`, and writes a
+ * self-contained debug bundle to disk. Returns the report so an agent can act on
+ * it directly and iterate (edit → re-run) without re-reading files.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { initTelemetry } from "@nodetool-ai/runtime";
+import { runOnServer } from "./server-runner.js";
+import { runInBrowser } from "./browser-runner.js";
+import { buildVerdict } from "./verdict.js";
+import { renderReportMarkdown } from "./markdown.js";
+import { resolveTarget } from "./target.js";
+function defaultOutDir(ref) {
+    const slug = ref
+        .replace(/[^a-zA-Z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40) || "workflow";
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    return resolve(`nodetool-debug/${slug}-${stamp}`);
+}
+export async function runDebug(ref, options, deps) {
+    const runServer = options.server ?? true;
+    // `--stages` is a browser-surface modifier, so opting into it implies the
+    // browser surface.
+    const runBrowser = (options.browser ?? false) || (options.stages ?? false);
+    const captureTrace = options.trace ?? false;
+    const log = deps.onLog ?? (() => { });
+    // A run with no surface exercises nothing, and the verdict builder scored it
+    // "ran clean on no surface" — a green report for a workflow that never ran.
+    if (!runServer && !runBrowser) {
+        throw new Error("Nothing to debug: --no-server was passed without --browser. Enable at least one surface.");
+    }
+    const resolved = await resolveTarget(ref, deps.loadFromDb);
+    const params = { ...resolved.fileParams, ...(options.params ?? {}) };
+    const outDir = options.outDir ? resolve(options.outDir) : defaultOutDir(ref);
+    await mkdir(outDir, { recursive: true });
+    await writeFile(join(outDir, "workflow.json"), JSON.stringify(resolved.graph, null, 2), "utf8");
+    const report = {
+        generatedAt: new Date().toISOString(),
+        target: resolved.info,
+        workflow: resolved.graph,
+        server: null,
+        browser: null,
+        verdict: { ok: false, headline: "", issues: [] },
+        bundleDir: outDir
+    };
+    if (runServer) {
+        log("Running workflow on the server surface…");
+        const serverDir = join(outDir, "server");
+        await mkdir(serverDir, { recursive: true });
+        // Tracing is opt-in (`--trace`): loading the OTel SDK and processing spans
+        // is real overhead. When enabled, route span output into the bundle — this
+        // wins because the `debug` command skips the global telemetry init.
+        let tracePath = null;
+        if (captureTrace) {
+            tracePath = join(serverDir, "trace.jsonl");
+            await initTelemetry({ traceFile: tracePath, silent: true });
+        }
+        const runInput = {
+            graph: resolved.graph,
+            workflowId: resolved.info.workflowId,
+            params,
+            tracePath,
+            timeoutMs: options.timeoutMs,
+            onInterventionLine: log
+        };
+        if (options.supervisor) {
+            runInput.supervisor = options.supervisor;
+        }
+        const outcome = await runOnServer(runInput);
+        const messagesPath = join(serverDir, "messages.jsonl");
+        await writeFile(messagesPath, outcome.rawMessages.map((m) => JSON.stringify(m)).join("\n") + "\n", "utf8");
+        outcome.report.messagesFile = "server/messages.jsonl";
+        if (outcome.report.trace)
+            outcome.report.traceFile = "server/trace.jsonl";
+        report.server = outcome.report;
+        log(`Server run: ${outcome.report.status} · ${outcome.report.summary.counts.errored} node error(s)`);
+    }
+    if (runBrowser) {
+        log("Running workflow on the browser surface (Playwright)…");
+        const browserDir = join(outDir, "browser");
+        report.browser = await runInBrowser({
+            graph: resolved.graph,
+            params,
+            outDir: browserDir,
+            captureStages: options.stages ?? false,
+            timeoutMs: options.timeoutMs,
+            onLog: log
+        });
+        log(report.browser.unavailableReason
+            ? `Browser run skipped: ${report.browser.unavailableReason}`
+            : `Browser run: ${report.browser.status} · ${report.browser.consoleErrors.length} console error(s)`);
+    }
+    report.verdict = buildVerdict(report.server, report.browser);
+    await writeFile(join(outDir, "report.json"), JSON.stringify(report, null, 2), "utf8");
+    await writeFile(join(outDir, "report.md"), renderReportMarkdown(report), "utf8");
+    return report;
+}
+//# sourceMappingURL=harness.js.map

package/dist/debug/harness.js.map

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

package/dist/debug/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Workflow debug harness — runs a workflow end-to-end on the server and/or in a
+ * real browser and collects the workflow JSON, every log/output/error, and an
+ * OpenTelemetry trace summary into a single `DebugReport` + on-disk bundle.
+ */
+export { runDebug, type DebugHarnessDeps } from "./harness.js";
+export { runOnServer, type ServerRunInput, type ServerRunOutcome } from "./server-runner.js";
+export { runInBrowser, buildBrowserReport, type BrowserRunInput } from "./browser-runner.js";
+export { resolveTarget, type ResolvedTarget } from "./target.js";
+export { collectExecutionSummary, previewValue } from "./collector.js";
+export { parseTraceJsonl, summarizeSpans, readTraceSummary, type TraceSpan } from "./trace.js";
+export { buildVerdict } from "./verdict.js";
+export { renderReportMarkdown } from "./markdown.js";
+export { diffReports, diffRuns, diffIsEmpty, formatDiff, snapshotDebugReport, type DebugDiff, type RunSnapshot } from "./diff.js";
+export { runWatchLoop, type FileWatcher, type WatchLoopInit } from "./watch.js";
+export type * 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;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAChF,mBAAmB,YAAY,CAAC"}

package/dist/debug/index.js

@@ -0,0 +1,16 @@
+/**
+ * Workflow debug harness — runs a workflow end-to-end on the server and/or in a
+ * real browser and collects the workflow JSON, every log/output/error, and an
+ * OpenTelemetry trace summary into a single `DebugReport` + on-disk bundle.
+ */
+export { runDebug } from "./harness.js";
+export { runOnServer } from "./server-runner.js";
+export { runInBrowser, buildBrowserReport } from "./browser-runner.js";
+export { resolveTarget } from "./target.js";
+export { collectExecutionSummary, previewValue } from "./collector.js";
+export { parseTraceJsonl, summarizeSpans, readTraceSummary } from "./trace.js";
+export { buildVerdict } from "./verdict.js";
+export { renderReportMarkdown } from "./markdown.js";
+export { diffReports, diffRuns, diffIsEmpty, formatDiff, snapshotDebugReport } from "./diff.js";
+export { runWatchLoop } from "./watch.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;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAyB,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,WAAW,EAA8C,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAwB,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,mBAAmB,EAGpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAwC,MAAM,YAAY,CAAC"}

package/dist/debug/markdown.d.ts

@@ -0,0 +1,3 @@
+import type { DebugReport } from "./types.js";
+export declare function renderReportMarkdown(report: DebugReport): string;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/debug/markdown.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEV,WAAW,EAIZ,MAAM,YAAY,CAAC;AAwHpB,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsBhE"}

package/dist/debug/markdown.js

@@ -0,0 +1,127 @@
+/**
+ * Renders a `DebugReport` as a human-readable Markdown document (report.md in
+ * the bundle). Pure — no IO — so it's trivially testable.
+ */
+import { formatInterventionLine, formatSupervisedSummary, summarizeInterventions } from "@nodetool-ai/execution/debug";
+function fmtMs(ms) {
+    if (ms === null || ms === undefined)
+        return "—";
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    return `${(ms / 1000).toFixed(2)}s`;
+}
+function summarySection(summary) {
+    const lines = [];
+    const c = summary.counts;
+    lines.push(`- Status: **${summary.status}**` + (summary.error ? ` — ${summary.error}` : ""));
+    lines.push(`- Nodes: ${c.nodes} (completed ${c.completed}, errored ${c.errored}) · ` +
+        `outputs ${c.outputs} · logs ${c.logs} · llm calls ${c.llmCalls}`);
+    if (summary.errors.length > 0) {
+        lines.push("", "**Errors**");
+        for (const e of summary.errors) {
+            lines.push(`- \`${e.nodeType ?? e.nodeId ?? "workflow"}\`: ${e.message}`);
+        }
+    }
+    const failing = summary.nodes.filter((n) => n.error);
+    if (failing.length > 0) {
+        lines.push("", "**Failing nodes**");
+        for (const n of failing) {
+            lines.push(`- \`${n.nodeType ?? n.nodeId}\` (${n.nodeId}) — ${n.error}`);
+        }
+    }
+    if (summary.outputs.length > 0) {
+        lines.push("", "**Outputs**");
+        for (const o of summary.outputs.slice(0, 20)) {
+            lines.push(`- \`${o.outputName}\` (${o.outputType}): ${JSON.stringify(o.value)}`);
+        }
+    }
+    if (summary.llmCalls.length > 0) {
+        lines.push("", "**LLM calls**");
+        for (const call of summary.llmCalls.slice(0, 20)) {
+            const tok = `${call.tokensInput ?? "?"}→${call.tokensOutput ?? "?"} tok`;
+            const cost = call.cost != null ? ` · $${call.cost.toFixed(4)}` : "";
+            lines.push(`- ${call.provider}/${call.model} · ${tok}${cost} · ${fmtMs(call.durationMs)}` +
+                (call.error ? ` · ERROR ${call.error}` : ""));
+        }
+    }
+    if (summary.interventions.length > 0) {
+        lines.push("", "**Interventions**");
+        for (const intervention of summary.interventions) {
+            lines.push(`- ${formatInterventionLine(intervention)}`);
+        }
+        lines.push(`- ${formatSupervisedSummary(summarizeInterventions(summary.interventions))}`);
+    }
+    if (summary.logs.length > 0) {
+        lines.push("", "**Logs**");
+        for (const log of summary.logs.slice(0, 50)) {
+            const where = log.nodeId ? ` [${log.nodeId}]` : "";
+            lines.push(`- \`${log.severity}\`${where} ${log.content}`);
+        }
+        if (summary.logs.length > 50)
+            lines.push(`- …and ${summary.logs.length - 50} more`);
+    }
+    return lines;
+}
+function traceSection(trace) {
+    const lines = ["", "**Trace**"];
+    lines.push(`- ${trace.spanCount} spans · ${fmtMs(trace.totalDurationMs)} wall · ` +
+        `${trace.tokens.total} tokens · $${trace.costUsd.toFixed(4)}`);
+    const names = Object.entries(trace.byName).sort((a, b) => b[1].totalDurationMs - a[1].totalDurationMs);
+    for (const [name, agg] of names.slice(0, 10)) {
+        lines.push(`- \`${name}\` ×${agg.count} · ${fmtMs(agg.totalDurationMs)}`);
+    }
+    return lines;
+}
+function serverSection(server) {
+    const lines = ["## Server surface", ""];
+    lines.push(`Outcome: ${server.ok ? "✅ completed" : `❌ ${server.status}`} · ${fmtMs(server.durationMs)}`);
+    lines.push(...summarySection(server.summary));
+    if (server.trace)
+        lines.push(...traceSection(server.trace));
+    return lines;
+}
+function browserSection(browser) {
+    const lines = ["## Browser surface", ""];
+    if (browser.unavailableReason) {
+        lines.push(`⚠️ Not run: ${browser.unavailableReason}`);
+        return lines;
+    }
+    lines.push(`Outcome: ${browser.ok ? "✅ completed" : `❌ ${browser.status}`} · ${fmtMs(browser.durationMs)}`);
+    lines.push(...summarySection(browser.summary));
+    if (browser.consoleErrors.length > 0) {
+        lines.push("", "**Console errors**");
+        for (const err of browser.consoleErrors.slice(0, 20))
+            lines.push(`- ${err}`);
+    }
+    if (browser.stages && browser.stages.length > 0) {
+        lines.push("", `**Stage screenshots** (${browser.stages.length})`);
+        for (const s of browser.stages) {
+            lines.push(`- \`${String(s.index).padStart(2, "0")}\` ${s.status} — \`${s.file}\``);
+        }
+    }
+    if (browser.screenshotFile)
+        lines.push("", `Final screenshot: \`${browser.screenshotFile}\``);
+    return lines;
+}
+export function renderReportMarkdown(report) {
+    const lines = [];
+    lines.push(`# Workflow debug report`, "");
+    lines.push(`${report.verdict.ok ? "✅" : "❌"} **${report.verdict.headline}**`, "");
+    lines.push(`- Target: \`${report.target.ref}\` (${report.target.source}` +
+        (report.target.workflowId ? `, id ${report.target.workflowId}` : "") +
+        `)`);
+    lines.push(`- Graph: ${report.target.nodeCount} nodes, ${report.target.edgeCount} edges`);
+    lines.push(`- Generated: ${report.generatedAt}`);
+    if (report.verdict.issues.length > 0) {
+        lines.push("", "## Issues", "");
+        for (const issue of report.verdict.issues)
+            lines.push(`- ${issue}`);
+    }
+    if (report.server)
+        lines.push("", ...serverSection(report.server));
+    if (report.browser)
+        lines.push("", ...browserSection(report.browser));
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=markdown.js.map

package/dist/debug/markdown.js.map

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

package/dist/debug/server-runner.d.ts

@@ -0,0 +1,24 @@
+import type { ProcessingMessage } from "@nodetool-ai/protocol";
+import { ProcessingContext } from "@nodetool-ai/runtime";
+import { type SupervisorRunConfig } from "../supervisor.js";
+import type { DebugGraph, ServerRunReport } from "./types.js";
+export interface ServerRunInput {
+    graph: DebugGraph;
+    workflowId: string | null;
+    params: Record<string, unknown>;
+    /** Absolute path telemetry was told to write spans to; read back for trace summary. */
+    tracePath?: string | null;
+    timeoutMs?: number;
+    /** Supervise this run (`--supervise` and its bounds). */
+    supervisor?: SupervisorRunConfig;
+    /** Sink for the inline `⛨` lines. Defaults to stderr. */
+    onInterventionLine?: (line: string) => void;
+    context?: ProcessingContext;
+}
+export interface ServerRunOutcome {
+    report: ServerRunReport;
+    /** The full message stream, for writing the raw bundle artifact. */
+    rawMessages: ProcessingMessage[];
+}
+export declare function runOnServer(input: ServerRunInput): Promise<ServerRunOutcome>;
+//# sourceMappingURL=server-runner.d.ts.map

package/dist/debug/server-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-runner.d.ts","sourceRoot":"","sources":["../../src/debug/server-runner.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAa9D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,oEAAoE;IACpE,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAYD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAyK3B"}