@kairos-sdk/core 0.3.2 → 0.4.5

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

@@ -1,170 +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,
-  PromptBuilder,
+  PatternAnalyzer,
+  TelemetryCollector,
   TelemetryReader,
   generateUUID,
   nullLogger,
   scoreToMode
-} from "./chunk-RYGYNOR6.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) {
-    super(message);
-    this.issues = issues;
-    this.name = "ValidationError";
-  }
-  issues;
-};
-
-// 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";
@@ -212,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;
@@ -262,7 +118,7 @@ var WorkflowDesigner = class {
         issues: validation.issues
       });
       if (validation.valid) {
-        return { workflow: parsed.workflow, credentialsNeeded: parsed.credentialsNeeded, attempts, attemptMetadata };
+        return { workflow: parsed.workflow, credentialsNeeded: parsed.credentialsNeeded, attempts, attemptMetadata, warnedRules: this.promptBuilder.getWarnedRules() };
       }
       lastErrors = errors;
       this.logger.warn(`WorkflowDesigner: validation failed on attempt ${attempt}`, {
@@ -272,7 +128,9 @@ var WorkflowDesigner = class {
     const finalIssues = attemptMetadata.at(-1)?.issues ?? lastErrors;
     throw new ValidationError(
       `Workflow failed validation after ${MAX_ATTEMPTS} attempts`,
-      finalIssues
+      finalIssues,
+      attemptMetadata,
+      this.promptBuilder.getWarnedRules()
     );
   }
   async callClaude(system, userMessage, temperature) {
@@ -299,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"
     );
@@ -325,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;
@@ -334,6 +199,7 @@ var Kairos = class {
   logger;
   telemetry;
   telemetryReader;
+  patternAnalyzer;
   model;
   saveQueue = Promise.resolve(null);
   constructor(options) {
@@ -352,19 +218,23 @@ 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;
     if (options.telemetry === true) {
       this.telemetry = new TelemetryCollector();
       this.telemetryReader = new TelemetryReader();
+      this.patternAnalyzer = new PatternAnalyzer();
     } else if (typeof options.telemetry === "string") {
       this.telemetry = new TelemetryCollector(options.telemetry);
       this.telemetryReader = new TelemetryReader(options.telemetry);
+      this.patternAnalyzer = new PatternAnalyzer(options.telemetry);
     } else {
       this.telemetry = null;
       this.telemetryReader = null;
+      this.patternAnalyzer = null;
     }
   }
   requireProvider() {
@@ -382,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) {
@@ -402,12 +274,48 @@ var Kairos = class {
         this.logger.info(`Telemetry: ${highFreq.length} high-frequency failure rule(s) will be warned about`);
       }
     }
-    const designResult = await this.designer.design(
-      { description, ...options?.name ? { name: options.name } : {} },
-      matches,
-      globalFailureRates
-    );
-    await this.emitAttemptTelemetry(description, designResult);
+    let designResult;
+    try {
+      designResult = await this.designer.design(
+        { description, ...options?.name ? { name: options.name } : {} },
+        matches,
+        globalFailureRates
+      );
+    } catch (err) {
+      if (err instanceof ValidationError && err.attemptMetadata) {
+        for (const meta of err.attemptMetadata) {
+          await this.telemetry?.emit("generation_attempt", {
+            description,
+            attempt: meta.attempt,
+            temperature: meta.temperature,
+            durationMs: meta.durationMs,
+            tokensInput: meta.tokensInput,
+            tokensOutput: meta.tokensOutput,
+            validationPassed: meta.validationPassed,
+            issueCount: meta.issues.length,
+            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,
+          success: false,
+          totalAttempts: err.attemptMetadata.length,
+          totalDurationMs: Date.now() - buildStart,
+          totalTokensInput: err.attemptMetadata.reduce((s, m) => s + m.tokensInput, 0),
+          totalTokensOutput: err.attemptMetadata.reduce((s, m) => s + m.tokensOutput, 0),
+          workflowName: null,
+          workflowId: null,
+          dryRun: options?.dryRun ?? false,
+          credentialsNeeded: 0,
+          warnedRules: err.warnedRules ?? [],
+          workflowType
+        }, runId);
+        this.updatePatterns();
+      }
+      throw err;
+    }
+    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) {
@@ -423,8 +331,11 @@ var Kairos = class {
         workflowName: workflow.name,
         workflowId: null,
         dryRun: true,
-        credentialsNeeded: designResult.credentialsNeeded.length
-      });
+        credentialsNeeded: designResult.credentialsNeeded.length,
+        warnedRules: designResult.warnedRules,
+        workflowType
+      }, runId);
+      this.updatePatterns();
       return {
         workflowId: null,
         name: workflow.name,
@@ -453,8 +364,11 @@ var Kairos = class {
       workflowName: deployed.name,
       workflowId: deployed.workflowId,
       dryRun: false,
-      credentialsNeeded: designResult.credentialsNeeded.length
-    });
+      credentialsNeeded: designResult.credentialsNeeded.length,
+      warnedRules: designResult.warnedRules,
+      workflowType
+    }, runId);
+    this.updatePatterns();
     return {
       workflowId: deployed.workflowId,
       name: deployed.name,
@@ -469,16 +383,54 @@ 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() ?? [];
-    const designResult = await this.designer.design({ description }, matches, globalFailureRates);
-    await this.emitAttemptTelemetry(description, designResult);
+    let designResult;
+    try {
+      designResult = await this.designer.design({ description }, matches, globalFailureRates);
+    } catch (err) {
+      if (err instanceof ValidationError && err.attemptMetadata) {
+        for (const meta of err.attemptMetadata) {
+          await this.telemetry?.emit("generation_attempt", {
+            description,
+            attempt: meta.attempt,
+            temperature: meta.temperature,
+            durationMs: meta.durationMs,
+            tokensInput: meta.tokensInput,
+            tokensOutput: meta.tokensOutput,
+            validationPassed: meta.validationPassed,
+            issueCount: meta.issues.length,
+            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,
+          success: false,
+          totalAttempts: err.attemptMetadata.length,
+          totalDurationMs: Date.now() - buildStart,
+          totalTokensInput: err.attemptMetadata.reduce((s, m) => s + m.tokensInput, 0),
+          totalTokensOutput: err.attemptMetadata.reduce((s, m) => s + m.tokensOutput, 0),
+          workflowName: null,
+          workflowId: null,
+          dryRun: false,
+          credentialsNeeded: 0,
+          warnedRules: err.warnedRules ?? [],
+          workflowType
+        }, runId);
+        this.updatePatterns();
+      }
+      throw err;
+    }
+    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);
@@ -495,8 +447,11 @@ var Kairos = class {
       workflowName: deployed.name,
       workflowId: deployed.workflowId,
       dryRun: false,
-      credentialsNeeded: designResult.credentialsNeeded.length
-    });
+      credentialsNeeded: designResult.credentialsNeeded.length,
+      warnedRules: designResult.warnedRules,
+      workflowType
+    }, runId);
+    this.updatePatterns();
     return {
       workflowId: deployed.workflowId,
       name: deployed.name,
@@ -511,7 +466,14 @@ var Kairos = class {
     await this.saveQueue.catch(() => {
     });
   }
-  async emitAttemptTelemetry(description, designResult) {
+  updatePatterns() {
+    if (!this.patternAnalyzer) return;
+    this.saveQueue = this.saveQueue.then(() => this.patternAnalyzer.analyzeAndSave()).then(() => null).catch((err) => {
+      this.logger.warn("Pattern analysis failed (non-fatal)", { err: String(err) });
+      return null;
+    });
+  }
+  async emitAttemptTelemetry(description, designResult, workflowType, runId) {
     for (const meta of designResult.attemptMetadata) {
       await this.telemetry?.emit("generation_attempt", {
         description,
@@ -522,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 }))
-      });
+        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() {
@@ -620,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-KQSNT3HZ.js.map
+//# sourceMappingURL=chunk-4TS6GW6O.js.map