@monoes/memory 1.0.0

package/dist/index.js

@@ -0,0 +1,379 @@
+/**
+ * @monomind/memory - V1 Unified Memory System
+ *
+ * Provides a unified memory interface backed by AgentDB with HNSW indexing
+ * for 150x-12,500x faster vector search compared to brute-force approaches.
+ *
+ * @module @monomind/memory
+ *
+ * @example
+ * ```typescript
+ * import { UnifiedMemoryService, query, QueryTemplates } from '@monomind/memory';
+ *
+ * // Initialize the memory service
+ * const memory = new UnifiedMemoryService({
+ *   dimensions: 1536,
+ *   cacheEnabled: true,
+ *   embeddingGenerator: async (text) => embeddings.embed(text),
+ * });
+ *
+ * await memory.initialize();
+ *
+ * // Store entries
+ * await memory.store({
+ *   key: 'auth-patterns',
+ *   content: 'OAuth 2.0 implementation patterns for secure authentication',
+ *   tags: ['auth', 'security', 'patterns'],
+ * });
+ *
+ * // Semantic search
+ * const results = await memory.semanticSearch('user authentication best practices', 5);
+ *
+ * // Query with fluent builder
+ * const entries = await memory.query(
+ *   query()
+ *     .semantic('security vulnerabilities')
+ *     .inNamespace('security')
+ *     .withTags(['critical'])
+ *     .threshold(0.8)
+ *     .limit(10)
+ *     .build()
+ * );
+ * ```
+ */
+// Utility Functions and Constants (runtime values)
+export { generateMemoryId, createDefaultEntry, PERFORMANCE_TARGETS, } from './types.js';
+// ===== Auto Memory Bridge (ADR-048) =====
+export { AutoMemoryBridge, resolveAutoMemoryDir, findGitRoot } from './auto-memory-bridge.js';
+// ===== Learning Bridge =====
+export { LearningBridge } from './learning-bridge.js';
+// ===== RVF Learning Persistence (ADR-057 Phase 6) =====
+export { RvfLearningStore } from './rvf-learning-store.js';
+export { PersistentSonaCoordinator } from './persistent-sona.js';
+// ===== RVF Migration (Bidirectional) =====
+export { RvfMigrator } from './rvf-migration.js';
+// ===== Knowledge Graph =====
+export { MemoryGraph } from './memory-graph.js';
+// ===== Agent-Scoped Memory =====
+export { resolveAgentMemoryDir, createAgentBridge, transferKnowledge, listAgentScopes, } from './agent-memory-scope.js';
+// ===== Controller Registry (ADR-053) =====
+export { ControllerRegistry, INIT_LEVELS } from './controller-registry.js';
+// ===== Core Components =====
+export { AgentDBAdapter } from './agentdb-adapter.js';
+export { AgentDBBackend } from './agentdb-backend.js';
+export { SQLiteBackend } from './sqlite-backend.js';
+export { SqlJsBackend } from './sqljs-backend.js';
+export { HybridBackend } from './hybrid-backend.js';
+export { RvfBackend } from './rvf-backend.js';
+export { DiskAnnBackend } from './diskann-backend.js';
+export { HnswLite, cosineSimilarity } from './hnsw-lite.js';
+export { HNSWIndex } from './hnsw-index.js';
+export { CacheManager, TieredCacheManager } from './cache-manager.js';
+export { QueryBuilder, query, QueryTemplates } from './query-builder.js';
+export { MemoryMigrator, createMigrator, migrateMultipleSources } from './migration.js';
+export { createDatabase, getPlatformInfo, getAvailableProviders } from './database-provider.js';
+// ===== Graph Checkpointing (Task 08) =====
+export { SwarmCheckpointer } from './checkpointer.js';
+// ===== Multi-Tier Memory (Task 09) =====
+export { TierManager } from './tier-manager.js';
+export { ShortTermMemory, EntityMemory, ContextualMemory } from './tiers/index.js';
+// ===== Episodic Memory (Task 11) =====
+export { EpisodicStore } from './episodic-store.js';
+// ===== Per-Agent Knowledge Base (Task 28) =====
+export { chunkDocument, KnowledgeStore, KnowledgeRetriever } from './knowledge/index.js';
+// ===== Unified Memory Service =====
+import { EventEmitter } from 'node:events';
+import { AgentDBAdapter } from './agentdb-adapter.js';
+import { MemoryMigrator } from './migration.js';
+/**
+ * Unified Memory Service
+ *
+ * High-level interface for the V1 memory system that provides:
+ * - Simple API for common operations
+ * - Automatic embedding generation
+ * - Cross-agent memory sharing
+ * - SONA integration for learning
+ * - Event-driven notifications
+ * - Performance monitoring
+ */
+export class UnifiedMemoryService extends EventEmitter {
+    adapter;
+    config;
+    initialized = false;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            dimensions: 1536,
+            cacheEnabled: true,
+            autoEmbed: true,
+            ...config,
+        };
+        this.adapter = new AgentDBAdapter({
+            dimensions: this.config.dimensions,
+            cacheEnabled: this.config.cacheEnabled,
+            cacheSize: this.config.cacheSize,
+            cacheTtl: this.config.cacheTtl,
+            hnswM: this.config.hnswM,
+            hnswEfConstruction: this.config.hnswEfConstruction,
+            defaultNamespace: this.config.defaultNamespace,
+            embeddingGenerator: this.config.embeddingGenerator,
+            persistenceEnabled: this.config.persistenceEnabled,
+            persistencePath: this.config.persistencePath,
+            maxEntries: this.config.maxEntries,
+        });
+        // Forward adapter events
+        this.adapter.on('entry:stored', (data) => this.emit('entry:stored', data));
+        this.adapter.on('entry:updated', (data) => this.emit('entry:updated', data));
+        this.adapter.on('entry:deleted', (data) => this.emit('entry:deleted', data));
+        this.adapter.on('cache:hit', (data) => this.emit('cache:hit', data));
+        this.adapter.on('cache:miss', (data) => this.emit('cache:miss', data));
+        this.adapter.on('index:added', (data) => this.emit('index:added', data));
+    }
+    // ===== Lifecycle =====
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.adapter.initialize();
+        this.initialized = true;
+        this.emit('initialized');
+    }
+    async shutdown() {
+        if (!this.initialized)
+            return;
+        await this.adapter.shutdown();
+        this.initialized = false;
+        this.emit('shutdown');
+    }
+    // ===== IMemoryBackend Implementation =====
+    async store(entry) {
+        return this.adapter.store(entry);
+    }
+    async get(id) {
+        return this.adapter.get(id);
+    }
+    async getByKey(namespace, key) {
+        return this.adapter.getByKey(namespace, key);
+    }
+    async update(id, update) {
+        return this.adapter.update(id, update);
+    }
+    async delete(id) {
+        return this.adapter.delete(id);
+    }
+    async query(query) {
+        return this.adapter.query(query);
+    }
+    async search(embedding, options) {
+        return this.adapter.search(embedding, options);
+    }
+    async bulkInsert(entries) {
+        return this.adapter.bulkInsert(entries);
+    }
+    async bulkDelete(ids) {
+        return this.adapter.bulkDelete(ids);
+    }
+    async count(namespace) {
+        return this.adapter.count(namespace);
+    }
+    async listNamespaces() {
+        return this.adapter.listNamespaces();
+    }
+    async clearNamespace(namespace) {
+        return this.adapter.clearNamespace(namespace);
+    }
+    async getStats() {
+        return this.adapter.getStats();
+    }
+    async healthCheck() {
+        return this.adapter.healthCheck();
+    }
+    // ===== Convenience Methods =====
+    /**
+     * Store an entry from simple input
+     */
+    async storeEntry(input) {
+        return this.adapter.storeEntry(input);
+    }
+    /**
+     * Semantic search by content string
+     */
+    async semanticSearch(content, k = 10, threshold) {
+        return this.adapter.semanticSearch(content, k, threshold);
+    }
+    /**
+     * Find similar entries to a given entry
+     */
+    async findSimilar(id, k = 5) {
+        const entry = await this.get(id);
+        if (!entry || !entry.embedding) {
+            return [];
+        }
+        const results = await this.search(entry.embedding, { k: k + 1 });
+        // Filter out the source entry
+        return results.filter((r) => r.entry.id !== id).slice(0, k);
+    }
+    /**
+     * Get or create an entry
+     */
+    async getOrCreate(namespace, key, creator) {
+        const existing = await this.getByKey(namespace, key);
+        if (existing)
+            return existing;
+        const input = await creator();
+        return this.storeEntry({ ...input, namespace, key });
+    }
+    /**
+     * Append content to an existing entry
+     */
+    async appendContent(id, content) {
+        const entry = await this.get(id);
+        if (!entry)
+            return null;
+        return this.update(id, {
+            content: entry.content + '\n' + content,
+        });
+    }
+    /**
+     * Add tags to an existing entry
+     */
+    async addTags(id, tags) {
+        const entry = await this.get(id);
+        if (!entry)
+            return null;
+        const newTags = [...new Set([...entry.tags, ...tags])];
+        return this.update(id, { tags: newTags });
+    }
+    /**
+     * Remove tags from an existing entry
+     */
+    async removeTags(id, tags) {
+        const entry = await this.get(id);
+        if (!entry)
+            return null;
+        const newTags = entry.tags.filter((t) => !tags.includes(t));
+        return this.update(id, { tags: newTags });
+    }
+    // ===== Migration =====
+    /**
+     * Migrate from a legacy memory source
+     */
+    async migrateFrom(source, sourcePath, options = {}) {
+        const migrator = new MemoryMigrator(this.adapter, { source, sourcePath, ...options }, this.config.embeddingGenerator);
+        // Forward migration events
+        migrator.on('migration:started', (data) => this.emit('migration:started', data));
+        migrator.on('migration:progress', (data) => this.emit('migration:progress', data));
+        migrator.on('migration:completed', (data) => this.emit('migration:completed', data));
+        migrator.on('migration:failed', (data) => this.emit('migration:failed', data));
+        migrator.on('migration:error', (data) => this.emit('migration:error', data));
+        migrator.on('migration:warning', (data) => this.emit('migration:warning', data));
+        return migrator.migrate();
+    }
+    // ===== Cross-Agent Memory Sharing =====
+    /**
+     * Share an entry with another agent
+     */
+    async shareWith(id, agentId) {
+        const entry = await this.get(id);
+        if (!entry)
+            return null;
+        const sharedWith = entry.metadata.sharedWith || [];
+        if (!sharedWith.includes(agentId)) {
+            sharedWith.push(agentId);
+        }
+        return this.update(id, {
+            metadata: { ...entry.metadata, sharedWith },
+        });
+    }
+    /**
+     * Get entries shared with a specific agent
+     */
+    async getSharedWith(agentId) {
+        const all = await this.query({ type: 'hybrid', limit: 10000 });
+        return all.filter((entry) => {
+            const sharedWith = entry.metadata.sharedWith || [];
+            return sharedWith.includes(agentId);
+        });
+    }
+    // ===== Utility =====
+    /**
+     * Get the underlying adapter for advanced operations
+     */
+    getAdapter() {
+        return this.adapter;
+    }
+    /**
+     * Check if the service is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+}
+// ===== Factory Functions =====
+/**
+ * Create a simple in-memory service (for testing)
+ */
+export function createInMemoryService() {
+    return new UnifiedMemoryService({
+        persistenceEnabled: false,
+        cacheEnabled: true,
+    });
+}
+/**
+ * Create a persistent memory service
+ */
+export function createPersistentService(path) {
+    return new UnifiedMemoryService({
+        persistenceEnabled: true,
+        persistencePath: path,
+        cacheEnabled: true,
+    });
+}
+/**
+ * Create a memory service with embedding support
+ */
+export function createEmbeddingService(embeddingGenerator, dimensions = 1536) {
+    return new UnifiedMemoryService({
+        embeddingGenerator,
+        dimensions,
+        autoEmbed: true,
+        cacheEnabled: true,
+    });
+}
+/**
+ * Create a hybrid memory service (SQLite + AgentDB)
+ * This is the DEFAULT recommended configuration per ADR-009
+ *
+ * @example
+ * ```typescript
+ * const memory = createHybridService('./data/memory.db', embeddingFn);
+ * await memory.initialize();
+ *
+ * // Structured queries go to SQLite
+ * const user = await memory.getByKey('users', 'john@example.com');
+ *
+ * // Semantic queries go to AgentDB
+ * const similar = await memory.semanticSearch('authentication patterns', 10);
+ * ```
+ */
+export function createHybridService(databasePath, embeddingGenerator, dimensions = 1536) {
+    return new UnifiedMemoryService({
+        embeddingGenerator,
+        dimensions,
+        autoEmbed: true,
+        cacheEnabled: true,
+        // Note: This would require extending UnifiedMemoryService to support HybridBackend
+        // For now, this creates an AgentDB service with persistence
+        persistenceEnabled: true,
+        persistencePath: databasePath,
+    });
+}
+// ===== Prompt Version Management (Task 24) =====
+export { PromptVersionStore } from './prompt-version-store.js';
+export { DEFAULT_EXTRACTION_CONFIG } from './procedural/index.js';
+export { ActionRecordStore } from './procedural/index.js';
+export { ActionSequenceExtractor } from './procedural/index.js';
+export { LearnedSkillSerializer } from './procedural/index.js';
+export { SkillRegistry } from './procedural/index.js';
+// Default export
+export default UnifiedMemoryService;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Document chunker for per-agent knowledge base.
+ * Splits documents into overlapping text chunks, preferring paragraph boundaries.
+ *
+ * @module @monomind/memory/knowledge/document-chunker
+ */
+export interface TextChunk {
+    chunkId: string;
+    docId: string;
+    text: string;
+    startChar: number;
+    endChar: number;
+    chunkIndex: number;
+}
+/**
+ * Chunk a document into overlapping text segments.
+ *
+ * Tries to break at paragraph boundaries (\n\n) within 20% of the nominal
+ * chunk end to produce more natural splits.
+ */
+export declare function chunkDocument(docId: string, text: string, chunkSizeChars?: number, overlapChars?: number): TextChunk[];
+//# sourceMappingURL=document-chunker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-chunker.d.ts","sourceRoot":"","sources":["../../src/knowledge/document-chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,cAAc,GAAE,MAA2B,EAC3C,YAAY,GAAE,MAAwB,GACrC,SAAS,EAAE,CA4Cb"}

package/dist/knowledge/document-chunker.js

@@ -0,0 +1,52 @@
+/**
+ * Document chunker for per-agent knowledge base.
+ * Splits documents into overlapping text chunks, preferring paragraph boundaries.
+ *
+ * @module @monomind/memory/knowledge/document-chunker
+ */
+const DEFAULT_CHUNK_SIZE = 3200;
+const DEFAULT_OVERLAP = 400;
+/**
+ * Chunk a document into overlapping text segments.
+ *
+ * Tries to break at paragraph boundaries (\n\n) within 20% of the nominal
+ * chunk end to produce more natural splits.
+ */
+export function chunkDocument(docId, text, chunkSizeChars = DEFAULT_CHUNK_SIZE, overlapChars = DEFAULT_OVERLAP) {
+    if (text.length === 0) {
+        return [];
+    }
+    const chunks = [];
+    let startChar = 0;
+    let chunkIndex = 0;
+    while (startChar < text.length) {
+        let endChar = Math.min(startChar + chunkSizeChars, text.length);
+        // If we haven't reached the end, try to snap to a paragraph boundary
+        if (endChar < text.length) {
+            const windowStart = Math.max(startChar, endChar - Math.floor(chunkSizeChars * 0.2));
+            const window = text.slice(windowStart, endChar);
+            const lastParagraph = window.lastIndexOf('\n\n');
+            if (lastParagraph !== -1) {
+                // Break right after the paragraph boundary
+                endChar = windowStart + lastParagraph + 2;
+            }
+        }
+        chunks.push({
+            chunkId: `${docId}:${chunkIndex}`,
+            docId,
+            text: text.slice(startChar, endChar),
+            startChar,
+            endChar,
+            chunkIndex,
+        });
+        chunkIndex++;
+        // If this chunk reached the end of the document, stop
+        if (endChar >= text.length)
+            break;
+        // Advance by (endChar - startChar - overlap), but at least 1 char to avoid infinite loops
+        const advance = Math.max(1, endChar - startChar - overlapChars);
+        startChar = startChar + advance;
+    }
+    return chunks;
+}
+//# sourceMappingURL=document-chunker.js.map

package/dist/knowledge/document-chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-chunker.js","sourceRoot":"","sources":["../../src/knowledge/document-chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,IAAY,EACZ,iBAAyB,kBAAkB,EAC3C,eAAuB,eAAe;IAEtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhE,qEAAqE;QACrE,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAEjD,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,2CAA2C;gBAC3C,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,GAAG,KAAK,IAAI,UAAU,EAAE;YACjC,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;YACpC,SAAS;YACT,OAAO;YACP,UAAU;SACX,CAAC,CAAC;QAEH,UAAU,EAAE,CAAC;QAEb,sDAAsD;QACtD,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM;QAElC,0FAA0F;QAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC;QAChE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/knowledge/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Per-Agent Knowledge Base module.
+ *
+ * @module @monomind/memory/knowledge
+ */
+export { chunkDocument } from './document-chunker.js';
+export type { TextChunk } from './document-chunker.js';
+export { KnowledgeStore } from './knowledge-store.js';
+export type { MetadataRecord, ChunkRecord } from './knowledge-store.js';
+export { KnowledgeRetriever } from './knowledge-retriever.js';
+export type { KnowledgeExcerpt, RetrievalResult, SearchFn, } from './knowledge-retriever.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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,QAAQ,GACT,MAAM,0BAA0B,CAAC"}

package/dist/knowledge/index.js

@@ -0,0 +1,9 @@
+/**
+ * Per-Agent Knowledge Base module.
+ *
+ * @module @monomind/memory/knowledge
+ */
+export { chunkDocument } from './document-chunker.js';
+export { KnowledgeStore } from './knowledge-store.js';
+export { KnowledgeRetriever } from './knowledge-retriever.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;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * Knowledge retriever for per-agent knowledge base.
+ *
+ * Queries shared and agent-private partitions, deduplicates, and formats
+ * excerpts as context for downstream LLM consumption.
+ *
+ * @module @monomind/memory/knowledge/knowledge-retriever
+ */
+import type { KnowledgeStore } from './knowledge-store.js';
+/** A single excerpt returned from retrieval. */
+export interface KnowledgeExcerpt {
+    chunkId: string;
+    filePath: string;
+    scope: string;
+    text: string;
+    similarity: number;
+    chunkIndex: number;
+}
+/** Combined retrieval result with formatted context. */
+export interface RetrievalResult {
+    excerpts: KnowledgeExcerpt[];
+    formattedContext: string;
+}
+/**
+ * Signature for the vector search function injected into the retriever.
+ */
+export type SearchFn = (query: string, options: {
+    namespace: string;
+    limit: number;
+    minScore: number;
+}) => Promise<Array<{
+    key: string;
+    value: string;
+    score: number;
+    metadata: Record<string, unknown>;
+}>>;
+export declare class KnowledgeRetriever {
+    private readonly searchFn;
+    private readonly store;
+    constructor(searchFn: SearchFn, store: KnowledgeStore);
+    /**
+     * Retrieve relevant knowledge excerpts for a task, merging shared and
+     * agent-private partitions.
+     */
+    retrieveForTask(agentSlug: string, query: string, maxChunks?: number): Promise<RetrievalResult>;
+    private formatContext;
+}
+//# sourceMappingURL=knowledge-retriever.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-retriever.d.ts","sourceRoot":"","sources":["../../src/knowledge/knowledge-retriever.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,KAC5D,OAAO,CACV,KAAK,CAAC;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC,CACH,CAAC;AAKF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAE3B,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc;IAKrD;;;OAGG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,eAAe,CAAC;IAyD3B,OAAO,CAAC,aAAa;CAgBtB"}

package/dist/knowledge/knowledge-retriever.js

@@ -0,0 +1,80 @@
+/**
+ * Knowledge retriever for per-agent knowledge base.
+ *
+ * Queries shared and agent-private partitions, deduplicates, and formats
+ * excerpts as context for downstream LLM consumption.
+ *
+ * @module @monomind/memory/knowledge/knowledge-retriever
+ */
+const DEFAULT_MAX_CHUNKS = 10;
+const DEFAULT_MIN_SCORE = 0.3;
+export class KnowledgeRetriever {
+    searchFn;
+    store;
+    constructor(searchFn, store) {
+        this.searchFn = searchFn;
+        this.store = store;
+    }
+    /**
+     * Retrieve relevant knowledge excerpts for a task, merging shared and
+     * agent-private partitions.
+     */
+    async retrieveForTask(agentSlug, query, maxChunks = DEFAULT_MAX_CHUNKS) {
+        const halfLimit = Math.max(1, Math.ceil(maxChunks / 2));
+        const sharedNamespace = this.store.getPartitionNamespace('shared');
+        const privateNamespace = this.store.getPartitionNamespace(agentSlug);
+        // Query both partitions concurrently
+        const [sharedResults, privateResults] = await Promise.all([
+            this.searchFn(query, {
+                namespace: sharedNamespace,
+                limit: halfLimit,
+                minScore: DEFAULT_MIN_SCORE,
+            }),
+            this.searchFn(query, {
+                namespace: privateNamespace,
+                limit: halfLimit,
+                minScore: DEFAULT_MIN_SCORE,
+            }),
+        ]);
+        // Map raw results to excerpts
+        const toExcerpt = (r, scope) => ({
+            chunkId: r.key,
+            filePath: r.metadata.filePath ?? '',
+            scope,
+            text: r.value,
+            similarity: r.score,
+            chunkIndex: r.metadata.chunkIndex ?? 0,
+        });
+        const allExcerpts = [
+            ...sharedResults.map((r) => toExcerpt(r, 'shared')),
+            ...privateResults.map((r) => toExcerpt(r, agentSlug)),
+        ];
+        // Deduplicate by chunkId (keep higher similarity)
+        const seen = new Map();
+        for (const ex of allExcerpts) {
+            const existing = seen.get(ex.chunkId);
+            if (!existing || ex.similarity > existing.similarity) {
+                seen.set(ex.chunkId, ex);
+            }
+        }
+        // Sort descending by similarity, then cap at maxChunks
+        const excerpts = [...seen.values()]
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, maxChunks);
+        const formattedContext = this.formatContext(excerpts);
+        return { excerpts, formattedContext };
+    }
+    formatContext(excerpts) {
+        if (excerpts.length === 0) {
+            return '';
+        }
+        const lines = ['## Relevant Knowledge Base Excerpts', ''];
+        excerpts.forEach((ex, i) => {
+            lines.push(`${i + 1}. **[${ex.scope}] ${ex.filePath}** (similarity: ${ex.similarity.toFixed(2)})`);
+            lines.push(ex.text);
+            lines.push('');
+        });
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=knowledge-retriever.js.map

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

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