@octo-cyber/ai 0.5.5 → 0.5.7

package/dist/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/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/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/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/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/workflow-design/agents/WorkflowValidatorAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowValidatorAgent.js","sourceRoot":"","sources":["../../../src/workflow-design/agents/WorkflowValidatorAgent.ts"],"names":[],"mappings":";;;AAAA,8DAAwD;AAGxD,+DAA+D;AAC/D,yBAAyB;AACzB,wEAAwE;AACxE,8DAA8D;AAC9D,+DAA+D;AAE/D,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;CAkBrB,CAAC;AAEF,MAAa,sBAAsB;IACJ;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,QAAQ,CAAC,QAAqB,EAAE,OAAkB;QACtD,oFAAoF;QACpF,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAElD,qDAAqD;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAc;YAC1B,GAAG,OAAO;YACV;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,iDAAiD,YAAY,UAAU;aACjF;SACF,CAAC;QAEF,IAAI,SAAS,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,2FAA2F;YAC3F,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;YACpI,MAAM,MAAM,GAAG,oCAAe,CAAC,kBAAkB,CAAmB,KAAK,CAAC,CAAC;YAC3E,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;YAC1D,SAAS,GAAG,EAAE,CAAC;QACjB,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC9D,CAAC;IAEO,cAAc,CAAC,QAAqB;QAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAEpC,wBAAwB;QACxB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,IAAI,sBAAsB,CAAC,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YACtD,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,gBAAgB,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,KAAK,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,2BAA2B,UAAU,kCAAkC,CAAC,CAAC;YACvF,CAAC;YACD,KAAK,MAAM,iBAAiB,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzD,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;oBAC1C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;wBAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;4BAC9B,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;wBACtF,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,MAAM,gBAAgB,GAAG,oDAAoD,CAAC;QAC9E,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,+BAA+B,IAAI,CAAC,IAAI,+DAA+D,CAAC,CAAC;YACzI,CAAC;QACH,CAAC;QAED,0DAA0D;QAC1D,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;YACxC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CACtC,CAAC;QACF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM,CAAC,IAAI,CAAC,wCAAwC,KAAK,gCAAgC,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAhGD,wDAgGC"}

package/dist/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/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/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/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/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/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/workflow-design/types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflow-design/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,uBAAuB;AACvB,+DAA+D"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@octo-cyber/ai",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "Octo AI module — Agent + Capability + SyncBridge + client registration",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
     },
     "./web": {
       "types": "./web/index.ts",
@@ -22,22 +22,27 @@
     }
   },
   "dependencies": {
-    "@octo-cyber/core": "^0.5.4",
+    "@anthropic-ai/sdk": "^0.80.0",
+    "node-screenshots": "^0.2.8",
     "@octo-cyber/auth": "^0.5.6",
+    "@octo-cyber/core": "^0.5.4",
     "@octo-cyber/task": "^0.5.3"
   },
+  "optionalDependencies": {
+    "@nut-tree/nut-js": "^4.2.0"
+  },
   "peerDependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
+    "@hookform/resolvers": "^5.0.0",
+    "@tanstack/react-table": "^8.0.0",
+    "lucide-react": ">=0.400.0",
     "next": "^16.0.0",
     "next-intl": "^4.0.0",
-    "lucide-react": ">=0.400.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "react-hook-form": "^7.0.0",
-    "@hookform/resolvers": "^5.0.0",
-    "@tanstack/react-table": "^8.0.0",
-    "zod": "^3.0.0",
     "sonner": "^2.0.0",
-    "@octo-cyber/ui": "^0.5.2"
+    "zod": "^3.0.0",
+    "@octo-cyber/ui": "^0.5.3"
   },
   "peerDependenciesMeta": {
     "@octo-cyber/ui": {
@@ -75,6 +80,7 @@
     }
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "typescript": "^5.8.0",
@@ -90,6 +96,7 @@
   "license": "MIT",
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
+    "build:web": "vite build --config vite.config.ts",
     "dev": "tsc -p tsconfig.build.json --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"