@octo-cyber/ai 0.5.5 → 0.5.7

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

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowDesignOrchestrator = void 0;
+const ActionChainAgent_js_1 = require("./agents/ActionChainAgent.js");
+const CodeScriptAgent_js_1 = require("./agents/CodeScriptAgent.js");
+const LogicFlowAgent_js_1 = require("./agents/LogicFlowAgent.js");
+const TriggerAnalystAgent_js_1 = require("./agents/TriggerAnalystAgent.js");
+const WorkflowValidatorAgent_js_1 = require("./agents/WorkflowValidatorAgent.js");
+// ============================================================
+// WorkflowDesignOrchestrator
+// Main entry point. Maintains WorkflowDraft state and coordinates
+// sub-agents through the 5-phase pipeline.
+// ============================================================
+class WorkflowDesignOrchestrator {
+    client;
+    draft;
+    triggerAgent;
+    actionAgent;
+    logicAgent;
+    codeAgent;
+    validatorAgent;
+    constructor(client) {
+        this.client = client;
+        this.triggerAgent = new TriggerAnalystAgent_js_1.TriggerAnalystAgent(client);
+        this.actionAgent = new ActionChainAgent_js_1.ActionChainAgent(client);
+        this.logicAgent = new LogicFlowAgent_js_1.LogicFlowAgent(client);
+        this.codeAgent = new CodeScriptAgent_js_1.CodeScriptAgent(client);
+        this.validatorAgent = new WorkflowValidatorAgent_js_1.WorkflowValidatorAgent(client);
+        this.draft = { intent: '', conversationHistory: [] };
+    }
+    // ============================================================
+    // Public API
+    // ============================================================
+    /**
+     * First call: design a brand-new workflow from user intent.
+     */
+    async design(userMessage) {
+        this.draft.intent = userMessage;
+        this.draft.conversationHistory = [{ role: 'user', content: userMessage }];
+        await this.runFullPipeline();
+        if (!this.draft.finalWorkflow) {
+            throw new Error('WorkflowDesignOrchestrator: pipeline completed but finalWorkflow is not set');
+        }
+        return this.draft.finalWorkflow;
+    }
+    /**
+     * Subsequent calls: modify the existing workflow based on user follow-up.
+     * Only re-runs the sub-agents relevant to the detected modification scope.
+     */
+    async modify(userMessage) {
+        this.draft.conversationHistory.push({ role: 'user', content: userMessage });
+        const modification = this.detectModificationScope(userMessage);
+        switch (modification.scope) {
+            case 'trigger':
+                await this.runPhase1();
+                break;
+            case 'actions':
+                await this.runPhase2Actions();
+                break;
+            case 'logic':
+                await this.runPhase2Logic();
+                break;
+            case 'code':
+                await this.runPhase3();
+                break;
+            case 'all':
+                await this.runFullPipeline();
+                return this.draft.finalWorkflow;
+        }
+        // Re-assemble and re-validate after partial update
+        await this.runPhase4And5();
+        if (!this.draft.finalWorkflow) {
+            throw new Error('WorkflowDesignOrchestrator: modification pipeline completed but finalWorkflow is not set');
+        }
+        return this.draft.finalWorkflow;
+    }
+    /** Access the current draft (for debugging / partial progress). */
+    getDraft() {
+        return this.draft;
+    }
+    /** Reset state for a new conversation. */
+    reset() {
+        this.draft = { intent: '', conversationHistory: [] };
+    }
+    // ============================================================
+    // Pipeline phases
+    // ============================================================
+    async runFullPipeline() {
+        await this.runPhase1();
+        await this.runPhase2();
+        await this.runPhase3();
+        await this.runPhase4And5();
+    }
+    /** Phase 1: TriggerAnalystAgent (serial) */
+    async runPhase1() {
+        const result = await this.triggerAgent.analyse(this.draft.intent, this.draft.conversationHistory);
+        this.draft.triggerSpec = result.spec;
+    }
+    /** Phase 2: ActionChainAgent + LogicFlowAgent (parallel) */
+    async runPhase2() {
+        await Promise.all([
+            this.runPhase2Actions(),
+            this.runPhase2Logic(),
+        ]);
+    }
+    async runPhase2Actions() {
+        if (!this.draft.triggerSpec) {
+            await this.runPhase1();
+        }
+        const result = await this.actionAgent.design(this.draft.intent, this.draft.triggerSpec, this.draft.conversationHistory);
+        this.draft.actionSpecs = result.specs;
+    }
+    async runPhase2Logic() {
+        // LogicFlowAgent can run with an empty action list — it will return []
+        const actionSpecs = this.draft.actionSpecs ?? [];
+        const result = await this.logicAgent.design(this.draft.intent, actionSpecs, this.draft.conversationHistory);
+        this.draft.logicSpecs = result.specs;
+    }
+    /** Phase 3: CodeScriptAgent (conditional) */
+    async runPhase3() {
+        const actionSpecs = this.draft.actionSpecs ?? [];
+        const logicSpecs = this.draft.logicSpecs ?? [];
+        const hasCodeNodes = actionSpecs.some((s) => s.needsCodeGen);
+        if (!hasCodeNodes) {
+            this.draft.codeSpecs = {};
+            return;
+        }
+        const result = await this.codeAgent.generate(actionSpecs, logicSpecs, this.draft.conversationHistory);
+        this.draft.codeSpecs = result.codes;
+    }
+    /** Phase 4: Assemble + Phase 5: Validate */
+    async runPhase4And5() {
+        const workflow = this.assembleWorkflow();
+        this.draft.finalWorkflow = workflow;
+        const validation = await this.runPhase5(workflow);
+        this.draft.validationErrors = validation.errors;
+        if (!validation.valid) {
+            await this.repairFromValidationErrors(validation);
+        }
+    }
+    /** Phase 5: WorkflowValidatorAgent */
+    async runPhase5(workflow) {
+        return this.validatorAgent.validate(workflow, this.draft.conversationHistory);
+    }
+    // ============================================================
+    // Workflow assembly (Phase 4)
+    // ============================================================
+    assembleWorkflow() {
+        const nodes = [];
+        const connections = {};
+        const triggerSpec = this.draft.triggerSpec;
+        if (!triggerSpec) {
+            throw new Error('Cannot assemble workflow: triggerSpec is missing');
+        }
+        // 1. Trigger node
+        const triggerId = 'trigger_0';
+        nodes.push(this.specToNode(triggerSpec, triggerId));
+        // 2. Build ordered list: merge actionSpecs and logicSpecs by insertAfterIndex
+        const actionSpecs = this.draft.actionSpecs ?? [];
+        const logicSpecs = this.draft.logicSpecs ?? [];
+        const ordered = this.mergeActionAndLogic(actionSpecs, logicSpecs);
+        // 3. Build nodes + connections in order
+        let prevNodeName = triggerSpec.name;
+        ordered.forEach((item, idx) => {
+            const nodeId = `node_${idx}`;
+            const node = this.specToNode(item, nodeId);
+            // Inject generated code if applicable
+            if ('needsCodeGen' in item && item.needsCodeGen && this.draft.codeSpecs) {
+                const codeKey = `action_${actionSpecs.indexOf(item)}`;
+                const code = this.draft.codeSpecs[codeKey];
+                if (code) {
+                    node.parameters = { ...node.parameters, jsCode: code };
+                }
+            }
+            nodes.push(node);
+            // Connect previous → current
+            if (!connections[prevNodeName]) {
+                connections[prevNodeName] = { main: [[]] };
+            }
+            connections[prevNodeName].main[0].push({
+                node: node.name,
+                type: 'main',
+                index: 0,
+            });
+            prevNodeName = node.name;
+        });
+        return {
+            name: this.generateWorkflowName(),
+            nodes,
+            connections,
+            active: false,
+            settings: { executionOrder: 'v1' },
+        };
+    }
+    mergeActionAndLogic(actionSpecs, logicSpecs) {
+        const result = [...actionSpecs];
+        // Insert logic nodes at their specified positions (descending order to preserve indices)
+        const sorted = [...logicSpecs].sort((a, b) => b.insertAfterIndex - a.insertAfterIndex);
+        for (const logic of sorted) {
+            const insertAt = logic.insertAfterIndex + 1;
+            result.splice(insertAt, 0, logic);
+        }
+        return result;
+    }
+    specToNode(spec, id) {
+        return {
+            id,
+            name: spec.name,
+            type: spec.type,
+            typeVersion: 1,
+            position: [spec.position.x, spec.position.y],
+            parameters: spec.parameters,
+        };
+    }
+    generateWorkflowName() {
+        const words = this.draft.intent.split(/\s+/).slice(0, 5).join(' ');
+        return `Workflow: ${words}`;
+    }
+    // ============================================================
+    // Repair loop after validation errors
+    // ============================================================
+    async repairFromValidationErrors(validation) {
+        const MAX_REPAIR_ROUNDS = 2;
+        for (let round = 0; round < MAX_REPAIR_ROUNDS; round++) {
+            const errorSummary = validation.errors.join('; ');
+            // Classify which agents to re-run based on error messages
+            const needsTriggerRepair = /trigger/i.test(errorSummary);
+            const needsActionRepair = /node.*does not exist|missing.*name|duplicate/i.test(errorSummary);
+            if (needsTriggerRepair)
+                await this.runPhase1();
+            if (needsActionRepair) {
+                await this.runPhase2Actions();
+                await this.runPhase2Logic();
+            }
+            const repairedWorkflow = this.assembleWorkflow();
+            const reValidation = await this.runPhase5(repairedWorkflow);
+            this.draft.finalWorkflow = repairedWorkflow;
+            this.draft.validationErrors = reValidation.errors;
+            if (reValidation.valid)
+                break;
+        }
+    }
+    // ============================================================
+    // Modification intent detection
+    // ============================================================
+    detectModificationScope(userMessage) {
+        const lower = userMessage.toLowerCase();
+        if (/trigger|schedule|cron|webhook|每.*分钟|定时|触发/.test(lower)) {
+            return { scope: 'trigger', description: userMessage };
+        }
+        if (/代码|code|script|function|函数/.test(lower)) {
+            return { scope: 'code', description: userMessage };
+        }
+        if (/if|条件|判断|分支|error|错误|merge|合并|switch/.test(lower)) {
+            return { scope: 'logic', description: userMessage };
+        }
+        if (/add|remove|delete|step|节点|加一步|删掉|新增|修改步骤/.test(lower)) {
+            return { scope: 'actions', description: userMessage };
+        }
+        // Default: full re-design
+        return { scope: 'all', description: userMessage };
+    }
+}
+exports.WorkflowDesignOrchestrator = WorkflowDesignOrchestrator;
+//# sourceMappingURL=WorkflowDesignOrchestrator.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionChainAgent.d.ts","sourceRoot":"","sources":["../../../../src/workflow-design/agents/ActionChainAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EACV,iBAAiB,EAEjB,OAAO,EACP,eAAe,EAChB,MAAM,aAAa,CAAC;AAqCrB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE9C,MAAM,CACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAuB7B,OAAO,CAAC,oBAAoB;CAiB7B"}

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

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionChainAgent = void 0;
+const OctoAgentClient_js_1 = require("../OctoAgentClient.js");
+const N8nNodeKnowledgeBase_js_1 = require("../N8nNodeKnowledgeBase.js");
+// ============================================================
+// ActionChainAgent
+// Designs the main execution chain of action nodes for a workflow.
+// Runs in parallel with LogicFlowAgent (Phase 2).
+// ============================================================
+const SYSTEM_PROMPT_BASE = `You are an n8n workflow action chain designer.
+Your job is to design the sequence of action nodes that fulfil the user's workflow requirement.
+You will be told what trigger node was chosen; your nodes come AFTER the trigger.
+
+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 },
+        "dependsOn": "<name of upstream node or null>",
+        "needsCodeGen": <true|false>,
+        "codeDescription": "<optional description when needsCodeGen=true>"
+      }
+    ],
+    "reasoning": "<brief explanation>"
+  }
+- Start the first node's x at 460, increment by 220 for each subsequent node.
+- Set "dependsOn" to the name of the preceding node (trigger or action).
+  First action node's dependsOn = the trigger node name.
+- Mark "needsCodeGen": true for any Function/Code node, and provide "codeDescription".
+- Use realistic, minimal parameters; leave credentials as empty strings.
+- Include at most 8 action nodes.
+`;
+class ActionChainAgent {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async design(intent, triggerSpec, history) {
+        const categories = N8nNodeKnowledgeBase_js_1.N8nNodeKnowledgeBase.inferCategories(intent);
+        const actionCategories = categories.filter((c) => c !== 'trigger');
+        const system = [
+            { type: 'text', text: SYSTEM_PROMPT_BASE },
+            N8nNodeKnowledgeBase_js_1.N8nNodeKnowledgeBase.buildCachedBlock(actionCategories),
+        ];
+        const contextBlock = `Trigger node chosen: "${triggerSpec.name}" (type: ${triggerSpec.type})
+
+Workflow requirement: ${intent}`;
+        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('ActionChainAgent: specs must be an array');
+        }
+        const specs = result.specs.map((s, idx) => ({
+            type: s.type || 'n8n-nodes-base.set',
+            name: s.name || `Step ${idx + 1}`,
+            parameters: s.parameters ?? {},
+            position: s.position ?? { x: 460 + idx * 220, y: 300 },
+            dependsOn: s.dependsOn ?? undefined,
+            needsCodeGen: s.needsCodeGen ?? false,
+            codeDescription: s.codeDescription ?? undefined,
+        }));
+        return { specs, reasoning: result.reasoning ?? '' };
+    }
+}
+exports.ActionChainAgent = ActionChainAgent;
+//# sourceMappingURL=ActionChainAgent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionChainAgent.js","sourceRoot":"","sources":["../../../../src/workflow-design/agents/ActionChainAgent.ts"],"names":[],"mappings":";;;AAAA,8DAAwD;AACxD,wEAAkE;AAQlE,+DAA+D;AAC/D,mBAAmB;AACnB,mEAAmE;AACnE,kDAAkD;AAClD,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1B,CAAC;AAEF,MAAa,gBAAgB;IACE;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,MAAM,CACV,MAAc,EACd,WAA4B,EAC5B,OAAkB;QAElB,MAAM,UAAU,GAAG,8CAAoB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG;YACb,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE;YACnD,8CAAoB,CAAC,gBAAgB,CAAC,gBAAgB,CAAC;SACxD,CAAC;QAEF,MAAM,YAAY,GAAG,yBAAyB,WAAW,CAAC,IAAI,YAAY,WAAW,CAAC,IAAI;;wBAEtE,MAAM,EAAE,CAAC;QAE7B,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,CAAoB,KAAK,CAAC,CAAC;QAE5E,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAEO,oBAAoB,CAAC,MAAyB;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,KAAK,GAAqB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5D,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,oBAAoB;YACpC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,QAAQ,GAAG,GAAG,CAAC,EAAE;YACjC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;YACtD,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,SAAS;YACnC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,KAAK;YACrC,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,SAAS;SAChD,CAAC,CAAC,CAAC;QAEJ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;CACF;AA/CD,4CA+CC"}

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

@@ -0,0 +1,15 @@
+import { OctoAgentClient } from '../OctoAgentClient.js';
+import type { ActionNodeSpec, CodeScriptResult, LogicNodeSpec, Message } from '../types.js';
+export declare class CodeScriptAgent {
+    private readonly client;
+    constructor(client: OctoAgentClient);
+    /**
+     * 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.
+     */
+    generate(actionSpecs: ActionNodeSpec[], logicSpecs: LogicNodeSpec[], history: Message[]): Promise<CodeScriptResult>;
+    private collectCodeRequests;
+}
+//# sourceMappingURL=CodeScriptAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CodeScriptAgent.d.ts","sourceRoot":"","sources":["../../../../src/workflow-design/agents/CodeScriptAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA0C5F,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD;;;;;OAKG;IACG,QAAQ,CACZ,WAAW,EAAE,cAAc,EAAE,EAC7B,UAAU,EAAE,aAAa,EAAE,EAC3B,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,gBAAgB,CAAC;IA6B5B,OAAO,CAAC,mBAAmB;CAgC5B"}

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"}