@kairos-sdk/core 0.5.1 → 0.6.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as ClientOptions, B as BuildOptions, a as BuildResult, N as N8nWorkflow, W as WorkflowListItem, D as DeleteOptions, E as ExecutionFilter, b as ExecutionSummary, c as ExecutionDetail, T as Tag } from './reader-B5mV20H6.cjs';
-export { A as ApiError, d as AttemptMetadata, e as CredentialRequirement, f as DEFAULT_REGISTRY, g as DeployResult, F as FailurePattern, h as FileLibrary, G as GenerationError, i as GuardError, I as ILogger, j as IProvider, k as IWorkflowLibrary, K as KairosError, l as N8nApiClient, m as N8nConnections, n as N8nFieldStripper, o as N8nNode, p as N8nProvider, q as N8nSettings, r as N8nValidator, s as NodeRegistry, t as NullLibrary, O as OutcomeData, u as OutcomeStats, P as ProviderError, R as ResponseParseError, v as RuleFailureRate, S as ScoredEntry, w as SmokeTestResult, x as SourceKind, y as StoredWorkflow, z as SyncProgress, H as TelemetryCollector, J as TelemetryEvent, L as TelemetryReader, M as TemplateSyncer, Q as TrustLevel, V as ValidationError, U as ValidationIssue, X as ValidationResult, Y as WorkflowCluster, Z as WorkflowMatch, _ as WorkflowMetadataInput, $ as buildSearchCorpus, a0 as clusterWorkflows, a1 as hybridScore, a2 as nullLogger, a3 as rerank, a4 as tokenize } from './reader-B5mV20H6.cjs';
+import { C as ClientOptions, B as BuildOptions, b as BuildResult, r as N8nWorkflow, Z as WorkflowListItem, d as DeleteOptions, f as ExecutionFilter, g as ExecutionSummary, E as ExecutionDetail, T as Tag, c as CredentialRequirement } from './reader-CfWGpL4V.cjs';
+export { A as ApiError, a as AttemptMetadata, D as DEFAULT_REGISTRY, e as DeployResult, F as FailurePattern, h as FileLibrary, G as GenerationError, i as GuardError, I as ILogger, j as IProvider, k as IWorkflowLibrary, K as KairosError, N as N8nApiClient, l as N8nConnections, m as N8nFieldStripper, n as N8nNode, o as N8nProvider, p as N8nSettings, q as N8nValidator, s as NodeRegistry, t as NullLibrary, O as OutcomeData, u as OutcomeStats, P as ProviderError, R as ResponseParseError, v as RuleFailureRate, S as ScoredEntry, w as SmokeTestResult, y as SourceKind, z as StoredWorkflow, H as SyncProgress, J as TelemetryCollector, L as TelemetryEvent, M as TelemetryReader, Q as TemplateSyncer, U as TrustLevel, V as ValidationError, W as ValidationIssue, X as ValidationResult, Y as WorkflowCluster, _ as WorkflowMatch, $ as WorkflowMetadataInput, a0 as buildSearchCorpus, a1 as clusterWorkflows, a2 as hybridScore, a3 as nullLogger, a4 as rerank, a5 as tokenize } from './reader-CfWGpL4V.cjs';
 
 declare class Kairos {
     private readonly provider;
@@ -34,4 +34,87 @@ declare class Kairos {
     untag(workflowId: string, tagIds: string[]): Promise<void>;
 }
 
-export { BuildOptions, BuildResult, ClientOptions, DeleteOptions, ExecutionDetail, ExecutionFilter, ExecutionSummary, Kairos, N8nWorkflow, Tag, WorkflowListItem };
+type AssumptionType = 'safe' | 'needs_confirmation' | 'blocking';
+type PackStatus = 'draft' | 'blocked' | 'ready_for_test' | 'ready_for_activation' | 'active' | 'needs_attention';
+interface TypedAssumption {
+    type: AssumptionType;
+    text: string;
+}
+interface WorkflowPlan {
+    name: string;
+    description: string;
+    purpose: string;
+}
+interface PackPlan {
+    businessContext: string;
+    workflows: WorkflowPlan[];
+    assumptions: TypedAssumption[];
+    sheetsColumns: Array<{
+        sheet: string;
+        columns: string[];
+    }>;
+    testChecklist: Array<{
+        workflow: string;
+        steps: string[];
+    }>;
+}
+interface PackWorkflowResult {
+    name: string;
+    purpose: string;
+    workflowId: string | null;
+    deployed: boolean;
+    generationAttempts: number;
+    credentialsNeeded: CredentialRequirement[];
+    error?: string;
+}
+interface WorkflowPackResult {
+    businessContext: string;
+    packName: string;
+    status: PackStatus;
+    workflows: PackWorkflowResult[];
+    allCredentials: Array<{
+        service: string;
+        credentialType: string;
+    }>;
+    sheetsColumns: Array<{
+        sheet: string;
+        columns: string[];
+    }>;
+    assumptions: TypedAssumption[];
+    testChecklist: Array<{
+        workflow: string;
+        steps: string[];
+    }>;
+    builtAt: string;
+}
+declare function derivePackStatus(pack: Pick<WorkflowPackResult, 'assumptions' | 'workflows'> & {
+    status?: PackStatus;
+}): PackStatus;
+declare class PackBuilder {
+    private client;
+    private kairos;
+    private model;
+    constructor(options: {
+        anthropicApiKey: string;
+        kairos: Kairos;
+        model?: string;
+    });
+    plan(businessContext: string): Promise<PackPlan>;
+    build(plan: PackPlan, options?: {
+        dryRun?: boolean;
+        activate?: boolean;
+        onProgress?: (workflow: WorkflowPlan, index: number, total: number) => void;
+    }): Promise<WorkflowPackResult>;
+}
+
+declare function generateHandoff(pack: WorkflowPackResult): string;
+
+interface PackValidationIssue {
+    type: 'duplicate_name' | 'blocking_assumption' | 'unsafe_activation' | 'schedule_conflict';
+    severity: 'error' | 'warning';
+    message: string;
+    workflows?: string[];
+}
+declare function validatePack(pack: WorkflowPackResult): PackValidationIssue[];
+
+export { type AssumptionType, BuildOptions, BuildResult, ClientOptions, CredentialRequirement, DeleteOptions, ExecutionDetail, ExecutionFilter, ExecutionSummary, Kairos, N8nWorkflow, PackBuilder, type PackPlan, type PackStatus, type PackValidationIssue, type PackWorkflowResult, Tag, type TypedAssumption, WorkflowListItem, type WorkflowPackResult, type WorkflowPlan, derivePackStatus, generateHandoff, validatePack };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ClientOptions, B as BuildOptions, a as BuildResult, N as N8nWorkflow, W as WorkflowListItem, D as DeleteOptions, E as ExecutionFilter, b as ExecutionSummary, c as ExecutionDetail, T as Tag } from './reader-B5mV20H6.js';
-export { A as ApiError, d as AttemptMetadata, e as CredentialRequirement, f as DEFAULT_REGISTRY, g as DeployResult, F as FailurePattern, h as FileLibrary, G as GenerationError, i as GuardError, I as ILogger, j as IProvider, k as IWorkflowLibrary, K as KairosError, l as N8nApiClient, m as N8nConnections, n as N8nFieldStripper, o as N8nNode, p as N8nProvider, q as N8nSettings, r as N8nValidator, s as NodeRegistry, t as NullLibrary, O as OutcomeData, u as OutcomeStats, P as ProviderError, R as ResponseParseError, v as RuleFailureRate, S as ScoredEntry, w as SmokeTestResult, x as SourceKind, y as StoredWorkflow, z as SyncProgress, H as TelemetryCollector, J as TelemetryEvent, L as TelemetryReader, M as TemplateSyncer, Q as TrustLevel, V as ValidationError, U as ValidationIssue, X as ValidationResult, Y as WorkflowCluster, Z as WorkflowMatch, _ as WorkflowMetadataInput, $ as buildSearchCorpus, a0 as clusterWorkflows, a1 as hybridScore, a2 as nullLogger, a3 as rerank, a4 as tokenize } from './reader-B5mV20H6.js';
+import { C as ClientOptions, B as BuildOptions, b as BuildResult, r as N8nWorkflow, Z as WorkflowListItem, d as DeleteOptions, f as ExecutionFilter, g as ExecutionSummary, E as ExecutionDetail, T as Tag, c as CredentialRequirement } from './reader-CfWGpL4V.js';
+export { A as ApiError, a as AttemptMetadata, D as DEFAULT_REGISTRY, e as DeployResult, F as FailurePattern, h as FileLibrary, G as GenerationError, i as GuardError, I as ILogger, j as IProvider, k as IWorkflowLibrary, K as KairosError, N as N8nApiClient, l as N8nConnections, m as N8nFieldStripper, n as N8nNode, o as N8nProvider, p as N8nSettings, q as N8nValidator, s as NodeRegistry, t as NullLibrary, O as OutcomeData, u as OutcomeStats, P as ProviderError, R as ResponseParseError, v as RuleFailureRate, S as ScoredEntry, w as SmokeTestResult, y as SourceKind, z as StoredWorkflow, H as SyncProgress, J as TelemetryCollector, L as TelemetryEvent, M as TelemetryReader, Q as TemplateSyncer, U as TrustLevel, V as ValidationError, W as ValidationIssue, X as ValidationResult, Y as WorkflowCluster, _ as WorkflowMatch, $ as WorkflowMetadataInput, a0 as buildSearchCorpus, a1 as clusterWorkflows, a2 as hybridScore, a3 as nullLogger, a4 as rerank, a5 as tokenize } from './reader-CfWGpL4V.js';
 
 declare class Kairos {
     private readonly provider;
@@ -34,4 +34,87 @@ declare class Kairos {
     untag(workflowId: string, tagIds: string[]): Promise<void>;
 }
 
-export { BuildOptions, BuildResult, ClientOptions, DeleteOptions, ExecutionDetail, ExecutionFilter, ExecutionSummary, Kairos, N8nWorkflow, Tag, WorkflowListItem };
+type AssumptionType = 'safe' | 'needs_confirmation' | 'blocking';
+type PackStatus = 'draft' | 'blocked' | 'ready_for_test' | 'ready_for_activation' | 'active' | 'needs_attention';
+interface TypedAssumption {
+    type: AssumptionType;
+    text: string;
+}
+interface WorkflowPlan {
+    name: string;
+    description: string;
+    purpose: string;
+}
+interface PackPlan {
+    businessContext: string;
+    workflows: WorkflowPlan[];
+    assumptions: TypedAssumption[];
+    sheetsColumns: Array<{
+        sheet: string;
+        columns: string[];
+    }>;
+    testChecklist: Array<{
+        workflow: string;
+        steps: string[];
+    }>;
+}
+interface PackWorkflowResult {
+    name: string;
+    purpose: string;
+    workflowId: string | null;
+    deployed: boolean;
+    generationAttempts: number;
+    credentialsNeeded: CredentialRequirement[];
+    error?: string;
+}
+interface WorkflowPackResult {
+    businessContext: string;
+    packName: string;
+    status: PackStatus;
+    workflows: PackWorkflowResult[];
+    allCredentials: Array<{
+        service: string;
+        credentialType: string;
+    }>;
+    sheetsColumns: Array<{
+        sheet: string;
+        columns: string[];
+    }>;
+    assumptions: TypedAssumption[];
+    testChecklist: Array<{
+        workflow: string;
+        steps: string[];
+    }>;
+    builtAt: string;
+}
+declare function derivePackStatus(pack: Pick<WorkflowPackResult, 'assumptions' | 'workflows'> & {
+    status?: PackStatus;
+}): PackStatus;
+declare class PackBuilder {
+    private client;
+    private kairos;
+    private model;
+    constructor(options: {
+        anthropicApiKey: string;
+        kairos: Kairos;
+        model?: string;
+    });
+    plan(businessContext: string): Promise<PackPlan>;
+    build(plan: PackPlan, options?: {
+        dryRun?: boolean;
+        activate?: boolean;
+        onProgress?: (workflow: WorkflowPlan, index: number, total: number) => void;
+    }): Promise<WorkflowPackResult>;
+}
+
+declare function generateHandoff(pack: WorkflowPackResult): string;
+
+interface PackValidationIssue {
+    type: 'duplicate_name' | 'blocking_assumption' | 'unsafe_activation' | 'schedule_conflict';
+    severity: 'error' | 'warning';
+    message: string;
+    workflows?: string[];
+}
+declare function validatePack(pack: WorkflowPackResult): PackValidationIssue[];
+
+export { type AssumptionType, BuildOptions, BuildResult, ClientOptions, CredentialRequirement, DeleteOptions, ExecutionDetail, ExecutionFilter, ExecutionSummary, Kairos, N8nWorkflow, PackBuilder, type PackPlan, type PackStatus, type PackValidationIssue, type PackWorkflowResult, Tag, type TypedAssumption, WorkflowListItem, type WorkflowPackResult, type WorkflowPlan, derivePackStatus, generateHandoff, validatePack };

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   Kairos
-} from "./chunk-GVZKMS53.js";
-import "./chunk-V2IZBZGB.js";
+} from "./chunk-YOQTEVDB.js";
+import "./chunk-STG7Z2SS.js";
 import "./chunk-6FOFWVMG.js";
 import {
   GenerationError,
@@ -10,7 +10,7 @@ import {
   ResponseParseError,
   TemplateSyncer,
   ValidationError
-} from "./chunk-MYAGTDQ2.js";
+} from "./chunk-PCNW5ZUD.js";
 import {
   ApiError,
   DEFAULT_REGISTRY,
@@ -30,7 +30,17 @@ import {
   nullLogger,
   rerank,
   tokenize
-} from "./chunk-VPPWTMRJ.js";
+} from "./chunk-2ZHNO37N.js";
+import {
+  PackBuilder,
+  derivePackStatus
+} from "./chunk-GG4B4TYG.js";
+import {
+  generateHandoff
+} from "./chunk-SC6CLQZB.js";
+import {
+  validatePack
+} from "./chunk-SQS4QHDH.js";
 export {
   ApiError,
   DEFAULT_REGISTRY,
@@ -45,6 +55,7 @@ export {
   N8nValidator,
   NodeRegistry,
   NullLibrary,
+  PackBuilder,
   ProviderError,
   ResponseParseError,
   TelemetryCollector,
@@ -53,9 +64,12 @@ export {
   ValidationError,
   buildSearchCorpus,
   clusterWorkflows,
+  derivePackStatus,
+  generateHandoff,
   hybridScore,
   nullLogger,
   rerank,
-  tokenize
+  tokenize,
+  validatePack
 };
 //# sourceMappingURL=index.js.map

package/dist/mcp-server.cjs

@@ -901,6 +901,7 @@ var N8nValidator = class {
     this.checkRule32(workflow, issues);
     this.checkRule33(workflow, issues);
     this.checkRule34(workflow, issues);
+    this.checkRule35(workflow, issues);
     if (Array.isArray(workflow.nodes)) {
       const nodeById = new Map(workflow.nodes.map((n) => [n.id, n.type]));
       for (const issue of issues) {
@@ -1473,6 +1474,43 @@ var N8nValidator = class {
       }
     }
   }
+  // Rule 35 (WARN): email-sending node with no duplicate-prevention signal
+  checkRule35(w, issues) {
+    if (!Array.isArray(w.nodes)) return;
+    const sendNodes = w.nodes.filter((node) => {
+      if (node.type === "n8n-nodes-base.gmail") {
+        const op = node.parameters?.["operation"];
+        return !op || op === "send" || op === "sendEmail" || op === "reply";
+      }
+      return node.type === "n8n-nodes-base.emailSend" || node.type === "n8n-nodes-base.sendEmail";
+    });
+    if (sendNodes.length === 0) return;
+    const workflowText = JSON.stringify(w).toLowerCase();
+    const IDEMPOTENCY_SIGNALS = [
+      "sent_at",
+      "last_sent",
+      "last_reminder",
+      "processed_at",
+      "already_sent",
+      "email_sent",
+      "notified_at",
+      "reminder_sent",
+      "contacted_at",
+      "dedupe",
+      "idempotent"
+    ];
+    const hasIdempotencySignal = IDEMPOTENCY_SIGNALS.some((s) => workflowText.includes(s));
+    if (!hasIdempotencySignal) {
+      for (const node of sendNodes) {
+        this.warn(
+          issues,
+          35,
+          `Node "${node.name}" sends email but no duplicate-prevention signal detected \u2014 add a sent_at timestamp field, a prior-send IF check, or a deduplication key to avoid repeat sends`,
+          node.id
+        );
+      }
+    }
+  }
   // Rule 34 (WARN): webhook path contains spaces, starts with slash, or looks like a full URL
   checkRule34(w, issues) {
     if (!Array.isArray(w.nodes)) return;
@@ -2020,7 +2058,7 @@ Respond ONLY with a generate_workflow tool call. No prose. No markdown outside t
 If the request is impossible or unclear, set the error field instead of generating a workflow.`;
 
 // src/validation/rule-metadata.ts
-var VALIDATOR_RULE_IDS = Array.from({ length: 34 }, (_, i) => i + 1);
+var VALIDATOR_RULE_IDS = Array.from({ length: 35 }, (_, i) => i + 1);
 var RULE_PIPELINE_STAGES = {
   1: "node_generation",
   2: "node_generation",
@@ -2055,7 +2093,8 @@ var RULE_PIPELINE_STAGES = {
   31: "node_generation",
   32: "node_generation",
   33: "node_generation",
-  34: "node_generation"
+  34: "node_generation",
+  35: "node_generation"
 };
 var RULE_EXAMPLES = {
   17: {
@@ -2105,6 +2144,10 @@ var RULE_EXAMPLES = {
   34: {
     bad: '"path": "/my webhook"',
     good: '"path": "my-webhook"'
+  },
+  35: {
+    bad: '"type": "n8n-nodes-base.gmail", "parameters": { "operation": "send" }  // no sent_at tracking',
+    good: 'Add a Set node after send that writes "sent_at": "={{ $now }}" back to the sheet, or an IF node that checks sent_at before sending'
   }
 };
 var RULE_MITIGATIONS = {
@@ -2141,7 +2184,8 @@ var RULE_MITIGATIONS = {
   31: "Add at least one condition to the if node \u2014 conditions.conditions array must be non-empty",
   32: "Add field assignments to the set node \u2014 assignments.assignments array must be non-empty for typeVersion 3.x",
   33: "Add at least one schedule rule to scheduleTrigger \u2014 rule.interval array must have at least one entry",
-  34: 'Webhook path must be a relative path without spaces, leading slashes, or protocol prefixes (e.g. "my-hook")'
+  34: 'Webhook path must be a relative path without spaces, leading slashes, or protocol prefixes (e.g. "my-hook")',
+  35: "Add duplicate-prevention to email-sending workflows: a sent_at timestamp field updated after each send, or an IF node that checks prior-send status before sending"
 };
 
 // src/generation/prompt-builder.ts