@framers/agentos 0.1.181 → 0.1.182

package/dist/memory/core/types.d.ts

@@ -199,6 +199,103 @@ export interface MemoryHealthReport {
     tracesPerType: Record<MemoryType, number>;
     tracesPerScope: Record<MemoryScope, number>;
 }
+/**
+ * Serializable snapshot of the full memory graph for visualization.
+ * Contains nodes (traces), edges (associations), clusters, and aggregate stats.
+ * Used by wilds-ai companion sidebar, memory graph view, and devtools.
+ */
+export interface MemoryGraphSnapshot {
+    nodes: Array<{
+        id: string;
+        type: MemoryType;
+        content: string;
+        strength: number;
+        isFlashbulb: boolean;
+        createdAt: number;
+        lastAccessedAt: number;
+        retrievalCount: number;
+    }>;
+    edges: Array<{
+        sourceId: string;
+        targetId: string;
+        type: string;
+        weight: number;
+    }>;
+    clusters: Array<{
+        clusterId: string;
+        memberIds: string[];
+        density: number;
+    }>;
+    stats: {
+        nodeCount: number;
+        edgeCount: number;
+        clusterCount: number;
+    };
+}
+/**
+ * Observation pipeline health stats for devtools/monitoring.
+ * Exposes the state of the 3-tier pipeline: notes → compressed → reflected.
+ */
+export interface ObservationPipelineStats {
+    /** Number of raw observation notes pending compression. */
+    pendingNotes: number;
+    /** Number of compressed observations pending reflection. */
+    pendingCompressed: number;
+    /** Total observation notes produced since initialization. */
+    totalNotesProduced: number;
+    /** Total reflection cycles completed. */
+    totalReflectionsProduced: number;
+    /** Timestamp of last reflection cycle, or null if none. */
+    lastReflectionAt: number | null;
+    /** Average compression ratio (input tokens / output tokens). */
+    avgCompressionRatio: number;
+}
+/**
+ * Full exportable memory state for character portability across worlds.
+ * Used for companion export/import in wilds-ai.
+ */
+export interface CognitiveMemorySnapshot {
+    /** Snapshot format version. */
+    version: string;
+    /** Agent/entity ID that owns this memory. */
+    agentId: string;
+    /** All active memory traces. */
+    traces: MemoryTrace[];
+    /** Graph edges between traces. */
+    graphEdges: Array<{
+        sourceId: string;
+        targetId: string;
+        type: string;
+        weight: number;
+        createdAt: number;
+    }>;
+    /** Active prospective memory items. */
+    prospectiveItems: Array<{
+        id: string;
+        content: string;
+        triggerType: string;
+        importance: number;
+        triggered: boolean;
+        createdAt: number;
+    }>;
+    /** Snapshot metadata for import validation. */
+    metadata: {
+        exportedAt: number;
+        traceCount: number;
+        typeDistribution: Record<MemoryType, number>;
+    };
+}
+/** Strength distribution stats per memory type. */
+export interface MemoryTypeStats {
+    /** Total traces of this type. */
+    count: number;
+    /** Average encoding strength across traces. */
+    avgStrength: number;
+    /** Number of traces below 0.3 strength (fading). */
+    decaying: number;
+    /** Number of flashbulb-strength traces (above 0.8). */
+    flashbulb: number;
+}
 export type { EmbeddingConfig, ExtendedConsolidationConfig, IngestionConfig, MemoryConfig, RememberOptions, RecallOptions, IngestOptions, IngestResult, ExportOptions, ImportOptions, ImportResult, ConsolidationResult, MemoryHealth, LoadOptions, LoadedDocument, DocumentMetadata, DocumentChunk, ExtractedImage, ExtractedTable, } from '../io/facade/types.js';
 export type { CompactionEntry, CompactionInput, CompactionResult, ContextMessage, ICompactionStrategy, InfiniteContextConfig, SummaryChainNode, } from '../pipeline/context/types.js';
 //# sourceMappingURL=types.d.ts.map

package/dist/memory/core/types.d.ts.map

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

package/dist/memory/pipeline/observation/MemoryReflector.d.ts

@@ -15,9 +15,23 @@
 import type { MemoryTrace } from '../../core/types.js';
 import type { HexacoTraits, ReflectorConfig } from '../../core/config.js';
 import type { ObservationNote } from './MemoryObserver.js';
+/**
+ * Result of a reflection cycle.
+ *
+ * Contains the consolidated long-term traces (typed as episodic, semantic,
+ * procedural, prospective, or relational), any superseded trace IDs, the
+ * consumed note IDs, and the compression ratio achieved.
+ */
 export interface MemoryReflectionResult {
     /** New long-term memory traces to store. */
-    traces: Omit<MemoryTrace, 'id' | 'encodingStrength' | 'stability' | 'retrievalCount' | 'lastAccessedAt' | 'accessCount' | 'reinforcementInterval' | 'createdAt' | 'updatedAt'>[];
+    traces: (Omit<MemoryTrace, 'id' | 'encodingStrength' | 'stability' | 'retrievalCount' | 'lastAccessedAt' | 'accessCount' | 'reinforcementInterval' | 'createdAt' | 'updatedAt'> & {
+        /**
+         * Reflector's chain-of-thought reasoning for why this trace matters.
+         * Available for devtools/debugging; stripped before the trace is
+         * passed to `CognitiveMemoryManager.encode()` for storage.
+         */
+        reasoning?: string;
+    })[];
     /** IDs of existing traces that should be superseded. */
     supersededTraceIds: string[];
     /** IDs of observation notes that were consumed. */
@@ -46,6 +60,19 @@ export declare class MemoryReflector {
     getPendingNoteCount(): number;
     /** Clear all pending notes. */
     clear(): void;
+    /**
+     * Parse the LLM's reflection response into structured trace data.
+     *
+     * Handles:
+     * - Stripping `<thinking>...</thinking>` blocks (chain-of-thought reasoning)
+     * - Parsing one JSON object per line
+     * - Validating and normalizing type/scope enums
+     * - Preserving the optional `reasoning` field for devtools
+     * - Collecting superseded and consumed note IDs
+     *
+     * @param llmResponse - Raw LLM output containing optional thinking block + JSON lines
+     * @returns Parsed reflection result with typed traces
+     */
     private parseReflection;
 }
 //# sourceMappingURL=MemoryReflector.d.ts.map

package/dist/memory/pipeline/observation/MemoryReflector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryReflector.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/observation/MemoryReflector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAY,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,kBAAkB,GAAG,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,GAAG,uBAAuB,GAAG,WAAW,GAAG,WAAW,CAAC,EAAE,CAAC;IACjL,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mDAAmD;IACnD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAoDD,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAC,CAAgE;IACnF,OAAO,CAAC,MAAM,CAAkB;gBAG9B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAWnC;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAShF,iEAAiE;IACjE,cAAc,IAAI,OAAO;IAQzB;;OAEG;IACG,OAAO,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkC9E,8BAA8B;IAC9B,mBAAmB,IAAI,MAAM;IAI7B,+BAA+B;IAC/B,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,eAAe;CA+DxB"}
+{"version":3,"file":"MemoryReflector.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/observation/MemoryReflector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAY,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,kBAAkB,GAAG,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,GAAG,uBAAuB,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG;QAChL;;;;WAIG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,EAAE,CAAC;IACL,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mDAAmD;IACnD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAmGD,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAC,CAAgE;IACnF,OAAO,CAAC,MAAM,CAAkB;gBAG9B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAWnC;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAShF,iEAAiE;IACjE,cAAc,IAAI,OAAO;IAQzB;;OAEG;IACG,OAAO,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkC9E,8BAA8B;IAC9B,mBAAmB,IAAI,MAAM;IAI7B,+BAA+B;IAC/B,KAAK,IAAI,IAAI;IAMb;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;CA4ExB"}

package/dist/memory/pipeline/observation/MemoryReflector.js

@@ -15,31 +15,77 @@
 // ---------------------------------------------------------------------------
 // Personality-aware system prompt
 // ---------------------------------------------------------------------------
+/**
+ * Build a personality-biased system prompt for the memory reflector.
+ *
+ * Personality influences (grounded in HEXACO model of personality):
+ * - High honesty → prefer newer info over old on contradiction (source monitoring)
+ * - High agreeableness → keep both versions on contradiction (cognitive flexibility)
+ * - High conscientiousness → structured, categorized output (organizational encoding)
+ * - High openness → rich, associative output (spreading activation style)
+ * - High emotionality → heightened sensitivity to relational/emotional signals
+ * - High extraversion → captures social dynamics and group interactions
+ *
+ * The chain-of-thought `<thinking>` block asks the LLM to reason about
+ * each memory type before extraction, improving classification accuracy
+ * and ensuring relational signals are not overlooked.
+ *
+ * @param traits - HEXACO personality traits of the agent
+ * @returns System prompt string for the LLM reflector call
+ */
 function buildReflectorSystemPrompt(traits) {
     const clamp = (v) => v == null ? 0.5 : Math.max(0, Math.min(1, v));
+    // Conflict resolution strategy — mirrors source monitoring in cognitive psychology.
+    // High honesty agents trust newer information; high agreeableness agents preserve both.
     const conflictStrategy = clamp(traits.honesty) > 0.6
         ? 'When you detect a contradiction with existing knowledge, prefer the newer information and flag the old memory for supersession.'
         : clamp(traits.agreeableness) > 0.6
             ? 'When you detect a contradiction, keep both versions and note the discrepancy.'
             : 'When you detect a contradiction, keep the version with higher confidence.';
+    // Memory organization style — mirrors encoding specificity principle.
     const memoryStyle = clamp(traits.conscientiousness) > 0.6
         ? 'Produce structured, well-organized memory traces with clear categories.'
         : clamp(traits.openness) > 0.6
             ? 'Produce rich, associative memory traces that capture connections and context.'
             : 'Produce concise, factual memory traces focused on key information.';
+    // Relational sensitivity — emotionality and agreeableness heighten
+    // detection of trust signals, boundary events, and social cues.
+    const relationalEmphases = [];
+    if (clamp(traits.emotionality) > 0.6) {
+        relationalEmphases.push('Pay special attention to emotional subtleties, vulnerability signals, and shifts in emotional tone — these are important relational memories.');
+    }
+    if (clamp(traits.agreeableness) > 0.6) {
+        relationalEmphases.push('Notice rapport cues, harmony signals, and moments of mutual understanding.');
+    }
+    if (clamp(traits.extraversion) > 0.6) {
+        relationalEmphases.push('Capture social dynamics, group interactions, and interpersonal energy shifts.');
+    }
+    const relationalBlock = relationalEmphases.length > 0
+        ? `\n\nRelational sensitivity:\n${relationalEmphases.map((e) => `- ${e}`).join('\n')}`
+        : '';
     return `You are a memory reflector. Your job is to consolidate observation notes into long-term memory traces.
 
+Before producing traces, reason step by step inside <thinking> tags:
+1. What new FACTS did the user reveal? (semantic)
+2. What EVENTS happened worth remembering? (episodic)
+3. What PATTERNS or PREFERENCES emerged? (procedural)
+4. What FUTURE INTENTIONS were expressed? (prospective)
+5. What RELATIONSHIP SIGNALS appeared — vulnerability, trust, conflict, warmth? (relational)
+6. Do any of these CONTRADICT existing memories? If so, which is more reliable?
+7. What can be MERGED from multiple notes into a single trace?
+
 Rules:
 1. Merge redundant or overlapping observations into single traces
-2. Assign each trace a type: "episodic" (events), "semantic" (facts/knowledge), "procedural" (how-to), or "prospective" (future goals/intentions)
+2. Assign each trace a type: "episodic" (events/experiences), "semantic" (facts/knowledge), "procedural" (how-to/patterns), "prospective" (future intentions/reminders), or "relational" (trust signals, boundary events, emotional bonds, relationship shifts)
 3. Assign a scope: "user" (about the user), "thread" (conversation-specific), "persona" (about the agent), or "organization" (shared)
 4. ${conflictStrategy}
 5. ${memoryStyle}
-6. Target 5-40x compression: many notes → few high-quality traces
+6. Target 5-40x compression: many notes → few high-quality traces${relationalBlock}
 
-For each trace, output a JSON object on its own line:
+After your <thinking> block, output JSON objects, one per line:
 {
-  "type": "episodic|semantic|procedural|prospective",
+  "reasoning": "brief explanation of why this trace matters",
+  "type": "episodic|semantic|procedural|prospective|relational",
   "scope": "user|thread|persona|organization",
   "scopeId": "relevant_id",
   "content": "consolidated memory content",
@@ -51,7 +97,7 @@ For each trace, output a JSON object on its own line:
   "consumedNotes": ["note_id1", "note_id2"]
 }
 
-Output ONLY valid JSON objects, one per line.`;
+Output your <thinking> block first, then ONLY valid JSON objects, one per line.`;
 }
 // ---------------------------------------------------------------------------
 // MemoryReflector
@@ -123,20 +169,41 @@ export class MemoryReflector {
         this.pendingNotes = [];
     }
     // --- Internal ---
+    /**
+     * Parse the LLM's reflection response into structured trace data.
+     *
+     * Handles:
+     * - Stripping `<thinking>...</thinking>` blocks (chain-of-thought reasoning)
+     * - Parsing one JSON object per line
+     * - Validating and normalizing type/scope enums
+     * - Preserving the optional `reasoning` field for devtools
+     * - Collecting superseded and consumed note IDs
+     *
+     * @param llmResponse - Raw LLM output containing optional thinking block + JSON lines
+     * @returns Parsed reflection result with typed traces
+     */
     parseReflection(llmResponse) {
         const traces = [];
         const supersededTraceIds = [];
         const consumedNoteIds = [];
-        const lines = llmResponse.split('\n').filter((l) => l.trim());
+        // Strip <thinking>...</thinking> blocks before parsing JSON lines.
+        // The thinking block contains the reflector's chain-of-thought reasoning
+        // which is useful for debugging but not part of the trace data.
+        const cleaned = llmResponse.replace(/<thinking>[\s\S]*?<\/thinking>/gi, '');
+        const lines = cleaned.split('\n').filter((l) => l.trim());
         const now = Date.now();
         for (const line of lines) {
             try {
                 const parsed = JSON.parse(line.trim());
                 if (!parsed.content)
                     continue;
+                // Validate memory type — defaults to 'semantic' for unrecognized types.
+                // All 5 Tulving-extended types are accepted: episodic, semantic,
+                // procedural, prospective, and relational.
                 const type = (['episodic', 'semantic', 'procedural', 'prospective', 'relational'].includes(parsed.type)
                     ? parsed.type
                     : 'semantic');
+                // Validate memory scope — defaults to 'user' for unrecognized scopes.
                 const scope = (['user', 'thread', 'persona', 'organization'].includes(parsed.scope)
                     ? parsed.scope
                     : 'user');
@@ -162,6 +229,9 @@ export class MemoryReflector {
                     },
                     associatedTraceIds: [],
                     isActive: true,
+                    // Preserve reasoning for devtools — CognitiveMemoryManager strips
+                    // this before passing to encode() since it's not part of MemoryTrace.
+                    reasoning: typeof parsed.reasoning === 'string' ? parsed.reasoning : undefined,
                 });
                 if (Array.isArray(parsed.supersedes)) {
                     supersededTraceIds.push(...parsed.supersedes);
@@ -171,10 +241,12 @@ export class MemoryReflector {
                 }
             }
             catch {
-                // Skip malformed lines
+                // Skip malformed lines — common when LLM outputs markdown fences or commentary
             }
         }
-        // If no specific notes were claimed, consider all pending consumed
+        // If no specific notes were claimed, consider all pending consumed.
+        // This handles the case where the LLM omits consumedNotes fields
+        // but still produces valid traces from the input notes.
         if (consumedNoteIds.length === 0 && traces.length > 0) {
             consumedNoteIds.push(...this.pendingNotes.map((n) => n.id));
         }

package/dist/memory/pipeline/observation/MemoryReflector.js.map

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

package/dist/memory/retrieval/hyde/MemoryHydeRetriever.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Memory-specific HyDE (Hypothetical Document Embedding) retriever.
+ *
+ * Improves memory recall for vague or abstract queries by generating a
+ * hypothetical memory trace BEFORE embedding. The hypothesis is closer
+ * in embedding space to actual stored traces than the raw query.
+ *
+ * Cognitive science grounding: this mirrors the "generation effect" —
+ * generating information about a topic activates related neural pathways
+ * more strongly than passive recognition. By generating what a memory
+ * WOULD look like, we activate the right retrieval pathways.
+ *
+ * Effective for:
+ * - Abstract queries ("that deployment discussion")
+ * - Emotional recall ("when they were upset")
+ * - Temporal queries ("something from last week")
+ * - Vague references ("the thing about cats")
+ *
+ * Auto-attached by CognitiveMemoryManager when any LLM invoker is available.
+ * Remains opt-in per query via `options.hyde: true` on `retrieve()`.
+ *
+ * @module agentos/memory/retrieval/hyde/MemoryHydeRetriever
+ * @see {@link CognitiveMemoryManager.retrieve} — consumes the hypothesis
+ */
+/** LLM invoker function signature matching AgentOS observer/reflector convention. */
+type LlmInvoker = (systemPrompt: string, userPrompt: string) => Promise<string>;
+/**
+ * Memory-specific HyDE retriever that generates hypothetical memory traces.
+ *
+ * Implements the same `generateHypothesis()` interface expected by
+ * CognitiveMemoryManager so it can be assigned via `setHydeRetriever()`.
+ *
+ * Lightweight: uses `maxTokens: 150` with no chain-of-thought. Target
+ * latency is under 500ms with a fast model.
+ *
+ * @example
+ * ```ts
+ * const retriever = new MemoryHydeRetriever(llmInvoker);
+ * const result = await retriever.generateHypothesis('what does the user like?');
+ * // result.hypothesis = "User mentioned they enjoy hiking and cooking..."
+ * ```
+ */
+export declare class MemoryHydeRetriever {
+    private readonly llmInvoker;
+    /**
+     * @param llmInvoker - Function that calls an LLM with (systemPrompt, userPrompt).
+     *   Typically reused from the observer, reflector, or feature detection config.
+     */
+    constructor(llmInvoker: LlmInvoker);
+    /**
+     * Generate a hypothetical memory trace for a recall query.
+     *
+     * The generated hypothesis is used as the embedding input for vector
+     * search, producing results that are more semantically aligned with
+     * actual stored traces.
+     *
+     * Returns the same shape as `HydeRetriever.generateHypothesis()` so
+     * CognitiveMemoryManager can use it interchangeably.
+     *
+     * @param query - The recall query (e.g., "what does the user do for work?")
+     * @returns Object with `hypothesis` text and `latencyMs` timing
+     */
+    generateHypothesis(query: string): Promise<{
+        hypothesis: string;
+        latencyMs: number;
+    }>;
+}
+export {};
+//# sourceMappingURL=MemoryHydeRetriever.d.ts.map

package/dist/memory/retrieval/hyde/MemoryHydeRetriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryHydeRetriever.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/hyde/MemoryHydeRetriever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,qFAAqF;AACrF,KAAK,UAAU,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAuBhF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;;OAGG;gBACS,UAAU,EAAE,UAAU;IAIlC;;;;;;;;;;;;OAYG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAa5F"}

package/dist/memory/retrieval/hyde/MemoryHydeRetriever.js

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview Memory-specific HyDE (Hypothetical Document Embedding) retriever.
+ *
+ * Improves memory recall for vague or abstract queries by generating a
+ * hypothetical memory trace BEFORE embedding. The hypothesis is closer
+ * in embedding space to actual stored traces than the raw query.
+ *
+ * Cognitive science grounding: this mirrors the "generation effect" —
+ * generating information about a topic activates related neural pathways
+ * more strongly than passive recognition. By generating what a memory
+ * WOULD look like, we activate the right retrieval pathways.
+ *
+ * Effective for:
+ * - Abstract queries ("that deployment discussion")
+ * - Emotional recall ("when they were upset")
+ * - Temporal queries ("something from last week")
+ * - Vague references ("the thing about cats")
+ *
+ * Auto-attached by CognitiveMemoryManager when any LLM invoker is available.
+ * Remains opt-in per query via `options.hyde: true` on `retrieve()`.
+ *
+ * @module agentos/memory/retrieval/hyde/MemoryHydeRetriever
+ * @see {@link CognitiveMemoryManager.retrieve} — consumes the hypothesis
+ */
+/**
+ * System prompt for hypothesis generation.
+ *
+ * Instructs the LLM to output what a STORED memory trace would look like,
+ * not to answer the query. This produces embeddings that are semantically
+ * closer to actual stored traces than raw recall queries.
+ */
+const HYDE_SYSTEM_PROMPT = `You are a memory system. Given a recall query, generate what a stored memory trace about this topic would look like. Write it as a first-person observation note, 1-2 sentences, as if you recorded it when it happened.
+
+Do NOT answer the query. Generate what the STORED MEMORY would say.
+
+Examples:
+Query: "what does the user do for work?"
+Hypothesis: "User mentioned they are a software engineer working on backend systems at a startup."
+
+Query: "when were they upset?"
+Hypothesis: "User expressed frustration and stress about a missed deadline. Emotional tone was tense."
+
+Query: "that thing about cats"
+Hypothesis: "User talked about having two cats named Luna and Mochi. They seem important to the user."`;
+/**
+ * Memory-specific HyDE retriever that generates hypothetical memory traces.
+ *
+ * Implements the same `generateHypothesis()` interface expected by
+ * CognitiveMemoryManager so it can be assigned via `setHydeRetriever()`.
+ *
+ * Lightweight: uses `maxTokens: 150` with no chain-of-thought. Target
+ * latency is under 500ms with a fast model.
+ *
+ * @example
+ * ```ts
+ * const retriever = new MemoryHydeRetriever(llmInvoker);
+ * const result = await retriever.generateHypothesis('what does the user like?');
+ * // result.hypothesis = "User mentioned they enjoy hiking and cooking..."
+ * ```
+ */
+export class MemoryHydeRetriever {
+    /**
+     * @param llmInvoker - Function that calls an LLM with (systemPrompt, userPrompt).
+     *   Typically reused from the observer, reflector, or feature detection config.
+     */
+    constructor(llmInvoker) {
+        this.llmInvoker = llmInvoker;
+    }
+    /**
+     * Generate a hypothetical memory trace for a recall query.
+     *
+     * The generated hypothesis is used as the embedding input for vector
+     * search, producing results that are more semantically aligned with
+     * actual stored traces.
+     *
+     * Returns the same shape as `HydeRetriever.generateHypothesis()` so
+     * CognitiveMemoryManager can use it interchangeably.
+     *
+     * @param query - The recall query (e.g., "what does the user do for work?")
+     * @returns Object with `hypothesis` text and `latencyMs` timing
+     */
+    async generateHypothesis(query) {
+        const start = Date.now();
+        try {
+            const hypothesis = await this.llmInvoker(HYDE_SYSTEM_PROMPT, `Query: "${query}"`);
+            return {
+                hypothesis: hypothesis.trim(),
+                latencyMs: Date.now() - start,
+            };
+        }
+        catch {
+            // HyDE is non-critical — return empty hypothesis to fall through to raw query
+            return { hypothesis: '', latencyMs: Date.now() - start };
+        }
+    }
+}
+//# sourceMappingURL=MemoryHydeRetriever.js.map

package/dist/memory/retrieval/hyde/MemoryHydeRetriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryHydeRetriever.js","sourceRoot":"","sources":["../../../../src/memory/retrieval/hyde/MemoryHydeRetriever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;uGAY4E,CAAC;AAExG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAmB;IAG9B;;;OAGG;IACH,YAAY,UAAsB;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAAa;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,WAAW,KAAK,GAAG,CAAC,CAAC;YAClF,OAAO;gBACL,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE;gBAC7B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC9B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;YAC9E,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAC3D,CAAC;IACH,CAAC;CACF"}

package/dist/memory/retrieval/store/MemoryStore.d.ts

@@ -40,7 +40,22 @@ export declare class MemoryStore {
     private knownScopes;
     /** Optional cognitive mechanisms engine for retrieval-time hooks. */
     private mechanismsEngine?;
+    /**
+     * Optional SqliteBrain for durable write-through persistence.
+     * When set, store/softDelete/recordAccess also write to the brain's SQL tables.
+     * The in-memory vector index remains the hot read path (fast); the brain is
+     * the durable backing store that survives process restarts.
+     */
+    private brain;
     constructor(config: MemoryStoreConfig);
+    /**
+     * Attach a SqliteBrain for durable write-through persistence.
+     * Once attached, all store/softDelete/recordAccess operations also
+     * write to the brain's `memory_traces` table.
+     *
+     * @param brain - SqliteBrain instance (already initialized with schema)
+     */
+    setBrain(brain: import('./SqliteBrain.js').SqliteBrain): void;
     /**
      * Store a new memory trace: embed content, upsert into vector store,
      * and record as episodic memory in the knowledge graph.

package/dist/memory/retrieval/store/MemoryStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryStore.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/store/MemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AAYxC,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,YAAY,CAAC;IAC1B,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,cAAc,EAAE,eAAe,CAAC;IAChC,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,+CAA+C,EAAE,yBAAyB,CAAC;IACrG,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,QAAQ,CAAC;CAC/B;AAwED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAc;IAC3B,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAAuC;IACzD,oFAAoF;IACpF,OAAO,CAAC,cAAc,CAAoC;IAC1D,kGAAkG;IAClG,OAAO,CAAC,WAAW,CAAmE;IACtF,qEAAqE;IACrE,OAAO,CAAC,gBAAgB,CAAC,CAAoF;gBAEjG,MAAM,EAAE,iBAAiB;IAUrC;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE9C;;OAEG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,QAAQ,EACrB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAAC,OAAO,EAAE,uBAAuB,EAAE,CAAA;KAAE,CAAC;IAmG/E;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAuD1E;;;;;;;;;OASG;IACG,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuDhG;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAQ7B;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,WAAW,EAAE;IAoBjB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,cAAc;CAGvB"}
+{"version":3,"file":"MemoryStore.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/store/MemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AAYxC,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,YAAY,CAAC;IAC1B,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,cAAc,EAAE,eAAe,CAAC;IAChC,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,+CAA+C,EAAE,yBAAyB,CAAC;IACrG,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,QAAQ,CAAC;CAC/B;AAwED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAc;IAC3B,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAAuC;IACzD,oFAAoF;IACpF,OAAO,CAAC,cAAc,CAAoC;IAC1D,kGAAkG;IAClG,OAAO,CAAC,WAAW,CAAmE;IACtF,qEAAqE;IACrE,OAAO,CAAC,gBAAgB,CAAC,CAAoF;IAC7G;;;;;OAKG;IACH,OAAO,CAAC,KAAK,CAAuD;gBAExD,MAAM,EAAE,iBAAiB;IAMrC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,kBAAkB,EAAE,WAAW,GAAG,IAAI;IAQ7D;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuG9C;;OAEG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,QAAQ,EACrB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAAC,OAAO,EAAE,uBAAuB,EAAE,CAAA;KAAE,CAAC;IAmG/E;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAmE1E;;;;;;;;;OASG;IACG,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuDhG;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAQ7B;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,WAAW,EAAE;IAoBjB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,cAAc;CAGvB"}