@bitkyc08/opencodex 2.93.0 → 2.94.0

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 (435) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-DmvwlhQq.js +58 -0
  4. package/gui/dist/assets/Tray-CZatQdoF.js +1 -0
  5. package/gui/dist/assets/index-3EPO_KbX.js +94 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/{quota-summary-BXu4zE8H.js → quota-summary-BHvWg9mi.js} +1 -1
  8. package/gui/dist/index.html +2 -2
  9. package/gui/dist/provider-icons/t3code.svg +4 -0
  10. package/package.json +7 -4
  11. package/src/adapters/anthropic/account-metadata.ts +34 -3
  12. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  13. package/src/adapters/anthropic/passthrough.ts +5 -2
  14. package/src/adapters/anthropic.ts +17 -4
  15. package/src/adapters/antigravity-refusal.ts +29 -0
  16. package/src/adapters/base.ts +11 -1
  17. package/src/adapters/client-fingerprint.ts +43 -9
  18. package/src/adapters/coding-agent/protocol.ts +19 -9
  19. package/src/adapters/command-code.ts +4 -5
  20. package/src/adapters/cursor/catalog.ts +5 -3
  21. package/src/adapters/cursor/claude-id.ts +30 -19
  22. package/src/adapters/cursor/cursor-errors.ts +5 -2
  23. package/src/adapters/cursor/h2-pool.ts +9 -7
  24. package/src/adapters/cursor/http1-bidi.ts +1 -0
  25. package/src/adapters/cursor/live-models.ts +4 -2
  26. package/src/adapters/cursor.ts +4 -1
  27. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  28. package/src/adapters/google-antigravity-replay.ts +13 -2
  29. package/src/adapters/google-antigravity-wire.ts +8 -3
  30. package/src/adapters/google-errors.ts +33 -0
  31. package/src/adapters/google-http.ts +41 -16
  32. package/src/adapters/google-wire-compiler.ts +4 -0
  33. package/src/adapters/google.ts +21 -10
  34. package/src/adapters/kiro/adapter.ts +3 -0
  35. package/src/adapters/kiro/stream.ts +18 -13
  36. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  37. package/src/adapters/openai-chat/messages.ts +22 -10
  38. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  39. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  40. package/src/adapters/openai-chat/wire.ts +9 -0
  41. package/src/adapters/openai-chat.ts +18 -17
  42. package/src/adapters/openai-responses/image-gen.ts +15 -1
  43. package/src/adapters/openai-responses/passthrough.ts +11 -34
  44. package/src/adapters/openai-responses/transport.ts +20 -2
  45. package/src/adapters/openai-responses/usage.ts +34 -0
  46. package/src/adapters/qoder/adapter.ts +9 -15
  47. package/src/adapters/qoder/image-input.ts +52 -0
  48. package/src/adapters/unique-tool-call-ids.ts +2 -2
  49. package/src/adapters/zed-additional-tools.ts +51 -0
  50. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  51. package/src/adapters/zed-json-tokens.ts +166 -0
  52. package/src/adapters/zed-openai-stream.ts +723 -0
  53. package/src/adapters/zed-tool-arguments.ts +79 -0
  54. package/src/adapters/zed.ts +53 -3
  55. package/src/advisor/consult.ts +22 -0
  56. package/src/advisor/runtime.ts +3 -0
  57. package/src/bridge/errors.ts +22 -1
  58. package/src/bridge/response-json.ts +4 -1
  59. package/src/bridge/sse.ts +21 -12
  60. package/src/chat/inbound.ts +13 -2
  61. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  62. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +83 -0
  63. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  64. package/src/claude/desktop-first-party.ts +16 -5
  65. package/src/claude/desktop-gateway-state.ts +4 -0
  66. package/src/claude/inbound-tool-loading.ts +93 -0
  67. package/src/claude/intercept/picker-listener.ts +33 -1
  68. package/src/claude/model-info.ts +29 -4
  69. package/src/claude/outbound.ts +33 -13
  70. package/src/cli/account-main.ts +43 -5
  71. package/src/cli/capabilities-base.ts +22 -5
  72. package/src/cli/capabilities-integrations.ts +4 -4
  73. package/src/cli/claude-desktop.ts +139 -98
  74. package/src/cli/codex-cli-update.ts +102 -48
  75. package/src/cli/codex-launch-auth.ts +93 -0
  76. package/src/cli/codex-launch-command.ts +32 -0
  77. package/src/cli/codex-launch-diagnostics.ts +37 -0
  78. package/src/cli/codex-launch-ownership.ts +307 -0
  79. package/src/cli/codex-launch-policy.ts +84 -0
  80. package/src/cli/codex-launcher.ts +310 -0
  81. package/src/cli/codex-shim-autorestore.ts +2 -0
  82. package/src/cli/config-command.ts +9 -4
  83. package/src/cli/config-mutation.ts +13 -0
  84. package/src/cli/dispatch.ts +13 -7
  85. package/src/cli/effort.ts +19 -14
  86. package/src/cli/ensure-desired-integrations.ts +21 -14
  87. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  88. package/src/cli/export-command.ts +8 -4
  89. package/src/cli/help.ts +3 -1
  90. package/src/cli/index.ts +58 -64
  91. package/src/cli/integration-input.ts +12 -0
  92. package/src/cli/integration-plan-dto.ts +2 -0
  93. package/src/cli/integration-preview.ts +6 -3
  94. package/src/cli/integrations.ts +2 -1
  95. package/src/cli/link-cleanup.ts +8 -23
  96. package/src/cli/link-enrollment.ts +1 -4
  97. package/src/cli/link.ts +1 -1
  98. package/src/cli/loopback-family.ts +2 -31
  99. package/src/cli/models.ts +62 -49
  100. package/src/cli/provider.ts +146 -139
  101. package/src/cli/registry.ts +34 -3
  102. package/src/cli/root.ts +2 -0
  103. package/src/cli/start-owner-fence.ts +22 -3
  104. package/src/cli/status-link.ts +28 -0
  105. package/src/cli/status.ts +15 -0
  106. package/src/cli/stop-restore-guard.ts +48 -0
  107. package/src/cli/stop-restore.ts +117 -36
  108. package/src/cli/system-command.ts +2 -0
  109. package/src/cli/v2.ts +17 -4
  110. package/src/client/lifecycle-lock.ts +1 -1
  111. package/src/client/link-connection.ts +19 -0
  112. package/src/client/link-relay-transport.ts +25 -3
  113. package/src/client/link-tunnel.ts +10 -0
  114. package/src/client/machine-listener.ts +7 -1
  115. package/src/client/restore-ownership.ts +45 -0
  116. package/src/client/runtime.ts +13 -1
  117. package/src/client/state.ts +1 -1
  118. package/src/clients/client-ids.ts +7 -0
  119. package/src/clients/client-path.ts +13 -5
  120. package/src/clients/config-export/agent-clients.ts +3 -6
  121. package/src/clients/config-export/alias-selectors.ts +85 -0
  122. package/src/clients/config-export/contracts.ts +6 -25
  123. package/src/clients/config-export/dsh.ts +8 -1
  124. package/src/clients/config-export/model-metadata.ts +19 -0
  125. package/src/clients/config-export/model-names.ts +31 -0
  126. package/src/clients/config-export/qoder.ts +3 -11
  127. package/src/clients/config-export/t3code.ts +141 -0
  128. package/src/clients/config-export.ts +51 -15
  129. package/src/clients/gentle-shell-path.ts +3 -3
  130. package/src/codex/account-lifecycle.ts +27 -13
  131. package/src/codex/account-store.ts +32 -6
  132. package/src/codex/app-server-processes.ts +84 -1
  133. package/src/codex/auth-api/main-account-probe.ts +50 -11
  134. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  135. package/src/codex/auth-context.ts +45 -4
  136. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  137. package/src/codex/catalog/build-entries.ts +12 -13
  138. package/src/codex/catalog/bundled.ts +59 -9
  139. package/src/codex/catalog/derive-entry.ts +2 -0
  140. package/src/codex/catalog/gather-capture.ts +3 -0
  141. package/src/codex/catalog/metadata.ts +6 -5
  142. package/src/codex/catalog/model-hints.ts +36 -4
  143. package/src/codex/catalog/native-priority.ts +63 -0
  144. package/src/codex/catalog/provider-models.ts +20 -4
  145. package/src/codex/catalog/retained-sync.ts +1 -1
  146. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  147. package/src/codex/cli-install-provenance.ts +57 -29
  148. package/src/codex/cli-installation-identity.ts +1 -1
  149. package/src/codex/cli-installation-limits.ts +7 -0
  150. package/src/codex/cli-update-apply.ts +391 -0
  151. package/src/codex/cli-update-artifacts.ts +257 -0
  152. package/src/codex/cli-update-files.ts +100 -0
  153. package/src/codex/cli-update-inspection-context.ts +49 -0
  154. package/src/codex/cli-update-job-execution.ts +77 -0
  155. package/src/codex/cli-update-job-store-windows.ts +1010 -0
  156. package/src/codex/cli-update-job-worker.ts +393 -0
  157. package/src/codex/cli-update-job.ts +369 -0
  158. package/src/codex/cli-update-lease.ts +71 -0
  159. package/src/codex/cli-update-paths.ts +76 -0
  160. package/src/codex/cli-update-plan.ts +180 -47
  161. package/src/codex/cli-update-recovery.ts +236 -0
  162. package/src/codex/cli-update-selection-gate.ts +235 -0
  163. package/src/codex/cli-update-windows-apply.ts +308 -0
  164. package/src/codex/cli-update-windows-layout.ts +110 -0
  165. package/src/codex/cli-update-windows-observation.ts +91 -0
  166. package/src/codex/cli-update-windows-paths.ts +26 -0
  167. package/src/codex/cli-update-worker-recovery.ts +32 -0
  168. package/src/codex/cli-update-worker.ts +185 -0
  169. package/src/codex/cli-windows-plan-provenance.ts +250 -0
  170. package/src/codex/desktop-app-restart.ts +22 -3
  171. package/src/codex/exec-boundary.ts +208 -0
  172. package/src/codex/forward-transport-headers.ts +80 -0
  173. package/src/codex/history-job.ts +7 -0
  174. package/src/codex/history-provider.ts +5 -2
  175. package/src/codex/history-worker.ts +20 -1
  176. package/src/codex/inject/restore.ts +57 -25
  177. package/src/codex/internal/history-writer.ts +2 -1
  178. package/src/codex/mac-app-bundle.ts +52 -0
  179. package/src/codex/main-account.ts +161 -23
  180. package/src/codex/native-main-auth-temp.ts +3 -2
  181. package/src/codex/native-main-refresh-mode.ts +18 -3
  182. package/src/codex/native-profile-manager.ts +8 -6
  183. package/src/codex/native-profile-store.ts +9 -0
  184. package/src/codex/ocx-compaction-history.ts +3 -2
  185. package/src/codex/prompt-text-probe.ts +211 -69
  186. package/src/codex/quota.ts +9 -0
  187. package/src/codex/role-model-history.ts +253 -0
  188. package/src/codex/runtime.ts +120 -71
  189. package/src/codex/shim-overlay.ts +22 -3
  190. package/src/codex/shim-templates.ts +5 -2
  191. package/src/codex/shim-wrapper-write.ts +136 -0
  192. package/src/codex/shim.ts +24 -125
  193. package/src/codex/windows-cli-child-native.ts +119 -0
  194. package/src/codex/windows-cli-child-pipe.ts +87 -0
  195. package/src/codex/windows-cli-child.ts +260 -0
  196. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  197. package/src/codex/windows-cli-recovery.ts +39 -0
  198. package/src/codex/windows-installation-files.ts +52 -6
  199. package/src/codex/windows-npm-execution.ts +25 -0
  200. package/src/combos/failover.ts +84 -5
  201. package/src/combos/index.ts +1 -0
  202. package/src/combos/resolve.ts +60 -22
  203. package/src/config/atomic-write.ts +75 -22
  204. package/src/config/diagnostics.ts +18 -10
  205. package/src/config/live-reconcile.ts +11 -3
  206. package/src/config/owner-registry.ts +5 -4
  207. package/src/config/persist-unlocked.ts +34 -8
  208. package/src/config/persisted-mutation.ts +7 -0
  209. package/src/config/process-state.ts +9 -5
  210. package/src/config/removed-opencode-free-backup.ts +99 -0
  211. package/src/config/removed-opencode-free.ts +4 -8
  212. package/src/config/salvage.ts +1 -0
  213. package/src/config/schema/config-schema.ts +16 -1
  214. package/src/config/schema/leaf-validators.ts +15 -0
  215. package/src/config.ts +4 -4
  216. package/src/generated/compatibility-version.json +743 -315
  217. package/src/grok/inject.ts +2 -1
  218. package/src/grok/sync.ts +5 -2
  219. package/src/images/loop.ts +14 -5
  220. package/src/integrations/catalog-refresh.ts +1 -1
  221. package/src/integrations/hermes-refresh.ts +28 -0
  222. package/src/integrations/model-name-guard.ts +31 -0
  223. package/src/integrations/mutation-plan.ts +17 -4
  224. package/src/integrations/ownership.ts +3 -0
  225. package/src/integrations/registry.ts +10 -1
  226. package/src/integrations/state.ts +6 -0
  227. package/src/integrations/writer.ts +64 -59
  228. package/src/lib/abort.ts +8 -4
  229. package/src/lib/bounded-body.ts +7 -1
  230. package/src/lib/config-ownership.ts +4 -0
  231. package/src/lib/errors.ts +2 -0
  232. package/src/lib/eventstream-decoder.ts +3 -2
  233. package/src/lib/http-response-semantics.ts +9 -6
  234. package/src/lib/inbound-body-policy.ts +11 -0
  235. package/src/lib/jsonc.ts +7 -2
  236. package/src/lib/local-management-capability.ts +3 -1
  237. package/src/lib/local-upstream.ts +22 -26
  238. package/src/lib/loopback-family.ts +31 -0
  239. package/src/lib/plain-data.ts +7 -5
  240. package/src/lib/process-control.ts +30 -5
  241. package/src/lib/shadow-call.ts +55 -1
  242. package/src/lib/tool-argument-integers.ts +99 -7
  243. package/src/lib/upstream-retry.ts +6 -1
  244. package/src/lib/windows-elevation.ts +34 -11
  245. package/src/lib/windows-owner-acl.ts +272 -32
  246. package/src/lib/windows-secret-acl.ts +310 -44
  247. package/src/lib/windows-service-wrappers.ts +10 -7
  248. package/src/lib/winsw.ts +8 -4
  249. package/src/link/relay-auth.ts +38 -1
  250. package/src/link/remote-platform.ts +11 -23
  251. package/src/link/remote-probe.ts +3 -1
  252. package/src/link/remote-windows.ts +150 -0
  253. package/src/link/ssh-argv.ts +13 -5
  254. package/src/link/store.ts +4 -1
  255. package/src/link/supervisor.ts +9 -0
  256. package/src/local-credentials/generation.ts +238 -0
  257. package/src/local-credentials/inventory.ts +281 -0
  258. package/src/local-credentials/observation-lease.ts +83 -0
  259. package/src/local-credentials/publication-fence.ts +81 -0
  260. package/src/local-credentials/references.ts +36 -0
  261. package/src/local-credentials/runtime-observation.ts +28 -0
  262. package/src/oauth/account-auto-pause-policy.ts +11 -0
  263. package/src/oauth/anthropic-account-refusal.ts +1 -0
  264. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  265. package/src/oauth/anthropic-routing.ts +34 -44
  266. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  267. package/src/oauth/chatgpt.ts +11 -9
  268. package/src/oauth/cursor.ts +8 -2
  269. package/src/oauth/generic-account-failover.ts +33 -2
  270. package/src/oauth/generic-session-affinity.ts +7 -0
  271. package/src/oauth/google-antigravity.ts +29 -5
  272. package/src/oauth/index.ts +1 -0
  273. package/src/oauth/store.ts +32 -4
  274. package/src/protocols/encoders/adapter-events.ts +7 -4
  275. package/src/protocols/encoders/messages.ts +1 -1
  276. package/src/providers/antigravity-account-roster.ts +73 -7
  277. package/src/providers/antigravity-models.ts +8 -4
  278. package/src/providers/api-key-resolve.ts +16 -3
  279. package/src/providers/claude-cli-identity.ts +2 -0
  280. package/src/providers/codex-capacity.ts +3 -2
  281. package/src/providers/free-directory.ts +10 -2
  282. package/src/providers/key-store.ts +7 -2
  283. package/src/providers/provider-id-rewrite.ts +3 -0
  284. package/src/providers/quota/antigravity.ts +6 -4
  285. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  286. package/src/providers/stale-model-roster-migration.ts +3 -0
  287. package/src/quota-pool/assemble.ts +51 -21
  288. package/src/quota-pool/pooled.ts +162 -0
  289. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  290. package/src/responses/apply-patch-envelope.ts +35 -0
  291. package/src/responses/compaction-history-framing.ts +15 -4
  292. package/src/responses/turn-membership.ts +111 -0
  293. package/src/server/advisor-admission-scope.ts +43 -0
  294. package/src/server/audio-upstream.ts +10 -2
  295. package/src/server/auth-cors.ts +23 -0
  296. package/src/server/bind-host.ts +5 -0
  297. package/src/server/chat-completions.ts +17 -2
  298. package/src/server/chat-native.ts +16 -11
  299. package/src/server/claude-messages.ts +9 -1
  300. package/src/server/codex-model-list.ts +46 -0
  301. package/src/server/gui-session.ts +5 -2
  302. package/src/server/inbound-body-admission.ts +21 -13
  303. package/src/server/inbound-body-budget.ts +128 -0
  304. package/src/server/index/link-listener.ts +3 -1
  305. package/src/server/index/link-relay-sessions.ts +9 -2
  306. package/src/server/index/optional-listeners.ts +1 -0
  307. package/src/server/index/serve-options.ts +9 -43
  308. package/src/server/index/websocket-handler.ts +7 -0
  309. package/src/server/index.ts +6 -5
  310. package/src/server/inference/client-encoder-delivery.ts +3 -1
  311. package/src/server/lifecycle.ts +8 -1
  312. package/src/server/management/advisor-routes.ts +26 -9
  313. package/src/server/management/agent-settings-routes.ts +424 -543
  314. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  315. package/src/server/management/claude-code-settings-patch.ts +211 -0
  316. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  317. package/src/server/management/codex-agent-role-routes.ts +79 -2
  318. package/src/server/management/codex-cli-update-routes.ts +55 -0
  319. package/src/server/management/codex-prompt-routes.ts +2 -1
  320. package/src/server/management/config-routes.ts +444 -380
  321. package/src/server/management/consent-session.ts +6 -0
  322. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  323. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  324. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  325. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  326. package/src/server/management/integration-routes.ts +45 -5
  327. package/src/server/management/link-enrollment.ts +21 -32
  328. package/src/server/management/link-route-state.ts +1 -0
  329. package/src/server/management/link-routes.ts +4 -1
  330. package/src/server/management/model-routes.ts +22 -6
  331. package/src/server/management/model-rows.ts +3 -1
  332. package/src/server/management/native-integration-routes.ts +90 -38
  333. package/src/server/management/oauth-account-routes.ts +8 -7
  334. package/src/server/management/route-registry.ts +8 -3
  335. package/src/server/management/session-routes.ts +20 -2
  336. package/src/server/management/shadow-call-validation.ts +43 -2
  337. package/src/server/management/sidebar-routes.ts +2 -1
  338. package/src/server/management/system-restart.ts +47 -7
  339. package/src/server/management-api.ts +61 -51
  340. package/src/server/management-auth.ts +11 -3
  341. package/src/server/messages-native.ts +21 -7
  342. package/src/server/messages-shared.ts +110 -18
  343. package/src/server/persistent-gui-session.ts +155 -0
  344. package/src/server/port-reclaim.ts +29 -5
  345. package/src/server/proxy-liveness.ts +110 -33
  346. package/src/server/request-decompress.ts +5 -1
  347. package/src/server/responses/account-change-state.ts +14 -2
  348. package/src/server/responses/adapter-continuation.ts +5 -4
  349. package/src/server/responses/adapter-delivery.ts +20 -5
  350. package/src/server/responses/adapter-dispatch.ts +39 -45
  351. package/src/server/responses/advisor-plan-slot.ts +3 -0
  352. package/src/server/responses/advisor-slot.ts +4 -2
  353. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  354. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  355. package/src/server/responses/combo-required-tool-contract.ts +2 -1
  356. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  357. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  358. package/src/server/responses/combo-stream-preflight.ts +47 -7
  359. package/src/server/responses/compact.ts +14 -7
  360. package/src/server/responses/compaction-recovery.ts +2 -1
  361. package/src/server/responses/core-auth.ts +2 -1
  362. package/src/server/responses/core-codex-account.ts +1 -0
  363. package/src/server/responses/core-combo-failure.ts +11 -6
  364. package/src/server/responses/core-combo-native.ts +6 -5
  365. package/src/server/responses/core-combo.ts +93 -20
  366. package/src/server/responses/core-options.ts +7 -0
  367. package/src/server/responses/fetch-helpers.ts +5 -1
  368. package/src/server/responses/jev-model-invoke.ts +8 -3
  369. package/src/server/responses/memory-models.ts +3 -2
  370. package/src/server/responses/passthrough-delivery.ts +36 -8
  371. package/src/server/responses/passthrough-dispatch.ts +12 -12
  372. package/src/server/responses/request-prepare.ts +10 -1
  373. package/src/server/responses/request-transport.ts +41 -6
  374. package/src/server/responses/run-turn-execution.ts +11 -3
  375. package/src/server/responses/sidecar-execution.ts +5 -0
  376. package/src/server/responses/turn-membership.ts +30 -0
  377. package/src/server/responses-custom-tool-repair.ts +86 -11
  378. package/src/server/responses-image-gen-repair.ts +1 -1
  379. package/src/server/restart-parent-ownership.ts +49 -0
  380. package/src/server/stop-teardown.ts +46 -9
  381. package/src/server/windows-tcp-drop.ts +4 -2
  382. package/src/service/desktop-recovery-process.ts +341 -0
  383. package/src/service/desktop-recovery.ts +172 -0
  384. package/src/service/windows-ops.ts +6 -3
  385. package/src/service/windows-scheduler.ts +29 -6
  386. package/src/stall-timeout.ts +47 -0
  387. package/src/tray/windows.ts +6 -4
  388. package/src/types/config.ts +61 -10
  389. package/src/types/request.ts +1 -1
  390. package/src/types.ts +1 -0
  391. package/src/update/async-check.ts +4 -3
  392. package/src/update/bind-probe.ts +2 -2
  393. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  394. package/src/update/guarded-port-reclaim.ts +14 -0
  395. package/src/update/guarded-runtime-ops.ts +58 -0
  396. package/src/update/guarded-tray-ops.ts +9 -0
  397. package/src/update/index.ts +196 -58
  398. package/src/update/job-pinned-start.ts +53 -0
  399. package/src/update/job-supervised-restart.ts +23 -6
  400. package/src/update/job-update-home.ts +62 -0
  401. package/src/update/job-update-tray.ts +29 -0
  402. package/src/update/job-windows-restart.ts +39 -0
  403. package/src/update/job.ts +179 -193
  404. package/src/update/mutation-guard.d.mts +30 -0
  405. package/src/update/mutation-guard.mjs +103 -0
  406. package/src/update/notify.ts +2 -2
  407. package/src/update/npm-cache-preflight.mjs +4 -4
  408. package/src/update/npm-install.mjs +5 -3
  409. package/src/update/pnpm-read-policy.mjs +3 -2
  410. package/src/update/proxy-liveness-probe.mjs +2 -2
  411. package/src/update/service-home-authority.ts +35 -0
  412. package/src/update/service-home-package-only-protocol.json +1 -0
  413. package/src/update/service-home-policy.d.mts +25 -0
  414. package/src/update/service-home-policy.mjs +112 -0
  415. package/src/update/service-home-probe-entry.ts +9 -0
  416. package/src/update/service-home-probe.d.mts +15 -0
  417. package/src/update/service-home-probe.mjs +79 -0
  418. package/src/update/service-home-protocol.json +1 -0
  419. package/src/update/supervised-recovery.d.mts +2 -2
  420. package/src/update/supervised-recovery.mjs +14 -7
  421. package/src/update/transactional-install.d.mts +3 -1
  422. package/src/update/transactional-install.mjs +29 -19
  423. package/src/update/update-failure-guidance.mjs +1 -1
  424. package/src/update/worker-launch.ts +3 -3
  425. package/src/vision/anthropic-describe.ts +2 -1
  426. package/src/web-search/anthropic-executor.ts +2 -1
  427. package/src/web-search/anthropic-history.ts +1 -0
  428. package/src/web-search/format-result.ts +3 -2
  429. package/src/web-search/header-deadline.ts +3 -2
  430. package/src/web-search/loop.ts +10 -4
  431. package/src/web-search/parse.ts +191 -38
  432. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  433. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  434. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  435. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
@@ -1,3 +1,6 @@
1
+ import { readConfigForAdmittedMutation } from "../../config/persisted-mutation";
2
+ import { getConfigDir as configRoot, withConfigDirHardeningSettled as settleConfigRoot } from "../../config/paths";
3
+ import { WindowsSecretAclSettleTimeoutError } from "../../lib/windows-secret-acl";
1
4
  import { MAIN_ACCOUNT_HARD_LOCK_MIN_PERCENT } from "../../codex/quota-types";
2
5
  import { resolveMainAccountHardLockThresholds } from "../../codex/main-account-hard-lock";
3
6
  import { getMainAccountExternalUsageWarning } from "../../codex/main-account-external-usage";
@@ -45,7 +48,7 @@ import {
45
48
  import { removeCredential } from "../../oauth/store";
46
49
  import { providerDestinationResolvedError } from "../../lib/destination-policy";
47
50
  import { isStreamMode } from "../../lib/bun-stream-caps";
48
- import { shadowSourceModels } from "../../lib/shadow-call";
51
+ import { isDefaultShadowSourceModels, shadowSourceModelOptions, shadowSourceModels } from "../../lib/shadow-call";
49
52
  import {
50
53
  configureAppOwnedMemoryBudget,
51
54
  enforceAppOwnedMemoryBudget,
@@ -121,7 +124,11 @@ import {
121
124
  type DebugFlag,
122
125
  } from "../../lib/debug-settings";
123
126
  import type { OcxClaudeCodeConfig, OcxConfig, OcxCustomModel, OcxProviderConfig } from "../../types";
124
- import { shadowCallTargetError } from "./shadow-call-validation";
127
+ import {
128
+ normalizeShadowCallSourceModels,
129
+ shadowCallSourceModelsError,
130
+ shadowCallTargetError,
131
+ } from "./shadow-call-validation";
125
132
  import { autoReviewOverrideConfigError } from "../../config/provider-validation";
126
133
  import { ConfigWritePublishedError } from "../../config/persist-unlocked";
127
134
  import { drainAndShutdown } from "../lifecycle";
@@ -148,6 +155,17 @@ function quotaAutoRefreshSettings(config: OcxConfig) {
148
155
  ]));
149
156
  }
150
157
 
158
+ /** The complete shadow-call settings body shared by GET and a successful PUT. */
159
+ function shadowCallSettingsResponse(config: OcxConfig) {
160
+ const sci = config.shadowCallIntercept ?? {};
161
+ return {
162
+ enabled: sci.enabled === true,
163
+ model: sci.model ?? "",
164
+ sourceModels: shadowSourceModels(sci.sourceModels),
165
+ sourceModelOptions: shadowSourceModelOptions(sci.sourceModels),
166
+ };
167
+ }
168
+
151
169
  async function sidecarVisionResponseSettings(config: OcxConfig): Promise<{
152
170
  model: string;
153
171
  reasoning: string;
@@ -274,10 +292,10 @@ export async function syncEnabledClientIntegrations(
274
292
  const models = await (deps.fetchAllModels ?? fetchAllModels)(config);
275
293
  // Serialized with Desktop mode transitions (picker lock): a first-party switch cannot interleave.
276
294
  const { runPickerTransition } = await import("./claude-desktop-picker-routes");
277
- await runPickerTransition(config, async () => {
295
+ await runPickerTransition(config, () => settleConfigRoot(configRoot(), () => {
278
296
  // Discovery admits a concurrent OFF or settings edit. Re-read outside C:
279
297
  // the writer facade owns L and its final desired-state check under L→C.
280
- const latest = loadConfig();
298
+ const latest = readConfigForAdmittedMutation();
281
299
  // Discovery awaited: the mode may have changed meanwhile. Re-resolve on the fresh read,
282
300
  // immediately before the writer, so a first-party switch during fetchAllModels still wins.
283
301
  if (stale()) return;
@@ -314,7 +332,7 @@ export async function syncEnabledClientIntegrations(
314
332
  : { client: "claude-desktop", ok: true, changed: true });
315
333
  }
316
334
  }
317
- });
335
+ }));
318
336
  } catch (error) {
319
337
  out.push({ client: "claude-desktop", ok: false, reason: error instanceof Error ? error.message : String(error) });
320
338
  }
@@ -331,8 +349,8 @@ export async function syncEnabledClientIntegrations(
331
349
  config,
332
350
  port,
333
351
  }, unattended
334
- ? ["mcode", "pi", "aside", "raycast", "omo", "commandcode", "droid", "opencode", "kilo", "qoder", "qoder-cn", "workbuddy", "workbuddy-ai"]
335
- : ["mcode", "pi", "aside", "raycast", "omo", "cline", "commandcode", "droid", "opencode", "kilo", "qoder", "qoder-cn", "workbuddy", "workbuddy-ai"],
352
+ ? ["mcode", "pi", "aside", "raycast", "omo", "commandcode", "droid", "opencode", "kilo", "qoder", "qoder-cn", "workbuddy", "workbuddy-ai", "hermes", "t3code"]
353
+ : ["mcode", "pi", "aside", "raycast", "omo", "cline", "commandcode", "droid", "opencode", "kilo", "qoder", "qoder-cn", "workbuddy", "workbuddy-ai", "hermes", "t3code"],
336
354
  ...unattended ? [{ refreshOnly: true, admit }] as const : []));
337
355
 
338
356
  return out;
@@ -357,6 +375,14 @@ function publicVisionSidecarSettings(
357
375
 
358
376
  /** Serve validated settings and publish catalog-affecting changes after persistence. */
359
377
  export async function handleConfigRoutes(ctx: ManagementContext): Promise<Response | null> {
378
+ try { return await handleConfigRoutesImpl(ctx); }
379
+ catch (error) {
380
+ if (!(error instanceof WindowsSecretAclSettleTimeoutError)) throw error;
381
+ return jsonResponse({ error: "Could not save settings", code: "write_failed", diagnostic: { stage: "ca", cause: "ETIMEDOUT" } }, 500);
382
+ }
383
+ }
384
+
385
+ async function handleConfigRoutesImpl(ctx: ManagementContext): Promise<Response | null> {
360
386
  const { req, url, config, deps, convergeCodexCatalog, syncClaudeAgentDefsBestEffort } = ctx;
361
387
  const readStartupHealth = deps.getCachedStartupHealth ?? getCachedStartupHealth;
362
388
  // Settings only seed the dashboard chip; /api/startup-health owns the bounded fresh read.
@@ -600,13 +626,7 @@ export async function handleConfigRoutes(ctx: ManagementContext): Promise<Respon
600
626
  || percent < MAIN_ACCOUNT_HARD_LOCK_MIN_PERCENT || percent > 100)) {
601
627
  return jsonResponse({ error: "codexMainAccountHardLockThresholds requires integer short/long percentages from 80 to 100" }, 400);
602
628
  }
603
- // A partial body updates one window and keeps the other stored value.
604
- hardLockThresholds = { ...config.codexMainAccountHardLockThresholds,
605
- ...(value as NonNullable<OcxConfig["codexMainAccountHardLockThresholds"]>) };
606
- const defaults = resolveMainAccountHardLockThresholds(undefined);
607
- if ((hardLockThresholds.short ?? defaults.short) > (hardLockThresholds.long ?? defaults.long)) {
608
- return jsonResponse({ error: "codexMainAccountHardLockThresholds short must not exceed long" }, 400);
609
- }
629
+ hardLockThresholds = { ...(value as NonNullable<OcxConfig["codexMainAccountHardLockThresholds"]>) };
610
630
  }
611
631
  // null clears the section, like compactionRouting; a present section must fully parse.
612
632
  const hardLockFallback = body.codexMainAccountHardLockFallback == null
@@ -666,163 +686,178 @@ export async function handleConfigRoutes(ctx: ManagementContext): Promise<Respon
666
686
  )) {
667
687
  return jsonResponse({ error: `appOwnedMemoryBudgetMb must be an integer from ${MIN_APP_OWNED_MEMORY_BUDGET_MB} to ${MAX_APP_OWNED_MEMORY_BUDGET_MB}` }, 400);
668
688
  }
669
- const restoreCompactionRouting = captureConfigTopLevelRollback(config, ["compactionRouting", "compactionRecovery", "memoryModels", "reasoningRetention"]);
670
- const previousSettings = {
671
- codexAutoStart: config.codexAutoStart,
672
- hasCodexAutoStart: Object.hasOwn(config, "codexAutoStart"),
673
- streamMode: config.streamMode,
674
- hasStreamMode: Object.hasOwn(config, "streamMode"),
675
- appOwnedMemoryBudgetMb: config.appOwnedMemoryBudgetMb,
676
- hasAppOwnedMemoryBudgetMb: Object.hasOwn(config, "appOwnedMemoryBudgetMb"),
677
- codexAccountNamespaces: config.codexAccountNamespaces,
678
- hasCodexAccountNamespaces: Object.hasOwn(config, "codexAccountNamespaces"),
679
- codexAccountPickerEnabled: config.codexAccountPickerEnabled,
680
- hasCodexAccountPickerEnabled: Object.hasOwn(config, "codexAccountPickerEnabled"),
681
- codexQuotaAutoRefresh: config.codexQuotaAutoRefresh,
682
- hasCodexQuotaAutoRefresh: Object.hasOwn(config, "codexQuotaAutoRefresh"),
683
- oauthOpenBrowser: config.oauthOpenBrowser,
684
- hasOauthOpenBrowser: Object.hasOwn(config, "oauthOpenBrowser"),
685
- showCodexCredits: config.showCodexCredits,
686
- hasShowCodexCredits: Object.hasOwn(config, "showCodexCredits"),
687
- ultraFastTier: config.ultraFastTier,
688
- hasUltraFastTier: Object.hasOwn(config, "ultraFastTier"),
689
- fastRows: config.fastRows,
690
- hasFastRows: Object.hasOwn(config, "fastRows"),
691
- codexMainAccountHardLockThresholds: config.codexMainAccountHardLockThresholds,
692
- hasCodexMainAccountHardLockThresholds: Object.hasOwn(config, "codexMainAccountHardLockThresholds"),
693
- codexMainAccountHardLock: config.codexMainAccountHardLock,
694
- hasCodexMainAccountHardLock: Object.hasOwn(config, "codexMainAccountHardLock"),
695
- codexMainAccountHardLockFallback: config.codexMainAccountHardLockFallback,
696
- hasCodexMainAccountHardLockFallback: Object.hasOwn(config, "codexMainAccountHardLockFallback"),
697
- codexDesktopAuthless: config.codexDesktopAuthless,
698
- hasCodexDesktopAuthless: Object.hasOwn(config, "codexDesktopAuthless"),
699
- codexClientCompaction: config.codexClientCompaction,
700
- hasCodexClientCompaction: Object.hasOwn(config, "codexClientCompaction"),
701
- };
702
- const pickerWasEnabled = codexAccountPickerEnabled(config);
703
- let pickerIsEnabled = pickerWasEnabled;
704
- const authlessWasEnabled = config.codexDesktopAuthless === true;
705
- const clientCompactionWasEnabled = config.codexClientCompaction === true;
706
- const fastRowsWasEnabled = config.fastRows !== false;
707
- try {
708
- if (typeof body.codexAutoStart === "boolean") {
709
- config.codexAutoStart = body.codexAutoStart;
710
- }
711
- if (body.streamMode !== undefined) {
712
- if (body.streamMode === "auto") {
713
- deleteConfigTopLevelKey(config, "streamMode");
714
- } else {
715
- config.streamMode = body.streamMode as "legacy-tee" | "eager-relay";
716
- }
717
- }
718
- if (typeof body.appOwnedMemoryBudgetMb === "number") {
719
- config.appOwnedMemoryBudgetMb = body.appOwnedMemoryBudgetMb;
720
- }
721
- if (body.codexAccountPickerEnabled === true) {
722
- config.codexAccountPickerEnabled = true;
723
- initializeDefaultCodexAccountNamespaces(config);
724
- } else if (body.codexAccountPickerEnabled === false) {
725
- config.codexAccountPickerEnabled = false;
726
- }
727
- if (typeof body.showCodexCredits === "boolean") config.showCodexCredits = body.showCodexCredits;
728
- if (typeof body.oauthOpenBrowser === "boolean") {
729
- config.oauthOpenBrowser = body.oauthOpenBrowser;
689
+ let pickerWasEnabled = false, pickerIsEnabled = false;
690
+ let authlessIsEnabled = false, clientCompactionIsEnabled = false, fastRowsIsEnabled = false;
691
+ let desktopSwitchesChanged = false, fastRowsChanged = false;
692
+ const refusal = await settleConfigRoot(configRoot(), () => {
693
+ if (hardLockThresholds) {
694
+ hardLockThresholds = { ...config.codexMainAccountHardLockThresholds, ...hardLockThresholds };
695
+ const defaults = resolveMainAccountHardLockThresholds(undefined);
696
+ if ((hardLockThresholds.short ?? defaults.short) > (hardLockThresholds.long ?? defaults.long)) return jsonResponse({ error: "codexMainAccountHardLockThresholds short must not exceed long" }, 400);
730
697
  }
731
- // Off deletes the key rather than persisting `false`: absent is the documented
732
- // default, and a written `false` would survive as a decision nobody made.
733
- if (body.ultraFastTier === true) config.ultraFastTier = true;
734
- else if (body.ultraFastTier === false) deleteConfigTopLevelKey(config, "ultraFastTier");
735
- if (body.fastRows === false) config.fastRows = false;
736
- else if (body.fastRows === true) deleteConfigTopLevelKey(config, "fastRows");
737
- // Inverted from the pair above because the default is on (#5694): off is the persisted
738
- // decision, so it writes `false`, while on deletes the key and returns to the default.
739
- if (hardLockThresholds !== undefined) config.codexMainAccountHardLockThresholds = { ...hardLockThresholds };
740
- if (body.codexMainAccountHardLock === false) config.codexMainAccountHardLock = false;
741
- else if (body.codexMainAccountHardLock === true) deleteConfigTopLevelKey(config, "codexMainAccountHardLock");
742
- if (hardLockFallback === null) deleteConfigTopLevelKey(config, "codexMainAccountHardLockFallback");
743
- else if (hardLockFallback?.success) config.codexMainAccountHardLockFallback = hardLockFallback.data;
744
- if (body.codexDesktopAuthless === true) config.codexDesktopAuthless = true;
745
- else if (body.codexDesktopAuthless === false) deleteConfigTopLevelKey(config, "codexDesktopAuthless");
746
- if (body.codexClientCompaction === true) config.codexClientCompaction = true;
747
- else if (body.codexClientCompaction === false) deleteConfigTopLevelKey(config, "codexClientCompaction");
748
- if (compactionRouting === null) deleteConfigTopLevelKey(config, "compactionRouting");
749
- else if (compactionRouting?.success) config.compactionRouting = compactionRouting.data;
750
- if (compactionRecovery === null) deleteConfigTopLevelKey(config, "compactionRecovery");
751
- else if (compactionRecovery?.success) config.compactionRecovery = compactionRecovery.data;
752
- if (reasoningRetention === null) deleteConfigTopLevelKey(config, "reasoningRetention");
753
- else if (reasoningRetention?.success) config.reasoningRetention = reasoningRetention.data;
754
- // Null clears both phases; the GUI sends that when neither row names a model.
755
- if (memoryModels === null) deleteConfigTopLevelKey(config, "memoryModels");
756
- else if (memoryModels?.success) config.memoryModels = memoryModels.data;
757
698
  if (quotaAutoRefreshChange) {
758
699
  const { id, window, enabled } = quotaAutoRefreshChange;
759
- const setting = { ...(config.codexQuotaAutoRefresh?.[id] ?? {}) };
760
- if (enabled) setting[window] = true;
761
- else delete setting[window];
762
- const all = { ...(config.codexQuotaAutoRefresh ?? {}) };
763
- if (Object.keys(setting).length > 0) all[id] = setting;
764
- else delete all[id];
765
- if (Object.keys(all).length > 0) config.codexQuotaAutoRefresh = all;
766
- else deleteConfigTopLevelKey(config, "codexQuotaAutoRefresh");
700
+ if (id !== MAIN_CODEX_ACCOUNT_ID && !(config.codexAccounts ?? []).some(account => isSelectableCodexPoolAccount(account) && account.id === id)) return jsonResponse({ error: "Account not found" }, 404);
701
+ if (enabled && !codexQuotaAutoRefreshStatus(config, id, getAccountQuota(id))[window === "fiveHour" ? "fiveHourAvailable" : "weeklyAvailable"]) return jsonResponse({ error: "Quota window is not available for this account" }, 409);
767
702
  }
768
- pickerIsEnabled = codexAccountPickerEnabled(config);
769
- (deps.saveConfigPreservingClaudeCode ?? saveConfigPreservingClaudeCode)(config);
770
- } catch (error) {
771
- if (previousSettings.hasCodexAutoStart) config.codexAutoStart = previousSettings.codexAutoStart;
772
- else deleteConfigTopLevelKey(config, "codexAutoStart");
773
- if (previousSettings.hasStreamMode) config.streamMode = previousSettings.streamMode;
774
- else deleteConfigTopLevelKey(config, "streamMode");
775
- if (previousSettings.hasAppOwnedMemoryBudgetMb) {
776
- config.appOwnedMemoryBudgetMb = previousSettings.appOwnedMemoryBudgetMb;
777
- } else deleteConfigTopLevelKey(config, "appOwnedMemoryBudgetMb");
778
- if (previousSettings.hasCodexAccountNamespaces) {
779
- config.codexAccountNamespaces = previousSettings.codexAccountNamespaces;
780
- } else deleteConfigTopLevelKey(config, "codexAccountNamespaces");
781
- if (previousSettings.hasCodexAccountPickerEnabled) {
782
- config.codexAccountPickerEnabled = previousSettings.codexAccountPickerEnabled;
783
- } else deleteConfigTopLevelKey(config, "codexAccountPickerEnabled");
784
- if (previousSettings.hasCodexQuotaAutoRefresh) {
785
- config.codexQuotaAutoRefresh = previousSettings.codexQuotaAutoRefresh;
786
- } else deleteConfigTopLevelKey(config, "codexQuotaAutoRefresh");
787
- if (previousSettings.hasShowCodexCredits) config.showCodexCredits = previousSettings.showCodexCredits;
788
- else deleteConfigTopLevelKey(config, "showCodexCredits");
789
- if (previousSettings.hasOauthOpenBrowser) {
790
- config.oauthOpenBrowser = previousSettings.oauthOpenBrowser;
791
- } else deleteConfigTopLevelKey(config, "oauthOpenBrowser");
792
- if (previousSettings.hasUltraFastTier) {
793
- config.ultraFastTier = previousSettings.ultraFastTier;
794
- } else deleteConfigTopLevelKey(config, "ultraFastTier");
795
- if (previousSettings.hasFastRows) {
796
- config.fastRows = previousSettings.fastRows;
797
- } else deleteConfigTopLevelKey(config, "fastRows");
798
- if (previousSettings.hasCodexMainAccountHardLockThresholds) {
799
- config.codexMainAccountHardLockThresholds = previousSettings.codexMainAccountHardLockThresholds;
800
- } else deleteConfigTopLevelKey(config, "codexMainAccountHardLockThresholds");
801
- if (previousSettings.hasCodexMainAccountHardLock) {
802
- config.codexMainAccountHardLock = previousSettings.codexMainAccountHardLock;
803
- } else deleteConfigTopLevelKey(config, "codexMainAccountHardLock");
804
- if (previousSettings.hasCodexMainAccountHardLockFallback) {
805
- config.codexMainAccountHardLockFallback = previousSettings.codexMainAccountHardLockFallback;
806
- } else deleteConfigTopLevelKey(config, "codexMainAccountHardLockFallback");
807
- if (previousSettings.hasCodexDesktopAuthless) {
808
- config.codexDesktopAuthless = previousSettings.codexDesktopAuthless;
809
- } else deleteConfigTopLevelKey(config, "codexDesktopAuthless");
810
- if (previousSettings.hasCodexClientCompaction) {
811
- config.codexClientCompaction = previousSettings.codexClientCompaction;
812
- } else deleteConfigTopLevelKey(config, "codexClientCompaction");
813
- restoreCompactionRouting();
814
- throw error;
815
- }
703
+ pickerWasEnabled = codexAccountPickerEnabled(config);
704
+ const authlessWasEnabled = config.codexDesktopAuthless === true;
705
+ const clientCompactionWasEnabled = config.codexClientCompaction === true;
706
+ const fastRowsWasEnabled = config.fastRows !== false;
707
+ const restoreCompactionRouting = captureConfigTopLevelRollback(config, ["compactionRouting", "compactionRecovery", "memoryModels", "reasoningRetention"]);
708
+ const previousSettings = {
709
+ codexAutoStart: config.codexAutoStart,
710
+ hasCodexAutoStart: Object.hasOwn(config, "codexAutoStart"),
711
+ streamMode: config.streamMode,
712
+ hasStreamMode: Object.hasOwn(config, "streamMode"),
713
+ appOwnedMemoryBudgetMb: config.appOwnedMemoryBudgetMb,
714
+ hasAppOwnedMemoryBudgetMb: Object.hasOwn(config, "appOwnedMemoryBudgetMb"),
715
+ codexAccountNamespaces: config.codexAccountNamespaces,
716
+ hasCodexAccountNamespaces: Object.hasOwn(config, "codexAccountNamespaces"),
717
+ codexAccountPickerEnabled: config.codexAccountPickerEnabled,
718
+ hasCodexAccountPickerEnabled: Object.hasOwn(config, "codexAccountPickerEnabled"),
719
+ codexQuotaAutoRefresh: config.codexQuotaAutoRefresh,
720
+ hasCodexQuotaAutoRefresh: Object.hasOwn(config, "codexQuotaAutoRefresh"),
721
+ oauthOpenBrowser: config.oauthOpenBrowser,
722
+ hasOauthOpenBrowser: Object.hasOwn(config, "oauthOpenBrowser"),
723
+ showCodexCredits: config.showCodexCredits,
724
+ hasShowCodexCredits: Object.hasOwn(config, "showCodexCredits"),
725
+ ultraFastTier: config.ultraFastTier,
726
+ hasUltraFastTier: Object.hasOwn(config, "ultraFastTier"),
727
+ fastRows: config.fastRows,
728
+ hasFastRows: Object.hasOwn(config, "fastRows"),
729
+ codexMainAccountHardLockThresholds: config.codexMainAccountHardLockThresholds,
730
+ hasCodexMainAccountHardLockThresholds: Object.hasOwn(config, "codexMainAccountHardLockThresholds"),
731
+ codexMainAccountHardLock: config.codexMainAccountHardLock,
732
+ hasCodexMainAccountHardLock: Object.hasOwn(config, "codexMainAccountHardLock"),
733
+ codexMainAccountHardLockFallback: config.codexMainAccountHardLockFallback,
734
+ hasCodexMainAccountHardLockFallback: Object.hasOwn(config, "codexMainAccountHardLockFallback"),
735
+ codexDesktopAuthless: config.codexDesktopAuthless,
736
+ hasCodexDesktopAuthless: Object.hasOwn(config, "codexDesktopAuthless"),
737
+ codexClientCompaction: config.codexClientCompaction,
738
+ hasCodexClientCompaction: Object.hasOwn(config, "codexClientCompaction"),
739
+ };
740
+ try {
741
+ if (typeof body.codexAutoStart === "boolean") {
742
+ config.codexAutoStart = body.codexAutoStart;
743
+ }
744
+ if (body.streamMode !== undefined) {
745
+ if (body.streamMode === "auto") {
746
+ deleteConfigTopLevelKey(config, "streamMode");
747
+ } else {
748
+ config.streamMode = body.streamMode as "legacy-tee" | "eager-relay";
749
+ }
750
+ }
751
+ if (typeof body.appOwnedMemoryBudgetMb === "number") {
752
+ config.appOwnedMemoryBudgetMb = body.appOwnedMemoryBudgetMb;
753
+ }
754
+ if (body.codexAccountPickerEnabled === true) {
755
+ config.codexAccountPickerEnabled = true;
756
+ initializeDefaultCodexAccountNamespaces(config);
757
+ } else if (body.codexAccountPickerEnabled === false) {
758
+ config.codexAccountPickerEnabled = false;
759
+ }
760
+ if (typeof body.showCodexCredits === "boolean") config.showCodexCredits = body.showCodexCredits;
761
+ if (typeof body.oauthOpenBrowser === "boolean") {
762
+ config.oauthOpenBrowser = body.oauthOpenBrowser;
763
+ }
764
+ // Off deletes the key rather than persisting `false`: absent is the documented
765
+ // default, and a written `false` would survive as a decision nobody made.
766
+ if (body.ultraFastTier === true) config.ultraFastTier = true;
767
+ else if (body.ultraFastTier === false) deleteConfigTopLevelKey(config, "ultraFastTier");
768
+ if (body.fastRows === false) config.fastRows = false;
769
+ else if (body.fastRows === true) deleteConfigTopLevelKey(config, "fastRows");
770
+ // Inverted from the pair above because the default is on (#5694): off is the persisted
771
+ // decision, so it writes `false`, while on deletes the key and returns to the default.
772
+ if (hardLockThresholds !== undefined) config.codexMainAccountHardLockThresholds = { ...hardLockThresholds };
773
+ if (body.codexMainAccountHardLock === false) config.codexMainAccountHardLock = false;
774
+ else if (body.codexMainAccountHardLock === true) deleteConfigTopLevelKey(config, "codexMainAccountHardLock");
775
+ if (hardLockFallback === null) deleteConfigTopLevelKey(config, "codexMainAccountHardLockFallback");
776
+ else if (hardLockFallback?.success) config.codexMainAccountHardLockFallback = hardLockFallback.data;
777
+ if (body.codexDesktopAuthless === true) config.codexDesktopAuthless = true;
778
+ else if (body.codexDesktopAuthless === false) deleteConfigTopLevelKey(config, "codexDesktopAuthless");
779
+ if (body.codexClientCompaction === true) config.codexClientCompaction = true;
780
+ else if (body.codexClientCompaction === false) deleteConfigTopLevelKey(config, "codexClientCompaction");
781
+ if (compactionRouting === null) deleteConfigTopLevelKey(config, "compactionRouting");
782
+ else if (compactionRouting?.success) config.compactionRouting = compactionRouting.data;
783
+ if (compactionRecovery === null) deleteConfigTopLevelKey(config, "compactionRecovery");
784
+ else if (compactionRecovery?.success) config.compactionRecovery = compactionRecovery.data;
785
+ if (reasoningRetention === null) deleteConfigTopLevelKey(config, "reasoningRetention");
786
+ else if (reasoningRetention?.success) config.reasoningRetention = reasoningRetention.data;
787
+ // Null clears both phases; the GUI sends that when neither row names a model.
788
+ if (memoryModels === null) deleteConfigTopLevelKey(config, "memoryModels");
789
+ else if (memoryModels?.success) config.memoryModels = memoryModels.data;
790
+ if (quotaAutoRefreshChange) {
791
+ const { id, window, enabled } = quotaAutoRefreshChange;
792
+ const setting = { ...(config.codexQuotaAutoRefresh?.[id] ?? {}) };
793
+ if (enabled) setting[window] = true;
794
+ else delete setting[window];
795
+ const all = { ...(config.codexQuotaAutoRefresh ?? {}) };
796
+ if (Object.keys(setting).length > 0) all[id] = setting;
797
+ else delete all[id];
798
+ if (Object.keys(all).length > 0) config.codexQuotaAutoRefresh = all;
799
+ else deleteConfigTopLevelKey(config, "codexQuotaAutoRefresh");
800
+ }
801
+ pickerIsEnabled = codexAccountPickerEnabled(config);
802
+ (deps.saveConfigPreservingClaudeCode ?? saveConfigPreservingClaudeCode)(config);
803
+ authlessIsEnabled = config.codexDesktopAuthless === true;
804
+ clientCompactionIsEnabled = config.codexClientCompaction === true;
805
+ fastRowsIsEnabled = config.fastRows !== false;
806
+ fastRowsChanged = fastRowsWasEnabled !== fastRowsIsEnabled;
807
+ desktopSwitchesChanged = authlessWasEnabled !== authlessIsEnabled || clientCompactionWasEnabled !== clientCompactionIsEnabled;
808
+ } catch (error) {
809
+ if (previousSettings.hasCodexAutoStart) config.codexAutoStart = previousSettings.codexAutoStart;
810
+ else deleteConfigTopLevelKey(config, "codexAutoStart");
811
+ if (previousSettings.hasStreamMode) config.streamMode = previousSettings.streamMode;
812
+ else deleteConfigTopLevelKey(config, "streamMode");
813
+ if (previousSettings.hasAppOwnedMemoryBudgetMb) {
814
+ config.appOwnedMemoryBudgetMb = previousSettings.appOwnedMemoryBudgetMb;
815
+ } else deleteConfigTopLevelKey(config, "appOwnedMemoryBudgetMb");
816
+ if (previousSettings.hasCodexAccountNamespaces) {
817
+ config.codexAccountNamespaces = previousSettings.codexAccountNamespaces;
818
+ } else deleteConfigTopLevelKey(config, "codexAccountNamespaces");
819
+ if (previousSettings.hasCodexAccountPickerEnabled) {
820
+ config.codexAccountPickerEnabled = previousSettings.codexAccountPickerEnabled;
821
+ } else deleteConfigTopLevelKey(config, "codexAccountPickerEnabled");
822
+ if (previousSettings.hasCodexQuotaAutoRefresh) {
823
+ config.codexQuotaAutoRefresh = previousSettings.codexQuotaAutoRefresh;
824
+ } else deleteConfigTopLevelKey(config, "codexQuotaAutoRefresh");
825
+ if (previousSettings.hasShowCodexCredits) config.showCodexCredits = previousSettings.showCodexCredits;
826
+ else deleteConfigTopLevelKey(config, "showCodexCredits");
827
+ if (previousSettings.hasOauthOpenBrowser) {
828
+ config.oauthOpenBrowser = previousSettings.oauthOpenBrowser;
829
+ } else deleteConfigTopLevelKey(config, "oauthOpenBrowser");
830
+ if (previousSettings.hasUltraFastTier) {
831
+ config.ultraFastTier = previousSettings.ultraFastTier;
832
+ } else deleteConfigTopLevelKey(config, "ultraFastTier");
833
+ if (previousSettings.hasFastRows) {
834
+ config.fastRows = previousSettings.fastRows;
835
+ } else deleteConfigTopLevelKey(config, "fastRows");
836
+ if (previousSettings.hasCodexMainAccountHardLockThresholds) {
837
+ config.codexMainAccountHardLockThresholds = previousSettings.codexMainAccountHardLockThresholds;
838
+ } else deleteConfigTopLevelKey(config, "codexMainAccountHardLockThresholds");
839
+ if (previousSettings.hasCodexMainAccountHardLock) {
840
+ config.codexMainAccountHardLock = previousSettings.codexMainAccountHardLock;
841
+ } else deleteConfigTopLevelKey(config, "codexMainAccountHardLock");
842
+ if (previousSettings.hasCodexMainAccountHardLockFallback) {
843
+ config.codexMainAccountHardLockFallback = previousSettings.codexMainAccountHardLockFallback;
844
+ } else deleteConfigTopLevelKey(config, "codexMainAccountHardLockFallback");
845
+ if (previousSettings.hasCodexDesktopAuthless) {
846
+ config.codexDesktopAuthless = previousSettings.codexDesktopAuthless;
847
+ } else deleteConfigTopLevelKey(config, "codexDesktopAuthless");
848
+ if (previousSettings.hasCodexClientCompaction) {
849
+ config.codexClientCompaction = previousSettings.codexClientCompaction;
850
+ } else deleteConfigTopLevelKey(config, "codexClientCompaction");
851
+ restoreCompactionRouting();
852
+ throw error;
853
+ }
854
+ return null;
855
+ });
856
+ if (refusal) return refusal;
816
857
  if (typeof body.appOwnedMemoryBudgetMb === "number") {
817
858
  configureAppOwnedMemoryBudget(resolveAppOwnedMemoryBudgetBytes(body.appOwnedMemoryBudgetMb));
818
859
  enforceAppOwnedMemoryBudget();
819
860
  }
820
- const authlessIsEnabled = config.codexDesktopAuthless === true;
821
- const clientCompactionIsEnabled = config.codexClientCompaction === true;
822
- const fastRowsIsEnabled = config.fastRows !== false;
823
- const fastRowsChanged = fastRowsWasEnabled !== fastRowsIsEnabled;
824
- const desktopSwitchesChanged = authlessWasEnabled !== authlessIsEnabled
825
- || clientCompactionWasEnabled !== clientCompactionIsEnabled;
826
861
  // Catalog convergence is not config injection, and the comment that used to sit here said
827
862
  // it was. `convergeCodexCatalog` rejects any scope but `catalog` and never reaches the
828
863
  // injector, which is why flipping either switch left `config.toml` in its old shape until
@@ -1004,11 +1039,6 @@ export async function handleConfigRoutes(ctx: ManagementContext): Promise<Respon
1004
1039
  };
1005
1040
  };
1006
1041
  const WEB_SEARCH_BACKENDS_UNION = ["openai", "anthropic", "xai", "gemini", "exa"] as const;
1007
- const instanceError = anthropicSidecarPatchError(config, {
1008
- ...(body.webSearch ? { webSearchSidecar: body.webSearch } : {}),
1009
- ...(body.vision ? { visionSidecar: body.vision } : {}),
1010
- });
1011
- if (instanceError) return jsonResponse({ error: instanceError }, 400);
1012
1042
  if (body.webSearch && body.webSearch.backend !== undefined && body.webSearch.backend !== null
1013
1043
  && !WEB_SEARCH_BACKENDS_UNION.includes(body.webSearch.backend as never)) {
1014
1044
  return jsonResponse({ error: "webSearch.backend must be openai, anthropic, xai, gemini, exa, or null" }, 400);
@@ -1045,189 +1075,208 @@ export async function handleConfigRoutes(ctx: ManagementContext): Promise<Respon
1045
1075
  if (body.vision?.reasoning !== undefined && !isVisionReasoningEffort(body.vision.reasoning)) {
1046
1076
  return jsonResponse({ error: `vision.reasoning must be ${VISION_REASONING_EFFORTS.join(", ")}` }, 400);
1047
1077
  }
1048
- // Reject ONLY a model we can prove is blind. An id nothing knows about stays
1049
- // allowed: the operator may be ahead of our catalog, and the runtime never
1050
- // required catalog membership (`tests/vision/vision-reasoning-contract.test.ts`
1051
- // pins `custom-vision` → 200). The catalog is read ONCE and reused for the
1052
- // rejection body, so a 400 cannot cost two provider fetches.
1053
- if (body.vision && typeof body.vision.model === "string" && body.vision.model !== "") {
1054
- const requested = body.vision.model;
1055
- const candidates = await visionCandidateRows({ ...config, visionSidecar: sidecarSettingsAfterPatch(config.visionSidecar, body.vision) });
1056
- const hint = body.vision.backend === "anthropic" || body.vision.backend === "openai"
1057
- || body.vision.backend === "routed"
1058
- ? body.vision.backend
1059
- : config.visionSidecar?.backend;
1060
- // Coherence (roadmap 170 r2): the forward/OAuth executors POST the model
1061
- // string VERBATIM, so a namespaced id on those backends persists a wire
1062
- // id they cannot run; and "routed" without a namespace cannot route.
1063
- const effectiveBackend = hint ?? "openai";
1064
- const namespaced = requested.includes("/");
1065
- if (namespaced && effectiveBackend !== "routed") {
1066
- return jsonResponse({ error: `vision.model "${requested}" is provider-namespaced; it requires vision.backend "routed"` }, 400);
1067
- }
1068
- if (!namespaced && effectiveBackend === "routed") {
1069
- return jsonResponse({ error: `vision.backend "routed" requires a provider-namespaced vision.model ("provider/model"); got "${requested}"` }, 400);
1070
- }
1071
- if (visionDescriberIsProvablyBlind(config, requested, candidates, hint)) {
1072
- return jsonResponse(visionDescriberRejection("vision.model", requested, config, candidates), 400);
1078
+ const evidenceState = JSON.stringify(config);
1079
+ const visionEvidence = typeof body.vision?.model === "string" && body.vision.model !== ""
1080
+ ? await visionCandidateRows({ ...config, visionSidecar: sidecarSettingsAfterPatch(config.visionSidecar, body.vision) }) : undefined;
1081
+ const webEvidence = body.webSearch && (body.webSearch.model !== undefined || body.webSearch.backend !== undefined || body.webSearch.anthropicInstance !== undefined)
1082
+ ? await webSearchCandidateRows({ ...config, webSearchSidecar: sidecarSettingsAfterPatch(config.webSearchSidecar, body.webSearch) }) : undefined;
1083
+ const committed = await settleConfigRoot(configRoot(), () => {
1084
+ if ((visionEvidence || webEvidence) && JSON.stringify(config) !== evidenceState) return jsonResponse({ error: "Sidecar validation state changed during discovery", code: "config_changed" }, 409);
1085
+ const instanceError = anthropicSidecarPatchError(config, {
1086
+ ...(body.webSearch ? { webSearchSidecar: body.webSearch } : {}),
1087
+ ...(body.vision ? { visionSidecar: body.vision } : {}),
1088
+ });
1089
+ if (instanceError) return jsonResponse({ error: instanceError }, 400);
1090
+ // Reject ONLY a model we can prove is blind. An id nothing knows about stays
1091
+ // allowed: the operator may be ahead of our catalog, and the runtime never
1092
+ // required catalog membership (`tests/vision/vision-reasoning-contract.test.ts`
1093
+ // pins `custom-vision` → 200). The catalog is read ONCE and reused for the
1094
+ // rejection body, so a 400 cannot cost two provider fetches.
1095
+ if (body.vision && typeof body.vision.model === "string" && body.vision.model !== "") {
1096
+ const requested = body.vision.model;
1097
+ const candidates = visionEvidence!;
1098
+ const hint = body.vision.backend === "anthropic" || body.vision.backend === "openai"
1099
+ || body.vision.backend === "routed"
1100
+ ? body.vision.backend
1101
+ : config.visionSidecar?.backend;
1102
+ // Coherence (roadmap 170 r2): the forward/OAuth executors POST the model
1103
+ // string VERBATIM, so a namespaced id on those backends persists a wire
1104
+ // id they cannot run; and "routed" without a namespace cannot route.
1105
+ const effectiveBackend = hint ?? "openai";
1106
+ const namespaced = requested.includes("/");
1107
+ if (namespaced && effectiveBackend !== "routed") {
1108
+ return jsonResponse({ error: `vision.model "${requested}" is provider-namespaced; it requires vision.backend "routed"` }, 400);
1109
+ }
1110
+ if (!namespaced && effectiveBackend === "routed") {
1111
+ return jsonResponse({ error: `vision.backend "routed" requires a provider-namespaced vision.model ("provider/model"); got "${requested}"` }, 400);
1112
+ }
1113
+ if (visionDescriberIsProvablyBlind(config, requested, candidates, hint)) {
1114
+ return jsonResponse(visionDescriberRejection("vision.model", requested, config, candidates), 400);
1115
+ }
1073
1116
  }
1074
- }
1075
1117
 
1076
- let normalizedVisionReasoning: ReturnType<typeof normalizeVisionReasoningForModel>;
1077
- let visionReasoningTouched = false;
1078
- if (body.vision && (body.vision.model !== undefined || body.vision.reasoning !== undefined)) {
1079
- visionReasoningTouched = true;
1080
- const model = typeof body.vision.model === "string"
1081
- ? (body.vision.model === "" ? "gpt-5.6-luna" : body.vision.model)
1082
- : (config.visionSidecar?.model || "gpt-5.6-luna");
1083
- const sourceReasoning = body.vision.reasoning ?? config.visionSidecar?.reasoning;
1084
- normalizedVisionReasoning = sourceReasoning === undefined
1085
- ? undefined
1086
- : normalizeVisionReasoningForModel(model, sourceReasoning);
1087
- }
1118
+ let normalizedVisionReasoning: ReturnType<typeof normalizeVisionReasoningForModel>;
1119
+ let visionReasoningTouched = false;
1120
+ if (body.vision && (body.vision.model !== undefined || body.vision.reasoning !== undefined)) {
1121
+ visionReasoningTouched = true;
1122
+ const model = typeof body.vision.model === "string"
1123
+ ? (body.vision.model === "" ? "gpt-5.6-luna" : body.vision.model)
1124
+ : (config.visionSidecar?.model || "gpt-5.6-luna");
1125
+ const sourceReasoning = body.vision.reasoning ?? config.visionSidecar?.reasoning;
1126
+ normalizedVisionReasoning = sourceReasoning === undefined
1127
+ ? undefined
1128
+ : normalizeVisionReasoningForModel(model, sourceReasoning);
1129
+ }
1088
1130
 
1089
- // Read BEFORE the mutation below: the Codex-side key follows the switch, and a flip is the
1090
- // only case that owes a config.toml rewrite.
1091
- const webSearchEnabledBefore = config.webSearchSidecar?.enabled !== false;
1092
- const visionEnabledBefore = config.visionSidecar?.enabled !== false;
1093
- if (body.webSearch) {
1094
- const pairTouched = body.webSearch.model !== undefined || body.webSearch.backend !== undefined || body.webSearch.anthropicInstance !== undefined;
1095
- // Validate against the backend the caller SUBMITTED, across the whole
1096
- // union — not just openai/anthropic (#2457). The union check above has
1097
- // already refused unknown literals, so a surviving string is a member;
1098
- // Array.includes does not narrow, hence the cast. Falling back to the
1099
- // stored backend for xai/gemini/exa both rejected legal pairs and
1100
- // accepted illegal ones: a submitted gemini was checked against a stored
1101
- // openai. null means "unset the backend", and unset resolves to openai.
1102
- const submittedBackend = body.webSearch.backend;
1103
- const effectiveBackend = typeof submittedBackend === "string"
1104
- && WEB_SEARCH_BACKENDS_UNION.includes(submittedBackend as never)
1105
- ? submittedBackend as typeof WEB_SEARCH_BACKENDS_UNION[number]
1106
- : submittedBackend === null
1107
- ? "openai"
1108
- : config.webSearchSidecar?.backend ?? "openai";
1109
- const effectiveModel = typeof body.webSearch.model === "string"
1110
- ? body.webSearch.model || undefined
1111
- : config.webSearchSidecar?.model;
1112
- if (pairTouched && effectiveModel) {
1113
- const candidates = await webSearchCandidateRows({ ...config, webSearchSidecar: sidecarSettingsAfterPatch(config.webSearchSidecar, body.webSearch) });
1114
- if (webSearchModelIsRejected(effectiveBackend, effectiveModel, candidates)) {
1115
- return jsonResponse(webSearchModelRejection("webSearch.model", effectiveBackend, effectiveModel, candidates), 400);
1131
+ // Read BEFORE the mutation below: the Codex-side key follows the switch, and a flip is the
1132
+ // only case that owes a config.toml rewrite.
1133
+ const webSearchEnabledBefore = config.webSearchSidecar?.enabled !== false;
1134
+ const visionEnabledBefore = config.visionSidecar?.enabled !== false;
1135
+ let webSearchCandidate: OcxConfig["webSearchSidecar"];
1136
+ if (body.webSearch) {
1137
+ const pairTouched = body.webSearch.model !== undefined || body.webSearch.backend !== undefined || body.webSearch.anthropicInstance !== undefined;
1138
+ // Validate against the backend the caller SUBMITTED, across the whole
1139
+ // union — not just openai/anthropic (#2457). The union check above has
1140
+ // already refused unknown literals, so a surviving string is a member;
1141
+ // Array.includes does not narrow, hence the cast. Falling back to the
1142
+ // stored backend for xai/gemini/exa both rejected legal pairs and
1143
+ // accepted illegal ones: a submitted gemini was checked against a stored
1144
+ // openai. null means "unset the backend", and unset resolves to openai.
1145
+ const submittedBackend = body.webSearch.backend;
1146
+ const effectiveBackend = typeof submittedBackend === "string"
1147
+ && WEB_SEARCH_BACKENDS_UNION.includes(submittedBackend as never)
1148
+ ? submittedBackend as typeof WEB_SEARCH_BACKENDS_UNION[number]
1149
+ : submittedBackend === null
1150
+ ? "openai"
1151
+ : config.webSearchSidecar?.backend ?? "openai";
1152
+ const effectiveModel = typeof body.webSearch.model === "string"
1153
+ ? body.webSearch.model || undefined
1154
+ : config.webSearchSidecar?.model;
1155
+ if (pairTouched && effectiveModel) {
1156
+ const candidates = webEvidence!;
1157
+ if (webSearchModelIsRejected(effectiveBackend, effectiveModel, candidates)) {
1158
+ return jsonResponse(webSearchModelRejection("webSearch.model", effectiveBackend, effectiveModel, candidates), 400);
1159
+ }
1116
1160
  }
1117
- }
1118
- const webSearchCandidate = { ...config.webSearchSidecar };
1119
- if (body.webSearch.anthropicInstance === null) delete webSearchCandidate.anthropicInstance;
1120
- else if (isAnthropicInstanceId(body.webSearch.anthropicInstance)) webSearchCandidate.anthropicInstance = body.webSearch.anthropicInstance;
1121
- if (typeof body.webSearch.model === "string") {
1122
- if (body.webSearch.model === "") delete webSearchCandidate.model;
1123
- else webSearchCandidate.model = body.webSearch.model;
1124
- }
1125
- if (body.webSearch.backend === null) delete webSearchCandidate.backend;
1126
- else if (WEB_SEARCH_BACKENDS_UNION.includes(body.webSearch.backend as never)) {
1127
- webSearchCandidate.backend = body.webSearch.backend as typeof WEB_SEARCH_BACKENDS_UNION[number];
1128
- }
1129
- if (typeof body.webSearch.reasoning === "string") webSearchCandidate.reasoning = body.webSearch.reasoning;
1130
- // Operator secret for the exa backend: string sets, empty string clears. The GET
1131
- // payload deliberately never carries it and redact.ts strips the key from logs.
1132
- if (typeof body.webSearch.exaApiKey === "string") {
1133
- if (body.webSearch.exaApiKey === "") delete webSearchCandidate.exaApiKey;
1134
- else webSearchCandidate.exaApiKey = body.webSearch.exaApiKey;
1135
- }
1136
- // Opt-in x_search block (L7): null clears; an object is doc-validated before persisting.
1137
- if (body.webSearch.xSearch === null) delete webSearchCandidate.xSearch;
1138
- else if (body.webSearch.xSearch !== undefined) {
1139
- if (!isPlainRecord(body.webSearch.xSearch)) {
1140
- return jsonResponse({ error: "webSearch.xSearch must be an object or null" }, 400);
1161
+ webSearchCandidate = { ...config.webSearchSidecar };
1162
+ if (body.webSearch.anthropicInstance === null) delete webSearchCandidate.anthropicInstance;
1163
+ else if (isAnthropicInstanceId(body.webSearch.anthropicInstance)) webSearchCandidate.anthropicInstance = body.webSearch.anthropicInstance;
1164
+ if (typeof body.webSearch.model === "string") {
1165
+ if (body.webSearch.model === "") delete webSearchCandidate.model;
1166
+ else webSearchCandidate.model = body.webSearch.model;
1141
1167
  }
1142
- const x = body.webSearch.xSearch as Record<string, unknown>;
1143
- const allowedXSearchKeys = new Set([
1144
- "enabled",
1145
- "allowedXHandles",
1146
- "excludedXHandles",
1147
- "fromDate",
1148
- "toDate",
1149
- ]);
1150
- const unknownKey = Object.keys(x).find(key => !allowedXSearchKeys.has(key));
1151
- if (unknownKey !== undefined) {
1152
- return jsonResponse({ error: `webSearch.xSearch.${unknownKey} is not a supported field` }, 400);
1168
+ if (body.webSearch.backend === null) delete webSearchCandidate.backend;
1169
+ else if (WEB_SEARCH_BACKENDS_UNION.includes(body.webSearch.backend as never)) {
1170
+ webSearchCandidate.backend = body.webSearch.backend as typeof WEB_SEARCH_BACKENDS_UNION[number];
1153
1171
  }
1154
- if (x.enabled !== undefined && typeof x.enabled !== "boolean") {
1155
- return jsonResponse({ error: "webSearch.xSearch.enabled must be a boolean" }, 400);
1172
+ if (typeof body.webSearch.reasoning === "string") webSearchCandidate.reasoning = body.webSearch.reasoning;
1173
+ // Operator secret for the exa backend: string sets, empty string clears. The GET
1174
+ // payload deliberately never carries it and redact.ts strips the key from logs.
1175
+ if (typeof body.webSearch.exaApiKey === "string") {
1176
+ if (body.webSearch.exaApiKey === "") delete webSearchCandidate.exaApiKey;
1177
+ else webSearchCandidate.exaApiKey = body.webSearch.exaApiKey;
1156
1178
  }
1157
- for (const field of ["allowedXHandles", "excludedXHandles"] as const) {
1158
- const value = x[field];
1159
- if (value !== undefined && (!Array.isArray(value) || !value.every(handle => typeof handle === "string"))) {
1160
- return jsonResponse({ error: `webSearch.xSearch.${field} must be an array of strings` }, 400);
1179
+ // Opt-in x_search block (L7): null clears; an object is doc-validated before persisting.
1180
+ if (body.webSearch.xSearch === null) delete webSearchCandidate.xSearch;
1181
+ else if (body.webSearch.xSearch !== undefined) {
1182
+ if (!isPlainRecord(body.webSearch.xSearch)) {
1183
+ return jsonResponse({ error: "webSearch.xSearch must be an object or null" }, 400);
1161
1184
  }
1162
- }
1163
- for (const field of ["fromDate", "toDate"] as const) {
1164
- if (x[field] !== undefined && typeof x[field] !== "string") {
1165
- return jsonResponse({ error: `webSearch.xSearch.${field} must be an ISO-8601 date (YYYY-MM-DD)` }, 400);
1185
+ const x = body.webSearch.xSearch as Record<string, unknown>;
1186
+ const allowedXSearchKeys = new Set([
1187
+ "enabled",
1188
+ "allowedXHandles",
1189
+ "excludedXHandles",
1190
+ "fromDate",
1191
+ "toDate",
1192
+ ]);
1193
+ const unknownKey = Object.keys(x).find(key => !allowedXSearchKeys.has(key));
1194
+ if (unknownKey !== undefined) {
1195
+ return jsonResponse({ error: `webSearch.xSearch.${unknownKey} is not a supported field` }, 400);
1196
+ }
1197
+ if (x.enabled !== undefined && typeof x.enabled !== "boolean") {
1198
+ return jsonResponse({ error: "webSearch.xSearch.enabled must be a boolean" }, 400);
1199
+ }
1200
+ for (const field of ["allowedXHandles", "excludedXHandles"] as const) {
1201
+ const value = x[field];
1202
+ if (value !== undefined && (!Array.isArray(value) || !value.every(handle => typeof handle === "string"))) {
1203
+ return jsonResponse({ error: `webSearch.xSearch.${field} must be an array of strings` }, 400);
1204
+ }
1205
+ }
1206
+ for (const field of ["fromDate", "toDate"] as const) {
1207
+ if (x[field] !== undefined && typeof x[field] !== "string") {
1208
+ return jsonResponse({ error: `webSearch.xSearch.${field} must be an ISO-8601 date (YYYY-MM-DD)` }, 400);
1209
+ }
1166
1210
  }
1211
+ const candidate = {
1212
+ ...(x.enabled === true ? { enabled: true } : {}),
1213
+ ...(x.allowedXHandles !== undefined ? { allowedXHandles: x.allowedXHandles as string[] } : {}),
1214
+ ...(x.excludedXHandles !== undefined ? { excludedXHandles: x.excludedXHandles as string[] } : {}),
1215
+ ...(x.fromDate !== undefined ? { fromDate: x.fromDate as string } : {}),
1216
+ ...(x.toDate !== undefined ? { toDate: x.toDate as string } : {}),
1217
+ };
1218
+ const invalid = validateXaiSearchOptions({
1219
+ xSearch: candidate.enabled,
1220
+ allowedXHandles: candidate.allowedXHandles,
1221
+ excludedXHandles: candidate.excludedXHandles,
1222
+ fromDate: candidate.fromDate,
1223
+ toDate: candidate.toDate,
1224
+ });
1225
+ if (invalid) return jsonResponse({ error: `webSearch.xSearch invalid: ${invalid}` }, 400);
1226
+ webSearchCandidate.xSearch = candidate;
1227
+ }
1228
+ if (typeof body.webSearch.streamRoutedModelOutput === "boolean") {
1229
+ // `false` is the default — drop the key so config files stay minimal.
1230
+ if (body.webSearch.streamRoutedModelOutput) webSearchCandidate.streamRoutedModelOutput = true;
1231
+ else delete webSearchCandidate.streamRoutedModelOutput;
1232
+ }
1233
+ if (typeof body.webSearch.enabled === "boolean") {
1234
+ // `true` is the default — drop the key so a disable/re-enable cycle does not rewrite the
1235
+ // file, exactly like the Vision master switch.
1236
+ if (body.webSearch.enabled) delete webSearchCandidate.enabled;
1237
+ else webSearchCandidate.enabled = false;
1167
1238
  }
1168
- const candidate = {
1169
- ...(x.enabled === true ? { enabled: true } : {}),
1170
- ...(x.allowedXHandles !== undefined ? { allowedXHandles: x.allowedXHandles as string[] } : {}),
1171
- ...(x.excludedXHandles !== undefined ? { excludedXHandles: x.excludedXHandles as string[] } : {}),
1172
- ...(x.fromDate !== undefined ? { fromDate: x.fromDate as string } : {}),
1173
- ...(x.toDate !== undefined ? { toDate: x.toDate as string } : {}),
1174
- };
1175
- const invalid = validateXaiSearchOptions({
1176
- xSearch: candidate.enabled,
1177
- allowedXHandles: candidate.allowedXHandles,
1178
- excludedXHandles: candidate.excludedXHandles,
1179
- fromDate: candidate.fromDate,
1180
- toDate: candidate.toDate,
1181
- });
1182
- if (invalid) return jsonResponse({ error: `webSearch.xSearch invalid: ${invalid}` }, 400);
1183
- webSearchCandidate.xSearch = candidate;
1184
- }
1185
- if (typeof body.webSearch.streamRoutedModelOutput === "boolean") {
1186
- // `false` is the default — drop the key so config files stay minimal.
1187
- if (body.webSearch.streamRoutedModelOutput) webSearchCandidate.streamRoutedModelOutput = true;
1188
- else delete webSearchCandidate.streamRoutedModelOutput;
1189
- }
1190
- if (typeof body.webSearch.enabled === "boolean") {
1191
- // `true` is the default — drop the key so a disable/re-enable cycle does not rewrite the
1192
- // file, exactly like the Vision master switch.
1193
- if (body.webSearch.enabled) delete webSearchCandidate.enabled;
1194
- else webSearchCandidate.enabled = false;
1195
- }
1196
- config.webSearchSidecar = webSearchCandidate;
1197
- }
1198
- if (body.vision) {
1199
- config.visionSidecar = { ...config.visionSidecar };
1200
- if (body.vision.anthropicInstance === null) delete config.visionSidecar.anthropicInstance;
1201
- else if (isAnthropicInstanceId(body.vision.anthropicInstance)) config.visionSidecar.anthropicInstance = body.vision.anthropicInstance;
1202
- if (typeof body.vision.model === "string") {
1203
- if (body.vision.model === "") delete config.visionSidecar.model;
1204
- else config.visionSidecar.model = body.vision.model;
1205
- }
1206
- if (body.vision.backend === null) delete config.visionSidecar.backend;
1207
- else if (body.vision.backend === "openai" || body.vision.backend === "anthropic"
1208
- || body.vision.backend === "routed") {
1209
- config.visionSidecar.backend = body.vision.backend;
1210
- }
1211
- if (typeof body.vision.maxDescriptionsPerTurn === "number") {
1212
- config.visionSidecar.maxDescriptionsPerTurn = body.vision.maxDescriptionsPerTurn;
1213
- }
1214
- if (typeof body.vision.enabled === "boolean") {
1215
- // `true` is the default — drop the key so disable/re-enable does not rewrite the file.
1216
- if (body.vision.enabled) delete config.visionSidecar.enabled;
1217
- else config.visionSidecar.enabled = false;
1218
- }
1219
- if (typeof body.vision.timeoutMs === "number") {
1220
- config.visionSidecar.timeoutMs = body.vision.timeoutMs;
1221
1239
  }
1222
- if (visionReasoningTouched) {
1223
- if (normalizedVisionReasoning === undefined) delete config.visionSidecar.reasoning;
1224
- else config.visionSidecar.reasoning = normalizedVisionReasoning;
1240
+ const visionCandidate = { ...config.visionSidecar };
1241
+ if (body.vision) {
1242
+ if (body.vision.anthropicInstance === null) delete visionCandidate.anthropicInstance;
1243
+ else if (isAnthropicInstanceId(body.vision.anthropicInstance)) visionCandidate.anthropicInstance = body.vision.anthropicInstance;
1244
+ if (typeof body.vision.model === "string") {
1245
+ if (body.vision.model === "") delete visionCandidate.model;
1246
+ else visionCandidate.model = body.vision.model;
1247
+ }
1248
+ if (body.vision.backend === null) delete visionCandidate.backend;
1249
+ else if (body.vision.backend === "openai" || body.vision.backend === "anthropic"
1250
+ || body.vision.backend === "routed") {
1251
+ visionCandidate.backend = body.vision.backend;
1252
+ }
1253
+ if (typeof body.vision.maxDescriptionsPerTurn === "number") {
1254
+ visionCandidate.maxDescriptionsPerTurn = body.vision.maxDescriptionsPerTurn;
1255
+ }
1256
+ if (typeof body.vision.enabled === "boolean") {
1257
+ // `true` is the default — drop the key so disable/re-enable does not rewrite the file.
1258
+ if (body.vision.enabled) delete visionCandidate.enabled;
1259
+ else visionCandidate.enabled = false;
1260
+ }
1261
+ if (typeof body.vision.timeoutMs === "number") {
1262
+ visionCandidate.timeoutMs = body.vision.timeoutMs;
1263
+ }
1264
+ if (visionReasoningTouched) {
1265
+ if (normalizedVisionReasoning === undefined) delete visionCandidate.reasoning;
1266
+ else visionCandidate.reasoning = normalizedVisionReasoning;
1267
+ }
1225
1268
  }
1226
- }
1227
- saveConfigPreservingClaudeCode(config);
1269
+
1270
+ if (webSearchCandidate) config.webSearchSidecar = webSearchCandidate;
1271
+ if (body.vision) config.visionSidecar = visionCandidate;
1272
+ saveConfigPreservingClaudeCode(config);
1273
+ return { visionEnabledChanged: visionEnabledBefore !== (config.visionSidecar?.enabled !== false),
1274
+ webSearchEnabledChanged: typeof body.webSearch?.enabled === "boolean" && webSearchEnabledBefore !== (config.webSearchSidecar?.enabled !== false) };
1275
+ });
1276
+ if (committed instanceof Response) return committed;
1228
1277
  // Publish the changed attachment affordance to both the managed catalog and Codex cache.
1229
1278
  // Use the existing bounded catalog-only path after persistence, outside the config lock.
1230
- const catalogRefresh = visionEnabledBefore !== (config.visionSidecar?.enabled !== false)
1279
+ const catalogRefresh = committed.visionEnabledChanged
1231
1280
  ? await convergeCodexCatalog()
1232
1281
  : undefined;
1233
1282
  // The sidecar's own switch is only half of what "off" means: Codex keeps declaring its native
@@ -1235,8 +1284,7 @@ export async function handleConfigRoutes(ctx: ManagementContext): Promise<Respon
1235
1284
  // is the one the model reaches for — which is why an MCP search server needs the client-side
1236
1285
  // key off too. The injection owns that root key, and a write that cannot happen is reported
1237
1286
  // (the Desktop switches' contract) instead of being stored as if it had.
1238
- const webSearchEnabledChanged = typeof body.webSearch?.enabled === "boolean"
1239
- && webSearchEnabledBefore !== (config.webSearchSidecar?.enabled !== false);
1287
+ const webSearchEnabledChanged = committed.webSearchEnabledChanged;
1240
1288
  const codexWebSearch: CodexDesktopSwitchApply = webSearchEnabledChanged
1241
1289
  ? await applyCodexConfigInjection(config)
1242
1290
  : { applied: false, reason: "not_requested", retryable: false };
@@ -1266,46 +1314,60 @@ export async function handleConfigRoutes(ctx: ManagementContext): Promise<Respon
1266
1314
  }
1267
1315
 
1268
1316
  if (url.pathname === "/api/shadow-call-settings" && req.method === "GET") {
1269
- const sci = config.shadowCallIntercept ?? {};
1270
- return jsonResponse({
1271
- enabled: sci.enabled === true,
1272
- model: sci.model ?? "",
1273
- sourceModels: shadowSourceModels(sci.sourceModels),
1274
- });
1317
+ return jsonResponse(shadowCallSettingsResponse(config));
1275
1318
  }
1276
1319
 
1277
1320
  if (url.pathname === "/api/shadow-call-settings" && req.method === "PUT") {
1278
1321
  let raw: unknown;
1279
1322
  try { raw = await readManagementJsonBody(req); } catch (error) { rethrowManagementBodyTooLarge(error); return jsonResponse({ error: "invalid JSON body" }, 400); }
1280
1323
  if (!isPlainRecord(raw)) return jsonResponse({ error: "body must be a JSON object" }, 400);
1281
- const body = raw as { enabled?: unknown; model?: unknown };
1324
+ const body = raw as { enabled?: unknown; model?: unknown; sourceModels?: unknown };
1282
1325
  if (body.enabled !== undefined && typeof body.enabled !== "boolean") {
1283
1326
  return jsonResponse({ error: "enabled must be a boolean" }, 400);
1284
1327
  }
1285
1328
  if (body.model !== undefined && typeof body.model !== "string") {
1286
1329
  return jsonResponse({ error: "model must be a string" }, 400);
1287
1330
  }
1288
- const candidateModel = typeof body.model === "string"
1289
- ? body.model
1290
- : body.enabled === true
1291
- ? config.shadowCallIntercept?.model
1292
- : undefined;
1293
- const targetError = shadowCallTargetError(config, candidateModel);
1294
- if (targetError) return jsonResponse({ error: targetError }, 400);
1295
- config.shadowCallIntercept = { ...config.shadowCallIntercept };
1296
- if (typeof body.enabled === "boolean") config.shadowCallIntercept.enabled = body.enabled;
1297
- if (typeof body.model === "string") {
1298
- if (body.model === "") delete config.shadowCallIntercept.model;
1299
- else config.shadowCallIntercept.model = body.model;
1300
- }
1301
- saveConfigPreservingClaudeCode(config);
1302
- const sci = config.shadowCallIntercept;
1303
- return jsonResponse({
1304
- ok: true,
1305
- enabled: sci.enabled === true,
1306
- model: sci.model ?? "",
1307
- sourceModels: shadowSourceModels(sci.sourceModels),
1331
+ const refusal = await settleConfigRoot(configRoot(), () => {
1332
+ const sourceModelsError = body.sourceModels === undefined ? null : shadowCallSourceModelsError(body.sourceModels);
1333
+ if (sourceModelsError) {
1334
+ return jsonResponse({ error: sourceModelsError, code: "shadow_call_source_invalid" }, 400);
1335
+ }
1336
+ const nextSourceModels = body.sourceModels === undefined
1337
+ ? undefined
1338
+ : normalizeShadowCallSourceModels(body.sourceModels as string[]);
1339
+ const candidateModel = typeof body.model === "string"
1340
+ ? body.model
1341
+ : body.enabled === true || body.sourceModels !== undefined
1342
+ ? config.shadowCallIntercept?.model
1343
+ : undefined;
1344
+ const targetError = shadowCallTargetError(config, candidateModel, nextSourceModels ?? config.shadowCallIntercept?.sourceModels);
1345
+ if (targetError) {
1346
+ return jsonResponse({ error: targetError, code: "shadow_call_target_invalid" }, 400);
1347
+ }
1348
+ const rollback = captureConfigTopLevelRollback(config, ["shadowCallIntercept"]);
1349
+ try {
1350
+ config.shadowCallIntercept = { ...config.shadowCallIntercept };
1351
+ if (typeof body.enabled === "boolean") config.shadowCallIntercept.enabled = body.enabled;
1352
+ if (typeof body.model === "string") {
1353
+ if (body.model === "") delete config.shadowCallIntercept.model;
1354
+ else config.shadowCallIntercept.model = body.model;
1355
+ }
1356
+ if (nextSourceModels) {
1357
+ // Drop a list that merely restates the built-in set, so future client
1358
+ // versions can move the defaults without pinning them here.
1359
+ if (isDefaultShadowSourceModels(nextSourceModels)) delete config.shadowCallIntercept.sourceModels;
1360
+ else config.shadowCallIntercept.sourceModels = nextSourceModels;
1361
+ }
1362
+ (deps.saveConfigPreservingClaudeCode ?? saveConfigPreservingClaudeCode)(config);
1363
+ } catch (error) {
1364
+ if (!(error instanceof ConfigWritePublishedError)) rollback();
1365
+ throw error;
1366
+ }
1367
+ return null;
1308
1368
  });
1369
+ if (refusal) return refusal;
1370
+ return jsonResponse({ ok: true, ...shadowCallSettingsResponse(config) });
1309
1371
  }
1310
1372
 
1311
1373
  if (url.pathname === "/api/auto-review-settings" && req.method === "GET") {
@@ -1320,24 +1382,26 @@ export async function handleConfigRoutes(ctx: ManagementContext): Promise<Respon
1320
1382
  const body = raw as { enabled?: unknown; model?: unknown };
1321
1383
  const shapeError = autoReviewOverrideConfigError(body, "body");
1322
1384
  if (shapeError) return jsonResponse({ error: shapeError }, 400);
1323
- const rollback = captureConfigTopLevelRollback(config, ["autoReviewOverride"]);
1324
- try {
1325
- config.autoReviewOverride = { ...config.autoReviewOverride };
1326
- if (typeof body.enabled === "boolean") config.autoReviewOverride.enabled = body.enabled;
1327
- if (typeof body.model === "string") {
1328
- const trimmed = body.model.trim();
1329
- if (trimmed === "") delete config.autoReviewOverride.model;
1330
- else config.autoReviewOverride.model = trimmed;
1385
+ await settleConfigRoot(configRoot(), () => {
1386
+ const rollback = captureConfigTopLevelRollback(config, ["autoReviewOverride"]);
1387
+ try {
1388
+ config.autoReviewOverride = { ...config.autoReviewOverride };
1389
+ if (typeof body.enabled === "boolean") config.autoReviewOverride.enabled = body.enabled;
1390
+ if (typeof body.model === "string") {
1391
+ const trimmed = body.model.trim();
1392
+ if (trimmed === "") delete config.autoReviewOverride.model;
1393
+ else config.autoReviewOverride.model = trimmed;
1394
+ }
1395
+ (deps.saveConfigPreservingClaudeCode ?? saveConfigPreservingClaudeCode)(config);
1396
+ } catch (error) {
1397
+ if (!(error instanceof ConfigWritePublishedError)) rollback();
1398
+ throw error;
1331
1399
  }
1332
- (deps.saveConfigPreservingClaudeCode ?? saveConfigPreservingClaudeCode)(config);
1333
- } catch (error) {
1334
- if (!(error instanceof ConfigWritePublishedError)) rollback();
1335
- throw error;
1336
- }
1400
+ });
1337
1401
  // The catalog carries the reviewer stamps, so the new selector has to reach it now; the
1338
1402
  // disposition travels in the body like every other catalog-affecting route.
1339
1403
  const catalogRefresh = await convergeCodexCatalog();
1340
- const override = config.autoReviewOverride;
1404
+ const override = config.autoReviewOverride ?? {};
1341
1405
  return jsonResponse({ ok: true, enabled: override.enabled === true, model: override.model ?? "", catalogRefresh });
1342
1406
  }
1343
1407
  return null;