@bacnh85/pi-sub 0.1.24 → 0.1.28

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.1.28 (2026-08-09)
+
+### Improvements
+
+- **Command Code monthly balance now shown in the footer.** The footer adds a
+  compact `M:$X.XX` segment (monthly credit balance from
+  `/alpha/billing/credits`) next to the 5-hour/weekly windows, e.g.
+  `(Command Code key#…) R:100%/5H W:100%/7D M:$69.99`. The `/sub` detail view
+  keeps the `Monthly: $X remaining` breakdown line.
+
+## 0.1.27 (2026-08-09)
+
+### Features
+
+- **Command Code now shows live usage windows.** The adapter fetches
+  `https://api.commandcode.ai/alpha/billing/credits` with the same Provider
+  API key used for `/provider/v1` models and renders the 5-hour and weekly
+  rolling windows (USD used/cap, remaining% + reset countdown) plus a
+  `Monthly: $X remaining` balance line — matching what the `cmd /usage` CLI
+  shows. Previously the footer showed session cost only.
+
+## 0.1.26 (2026-08-09)
+
+### Features
+
+- Added Command Code (`commandcode`) provider support. When a `commandcode`
+  model is active, the footer shows the account label plus session cost and
+  tok/s, and `/sub` reports the provider. Command Code's Provider API does not
+  expose usage windows via its API key (the rolling-window data is
+  web-session-cookie only), so live 5h/weekly meters are not shown — behavior
+  matches `opencode-go` and `9router`.
+
+## 0.1.25 (2026-08-07)
+
+### Improvements
+
+- Widen peer dependency range to support Pi 0.84.0 (`>=0.80.8 <0.85.0`).
+  No code changes — verified compatible against the 0.84.0 SDK types.
+
 ## 0.1.24 (2026-08-05)
 
 ### Improvements

package/README.md

@@ -2,7 +2,7 @@
 
 Pi extension that shows subscription usage for the currently selected supported model provider.
 
-Supports OpenAI Codex (`openai-codex`) with live usage windows from ChatGPT's usage endpoint, OpenCode Go (`opencode-go`) with session cost tracking, and Z.ai GLM Coding Plan — both the international (`zai`) and China (`zai-coding-cn`, `open.bigmodel.cn`) endpoints — with quota monitoring. Displays a subscription footer status after Pi's built-in status/token usage line.
+ Supports OpenAI Codex (`openai-codex`) with live usage windows from ChatGPT's usage endpoint, OpenCode Go (`opencode-go`) with session cost tracking, and Z.ai GLM Coding Plan — both the international (`zai`) and China (`zai-coding-cn`, `open.bigmodel.cn`) endpoints — with quota monitoring. Also tracks Command Code (`commandcode`) 5-hour/weekly windows and monthly credit balance. Displays a subscription footer status after Pi's built-in status/token usage line.
 
 ## Install
 
@@ -59,6 +59,18 @@ The built-in `zai-coding-cn` provider targets the domestic BigModel endpoint (`o
 9router (172.30.55.22:20128) 145 tok/s
 ```
 
+### Command Code
+
+Command Code exposes live usage windows via its `/alpha/billing/credits` endpoint (same Provider API key used for `/provider/v1` models — no cookies). The footer shows the active account/key label, 5-hour and weekly remaining windows with reset countdowns, and last response speed:
+
+```text
+(Command Code key#1a2b3c4d) R:99%/4H W:99%/6D M:$69.99 42 tok/s
+```
+
+The `M:$X.XX` segment is the monthly credit balance (the plan's remaining
+monthly allowance in USD). The `/sub` detail view also shows a
+`Monthly: $X remaining` line.
+
 ### Tokens per second
 
 `pi-sub` tracks each response's tokens-per-second (tok/s) speed by measuring the time from provider request to message completion against the response's output token count. The last response's speed is shown in the footer next to usage data. The `/sub` detail view shows both the last response speed and the session-wide average.
@@ -98,6 +110,20 @@ Last response: 42 tok/s · Session avg: 39 tok/s
 OpenCode Go does not expose usage windows.
 ```
 
+For Command Code, `/sub` shows the provider/model, active account/key label, rolling windows, and speed:
+
+```text
+Provider: Command Code · Model: deepseek/deepseek-v4-flash · Fetched: 14:23
+Session cost: $0.05
+Last response: 42 tok/s · Session avg: 39 tok/s
+
+  ACCOUNT                        ROLLING  WEEKLY   LAST ACTIVITY
+-----------------------------------------------------------------
+* Command Code key#1a2b3c4d      99%/4H   99%/6D   Now
+
+Monthly: $69.99 remaining
+```
+
 For Z.ai, `/sub` shows the rolling and weekly quota windows and speed:
 
 ```text
@@ -130,6 +156,7 @@ Refreshes are cached briefly to avoid excessive usage endpoint calls.
 
 - **OpenAI Codex**: Pi auth must contain an `openai-codex` OAuth entry in `~/.pi/agent/auth.json` or `$PI_CODING_AGENT_DIR/auth.json`. The entry must include `access` and `accountId` fields.
 - **OpenCode Go**: Pi auth must contain an `opencode-go` API key entry (via `/login` or env var). The entry must have a `key` field or an `accountId` field. OpenCode Go/Zen usage windows and Zen balance are not shown because no public API is currently documented for those values.
+- **Command Code**: Pi auth must contain a `commandcode` API key entry (via `/login commandcode` or the `COMMAND_CODE_API_KEY` env var). The entry must have a `key` field or an `accountId` field. Usage is read from `https://api.commandcode.ai/alpha/billing/credits` with the same key; 5-hour and weekly windows plus the monthly credit balance are displayed.
 - **Z.ai**: Pi auth must contain a `zai` entry in `auth.json` with a `key` field (the same API key used for Z.ai model access via `@czottmann/pi-zai-api`). The Z.ai provider must be registered (e.g., `pi install npm:@czottmann/pi-zai-api`).
 - **Z.ai Coding Plan (China)**: The built-in `zai-coding-cn` provider targets `https://open.bigmodel.cn/api/coding/paas/v4`. Pi auth must contain a `zai-coding-cn` entry with a `key` field (set via `/login` or the `ZAI_CODING_CN_API_KEY` env var). Quota is read from the BigModel endpoint `https://open.bigmodel.cn/api/monitor/usage/quota/limit`.
 - For API-key-only providers, account labels come from stored auth metadata (`email`, `label`, `name`, or `accountId`) when available; otherwise `pi-sub` displays a non-secret SHA-256 key fingerprint such as `Z.ai key#1a2b3c4d`.
@@ -141,4 +168,4 @@ See [CHANGELOG.md](CHANGELOG.md) for release history.
 
 ## Design notes
 
-The extension is named `pi-sub` rather than `pi-codex-usage` so future subscription providers can be added as separate adapters. Supports OpenAI Codex (live usage API), OpenCode Go (session cost only), and the Z.ai GLM Coding Plan (international `zai` and China `zai-coding-cn`, which share a quota response format and are served by one parameterized adapter).
+The extension is named `pi-sub` rather than `pi-codex-usage` so future subscription providers can be added as separate adapters. Supports OpenAI Codex (live usage API), OpenCode Go (session cost only), the Z.ai GLM Coding Plan (international `zai` and China `zai-coding-cn`, which share a quota response format and are served by one parameterized adapter), and Command Code (live 5-hour/weekly windows + monthly balance via `/alpha/billing/credits`).

package/extensions/index.ts

@@ -18,6 +18,8 @@ const ZAI_CODING_CN_PROVIDER = "zai-coding-cn";
 const ZAI_CODING_CN_USAGE_URL = "https://open.bigmodel.cn/api/monitor/usage/quota/limit";
 const NINE_ROUTER_PROVIDER = "9router";
 const NINE_ROUTER_CONFIG_PATH = path.join(os.homedir(), ".pi", "agent", "9router-config.json");
+const COMMAND_CODE_PROVIDER = "commandcode";
+const COMMAND_CODE_USAGE_URL = "https://api.commandcode.ai/alpha/billing/credits";
 
 type ModelLike = { provider?: string; id?: string } | undefined;
 
@@ -59,6 +61,8 @@ interface SubscriptionAccountSnapshot {
   plan?: string;
   fiveHour?: UsageWindow;
   weekly?: UsageWindow;
+  // Command Code-only: monthly credit balance in USD (not a rolling window).
+  monthlyCredits?: number;
   // Z.ai-only extras surfaced in the /sub detail view.
   mcpMonthly?: UsageWindow; // from TIME_LIMIT already present in the quota response
   usageBreakdown?: string; // per-model / per-tool summary line(s)
@@ -117,6 +121,10 @@ function isNineRouterModel(model: ModelLike): boolean {
   return (model?.provider?.toLowerCase() ?? "") === NINE_ROUTER_PROVIDER;
 }
 
+function isCommandCodeModel(model: ModelLike): boolean {
+  return (model?.provider?.toLowerCase() ?? "") === COMMAND_CODE_PROVIDER;
+}
+
 function piAuthPath(): string {
   const configDir = process.env.PI_CODING_AGENT_DIR?.trim() || path.join(os.homedir(), ".pi", "agent");
   return path.join(configDir, "auth.json");
@@ -340,6 +348,7 @@ function redactedError(error: unknown, provider = "Codex"): string {
   if (/missing openai-codex/i.test(message)) return "openai-codex auth not found";
   if (/missing opencode-go/i.test(message)) return "opencode-go auth not found";
   if (/missing zai/i.test(message)) return "zai auth not found";
+  if (/missing commandcode/i.test(message)) return "commandcode auth not found";
   if (/timed out|timeout|aborted/i.test(message)) return `${provider} usage refresh timed out`;
   if (/401|403|auth|token|unauthorized|forbidden/i.test(message)) return `${provider} auth unavailable`;
   return `${provider} usage unavailable`;
@@ -411,6 +420,60 @@ async function fetchNineRouterUsage(_signal?: AbortSignal): Promise<Subscription
   };
 }
 
+// Command Code's /alpha/billing/credits endpoint (auth: same Provider API key
+// as /provider/v1 models) returns live 5-hour and weekly rolling windows plus
+// the monthly credit balance — the same data as the cmd /usage CLI.
+async function fetchCommandCodeUsage(signal?: AbortSignal): Promise<SubscriptionUsageSnapshot> {
+  try {
+    const { key: apiKey, account: authAccount } = await readZaiAuth(COMMAND_CODE_PROVIDER, "Command Code");
+    const timeoutSignal = AbortSignal.timeout(7_000);
+    const combinedSignal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+
+    const headers = {
+      Accept: "application/json",
+      Authorization: `Bearer ${apiKey}`,
+      "User-Agent": "pi-sub/0.1.27",
+    };
+    const response = await fetch(COMMAND_CODE_USAGE_URL, { headers, signal: combinedSignal });
+    if (!response.ok) {
+      throw new Error(`Command Code usage request failed with HTTP ${response.status}`);
+    }
+    const body = (await response.json()) as CommandCodeCreditsApiResponse;
+
+    const credits = body.credits;
+    const windowLimits = body.windowLimits;
+    const fiveHour = commandCodeWindowToUsageWindow(windowLimits?.fiveHour);
+    const weekly = commandCodeWindowToUsageWindow(windowLimits?.weekly);
+
+    // Monthly allowance is an absolute USD balance, not a rolling window.
+    const monthlyCredits = typeof credits?.monthlyCredits === "number" ? credits.monthlyCredits : undefined;
+    const monthlyLine = monthlyCredits !== undefined ? `Monthly: $${monthlyCredits.toFixed(2)} remaining` : undefined;
+    const breakdown = [monthlyLine].filter((s): s is string => !!s);
+
+    const account: SubscriptionAccountSnapshot = {
+      ...authAccount,
+      fiveHour,
+      weekly,
+      monthlyCredits,
+      usageBreakdown: breakdown.length > 0 ? breakdown.join("\n") : undefined,
+    };
+
+    return {
+      providerDisplayName: "Command Code",
+      accounts: [account],
+      activeAccount: account,
+      fetchedAt: Date.now(),
+    };
+  } catch (error) {
+    return {
+      providerDisplayName: "Command Code",
+      accounts: [],
+      fetchedAt: Date.now(),
+      error: redactedError(error, "Command Code"),
+    };
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Z.ai adapter
 // ---------------------------------------------------------------------------
@@ -438,6 +501,48 @@ interface ZaiUsageApiError {
   success?: boolean;
 }
 
+// ---------------------------------------------------------------------------
+// Command Code adapter
+// ---------------------------------------------------------------------------
+// Live-verified 2026-08-09: GET https://api.commandcode.ai/alpha/billing/credits
+// with the Provider API key (same user_... key as /provider/v1 models) returns
+// USD windows + monthly credit balance. resetAt is epoch milliseconds.
+
+interface CommandCodeWindowApi {
+  used: number;
+  cap: number;
+  exceeded?: boolean | null;
+  resetAt?: number;
+}
+
+interface CommandCodeCreditsApiResponse {
+  credits?: {
+    monthlyCredits?: number;
+    purchasedCredits?: number;
+    freeCredits?: number;
+    belowThreshold?: boolean;
+  };
+  windowLimits?: {
+    limited?: boolean;
+    fiveHour?: CommandCodeWindowApi;
+    weekly?: CommandCodeWindowApi;
+  };
+}
+
+/** Map a Command Code USD window (used/cap in dollars, resetAt in ms) into
+ *  the shared UsageWindow shape (remaining%, reset labels). */
+function commandCodeWindowToUsageWindow(window: CommandCodeWindowApi | undefined): UsageWindow | undefined {
+  if (!window || typeof window.used !== "number" || typeof window.cap !== "number" || window.cap <= 0) return undefined;
+  const usedPct = Math.round((window.used / window.cap) * 100);
+  const percent = Math.min(100, usedPct);
+  const remaining = Math.max(0, 100 - percent);
+  // resetAt is epoch ms; format helpers expect seconds.
+  const resetAtSec = window.resetAt ? window.resetAt / 1000 : undefined;
+  const resetLabel = formatReset(resetAtSec);
+  const remainingLabel = formatRemainingTime(resetAtSec);
+  return { percent, remaining, remainingLabel, resetLabel };
+}
+
 function zaiLimitToUsageWindow(limit: ZaiLimitEntry): UsageWindow | undefined {
   if (typeof limit.percentage !== "number") return undefined;
   const percent = Math.round(limit.percentage);
@@ -600,6 +705,7 @@ function supportedAdapter(model: ModelLike): SubscriptionProviderAdapter | undef
   if (isZaiModel(model)) return { id: ZAI_PROVIDER, displayName: "Z.ai", ...zaiUsageAdapter(ZAI_PROVIDER, ZAI_USAGE_URL, "Z.ai") };
   if (isZaiCodingCnModel(model)) return { id: ZAI_CODING_CN_PROVIDER, displayName: "Z.ai (CN)", ...zaiUsageAdapter(ZAI_CODING_CN_PROVIDER, ZAI_CODING_CN_USAGE_URL, "Z.ai (CN)") };
   if (isNineRouterModel(model)) return { id: NINE_ROUTER_PROVIDER, displayName: "9router", fetchUsage: fetchNineRouterUsage };
+  if (isCommandCodeModel(model)) return { id: COMMAND_CODE_PROVIDER, displayName: "Command Code", fetchUsage: fetchCommandCodeUsage };
   return undefined;
 }
 
@@ -647,6 +753,8 @@ function renderSubscriptionLine(ctx: ExtensionContext, state: State): void {
     const segments = accountPart ? [accountPart, ...windowParts] : [...windowParts];
     const cost = state.cumulativeCost;
     const hasWindows = windowParts.length > 0;
+    // Command Code monthly balance: compact USD figure, e.g. M:$69.99.
+    if (typeof account?.monthlyCredits === "number") segments.push(`M:$${account.monthlyCredits.toFixed(2)}`);
     if (cost > 0) segments.push(`$${cost.toFixed(2)}`);
     if (state.lastTokPerSec !== undefined) segments.push(`${state.lastTokPerSec} tok/s`);
     if (segments.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacnh85/pi-sub",
-  "version": "0.1.24",
+  "version": "0.1.28",
   "description": "Pi extension showing subscription usage for supported model providers.",
   "type": "module",
   "license": "MIT",
@@ -39,6 +39,6 @@
     "node": ">=20.3.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=0.80.8 <0.84.0"
+    "@earendil-works/pi-coding-agent": ">=0.80.8 <0.85.0"
   }
 }