context-gatekeeper 0.3.0

package/dist/services/memory-tiers.js

@@ -0,0 +1,275 @@
+/**
+ * Memory Tiers Service
+ * Implements 3-tier memory architecture: session, short-term, long-term
+ * with forgetting mechanism and semantic compression
+ */
+import { getDatabase, query, run } from '../utils/db.js';
+import { DatabaseError } from '../utils/errors.js';
+import { getMemoriesByIds, createMemory, deleteMemory } from '../schema/memory.js';
+import { getContextCompressor } from './compressor/index.js';
+const DEFAULT_TIER_CONFIG = {
+    sessionRetentionHours: 1,
+    shortRetentionDays: 7,
+    longPromotionThreshold: 0.8,
+    forgettingThreshold: 0.2,
+    maxTierSize: {
+        session: 50,
+        short: 500,
+        long: 10000
+    }
+};
+// ============ Schema ============
+export function initMemoryTiers() {
+    const db = getDatabase();
+    try {
+        db.run(`
+      CREATE TABLE IF NOT EXISTS memory_tiers (
+        memory_id TEXT PRIMARY KEY,
+        tier TEXT NOT NULL CHECK (tier IN ('session', 'short', 'long')),
+        access_count INTEGER NOT NULL DEFAULT 1,
+        last_accessed_at TEXT NOT NULL DEFAULT (datetime('now')),
+        tier_changed_at TEXT NOT NULL DEFAULT (datetime('now')),
+        importance_score REAL NOT NULL DEFAULT 0.5,
+        FOREIGN KEY (memory_id) REFERENCES memories(id)
+      )
+    `);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memory_tiers_tier ON memory_tiers(tier)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memory_tiers_accessed ON memory_tiers(last_accessed_at)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memory_tiers_importance ON memory_tiers(importance_score)`);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to initialize memory tiers', error);
+    }
+}
+// ============ Memory Tier Management ============
+class MemoryTiersService {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_TIER_CONFIG, ...config };
+    }
+    /**
+     * Assign a memory to a tier
+     */
+    async assignToTier(memoryId, tier, importanceScore = 0.5) {
+        const now = new Date().toISOString();
+        try {
+            // Check if already assigned
+            const existing = query(`SELECT * FROM memory_tiers WHERE memory_id = ?`, [memoryId]);
+            if (existing.length > 0) {
+                // Update existing tier
+                run(`UPDATE memory_tiers SET tier = ?, importance_score = ?, tier_changed_at = ?, last_accessed_at = ? WHERE memory_id = ?`, [tier, importanceScore, now, now, memoryId]);
+            }
+            else {
+                // Create new tier record
+                run(`INSERT INTO memory_tiers (memory_id, tier, importance_score, last_accessed_at, tier_changed_at) VALUES (?, ?, ?, ?, ?)`, [memoryId, tier, importanceScore, now, now]);
+            }
+            return this.getTierRecord(memoryId);
+        }
+        catch (error) {
+            throw new DatabaseError('Failed to assign memory to tier', error);
+        }
+    }
+    /**
+     * Get tier record for a memory
+     */
+    getTierRecord(memoryId) {
+        try {
+            const rows = query(`SELECT * FROM memory_tiers WHERE memory_id = ?`, [memoryId]);
+            if (rows.length === 0)
+                return null;
+            return mapTierRow(rows[0]);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get memories by tier
+     */
+    getMemoriesByTier(tier, isolation) {
+        try {
+            let sql = `
+        SELECT m.* FROM memories m
+        JOIN memory_tiers t ON m.id = t.memory_id
+        WHERE t.tier = ? AND m.deleted = 0
+      `;
+            const params = [tier];
+            if (isolation?.userId) {
+                sql += ' AND m.user_id = ?';
+                params.push(isolation.userId);
+            }
+            if (isolation?.agentId) {
+                sql += ' AND m.agent_id = ?';
+                params.push(isolation.agentId);
+            }
+            if (isolation?.projectId) {
+                sql += ' AND m.project_id = ?';
+                params.push(isolation.projectId);
+            }
+            sql += ' ORDER BY t.importance_score DESC, t.last_accessed_at DESC';
+            const rows = query(sql, params);
+            return rows.map(mapMemoryRow);
+        }
+        catch (error) {
+            throw new DatabaseError('Failed to get memories by tier', error);
+        }
+    }
+    /**
+     * Update tier assignment based on access patterns
+     */
+    async refreshTierAssignment(memoryId) {
+        const record = this.getTierRecord(memoryId);
+        if (!record)
+            return null;
+        // Increment access count
+        run(`UPDATE memory_tiers SET access_count = access_count + 1, last_accessed_at = ? WHERE memory_id = ?`, [new Date().toISOString(), memoryId]);
+        // Check for tier promotion/demotion
+        const updatedRecord = this.getTierRecord(memoryId);
+        if (!updatedRecord)
+            return null;
+        // Promote to long-term if high importance and many accesses
+        if (updatedRecord.importanceScore >= this.config.longPromotionThreshold &&
+            updatedRecord.accessCount >= 10 &&
+            updatedRecord.tier !== 'long') {
+            return this.assignToTier(memoryId, 'long', updatedRecord.importanceScore + 0.1);
+        }
+        return updatedRecord;
+    }
+    /**
+     * Run tier maintenance - promote, demote, and forget memories
+     */
+    async runTierMaintenance() {
+        const stats = {
+            sessionCount: 0,
+            shortCount: 0,
+            longCount: 0,
+            promotedCount: 0,
+            demotedCount: 0,
+            forgottenCount: 0
+        };
+        const now = new Date();
+        // Session tier: promote session memories to short-term after retention period
+        const sessionRetentionMs = this.config.sessionRetentionHours * 60 * 60 * 1000;
+        const sessionThreshold = new Date(now.getTime() - sessionRetentionMs);
+        const sessionMemories = query(`SELECT memory_id, importance_score FROM memory_tiers WHERE tier = 'session' AND datetime(last_accessed_at) < datetime(?)`, [sessionThreshold.toISOString()]);
+        for (const row of sessionMemories) {
+            if (row.importance_score >= this.config.forgettingThreshold) {
+                await this.assignToTier(row.memory_id, 'short', row.importance_score);
+                stats.promotedCount++;
+            }
+            else {
+                // Forget this memory
+                await this.forgetMemory(row.memory_id);
+                stats.forgottenCount++;
+            }
+        }
+        // Short tier: promote important memories to long-term
+        const shortMemories = query(`SELECT memory_id, importance_score FROM memory_tiers WHERE tier = 'short'`);
+        for (const row of shortMemories) {
+            if (row.importance_score >= this.config.longPromotionThreshold) {
+                await this.assignToTier(row.memory_id, 'long', row.importance_score + 0.1);
+                stats.promotedCount++;
+            }
+        }
+        // Long tier: enforce max size (evict lowest importance)
+        const longCount = query(`SELECT COUNT(*) as count FROM memory_tiers WHERE tier = 'long'`)[0]?.count ?? 0;
+        if (longCount > this.config.maxTierSize.long) {
+            const toDemote = query(`SELECT memory_id FROM memory_tiers WHERE tier = 'long' ORDER BY importance_score ASC LIMIT ?`, [longCount - this.config.maxTierSize.long]);
+            for (const row of toDemote) {
+                await this.assignToTier(row.memory_id, 'short', 0.3);
+                stats.demotedCount++;
+            }
+        }
+        // Count tiers
+        stats.sessionCount = query(`SELECT COUNT(*) as count FROM memory_tiers WHERE tier = 'session'`)[0]?.count ?? 0;
+        stats.shortCount = query(`SELECT COUNT(*) as count FROM memory_tiers WHERE tier = 'short'`)[0]?.count ?? 0;
+        stats.longCount = query(`SELECT COUNT(*) as count FROM memory_tiers WHERE tier = 'long'`)[0]?.count ?? 0;
+        return stats;
+    }
+    /**
+     * Forget a memory (soft delete with semantic compression)
+     */
+    async forgetMemory(memoryId) {
+        const memory = getMemoriesByIds([memoryId])[0];
+        if (!memory)
+            return;
+        // Create a semantic compression before forgetting
+        const compressor = getContextCompressor();
+        await compressor.compress(0.9); // Compress to 90% reduction
+        // Soft delete
+        deleteMemory(memoryId);
+    }
+    /**
+     * Create a new memory in session tier
+     */
+    async createTieredMemory(content, priority, importanceScore = 0.5, isolation) {
+        const memory = createMemory({
+            content,
+            priority,
+            userId: isolation?.userId,
+            agentId: isolation?.agentId,
+            projectId: isolation?.projectId
+        });
+        await this.assignToTier(memory.id, 'session', importanceScore);
+        return memory;
+    }
+    /**
+     * Get tier statistics
+     */
+    getTierStats() {
+        try {
+            const rows = query(`SELECT tier, COUNT(*) as count, AVG(importance_score) as avg_importance FROM memory_tiers GROUP BY tier`);
+            return rows.map(row => ({
+                tier: row.tier,
+                count: row.count,
+                avgImportance: row.avg_importance
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+function mapTierRow(row) {
+    return {
+        memoryId: row.memory_id,
+        tier: row.tier,
+        accessCount: row.access_count,
+        lastAccessedAt: new Date(row.last_accessed_at),
+        tierChangedAt: new Date(row.tier_changed_at),
+        importanceScore: row.importance_score
+    };
+}
+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.created_at),
+        updatedAt: new Date(row.updated_at),
+        expiresAt: row.expires_at ? new Date(row.expires_at) : null,
+        deleted: row.deleted === 1
+    };
+}
+// ============ Singleton ============
+let memoryTiersInstance = null;
+export function getMemoryTiersService(config) {
+    if (!memoryTiersInstance) {
+        memoryTiersInstance = new MemoryTiersService(config);
+    }
+    return memoryTiersInstance;
+}
+export function resetMemoryTiersService() {
+    memoryTiersInstance = null;
+}
+//# sourceMappingURL=memory-tiers.js.map

package/dist/services/memory-tiers.js.map

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

package/dist/services/memory.d.ts

@@ -0,0 +1,33 @@
+import { CreateMemoryInput, RecallMemoryInput, Memory, IsolationContext, DEFAULT_ISOLATION } from '../models/types.js';
+export type SearchMode = 'keyword' | 'semantic' | 'hybrid' | 'auto' | 'fulltext';
+export interface MemoryStoreOptions {
+    useTransaction?: boolean;
+    isolation?: IsolationContext;
+}
+export declare class MemoryService {
+    private isolationContext;
+    constructor(isolationContext?: IsolationContext);
+    setIsolationContext(context: Partial<IsolationContext>): void;
+    getIsolationContext(): IsolationContext;
+    storeMemory(input: CreateMemoryInput, updatedBy?: string, options?: MemoryStoreOptions): Memory;
+    storeMemoryWithTransaction(input: CreateMemoryInput, updatedBy?: string, isolation?: IsolationContext): Memory;
+    recallMemories(input: RecallMemoryInput, searchMode?: SearchMode): Memory[];
+    private searchWithFullText;
+    private detectSearchMode;
+    getMemory(id: string): Memory | null;
+    anchorMemory(id: string): Memory;
+    updateMemoryContent(id: string, content: string, updatedBy?: string, options?: MemoryStoreOptions): Memory;
+    updateMemoryContentWithTransaction(id: string, content: string, updatedBy?: string, isolation?: IsolationContext): Memory;
+    removeMemory(id: string, updatedBy?: string): void;
+    listAllMemories(projectTags?: string[]): Memory[];
+    getHighPriorityMemories(projectTags?: string[]): Memory[];
+    isMemoryHighPriority(memory: Memory | null): boolean;
+    cleanupExpired(): number;
+    rebuildSearchIndex(): number;
+    isSearchIndexAvailable(): boolean;
+}
+export declare function getMemoryService(isolation?: IsolationContext): MemoryService;
+export declare function resetMemoryService(): void;
+export { DEFAULT_ISOLATION };
+export type { IsolationContext };
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/services/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAwB5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,gBAAgB,GAAE,gBAAoC;IAIlE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAI7D,mBAAmB,IAAI,gBAAgB;IAIvC,WAAW,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAiC1F,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,gBAAgB;IA4BrG,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,GAAE,UAAmB;IAyDxE,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,gBAAgB;IAkBxB,SAAS,CAAC,EAAE,EAAE,MAAM;IAIpB,YAAY,CAAC,EAAE,EAAE,MAAM;IAIvB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAcrG,kCAAkC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,gBAAgB;IAUhH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlD,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE;IAItC,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE;IAK9C,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAKpD,cAAc,IAAI,MAAM;IAIxB,kBAAkB,IAAI,MAAM;IAI5B,sBAAsB,IAAI,OAAO;CAQlC;AAID,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAK5E;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/services/memory.js

@@ -0,0 +1,209 @@
+import { DEFAULT_ISOLATION } from '../models/types.js';
+import { createMemory, getMemory, getMemoriesByIds, updateMemory, deleteMemory, listMemories, searchMemoriesBM25, searchMemoriesVector, searchMemoriesHybrid, incrementAccessCount, storeEmbedding, computeContentHash, findDuplicateByHash, cleanupExpiredMemories } from '../schema/memory.js';
+import { insertHNSWNode, getHNSWIndex } from './hnsw-index.js';
+import { searchFullText, rebuildFullTextIndex } from '../schema/fulltext-search.js';
+import { calculatePriorityScore, isHighPriority } from '../utils/priority.js';
+import { generateFixedEmbedding, generateFixedQueryEmbedding } from '../services/embedding-fixed.js';
+import { transaction } from '../utils/db.js';
+export class MemoryService {
+    isolationContext;
+    constructor(isolationContext = DEFAULT_ISOLATION) {
+        this.isolationContext = isolationContext;
+    }
+    setIsolationContext(context) {
+        this.isolationContext = { ...this.isolationContext, ...context };
+    }
+    getIsolationContext() {
+        return { ...this.isolationContext };
+    }
+    storeMemory(input, updatedBy, options = {}) {
+        const isolation = options.isolation || this.isolationContext;
+        if (options.useTransaction) {
+            return this.storeMemoryWithTransaction(input, updatedBy, isolation);
+        }
+        const contentHash = computeContentHash(input.content);
+        const existing = findDuplicateByHash(contentHash, isolation);
+        if (existing) {
+            incrementAccessCount(existing.id);
+            return existing;
+        }
+        const memoryInput = { ...input, ...isolation };
+        const memory = createMemory(memoryInput, updatedBy);
+        const embedding = generateFixedEmbedding(input.content);
+        storeEmbedding(memory.id, input.content, embedding, 'fixed-tfidf', 'v1', 4096);
+        // 增量索引：新记忆同步写入 HNSW（懒构建，无需全量重建）
+        try {
+            const idx = getHNSWIndex('default');
+            if (idx) {
+                insertHNSWNode('default', memory.id, embedding, input.projectTags || []);
+            }
+        }
+        catch {
+            // HNSW 索引未初始化，静默跳过
+        }
+        return memory;
+    }
+    storeMemoryWithTransaction(input, updatedBy, isolation) {
+        const effectiveIsolation = isolation || this.isolationContext;
+        const contentHash = computeContentHash(input.content);
+        const existing = findDuplicateByHash(contentHash, effectiveIsolation);
+        if (existing) {
+            incrementAccessCount(existing.id);
+            return existing;
+        }
+        return transaction(() => {
+            const memoryInput = { ...input, ...effectiveIsolation };
+            const memory = createMemory(memoryInput, updatedBy);
+            const embedding = generateFixedEmbedding(input.content);
+            storeEmbedding(memory.id, input.content, embedding, 'fixed-tfidf', 'v1', 4096);
+            // 增量索引
+            try {
+                const idx = getHNSWIndex('default');
+                if (idx) {
+                    insertHNSWNode('default', memory.id, embedding, input.projectTags || []);
+                }
+            }
+            catch {
+                // 静默跳过
+            }
+            return memory;
+        });
+    }
+    recallMemories(input, searchMode = 'auto') {
+        const { query, projectTags, limit = 10, userId, agentId, projectId } = input;
+        const isolation = { userId, agentId, projectId };
+        let memories;
+        const actualMode = searchMode === 'auto' ? this.detectSearchMode(query) : searchMode;
+        switch (actualMode) {
+            case 'keyword':
+                memories = searchMemoriesBM25(query, projectTags, limit, isolation);
+                break;
+            case 'fulltext':
+                memories = this.searchWithFullText(query, projectTags, limit, isolation);
+                break;
+            case 'semantic':
+                try {
+                    const queryEmbedding = generateFixedQueryEmbedding(query);
+                    const results = searchMemoriesVector(queryEmbedding, projectTags, limit, 0.1, isolation);
+                    memories = results.map(r => ({ ...r, similarity: r.similarity }));
+                }
+                catch {
+                    memories = searchMemoriesBM25(query, projectTags, limit, isolation);
+                }
+                break;
+            case 'hybrid':
+                try {
+                    const queryEmbedding = generateFixedQueryEmbedding(query);
+                    const results = searchMemoriesHybrid(query, queryEmbedding, projectTags, limit, 0.5, 0.5, isolation);
+                    memories = results;
+                }
+                catch {
+                    memories = searchMemoriesBM25(query, projectTags, limit, isolation);
+                }
+                break;
+            default:
+                memories = searchMemoriesBM25(query, projectTags, limit, isolation);
+        }
+        if (!query) {
+            memories = listMemories(projectTags, isolation);
+        }
+        const scoredMemories = [];
+        for (const memory of memories) {
+            incrementAccessCount(memory.id);
+            const score = calculatePriorityScore(memory.priority, memory.accessCount + 1, memory.createdAt, memory.anchored);
+            scoredMemories.push({ memory, score });
+        }
+        scoredMemories.sort((a, b) => b.score - a.score);
+        return scoredMemories.slice(0, limit).map(item => item.memory);
+    }
+    searchWithFullText(queryText, projectTags, limit = 10, isolation) {
+        const results = searchFullText(queryText, limit);
+        const memoryIds = results.map(result => result.memoryId);
+        const memories = getMemoriesByIds(memoryIds, isolation);
+        if (!projectTags || projectTags.length === 0) {
+            return memories;
+        }
+        return memories.filter(memory => projectTags.every(tag => memory.projectTags.includes(tag)));
+    }
+    detectSearchMode(query) {
+        if (query.length < 20) {
+            return 'keyword';
+        }
+        const hasTechnicalTerms = /\b(api|function|class|error|bug|fix|implement|test|config)\b/i.test(query);
+        if (hasTechnicalTerms) {
+            return 'hybrid';
+        }
+        const hasNaturalLanguage = /\b(how|what|why|explain|describe|tell me about)\b/i.test(query);
+        if (hasNaturalLanguage) {
+            return 'semantic';
+        }
+        return 'hybrid';
+    }
+    getMemory(id) {
+        return getMemory(id, this.isolationContext);
+    }
+    anchorMemory(id) {
+        return updateMemory(id, { anchored: true }, undefined, this.isolationContext);
+    }
+    updateMemoryContent(id, content, updatedBy, options = {}) {
+        const isolation = options.isolation || this.isolationContext;
+        if (options.useTransaction) {
+            return this.updateMemoryContentWithTransaction(id, content, updatedBy, isolation);
+        }
+        const memory = updateMemory(id, { content }, updatedBy, isolation);
+        const embedding = generateFixedEmbedding(content);
+        storeEmbedding(id, content, embedding, 'fixed-tfidf', 'v1', 4096);
+        return memory;
+    }
+    updateMemoryContentWithTransaction(id, content, updatedBy, isolation) {
+        const effectiveIsolation = isolation || this.isolationContext;
+        return transaction(() => {
+            const memory = updateMemory(id, { content }, updatedBy, effectiveIsolation);
+            const embedding = generateFixedEmbedding(content);
+            storeEmbedding(id, content, embedding, 'fixed-tfidf', 'v1', 4096);
+            return memory;
+        });
+    }
+    removeMemory(id, updatedBy) {
+        deleteMemory(id, updatedBy, this.isolationContext);
+    }
+    listAllMemories(projectTags) {
+        return listMemories(projectTags, this.isolationContext);
+    }
+    getHighPriorityMemories(projectTags) {
+        const memories = listMemories(projectTags, this.isolationContext);
+        return memories.filter(memory => isHighPriority(memory.priority));
+    }
+    isMemoryHighPriority(memory) {
+        if (!memory)
+            return false;
+        return isHighPriority(memory.priority);
+    }
+    cleanupExpired() {
+        return cleanupExpiredMemories();
+    }
+    rebuildSearchIndex() {
+        return rebuildFullTextIndex();
+    }
+    isSearchIndexAvailable() {
+        try {
+            searchFullText('health-check', 1);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+let memoryServiceInstance = null;
+export function getMemoryService(isolation) {
+    if (!memoryServiceInstance) {
+        memoryServiceInstance = new MemoryService(isolation);
+    }
+    return memoryServiceInstance;
+}
+export function resetMemoryService() {
+    memoryServiceInstance = null;
+}
+export { DEFAULT_ISOLATION };
+//# sourceMappingURL=memory.js.map

package/dist/services/memory.js.map

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

package/dist/services/multi-agent-sharing.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Multi-Agent Sharing Service
+ * Enables sharing memories and sessions across agents
+ */
+import { Memory } from '../models/types.js';
+export interface ShareConfig {
+    shareToAgents: string[];
+    shareToProjects: string[];
+    permission: 'read' | 'read_write' | 'admin';
+    expiresAt?: Date;
+}
+export interface SharedMemoryRecord {
+    id: string;
+    memoryId: string;
+    sharedByAgentId: string;
+    sharedToAgentId: string;
+    sharedToProjectId: string;
+    permission: string;
+    sharedAt: Date;
+    expiresAt: Date | null;
+}
+export interface ShareToken {
+    token: string;
+    memoryId: string;
+    sharedByAgentId: string;
+    permission: string;
+    createdAt: Date;
+    expiresAt: Date | null;
+    useCount: number;
+    maxUses: number | null;
+}
+export declare function initMultiAgentSharing(): void;
+/**
+ * Share a memory with specific agents
+ */
+export declare function shareMemoryToAgents(memoryId: string, sharedByAgentId: string, targetAgentIds: string[], targetProjectId: string, permission?: ShareConfig['permission'], expiresAt?: Date): SharedMemoryRecord[];
+/**
+ * Share a memory to a project (all agents in project)
+ */
+export declare function shareMemoryToProject(memoryId: string, sharedByAgentId: string, targetProjectId: string, permission?: ShareConfig['permission'], expiresAt?: Date): SharedMemoryRecord;
+/**
+ * Get shared memories for an agent
+ */
+export declare function getSharedMemoriesForAgent(agentId: string, projectId?: string, includeExpired?: boolean): Array<SharedMemoryRecord & {
+    memory: Memory;
+}>;
+/**
+ * Revoke a shared memory
+ */
+export declare function revokeSharedMemory(shareId: string): void;
+/**
+ * Revoke all shares of a memory
+ */
+export declare function revokeAllSharesForMemory(memoryId: string): number;
+/**
+ * Create a share token for a memory
+ */
+export declare function createShareToken(memoryId: string, sharedByAgentId: string, permission?: 'read' | 'read_write', options?: {
+    expiresAt?: Date;
+    maxUses?: number;
+}): ShareToken;
+/**
+ * Redeem a share token
+ */
+export declare function redeemShareToken(token: string): {
+    memory: Memory;
+    permission: string;
+} | null;
+/**
+ * Delete expired tokens
+ */
+export declare function cleanupExpiredTokens(): number;
+export declare function getMultiAgentSharingService(): {
+    shareMemoryToAgents: typeof shareMemoryToAgents;
+    shareMemoryToProject: typeof shareMemoryToProject;
+    getSharedMemoriesForAgent: typeof getSharedMemoriesForAgent;
+    revokeSharedMemory: typeof revokeSharedMemory;
+    revokeAllSharesForMemory: typeof revokeAllSharesForMemory;
+    createShareToken: typeof createShareToken;
+    redeemShareToken: typeof redeemShareToken;
+    cleanupExpiredTokens: typeof cleanupExpiredTokens;
+};
+//# sourceMappingURL=multi-agent-sharing.d.ts.map

package/dist/services/multi-agent-sharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-agent-sharing.d.ts","sourceRoot":"","sources":["../../src/services/multi-agent-sharing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;IAC5C,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAyC5C;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EAAE,EACxB,eAAe,EAAE,MAAM,EACvB,UAAU,GAAE,WAAW,CAAC,YAAY,CAAU,EAC9C,SAAS,CAAC,EAAE,IAAI,GACf,kBAAkB,EAAE,CAStB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,UAAU,GAAE,WAAW,CAAC,YAAY,CAAU,EAC9C,SAAS,CAAC,EAAE,IAAI,GACf,kBAAkB,CAGpB;AA+CD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,GAAE,OAAe,GAC9B,KAAK,CAAC,kBAAkB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAuChD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOjE;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,UAAU,GAAE,MAAM,GAAG,YAAqB,EAC1C,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,UAAU,CAgCZ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4C7F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAsED,wBAAgB,2BAA2B;;;;;;;;;EAW1C"}