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:326

Total access count (includes non-retrieval touches).

associatedTraceIds​

associatedTraceIds: string[]

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

consolidatedAt?​

optional consolidatedAt: number

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

content​

content: string

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

createdAt​

createdAt: number

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

emotionalContext​

emotionalContext: EmotionalContext

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

encodingStrength​

encodingStrength: number

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

S_0: initial encoding strength, set at creation.

entities​

entities: string[]

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

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:318

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

isActive​

isActive: boolean

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

lastAccessedAt​

lastAccessedAt: number

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

Unix ms of last retrieval.

nextReinforcementAt?​

optional nextReinforcementAt: number

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

When this memory is next due for reinforcement review.

policy?​

optional policy: MemoryTrustPolicy

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

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:309

reinforcementInterval​

reinforcementInterval: number

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

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

retrievalCount​

retrievalCount: number

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

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:320

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

structuredData?​

optional structuredData: Record<string, unknown>

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

tags​

tags: string[]

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

turnUserId?​

optional turnUserId: string

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

The explicit user id of the turn that filed this trace when that turn had no learner: a second user speaking on another user's session, whose trace is filed under the session's scope. Account deletion for that user (LearningLayer.forgetUser) finds the trace by it. Absent on every other trace.

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:349