@kilnai/core 0.1.15 → 0.9.0

package/dist/domains/routing-templates.js

@@ -0,0 +1,109 @@
+const ROUTING_TEMPLATES = [
+    {
+        id: "service-business",
+        name: "Service Business",
+        description: "For salons, clinics, repair shops — routes booking, general inquiries, and support",
+        category: "service",
+        agents: [
+            {
+                id: "booking",
+                name: "Booking Agent",
+                role: "Appointment scheduler",
+                goal: "Help customers book, reschedule, and cancel appointments",
+            },
+            {
+                id: "general",
+                name: "General Inquiry Agent",
+                role: "Information specialist",
+                goal: "Answer questions about services, pricing, and business details",
+            },
+            {
+                id: "support",
+                name: "Support Agent",
+                role: "Customer support",
+                goal: "Resolve customer issues and complaints",
+            },
+        ],
+        routing: {
+            rules: [
+                { match: "appointment|book|schedule|reserv|reschedule", agent: "booking" },
+                { match: "problem|issue|complaint|broken|not working", agent: "support" },
+            ],
+            fallback: "general",
+        },
+    },
+    {
+        id: "ecommerce",
+        name: "E-Commerce",
+        description: "For online stores — routes sales, order support, and returns",
+        category: "ecommerce",
+        agents: [
+            {
+                id: "sales",
+                name: "Sales Agent",
+                role: "Sales specialist",
+                goal: "Help customers find products and complete purchases",
+            },
+            {
+                id: "order-support",
+                name: "Order Support Agent",
+                role: "Order specialist",
+                goal: "Track orders, handle shipping inquiries, and resolve delivery issues",
+            },
+            {
+                id: "returns",
+                name: "Returns Agent",
+                role: "Returns and refunds specialist",
+                goal: "Process returns, exchanges, and refunds",
+            },
+        ],
+        routing: {
+            rules: [
+                { match: "buy|purchase|price|quote|cost|product", agent: "sales" },
+                { match: "cancel|refund|return|exchange", agent: "returns" },
+                { match: "order|tracking|shipping|delivery|shipped", agent: "order-support" },
+            ],
+            fallback: "sales",
+        },
+    },
+    {
+        id: "customer-support",
+        name: "Customer Support",
+        description: "For multi-tier support — routes triage, technical issues, and billing",
+        category: "support",
+        agents: [
+            {
+                id: "triage",
+                name: "Triage Agent",
+                role: "First responder",
+                goal: "Assess customer needs and route to the right specialist",
+            },
+            {
+                id: "technical",
+                name: "Technical Support Agent",
+                role: "Technical specialist",
+                goal: "Resolve technical issues, bugs, and errors",
+            },
+            {
+                id: "billing",
+                name: "Billing Agent",
+                role: "Billing specialist",
+                goal: "Handle invoices, payments, subscriptions, and billing disputes",
+            },
+        ],
+        routing: {
+            rules: [
+                { match: "error|bug|crash|broken|not working|technical", agent: "technical" },
+                { match: "invoice|charge|payment|billing|subscription|plan", agent: "billing" },
+            ],
+            fallback: "triage",
+        },
+    },
+];
+export function getRoutingTemplate(id) {
+    return ROUTING_TEMPLATES.find((t) => t.id === id);
+}
+export function listRoutingTemplates() {
+    return ROUTING_TEMPLATES;
+}
+//# sourceMappingURL=routing-templates.js.map

package/dist/domains/routing-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-templates.js","sourceRoot":"","sources":["../../src/domains/routing-templates.ts"],"names":[],"mappings":"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"}

package/dist/engine/domain/capability.d.ts

@@ -1,3 +1,4 @@
+import type { RetryConfig } from "./tool-execution.js";
 /** Safety annotations that drive engine policies */
 export interface CapabilityAnnotations {
     readonly readOnly?: boolean;
@@ -20,5 +21,6 @@ export interface Capability {
     readonly guardrail?: string;
     readonly guardrailRetries?: number;
     readonly outputSchema?: Record<string, unknown>;
+    readonly retry?: RetryConfig;
 }
 //# sourceMappingURL=capability.d.ts.map

package/dist/engine/domain/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/capability.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/capability.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC9B"}

package/dist/engine/domain/chunker.d.ts

@@ -19,4 +19,8 @@ export interface ChunkConfig {
 export interface Chunker {
     chunk(document: Document, config: ChunkConfig): Chunk[];
 }
+/** Optional post-chunking enrichment. Adds contextual prefixes to chunks using an LLM. */
+export interface ChunkEnricher {
+    enrich(document: Document, chunks: Chunk[]): Promise<Chunk[]>;
+}
 //# sourceMappingURL=chunker.d.ts.map

package/dist/engine/domain/chunker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/chunker.ts"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,wCAAwC;AACxC,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,8BAA8B;AAC9B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,sCAAsC;AACtC,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAAC;CACzD"}
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/chunker.ts"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,wCAAwC;AACxC,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,8BAA8B;AAC9B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,sCAAsC;AACtC,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAAC;CACzD;AAED,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CAC/D"}

package/dist/engine/domain/contact-memory.d.ts

@@ -0,0 +1,30 @@
+export type FactCategory = "preference" | "entity" | "issue" | "general";
+export type FactAction = "ADD" | "UPDATE" | "DELETE" | "NOOP";
+export interface ContactFact {
+    readonly id: string;
+    readonly externalUserId: string;
+    readonly tenantId: string;
+    readonly content: string;
+    readonly category: FactCategory;
+    readonly confidence: number;
+    readonly validAt: string;
+    readonly expiredAt?: string;
+    readonly createdAt: string;
+}
+export interface ExtractedFact {
+    readonly action: FactAction;
+    readonly content: string;
+    readonly category: FactCategory;
+    readonly confidence: number;
+    readonly existingFactId?: string;
+}
+export interface ContactMemoryService {
+    extractAndStore(conversationHistory: string, externalUserId: string, tenantId: string): Promise<readonly ContactFact[]>;
+    recall(externalUserId: string, tenantId: string, options?: {
+        query?: string;
+        limit?: number;
+    }): Promise<readonly ContactFact[]>;
+    forget(factId: string, tenantId: string): Promise<void>;
+    forgetAll(externalUserId: string, tenantId: string): Promise<void>;
+}
+//# sourceMappingURL=contact-memory.d.ts.map

package/dist/engine/domain/contact-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-memory.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/contact-memory.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AACzE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,CACb,mBAAmB,EAAE,MAAM,EAC3B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAEnC,MAAM,CACJ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAEnC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE"}

package/dist/engine/domain/contact-memory.js

@@ -0,0 +1,4 @@
+// Engine domain: Contact Memory -- per-user fact storage across conversations
+// Facts extracted via LLM after session expiry, recalled at next conversation start
+export {};
+//# sourceMappingURL=contact-memory.js.map

package/dist/engine/domain/contact-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-memory.js","sourceRoot":"","sources":["../../../src/engine/domain/contact-memory.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oFAAoF"}

package/dist/engine/domain/knowledge-config.d.ts

@@ -5,26 +5,51 @@ export interface KnowledgeEmbeddingConfig {
     readonly baseUrl?: string;
 }
 export interface KnowledgeStoreConfig {
-    readonly backend: "memory" | "pgvector" | "sqlite-vec";
+    readonly backend: "memory" | "pgvector";
     readonly connectionString?: string;
 }
+export interface ContextualConfig {
+    readonly enabled: boolean;
+    readonly provider: "anthropic" | "openai" | "deepseek" | "ollama";
+    readonly model?: string;
+    readonly apiKeyEnv?: string;
+    readonly baseUrl?: string;
+    readonly concurrency?: number;
+}
 export interface KnowledgeChunkingConfig {
     readonly strategy: "recursive" | "markdown";
     readonly chunkSize?: number;
     readonly chunkOverlap?: number;
+    readonly contextual?: ContextualConfig;
 }
 export interface KnowledgeSourceConfig {
     readonly name: string;
     readonly path: string;
+    readonly type?: "file" | "url" | "pdf";
     readonly watch?: boolean;
     readonly chunking?: KnowledgeChunkingConfig;
 }
+export interface KnowledgeRerankerConfig {
+    readonly provider: "cohere";
+    readonly model?: string;
+    readonly apiKeyEnv: string;
+}
+export interface ContactMemoryConfig {
+    readonly enabled: boolean;
+    readonly provider: "anthropic" | "openai" | "deepseek" | "ollama";
+    readonly model?: string;
+    readonly apiKeyEnv?: string;
+    readonly baseUrl?: string;
+}
 export interface KnowledgeConfig {
     readonly embedding: KnowledgeEmbeddingConfig;
     readonly store: KnowledgeStoreConfig;
     readonly chunking: KnowledgeChunkingConfig;
     readonly sources: readonly KnowledgeSourceConfig[];
+    readonly reranker?: KnowledgeRerankerConfig;
     readonly allowedAgents?: readonly string[];
+    readonly mode?: "auto" | "tool";
+    readonly contactMemory?: ContactMemoryConfig;
 }
 export interface KnowledgeValidationError {
     readonly field: string;

package/dist/engine/domain/knowledge-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-config.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/knowledge-config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IACvD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,wBAAwB,EAAE,CAiE3F"}
+{"version":3,"file":"knowledge-config.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/knowledge-config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CAC9C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,wBAAwB,EAAE,CAyG3F"}

package/dist/engine/domain/knowledge-config.js

@@ -13,10 +13,10 @@ export function validateKnowledgeConfig(config) {
     if (!config.store || !config.store.backend) {
         errors.push({ field: "store.backend", message: "required" });
     }
-    else if (!["memory", "pgvector", "sqlite-vec"].includes(config.store.backend)) {
-        errors.push({ field: "store.backend", message: "must be 'memory', 'pgvector', or 'sqlite-vec'" });
+    else if (!["memory", "pgvector"].includes(config.store.backend)) {
+        errors.push({ field: "store.backend", message: "must be 'memory' or 'pgvector'" });
     }
-    if (["pgvector", "sqlite-vec"].includes(config.store.backend) && !config.store.connectionString) {
+    if (config.store.backend === "pgvector" && !config.store.connectionString) {
         errors.push({ field: "store.connectionString", message: `required when backend is '${config.store.backend}'` });
     }
     if (!config.chunking || !config.chunking.strategy) {
@@ -36,6 +36,44 @@ export function validateKnowledgeConfig(config) {
     if (effectiveChunkOverlap >= effectiveChunkSize) {
         errors.push({ field: "chunking.chunkOverlap", message: "must be less than chunkSize" });
     }
+    if (config.mode !== undefined && config.mode !== "auto" && config.mode !== "tool") {
+        errors.push({ field: "mode", message: "must be 'auto' or 'tool'" });
+    }
+    if (config.chunking.contextual?.enabled) {
+        const ctx = config.chunking.contextual;
+        if (!ctx.provider) {
+            errors.push({ field: "chunking.contextual.provider", message: "required when contextual enrichment is enabled" });
+        }
+        else if (!["anthropic", "openai", "deepseek", "ollama"].includes(ctx.provider)) {
+            errors.push({ field: "chunking.contextual.provider", message: "must be 'anthropic', 'openai', 'deepseek', or 'ollama'" });
+        }
+        if (ctx.provider !== "ollama" && !ctx.apiKeyEnv) {
+            errors.push({ field: "chunking.contextual.apiKeyEnv", message: `required when provider is '${ctx.provider}'` });
+        }
+        if (ctx.concurrency !== undefined && ctx.concurrency <= 0) {
+            errors.push({ field: "chunking.contextual.concurrency", message: "must be greater than 0" });
+        }
+    }
+    if (config.contactMemory?.enabled) {
+        const cm = config.contactMemory;
+        if (!cm.provider) {
+            errors.push({ field: "contactMemory.provider", message: "required when contact memory is enabled" });
+        }
+        else if (!["anthropic", "openai", "deepseek", "ollama"].includes(cm.provider)) {
+            errors.push({ field: "contactMemory.provider", message: "must be 'anthropic', 'openai', 'deepseek', or 'ollama'" });
+        }
+        if (cm.provider !== "ollama" && !cm.apiKeyEnv) {
+            errors.push({ field: "contactMemory.apiKeyEnv", message: `required when provider is '${cm.provider}'` });
+        }
+    }
+    if (config.reranker) {
+        if (config.reranker.provider !== "cohere") {
+            errors.push({ field: "reranker.provider", message: "must be 'cohere'" });
+        }
+        if (!config.reranker.apiKeyEnv || typeof config.reranker.apiKeyEnv !== "string") {
+            errors.push({ field: "reranker.apiKeyEnv", message: "required" });
+        }
+    }
     if (!config.sources || !Array.isArray(config.sources) || config.sources.length === 0) {
         errors.push({ field: "sources", message: "must be a non-empty array" });
     }

package/dist/engine/domain/knowledge-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-config.js","sourceRoot":"","sources":["../../../src/engine/domain/knowledge-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"knowledge-config.js","sourceRoot":"","sources":["../../../src/engine/domain/knowledge-config.ts"],"names":[],"mappings":"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"}

package/dist/engine/domain/knowledge-source.d.ts

@@ -0,0 +1,31 @@
+export type KnowledgeSourceType = "file" | "url" | "pdf";
+export type KnowledgeSourceStatus = "pending" | "indexing" | "indexed" | "failed";
+export interface KnowledgeSource {
+    readonly sourceId: string;
+    readonly appName: string;
+    readonly name: string;
+    readonly type: KnowledgeSourceType;
+    readonly uri: string;
+    readonly status: KnowledgeSourceStatus;
+    readonly contentHash?: string;
+    readonly chunkCount: number;
+    readonly error?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly lastIndexedAt?: string;
+}
+export interface ExtractedContent {
+    readonly content: string;
+    readonly metadata: Record<string, unknown>;
+}
+export interface ContentExtractor {
+    readonly supportedTypes: readonly KnowledgeSourceType[];
+    extract(uri: string, type: KnowledgeSourceType): Promise<ExtractedContent>;
+}
+export interface SourceStore {
+    get(appName: string, sourceId: string): KnowledgeSource | undefined;
+    list(appName: string): readonly KnowledgeSource[];
+    save(source: KnowledgeSource): void;
+    remove(appName: string, sourceId: string): boolean;
+}
+//# sourceMappingURL=knowledge-source.d.ts.map

package/dist/engine/domain/knowledge-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-source.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/knowledge-source.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AACzD,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,CAAC;IAClD,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACpD"}

package/dist/engine/domain/knowledge-source.js

@@ -0,0 +1,3 @@
+// Knowledge source domain types -- source lifecycle management for knowledge RAG
+export {};
+//# sourceMappingURL=knowledge-source.js.map

package/dist/engine/domain/knowledge-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-source.js","sourceRoot":"","sources":["../../../src/engine/domain/knowledge-source.ts"],"names":[],"mappings":"AAAA,iFAAiF"}

package/dist/engine/domain/model-router.d.ts

@@ -0,0 +1,87 @@
+/** Routing tier describes how the model was selected */
+export type RoutingTier = "rule" | "complexity" | "cascade" | "default";
+/** Complexity class derived from complexity score */
+export type ComplexityClass = "trivial" | "simple" | "moderate" | "complex" | "expert";
+/** Static capability profile for a model */
+export interface ModelCapabilityProfile {
+    readonly provider: string;
+    readonly model: string;
+    readonly supportsTools: boolean;
+    readonly supportsStreaming: boolean;
+    readonly supportsStructuredOutput: boolean;
+    readonly supportsVision: boolean;
+    readonly supportsAudio: boolean;
+    readonly maxContextTokens: number;
+    readonly qualityTier: "high" | "medium" | "low";
+    readonly inputPer1M: number;
+    readonly outputPer1M: number;
+}
+/** Complexity scoring output */
+export interface ComplexityScore {
+    readonly score: number;
+    readonly class: ComplexityClass;
+    readonly signals: {
+        readonly tokenCount: number;
+        readonly hasTools: boolean;
+        readonly toolCount: number;
+        readonly hasCodeBlocks: boolean;
+        readonly hasReasoningMarkers: boolean;
+        readonly turnDepth: number;
+    };
+}
+/** Input to the model router */
+export interface RoutingRequest {
+    readonly tenantId: string;
+    readonly agentId?: string;
+    readonly agentTier?: "reasoning" | "coding" | "fast";
+    readonly complexity: ComplexityScore;
+    readonly hasTools: boolean;
+    readonly toolCount: number;
+    readonly requiresStreaming: boolean;
+    readonly budgetRemainingCents?: number;
+}
+/** Output from the model router */
+export interface RoutingDecision {
+    readonly provider: string;
+    readonly model: string;
+    readonly reasoning: string;
+    readonly confidence: number;
+    readonly routingTier: RoutingTier;
+    readonly estimatedCostUsd?: number;
+}
+/** Routing condition types for rules-based routing */
+export type RoutingCondition = {
+    readonly type: "has_tools";
+} | {
+    readonly type: "complexity_above";
+    readonly threshold: number;
+} | {
+    readonly type: "complexity_below";
+    readonly threshold: number;
+} | {
+    readonly type: "budget_below_cents";
+    readonly cents: number;
+} | {
+    readonly type: "agent_tier";
+    readonly tier: "fast" | "coding" | "reasoning";
+} | {
+    readonly type: "agent_id";
+    readonly agentId: string;
+} | {
+    readonly type: "always";
+};
+/** A single routing rule */
+export interface RoutingRule {
+    readonly name: string;
+    readonly priority: number;
+    readonly condition: RoutingCondition;
+    readonly target: {
+        readonly provider: string;
+        readonly model: string;
+    };
+}
+/** Model router interface */
+export interface ModelRouter {
+    route(request: RoutingRequest): RoutingDecision;
+}
+//# sourceMappingURL=model-router.d.ts.map

package/dist/engine/domain/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/model-router.ts"],"names":[],"mappings":"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"}

package/dist/engine/domain/model-router.js

@@ -0,0 +1,4 @@
+// Engine type: ModelRouter -- per-request model selection
+// Pure TypeScript, zero external dependencies.
+export {};
+//# sourceMappingURL=model-router.js.map

package/dist/engine/domain/model-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.js","sourceRoot":"","sources":["../../../src/engine/domain/model-router.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,+CAA+C"}

package/dist/engine/domain/rate-limiter.d.ts

@@ -0,0 +1,15 @@
+export interface RateLimitConfig {
+    readonly defaultPerMinute: number;
+    readonly perTool?: Readonly<Record<string, number>>;
+}
+export interface RateLimitResult {
+    readonly allowed: boolean;
+    readonly remaining: number;
+    readonly retryAfterMs?: number;
+}
+export interface RateLimiter {
+    check(tenantId: string, toolName: string): RateLimitResult;
+    record(tenantId: string, toolName: string): void;
+    reset(tenantId: string): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/engine/domain/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/rate-limiter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC;IAC3D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/engine/domain/rate-limiter.js

@@ -0,0 +1,3 @@
+// Engine domain: rate limiting types for Phase 5b (tenant tool config)
+export {};
+//# sourceMappingURL=rate-limiter.js.map

package/dist/engine/domain/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../src/engine/domain/rate-limiter.ts"],"names":[],"mappings":"AAAA,uEAAuE"}

package/dist/engine/domain/tool-execution.d.ts

@@ -0,0 +1,33 @@
+/** Retry strategy for tool execution errors */
+export type RetryStrategy = "exponential" | "mutate_params";
+/** Retry configuration for a capability */
+export interface RetryConfig {
+    readonly onValidationError?: RetryStrategy;
+    readonly onTransientError?: RetryStrategy;
+    readonly maxAttempts?: number;
+    readonly timeout?: number;
+    readonly fallback?: string;
+}
+/** Authorization level (1=auto-execute, 2=audit, 3=confirm, 4=always-confirm) */
+export type AuthorizationLevel = 1 | 2 | 3 | 4;
+/** Result of a tool authorization check */
+export interface ToolAuthorizationResult {
+    readonly level: AuthorizationLevel;
+    readonly allowed: boolean;
+    readonly requiresApproval: boolean;
+    readonly reason: string;
+}
+/** Classification of a tool execution error */
+export type ToolErrorType = "validation" | "transient" | "fatal";
+/** Interface for authorizing tool execution based on annotations */
+export interface ToolAuthorizer {
+    authorize(toolName: string, annotations?: import("./capability.js").CapabilityAnnotations): ToolAuthorizationResult;
+}
+/** Result of tool execution with retry */
+export interface ToolExecutionResult {
+    readonly result: unknown;
+    readonly attempts: number;
+    readonly durationMs: number;
+    readonly fallbackUsed: boolean;
+}
+//# sourceMappingURL=tool-execution.d.ts.map

package/dist/engine/domain/tool-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-execution.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/tool-execution.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5D,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAEjE,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,iBAAiB,EAAE,qBAAqB,GAAG,uBAAuB,CAAC;CACrH;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC"}

package/dist/engine/domain/tool-execution.js

@@ -0,0 +1,3 @@
+// Engine domain: tool execution types for Phase 5a (agentic actions)
+export {};
+//# sourceMappingURL=tool-execution.js.map

package/dist/engine/domain/tool-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-execution.js","sourceRoot":"","sources":["../../../src/engine/domain/tool-execution.ts"],"names":[],"mappings":"AAAA,qEAAqE"}

package/dist/engine/domain/vector-store.d.ts

@@ -23,5 +23,6 @@ export interface VectorStore {
     upsert(entries: VectorEntry[]): Promise<void>;
     query(embedding: number[], options: VectorQueryOptions): Promise<VectorResult[]>;
     delete(ids: string[]): Promise<void>;
+    deleteByMetadata(filter: Record<string, unknown>): Promise<number>;
 }
 //# sourceMappingURL=vector-store.d.ts.map

package/dist/engine/domain/vector-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/vector-store.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACjF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC"}
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../../src/engine/domain/vector-store.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACjF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpE"}

package/dist/engine/error-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-catalog.d.ts","sourceRoot":"","sources":["../../src/engine/error-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,mFAAmF;AACnF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe,CAybjB"}
+{"version":3,"file":"error-catalog.d.ts","sourceRoot":"","sources":["../../src/engine/error-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,mFAAmF;AACnF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe,CAyjBjB"}