@octo-cyber/ai 0.5.4 → 0.5.6

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

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

package/dist/src/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/src/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;AAkT9E,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"}

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

@@ -0,0 +1,362 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N8nNodeKnowledgeBase = void 0;
+// ============================================================
+// Embedded n8n node knowledge base
+// No external fetch — all data is inlined here.
+// ============================================================
+const NODE_TEMPLATES = [
+    // ----------------------------------------------------------
+    // Triggers
+    // ----------------------------------------------------------
+    {
+        type: 'n8n-nodes-base.manualTrigger',
+        displayName: 'Manual Trigger',
+        category: 'trigger',
+        coreParams: [],
+        description: 'Manually start the workflow from the n8n editor.',
+    },
+    {
+        type: 'n8n-nodes-base.scheduleTrigger',
+        displayName: 'Schedule Trigger (Cron)',
+        category: 'trigger',
+        coreParams: ['rule', 'cronExpression', 'interval'],
+        description: 'Trigger on a fixed schedule or cron expression.',
+    },
+    {
+        type: 'n8n-nodes-base.webhook',
+        displayName: 'Webhook',
+        category: 'trigger',
+        coreParams: ['httpMethod', 'path', 'authentication', 'responseMode'],
+        description: 'Receive HTTP requests and start the workflow.',
+    },
+    {
+        type: 'n8n-nodes-base.emailTrigger',
+        displayName: 'Email Trigger (IMAP)',
+        category: 'trigger',
+        coreParams: ['mailbox', 'credentials', 'format'],
+        description: 'Trigger when a new email arrives in an IMAP mailbox.',
+    },
+    {
+        type: 'n8n-nodes-base.n8nTrigger',
+        displayName: 'n8n Trigger (Workflow Event)',
+        category: 'trigger',
+        coreParams: ['events'],
+        description: 'Trigger on internal n8n events (workflow updated, etc.).',
+    },
+    // ----------------------------------------------------------
+    // HTTP / API
+    // ----------------------------------------------------------
+    {
+        type: 'n8n-nodes-base.httpRequest',
+        displayName: 'HTTP Request',
+        category: 'http',
+        coreParams: ['method', 'url', 'authentication', 'headers', 'body', 'qs'],
+        description: 'Make any HTTP/REST API call.',
+    },
+    {
+        type: 'n8n-nodes-base.respondToWebhook',
+        displayName: 'Webhook Response',
+        category: 'http',
+        coreParams: ['respondWith', 'responseBody', 'responseCode', 'responseHeaders'],
+        description: 'Send a response back to the caller of a Webhook trigger.',
+    },
+    // ----------------------------------------------------------
+    // Data processing
+    // ----------------------------------------------------------
+    {
+        type: 'n8n-nodes-base.set',
+        displayName: 'Set',
+        category: 'data',
+        coreParams: ['values', 'keepOnlySet'],
+        description: 'Set, rename, or delete fields on items.',
+    },
+    {
+        type: 'n8n-nodes-base.code',
+        displayName: 'Code (Function)',
+        category: 'data',
+        coreParams: ['jsCode', 'mode'],
+        description: 'Run custom JavaScript code against the input items.',
+    },
+    {
+        type: 'n8n-nodes-base.itemLists',
+        displayName: 'Item Lists',
+        category: 'data',
+        coreParams: ['operation', 'fieldToSplitOut', 'fieldsToAggregate'],
+        description: 'Split, aggregate, or deduplicate item lists.',
+    },
+    {
+        type: 'n8n-nodes-base.extractFromFile',
+        displayName: 'JSON Parse / Extract',
+        category: 'data',
+        coreParams: ['operation', 'dataPropertyName'],
+        description: 'Parse JSON strings or extract data from binary files.',
+    },
+    // ----------------------------------------------------------
+    // Conditional / flow control
+    // ----------------------------------------------------------
+    {
+        type: 'n8n-nodes-base.if',
+        displayName: 'IF',
+        category: 'control',
+        coreParams: ['conditions'],
+        description: 'Route items down true/false branches based on conditions.',
+    },
+    {
+        type: 'n8n-nodes-base.switch',
+        displayName: 'Switch',
+        category: 'control',
+        coreParams: ['mode', 'rules'],
+        description: 'Route items to one of multiple outputs based on value.',
+    },
+    {
+        type: 'n8n-nodes-base.merge',
+        displayName: 'Merge',
+        category: 'control',
+        coreParams: ['mode', 'joinMode'],
+        description: 'Merge items from two branches.',
+    },
+    {
+        type: 'n8n-nodes-base.wait',
+        displayName: 'Wait',
+        category: 'control',
+        coreParams: ['resume', 'amount', 'unit'],
+        description: 'Pause the workflow execution for a specified time.',
+    },
+    {
+        type: 'n8n-nodes-base.errorTrigger',
+        displayName: 'Error Trigger',
+        category: 'control',
+        coreParams: [],
+        description: 'Trigger a separate error-handling workflow on failure.',
+    },
+    // ----------------------------------------------------------
+    // Notifications
+    // ----------------------------------------------------------
+    {
+        type: 'n8n-nodes-base.emailSend',
+        displayName: 'Send Email (SMTP)',
+        category: 'notification',
+        coreParams: ['fromEmail', 'toEmail', 'subject', 'text', 'html', 'credentials'],
+        description: 'Send an email via SMTP.',
+    },
+    {
+        type: 'n8n-nodes-base.gmail',
+        displayName: 'Gmail',
+        category: 'notification',
+        coreParams: ['operation', 'to', 'subject', 'message', 'credentials'],
+        description: 'Send or manage Gmail messages.',
+    },
+    {
+        type: 'n8n-nodes-base.slack',
+        displayName: 'Slack',
+        category: 'notification',
+        coreParams: ['operation', 'channel', 'text', 'credentials'],
+        description: 'Post messages or manage Slack channels.',
+    },
+    {
+        type: 'n8n-nodes-base.telegram',
+        displayName: 'Telegram',
+        category: 'notification',
+        coreParams: ['operation', 'chatId', 'text', 'credentials'],
+        description: 'Send messages via Telegram Bot API.',
+    },
+    // ----------------------------------------------------------
+    // Databases
+    // ----------------------------------------------------------
+    {
+        type: 'n8n-nodes-base.postgres',
+        displayName: 'Postgres',
+        category: 'database',
+        coreParams: ['operation', 'query', 'table', 'columns', 'credentials'],
+        description: 'Execute queries against a PostgreSQL database.',
+    },
+    {
+        type: 'n8n-nodes-base.mySql',
+        displayName: 'MySQL',
+        category: 'database',
+        coreParams: ['operation', 'query', 'table', 'credentials'],
+        description: 'Execute queries against a MySQL/MariaDB database.',
+    },
+    {
+        type: 'n8n-nodes-base.redis',
+        displayName: 'Redis',
+        category: 'database',
+        coreParams: ['operation', 'key', 'value', 'credentials'],
+        description: 'Get/set/delete keys in a Redis store.',
+    },
+    {
+        type: 'n8n-nodes-base.mongoDb',
+        displayName: 'MongoDB',
+        category: 'database',
+        coreParams: ['operation', 'collection', 'query', 'credentials'],
+        description: 'Interact with a MongoDB collection.',
+    },
+    // ----------------------------------------------------------
+    // Files
+    // ----------------------------------------------------------
+    {
+        type: 'n8n-nodes-base.readBinaryFiles',
+        displayName: 'Read Binary Files',
+        category: 'file',
+        coreParams: ['filePath'],
+        description: 'Read one or more files from the local filesystem.',
+    },
+    {
+        type: 'n8n-nodes-base.writeBinaryFile',
+        displayName: 'Write Binary File',
+        category: 'file',
+        coreParams: ['fileName', 'dataPropertyName'],
+        description: 'Write binary data to a local file.',
+    },
+    {
+        type: 'n8n-nodes-base.awsS3',
+        displayName: 'S3',
+        category: 'file',
+        coreParams: ['operation', 'bucketName', 'fileName', 'credentials'],
+        description: 'Upload/download objects in AWS S3 or compatible storage.',
+    },
+    // ----------------------------------------------------------
+    // AI / LLM  (n8n v1.x)
+    // ----------------------------------------------------------
+    {
+        type: '@n8n/n8n-nodes-langchain.openAi',
+        displayName: 'OpenAI',
+        category: 'ai',
+        coreParams: ['operation', 'model', 'prompt', 'credentials'],
+        description: 'Call OpenAI Chat Completions, Embeddings, or DALL-E. (n8n v1.x)',
+    },
+    {
+        type: '@n8n/n8n-nodes-langchain.lmChatAnthropic',
+        displayName: 'Anthropic (Claude)',
+        category: 'ai',
+        coreParams: ['model', 'credentials'],
+        description: 'Use Claude as a LangChain chat model inside an AI Agent. (n8n v1.x)',
+    },
+    {
+        type: '@n8n/n8n-nodes-langchain.agent',
+        displayName: 'AI Agent (LangChain)',
+        category: 'ai',
+        coreParams: ['agentType', 'text', 'options'],
+        description: 'Orchestrate tools with a LangChain agent loop. (n8n v1.x)',
+    },
+    {
+        type: '@n8n/n8n-nodes-langchain.chainLlm',
+        displayName: 'LLM Chain',
+        category: 'ai',
+        coreParams: ['prompt', 'model'],
+        description: 'Simple single-step LLM chain. (n8n v1.x)',
+    },
+    // ----------------------------------------------------------
+    // Octo custom nodes
+    // ----------------------------------------------------------
+    {
+        type: 'octoAgent',
+        displayName: 'Octo Agent',
+        category: 'ai',
+        coreParams: ['prompt', 'maxRounds', 'timeout'],
+        description: 'AI agent with universal computer control — takes screenshots, reads any screen content, ' +
+            'clicks, types, scrolls, and presses keys to automate any desktop application. ' +
+            'Input: prompt (task description). Output: { success, output, prompt }. ' +
+            'Use when the task requires interacting with GUI applications, reading screen content, ' +
+            'or automating workflows that have no API.',
+    },
+    {
+        type: 'octoClaudeCliTool',
+        displayName: 'Octo Claude CLI',
+        category: 'ai',
+        coreParams: ['toolDescription', 'workingDir', 'timeout'],
+        description: 'Execute Claude CLI as an AI Agent tool via Octo for code generation and analysis.',
+    },
+    {
+        type: 'octoGeminiCliTool',
+        displayName: 'Octo Gemini CLI',
+        category: 'ai',
+        coreParams: ['toolDescription', 'workingDir', 'timeout'],
+        description: 'Execute Gemini CLI as an AI Agent tool via Octo.',
+    },
+    {
+        type: 'octoNotification',
+        displayName: 'Octo Notification',
+        category: 'notification',
+        coreParams: ['title', 'content', 'channel', 'userId'],
+        description: 'Send a notification via Octo notification center.',
+    },
+    {
+        type: 'octoKnowledge',
+        displayName: 'Octo Knowledge',
+        category: 'ai',
+        coreParams: ['operation', 'query', 'groupId'],
+        description: 'Search or retrieve notes from the Octo knowledge base.',
+    },
+];
+// ============================================================
+// Public API
+// ============================================================
+class N8nNodeKnowledgeBase {
+    static templates = NODE_TEMPLATES;
+    /** Return templates matching the given categories. */
+    static getByCategories(categories) {
+        return this.templates.filter((t) => categories.includes(t.category));
+    }
+    /** Return all templates. */
+    static getAll() {
+        return this.templates;
+    }
+    /** Find a template by its n8n type string. */
+    static findByType(type) {
+        return this.templates.find((t) => t.type === type);
+    }
+    /**
+     * Build a compact prompt fragment listing the relevant nodes.
+     * Orchestrator calls this to inject node knowledge into sub-agent prompts.
+     */
+    static buildPromptSection(categories) {
+        const nodes = this.getByCategories(categories);
+        if (nodes.length === 0)
+            return '';
+        const lines = nodes.map((n) => `- ${n.displayName} (type: \`${n.type}\`): ${n.description} Core params: ${n.coreParams.join(', ') || 'none'}.`);
+        return `## Available n8n Nodes\n${lines.join('\n')}`;
+    }
+    /**
+     * 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) {
+        return {
+            type: 'text',
+            text: this.buildPromptSection(categories),
+            cache_control: { type: 'ephemeral' },
+        };
+    }
+    /**
+     * Infer relevant categories from a free-text intent description.
+     * Used by the Orchestrator to pick which node docs to inject.
+     */
+    static inferCategories(intent) {
+        const lower = intent.toLowerCase();
+        const categories = new Set();
+        // Always include triggers and data processing
+        categories.add('trigger');
+        categories.add('data');
+        if (/http|api|rest|fetch|request|webhook|url/.test(lower))
+            categories.add('http');
+        if (/email|mail|gmail|smtp/.test(lower))
+            categories.add('notification');
+        if (/slack|telegram|notify|notification|alert|message/.test(lower))
+            categories.add('notification');
+        if (/if|condition|branch|switch|route|filter|check/.test(lower))
+            categories.add('control');
+        if (/error|retry|fail|fallback/.test(lower))
+            categories.add('control');
+        if (/postgres|mysql|sqlite|db|database|sql|mongo|redis/.test(lower))
+            categories.add('database');
+        if (/file|upload|download|s3|storage|binary/.test(lower))
+            categories.add('file');
+        if (/ai|llm|gpt|claude|openai|anthropic|langchain|agent|chat/.test(lower))
+            categories.add('ai');
+        return Array.from(categories);
+    }
+}
+exports.N8nNodeKnowledgeBase = N8nNodeKnowledgeBase;
+//# sourceMappingURL=N8nNodeKnowledgeBase.js.map

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

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

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

@@ -0,0 +1,42 @@
+import Anthropic from '@anthropic-ai/sdk';
+import type { MessageParam } from '@anthropic-ai/sdk/resources';
+import type { AgentRunOptions, Message, Tool, SystemContent } from './types.js';
+export declare class OctoAgentClient {
+    private readonly model;
+    /**
+     * Exposed for test injection:
+     *   vi.spyOn(client.anthropic.messages, 'create').mockResolvedValue(...)
+     */
+    readonly anthropic: Anthropic;
+    constructor(model?: string, baseUrl?: string);
+    /**
+     * Single-turn LLM call.
+     * @param messages     Conversation turns (user/assistant only — no system).
+     * @param system       System instructions: plain string or cached content blocks.
+     * @param tools        Optional tool definitions (ignored in the Anthropic call here;
+     *                     use run() for tool-calling loops).
+     * @returns            The assistant's text reply.
+     */
+    singleCall(messages: Message[], system: SystemContent, tools?: Tool[]): Promise<string>;
+    /**
+     * Run a full agent loop.
+     * Sends systemPrompt + userMessage, processes tool_calls until the model
+     * stops calling tools or maxRounds is reached.
+     *
+     * @returns The accumulated text output from all assistant turns.
+     */
+    run(options: AgentRunOptions): Promise<string>;
+    /**
+     * Streaming text generation — yields tokens as they arrive.
+     * @param messages     Conversation turns (user/assistant).
+     * @param systemPrompt System instructions.
+     * @returns            AsyncIterable of text chunks.
+     */
+    stream(messages: MessageParam[], systemPrompt: SystemContent): AsyncIterable<string>;
+    /**
+     * Parse a JSON block from an LLM response.
+     * The model often wraps JSON in markdown fences — this strips them.
+     */
+    static parseJsonFromReply<T>(reply: string): T;
+}
+//# sourceMappingURL=OctoAgentClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OctoAgentClient.d.ts","sourceRoot":"","sources":["../../../src/workflow-design/OctoAgentClient.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAiD,MAAM,6BAA6B,CAAC;AAC/G,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAuChG,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;gBAElB,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAQ5C;;;;;;;OAOG;IACG,UAAU,CACd,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,aAAa,EACrB,KAAK,CAAC,EAAE,IAAI,EAAE,GACb,OAAO,CAAC,MAAM,CAAC;IA4BlB;;;;;;OAMG;IACG,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAqFpD;;;;;OAKG;IACI,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC;IAgB3F;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC;CAY/C"}