@bitkyc08/opencodex 2.100.1 → 2.100.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (624) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/Tray-BV4ms9U9.js +1 -0
  6. package/gui/dist/assets/{brand-mark-nr3ziR-T.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/index-DQtCRNAw.css +2 -0
  9. package/gui/dist/assets/{segment-thumb-features-DKCVUUTi.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-BedmOsE7.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/quota-summary-Dy5_wfTT.js +1 -0
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +6 -4
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/native-exec.ts +3 -2
  38. package/src/adapters/cursor/protobuf-request.ts +8 -8
  39. package/src/adapters/cursor/tool-guidance.ts +3 -3
  40. package/src/adapters/cursor/tool-wording.ts +10 -1
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/tool-schema.ts +20 -2
  43. package/src/adapters/google-antigravity-wire.ts +15 -6
  44. package/src/adapters/google-truncation.ts +4 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +17 -4
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/openai-chat/tool-schema.ts +9 -0
  54. package/src/adapters/openai-responses/tool-schema.ts +18 -4
  55. package/src/adapters/run-turn-queue.ts +139 -5
  56. package/src/adapters/upstream-http-error.ts +4 -2
  57. package/src/adapters/zed.ts +3 -0
  58. package/src/advisor/consult.ts +15 -4
  59. package/src/advisor/context.ts +12 -3
  60. package/src/advisor/runtime.ts +35 -5
  61. package/src/advisor/settings.ts +8 -0
  62. package/src/advisor/synthetic-tool.ts +21 -8
  63. package/src/bridge/response-json.ts +11 -2
  64. package/src/bridge/sse.ts +51 -9
  65. package/src/claude/auth-detect.ts +21 -33
  66. package/src/claude/chat-tool-dispatch.ts +233 -0
  67. package/src/claude/desktop-3p.ts +11 -5
  68. package/src/claude/desktop-gateway-state.ts +2 -0
  69. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  70. package/src/claude/desktop-remote-store.ts +24 -4
  71. package/src/claude/inbound-content-options.ts +31 -16
  72. package/src/claude/inbound-tool-loading.ts +42 -17
  73. package/src/claude/outbound.ts +13 -3
  74. package/src/cli/account-api.ts +23 -1
  75. package/src/cli/account-auth.ts +54 -21
  76. package/src/cli/account-extended.ts +60 -6
  77. package/src/cli/account-key-quota.ts +56 -7
  78. package/src/cli/account.ts +5 -3
  79. package/src/cli/advisor.ts +7 -4
  80. package/src/cli/alias.ts +38 -1
  81. package/src/cli/capabilities-access-remote.ts +137 -2
  82. package/src/cli/capabilities-accounts.ts +3 -3
  83. package/src/cli/capabilities-agents-routing.ts +17 -10
  84. package/src/cli/capabilities-base.ts +43 -18
  85. package/src/cli/capabilities-integrations.ts +2 -2
  86. package/src/cli/capabilities-provider-models.ts +18 -2
  87. package/src/cli/capabilities-route-to.ts +43 -0
  88. package/src/cli/capabilities.ts +2 -0
  89. package/src/cli/capability-contracts.ts +1 -1
  90. package/src/cli/claude-desktop.ts +30 -11
  91. package/src/cli/claude.ts +36 -17
  92. package/src/cli/codex-launcher.ts +3 -1
  93. package/src/cli/codex-shim-autorestore.ts +5 -42
  94. package/src/cli/config-command.ts +38 -2
  95. package/src/cli/config-root-startup.ts +34 -0
  96. package/src/cli/connect.ts +124 -19
  97. package/src/cli/desktop-runtime-guidance.ts +1 -1
  98. package/src/cli/disconnect-runtime.ts +168 -0
  99. package/src/cli/dispatch.ts +54 -12
  100. package/src/cli/export-command.ts +1 -1
  101. package/src/cli/gui-pair-client.ts +29 -5
  102. package/src/cli/gui.ts +10 -5
  103. package/src/cli/help-catalog.ts +11 -0
  104. package/src/cli/help.ts +5 -4
  105. package/src/cli/hub.ts +18 -1
  106. package/src/cli/index.ts +83 -92
  107. package/src/cli/inspect.ts +11 -2
  108. package/src/cli/integrations.ts +26 -1
  109. package/src/cli/link-capture.ts +64 -0
  110. package/src/cli/link-child-ops.ts +314 -0
  111. package/src/cli/link-cleanup.ts +8 -5
  112. package/src/cli/link-diagnostics.ts +67 -0
  113. package/src/cli/link-enrollment.ts +158 -12
  114. package/src/cli/link-operations.ts +52 -0
  115. package/src/cli/link-recover.ts +152 -0
  116. package/src/cli/link-routes.ts +87 -0
  117. package/src/cli/link-status-child.ts +137 -0
  118. package/src/cli/link-status-traffic.ts +34 -0
  119. package/src/cli/link.ts +327 -37
  120. package/src/cli/message-command.ts +1 -1
  121. package/src/cli/message-mcp-command.ts +23 -10
  122. package/src/cli/models-runtime.ts +3 -3
  123. package/src/cli/opencode.ts +3 -1
  124. package/src/cli/pi-sync.ts +35 -0
  125. package/src/cli/preflight-exemptions.ts +46 -0
  126. package/src/cli/registry.ts +29 -12
  127. package/src/cli/restart-failure.ts +5 -2
  128. package/src/cli/root.ts +5 -1
  129. package/src/cli/route-to.ts +172 -0
  130. package/src/cli/runtime-api.ts +5 -8
  131. package/src/cli/status.ts +3 -1
  132. package/src/cli/stop-approval.ts +66 -19
  133. package/src/cli/stop-report.ts +23 -0
  134. package/src/cli/stop-windows-checked.ts +304 -0
  135. package/src/cli/sync-command.ts +70 -13
  136. package/src/cli/sync-fanout.ts +81 -99
  137. package/src/cli/sync-flags.ts +40 -3
  138. package/src/cli/sync-link-status.ts +18 -2
  139. package/src/cli/sync-update-guard.ts +7 -2
  140. package/src/cli/system-restart-client.ts +3 -2
  141. package/src/cli/uninstall-plan.ts +77 -5
  142. package/src/cli/uninstall-stop.ts +152 -0
  143. package/src/cli/v2-input.ts +10 -6
  144. package/src/cli/v2-local-output.ts +3 -2
  145. package/src/cli/v2-runtime.ts +10 -3
  146. package/src/cli/v2.ts +22 -7
  147. package/src/client/connect.ts +321 -34
  148. package/src/client/link-home-features.ts +27 -0
  149. package/src/client/link-home.ts +92 -4
  150. package/src/client/link-ingress.ts +21 -3
  151. package/src/client/link-join.ts +12 -2
  152. package/src/client/link-parity-reporter.ts +60 -6
  153. package/src/client/link-readiness.ts +16 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel-status.ts +76 -0
  161. package/src/client/link-tunnel.ts +56 -5
  162. package/src/client/link-websocket-limits.ts +89 -0
  163. package/src/client/link-websocket.ts +586 -0
  164. package/src/client/link-ws-advertisement.ts +100 -0
  165. package/src/client/link-ws-framer.ts +241 -0
  166. package/src/client/link-ws-transport.ts +177 -0
  167. package/src/client/machine-api.ts +13 -2
  168. package/src/client/machine-listener.ts +48 -7
  169. package/src/client/route-intent-apply.ts +293 -0
  170. package/src/client/route-intent-file-originals.ts +97 -0
  171. package/src/client/route-intent-native-originals.ts +201 -0
  172. package/src/client/route-intent-watch.ts +141 -0
  173. package/src/client/runtime-restart.ts +127 -5
  174. package/src/client/runtime.ts +61 -15
  175. package/src/client/state.ts +30 -0
  176. package/src/client/sync-expectation.ts +36 -2
  177. package/src/client/sync-runtime.ts +7 -0
  178. package/src/clients/config-export/alias-selectors.ts +63 -40
  179. package/src/clients/config-export/contracts.ts +2 -0
  180. package/src/clients/config-export/nested-selectors.ts +42 -0
  181. package/src/clients/config-export.ts +36 -4
  182. package/src/codex/account-resume-health.ts +41 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/login-flow.ts +6 -0
  187. package/src/codex/auth-api/routes.ts +35 -2
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +21 -6
  190. package/src/codex/catalog/gather-capture.ts +10 -2
  191. package/src/codex/catalog/parsing.ts +7 -3
  192. package/src/codex/catalog/provider-models.ts +67 -23
  193. package/src/codex/catalog/retained-sync.ts +2 -1
  194. package/src/codex/catalog/routed-gather.ts +1 -1
  195. package/src/codex/catalog-auto-refresh.ts +11 -0
  196. package/src/codex/cli-update-job.ts +35 -13
  197. package/src/codex/convergence-types.ts +2 -0
  198. package/src/codex/convergence.ts +2 -2
  199. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  200. package/src/codex/features.ts +2 -2
  201. package/src/codex/history-provider.ts +31 -0
  202. package/src/codex/inject/multi-agent-v2.ts +9 -3
  203. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  204. package/src/codex/inject/plan.ts +20 -2
  205. package/src/codex/inject.ts +2 -0
  206. package/src/codex/journal-config-restore.ts +217 -0
  207. package/src/codex/journal.ts +75 -6
  208. package/src/codex/main-account.ts +23 -30
  209. package/src/codex/native-main-auth-file.ts +104 -0
  210. package/src/codex/native-profile-manager.ts +4 -3
  211. package/src/codex/native-profile-store.ts +3 -61
  212. package/src/codex/orca-import.ts +10 -1
  213. package/src/codex/quota-history.ts +13 -0
  214. package/src/codex/quota-window-conflict.ts +103 -0
  215. package/src/codex/quota.ts +134 -7
  216. package/src/codex/subagent-model-fallback.ts +3 -1
  217. package/src/codex/websocket-activity.ts +171 -16
  218. package/src/codex/websocket-registry.ts +11 -4
  219. package/src/combos/cooldown-store.ts +228 -0
  220. package/src/combos/failover.ts +760 -35
  221. package/src/config/dashboard-trusted-proxy.ts +83 -0
  222. package/src/config/diagnostics.ts +28 -0
  223. package/src/config/feature-flags.ts +9 -0
  224. package/src/config/live-reconcile.ts +10 -1
  225. package/src/config/load-degrade.ts +12 -1
  226. package/src/config/multi-agent-surface.ts +28 -5
  227. package/src/config/pending-teardown.ts +60 -3
  228. package/src/config/process-state.ts +175 -4
  229. package/src/config/provider-validation.ts +4 -4
  230. package/src/config/salvage.ts +1 -0
  231. package/src/config/schema/config-schema.ts +12 -3
  232. package/src/config/schema/leaf-validators.ts +43 -14
  233. package/src/config/windows-process-command-line.ts +107 -0
  234. package/src/generated/compatibility-version.json +1077 -429
  235. package/src/generated/model-metadata.ts +1 -1
  236. package/src/images/loop.ts +3 -0
  237. package/src/integrations/model-name-guard.ts +25 -0
  238. package/src/integrations/route-intent-catalog.ts +26 -0
  239. package/src/integrations/route-intent-connected.ts +262 -0
  240. package/src/integrations/route-intent-contract.ts +55 -0
  241. package/src/integrations/route-intent-disconnect.ts +109 -0
  242. package/src/integrations/route-intent-initial.ts +64 -0
  243. package/src/integrations/route-intent-state.ts +117 -0
  244. package/src/integrations/route-intent-tick.ts +65 -0
  245. package/src/integrations/route-intent.ts +212 -0
  246. package/src/integrations/writer.ts +44 -11
  247. package/src/lib/catalog-etag.ts +10 -0
  248. package/src/lib/client-error-body.ts +15 -0
  249. package/src/lib/client-retry-after.ts +29 -0
  250. package/src/lib/config-ownership.ts +13 -0
  251. package/src/lib/context-overflow-verdict.ts +266 -9
  252. package/src/lib/desktop-gui-origin.ts +28 -0
  253. package/src/lib/errors.ts +1 -1
  254. package/src/lib/failure-detail.ts +72 -3
  255. package/src/lib/gui-pair-capability.ts +2 -1
  256. package/src/lib/hard-refusal.ts +259 -0
  257. package/src/lib/messages-error-body.ts +4 -1
  258. package/src/lib/outbound-credential-registry.ts +362 -4
  259. package/src/lib/paced-stream.ts +34 -0
  260. package/src/lib/passive-key-fetch-proof.ts +30 -0
  261. package/src/lib/passive-read.ts +5 -0
  262. package/src/lib/process-control.ts +76 -12
  263. package/src/lib/redact.ts +84 -8
  264. package/src/lib/state-store-registrations.ts +11 -0
  265. package/src/lib/state-store-sweeper.ts +4 -0
  266. package/src/lib/supervisor-markers.ts +18 -0
  267. package/src/lib/terminal-safe-text.ts +58 -0
  268. package/src/lib/translator-budget.ts +3 -2
  269. package/src/lib/upstream-retry.ts +14 -4
  270. package/src/link/alias-lock.ts +119 -0
  271. package/src/link/child-activity.ts +83 -0
  272. package/src/link/child-binary-cache-fill.d.mts +50 -0
  273. package/src/link/child-binary-cache-fill.mjs +494 -0
  274. package/src/link/child-binary-cache-start.ts +73 -0
  275. package/src/link/child-binary-source.ts +12 -5
  276. package/src/link/child-catalog-freshness.ts +149 -0
  277. package/src/link/child-gated-ocx.ts +135 -0
  278. package/src/link/child-observations.ts +206 -0
  279. package/src/link/child-observe.ts +121 -0
  280. package/src/link/child-ops-engine.ts +230 -0
  281. package/src/link/child-ops-host.ts +138 -0
  282. package/src/link/child-ops-runners.ts +319 -0
  283. package/src/link/child-ops-scheduler.ts +207 -0
  284. package/src/link/child-ops-types.ts +89 -0
  285. package/src/link/child-parity.ts +23 -4
  286. package/src/link/child-policy.ts +93 -0
  287. package/src/link/child-update-contract.ts +174 -0
  288. package/src/link/codex-settings.ts +1 -1
  289. package/src/link/compatibility.ts +18 -1
  290. package/src/link/diagnostics-read.ts +163 -0
  291. package/src/link/diagnostics.ts +20 -7
  292. package/src/link/explicit-route.ts +209 -0
  293. package/src/link/link-recover.ts +113 -0
  294. package/src/link/management-routes.ts +3 -1
  295. package/src/link/operation-recovery-slot.ts +44 -0
  296. package/src/link/operations-journal.ts +408 -0
  297. package/src/link/paths.ts +5 -0
  298. package/src/link/peer-report.ts +1 -1
  299. package/src/link/relay-auth.ts +14 -0
  300. package/src/link/remote-plant.ts +152 -14
  301. package/src/link/remote-platform.ts +21 -10
  302. package/src/link/remote-probe.ts +11 -3
  303. package/src/link/remote-windows.ts +88 -12
  304. package/src/link/request-compression.ts +30 -0
  305. package/src/link/residual-recovery.ts +54 -0
  306. package/src/link/retirement.ts +128 -0
  307. package/src/link/route-intent-watch.ts +41 -0
  308. package/src/link/route-intent.ts +209 -0
  309. package/src/link/route-proof.ts +82 -0
  310. package/src/link/route-rounds.ts +579 -0
  311. package/src/link/route-select.ts +95 -0
  312. package/src/link/route-trust.ts +96 -0
  313. package/src/link/ssh-argv.ts +285 -43
  314. package/src/link/ssh-capture-redact.ts +253 -0
  315. package/src/link/ssh-capture.ts +497 -0
  316. package/src/link/ssh-runner.ts +141 -14
  317. package/src/link/status-projection.ts +160 -0
  318. package/src/link/store.ts +54 -1
  319. package/src/link/supervisor.ts +543 -55
  320. package/src/link/sync-fanout-classify.ts +114 -0
  321. package/src/link/sync-then-restart.ts +65 -0
  322. package/src/link/tombstones.ts +209 -0
  323. package/src/link/traffic.ts +178 -0
  324. package/src/link/tunnel-state.ts +10 -4
  325. package/src/link/ws-activity-holds.ts +474 -0
  326. package/src/local-credentials/publication-fence.ts +20 -1
  327. package/src/messaging/mcp-queue-rpc.ts +3 -2
  328. package/src/messaging/mcp-queue-server.ts +21 -1
  329. package/src/messaging/mcp-reply-tools.ts +24 -9
  330. package/src/messaging/mcp-reply-wait.ts +70 -0
  331. package/src/messaging/mcp-resume-tools.ts +25 -0
  332. package/src/messaging/remote-enrollment.ts +3 -3
  333. package/src/messaging/remote-tunnels.ts +2 -2
  334. package/src/messaging/resume-permissions.ts +27 -0
  335. package/src/messaging/rpc.ts +46 -2
  336. package/src/oauth/account-resume-health.ts +60 -0
  337. package/src/oauth/anthropic-continuity.ts +23 -7
  338. package/src/oauth/anthropic-routing.ts +5 -2
  339. package/src/oauth/anthropic.ts +22 -2
  340. package/src/oauth/claude-keychain-read.ts +78 -68
  341. package/src/oauth/index.ts +25 -6
  342. package/src/oauth/local-token-detect.ts +8 -29
  343. package/src/oauth/login-cli-errors.ts +5 -1
  344. package/src/oauth/login-cli.ts +33 -18
  345. package/src/oauth/login-flow-state.ts +26 -3
  346. package/src/oauth/meta-muse.ts +1 -1
  347. package/src/oauth/store.ts +51 -1
  348. package/src/oauth/xai.ts +248 -14
  349. package/src/protocols/contract.ts +4 -0
  350. package/src/protocols/encoders/messages.ts +1 -0
  351. package/src/providers/alias-template.ts +48 -0
  352. package/src/providers/anthropic-billing-ownership.ts +2 -0
  353. package/src/providers/anthropic-output-caps.ts +46 -0
  354. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  355. package/src/providers/antigravity-effort-families.ts +11 -3
  356. package/src/providers/antigravity-models.ts +32 -9
  357. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  358. package/src/providers/api-key-pause-state.ts +23 -0
  359. package/src/providers/api-key-pause.ts +71 -10
  360. package/src/providers/api-key-resolve.ts +49 -7
  361. package/src/providers/api-key-response-ownership.ts +2 -0
  362. package/src/providers/api-key-selection-capture.ts +3 -1
  363. package/src/providers/api-key-selection.ts +54 -11
  364. package/src/providers/api-keys.ts +24 -7
  365. package/src/providers/cache-affinity-identity.ts +73 -0
  366. package/src/providers/cache-affinity.ts +256 -0
  367. package/src/providers/claude-cli-usage-state.ts +11 -6
  368. package/src/providers/claude-cli-usage.ts +27 -9
  369. package/src/providers/codex-capacity.ts +11 -2
  370. package/src/providers/default-aliases.ts +98 -20
  371. package/src/providers/google-vertex-model-discovery.ts +510 -0
  372. package/src/providers/key-failover.ts +136 -14
  373. package/src/providers/key-store.ts +3 -3
  374. package/src/providers/kiro-models.ts +3 -5
  375. package/src/providers/label.ts +31 -5
  376. package/src/providers/mistral-transport.ts +17 -4
  377. package/src/providers/model-discovery-config.ts +31 -0
  378. package/src/providers/model-discovery-diagnostic.ts +34 -3
  379. package/src/providers/model-discovery.ts +43 -7
  380. package/src/providers/model-rename-fields.ts +5 -0
  381. package/src/providers/muse-key-quota.ts +14 -6
  382. package/src/providers/new-model-policy-runtime.ts +17 -4
  383. package/src/providers/new-model-policy.ts +30 -4
  384. package/src/providers/openai-sidecar.ts +15 -2
  385. package/src/providers/passive-key-observation.ts +252 -0
  386. package/src/providers/provider-id-rewrite.ts +3 -0
  387. package/src/providers/quota/account-cache.ts +53 -34
  388. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  389. package/src/providers/quota/anthropic-usage-windows.ts +19 -9
  390. package/src/providers/quota/passive-key-limits.ts +272 -0
  391. package/src/providers/quota/passive-wire-model.ts +126 -0
  392. package/src/providers/quota/report-cache.ts +112 -5
  393. package/src/providers/quota/vendor-probes-key.ts +73 -0
  394. package/src/providers/quota/vendor-probes-oauth.ts +57 -3
  395. package/src/providers/quota-key-accounts.ts +22 -10
  396. package/src/providers/quota-mistral-budget.ts +18 -0
  397. package/src/providers/quota-types.ts +43 -0
  398. package/src/providers/quota.ts +31 -32
  399. package/src/providers/reasoning-metadata.ts +1051 -12
  400. package/src/providers/registry/entries-core.ts +34 -16
  401. package/src/providers/registry/entries-extended.ts +32 -0
  402. package/src/providers/registry/model-seeds.ts +35 -0
  403. package/src/providers/resolved-model-policy.ts +7 -0
  404. package/src/providers/routed-config.ts +8 -3
  405. package/src/providers/xai-transport.ts +3 -0
  406. package/src/quota/reset-observer.ts +4 -2
  407. package/src/quota/reset-seen-store.ts +9 -0
  408. package/src/quota/window-mapping.ts +1 -0
  409. package/src/quota-pool/assemble.ts +4 -1
  410. package/src/remote/features.ts +17 -0
  411. package/src/responses/anthropic-progress.ts +10 -4
  412. package/src/responses/citation-markers.ts +231 -0
  413. package/src/responses/hosted-tool-policy.ts +56 -12
  414. package/src/responses/spill-store.ts +5 -1
  415. package/src/responses/state/replay-input.ts +50 -0
  416. package/src/responses/state/replay-owner.ts +24 -0
  417. package/src/responses/state/snapshot-codec.ts +9 -0
  418. package/src/responses/state/spill-queue.ts +1 -0
  419. package/src/responses/state.ts +42 -60
  420. package/src/router.ts +4 -2
  421. package/src/routing/home-route-capture.ts +123 -0
  422. package/src/routing/home-route-intent.ts +200 -0
  423. package/src/routing/route-intent-state.ts +178 -0
  424. package/src/routing/route-to-live-settings.ts +35 -0
  425. package/src/routing/route-to-local.ts +145 -0
  426. package/src/routing/route-to-status.ts +94 -0
  427. package/src/routing/route-to-sync-child.ts +32 -0
  428. package/src/server/adapter-resolve.ts +21 -1
  429. package/src/server/admitted-http-turn.ts +3 -0
  430. package/src/server/auth-cors.ts +109 -8
  431. package/src/server/bare-upstream-error.ts +220 -0
  432. package/src/server/catalog-download.ts +3 -5
  433. package/src/server/chat-native.ts +25 -7
  434. package/src/server/claude-messages.ts +8 -5
  435. package/src/server/codex-model-list.ts +2 -1
  436. package/src/server/configured-credentials.ts +37 -5
  437. package/src/server/gui-desktop-authorization.ts +36 -0
  438. package/src/server/gui-pair-delivery.ts +6 -3
  439. package/src/server/gui-session.ts +10 -1
  440. package/src/server/images.ts +41 -13
  441. package/src/server/inbound-body-admission.ts +17 -4
  442. package/src/server/index/link-listener.ts +203 -11
  443. package/src/server/index/link-management.ts +15 -1
  444. package/src/server/index/link-relay-sessions.ts +128 -8
  445. package/src/server/index/link-websocket-limits.ts +136 -0
  446. package/src/server/index/link-websocket.ts +692 -0
  447. package/src/server/index/optional-listeners.ts +115 -7
  448. package/src/server/index/route-intent-watch.ts +47 -0
  449. package/src/server/index/serve-contract.ts +86 -0
  450. package/src/server/index/serve-options.ts +35 -86
  451. package/src/server/index/startup-warnings.ts +8 -2
  452. package/src/server/index/websocket-handler.ts +26 -4
  453. package/src/server/index.ts +12 -2
  454. package/src/server/inference/client-encoder-delivery.ts +2 -0
  455. package/src/server/inspection-tee.ts +39 -2
  456. package/src/server/lifecycle.ts +2 -0
  457. package/src/server/link-turn.ts +137 -0
  458. package/src/server/management/advisor-routes.ts +10 -2
  459. package/src/server/management/agent-settings-routes.ts +50 -16
  460. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  461. package/src/server/management/config-routes.ts +7 -1
  462. package/src/server/management/context.ts +9 -2
  463. package/src/server/management/desktop-authorization.ts +41 -0
  464. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  465. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  466. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  467. package/src/server/management/home-integration-decision.ts +89 -0
  468. package/src/server/management/integration-routes.ts +208 -81
  469. package/src/server/management/link-child-ops-routes.ts +218 -0
  470. package/src/server/management/link-child-preflight.ts +31 -0
  471. package/src/server/management/link-diagnostics-route.ts +29 -0
  472. package/src/server/management/link-enrollment.ts +199 -47
  473. package/src/server/management/link-operation.ts +609 -0
  474. package/src/server/management/link-recover-route.ts +103 -0
  475. package/src/server/management/link-route-edit.ts +173 -0
  476. package/src/server/management/link-route-request.ts +62 -0
  477. package/src/server/management/link-route-state.ts +92 -6
  478. package/src/server/management/link-routes.ts +563 -51
  479. package/src/server/management/link-traffic-status.ts +13 -0
  480. package/src/server/management/model-routes.ts +122 -36
  481. package/src/server/management/model-rows.ts +2 -1
  482. package/src/server/management/native-integration-routes.ts +176 -70
  483. package/src/server/management/oauth-account-routes.ts +69 -17
  484. package/src/server/management/protocol-routes.ts +7 -0
  485. package/src/server/management/provider-completion-test.ts +4 -4
  486. package/src/server/management/provider-overwrite-carry.ts +39 -3
  487. package/src/server/management/provider-routes.ts +80 -72
  488. package/src/server/management/provider-routing-quota.ts +45 -0
  489. package/src/server/management/route-registry.ts +25 -3
  490. package/src/server/management/route-to-routes.ts +257 -0
  491. package/src/server/management/system-restart.ts +4 -2
  492. package/src/server/management/usage-aggregate-cache.ts +101 -66
  493. package/src/server/management-api.ts +17 -3
  494. package/src/server/management-auth.ts +13 -1
  495. package/src/server/messages-native-preflight.ts +27 -4
  496. package/src/server/messages-native.ts +22 -5
  497. package/src/server/persistent-gui-session.ts +6 -3
  498. package/src/server/proxy-liveness.ts +33 -6
  499. package/src/server/relay-eager.ts +36 -12
  500. package/src/server/relay.ts +183 -116
  501. package/src/server/request-body-facts.ts +48 -0
  502. package/src/server/request-decompress.ts +65 -2
  503. package/src/server/request-log-account-rotation.ts +6 -0
  504. package/src/server/request-log-attempt-usage.ts +69 -0
  505. package/src/server/request-log-cache-affinity.ts +60 -0
  506. package/src/server/request-log-conversation.ts +45 -2
  507. package/src/server/request-log-failure-detail.ts +59 -1
  508. package/src/server/request-log-terminal-status.ts +210 -24
  509. package/src/server/request-log.ts +71 -79
  510. package/src/server/responses/adapter-continuation.ts +2 -1
  511. package/src/server/responses/adapter-delivery.ts +2 -0
  512. package/src/server/responses/adapter-dispatch.ts +40 -51
  513. package/src/server/responses/advisor-plan-slot.ts +33 -1
  514. package/src/server/responses/advisor-question.ts +21 -0
  515. package/src/server/responses/advisor-slot.ts +10 -3
  516. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  517. package/src/server/responses/buffered-sse-json.ts +9 -3
  518. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  519. package/src/server/responses/codex-tool-catalog.ts +156 -0
  520. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  521. package/src/server/responses/combo-stream-preflight.ts +701 -81
  522. package/src/server/responses/compact.ts +47 -12
  523. package/src/server/responses/context-overflow.ts +58 -2
  524. package/src/server/responses/core-codex-account.ts +17 -3
  525. package/src/server/responses/core-combo-failure.ts +37 -4
  526. package/src/server/responses/core-combo-native.ts +3 -1
  527. package/src/server/responses/core-combo.ts +62 -7
  528. package/src/server/responses/core-errors.ts +8 -3
  529. package/src/server/responses/core-lifetime.ts +3 -2
  530. package/src/server/responses/core-normalize.ts +3 -1
  531. package/src/server/responses/core-opaque-recovery.ts +45 -2
  532. package/src/server/responses/core-options.ts +18 -0
  533. package/src/server/responses/core.ts +2 -0
  534. package/src/server/responses/fetch-helpers.ts +15 -10
  535. package/src/server/responses/native-replay-guard.ts +57 -0
  536. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  537. package/src/server/responses/outbound-request-body.ts +29 -0
  538. package/src/server/responses/passthrough-completion.ts +105 -8
  539. package/src/server/responses/passthrough-delivery.ts +31 -11
  540. package/src/server/responses/passthrough-dispatch.ts +99 -106
  541. package/src/server/responses/policy-fallback.ts +13 -1
  542. package/src/server/responses/request-prepare.ts +50 -6
  543. package/src/server/responses/request-transport.ts +53 -17
  544. package/src/server/responses/reset-replay.ts +104 -4
  545. package/src/server/responses/run-turn-execution.ts +58 -30
  546. package/src/server/responses/sidecar-execution.ts +14 -0
  547. package/src/server/responses/terminal-error-redaction.ts +222 -25
  548. package/src/server/responses/ws-upstream.ts +2 -2
  549. package/src/server/sse-payload-rewrite.ts +3 -2
  550. package/src/server/stop-service-route.ts +85 -0
  551. package/src/server/system-env-shell.ts +12 -1
  552. package/src/server/system-env.ts +5 -3
  553. package/src/server/windows-tcp-drop.ts +21 -4
  554. package/src/server/workflow-refusal.ts +8 -0
  555. package/src/server/ws-bridge.ts +191 -12
  556. package/src/service/cli-windows-stop.ts +189 -0
  557. package/src/service/cli.ts +41 -12
  558. package/src/service/disconnected-client-restart.ts +60 -0
  559. package/src/service/guarded-manager-target.ts +18 -1
  560. package/src/service/health.ts +99 -6
  561. package/src/service/launchd.ts +84 -31
  562. package/src/service/orchestration.ts +418 -91
  563. package/src/service/repair.ts +223 -6
  564. package/src/service/restart-proxy-stop.ts +79 -0
  565. package/src/service/service-child-ownership.ts +6 -2
  566. package/src/service/windows-checked-stop-live.ts +467 -0
  567. package/src/service/windows-checked-stop.ts +435 -0
  568. package/src/service/windows-command-line-token.ts +23 -0
  569. package/src/service/windows-guarded-manager.ts +77 -34
  570. package/src/service/windows-ops.ts +38 -56
  571. package/src/service/windows-process-evidence.ts +292 -0
  572. package/src/service/windows-process-native.ts +262 -0
  573. package/src/service/windows-service-stop.ts +321 -0
  574. package/src/service/windows-stop-binding.ts +187 -0
  575. package/src/service/windows-stop-budget.ts +123 -0
  576. package/src/service/windows-stop-confirm.ts +158 -0
  577. package/src/service/windows-stop-deadline.ts +56 -0
  578. package/src/service.ts +2 -2
  579. package/src/types/claude-tool-loading.ts +48 -0
  580. package/src/types/config.ts +47 -53
  581. package/src/types/link.ts +20 -0
  582. package/src/types/multi-agent.ts +13 -0
  583. package/src/types/provider.ts +68 -2
  584. package/src/types/request.ts +4 -0
  585. package/src/types.ts +4 -0
  586. package/src/update/guarded-runtime-ops.ts +5 -7
  587. package/src/update/index.ts +25 -10
  588. package/src/update/install-detection.mjs +3 -1
  589. package/src/update/job-pinned-start.ts +2 -0
  590. package/src/update/job-windows-restart.ts +19 -32
  591. package/src/update/job.ts +12 -5
  592. package/src/update/npm-install.d.mts +11 -0
  593. package/src/update/npm-install.mjs +44 -7
  594. package/src/update/orchestrated-entry.ts +1 -1
  595. package/src/update/orchestrated-node-driver.mjs +3 -2
  596. package/src/update/orchestrated-pnpm.d.mts +4 -0
  597. package/src/update/orchestrated-pnpm.mjs +50 -6
  598. package/src/update/orchestrated-session.d.mts +3 -1
  599. package/src/update/orchestrated-session.mjs +21 -6
  600. package/src/update/pnpm-global-install.d.mts +21 -3
  601. package/src/update/pnpm-global-install.mjs +322 -19
  602. package/src/update/pnpm-store-layout.mjs +46 -0
  603. package/src/update/sync-update-mutex.d.mts +3 -2
  604. package/src/update/sync-update-mutex.mjs +57 -8
  605. package/src/update/transactional-install.d.mts +3 -1
  606. package/src/update/transactional-install.mjs +545 -12
  607. package/src/update/windows-installer-marker.d.mts +1 -0
  608. package/src/update/windows-installer-marker.mjs +44 -0
  609. package/src/usage/expected-prices.ts +8 -0
  610. package/src/usage/filter-index.ts +326 -77
  611. package/src/usage/ledger-scanner.ts +15 -0
  612. package/src/usage/link-log-fields.ts +48 -0
  613. package/src/usage/log.ts +43 -2
  614. package/src/usage/request-body.ts +37 -0
  615. package/src/web-search/loop.ts +3 -0
  616. package/src/web-search/parse.ts +21 -2
  617. package/gui/dist/assets/App-g3Cm2xhZ.js +0 -59
  618. package/gui/dist/assets/Tray-BMDkAiXy.js +0 -1
  619. package/gui/dist/assets/index-Bziu8gTy.css +0 -2
  620. package/gui/dist/assets/index-OYzhQUNP.js +0 -94
  621. package/gui/dist/classic/assets/App-CgPBKUP-.js +0 -58
  622. package/gui/dist/classic/assets/index-BR-HhNrp.js +0 -94
  623. package/gui/dist/classic/assets/quota-summary-CXKhvSmQ.js +0 -1
  624. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -6,7 +6,9 @@ import { effectiveCodexAuthAccountId, listCodexAuthAccountsSnapshot } from "../.
6
6
  import { CODEX_EXHAUSTED_USAGE_PERCENT, withoutRetiredCodexQuota, type StoredAccountQuota } from "../../codex/quota";
7
7
  import { isMainAccountIdentityGenerationLive } from "../../codex/main-account-cache";
8
8
  import { codexPlanKey } from "../../codex/plan";
9
- import { resolveProviderApiKey } from "../key-store";
9
+ import { isKeychainReference, resolveProviderApiKey } from "../key-store";
10
+ import { passiveKeychainGeneration, peekResolvedProviderKey } from "../api-key-resolve";
11
+ import { resolveEnvValue } from "../../config/proxy-env";
10
12
  import { apiKeyPoolEntryId } from "../api-keys";
11
13
  import { getProviderRegistryEntry, providerCodexAccountMode } from "../registry";
12
14
  import { isCanonicalOpenAiForwardProvider, OPENAI_CODEX_PROVIDER_ID } from "../openai-tiers";
@@ -21,10 +23,70 @@ import type { ProviderQuota, ProviderRoutingQuota } from "../quota-types";
21
23
  export const LAST_GOOD_MAX_AGE_MS = CODEX_CAPACITY_MAX_QUOTA_AGE_MS;
22
24
  const nativeMainReportGenerations = new WeakMap<ProviderQuotaReport, number>();
23
25
  export const accountReportCurrent = new WeakMap<ProviderQuotaReport, () => boolean>();
26
+ const reportOwners = new WeakMap<ProviderQuotaReport, { name: string; signature: string; credentialBound: boolean }>();
27
+ function ownerSignature(provider: OcxProviderConfig, credentialBound = false): string {
28
+ return createHash("sha256").update(JSON.stringify([provider.adapter, provider.baseUrl, provider.authMode ?? "key", credentialBound ? undefined : provider.apiKey, provider.disabled])).digest("hex");
29
+ }
30
+ export function captureReportOwner(name: string, provider: OcxProviderConfig): (report: ProviderQuotaReport) => void {
31
+ const owner = { name, signature: ownerSignature(provider), credentialBound: false };
32
+ return report => { if (!reportOwners.has(report)) reportOwners.set(report, owner); };
33
+ }
34
+ export async function collectOwnedReport(name: string, provider: OcxProviderConfig, probe: () => Promise<ProviderQuotaProbeResult>): Promise<ProviderQuotaProbeResult> {
35
+ const bind = captureReportOwner(name, provider);
36
+ const result = await probe();
37
+ if (result && typeof result !== "symbol") bind(result);
38
+ return result;
39
+ }
40
+ function reportOwnerCurrent(report: ProviderQuotaReport, provider: OcxProviderConfig | undefined, passive = false): boolean {
41
+ const owner = reportOwners.get(report);
42
+ // Only a key-authenticated report depends on the keychain value a passive read cannot verify.
43
+ return !!owner && !!provider && !provider.disabled && owner.name === report.provider
44
+ && !(passive && (provider.authMode ?? "key") === "key" && isKeychainReference(provider.apiKey))
45
+ && owner.signature === ownerSignature(provider, owner.credentialBound);
46
+ }
47
+ /** The measured quota a reset detector should observe when the shown quota is an estimate (pooled rows). */
48
+ export const observedQuotaFor = new WeakMap<ProviderQuotaReport, ProviderQuota>();
24
49
  export const routingEvidence = new WeakMap<ProviderQuotaReport, ProviderQuotaRoutingEvidence>();
50
+ /**
51
+ * Credential identity captured by a probe that opted into binding; never serialized with the
52
+ * report. Only producers whose report must not outlive its credential register here (#8290),
53
+ * so a provider that did not opt in keeps its dev-era cache and join behaviour unchanged.
54
+ */
55
+ export const keyReportCredentialIds = new WeakMap<ProviderQuotaReport, string>();
56
+ const keyReportDestinations = new WeakMap<ProviderQuotaReport, { adapter: string; baseUrl: string }>();
57
+ /**
58
+ * Whether a probe-bound report still describes the provider as it is configured NOW.
59
+ *
60
+ * A report is published only for the credential and destination that produced it. The
61
+ * comparison is a full digest: the 8-character apiKeyPoolEntryId is a cache discriminator,
62
+ * not an identity, and two distinct keys can share it.
63
+ */
64
+ export function keyReportCredentialCurrent(value: ProviderQuotaReport, provider: OcxProviderConfig | undefined, passive = false): boolean {
65
+ const captured = keyReportCredentialIds.get(value);
66
+ if (!captured) return true;
67
+ if (!provider || provider.disabled || (provider.authMode ?? "key") !== "key") return false;
68
+ const destination = keyReportDestinations.get(value);
69
+ if (!destination || destination.adapter !== provider.adapter || destination.baseUrl !== provider.baseUrl) return false;
70
+ // A passive read cannot open the OS keychain or publish credential observations.
71
+ if (passive && isKeychainReference(provider.apiKey)) return false;
72
+ const current = (passive ? resolveEnvValue(provider.apiKey) : resolveProviderApiKey(provider.apiKey))?.trim();
73
+ return !!current && createHash("sha256").update(current).digest("hex") === captured;
74
+ }
75
+ /** Validate joined results against the joining caller's independently mutable configuration. */
76
+ export function validateJoinedReports(response: ProviderQuotaResponse, config: OcxConfig): ProviderQuotaResponse {
77
+ return { ...response, reports: response.reports.filter(item => {
78
+ const provider = config.providers[item.provider];
79
+ return reportOwnerCurrent(item, provider) && isProviderQuotaReportCurrent(item)
80
+ && keyReportCredentialCurrent(item, provider);
81
+ }) };
82
+ }
25
83
  /** Only the live Antigravity probe binds this projection; display/last-good rows cannot create it. */
26
84
  export const antigravityEvidence = new WeakMap<ProviderQuotaReport, { receipt: AntigravityQuotaReceipt; windows: readonly DecisionQuotaWindow[] }>();
27
85
  export let providerQuotaBeforePublishForTests: (() => void | Promise<void>) | null = null;
86
+ export let providerQuotaBeforeObservationForTests: (() => void | Promise<void>) | null = null;
87
+ export function setProviderQuotaBeforeObservationForTests(hook: (() => void | Promise<void>) | null): void {
88
+ providerQuotaBeforeObservationForTests = hook;
89
+ }
28
90
 
29
91
  /** Test-only seam for identity/config invalidation after probes but before publication. */
30
92
  export function setProviderQuotaBeforePublishForTests(
@@ -117,6 +179,38 @@ export function providerReportEpochChanged(captured: ReadonlyMap<string, number>
117
179
  return (providerReportEpochs.get(provider) ?? 0) !== (captured.get(provider) ?? 0);
118
180
  }
119
181
 
182
+ /** Capture publication authority before queued reset observations can yield. */
183
+ export function captureObservationAuthority(config: OcxConfig, reports: readonly ProviderQuotaReport[]): (report: ProviderQuotaReport) => boolean {
184
+ const epoch = invalidationEpoch;
185
+ const providerEpochs = captureProviderReportEpochs();
186
+ const keychainProofs = new Map<ProviderQuotaReport, { reference: string; generation: number } | undefined>();
187
+ for (const report of reports) {
188
+ const reference = config.providers[report.provider]?.apiKey;
189
+ if (!keyReportCredentialIds.has(report) || !isKeychainReference(reference)) continue;
190
+ keychainProofs.set(report, undefined);
191
+ const key = peekResolvedProviderKey(reference);
192
+ const generation = key === undefined ? undefined : passiveKeychainGeneration(reference, key);
193
+ if (key?.trim() && generation !== undefined && createHash("sha256").update(key.trim()).digest("hex") === keyReportCredentialIds.get(report)) {
194
+ keychainProofs.set(report, { reference, generation });
195
+ }
196
+ }
197
+ return report => {
198
+ const provider = config.providers[report.provider];
199
+ const proof = keychainProofs.get(report);
200
+ const key = proof && provider?.apiKey === proof.reference ? peekResolvedProviderKey(proof.reference) : undefined;
201
+ const destination = keyReportDestinations.get(report);
202
+ const keyCurrent = keychainProofs.has(report)
203
+ ? !!proof && !!provider && !provider.disabled && (provider.authMode ?? "key") === "key"
204
+ && destination?.adapter === provider.adapter && destination.baseUrl === provider.baseUrl
205
+ && !!key?.trim() && passiveKeychainGeneration(proof.reference, key) === proof.generation
206
+ && createHash("sha256").update(key.trim()).digest("hex") === keyReportCredentialIds.get(report)
207
+ : keyReportCredentialCurrent(report, provider, true);
208
+ return epoch === invalidationEpoch && !providerReportEpochChanged(providerEpochs, report.provider)
209
+ && reportOwnerCurrent(report, provider) && isProviderQuotaReportCurrent(report)
210
+ && keyCurrent;
211
+ };
212
+ }
213
+
120
214
  /**
121
215
  * Provider-scoped invalidation: drop one provider's report and routing row. The global epoch
122
216
  * is untouched, so another provider's cached row and in-flight commit authority survive; an
@@ -136,6 +230,9 @@ function cacheKey(config: OcxConfig): string {
136
230
  const resolvedKey = typeof provider.apiKey === "string"
137
231
  ? resolveProviderApiKey(provider.apiKey)?.trim()
138
232
  : undefined;
233
+ // The 8-char pool id is a cheap discriminator, not an identity: two keys can share it.
234
+ // A probe-bound report is re-validated against its captured full digest
235
+ // (keyReportCredentialCurrent), so a collision cannot serve the other key's budgets.
139
236
  const activeKeyId = resolvedKey ? apiKeyPoolEntryId(resolvedKey) : "none";
140
237
  return `${name}:${provider.adapter}:${provider.authMode ?? "key"}:${providerCodexAccountMode(name, provider) ?? "none"}:${provider.disabled === true ? "off" : "on"}:${provider.baseUrl}:${activeKeyId}`;
141
238
  })
@@ -266,6 +363,7 @@ export function publicCapacityAggregation(
266
363
  export function hasQuotaRows(quota: ProviderQuota | null | undefined): quota is ProviderQuota {
267
364
  if (!quota) return false;
268
365
  return typeof quota.fiveHourPercent === "number"
366
+ || (quota.unknownBudgetWindows?.length ?? 0) > 0
269
367
  || typeof quota.weeklyPercent === "number"
270
368
  || typeof quota.monthlyPercent === "number"
271
369
  || quota.creditsUsd?.unlimited === true
@@ -321,9 +419,16 @@ export function keyReport(
321
419
  config: OcxProviderConfig,
322
420
  probedCredential: string,
323
421
  inferenceQuota?: ProviderQuota,
422
+ options?: { bindCredential?: boolean },
324
423
  ): ProviderQuotaReport | null {
325
424
  const result = report(provider, source, quota);
326
- if (!result || !inferenceQuota) return result;
425
+ if (!result) return result;
426
+ if (options?.bindCredential === true) {
427
+ keyReportCredentialIds.set(result, createHash("sha256").update(probedCredential).digest("hex"));
428
+ keyReportDestinations.set(result, { adapter: config.adapter, baseUrl: config.baseUrl });
429
+ reportOwners.set(result, { name: provider, signature: ownerSignature(config, true), credentialBound: true });
430
+ }
431
+ if (!inferenceQuota) return result;
327
432
  const binding = providerQuotaRoutingBinding(provider, config, probedCredential);
328
433
  if (binding) routingEvidence.set(result, { quota: inferenceQuota, binding });
329
434
  return result;
@@ -386,11 +491,13 @@ export function publishCollectedDecisionQuota(reports: ProviderQuotaReport[], co
386
491
  * no probe, token refresh, account snapshot or publication into routing evidence. The Home's own
387
492
  * dashboard and traffic keep the cache current.
388
493
  */
389
- export function heldProviderQuotaReports(configuredProviders: readonly string[]): ProviderQuotaResponse {
494
+ export function heldProviderQuotaReports(config: OcxConfig): ProviderQuotaResponse {
390
495
  const held = getProviderQuotaReportCache()?.response;
391
- const configured = new Set(configuredProviders);
392
496
  return {
393
497
  generatedAt: held?.generatedAt ?? Date.now(),
394
- reports: (held?.reports ?? []).filter(item => configured.has(item.provider) && isProviderQuotaReportCurrent(item)),
498
+ reports: (held?.reports ?? []).filter(item => {
499
+ const provider = config.providers[item.provider];
500
+ return reportOwnerCurrent(item, provider, true) && isProviderQuotaReportCurrent(item) && keyReportCredentialCurrent(item, provider, true);
501
+ }),
395
502
  };
396
503
  }
@@ -15,6 +15,7 @@ import {
15
15
  } from "./report-cache";
16
16
  import { getTokenForAccountQuotaProbe } from "./account-cache";
17
17
  import type { AccountQuotaMode, ProviderQuota, ProviderQuotaCreditsUsd } from "../quota-types";
18
+ import { markDisplayOnlyQuota } from "../quota-types";
18
19
  import type { OcxProviderConfig } from "../../types";
19
20
 
20
21
  // A quota probe must use the provider's inference route so it neither reports a false healthy path nor leaks a key through another exit.
@@ -41,6 +42,7 @@ const OPENCODE_GO_BASE_URL = "https://opencode.ai/zen/go/v1";
41
42
  const OPENCODE_GO_USAGE_URL = `${OPENCODE_GO_BASE_URL}/usage`;
42
43
  const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
43
44
  const DEEPSEEK_BASE_URL = "https://api.deepseek.com";
45
+ const MISTRAL_BASE_URL = "https://api.mistral.ai";
44
46
  const CLINE_BASE_URL = "https://api.cline.bot";
45
47
  const OLLAMA_CLOUD_BASE_URL = "https://ollama.com";
46
48
  const OLLAMA_CLOUD_USAGE_URL = `${OLLAMA_CLOUD_BASE_URL}/api/usage`;
@@ -76,6 +78,74 @@ function isCanonicalDeepSeekBaseUrl(baseUrl: string): boolean {
76
78
  return normalized === DEEPSEEK_BASE_URL || normalized === `${DEEPSEEK_BASE_URL}/v1`;
77
79
  }
78
80
 
81
+ /** Only the exact HTTPS origin, optionally with the `/v1` API root: no credentials, port, query or fragment. */
82
+ function isCanonicalMistralBaseUrl(baseUrl: string): boolean {
83
+ const normalized = normalizedBaseUrl(baseUrl);
84
+ return normalized === MISTRAL_BASE_URL || normalized === `${MISTRAL_BASE_URL}/v1`;
85
+ }
86
+
87
+ const MISTRAL_PLAN_NAMES = new Set(["FREE", "INDIVIDUAL", "EDU", "TEAM"]);
88
+ const MISTRAL_BUDGETS = [["api_budget", "API budget"], ["vibe_budget", "Vibe budget"]] as const;
89
+
90
+ /**
91
+ * Mistral Studio/Vibe budgets (#8290).
92
+ *
93
+ * Display-only: the result never carries routing evidence, so neither key ranking nor the
94
+ * passive quota pool may spend or order a key from it. The destination is fixed and canonical,
95
+ * the request rides the provider's own egress, redirects are refused, and the body is bounded
96
+ * by readQuotaJson. A denial (401/403 and other non-retryable client statuses) is terminal and
97
+ * suppresses the previous row; transport trouble, 408, 429 and 5xx are transient and keep it.
98
+ */
99
+ async function fetchMistralQuota(provider: string, config: OcxProviderConfig): Promise<ProviderQuotaProbeResult> {
100
+ if (!isCanonicalMistralBaseUrl(config.baseUrl)) return null;
101
+ const apiKey = resolveProviderApiKey(config.apiKey)?.trim();
102
+ if (!apiKey) return null;
103
+ const init: RequestInit = {
104
+ headers: { Accept: "application/json", Authorization: `Bearer ${apiKey}` },
105
+ redirect: "error", signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
106
+ };
107
+ const settled = await Promise.allSettled([
108
+ quotaFetch(provider, config, `${MISTRAL_BASE_URL}/v1/billing/budget`, init),
109
+ quotaFetch(provider, config, `${MISTRAL_BASE_URL}/v1/billing/subscription`, init),
110
+ ]);
111
+ const responses = settled.flatMap(result => result.status === "fulfilled" ? [result.value] : []);
112
+ // 402 is a billing refusal of the reading, not proof that the credential is invalid: the
113
+ // plan may be exhausted or the billing endpoint may be gated. Keep the last-good row, as for
114
+ // 408/429, instead of erasing the measured budgets on a payment-required response.
115
+ if (responses.some(response => response.status >= 400 && response.status < 500 && response.status !== 402 && response.status !== 408 && response.status !== 429)) return TERMINAL_QUOTA_FAILURE;
116
+ if (responses.length !== 2 || responses.some(response => !response.ok)) return null;
117
+ const [budgetResponse, subscriptionResponse] = responses as [Response, Response];
118
+ const [budgetValue, subscriptionValue] = await Promise.all([
119
+ readQuotaJson(budgetResponse), readQuotaJson(subscriptionResponse),
120
+ ]);
121
+ if (budgetValue === QUOTA_JSON_READ_FAILURE || subscriptionValue === QUOTA_JSON_READ_FAILURE) return null;
122
+ const budget = asRecord(budgetValue);
123
+ const subscription = asRecord(subscriptionValue);
124
+ if (!budget || !subscription) return null;
125
+ const plan = typeof subscription.plan_name === "string" && MISTRAL_PLAN_NAMES.has(subscription.plan_name)
126
+ ? subscription.plan_name : undefined;
127
+ const customWindows: NonNullable<ProviderQuota["customWindows"]> = [];
128
+ const unknownBudgetWindows: NonNullable<ProviderQuota["unknownBudgetWindows"]> = [];
129
+ for (const [key, label] of MISTRAL_BUDGETS) {
130
+ const row = asRecord(budget[key]);
131
+ const resetAt = normalizeResetAt(row?.reset_at);
132
+ const reset = resetAt === undefined ? {} : { resetAt };
133
+ const suffix = plan ? ` (${plan})` : "";
134
+ const initial = toFiniteNumber(row?.initial_budget);
135
+ const percent = toFiniteNumber(row?.usage_percentage);
136
+ const currency = typeof row?.currency === "string" && /^[A-Za-z]{3}$/.test(row.currency) ? row.currency.toUpperCase() : undefined;
137
+ if (initial === undefined || initial <= 0 || percent === undefined || percent < 0 || percent > 100 || !currency) {
138
+ unknownBudgetWindows.push({ label: `${label}${suffix}`, ...reset });
139
+ continue;
140
+ }
141
+ const used = initial * (percent / 100);
142
+ customWindows.push({ label, displayLabel: `${label} (${currency} ${used.toFixed(2)} of ${currency} ${initial.toFixed(2)} used${plan ? `; ${plan}` : ""})`, percent, ...reset });
143
+ }
144
+ const quota: ProviderQuota = { customWindows, unknownBudgetWindows, updatedAt: Date.now() };
145
+ // Vibe and PAYG entitlements are display information, not inference eligibility evidence.
146
+ return keyReport(provider, "mistral:budget", markDisplayOnlyQuota(quota), config, apiKey, undefined, { bindCredential: true });
147
+ }
148
+
79
149
  function isCanonicalClineBaseUrl(baseUrl: string): boolean {
80
150
  const normalized = normalizedBaseUrl(baseUrl);
81
151
  return normalized === CLINE_BASE_URL || normalized === `${CLINE_BASE_URL}/api/v1`;
@@ -1470,6 +1540,9 @@ export function keyQuotaReaderForProvider(name: string, provider: OcxProviderCon
1470
1540
  if (isCanonicalA6apiBaseUrl(provider.baseUrl)) return fetchA6apiQuota;
1471
1541
  if (name === "openrouter" && isCanonicalOpenRouterBaseUrl(provider.baseUrl)) return fetchOpenRouterQuota;
1472
1542
  if (name === "deepseek" && isCanonicalDeepSeekBaseUrl(provider.baseUrl)) return fetchDeepSeekQuota;
1543
+ // The canonical-URL guard alone decides eligibility, so a custom provider name that points
1544
+ // at Mistral's own origin still probes, and a Mistral-named lookalike still dispatches nothing.
1545
+ if (isCanonicalMistralBaseUrl(provider.baseUrl)) return fetchMistralQuota;
1473
1546
  if (name === "cline-pass" && isCanonicalClineBaseUrl(provider.baseUrl)) return fetchClineQuota;
1474
1547
  if (isCanonicalOllamaCloudBaseUrl(provider.baseUrl ?? getProviderRegistryEntry(name)?.baseUrl)) return fetchOllamaCloudQuota;
1475
1548
  // #4201: the Responses preset is the same domestic GLM Coding Plan subscription on the OpenAI
@@ -4,6 +4,7 @@ import { MAIN_CODEX_ACCOUNT_ID } from "../../codex/main-account";
4
4
  import { getValidAccessToken } from "../../oauth";
5
5
  import { loadConfig } from "../../config";
6
6
  import { configuredAnthropicInstance, type AnthropicInstanceId } from "../anthropic-instance";
7
+ import { isAnthropicPoolEnabledFor } from "../../oauth/anthropic-pool-config";
7
8
  import { captureOAuthAccountSelection, credentialGeneration, getAccountCredential, getAccountSet } from "../../oauth/store";
8
9
  import { hydrateKiroAccountState, persistKiroAccountState } from "../kiro-account-state-disk";
9
10
  import { kiroProbeCurrent, kiroProbeIdentity } from "./kiro-account-probe";
@@ -22,7 +23,7 @@ import { aggregateCodexPoolCapacity, CODEX_CAPACITY_MAX_QUOTA_AGE_MS, type Codex
22
23
  import { asRecord, normalizePercent, normalizeResetAt, readQuotaJson, REQUEST_TIMEOUT_MS, toFiniteNumber } from "../quota-wire";
23
24
  import { providerCodexAccountMode } from "../registry";
24
25
  import {
25
- accountReportCurrent,
26
+ accountReportCurrent, observedQuotaFor,
26
27
  AUTHORITATIVE_EMPTY_QUOTA,
27
28
  TERMINAL_QUOTA_FAILURE,
28
29
  providerLabel,
@@ -38,6 +39,7 @@ import {
38
39
  accountCacheKey,
39
40
  captureProviderAccountQuotaEpoch,
40
41
  accountQuotaCache,
42
+ getCachedProviderAccountQuota,
41
43
  hydrateAccountQuotaCache,
42
44
  mayCommitAccountQuotaKey,
43
45
  persistAccountQuotaCache,
@@ -282,6 +284,51 @@ export async function fetchAnthropicUsageProbeForInstance(
282
284
  return probe;
283
285
  }
284
286
 
287
+ /** Pool switch plus each seat's routability, in store order; a change retires a cached pooled report. */
288
+ function anthropicPoolState(config: OcxConfig, instance: AnthropicInstanceId): string {
289
+ const accounts = getAccountSet(instance)?.accounts ?? [];
290
+ return JSON.stringify([isAnthropicPoolEnabledFor(config, instance),
291
+ accounts.map(row => [row.id, row.paused === true, row.needsReauth === true])]);
292
+ }
293
+
294
+ /**
295
+ * Pooled Anthropic report: the same display-only configured-weight estimate the Codex pool row
296
+ * carries, so the Providers overview shows pool-wide 5-hour/weekly bars, the next recovery and the
297
+ * effective account instead of the active seat alone.
298
+ *
299
+ * Only when the account pool is enabled and holds more than one account: with the pool off,
300
+ * requests are served by the active account, so its own reading is the provider's quota. Each
301
+ * account reads its last-good per-account row (the active one was just refreshed above); Anthropic
302
+ * reports no seat tier, so every routable account weighs 1. Paused, reauth and stale accounts are
303
+ * excluded and surface as incomplete coverage, exactly as for Codex.
304
+ */
305
+ function anthropicPoolReport(
306
+ provider: string,
307
+ instance: AnthropicInstanceId,
308
+ config: OcxConfig,
309
+ activeAccountId: string,
310
+ activeQuota: ProviderQuota,
311
+ ): ProviderQuotaReport | null {
312
+ if (!isAnthropicPoolEnabledFor(config, instance)) return null;
313
+ const accounts = getAccountSet(instance)?.accounts ?? [];
314
+ if (accounts.length < 2) return null;
315
+ const capacity = aggregateCodexPoolCapacity(accounts.map(row => ({
316
+ isMain: false,
317
+ active: row.id === activeAccountId,
318
+ weight: 1,
319
+ paused: row.paused === true,
320
+ needsReauth: row.needsReauth === true,
321
+ quota: (row.id === activeAccountId ? activeQuota : getCachedProviderAccountQuota(instance, row.id)) as CodexCapacityQuota | null,
322
+ })));
323
+ if (!capacity.aggregation || !capacity.quota) return null;
324
+ return report(
325
+ provider,
326
+ "anthropic:oauth-usage",
327
+ capacity.quota as ProviderQuota,
328
+ publicCapacityAggregation(capacity.aggregation, "aggregate"),
329
+ );
330
+ }
331
+
285
332
  /** `config` is the caller's live object; currency re-reads it instead of reloading the file. */
286
333
  export async function fetchAnthropicQuota(provider: string, config: OcxConfig = loadConfig()): Promise<ProviderQuotaReport | null> {
287
334
  const instance = configuredAnthropicInstance(config, provider);
@@ -336,9 +383,16 @@ export async function fetchAnthropicQuota(provider: string, config: OcxConfig =
336
383
  accountQuotaCache.set(probedAccountKey, { ts: Date.now(), quota, isCurrent: anthropicCurrent }); anthropicPublish?.();
337
384
  }
338
385
  }
339
- const quotaReport = report(provider, "anthropic:oauth-usage", quota);
386
+ const pooledReport = anthropicPoolReport(provider, instance, config, probedAccountId, quota);
387
+ const quotaReport = pooledReport ?? report(provider, "anthropic:oauth-usage", quota);
388
+ // The estimate carries no reset times, so reset detection keeps observing the active seat's reading.
389
+ if (pooledReport) observedQuotaFor.set(pooledReport, quota);
390
+ // Current only while the pool switch and membership are unchanged: pausing, resuming or reauthorizing
391
+ // an inactive seat changes the aggregate, and turning the pool on or adding a seat changes the report.
392
+ const poolState = anthropicPoolState(config, instance);
340
393
  if (quotaReport && anthropicCurrent) {
341
- accountReportCurrent.set(quotaReport, () => anthropicCurrent() && getAccountSet(instance)?.activeAccountId === probedAccountId);
394
+ accountReportCurrent.set(quotaReport, () => anthropicCurrent() && anthropicPoolState(config, instance) === poolState
395
+ && getAccountSet(instance)?.activeAccountId === probedAccountId);
342
396
  }
343
397
  return quotaReport;
344
398
  }
@@ -8,7 +8,8 @@ import { ACCOUNT_QUOTA_TTL_MS } from "./quota-wire";
8
8
 
9
9
  const MAX_ENTRIES = 256;
10
10
  const LAST_GOOD_MS = 30 * 60_000;
11
- type Entry = { ts: number; quota: ProviderQuota | null; unavailable?: true };
11
+ /** `unread` marks a synthesized row: no read happened, so `ts` is not a read time. */
12
+ type Entry = { ts: number; quota: ProviderQuota | null; unavailable?: true; unread?: true };
12
13
  export type KeyQuotaProbeOutcome =
13
14
  | { kind: "quota"; quota: ProviderQuota }
14
15
  | { kind: "empty" | "terminal" | "unavailable" };
@@ -16,6 +17,8 @@ export interface ProviderApiKeyQuota {
16
17
  keyId: string;
17
18
  quota: ProviderQuota | null;
18
19
  unavailable?: true;
20
+ /** When this key's quota was last read, success or failure; absent when no read happened. */
21
+ readAt?: number;
19
22
  /** Server-only, non-enumerable; call immediately before the safe DTO join. */
20
23
  isCurrent: () => boolean;
21
24
  }
@@ -128,7 +131,7 @@ async function readEntry(
128
131
  if (running) return running;
129
132
  const lastGood = previous?.quota && Date.now() - previous.quota.updatedAt < LAST_GOOD_MS
130
133
  ? previous.quota : null;
131
- if (flights.size >= MAX_ENTRIES) return { ts: Date.now(), quota: lastGood, unavailable: true };
134
+ if (flights.size >= MAX_ENTRIES) return { ts: Date.now(), quota: lastGood, unavailable: true, unread: true };
132
135
  const flight = (async (): Promise<Entry> => {
133
136
  let result: KeyQuotaProbeOutcome;
134
137
  try { result = await probe(); } catch { result = { kind: "unavailable" }; }
@@ -174,17 +177,26 @@ export async function readProviderApiKeyQuotas(
174
177
  return !!currentKey && identity(name, current, row.id, currentKey) === key;
175
178
  } catch { return false; }
176
179
  };
180
+ const isPaused = () => row.disabled === true
181
+ || roster(config.providers[name] ?? providerSnapshot).find(candidate => candidate.id === row.id)?.disabled === true;
182
+ const cached = key ? cache.get(key) : undefined;
177
183
  const entry = key && resolved && isCurrent()
178
- ? await readEntry(key, force, isCurrent, () => {
179
- const isolatedProvider = { ...providerSnapshot, apiKey: resolved, apiKeyPool: undefined };
180
- const isolatedConfig = { ...config, providers: { [name]: isolatedProvider } };
181
- return probe(isolatedProvider, isolatedConfig);
182
- })
183
- : { ts: Date.now(), quota: null, unavailable: true as const };
184
+ ? isPaused()
185
+ ? (cached && (!cached.quota || Date.now() - cached.quota.updatedAt < LAST_GOOD_MS)
186
+ ? cached
187
+ : { ts: Date.now(), quota: null, unavailable: true as const, unread: true as const })
188
+ : await readEntry(key, force, isCurrent, () => {
189
+ const isolatedProvider = { ...providerSnapshot, apiKey: resolved, apiKeyPool: undefined };
190
+ const isolatedConfig = { ...config, providers: { [name]: isolatedProvider } };
191
+ return probe(isolatedProvider, isolatedConfig);
192
+ })
193
+ : { ts: Date.now(), quota: null, unavailable: true as const, unread: true as const };
194
+ const current = isCurrent();
184
195
  const result = {
185
196
  keyId: row.id,
186
- quota: isCurrent() ? entry.quota : null,
187
- ...(!isCurrent() || entry.unavailable ? { unavailable: true as const } : {}),
197
+ quota: current ? entry.quota : null,
198
+ ...(!current || entry.unavailable ? { unavailable: true as const } : {}),
199
+ ...(current && !entry.unread ? { readAt: entry.ts } : {}),
188
200
  };
189
201
  return Object.defineProperty(result, "isCurrent", { value: isCurrent }) as ProviderApiKeyQuota;
190
202
  });
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Mistral budget windows the reset detector may keep while their percent is unknown.
3
+ *
4
+ * This lives beside the provider quota seam rather than in src/quota/: src/providers/quota.ts is
5
+ * statically reachable from the core request path, and tests/usage/quota-reset-core-boundary.test.ts
6
+ * keeps every src/quota module off that path. The seam calls this on every Mistral report, so it
7
+ * must stay a plain import with no dependency on the reset subsystem.
8
+ */
9
+ export function mistralUnknownBudgetWindows(
10
+ quota: { unknownBudgetWindows?: ReadonlyArray<{ label: string; resetAt?: number }> },
11
+ ): { window: string; resetAt: number }[] {
12
+ return (quota.unknownBudgetWindows ?? []).flatMap(entry => {
13
+ const match = /^(API budget|Vibe budget)(?: \((?:FREE|INDIVIDUAL|EDU|TEAM)\))?$/.exec(entry.label);
14
+ return match && typeof entry.resetAt === "number" && Number.isFinite(entry.resetAt) && entry.resetAt > 0
15
+ ? [{ window: `custom:${match[1]}`, resetAt: entry.resetAt }]
16
+ : [];
17
+ });
18
+ }
@@ -10,6 +10,16 @@
10
10
 
11
11
  export const PROVIDER_QUOTA_MAX_AGE_MS = 30 * 60_000;
12
12
 
13
+ // Process-local authority: display readings must not acquire key-selection authority.
14
+ const displayOnlyQuotas = new WeakSet<ProviderQuota>();
15
+ export function markDisplayOnlyQuota(quota: ProviderQuota): ProviderQuota {
16
+ displayOnlyQuotas.add(quota);
17
+ return quota;
18
+ }
19
+ export function isDisplayOnlyQuota(quota: ProviderQuota): boolean {
20
+ return displayOnlyQuotas.has(quota);
21
+ }
22
+
13
23
  /** Management-only eligibility evidence; private credential binding never leaves the server. */
14
24
  export type ProviderRoutingQuota =
15
25
  | { state: "unknown" }
@@ -17,6 +27,8 @@ export type ProviderRoutingQuota =
17
27
 
18
28
  export interface ProviderQuotaWindow {
19
29
  label: string;
30
+ /** Presentation text only; identity and routing use label and structured fields. */
31
+ displayLabel?: string;
20
32
  percent: number;
21
33
  resetAt?: number;
22
34
  /**
@@ -60,6 +72,8 @@ export interface ProviderQuotaCreditsUsd {
60
72
  }
61
73
 
62
74
  export interface ProviderQuota {
75
+ /** Display-only budget windows for which the upstream did not provide a usable entitlement. */
76
+ unknownBudgetWindows?: { label: string; resetAt?: number }[];
63
77
  /** Display-only subscription credits; not a routing or exhaustion window. */
64
78
  workbuddyCredits?: import("./workbuddy-credit-balance").WorkBuddyCreditBalance;
65
79
  fiveHourPercent?: number;
@@ -72,6 +86,12 @@ export interface ProviderQuota {
72
86
  kiroCreditsUsed?: number;
73
87
  kiroCreditsLimit?: number;
74
88
  customWindows?: ProviderQuotaWindow[];
89
+ /**
90
+ * Display-only measurements the producer withheld from routing: Anthropic model-scoped rows
91
+ * that upstream reports with `is_active: false`. Routing, exhaustion, cooldown recovery and
92
+ * reset ordering read only `customWindows`; nothing but quota display reads this field.
93
+ */
94
+ displayWindows?: ProviderQuotaWindow[];
75
95
  creditsUsd?: ProviderQuotaCreditsUsd;
76
96
  updatedAt: number;
77
97
  }
@@ -84,6 +104,24 @@ export interface AccountQuotaFields {
84
104
  quota?: ProviderQuota | null;
85
105
  quotaUnavailable?: boolean;
86
106
  quotaFailure?: QuotaFailureCode;
107
+ /** Why the current balance is unknown (#8397); a last-good value may still ride along with read_failed. */
108
+ quotaUnknownReason?: QuotaUnknownReason;
109
+ /** When the balance was last read (epoch ms), success or failure; absent when never read. */
110
+ quotaReadAt?: number;
111
+ }
112
+
113
+ /**
114
+ * Closed reasons a balance is unknown. A row with a reason must never be rendered as zero.
115
+ * no_balance_source: no reader exists for this destination. passive_not_observed: a passive
116
+ * provider has not observed usage yet. read_failed: a reader exists and its last read failed.
117
+ * not_read: a reader exists but no read was made (paused key, or the key changed mid-read).
118
+ * not_reported: the read succeeded and the provider authoritatively reported no balance to meter
119
+ * (for example zero total credits, or a plan with no model window).
120
+ */
121
+ export const QUOTA_UNKNOWN_REASONS = ["no_balance_source", "passive_not_observed", "read_failed", "not_read", "not_reported"] as const;
122
+ export type QuotaUnknownReason = typeof QUOTA_UNKNOWN_REASONS[number];
123
+ export function parseQuotaUnknownReason(value: unknown): QuotaUnknownReason | undefined {
124
+ return QUOTA_UNKNOWN_REASONS.find(reason => reason === value);
87
125
  }
88
126
 
89
127
 
@@ -96,3 +134,8 @@ export type QuotaFailureCode = typeof QUOTA_FAILURE_CODES[number];
96
134
  export function parseQuotaFailureCode(value: unknown): QuotaFailureCode | undefined {
97
135
  return QUOTA_FAILURE_CODES.find(code => code === value);
98
136
  }
137
+
138
+ /** A model family's share of the weekly limit is meaningful only as a finite percent in (0, 100]. */
139
+ export function isWeeklyAllowancePercent(value: unknown): value is number {
140
+ return typeof value === "number" && Number.isFinite(value) && value > 0 && value <= 100;
141
+ }