@kairos-sdk/core 0.3.0 → 0.3.2

package/dist/index.d.cts

@@ -283,6 +283,17 @@ interface N8nWorkflowResponse {
     shared?: boolean;
     isArchived?: boolean;
 }
+interface N8nNodeTypeInfo {
+    name: string;
+    displayName: string;
+    version: number | number[];
+    description?: string;
+    group?: string[];
+    credentials?: Array<{
+        name: string;
+        required?: boolean;
+    }>;
+}
 
 declare class N8nApiClient {
     private readonly baseUrl;
@@ -304,6 +315,7 @@ declare class N8nApiClient {
     createTag(name: string): Promise<Tag>;
     tagWorkflow(workflowId: string, tagIds: string[]): Promise<void>;
     untagWorkflow(workflowId: string, tagIds: string[]): Promise<void>;
+    getNodeTypes(): Promise<N8nNodeTypeInfo[]>;
     private mapExecution;
 }
 

package/dist/index.d.ts

@@ -283,6 +283,17 @@ interface N8nWorkflowResponse {
     shared?: boolean;
     isArchived?: boolean;
 }
+interface N8nNodeTypeInfo {
+    name: string;
+    displayName: string;
+    version: number | number[];
+    description?: string;
+    group?: string[];
+    credentials?: Array<{
+        name: string;
+        required?: boolean;
+    }>;
+}
 
 declare class N8nApiClient {
     private readonly baseUrl;
@@ -304,6 +315,7 @@ declare class N8nApiClient {
     createTag(name: string): Promise<Tag>;
     tagWorkflow(workflowId: string, tagIds: string[]): Promise<void>;
     untagWorkflow(workflowId: string, tagIds: string[]): Promise<void>;
+    getNodeTypes(): Promise<N8nNodeTypeInfo[]>;
     private mapExecution;
 }
 

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   TelemetryCollector,
   TemplateSyncer,
   ValidationError
-} from "./chunk-Q77XA7UC.js";
+} from "./chunk-KQSNT3HZ.js";
 import {
   ApiError,
   DEFAULT_REGISTRY,
@@ -26,7 +26,7 @@ import {
   nullLogger,
   rerank,
   tokenize
-} from "./chunk-DDV7ZART.js";
+} from "./chunk-RYGYNOR6.js";
 export {
   ApiError,
   DEFAULT_REGISTRY,

package/dist/mcp-server.cjs

@@ -1144,6 +1144,14 @@ var N8nApiClient = class {
     const remaining = (current.tags ?? []).filter((t) => !tagIds.includes(t.id)).map((t) => ({ id: t.id }));
     await this.request("PUT", `/workflows/${workflowId}/tags`, remaining);
   }
+  async getNodeTypes() {
+    try {
+      const response = await this.request("GET", "/node-types");
+      return response.data ?? response;
+    } catch {
+      return [];
+    }
+  }
   mapExecution(e) {
     return {
       id: e.id,
@@ -1363,9 +1371,9 @@ var RULE_REMEDIES = {
   22: "Ensure all required parameters are set for each node type (e.g. webhook needs httpMethod and path)"
 };
 var PromptBuilder = class {
-  build(request, matches, globalFailureRates = []) {
+  build(request, matches, globalFailureRates = [], dynamicCatalog) {
     const mode = this.resolveMode(matches);
-    const system = this.buildSystem(matches, mode, globalFailureRates);
+    const system = this.buildSystem(matches, mode, globalFailureRates, dynamicCatalog);
     const userMessage = this.buildUserMessage(request, matches, mode);
     return { system, userMessage, mode, matches };
   }
@@ -1384,11 +1392,18 @@ Fix ALL of the above issues in your new response. Do not repeat any of these mis
     if (!top) return "scratch";
     return scoreToMode(top.score);
   }
-  buildSystem(matches, mode, globalFailureRates = []) {
+  buildSystem(matches, mode, globalFailureRates = [], dynamicCatalog) {
+    let basePrompt = SYSTEM_PROMPT_V1;
+    if (dynamicCatalog) {
+      basePrompt = basePrompt.replace(
+        /## NODE CATALOG — exact type strings and safe typeVersions[\s\S]*?(?=## PRE-DELIVERY SELF-CHECK)/,
+        dynamicCatalog + "\n\n"
+      );
+    }
     const blocks = [
       {
         type: "text",
-        text: SYSTEM_PROMPT_V1,
+        text: basePrompt,
         cache_control: { type: "ephemeral" }
       }
     ];
@@ -1559,6 +1574,63 @@ var TelemetryReader = class {
   }
 };
 
+// src/validation/node-syncer.ts
+var TRIGGER_PATTERNS = [/trigger/i, /Trigger$/];
+var NodeSyncer = class {
+  baseRegistry;
+  constructor() {
+    this.baseRegistry = new Map(DEFAULT_REGISTRY.map((d) => [d.type, d]));
+  }
+  sync(liveNodes) {
+    const merged = new Map(this.baseRegistry);
+    let newNodes = 0;
+    for (const node of liveNodes) {
+      const versions = Array.isArray(node.version) ? node.version : [node.version];
+      const isTrigger = TRIGGER_PATTERNS.some((p) => p.test(node.name));
+      const credentialType = node.credentials?.[0]?.name;
+      const existing = merged.get(node.name);
+      if (existing) {
+        const allVersions = /* @__PURE__ */ new Set([...existing.safeTypeVersions, ...versions]);
+        merged.set(node.name, {
+          ...existing,
+          safeTypeVersions: [...allVersions].sort((a, b) => a - b)
+        });
+      } else {
+        newNodes++;
+        merged.set(node.name, {
+          type: node.name,
+          safeTypeVersions: versions.sort((a, b) => a - b),
+          requiredParams: [],
+          ...credentialType ? { credentialType } : {},
+          ...isTrigger ? { isTrigger: true } : {}
+        });
+      }
+    }
+    const definitions = [...merged.values()];
+    const registry = new NodeRegistry(definitions);
+    const catalogText = this.buildCatalog(definitions);
+    return { registry, catalogText, nodeCount: definitions.length, newNodes };
+  }
+  buildCatalog(definitions) {
+    const triggers = definitions.filter((d) => d.isTrigger);
+    const regular = definitions.filter((d) => !d.isTrigger);
+    const formatEntry = (d) => {
+      const versions = d.safeTypeVersions.join(", ");
+      const cred = d.credentialType ? ` \u2014 cred: ${d.credentialType}` : "";
+      return `${d.type}  typeVersion: ${versions}${cred}`;
+    };
+    const triggerLines = triggers.map(formatEntry).join("\n");
+    const regularLines = regular.map(formatEntry).join("\n");
+    return `## NODE CATALOG \u2014 synced from your n8n instance (${definitions.length} node types)
+
+### Triggers:
+${triggerLines}
+
+### Regular nodes:
+${regularLines}`;
+  }
+};
+
 // src/utils/logger.ts
 var nullLogger = {
   debug() {
@@ -1580,6 +1652,8 @@ var __dirname = (0, import_node_path3.dirname)((0, import_node_url.fileURLToPath
 var pkg = JSON.parse((0, import_node_fs.readFileSync)((0, import_node_path3.join)(__dirname, "..", "package.json"), "utf-8"));
 var library = new FileLibrary();
 var validator = new N8nValidator();
+var nodeSyncer = new NodeSyncer();
+var lastSync = null;
 var stripper = new N8nFieldStripper();
 var promptBuilder = new PromptBuilder();
 function getTelemetryReader() {
@@ -1601,6 +1675,22 @@ function getApiClient() {
   }
   return new N8nApiClient(baseUrl, apiKey, nullLogger);
 }
+async function autoSync() {
+  if (lastSync) return lastSync;
+  const baseUrl = process.env["N8N_BASE_URL"];
+  const apiKey = process.env["N8N_API_KEY"];
+  if (!baseUrl || !apiKey) return null;
+  try {
+    const client = new N8nApiClient(baseUrl, apiKey, nullLogger);
+    const nodeTypes = await client.getNodeTypes();
+    if (nodeTypes.length === 0) return null;
+    lastSync = nodeSyncer.sync(nodeTypes);
+    validator = new N8nValidator(lastSync.registry);
+    return lastSync;
+  } catch {
+    return null;
+  }
+}
 var server = new import_mcp.McpServer({
   name: "kairos",
   version: pkg.version
@@ -1613,12 +1703,24 @@ server.tool(
     name: import_zod.z.string().optional().describe("Optional workflow name override")
   },
   async ({ description, name }) => {
+    const baseUrl = process.env["N8N_BASE_URL"];
+    const apiKey = process.env["N8N_API_KEY"];
+    if (!baseUrl || !apiKey) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: "N8N_BASE_URL and N8N_API_KEY are required. Kairos needs to sync your n8n instance's node types to generate accurate workflows." })
+        }],
+        isError: true
+      };
+    }
     await library.initialize();
+    const syncResult = await autoSync();
     const matches = await library.search(description);
     const telemetryReader = getTelemetryReader();
     const failureRates = await telemetryReader?.getFailureRates() ?? [];
     const request = { description, ...name ? { name } : {} };
-    const built = promptBuilder.build(request, matches, failureRates);
+    const built = promptBuilder.build(request, matches, failureRates, syncResult?.catalogText);
     const systemText = built.system.map((block) => block.text).join("\n\n---\n\n");
     return {
       content: [{
@@ -1627,6 +1729,9 @@ server.tool(
           mode: built.mode,
           matchCount: matches.length,
           topMatchScore: matches[0]?.score ?? null,
+          nodeCatalog: syncResult ? "synced" : "static",
+          nodeCount: syncResult?.nodeCount ?? null,
+          ...syncResult ? {} : { syncWarning: "Could not sync node types from your n8n instance. Using static fallback catalog \u2014 generated workflows may not match your exact n8n setup." },
           systemPrompt: systemText,
           userMessage: built.userMessage,
           outputFormat: {
@@ -1806,6 +1911,46 @@ server.tool(
     };
   }
 );
+server.tool(
+  "kairos_sync",
+  "Sync the node catalog from your live n8n instance. Fetches all installed node types and versions so Kairos knows exactly what your n8n supports. Automatically called by kairos_prompt when n8n credentials are set, but you can call this manually to force a refresh.",
+  {},
+  async () => {
+    const baseUrl = process.env["N8N_BASE_URL"];
+    const apiKey = process.env["N8N_API_KEY"];
+    if (!baseUrl || !apiKey) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: "N8N_BASE_URL and N8N_API_KEY are required for sync." })
+        }],
+        isError: true
+      };
+    }
+    lastSync = null;
+    const result = await autoSync();
+    if (!result) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: "Failed to fetch node types from n8n. Check your credentials and that your instance is running." })
+        }],
+        isError: true
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          synced: true,
+          nodeCount: result.nodeCount,
+          newNodes: result.newNodes,
+          message: `Synced ${result.nodeCount} node types from your n8n instance (${result.newNodes} not in default catalog).`
+        }, null, 2)
+      }]
+    };
+  }
+);
 server.tool(
   "kairos_list",
   "List all workflows deployed on the connected n8n instance.",