@goodandready/dsh-opencode-provider 0.5.24 → 0.5.25

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.25 — release 2: stale data
+
+- **#87 — stale usage**: a failed usage refresh now returns the last successful report with `stale: true` and `lastSuccessAt` instead of discarding it. The quota sidebar/panel and Settings label the stale snapshot; an explicit refresh no longer loses the previous reading.
+- **#88 — stale analytics**: a failed analytics rescan keeps the previous report and heatmap visible with a stale notice and a retry button instead of blanking the panel; successful rescans clear the stale flag.
+- 127 tests.
+
 ## 0.5.24 — release 1: account safety
 
 - **#89 — managed credential cleanup**: keys saved through Settings or imported from `auth.json` are recorded in `~/.dsh/storages/dsh-opencode/managed-credentials.json` (refs only, never secrets). Removing an account asks for confirmation and deletes only plugin-managed credentials after the settings save succeeds; external environment/`auth.json` references are left intact. Cleanup failures are reported separately from the account removal.

package/README.md

@@ -132,12 +132,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.24.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.25.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.24.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.25.tgz
 
 # Or install the published package:
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.24
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.25
 ```
 
 Restart dsh (or DSH Desktop), then pick **OpenCode (plugin)** or **OpenCode Go (plugin)** in the model picker.

package/README.ru.md

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

package/README.zh.md

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

package/lib/client.js

@@ -96,6 +96,7 @@ window.__ModuleLoader__.load({
 				runwaySafe: "safe",
 				noUsage: "Quota is unavailable.",
 				usageError: "Quota error",
+				usageStale: "Showing the last successful quota reading; the latest refresh failed.",
 				refresh: "Refresh",
 				refreshed: "Refreshed",
 				loading: "Loading…",
@@ -144,6 +145,7 @@ window.__ModuleLoader__.load({
 				heatmapAllAccounts: "All accounts",
 				analyticsHint: "Aggregated from local session metadata by last activity. A session that switched models is counted under its last model; failures are not exposed by the projection. Only plugin routes are counted; legacy opencode sessions belong to the built-in catalog.",
 				analyticsPartial: "This report is partial: the projection scan hit its file limit or skipped unreadable files.",
+				analyticsStale: "Showing the previous successful scan; the latest refresh failed.",
 				analyticsEmpty: "No plugin sessions in this window. Legacy opencode sessions belong to the built-in catalog.",
 				showAll: "Show all",
 				modelSearch: "Search models…",
@@ -314,6 +316,7 @@ window.__ModuleLoader__.load({
 				runwaySafe: "安全",
 				noUsage: "配额不可用。",
 				usageError: "配额错误",
+				usageStale: "显示上次成功读取的配额；最新刷新失败。",
 				refresh: "刷新",
 				refreshed: "已刷新",
 				loading: "加载中…",
@@ -362,6 +365,7 @@ window.__ModuleLoader__.load({
 				heatmapAllAccounts: "全部账户",
 				analyticsHint: "按最后活动时间聚合本地会话元数据。切换过模型的会话计入最后使用的模型；本地投影不暴露失败。仅统计插件路由；旧 opencode 会话属于内置目录。",
 				analyticsPartial: "此报告不完整：投影扫描达到文件上限或跳过了不可读文件。",
+				analyticsStale: "显示上次成功扫描的结果；最新刷新失败。",
 				analyticsEmpty: "此窗口内没有插件会话。旧 opencode 会话属于内置目录。",
 				showAll: "显示全部",
 				modelSearch: "搜索模型…",
@@ -1016,6 +1020,10 @@ window.__ModuleLoader__.load({
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "oc-bars",
 				children: [
+					usage.stale === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+						className: "oc-hint",
+						children: [t("usageStale"), usage.lastSuccessAt === void 0 ? "" : ` (${new Date(usage.lastSuccessAt).toLocaleTimeString()})`]
+					}) : null,
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Row, {
 						label: t("fiveHour"),
 						window: windows.fiveHour
@@ -1344,6 +1352,7 @@ window.__ModuleLoader__.load({
 			const [stateError, setStateError] = (0, react.useState)(null);
 			const [analytics, setAnalytics] = (0, react.useState)(null);
 			const [analyticsError, setAnalyticsError] = (0, react.useState)(null);
+			const [analyticsStale, setAnalyticsStale] = (0, react.useState)(false);
 			const [days, setDays] = (0, react.useState)(7);
 			const [busy, setBusy] = (0, react.useState)(false);
 			const analyticsSeq = (0, react.useRef)(0);
@@ -1359,14 +1368,16 @@ window.__ModuleLoader__.load({
 				const seq = analyticsSeq.current + 1;
 				analyticsSeq.current = seq;
 				setAnalyticsError(null);
+				setAnalyticsStale(analytics !== null);
 				fetchAnalytics(windowDays).then((next) => {
 					if (seq !== analyticsSeq.current) return;
 					setAnalytics(next);
 					setAnalyticsError(null);
+					setAnalyticsStale(false);
 				}).catch((caught) => {
 					if (seq !== analyticsSeq.current) return;
-					setAnalytics(null);
 					setAnalyticsError(caught instanceof Error ? caught.message : "analytics failed");
+					setAnalyticsStale(analytics !== null);
 				});
 			};
 			(0, react.useEffect)(() => {
@@ -1583,59 +1594,69 @@ window.__ModuleLoader__.load({
 							children: t("intro")
 						})]
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("section", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 						className: "oc-card",
-						children: analyticsError !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+						children: [
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 								className: "oc-card-title",
 								children: t("usageAnalytics")
 							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+							analyticsError !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 								className: "oc-hint",
 								children: [
 									t("failed"),
 									": ",
 									analyticsError
 								]
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							}) : null,
+							analyticsStale && analytics !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("analyticsStale")
+							}) : null,
+							analyticsError !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: "oc-button",
 								onClick: () => loadAnalytics(days),
 								children: t("refresh")
+							}) : null,
+							analytics === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("loading")
+							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UsageAnalyticsView, {
+								analytics,
+								t,
+								days,
+								onDays: setDays
 							})
-						] }) : analytics === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
-							className: "oc-card-title",
-							children: t("usageAnalytics")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-							className: "oc-hint",
-							children: t("loading")
-						})] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UsageAnalyticsView, {
-							analytics,
-							t,
-							days,
-							onDays: setDays
-						})
+						]
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 						className: "oc-card",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
-							className: "oc-card-title",
-							children: t("requestHeatmap")
-						}), analyticsError !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
-							className: "oc-hint",
-							children: [
-								t("failed"),
-								": ",
-								analyticsError
-							]
-						}) : analytics === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-							className: "oc-hint",
-							children: t("loading")
-						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RequestHeatmapView, {
-							heatmap: analytics.heatmap,
-							t
-						})]
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+								className: "oc-card-title",
+								children: t("requestHeatmap")
+							}),
+							analyticsError !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+								className: "oc-hint",
+								children: [
+									t("failed"),
+									": ",
+									analyticsError
+								]
+							}) : null,
+							analyticsStale && analytics !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("analyticsStale")
+							}) : null,
+							analytics === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("loading")
+							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RequestHeatmapView, {
+								heatmap: analytics.heatmap,
+								t
+							})
+						]
 					})
 				]
 			});
@@ -2334,6 +2355,10 @@ window.__ModuleLoader__.load({
 									]
 								});
 							})(),
+							defaultAccount?.usage?.stale === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("usageStale")
+							}) : null,
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "oc-row",
 								children: [
@@ -2435,8 +2460,8 @@ window.__ModuleLoader__.load({
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("h3", {
 								className: "oc-card-title",
 								children: [t("serviceStatus"), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: `oc-badge ${state.service.usageCheckedAt === void 0 ? "oc-badge-warn" : state.service.usageError === void 0 ? "oc-badge-ok" : "oc-badge-bad"}`,
-									children: state.service.usageCheckedAt === void 0 ? t("notChecked") : state.service.usageError === void 0 ? t("serviceOk") : t("serviceDegraded")
+									className: `oc-badge ${state.service.usageCheckedAt === void 0 ? "oc-badge-warn" : state.service.usageError === void 0 && state.service.usageStale !== true ? "oc-badge-ok" : "oc-badge-bad"}`,
+									children: state.service.usageCheckedAt === void 0 ? t("notChecked") : state.service.usageError === void 0 && state.service.usageStale !== true ? t("serviceOk") : t("serviceDegraded")
 								})]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -2447,7 +2472,7 @@ window.__ModuleLoader__.load({
 										children: t("usageEndpoint")
 									}),
 									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: `oc-badge ${state.service.usageCheckedAt === void 0 ? "oc-badge-warn" : state.service.usageError === void 0 ? "oc-badge-ok" : "oc-badge-bad"}`,
+										className: `oc-badge ${state.service.usageCheckedAt === void 0 ? "oc-badge-warn" : state.service.usageError === void 0 && state.service.usageStale !== true ? "oc-badge-ok" : "oc-badge-bad"}`,
 										children: state.service.usageCheckedAt === void 0 ? t("notChecked") : t("checkedAt").replace("{time}", new Date(state.service.usageCheckedAt).toLocaleTimeString())
 									}),
 									state.service.usageLatencyMs === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -2460,6 +2485,10 @@ window.__ModuleLoader__.load({
 								className: "oc-hint",
 								children: state.service.usageError
 							}),
+							state.service.usageStale === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("usageStale")
+							}) : null,
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "oc-row",
 								children: [
@@ -2641,6 +2670,10 @@ window.__ModuleLoader__.load({
 												known.usage.error
 											]
 										}),
+										known?.usage?.stale === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "oc-hint",
+											children: t("usageStale")
+										}) : null,
 										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 											className: "oc-row",
 											children: [

package/lib/index.d.ts

@@ -263,6 +263,9 @@ interface UsageResult {
   readonly keyStatus?: UsageKeyStatus;
   readonly latencyMs?: number;
   readonly checkedAt: number;
+  /** True when `report` is the last successful reading after a failed refresh. */
+  readonly stale?: boolean;
+  readonly lastSuccessAt?: number;
 }
 interface UsageWindowPayload {
   status?: string;

package/lib/index.js

@@ -81,7 +81,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.24";
+const DEFAULT_USER_AGENT = "dsh-opencode-provider/0.5.25";
 const DEFAULT_CONTEXT_WINDOW = 262144;
 const DEFAULT_MAX_TOKENS = 32768;
 const DEFAULT_GENERATE_MAX_TOKENS = 32768;
@@ -5033,7 +5033,8 @@ async function buildState(ctx, deps) {
 		service: {
 			...usage?.checkedAt === void 0 ? {} : { usageCheckedAt: usage.checkedAt },
 			...usage?.latencyMs === void 0 ? {} : { usageLatencyMs: usage.latencyMs },
-			...usage?.error === void 0 ? {} : { usageError: usage.error }
+			...usage?.error === void 0 ? {} : { usageError: usage.error },
+			...usage?.stale === true ? { usageStale: true } : {}
 		},
 		routing: deps.adapter.routingTrace(),
 		auth: {
@@ -5618,6 +5619,8 @@ function fingerprint(key) {
 /** Cached reader for the (undocumented) Go usage endpoint. Fail-open by design. */
 function createUsageReader(config, resolveKey, fetchImpl = fetch) {
 	const cache = /* @__PURE__ */ new Map();
+	/** Last successful reading per key, kept across explicit cache clears. */
+	const lastSuccess = /* @__PURE__ */ new Map();
 	const read = async (provider, explicitKey) => {
 		if (provider !== "opencode-go-direct" && provider !== "opencode-go") return void 0;
 		const current = config();
@@ -5635,7 +5638,7 @@ function createUsageReader(config, resolveKey, fetchImpl = fetch) {
 		const cacheKey = `${provider}:${fingerprint(key)}`;
 		const cached = cache.get(cacheKey);
 		if (cached !== void 0) {
-			const ttl = cached.report === void 0 ? FAILURE_TTL_MS : SUCCESS_TTL_MS;
+			const ttl = cached.report === void 0 || cached.stale === true ? FAILURE_TTL_MS : SUCCESS_TTL_MS;
 			if (Date.now() - cached.checkedAt < ttl) return cached;
 		}
 		const result = async () => {
@@ -5693,8 +5696,25 @@ function createUsageReader(config, resolveKey, fetchImpl = fetch) {
 			}
 		};
 		const fresh = await result();
-		cache.set(cacheKey, fresh);
-		return fresh;
+		const previous = cached?.report !== void 0 ? cached : lastSuccess.get(cacheKey);
+		if (fresh.report === void 0 && previous?.report !== void 0) {
+			const stale = {
+				...fresh,
+				report: previous.report,
+				stale: true,
+				lastSuccessAt: previous.lastSuccessAt ?? previous.checkedAt
+			};
+			cache.set(cacheKey, stale);
+			return stale;
+		}
+		const next = fresh.report === void 0 ? fresh : {
+			...fresh,
+			stale: false,
+			lastSuccessAt: fresh.checkedAt
+		};
+		if (next.report !== void 0) lastSuccess.set(cacheKey, next);
+		cache.set(cacheKey, next);
+		return next;
 	};
 	read.clear = () => {
 		cache.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-opencode-provider",
-  "version": "0.5.24",
+  "version": "0.5.25",
   "description": "OpenCode / OpenCode Go LLM provider plugin for DeepSeek Harness (dsh).",
   "license": "MIT",
   "type": "module",