dsh-layered-memory 0.8.8 → 0.8.9

package/dist/hooks/recall.js

@@ -1,9 +1,12 @@
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import { RecallDedupeStore } from '../store/recall-dedupe.js';
+import { OccupancyStore } from '../store/occupancy.js';
 import { applyRecallBudget, raceRecallTimeout, RECALL_EMBED_CAP_MS } from '../util/recall-budget.js';
+import { clearProfileShare, emptyOccupancyLedger, estimateInjectedMessageTokens, estimateStableSectionTokens, recordProfileShare, recordRecallInjection, resetForCompaction, } from '../util/context-occupancy.js';
 import { errDetail } from '../util/filelog.js';
 import { blocksToText } from '../util/text.js';
 const PROFILE_TTL = 60_000;
+const storedEstimateCache = new Map();
 /** 召回查询只取会话末尾 N 条消息（长会话每步把全史拼进 FTS MATCH 会让检索成本线性上涨）。 */
 const RECALL_QUERY_TAIL_MESSAGES = 8;
 /** 召回查询总字符上限（保留末尾——最新语境权重最高）。 */
@@ -52,6 +55,8 @@ export function emptyRecallStats(now = Date.now()) {
 export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
     /** 召回去重存储（同会话已注入的记忆不再重复注入；写穿持久化，重启不丢）。 */
     const dedupe = new RecallDedupeStore(dataDir, logger);
+    /** 记忆占用流水（账本迁移写穿；重启后历史会话账目由此复生——票07）。 */
+    const occupancyStore = new OccupancyStore(dataDir, logger);
     /** 每 agent 召回统计（工具指南门控读 lastHits；悬浮卡信息区读全量计数）。 */
     const recallStats = new Map();
     const statFor = (id) => {
@@ -62,6 +67,17 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
         }
         return s;
     };
+    /** 每 agent 记忆占用账本（权威账本的唯一宿主实例；占用指示器与悬浮卡同源消费）。 */
+    const occupancyByAgent = new Map();
+    const ledgerFor = (id) => {
+        let led = occupancyByAgent.get(id);
+        if (!led) {
+            // 进程重启/agent 重建后回看：从流水复生（新迁移在持久值上继续累加——票07）
+            led = occupancyStore.load(id) ?? emptyOccupancyLedger();
+            occupancyByAgent.set(id, led);
+        }
+        return led;
+    };
     // 画像/场景导航按族缓存（分族隔离：注入时按会话档位选族）
     const profileCache = {
         chat: { persona: '', nav: '' },
@@ -92,13 +108,18 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
     // agent 销毁时清掉召回统计槽（去重记录不随 agent 清——持久化语义：会话恢复后继续压制）
     ctx.on('agent/disposed', (payload) => {
         recallStats.delete(payload.agent.id);
+        occupancyByAgent.delete(payload.agent.id);
     });
     // 上下文压缩/清空 → 已注入内容从模型上下文丢失，重置该会话的去重压制
     // （resume/startup 不重置：历史仍在，已注入的记忆模型还持有）。
+    // 占用账本同步全量归零（宁低勿高；v1 轮级粒度近似，事件级 shadow price 对齐留待后续）。
     ctx.on('agent/session-start', (payload) => {
         if (payload.source === 'compact' || payload.source === 'clear') {
             dedupe.reset(payload.agent.id);
-            logger.info(`[memory] 召回去重重置（agent=${payload.agent.id}，source=${payload.source}）`);
+            const led = ledgerFor(payload.agent.id);
+            resetForCompaction(led);
+            occupancyStore.save(payload.agent.id, led); // stock 归零 ⇒ 流水条目删除
+            logger.info(`[memory] 召回去重与占用账本重置（agent=${payload.agent.id}，source=${payload.source}）`);
         }
     });
     // ── 1. pre-step 消息侧注入：记忆先行于每一条新的用户输入（ADR-0001） ──
@@ -180,6 +201,10 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                     // "上下文注入"（专用"跨会话召回"标题仅留给 session-reference 来源）
                     source: { kind: 'plugin', plugin: 'memory', form: 'recall' },
                 });
+                // 入账在成功构造注入消息之后、返回 enter 之前——任何前置抛错路径账目零扰动
+                const led = ledgerFor(payload.agent.id);
+                recordRecallInjection(led, text.length);
+                occupancyStore.save(payload.agent.id, led);
                 // 注入消息排在用户新消息之前（原版 prepend 语义：先线索后问题）
                 return { kind: 'enter', messages: [injection, ...decision.messages] };
             }
@@ -192,6 +217,101 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
     // ── 2. agent 作用域上下文 provider（系统提示稳定区：画像 + 导航 + 门控指南） ──
     // 插件可能在默认 agent 创建之后才加载（组合顺序由依赖决定），
     // 因此除了监听 agent/created，还要给已存在的 agent 补注册。
+    /**
+     * 稳定区当前组词（纯读，不记账）：text() 的取词部分单独成函数，
+     * 供旧会话回填估算（RecallHooks.estimateProfileTokens）复用同一口径。
+     */ const composeStableText = (agentId) => {
+        const s = live.get();
+        if (!s.enabled || !s.recall)
+            return '';
+        const mode = modes.get(agentId);
+        if (mode === 'off')
+            return '';
+        // auto 档：两族按类别归组（画像/导航各一个标签，域内 <domain> 分块）；纯档：单族原格式
+        const body = mode === 'auto'
+            ? formatProfileAuto(profileCache.chat, profileCache.work)
+            : formatProfileSingle(profileCache[mode]);
+        const hasRecallHit = (recallStats.get(agentId)?.lastHits ?? 0) > 0;
+        // 指南三条件门控：工具已注册（cfg.tools）&&（稳定内容 ∥ 本轮召回命中）——
+        // 空库用户与关闭工具的用户不付这份固定 token（原版 auto-recall 同款语义）
+        if (!cfg.tools)
+            return body;
+        if (!body && !hasRecallHit)
+            return '';
+        return body ? `${body}\n\n${MEMORY_TOOLS_GUIDE}` : MEMORY_TOOLS_GUIDE;
+    };
+    async function estimateRecallFromStorage(sessionId) {
+        if (storedEstimateCache.has(sessionId))
+            return storedEstimateCache.get(sessionId) ?? null;
+        let tokens = null;
+        try {
+            // 可选服务（JSONL 后端注册名）；缺失/其它实现 → 回填隐藏
+            const persistence = (await ctx.get?.('sessionPersistence'));
+            const stored = typeof persistence?.loadStored === 'function' ? await persistence.loadStored(sessionId) : undefined;
+            if (stored?.events) {
+                tokens = 0;
+                for (const ev of stored.events) {
+                    if (typeof ev.type === 'string' && ev.type.startsWith('compaction'))
+                        tokens = 0;
+                    if (ev.type !== 'user/message')
+                        continue;
+                    const src = ev.data?.source;
+                    if (!src || src.kind !== 'plugin' || src.plugin !== 'memory' || src.form !== 'recall')
+                        continue;
+                    let chars = 0;
+                    for (const b of ev.data?.content ?? []) {
+                        if (b?.type === 'text' && typeof b.text === 'string')
+                            chars += b.text.length;
+                    }
+                    if (chars > 0)
+                        tokens += estimateInjectedMessageTokens(chars);
+                }
+            }
+        }
+        catch {
+            tokens = null;
+        }
+        storedEstimateCache.set(sessionId, tokens);
+        return tokens;
+    }
+    /**
+     * 召回份额回填（票08 旧会话）：live 会话的 surface（模型可见序号集）∩ 全事件日志
+     * 里本插件的 recall 注入，官方同式折算。窗口语义天然正确——被压缩折叠的注入不在
+     * surface.nodes 上，自动出局。会话不在 live store（未打开）返回 null。
+     */
+    const estimateRecallTokens = async (sessionId) => {
+        try {
+            // cordis 属性访问（ctx.sessions）对未 inject 的服务抛 "without inject"（实测）；
+            // 可选服务一律走 ctx.get() 的宽容路径
+            const sessions = ctx.get?.('sessions');
+            const session = typeof sessions?.get === 'function' ? sessions.get(sessionId) : undefined;
+            if (session) {
+                const visible = new Set(session.surface.nodes);
+                let total = 0;
+                for (const ev of session.events) {
+                    if (ev.type !== 'user/message' || !visible.has(ev.seq))
+                        continue;
+                    const msg = ev.data;
+                    const src = msg?.source;
+                    if (!src || src.kind !== 'plugin' || src.plugin !== 'memory' || src.form !== 'recall')
+                        continue;
+                    let chars = 0;
+                    for (const b of msg.content ?? []) {
+                        if (b?.type === 'text' && typeof b.text === 'string')
+                            chars += b.text.length;
+                    }
+                    if (chars > 0)
+                        total += estimateInjectedMessageTokens(chars);
+                }
+                return total;
+            }
+            // 仅查看的旧会话不在 live store：官方持久化服务读存储前缀兜底（见函数头）
+            return estimateRecallFromStorage(sessionId);
+        }
+        catch {
+            return null; // 服务缺失/形状异常：回填隐藏，不扰动主流程
+        }
+    };
     const registered = new WeakSet();
     // context() 的 disposer 必须挂到插件自身生命周期：agent.ctx 比插件实例活得久，
     // 不主动清理会导致热重载后旧注册泄漏、新实例撞名（"already registered"）
@@ -205,24 +325,15 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                 name: 'memory:profile',
                 order: 510,
                 text: () => {
-                    const s = live.get();
-                    if (!s.enabled || !s.recall)
-                        return '';
-                    const mode = modes.get(agent.id);
-                    if (mode === 'off')
-                        return '';
-                    // auto 档：两族按类别归组（画像/导航各一个标签，域内 <domain> 分块）；纯档：单族原格式
-                    const body = mode === 'auto'
-                        ? formatProfileAuto(profileCache.chat, profileCache.work)
-                        : formatProfileSingle(profileCache[mode]);
-                    const hasRecallHit = (recallStats.get(agent.id)?.lastHits ?? 0) > 0;
-                    // 指南三条件门控：工具已注册（cfg.tools）&&（稳定内容 ∥ 本轮召回命中）——
-                    // 空库用户与关闭工具的用户不付这份固定 token（原版 auto-recall 同款语义）
-                    if (!cfg.tools)
-                        return body;
-                    if (!body && !hasRecallHit)
-                        return '';
-                    return body ? `${body}\n\n${MEMORY_TOOLS_GUIDE}` : MEMORY_TOOLS_GUIDE;
+                    const final = composeStableText(agent.id);
+                    const ledger = ledgerFor(agent.id);
+                    // 空串即物理离场（停用/OFF/门控全空）：份额同边界清零；否则按实际长度入账
+                    if (final === '')
+                        clearProfileShare(ledger);
+                    else
+                        recordProfileShare(ledger, final.length);
+                    occupancyStore.save(agent.id, ledger);
+                    return final;
                 },
             }));
         }
@@ -248,7 +359,19 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
             }
         }
     });
-    return { invalidateProfile, stats: (id) => recallStats.get(id) };
+    return {
+        invalidateProfile,
+        stats: (id) => recallStats.get(id),
+        /** 占用账本只读出口：内存优先，miss 时从流水复生（重启后历史会话）；从未注入返回 null。 */
+        occupancy: (id) => {
+            const led = occupancyByAgent.get(id) ?? occupancyStore.load(id);
+            if (led)
+                occupancyByAgent.set(id, led);
+            return led ?? null;
+        },
+        estimateProfileTokens: (id) => estimateStableSectionTokens(composeStableText(id).length),
+        estimateRecallTokens,
+    };
 }
 /** auto 档 <user-persona> 内的域说明：让模型理解分块结构与两域的独立性。 */
 const DOMAIN_HINT = '以下内容按记忆域分块：chat=用户个人画像（User Narrative Profile），work=团队工作准则（Team Operating Doctrine）。' +

package/dist/index.d.ts

@@ -109,6 +109,63 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
             model: import("@deepseek-ai/schemastery").default<string, string>;
             reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         }>[]>;
+        layerRoutes: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
         maxTokens: import("@deepseek-ai/schemastery").default<number, number>;
         reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         temperature: import("@deepseek-ai/schemastery").default<number, number>;
@@ -126,6 +183,63 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
             model: import("@deepseek-ai/schemastery").default<string, string>;
             reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         }>[]>;
+        layerRoutes: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
         maxTokens: import("@deepseek-ai/schemastery").default<number, number>;
         reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         temperature: import("@deepseek-ai/schemastery").default<number, number>;
@@ -240,6 +354,63 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
             model: import("@deepseek-ai/schemastery").default<string, string>;
             reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         }>[]>;
+        layerRoutes: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
         maxTokens: import("@deepseek-ai/schemastery").default<number, number>;
         reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         temperature: import("@deepseek-ai/schemastery").default<number, number>;
@@ -257,6 +428,63 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
             model: import("@deepseek-ai/schemastery").default<string, string>;
             reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         }>[]>;
+        layerRoutes: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>, Schemastery.ObjectT<{
+            l1: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l2: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+            l3: import("@deepseek-ai/schemastery").default<({
+                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: import("@deepseek-ai/schemastery").default<string, string>;
+                model: import("@deepseek-ai/schemastery").default<string, string>;
+                reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
+            }>[]>;
+        }>>;
         maxTokens: import("@deepseek-ai/schemastery").default<number, number>;
         reasoningEffort: import("@deepseek-ai/schemastery").default<"" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "" | "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">;
         temperature: import("@deepseek-ai/schemastery").default<number, number>;

package/dist/index.js

@@ -307,6 +307,9 @@ export async function apply(ctx, config) {
     // 悬浮卡信息区数据源（session-stats 热路径端点；全部内存读 + 索引 COUNT，零文件 I/O）
     {
         recallStats: (sid) => recall.stats(sid),
+        memoryOccupancy: (sid) => recall.occupancy(sid),
+        profileEstimate: (sid) => recall.estimateProfileTokens(sid),
+        recallEstimate: (sid) => recall.estimateRecallTokens(sid),
         runnerView: (sid, mode) => runner.sessionView(sid, mode),
         l0Count: (sid) => stores.l0.countBySession(sid),
         capabilities: () => db.getCapabilities(),

package/dist/llm.d.ts

@@ -25,21 +25,27 @@ export declare const LAYER_MAX_TOKENS_L2 = 32000;
 /** L3 画像（完整 persona 文档）。 */
 export declare const LAYER_MAX_TOKENS_L3 = 16000;
 /** 分层输出预算键（已迁入契约 src/contract.ts；import type 供本地使用，re-export 不断裂既有引用）。 */
-import type { DistillBudgetLayer } from './contract.js';
+import type { DistillBudgetLayer, LayerRouteKey, StaticFallbackEntry } from './contract.js';
 export type { DistillBudgetLayer } from './contract.js';
 /** 各层内置默认预算（设置页"0 = 跟随默认"的默认值来源）。 */
 export declare const LAYER_DEFAULT_BUDGETS: Record<DistillBudgetLayer, number>;
-/**
- * 解析某蒸馏层的生效输出预算：运行时覆盖（cfg.llm.budgets，由 effectiveCfg 从
- * 设置页 distillBudgets 注入，0/缺省 = 跟随）→ 内置默认 → 思考档放大
- * （high/xhigh/max ×4，reasoning 计入输出预算的历史事故防线）。
- */
-export declare function resolveLayerTokens(cfg: {
+/** resolveLayerTokens/layerEffortTrigger 需要的最小 cfg 视图（smoke 决策表用窄对象即可构造）。 */
+export interface LayerRouteCfgView {
     llm: {
         reasoningEffort: string;
+        primaryEffort?: string;
+        layerRoutes?: Partial<Record<LayerRouteKey, StaticFallbackEntry[]>>;
+        layerChainsRuntime?: Partial<Record<LayerRouteKey, StaticFallbackEntry[]>>;
         budgets?: Partial<Record<DistillBudgetLayer, number>>;
     };
-}, layer: DistillBudgetLayer): number;
+}
+/**
+ * 解析某蒸馏层的生效输出预算：运行时覆盖（cfg.llm.budgets，由 effectiveCfg 从
+ * 设置页 distillBudgets 注入，0/缺省 = 跟随）→ 内置默认 → 思考档放大
+ * （high/xhigh/max ×4，reasoning 计入输出预算的历史事故防线）。放大触发档位
+ * 跟层走（#34 D8）：层链头档位候选 > 全局主路由档位候选（primaryEffort > 静态全局）。
+ */
+export declare function resolveLayerTokens(cfg: LayerRouteCfgView, layer: DistillBudgetLayer): number;
 /**
  * 高思考档集合（输出预算 ×4 的档位）：阶段侧 layerMaxTokens 与 callLLM 的
  * 自动档防线共用同一张表——此前两处字面量表分叉（防线漏 xhigh），显式 xhigh
@@ -79,6 +85,20 @@ export declare function buildRouteChain(primary: {
     model: string;
     effort?: string;
 }, fallbacks: FallbackRouteEntry[] | undefined, globalEffort: string): DistillRoute[];
+/** DistillLayer（调用点四键）→ 路由层键（三键）：l1-extract/l1-dedup 同属 l1。 */
+export declare function layerKeyFor(layer: DistillLayer): LayerRouteKey;
+/** 该层的预算放大触发档位（D8）：层链头档位候选 > 全局主路由档位候选（primaryEffort > 静态全局）。 */
+export declare function layerEffortTrigger(cfg: LayerRouteCfgView, key: LayerRouteKey): string;
+/**
+ * 解析某次蒸馏调用的实际路由链（callLLM 入口）：有层标签且该层配了层链 → 层链
+ * 完整替换（buildRouteChain 复用：头行在前、条目去重、档位三级候选）；否则现行
+ * 全局解析（主路由既有优先级 + fallbacks，语义一个比特不动）。layer 缺省
+ * （bench/测试缝）= 全局解析。
+ */
+export declare function resolveLayerRoutes(ctx: Context, cfg: MemoryConfig, layer?: DistillLayer): Promise<DistillRoute[]>;
+/** 层链解析的同步半边（llm-providers 视图与 resolveLayerRoutes 共用一条真值路径）：
+ *  该层配了有效层链 → 完整链；null = 该层跟随全局解析。 */
+export declare function layerChainOrNull(cfg: LayerRouteCfgView, key: LayerRouteKey): DistillRoute[] | null;
 export interface ModelEffortInfo {
     /** 模型可设置的思考档位 id（适配器声明；空 = 未声明/不可设置） */
     efforts: string[];
@@ -89,6 +109,12 @@ export interface ModelEffortInfo {
 export declare function invalidateEffortCache(): void;
 /** 探询某模型的思考档位能力；失败返回 null（调用方保持旧发送行为，不改判）。 */
 export declare function resolveModelEfforts(ctx: Context, provider: string, model: string): Promise<ModelEffortInfo | null>;
+/**
+ * 探询某模型的上下文窗口容量（adapter 声明的 provider-owned capacity）。
+ * 与 effortCache 同源同失效策略（invalidateEffortCache 一并清空）；
+ * 仅用于占用指示器的分母展示——分母必须与官方环同源（模型声明值），禁止 client 自估。
+ */
+export declare function resolveModelContextWindow(ctx: Context, provider: string, model: string): Promise<number | null>;
 export type EffortDecisionReason = 'supported' | 'auto-default' | 'auto-high' | 'alias-none' | 'unsupported' | 'no-efforts' | 'no-capability';
 export interface EffortDecision {
     /** 实际发送的档位；'' = 不发送（跟随模型默认） */