@loomcycle/n8n-nodes-loomcycle 1.0.0

package/dist/nodes/LoomCycleMcpServerTool/LoomCycleMcpServerTool.node.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoomCycleMcpServerTool = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = require("zod");
+const client_1 = require("@loomcycle/client");
+const client_2 = require("../LoomCycle/helpers/client");
+const segments_1 = require("../LoomCycle/helpers/segments");
+const streaming_1 = require("../LoomCycle/helpers/streaming");
+const envVarHints_1 = require("../LoomCycle/helpers/envVarHints");
+const clusterTool_1 = require("../_shared/clusterTool");
+/**
+ * `LoomCycle MCP Server Tool` — **the strategic differentiator** for the
+ * n8n integration.
+ *
+ * Wires a single MCP server registration into loomcycle's substrate
+ * idempotently (get-then-create), then exposes a tool the parent AI
+ * Agent can call to delegate work to a loomcycle agent that has access
+ * to that MCP server's tool surface.
+ *
+ * Flow on `supplyData`:
+ *   1. Read tool config (name, transport, URL, headers, the loomcycle
+ *      agent to spawn).
+ *   2. Refuse stdio transport with `NodeOperationError` (stdio MCP
+ *      servers must live in loomcycle.yaml — the substrate enforces
+ *      this; we surface it pre-wire for a cleaner error).
+ *   3. Idempotent ensure: `mcpServerDef({op:"get", name})` → on
+ *      `NotFoundError`, `mcpServerDef({op:"create", ...})`. This means
+ *      the second-and-Nth canvas runs are no-ops; the first run does
+ *      the actual registration.
+ *   4. Return a tool that, when invoked, spawns the configured
+ *      loomcycle agent with `allowed_tools: ["mcp__<name>__*"]` so
+ *      the agent has access to the just-registered MCP server's tools.
+ *
+ * Lifecycle: **`cleanupOnEnd: false` default** — registrations persist
+ * across workflow executions so multiple agentic teams share stable
+ * MCP fleets without churn. Opt in to retire-on-workflow-end via the
+ * sub-node parameter when you want ephemeral / scoped registrations.
+ */
+const McpServerInputSchema = zod_1.z.object({
+    prompt: zod_1.z.string().describe('Prompt sent to the loomcycle agent (which has access to the MCP server\'s tools)'),
+});
+class LoomCycleMcpServerTool {
+    constructor() {
+        this.description = {
+            displayName: 'LoomCycle MCP Server Tool',
+            name: 'loomCycleMcpServerTool',
+            icon: 'file:LoomCycleMcpServerTool.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Registers an MCP server in the loomcycle substrate (idempotent), then exposes a tool that delegates to a loomcycle agent using that MCP server',
+            defaults: { name: 'LoomCycle MCP Server 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_mcp',
+                    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 loomcycle agent that has access to the configured MCP server. Pass the task as the prompt.',
+                    description: 'Description the AI Agent sees when deciding whether to call the tool',
+                },
+                {
+                    displayName: 'MCP Server Name',
+                    name: 'mcpName',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Registration name in loomcycle — referenced by agents as `mcp__&lt;name&gt;__&lt;tool&gt;`. Must be unique across the substrate; collisions with static yaml entries are refused.',
+                },
+                {
+                    displayName: 'Transport',
+                    name: 'transport',
+                    type: 'options',
+                    default: 'streamable-http',
+                    required: true,
+                    options: [
+                        { name: 'HTTP', value: 'http', description: 'Classic JSON-RPC over HTTP POST' },
+                        { name: 'Streamable HTTP', value: 'streamable-http', description: 'MCP Streamable HTTP transport (recommended)' },
+                    ],
+                    description: 'Transport for the MCP server. Stdio is intentionally not supported here — register stdio MCPs in loomcycle.yaml.',
+                },
+                {
+                    displayName: 'URL',
+                    name: 'mcpUrl',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'https://mcp.example.com/v1',
+                    description: 'MCP server endpoint URL. Hostname must be in loomcycle\'s HTTPHostAllowlist.',
+                },
+                {
+                    displayName: 'Headers',
+                    name: 'headers',
+                    type: 'fixedCollection',
+                    placeholder: 'Add Header',
+                    default: {},
+                    typeOptions: { multipleValues: true },
+                    options: [
+                        {
+                            name: 'header',
+                            displayName: 'Header',
+                            values: [
+                                {
+                                    displayName: 'Name',
+                                    name: 'name',
+                                    type: 'string',
+                                    default: '',
+                                    required: true,
+                                },
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                    required: true,
+                                    description: 'Supports `${LOOMCYCLE_FOO}` env-var substitution + `${run.user_bearer:-FALLBACK}` per-run substitution',
+                                },
+                            ],
+                        },
+                    ],
+                    description: 'Headers attached to every MCP call. Use template strings (`${LOOMCYCLE_FOO_TOKEN}`) — plaintext credentials never travel through this wire path.',
+                },
+                {
+                    displayName: 'Loomcycle Agent',
+                    name: 'agent',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Loomcycle agent name to spawn when the parent AI Agent invokes this tool. The spawn will include `mcp__&lt;name&gt;__*` in allowed_tools so the agent can reach the MCP server.',
+                },
+                {
+                    displayName: 'Cleanup On Workflow End',
+                    name: 'cleanupOnEnd',
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether to retire the MCP server registration when the workflow execution ends. Default false: registrations persist so multiple agentic teams share stable MCP fleets without churn.',
+                },
+            ],
+        };
+    }
+    async supplyData() {
+        const toolName = this.getNodeParameter('toolName', 0, 'loomcycle_mcp');
+        const toolDescription = this.getNodeParameter('toolDescription', 0, '');
+        const mcpName = this.getNodeParameter('mcpName', 0);
+        const transport = this.getNodeParameter('transport', 0);
+        const mcpUrl = this.getNodeParameter('mcpUrl', 0);
+        const headersParam = this.getNodeParameter('headers', 0, {});
+        const agent = this.getNodeParameter('agent', 0);
+        const cleanupOnEnd = this.getNodeParameter('cleanupOnEnd', 0, false);
+        if (transport !== 'http' && transport !== 'streamable-http') {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Transport must be HTTP or Streamable-HTTP. Stdio MCP servers must be declared in loomcycle.yaml — dynamic registration does not support stdio.`);
+        }
+        const headers = collectHeaders(headersParam);
+        const client = await (0, client_2.getClient)(this);
+        const userIdDefault = await (0, client_2.getCredentialDefault)(this, 'userId');
+        const userTierDefault = await (0, client_2.getCredentialDefault)(this, 'userTier');
+        // Idempotent ensure: try get; on NotFoundError, create.
+        try {
+            await client.mcpServerDef({ op: 'get', name: mcpName });
+        }
+        catch (err) {
+            if (!(err instanceof client_1.NotFoundError)) {
+                throw err;
+            }
+            const createInput = {
+                op: 'create',
+                name: mcpName,
+                promote: true,
+                // transport / url / headers ride on the index-signature
+                // (SubstrateToolInput has `[extra: string]: unknown`).
+                transport,
+                url: mcpUrl,
+            };
+            if (Object.keys(headers).length > 0)
+                createInput.headers = headers;
+            await client.mcpServerDef(createInput);
+        }
+        // Env-var hints (defence-in-depth — surface in the node's log so
+        // operators see which env vars must exist on the loomcycle side).
+        const envVars = (0, envVarHints_1.extractEnvVarsFromHeaders)(headersParam);
+        if (envVars.length > 0) {
+            this.logger.info?.(`[LoomCycleMcpServerTool] MCP server ${mcpName} registered. Required env vars on loomcycle: ${envVars.join(', ')}`);
+        }
+        const allowedToolGlob = `mcp__${mcpName}__*`;
+        const tool = (0, clusterTool_1.buildTool)({
+            name: toolName,
+            description: toolDescription,
+            schema: McpServerInputSchema,
+            fn: async (args) => {
+                const runOpts = {
+                    agent,
+                    segments: (0, segments_1.buildSegments)(args.prompt, true), // model-supplied prompt → untrusted
+                    allowedTools: [allowedToolGlob],
+                };
+                if (userIdDefault)
+                    runOpts.userId = userIdDefault;
+                if (userTierDefault)
+                    runOpts.userTier = userTierDefault;
+                const result = await (0, streaming_1.drainRunStream)(client.runStreaming(runOpts));
+                return result.finalText;
+            },
+        });
+        const supplyData = { response: tool };
+        if (cleanupOnEnd) {
+            supplyData.closeFunction = async () => {
+                try {
+                    await client.mcpServerDef({ op: 'retire', name: mcpName });
+                }
+                catch {
+                    // Best-effort cleanup; n8n's lifecycle calls closeFunction
+                    // at workflow-end and we don't want a failed retire to
+                    // taint the workflow's success state.
+                }
+            };
+        }
+        return supplyData;
+    }
+}
+exports.LoomCycleMcpServerTool = LoomCycleMcpServerTool;
+/**
+ * Collect headers from the n8n fixedCollection shape into a map.
+ * Identical to the helper inside the umbrella node's executeMcpServerDef
+ * — kept local because the umbrella's lives in a closure and we want
+ * the cluster sub-node to be standalone.
+ */
+function collectHeaders(raw) {
+    const out = {};
+    if (!raw || typeof raw !== 'object')
+        return out;
+    const headerCollection = raw.header;
+    if (!Array.isArray(headerCollection))
+        return out;
+    for (const entry of headerCollection) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const name = entry.name;
+        const value = entry.value;
+        if (typeof name === 'string' && name && typeof value === 'string') {
+            out[name] = value;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=LoomCycleMcpServerTool.node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoomCycleMcpServerTool.node.js","sourceRoot":"","sources":["../../../nodes/LoomCycleMcpServerTool/LoomCycleMcpServerTool.node.ts"],"names":[],"mappings":";;;AACA,+CAAuE;AACvE,6BAAwB;AAExB,8CAAkD;AAElD,wDAA8E;AAC9E,4DAA8D;AAC9D,8DAAgE;AAChE,kEAA6E;AAC7E,wDAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;CAC/G,CAAC,CAAC;AAEH,MAAa,sBAAsB;IAAnC;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,2BAA2B;YACxC,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,iCAAiC;YACvC,KAAK,EAAE,CAAC,WAAW,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,WAAW,EACV,gJAAgJ;YACjJ,QAAQ,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE;YAC/C,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE;YAC/D,2FAA2F;YAC3F,MAAM,EAAE,EAAE;YACV,+EAA+E;YAC/E,OAAO,EAAE,CAAC,kCAAmB,CAAC,MAAM,CAAC;YACrC,WAAW,EAAE,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACvD,UAAU,EAAE;gBACX;oBACC,WAAW,EAAE,WAAW;oBACxB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,eAAe;oBACxB,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,kDAAkD;iBAC/D;gBACD;oBACC,WAAW,EAAE,kBAAkB;oBAC/B,IAAI,EAAE,iBAAiB;oBACvB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;oBACxB,OAAO,EACN,iHAAiH;oBAClH,WAAW,EAAE,sEAAsE;iBACnF;gBACD;oBACC,WAAW,EAAE,iBAAiB;oBAC9B,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,EAAE;oBACX,QAAQ,EAAE,IAAI;oBACd,WAAW,EACV,mLAAmL;iBACpL;gBACD;oBACC,WAAW,EAAE,WAAW;oBACxB,IAAI,EAAE,WAAW;oBACjB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,iBAAiB;oBAC1B,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE;wBACR,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,iCAAiC,EAAE;wBAC/E,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,6CAA6C,EAAE;qBACjH;oBACD,WAAW,EAAE,kHAAkH;iBAC/H;gBACD;oBACC,WAAW,EAAE,KAAK;oBAClB,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,EAAE;oBACX,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,4BAA4B;oBACzC,WAAW,EAAE,8EAA8E;iBAC3F;gBACD;oBACC,WAAW,EAAE,SAAS;oBACtB,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,iBAAiB;oBACvB,WAAW,EAAE,YAAY;oBACzB,OAAO,EAAE,EAAE;oBACX,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE;oBACrC,OAAO,EAAE;wBACR;4BACC,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,QAAQ;4BACrB,MAAM,EAAE;gCACP;oCACC,WAAW,EAAE,MAAM;oCACnB,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,QAAQ;oCACd,OAAO,EAAE,EAAE;oCACX,QAAQ,EAAE,IAAI;iCACd;gCACD;oCACC,WAAW,EAAE,OAAO;oCACpB,IAAI,EAAE,OAAO;oCACb,IAAI,EAAE,QAAQ;oCACd,OAAO,EAAE,EAAE;oCACX,QAAQ,EAAE,IAAI;oCACd,WAAW,EACV,wGAAwG;iCACzG;6BACD;yBACD;qBACD;oBACD,WAAW,EACV,kJAAkJ;iBACnJ;gBACD;oBACC,WAAW,EAAE,iBAAiB;oBAC9B,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,EAAE;oBACX,QAAQ,EAAE,IAAI;oBACd,WAAW,EACV,iLAAiL;iBAClL;gBACD;oBACC,WAAW,EAAE,yBAAyB;oBACtC,IAAI,EAAE,cAAc;oBACpB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,KAAK;oBACd,WAAW,EACV,uLAAuL;iBACxL;aACD;SACD,CAAC;IAyFH,CAAC;IAvFA,KAAK,CAAC,UAAU;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,EAAE,eAAe,CAAW,CAAC;QACjF,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAW,CAAC;QAClF,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAW,CAAC;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAW,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW,CAAC;QAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAY,CAAC;QACxE,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAW,CAAC;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,EAAE,KAAK,CAAY,CAAC;QAEhF,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;YAC7D,MAAM,IAAI,iCAAkB,CAC3B,IAAI,CAAC,OAAO,EAAE,EACd,gJAAgJ,CAChJ,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAS,EAAC,IAAI,CAAC,CAAC;QACrC,MAAM,aAAa,GAAG,MAAM,IAAA,6BAAoB,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,eAAe,GAAG,MAAM,IAAA,6BAAoB,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAErE,wDAAwD;QACxD,IAAI,CAAC;YACJ,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,CAAC,GAAG,YAAY,sBAAa,CAAC,EAAE,CAAC;gBACrC,MAAM,GAAG,CAAC;YACX,CAAC;YACD,MAAM,WAAW,GAAuB;gBACvC,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,IAAI;gBACb,wDAAwD;gBACxD,uDAAuD;gBACvD,SAAS;gBACT,GAAG,EAAE,MAAM;aACX,CAAC;YACF,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;YACnE,MAAM,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QAED,iEAAiE;QACjE,kEAAkE;QAClE,MAAM,OAAO,GAAG,IAAA,uCAAyB,EAAC,YAAY,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CACjB,uCAAuC,OAAO,gDAAgD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClH,CAAC;QACH,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,OAAO,KAAK,CAAC;QAE7C,MAAM,IAAI,GAAG,IAAA,uBAAS,EAAC;YACtB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,eAAe;YAC5B,MAAM,EAAE,oBAAoB;YAC5B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAClB,MAAM,OAAO,GAAe;oBAC3B,KAAK;oBACL,QAAQ,EAAE,IAAA,wBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,oCAAoC;oBAChF,YAAY,EAAE,CAAC,eAAe,CAAC;iBAC/B,CAAC;gBACF,IAAI,aAAa;oBAAE,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC;gBAClD,IAAI,eAAe;oBAAE,OAAO,CAAC,QAAQ,GAAG,eAAe,CAAC;gBAExD,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAc,EAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;gBAClE,OAAO,MAAM,CAAC,SAAS,CAAC;YACzB,CAAC;SACD,CAAC,CAAC;QAEH,MAAM,UAAU,GAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAElD,IAAI,YAAY,EAAE,CAAC;YAClB,UAAU,CAAC,aAAa,GAAG,KAAK,IAAI,EAAE;gBACrC,IAAI,CAAC;oBACJ,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC5D,CAAC;gBAAC,MAAM,CAAC;oBACR,2DAA2D;oBAC3D,uDAAuD;oBACvD,sCAAsC;gBACvC,CAAC;YACF,CAAC,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACnB,CAAC;CACD;AA9MD,wDA8MC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,GAAY;IACnC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAChD,MAAM,gBAAgB,GAAI,GAA4B,CAAC,MAAM,CAAC;IAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAAE,OAAO,GAAG,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;QAChD,MAAM,KAAK,GAAI,KAA6B,CAAC,KAAK,CAAC;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/nodes/LoomCycleMcpServerTool/LoomCycleMcpServerTool.node.json

@@ -0,0 +1,13 @@
+{
+	"node": "@loomcycle/n8n-nodes-loomcycle.loomCycleMcpServerTool",
+	"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/LoomCycleMcpServerTool/LoomCycleMcpServerTool.svg

@@ -0,0 +1,14 @@
+<?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 MCP Server 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">
+    <rect x="14" y="16" width="32" height="14" rx="2"/>
+    <path d="M14 22 L46 22"/>
+    <circle cx="18" cy="19" r="1" fill="#22d3ee"/>
+    <circle cx="22" cy="19" r="1" fill="#22d3ee"/>
+    <path d="M22 30 L22 38 L30 38"/>
+    <path d="M38 30 L38 38 L30 38"/>
+    <circle cx="30" cy="44" r="3" fill="#22d3ee"/>
+  </g>
+</svg>

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

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

package/dist/nodes/LoomCycleMemoryTool/LoomCycleMemoryTool.node.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoomCycleMemoryTool = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = require("zod");
+const client_1 = require("../LoomCycle/helpers/client");
+const clusterTool_1 = require("../_shared/clusterTool");
+/**
+ * `LoomCycle Memory Tool` — cluster sub-node that plugs into n8n's AI
+ * Agent. Exposes loomcycle's Memory read surface as a single discriminated
+ * tool the agent can call.
+ *
+ * Read-only in this sub-phase (mirroring the action-node Memory resource;
+ * Set/Delete/Search land when `@loomcycle/client` exposes admin write
+ * endpoints).
+ */
+const MemoryInputSchema = zod_1.z.object({
+    op: zod_1.z
+        .enum(['listScopes', 'listScopeIDs', 'listEntries', 'getEntry'])
+        .describe('Which Memory operation to invoke'),
+    scope: zod_1.z
+        .string()
+        .optional()
+        .describe('Memory scope (e.g. "agent", "user"). Required for listScopeIDs / listEntries / getEntry.'),
+    scopeID: zod_1.z
+        .string()
+        .optional()
+        .describe('Identifier within the scope. Required for listEntries / getEntry.'),
+    key: zod_1.z.string().optional().describe('Entry key. Required for getEntry.'),
+    prefix: zod_1.z.string().optional().describe('Key prefix filter for listEntries'),
+    limit: zod_1.z.number().int().positive().optional().describe('Max number of entries to return (listEntries)'),
+});
+class LoomCycleMemoryTool {
+    constructor() {
+        this.description = {
+            displayName: 'LoomCycle Memory Tool',
+            name: 'loomCycleMemoryTool',
+            icon: 'file:LoomCycleMemoryTool.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Loomcycle Memory ops (read-only) as a tool the AI Agent can call',
+            defaults: { name: 'LoomCycle Memory 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_memory',
+                    required: true,
+                    description: 'Name of the tool surfaced to the parent AI Agent — must be unique across sibling tools',
+                },
+                {
+                    displayName: 'Tool Description',
+                    name: 'toolDescription',
+                    type: 'string',
+                    typeOptions: { rows: 3 },
+                    default: 'Read loomcycle Memory entries. Use op=listScopes to list scopes, op=listScopeIDs+scope to list ids, op=listEntries+scope+scopeID to list keys (optionally prefix/limit), op=getEntry+scope+scopeID+key to read a value.',
+                    description: 'Description the AI Agent sees when deciding whether to call the tool',
+                },
+            ],
+        };
+    }
+    async supplyData() {
+        const toolName = this.getNodeParameter('toolName', 0, 'loomcycle_memory');
+        const toolDescription = this.getNodeParameter('toolDescription', 0, '');
+        const client = await (0, client_1.getClient)(this);
+        const tool = (0, clusterTool_1.buildTool)({
+            name: toolName,
+            description: toolDescription,
+            schema: MemoryInputSchema,
+            fn: async (args) => {
+                switch (args.op) {
+                    case 'listScopes':
+                        return client.listMemoryScopes();
+                    case 'listScopeIDs':
+                        if (!args.scope)
+                            throw new Error('scope is required for listScopeIDs');
+                        return client.listMemoryScopeIDs(args.scope);
+                    case 'listEntries': {
+                        if (!args.scope || !args.scopeID)
+                            throw new Error('scope + scopeID required for listEntries');
+                        const opts = {};
+                        if (args.prefix)
+                            opts.prefix = args.prefix;
+                        if (args.limit)
+                            opts.limit = args.limit;
+                        return client.listMemoryEntries(args.scope, args.scopeID, opts);
+                    }
+                    case 'getEntry':
+                        if (!args.scope || !args.scopeID || !args.key) {
+                            throw new Error('scope + scopeID + key required for getEntry');
+                        }
+                        return client.getMemoryEntry(args.scope, args.scopeID, args.key);
+                }
+            },
+        });
+        return { response: tool };
+    }
+}
+exports.LoomCycleMemoryTool = LoomCycleMemoryTool;
+//# sourceMappingURL=LoomCycleMemoryTool.node.js.map

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

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

package/dist/nodes/LoomCycleMemoryTool/LoomCycleMemoryTool.node.json

@@ -0,0 +1,13 @@
+{
+	"node": "@loomcycle/n8n-nodes-loomcycle.loomCycleMemoryTool",
+	"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/LoomCycleMemoryTool/LoomCycleMemoryTool.svg

@@ -0,0 +1,11 @@
+<?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 Memory 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">
+    <rect x="14" y="18" width="32" height="24" rx="3"/>
+    <path d="M14 26 L46 26"/>
+    <path d="M14 34 L46 34"/>
+    <path d="M22 18 L22 42"/>
+  </g>
+</svg>

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

@@ -0,0 +1,18 @@
+import type { INodeType, INodeTypeDescription, ITriggerFunctions, ITriggerResponse } from 'n8n-workflow';
+/**
+ * `LoomCycle: Run Completed` — trigger that fires when a loomcycle
+ * agent run reaches a terminal state (completed / failed / cancelled).
+ *
+ * Two transports, operator-selectable via the `mode` parameter:
+ *   - `sse` (default): persistent stream via streamUserRunStates. The
+ *     adapter handles the substrate's 30-min server-side cap by
+ *     yielding cleanly; our loop transparently re-opens. parentAgentId
+ *     filter and debug toggle are forwarded.
+ *   - `poll`: periodic listUserAgents calls with workflow-static
+ *     dedup. Use when the deployment can't sustain long-lived SSE
+ *     (reverse-proxy issues, Cloudflare workers, etc.).
+ */
+export declare class LoomCycleRunCompleted implements INodeType {
+    description: INodeTypeDescription;
+    trigger(this: ITriggerFunctions): Promise<ITriggerResponse>;
+}

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

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoomCycleRunCompleted = void 0;
+const client_1 = require("../LoomCycle/helpers/client");
+const errors_1 = require("../LoomCycle/helpers/errors");
+const sse_1 = require("./helpers/sse");
+const poll_1 = require("./helpers/poll");
+/**
+ * `LoomCycle: Run Completed` — trigger that fires when a loomcycle
+ * agent run reaches a terminal state (completed / failed / cancelled).
+ *
+ * Two transports, operator-selectable via the `mode` parameter:
+ *   - `sse` (default): persistent stream via streamUserRunStates. The
+ *     adapter handles the substrate's 30-min server-side cap by
+ *     yielding cleanly; our loop transparently re-opens. parentAgentId
+ *     filter and debug toggle are forwarded.
+ *   - `poll`: periodic listUserAgents calls with workflow-static
+ *     dedup. Use when the deployment can't sustain long-lived SSE
+ *     (reverse-proxy issues, Cloudflare workers, etc.).
+ */
+class LoomCycleRunCompleted {
+    constructor() {
+        this.description = {
+            displayName: 'LoomCycle: Run Completed',
+            name: 'loomCycleRunCompleted',
+            icon: 'file:LoomCycleRunCompleted.svg',
+            group: ['trigger'],
+            version: 1,
+            description: 'Fires when a loomcycle agent run reaches a terminal state (completed/failed/cancelled)',
+            defaults: { name: 'LoomCycle: Run Completed' },
+            // eslint-disable-next-line n8n-nodes-base/node-class-description-inputs-wrong-regular-node
+            inputs: [],
+            outputs: ['main'],
+            credentials: [{ name: 'loomCycleApi', required: true }],
+            properties: [
+                {
+                    displayName: 'User ID',
+                    name: 'userId',
+                    type: 'string',
+                    default: '',
+                    description: 'User_id to watch. Empty = use the credential\'s Default User ID.',
+                },
+                {
+                    displayName: 'Statuses',
+                    name: 'statuses',
+                    type: 'multiOptions',
+                    default: ['completed'],
+                    options: [
+                        { name: 'Cancelled', value: 'cancelled' },
+                        { name: 'Completed', value: 'completed' },
+                        { name: 'Failed', value: 'failed' },
+                    ],
+                    description: 'Which terminal statuses fire this trigger',
+                },
+                {
+                    displayName: 'Transport',
+                    name: 'mode',
+                    type: 'options',
+                    default: 'sse',
+                    options: [
+                        {
+                            name: 'SSE (Push)',
+                            value: 'sse',
+                            description: 'Persistent stream; near-zero latency. Requires reverse-proxy SSE support.',
+                        },
+                        {
+                            name: 'Polling',
+                            value: 'poll',
+                            description: 'Periodic list calls with dedup. Use when SSE is not viable.',
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Poll Interval (Seconds)',
+                    name: 'intervalSec',
+                    type: 'number',
+                    default: 30,
+                    typeOptions: { minValue: 5, maxValue: 3600 },
+                    displayOptions: { show: { mode: ['poll'] } },
+                    description: 'How frequently to poll for new terminal-state rows',
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Agent Name',
+                            name: 'agent',
+                            type: 'string',
+                            default: '',
+                            description: 'Narrow to runs of a specific agent name (SSE mode only)',
+                        },
+                        {
+                            displayName: 'Parent Agent ID',
+                            name: 'parentAgentId',
+                            type: 'string',
+                            default: '',
+                            description: 'Narrow to sub-runs of a specific parent agent_id',
+                        },
+                        {
+                            displayName: 'Surface Stream Open/Close Events',
+                            name: 'emitClose',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to emit synthetic `{__meta:"stream_close"}` rows when the SSE stream reconnects. SSE mode only.',
+                        },
+                        {
+                            displayName: 'Reconnect Backoff (Ms)',
+                            name: 'reconnectBackoffMs',
+                            type: 'number',
+                            default: 1000,
+                            typeOptions: { minValue: 100, maxValue: 60000 },
+                            description: 'Base backoff between SSE reconnects. Multiplied by attempt count (capped at 4×).',
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async trigger() {
+        const userIdParam = this.getNodeParameter('userId', '') ?? '';
+        const statuses = this.getNodeParameter('statuses', ['completed']) ?? ['completed'];
+        const mode = this.getNodeParameter('mode', 'sse') ?? 'sse';
+        const intervalSec = this.getNodeParameter('intervalSec', 30) ?? 30;
+        const additionalFields = this.getNodeParameter('additionalFields', {}) ?? {};
+        const userId = userIdParam || (await (0, client_1.getCredentialDefault)(this, 'userId'));
+        if (!userId) {
+            throw (0, errors_1.wrapLoomcycleError)(new Error('User ID required — set per-node or as Default User ID on the credential'), this.getNode());
+        }
+        const client = await (0, client_1.getClient)(this);
+        const ac = new AbortController();
+        const agent = additionalFields.agent || undefined;
+        const parentAgentId = additionalFields.parentAgentId || undefined;
+        const emitClose = additionalFields.emitClose ?? false;
+        const reconnectBackoffMs = additionalFields.reconnectBackoffMs ?? 1000;
+        // Background loop — fire-and-forget. n8n's closeFunction aborts
+        // the controller; both loops respect it cooperatively.
+        if (mode === 'poll') {
+            void poll_1.runPollLoop.call(this, {
+                client,
+                userId,
+                statuses: statuses,
+                parentAgentId,
+                intervalMs: intervalSec * 1000,
+                signal: ac.signal,
+            });
+        }
+        else {
+            void sse_1.runSseLoop.call(this, {
+                client,
+                userId,
+                statuses,
+                parentAgentId,
+                agent,
+                debug: emitClose,
+                emitClose,
+                signal: ac.signal,
+                reconnectBackoffMs,
+            });
+        }
+        // Single-shot path used when the operator clicks "Listen for Test
+        // Event" in the n8n editor. We resolve as soon as the first event
+        // lands, then close.
+        async function manualTriggerFunction() {
+            const oneShotAc = new AbortController();
+            const userIdInner = userId;
+            await poll_1.pollOnce.call(this, {
+                client,
+                userId: userIdInner,
+                statuses: statuses,
+                parentAgentId,
+                intervalMs: 0,
+                signal: oneShotAc.signal,
+            });
+        }
+        return {
+            closeFunction: async () => {
+                ac.abort();
+            },
+            manualTriggerFunction: manualTriggerFunction.bind(this),
+        };
+    }
+}
+exports.LoomCycleRunCompleted = LoomCycleRunCompleted;
+//# sourceMappingURL=LoomCycleRunCompleted.node.js.map