Skip to main content

Interface: MemoryTrace

Defined in: packages/agentos/src/cognition/memory/core/types.ts:290

Extended by

Properties

accessCount

accessCount: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:320

Total access count (includes non-retrieval touches).


associatedTraceIds

associatedTraceIds: string[]

Defined in: packages/agentos/src/cognition/memory/core/types.ts:329


consolidatedAt?

optional consolidatedAt: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:344


content

content: string

Defined in: packages/agentos/src/cognition/memory/core/types.ts:297


createdAt

createdAt: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:342


emotionalContext

emotionalContext: EmotionalContext

Defined in: packages/agentos/src/cognition/memory/core/types.ts:306


encodingStrength

encodingStrength: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:310

S_0: initial encoding strength, set at creation.


entities

entities: string[]

Defined in: packages/agentos/src/cognition/memory/core/types.ts:299


id

id: string

Defined in: packages/agentos/src/cognition/memory/core/types.ts:291


importance?

optional importance: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:312

Optional normalized salience score used by some consolidation/retrieval paths.


isActive

isActive: boolean

Defined in: packages/agentos/src/cognition/memory/core/types.ts:345


lastAccessedAt

lastAccessedAt: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:318

Unix ms of last retrieval.


nextReinforcementAt?

optional nextReinforcementAt: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:326

When this memory is next due for reinforcement review.


policy?

optional policy: MemoryTrustPolicy

Defined in: packages/agentos/src/cognition/memory/core/types.ts:339

Per-trace capability gating. Set at encoding time from the source-type defaults table (DEFAULT_TRUST_POLICY_BY_SOURCE). When absent, the runtime treats the memory as unrestricted; callers should use canUseFor to gate against authorization / personalization / fact-claim use cases.


provenance

provenance: MemoryProvenance

Defined in: packages/agentos/src/cognition/memory/core/types.ts:303


reinforcementInterval

reinforcementInterval: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:324

Current interval (ms); doubles on each successful recall.


retrievalCount

retrievalCount: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:316

Number of times this trace has been successfully retrieved.


scope

scope: MemoryScope

Defined in: packages/agentos/src/cognition/memory/core/types.ts:293


scopeId

scopeId: string

Defined in: packages/agentos/src/cognition/memory/core/types.ts:294


stability

stability: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:314

Time constant (ms); grows with each successful retrieval.


structuredData?

optional structuredData: Record<string, unknown>

Defined in: packages/agentos/src/cognition/memory/core/types.ts:298


tags

tags: string[]

Defined in: packages/agentos/src/cognition/memory/core/types.ts:300


type

type: MemoryType

Defined in: packages/agentos/src/cognition/memory/core/types.ts:292


updatedAt

updatedAt: number

Defined in: packages/agentos/src/cognition/memory/core/types.ts:343