@loomcycle/n8n-nodes-loomcycle 1.0.0

package/dist/nodes/LoomCycle/descriptions/runs.d.ts

@@ -0,0 +1,17 @@
+import type { INodeProperties } from 'n8n-workflow';
+/**
+ * Operation descriptions for the `run` resource of the LoomCycle umbrella
+ * node. Five ops:
+ *   - Spawn         → runStreaming (drained synchronously)
+ *   - Get Status    → getAgent
+ *   - Wait          → poll getAgent until terminal state
+ *   - Cancel        → cancelAgent (cascades via parent_agent_id)
+ *   - List Agents   → listUserAgents
+ *
+ * Long runs block the node's execute(); operators wanting async semantics
+ * should use the LoomCycle: Run Completed trigger (Sub-phase 2.3).
+ *
+ * Options arrays are alphabetised by name per the n8n-nodes-base
+ * convention (default values are selected by `value`, not array position).
+ */
+export declare const runOps: INodeProperties[];

package/dist/nodes/LoomCycle/descriptions/runs.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runOps = void 0;
+/**
+ * Operation descriptions for the `run` resource of the LoomCycle umbrella
+ * node. Five ops:
+ *   - Spawn         → runStreaming (drained synchronously)
+ *   - Get Status    → getAgent
+ *   - Wait          → poll getAgent until terminal state
+ *   - Cancel        → cancelAgent (cascades via parent_agent_id)
+ *   - List Agents   → listUserAgents
+ *
+ * Long runs block the node's execute(); operators wanting async semantics
+ * should use the LoomCycle: Run Completed trigger (Sub-phase 2.3).
+ *
+ * Options arrays are alphabetised by name per the n8n-nodes-base
+ * convention (default values are selected by `value`, not array position).
+ */
+exports.runOps = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: { show: { resource: ['run'] } },
+        options: [
+            {
+                name: 'Cancel',
+                value: 'cancel',
+                description: 'Cancel a running agent (cascades to children via parent_agent_id)',
+                action: 'Cancel a run',
+            },
+            {
+                name: 'Get Status',
+                value: 'getStatus',
+                description: 'Fetch the current state of a running or completed agent',
+                action: 'Get run status',
+            },
+            {
+                name: 'List Agents',
+                value: 'listAgents',
+                description: 'List recent / running agents for a user_id',
+                action: 'List agents for a user',
+            },
+            {
+                name: 'Spawn',
+                value: 'spawn',
+                description: 'Spawn a new loomcycle agent run and wait synchronously for completion',
+                action: 'Spawn a run',
+            },
+            {
+                name: 'Wait for Completion',
+                value: 'wait',
+                description: 'Poll until the agent reaches a terminal state (completed/failed/cancelled)',
+                action: 'Wait for completion',
+            },
+        ],
+        default: 'spawn',
+    },
+    // ---- Spawn parameters ----
+    {
+        displayName: 'Agent Name or ID',
+        name: 'agent',
+        type: 'options',
+        typeOptions: { loadOptionsMethod: 'loadAgents' },
+        default: '',
+        required: true,
+        displayOptions: { show: { resource: ['run'], operation: ['spawn'] } },
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+    },
+    {
+        displayName: 'Prompt',
+        name: 'prompt',
+        type: 'string',
+        typeOptions: { rows: 4 },
+        default: '',
+        required: true,
+        displayOptions: { show: { resource: ['run'], operation: ['spawn'] } },
+        description: 'User prompt sent to the agent — wrapped as a trusted-text segment by default',
+    },
+    {
+        displayName: 'User ID',
+        name: 'userId',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { resource: ['run'], operation: ['spawn'] } },
+        description: 'Override the credential\'s Default User ID for this run. Leave empty to use the credential default.',
+    },
+    {
+        displayName: 'User Tier',
+        name: 'userTier',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { resource: ['run'], operation: ['spawn'] } },
+        description: 'Override the credential\'s Default User Tier for this run. Leave empty to use the credential default.',
+    },
+    {
+        displayName: 'Treat Prompt as Untrusted',
+        name: 'treatPromptAsUntrusted',
+        type: 'boolean',
+        default: false,
+        displayOptions: { show: { resource: ['run'], operation: ['spawn'] } },
+        description: 'Whether to wrap the prompt as an untrusted-block segment instead of trusted-text. Enable when the prompt contains end-user input (e.g. a Slack message body) that the agent should treat as data, not instruction.',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: { show: { resource: ['run'], operation: ['spawn'] } },
+        options: [
+            {
+                displayName: 'Agent ID',
+                name: 'agentId',
+                type: 'string',
+                default: '',
+                description: 'Caller-supplied agent_id. Loomcycle generates one if empty.',
+            },
+            {
+                displayName: 'Allowed Hosts (Comma-Separated)',
+                name: 'allowedHosts',
+                type: 'string',
+                default: '',
+                description: 'Comma-separated host allowlist for the HTTP / WebFetch / WebSearch tools. Empty = use the operator floor.',
+            },
+            {
+                displayName: 'Allowed Tools (Comma-Separated)',
+                name: 'allowedTools',
+                type: 'string',
+                default: '',
+                description: 'Comma-separated tool-name list to narrow the agent\'s allowed_tools beyond the operator floor. Empty = no narrowing.',
+            },
+            {
+                displayName: 'Session ID',
+                name: 'sessionId',
+                type: 'string',
+                default: '',
+                description: 'Existing session_id to continue. Leave empty to start a fresh session.',
+            },
+            {
+                displayName: 'User Bearer',
+                name: 'userBearer',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'Per-end-user bearer token substituted into MCP server headers via the ${run.user_bearer} pattern (v0.8.14+)',
+            },
+            {
+                displayName: 'Web Search Host Filter',
+                name: 'webSearchFilter',
+                type: 'options',
+                default: '',
+                options: [
+                    { name: 'Default (Off)', value: '' },
+                    { name: 'Drop — Filter Out Allowed-Hosts', value: 'drop' },
+                    { name: 'Keep — Filter In Allowed-Hosts', value: 'keep' },
+                ],
+                description: 'Optional Brave-side host-filtering behaviour for the WebSearch tool. Only meaningful when Allowed Hosts is also set on this run.',
+            },
+        ],
+    },
+    // ---- Get Status / Wait / Cancel: shared Agent ID ----
+    {
+        displayName: 'Agent ID',
+        name: 'agentId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { resource: ['run'], operation: ['getStatus', 'wait', 'cancel'] } },
+        description: 'The agent_id of the run to inspect / wait on / cancel',
+    },
+    // ---- Wait-specific ----
+    {
+        displayName: 'Poll Interval (Ms)',
+        name: 'pollIntervalMs',
+        type: 'number',
+        default: 1000,
+        typeOptions: { minValue: 250, maxValue: 60000 },
+        displayOptions: { show: { resource: ['run'], operation: ['wait'] } },
+        description: 'How frequently to poll getAgent while waiting. Lower values yield faster detection at the cost of more HTTP calls.',
+    },
+    {
+        displayName: 'Timeout (Seconds)',
+        name: 'timeoutSec',
+        type: 'number',
+        default: 300,
+        typeOptions: { minValue: 5, maxValue: 86400 },
+        displayOptions: { show: { resource: ['run'], operation: ['wait'] } },
+        description: 'Maximum seconds to wait before giving up. Exceeding this throws a workflow error.',
+    },
+    // ---- Cancel reason ----
+    {
+        displayName: 'Reason',
+        name: 'reason',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { resource: ['run'], operation: ['cancel'] } },
+        description: 'Operator-visible reason recorded with the cancellation',
+    },
+    // ---- List Agents ----
+    {
+        displayName: 'User ID',
+        name: 'userId',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { resource: ['run'], operation: ['listAgents'] } },
+        description: 'User_id to list agents for. Empty = use the credential\'s Default User ID.',
+    },
+    {
+        displayName: 'Status Filter',
+        name: 'statusFilter',
+        type: 'options',
+        default: '',
+        displayOptions: { show: { resource: ['run'], operation: ['listAgents'] } },
+        options: [
+            { name: 'All', value: '' },
+            { name: 'Cancelled', value: 'cancelled' },
+            { name: 'Completed', value: 'completed' },
+            { name: 'Failed', value: 'failed' },
+            { name: 'Running', value: 'running' },
+        ],
+        description: 'Filter the listing by run status',
+    },
+];
+//# sourceMappingURL=runs.js.map

package/dist/nodes/LoomCycle/descriptions/runs.js.map

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

package/dist/nodes/LoomCycle/descriptions/skilldef.d.ts

@@ -0,0 +1,10 @@
+import type { INodeProperties } from 'n8n-workflow';
+/**
+ * Operation descriptions for the `skillDef` resource — substrate-admin
+ * management of versioned skill definitions (v0.8.22+). 7 ops mapping
+ * to `client.skillDef({op})`. Mirrors agentDef exactly; skill-specific
+ * overlay fields (body, allowed_tools) live inside the overlay JSON.
+ *
+ * Op options array is alphabetised by name.
+ */
+export declare const skillDefOps: INodeProperties[];

package/dist/nodes/LoomCycle/descriptions/skilldef.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillDefOps = void 0;
+/**
+ * Operation descriptions for the `skillDef` resource — substrate-admin
+ * management of versioned skill definitions (v0.8.22+). 7 ops mapping
+ * to `client.skillDef({op})`. Mirrors agentDef exactly; skill-specific
+ * overlay fields (body, allowed_tools) live inside the overlay JSON.
+ *
+ * Op options array is alphabetised by name.
+ */
+exports.skillDefOps = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: { show: { resource: ['skillDef'] } },
+        options: [
+            {
+                name: 'Create',
+                value: 'create',
+                description: 'Register a new skill definition (initial version)',
+                action: 'Create a skill definition',
+            },
+            {
+                name: 'Fork',
+                value: 'fork',
+                description: 'Branch from an existing def_id with an overlay diff',
+                action: 'Fork a skill definition',
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                description: 'Return the active row for a name',
+                action: 'Get a skill definition',
+            },
+            {
+                name: 'List Versions',
+                value: 'list',
+                description: 'List all versions for a name (lineage tree)',
+                action: 'List skill definition versions',
+            },
+            {
+                name: 'Promote',
+                value: 'promote',
+                description: 'Make a specific def_id the active version',
+                action: 'Promote a skill definition',
+            },
+            {
+                name: 'Retire',
+                value: 'retire',
+                description: 'Mark a def_id (or active row for a name) as retired',
+                action: 'Retire a skill definition',
+            },
+            {
+                name: 'Verify',
+                value: 'verify',
+                description: 'Compare a content_sha256 against the deployed active row',
+                action: 'Verify a skill definition hash',
+            },
+        ],
+        default: 'list',
+    },
+    // ---- Name (used by Get / List / Create / Retire / Verify) ----
+    {
+        displayName: 'Name',
+        name: 'name',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+            show: { resource: ['skillDef'], operation: ['get', 'list', 'create', 'retire', 'verify'] },
+        },
+        description: 'Skill definition name (matches the skill\'s yaml frontmatter / .md filename stem)',
+    },
+    // ---- Def ID (Promote / Retire) ----
+    {
+        displayName: 'Def ID',
+        name: 'defId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { resource: ['skillDef'], operation: ['promote'] } },
+        description: 'Specific def_id to act on. Versions are returned by List Versions.',
+    },
+    {
+        displayName: 'Def ID (Optional)',
+        name: 'defId',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { resource: ['skillDef'], operation: ['retire'] } },
+        description: 'Specific def_id to retire. Leave empty to retire the active version of the name above.',
+    },
+    // ---- Parent Def ID (Fork) ----
+    {
+        displayName: 'Parent Def ID',
+        name: 'parentDefId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { resource: ['skillDef'], operation: ['fork'] } },
+        description: 'Def_id of the row to fork. The new row inherits all fields not present in the overlay.',
+    },
+    // ---- Description (Create / Fork) ----
+    {
+        displayName: 'Description',
+        name: 'defDescription',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { resource: ['skillDef'], operation: ['create', 'fork'] } },
+        description: 'Operator-visible description of this version',
+    },
+    // ---- Overlay JSON (Create / Fork) ----
+    {
+        displayName: 'Overlay (JSON)',
+        name: 'overlay',
+        type: 'json',
+        default: '{}',
+        typeOptions: { rows: 6 },
+        displayOptions: { show: { resource: ['skillDef'], operation: ['create', 'fork'] } },
+        description: 'JSON object with the skill\'s content-bearing fields (body, allowed_tools, description, etc.). Merged onto parent for Fork; defines initial row for Create.',
+    },
+    // ---- Promote-After-Create (Create / Fork) ----
+    {
+        displayName: 'Promote to Active',
+        name: 'promote',
+        type: 'boolean',
+        default: false,
+        displayOptions: { show: { resource: ['skillDef'], operation: ['create', 'fork'] } },
+        description: 'Whether to auto-promote the new version to active immediately',
+    },
+    // ---- Content SHA256 (Verify) ----
+    {
+        displayName: 'Content SHA256',
+        name: 'contentSha256',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { resource: ['skillDef'], operation: ['verify'] } },
+        description: 'Local content_sha256 (typically from `loomcycle hash skill <path>`) to compare against the deployed active row',
+    },
+];
+//# sourceMappingURL=skilldef.js.map

package/dist/nodes/LoomCycle/descriptions/skilldef.js.map

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

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

@@ -0,0 +1,42 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, ITriggerFunctions, ISupplyDataFunctions } from 'n8n-workflow';
+/**
+ * Loomcycle-version gating for ops that depend on a substrate-side
+ * feature shipped in a specific version.
+ *
+ * In 2.2 + 2.4 this is exercised by MCPServerDef (substrate landed in
+ * loomcycle v0.9.2 PR #177). The gate code path remains for
+ * forward-compat against future-feature additions and for the rare case
+ * of an operator running pre-v0.9.2 loomcycle. Surface a clean
+ * NodeOperationError("Requires loomcycle vX.Y") so the operator UI
+ * shows the right next-step.
+ *
+ * The gate calls health() (unauthenticated, cheap) and parses the
+ * returned `version` field. n8n re-enters the node's execute per item;
+ * the per-execution caller is expected to cache the result.
+ */
+export interface ParsedSemver {
+    major: number;
+    minor: number;
+    patch: number;
+    raw: string;
+}
+/**
+ * Parse a `v<major>.<minor>.<patch>` string, returning {0,0,0,raw}
+ * when parsing fails (so comparisons against a real minimum reject).
+ */
+export declare function parseSemver(input: string | undefined): ParsedSemver;
+/**
+ * Return true when `actual` is `>= minimum`. Component-wise comparison;
+ * all three fields must be parsed cleanly to count.
+ */
+export declare function semverGte(actual: ParsedSemver, minimum: ParsedSemver): boolean;
+/**
+ * Throw NodeOperationError when the connected loomcycle is older than
+ * `minVersion` (e.g. "0.9.2"). Use sparingly — every call is a wire
+ * round-trip; cache the result across an execution.
+ *
+ * Empty / unparseable version strings are treated as "too old" so the
+ * gate fails closed. Operators running a build without `version`
+ * embedded should upgrade.
+ */
+export declare function requireLoomcycleVersion(ctx: IExecuteFunctions | ILoadOptionsFunctions | ITriggerFunctions | ISupplyDataFunctions, minVersion: string, featureLabel: string): Promise<void>;

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

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSemver = parseSemver;
+exports.semverGte = semverGte;
+exports.requireLoomcycleVersion = requireLoomcycleVersion;
+const n8n_workflow_1 = require("n8n-workflow");
+const client_1 = require("./client");
+/**
+ * Parse a `v<major>.<minor>.<patch>` string, returning {0,0,0,raw}
+ * when parsing fails (so comparisons against a real minimum reject).
+ */
+function parseSemver(input) {
+    const raw = (input ?? '').trim();
+    const match = raw.replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match)
+        return { major: 0, minor: 0, patch: 0, raw };
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        raw,
+    };
+}
+/**
+ * Return true when `actual` is `>= minimum`. Component-wise comparison;
+ * all three fields must be parsed cleanly to count.
+ */
+function semverGte(actual, minimum) {
+    if (actual.major !== minimum.major)
+        return actual.major > minimum.major;
+    if (actual.minor !== minimum.minor)
+        return actual.minor > minimum.minor;
+    return actual.patch >= minimum.patch;
+}
+/**
+ * Throw NodeOperationError when the connected loomcycle is older than
+ * `minVersion` (e.g. "0.9.2"). Use sparingly — every call is a wire
+ * round-trip; cache the result across an execution.
+ *
+ * Empty / unparseable version strings are treated as "too old" so the
+ * gate fails closed. Operators running a build without `version`
+ * embedded should upgrade.
+ */
+async function requireLoomcycleVersion(ctx, minVersion, featureLabel) {
+    const client = await (0, client_1.getClient)(ctx);
+    const health = await client.health();
+    const actual = parseSemver(health.version);
+    const minimum = parseSemver(minVersion);
+    if (!semverGte(actual, minimum)) {
+        const got = actual.raw || '(empty)';
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `${featureLabel} requires loomcycle ≥ v${minVersion}. The connected loomcycle reports version ${got}.`);
+    }
+}
+//# sourceMappingURL=capability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../../../nodes/LoomCycle/helpers/capability.ts"],"names":[],"mappings":";;AA+BA,kCAUC;AAMD,8BAIC;AAWD,0DAgBC;AA7ED,+CAAkD;AAClD,qCAAqC;AAyBrC;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAyB;IACpD,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACzD,OAAO;QACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,GAAG;KACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,MAAoB,EAAE,OAAqB;IACpE,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACxE,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACxE,OAAO,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;AACtC,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,uBAAuB,CAC5C,GAAyF,EACzF,UAAkB,EAClB,YAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAS,EAAC,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,SAAS,CAAC;QACpC,MAAM,IAAI,iCAAkB,CAC1B,GAAyB,CAAC,OAAO,EAAE,EACpC,GAAG,YAAY,0BAA0B,UAAU,6CAA6C,GAAG,GAAG,CACtG,CAAC;IACH,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, ITriggerFunctions, ISupplyDataFunctions } from 'n8n-workflow';
+import { LoomcycleClient } from '@loomcycle/client';
+/**
+ * Build a LoomcycleClient from the n8n credential. Treats the credential
+ * object as opaque — only the base URL + bearer leave this helper, and
+ * even those go through the typed adapter (never raw fetch).
+ *
+ * Every action / trigger / cluster node uses this to construct its client.
+ */
+export declare function getClient(ctx: IExecuteFunctions | ILoadOptionsFunctions | ITriggerFunctions | ISupplyDataFunctions): Promise<LoomcycleClient>;
+/**
+ * Read a credential default safely. Used by action nodes to fall through
+ * credential `userId` / `userTier` when the per-node parameter is empty.
+ */
+export declare function getCredentialDefault(ctx: IExecuteFunctions | ILoadOptionsFunctions | ITriggerFunctions | ISupplyDataFunctions, field: 'userId' | 'userTier' | 'mcpUrl'): Promise<string>;

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClient = getClient;
+exports.getCredentialDefault = getCredentialDefault;
+const client_1 = require("@loomcycle/client");
+/**
+ * Build a LoomcycleClient from the n8n credential. Treats the credential
+ * object as opaque — only the base URL + bearer leave this helper, and
+ * even those go through the typed adapter (never raw fetch).
+ *
+ * Every action / trigger / cluster node uses this to construct its client.
+ */
+async function getClient(ctx) {
+    const creds = await ctx.getCredentials('loomCycleApi');
+    const baseUrl = String(creds.baseUrl ?? '').trim();
+    const authToken = String(creds.bearerToken ?? '').trim();
+    return new client_1.LoomcycleClient({
+        baseUrl: baseUrl || undefined,
+        authToken: authToken || undefined,
+    });
+}
+/**
+ * Read a credential default safely. Used by action nodes to fall through
+ * credential `userId` / `userTier` when the per-node parameter is empty.
+ */
+async function getCredentialDefault(ctx, field) {
+    const creds = await ctx.getCredentials('loomCycleApi');
+    return String(creds[field] ?? '').trim();
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../nodes/LoomCycle/helpers/client.ts"],"names":[],"mappings":";;AAeA,8BAWC;AAMD,oDAMC;AAhCD,8CAAoD;AAEpD;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAC9B,GAAyF;IAEzF,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,OAAO,IAAI,wBAAe,CAAC;QAC1B,OAAO,EAAE,OAAO,IAAI,SAAS;QAC7B,SAAS,EAAE,SAAS,IAAI,SAAS;KACjC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,oBAAoB,CACzC,GAAyF,EACzF,KAAuC;IAEvC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+/**
+ * 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).
+ */
+export declare function extractEnvVarNames(text: string): string[];
+/**
+ * Extract env-var names from the typical "headers" n8n fixedCollection
+ * shape (`{ header: [{ name, value }, ...] }`).
+ */
+export declare function extractEnvVarsFromHeaders(headers: unknown): string[];
+/**
+ * Compose the human-readable hint string the node UI surfaces under
+ * the Headers field. Empty when no env-var tokens are referenced.
+ */
+export declare function formatEnvVarHint(names: string[]): string;