@kilnai/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+export * from "./orchestrator/index.js";
+export * from "./agents/index.js";
+export * from "./domain/index.js";
+export * from "./package/index.js";
+export * from "./skill/index.js";
+export * from "./memory/index.js";
+export * from "./tree/index.js";
+export * from "./events/index.js";
+export * from "./cost/index.js";
+export * from "./security/index.js";
+export * from "./observability/index.js";
+export * from "./knowledge/index.js";
+export * from "./eval/index.js";
+export * from "./safety/index.js";
+export * as engine from "./engine/index.js";
+export type { StreamLevel } from "./events/index.js";
+export { EVENT_LEVEL_MAP, LEVEL_HIERARCHY } from "./events/index.js";
+export { KilnError } from "./engine/errors.js";
+export type { KilnErrorCode } from "./engine/errors.js";
+export { getErrorSuggestion } from "./engine/error-catalog.js";
+export type { ErrorSuggestion } from "./engine/error-catalog.js";
+export { CircuitBreaker } from "./agents/circuit-breaker.js";
+export type { CircuitBreakerConfig, CircuitState } from "./agents/circuit-breaker.js";
+export type { Channel, MessageFormat, IncomingMessage, OutgoingMessage, EngineEvent, } from "./engine/domain/channel.js";
+export type { ContentPart, TextPart, ImagePart, AudioPart, FilePart, ToolUsePart, ToolResultPart, } from "./engine/domain/content.js";
+export { textPart, textParts, extractText, hasModality, validateContentPart, validateContentParts, } from "./engine/domain/content.js";
+export type { Modality } from "./engine/domain/modality.js";
+export { VALID_MODALITIES, validateModalities } from "./engine/domain/modality.js";
+export type { SttAdapter, SttResult, TtsAdapter, TtsOptions, TtsResult, VoiceConfig, SttProviderConfig, TtsProviderConfig, } from "./engine/domain/speech-config.js";
+export { validateVoiceConfig } from "./engine/domain/speech-config.js";
+export type { GatewayConfig, GatewayAppBinding, GatewayChannelBinding, GatewayValidationError, } from "./engine/gateway/gateway-config.js";
+export { validateGatewayConfig } from "./engine/gateway/gateway-config.js";
+export { GatewayLoaderError, parseGatewayYaml } from "./engine/gateway/gateway-loader.js";
+export type { ObservabilityConfig, ObservabilityExporter } from "./engine/gateway/observability-config.js";
+export { validateObservabilityConfig } from "./engine/gateway/observability-config.js";
+export type { App, MemoryConfig, AppValidationError } from "./engine/composites/app.js";
+export { AppLoaderError, parseAppYaml, validateAppGraph } from "./engine/loader/app-loader.js";
+export { PresetLoaderError, loadPresetConfig } from "./engine/loader/preset-loader.js";
+export type { RuntimeMode, ProviderConfig, BillingConfig, BillingTier, BudgetResponse, UsageReport, ModeBConfig, ModeBValidationError, } from "./engine/gateway/mode-b-config.js";
+export { validateModeBConfig } from "./engine/gateway/mode-b-config.js";
+export { ModeBLoaderError, parseModeBConfig } from "./engine/gateway/mode-b-loader.js";
+export type { DelegationErrorCode, AppDelegation, DelegationTokenUsage, AppDelegationResult, DelegationError, DelegationValidationError, } from "./engine/gateway/delegation-config.js";
+export { isDelegationCapability, validateDelegation } from "./engine/gateway/delegation-config.js";
+export type { Trigger, TriggerType, WebhookTrigger, EventTrigger, ScheduleTrigger, TriggerValidationError, } from "./engine/domain/trigger.js";
+export { validateTrigger } from "./engine/domain/trigger.js";
+export type { CronExpression } from "./engine/domain/cron.js";
+export { parseCronExpression, validateCronExpression, nextFireTime } from "./engine/domain/cron.js";
+export type { TenantConfig, TenantService, TenantContact, TenantHours, TenantFaqEntry, TenantTone, TenantBilling, TenantValidationError, } from "./engine/gateway/tenant-config.js";
+export { validateTenantConfig } from "./engine/gateway/tenant-config.js";
+export type { AgentCard, A2ACapabilitySchema, A2AAuthConfig, A2ATaskStatus, A2AArtifact, A2APart, A2ATask, A2AMessage, A2AValidationError, } from "./engine/domain/a2a-config.js";
+export { validateAgentCard } from "./engine/domain/a2a-config.js";
+export type { McpConfig, McpServerConfig, McpValidationError, } from "./engine/domain/mcp-config.js";
+export { validateMcpConfig } from "./engine/domain/mcp-config.js";
+export type { ToolSelectionConfig, ToolSelectionStrategy, ToolSelectionValidationError, } from "./engine/domain/tool-selection-config.js";
+export { validateToolSelectionConfig } from "./engine/domain/tool-selection-config.js";
+export type { SafetyConfig, SafetyValidationError, PiiConfig, PiiType, PiiAction, ContentConfig, ContentCategory, ContentAction, ContentCategoryConfig, RailConfig, RailType, TopicRailConfig, CompetitorRailConfig, EscalationRailConfig, ComplianceRailConfig, } from "./engine/domain/safety-config.js";
+export { validateSafetyConfig } from "./engine/domain/safety-config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,42 @@
+export * from "./orchestrator/index.js";
+export * from "./agents/index.js";
+export * from "./domain/index.js";
+export * from "./package/index.js";
+export * from "./skill/index.js";
+export * from "./memory/index.js";
+export * from "./tree/index.js";
+export * from "./events/index.js";
+export * from "./cost/index.js";
+export * from "./security/index.js";
+export * from "./observability/index.js";
+export * from "./knowledge/index.js";
+export * from "./eval/index.js";
+export * from "./safety/index.js";
+export * as engine from "./engine/index.js";
+export { EVENT_LEVEL_MAP, LEVEL_HIERARCHY } from "./events/index.js";
+// Error hierarchy re-exported for direct access by runtime
+export { KilnError } from "./engine/errors.js";
+// Error catalog re-exported for direct access by CLI formatters
+export { getErrorSuggestion } from "./engine/error-catalog.js";
+// Circuit breaker re-exported for direct access by runtime
+export { CircuitBreaker } from "./agents/circuit-breaker.js";
+export { textPart, textParts, extractText, hasModality, validateContentPart, validateContentParts, } from "./engine/domain/content.js";
+export { VALID_MODALITIES, validateModalities } from "./engine/domain/modality.js";
+export { validateVoiceConfig } from "./engine/domain/speech-config.js";
+export { validateGatewayConfig } from "./engine/gateway/gateway-config.js";
+export { GatewayLoaderError, parseGatewayYaml } from "./engine/gateway/gateway-loader.js";
+export { validateObservabilityConfig } from "./engine/gateway/observability-config.js";
+export { AppLoaderError, parseAppYaml, validateAppGraph } from "./engine/loader/app-loader.js";
+// Preset loader re-exported for direct access by tests and tooling
+export { PresetLoaderError, loadPresetConfig } from "./engine/loader/preset-loader.js";
+export { validateModeBConfig } from "./engine/gateway/mode-b-config.js";
+export { ModeBLoaderError, parseModeBConfig } from "./engine/gateway/mode-b-loader.js";
+export { isDelegationCapability, validateDelegation } from "./engine/gateway/delegation-config.js";
+export { validateTrigger } from "./engine/domain/trigger.js";
+export { parseCronExpression, validateCronExpression, nextFireTime } from "./engine/domain/cron.js";
+export { validateTenantConfig } from "./engine/gateway/tenant-config.js";
+export { validateAgentCard } from "./engine/domain/a2a-config.js";
+export { validateMcpConfig } from "./engine/domain/mcp-config.js";
+export { validateToolSelectionConfig } from "./engine/domain/tool-selection-config.js";
+export { validateSafetyConfig } from "./engine/domain/safety-config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAI5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,2DAA2D;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,gEAAgE;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,2DAA2D;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAsB7D,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAWnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AASvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE1F,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAIvF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAE/F,mEAAmE;AACnE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAavF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAWvF,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAWnG,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAapG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAczE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAQlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAQlE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAoBvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/knowledge/index.d.ts

@@ -0,0 +1,10 @@
+export { RecursiveTextChunker } from "./recursive-chunker.js";
+export { MarkdownChunker } from "./markdown-chunker.js";
+export { OpenAIEmbeddingAdapter } from "./infrastructure/openai-embedding.js";
+export { OllamaEmbeddingAdapter } from "./infrastructure/ollama-embedding.js";
+export { InMemoryVectorStore, cosineSimilarity } from "./infrastructure/memory-vector-store.js";
+export { RetrievalPipeline } from "./retrieval-pipeline.js";
+export type { RetrievalPipelineConfig } from "./retrieval-pipeline.js";
+export { type Reranker } from "./reranker.js";
+export { createKnowledgeCapability, executeKnowledgeSearch } from "./knowledge-capability.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/knowledge/index.js

@@ -0,0 +1,9 @@
+// Knowledge bounded context -- RAG primitives
+export { RecursiveTextChunker } from "./recursive-chunker.js";
+export { MarkdownChunker } from "./markdown-chunker.js";
+export { OpenAIEmbeddingAdapter } from "./infrastructure/openai-embedding.js";
+export { OllamaEmbeddingAdapter } from "./infrastructure/ollama-embedding.js";
+export { InMemoryVectorStore, cosineSimilarity } from "./infrastructure/memory-vector-store.js";
+export { RetrievalPipeline } from "./retrieval-pipeline.js";
+export { createKnowledgeCapability, executeKnowledgeSearch } from "./knowledge-capability.js";
+//# sourceMappingURL=index.js.map

package/dist/knowledge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/knowledge/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/knowledge/infrastructure/memory-vector-store.d.ts

@@ -0,0 +1,12 @@
+import type { VectorEntry, VectorResult, VectorQueryOptions, VectorStore } from "../../engine/domain/vector-store.js";
+export declare class InMemoryVectorStore implements VectorStore {
+    private readonly entries;
+    upsert(entries: VectorEntry[]): Promise<void>;
+    query(embedding: number[], options: VectorQueryOptions): Promise<VectorResult[]>;
+    delete(ids: string[]): Promise<void>;
+    private matchesFilter;
+    get size(): number;
+    clear(): void;
+}
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=memory-vector-store.d.ts.map

package/dist/knowledge/infrastructure/memory-vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-vector-store.d.ts","sourceRoot":"","sources":["../../../src/knowledge/infrastructure/memory-vector-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEtH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAEpD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA6BhF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1C,OAAO,CAAC,aAAa;IASrB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA0BjE"}

package/dist/knowledge/infrastructure/memory-vector-store.js

@@ -0,0 +1,71 @@
+// InMemoryVectorStore -- simple Map-based vector storage with cosine similarity
+export class InMemoryVectorStore {
+    entries = new Map();
+    async upsert(entries) {
+        for (const entry of entries) {
+            this.entries.set(entry.id, entry);
+        }
+    }
+    async query(embedding, options) {
+        const { topK, minScore, filter } = options;
+        const results = [];
+        for (const entry of this.entries.values()) {
+            if (filter && !this.matchesFilter(entry.metadata, filter)) {
+                continue;
+            }
+            const score = cosineSimilarity(embedding, entry.embedding);
+            if (minScore !== undefined && score < minScore) {
+                continue;
+            }
+            results.push({
+                id: entry.id,
+                content: entry.content,
+                score,
+                metadata: entry.metadata,
+            });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, topK);
+    }
+    async delete(ids) {
+        for (const id of ids) {
+            this.entries.delete(id);
+        }
+    }
+    matchesFilter(metadata, filter) {
+        for (const [key, value] of Object.entries(filter)) {
+            if (metadata[key] !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimensions must match: ${a.length} vs ${b.length}`);
+    }
+    if (a.length === 0) {
+        return 0;
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0) {
+        return 0;
+    }
+    return dotProduct / denominator;
+}
+//# sourceMappingURL=memory-vector-store.js.map

package/dist/knowledge/infrastructure/memory-vector-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-vector-store.js","sourceRoot":"","sources":["../../../src/knowledge/infrastructure/memory-vector-store.ts"],"names":[],"mappings":"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"}

package/dist/knowledge/infrastructure/ollama-embedding.d.ts

@@ -0,0 +1,15 @@
+import type { EmbeddingAdapter } from "../../engine/domain/embedding.js";
+interface OllamaEmbeddingConfig {
+    readonly model?: string;
+    readonly baseUrl?: string;
+}
+export declare class OllamaEmbeddingAdapter implements EmbeddingAdapter {
+    readonly name = "ollama";
+    readonly dimensions: number;
+    private readonly model;
+    private readonly baseUrl;
+    constructor(config?: OllamaEmbeddingConfig);
+    embed(texts: string[]): Promise<number[][]>;
+}
+export {};
+//# sourceMappingURL=ollama-embedding.d.ts.map

package/dist/knowledge/infrastructure/ollama-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-embedding.d.ts","sourceRoot":"","sources":["../../../src/knowledge/infrastructure/ollama-embedding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,GAAE,qBAA0B;IAMxC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CA+BlD"}

package/dist/knowledge/infrastructure/ollama-embedding.js

@@ -0,0 +1,38 @@
+// Ollama embedding adapter -- fetch-based, local model
+export class OllamaEmbeddingAdapter {
+    name = "ollama";
+    dimensions;
+    model;
+    baseUrl;
+    constructor(config = {}) {
+        this.model = config.model ?? "nomic-embed-text";
+        this.baseUrl = config.baseUrl ?? "http://localhost:11434";
+        this.dimensions = 768;
+    }
+    async embed(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        const request = {
+            model: this.model,
+            input: texts,
+        };
+        const response = await fetch(`${this.baseUrl}/api/embed`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(request),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Ollama embedding request failed: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        const data = (await response.json());
+        if (!data.embeddings || data.embeddings.length !== texts.length) {
+            throw new Error(`Ollama returned ${data.embeddings?.length ?? 0} embeddings, expected ${texts.length}`);
+        }
+        return data.embeddings;
+    }
+}
+//# sourceMappingURL=ollama-embedding.js.map

package/dist/knowledge/infrastructure/ollama-embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-embedding.js","sourceRoot":"","sources":["../../../src/knowledge/infrastructure/ollama-embedding.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAmBvD,MAAM,OAAO,sBAAsB;IACxB,IAAI,GAAG,QAAQ,CAAC;IAChB,UAAU,CAAS;IACX,KAAK,CAAS;IACd,OAAO,CAAS;IAEjC,YAAY,SAAgC,EAAE;QAC5C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,kBAAkB,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,wBAAwB,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,KAAK;SACb,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,YAAY,EAAE;YACxD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CAAC,CAAC;QAC/G,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAEhE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,yBAAyB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1G,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/knowledge/infrastructure/openai-embedding.d.ts

@@ -0,0 +1,18 @@
+import type { EmbeddingAdapter } from "../../engine/domain/embedding.js";
+interface OpenAIEmbeddingConfig {
+    readonly apiKey: string;
+    readonly model?: string;
+}
+export declare class OpenAIEmbeddingAdapter implements EmbeddingAdapter {
+    readonly name = "openai";
+    readonly dimensions: number;
+    private readonly apiKey;
+    private readonly model;
+    private readonly baseUrl;
+    constructor(config: OpenAIEmbeddingConfig);
+    private getDimensionsForModel;
+    embed(texts: string[]): Promise<number[][]>;
+    private fetchWithRetry;
+}
+export {};
+//# sourceMappingURL=openai-embedding.d.ts.map

package/dist/knowledge/infrastructure/openai-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-embedding.d.ts","sourceRoot":"","sources":["../../../src/knowledge/infrastructure/openai-embedding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAcD,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;gBAE3C,MAAM,EAAE,qBAAqB;IAMzC,OAAO,CAAC,qBAAqB;IAOvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAuCnC,cAAc;CAoB7B"}

package/dist/knowledge/infrastructure/openai-embedding.js

@@ -0,0 +1,66 @@
+// OpenAI embedding adapter -- fetch-based, no external SDK dependency
+export class OpenAIEmbeddingAdapter {
+    name = "openai";
+    dimensions;
+    apiKey;
+    model;
+    baseUrl = "https://api.openai.com/v1";
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.model = config.model ?? "text-embedding-3-small";
+        this.dimensions = this.getDimensionsForModel(this.model);
+    }
+    getDimensionsForModel(model) {
+        if (model === "text-embedding-3-large") {
+            return 3072;
+        }
+        return 1536;
+    }
+    async embed(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        const response = await this.fetchWithRetry(`${this.baseUrl}/embeddings`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                input: texts,
+                model: this.model,
+            }),
+        });
+        const data = (await response.json());
+        const sortedEmbeddings = new Map();
+        for (const item of data.data) {
+            sortedEmbeddings.set(item.index, item.embedding);
+        }
+        const result = [];
+        for (let i = 0; i < texts.length; i++) {
+            const embedding = sortedEmbeddings.get(i);
+            if (!embedding) {
+                throw new Error(`Missing embedding for index ${i}`);
+            }
+            result.push(embedding);
+        }
+        return result;
+    }
+    async fetchWithRetry(url, options, retries = 3) {
+        for (let attempt = 0; attempt < retries; attempt++) {
+            const response = await fetch(url, options);
+            if (response.ok) {
+                return response;
+            }
+            if (response.status === 429 || response.status >= 500) {
+                const delay = Math.pow(2, attempt) * 1000;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                continue;
+            }
+            const errorText = await response.text();
+            throw new Error(`OpenAI embedding request failed: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        throw new Error(`OpenAI embedding request failed after ${retries} retries`);
+    }
+}
+//# sourceMappingURL=openai-embedding.js.map

package/dist/knowledge/infrastructure/openai-embedding.js.map

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

package/dist/knowledge/knowledge-capability.d.ts

@@ -0,0 +1,15 @@
+import type { Capability } from "../engine/domain/capability.js";
+import type { RetrievalPipeline } from "./retrieval-pipeline.js";
+export declare function createKnowledgeCapability(): Capability;
+export declare function executeKnowledgeSearch(pipeline: RetrievalPipeline, input: {
+    query: string;
+    source?: string;
+    topK?: number;
+}): Promise<{
+    results: {
+        content: string;
+        score: number;
+        metadata: Record<string, unknown>;
+    }[];
+}>;
+//# sourceMappingURL=knowledge-capability.d.ts.map

package/dist/knowledge/knowledge-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-capability.d.ts","sourceRoot":"","sources":["../../src/knowledge/knowledge-capability.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,wBAAgB,yBAAyB,IAAI,UAAU,CAoBtD;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAY/F"}

package/dist/knowledge/knowledge-capability.js

@@ -0,0 +1,36 @@
+// Knowledge capability auto-injection -- creates the knowledge_search capability
+export function createKnowledgeCapability() {
+    return {
+        name: "knowledge_search",
+        description: "Search the knowledge base for relevant information. Returns chunks ranked by relevance.",
+        schema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "The search query" },
+                source: { type: "string", description: "Optional: restrict to a specific knowledge source by name" },
+                topK: { type: "number", description: "Optional: max results to return (default: 5)" },
+            },
+            required: ["query"],
+        },
+        tags: ["knowledge", "search", "rag"],
+        annotations: {
+            readOnly: true,
+            idempotent: true,
+            cacheTtl: 60,
+        },
+    };
+}
+export async function executeKnowledgeSearch(pipeline, input) {
+    const results = await pipeline.retrieve(input.query, {
+        topK: input.topK ?? 5,
+        source: input.source,
+    });
+    return {
+        results: results.map((r) => ({
+            content: r.content,
+            score: r.score,
+            metadata: r.metadata,
+        })),
+    };
+}
+//# sourceMappingURL=knowledge-capability.js.map

package/dist/knowledge/knowledge-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-capability.js","sourceRoot":"","sources":["../../src/knowledge/knowledge-capability.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAKjF,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,yFAAyF;QACtG,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;gBAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBACpG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;aACtF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC;QACpC,WAAW,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAA2B,EAC3B,KAAwD;IAExD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE;QACnD,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;QACrB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;IACH,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/knowledge/markdown-chunker.d.ts

@@ -0,0 +1,8 @@
+import type { Document, Chunk, ChunkConfig, Chunker } from "../engine/domain/chunker.js";
+export declare class MarkdownChunker implements Chunker {
+    chunk(document: Document, config: ChunkConfig): Chunk[];
+    private splitByHeadings;
+    private fallbackChunk;
+    private generateChunkId;
+}
+//# sourceMappingURL=markdown-chunker.d.ts.map

package/dist/knowledge/markdown-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-chunker.d.ts","sourceRoot":"","sources":["../../src/knowledge/markdown-chunker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGzF,qBAAa,eAAgB,YAAW,OAAO;IAC7C,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE;IAqEvD,OAAO,CAAC,eAAe;IAsDvB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,eAAe;CAKxB"}

package/dist/knowledge/markdown-chunker.js

@@ -0,0 +1,146 @@
+// MarkdownChunker -- splits markdown by heading hierarchy, preserving structure
+import { createHash } from "node:crypto";
+export class MarkdownChunker {
+    chunk(document, config) {
+        const { content, metadata } = document;
+        const { chunkSize, chunkOverlap } = config;
+        if (!content || content.length === 0) {
+            return [];
+        }
+        const safeChunkSize = chunkSize > 0 ? chunkSize : 512;
+        const safeChunkOverlap = Math.min(chunkOverlap >= 0 ? chunkOverlap : 0, safeChunkSize);
+        const sections = this.splitByHeadings(content);
+        if (sections.length === 0) {
+            return this.fallbackChunk(document, config);
+        }
+        const chunks = [];
+        let currentChunk = "";
+        let currentHeading = "";
+        let currentLevel = 0;
+        let chunkIndex = 0;
+        const source = metadata.source || "unknown";
+        for (const section of sections) {
+            const sectionHeading = section.heading || currentHeading;
+            const sectionLevel = section.level || currentLevel;
+            const sectionContent = sectionHeading
+                ? `${"#".repeat(sectionLevel)} ${sectionHeading}\n\n${section.content}`
+                : section.content;
+            if (currentChunk.length + sectionContent.length > safeChunkSize && currentChunk.length > 0) {
+                const chunkId = this.generateChunkId(source, chunkIndex);
+                chunks.push({
+                    id: chunkId,
+                    content: currentChunk.trim(),
+                    metadata: { ...metadata, chunkIndex, heading: currentHeading, level: currentLevel },
+                });
+                const overlapStart = Math.max(0, currentChunk.length - safeChunkOverlap);
+                const overlapText = currentChunk.slice(overlapStart);
+                currentChunk = overlapText + sectionContent;
+                chunkIndex++;
+                currentHeading = sectionHeading;
+                currentLevel = sectionLevel;
+            }
+            else {
+                if (section.heading && currentChunk.length > 0) {
+                    currentChunk += "\n\n";
+                }
+                currentChunk += sectionContent;
+                currentHeading = sectionHeading;
+                currentLevel = sectionLevel;
+            }
+        }
+        if (currentChunk.trim().length > 0) {
+            const chunkId = this.generateChunkId(source, chunkIndex);
+            chunks.push({
+                id: chunkId,
+                content: currentChunk.trim(),
+                metadata: { ...metadata, chunkIndex, heading: currentHeading, level: currentLevel },
+            });
+        }
+        return chunks;
+    }
+    splitByHeadings(content) {
+        const lines = content.split("\n");
+        const sections = [];
+        let currentHeading = "";
+        let currentLevel = 0;
+        let currentContent = [];
+        let inCodeBlock = false;
+        for (const line of lines) {
+            if (line.startsWith("```")) {
+                currentContent.push(line);
+                inCodeBlock = !inCodeBlock;
+                continue;
+            }
+            if (inCodeBlock) {
+                currentContent.push(line);
+                continue;
+            }
+            const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+            if (headingMatch) {
+                if (currentContent.length > 0 || currentHeading) {
+                    sections.push({
+                        heading: currentHeading,
+                        level: currentLevel,
+                        content: currentContent.join("\n"),
+                    });
+                }
+                currentHeading = headingMatch[2];
+                currentLevel = headingMatch[1].length;
+                currentContent = [];
+            }
+            else {
+                const trimmedLine = line.trim();
+                if (trimmedLine) {
+                    currentContent.push(line);
+                }
+                else if (currentContent.length > 0 && currentContent[currentContent.length - 1].trim() !== "") {
+                    currentContent.push(line);
+                }
+            }
+        }
+        if (currentContent.length > 0 || currentHeading) {
+            sections.push({
+                heading: currentHeading,
+                level: currentLevel,
+                content: currentContent.join("\n"),
+            });
+        }
+        return sections;
+    }
+    fallbackChunk(document, config) {
+        const { content, metadata } = document;
+        const { chunkSize, chunkOverlap } = config;
+        const safeChunkSize = chunkSize > 0 ? chunkSize : 512;
+        const safeChunkOverlap = Math.min(chunkOverlap >= 0 ? chunkOverlap : 0, safeChunkSize);
+        const source = metadata.source || "unknown";
+        const chunks = [];
+        let startIndex = 0;
+        let chunkIndex = 0;
+        while (startIndex < content.length) {
+            let endIndex = startIndex + safeChunkSize;
+            if (endIndex >= content.length) {
+                endIndex = content.length;
+            }
+            const chunkContent = content.slice(startIndex, endIndex);
+            const chunkId = this.generateChunkId(source, chunkIndex);
+            chunks.push({
+                id: chunkId,
+                content: chunkContent,
+                metadata: { ...metadata, chunkIndex },
+            });
+            if (endIndex >= content.length) {
+                break;
+            }
+            const nextStart = endIndex - safeChunkOverlap;
+            startIndex = nextStart > startIndex ? nextStart : endIndex;
+            chunkIndex++;
+        }
+        return chunks;
+    }
+    generateChunkId(source, index) {
+        const input = `${source}:${index}`;
+        const hash = createHash("sha256").update(input).digest("hex");
+        return hash.slice(0, 16);
+    }
+}
+//# sourceMappingURL=markdown-chunker.js.map