@framers/agentos 0.1.125 → 0.1.127

package/dist/memory/core/prompt/MemoryFormatters.js

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview Personality-specific memory formatting.
+ *
+ * Formats MemoryTrace objects into text appropriate for prompt injection,
+ * with style adapted to the agent's personality:
+ * - **structured** (high conscientiousness): bullet lists with metadata
+ * - **narrative** (high openness): flowing prose with associations
+ * - **emotional** (high emotionality): includes emotional context annotations
+ *
+ * @module agentos/memory/prompt/MemoryFormatters
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function timeAgo(timestampMs) {
+    const elapsed = Date.now() - timestampMs;
+    const minutes = Math.floor(elapsed / 60000);
+    if (minutes < 1)
+        return 'just now';
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    if (days < 7)
+        return `${days}d ago`;
+    const weeks = Math.floor(days / 7);
+    return `${weeks}w ago`;
+}
+function confidenceLabel(confidence) {
+    if (confidence > 0.8)
+        return 'high confidence';
+    if (confidence > 0.5)
+        return 'moderate confidence';
+    return 'low confidence';
+}
+function valenceEmoji(valence) {
+    if (valence > 0.3)
+        return '(+)';
+    if (valence < -0.3)
+        return '(-)';
+    return '(~)';
+}
+// ---------------------------------------------------------------------------
+// Formatters
+// ---------------------------------------------------------------------------
+function formatStructured(trace) {
+    const parts = [
+        `- [${trace.type}]`,
+        trace.content.substring(0, 300),
+    ];
+    const meta = [];
+    meta.push(timeAgo(trace.createdAt));
+    meta.push(confidenceLabel(trace.provenance.confidence));
+    meta.push(`relevance: ${(trace.retrievalScore ?? trace.provenance.confidence).toFixed(2)}`);
+    if (trace.tags.length > 0) {
+        meta.push(`tags: ${trace.tags.slice(0, 3).join(', ')}`);
+    }
+    parts.push(`(${meta.join(' | ')})`);
+    return parts.join(' ');
+}
+function formatNarrative(trace) {
+    const time = timeAgo(trace.createdAt);
+    const content = trace.content.substring(0, 350);
+    let text = `${time}: ${content}`;
+    if (trace.associatedTraceIds.length > 0) {
+        text += ` [linked to ${trace.associatedTraceIds.length} other memories]`;
+    }
+    if (trace.entities.length > 0) {
+        text += ` (involves: ${trace.entities.slice(0, 3).join(', ')})`;
+    }
+    return text;
+}
+function formatEmotional(trace) {
+    const time = timeAgo(trace.createdAt);
+    const emoji = valenceEmoji(trace.emotionalContext.valence);
+    const content = trace.content.substring(0, 300);
+    const intensity = trace.emotionalContext.intensity;
+    let text = `${emoji} ${time}: ${content}`;
+    if (intensity > 0.6) {
+        text += ` [strongly felt, mood: ${trace.emotionalContext.gmiMood}]`;
+    }
+    else if (intensity > 0.3) {
+        text += ` [mood: ${trace.emotionalContext.gmiMood}]`;
+    }
+    return text;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Format a single memory trace according to the given style.
+ */
+export function formatMemoryTrace(trace, style) {
+    switch (style) {
+        case 'structured':
+            return formatStructured(trace);
+        case 'narrative':
+            return formatNarrative(trace);
+        case 'emotional':
+            return formatEmotional(trace);
+        default:
+            return formatStructured(trace);
+    }
+}
+/**
+ * Format multiple traces with a separator appropriate for the style.
+ */
+export function formatMemoryTraces(traces, style) {
+    return traces.map((t) => formatMemoryTrace(t, style)).join('\n');
+}
+//# sourceMappingURL=MemoryFormatters.js.map

package/dist/memory/core/prompt/MemoryFormatters.js.map

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

package/dist/memory/core/prompt/MemoryPromptAssembler.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Token-budgeted memory prompt assembly.
+ *
+ * Carves a token budget from the PromptEngine's RAG context allocation
+ * and distributes it across memory sections:
+ * - Working memory scratchpad
+ * - Semantic recall results
+ * - Recent episodic memories
+ * - Prospective alerts (Batch 2)
+ * - Graph associations (Batch 2)
+ * - Observation notes (Batch 2)
+ *
+ * @module agentos/memory/prompt/MemoryPromptAssembler
+ */
+import type { MemoryBudgetAllocation, AssembledMemoryContext, ScoredMemoryTrace } from '../types.js';
+import type { HexacoTraits } from '../config.js';
+export interface MemoryAssemblerInput {
+    /** Token budget for all memory context. */
+    totalTokenBudget: number;
+    /** Budget allocation percentages. */
+    allocation?: Partial<MemoryBudgetAllocation>;
+    /** HEXACO traits for formatting style selection. */
+    traits: HexacoTraits;
+    /** Working memory formatted string. */
+    workingMemoryText?: string;
+    /** Scored semantic/episodic traces from retrieval. */
+    retrievedTraces?: ScoredMemoryTrace[];
+    /** Prospective memory alerts (Batch 2). */
+    prospectiveAlerts?: string[];
+    /** Graph association context (Batch 2). */
+    graphContext?: string[];
+    /** Observation notes (Batch 2). */
+    observationNotes?: string[];
+    /** Persistent markdown memory (MEMORY.md contents). */
+    persistentMemoryText?: string;
+    /** Optional cognitive mechanisms engine for involuntary recall. */
+    mechanismsEngine?: import('../../mechanisms/CognitiveMechanismsEngine.js').CognitiveMechanismsEngine;
+    /** All available traces for involuntary recall pool. */
+    allTraces?: import('../types.js').MemoryTrace[];
+}
+/**
+ * Assemble memory context into a single formatted string within
+ * the given token budget, with overflow redistribution.
+ */
+export declare function assembleMemoryContext(input: MemoryAssemblerInput): AssembledMemoryContext;
+//# sourceMappingURL=MemoryPromptAssembler.d.ts.map

package/dist/memory/core/prompt/MemoryPromptAssembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryPromptAssembler.d.ts","sourceRoot":"","sources":["../../../../src/memory/core/prompt/MemoryPromptAssembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAmCjD,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7C,oDAAoD;IACpD,MAAM,EAAE,YAAY,CAAC;IAGrB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,eAAe,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACtC,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAG9B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,+CAA+C,EAAE,yBAAyB,CAAC;IACrG,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,aAAa,EAAE,WAAW,EAAE,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,sBAAsB,CAsKzF"}

package/dist/memory/core/prompt/MemoryPromptAssembler.js

@@ -0,0 +1,205 @@
+/**
+ * @fileoverview Token-budgeted memory prompt assembly.
+ *
+ * Carves a token budget from the PromptEngine's RAG context allocation
+ * and distributes it across memory sections:
+ * - Working memory scratchpad
+ * - Semantic recall results
+ * - Recent episodic memories
+ * - Prospective alerts (Batch 2)
+ * - Graph associations (Batch 2)
+ * - Observation notes (Batch 2)
+ *
+ * @module agentos/memory/prompt/MemoryPromptAssembler
+ */
+import { DEFAULT_BUDGET_ALLOCATION } from '../config.js';
+import { formatMemoryTrace } from './MemoryFormatters.js';
+// ---------------------------------------------------------------------------
+// Token estimation
+// ---------------------------------------------------------------------------
+/** Rough token estimate: ~4 chars per token for English text. */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// ---------------------------------------------------------------------------
+// Personality → formatting style
+// ---------------------------------------------------------------------------
+const clamp01 = (v) => v == null ? 0.5 : Math.max(0, Math.min(1, v));
+function selectFormattingStyle(traits) {
+    const c = clamp01(traits.conscientiousness);
+    const o = clamp01(traits.openness);
+    const e = clamp01(traits.emotionality);
+    // Highest trait wins
+    if (c >= o && c >= e)
+        return 'structured';
+    if (o >= c && o >= e)
+        return 'narrative';
+    return 'emotional';
+}
+/**
+ * Assemble memory context into a single formatted string within
+ * the given token budget, with overflow redistribution.
+ */
+export function assembleMemoryContext(input) {
+    const alloc = {
+        ...DEFAULT_BUDGET_ALLOCATION,
+        ...input.allocation,
+    };
+    const budget = input.totalTokenBudget;
+    const style = selectFormattingStyle(input.traits);
+    // Compute per-section budgets
+    const pmBudget = Math.floor(budget * alloc.persistentMemory);
+    const wmBudget = Math.floor(budget * alloc.workingMemory);
+    let semanticBudget = Math.floor(budget * alloc.semanticRecall);
+    const episodicBudget = Math.floor(budget * alloc.recentEpisodic);
+    const prospectiveBudget = Math.floor(budget * alloc.prospectiveAlerts);
+    const graphBudget = Math.floor(budget * alloc.graphAssociations);
+    const observationBudget = Math.floor(budget * alloc.observationNotes);
+    const sections = [];
+    const includedIds = [];
+    let totalTokens = 0;
+    // --- Persistent Memory (MEMORY.md) ---
+    if (input.persistentMemoryText && pmBudget > 0) {
+        let pmText = input.persistentMemoryText;
+        const maxChars = pmBudget * 4;
+        if (pmText.length > maxChars) {
+            pmText = pmText.slice(0, maxChars) + '\n<!-- truncated -->';
+        }
+        sections.push(`## Persistent Memory\n\n${pmText}`);
+        totalTokens += Math.min(estimateTokens(input.persistentMemoryText), pmBudget);
+    }
+    // --- Working Memory ---
+    const wmText = input.workingMemoryText ?? '';
+    const wmTokens = estimateTokens(wmText);
+    let wmUsed = 0;
+    if (wmText && wmTokens <= wmBudget) {
+        sections.push(`## Active Context\n${wmText}`);
+        wmUsed = wmTokens;
+        totalTokens += wmUsed;
+    }
+    const wmOverflow = wmBudget - wmUsed;
+    // --- Separate episodic and semantic traces ---
+    const episodicTraces = [];
+    const semanticTraces = [];
+    for (const trace of input.retrievedTraces ?? []) {
+        if (trace.type === 'episodic') {
+            episodicTraces.push(trace);
+        }
+        else {
+            semanticTraces.push(trace);
+        }
+    }
+    // --- Semantic Recall (gets overflow from WM and unused Batch 2 sections) ---
+    semanticBudget += wmOverflow;
+    // If Batch 2 sections are empty, their budgets flow to semantic
+    if (!input.prospectiveAlerts?.length)
+        semanticBudget += prospectiveBudget;
+    if (!input.graphContext?.length)
+        semanticBudget += graphBudget;
+    if (!input.observationNotes?.length)
+        semanticBudget += observationBudget;
+    let semanticUsed = 0;
+    if (semanticTraces.length > 0) {
+        const semanticLines = [];
+        for (const trace of semanticTraces) {
+            const formatted = formatMemoryTrace(trace, style);
+            const tokens = estimateTokens(formatted);
+            if (semanticUsed + tokens > semanticBudget)
+                break;
+            semanticLines.push(formatted);
+            semanticUsed += tokens;
+            includedIds.push(trace.id);
+        }
+        if (semanticLines.length > 0) {
+            sections.push(`## Relevant Memories\n${semanticLines.join('\n')}`);
+            totalTokens += semanticUsed;
+        }
+    }
+    // --- Recent Episodic ---
+    let episodicUsed = 0;
+    if (episodicTraces.length > 0) {
+        const episodicLines = [];
+        for (const trace of episodicTraces) {
+            const formatted = formatMemoryTrace(trace, style);
+            const tokens = estimateTokens(formatted);
+            if (episodicUsed + tokens > episodicBudget)
+                break;
+            episodicLines.push(formatted);
+            episodicUsed += tokens;
+            includedIds.push(trace.id);
+        }
+        if (episodicLines.length > 0) {
+            sections.push(`## Recent Experiences\n${episodicLines.join('\n')}`);
+            totalTokens += episodicUsed;
+        }
+    }
+    // --- Prospective Alerts (Batch 2) ---
+    if (input.prospectiveAlerts?.length) {
+        let prospectiveUsed = 0;
+        const prospectiveLines = [];
+        for (const alert of input.prospectiveAlerts) {
+            const tokens = estimateTokens(alert);
+            if (prospectiveUsed + tokens > prospectiveBudget)
+                break;
+            prospectiveLines.push(`- ${alert}`);
+            prospectiveUsed += tokens;
+        }
+        if (prospectiveLines.length > 0) {
+            sections.push(`## Reminders\n${prospectiveLines.join('\n')}`);
+            totalTokens += prospectiveUsed;
+        }
+    }
+    // --- Graph Associations (Batch 2) ---
+    if (input.graphContext?.length) {
+        let graphUsed = 0;
+        const graphLines = [];
+        for (const ctx of input.graphContext) {
+            const tokens = estimateTokens(ctx);
+            if (graphUsed + tokens > graphBudget)
+                break;
+            graphLines.push(`- ${ctx}`);
+            graphUsed += tokens;
+        }
+        if (graphLines.length > 0) {
+            sections.push(`## Related Context\n${graphLines.join('\n')}`);
+            totalTokens += graphUsed;
+        }
+    }
+    // --- Observation Notes (Batch 2) ---
+    if (input.observationNotes?.length) {
+        let observationUsed = 0;
+        const observationLines = [];
+        for (const note of input.observationNotes) {
+            const tokens = estimateTokens(note);
+            if (observationUsed + tokens > observationBudget)
+                break;
+            observationLines.push(`- ${note}`);
+            observationUsed += tokens;
+        }
+        if (observationLines.length > 0) {
+            sections.push(`## Observations\n${observationLines.join('\n')}`);
+            totalTokens += observationUsed;
+        }
+    }
+    // --- Involuntary Recall (Cognitive Mechanisms) ---
+    if (input.mechanismsEngine && input.allTraces) {
+        const retrievedSet = new Set(includedIds);
+        const { involuntaryMemory } = input.mechanismsEngine.onPromptAssembly(input.allTraces, retrievedSet);
+        if (involuntaryMemory) {
+            const formatted = `[spontaneous memory] ${formatMemoryTrace(involuntaryMemory, style)}`;
+            const tokens = estimateTokens(formatted);
+            if (totalTokens + tokens <= budget) {
+                sections.push(`## Something This Reminds Me Of\n${formatted}`);
+                totalTokens += tokens;
+                includedIds.push(involuntaryMemory.id);
+            }
+        }
+    }
+    return {
+        contextText: sections.join('\n\n'),
+        tokensUsed: totalTokens,
+        allocation: alloc,
+        includedMemoryIds: includedIds,
+    };
+}
+//# sourceMappingURL=MemoryPromptAssembler.js.map

package/dist/memory/core/prompt/MemoryPromptAssembler.js.map

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

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

@@ -0,0 +1,204 @@
+/**
+ * @fileoverview Core types for the Cognitive Memory System.
+ *
+ * Grounded in cognitive science models:
+ * - Atkinson-Shiffrin (sensory → STM → LTM)
+ * - Baddeley's working memory (slot-based, capacity-limited)
+ * - Tulving's LTM taxonomy (episodic vs semantic)
+ * - Ebbinghaus forgetting curve (strength decay over time)
+ * - PAD emotional model (valence/arousal/dominance tagging)
+ *
+ * @module agentos/memory/types
+ */
+/** Long-term memory subtypes (Tulving's taxonomy + extensions). */
+export type MemoryType = 'episodic' | 'semantic' | 'procedural' | 'prospective';
+/** Visibility / ownership scope for a memory trace. */
+export type MemoryScope = 'thread' | 'user' | 'persona' | 'organization';
+/** How the content of this memory was originally produced. */
+export type MemorySourceType = 'user_statement' | 'agent_inference' | 'tool_result' | 'observation' | 'reflection' | 'external';
+export interface MemoryProvenance {
+    sourceType: MemorySourceType;
+    /** Back-reference to originating conversation, tool call, etc. */
+    sourceId?: string;
+    /** Timestamp of the original source information. */
+    sourceTimestamp: number;
+    /** 0-1 confidence we have in this memory's accuracy. */
+    confidence: number;
+    /** How many times this memory has been externally confirmed. */
+    verificationCount: number;
+    lastVerifiedAt?: number;
+    /** IDs of other traces that contradict this one. */
+    contradictedBy?: string[];
+}
+export interface EmotionalContext {
+    /** Pleasure / valence dimension, -1 (negative) to 1 (positive). */
+    valence: number;
+    /** Arousal dimension, 0 (calm) to 1 (excited). */
+    arousal: number;
+    /** Dominance dimension, -1 (submissive) to 1 (dominant). */
+    dominance: number;
+    /** Derived emotional intensity: |valence| * arousal. */
+    intensity: number;
+    /** GMIMood enum string at encoding time. */
+    gmiMood: string;
+}
+export interface ContentFeatures {
+    hasNovelty: boolean;
+    hasProcedure: boolean;
+    hasEmotion: boolean;
+    hasSocialContent: boolean;
+    hasCooperation: boolean;
+    hasEthicalContent: boolean;
+    hasContradiction: boolean;
+    /** 0-1 relevance to current task / active goal. */
+    topicRelevance: number;
+}
+export interface MemoryTrace {
+    id: string;
+    type: MemoryType;
+    scope: MemoryScope;
+    scopeId: string;
+    content: string;
+    structuredData?: Record<string, unknown>;
+    entities: string[];
+    tags: string[];
+    provenance: MemoryProvenance;
+    emotionalContext: EmotionalContext;
+    /** S_0: initial encoding strength, set at creation. */
+    encodingStrength: number;
+    /** Optional normalized salience score used by some consolidation/retrieval paths. */
+    importance?: number;
+    /** Time constant (ms); grows with each successful retrieval. */
+    stability: number;
+    /** Number of times this trace has been successfully retrieved. */
+    retrievalCount: number;
+    /** Unix ms of last retrieval. */
+    lastAccessedAt: number;
+    /** Total access count (includes non-retrieval touches). */
+    accessCount: number;
+    /** Current interval (ms); doubles on each successful recall. */
+    reinforcementInterval: number;
+    /** When this memory is next due for reinforcement review. */
+    nextReinforcementAt?: number;
+    associatedTraceIds: string[];
+    createdAt: number;
+    updatedAt: number;
+    consolidatedAt?: number;
+    isActive: boolean;
+}
+export interface WorkingMemorySlot {
+    slotId: string;
+    /** Reference to the underlying MemoryTrace (or a transient key). */
+    traceId: string;
+    /** 0-1 activation level; determines if slot is "in focus". */
+    activationLevel: number;
+    /** When this trace entered working memory (Unix ms). */
+    enteredAt: number;
+    /** Maintenance rehearsal counter. */
+    rehearsalCount: number;
+    /** How much attention is allocated to this slot (0-1). */
+    attentionWeight: number;
+}
+export interface EncodingWeights {
+    noveltyAttention: number;
+    proceduralAttention: number;
+    emotionalSensitivity: number;
+    socialAttention: number;
+    cooperativeAttention: number;
+    ethicalAttention: number;
+}
+export interface EncodingResult {
+    initialStrength: number;
+    stability: number;
+    importance: number;
+    isFlashbulb: boolean;
+}
+export interface CognitiveRetrievalOptions {
+    topK?: number;
+    types?: MemoryType[];
+    scopes?: Array<{
+        scope: MemoryScope;
+        scopeId: string;
+    }>;
+    tags?: string[];
+    entities?: string[];
+    minConfidence?: number;
+    timeRange?: {
+        after?: number;
+        before?: number;
+    };
+    /** If true, skip emotional congruence bias (useful for factual lookups). */
+    neutralMood?: boolean;
+    /**
+     * Enable HyDE (Hypothetical Document Embedding) for memory retrieval.
+     *
+     * When `true` and a HyDE retriever is configured on the memory manager,
+     * the system generates a hypothetical memory trace matching the query
+     * before embedding. This produces embeddings that are closer to actual
+     * stored memories, improving recall — especially for vague or abstract
+     * recall prompts (e.g. "that thing we discussed about deployment").
+     *
+     * Adds one LLM call per retrieval. Use for important lookups where
+     * recall quality matters more than latency.
+     *
+     * @default false
+     */
+    hyde?: boolean;
+}
+export interface ScoredMemoryTrace extends MemoryTrace {
+    /** Composite retrieval score (0-1). */
+    retrievalScore: number;
+    /** Individual score components for debugging. */
+    scoreBreakdown: {
+        strengthScore: number;
+        similarityScore: number;
+        recencyScore: number;
+        emotionalCongruenceScore: number;
+        graphActivationScore: number;
+        importanceScore: number;
+    };
+}
+export interface PartiallyRetrievedTrace {
+    traceId: string;
+    confidence: number;
+    partialContent: string;
+    suggestedCues: string[];
+}
+export interface CognitiveRetrievalResult {
+    retrieved: ScoredMemoryTrace[];
+    partiallyRetrieved: PartiallyRetrievedTrace[];
+    diagnostics: {
+        candidatesScanned: number;
+        vectorSearchTimeMs: number;
+        scoringTimeMs: number;
+        totalTimeMs: number;
+    };
+}
+export interface MemoryBudgetAllocation {
+    workingMemory: number;
+    semanticRecall: number;
+    recentEpisodic: number;
+    prospectiveAlerts: number;
+    graphAssociations: number;
+    observationNotes: number;
+    persistentMemory: number;
+}
+export interface AssembledMemoryContext {
+    contextText: string;
+    tokensUsed: number;
+    allocation: MemoryBudgetAllocation;
+    includedMemoryIds: string[];
+}
+export interface MemoryHealthReport {
+    totalTraces: number;
+    activeTraces: number;
+    avgStrength: number;
+    weakestTraceStrength: number;
+    workingMemoryUtilization: number;
+    lastConsolidationAt?: number;
+    tracesPerType: Record<MemoryType, number>;
+    tracesPerScope: Record<MemoryScope, 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

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

package/dist/memory/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/memory/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/memory/core/util/crossPlatformCrypto.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Cross-platform cryptographic utilities.
+ *
+ * Provides SHA-256 hashing and UUID v4 generation that work in both
+ * Node.js and browser environments. Node.js uses the native `crypto`
+ * module for performance; browsers use `crypto.subtle` and
+ * `crypto.getRandomValues`.
+ *
+ * @module memory/util/crossPlatformCrypto
+ */
+/**
+ * Compute SHA-256 hex digest of a string.
+ *
+ * Uses Node.js `crypto.createHash` when available (fast, synchronous
+ * under the hood). Falls back to `crypto.subtle.digest` in browsers.
+ *
+ * @param input - The string to hash.
+ * @returns 64-character lowercase hex digest.
+ */
+export declare function sha256(input: string): Promise<string>;
+/**
+ * Generate a UUID v4 string.
+ *
+ * Uses `crypto.randomUUID()` which is available in Node.js 19+ and all
+ * modern browsers. Falls back to a manual implementation using
+ * `crypto.getRandomValues` or `Math.random`.
+ *
+ * @returns UUID v4 string (e.g. `"550e8400-e29b-41d4-a716-446655440000"`).
+ */
+export declare function uuid(): string;
+//# sourceMappingURL=crossPlatformCrypto.d.ts.map

package/dist/memory/core/util/crossPlatformCrypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossPlatformCrypto.d.ts","sourceRoot":"","sources":["../../../../src/memory/core/util/crossPlatformCrypto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAgB7B"}