@nodetool-ai/cli-chat 0.0.0-stage → 0.8.9-bootstrap.0

package/dist/commands/tools.js

@@ -0,0 +1,206 @@
+import { readFile } from "node:fs/promises";
+import { asJson } from "@nodetool-ai/cli-common/commands/output";
+import { commandFailureExitCode, printCommandError } from "@nodetool-ai/pack-manager/command-errors";
+import { isRecord } from "@nodetool-ai/cli-common/predicates";
+import { setupLocalDb, LOCAL_USER_ID } from "@nodetool-ai/cli-local/local-db";
+async function localTools() {
+    const { buildCliToolbelt } = await import("../agent-toolbelt.js");
+    const { buildFullRegistry } = await import("@nodetool-ai/cli-execution/node-registry");
+    const registry = await buildFullRegistry();
+    const { toolForCapabilityName } = await import("@nodetool-ai/agents");
+    const byName = new Map(buildCliToolbelt({}, registry).map((tool) => [tool.name, tool]));
+    // Model discovery is provider-backed at invocation, but its schema is static.
+    for (const name of ["find_model", "list_models"]) {
+        if (!byName.has(name)) {
+            byName.set(name, toolForCapabilityName(name));
+        }
+    }
+    const tools = [...byName.values()];
+    return {
+        list: async () => tools,
+        call: async (name, args) => {
+            if (!tools.some((candidate) => candidate.name === name)) {
+                throw new Error(`Unknown tool: ${name}. Use nodetool tools list to discover names.`);
+            }
+            const { getDefaultDbPath } = await import("@nodetool-ai/config");
+            const { migrateSqliteDb, Project } = await import("@nodetool-ai/models");
+            await migrateSqliteDb(getDefaultDbPath());
+            await setupLocalDb();
+            await Project.ensurePersonal(LOCAL_USER_ID);
+            const { buildConfiguredProviders } = await import("@nodetool-ai/cli-providers");
+            const providers = await buildConfiguredProviders();
+            const tool = buildCliToolbelt(providers, registry).find((candidate) => candidate.name === name);
+            if (!tool) {
+                throw new Error(`No configured providers are available for ${name}. Configure a provider before calling this tool.`);
+            }
+            const { createChatContext } = await import("../chat-context.js");
+            const context = await createChatContext({
+                workspaceDir: process.cwd(),
+                userId: LOCAL_USER_ID
+            });
+            for (const [id, provider] of Object.entries(providers)) {
+                context.registerProvider(id, provider);
+            }
+            const { RUN_BUDGET_CONTEXT_KEY } = await import("@nodetool-ai/runtime");
+            const { PERMISSION_GATE_CONTEXT_KEY, headlessGate } = await import("@nodetool-ai/agents");
+            const { createCliRunBudget } = await import("@nodetool-ai/cli-execution/run-budget");
+            context.set(RUN_BUDGET_CONTEXT_KEY, await createCliRunBudget());
+            context.set(PERMISSION_GATE_CONTEXT_KEY, headlessGate("CLI tool call"));
+            const { attachRunCostLedger } = await import("@nodetool-ai/execution");
+            const ledger = attachRunCostLedger(context, {
+                userId: LOCAL_USER_ID,
+                workflowId: null
+            });
+            const controller = new AbortController();
+            const cancel = () => controller.abort(new Error("Tool call interrupted"));
+            context.signal = controller.signal;
+            process.once("SIGINT", cancel);
+            process.once("SIGTERM", cancel);
+            try {
+                return await tool.execute(context, args);
+            }
+            finally {
+                await ledger.settled();
+                ledger();
+                process.removeListener("SIGINT", cancel);
+                process.removeListener("SIGTERM", cancel);
+            }
+        }
+    };
+}
+export async function parseToolArguments(raw) {
+    const value = JSON.parse(raw.startsWith("@") ? await readFile(raw.slice(1), "utf8") : raw);
+    if (!isRecord(value)) {
+        throw new Error("--args must be a JSON object or @path to a JSON object file.");
+    }
+    return value;
+}
+/** Inspect only result envelopes whose tool contracts define failure statuses. */
+function toolCallFailed(name, result) {
+    if (!isRecord(result)) {
+        return false;
+    }
+    if (commandFailureExitCode(result) === 3 ||
+        result.error ||
+        result.isError === true ||
+        result.success === false ||
+        result.ok === false) {
+        return true;
+    }
+    switch (name) {
+        case "get_node_info":
+        case "search_nodes":
+            return result.status === "error";
+        case "run_node":
+        case "run_workflow":
+        case "resolve_workflow_escalation":
+            return result.status === "failed" || result.status === "error";
+        case "debug_app":
+            return (result.status === "failed" ||
+                (isRecord(result.verdict) && result.verdict.ok === false));
+        case "debug_workflow":
+            return (isRecord(result.run) &&
+                (result.run.status === "failed" ||
+                    result.run.status === "error" ||
+                    Boolean(result.run.error) ||
+                    (isRecord(result.run.verdict) && result.run.verdict.ok === false)));
+        default:
+            return false;
+    }
+}
+export const AUTHORING_HELP = `
+Authoring tools and starting documents:
+  nodetool tools list timeline
+  nodetool tools info create_timeline
+  nodetool skills list
+  nodetool skills read storyboard-core
+  nodetool skills read motion-graphics
+  nodetool skills read nodetool-workflow-builder
+  nodetool skills read nodetool-app-builder
+  nodetool skills read native-game
+  nodetool tools call list_projects
+  nodetool tools call create_timeline --args '{"name":"My timeline"}'
+  nodetool tools call <name> --args @arguments.json
+
+Tools expose their current input schemas. Read the matching shipped guide
+before creating workflows, timelines, motion graphics, mini apps, or games.
+`;
+export function registerAuthoringCommands(program, load = localTools) {
+    const run = async (name, args) => {
+        try {
+            const result = await (await load()).call(name, args);
+            asJson(result);
+            if (toolCallFailed(name, result)) {
+                const failure = name === "debug_workflow" && isRecord(result) && isRecord(result.run)
+                    ? result.run
+                    : result;
+                process.exitCode = commandFailureExitCode(failure);
+            }
+        }
+        catch (error) {
+            process.exitCode = printCommandError(error, true);
+        }
+    };
+    const tools = program
+        .command("tools")
+        .description("Discover tool schemas and call local authoring tools")
+        .addHelpText("after", AUTHORING_HELP);
+    tools
+        .command("list [query]")
+        .description("List tool names and descriptions, optionally filtered")
+        .action(async (query) => {
+        const matches = (await (await load()).list()).filter((tool) => !query ||
+            `${tool.name} ${tool.description}`
+                .toLowerCase()
+                .includes(query.toLowerCase()));
+        asJson(matches.map((tool) => ({
+            name: tool.name,
+            description: tool.description
+        })));
+    });
+    tools
+        .command("info <name>")
+        .description("Print the authoritative input schema for a tool")
+        .action(async (name) => {
+        const tool = (await (await load()).list()).find((candidate) => candidate.name === name);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${name}. Use nodetool tools list.`);
+        }
+        asJson({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema
+        });
+    });
+    tools
+        .command("call <name>")
+        .description("Execute a local tool. Calls can save documents, run jobs, or use configured providers.")
+        .option("--args <json|@file>", "JSON arguments, inline or read from a file", "{}")
+        .action(async (name, options) => run(name, await parseToolArguments(options.args)));
+    const skills = program
+        .command("skills")
+        .description("Find and read installed authoring guides and user skills");
+    skills
+        .command("list [query]")
+        .description("Search the installed skill catalog")
+        .action(async (query) => run("list_skills", query ? { query } : {}));
+    skills
+        .command("read <name>")
+        .description("Read a guide, including its starting examples and tool instructions")
+        .action(async (name) => run("load_skill", { name }));
+    program.addHelpText("after", AUTHORING_HELP);
+    for (const name of [
+        "timeline",
+        "game",
+        "app",
+        "apps",
+        "workflows",
+        "jsscript",
+        "sketch"
+    ]) {
+        program.commands
+            .find((command) => command.name() === name)
+            ?.addHelpText("after", AUTHORING_HELP);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

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

package/dist/diagnose.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Pure failure-diagnosis aggregator for `nodetool agent diagnose <job_id>`.
+ *
+ * When a run fails the cause is scattered across the job record, the structured
+ * processing-message stream, and the OpenTelemetry trace. `diagnoseRun` folds
+ * those three sources into one `DiagnosisReport` that names the failing
+ * node/step, the error, the last `llm.chat`/`llm.stream` span at or before the
+ * failure (with tokens, model, and a truncated response), a memory snapshot, and
+ * a deterministic "likely fix locus" pointing at where to start.
+ *
+ * The function is pure and deterministic — it only reads its inputs and never
+ * touches the filesystem, env, or clock. The CLI wiring in
+ * `commands/agent.ts` gathers the real inputs and calls it. Keep all I/O out of
+ * this module so it stays unit-testable under the CLI vitest stub setup, which
+ * stubs every `@nodetool-ai/*` runtime package — only `import type` is used.
+ */
+import type { ProcessingMessage } from "@nodetool-ai/protocol";
+/** A failed run/job record, as returned by `jobs.get` (subset we read). */
+export interface DiagnoseJob {
+    id: string;
+    status?: string;
+    error?: string | null;
+    workflowId?: string | null;
+}
+/**
+ * One OpenTelemetry span, loosely typed. Structurally compatible with the debug
+ * harness `TraceSpan`, but only the fields the diagnoser reads are required so
+ * callers can pass either parsed JSONL lines or richer span objects.
+ */
+/** An OpenTelemetry attribute value, as the trace JSONL carries it. */
+export type SpanAttributeValue = string | number | boolean | null | Array<string | number | boolean | null>;
+export interface TraceSpanLite {
+    name: string;
+    span_id?: string;
+    parent_span_id?: string | null;
+    start_time_ms?: number;
+    end_time_ms?: number;
+    attributes?: Record<string, SpanAttributeValue>;
+    status?: {
+        code?: string;
+        message?: string;
+    };
+}
+/**
+ * Everything `diagnoseRun` needs. Every field is optional so the diagnoser
+ * degrades gracefully when a source is unavailable (it reports what was
+ * missing rather than crashing).
+ */
+export interface DiagnoseInputs {
+    job?: DiagnoseJob;
+    /** Processing messages from the run (e.g. a bundle's messages.jsonl). */
+    messages?: ReadonlyArray<ProcessingMessage | Record<string, unknown>>;
+    /** Trace spans (e.g. a parsed trace.jsonl). */
+    spans?: ReadonlyArray<TraceSpanLite>;
+    /** A memory/state snapshot captured at failure. */
+    memory?: Record<string, unknown>;
+}
+/** The node or step the run failed on. */
+interface FailureSite {
+    /** Where the failure was identified. */
+    kind: "node" | "step" | "job" | "unknown";
+    /** Node id, when a failing node was found. */
+    nodeId: string | null;
+    /** Node type, when known (e.g. "nodetool.text.Concatenate"). */
+    nodeType: string | null;
+    /** Node display name, when known. */
+    nodeName: string | null;
+    /** Step id, when the failure came from an agent step. */
+    stepId: string | null;
+    /** Step instructions/title, when known. */
+    stepLabel: string | null;
+}
+/** Summary of the last LLM call before the failure. */
+interface LastLlmSummary {
+    /** Span name — "llm.chat" or "llm.stream". */
+    name: string;
+    provider: string | null;
+    model: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    totalTokens: number | null;
+    costUsd: number | null;
+    /** Truncated `llm.response.content` from the span attributes. */
+    responsePreview: string | null;
+    durationMs: number | null;
+    /** Span status code, when present (e.g. "ERROR"). */
+    statusCode: string | null;
+}
+/** Compact view of the memory/state snapshot at failure. */
+interface MemorySnapshot {
+    /** Number of top-level keys. */
+    keyCount: number;
+    /** Top-level keys (capped). */
+    keys: string[];
+    /** Per-key one-line value previews (capped, truncated). */
+    preview: Record<string, string>;
+}
+/** A heuristic pointer at where to start fixing. */
+interface FixLocus {
+    /** One-line, human-readable starting point. */
+    summary: string;
+    /** Failing node type, when derivable. */
+    nodeType: string | null;
+    /** Model implicated by the last LLM call, when derivable. */
+    model: string | null;
+    /** Concrete hints (prompt/model/file references) extracted from the error. */
+    hints: string[];
+}
+export interface DiagnosisReport {
+    /** True when no failure could be identified from any source. */
+    ok: boolean;
+    jobId: string | null;
+    jobStatus: string | null;
+    /** The node/step the run failed on. */
+    failure: FailureSite;
+    /** The failure message, normalized to a single string. */
+    error: string | null;
+    /** The last llm.chat/llm.stream span at or before the failure. */
+    lastLlm: LastLlmSummary | null;
+    /** Memory/state snapshot summary, when a snapshot was supplied. */
+    memory: MemorySnapshot | null;
+    /** Where to start fixing. Null only when there's no failure. */
+    fixLocus: FixLocus | null;
+    /** Sources that were absent — surfaced so callers see partial coverage. */
+    missing: string[];
+}
+/**
+ * Aggregate a failed run's job record, message stream, and trace spans into a
+ * single `DiagnosisReport`. Deterministic and side-effect-free.
+ */
+export declare function diagnoseRun(inputs: DiagnoseInputs): DiagnosisReport;
+/**
+ * Render a `DiagnosisReport` as a plain-text block for the terminal. Kept here
+ * (not in the CLI command) so the formatting is unit-testable and dependency-
+ * free; the command adds color separately if desired.
+ */
+export declare function renderDiagnosis(report: DiagnosisReport): string;
+export {};
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/diagnose.d.ts.map

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