dsh-prime-memory 0.11.0

package/dist/config.d.ts

@@ -0,0 +1,683 @@
+/**
+ * 插件配置:Schemastery schema + 类型。
+ *
+ * 默认数据目录:$DSH_HOME/memory(用官方 dshHomePath 解析,DSH_HOME 缺省 ~/.dsh)。
+ * 键名/默认值/取值范围是部署面契约(patch.yml 按"整行替换,不深合并"覆盖),不可更名。
+ */
+import Schema from '@deepseek-ai/schemastery';
+import type { LayerRouteKey, StaticFallbackEntry } from './contract.js';
+import type { ExtractMode } from './types.js';
+/**
+ * 蒸馏思考档位全词汇表(唯一事实源):'' = 自动(模型默认档 → high),
+ * 其余为各适配器通用档位词汇(deepseek 认 'off',OpenAI 系是 'none')。
+ * schema(config/settings)、运行时解析与 RPC 写入门共用,勿在别处再抄字面量表。
+ */
+export declare const EFFORT_CHOICES: readonly ["", "off", "none", "minimal", "low", "medium", "high", "xhigh", "max"];
+export interface MemoryConfig {
+    /** 数据目录;留空则用 $DSH_HOME/memory。 */
+    dataDir: string;
+    /** 新会话的默认记忆档位:auto(双族自动)| chat(个人)| work(工作)。 */
+    family: ExtractMode;
+    capture: {
+        enabled: boolean;
+        /** 助手消息是否剥离代码块(减少嵌入噪声)。 */
+        stripCodeBlocks: boolean;
+        /** 单条消息内容最大字符数。 */
+        maxMessageChars: number;
+    };
+    extract: {
+        enabled: boolean;
+        /** 稳态触发阈值:单会话攒够多少条新消息才跑一次 L1 抽取(省 token)。
+         *  起步阶段生效阈值从 1 翻倍爬坡到此值(渐进阈值,ADR-0003)。 */
+        minMessages: number;
+        /** 闲置兜底:会话静默多少秒后把未蒸馏切片落袋;0 = 关闭。 */
+        idleSeconds: number;
+        /** L1 抽取时的背景消息条数(供上下文推断,不参与提取)。 */
+        backgroundMessages: number;
+        /** 去重候选池大小(每条新记忆的相似候选数)。 */
+        candidatePool: number;
+    };
+    l2: {
+        enabled: boolean;
+        /** 距上次 L2 整合的新记忆达到该数量才触发。 */
+        minNewMemories: number;
+        /** 场景块数量上限。 */
+        maxScenes: number;
+        /** L2 prompt 里附带的相似场景全文数量上限。 */
+        sceneContextLimit: number;
+    };
+    l3: {
+        enabled: boolean;
+        /** 距上次 L3 蒸馏的新记忆数量阈值。 */
+        interval: number;
+    };
+    graph: {
+        /** 知识图谱投影总开关(部署级,默认关):开启后还需运行时蒸馏开关(live.distill)
+         *  同时为真才执行;图谱是 L1 的可重建投影,关闭不影响记忆主链路。 */
+        enabled: boolean;
+    };
+    recall: {
+        enabled: boolean;
+        /** 每步自动召回注入的 L1 条数。 */
+        maxResults: number;
+        /** 单条注入记忆的字符上限(超限截断并提示用工具查全文);0 = 不限。 */
+        maxCharsPerMemory: number;
+        /** 整轮注入总字符上限(超限按相关性丢尾部);0 = 不限。 */
+        maxTotalRecallChars: number;
+        /** 召回总预算(ms):超时跳过本轮注入、不阻塞对话;0 = 不限时。 */
+        timeoutMs: number;
+        includePersona: boolean;
+        includeSceneNav: boolean;
+        /** 检索策略:keyword(FTS5 BM25)| embedding(向量)| hybrid(双路 + RRF 融合)。 */
+        strategy: 'keyword' | 'embedding' | 'hybrid';
+        /** 召回路径分数阈值(0~1,低于该分不注入;工具路径不过滤)。 */
+        scoreThreshold: number;
+        /** 时效衰减半衰期(天,0=关):score × max(0.5, 0.5^(Δ天/半衰期)),
+         *  只影响相关度相近候选间的名次(老记忆最多损失一半排序分,不淘汰)。 */
+        decayHalfLifeDays: number;
+    };
+    embedding: {
+        /** 向量检索总开关;关闭时纯 FTS 运行。 */
+        enabled: boolean;
+        /** OpenAI 兼容 /embeddings 服务地址,如 https://api.siliconflow.cn/v1。 */
+        baseUrl: string;
+        apiKey: string;
+        model: string;
+        /** 向量维度(启用时必填,须与模型输出一致;vec0 建表需要固定维度)。 */
+        dimensions: number;
+        /** 单条文本最大字符数(超长截断)。 */
+        maxInputChars: number;
+        /** 单次调用超时(ms)。 */
+        timeoutMs: number;
+        /** 允许本地嵌入模型档(部署上限:公司环境可禁下载与本地推理)。 */
+        allowLocalModels: boolean;
+        /** 模型下载镜像根地址(默认国内可达的 hf-mirror.com)。 */
+        mirror: string;
+        /** 模型下载代理三态:''(默认)= 探测代理环境变量;'none' = 强制直连;其他 = 代理 URL。 */
+        proxy: string;
+    };
+    llm: {
+        /** 蒸馏用的 provider 路由;留空用当前默认选择。 */
+        provider: string;
+        /** 蒸馏用的模型;留空用当前默认选择。 */
+        model: string;
+        /** 压缩(蒸馏)调用通道:'host' = 复用宿主 ctx.llm(默认,零配置);'direct' =
+         *  插件原生 HTTP 直连 llm.baseURL 指定的 OpenAI 兼容端点。direct 失败自动回退宿主
+         *  路由作兜底;direct 未配置时静默回退 host。 */
+        mode: 'host' | 'direct';
+        /** direct 模式下的 OpenAI 兼容 /v1 端点根地址;host 模式忽略。 */
+        baseURL: string;
+        /** direct 模式下可选 API Key(本地免 key);host 模式忽略。 */
+        apiKey: string;
+        /** 回退链:主路由失败(报错/掐断/网络异常/空输出)后按序降级的备用路由,
+         *  条目顺序即优先级。与主路由完全相同的条目自动跳过;provider/model 缺失的条目剔除;
+         *  条目 reasoningEffort 非空时覆盖全局档位;空数组(缺省)= 单路由行为不变。 */
+        fallbacks?: StaticFallbackEntry[];
+        /** 按层静态路由链:层键 l1/l2/l3 各一条完整链(头行必须 provider+model 双显式)。
+         *  非空即完整替换该层解析;空/缺省 = 该层跟随全局解析。被运行时层链压过;
+         *  pin 不废静态层链。 */
+        layerRoutes?: Partial<Record<LayerRouteKey, StaticFallbackEntry[]>>;
+        /** 运行时层链(effectiveCfg 从设置页 distillLayerChains 注入,层内第一优先级);
+         *  非静态 schema——运行时偏好,无部署上限语义。 */
+        layerChainsRuntime?: Partial<Record<LayerRouteKey, StaticFallbackEntry[]>>;
+        /** 单次蒸馏调用的输出 token 上限(推理模型的 reasoning 与正文共享该预算)。 */
+        maxTokens: number;
+        /** 蒸馏调用的思考档位;空串不传(跟随模型默认)。 */
+        reasoningEffort: string;
+        /** 运行时主路由显式档位(distillChain[0].reasoningEffort 经 effectiveCfg 注入);
+         *  '' = 跟随全局静态 reasoningEffort。 */
+        primaryEffort?: string;
+        temperature: number;
+        /** 单次蒸馏调用的用户 prompt 字符预算(≈token 数,按中文 1 字≈1 token 保守估算)。 */
+        maxInputChars: number;
+        /** 单次蒸馏调用超时(ms)。 */
+        timeoutMs: number;
+        /** 分层输出预算运行时覆盖(设置页 distillBudgets 经 effectiveCfg 注入;
+         *  0/缺省 = 用内置默认。非静态 schema——预算无部署上限语义)。 */
+        budgets?: Partial<{
+            extract: number;
+            dedup: number;
+            l2: number;
+            l3: number;
+            graph: number;
+        }>;
+    };
+    /** Hall(粗分类属性通道):参与 L1 自动打标与记忆库过滤的 Hall id 列表。
+     *  空数组 = 关闭 Hall 功能(不自动打标)。 */
+    hall: {
+        enabled: string[];
+    };
+    tokenCost: {
+        /** token_cost 明细保留天数;写入时滚动清理更早行。0 = 永久保留。 */
+        retentionDays: number;
+    };
+    /** 是否注册模型可调用的记忆工具。 */
+    tools: boolean;
+    /** 注册 bench 控制服务(dsh-memory-bench,进程内 rebuild 触发面)。
+     *  仅供基准/调试部署,默认关——生产零表面积。 */
+    benchControl: boolean;
+}
+export declare const memorySchema: Schema<Schemastery.ObjectS<{
+    dataDir: Schema<string, string>;
+    family: Schema<"chat" | "work" | "auto", "chat" | "work" | "auto">;
+    capture: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        stripCodeBlocks: Schema<boolean, boolean>;
+        maxMessageChars: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        stripCodeBlocks: Schema<boolean, boolean>;
+        maxMessageChars: Schema<number, number>;
+    }>>;
+    extract: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        minMessages: Schema<number, number>;
+        idleSeconds: Schema<number, number>;
+        backgroundMessages: Schema<number, number>;
+        candidatePool: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        minMessages: Schema<number, number>;
+        idleSeconds: Schema<number, number>;
+        backgroundMessages: Schema<number, number>;
+        candidatePool: Schema<number, number>;
+    }>>;
+    l2: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        minNewMemories: Schema<number, number>;
+        maxScenes: Schema<number, number>;
+        sceneContextLimit: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        minNewMemories: Schema<number, number>;
+        maxScenes: Schema<number, number>;
+        sceneContextLimit: Schema<number, number>;
+    }>>;
+    l3: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        interval: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        interval: Schema<number, number>;
+    }>>;
+    graph: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+    }>>;
+    recall: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        maxResults: Schema<number, number>;
+        maxCharsPerMemory: Schema<number, number>;
+        maxTotalRecallChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        includePersona: Schema<boolean, boolean>;
+        includeSceneNav: Schema<boolean, boolean>;
+        strategy: Schema<"hybrid" | "keyword" | "embedding", "hybrid" | "keyword" | "embedding">;
+        scoreThreshold: Schema<number, number>;
+        decayHalfLifeDays: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        maxResults: Schema<number, number>;
+        maxCharsPerMemory: Schema<number, number>;
+        maxTotalRecallChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        includePersona: Schema<boolean, boolean>;
+        includeSceneNav: Schema<boolean, boolean>;
+        strategy: Schema<"hybrid" | "keyword" | "embedding", "hybrid" | "keyword" | "embedding">;
+        scoreThreshold: Schema<number, number>;
+        decayHalfLifeDays: Schema<number, number>;
+    }>>;
+    embedding: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        baseUrl: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        model: Schema<string, string>;
+        dimensions: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        allowLocalModels: Schema<boolean, boolean>;
+        mirror: Schema<string, string>;
+        proxy: Schema<string, string>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        baseUrl: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        model: Schema<string, string>;
+        dimensions: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        allowLocalModels: Schema<boolean, boolean>;
+        mirror: Schema<string, string>;
+        proxy: Schema<string, string>;
+    }>>;
+    llm: Schema<Schemastery.ObjectS<{
+        provider: Schema<string, string>;
+        model: Schema<string, string>;
+        mode: Schema<"host" | "direct", "host" | "direct">;
+        baseURL: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        fallbacks: Schema<({
+            provider?: string | null | undefined;
+            model?: string | null | undefined;
+            reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+            provider: Schema<string, string>;
+            model: Schema<string, string>;
+            reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        }>[]>;
+        layerRoutes: Schema<Schemastery.ObjectS<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
+        maxTokens: Schema<number, number>;
+        reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        temperature: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        provider: Schema<string, string>;
+        model: Schema<string, string>;
+        mode: Schema<"host" | "direct", "host" | "direct">;
+        baseURL: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        fallbacks: Schema<({
+            provider?: string | null | undefined;
+            model?: string | null | undefined;
+            reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+            provider: Schema<string, string>;
+            model: Schema<string, string>;
+            reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        }>[]>;
+        layerRoutes: Schema<Schemastery.ObjectS<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
+        maxTokens: Schema<number, number>;
+        reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        temperature: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+    }>>;
+    hall: Schema<Schemastery.ObjectS<{
+        enabled: Schema<string[], string[]>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<string[], string[]>;
+    }>>;
+    tokenCost: Schema<Schemastery.ObjectS<{
+        retentionDays: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        retentionDays: Schema<number, number>;
+    }>>;
+    tools: Schema<boolean, boolean>;
+    benchControl: Schema<boolean, boolean>;
+}>, Schemastery.ObjectT<{
+    dataDir: Schema<string, string>;
+    family: Schema<"chat" | "work" | "auto", "chat" | "work" | "auto">;
+    capture: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        stripCodeBlocks: Schema<boolean, boolean>;
+        maxMessageChars: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        stripCodeBlocks: Schema<boolean, boolean>;
+        maxMessageChars: Schema<number, number>;
+    }>>;
+    extract: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        minMessages: Schema<number, number>;
+        idleSeconds: Schema<number, number>;
+        backgroundMessages: Schema<number, number>;
+        candidatePool: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        minMessages: Schema<number, number>;
+        idleSeconds: Schema<number, number>;
+        backgroundMessages: Schema<number, number>;
+        candidatePool: Schema<number, number>;
+    }>>;
+    l2: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        minNewMemories: Schema<number, number>;
+        maxScenes: Schema<number, number>;
+        sceneContextLimit: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        minNewMemories: Schema<number, number>;
+        maxScenes: Schema<number, number>;
+        sceneContextLimit: Schema<number, number>;
+    }>>;
+    l3: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        interval: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        interval: Schema<number, number>;
+    }>>;
+    graph: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+    }>>;
+    recall: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        maxResults: Schema<number, number>;
+        maxCharsPerMemory: Schema<number, number>;
+        maxTotalRecallChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        includePersona: Schema<boolean, boolean>;
+        includeSceneNav: Schema<boolean, boolean>;
+        strategy: Schema<"hybrid" | "keyword" | "embedding", "hybrid" | "keyword" | "embedding">;
+        scoreThreshold: Schema<number, number>;
+        decayHalfLifeDays: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        maxResults: Schema<number, number>;
+        maxCharsPerMemory: Schema<number, number>;
+        maxTotalRecallChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        includePersona: Schema<boolean, boolean>;
+        includeSceneNav: Schema<boolean, boolean>;
+        strategy: Schema<"hybrid" | "keyword" | "embedding", "hybrid" | "keyword" | "embedding">;
+        scoreThreshold: Schema<number, number>;
+        decayHalfLifeDays: Schema<number, number>;
+    }>>;
+    embedding: Schema<Schemastery.ObjectS<{
+        enabled: Schema<boolean, boolean>;
+        baseUrl: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        model: Schema<string, string>;
+        dimensions: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        allowLocalModels: Schema<boolean, boolean>;
+        mirror: Schema<string, string>;
+        proxy: Schema<string, string>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<boolean, boolean>;
+        baseUrl: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        model: Schema<string, string>;
+        dimensions: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+        allowLocalModels: Schema<boolean, boolean>;
+        mirror: Schema<string, string>;
+        proxy: Schema<string, string>;
+    }>>;
+    llm: Schema<Schemastery.ObjectS<{
+        provider: Schema<string, string>;
+        model: Schema<string, string>;
+        mode: Schema<"host" | "direct", "host" | "direct">;
+        baseURL: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        fallbacks: Schema<({
+            provider?: string | null | undefined;
+            model?: string | null | undefined;
+            reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+            provider: Schema<string, string>;
+            model: Schema<string, string>;
+            reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        }>[]>;
+        layerRoutes: Schema<Schemastery.ObjectS<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
+        maxTokens: Schema<number, number>;
+        reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        temperature: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        provider: Schema<string, string>;
+        model: Schema<string, string>;
+        mode: Schema<"host" | "direct", "host" | "direct">;
+        baseURL: Schema<string, string>;
+        apiKey: Schema<string, string>;
+        fallbacks: Schema<({
+            provider?: string | null | undefined;
+            model?: string | null | undefined;
+            reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+            provider: Schema<string, string>;
+            model: Schema<string, string>;
+            reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        }>[]>;
+        layerRoutes: Schema<Schemastery.ObjectS<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: Schema<({
+                provider?: string | null | undefined;
+                model?: string | null | undefined;
+                reasoningEffort?: "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null | undefined;
+            } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+                provider: Schema<string, string>;
+                model: Schema<string, string>;
+                reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
+        maxTokens: Schema<number, number>;
+        reasoningEffort: Schema<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+        temperature: Schema<number, number>;
+        maxInputChars: Schema<number, number>;
+        timeoutMs: Schema<number, number>;
+    }>>;
+    hall: Schema<Schemastery.ObjectS<{
+        enabled: Schema<string[], string[]>;
+    }>, Schemastery.ObjectT<{
+        enabled: Schema<string[], string[]>;
+    }>>;
+    tokenCost: Schema<Schemastery.ObjectS<{
+        retentionDays: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        retentionDays: Schema<number, number>;
+    }>>;
+    tools: Schema<boolean, boolean>;
+    benchControl: Schema<boolean, boolean>;
+}>>;
+export declare function resolveDataDir(cfg: MemoryConfig): string;