@kairos-sdk/core 0.4.0 → 0.5.0

package/dist/{chunk-N6LRD2FN.js → chunk-HBGZTUUZ.js}

@@ -1,175 +1,26 @@
 import {
-  KairosError,
+  PromptBuilder,
+  inferWorkflowType
+} from "./chunk-EVOAYH2K.js";
+import {
+  GenerationError,
+  N8nProvider,
+  NullLibrary,
+  ResponseParseError,
+  ValidationError
+} from "./chunk-5GAY7CSJ.js";
+import {
+  GuardError,
   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-KIFT5LA7.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;
@@ -245,7 +96,8 @@ var WorkflowDesigner = class {
         const issueLines = lastErrors.map(
           (i) => `- [Rule ${i.rule}] ${i.message}${i.nodeId ? ` (node: ${i.nodeId})` : ""}`
         );
-        userMessage = this.promptBuilder.buildCorrectionMessage(request, matches, issueLines, attempt - 1);
+        const failingRuleIds = lastErrors.map((i) => i.rule);
+        userMessage = this.promptBuilder.buildCorrectionMessage(request, matches, issueLines, attempt - 1, failingRuleIds);
         this.logger.debug(`WorkflowDesigner: correction attempt ${attempt}`, { issueCount: lastErrors.length });
       }
       const start = Date.now();
@@ -306,6 +158,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,7 +189,9 @@ var WorkflowDesigner = class {
 };
 
 // src/client.ts
-var DEFAULT_MODEL = "claude-sonnet-4-6";
+import { homedir } from "os";
+import { join } from "path";
+var DEFAULT_MODEL = process.env["KAIROS_MODEL"] ?? "claude-sonnet-4-6";
 var Kairos = class {
   provider;
   designer;
@@ -360,7 +219,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 +253,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 +294,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 +309,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 +333,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,
@@ -484,10 +349,19 @@ var Kairos = class {
     }
     const provider = this.requireProvider();
     const deployed = await provider.deploy(workflow);
-    this.recordDeploy();
+    this.logger.info("Workflow deployed to n8n", { workflowId: deployed.workflowId, name: deployed.name });
+    this.recordDeploy(deployed.workflowId);
     if (options?.activate) {
       await provider.activate(deployed.workflowId);
     }
+    let smokeTestResult;
+    if (options?.smokeTest) {
+      smokeTestResult = await provider.smokeTest(deployed.workflowId, workflow).catch((err) => {
+        this.logger.warn("Smoke test threw unexpectedly", { err: String(err) });
+        return { status: "error", triggerType: "manual", error: String(err) };
+      });
+      this.logger.info("Smoke test complete", { status: smokeTestResult.status, triggerType: smokeTestResult.triggerType });
+    }
     const totalTokensInput = designResult.attemptMetadata.reduce((s, m) => s + m.tokensInput, 0);
     const totalTokensOutput = designResult.attemptMetadata.reduce((s, m) => s + m.tokensOutput, 0);
     await this.telemetry?.emit("build_complete", {
@@ -501,8 +375,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,
@@ -511,18 +386,21 @@ var Kairos = class {
       credentialsNeeded: designResult.credentialsNeeded,
       activationRequired: !options?.activate,
       generationAttempts: designResult.attempts,
-      dryRun: false
+      dryRun: false,
+      ...smokeTestResult !== void 0 ? { smokeTest: smokeTestResult } : {}
     };
   }
   async replace(id, description) {
     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 +419,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,16 +434,18 @@ 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);
+    this.logger.info("Workflow updated in n8n", { workflowId: deployed.workflowId, name: deployed.name });
+    this.saveToLibrary(designResult.workflow, description, designResult, matches, deployed.workflowId);
     this.recordDeploy();
     const totalTokensInput = designResult.attemptMetadata.reduce((s, m) => s + m.tokensInput, 0);
     const totalTokensOutput = designResult.attemptMetadata.reduce((s, m) => s + m.tokensOutput, 0);
@@ -579,8 +460,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 +485,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,14 +496,15 @@ 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() {
+  recordDeploy(n8nWorkflowId) {
     this.saveQueue = this.saveQueue.then(async (savedId) => {
       if (savedId) {
-        await this.library.recordDeployment(savedId);
+        await this.library.recordDeployment(savedId, n8nWorkflowId);
       }
       return savedId;
     }).catch((err) => {
@@ -629,7 +512,7 @@ var Kairos = class {
       return null;
     });
   }
-  saveToLibrary(workflow, description, designResult, matches) {
+  saveToLibrary(workflow, description, designResult, matches, n8nWorkflowId) {
     const failedAttempts = designResult.attemptMetadata.filter((m) => !m.validationPassed);
     const failurePatterns = failedAttempts.flatMap(
       (m) => m.issues.map((i) => ({ rule: i.rule, message: i.message }))
@@ -655,6 +538,7 @@ var Kairos = class {
     if (matches.length > 0) metadata.sourceWorkflowIds = matches.map((m) => m.workflow.id);
     if (topMatch) metadata.topMatchScore = topMatch.score;
     if (designResult.credentialsNeeded.length > 0) metadata.credentialsNeeded = designResult.credentialsNeeded;
+    if (n8nWorkflowId) metadata.n8nWorkflowId = n8nWorkflowId;
     const firstTryPass = designResult.attemptMetadata.length > 0 && designResult.attemptMetadata[0].validationPassed;
     const failedRules = Array.from(new Set(
       designResult.attemptMetadata.filter((m) => !m.validationPassed).flatMap((m) => m.issues.map((i) => i.rule))
@@ -712,190 +596,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-HBGZTUUZ.js.map