@goodandready/dsh-ollama-cloud-provider 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.1.13 — 2026-10-29
+
+- Account cards now show per-account balance/remaining credits, purchased
+  amount, reset date and the time of the last usage read (or the 5-hour/weekly
+  bars for legacy accounts).
+- Added `npm run test:engine`: an isolated boot matrix that installs every
+  declared `dshReleases` core, composes the plugin, checks `--dump-config` and
+  waits for `/dsh-ollama/health` in a real web host. Supports
+  `--versions 0.2.1-rc.4` for a single release.
+
+## 0.1.12 — 2026-10-29
+
+- The sidebar quota card and panel now pause polling while the document is
+  hidden and refresh immediately when it becomes visible again.
+- Settings gained a **Service status** row: a local, keyless probe of the
+  public tag endpoint with latency, checked time and an error state. Ollama
+  Cloud has no public status page, so this row reports host-to-gateway
+  reachability only.
+- Error mapping now recognizes context-window overflow (using the harness
+  `CONTEXT_WINDOW_EXCEEDED_CODE`), model capability rejections for images/tools
+  and oversized request bodies, instead of returning a generic 400 message.
+
 ## 0.1.11 — 2026-10-29
 
 - Compatibility declarations now use the same-channel range

package/README.md

@@ -103,17 +103,17 @@ npm pack
 Install the published package:
 
 ```bash
-dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.11
+dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.13
 # DSH Desktop:
-dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.11
+dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.13
 ```
 
 Or install the packed tarball into a profile:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.11.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.13.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.11.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.13.tgz
 ```
 
 Restart dsh (or DSH Desktop), then pick **Ollama Cloud** in the model picker.
@@ -194,7 +194,7 @@ Open **Settings → Ollama Cloud**:
 - **Sidebar** — show or hide the quota card, and an optional plan label (for example `PRO`) shown next to the provider name.
 - **Plugin update** — current/latest version and **Update now**.
 
-The Host serves `/dsh-ollama/state`, `/health`, `/analytics`, `/usage`, `/balance`, `/config`, `/key`, `/key/clear`, `/refresh`, `/models/refresh`, `/test` and `/update`. Writes require JSON, an `Origin` or `Referer` matching `Host` (the Desktop renderer is identified by its `dsh-auth-*` cookie and desktop user agent when both headers are absent), and are restricted to loopback (`127.0.0.1` / `::1`); a write without any source identity is rejected with 403.
+The Host serves `/dsh-ollama/state`, `/health`, `/status`, `/analytics`, `/usage`, `/balance`, `/config`, `/key`, `/key/clear`, `/refresh`, `/models/refresh`, `/test` and `/update`. `/status` probes the public tag endpoint without a key or quota. Writes require JSON, an `Origin` or `Referer` matching `Host` (the Desktop renderer is identified by its `dsh-auth-*` cookie and desktop user agent when both headers are absent), and are restricted to loopback (`127.0.0.1` / `::1`); a write without any source identity is rejected with 403.
 
 ## Command
 

package/README.ru.md

@@ -103,17 +103,17 @@ npm pack
 Установка опубликованного пакета из npm:
 
 ```bash
-dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.11
+dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.13
 # DSH Desktop:
-dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.11
+dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.13
 ```
 
 Либо установка из упакованного tarball:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.11.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.13.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.11.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.13.tgz
 ```
 
 После установки перезапустите dsh (или DSH Desktop) и выберите **Ollama Cloud** в списке моделей.

package/README.zh.md

@@ -102,17 +102,17 @@ npm pack
 从 npm 安装已发布版本：
 
 ```bash
-dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.11
+dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.13
 # DSH 桌面端：
-dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.11
+dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.13
 ```
 
 或通过打包文件安装：
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.11.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.13.tgz
 # DSH 桌面端：
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.11.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.13.tgz
 ```
 
 安装完成后重启 dsh 或 DSH 桌面端，在模型列表中选择 **Ollama Cloud** 即可。

package/lib/client.js

@@ -49,6 +49,7 @@ window.__ModuleLoader__.load({
 				tokens: "Tokens",
 				spend7d: "7-day spend",
 				remaining: "remaining",
+				until: "until",
 				purchased: "Purchased",
 				range: "Range",
 				last24h: "Last 24 hours",
@@ -118,6 +119,13 @@ window.__ModuleLoader__.load({
 				maxOutputTokens: "Output limit (0 = provider default)",
 				contextWindow: "Context window override",
 				sidebar: "Sidebar",
+				serviceStatus: "Service status",
+				serviceStatusHint: "Checks the public Ollama Cloud tag endpoint without using your key or quota.",
+				serviceOnline: "Reachable",
+				serviceOffline: "Unreachable",
+				serviceUnknown: "Not checked",
+				refreshStatus: "Check now",
+				checkingService: "Checking…",
 				showSidebarQuota: "Show the quota card in the sidebar",
 				showSidebarQuotaHint: "The card appears above Settings and opens this panel.",
 				planLabel: "Plan label",
@@ -208,6 +216,7 @@ window.__ModuleLoader__.load({
 				tokens: "Token",
 				spend7d: "7 天费用",
 				remaining: "剩余",
+				until: "至",
 				purchased: "已购买",
 				range: "范围",
 				last24h: "最近 24 小时",
@@ -277,6 +286,13 @@ window.__ModuleLoader__.load({
 				maxOutputTokens: "输出上限（0 = 提供方默认）",
 				contextWindow: "上下文窗口覆盖",
 				sidebar: "侧边栏",
+				serviceStatus: "服务状态",
+				serviceStatusHint: "检查 Ollama Cloud 公共 tag 端点，不使用密钥或额度。",
+				serviceOnline: "可访问",
+				serviceOffline: "不可访问",
+				serviceUnknown: "未检查",
+				refreshStatus: "立即检查",
+				checkingService: "检查中…",
 				showSidebarQuota: "在侧边栏显示配额卡片",
 				showSidebarQuotaHint: "卡片显示在设置上方，点击可打开此面板。",
 				planLabel: "套餐标签",
@@ -401,6 +417,9 @@ window.__ModuleLoader__.load({
 		function fetchState() {
 			return call("/dsh-ollama/state");
 		}
+		function fetchServiceStatus() {
+			return call("/dsh-ollama/status");
+		}
 		function refreshState() {
 			return call("/dsh-ollama/refresh", {
 				method: "POST",
@@ -990,9 +1009,16 @@ window.__ModuleLoader__.load({
 			(0, react.useEffect)(() => {
 				load();
 				const timer = setInterval(() => {
-					load();
+					if (document.visibilityState !== "hidden") load();
 				}, intervalMs);
-				return () => clearInterval(timer);
+				const onVisibility = () => {
+					if (document.visibilityState !== "hidden") load();
+				};
+				document.addEventListener("visibilitychange", onVisibility);
+				return () => {
+					clearInterval(timer);
+					document.removeEventListener("visibilitychange", onVisibility);
+				};
 			}, [load, intervalMs]);
 			return {
 				state,
@@ -1672,6 +1698,9 @@ window.__ModuleLoader__.load({
 			const [testModel, setTestModel] = (0, react.useState)("gpt-oss:120b");
 			const [testing, setTesting] = (0, react.useState)(false);
 			const [testResult, setTestResult] = (0, react.useState)(null);
+			const [service, setService] = (0, react.useState)(null);
+			const [serviceBusy, setServiceBusy] = (0, react.useState)(false);
+			const [serviceError, setServiceError] = (0, react.useState)(null);
 			const load = (0, react.useCallback)(async () => {
 				setLoading(true);
 				try {
@@ -1733,6 +1762,20 @@ window.__ModuleLoader__.load({
 					setError(caught instanceof Error ? caught.message : t("failed"));
 				}
 			}, [t]);
+			const loadService = (0, react.useCallback)(async () => {
+				setServiceBusy(true);
+				try {
+					setService(await fetchServiceStatus());
+					setServiceError(null);
+				} catch (caught) {
+					setServiceError(caught instanceof Error ? caught.message : t("failed"));
+				} finally {
+					setServiceBusy(false);
+				}
+			}, [t]);
+			(0, react.useEffect)(() => {
+				loadService();
+			}, [loadService]);
 			if (loading && state === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "ocl-hint",
 				children: t("loading")
@@ -1906,6 +1949,47 @@ window.__ModuleLoader__.load({
 							})
 						]
 					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: "ocl-card",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+								className: "ocl-card-title",
+								children: t("serviceStatus")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "ocl-row ocl-statusRow",
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: `ocl-statusDot${service?.ok === true ? " ocl-statusDotOk" : service === null ? "" : " ocl-statusDotBad"}` }),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: service === null ? serviceBusy ? t("checkingService") : t("serviceUnknown") : service.ok ? t("serviceOnline") : t("serviceOffline") }),
+									service === null ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+										className: "ocl-hint",
+										children: [
+											service.latencyMs,
+											" ms · ",
+											new Date(service.checkedAt).toLocaleTimeString()
+										]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "ocl-button",
+										disabled: serviceBusy,
+										onClick: () => {
+											loadService();
+										},
+										children: serviceBusy ? t("checkingService") : t("refreshStatus")
+									})
+								]
+							}),
+							serviceError === null && service?.error === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "ocl-hint",
+								children: serviceError ?? service?.error
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "ocl-hint",
+								children: t("serviceStatusHint")
+							})
+						]
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 						className: "ocl-card",
 						children: [
@@ -2023,6 +2107,20 @@ window.__ModuleLoader__.load({
 												})
 											]
 										}),
+										known?.usage?.report === void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "ocl-hint",
+											children: t("noUsage")
+										}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: "ocl-accountUsage",
+											children: [quotaBars(known.usage.report).map((bar) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+												className: "ocl-badge",
+												title: bar.detail,
+												children: [bar.detail ?? `${bar.label}: ${bar.remainingPercent.toFixed(0)}% ${t("remaining")}`, bar.resetsAt === void 0 ? "" : ` · ${t("until")} ${new Date(bar.resetsAt).toLocaleDateString()}`]
+											}, bar.key)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "ocl-hint",
+												children: new Date(known.usage.checkedAt).toLocaleTimeString()
+											})]
+										}),
 										known?.usage?.report?.windows.d7 === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 											className: "ocl-row",
 											children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
@@ -2571,6 +2669,7 @@ window.__ModuleLoader__.load({
 .ocl-model-section .ocl-hint { margin: 0 0 4px; }
 .ocl-account { display: grid; grid-template-columns: minmax(0,1fr) minmax(0,1fr) auto; gap: 8px; align-items: center; }
 .ocl-account-block { display: flex; flex-direction: column; gap: 6px; padding: 9px; border: 1px solid var(--ocl-border-soft); border-radius: 8px; background: var(--ocl-fill); }
+.ocl-accountUsage { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; }
 .ocl-notice { font-size: 12px; padding: 7px 10px; border-radius: 7px; background: var(--ocl-accent-soft); border: 1px solid var(--ocl-accent-border); }
 .ocl-error { font-size: 12px; padding: 7px 10px; border-radius: 7px; background: var(--ocl-danger-soft); border: 1px solid var(--ocl-danger-border); color: var(--ocl-danger); }
 [class*="_footerActions"]:has(.ocl-foot), [class*="_footerActions"]:has(.ocl-railButton) { flex-direction: column; }
@@ -2595,6 +2694,10 @@ window.__ModuleLoader__.load({
 .ocl-railButton:hover { color: var(--ocl-text); background: var(--ocl-fill-hover); }
 .ocl-railButton:focus-visible { outline: var(--dsw-focus-ring-width, 2px) solid var(--ocl-focus); outline-offset: -2px; }
 .ocl-ring { flex: none; display: inline-flex; }
+.ocl-statusRow { align-items: center; gap: 8px; flex-wrap: wrap; }
+.ocl-statusDot { width: 8px; height: 8px; border-radius: 999px; background: var(--ocl-text-secondary); flex: none; }
+.ocl-statusDotOk { background: var(--ocl-accent); }
+.ocl-statusDotBad { background: var(--ocl-danger); }
 .ocl-panel { display: flex; flex-direction: column; gap: 14px; padding: 18px; max-width: 760px; margin: 0 auto; height: 100%; max-height: calc(100vh - 56px); min-height: 0; overflow-y: auto; overscroll-behavior: contain; scrollbar-gutter: stable; }
 .ocl-panel-head { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
 .ocl-limits { margin-top: 8px; }

package/lib/index.js

@@ -3,7 +3,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import { appendFile, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
-import { LlmAdapter, LlmError, ReasoningEffortId, ToolCallId, attributionHeaders, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
+import { CONTEXT_WINDOW_EXCEEDED_CODE, LlmAdapter, LlmError, ReasoningEffortId, ToolCallId, attributionHeaders, isContextWindowExceededError, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
 import z from "@deepseek-ai/schemastery";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
@@ -49,7 +49,7 @@ const DEFAULT_API_BASE = "https://ollama.com";
 const DEFAULT_OPENAI_BASE = "https://ollama.com/v1";
 const DEFAULT_USAGE_URL = "https://ollama.com/api/usage";
 const DEFAULT_BALANCE_URL = "https://ollama.com/api/balance";
-const DEFAULT_USER_AGENT = "dsh-ollama-cloud-provider/0.1.11";
+const DEFAULT_USER_AGENT = "dsh-ollama-cloud-provider/0.1.13";
 const DEFAULT_CONTEXT_WINDOW = 131072;
 const DEFAULT_MAX_TOKENS = 32768;
 const DEFAULT_GENERATE_MAX_TOKENS = 131072;
@@ -1042,6 +1042,9 @@ function classifyResponseError(status, text, headers) {
 	if (status === 401 || status === 403) return new LlmError(`Ollama Cloud rejected the credential: ${message}. Create a key at https://ollama.com/settings/keys and store it through the credentials service.`, "INVALID_CREDENTIAL", options);
 	if (status === 404) return new LlmError(`Ollama Cloud does not serve this model: ${message}. Refresh the catalog and check that the id matches the cloud list exactly.`, "UNSUPPORTED_MODEL", options);
 	if (status === 429) return new LlmError(`Ollama Cloud rate-limited the request: ${message}`, "RATE_LIMIT", options);
+	if (isContextWindowExceededError(detail)) return new LlmError(`Ollama Cloud rejected the request: context window exceeded: ${message}`, CONTEXT_WINDOW_EXCEEDED_CODE, options);
+	if (/does not support (?:images?|vision|tools?)|unsupported (?:image|tool)|image (?:input|modality) is not supported|tools? (?:are|is) not supported/i.test(detail)) return new LlmError(`Ollama Cloud model does not accept this request: ${message}`, "UNSUPPORTED_MODEL", options);
+	if (/request (?:body|entity) too large|payload too large|node count cannot exceed|maximum (?:request|body) size/i.test(detail)) return new LlmError(`Ollama Cloud rejected the request body as too large: ${message}`, "PROVIDER_HTTP_ERROR", options);
 	if (status === 408 || status === 504) return new LlmError(`Ollama Cloud timed out (HTTP ${status}): ${message}`, "TIMEOUT", options);
 	if (status === 503) return new LlmError(`Ollama Cloud is at its concurrency limit or temporarily unavailable: ${message}`, "SERVER", options);
 	if (status >= 500) return new LlmError(`Ollama Cloud gateway error (HTTP ${status}): ${message}`, "SERVER", options);
@@ -3588,6 +3591,43 @@ function publicConfig(config) {
 		userAgent: config.userAgent
 	};
 }
+// src/status.ts
+const PROBE_TIMEOUT_MS = 5e3;
+/**
+* Probe the public Ollama Cloud tag endpoint. This request carries no key and
+* does not consume quota; it only answers whether the configured API base is
+* reachable from this host.
+*/
+async function probeService(config, fetchImpl = fetch) {
+	const started = Date.now();
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), PROBE_TIMEOUT_MS);
+	try {
+		const response = await fetchImpl(tagsUrlFor(config), {
+			method: "GET",
+			signal: controller.signal,
+			headers: { accept: "application/json" }
+		});
+		const latencyMs = Date.now() - started;
+		return {
+			ok: response.ok,
+			status: response.status,
+			latencyMs,
+			checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			...response.ok ? {} : { error: `HTTP ${response.status}` }
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			status: null,
+			latencyMs: Date.now() - started,
+			checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			error: controller.signal.aborted ? "timeout" : error instanceof Error ? error.message : String(error)
+		};
+	} finally {
+		clearTimeout(timer);
+	}
+}
 // src/routes-values.ts
 const TRANSPORTS = /* @__PURE__ */ new Set(["native", "openai-chat"]);
 function cleanAccounts(value) {
@@ -3979,6 +4019,20 @@ function applyRoutes(ctx, web, deps) {
 			json(res, 500, { error: error instanceof Error ? error.message : "health failed" });
 		}
 	});
+	route("/dsh-ollama/status", async (req, res) => {
+		if (!readOnly(req, res)) return;
+		try {
+			json(res, 200, await probeService(deps.config(), fetch));
+		} catch (error) {
+			json(res, 200, {
+				ok: false,
+				status: null,
+				latencyMs: 0,
+				checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				error: error instanceof Error ? error.message : "status failed"
+			});
+		}
+	});
 	route("/dsh-ollama/analytics", async (req, res) => {
 		if (!readOnly(req, res)) return;
 		const url = new URL(req.url ?? "/", "http://localhost");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-ollama-cloud-provider",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Ollama Cloud LLM provider plugin for DeepSeek Harness (dsh).",
   "license": "MIT",
   "type": "module",
@@ -70,8 +70,9 @@
     "build": "tsdown",
     "prepare": "tsdown 1>&2",
     "typecheck": "tsc --noEmit",
-    "test": "node --import tsx --test tests/core.test.ts tests/usage.test.ts tests/adapter.test.ts tests/routes.test.ts tests/native.test.ts tests/commands.test.ts tests/tui-settings.test.ts tests/analytics.test.ts tests/apply.test.ts tests/account-rules.test.ts tests/request-log.test.ts tests/image-budget.test.ts tests/tool-schema.test.ts tests/tools.test.ts tests/plugin-updater.test.ts tests/compat.test.ts",
+    "test": "node --import tsx --test tests/core.test.ts tests/usage.test.ts tests/adapter.test.ts tests/routes.test.ts tests/native.test.ts tests/commands.test.ts tests/tui-settings.test.ts tests/analytics.test.ts tests/apply.test.ts tests/account-rules.test.ts tests/request-log.test.ts tests/image-budget.test.ts tests/tool-schema.test.ts tests/tools.test.ts tests/plugin-updater.test.ts tests/compat.test.ts tests/status.test.ts",
     "check": "npm run typecheck && npm test && npm run build",
+    "test:engine": "node scripts/test-engines.mjs",
     "release": "npm run check && npm pack",
     "sync:models": "node scripts/sync-models.mjs"
   },