@octo-cyber/ai 0.5.4 → 0.5.6

package/dist/src/workflow-design/agents/CodeScriptAgent.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeScriptAgent = void 0;
+const OctoAgentClient_js_1 = require("../OctoAgentClient.js");
+// ============================================================
+// CodeScriptAgent
+// Generates JavaScript code snippets for Function/Code nodes.
+// Only invoked when at least one node has needsCodeGen = true (Phase 3).
+// ============================================================
+const SYSTEM_PROMPT = `You are an n8n JavaScript code generator for Code nodes.
+Your job is to write the body of n8n Code nodes based on a description of what the code should do.
+
+SECURITY CONSTRAINTS (mandatory — never violate):
+- Do NOT access external networks (no fetch, no require('http'), no require('https')) unless the user explicitly states the code must call an external API.
+- Do NOT read or write local files (no fs module, no require('fs')).
+- Do NOT execute child processes (no child_process, no exec, no spawn).
+- Do NOT access environment variables beyond what n8n already injects.
+
+n8n Code node context:
+- Input items are available as: const items = $input.all(); or $input.first()
+- Each item has: item.json, item.binary
+- Return value must be an array of items: return items; or return [{ json: {...} }]
+- Built-in helpers available: $now, $today, DateTime, $jmespath, $workflow, $execution, $node
+
+Rules:
+- Respond with ONLY a JSON object inside a markdown json fence.
+- The JSON must match this shape:
+  {
+    "codes": {
+      "<nodeId>": "<complete JS code string for that node>"
+    }
+  }
+- Each code value is the full jsCode string (not a function wrapper — just the statements).
+- Add a brief comment at the top of each snippet explaining what it does.
+- Keep each snippet under 40 lines.
+`;
+class CodeScriptAgent {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Generate code for all nodes marked needsCodeGen.
+     * @param actionSpecs  Full action spec list (to find code nodes).
+     * @param logicSpecs   Logic spec list (in case logic nodes also need code).
+     * @param history      Conversation history for context.
+     */
+    async generate(actionSpecs, logicSpecs, history) {
+        const requests = this.collectCodeRequests(actionSpecs, logicSpecs);
+        if (requests.length === 0) {
+            return { codes: {} };
+        }
+        const requestList = requests
+            .map((r) => `- Node "${r.nodeName}" (id: ${r.nodeId}): ${r.description}`)
+            .join('\n');
+        const prompt = `Generate JavaScript code for the following n8n Code nodes:\n\n${requestList}`;
+        const messages = [
+            ...history,
+            { role: 'user', content: prompt },
+        ];
+        // Cache the code-gen system prompt — same instructions for all code generation calls
+        const reply = await this.client.singleCall(messages, [{ type: 'text', text: SYSTEM_PROMPT, cache_control: { type: 'ephemeral' } }]);
+        const result = OctoAgentClient_js_1.OctoAgentClient.parseJsonFromReply(reply);
+        if (!result.codes || typeof result.codes !== 'object') {
+            throw new Error('CodeScriptAgent: missing codes object in response');
+        }
+        return result;
+    }
+    collectCodeRequests(actionSpecs, logicSpecs) {
+        const requests = [];
+        actionSpecs.forEach((spec, idx) => {
+            if (spec.needsCodeGen) {
+                requests.push({
+                    nodeId: `action_${idx}`,
+                    nodeName: spec.name,
+                    description: spec.codeDescription ?? `Execute custom logic for "${spec.name}"`,
+                });
+            }
+        });
+        // Logic nodes don't typically need code gen, but support it for completeness
+        logicSpecs.forEach((spec, idx) => {
+            const isCodeNode = spec.type === 'n8n-nodes-base.code' ||
+                spec.type === 'n8n-nodes-base.function';
+            if (isCodeNode) {
+                requests.push({
+                    nodeId: `logic_${idx}`,
+                    nodeName: spec.name,
+                    description: spec.condition ?? `Execute logic for "${spec.name}"`,
+                });
+            }
+        });
+        return requests;
+    }
+}
+exports.CodeScriptAgent = CodeScriptAgent;
+//# sourceMappingURL=CodeScriptAgent.js.map

package/dist/src/workflow-design/agents/CodeScriptAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeScriptAgent.js","sourceRoot":"","sources":["../../../../src/workflow-design/agents/CodeScriptAgent.ts"],"names":[],"mappings":";;;AAAA,8DAAwD;AAGxD,+DAA+D;AAC/D,kBAAkB;AAClB,8DAA8D;AAC9D,yEAAyE;AACzE,+DAA+D;AAE/D,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BrB,CAAC;AAQF,MAAa,eAAe;IACG;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,WAA6B,EAC7B,UAA2B,EAC3B,OAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAEnE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,QAAQ,UAAU,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;aACxE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,iEAAiE,WAAW,EAAE,CAAC;QAE9F,MAAM,QAAQ,GAAc;YAC1B,GAAG,OAAO;YACV,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC,CAAC;QAEF,qFAAqF;QACrF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;QACpI,MAAM,MAAM,GAAG,oCAAe,CAAC,kBAAkB,CAAmB,KAAK,CAAC,CAAC;QAE3E,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,mBAAmB,CACzB,WAA6B,EAC7B,UAA2B;QAE3B,MAAM,QAAQ,GAAkB,EAAE,CAAC;QAEnC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAChC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,UAAU,GAAG,EAAE;oBACvB,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,WAAW,EAAE,IAAI,CAAC,eAAe,IAAI,6BAA6B,IAAI,CAAC,IAAI,GAAG;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,6EAA6E;QAC7E,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC/B,MAAM,UAAU,GACd,IAAI,CAAC,IAAI,KAAK,qBAAqB;gBACnC,IAAI,CAAC,IAAI,KAAK,yBAAyB,CAAC;YAC1C,IAAI,UAAU,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,SAAS,GAAG,EAAE;oBACtB,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,WAAW,EAAE,IAAI,CAAC,SAAS,IAAI,sBAAsB,IAAI,CAAC,IAAI,GAAG;iBAClE,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA1ED,0CA0EC"}

package/dist/src/workflow-design/agents/LogicFlowAgent.d.ts

@@ -0,0 +1,9 @@
+import { OctoAgentClient } from '../OctoAgentClient.js';
+import type { ActionNodeSpec, LogicFlowResult, Message } from '../types.js';
+export declare class LogicFlowAgent {
+    private readonly client;
+    constructor(client: OctoAgentClient);
+    design(intent: string, actionSpecs: ActionNodeSpec[], history: Message[]): Promise<LogicFlowResult>;
+    private validateAndNormalise;
+}
+//# sourceMappingURL=LogicFlowAgent.d.ts.map

package/dist/src/workflow-design/agents/LogicFlowAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogicFlowAgent.d.ts","sourceRoot":"","sources":["../../../../src/workflow-design/agents/LogicFlowAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,OAAO,EACR,MAAM,aAAa,CAAC;AAiCrB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE9C,MAAM,CACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,cAAc,EAAE,EAC7B,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,eAAe,CAAC;IA4B3B,OAAO,CAAC,oBAAoB;CAgB7B"}

package/dist/src/workflow-design/agents/LogicFlowAgent.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogicFlowAgent = void 0;
+const OctoAgentClient_js_1 = require("../OctoAgentClient.js");
+const N8nNodeKnowledgeBase_js_1 = require("../N8nNodeKnowledgeBase.js");
+// ============================================================
+// LogicFlowAgent
+// Adds conditional branches, merge nodes, and error handling.
+// Runs in parallel with ActionChainAgent (Phase 2).
+// ============================================================
+const SYSTEM_PROMPT_BASE = `You are an n8n workflow logic flow designer.
+Your job is to identify where conditional branching (IF/Switch), merging (Merge), or error handling (Error Trigger) is needed in a workflow, and specify those nodes.
+
+Rules:
+- Respond with ONLY a JSON object inside a markdown json fence.
+- The JSON must match this shape exactly:
+  {
+    "specs": [
+      {
+        "type": "<n8n node type>",
+        "name": "<display name>",
+        "parameters": { <params> },
+        "position": { "x": <number>, "y": 300 },
+        "insertAfterIndex": <integer index into the action specs array>,
+        "condition": "<optional condition expression for IF/Switch>"
+      }
+    ],
+    "reasoning": "<brief explanation>"
+  }
+- If no logic nodes are needed, return { "specs": [], "reasoning": "No conditional logic required." }
+- "insertAfterIndex" is 0-based; -1 means before the first action node.
+- Use y: 120 for true-branch paths (if you want to indicate branching visually).
+- Provide realistic condition expressions using n8n expression syntax: e.g. {{ $json.status === 'error' }}
+`;
+class LogicFlowAgent {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async design(intent, actionSpecs, history) {
+        const system = [
+            { type: 'text', text: SYSTEM_PROMPT_BASE },
+            N8nNodeKnowledgeBase_js_1.N8nNodeKnowledgeBase.buildCachedBlock(['control']),
+        ];
+        const actionSummary = actionSpecs
+            .map((s, i) => `[${i}] ${s.name} (${s.type})`)
+            .join('\n');
+        const contextBlock = `Workflow requirement: ${intent}
+
+Current action nodes (in order):
+${actionSummary}
+
+Identify any conditional logic, branches, or error handling that should be added.`;
+        const messages = [
+            ...history,
+            { role: 'user', content: contextBlock },
+        ];
+        const reply = await this.client.singleCall(messages, system);
+        const result = OctoAgentClient_js_1.OctoAgentClient.parseJsonFromReply(reply);
+        return this.validateAndNormalise(result);
+    }
+    validateAndNormalise(result) {
+        if (!Array.isArray(result.specs)) {
+            throw new Error('LogicFlowAgent: specs must be an array');
+        }
+        const specs = result.specs.map((s, idx) => ({
+            type: s.type || 'n8n-nodes-base.if',
+            name: s.name || `Logic ${idx + 1}`,
+            parameters: s.parameters ?? {},
+            position: s.position ?? { x: 460, y: 120 },
+            insertAfterIndex: typeof s.insertAfterIndex === 'number' ? s.insertAfterIndex : -1,
+            condition: s.condition ?? undefined,
+        }));
+        return { specs, reasoning: result.reasoning ?? '' };
+    }
+}
+exports.LogicFlowAgent = LogicFlowAgent;
+//# sourceMappingURL=LogicFlowAgent.js.map

package/dist/src/workflow-design/agents/LogicFlowAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogicFlowAgent.js","sourceRoot":"","sources":["../../../../src/workflow-design/agents/LogicFlowAgent.ts"],"names":[],"mappings":";;;AAAA,8DAAwD;AACxD,wEAAkE;AAQlE,+DAA+D;AAC/D,iBAAiB;AACjB,8DAA8D;AAC9D,oDAAoD;AACpD,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuB1B,CAAC;AAEF,MAAa,cAAc;IACI;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,MAAM,CACV,MAAc,EACd,WAA6B,EAC7B,OAAkB;QAElB,MAAM,MAAM,GAAG;YACb,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE;YACnD,8CAAoB,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC;SACnD,CAAC;QAEF,MAAM,aAAa,GAAG,WAAW;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;aAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,YAAY,GAAG,yBAAyB,MAAM;;;EAGtD,aAAa;;kFAEmE,CAAC;QAE/E,MAAM,QAAQ,GAAc;YAC1B,GAAG,OAAO;YACV,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE;SACxC,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,oCAAe,CAAC,kBAAkB,CAAkB,KAAK,CAAC,CAAC;QAE1E,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAEO,oBAAoB,CAAC,MAAuB;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,KAAK,GAAoB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAC3D,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,mBAAmB;YACnC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS,GAAG,GAAG,CAAC,EAAE;YAClC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;YAC1C,gBAAgB,EAAE,OAAO,CAAC,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;YAClF,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,SAAS;SACpC,CAAC,CAAC,CAAC;QAEJ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;CACF;AAnDD,wCAmDC"}

package/dist/src/workflow-design/agents/TriggerAnalystAgent.d.ts

@@ -0,0 +1,9 @@
+import { OctoAgentClient } from '../OctoAgentClient.js';
+import type { Message, TriggerAnalysisResult } from '../types.js';
+export declare class TriggerAnalystAgent {
+    private readonly client;
+    constructor(client: OctoAgentClient);
+    analyse(intent: string, history: Message[]): Promise<TriggerAnalysisResult>;
+    private validateAndNormalise;
+}
+//# sourceMappingURL=TriggerAnalystAgent.d.ts.map

package/dist/src/workflow-design/agents/TriggerAnalystAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerAnalystAgent.d.ts","sourceRoot":"","sources":["../../../../src/workflow-design/agents/TriggerAnalystAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAmB,MAAM,aAAa,CAAC;AA4BnF,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE9C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoBjF,OAAO,CAAC,oBAAoB;CAc7B"}

package/dist/src/workflow-design/agents/TriggerAnalystAgent.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggerAnalystAgent = void 0;
+const OctoAgentClient_js_1 = require("../OctoAgentClient.js");
+const N8nNodeKnowledgeBase_js_1 = require("../N8nNodeKnowledgeBase.js");
+// ============================================================
+// TriggerAnalystAgent
+// Analyses user intent and selects the appropriate n8n trigger node.
+// ============================================================
+const SYSTEM_PROMPT_BASE = `You are an n8n workflow trigger specialist.
+Your only job is to identify the correct trigger node for a workflow based on the user's description.
+
+Rules:
+- Respond with ONLY a JSON object — no extra text, no markdown explanation outside the JSON fence.
+- The JSON must match this shape exactly:
+  {
+    "spec": {
+      "type": "<n8n node type string>",
+      "name": "<short display name>",
+      "parameters": { <relevant params> },
+      "position": { "x": 240, "y": 300 }
+    },
+    "reasoning": "<one sentence why this trigger>"
+  }
+- Use "x": 240, "y": 300 as the default position for all trigger nodes.
+- Choose the most specific trigger available; fall back to Manual Trigger only if truly unclear.
+- For cron/schedule triggers include a "rule" or "cronExpression" parameter with a sensible default.
+- For Webhook triggers include "httpMethod" (GET or POST) and a "path" parameter.
+`;
+class TriggerAnalystAgent {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async analyse(intent, history) {
+        const system = [
+            { type: 'text', text: SYSTEM_PROMPT_BASE },
+            N8nNodeKnowledgeBase_js_1.N8nNodeKnowledgeBase.buildCachedBlock(['trigger']),
+        ];
+        const messages = [
+            ...history,
+            {
+                role: 'user',
+                content: `Analyse the following workflow requirement and return the trigger node specification:\n\n${intent}`,
+            },
+        ];
+        const reply = await this.client.singleCall(messages, system);
+        const result = OctoAgentClient_js_1.OctoAgentClient.parseJsonFromReply(reply);
+        return this.validateAndNormalise(result);
+    }
+    validateAndNormalise(result) {
+        if (!result.spec?.type) {
+            throw new Error('TriggerAnalystAgent: missing spec.type in response');
+        }
+        const spec = {
+            type: result.spec.type,
+            name: result.spec.name || 'Trigger',
+            parameters: result.spec.parameters ?? {},
+            position: result.spec.position ?? { x: 240, y: 300 },
+        };
+        return { spec, reasoning: result.reasoning ?? '' };
+    }
+}
+exports.TriggerAnalystAgent = TriggerAnalystAgent;
+//# sourceMappingURL=TriggerAnalystAgent.js.map

package/dist/src/workflow-design/agents/TriggerAnalystAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerAnalystAgent.js","sourceRoot":"","sources":["../../../../src/workflow-design/agents/TriggerAnalystAgent.ts"],"names":[],"mappings":";;;AAAA,8DAAwD;AACxD,wEAAkE;AAGlE,+DAA+D;AAC/D,sBAAsB;AACtB,qEAAqE;AACrE,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;CAmB1B,CAAC;AAEF,MAAa,mBAAmB;IACD;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAkB;QAC9C,MAAM,MAAM,GAAG;YACb,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE;YACnD,8CAAoB,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC;SACnD,CAAC;QAEF,MAAM,QAAQ,GAAc;YAC1B,GAAG,OAAO;YACV;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,4FAA4F,MAAM,EAAE;aAC9G;SACF,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,oCAAe,CAAC,kBAAkB,CAAwB,KAAK,CAAC,CAAC;QAEhF,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAEO,oBAAoB,CAAC,MAA6B;QACxD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,IAAI,GAAoB;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;YACtB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,SAAS;YACnC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE;YACxC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SACrD,CAAC;QAEF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;IACrD,CAAC;CACF;AArCD,kDAqCC"}

package/dist/src/workflow-design/agents/WorkflowValidatorAgent.d.ts

@@ -0,0 +1,9 @@
+import { OctoAgentClient } from '../OctoAgentClient.js';
+import type { Message, N8nWorkflow, ValidationResult } from '../types.js';
+export declare class WorkflowValidatorAgent {
+    private readonly client;
+    constructor(client: OctoAgentClient);
+    validate(workflow: N8nWorkflow, history: Message[]): Promise<ValidationResult>;
+    private runLocalChecks;
+}
+//# sourceMappingURL=WorkflowValidatorAgent.d.ts.map

package/dist/src/workflow-design/agents/WorkflowValidatorAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowValidatorAgent.d.ts","sourceRoot":"","sources":["../../../../src/workflow-design/agents/WorkflowValidatorAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA4B1E,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE9C,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8BpF,OAAO,CAAC,cAAc;CA+DvB"}

package/dist/src/workflow-design/agents/WorkflowValidatorAgent.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowValidatorAgent = void 0;
+const OctoAgentClient_js_1 = require("../OctoAgentClient.js");
+// ============================================================
+// WorkflowValidatorAgent
+// Validates the assembled n8n workflow JSON for structural correctness.
+// Phase 5 — runs after Orchestrator assembles the final JSON.
+// ============================================================
+const SYSTEM_PROMPT = `You are an n8n workflow JSON validator.
+You will receive a complete n8n workflow JSON object and must validate it.
+
+Check for these issues:
+1. Every node referenced in "connections" must exist in "nodes" (by name).
+2. Every source node in connections must exist in "nodes".
+3. All nodes must have a non-empty "type" field in the correct format (e.g. "n8n-nodes-base.xxx" or "@n8n/n8n-nodes-langchain.xxx").
+4. All nodes must have a non-empty "name" field.
+5. All nodes must have a valid "position" array of two numbers.
+6. The workflow must have exactly one trigger node (a node whose type ends with "Trigger" or "Webhook" or is "n8n-nodes-base.manualTrigger").
+7. No duplicate node names.
+
+Respond with ONLY a JSON object inside a markdown json fence:
+{
+  "valid": <true|false>,
+  "errors": ["<error message>", ...]
+}
+If valid, "errors" should be an empty array.
+`;
+class WorkflowValidatorAgent {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async validate(workflow, history) {
+        // Run structural checks locally first (fast, no LLM call needed for obvious errors)
+        const localErrors = this.runLocalChecks(workflow);
+        // Also ask the LLM for a higher-level semantic check
+        const workflowJson = JSON.stringify(workflow, null, 2);
+        const messages = [
+            ...history,
+            {
+                role: 'user',
+                content: `Validate this n8n workflow JSON:\n\`\`\`json\n${workflowJson}\n\`\`\``,
+            },
+        ];
+        let llmErrors = [];
+        try {
+            // Cache the validator system prompt — it's large and identical across all validation calls
+            const reply = await this.client.singleCall(messages, [{ type: 'text', text: SYSTEM_PROMPT, cache_control: { type: 'ephemeral' } }]);
+            const result = OctoAgentClient_js_1.OctoAgentClient.parseJsonFromReply(reply);
+            llmErrors = Array.isArray(result.errors) ? result.errors : [];
+        }
+        catch {
+            // If LLM validation fails, fall back to local checks only
+            llmErrors = [];
+        }
+        const allErrors = [...new Set([...localErrors, ...llmErrors])];
+        return { valid: allErrors.length === 0, errors: allErrors };
+    }
+    runLocalChecks(workflow) {
+        const errors = [];
+        const nodeNames = new Set(workflow.nodes.map((n) => n.name));
+        const seenNames = new Set();
+        // Check duplicate names
+        for (const node of workflow.nodes) {
+            if (!node.name) {
+                errors.push(`Node with type "${node.type}" is missing a name.`);
+                continue;
+            }
+            if (seenNames.has(node.name)) {
+                errors.push(`Duplicate node name: "${node.name}".`);
+            }
+            seenNames.add(node.name);
+        }
+        // Check node type format
+        for (const node of workflow.nodes) {
+            if (!node.type) {
+                errors.push(`Node "${node.name}" has no type.`);
+            }
+        }
+        // Check connections reference valid nodes
+        for (const [sourceName, outputMap] of Object.entries(workflow.connections)) {
+            if (!nodeNames.has(sourceName)) {
+                errors.push(`Connection source node "${sourceName}" does not exist in nodes array.`);
+            }
+            for (const outputConnections of Object.values(outputMap)) {
+                for (const connGroup of outputConnections) {
+                    for (const conn of connGroup) {
+                        if (!nodeNames.has(conn.node)) {
+                            errors.push(`Connection target node "${conn.node}" does not exist in nodes array.`);
+                        }
+                    }
+                }
+            }
+        }
+        // Check node type format (must match n8n-nodes-base.xxx or @scope/pkg.xxx)
+        const validTypePattern = /^(@[^/]+\/[^.]+\.[a-zA-Z]|[a-zA-Z0-9-]+\.[a-zA-Z])/;
+        for (const node of workflow.nodes) {
+            if (node.type && !validTypePattern.test(node.type)) {
+                errors.push(`Node "${node.name}" has invalid type format: "${node.type}". Expected format: "n8n-nodes-base.xxx" or "@scope/pkg.xxx".`);
+            }
+        }
+        // Check exactly one trigger node (not zero, not multiple)
+        const triggerNodes = workflow.nodes.filter((n) => n.type.toLowerCase().includes('trigger') ||
+            n.type === 'n8n-nodes-base.webhook');
+        if (triggerNodes.length === 0) {
+            errors.push('Workflow has no trigger node.');
+        }
+        else if (triggerNodes.length > 1) {
+            const names = triggerNodes.map((n) => `"${n.name}"`).join(', ');
+            errors.push(`Workflow has multiple trigger nodes: ${names}. Only one trigger is allowed.`);
+        }
+        return errors;
+    }
+}
+exports.WorkflowValidatorAgent = WorkflowValidatorAgent;
+//# sourceMappingURL=WorkflowValidatorAgent.js.map

package/dist/src/workflow-design/agents/WorkflowValidatorAgent.js.map

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

package/dist/src/workflow-design/index.d.ts

@@ -0,0 +1,12 @@
+export { OctoAgentClient } from './OctoAgentClient.js';
+export { N8nNodeKnowledgeBase } from './N8nNodeKnowledgeBase.js';
+export { WorkflowDesignOrchestrator } from './WorkflowDesignOrchestrator.js';
+export { DocumentExtractorAgent } from './DocumentExtractorAgent.js';
+export { TriggerAnalystAgent } from './agents/TriggerAnalystAgent.js';
+export { ActionChainAgent } from './agents/ActionChainAgent.js';
+export { LogicFlowAgent } from './agents/LogicFlowAgent.js';
+export { CodeScriptAgent } from './agents/CodeScriptAgent.js';
+export { WorkflowValidatorAgent } from './agents/WorkflowValidatorAgent.js';
+export type { InvoiceData, InvoiceLineItem, ContractData, ContractParty, } from './DocumentExtractorAgent.js';
+export type { Message, Tool, NodePosition, TriggerNodeSpec, ActionNodeSpec, LogicNodeSpec, N8nNode, N8nWorkflow, WorkflowDraft, ValidationResult, ModificationScope, ParsedModificationIntent, TriggerAnalysisResult, ActionChainResult, LogicFlowResult, CodeScriptResult, NodeCategory, NodeTemplate, ToolDefinition, AgentRunOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/workflow-design/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow-design/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,YAAY,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,OAAO,EACP,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/src/workflow-design/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowValidatorAgent = exports.CodeScriptAgent = exports.LogicFlowAgent = exports.ActionChainAgent = exports.TriggerAnalystAgent = exports.DocumentExtractorAgent = exports.WorkflowDesignOrchestrator = exports.N8nNodeKnowledgeBase = exports.OctoAgentClient = void 0;
+var OctoAgentClient_js_1 = require("./OctoAgentClient.js");
+Object.defineProperty(exports, "OctoAgentClient", { enumerable: true, get: function () { return OctoAgentClient_js_1.OctoAgentClient; } });
+var N8nNodeKnowledgeBase_js_1 = require("./N8nNodeKnowledgeBase.js");
+Object.defineProperty(exports, "N8nNodeKnowledgeBase", { enumerable: true, get: function () { return N8nNodeKnowledgeBase_js_1.N8nNodeKnowledgeBase; } });
+var WorkflowDesignOrchestrator_js_1 = require("./WorkflowDesignOrchestrator.js");
+Object.defineProperty(exports, "WorkflowDesignOrchestrator", { enumerable: true, get: function () { return WorkflowDesignOrchestrator_js_1.WorkflowDesignOrchestrator; } });
+var DocumentExtractorAgent_js_1 = require("./DocumentExtractorAgent.js");
+Object.defineProperty(exports, "DocumentExtractorAgent", { enumerable: true, get: function () { return DocumentExtractorAgent_js_1.DocumentExtractorAgent; } });
+// Sub-agents (exported for testing / custom composition)
+var TriggerAnalystAgent_js_1 = require("./agents/TriggerAnalystAgent.js");
+Object.defineProperty(exports, "TriggerAnalystAgent", { enumerable: true, get: function () { return TriggerAnalystAgent_js_1.TriggerAnalystAgent; } });
+var ActionChainAgent_js_1 = require("./agents/ActionChainAgent.js");
+Object.defineProperty(exports, "ActionChainAgent", { enumerable: true, get: function () { return ActionChainAgent_js_1.ActionChainAgent; } });
+var LogicFlowAgent_js_1 = require("./agents/LogicFlowAgent.js");
+Object.defineProperty(exports, "LogicFlowAgent", { enumerable: true, get: function () { return LogicFlowAgent_js_1.LogicFlowAgent; } });
+var CodeScriptAgent_js_1 = require("./agents/CodeScriptAgent.js");
+Object.defineProperty(exports, "CodeScriptAgent", { enumerable: true, get: function () { return CodeScriptAgent_js_1.CodeScriptAgent; } });
+var WorkflowValidatorAgent_js_1 = require("./agents/WorkflowValidatorAgent.js");
+Object.defineProperty(exports, "WorkflowValidatorAgent", { enumerable: true, get: function () { return WorkflowValidatorAgent_js_1.WorkflowValidatorAgent; } });
+//# sourceMappingURL=index.js.map

package/dist/src/workflow-design/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow-design/index.ts"],"names":[],"mappings":";;;AAAA,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AACxB,qEAAiE;AAAxD,+HAAA,oBAAoB,OAAA;AAC7B,iFAA6E;AAApE,2IAAA,0BAA0B,OAAA;AACnC,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAE/B,yDAAyD;AACzD,0EAAsE;AAA7D,6HAAA,mBAAmB,OAAA;AAC5B,oEAAgE;AAAvD,uHAAA,gBAAgB,OAAA;AACzB,gEAA4D;AAAnD,mHAAA,cAAc,OAAA;AACvB,kEAA8D;AAArD,qHAAA,eAAe,OAAA;AACxB,gFAA4E;AAAnE,mIAAA,sBAAsB,OAAA"}

package/dist/src/workflow-design/types.d.ts

@@ -0,0 +1,155 @@
+export interface Message {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface NodePosition {
+    x: number;
+    y: number;
+}
+export interface TriggerNodeSpec {
+    /** n8n node type string, e.g. 'n8n-nodes-base.scheduleTrigger' */
+    type: string;
+    /** Human-readable name shown in editor */
+    name: string;
+    parameters: Record<string, unknown>;
+    position: NodePosition;
+}
+export interface ActionNodeSpec {
+    type: string;
+    name: string;
+    parameters: Record<string, unknown>;
+    position: NodePosition;
+    /** id of the upstream node this action depends on */
+    dependsOn?: string;
+    /** marks this node as needing code generation */
+    needsCodeGen?: boolean;
+    /** description for CodeScriptAgent when needsCodeGen = true */
+    codeDescription?: string;
+}
+export interface LogicNodeSpec {
+    type: string;
+    name: string;
+    parameters: Record<string, unknown>;
+    position: NodePosition;
+    /** index in actionSpecs after which this logic node is inserted */
+    insertAfterIndex: number;
+    /** condition expression for IF/Switch nodes */
+    condition?: string;
+}
+export interface N8nNodeConnection {
+    node: string;
+    type: string;
+    index: number;
+}
+export interface N8nNode {
+    id: string;
+    name: string;
+    type: string;
+    typeVersion: number;
+    position: [number, number];
+    parameters: Record<string, unknown>;
+}
+export interface N8nWorkflow {
+    name: string;
+    nodes: N8nNode[];
+    connections: Record<string, {
+        main: Array<Array<{
+            node: string;
+            type: string;
+            index: number;
+        }>>;
+    }>;
+    active: boolean;
+    settings: Record<string, unknown>;
+}
+export interface WorkflowDraft {
+    intent: string;
+    conversationHistory: Message[];
+    triggerSpec?: TriggerNodeSpec;
+    actionSpecs?: ActionNodeSpec[];
+    logicSpecs?: LogicNodeSpec[];
+    /** nodeId → generated code snippet */
+    codeSpecs?: Record<string, string>;
+    validationErrors?: string[];
+    finalWorkflow?: N8nWorkflow;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export type ModificationScope = 'trigger' | 'actions' | 'logic' | 'code' | 'all';
+export interface ParsedModificationIntent {
+    scope: ModificationScope;
+    description: string;
+}
+export interface TriggerAnalysisResult {
+    spec: TriggerNodeSpec;
+    reasoning: string;
+}
+export interface ActionChainResult {
+    specs: ActionNodeSpec[];
+    reasoning: string;
+}
+export interface LogicFlowResult {
+    specs: LogicNodeSpec[];
+    reasoning: string;
+}
+export interface CodeScriptResult {
+    /** nodeId → code */
+    codes: Record<string, string>;
+}
+/** A text content block marked for Anthropic prompt caching. */
+export interface CachedTextBlock {
+    type: 'text';
+    text: string;
+    cache_control: {
+        type: 'ephemeral';
+    };
+}
+/** System content accepted by OctoAgentClient — plain string or cached blocks. */
+export type SystemContent = string | Array<{
+    type: 'text';
+    text: string;
+    cache_control?: {
+        type: 'ephemeral';
+    };
+}>;
+export type NodeCategory = 'trigger' | 'http' | 'data' | 'control' | 'notification' | 'database' | 'file' | 'ai';
+export interface NodeTemplate {
+    type: string;
+    displayName: string;
+    category: NodeCategory;
+    /** Core parameter names users usually configure */
+    coreParams: string[];
+    /** Short description for prompts */
+    description: string;
+}
+/**
+ * A tool that the agent can call during an agent loop.
+ * The `execute` function receives parsed JSON arguments and returns a string result.
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    /** JSON Schema for the tool's input parameters. */
+    parameters: Record<string, unknown>;
+    execute: (args: unknown) => Promise<string>;
+}
+/** Options for running a full agent loop with optional tool use. */
+export interface AgentRunOptions {
+    systemPrompt: string;
+    userMessage: string;
+    tools?: ToolDefinition[];
+    /** Maximum number of LLM rounds (default 10). Prevents infinite loops. */
+    maxRounds?: number;
+    /** Timeout in ms for the entire run (default 300 000 ms = 5 min). */
+    timeoutMs?: number;
+    /** Called with each text chunk emitted by the assistant. */
+    onChunk?: (chunk: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/workflow-design/types.d.ts.map

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

package/dist/src/workflow-design/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// Shared message types
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map