@goodandready/dsh-opencode-provider 0.5.17 → 0.5.18

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.5.18
+
+- **Compatibility range**: `engines.dsh`, DSH peer ranges and `dsh.compatibility.dsh` now use `>=0.2.1-rc.2 <0.2.2-0`; `dshReleases` keeps the tested rc.2/rc.3/rc.4 records. Future `0.2.1` RCs are admitted automatically; the next minor remains excluded.
+- **Engine matrix**: added `test:engine` and `test:install`, which install the packed plugin into isolated web profiles for every `dshReleases` version, then boot the host and assert provider activation and a non-empty live catalog.
+- **Key status**: `/state` now reports `keyStatus` per account (`ok`, `expired`, `invalid`, `missing`, `unavailable`, `unchecked`); usage 401/403 bodies are classified as expired/invalid. Settings shows the badge and adds a per-account **Check key** action backed by the new `/dsh-opencode/accounts/check` route. A check only reads the usage endpoint and does not send a model request.
+- 104 tests.
+
 ## 0.5.17
 
 - **DSH 0.2.1-rc.4 compatibility**: added rc.4 to `engines.dsh`, peer ranges and `dsh.compatibility.dshReleases`; rc.2 and rc.3 remain supported. Development/typecheck dependencies moved to `@deepseek-ai/*@0.2.1-rc.4`.

package/README.md

@@ -130,12 +130,12 @@ npm pack
 Install the **packed tarball** into a profile:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.17.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.18.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.17.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.18.tgz
 
 # Or install the published package:
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.17
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.18
 ```
 
 Restart dsh (or DSH Desktop), then pick **OpenCode (plugin)** or **OpenCode Go (plugin)** in the model picker.

package/README.ru.md

@@ -129,12 +129,12 @@ npm pack
 Установка из **упакованного tarball**:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.17.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.18.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.17.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.18.tgz
 
 # Либо установка опубликованного пакета из npm:
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.17
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.18
 ```
 
 После установки перезапустите dsh (или DSH Desktop) и выберите **OpenCode (plugin)** или **OpenCode Go (plugin)** в списке моделей.

package/README.zh.md

@@ -124,12 +124,12 @@ npm pack
 通过**打包文件 (.tgz)**安装：
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.17.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.18.tgz
 # DSH 桌面端：
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.17.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.18.tgz
 
 # 或从 npm 安装已发布版本：
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.17
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.18
 ```
 
 安装完成后重启 dsh 或 DSH 桌面端，在模型选择器中选择 **OpenCode (plugin)** 或 **OpenCode Go (plugin)** 即可。

package/lib/client.js

@@ -17,6 +17,14 @@ window.__ModuleLoader__.load({
 				keyHint: "Paste a key from the OpenCode console, or import the key OpenCode already stored.",
 				keyConfigured: "Configured",
 				keyMissing: "Not configured",
+				keyStatusOk: "Key OK",
+				keyStatusExpired: "Key expired",
+				keyStatusInvalid: "Key rejected",
+				keyStatusMissing: "Key missing",
+				keyStatusUnavailable: "Key check failed",
+				keyStatusUnchecked: "Key unchecked",
+				checkKey: "Check key",
+				keyStatusHint: "A key check reads the usage endpoint; it does not send a model request.",
 				keySource: "Source",
 				keyWritable: "Writable",
 				pasteKey: "Paste a key",
@@ -202,6 +210,14 @@ window.__ModuleLoader__.load({
 				keyHint: "粘贴 OpenCode 控制台的密钥，或导入 OpenCode 已保存的密钥。",
 				keyConfigured: "已配置",
 				keyMissing: "未配置",
+				keyStatusOk: "密钥正常",
+				keyStatusExpired: "密钥已过期",
+				keyStatusInvalid: "密钥被拒绝",
+				keyStatusMissing: "缺少密钥",
+				keyStatusUnavailable: "检查失败",
+				keyStatusUnchecked: "未检查",
+				checkKey: "检查密钥",
+				keyStatusHint: "检查仅读取用量端点，不会发送模型请求。",
 				keySource: "来源",
 				keyWritable: "可写",
 				pasteKey: "粘贴密钥",
@@ -412,6 +428,12 @@ window.__ModuleLoader__.load({
 				body: "{}"
 			});
 		}
+		function checkAccount(label) {
+			return call("/dsh-opencode/accounts/check", {
+				method: "POST",
+				body: JSON.stringify({ label })
+			});
+		}
 		function saveConfig(patch) {
 			return call("/dsh-opencode/config", {
 				method: "POST",
@@ -1819,6 +1841,19 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/settings-page.tsx
+		function keyStatusLabel(status, t) {
+			if (status === "ok") return t("keyStatusOk");
+			if (status === "expired") return t("keyStatusExpired");
+			if (status === "invalid") return t("keyStatusInvalid");
+			if (status === "missing") return t("keyStatusMissing");
+			if (status === "unavailable") return t("keyStatusUnavailable");
+			return t("keyStatusUnchecked");
+		}
+		function keyStatusClass(status) {
+			if (status === "ok") return "oc-badge-ok";
+			if (status === "expired" || status === "invalid") return "oc-badge-bad";
+			return "oc-badge-warn";
+		}
 		function OpenCodeSettingsPage(props) {
 			const { t } = props;
 			const [state, setState] = (0, react.useState)(null);
@@ -1834,6 +1869,7 @@ window.__ModuleLoader__.load({
 			const [testing, setTesting] = (0, react.useState)(false);
 			const [testResult, setTestResult] = (0, react.useState)(null);
 			const [importing, setImporting] = (0, react.useState)(false);
+			const [checking, setChecking] = (0, react.useState)(null);
 			const load = (0, react.useCallback)(async () => {
 				setLoading(true);
 				try {
@@ -1875,6 +1911,18 @@ window.__ModuleLoader__.load({
 					setSaving(false);
 				}
 			};
+			const checkKey = async (label) => {
+				setChecking(label);
+				setError(null);
+				try {
+					await checkAccount(label);
+					await load();
+				} catch (caught) {
+					setError(caught instanceof Error ? caught.message : t("failed"));
+				} finally {
+					setChecking(null);
+				}
+			};
 			const refresh = async () => {
 				try {
 					const next = await refreshState();
@@ -2125,7 +2173,11 @@ window.__ModuleLoader__.load({
 											className: "oc-badge oc-badge-bad",
 											children: mark
 										});
-									})()
+									})(),
+									defaultAccount === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: `oc-badge ${keyStatusClass(defaultAccount.keyStatus)}`,
+										children: keyStatusLabel(defaultAccount.keyStatus, t)
+									})
 								]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
@@ -2310,6 +2362,10 @@ window.__ModuleLoader__.load({
 								className: "oc-hint",
 								children: t("accountsHint")
 							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("keyStatusHint")
+							}),
 							draft.accounts.map((account, index) => {
 								const known = state.accounts.find((row) => account.apiKeyEnv !== "" && row.ref === account.apiKeyEnv || account.label !== "" && row.label === account.label);
 								const configured = known?.configured === true;
@@ -2348,6 +2404,10 @@ window.__ModuleLoader__.load({
 													className: `oc-badge ${configured ? "oc-badge-ok" : "oc-badge-warn"}`,
 													children: configured ? t("keyConfigured") : t("keyMissing")
 												}),
+												known === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: `oc-badge ${keyStatusClass(known.keyStatus)}`,
+													children: keyStatusLabel(known.keyStatus, t)
+												}),
 												known === void 0 || known.mark === "" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 													className: "oc-badge oc-badge-bad",
 													children: accountMark(known, t)
@@ -2401,6 +2461,15 @@ window.__ModuleLoader__.load({
 													},
 													children: t("saveKey")
 												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+													type: "button",
+													className: "oc-button",
+													disabled: known === void 0 || checking === known.label,
+													onClick: () => {
+														if (known !== void 0) checkKey(known.label);
+													},
+													children: checking === known?.label ? t("loading") : t("checkKey")
+												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 													type: "button",
 													className: "oc-button",

package/lib/index.d.ts

@@ -242,9 +242,11 @@ interface UsageReport {
     readonly monthly?: UsageWindow;
   };
 }
+type UsageKeyStatus = 'ok' | 'invalid' | 'expired' | 'missing' | 'unavailable';
 interface UsageResult {
   readonly report?: UsageReport;
   readonly error?: string;
+  readonly keyStatus?: UsageKeyStatus;
   readonly checkedAt: number;
 }
 interface UsageWindowPayload {

package/lib/index.js

@@ -18,7 +18,7 @@ const DEFAULT_GO_API_BASE = "https://opencode.ai/inference/go";
 const DEFAULT_GO_ZEN_BASE = "https://opencode.ai/zen/go/v1";
 const DEFAULT_USAGE_URL = "https://opencode.ai/zen/go/v1/usage";
 const DEFAULT_AUTH_ENTRY = "opencode-go";
-const DEFAULT_USER_AGENT = "dsh-opencode-provider/0.5.17";
+const DEFAULT_USER_AGENT = "dsh-opencode-provider/0.5.18";
 const DEFAULT_CONTEXT_WINDOW = 262144;
 const DEFAULT_MAX_TOKENS = 32768;
 const DEFAULT_GENERATE_MAX_TOKENS = 32768;
@@ -4737,6 +4737,8 @@ async function buildState(ctx, deps) {
 			source = hit.source;
 		}
 		const health = hit === void 0 ? void 0 : deps.adapter.accountHealth(hit.key);
+		const usage = hit === void 0 ? null : usageByLabel.get(slot.label) ?? null;
+		const keyStatus = !configured ? "missing" : health?.reason === "invalid-credential" ? "invalid" : usage?.keyStatus ?? "unchecked";
 		accounts.push({
 			...slot,
 			configured,
@@ -4744,7 +4746,8 @@ async function buildState(ctx, deps) {
 			active: activeLabel === slot.label,
 			coolingUntil: health?.coolingUntil ?? 0,
 			mark: health?.reason ?? "",
-			usage: hit === void 0 ? null : usageByLabel.get(slot.label) ?? null
+			keyStatus,
+			usage
 		});
 	}
 	let models = [];
@@ -4972,6 +4975,28 @@ function applyRoutes(ctx, web, deps) {
 			json(res, 500, { error: error instanceof Error ? error.message : "refresh failed" });
 		}
 	});
+	route("/dsh-opencode/accounts/check", async (req, res) => {
+		if (!requirePost(req, res)) return;
+		try {
+			const body = await readJson(req);
+			const label = typeof body.label === "string" && body.label.trim() !== "" ? body.label.trim() : "default";
+			const hit = (await deps.pool.resolveAll(GO_PROVIDER).catch(() => [])).find((entry) => (entry.label ?? "default") === label);
+			if (hit === void 0) {
+				json(res, 404, { error: `account "${label}" is not configured` });
+				return;
+			}
+			deps.usage.clear();
+			const result = await deps.usage(GO_PROVIDER, hit.key);
+			const keyStatus = result?.keyStatus ?? "unchecked";
+			json(res, 200, {
+				ok: keyStatus === "ok",
+				keyStatus,
+				...result?.error === void 0 ? {} : { error: result.error }
+			});
+		} catch (error) {
+			json(res, 500, { error: error instanceof Error ? error.message : "account check failed" });
+		}
+	});
 	route("/dsh-opencode/models/refresh", async (req, res) => {
 		if (!requirePost(req, res)) return;
 		clearCatalogCache();
@@ -5324,6 +5349,7 @@ function createUsageReader(config, resolveKey, fetchImpl = fetch) {
 		} catch {
 			return {
 				error: "no credential",
+				keyStatus: "missing",
 				checkedAt: Date.now()
 			};
 		}
@@ -5355,21 +5381,28 @@ function createUsageReader(config, resolveKey, fetchImpl = fetch) {
 					await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
 				}
 				if (response === void 0) throw lastNetworkError ?? /* @__PURE__ */ new Error("usage request failed");
-				if (response.status === 401 || response.status === 403) return {
-					error: "usage endpoint rejected the key (inference may still work)",
-					checkedAt: Date.now()
-				};
+				if (response.status === 401 || response.status === 403) {
+					const body = await response.text().catch(() => "");
+					return {
+						error: "usage endpoint rejected the key (inference may still work)",
+						keyStatus: /expired/i.test(body) ? "expired" : "invalid",
+						checkedAt: Date.now()
+					};
+				}
 				if (!response.ok) return {
 					error: `usage endpoint returned HTTP ${response.status}`,
+					keyStatus: "unavailable",
 					checkedAt: Date.now()
 				};
 				return {
 					report: normalizeUsage(await response.json()),
+					keyStatus: "ok",
 					checkedAt: Date.now()
 				};
 			} catch (error) {
 				return {
 					error: error instanceof Error ? error.message : "usage request failed",
+					keyStatus: "unavailable",
 					checkedAt: Date.now()
 				};
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-opencode-provider",
-  "version": "0.5.17",
+  "version": "0.5.18",
   "description": "OpenCode / OpenCode Go LLM provider plugin for DeepSeek Harness (dsh).",
   "license": "MIT",
   "type": "module",
@@ -54,17 +54,16 @@
     },
     "compatibility": {
       "dshReleases": {
-        "0.2.0-rc.2": "compatible",
         "0.2.1-rc.2": "compatible",
         "0.2.1-rc.3": "compatible",
         "0.2.1-rc.4": "compatible"
       },
-      "dsh": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
+      "dsh": ">=0.2.1-rc.2 <0.2.2-0"
     }
   },
   "engines": {
     "node": ">=22",
-    "dsh": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
+    "dsh": ">=0.2.1-rc.2 <0.2.2-0"
   },
   "scripts": {
     "build": "tsdown",
@@ -72,6 +71,8 @@
     "typecheck": "tsc --noEmit",
     "test": "node --import tsx --test tests/core.test.ts tests/routes.test.ts tests/limits.test.ts tests/analytics.test.ts tests/adapter.test.ts tests/usage.test.ts tests/request-log.test.ts tests/account-rules.test.ts tests/commands.test.ts tests/tool-schema.test.ts tests/tui-settings.test.ts tests/plan-filter.test.ts tests/image-budget.test.ts tests/tools.test.ts tests/plugin-updater.test.ts tests/client-render.test.tsx",
     "check": "npm run typecheck && npm test && npm run build",
+    "test:engine": "node scripts/test-engines.mjs",
+    "test:install": "node scripts/test-engines.mjs --install-only",
     "release": "npm run check && npm pack",
     "sync:models": "node scripts/sync-models.mjs"
   },
@@ -84,19 +85,19 @@
     "llm-provider"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4 || ~4.0.5",
-    "@deepseek-ai/dsh-attachment": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-commands": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-credentials": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-launch-environment": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-settings": "0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/schemastery": "~3.18.4 || ~3.18.5",
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-attachment": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-client-locale": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-commands": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-credentials": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-launch-environment": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/dsh-settings": ">=0.2.1-rc.2 <0.2.2-0",
+    "@deepseek-ai/schemastery": "~3.18.5",
     "react": "^18.2.0"
   },
   "devDependencies": {