Graphorin API reference v0.12.1
Graphorin API reference / @graphorin/memory / / CreateConsolidatorOptions
Interface: CreateConsolidatorOptions
Defined in: packages/memory/src/consolidator/types.ts:436
Options accepted by createConsolidator.
Stable
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
autoPromoteExtraction? | readonly | boolean | Opt in to auto-promotion of injection-clean extraction facts (MCON-2). Defaults false. See ConsolidatorConfig.autoPromoteExtraction. | packages/memory/src/consolidator/types.ts:532 |
budgetResetSemantics? | readonly | "utc" | "local" | "sliding-24h" | - | packages/memory/src/consolidator/types.ts:506 |
ceilings? | readonly | Partial<ConsolidatorCeilings> | - | packages/memory/src/consolidator/types.ts:478 |
cheapModel? | readonly | string | null | - | packages/memory/src/consolidator/types.ts:504 |
cheapProvider? | readonly | Provider | null | Provider routed to the standard phase (extraction / episode / reconcile / situating-context calls) when set (MCON-7). Falls back to provider. Pair with cheapModel for the telemetry label. | packages/memory/src/consolidator/types.ts:498 |
contextualRetrieval? | readonly | ContextualRetrievalMode | Override the per-tier ConsolidatorConfig.contextualRetrieval default (P1-3). | packages/memory/src/consolidator/types.ts:542 |
curatedBlocks? | readonly | readonly CuratedBlockSpec[] | Curated working blocks the deep phase maintains (wave-D D3). learnedContext: true remains sugar for [{ label: 'learned_context' }] and composes with this list. | packages/memory/src/consolidator/types.ts:552 |
decayArchiveThreshold? | readonly | number | - | packages/memory/src/consolidator/types.ts:512 |
decayCapacity? | readonly | number | null | Override the ConsolidatorConfig.decayCapacity default (X-1). | packages/memory/src/consolidator/types.ts:514 |
decayTauDays? | readonly | number | - | packages/memory/src/consolidator/types.ts:511 |
deepModel? | readonly | string | null | - | packages/memory/src/consolidator/types.ts:505 |
deepProvider? | readonly | Provider | null | Provider routed to the deep phase (conflict judge) and the reflection pass when set (MCON-7). Falls back to provider. | packages/memory/src/consolidator/types.ts:503 |
defaultScope? | readonly | SessionScope | Default scope used by event triggers + the manual fireNow path. | packages/memory/src/consolidator/types.ts:558 |
dlqBaseBackoffMs? | readonly | number | - | packages/memory/src/consolidator/types.ts:522 |
dlqMaxBackoffMs? | readonly | number | - | packages/memory/src/consolidator/types.ts:523 |
dlqMaxRetries? | readonly | number | - | packages/memory/src/consolidator/types.ts:521 |
episodic? | readonly | EpisodicMemory | The EpisodicMemory tier instance from the parent createMemory(...) facade. When supplied (and formEpisodes is on) the standard phase auto-forms a quarantined episode per processed slice (P1-2). Omitted ⇒ episode formation is skipped. | packages/memory/src/consolidator/types.ts:456 |
formEpisodes? | readonly | boolean | Override the per-tier ConsolidatorConfig.formEpisodes default (P1-2). | packages/memory/src/consolidator/types.ts:525 |
importanceScoring? | readonly | boolean | Override the per-tier ConsolidatorConfig.importanceScoring default (P1-2). | packages/memory/src/consolidator/types.ts:527 |
importanceThreshold? | readonly | number | Override the ConsolidatorConfig.importanceThreshold default (P1-1). | packages/memory/src/consolidator/types.ts:536 |
ingestGate? | readonly | MemoryIngestGate | B3: override ConsolidatorConfig.ingestGate. | packages/memory/src/consolidator/types.ts:509 |
learnedContext? | readonly | boolean | Override the per-tier ConsolidatorConfig.learnedContext default (D3). | packages/memory/src/consolidator/types.ts:544 |
learnedContextMaxChars? | readonly | number | Override the ConsolidatorConfig.learnedContextMaxChars default (D3). | packages/memory/src/consolidator/types.ts:546 |
lockWaitMs? | readonly | number | - | packages/memory/src/consolidator/types.ts:510 |
maxDeepConflictsPerRun? | readonly | number | - | packages/memory/src/consolidator/types.ts:520 |
maxStandardBatchSize? | readonly | number | - | packages/memory/src/consolidator/types.ts:517 |
maxTranscriptChars? | readonly | number | Override the per-tier ConsolidatorConfig.maxTranscriptChars default (W-081). | packages/memory/src/consolidator/types.ts:519 |
noiseFilters? | readonly | readonly ("default" | "minimal" | "none")[] | - | packages/memory/src/consolidator/types.ts:507 |
now? | readonly | () => number | Override the wall clock - used by tests. | packages/memory/src/consolidator/types.ts:472 |
onExceed? | readonly | OnBudgetExceed | - | packages/memory/src/consolidator/types.ts:479 |
phases? | readonly | readonly ConsolidatorPhase[] | - | packages/memory/src/consolidator/types.ts:477 |
priceUsage? | readonly | (usage) => number | USD pricer for phase LLM usage (memory-consolidation-02). Wire it to @graphorin/pricing's calculateCost (or any per-token rate) so the maxCostPerDay ceiling can actually accumulate spend - without it every phase prices its calls at $0 and the USD ceiling never trips at any tier. priceUsage: ({ promptTokens, completionTokens }) => (promptTokens * 3 + completionTokens * 15) / 1_000_000 | packages/memory/src/consolidator/types.ts:492 |
profileProjection? | readonly | ProfileProjectionConfig | Enable the profile-projection pass (wave-D D2). Default off. | packages/memory/src/consolidator/types.ts:554 |
promotion? | readonly | PromotionPolicyConfig | Enable the deterministic promotion step (wave-D D4). Default off. | packages/memory/src/consolidator/types.ts:556 |
provider? | readonly | Provider | null | Provider used by the standard + deep phases. Required when the tier enables either phase; ignored when the active phases collapse to ['light']. | packages/memory/src/consolidator/types.ts:469 |
randomId? | readonly | () => string | Random source for stable run ids - used by tests. | packages/memory/src/consolidator/types.ts:474 |
reflection? | readonly | boolean | Override the per-tier ConsolidatorConfig.reflection default (P1-1). | packages/memory/src/consolidator/types.ts:534 |
reflectionMaxQuarantinedInsights? | readonly | number | Override the ConsolidatorConfig.reflectionMaxQuarantinedInsights default (W-082). | packages/memory/src/consolidator/types.ts:540 |
reflectionMaxQuestions? | readonly | number | Override the ConsolidatorConfig.reflectionMaxQuestions default (P1-1). | packages/memory/src/consolidator/types.ts:538 |
salienceWeights? | readonly | SalienceWeights | Override the ConsolidatorConfig.salienceWeights default (X-1). | packages/memory/src/consolidator/types.ts:516 |
semantic | readonly | SemanticMemory | The SemanticMemory tier instance from the parent createMemory(...) facade. The standard phase routes every extracted fact through semantic.remember(...) so the conflict pipeline (Phase 10b) handles dedup / supersede. | packages/memory/src/consolidator/types.ts:449 |
store | readonly | MemoryStoreAdapter | Storage adapter - supplies the consolidator state, runs, DLQ, and per-tier helpers. The default @graphorin/store-sqlite adapter exposes everything by construction. | packages/memory/src/consolidator/types.ts:442 |
tier? | readonly | ConsolidatorTier | - | packages/memory/src/consolidator/types.ts:476 |
tracer? | readonly | Tracer | - | packages/memory/src/consolidator/types.ts:470 |
triggers? | readonly | readonly ConsolidatorTriggerSpec[] | - | packages/memory/src/consolidator/types.ts:475 |
working? | readonly | WorkingMemory | The WorkingMemory tier instance from the parent createMemory(...) facade (D3). Required for the learned-context pass - without it the pass is a silent no-op even when learnedContext is enabled. | packages/memory/src/consolidator/types.ts:463 |