@vinkius-core/mcp-fusion-n8n 1.0.0

package/README.md

@@ -0,0 +1,62 @@
+# @vinkius-core/mcp-fusion-n8n
+
+A bidirectional translation driver: **n8n REST API ↔ MCP In-Memory Objects**.
+
+Install this package and you gain **5 engineering primitives** that turn your entire n8n automation infrastructure into AI-native tools.
+
+```typescript
+const n8n = await createN8nConnector({
+  url: process.env.N8N_URL!,
+  apiKey: process.env.N8N_API_KEY!,
+  includeTags: ['ai-enabled'],
+  pollInterval: 60_000,
+  onChange: () => server.notification({ method: 'notifications/tools/list_changed' }),
+});
+
+for (const tool of n8n.tools()) {
+  registry.register(defineTool(tool.name, tool.config));
+}
+```
+
+## The 5 Primitives
+
+### 1. Dynamic Ingestion & Zero-Trust Topology
+Connects to n8n at boot (`GET /api/v1/workflows`), scans the visual infrastructure, fetches only active webhook-triggered flows with release tags, and compiles them into `ToolBuilder` instances.
+
+**The impact:** The developer writes zero `fetch()` calls. In 3 lines, 400 legacy automations (Jira, Slack, SAP) become native tools for Claude. Tag filtering guarantees the AI never accesses unauthorized internal flows.
+
+### 2. Semantic Inference — The Hallucination Cure
+n8n webhooks accept any loose JSON. The package extracts the **Notes** field from the workflow canvas and injects it as the tool `description`.
+
+**The impact:** The ops team writes *"Send 'customer_email' and 'urgency' in the body"* in n8n. The AI reads it, understands the semantics, and builds correct JSON with **deterministic precision in zero-shot** — bypassing n8n's complete lack of strict typing.
+
+### 3. Real-Time MVA Interception — The SOC2 Shield
+The package produces `ToolBuilder` instances, not a server. You attach Presenters (Zod Egress Firewall) and auth Middleware to sensitive routes — **in RAM, before the port opens**.
+
+**The impact:** n8n returns 2MB of raw Salesforce JSON packed with internal IPs and passwords. Your Zod Presenter strips every sensitive key. The LLM receives 5KB of clean data. **Absolute data governance.**
+
+### 4. Surgical Construction — `defineN8nTool()`
+For critical routes (Stripe refunds, production deploys), `defineN8nTool()` points to the exact workflow ID, enforces hand-written input schemas, and attaches authorization middleware.
+
+**The impact:** n8n is "dumb muscle". The business rules, strict typing, and security stay **hardcoded in your TypeScript backend**.
+
+### 5. Live State Sync — Infrastructure Hot-Reload
+Background polling motor monitors n8n every N seconds. On change, recompiles `ToolBuilder` in RAM and fires `notifications/tools/list_changed`.
+
+**The impact:** Ops activates a new workflow on Friday at 3 PM. Within 60 seconds, Claude has it — without restarting the Node.js server. **Zero-downtime.**
+
+## What You Deliver
+
+A **fiber-optic cable** between the low-code world (n8n) and the pro-code world (**MCP Fusion**). The package resolves HTTP I/O, route discovery, state synchronization, and LLM semantics. But it returns **100% of the control** over Routing, Protocol, and Security (MVA) to the developer in `server.ts`.
+
+The perfect balance between the insane agility of low-code integrations and hardcore software engineering.
+
+## Install
+
+```bash
+npm install @vinkius-core/mcp-fusion-n8n @vinkius-core/mcp-fusion zod
+```
+
+## Documentation
+
+Full docs with configuration reference and production examples: [mcp-fusion.vinkius.com/n8n-connector](https://mcp-fusion.vinkius.com/n8n-connector).

package/dist/N8nClient.d.ts

@@ -0,0 +1,24 @@
+import type { N8nWorkflow, N8nWebhookResponse } from './types.js';
+export interface N8nClientConfig {
+    readonly url: string;
+    readonly apiKey: string;
+    readonly timeout?: number;
+}
+/**
+ * Minimal HTTP client for the n8n REST API.
+ * Handles authentication, URL normalization, and error wrapping.
+ */
+export declare class N8nClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeout;
+    constructor(config: N8nClientConfig);
+    /** Fetch all active workflows from n8n */
+    listWorkflows(): Promise<N8nWorkflow[]>;
+    /** Fetch a specific workflow by ID */
+    getWorkflow(id: number): Promise<N8nWorkflow>;
+    /** Call a webhook endpoint on the n8n instance */
+    callWebhook(path: string, method: string, payload?: Record<string, unknown>): Promise<N8nWebhookResponse>;
+    private get;
+}
+//# sourceMappingURL=N8nClient.d.ts.map

package/dist/N8nClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"N8nClient.d.ts","sourceRoot":"","sources":["../src/N8nClient.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,eAAe;IAQnC,0CAA0C;IACpC,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAM7C,sCAAsC;IAChC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOnD,kDAAkD;IAC5C,WAAW,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,kBAAkB,CAAC;YAgChB,GAAG;CAyBpB"}

package/dist/N8nClient.js

@@ -0,0 +1,79 @@
+// ============================================================================
+// N8nClient — HTTP client for the n8n REST API
+// ============================================================================
+/**
+ * Minimal HTTP client for the n8n REST API.
+ * Handles authentication, URL normalization, and error wrapping.
+ */
+export class N8nClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    constructor(config) {
+        this.baseUrl = config.url.replace(/\/+$/, '');
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout ?? 30_000;
+    }
+    // ── Workflow Discovery ──
+    /** Fetch all active workflows from n8n */
+    async listWorkflows() {
+        const response = await this.get('/api/v1/workflows?active=true');
+        const body = await response.json();
+        return body.data;
+    }
+    /** Fetch a specific workflow by ID */
+    async getWorkflow(id) {
+        const response = await this.get(`/api/v1/workflows/${id}`);
+        return await response.json();
+    }
+    // ── Webhook Execution ──
+    /** Call a webhook endpoint on the n8n instance */
+    async callWebhook(path, method, payload) {
+        const webhookUrl = `${this.baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const upperMethod = method.toUpperCase();
+            const hasBody = upperMethod !== 'GET' && upperMethod !== 'HEAD';
+            const response = await fetch(webhookUrl, {
+                method: upperMethod,
+                headers: { 'Content-Type': 'application/json' },
+                ...(hasBody ? { body: JSON.stringify(payload ?? {}) } : {}),
+                signal: controller.signal,
+            });
+            const data = await response.json().catch(() => null);
+            const execId = response.headers.get('x-n8n-execution-id');
+            return {
+                status: response.status,
+                data,
+                ...(execId ? { executionId: execId } : {}),
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    // ── Internal ──
+    async get(path) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method: 'GET',
+                headers: {
+                    'X-N8N-API-KEY': this.apiKey,
+                    'Accept': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`n8n API error: ${response.status} ${response.statusText} — ${path}`);
+            }
+            return response;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=N8nClient.js.map

package/dist/N8nClient.js.map

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

package/dist/SchemaInferrer.d.ts

@@ -0,0 +1,12 @@
+import { type ZodTypeAny } from 'zod';
+import type { WebhookConfig } from './types.js';
+/**
+ * Infers Zod schemas from n8n webhook configurations.
+ *
+ * Strategy:
+ * - Query parameters → strict Zod fields with type coercion
+ * - Request body → `z.record(z.any())` fallback (n8n webhooks accept any JSON)
+ * - Workflow notes → `.describe()` on the schema for LLM semantic understanding
+ */
+export declare function inferSchema(config: WebhookConfig): Record<string, ZodTypeAny>;
+//# sourceMappingURL=SchemaInferrer.d.ts.map

package/dist/SchemaInferrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaInferrer.d.ts","sourceRoot":"","sources":["../src/SchemaInferrer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAmB7E"}

package/dist/SchemaInferrer.js

@@ -0,0 +1,48 @@
+// ============================================================================
+// SchemaInferrer — WebhookConfig → Zod schema for MCP Fusion tools
+// ============================================================================
+import { z } from 'zod';
+/**
+ * Infers Zod schemas from n8n webhook configurations.
+ *
+ * Strategy:
+ * - Query parameters → strict Zod fields with type coercion
+ * - Request body → `z.record(z.any())` fallback (n8n webhooks accept any JSON)
+ * - Workflow notes → `.describe()` on the schema for LLM semantic understanding
+ */
+export function inferSchema(config) {
+    const fields = {};
+    // ── Query parameters → strict Zod fields ──
+    for (const param of config.queryParams) {
+        const field = buildParamField(param.type, param.required);
+        fields[param.name] = field;
+    }
+    // ── Body → open record (n8n webhooks accept arbitrary JSON) ──
+    // Only add for methods that accept a body
+    const method = config.method.toUpperCase();
+    if (method !== 'GET' && method !== 'HEAD' && method !== 'DELETE') {
+        fields['body'] = z.record(z.any())
+            .optional()
+            .describe('Request body — see workflow description for expected fields');
+    }
+    return fields;
+}
+/**
+ * Build a Zod field for a query parameter with correct type coercion.
+ */
+function buildParamField(type, required) {
+    let field;
+    switch (type) {
+        case 'number':
+            field = z.coerce.number();
+            break;
+        case 'boolean':
+            field = z.coerce.boolean();
+            break;
+        default:
+            field = z.string();
+            break;
+    }
+    return required ? field : field.optional();
+}
+//# sourceMappingURL=SchemaInferrer.js.map

package/dist/SchemaInferrer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaInferrer.js","sourceRoot":"","sources":["../src/SchemaInferrer.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,+EAA+E;AAE/E,OAAO,EAAE,CAAC,EAAmB,MAAM,KAAK,CAAC;AAGzC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC7C,MAAM,MAAM,GAA+B,EAAE,CAAC;IAE9C,6CAA6C;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,gEAAgE;IAChE,0CAA0C;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;aAC7B,QAAQ,EAAE;aACV,QAAQ,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,QAAiB;IACpD,IAAI,KAAiB,CAAC;IAEtB,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,QAAQ;YACT,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM;QACV,KAAK,SAAS;YACV,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM;QACV;YACI,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM;IACd,CAAC;IAED,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC/C,CAAC"}

package/dist/ToolSynthesizer.d.ts

@@ -0,0 +1,43 @@
+import type { WebhookConfig } from './types.js';
+import type { N8nClient } from './N8nClient.js';
+/**
+ * Synthesizes MCP Fusion tool definitions from discovered n8n webhook workflows.
+ *
+ * Uses `defineTool()` pattern — returns config objects that the consumer
+ * feeds to their own ToolRegistry. This is the IoC boundary:
+ * we produce builders, the developer owns the server.
+ */
+export interface SynthesizedTool {
+    /** Tool name (snake_case from workflow name) */
+    readonly name: string;
+    /** Full tool config for defineTool() */
+    readonly config: {
+        readonly description: string;
+        readonly tags: readonly string[];
+        readonly actions: Record<string, SynthesizedAction>;
+    };
+}
+export interface SynthesizedAction {
+    readonly description: string;
+    readonly params: Record<string, unknown>;
+    readonly handler: (ctx: unknown, args: Record<string, unknown>) => Promise<unknown>;
+    readonly annotations?: {
+        readonly readOnlyHint?: boolean;
+        readonly destructiveHint?: boolean;
+    };
+}
+/**
+ * Convert a workflow name to a valid snake_case tool name.
+ * "Lead Enrichment" → "lead_enrichment"
+ * "My Awesome Workflow (v2)" → "my_awesome_workflow_v2"
+ */
+export declare function toToolName(workflowName: string): string;
+/**
+ * Synthesize a MCP Fusion tool definition from a webhook config.
+ */
+export declare function synthesizeTool(webhook: WebhookConfig, client: N8nClient): SynthesizedTool;
+/**
+ * Synthesize tools from an array of webhook configs.
+ */
+export declare function synthesizeAll(webhooks: WebhookConfig[], client: N8nClient): SynthesizedTool[];
+//# sourceMappingURL=ToolSynthesizer.d.ts.map

package/dist/ToolSynthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSynthesizer.d.ts","sourceRoot":"","sources":["../src/ToolSynthesizer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE;QACb,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;KACvD,CAAC;CACL;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE;QACnB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;KACtC,CAAC;CACL;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,SAAS,GAClB,eAAe,CAsEjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,EAAE,SAAS,GAClB,eAAe,EAAE,CAEnB"}

package/dist/ToolSynthesizer.js

@@ -0,0 +1,92 @@
+// ============================================================================
+// ToolSynthesizer — WebhookConfig → MCP Fusion ToolBuilder
+// ============================================================================
+import { z } from 'zod';
+import { inferSchema } from './SchemaInferrer.js';
+/**
+ * Convert a workflow name to a valid snake_case tool name.
+ * "Lead Enrichment" → "lead_enrichment"
+ * "My Awesome Workflow (v2)" → "my_awesome_workflow_v2"
+ */
+export function toToolName(workflowName) {
+    return workflowName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+}
+/**
+ * Synthesize a MCP Fusion tool definition from a webhook config.
+ */
+export function synthesizeTool(webhook, client) {
+    const name = toToolName(webhook.workflowName);
+    const schema = inferSchema(webhook);
+    const method = webhook.method.toUpperCase();
+    const isReadOnly = method === 'GET';
+    // Build param definitions from inferred schema
+    const params = {};
+    for (const [key, zodType] of Object.entries(schema)) {
+        if (key === 'body') {
+            params[key] = { type: 'object', description: 'Request body — see workflow description for expected fields' };
+        }
+        else {
+            params[key] = 'string'; // query params are strings by default
+        }
+    }
+    // Build the handler — calls the n8n webhook
+    const handler = async (_ctx, args) => {
+        const { body, ...queryArgs } = args;
+        const payload = body ?? queryArgs;
+        const response = await client.callWebhook(webhook.path, webhook.method, payload);
+        if (response.status >= 400) {
+            return {
+                isError: true,
+                content: [{
+                        type: 'text',
+                        text: `n8n workflow error (HTTP ${response.status}): ${JSON.stringify(response.data)}`,
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(response.data, null, 2),
+                }],
+        };
+    };
+    // Tool description with n8n metadata
+    const lines = [
+        `[n8n Workflow #${webhook.workflowId}] ${webhook.workflowName}`,
+        '',
+        webhook.description,
+        '',
+        `Webhook: ${method} ${webhook.path}`,
+    ];
+    if (webhook.tags.length > 0) {
+        lines.push(`Tags: ${webhook.tags.join(', ')}`);
+    }
+    return {
+        name,
+        config: {
+            description: lines.join('\n'),
+            tags: [...webhook.tags],
+            actions: {
+                execute: {
+                    description: `Execute the "${webhook.workflowName}" workflow`,
+                    params,
+                    handler,
+                    annotations: {
+                        readOnlyHint: isReadOnly,
+                        ...(isReadOnly ? {} : { destructiveHint: false }),
+                    },
+                },
+            },
+        },
+    };
+}
+/**
+ * Synthesize tools from an array of webhook configs.
+ */
+export function synthesizeAll(webhooks, client) {
+    return webhooks.map(w => synthesizeTool(w, client));
+}
+//# sourceMappingURL=ToolSynthesizer.js.map

package/dist/ToolSynthesizer.js.map

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

package/dist/WorkflowDiscovery.d.ts

@@ -0,0 +1,30 @@
+import type { N8nClient } from './N8nClient.js';
+import type { WebhookConfig } from './types.js';
+export interface DiscoveryOptions {
+    readonly includeTags?: readonly string[];
+    readonly excludeTags?: readonly string[];
+}
+/**
+ * Discovers webhook-triggered workflows from an n8n instance.
+ *
+ * Only workflows with a Webhook node as trigger are included.
+ * Tag filtering (include/exclude) is applied after discovery.
+ */
+export declare class WorkflowDiscovery {
+    private readonly client;
+    private readonly options;
+    constructor(client: N8nClient, options?: DiscoveryOptions);
+    /** Discover all webhook workflows, apply tag filters, return configs */
+    discover(): Promise<WebhookConfig[]>;
+    /** Check if a workflow has a Webhook node as its trigger */
+    private hasWebhookTrigger;
+    /** Find the first webhook node in a workflow */
+    private findWebhookNode;
+    /** Apply include/exclude tag filters */
+    private applyTagFilters;
+    /** Extract webhook configuration from a workflow */
+    private extractWebhookConfig;
+    /** Extract query parameters from webhook node configuration */
+    private extractQueryParams;
+}
+//# sourceMappingURL=WorkflowDiscovery.d.ts.map

package/dist/WorkflowDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowDiscovery.d.ts","sourceRoot":"","sources":["../src/WorkflowDiscovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAwB,aAAa,EAAc,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,gBAAqB;IAGnD,wEAAwE;IAClE,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAS1C,4DAA4D;IAC5D,OAAO,CAAC,iBAAiB;IAOzB,gDAAgD;IAChD,OAAO,CAAC,eAAe;IAOvB,wCAAwC;IACxC,OAAO,CAAC,eAAe;IAkBvB,oDAAoD;IACpD,OAAO,CAAC,oBAAoB;IAgC5B,+DAA+D;IAC/D,OAAO,CAAC,kBAAkB;CAiB7B"}

package/dist/WorkflowDiscovery.js

@@ -0,0 +1,95 @@
+// ============================================================================
+// WorkflowDiscovery — Fetch + filter webhook-triggered workflows
+// ============================================================================
+/**
+ * Discovers webhook-triggered workflows from an n8n instance.
+ *
+ * Only workflows with a Webhook node as trigger are included.
+ * Tag filtering (include/exclude) is applied after discovery.
+ */
+export class WorkflowDiscovery {
+    client;
+    options;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.options = options;
+    }
+    /** Discover all webhook workflows, apply tag filters, return configs */
+    async discover() {
+        const workflows = await this.client.listWorkflows();
+        const webhookWorkflows = workflows.filter(w => this.hasWebhookTrigger(w));
+        const filtered = this.applyTagFilters(webhookWorkflows);
+        return filtered.map(w => this.extractWebhookConfig(w));
+    }
+    // ── Internal ──
+    /** Check if a workflow has a Webhook node as its trigger */
+    hasWebhookTrigger(workflow) {
+        return workflow.nodes.some(node => node.type === 'n8n-nodes-base.webhook'
+            || node.type === '@n8n/n8n-nodes-base.webhook');
+    }
+    /** Find the first webhook node in a workflow */
+    findWebhookNode(workflow) {
+        return workflow.nodes.find(node => node.type === 'n8n-nodes-base.webhook'
+            || node.type === '@n8n/n8n-nodes-base.webhook');
+    }
+    /** Apply include/exclude tag filters */
+    applyTagFilters(workflows) {
+        const { includeTags, excludeTags } = this.options;
+        return workflows.filter(w => {
+            const tags = w.tags.map(t => t.name);
+            if (includeTags && includeTags.length > 0) {
+                if (!tags.some(t => includeTags.includes(t)))
+                    return false;
+            }
+            if (excludeTags && excludeTags.length > 0) {
+                if (tags.some(t => excludeTags.includes(t)))
+                    return false;
+            }
+            return true;
+        });
+    }
+    /** Extract webhook configuration from a workflow */
+    extractWebhookConfig(workflow) {
+        const node = this.findWebhookNode(workflow);
+        const params = node.parameters;
+        // Extract webhook path (n8n stores it as 'path' parameter)
+        const path = typeof params['path'] === 'string'
+            ? `/webhook/${params['path']}`
+            : `/webhook/${workflow.id}`;
+        // Extract HTTP method (default POST)
+        const method = typeof params['httpMethod'] === 'string'
+            ? params['httpMethod']
+            : 'POST';
+        // Extract description from workflow notes (the "Hack Semântico")
+        const description = workflow.meta?.notes
+            ?? `n8n Workflow #${workflow.id}: ${workflow.name}`;
+        // Extract query parameters if configured
+        const queryParams = this.extractQueryParams(params);
+        return {
+            workflowId: workflow.id,
+            workflowName: workflow.name,
+            path,
+            method,
+            description,
+            tags: workflow.tags.map(t => t.name),
+            queryParams,
+        };
+    }
+    /** Extract query parameters from webhook node configuration */
+    extractQueryParams(params) {
+        // n8n stores query params in 'options.queryParameterAuthentication'
+        // or as configured in the webhook node options
+        const options = params['options'];
+        if (!options)
+            return [];
+        const rawParams = options['queryParameters'];
+        if (!rawParams || !Array.isArray(rawParams))
+            return [];
+        return rawParams.map(p => ({
+            name: p.name,
+            type: p.type || 'string',
+            required: p.required ?? false,
+        }));
+    }
+}
+//# sourceMappingURL=WorkflowDiscovery.js.map

package/dist/WorkflowDiscovery.js.map

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

package/dist/createN8nConnector.d.ts

@@ -0,0 +1,37 @@
+import { N8nClient } from './N8nClient.js';
+import { type SynthesizedTool } from './ToolSynthesizer.js';
+import type { N8nConnectorConfig, WebhookConfig } from './types.js';
+/**
+ * The n8n connector — auto-discovers webhook workflows and produces
+ * tool definitions ready for MCP Fusion's `defineTool()`.
+ *
+ * ```typescript
+ * const n8n = await createN8nConnector({
+ *   url: '...', apiKey: '...',
+ *   pollInterval: 60_000,
+ *   onChange: () => server.notification({ method: 'notifications/tools/list_changed' }),
+ * });
+ * ```
+ */
+export interface N8nConnector {
+    /** The HTTP client for n8n API — expose in context if needed */
+    readonly client: N8nClient;
+    /** Discovered webhook workflow metadata */
+    readonly workflows: readonly WebhookConfig[];
+    /** Pre-synthesized tool definitions ready for defineTool() */
+    tools(): readonly SynthesizedTool[];
+    /** Re-discover workflows (manual poll) */
+    refresh(): Promise<boolean>;
+    /** Stop the background polling loop (if active) */
+    stop(): void;
+}
+/**
+ * Create an n8n connector that auto-discovers webhook workflows.
+ *
+ * If `pollInterval` is set, starts a background polling loop that
+ * re-discovers workflows and calls `onChange()` when the tool list changes.
+ * This enables zero-downtime hot-reload: the MCP server emits
+ * `notifications/tools/list_changed` and Claude refreshes instantly.
+ */
+export declare function createN8nConnector(config: N8nConnectorConfig): Promise<N8nConnector>;
+//# sourceMappingURL=createN8nConnector.d.ts.map

package/dist/createN8nConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createN8nConnector.d.ts","sourceRoot":"","sources":["../src/createN8nConnector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAwB,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IACzB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,8DAA8D;IAC9D,KAAK,IAAI,SAAS,eAAe,EAAE,CAAC;IACpC,0CAA0C;IAC1C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,mDAAmD;IACnD,IAAI,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACpC,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAgFvB"}

package/dist/createN8nConnector.js

@@ -0,0 +1,84 @@
+// ============================================================================
+// createN8nConnector — Auto-discovery mode (the Growth Hack)
+// ============================================================================
+import { N8nClient } from './N8nClient.js';
+import { WorkflowDiscovery } from './WorkflowDiscovery.js';
+import { synthesizeAll } from './ToolSynthesizer.js';
+/**
+ * Create an n8n connector that auto-discovers webhook workflows.
+ *
+ * If `pollInterval` is set, starts a background polling loop that
+ * re-discovers workflows and calls `onChange()` when the tool list changes.
+ * This enables zero-downtime hot-reload: the MCP server emits
+ * `notifications/tools/list_changed` and Claude refreshes instantly.
+ */
+export async function createN8nConnector(config) {
+    const clientConfig = {
+        url: config.url,
+        apiKey: config.apiKey,
+        ...(config.timeout != null ? { timeout: config.timeout } : {}),
+    };
+    const client = new N8nClient(clientConfig);
+    const discoveryOpts = {
+        ...(config.includeTags ? { includeTags: config.includeTags } : {}),
+        ...(config.excludeTags ? { excludeTags: config.excludeTags } : {}),
+    };
+    const discovery = new WorkflowDiscovery(client, discoveryOpts);
+    let webhooks = await discovery.discover();
+    let synthesized = synthesizeAll(webhooks, client);
+    // ── Background Polling (Live State Sync) ──
+    let pollTimer = null;
+    /** Compute a fingerprint from tool names for change detection */
+    function fingerprint(tools) {
+        return tools.map(t => t.name).sort().join(',');
+    }
+    let lastFingerprint = fingerprint(synthesized);
+    /**
+     * Refresh and detect changes. Returns `true` if the tool list changed.
+     */
+    async function refresh() {
+        webhooks = await discovery.discover();
+        const newSynth = synthesizeAll(webhooks, client);
+        const newFp = fingerprint(newSynth);
+        const changed = newFp !== lastFingerprint;
+        synthesized = newSynth;
+        lastFingerprint = newFp;
+        return changed;
+    }
+    // Start polling if interval is configured
+    if (config.pollInterval != null && config.pollInterval > 0) {
+        pollTimer = setInterval(async () => {
+            try {
+                const changed = await refresh();
+                if (changed && config.onChange) {
+                    config.onChange();
+                }
+            }
+            catch {
+                // Polling errors are silently swallowed — n8n might be
+                // temporarily unreachable. Next cycle will retry.
+            }
+        }, config.pollInterval);
+        // Ensure the timer doesn't prevent Node.js from exiting
+        if (typeof pollTimer === 'object' && 'unref' in pollTimer) {
+            pollTimer.unref();
+        }
+    }
+    return {
+        client,
+        get workflows() {
+            return webhooks;
+        },
+        tools() {
+            return synthesized;
+        },
+        refresh,
+        stop() {
+            if (pollTimer != null) {
+                clearInterval(pollTimer);
+                pollTimer = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=createN8nConnector.js.map

package/dist/createN8nConnector.js.map

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

package/dist/defineN8nTool.d.ts

@@ -0,0 +1,26 @@
+import type { N8nClient } from './N8nClient.js';
+import type { N8nToolConfig } from './types.js';
+import type { SynthesizedTool } from './ToolSynthesizer.js';
+/**
+ * Manually define an n8n workflow as an MCP Fusion tool.
+ *
+ * For when architects need surgical control: strict Zod params,
+ * custom annotations, specific middleware chains.
+ *
+ * ```typescript
+ * const deploy = defineN8nTool('deploy_staging', client, {
+ *   workflowId: 15,
+ *   webhookPath: '/webhook/deploy',
+ *   params: {
+ *     branch: 'string',
+ *     environment: { type: 'string', enum: ['staging', 'production'] },
+ *   },
+ *   annotations: { destructiveHint: true },
+ * });
+ *
+ * const builder = defineTool(deploy.name, deploy.config);
+ * registry.register(builder);
+ * ```
+ */
+export declare function defineN8nTool<TContext = void>(name: string, client: N8nClient, config: N8nToolConfig<TContext>): SynthesizedTool;
+//# sourceMappingURL=defineN8nTool.d.ts.map

package/dist/defineN8nTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineN8nTool.d.ts","sourceRoot":"","sources":["../src/defineN8nTool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,sBAAsB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAG,IAAI,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAChC,eAAe,CAmEjB"}

package/dist/defineN8nTool.js

@@ -0,0 +1,84 @@
+// ============================================================================
+// defineN8nTool — Manual/surgical mode (the Enterprise Weapon)
+// ============================================================================
+/**
+ * Manually define an n8n workflow as an MCP Fusion tool.
+ *
+ * For when architects need surgical control: strict Zod params,
+ * custom annotations, specific middleware chains.
+ *
+ * ```typescript
+ * const deploy = defineN8nTool('deploy_staging', client, {
+ *   workflowId: 15,
+ *   webhookPath: '/webhook/deploy',
+ *   params: {
+ *     branch: 'string',
+ *     environment: { type: 'string', enum: ['staging', 'production'] },
+ *   },
+ *   annotations: { destructiveHint: true },
+ * });
+ *
+ * const builder = defineTool(deploy.name, deploy.config);
+ * registry.register(builder);
+ * ```
+ */
+export function defineN8nTool(name, client, config) {
+    const method = (config.method ?? 'POST').toUpperCase();
+    const isReadOnly = method === 'GET';
+    // Build params from user-provided definitions
+    const params = {};
+    if (config.params) {
+        for (const [key, def] of Object.entries(config.params)) {
+            if (typeof def === 'string') {
+                params[key] = def;
+            }
+            else {
+                params[key] = {
+                    type: def.type,
+                    ...(def.enum ? { enum: def.enum } : {}),
+                    ...(def.description ? { description: def.description } : {}),
+                };
+            }
+        }
+    }
+    // Build handler
+    const handler = async (_ctx, args) => {
+        const response = await client.callWebhook(config.webhookPath, method, args);
+        if (response.status >= 400) {
+            return {
+                isError: true,
+                content: [{
+                        type: 'text',
+                        text: `n8n workflow error (HTTP ${response.status}): ${JSON.stringify(response.data)}`,
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(response.data, null, 2),
+                }],
+        };
+    };
+    const description = config.description ??
+        `[n8n Workflow #${config.workflowId}] ${name}`;
+    return {
+        name,
+        config: {
+            description,
+            tags: config.tags ? [...config.tags] : [],
+            actions: {
+                execute: {
+                    description: `Execute workflow #${config.workflowId}`,
+                    params,
+                    handler,
+                    annotations: config.annotations ?? {
+                        readOnlyHint: isReadOnly,
+                        ...(isReadOnly ? {} : { destructiveHint: false }),
+                    },
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=defineN8nTool.js.map

package/dist/defineN8nTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineN8nTool.js","sourceRoot":"","sources":["../src/defineN8nTool.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+DAA+D;AAC/D,+EAA+E;AAM/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CACzB,IAAY,EACZ,MAAiB,EACjB,MAA+B;IAE/B,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,MAAM,UAAU,GAAG,MAAM,KAAK,KAAK,CAAC;IAEpC,8CAA8C;IAC9C,MAAM,MAAM,GAA8F,EAAE,CAAC;IAC7G,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,GAAG,CAAC,GAAG;oBACV,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GAAG,KAAK,EAAE,IAAa,EAAE,IAA6B,EAAE,EAAE;QACnE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CACrC,MAAM,CAAC,WAAW,EAClB,MAAM,EACN,IAAI,CACP,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACzB,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC;wBACN,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,4BAA4B,QAAQ,CAAC,MAAM,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;qBACzF,CAAC;aACL,CAAC;QACN,CAAC;QAED,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC/C,CAAC;SACL,CAAC;IACN,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW;QAClC,kBAAkB,MAAM,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;IAEnD,OAAO;QACH,IAAI;QACJ,MAAM,EAAE;YACJ,WAAW;YACX,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YACzC,OAAO,EAAE;gBACL,OAAO,EAAE;oBACL,WAAW,EAAE,qBAAqB,MAAM,CAAC,UAAU,EAAE;oBACrD,MAAM;oBACN,OAAO;oBACP,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI;wBAC/B,YAAY,EAAE,UAAU;wBACxB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;qBACpD;iBACJ;aACJ;SACJ;KACJ,CAAC;AACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { createN8nConnector } from './createN8nConnector.js';
+export type { N8nConnector } from './createN8nConnector.js';
+export { defineN8nTool } from './defineN8nTool.js';
+export { N8nClient } from './N8nClient.js';
+export type { N8nClientConfig } from './N8nClient.js';
+export { WorkflowDiscovery } from './WorkflowDiscovery.js';
+export type { DiscoveryOptions } from './WorkflowDiscovery.js';
+export { inferSchema } from './SchemaInferrer.js';
+export { synthesizeTool, synthesizeAll, toToolName } from './ToolSynthesizer.js';
+export type { SynthesizedTool, SynthesizedAction } from './ToolSynthesizer.js';
+export type { N8nWorkflow, N8nNode, N8nTag, N8nWebhookResponse, N8nConnectorConfig, N8nToolConfig, WebhookConfig, QueryParam, ParamDef, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,YAAY,EACR,WAAW,EACX,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,UAAU,EACV,QAAQ,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// ============================================================================
+// @vinkius-core/mcp-fusion-n8n — Barrel Export
+// ============================================================================
+// ── Primary API ──
+export { createN8nConnector } from './createN8nConnector.js';
+export { defineN8nTool } from './defineN8nTool.js';
+// ── Client ──
+export { N8nClient } from './N8nClient.js';
+// ── Discovery ──
+export { WorkflowDiscovery } from './WorkflowDiscovery.js';
+// ── Schema Inference ──
+export { inferSchema } from './SchemaInferrer.js';
+// ── Tool Synthesis ──
+export { synthesizeTool, synthesizeAll, toToolName } from './ToolSynthesizer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E,oBAAoB;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,kBAAkB;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,yBAAyB;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+/** Workflow node from n8n API */
+export interface N8nNode {
+    readonly name: string;
+    readonly type: string;
+    readonly parameters: Record<string, unknown>;
+    readonly position: readonly [number, number];
+}
+/** Workflow from n8n GET /api/v1/workflows */
+export interface N8nWorkflow {
+    readonly id: number;
+    readonly name: string;
+    readonly active: boolean;
+    readonly tags: readonly N8nTag[];
+    readonly nodes: readonly N8nNode[];
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    /** User-facing notes/description (the "Hack Semântico" field) */
+    readonly meta?: {
+        readonly notes?: string;
+    };
+}
+/** Tag from n8n API */
+export interface N8nTag {
+    readonly id: number;
+    readonly name: string;
+}
+/** Webhook node configuration extracted from a workflow */
+export interface WebhookConfig {
+    readonly workflowId: number;
+    readonly workflowName: string;
+    readonly path: string;
+    readonly method: string;
+    readonly description: string;
+    readonly tags: readonly string[];
+    readonly queryParams: readonly QueryParam[];
+}
+/** Query parameter extracted from webhook node */
+export interface QueryParam {
+    readonly name: string;
+    readonly type: 'string' | 'number' | 'boolean';
+    readonly required: boolean;
+}
+/** n8n webhook execution response */
+export interface N8nWebhookResponse {
+    readonly status: number;
+    readonly data: unknown;
+    readonly executionId?: string;
+}
+/** Configuration for the n8n connector */
+export interface N8nConnectorConfig {
+    /** n8n instance base URL (e.g., http://localhost:5678) */
+    readonly url: string;
+    /** n8n REST API key */
+    readonly apiKey: string;
+    /** Only expose workflows with these tags */
+    readonly includeTags?: readonly string[];
+    /** Exclude workflows with these tags */
+    readonly excludeTags?: readonly string[];
+    /** Webhook call timeout in ms (default: 30000) */
+    readonly timeout?: number;
+    /** Polling interval in ms for live state sync (default: off). Set to enable auto-refresh. */
+    readonly pollInterval?: number;
+    /**
+     * Called when the tool list changes after a poll cycle.
+     * Use this to emit `notifications/tools/list_changed` on your MCP server.
+     */
+    readonly onChange?: () => void;
+}
+/** Configuration for manually defining an n8n tool */
+export interface N8nToolConfig<TContext = void> {
+    /** n8n workflow ID */
+    readonly workflowId: number;
+    /** Webhook path (e.g., '/webhook/lead-enrichment') */
+    readonly webhookPath: string;
+    /** HTTP method (default: 'POST') */
+    readonly method?: string;
+    /** Tool description for the LLM */
+    readonly description?: string;
+    /** Parameter definitions (JSON-first, like defineTool) */
+    readonly params?: Record<string, ParamDef>;
+    /** MCP annotations */
+    readonly annotations?: {
+        readonly readOnlyHint?: boolean;
+        readonly destructiveHint?: boolean;
+    };
+    /** Tags for filtering */
+    readonly tags?: readonly string[];
+}
+/** Parameter definition (JSON-first) */
+export type ParamDef = string | {
+    readonly type: string;
+    readonly enum?: readonly string[];
+    readonly description?: string;
+    readonly required?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// n8n API Types — Internal type definitions for the n8n REST API
+// ============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iEAAiE;AACjE,+EAA+E"}

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "@vinkius-core/mcp-fusion-n8n",
+    "version": "1.0.0",
+    "description": "n8n connector for MCP Fusion. Auto-discovers webhook workflows and produces ToolBuilders — so AI agents can call your automations natively.",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "tsc",
+        "test": "vitest run",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "mcp",
+        "n8n",
+        "mcp-fusion",
+        "workflow",
+        "automation",
+        "ai",
+        "llm",
+        "connector"
+    ],
+    "author": "Vinkius Labs",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/vinkius-labs/mcp-fusion.git",
+        "directory": "packages/n8n"
+    },
+    "bugs": {
+        "url": "https://github.com/vinkius-labs/mcp-fusion/issues"
+    },
+    "homepage": "https://mcp-fusion.vinkius.com/",
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "peerDependencies": {
+        "@vinkius-core/mcp-fusion": "^2.0.0",
+        "zod": "^3.25.1 || ^4.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^25.3.0"
+    },
+    "license": "Apache-2.0"
+}