dsh-any-deepseek 0.0.13 → 0.0.14

package/lib/balance.d.ts

@@ -119,6 +119,25 @@ export declare function parseOllamaBalance(body: unknown): BalanceReading | unde
  * @returns the reading, or undefined when neither body is this shape.
  */
 export declare function parseOpenAIBilling(subscription: unknown, usage: unknown): BalanceReading | undefined;
+/**
+ * Parse OpenCode Go's `GET /zen/go/v1/usage`.
+ *
+ * 🔴 **This surface reports WINDOWS, never money.** The owner remembered correctly that OpenCode
+ * exposes a usage query — and it does; what it does not expose (to an API key) is the credit
+ * wallet, which lives behind a logged-in browser session. The only key-authenticated money signal
+ * is the error thrown at $0 (anomalyco/opencode#44189), which is why the feature request asks for
+ * a `balance` object to be added to this very endpoint.
+ *
+ * Two response shapes are accepted, because a monitor should not break when the provider ships
+ * the requested addition:
+ *  · `{ usage: { rolling: {percent, resetsAt}, weekly: … , monthly: … } }`
+ *  · the same keys hoisted to the top level.
+ * A `balance` object is read IF PRESENT — so the day they merge that request, the number appears
+ * with no code change here.
+ * @param body - the parsed JSON body.
+ * @returns the reading, or undefined when the body carries no recognizable window.
+ */
+export declare function parseOpencodeWindows(body: unknown): BalanceReading | undefined;
 /**
  * Map one channel's raw bodies onto a reading, dispatching on the declared shape.
  * @param probe - the preset's declared probe.

package/lib/index.js

@@ -278,7 +278,25 @@ const CHANNEL_PRESETS = {
 		...V41_FLASH_CAPS,
 		compat: { ...DEEPSEEK_THINKING_COMPAT },
 		headers: { ...OPENCODE_HEADERS },
-		note: "Requires the OpenCode session headers; shipped with the preset. No balance API (subscription usage only)."
+		/**
+		* 🔴 **The owner was right that OpenCode has a query surface — and it reports WINDOWS, not
+		* money.** Both halves of that sentence were measured, in that order:
+		*
+		*  1. A route exists at `/zen/go/v1/usage`. Proven by status code discrimination without a
+		*     key: a made-up path under the same prefix answers **404**, while `/usage` answers
+		*     **401** (route present, auth required). `/zen/v1/balance` answers 404 — that one really
+		*     does not exist (it is what anomalyco/opencode#44189 is asking for).
+		*  2. What it returns is Go-subscription usage windows (rolling / weekly / monthly), **not**
+		*     the credit wallet. The balance is only reachable from a logged-in browser session
+		*     (`BillingTable.balance` behind a SolidStart server function), so a key cannot read it —
+		*     the only key-authenticated money signal is the error thrown at $0.
+		*
+		* ⇒ Declared as a `windows` shape, which is exactly what this endpoint honestly provides.
+		* The credit balance stays absent rather than invented; the panel shows the windows and does
+		* not pretend a currency amount exists.
+		*/
+		balance: { shape: "opencode-windows" },
+		note: "Requires the OpenCode session headers; shipped with the preset. Usage windows only — the credit balance is not readable with an API key."
 	},
 	commandcode: {
 		displayName: "CommandCode",
@@ -304,8 +322,7 @@ const CHANNEL_PRESETS = {
 		api: "openai-completions",
 		baseURL: "https://amr-link.open-design.ai/v1",
 		model: "deepseek-v4.1-flash",
-		...V41_FLASH_CAPS,
-		balance: { shape: "openai-billing" }
+		...V41_FLASH_CAPS
 	},
 	"deepseek-official": {
 		displayName: "DeepSeek Official",
@@ -1792,6 +1809,7 @@ function balanceUrls(probe, channelBaseURL) {
 	switch (probe.shape) {
 		case "deepseek": return [`${root}/user/balance`];
 		case "ollama": return [`${root}/api/balance`];
+		case "opencode-windows": return [`${root}/usage`];
 		case "openai-billing": return [`${root}/dashboard/billing/subscription`, `${root}/dashboard/billing/usage`];
 	}
 }
@@ -1951,6 +1969,58 @@ function parseOpenAIBilling(subscription, usage) {
 	};
 }
 /**
+* Parse OpenCode Go's `GET /zen/go/v1/usage`.
+*
+* 🔴 **This surface reports WINDOWS, never money.** The owner remembered correctly that OpenCode
+* exposes a usage query — and it does; what it does not expose (to an API key) is the credit
+* wallet, which lives behind a logged-in browser session. The only key-authenticated money signal
+* is the error thrown at $0 (anomalyco/opencode#44189), which is why the feature request asks for
+* a `balance` object to be added to this very endpoint.
+*
+* Two response shapes are accepted, because a monitor should not break when the provider ships
+* the requested addition:
+*  · `{ usage: { rolling: {percent, resetsAt}, weekly: … , monthly: … } }`
+*  · the same keys hoisted to the top level.
+* A `balance` object is read IF PRESENT — so the day they merge that request, the number appears
+* with no code change here.
+* @param body - the parsed JSON body.
+* @returns the reading, or undefined when the body carries no recognizable window.
+*/
+function parseOpencodeWindows(body) {
+	const root = asRecord(body);
+	if (root === void 0) return void 0;
+	const usage = asRecord(root.usage) ?? root;
+	const windows = [];
+	for (const name of [
+		"rolling",
+		"weekly",
+		"monthly"
+	]) {
+		const window = asRecord(usage[name]);
+		if (window === void 0) continue;
+		const used = num(window.percent);
+		if (used === void 0) continue;
+		windows.push({
+			name,
+			remainingPercent: Math.max(0, Math.min(100, 100 - used)),
+			...text(window.resetsAt) === void 0 ? {} : { resetsAt: text(window.resetsAt) }
+		});
+	}
+	const amounts = [];
+	const balance = asRecord(root.balance);
+	const usd = num(balance?.usd);
+	if (usd !== void 0) amounts.push({
+		currency: text(balance?.currency) ?? "USD",
+		remaining: usd
+	});
+	if (windows.length === 0 && amounts.length === 0) return void 0;
+	return {
+		amounts,
+		windows,
+		note: amounts.length === 0 ? "subscription usage windows; the credit balance is not readable with an API key" : void 0
+	};
+}
+/**
 * Map one channel's raw bodies onto a reading, dispatching on the declared shape.
 * @param probe - the preset's declared probe.
 * @param bodies - response bodies in the order {@link balanceUrls} returned URLs.
@@ -1960,6 +2030,7 @@ function readBalance(probe, bodies) {
 	switch (probe.shape) {
 		case "deepseek": return parseDeepSeekBalance(bodies[0]);
 		case "ollama": return parseOllamaBalance(bodies[0]);
+		case "opencode-windows": return parseOpencodeWindows(bodies[0]);
 		case "openai-billing": return parseOpenAIBilling(bodies[0], bodies[1]);
 	}
 }
@@ -2200,11 +2271,29 @@ async function fetchBalance(channel, key, signal) {
 			...signal === void 0 ? {} : { signal }
 		});
 		const text = await response.text();
-		if (!response.ok) return {
-			status: "unavailable",
-			code: `HTTP_${response.status}`,
-			detail: `balance endpoint answered HTTP ${response.status}`
-		};
+		if (!response.ok) {
+			/**
+			* 🔴 **404 means "this relay has no such route", not "the read failed".**
+			*
+			* The distinction decides what the user does next: `unsupported` says "this endpoint
+			* does not publish a balance — stop looking", while `unavailable` says "it should have
+			* but did not answer — try again". Reporting a 404 as a failure invites a retry loop
+			* against a route that will never exist.
+			*
+			* Measured: Open Design answers 404 on every billing candidate while `/v1/models`
+			* answers 401 (route exists, auth required) — that difference is how the two were told
+			* apart without a key.
+			*/
+			if (response.status === 404) return {
+				status: "unsupported",
+				detail: "this relay has no balance route (HTTP 404)"
+			};
+			return {
+				status: "unavailable",
+				code: `HTTP_${response.status}`,
+				detail: `balance endpoint answered HTTP ${response.status}`
+			};
+		}
 		try {
 			bodies.push(JSON.parse(text));
 		} catch {

package/lib/presets.d.ts

@@ -32,23 +32,26 @@ export type ChannelModality = 'text' | 'image';
  * How to read one endpoint's remaining balance.
  *
  * Owner request (2026-10-23): 「其它渠道的查看方式你需要找到并实现它们的」. There is no single
- * answer — every provider invented its own surface, and some have none at all. This type is that
- * fact written down instead of guessed: a preset either names a known shape or says it has none.
- *
- * Three shapes were verified against real endpoints (see `balance.ts` for the response mapping):
- *  · `deepseek`  — DeepSeek's own `GET /user/balance`.
- *  · `ollama`    — `GET /api/balance` (note: under `/api`, NOT the `/v1` used for inference).
- *  · `openai-billing` — the OpenAI-legacy billing pair that new-api / one-api relays clone:
+ * answer — every provider invented its own surface, and some report windows instead of money.
+ * This type is that fact written down instead of guessed: a preset either names a known shape or
+ * says it has none.
+ *
+ * Four shapes were verified against real endpoints (see `balance.ts` for the response mapping):
+ *  · `deepseek`        — DeepSeek's own `GET /user/balance`.
+ *  · `ollama`          — `GET /api/balance` (note: under `/api`, NOT the `/v1` used for inference).
+ *  · `opencode-windows` — OpenCode Go's `GET /zen/go/v1/usage`: rolling/weekly/monthly WINDOWS.
+ *                         No currency amount — the credit wallet is not API-readable.
+ *  · `openai-billing`  — the OpenAI-legacy billing pair that new-api / one-api relays clone:
  *    `GET /v1/dashboard/billing/subscription` + `GET /v1/dashboard/billing/usage`.
  *
- * 🔴 **A fourth answer is legitimate and must be representable: "this endpoint has no balance
- * API".** OpenCode Zen is exactly that case — its owner has an open feature request asking for
- * one, because today the only key-authenticated signal is the error thrown at $0
- * (anomalyco/opencode#44189). Pretending otherwise would mean showing a number nobody measured.
+ * 🔴 **"This endpoint has no balance API" must be representable, and is**: a preset simply omits
+ * `balance`. Open Design is a measured case (every billing candidate answers 404 while
+ * `/v1/models` answers 401, i.e. inference only). Pretending otherwise would mean showing a
+ * number nobody measured.
  */
 export interface BalanceProbe {
     /** Which response shape to read. */
-    shape: 'deepseek' | 'ollama' | 'openai-billing';
+    shape: 'deepseek' | 'ollama' | 'opencode-windows' | 'openai-billing';
     /**
      * Overrides the base URL for the balance call.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-any-deepseek",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "One DeepSeek V4.1 Flash provider for DeepSeek Harness: paste a key per channel, switch channels manually, token usage booked per real upstream.",
   "license": "MIT",
   "repository": {