@elizaos/plugin-n8n-workflow 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { type Plugin } from '@elizaos/core';
+/**
+ * n8n Workflow Plugin for ElizaOS
+ *
+ * Generate and manage n8n workflows from natural language using RAG pipeline.
+ * Supports workflow CRUD, execution management, and credential resolution.
+ *
+ * **Required Configuration:**
+ * - `N8N_API_KEY`: Your n8n API key
+ * - `N8N_HOST`: Your n8n instance URL (e.g., https://your.n8n.cloud)
+ *
+ * **Optional Configuration:**
+ * - `n8n.credentials`: Pre-configured credential IDs for local mode
+ *
+ * **Example Character Configuration:**
+ * ```json
+ * {
+ *   "name": "AI Workflow Builder",
+ *   "plugins": ["@elizaos/plugin-n8n-workflow"],
+ *   "settings": {
+ *     "N8N_API_KEY": "env:N8N_API_KEY",
+ *     "N8N_HOST": "https://your.n8n.cloud",
+ *     "n8n": {
+ *       "credentials": {
+ *         "gmailOAuth2Api": "cred_gmail_123",
+ *         "stripeApi": "cred_stripe_456"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare const n8nWorkflowPlugin: Plugin;
+export default n8nWorkflowPlugin;
+//# 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":"AAAA,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAcxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,iBAAiB,EAAE,MA6D/B,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,75 @@
+import { logger } from '@elizaos/core';
+import { N8nWorkflowService } from './services/index';
+import { createWorkflowAction, listWorkflowsAction, getExecutionsAction, activateWorkflowAction, deactivateWorkflowAction, deleteWorkflowAction, executeWorkflowAction, listCredentialsAction, } from './actions/index';
+import { workflowStatusProvider, activeWorkflowsProvider } from './providers/index';
+/**
+ * n8n Workflow Plugin for ElizaOS
+ *
+ * Generate and manage n8n workflows from natural language using RAG pipeline.
+ * Supports workflow CRUD, execution management, and credential resolution.
+ *
+ * **Required Configuration:**
+ * - `N8N_API_KEY`: Your n8n API key
+ * - `N8N_HOST`: Your n8n instance URL (e.g., https://your.n8n.cloud)
+ *
+ * **Optional Configuration:**
+ * - `n8n.credentials`: Pre-configured credential IDs for local mode
+ *
+ * **Example Character Configuration:**
+ * ```json
+ * {
+ *   "name": "AI Workflow Builder",
+ *   "plugins": ["@elizaos/plugin-n8n-workflow"],
+ *   "settings": {
+ *     "N8N_API_KEY": "env:N8N_API_KEY",
+ *     "N8N_HOST": "https://your.n8n.cloud",
+ *     "n8n": {
+ *       "credentials": {
+ *         "gmailOAuth2Api": "cred_gmail_123",
+ *         "stripeApi": "cred_stripe_456"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export const n8nWorkflowPlugin = {
+    name: 'n8n-workflow',
+    description: 'Generate and deploy n8n workflows from natural language. ' +
+        'Supports 450+ native n8n nodes (Gmail, Slack, Stripe, etc.) with intelligent ' +
+        'credential resolution and workflow management.',
+    services: [N8nWorkflowService],
+    actions: [
+        createWorkflowAction,
+        listWorkflowsAction,
+        getExecutionsAction,
+        activateWorkflowAction,
+        deactivateWorkflowAction,
+        deleteWorkflowAction,
+        executeWorkflowAction,
+        listCredentialsAction,
+    ],
+    providers: [workflowStatusProvider, activeWorkflowsProvider],
+    init: async (_config, runtime) => {
+        const apiKey = runtime.getSetting('N8N_API_KEY');
+        const host = runtime.getSetting('N8N_HOST');
+        logger.info(`n8n Workflow Plugin - API Key: ${apiKey ? 'configured' : 'not configured'}, Host: ${host || 'not set'}`);
+        if (!apiKey) {
+            logger.warn('N8N_API_KEY not provided - plugin will not be functional. ' +
+                'Please set N8N_API_KEY in your environment or character settings.');
+        }
+        if (!host) {
+            logger.warn('N8N_HOST not provided - plugin will not be functional. ' +
+                'Please set N8N_HOST to your n8n instance URL (e.g., https://your.n8n.cloud).');
+        }
+        // Check for pre-configured credentials (optional)
+        const n8nSettings = runtime.getSetting('n8n');
+        if (n8nSettings?.credentials) {
+            const credCount = Object.keys(n8nSettings.credentials).length;
+            logger.info({ src: 'plugin:n8n-workflow:plugin:init' }, `n8n Workflow Plugin - Pre-configured credentials: ${credCount} credential types`);
+        }
+        logger.info({ src: 'plugin:n8n-workflow:plugin:init' }, 'n8n Workflow Plugin initialized successfully');
+    },
+};
+export default n8nWorkflowPlugin;
+//# 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,OAAO,EAAsB,MAAM,EAAe,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAW;IACvC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,2DAA2D;QAC3D,+EAA+E;QAC/E,gDAAgD;IAElD,QAAQ,EAAE,CAAC,kBAAkB,CAAC;IAE9B,OAAO,EAAE;QACP,oBAAoB;QACpB,mBAAmB;QACnB,mBAAmB;QACnB,sBAAsB;QACtB,wBAAwB;QACxB,oBAAoB;QACpB,qBAAqB;QACrB,qBAAqB;KACtB;IAED,SAAS,EAAE,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;IAE5D,IAAI,EAAE,KAAK,EAAE,OAA+B,EAAE,OAAsB,EAAiB,EAAE;QACrF,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE5C,MAAM,CAAC,IAAI,CACT,kCAAkC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,WAAW,IAAI,IAAI,SAAS,EAAE,CACzG,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CACT,4DAA4D;gBAC1D,mEAAmE,CACtE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CACT,yDAAyD;gBACvD,8EAA8E,CACjF,CAAC;QACJ,CAAC;QAED,kDAAkD;QAClD,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAE/B,CAAC;QACd,IAAI,WAAW,EAAE,WAAW,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;YAC9D,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,iCAAiC,EAAE,EAC1C,qDAAqD,SAAS,mBAAmB,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,iCAAiC,EAAE,EAC1C,8CAA8C,CAC/C,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,3 @@
+export { KEYWORD_EXTRACTION_SYSTEM_PROMPT } from './keywordExtraction';
+export { WORKFLOW_GENERATION_SYSTEM_PROMPT } from './workflowGeneration';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,3 @@
+export { KEYWORD_EXTRACTION_SYSTEM_PROMPT } from './keywordExtraction';
+export { WORKFLOW_GENERATION_SYSTEM_PROMPT } from './workflowGeneration';
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/prompts/keywordExtraction.d.ts

@@ -0,0 +1,6 @@
+/**
+ * System prompt for keyword extraction from user workflow descriptions
+ * Adapted from n8n-intelligence for ElizaOS
+ */
+export declare const KEYWORD_EXTRACTION_SYSTEM_PROMPT = "You are an expert at extracting relevant search terms for finding n8n nodes.\n\nGiven a user prompt describing an n8n workflow, extract up to 5 concise keywords or phrases that best represent the core actions, services, or data transformations involved.\n\nFocus on terms likely to match n8n node names or functionalities. Avoid generic words.\n\nExamples:\n- \"Send me Stripe payment summaries via Gmail every Monday\" \u2192 [\"stripe\", \"gmail\", \"send\", \"email\", \"schedule\"]\n- \"Post RSS feed updates to Slack channel\" \u2192 [\"rss\", \"slack\", \"post\", \"feed\", \"webhook\"]\n- \"Summarize weekly GitHub issues and send to Notion\" \u2192 [\"github\", \"issues\", \"notion\", \"summarize\"]\n- \"Fetch weather data hourly and store in Google Sheets\" \u2192 [\"weather\", \"http\", \"schedule\", \"google sheets\", \"store\"]\n- \"When new Stripe payment, create invoice in QuickBooks\" \u2192 [\"stripe\", \"webhook\", \"quickbooks\", \"invoice\", \"payment\"]\n\nReturn a JSON object with a \"keywords\" array containing 1-5 relevant search terms.";
+//# sourceMappingURL=keywordExtraction.d.ts.map

package/dist/prompts/keywordExtraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywordExtraction.d.ts","sourceRoot":"","sources":["../../src/prompts/keywordExtraction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,gCAAgC,gjCAasC,CAAC"}

package/dist/prompts/keywordExtraction.js

@@ -0,0 +1,19 @@
+/**
+ * System prompt for keyword extraction from user workflow descriptions
+ * Adapted from n8n-intelligence for ElizaOS
+ */
+export const KEYWORD_EXTRACTION_SYSTEM_PROMPT = `You are an expert at extracting relevant search terms for finding n8n nodes.
+
+Given a user prompt describing an n8n workflow, extract up to 5 concise keywords or phrases that best represent the core actions, services, or data transformations involved.
+
+Focus on terms likely to match n8n node names or functionalities. Avoid generic words.
+
+Examples:
+- "Send me Stripe payment summaries via Gmail every Monday" → ["stripe", "gmail", "send", "email", "schedule"]
+- "Post RSS feed updates to Slack channel" → ["rss", "slack", "post", "feed", "webhook"]
+- "Summarize weekly GitHub issues and send to Notion" → ["github", "issues", "notion", "summarize"]
+- "Fetch weather data hourly and store in Google Sheets" → ["weather", "http", "schedule", "google sheets", "store"]
+- "When new Stripe payment, create invoice in QuickBooks" → ["stripe", "webhook", "quickbooks", "invoice", "payment"]
+
+Return a JSON object with a "keywords" array containing 1-5 relevant search terms.`;
+//# sourceMappingURL=keywordExtraction.js.map

package/dist/prompts/keywordExtraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywordExtraction.js","sourceRoot":"","sources":["../../src/prompts/keywordExtraction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG;;;;;;;;;;;;;mFAamC,CAAC"}

package/dist/prompts/workflowGeneration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * System prompt for n8n workflow generation
+ * Adapted from n8n-intelligence with credential injection instructions
+ * @see https://github.com/n8n-intelligence/worker/utils/prompt.ts
+ */
+export declare const WORKFLOW_GENERATION_SYSTEM_PROMPT = "## n8n Workflow AI Definition: Core Concepts\n\n### 1. **Workflow**\n\nA workflow is a collection of nodes and the connections between them.\n\n```json\n{\n  \"id\": \"uuid\",\n  \"name\": \"string\",\n  \"active\": true,\n  \"nodes\": [/* array of Node objects */],\n  \"connections\": {/* see below */},\n  \"settings\": {/* workflow-specific settings, optional */},\n  \"staticData\": {/* optional */},\n  \"pinData\": {/* optional */}\n}\n```\n\n---\n\n### 2. **Node**\n\nA node is a single step in a workflow. Each node has:\n\n| Field         | Type      | Description                      |\n|:--------------|:----------|:----------------------------------|\n| id            | string    | Unique node identifier            |\n| name          | string    | Node name (unique in workflow)    |\n| type          | string    | Node type (e.g. `httpRequest`)    |\n| typeVersion   | number    | Node type version                 |\n| position      | [number, number] | Canvas position          |\n| parameters    | object    | Node parameters (see below)       |\n| credentials   | object    | Credential references (optional)  |\n| disabled      | boolean   | If node is disabled (optional)    |\n\n---\n\n### 3. **Connections**\n\nConnections define how nodes are linked.\n\n```json\n{\n  \"NodeA\": {\n    \"main\": [\n      [ { \"node\": \"NodeB\", \"type\": \"main\", \"index\": 0 } ]\n    ]\n  }\n}\n```\n-  Key: source node name\n-  Each connection has a `type` (commonly `\"main\"`)\n-  Each connection points to a destination node, with an index\n\n---\n\n### 4. **Node Parameters**\n\nEach node has parameters, which are defined in its node type description. Parameters can be:\n\n-  Simple values (string, number, boolean)\n-  Complex objects (collections, fixedCollections, etc.)\n-  Resource locators (for referencing external resources)\n-  Options (select from a list)\n\n**Parameter properties:**\n| Field         | Type      | Description                      |\n|:--------------|:----------|:----------------------------------|\n| displayName   | string    | Label shown in UI                |\n| name          | string    | Internal parameter name          |\n| type          | string    | Parameter type (`string`, `number`, `options`, etc.) |\n| default       | any       | Default value                    |\n| description   | string    | Help text (optional)             |\n| required      | boolean   | Is required? (optional)          |\n| options       | array     | For `options` type: choices    |\n| displayOptions| object    | Show/hide logic (optional)       |\n\n---\n\n### 5. **Node Type Description**\n\nEach node type (e.g. HTTP Request, Slack, Google Sheets) defines:\n\n| Field         | Type      | Description                      |\n|:--------------|:----------|:----------------------------------|\n| name          | string    | Node type name                   |\n| displayName   | string    | Human-readable name              |\n| group         | array     | Node group(s): e.g. input, output, trigger |\n| description   | string    | Node description                 |\n| version       | number    | Node version                     |\n| inputs        | array     | Allowed input connection types   |\n| outputs       | array     | Allowed output connection types  |\n| properties    | array     | Parameter definitions            |\n| credentials   | array     | Credential requirements          |\n| documentationUrl | string | Docs link (optional)             |\n\n---\n\n### 6. **Credentials**\n\nSome nodes require credentials. For nodes that need authentication:\n\n**IMPORTANT:** Always use native n8n nodes (e.g. `n8n-nodes-base.gmail`, `n8n-nodes-base.slack`) rather than generic HTTP Request nodes.\n\nWhen a node requires credentials, include a `credentials` field in the node object:\n\n```json\n{\n  \"name\": \"Send Gmail\",\n  \"type\": \"n8n-nodes-base.gmail\",\n  \"credentials\": {\n    \"gmailOAuth2Api\": {\n      \"id\": \"{{CREDENTIAL_ID}}\",\n      \"name\": \"Gmail Account\"\n    }\n  }\n}\n```\n\nThe credential ID will be injected automatically. Use the credential type name from the node's definition (e.g. `gmailOAuth2Api`, `slackOAuth2Api`, `stripeApi`).\n\n---\n\n### 7. **Workflow Settings (optional)**\n\nWorkflow-level settings, e.g. timezone, error workflow, execution options.\n\n---\n\n## **Prompt Example for AI**\n\n> You are an n8n workflow generator. Given a user's intent, generate a workflow as a JSON object.\n> Use the following structure:\n> - `nodes`: List of nodes, each with `id`, `name`, `type`, `typeVersion`, `position`, `parameters`, and optional `credentials`.\n> - `connections`: Object mapping node names to their output connections.\n> - `settings`: Optional workflow settings.\n\n> Reference [n8n node type documentation](https://docs.n8n.io/integrations/builtin/app-nodes/) for available node types and their parameters.\n\n**When creating nodes:**\n-  Use required parameters from the node's type definition.\n-  For options, pick the most common or user-specified value.\n-  Use unique names for each node.\n-  Connect nodes using the `connections` object, with `\"main\"` as the default connection type.\n-  For nodes requiring authentication, include the `credentials` field with the appropriate credential type.\n-  Use native n8n nodes (n8n-nodes-base.*) instead of generic HTTP Request nodes.\n\n---\n\n## **Minimal Example Workflow**\n\n```json\n{\n  \"nodes\": [\n    {\n      \"id\": \"uuid-1\",\n      \"name\": \"Start\",\n      \"type\": \"n8n-nodes-base.start\",\n      \"typeVersion\": 1,\n      \"position\": [0,0],\n      \"parameters\": {}\n    },\n    {\n      \"id\": \"uuid-2\",\n      \"name\": \"Send Email\",\n      \"type\": \"n8n-nodes-base.emailSend\",\n      \"typeVersion\": 1,\n      \"position\": [200,0],\n      \"parameters\": {\n        \"to\": \"user@example.com\",\n        \"subject\": \"Hello\",\n        \"text\": \"This is a test\"\n      }\n    }\n  ],\n  \"connections\": {\n    \"Start\": { \"main\": [ [ { \"node\": \"Send Email\", \"type\": \"main\", \"index\": 0 } ] ] }\n  }\n}\n```\n\n---\n\n## **Example with Credentials**\n\n```json\n{\n  \"nodes\": [\n    {\n      \"id\": \"uuid-1\",\n      \"name\": \"Schedule Trigger\",\n      \"type\": \"n8n-nodes-base.scheduleTrigger\",\n      \"typeVersion\": 1,\n      \"position\": [0,0],\n      \"parameters\": {\n        \"rule\": {\n          \"interval\": [\n            {\n              \"field\": \"hours\",\n              \"hoursInterval\": 24\n            }\n          ]\n        }\n      }\n    },\n    {\n      \"id\": \"uuid-2\",\n      \"name\": \"Get Stripe Payments\",\n      \"type\": \"n8n-nodes-base.stripe\",\n      \"typeVersion\": 1,\n      \"position\": [200,0],\n      \"parameters\": {\n        \"resource\": \"charge\",\n        \"operation\": \"getAll\"\n      },\n      \"credentials\": {\n        \"stripeApi\": {\n          \"id\": \"{{CREDENTIAL_ID}}\",\n          \"name\": \"Stripe Account\"\n        }\n      }\n    },\n    {\n      \"id\": \"uuid-3\",\n      \"name\": \"Send via Gmail\",\n      \"type\": \"n8n-nodes-base.gmail\",\n      \"typeVersion\": 2,\n      \"position\": [400,0],\n      \"parameters\": {\n        \"operation\": \"send\",\n        \"message\": {\n          \"to\": \"user@example.com\",\n          \"subject\": \"Daily Stripe Summary\",\n          \"body\": \"{{ $json.data }}\"\n        }\n      },\n      \"credentials\": {\n        \"gmailOAuth2Api\": {\n          \"id\": \"{{CREDENTIAL_ID}}\",\n          \"name\": \"Gmail Account\"\n        }\n      }\n    }\n  ],\n  \"connections\": {\n    \"Schedule Trigger\": { \"main\": [ [ { \"node\": \"Get Stripe Payments\", \"type\": \"main\", \"index\": 0 } ] ] },\n    \"Get Stripe Payments\": { \"main\": [ [ { \"node\": \"Send via Gmail\", \"type\": \"main\", \"index\": 0 } ] ] }\n  }\n}\n```\n\n---\n\n## **Summary Table: Key n8n Workflow Concepts**\n\n| Concept         | Description/Key Fields                                     |\n|:----------------|:----------------------------------------------------------|\n| Workflow        | id, name, active, nodes, connections, settings            |\n| Node            | id, name, type, typeVersion, position, parameters, credentials, disabled |\n| Connections     | Map of node names to output connection arrays              |\n| Node Parameters | name, displayName, type, default, options, required, description |\n| Node Type       | name, displayName, group, description, version, inputs, outputs, properties, credentials |\n| Credentials     | Referenced in node, injected automatically by ID          |\n| Settings        | Workflow-level options                                    |\n\n---\n\n**Use only these fields and structures for AI workflow generation.**\nFor parameter validation and types, rely on the node's type definition and basic TypeScript types.\n\n---\n\n## **Handling Incomplete or Ambiguous Prompts**\n\nWhen the user prompt lacks specific details:\n\n1. **Make reasonable assumptions** based on common use cases\n2. **Use sensible defaults**:\n   - Email service: Prefer Gmail over generic SMTP\n   - Schedule: Default to daily at 9 AM if frequency not specified\n   - Error handling: Include basic error notifications\n   - Data format: Use JSON for structured data\n\n3. **Document your assumptions** in a special `_meta` field:\n\n```json\n{\n  \"name\": \"Workflow Name\",\n  \"nodes\": [...],\n  \"connections\": {...},\n  \"_meta\": {\n    \"assumptions\": [\n      \"Using Gmail as email service (not specified)\",\n      \"Running daily at 9 AM (frequency not specified)\",\n      \"Sending to primary email address (recipient not specified)\"\n    ],\n    \"suggestions\": [\n      \"Consider adding error notification to Slack\",\n      \"You may want to filter payments by status\",\n      \"Add a condition node to check if data is empty\"\n    ],\n    \"requiresClarification\": [\n      \"Which email address should receive the summary?\",\n      \"Should failed payments be included?\"\n    ]\n  }\n}\n```\n\n4. **If critically ambiguous** (multiple valid interpretations):\n   - Set `_meta.requiresClarification` with specific questions\n   - Still generate a valid workflow with best-guess defaults\n   - The user can approve or request modifications\n\n**Example ambiguous prompt**: \"Send me payment info\"\n- Assumption: Stripe payments (most common)\n- Assumption: Email via Gmail\n- Clarification needed: \"Which email address?\" / \"All payments or just successful ones?\"\n\n---\n\n**IMPORTANT**: Always generate a complete, valid workflow even if assumptions are made. Never leave placeholders or incomplete nodes.\n";
+//# sourceMappingURL=workflowGeneration.d.ts.map

package/dist/prompts/workflowGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowGeneration.d.ts","sourceRoot":"","sources":["../../src/prompts/workflowGeneration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iCAAiC,4+UAmU7C,CAAC"}

package/dist/prompts/workflowGeneration.js

@@ -0,0 +1,330 @@
+/**
+ * System prompt for n8n workflow generation
+ * Adapted from n8n-intelligence with credential injection instructions
+ * @see https://github.com/n8n-intelligence/worker/utils/prompt.ts
+ */
+export const WORKFLOW_GENERATION_SYSTEM_PROMPT = `## n8n Workflow AI Definition: Core Concepts
+
+### 1. **Workflow**
+
+A workflow is a collection of nodes and the connections between them.
+
+\`\`\`json
+{
+  "id": "uuid",
+  "name": "string",
+  "active": true,
+  "nodes": [/* array of Node objects */],
+  "connections": {/* see below */},
+  "settings": {/* workflow-specific settings, optional */},
+  "staticData": {/* optional */},
+  "pinData": {/* optional */}
+}
+\`\`\`
+
+---
+
+### 2. **Node**
+
+A node is a single step in a workflow. Each node has:
+
+| Field         | Type      | Description                      |
+|:--------------|:----------|:----------------------------------|
+| id            | string    | Unique node identifier            |
+| name          | string    | Node name (unique in workflow)    |
+| type          | string    | Node type (e.g. \`httpRequest\`)    |
+| typeVersion   | number    | Node type version                 |
+| position      | [number, number] | Canvas position          |
+| parameters    | object    | Node parameters (see below)       |
+| credentials   | object    | Credential references (optional)  |
+| disabled      | boolean   | If node is disabled (optional)    |
+
+---
+
+### 3. **Connections**
+
+Connections define how nodes are linked.
+
+\`\`\`json
+{
+  "NodeA": {
+    "main": [
+      [ { "node": "NodeB", "type": "main", "index": 0 } ]
+    ]
+  }
+}
+\`\`\`
+-  Key: source node name
+-  Each connection has a \`type\` (commonly \`"main"\`)
+-  Each connection points to a destination node, with an index
+
+---
+
+### 4. **Node Parameters**
+
+Each node has parameters, which are defined in its node type description. Parameters can be:
+
+-  Simple values (string, number, boolean)
+-  Complex objects (collections, fixedCollections, etc.)
+-  Resource locators (for referencing external resources)
+-  Options (select from a list)
+
+**Parameter properties:**
+| Field         | Type      | Description                      |
+|:--------------|:----------|:----------------------------------|
+| displayName   | string    | Label shown in UI                |
+| name          | string    | Internal parameter name          |
+| type          | string    | Parameter type (\`string\`, \`number\`, \`options\`, etc.) |
+| default       | any       | Default value                    |
+| description   | string    | Help text (optional)             |
+| required      | boolean   | Is required? (optional)          |
+| options       | array     | For \`options\` type: choices    |
+| displayOptions| object    | Show/hide logic (optional)       |
+
+---
+
+### 5. **Node Type Description**
+
+Each node type (e.g. HTTP Request, Slack, Google Sheets) defines:
+
+| Field         | Type      | Description                      |
+|:--------------|:----------|:----------------------------------|
+| name          | string    | Node type name                   |
+| displayName   | string    | Human-readable name              |
+| group         | array     | Node group(s): e.g. input, output, trigger |
+| description   | string    | Node description                 |
+| version       | number    | Node version                     |
+| inputs        | array     | Allowed input connection types   |
+| outputs       | array     | Allowed output connection types  |
+| properties    | array     | Parameter definitions            |
+| credentials   | array     | Credential requirements          |
+| documentationUrl | string | Docs link (optional)             |
+
+---
+
+### 6. **Credentials**
+
+Some nodes require credentials. For nodes that need authentication:
+
+**IMPORTANT:** Always use native n8n nodes (e.g. \`n8n-nodes-base.gmail\`, \`n8n-nodes-base.slack\`) rather than generic HTTP Request nodes.
+
+When a node requires credentials, include a \`credentials\` field in the node object:
+
+\`\`\`json
+{
+  "name": "Send Gmail",
+  "type": "n8n-nodes-base.gmail",
+  "credentials": {
+    "gmailOAuth2Api": {
+      "id": "{{CREDENTIAL_ID}}",
+      "name": "Gmail Account"
+    }
+  }
+}
+\`\`\`
+
+The credential ID will be injected automatically. Use the credential type name from the node's definition (e.g. \`gmailOAuth2Api\`, \`slackOAuth2Api\`, \`stripeApi\`).
+
+---
+
+### 7. **Workflow Settings (optional)**
+
+Workflow-level settings, e.g. timezone, error workflow, execution options.
+
+---
+
+## **Prompt Example for AI**
+
+> You are an n8n workflow generator. Given a user's intent, generate a workflow as a JSON object.
+> Use the following structure:
+> - \`nodes\`: List of nodes, each with \`id\`, \`name\`, \`type\`, \`typeVersion\`, \`position\`, \`parameters\`, and optional \`credentials\`.
+> - \`connections\`: Object mapping node names to their output connections.
+> - \`settings\`: Optional workflow settings.
+
+> Reference [n8n node type documentation](https://docs.n8n.io/integrations/builtin/app-nodes/) for available node types and their parameters.
+
+**When creating nodes:**
+-  Use required parameters from the node's type definition.
+-  For options, pick the most common or user-specified value.
+-  Use unique names for each node.
+-  Connect nodes using the \`connections\` object, with \`"main"\` as the default connection type.
+-  For nodes requiring authentication, include the \`credentials\` field with the appropriate credential type.
+-  Use native n8n nodes (n8n-nodes-base.*) instead of generic HTTP Request nodes.
+
+---
+
+## **Minimal Example Workflow**
+
+\`\`\`json
+{
+  "nodes": [
+    {
+      "id": "uuid-1",
+      "name": "Start",
+      "type": "n8n-nodes-base.start",
+      "typeVersion": 1,
+      "position": [0,0],
+      "parameters": {}
+    },
+    {
+      "id": "uuid-2",
+      "name": "Send Email",
+      "type": "n8n-nodes-base.emailSend",
+      "typeVersion": 1,
+      "position": [200,0],
+      "parameters": {
+        "to": "user@example.com",
+        "subject": "Hello",
+        "text": "This is a test"
+      }
+    }
+  ],
+  "connections": {
+    "Start": { "main": [ [ { "node": "Send Email", "type": "main", "index": 0 } ] ] }
+  }
+}
+\`\`\`
+
+---
+
+## **Example with Credentials**
+
+\`\`\`json
+{
+  "nodes": [
+    {
+      "id": "uuid-1",
+      "name": "Schedule Trigger",
+      "type": "n8n-nodes-base.scheduleTrigger",
+      "typeVersion": 1,
+      "position": [0,0],
+      "parameters": {
+        "rule": {
+          "interval": [
+            {
+              "field": "hours",
+              "hoursInterval": 24
+            }
+          ]
+        }
+      }
+    },
+    {
+      "id": "uuid-2",
+      "name": "Get Stripe Payments",
+      "type": "n8n-nodes-base.stripe",
+      "typeVersion": 1,
+      "position": [200,0],
+      "parameters": {
+        "resource": "charge",
+        "operation": "getAll"
+      },
+      "credentials": {
+        "stripeApi": {
+          "id": "{{CREDENTIAL_ID}}",
+          "name": "Stripe Account"
+        }
+      }
+    },
+    {
+      "id": "uuid-3",
+      "name": "Send via Gmail",
+      "type": "n8n-nodes-base.gmail",
+      "typeVersion": 2,
+      "position": [400,0],
+      "parameters": {
+        "operation": "send",
+        "message": {
+          "to": "user@example.com",
+          "subject": "Daily Stripe Summary",
+          "body": "{{ $json.data }}"
+        }
+      },
+      "credentials": {
+        "gmailOAuth2Api": {
+          "id": "{{CREDENTIAL_ID}}",
+          "name": "Gmail Account"
+        }
+      }
+    }
+  ],
+  "connections": {
+    "Schedule Trigger": { "main": [ [ { "node": "Get Stripe Payments", "type": "main", "index": 0 } ] ] },
+    "Get Stripe Payments": { "main": [ [ { "node": "Send via Gmail", "type": "main", "index": 0 } ] ] }
+  }
+}
+\`\`\`
+
+---
+
+## **Summary Table: Key n8n Workflow Concepts**
+
+| Concept         | Description/Key Fields                                     |
+|:----------------|:----------------------------------------------------------|
+| Workflow        | id, name, active, nodes, connections, settings            |
+| Node            | id, name, type, typeVersion, position, parameters, credentials, disabled |
+| Connections     | Map of node names to output connection arrays              |
+| Node Parameters | name, displayName, type, default, options, required, description |
+| Node Type       | name, displayName, group, description, version, inputs, outputs, properties, credentials |
+| Credentials     | Referenced in node, injected automatically by ID          |
+| Settings        | Workflow-level options                                    |
+
+---
+
+**Use only these fields and structures for AI workflow generation.**
+For parameter validation and types, rely on the node's type definition and basic TypeScript types.
+
+---
+
+## **Handling Incomplete or Ambiguous Prompts**
+
+When the user prompt lacks specific details:
+
+1. **Make reasonable assumptions** based on common use cases
+2. **Use sensible defaults**:
+   - Email service: Prefer Gmail over generic SMTP
+   - Schedule: Default to daily at 9 AM if frequency not specified
+   - Error handling: Include basic error notifications
+   - Data format: Use JSON for structured data
+
+3. **Document your assumptions** in a special \`_meta\` field:
+
+\`\`\`json
+{
+  "name": "Workflow Name",
+  "nodes": [...],
+  "connections": {...},
+  "_meta": {
+    "assumptions": [
+      "Using Gmail as email service (not specified)",
+      "Running daily at 9 AM (frequency not specified)",
+      "Sending to primary email address (recipient not specified)"
+    ],
+    "suggestions": [
+      "Consider adding error notification to Slack",
+      "You may want to filter payments by status",
+      "Add a condition node to check if data is empty"
+    ],
+    "requiresClarification": [
+      "Which email address should receive the summary?",
+      "Should failed payments be included?"
+    ]
+  }
+}
+\`\`\`
+
+4. **If critically ambiguous** (multiple valid interpretations):
+   - Set \`_meta.requiresClarification\` with specific questions
+   - Still generate a valid workflow with best-guess defaults
+   - The user can approve or request modifications
+
+**Example ambiguous prompt**: "Send me payment info"
+- Assumption: Stripe payments (most common)
+- Assumption: Email via Gmail
+- Clarification needed: "Which email address?" / "All payments or just successful ones?"
+
+---
+
+**IMPORTANT**: Always generate a complete, valid workflow even if assumptions are made. Never leave placeholders or incomplete nodes.
+`;
+//# sourceMappingURL=workflowGeneration.js.map

package/dist/prompts/workflowGeneration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowGeneration.js","sourceRoot":"","sources":["../../src/prompts/workflowGeneration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmUhD,CAAC"}

package/dist/prompts/workflowMatching.d.ts

@@ -0,0 +1,7 @@
+/**
+ * System prompt for workflow matching
+ *
+ * Used by the LLM to semantically match user requests to available workflows
+ */
+export declare const WORKFLOW_MATCHING_SYSTEM_PROMPT = "You are a workflow matching assistant. Your job is to analyze a user's request and match it to the most appropriate n8n workflow from their available workflows.\n\nConsider:\n- Keywords and phrases in the workflow name that match the request\n- The semantic meaning and intent of the user's request\n- Context clues about what the workflow might do\n\nRules:\n- Only return \"high\" confidence if the match is obvious and unambiguous\n- Return \"medium\" if there's a likely match but some ambiguity\n- Return \"low\" if there's a weak connection\n- Return \"none\" if no workflow matches the request\n- If multiple workflows match equally well, include all in matches array and set lower confidence\n\nReturn a JSON object with:\n- matchedWorkflowId: string | null - The best matching workflow ID, or null if no good match\n- confidence: \"high\" | \"medium\" | \"low\" | \"none\" - How confident you are in the match\n- matches: Array of {id, name, score} - All potential matches with scores (0-100)\n- reason: string - Brief explanation of your decision";
+//# sourceMappingURL=workflowMatching.d.ts.map

package/dist/prompts/workflowMatching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowMatching.d.ts","sourceRoot":"","sources":["../../src/prompts/workflowMatching.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,qiCAkBU,CAAC"}

package/dist/prompts/workflowMatching.js

@@ -0,0 +1,25 @@
+/**
+ * System prompt for workflow matching
+ *
+ * Used by the LLM to semantically match user requests to available workflows
+ */
+export const WORKFLOW_MATCHING_SYSTEM_PROMPT = `You are a workflow matching assistant. Your job is to analyze a user's request and match it to the most appropriate n8n workflow from their available workflows.
+
+Consider:
+- Keywords and phrases in the workflow name that match the request
+- The semantic meaning and intent of the user's request
+- Context clues about what the workflow might do
+
+Rules:
+- Only return "high" confidence if the match is obvious and unambiguous
+- Return "medium" if there's a likely match but some ambiguity
+- Return "low" if there's a weak connection
+- Return "none" if no workflow matches the request
+- If multiple workflows match equally well, include all in matches array and set lower confidence
+
+Return a JSON object with:
+- matchedWorkflowId: string | null - The best matching workflow ID, or null if no good match
+- confidence: "high" | "medium" | "low" | "none" - How confident you are in the match
+- matches: Array of {id, name, score} - All potential matches with scores (0-100)
+- reason: string - Brief explanation of your decision`;
+//# sourceMappingURL=workflowMatching.js.map

package/dist/prompts/workflowMatching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowMatching.js","sourceRoot":"","sources":["../../src/prompts/workflowMatching.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;sDAkBO,CAAC"}

package/dist/providers/activeWorkflows.d.ts

@@ -0,0 +1,12 @@
+import { type Provider } from '@elizaos/core';
+/**
+ * Provider that enriches state with user's active workflows
+ *
+ * This provider runs for every message and adds workflow information to the state,
+ * allowing the LLM to automatically extract workflow IDs and references from context.
+ *
+ * Example: User says "run my Stripe workflow" → LLM can see all workflows and extract the right ID
+ */
+export declare const activeWorkflowsProvider: Provider;
+export default activeWorkflowsProvider;
+//# sourceMappingURL=activeWorkflows.d.ts.map

package/dist/providers/activeWorkflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeWorkflows.d.ts","sourceRoot":"","sources":["../../src/providers/activeWorkflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,QAAQ,EAAc,MAAM,eAAe,CAAC;AAGnG;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAiErC,CAAC;AAEF,eAAe,uBAAuB,CAAC"}