context-gatekeeper 0.3.0

package/dist/services/multi-agent-sharing.js

@@ -0,0 +1,278 @@
+/**
+ * Multi-Agent Sharing Service
+ * Enables sharing memories and sessions across agents
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { getDatabase, query, run } from '../utils/db.js';
+import { DatabaseError } from '../utils/errors.js';
+import { getMemory } from '../schema/memory.js';
+export function initMultiAgentSharing() {
+    const db = getDatabase();
+    try {
+        // Shared memories table
+        db.run(`
+      CREATE TABLE IF NOT EXISTS shared_memories (
+        id TEXT PRIMARY KEY,
+        memory_id TEXT NOT NULL,
+        shared_by_agent_id TEXT NOT NULL,
+        shared_to_agent_id TEXT NOT NULL,
+        shared_to_project_id TEXT NOT NULL,
+        permission TEXT NOT NULL CHECK (permission IN ('read', 'read_write', 'admin')),
+        shared_at TEXT NOT NULL DEFAULT (datetime('now')),
+        expires_at TEXT,
+        FOREIGN KEY (memory_id) REFERENCES memories(id)
+      )
+    `);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_shared_memories_to_agent ON shared_memories(shared_to_agent_id)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_shared_memories_to_project ON shared_memories(shared_to_project_id)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_shared_memories_memory ON shared_memories(memory_id)`);
+        // Share tokens table (for one-time or limited-use shares)
+        db.run(`
+      CREATE TABLE IF NOT EXISTS share_tokens (
+        token TEXT PRIMARY KEY,
+        memory_id TEXT NOT NULL,
+        shared_by_agent_id TEXT NOT NULL,
+        permission TEXT NOT NULL CHECK (permission IN ('read', 'read_write')),
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        expires_at TEXT,
+        use_count INTEGER NOT NULL DEFAULT 0,
+        max_uses INTEGER,
+        FOREIGN KEY (memory_id) REFERENCES memories(id)
+      )
+    `);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_share_tokens_memory ON share_tokens(memory_id)`);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to initialize multi-agent sharing', error);
+    }
+}
+// ============ Direct Sharing ============
+/**
+ * Share a memory with specific agents
+ */
+export function shareMemoryToAgents(memoryId, sharedByAgentId, targetAgentIds, targetProjectId, permission = 'read', expiresAt) {
+    const records = [];
+    for (const agentId of targetAgentIds) {
+        const record = shareMemory(memoryId, sharedByAgentId, agentId, targetProjectId, permission, expiresAt);
+        records.push(record);
+    }
+    return records;
+}
+/**
+ * Share a memory to a project (all agents in project)
+ */
+export function shareMemoryToProject(memoryId, sharedByAgentId, targetProjectId, permission = 'read', expiresAt) {
+    // Use '*' as the agent ID to indicate project-wide sharing
+    return shareMemory(memoryId, sharedByAgentId, '*', targetProjectId, permission, expiresAt);
+}
+/**
+ * Internal share memory function
+ */
+function shareMemory(memoryId, sharedByAgentId, sharedToAgentId, sharedToProjectId, permission, expiresAt) {
+    const id = uuidv4();
+    const now = new Date().toISOString();
+    try {
+        run(`INSERT INTO shared_memories (id, memory_id, shared_by_agent_id, shared_to_agent_id, shared_to_project_id, permission, shared_at, expires_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
+            id,
+            memoryId,
+            sharedByAgentId,
+            sharedToAgentId,
+            sharedToProjectId,
+            permission,
+            now,
+            expiresAt?.toISOString() || null
+        ]);
+        return {
+            id,
+            memoryId,
+            sharedByAgentId,
+            sharedToAgentId,
+            sharedToProjectId,
+            permission,
+            sharedAt: new Date(now),
+            expiresAt: expiresAt || null
+        };
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to share memory', error);
+    }
+}
+/**
+ * Get shared memories for an agent
+ */
+export function getSharedMemoriesForAgent(agentId, projectId, includeExpired = false) {
+    try {
+        let sql = `
+      SELECT s.*, m.content, m.priority, m.project_tags, m.anchored, m.access_count, m.version, m.updated_by, m.parent_id, m.lineage, m.created_at as memory_created_at, m.updated_at as memory_updated_at, m.expires_at as memory_expires_at, m.deleted
+      FROM shared_memories s
+      JOIN memories m ON s.memory_id = m.id
+      WHERE (s.shared_to_agent_id = ? OR s.shared_to_agent_id = '*')
+      AND m.deleted = 0
+    `;
+        const params = [agentId];
+        if (projectId) {
+            sql += ' AND s.shared_to_project_id = ?';
+            params.push(projectId);
+        }
+        if (!includeExpired) {
+            sql += ' AND (s.expires_at IS NULL OR datetime(s.expires_at) > datetime(?))';
+            params.push(new Date().toISOString());
+        }
+        sql += ' ORDER BY s.shared_at DESC';
+        const rows = query(sql, params);
+        return rows.map(row => ({
+            id: row.id,
+            memoryId: row.memory_id,
+            sharedByAgentId: row.shared_by_agent_id,
+            sharedToAgentId: row.shared_to_agent_id,
+            sharedToProjectId: row.shared_to_project_id,
+            permission: row.permission,
+            sharedAt: new Date(row.shared_at),
+            expiresAt: row.expires_at ? new Date(row.expires_at) : null,
+            memory: mapMemoryRow(row)
+        }));
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to get shared memories', error);
+    }
+}
+/**
+ * Revoke a shared memory
+ */
+export function revokeSharedMemory(shareId) {
+    try {
+        run(`DELETE FROM shared_memories WHERE id = ?`, [shareId]);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to revoke shared memory', error);
+    }
+}
+/**
+ * Revoke all shares of a memory
+ */
+export function revokeAllSharesForMemory(memoryId) {
+    try {
+        const result = run(`DELETE FROM shared_memories WHERE memory_id = ?`, [memoryId]);
+        return result.changes;
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to revoke shared memories', error);
+    }
+}
+// ============ Token-Based Sharing ============
+/**
+ * Create a share token for a memory
+ */
+export function createShareToken(memoryId, sharedByAgentId, permission = 'read', options = {}) {
+    const token = uuidv4();
+    const now = new Date().toISOString();
+    try {
+        run(`INSERT INTO share_tokens (token, memory_id, shared_by_agent_id, permission, created_at, expires_at, max_uses)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            token,
+            memoryId,
+            sharedByAgentId,
+            permission,
+            now,
+            options.expiresAt?.toISOString() || null,
+            options.maxUses || null
+        ]);
+        return {
+            token,
+            memoryId,
+            sharedByAgentId,
+            permission,
+            createdAt: new Date(now),
+            expiresAt: options.expiresAt || null,
+            useCount: 0,
+            maxUses: options.maxUses || null
+        };
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to create share token', error);
+    }
+}
+/**
+ * Redeem a share token
+ */
+export function redeemShareToken(token) {
+    try {
+        // Get token
+        const tokenRows = query(`SELECT * FROM share_tokens WHERE token = ?`, [token]);
+        if (tokenRows.length === 0) {
+            return null;
+        }
+        const tokenRow = tokenRows[0];
+        const now = new Date();
+        // Check expiration
+        if (tokenRow.expires_at && new Date(tokenRow.expires_at) < now) {
+            return null;
+        }
+        // Check max uses
+        if (tokenRow.max_uses !== null && tokenRow.use_count >= tokenRow.max_uses) {
+            return null;
+        }
+        // Get memory
+        const memory = getMemory(tokenRow.memory_id);
+        if (!memory) {
+            return null;
+        }
+        // Increment use count
+        run(`UPDATE share_tokens SET use_count = use_count + 1 WHERE token = ?`, [token]);
+        return {
+            memory,
+            permission: tokenRow.permission
+        };
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to redeem share token', error);
+    }
+}
+/**
+ * Delete expired tokens
+ */
+export function cleanupExpiredTokens() {
+    try {
+        const result = run(`DELETE FROM share_tokens WHERE expires_at IS NOT NULL AND datetime(expires_at) < datetime(?)`, [new Date().toISOString()]);
+        return result.changes;
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to cleanup expired tokens', error);
+    }
+}
+function mapMemoryRow(row) {
+    return {
+        id: row.id,
+        userId: row.user_id,
+        agentId: row.agent_id,
+        projectId: row.project_id,
+        content: row.content,
+        priority: row.priority,
+        projectTags: JSON.parse(row.project_tags || '[]'),
+        anchored: row.anchored === 1,
+        accessCount: row.access_count,
+        version: row.version,
+        updatedBy: row.updated_by,
+        parentId: row.parent_id,
+        lineage: JSON.parse(row.lineage || '[]'),
+        createdAt: new Date(row.memory_created_at || row.created_at),
+        updatedAt: new Date(row.memory_updated_at || row.updated_at),
+        expiresAt: row.memory_expires_at ? new Date(row.memory_expires_at) : (row.expires_at ? new Date(row.expires_at) : null),
+        deleted: row.deleted === 1
+    };
+}
+// ============ Service Wrapper ============
+export function getMultiAgentSharingService() {
+    return {
+        shareMemoryToAgents,
+        shareMemoryToProject,
+        getSharedMemoriesForAgent,
+        revokeSharedMemory,
+        revokeAllSharesForMemory,
+        createShareToken,
+        redeemShareToken,
+        cleanupExpiredTokens
+    };
+}
+//# sourceMappingURL=multi-agent-sharing.js.map

package/dist/services/multi-agent-sharing.js.map

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

package/dist/services/reranker.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Reranker Service
+ * Implements two-stage retrieval: recall candidates, then rerank with scoring
+ */
+import { Memory, IsolationContext } from '../models/types.js';
+export interface RerankConfig {
+    initialRecallLimit: number;
+    finalLimit: number;
+    rerankWeight: {
+        semantic: number;
+        keyword: number;
+        recency: number;
+        importance: number;
+    };
+    importanceThreshold: number;
+}
+export interface RerankedResult {
+    memory: Memory;
+    originalScore: number;
+    rerankedScore: number;
+    rerankFactors: {
+        semanticScore: number;
+        keywordScore: number;
+        recencyScore: number;
+        importanceScore: number;
+    };
+}
+export interface RerankedSearchResult {
+    results: RerankedResult[];
+    totalCandidates: number;
+    searchMode: string;
+}
+declare class RerankerService {
+    private config;
+    constructor(config?: Partial<RerankConfig>);
+    /**
+     * Two-stage retrieval with reranking
+     */
+    search(query: string, isolation?: IsolationContext, projectTags?: string[], mode?: 'semantic' | 'keyword' | 'hybrid'): Promise<RerankedSearchResult>;
+    /**
+     * Stage 1: Recall candidates using multiple strategies
+     */
+    private recallCandidates;
+    /**
+     * Stage 2: Rerank candidates using multiple signals
+     */
+    private rerank;
+    /**
+     * Compute individual reranking factors
+     */
+    private computeRerankFactors;
+    /**
+     * Compute semantic similarity score
+     */
+    private computeSemanticScore;
+    /**
+     * Compute keyword match score
+     */
+    private computeKeywordScore;
+    /**
+     * Compute recency score (exponential decay)
+     */
+    private computeRecencyScore;
+    /**
+     * Compute importance score
+     */
+    private computeImportanceScore;
+    /**
+     * Compute final score from factors
+     */
+    private computeFinalScore;
+    /**
+     * Filter results by importance threshold
+     */
+    filterByImportance(results: RerankedResult[]): RerankedResult[];
+    /**
+     * Get configuration
+     */
+    getConfig(): RerankConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<RerankConfig>): void;
+}
+export declare function getRerankerService(config?: Partial<RerankConfig>): RerankerService;
+export declare function resetRerankerService(): void;
+export {};
+//# sourceMappingURL=reranker.d.ts.map

package/dist/services/reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../../src/services/reranker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAK9D,MAAM,WAAW,YAAY;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAcD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAI9C;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,gBAAgB,EAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,IAAI,GAAE,UAAU,GAAG,SAAS,GAAG,QAAmB,GACjD,OAAO,CAAC,oBAAoB,CAAC;IAchC;;OAEG;YACW,gBAAgB;IAkF9B;;OAEG;YACW,MAAM;IA2BpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAI/D;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;CAGnD;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,eAAe,CAKlF;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/services/reranker.js

@@ -0,0 +1,234 @@
+/**
+ * Reranker Service
+ * Implements two-stage retrieval: recall candidates, then rerank with scoring
+ */
+import { searchMemoriesVector, searchMemoriesHybrid, searchMemoriesBM25, listMemories } from '../schema/memory.js';
+import { generateFixedEmbedding, generateFixedQueryEmbedding } from './embedding-fixed.js';
+import { isHighPriority } from '../utils/priority.js';
+const DEFAULT_RERANK_CONFIG = {
+    initialRecallLimit: 50,
+    finalLimit: 10,
+    rerankWeight: {
+        semantic: 0.4,
+        keyword: 0.3,
+        recency: 0.2,
+        importance: 0.1
+    },
+    importanceThreshold: 0.5
+};
+class RerankerService {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_RERANK_CONFIG, ...config };
+    }
+    /**
+     * Two-stage retrieval with reranking
+     */
+    async search(query, isolation, projectTags, mode = 'hybrid') {
+        // Stage 1: Recall candidates
+        const candidates = await this.recallCandidates(query, isolation, projectTags, mode);
+        // Stage 2: Rerank
+        const reranked = await this.rerank(query, candidates, isolation);
+        return {
+            results: reranked.slice(0, this.config.finalLimit),
+            totalCandidates: candidates.length,
+            searchMode: mode
+        };
+    }
+    /**
+     * Stage 1: Recall candidates using multiple strategies
+     */
+    async recallCandidates(query, isolation, projectTags, mode = 'hybrid') {
+        const candidates = new Map();
+        const limit = this.config.initialRecallLimit;
+        // Semantic recall
+        if (mode === 'semantic' || mode === 'hybrid') {
+            try {
+                const queryEmbedding = generateFixedQueryEmbedding(query);
+                const semanticResults = searchMemoriesVector(queryEmbedding, projectTags, limit, 0.05, // Lower threshold for recall
+                isolation);
+                for (const result of semanticResults) {
+                    candidates.set(result.id, { ...result, originalScore: result.similarity });
+                }
+            }
+            catch {
+                // Fallback to other methods
+            }
+        }
+        // Keyword recall
+        if (mode === 'keyword' || mode === 'hybrid') {
+            const keywordResults = searchMemoriesBM25(query, projectTags, limit, isolation);
+            for (const memory of keywordResults) {
+                if (!candidates.has(memory.id)) {
+                    candidates.set(memory.id, { ...memory, originalScore: 0.5 });
+                }
+            }
+        }
+        // Hybrid recall
+        if (mode === 'hybrid') {
+            try {
+                const queryEmbedding = generateFixedQueryEmbedding(query);
+                const hybridResults = searchMemoriesHybrid(query, queryEmbedding, projectTags, limit, 0.5, 0.5, isolation);
+                for (const result of hybridResults) {
+                    if (!candidates.has(result.id)) {
+                        candidates.set(result.id, { ...result, originalScore: result.combinedScore });
+                    }
+                }
+            }
+            catch {
+                // Ignore
+            }
+        }
+        // Add high-priority anchored memories regardless of search
+        const allMemories = listMemories(projectTags, isolation);
+        const anchoredHighPriority = allMemories.filter(m => m.anchored || isHighPriority(m.priority));
+        for (const memory of anchoredHighPriority) {
+            if (!candidates.has(memory.id)) {
+                candidates.set(memory.id, { ...memory, originalScore: 0.9 });
+            }
+        }
+        return Array.from(candidates.values());
+    }
+    /**
+     * Stage 2: Rerank candidates using multiple signals
+     */
+    async rerank(query, candidates, _isolation) {
+        const queryLower = query.toLowerCase();
+        const queryTerms = queryLower.split(/\s+/).filter(t => t.length > 2);
+        const reranked = [];
+        for (const candidate of candidates) {
+            const factors = this.computeRerankFactors(candidate, queryLower, queryTerms);
+            const rerankedScore = this.computeFinalScore(factors);
+            reranked.push({
+                memory: candidate,
+                originalScore: 'originalScore' in candidate ? candidate.originalScore : 0.5,
+                rerankedScore,
+                rerankFactors: factors
+            });
+        }
+        // Sort by reranked score
+        reranked.sort((a, b) => b.rerankedScore - a.rerankedScore);
+        return reranked;
+    }
+    /**
+     * Compute individual reranking factors
+     */
+    computeRerankFactors(memory, queryLower, queryTerms) {
+        // Semantic score (based on content similarity)
+        const semanticScore = this.computeSemanticScore(memory.content, queryLower);
+        // Keyword match score
+        const keywordScore = this.computeKeywordScore(memory.content, queryTerms);
+        // Recency score (decay over time)
+        const recencyScore = this.computeRecencyScore(memory.updatedAt);
+        // Importance score (based on priority and access patterns)
+        const importanceScore = this.computeImportanceScore(memory);
+        return {
+            semanticScore,
+            keywordScore,
+            recencyScore,
+            importanceScore
+        };
+    }
+    /**
+     * Compute semantic similarity score
+     */
+    computeSemanticScore(content, query) {
+        const contentEmbedding = generateFixedEmbedding(content);
+        const queryEmbedding = generateFixedQueryEmbedding(query);
+        // Compute cosine similarity
+        let dot = 0, normA = 0, normB = 0;
+        for (let i = 0; i < contentEmbedding.length && i < queryEmbedding.length; i++) {
+            dot += contentEmbedding[i] * queryEmbedding[i];
+            normA += contentEmbedding[i] * contentEmbedding[i];
+            normB += queryEmbedding[i] * queryEmbedding[i];
+        }
+        const cosine = normA > 0 && normB > 0 ? dot / (Math.sqrt(normA) * Math.sqrt(normB)) : 0;
+        return Math.max(0, Math.min(1, cosine));
+    }
+    /**
+     * Compute keyword match score
+     */
+    computeKeywordScore(content, queryTerms) {
+        if (queryTerms.length === 0)
+            return 0.5;
+        const contentLower = content.toLowerCase();
+        let matches = 0;
+        for (const term of queryTerms) {
+            if (contentLower.includes(term)) {
+                matches++;
+            }
+        }
+        return matches / queryTerms.length;
+    }
+    /**
+     * Compute recency score (exponential decay)
+     */
+    computeRecencyScore(updatedAt) {
+        const now = new Date();
+        const ageMs = now.getTime() - updatedAt.getTime();
+        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+        // Exponential decay with half-life of 7 days
+        const halfLifeDays = 7;
+        const decay = Math.pow(0.5, ageDays / halfLifeDays);
+        return Math.max(0.1, Math.min(1, decay));
+    }
+    /**
+     * Compute importance score
+     */
+    computeImportanceScore(memory) {
+        // Base score from priority
+        const priorityScore = {
+            anchored: 1.0,
+            constraint: 0.9,
+            decision: 0.7,
+            preference: 0.5,
+            fact: 0.3
+        };
+        const baseScore = priorityScore[memory.priority] ?? 0.5;
+        // Boost for anchored memories
+        const anchoredBoost = memory.anchored ? 0.1 : 0;
+        // Boost for frequently accessed memories (logarithmic)
+        const accessBoost = Math.min(0.2, Math.log10(memory.accessCount + 1) * 0.1);
+        return Math.min(1, baseScore + anchoredBoost + accessBoost);
+    }
+    /**
+     * Compute final score from factors
+     */
+    computeFinalScore(factors) {
+        const { semantic, keyword, recency, importance } = this.config.rerankWeight;
+        return (factors.semanticScore * semantic +
+            factors.keywordScore * keyword +
+            factors.recencyScore * recency +
+            factors.importanceScore * importance);
+    }
+    /**
+     * Filter results by importance threshold
+     */
+    filterByImportance(results) {
+        return results.filter(r => r.rerankFactors.importanceScore >= this.config.importanceThreshold);
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(updates) {
+        this.config = { ...this.config, ...updates };
+    }
+}
+// ============ Singleton ============
+let rerankerInstance = null;
+export function getRerankerService(config) {
+    if (!rerankerInstance) {
+        rerankerInstance = new RerankerService(config);
+    }
+    return rerankerInstance;
+}
+export function resetRerankerService() {
+    rerankerInstance = null;
+}
+//# sourceMappingURL=reranker.js.map

package/dist/services/reranker.js.map

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

package/dist/services/triple-extractor.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Triple Extraction Pipeline
+ * Extracts knowledge graph triples (entity-relation-entity) from memories and conversations
+ */
+import { getEntity, KGExtractionResult } from '../schema/knowledge-graph.js';
+import type { Memory } from '../models/types.js';
+export interface ExtractionConfig {
+    minConfidence?: number;
+    entityTypes?: string[];
+    includeFacts?: boolean;
+}
+/**
+ * Extract knowledge graph triples from a memory
+ */
+export declare function extractTriplesFromMemory(memory: Memory, config?: ExtractionConfig): KGExtractionResult;
+/**
+ * Extract triples from multiple memories
+ */
+export declare function extractTriplesFromMemories(memories: Memory[], config?: ExtractionConfig): KGExtractionResult;
+/**
+ * Extract triples from conversation turns
+ */
+export interface ConversationTurn {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export declare function extractTriplesFromConversation(turns: ConversationTurn[], config?: ExtractionConfig): KGExtractionResult;
+/**
+ * Get context for a memory from the knowledge graph
+ */
+export declare function getMemoryContext(_memoryId: string): {
+    relatedEntities: ReturnType<typeof getEntity>[];
+    relatedRelations: Awaited<ReturnType<typeof import('../schema/knowledge-graph.js').getRelationsByEntity>>;
+};
+//# sourceMappingURL=triple-extractor.d.ts.map

package/dist/services/triple-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triple-extractor.d.ts","sourceRoot":"","sources":["../../src/services/triple-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAA4C,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAyHjD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAOD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,gBAAqB,GAAG,kBAAkB,CAuG1G;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,gBAAqB,GAAG,kBAAkB,CAqChH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,gBAAgB,EAAE,EACzB,MAAM,GAAE,gBAAqB,GAC5B,kBAAkB,CA2BpB;AA0BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG;IACnD,eAAe,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,EAAE,CAAC;IAChD,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,cAAc,8BAA8B,EAAE,oBAAoB,CAAC,CAAC,CAAC;CAC3G,CAOA"}