@narumitw/pi-usage 0.62.0 → 0.63.1

package/README.md

@@ -4,7 +4,7 @@
 
 Inspect usage and DeepSeek API balance for Pi's active provider account, query other configured providers, and toggle Fast mode for supported OpenAI Codex models.
 The extension keeps each provider's native quota, allowance, and spending semantics instead of treating unlike values as equivalent.
-Native `openai` ChatGPT OAuth shows authentication status and a usage-settings link by default; experimental companion quota reporting requires explicit opt-in.
+Native `openai` ChatGPT OAuth automatically reports plan usage through a valid same-account Codex companion login; without that login it shows authentication status and a usage-settings link.
 xAI OAuth subscription reporting follows the reviewed Grok Build contract and runs only after an explicit `/usage` action.
 
 ## ✨ Features
@@ -50,7 +50,7 @@ The package declares `dist/index.ts`, so an unbuilt local checkout must run the
 Run `/usage` in TUI or RPC mode to inspect the active provider, refresh its usage, or choose another configured provider.
 When a provider exposes several billing targets, `/usage` asks for one target before querying usage.
 Run `/fast` to toggle Fast mode for a supported active Codex model.
-For native `/login openai`, select an `openai` model and run `/usage` to verify ChatGPT authentication and find [ChatGPT usage settings](https://chatgpt.com/settings/usage).
+For native `/login openai`, select an `openai` model and run `/usage`. A same-account/workspace `/login openai-codex` supplies [companion usage](#chatgpt-companion-usage) automatically without changing native inference.
 Native OpenAI Fast mode and earned reset redemption are not implemented; those actions remain specific to legacy `openai-codex`.
 
 ## 💬 Commands
@@ -70,7 +70,7 @@ Read the [query and reset guide](./docs/operations.md) for target selection, can
 
 ## ⚙️ Settings
 
-Choose **Settings** in `/usage` to edit Codex Fast mode, percentage display, reset countdown, and experimental ChatGPT companion usage through Pi's settings-list interaction in TUI mode.
+Choose **Settings** in `/usage` to edit Codex Fast mode, percentage display, and reset countdown through Pi's settings-list interaction in TUI mode.
 RPC mode reports the active manual settings path instead of opening terminal UI.
 
 These preferences live in `pi-usage.json` under Pi's user agent directory, normally `~/.pi/agent/pi-usage.json`.
@@ -85,33 +85,29 @@ Target selections are stored only as IDs in the provider-neutral `selectedTarget
 The former `fireworksAccountId` field remains read-compatible: it supplies `selectedTargets.fireworks` in memory only when the generic value is absent.
 A successful explicit Fireworks account selection writes the generic field and removes the legacy field atomically; ordinary reads do not rewrite the file.
 
-### Experimental ChatGPT companion usage
+### ChatGPT companion usage
 
-**Experimental:** this read-only feature uses undocumented ChatGPT backend endpoints. Live numerical agreement has not been independently verified; endpoint changes can make reporting unavailable.
+**Experimental source:** this read-only feature uses undocumented ChatGPT backend endpoints that may change without notice.
+A user observed the plan weekly remaining percentage and reset time matching the ChatGPT overview; app percentages and broader account/window agreement remain unverified.
 
 Keep `/login openai` for native inference, then run `/login openai-codex` with the **same ChatGPT account and workspace**.
-Enable **Experimental ChatGPT companion usage** in Settings and accept its disclosure.
-The confirmation returns to the same settings row; exit Settings to refresh the report and footer without `/reload`.
-Declining or cancelling confirmation leaves the preference unchanged.
-Alternatively, explicitly set this user-level preference and run `/reload`:
+After native OAuth validation, companion usage is automatic on queries and scheduled refreshes; there is no enablement setting or confirmation.
+This intentionally replaces the former default-off experimental opt-in.
+Existing `openaiCompanionUsage` values, including `false`, are ignored and preserved as unrelated JSON during other settings saves; reads do not rewrite the file.
+Remove the companion login if you do not want this automatic companion query path.
 
-```json
-{
-  "openaiCompanionUsage": true
-}
-```
-
-The preference defaults to `false`; there is no project or environment override.
 The extension sends only the independently validated companion bearer and account ID to ChatGPT, never the native token.
 It requires exactly one app registration matching the native grant's client ID, but that match is **not independent proof of shared identity**.
 
-Reports and the statusline keep shared **plan limits** and **app limits** separate, including their reset times.
-**App allowance** is a cap on shared plan usage, not remaining quota or a reserved pool.
+The statusline shows only shared **plan limits**, with percentages and reset times/window labels.
+Detailed reports also show **app limits** with reset times/window labels only.
+App used/remaining percentages are hidden, but their backend data remains validated.
+**App allowance** is a separately labeled cap on shared plan usage, not remaining quota or a reserved pool.
 Codex percentage/countdown preferences do not change this native report.
 No reset tickets are listed or redeemed, and no allowance is changed.
 
 Missing companion login preserves web-only setup guidance; invalid credentials, missing/duplicate registrations, unsupported pagination, malformed responses, and endpoint failures report unavailable data instead of guessed or stale quota.
-Turn the setting Off or remove the companion login to restore web-only reporting without changing native inference.
+Removing the companion login restores web-only reporting without changing native inference.
 
 ### Codex Fast mode
 
@@ -159,7 +155,7 @@ Currencies and billing targets remain separate.
 
 | Provider | Reported data |
 | --- | --- |
-| OpenAI (native ChatGPT OAuth) | Authentication status by default; opt-in experimental companion-sourced plan/app windows and resets |
+| OpenAI (native ChatGPT OAuth) | Automatic companion-sourced plan percentages and plan/app resets; authentication status when companion login is absent |
 | OpenAI Codex (legacy) | Subscription windows, credits, resets, and model buckets |
 | Kimi For Coding | Plan request windows and a separate booster wallet |
 | Moonshot AI Global/China | Current API balance in USD/CNY |
@@ -202,8 +198,8 @@ MiniMax publishes Token Plan window percentages or the regional pay-as-you-go av
 Baseten publishes the exact trailing 30-day Model APIs net subtotal after credits.
 xAI is always menu-only and never starts a scheduled status refresh.
 Z.AI statusline usage refreshes every five minutes while the selected model remains on Z.AI.
-Verified native OpenAI OAuth publishes `chatgpt usage: web only` by default; its five-minute refresh revalidates authentication locally without calling a usage endpoint.
-With companion usage enabled, refreshes query both read-only endpoints and publish distinct remaining values, for example `chatgpt plan 70% ↻ 2h30m · app 80% ↻ 3d`.
+Verified native OpenAI OAuth with valid companion auth refreshes both read-only endpoints automatically, for example `chatgpt plan 70% ↻ 2h30m`.
+Without companion auth it publishes `chatgpt usage: web only`; refreshes revalidate auth without calling a usage endpoint.
 OpenAI API-key auth clears this status.
 
 Queries for another provider or all providers never publish their results to the statusline.
@@ -235,9 +231,9 @@ The protocols carry no account name or extension identity.
 Only the selected provider's exact runtime match is used, and secrets are sent only to its validated official origin.
 Native OpenAI status requires fresh Pi OAuth resolution and a matching complete ChatGPT grant, including the direct-token scope and client ID.
 Model-level Authorization overrides cannot inherit subscription status from a stored login.
-Default native status sends no usage request, and native tokens are never forwarded to ChatGPT backend endpoints.
-The opt-in companion path sends only its validated Codex bearer and matching account ID to fixed `GET /backend-api/wham/usage/chatpass/apps` and `GET /backend-api/wham/usage` routes on `https://chatgpt.com`, rejects redirects, and bounds response sizes and request time.
-Both credential identities and the enabled setting bind cache identity and request-boundary revalidation.
+Native tokens are never forwarded to ChatGPT backend endpoints.
+The automatic companion path sends only its validated Codex bearer and matching account ID to fixed `GET /backend-api/wham/usage/chatpass/apps` and `GET /backend-api/wham/usage` routes on `https://chatgpt.com`, rejects redirects, and bounds response sizes and request time.
+Both credential identities and native registration metadata bind cache identity and request-boundary revalidation.
 DeepSeek balance requests require Bearer authentication, send only that resolved credential from Pi's runtime auth to `https://api.deepseek.com/user/balance`, and refuse redirects.
 Fireworks spend requests send only that resolved credential to the official `https://api.fireworks.ai` account-listing and billing-summary endpoints and refuse redirects.
 Moonshot balance requests send only the resolved Bearer credential to the matching official Global or China balance origin and refuse redirects.
@@ -252,7 +248,7 @@ An absent or incompatible peer preserves standalone fallback and fail-closed mis
 ## 🚧 Limitations
 
 - Numerical usage requires a meaningful provider usage source and verifiable Pi runtime auth.
-- Native `openai` has no verified native-token numerical quota API. Experimental companion reports require same-account setup, cannot independently prove shared identity, and reject incomplete/paginated app lists. Live availability and dashboard agreement remain unverified.
+- Native `openai` has no verified native-token numerical quota API. Experimental companion reports require same-account setup, cannot independently prove shared identity, and reject incomplete/paginated app lists. Only one user-reported plan weekly comparison has been observed; app agreement and broader live behavior remain unverified.
 - Native Fast mode and earned reset redemption, and OpenAI API-key usage reporting, remain unsupported.
 - GitHub Copilot quota, Kimi managed usage, Z.AI quota, and OpenAI Codex reset redemption rely on provider-owned endpoints that may change without notice.
 - Codex reset redemption requires a current ChatGPT OAuth credential from Pi's login or a compatible credential source; Codex API keys cannot redeem earned subscription resets.

package/dist/chunks/{chunk-WEXCFYZX.ts → chunk-ENCC7IBP.ts}

@@ -1356,7 +1356,7 @@ var OPENAI_CHATGPT_ADAPTER = {
   invalidateCacheOnFailure: true,
   async query(auth, signal, timeoutMs, guard) {
     if (auth.openaiCompanion) {
-      const { queryOpenAICompanionUsage } = await import("./openai-companion-usage-Y3WTMUB2.ts");
+      const { queryOpenAICompanionUsage } = await import("./openai-companion-usage-4NOBHGP7.ts");
       signal.throwIfAborted();
       return queryOpenAICompanionUsage(auth, signal, timeoutMs, guard);
     }
@@ -1373,11 +1373,9 @@ var OPENAI_CHATGPT_ADAPTER = {
       buckets: [],
       metrics: [{ id: "plan-auth", label: "ChatGPT plan authentication", value: "Connected (native OAuth)" }],
       notes: [
-        "Numerical usage and reset times are unavailable in pi-usage for native OpenAI OAuth.",
+        "Numerical usage requires a companion /login openai-codex with the same ChatGPT account/workspace; native inference stays on openai.",
         `Manage usage: ${CHATGPT_USAGE_SETTINGS_URL}`,
-        ...auth.openaiCompanionEnabled ? [
-          "Experimental companion usage requires /login openai-codex with the same ChatGPT account/workspace; native inference stays on openai."
-        ] : [],
+        "Companion usage uses undocumented ChatGPT endpoints; registration matching is not independent identity proof.",
         "Fast mode and earned reset redemption remain legacy openai-codex features."
       ]
     };
@@ -2361,7 +2359,7 @@ function adapterForProvider(providerId) {
 function isStaleExtensionContextError(error) {
   return error instanceof Error && error.message.includes("This extension ctx is stale after session replacement or reload");
 }
-async function resolveUsageAuth(ctx, adapter, salt = AUTH_FINGERPRINT_SALT, credentialReader = readStoredCredential2, candidateReader, openaiCompanionUsage = false) {
+async function resolveUsageAuth(ctx, adapter, salt = AUTH_FINGERPRINT_SALT, credentialReader = readStoredCredential2, candidateReader, _openaiCompanionUsage) {
   if (ctx.model?.provider === adapter.id && !hasOfficialOrigin(ctx.model, adapter.id)) {
     throw new Error(
       `${adapter.displayName} usage cannot send a custom provider base URL credential to the official usage endpoint.`
@@ -2448,8 +2446,7 @@ async function resolveUsageAuth(ctx, adapter, salt = AUTH_FINGERPRINT_SALT, cred
     const native = finalize(
       resolveOpenAIChatGPTAuth(auth, providerResult.auth, providerResult.source, model, offered.candidates)
     );
-    if (!openaiCompanionUsage) return native;
-    const { resolveOpenAICompanionAuth } = await import("./openai-companion-auth-Q456G46T.ts");
+    const { resolveOpenAICompanionAuth } = await import("./openai-companion-auth-6VLPFVHF.ts");
     return resolveOpenAICompanionAuth(ctx, native, salt, credentialReader, candidateReader);
   }
   if (adapter.id === "github-copilot") {
@@ -3002,4 +2999,4 @@ export {
   providerIsConfigured,
   fetchProviderJson
 };
-//# sourceMappingURL=chunk-WEXCFYZX.ts.map
+//# sourceMappingURL=chunk-ENCC7IBP.ts.map