@kairos-sdk/core 0.4.0 → 0.4.5

package/README.md

@@ -8,7 +8,7 @@
 
 ![Kairos SDK Demo](demo.gif)
 
-Kairos turns plain-English workflow descriptions into validated, deployable n8n workflow JSON. Use it as an **MCP server** (connect to Claude Code, Claude Desktop, or any MCP host — your LLM generates, Kairos validates and deploys, no Anthropic API key needed) or as a **TypeScript SDK** for programmatic control (calls Claude internally with a specialized prompt). Either way, workflows pass through a **23-rule structural validator** with automatic correction, and a local workflow library with **hybrid retrieval** (TF-IDF + node fingerprinting + outcome history + cluster reranking) injects past failure patterns into future generations. With a seeded template library, Kairos achieves **100% first-try structural validation pass rate** across 20 benchmark prompts (meaning the generated JSON is structurally valid on the first attempt — runtime behavior depends on your credentials and node configuration).
+Kairos turns plain-English workflow descriptions into validated, deployable n8n workflow JSON. Use it as an **MCP server** (connect to Claude Code, Claude Desktop, or any MCP host — your LLM generates, Kairos validates and deploys, no Anthropic API key needed) or as a **TypeScript SDK** for programmatic control (calls Claude internally with a specialized prompt). Either way, workflows pass through a **26-rule structural validator** with automatic correction, and a local workflow library with **hybrid retrieval** (TF-IDF + node fingerprinting + outcome history + cluster reranking) injects past failure patterns into future generations. With a seeded template library, Kairos achieves **100% first-try structural validation pass rate** across 20 benchmark prompts (meaning the generated JSON is structurally valid on the first attempt — runtime behavior depends on your credentials and node configuration).
 
 ```ts
 import { Kairos } from '@kairos-sdk/core'
@@ -95,7 +95,7 @@ The MCP server does **not** call an LLM internally. Instead, it gives your host
 
 1. **Host LLM calls `kairos_prompt`** — gets the n8n system prompt, node catalog, library matches, and failure patterns
 2. **Host LLM generates the workflow JSON** using that context (no separate API call)
-3. **Host LLM calls `kairos_validate`** — checks the JSON against 23 structural rules
+3. **Host LLM calls `kairos_validate`** — checks the JSON against 26 structural rules
 4. If invalid, the host LLM fixes the issues and validates again
 5. **Host LLM calls `kairos_deploy`** — sends the validated workflow to n8n
 
@@ -108,7 +108,7 @@ This means Kairos works with **any LLM** — Claude, GPT, Gemini, Llama, or anyt
 | Tool | Description |
 |------|-------------|
 | `kairos_prompt` | Returns the specialized system prompt, node catalog, library matches, and failure patterns for a given description |
-| `kairos_validate` | Validates workflow JSON against 23 structural rules — returns errors and warnings |
+| `kairos_validate` | Validates workflow JSON against 26 structural rules — returns errors and warnings |
 | `kairos_search` | Searches the local workflow library for similar past builds |
 | `kairos_sync` | Manually refresh the node catalog from your n8n instance (auto-runs on first `kairos_prompt` call) |
 
@@ -180,7 +180,7 @@ console.log(deployed.workflowId) // now live in n8n
 
 ## Benchmark Results
 
-Tested against 20 workflow prompts of varying complexity (simple triggers, multi-step conditional logic, AI agents with memory). Results measure **structural validation pass rate** — whether the generated workflow passes all 23 validator rules, not end-to-end execution correctness.
+Tested against 20 workflow prompts of varying complexity (simple triggers, multi-step conditional logic, AI agents with memory). Results measure **structural validation pass rate** — whether the generated workflow passes all 26 validator rules, not end-to-end execution correctness.
 
 ### Before vs After: Template-Seeded Library
 
@@ -192,7 +192,7 @@ Tested against 20 workflow prompts of varying complexity (simple triggers, multi
 | Avg generation time | 30.6s | **20.7s** | -32% |
 | Failures | 0 | 0 | — |
 
-The baseline run used Claude with the 23-rule validator and correction loop but no library. The seeded run used the same validator plus a library of 105 workflows (16 organic + 89 ingested from the n8n community). The broader local development library now contains 286+ generated/ingested workflows. Template seeding eliminated the correction loop entirely and cut generation time by a third.
+The baseline run used Claude with the 26-rule validator and correction loop but no library. The seeded run used the same validator plus a library of 105 workflows (16 organic + 89 ingested from the n8n community). The broader local development library now contains 286+ generated/ingested workflows. Template seeding eliminated the correction loop entirely and cut generation time by a third.
 
 > **Note:** These results confirm that generated workflows are structurally valid and deployable to n8n. They do not verify runtime execution correctness, credential configuration, or whether the workflow output matches user intent.
 
@@ -205,7 +205,7 @@ The baseline run used Claude with the 23-rule validator and correction loop but
 1. **Search** — Kairos searches its local workflow library for similar past builds. Matching workflows and their failure patterns are pulled into context.
 2. **Warn** — Known failure patterns (from library matches and global telemetry rates) are injected into the system prompt so Claude avoids repeating known mistakes.
 3. **Generate** — Your description is sent to Claude with a detailed system prompt, forcing a `generate_workflow` tool call that produces structured n8n workflow JSON.
-4. **Validate** — The workflow is checked against **23 structural rules** covering node IDs, types, versions, names, positions, connections, forbidden fields, trigger presence, AI connection direction, cycle detection, webhook pairing, and required parameters.
+4. **Validate** — The workflow is checked against **26 structural rules** covering node IDs, types, versions, names, positions, connections, forbidden fields, trigger presence, AI connection direction, cycle detection, webhook pairing, and required parameters.
 5. **Correct** — If validation fails, the specific rule violations are sent back to Claude for correction (up to 3 attempts, with tighter temperature on the final try).
 6. **Strip** — Forbidden server-assigned fields (`id`, `createdAt`, `updatedAt`, etc.) are stripped before deployment.
 7. **Deploy** — The validated workflow is posted to your n8n instance via REST API.
@@ -215,7 +215,7 @@ The baseline run used Claude with the 23-rule validator and correction loop but
 
 1. **Prompt** — Your LLM calls `kairos_prompt`, which searches the library and returns the specialized system prompt, node catalog, library matches, and failure patterns.
 2. **Generate** — Your LLM generates the workflow JSON itself using that context. No separate API call.
-3. **Validate** — Your LLM calls `kairos_validate`, which checks the JSON against the same 23 structural rules.
+3. **Validate** — Your LLM calls `kairos_validate`, which checks the JSON against the same 26 structural rules.
 4. **Correct** — If validation fails, your LLM fixes the issues and calls `kairos_validate` again.
 5. **Deploy** — Your LLM calls `kairos_deploy`, which strips forbidden fields and posts the workflow to n8n.
 6. **Record** — The deployed workflow is saved to the local library for future retrieval.
@@ -224,7 +224,7 @@ The baseline run used Claude with the 23-rule validator and correction loop but
 
 ## Validator Rules
 
-The 23-rule validator is the core of what makes Kairos reliable. In baseline testing (no library), Claude needed the correction loop 45% of the time. Each rule targets a specific class of error:
+The 26-rule validator is the core of what makes Kairos reliable. In baseline testing (no library), Claude needed the correction loop 45% of the time. Each rule targets a specific class of error:
 
 | Rule | Severity | What it checks |
 |------|----------|----------------|
@@ -251,6 +251,9 @@ The 23-rule validator is the core of what makes Kairos reliable. In baseline tes
 | 21 | warn | Webhook with responseMode="responseNode" has respondToWebhook |
 | 22 | warn | Required parameters present for known node types |
 | 23 | warn | Node type is recognized in the registry (unknown types may not exist in n8n) |
+| 24 | warn | No deprecated `$node["..."]` accessor syntax in expressions |
+| 25 | warn | No `$json.items[n]` array access (n8n flattens items automatically) |
+| 26 | warn | Node references use `.first()` or `.all()` (bare `$('Node').json` throws at runtime) |
 
 Errors block deployment. Warnings are recorded and fed back into the prompt for future builds.
 
@@ -389,7 +392,7 @@ try {
 |---|---|
 | `GenerationError` | Anthropic API call failed |
 | `ResponseParseError` | Claude responded but produced no usable tool call |
-| `ValidationError` | Workflow failed 23-rule validation after max retries (carries `.attemptMetadata` and `.warnedRules`) |
+| `ValidationError` | Workflow failed 26-rule validation after max retries (carries `.attemptMetadata` and `.warnedRules`) |
 | `ProviderError` | Network/auth failure talking to n8n |
 | `ApiError` | n8n returned a 4xx or 5xx (carries `.statusCode`) |
 | `GuardError` | Input validation failed (empty description) or `delete()` called without `{ confirm: true }` |

package/dist/{chunk-N6LRD2FN.js → chunk-4TS6GW6O.js}

@@ -1,175 +1,26 @@
 import {
-  KairosError,
+  PromptBuilder,
+  inferWorkflowType
+} from "./chunk-CR2NHLOH.js";
+import {
+  GenerationError,
+  GuardError,
+  N8nProvider,
+  NullLibrary,
+  ResponseParseError,
+  ValidationError
+} from "./chunk-6CLI43FI.js";
+import {
   N8nApiClient,
   N8nFieldStripper,
   N8nValidator,
   PatternAnalyzer,
-  PromptBuilder,
+  TelemetryCollector,
   TelemetryReader,
   generateUUID,
   nullLogger,
   scoreToMode
-} from "./chunk-NJ6QZBIC.js";
-
-// src/library/null-library.ts
-var NullLibrary = class {
-  async initialize() {
-  }
-  async search(_description, _options) {
-    return [];
-  }
-  async save(_workflow, _metadata) {
-    return generateUUID();
-  }
-  async recordDeployment(_id) {
-  }
-  async recordOutcome(_id, _outcome) {
-  }
-  async get(_id) {
-    return null;
-  }
-  async list(_filters) {
-    return [];
-  }
-};
-
-// src/errors/guard-error.ts
-var GuardError = class extends KairosError {
-  constructor(message) {
-    super(message);
-    this.name = "GuardError";
-  }
-};
-
-// src/providers/n8n/provider.ts
-var N8nProvider = class {
-  constructor(client, stripper) {
-    this.client = client;
-    this.stripper = stripper;
-  }
-  client;
-  stripper;
-  platform = "n8n";
-  async deploy(workflow) {
-    const stripped = this.stripper.stripForCreate(workflow);
-    const response = await this.client.createWorkflow(stripped);
-    return { workflowId: response.id, name: response.name };
-  }
-  async update(id, workflow) {
-    const stripped = this.stripper.stripForUpdate(workflow);
-    const response = await this.client.updateWorkflow(id, stripped);
-    return { workflowId: response.id, name: response.name };
-  }
-  async get(id) {
-    const response = await this.client.getWorkflow(id);
-    return {
-      name: response.name,
-      nodes: response.nodes,
-      connections: response.connections,
-      ...response.settings !== void 0 ? { settings: response.settings } : {},
-      ...response.tags !== void 0 ? { tags: response.tags } : {}
-    };
-  }
-  async list() {
-    return this.client.listWorkflows();
-  }
-  async activate(id) {
-    await this.client.activateWorkflow(id);
-  }
-  async deactivate(id) {
-    await this.client.deactivateWorkflow(id);
-  }
-  async delete(id, options) {
-    if (options.confirm !== true) {
-      throw new GuardError("delete() requires { confirm: true } to prevent accidental deletion");
-    }
-    await this.client.deleteWorkflow(id);
-  }
-  async executions(workflowId, filter) {
-    return this.client.getExecutions(workflowId, filter);
-  }
-  async execution(id) {
-    return this.client.getExecution(id);
-  }
-  async listTags() {
-    return this.client.listTags();
-  }
-  async createTag(name) {
-    return this.client.createTag(name);
-  }
-  async tag(workflowId, tagIds) {
-    await this.client.tagWorkflow(workflowId, tagIds);
-  }
-  async untag(workflowId, tagIds) {
-    await this.client.untagWorkflow(workflowId, tagIds);
-  }
-};
-
-// src/errors/generation-error.ts
-var GenerationError = class extends KairosError {
-  constructor(message, cause) {
-    super(message, cause);
-    this.name = "GenerationError";
-  }
-};
-
-// src/errors/response-parse-error.ts
-var ResponseParseError = class extends KairosError {
-  constructor(message, cause) {
-    super(message, cause);
-    this.name = "ResponseParseError";
-  }
-};
-
-// src/errors/validation-error.ts
-var ValidationError = class extends KairosError {
-  constructor(message, issues, attemptMetadata, warnedRules) {
-    super(message);
-    this.issues = issues;
-    this.attemptMetadata = attemptMetadata;
-    this.warnedRules = warnedRules;
-    this.name = "ValidationError";
-  }
-  issues;
-  attemptMetadata;
-  warnedRules;
-};
-
-// src/telemetry/collector.ts
-import { appendFile, mkdir } from "fs/promises";
-import { join } from "path";
-import { homedir } from "os";
-
-// src/telemetry/types.ts
-var TELEMETRY_SCHEMA_VERSION = 2;
-
-// src/telemetry/collector.ts
-var TelemetryCollector = class {
-  dir;
-  sessionId;
-  dirReady = null;
-  constructor(dir) {
-    this.dir = dir ?? join(homedir(), ".kairos", "telemetry");
-    this.sessionId = generateUUID();
-  }
-  async emit(eventType, data) {
-    const event = {
-      schemaVersion: TELEMETRY_SCHEMA_VERSION,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      sessionId: this.sessionId,
-      eventType,
-      data
-    };
-    if (!this.dirReady) {
-      this.dirReady = mkdir(this.dir, { recursive: true }).then(() => {
-      });
-    }
-    await this.dirReady;
-    const filename = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10) + ".jsonl";
-    const filepath = join(this.dir, filename);
-    await appendFile(filepath, JSON.stringify(event) + "\n", "utf-8");
-  }
-};
+} from "./chunk-6IXW3WCC.js";
 
 // src/client.ts
 import Anthropic from "@anthropic-ai/sdk";
@@ -217,12 +68,12 @@ var GENERATE_WORKFLOW_TOOL = {
   }
 };
 var WorkflowDesigner = class {
-  constructor(anthropic, model, logger) {
+  constructor(anthropic, model, logger, patternsPath) {
     this.anthropic = anthropic;
     this.model = model;
     this.logger = logger;
     this.validator = new N8nValidator();
-    this.promptBuilder = new PromptBuilder();
+    this.promptBuilder = new PromptBuilder(patternsPath);
   }
   anthropic;
   model;
@@ -306,6 +157,11 @@ var WorkflowDesigner = class {
     }
   }
   extractToolUse(message) {
+    if (message.stop_reason === "max_tokens") {
+      throw new GenerationError(
+        "Claude response was truncated (max_tokens reached) \u2014 the workflow may be too large. Try a simpler description or break it into smaller workflows."
+      );
+    }
     const toolUseBlock = message.content.find(
       (block) => block.type === "tool_use"
     );
@@ -332,6 +188,8 @@ var WorkflowDesigner = class {
 };
 
 // src/client.ts
+import { homedir } from "os";
+import { join } from "path";
 var DEFAULT_MODEL = "claude-sonnet-4-6";
 var Kairos = class {
   provider;
@@ -360,7 +218,8 @@ var Kairos = class {
       this.provider = null;
     }
     const anthropic = new Anthropic({ apiKey: options.anthropicApiKey });
-    this.designer = new WorkflowDesigner(anthropic, this.model, logger);
+    const patternsPath = typeof options.telemetry === "string" ? join(options.telemetry, "..", "patterns.json") : join(homedir(), ".kairos", "patterns.json");
+    this.designer = new WorkflowDesigner(anthropic, this.model, logger, patternsPath);
     this.validator = new N8nValidator();
     this.library = options.library ?? new NullLibrary();
     this.logger = logger;
@@ -393,11 +252,13 @@ var Kairos = class {
     this.validateDescription(description);
     this.logger.info("Kairos.build", { description, dryRun: options?.dryRun });
     const buildStart = Date.now();
+    const runId = generateUUID();
+    const workflowType = inferWorkflowType(description);
     await this.telemetry?.emit("build_start", {
       description,
       model: this.model,
       dryRun: options?.dryRun ?? false
-    });
+    }, runId);
     await this.library.initialize();
     const matches = await this.library.search(description);
     if (matches.length > 0) {
@@ -432,8 +293,9 @@ var Kairos = class {
             tokensOutput: meta.tokensOutput,
             validationPassed: meta.validationPassed,
             issueCount: meta.issues.length,
-            issues: meta.issues.map((i) => ({ rule: i.rule, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null }))
-          });
+            issues: meta.issues.map((i) => ({ rule: i.rule, severity: i.severity, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null })),
+            workflowType
+          }, runId);
         }
         await this.telemetry?.emit("build_complete", {
           description,
@@ -446,13 +308,14 @@ var Kairos = class {
           workflowId: null,
           dryRun: options?.dryRun ?? false,
           credentialsNeeded: 0,
-          warnedRules: err.warnedRules ?? []
-        });
+          warnedRules: err.warnedRules ?? [],
+          workflowType
+        }, runId);
         this.updatePatterns();
       }
       throw err;
     }
-    await this.emitAttemptTelemetry(description, designResult);
+    await this.emitAttemptTelemetry(description, designResult, workflowType, runId);
     const workflow = options?.name ? { ...designResult.workflow, name: options.name } : designResult.workflow;
     this.saveToLibrary(workflow, description, designResult, matches);
     if (options?.dryRun) {
@@ -469,8 +332,9 @@ var Kairos = class {
         workflowId: null,
         dryRun: true,
         credentialsNeeded: designResult.credentialsNeeded.length,
-        warnedRules: designResult.warnedRules
-      });
+        warnedRules: designResult.warnedRules,
+        workflowType
+      }, runId);
       this.updatePatterns();
       return {
         workflowId: null,
@@ -501,8 +365,9 @@ var Kairos = class {
       workflowId: deployed.workflowId,
       dryRun: false,
       credentialsNeeded: designResult.credentialsNeeded.length,
-      warnedRules: designResult.warnedRules
-    });
+      warnedRules: designResult.warnedRules,
+      workflowType
+    }, runId);
     this.updatePatterns();
     return {
       workflowId: deployed.workflowId,
@@ -518,11 +383,13 @@ var Kairos = class {
     this.validateDescription(description);
     this.logger.info("Kairos.update", { id, description });
     const buildStart = Date.now();
+    const runId = generateUUID();
+    const workflowType = inferWorkflowType(description);
     await this.telemetry?.emit("build_start", {
       description,
       model: this.model,
       dryRun: false
-    });
+    }, runId);
     await this.library.initialize();
     const matches = await this.library.search(description);
     const globalFailureRates = await this.telemetryReader?.getFailureRates() ?? [];
@@ -541,8 +408,9 @@ var Kairos = class {
             tokensOutput: meta.tokensOutput,
             validationPassed: meta.validationPassed,
             issueCount: meta.issues.length,
-            issues: meta.issues.map((i) => ({ rule: i.rule, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null }))
-          });
+            issues: meta.issues.map((i) => ({ rule: i.rule, severity: i.severity, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null })),
+            workflowType
+          }, runId);
         }
         await this.telemetry?.emit("build_complete", {
           description,
@@ -555,13 +423,14 @@ var Kairos = class {
           workflowId: null,
           dryRun: false,
           credentialsNeeded: 0,
-          warnedRules: err.warnedRules ?? []
-        });
+          warnedRules: err.warnedRules ?? [],
+          workflowType
+        }, runId);
         this.updatePatterns();
       }
       throw err;
     }
-    await this.emitAttemptTelemetry(description, designResult);
+    await this.emitAttemptTelemetry(description, designResult, workflowType, runId);
     const provider = this.requireProvider();
     const deployed = await provider.update(id, designResult.workflow);
     this.saveToLibrary(designResult.workflow, description, designResult, matches);
@@ -579,8 +448,9 @@ var Kairos = class {
       workflowId: deployed.workflowId,
       dryRun: false,
       credentialsNeeded: designResult.credentialsNeeded.length,
-      warnedRules: designResult.warnedRules
-    });
+      warnedRules: designResult.warnedRules,
+      workflowType
+    }, runId);
     this.updatePatterns();
     return {
       workflowId: deployed.workflowId,
@@ -603,7 +473,7 @@ var Kairos = class {
       return null;
     });
   }
-  async emitAttemptTelemetry(description, designResult) {
+  async emitAttemptTelemetry(description, designResult, workflowType, runId) {
     for (const meta of designResult.attemptMetadata) {
       await this.telemetry?.emit("generation_attempt", {
         description,
@@ -614,8 +484,9 @@ var Kairos = class {
         tokensOutput: meta.tokensOutput,
         validationPassed: meta.validationPassed,
         issueCount: meta.issues.length,
-        issues: meta.issues.map((i) => ({ rule: i.rule, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null }))
-      });
+        issues: meta.issues.map((i) => ({ rule: i.rule, severity: i.severity, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null })),
+        workflowType
+      }, runId);
     }
   }
   recordDeploy() {
@@ -712,190 +583,7 @@ var Kairos = class {
   }
 };
 
-// src/templates/safety.ts
-var BLOCKED_NODE_TYPES = /* @__PURE__ */ new Set([
-  "n8n-nodes-base.code",
-  "n8n-nodes-base.executeCommand",
-  "n8n-nodes-base.ssh"
-]);
-var REVIEW_NODE_TYPES = /* @__PURE__ */ new Set([
-  "n8n-nodes-base.httpRequest"
-]);
-var SECRET_PATTERNS = [
-  /sk-[a-zA-Z0-9]{20,}/,
-  /ghp_[a-zA-Z0-9]{36}/,
-  /xoxb-[0-9]+-[0-9]+-[a-zA-Z0-9]+/,
-  /AIza[a-zA-Z0-9_-]{35}/,
-  /AKIA[A-Z0-9]{16}/
-];
-function assessTemplateSafety(workflow) {
-  const reasons = [];
-  let worst = "safe";
-  const escalate = (level, reason) => {
-    reasons.push(reason);
-    if (level === "blocked") worst = "blocked";
-    else if (level === "review" && worst === "safe") worst = "review";
-  };
-  for (const node of workflow.nodes) {
-    if (BLOCKED_NODE_TYPES.has(node.type)) {
-      escalate("blocked", `Contains ${node.type} node "${node.name}"`);
-    }
-    if (REVIEW_NODE_TYPES.has(node.type)) {
-      escalate("review", `Contains ${node.type} node "${node.name}"`);
-    }
-    const paramStr = JSON.stringify(node.parameters);
-    for (const pattern of SECRET_PATTERNS) {
-      if (pattern.test(paramStr)) {
-        escalate("blocked", `Node "${node.name}" parameters contain a hardcoded secret`);
-        break;
-      }
-    }
-  }
-  return { trustLevel: worst, reasons };
-}
-
-// src/templates/syncer.ts
-var N8N_TEMPLATE_API = "https://api.n8n.io/api/templates";
-var PAGE_SIZE = 50;
-var DELAY_BETWEEN_FETCHES_MS = 200;
-var DEFAULT_SETTINGS = {
-  executionOrder: "v1",
-  saveManualExecutions: true,
-  timezone: "UTC"
-};
-var TemplateSyncer = class {
-  constructor(library, logger) {
-    this.library = library;
-    this.validator = new N8nValidator();
-    this.logger = logger;
-  }
-  library;
-  validator;
-  logger;
-  async sync(options) {
-    const maxTemplates = options?.maxTemplates ?? 500;
-    await this.library.initialize();
-    const existing = await this.library.list();
-    const existingSourceIds = new Set(
-      existing.filter((w) => w.sourceKind === "n8n-template" && w.sourceId).map((w) => w.sourceId)
-    );
-    const progress = {
-      total: 0,
-      processed: 0,
-      saved: 0,
-      skippedPaid: 0,
-      skippedDuplicate: 0,
-      blocked: 0,
-      reviewed: 0
-    };
-    const templateIds = await this.fetchTemplateIds(maxTemplates, progress);
-    for (const id of templateIds) {
-      if (existingSourceIds.has(String(id))) {
-        progress.skippedDuplicate++;
-        progress.processed++;
-        options?.onProgress?.(progress);
-        continue;
-      }
-      try {
-        await this.processTemplate(id, progress);
-      } catch (err) {
-        this.logger.warn(`Failed to process template ${id}`, { err: String(err) });
-      }
-      progress.processed++;
-      options?.onProgress?.(progress);
-      await new Promise((resolve) => setTimeout(resolve, DELAY_BETWEEN_FETCHES_MS));
-    }
-    return progress;
-  }
-  async fetchTemplateIds(max, progress) {
-    const ids = [];
-    let page = 1;
-    while (ids.length < max) {
-      const url = `${N8N_TEMPLATE_API}/search?page=${page}&rows=${PAGE_SIZE}`;
-      const response = await fetch(url);
-      if (!response.ok) break;
-      const data = await response.json();
-      progress.total = Math.min(data.totalWorkflows, max);
-      for (const template of data.workflows) {
-        if (ids.length >= max) break;
-        if (template.price && template.price > 0) {
-          progress.skippedPaid++;
-          continue;
-        }
-        ids.push(template.id);
-      }
-      if (data.workflows.length < PAGE_SIZE) break;
-      page++;
-      await new Promise((resolve) => setTimeout(resolve, DELAY_BETWEEN_FETCHES_MS));
-    }
-    return ids;
-  }
-  async processTemplate(id, progress) {
-    const url = `${N8N_TEMPLATE_API}/workflows/${id}`;
-    const response = await fetch(url);
-    if (!response.ok) return;
-    const data = await response.json();
-    const templateMeta = data.workflow;
-    const rawWorkflow = templateMeta.workflow;
-    if (!rawWorkflow?.nodes?.length) return;
-    const workflow = {
-      name: templateMeta.name,
-      nodes: rawWorkflow.nodes.filter((n) => n.type && n.name),
-      connections: rawWorkflow.connections,
-      settings: rawWorkflow.settings ? { executionOrder: "v1", ...rawWorkflow.settings } : { ...DEFAULT_SETTINGS }
-    };
-    const validation = this.validator.validate(workflow);
-    const validationErrors = validation.issues.filter((i) => i.severity === "error");
-    if (validationErrors.length > 0) {
-      progress.blocked++;
-      this.logger.debug(`Template ${id} blocked: ${validationErrors.length} validation errors`);
-      return;
-    }
-    const safety = assessTemplateSafety(workflow);
-    if (safety.trustLevel === "blocked") {
-      progress.blocked++;
-      this.logger.debug(`Template ${id} blocked: ${safety.reasons.join(", ")}`);
-      return;
-    }
-    if (safety.trustLevel === "review") {
-      progress.reviewed++;
-    }
-    const description = this.cleanDescription(templateMeta.description);
-    const autoTags = Array.from(new Set(
-      workflow.nodes.flatMap((n) => {
-        const bare = n.type.split(".").pop() ?? "";
-        const tags = [bare];
-        if (n.type.includes("Trigger") || n.type.includes("trigger")) tags.push(`trigger:${bare}`);
-        if (n.type.includes("langchain")) tags.push("ai");
-        return tags;
-      })
-    ));
-    const metadata = {
-      description,
-      tags: autoTags,
-      sourceKind: "n8n-template",
-      sourceId: String(id),
-      sourceUrl: `https://n8n.io/workflows/${id}`,
-      trustLevel: safety.trustLevel
-    };
-    await this.library.save(workflow, metadata);
-    progress.saved++;
-    this.logger.debug(`Template ${id} saved: "${templateMeta.name}" (${safety.trustLevel})`);
-  }
-  cleanDescription(raw) {
-    return raw.replace(/#{1,6}\s*/g, "").replace(/\*{1,2}([^*]+)\*{1,2}/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/\n{3,}/g, "\n\n").trim().slice(0, 500);
-  }
-};
-
 export {
-  NullLibrary,
-  GuardError,
-  N8nProvider,
-  GenerationError,
-  ResponseParseError,
-  ValidationError,
-  TelemetryCollector,
-  Kairos,
-  TemplateSyncer
+  Kairos
 };
-//# sourceMappingURL=chunk-N6LRD2FN.js.map
+//# sourceMappingURL=chunk-4TS6GW6O.js.map