@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
@@ -114,11 +114,11 @@ const ANTIGRAVITY_WIRE_IDS_BY_PICKER_MODEL: Record<string, string[]> = Object.en
114
114
  }, {});
115
115
 
116
116
  const ANTIGRAVITY_DISCOVERY_EFFORTS = ["low", "medium", "high"] as const;
117
- type AntigravityDiscoveryEffort = typeof ANTIGRAVITY_DISCOVERY_EFFORTS[number];
117
+ type AntigravityDiscoveryEffort = typeof ANTIGRAVITY_DISCOVERY_EFFORTS[number] | "xhigh";
118
118
  type AntigravityEffortWireModelIds = Partial<Record<AntigravityDiscoveryEffort, string>>;
119
119
 
120
120
  function isAntigravityDiscoveryEffort(value: string): value is AntigravityDiscoveryEffort {
121
- return (ANTIGRAVITY_DISCOVERY_EFFORTS as readonly string[]).includes(value);
121
+ return [...ANTIGRAVITY_DISCOVERY_EFFORTS, "xhigh"].includes(value as AntigravityDiscoveryEffort);
122
122
  }
123
123
 
124
124
  function pickerModelIdForDiscoveredWireId(
@@ -144,7 +144,7 @@ function pickerModelIdForDiscoveredWireId(
144
144
  if (isKnownAntigravityPickerModelId(baseId)) return baseId;
145
145
  }
146
146
 
147
- const effortMatch = /^(.*)-(low|medium|high)$/.exec(wireId);
147
+ const effortMatch = /^(.*)-(low|medium|high|xhigh)$/.exec(wireId);
148
148
  if (effortMatch) {
149
149
  const baseId = effortMatch[1]!;
150
150
  if (isValidModelDiscoveryModelId(baseId)
@@ -278,7 +278,7 @@ function completeDiscoveredEffortWireModelIds(
278
278
  const explicitEffortMap = Object.hasOwn(ANTIGRAVITY_EFFORT_WIRE_MAP, pickerId)
279
279
  ? ANTIGRAVITY_EFFORT_WIRE_MAP[pickerId] : undefined;
280
280
  if (explicitEffortMap && Object.values(explicitEffortMap).every(wireId => available.has(wireId))) {
281
- return { ...explicitEffortMap };
281
+ return { ...explicitEffortMap, ...(available.has(`${pickerId}-xhigh`) ? { xhigh: `${pickerId}-xhigh` } : {}) };
282
282
  }
283
283
 
284
284
  if (!isValidModelDiscoveryModelId(pickerId)) return undefined;
@@ -288,9 +288,28 @@ function completeDiscoveredEffortWireModelIds(
288
288
  if (!available.has(wireId)) return undefined;
289
289
  suffixEffortMap[effort] = wireId;
290
290
  }
291
+ if (available.has(`${pickerId}-xhigh`)) suffixEffortMap.xhigh = `${pickerId}-xhigh`;
291
292
  return suffixEffortMap;
292
293
  }
293
294
 
295
+ /**
296
+ * Default rung for a model known only from live discovery. Gemini 4 Hydrogen defaults to high:
297
+ * its low/medium/high/xhigh ladder and high default were verified on Vertex AI by #8583's author
298
+ * (2026-11-13). On CCA it is entitlement-gated: an account whose discovery listed the four
299
+ * `gemini-4-hydrogen-*` tiers answered an xhigh request with 200 (2026-11-12), so this applies only
300
+ * once that account's CCA discovery lists the family. Other discovered families keep medium when they have it.
301
+ */
302
+ const ANTIGRAVITY_DISCOVERED_DEFAULT_EFFORT: Record<string, string> = {
303
+ "gemini-4-hydrogen": "high",
304
+ };
305
+
306
+ /** Default effort the catalog publishes, and routing applies, for a discovered effort family. */
307
+ export function discoveredAntigravityDefaultEffort(modelId: string, hasMedium: boolean): string {
308
+ return Object.hasOwn(ANTIGRAVITY_DISCOVERED_DEFAULT_EFFORT, modelId)
309
+ ? ANTIGRAVITY_DISCOVERED_DEFAULT_EFFORT[modelId]!
310
+ : hasMedium ? "medium" : "high";
311
+ }
312
+
294
313
  // ── Default effort per Gemini base model ──
295
314
  const ANTIGRAVITY_DEFAULT_EFFORT: Record<string, string> = {
296
315
  // Google's documented thinking_level default, and the tier CCA marks `recommended`.
@@ -327,8 +346,11 @@ function pickerToWireId(pickerId: string): string {
327
346
  return ANTIGRAVITY_PICKER_TO_WIRE[pickerId] ?? pickerId;
328
347
  }
329
348
 
349
+ /** Requested efforts above `high`: they select a discovered xhigh tier when one exists, else `high`. */
350
+ const ANTIGRAVITY_ABOVE_HIGH_EFFORTS = new Set(["xhigh", "max", "ultra"]);
351
+
330
352
  function resolveAntigravityThinkingLevel(effort: string): string | undefined {
331
- if (effort === "xhigh" || effort === "max" || effort === "ultra") return "high";
353
+ if (ANTIGRAVITY_ABOVE_HIGH_EFFORTS.has(effort)) return "high";
332
354
  return ANTIGRAVITY_THINKING_LEVELS.has(effort) ? effort : undefined;
333
355
  }
334
356
 
@@ -517,7 +539,7 @@ export function registerAntigravityDiscoveredWireModels(
517
539
  const families: Record<string, AntigravitySuffixMap> = Object.create(null);
518
540
  for (const model of models) {
519
541
  if (ANTIGRAVITY_DISCOVERY_EFFORTS.every(effort => model.effortWireModelIds?.[effort] === `${model.id}-${effort}`)) {
520
- families[model.id] = { low: `${model.id}-low`, medium: `${model.id}-medium`, high: `${model.id}-high` };
542
+ families[model.id] = { low: `${model.id}-low`, medium: `${model.id}-medium`, high: `${model.id}-high`, ...(model.effortWireModelIds?.xhigh === `${model.id}-xhigh` ? { xhigh: `${model.id}-xhigh` } : {}) };
521
543
  }
522
544
  }
523
545
  writeAntigravityWireSnapshot(key, { version: 1, provider: generation.provider, families });
@@ -575,14 +597,14 @@ function discoveredAntigravityEffortWireModelId(
575
597
  const effortMap = discoveredAntigravityMapping(baseUrl)?.effortModels.get(modelId);
576
598
  if (!effortMap) return undefined;
577
599
 
578
- const requestedEffort = effort ? resolveAntigravityThinkingLevel(effort) : undefined;
600
+ const requestedEffort = effort && ANTIGRAVITY_ABOVE_HIGH_EFFORTS.has(effort) && effortMap.xhigh ? "xhigh" : effort ? resolveAntigravityThinkingLevel(effort) : undefined;
579
601
  if (requestedEffort && isAntigravityDiscoveryEffort(requestedEffort) && effortMap[requestedEffort]) {
580
602
  return effortMap[requestedEffort];
581
603
  }
582
604
 
583
605
  const defaultEffort = ANTIGRAVITY_DEFAULT_EFFORT[modelId]
584
606
  ?? ANTIGRAVITY_THINKING_LEVEL_MODELS[modelId]
585
- ?? "medium";
607
+ ?? discoveredAntigravityDefaultEffort(modelId, !!effortMap.medium);
586
608
  if (defaultEffort && isAntigravityDiscoveryEffort(defaultEffort) && effortMap[defaultEffort]) {
587
609
  return effortMap[defaultEffort];
588
610
  }
@@ -837,7 +859,8 @@ export function resolveAntigravityEffortWireModel(
837
859
  if (effortMap) {
838
860
  const suffixTiered = ANTIGRAVITY_SUFFIX_TIER_MODELS.has(modelId);
839
861
  // Normalize FIRST for suffix-tiered models. The discovery path clamps max/xhigh/ultra to
840
- // `high` before its own lookup, so a static path that skipped the clamp answered `medium`
862
+ // `high` for a family without a discovered xhigh tier (a family that has one selects it, see
863
+ // ANTIGRAVITY_ABOVE_HIGH_EFFORTS), so a static path that skipped the clamp answered `medium`
841
864
  // for the same request: one input, two tiers, decided by whether discovery happened to run.
842
865
  const requested = suffixTiered && effort
843
866
  ? resolveAntigravityThinkingLevel(effort) ?? effort
@@ -6,7 +6,7 @@ import { getConfigDir } from "../config/paths";
6
6
  import { isValidProviderName } from "../config/provider-name";
7
7
  import { isValidModelDiscoveryModelId, MODEL_DISCOVERY_MAX_MODELS, MODEL_DISCOVERY_MAX_RESPONSE_BYTES } from "./model-discovery-limits";
8
8
 
9
- export type AntigravitySuffixMap = Record<"low" | "medium" | "high", string>;
9
+ export type AntigravitySuffixMap = Record<"low" | "medium" | "high", string> & Partial<Record<"xhigh", string>>;
10
10
  export interface AntigravityWireSnapshot {
11
11
  version: 1;
12
12
  provider: string;
@@ -31,7 +31,8 @@ function validatedSnapshot(value: unknown): AntigravityWireSnapshot | undefined
31
31
  if (!isValidModelDiscoveryModelId(base) || !candidate || typeof candidate !== "object" || Array.isArray(candidate)) return undefined;
32
32
  const map = candidate as Record<string, unknown>;
33
33
  if (!EFFORTS.every(effort => map[effort] === `${base}-${effort}` && isValidModelDiscoveryModelId(map[effort]))) return undefined;
34
- families[base] = { low: `${base}-low`, medium: `${base}-medium`, high: `${base}-high` };
34
+ if (map.xhigh !== undefined && (map.xhigh !== `${base}-xhigh` || !isValidModelDiscoveryModelId(map.xhigh))) return undefined;
35
+ families[base] = { low: `${base}-low`, medium: `${base}-medium`, high: `${base}-high`, ...(map.xhigh ? { xhigh: `${base}-xhigh` } : {}) };
35
36
  }
36
37
  return { version: 1, provider: row.provider, families };
37
38
  }
@@ -11,6 +11,7 @@ import { resolveProviderApiKey } from "./api-key-resolve";
11
11
  import { captureProviderApiKeySelection, commitProviderApiKeySelection } from "./api-key-selection";
12
12
  import { forgetApiKeyRotationCursor } from "./key-failover";
13
13
  import { clearProviderQuotaCacheFor } from "./quota/report-cache";
14
+ import { clearPassiveKeyAccount } from "./passive-key-observation";
14
15
 
15
16
  export { ProviderApiKeyPausedError, isProviderApiKeyPaused } from "./api-key-pause-state";
16
17
 
@@ -81,6 +82,8 @@ export function setProviderApiKeyPausedWithResult(config: OcxConfig, name: strin
81
82
  clearProviderQuotaCacheFor(name);
82
83
  }
83
84
  }
85
+ // A pause changes which credential may own a passive observation.
86
+ if (ok) clearPassiveKeyAccount(name, id);
84
87
  return response;
85
88
  }
86
89
 
@@ -45,25 +45,57 @@ let entryFactory: ProviderKeychainEntryFactory = defaultEntryFactory;
45
45
  const resolvedCache = new Map<string, string>();
46
46
  const warnedAccounts = new Set<string>();
47
47
  let resolutionGeneration = 0;
48
+ // A digest and incarnation token retain passive ownership without retaining another secret copy.
49
+ // Only a routing read can establish this proof; passive paths never read or populate the keychain.
50
+ const passiveProofs = new Map<string, { digest: string; generation: number }>();
51
+ let nextPassiveGeneration = 0;
52
+ const MAX_PASSIVE_PROOFS = 512;
53
+
54
+ function credentialDigest(value: string): string {
55
+ return new Bun.CryptoHasher("sha256").update(value).digest("hex");
56
+ }
57
+
58
+ /** Return the observed account incarnation, optionally requiring a match to the wire key. */
59
+ export function passiveKeychainGeneration(reference: string, key?: string): number | undefined {
60
+ if (!isKeychainReference(reference)) return undefined;
61
+ const account = keychainAccount(reference);
62
+ const proof = passiveProofs.get(account);
63
+ if (!resolvedCache.has(account)) return undefined;
64
+ return proof && (key === undefined || proof.digest === credentialDigest(key)) ? proof.generation : undefined;
65
+ }
66
+
67
+ function rememberPassiveProof(account: string, value: string): void {
68
+ const digest = credentialDigest(value), previous = passiveProofs.get(account);
69
+ passiveProofs.delete(account);
70
+ passiveProofs.set(account, previous?.digest === digest ? previous : { digest, generation: ++nextPassiveGeneration });
71
+ if (passiveProofs.size > MAX_PASSIVE_PROOFS) passiveProofs.delete(passiveProofs.keys().next().value!);
72
+ }
48
73
 
49
74
  /** Advances whenever cached secrets may have changed, so derived snapshots can rebuild. */
50
75
  export function providerKeyResolutionGeneration(): number {
51
76
  return resolutionGeneration;
52
77
  }
53
78
 
79
+ /** Inspect a resolved routing credential without reading the OS, modifying the cache or publishing evidence. */
80
+ export function peekResolvedProviderKey(value: string): string | undefined {
81
+ return isKeychainReference(value) ? resolvedCache.get(keychainAccount(value)) : undefined;
82
+ }
83
+
54
84
  /** Test seam: swap the OS entry for an in-memory one and drop caches. */
55
85
  export function setProviderKeychainEntryFactoryForTests(factory: ProviderKeychainEntryFactory | null): void {
56
86
  entryFactory = factory ?? defaultEntryFactory;
57
87
  invalidateDecisionKeyQuotas();
58
88
  resolvedCache.clear();
89
+ passiveProofs.clear();
59
90
  resolutionGeneration++;
60
91
  warnedAccounts.clear();
61
92
  }
62
93
 
63
94
  /** Write-path seam: a store/restore mutated secrets, so cached reads and warnings are stale. */
64
- export function invalidateResolvedProviderKeyCache(): void {
95
+ export function invalidateResolvedProviderKeyCache(options?: { preservePassiveKeychainProofs: true }): void {
65
96
  invalidateDecisionKeyQuotas();
66
97
  resolvedCache.clear();
98
+ if (!options?.preservePassiveKeychainProofs) passiveProofs.clear();
67
99
  resolutionGeneration++;
68
100
  warnedAccounts.clear();
69
101
  }
@@ -95,16 +127,16 @@ export function providerKeychainEntry(account: string): ProviderKeychainEntry {
95
127
  };
96
128
  return {
97
129
  getPassword: () => entry.getPassword(),
98
- setPassword: password => publishCredentialSync(() => entry.setPassword(password), {
130
+ setPassword: password => publishCredentialSync(() => { passiveProofs.delete(account); entry.setPassword(password); }, {
99
131
  accounts: [account], absent: completed => completed ? [] : absent(),
100
132
  }),
101
133
  // Registered before the attempt, so a deletion that fails keeps the secret counted.
102
- deletePassword: () => publishCredentialSync(() => entry.deletePassword(), { accounts: [account], absent }),
134
+ deletePassword: () => publishCredentialSync(() => { passiveProofs.delete(account); return entry.deletePassword(); }, { accounts: [account], absent }),
103
135
  };
104
136
  }
105
137
 
106
- function readKeychain(account: string, quiet = false): string | undefined {
107
- const cached = resolvedCache.get(account);
138
+ function readKeychain(account: string, quiet = false, useCache = true): string | undefined {
139
+ const cached = useCache ? resolvedCache.get(account) : undefined;
108
140
  if (cached !== undefined) return cached;
109
141
  let value: string | null = null;
110
142
  try {
@@ -113,10 +145,14 @@ function readKeychain(account: string, quiet = false): string | undefined {
113
145
  // fall through to the single warning below
114
146
  }
115
147
  if (typeof value === "string" && value.trim()) {
116
- if (isGcpCredentialMaterial(value)) throw new Error("GCP credential JSON cannot be used as a literal API key; select a gcp-sa reference");
117
- resolvedCache.set(account, value);
148
+ if (isGcpCredentialMaterial(value)) {
149
+ if (useCache) passiveProofs.delete(account);
150
+ throw new Error("GCP credential JSON cannot be used as a literal API key; select a gcp-sa reference");
151
+ }
152
+ if (useCache) { resolvedCache.set(account, value); rememberPassiveProof(account, value); }
118
153
  return value;
119
154
  }
155
+ if (useCache) passiveProofs.delete(account);
120
156
  if (!quiet && !warnedAccounts.has(account)) {
121
157
  warnedAccounts.add(account);
122
158
  console.warn(`[opencodex] provider key reference keychain:${account} could not be read from the OS keychain; requests for this provider have no credential until the keychain is available (no plaintext fallback)`);
@@ -135,6 +171,12 @@ export function resolveProviderApiKey(value: string | undefined): string | undef
135
171
  return resolved;
136
172
  }
137
173
 
174
+ /** Resolve current display ownership without touching routing's cache, evidence, or warnings. */
175
+ export function resolveProviderApiKeyPassively(value: string | undefined): string | undefined {
176
+ if (!value) return undefined;
177
+ return isKeychainReference(value) ? readKeychain(keychainAccount(value), true, false) : resolveEnvValue(value);
178
+ }
179
+
138
180
  /** The same resolution without the unreadable-reference warning, for observe-only callers. */
139
181
  export function resolveProviderApiKeyQuietly(value: string | undefined): string | undefined {
140
182
  if (!value) return undefined;
@@ -1,5 +1,6 @@
1
1
  import type { OcxConfig, OcxProviderConfig } from "../types";
2
2
  import { isEgressTransparentExecutor, markEgressTransparentExecutor } from "../lib/provider-egress";
3
+ import { inheritPassiveKeyProof } from "../lib/passive-key-fetch-proof";
3
4
  import { isNonReplayableResponse } from "../lib/upstream-retry";
4
5
  import { providerApiKeySelectionOwnsFailure } from "./api-key-selection";
5
6
  import { recordDistributedKeyFailure } from "./key-failover";
@@ -33,6 +34,7 @@ export function distributedKeyPhysicalFetch(
33
34
  owners.set(response, owners.has(response) ? null : owner);
34
35
  return response;
35
36
  }) as typeof globalThis.fetch;
37
+ inheritPassiveKeyProof(wrapped, physicalFetch);
36
38
  return isEgressTransparentExecutor(physicalFetch) ? markEgressTransparentExecutor(wrapped) : wrapped;
37
39
  }
38
40
 
@@ -10,32 +10,74 @@ import { OPENCODE_GO_SESSION_HEADER } from "./opencode-go-transport";
10
10
  import { resolveProviderTransport, XAI_GROK_COMPATIBILITY, type OcxProviderTransport } from "./xai-transport";
11
11
  import { captureProviderApiKeySelection } from "./api-key-selection-capture";
12
12
  import { vertexEnvironmentKeyIsCurrent } from "./vertex-environment-authority";
13
+ import { cacheAffinityApplies } from "./cache-affinity";
14
+ import { currentCacheAffinityIdentity } from "./cache-affinity-identity";
13
15
 
14
16
  export { captureProviderApiKeySelection } from "./api-key-selection-capture";
15
17
 
16
- function matchesSelection(provider: OcxProviderConfig, expected: ProviderApiKeySelection): boolean {
17
- if (expected.distributed) return provider.apiKeySelectionRevision === expected.revision
18
+ export function affinitySelectionIsCurrent(name: string, provider: OcxProviderConfig, expected: ProviderApiKeySelection): boolean {
19
+ return !!expected.cacheAffinityGeneration && !!expected.entryId
20
+ && expected.cacheAffinityGeneration === currentCacheAffinityIdentity(name, provider, expected.entryId);
21
+ }
22
+
23
+ /** A stale affinity generation cannot authorize paced readmission onto another credential. */
24
+ export function providerAffinityGenerationIsCurrent(config: OcxConfig, name: string, routed: OcxProviderConfig): boolean {
25
+ const selection = routed._apiKeyAttempt;
26
+ return !selection?.cacheAffinity || !!config.providers[name]
27
+ && affinitySelectionIsCurrent(name, config.providers[name]!, selection);
28
+ }
29
+
30
+ function matchesSelection(name: string, provider: OcxProviderConfig, expected: ProviderApiKeySelection): boolean {
31
+ if (expected.distributed && !expected.cacheAffinity) return provider.apiKeySelectionRevision === expected.revision
18
32
  && provider.requestPacing?.enabled === true && provider.requestPacing.keySelection === "round-robin"
19
33
  && !!provider.apiKeyPool?.some(entry => !entry.disabled && entry.id === expected.entryId && entry.key === expected.reference);
34
+ if (expected.cacheAffinity === true) {
35
+ // Affinity picks are fenced on credential/destination generation, not selection revision.
36
+ // commitProviderApiKeySelection bumps the revision on EVERY committed key
37
+ // change — automatic rotation included — so a revision fence cannot tell
38
+ // an operator's re-selection from another conversation's rotation, and
39
+ // telling them apart is not affinity's job: the conversation keeps its
40
+ // credential while its generation lives, and the provider's cacheAffinity mode
41
+ // is the operator's override. (Ordinary captured selections keep the
42
+ // revision fence below: a permit for the previously committed key must
43
+ // not dispatch after a manual replacement.)
44
+ return cacheAffinityApplies(provider) && affinitySelectionIsCurrent(name, provider, expected) && !!expected.entryId && !!expected.reference
45
+ && (provider.apiKeyPool ?? []).some(entry => !entry.disabled && entry.id === expected.entryId && entry.key === expected.reference);
46
+ }
20
47
  const current = captureProviderApiKeySelection(provider);
21
- return current.entryId === expected.entryId && current.reference === expected.reference
22
- && current.revision === expected.revision;
48
+ if (current.revision !== expected.revision) return false;
49
+ return current.entryId === expected.entryId && current.reference === expected.reference;
23
50
  }
24
51
 
25
52
  function currentKeyProvider(config: OcxConfig, name: string, selection?: ProviderApiKeySelection, allowCooling = false): OcxProviderConfig | null {
26
53
  const configured = config.providers[name];
27
54
  if (!configured || configured.disabled) return null;
55
+ if (selection?.cacheAffinity && !cacheAffinityApplies(configured)) return null;
56
+ if (selection?.cacheAffinity && !affinitySelectionIsCurrent(name, configured, selection)) return null;
28
57
  let row = configured;
29
58
  if (selection?.distributed) {
30
59
  const entry = configured.apiKeyPool?.find(key => key.id === selection.entryId && key.key === selection.reference);
31
- if (!entry || entry.disabled || (!allowCooling && isKeyInCooldown(name, entry.id)) || configured.apiKeySelectionRevision !== selection.revision
60
+ if (!entry || entry.disabled || (!allowCooling && isKeyInCooldown(name, entry.id)) || (!selection.cacheAffinity && configured.apiKeySelectionRevision !== selection.revision)
32
61
  || !configured.requestPacing?.enabled || configured.requestPacing.keySelection !== "round-robin") return null;
33
62
  row = { ...configured, apiKey: entry.key, _apiKeyAttempt: selection };
34
63
  }
64
+ else if (selection?.cacheAffinity && selection.entryId && selection.reference) {
65
+ // A request-captured pool selection (cache affinity picks one without
66
+ // committing it globally) survives this re-read while its generation is live:
67
+ // present with the captured key, enabled, and out of cooldown. It is
68
+ // deliberately NOT fenced on the selection revision — that revision bumps
69
+ // on every committed change, automatic rotation included, so it cannot
70
+ // supersede a pick whose whole purpose is to outlast committed movement.
71
+ // An invalidated captured pick cannot authorize a different credential.
72
+ const entry = configured.apiKeyPool?.find(key => key.id === selection.entryId && key.key === selection.reference);
73
+ if (entry && !entry.disabled && (allowCooling || !isKeyInCooldown(name, entry.id))) {
74
+ row = { ...configured, apiKey: entry.key, _apiKeyAttempt: selection };
75
+ } else return null;
76
+ }
35
77
  const hasPausedActiveReference = row.apiKeyPool?.some(entry => entry.disabled && entry.key === row.apiKey)
36
78
  && !row.apiKeyPool?.some(entry => !entry.disabled && entry.key === row.apiKey);
37
79
  if (hasPausedActiveReference || row.apiKeyPool?.length && row.apiKeyPool.every(entry => entry.disabled)) return null;
38
- const current = routedProviderConfig(name, { ...row, _apiKeyAttempt: selection?.distributed ? selection : undefined });
80
+ const current = routedProviderConfig(name, { ...row, _apiKeyAttempt: row === configured ? undefined : selection });
39
81
  if (current.authMode === "oauth" || current.authMode === "forward") return null;
40
82
  if (current.authMode === "key" && !current.keyOptional && !current.apiKey?.trim()
41
83
  && !(current.adapter === "google" && current.googleMode === "vertex")) return null;
@@ -65,7 +107,7 @@ function matchesConfiguredSelection(
65
107
  const current = currentKeyProvider(config, name, expected, allowCooling);
66
108
  return current !== null && expected !== undefined
67
109
  && vertexEnvironmentKeyIsCurrent(expected, current)
68
- && (expected.distributed === true || matchesSelection(config.providers[name]!, expected))
110
+ && (expected.distributed === true || matchesSelection(name, config.providers[name]!, expected))
69
111
  && current.apiKey === routedProvider.apiKey
70
112
  && current.authMode === routedProvider.authMode
71
113
  && current.baseUrl === routedProvider.baseUrl
@@ -83,7 +125,7 @@ export function resolveCurrentProviderApiKeyTransport(
83
125
  // A permit acquired for one key cannot authorize a different key after a manual edit.
84
126
  if (routedProvider.requestPacing?.enabled && routedProvider.requestPacing.keys
85
127
  && routedProvider._apiKeyAttempt && config.providers[name]
86
- && !routedProvider._apiKeyAttempt.distributed && !matchesSelection(config.providers[name]!, routedProvider._apiKeyAttempt)) return null;
128
+ && !routedProvider._apiKeyAttempt.distributed && !matchesSelection(name, config.providers[name]!, routedProvider._apiKeyAttempt)) return null;
87
129
  const current = currentKeyProvider(config, name, routedProvider._apiKeyAttempt);
88
130
  if (!current) return null;
89
131
  const runtime = routedProvider as OcxProviderTransport;
@@ -122,7 +164,7 @@ export function commitProviderApiKeySelection<T>(
122
164
  if (!provider || provider.authMode === "oauth" || provider.authMode === "forward") {
123
165
  return { changed: false, value: { status: "unavailable" } };
124
166
  }
125
- if (expectedSelection && !matchesSelection(provider, expectedSelection)) {
167
+ if (expectedSelection && !matchesSelection(name, provider, expectedSelection)) {
126
168
  return { changed: false, value: { status: "superseded", provider: structuredClone(provider) } };
127
169
  }
128
170
  const before = provider.apiKey;
@@ -11,6 +11,7 @@ import { saveConfigPreservingClaudeCode } from "../config";
11
11
  import type { OcxConfig, OcxProviderConfig } from "../types";
12
12
  import { GCP_CREDENTIAL_MARKER_PREFIX, isGcpCredentialMaterial, parseGcpCredentialJson } from "../lib/gcp-adc";
13
13
  import { invalidateResolvedProviderKeyCache, probeProviderKeychain, providerKeychainEntry } from "./api-key-resolve";
14
+ import { clearPassiveKeyAccount } from "./passive-key-observation";
14
15
  import type { AccountQuotaFields } from "./quota-types";
15
16
  import { commitProviderApiKeySelection } from "./api-key-selection";
16
17
  import { captureProviderApiKeySelection } from "./api-key-selection-capture";
@@ -286,7 +287,8 @@ export function addProviderApiKey(config: OcxConfig, name: string, key: string,
286
287
  return { changed: true, selectionChanged: true, value: stored[0]!.id };
287
288
  });
288
289
  if (committed.status === "committed") {
289
- invalidateResolvedProviderKeyCache();
290
+ for (const entry of stored) clearPassiveKeyAccount(name, entry.id);
291
+ invalidateResolvedProviderKeyCache({ preservePassiveKeychainProofs: true });
290
292
  return { id: committed.value };
291
293
  }
292
294
  cleanupRemovedGcpCredentials(created);
@@ -314,6 +316,7 @@ export function addProviderApiKey(config: OcxConfig, name: string, key: string,
314
316
  return { changed: true, selectionChanged: true, value: id };
315
317
  });
316
318
  if (committed.status !== "committed") return { error: "provider selection unavailable" };
319
+ clearPassiveKeyAccount(name, id);
317
320
  return { id };
318
321
  }
319
322
 
@@ -369,7 +372,8 @@ export function removeProviderApiKey(config: OcxConfig, name: string, id: string
369
372
  return { changed: true, selectionChanged: activeEntryIdBefore !== activeEntryIdAfter, value: true };
370
373
  });
371
374
  if (committed.status !== "committed" || !committed.value) return false;
375
+ clearPassiveKeyAccount(name, id);
372
376
  if (removed?.startsWith(GCP_CREDENTIAL_MARKER_PREFIX)) cleanupRemovedGcpCredentials([removed]);
373
- invalidateResolvedProviderKeyCache();
377
+ invalidateResolvedProviderKeyCache({ preservePassiveKeychainProofs: true });
374
378
  return true;
375
379
  }
@@ -0,0 +1,73 @@
1
+ import { createHmac, randomBytes, randomUUID } from "node:crypto";
2
+ import type { OcxProviderConfig } from "../types";
3
+ import { routedProviderConfig } from "./routed-config";
4
+
5
+ // The fingerprint is process-local and is never included in request logs or persisted.
6
+ const fingerprintKey = randomBytes(32);
7
+ // Enumerable symbols follow the existing combo/policy context copies, while JSON and
8
+ // the request-log serializers omit them. No credential or destination is retained.
9
+ const sentIdentity = Symbol("cache-affinity-identity");
10
+ type IdentityContext = { [sentIdentity]?: string };
11
+ const generations = new Map<string, { providerName: string; entryId: string; fingerprint?: string; token: string }>();
12
+ const GENERATION_CAPACITY = 2048;
13
+
14
+ function observedIdentity(providerName: string, entryId: string, fingerprint: string | undefined): string | undefined {
15
+ const key = JSON.stringify([providerName, entryId]);
16
+ let generation = generations.get(key);
17
+ if (!generation || generation.fingerprint !== fingerprint) {
18
+ generation = { providerName, entryId, fingerprint, token: randomUUID() };
19
+ generations.delete(key);
20
+ generations.set(key, generation);
21
+ if (generations.size > GENERATION_CAPACITY) generations.delete(generations.keys().next().value!);
22
+ }
23
+ return fingerprint ? generation.token : undefined;
24
+ }
25
+
26
+ export function cacheAffinityIdentity(provider: OcxProviderConfig): string | undefined {
27
+ const selection = provider._apiKeyAttempt;
28
+ if (!selection?.entryId || !selection.reference || !provider.apiKey) return undefined;
29
+ return createHmac("sha256", fingerprintKey).update(JSON.stringify([
30
+ selection.entryId, selection.reference, provider.apiKey, provider.authMode,
31
+ provider.adapter, provider.baseUrl, provider.responsesPath, provider.chatCompletionsPath,
32
+ provider.googleMode, provider.project, provider.location, provider.apiKeyTransport,
33
+ ])).digest("hex");
34
+ }
35
+
36
+ export function currentCacheAffinityIdentity(providerName: string, provider: OcxProviderConfig | undefined, entryId: string): string | undefined {
37
+ if (!provider || provider.disabled || provider.cacheAffinity === "off" || provider.authMode === "oauth"
38
+ || provider.authMode === "forward" || (provider.apiKeyPool?.length ?? 0) < 2) {
39
+ return observedIdentity(providerName, entryId, undefined);
40
+ }
41
+ const entry = provider.apiKeyPool?.find(item => item.id === entryId && !item.disabled);
42
+ if (!entry) return observedIdentity(providerName, entryId, undefined);
43
+ try {
44
+ return observedIdentity(providerName, entryId, cacheAffinityIdentity(routedProviderConfig(providerName, { ...provider, apiKey: entry.key,
45
+ _apiKeyAttempt: { entryId: entry.id, reference: entry.key } })));
46
+ } catch {
47
+ return observedIdentity(providerName, entryId, undefined);
48
+ }
49
+ }
50
+
51
+ export function captureCacheAffinityIdentity(context: object, providerName: string, provider: OcxProviderConfig): void {
52
+ const selection = provider._apiKeyAttempt;
53
+ const entryId = selection?.entryId;
54
+ const identity = selection?.cacheAffinity ? selection.cacheAffinityGeneration
55
+ : entryId ? observedIdentity(providerName, entryId, cacheAffinityIdentity(provider)) : undefined;
56
+ if (identity) (context as IdentityContext)[sentIdentity] = identity;
57
+ else delete (context as IdentityContext)[sentIdentity];
58
+ }
59
+
60
+ export function capturedCacheAffinityIdentity(context: object): string | undefined {
61
+ return (context as IdentityContext)[sentIdentity];
62
+ }
63
+
64
+ /** Also observe in-flight credentials which have not yet produced a binding. */
65
+ export function reconcileCacheAffinityIdentities(providers: Readonly<Record<string, OcxProviderConfig>>): void {
66
+ for (const { providerName, entryId } of [...generations.values()]) {
67
+ currentCacheAffinityIdentity(providerName, providers[providerName], entryId);
68
+ }
69
+ }
70
+
71
+ export function clearCacheAffinityIdentitiesForTests(): void {
72
+ generations.clear();
73
+ }