dsh-layered-memory 0.8.8 → 0.8.9

package/dist/config.d.ts

@@ -4,7 +4,7 @@
  * 默认数据目录：$DSH_HOME/memory（用官方 dshHomePath 解析，DSH_HOME 缺省 ~/.dsh）。
  */
 import Schema from '@deepseek-ai/schemastery';
-import type { StaticFallbackEntry } from './contract.js';
+import type { LayerRouteKey, StaticFallbackEntry } from './contract.js';
 import type { ExtractMode } from './types.js';
 /**
  * 蒸馏思考档位全词汇表（唯一事实源）：'' = 自动（模型默认档 → high），
@@ -103,6 +103,14 @@ export interface MemoryConfig {
          *  旧档位键 reasoningEffort 的整体接管——含给条目盖章——仍对存量值生效）；
          *  空数组（缺省）= 单路由行为不变。 */
         fallbacks?: StaticFallbackEntry[];
+        /** 按层静态路由链（#34）：层键 l1/l2/l3 各一条完整链（条目形状同 fallbacks；
+         *  头行必须 provider+model 双显式）。非空即完整替换该层解析（该层主路由与回退都
+         *  归层链管，全局链对该层不参与）；空/缺省 = 该层跟随全局解析。被运行时层链
+         *  （设置页 distillLayerChains）压过；pin 不废静态层链（同为部署配置，同回退链先例）。 */
+        layerRoutes?: Partial<Record<LayerRouteKey, StaticFallbackEntry[]>>;
+        /** 运行时层链（effectiveCfg 从设置页 distillLayerChains 注入，层内第一优先级）；
+         *  非静态 schema——与 primaryEffort/budgets 同类：运行时偏好，无部署上限语义。 */
+        layerChainsRuntime?: Partial<Record<LayerRouteKey, StaticFallbackEntry[]>>;
         /** 单次蒸馏调用的输出 token 上限（推理模型的 reasoning 与正文共享该预算）。 */
         maxTokens: number;
         /** 蒸馏调用的思考档位；空串不传（跟随模型默认）。 */
@@ -235,6 +243,63 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<{
             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>;
@@ -252,6 +317,63 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<{
             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>;
@@ -366,6 +488,63 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<{
             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>;
@@ -383,6 +562,63 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<{
             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>;

package/dist/config.js

@@ -76,6 +76,25 @@ export const memorySchema = Schema.object({
             model: Schema.string().default(''),
             reasoningEffort: Schema.union([...EFFORT_CHOICES]).default(''),
         })).default([]),
+        // 按层静态路由链（#34）：每层一条完整链（头行须双显式——启动侧只做形状默认，
+        // 语义校验（头行/去重/上限）在解析侧防御 + 设置页写入门；空数组 = 该层跟随全局）
+        layerRoutes: Schema.object({
+            l1: Schema.array(Schema.object({
+                provider: Schema.string().default(''),
+                model: Schema.string().default(''),
+                reasoningEffort: Schema.union([...EFFORT_CHOICES]).default(''),
+            })).default([]),
+            l2: Schema.array(Schema.object({
+                provider: Schema.string().default(''),
+                model: Schema.string().default(''),
+                reasoningEffort: Schema.union([...EFFORT_CHOICES]).default(''),
+            })).default([]),
+            l3: Schema.array(Schema.object({
+                provider: Schema.string().default(''),
+                model: Schema.string().default(''),
+                reasoningEffort: Schema.union([...EFFORT_CHOICES]).default(''),
+            })).default([]),
+        }).default({ l1: [], l2: [], l3: [] }),
         // 推理模型（如 v4-flash）的 reasoning 计入输出预算：预算不足会被思考吃光导致正文 0 字符。
         // 0.8.0 起各蒸馏层显式传分层预算（见 llm.ts LAYER_MAX_TOKENS_*），本值为未分层调用的兜底总闸
         maxTokens: Schema.number().min(1024).max(1_000_000).default(65_536),

package/dist/contract.d.ts

@@ -40,6 +40,9 @@ export interface StaticFallbackEntry {
     model: string;
     reasoningEffort?: string;
 }
+/** 按层路由的层键（#34）：l1 同管 l1-extract + l1-dedup 两个调用点（与成本看板
+ *  按层级归并口径同源）；预算键（DistillBudgetLayer）是另一套四键词表，不混用。 */
+export type LayerRouteKey = 'l1' | 'l2' | 'l3';
 /** 记忆模式运行时开关（settings-get/set 的 settings 载荷）。 */
 export interface MemoryLiveSettings {
     /** 总开关：关 = 捕获/蒸馏/召回注入全停（数据保留） */
@@ -67,6 +70,10 @@ export interface MemoryLiveSettings {
     /** 输入预算运行时覆盖（字符，≈token）：单次蒸馏调用的输入上限，L1 按此分块、
      *  超限截断；0 = 跟随静态配置 llm.maxInputChars。 */
     distillMaxInputChars: number;
+    /** 运行时按层路由链（#34）：层键 l1/l2/l3 各一条完整链（条目同 DistillChainEntry）；
+     *  非空即完整接管该层解析（压过静态 layerRoutes，层内第一优先级）；空数组 = 该层
+     *  跟随（静态层链 → 全局解析逐级兜底）。写入经 settings-set 逐层校验（头行必须显式）。 */
+    distillLayerChains: Record<LayerRouteKey, DistillChainEntry[]>;
 }
 /** 单会话召回统计（悬浮卡信息区数据源；口径见 recall.ts 注释）。 */
 export interface RecallSessionStats {
@@ -87,6 +94,12 @@ export interface RecallSessionStats {
     /** 最近一次记账时间（LRU 清理依据）。 */
     updatedAt: number;
 }
+/**
+ * 单会话记忆上下文占用（session-stats.memoryOccupancy；悬浮卡与输入栏占用指示器共用）。
+ * 形状与算术的唯一来源是 util/context-occupancy 的 OccupancyLedger——官方 token-meter
+ * 同式启发式，禁止任何一侧另写换算。null = 本会话从未注入过。
+ */
+export type MemoryOccupancy = import('./util/context-occupancy.js').OccupancyLedger;
 /** 重建阶段。 */
 export type RebuildPhase = 'idle' | 'preparing' | 'distilling' | 'finalizing' | 'done' | 'cancelled' | 'failed';
 /** 重建状态（rebuild-status/start/cancel 端点返回值）。 */
@@ -350,6 +363,16 @@ export type SessionStatsResponse = {
     recall: {
         enabled: boolean;
     } & RecallSessionStats;
+    /** 记忆上下文占用账本（未注入过的会话为 null）。 */
+    memoryOccupancy: MemoryOccupancy | null;
+    /** 旧会话回填（票08）：host 侧估出的双通道份额——召回按 live 会话 surface 现扫
+     *  （null = 会话不在 store），稳定区按当前组词折算。账本存在时客户端取两者较大值。 */
+    occupancyBackfill: {
+        recallTokens: number | null;
+        profileTokens: number;
+    } | null;
+    /** 主对话模型的官方声明上下文窗口（占用占比分母；null = 未声明/解析失败，UI 降级隐藏占比）。 */
+    contextWindowTokens: number | null;
     distill: SessionDistillView;
     l0Count: number;
     retrieval: 'hybrid' | 'vector' | 'keyword' | 'none';
@@ -397,6 +420,8 @@ export interface SettingsSetRequest {
     distill?: boolean;
     recall?: boolean;
     distillChain?: DistillChainEntry[];
+    /** 运行时按层路由链（#34）：逐层 patch（只带要改的层；空数组 = 该层回到跟随）。 */
+    distillLayerChains?: Partial<Record<LayerRouteKey, DistillChainEntry[]>>;
     reasoningEffort?: EffortChoice;
     distillProvider?: string;
     distillModel?: string;
@@ -484,6 +509,16 @@ export interface EffectiveChainRoute {
     model: string;
     effort: string;
 }
+/** 按层层链视图（#34 B 分段 UI 数据源）：runtime = 设置页运行时层链（pinned 下不生效，
+ *  视图照实返回存量）；static = 部署 YAML layerRoutes；effectiveChain = 该层实际链
+ *  （层链完整替换，或跟随全局时与全局链同值）；source 三态：runtime 接管 / static
+ *  生效 / global 跟随全局解析。 */
+export interface LayerChainView {
+    runtime: DistillChainEntry[];
+    static: StaticFallbackEntry[];
+    effectiveChain: EffectiveChainRoute[];
+    source: 'runtime' | 'static' | 'global';
+}
 export interface LlmProvidersResponse {
     supported: true;
     providers: Array<{
@@ -512,6 +547,8 @@ export interface LlmProvidersResponse {
         effectiveChain: EffectiveChainRoute[];
         source: 'runtime' | 'static';
     };
+    /** 按层层链（l1/l2/l3；l1 同管抽取+去重两个调用点）。 */
+    layerChains: Record<LayerRouteKey, LayerChainView>;
 }
 /** dsh-memory/llm-models */
 export interface LlmModelsRequest {

package/dist/hooks/recall.d.ts

@@ -23,6 +23,7 @@ import type { PersonaStore } from '../store/persona.js';
 import type { SceneStore } from '../store/scenes.js';
 import type { SessionModeStore } from '../store/session-modes.js';
 import type { MemoryLogger } from '../types.js';
+import { type OccupancyLedger } from '../util/context-occupancy.js';
 /**
  * 从会话消息构建召回查询（纯函数）：末尾 N 条 + 总长截断，空输入返回空串。
  * 全史拼接会让 MATCH 表达式随会话长度线性膨胀（整会话累计二次方成本）。
@@ -44,6 +45,16 @@ export interface RecallHooks {
     invalidateProfile(): void;
     /** 会话召回统计只读视图（未发生过检索的会话返回 undefined）。 */
     stats(sessionId: string): RecallSessionStats | undefined;
+    /** 记忆占用账本只读出口：内存优先，miss 时从流水复生（重启后历史会话）；从未注入返回 null。 */
+    occupancy(sessionId: string): OccupancyLedger | null;
+    /**
+     * 稳定区份额估算（票08 旧会话回填）：按当前画像/导航/指南组词折算 token，
+     * 纯读不记账——旧会话系统提示里"现在大约坐着多少稳定区"的最佳可得估计。
+     */
+    estimateProfileTokens(agentId: string): number;
+    /** 召回份额回填（票08）：live 会话 surface 现扫本插件注入，miss 时读盘上日志兜底；
+     *  均不可得返回 null。 */
+    estimateRecallTokens(sessionId: string): Promise<number | null>;
 }
 export declare function registerRecall(ctx: Context, cfg: MemoryConfig, stores: {
     l1: L1Store;