@bacnh85/pi-sub 0.1.32 → 0.1.33

package/CHANGELOG.md

@@ -4,9 +4,9 @@
   instead of the misleading aggregate windows (R:100%/5H W:0%/2D). Credit-based
   upstreams report "Unavailable" session/weekly in the usage text; pi-sub now
   recognizes that shape and fetches `credits_usd` from the management usage
-  API. Needs `ROUTER_MGMT_TOKEN` (an `oma_` CLI token or manage-scope key) in
-  env / `~/.pi/agent/.env.local`; without it, the footer degrades to the clean
-  endpoint display (no aggregate leak).
+  API — grant the router key the `manage` scope in the OmniRoute dashboard
+  (done), or set `ROUTER_MGMT_TOKEN`. Without it, the footer degrades to the
+  clean endpoint display (no aggregate leak).
 - The plain-retry fallback (drop `?provider=`) now fires only on "No cached
   usage data" (wrong/unknown slug), not on "Unavailable" windows.
 - pi-sub now reads `.env.local`/`.env` (cwd then `~/.pi/agent`) for its own
@@ -66,6 +66,12 @@
 
 # Changelog
 
+## 0.1.33 (2026-08-29)
+
+### Added
+
+- `/sub` argument completion offers `refresh`.
+
 ## 0.1.29 (2026-08-15)
 
 ### Features

package/extensions/index.ts

@@ -362,11 +362,13 @@ function routerOrigin(baseUrl: string): string {
   return baseUrl.replace(/\/v1\/?$/, "");
 }
 
-/** OmniRoute management token (oma_ CLI token or manage-scope key) from env —
- *  unlocks /api/usage/<connectionId> which carries the raw USD balance for
- *  credit-based upstreams (deepseek) that the key-authable endpoints strip. */
-function readRouterMgmtToken(): string | undefined {
-  return process.env.ROUTER_MGMT_TOKEN || process.env.OMNIROUTE_MGMT_TOKEN || undefined;
+/** OmniRoute management credential (manage-scope key or oma_ CLI token) from
+ *  env — optional override. The router key itself works when it holds the
+ *  `manage` scope (API Keys dashboard), which unlocks
+ *  /api/usage/<connectionId> carrying the raw USD balance for credit-based
+ *  upstreams (deepseek) that the key-authable endpoints normalize away. */
+function readRouterMgmtToken(apiKey: string | undefined): string | undefined {
+  return process.env.ROUTER_MGMT_TOKEN || process.env.OMNIROUTE_MGMT_TOKEN || apiKey;
 }
 
 /** Parse OmniRoute's `/api/usage/om-usage` plain-text report into windows.
@@ -667,15 +669,15 @@ interface RouterCredits {
 
 /** Fetch the raw USD balance for credit-based upstreams (deepseek: `credits_usd`)
  *  via OmniRoute's management usage API. Only called when the key-authable
- *  om-usage text reports no usable windows — the API-key surface normalizes
- *  credits to meaningless percentages, so this needs ROUTER_MGMT_TOKEN.
- *  Uses connection discovery from /api/v1/me/status (key-authable) +
- *  /api/usage/<id> (management token). */
+ *  om-usage text reports no usable windows — that surface normalizes credits
+ *  to meaningless percentages. Needs the router key to hold the `manage`
+ *  scope (or ROUTER_MGMT_TOKEN as override). Connection discovery comes from
+ *  /api/v1/me/status (key-authable); the balance from /api/usage/<id>. */
 async function fetchRouterCredits(provider: string | undefined, w: ReturnType<typeof parseOmniUsageText>): Promise<RouterCredits | undefined> {
   if (!provider || w.session || w.providerWeekly) return undefined;
   const cfg = readRouterConfig();
   const apiKey = readRouterApiKey();
-  const mgmtToken = readRouterMgmtToken();
+  const mgmtToken = readRouterMgmtToken(apiKey);
   if (!cfg || !apiKey || !mgmtToken) return undefined;
   const origin = routerOrigin(cfg.baseUrl);
   try {
@@ -1293,6 +1295,12 @@ export default function (pi: ExtensionAPI) {
 
   pi.registerCommand("sub", {
     description: "Show subscription usage for the current supported model provider (use /sub refresh to force refresh).",
+    getArgumentCompletions: (prefix) => {
+      const items = ["refresh"]
+        .filter((k) => k.startsWith(String(prefix || "").trim().toLowerCase()))
+        .map((k) => ({ value: k, label: k, description: "force refresh" }));
+      return items.length > 0 ? items : null;
+    },
     handler: async (args, ctx) => {
       updateActiveAdapter(ctx, state, ctx.model);
       const command = args.trim().toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacnh85/pi-sub",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "description": "Pi extension showing subscription usage for supported model providers.",
   "type": "module",
   "license": "MIT",