@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
@@ -6,6 +6,12 @@ import { mirrorDesiredEnabledOntoSnapshot } from "./claude-desktop-config-writer
6
6
  import { ensureManagementClaudeIntercept, interceptStartRefusal } from "./claude-intercept-routes";
7
7
  import { persistCommittedDesktopGateway } from "../../claude/desktop-gateway-state";
8
8
  import { commitClaudeCodeBlock } from "../../claude/claude-code-block";
9
+ import { HomeAsideIntentDerivationError, initializeHomeRouteIntentDefaults } from "../../routing/home-route-intent";
10
+ import { homeHasLinks } from "../../routing/home-route-capture";
11
+ import { recordHomeNativeDecision, RouteIntentStateUnreadableError } from "../../routing/route-intent-state";
12
+ import { withDurableRouteNativeSettings } from "../../routing/route-to-live-settings";
13
+ import { withLinkApply, LinkApplyBusyError } from "../../client/link-home";
14
+ import { ConfigMutationLockError, withConfigMutationLockSync } from "../../config/mutation-lock";
9
15
  /**
10
16
  * Toggle routes for the integrations that are NOT file-merged clients.
11
17
  *
@@ -62,6 +68,8 @@ import { managementInferencePort, type ManagementContext } from "./context";
62
68
 
63
69
  export type NativeIntegrationClientId = "claude" | "grok" | "codex" | "claude-desktop";
64
70
 
71
+ type NativeDecisionContext = ManagementContext & { decisionProgress?: { desiredEnabled?: boolean } };
72
+
65
73
  /** Every reason this module can decline, in one place (audit r3 #6). */
66
74
  export type NativeRefusalReason =
67
75
  | "not_installed"
@@ -115,7 +123,12 @@ export interface NativeRefusalEnvelope {
115
123
  /** Present on every post-commit refusal; absent only for pre-commit refusals. */
116
124
  desiredEnabled?: boolean;
117
125
  residualPaths?: string[];
118
- diagnostic?: InterceptSecretDiagnostic;
126
+ diagnostic?: InterceptSecretDiagnostic | NativeConfigDiagnostic;
127
+ }
128
+
129
+ interface NativeConfigDiagnostic {
130
+ stage: "config";
131
+ cause: "SQLITE_NOTADB" | "SQLITE_CORRUPT" | "SQLITE_CANTOPEN" | "SQLITE_IOERR" | "EACCES" | "EPERM" | "ENOENT" | "EIO" | "unknown";
119
132
  }
120
133
 
121
134
  export type NativePostCommitRefusalEnvelope = Omit<NativeRefusalEnvelope, "desiredEnabled"> & {
@@ -127,7 +140,7 @@ function refusal(
127
140
  clientId: NativeIntegrationClientId,
128
141
  reason: NativeRefusalReason,
129
142
  message: string,
130
- extra: Pick<NativeRefusalEnvelope, "desiredEnabled" | "residualPaths"> = {},
143
+ extra: Pick<NativeRefusalEnvelope, "desiredEnabled" | "residualPaths" | "diagnostic"> = {},
131
144
  ): Response {
132
145
  return jsonResponse({
133
146
  error: status >= 500 ? "native integration change failed" : "native integration change refused",
@@ -274,12 +287,66 @@ function grokStatus(config: ManagementContext["config"]): NativeStatus {
274
287
  * whole class to a retryable 409 would tell the user to retry a lock file they
275
288
  * cannot open, which fails identically forever (audit r8 #2).
276
289
  */
277
- function isLockContention(error: unknown): boolean {
290
+ function isConfigMutationContention(error: unknown): boolean {
278
291
  if (!error || typeof error !== "object") return false;
279
292
  const cause = (error as { cause?: { code?: unknown } }).cause;
280
293
  return cause?.code === "SQLITE_BUSY";
281
294
  }
282
295
 
296
+ function configFailureDiagnostic(error: unknown): NativeConfigDiagnostic {
297
+ const cause = error instanceof ConfigMutationLockError || error instanceof ConfigWritePublishedError ? error.cause : error;
298
+ const code = cause && typeof cause === "object" && "code" in cause ? cause.code : undefined;
299
+ const allowed: readonly NativeConfigDiagnostic["cause"][] = ["SQLITE_NOTADB", "SQLITE_CORRUPT", "SQLITE_CANTOPEN", "SQLITE_IOERR", "EACCES", "EPERM", "ENOENT", "EIO"];
300
+ return { stage: "config", cause: allowed.find(value => value === code) ?? "unknown" };
301
+ }
302
+
303
+ /** ACL admission and Home apply exclusion precede this synchronous C section. */
304
+ async function commitNativeDecision(
305
+ ctx: NativeDecisionContext, clientId: NativeIntegrationClientId, enabled: boolean,
306
+ persist: () => boolean | Response,
307
+ ): Promise<Response | null> {
308
+ let published = false;
309
+ try {
310
+ return await settleConfigRoot(configRoot(), () => withConfigMutationLockSync(() => {
311
+ // Capture the Children's defaults from the durable switches before this one changes, under
312
+ // the rule every Home-only switch writer follows: only once the Home has a link. Another
313
+ // process may have changed the switches since this server loaded its snapshot. A Home with
314
+ // no link has no Child to protect, so the toggle changes only the switch.
315
+ const linked = homeHasLinks();
316
+ if (linked) initializeHomeRouteIntentDefaults(withDurableRouteNativeSettings(ctx.config), ctx.version);
317
+ const result = persist();
318
+ if (result instanceof Response) return result;
319
+ published = result;
320
+ if (published && ctx.decisionProgress) ctx.decisionProgress.desiredEnabled = enabled;
321
+ // The switch just written is the Home's decision; route intent keeps no Home entry for it.
322
+ if (linked) recordHomeNativeDecision(clientId);
323
+ if (ctx.decisionProgress) ctx.decisionProgress.desiredEnabled = enabled;
324
+ return null;
325
+ }));
326
+ } catch (error) {
327
+ if (error instanceof WindowsSecretAclSettleTimeoutError && !published) {
328
+ const firstParty = clientId === "claude-desktop" && resolveClaudeDesktopApplyMode(ctx.config, observeClaudeDesktopMode(ctx.config)) === "first-party";
329
+ return refusal(500, clientId, "write_failed", "Config ACL settlement timed out. Nothing was written; retry after it settles.",
330
+ firstParty ? { diagnostic: { stage: "ca", cause: "ETIMEDOUT" } } : {});
331
+ }
332
+ if (error instanceof HomeAsideIntentDerivationError) return refusal(409, clientId, "metadata_unreadable",
333
+ "Existing Aside ownership could not be resolved. Repair the Aside accounts.json manifest and stable userId selection, or choose an explicit Home Aside intent with ocx route to aside on or ocx route to aside off, then retry. Existing policy was preserved.");
334
+ if (error instanceof RouteIntentStateUnreadableError && !published) return refusal(500, clientId, "metadata_unreadable", error.message);
335
+ if (published || error instanceof ConfigWritePublishedError) {
336
+ if (clientId === "claude-desktop" && error instanceof ConfigWritePublishedError) mirrorDesiredEnabledOntoSnapshot(ctx.config, clientId, enabled);
337
+ const busy = isConfigLockError(error) && isConfigMutationContention(error);
338
+ return postCommitRefusal(busy ? 409 : 500, clientId, busy ? "config_busy" : "write_failed",
339
+ "The native switch was saved, but Home route intent or configuration bookkeeping did not complete. Repair configuration storage if needed, then retry the same switch to reconcile Home intent and apply it.",
340
+ { desiredEnabled: enabled, diagnostic: configFailureDiagnostic(error) });
341
+ }
342
+ const busy = isConfigLockError(error) && isConfigMutationContention(error);
343
+ return refusal(busy ? 409 : 500, clientId, busy ? "config_busy" : "write_failed",
344
+ busy ? "Another process is saving the configuration right now. Nothing was written; retry in a moment."
345
+ : "The native decision could not be saved. Inspect and repair configuration storage, then retry.",
346
+ busy ? {} : { diagnostic: configFailureDiagnostic(error) });
347
+ }
348
+ }
349
+
283
350
  function isConfigLockError(error: unknown): boolean {
284
351
  return !!error && typeof error === "object"
285
352
  && (error as { code?: unknown }).code === "CONFIG_MUTATION_LOCK_UNAVAILABLE";
@@ -334,7 +401,7 @@ let codexToggleFlight: Promise<Response> | null = null;
334
401
  * reads the persisted intent and converges — whereas converging first and dying
335
402
  * would leave artifacts the next start silently undoes.
336
403
  */
337
- async function handleCodexToggle(ctx: ManagementContext): Promise<Response> {
404
+ async function handleCodexToggle(ctx: NativeDecisionContext): Promise<Response> {
338
405
  const { req } = ctx;
339
406
  if (codexToggleFlight) {
340
407
  return refusal(409, "codex", "config_busy",
@@ -354,21 +421,27 @@ async function handleCodexToggle(ctx: ManagementContext): Promise<Response> {
354
421
  const enabled = body.enabled;
355
422
 
356
423
  const { setCodexIntegrationEnabled } = await import("../../codex/desired-state");
357
- const persisted = setCodexIntegrationEnabled(enabled);
424
+ let decisionResult!: ReturnType<typeof setCodexIntegrationEnabled>;
358
425
  /*
359
426
  * `missing` does not block the switch — see the Grok route for the reasoning.
360
427
  * A user with no config file yet still gets the artifact change; what they
361
428
  * lose is durability across a restart, and the envelope says so rather than
362
429
  * implying the switch failed.
363
430
  */
364
- if (!persisted.ok && persisted.reason !== "missing") {
365
- return refusal(
366
- persisted.retryable ? 409 : 500,
367
- "codex",
368
- persisted.retryable ? "config_busy" : "write_failed",
369
- persisted.message,
370
- );
371
- }
431
+ const decisionRefusal = await commitNativeDecision(ctx, "codex", enabled, () => {
432
+ decisionResult = setCodexIntegrationEnabled(enabled);
433
+ if (!decisionResult.ok && decisionResult.reason !== "missing") {
434
+ return refusal(
435
+ decisionResult.retryable ? 409 : 500,
436
+ "codex",
437
+ decisionResult.retryable ? "config_busy" : "write_failed",
438
+ decisionResult.message,
439
+ );
440
+ }
441
+ return decisionResult.ok;
442
+ });
443
+ if (decisionRefusal) return decisionRefusal;
444
+ const persisted = decisionResult;
372
445
  const durable = persisted.ok;
373
446
 
374
447
  if (enabled) {
@@ -435,7 +508,7 @@ async function handleCodexToggle(ctx: ManagementContext): Promise<Response> {
435
508
  }
436
509
  }
437
510
 
438
- async function handleGrokToggle(ctx: ManagementContext): Promise<Response> {
511
+ async function handleGrokToggle(ctx: NativeDecisionContext): Promise<Response> {
439
512
  const { req, config, deps } = ctx;
440
513
  /*
441
514
  * The guard stands BEFORE the first await, or two concurrent PUTs could both
@@ -482,7 +555,7 @@ async function handleGrokToggle(ctx: ManagementContext): Promise<Response> {
482
555
  * on, where the other order leaves artifacts the next start undoes.
483
556
  */
484
557
  const { setGrokIntegrationEnabled } = await import("../../codex/desired-state");
485
- const persisted = setGrokIntegrationEnabled(enabled);
558
+ let decisionResult!: ReturnType<typeof setGrokIntegrationEnabled>;
486
559
  /*
487
560
  * `missing` does NOT block the toggle here.
488
561
  *
@@ -494,14 +567,20 @@ async function handleGrokToggle(ctx: ManagementContext): Promise<Response> {
494
567
  * on the envelope says. `conflict` and `invalid` are different: another
495
568
  * writer won, or the file is malformed and must not be overwritten.
496
569
  */
497
- if (!persisted.ok && persisted.reason !== "missing") {
498
- return refusal(
499
- persisted.retryable ? 409 : 500,
500
- "grok",
501
- persisted.retryable ? "config_busy" : "write_failed",
502
- persisted.message,
503
- );
504
- }
570
+ const decisionRefusal = await commitNativeDecision(ctx, "grok", enabled, () => {
571
+ decisionResult = setGrokIntegrationEnabled(enabled);
572
+ if (!decisionResult.ok && decisionResult.reason !== "missing") {
573
+ return refusal(
574
+ decisionResult.retryable ? 409 : 500,
575
+ "grok",
576
+ decisionResult.retryable ? "config_busy" : "write_failed",
577
+ decisionResult.message,
578
+ );
579
+ }
580
+ return decisionResult.ok;
581
+ });
582
+ if (decisionRefusal) return decisionRefusal;
583
+ const persisted = decisionResult;
505
584
  const durable = persisted.ok;
506
585
  const desiredEnabled = durable ? loadConfig().clientIntegrations?.grok !== false : enabled;
507
586
 
@@ -701,7 +780,7 @@ async function persistDesktopModeMarker(config: ManagementContext["config"], des
701
780
 
702
781
  let claudeDesktopToggleFlight: Promise<Response> | null = null;
703
782
 
704
- async function handleClaudeDesktopToggle(ctx: ManagementContext): Promise<Response> {
783
+ async function handleClaudeDesktopToggle(ctx: NativeDecisionContext): Promise<Response> {
705
784
  if (claudeDesktopToggleFlight) {
706
785
  return refusal(409, "claude-desktop", "config_busy",
707
786
  "Another Claude Desktop change is already in flight. Nothing was written — try again in a moment.");
@@ -719,17 +798,15 @@ async function handleClaudeDesktopToggle(ctx: ManagementContext): Promise<Respon
719
798
 
720
799
  const { setIntegrationEnabled } = await import("../../codex/desired-state");
721
800
  const enabled = body.enabled;
722
- const persisted = await settleConfigRoot(configRoot(), () => {
801
+ const decisionRefusal = await commitNativeDecision(ctx, "claude-desktop", enabled, () => {
723
802
  const result = setIntegrationEnabled("claude-desktop", enabled);
724
803
  if (result.ok) {
725
804
  committedDesiredEnabled = enabled;
726
805
  mirrorDesiredEnabledOntoSnapshot(ctx.config, "claude-desktop", enabled);
727
806
  }
728
- return result;
807
+ return result.ok ? true : refusal(result.retryable ? 409 : 500, "claude-desktop", result.retryable ? "config_busy" : "write_failed", result.message);
729
808
  });
730
- if (!persisted.ok) {
731
- return refusal(persisted.retryable ? 409 : 500, "claude-desktop", persisted.retryable ? "config_busy" : "write_failed", persisted.message);
732
- }
809
+ if (decisionRefusal) return decisionRefusal;
733
810
  const desiredEnabled = loadConfig().clientIntegrations?.["claude-desktop"] !== false;
734
811
  committedDesiredEnabled = desiredEnabled;
735
812
  const current = loadConfig();
@@ -922,7 +999,7 @@ function persistedIntentConfig(snapshot: ManagementContext["config"]): Managemen
922
999
  }
923
1000
  }
924
1001
 
925
- export async function handleNativeIntegrationRoutes(ctx: ManagementContext): Promise<Response | null> {
1002
+ async function handleNativeIntegrationRoutesUnlocked(ctx: NativeDecisionContext): Promise<Response | null> {
926
1003
  const { req, url, config, deps } = ctx;
927
1004
 
928
1005
  if (url.pathname === "/api/native-integrations" && req.method === "GET") {
@@ -949,53 +1026,51 @@ export async function handleNativeIntegrationRoutes(ctx: ManagementContext): Pro
949
1026
  }
950
1027
 
951
1028
  const enabled = body.enabled;
952
- if (claudeCodeEnabled(config) === enabled) {
953
- // Re-run the same reconcile on a repeated OFF: definitions left behind by an older
954
- // version that never pruned on disable are removed the next time the user says off.
1029
+ let changed = false;
1030
+ const decisionRefusal = await commitNativeDecision(ctx, "claude", enabled, () => {
1031
+ changed = claudeCodeEnabled(config) !== enabled;
1032
+ if (!changed) return true;
1033
+
1034
+ /*
1035
+ * Same block writer as PUT /api/claude-code: it stamps the migration sentinel.
1036
+ * Toggling Claude ON is one of the two ways a block gets CREATED, so without the
1037
+ * sentinel the next startServer would silently convert a user's Auto auth mode into
1038
+ * a sticky manual subscription — a failure that surfaces nowhere near this route.
1039
+ */
1040
+ // Kept so a failed save leaves the shared in-memory config matching disk: otherwise a
1041
+ // retry on the same object would read the unsaved value, take the repeated-OFF branch
1042
+ // and prune agents while the persisted integration is still on.
1043
+ const previousBlock = config.claudeCode === undefined ? undefined : structuredClone(config.claudeCode);
1044
+ commitClaudeCodeBlock(config, { ...(config.claudeCode ?? {}), enabled });
1045
+
1046
+ /*
1047
+ * `deps.` first: ManagementApiDeps carries this seam so route tests with an
1048
+ * in-memory fixture cannot overwrite the developer's real OPENCODEX_HOME.
1049
+ */
1050
+ const persist = deps.saveConfigPreservingClaudeCode ?? saveConfigPreservingClaudeCode;
1051
+ try {
1052
+ persist(config);
1053
+ } catch (error) {
1054
+ // A published write already put the new value on disk; only an unpublished one rolls back.
1055
+ if (!(error instanceof ConfigWritePublishedError)) {
1056
+ if (previousBlock === undefined) delete config.claudeCode;
1057
+ else config.claudeCode = previousBlock;
1058
+ }
1059
+ throw error;
1060
+ }
1061
+ return true;
1062
+ });
1063
+ if (decisionRefusal) return decisionRefusal;
1064
+ if (!changed) {
1065
+ // Repeated OFF also prunes definitions left by older versions.
955
1066
  if (!enabled) await ctx.syncClaudeAgentDefsBestEffort?.();
956
1067
  return jsonResponse({
957
1068
  ok: true, clientId: "claude", changed: false,
958
- state: enabled ? "current" : "absent",
959
- desiredEnabled: enabled,
1069
+ state: enabled ? "current" : "absent", desiredEnabled: enabled,
960
1070
  message: enabled ? "Claude inbound is already on" : "Claude inbound is already off",
961
1071
  } satisfies NativeToggleEnvelope);
962
1072
  }
963
1073
 
964
- /*
965
- * Same block writer as PUT /api/claude-code: it stamps the migration sentinel.
966
- * Toggling Claude ON is one of the two ways a block gets CREATED, so without the
967
- * sentinel the next startServer would silently convert a user's Auto auth mode into
968
- * a sticky manual subscription — a failure that surfaces nowhere near this route.
969
- */
970
- // Kept so a failed save leaves the shared in-memory config matching disk: otherwise a
971
- // retry on the same object would read the unsaved value, take the repeated-OFF branch
972
- // and prune agents while the persisted integration is still on.
973
- const previousBlock = config.claudeCode === undefined ? undefined : structuredClone(config.claudeCode);
974
- commitClaudeCodeBlock(config, { ...(config.claudeCode ?? {}), enabled });
975
-
976
- /*
977
- * `deps.` first: ManagementApiDeps carries this seam so route tests with an
978
- * in-memory fixture cannot overwrite the developer's real OPENCODEX_HOME.
979
- */
980
- const persist = deps.saveConfigPreservingClaudeCode ?? saveConfigPreservingClaudeCode;
981
- try {
982
- persist(config);
983
- } catch (error) {
984
- // A published write already put the new value on disk; only an unpublished one rolls back.
985
- if (!(error instanceof ConfigWritePublishedError)) {
986
- if (previousBlock === undefined) delete config.claudeCode;
987
- else config.claudeCode = previousBlock;
988
- }
989
- if (isConfigLockError(error)) {
990
- return isLockContention(error)
991
- ? refusal(409, "claude", "config_busy",
992
- "Another process is saving the configuration right now. Try again in a moment.")
993
- : refusal(500, "claude", "write_failed",
994
- `The configuration lock could not be acquired: ${error instanceof Error ? error.message : String(error)}`);
995
- }
996
- throw error;
997
- }
998
-
999
1074
  /*
1000
1075
  * The generated ~/.claude/agents/ocx-*.md definitions route through this proxy; a
1001
1076
  * native Claude Code session that still loads them after OFF follows their
@@ -1034,3 +1109,34 @@ export async function handleNativeIntegrationRoutes(ctx: ManagementContext): Pro
1034
1109
 
1035
1110
  return null;
1036
1111
  }
1112
+
1113
+ export async function handleNativeIntegrationRoutes(ctx: ManagementContext): Promise<Response | null> {
1114
+ if (ctx.req.method !== "PUT" || !/^\/api\/native-integrations\/(claude|claude-desktop|codex|grok)$/.test(ctx.url.pathname)) {
1115
+ return handleNativeIntegrationRoutesUnlocked(ctx);
1116
+ }
1117
+ if (ctx.config.runtimeRole === "client") return jsonResponse({ error: "Route decisions are owned by the Home", code: "link_child_read_only" }, 403);
1118
+ const decisionProgress: { desiredEnabled?: boolean } = {};
1119
+ try { return await settleConfigRoot(configRoot(), () => withLinkApply(() => handleNativeIntegrationRoutesUnlocked({ ...ctx, decisionProgress }))); }
1120
+ catch (error) {
1121
+ const clientId = ctx.url.pathname.split("/").at(-1) as NativeIntegrationClientId;
1122
+ if (decisionProgress.desiredEnabled !== undefined) {
1123
+ const busy = error instanceof LinkApplyBusyError || (isConfigLockError(error) && isConfigMutationContention(error));
1124
+ const firstPartyTimeout = error instanceof WindowsSecretAclSettleTimeoutError && clientId === "claude-desktop"
1125
+ && resolveClaudeDesktopApplyMode(ctx.config, observeClaudeDesktopMode(ctx.config)) === "first-party";
1126
+ return postCommitRefusal(busy ? 409 : 500, clientId, busy ? "config_busy" : "write_failed",
1127
+ "The native decision was saved, but applying it did not complete. Repair configuration storage if needed, then retry the same switch to reconcile and apply it.",
1128
+ { desiredEnabled: decisionProgress.desiredEnabled,
1129
+ diagnostic: firstPartyTimeout ? { stage: "ca", cause: "ETIMEDOUT" } : configFailureDiagnostic(error) });
1130
+ }
1131
+ if (error instanceof LinkApplyBusyError || (isConfigLockError(error) && isConfigMutationContention(error))) return refusal(409, clientId, "config_busy", "Another Home apply or config mutation is running. Nothing was written; retry in a moment.");
1132
+ if (isConfigLockError(error)) return refusal(500, clientId, "write_failed",
1133
+ "Configuration storage is unavailable. Inspect and repair it before retrying.", { diagnostic: configFailureDiagnostic(error) });
1134
+ if (error instanceof WindowsSecretAclSettleTimeoutError) {
1135
+ const clientId = ctx.url.pathname.split("/").at(-1) as NativeIntegrationClientId;
1136
+ const firstParty = clientId === "claude-desktop" && resolveClaudeDesktopApplyMode(ctx.config, observeClaudeDesktopMode(ctx.config)) === "first-party";
1137
+ return refusal(500, clientId, "write_failed", "Config ACL settlement timed out. Nothing was written; retry after it settles.",
1138
+ firstParty ? { diagnostic: { stage: "ca", cause: "ETIMEDOUT" } } : {});
1139
+ }
1140
+ throw error;
1141
+ }
1142
+ }
@@ -34,9 +34,17 @@ import {
34
34
  submitLoginCode,
35
35
  submitManualLoginCode,
36
36
  supportsCodeLoginMode,
37
+ supportsDeviceLoginMode,
37
38
  waitForLoginSettled,
38
39
  } from "../../oauth";
39
40
  import { OAuthMutationBusyError, removeCredential } from "../../oauth/store";
41
+ import {
42
+ ANTIGRAVITY_RISK_PROVIDER,
43
+ ANTIGRAVITY_RISK_REFUSAL_CODE,
44
+ antigravityRiskRefusalBody,
45
+ hasAntigravityRiskAcknowledgement,
46
+ requiresAntigravityRiskAcknowledgement,
47
+ } from "../../oauth/antigravity-risk";
40
48
  import { cancelKiroDeviceLogin, kiroDeviceConfigBaseline, selectKiroDeviceProfile, startKiroDeviceLogin, statusKiroDeviceLogin, type KiroDeviceMethod } from "../../oauth/kiro-device-login";
41
49
  import { parseKiroIamOptions } from "../../oauth/kiro-iam-identity-center";
42
50
  import { providerDestinationResolvedError } from "../../lib/destination-policy";
@@ -180,11 +188,15 @@ function validateKeyName(
180
188
  export type IssuedApiKey = Pick<OcxApiKeyEntry, "id" | "name" | "key" | "createdAt">;
181
189
 
182
190
  /** Shared one-time data-key issuance used by the dashboard and link transactions. */
183
- export function issueApiKeyInProcess(config: OcxConfig, name: string): IssuedApiKey {
191
+ export function issueApiKeyInProcess(config: OcxConfig, name: string, reservedId?: string): IssuedApiKey {
184
192
  const checked = validateKeyName(name, { required: true });
185
193
  if ("error" in checked) throw new Error(checked.error);
194
+ // An operation journal reserves the id before it issues the key, so a crash can be matched to it later.
195
+ if (reservedId !== undefined && (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(reservedId) || (config.apiKeys ?? []).some(key => key.id === reservedId))) {
196
+ throw new Error("The reserved key id is invalid or already in use.");
197
+ }
186
198
  const entry: IssuedApiKey = {
187
- id: randomUUID(),
199
+ id: reservedId ?? randomUUID(),
188
200
  name: checked.value,
189
201
  key: `ocx_data_${randomBytes(20).toString("hex")}`,
190
202
  createdAt: new Date().toISOString(),
@@ -260,9 +272,14 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
260
272
  // the provider's loopback callback server (inside this process) captures the redirect in the
261
273
  // background, then the credential is persisted. The GUI opens the URL and polls /api/oauth/status.
262
274
  if (url.pathname === "/api/oauth/login" && req.method === "POST") {
263
- const body = await readManagementJsonBodyOr(req, {}) as { provider?: string; addAccount?: boolean; accountId?: string; reauth?: boolean; openBrowser?: unknown; method?: unknown; mode?: unknown; startUrl?: unknown; region?: unknown; flowId?: unknown; profileArn?: unknown };
275
+ const body = await readManagementJsonBodyOr(req, {}) as { provider?: string; addAccount?: boolean; accountId?: string; reauth?: boolean; openBrowser?: unknown; method?: unknown; mode?: unknown; device?: unknown; startUrl?: unknown; region?: unknown; flowId?: unknown; profileArn?: unknown };
264
276
  const provider = (body.provider ?? "").trim().toLowerCase();
265
277
  if (!isPublicOAuthProvider(provider)) return jsonResponse({ error: "unknown oauth provider" }, 400);
278
+ // Antigravity sign-in can get the Google account disabled. Every client asks first; this is
279
+ // the check none of them can skip, and it runs before any flow state is created.
280
+ if (requiresAntigravityRiskAcknowledgement(provider) && !hasAntigravityRiskAcknowledgement(body)) {
281
+ return jsonResponse(antigravityRiskRefusalBody(), 403);
282
+ }
266
283
  // Omitted mode is the localhost-callback flow this route has always run.
267
284
  if (body.mode !== undefined && body.mode !== "callback" && body.mode !== "code") {
268
285
  return jsonResponse({ error: "mode must be \"callback\" or \"code\"" }, 400);
@@ -271,6 +288,12 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
271
288
  if (codeMode && !supportsCodeLoginMode(provider)) {
272
289
  return jsonResponse({ error: "code_mode_unsupported" }, 400);
273
290
  }
291
+ // `device: true` picks the provider's device grant over its browser callback (xAI).
292
+ if (body.device !== undefined && body.device !== true) return jsonResponse({ error: "device must be true" }, 400);
293
+ const device = body.device === true;
294
+ if (device && (codeMode || !supportsDeviceLoginMode(provider))) {
295
+ return jsonResponse({ error: "device_login_unsupported" }, 400);
296
+ }
274
297
  // Muse may import a local Keychain credential or start a device grant; add-account
275
298
  // and reauth skip the import. All management login paths require the dashboard
276
299
  // principal before credential acquisition. A raw token proves administration,
@@ -322,13 +345,13 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
322
345
  // request may already have mutated live config and yielded before its save.
323
346
  const persistedBaseline = readConfigDiagnostics().config;
324
347
  // addAccount / reauth forces a fresh browser identity (skips local-CLI token import).
325
- // Only code mode gets a flow id: it is what a later paste is pinned to. The callback
326
- // flow's lifecycle argument stays exactly as it was.
327
- const flowId = codeMode ? randomUUID() : undefined;
348
+ // The xAI device caller also needs its own flow identity for polling.
349
+ const flowId = codeMode || (provider === "xai" && device) ? randomUUID() : undefined;
328
350
  const { url: authUrl, instructions, deviceCode, expiresAt } = await startLoginFlow(provider, {
329
351
  forceLogin: body.addAccount === true || reauth,
330
352
  ...(accountId ? { reauthAccountId: accountId } : {}),
331
353
  ...(codeMode ? { codeMode: true } : {}),
354
+ ...(device ? { flow: "device" as const } : {}),
332
355
  }, {
333
356
  ...(flowId ? { flowId } : {}),
334
357
  // startLoginFlow returns the authorization URL before background persistence completes.
@@ -362,7 +385,7 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
362
385
  instructions,
363
386
  deviceCode,
364
387
  browserLaunch,
365
- ...(codeMode ? { mode: "code", flowId, expiresAt } : {}),
388
+ ...(codeMode ? { mode: "code", flowId, expiresAt } : flowId ? { flowId } : {}),
366
389
  });
367
390
  } catch (err) {
368
391
  if (err instanceof OAuthMutationBusyError) throw err;
@@ -387,6 +410,7 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
387
410
  const result = cancelKiroDeviceLogin(body.flowId, principal ?? "admin-token");
388
411
  return result ? jsonResponse(result) : jsonResponse({ error: "unknown login flow" }, 404);
389
412
  }
413
+ if (provider === "xai" && body.flowId !== undefined && (typeof body.flowId !== "string" || body.flowId.length > 128)) return jsonResponse({ error: "unknown login flow" }, 404);
390
414
  const { cancelLoginFlow } = await import("../../oauth");
391
415
  // Without a flow id this cancels the provider's newest in-flight login, which is what the
392
416
  // single-user GUI has always meant by "Cancel". A host running concurrent code logins for
@@ -471,7 +495,7 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
471
495
  // Resolved here, at the request boundary that already holds the config, and passed down.
472
496
  // getLoginStatus stays free of config I/O. This route does not re-mask afterwards: it
473
497
  // consumes the already-projected status rather than redacting a second time.
474
- const status = getLoginStatus(provider, emailMaskingEnabled(config));
498
+ const status = getLoginStatus(provider, emailMaskingEnabled(config), provider === "xai" ? url.searchParams.get("flowId") ?? undefined : undefined);
475
499
  return jsonResponse(status);
476
500
  }
477
501
 
@@ -564,7 +588,8 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
564
588
  ...(provider === "anthropic2" ? { provider } : {}), activeAccountId: projected.activeAccountId,
565
589
  accounts: projected.accounts.map(account => {
566
590
  const row = byId.get(account.id);
567
- if (!row) return account;
591
+ // #8397: a passive provider with no observation for this account yet says so.
592
+ if (!row) return passiveQuota ? { ...account, quotaUnknownReason: "passive_not_observed" } : account;
568
593
  if (config.providers[provider] !== quotaProvider || row.isCurrent?.() === false) {
569
594
  return { ...account, quota: null, quotaUnavailable: true };
570
595
  }
@@ -606,14 +631,13 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
606
631
  if (!latest) return jsonResponse({ error: "account not found" }, 404);
607
632
  return jsonResponse({ error: latest.paused ? "account is paused" : "account selection changed" }, 409);
608
633
  }
609
- const { forgetGenericFailoverRoster } = await import("../../oauth/generic-account-failover");
634
+ const { forgetGenericFailoverRoster, seedGenericPoolSelection } = await import("../../oauth/generic-account-failover");
610
635
  forgetGenericFailoverRoster(provider);
611
636
  // Seed the rotation cursor on the operator's pick, or a sticky round-robin ring hands the
612
637
  // very next dispatch back to whatever the pool had chosen. forgetGenericFailoverRoster
613
638
  // only drops the presence count; it has never touched the cursor. Same defect the Codex
614
639
  // side carries resetCodexRoutingForManualSelection for.
615
- const { genericPoolKey, seedPoolRotationAccount } = await import("../../oauth/pool-kernel");
616
- seedPoolRotationAccount(genericPoolKey(provider), body.accountId);
640
+ seedGenericPoolSelection(provider, body.accountId);
617
641
  const anthropicRouting = isAnthropicOAuthInstance(provider)
618
642
  ? (await import("../../oauth/anthropic-routing")).anthropicRoutingFor(provider) : undefined;
619
643
  anthropicRouting?.resetAnthropicRoutingForManualSelection(body.accountId);
@@ -697,8 +721,8 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
697
721
  }
698
722
  if (result.activeAccountChanged) {
699
723
  if (!anthropicRouting) {
700
- const { genericPoolKey, seedPoolRotationAccount } = await import("../../oauth/pool-kernel");
701
- seedPoolRotationAccount(genericPoolKey(provider), result.activeAccountId);
724
+ const { seedGenericPoolSelection } = await import("../../oauth/generic-account-failover");
725
+ seedGenericPoolSelection(provider, result.activeAccountId);
702
726
  }
703
727
  const { clearModelCache } = await import("../../codex/model-cache");
704
728
  const { clearGatherRoutedModelsInflight } = await import("../../codex/catalog");
@@ -1060,6 +1084,12 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
1060
1084
  if (!isPlainRecord(rawBody)) return jsonResponse({ code: "invalid_document" }, 400);
1061
1085
  const provider = typeof rawBody.provider === "string" ? rawBody.provider : "";
1062
1086
  const format = typeof rawBody.format === "string" ? rawBody.format : "";
1087
+ // An imported Antigravity credential carries the same account risk as a fresh login. Import
1088
+ // admits only the exact provider id, so the gate matches it exactly too; other spellings
1089
+ // keep their unsupported_provider answer.
1090
+ if (provider === ANTIGRAVITY_RISK_PROVIDER && !hasAntigravityRiskAcknowledgement(rawBody)) {
1091
+ return jsonResponse({ code: ANTIGRAVITY_RISK_REFUSAL_CODE }, 403);
1092
+ }
1063
1093
  const { importAccounts } = await import("../../oauth/account-import");
1064
1094
  const imported = await importAccounts({
1065
1095
  provider,
@@ -1152,7 +1182,9 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
1152
1182
  const listed = listProviderApiKeys(config, name);
1153
1183
  const provider = config.providers[name];
1154
1184
  const quotaMode = provider ? providerApiKeyQuotaMode(name, provider) : "unsupported";
1155
- return { ...listed, keys: listed.keys.map(key => ({ ...key, quotaMode })) };
1185
+ // #8397: say why a balance is unknown; a destination without a reader has no balance source.
1186
+ return { ...listed, keys: listed.keys.map(key => ({ ...key, quotaMode,
1187
+ ...(quotaMode === "unsupported" ? { quotaUnknownReason: "no_balance_source" as const } : {}) })) };
1156
1188
  };
1157
1189
  const initial = projectKeys();
1158
1190
  if (url.searchParams.get("quota") !== "1" || !initial.keys.some(key => key.quotaMode === "probe")) {
@@ -1165,10 +1197,17 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
1165
1197
  activeId: current.activeId,
1166
1198
  keys: current.keys.map(key => {
1167
1199
  const row = byId.get(key.id);
1168
- if (!row || key.quotaMode !== "probe") return key;
1169
- if (!row.isCurrent()) return { ...key, quota: null, quotaUnavailable: true };
1200
+ if (key.quotaMode !== "probe") return key;
1201
+ // A key added while the read was in flight was never read.
1202
+ if (!row) return { ...key, quotaUnknownReason: "not_read" };
1203
+ if (!row.isCurrent()) return { ...key, quota: null, quotaUnavailable: true, quotaUnknownReason: "not_read" };
1204
+ const readAt = row.readAt === undefined ? {} : { quotaReadAt: row.readAt };
1205
+ // A successful read with no meterable balance (authoritative empty) still names why it is unknown.
1206
+ const reason = row.unavailable ? (row.readAt === undefined ? "not_read" : "read_failed")
1207
+ : row.quota === null && row.readAt !== undefined ? "not_reported" : undefined;
1170
1208
  // Internal identity/epoch checks never enter the JSON DTO.
1171
- return { ...key, quota: row.quota, quotaUnavailable: row.unavailable === true };
1209
+ return { ...key, quota: row.quota, quotaUnavailable: row.unavailable === true, ...readAt,
1210
+ ...(reason ? { quotaUnknownReason: reason } : {}) };
1172
1211
  }),
1173
1212
  });
1174
1213
  }
@@ -1216,6 +1255,7 @@ export async function handleOauthAccountRoutes(ctx: ManagementContext): Promise<
1216
1255
  ? storeProviderKeyInKeychain(config, name)
1217
1256
  : restoreProviderKeyFromKeychain(config, name);
1218
1257
  if (!result.ok) return jsonResponse({ error: result.error }, result.status);
1258
+ (await import("../../providers/passive-key-observation")).clearPassiveKeyLimits(name);
1219
1259
  const { clearProviderQuotaCache } = await import("../../providers/quota");
1220
1260
  clearProviderQuotaCache();
1221
1261
  return jsonResponse({ ...result, name, store: providerKeyStoreKind(config.providers[name]) });
@@ -22,6 +22,7 @@ import { protocolPolicyRevision, resolveApiSurfaceSettings, resolveProtocolSetti
22
22
  import type { OcxConfig } from "../../types";
23
23
  import type { ManagementContext } from "./context";
24
24
  import { readManagementJsonBodyOr } from "./body";
25
+ import { captureHomeRouteDefaultsBeforeHomeSwitch } from "../../routing/home-route-capture";
25
26
  import {
26
27
  applyProtocolSettingsPatch,
27
28
  parseProtocolSettingsPatch,
@@ -115,6 +116,12 @@ async function patchProtocolSettings(ctx: ManagementContext): Promise<Response>
115
116
  // `deps.` first: route tests with an in-memory fixture must never write the real config.
116
117
  const persist = ctx.deps.saveConfigPreservingClaudeCode
117
118
  ?? (await import("../../config")).saveConfigPreservingClaudeCode;
119
+ // Closing Messages turns Claude Code off on this Home alone: freeze what Children inherit first.
120
+ const captureRefused = applied.claudeCodeChanged ? captureHomeRouteDefaultsBeforeHomeSwitch() : null;
121
+ if (captureRefused) {
122
+ restoreProtocolSettings(config, snapshot);
123
+ return jsonResponse({ error: { code: "route_intent_unavailable", message: captureRefused.message } }, captureRefused.retryable ? 409 : 500, req, config);
124
+ }
118
125
  try {
119
126
  persist(config);
120
127
  } catch (error) {
@@ -72,13 +72,13 @@ function transportExclusion(row: OcxProviderConfig): Extract<ProviderCompletionT
72
72
  if (typeof (row as { fetch?: unknown }).fetch === "function" && "proxy" in row) return "custom_executor_egress";
73
73
  return undefined;
74
74
  }
75
- function nativeModel(config: OcxConfig, row: OcxProviderConfig, model: string): string {
75
+ function nativeModel(config: OcxConfig, name: string, row: OcxProviderConfig, model: string): string {
76
76
  const known = new Set([...(row.models ?? []), ...Object.keys(row.modelAliases ?? {})]);
77
- return known.has(model) ? model : resolveModelAlias(config, row, known, model) ?? model;
77
+ return known.has(model) ? model : resolveModelAlias(config, row, known, model, name) ?? model;
78
78
  }
79
79
  function derive(config: OcxConfig, name: string, row: OcxProviderConfig, model: string) {
80
80
  const resolved = routedProviderConfig(name, row);
81
- const native = nativeModel(config, resolved, model);
81
+ const native = nativeModel(config, name, resolved, model);
82
82
  const routed = resolveWireProtocolOverride(name, native, resolved);
83
83
  const wire = routed.adapter;
84
84
  if (wire !== "openai-chat" && wire !== "openai-responses") throw new Error("unsupported adapter");
@@ -134,7 +134,7 @@ export async function runProviderCompletionTest(
134
134
  let snapshot: OcxProviderConfig = metadata;
135
135
  let destinationRefused = false;
136
136
  try { snapshot = routedProviderConfig(name, metadata); } catch { destinationRefused = true; }
137
- const native = nativeModel(config, snapshot, model);
137
+ const native = nativeModel(config, name, snapshot, model);
138
138
  const wire = resolveWireProtocolOverride(name, native, snapshot).adapter;
139
139
  if (wire !== "openai-chat" && wire !== "openai-responses") return { applicable: false, reason: "unsupported_adapter", adapter: wire };
140
140
  const now = deps.now ?? (() => performance.now());