@kairos-sdk/core 0.5.0 → 0.5.1

package/dist/index.d.cts

@@ -4,7 +4,6 @@ export { A as ApiError, d as AttemptMetadata, e as CredentialRequirement, f as D
 declare class Kairos {
     private readonly provider;
     private readonly designer;
-    private readonly validator;
     private readonly library;
     private readonly logger;
     private readonly telemetry;

package/dist/index.d.ts

@@ -4,7 +4,6 @@ export { A as ApiError, d as AttemptMetadata, e as CredentialRequirement, f as D
 declare class Kairos {
     private readonly provider;
     private readonly designer;
-    private readonly validator;
     private readonly library;
     private readonly logger;
     private readonly telemetry;

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   Kairos
-} from "./chunk-HBGZTUUZ.js";
-import "./chunk-EVOAYH2K.js";
+} from "./chunk-GVZKMS53.js";
+import "./chunk-V2IZBZGB.js";
 import "./chunk-6FOFWVMG.js";
 import {
   GenerationError,
@@ -10,7 +10,7 @@ import {
   ResponseParseError,
   TemplateSyncer,
   ValidationError
-} from "./chunk-5GAY7CSJ.js";
+} from "./chunk-MYAGTDQ2.js";
 import {
   ApiError,
   DEFAULT_REGISTRY,
@@ -30,7 +30,7 @@ import {
   nullLogger,
   rerank,
   tokenize
-} from "./chunk-KIFT5LA7.js";
+} from "./chunk-VPPWTMRJ.js";
 export {
   ApiError,
   DEFAULT_REGISTRY,

package/dist/mcp-server.cjs

@@ -4,6 +4,8 @@
 // src/mcp-server.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+var import_streamableHttp = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+var import_node_http = require("http");
 var import_zod = require("zod");
 
 // src/library/file-library.ts
@@ -2594,7 +2596,7 @@ var PatternAnalyzer = class _PatternAnalyzer {
     this._cachedEvents = events;
     const starts = events.filter((e) => e.eventType === "build_start");
     const attempts = events.filter((e) => e.eventType === "generation_attempt");
-    const passed = attempts.filter(
+    const _passed = attempts.filter(
       (a) => a.data.validationPassed === true
     );
     const failed = attempts.filter(
@@ -3177,12 +3179,37 @@ function inferWorkflowType(description) {
 
 // src/mcp-server.ts
 var import_node_fs3 = require("fs");
-var import_node_path7 = require("path");
+var import_node_path8 = require("path");
 var import_node_os6 = require("os");
 var import_node_url = require("url");
+
+// src/utils/node-catalog-cache.ts
+var import_promises5 = require("fs/promises");
+var import_node_path7 = require("path");
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+async function readCatalogCache(cachePath) {
+  try {
+    const raw = await (0, import_promises5.readFile)(cachePath, "utf-8");
+    const cached = JSON.parse(raw);
+    if (Date.now() - cached.cachedAt > CACHE_TTL_MS) return null;
+    return cached.syncResult;
+  } catch {
+    return null;
+  }
+}
+async function writeCatalogCache(cachePath, syncResult) {
+  try {
+    await (0, import_promises5.mkdir)((0, import_node_path7.dirname)(cachePath), { recursive: true });
+    const payload = { cachedAt: Date.now(), syncResult };
+    await (0, import_promises5.writeFile)(cachePath, JSON.stringify(payload), "utf-8");
+  } catch {
+  }
+}
+
+// src/mcp-server.ts
 var import_meta = {};
-var __dirname = (0, import_node_path7.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
-var pkg = JSON.parse((0, import_node_fs3.readFileSync)((0, import_node_path7.join)(__dirname, "..", "package.json"), "utf-8"));
+var __dirname = (0, import_node_path8.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
+var pkg = JSON.parse((0, import_node_fs3.readFileSync)((0, import_node_path8.join)(__dirname, "..", "package.json"), "utf-8"));
 var library = new FileLibrary();
 var _validator = new N8nValidator();
 function getValidator() {
@@ -3201,9 +3228,9 @@ function getMcpTelemetry() {
 function getMcpPatternsPath() {
   const val = process.env["KAIROS_TELEMETRY"];
   if (val && val !== "false" && val !== "true") {
-    return (0, import_node_path7.join)(val, "..", "patterns.json");
+    return (0, import_node_path8.join)(val, "..", "patterns.json");
   }
-  return (0, import_node_path7.join)((0, import_node_os6.homedir)(), ".kairos", "patterns.json");
+  return (0, import_node_path8.join)((0, import_node_os6.homedir)(), ".kairos", "patterns.json");
 }
 var mcpTelemetry = getMcpTelemetry();
 var mcpSessions = /* @__PURE__ */ new Map();
@@ -3221,7 +3248,14 @@ function getTelemetryReader() {
     return null;
   }
 }
+function getMcpMode() {
+  const mode = process.env["KAIROS_MCP_MODE"]?.toLowerCase();
+  if (mode === "readonly" || mode === "validate") return mode;
+  return "deploy";
+}
 function isAllowed(action) {
+  const mode = getMcpMode();
+  if (mode === "readonly" || mode === "validate") return false;
   const key = `KAIROS_MCP_ALLOW_${action.toUpperCase()}`;
   return process.env[key] === "true";
 }
@@ -3245,8 +3279,20 @@ function getApiClient() {
   }
   return new N8nApiClient(baseUrl, apiKey, nullLogger);
 }
+function getCatalogCachePath() {
+  const telemetry = process.env["KAIROS_TELEMETRY"];
+  const base = telemetry ? (0, import_node_path8.join)(telemetry, "..") : (0, import_node_path8.join)((0, import_node_os6.homedir)(), ".kairos");
+  return (0, import_node_path8.join)(base, "node-catalog-cache.json");
+}
 async function autoSync() {
   if (lastSync) return lastSync;
+  const cachePath = getCatalogCachePath();
+  const cached = await readCatalogCache(cachePath);
+  if (cached) {
+    lastSync = cached;
+    _validator = new N8nValidator(lastSync.registry);
+    return lastSync;
+  }
   const baseUrl = process.env["N8N_BASE_URL"];
   const apiKey = process.env["N8N_API_KEY"];
   if (!baseUrl || !apiKey) return null;
@@ -3256,6 +3302,8 @@ async function autoSync() {
     if (nodeTypes.length === 0) return null;
     lastSync = nodeSyncer.sync(nodeTypes);
     _validator = new N8nValidator(lastSync.registry);
+    writeCatalogCache(cachePath, lastSync).catch(() => {
+    });
     return lastSync;
   } catch {
     return null;
@@ -3274,13 +3322,9 @@ server.tool(
   },
   async ({ description, name }) => {
     evictStaleSessions();
-    const baseUrl = process.env["N8N_BASE_URL"];
-    const apiKey = process.env["N8N_API_KEY"];
-    if (!baseUrl || !apiKey) {
-      return mcpError(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." }));
-    }
     const runId = generateUUID();
     const workflowType = inferWorkflowType(description);
+    const hasN8nCreds = !!(process.env["N8N_BASE_URL"] && process.env["N8N_API_KEY"]);
     const syncPromise = autoSync();
     const syncTimeout = new Promise((resolve) => setTimeout(() => resolve(null), AUTO_SYNC_TIMEOUT_MS));
     await library.initialize();
@@ -3300,7 +3344,8 @@ server.tool(
         startTime: Date.now(),
         validateAttempts: 0,
         warnedRules: promptBuilder.getWarnedRules(),
-        workflowType
+        workflowType,
+        matchCount: matches.length
       });
       await mcpTelemetry.emit("build_start", { description, model: "mcp-decomposed", dryRun: false }, runId);
     }
@@ -3312,7 +3357,9 @@ server.tool(
       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." },
+      ...syncResult ? {} : {
+        syncWarning: hasN8nCreds ? "Could not sync node types from your n8n instance. Using static fallback catalog \u2014 generated workflows may not match your exact n8n setup." : "N8N_BASE_URL and N8N_API_KEY are not set. Using static fallback catalog \u2014 node types may not match your n8n instance. Set these env vars to enable accurate generation and deployment."
+      },
       systemPrompt: systemText,
       userMessage: built.userMessage,
       outputFormat: {
@@ -3385,10 +3432,11 @@ server.tool(
   {
     workflow: import_zod.z.string().describe("The validated workflow JSON string to deploy"),
     activate: import_zod.z.boolean().default(false).describe("Activate the workflow immediately after deployment"),
+    description: import_zod.z.string().optional().describe("The original user intent / description for this workflow \u2014 used to improve library search quality over time"),
     kairos_run_id: import_zod.z.string().optional().describe("Run ID from kairos_prompt \u2014 enables telemetry correlation"),
     kairos_secret: import_zod.z.string().optional().describe("Required when KAIROS_MCP_SECRET env var is set")
   },
-  async ({ workflow: workflowStr, activate, kairos_run_id, kairos_secret }) => {
+  async ({ workflow: workflowStr, activate, description: userDescription, kairos_run_id, kairos_secret }) => {
     const authError = checkMcpAuth(kairos_secret);
     if (authError) return authError;
     if (!isAllowed("deploy")) {
@@ -3429,8 +3477,8 @@ server.tool(
 Note: kairos_run_id "${kairos_run_id}" was provided but no active session was found. This usually means kairos_deploy was called without a prior kairos_prompt call, or the session expired. Telemetry and pattern learning for this build were skipped.` : "";
     await library.initialize();
     await library.save(parsed, {
-      description: session?.description ?? parsed.name,
-      generationMode: "scratch",
+      description: session?.description ?? userDescription ?? parsed.name,
+      generationMode: session && session.matchCount > 0 ? "reference" : "scratch",
       generationAttempts: session?.validateAttempts ?? 1,
       n8nWorkflowId: response.id
     });
@@ -3467,12 +3515,16 @@ server.tool(
   {
     workflow_id: import_zod.z.string().describe("The n8n workflow ID to replace"),
     workflow: import_zod.z.string().describe("The validated workflow JSON string"),
+    description: import_zod.z.string().optional().describe("The original user intent / description for this workflow \u2014 used to improve library search quality over time"),
     kairos_run_id: import_zod.z.string().optional().describe("Run ID from kairos_prompt \u2014 enables telemetry correlation"),
     kairos_secret: import_zod.z.string().optional().describe("Required when KAIROS_MCP_SECRET env var is set")
   },
-  async ({ workflow_id, workflow: workflowStr, kairos_run_id, kairos_secret }) => {
+  async ({ workflow_id, workflow: workflowStr, description: userDescription, kairos_run_id, kairos_secret }) => {
     const authError = checkMcpAuth(kairos_secret);
     if (authError) return authError;
+    if (!isAllowed("deploy")) {
+      return mcpError(JSON.stringify({ error: "Replace is disabled. Set KAIROS_MCP_ALLOW_DEPLOY=true or KAIROS_MCP_MODE=deploy to enable." }));
+    }
     let parsed;
     try {
       parsed = JSON.parse(workflowStr);
@@ -3496,8 +3548,8 @@ server.tool(
 Note: kairos_run_id "${kairos_run_id}" was provided but no active session was found.` : "";
     await library.initialize();
     await library.save(parsed, {
-      description: session?.description ?? parsed.name,
-      generationMode: "scratch",
+      description: session?.description ?? userDescription ?? parsed.name,
+      generationMode: session && session.matchCount > 0 ? "reference" : "scratch",
       generationAttempts: session?.validateAttempts ?? 1,
       n8nWorkflowId: workflow_id
     });
@@ -3743,8 +3795,27 @@ async function main() {
       "[kairos-mcp] WARNING: ANTHROPIC_API_KEY is not set \u2014 kairos_prompt will fail. Set it before using workflow generation tools.\n"
     );
   }
-  const transport = new import_stdio.StdioServerTransport();
-  await server.connect(transport);
+  const useHttp = process.argv.includes("--http");
+  if (useHttp) {
+    const port = parseInt(process.env["KAIROS_MCP_PORT"] ?? "3000", 10);
+    const transport = new import_streamableHttp.StreamableHTTPServerTransport();
+    await server.connect(transport);
+    const httpServer = (0, import_node_http.createServer)(async (req, res) => {
+      if (req.method === "GET" || req.method === "POST" || req.method === "DELETE") {
+        await transport.handleRequest(req, res);
+      } else {
+        res.writeHead(405, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Method not allowed" }));
+      }
+    });
+    httpServer.listen(port, () => {
+      process.stderr.write(`[kairos-mcp] HTTP transport listening on port ${port}
+`);
+    });
+  } else {
+    const transport = new import_stdio.StdioServerTransport();
+    await server.connect(transport);
+  }
 }
 main().catch((err) => {
   console.error("Kairos MCP server failed to start:", err);