agentx-sdk 0.1.0

package/dist/core/streaming-tool-executor.js

@@ -0,0 +1,164 @@
+/**
+ * Executes tools while the LLM is still streaming.
+ * Respects concurrency safety: safe tools run in parallel, unsafe tools run alone.
+ * Results are always yielded in submission order.
+ * Supports progress callbacks — tools can report incremental updates.
+ */
+export class StreamingToolExecutor {
+    tools = [];
+    executor;
+    signal;
+    processing = false;
+    /** Accumulated progress events from all tools (drained by getProgressEvents) */
+    pendingProgress = [];
+    constructor(executor, signal) {
+        this.executor = executor;
+        this.signal = signal;
+    }
+    /** Called during LLM streaming when a tool_call chunk arrives */
+    addTool(id, name, args) {
+        let parsedArgs;
+        try {
+            parsedArgs = JSON.parse(args);
+        }
+        catch {
+            parsedArgs = {};
+        }
+        const toolDef = this.executor.listTools().find(t => t.name === name);
+        const isSafe = toolDef
+            ? typeof toolDef.isConcurrencySafe === 'function'
+                ? toolDef.isConcurrencySafe(parsedArgs)
+                : toolDef.isConcurrencySafe === true
+            : false;
+        const tracked = { id, name, args, isSafe, status: 'queued', progressEvents: [] };
+        this.tools.push(tracked);
+        void this.processQueue();
+    }
+    /**
+     * Non-blocking: yields completed results in submission order.
+     * Call during streaming to drain finished tools without waiting.
+     */
+    *getCompletedResults() {
+        for (const tool of this.tools) {
+            if (tool.status === 'completed') {
+                tool.status = 'yielded';
+                yield {
+                    id: tool.id,
+                    name: tool.name,
+                    result: tool.result,
+                    duration: tool.duration,
+                };
+            }
+            else if (tool.status !== 'yielded') {
+                break;
+            }
+        }
+    }
+    /**
+     * Non-blocking: drains accumulated progress events from all tools.
+     * Call during streaming alongside getCompletedResults().
+     */
+    *getProgressEvents() {
+        while (this.pendingProgress.length > 0) {
+            yield this.pendingProgress.shift();
+        }
+    }
+    /**
+     * Blocking: waits for all remaining tools to complete, yielding in order.
+     * Call after streaming ends.
+     */
+    async *getRemainingResults() {
+        for (const tool of this.tools) {
+            if (tool.status === 'yielded')
+                continue;
+            if (tool.promise) {
+                await tool.promise;
+            }
+            tool.status = 'yielded';
+            yield {
+                id: tool.id,
+                name: tool.name,
+                result: tool.result,
+                duration: tool.duration,
+            };
+        }
+    }
+    /**
+     * Process the queue respecting concurrency rules:
+     * - Multiple consecutive safe tools can execute in parallel
+     * - An unsafe tool must execute alone (waits for all prior to finish)
+     */
+    async processQueue() {
+        if (this.processing)
+            return;
+        this.processing = true;
+        try {
+            while (true) {
+                const nextQueued = this.tools.find(t => t.status === 'queued');
+                if (!nextQueued)
+                    break;
+                const executing = this.tools.filter(t => t.status === 'executing');
+                if (nextQueued.isSafe) {
+                    const hasUnsafeExecuting = executing.some(t => !t.isSafe);
+                    if (hasUnsafeExecuting) {
+                        await Promise.all(executing.map(t => t.promise));
+                        continue;
+                    }
+                    this.startTool(nextQueued);
+                }
+                else {
+                    if (executing.length > 0) {
+                        await Promise.all(executing.map(t => t.promise));
+                        continue;
+                    }
+                    this.startTool(nextQueued);
+                    await nextQueued.promise;
+                }
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    startTool(tracked) {
+        tracked.status = 'executing';
+        tracked.promise = this.executeTool(tracked);
+    }
+    async executeTool(tracked) {
+        const start = Date.now();
+        let parsedArgs;
+        try {
+            parsedArgs = JSON.parse(tracked.args);
+        }
+        catch {
+            parsedArgs = {};
+        }
+        // Build progress callback that accumulates events
+        const onProgress = (data) => {
+            const event = {
+                toolCallId: tracked.id,
+                toolName: tracked.name,
+                data,
+            };
+            tracked.progressEvents.push(event);
+            this.pendingProgress.push(event);
+        };
+        try {
+            const result = await this.executor.execute(tracked.name, parsedArgs, {
+                signal: this.signal,
+                toolCallId: tracked.id,
+                onProgress,
+            });
+            tracked.result = result;
+        }
+        catch (error) {
+            tracked.result = {
+                content: `Tool error: ${error instanceof Error ? error.message : String(error)}`,
+                isError: true,
+            };
+        }
+        tracked.duration = Date.now() - start;
+        tracked.status = 'completed';
+    }
+}
+//# sourceMappingURL=streaming-tool-executor.js.map

package/dist/core/streaming-tool-executor.js.map

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

package/dist/core/turn-end-hooks.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Turn-end hooks — run after each completed assistant turn.
+ *
+ * Ported from old_src/query/stopHooks.ts pattern. In old_src, turn-end
+ * is where "invisible intelligence" lives: memory extraction, session
+ * summary, prompt suggestions, and custom hooks all fire here.
+ *
+ * Two modes:
+ * - Fire-and-forget (blocking: false, default) — errors swallowed, never blocks
+ * - Blocking (blocking: true) — can return errors and prevent continuation
+ */
+import type { TokenUsage } from '../contracts/entities/token-usage.js';
+export interface TurnEndHookContext {
+    assistantText: string;
+    turnCount: number;
+    threadId: string;
+    usage: TokenUsage;
+}
+export interface TurnEndHookResult {
+    blockingError?: string;
+    preventContinuation?: boolean;
+}
+export interface TurnEndHook {
+    name: string;
+    /** If true, hook can return blocking errors and prevent continuation. Default: false. */
+    blocking?: boolean;
+    execute(context: TurnEndHookContext): Promise<TurnEndHookResult | void>;
+}
+export interface TurnEndHooksResult {
+    blockingErrors: string[];
+    preventContinuation: boolean;
+}
+/**
+ * Run all turn-end hooks in order.
+ * Fire-and-forget hooks (blocking: false) run but errors are swallowed.
+ * Blocking hooks can return errors and prevent continuation.
+ */
+export declare function runTurnEndHooks(hooks: TurnEndHook[], context: TurnEndHookContext): Promise<TurnEndHooksResult>;
+//# sourceMappingURL=turn-end-hooks.d.ts.map

package/dist/core/turn-end-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-end-hooks.d.ts","sourceRoot":"","sources":["../../src/core/turn-end-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAkB7B"}

package/dist/core/turn-end-hooks.js

@@ -0,0 +1,36 @@
+/**
+ * Turn-end hooks — run after each completed assistant turn.
+ *
+ * Ported from old_src/query/stopHooks.ts pattern. In old_src, turn-end
+ * is where "invisible intelligence" lives: memory extraction, session
+ * summary, prompt suggestions, and custom hooks all fire here.
+ *
+ * Two modes:
+ * - Fire-and-forget (blocking: false, default) — errors swallowed, never blocks
+ * - Blocking (blocking: true) — can return errors and prevent continuation
+ */
+/**
+ * Run all turn-end hooks in order.
+ * Fire-and-forget hooks (blocking: false) run but errors are swallowed.
+ * Blocking hooks can return errors and prevent continuation.
+ */
+export async function runTurnEndHooks(hooks, context) {
+    const blockingErrors = [];
+    let preventContinuation = false;
+    for (const hook of hooks) {
+        try {
+            const result = await hook.execute(context);
+            if (hook.blocking && result) {
+                if (result.blockingError)
+                    blockingErrors.push(result.blockingError);
+                if (result.preventContinuation)
+                    preventContinuation = true;
+            }
+        }
+        catch {
+            // Hooks should never break the pipeline
+        }
+    }
+    return { blockingErrors, preventContinuation };
+}
+//# sourceMappingURL=turn-end-hooks.js.map

package/dist/core/turn-end-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-end-hooks.js","sourceRoot":"","sources":["../../src/core/turn-end-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4BH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB,EACpB,OAA2B;IAE3B,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAE3C,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC;gBAC5B,IAAI,MAAM,CAAC,aAAa;oBAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBACpE,IAAI,MAAM,CAAC,mBAAmB;oBAAE,mBAAmB,GAAG,IAAI,CAAC;YAC7D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC;AACjD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+export { Agent } from './agent.js';
+export type { ChatOptions } from './agent.js';
+export * from './contracts/index.js';
+export { AgentConfigSchema } from './config/config.js';
+export type { AgentConfig, AgentConfigInput, MCPConnectionConfig, MCPConnectionConfigInput, CostPolicy } from './config/config.js';
+export { FileMemorySystem } from './memory/file-memory-system.js';
+export type { FileMemoryConfig } from './memory/file-memory-system.js';
+export type { MemoryType, MemoryHeader, MemoryFile, SaveMemoryInput } from './memory/memory-types.js';
+export { SQLiteVectorStore } from './knowledge/sqlite-vector-store.js';
+export { SQLiteConversationStore } from './storage/sqlite-conversation-store.js';
+export { SQLiteDatabase } from './storage/sqlite-database.js';
+export { builtinTools } from './tools/builtin/index.js';
+export { createGlobTool, createGrepTool, createFileReadTool, createFileWriteTool, createFileEditTool, createBashTool, createWebFetchTool, createAskUserTool, } from './tools/builtin/index.js';
+export type { AskUserOptions } from './tools/builtin/index.js';
+export { createSqlTools } from './tools/sql/index.js';
+export type { SqlToolFactoryOptions, SqlQueryRunner, SqlQueryDef } from './tools/sql/index.js';
+export { jsonSchemaToZod } from './tools/json-schema-to-zod.js';
+export { MCPAdapter } from './tools/mcp-adapter.js';
+export type { MCPHealthStatus, MCPResource, MCPPromptInfo, MCPConnectionInfo } from './tools/mcp-adapter.js';
+export { SkillManager } from './skills/skill-manager.js';
+export { createSkillTool, SKILL_TOOL_NAME } from './tools/skill-tool.js';
+export { scanSkillFiles, loadSkillFile, parseSkillFrontmatter } from './skills/skill-loader.js';
+export { substituteArgs } from './skills/skill-args.js';
+export { matchGlob, matchAnyGlob } from './skills/skill-glob.js';
+export { runTurnEndHooks } from './core/turn-end-hooks.js';
+export type { TurnEndHook, TurnEndHookContext, TurnEndHookResult } from './core/turn-end-hooks.js';
+export { buildToolUsagePrompt, buildEnvironmentPrompt } from './core/prompt-builders.js';
+export type { EnvironmentInfo } from './core/prompt-builders.js';
+export { normalizeMessagesForAPI } from './core/message-normalize.js';
+export { PromptSectionCache } from './core/prompt-cache.js';
+export { analyzeContext } from './core/context-analysis.js';
+export type { ContextAnalysis } from './core/context-analysis.js';
+export { getModelContextWindow } from './utils/model-context.js';
+export { createLogger } from './utils/logger.js';
+export type { Logger } from './utils/logger.js';
+export { LRUCache } from './utils/cache.js';
+export { retry } from './utils/retry.js';
+export { estimateTokens } from './utils/token-counter.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":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGnI,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EACL,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EACvE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,GAC1E,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG7G,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,45 @@
+// Agent (main entry point)
+export { Agent } from './agent.js';
+// Contracts (types and enums)
+export * from './contracts/index.js';
+// Config
+export { AgentConfigSchema } from './config/config.js';
+// File-based memory system
+export { FileMemorySystem } from './memory/file-memory-system.js';
+// Pluggable stores (for custom implementations)
+export { SQLiteVectorStore } from './knowledge/sqlite-vector-store.js';
+export { SQLiteConversationStore } from './storage/sqlite-conversation-store.js';
+export { SQLiteDatabase } from './storage/sqlite-database.js';
+// Builtin tools
+export { builtinTools } from './tools/builtin/index.js';
+export { createGlobTool, createGrepTool, createFileReadTool, createFileWriteTool, createFileEditTool, createBashTool, createWebFetchTool, createAskUserTool, } from './tools/builtin/index.js';
+// SQL query tools
+export { createSqlTools } from './tools/sql/index.js';
+// JSON Schema → Zod
+export { jsonSchemaToZod } from './tools/json-schema-to-zod.js';
+// MCP
+export { MCPAdapter } from './tools/mcp-adapter.js';
+// Skills
+export { SkillManager } from './skills/skill-manager.js';
+export { createSkillTool, SKILL_TOOL_NAME } from './tools/skill-tool.js';
+export { scanSkillFiles, loadSkillFile, parseSkillFrontmatter } from './skills/skill-loader.js';
+export { substituteArgs } from './skills/skill-args.js';
+export { matchGlob, matchAnyGlob } from './skills/skill-glob.js';
+// Turn-end hooks
+export { runTurnEndHooks } from './core/turn-end-hooks.js';
+// Prompt builders
+export { buildToolUsagePrompt, buildEnvironmentPrompt } from './core/prompt-builders.js';
+// Message normalization
+export { normalizeMessagesForAPI } from './core/message-normalize.js';
+// Prompt cache
+export { PromptSectionCache } from './core/prompt-cache.js';
+// Context analysis
+export { analyzeContext } from './core/context-analysis.js';
+// Model utilities
+export { getModelContextWindow } from './utils/model-context.js';
+// Utils
+export { createLogger } from './utils/logger.js';
+export { LRUCache } from './utils/cache.js';
+export { retry } from './utils/retry.js';
+export { estimateTokens } from './utils/token-counter.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,2BAA2B;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,8BAA8B;AAC9B,cAAc,sBAAsB,CAAC;AAErC,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIlE,gDAAgD;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EACL,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EACvE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,GAC1E,MAAM,0BAA0B,CAAC;AAGlC,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM;AACN,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEjE,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGzF,wBAAwB;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,kBAAkB;AAClB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/knowledge/chunking.d.ts

@@ -0,0 +1,9 @@
+export interface ChunkingOptions {
+    chunkSize: number;
+    chunkOverlap: number;
+}
+/**
+ * Splits text into overlapping chunks using recursive character splitting.
+ */
+export declare function chunkText(text: string, options: ChunkingOptions): string[];
+//# sourceMappingURL=chunking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../../src/knowledge/chunking.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAO1E"}

package/dist/knowledge/chunking.js

@@ -0,0 +1,49 @@
+/**
+ * Splits text into overlapping chunks using recursive character splitting.
+ */
+export function chunkText(text, options) {
+    const { chunkSize, chunkOverlap } = options;
+    if (!text || chunkSize <= 0)
+        return [];
+    if (text.length <= chunkSize)
+        return [text];
+    const separators = ['\n\n', '\n', '. ', ' ', ''];
+    return recursiveSplit(text, separators, chunkSize, chunkOverlap);
+}
+function recursiveSplit(text, separators, chunkSize, overlap) {
+    const chunks = [];
+    const separator = separators.find(s => s === '' || text.includes(s)) ?? '';
+    const parts = separator ? text.split(separator) : [...text];
+    let current = '';
+    for (const part of parts) {
+        const candidate = current ? current + separator + part : part;
+        if (candidate.length > chunkSize && current) {
+            chunks.push(current.trim());
+            // Overlap: keep tail of current chunk
+            const overlapText = current.slice(-overlap);
+            current = overlapText ? overlapText + separator + part : part;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current.trim()) {
+        chunks.push(current.trim());
+    }
+    // If any chunk is still too large, split with next separator
+    if (separators.length > 1) {
+        const nextSeparators = separators.slice(1);
+        const refined = [];
+        for (const chunk of chunks) {
+            if (chunk.length > chunkSize) {
+                refined.push(...recursiveSplit(chunk, nextSeparators, chunkSize, overlap));
+            }
+            else {
+                refined.push(chunk);
+            }
+        }
+        return refined;
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunking.js.map

package/dist/knowledge/chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.js","sourceRoot":"","sources":["../../src/knowledge/chunking.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAwB;IAC9D,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAC5C,IAAI,CAAC,IAAI,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,UAAoB,EAAE,SAAiB,EAAE,OAAe;IAC5F,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE3E,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAE9D,IAAI,SAAS,CAAC,MAAM,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5B,sCAAsC;YACtC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5C,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,6DAA6D;IAC7D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/knowledge/embedding-service.d.ts

@@ -0,0 +1,16 @@
+import type { OpenRouterClient } from '../llm/openrouter-client.js';
+/**
+ * Generates embeddings via OpenRouter with LRU caching.
+ */
+export declare class EmbeddingService {
+    private readonly client;
+    private readonly cache;
+    private readonly model?;
+    constructor(client: OpenRouterClient, options?: {
+        model?: string;
+        cacheSize?: number;
+    });
+    embed(texts: string[]): Promise<number[][]>;
+    embedSingle(text: string): Promise<Float32Array>;
+}
+//# sourceMappingURL=embedding-service.d.ts.map

package/dist/knowledge/embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.d.ts","sourceRoot":"","sources":["../../src/knowledge/embedding-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;gBAEpB,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAMhF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IA2B3C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAIvD"}

package/dist/knowledge/embedding-service.js

@@ -0,0 +1,43 @@
+import { LRUCache } from '../utils/cache.js';
+/**
+ * Generates embeddings via OpenRouter with LRU caching.
+ */
+export class EmbeddingService {
+    client;
+    cache;
+    model;
+    constructor(client, options) {
+        this.client = client;
+        this.model = options?.model;
+        this.cache = new LRUCache({ maxSize: options?.cacheSize ?? 10_000, ttl: 3_600_000 });
+    }
+    async embed(texts) {
+        const results = new Array(texts.length);
+        const uncached = [];
+        // Check cache
+        for (let i = 0; i < texts.length; i++) {
+            const cached = this.cache.get(texts[i]);
+            if (cached) {
+                results[i] = cached;
+            }
+            else {
+                uncached.push({ index: i, text: texts[i] });
+            }
+        }
+        // Fetch uncached
+        if (uncached.length > 0) {
+            const embeddings = await this.client.embed(uncached.map(u => u.text), this.model);
+            for (let i = 0; i < uncached.length; i++) {
+                const entry = uncached[i];
+                results[entry.index] = embeddings[i];
+                this.cache.set(entry.text, embeddings[i]);
+            }
+        }
+        return results;
+    }
+    async embedSingle(text) {
+        const [result] = await this.embed([text]);
+        return new Float32Array(result);
+    }
+}
+//# sourceMappingURL=embedding-service.js.map

package/dist/knowledge/embedding-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.js","sourceRoot":"","sources":["../../src/knowledge/embedding-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACV,MAAM,CAAmB;IACzB,KAAK,CAA6B;IAClC,KAAK,CAAU;IAEhC,YAAY,MAAwB,EAAE,OAAgD;QACpF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,IAAI,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,MAAM,OAAO,GAAe,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,QAAQ,GAA2C,EAAE,CAAC;QAE5D,cAAc;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACzC,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAClF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;gBACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,OAAO,IAAI,YAAY,CAAC,MAAO,CAAC,CAAC;IACnC,CAAC;CACF"}

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

@@ -0,0 +1,33 @@
+import type { VectorStore } from '../contracts/entities/stores.js';
+import type { KnowledgeDocument, RetrievedKnowledge } from '../contracts/entities/knowledge.js';
+import type { EmbeddingService } from './embedding-service.js';
+export interface KnowledgeManagerConfig {
+    store: VectorStore;
+    embeddingService: EmbeddingService;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    topK?: number;
+    minScore?: number;
+}
+/**
+ * Manages knowledge ingestion (chunking + embedding) and RAG search.
+ */
+export declare class KnowledgeManager {
+    private readonly store;
+    private readonly embeddingService;
+    private readonly chunkSize;
+    private readonly chunkOverlap;
+    private readonly topK;
+    private readonly minScore;
+    private readonly searchCache;
+    constructor(config: KnowledgeManagerConfig);
+    /**
+     * Ingests a document: chunks it, generates embeddings, and persists.
+     */
+    ingest(document: KnowledgeDocument): Promise<number>;
+    /**
+     * Searches knowledge by semantic similarity.
+     */
+    search(query: string): Promise<RetrievedKnowledge[]>;
+}
+//# sourceMappingURL=knowledge-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-manager.d.ts","sourceRoot":"","sources":["../../src/knowledge/knowledge-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAkB,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;gBAEzD,MAAM,EAAE,sBAAsB;IAU1C;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB1D;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAY3D"}

package/dist/knowledge/knowledge-manager.js

@@ -0,0 +1,62 @@
+import { randomUUID } from 'node:crypto';
+import { chunkText } from './chunking.js';
+import { LRUCache } from '../utils/cache.js';
+/**
+ * Manages knowledge ingestion (chunking + embedding) and RAG search.
+ */
+export class KnowledgeManager {
+    store;
+    embeddingService;
+    chunkSize;
+    chunkOverlap;
+    topK;
+    minScore;
+    searchCache;
+    constructor(config) {
+        this.store = config.store;
+        this.embeddingService = config.embeddingService;
+        this.chunkSize = config.chunkSize ?? 512;
+        this.chunkOverlap = config.chunkOverlap ?? 64;
+        this.topK = config.topK ?? 5;
+        this.minScore = config.minScore ?? 0.3;
+        this.searchCache = new LRUCache({ maxSize: 100, ttl: 300_000 });
+    }
+    /**
+     * Ingests a document: chunks it, generates embeddings, and persists.
+     */
+    async ingest(document) {
+        const chunks = chunkText(document.content, {
+            chunkSize: this.chunkSize,
+            chunkOverlap: this.chunkOverlap,
+        });
+        if (chunks.length === 0)
+            return 0;
+        const embeddings = await this.embeddingService.embed(chunks);
+        for (let i = 0; i < chunks.length; i++) {
+            const chunk = {
+                id: randomUUID(),
+                content: chunks[i],
+                embedding: new Float32Array(embeddings[i]),
+                metadata: { ...document.metadata, chunkIndex: i, totalChunks: chunks.length },
+                createdAt: Date.now(),
+            };
+            this.store.upsert(chunk);
+        }
+        return chunks.length;
+    }
+    /**
+     * Searches knowledge by semantic similarity.
+     */
+    async search(query) {
+        // Check cache
+        const cached = this.searchCache.get(query);
+        if (cached)
+            return cached;
+        const queryEmbedding = await this.embeddingService.embedSingle(query);
+        const results = this.store.search(queryEmbedding, this.topK)
+            .filter(r => r.score >= this.minScore);
+        this.searchCache.set(query, results);
+        return results;
+    }
+}
+//# sourceMappingURL=knowledge-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-manager.js","sourceRoot":"","sources":["../../src/knowledge/knowledge-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAW7C;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,CAAc;IACnB,gBAAgB,CAAmB;IACnC,SAAS,CAAS;IAClB,YAAY,CAAS;IACrB,IAAI,CAAS;IACb,QAAQ,CAAS;IACjB,WAAW,CAAyC;IAErE,YAAY,MAA8B;QACxC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,QAAQ,CAA+B,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,QAA2B;QACtC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAElC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAmB;gBAC5B,EAAE,EAAE,UAAU,EAAE;gBAChB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAE;gBACnB,SAAS,EAAE,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;gBAC3C,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;gBAC7E,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,cAAc;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC;aACzD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEzC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/knowledge/sqlite-vector-store.d.ts

@@ -0,0 +1,16 @@
+import type { VectorStore } from '../contracts/entities/stores.js';
+import type { KnowledgeChunk, RetrievedKnowledge } from '../contracts/entities/knowledge.js';
+import type { SQLiteDatabase } from '../storage/sqlite-database.js';
+/**
+ * SQLite implementation of VectorStore with brute-force cosine similarity.
+ */
+export declare class SQLiteVectorStore implements VectorStore {
+    private readonly database;
+    constructor(database: SQLiteDatabase);
+    upsert(chunk: KnowledgeChunk): void;
+    search(queryEmbedding: Float32Array, topK: number): RetrievedKnowledge[];
+    delete(id: string): void;
+    listAll(): KnowledgeChunk[];
+    deleteBySource(sourceId: string): void;
+}
+//# sourceMappingURL=sqlite-vector-store.d.ts.map

package/dist/knowledge/sqlite-vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-vector-store.d.ts","sourceRoot":"","sources":["../../src/knowledge/sqlite-vector-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,QAAQ,EAAE,cAAc;IAIpC,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAanC,MAAM,CAAC,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAiBxE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,OAAO,IAAI,cAAc,EAAE;IAW3B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAGvC"}