@dan-ai-studio/dshopencodego 0.1.38 → 0.1.39

package/README.en.md

@@ -128,13 +128,23 @@ A model that does not accept image input is rejected before the request is sent
 
 Four evidence levels decide how a model is called, first hit wins:
 
-1. **The installed pi-ai catalog entry** — protocol plus wire quirks (DeepSeek's `thinkingFormat`, for example).
+1. **The pi-ai catalog entry** — protocol plus wire quirks (DeepSeek's `thinkingFormat`, for example). This catalog is **compiled into the bundle**, so it only moves when the plugin is released.
 2. **models.dev's per-model `provider.npm`** — `@ai-sdk/openai` → Responses, `@ai-sdk/anthropic` → Messages, absent → Chat Completions.
 3. **Family rule** — `grok*`/`gpt*`/`muse-*` → Responses, everything else → Chat Completions.
 4. **`modelProtocols` override** — always wins.
 
 The gateway's `/v1/models` answers only *which* models exist, never *how* to call them. Inferred decisions are labelled in the settings page; override them with `modelProtocols`.
 
+## A common question: does the provider adding or retiring a model need a plugin release?
+
+**No — the model list is live.** The gateway's `/v1/models` is the only source of membership, and every catalog refresh (a 60-minute cache by default, or the Recheck button) takes it as the truth:
+
+- a model the provider **adds** appears on the next refresh; if no metadata source describes it, it is labelled as inferred and can be pinned with `modelProtocols`;
+- a model the provider **retires** disappears on the next refresh;
+- the bundled catalog is **frozen at the plugin's version** and affects only the quality of the "how to call it" decision, never *which* models exist.
+
+The only thing that waits on a plugin release is a missing wire quirk in the pi-ai catalog (DeepSeek's `thinkingFormat`, say) — the model itself is already usable.
+
 ## The model list in the settings page
 
 The "OpenCode Go" section shows the live gateway catalog (the count follows the gateway) with, per model:

package/README.md

@@ -128,13 +128,23 @@ API Key 通过 Harness 凭证库提供（引用名 `OPENCODE_GO_API_KEY`），
 
 一个模型"怎么调"由四级证据决定，先命中先赢：
 
-1. **内置 pi-ai 目录的精确条目**——给出协议与线怪癖（如 DeepSeek 的 `thinkingFormat`）。
+1. **pi-ai 内置目录的精确条目**——给出协议与线怪癖（如 DeepSeek 的 `thinkingFormat`）。该目录**编译进插件产物**，版本随插件发版更新，不会在运行时自行变化。
 2. **models.dev 的每模型 `provider.npm`**——`@ai-sdk/openai` → Responses，`@ai-sdk/anthropic` → Messages，缺省 → Chat Completions。
 3. **家族规则**——`grok*`/`gpt*`/`muse-*` → Responses，其余 → Chat Completions。
 4. **`modelProtocols` 覆盖**——永远最高优先。
 
 网关的 `/v1/models` 只回答"有哪些模型"，不回答"怎么调"。被推断出来的模型会在设置页标注，判错时用 `modelProtocols` 覆盖即可。
 
+## 一个常见疑问：官方增删模型后，需要等插件发版吗？
+
+**不需要——模型列表是实时的。** 网关 `/v1/models` 是成员资格的唯一来源，每次刷新目录（默认 60 分钟缓存，或点「重新检查」）都会以它为准：
+
+- 官方**新增**模型 → 下次刷新即出现，协议/容量若不在内置目录中则标为"推断"并可被 `modelProtocols` 覆盖；
+- 官方**下线**模型 → 下次刷新即消失；
+- 内置目录**冻结**在插件版本里，仅影响"怎么调"的推断质量，不影响"有哪些"。
+
+只有当 pi-ai 内置目录**缺了某个模型的线怪癖**（如 DeepSeek 的 `thinkingFormat`）时，才需要等插件同步 pi-ai 的新版本——而模型本身早已可用。
+
 ## 设置页里的模型列表
 
 设置页的「OpenCode Go」分区展示网关实时目录（数量随网关发布变化），并对每个模型给出：

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

package/lib/index.js

@@ -45505,7 +45505,7 @@ function createUpdateChecker(deps) {
 }
 
 // src/update/version.ts
-var PLUGIN_VERSION = true ? "0.1.38" : "0.0.0-dev";
+var PLUGIN_VERSION = true ? "0.1.39" : "0.0.0-dev";
 
 // src/update/service.ts
 import { TypertRemoteService as TypertRemoteService2 } from "@deepseek-ai/dsh-typert-protocol";

package/lib/types/catalog/go-doc.d.ts

@@ -22,8 +22,6 @@ import type { WireProtocol } from './protocol.ts';
  * same path and is tried when GitHub itself is unreachable.
  */
 export declare const GO_DOC_URLS: readonly string[];
-/** The document is about 30 KB; the cap leaves room without inviting a flood. */
-export declare const GO_DOC_MAX_BYTES: number;
 /** What one parse of the document yields. */
 export interface GoDoc {
     /** Per-model allowances, keyed by the gateway's model id. */

package/lib/types/catalog/go-doc.js

@@ -27,7 +27,7 @@ export const GO_DOC_URLS = [
     'https://cdn.jsdelivr.net/gh/anomalyco/opencode@dev/packages/web/src/content/docs/go.mdx',
 ];
 /** The document is about 30 KB; the cap leaves room without inviting a flood. */
-export const GO_DOC_MAX_BYTES = 1024 * 1024;
+const GO_DOC_MAX_BYTES = 1024 * 1024;
 /** The protocol each documented endpoint path names. */
 const ENDPOINT_PROTOCOLS = {
     '/chat/completions': 'openai-completions',

package/lib/types/catalog/index.d.ts

@@ -50,7 +50,7 @@ export interface CatalogSnapshot {
     readonly fetchedAtMs: number;
 }
 /** Observers the plugin logs through. */
-export interface CatalogObservers {
+interface CatalogObservers {
     /** One source fell back to retained data. */
     readonly onFallback?: (detail: {
         url: string;

package/lib/types/catalog/metadata.d.ts

@@ -64,7 +64,7 @@ export interface ModelDefaults {
 /** The base URL one protocol's SDK expects for this gateway. */
 export declare function modelBaseURL(api: WireProtocol, baseURL: string): string;
 /** Inputs the ladder needs beyond the document itself. */
-export interface MetadataSources {
+interface MetadataSources {
     /** Installed catalog entries by id, the first level of the ladder. */
     readonly builtin: ReadonlyMap<string, Model<Api>>;
     /** Route defaults for a model no source sizes. */
@@ -83,3 +83,4 @@ export interface MetadataSources {
 export declare function readOnlineMetadata(body: unknown, sources: MetadataSources): OnlineMetadata;
 /** Project one parsed model into the shape pi-ai's providers consume. */
 export declare function toPiModel(facts: ModelFacts, baseURL: string): Model<Api>;
+export {};

package/lib/types/catalog/protocol.d.ts

@@ -49,7 +49,7 @@ export declare function inferProtocol(id: string): WireProtocol;
 /** Narrow an arbitrary configured string to a protocol this plugin can drive. */
 export declare function asWireProtocol(value: string | undefined): WireProtocol | undefined;
 /** One model's evidence, as gathered from the three automatic sources. */
-export interface ProtocolEvidence {
+interface ProtocolEvidence {
     /** Protocol the installed pi-ai catalog declares for this exact id. */
     readonly builtin?: WireProtocol;
     /** Protocol models.dev names for this model, or its provider-level default. */
@@ -68,3 +68,4 @@ export interface ProtocolEvidence {
 export declare function decideProtocol(id: string, evidence: ProtocolEvidence): ProtocolDecision | undefined;
 /** The pi-ai API string for one wire protocol. */
 export declare function piApiOf(api: WireProtocol): Api;
+export {};

package/lib/types/catalog/service.d.ts

@@ -12,7 +12,7 @@ import { RemoteError, TypertRemoteService } from '@deepseek-ai/dsh-typert-protoc
 import type { OpencodeGoCatalog } from './index.ts';
 import type { CatalogReading } from './reading.ts';
 /** Host inputs for the catalog service. */
-export interface CatalogServiceOptions {
+interface CatalogServiceOptions {
     /** The route's current catalog resolver. */
     readonly catalog: () => OpencodeGoCatalog;
     /** Current per-model visibility switches. */
@@ -30,3 +30,4 @@ export declare class OpencodeGoCatalogService extends TypertRemoteService {
 }
 /** The domain failure the settings page renders when a refresh cannot run. */
 export declare function catalogFailure(error: unknown): RemoteError;
+export {};

package/lib/types/config.d.ts

@@ -17,20 +17,12 @@ import z from '@deepseek-ai/schemastery';
 export declare const DEFAULT_API_KEY_ENV = "OPENCODE_GO_API_KEY";
 /** Requests and pickers share this cache lifetime; explicit discovery revalidates immediately. */
 export declare const DEFAULT_REFRESH_MINUTES = 60;
-/** Default maximum idle interval while one stream read is outstanding. */
-export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
-/** Request-level bound on the base64-encoded image payload. */
-export declare const DEFAULT_MAX_REQUEST_IMAGE_BYTES: number;
-/** Total-pixel budget for one request image. */
-export declare const DEFAULT_REQUEST_IMAGE_PIXEL_BUDGET = 1440000;
-/** Raw encoded-byte target for one request image before base64 expansion. */
-export declare const DEFAULT_REQUEST_IMAGE_MAX_BYTES = 400000;
 /**
  * One model's configured capacities. Every field is optional so a deployment
  * overrides only the value it needs; `null` explicitly selects the catalog
  * value even when a lower layer supplies an override.
  */
-export interface OpencodeGoModelLimit {
+interface OpencodeGoModelLimit {
     /** Context window in tokens, overriding what the catalog advertised. */
     contextWindow?: number | null;
     /** Output cap per request, overriding what the catalog advertised. */
@@ -107,3 +99,4 @@ export declare function readConfig(config: LiveConfig): OpencodeGoConfig;
  * @returns the normalized base URL without trailing slashes.
  */
 export declare function assertBaseURL(raw: string): string;
+export {};

package/lib/types/config.js

@@ -20,13 +20,13 @@ export const DEFAULT_API_KEY_ENV = 'OPENCODE_GO_API_KEY';
 /** Requests and pickers share this cache lifetime; explicit discovery revalidates immediately. */
 export const DEFAULT_REFRESH_MINUTES = 60;
 /** Default maximum idle interval while one stream read is outstanding. */
-export const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300_000;
+const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300_000;
 /** Request-level bound on the base64-encoded image payload. */
-export const DEFAULT_MAX_REQUEST_IMAGE_BYTES = 6 * 1024 * 1024;
+const DEFAULT_MAX_REQUEST_IMAGE_BYTES = 6 * 1024 * 1024;
 /** Total-pixel budget for one request image. */
-export const DEFAULT_REQUEST_IMAGE_PIXEL_BUDGET = 1_440_000;
+const DEFAULT_REQUEST_IMAGE_PIXEL_BUDGET = 1_440_000;
 /** Raw encoded-byte target for one request image before base64 expansion. */
-export const DEFAULT_REQUEST_IMAGE_MAX_BYTES = 400_000;
+const DEFAULT_REQUEST_IMAGE_MAX_BYTES = 400_000;
 const fields = {
     enabled: z.boolean().default(true),
     modelVisibility: z.dict(z.boolean().required()).default({}),

package/lib/types/models.d.ts

@@ -87,8 +87,6 @@ export declare function recommendedIds(models: readonly Pick<ModelSummary, 'id'
 export declare function isModelEnabled(model: Pick<ModelSummary, 'id' | 'deprecated' | 'configurationMissing' | 'recommended'>, visibility?: Readonly<Record<string, boolean>>): boolean;
 /** A calendar date as models.dev states it, without a timezone. */
 export declare function validReleaseDate(value: unknown): value is string;
-/** Whether a model shipped within the last week. */
-export declare function isNewModel(model: ModelSummary, now?: number): boolean;
 /**
  * Order models for display: newly shipped first, then the rest, then deprecated.
  * Newest releases come first within the first group.

package/lib/types/models.js

@@ -69,7 +69,7 @@ export function validReleaseDate(value) {
         && Number.isFinite(Date.parse(value)) && new Date(value).toISOString().slice(0, 10) === value;
 }
 /** Whether a model shipped within the last week. */
-export function isNewModel(model, now = Date.now()) {
+function isNewModel(model, now = Date.now()) {
     if (model.deprecated === true || !validReleaseDate(model.releaseDate))
         return false;
     const days = Math.floor(now / 86_400_000) - Date.parse(model.releaseDate) / 86_400_000;

package/lib/types/update/check.d.ts

@@ -61,7 +61,7 @@ export declare function isUpdateAvailable(current: string, latest: string | unde
 /** Read the `version` field out of a registry `latest` document. */
 export declare function parseLatestVersion(body: unknown): string | undefined;
 /** Dependencies the check needs, injectable for tests. */
-export interface UpdateCheckDeps {
+interface UpdateCheckDeps {
     /** Running build's version (build-time constant in production). */
     readonly currentVersion: string;
     /** Fetch implementation; defaults to the global one. */

package/lib/types/usage/windows.d.ts

@@ -32,7 +32,7 @@ export interface GoUsageWindows {
  */
 export declare function parseGoUsage(value: unknown): Omit<GoUsageWindows, 'source'>;
 /** Inputs one usage read needs. */
-export interface UsageReadOptions {
+interface UsageReadOptions {
     /** Normalized gateway base URL. */
     readonly baseURL: string;
     /** Resolved credential; absence is reported as an unconfigured route. */
@@ -49,3 +49,4 @@ export interface UsageReadOptions {
  *   endpoint fails, or the body is not a usage document.
  */
 export declare function readUsageWindows(options: UsageReadOptions): Promise<GoUsageWindows>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dan-ai-studio/dshopencodego",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "description": "OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage",
   "type": "module",
   "license": "MIT",