@nodetool-ai/websocket 0.8.4-a24.3 → 0.8.5

package/dist/.nodetool-build-stamp

@@ -1 +1 @@
-2026-10-16T18:28:52.249Z
+2026-10-18T06:41:51.217Z

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

@@ -0,0 +1,25 @@
+/**
+ * `run_node` for a host with no chat turn: run one node as an inline graph
+ * through the execution service, the path `run_workflow` and `render_timeline`
+ * already take.
+ *
+ * The chat turn reads the node's own `node_update` result. A service run only
+ * reports what Output nodes collect, and a node with no outgoing edge reports
+ * its values as an unnamed list. So the graph wires one Output node per
+ * declared slot, named after the slot, and the answer maps them back.
+ */
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { type WorkflowRunEnvironment } from "@nodetool-ai/execution/service";
+import type { RunNodeFn } from "./run-node-tool.js";
+/** The node, plus one named Output node per output slot. */
+export declare function singleNodeGraph(nodeType: string, inputs: Record<string, unknown>, slots: readonly string[]): {
+    nodes: Record<string, unknown>[];
+    edges: Record<string, unknown>[];
+};
+/** A `RunNodeFn` over the execution service, for one user. */
+export declare function serviceNodeRunner(options: {
+    userId: string;
+    registry: NodeRegistry | undefined;
+    environment: () => Promise<WorkflowRunEnvironment | null>;
+}): RunNodeFn;
+//# sourceMappingURL=run-node-workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-node-workflow.d.ts","sourceRoot":"","sources":["../../src/agent/run-node-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAOpD,4DAA4D;AAC5D,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAAE,CAqBxE;AAqBD,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,WAAW,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CAC3D,GAAG,SAAS,CAsCZ"}

package/dist/agent/run-node-workflow.js

@@ -0,0 +1,90 @@
+/**
+ * `run_node` for a host with no chat turn: run one node as an inline graph
+ * through the execution service, the path `run_workflow` and `render_timeline`
+ * already take.
+ *
+ * The chat turn reads the node's own `node_update` result. A service run only
+ * reports what Output nodes collect, and a node with no outgoing edge reports
+ * its values as an unnamed list. So the graph wires one Output node per
+ * declared slot, named after the slot, and the answer maps them back.
+ */
+import { runWorkflow } from "@nodetool-ai/execution/service";
+import { isRecord, isString } from "../lib/wire-values.js";
+const NODE_ID = "node_0";
+/** The slot a node reports when the registry has no metadata for it. */
+const FALLBACK_SLOT = "output";
+/** The node, plus one named Output node per output slot. */
+export function singleNodeGraph(nodeType, inputs, slots) {
+    const nodes = [
+        { id: NODE_ID, type: nodeType, data: inputs }
+    ];
+    const edges = [];
+    for (const slot of slots) {
+        const outputId = `output_${slot}`;
+        nodes.push({
+            id: outputId,
+            type: "nodetool.output.Output",
+            data: { name: slot }
+        });
+        edges.push({
+            id: `${NODE_ID}-${slot}`,
+            source: NODE_ID,
+            sourceHandle: slot,
+            target: outputId,
+            targetHandle: "value"
+        });
+    }
+    return { nodes, edges };
+}
+/**
+ * Output values by slot. An Output node collects a list; a one-shot node fills
+ * it with one value, which is answered bare, and a streaming node keeps its list.
+ */
+function outputsBySlot(outputs, slots) {
+    const collected = isRecord(outputs) ? outputs : {};
+    const result = {};
+    for (const slot of slots) {
+        const values = collected[slot];
+        if (values === undefined)
+            continue;
+        result[slot] =
+            Array.isArray(values) && values.length === 1 ? values[0] : values;
+    }
+    return result;
+}
+/** A `RunNodeFn` over the execution service, for one user. */
+export function serviceNodeRunner(options) {
+    return async (nodeType, inputs) => {
+        const environment = await options.environment();
+        if (!environment) {
+            return {
+                error: "Cannot run a node: no node registry is available in this process."
+            };
+        }
+        const metadata = (options.registry ?? environment.registry).resolveMetadata(nodeType);
+        const declared = (metadata?.outputs ?? [])
+            .map((output) => output.name)
+            .filter(isString);
+        const slots = declared.length > 0 ? declared : [FALLBACK_SLOT];
+        const outcome = await runWorkflow({
+            workflowId: "",
+            userId: options.userId,
+            environment,
+            graph: singleNodeGraph(nodeType, inputs, slots),
+            jobName: `Run ${nodeType}`
+        });
+        if (outcome.kind === "error") {
+            return outcome.missingPack ?? { error: outcome.detail };
+        }
+        const { payload } = outcome;
+        if (payload["status"] === "failed") {
+            return (payload["missingPack"] ?? {
+                error: isString(payload["error"])
+                    ? payload["error"]
+                    : `Node '${nodeType}' failed`
+            });
+        }
+        return outputsBySlot(payload["outputs"], slots);
+    };
+}
+//# sourceMappingURL=run-node-workflow.js.map

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

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

package/dist/backend-analytics.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Product analytics emitted by the cloud backend itself (`cloud_backend`).
+ *
+ * Off unless the server runs the cloud profile and the operator sets
+ * `NODETOOL_ANALYTICS_BACKEND=1`; `NODETOOL_TELEMETRY=0` still wins. The
+ * events answer aggregate product questions ("how many cloud workflow runs
+ * fail, and in which category?"), so they carry no anonymous ID, no session
+ * ID, and no account, project, workflow or job identifier. The functions
+ * below take only enum values and a duration, so a caller has no way to pass
+ * one even by mistake.
+ *
+ * Operational metrics (latency, queue depth, worker health, CPU) are not
+ * product analytics and belong to the OpenTelemetry pipeline in
+ * `@nodetool-ai/runtime`, not here.
+ */
+import { type AnalyticsClient, type AnalyticsTransport, type Feature } from "@nodetool-ai/analytics";
+type Env = Readonly<Record<string, string | undefined>>;
+export declare function isBackendAnalyticsEnabled(env?: Env): boolean;
+export declare function createBackendAnalyticsClient(env?: Env, transport?: AnalyticsTransport): AnalyticsClient;
+/** For tests: forget the cached client so the next call re-reads the env. */
+export declare function resetBackendAnalytics(): void;
+export declare function trackExecutionStarted(feature: Feature): void;
+export declare function trackExecutionFinished(feature: Feature, status: "completed" | "failed" | "cancelled", durationMs: number, error?: unknown): void;
+export {};
+//# sourceMappingURL=backend-analytics.d.ts.map

package/dist/backend-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-analytics.d.ts","sourceRoot":"","sources":["../src/backend-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EASL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,OAAO,EACb,MAAM,wBAAwB,CAAC;AAUhC,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAExD,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,GAAiB,GAAG,OAAO,CAOzE;AAgBD,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,GAAiB,EACtB,SAAS,GAAE,kBAA0C,GACpD,eAAe,CAajB;AAWD,6EAA6E;AAC7E,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS5D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,EAC5C,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,OAAO,GACd,IAAI,CAsBN"}

package/dist/backend-analytics.js

@@ -0,0 +1,102 @@
+/**
+ * Product analytics emitted by the cloud backend itself (`cloud_backend`).
+ *
+ * Off unless the server runs the cloud profile and the operator sets
+ * `NODETOOL_ANALYTICS_BACKEND=1`; `NODETOOL_TELEMETRY=0` still wins. The
+ * events answer aggregate product questions ("how many cloud workflow runs
+ * fail, and in which category?"), so they carry no anonymous ID, no session
+ * ID, and no account, project, workflow or job identifier. The functions
+ * below take only enum values and a duration, so a caller has no way to pass
+ * one even by mistake.
+ *
+ * Operational metrics (latency, queue depth, worker health, CPU) are not
+ * product analytics and belong to the OpenTelemetry pipeline in
+ * `@nodetool-ai/runtime`, not here.
+ */
+import { DEFAULT_CONSENT, bucketDuration, categorizeError, createAnalyticsClient, createFetchTransport, createMemoryAnalyticsStore, isAnalyticsDisabledByEnv, platformFromNode } from "@nodetool-ai/analytics";
+import { recordAnalyticsEvents } from "@nodetool-ai/models";
+import { isCloudProfile } from "./lib/cloud-profile.js";
+import { getVersion } from "./routes/health.js";
+import { acceptAnalyticsBatch, analyticsRelayEndpoint, analyticsRouteMode } from "./routes/analytics.js";
+export function isBackendAnalyticsEnabled(env = process.env) {
+    const flag = env["NODETOOL_ANALYTICS_BACKEND"]?.trim().toLowerCase();
+    return ((flag === "1" || flag === "true") &&
+        isCloudProfile(env) &&
+        !isAnalyticsDisabledByEnv(env));
+}
+/** Stores directly when this server is the ingestion service, else relays. */
+function backendTransport(env) {
+    if (analyticsRouteMode(env) === "ingest") {
+        return {
+            async send(batch) {
+                const accepted = acceptAnalyticsBatch(batch, new Date());
+                if (accepted.ok)
+                    await recordAnalyticsEvents(accepted.batch.events);
+                return true;
+            }
+        };
+    }
+    return createFetchTransport({ url: analyticsRelayEndpoint(env), timeoutMs: 5_000 });
+}
+export function createBackendAnalyticsClient(env = process.env, transport = backendTransport(env)) {
+    return createAnalyticsClient({
+        clientType: "cloud_backend",
+        appVersion: getVersion(),
+        platform: platformFromNode(process.platform),
+        // The operator's flag is the consent for system-level events. Nothing is
+        // stored on disk: a restart simply starts an empty queue.
+        store: createMemoryAnalyticsStore({
+            consent: { ...DEFAULT_CONSENT, productAnalytics: "granted" }
+        }),
+        transport,
+        flushDelayMs: 60_000
+    });
+}
+let client;
+function backendClient() {
+    if (client === undefined) {
+        client = isBackendAnalyticsEnabled() ? createBackendAnalyticsClient() : null;
+    }
+    return client;
+}
+/** For tests: forget the cached client so the next call re-reads the env. */
+export function resetBackendAnalytics() {
+    client?.shutdown();
+    client = undefined;
+}
+export function trackExecutionStarted(feature) {
+    try {
+        backendClient()?.track({
+            event: "execution_started",
+            properties: { executionMode: "cloud", feature }
+        });
+    }
+    catch {
+        // Analytics never affects a run.
+    }
+}
+export function trackExecutionFinished(feature, status, durationMs, error) {
+    try {
+        const durationBucket = bucketDuration(durationMs);
+        if (status === "completed") {
+            backendClient()?.track({
+                event: "execution_completed",
+                properties: { executionMode: "cloud", feature, durationBucket }
+            });
+            return;
+        }
+        backendClient()?.track({
+            event: "execution_failed",
+            properties: {
+                executionMode: "cloud",
+                feature,
+                durationBucket,
+                errorCategory: status === "cancelled" ? "cancelled" : categorizeError(error)
+            }
+        });
+    }
+    catch {
+        // Analytics never affects a run.
+    }
+}
+//# sourceMappingURL=backend-analytics.js.map

package/dist/backend-analytics.js.map

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

package/dist/example-workflows.d.ts

@@ -5,6 +5,8 @@ interface ExampleWorkflowLoadOptions {
     metadataRoots?: string[];
     metadataMaxDepth?: number;
 }
+/** Default examples shipped inside the npm package or bundled server. */
+export declare function shippedWorkflowExamplesDir(): string | undefined;
 /**
  * Resolve the directory containing gallery thumbnail JPGs/PNGs for an examples dir.
  * Prefer the sibling `assets/<package>` layout; fall back to bundled assets when

package/dist/example-workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example-workflows.d.ts","sourceRoot":"","sources":["../src/example-workflows.ts"],"names":[],"mappings":"AAKA,UAAU,0BAA0B;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAaD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAChC,MAAM,CAiBR;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAwDf;AAyCD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAahC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,MAAM,GAAG,IAAI,CAKf"}
+{"version":3,"file":"example-workflows.d.ts","sourceRoot":"","sources":["../src/example-workflows.ts"],"names":[],"mappings":"AAMA,UAAU,0BAA0B;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,SAAS,CAO/D;AAaD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAChC,MAAM,CAiBR;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAwDf;AAyCD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAchC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,MAAM,GAAG,IAAI,CAMf"}

package/dist/example-workflows.js

@@ -1,7 +1,17 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import nodePath from "node:path";
+import { fileURLToPath } from "node:url";
 import { loadPythonPackageMetadata } from "@nodetool-ai/node-sdk";
 import { isString } from "./lib/wire-values.js";
+/** Default examples shipped inside the npm package or bundled server. */
+export function shippedWorkflowExamplesDir() {
+    const here = nodePath.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        nodePath.join(here, "examples", "nodetool-base"),
+        nodePath.resolve(here, "../../base-nodes/nodetool/examples/nodetool-base")
+    ];
+    return candidates.find((directory) => existsSync(directory));
+}
 function directoryHasGalleryThumbnails(dir) {
     if (!existsSync(dir)) {
         return false;
@@ -109,8 +119,9 @@ function loadExampleGraphFromPythonPackage(packageName, exampleRef, options) {
 }
 /** Load a full example workflow JSON (including graph) for workflow creation. */
 export function loadExampleGraph(packageName, exampleRef, options = {}) {
-    if (options.examplesDir && existsSync(options.examplesDir)) {
-        const fromDir = loadExampleGraphFromDir(options.examplesDir, exampleRef);
+    const examplesDir = options.examplesDir ?? shippedWorkflowExamplesDir();
+    if (examplesDir && existsSync(examplesDir) && (options.examplesDir || !packageName || packageName === nodePath.basename(examplesDir))) {
+        const fromDir = loadExampleGraphFromDir(examplesDir, exampleRef);
         if (fromDir) {
             return fromDir;
         }
@@ -121,8 +132,9 @@ export function loadExampleGraph(packageName, exampleRef, options = {}) {
     return null;
 }
 export function defaultExamplePackageName(options) {
-    if (options.examplesDir && existsSync(options.examplesDir)) {
-        return nodePath.basename(options.examplesDir);
+    const examplesDir = options.examplesDir ?? shippedWorkflowExamplesDir();
+    if (examplesDir && existsSync(examplesDir)) {
+        return nodePath.basename(examplesDir);
     }
     return null;
 }

package/dist/example-workflows.js.map

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

package/dist/examples/nodetool-base/A Campaign Concept from a Brief.json

@@ -0,0 +1,135 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-07-30T16:00:00.000Z",
+  "updated_at": "2026-07-30T16:00:00.000Z",
+  "name": "A Campaign Concept from a Brief",
+  "tool_name": null,
+  "description": "A brief becomes a concept with a line, a visual idea and three channel executions. Asking for the executions is what forces the concept to be one that survives contact with a media plan.",
+  "tags": [
+    "text",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# A Campaign Concept from a Brief\n\nTurns a campaign brief into a campaign line, a visual concept and three channel executions. Use it to test whether an idea holds up across out of home, social and a 15-second film.\n\n**How it works:** Type the brief into \"1 Input\". The \"2 Agent\" node acts as a creative director and writes the line, the concept paragraph and the three executions. \"3 Output\" shows the result as text.\n\n**Try this:** Pick a model on the Agent and edit its system prompt to swap one channel, for example radio instead of out of home."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "selectable": true,
+          "height": 286
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "in",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "brief",
+          "value": "",
+          "description": "The campaign brief"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 385
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "1  Input"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "ag",
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "system": "You are a creative director. From the brief give: a campaign line, a one-paragraph visual concept, and three channel executions (out of home, social, and a 15-second film).",
+          "prompt": "",
+          "tools": [],
+          "image": [],
+          "audio": [],
+          "history": [],
+          "thread_id": "",
+          "max_tokens": 16384,
+          "max_turns": 100
+        },
+        "ui_properties": {
+          "position": {
+            "x": 400,
+            "y": 366
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "2  Agent"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "concept"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 398
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "3  Output"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "in",
+        "sourceHandle": "output",
+        "target": "ag",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "e2",
+        "source": "ag",
+        "sourceHandle": "text",
+        "target": "out",
+        "targetHandle": "value"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}

package/dist/examples/nodetool-base/A Gradient Card as PNG.json

@@ -0,0 +1,128 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-07-30T12:00:00.000Z",
+  "updated_at": "2026-07-30T12:00:00.000Z",
+  "name": "A Gradient Card as PNG",
+  "tool_name": null,
+  "description": "A certified starter that runs as-is with no asset, provider, or API key. Build vector art in a Code node, rasterise it, and inspect the generated 800×480 PNG.",
+  "tags": [
+    "image",
+    "example",
+    "getting-started"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# A Gradient Card as PNG\n\nDraws a gradient card as vector art and saves it as an 800 by 480 PNG. It runs locally with no asset, provider or API key.\n\n**How it works:** \"1 Elements\" is a Code node that returns SVG elements, with the linear gradient defined before the rectangle that uses it. \"2 Rasterise 2x\" renders the 400 by 240 view box at scale 2. \"3 PNG\" shows the image.\n\n**Try this:** Change the gradient stop colours in the Elements code, or set scale to 3 on \"2 Rasterise 2x\" for a 1200 by 720 PNG."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "selectable": true,
+          "height": 266
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "elements",
+        "type": "nodetool.code.Code",
+        "data": {
+          "code": "// One Code node replaces the retired lib.svg element builders. The gradient\n// is defined first so the rect below can paint with fill=\"url(#card)\".\nreturn {\n  output: [\n    {\n      name: \"linearGradient\",\n      attributes: { id: \"card\", x1: \"0%\", y1: \"0%\", x2: \"100%\", y2: \"100%\" },\n      children: [\n        {\n          name: \"stop\",\n          attributes: { offset: \"0%\", style: \"stop-color:#0ea5e9;stop-opacity:1\" }\n        },\n        {\n          name: \"stop\",\n          attributes: { offset: \"100%\", style: \"stop-color:#7c3aed;stop-opacity:1\" }\n        }\n      ]\n    },\n    {\n      name: \"rect\",\n      attributes: { x: 0, y: 0, width: 400, height: 240, fill: \"url(#card)\" }\n    }\n  ]\n};"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 346
+          },
+          "zIndex": 0,
+          "width": 380,
+          "selectable": true,
+          "title": "1  Elements"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {
+          "output": {
+            "type": "any",
+            "type_args": [],
+            "optional": false
+          }
+        }
+      },
+      {
+        "id": "img",
+        "type": "lib.svg.SVGToImage",
+        "data": {
+          "elements": [],
+          "width": 400,
+          "height": 240,
+          "viewBox": "0 0 400 240",
+          "scale": 2
+        },
+        "ui_properties": {
+          "position": {
+            "x": 480,
+            "y": 430
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "2  Rasterise 2x"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "card"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 860,
+            "y": 444
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "3  PNG"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "elements",
+        "sourceHandle": "output",
+        "target": "img",
+        "targetHandle": "elements"
+      },
+      {
+        "id": "e2",
+        "source": "img",
+        "sourceHandle": "output",
+        "target": "out",
+        "targetHandle": "value"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}