@octo-cyber/ai 0.5.5 → 0.5.7

package/dist/src/skill/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Skill-related type definitions for the SKILL.md generation system.
+ */
+/** Supported AI tool targets for skill installation. */
+export type SkillTarget = 'claude' | 'cursor' | 'codex' | 'gemini';
+/** Information about an AI tool installation target. */
+export interface SkillTargetInfo {
+    id: SkillTarget;
+    name: string;
+    /** Base directory for skills (e.g. ~/.claude/skills/) */
+    skillsDir: string;
+    /** How to detect if the tool is installed */
+    detectDir: string;
+    isInstalled: boolean;
+}
+/** Source type for a skill. */
+export type SkillSourceType = 'module' | 'custom';
+/** Parameters for generating a skill from a module. */
+export interface SkillGenerateParams {
+    /** Module name (e.g. 'auth', 'erp'). */
+    module: string;
+    /** Base URL of the Octo server (e.g. 'http://localhost:9988'). */
+    baseUrl: string;
+    /** API Key to embed in the skill (full key string). */
+    apiKey?: string;
+}
+/** Result of skill generation. */
+export interface SkillGenerateResult {
+    name: string;
+    description: string;
+    content: string;
+    sourceModule: string;
+    version: string;
+}
+/** Endpoint info extracted from RouteRegistry for skill generation. */
+export interface EndpointInfo {
+    method: string;
+    path: string;
+    summary: string;
+    permission?: string;
+    controller: string;
+    controllerName?: string;
+    tags?: string[];
+}
+/** A skill discovered from an external market/GitHub repo. */
+export interface MarketSkillInfo {
+    /** Skill name (directory name) */
+    name: string;
+    /** Skill description from SKILL.md frontmatter */
+    description: string;
+    /** GitHub owner/repo */
+    repo: string;
+    /** Path within repo to SKILL.md */
+    path: string;
+    /** Raw download URL */
+    downloadUrl: string;
+    /** Category/group inferred from path */
+    category?: string;
+    /** Stars of the repo */
+    stars?: number;
+}
+/** Search result from the skill market. */
+export interface MarketSearchResult {
+    skills: MarketSkillInfo[];
+    total: number;
+    source: string;
+}
+/** Known skill repositories that can be browsed. */
+export interface SkillRepo {
+    owner: string;
+    repo: string;
+    description: string;
+    stars: number;
+    skillCount?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/skill/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/skill/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnE,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/src/skill/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Skill-related type definitions for the SKILL.md generation system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/skill/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skill/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

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