@loomcycle/n8n-nodes-loomcycle 1.0.0

package/dist/nodes/LoomCycleChannelMessage/LoomCycleChannelMessage.node.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoomCycleChannelMessage = void 0;
+const client_1 = require("../LoomCycle/helpers/client");
+const errors_1 = require("../LoomCycle/helpers/errors");
+const loadOptions_1 = require("../LoomCycle/helpers/loadOptions");
+const subscribe_1 = require("./helpers/subscribe");
+/**
+ * `LoomCycle: Channel Message` — trigger that fires when a new
+ * message lands on a watched loomcycle channel.
+ *
+ * Two delivery modes:
+ *   - `auto-ack`: direct long-poll subscribeChannel (at-most-once;
+ *     fastest path)
+ *   - `peek-ack`: peekChannel + explicit ackChannel after emit (at-
+ *     least-once; survives workflow crashes mid-processing)
+ *
+ * Both modes ride the v0.9.2 PR #180 Channel CRUD wire surface — no
+ * one-shot agents.
+ */
+class LoomCycleChannelMessage {
+    constructor() {
+        this.description = {
+            displayName: 'LoomCycle: Channel Message',
+            name: 'loomCycleChannelMessage',
+            icon: 'file:LoomCycleChannelMessage.svg',
+            group: ['trigger'],
+            version: 1,
+            description: 'Fires when a new message arrives on a loomcycle channel',
+            defaults: { name: 'LoomCycle: Channel Message' },
+            // eslint-disable-next-line n8n-nodes-base/node-class-description-inputs-wrong-regular-node
+            inputs: [],
+            outputs: ['main'],
+            credentials: [{ name: 'loomCycleApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Channel Name or ID',
+                    name: 'channel',
+                    type: 'options',
+                    typeOptions: { loadOptionsMethod: 'loadChannels' },
+                    default: '',
+                    required: true,
+                    description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+                },
+                {
+                    displayName: 'Scope',
+                    name: 'scope',
+                    type: 'options',
+                    default: 'global',
+                    options: [
+                        { name: 'Global (Admin)', value: 'global', description: 'Single global queue for the channel' },
+                        { name: 'User (Per-User)', value: 'user', description: 'Per-user queue; userId required' },
+                    ],
+                },
+                {
+                    displayName: 'User ID',
+                    name: 'userId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { scope: ['user'] } },
+                    description: 'User_id for the per-user scope. Empty = use the credential\'s Default User ID.',
+                },
+                {
+                    displayName: 'Delivery Mode',
+                    name: 'deliveryMode',
+                    type: 'options',
+                    default: 'auto-ack',
+                    options: [
+                        {
+                            name: 'Auto-Ack (At-Most-Once)',
+                            value: 'auto-ack',
+                            description: 'Direct long-poll subscribe; substrate auto-commits the cursor',
+                        },
+                        {
+                            name: 'Peek + Explicit Ack (At-Least-Once)',
+                            value: 'peek-ack',
+                            description: 'Peek non-destructively, emit, then ack — survives crashes mid-processing',
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Max Messages per Batch',
+                            name: 'maxMessages',
+                            type: 'number',
+                            default: 10,
+                            typeOptions: { minValue: 1, maxValue: 1000 },
+                            description: 'Maximum number of messages to return per long-poll round',
+                        },
+                        {
+                            displayName: 'Wait Ms',
+                            name: 'waitMs',
+                            type: 'number',
+                            default: 30000,
+                            typeOptions: { minValue: 0, maxValue: 60000 },
+                            description: 'Long-poll wait timeout for auto-ack mode (server cap typically 30s). For peek-ack mode, sleep between empty peeks.',
+                        },
+                        {
+                            displayName: 'Error Backoff (Ms)',
+                            name: 'backoffMs',
+                            type: 'number',
+                            default: 5000,
+                            typeOptions: { minValue: 500, maxValue: 60000 },
+                            description: 'How long to wait after an error before retrying',
+                        },
+                    ],
+                },
+            ],
+        };
+        this.methods = {
+            loadOptions: {
+                loadChannels: loadOptions_1.loadChannels,
+            },
+        };
+    }
+    async trigger() {
+        const channel = this.getNodeParameter('channel', '');
+        const scope = this.getNodeParameter('scope', 'global') ?? 'global';
+        const userIdParam = this.getNodeParameter('userId', '') ?? '';
+        const deliveryMode = this.getNodeParameter('deliveryMode', 'auto-ack') ?? 'auto-ack';
+        const additionalFields = this.getNodeParameter('additionalFields', {}) ?? {};
+        if (!channel) {
+            throw (0, errors_1.wrapLoomcycleError)(new Error('Channel name is required'), this.getNode());
+        }
+        const userId = scope === 'user' ? userIdParam || (await (0, client_1.getCredentialDefault)(this, 'userId')) : undefined;
+        if (scope === 'user' && !userId) {
+            throw (0, errors_1.wrapLoomcycleError)(new Error('User ID is required when scope=user — 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 loopOpts = {
+            client,
+            channel,
+            scope,
+            userId,
+            deliveryMode,
+            maxMessages: additionalFields.maxMessages ?? 10,
+            waitMs: additionalFields.waitMs ?? 30000,
+            backoffMs: additionalFields.backoffMs ?? 5000,
+            signal: ac.signal,
+        };
+        void subscribe_1.runSubscribeLoop.call(this, loopOpts);
+        async function manualTriggerFunction() {
+            const oneShotAc = new AbortController();
+            await subscribe_1.subscribeOnce.call(this, { ...loopOpts, signal: oneShotAc.signal });
+        }
+        return {
+            closeFunction: async () => {
+                ac.abort();
+            },
+            manualTriggerFunction: manualTriggerFunction.bind(this),
+        };
+    }
+}
+exports.LoomCycleChannelMessage = LoomCycleChannelMessage;
+//# sourceMappingURL=LoomCycleChannelMessage.node.js.map

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

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

package/dist/nodes/LoomCycleChannelMessage/LoomCycleChannelMessage.node.json

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

package/dist/nodes/LoomCycleChannelMessage/LoomCycleChannelMessage.svg

@@ -0,0 +1,9 @@
+<?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: Channel Message</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="15" y="20" width="30" height="20" rx="4"/>
+    <path d="M15 24 L30 32 L45 24"/>
+  </g>
+</svg>

package/dist/nodes/LoomCycleChannelMessage/helpers/subscribe.d.ts

@@ -0,0 +1,20 @@
+import type { ITriggerFunctions } from 'n8n-workflow';
+import type { ChannelScope, LoomcycleClient } from '@loomcycle/client';
+export interface SubscribeOptions {
+    client: LoomcycleClient;
+    channel: string;
+    scope: ChannelScope;
+    userId?: string;
+    deliveryMode: 'auto-ack' | 'peek-ack';
+    maxMessages: number;
+    waitMs: number;
+    backoffMs: number;
+    signal: AbortSignal;
+}
+export declare function runSubscribeLoop(this: ITriggerFunctions, opts: SubscribeOptions): Promise<void>;
+/**
+ * Single long-poll round. Returns the number of messages emitted.
+ * Exposed as a separate function so manualTriggerFunction can do a
+ * one-shot listen.
+ */
+export declare function subscribeOnce(this: ITriggerFunctions, opts: SubscribeOptions): Promise<number>;

package/dist/nodes/LoomCycleChannelMessage/helpers/subscribe.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSubscribeLoop = runSubscribeLoop;
+exports.subscribeOnce = subscribeOnce;
+const staticData_1 = require("../../LoomCycle/helpers/staticData");
+/**
+ * Long-poll subscribe loop for the LoomCycleChannelMessage trigger.
+ *
+ * Two delivery shapes:
+ *   - `auto-ack` (default): direct subscribeChannel — substrate
+ *     auto-commits the cursor on a non-empty batch (at-most-once).
+ *   - `peek-ack`: peekChannel + ackChannel-after-emit. Survives
+ *     workflow crashes between "loomcycle returned the batch" and
+ *     "downstream node finished processing" (at-least-once).
+ *
+ * On any error, surfaces via emitError and waits one backoff before
+ * retrying. The outer abort signal breaks both error-retry sleep and
+ * the next long-poll round-trip.
+ */
+const CURSOR_KEY = 'channelMessageCursor';
+const MAX_CONSECUTIVE_FAILURES = 5;
+async function runSubscribeLoop(opts) {
+    let consecutiveFailures = 0;
+    while (!opts.signal.aborted) {
+        try {
+            const emitted = await subscribeOnce.call(this, opts);
+            consecutiveFailures = 0;
+            if (emitted === 0) {
+                // long-poll returned empty (timed out); loop immediately
+                continue;
+            }
+        }
+        catch (err) {
+            if (opts.signal.aborted)
+                return;
+            consecutiveFailures += 1;
+            if (consecutiveFailures >= MAX_CONSECUTIVE_FAILURES) {
+                // Terminal — bail out so n8n's trigger lifecycle deactivates
+                // rather than spinning indefinitely on (e.g.) a permanent
+                // ChannelCursorRegressionError on ack.
+                this.emitError(err);
+                return;
+            }
+            await sleep(opts.backoffMs, opts.signal);
+        }
+    }
+}
+/**
+ * Single long-poll round. Returns the number of messages emitted.
+ * Exposed as a separate function so manualTriggerFunction can do a
+ * one-shot listen.
+ */
+async function subscribeOnce(opts) {
+    if (opts.deliveryMode === 'peek-ack') {
+        const persistedCursor = (0, staticData_1.readCursor)(this, CURSOR_KEY);
+        const resp = await opts.client.peekChannel(opts.channel, {
+            scope: opts.scope,
+            userId: opts.userId,
+            fromCursor: persistedCursor || undefined,
+            maxMessages: opts.maxMessages,
+            signal: opts.signal,
+        });
+        const messages = resp.messages ?? [];
+        if (messages.length === 0) {
+            // Peek doesn't long-poll; sleep waitMs before next iteration
+            // so we don't spin.
+            await sleep(opts.waitMs, opts.signal);
+            return 0;
+        }
+        this.emit([this.helpers.returnJsonArray(messages.map((m) => m))]);
+        const lastCursor = messages[messages.length - 1].id;
+        await opts.client.ackChannel(opts.channel, {
+            scope: opts.scope,
+            userId: opts.userId,
+            cursor: lastCursor,
+            signal: opts.signal,
+        });
+        (0, staticData_1.writeCursor)(this, CURSOR_KEY, lastCursor);
+        return messages.length;
+    }
+    // auto-ack — direct subscribe
+    const resp = await opts.client.subscribeChannel(opts.channel, {
+        scope: opts.scope,
+        userId: opts.userId,
+        maxMessages: opts.maxMessages,
+        waitMs: opts.waitMs,
+        signal: opts.signal,
+    });
+    const messages = resp.messages ?? [];
+    if (messages.length === 0)
+        return 0;
+    this.emit([this.helpers.returnJsonArray(messages.map((m) => m))]);
+    return messages.length;
+}
+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=subscribe.js.map

package/dist/nodes/LoomCycleChannelMessage/helpers/subscribe.js.map

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

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

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

package/dist/nodes/LoomCycleChannelTool/LoomCycleChannelTool.node.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoomCycleChannelTool = 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 Channel Tool` — cluster sub-node exposing Channel Publish +
+ * Peek as a tool the AI Agent can call. (Subscribe is intentionally a
+ * trigger node, not a tool; Ack would couple to durable cursor state
+ * better handled by the action node.)
+ */
+const ChannelInputSchema = zod_1.z.object({
+    op: zod_1.z.enum(['publish', 'peek']).describe('Channel operation to invoke'),
+    channel: zod_1.z.string().describe('Channel name'),
+    scope: zod_1.z.enum(['global', 'user']).default('global').describe('Channel scope'),
+    userId: zod_1.z
+        .string()
+        .optional()
+        .describe('User_id for scope=user. Falls through to the credential default if empty.'),
+    payload: zod_1.z
+        .unknown()
+        .optional()
+        .describe('JSON-serialisable payload (publish only). Required for publish.'),
+    deliverAt: zod_1.z
+        .string()
+        .optional()
+        .describe('Optional RFC3339 deferred-delivery timestamp (publish only)'),
+    fromCursor: zod_1.z.string().optional().describe('Resume cursor (peek only). Empty = oldest non-expired row.'),
+    maxMessages: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Max messages to return (peek only). Defaults to 10 substrate-side.'),
+});
+class LoomCycleChannelTool {
+    constructor() {
+        this.description = {
+            displayName: 'LoomCycle Channel Tool',
+            name: 'loomCycleChannelTool',
+            icon: 'file:LoomCycleChannelTool.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Loomcycle Channel ops (publish + peek) as a tool the AI Agent can call',
+            defaults: { name: 'LoomCycle Channel 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_channel',
+                    required: true,
+                    description: 'Name of the tool surfaced to the parent AI Agent',
+                },
+                {
+                    displayName: 'Tool Description',
+                    name: 'toolDescription',
+                    type: 'string',
+                    typeOptions: { rows: 3 },
+                    default: 'Publish or peek at loomcycle channel messages. Use op=publish+channel+payload to publish; op=peek+channel to non-destructively read.',
+                    description: 'Description the AI Agent sees when deciding whether to call the tool',
+                },
+            ],
+        };
+    }
+    async supplyData() {
+        const toolName = this.getNodeParameter('toolName', 0, 'loomcycle_channel');
+        const toolDescription = this.getNodeParameter('toolDescription', 0, '');
+        const client = await (0, client_1.getClient)(this);
+        const credentialUserIdDefault = await (0, client_1.getCredentialDefault)(this, 'userId');
+        const tool = (0, clusterTool_1.buildTool)({
+            name: toolName,
+            description: toolDescription,
+            schema: ChannelInputSchema,
+            fn: async (args) => {
+                const scope = args.scope ?? 'global';
+                const userId = scope === 'user' ? args.userId || credentialUserIdDefault : undefined;
+                if (scope === 'user' && !userId) {
+                    throw new Error('userId required when scope=user (set on tool args or as credential default)');
+                }
+                if (args.op === 'publish') {
+                    if (args.payload === undefined) {
+                        throw new Error('payload is required for publish');
+                    }
+                    return client.publishChannel(args.channel, {
+                        scope,
+                        userId,
+                        payload: args.payload,
+                        deliverAt: args.deliverAt,
+                    });
+                }
+                // peek
+                return client.peekChannel(args.channel, {
+                    scope,
+                    userId,
+                    fromCursor: args.fromCursor,
+                    maxMessages: args.maxMessages,
+                });
+            },
+        });
+        return { response: tool };
+    }
+}
+exports.LoomCycleChannelTool = LoomCycleChannelTool;
+//# sourceMappingURL=LoomCycleChannelTool.node.js.map

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

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

package/dist/nodes/LoomCycleChannelTool/LoomCycleChannelTool.node.json

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

@@ -0,0 +1,13 @@
+<?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 Channel 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">
+    <path d="M16 22 L44 22"/>
+    <path d="M16 30 L44 30"/>
+    <path d="M16 38 L44 38"/>
+    <circle cx="14" cy="22" r="2" fill="#22d3ee"/>
+    <circle cx="46" cy="30" r="2" fill="#22d3ee"/>
+    <circle cx="14" cy="38" r="2" fill="#22d3ee"/>
+  </g>
+</svg>

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

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