@goodandready/dsh-opencode-provider 0.5.3 → 0.5.4

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.4
+
+- **Sidebar settings**: the quota-card switch moved out of Connection into its own **Sidebar** section in Settings → OpenCode and into the TUI; saving now refreshes the sidebar card immediately instead of waiting for the 60-second poll.
+- 85 tests.
+
 ## 0.5.3
 
 - **Per-account runway**: the quota panel estimates time to exhaustion for each account from the 5-hour, weekly and monthly burn rate and flags the first window projected to run out before its reset. The estimate is intentionally approximate; only the current percentage and reset time are exposed by the usage endpoint.

package/README.md

@@ -123,12 +123,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.3.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.4.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.3.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.4.tgz
 
 # Or install the published package:
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.3
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.4
 ```
 
 Restart dsh (or DSH Desktop), then pick `OpenCode` or `OpenCode Go` in the model picker.
@@ -231,11 +231,12 @@ Open **Settings → OpenCode**:
 - **Quota** — 5-hour, weekly and monthly bars with reset dates, plus warning banners at 80% and 95%.
 - **Accounts** — add extra accounts by credential reference, set each account's key from the page, see whether it is configured, pin one, or return to automatic rotation. **Import all from auth.json** copies every OpenCode key into its own credential ref and adds an account for it; **Check all accounts** refreshes the per-account quota/health rows.
 - **Models** — search, refresh the live catalog, uncheck models to build an allowlist, override the wire transport per model, and see each model's input/output price plus its Go request estimate (`Go 34.7K/5h`). Hover the estimate for the full Go / Go Plus monthly allowance and 5h/week/month request counts; expand **Subscription limits** for a table of every model with both plans.
-- **Connection** — API bases, usage endpoint, timeouts, output cap, context override, sidebar-card switch. The OpenCode auth-entry field autocompletes from the keys present in `auth.json`.
+- **Connection** — API bases, usage endpoint, timeouts, output cap, context override. The OpenCode auth-entry field autocompletes from the keys present in `auth.json`.
+- **Sidebar** — show or hide the quota card. The card refreshes immediately after saving and otherwise every 60 seconds.
 - **Plugin update** — current/latest version, update badge, and **Update now**. It installs the exact registry version through the normal `dsh plugin add` path, blocks a second click while installing, and reports when DSH must be restarted.
 - **Routing** — sticky account per conversation and the free fallback model used after a Go quota error. The quota panel shows the last routing decisions with their reason.
 
-The sidebar quota card is **off by default**. Enable *Show the quota card in the sidebar* in the settings page; clicking the card opens the full quota panel, which also carries the **Usage by model** table (7/30/90-day window).
+The sidebar quota card is **off by default**. Enable *Show the quota card in the sidebar* under **Sidebar**; the card appears immediately after saving, and clicking it opens the full quota panel with the **Usage by model** table (7/30/90-day window).
 
 The Host serves `/dsh-opencode/state`, `/health`, `/analytics`, `/config`, `/key`, `/key/clear`, `/auth-import`, `/refresh`, `/models/refresh`, `/test` and `/update`. Writes require JSON, are refused for cross-origin requests, and are restricted to loopback (`127.0.0.1` / `::1`); reads stay same-origin. This keeps key and configuration writes off a LAN-exposed web server until the host's own auth token can be integrated.
 

package/README.ru.md

@@ -88,6 +88,7 @@ graph LR
   - Автоматический переход на следующий аккаунт при 401/403/429 или ответах о превышении квот (400/402/403/429).
   - Недействительный ключ охлаждается 24 часа, превышение квоты — 10 минут (или по заголовку `Retry-After`), rate limit — 60 секунд (или по `Retry-After`).
   - Если запрос уже начал стриминг, он не переключается посреди ответа; следующий запрос берёт следующий готовый ключ.
+- **Sidebar-карточка квот**: отдельный переключатель в разделе **Sidebar** (и в TUI); после сохранения карточка появляется/исчезает сразу, без ожидания 60-секундного polling.
 - **Квоты по каждому аккаунту**: отображение индивидуального расхода за 5 часов, неделю и месяц; активный аккаунт управляет сайдбаром и панелью.
 - **Runway по каждому аккаунту**: оценка времени до исчерпания по среднему темпу каждого окна; отмечается первое окно, которое закончится раньше сброса. Оценка приблизительная: API отдаёт только текущий процент и время сброса.
 - **Онбординг аккаунтов**: **Import all from auth.json** переносит все ключи OpenCode в отдельные credential ref и добавляет аккаунты; **Check all accounts** обновляет квоты и health по каждому аккаунту.
@@ -120,12 +121,12 @@ npm pack
 Установка из **упакованного tarball**:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.3.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.4.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.3.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.4.tgz
 
 # Либо установка опубликованного пакета из npm:
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.3
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.4
 ```
 
 После установки перезапустите dsh (или DSH Desktop) и выберите **OpenCode** или **OpenCode Go** в списке моделей.

package/README.zh.md

@@ -89,6 +89,7 @@ graph LR
   - 在生成流开始前，遇到 401/403/429 或配额用尽响应（400/402/403/429）自动重试下一个账户。
   - 无效密钥冷却 24 小时，超额冷却 10 分钟（或遵循 `Retry-After`），速率限制冷却 60 秒。
   - 正在流式传输中的请求不会被打断，下一个请求会自动使用下一个可用密钥。
+- **侧边栏配额卡片**：独立 **Sidebar** 开关（TUI 也可设置）；保存后立即显示/隐藏，无需等待 60 秒轮询。
 - **多账户额度与健康监控**：每行独立展示 5 小时、每周与每月使用情况，活跃账户驱动侧边栏与配额面板。
 - **每账户预计可用时长**：按各窗口的平均消耗速度估算耗尽时间，并标记在重置前最先耗尽的窗口；API 仅提供当前百分比与重置时间，因此为近似值。
 - **模型 ➔ 账户路由规则**：支持 Glob 通配符（如 `*free*`、`deepseek-*`）将模型优先绑定至特定账户，其他账户保留为备用。
@@ -117,12 +118,12 @@ npm pack
 通过**打包文件 (.tgz)**安装：
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.3.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.4.tgz
 # DSH 桌面端：
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.3.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.4.tgz
 
 # 或从 npm 安装已发布版本：
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.3
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.4
 ```
 
 安装完成后重启 dsh 或 DSH 桌面端，在模型选择器中选择 **OpenCode** 或 **OpenCode Go** 即可。

package/lib/client.js

@@ -151,7 +151,9 @@ window.__ModuleLoader__.load({
 				streamIdleTimeoutMs: "Stream idle timeout (ms)",
 				maxOutputTokens: "Output limit (empty = model default, 0 = omit)",
 				contextWindow: "Context override",
+				sidebar: "Sidebar",
 				showSidebarQuota: "Show the quota card in the sidebar",
+				showSidebarQuotaHint: "The card updates immediately after saving and otherwise every 60 seconds.",
 				routing: "Routing",
 				routingHint: "Recent account/model choices. No prompts or keys are recorded.",
 				routingEmpty: "No routing decisions yet.",
@@ -331,7 +333,9 @@ window.__ModuleLoader__.load({
 				streamIdleTimeoutMs: "流空闲超时（毫秒）",
 				maxOutputTokens: "输出上限（空 = 模型默认，0 = 省略）",
 				contextWindow: "上下文覆盖",
+				sidebar: "侧边栏",
 				showSidebarQuota: "在侧边栏显示配额卡片",
+				showSidebarQuotaHint: "保存后立即更新；其余时间每 60 秒更新一次。",
 				routing: "路由",
 				routingHint: "最近使用的账户/模型选择。不会记录提示词或密钥。",
 				routingEmpty: "尚无路由决策。",
@@ -454,6 +458,9 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/events.ts
+		const CONFIG_CHANGED_EVENT = "dsh-opencode-config-changed";
+		//#endregion
 		//#region src/client/heatmap.tsx
 		const DAYS = [
 			"Mon",
@@ -1014,9 +1021,14 @@ window.__ModuleLoader__.load({
 				};
 				load();
 				const timer = setInterval(load, intervalMs);
+				const onConfigChanged = () => {
+					load();
+				};
+				window.addEventListener(CONFIG_CHANGED_EVENT, onConfigChanged);
 				return () => {
 					cancelled = true;
 					clearInterval(timer);
+					window.removeEventListener(CONFIG_CHANGED_EVENT, onConfigChanged);
 				};
 			}, [intervalMs]);
 			return state;
@@ -1256,8 +1268,13 @@ window.__ModuleLoader__.load({
 				load();
 				loadAnalytics(days);
 				const timer = setInterval(load, 6e4);
+				const onConfigChanged = () => {
+					load();
+				};
+				window.addEventListener(CONFIG_CHANGED_EVENT, onConfigChanged);
 				return () => {
 					clearInterval(timer);
+					window.removeEventListener(CONFIG_CHANGED_EVENT, onConfigChanged);
 					analyticsSeq.current += 1;
 				};
 			}, [days]);
@@ -1803,6 +1820,7 @@ window.__ModuleLoader__.load({
 				setError(null);
 				try {
 					await saveConfig(patchOf(draft));
+					window.dispatchEvent(new CustomEvent(CONFIG_CHANGED_EVENT));
 					setNotice(t("saved"));
 					setState(null);
 					setDraft(null);
@@ -2657,78 +2675,84 @@ window.__ModuleLoader__.load({
 							})
 						]
 					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: "oc-card",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+							className: "oc-card-title",
+							children: t("advanced")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "oc-grid",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("apiKeyEnv"),
+									hint: t("apiKeyEnvHint"),
+									value: draft.apiKeyEnv,
+									onChange: (value) => update({ apiKeyEnv: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("openCodeAuthEntry"),
+									hint: t("openCodeAuthEntryHint"),
+									value: draft.openCodeAuthEntry,
+									onChange: (value) => update({ openCodeAuthEntry: value }),
+									list: "oc-auth-entries"
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("datalist", {
+									id: "oc-auth-entries",
+									children: state.auth.entries.map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", { value: entry }, entry))
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("apiBase"),
+									value: draft.apiBase,
+									onChange: (value) => update({ apiBase: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("goApiBase"),
+									value: draft.goApiBase,
+									onChange: (value) => update({ goApiBase: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("goZenBase"),
+									value: draft.goZenBase,
+									onChange: (value) => update({ goZenBase: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("usageUrl"),
+									value: draft.usageUrl,
+									onChange: (value) => update({ usageUrl: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("requestTimeoutMs"),
+									type: "number",
+									value: draft.requestTimeoutMs,
+									onChange: (value) => update({ requestTimeoutMs: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("streamIdleTimeoutMs"),
+									type: "number",
+									value: draft.streamIdleTimeoutMs,
+									onChange: (value) => update({ streamIdleTimeoutMs: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("maxOutputTokens"),
+									type: "number",
+									value: draft.maxOutputTokens,
+									onChange: (value) => update({ maxOutputTokens: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("contextWindow"),
+									type: "number",
+									value: draft.contextWindow,
+									onChange: (value) => update({ contextWindow: value })
+								})
+							]
+						})]
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 						className: "oc-card",
 						children: [
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 								className: "oc-card-title",
-								children: t("advanced")
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "oc-grid",
-								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("apiKeyEnv"),
-										hint: t("apiKeyEnvHint"),
-										value: draft.apiKeyEnv,
-										onChange: (value) => update({ apiKeyEnv: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("openCodeAuthEntry"),
-										hint: t("openCodeAuthEntryHint"),
-										value: draft.openCodeAuthEntry,
-										onChange: (value) => update({ openCodeAuthEntry: value }),
-										list: "oc-auth-entries"
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("datalist", {
-										id: "oc-auth-entries",
-										children: state.auth.entries.map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", { value: entry }, entry))
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("apiBase"),
-										value: draft.apiBase,
-										onChange: (value) => update({ apiBase: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("goApiBase"),
-										value: draft.goApiBase,
-										onChange: (value) => update({ goApiBase: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("goZenBase"),
-										value: draft.goZenBase,
-										onChange: (value) => update({ goZenBase: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("usageUrl"),
-										value: draft.usageUrl,
-										onChange: (value) => update({ usageUrl: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("requestTimeoutMs"),
-										type: "number",
-										value: draft.requestTimeoutMs,
-										onChange: (value) => update({ requestTimeoutMs: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("streamIdleTimeoutMs"),
-										type: "number",
-										value: draft.streamIdleTimeoutMs,
-										onChange: (value) => update({ streamIdleTimeoutMs: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("maxOutputTokens"),
-										type: "number",
-										value: draft.maxOutputTokens,
-										onChange: (value) => update({ maxOutputTokens: value })
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("contextWindow"),
-										type: "number",
-										value: draft.contextWindow,
-										onChange: (value) => update({ contextWindow: value })
-									})
-								]
+								children: t("sidebar")
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
 								className: "oc-row",
@@ -2737,6 +2761,10 @@ window.__ModuleLoader__.load({
 									checked: draft.showSidebarQuota,
 									onChange: (event) => update({ showSidebarQuota: event.target.checked })
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("showSidebarQuota") })]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "oc-hint",
+								children: t("showSidebarQuotaHint")
 							})
 						]
 					}),

package/lib/index.js

@@ -17,7 +17,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.3";
+const DEFAULT_USER_AGENT = "dsh-opencode-provider/0.5.4";
 const DEFAULT_CONTEXT_WINDOW = 262144;
 const DEFAULT_MAX_TOKENS = 32768;
 const DEFAULT_GENERATE_MAX_TOKENS = 32768;
@@ -4871,6 +4871,10 @@ function buildOpenCodeTuiSection(deps) {
 			{
 				id: "advanced",
 				title: "Advanced"
+			},
+			{
+				id: "sidebar",
+				title: "Sidebar"
 			}
 		],
 		fields: [
@@ -4957,6 +4961,18 @@ function buildOpenCodeTuiSection(deps) {
 					value: text.trim() === "true"
 				})
 			},
+			{
+				path: ["showSidebarQuota"],
+				group: "sidebar",
+				kind: "boolean",
+				label: "Show quota card in sidebar",
+				hint: "Card visibility updates on the next sidebar refresh.",
+				format: (value) => String(value === void 0 ? deps.showSidebarQuota() : value === true),
+				parse: (text) => ({
+					kind: "set",
+					value: text.trim() === "true"
+				})
+			},
 			{
 				path: ["activeAccount"],
 				group: "advanced",
@@ -5028,7 +5044,8 @@ function applyOpenCodeTuiSettings(ctx, deps) {
 		activeAccount: deps.activeAccount(),
 		filterModelsByPlan: deps.filterModelsByPlan(),
 		quotaFallbackModel: deps.quotaFallbackModel(),
-		stickySession: deps.stickySession()
+		stickySession: deps.stickySession(),
+		showSidebarQuota: deps.showSidebarQuota()
 	});
 	let lastSignature = signature();
 	const refresh = () => {
@@ -5209,7 +5226,8 @@ function apply(ctx, config) {
 			activeAccount: () => current().activeAccount,
 			filterModelsByPlan: () => current().filterModelsByPlan,
 			quotaFallbackModel: () => current().quotaFallbackModel,
-			stickySession: () => current().stickySession
+			stickySession: () => current().stickySession,
+			showSidebarQuota: () => current().showSidebarQuota
 		});
 	});
 	ctx.inject(["webServer"], (webCtx) => {

package/package.json

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