@remnic/core 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,1243 @@
+type ReasoningEffort = "none" | "low" | "medium" | "high";
+type TriggerMode = "smart" | "every_n" | "time_based";
+type SignalLevel = "none" | "low" | "medium" | "high";
+type MemoryCategory = "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule";
+type ConsolidationAction = "ADD" | "MERGE" | "UPDATE" | "INVALIDATE" | "SKIP";
+type ConfidenceTier = "explicit" | "implied" | "inferred" | "speculative";
+type PrincipalFromSessionKeyMode = "map" | "prefix" | "regex";
+type RecallPlanMode = "no_recall" | "minimal" | "full" | "graph_mode";
+type CronRecallMode = "all" | "none" | "allowlist";
+type CronConversationRecallMode = "auto" | "always" | "never";
+type IdentityInjectionMode = "recovery_only" | "minimal" | "full";
+type CaptureMode = "implicit" | "explicit" | "hybrid";
+type MemoryOsPresetName = "conservative" | "balanced" | "research-max" | "local-llm-heavy";
+type ExtractionPassSource = "base" | "proactive";
+interface RecallSectionConfig {
+    id: string;
+    enabled?: boolean;
+    maxChars?: number | null;
+    maxHints?: number;
+    maxSupportingFacts?: number;
+    maxRelatedEntities?: number;
+    consolidateTriggerLines?: number;
+    consolidateTargetLines?: number;
+    maxEntities?: number;
+    maxResults?: number;
+    recentTurns?: number;
+    maxTurns?: number;
+    maxTokens?: number;
+    lookbackHours?: number;
+    maxCount?: number;
+    topK?: number;
+    timeoutMs?: number;
+    maxPatterns?: number;
+    maxRubrics?: number;
+}
+interface RecallPipelineConfig {
+    recallBudgetChars: number;
+    pipeline: RecallSectionConfig[];
+}
+interface SessionObserverBandConfig {
+    maxBytes: number;
+    triggerDeltaBytes: number;
+    triggerDeltaTokens: number;
+}
+interface FileHygieneConfig {
+    enabled: boolean;
+    lintEnabled: boolean;
+    lintBudgetBytes: number;
+    lintWarnRatio: number;
+    lintPaths: string[];
+    rotateEnabled: boolean;
+    rotateMaxBytes: number;
+    rotateKeepTailChars: number;
+    rotatePaths: string[];
+    archiveDir: string;
+    runMinIntervalMs: number;
+    warningsLogEnabled: boolean;
+    warningsLogPath: string;
+    indexEnabled: boolean;
+    indexPath: string;
+}
+interface NativeKnowledgeConfig {
+    enabled: boolean;
+    includeFiles: string[];
+    maxChunkChars: number;
+    maxResults: number;
+    maxChars: number;
+    stateDir: string;
+    obsidianVaults: NativeKnowledgeObsidianVaultConfig[];
+    openclawWorkspace?: NativeKnowledgeOpenClawWorkspaceConfig;
+}
+interface NativeKnowledgeFolderRuleConfig {
+    pathPrefix: string;
+    namespace?: string;
+    privacyClass?: string;
+}
+interface NativeKnowledgeObsidianVaultConfig {
+    id: string;
+    rootDir: string;
+    includeGlobs: string[];
+    excludeGlobs: string[];
+    namespace?: string;
+    privacyClass?: string;
+    folderRules: NativeKnowledgeFolderRuleConfig[];
+    dailyNotePatterns: string[];
+    materializeBacklinks: boolean;
+}
+interface NativeKnowledgeOpenClawWorkspaceConfig {
+    enabled: boolean;
+    bootstrapFiles: string[];
+    handoffGlobs: string[];
+    dailySummaryGlobs: string[];
+    automationNoteGlobs: string[];
+    workspaceDocGlobs: string[];
+    excludeGlobs: string[];
+    sharedSafeGlobs: string[];
+}
+interface AgentAccessHttpConfig {
+    enabled: boolean;
+    host: string;
+    port: number;
+    authToken?: string;
+    principal?: string;
+    maxBodyBytes: number;
+}
+declare function confidenceTier(score: number): ConfidenceTier;
+/** Default TTL in days for speculative memories (auto-expire if unconfirmed) */
+declare const SPECULATIVE_TTL_DAYS = 30;
+interface PluginConfig {
+    openaiApiKey: string | undefined;
+    openaiBaseUrl: string | undefined;
+    model: string;
+    reasoningEffort: ReasoningEffort;
+    triggerMode: TriggerMode;
+    bufferMaxTurns: number;
+    bufferMaxMinutes: number;
+    consolidateEveryN: number;
+    highSignalPatterns: string[];
+    maxMemoryTokens: number;
+    memoryOsPreset?: MemoryOsPresetName;
+    qmdEnabled: boolean;
+    qmdCollection: string;
+    qmdMaxResults: number;
+    qmdColdTierEnabled?: boolean;
+    qmdColdCollection?: string;
+    qmdColdMaxResults?: number;
+    qmdTierMigrationEnabled: boolean;
+    qmdTierDemotionMinAgeDays: number;
+    qmdTierDemotionValueThreshold: number;
+    qmdTierPromotionValueThreshold: number;
+    qmdTierParityGraphEnabled: boolean;
+    qmdTierParityHiMemEnabled: boolean;
+    qmdTierAutoBackfillEnabled: boolean;
+    embeddingFallbackEnabled: boolean;
+    embeddingFallbackProvider: "auto" | "openai" | "local";
+    /** Optional absolute path to qmd binary. If unset, PATH/fallback discovery is used. */
+    qmdPath?: string;
+    memoryDir: string;
+    debug: boolean;
+    identityEnabled: boolean;
+    identityContinuityEnabled: boolean;
+    identityInjectionMode: IdentityInjectionMode;
+    identityMaxInjectChars: number;
+    continuityIncidentLoggingEnabled: boolean;
+    continuityAuditEnabled: boolean;
+    sessionObserverEnabled?: boolean;
+    sessionObserverDebounceMs?: number;
+    sessionObserverBands?: SessionObserverBandConfig[];
+    injectQuestions: boolean;
+    commitmentDecayDays: number;
+    workspaceDir: string;
+    captureMode: CaptureMode;
+    fileHygiene?: FileHygieneConfig;
+    nativeKnowledge?: NativeKnowledgeConfig;
+    agentAccessHttp: AgentAccessHttpConfig;
+    accessTrackingEnabled: boolean;
+    accessTrackingBufferMaxSize: number;
+    recencyWeight: number;
+    boostAccessCount: boolean;
+    /** Record empty recall impressions (memoryIds: []) when no memories are injected. Disabled by default. */
+    recordEmptyRecallImpressions: boolean;
+    queryExpansionEnabled: boolean;
+    queryExpansionMaxQueries: number;
+    /** Minimum token length to consider for query expansion. */
+    queryExpansionMinTokenLen: number;
+    rerankEnabled: boolean;
+    /** Rerank provider. "local" uses Local LLM only; "cloud" uses gateway fallback chain. */
+    rerankProvider: "local" | "cloud";
+    rerankMaxCandidates: number;
+    rerankTimeoutMs: number;
+    rerankCacheEnabled: boolean;
+    rerankCacheTtlMs: number;
+    feedbackEnabled: boolean;
+    /** If true, allow recording negative examples and apply a soft penalty during ranking. */
+    negativeExamplesEnabled: boolean;
+    /** Score penalty per "not useful" hit (typical QMD scores ~0-1). Keep small. */
+    negativeExamplesPenaltyPerHit: number;
+    /** Maximum penalty applied from negative examples. */
+    negativeExamplesPenaltyCap: number;
+    chunkingEnabled: boolean;
+    chunkingTargetTokens: number;
+    chunkingMinTokens: number;
+    chunkingOverlapSentences: number;
+    contradictionDetectionEnabled: boolean;
+    contradictionSimilarityThreshold: number;
+    contradictionMinConfidence: number;
+    contradictionAutoResolve: boolean;
+    memoryLinkingEnabled: boolean;
+    threadingEnabled: boolean;
+    threadingGapMinutes: number;
+    summarizationEnabled: boolean;
+    summarizationTriggerCount: number;
+    summarizationRecentToKeep: number;
+    summarizationImportanceThreshold: number;
+    summarizationProtectedTags: string[];
+    topicExtractionEnabled: boolean;
+    topicExtractionTopN: number;
+    transcriptEnabled: boolean;
+    transcriptRetentionDays: number;
+    /** Channel types to skip from transcript logging (e.g., ["cron"]) */
+    transcriptSkipChannelTypes: string[];
+    transcriptRecallHours: number;
+    maxTranscriptTurns: number;
+    maxTranscriptTokens: number;
+    checkpointEnabled: boolean;
+    checkpointTurns: number;
+    compactionResetEnabled: boolean;
+    hourlySummariesEnabled: boolean;
+    daySummaryEnabled: boolean;
+    /** If true, Engram may attempt to auto-register an hourly summary cron job (default off). */
+    hourlySummaryCronAutoRegister: boolean;
+    /** If true, Engram may attempt to auto-register the nightly governance cron job (default off). */
+    nightlyGovernanceCronAutoRegister: boolean;
+    summaryRecallHours: number;
+    maxSummaryCount: number;
+    summaryModel: string;
+    hourlySummariesExtendedEnabled: boolean;
+    hourlySummariesIncludeToolStats: boolean;
+    hourlySummariesIncludeSystemMessages: boolean;
+    hourlySummariesMaxTurnsPerRun: number;
+    conversationIndexEnabled: boolean;
+    conversationIndexBackend: "qmd" | "faiss";
+    conversationIndexQmdCollection: string;
+    conversationIndexRetentionDays: number;
+    conversationIndexMinUpdateIntervalMs: number;
+    conversationIndexEmbedOnUpdate: boolean;
+    conversationIndexFaissScriptPath?: string;
+    conversationIndexFaissPythonBin?: string;
+    conversationIndexFaissModelId: string;
+    conversationIndexFaissIndexDir: string;
+    conversationIndexFaissUpsertTimeoutMs: number;
+    conversationIndexFaissSearchTimeoutMs: number;
+    conversationIndexFaissHealthTimeoutMs: number;
+    conversationIndexFaissMaxBatchSize: number;
+    conversationIndexFaissMaxSearchK: number;
+    conversationRecallTopK: number;
+    conversationRecallMaxChars: number;
+    conversationRecallTimeoutMs: number;
+    evalHarnessEnabled: boolean;
+    evalShadowModeEnabled: boolean;
+    benchmarkBaselineSnapshotsEnabled: boolean;
+    benchmarkDeltaReporterEnabled: boolean;
+    benchmarkStoredBaselineEnabled: boolean;
+    evalStoreDir: string;
+    objectiveStateMemoryEnabled: boolean;
+    objectiveStateSnapshotWritesEnabled: boolean;
+    objectiveStateRecallEnabled: boolean;
+    objectiveStateStoreDir: string;
+    causalTrajectoryMemoryEnabled: boolean;
+    causalTrajectoryStoreDir: string;
+    causalTrajectoryRecallEnabled: boolean;
+    actionGraphRecallEnabled: boolean;
+    trustZonesEnabled: boolean;
+    quarantinePromotionEnabled: boolean;
+    trustZoneStoreDir: string;
+    trustZoneRecallEnabled: boolean;
+    memoryPoisoningDefenseEnabled: boolean;
+    memoryRedTeamBenchEnabled: boolean;
+    harmonicRetrievalEnabled: boolean;
+    abstractionAnchorsEnabled: boolean;
+    abstractionNodeStoreDir: string;
+    verifiedRecallEnabled: boolean;
+    semanticRulePromotionEnabled: boolean;
+    semanticRuleVerificationEnabled: boolean;
+    semanticConsolidationEnabled: boolean;
+    semanticConsolidationModel: string;
+    semanticConsolidationThreshold: number;
+    semanticConsolidationMinClusterSize: number;
+    semanticConsolidationExcludeCategories: string[];
+    semanticConsolidationIntervalHours: number;
+    semanticConsolidationMaxPerRun: number;
+    creationMemoryEnabled: boolean;
+    memoryUtilityLearningEnabled: boolean;
+    promotionByOutcomeEnabled: boolean;
+    commitmentLedgerEnabled: boolean;
+    commitmentLifecycleEnabled: boolean;
+    commitmentStaleDays: number;
+    commitmentLedgerDir: string;
+    resumeBundlesEnabled: boolean;
+    resumeBundleDir: string;
+    workProductRecallEnabled: boolean;
+    workProductLedgerDir: string;
+    workTasksEnabled: boolean;
+    workProjectsEnabled: boolean;
+    workTasksDir: string;
+    workProjectsDir: string;
+    workIndexEnabled: boolean;
+    workIndexDir: string;
+    workTaskIndexEnabled: boolean;
+    workProjectIndexEnabled: boolean;
+    workIndexAutoRebuildEnabled: boolean;
+    workIndexAutoRebuildDebounceMs: number;
+    localLlmEnabled: boolean;
+    localLlmUrl: string;
+    localLlmModel: string;
+    /** Optional API key for authenticated OpenAI-compatible endpoints. */
+    localLlmApiKey?: string;
+    /** Additional headers for local/compatible endpoint requests. */
+    localLlmHeaders?: Record<string, string>;
+    /** If false, do not send Authorization header even when localLlmApiKey is set. */
+    localLlmAuthHeader: boolean;
+    localLlmFallback: boolean;
+    /** Optional home directory override for local LLM helpers (LM Studio settings, CLI PATH). */
+    localLlmHomeDir?: string;
+    /** Optional absolute path to LMS CLI binary (preferred over auto-detection). */
+    localLmsCliPath?: string;
+    /** Optional bin directory prepended to PATH for LMS CLI execution. */
+    localLmsBinDir?: string;
+    /** Hard timeout for local LLM requests (ms). */
+    localLlmTimeoutMs: number;
+    /** Max context window for local LLM (override auto-detection). Set lower if your LLM server defaults to smaller contexts. */
+    localLlmMaxContext?: number;
+    /** If true, log slow operations (local LLM + related I/O) with durations and metadata (no content). */
+    slowLogEnabled: boolean;
+    /**
+     * If true, include the full recalled memory text in `RecallTraceEvent.recalledContent`.
+     * Disabled by default — enable only when you want external trace subscribers (e.g. Langfuse)
+     * to see the exact memory context injected into each conversation turn.
+     * This adds payload to trace events but does not log to files or the gateway log.
+     */
+    traceRecallContent: boolean;
+    /** Threshold for slow operation logging (ms). */
+    slowLogThresholdMs: number;
+    /** If true, collect and persist timing traces for recall and extraction pipelines. */
+    profilingEnabled: boolean;
+    /** Directory for profiling trace JSONL files. Defaults to <memoryDir>/profiling. */
+    profilingStorageDir: string;
+    /** Maximum number of trace files to keep (rolling window). */
+    profilingMaxTraces: number;
+    extractionDedupeEnabled: boolean;
+    extractionDedupeWindowMs: number;
+    extractionMinChars: number;
+    extractionMinUserTurns: number;
+    extractionMaxTurnChars: number;
+    extractionMaxFactsPerRun: number;
+    extractionMaxEntitiesPerRun: number;
+    extractionMaxQuestionsPerRun: number;
+    extractionMaxProfileUpdatesPerRun: number;
+    consolidationRequireNonZeroExtraction: boolean;
+    consolidationMinIntervalMs: number;
+    qmdMaintenanceEnabled: boolean;
+    qmdMaintenanceDebounceMs: number;
+    qmdAutoEmbedEnabled: boolean;
+    qmdEmbedMinIntervalMs: number;
+    qmdUpdateTimeoutMs: number;
+    qmdUpdateMinIntervalMs: number;
+    localLlmRetry5xxCount: number;
+    localLlmRetryBackoffMs: number;
+    localLlm400TripThreshold: number;
+    localLlm400CooldownMs: number;
+    localLlmFastEnabled: boolean;
+    localLlmFastModel: string;
+    localLlmFastUrl: string;
+    localLlmFastTimeoutMs: number;
+    gatewayConfig?: GatewayConfig;
+    modelSource: "plugin" | "gateway";
+    gatewayAgentId: string;
+    fastGatewayAgentId: string;
+    namespacesEnabled: boolean;
+    defaultNamespace: string;
+    sharedNamespace: string;
+    principalFromSessionKeyMode: PrincipalFromSessionKeyMode;
+    principalFromSessionKeyRules: PrincipalRule[];
+    namespacePolicies: NamespacePolicy[];
+    defaultRecallNamespaces: Array<"self" | "shared">;
+    cronRecallMode: CronRecallMode;
+    cronRecallAllowlist: string[];
+    cronRecallPolicyEnabled: boolean;
+    cronRecallNormalizedQueryMaxChars: number;
+    cronRecallInstructionHeavyTokenCap: number;
+    cronConversationRecallMode: CronConversationRecallMode;
+    autoPromoteToSharedEnabled: boolean;
+    autoPromoteToSharedCategories: Array<"fact" | "correction" | "decision" | "preference">;
+    autoPromoteMinConfidenceTier: ConfidenceTier;
+    routingRulesEnabled: boolean;
+    routingRulesStateFile: string;
+    sharedContextEnabled: boolean;
+    sharedContextDir?: string;
+    sharedContextMaxInjectChars: number;
+    crossSignalsSemanticEnabled: boolean;
+    crossSignalsSemanticTimeoutMs: number;
+    sharedCrossSignalSemanticEnabled?: boolean;
+    sharedCrossSignalSemanticTimeoutMs?: number;
+    sharedCrossSignalSemanticMaxCandidates?: number;
+    compoundingEnabled: boolean;
+    compoundingWeeklyCronEnabled: boolean;
+    compoundingSemanticEnabled: boolean;
+    compoundingSynthesisTimeoutMs: number;
+    compoundingInjectEnabled: boolean;
+    ircEnabled: boolean;
+    ircMaxPreferences: number;
+    ircIncludeCorrections: boolean;
+    ircMinConfidence: number;
+    cmcEnabled: boolean;
+    cmcStitchLookbackDays: number;
+    cmcStitchMinScore: number;
+    cmcStitchMaxEdgesPerTrajectory: number;
+    cmcConsolidationEnabled: boolean;
+    cmcConsolidationMinRecurrence: number;
+    cmcConsolidationMinSessions: number;
+    cmcConsolidationSuccessThreshold: number;
+    cmcRetrievalEnabled: boolean;
+    cmcRetrievalMaxDepth: number;
+    cmcRetrievalMaxChars: number;
+    cmcRetrievalCounterfactualBoost: number;
+    cmcBehaviorLearningEnabled: boolean;
+    cmcBehaviorMinFrequency: number;
+    cmcBehaviorMinSessions: number;
+    cmcBehaviorConfidenceThreshold: number;
+    cmcLifecycleCausalImpactWeight: number;
+    calibrationEnabled: boolean;
+    calibrationMaxRulesPerRecall: number;
+    calibrationMaxChars: number;
+    searchBackend?: "qmd" | "remote" | "noop" | "lancedb" | "meilisearch" | "orama";
+    remoteSearchBaseUrl?: string;
+    remoteSearchApiKey?: string;
+    remoteSearchTimeoutMs?: number;
+    lancedbEnabled: boolean;
+    lanceDbPath?: string;
+    lanceEmbeddingDimension?: number;
+    meilisearchEnabled: boolean;
+    meilisearchHost?: string;
+    meilisearchApiKey?: string;
+    meilisearchTimeoutMs?: number;
+    meilisearchAutoIndex?: boolean;
+    oramaEnabled: boolean;
+    oramaDbPath?: string;
+    oramaEmbeddingDimension?: number;
+    qmdDaemonEnabled: boolean;
+    qmdDaemonUrl: string;
+    qmdDaemonRecheckIntervalMs: number;
+    qmdIntentHintsEnabled: boolean;
+    qmdExplainEnabled: boolean;
+    knowledgeIndexEnabled: boolean;
+    knowledgeIndexMaxEntities: number;
+    knowledgeIndexMaxChars: number;
+    entityRetrievalEnabled: boolean;
+    entityRetrievalMaxChars: number;
+    entityRetrievalMaxHints: number;
+    entityRetrievalMaxSupportingFacts: number;
+    entityRetrievalMaxRelatedEntities: number;
+    entityRetrievalRecentTurns: number;
+    recallBudgetChars: number;
+    recallOuterTimeoutMs: number;
+    recallCoreDeadlineMs: number;
+    recallEnrichmentDeadlineMs: number;
+    recallPipeline: RecallSectionConfig[];
+    qmdRecallCacheTtlMs: number;
+    qmdRecallCacheStaleTtlMs: number;
+    qmdRecallCacheMaxEntries: number;
+    entityRelationshipsEnabled: boolean;
+    entityActivityLogEnabled: boolean;
+    entityActivityLogMaxEntries: number;
+    entityAliasesEnabled: boolean;
+    entitySummaryEnabled: boolean;
+    /** Enable content-hash deduplication to prevent storing semantically identical facts. */
+    factDeduplicationEnabled: boolean;
+    /** Enable automatic archival of old, low-importance, rarely-accessed facts. */
+    factArchivalEnabled: boolean;
+    /** Minimum age in days before a fact is eligible for archival. */
+    factArchivalAgeDays: number;
+    /** Maximum importance score for archival eligibility (0-1). Only facts below this are archived. */
+    factArchivalMaxImportance: number;
+    /** Maximum access count for archival eligibility. Only rarely-accessed facts are archived. */
+    factArchivalMaxAccessCount: number;
+    /** Tags that protect a fact from archival regardless of other criteria. */
+    factArchivalProtectedCategories: string[];
+    lifecyclePolicyEnabled: boolean;
+    lifecycleFilterStaleEnabled: boolean;
+    lifecyclePromoteHeatThreshold: number;
+    lifecycleStaleDecayThreshold: number;
+    lifecycleArchiveDecayThreshold: number;
+    lifecycleProtectedCategories: MemoryCategory[];
+    lifecycleMetricsEnabled: boolean;
+    proactiveExtractionEnabled: boolean;
+    contextCompressionActionsEnabled: boolean;
+    compressionGuidelineLearningEnabled: boolean;
+    compressionGuidelineSemanticRefinementEnabled: boolean;
+    compressionGuidelineSemanticTimeoutMs: number;
+    maxProactiveQuestionsPerExtraction: number;
+    proactiveExtractionTimeoutMs: number;
+    proactiveExtractionMaxTokens: number;
+    extractionMaxOutputTokens: number;
+    proactiveExtractionCategoryAllowlist?: MemoryCategory[];
+    maxCompressionTokensPerHour: number;
+    behaviorLoopAutoTuneEnabled: boolean;
+    behaviorLoopLearningWindowDays: number;
+    behaviorLoopMinSignalCount: number;
+    behaviorLoopMaxDeltaPerCycle: number;
+    behaviorLoopProtectedParams: string[];
+    recallPlannerEnabled: boolean;
+    recallPlannerModel: string;
+    recallPlannerTimeoutMs: number;
+    recallPlannerUseResponsesApi: boolean;
+    recallPlannerMaxPromptChars: number;
+    recallPlannerMaxMemoryHints: number;
+    recallPlannerShadowMode: boolean;
+    recallPlannerTelemetryEnabled: boolean;
+    recallPlannerMaxQmdResultsMinimal: number;
+    recallPlannerMaxQmdResultsFull: number;
+    intentRoutingEnabled: boolean;
+    intentRoutingBoost: number;
+    verbatimArtifactsEnabled: boolean;
+    verbatimArtifactsMinConfidence: number;
+    verbatimArtifactsMaxRecall: number;
+    verbatimArtifactCategories: MemoryCategory[];
+    memoryBoxesEnabled: boolean;
+    /** Jaccard overlap threshold below which a topic shift triggers box sealing (0-1, default 0.35) */
+    boxTopicShiftThreshold: number;
+    /** Time gap in ms before an open box is sealed (default 30 min) */
+    boxTimeGapMs: number;
+    /** Max memories per box before forced seal */
+    boxMaxMemories: number;
+    traceWeaverEnabled: boolean;
+    /** Days back to search for trace links */
+    traceWeaverLookbackDays: number;
+    /** Minimum Jaccard overlap to assign the same traceId (0-1, default 0.4) */
+    traceWeaverOverlapThreshold: number;
+    /** Number of recent days of boxes to inject during recall */
+    boxRecallDays: number;
+    /** Classify extracted memories as episode or note and tag with memoryKind */
+    episodeNoteModeEnabled: boolean;
+    /** Build and maintain temporal (state/index_time.json) and tag (state/index_tags.json) indexes */
+    queryAwareIndexingEnabled: boolean;
+    /** Max candidate paths returned from index prefilter (0 = no cap) */
+    queryAwareIndexingMaxCandidates: number;
+    temporalIndexWindowDays: number;
+    temporalIndexMaxEntries: number;
+    temporalBoostRecentDays: number;
+    temporalBoostScore: number;
+    temporalDecayEnabled: boolean;
+    tagMemoryEnabled: boolean;
+    tagMaxPerMemory: number;
+    tagIndexMaxEntries: number;
+    tagRecallBoost: number;
+    tagRecallMaxMatches: number;
+    multiGraphMemoryEnabled: boolean;
+    graphRecallEnabled: boolean;
+    graphRecallMaxExpansions: number;
+    graphRecallMaxPerSeed: number;
+    graphRecallMinEdgeWeight: number;
+    graphRecallShadowEnabled: boolean;
+    graphRecallSnapshotEnabled: boolean;
+    graphRecallShadowSampleRate: number;
+    graphRecallExplainToolEnabled: boolean;
+    graphRecallStoreColdMirror: boolean;
+    graphRecallColdMirrorCollection?: string;
+    graphRecallColdMirrorMinAgeDays: number;
+    graphRecallUseEntityPriors: boolean;
+    graphRecallEntityPriorBoost: number;
+    graphRecallPreferHubSeeds: boolean;
+    graphRecallHubBias: number;
+    graphRecallRecencyHalfLifeDays: number;
+    graphRecallDampingFactor: number;
+    graphRecallMaxSeedNodes: number;
+    graphRecallMaxExpandedNodes: number;
+    graphRecallMaxTrailPerNode: number;
+    graphRecallMinSeedScore: number;
+    graphRecallExpansionScoreThreshold: number;
+    graphRecallExplainMaxPaths: number;
+    graphRecallExplainMaxChars: number;
+    graphRecallExplainEdgeLimit: number;
+    graphRecallExplainEnabled: boolean;
+    graphRecallEntityHintsEnabled: boolean;
+    graphRecallEntityHintMax: number;
+    graphRecallEntityHintMaxChars: number;
+    graphRecallSnapshotDir: string;
+    graphRecallEnableTrace: boolean;
+    graphRecallEnableDebug: boolean;
+    /** Allow graph_mode escalation for broader causal/timeline phrasing beyond strict keywords. */
+    graphExpandedIntentEnabled?: boolean;
+    /** Run bounded graph expansion in full mode when enough recall seeds exist. */
+    graphAssistInFullModeEnabled?: boolean;
+    /** In full mode, compute graph assist for telemetry/snapshotting but do not inject merged results. */
+    graphAssistShadowEvalEnabled?: boolean;
+    /** Minimum seed results required before full-mode graph assist runs. */
+    graphAssistMinSeedResults?: number;
+    entityGraphEnabled: boolean;
+    timeGraphEnabled: boolean;
+    /** When true, write fallback temporal adjacency edges for consecutive extracted memories. */
+    graphWriteSessionAdjacencyEnabled?: boolean;
+    causalGraphEnabled: boolean;
+    maxGraphTraversalSteps: number;
+    graphActivationDecay: number;
+    /** Weight of graph activation score when blending with seed QMD score (0-1). */
+    graphExpansionActivationWeight: number;
+    /** Lower bound for blended graph-expanded recall scores (0-1). */
+    graphExpansionBlendMin: number;
+    /** Upper bound for blended graph-expanded recall scores (0-1). */
+    graphExpansionBlendMax: number;
+    maxEntityGraphEdgesPerMemory: number;
+    /** SimpleMem-inspired de-linearization: resolve pronouns and anchor relative dates after extraction. */
+    delinearizeEnabled: boolean;
+    /** Synapse-inspired confidence gate — skip memory injection when top score is below threshold. */
+    recallConfidenceGateEnabled: boolean;
+    recallConfidenceGateThreshold: number;
+    /** PlugMem-inspired causal rule extraction: mine IF→THEN rules during consolidation. */
+    causalRuleExtractionEnabled: boolean;
+    /** E-Mem-inspired memory reconstruction: targeted retrieval for missing entity context. */
+    memoryReconstructionEnabled: boolean;
+    /** Maximum number of entity expansions per recall. */
+    memoryReconstructionMaxExpansions: number;
+    /** Synapse-inspired lateral inhibition to suppress hub-node dominance. */
+    graphLateralInhibitionEnabled: boolean;
+    /** Inhibition strength (default 0.15). Higher = more suppression. */
+    graphLateralInhibitionBeta: number;
+    /** Number of top competing nodes considered for inhibition (default 7). */
+    graphLateralInhibitionTopM: number;
+    temporalMemoryTreeEnabled: boolean;
+    tmtHourlyMinMemories: number;
+    tmtSummaryMaxTokens: number;
+    lcmEnabled: boolean;
+    lcmLeafBatchSize: number;
+    lcmRollupFanIn: number;
+    lcmFreshTailTurns: number;
+    lcmMaxDepth: number;
+    lcmRecallBudgetShare: number;
+    lcmDeterministicMaxTokens: number;
+    lcmArchiveRetentionDays: number;
+    /** Enable three-agent parallel retrieval (DirectFact + Contextual + Temporal). Default false. */
+    parallelRetrievalEnabled: boolean;
+    /** Per-agent source weights for score blending during merge. */
+    parallelAgentWeights: {
+        direct: number;
+        contextual: number;
+        temporal: number;
+    };
+    /** Max results fetched per agent before merge. */
+    parallelMaxResultsPerAgent: number;
+}
+interface BootstrapOptions {
+    dryRun?: boolean;
+    sessionsDir?: string;
+    limit?: number;
+    since?: Date;
+}
+interface BootstrapResult {
+    sessionsScanned: number;
+    turnsProcessed: number;
+    highSignalTurns: number;
+    memoriesCreated: number;
+    skipped: number;
+}
+interface PrincipalRule {
+    match: string;
+    principal: string;
+}
+interface NamespacePolicy {
+    name: string;
+    readPrincipals: string[];
+    writePrincipals: string[];
+    includeInRecallByDefault?: boolean;
+}
+interface RelevanceFeedback {
+    up: number;
+    down: number;
+    lastUpdatedAt: string;
+    notes?: string[];
+}
+interface BufferTurn {
+    role: "user" | "assistant";
+    content: string;
+    timestamp: string;
+    sessionKey?: string;
+}
+interface BufferState {
+    turns: BufferTurn[];
+    lastExtractionAt: string | null;
+    extractionCount: number;
+}
+interface BehaviorLoopAdjustment {
+    parameter: string;
+    previousValue: number;
+    nextValue: number;
+    delta: number;
+    evidenceCount: number;
+    confidence: number;
+    reason: string;
+    appliedAt: string;
+}
+interface BehaviorLoopPolicyState {
+    version: number;
+    windowDays: number;
+    minSignalCount: number;
+    maxDeltaPerCycle: number;
+    protectedParams: string[];
+    adjustments: BehaviorLoopAdjustment[];
+    updatedAt: string;
+}
+type BehaviorSignalType = "correction_override" | "preference_affinity" | "topic_revisitation" | "action_pattern" | "outcome_preference" | "phrasing_style";
+type BehaviorSignalDirection = "positive" | "negative";
+interface BehaviorSignalEvent {
+    timestamp: string;
+    namespace: string;
+    memoryId: string;
+    category: Extract<MemoryCategory, "correction" | "preference">;
+    signalType: BehaviorSignalType;
+    direction: BehaviorSignalDirection;
+    confidence: number;
+    signalHash: string;
+    source: "extraction" | "correction";
+}
+/** Memory status for lifecycle management */
+type MemoryStatus = "active" | "pending_review" | "rejected" | "quarantined" | "superseded" | "archived";
+type LifecycleState = "candidate" | "validated" | "active" | "stale" | "archived";
+type VerificationState = "unverified" | "user_confirmed" | "system_inferred" | "disputed";
+type PolicyClass = "ephemeral" | "durable" | "protected";
+/** Importance level tiers */
+type ImportanceLevel = "critical" | "high" | "normal" | "low" | "trivial";
+/** Importance scoring result */
+interface ImportanceScore {
+    /** Numeric score 0-1 */
+    score: number;
+    /** Tier level */
+    level: ImportanceLevel;
+    /** Reasons for this score */
+    reasons: string[];
+    /** Salient keywords extracted */
+    keywords: string[];
+}
+interface MemoryFrontmatter {
+    id: string;
+    category: MemoryCategory;
+    created: string;
+    updated: string;
+    source: string;
+    confidence: number;
+    confidenceTier: ConfidenceTier;
+    tags: string[];
+    entityRef?: string;
+    supersedes?: string;
+    /** ISO 8601 date — memory expires and gets cleaned up after this date */
+    expiresAt?: string;
+    /** IDs of parent memories this was derived from (lineage tracking) */
+    lineage?: string[];
+    /** Memory status: active (default), pending_review, rejected, quarantined, superseded, or archived */
+    status?: MemoryStatus;
+    /** ID of memory that superseded this one */
+    supersededBy?: string;
+    /** Timestamp when superseded */
+    supersededAt?: string;
+    /** Timestamp when archived */
+    archivedAt?: string;
+    /** Policy-driven lifecycle state used for retrieval eligibility/ranking. */
+    lifecycleState?: LifecycleState;
+    /** Verification provenance used by lifecycle policy. */
+    verificationState?: VerificationState;
+    /** Policy class used by lifecycle guardrails. */
+    policyClass?: PolicyClass;
+    /** Last lifecycle validation timestamp (ISO 8601). */
+    lastValidatedAt?: string;
+    /** Lifecycle decay score in [0,1]. */
+    decayScore?: number;
+    /** Lifecycle heat score in [0,1]. */
+    heatScore?: number;
+    /** Number of times this memory has been retrieved */
+    accessCount?: number;
+    /** Last time this memory was accessed (ISO 8601) */
+    lastAccessed?: string;
+    /** Importance score with level, reasons, and keywords */
+    importance?: ImportanceScore;
+    /** Parent memory ID if this is a chunk */
+    parentId?: string;
+    /** Chunk index within parent (0-based) */
+    chunkIndex?: number;
+    /** Total number of chunks for this parent */
+    chunkTotal?: number;
+    /** Links to other memories */
+    links?: MemoryLink[];
+    intentGoal?: string;
+    intentActionType?: string;
+    intentEntityTypes?: string[];
+    artifactType?: "decision" | "constraint" | "todo" | "definition" | "commitment" | "correction" | "fact";
+    sourceMemoryId?: string;
+    sourceTurnId?: string;
+    /** episode = time-specific event; note = stable belief/preference/decision */
+    memoryKind?: "episode" | "note";
+    /** Structured key-value attributes extracted from the content (e.g., product attributes, dates, quantities). */
+    structuredAttributes?: Record<string, string>;
+}
+/** Memory link relationship types */
+type MemoryLinkType = "follows" | "references" | "contradicts" | "supports" | "related";
+/** A link between memories */
+interface MemoryLink {
+    targetId: string;
+    linkType: MemoryLinkType;
+    strength: number;
+    reason?: string;
+}
+interface ConversationThread {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    sessionKey?: string;
+    episodeIds: string[];
+    linkedThreadIds: string[];
+}
+interface MemorySummary {
+    id: string;
+    createdAt: string;
+    timeRangeStart: string;
+    timeRangeEnd: string;
+    summaryText: string;
+    keyFacts: string[];
+    keyEntities: string[];
+    sourceEpisodeIds: string[];
+}
+interface DaySummaryResult {
+    summary: string;
+    bullets: string[];
+    next_actions: string[];
+    risks_or_open_loops: string[];
+}
+interface TopicScore {
+    term: string;
+    score: number;
+    count: number;
+}
+interface MemoryFile {
+    path: string;
+    frontmatter: MemoryFrontmatter;
+    content: string;
+}
+interface ExtractedFact {
+    category: MemoryCategory;
+    content: string;
+    confidence: number;
+    tags: string[];
+    entityRef?: string;
+    source?: ExtractionPassSource;
+    promptedByQuestion?: string;
+    /** Structured key-value attributes extracted from the content (e.g., product attributes, dates, quantities). */
+    structuredAttributes?: Record<string, string>;
+}
+interface MemoryIntent {
+    goal: string;
+    actionType: string;
+    entityTypes: string[];
+}
+interface ExtractedQuestion {
+    question: string;
+    context: string;
+    priority: number;
+}
+interface QuestionEntry {
+    id: string;
+    question: string;
+    context: string;
+    priority: number;
+    created: string;
+    resolved: boolean;
+    resolvedAt?: string;
+}
+interface ExtractionResult {
+    facts: ExtractedFact[];
+    profileUpdates: string[];
+    entities: EntityMention[];
+    questions: ExtractedQuestion[];
+    identityReflection?: string;
+    relationships?: ExtractedRelationship[];
+}
+interface EntityMention {
+    name: string;
+    type: "person" | "project" | "tool" | "company" | "place" | "other";
+    facts: string[];
+    source?: ExtractionPassSource;
+    promptedByQuestion?: string;
+}
+interface EntityRelationship {
+    target: string;
+    label: string;
+}
+interface EntityActivityEntry {
+    date: string;
+    note: string;
+}
+interface EntityFile {
+    name: string;
+    type: string;
+    updated: string;
+    facts: string[];
+    summary?: string;
+    relationships: EntityRelationship[];
+    activity: EntityActivityEntry[];
+    aliases: string[];
+}
+interface ScoredEntity {
+    name: string;
+    type: string;
+    score: number;
+    factCount: number;
+    summary?: string;
+    topRelationships: string[];
+}
+interface ExtractedRelationship {
+    source: string;
+    target: string;
+    label: string;
+    extractionSource?: ExtractionPassSource;
+    promptedByQuestion?: string;
+}
+interface ConsolidationItem {
+    existingId: string;
+    action: ConsolidationAction;
+    mergeWith?: string;
+    updatedContent?: string;
+    reason: string;
+}
+interface ConsolidationResult {
+    items: ConsolidationItem[];
+    profileUpdates: string[];
+    entityUpdates: EntityMention[];
+}
+interface QmdSearchResult {
+    docid: string;
+    path: string;
+    snippet: string;
+    score: number;
+    explain?: QmdSearchExplain;
+    transport?: "daemon" | "subprocess" | "hybrid" | "scoped_prefilter";
+}
+interface QmdSearchExplain {
+    ftsScores?: number[];
+    vectorScores?: number[];
+    rrf?: number;
+    rerankScore?: number;
+    blendedScore?: number;
+}
+interface MetaState {
+    extractionCount: number;
+    lastExtractionAt: string | null;
+    lastConsolidationAt: string | null;
+    totalMemories: number;
+    totalEntities: number;
+}
+type MemoryActionType = "store_episode" | "store_note" | "update_note" | "create_artifact" | "summarize_node" | "discard" | "link_graph";
+type MemoryActionOutcome = "applied" | "skipped" | "failed";
+type MemoryActionPolicyDecision = "allow" | "defer" | "deny";
+type MemoryActionStatus = "validated" | "applied" | "rejected";
+type MemoryActionEligibilitySource = "extraction" | "consolidation" | "replay" | "manual" | "unknown";
+interface MemoryActionEligibilityContext {
+    confidence: number;
+    lifecycleState: LifecycleState;
+    importance: number;
+    source: MemoryActionEligibilitySource;
+}
+interface MemoryActionPolicyResult {
+    action: MemoryActionType;
+    decision: MemoryActionPolicyDecision;
+    rationale: string;
+    eligibility: MemoryActionEligibilityContext;
+}
+interface MemoryActionEvent {
+    schemaVersion?: number;
+    actionId?: string;
+    timestamp: string;
+    action: MemoryActionType;
+    outcome: MemoryActionOutcome;
+    status?: MemoryActionStatus;
+    actor?: string;
+    subsystem?: string;
+    reason?: string;
+    memoryId?: string;
+    namespace?: string;
+    sessionKey?: string;
+    sourceSessionKey?: string;
+    checkpointCapturedAt?: string;
+    checkpointTtl?: string;
+    checkpointTurnCount?: number;
+    inputSummary?: string;
+    outputMemoryIds?: string[];
+    dryRun?: boolean;
+    policyVersion?: string;
+    promptHash?: string;
+    policyDecision?: MemoryActionPolicyDecision;
+    policyRationale?: string;
+    policyEligibility?: MemoryActionEligibilityContext;
+}
+type MemoryLifecycleEventType = "created" | "updated" | "superseded" | "archived" | "rejected" | "restored" | "merged" | "imported" | "promoted" | "explicit_capture_accepted" | "explicit_capture_queued";
+interface MemoryLifecycleStateSummary {
+    category?: MemoryCategory;
+    path?: string;
+    status?: MemoryStatus;
+    lifecycleState?: LifecycleState;
+}
+interface MemoryLifecycleEvent {
+    eventId: string;
+    memoryId: string;
+    eventType: MemoryLifecycleEventType;
+    timestamp: string;
+    actor: string;
+    reasonCode?: string;
+    ruleVersion: string;
+    relatedMemoryIds?: string[];
+    before?: MemoryLifecycleStateSummary;
+    after?: MemoryLifecycleStateSummary;
+    correlationId?: string;
+}
+interface MemoryProjectionCurrentState {
+    memoryId: string;
+    category: MemoryCategory;
+    status: MemoryStatus;
+    lifecycleState?: LifecycleState;
+    path: string;
+    pathRel: string;
+    created: string;
+    updated: string;
+    archivedAt?: string;
+    supersededAt?: string;
+    entityRef?: string;
+    source: string;
+    confidence: number;
+    confidenceTier: ConfidenceTier;
+    memoryKind?: MemoryFrontmatter["memoryKind"];
+    accessCount?: number;
+    lastAccessed?: string;
+    tags?: string[];
+    preview?: string;
+}
+interface CompressionGuidelineOptimizerSourceWindow {
+    from: string;
+    to: string;
+}
+interface CompressionGuidelineOptimizerEventCounts {
+    total: number;
+    applied: number;
+    skipped: number;
+    failed: number;
+}
+type CompressionGuidelineActivationState = "draft" | "active";
+interface CompressionGuidelineOptimizerActionSummary {
+    action: MemoryActionType;
+    total: number;
+    outcomes: Record<MemoryActionOutcome, number>;
+    quality: {
+        good: number;
+        poor: number;
+        unknown: number;
+    };
+}
+interface CompressionGuidelineOptimizerRuleUpdate {
+    action: MemoryActionType;
+    delta: number;
+    direction: "increase" | "decrease" | "hold";
+    confidence: "low" | "medium" | "high";
+    notes: string[];
+}
+interface CompressionGuidelineOptimizerState {
+    version: number;
+    updatedAt: string;
+    sourceWindow: CompressionGuidelineOptimizerSourceWindow;
+    eventCounts: CompressionGuidelineOptimizerEventCounts;
+    guidelineVersion: number;
+    contentHash?: string;
+    activationState?: CompressionGuidelineActivationState;
+    actionSummaries?: CompressionGuidelineOptimizerActionSummary[];
+    ruleUpdates?: CompressionGuidelineOptimizerRuleUpdate[];
+}
+type ContinuityIncidentState = "open" | "closed";
+interface ContinuityIncidentRecord {
+    id: string;
+    state: ContinuityIncidentState;
+    openedAt: string;
+    updatedAt: string;
+    triggerWindow?: string;
+    symptom: string;
+    suspectedCause?: string;
+    fixApplied?: string;
+    verificationResult?: string;
+    preventiveRule?: string;
+    closedAt?: string;
+    filePath?: string;
+}
+interface ContinuityIncidentOpenInput {
+    triggerWindow?: string;
+    symptom: string;
+    suspectedCause?: string;
+}
+interface ContinuityIncidentCloseInput {
+    fixApplied: string;
+    verificationResult: string;
+    preventiveRule?: string;
+}
+type ContinuityLoopCadence = "daily" | "weekly" | "monthly" | "quarterly";
+type ContinuityLoopStatus = "active" | "paused" | "retired";
+interface ContinuityImprovementLoop {
+    id: string;
+    cadence: ContinuityLoopCadence;
+    purpose: string;
+    status: ContinuityLoopStatus;
+    killCondition: string;
+    lastReviewed: string;
+    notes?: string;
+}
+interface ContinuityLoopUpsertInput {
+    id: string;
+    cadence: ContinuityLoopCadence;
+    purpose: string;
+    status: ContinuityLoopStatus;
+    killCondition: string;
+    lastReviewed?: string;
+    notes?: string;
+}
+interface ContinuityLoopReviewInput {
+    status?: ContinuityLoopStatus;
+    notes?: string;
+    reviewedAt?: string;
+}
+/** Entry in the access tracking buffer (batched updates) */
+interface AccessTrackingEntry {
+    memoryId: string;
+    newCount: number;
+    lastAccessed: string;
+}
+interface SignalScanResult {
+    level: SignalLevel;
+    patterns: string[];
+}
+interface LlmTraceEvent {
+    kind: "llm_start" | "llm_end" | "llm_error";
+    traceId: string;
+    model: string;
+    operation: "extraction" | "consolidation" | "profile_consolidation" | "identity_consolidation" | "day_summary";
+    input?: string;
+    output?: string;
+    durationMs?: number;
+    error?: string;
+    tokenUsage?: {
+        input?: number;
+        output?: number;
+        total?: number;
+    };
+}
+interface RecallTraceEvent {
+    kind: "recall_summary";
+    traceId: string;
+    operation: "recall";
+    sessionKey?: string;
+    promptHash: string;
+    promptLength: number;
+    retrievalQueryHash: string;
+    retrievalQueryLength: number;
+    recallMode: RecallPlanMode;
+    recallResultLimit: number;
+    qmdEnabled: boolean;
+    qmdAvailable: boolean;
+    recallNamespaces: string[];
+    source: "none" | "hot_qmd" | "hot_embedding" | "cold_fallback" | "recent_scan";
+    recalledMemoryCount: number;
+    injected: boolean;
+    contextChars: number;
+    policyVersion?: string;
+    identityInjectionMode?: IdentityInjectionMode | "none";
+    identityInjectedChars?: number;
+    identityInjectionTruncated?: boolean;
+    durationMs: number;
+    timings?: Record<string, string>;
+    /**
+     * The full recalled memory context injected into the system prompt.
+     * Only populated when `traceRecallContent` config option is `true`.
+     * Omitted by default to avoid sending potentially sensitive memory content
+     * to external trace collectors unless explicitly opted in.
+     */
+    recalledContent?: string;
+}
+type EngramTraceEvent = LlmTraceEvent | RecallTraceEvent;
+type LlmTraceCallback = (event: EngramTraceEvent) => void;
+type ModelApi = "openai-completions" | "anthropic-messages" | "google-generative" | string;
+type ModelProviderAuthMode = "bearer" | "header" | "query";
+interface ModelDefinitionConfig {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    costPer1MInput?: number;
+    costPer1MOutput?: number;
+    aliases?: string[];
+}
+interface ModelProviderConfig {
+    baseUrl: string;
+    apiKey?: string | Record<string, unknown>;
+    auth?: ModelProviderAuthMode;
+    api?: ModelApi;
+    headers?: Record<string, string>;
+    authHeader?: boolean;
+    models: ModelDefinitionConfig[];
+}
+interface AgentDefaultsConfig {
+    model?: {
+        primary?: string;
+        backup?: string;
+        fallbacks?: string[];
+    };
+    thinking?: {
+        mode?: "off" | "on" | "adaptive";
+        budget?: number;
+    };
+}
+interface AgentPersonaModelConfig {
+    primary?: string;
+    fallbacks?: string[];
+}
+interface AgentPersona {
+    id: string;
+    name?: string;
+    model?: AgentPersonaModelConfig;
+}
+interface GatewayConfig {
+    agents?: {
+        defaults?: AgentDefaultsConfig;
+        list?: AgentPersona[];
+    };
+    models?: {
+        providers?: Record<string, ModelProviderConfig>;
+    };
+}
+interface TranscriptEntry {
+    timestamp: string;
+    role: "user" | "assistant";
+    content: string;
+    sessionKey: string;
+    turnId: string;
+    metadata?: {
+        compactAfter?: boolean;
+        compactionId?: string | null;
+    };
+}
+interface Checkpoint {
+    sessionKey: string;
+    capturedAt: string;
+    turns: TranscriptEntry[];
+    ttl: string;
+}
+interface HourlySummary {
+    hour: string;
+    sessionKey: string;
+    bullets: string[];
+    turnCount: number;
+    generatedAt: string;
+}
+
+export { type AccessTrackingEntry, type AgentAccessHttpConfig, type AgentDefaultsConfig, type AgentPersona, type AgentPersonaModelConfig, type BehaviorLoopAdjustment, type BehaviorLoopPolicyState, type BehaviorSignalDirection, type BehaviorSignalEvent, type BehaviorSignalType, type BootstrapOptions, type BootstrapResult, type BufferState, type BufferTurn, type CaptureMode, type Checkpoint, type CompressionGuidelineActivationState, type CompressionGuidelineOptimizerActionSummary, type CompressionGuidelineOptimizerEventCounts, type CompressionGuidelineOptimizerRuleUpdate, type CompressionGuidelineOptimizerSourceWindow, type CompressionGuidelineOptimizerState, type ConfidenceTier, type ConsolidationAction, type ConsolidationItem, type ConsolidationResult, type ContinuityImprovementLoop, type ContinuityIncidentCloseInput, type ContinuityIncidentOpenInput, type ContinuityIncidentRecord, type ContinuityIncidentState, type ContinuityLoopCadence, type ContinuityLoopReviewInput, type ContinuityLoopStatus, type ContinuityLoopUpsertInput, type ConversationThread, type CronConversationRecallMode, type CronRecallMode, type DaySummaryResult, type EngramTraceEvent, type EntityActivityEntry, type EntityFile, type EntityMention, type EntityRelationship, type ExtractedFact, type ExtractedQuestion, type ExtractedRelationship, type ExtractionPassSource, type ExtractionResult, type FileHygieneConfig, type GatewayConfig, type HourlySummary, type IdentityInjectionMode, type ImportanceLevel, type ImportanceScore, type LifecycleState, type LlmTraceCallback, type LlmTraceEvent, type MemoryActionEligibilityContext, type MemoryActionEligibilitySource, type MemoryActionEvent, type MemoryActionOutcome, type MemoryActionPolicyDecision, type MemoryActionPolicyResult, type MemoryActionStatus, type MemoryActionType, type MemoryCategory, type MemoryFile, type MemoryFrontmatter, type MemoryIntent, type MemoryLifecycleEvent, type MemoryLifecycleEventType, type MemoryLifecycleStateSummary, type MemoryLink, type MemoryLinkType, type MemoryOsPresetName, type MemoryProjectionCurrentState, type MemoryStatus, type MemorySummary, type MetaState, type ModelApi, type ModelDefinitionConfig, type ModelProviderAuthMode, type ModelProviderConfig, type NamespacePolicy, type NativeKnowledgeConfig, type NativeKnowledgeFolderRuleConfig, type NativeKnowledgeObsidianVaultConfig, type NativeKnowledgeOpenClawWorkspaceConfig, type PluginConfig, type PolicyClass, type PrincipalFromSessionKeyMode, type PrincipalRule, type QmdSearchExplain, type QmdSearchResult, type QuestionEntry, type ReasoningEffort, type RecallPipelineConfig, type RecallPlanMode, type RecallSectionConfig, type RecallTraceEvent, type RelevanceFeedback, SPECULATIVE_TTL_DAYS, type ScoredEntity, type SessionObserverBandConfig, type SignalLevel, type SignalScanResult, type TopicScore, type TranscriptEntry, type TriggerMode, type VerificationState, confidenceTier };