@loomcycle/n8n-nodes-loomcycle 1.0.0

package/dist/nodes/LoomCycleRunCompleted/LoomCycleRunCompleted.node.js.map

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

package/dist/nodes/LoomCycleRunCompleted/LoomCycleRunCompleted.node.json

@@ -0,0 +1,13 @@
+{
+	"node": "@loomcycle/n8n-nodes-loomcycle.loomCycleRunCompleted",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["AI"],
+	"resources": {
+		"primaryDocumentation": [
+			{
+				"url": "https://github.com/denn-gubsky/n8n-nodes-loomcycle#trigger-nodes"
+			}
+		]
+	}
+}

package/dist/nodes/LoomCycleRunCompleted/LoomCycleRunCompleted.svg

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
+  <title>LoomCycle: Run Completed</title>
+  <circle cx="30" cy="30" r="28" fill="#0f172a"/>
+  <g fill="none" stroke="#22d3ee" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+    <circle cx="30" cy="30" r="16"/>
+    <path d="M22 30 L28 36 L40 22"/>
+  </g>
+  <circle cx="30" cy="30" r="3" fill="#22d3ee"/>
+</svg>

package/dist/nodes/LoomCycleRunCompleted/helpers/poll.d.ts

@@ -0,0 +1,12 @@
+import type { ITriggerFunctions } from 'n8n-workflow';
+import type { AgentStatus, LoomcycleClient } from '@loomcycle/client';
+export interface PollOptions {
+    client: LoomcycleClient;
+    userId: string;
+    statuses: AgentStatus[];
+    parentAgentId?: string;
+    intervalMs: number;
+    signal: AbortSignal;
+}
+export declare function runPollLoop(this: ITriggerFunctions, opts: PollOptions): Promise<void>;
+export declare function pollOnce(this: ITriggerFunctions, opts: PollOptions): Promise<void>;

package/dist/nodes/LoomCycleRunCompleted/helpers/poll.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPollLoop = runPollLoop;
+exports.pollOnce = pollOnce;
+const staticData_1 = require("../../LoomCycle/helpers/staticData");
+/**
+ * Polling-fallback event loop for the LoomCycleRunCompleted trigger.
+ *
+ * Calls `listUserAgents(userId, { status, parentAgentId? })` on a fixed
+ * interval, dedups against `workflowStaticData[seenKey].seen` (a set of
+ * agent_ids), emits any new rows whose status matches the operator's
+ * filter. Terminal statuses go into the seen set; running rows are
+ * skipped (we want the COMPLETION emit, not in-flight emits).
+ *
+ * Used when the operator's deployment can't sustain a long-lived SSE
+ * connection (Cloudflare workers without WebSocket, naive nginx
+ * `proxy_buffering on`, etc.).
+ */
+const SEEN_KEY = 'runCompletedSeen';
+async function runPollLoop(opts) {
+    while (!opts.signal.aborted) {
+        try {
+            await pollOnce.call(this, opts);
+        }
+        catch (err) {
+            if (opts.signal.aborted)
+                return;
+            this.emitError(err);
+            // fall through to wait then retry
+        }
+        await sleep(opts.intervalMs, opts.signal);
+    }
+}
+async function pollOnce(opts) {
+    // listUserAgents takes a single `status` filter; iterate the
+    // operator's selection. When empty, ask for all terminal statuses.
+    const wanted = opts.statuses.length > 0 ? opts.statuses : ['completed', 'failed', 'cancelled'];
+    const seen = (0, staticData_1.readSeenSet)(this, SEEN_KEY);
+    const fresh = [];
+    for (const status of wanted) {
+        const rows = await opts.client.listUserAgents(opts.userId, {
+            status,
+            parentAgentId: opts.parentAgentId,
+            signal: opts.signal,
+        });
+        for (const row of rows) {
+            if (!row.agent_id || seen.has(row.agent_id))
+                continue;
+            fresh.push(row);
+            seen.add(row.agent_id);
+        }
+    }
+    if (fresh.length > 0) {
+        (0, staticData_1.writeSeenSet)(this, SEEN_KEY, seen);
+        this.emit([this.helpers.returnJsonArray(fresh.map((r) => r))]);
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve();
+        const t = setTimeout(resolve, ms);
+        signal.addEventListener('abort', () => {
+            clearTimeout(t);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=poll.js.map

package/dist/nodes/LoomCycleRunCompleted/helpers/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../../../../nodes/LoomCycleRunCompleted/helpers/poll.ts"],"names":[],"mappings":";;AA6BA,kCAWC;AAED,4BAyBC;AAjED,mEAA+E;AAE/E;;;;;;;;;;;;GAYG;AAEH,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAW7B,KAAK,UAAU,WAAW,CAA0B,IAAiB;IAC3E,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACJ,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YAChC,IAAI,CAAC,SAAS,CAAC,GAAY,CAAC,CAAC;YAC7B,kCAAkC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;AACF,CAAC;AAEM,KAAK,UAAU,QAAQ,CAA0B,IAAiB;IACxE,6DAA6D;IAC7D,mEAAmE;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAmB,CAAC;IAElH,MAAM,IAAI,GAAG,IAAA,wBAAW,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,KAAK,GAAY,EAAE,CAAC;IAE1B,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE;YAC1D,MAAM;YACN,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACtD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACF,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAA,yBAAY,EAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAA2B,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,CAAC;AACF,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAmB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,OAAO,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACrC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/nodes/LoomCycleRunCompleted/helpers/sse.d.ts

@@ -0,0 +1,29 @@
+import type { ITriggerFunctions } from 'n8n-workflow';
+import type { LoomcycleClient } from '@loomcycle/client';
+/**
+ * SSE-driven event loop for the LoomCycleRunCompleted trigger.
+ *
+ * Wraps `client.streamUserRunStates(userId, opts)` in an auto-reconnect
+ * outer loop: when the iterator completes (server-side 30-min cap, or
+ * a transient disconnect), the loop re-opens unless the abort signal
+ * is fired.
+ *
+ * Adapter `debug: true` yields synthetic `{ kind: "close", payload:
+ * { reason } }` items around real frames; we emit those as debug rows
+ * so the operator can see reconnects when opted-in.
+ *
+ * On a non-abort error (network / 5xx / auth flip), the loop re-throws
+ * via emitError so the n8n trigger lifecycle handles it.
+ */
+export interface SseOptions {
+    client: LoomcycleClient;
+    userId: string;
+    statuses: string[];
+    parentAgentId?: string;
+    agent?: string;
+    debug: boolean;
+    emitClose: boolean;
+    signal: AbortSignal;
+    reconnectBackoffMs: number;
+}
+export declare function runSseLoop(this: ITriggerFunctions, opts: SseOptions): Promise<void>;

package/dist/nodes/LoomCycleRunCompleted/helpers/sse.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSseLoop = runSseLoop;
+async function runSseLoop(opts) {
+    let attempt = 0;
+    while (!opts.signal.aborted) {
+        try {
+            for await (const item of opts.client.streamUserRunStates(opts.userId, {
+                statuses: opts.statuses.length > 0 ? opts.statuses : undefined,
+                agent: opts.agent,
+                parentAgentId: opts.parentAgentId,
+                debug: opts.debug,
+                signal: opts.signal,
+            })) {
+                if (opts.signal.aborted)
+                    return;
+                if (item.kind === 'event') {
+                    this.emit([this.helpers.returnJsonArray([item.payload])]);
+                }
+                else if (item.kind === 'close' && opts.emitClose) {
+                    this.emit([
+                        this.helpers.returnJsonArray([
+                            {
+                                __meta: 'stream_close',
+                                reason: item.payload?.reason ?? '',
+                            },
+                        ]),
+                    ]);
+                }
+            }
+            attempt = 0; // clean stream end → reset backoff
+        }
+        catch (err) {
+            if (opts.signal.aborted)
+                return;
+            attempt += 1;
+            if (attempt >= 5) {
+                // Terminal — no more reconnects. emitError ONCE so n8n's
+                // trigger lifecycle deactivates rather than going silently
+                // deaf. Earlier attempts swallow the error + backoff because
+                // transient SSE drops are normal (30-min server cap,
+                // reverse-proxy idle resets, etc).
+                this.emitError(err);
+                return;
+            }
+            await sleep(opts.reconnectBackoffMs * Math.min(attempt, 4), opts.signal);
+        }
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve();
+        const t = setTimeout(resolve, ms);
+        signal.addEventListener('abort', () => {
+            clearTimeout(t);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=sse.js.map

package/dist/nodes/LoomCycleRunCompleted/helpers/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../../nodes/LoomCycleRunCompleted/helpers/sse.ts"],"names":[],"mappings":";;AA+BA,gCAyCC;AAzCM,KAAK,UAAU,UAAU,CAA0B,IAAgB;IACzE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACJ,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE;gBACrE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC9D,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;aACnB,CAAC,EAAE,CAAC;gBACJ,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,OAAO;gBAChC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC3B,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,OAAiC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrF,CAAC;qBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpD,IAAI,CAAC,IAAI,CAAC;wBACT,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;4BAC5B;gCACC,MAAM,EAAE,cAAc;gCACtB,MAAM,EAAG,IAA0C,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE;6BAC1D;yBAChB,CAAC;qBACF,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YACD,OAAO,GAAG,CAAC,CAAC,CAAC,mCAAmC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YAChC,OAAO,IAAI,CAAC,CAAC;YACb,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBAClB,yDAAyD;gBACzD,2DAA2D;gBAC3D,6DAA6D;gBAC7D,qDAAqD;gBACrD,mCAAmC;gBACnC,IAAI,CAAC,SAAS,CAAC,GAAY,CAAC,CAAC;gBAC7B,OAAO;YACR,CAAC;YACD,MAAM,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1E,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAmB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,OAAO,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACrC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/nodes/LoomCycleSubAgentTool/LoomCycleSubAgentTool.node.d.ts

@@ -0,0 +1,5 @@
+import type { INodeType, INodeTypeDescription, ISupplyDataFunctions, SupplyData } from 'n8n-workflow';
+export declare class LoomCycleSubAgentTool implements INodeType {
+    description: INodeTypeDescription;
+    supplyData(this: ISupplyDataFunctions): Promise<SupplyData>;
+}

package/dist/nodes/LoomCycleSubAgentTool/LoomCycleSubAgentTool.node.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoomCycleSubAgentTool = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = require("zod");
+const client_1 = require("../LoomCycle/helpers/client");
+const segments_1 = require("../LoomCycle/helpers/segments");
+const streaming_1 = require("../LoomCycle/helpers/streaming");
+const clusterTool_1 = require("../_shared/clusterTool");
+/**
+ * `LoomCycle Sub-Agent Tool` — cluster sub-node that lets the parent
+ * n8n AI Agent delegate to a loomcycle agent. When the parent invokes
+ * the tool with a prompt, this node spawns the configured loomcycle
+ * agent, blocks until it terminates, and returns the drained final
+ * text.
+ *
+ * Useful for: handing off to a specialised loomcycle agent (code-
+ * generation, research, evaluation, etc.) while the n8n AI Agent
+ * remains the user-facing orchestrator.
+ */
+const SubAgentInputSchema = zod_1.z.object({
+    prompt: zod_1.z.string().describe('Prompt sent to the loomcycle agent'),
+    sessionId: zod_1.z.string().optional().describe('Optional session_id to continue an existing session'),
+});
+class LoomCycleSubAgentTool {
+    constructor() {
+        this.description = {
+            displayName: 'LoomCycle Sub-Agent Tool',
+            name: 'loomCycleSubAgentTool',
+            icon: 'file:LoomCycleSubAgentTool.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Delegates to a configured loomcycle agent — the parent AI Agent calls this tool with a prompt',
+            defaults: { name: 'LoomCycle Sub-Agent Tool' },
+            codex: { categories: ['AI'], subcategories: { AI: ['Tools'] } },
+            // eslint-disable-next-line n8n-nodes-base/node-class-description-inputs-wrong-regular-node
+            inputs: [],
+            // eslint-disable-next-line n8n-nodes-base/node-class-description-outputs-wrong
+            outputs: [n8n_workflow_1.NodeConnectionTypes.AiTool],
+            outputNames: ['Tool'],
+            credentials: [{ name: 'loomCycleApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Tool Name',
+                    name: 'toolName',
+                    type: 'string',
+                    default: 'loomcycle_sub_agent',
+                    required: true,
+                    description: 'Name of the tool surfaced to the parent AI Agent',
+                },
+                {
+                    displayName: 'Tool Description',
+                    name: 'toolDescription',
+                    type: 'string',
+                    typeOptions: { rows: 3 },
+                    default: 'Delegate a task to a specialised loomcycle agent. Pass the task as the prompt; receive the agent\'s final text.',
+                    description: 'Description the AI Agent sees when deciding whether to call the tool',
+                },
+                {
+                    displayName: 'Agent Name or ID',
+                    name: 'agent',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Loomcycle agent name to spawn — must be declared in operator yaml or registered dynamically',
+                },
+                {
+                    displayName: 'User ID',
+                    name: 'userId',
+                    type: 'string',
+                    default: '',
+                    description: 'Per-tool override of user_id. Falls through to credential default.',
+                },
+                {
+                    displayName: 'User Tier',
+                    name: 'userTier',
+                    type: 'string',
+                    default: '',
+                    description: 'Per-tool override of user_tier. Falls through to credential default.',
+                },
+                {
+                    displayName: 'Treat Prompt as Untrusted',
+                    name: 'treatPromptAsUntrusted',
+                    type: 'boolean',
+                    default: true,
+                    description: 'Whether to wrap the prompt as an untrusted-block segment. Defaults true here because the prompt is model-supplied (the parent AI Agent\'s tool-call argument).',
+                },
+            ],
+        };
+    }
+    async supplyData() {
+        const toolName = this.getNodeParameter('toolName', 0, 'loomcycle_sub_agent');
+        const toolDescription = this.getNodeParameter('toolDescription', 0, '');
+        const agent = this.getNodeParameter('agent', 0);
+        const userIdParam = this.getNodeParameter('userId', 0, '');
+        const userTierParam = this.getNodeParameter('userTier', 0, '');
+        const treatPromptAsUntrusted = this.getNodeParameter('treatPromptAsUntrusted', 0, true);
+        const client = await (0, client_1.getClient)(this);
+        const userIdDefault = await (0, client_1.getCredentialDefault)(this, 'userId');
+        const userTierDefault = await (0, client_1.getCredentialDefault)(this, 'userTier');
+        const userId = userIdParam || userIdDefault;
+        const userTier = userTierParam || userTierDefault;
+        const tool = (0, clusterTool_1.buildTool)({
+            name: toolName,
+            description: toolDescription,
+            schema: SubAgentInputSchema,
+            fn: async (args) => {
+                const runOpts = {
+                    agent,
+                    segments: (0, segments_1.buildSegments)(args.prompt, treatPromptAsUntrusted),
+                };
+                if (userId)
+                    runOpts.userId = userId;
+                if (userTier)
+                    runOpts.userTier = userTier;
+                if (args.sessionId)
+                    runOpts.sessionId = args.sessionId;
+                const result = await (0, streaming_1.drainRunStream)(client.runStreaming(runOpts));
+                // Return the finalText directly (string contract) so the parent
+                // AI Agent treats it as the tool's textual output. Metadata
+                // like usage/sessionId/agentId are dropped — too noisy for the
+                // agent's context. Operators wanting those should use the
+                // action node's Spawn op instead.
+                return result.finalText;
+            },
+        });
+        return { response: tool };
+    }
+}
+exports.LoomCycleSubAgentTool = LoomCycleSubAgentTool;
+//# sourceMappingURL=LoomCycleSubAgentTool.node.js.map

package/dist/nodes/LoomCycleSubAgentTool/LoomCycleSubAgentTool.node.js.map

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

package/dist/nodes/LoomCycleSubAgentTool/LoomCycleSubAgentTool.node.json

@@ -0,0 +1,13 @@
+{
+	"node": "@loomcycle/n8n-nodes-loomcycle.loomCycleSubAgentTool",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["AI"],
+	"resources": {
+		"primaryDocumentation": [
+			{
+				"url": "https://github.com/denn-gubsky/n8n-nodes-loomcycle#cluster-sub-nodes"
+			}
+		]
+	}
+}

package/dist/nodes/LoomCycleSubAgentTool/LoomCycleSubAgentTool.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
+  <title>LoomCycle Sub-Agent Tool</title>
+  <circle cx="30" cy="30" r="28" fill="#0f172a"/>
+  <g fill="none" stroke="#22d3ee" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+    <circle cx="22" cy="22" r="6"/>
+    <circle cx="40" cy="22" r="4"/>
+    <circle cx="40" cy="38" r="4"/>
+    <path d="M27 23 L36 22"/>
+    <path d="M27 27 L36 36"/>
+  </g>
+</svg>

package/dist/nodes/_shared/clusterTool.d.ts

@@ -0,0 +1,19 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import type { z } from 'zod';
+/**
+ * Build a LangChain `DynamicStructuredTool` with our standard error
+ * envelope. Every cluster sub-node uses this helper so the wire surface
+ * to the parent AI Agent is uniform.
+ *
+ * The returned tool's `func` always resolves to a string (LangChain
+ * contract). We JSON-stringify structured results; thrown wire errors
+ * are caught + redacted + returned as a `{"error": "..."}` string so
+ * the agent can read the failure mode without us leaking bearer
+ * fragments into the model's context (CLAUDE.md §security.6).
+ */
+export declare function buildTool<S extends z.ZodTypeAny>(opts: {
+    name: string;
+    description: string;
+    schema: S;
+    fn: (args: z.infer<S>) => Promise<unknown>;
+}): DynamicStructuredTool;

package/dist/nodes/_shared/clusterTool.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTool = buildTool;
+const tools_1 = require("@langchain/core/tools");
+const errors_1 = require("../LoomCycle/helpers/errors");
+/**
+ * Build a LangChain `DynamicStructuredTool` with our standard error
+ * envelope. Every cluster sub-node uses this helper so the wire surface
+ * to the parent AI Agent is uniform.
+ *
+ * The returned tool's `func` always resolves to a string (LangChain
+ * contract). We JSON-stringify structured results; thrown wire errors
+ * are caught + redacted + returned as a `{"error": "..."}` string so
+ * the agent can read the failure mode without us leaking bearer
+ * fragments into the model's context (CLAUDE.md §security.6).
+ */
+function buildTool(opts) {
+    return new tools_1.DynamicStructuredTool({
+        name: opts.name,
+        description: opts.description,
+        schema: opts.schema,
+        func: async (args) => {
+            try {
+                const result = await opts.fn(args);
+                if (typeof result === 'string')
+                    return result;
+                return JSON.stringify(result);
+            }
+            catch (err) {
+                const message = (0, errors_1.redactBearerFragments)(err.message ?? 'unknown loomcycle error');
+                return JSON.stringify({ error: message });
+            }
+        },
+    });
+}
+//# sourceMappingURL=clusterTool.js.map

package/dist/nodes/_shared/clusterTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterTool.js","sourceRoot":"","sources":["../../../nodes/_shared/clusterTool.ts"],"names":[],"mappings":";;AAeA,8BAqBC;AApCD,iDAA8D;AAE9D,wDAAoE;AAEpE;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAAyB,IAKjD;IACA,OAAO,IAAI,6BAAqB,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,KAAK,EAAE,IAAgB,EAAmB,EAAE;YACjD,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,OAAO,MAAM,KAAK,QAAQ;oBAAE,OAAO,MAAM,CAAC;gBAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,OAAO,GAAG,IAAA,8BAAqB,EAAE,GAAa,CAAC,OAAO,IAAI,yBAAyB,CAAC,CAAC;gBAC3F,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3C,CAAC;QACF,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}