@bitkyc08/opencodex 2.93.0-preview.20261027 → 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-DxToX1rV.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-CJZoq-uF.js +0 -58
  433. package/gui/dist/assets/Tray-BWQPcgZn.js +0 -1
  434. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
  435. package/gui/dist/assets/index-Xfct8owH.js +0 -94
@@ -1,4 +1,4 @@
1
- import { spawnSync, type SpawnSyncReturns } from "node:child_process";
1
+ import { execFile, type ExecFileException } from "node:child_process";
2
2
  import { createHash } from "node:crypto";
3
3
  import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
4
4
  import { tmpdir } from "node:os";
@@ -7,6 +7,12 @@ import { join, resolve } from "node:path";
7
7
  import { compareStrictSemver, parseStrictSemver } from "../lib/strict-semver";
8
8
  import { npmInvocation } from "../update/npm-invocation.mjs";
9
9
  import { CODEX_CLI_TRANSPORT_ENV_KEYS } from "../update/codex-cli-update-launch-policy.mjs";
10
+ import { CODEX_CLI_REGISTRY, isSha512Integrity, codexCliArtifactSetAsync, codexCliArtifactSetDigest, type CodexCliArtifactSet } from "./cli-update-artifacts";
11
+ export { CODEX_CLI_REGISTRY } from "./cli-update-artifacts";
12
+ import { windowsCodexCliPlanEvidence, windowsCodexCliToolchainDigest, withWindowsCodexCliPlanToolchain } from "./cli-windows-plan-provenance";
13
+ import { windowsCliApplyPrefixSupported } from "./cli-update-job-store-windows";
14
+ import { windowsInstallNamespaceSupported } from "./cli-update-windows-observation";
15
+ import { windowsNpmExecutionArgs } from "./windows-npm-execution";
10
16
  import {
11
17
  inspectCodexCliInstall,
12
18
  type CodexCliInstallKind,
@@ -14,7 +20,7 @@ import {
14
20
  type CodexCliInstallReport,
15
21
  } from "./cli-install-provenance";
16
22
  import {
17
- scanCodexSessionProcesses,
23
+ scanCodexSessionProcessesAsync,
18
24
  type CodexAppServerProcessIo,
19
25
  type CodexAppServerProcessScan,
20
26
  } from "./app-server-processes";
@@ -43,23 +49,12 @@ import {
43
49
  export const CODEX_CLI_PACKAGE = "@openai/codex";
44
50
  export const CODEX_CLI_UPDATE_SCHEMA_VERSION = 1 as const;
45
51
 
46
- /**
47
- * The one registry this workflow is allowed to resolve, pack and install from.
48
- *
49
- * npm view/pack inherit the operator's npm configuration by default, so a project or
50
- * user .npmrc — or an npm_config_* env var — can redirect "@openai/codex" to another
51
- * registry whose version query, integrity query and tarball all agree with each
52
- * other. Every npm call below pins this registry explicitly AND runs with the
53
- * registry-affecting configuration isolated, so the pinned origin is the only source
54
- * the evidence can come from.
55
- */
56
- export const CODEX_CLI_REGISTRY = "https://registry.npmjs.org";
57
-
58
52
  /** Only the stable channel is exposed; a moving dist-tag is resolved before it is used. */
59
53
  export type CodexCliUpdateChannel = "latest";
60
54
 
61
55
  export type CodexCliUpdateRefusal =
62
56
  | "windows_inspection_deferred"
57
+ | "windows_apply_disabled"
63
58
  | "not_managed"
64
59
  | "installed_version_unverified"
65
60
  | "install_content_unverified"
@@ -83,7 +78,7 @@ export interface CodexCliUpdateSession {
83
78
  }
84
79
 
85
80
  export type CodexCliUpdateTarget =
86
- | Readonly<{ kind: "resolved"; version: string; integrity: string }>
81
+ | Readonly<{ kind: "resolved"; version: string; integrity: string; artifacts?: CodexCliArtifactSet }>
87
82
  | Readonly<{ kind: "unresolved"; reason: string }>;
88
83
 
89
84
  export interface CodexCliUpdatePlan {
@@ -92,7 +87,7 @@ export interface CodexCliUpdatePlan {
92
87
  readonly channel: CodexCliUpdateChannel;
93
88
  readonly applicable: boolean;
94
89
  readonly refusal: CodexCliUpdateRefusal | null;
95
- /** Present only for an applicable plan; there is nothing to quote for a refusal. */
90
+ /** Also present for a proven Windows read-only plan whose apply remains disabled. */
96
91
  readonly planId: string | null;
97
92
  readonly provenance: CodexCliInstallKind;
98
93
  readonly managed: boolean;
@@ -101,6 +96,7 @@ export interface CodexCliUpdatePlan {
101
96
  readonly location: string | null;
102
97
  readonly targetVersion: string | null;
103
98
  readonly targetIntegrity: string | null;
99
+ readonly targetArtifacts?: CodexCliArtifactSet;
104
100
  readonly session: CodexCliUpdateSession;
105
101
  /**
106
102
  * The bounded content observation the installation report produced: digest of
@@ -119,25 +115,17 @@ export interface CodexCliUpdatePlanDeps {
119
115
  readonly platform?: NodeJS.Platform;
120
116
  readonly channel?: CodexCliUpdateChannel;
121
117
  readonly scanProcesses?: (io?: CodexAppServerProcessIo) => CodexAppServerProcessScan;
118
+ /** Preferred request-path seam: the real session scan runs its child processes async. */
119
+ readonly scanProcessesAsync?: (io?: CodexAppServerProcessIo) => Promise<CodexAppServerProcessScan>;
122
120
  readonly processIo?: CodexAppServerProcessIo;
123
- readonly resolveTarget?: (channel: CodexCliUpdateChannel) => CodexCliUpdateTarget;
124
- readonly spawnProcess?: typeof spawnSync;
121
+ readonly resolveTarget?: (channel: CodexCliUpdateChannel) => CodexCliUpdateTarget | Promise<CodexCliUpdateTarget>;
122
+ readonly spawnProcess?: CodexCliUpdateSpawn;
125
123
  }
126
124
 
127
125
 
128
126
  const PLAN_ID_LENGTH = 32;
129
127
  const PLAN_ID_RE = /^[0-9a-f]{32}$/;
130
128
  const REGISTRY_TIMEOUT_MS = 12_000;
131
- const SHA512_INTEGRITY_RE = /^sha512-[A-Za-z0-9+/]{86}==$/;
132
-
133
- function isSha512Integrity(token: string): boolean {
134
- if (!SHA512_INTEGRITY_RE.test(token)) return false;
135
- const encoded = token.slice("sha512-".length);
136
- // Base64 decoders accept truncated input and nonzero unused padding bits.
137
- // Require exactly 64 bytes and the canonical encoding of those same bytes.
138
- const digest = Buffer.from(encoded, "base64");
139
- return digest.byteLength === 64 && digest.toString("base64") === encoded;
140
- }
141
129
 
142
130
  /** The install argv this plan quotes for the operator to read, in argv form. */
143
131
  export function codexCliUpdateCommand(version: string): readonly string[] {
@@ -170,6 +158,8 @@ export function codexCliUpdatePlanId(bound: {
170
158
  readonly channel: CodexCliUpdateChannel;
171
159
  readonly targetVersion: string;
172
160
  readonly targetIntegrity: string;
161
+ readonly targetArtifactsDigest?: string;
162
+ readonly toolchainDigest?: string;
173
163
  }): string {
174
164
  // Ordered pairs, not object key order: the digest must not depend on how a caller
175
165
  // happened to build the record.
@@ -187,6 +177,8 @@ export function codexCliUpdatePlanId(bound: {
187
177
  ];
188
178
  const hash = createHash("sha256");
189
179
  for (const [key, value] of fields) hash.update(`${key}=${value}\n`);
180
+ if (bound.targetArtifactsDigest) hash.update(`targetArtifactsDigest=${bound.targetArtifactsDigest}\n`);
181
+ if (bound.toolchainDigest) hash.update(`toolchainDigest=${bound.toolchainDigest}\n`);
190
182
  return hash.digest("hex").slice(0, PLAN_ID_LENGTH);
191
183
  }
192
184
 
@@ -317,7 +309,7 @@ interface NpmConfigIsolation {
317
309
  * and the env filter removes the env-var channel. What remains is exactly the pinned
318
310
  * --registry flag plus proxy/CA values captured before project dotenv loading.
319
311
  */
320
- function createNpmConfigIsolation(dir?: string, boundEnv?: NodeJS.ProcessEnv): NpmConfigIsolation {
312
+ export function createNpmConfigIsolation(dir?: string, boundEnv?: NodeJS.ProcessEnv): NpmConfigIsolation {
321
313
  const ownsRoot = dir === undefined;
322
314
  const root = dir ?? mkdtempSync(join(tmpdir(), "ocx-codex-cli-meta-"));
323
315
  try {
@@ -330,6 +322,7 @@ function createNpmConfigIsolation(dir?: string, boundEnv?: NodeJS.ProcessEnv): N
330
322
  const env = codexCliUpdateBoundEnv(boundEnv);
331
323
  // npm enables Node's compile cache itself. Dropping the ambient output path
332
324
  // alone recreates <tmpdir>/node-compile-cache outside this owned lifetime.
325
+ // The version verification child inherits this same controlled path.
333
326
  env.NODE_COMPILE_CACHE = resolve(root, "node-compile-cache");
334
327
  return { dir: root, npmrc, globalNpmrc, cache, env };
335
328
  } catch (error) {
@@ -351,7 +344,7 @@ function isolatedNpmArgs(args: readonly string[], isolation: NpmConfigIsolation)
351
344
  ];
352
345
  }
353
346
 
354
- function isolatedNpmTarget(args: readonly string[], isolation: NpmConfigIsolation): NpmTarget | null {
347
+ export function isolatedNpmTarget(args: readonly string[], isolation: NpmConfigIsolation): NpmTarget | null {
355
348
  const target = npmTarget(isolatedNpmArgs(args, isolation), isolation.env);
356
349
  if (!target) return null;
357
350
  return {
@@ -361,6 +354,96 @@ function isolatedNpmTarget(args: readonly string[], isolation: NpmConfigIsolatio
361
354
  };
362
355
  }
363
356
 
357
+ /** The option fields one registry-metadata query passes to its spawn. */
358
+ export interface CodexCliUpdateSpawnOptions {
359
+ readonly encoding: "utf8";
360
+ readonly timeout: number;
361
+ readonly maxBuffer?: number;
362
+ readonly windowsHide: true;
363
+ readonly cwd?: string;
364
+ readonly env?: NodeJS.ProcessEnv;
365
+ readonly windowsVerbatimArguments?: boolean;
366
+ }
367
+
368
+ /** The fields a resolver reads off one spawn result; sync injections may carry more. */
369
+ export interface CodexCliUpdateSpawnResult {
370
+ readonly status: number | null;
371
+ readonly stdout: string;
372
+ }
373
+
374
+ /**
375
+ * One registry-metadata invocation. The production runner is asynchronous so a slow
376
+ * npm cannot park the proxy event loop; a synchronous SpawnSync-shaped injection
377
+ * remains assignable, so tests asserting argv/env without real I/O are unchanged.
378
+ */
379
+ export type CodexCliUpdateSpawn = (
380
+ bin: string,
381
+ args: readonly string[],
382
+ options: CodexCliUpdateSpawnOptions,
383
+ ) => CodexCliUpdateSpawnResult | Promise<CodexCliUpdateSpawnResult>;
384
+
385
+ /**
386
+ * A single bounded registry child whose wait happens off the event loop.
387
+ *
388
+ * The previous spawnSync blocked the whole proxy for up to the per-query deadline:
389
+ * a slow registry stalled unrelated requests and streaming for seconds at a time,
390
+ * and the background apply repeated the same stall. The observable contract is
391
+ * unchanged — status null on timeout or spawn failure, stdout bounded by
392
+ * maxBuffer — but only the awaited caller observes the child.
393
+ */
394
+ export function spawnCodexCliUpdateMetadata(
395
+ bin: string,
396
+ args: readonly string[],
397
+ options: CodexCliUpdateSpawnOptions,
398
+ ): Promise<CodexCliUpdateSpawnResult> {
399
+ return new Promise(resolve => {
400
+ let timedOut = false;
401
+ let deadline: ReturnType<typeof setTimeout> | undefined;
402
+ let child: ReturnType<typeof execFile>;
403
+ try {
404
+ // execFile's callback is the only terminal observation: it runs after the
405
+ // child terminated and its piped stdio was fully consumed, so this result —
406
+ // and the caller's isolation cleanup in its finally — never outrun a live
407
+ // child, and no arbitrary reap window can fake completion. encoding "utf8"
408
+ // decodes the buffered output once, so a multibyte character split across
409
+ // OS pipe chunks stays intact, while maxBuffer bounds both captured
410
+ // streams in bytes exactly like spawnSync did. This proves only the
411
+ // child's own termination; any descendants it left behind are outside the
412
+ // observation, as they were under spawnSync.
413
+ child = execFile(bin, [...args], {
414
+ encoding: "utf8",
415
+ timeout: options.timeout,
416
+ maxBuffer: options.maxBuffer ?? 1024 * 1024,
417
+ killSignal: "SIGKILL",
418
+ windowsHide: true,
419
+ cwd: options.cwd,
420
+ env: options.env,
421
+ windowsVerbatimArguments: options.windowsVerbatimArguments ?? false,
422
+ }, (error: ExecFileException | null, stdout: string) => {
423
+ if (deadline) clearTimeout(deadline);
424
+ // spawnSync reported status null whenever the child was signal-killed
425
+ // (timeout or maxBuffer) or never spawned; a numeric error.code is the
426
+ // plain exit code. timedOut is latched so a late code-0 close after the
427
+ // deadline still refuses, matching the synchronous timeout lane.
428
+ const status = timedOut ? null
429
+ : error === null ? 0
430
+ : typeof error.code === "number" ? error.code : null;
431
+ resolve(Object.freeze({ status, stdout }));
432
+ });
433
+ } catch {
434
+ resolve(Object.freeze({ status: null, stdout: "" }));
435
+ return;
436
+ }
437
+ // A deadline of our own keeps the same per-query bound even on a runtime
438
+ // that does not honor execFile's timeout option. It only latches the
439
+ // refusal and signals the child; resolution still waits for the callback.
440
+ deadline = setTimeout(() => {
441
+ timedOut = true;
442
+ try { child.kill("SIGKILL"); } catch { /* the close event still settles */ }
443
+ }, options.timeout);
444
+ });
445
+ }
446
+
364
447
  /**
365
448
  * Resolve the channel to one exact version plus its sha512 integrity token.
366
449
  *
@@ -369,12 +452,12 @@ function isolatedNpmTarget(args: readonly string[], isolation: NpmConfigIsolatio
369
452
  * acceptable for a foreign package we are about to install on the operator's behalf, so
370
453
  * every failure lane here is a refusal.
371
454
  */
372
- export function resolveCodexCliUpdateTarget(
455
+ export async function resolveCodexCliUpdateTarget(
373
456
  channel: CodexCliUpdateChannel,
374
- spawn: typeof spawnSync = spawnSync,
457
+ spawn: CodexCliUpdateSpawn = spawnCodexCliUpdateMetadata,
375
458
  /** Proof-bound pre-dotenv PATH/PATHEXT and proxy/CA env; absent settings stay absent. */
376
459
  boundEnv?: NodeJS.ProcessEnv,
377
- ): CodexCliUpdateTarget {
460
+ ): Promise<CodexCliUpdateTarget> {
378
461
  // The pinned registry and the isolation directory together are the boundary: the
379
462
  // version, the integrity token and the tarball URL all come from npmjs or the
380
463
  // target is unresolved — a redirected answer can never be the evidence.
@@ -387,7 +470,7 @@ export function resolveCodexCliUpdateTarget(
387
470
  return Object.freeze({ kind: "unresolved" as const, reason: "npm configuration isolation setup failed" });
388
471
  }
389
472
  try {
390
- const runView = (field: string, spec: string): SpawnSyncReturns<string> | null => {
473
+ const runView = async (field: string, spec: string): Promise<CodexCliUpdateSpawnResult | null> => {
391
474
  const target = isolatedNpmTarget(["view", spec, field], isolation);
392
475
  if (!target) return null;
393
476
  return spawn(target.bin, target.args, {
@@ -398,7 +481,7 @@ export function resolveCodexCliUpdateTarget(
398
481
  });
399
482
  };
400
483
 
401
- const versionRun = runView("version", `${CODEX_CLI_PACKAGE}@${channel}`);
484
+ const versionRun = await runView("version", `${CODEX_CLI_PACKAGE}@${channel}`);
402
485
  if (!versionRun) return Object.freeze({ kind: "unresolved" as const, reason: "npm executable was not found on a trusted PATH entry" });
403
486
  // status === null covers a timeout as well as a spawn failure.
404
487
  if (versionRun.status !== 0) {
@@ -409,7 +492,7 @@ export function resolveCodexCliUpdateTarget(
409
492
  return Object.freeze({ kind: "unresolved" as const, reason: "registry returned no exact version" });
410
493
  }
411
494
 
412
- const integrityRun = runView("dist.integrity", `${CODEX_CLI_PACKAGE}@${version}`);
495
+ const integrityRun = await runView("dist.integrity", `${CODEX_CLI_PACKAGE}@${version}`);
413
496
  if (!integrityRun) return Object.freeze({ kind: "unresolved" as const, reason: "npm executable was not found on a trusted PATH entry" });
414
497
  if (integrityRun.status !== 0) {
415
498
  return Object.freeze({ kind: "unresolved" as const, reason: `registry integrity query failed (status ${integrityRun.status ?? "timeout"})` });
@@ -424,7 +507,7 @@ export function resolveCodexCliUpdateTarget(
424
507
  // The digest binds the tarball's CONTENT; this binds its ORIGIN. A registry
425
508
  // answer whose tarball lives outside the pinned registry is not the artifact
426
509
  // the plan approved, even if its sha512 matched.
427
- const tarballRun = runView("dist.tarball", `${CODEX_CLI_PACKAGE}@${version}`);
510
+ const tarballRun = await runView("dist.tarball", `${CODEX_CLI_PACKAGE}@${version}`);
428
511
  if (!tarballRun) return Object.freeze({ kind: "unresolved" as const, reason: "npm executable was not found on a trusted PATH entry" });
429
512
  if (tarballRun.status !== 0) {
430
513
  return Object.freeze({ kind: "unresolved" as const, reason: `registry tarball query failed (status ${tarballRun.status ?? "timeout"})` });
@@ -447,6 +530,39 @@ export function resolveCodexCliUpdateTarget(
447
530
  }
448
531
  }
449
532
 
533
+ /** Resolve both exact archives, including the publisher's platform-package alias. */
534
+ export async function resolveCodexCliUpdateArtifactTarget(channel: CodexCliUpdateChannel,
535
+ spawn: CodexCliUpdateSpawn = spawnCodexCliUpdateMetadata, boundEnv?: NodeJS.ProcessEnv,
536
+ platform: NodeJS.Platform = process.platform, arch: string = process.arch,
537
+ windowsToolchain?: { readonly node: string; readonly npmCli: string }): Promise<CodexCliUpdateTarget> {
538
+ let isolation: NpmConfigIsolation | undefined;
539
+ try {
540
+ isolation = createNpmConfigIsolation(undefined, boundEnv);
541
+ const query = async (spec: string) => {
542
+ const args = isolatedNpmArgs(["view", spec, "--json"], isolation!);
543
+ const invocation = windowsToolchain
544
+ ? { bin: windowsToolchain.node, args: windowsNpmExecutionArgs(windowsToolchain.npmCli, args), options: { cwd: isolation!.dir, env: isolation!.env } }
545
+ : isolatedNpmTarget(["view", spec, "--json"], isolation!);
546
+ if (!invocation) throw new Error("npm unavailable");
547
+ const result = await spawn(invocation.bin, invocation.args, { encoding: "utf8", timeout: REGISTRY_TIMEOUT_MS,
548
+ maxBuffer: 1024 * 1024, windowsHide: true, ...invocation.options });
549
+ if (result.status !== 0) throw new Error("registry query failed");
550
+ return JSON.parse(result.stdout);
551
+ };
552
+ const latest = await query(`${CODEX_CLI_PACKAGE}@${channel}`);
553
+ if (!parseStrictSemver(latest.version)) throw new Error("target version unavailable");
554
+ const pinned = await query(`${CODEX_CLI_PACKAGE}@${latest.version}`);
555
+ if (pinned.version !== latest.version) throw new Error("target version drift");
556
+ const artifacts = await codexCliArtifactSetAsync(pinned, query, platform, arch);
557
+ return Object.freeze({ kind: "resolved", version: artifacts.main.version,
558
+ integrity: artifacts.main.integrity, artifacts });
559
+ } catch {
560
+ return Object.freeze({ kind: "unresolved", reason: "main/platform artifact metadata unverified" });
561
+ } finally {
562
+ if (isolation) { try { rmSync(isolation.dir, { recursive: true }); } catch { /* owned metadata residue */ } }
563
+ }
564
+ }
565
+
450
566
  function refusedPlan(
451
567
  refusal: CodexCliUpdateRefusal,
452
568
  report: CodexCliInstallReport,
@@ -494,11 +610,10 @@ export async function createCodexCliUpdatePlan(deps: CodexCliUpdatePlanDeps = {}
494
610
  // pays the bounded content read; a bare ownership check leaves it unobserved.
495
611
  const report = await inspect({ ...(deps.inspectionDeps ?? {}), observeInstallContent: true });
496
612
 
497
- // Phase 1 performs no candidate filesystem I/O at all on Windows, so there is no
498
- // ownership evidence to build a plan on. This stays dormant until the handle-bound
499
- // provenance layer exists; pretending otherwise would require exactly the reads phase 1
500
- // refused to perform.
501
- if (platform === "win32" || report.reason === "windows_inspection_deferred") {
613
+ // Windows planning requires private evidence from the production handle-bound
614
+ // predicate. A synthetic/copyable public managed flag cannot open this lane.
615
+ const windowsEvidence = windowsCodexCliPlanEvidence(report);
616
+ if ((platform === "win32" && !windowsEvidence) || report.reason === "windows_inspection_deferred") {
502
617
  return refusedPlan("windows_inspection_deferred", report, channel, null, NOT_EVALUATED);
503
618
  }
504
619
  if (!report.managed || report.provenance !== "npm-global") {
@@ -525,8 +640,12 @@ export async function createCodexCliUpdatePlan(deps: CodexCliUpdatePlanDeps = {}
525
640
  // When the caller had no trusted snapshot, inspectionDeps.env is the fail-closed
526
641
  // { PATH: "" } form, so this resolution cannot silently fall back to ambient.
527
642
  const resolveTarget = deps.resolveTarget
528
- ?? (ch => resolveCodexCliUpdateTarget(ch, deps.spawnProcess ?? spawnSync, deps.inspectionDeps?.env));
529
- const target = resolveTarget(channel);
643
+ ?? (ch => resolveCodexCliUpdateArtifactTarget(ch, deps.spawnProcess ?? spawnCodexCliUpdateMetadata, deps.inspectionDeps?.env,
644
+ platform, windowsEvidence?.arch ?? deps.inspectionDeps?.arch ?? process.arch, windowsEvidence ?? undefined));
645
+ const target = windowsEvidence
646
+ ? await withWindowsCodexCliPlanToolchain(report, () => resolveTarget(channel))
647
+ ?? Object.freeze({ kind: "unresolved" as const, reason: "Windows toolchain identity changed" })
648
+ : await resolveTarget(channel);
530
649
  if (target.kind !== "resolved") {
531
650
  return refusedPlan("target_unresolved", report, channel, target, NOT_EVALUATED);
532
651
  }
@@ -545,7 +664,13 @@ export async function createCodexCliUpdatePlan(deps: CodexCliUpdatePlanDeps = {}
545
664
  return refusedPlan("target_not_newer", report, channel, target, NOT_EVALUATED);
546
665
  }
547
666
 
548
- const scan = (deps.scanProcesses ?? scanCodexSessionProcesses)(deps.processIo ?? {});
667
+ // The request-path scan keeps registry and process-table waits off the event loop;
668
+ // a synchronous injection remains honored for tests that never spawn a real child.
669
+ const scan = deps.scanProcessesAsync
670
+ ? await deps.scanProcessesAsync(deps.processIo ?? {})
671
+ : deps.scanProcesses
672
+ ? deps.scanProcesses(deps.processIo ?? {})
673
+ : await scanCodexSessionProcessesAsync(deps.processIo ?? {});
549
674
  if (scan.kind !== "observed") {
550
675
  // An unreadable process table is not "no sessions". `listCodexAppServerProcesses`
551
676
  // maps that failure to an empty list because its kill contract must never signal a
@@ -557,12 +682,17 @@ export async function createCodexCliUpdatePlan(deps: CodexCliUpdatePlanDeps = {}
557
682
  return refusedPlan("blocked_active_session", report, channel, target, Object.freeze({ state: "active" as const, matches }));
558
683
  }
559
684
 
685
+ const applicable = platform !== "win32" || (!!windowsEvidence && windowsEvidence.arch === "x64"
686
+ && target.artifacts?.platform === "win32" && target.artifacts.arch === "x64"
687
+ && process.platform === "win32" && process.arch === "x64"
688
+ && windowsInstallNamespaceSupported(windowsEvidence.prefix)
689
+ && await windowsCliApplyPrefixSupported(windowsEvidence.prefix));
560
690
  return Object.freeze({
561
691
  schemaVersion: CODEX_CLI_UPDATE_SCHEMA_VERSION,
562
692
  package: CODEX_CLI_PACKAGE,
563
693
  channel,
564
- applicable: true,
565
- refusal: null,
694
+ applicable,
695
+ refusal: applicable ? null : "windows_apply_disabled",
566
696
  planId: codexCliUpdatePlanId({
567
697
  platform,
568
698
  provenance: report.provenance,
@@ -572,6 +702,8 @@ export async function createCodexCliUpdatePlan(deps: CodexCliUpdatePlanDeps = {}
572
702
  channel,
573
703
  targetVersion: target.version,
574
704
  targetIntegrity: target.integrity,
705
+ targetArtifactsDigest: target.artifacts ? codexCliArtifactSetDigest(target.artifacts) : undefined,
706
+ toolchainDigest: windowsCodexCliToolchainDigest(report),
575
707
  }),
576
708
  provenance: report.provenance,
577
709
  managed: report.managed,
@@ -580,6 +712,7 @@ export async function createCodexCliUpdatePlan(deps: CodexCliUpdatePlanDeps = {}
580
712
  location: report.location,
581
713
  targetVersion: target.version,
582
714
  targetIntegrity: target.integrity,
715
+ ...(target.artifacts ? { targetArtifacts: target.artifacts } : {}),
583
716
  session: Object.freeze({ state: "none" as const, matches: 0 }),
584
717
  installContentDigest: report.installContentDigest,
585
718
  command: codexCliUpdateCommand(target.version),
@@ -0,0 +1,236 @@
1
+ import { closeSync, constants, fstatSync, fsyncSync, ftruncateSync, lstatSync, mkdirSync, openSync,
2
+ readFileSync, readdirSync, realpathSync, renameSync, writeFileSync } from "node:fs";
3
+ import { dirname, join } from "node:path";
4
+ import { getConfigDir } from "../config/paths";
5
+ import { assertTrustedCodexCliAncestry } from "./cli-update-paths";
6
+ import { withWindowsCliRecoveryStore } from "./cli-update-job-store-windows";
7
+ import { windowsCodexCliChildGone } from "./windows-cli-recovery";
8
+
9
+ export interface CodexCliUpdateNativeChildIdentity { jobName: string; creationTime: string }
10
+ export interface CodexCliUpdateNativeRecoveryProof { path: string; terminal: string }
11
+
12
+ interface RecoveryRecord {
13
+ version: 1; token: string; parentPid: number;
14
+ phase: "armed" | "child" | "terminal"; pgid: number | null;
15
+ windows?: { jobName: string | null; creationTime: string | null };
16
+ }
17
+ /** ESRCH on the entire owned group is proof; EPERM and PID-only death are not. */
18
+ export function codexCliUpdateGroupGone(pgid: number): boolean {
19
+ if (process.platform === "win32" || !Number.isSafeInteger(pgid) || pgid <= 0) return false;
20
+ try { process.kill(-pgid, 0); return false; }
21
+ catch (error) { return (error as NodeJS.ErrnoException).code === "ESRCH"; }
22
+ }
23
+ function processGone(pid: number): boolean {
24
+ try { process.kill(pid, 0); return false; }
25
+ catch (error) { return (error as NodeJS.ErrnoException).code === "ESRCH"; }
26
+ }
27
+ function syncDirectory(dir: string): void {
28
+ const fd = openSync(dir, constants.O_RDONLY);
29
+ try { fsyncSync(fd); } finally { closeSync(fd); }
30
+ }
31
+ function directory(configDir: string, create: boolean): string {
32
+ if (process.platform === "win32") return withWindowsCliRecoveryStore(configDir, create, io => io.dir);
33
+ assertTrustedCodexCliAncestry(configDir);
34
+ const dir = join(configDir, "codex-cli-update-recovery");
35
+ if (create) {
36
+ try { mkdirSync(dir, { mode: 0o700 }); }
37
+ catch (error) { if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error; }
38
+ }
39
+ const stat = lstatSync(dir);
40
+ if (!stat.isDirectory() || stat.isSymbolicLink() || stat.uid !== process.geteuid?.()
41
+ || (stat.mode & 0o077) !== 0 || realpathSync.native(dir) !== dir) throw new Error("unsafe_recovery_store");
42
+ // Persist the store's directory entry too, including a concurrent creator.
43
+ if (create) syncDirectory(configDir);
44
+ return dir;
45
+ }
46
+ function read(dir: string, token: string, suffix = ".json"): RecoveryRecord {
47
+ if (!/^[0-9a-f-]{36}$/.test(token)) throw new Error("invalid_recovery_owner");
48
+ if (process.platform === "win32") {
49
+ const record = withWindowsCliRecoveryStore(dirname(dir), false, io => JSON.parse(io.read(token + suffix))) as RecoveryRecord;
50
+ if (!validRecord(record, token)) throw new Error("invalid_recovery_owner");
51
+ return record;
52
+ }
53
+ const path = join(dir, token + suffix);
54
+ const fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
55
+ try {
56
+ const stat = fstatSync(fd), lexical = lstatSync(path);
57
+ if (!stat.isFile() || stat.size > 1024 || stat.nlink !== 1 || stat.uid !== process.geteuid?.()
58
+ || (stat.mode & 0o077) !== 0 || lexical.isSymbolicLink() || lexical.dev !== stat.dev || lexical.ino !== stat.ino) {
59
+ throw new Error("unsafe_recovery_store");
60
+ }
61
+ const record = JSON.parse(readFileSync(fd, "utf8")) as RecoveryRecord;
62
+ if (!validRecord(record, token)) throw new Error("invalid_recovery_owner");
63
+ return record;
64
+ } finally { closeSync(fd); }
65
+ }
66
+ function validRecord(record: RecoveryRecord, token: string): boolean {
67
+ return !!record && record.version === 1 && record.token === token && Number.isSafeInteger(record.parentPid) && record.parentPid > 0
68
+ && ["armed", "child", "terminal"].includes(record.phase)
69
+ && (record.pgid === null || (Number.isSafeInteger(record.pgid) && record.pgid > 0))
70
+ && (record.windows === undefined || (!!record.windows
71
+ && (record.windows.jobName === null || (typeof record.windows.jobName === "string" && /^Global\\ocx-cli-[0-9a-f-]{36}$/.test(record.windows.jobName)))
72
+ && (record.windows.creationTime === null || (typeof record.windows.creationTime === "string" && /^[1-9][0-9]{0,19}$/.test(record.windows.creationTime)))));
73
+ }
74
+ function childGone(record: RecoveryRecord, proof?: (token: string) => RecoveryRecord): boolean {
75
+ if (record.pgid === null) return false;
76
+ if (process.platform !== "win32") return codexCliUpdateGroupGone(record.pgid);
77
+ if (!record.windows?.jobName || !record.windows.creationTime || !proof) return false;
78
+ const terminal = proof(record.token);
79
+ return terminal.phase === "terminal" && terminal.pgid === null && terminal.parentPid === record.parentPid
80
+ && terminal.windows?.jobName === record.windows.jobName
81
+ && windowsCodexCliChildGone(record.pgid, record.windows.creationTime, record.windows.jobName);
82
+ }
83
+ /** Called only after this generation's fence was sealed against another spawn. */
84
+ export function closedWindowsCodexCliUpdateChildGone(token: string, configDir = getConfigDir(), expectedPid?: number): boolean {
85
+ try { const dir = directory(configDir, false), record = read(dir, token);
86
+ return record.phase === "child" && record.pgid === expectedPid && childGone(record, token => read(dir, token, ".proof")); }
87
+ catch { return false; }
88
+ }
89
+ function pending(path: string): number {
90
+ const fd = openSync(path, constants.O_WRONLY | constants.O_CREAT | constants.O_NOFOLLOW | constants.O_NONBLOCK, 0o600);
91
+ try {
92
+ const stat = fstatSync(fd), lexical = lstatSync(path);
93
+ if (!stat.isFile() || stat.nlink !== 1 || stat.uid !== process.geteuid?.() || (stat.mode & 0o077) !== 0
94
+ || lexical.isSymbolicLink() || lexical.dev !== stat.dev || lexical.ino !== stat.ino) throw new Error("unsafe_recovery_store");
95
+ ftruncateSync(fd, 0); return fd;
96
+ } catch (error) { closeSync(fd); throw error; }
97
+ }
98
+ function write(dir: string, record: RecoveryRecord): void {
99
+ if (process.platform === "win32") {
100
+ withWindowsCliRecoveryStore(dirname(dir), true, io => io.write(record.token + ".json", record.token + ".pending", JSON.stringify(record)));
101
+ return;
102
+ }
103
+ const temp = join(dir, record.token + ".pending");
104
+ const fd = pending(temp);
105
+ try { writeFileSync(fd, JSON.stringify(record)); fsyncSync(fd); } finally { closeSync(fd); }
106
+ renameSync(temp, join(dir, record.token + ".json"));
107
+ syncDirectory(dir);
108
+ }
109
+ /** Written before COMMITTED; a crash in the spawn/publication gap stays armed. */
110
+ export function createCodexCliUpdateRecovery(token: string, configDir = getConfigDir()) {
111
+ let dir: string | undefined;
112
+ let record: RecoveryRecord = { version: 1, token, parentPid: process.pid, phase: "armed", pgid: null };
113
+ return {
114
+ arm(jobName?: string): CodexCliUpdateNativeRecoveryProof | undefined {
115
+ dir ??= directory(configDir, true);
116
+ try {
117
+ if (read(dir, token, ".terminal").phase !== "terminal") throw new Error("invalid_recovery_owner");
118
+ return; // Parent recovery already ended this exact token.
119
+ } catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; }
120
+ record = { ...record, phase: "armed", pgid: null,
121
+ ...(process.platform === "win32" ? { windows: { jobName: jobName ?? null, creationTime: null } } : {}) }; write(dir, record);
122
+ if (process.platform === "win32" && jobName) {
123
+ withWindowsCliRecoveryStore(configDir, true, io => io.write(token + ".proof", token + ".proof.pending", JSON.stringify(record)));
124
+ return { path: join(dir, token + ".proof"), terminal: JSON.stringify({ ...record, phase: "terminal" }) };
125
+ }
126
+ },
127
+ child(pgid: number, identity?: CodexCliUpdateNativeChildIdentity) {
128
+ if (dir) { record = { ...record, phase: "child", pgid, ...(identity ? { windows: identity } : {}) }; write(dir, record); }
129
+ },
130
+ terminal() { if (dir) { record = { ...record, phase: "terminal", pgid: null }; write(dir, record); } },
131
+ };
132
+ }
133
+ /** Parent recovery owns this exact run token, never another generation's record. */
134
+ export function finishClosedCodexCliUpdateRecovery(token: string, configDir = getConfigDir()): void {
135
+ const dir = directory(configDir, true);
136
+ if (process.platform === "win32") {
137
+ withWindowsCliRecoveryStore(configDir, true, io => io.write(token + ".terminal", token + ".terminal.pending",
138
+ JSON.stringify({ version: 1, token, parentPid: process.pid, phase: "terminal", pgid: null })));
139
+ return;
140
+ }
141
+ // An independent terminal marker cannot be overwritten by an interrupted
142
+ // worker finishing its old armed-record rename after the close notification.
143
+ const marker = join(dir, token + ".terminal");
144
+ const temp = join(dir, token + ".terminal.pending");
145
+ const fd = pending(temp);
146
+ try { writeFileSync(fd, JSON.stringify({ version: 1, token, parentPid: process.pid, phase: "terminal", pgid: null })); fsyncSync(fd); }
147
+ finally { closeSync(fd); }
148
+ renameSync(temp, marker);
149
+ syncDirectory(dir);
150
+ }
151
+ /** Proven Windows pending children may publish; ambiguous job receipts stay unchanged. */
152
+ export function codexCliUpdateRecoveryBlocksAdmission(configDir = getConfigDir()): boolean {
153
+ // Ordinary callers can use a home alias without any updater history. Probe
154
+ // lexically first: a dangling store link is existing, unsafe evidence too.
155
+ try { lstatSync(join(configDir, "codex-cli-update-recovery")); }
156
+ catch (error) { return (error as NodeJS.ErrnoException).code !== "ENOENT"; }
157
+ try {
158
+ // Resolve only the supported home alias, never a linked recovery store.
159
+ // Mutation eligibility still requires the original canonical ancestry.
160
+ const canonical = realpathSync.native(configDir);
161
+ if (process.platform === "win32") return withWindowsCliRecoveryStore(canonical, false, io =>
162
+ inspectRecoveryFiles(io.names(), (token, suffix = ".json") => {
163
+ const record = JSON.parse(io.read(token + suffix)) as RecoveryRecord;
164
+ if (!validRecord(record, token)) throw new Error("invalid_recovery_owner");
165
+ return record;
166
+ }, record => io.write(record.token + ".json", record.token + ".pending", JSON.stringify(record), true)), true);
167
+ const dir = directory(canonical, false);
168
+ return inspectRecoveryFiles(readdirSync(dir), (token, suffix) => read(dir, token, suffix));
169
+ } catch { return true; } // Existing evidence that disappears/is unreadable stays fenced.
170
+ }
171
+
172
+ function inspectRecoveryFiles(files: string[], readRecord: (token: string, suffix?: string) => RecoveryRecord,
173
+ publishChild?: (record: RecoveryRecord) => void): boolean {
174
+ if (new Set(files.map(file => file.slice(0, 36))).size > 256) return true;
175
+ const terminal = new Set<string>();
176
+ const active = new Map<string, RecoveryRecord>();
177
+ for (const file of files.filter(file => file.endsWith(".terminal"))) {
178
+ const record = readRecord(file.slice(0, -9), ".terminal");
179
+ if (record.phase !== "terminal") return true;
180
+ terminal.add(record.token);
181
+ }
182
+ for (const file of files.filter(file => file.endsWith(".json"))) {
183
+ if (terminal.has(file.slice(0, -5))) continue;
184
+ const record = readRecord(file.slice(0, -5));
185
+ if (record.phase === "terminal") { terminal.add(record.token); continue; }
186
+ active.set(record.token, record);
187
+ }
188
+ const reconciled = new Map<string, RecoveryRecord>();
189
+ for (const file of files.filter(file => !file.endsWith(".json") && !file.endsWith(".terminal"))) {
190
+ if (process.platform === "win32" && /^[0-9a-f-]{36}\.proof\.pending$/.test(file)) {
191
+ if (terminal.has(file.slice(0, 36))) continue;
192
+ return true;
193
+ }
194
+ if (process.platform === "win32" && /^[0-9a-f-]{36}\.proof$/.test(file)) {
195
+ const token = file.slice(0, 36);
196
+ if (terminal.has(token) || active.get(token)?.windows?.jobName) continue;
197
+ return true;
198
+ }
199
+ const partial = /^([0-9a-f-]{36})(?:\.(?:terminal|[0-9a-f-]{36}))?\.pending$/.exec(file);
200
+ if (!partial) return true;
201
+ const token = partial[1]!;
202
+ if (terminal.has(token)) continue; // Published terminal authority shadows late writes.
203
+ const suffix = file.slice(token.length);
204
+ if (suffix !== ".pending" && suffix !== ".terminal.pending") return true;
205
+ const record = readRecord(token, suffix);
206
+ const previous = active.get(token) ?? reconciled.get(token);
207
+ if (process.platform === "win32" && suffix === ".pending" && record.phase === "child") {
208
+ const armed = active.get(token);
209
+ if (!publishChild || armed?.phase !== "armed" || armed.pgid !== null
210
+ || armed.parentPid !== record.parentPid || !armed.windows?.jobName
211
+ || armed.windows.creationTime !== null || armed.windows.jobName !== record.windows?.jobName
212
+ || record.pgid === null || record.pgid > 0xffffffff || !record.windows?.creationTime
213
+ || BigInt(record.windows.creationTime) > 0xffffffffffffffffn
214
+ || !processGone(record.parentPid) || !childGone(record, token => readRecord(token, ".proof"))) return true;
215
+ publishChild(record); // Existing protected flush/ACL/rename path; any failure fences.
216
+ reconciled.set(token, record); continue;
217
+ }
218
+ // A complete cleanup write can survive a crash before rename. Recognize
219
+ // only this owner's terminal evidence, with fresh lifetime proofs. Never
220
+ // infer completion from an armed/potential verifier publication.
221
+ if (record.phase !== "terminal" || record.pgid !== null || !processGone(record.parentPid)
222
+ || (previous && previous.parentPid !== record.parentPid)) return true;
223
+ if (previous?.phase === "child"
224
+ && !childGone(previous, token => readRecord(token, ".proof"))) return true;
225
+ reconciled.set(token, record);
226
+ }
227
+ for (const record of active.values()) {
228
+ if (reconciled.has(record.token)) continue;
229
+ // Re-probe on every admission attempt, including after a restart. A live
230
+ // or inaccessible group stays fenced until the whole group proves absent.
231
+ if (record.phase === "child" && record.pgid !== null
232
+ && processGone(record.parentPid) && childGone(record, token => readRecord(token, ".proof"))) continue;
233
+ return true;
234
+ }
235
+ return false;
236
+ }