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

package/dist/commands/collections.js

@@ -0,0 +1,257 @@
+/**
+ * `nodetool collections` — manage RAG vector-store collections.
+ *
+ * Runs in-process against the default vector provider (sqlite-vec unless
+ * NODETOOL_VECTOR_PROVIDER points elsewhere), so it works without a running
+ * server. Indexing chunks documents with the same splitter the server uses.
+ */
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { getDefaultVectorProvider, splitDocument, CollectionNotFoundError } from "@nodetool-ai/vectorstore";
+import { Workflow } from "@nodetool-ai/models";
+import { asJson, printTable, printKv, confirm } from "@nodetool-ai/cli-common/commands/output";
+import { setupLocalDb } from "@nodetool-ai/cli-local/local-db";
+import { isNonEmptyString } from "@nodetool-ai/cli-common/predicates";
+function fail(e) {
+    if (e instanceof CollectionNotFoundError) {
+        console.error(e.message);
+        process.exit(1);
+    }
+    console.error(String(e instanceof Error ? e.message : e));
+    process.exit(1);
+}
+/** Resolve a workflow's name from an id, forgivingly (null on any failure). */
+async function workflowName(id) {
+    if (!isNonEmptyString(id)) {
+        return null;
+    }
+    try {
+        const wf = (await Workflow.get(id));
+        return wf?.name ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function registerCollectionCommands(program) {
+    const collections = program
+        .command("collections")
+        .description("Manage RAG vector-store collections");
+    collections
+        .command("list")
+        .description("List collections with document counts")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const provider = getDefaultVectorProvider();
+            const infos = await provider.listCollections();
+            const rows = [];
+            for (const info of infos) {
+                try {
+                    const collection = await provider.getCollection({ name: info.name });
+                    const count = await collection.count();
+                    const metadata = info.metadata ?? {};
+                    rows.push({
+                        name: info.name,
+                        count,
+                        embedding_model: metadata["embedding_model"] ?? "",
+                        workflow: (await workflowName(metadata["workflow"])) ?? ""
+                    });
+                }
+                catch (err) {
+                    // A collection can race a delete between listCollections() and
+                    // getCollection(); skip only that. Surface anything else (corrupt
+                    // collection, provider failure) instead of hiding it.
+                    if (!(err instanceof CollectionNotFoundError)) {
+                        throw err;
+                    }
+                }
+            }
+            if (opts.json) {
+                asJson(rows);
+                return;
+            }
+            printTable(rows);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    collections
+        .command("get <name>")
+        .description("Show a collection's metadata and document count")
+        .option("--json", "Output as JSON")
+        .action(async (name, opts) => {
+        try {
+            await setupLocalDb();
+            const collection = await getDefaultVectorProvider().getCollection({
+                name
+            });
+            const count = await collection.count();
+            const metadata = collection.metadata ?? {};
+            if (opts.json) {
+                asJson({ name: collection.name, count, metadata });
+                return;
+            }
+            printKv({ name: collection.name, count, ...metadata });
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    collections
+        .command("create <name>")
+        .description("Create a collection")
+        .option("--embedding-model <model>", "Embedding model id")
+        .option("--embedding-provider <provider>", "Embedding provider id")
+        .option("--json", "Output as JSON")
+        .action(async (name, opts) => {
+        try {
+            await setupLocalDb();
+            const metadata = {};
+            if (opts.embeddingModel) {
+                metadata["embedding_model"] = opts.embeddingModel;
+            }
+            if (opts.embeddingProvider) {
+                metadata["embedding_provider"] = opts.embeddingProvider;
+            }
+            const collection = await getDefaultVectorProvider().createCollection({
+                name,
+                metadata
+            });
+            if (opts.json) {
+                asJson({ name: collection.name, metadata: collection.metadata });
+                return;
+            }
+            console.log(`Created collection '${collection.name}'.`);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    collections
+        .command("delete <name>")
+        .description("Delete a collection and all its documents")
+        .option("-y, --yes", "Skip the confirmation prompt")
+        .option("--json", "Output as JSON")
+        .action(async (name, opts) => {
+        try {
+            const ok = await confirm(`Delete collection '${name}' and all its documents?`, { force: opts.yes });
+            if (!ok) {
+                if (opts.json) {
+                    asJson({ deleted: false, aborted: true });
+                }
+                else {
+                    console.error("Aborted.");
+                }
+                process.exit(1);
+            }
+            await setupLocalDb();
+            await getDefaultVectorProvider().deleteCollection(name);
+            const message = `Collection ${name} deleted successfully`;
+            if (opts.json) {
+                asJson({ message });
+                return;
+            }
+            console.log(message);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    collections
+        .command("query <name> <text...>")
+        .description("Semantic search over a collection")
+        .option("-n, --n-results <n>", "Number of results", "10")
+        .option("--json", "Output as JSON")
+        .action(async (name, text, opts) => {
+        const nResults = Number.parseInt(opts.nResults, 10);
+        if (!Number.isFinite(nResults) || nResults <= 0) {
+            console.error(`Invalid --n-results value: ${opts.nResults}`);
+            process.exit(1);
+        }
+        try {
+            await setupLocalDb();
+            const collection = await getDefaultVectorProvider().getCollection({
+                name
+            });
+            const matches = await collection.query({
+                text: text.join(" "),
+                topK: nResults
+            });
+            if (opts.json) {
+                asJson(matches);
+                return;
+            }
+            if (matches.length === 0) {
+                console.log("(no matches)");
+                return;
+            }
+            printTable(matches.map((m) => ({
+                id: m.id,
+                distance: m.distance?.toFixed(4) ?? "",
+                document: (m.document ?? "").replace(/\s+/g, " ").slice(0, 80)
+            })));
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    collections
+        .command("index <name> <file...>")
+        .description("Chunk and index one or more text documents into a collection")
+        .option("--json", "Output as JSON")
+        .action(async (name, files, opts) => {
+        try {
+            await setupLocalDb();
+            const collection = await getDefaultVectorProvider().getCollection({
+                name
+            });
+            const results = [];
+            for (const file of files) {
+                try {
+                    const text = await readFile(file, "utf8");
+                    const fileName = basename(file);
+                    const chunks = splitDocument(text, fileName);
+                    if (chunks.length > 0) {
+                        // Derive the record-id prefix from the full path (sanitized) so
+                        // two files with the same basename (a/foo.txt, b/foo.txt) don't
+                        // collide and overwrite each other's chunks. Re-indexing the same
+                        // path stays idempotent.
+                        const idPrefix = file.replace(/[^A-Za-z0-9._-]+/g, "_");
+                        await collection.upsert(chunks.map((c, i) => ({
+                            id: `${idPrefix}#${i}`,
+                            document: c.text,
+                            metadata: {
+                                source: file,
+                                start_index: String(c.start_index)
+                            }
+                        })));
+                    }
+                    results.push({ file, chunks: chunks.length, error: "" });
+                }
+                catch (e) {
+                    results.push({
+                        file,
+                        chunks: 0,
+                        error: String(e instanceof Error ? e.message : e)
+                    });
+                }
+            }
+            if (opts.json) {
+                asJson(results);
+            }
+            else {
+                printTable(results);
+            }
+            if (results.some((r) => r.error)) {
+                process.exit(1);
+            }
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+}
+//# sourceMappingURL=collections.js.map

package/dist/commands/collections.js.map

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

package/dist/commands/costs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `nodetool costs` — inspect provider spend tracked in the local DB.
+ *
+ * Reads the local SQLite `predictions` table directly (in-process), so it works
+ * without a running server. Every provider call NodeTool makes is recorded as a
+ * Prediction — LLM calls with token counts, image/video/audio generation with
+ * the billing unit, quantity and unit price behind the charge.
+ *
+ * A call whose model is in no price catalog is still recorded, with a null
+ * cost. It shows up in `list` and is counted as `unpriced` in the aggregates,
+ * so an unknown price reads as unknown rather than as free.
+ */
+import type { Command } from "commander";
+export declare function registerCostsCommands(program: Command): void;
+//# sourceMappingURL=costs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../../src/commands/costs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8L5D"}

package/dist/commands/costs.js

@@ -0,0 +1,201 @@
+/**
+ * `nodetool costs` — inspect provider spend tracked in the local DB.
+ *
+ * Reads the local SQLite `predictions` table directly (in-process), so it works
+ * without a running server. Every provider call NodeTool makes is recorded as a
+ * Prediction — LLM calls with token counts, image/video/audio generation with
+ * the billing unit, quantity and unit price behind the charge.
+ *
+ * A call whose model is in no price catalog is still recorded, with a null
+ * cost. It shows up in `list` and is counted as `unpriced` in the aggregates,
+ * so an unknown price reads as unknown rather than as free.
+ */
+import { Prediction } from "@nodetool-ai/models";
+import { asJson, printTable, printKv } 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 usd(n) {
+    return `$${(n ?? 0).toFixed(4)}`;
+}
+/** A cost cell that tells an unpriced call apart from a genuinely free one. */
+function costCell(cost) {
+    return cost == null ? "unpriced" : usd(cost);
+}
+/** The units behind a unit-billed charge, e.g. "5 × seconds @ $0.2050". */
+function unitsCell(call) {
+    if (call.billing_unit == null && call.unit_price == null)
+        return "";
+    const quantity = call.quantity ?? 1;
+    const unit = call.billing_unit ?? "run";
+    const price = call.unit_price == null ? "" : ` @ ${usd(call.unit_price)}`;
+    return `${quantity} × ${unit}${price}`;
+}
+export function registerCostsCommands(program) {
+    const costs = program
+        .command("costs")
+        .description("Inspect tracked LLM/provider spend");
+    costs
+        .command("summary")
+        .description("Overall spend plus per-provider and per-model breakdowns")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const [byProvider, byModel] = await Promise.all([
+                Prediction.aggregateByProvider(LOCAL_USER_ID),
+                Prediction.aggregateByModel(LOCAL_USER_ID)
+            ]);
+            // Derive the overall totals by summing the provider aggregates rather
+            // than issuing a third full-table scan (aggregateByUser).
+            const overall = byProvider.reduce((acc, p) => ({
+                total_cost: acc.total_cost + p.total_cost,
+                total_input_tokens: acc.total_input_tokens + p.total_input_tokens,
+                total_output_tokens: acc.total_output_tokens + p.total_output_tokens,
+                total_tokens: acc.total_tokens + p.total_tokens,
+                call_count: acc.call_count + p.call_count,
+                unpriced_count: acc.unpriced_count + p.unpriced_count
+            }), {
+                total_cost: 0,
+                total_input_tokens: 0,
+                total_output_tokens: 0,
+                total_tokens: 0,
+                call_count: 0,
+                unpriced_count: 0
+            });
+            if (opts.json) {
+                asJson({ overall, by_provider: byProvider, by_model: byModel });
+                return;
+            }
+            console.log("\nOverall");
+            printKv({
+                total_cost: usd(overall.total_cost),
+                total_tokens: overall.total_tokens,
+                calls: overall.call_count,
+                unpriced_calls: overall.unpriced_count
+            });
+            if (overall.unpriced_count > 0) {
+                console.log(`\n${overall.unpriced_count} call(s) ran on a model no price ` +
+                    `catalog covers, so the total above is a lower bound. ` +
+                    `Run \`nodetool costs list\` to see them.`);
+            }
+            console.log("\nBy provider");
+            printTable(byProvider.map((p) => ({
+                provider: p.provider,
+                cost: usd(p.total_cost),
+                tokens: p.total_tokens,
+                calls: p.call_count,
+                unpriced: p.unpriced_count
+            })));
+            console.log("\nBy model");
+            printTable(byModel.map((m) => ({
+                provider: m.provider,
+                model: m.model,
+                cost: usd(m.total_cost),
+                tokens: m.total_tokens,
+                calls: m.call_count,
+                unpriced: m.unpriced_count
+            })));
+            console.log();
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    costs
+        .command("list")
+        .description("List recent provider calls with cost, tokens and billed units")
+        .option("--provider <name>", "Filter by provider")
+        .option("--model <id>", "Filter by model")
+        .option("--limit <n>", "Max results", "50")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const limit = Number.parseInt(opts.limit, 10);
+        if (!Number.isFinite(limit) || limit <= 0) {
+            console.error(`Invalid --limit value: ${opts.limit}`);
+            process.exit(1);
+        }
+        try {
+            await setupLocalDb();
+            const page = { limit };
+            if (opts.provider) {
+                page.provider = opts.provider;
+            }
+            if (opts.model) {
+                page.model = opts.model;
+            }
+            const [calls] = await Prediction.paginate(LOCAL_USER_ID, page);
+            if (opts.json) {
+                asJson(calls);
+                return;
+            }
+            printTable(calls.map((c) => ({
+                created_at: c.created_at ?? "",
+                provider: c.provider,
+                model: c.model,
+                cost: costCell(c.cost),
+                in: c.input_tokens ?? "",
+                out: c.output_tokens ?? "",
+                units: unitsCell(c)
+            })));
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    costs
+        .command("by-provider")
+        .description("Aggregate spend grouped by provider")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const data = await Prediction.aggregateByProvider(LOCAL_USER_ID);
+            if (opts.json) {
+                asJson(data);
+                return;
+            }
+            printTable(data.map((p) => ({
+                provider: p.provider,
+                cost: usd(p.total_cost),
+                input_tokens: p.total_input_tokens,
+                output_tokens: p.total_output_tokens,
+                calls: p.call_count,
+                unpriced: p.unpriced_count
+            })));
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    costs
+        .command("by-model")
+        .description("Aggregate spend grouped by model")
+        .option("--provider <name>", "Filter by provider")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const data = await Prediction.aggregateByModel(LOCAL_USER_ID, opts.provider ? { provider: opts.provider } : {});
+            if (opts.json) {
+                asJson(data);
+                return;
+            }
+            printTable(data.map((m) => ({
+                provider: m.provider,
+                model: m.model,
+                cost: usd(m.total_cost),
+                input_tokens: m.total_input_tokens,
+                output_tokens: m.total_output_tokens,
+                calls: m.call_count,
+                unpriced: m.unpriced_count
+            })));
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+}
+//# sourceMappingURL=costs.js.map

package/dist/commands/costs.js.map

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

package/dist/commands/debug.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `nodetool debug` — the workflow debug harness command.
+ *
+ * Runs a workflow end-to-end on the headless server and (optionally) in a real
+ * browser, then writes a debug bundle (workflow JSON, every message/log/output/
+ * error, an OpenTelemetry trace summary, plus browser console errors and a
+ * screenshot) and prints an agent-friendly summary. Heavy dependencies are
+ * imported lazily inside the action so command registration stays light and
+ * unit-testable.
+ */
+import type { Command } from "commander";
+export declare function registerDebugCommands(program: Command): void;
+//# sourceMappingURL=debug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmI5D"}