billion-context-dsh 0.2.15 → 0.2.17

package/README.en.md

@@ -3,7 +3,7 @@
 [English](./README.en.md) | [中文](./README.md)
 
 > **⚠️ Beta notice — not for production use**
-> This project (**v0.2.15**) is a work-in-progress beta. The [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) itself is also in **public beta**. **Do not use either in engineering / production environments** — expect breaking changes and rough edges.
+> This project (**v0.2.17**) is a work-in-progress beta. The [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) itself is also in **public beta**. **Do not use either in engineering / production environments** — expect breaking changes and rough edges.
 
 <p align="center">
 <strong>Built with gratitude on top of these projects</strong> — please give them a ⭐:
@@ -86,6 +86,14 @@ npm install billion-context-dsh
 
 This only installs the package into your project/global store; it does **not** touch any profile — add a composition row as shown below or the engine never mounts.
 
+**Install from the git source (`github:` spec — the form the plugin store shows).** The prebuilt `dist/` artifacts are committed to this repository, so a git-source install also works out of the box — **no build step needed**, and pnpm 11's default build-script blocking (`allowBuilds`) never applies to this package:
+
+```bash
+dsh plugin --profile web add github:Tyan66666/billion-context-dsh#v0.2.17
+```
+
+Prefer a `#<tag>` ref to get artifacts identical to that npm release; without a ref you get the latest default-branch build. Only building the repo yourself (`npm run build`) requires approving build scripts. Background and trade-offs: [docs/git-source-install-design.md](docs/git-source-install-design.md) (issue #92).
+
 ## Scope & customization
 
 Two audiences: ① Path B (plain npm install) users, who must write a composition row; ② Path A users who want custom `config` (the bundle already ships sane defaults — override them with a SAME-ID row).
@@ -199,8 +207,8 @@ This project reuses `acp-kernel`'s compression core and `billion-context-pi`'s d
 
 | Key | Default | Meaning |
 |---|---|---|
-| `modelContextLimit` | auto-detected (fallback `128000`) | Context window used for the kernel's pressure decisions; an explicit value wins and skips the probe |
-| `autoModelContextLimit` | `true` | Probe the model's real window from the model API (`agent.ctx.llm.resolveModelInfo`); fall back to the default on failure, the `/acp` command shows the window source (the `acp_status` model tool carries no window info). A failed probe is surfaced in the host log and the `/acp` panel (`restart to re-probe`) — the failure is cached like a success, so fixing the gateway requires a restart or an explicit `modelContextLimit` before the probe retries |
+| `modelContextLimit` | auto-detected (fallback `128000`) | Context window used for the kernel's pressure decisions; an explicit value wins and skips detection. When omitted, the host session projection `contextPressure.contextWindow` is read first — the capacity disclosed for the **current real route** (a session that switched models follows automatically, no restart needed) — and the model API is probed only when the projection discloses no window |
+| `autoModelContextLimit` | `true` | Resolve the real context window automatically: the host projection first (`windowFor` → `projectedContextWindow`, `src/window.ts`), then the model API probe (`agent.ctx.llm.resolveModelInfo`); both are skipped when `autoModelContextLimit: false`. On probe failure it falls back to the default, and the `/acp` command shows the window source (the `acp_status` model tool carries no window info). A failed probe is surfaced in the host log and the `/acp` panel (`restart to re-probe`) — the failure is cached like a success, so fixing the gateway requires a restart or an explicit `modelContextLimit` before the probe retries |
 | `nudgeMinContextLimitPct` | kernel default `0.45` | Nudge window lower bound (usage fraction) — validation only; the growth-driven trigger has no percentage floor — same default as billion-context-pi |
 | `nudgeMaxContextLimitPct` | engine default `0.70` (kernel/pi default `0.75`) | Over-limit line: above this the nudge fires regardless of growth — deliberately below the host compaction-basic 80% auto-compaction line so the forced nudge fires first; an explicit value wins (a same-name key in `coreOverrides.nudge` outranks it — see below) |
 | `nudgeEmergencyThresholdPct` | engine default `0.85` (kernel/pi default `0.95`) | Emergency nudge (bypasses the per-turn dedup) — lowered from `0.95`: at 95% the model has no room to act and the 80% auto-compaction line shadows it; an explicit value wins (a same-name key in `coreOverrides.nudge` outranks it — see below) |
@@ -233,7 +241,7 @@ src/
 ├── nudge.ts        # M4: kernel pressure decision → injected advisory nudge
 ├── system-prompt.ts# M4: one-time ACP guidance section (keeps nudges short)
 ├── config.ts       # kernel config assembly (thresholds + coreOverrides)
-├── window.ts       # auto context-window detection (LLM runtime probe, fallback 128000)
+├── window.ts       # auto context-window detection (session projection first, LLM runtime probe fallback, default 128000)
 └── commands.ts     # M4: /acp slash command
 ```
 

package/README.md

@@ -3,7 +3,7 @@
 [中文](./README.md) | [English](./README.en.md)
 
 > **⚠️ 测试版声明——请勿用于生产环境**
-> 本项目（**v0.2.15**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
+> 本项目（**v0.2.17**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
 
 <p align="center">
 <strong>衷心感谢以下项目——请给它们一个 ⭐：</strong>
@@ -88,6 +88,14 @@ npm install billion-context-dsh
 
 这只把包装进你的项目/全局，**不会**触碰任何 profile——请按下方「两种生效范围与自定义」手写组合行，引擎才会挂载。
 
+**git 源安装（`github:` 规格，插件商店展示的形态）。** 预构建产物 `dist/` 已提交到仓库，从 git 源安装同样开箱即用——**无需任何构建步骤**，pnpm 11 默认拦截构建脚本（`allowBuilds`）的机制对这个包不构成障碍：
+
+```bash
+dsh plugin --profile web add github:Tyan66666/billion-context-dsh#v0.2.17
+```
+
+建议带 `#<tag>` 安装，拿到与对应 npm 版本完全一致的产物；不带 ref 则装默认分支的最新构建。只有 clone 仓库自行从源码构建（`npm run build`）才需要放行构建。背景与方案取舍见 [docs/git-source-install-design.md](docs/git-source-install-design.md)（issue #92）。
+
 ## 两种生效范围与自定义
 
 本节服务于两类人：① 方式二（纯 npm 安装，必须手写组合行）；② 方式一用户想自定义 `config`（bundle 已有默认行为，只需用**同 id** 行覆盖）。
@@ -199,8 +207,8 @@ DSH 的每个模型请求都派生自其 append-only 会话日志（*surface*）
 
 | 键 | 默认值 | 含义 |
 |---|---|---|
-| `modelContextLimit` | 自动探测（回退 `128000`） | 用于内核压力决策的上下文窗口；显式配置时优先且跳过探测 |
-| `autoModelContextLimit` | `true` | 从模型 API 自动探测真实窗口（`agent.ctx.llm.resolveModelInfo`）；探测失败回退默认值，`/acp` 命令展示窗口来源（模型工具 `acp_status` 不含窗口信息）。探测失败会在宿主日志与 `/acp` 面板提示（`restart to re-probe`）——失败结果同样被缓存，修复网关后需重启或显式设置 `modelContextLimit` 才会重新探测 |
+| `modelContextLimit` | 自动探测（回退 `128000`） | 用于内核压力决策的上下文窗口；显式配置时优先且跳过探测。省略时优先读宿主会话投影 `contextPressure.contextWindow`（按**当前真实路由**披露的新窗口，切模型会话自动跟随，无需重启），无投影时再从模型 API 探测 |
+| `autoModelContextLimit` | `true` | 从模型 API 自动探测真实窗口（`agent.ctx.llm.resolveModelInfo`）；探测失败回退默认值，`/acp` 命令展示窗口来源（模型工具 `acp_status` 不含窗口信息）。省略时窗口先读宿主投影（`windowFor` → `projectedContextWindow`，`src/window.ts`）再走探测；投影与探测在 `autoModelContextLimit: false` 时均跳过。探测失败会在宿主日志与 `/acp` 面板提示（`restart to re-probe`）——失败结果同样被缓存，修复网关后需重启或显式设置 `modelContextLimit` 才会重新探测 |
 | `nudgeMinContextLimitPct` | 内核默认 `0.45` | Nudge 窗口下界（用量占比）——仅作配置校验，增长路径的触发没有百分比下限——与 billion-context-pi 相同的默认值 |
 | `nudgeMaxContextLimitPct` | engine 默认 `0.70`（内核/pi 默认 `0.75`） | 过限线：超过此值则无论增长与否都触发 nudge——刻意低于宿主 compaction-basic 的 80% 自动压缩线，保证强制 nudge 先触发；显式配置优先（`coreOverrides.nudge` 同名键优先级更高，见下） |
 | `nudgeEmergencyThresholdPct` | engine 默认 `0.85`（内核/pi 默认 `0.95`） | 紧急 nudge（绕过每轮去重）——从 `0.95` 下调：95% 时模型已无操作空间且会被 80% 自动压缩线遮蔽；显式配置优先（`coreOverrides.nudge` 同名键优先级更高，见下） |
@@ -233,7 +241,7 @@ src/
 ├── nudge.ts        # M4: 内核压力决策 → 注入的建议式 nudge
 ├── system-prompt.ts# M4: 一次性 ACP 指引段（让 nudge 保持简短）
 ├── config.ts       # 内核配置组装（阈值 + coreOverrides）
-├── window.ts       # 自动上下文窗口探测（LLM 运行时探测，回退 128000）
+├── window.ts       # 自动上下文窗口探测（宿主投影优先，LLM 运行时探测回退，兜底 128000）
 └── commands.ts     # M4: /acp 斜杠命令
 ```
 

package/dist/index.d.ts

@@ -40,18 +40,20 @@ export { DEFAULT_PROMPTS, DEFAULT_RESOLVED, renderSystemPrompt, renderTemplate,
 export { makeTools, type ToolEnvironment } from './tools.ts';
 export { acpCommand } from './commands.ts';
 export { buildNudge, resolveTokenCount, type NudgeEnvironment, type NudgeOutcome } from './nudge.ts';
-export { DEFAULT_CONTEXT_WINDOW, detectContextWindow, windowSourceLabel, type AcpWindow, } from './window.ts';
+export { DEFAULT_CONTEXT_WINDOW, detectContextWindow, projectedContextWindow, windowSourceLabel, type AcpWindow, } from './window.ts';
 export { AlreadyCompressedRangeError, rebuildBlockLedger, resolveSurfaceRange, runCompactionTransaction, shadowedSeqsOf, findOpenTurn, assertNoActiveCompaction, blockRegistry, blockRefForSummarySeq, compactionIdsOfKernelBlocks, summarySeqOfKernelBlock, expandShadowedSeqs, hideCompressToolPair, stripOrphanedSurfaceToolMessages, type AcpBlockLedgerEntry, type CompactionTransactionInput, type ResolvedSurfaceRange, } from './region.ts';
 export { eventsToCoreMessages, projectEvent, surfaceEventsOf, extractEventText } from './messages.ts';
 export interface AcpConfig {
     /**
      * The context window used for pressure decisions, in tokens. When omitted,
-     * `autoModelContextLimit` (default true) probes the model's real window via
+     * `autoModelContextLimit` (default true) resolves it automatically: the live
+     * host session projection (`contextPressure.contextWindow`) is preferred,
+     * then the model's real window is probed via
      * `agent.ctx.llm.resolveModelInfo(provider, model)`; an explicit value
-     * always wins and disables the probe.
+     * always wins and disables both.
      */
     readonly modelContextLimit?: number;
-    /** Probe the model's real context window from the LLM runtime. Default true. */
+    /** Auto-resolve the real context window: host session projection first, then the LLM runtime probe. Default true. */
     readonly autoModelContextLimit: boolean;
     /** Nudge window lower bound (usage fraction; validation only — the growth-driven trigger has no percentage floor). Kernel default 0.45 — same as billion-context-pi. */
     readonly nudgeMinContextLimitPct?: number;
@@ -129,10 +131,14 @@ export declare class AcpCompactionEngine extends CompactionEngine {
     constructor(ctx: Context, config?: Partial<AcpConfig>);
     /**
      * Resolve the effective context window for an agent. An explicitly
-     * configured `modelContextLimit` always wins (no probe). Otherwise probe the
-     * model's real window via `agent.ctx.llm.resolveModelInfo` (cached per
-     * provider/model route, probe failures cached too) and fall back to
-     * DEFAULT_CONTEXT_WINDOW when auto-detection is disabled or unavailable.
+     * configured `modelContextLimit` always wins (no probe). Otherwise the live
+     * session projection (`contextPressure.contextWindow`) is preferred when it
+     * discloses one — it tracks the session's CURRENT route, so a mid-session
+     * model switch repairs itself without a restart or config (see
+     * projectedContextWindow). Falls back to probing the model's real window
+     * via `agent.ctx.llm.resolveModelInfo` (cached per provider/model route,
+     * probe failures cached too) and finally to DEFAULT_CONTEXT_WINDOW when
+     * auto-detection is disabled or unavailable.
      */
     windowFor(agent: Agent): Promise<AcpWindow>;
     /** ACP is model-driven: automatic pressure policy never summarizes by itself. */

package/dist/index.js

@@ -4336,12 +4336,21 @@ function makeTools(env) {
 var DEFAULT_CONTEXT_WINDOW = 128e3;
 function windowSourceLabel(window) {
   if (window.source === "explicit") return "configured";
+  if (window.source === "projection") {
+    return `session projection current route (auto-refreshes on model switch)`;
+  }
   if (window.source === "auto") {
     return `auto-detected from ${window.provider ?? "?"}/${window.model ?? "?"}`;
   }
   if (window.probeFailed === true) return "default (auto-detection failed \u2014 restart to re-probe)";
   return "default (auto-detection unavailable)";
 }
+function projectedContextWindow(agent) {
+  const projections = agent.ctx?.get?.("sessionProjections");
+  const window = projections?.snapshot?.(agent.session)?.values?.contextPressure?.contextWindow;
+  if (typeof window === "number" && Number.isInteger(window) && window > 0) return window;
+  return null;
+}
 async function detectContextWindow(agent, provider, model) {
   const llm = agent.ctx?.get?.("llm");
   if (llm?.resolveModelInfo === void 0) return null;
@@ -4600,10 +4609,14 @@ var AcpCompactionEngine = class extends CompactionEngine {
   }
   /**
    * Resolve the effective context window for an agent. An explicitly
-   * configured `modelContextLimit` always wins (no probe). Otherwise probe the
-   * model's real window via `agent.ctx.llm.resolveModelInfo` (cached per
-   * provider/model route, probe failures cached too) and fall back to
-   * DEFAULT_CONTEXT_WINDOW when auto-detection is disabled or unavailable.
+   * configured `modelContextLimit` always wins (no probe). Otherwise the live
+   * session projection (`contextPressure.contextWindow`) is preferred when it
+   * discloses one — it tracks the session's CURRENT route, so a mid-session
+   * model switch repairs itself without a restart or config (see
+   * projectedContextWindow). Falls back to probing the model's real window
+   * via `agent.ctx.llm.resolveModelInfo` (cached per provider/model route,
+   * probe failures cached too) and finally to DEFAULT_CONTEXT_WINDOW when
+   * auto-detection is disabled or unavailable.
    */
   async windowFor(agent) {
     if (this.config.modelContextLimit !== void 0) {
@@ -4612,6 +4625,12 @@ var AcpCompactionEngine = class extends CompactionEngine {
     const provider = agent.options.provider ?? "";
     const model = agent.options.model ?? "";
     const key = `${provider}\0${model}`;
+    if (this.config.autoModelContextLimit) {
+      const projected = projectedContextWindow(agent);
+      if (projected !== null) {
+        return { limit: projected, source: "projection", provider, model };
+      }
+    }
     const cached = this.windowCache.get(key);
     if (cached !== void 0) return cached;
     let window;
@@ -4680,6 +4699,7 @@ export {
   kernelConfigFor,
   makeTools,
   projectEvent,
+  projectedContextWindow,
   rebuildBlockLedger,
   renderSystemPrompt,
   renderTemplate,