@nodetool-ai/cli 0.7.0-rc.22 → 0.8.1

package/dist/node/run-node.d.ts

@@ -0,0 +1,28 @@
+interface NodeRunResult {
+    nodeType: string;
+    title: string | null;
+    ok: boolean;
+    error: string | null;
+    durationMs: number;
+    /** Every record emitted by the node (one entry for a one-shot process()). */
+    chunks: Array<Record<string, unknown>>;
+    /** Declared output handles, for reference. */
+    outputs: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+interface RunSingleNodeOptions {
+    /** Property values keyed by @prop name. */
+    props?: Record<string, unknown>;
+    /**
+     * Resolves secrets (API keys) for nodes that need them. Injected by the
+     * caller so this module stays free of a hard `@nodetool-ai/models` import
+     * (which would pull in the SQLite native binding for hermetic runs). When
+     * omitted, every secret resolves to null.
+     */
+    secretResolver?: (key: string) => Promise<string | null>;
+}
+export declare function runSingleNode(nodeType: string, options?: RunSingleNodeOptions): Promise<NodeRunResult>;
+export {};
+//# sourceMappingURL=run-node.d.ts.map

package/dist/node/run-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-node.d.ts","sourceRoot":"","sources":["../../src/node/run-node.ts"],"names":[],"mappings":"AAaA,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,8CAA8C;IAC9C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,oBAAoB;IAC5B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1D;AAUD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA8DxB"}

package/dist/node/run-node.js

@@ -0,0 +1,76 @@
+/**
+ * Runs a single node in isolation — instantiate it from the registry, feed it a
+ * property bag, and capture what its `process()` / `genProcess()` emits. Lets an
+ * agent exercise one node's logic without authoring a whole workflow.
+ *
+ * Integration code (pulls in every node pack + a runtime context), so it's
+ * exercised end-to-end rather than unit-tested.
+ */
+import { getDefaultAssetsPath } from "@nodetool-ai/config";
+import { PERMISSION_GATE_CONTEXT_KEY, ProcessingContext, headlessGate } from "@nodetool-ai/runtime";
+import { FileStorageAdapter } from "@nodetool-ai/storage";
+import { buildFullRegistry } from "../node-registry.js";
+function typeMetaToString(tm) {
+    if (!tm)
+        return "";
+    const args = (tm.type_args ?? [])
+        .map(typeMetaToString)
+        .filter(Boolean);
+    return args.length > 0 ? `${tm.type}[${args.join(", ")}]` : tm.type;
+}
+export async function runSingleNode(nodeType, options = {}) {
+    const registry = buildFullRegistry();
+    if (!registry.has(nodeType)) {
+        throw new Error(`Unknown node type "${nodeType}". It is not in the local TS registry (Python-only nodes can't be run this way).`);
+    }
+    const cls = registry.getClass(nodeType);
+    const meta = registry.getMetadata(nodeType);
+    const title = meta?.title ?? null;
+    const outputs = (meta?.outputs ?? []).map((o) => ({
+        name: o.name,
+        type: typeMetaToString(o.type)
+    }));
+    if (cls.isStreamingInput) {
+        throw new Error(`Node "${nodeType}" is a streaming-input node — it consumes a live input stream and must run inside a graph. Use \`nodetool debug\` instead.`);
+    }
+    const props = options.props ?? {};
+    const executor = registry.resolve({ id: "single-run", type: nodeType, properties: props });
+    const context = new ProcessingContext({
+        jobId: `node-run-${Date.now()}`,
+        workflowId: null,
+        userId: "1",
+        secretResolver: options.secretResolver ?? (() => Promise.resolve(null)),
+        storage: new FileStorageAdapter(getDefaultAssetsPath())
+    });
+    context.set(PERMISSION_GATE_CONTEXT_KEY, headlessGate("node run"));
+    const startedAt = Date.now();
+    const chunks = [];
+    try {
+        // Drain genProcess: this covers both one-shot nodes (the default genProcess
+        // yields process() once) and streaming-output nodes that override it.
+        for await (const chunk of executor.genProcess(props, context)) {
+            chunks.push(chunk);
+        }
+        return {
+            nodeType,
+            title,
+            ok: true,
+            error: null,
+            durationMs: Date.now() - startedAt,
+            chunks,
+            outputs
+        };
+    }
+    catch (err) {
+        return {
+            nodeType,
+            title,
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+            durationMs: Date.now() - startedAt,
+            chunks,
+            outputs
+        };
+    }
+}
+//# sourceMappingURL=run-node.js.map

package/dist/node/run-node.js.map

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

package/dist/node-registry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Builds a NodeRegistry populated with every TypeScript node pack the CLI
+ * ships. Shared by the debug, validate, and single-node-run harnesses so they
+ * all resolve node types against the same set.
+ *
+ * Python-only node packs (huggingface worker nodes, mlx, etc.) are not
+ * registered here — they have no TS class and are resolved lazily through the
+ * Python bridge at execution time. Static tools (validate) therefore treat
+ * unknown types as "not in the local TS registry".
+ */
+import { NodeRegistry } from "@nodetool-ai/node-sdk";
+export declare function buildFullRegistry(): NodeRegistry;
+//# sourceMappingURL=node-registry.d.ts.map

package/dist/node-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-registry.d.ts","sourceRoot":"","sources":["../src/node-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAYrD,wBAAgB,iBAAiB,IAAI,YAAY,CAahD"}

package/dist/node-registry.js

@@ -0,0 +1,36 @@
+/**
+ * Builds a NodeRegistry populated with every TypeScript node pack the CLI
+ * ships. Shared by the debug, validate, and single-node-run harnesses so they
+ * all resolve node types against the same set.
+ *
+ * Python-only node packs (huggingface worker nodes, mlx, etc.) are not
+ * registered here — they have no TS class and are resolved lazily through the
+ * Python bridge at execution time. Static tools (validate) therefore treat
+ * unknown types as "not in the local TS registry".
+ */
+import { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { registerBaseNodes } from "@nodetool-ai/base-nodes";
+import { registerAtlasCloudNodes } from "@nodetool-ai/atlascloud-nodes";
+import { registerElevenLabsNodes } from "@nodetool-ai/elevenlabs-nodes";
+import { registerMinimaxNodes } from "@nodetool-ai/minimax-nodes";
+import { registerTransformersJsNodes } from "@nodetool-ai/transformers-js-nodes";
+import { registerFalNodes } from "@nodetool-ai/fal-nodes";
+import { registerReplicateNodes } from "@nodetool-ai/replicate-nodes";
+import { registerReveNodes } from "@nodetool-ai/reve-nodes";
+import { registerHuggingFaceNodes } from "@nodetool-ai/huggingface-nodes";
+import { installSandboxCatalog } from "./sandbox-catalog.js";
+export function buildFullRegistry() {
+    installSandboxCatalog();
+    const registry = new NodeRegistry();
+    registerBaseNodes(registry);
+    registerAtlasCloudNodes(registry);
+    registerElevenLabsNodes(registry);
+    registerMinimaxNodes(registry);
+    registerTransformersJsNodes(registry);
+    registerFalNodes(registry);
+    registerReplicateNodes(registry);
+    registerReveNodes(registry);
+    registerHuggingFaceNodes(registry);
+    return registry;
+}
+//# sourceMappingURL=node-registry.js.map

package/dist/node-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-registry.js","sourceRoot":"","sources":["../src/node-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,UAAU,iBAAiB;IAC/B,qBAAqB,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACtC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACjC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC"}