@framers/agentos 0.1.46 → 0.1.47

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

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Unified memory store wrapping IVectorStore + IKnowledgeGraph.
+ *
+ * Handles:
+ * - Embedding and storing memory traces in vector store
+ * - Recording as episodic memories in knowledge graph
+ * - Querying with decay-aware scoring
+ * - Access tracking for spaced repetition
+ *
+ * @module agentos/memory/store/MemoryStore
+ */
+import type { IVectorStore } from '../../rag/IVectorStore.js';
+import type { IEmbeddingManager } from '../../rag/IEmbeddingManager.js';
+import type { IKnowledgeGraph } from '../../core/knowledge/IKnowledgeGraph.js';
+import type { MemoryTrace, MemoryType, MemoryScope, CognitiveRetrievalOptions, ScoredMemoryTrace, PartiallyRetrievedTrace } from '../types.js';
+import type { PADState, DecayConfig } from '../config.js';
+import { type RetrievalUpdateResult } from '../decay/DecayModel.js';
+export interface MemoryStoreConfig {
+    vectorStore: IVectorStore;
+    embeddingManager: IEmbeddingManager;
+    knowledgeGraph: IKnowledgeGraph;
+    /** Collection name prefix. @default 'cogmem' */
+    collectionPrefix: string;
+    /** Embedding dimension (auto-detected if possible). */
+    embeddingDimension?: number;
+    decayConfig?: DecayConfig;
+}
+export declare class MemoryStore {
+    private config;
+    private decay;
+    /** Cache of full MemoryTrace objects by ID. */
+    private traceCache;
+    /** Track concrete scopes we have seen, so retrieval never falls back to a fake wildcard scope. */
+    private knownScopes;
+    constructor(config: MemoryStoreConfig);
+    /**
+     * Store a new memory trace: embed content, upsert into vector store,
+     * and record as episodic memory in the knowledge graph.
+     */
+    store(trace: MemoryTrace): Promise<void>;
+    /**
+     * Query memory traces with cognitive scoring.
+     */
+    query(queryText: string, currentMood: PADState, options?: CognitiveRetrievalOptions): Promise<{
+        scored: ScoredMemoryTrace[];
+        partial: PartiallyRetrievedTrace[];
+    }>;
+    /**
+     * Record that a memory was accessed (retrieved).
+     * Updates decay parameters via spaced repetition.
+     */
+    recordAccess(traceId: string): Promise<RetrievalUpdateResult | null>;
+    /**
+     * Get all traces for a scope (for consolidation pipeline).
+     */
+    getByScope(scope: MemoryScope, scopeId: string, type?: MemoryType): Promise<MemoryTrace[]>;
+    /**
+     * Soft-delete a trace.
+     */
+    softDelete(traceId: string): Promise<void>;
+    /**
+     * Get a trace by ID.
+     */
+    getTrace(traceId: string): MemoryTrace | undefined;
+    /**
+     * Get trace count.
+     */
+    getTraceCount(): number;
+    /**
+     * Get active trace count.
+     */
+    getActiveTraceCount(): number;
+    private registerScope;
+    private getKnownScopes;
+}
+//# sourceMappingURL=MemoryStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStore.d.ts","sourceRoot":"","sources":["../../../src/memory/store/MemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAYhC,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;CAC3B;AAwED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAc;IAC3B,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAAuC;IACzD,kGAAkG;IAClG,OAAO,CAAC,WAAW,CAAmE;gBAE1E,MAAM,EAAE,iBAAiB;IASrC;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD9C;;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;IA6F/E;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IA0C1E;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAahG;;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,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,cAAc;CAGvB"}

package/dist/memory/store/MemoryStore.js

@@ -0,0 +1,320 @@
+/**
+ * @fileoverview Unified memory store wrapping IVectorStore + IKnowledgeGraph.
+ *
+ * Handles:
+ * - Embedding and storing memory traces in vector store
+ * - Recording as episodic memories in knowledge graph
+ * - Querying with decay-aware scoring
+ * - Access tracking for spaced repetition
+ *
+ * @module agentos/memory/store/MemoryStore
+ */
+import { DEFAULT_DECAY_CONFIG } from '../config.js';
+import { updateOnRetrieval, } from '../decay/DecayModel.js';
+import { scoreAndRankTraces, detectPartiallyRetrieved, } from '../decay/RetrievalPriorityScorer.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function collectionName(prefix, scope, scopeId) {
+    return `${prefix}_${scope}_${scopeId}`;
+}
+function scopeKey(scope, scopeId) {
+    return `${scope}:${scopeId}`;
+}
+function traceToMetadata(trace) {
+    return {
+        type: trace.type,
+        scope: trace.scope,
+        scopeId: trace.scopeId,
+        encodingStrength: trace.encodingStrength,
+        stability: trace.stability,
+        retrievalCount: trace.retrievalCount,
+        lastAccessedAt: trace.lastAccessedAt,
+        accessCount: trace.accessCount,
+        emotionalValence: trace.emotionalContext.valence,
+        emotionalArousal: trace.emotionalContext.arousal,
+        emotionalIntensity: trace.emotionalContext.intensity,
+        confidence: trace.provenance.confidence,
+        sourceType: trace.provenance.sourceType,
+        importance: trace.provenance.confidence, // use confidence as proxy
+        createdAt: trace.createdAt,
+        isActive: trace.isActive ? 1 : 0,
+        tags: trace.tags.join(','),
+        entities: trace.entities.join(','),
+    };
+}
+function metadataToTracePartial(metadata) {
+    return {
+        type: metadata.type,
+        scope: metadata.scope,
+        scopeId: metadata.scopeId,
+        encodingStrength: metadata.encodingStrength,
+        stability: metadata.stability,
+        retrievalCount: metadata.retrievalCount,
+        lastAccessedAt: metadata.lastAccessedAt,
+        accessCount: metadata.accessCount,
+        emotionalContext: {
+            valence: metadata.emotionalValence,
+            arousal: metadata.emotionalArousal,
+            dominance: 0,
+            intensity: metadata.emotionalIntensity,
+            gmiMood: '',
+        },
+        provenance: {
+            sourceType: metadata.sourceType,
+            confidence: metadata.confidence,
+            verificationCount: 0,
+            sourceTimestamp: metadata.createdAt,
+        },
+        createdAt: metadata.createdAt,
+        isActive: metadata.isActive === 1,
+        tags: typeof metadata.tags === 'string' ? metadata.tags.split(',').filter(Boolean) : [],
+        entities: typeof metadata.entities === 'string' ? metadata.entities.split(',').filter(Boolean) : [],
+    };
+}
+// ---------------------------------------------------------------------------
+// MemoryStore
+// ---------------------------------------------------------------------------
+export class MemoryStore {
+    constructor(config) {
+        /** Cache of full MemoryTrace objects by ID. */
+        this.traceCache = new Map();
+        /** Track concrete scopes we have seen, so retrieval never falls back to a fake wildcard scope. */
+        this.knownScopes = new Map();
+        this.config = config;
+        this.decay = config.decayConfig ?? DEFAULT_DECAY_CONFIG;
+    }
+    // =========================================================================
+    // Store
+    // =========================================================================
+    /**
+     * Store a new memory trace: embed content, upsert into vector store,
+     * and record as episodic memory in the knowledge graph.
+     */
+    async store(trace) {
+        const collection = collectionName(this.config.collectionPrefix, trace.scope, trace.scopeId);
+        // Generate embedding
+        const embeddingResponse = await this.config.embeddingManager.generateEmbeddings({
+            texts: trace.content,
+        });
+        const embedding = embeddingResponse.embeddings[0];
+        // Upsert into vector store
+        const doc = {
+            id: trace.id,
+            textContent: trace.content,
+            embedding,
+            metadata: traceToMetadata(trace),
+        };
+        await this.config.vectorStore.upsert(collection, [doc]);
+        // Record in knowledge graph as episodic memory
+        try {
+            await this.config.knowledgeGraph.recordMemory({
+                type: trace.type === 'episodic' ? 'conversation' : 'discovery',
+                summary: trace.content.substring(0, 200),
+                description: trace.content,
+                participants: [trace.scopeId],
+                valence: trace.emotionalContext.valence,
+                importance: trace.encodingStrength,
+                entityIds: [],
+                embedding,
+                occurredAt: new Date(trace.createdAt).toISOString(),
+                outcome: 'unknown',
+                context: {
+                    memoryTraceId: trace.id,
+                    scope: trace.scope,
+                    scopeId: trace.scopeId,
+                    type: trace.type,
+                },
+            });
+        }
+        catch {
+            // Knowledge graph may not be available; non-critical
+        }
+        // Cache
+        this.traceCache.set(trace.id, trace);
+        this.registerScope(trace.scope, trace.scopeId);
+    }
+    // =========================================================================
+    // Query
+    // =========================================================================
+    /**
+     * Query memory traces with cognitive scoring.
+     */
+    async query(queryText, currentMood, options = {}) {
+        const now = Date.now();
+        const topK = options.topK ?? 20;
+        // Determine which collections to search
+        const scopes = options.scopes?.length ? options.scopes : this.getKnownScopes();
+        if (scopes.length === 0) {
+            return { scored: [], partial: [] };
+        }
+        // Generate query embedding
+        const embeddingResponse = await this.config.embeddingManager.generateEmbeddings({
+            texts: queryText,
+        });
+        const queryEmbedding = embeddingResponse.embeddings[0];
+        // Build metadata filter
+        const metadataFilter = { isActive: { $eq: 1 } };
+        if (options.types?.length) {
+            metadataFilter.type = { $in: options.types };
+        }
+        if (options.minConfidence != null) {
+            metadataFilter.confidence = { $gte: options.minConfidence };
+        }
+        if (options.timeRange?.after) {
+            metadataFilter.createdAt = { $gte: options.timeRange.after };
+        }
+        // Search across scopes
+        const allCandidates = [];
+        for (const { scope, scopeId } of scopes) {
+            const collection = collectionName(this.config.collectionPrefix, scope, scopeId);
+            try {
+                const results = await this.config.vectorStore.query(collection, queryEmbedding, {
+                    topK: topK * 2, // over-fetch for re-ranking
+                    filter: metadataFilter,
+                    includeMetadata: true,
+                });
+                for (const result of results.documents) {
+                    const tracePartial = metadataToTracePartial(result.metadata ?? {});
+                    const cached = this.traceCache.get(result.id);
+                    const trace = cached ??
+                        {
+                            id: result.id,
+                            content: result.textContent ?? '',
+                            structuredData: undefined,
+                            associatedTraceIds: [],
+                            reinforcementInterval: 3600000,
+                            updatedAt: Date.now(),
+                            ...tracePartial,
+                        };
+                    if (!cached) {
+                        this.traceCache.set(trace.id, trace);
+                    }
+                    if (trace.scope && trace.scopeId) {
+                        this.registerScope(trace.scope, trace.scopeId);
+                    }
+                    allCandidates.push({
+                        trace,
+                        vectorSimilarity: result.similarityScore ?? 0,
+                        graphActivation: 0, // Batch 2
+                    });
+                }
+            }
+            catch {
+                // Collection may not exist yet; skip
+            }
+        }
+        // Score and rank
+        const scoringContext = {
+            currentMood,
+            now,
+            neutralMood: options.neutralMood,
+            decayConfig: this.decay,
+        };
+        const scored = scoreAndRankTraces(allCandidates, scoringContext).slice(0, topK);
+        const partial = detectPartiallyRetrieved(allCandidates, now);
+        return { scored, partial };
+    }
+    // =========================================================================
+    // Access tracking
+    // =========================================================================
+    /**
+     * Record that a memory was accessed (retrieved).
+     * Updates decay parameters via spaced repetition.
+     */
+    async recordAccess(traceId) {
+        const trace = this.traceCache.get(traceId);
+        if (!trace)
+            return null;
+        const now = Date.now();
+        const update = updateOnRetrieval(trace, now);
+        // Apply updates to cached trace
+        trace.encodingStrength = update.encodingStrength;
+        trace.stability = update.stability;
+        trace.retrievalCount = update.retrievalCount;
+        trace.lastAccessedAt = update.lastAccessedAt;
+        trace.accessCount = update.accessCount;
+        trace.reinforcementInterval = update.reinforcementInterval;
+        trace.nextReinforcementAt = update.nextReinforcementAt;
+        trace.updatedAt = now;
+        // Update vector store metadata
+        const collection = collectionName(this.config.collectionPrefix, trace.scope, trace.scopeId);
+        try {
+            const embeddingResponse = await this.config.embeddingManager.generateEmbeddings({
+                texts: trace.content,
+            });
+            await this.config.vectorStore.upsert(collection, [
+                {
+                    id: trace.id,
+                    textContent: trace.content,
+                    embedding: embeddingResponse.embeddings[0],
+                    metadata: traceToMetadata(trace),
+                },
+            ]);
+        }
+        catch {
+            // Non-critical update
+        }
+        return update;
+    }
+    // =========================================================================
+    // Batch operations
+    // =========================================================================
+    /**
+     * Get all traces for a scope (for consolidation pipeline).
+     */
+    async getByScope(scope, scopeId, type) {
+        // Return from cache + filter
+        const results = [];
+        for (const trace of this.traceCache.values()) {
+            if (trace.scope === scope && trace.scopeId === scopeId) {
+                if (!type || trace.type === type) {
+                    results.push(trace);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Soft-delete a trace.
+     */
+    async softDelete(traceId) {
+        const trace = this.traceCache.get(traceId);
+        if (trace) {
+            trace.isActive = false;
+            trace.updatedAt = Date.now();
+        }
+    }
+    /**
+     * Get a trace by ID.
+     */
+    getTrace(traceId) {
+        return this.traceCache.get(traceId);
+    }
+    /**
+     * Get trace count.
+     */
+    getTraceCount() {
+        return this.traceCache.size;
+    }
+    /**
+     * Get active trace count.
+     */
+    getActiveTraceCount() {
+        let count = 0;
+        for (const trace of this.traceCache.values()) {
+            if (trace.isActive)
+                count++;
+        }
+        return count;
+    }
+    registerScope(scope, scopeId) {
+        if (!scopeId)
+            return;
+        this.knownScopes.set(scopeKey(scope, scopeId), { scope, scopeId });
+    }
+    getKnownScopes() {
+        return [...this.knownScopes.values()];
+    }
+}
+//# sourceMappingURL=MemoryStore.js.map

package/dist/memory/store/MemoryStore.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * @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;
+    /** 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;
+}
+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;
+}
+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>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/memory/types.js

@@ -0,0 +1,14 @@
+/**
+ * @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
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

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