@bacnh85/pi-sub 0.1.20 → 0.1.22

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to `pi-sub` will be documented in this file.
+
+## 0.1.22 (2026-07-30)
+
+### Improvements
+
+- Patch version bump for release sync and package documentation update.
+
+## 0.1.21 (2026-07-24)
+
+### Features
+
+- Added 9router adapter for tokens per second (tok/s) and endpoint display.
+- Cleared stale context on session shutdown to prevent crashes on `/new`.
+
+## 0.1.15 (2026-07-16)
+
+### Features
+
+- Added `zai-coding-cn` (Z.ai China / open.bigmodel.cn) usage monitoring.
+- Surfaced Z.ai MCP/month + per-model usage in `/sub` detail view.
+
+## 0.1.10 (2026-07-10)
+
+### Features
+
+- Added tok/s (tokens per second) display for response speed tracking.
+
+## 0.1.0 (2026-07-05)
+
+### Features
+
+- Initial release of `pi-sub` subscription usage footer extension.

package/README.md

@@ -1,4 +1,4 @@
-# pi-sub
+# @bacnh85/pi-sub
 
 Pi extension that shows subscription usage for the currently selected supported model provider.
 
@@ -6,20 +6,10 @@ Supports OpenAI Codex (`openai-codex`) with live usage windows from ChatGPT's us
 
 ## Install
 
-From npm after the package is published:
-
 ```bash
 pi install npm:@bacnh85/pi-sub
 ```
 
-From this repository checkout:
-
-```bash
-pi install ./pi-sub
-# or test directly
-pi -e ./pi-sub
-```
-
 ## What it shows
 
 ### OpenAI Codex
@@ -61,6 +51,14 @@ The built-in `zai-coding-cn` provider targets the domestic BigModel endpoint (`o
 (Z.ai (CN) key#1a2b3c4d) R:55%/2H W:80%/3D 42 tok/s
 ```
 
+### 9router
+
+9router is a proxy/router with no upstream usage API, so the footer shows the configured endpoint and last response speed:
+
+```text
+9router (172.30.55.22:20128) 145 tok/s
+```
+
 ### 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.
@@ -137,6 +135,10 @@ Refreshes are cached briefly to avoid excessive usage endpoint calls.
 - 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`.
 - `pi-sub` redacts auth/token-related errors and never prints credentials.
 
+## Changelog
+
+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).

package/extensions/index.ts

@@ -1,5 +1,6 @@
 import { readStoredCredential, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { createHash } from "node:crypto";
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
@@ -15,6 +16,8 @@ const ZAI_PROVIDER = "zai";
 const ZAI_USAGE_URL = "https://api.z.ai/api/monitor/usage/quota/limit";
 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");
 
 type ModelLike = { provider?: string; id?: string } | undefined;
 
@@ -110,6 +113,10 @@ function isZaiCodingCnModel(model: ModelLike): boolean {
   return (model?.provider?.toLowerCase() ?? "") === ZAI_CODING_CN_PROVIDER;
 }
 
+function isNineRouterModel(model: ModelLike): boolean {
+  return (model?.provider?.toLowerCase() ?? "") === NINE_ROUTER_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");
@@ -294,6 +301,21 @@ async function readZaiAuth(providerId: string, label: string): Promise<{ key: st
   return { key: entry.key, account: authAccountSnapshot(label, entry) };
 }
 
+// ponytail: duplicated from pi-9router — no shared config lib, 8 lines, acceptable
+function readNineRouterConfig(): { baseUrl: string; apiKey?: string } | null {
+  try {
+    const exists = (p: string) => { try { return fs.statSync(p).isFile(); } catch { return false; } };
+    if (!exists(NINE_ROUTER_CONFIG_PATH)) return null;
+    const data = JSON.parse(fs.readFileSync(NINE_ROUTER_CONFIG_PATH, "utf8")) as Record<string, unknown>;
+    const baseUrl = process.env.NINE_ROUTER_BASE_URL || (typeof data.baseUrl === "string" ? data.baseUrl : undefined);
+    const apiKey = process.env.NINE_ROUTER_API_KEY || (typeof data.apiKey === "string" ? data.apiKey : undefined);
+    if (!baseUrl || typeof baseUrl !== "string") return null;
+    return { baseUrl, apiKey };
+  } catch {
+    return null;
+  }
+}
+
 async function fetchUsageFromPiAuth(entry: PiAuthEntry, signal?: AbortSignal): Promise<UsageApiSnapshot | undefined> {
   const accountId = getCodexAccountId(entry) ?? entry.accountId;
   if (!accountId) throw new Error("Missing openai-codex OAuth entry in Pi auth");
@@ -364,6 +386,31 @@ async function fetchOpenCodeGoUsage(_signal?: AbortSignal): Promise<Subscription
   }
 }
 
+async function fetchNineRouterUsage(_signal?: AbortSignal): Promise<SubscriptionUsageSnapshot> {
+  const cfg = readNineRouterConfig();
+  const now = Date.now();
+  if (!cfg) {
+    return {
+      providerDisplayName: "9router",
+      accounts: [],
+      fetchedAt: now,
+      error: "9router not configured — run /login-9router",
+    };
+  }
+  const account: SubscriptionAccountSnapshot = {
+    id: cfg.baseUrl,
+    isActive: true,
+    accountLabel: cfg.baseUrl.replace(/^https?:\/\//, ""),
+    lastActivity: "Now",
+  };
+  return {
+    providerDisplayName: "9router",
+    accounts: [account],
+    activeAccount: account,
+    fetchedAt: now,
+  };
+}
+
 // ---------------------------------------------------------------------------
 // Z.ai adapter
 // ---------------------------------------------------------------------------
@@ -552,6 +599,7 @@ function supportedAdapter(model: ModelLike): SubscriptionProviderAdapter | undef
   if (isOpenCodeGoModel(model)) return { id: OPC_PROVIDER, displayName: "OpenCode Go", fetchUsage: fetchOpenCodeGoUsage };
   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 };
   return undefined;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacnh85/pi-sub",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "Pi extension showing subscription usage for supported model providers.",
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,7 @@
   ],
   "files": [
     "README.md",
+    "CHANGELOG.md",
     "extensions/index.ts",
     "extensions/package.json"
   ],