@bitkyc08/opencodex 2.100.2 → 2.100.4

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 (644) hide show
  1. package/AGENTS_INSTALL.md +23 -1
  2. package/README.md +1 -1
  3. package/bin/ocx.mjs +40 -19
  4. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  5. package/gui/dist/assets/App-DcpyI78f.js +60 -0
  6. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-CzjPJprT.js} +1 -1
  7. package/gui/dist/assets/brand-mark-BTIi7e69.js +1 -0
  8. package/gui/dist/assets/index-DJxM-imn.css +2 -0
  9. package/gui/dist/assets/index-DVgU6S3y.js +138 -0
  10. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-Bn6Y-g3R.js} +1 -1
  11. package/gui/dist/classic/assets/App-eYJAyNHM.js +59 -0
  12. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-xHMYxLkV.js} +1 -1
  13. package/gui/dist/classic/assets/index-DSaVRW4F.js +138 -0
  14. package/gui/dist/classic/assets/quota-summary-DyzHlkFl.js +1 -0
  15. package/gui/dist/classic/index.html +1 -1
  16. package/gui/dist/index.html +2 -2
  17. package/native/ocx-child/Cargo.toml +9 -0
  18. package/native/ocx-child/src/cli.rs +404 -20
  19. package/native/ocx-child/src/codex_home.rs +99 -14
  20. package/native/ocx-child/src/daemon.rs +2 -1
  21. package/native/ocx-child/src/lib.rs +3 -0
  22. package/native/ocx-child/src/link_ws.rs +2598 -0
  23. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  24. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  25. package/native/ocx-child/src/parity.rs +5 -1
  26. package/native/ocx-child/src/platform.rs +152 -6
  27. package/native/ocx-child/src/relay.rs +150 -19
  28. package/package.json +3 -3
  29. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  30. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  31. package/src/adapters/anthropic/client-identity.ts +3 -1
  32. package/src/adapters/anthropic/passthrough.ts +9 -3
  33. package/src/adapters/anthropic/per-message-effort.ts +296 -0
  34. package/src/adapters/anthropic.ts +34 -14
  35. package/src/adapters/claude-cli/adapter.ts +1 -0
  36. package/src/adapters/client-fingerprint.ts +3 -3
  37. package/src/adapters/cursor/discovery.ts +17 -0
  38. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  39. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  40. package/src/adapters/cursor/protobuf-request.ts +8 -8
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/chat.ts +71 -14
  43. package/src/adapters/google-antigravity-wire.ts +7 -5
  44. package/src/adapters/google-errors.ts +14 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +9 -2
  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/qoder/adapter.ts +9 -1
  54. package/src/adapters/zed.ts +7 -2
  55. package/src/advisor/consult.ts +15 -4
  56. package/src/advisor/context.ts +12 -3
  57. package/src/advisor/runtime.ts +35 -5
  58. package/src/advisor/settings.ts +8 -0
  59. package/src/advisor/synthetic-tool.ts +21 -8
  60. package/src/bridge/response-json.ts +11 -2
  61. package/src/bridge/sse.ts +43 -8
  62. package/src/claude/auth-detect.ts +21 -33
  63. package/src/claude/desktop-3p.ts +11 -5
  64. package/src/claude/desktop-gateway-state.ts +2 -0
  65. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  66. package/src/claude/desktop-remote-store.ts +82 -12
  67. package/src/claude/inbound-content-options.ts +31 -16
  68. package/src/claude/outbound.ts +13 -3
  69. package/src/cli/account-api.ts +21 -1
  70. package/src/cli/account-auth.ts +83 -22
  71. package/src/cli/account-extended.ts +33 -2
  72. package/src/cli/account-key-quota.ts +34 -5
  73. package/src/cli/account.ts +4 -2
  74. package/src/cli/advisor.ts +7 -4
  75. package/src/cli/alias.ts +38 -1
  76. package/src/cli/capabilities-access-remote.ts +128 -3
  77. package/src/cli/capabilities-accounts.ts +6 -6
  78. package/src/cli/capabilities-agents-routing.ts +17 -10
  79. package/src/cli/capabilities-base.ts +49 -19
  80. package/src/cli/capabilities-integrations.ts +2 -2
  81. package/src/cli/capabilities-observe-system.ts +2 -2
  82. package/src/cli/capabilities-provider-models.ts +18 -2
  83. package/src/cli/capabilities-route-to.ts +43 -0
  84. package/src/cli/capabilities.ts +2 -0
  85. package/src/cli/capability-contracts.ts +1 -1
  86. package/src/cli/claude-desktop.ts +30 -11
  87. package/src/cli/claude.ts +17 -3
  88. package/src/cli/codex-launcher.ts +3 -1
  89. package/src/cli/codex-shim-autorestore.ts +5 -42
  90. package/src/cli/config-command.ts +14 -1
  91. package/src/cli/config-root-startup.ts +34 -0
  92. package/src/cli/connect.ts +88 -16
  93. package/src/cli/desktop-runtime-guidance.ts +1 -1
  94. package/src/cli/disconnect-runtime.ts +178 -0
  95. package/src/cli/dispatch.ts +61 -13
  96. package/src/cli/export-command.ts +1 -1
  97. package/src/cli/gui-pair-client.ts +6 -3
  98. package/src/cli/gui.ts +10 -5
  99. package/src/cli/help-catalog.ts +11 -0
  100. package/src/cli/help.ts +4 -3
  101. package/src/cli/index.ts +85 -94
  102. package/src/cli/inspect.ts +11 -2
  103. package/src/cli/integrations.ts +26 -1
  104. package/src/cli/link-apply-restart.ts +4 -2
  105. package/src/cli/link-capture.ts +64 -0
  106. package/src/cli/link-child-ops.ts +218 -40
  107. package/src/cli/link-cleanup.ts +8 -5
  108. package/src/cli/link-diagnostics.ts +67 -0
  109. package/src/cli/link-enrollment.ts +158 -12
  110. package/src/cli/link-operations.ts +52 -0
  111. package/src/cli/link-recover.ts +152 -0
  112. package/src/cli/link-routes.ts +90 -0
  113. package/src/cli/link-status-child.ts +44 -1
  114. package/src/cli/link-status-traffic.ts +34 -0
  115. package/src/cli/link.ts +315 -37
  116. package/src/cli/message-command.ts +1 -1
  117. package/src/cli/message-mcp-command.ts +23 -10
  118. package/src/cli/models-runtime.ts +3 -3
  119. package/src/cli/opencode.ts +3 -1
  120. package/src/cli/pi-sync.ts +35 -0
  121. package/src/cli/preflight-exemptions.ts +49 -0
  122. package/src/cli/registry.ts +33 -14
  123. package/src/cli/resolve.ts +23 -8
  124. package/src/cli/restart-failure.ts +15 -2
  125. package/src/cli/root.ts +5 -1
  126. package/src/cli/route-to.ts +172 -0
  127. package/src/cli/runtime-api.ts +9 -8
  128. package/src/cli/status.ts +7 -2
  129. package/src/cli/stop-approval.ts +66 -19
  130. package/src/cli/stop-report.ts +23 -0
  131. package/src/cli/stop-windows-checked.ts +304 -0
  132. package/src/cli/sync-command.ts +70 -15
  133. package/src/cli/sync-fanout.ts +74 -19
  134. package/src/cli/sync-flags.ts +40 -3
  135. package/src/cli/sync-link-status.ts +18 -2
  136. package/src/cli/sync-update-guard.ts +7 -2
  137. package/src/cli/system-command.ts +1 -1
  138. package/src/cli/system-restart-client.ts +10 -3
  139. package/src/cli/system-settings-parity.ts +2 -1
  140. package/src/cli/uninstall-plan.ts +77 -5
  141. package/src/cli/uninstall-stop.ts +152 -0
  142. package/src/cli/v2-input.ts +10 -6
  143. package/src/cli/v2-local-output.ts +3 -2
  144. package/src/cli/v2-runtime.ts +10 -3
  145. package/src/cli/v2.ts +22 -7
  146. package/src/client/connect.ts +376 -35
  147. package/src/client/desktop-refusal.ts +38 -0
  148. package/src/client/lifecycle-lock.ts +29 -4
  149. package/src/client/link-home-features.ts +27 -0
  150. package/src/client/link-home.ts +92 -4
  151. package/src/client/link-ingress.ts +21 -3
  152. package/src/client/link-join.ts +12 -2
  153. package/src/client/link-parity-reporter.ts +60 -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.ts +56 -5
  161. package/src/client/link-websocket-limits.ts +89 -0
  162. package/src/client/link-websocket.ts +586 -0
  163. package/src/client/link-ws-advertisement.ts +100 -0
  164. package/src/client/link-ws-framer.ts +241 -0
  165. package/src/client/link-ws-transport.ts +177 -0
  166. package/src/client/machine-api.ts +13 -2
  167. package/src/client/machine-listener.ts +48 -7
  168. package/src/client/route-intent-apply.ts +293 -0
  169. package/src/client/route-intent-file-originals.ts +97 -0
  170. package/src/client/route-intent-native-originals.ts +201 -0
  171. package/src/client/route-intent-watch.ts +141 -0
  172. package/src/client/runtime-restart.ts +141 -7
  173. package/src/client/runtime.ts +63 -15
  174. package/src/client/state.ts +44 -0
  175. package/src/client/sync-expectation.ts +36 -2
  176. package/src/client/sync-runtime.ts +7 -0
  177. package/src/clients/config-export/alias-selectors.ts +63 -40
  178. package/src/clients/config-export/contracts.ts +2 -0
  179. package/src/clients/config-export/nested-selectors.ts +42 -0
  180. package/src/clients/config-export.ts +22 -3
  181. package/src/codex/account-pause.ts +4 -0
  182. package/src/codex/account-runtime-state.ts +4 -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/main-account-probe.ts +3 -1
  187. package/src/codex/auth-api/main-hard-lock-refusal-read.ts +172 -0
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +61 -8
  190. package/src/codex/catalog/build-entries.ts +10 -0
  191. package/src/codex/catalog/derive-entry.ts +7 -0
  192. package/src/codex/catalog/gather-capture.ts +8 -2
  193. package/src/codex/catalog/parsing.ts +7 -3
  194. package/src/codex/catalog/provider-models.ts +54 -15
  195. package/src/codex/catalog/reserve-warn.ts +7 -5
  196. package/src/codex/catalog/reserve.ts +4 -3
  197. package/src/codex/catalog/retained-sync.ts +4 -1
  198. package/src/codex/catalog/routed-defaults.ts +35 -0
  199. package/src/codex/catalog/routed-gather.ts +1 -1
  200. package/src/codex/catalog-auto-refresh.ts +11 -0
  201. package/src/codex/cli-update-job.ts +35 -13
  202. package/src/codex/convergence.ts +4 -2
  203. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  204. package/src/codex/features.ts +2 -2
  205. package/src/codex/history-provider.ts +31 -0
  206. package/src/codex/inject/multi-agent-v2.ts +9 -3
  207. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  208. package/src/codex/inject/plan.ts +20 -2
  209. package/src/codex/inject.ts +2 -0
  210. package/src/codex/journal-config-restore.ts +217 -0
  211. package/src/codex/journal.ts +75 -6
  212. package/src/codex/loopback-target.ts +22 -8
  213. package/src/codex/main-account.ts +109 -57
  214. package/src/codex/native-main-auth-file.ts +118 -0
  215. package/src/codex/native-main-credentials.ts +270 -0
  216. package/src/codex/native-main-owner.ts +3 -0
  217. package/src/codex/native-main-refresh-mode.ts +14 -1
  218. package/src/codex/native-profile-manager.ts +4 -3
  219. package/src/codex/native-profile-store.ts +3 -61
  220. package/src/codex/orca-import.ts +10 -1
  221. package/src/codex/quota-history.ts +13 -0
  222. package/src/codex/quota-window-conflict.ts +103 -0
  223. package/src/codex/quota.ts +86 -15
  224. package/src/codex/subagent-model-fallback.ts +3 -1
  225. package/src/codex/websocket-activity.ts +171 -16
  226. package/src/codex/websocket-registry.ts +11 -4
  227. package/src/combos/cooldown-store.ts +25 -5
  228. package/src/combos/failover.ts +342 -3
  229. package/src/combos/index.ts +5 -0
  230. package/src/combos/resolve.ts +115 -19
  231. package/src/config/dashboard-trusted-proxy.ts +83 -0
  232. package/src/config/diagnostics.ts +31 -0
  233. package/src/config/feature-flags.ts +9 -0
  234. package/src/config/live-reconcile.ts +16 -4
  235. package/src/config/load-degrade.ts +14 -1
  236. package/src/config/multi-agent-surface.ts +28 -5
  237. package/src/config/pending-teardown.ts +60 -3
  238. package/src/config/persisted-mutation.ts +2 -2
  239. package/src/config/persisted-projections.ts +18 -0
  240. package/src/config/process-state.ts +176 -4
  241. package/src/config/provider-validation.ts +4 -4
  242. package/src/config/reserve-capability.ts +96 -0
  243. package/src/config/schema/config-schema.ts +12 -0
  244. package/src/config/schema/leaf-validators.ts +11 -2
  245. package/src/config/schema/routed-catalog-defaults.ts +49 -0
  246. package/src/config/windows-process-command-line.ts +107 -0
  247. package/src/config.ts +7 -7
  248. package/src/desktop-update/acquire.ts +202 -0
  249. package/src/desktop-update/cli.ts +168 -0
  250. package/src/desktop-update/drain.ts +40 -0
  251. package/src/desktop-update/headless.ts +285 -0
  252. package/src/desktop-update/image.ts +85 -0
  253. package/src/desktop-update/install.ts +53 -0
  254. package/src/desktop-update/msi.ts +72 -0
  255. package/src/desktop-update/release.ts +128 -0
  256. package/src/desktop-update/runtime.ts +155 -0
  257. package/src/desktop-update/staging.ts +118 -0
  258. package/src/desktop-update/trust.ts +45 -0
  259. package/src/generated/compatibility-version.json +1114 -442
  260. package/src/generated/model-metadata.ts +1 -1
  261. package/src/images/fulfill-video.ts +3 -3
  262. package/src/images/loop.ts +9 -2
  263. package/src/images/plan.ts +147 -11
  264. package/src/images/types.ts +13 -4
  265. package/src/images/xai-video-client.ts +72 -10
  266. package/src/integrations/model-name-guard.ts +25 -0
  267. package/src/integrations/route-intent-catalog.ts +26 -0
  268. package/src/integrations/route-intent-connected.ts +262 -0
  269. package/src/integrations/route-intent-contract.ts +55 -0
  270. package/src/integrations/route-intent-disconnect.ts +109 -0
  271. package/src/integrations/route-intent-initial.ts +64 -0
  272. package/src/integrations/route-intent-state.ts +117 -0
  273. package/src/integrations/route-intent-tick.ts +65 -0
  274. package/src/integrations/route-intent.ts +212 -0
  275. package/src/integrations/writer.ts +44 -11
  276. package/src/lib/client-retry-after.ts +29 -0
  277. package/src/lib/config-ownership.ts +13 -0
  278. package/src/lib/desktop-gui-origin.ts +28 -0
  279. package/src/lib/errors.ts +1 -1
  280. package/src/lib/gcp-adc.ts +48 -4
  281. package/src/lib/gui-pair-capability.ts +2 -1
  282. package/src/lib/messages-error-body.ts +4 -1
  283. package/src/lib/offline-resend.ts +150 -0
  284. package/src/lib/outbound-credential-registry.ts +362 -4
  285. package/src/lib/paced-stream.ts +34 -0
  286. package/src/lib/passive-key-fetch-proof.ts +30 -0
  287. package/src/lib/passive-read.ts +5 -0
  288. package/src/lib/process-control.ts +76 -12
  289. package/src/lib/provider-outbound.ts +17 -6
  290. package/src/lib/redact.ts +84 -8
  291. package/src/lib/request-failure-model.ts +2 -0
  292. package/src/lib/response-body-inactivity.ts +23 -1
  293. package/src/lib/state-store-registrations.ts +11 -0
  294. package/src/lib/state-store-sweeper.ts +4 -0
  295. package/src/lib/supervisor-markers.ts +18 -0
  296. package/src/lib/terminal-safe-text.ts +58 -0
  297. package/src/lib/translator-budget.ts +3 -2
  298. package/src/lib/upstream-retry.ts +52 -9
  299. package/src/link/alias-lock.ts +119 -0
  300. package/src/link/child-activity.ts +28 -2
  301. package/src/link/child-binary-cache-fill.d.mts +50 -0
  302. package/src/link/child-binary-cache-fill.mjs +494 -0
  303. package/src/link/child-binary-cache-start.ts +73 -0
  304. package/src/link/child-binary-source.ts +12 -5
  305. package/src/link/child-gated-ocx.ts +29 -11
  306. package/src/link/child-observations.ts +2 -1
  307. package/src/link/child-observe.ts +2 -2
  308. package/src/link/child-ops-engine.ts +159 -91
  309. package/src/link/child-ops-host.ts +138 -0
  310. package/src/link/child-ops-runners.ts +319 -0
  311. package/src/link/child-ops-scheduler.ts +207 -0
  312. package/src/link/child-ops-types.ts +89 -0
  313. package/src/link/child-parity.ts +23 -4
  314. package/src/link/child-policy.ts +93 -0
  315. package/src/link/child-update-contract.ts +12 -3
  316. package/src/link/codex-settings.ts +1 -1
  317. package/src/link/compatibility.ts +18 -1
  318. package/src/link/diagnostics-read.ts +163 -0
  319. package/src/link/diagnostics.ts +20 -7
  320. package/src/link/explicit-route.ts +209 -0
  321. package/src/link/link-recover.ts +113 -0
  322. package/src/link/management-routes.ts +3 -1
  323. package/src/link/operation-recovery-slot.ts +44 -0
  324. package/src/link/operations-journal.ts +408 -0
  325. package/src/link/peer-report.ts +1 -1
  326. package/src/link/relay-auth.ts +14 -0
  327. package/src/link/remote-plant.ts +152 -14
  328. package/src/link/remote-platform.ts +21 -10
  329. package/src/link/remote-probe.ts +11 -3
  330. package/src/link/remote-windows.ts +124 -36
  331. package/src/link/request-compression.ts +30 -0
  332. package/src/link/residual-recovery.ts +66 -0
  333. package/src/link/retirement.ts +128 -0
  334. package/src/link/route-intent-watch.ts +41 -0
  335. package/src/link/route-intent.ts +209 -0
  336. package/src/link/route-proof.ts +82 -0
  337. package/src/link/route-rounds.ts +579 -0
  338. package/src/link/route-select.ts +95 -0
  339. package/src/link/route-trust.ts +96 -0
  340. package/src/link/ssh-argv.ts +172 -24
  341. package/src/link/ssh-capture-redact.ts +253 -0
  342. package/src/link/ssh-capture.ts +497 -0
  343. package/src/link/ssh-runner.ts +141 -14
  344. package/src/link/status-projection.ts +87 -0
  345. package/src/link/store.ts +54 -1
  346. package/src/link/supervisor.ts +543 -55
  347. package/src/link/sync-fanout-classify.ts +16 -0
  348. package/src/link/sync-then-restart.ts +65 -0
  349. package/src/link/tombstones.ts +209 -0
  350. package/src/link/traffic.ts +178 -0
  351. package/src/link/ws-activity-holds.ts +474 -0
  352. package/src/local-credentials/publication-fence.ts +20 -1
  353. package/src/messaging/budget.ts +23 -5
  354. package/src/messaging/mcp-queue-rpc.ts +1 -1
  355. package/src/messaging/mcp-queue-server.ts +16 -1
  356. package/src/messaging/mcp-resume-tools.ts +25 -0
  357. package/src/messaging/remote-enrollment.ts +3 -3
  358. package/src/messaging/remote-tunnels.ts +2 -2
  359. package/src/messaging/resume-permissions.ts +27 -0
  360. package/src/messaging/rpc.ts +50 -6
  361. package/src/oauth/anthropic-continuity.ts +23 -7
  362. package/src/oauth/anthropic-routing.ts +5 -2
  363. package/src/oauth/anthropic.ts +22 -2
  364. package/src/oauth/antigravity-risk.ts +126 -0
  365. package/src/oauth/claude-keychain-read.ts +78 -68
  366. package/src/oauth/generic-account-failover.ts +89 -18
  367. package/src/oauth/generic-session-affinity.ts +10 -3
  368. package/src/oauth/index.ts +24 -6
  369. package/src/oauth/local-token-detect.ts +8 -29
  370. package/src/oauth/login-cli-errors.ts +5 -1
  371. package/src/oauth/login-cli.ts +68 -19
  372. package/src/oauth/login-flow-state.ts +26 -3
  373. package/src/oauth/meta-muse.ts +1 -1
  374. package/src/oauth/pool-kernel.ts +3 -3
  375. package/src/oauth/store.ts +7 -0
  376. package/src/oauth/xai.ts +248 -14
  377. package/src/protocols/contract.ts +4 -0
  378. package/src/protocols/encoders/messages.ts +1 -0
  379. package/src/providers/alias-template.ts +48 -0
  380. package/src/providers/anthropic-billing-ownership.ts +2 -0
  381. package/src/providers/anthropic-billing-refusal.ts +27 -3
  382. package/src/providers/anthropic-output-caps.ts +46 -0
  383. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  384. package/src/providers/antigravity-effort-families.ts +11 -3
  385. package/src/providers/antigravity-models.ts +32 -9
  386. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  387. package/src/providers/api-key-pause.ts +3 -0
  388. package/src/providers/api-key-resolve.ts +49 -7
  389. package/src/providers/api-key-response-ownership.ts +2 -0
  390. package/src/providers/api-key-selection.ts +51 -9
  391. package/src/providers/api-keys.ts +6 -2
  392. package/src/providers/cache-affinity-identity.ts +73 -0
  393. package/src/providers/cache-affinity.ts +256 -0
  394. package/src/providers/default-aliases.ts +98 -20
  395. package/src/providers/google-vertex-model-discovery.ts +515 -0
  396. package/src/providers/key-failover.ts +123 -8
  397. package/src/providers/key-store.ts +3 -3
  398. package/src/providers/kiro-models.ts +3 -5
  399. package/src/providers/label.ts +31 -5
  400. package/src/providers/mistral-transport.ts +17 -4
  401. package/src/providers/model-rename-fields.ts +5 -0
  402. package/src/providers/muse-key-quota.ts +14 -6
  403. package/src/providers/new-model-policy-runtime.ts +17 -4
  404. package/src/providers/new-model-policy.ts +30 -4
  405. package/src/providers/passive-key-observation.ts +252 -0
  406. package/src/providers/quota/account-cache.ts +2 -1
  407. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  408. package/src/providers/quota/passive-key-limits.ts +272 -0
  409. package/src/providers/quota/passive-wire-model.ts +126 -0
  410. package/src/providers/quota/report-cache.ts +61 -2
  411. package/src/providers/quota/workbuddy.ts +6 -2
  412. package/src/providers/quota-key-accounts.ts +11 -6
  413. package/src/providers/quota-types.ts +18 -0
  414. package/src/providers/quota.ts +11 -12
  415. package/src/providers/registry/entries-core.ts +34 -16
  416. package/src/providers/registry/entries-extended.ts +32 -0
  417. package/src/providers/registry/model-seeds.ts +35 -0
  418. package/src/providers/resolved-model-policy.ts +7 -0
  419. package/src/providers/routed-config.ts +8 -3
  420. package/src/providers/workbuddy-credit-balance.ts +125 -16
  421. package/src/providers/xai-transport.ts +3 -0
  422. package/src/remote/features.ts +17 -0
  423. package/src/responses/anthropic-progress.ts +10 -4
  424. package/src/responses/citation-markers.ts +231 -0
  425. package/src/responses/effort-history.ts +732 -0
  426. package/src/responses/spill-store.ts +5 -1
  427. package/src/responses/state/replay-input.ts +50 -0
  428. package/src/responses/state/replay-owner.ts +24 -0
  429. package/src/responses/state/snapshot-codec.ts +9 -0
  430. package/src/responses/state/spill-queue.ts +1 -0
  431. package/src/responses/state.ts +42 -60
  432. package/src/router.ts +2 -2
  433. package/src/routing/history/integrity.ts +41 -4
  434. package/src/routing/home-route-capture.ts +123 -0
  435. package/src/routing/home-route-intent.ts +200 -0
  436. package/src/routing/route-intent-state.ts +178 -0
  437. package/src/routing/route-to-live-settings.ts +35 -0
  438. package/src/routing/route-to-local.ts +145 -0
  439. package/src/routing/route-to-status.ts +94 -0
  440. package/src/routing/route-to-sync-child.ts +32 -0
  441. package/src/server/adapter-resolve.ts +21 -1
  442. package/src/server/admitted-http-turn.ts +3 -0
  443. package/src/server/auth-cors.ts +111 -3
  444. package/src/server/bare-upstream-error.ts +220 -0
  445. package/src/server/chat-native.ts +14 -5
  446. package/src/server/claude-messages.ts +6 -4
  447. package/src/server/codex-model-list.ts +4 -2
  448. package/src/server/configured-credentials.ts +37 -5
  449. package/src/server/direct-local-http.ts +26 -3
  450. package/src/server/gui-desktop-authorization.ts +36 -0
  451. package/src/server/gui-pair-delivery.ts +6 -3
  452. package/src/server/gui-session.ts +10 -1
  453. package/src/server/inbound-body-admission.ts +17 -4
  454. package/src/server/index/link-listener.ts +196 -12
  455. package/src/server/index/link-management.ts +15 -1
  456. package/src/server/index/link-relay-sessions.ts +87 -8
  457. package/src/server/index/link-websocket-limits.ts +136 -0
  458. package/src/server/index/link-websocket.ts +692 -0
  459. package/src/server/index/optional-listeners.ts +97 -7
  460. package/src/server/index/route-intent-watch.ts +47 -0
  461. package/src/server/index/serve-contract.ts +86 -0
  462. package/src/server/index/serve-options.ts +36 -86
  463. package/src/server/index/startup-warnings.ts +8 -2
  464. package/src/server/index/websocket-handler.ts +26 -4
  465. package/src/server/index.ts +15 -4
  466. package/src/server/inference/client-encoder-delivery.ts +2 -0
  467. package/src/server/inspection-tee.ts +39 -2
  468. package/src/server/lifecycle.ts +2 -0
  469. package/src/server/link-turn.ts +149 -0
  470. package/src/server/management/advisor-routes.ts +10 -2
  471. package/src/server/management/agent-settings-routes.ts +50 -16
  472. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  473. package/src/server/management/config-routes.ts +39 -3
  474. package/src/server/management/context.ts +9 -2
  475. package/src/server/management/desktop-authorization.ts +41 -0
  476. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  477. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  478. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  479. package/src/server/management/home-integration-decision.ts +89 -0
  480. package/src/server/management/integration-routes.ts +208 -81
  481. package/src/server/management/link-child-ops-routes.ts +145 -43
  482. package/src/server/management/link-child-preflight.ts +31 -0
  483. package/src/server/management/link-diagnostics-route.ts +29 -0
  484. package/src/server/management/link-enrollment.ts +199 -47
  485. package/src/server/management/link-operation.ts +609 -0
  486. package/src/server/management/link-recover-route.ts +103 -0
  487. package/src/server/management/link-route-edit.ts +192 -0
  488. package/src/server/management/link-route-request.ts +62 -0
  489. package/src/server/management/link-route-state.ts +83 -7
  490. package/src/server/management/link-routes.ts +553 -51
  491. package/src/server/management/link-traffic-status.ts +13 -0
  492. package/src/server/management/model-routes.ts +122 -36
  493. package/src/server/management/model-rows.ts +2 -1
  494. package/src/server/management/native-integration-routes.ts +176 -70
  495. package/src/server/management/oauth-account-routes.ts +58 -18
  496. package/src/server/management/protocol-routes.ts +7 -0
  497. package/src/server/management/provider-completion-test.ts +4 -4
  498. package/src/server/management/provider-overwrite-carry.ts +14 -0
  499. package/src/server/management/provider-routes.ts +68 -65
  500. package/src/server/management/provider-routing-quota.ts +45 -0
  501. package/src/server/management/route-registry.ts +22 -3
  502. package/src/server/management/route-to-routes.ts +257 -0
  503. package/src/server/management/static-catalog-probe.ts +33 -0
  504. package/src/server/management/system-restart.ts +4 -2
  505. package/src/server/management/usage-aggregate-cache.ts +101 -66
  506. package/src/server/management-api.ts +17 -3
  507. package/src/server/management-auth.ts +13 -1
  508. package/src/server/messages-native-preflight.ts +27 -4
  509. package/src/server/messages-native.ts +17 -5
  510. package/src/server/persistent-gui-session.ts +6 -3
  511. package/src/server/proxy-liveness.ts +87 -15
  512. package/src/server/relay-eager.ts +36 -12
  513. package/src/server/relay.ts +189 -117
  514. package/src/server/request-body-facts.ts +48 -0
  515. package/src/server/request-decompress.ts +65 -2
  516. package/src/server/request-log-account-rotation.ts +6 -0
  517. package/src/server/request-log-attempt-usage.ts +69 -0
  518. package/src/server/request-log-cache-affinity.ts +60 -0
  519. package/src/server/request-log-conversation.ts +45 -2
  520. package/src/server/request-log-terminal-status.ts +210 -24
  521. package/src/server/request-log.ts +76 -80
  522. package/src/server/reserve-capability-startup.ts +32 -0
  523. package/src/server/responses/adapter-continuation.ts +2 -1
  524. package/src/server/responses/adapter-delivery.ts +4 -0
  525. package/src/server/responses/adapter-dispatch.ts +36 -17
  526. package/src/server/responses/advisor-plan-slot.ts +33 -1
  527. package/src/server/responses/advisor-question.ts +21 -0
  528. package/src/server/responses/advisor-slot.ts +10 -3
  529. package/src/server/responses/antigravity-fault-rotation.ts +24 -0
  530. package/src/server/responses/antigravity-validation-refusal.ts +43 -6
  531. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  532. package/src/server/responses/buffered-sse-json.ts +9 -3
  533. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  534. package/src/server/responses/codex-tool-catalog.ts +156 -0
  535. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  536. package/src/server/responses/combo-selection-keepalive.ts +254 -0
  537. package/src/server/responses/combo-stream-preflight.ts +557 -54
  538. package/src/server/responses/compact.ts +32 -8
  539. package/src/server/responses/core-codex-account.ts +17 -3
  540. package/src/server/responses/core-combo-failure.ts +8 -0
  541. package/src/server/responses/core-combo.ts +55 -12
  542. package/src/server/responses/core-errors.ts +13 -7
  543. package/src/server/responses/core-lifetime.ts +3 -2
  544. package/src/server/responses/core-normalize.ts +3 -1
  545. package/src/server/responses/core-options.ts +14 -0
  546. package/src/server/responses/core.ts +23 -0
  547. package/src/server/responses/estimated-usage.ts +115 -0
  548. package/src/server/responses/fetch-helpers.ts +15 -10
  549. package/src/server/responses/jev-model-invoke.ts +7 -2
  550. package/src/server/responses/native-replay-guard.ts +57 -0
  551. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  552. package/src/server/responses/outbound-request-body.ts +29 -0
  553. package/src/server/responses/passthrough-completion.ts +109 -9
  554. package/src/server/responses/passthrough-delivery.ts +77 -18
  555. package/src/server/responses/passthrough-dispatch.ts +77 -73
  556. package/src/server/responses/policy-fallback.ts +13 -1
  557. package/src/server/responses/request-prepare.ts +59 -11
  558. package/src/server/responses/request-transport.ts +10 -3
  559. package/src/server/responses/reset-replay.ts +46 -2
  560. package/src/server/responses/run-turn-execution.ts +2 -0
  561. package/src/server/responses/sidecar-execution.ts +19 -0
  562. package/src/server/responses/terminal-error-redaction.ts +222 -25
  563. package/src/server/responses/ws-upstream.ts +2 -2
  564. package/src/server/sse-payload-rewrite.ts +3 -2
  565. package/src/server/stop-service-route.ts +85 -0
  566. package/src/server/system-env-shell.ts +12 -1
  567. package/src/server/system-env.ts +5 -3
  568. package/src/server/windows-tcp-drop.ts +21 -4
  569. package/src/server/workflow-refusal.ts +8 -0
  570. package/src/server/ws-bridge.ts +191 -12
  571. package/src/service/cli-windows-stop.ts +189 -0
  572. package/src/service/cli.ts +41 -12
  573. package/src/service/desktop-supervision.d.mts +2 -0
  574. package/src/service/desktop-supervision.mjs +5 -0
  575. package/src/service/disconnected-client-restart.ts +60 -0
  576. package/src/service/guarded-manager-target.ts +18 -1
  577. package/src/service/health.ts +99 -6
  578. package/src/service/launchd.ts +84 -31
  579. package/src/service/orchestration.ts +418 -91
  580. package/src/service/repair.ts +223 -6
  581. package/src/service/restart-proxy-stop.ts +79 -0
  582. package/src/service/service-child-ownership.ts +6 -2
  583. package/src/service/windows-checked-stop-live.ts +467 -0
  584. package/src/service/windows-checked-stop.ts +435 -0
  585. package/src/service/windows-command-line-token.ts +23 -0
  586. package/src/service/windows-guarded-manager.ts +77 -34
  587. package/src/service/windows-ops.ts +38 -56
  588. package/src/service/windows-process-evidence.ts +292 -0
  589. package/src/service/windows-process-native.ts +262 -0
  590. package/src/service/windows-service-stop.ts +321 -0
  591. package/src/service/windows-stop-binding.ts +187 -0
  592. package/src/service/windows-stop-budget.ts +123 -0
  593. package/src/service/windows-stop-confirm.ts +158 -0
  594. package/src/service/windows-stop-deadline.ts +56 -0
  595. package/src/service.ts +2 -2
  596. package/src/stall-timeout.ts +11 -0
  597. package/src/types/config.ts +57 -110
  598. package/src/types/link.ts +20 -0
  599. package/src/types/multi-agent.ts +13 -0
  600. package/src/types/provider.ts +60 -2
  601. package/src/types/request.ts +23 -0
  602. package/src/types/routed-catalog-defaults.ts +17 -0
  603. package/src/types/routing-profile.ts +90 -0
  604. package/src/types.ts +4 -0
  605. package/src/update/guarded-runtime-ops.ts +5 -7
  606. package/src/update/index.ts +26 -11
  607. package/src/update/install-detection.mjs +3 -1
  608. package/src/update/job-pinned-start.ts +2 -0
  609. package/src/update/job-windows-restart.ts +19 -32
  610. package/src/update/job.ts +12 -5
  611. package/src/update/npm-install.d.mts +11 -0
  612. package/src/update/npm-install.mjs +44 -7
  613. package/src/update/orchestrated-entry.ts +1 -1
  614. package/src/update/orchestrated-node-driver.mjs +3 -2
  615. package/src/update/orchestrated-pnpm.d.mts +4 -0
  616. package/src/update/orchestrated-pnpm.mjs +50 -6
  617. package/src/update/orchestrated-session.d.mts +3 -1
  618. package/src/update/orchestrated-session.mjs +21 -6
  619. package/src/update/pnpm-global-install.d.mts +21 -3
  620. package/src/update/pnpm-global-install.mjs +322 -19
  621. package/src/update/pnpm-store-layout.mjs +46 -0
  622. package/src/update/sync-update-mutex.d.mts +3 -2
  623. package/src/update/sync-update-mutex.mjs +57 -8
  624. package/src/update/transactional-install.d.mts +3 -1
  625. package/src/update/transactional-install.mjs +545 -12
  626. package/src/update/windows-installer-marker.d.mts +1 -0
  627. package/src/update/windows-installer-marker.mjs +44 -0
  628. package/src/usage/expected-prices.ts +8 -0
  629. package/src/usage/filter-index.ts +326 -77
  630. package/src/usage/ledger-scanner.ts +15 -0
  631. package/src/usage/link-log-fields.ts +48 -0
  632. package/src/usage/log.ts +57 -6
  633. package/src/usage/request-body.ts +37 -0
  634. package/src/usage/telemetry-contract.ts +1 -0
  635. package/src/web-search/loop.ts +3 -0
  636. package/src/web-search/passthrough-bridge.ts +7 -0
  637. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  638. package/gui/dist/assets/brand-mark-DU-0Vdkr.js +0 -1
  639. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  640. package/gui/dist/assets/index-DJEkIDAi.css +0 -2
  641. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  642. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  643. package/gui/dist/classic/assets/quota-summary-CakPe9Ni.js +0 -1
  644. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,252 @@
1
+ import type { OcxConfig, OcxProviderConfig } from "../types";
2
+ import { getConfigDir } from "../config/paths";
3
+ import { isEgressTransparentExecutor, markEgressTransparentExecutor } from "../lib/provider-egress";
4
+ import { isPassiveKeyDeferred, isPassiveKeyTransparent, PASSIVE_KEY_SEND } from "../lib/passive-key-fetch-proof";
5
+ import { isKeychainReference, passiveKeychainGeneration, peekResolvedProviderKey, resolveProviderApiKeyPassively } from "./api-key-resolve";
6
+ import { passiveKeyLimits, type PassiveKeyProvider } from "./quota/passive-key-limits";
7
+ import { extractPassiveWireModel } from "./quota/passive-wire-model";
8
+
9
+ const destinations = new Map<string, PassiveKeyProvider>([
10
+ ["https://api.openai.com", "openai"], ["https://api.anthropic.com", "anthropic"],
11
+ ["https://api.x.ai", "xai"], ["https://api.groq.com", "groq"], ["https://api.mistral.ai", "mistral"],
12
+ ]);
13
+ const paths: Record<PassiveKeyProvider, readonly string[]> = {
14
+ openai: ["/v1/chat/completions", "/v1/responses", "/v1/responses/compact"],
15
+ anthropic: ["/v1/messages"], xai: ["/v1/chat/completions", "/v1/responses"],
16
+ groq: ["/openai/v1/chat/completions"], mistral: ["/v1/chat/completions"],
17
+ };
18
+ let sequence = 0;
19
+ const seenResponses = new WeakSet<Response>();
20
+ // Account identities contain only hashes. Eviction also revokes reservations in the limit cache.
21
+ const incarnations = new Map<string, { home: string; name: string; owner: string }>();
22
+ const MAX_INCARNATIONS = 512;
23
+
24
+ /** Fields that can change the destination or account owning a passive observation. */
25
+ export function passiveProviderOwnership(provider: OcxProviderConfig | undefined): unknown {
26
+ if (!provider) return null;
27
+ return structuredClone({
28
+ adapter: provider.adapter, baseUrl: provider.baseUrl, authMode: provider.authMode ?? "key",
29
+ disabled: provider.disabled === true, apiKey: provider.apiKey,
30
+ apiKeyPool: provider.apiKeyPool?.map(({ id, key, disabled }) => ({ id, key, disabled: disabled === true }))
31
+ .sort((a, b) => a.id.localeCompare(b.id) || a.key.localeCompare(b.key)),
32
+ apiKeyTransport: provider.apiKeyTransport, headers: provider.headers,
33
+ responsesPath: provider.responsesPath, chatCompletionsPath: provider.chatCompletionsPath,
34
+ modelAdapters: provider.modelAdapters,
35
+ });
36
+ }
37
+
38
+ /**
39
+ * Invalidate both stored and in-flight observations after key-store mutation.
40
+ *
41
+ * The home is captured here rather than read per entry: rows observed under another config
42
+ * home belong to that installation and stay untouched.
43
+ */
44
+ export function clearPassiveKeyLimits(name?: string, home: string = getConfigDir()): void {
45
+ passiveKeyLimits.clear(home, name);
46
+ for (const [scope, entry] of incarnations) {
47
+ if (entry.home === home && (name === undefined || entry.name === name)) incarnations.delete(scope);
48
+ }
49
+ }
50
+
51
+ function accountScope(home: string, name: string, id: string): string {
52
+ return new Bun.CryptoHasher("sha256").update(JSON.stringify([home, name, id])).digest("hex");
53
+ }
54
+ /** Stable opaque identifier for quota presentation, scoped to this installation and provider. */
55
+ export function passiveKeyQuotaId(name: string, id: string, home: string = getConfigDir()): string {
56
+ return accountScope(home, name, id);
57
+ }
58
+
59
+ /** Retire all models and outstanding reservations for one account incarnation. */
60
+ export function clearPassiveKeyAccount(name: string, id: string, home: string = getConfigDir()): void {
61
+ const scope = accountScope(home, name, id);
62
+ passiveKeyLimits.clear(home, name, scope);
63
+ incarnations.delete(scope);
64
+ }
65
+
66
+ function keyId(reference: string): string {
67
+ return new Bun.CryptoHasher("sha256").update(reference).digest("hex").slice(0, 8);
68
+ }
69
+
70
+ function identity(home: string, name: string, provider: OcxProviderConfig, id: string, reference: string, key: string | undefined): string | undefined {
71
+ const generation = isKeychainReference(reference) ? passiveKeychainGeneration(reference, key) : null;
72
+ if (generation === undefined) return undefined;
73
+ if (generation !== null) key = undefined;
74
+ return new Bun.CryptoHasher("sha256").update(JSON.stringify([home, name, provider.adapter, provider.baseUrl, id, reference, key, generation])).digest("hex");
75
+ }
76
+
77
+ function currentKey(reference: string): string | undefined {
78
+ return resolveProviderApiKeyPassively(reference);
79
+ }
80
+
81
+ function remember(home: string, name: string, id: string, owner: string): { home: string; name: string; owner: string } {
82
+ const scope = accountScope(home, name, id);
83
+ const previous = incarnations.get(scope);
84
+ if (previous && previous.owner !== owner) clearPassiveKeyAccount(name, id, home);
85
+ incarnations.delete(scope);
86
+ const incarnation = previous?.owner === owner ? previous : { home, name, owner };
87
+ incarnations.set(scope, incarnation);
88
+ if (incarnations.size > MAX_INCARNATIONS) {
89
+ const oldest = incarnations.keys().next().value!;
90
+ const entry = incarnations.get(oldest)!;
91
+ passiveKeyLimits.clear(entry.home, entry.name, oldest);
92
+ incarnations.delete(oldest);
93
+ }
94
+ return incarnation;
95
+ }
96
+
97
+ /** Poll only accounts already observed; a changed value revokes every model and flight. */
98
+ function currentOwner(home: string, name: string, provider: OcxProviderConfig, id: string, reference: string): string | undefined {
99
+ const existing = incarnations.get(accountScope(home, name, id));
100
+ if (!existing) return undefined;
101
+ // A cache clear suspends proof until routing rereads the account. Keep the bounded
102
+ // observation for a matching reread, but never expose it while unverified.
103
+ if (isKeychainReference(reference) && peekResolvedProviderKey(reference) === undefined) return undefined;
104
+ try {
105
+ const key = isKeychainReference(reference) ? undefined : currentKey(reference);
106
+ const owner = (key || isKeychainReference(reference)) && identity(home, name, provider, id, reference, key);
107
+ if (owner === existing.owner) return owner;
108
+ } catch { /* A malformed account cannot invalidate another account's projection. */ }
109
+ clearPassiveKeyAccount(name, id, home);
110
+ return undefined;
111
+ }
112
+
113
+ /** A selected account remains the owner after a different account becomes active. */
114
+ function stillConfigured(config: OcxConfig, name: string, snapshot: OcxProviderConfig, home: string): boolean {
115
+ const current = config.providers[name];
116
+ const selection = snapshot._apiKeyAttempt;
117
+ if (!current || current.disabled || !selection?.reference || !snapshot.apiKey
118
+ || (current.authMode !== undefined && current.authMode !== "key")
119
+ || current.adapter !== snapshot.adapter || current.baseUrl !== snapshot.baseUrl) return false;
120
+ const reference = selection.reference;
121
+ if (current.apiKeyPool?.length) {
122
+ const row = current.apiKeyPool.find(entry => entry.id === selection.entryId && entry.key === reference);
123
+ if (!row || row.disabled) return false;
124
+ } else if (current.apiKey !== reference) return false;
125
+ const id = selection.entryId ?? keyId(reference);
126
+ const matches = isKeychainReference(reference)
127
+ ? passiveKeychainGeneration(reference, snapshot.apiKey) !== undefined
128
+ : currentKey(reference) === snapshot.apiKey;
129
+ if (!matches) {
130
+ currentOwner(home, name, current, id, reference);
131
+ return false;
132
+ }
133
+ return true;
134
+ }
135
+
136
+ /** Record only a configured key at the final destination and credential boundary. */
137
+ export function passiveKeyPhysicalFetch(
138
+ physicalFetch: typeof globalThis.fetch, config: OcxConfig, name: string, provider: OcxProviderConfig,
139
+ ): typeof globalThis.fetch {
140
+ if (!isPassiveKeyTransparent(physicalFetch) || (provider.authMode !== undefined && provider.authMode !== "key") || !provider.apiKey || !provider._apiKeyAttempt?.reference) return physicalFetch;
141
+ const snapshot = { ...provider, _apiKeyAttempt: { ...provider._apiKeyAttempt } };
142
+ // The observing home is captured with the send. A later config-home change cannot migrate or
143
+ // expose these rows, and management reads resolve their own home independently.
144
+ const home = getConfigDir();
145
+ const wrapped = (async (input, init) => {
146
+ const url = input instanceof Request ? input.url : String(input);
147
+ let destination: URL;
148
+ try { destination = new URL(url); } catch { return physicalFetch(input, init); }
149
+ const vendor = destinations.get(destination.origin);
150
+ const key = snapshot.apiKey!;
151
+ let owned = false;
152
+ try {
153
+ owned = !!vendor && new URL(snapshot.baseUrl).origin === destination.origin
154
+ && destination.protocol === "https:" && !destination.username && !destination.password
155
+ && paths[vendor].includes(destination.pathname) && !destination.search && !destination.hash
156
+ && (vendor !== "openai" || key.startsWith("sk-"));
157
+ } catch { /* An unprovable owner cannot receive a passive observation. */ }
158
+ if (owned) {
159
+ const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
160
+ const expectedAuth = vendor === "anthropic" && snapshot.apiKeyTransport !== "bearer"
161
+ ? headers.get("x-api-key") === key && !headers.has("authorization")
162
+ : headers.get("authorization") === `Bearer ${key}` && !headers.has("x-api-key");
163
+ try { owned = !headers.has("api-key") && expectedAuth && stillConfigured(config, name, snapshot, home); }
164
+ catch { owned = false; /* An unprovable owner cannot receive a passive observation. */ }
165
+ }
166
+ const wireBody = init?.body;
167
+ const model = owned ? extractPassiveWireModel(wireBody) : undefined;
168
+ const delayed = isPassiveKeyDeferred(physicalFetch);
169
+ const generation = isKeychainReference(snapshot._apiKeyAttempt!.reference!) ? passiveKeychainGeneration(snapshot._apiKeyAttempt!.reference!, key) : undefined;
170
+ let reservation: ReturnType<typeof passiveKeyLimits.reserve>;
171
+ let atSend: ((wireInput: RequestInfo | URL, wireInit?: RequestInit) => void) | undefined;
172
+ try {
173
+ if (owned && vendor && model) {
174
+ const reference = snapshot._apiKeyAttempt!.reference!;
175
+ const id = snapshot._apiKeyAttempt!.entryId ?? keyId(reference);
176
+ const owner = identity(home, name, snapshot, id, reference, key);
177
+ if (owner) {
178
+ const scope = accountScope(home, name, id);
179
+ const incarnation = remember(home, name, id, owner);
180
+ atSend = (wireInput, wireInit) => {
181
+ try {
182
+ if (delayed) {
183
+ const wireUrl = wireInput instanceof Request ? wireInput.url : String(wireInput);
184
+ const headers = new Headers(wireInit?.headers ?? (wireInput instanceof Request ? wireInput.headers : undefined));
185
+ const authMatches = vendor === "anthropic" && snapshot.apiKeyTransport !== "bearer"
186
+ ? headers.get("x-api-key") === key && !headers.has("authorization")
187
+ : headers.get("authorization") === `Bearer ${key}` && !headers.has("x-api-key");
188
+ if (wireUrl !== url || headers.has("api-key") || !authMatches || wireInit?.body !== wireBody) return;
189
+ }
190
+ if (incarnations.get(scope) !== incarnation || !stillConfigured(config, name, snapshot, home)
191
+ || (isKeychainReference(reference) && (generation === undefined || generation !== passiveKeychainGeneration(reference, key)))) return;
192
+ reservation = passiveKeyLimits.reserve({ home, owner, provider: vendor, model, namespace: name, account: scope }, ++sequence);
193
+ } catch { /* Observation cannot prevent a proxied send. */ }
194
+ };
195
+ }
196
+ }
197
+ } catch { /* Reservation failure cannot prevent a proxied send. */ }
198
+ try {
199
+ if (!delayed) atSend?.(input, init);
200
+ const physicalInit = delayed && atSend ? Object.assign({}, init, { [PASSIVE_KEY_SEND]: atSend }) : init;
201
+ const response = await physicalFetch(input, physicalInit);
202
+ const reused = seenResponses.has(response);
203
+ seenResponses.add(response);
204
+ try {
205
+ if (reservation && !reused && (!isKeychainReference(snapshot._apiKeyAttempt!.reference!) || (generation !== undefined && generation === passiveKeychainGeneration(snapshot._apiKeyAttempt!.reference!, key))) && stillConfigured(config, name, snapshot, home)) {
206
+ reservation.record(response.headers, Date.now(), response.status);
207
+ }
208
+ } catch { /* Passive display evidence must not fail the proxied response. */ }
209
+ return response;
210
+ } finally { reservation?.cancel(); }
211
+ }) as typeof globalThis.fetch;
212
+ return isEgressTransparentExecutor(physicalFetch) ? markEgressTransparentExecutor(wrapped) : wrapped;
213
+ }
214
+
215
+ /** Read the current configured key only; missing or replaced keys cannot inherit observations. */
216
+ export function getPassiveKeyLimits(config: OcxConfig, name: string, model: string) {
217
+ const provider = config.providers[name];
218
+ if (!provider || (provider.authMode !== undefined && provider.authMode !== "key") || !provider.apiKey) return [];
219
+ let vendor: PassiveKeyProvider | undefined;
220
+ try { vendor = destinations.get(new URL(provider.baseUrl).origin); } catch { return []; }
221
+ if (!vendor) return [];
222
+ const id = provider.apiKeyPool?.find(entry => entry.key === provider.apiKey)?.id ?? keyId(provider.apiKey);
223
+ const home = getConfigDir();
224
+ const owner = currentOwner(home, name, provider, id, provider.apiKey);
225
+ if (!owner) return [];
226
+ return owner ? passiveKeyLimits.get({ home, owner, provider: vendor, model }, Date.now()) : [];
227
+ }
228
+
229
+ /** Cached-only projection, scoped to configured account IDs and without credential material. */
230
+ export function listPassiveKeyLimits(config: OcxConfig) {
231
+ const result: Array<{ provider: string; keyId: string; model: string; windows: ReturnType<typeof passiveKeyLimits.get> }> = [];
232
+ const home = getConfigDir();
233
+ for (const [name, provider] of Object.entries(config.providers)) {
234
+ if (provider.disabled || (provider.authMode !== undefined && provider.authMode !== "key")) continue;
235
+ let vendor: PassiveKeyProvider | undefined;
236
+ try { vendor = destinations.get(new URL(provider.baseUrl).origin); } catch { continue; }
237
+ if (!vendor) continue;
238
+ const entries = provider.apiKeyPool?.length ? provider.apiKeyPool : provider.apiKey
239
+ ? [{ id: keyId(provider.apiKey), key: provider.apiKey }] : [];
240
+ for (const entry of entries) {
241
+ try {
242
+ if ("disabled" in entry && entry.disabled) continue;
243
+ const owner = currentOwner(home, name, provider, entry.id, entry.key);
244
+ if (!owner) continue;
245
+ for (const reading of passiveKeyLimits.list(home, owner, vendor, Date.now())) {
246
+ result.push({ provider: name, keyId: passiveKeyQuotaId(name, entry.id, home), ...reading });
247
+ }
248
+ } catch { /* One invalid account cannot reject the whole projection. */ }
249
+ }
250
+ }
251
+ return result;
252
+ }
@@ -17,7 +17,7 @@ import { replaceCachedProviderQuotas } from "../quota-routing-cache";
17
17
  import { getProviderRegistryEntry } from "../registry";
18
18
  import { getProviderQuotaReportCache, hasQuotaRows, routingEvidence, setProviderQuotaReportCache } from "./report-cache";
19
19
  import { isCanonicalCommandCodeBaseUrl, isCanonicalKimiCodeBaseUrl } from "./vendor-probes-key";
20
- import { isWeeklyAllowancePercent, type AccountQuotaMode, type ProviderQuota, type ProviderQuotaWindow, type QuotaFailureCode } from "../quota-types";
20
+ import { isDisplayOnlyQuota, isWeeklyAllowancePercent, type AccountQuotaMode, type ProviderQuota, type ProviderQuotaWindow, type QuotaFailureCode } from "../quota-types";
21
21
  import type { OcxConfig, OcxProviderConfig } from "../../types";
22
22
 
23
23
  /** Match oauth/index REFRESH_SKEW_MS — use stored access without refresh when still fresh. */
@@ -181,6 +181,7 @@ export function persistAccountQuotaCache(): void {
181
181
  const liveKiro = new Map<string, ProviderAccount>(getAccountSet("kiro")?.accounts.map(account =>
182
182
  [accountCacheKey("kiro", account.id), account]) ?? []);
183
183
  for (const [key, entry] of accountQuotaCache) {
184
+ if (entry.quota && isDisplayOnlyQuota(entry.quota)) continue;
184
185
  const quota = isAnthropicAccountCacheKey(key) ? normalizeAnthropicQuota(entry.quota, now) : entry.quota;
185
186
  if (quota && key.startsWith("kiro\0")) {
186
187
  const account = liveKiro.get(key);
@@ -0,0 +1,121 @@
1
+ import type { OcxConfig } from "../../types";
2
+ import { ANTHROPIC_INSTANCE_IDS, type AnthropicInstanceId } from "../anthropic-instance-id";
3
+ import { getAccountSet } from "../../oauth/store";
4
+ import { anthropicRoutingFor } from "../../oauth/anthropic-routing";
5
+ import { registerStateSweepAfterTick, STATE_SWEEP_INTERVAL_MS } from "../../lib/state-store-sweeper";
6
+ import { fetchAnthropicAccountQuota } from "./anthropic-account-quota";
7
+
8
+ /**
9
+ * Background recovery for Anthropic quota cooldowns.
10
+ *
11
+ * A 429 cools the account until the deadline upstream named, and a fresh usage read that shows
12
+ * every rejected window open lifts it early (#6989). Until now that read only happened when
13
+ * something else asked for quota: the dashboard, `ocx account refresh`, or a reset admitted
14
+ * through this proxy. A Claude Code user whose window was reset elsewhere (a reset grant spent
15
+ * in the Claude app, a plan upgrade) kept receiving "temporarily rate-limited" from a pool
16
+ * whose accounts upstream had already reopened, until the old deadline or a manual
17
+ * clear-cooldown.
18
+ *
19
+ * This worker issues that read itself, on the shared state sweep, for every account whose
20
+ * cooldown is claimable. The read goes through `fetchAnthropicAccountQuota`, so the claim,
21
+ * generation fence and settlement are the same ones a dashboard read uses; the worker adds only
22
+ * the trigger and its pacing.
23
+ */
24
+
25
+ /** First retry after a read that kept the cooldown. Doubles per retained read up to the cap. */
26
+ export const ANTHROPIC_COOLDOWN_RECOVERY_PROBE_MIN_MS = STATE_SWEEP_INTERVAL_MS;
27
+ export const ANTHROPIC_COOLDOWN_RECOVERY_PROBE_MAX_MS = 10 * 60_000;
28
+
29
+ type RecoveryAttempt = { generation: number; nextAt: number; delayMs: number };
30
+ type DueProbe = { instance: AnthropicInstanceId; accountId: string; key: string; generation: number };
31
+
32
+ /** Keyed per instance and account; bound to the cooldown generation the backoff was earned by. */
33
+ const attempts = new Map<string, RecoveryAttempt>();
34
+ let inFlight: Promise<void> | null = null;
35
+
36
+ function attemptKey(instance: AnthropicInstanceId, accountId: string): string {
37
+ return `${instance}\0${accountId}`;
38
+ }
39
+
40
+ function anthropicInstanceProbesUsage(config: OcxConfig, instance: AnthropicInstanceId): boolean {
41
+ const target = config.providers[instance];
42
+ return !!target && target.disabled !== true && target.authMode === "oauth";
43
+ }
44
+
45
+ /** Cooled accounts whose refusal a usage read may lift and whose backoff has elapsed. */
46
+ export function dueAnthropicCooldownRecoveryProbes(config: OcxConfig, now = Date.now()): DueProbe[] {
47
+ const due: DueProbe[] = [];
48
+ const live = new Set<string>();
49
+ for (const instance of ANTHROPIC_INSTANCE_IDS) {
50
+ if (!anthropicInstanceProbesUsage(config, instance)) continue;
51
+ const set = getAccountSet(instance);
52
+ if (!set) continue;
53
+ const routing = anthropicRoutingFor(instance);
54
+ for (const row of set.accounts) {
55
+ // A paused or signed-out account is refused by the probe before any request; skip it here.
56
+ if (row.paused === true || row.needsReauth === true) continue;
57
+ const key = attemptKey(instance, row.id);
58
+ const claim = routing.captureAnthropicCooldownRecovery(row.id, now);
59
+ // A refusal that named no window settles as retained whatever usage shows: never read for it.
60
+ if (!claim || !claim.namesRejectedWindow) continue;
61
+ live.add(key);
62
+ // A deadline the sweeper reaches first needs no upstream read.
63
+ const until = routing.getAnthropicAccountHealthSnapshot(row.id, now)?.cooldownUntil;
64
+ if (until === undefined || until - now <= STATE_SWEEP_INTERVAL_MS) continue;
65
+ const attempt = attempts.get(key);
66
+ if (attempt && attempt.generation === claim.cooldownGeneration && attempt.nextAt > now) continue;
67
+ due.push({ instance, accountId: row.id, key, generation: claim.cooldownGeneration });
68
+ }
69
+ }
70
+ // A lifted, expired or removed cooldown drops its backoff with it.
71
+ for (const key of attempts.keys()) if (!live.has(key)) attempts.delete(key);
72
+ return due;
73
+ }
74
+
75
+ function settleAttempt(probe: DueProbe, now: number): void {
76
+ const claim = anthropicRoutingFor(probe.instance).captureAnthropicCooldownRecovery(probe.accountId, now);
77
+ // Lifted, or replaced by a newer refusal that earns its own first read on the next sweep.
78
+ if (!claim || claim.cooldownGeneration !== probe.generation) { attempts.delete(probe.key); return; }
79
+ const previous = attempts.get(probe.key);
80
+ const delayMs = previous?.generation === probe.generation
81
+ ? Math.min(previous.delayMs * 2, ANTHROPIC_COOLDOWN_RECOVERY_PROBE_MAX_MS)
82
+ : ANTHROPIC_COOLDOWN_RECOVERY_PROBE_MIN_MS;
83
+ attempts.set(probe.key, { generation: probe.generation, nextAt: now + delayMs, delayMs });
84
+ }
85
+
86
+ /**
87
+ * One pass over every due cooled account. Single-flight: a sweep that fires while a pass is
88
+ * still reading joins it. Reads are sequential; a pool rarely has more than a few cooled accounts
89
+ * and this must never stampede the usage endpoint.
90
+ */
91
+ export async function runAnthropicCooldownRecoveryProbes(config: OcxConfig, now = Date.now()): Promise<void> {
92
+ if (inFlight) return inFlight;
93
+ inFlight = (async () => {
94
+ for (const probe of dueAnthropicCooldownRecoveryProbes(config, now)) {
95
+ try {
96
+ // Force bypasses the TTL; fresh dispatch refuses to join an older flight whose evidence
97
+ // predates the claim. Settlement happens inside the probe under the generation fence.
98
+ await fetchAnthropicAccountQuota(probe.instance, probe.accountId, true, config, true);
99
+ } catch {
100
+ // A stale or disowned probe settles nothing; the cooldown is kept and retried on backoff.
101
+ }
102
+ settleAttempt(probe, Date.now());
103
+ }
104
+ })().catch(() => {
105
+ // Background recovery is best-effort; routing keeps the cooldown on failure.
106
+ }).finally(() => { inFlight = null; });
107
+ return inFlight;
108
+ }
109
+
110
+ export function registerAnthropicCooldownRecoveryProbeWorker(config: OcxConfig): () => void {
111
+ return registerStateSweepAfterTick({
112
+ name: "anthropic-cooldown-recovery",
113
+ afterTick: () => { void runAnthropicCooldownRecoveryProbes(config); },
114
+ });
115
+ }
116
+
117
+ /** Test-only: drop the backoff table and the single-flight promise. */
118
+ export function clearAnthropicCooldownRecoveryProbeStateForTests(): void {
119
+ attempts.clear();
120
+ inFlight = null;
121
+ }
@@ -0,0 +1,272 @@
1
+ import { anthropicRateLimitHeaders } from "../../server/anthropic-rate-limit-headers";
2
+
3
+ export type PassiveKeyProvider = "openai" | "xai" | "groq" | "anthropic" | "mistral";
4
+ export type PassiveKeyLimit = {
5
+ dimension: "requests" | "tokens" | "input-tokens" | "output-tokens";
6
+ window?: "minute" | "day" | "month";
7
+ observedAt: number;
8
+ limit?: number;
9
+ remaining?: number;
10
+ resetAt?: number;
11
+ };
12
+ export type PassiveKeyLimitReading = PassiveKeyLimit & { stale: boolean };
13
+ /**
14
+ * `home` is the config home that observed the send. Two installations can hold the same
15
+ * provider and API key, so the credential alone does not identify a counter: without this
16
+ * dimension home B would read, replace, or retire home A's rows.
17
+ */
18
+ export type PassiveKeyIdentity = {
19
+ owner: string; provider: PassiveKeyProvider; model: string; home: string;
20
+ namespace?: string; account?: string;
21
+ };
22
+
23
+ const PROVIDERS: readonly string[] = ["openai", "xai", "groq", "anthropic", "mistral"];
24
+ const MAX_COUNT = 1_000_000_000_000;
25
+ const MAX_TIME = 253_402_300_799_999;
26
+ const MAX_DURATION_MS = 30 * 24 * 60 * 60 * 1000;
27
+ const MAX_ENTRIES = 512;
28
+ const MAX_RETENTION_MS = 24 * 60 * 60 * 1000;
29
+
30
+ function timestamp(value: number): boolean {
31
+ return Number.isSafeInteger(value) && value >= 0 && value <= MAX_TIME;
32
+ }
33
+
34
+ // Mistral's private count helper has the same integer grammar but lives in the transport
35
+ // module; importing it here would also import transport and pacing. Keep this parser bounded.
36
+ function count(value: string | null | undefined): number | undefined {
37
+ if (value == null || value.length > 128 || !/^\d{1,16}$/.test(value.trim())) return undefined;
38
+ const parsed = Number(value.trim());
39
+ return Number.isSafeInteger(parsed) && parsed <= MAX_COUNT ? parsed : undefined;
40
+ }
41
+
42
+ /** Strict, descending units; arithmetic is exact and accepts only whole milliseconds. */
43
+ function duration(value: string | null): number | undefined {
44
+ if (value === null || value.length > 64) return undefined;
45
+ const input = value.trim();
46
+ const part = /(\d+(?:\.\d+)?)(ms|h|m|s)/gy;
47
+ const units: Record<string, [number, bigint]> = { h: [3, 3_600_000n], m: [2, 60_000n], s: [1, 1000n], ms: [0, 1n] };
48
+ let cursor = 0, previous = 4, total = 0n;
49
+ while (cursor < input.length) {
50
+ part.lastIndex = cursor;
51
+ const match = part.exec(input);
52
+ if (!match) return undefined;
53
+ const [rank, multiplier] = units[match[2]!]!;
54
+ if (rank >= previous) return undefined;
55
+ const [whole, fraction = ""] = match[1]!.split(".");
56
+ const scale = 10n ** BigInt(fraction.length);
57
+ const scaled = (BigInt(whole!) * scale + BigInt(fraction || "0")) * multiplier;
58
+ if (scaled % scale !== 0n) return undefined;
59
+ total += scaled / scale;
60
+ if (total > BigInt(MAX_DURATION_MS)) return undefined;
61
+ previous = rank;
62
+ cursor = part.lastIndex;
63
+ }
64
+ return cursor === 0 ? undefined : Number(total);
65
+ }
66
+
67
+ /** Parse only known header families; absent or invalid values never imply zero. */
68
+ export function parsePassiveKeyLimits(provider: PassiveKeyProvider, headers: Headers, observedAt: number): PassiveKeyLimit[] {
69
+ if (!PROVIDERS.includes(provider) || !timestamp(observedAt)) return [];
70
+ const normalized = provider === "anthropic" ? anthropicRateLimitHeaders(headers) : undefined;
71
+ const result: PassiveKeyLimit[] = [];
72
+ const add = (dimension: PassiveKeyLimit["dimension"], limit: number | undefined, remaining: number | undefined,
73
+ resetAt?: number, window?: PassiveKeyLimit["window"]) => {
74
+ result.push({ dimension, ...(window ? { window } : {}), observedAt,
75
+ ...(limit !== undefined ? { limit } : {}), ...(remaining !== undefined ? { remaining } : {}),
76
+ ...(resetAt !== undefined && timestamp(resetAt) ? { resetAt } : {}) });
77
+ };
78
+ if (provider === "anthropic") {
79
+ for (const dimension of ["requests", "input-tokens", "output-tokens", "tokens"] as const) {
80
+ const base = `anthropic-ratelimit-${dimension}`;
81
+ const date = normalized?.[`${base}-reset`];
82
+ add(dimension, count(normalized?.[`${base}-limit`]), count(normalized?.[`${base}-remaining`]), date ? Date.parse(date) : undefined);
83
+ }
84
+ } else if (provider === "mistral") {
85
+ for (const [dimension, wire, window] of [["requests", "req", "minute"], ["tokens", "tokens", "minute"], ["tokens", "tokens", "month"]] as const) {
86
+ add(dimension, count(headers.get(`x-ratelimit-limit-${wire}-${window}`)),
87
+ count(headers.get(`x-ratelimit-remaining-${wire}-${window}`)), undefined, window);
88
+ }
89
+ } else {
90
+ for (const dimension of ["requests", "tokens"] as const) {
91
+ const reset = duration(headers.get(`x-ratelimit-reset-${dimension}`));
92
+ add(dimension, count(headers.get(`x-ratelimit-limit-${dimension}`)),
93
+ count(headers.get(`x-ratelimit-remaining-${dimension}`)), reset === undefined ? undefined : observedAt + reset,
94
+ provider === "groq" ? (dimension === "requests" ? "day" : "minute") : undefined);
95
+ }
96
+ }
97
+ return result;
98
+ }
99
+
100
+ type Entry = {
101
+ sequence: number; rows: PassiveKeyLimit[]; pending: number; home: string;
102
+ namespace?: string; account?: string; timer?: ReturnType<typeof setTimeout>;
103
+ };
104
+ export type PassiveKeyLimitReservation = {
105
+ /** `status` is the physical response status: a redirect is not a quota reading. */
106
+ record(headers: Headers, observedAt: number, status: number): boolean;
107
+ cancel(): void;
108
+ };
109
+
110
+ /** In-memory only. Callers supply opaque owner IDs and globally increasing send sequences. */
111
+ export class PassiveKeyLimitCache {
112
+ private readonly entries = new Map<string, Entry>();
113
+ private readonly maxEntries: number;
114
+ private readonly retentionMs: number;
115
+
116
+ constructor(options: { maxEntries?: number; retentionMs?: number } = {}) {
117
+ this.maxEntries = options.maxEntries ?? MAX_ENTRIES;
118
+ this.retentionMs = options.retentionMs ?? MAX_RETENTION_MS;
119
+ if (!Number.isSafeInteger(this.maxEntries) || this.maxEntries < 1 || this.maxEntries > MAX_ENTRIES
120
+ || !Number.isSafeInteger(this.retentionMs) || this.retentionMs < 1 || this.retentionMs > MAX_RETENTION_MS) {
121
+ throw new RangeError("Invalid passive key cache bounds");
122
+ }
123
+ }
124
+
125
+ clear(home: string, namespace?: string, account?: string): void {
126
+ for (const [key, entry] of this.entries) {
127
+ if (entry.home !== home) continue;
128
+ if (namespace !== undefined && entry.namespace !== namespace) continue;
129
+ if (account !== undefined && entry.account !== account) continue;
130
+ if (entry.timer) clearTimeout(entry.timer);
131
+ this.entries.delete(key);
132
+ }
133
+ }
134
+
135
+ private key(identity: PassiveKeyIdentity): string | undefined {
136
+ if (!identity || typeof identity.owner !== "string" || identity.owner.length < 1 || identity.owner.length > 256
137
+ || typeof identity.home !== "string" || identity.home.length < 1 || identity.home.length > 1024
138
+ || !PROVIDERS.includes(identity.provider) || (identity.namespace !== undefined && (typeof identity.namespace !== "string" || identity.namespace.length > 128)) || typeof identity.model !== "string"
139
+ || !/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(identity.model)) return undefined;
140
+ const ownerHash = new Bun.CryptoHasher("sha256").update(identity.owner).digest("hex");
141
+ const homeHash = new Bun.CryptoHasher("sha256").update(identity.home).digest("hex");
142
+ return JSON.stringify([homeHash, ownerHash, identity.provider, identity.model]);
143
+ }
144
+
145
+ /**
146
+ * Reserve immediately before the physical send. Record once on an eligible response;
147
+ * cancel in finally on failures, cancellation, or an ineligible response. Eviction
148
+ * or clear invalidates the reservation even if the same identity is later recreated.
149
+ * Reservations live with the caller, not in an unbounded cache-side collection.
150
+ */
151
+ reserve(identity: PassiveKeyIdentity, sequence: number): PassiveKeyLimitReservation | undefined {
152
+ const key = this.key(identity);
153
+ if (!key || !Number.isSafeInteger(sequence) || sequence < 0) return undefined;
154
+ let entry = this.entries.get(key);
155
+ if (!entry) {
156
+ entry = { sequence: -1, rows: [], pending: 0, home: identity.home, namespace: identity.namespace, account: identity.account };
157
+ this.entries.set(key, entry);
158
+ this.evictOverflow();
159
+ }
160
+ const reservedEntry = entry;
161
+ const reservedIdentity = { ...identity };
162
+ reservedEntry.pending++;
163
+ let active = true;
164
+ const release = () => {
165
+ if (!active) return false;
166
+ active = false;
167
+ reservedEntry.pending--;
168
+ if (reservedEntry.pending === 0 && reservedEntry.sequence === -1 && reservedEntry.rows.length === 0 && this.entries.get(key) === reservedEntry) {
169
+ this.entries.delete(key);
170
+ }
171
+ return true;
172
+ };
173
+ return {
174
+ record: (headers, observedAt, status) => {
175
+ if (!active) return false;
176
+ try {
177
+ return this.entries.get(key) === reservedEntry && this.record(reservedIdentity, headers, observedAt, sequence, status);
178
+ } finally { release(); }
179
+ },
180
+ cancel: () => { release(); },
181
+ };
182
+ }
183
+
184
+ /** Legacy response-only API; use reserve at send time to fence eviction races. */
185
+ record(identity: PassiveKeyIdentity, headers: Headers, observedAt: number, sequence: number, status: number): boolean {
186
+ const key = this.key(identity);
187
+ if (!key || !timestamp(observedAt) || !Number.isSafeInteger(sequence) || sequence < 0) return false;
188
+ // A redirect is never a reading: its headers belong to the intermediary, and counting one
189
+ // would let a headerless manual 302 advance the fence over a real response that is still in
190
+ // flight. Refusals stay eligible — a 429's cells are the most useful observation there is.
191
+ if (!Number.isInteger(status) || status < 100 || status > 599 || (status >= 300 && status < 400)) return false;
192
+ const parsed = parsePassiveKeyLimits(identity.provider, headers, observedAt);
193
+ // A parsed response with no count, remaining value or reset in any family proves nothing.
194
+ // It must not advance the sequence fence or replace a retained numeric measurement.
195
+ const current = this.entries.get(key);
196
+ if (!parsed.some(row => row.limit !== undefined || row.remaining !== undefined || row.resetAt !== undefined)) {
197
+ if (current?.rows.length) return false;
198
+ const entry: Entry = current ?? { sequence: -1, rows: [], pending: 0, home: identity.home, namespace: identity.namespace, account: identity.account };
199
+ entry.rows = parsed;
200
+ entry.timer = setTimeout(() => { entry.rows = []; entry.timer = undefined; }, this.retentionMs);
201
+ entry.timer.unref();
202
+ this.entries.set(key, entry);
203
+ this.evictOverflow();
204
+ return true;
205
+ }
206
+ if (current && sequence <= current.sequence) return false;
207
+ const rows = parsed.flatMap(row => {
208
+ if (row.limit !== undefined || row.remaining !== undefined || row.resetAt !== undefined) return [row];
209
+ const previous = current?.rows.find(item => item.dimension === row.dimension && item.window === row.window
210
+ && (item.limit !== undefined || item.remaining !== undefined || item.resetAt !== undefined)
211
+ && observedAt >= item.observedAt && observedAt - item.observedAt < this.retentionMs);
212
+ // Keep the new unknown observation as a fallback after the older measurement expires.
213
+ return previous ? [previous, row] : [row];
214
+ });
215
+ if (current?.timer) clearTimeout(current.timer);
216
+ const entry: Entry = current ?? { sequence, rows, pending: 0, home: identity.home, namespace: identity.namespace, account: identity.account };
217
+ entry.sequence = sequence;
218
+ entry.rows = rows;
219
+ entry.timer = setTimeout(() => { entry.rows = []; entry.timer = undefined; }, this.retentionMs);
220
+ entry.timer.unref();
221
+ this.entries.delete(key);
222
+ this.entries.set(key, entry);
223
+ this.evictOverflow();
224
+ return true;
225
+ }
226
+
227
+ private evictOverflow(): void {
228
+ if (this.entries.size <= this.maxEntries) return;
229
+ const oldest = this.entries.keys().next().value!;
230
+ const timer = this.entries.get(oldest)?.timer;
231
+ if (timer) clearTimeout(timer);
232
+ this.entries.delete(oldest);
233
+ }
234
+
235
+ get(identity: PassiveKeyIdentity, now: number): PassiveKeyLimitReading[] {
236
+ const key = this.key(identity);
237
+ if (!key || !timestamp(now)) return [];
238
+ const entry = this.entries.get(key);
239
+ if (!entry) return [];
240
+ entry.rows = entry.rows.filter(row => now < row.observedAt || now - row.observedAt < this.retentionMs);
241
+ const seen = new Set<string>();
242
+ const rows = entry.rows.filter(row => {
243
+ if (now < row.observedAt) return false;
244
+ const kind = `${row.dimension}:${row.window ?? ""}`;
245
+ if (seen.has(kind)) return false;
246
+ seen.add(kind);
247
+ return true;
248
+ });
249
+ // Keep the sequence fence until eviction; freshness applies to the returned rows.
250
+ this.entries.delete(key);
251
+ this.entries.set(key, entry);
252
+ return rows.map(row => ({ ...row, stale: row.resetAt !== undefined && now >= row.resetAt }));
253
+ }
254
+
255
+ list(home: string, owner: string, provider: PassiveKeyProvider, now: number): { model: string; windows: PassiveKeyLimitReading[] }[] {
256
+ if (typeof home !== "string" || !home || home.length > 1024
257
+ || typeof owner !== "string" || !owner || owner.length > 256 || !PROVIDERS.includes(provider) || !timestamp(now)) return [];
258
+ const homeHash = new Bun.CryptoHasher("sha256").update(home).digest("hex");
259
+ const ownerHash = new Bun.CryptoHasher("sha256").update(owner).digest("hex");
260
+ const models = Array.from(this.entries.keys()).flatMap(key => {
261
+ const [storedHome, storedOwner, storedProvider, model] = JSON.parse(key) as [string, string, string, string];
262
+ return storedHome === homeHash && storedOwner === ownerHash && storedProvider === provider ? [model] : [];
263
+ });
264
+ return models.flatMap(model => {
265
+ const windows = this.get({ home, owner, provider, model }, now);
266
+ return windows.length ? [{ model, windows }] : [];
267
+ });
268
+ }
269
+ }
270
+
271
+ /** One process-local cache, shared by the physical response and management readers. */
272
+ export const passiveKeyLimits = new PassiveKeyLimitCache();