Skip to main content

Interface: ScoredMemoryTrace

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

Extends​

Properties​

accessCount​

accessCount: number

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

Total access count (includes non-retrieval touches).

Inherited from​

MemoryTrace.accessCount

associatedTraceIds​

associatedTraceIds: string[]

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

Inherited from​

MemoryTrace.associatedTraceIds

consolidatedAt?​

optional consolidatedAt: number

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

Inherited from​

MemoryTrace.consolidatedAt

content​

content: string

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

Inherited from​

MemoryTrace.content

createdAt​

createdAt: number

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

Inherited from​

MemoryTrace.createdAt

emotionalContext​

emotionalContext: EmotionalContext

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

Inherited from​

MemoryTrace.emotionalContext

encodingStrength​

encodingStrength: number

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

S_0: initial encoding strength, set at creation.

Inherited from​

MemoryTrace.encodingStrength

entities​

entities: string[]

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

Inherited from​

MemoryTrace.entities

id​

id: string

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

Inherited from​

MemoryTrace.id

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.

Inherited from​

MemoryTrace.importance

isActive​

isActive: boolean

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

Inherited from​

MemoryTrace.isActive

lastAccessedAt​

lastAccessedAt: number

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

Unix ms of last retrieval.

Inherited from​

MemoryTrace.lastAccessedAt

nextReinforcementAt?​

optional nextReinforcementAt: number

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

When this memory is next due for reinforcement review.

Inherited from​

MemoryTrace.nextReinforcementAt

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.

Inherited from​

MemoryTrace.policy

provenance​

provenance: MemoryProvenance

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

Inherited from​

MemoryTrace.provenance

reinforcementInterval​

reinforcementInterval: number

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

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

Inherited from​

MemoryTrace.reinforcementInterval

retrievalCount​

retrievalCount: number

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

Number of times this trace has been successfully retrieved.

Inherited from​

MemoryTrace.retrievalCount

retrievalScore​

retrievalScore: number

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

Composite retrieval score (0-1).

scope​

scope: MemoryScope

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

Inherited from​

MemoryTrace.scope

scopeId​

scopeId: string

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

Inherited from​

MemoryTrace.scopeId

scoreBreakdown​

scoreBreakdown: object

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

Individual score components for debugging.

emotionalCongruenceScore​

emotionalCongruenceScore: number

graphActivationScore​

graphActivationScore: number

importanceScore​

importanceScore: number

recencyScore​

recencyScore: number

similarityScore​

similarityScore: number

strengthScore​

strengthScore: number

stability​

stability: number

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

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

Inherited from​

MemoryTrace.stability

structuredData?​

optional structuredData: Record<string, unknown>

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

Inherited from​

MemoryTrace.structuredData

tags​

tags: string[]

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

Inherited from​

MemoryTrace.tags

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.

Inherited from​

MemoryTrace.turnUserId

type​

type: MemoryType

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

Inherited from​

MemoryTrace.type

updatedAt​

updatedAt: number

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

Inherited from​

MemoryTrace.updatedAt