Skip to content

Graphorin API reference v0.7.0


Graphorin API reference / @graphorin/memory / / CreateConsolidatorOptions

Interface: CreateConsolidatorOptions

Defined in: packages/memory/src/consolidator/types.ts:362

Options accepted by createConsolidator.

Stable

Properties

PropertyModifierTypeDescriptionDefined in
autoPromoteExtraction?readonlybooleanOpt in to auto-promotion of injection-clean extraction facts (MCON-2). Defaults false. See ConsolidatorConfig.autoPromoteExtraction.packages/memory/src/consolidator/types.ts:456
budgetResetSemantics?readonly"utc" | "local" | "sliding-24h"-packages/memory/src/consolidator/types.ts:432
ceilings?readonlyPartial<ConsolidatorCeilings>-packages/memory/src/consolidator/types.ts:404
cheapModel?readonlystring | null-packages/memory/src/consolidator/types.ts:430
cheapProvider?readonlyProvider | nullProvider 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:424
contextualRetrieval?readonlyContextualRetrievalModeOverride the per-tier ConsolidatorConfig.contextualRetrieval default (P1-3).packages/memory/src/consolidator/types.ts:466
decayArchiveThreshold?readonlynumber-packages/memory/src/consolidator/types.ts:436
decayCapacity?readonlynumber | nullOverride the ConsolidatorConfig.decayCapacity default (X-1).packages/memory/src/consolidator/types.ts:438
decayTauDays?readonlynumber-packages/memory/src/consolidator/types.ts:435
deepModel?readonlystring | null-packages/memory/src/consolidator/types.ts:431
deepProvider?readonlyProvider | nullProvider 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:429
defaultScope?readonlySessionScopeDefault scope used by event triggers + the manual fireNow path.packages/memory/src/consolidator/types.ts:472
dlqBaseBackoffMs?readonlynumber-packages/memory/src/consolidator/types.ts:446
dlqMaxBackoffMs?readonlynumber-packages/memory/src/consolidator/types.ts:447
dlqMaxRetries?readonlynumber-packages/memory/src/consolidator/types.ts:445
episodic?readonlyEpisodicMemoryThe 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:382
formEpisodes?readonlybooleanOverride the per-tier ConsolidatorConfig.formEpisodes default (P1-2).packages/memory/src/consolidator/types.ts:449
importanceScoring?readonlybooleanOverride the per-tier ConsolidatorConfig.importanceScoring default (P1-2).packages/memory/src/consolidator/types.ts:451
importanceThreshold?readonlynumberOverride the ConsolidatorConfig.importanceThreshold default (P1-1).packages/memory/src/consolidator/types.ts:460
learnedContext?readonlybooleanOverride the per-tier ConsolidatorConfig.learnedContext default (D3).packages/memory/src/consolidator/types.ts:468
learnedContextMaxChars?readonlynumberOverride the ConsolidatorConfig.learnedContextMaxChars default (D3).packages/memory/src/consolidator/types.ts:470
lockWaitMs?readonlynumber-packages/memory/src/consolidator/types.ts:434
maxDeepConflictsPerRun?readonlynumber-packages/memory/src/consolidator/types.ts:444
maxStandardBatchSize?readonlynumber-packages/memory/src/consolidator/types.ts:441
maxTranscriptChars?readonlynumberOverride the per-tier ConsolidatorConfig.maxTranscriptChars default (W-081).packages/memory/src/consolidator/types.ts:443
noiseFilters?readonlyreadonly ("default" | "minimal" | "none")[]-packages/memory/src/consolidator/types.ts:433
now?readonly() => numberOverride the wall clock - used by tests.packages/memory/src/consolidator/types.ts:398
onExceed?readonlyOnBudgetExceed-packages/memory/src/consolidator/types.ts:405
phases?readonlyreadonly ConsolidatorPhase[]-packages/memory/src/consolidator/types.ts:403
priceUsage?readonly(usage) => numberUSD 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_000packages/memory/src/consolidator/types.ts:418
provider?readonlyProvider | nullProvider 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:395
randomId?readonly() => stringRandom source for stable run ids - used by tests.packages/memory/src/consolidator/types.ts:400
reflection?readonlybooleanOverride the per-tier ConsolidatorConfig.reflection default (P1-1).packages/memory/src/consolidator/types.ts:458
reflectionMaxQuarantinedInsights?readonlynumberOverride the ConsolidatorConfig.reflectionMaxQuarantinedInsights default (W-082).packages/memory/src/consolidator/types.ts:464
reflectionMaxQuestions?readonlynumberOverride the ConsolidatorConfig.reflectionMaxQuestions default (P1-1).packages/memory/src/consolidator/types.ts:462
salienceWeights?readonlySalienceWeightsOverride the ConsolidatorConfig.salienceWeights default (X-1).packages/memory/src/consolidator/types.ts:440
semanticreadonlySemanticMemoryThe 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:375
storereadonlyMemoryStoreAdapterStorage 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:368
tier?readonlyConsolidatorTier-packages/memory/src/consolidator/types.ts:402
tracer?readonlyTracer-packages/memory/src/consolidator/types.ts:396
triggers?readonlyreadonly ConsolidatorTriggerSpec[]-packages/memory/src/consolidator/types.ts:401
working?readonlyWorkingMemoryThe 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:389