Interface: CognitiveRetrievalOptions

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

Properties

entities?

optional entities: string[]

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

---

hyde?

optional hyde: boolean

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

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

---

minConfidence?

optional minConfidence: number

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

---

neutralMood?

optional neutralMood: boolean

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

If true, skip emotional congruence bias (useful for factual lookups).

---

policy?

optional policy: MemoryRetrievalPolicy

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

Shared retrieval profile and confidence policy.

---

scopes?

optional scopes: object[]

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

scope

scope: MemoryScope

scopeId

scopeId: string

---

scoringWeights?

optional scoringWeights: Partial<ScoringWeights>

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

Override the 6-signal retrieval weights for this call. Missing keys fall back to DEFAULT_SCORING_WEIGHTS. Useful for ablation studies (zero one weight at a time and measure Δaccuracy) and for A/B testing alternate weight configurations without mutating global defaults.

---

tags?

optional tags: string[]

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

---

timeRange?

optional timeRange: object

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

after?

optional after: number

before?

optional before: number

---

topK?

optional topK: number

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

---

types?

optional types: MemoryType[]

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