@pga-ai/core 0.4.0

package/dist/memory/LayeredMemory.d.ts

@@ -0,0 +1,112 @@
+import type { StorageAdapter } from '../interfaces/StorageAdapter.js';
+import type { LLMAdapter } from '../interfaces/LLMAdapter.js';
+import type { Interaction } from '../types/index.js';
+import type { MetricsCollector } from '../monitoring/MetricsCollector.js';
+export interface ShortTermMemory {
+    messages: Interaction[];
+    ttl: number;
+    maxMessages: number;
+    estimatedTokens: number;
+}
+export interface MediumTermMemory {
+    summary: string;
+    periodStart: Date;
+    periodEnd: Date;
+    messageCount: number;
+    estimatedTokens: number;
+}
+export interface LongTermMemory {
+    userProfile: UserProfile;
+    semanticFacts: SemanticFact[];
+    permanentPreferences: Record<string, any>;
+    estimatedTokens: number;
+}
+export interface SemanticFact {
+    id: string;
+    fact: string;
+    category: 'profile' | 'preference' | 'constraint' | 'knowledge';
+    confidence: number;
+    sourceTurn: number;
+    sourceInteractionId?: string;
+    extractedAt: Date;
+    expiry: Date | null;
+    verified: boolean;
+}
+export interface UserProfile {
+    userId: string;
+    profession?: string;
+    timezone?: string;
+    language?: string;
+    communicationStyle?: 'formal' | 'casual' | 'technical';
+    codePreferences?: {
+        language?: string;
+        style?: string;
+        verbosity?: 'concise' | 'detailed';
+    };
+}
+export interface LayeredMemorySnapshot {
+    shortTerm: ShortTermMemory;
+    mediumTerm: MediumTermMemory;
+    longTerm: LongTermMemory;
+    totalEstimatedTokens: number;
+    lastCompaction: Date;
+}
+export interface LayeredMemoryConfig {
+    enabled: boolean;
+    shortTerm: {
+        maxMessages: number;
+        ttlHours: number;
+    };
+    mediumTerm: {
+        maxMessages: number;
+        ttlDays: number;
+        compressionRatio: number;
+    };
+    longTerm: {
+        enabled: boolean;
+        autoExtraction: boolean;
+        minConfidence: number;
+        defaultTTLDays: number;
+    };
+    compaction: {
+        autoCompact: boolean;
+        triggerAfterMessages: number;
+    };
+    privacy: {
+        enableExpiration: boolean;
+        allowUserDeletion: boolean;
+    };
+}
+export declare class LayeredMemory {
+    private storage;
+    private llm;
+    private config;
+    private summaryCache;
+    private lastCompactionTimes;
+    private turnCounters;
+    private metricsCollector?;
+    constructor(storage: StorageAdapter, llm: LLMAdapter, config?: Partial<LayeredMemoryConfig>, metricsCollector?: MetricsCollector);
+    getMemorySnapshot(userId: string, genomeId: string): Promise<LayeredMemorySnapshot>;
+    buildContext(userId: string, genomeId: string): Promise<string>;
+    addInteraction(userId: string, genomeId: string, interaction: Interaction): Promise<void>;
+    deleteUserData(userId: string, genomeId: string): Promise<void>;
+    deleteFact(userId: string, genomeId: string, factId: string): Promise<void>;
+    verifyFact(userId: string, genomeId: string, factId: string): Promise<void>;
+    getFacts(userId: string, genomeId: string): Promise<SemanticFact[]>;
+    cleanExpiredFacts(userId: string, genomeId: string): Promise<number>;
+    compactMemory(userId: string, genomeId: string): Promise<void>;
+    private getShortTermMemory;
+    private getMediumTermMemory;
+    private getLongTermMemory;
+    private getAllInteractions;
+    private summarizeInteractions;
+    private extractLongTermFacts;
+    private formatLongTermMemory;
+    private formatMediumTermMemory;
+    private formatShortTermMemory;
+    private getMessageCount;
+    private getLastCompactionTime;
+    private setLastCompactionTime;
+    private estimateTokens;
+}
+//# sourceMappingURL=LayeredMemory.d.ts.map

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

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

package/dist/memory/LayeredMemory.js

@@ -0,0 +1,405 @@
+export class LayeredMemory {
+    storage;
+    llm;
+    config;
+    summaryCache = new Map();
+    lastCompactionTimes = new Map();
+    turnCounters = new Map();
+    metricsCollector;
+    constructor(storage, llm, config, metricsCollector) {
+        this.storage = storage;
+        this.llm = llm;
+        this.metricsCollector = metricsCollector;
+        this.config = {
+            enabled: config?.enabled ?? true,
+            shortTerm: {
+                maxMessages: config?.shortTerm?.maxMessages ?? 10,
+                ttlHours: config?.shortTerm?.ttlHours ?? 1,
+            },
+            mediumTerm: {
+                maxMessages: config?.mediumTerm?.maxMessages ?? 50,
+                ttlDays: config?.mediumTerm?.ttlDays ?? 7,
+                compressionRatio: config?.mediumTerm?.compressionRatio ?? 0.2,
+            },
+            longTerm: {
+                enabled: config?.longTerm?.enabled ?? true,
+                autoExtraction: config?.longTerm?.autoExtraction ?? true,
+                minConfidence: config?.longTerm?.minConfidence ?? 0.7,
+                defaultTTLDays: config?.longTerm?.defaultTTLDays ?? 365,
+            },
+            compaction: {
+                autoCompact: config?.compaction?.autoCompact ?? true,
+                triggerAfterMessages: config?.compaction?.triggerAfterMessages ?? 50,
+            },
+            privacy: {
+                enableExpiration: config?.privacy?.enableExpiration ?? true,
+                allowUserDeletion: config?.privacy?.allowUserDeletion ?? true,
+            },
+        };
+    }
+    async getMemorySnapshot(userId, genomeId) {
+        const [shortTerm, mediumTerm, longTerm] = await Promise.all([
+            this.getShortTermMemory(userId, genomeId),
+            this.getMediumTermMemory(userId, genomeId),
+            this.getLongTermMemory(userId, genomeId),
+        ]);
+        const totalEstimatedTokens = shortTerm.estimatedTokens +
+            mediumTerm.estimatedTokens +
+            longTerm.estimatedTokens;
+        const lastCompaction = await this.getLastCompactionTime(userId, genomeId);
+        return {
+            shortTerm,
+            mediumTerm,
+            longTerm,
+            totalEstimatedTokens,
+            lastCompaction,
+        };
+    }
+    async buildContext(userId, genomeId) {
+        const snapshot = await this.getMemorySnapshot(userId, genomeId);
+        const sections = [];
+        if (snapshot.longTerm.estimatedTokens > 0) {
+            sections.push(this.formatLongTermMemory(snapshot.longTerm));
+        }
+        if (snapshot.mediumTerm.summary) {
+            sections.push(this.formatMediumTermMemory(snapshot.mediumTerm));
+        }
+        if (snapshot.shortTerm.messages.length > 0) {
+            sections.push(this.formatShortTermMemory(snapshot.shortTerm));
+        }
+        return sections.join('\n\n');
+    }
+    async addInteraction(userId, genomeId, interaction) {
+        await this.storage.recordInteraction(interaction);
+        if (this.config.compaction.autoCompact) {
+            const messageCount = await this.getMessageCount(userId, genomeId);
+            if (messageCount % this.config.compaction.triggerAfterMessages === 0) {
+                await this.compactMemory(userId, genomeId);
+            }
+        }
+        if (this.config.longTerm.enabled && this.config.longTerm.autoExtraction) {
+            await this.extractLongTermFacts(userId, genomeId, interaction);
+        }
+    }
+    async deleteUserData(userId, genomeId) {
+        if (!this.config.privacy.allowUserDeletion) {
+            throw new Error('User data deletion is not enabled');
+        }
+        const cacheKey = `${userId}:${genomeId}`;
+        this.summaryCache.delete(cacheKey);
+        this.lastCompactionTimes.delete(cacheKey);
+        this.turnCounters.delete(cacheKey);
+        await this.storage.deleteUserFacts(userId, genomeId);
+    }
+    async deleteFact(userId, genomeId, factId) {
+        void userId;
+        void genomeId;
+        await this.storage.deleteFact(factId);
+    }
+    async verifyFact(userId, genomeId, factId) {
+        void userId;
+        void genomeId;
+        await this.storage.updateFact(factId, {
+            verified: true,
+            confidence: 1.0,
+            expiry: null,
+        });
+    }
+    async getFacts(userId, genomeId) {
+        const longTerm = await this.getLongTermMemory(userId, genomeId);
+        return longTerm.semanticFacts;
+    }
+    async cleanExpiredFacts(userId, genomeId) {
+        return await this.storage.cleanExpiredFacts(userId, genomeId);
+    }
+    async compactMemory(userId, genomeId) {
+        const startTime = Date.now();
+        const interactions = await this.getAllInteractions(userId, genomeId);
+        if (interactions.length < this.config.shortTerm.maxMessages) {
+            return;
+        }
+        const fullText = interactions.map(i => `${i.userMessage} ${i.assistantResponse}`).join(' ');
+        const tokensBeforeCompaction = this.estimateTokens(fullText);
+        const shortTermCutoff = interactions.length - this.config.shortTerm.maxMessages;
+        const mediumTermMessages = interactions.slice(0, shortTermCutoff);
+        let tokensAfterCompaction = tokensBeforeCompaction;
+        if (mediumTermMessages.length > 0) {
+            const summary = await this.summarizeInteractions(mediumTermMessages);
+            const cacheKey = `${userId}:${genomeId}`;
+            this.summaryCache.set(cacheKey, {
+                summary,
+                timestamp: new Date(),
+            });
+            const shortTermText = interactions
+                .slice(-this.config.shortTerm.maxMessages)
+                .map(i => `${i.userMessage} ${i.assistantResponse}`)
+                .join(' ');
+            tokensAfterCompaction = this.estimateTokens(shortTermText + summary);
+        }
+        await this.setLastCompactionTime(userId, genomeId, new Date());
+        const latencyMs = Date.now() - startTime;
+        const compressionRatio = tokensBeforeCompaction > 0
+            ? 1 - (tokensAfterCompaction / tokensBeforeCompaction)
+            : 0;
+        this.metricsCollector?.logAudit({
+            level: 'info',
+            component: 'LayeredMemory',
+            operation: 'compaction',
+            userId,
+            genomeId,
+            message: `Compacted ${mediumTermMessages.length} messages with ${compressionRatio.toFixed(1)}x compression ratio`,
+            duration: latencyMs,
+            metadata: {
+                messagesCompacted: mediumTermMessages.length,
+                tokensBeforeCompaction,
+                tokensAfterCompaction,
+                compressionRatio,
+            },
+        });
+    }
+    async getShortTermMemory(userId, genomeId) {
+        const allInteractions = await this.getAllInteractions(userId, genomeId);
+        const recentMessages = allInteractions.slice(-this.config.shortTerm.maxMessages);
+        return {
+            messages: recentMessages,
+            ttl: this.config.shortTerm.ttlHours * 60 * 60 * 1000,
+            maxMessages: this.config.shortTerm.maxMessages,
+            estimatedTokens: this.estimateTokens(recentMessages.map(m => `${m.userMessage} ${m.assistantResponse}`).join(' ')),
+        };
+    }
+    async getMediumTermMemory(userId, genomeId) {
+        const cacheKey = `${userId}:${genomeId}`;
+        const cached = this.summaryCache.get(cacheKey);
+        if (cached) {
+            return {
+                summary: cached.summary,
+                periodStart: new Date(0),
+                periodEnd: cached.timestamp,
+                messageCount: 0,
+                estimatedTokens: this.estimateTokens(cached.summary),
+            };
+        }
+        const interactions = await this.getAllInteractions(userId, genomeId);
+        if (interactions.length > this.config.shortTerm.maxMessages) {
+            const shortTermCutoff = interactions.length - this.config.shortTerm.maxMessages;
+            const mediumTermMessages = interactions.slice(0, shortTermCutoff);
+            const summary = await this.summarizeInteractions(mediumTermMessages);
+            this.summaryCache.set(cacheKey, { summary, timestamp: new Date() });
+            return {
+                summary,
+                periodStart: mediumTermMessages[0].timestamp,
+                periodEnd: mediumTermMessages[mediumTermMessages.length - 1].timestamp,
+                messageCount: mediumTermMessages.length,
+                estimatedTokens: this.estimateTokens(summary),
+            };
+        }
+        return {
+            summary: '',
+            periodStart: new Date(),
+            periodEnd: new Date(),
+            messageCount: 0,
+            estimatedTokens: 0,
+        };
+    }
+    async getLongTermMemory(userId, genomeId) {
+        const includeExpired = !this.config.privacy.enableExpiration;
+        const facts = await this.storage.getFacts(userId, genomeId, includeExpired);
+        const userProfile = { userId };
+        const permanentPreferences = {};
+        const profileString = JSON.stringify({ userProfile, facts, permanentPreferences });
+        return {
+            userProfile,
+            semanticFacts: facts,
+            permanentPreferences,
+            estimatedTokens: this.estimateTokens(profileString),
+        };
+    }
+    async getAllInteractions(userId, genomeId) {
+        const interactions = await this.storage.getRecentInteractions(genomeId, userId, 1000);
+        return interactions;
+    }
+    async summarizeInteractions(interactions) {
+        const messagesText = interactions
+            .map(i => `User: ${i.userMessage}\nAssistant: ${i.assistantResponse}`)
+            .join('\n\n');
+        const summaryPrompt = `
+Summarize the following conversation in 5-7 sentences, preserving:
+1. Key facts learned about the user
+2. Important decisions or preferences stated
+3. Main topics discussed
+4. Any commitments or follow-ups
+
+Conversation:
+${messagesText}
+
+Summary:`;
+        const response = await this.llm.chat([
+            { role: 'system', content: 'You are a precise conversation summarizer.' },
+            { role: 'user', content: summaryPrompt },
+        ]);
+        return response.content;
+    }
+    async extractLongTermFacts(userId, genomeId, interaction) {
+        const startTime = Date.now();
+        const cacheKey = `${userId}:${genomeId}`;
+        const currentTurn = (this.turnCounters.get(cacheKey) || 0) + 1;
+        this.turnCounters.set(cacheKey, currentTurn);
+        const extractionPrompt = `
+Analyze this conversation and extract permanent facts about the user.
+Return ONLY facts that are unlikely to change (profession, timezone, preferences, etc.).
+
+User: ${interaction.userMessage}
+Assistant: ${interaction.assistantResponse}
+
+Extract facts in JSON format:
+{
+  "facts": [
+    {
+      "fact": "The user is a software engineer",
+      "category": "profile",
+      "confidence": 0.9
+    }
+  ]
+}
+
+Valid categories: "profile", "preference", "constraint", "knowledge"
+Confidence: 0.0 to 1.0
+
+If no permanent facts found, return: {"facts": []}
+`;
+        try {
+            const response = await this.llm.chat([
+                {
+                    role: 'system',
+                    content: 'You extract permanent user facts from conversations. Return valid JSON only.',
+                },
+                { role: 'user', content: extractionPrompt },
+            ]);
+            const parsed = JSON.parse(response.content);
+            const extractedFacts = parsed.facts || [];
+            const validFacts = extractedFacts.filter((f) => f.confidence >= this.config.longTerm.minConfidence);
+            const avgConfidence = validFacts.length > 0
+                ? validFacts.reduce((sum, f) => sum + f.confidence, 0) / validFacts.length
+                : 0;
+            if (validFacts.length === 0) {
+                this.metricsCollector?.logAudit({
+                    level: 'warning',
+                    component: 'LayeredMemory',
+                    operation: 'fact_extraction',
+                    userId,
+                    genomeId,
+                    message: 'No facts extracted from messages',
+                    duration: Date.now() - startTime,
+                    metadata: {
+                        factsExtracted: 0,
+                        avgConfidence: 0,
+                        success: false,
+                    },
+                });
+                return;
+            }
+            const now = new Date();
+            const ttlMs = this.config.longTerm.defaultTTLDays * 24 * 60 * 60 * 1000;
+            const expiry = new Date(now.getTime() + ttlMs);
+            const newFacts = validFacts.map((f) => ({
+                id: `${cacheKey}-${currentTurn}-${Date.now()}`,
+                fact: f.fact,
+                category: f.category,
+                confidence: f.confidence,
+                sourceTurn: currentTurn,
+                sourceInteractionId: interaction.timestamp.toISOString(),
+                extractedAt: now,
+                expiry,
+                verified: false,
+            }));
+            for (const fact of newFacts) {
+                await this.storage.saveFact(fact, userId, genomeId);
+            }
+            const latencyMs = Date.now() - startTime;
+            this.metricsCollector?.logAudit({
+                level: 'info',
+                component: 'LayeredMemory',
+                operation: 'fact_extraction',
+                userId,
+                genomeId,
+                message: `Extracted ${validFacts.length} semantic facts with avg confidence ${avgConfidence.toFixed(2)}`,
+                duration: latencyMs,
+                metadata: {
+                    factsExtracted: validFacts.length,
+                    avgConfidence,
+                    success: true,
+                },
+            });
+        }
+        catch (error) {
+            this.metricsCollector?.logAudit({
+                level: 'error',
+                component: 'LayeredMemory',
+                operation: 'fact_extraction',
+                userId,
+                genomeId,
+                message: 'Failed to extract semantic facts',
+                duration: Date.now() - startTime,
+                metadata: {
+                    factsExtracted: 0,
+                    success: false,
+                },
+                error: error instanceof Error ? {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                } : {
+                    name: 'UnknownError',
+                    message: String(error),
+                },
+            });
+            console.warn('Failed to extract long-term facts:', error);
+        }
+    }
+    formatLongTermMemory(longTerm) {
+        const factsFormatted = longTerm.semanticFacts
+            .map(f => `- ${f.fact} (confidence: ${f.confidence.toFixed(2)}, verified: ${f.verified})`)
+            .join('\n');
+        return `# User Profile & Permanent Knowledge
+
+User Information:
+${JSON.stringify(longTerm.userProfile, null, 2)}
+
+Known Facts:
+${factsFormatted || 'No facts extracted yet'}
+
+Preferences:
+${JSON.stringify(longTerm.permanentPreferences, null, 2)}`;
+    }
+    formatMediumTermMemory(mediumTerm) {
+        return `# Conversation History Summary (${mediumTerm.periodStart.toLocaleDateString()} - ${mediumTerm.periodEnd.toLocaleDateString()})
+
+${mediumTerm.summary}
+
+(${mediumTerm.messageCount} messages summarized)`;
+    }
+    formatShortTermMemory(shortTerm) {
+        const messages = shortTerm.messages
+            .map(m => `User: ${m.userMessage}\nAssistant: ${m.assistantResponse}`)
+            .join('\n\n');
+        return `# Recent Conversation
+
+${messages}`;
+    }
+    async getMessageCount(userId, genomeId) {
+        const interactions = await this.getAllInteractions(userId, genomeId);
+        return interactions.length;
+    }
+    async getLastCompactionTime(userId, genomeId) {
+        const cacheKey = `${userId}:${genomeId}`;
+        return this.lastCompactionTimes.get(cacheKey) || new Date(0);
+    }
+    async setLastCompactionTime(userId, genomeId, time) {
+        const cacheKey = `${userId}:${genomeId}`;
+        this.lastCompactionTimes.set(cacheKey, time);
+    }
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+}
+//# sourceMappingURL=LayeredMemory.js.map

package/dist/memory/LayeredMemory.js.map

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

package/dist/memory-compaction/MemoryCompactor.d.ts

@@ -0,0 +1,18 @@
+import type { Conversation, CompactionConfig, CompactionResult, MemoryItem, PrioritizationOptions, ConversationSummary, CompactionStrategy } from './types.js';
+export declare class MemoryCompactor {
+    private config;
+    private strategies;
+    constructor(config?: Partial<CompactionConfig>);
+    shouldCompact(conversation: Conversation): boolean;
+    compactConversation(conversation: Conversation): Promise<CompactionResult>;
+    applyCompaction(conversation: Conversation, result: CompactionResult): Conversation;
+    extractEssentials(conversation: Conversation): ConversationSummary;
+    prioritizeMemory(items: MemoryItem[], options?: Partial<PrioritizationOptions>): MemoryItem[];
+    private calculateTotalTokens;
+    private estimateTokens;
+    private extractTopics;
+    getConfig(): CompactionConfig;
+    updateConfig(config: Partial<CompactionConfig>): void;
+    getAvailableStrategies(): CompactionStrategy[];
+}
+//# sourceMappingURL=MemoryCompactor.d.ts.map

package/dist/memory-compaction/MemoryCompactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCompactor.d.ts","sourceRoot":"","sources":["../../src/memory-compaction/MemoryCompactor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAEhB,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAErB,MAAM,YAAY,CAAC;AA6BpB,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAA+C;gBAErD,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAoB9C,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO;IAS5C,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAchF,eAAe,CACX,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,gBAAgB,GACzB,YAAY;IAoCf,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,mBAAmB;IAkElE,gBAAgB,CACZ,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACzC,UAAU,EAAE;IAkCf,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAyBrB,SAAS,IAAI,gBAAgB;IAO7B,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAUrD,sBAAsB,IAAI,kBAAkB,EAAE;CAGjD"}