@dan-ai-studio/dshopencodego 0.1.34 → 0.1.35

package/README.en.md

@@ -173,7 +173,7 @@ The `engines.dsh` field is informational for readers and package managers; **DSH
 | `@deepseek-ai/cordis` | `4.0.2 \|\| 4.0.3 \|\| 4.0.4 \|\| 4.0.5-alpha.1 \|\| 4.0.5-alpha.2` | the same gate |
 | `engines.dsh` | `>=0.1.7-alpha.1 <0.2.0 \|\| >=0.2.0-rc.1 <0.2.1 \|\| >=0.2.1-alpha.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` | patch-level range `~1.0.2` (within 1.0.x) | an independent coupling: a change in pi-ai's request construction changes this plugin's wire behaviour |
+| bundled `@earendil-works/pi-ai` | patch-level range `~1.3.0` (within 1.3.x) | an independent coupling: a change in pi-ai's request construction changes this plugin's wire behaviour, and its builtin catalog is this plugin's fallback data |
 | bundled `@deepseek-ai/schemastery` | `~3.18.5-alpha.2` | kept in step with `dsh-settings`'s peer |
 
 Things to keep in mind when maintaining this:
@@ -196,7 +196,7 @@ Things to keep in mind when maintaining this:
 | "The settings write was rejected" | Usually a concurrent writer (another window or process) holding the same profile. The plugin retries once automatically; if it still fails the view has reloaded — click again. |
 | The usage button shows "unavailable" | An endpoint or credential change invalidated the previous reading. Fix the configuration and press Retry. It never shows `0` in place of a missing reading. |
 | npm publish fails with `ENEEDAUTH` | OIDC did not match: check the Trusted Publisher's **workflow filename** (must be exactly `publish-npm.yml`, case-sensitive) and the organization/repository fields; run on GitHub-hosted runners with `id-token: write`. A `repository.url` that does not match the GitHub repository is rejected as well. |
-| The whole DSH process stalls during ultra-long tool calls (multi-MB arguments) | Observed on pi-ai `0.87.1`: per-delta re-parsing of the accumulated arguments (issue #9265 / PR #9461). This plugin does not port DSH's consumer-side patch (ADR-0005); the bundled dependency is now `~1.0.2`, so a recurrence would be upstream behaviour and would be fixed by an upstream release. |
+| The whole DSH process stalls during ultra-long tool calls (multi-MB arguments) | Observed on pi-ai `0.87.1`: per-delta re-parsing of the accumulated arguments (issue #9265 / PR #9461). This plugin does not port DSH's consumer-side patch (ADR-0005); the bundled dependency is now `~1.3.0`, so a recurrence would be upstream behaviour and would be fixed by an upstream release. |
 
 ## Development
 

package/README.md

@@ -173,7 +173,7 @@ API Key 通过 Harness 凭证库提供（引用名 `OPENCODE_GO_API_KEY`），
 | `@deepseek-ai/cordis` | `4.0.2 \|\| 4.0.3 \|\| 4.0.4 \|\| 4.0.5-alpha.1 \|\| 4.0.5-alpha.2` | 同一门禁 |
 | `engines.dsh` | `>=0.1.7-alpha.1 <0.2.0 \|\| >=0.2.0-rc.1 <0.2.1 \|\| >=0.2.1-alpha.1 <0.3.0` | 仅信息字段，DSH 不读 |
 | `engines.node` | `^22.19.0 \|\| >=24.0.0` | 包管理器 |
-| 自带依赖 `@earendil-works/pi-ai` | 补丁级范围 `~1.0.2`（1.0.x 内） | 独立耦合：pi-ai 改请求构造即影响本插件的线上行为 |
+| 自带依赖 `@earendil-works/pi-ai` | 补丁级范围 `~1.3.0`（1.3.x 内） | 独立耦合：pi-ai 改请求构造即影响本插件的线上行为；其内置目录同时是本插件的打底数据 |
 | 自带依赖 `@deepseek-ai/schemastery` | `~3.18.5-alpha.2` | 与 `dsh-settings` 的 peer 保持一致 |
 
 维护时需要注意：
@@ -196,7 +196,7 @@ API Key 通过 Harness 凭证库提供（引用名 `OPENCODE_GO_API_KEY`），
 | 设置页出现「设置写入被拒绝」 | 通常是与另一个窗口/进程并发写同一 profile；插件会自动重试一次，仍失败时界面已重载最新状态，再点一次即可。 |
 | 用量按钮显示「不可用」 | 端点或凭证变化导致旧读数作废；配置正确后点「重试」。数值不会以 0 冒充。 |
 | npm 发布报 `ENEEDAUTH` | OIDC 没匹配上：核对包设置里 Trusted Publisher 的 **workflow 文件名**（必须恰为 `publish-npm.yml`、大小写敏感）与组织/仓库字段；确认跑在 GitHub 托管 runner 上且工作流带 `id-token: write`。`package.json` 的 `repository.url` 与仓库不符也会被拒。 |
-| 超长工具调用（多 MB 参数）期间整个 DSH 进程卡顿 | 曾在 pi-ai `0.87.1` 上观测到逐 delta 重解析的固有开销（issue #9265 / PR #9461）。本插件不移植 DSH 的消费者侧补丁（ADR-0005）；当前自带依赖已是 `~1.0.2`，若仍复现则属上游行为，随其发版解决。 |
+| 超长工具调用（多 MB 参数）期间整个 DSH 进程卡顿 | 曾在 pi-ai `0.87.1` 上观测到逐 delta 重解析的固有开销（issue #9265 / PR #9461）。本插件不移植 DSH 的消费者侧补丁（ADR-0005）；当前自带依赖已是 `~1.3.0`，若仍复现则属上游行为，随其发版解决。 |
 
 ## 开发
 

package/lib/client.js

@@ -562,7 +562,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 = { "title": "d7lz0W_title", "row": "d7lz0W_row", "button": "d7lz0W_button", "number": "d7lz0W_number", "mono": "d7lz0W_mono", "item": "d7lz0W_item", "hint": "d7lz0W_hint", "input": "d7lz0W_input", "name": "d7lz0W_name", "warn": "d7lz0W_warn", "itemMain": "d7lz0W_itemMain", "block": "d7lz0W_block", "select": "d7lz0W_select", "badge": "d7lz0W_badge", "ok": "d7lz0W_ok", "root": "d7lz0W_root", "list": "d7lz0W_list", "itemMeta": "d7lz0W_itemMeta", "itemModalities": "d7lz0W_itemModalities", "itemBody": "d7lz0W_itemBody" };
+var section_default = { "itemMain": "d7lz0W_itemMain", "warn": "d7lz0W_warn", "select": "d7lz0W_select", "mono": "d7lz0W_mono", "title": "d7lz0W_title", "block": "d7lz0W_block", "hint": "d7lz0W_hint", "row": "d7lz0W_row", "itemModalities": "d7lz0W_itemModalities", "button": "d7lz0W_button", "ok": "d7lz0W_ok", "number": "d7lz0W_number", "list": "d7lz0W_list", "item": "d7lz0W_item", "itemBody": "d7lz0W_itemBody", "root": "d7lz0W_root", "input": "d7lz0W_input", "itemMeta": "d7lz0W_itemMeta", "name": "d7lz0W_name", "badge": "d7lz0W_badge" };
 
 // src/client/Section.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -1335,7 +1335,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 = { "root": "mMNkkW_root", "limited": "mMNkkW_limited", "local": "mMNkkW_local", "warning": "mMNkkW_warning", "window": "mMNkkW_window", "hint": "mMNkkW_hint", "retry": "mMNkkW_retry", "trigger": "mMNkkW_trigger", "panel": "mMNkkW_panel", "row": "mMNkkW_row", "progress": "mMNkkW_progress" };
+var pill_default = { "warning": "mMNkkW_warning", "local": "mMNkkW_local", "retry": "mMNkkW_retry", "trigger": "mMNkkW_trigger", "root": "mMNkkW_root", "panel": "mMNkkW_panel", "window": "mMNkkW_window", "hint": "mMNkkW_hint", "row": "mMNkkW_row", "progress": "mMNkkW_progress", "limited": "mMNkkW_limited" };
 
 // src/client/UsagePill.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");

package/lib/index.js

@@ -421,7 +421,13 @@ function readOnlineMetadata(body, sources) {
         throw new Error(`configured protocol "${sources.overrides[id]}" is not one of anthropic-messages, openai-completions, openai-responses`);
       }
       const decision = decideProtocol(id, {
-        ...exact?.api === void 0 ? {} : { builtin: exact.api },
+        // Guarded, not asserted: pi-ai's builtin catalog is wider than this
+        // plugin's three protocols — 1.3.0 labels `gemini-4-argon-contributor`
+        // as `google-generative-ai`. Casting it straight to `WireProtocol`
+        // let an unimplementable protocol enter as `builtin`, the most
+        // trustworthy source, and the model then failed only once a stream
+        // was attempted.
+        ...asWireProtocol(exact?.api) === void 0 ? {} : { builtin: asWireProtocol(exact?.api) },
         ...protocolOfNpm(metadata["provider"] === void 0 ? providerNpm : record(metadata["provider"])["npm"] ?? providerNpm) === void 0 ? {} : { online: protocolOfNpm(record(metadata["provider"])["npm"] ?? providerNpm) },
         ...override === void 0 ? {} : { override }
       });
@@ -511,6 +517,9 @@ function harnessApiKeyAuth() {
     }
   };
 }
+function unsupportedBuiltinApi(api) {
+  return api === void 0 || asWireProtocol(api) !== void 0 ? void 0 : api;
+}
 function buildProvider(baseURL, models) {
   return createProvider({
     id: PROVIDER_ID,
@@ -638,6 +647,11 @@ var OpencodeGoCatalog = class {
         unavailable.set(id, reason);
         continue;
       }
+      const unsupported = unsupportedBuiltinApi(builtin.get(id)?.api);
+      if (unsupported !== void 0) {
+        unavailable.set(id, `its wire protocol "${unsupported}" is not implemented by this plugin`);
+        continue;
+      }
       facts.set(id, this.withDocumentedProtocol(this.inferredFacts(id, builtin)));
     }
     if (unavailable.size > 0) {
@@ -675,14 +689,15 @@ var OpencodeGoCatalog = class {
   /** Facts for an id no source describes, from the ladder and the route defaults. */
   inferredFacts(id, builtin) {
     const exact = builtin.get(id);
-    const api = exact?.api ?? inferFamily(id);
+    const builtinApi = asWireProtocol(exact?.api);
+    const api = builtinApi ?? inferFamily(id);
     const contextWindow = exact !== void 0 ? exact.contextWindow : this.options.defaults.contextWindow;
     const maxTokens = exact !== void 0 ? exact.maxTokens : this.options.defaults.maxTokens;
     return {
       id,
       name: exact?.name ?? id,
       api,
-      protocolSource: exact === void 0 ? "inferred" : "builtin",
+      protocolSource: builtinApi === void 0 ? "inferred" : "builtin",
       contextWindow,
       maxInputTokens: void 0,
       maxTokens,
@@ -2083,7 +2098,7 @@ function createUpdateChecker(deps) {
 }
 
 // src/update/version.ts
-var PLUGIN_VERSION = true ? "0.1.34" : "0.0.0-dev";
+var PLUGIN_VERSION = true ? "0.1.35" : "0.0.0-dev";
 
 // src/update/service.ts
 import { TypertRemoteService as TypertRemoteService2 } from "@deepseek-ai/dsh-typert-protocol";

package/lib/types/catalog/index.js

@@ -29,6 +29,7 @@ import { fetchModelIds } from "./gateway.js";
 import { fetchGoDocument, GO_DOC_URLS } from "./go-doc.js";
 import { readBoundedJson } from "./json-response.js";
 import { readOnlineMetadata, toPiModel } from "./metadata.js";
+import { asWireProtocol } from "./protocol.js";
 export { PROVIDER_ID, DISPLAY_NAME, DEFAULT_BASE_URL, CONSOLE_BASE_URL } from "./constants.js";
 export { readModelIds, fetchModelIds } from "./gateway.js";
 export { readOnlineMetadata, toPiModel, modelBaseURL } from "./metadata.js";
@@ -59,6 +60,18 @@ function harnessApiKeyAuth() {
         },
     };
 }
+/**
+ * The installed catalog's protocol, when this plugin cannot serve it.
+ *
+ * `Model<Api>['api']` is pi-ai's wider union; this plugin mounts exactly the
+ * three in `WIRE_PROTOCOLS`. The check exists because the catalog is wider
+ * than the plugin and grows on its own release cadence.
+ * @param api - the raw `api` string the installed catalog states.
+ * @returns the unusable protocol, or undefined when there is nothing to refuse.
+ */
+function unsupportedBuiltinApi(api) {
+    return api === undefined || asWireProtocol(api) !== undefined ? undefined : api;
+}
 function buildProvider(baseURL, models) {
     return createProvider({
         id: PROVIDER_ID,
@@ -205,6 +218,18 @@ export class OpencodeGoCatalog {
                 unavailable.set(id, reason);
                 continue;
             }
+            // The installed catalog may name a protocol this plugin cannot mount.
+            // pi-ai 1.3.0 labels `gemini-4-argon-contributor` as
+            // `google-generative-ai`, which `buildProvider` has no entry for, and
+            // the string used to reach the model list through an unchecked cast.
+            // Listing it as usable would defer the failure to the first stream —
+            // the one outcome this plugin refuses to ship — so it is refused here,
+            // exactly like a malformed record.
+            const unsupported = unsupportedBuiltinApi(builtin.get(id)?.api);
+            if (unsupported !== undefined) {
+                unavailable.set(id, `its wire protocol "${unsupported}" is not implemented by this plugin`);
+                continue;
+            }
             // No source describes this id. The gateway's own provider default
             // (`@ai-sdk/openai-compatible`) makes Chat Completions the best available
             // guess, and the route defaults size it; the settings surface marks it as
@@ -245,14 +270,17 @@ export class OpencodeGoCatalog {
     /** Facts for an id no source describes, from the ladder and the route defaults. */
     inferredFacts(id, builtin) {
         const exact = builtin.get(id);
-        const api = exact?.api ?? inferFamily(id);
+        // Guarded for the same reason `assemble` refuses these ids up front: the
+        // installed catalog states protocols this plugin cannot mount.
+        const builtinApi = asWireProtocol(exact?.api);
+        const api = builtinApi ?? inferFamily(id);
         const contextWindow = exact !== undefined ? exact.contextWindow : this.options.defaults.contextWindow;
         const maxTokens = exact !== undefined ? exact.maxTokens : this.options.defaults.maxTokens;
         return {
             id,
             name: exact?.name ?? id,
             api,
-            protocolSource: exact === undefined ? 'inferred' : 'builtin',
+            protocolSource: builtinApi === undefined ? 'inferred' : 'builtin',
             contextWindow,
             maxInputTokens: undefined,
             maxTokens,

package/lib/types/catalog/metadata.js

@@ -188,7 +188,13 @@ export function readOnlineMetadata(body, sources) {
                 throw new Error(`configured protocol "${sources.overrides[id]}" is not one of anthropic-messages, openai-completions, openai-responses`);
             }
             const decision = decideProtocol(id, {
-                ...exact?.api === undefined ? {} : { builtin: exact.api },
+                // Guarded, not asserted: pi-ai's builtin catalog is wider than this
+                // plugin's three protocols — 1.3.0 labels `gemini-4-argon-contributor`
+                // as `google-generative-ai`. Casting it straight to `WireProtocol`
+                // let an unimplementable protocol enter as `builtin`, the most
+                // trustworthy source, and the model then failed only once a stream
+                // was attempted.
+                ...asWireProtocol(exact?.api) === undefined ? {} : { builtin: asWireProtocol(exact?.api) },
                 ...protocolOfNpm(metadata['provider'] === undefined ? providerNpm : record(metadata['provider'])['npm'] ?? providerNpm) === undefined
                     ? {}
                     : { online: protocolOfNpm(record(metadata['provider'])['npm'] ?? providerNpm) },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dan-ai-studio/dshopencodego",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "description": "OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage",
   "type": "module",
   "license": "MIT",
@@ -68,7 +68,7 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "~3.18.5-alpha.2",
-    "@earendil-works/pi-ai": "~1.0.2"
+    "@earendil-works/pi-ai": "~1.3.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "4.0.2 || 4.0.3 || 4.0.4 || 4.0.5-alpha.1 || 4.0.5-alpha.2",