psychmem 1.0.0

package/dist/index.js

@@ -0,0 +1,191 @@
+/**
+ * PsychMem - Main Entry Point
+ *
+ * Psych-grounded selective memory system for AI agents
+ *
+ * Usage:
+ *   psychmem hook <json-input>    Process a hook event
+ *   psychmem search <query>       Search memories
+ *   psychmem get <id>             Get memory details
+ *   psychmem stats                Show memory stats
+ *   psychmem decay                Apply decay to all memories
+ *   psychmem consolidate          Run STM→LTM consolidation
+ */
+import { PsychMemHooks, createPsychMemHooks } from './hooks/index.js';
+import { MemoryRetrieval } from './retrieval/index.js';
+import { MemoryDatabase, createMemoryDatabase } from './storage/database.js';
+import { DEFAULT_CONFIG } from './types/index.js';
+export class PsychMem {
+    hooks;
+    retrieval;
+    db;
+    config;
+    initialized = false;
+    _externalDb;
+    constructor(config = {}, db) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        if (db) {
+            this._externalDb = db;
+        }
+    }
+    /**
+     * Initialize the PsychMem instance (must be called before use)
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        this.db = this._externalDb ?? await createMemoryDatabase(this.config);
+        this.hooks = await createPsychMemHooks(this.config, this.db);
+        this.retrieval = new MemoryRetrieval(this.db, this.config);
+        this.initialized = true;
+    }
+    /**
+     * Ensure instance is initialized
+     */
+    ensureInit() {
+        if (!this.initialized) {
+            throw new Error('PsychMem not initialized. Call await psychmem.init() first.');
+        }
+    }
+    /**
+     * Process a hook event
+     */
+    async handleHook(input) {
+        this.ensureInit();
+        return this.hooks.handle(input);
+    }
+    /**
+     * Search memories
+     */
+    search(query, limit) {
+        this.ensureInit();
+        return this.retrieval.search(query, undefined, limit);
+    }
+    /**
+     * Get memory by ID
+     */
+    getMemory(id) {
+        this.ensureInit();
+        return this.retrieval.getMemory(id);
+    }
+    /**
+     * Get memory details for multiple IDs
+     */
+    getMemories(ids, sessionId) {
+        this.ensureInit();
+        return this.retrieval.retrieveDetails(ids, sessionId);
+    }
+    /**
+     * Get memory stats
+     */
+    getStats() {
+        this.ensureInit();
+        const stmActive = this.db.getMemoriesByStore('stm', 'active');
+        const ltmActive = this.db.getMemoriesByStore('ltm', 'active');
+        const stmDecayed = this.db.getMemoriesByStore('stm', 'decayed');
+        const ltmDecayed = this.db.getMemoriesByStore('ltm', 'decayed');
+        const stmPinned = this.db.getMemoriesByStore('stm', 'pinned');
+        const ltmPinned = this.db.getMemoriesByStore('ltm', 'pinned');
+        return {
+            stm: {
+                count: stmActive.length,
+                decayedCount: stmDecayed.length,
+                pinnedCount: stmPinned.length,
+                avgStrength: this.avgStrength(stmActive),
+            },
+            ltm: {
+                count: ltmActive.length,
+                decayedCount: ltmDecayed.length,
+                pinnedCount: ltmPinned.length,
+                avgStrength: this.avgStrength(ltmActive),
+            },
+            total: stmActive.length + ltmActive.length,
+            totalIncludingDecayed: stmActive.length + ltmActive.length +
+                stmDecayed.length + ltmDecayed.length +
+                stmPinned.length + ltmPinned.length,
+        };
+    }
+    /**
+     * List memories, optionally filtered by store and/or status
+     */
+    listMemories(options = {}) {
+        this.ensureInit();
+        const { store, status = 'active', limit = 50 } = options;
+        if (store) {
+            return this.db.getMemoriesByStore(store, status).slice(0, limit);
+        }
+        const stm = this.db.getMemoriesByStore('stm', status);
+        const ltm = this.db.getMemoriesByStore('ltm', status);
+        return [...ltm, ...stm]
+            .sort((a, b) => b.strength - a.strength)
+            .slice(0, limit);
+    }
+    /**
+     * Apply decay to all memories
+     */
+    applyDecay() {
+        this.ensureInit();
+        return this.db.applyDecay();
+    }
+    /**
+     * Run consolidation
+     */
+    runConsolidation() {
+        this.ensureInit();
+        return this.db.runConsolidation();
+    }
+    /**
+     * Pin a memory (prevent decay)
+     */
+    pinMemory(id) {
+        this.ensureInit();
+        this.db.addFeedback('pin', id);
+    }
+    /**
+     * Forget a memory
+     */
+    forgetMemory(id) {
+        this.ensureInit();
+        this.db.addFeedback('forget', id);
+    }
+    /**
+     * Remember a memory (boost importance + promote to LTM)
+     */
+    rememberMemory(id) {
+        this.ensureInit();
+        this.db.addFeedback('remember', id);
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        if (this.initialized) {
+            this.db.close();
+            this.hooks.close();
+        }
+    }
+    avgStrength(memories) {
+        if (memories.length === 0)
+            return 0;
+        return memories.reduce((sum, m) => sum + m.strength, 0) / memories.length;
+    }
+}
+/**
+ * Create and initialize a PsychMem instance
+ */
+export async function createPsychMem(config = {}, db) {
+    const psychmem = new PsychMem(config, db);
+    await psychmem.init();
+    return psychmem;
+}
+// Re-export types and utilities
+export * from './types/index.js';
+export { PsychMemHooks, createPsychMemHooks } from './hooks/index.js';
+export { MemoryRetrieval } from './retrieval/index.js';
+export { MemoryDatabase, createMemoryDatabase } from './storage/database.js';
+export { ContextSweep } from './memory/context-sweep.js';
+export { SelectiveMemory } from './memory/selective-memory.js';
+// Re-export adapters
+export { createOpenCodePlugin, OpenCodeAdapter } from './adapters/opencode/index.js';
+export { ClaudeCodeAdapter, createClaudeCodeAdapter } from './adapters/claude-code/index.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":"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"}

package/dist/memory/context-sweep.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Context Sweep - Stage 1 of the selective memory pipeline
+ *
+ * v1.5: Now includes:
+ * - Multilingual keyword patterns (15 languages)
+ * - Structural/pragmatic signal detection (language-agnostic)
+ * - Unified classification with confidence differentiation
+ *
+ * Extracts memory candidates from raw events by detecting:
+ * - Importance signals (emphasis, corrections, repetitions)
+ * - Classification (bugfix, learning, decision, etc.)
+ * - Preliminary relevance scoring
+ *
+ * This is the CRITICAL component - without good extraction, the rest collapses.
+ */
+import type { Event, MemoryCandidate, SweepConfig } from '../types/index.js';
+export declare class ContextSweep {
+    private config;
+    private structuralAnalyzer;
+    constructor(config?: Partial<SweepConfig>);
+    /**
+     * Extract memory candidates from a list of events
+     */
+    extractCandidates(events: Event[]): MemoryCandidate[];
+    /**
+     * Extract candidates from conversation text (Stop event)
+     * This is a comprehensive analysis of the full conversation
+     *
+     * v1.5: Now uses multilingual patterns + structural signals
+     */
+    private extractFromConversationText;
+    /**
+     * Detect the role (user/assistant/tool) from chunk prefix
+     */
+    private detectChunkRole;
+    /**
+     * Check if chunk contains tool error indicators
+     */
+    private chunkHasToolError;
+    /**
+     * Get extraction method description
+     */
+    private getExtractionMethod;
+    /**
+     * Split content into semantic chunks for analysis.
+     *
+     * Strategies (tried in order):
+     * 1. Double-newline paragraphs (standard prose)
+     * 2. Conversation turns (Human:/Assistant: prefixed lines from extractConversationText)
+     * 3. Sentences
+     * 4. Whole content as single chunk
+     */
+    private splitIntoChunks;
+    /**
+     * Extract candidate from a user prompt
+     * v1.5: Now uses multilingual patterns + structural signals
+     */
+    private extractFromUserPrompt;
+    /**
+     * Extract candidates from tool events (bugs, fixes, learnings)
+     * v1.5: Now uses multilingual patterns
+     */
+    private extractFromToolEvents;
+    /**
+     * Detect repeated concepts/requests across events
+     */
+    private detectRepetitions;
+    /**
+     * Classify content into a memory classification
+     * v1.5: Uses multilingual patterns first, then structural heuristics
+     */
+    private classifyContentMultilingual;
+    /**
+     * Generate a concise summary for a memory candidate
+     * v1.5: Considers structural signals in summary selection
+     */
+    private generateSummary;
+    /**
+     * Format summary with classification prefix
+     */
+    private formatSummary;
+    /**
+     * Generate summary for tool events
+     */
+    private generateToolSummary;
+    /**
+     * Get emoji for classification
+     */
+    private getClassificationEmoji;
+    /**
+     * Calculate preliminary importance from signals
+     */
+    private calculatePreliminaryImportance;
+    /**
+     * Extract key concepts from content (simple keyword extraction)
+     */
+    private extractKeyConcepts;
+    /**
+     * Deduplicate and merge similar candidates
+     */
+    private deduplicateCandidates;
+    /**
+     * Simple similarity calculation (Jaccard index on words)
+     */
+    private calculateSimilarity;
+}
+//# sourceMappingURL=context-sweep.d.ts.map

package/dist/memory/context-sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-sweep.d.ts","sourceRoot":"","sources":["../../src/memory/context-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EAIf,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAS3B,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAK7C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE;IAwCrD;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IA+EnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAkDvB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAoD7B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA6C7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAuCnC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAiBtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+C7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAS5B"}