@dan-ai-studio/dshopencodego 0.1.16 → 0.1.18

package/README.en.md

@@ -71,7 +71,7 @@ Installation **must** go through the in-app UI — do not use the `dsh plugin` c
 
 Why: Electron owns the Desktop profile, and **the CLI cannot boot or mutate it** (Desktop README: *The CLI cannot boot or mutate this profile.*). Plugin management runs through the app's authenticated HTTP APIs and Desktop's bundled pnpm, so no `pnpm` on `PATH` is required. Upgrades and removals happen on the Plugins page too.
 
-The version constraint matches the CLI: the DSH bundled with the Desktop app must stay on the `0.1.7` line (`>=0.1.7-alpha.1 <0.1.8`, see "Compatibility"). If the plugin ever breaks startup, the Desktop's native recovery dialog can **disable third-party plugins, back up `cordis.patch.yml`, and restart** in one action — it will not lock the app out.
+The version constraint matches the CLI: the DSH bundled with the Desktop app must stay inside the declared and verified band (`>=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0`, see "Compatibility"). If the plugin ever breaks startup, the Desktop's native recovery dialog can **disable third-party plugins, back up `cordis.patch.yml`, and restart** in one action — it will not lock the app out.
 
 ## Configuration
 
@@ -136,7 +136,7 @@ The "OpenCode Go" section shows the live gateway catalog (the count follows the
 
 ## Compatibility
 
-**Supported**: DSH `0.1.7` releases (including `0.1.7-alpha.1`, `0.1.7-rc.*`, and the final release). Every `@deepseek-ai/dsh-*` peer dependency declares `>=0.1.7-alpha.1 <0.1.8`.
+**Supported**: DSH `0.1.7` releases (including `0.1.7-alpha.1`, `0.1.7-rc.*`, and the final release) and `0.2.0` releases (`0.2.0-rc.1` and later). Every `@deepseek-ai/dsh-*` peer dependency declares `>=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0` (`0.1.8` and `0.1.9` were never published, so the range is two segments rather than one).
 
 **The mechanism (not a hard pin)**: before mounting a plugin, DSH reads its `package.json` `peerDependencies` and semver-checks each against the **running DSH version** (prereleases participate):
 
@@ -146,15 +146,15 @@ The "OpenCode Go" section shows the live gateway catalog (the count follows the
 
 The `engines.dsh` field is informational for readers and package managers; **DSH's compatibility gate reads only `peerDependencies`**. `@deepseek-ai/cordis` is declared separately as `4.0.2 || 4.0.3 || 4.0.4`.
 
-**0.1.8+ or older releases**: the plugin is refused. If the seam is compatible, widen the peer range in your own build (never in DSH core), or wait for a plugin release.
+**Outside the declared range**: releases before `0.1.7-alpha.1`, the never-published gap `>=0.1.8 <0.2.0-rc.1`, and `0.3.0+` are refused. If the seam is compatible, widen the peer range in your own build (never in DSH core), or wait for a plugin release.
 
 ### Version-binding notes
 
 | Binding layer | Declared | Enforced by |
 | --- | --- | --- |
-| `peerDependencies` (17 `@deepseek-ai/dsh-*` packages) | all `>=0.1.7-alpha.1 <0.1.8` | **DSH's gate, at plugin load time** |
+| `peerDependencies` (17 `@deepseek-ai/dsh-*` packages) | all `>=0.1.7-alpha.1 <0.2.0 \|\| >=0.2.0-rc.1 <0.3.0` | **DSH's gate, at plugin load time** |
 | `@deepseek-ai/cordis` | `4.0.2 \|\| 4.0.3 \|\| 4.0.4` | the same gate |
-| `engines.dsh` | `>=0.1.7-alpha.1 <0.1.8` | informational only; DSH never reads it |
+| `engines.dsh` | `>=0.1.7-alpha.1 <0.2.0 \|\| >=0.2.0-rc.1 <0.3.0` | informational only; DSH never reads it |
 | `engines.node` | `^22.19.0 \|\| >=24.0.0` | the package manager |
 | bundled `@earendil-works/pi-ai` | pinned to exactly `0.87.1` | an independent coupling: a change in pi-ai's request construction changes this plugin's wire behaviour |
 | bundled `@deepseek-ai/schemastery` | `^3.18.3` | ordinary semver |
@@ -162,8 +162,8 @@ The `engines.dsh` field is informational for readers and package managers; **DSH
 Things to keep in mind when maintaining this:
 
 - **Required versus optional peers**: six of the eighteen are marked `optional` (`dsh-api-remotes`, `dsh-client-locale`, `dsh-client-store`, `dsh-client-ui-model-selection`, `dsh-client-ui-settings`, `dsh-client-ui-slots`). The twelve that actually block loading are `cordis`, `dsh-attachment`, `dsh-brand`, `dsh-client-ui-conversation`, `dsh-client-ui-renderer`, `dsh-credentials`, `dsh-fs`, `dsh-launch-environment`, `dsh-llm`, `dsh-timeout`, `dsh-typert-protocol`, and `dsh-typert-registry`. `dsh-llm` is the heaviest coupling — more than twenty imports across the source.
-- **Declared range ≠ verified range**: `0.1.7-alpha.1` and `alpha.2` fall inside the declaration but were never verified here. What was verified is `0.1.7-rc.1` (the dev-dependency baseline) and `0.1.7-rc.2` (daily use).
-- **The upper bound is a tracking line**: `<0.1.8` means that the moment DSH ships `0.1.8`, this plugin must ship a new release in the same window or every user loses the plugin. After changing a range, `npm test` is the verification (local mock gateway, no network, no tokens) — ranges follow what the interfaces declare, and are never "measured" with live probes.
+- **Declared range ≠ verified range**: `0.1.7-alpha.1` and `alpha.2` fall inside the declaration but were never verified here. What was verified is `0.1.7-rc.1`, `0.1.7-rc.2` (daily use), `0.2.0-rc.1` (the dev-dependency baseline: gate verdict + typecheck + full suite), and `0.2.0-rc.2` (dev-dependency baseline + `prepareCall` generation freeze + pi-ai delta-parse patch port).
+- **The upper bound is a tracking line**: `<0.3.0` means that the moment DSH ships `0.3.0`, this plugin must ship a new release in the same window or every user loses the plugin. The current range spans both `0.1.7` and `0.2.0` (`0.1.8` and `0.1.9` were never published, hence two segments). After changing a range, `npm test` is the verification (local mock gateway, no network, no tokens) — ranges follow what the interfaces declare, and are never "measured" with live probes.
 - **Peer coverage is now guarded both ways**: `dsh-typert-registry`, `dsh-client-ui-conversation`, and `dsh-client-ui-renderer` were imported by the source but absent from `peerDependencies`, invisible to the gate; they are declared now, and `tests/peer-coverage.spec.ts` asserts both directions — anything the source imports must be declared, and anything declared but unreached must be removed (`dsh-settings` went that way: the settings form is actually provided by `dsh-client-ui-settings`).
 - **Exemptions are per profile**: only a profile that ran `dsh plugin allow-version` has one, and no record means the plugin must stay inside the declared range. `dsh plugin version-exemptions` lists a profile's exemptions.
 

package/README.md

@@ -71,7 +71,7 @@ DSH 桌面端是 Electron 壳 + 完整的 dsh Web 应用，本插件对它同样
 
 原因：桌面端 profile 由 Electron 自己拥有，**CLI 不能启动也不能修改它**（桌面端 README 原文：*The CLI cannot boot or mutate this profile.*）。插件管理由应用内插件页经认证 HTTP API 完成，使用应用自带的 pnpm，不依赖 PATH 里的 `pnpm`；升级与卸载同样在 Plugins 页操作。
 
-版本约束与 CLI 一致：桌面端内置的 DSH 要落在 `0.1.7` 线内（`>=0.1.7-alpha.1 <0.1.8`，见「兼容性」）。若插件导致启动失败，桌面端的原生恢复对话框可以一键**禁用第三方插件、备份 `cordis.patch.yml` 后重启**，不会把应用锁死。
+版本约束与 CLI 一致：桌面端内置的 DSH 要落在已声明并验证过的版本带内（`>=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0`，见「兼容性」）。若插件导致启动失败，桌面端的原生恢复对话框可以一键**禁用第三方插件、备份 `cordis.patch.yml` 后重启**，不会把应用锁死。
 
 ## 配置
 
@@ -136,7 +136,7 @@ API Key 通过 Harness 凭证库提供（引用名 `OPENCODE_GO_API_KEY`），
 
 ## 兼容性
 
-**支持**：DSH `0.1.7` 系列（含 `0.1.7-alpha.1`、`0.1.7-rc.*` 与正式版）。插件在每个 `@deepseek-ai/dsh-*` 的 `peerDependencies` 上声明 `>=0.1.7-alpha.1 <0.1.8`。
+**支持**：DSH `0.1.7` 系列（含 `0.1.7-alpha.1`、`0.1.7-rc.*` 与正式版）与 `0.2.0` 系列（`0.2.0-rc.1` 及之后的正式版）。插件在每个 `@deepseek-ai/dsh-*` 的 `peerDependencies` 上声明 `>=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0`（`0.1.8`、`0.1.9` 从未发布，是两段之间的空白带）。
 
 **机制（不是写死）**：DSH 在挂载插件前会读取插件 `package.json` 的 `peerDependencies`，对**运行时的 DSH 版本**逐个做 semver 判定（含预发布）：
 
@@ -146,15 +146,15 @@ API Key 通过 Harness 凭证库提供（引用名 `OPENCODE_GO_API_KEY`），
 
 `package.json` 里的 `engines.dsh` 是本插件为读者/包管理器写的信息字段；**DSH 的兼容门禁只读 `peerDependencies`**，请以它为准。`@deepseek-ai/cordis` 单独声明为 `4.0.2 || 4.0.3 || 4.0.4`。
 
-**0.1.8+ 或更早版本**：会被拒绝加载。如果 DSH 侧接口兼容，可自行放宽该插件的 peer 范围并重新构建（不改 DSH 核心）；否则请等插件跟进发版。
+**声明范围之外**：`0.1.7-alpha.1` 之前、`0.1.8`–`0.2.0-rc.1` 之间的空白带、以及 `0.3.0+` 会被拒绝加载。如果 DSH 侧接口兼容，可自行放宽该插件的 peer 范围并重新构建（不改 DSH 核心）；否则请等插件跟进发版。
 
 ### 版本绑定的注意事项
 
 | 绑定层 | 声明 | 谁在把关 |
 | --- | --- | --- |
-| `peerDependencies`（17 个 `@deepseek-ai/dsh-*`） | 均为 `>=0.1.7-alpha.1 <0.1.8` | **DSH 加载时的真门禁** |
+| `peerDependencies`（17 个 `@deepseek-ai/dsh-*`） | 均为 `>=0.1.7-alpha.1 <0.2.0 \|\| >=0.2.0-rc.1 <0.3.0` | **DSH 加载时的真门禁** |
 | `@deepseek-ai/cordis` | `4.0.2 \|\| 4.0.3 \|\| 4.0.4` | 同一门禁 |
-| `engines.dsh` | `>=0.1.7-alpha.1 <0.1.8` | 仅信息字段，DSH 不读 |
+| `engines.dsh` | `>=0.1.7-alpha.1 <0.2.0 \|\| >=0.2.0-rc.1 <0.3.0` | 仅信息字段，DSH 不读 |
 | `engines.node` | `^22.19.0 \|\| >=24.0.0` | 包管理器 |
 | 自带依赖 `@earendil-works/pi-ai` | 精确锁 `0.87.1` | 独立耦合：pi-ai 改请求构造即影响本插件的线上行为 |
 | 自带依赖 `@deepseek-ai/schemastery` | `^3.18.3` | 常规 semver |
@@ -162,8 +162,8 @@ API Key 通过 Harness 凭证库提供（引用名 `OPENCODE_GO_API_KEY`），
 维护时需要注意：
 
 - **必选与可选之分**：18 个 peer（17 个 `dsh-*` 加框架 `cordis`）中 6 个标了 `optional`（`dsh-api-remotes`、`dsh-client-locale`、`dsh-client-store`、`dsh-client-ui-model-selection`、`dsh-client-ui-settings`、`dsh-client-ui-slots`）；真正卡住加载的是 12 个——`cordis`、`dsh-attachment`、`dsh-brand`、`dsh-client-ui-conversation`、`dsh-client-ui-renderer`、`dsh-credentials`、`dsh-fs`、`dsh-launch-environment`、`dsh-llm`、`dsh-timeout`、`dsh-typert-protocol`、`dsh-typert-registry`。其中 `dsh-llm` 是最重的一处耦合（源码 import 二十余处）。
-- **名义范围 ≠ 实测范围**：`0.1.7-alpha.1`、`alpha.2` 落在声明范围内，但本项目没有验证过；实际验证过的是 `0.1.7-rc.1`（开发依赖基线）与 `0.1.7-rc.2`（日常使用）。
-- **上界就是跟版线**：`<0.1.8` 意味着 DSH 一旦发布 `0.1.8`，本插件必须同批发新版，否则所有用户加载失败。调整范围后用 `npm test` 验证即可（本地 mock 网关，零网络零 token）——范围以接口声明为准，不要用线上探测来"测"出一个范围。
+- **名义范围 ≠ 实测范围**：`0.1.7-alpha.1`、`alpha.2` 落在声明范围内，但本项目没有验证过；实际验证过的是 `0.1.7-rc.1`、`0.1.7-rc.2`（日常使用）、`0.2.0-rc.1`（开发依赖基线：门禁判定 + typecheck + 全量用例）与 `0.2.0-rc.2`（开发依赖基线 + `prepareCall` 代次冻结 + pi-ai 增量解析补丁移植）。
+- **上界就是跟版线**：`<0.3.0` 意味着 DSH 一旦发布 `0.3.0`，本插件必须同批发新版，否则所有用户加载失败。当前范围跨 `0.1.7` 与 `0.2.0` 两代（`0.1.8`、`0.1.9` 从未发布，所以写成两段而不是一条）。调整范围后用 `npm test` 验证即可（本地 mock 网关，零网络零 token）——范围以接口声明为准，不要用线上探测来"测"出一个范围。
 - **peer 覆盖已双向守住**：`dsh-typert-registry`、`dsh-client-ui-conversation`、`dsh-client-ui-renderer` 曾被源码 import 却未声明、门禁管不到，现已补进 `peerDependencies`；`tests/peer-coverage.spec.ts` 双向断言——源码用到的必须声明，声明了却没人用的必须删（`dsh-settings` 就这样被移除：设置表单实际由 `dsh-client-ui-settings` 提供）。
 - **豁免是按 profile 记的**：只有显式执行过 `dsh plugin allow-version` 的 profile 才享有豁免；没有记录就代表必须落在声明范围内。用 `dsh plugin version-exemptions` 可查看当前 profile 的豁免。
 

package/lib/client.js

@@ -462,7 +462,7 @@ if (!document.querySelector("style[data-plugin-css=" + JSON.stringify(id) + "]")
   style.textContent = ".d7lz0W_root{color:var(--dsw-alias-label-primary);flex-direction:column;gap:1.25rem;display:flex}.d7lz0W_title{margin:0;font-size:1.05rem}.d7lz0W_hint{color:var(--dsw-alias-label-secondary);margin:0;font-size:.8rem}.d7lz0W_warn{color:var(--dsw-alias-state-warn-primary);margin:0;font-size:.8rem}.d7lz0W_ok{color:var(--dsw-alias-state-success-primary);font-size:.8rem}.d7lz0W_block{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);border-radius:.6rem;flex-direction:column;gap:.5rem;padding:.85rem;display:flex}.d7lz0W_row{flex-wrap:wrap;align-items:center;gap:.5rem;display:flex}.d7lz0W_row>strong{margin-right:auto}.d7lz0W_input{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-base);min-width:10rem;color:var(--dsw-alias-label-primary);font:inherit;border-radius:.35rem;flex:14rem;padding:.35rem .5rem;font-size:.85rem}.d7lz0W_button{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;border-radius:.35rem;padding:.35rem .7rem;font-size:.8rem}.d7lz0W_button:disabled{color:var(--dsw-alias-state-idle-primary);cursor:default}.d7lz0W_number{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-base);width:5rem;color:var(--dsw-alias-label-primary);font:inherit;border-radius:.35rem;padding:.25rem .4rem;font-size:.8rem}.d7lz0W_select{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-base);width:auto;max-width:100%;color:var(--dsw-alias-label-primary);font:inherit;border-radius:.35rem;padding:.25rem .4rem;font-size:.8rem}.d7lz0W_list{flex-direction:column;display:flex}.d7lz0W_item{border-top:1px solid var(--dsw-alias-border-l1);align-items:flex-start;gap:.5rem;padding:.45rem .15rem;display:flex}.d7lz0W_item input[type=checkbox]{accent-color:var(--dsw-alias-brand-primary);margin-top:.15rem}.d7lz0W_itemBody{flex-direction:column;gap:.15rem;min-width:0;display:flex}.d7lz0W_itemMain{flex-wrap:wrap;align-items:baseline;gap:.6rem;display:flex}.d7lz0W_itemMeta{color:var(--dsw-alias-label-secondary);flex-wrap:wrap;gap:.75rem;font-size:.75rem;display:flex}.d7lz0W_itemModalities{color:var(--dsw-alias-label-secondary);font-size:.75rem}.d7lz0W_name{color:var(--dsw-alias-label-primary)}.d7lz0W_mono{color:var(--dsw-alias-label-secondary);font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.d7lz0W_badge{color:var(--dsw-alias-brand-primary)}";
   document.head.appendChild(style);
 }
-var section_default = { "itemBody": "d7lz0W_itemBody", "name": "d7lz0W_name", "warn": "d7lz0W_warn", "block": "d7lz0W_block", "button": "d7lz0W_button", "ok": "d7lz0W_ok", "title": "d7lz0W_title", "hint": "d7lz0W_hint", "list": "d7lz0W_list", "itemMain": "d7lz0W_itemMain", "item": "d7lz0W_item", "number": "d7lz0W_number", "mono": "d7lz0W_mono", "badge": "d7lz0W_badge", "itemMeta": "d7lz0W_itemMeta", "input": "d7lz0W_input", "row": "d7lz0W_row", "itemModalities": "d7lz0W_itemModalities", "select": "d7lz0W_select", "root": "d7lz0W_root" };
+var section_default = { "ok": "d7lz0W_ok", "itemModalities": "d7lz0W_itemModalities", "number": "d7lz0W_number", "hint": "d7lz0W_hint", "item": "d7lz0W_item", "block": "d7lz0W_block", "name": "d7lz0W_name", "warn": "d7lz0W_warn", "itemMain": "d7lz0W_itemMain", "badge": "d7lz0W_badge", "button": "d7lz0W_button", "input": "d7lz0W_input", "row": "d7lz0W_row", "select": "d7lz0W_select", "title": "d7lz0W_title", "list": "d7lz0W_list", "root": "d7lz0W_root", "itemMeta": "d7lz0W_itemMeta", "itemBody": "d7lz0W_itemBody", "mono": "d7lz0W_mono" };
 
 // src/client/Section.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -963,7 +963,7 @@ if (!document.querySelector("style[data-plugin-css=" + JSON.stringify(id2) + "]"
   style.textContent = ".mMNkkW_root{align-items:center;display:inline-flex;position:relative}.mMNkkW_trigger{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);font:inherit;cursor:pointer;white-space:nowrap;border-radius:999px;padding:.35rem .6rem;font-size:.8rem;line-height:1}.mMNkkW_trigger:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-border-l2)}.mMNkkW_panel{z-index:20;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-overlay);width:18rem;color:var(--dsw-alias-label-primary);border-radius:.6rem;flex-direction:column;gap:.6rem;padding:.75rem .85rem;display:flex;position:absolute;bottom:calc(100% + .5rem);right:0;box-shadow:0 8px 24px #0000002e}.mMNkkW_window{flex-direction:column;gap:.25rem;display:flex}.mMNkkW_row{justify-content:space-between;gap:.5rem;font-size:.85rem;display:flex}.mMNkkW_hint{color:var(--dsw-alias-label-secondary);margin:0;font-size:.75rem}.mMNkkW_progress{width:100%;height:.35rem;accent-color:var(--dsw-alias-brand-primary)}.mMNkkW_limited{color:var(--dsw-alias-state-warn-primary);font-size:.75rem}.mMNkkW_warning{border:1px solid var(--dsw-alias-state-warn-primary);color:var(--dsw-alias-label-primary);border-radius:.4rem;padding:.4rem .5rem;font-size:.75rem}.mMNkkW_retry{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;border-radius:.35rem;align-self:flex-start;padding:.25rem .5rem;font-size:.75rem}.mMNkkW_local{border-top:1px solid var(--dsw-alias-border-l1);flex-direction:column;gap:.2rem;padding-top:.5rem;display:flex}";
   document.head.appendChild(style);
 }
-var pill_default = { "window": "mMNkkW_window", "row": "mMNkkW_row", "retry": "mMNkkW_retry", "trigger": "mMNkkW_trigger", "progress": "mMNkkW_progress", "root": "mMNkkW_root", "panel": "mMNkkW_panel", "warning": "mMNkkW_warning", "local": "mMNkkW_local", "limited": "mMNkkW_limited", "hint": "mMNkkW_hint" };
+var pill_default = { "hint": "mMNkkW_hint", "warning": "mMNkkW_warning", "trigger": "mMNkkW_trigger", "row": "mMNkkW_row", "retry": "mMNkkW_retry", "root": "mMNkkW_root", "panel": "mMNkkW_panel", "local": "mMNkkW_local", "window": "mMNkkW_window", "limited": "mMNkkW_limited", "progress": "mMNkkW_progress" };
 
 // src/client/UsagePill.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");

package/lib/index.js

@@ -1439,6 +1439,7 @@ var OpencodeGoAdapter = class extends LlmAdapter {
             input: ["text"]
           },
           overrides: config.modelProtocols,
+          ...this.options.readDocument === void 0 ? {} : { readDocument: this.options.readDocument },
           observers: {
             ...this.options.onFallback === void 0 ? {} : { onFallback: this.options.onFallback },
             ...this.options.onUnconfigured === void 0 ? {} : { onUnconfigured: this.options.onUnconfigured }
@@ -1518,14 +1519,28 @@ var OpencodeGoAdapter = class extends LlmAdapter {
       "UNSUPPORTED_REASONING_EFFORT"
     );
   }
+  async prepareCall(_provider, model, _signal) {
+    const config = this.options.config();
+    const snapshot = await this.catalogOf(config).forModel(model);
+    const facts = snapshot.facts.get(model);
+    if (facts === void 0) throw new LlmError8(`opencode-go has no model "${model}"`, "UNKNOWN_MODEL");
+    const prepared = this.modelInfo(withModelLimit(toPiModel(facts, config.baseURL), config.modelLimits));
+    return {
+      model: prepared,
+      stream: (options) => this.streamWithSnapshot(options, config, snapshot)
+    };
+  }
   async *stream(options) {
+    const config = this.options.config();
+    const snapshot = await this.catalogOf(config).forModel(options.model);
+    yield* this.streamWithSnapshot(options, config, snapshot);
+  }
+  async *streamWithSnapshot(options, config, snapshot) {
     var _stack = [];
     try {
       if (options.stop !== void 0) {
         throw new LlmError8("dshopencodego does not support GenerateOptions.stop", "UNSUPPORTED_OPTION");
       }
-      const config = this.options.config();
-      const snapshot = await this.catalogOf(config).forModel(options.model);
       const facts = snapshot.facts.get(options.model);
       if (facts === void 0) throw new LlmError8(`opencode-go has no model "${options.model}"`, "UNKNOWN_MODEL");
       const model = withModelLimit(toPiModel(facts, config.baseURL), config.modelLimits);

package/lib/types/adapter.d.ts

@@ -13,9 +13,10 @@
  * @module @dan-ai-studio/dshopencodego/adapter
  */
 import { attributionHeaders, LlmAdapter } from '@deepseek-ai/dsh-llm';
-import type { GenerateOptions, ImageAttachmentAccess, LlmModelInfo, LlmResolvedModelInfo, ResolvedRetryPolicy, StreamChunk, TokenUsage } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, ImageAttachmentAccess, LlmModelInfo, LlmResolvedModelInfo, PreparedAdapterCall, ResolvedRetryPolicy, StreamChunk, TokenUsage } from '@deepseek-ai/dsh-llm';
 import type { AttachmentStore, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import { OpencodeGoCatalog } from './catalog/index.ts';
+import type { GoDoc } from './catalog/go-doc.ts';
 import type { OpencodeGoConfig } from './config.ts';
 /** Image machinery the adapter reads once per request. */
 export interface OpencodeGoImageAccess {
@@ -45,6 +46,11 @@ export interface OpencodeGoAdapterOptions {
     }[]) => void;
     /** Observe assistant history degrading to provider-neutral conversion. */
     readonly onReplayDegrade?: (reason: string) => void;
+    /**
+     * Read the provider documentation. Defaults to the real fetch; tests inject
+     * a fixed document so the suite stays offline. Production omits this.
+     */
+    readonly readDocument?: () => Promise<GoDoc>;
     /**
      * Observe the provider's own usage for one completed call. This is the only
      * honest source of token counts: the gateway's `/usage` endpoint reports
@@ -86,7 +92,9 @@ export declare class OpencodeGoAdapter extends LlmAdapter {
     providerRetryPolicy(_provider: string): ResolvedRetryPolicy | undefined;
     /** Validate an explicit effort against the model's own levels, without clamping. */
     private resolveReasoningLevel;
+    prepareCall(_provider: string, model: string, _signal?: AbortSignal): Promise<PreparedAdapterCall>;
     stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
+    private streamWithSnapshot;
 }
 /** Re-exported so a composition can assert the attribution contract in one place. */
 export { attributionHeaders };

package/lib/types/adapter.js

@@ -119,6 +119,7 @@ export class OpencodeGoAdapter extends LlmAdapter {
                         input: ['text'],
                     },
                     overrides: config.modelProtocols,
+                    ...this.options.readDocument === undefined ? {} : { readDocument: this.options.readDocument },
                     observers: {
                         ...this.options.onFallback === undefined ? {} : { onFallback: this.options.onFallback },
                         ...this.options.onUnconfigured === undefined ? {} : { onUnconfigured: this.options.onUnconfigured },
@@ -213,14 +214,33 @@ export class OpencodeGoAdapter extends LlmAdapter {
             return effort;
         throw new LlmError(`opencode-go model "${model.id}" does not support reasoning effort "${effort}"`, 'UNSUPPORTED_REASONING_EFFORT');
     }
+    async prepareCall(_provider, model, _signal) {
+        // Freeze one generation: the config, catalog snapshot, and model facts are
+        // captured before the first await, so a settings change between preparation
+        // and dispatch cannot combine one generation's capabilities with another's
+        // endpoint. Mirrors llm-pi-ai's snapshot discipline.
+        const config = this.options.config();
+        const snapshot = await this.catalogOf(config).forModel(model);
+        const facts = snapshot.facts.get(model);
+        if (facts === undefined)
+            throw new LlmError(`opencode-go has no model "${model}"`, 'UNKNOWN_MODEL');
+        const prepared = this.modelInfo(withModelLimit(toPiModel(facts, config.baseURL), config.modelLimits));
+        return {
+            model: prepared,
+            stream: options => this.streamWithSnapshot(options, config, snapshot),
+        };
+    }
     async *stream(options) {
+        const config = this.options.config();
+        const snapshot = await this.catalogOf(config).forModel(options.model);
+        yield* this.streamWithSnapshot(options, config, snapshot);
+    }
+    async *streamWithSnapshot(options, config, snapshot) {
         const env_1 = { stack: [], error: void 0, hasError: false };
         try {
             if (options.stop !== undefined) {
                 throw new LlmError('dshopencodego does not support GenerateOptions.stop', 'UNSUPPORTED_OPTION');
             }
-            const config = this.options.config();
-            const snapshot = await this.catalogOf(config).forModel(options.model);
             const facts = snapshot.facts.get(options.model);
             if (facts === undefined)
                 throw new LlmError(`opencode-go has no model "${options.model}"`, 'UNKNOWN_MODEL');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dan-ai-studio/dshopencodego",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage",
   "type": "module",
   "license": "MIT",
@@ -14,7 +14,7 @@
   },
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.1.7-alpha.1 <0.1.8"
+    "dsh": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0"
   },
   "main": "./lib/index.js",
   "types": "./lib/types/index.d.ts",
@@ -59,6 +59,7 @@
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
+    "postinstall": "node scripts/patch-pi-ai.mjs",
     "prepare": "npm run build",
     "prepack": "npm run build"
   },
@@ -68,23 +69,23 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "4.0.2 || 4.0.3 || 4.0.4",
-    "@deepseek-ai/dsh-api-remotes": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-attachment": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-brand": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-client-store": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-client-ui-model-selection": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-fs": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-launch-environment": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-timeout": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.7-alpha.1 <0.1.8",
-    "@deepseek-ai/dsh-typert-registry": ">=0.1.7-alpha.1 <0.1.8"
+    "@deepseek-ai/dsh-api-remotes": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-attachment": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-brand": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-store": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-model-selection": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-fs": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-launch-environment": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-timeout": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-typert-registry": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-api-remotes": {
@@ -108,24 +109,28 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-brand": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-model-selection": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-credentials": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-fs": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-launch-environment": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-timeout": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-model-selection": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-launch-environment": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-sandbox": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-scope": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-timeout": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-registry": "^0.2.0-rc.2",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.20.0",