@narumitw/pi-usage 0.51.0 → 0.52.0

package/README.md

@@ -134,6 +134,16 @@ GitHub's quota endpoint requires the original GitHub OAuth token rather than the
 
 The extension does not call OpenRouter's account-level `/credits` endpoint because that operation requires a separate management key. OpenRouter documents the distinction between credit and rate limits in its [API limits guide](https://openrouter.ai/docs/api_reference/limits).
 
+### OpenCode Go (Zen)
+
+- Provider ID: `opencode-go`
+- Semantics: OpenCode Zen plan usage windows—rolling, weekly, and monthly
+- Source: `GET {model base URL}/usage` on the configured `opencode.ai` gateway using Pi's resolved inference API key
+- Displayed data: used percentage and reset time for each window; `rate-limited` windows remain visible at their reported usage, while unknown statuses are reported as unavailable notes
+- Statusline examples: `zen 0% r 4% w 2% m`
+
+The usage endpoint is derived from the model's base URL (`…/zen/go/v1/usage`) and is only queried when the resolved origin is `https://opencode.ai`; other origins fail before sending the credential.
+
 ## 🧭 Current and configured accounts
 
 `Current` means the provider and credential used by Pi's selected model. `Configured` means Pi reports runtime auth for another supported provider; it does not mean that provider is active.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@narumitw/pi-usage",
-	"version": "0.51.0",
-	"description": "Pi extension that shows current-account usage for Codex, GitHub Copilot, and OpenRouter.",
+	"version": "0.52.0",
+	"description": "Pi extension that shows current-account usage for Codex, GitHub Copilot, OpenRouter, and OpenCode Zen.",
 	"type": "module",
 	"license": "MIT",
 	"private": false,
@@ -13,7 +13,9 @@
 		"quota",
 		"codex",
 		"copilot",
-		"openrouter"
+		"openrouter",
+		"opencode",
+		"zen"
 	],
 	"files": [
 		"src",
@@ -38,10 +40,10 @@
 		"@earendil-works/pi-coding-agent": "*"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.5.7",
-		"@earendil-works/pi-ai": "0.84.1",
-		"@earendil-works/pi-coding-agent": "0.84.1",
-		"@types/node": "26.1.2",
+		"@biomejs/biome": "2.5.8",
+		"@earendil-works/pi-ai": "0.84.2",
+		"@earendil-works/pi-coding-agent": "0.84.2",
+		"@types/node": "26.2.0",
 		"typescript": "7.0.2"
 	},
 	"repository": {

package/src/format.ts

@@ -18,6 +18,7 @@ export function formatUsageReport(report: UsageReport, displayState: UsageDispla
 	if (report.providerId === "openai-codex") formatCodexReport(lines, report);
 	else if (report.providerId === "github-copilot") formatGitHubCopilotReport(lines, report);
 	else if (report.providerId === "openrouter") formatOpenRouterReport(lines, report);
+	else if (report.providerId === "opencode-go") formatOpenCodeZenReport(lines, report);
 	else formatGenericReport(lines, report);
 
 	if (report.notes) {
@@ -35,6 +36,7 @@ export function formatUsageStatusline(report: UsageReport, model?: UsageModel):
 		const total = report.metrics.find((metric) => metric.id === "usage-total");
 		if (typeof total?.value === "number") return `openrouter ${formatUsd(total.value)} used`;
 	}
+	if (report.providerId === "opencode-go") return formatOpenCodeZenStatusline(report);
 	return undefined;
 }
 
@@ -140,6 +142,24 @@ function formatOpenRouterReport(lines: string[], report: UsageReport): void {
 	}
 }
 
+function formatOpenCodeZenReport(lines: string[], report: UsageReport): void {
+	for (const bucket of report.buckets) {
+		const reset = bucket.resetsAt ? ` (resets ${formatReset(bucket.resetsAt)})` : "";
+		const used = bucket.used ?? "unavailable";
+		lines.push(`${`${bucket.label}:`.padEnd(VALUE_COLUMN)}${used}% used${reset}`);
+	}
+}
+
+function formatOpenCodeZenStatusline(report: UsageReport): string | undefined {
+	const parts = ["zen"];
+	for (const bucket of report.buckets) {
+		if (bucket.used === undefined) continue;
+		const compact = bucket.id === "rolling" ? "r" : bucket.id === "weekly" ? "w" : "m";
+		parts.push(`${clampPercent(bucket.used).toFixed(0)}% ${compact}`);
+	}
+	return parts.length > 1 ? parts.join(" ") : undefined;
+}
+
 function formatGenericReport(lines: string[], report: UsageReport): void {
 	for (const bucket of report.buckets) {
 		lines.push(

package/src/index.ts

@@ -34,6 +34,7 @@ export {
 export { formatProviderStates, formatUsageReport, formatUsageStatusline } from "./format.js";
 export { normalizeCodexBackendPayload } from "./providers/codex.js";
 export { normalizeGitHubCopilotUsagePayload } from "./providers/github-copilot.js";
+export { normalizeOpenCodeZenPayload } from "./providers/opencode-zen.js";
 export { normalizeOpenRouterKeyPayload } from "./providers/openrouter.js";
 export {
 	adapterForProvider,

package/src/providers/opencode-zen.ts

@@ -0,0 +1,83 @@
+import { sanitizeDisplayText } from "../core.js";
+import type { OpenCodeZenPayload, UsageBucket, UsageReport } from "../types.js";
+
+const ZEN_WINDOWS = [
+	{ key: "rolling", label: "Rolling" },
+	{ key: "weekly", label: "Weekly" },
+	{ key: "monthly", label: "Monthly" },
+] as const;
+
+export function normalizeOpenCodeZenPayload(
+	payload: OpenCodeZenPayload,
+	capturedAt: number,
+): UsageReport {
+	const usage = asObject(payload.usage);
+	if (!usage) throw new Error("OpenCode Zen usage response was not an object.");
+
+	const buckets: UsageBucket[] = [];
+	const notes: string[] = [];
+	for (const window of ZEN_WINDOWS) {
+		const raw = asObject(usage[window.key]);
+		if (!raw) continue;
+		const status = asString(raw.status);
+		if (status !== "ok" && status !== "rate-limited") {
+			notes.push(`${window.label} window unavailable (${status ?? "unknown status"}).`);
+			continue;
+		}
+		const used = asNonnegativeNumber(raw.percent);
+		if (used === undefined) continue;
+		const resetsAt = asEpochSeconds(raw.resetsAt);
+		buckets.push({
+			id: window.key,
+			label: `${window.label} window`,
+			used,
+			remaining: 100 - clampPercent(used),
+			limit: 100,
+			unit: "percent",
+			...(resetsAt !== undefined ? { resetsAt } : {}),
+		});
+	}
+	if (buckets.length === 0) {
+		throw new Error("OpenCode Zen usage endpoint returned no displayable usage data.");
+	}
+
+	return {
+		providerId: "opencode-go",
+		providerName: "OpenCode Go",
+		capturedAt,
+		source: "opencode-zen-usage",
+		semantics: {
+			kind: "consumer-subscription",
+			label: "OpenCode Zen plan usage",
+		},
+		buckets,
+		metrics: [],
+		...(notes.length > 0 ? { notes } : {}),
+	};
+}
+
+function asObject(value: unknown): Record<string, unknown> | undefined {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
+	return value as Record<string, unknown>;
+}
+
+function asString(value: unknown): string | undefined {
+	if (typeof value !== "string") return undefined;
+	return sanitizeDisplayText(value, 80) || undefined;
+}
+
+function asNonnegativeNumber(value: unknown): number | undefined {
+	if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return undefined;
+	return value;
+}
+
+function asEpochSeconds(value: unknown): number | undefined {
+	if (typeof value !== "string" || !value.trim()) return undefined;
+	const parsed = Date.parse(value);
+	if (Number.isNaN(parsed)) return undefined;
+	return Math.floor(parsed / 1000);
+}
+
+function clampPercent(value: number): number {
+	return Math.min(100, Math.max(0, value));
+}

package/src/query.ts

@@ -3,10 +3,12 @@ import { type ExtensionContext, readStoredCredential } from "@earendil-works/pi-
 import { errorMessage, fingerprintResolvedAuth, redactUsageError } from "./core.js";
 import { normalizeCodexBackendPayload } from "./providers/codex.js";
 import { normalizeGitHubCopilotUsagePayload } from "./providers/github-copilot.js";
+import { normalizeOpenCodeZenPayload } from "./providers/opencode-zen.js";
 import { normalizeOpenRouterKeyPayload } from "./providers/openrouter.js";
 import type {
 	CodexBackendPayload,
 	GitHubCopilotUsagePayload,
+	OpenCodeZenPayload,
 	OpenRouterKeyPayload,
 	PiModel,
 	ResolvedUsageAuth,
@@ -74,6 +76,21 @@ export const SUPPORTED_ADAPTERS: readonly UsageProviderAdapter[] = [
 			return normalizeOpenRouterKeyPayload(payload as OpenRouterKeyPayload, Date.now());
 		},
 	},
+	{
+		id: "opencode-go",
+		displayName: "OpenCode Go",
+		semantics: { kind: "consumer-subscription", label: "OpenCode Zen plan usage" },
+		async query(auth, signal, timeoutMs) {
+			const payload = await fetchProviderJson(
+				opencodeUsageUrl(auth.model.baseUrl),
+				auth,
+				signal,
+				timeoutMs,
+				"OpenCode Zen usage endpoint",
+			);
+			return normalizeOpenCodeZenPayload(payload as OpenCodeZenPayload, Date.now());
+		},
+	},
 ];
 
 export function adapterForProvider(
@@ -393,6 +410,7 @@ function hasOfficialUrlOrigin(value: string, providerId: string): boolean {
 		const url = new URL(value);
 		if (providerId === "openai-codex") return url.origin === "https://chatgpt.com";
 		if (providerId === "openrouter") return url.origin === "https://openrouter.ai";
+		if (providerId === "opencode-go") return url.origin === "https://opencode.ai";
 		if (providerId === "github-copilot") {
 			return (
 				url.protocol === "https:" && /^api\.[a-z0-9-]+\.githubcopilot\.com$/u.test(url.hostname)
@@ -418,6 +436,12 @@ function hasHeader(headers: Record<string, string>, name: string): boolean {
 	return Object.keys(headers).some((key) => key.toLowerCase() === name.toLowerCase());
 }
 
+function opencodeUsageUrl(baseUrl: string | undefined): string {
+	const base = baseUrl?.trim().replace(/\/+$/u, "");
+	if (!base) throw new Error("OpenCode Go model base URL is unavailable.");
+	return `${base}/usage`;
+}
+
 function isAbortError(error: unknown): boolean {
 	return error instanceof Error && error.name === "AbortError";
 }

package/src/types.ts

@@ -93,6 +93,10 @@ export type OpenRouterKeyPayload = {
 	data?: unknown;
 };
 
+export type OpenCodeZenPayload = {
+	usage?: unknown;
+};
+
 export type CodexBackendPayload = {
 	plan_type?: unknown;
 	rate_limit?: unknown;