@loomcycle/n8n-nodes-loomcycle 1.0.0

package/dist/nodes/LoomCycle/helpers/envVarHints.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Helpers for the MCPServerDef Register UI's "Required env vars on
+ * loomcycle" hint. Loomcycle's wire path substitutes `${LOOMCYCLE_FOO}`
+ * tokens in header values at request time using its own env (operator-
+ * managed); the n8n node never transmits a plaintext credential, only
+ * the template string. This module extracts the token names from a
+ * header collection so the node UI can render a "set these on the
+ * loomcycle deployment" reminder.
+ *
+ * See doc-internal/mcp-server-def-cross-repo.md §"The env-var-mirror UX
+ * gap" for the full rationale.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractEnvVarNames = extractEnvVarNames;
+exports.extractEnvVarsFromHeaders = extractEnvVarsFromHeaders;
+exports.formatEnvVarHint = formatEnvVarHint;
+const ENV_TOKEN_RE = /\$\{(LOOMCYCLE_[A-Z0-9_]+)(?::-[^}]*)?\}/g;
+/**
+ * Extract unique `${LOOMCYCLE_*}` env-var names referenced from a string.
+ * Supports the default-fallback form `${LOOMCYCLE_FOO:-default}` per the
+ * loomcycle v0.8.14 substitution grammar; the default value itself is
+ * ignored (loomcycle uses it; the operator still has to set the env to
+ * override).
+ */
+function extractEnvVarNames(text) {
+    if (!text)
+        return [];
+    const seen = new Set();
+    for (const match of text.matchAll(ENV_TOKEN_RE)) {
+        seen.add(match[1]);
+    }
+    return Array.from(seen).sort();
+}
+/**
+ * Extract env-var names from the typical "headers" n8n fixedCollection
+ * shape (`{ header: [{ name, value }, ...] }`).
+ */
+function extractEnvVarsFromHeaders(headers) {
+    if (!headers || typeof headers !== 'object')
+        return [];
+    const headerCollection = headers.header;
+    if (!Array.isArray(headerCollection))
+        return [];
+    const seen = new Set();
+    for (const entry of headerCollection) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const value = entry.value;
+        if (typeof value !== 'string')
+            continue;
+        for (const name of extractEnvVarNames(value)) {
+            seen.add(name);
+        }
+    }
+    return Array.from(seen).sort();
+}
+/**
+ * Compose the human-readable hint string the node UI surfaces under
+ * the Headers field. Empty when no env-var tokens are referenced.
+ */
+function formatEnvVarHint(names) {
+    if (names.length === 0)
+        return '';
+    return `Required env vars on the loomcycle deployment: ${names.join(', ')}. Set these in loomcycle's environment before registering; they substitute into the header values at request time.`;
+}
+//# sourceMappingURL=envVarHints.js.map

package/dist/nodes/LoomCycle/helpers/envVarHints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envVarHints.js","sourceRoot":"","sources":["../../../../nodes/LoomCycle/helpers/envVarHints.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAWH,gDAOC;AAMD,8DAcC;AAMD,4CAGC;AA7CD,MAAM,YAAY,GAAG,2CAA2C,CAAC;AAEjE;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,SAAgB,yBAAyB,CAAC,OAAgB;IACzD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,gBAAgB,GAAI,OAAgC,CAAC,MAAM,CAAC;IAClE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAAE,OAAO,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,KAAK,GAAI,KAA6B,CAAC,KAAK,CAAC;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QACxC,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,KAAe;IAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,kDAAkD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oHAAoH,CAAC;AAC/L,CAAC"}

package/dist/nodes/LoomCycle/helpers/errors.d.ts

@@ -0,0 +1,23 @@
+import type { INode } from 'n8n-workflow';
+/**
+ * Redact anything that LOOKS like a bearer token from a body string before
+ * surfacing it in NodeApiError.description (which renders in the n8n
+ * execution-log UI). CLAUDE.md §security.6: the bearer never leaks.
+ *
+ * Patterns covered:
+ *  - `Authorization: Bearer <token>` (case-insensitive)
+ *  - bare `Bearer <token>` substrings
+ *  - sk-* / lck-* / ant- style API-key-like tokens (best-effort defence in
+ *    depth; loomcycle bearers don't match these but operators may set
+ *    bearer values that do)
+ */
+export declare function redactBearerFragments(body: string): string;
+/**
+ * Map a `@loomcycle/client` typed error onto an n8n-flavoured error that
+ * renders well in the editor UI. The mapping is intentionally broad — every
+ * downstream wire call funnels through this single function so the
+ * credential-boundary-redaction rule lives in one place.
+ *
+ * Non-loomcycle errors pass through unchanged.
+ */
+export declare function wrapLoomcycleError(err: unknown, node: INode): Error;

package/dist/nodes/LoomCycle/helpers/errors.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactBearerFragments = redactBearerFragments;
+exports.wrapLoomcycleError = wrapLoomcycleError;
+const n8n_workflow_1 = require("n8n-workflow");
+const client_1 = require("@loomcycle/client");
+/**
+ * Redact anything that LOOKS like a bearer token from a body string before
+ * surfacing it in NodeApiError.description (which renders in the n8n
+ * execution-log UI). CLAUDE.md §security.6: the bearer never leaks.
+ *
+ * Patterns covered:
+ *  - `Authorization: Bearer <token>` (case-insensitive)
+ *  - bare `Bearer <token>` substrings
+ *  - sk-* / lck-* / ant- style API-key-like tokens (best-effort defence in
+ *    depth; loomcycle bearers don't match these but operators may set
+ *    bearer values that do)
+ */
+function redactBearerFragments(body) {
+    if (!body)
+        return body;
+    return body
+        .replace(/Authorization\s*:\s*Bearer\s+[\w.~+/=-]+/gi, 'Authorization: Bearer [REDACTED]')
+        .replace(/Bearer\s+[\w.~+/=-]{8,}/gi, 'Bearer [REDACTED]')
+        .replace(/\b(?:sk|lck|ant|sk-ant|sk-proj)-[\w-]{12,}/gi, '[REDACTED]');
+}
+/**
+ * Map a `@loomcycle/client` typed error onto an n8n-flavoured error that
+ * renders well in the editor UI. The mapping is intentionally broad — every
+ * downstream wire call funnels through this single function so the
+ * credential-boundary-redaction rule lives in one place.
+ *
+ * Non-loomcycle errors pass through unchanged.
+ */
+function wrapLoomcycleError(err, node) {
+    if (err instanceof client_1.AuthError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Authentication failed',
+            description: 'The bearer token in the LoomCycle API credential was rejected. Check Settings → Credentials.',
+            httpCode: '401',
+        });
+    }
+    if (err instanceof client_1.AgentNotFoundError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Agent not found',
+            description: redactBearerFragments(err.bodyText ?? 'The agent_id was not found on this loomcycle deployment.'),
+            httpCode: '404',
+        });
+    }
+    if (err instanceof client_1.SessionNotFoundError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Session not found',
+            description: redactBearerFragments(err.bodyText ?? 'The session_id was not found.'),
+            httpCode: '404',
+        });
+    }
+    if (err instanceof client_1.SnapshotNotFoundError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Snapshot not found',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '404',
+        });
+    }
+    if (err instanceof client_1.HookNotFoundError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Hook not found',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '404',
+        });
+    }
+    if (err instanceof client_1.NotFoundError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Resource not found',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '404',
+        });
+    }
+    if (err instanceof client_1.InvalidArgumentError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Invalid argument',
+            description: redactBearerFragments(err.bodyText ?? err.message),
+            httpCode: '400',
+        });
+    }
+    if (err instanceof client_1.SubstrateToolRefusedError) {
+        const tool = err.tool ? `${err.tool} ` : '';
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: `Substrate ${tool}refused the operation`,
+            description: redactBearerFragments(err.bodyText ?? err.message),
+            httpCode: '422',
+        });
+    }
+    if (err instanceof client_1.BackpressureError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Backpressure — too many in-flight requests',
+            description: redactBearerFragments(err.bodyText ?? 'Retry with backoff.'),
+            httpCode: '429',
+        });
+    }
+    if (err instanceof client_1.AlreadyPausingError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Runtime is already pausing or paused',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '409',
+        });
+    }
+    if (err instanceof client_1.ChannelCursorRegressionError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Channel cursor regression — supplied cursor is older than the committed cursor',
+            description: redactBearerFragments(err.bodyText ?? 'Re-fetch the channel\'s current committed cursor via subscribeChannel and retry the Ack.'),
+            httpCode: '409',
+        });
+    }
+    if (err instanceof client_1.NotPausedError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Runtime is not paused',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '409',
+        });
+    }
+    if (err instanceof client_1.PauseNotConfiguredError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Pause subsystem is not configured on this loomcycle deployment',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '503',
+        });
+    }
+    if (err instanceof client_1.SnapshotTooLargeError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Snapshot too large for this operation',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '413',
+        });
+    }
+    if (err instanceof client_1.SnapshotVersionError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Snapshot envelope version mismatch',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '422',
+        });
+    }
+    if (err instanceof client_1.SessionBusyError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Session is busy',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '409',
+        });
+    }
+    if (err instanceof client_1.AgentIDInUseError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'agent_id is already in use',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '409',
+        });
+    }
+    if (err instanceof client_1.UnavailableError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: 'Loomcycle backend unavailable',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: '503',
+        });
+    }
+    if (err instanceof client_1.LoomcycleError) {
+        return new n8n_workflow_1.NodeApiError(node, jsonifyError(err), {
+            message: err.message || 'Loomcycle wire error',
+            description: redactBearerFragments(err.bodyText ?? ''),
+            httpCode: err.status !== undefined ? String(err.status) : '500',
+        });
+    }
+    if (err instanceof Error) {
+        return new n8n_workflow_1.NodeOperationError(node, err.message);
+    }
+    return new n8n_workflow_1.NodeOperationError(node, 'Unknown error from loomcycle');
+}
+/**
+ * Coerce a LoomcycleError-shaped object into the JsonObject that
+ * NodeApiError expects in its second positional argument. The wire
+ * adapter's typed errors are real Error subclasses; n8n wants a plain
+ * object. Manual shape — we don't pass the original error instance
+ * because NodeApiError may serialise it and leak fields.
+ */
+function jsonifyError(err) {
+    return {
+        name: err.constructor.name,
+        message: err.message,
+        status: err.status ?? null,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/nodes/LoomCycle/helpers/errors.js.map

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

package/dist/nodes/LoomCycle/helpers/loadOptions.d.ts

@@ -0,0 +1,24 @@
+import type { ILoadOptionsFunctions, INodePropertyOptions } from 'n8n-workflow';
+/**
+ * loadOptions methods for dynamic n8n parameter dropdowns.
+ *
+ * Each method MUST be defensive — n8n re-evaluates loadOptions on every
+ * parameter render, so failures here block the operator from configuring
+ * the node. On any error, return a single instructional placeholder
+ * option so the dropdown remains usable (the operator can switch to
+ * manual entry via the "Use Expression" toggle).
+ */
+/**
+ * List agent names currently active for the credential's default user_id.
+ * Returns recent / running agent definitions visible via /v1/users/{id}/agents.
+ */
+export declare function loadAgents(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/**
+ * List declared channels via GET /v1/_channels (admin endpoint;
+ * shipped in loomcycle v0.9.x PR #173).
+ */
+export declare function loadChannels(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/**
+ * List known Memory scopes via GET /v1/_memory/scopes.
+ */
+export declare function loadMemoryScopes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;

package/dist/nodes/LoomCycle/helpers/loadOptions.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAgents = loadAgents;
+exports.loadChannels = loadChannels;
+exports.loadMemoryScopes = loadMemoryScopes;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+/**
+ * Build the dropdown's instructional fallback option after a failed
+ * loadOptions call. The message MUST run through `redactBearerFragments`
+ * because the wire-error string can echo back server-side header fragments
+ * (CLAUDE.md §security.6 — the bearer never reaches operator UIs).
+ */
+function failedToLoadOption(label, err) {
+    const msg = (0, errors_1.redactBearerFragments)(err.message ?? '');
+    return { name: `— failed to load ${label} (${msg}); type the name manually —`, value: '' };
+}
+/**
+ * loadOptions methods for dynamic n8n parameter dropdowns.
+ *
+ * Each method MUST be defensive — n8n re-evaluates loadOptions on every
+ * parameter render, so failures here block the operator from configuring
+ * the node. On any error, return a single instructional placeholder
+ * option so the dropdown remains usable (the operator can switch to
+ * manual entry via the "Use Expression" toggle).
+ */
+/**
+ * List agent names currently active for the credential's default user_id.
+ * Returns recent / running agent definitions visible via /v1/users/{id}/agents.
+ */
+async function loadAgents() {
+    try {
+        const userId = await (0, client_1.getCredentialDefault)(this, 'userId');
+        if (!userId) {
+            return [
+                {
+                    name: '— set Default User ID on the credential to enable dropdown, or type the agent name manually —',
+                    value: '',
+                },
+            ];
+        }
+        const client = await (0, client_1.getClient)(this);
+        const agents = await client.listUserAgents(userId);
+        const names = Array.from(new Set(agents.map((a) => a.agent))).sort();
+        if (names.length === 0) {
+            return [{ name: '— no running agents for this user; type the agent name manually —', value: '' }];
+        }
+        return names.map((name) => ({ name, value: name }));
+    }
+    catch (err) {
+        return [failedToLoadOption('agents', err)];
+    }
+}
+/**
+ * List declared channels via GET /v1/_channels (admin endpoint;
+ * shipped in loomcycle v0.9.x PR #173).
+ */
+async function loadChannels() {
+    try {
+        const client = await (0, client_1.getClient)(this);
+        const resp = await client.listChannels();
+        const names = resp.channels.map((c) => c.name).sort();
+        if (names.length === 0) {
+            return [{ name: '— no channels declared in operator yaml; type the channel name manually —', value: '' }];
+        }
+        return names.map((name) => ({ name, value: name }));
+    }
+    catch (err) {
+        return [failedToLoadOption('channels', err)];
+    }
+}
+/**
+ * List known Memory scopes via GET /v1/_memory/scopes.
+ */
+async function loadMemoryScopes() {
+    try {
+        const client = await (0, client_1.getClient)(this);
+        const resp = await client.listMemoryScopes();
+        const names = resp.scopes.map((s) => s.name).sort();
+        if (names.length === 0) {
+            return [{ name: '— no memory scopes; type the scope name manually —', value: '' }];
+        }
+        return names.map((name) => ({ name, value: name }));
+    }
+    catch (err) {
+        return [failedToLoadOption('scopes', err)];
+    }
+}
+//# sourceMappingURL=loadOptions.js.map

package/dist/nodes/LoomCycle/helpers/loadOptions.js.map

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

package/dist/nodes/LoomCycle/helpers/segments.d.ts

@@ -0,0 +1,13 @@
+import type { PromptSegment } from '@loomcycle/client';
+/**
+ * Wrap an operator-supplied prompt string into the PromptSegment[] shape
+ * loomcycle's runStreaming expects.
+ *
+ * By default the prompt is wrapped as `trusted-text` — appropriate for
+ * operator-authored prompts. When the caller knows the prompt contains
+ * user-supplied content (e.g. a Slack message body, an HTTP webhook
+ * payload), they should set `asUntrusted: true` to use the
+ * `untrusted-block` segment kind, which loomcycle treats as data rather
+ * than instruction.
+ */
+export declare function buildSegments(prompt: string, asUntrusted?: boolean): PromptSegment[];

package/dist/nodes/LoomCycle/helpers/segments.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSegments = buildSegments;
+/**
+ * Wrap an operator-supplied prompt string into the PromptSegment[] shape
+ * loomcycle's runStreaming expects.
+ *
+ * By default the prompt is wrapped as `trusted-text` — appropriate for
+ * operator-authored prompts. When the caller knows the prompt contains
+ * user-supplied content (e.g. a Slack message body, an HTTP webhook
+ * payload), they should set `asUntrusted: true` to use the
+ * `untrusted-block` segment kind, which loomcycle treats as data rather
+ * than instruction.
+ */
+function buildSegments(prompt, asUntrusted = false) {
+    if (asUntrusted) {
+        return [
+            {
+                role: 'user',
+                content: [{ type: 'untrusted-block', kind: 'text', text: prompt }],
+            },
+        ];
+    }
+    return [
+        {
+            role: 'user',
+            content: [{ type: 'trusted-text', text: prompt }],
+        },
+    ];
+}
+//# sourceMappingURL=segments.js.map

package/dist/nodes/LoomCycle/helpers/segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.js","sourceRoot":"","sources":["../../../../nodes/LoomCycle/helpers/segments.ts"],"names":[],"mappings":";;AAaA,sCAeC;AA1BD;;;;;;;;;;GAUG;AACH,SAAgB,aAAa,CAAC,MAAc,EAAE,WAAW,GAAG,KAAK;IAChE,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO;YACN;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;aAClE;SACD,CAAC;IACH,CAAC;IACD,OAAO;QACN;YACC,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACjD;KACD,CAAC;AACH,CAAC"}

package/dist/nodes/LoomCycle/helpers/staticData.d.ts

@@ -0,0 +1,5 @@
+import type { IPollFunctions, ITriggerFunctions } from 'n8n-workflow';
+export declare function readSeenSet(ctx: IPollFunctions | ITriggerFunctions, key: string): Set<string>;
+export declare function writeSeenSet(ctx: IPollFunctions | ITriggerFunctions, key: string, seen: Set<string>, cap?: number): void;
+export declare function readCursor(ctx: IPollFunctions | ITriggerFunctions, key: string): string;
+export declare function writeCursor(ctx: IPollFunctions | ITriggerFunctions, key: string, cursor: string): void;

package/dist/nodes/LoomCycle/helpers/staticData.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSeenSet = readSeenSet;
+exports.writeSeenSet = writeSeenSet;
+exports.readCursor = readCursor;
+exports.writeCursor = writeCursor;
+const DEFAULT_CAP = 1000;
+function readSeenSet(ctx, key) {
+    const data = ctx.getWorkflowStaticData('node');
+    const slot = (data[key] ?? {});
+    return new Set(slot.seen ?? []);
+}
+function writeSeenSet(ctx, key, seen, cap = DEFAULT_CAP) {
+    const trimmed = seen.size > cap ? new Set(Array.from(seen).slice(-cap)) : seen;
+    const data = ctx.getWorkflowStaticData('node');
+    const slot = (data[key] ?? {});
+    slot.seen = Array.from(trimmed);
+    data[key] = slot;
+}
+function readCursor(ctx, key) {
+    const data = ctx.getWorkflowStaticData('node');
+    const slot = (data[key] ?? {});
+    return slot.cursor ?? '';
+}
+function writeCursor(ctx, key, cursor) {
+    const data = ctx.getWorkflowStaticData('node');
+    const slot = (data[key] ?? {});
+    slot.cursor = cursor;
+    data[key] = slot;
+}
+//# sourceMappingURL=staticData.js.map

package/dist/nodes/LoomCycle/helpers/staticData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticData.js","sourceRoot":"","sources":["../../../../nodes/LoomCycle/helpers/staticData.ts"],"names":[],"mappings":";;AAsBA,kCAOC;AAED,oCAWC;AAED,gCAOC;AAED,kCASC;AA1CD,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,SAAgB,WAAW,CAC1B,GAAuC,EACvC,GAAW;IAEX,MAAM,IAAI,GAAG,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAgB,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;IAC7C,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,YAAY,CAC3B,GAAuC,EACvC,GAAW,EACX,IAAiB,EACjB,GAAG,GAAG,WAAW;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,MAAM,IAAI,GAAG,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAgB,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;IAC7C,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,SAAgB,UAAU,CACzB,GAAuC,EACvC,GAAW;IAEX,MAAM,IAAI,GAAG,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAgB,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;IAC7C,OAAO,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,SAAgB,WAAW,CAC1B,GAAuC,EACvC,GAAW,EACX,MAAc;IAEd,MAAM,IAAI,GAAG,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAgB,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;IAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/nodes/LoomCycle/helpers/streaming.d.ts

@@ -0,0 +1,31 @@
+import type { AgentEvent, Usage } from '@loomcycle/client';
+/**
+ * Result of draining a runStreaming() iterable into a single n8n output.
+ *
+ * Action nodes block their execute() until the run completes — long runs
+ * are better expressed via the LoomCycleRunCompleted trigger (Sub-phase
+ * 2.3). This shape is what the action node returns to downstream nodes.
+ *
+ * **No `events` array.** Long agent runs can emit thousands of frames;
+ * bundling them all into the result inflates n8n's execution-record
+ * storage and risks running the worker out of memory under bulk input.
+ * Downstream nodes that need event-level visibility should consume the
+ * SSE stream directly via the LoomCycleRunCompleted trigger.
+ */
+export interface RunDrainResult {
+    finalText: string;
+    usage?: Usage;
+    stopReason?: string;
+    sessionId?: string;
+    agentId?: string;
+    runId?: string;
+}
+/**
+ * Drain an async-iterable of AgentEvents into a structured summary.
+ *
+ * `event: error` frames (or any frame with `is_error: true`) cause the
+ * function to throw — the action node's `wrapLoomcycleError` catches and
+ * surfaces them as NodeApiError. Other event types fold into the compact
+ * summary returned.
+ */
+export declare function drainRunStream(stream: AsyncIterable<AgentEvent>): Promise<RunDrainResult>;

package/dist/nodes/LoomCycle/helpers/streaming.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.drainRunStream = drainRunStream;
+/**
+ * Drain an async-iterable of AgentEvents into a structured summary.
+ *
+ * `event: error` frames (or any frame with `is_error: true`) cause the
+ * function to throw — the action node's `wrapLoomcycleError` catches and
+ * surfaces them as NodeApiError. Other event types fold into the compact
+ * summary returned.
+ */
+async function drainRunStream(stream) {
+    let finalText = '';
+    let usage;
+    let stopReason;
+    let sessionId;
+    let agentId;
+    let runId;
+    let errorMessage;
+    for await (const ev of stream) {
+        if (ev.type === 'text' && typeof ev.text === 'string') {
+            finalText += ev.text;
+        }
+        if (ev.type === 'usage' && ev.usage) {
+            usage = ev.usage;
+        }
+        if (ev.type === 'done' && ev.stop_reason) {
+            stopReason = ev.stop_reason;
+        }
+        if (ev.type === 'session' && ev.session_id) {
+            sessionId = ev.session_id;
+        }
+        if (ev.type === 'agent') {
+            if (ev.agent_id)
+                agentId = ev.agent_id;
+            if (ev.run_id)
+                runId = ev.run_id;
+        }
+        if (ev.type === 'error' || ev.is_error === true) {
+            errorMessage = ev.error ?? 'unknown error from loomcycle';
+        }
+    }
+    if (errorMessage) {
+        throw new Error(errorMessage);
+    }
+    return { finalText, usage, stopReason, sessionId, agentId, runId };
+}
+//# sourceMappingURL=streaming.js.map

package/dist/nodes/LoomCycle/helpers/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../../../nodes/LoomCycle/helpers/streaming.ts"],"names":[],"mappings":";;AAgCA,wCAoCC;AA5CD;;;;;;;GAOG;AACI,KAAK,UAAU,cAAc,CAAC,MAAiC;IACrE,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,KAAwB,CAAC;IAC7B,IAAI,UAA8B,CAAC;IACnC,IAAI,SAA6B,CAAC;IAClC,IAAI,OAA2B,CAAC;IAChC,IAAI,KAAyB,CAAC;IAC9B,IAAI,YAAgC,CAAC;IAErC,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QAC/B,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,SAAS,IAAI,EAAE,CAAC,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACrC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;QAClB,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC1C,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC;QAC7B,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;YAC5C,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC;QAC3B,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC,QAAQ;gBAAE,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC;YACvC,IAAI,EAAE,CAAC,MAAM;gBAAE,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC;QAClC,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACjD,YAAY,GAAG,EAAE,CAAC,KAAK,IAAI,8BAA8B,CAAC;QAC3D,CAAC;IACF,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { INodeType, INodeTypeDescription, ITriggerFunctions, ITriggerResponse } from 'n8n-workflow';
+import { loadChannels } from '../LoomCycle/helpers/loadOptions';
+/**
+ * `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.
+ */
+export declare class LoomCycleChannelMessage implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            loadChannels: typeof loadChannels;
+        };
+    };
+    trigger(this: ITriggerFunctions): Promise<ITriggerResponse>;
+}