@mce-bt/microagents-memory 0.1.0

package/dist/mtm.js

@@ -0,0 +1,139 @@
+import pg from 'pg';
+const { Pool } = pg;
+/**
+ * Mid-Term Memory (MTM) — PostgreSQL-backed episodic summaries.
+ *
+ * Stores session summaries and recent episode timeline.
+ * Tagged by domain/topic for efficient querying.
+ * "What happened recently regarding X?"
+ */
+export class MidTermMemory {
+    pool = null;
+    config;
+    agentId = '';
+    constructor(config) {
+        this.config = config;
+    }
+    async start(agentId) {
+        this.agentId = agentId;
+        this.pool = new Pool({ connectionString: this.config.connectionString });
+        await this.ensureSchema();
+    }
+    async stop() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    async ensureSchema() {
+        if (!this.pool)
+            return;
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS mtm_episodes (
+        id TEXT PRIMARY KEY,
+        agent_id TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        summary TEXT NOT NULL,
+        tags TEXT[] DEFAULT '{}',
+        domain TEXT,
+        started_at TIMESTAMPTZ NOT NULL,
+        ended_at TIMESTAMPTZ,
+        metadata JSONB DEFAULT '{}',
+        created_at TIMESTAMPTZ DEFAULT NOW()
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_mtm_agent_id ON mtm_episodes(agent_id);
+      CREATE INDEX IF NOT EXISTS idx_mtm_domain ON mtm_episodes(domain);
+      CREATE INDEX IF NOT EXISTS idx_mtm_tags ON mtm_episodes USING GIN(tags);
+      CREATE INDEX IF NOT EXISTS idx_mtm_started_at ON mtm_episodes(started_at DESC);
+    `);
+    }
+    /**
+     * Store a session summary as an episodic memory.
+     */
+    async storeSummary(episode) {
+        if (!this.pool)
+            throw new Error('MTM not started');
+        const id = `ep-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        await this.pool.query(`INSERT INTO mtm_episodes (id, agent_id, session_id, summary, tags, domain, started_at, ended_at, metadata)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)`, [
+            id,
+            episode.agentId,
+            episode.sessionId,
+            episode.summary,
+            episode.tags,
+            episode.domain,
+            episode.startedAt,
+            episode.endedAt,
+            JSON.stringify(episode.metadata),
+        ]);
+        return id;
+    }
+    /**
+     * Get recent episodes, optionally filtered by domain or tags.
+     */
+    async getRecent(options = {}) {
+        if (!this.pool)
+            throw new Error('MTM not started');
+        const conditions = [];
+        const params = [];
+        let idx = 1;
+        // Default to current agent
+        conditions.push(`agent_id = $${idx}`);
+        params.push(options.agentId ?? this.agentId);
+        idx++;
+        if (options.domain) {
+            conditions.push(`domain = $${idx}`);
+            params.push(options.domain);
+            idx++;
+        }
+        if (options.tags && options.tags.length > 0) {
+            conditions.push(`tags && $${idx}`);
+            params.push(options.tags);
+            idx++;
+        }
+        if (options.sinceDate) {
+            conditions.push(`started_at >= $${idx}`);
+            params.push(options.sinceDate);
+            idx++;
+        }
+        const limit = options.limit ?? 20;
+        const where = conditions.join(' AND ');
+        const result = await this.pool.query(`SELECT * FROM mtm_episodes WHERE ${where} ORDER BY started_at DESC LIMIT $${idx}`, [...params, limit]);
+        return result.rows.map(this.rowToEpisode);
+    }
+    /**
+     * Get a specific episode by ID.
+     */
+    async getById(id) {
+        if (!this.pool)
+            throw new Error('MTM not started');
+        const result = await this.pool.query('SELECT * FROM mtm_episodes WHERE id = $1', [id]);
+        if (result.rows.length === 0)
+            return null;
+        return this.rowToEpisode(result.rows[0]);
+    }
+    /**
+     * Delete an episode.
+     */
+    async delete(id) {
+        if (!this.pool)
+            throw new Error('MTM not started');
+        await this.pool.query('DELETE FROM mtm_episodes WHERE id = $1', [id]);
+    }
+    rowToEpisode(row) {
+        return {
+            id: row.id,
+            agentId: row.agent_id,
+            sessionId: row.session_id,
+            summary: row.summary,
+            tags: row.tags,
+            domain: row.domain,
+            startedAt: new Date(row.started_at),
+            endedAt: row.ended_at ? new Date(row.ended_at) : null,
+            metadata: (row.metadata ?? {}),
+            createdAt: new Date(row.created_at),
+        };
+    }
+}
+//# sourceMappingURL=mtm.js.map

package/dist/mtm.js.map

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

package/dist/stm.d.ts

@@ -0,0 +1,55 @@
+import type { MemoryEntry } from '@mce-bt/microagents-core';
+export interface STMConfig {
+    redisUrl: string;
+    /** TTL for session data in seconds (default: 24 hours) */
+    sessionTtlS?: number;
+    /** Maximum entries per session before automatic truncation */
+    maxEntriesPerSession?: number;
+}
+/**
+ * Short-Term Memory (STM) — Redis-backed session log.
+ *
+ * Stores detailed, session-scoped interaction logs:
+ * messages, events, errors, plans, tool calls/results.
+ * Cross-agent within a session. TTL-based expiration.
+ */
+export declare class ShortTermMemory {
+    private redis;
+    private config;
+    private agentId;
+    private sessionTtlS;
+    private maxEntriesPerSession;
+    constructor(config: STMConfig);
+    start(agentId: string): Promise<void>;
+    stop(): Promise<void>;
+    private sessionKey;
+    /**
+     * Log an entry to the session's short-term memory.
+     */
+    log(sessionId: string, entry: Omit<MemoryEntry, 'id' | 'sessionId' | 'agentId' | 'timestamp'>): Promise<void>;
+    /**
+     * Get the full session log.
+     */
+    getSessionLog(sessionId: string): Promise<MemoryEntry[]>;
+    /**
+     * Get the most recent N entries from a session.
+     */
+    getRecentEntries(sessionId: string, count: number): Promise<MemoryEntry[]>;
+    /**
+     * Get session entries filtered by type.
+     */
+    getEntriesByType(sessionId: string, type: MemoryEntry['type']): Promise<MemoryEntry[]>;
+    /**
+     * Delete all entries for a session.
+     */
+    clearSession(sessionId: string): Promise<void>;
+    /**
+     * Check if a session exists in STM.
+     */
+    sessionExists(sessionId: string): Promise<boolean>;
+    /**
+     * Get the entry count for a session.
+     */
+    getSessionLength(sessionId: string): Promise<number>;
+}
+//# sourceMappingURL=stm.d.ts.map

package/dist/stm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stm.d.ts","sourceRoot":"","sources":["../src/stm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,MAAM,EAAE,SAAS;IAMvB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnH;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAO9D;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOhF;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK5F;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxD;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI3D"}

package/dist/stm.js

@@ -0,0 +1,105 @@
+import { Redis } from 'ioredis';
+/**
+ * Short-Term Memory (STM) — Redis-backed session log.
+ *
+ * Stores detailed, session-scoped interaction logs:
+ * messages, events, errors, plans, tool calls/results.
+ * Cross-agent within a session. TTL-based expiration.
+ */
+export class ShortTermMemory {
+    redis = null;
+    config;
+    agentId = '';
+    sessionTtlS;
+    maxEntriesPerSession;
+    constructor(config) {
+        this.config = config;
+        this.sessionTtlS = config.sessionTtlS ?? 86400; // 24h
+        this.maxEntriesPerSession = config.maxEntriesPerSession ?? 1000;
+    }
+    async start(agentId) {
+        this.agentId = agentId;
+        this.redis = new Redis(this.config.redisUrl);
+    }
+    async stop() {
+        if (this.redis) {
+            this.redis.disconnect();
+            this.redis = null;
+        }
+    }
+    sessionKey(sessionId) {
+        return `stm:${sessionId}`;
+    }
+    /**
+     * Log an entry to the session's short-term memory.
+     */
+    async log(sessionId, entry) {
+        if (!this.redis)
+            throw new Error('STM not started');
+        const fullEntry = {
+            ...entry,
+            id: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            sessionId,
+            agentId: this.agentId,
+            timestamp: new Date(),
+        };
+        const key = this.sessionKey(sessionId);
+        await this.redis.rpush(key, JSON.stringify(fullEntry));
+        await this.redis.expire(key, this.sessionTtlS);
+        // Trim to max entries (keep most recent)
+        const length = await this.redis.llen(key);
+        if (length > this.maxEntriesPerSession) {
+            await this.redis.ltrim(key, length - this.maxEntriesPerSession, -1);
+        }
+    }
+    /**
+     * Get the full session log.
+     */
+    async getSessionLog(sessionId) {
+        if (!this.redis)
+            throw new Error('STM not started');
+        const raw = await this.redis.lrange(this.sessionKey(sessionId), 0, -1);
+        return raw.map((r) => JSON.parse(r));
+    }
+    /**
+     * Get the most recent N entries from a session.
+     */
+    async getRecentEntries(sessionId, count) {
+        if (!this.redis)
+            throw new Error('STM not started');
+        const raw = await this.redis.lrange(this.sessionKey(sessionId), -count, -1);
+        return raw.map((r) => JSON.parse(r));
+    }
+    /**
+     * Get session entries filtered by type.
+     */
+    async getEntriesByType(sessionId, type) {
+        const all = await this.getSessionLog(sessionId);
+        return all.filter((e) => e.type === type);
+    }
+    /**
+     * Delete all entries for a session.
+     */
+    async clearSession(sessionId) {
+        if (!this.redis)
+            throw new Error('STM not started');
+        await this.redis.del(this.sessionKey(sessionId));
+    }
+    /**
+     * Check if a session exists in STM.
+     */
+    async sessionExists(sessionId) {
+        if (!this.redis)
+            throw new Error('STM not started');
+        return (await this.redis.exists(this.sessionKey(sessionId))) === 1;
+    }
+    /**
+     * Get the entry count for a session.
+     */
+    async getSessionLength(sessionId) {
+        if (!this.redis)
+            throw new Error('STM not started');
+        return this.redis.llen(this.sessionKey(sessionId));
+    }
+}
+//# sourceMappingURL=stm.js.map

package/dist/stm.js.map

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

package/dist/summarization-pipeline.d.ts

@@ -0,0 +1,78 @@
+import type { MemoryManager } from './manager.js';
+import type { MemoryExtractor, ExtractionStats } from './memory-extractor.js';
+export interface SummarizationPipelineConfig {
+    /**
+     * LLM function used to generate session summaries.
+     * Takes a conversation log as input, returns a concise summary.
+     */
+    summarizeFn: (text: string) => Promise<string>;
+    /**
+     * Minimum number of STM entries before a session qualifies
+     * for summarization (default: 5).
+     */
+    minEntries?: number;
+    /**
+     * Whether to run knowledge extraction after summarization
+     * (default: true).
+     */
+    extractKnowledge?: boolean;
+    /**
+     * Whether to use contradiction-aware extraction
+     * (default: true).
+     */
+    contradictionAware?: boolean;
+    /**
+     * Whether to clear the STM session after summarization
+     * (default: false — we keep the raw log for the current session).
+     */
+    clearStmAfterSummarize?: boolean;
+}
+export interface PipelineResult {
+    sessionId: string;
+    summarized: boolean;
+    episodeId?: string;
+    summary?: string;
+    extraction?: ExtractionStats;
+    skippedReason?: string;
+}
+/**
+ * Auto-Summarization Pipeline — moves knowledge up the memory tiers.
+ *
+ * STM (session log)  →  MTM (episode summary)  →  LTM (knowledge graph)
+ *
+ * This pipeline:
+ * 1. Reads the current session from STM
+ * 2. Uses an LLM to produce a concise summary → stores in MTM
+ * 3. Extracts entities/relations from the session → stores in KG (LTM)
+ *
+ * Can be triggered manually, on session close, or by a cron/heartbeat.
+ */
+export declare class SummarizationPipeline {
+    private manager;
+    private extractor;
+    private config;
+    private logger?;
+    constructor(manager: MemoryManager, extractor: MemoryExtractor | null, config: SummarizationPipelineConfig, logger?: SummarizationPipeline['logger']);
+    /**
+     * Process a single session: summarize → store episode → extract knowledge.
+     */
+    processSession(sessionId: string, options?: {
+        tags?: string[];
+        domain?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<PipelineResult>;
+    /**
+     * Process multiple sessions in batch.
+     * Useful for cron jobs that sweep up all completed sessions.
+     */
+    processSessions(sessionIds: string[], options?: {
+        tags?: string[];
+        domain?: string;
+    }): Promise<PipelineResult[]>;
+    /**
+     * Build context from entities mentioned in the session entries.
+     * Used for contradiction-aware extraction.
+     */
+    private buildEntityContext;
+}
+//# sourceMappingURL=summarization-pipeline.d.ts.map

package/dist/summarization-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarization-pipeline.d.ts","sourceRoot":"","sources":["../src/summarization-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI9E,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAEuC;IACrD,OAAO,CAAC,MAAM,CAAC,CAKb;gBAGA,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,eAAe,GAAG,IAAI,EACjC,MAAM,EAAE,2BAA2B,EACnC,MAAM,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC;IAc1C;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GACL,OAAO,CAAC,cAAc,CAAC;IAiF1B;;;OAGG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,cAAc,EAAE,CAAC;IAS5B;;;OAGG;YACW,kBAAkB;CA8CjC"}

package/dist/summarization-pipeline.js

@@ -0,0 +1,155 @@
+/**
+ * Auto-Summarization Pipeline — moves knowledge up the memory tiers.
+ *
+ * STM (session log)  →  MTM (episode summary)  →  LTM (knowledge graph)
+ *
+ * This pipeline:
+ * 1. Reads the current session from STM
+ * 2. Uses an LLM to produce a concise summary → stores in MTM
+ * 3. Extracts entities/relations from the session → stores in KG (LTM)
+ *
+ * Can be triggered manually, on session close, or by a cron/heartbeat.
+ */
+export class SummarizationPipeline {
+    manager;
+    extractor;
+    config;
+    logger;
+    constructor(manager, extractor, config, logger) {
+        this.manager = manager;
+        this.extractor = extractor;
+        this.config = {
+            summarizeFn: config.summarizeFn,
+            minEntries: config.minEntries ?? 5,
+            extractKnowledge: config.extractKnowledge ?? true,
+            contradictionAware: config.contradictionAware ?? true,
+            clearStmAfterSummarize: config.clearStmAfterSummarize ?? false,
+        };
+        this.logger = logger;
+    }
+    /**
+     * Process a single session: summarize → store episode → extract knowledge.
+     */
+    async processSession(sessionId, options = {}) {
+        const result = { sessionId, summarized: false };
+        // 1. Load STM entries
+        const entries = await this.manager.stm.getSessionLog(sessionId);
+        if (entries.length < this.config.minEntries) {
+            result.skippedReason = `Only ${entries.length} entries (min: ${this.config.minEntries})`;
+            this.logger?.debug('Session skipped', {
+                sessionId,
+                reason: result.skippedReason,
+            });
+            return result;
+        }
+        // 2. Generate summary via LLM
+        const logText = entries
+            .map((e) => {
+            const ts = new Date(e.timestamp).toISOString();
+            return `[${ts}] [${e.type}] ${e.content}`;
+        })
+            .join('\n');
+        const summary = await this.config.summarizeFn(logText);
+        // 3. Store in MTM as an episode
+        const episodeId = await this.manager.summarizeSession(sessionId, summary, {
+            tags: options.tags,
+            domain: options.domain,
+            metadata: options.metadata,
+        });
+        result.summarized = true;
+        result.episodeId = episodeId;
+        result.summary = summary;
+        this.logger?.info('Session summarized', {
+            sessionId,
+            episodeId,
+            entryCount: entries.length,
+        });
+        // 4. Extract knowledge into KG (if enabled and extractor available)
+        if (this.config.extractKnowledge && this.extractor) {
+            try {
+                let extractionStats;
+                if (this.config.contradictionAware) {
+                    // Build existing context for contradiction-aware extraction
+                    const existingContext = await this.buildEntityContext(entries);
+                    extractionStats = await this.extractor.extractWithContradictions(entries, existingContext || undefined);
+                }
+                else {
+                    extractionStats = await this.extractor.extractFromEntries(entries);
+                }
+                result.extraction = extractionStats;
+                this.logger?.info('Knowledge extracted from session', {
+                    sessionId,
+                    ...extractionStats,
+                });
+            }
+            catch (err) {
+                this.logger?.error('Knowledge extraction failed', {
+                    sessionId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        // 5. Optionally clear STM
+        if (this.config.clearStmAfterSummarize) {
+            await this.manager.stm.clearSession(sessionId);
+            this.logger?.debug('STM cleared after summarization', { sessionId });
+        }
+        return result;
+    }
+    /**
+     * Process multiple sessions in batch.
+     * Useful for cron jobs that sweep up all completed sessions.
+     */
+    async processSessions(sessionIds, options = {}) {
+        const results = [];
+        for (const sessionId of sessionIds) {
+            const result = await this.processSession(sessionId, options);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Build context from entities mentioned in the session entries.
+     * Used for contradiction-aware extraction.
+     */
+    async buildEntityContext(entries) {
+        if (!this.manager.kg)
+            return null;
+        // Extract potential entity names from entries (simple heuristic)
+        const kg = this.manager.kg;
+        const text = entries
+            .map((e) => e.content ?? '')
+            .join(' ');
+        // Quick search for entities matching terms in the text
+        const words = [...new Set(text.split(/[\s,;:!?.]+/).filter((w) => w.length > 2))];
+        // Check top words against KG (limit to avoid N+1)
+        const candidates = words.slice(0, 20);
+        const matchedEntities = [];
+        for (const word of candidates) {
+            const found = await kg.searchEntities({ query: word, limit: 1 });
+            if (found.length > 0) {
+                matchedEntities.push(found[0].name);
+            }
+        }
+        if (matchedEntities.length === 0)
+            return null;
+        // Build context text from matched entities
+        const contextParts = [];
+        for (const name of [...new Set(matchedEntities)]) {
+            const entity = await kg.getEntityByName(name);
+            if (!entity)
+                continue;
+            const relations = await kg.getEntityRelations(name);
+            const lines = [
+                `Entity: ${entity.name} (${entity.entityType})`,
+                `Observations: ${entity.observations.join('; ')}`,
+            ];
+            if (relations.length > 0) {
+                lines.push(`Relations: ${relations.map((r) => `${r.fromName} -[${r.relationType}]-> ${r.toName}`).join(', ')}`);
+            }
+            contextParts.push(lines.join('\n'));
+        }
+        return contextParts.join('\n\n');
+    }
+}
+//# sourceMappingURL=summarization-pipeline.js.map

package/dist/summarization-pipeline.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@mce-bt/microagents-memory",
+  "version": "0.1.0",
+  "description": "3-tier memory system — STM (Redis), MTM (Postgres), LTM (Postgres + pgvector)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "ioredis": "^5.4.0",
+    "pg": "^8.13.0",
+    "pgvector": "^0.2.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.0"
+  },
+  "peerDependencies": {
+    "@mce-bt/microagents-observability": "^0.1.0",
+    "@mce-bt/microagents-completion": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@mce-bt/microagents-observability": {
+      "optional": true
+    },
+    "@mce-bt/microagents-completion": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cavillo/microagents.git",
+    "directory": "packages/memory"
+  },
+  "homepage": "https://github.com/cavillo/microagents#readme",
+  "bugs": {
+    "url": "https://github.com/cavillo/microagents/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}