@octo-cyber/ai 0.5.5 → 0.5.7

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

package/dist/src/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/dist/workflow-design/DocumentExtractorAgent.d.ts

@@ -0,0 +1,47 @@
+import { OctoAgentClient } from './OctoAgentClient.js';
+export interface InvoiceLineItem {
+    description: string;
+    quantity: number | null;
+    unitPrice: number | null;
+    amount: number | null;
+}
+export interface InvoiceData {
+    invoiceNumber: string | null;
+    date: string | null;
+    vendor: string | null;
+    totalAmount: number | null;
+    currency: string | null;
+    subtotal: number | null;
+    taxAmount: number | null;
+    lineItems: InvoiceLineItem[];
+}
+export interface ContractParty {
+    name: string;
+    role: string | null;
+}
+export interface ContractData {
+    title: string | null;
+    parties: ContractParty[];
+    effectiveDate: string | null;
+    expiryDate: string | null;
+    value: number | null;
+    currency: string | null;
+    keyTerms: string[];
+}
+export declare class DocumentExtractorAgent {
+    private readonly client;
+    constructor(client: OctoAgentClient);
+    /**
+     * Extract structured invoice data from a base64-encoded image.
+     * @param imageBase64  Base64-encoded image data (no data: URI prefix).
+     * @param mediaType    MIME type e.g. 'image/jpeg', 'image/png'.
+     */
+    extractInvoice(imageBase64: string, mediaType: string): Promise<InvoiceData>;
+    /**
+     * Extract structured contract data from a base64-encoded image.
+     * @param imageBase64  Base64-encoded image data (no data: URI prefix).
+     * @param mediaType    MIME type e.g. 'image/jpeg', 'image/png'.
+     */
+    extractContract(imageBase64: string, mediaType?: string): Promise<ContractData>;
+}
+//# sourceMappingURL=DocumentExtractorAgent.d.ts.map

package/dist/workflow-design/DocumentExtractorAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentExtractorAgent.d.ts","sourceRoot":"","sources":["../../src/workflow-design/DocumentExtractorAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQvD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAyDD,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD;;;;OAIG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BlF;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAe,GAAG,OAAO,CAAC,YAAY,CAAC;CAyB5F"}

package/dist/workflow-design/DocumentExtractorAgent.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentExtractorAgent = void 0;
+const OctoAgentClient_js_1 = require("./OctoAgentClient.js");
+const INVOICE_SYSTEM = {
+    type: 'text',
+    text: `You are a document data extraction specialist.
+Extract structured data from the provided invoice image and return ONLY a JSON object.
+The JSON must match this shape exactly:
+{
+  "invoiceNumber": "string or null",
+  "date": "ISO date string (YYYY-MM-DD) or null",
+  "vendor": "vendor/supplier name or null",
+  "totalAmount": number or null,
+  "currency": "3-letter ISO code e.g. USD, CNY, EUR or null",
+  "subtotal": number or null,
+  "taxAmount": number or null,
+  "lineItems": [
+    {
+      "description": "item description",
+      "quantity": number or null,
+      "unitPrice": number or null,
+      "amount": number or null
+    }
+  ]
+}
+Return null for any field you cannot determine from the image. Do not guess.`,
+    cache_control: { type: 'ephemeral' },
+};
+const CONTRACT_SYSTEM = {
+    type: 'text',
+    text: `You are a document data extraction specialist.
+Extract structured data from the provided contract image and return ONLY a JSON object.
+The JSON must match this shape exactly:
+{
+  "title": "contract title or null",
+  "parties": [{ "name": "party name", "role": "role e.g. Buyer/Seller/Licensor or null" }],
+  "effectiveDate": "ISO date string (YYYY-MM-DD) or null",
+  "expiryDate": "ISO date string (YYYY-MM-DD) or null",
+  "value": number or null,
+  "currency": "3-letter ISO code or null",
+  "keyTerms": ["brief description of key term or obligation"]
+}
+Return null for any field you cannot determine. Keep keyTerms concise (max 10 items).`,
+    cache_control: { type: 'ephemeral' },
+};
+function toMediaType(raw) {
+    const normalised = raw.toLowerCase().replace('jpg', 'jpeg');
+    const supported = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
+    if (supported.includes(normalised)) {
+        return normalised;
+    }
+    return 'image/jpeg';
+}
+class DocumentExtractorAgent {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Extract structured invoice data from a base64-encoded image.
+     * @param imageBase64  Base64-encoded image data (no data: URI prefix).
+     * @param mediaType    MIME type e.g. 'image/jpeg', 'image/png'.
+     */
+    async extractInvoice(imageBase64, mediaType) {
+        const imageBlock = {
+            type: 'image',
+            source: {
+                type: 'base64',
+                media_type: toMediaType(mediaType),
+                data: imageBase64,
+            },
+        };
+        const response = await this.client.anthropic.messages.create({
+            model: 'claude-sonnet-4-5',
+            system: [INVOICE_SYSTEM],
+            messages: [
+                {
+                    role: 'user',
+                    content: [imageBlock, { type: 'text', text: 'Extract all invoice data from this image.' }],
+                },
+            ],
+            max_tokens: 2048,
+        });
+        const textBlock = response.content.find((b) => b.type === 'text');
+        return OctoAgentClient_js_1.OctoAgentClient.parseJsonFromReply(textBlock?.text ?? '{}');
+    }
+    /**
+     * Extract structured contract data from a base64-encoded image.
+     * @param imageBase64  Base64-encoded image data (no data: URI prefix).
+     * @param mediaType    MIME type e.g. 'image/jpeg', 'image/png'.
+     */
+    async extractContract(imageBase64, mediaType = 'image/jpeg') {
+        const imageBlock = {
+            type: 'image',
+            source: {
+                type: 'base64',
+                media_type: toMediaType(mediaType),
+                data: imageBase64,
+            },
+        };
+        const response = await this.client.anthropic.messages.create({
+            model: 'claude-sonnet-4-5',
+            system: [CONTRACT_SYSTEM],
+            messages: [
+                {
+                    role: 'user',
+                    content: [imageBlock, { type: 'text', text: 'Extract all contract data from this image.' }],
+                },
+            ],
+            max_tokens: 2048,
+        });
+        const textBlock = response.content.find((b) => b.type === 'text');
+        return OctoAgentClient_js_1.OctoAgentClient.parseJsonFromReply(textBlock?.text ?? '{}');
+    }
+}
+exports.DocumentExtractorAgent = DocumentExtractorAgent;
+//# sourceMappingURL=DocumentExtractorAgent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentExtractorAgent.js","sourceRoot":"","sources":["../../src/workflow-design/DocumentExtractorAgent.ts"],"names":[],"mappings":";;;AAEA,6DAAuD;AAyCvD,MAAM,cAAc,GAAwE;IAC1F,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;6EAoBqE;IAC3E,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;CACrC,CAAC;AAEF,MAAM,eAAe,GAAwE;IAC3F,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE;;;;;;;;;;;;sFAY8E;IACpF,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;CACrC,CAAC;AAIF,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAyB,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC/F,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAgC,CAAC,EAAE,CAAC;QACzD,OAAO,UAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAa,sBAAsB;IACJ;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,WAAmB,EAAE,SAAiB;QACzD,MAAM,UAAU,GAAoB;YAClC,IAAI,EAAE,OAAO;YACb,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC;gBAClC,IAAI,EAAE,WAAW;aAClB;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3D,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,CAAC,cAAc,CAAC;YACxB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2CAA2C,EAAE,CAAC;iBAC3F;aACF;YACD,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAoC,CAAC;QACrG,OAAO,oCAAe,CAAC,kBAAkB,CAAc,SAAS,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IAClF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,WAAmB,EAAE,SAAS,GAAG,YAAY;QACjE,MAAM,UAAU,GAAoB;YAClC,IAAI,EAAE,OAAO;YACb,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC;gBAClC,IAAI,EAAE,WAAW;aAClB;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3D,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,CAAC,eAAe,CAAC;YACzB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4CAA4C,EAAE,CAAC;iBAC5F;aACF;YACD,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAoC,CAAC;QACrG,OAAO,oCAAe,CAAC,kBAAkB,CAAe,SAAS,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IACnF,CAAC;CACF;AAhED,wDAgEC"}

package/dist/workflow-design/N8nNodeKnowledgeBase.d.ts

@@ -0,0 +1,26 @@
+import type { CachedTextBlock, NodeCategory, NodeTemplate } from './types.js';
+export declare class N8nNodeKnowledgeBase {
+    private static readonly templates;
+    /** Return templates matching the given categories. */
+    static getByCategories(categories: NodeCategory[]): NodeTemplate[];
+    /** Return all templates. */
+    static getAll(): NodeTemplate[];
+    /** Find a template by its n8n type string. */
+    static findByType(type: string): NodeTemplate | undefined;
+    /**
+     * Build a compact prompt fragment listing the relevant nodes.
+     * Orchestrator calls this to inject node knowledge into sub-agent prompts.
+     */
+    static buildPromptSection(categories: NodeCategory[]): string;
+    /**
+     * Build a prompt section as a cached content block for use with Anthropic SDK.
+     * Applying cache_control saves ~90% cost when the same knowledge is passed repeatedly.
+     */
+    static buildCachedBlock(categories: NodeCategory[]): CachedTextBlock;
+    /**
+     * Infer relevant categories from a free-text intent description.
+     * Used by the Orchestrator to pick which node docs to inject.
+     */
+    static inferCategories(intent: string): NodeCategory[];
+}
+//# sourceMappingURL=N8nNodeKnowledgeBase.d.ts.map

package/dist/workflow-design/N8nNodeKnowledgeBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"N8nNodeKnowledgeBase.d.ts","sourceRoot":"","sources":["../../src/workflow-design/N8nNodeKnowledgeBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsQ9E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAEnE,sDAAsD;IACtD,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAIlE,4BAA4B;IAC5B,MAAM,CAAC,MAAM,IAAI,YAAY,EAAE;IAI/B,8CAA8C;IAC9C,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzD;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM;IAU7D;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,eAAe;IAQpE;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;CAmBvD"}