@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,4 @@
1
+ import { hasHumanDashboardSession } from "./consent-session";
1
2
  /**
2
3
  * Management API for Anthropic OAuth usage-limit reset grants.
3
4
  *
@@ -182,7 +183,7 @@ async function handleRead(ctx: ManagementContext, deps: AnthropicResetGrantRoute
182
183
  }
183
184
 
184
185
  async function handleConsume(ctx: ManagementContext, injected?: AnthropicResetGrantRouteDeps): Promise<Response> {
185
- if (ctx.principal !== "gui-session") return fail(ctx, 403, "session_required");
186
+ if (!hasHumanDashboardSession(ctx)) return fail(ctx, 403, "session_required");
186
187
  let body: Record<string, unknown>;
187
188
  try {
188
189
  const parsed = await ctx.req.json() as unknown;
@@ -0,0 +1,211 @@
1
+ import type { OcxConfig, OcxClaudeCodeConfig } from "../../types";
2
+ import { isAnthropicInstanceId, type AnthropicInstanceId } from "../../providers/anthropic-instance-id";
3
+ import { jsonResponse } from "../auth-cors";
4
+
5
+ function isPlainObject(value: unknown): value is Record<string, unknown> {
6
+ return value !== null && typeof value === "object" && !Array.isArray(value)
7
+ && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
8
+ }
9
+
10
+ /** Validate request shape and build only a candidate; callers rebuild within admission before publishing. */
11
+ export function prepareClaudeCodePatch(config: OcxConfig, body: Record<string, unknown>) {
12
+ for (const field of ["webSearchSidecar", "visionSidecar"] as const) {
13
+ const section = body[field];
14
+ if (section === undefined || section === null) continue;
15
+ if (!isPlainObject(section)) return jsonResponse({ error: `${field} must be an object or null` }, 400);
16
+ if (section.enabled !== undefined && typeof section.enabled !== "boolean") {
17
+ return jsonResponse({ error: `${field}.enabled must be a boolean` }, 400);
18
+ }
19
+ // Both overrides now speak their full unions (roadmap 060 web, 170
20
+ // vision revised). Vision's third arm is "routed" (loopback through the
21
+ // proxy's own router), never exa: exa is not an LLM, and accepting an
22
+ // unknown literal would persist a backend the vision resolver reads as
23
+ // unset (review F1's failure mode).
24
+ const allowedBackends = field === "webSearchSidecar"
25
+ ? ["openai", "anthropic", "xai", "gemini", "exa"]
26
+ : ["openai", "anthropic", "routed"];
27
+ if (section.backend !== undefined && section.backend !== null
28
+ && !allowedBackends.includes(section.backend as string)) {
29
+ return jsonResponse({ error: `${field}.backend must be ${allowedBackends.join(", ")}, or null` }, 400);
30
+ }
31
+ if (section.model !== undefined && typeof section.model !== "string") {
32
+ return jsonResponse({ error: `${field}.model must be a string` }, 400);
33
+ }
34
+
35
+ }
36
+ const next = { ...(config.claudeCode ?? {}) };
37
+ for (const field of ["webSearchSidecar", "visionSidecar"] as const) {
38
+ const section = body[field];
39
+ if (section === undefined) continue;
40
+ if (section === null || Object.keys(section as Record<string, unknown>).length === 0) {
41
+ delete next[field];
42
+ continue;
43
+ }
44
+ // The per-field validation above guarantees vision only ever carries the two-member
45
+ // union; the cast is the loop's shared-shape compromise, not a wider write path.
46
+ const requested = section as { enabled?: boolean; backend?: "openai" | "anthropic" | "xai" | "gemini" | "exa" | null; model?: string; anthropicInstance?: AnthropicInstanceId | null };
47
+ const override = { ...next[field] } as NonNullable<OcxClaudeCodeConfig[typeof field]>;
48
+ if (requested.enabled !== undefined) override.enabled = requested.enabled;
49
+ if (requested.anthropicInstance === null) delete override.anthropicInstance;
50
+ else if (isAnthropicInstanceId(requested.anthropicInstance)) override.anthropicInstance = requested.anthropicInstance;
51
+ if (requested.backend === null) delete override.backend;
52
+ else if (requested.backend !== undefined) override.backend = requested.backend as never;
53
+ if (requested.model === "") delete override.model;
54
+ else if (requested.model !== undefined) override.model = requested.model;
55
+ // Indexed write across the field union collapses to an intersection; runtime
56
+ // validation above already guarantees the per-field shape.
57
+ if (Object.keys(override).length > 0) next[field] = override as never;
58
+ else delete next[field];
59
+ }
60
+ if (body.enabled !== undefined) {
61
+ if (typeof body.enabled !== "boolean") return jsonResponse({ error: "enabled must be a boolean" }, 400);
62
+ next.enabled = body.enabled;
63
+ }
64
+ if (body.authMode !== undefined) {
65
+ // Three-state intent: "proxy" and "subscription" are stored literally and stick
66
+ // forever; "auto" DELETES the key so the mode is resolved from detected Claude
67
+ // auth on every launch. The 260720 round-trip contract survives as a superset —
68
+ // storing "subscription" literally is also backward-safe, since older readers
69
+ // only ever recognised "proxy".
70
+ if (body.authMode !== "proxy" && body.authMode !== "subscription" && body.authMode !== "auto") {
71
+ return jsonResponse({ error: "authMode must be \"auto\", \"proxy\", or \"subscription\"" }, 400);
72
+ }
73
+ if (body.authMode === "auto") delete next.authMode;
74
+ else next.authMode = body.authMode;
75
+ }
76
+ if (body.systemEnv !== undefined) {
77
+ if (typeof body.systemEnv !== "boolean") return jsonResponse({ error: "systemEnv must be a boolean" }, 400);
78
+ next.systemEnv = body.systemEnv;
79
+ }
80
+ if (body.alwaysEnableEffort !== undefined) {
81
+ if (typeof body.alwaysEnableEffort !== "boolean") return jsonResponse({ error: "alwaysEnableEffort must be a boolean" }, 400);
82
+ if (body.alwaysEnableEffort) next.alwaysEnableEffort = true;
83
+ else delete next.alwaysEnableEffort;
84
+ }
85
+ if (body.maxContextTokens !== undefined) {
86
+ // CONFIG-ONLY back-compat (GUI control removed — superseded by auto-context):
87
+ // null clears; otherwise a positive integer (devlog 136 B6).
88
+ if (body.maxContextTokens === null) {
89
+ delete next.maxContextTokens;
90
+ } else if (typeof body.maxContextTokens !== "number" || !Number.isInteger(body.maxContextTokens) || body.maxContextTokens <= 0) {
91
+ return jsonResponse({ error: "maxContextTokens must be a positive integer or null" }, 400);
92
+ } else {
93
+ next.maxContextTokens = body.maxContextTokens;
94
+ }
95
+ }
96
+ if (body.autoContext !== undefined) {
97
+ // Default-on boolean (devlog 260712 020): true = drop the key, false = store.
98
+ if (typeof body.autoContext !== "boolean") return jsonResponse({ error: "autoContext must be a boolean" }, 400);
99
+ if (body.autoContext) delete next.autoContext;
100
+ else next.autoContext = false;
101
+ }
102
+ if (body.contextAccounting !== undefined) {
103
+ // Sparse like autoContext (devlog/_plan/261009_claude_1m_default/030): "1m" is the default
104
+ // and drops the key; "200k" is the only stored value.
105
+ if (body.contextAccounting !== "1m" && body.contextAccounting !== "200k") {
106
+ return jsonResponse({ error: "contextAccounting must be \"1m\" or \"200k\"" }, 400);
107
+ }
108
+ if (body.contextAccounting === "200k") next.contextAccounting = "200k";
109
+ else delete next.contextAccounting;
110
+ }
111
+ if (body.injectAgents !== undefined) {
112
+ // Default-on boolean (devlog 260712 070): true = drop the key, false = store.
113
+ if (typeof body.injectAgents !== "boolean") return jsonResponse({ error: "injectAgents must be a boolean" }, 400);
114
+ if (body.injectAgents) delete next.injectAgents;
115
+ else next.injectAgents = false;
116
+ }
117
+ if (body.autoCompactWindow !== undefined) {
118
+ // null resets to the 350k default; otherwise the binary-accepted range
119
+ // 100_000..1_000_000 (2.1.207 pSo/yDs — audit 021 #1).
120
+ if (body.autoCompactWindow === null) {
121
+ delete next.autoCompactWindow;
122
+ } else if (typeof body.autoCompactWindow !== "number" || !Number.isInteger(body.autoCompactWindow) || body.autoCompactWindow < 100_000 || body.autoCompactWindow > 1_000_000) {
123
+ return jsonResponse({ error: "autoCompactWindow must be an integer between 100000 and 1000000, or null" }, 400);
124
+ } else {
125
+ next.autoCompactWindow = body.autoCompactWindow;
126
+ }
127
+ }
128
+ if (body.blockedSkills !== undefined) {
129
+ // null resets to the default (["claude-api"]); an array (possibly empty = off)
130
+ // must contain non-empty strings (devlog 060).
131
+ if (body.blockedSkills === null) {
132
+ delete next.blockedSkills;
133
+ } else if (!Array.isArray(body.blockedSkills) || body.blockedSkills.some(s => typeof s !== "string" || s.trim() === "")) {
134
+ return jsonResponse({ error: "blockedSkills must be an array of non-empty strings, or null" }, 400);
135
+ } else {
136
+ next.blockedSkills = (body.blockedSkills as string[]).map(s => s.trim());
137
+ }
138
+ }
139
+ if (body.tierModels !== undefined) {
140
+ // Family defaults also serve third-party callers that request native tier aliases.
141
+ if (body.tierModels === null) {
142
+ delete next.tierModels;
143
+ } else if (!isPlainObject(body.tierModels)) {
144
+ return jsonResponse({ error: "tierModels must be an object with string values, or null" }, 400);
145
+ } else {
146
+ for (const [tier, value] of Object.entries(body.tierModels)) {
147
+ if (typeof value !== "string") return jsonResponse({ error: `tierModels.${tier} must be a string` }, 400);
148
+ }
149
+ const tierModels = body.tierModels as Record<string, string>;
150
+ const tiers: Record<string, string> = {};
151
+ for (const tier of ["opus", "sonnet", "haiku", "fable"] as const) {
152
+ const value = tierModels[tier];
153
+ if (value !== undefined && value.trim() !== "") tiers[tier] = value.trim();
154
+ }
155
+ if (Object.keys(tiers).length > 0) next.tierModels = tiers;
156
+ else delete next.tierModels;
157
+ }
158
+ }
159
+ let nextFastMode = config.fastMode;
160
+ if (body.fastMode !== undefined) {
161
+ if (body.fastMode !== true && body.fastMode !== false && body.fastMode !== null) {
162
+ return jsonResponse({ error: "fastMode must be true, false, or null" }, 400);
163
+ }
164
+ nextFastMode = body.fastMode === null ? undefined : body.fastMode;
165
+ }
166
+ for (const field of ["model", "smallFastModel", "classifierModel"] as const) {
167
+ const value = body[field];
168
+ if (value === undefined) continue;
169
+ if (typeof value !== "string") return jsonResponse({ error: `${field} must be a string` }, 400);
170
+ if (value.trim() === "") delete next[field];
171
+ else next[field] = value.trim();
172
+ }
173
+ if (body.classifierFallbacks !== undefined) {
174
+ if (body.classifierFallbacks === null) {
175
+ delete next.classifierFallbacks;
176
+ } else {
177
+ if (!Array.isArray(body.classifierFallbacks)) {
178
+ return jsonResponse({ error: "classifierFallbacks must be an array of strings, or null" }, 400);
179
+ }
180
+ const list: string[] = [];
181
+ for (const entry of body.classifierFallbacks) {
182
+ if (typeof entry !== "string" || entry.trim() === "") {
183
+ return jsonResponse({ error: "classifierFallbacks entries must be non-empty strings" }, 400);
184
+ }
185
+ list.push(entry.trim());
186
+ }
187
+ if (list.length > 0) next.classifierFallbacks = list;
188
+ else delete next.classifierFallbacks;
189
+ }
190
+ }
191
+ if (body.modelMap !== undefined) {
192
+ if (body.modelMap === null) {
193
+ delete next.modelMap;
194
+ } else {
195
+ if (!isPlainObject(body.modelMap)) {
196
+ return jsonResponse({ error: "modelMap must be an object of string->string, or null" }, 400);
197
+ }
198
+ const map: Record<string, string> = {};
199
+ for (const [k, v] of Object.entries(body.modelMap)) {
200
+ if (typeof v !== "string" || k.trim() === "" || v.trim() === "") {
201
+ return jsonResponse({ error: "modelMap entries must be non-empty strings" }, 400);
202
+ }
203
+ map[k.trim()] = v.trim();
204
+ }
205
+ if (Object.keys(map).length > 0) next.modelMap = map;
206
+ else delete next.modelMap;
207
+ }
208
+ }
209
+
210
+ return { next, nextFastMode };
211
+ }
@@ -0,0 +1,78 @@
1
+ import { adoptPersistedClaudeCode, deleteConfigTopLevelKey, mutatePersistedConfig } from "../../config";
2
+ import { getConfigDir as configRoot, withConfigDirHardeningSettled as settleConfigRoot } from "../../config/paths";
3
+ import type { OcxConfig } from "../../types";
4
+
5
+ /**
6
+ * Mirror a durable desired-state transition onto the long-lived server snapshot.
7
+ *
8
+ * `setIntegrationEnabled` writes DISK only. The server reuses one `config` object
9
+ * for every request, so leaving it stale makes the native GET report the opposite
10
+ * of what was just persisted, and makes any later whole-snapshot save (the Desktop
11
+ * profile PUT does exactly that) write the stale value back over the transition.
12
+ * ON is the ABSENCE of the key, matching `setIntegrationEnabled`'s on-disk shape.
13
+ */
14
+ export function mirrorDesiredEnabledOntoSnapshot(config: OcxConfig, client: "claude-desktop", enabled: boolean): void {
15
+ const integrations = { ...(config.clientIntegrations ?? {}) };
16
+ if (enabled) delete integrations[client];
17
+ else integrations[client] = false;
18
+ if (Object.keys(integrations).length === 0) deleteConfigTopLevelKey(config, "clientIntegrations");
19
+ else config.clientIntegrations = integrations;
20
+ }
21
+
22
+ /**
23
+ * Persist ONLY `claudeCode.desktopProfile`, field-scoped, against the CURRENT
24
+ * on-disk config.
25
+ *
26
+ * `saveConfigPreservingClaudeCode(ctx.config)` writes the whole long-lived server
27
+ * snapshot. On the apply path that snapshot still carries the `clientIntegrations`
28
+ * it was loaded with, so a save right after `setIntegrationEnabled("claude-desktop",
29
+ * true)` carried the stale OFF back over the enable and made the route cancel its
30
+ * own apply. Mutating one field under the config-mutation lock cannot regress an
31
+ * unrelated key another writer just committed.
32
+ */
33
+ export async function persistDesktopProfileField(
34
+ config: OcxConfig,
35
+ desktopProfile: NonNullable<OcxConfig["claudeCode"]>["desktopProfile"],
36
+ expectedProfile: NonNullable<OcxConfig["claudeCode"]>["desktopProfile"],
37
+ ): Promise<{ ok: true } | { ok: false; reason: "missing" | "invalid" | "conflict" | "unavailable" }> {
38
+ const outcome = await settleConfigRoot(configRoot(), () => {
39
+ const outcome = mutatePersistedConfig(persisted => {
40
+ if (JSON.stringify(persisted.claudeCode?.desktopProfile) !== JSON.stringify(expectedProfile)) {
41
+ return { changed: false, value: null };
42
+ }
43
+ persisted.claudeCode = { ...(persisted.claudeCode ?? {}), desktopProfile };
44
+ return { changed: true, value: structuredClone(persisted.claudeCode) };
45
+ });
46
+ if (outcome.status !== "unavailable" && outcome.value !== null) adoptPersistedClaudeCode(config, outcome.value);
47
+ return outcome;
48
+ }).catch(() => {
49
+ return { status: "unavailable", reason: "unavailable" } as const;
50
+ });
51
+ // Only mirror into memory once the durable write actually landed; an
52
+ // `unavailable` outcome must not leave the snapshot claiming a saved profile.
53
+ if (outcome.status === "unavailable") return { ok: false, reason: outcome.reason };
54
+ if (outcome.value === null) return { ok: false, reason: "conflict" };
55
+ return { ok: true };
56
+ }
57
+
58
+ export async function persistDesktopModeField(
59
+ config: OcxConfig,
60
+ desktopMode: "first-party" | "gateway",
61
+ ): Promise<{ ok: true } | { ok: false; reason: "missing" | "invalid" | "conflict" | "unavailable" }> {
62
+ const { recordClaudeDesktopMode } = await import("../../claude/desktop-first-party");
63
+ const outcome = await settleConfigRoot(configRoot(), () => {
64
+ const outcome = mutatePersistedConfig(persisted => {
65
+ const mutation = recordClaudeDesktopMode(persisted, desktopMode);
66
+ return { changed: mutation.changed, value: structuredClone(persisted.claudeCode) };
67
+ });
68
+ if (outcome.status !== "unavailable") adoptPersistedClaudeCode(config, outcome.value);
69
+ return outcome;
70
+ }).catch(() => {
71
+ return { status: "unavailable", reason: "unavailable" } as const;
72
+ });
73
+ if (outcome.status === "unavailable") return { ok: false, reason: outcome.reason };
74
+ // First-party apply ends here — no profile-marker write follows — so without
75
+ // adopting, live diverges from the armed baseline and a later whole-config
76
+ // save reads that divergence as a pending mutation and stomps hand edits.
77
+ return { ok: true };
78
+ }
@@ -22,11 +22,12 @@ function lazycodexNotDetected(ctx: ManagementContext): Response {
22
22
 
23
23
  export async function handleCodexAgentRoleRoutes(ctx: ManagementContext): Promise<Response | null> {
24
24
  const { req, url, config, deps } = ctx;
25
- const [{ getCodexHome }, roles, omo, { detectLazyCodex }] = await Promise.all([
25
+ const [{ getCodexHome }, roles, omo, { detectLazyCodex }, history] = await Promise.all([
26
26
  import("../../codex/paths"),
27
27
  import("../../codex/agent-role-models"),
28
28
  import("../../clients/omo-role-models"),
29
29
  import("../../clients/lazycodex"),
30
+ import("../../codex/role-model-history"),
30
31
  ]);
31
32
 
32
33
  if (url.pathname === "/api/codex-agent-roles" && req.method === "GET") {
@@ -35,6 +36,15 @@ export async function handleCodexAgentRoleRoutes(ctx: ManagementContext): Promis
35
36
  if (!lazycodex.detected) return jsonResponse({ lazycodex, omoJsonc: null, roles: [] }, 200, req, config);
36
37
  const omoState = omo.readOmoRoleModels(omo.omoJsoncPath());
37
38
  const omoModels = omoState.state === "present" ? omoState.models : {};
39
+ // History is optional: a file that cannot be read costs the Restore list, never role editing.
40
+ let changes: import("../../codex/role-model-history").RoleModelChange[] = [];
41
+ let historyUnavailable = false;
42
+ try {
43
+ changes = history.listRoleModelChanges(codexHome);
44
+ } catch (error) {
45
+ console.error(`[codex-agent-roles] could not read the change history: ${String(error)}`);
46
+ historyUnavailable = true;
47
+ }
38
48
  return jsonResponse({
39
49
  lazycodex,
40
50
  omoJsonc: { state: omoState.state },
@@ -43,6 +53,8 @@ export async function handleCodexAgentRoleRoutes(ctx: ManagementContext): Promis
43
53
  effort: roles.readCodexAgentRoleEffort(entry.role, codexHome),
44
54
  omoJsoncModel: omoModels[entry.role] ?? null,
45
55
  })),
56
+ history: changes,
57
+ ...(historyUnavailable ? { historyUnavailable } : {}),
46
58
  }, 200, req, config);
47
59
  }
48
60
 
@@ -88,7 +100,7 @@ export async function handleCodexAgentRoleRoutes(ctx: ManagementContext): Promis
88
100
  } catch {
89
101
  return jsonResponse({ error: "role must be URL-encoded", code: "invalid_role" }, 400, req, config);
90
102
  }
91
- let body: { model?: unknown; effort?: unknown };
103
+ let body: { model?: unknown; effort?: unknown; batch?: unknown; restores?: unknown };
92
104
  try {
93
105
  body = await readManagementJsonBody(req);
94
106
  } catch (error) {
@@ -102,12 +114,58 @@ export async function handleCodexAgentRoleRoutes(ctx: ManagementContext): Promis
102
114
  if (body?.model === undefined && body?.effort === undefined) {
103
115
  return jsonResponse({ error: "send a model, an effort, or both", code: "empty_update" }, 400, req, config);
104
116
  }
117
+ if (body.batch !== undefined && !history.isRoleHistoryBatch(body.batch)) {
118
+ return jsonResponse({ error: "batch must be 1 to 64 letters, digits or dashes", code: "invalid_batch" }, 400, req, config);
119
+ }
120
+ if (body.restores !== undefined && !history.isRoleHistoryBatch(body.restores)) {
121
+ return jsonResponse({ error: "restores must be 1 to 64 letters, digits or dashes", code: "invalid_restores" }, 400, req, config);
122
+ }
123
+ // A write without `batch` starts a batch and the response names it; a later write joins it only
124
+ // while it is this home's newest batch, up to the listing size. History is optional: a file that
125
+ // cannot be read does not block saves, and such a save is simply not recorded.
126
+ let slot: import("../../codex/role-model-history").BatchSlot | null = null;
127
+ try {
128
+ const claimed = history.claimBatchRow(codexHome, body.batch);
129
+ if (claimed === "batch_closed") {
130
+ return jsonResponse({ error: "this batch takes no more changes; leave batch out to start a new one", code: "batch_closed" }, 409, req, config);
131
+ }
132
+ if (claimed === "batch_full") {
133
+ return jsonResponse({ error: `a batch holds at most ${history.ROLE_HISTORY_LIMIT} changes`, code: "batch_full" }, 409, req, config);
134
+ }
135
+ slot = claimed;
136
+ } catch (error) {
137
+ console.error(`[codex-agent-roles] could not read the change history: ${String(error)}`);
138
+ }
105
139
  let model: string | undefined;
106
140
  let effort: string | null | undefined;
107
141
  let toml: { status: "written" | "unchanged" };
142
+ let before: import("../../codex/role-model-history").RoleSetting = { model: null, effort: null };
108
143
  try {
109
144
  model = body?.model === undefined ? undefined : roles.validateAgentRoleModel(body.model);
110
145
  effort = body?.effort === undefined ? undefined : body.effort === null ? null : roles.validateAgentRoleEffort(body.effort);
146
+ } catch (error) {
147
+ if (error instanceof roles.AgentRoleModelError) return jsonResponse({ error: error.message, code: error.code }, 400, req, config);
148
+ throw error;
149
+ }
150
+ // A Restore names the batch it puts back, and only this Codex home's history can vouch for it: the
151
+ // write must be that role's earliest `before` in the batch, so a stale page cannot carry models
152
+ // across homes. A role that had no model pin is restored without a model, since a save keeps a pin.
153
+ if (typeof body.restores === "string") {
154
+ let allowed: import("../../codex/role-model-history").RoleSetting | null;
155
+ try {
156
+ allowed = history.restorableSetting(codexHome, body.restores, role);
157
+ } catch {
158
+ allowed = null;
159
+ }
160
+ if (!allowed || model !== (allowed.model ?? undefined) || effort !== allowed.effort) {
161
+ return jsonResponse({ error: "this Codex home's change history has no such change to restore", code: "restore_not_in_history" }, 409, req, config);
162
+ }
163
+ }
164
+ try {
165
+ before = {
166
+ model: roles.listCodexAgentRoleModels(codexHome).find(entry => entry.role === role)?.model ?? null,
167
+ effort: roles.readCodexAgentRoleEffort(role, codexHome),
168
+ };
111
169
  toml = roles.writeCodexAgentRoleModel(role, model, codexHome, effort);
112
170
  } catch (error) {
113
171
  if (error instanceof roles.AgentRoleModelError) {
@@ -117,6 +175,24 @@ export async function handleCodexAgentRoleRoutes(ctx: ManagementContext): Promis
117
175
  // Filesystem and ownership errors carry absolute paths and UIDs; keep them out of the response.
118
176
  return jsonResponse({ error: "could not write the role file", code: "write_failed" }, 500, req, config);
119
177
  }
178
+ let recorded: string | undefined;
179
+ if (toml.status === "written" && slot) {
180
+ try {
181
+ history.recordRoleModelChange(codexHome, {
182
+ at: new Date().toISOString(),
183
+ batch: slot.batch,
184
+ n: slot.n,
185
+ role,
186
+ before,
187
+ after: { model: model ?? before.model, effort: effort === undefined ? before.effort : effort },
188
+ ...(typeof body.restores === "string" ? { restores: body.restores } : {}),
189
+ });
190
+ recorded = slot.batch;
191
+ } catch (error) {
192
+ // The write already stands; a lost history row only costs the Restore button for it.
193
+ console.error(`[codex-agent-roles] could not record the change: ${String(error)}`);
194
+ }
195
+ }
120
196
 
121
197
  // The role TOML is what Codex obeys, so its write stands even when the omo mirror cannot follow.
122
198
  let omoStatus: ReturnType<typeof omo.writeOmoRoleModel> | "write_failed";
@@ -133,5 +209,6 @@ export async function handleCodexAgentRoleRoutes(ctx: ManagementContext): Promis
133
209
  ...(effort !== undefined ? { effort } : {}),
134
210
  toml,
135
211
  omoJsonc: { status: omoStatus },
212
+ ...(recorded ? { batch: recorded } : {}),
136
213
  }, 200, req, config);
137
214
  }
@@ -0,0 +1,55 @@
1
+ import { admitCodexCliUpdateJob, readCodexCliUpdateJob, runCodexCliUpdateJob } from "../../codex/cli-update-job";
2
+ import { runCodexCliUpdateApplyInWorker, runCodexCliUpdatePlanInWorker } from "../../codex/cli-update-job-worker";
3
+ import { jsonResponse } from "../auth-cors";
4
+ import { trackBackgroundWork } from "../../lib/background-work";
5
+ import { readManagementJsonBody, rethrowManagementBodyTooLarge } from "./body";
6
+ import type { ManagementContext } from "./context";
7
+ import { hasHumanDashboardSession } from "./consent-session";
8
+
9
+ const STATUS = /^\/api\/codex\/cli-update\/jobs\/([0-9a-f-]{36})$/;
10
+
11
+ export async function handleCodexCliUpdateRoutes(ctx: ManagementContext): Promise<Response | null> {
12
+ if (ctx.url.pathname === "/api/codex/cli-update/plan") {
13
+ if (ctx.req.method !== "GET") return jsonResponse({ error: "method_not_allowed" }, 405, ctx.req, ctx.config);
14
+ try {
15
+ const plan = await runCodexCliUpdatePlanInWorker();
16
+ return jsonResponse(plan, 200, ctx.req, ctx.config);
17
+ } catch { return jsonResponse({ error: "plan_unavailable" }, 503, ctx.req, ctx.config); }
18
+ }
19
+ const match = STATUS.exec(ctx.url.pathname);
20
+ if (match && ctx.req.method === "GET") {
21
+ try {
22
+ const job = await readCodexCliUpdateJob(match[1]!);
23
+ return job ? jsonResponse(job, 200, ctx.req, ctx.config) : jsonResponse({ error: "job_not_found" }, 404, ctx.req, ctx.config);
24
+ } catch { return jsonResponse({ error: "job_state_unavailable" }, 503, ctx.req, ctx.config); }
25
+ }
26
+ if (ctx.url.pathname !== "/api/codex/cli-update/apply") return null;
27
+ if (ctx.req.method !== "POST") return jsonResponse({ error: "method_not_allowed" }, 405, ctx.req, ctx.config);
28
+ if (!hasHumanDashboardSession(ctx) || !ctx.trustedLoopbackIngress) {
29
+ return jsonResponse({ error: "local_dashboard_confirmation_required" }, 403, ctx.req, ctx.config);
30
+ }
31
+ let body: unknown;
32
+ try { body = await readManagementJsonBody(ctx.req); }
33
+ catch (error) { rethrowManagementBodyTooLarge(error); return jsonResponse({ error: "invalid_json" }, 400, ctx.req, ctx.config); }
34
+ if (!body || typeof body !== "object" || Array.isArray(body)) return jsonResponse({ error: "invalid_request" }, 400, ctx.req, ctx.config);
35
+ const value = body as Record<string, unknown>;
36
+ if (Object.keys(value).some(key => !["requestId", "planId", "confirmed"].includes(key))
37
+ || value.confirmed !== true || typeof value.requestId !== "string" || typeof value.planId !== "string") {
38
+ return jsonResponse({ error: "invalid_request" }, 400, ctx.req, ctx.config);
39
+ }
40
+ try {
41
+ const admitted = await admitCodexCliUpdateJob({ requestId: value.requestId, planId: value.planId, confirmed: true });
42
+ if (admitted.kind === "accepted") {
43
+ const work = runCodexCliUpdateJob(admitted.job.jobId, admitted.generation,
44
+ () => runCodexCliUpdateApplyInWorker(value.planId as string, { jobId: admitted.job.jobId }));
45
+ trackBackgroundWork(`codex-cli-update:${admitted.job.jobId}`, work).catch(() => undefined);
46
+ }
47
+ return jsonResponse({ job: admitted.job }, 202, ctx.req, ctx.config);
48
+ } catch (error) {
49
+ const code = error instanceof Error ? error.message : "admission_failed";
50
+ const status = code === "idempotency_conflict" ? 409 : code === "invalid_request" ? 400 : 503;
51
+ const response = jsonResponse({ error: ["invalid_request", "idempotency_conflict", "store_full", "job_store_busy", "unsupported_store", "unsafe_store"].includes(code) ? code : "admission_failed" }, status, ctx.req, ctx.config);
52
+ if (code === "job_store_busy") response.headers.set("Retry-After", "1");
53
+ return response;
54
+ }
55
+ }
@@ -1,3 +1,4 @@
1
+ import { hasHumanDashboardSession } from "./consent-session";
1
2
  /**
2
3
  * /api/codex-prompt — the Codex prompt-layer surface.
3
4
  *
@@ -303,7 +304,7 @@ export async function handleCodexPromptRoutes(ctx: ManagementContext): Promise<R
303
304
  //
304
305
  // Reads stay open to the admin token: describing the prompt stack changes nothing,
305
306
  // and the dashboard's own cold load needs it.
306
- if (req.method !== "GET" && req.method !== "HEAD" && ctx.principal !== "gui-session") {
307
+ if (req.method !== "GET" && req.method !== "HEAD" && !hasHumanDashboardSession(ctx)) {
307
308
  return fail(
308
309
  ctx,
309
310
  "dashboard_session_required",