@nodetool-ai/cli-workflow 0.0.0-stage → 0.8.9-beta.2

package/dist/commands/debug.js

@@ -0,0 +1,149 @@
+import { trimHyphens } from "@nodetool-ai/cli-common/trimHyphens";
+import { formatInterventionLine, formatSupervisedSummary, summarizeInterventions } from "@nodetool-ai/execution/debug";
+import { addSupervisorOptions, parseSupervisorFlags } from "@nodetool-ai/cli-execution/supervisor";
+import { numericOptionParser } from "@nodetool-ai/cli-common/numeric-options";
+import { printCommandError, commandMissingRuntime, commandMissingPack } from "@nodetool-ai/pack-manager/command-errors";
+import { installMissingPacksAndReexec } from "./install-missing-packs.js";
+export function registerDebugCommands(program) {
+    addSupervisorOptions(program
+        .command("debug <workflow_id_or_file>")
+        .description("Run a workflow end-to-end (server and/or browser) and collect a full debug bundle")
+        .option("--no-server", "Skip the headless server surface")
+        .option("--install-missing", "Authorize missing node pack installation, then re-execute once")
+        .option("--browser", "Also run the workflow in a real browser (Playwright) — expensive")
+        .option("--trace", "Capture an OpenTelemetry trace of the server run (timing/tokens/cost) — expensive")
+        .option("--stages", "Capture a canvas screenshot at every browser run stage (implies --browser) — expensive")
+        .option("--params <json>", "JSON params string keyed by input-node name")
+        .option("--out <dir>", "Bundle output directory (default: nodetool-debug/<id>-<timestamp>)")
+        .option("--timeout <ms>", "Per-surface run timeout in milliseconds", numericOptionParser("--timeout", { integer: true, min: 0 }))
+        .option("--json", "Print the full DebugReport as JSON to stdout")
+        .option("--watch", "Re-run on file change and print a diff of the verdict (file targets only)")).action(async (ref, opts) => {
+        try {
+            const { initDb, Workflow } = await import("@nodetool-ai/models");
+            const { initMasterKey } = await import("@nodetool-ai/security");
+            const { getDefaultDbPath } = await import("@nodetool-ai/config");
+            const { runDebug, runWatchLoop, snapshotDebugReport } = await import("@nodetool-ai/cli-execution/debug/index");
+            initDb(getDefaultDbPath());
+            try {
+                await initMasterKey();
+            }
+            catch {
+                // Secret decryption is best-effort for debug runs; a missing master
+                // key only affects nodes that need secrets.
+            }
+            const params = opts.params
+                ? JSON.parse(opts.params)
+                : {};
+            const loadFromDb = (id) => Workflow.get(id);
+            // In watch mode keep a stable bundle dir so each re-run overwrites
+            // rather than littering timestamped directories.
+            const supervisor = parseSupervisorFlags(opts);
+            const runOptions = {
+                server: opts.server,
+                browser: opts.browser ?? false,
+                trace: opts.trace ?? false,
+                stages: opts.stages ?? false,
+                params
+            };
+            if (supervisor) {
+                runOptions.supervisor = supervisor;
+            }
+            if (opts.out) {
+                runOptions.outDir = opts.out;
+            }
+            else if (opts.watch) {
+                runOptions.outDir = `nodetool-debug/${watchSlug(ref)}-watch`;
+            }
+            if (opts.timeout) {
+                runOptions.timeoutMs = opts.timeout;
+            }
+            const runOnce = () => runDebug(ref, runOptions, {
+                loadFromDb,
+                onLog: (line) => console.error(line.trimEnd())
+            });
+            const report = await runOnce();
+            if (!report.verdict.ok && (commandMissingRuntime(report) || commandMissingPack(report))) {
+                const exit = await installMissingPacksAndReexec(report, { command: "debug", installMissing: opts.installMissing });
+                if (exit !== null) {
+                    process.exit(exit);
+                }
+                process.exit(printCommandError(report, opts.json));
+            }
+            if (opts.json) {
+                console.log(JSON.stringify(report, null, 2));
+            }
+            else {
+                printSummary(report);
+            }
+            if (!opts.watch) {
+                process.exit(report.verdict.ok ? 0 : 1);
+            }
+            // ── Watch mode ────────────────────────────────────────────────────
+            const { existsSync } = await import("node:fs");
+            const { resolve } = await import("node:path");
+            const watchPath = resolve(ref);
+            if (!existsSync(watchPath)) {
+                console.error(`\n--watch needs a file target to watch; "${ref}" is not a file on disk.`);
+                process.exit(1);
+            }
+            await runWatchLoop({
+                file: watchPath,
+                first: report,
+                run: runOnce,
+                snapshot: snapshotDebugReport,
+                log: (line) => console.error(line)
+            });
+            process.exit(0);
+        }
+        catch (e) {
+            const exit = await installMissingPacksAndReexec(e, { command: "debug", installMissing: opts.installMissing });
+            if (exit !== null) {
+                process.exit(exit);
+            }
+            process.exit(printCommandError(e, opts.json));
+        }
+    });
+}
+function watchSlug(ref) {
+    return (trimHyphens(ref.replace(/[^a-zA-Z0-9_-]+/g, "-"))
+        .slice(0, 40) || "workflow");
+}
+function printSummary(report) {
+    const mark = report.verdict.ok ? "✅" : "❌";
+    console.log(`\n${mark} ${report.verdict.headline}`);
+    if (report.server) {
+        console.log(`  server:  ${report.server.status} (${report.server.summary.counts.errored} node error(s))`);
+        const interventions = report.server.summary.interventions;
+        if (report.server.supervised && interventions.length > 0) {
+            for (const intervention of interventions) {
+                console.log(`  ${formatInterventionLine(intervention)}`);
+            }
+            console.log(`  ${formatSupervisedSummary(summarizeInterventions(interventions))}`);
+        }
+    }
+    if (report.browser) {
+        console.log(report.browser.unavailableReason
+            ? `  browser: skipped — ${report.browser.unavailableReason}`
+            : `  browser: ${report.browser.status} (${report.browser.consoleErrors.length} console error(s))`);
+    }
+    if (report.verdict.issues.length > 0) {
+        console.log("\nIssues:");
+        for (const issue of report.verdict.issues)
+            console.log(`  - ${issue}`);
+    }
+    if (report.verdict.warnings && report.verdict.warnings.length > 0) {
+        console.log("\nWarnings:");
+        for (const warning of report.verdict.warnings)
+            console.log(`  - ${warning}`);
+    }
+    if (report.bundleDir) {
+        const parts = ["report.md / report.json", "workflow.json"];
+        if (report.server)
+            parts.push("server/");
+        if (report.browser && !report.browser.unavailableReason)
+            parts.push("browser/");
+        console.log(`\nDebug bundle: ${report.bundleDir}`);
+        console.log(`  ${parts.join(" · ")}`);
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/commands/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,qCAAqC,CAAC;AAYhE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EAErB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACxH,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAe1E,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,oBAAoB,CAClB,OAAO;SACJ,OAAO,CAAC,6BAA6B,CAAC;SACtC,WAAW,CACV,mFAAmF,CACpF;SACA,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;SACzD,MAAM,CAAC,mBAAmB,EAAE,gEAAgE,CAAC;SAC7F,MAAM,CACL,WAAW,EACX,kEAAkE,CACnE;SACA,MAAM,CACL,SAAS,EACT,mFAAmF,CACpF;SACA,MAAM,CACL,UAAU,EACV,wFAAwF,CACzF;SACA,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;SACxE,MAAM,CACL,aAAa,EACb,oEAAoE,CACrE;SACA,MAAM,CACL,gBAAgB,EAChB,yCAAyC,EACzC,mBAAmB,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAC5D;SACA,MAAM,CAAC,QAAQ,EAAE,8CAA8C,CAAC;SAChE,MAAM,CACL,SAAS,EACT,2EAA2E,CAC5E,CACJ,CAAC,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,IAAqB,EAAE,EAAE;QACpD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACjE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAChE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACjE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,GACnD,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;YAEzD,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,aAAa,EAAE,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;gBACpE,4CAA4C;YAC9C,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;gBACxB,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAA6B;gBACtD,CAAC,CAAC,EAAE,CAAC;YAEP,MAAM,UAAU,GAAG,CAAC,EAAU,EAAE,EAAE,CAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAEN,CAAC;YAEZ,mEAAmE;YACnE,iDAAiD;YACjD,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAE9C,MAAM,UAAU,GAAmC;gBACjD,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;gBAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;gBAC5B,MAAM;aACP,CAAC;YACF,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC;YACrC,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC;YAC/B,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtB,UAAU,CAAC,MAAM,GAAG,kBAAkB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC/D,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC;YACtC,CAAC;YAED,MAAM,OAAO,GAAG,GAAG,EAAE,CACnB,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE;gBACxB,UAAU;gBACV,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;aAC/C,CAAC,CAAC;YAEL,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACxF,MAAM,IAAI,GAAG,MAAM,4BAA4B,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;gBACnH,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAC,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,CAAC;YAED,qEAAqE;YACrE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CACX,4CAA4C,GAAG,0BAA0B,CAC1E,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,YAAY,CAAC;gBACjB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,MAAM;gBACb,GAAG,EAAE,OAAO;gBACZ,QAAQ,EAAE,mBAAmB;gBAC7B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;aACnC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,MAAM,4BAA4B,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;YAC9G,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,CACL,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;SAC9C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAkBrB;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CACT,cAAc,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAC7F,CAAC;QACF,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,OAAO,CAAC,GAAG,CAAC,KAAK,sBAAsB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,CAAC,GAAG,CACT,KAAK,uBAAuB,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,OAAO,CAAC,iBAAiB;YAC9B,CAAC,CAAC,wBAAwB,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE;YAC5D,CAAC,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,oBAAoB,CACpG,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ;YAC3C,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB;YACrD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/commands/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `nodetool errors` — inspect, export and sync the redacted error traces in
+ * the local database.
+ *
+ * Reads `nodetool_error_traces` in-process, so it works without a running
+ * server. Every row was redacted before it was stored; `export` prints
+ * Markdown that can go straight into a bug report.
+ */
+import type { Command } from "commander";
+export declare function registerErrorsCommands(program: Command): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/commands/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/commands/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuK7D"}

package/dist/commands/errors.js

@@ -0,0 +1,177 @@
+/**
+ * `nodetool errors` — inspect, export and sync the redacted error traces in
+ * the local database.
+ *
+ * Reads `nodetool_error_traces` in-process, so it works without a running
+ * server. Every row was redacted before it was stored; `export` prints
+ * Markdown that can go straight into a bug report.
+ */
+import { writeFile } from "node:fs/promises";
+import { formatErrorReport, getErrorTrace, listErrorTraces, pruneErrorTraces, summarizeErrorTraces, DEFAULT_ERROR_TRACE_RETENTION_DAYS } from "@nodetool-ai/models";
+import { asJson, printKv, printTable } from "@nodetool-ai/cli-common/commands/output";
+import { setupLocalDb, LOCAL_USER_ID } from "@nodetool-ai/cli-local/local-db";
+function fail(e) {
+    console.error(String(e instanceof Error ? e.message : e));
+    process.exit(1);
+}
+function parseLimit(raw, fallback) {
+    const n = Number(raw ?? fallback);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : fallback;
+}
+function firstLine(text, max = 80) {
+    const line = text.split("\n")[0] ?? "";
+    return line.length > max ? `${line.slice(0, max - 1)}…` : line;
+}
+async function findOrFail(id) {
+    const result = await getErrorTrace(LOCAL_USER_ID, id);
+    if (result.ok)
+        return result.trace;
+    return fail(result.reason === "ambiguous"
+        ? `Trace id ${id} matches more than one trace; use the full id.`
+        : `Error trace ${id} was not found.`);
+}
+export function registerErrorsCommands(program) {
+    const errors = program
+        .command("errors")
+        .description("Inspect, export and sync redacted error traces");
+    errors
+        .command("list")
+        .description("Recent errors, grouped by fingerprint unless --all")
+        .option("--all", "List individual traces instead of groups")
+        .option("--since <iso>", "Only traces at or after this time")
+        .option("--fingerprint <fp>", "Only occurrences of one error group")
+        .option("--limit <n>", "Maximum rows", "20")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const limit = parseLimit(opts.limit, 20);
+            if (!opts.all && !opts.fingerprint) {
+                const groups = await summarizeErrorTraces(LOCAL_USER_ID, {
+                    since: opts.since,
+                    limit
+                });
+                if (opts.json)
+                    return asJson(groups);
+                printTable(groups.map((g) => ({
+                    fingerprint: g.fingerprint,
+                    count: g.count,
+                    source: g.source,
+                    last_seen: g.last_seen,
+                    latest_id: g.latest_id,
+                    error: firstLine(`${g.error_type ?? "Error"}: ${g.message}`)
+                })));
+                return;
+            }
+            const traces = await listErrorTraces(LOCAL_USER_ID, {
+                since: opts.since,
+                fingerprint: opts.fingerprint,
+                limit
+            });
+            if (opts.json)
+                return asJson(traces);
+            printTable(traces.map((t) => ({
+                id: t.id,
+                created_at: t.created_at,
+                source: t.source,
+                error: firstLine(`${t.error_type ?? "Error"}: ${t.message}`)
+            })));
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    errors
+        .command("show <id>")
+        .description("One trace with its stack (full id or 12-character prefix)")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        try {
+            await setupLocalDb();
+            const trace = await findOrFail(id);
+            if (opts.json)
+                return asJson(trace);
+            printKv({
+                id: trace.id,
+                created_at: trace.created_at,
+                source: trace.source,
+                severity: trace.severity,
+                fingerprint: trace.fingerprint,
+                error_type: trace.error_type ?? "",
+                message: trace.message,
+                ...(trace.context ?? {})
+            });
+            if (trace.stack)
+                console.log(`\n${trace.stack}`);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    errors
+        .command("export [ids...]")
+        .description("Markdown bug-report section for traces, a group, or recent errors")
+        .option("--fingerprint <fp>", "Every recent occurrence of one error group")
+        .option("--since <iso>", "Only traces at or after this time")
+        .option("--limit <n>", "Maximum traces", "10")
+        .option("-o, --out <file>", "Write the report to a file")
+        .action(async (ids, opts) => {
+        try {
+            await setupLocalDb();
+            const traces = ids.length > 0
+                ? await Promise.all(ids.map(findOrFail))
+                : await listErrorTraces(LOCAL_USER_ID, {
+                    fingerprint: opts.fingerprint,
+                    since: opts.since,
+                    limit: parseLimit(opts.limit, 10)
+                });
+            const markdown = formatErrorReport(traces);
+            if (opts.out) {
+                await writeFile(opts.out, markdown, "utf8");
+                console.error(`Wrote ${traces.length} trace(s) to ${opts.out}`);
+            }
+            else {
+                console.log(markdown);
+            }
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    errors
+        .command("sync")
+        .description("Push unsynced traces to NODETOOL_ERROR_TRACE_SYNC_URL with NODETOOL_ERROR_TRACE_SYNC_TOKEN")
+        .action(async () => {
+        try {
+            const { errorTraceSyncConfig, syncErrorTraces } = await import("@nodetool-ai/error-trace-services");
+            const config = errorTraceSyncConfig();
+            if (!config) {
+                fail("Error trace sync is off. Set NODETOOL_ERROR_TRACE_SYNC_URL (https) " +
+                    "and NODETOOL_ERROR_TRACE_SYNC_TOKEN to an access token.");
+            }
+            await setupLocalDb();
+            const result = await syncErrorTraces(config);
+            if (result.error)
+                fail(`Pushed ${result.pushed}, then: ${result.error}`);
+            console.log(`Pushed ${result.pushed} trace(s) to ${config.url}`);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    errors
+        .command("prune")
+        .description("Delete traces older than the retention window")
+        .option("--days <n>", "Retention in days", String(DEFAULT_ERROR_TRACE_RETENTION_DAYS))
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const removed = await pruneErrorTraces(parseLimit(opts.days, DEFAULT_ERROR_TRACE_RETENTION_DAYS));
+            console.log(`Removed ${removed} trace(s)`);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/commands/errors.js.map

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

package/dist/commands/generate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `nodetool generate` — generate media from any provider, from the terminal.
+ *
+ *   nodetool generate fal-ai flux-schnell "a red fox in snow" -o fox.png
+ *   nodetool generate openai gpt-image-1 "a logo" --aspect-ratio 1:1
+ *   nodetool generate fal-ai --list-models            # discover model ids
+ *
+ * Built to be agent-friendly: positional `<provider> <model> <prompt>`, lenient
+ * model/provider name matching, `--json` machine output, and a `--list-models`
+ * discovery mode. Today it covers text-to-image (and image-to-image with
+ * `--image`); the surface is shaped to grow to other modalities.
+ *
+ * Heavy deps (runtime providers, DB) load lazily inside the action.
+ */
+import type { Command } from "commander";
+export declare function registerGenerateCommand(program: Command): void;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwIzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C9D"}