@cognitive-engine/memory 0.1.0

package/dist/episode-extractor.d.ts

@@ -0,0 +1,15 @@
+import type { LlmProvider, EmbeddingProvider, Episode } from '@cognitive-engine/core';
+/**
+ * Extracts episodic memories from user messages using LLM analysis.
+ */
+export declare class EpisodeExtractor {
+    private readonly llm;
+    private readonly embedding;
+    constructor(llm: LlmProvider, embedding: EmbeddingProvider);
+    /**
+     * Analyze a message and extract an episode if present.
+     * Returns null if the message doesn't contain a personal episode.
+     */
+    extract(userId: string, message: string, occurredAt?: Date): Promise<Episode | null>;
+}
+//# sourceMappingURL=episode-extractor.d.ts.map

package/dist/episode-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-extractor.d.ts","sourceRoot":"","sources":["../src/episode-extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,OAAO,EACR,MAAM,wBAAwB,CAAA;AAoC/B;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,iBAAiB;IAG/C;;;OAGG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,IAAI,GAChB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAsC3B"}

package/dist/episode-extractor.js

@@ -0,0 +1,67 @@
+import { uid } from '@cognitive-engine/core';
+import { clamp } from '@cognitive-engine/math';
+const EXTRACTION_PROMPT = `Analyze the following message and determine if it contains a personal episode (event, experience, story).
+Respond ONLY with valid JSON (no markdown, no code blocks):
+
+{
+  "hasEpisode": true/false,
+  "summary": "one-line summary",
+  "details": "key details",
+  "participants": ["person names"],
+  "location": "place or null",
+  "emotions": ["emotion labels"],
+  "emotionalValence": -1 to 1,
+  "emotionalIntensity": 0 to 1,
+  "category": "work|personal|health|relationship|finance|education|hobby|other",
+  "tags": ["relevant tags"],
+  "importance": 0 to 1
+}
+
+If the message is not a personal episode (greetings, questions, commands), set hasEpisode=false and leave other fields with defaults.`;
+/**
+ * Extracts episodic memories from user messages using LLM analysis.
+ */
+export class EpisodeExtractor {
+    llm;
+    embedding;
+    constructor(llm, embedding) {
+        this.llm = llm;
+        this.embedding = embedding;
+    }
+    /**
+     * Analyze a message and extract an episode if present.
+     * Returns null if the message doesn't contain a personal episode.
+     */
+    async extract(userId, message, occurredAt) {
+        const response = await this.llm.completeJson([
+            { role: 'system', content: EXTRACTION_PROMPT },
+            { role: 'user', content: message },
+        ], { temperature: 0, maxTokens: 500 });
+        const result = response.parsed;
+        if (!result.hasEpisode)
+            return null;
+        const now = new Date();
+        const vector = await this.embedding.embed(`${result.summary}. ${result.details}`);
+        return {
+            id: uid('ep'),
+            userId,
+            summary: result.summary ?? '',
+            details: result.details ?? '',
+            participants: result.participants ?? [],
+            location: result.location,
+            occurredAt: occurredAt ?? now,
+            reportedAt: now,
+            emotionalValence: clamp(result.emotionalValence ?? 0, -1, 1),
+            emotionalIntensity: clamp(result.emotionalIntensity ?? 0, 0, 1),
+            emotions: result.emotions ?? [],
+            category: result.category ?? 'other',
+            tags: result.tags ?? [],
+            importance: clamp(result.importance ?? 0.5, 0, 1),
+            accessCount: 0,
+            decayFactor: 0.03,
+            embedding: vector,
+            createdAt: now,
+        };
+    }
+}
+//# sourceMappingURL=episode-extractor.js.map

package/dist/episode-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-extractor.js","sourceRoot":"","sources":["../src/episode-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAA;AAM5C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAgB9C,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;sIAiB4G,CAAA;AAEtI;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,GAAgB,EAChB,SAA4B;QAD5B,QAAG,GAAH,GAAG,CAAa;QAChB,cAAS,GAAT,SAAS,CAAmB;IAC5C,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,OAAO,CACX,MAAc,EACd,OAAe,EACf,UAAiB;QAEjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAC1C;YACE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE;YAC9C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;SACnC,EACD,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CACnC,CAAA;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;QAC9B,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,IAAI,CAAA;QAEnC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CACvC,GAAG,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,EAAE,CACvC,CAAA;QAED,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC;YACb,MAAM;YACN,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,UAAU,IAAI,GAAG;YAC7B,UAAU,EAAE,GAAG;YACf,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5D,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/D,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO;YACpC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;YACvB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACjD,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,GAAG;SACf,CAAA;IACH,CAAC;CACF"}

package/dist/episodic-memory.d.ts

@@ -0,0 +1,31 @@
+import type { Store, EmbeddingProvider, Episode, EpisodeSearchResult, EpisodeQuery, EpisodicContext, ConsolidationResult, MemoryConfig } from '@cognitive-engine/core';
+/**
+ * Episodic memory with semantic search, exponential decay, and consolidation.
+ *
+ * Uses embeddings + cosine similarity for relevance search.
+ * Combines relevance, recency, and importance for final scoring.
+ */
+export declare class EpisodicMemory {
+    private readonly store;
+    private readonly embedding;
+    private readonly config;
+    constructor(store: Store, embedding: EmbeddingProvider, config?: MemoryConfig);
+    /** Store a new episode. */
+    storeEpisode(episode: Episode): Promise<void>;
+    /** Retrieve a specific episode by ID. */
+    get(episodeId: string): Promise<Episode | null>;
+    /** Search episodes with semantic + temporal scoring. */
+    search(query: EpisodeQuery): Promise<EpisodeSearchResult[]>;
+    /** Build episodic context for the reasoning layer. */
+    getContext(userId: string, currentQuery?: string): Promise<EpisodicContext>;
+    /**
+     * Consolidate memories: apply decay, delete forgotten episodes.
+     */
+    consolidate(userId: string): Promise<ConsolidationResult>;
+    /** Mark an episode as accessed (boosts importance). */
+    recordAccess(episodeId: string): Promise<void>;
+    private fetchCandidates;
+    private computeRelevanceScores;
+    private detectEmotionalPattern;
+}
+//# sourceMappingURL=episodic-memory.d.ts.map

package/dist/episodic-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episodic-memory.d.ts","sourceRoot":"","sources":["../src/episodic-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,iBAAiB,EACjB,OAAO,EACP,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,YAAY,EACb,MAAM,wBAAwB,CAAA;AA8B/B;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAG3C,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,iBAAiB,EAC5B,MAAM,GAAE,YAAiB;IAkB3B,2BAA2B;IACrB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,yCAAyC;IACnC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIrD,wDAAwD;IAClD,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA6CjE,sDAAsD;IAChD,UAAU,CACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC;IA8B3B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqC/D,uDAAuD;IACjD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAYtC,eAAe;YA2Cf,sBAAsB;IAmBpC,OAAO,CAAC,sBAAsB;CA8B/B"}

package/dist/episodic-memory.js

@@ -0,0 +1,238 @@
+import { cosineSimilarity, exponentialDecay } from '@cognitive-engine/math';
+const COLLECTION = 'episodes';
+const MS_PER_DAY = 1000 * 60 * 60 * 24;
+const ACCESS_BOOST_PER_VIEW = 0.1;
+const MAX_ACCESS_BOOST = 0.5;
+const CONSOLIDATION_AGE_DAYS = 30;
+const FORGOTTEN_THRESHOLD = 0.1;
+const MIN_ACCESS_TO_KEEP = 2;
+const CONSOLIDATION_DECAY_FACTOR = 0.01;
+const DEFAULT_CONFIG = {
+    decayLambda: 0.03,
+    scoringWeights: { relevance: 0.4, recency: 0.3, importance: 0.3 },
+    similarityThreshold: 0.7,
+    categories: [],
+    maxRecentEpisodes: 5,
+    maxRelevantEpisodes: 3,
+};
+/**
+ * Episodic memory with semantic search, exponential decay, and consolidation.
+ *
+ * Uses embeddings + cosine similarity for relevance search.
+ * Combines relevance, recency, and importance for final scoring.
+ */
+export class EpisodicMemory {
+    store;
+    embedding;
+    config;
+    constructor(store, embedding, config = {}) {
+        this.store = store;
+        this.embedding = embedding;
+        this.config = {
+            decayLambda: config.decayLambda ?? DEFAULT_CONFIG.decayLambda,
+            scoringWeights: {
+                relevance: config.scoringWeights?.relevance ?? DEFAULT_CONFIG.scoringWeights.relevance,
+                recency: config.scoringWeights?.recency ?? DEFAULT_CONFIG.scoringWeights.recency,
+                importance: config.scoringWeights?.importance ?? DEFAULT_CONFIG.scoringWeights.importance,
+            },
+            similarityThreshold: config.similarityThreshold ?? DEFAULT_CONFIG.similarityThreshold,
+            categories: config.categories ?? DEFAULT_CONFIG.categories,
+            maxRecentEpisodes: config.maxRecentEpisodes ?? DEFAULT_CONFIG.maxRecentEpisodes,
+            maxRelevantEpisodes: config.maxRelevantEpisodes ?? DEFAULT_CONFIG.maxRelevantEpisodes,
+        };
+    }
+    /** Store a new episode. */
+    async storeEpisode(episode) {
+        await this.store.set(COLLECTION, episode.id, episode);
+    }
+    /** Retrieve a specific episode by ID. */
+    async get(episodeId) {
+        return this.store.get(COLLECTION, episodeId);
+    }
+    /** Search episodes with semantic + temporal scoring. */
+    async search(query) {
+        const now = Date.now();
+        const relevance = this.config.scoringWeights.relevance;
+        const recency = this.config.scoringWeights.recency;
+        const importance = this.config.scoringWeights.importance;
+        // Fetch candidate episodes
+        const candidates = await this.fetchCandidates(query);
+        // Compute relevance scores via embedding similarity
+        const relevanceScores = await this.computeRelevanceScores(query.query, candidates);
+        // Score and rank
+        const results = [];
+        for (const ep of candidates) {
+            const daysSince = (now - ep.occurredAt.getTime()) / MS_PER_DAY;
+            const recencyScore = exponentialDecay(daysSince, ep.decayFactor);
+            const relevanceScore = relevanceScores.get(ep.id) ?? 0.5;
+            const accessBoost = Math.min(ep.accessCount * ACCESS_BOOST_PER_VIEW, MAX_ACCESS_BOOST);
+            const importanceScore = Math.min(ep.importance + accessBoost, 1);
+            const combinedScore = relevanceScore * relevance +
+                recencyScore * recency +
+                importanceScore * importance;
+            // Skip "forgotten" episodes unless explicitly requested
+            if (!query.includeDecayed && recencyScore < 0.1)
+                continue;
+            results.push({
+                episode: ep,
+                relevanceScore,
+                recencyScore,
+                importanceScore,
+                combinedScore,
+            });
+        }
+        results.sort((a, b) => b.combinedScore - a.combinedScore);
+        return results.slice(0, query.limit ?? this.config.maxRelevantEpisodes);
+    }
+    /** Build episodic context for the reasoning layer. */
+    async getContext(userId, currentQuery) {
+        // Recent episodes
+        const recentResults = await this.store.find(COLLECTION, {
+            where: { userId },
+            orderBy: { occurredAt: 'desc' },
+            limit: this.config.maxRecentEpisodes,
+        });
+        // Relevant episodes (semantic search)
+        let relevantEpisodes = [];
+        if (currentQuery) {
+            const searchResults = await this.search({
+                userId,
+                query: currentQuery,
+                limit: this.config.maxRelevantEpisodes,
+            });
+            relevantEpisodes = searchResults.map((r) => r.episode);
+        }
+        // Detect dominant emotional pattern
+        const allEpisodes = [...recentResults, ...relevantEpisodes];
+        const emotionalPattern = this.detectEmotionalPattern(allEpisodes);
+        return {
+            recentEpisodes: recentResults,
+            relevantEpisodes,
+            emotionalPattern,
+        };
+    }
+    /**
+     * Consolidate memories: apply decay, delete forgotten episodes.
+     */
+    async consolidate(userId) {
+        const now = Date.now();
+        const episodes = await this.store.find(COLLECTION, {
+            where: { userId },
+        });
+        let decayedCount = 0;
+        let deletedCount = 0;
+        for (const ep of episodes) {
+            const daysSince = (now - ep.occurredAt.getTime()) / MS_PER_DAY;
+            if (daysSince < CONSOLIDATION_AGE_DAYS)
+                continue;
+            const newImportance = ep.importance * exponentialDecay(daysSince, ep.decayFactor * CONSOLIDATION_DECAY_FACTOR);
+            if (newImportance < FORGOTTEN_THRESHOLD && ep.accessCount < MIN_ACCESS_TO_KEEP) {
+                // Forget this episode
+                await this.store.delete(COLLECTION, ep.id);
+                deletedCount++;
+            }
+            else if (newImportance < ep.importance) {
+                // Decay importance
+                await this.store.set(COLLECTION, ep.id, {
+                    ...ep,
+                    importance: newImportance,
+                });
+                decayedCount++;
+            }
+        }
+        return {
+            decayedCount,
+            deletedCount,
+            remainingCount: episodes.length - deletedCount,
+        };
+    }
+    /** Mark an episode as accessed (boosts importance). */
+    async recordAccess(episodeId) {
+        const ep = await this.store.get(COLLECTION, episodeId);
+        if (!ep)
+            return;
+        await this.store.set(COLLECTION, episodeId, {
+            ...ep,
+            accessCount: ep.accessCount + 1,
+            lastAccessed: new Date(),
+        });
+    }
+    // ── Private ──
+    async fetchCandidates(query) {
+        const where = { userId: query.userId };
+        if (query.categories && query.categories.length > 0) {
+            // Store doesn't support $in, filter post-fetch
+        }
+        const episodes = await this.store.find(COLLECTION, {
+            where,
+            orderBy: { occurredAt: 'desc' },
+            limit: (query.limit ?? this.config.maxRelevantEpisodes) * 3,
+        });
+        return episodes.filter((ep) => {
+            if (query.categories &&
+                query.categories.length > 0 &&
+                !query.categories.includes(ep.category)) {
+                return false;
+            }
+            if (query.emotions &&
+                query.emotions.length > 0 &&
+                !ep.emotions.some((e) => query.emotions.includes(e))) {
+                return false;
+            }
+            if (query.timeRange?.from && ep.occurredAt < query.timeRange.from) {
+                return false;
+            }
+            if (query.timeRange?.to && ep.occurredAt > query.timeRange.to) {
+                return false;
+            }
+            if (query.minImportance !== undefined &&
+                ep.importance < query.minImportance) {
+                return false;
+            }
+            return true;
+        });
+    }
+    async computeRelevanceScores(queryText, episodes) {
+        const scores = new Map();
+        if (!queryText || episodes.length === 0)
+            return scores;
+        const queryVec = await this.embedding.embed(queryText);
+        for (const ep of episodes) {
+            if (ep.embedding && ep.embedding.length > 0) {
+                const similarity = cosineSimilarity(queryVec, ep.embedding);
+                scores.set(ep.id, Math.max(0, similarity));
+            }
+        }
+        return scores;
+    }
+    detectEmotionalPattern(episodes) {
+        if (episodes.length === 0)
+            return 'neutral';
+        const emotionCounts = new Map();
+        let totalValence = 0;
+        for (const ep of episodes) {
+            totalValence += ep.emotionalValence;
+            for (const emotion of ep.emotions) {
+                emotionCounts.set(emotion, (emotionCounts.get(emotion) ?? 0) + 1);
+            }
+        }
+        const avgValence = totalValence / episodes.length;
+        // Find dominant emotion
+        let dominantEmotion = 'neutral';
+        let maxCount = 0;
+        for (const [emotion, count] of emotionCounts) {
+            if (count > maxCount) {
+                maxCount = count;
+                dominantEmotion = emotion;
+            }
+        }
+        if (avgValence > 0.3)
+            return `positive (${dominantEmotion})`;
+        if (avgValence < -0.3)
+            return `negative (${dominantEmotion})`;
+        if (dominantEmotion !== 'neutral')
+            return dominantEmotion;
+        return 'neutral';
+    }
+}
+//# sourceMappingURL=episodic-memory.js.map

package/dist/episodic-memory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { EpisodicMemory } from './episodic-memory.js';
+export { EpisodeExtractor } from './episode-extractor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { EpisodicMemory } from './episodic-memory.js';
+export { EpisodeExtractor } from './episode-extractor.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@cognitive-engine/memory",
+  "version": "0.1.0",
+  "description": "Episodic memory with decay, semantic search, and consolidation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@cognitive-engine/core": "*",
+    "@cognitive-engine/math": "*"
+  },
+  "license": "Apache-2.0",
+  "author": "Dmitry Zorin",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/medonomator/cognitive-engine.git",
+    "directory": "packages/memory"
+  },
+  "homepage": "https://github.com/medonomator/cognitive-engine/tree/main/packages/memory",
+  "publishConfig": {
+    "access": "public"
+  }
+}