@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
@@ -0,0 +1,393 @@
1
+ /**
2
+ * Parent-side dispatch for Codex CLI update plan/apply workers.
3
+ *
4
+ * The HTTP route and CLI keep their existing contracts: admission and the
5
+ * generation-fenced durable ledger stay in this realm, the spawned Worker
6
+ * realm owns the heavy inspection, hashing and installer lifetime. A job is
7
+ * one fresh Worker plus one unique requestId plus the ledger generation; no
8
+ * wire generation is needed because the Worker runs once, ignores later
9
+ * messages and closes.
10
+ *
11
+ * Cancellation uses BOTH channels: the per-job shared fence's
12
+ * PREPARING -> CANCELLED compare-exchange (the only word a synchronous
13
+ * worker section can observe) and a "cancel" message that aborts the real
14
+ * AbortSignal handed to apply's fetchArtifact path. The message is posted
15
+ * only when the fence CAS won, so a cancel arriving after COMMITTED defers
16
+ * to the live installer's close exactly like the in-process contract.
17
+ *
18
+ * Settlement requires BOTH a valid reply AND the Worker's close. A reply
19
+ * alone is never terminal evidence: a legitimate result can still report
20
+ * installer_state_unknown or version_process_state_unknown with a retained
21
+ * lease and a live verification child, so done-without-close means the Worker's
22
+ * own exit could not be observed and the job resolves ambiguous with its lease
23
+ * state unknown. This host never calls terminate(): an unresponsive Worker may
24
+ * legitimately own a running npm child, and killing the thread would orphan
25
+ * the very lifetime the ledger must keep reporting as unknown. Workers that
26
+ * settle ambiguous while still alive are tracked in the unjoined set so their
27
+ * count is observable evidence rather than a silent leak.
28
+ */
29
+ import { randomUUID } from "node:crypto";
30
+ import type { CodexCliApplyResult } from "./cli-update-apply";
31
+ import type { CodexCliUpdateChannel, CodexCliUpdatePlan } from "./cli-update-plan";
32
+ import type { CodexCliUpdateInspectionSnapshot } from "./cli-update-inspection-context";
33
+ import { trustedNodeLauncherContext } from "../cli/launcher-context";
34
+ import { spawnWorker } from "../lib/worker-embed";
35
+ import { recoverClosedCodexCliUpdateWorker } from "./cli-update-worker-recovery";
36
+ import {
37
+ CODEX_CLI_UPDATE_GATE_FREE,
38
+ CODEX_CLI_UPDATE_GATE_PARENT_WRITE,
39
+ CODEX_CLI_UPDATE_GATE_WORKER_COMMIT,
40
+ cancelCodexCliUpdateFence,
41
+ codexCliUpdateSelectionGate,
42
+ createCodexCliUpdateFence,
43
+ allocateCodexCliUpdateGateOwner,
44
+ } from "./cli-update-selection-gate";
45
+ import type { CodexCliUpdateWorkerReply, CodexCliUpdateWorkerRunMessage } from "./cli-update-worker";
46
+
47
+ /** Grace for the Worker's close after a valid reply before the run goes ambiguous. */
48
+ const WORKER_CLOSE_GRACE_MS = 10_000;
49
+
50
+ interface LiveJobRecord {
51
+ /** Fence CAS plus async cancel delivery; false when the fence already moved. */
52
+ readonly cancel: () => boolean;
53
+ readonly settled: () => boolean;
54
+ readonly workerClosed: () => boolean;
55
+ }
56
+
57
+ const liveJobs = new Map<string, LiveJobRecord>();
58
+ const recoveryJobs = new Map<string, () => void>();
59
+ /** Explicit reconciliation request; only the original Worker can observe its
60
+ * original native Job. This never reruns apply or changes the earlier receipt.
61
+ */
62
+ export function recoverCodexCliUpdateWorkerJob(jobId: string): boolean {
63
+ const recover = recoveryJobs.get(jobId);
64
+ if (!recover) return false;
65
+ recover(); return true;
66
+ }
67
+ const unjoinedWorkers = new Set<Worker>();
68
+ let unjoinedWorkerClosedTotal = 0;
69
+
70
+ /**
71
+ * Parent cancellation for one in-flight job: CASes that job's fence
72
+ * PREPARING -> CANCELLED and, only when that word was won, posts the async
73
+ * "cancel" message that aborts the worker's real AbortSignal. False when the
74
+ * job is unknown here or its fence already committed/cancelled — a lost CAS
75
+ * never reaches the worker, so a post-COMMITTED cancel stays deferred.
76
+ */
77
+ export function cancelCodexCliUpdateWorkerJob(jobId: string): boolean {
78
+ return liveJobs.get(jobId)?.cancel() ?? false;
79
+ }
80
+
81
+ /** Workers that settled ambiguous while still alive; evidence, not a leak counter. */
82
+ export function codexCliUpdateUnjoinedWorkerCount(): number {
83
+ return unjoinedWorkers.size;
84
+ }
85
+
86
+ /**
87
+ * Cumulative count of workers that settled without close evidence and were
88
+ * later observed closed — removed from the live set but retained as evidence.
89
+ */
90
+ export function codexCliUpdateUnjoinedWorkerClosedTotal(): number {
91
+ return unjoinedWorkerClosedTotal;
92
+ }
93
+
94
+ /**
95
+ * Operator-facing snapshot for diagnosing admission. Worker holder words
96
+ * carry generations; recovery observers can outlive the dispatch receipt.
97
+ * The liveJobs list remains dispatch evidence, not a list of OS children.
98
+ */
99
+ export interface CodexCliUpdateWorkerDiagnostics {
100
+ readonly gate: "free" | "parent_write" | "worker_commit" | "unrecognized";
101
+ readonly liveJobs: readonly {
102
+ readonly jobId: string;
103
+ readonly settled: boolean;
104
+ readonly workerClosed: boolean;
105
+ }[];
106
+ readonly unjoinedWorkers: number;
107
+ readonly unjoinedWorkerClosedTotal: number;
108
+ }
109
+
110
+ export function codexCliUpdateWorkerDiagnostics(): CodexCliUpdateWorkerDiagnostics {
111
+ const raw = Atomics.load(new Int32Array(codexCliUpdateSelectionGate()), 0);
112
+ const gate = raw === CODEX_CLI_UPDATE_GATE_FREE ? "free"
113
+ : raw === CODEX_CLI_UPDATE_GATE_PARENT_WRITE ? "parent_write"
114
+ : raw >= CODEX_CLI_UPDATE_GATE_WORKER_COMMIT ? "worker_commit"
115
+ : "unrecognized";
116
+ return {
117
+ gate,
118
+ liveJobs: [...liveJobs.entries()].map(([jobId, record]) => ({
119
+ jobId, settled: record.settled(), workerClosed: record.workerClosed(),
120
+ })),
121
+ unjoinedWorkers: unjoinedWorkers.size,
122
+ unjoinedWorkerClosedTotal,
123
+ };
124
+ }
125
+
126
+ export interface CodexCliUpdateWorkerSpawnOptions {
127
+ /** Frozen launcher snapshot; default captures the trusted context at call time. */
128
+ readonly snapshot?: CodexCliUpdateInspectionSnapshot;
129
+ /** Optional external abort: fires the same fence CAS as cancelCodexCliUpdateWorkerJob. */
130
+ readonly signal?: AbortSignal;
131
+ /** Test seam: spawn a fixture Worker instead of the bundled entrypoint. */
132
+ readonly spawnWorkerFn?: (devUrl: string, key: string) => Worker;
133
+ readonly closeGraceMs?: number;
134
+ readonly env?: { readonly CODEX_HOME?: string; readonly OPENCODEX_HOME?: string };
135
+ }
136
+
137
+ type DispatchSettlement =
138
+ | { readonly kind: "reply"; readonly reply: CodexCliUpdateWorkerReply }
139
+ | { readonly kind: "spawn_failed" }
140
+ | { readonly kind: "unsettled" };
141
+
142
+ const APPLY_OUTCOMES: ReadonlySet<string> = new Set(["refused", "applied", "not_applied", "ambiguous"]);
143
+
144
+ /**
145
+ * Reject a reply that names our ids but lacks its payload. Accepting a
146
+ * shapeless "done" would read success out of work that may not have happened;
147
+ * the ledger's downstream normalizer is a second clamp, not the only check.
148
+ */
149
+ function isPlausibleWorkerReply(
150
+ data: unknown,
151
+ requestId: string,
152
+ jobId: string,
153
+ operation: "plan" | "apply",
154
+ ): data is CodexCliUpdateWorkerReply {
155
+ if (!data || typeof data !== "object" || Array.isArray(data)) return false;
156
+ const o = data as Record<string, unknown>;
157
+ if (o.requestId !== requestId || o.jobId !== jobId) return false;
158
+ if (o.type === "error") return typeof o.message === "string";
159
+ if (o.type !== "done" || o.operation !== operation) return false;
160
+ if (operation === "plan") {
161
+ return !!o.plan && typeof o.plan === "object" && !Array.isArray(o.plan);
162
+ }
163
+ const result = o.result;
164
+ return !!result && typeof result === "object" && !Array.isArray(result)
165
+ && APPLY_OUTCOMES.has((result as { outcome?: unknown }).outcome as string)
166
+ && typeof (result as { reason?: unknown }).reason === "string";
167
+ }
168
+
169
+ function trackUnjoined(worker: Worker, alreadyClosed: boolean): void {
170
+ if (unjoinedWorkers.has(worker)) return;
171
+ if (alreadyClosed) {
172
+ // The close is already evidenced; keep the diagnostic without pretending
173
+ // a dead Worker is a live leak.
174
+ unjoinedWorkerClosedTotal++;
175
+ warnIfCommitGateHeld();
176
+ return;
177
+ }
178
+ unjoinedWorkers.add(worker);
179
+ worker.addEventListener("close", () => {
180
+ if (!unjoinedWorkers.delete(worker)) return;
181
+ unjoinedWorkerClosedTotal++;
182
+ warnIfCommitGateHeld();
183
+ }, { once: true });
184
+ }
185
+
186
+ /**
187
+ * A closed worker can still have a live installer group. Owner-scoped
188
+ * recovery releases admission only after matching terminal proof.
189
+ */
190
+ function warnIfCommitGateHeld(): void {
191
+ if (Atomics.load(new Int32Array(codexCliUpdateSelectionGate()), 0)
192
+ < CODEX_CLI_UPDATE_GATE_WORKER_COMMIT) return;
193
+ console.warn(
194
+ "[opencodex] a Codex CLI update worker closed while the shared selection gate still reads"
195
+ + " worker_commit; admission awaits owner-scoped terminal evidence — inspect"
196
+ + " codexCliUpdateWorkerDiagnostics() before retrying a busy operation",
197
+ );
198
+ }
199
+
200
+ interface DispatchState {
201
+ settled: boolean;
202
+ closed: boolean;
203
+ }
204
+
205
+ function dispatchWorker(
206
+ worker: Worker,
207
+ message: CodexCliUpdateWorkerRunMessage,
208
+ options: CodexCliUpdateWorkerSpawnOptions,
209
+ state: DispatchState,
210
+ ): Promise<DispatchSettlement> {
211
+ return new Promise<DispatchSettlement>(resolve => {
212
+ let reply: CodexCliUpdateWorkerReply | undefined;
213
+ let grace: ReturnType<typeof setTimeout> | undefined;
214
+ const finish = (value: DispatchSettlement) => {
215
+ if (state.settled) return;
216
+ state.settled = true;
217
+ if (grace) clearTimeout(grace);
218
+ resolve(value);
219
+ };
220
+ // Every non-reply terminal signal keeps the possibly-live Worker tracked:
221
+ // it can still own an installer child the ledger must report as unknown.
222
+ const unsettled = () => {
223
+ if (state.settled) return;
224
+ trackUnjoined(worker, state.closed);
225
+ finish({ kind: "unsettled" });
226
+ };
227
+ worker.onmessage = (event: MessageEvent<unknown>) => {
228
+ // A settled or already-closed dispatch ignores late traffic entirely:
229
+ // a duplicate or post-close message must not re-arm the grace timer,
230
+ // attach listeners or re-add the Worker to the unjoined set. Once a
231
+ // valid reply is stored it is authoritative: a run-once Worker cannot
232
+ // legitimately send a second result, so a late "better" duplicate or a
233
+ // trailing error reply never replaces the first correlated payload.
234
+ if (state.settled || state.closed || reply !== undefined) return;
235
+ const data = event.data;
236
+ if (!data || typeof data !== "object" || Array.isArray(data)) {
237
+ unsettled();
238
+ return;
239
+ }
240
+ const m = data as Record<string, unknown>;
241
+ // A reply naming different ids belongs to someone else; ignoring it is
242
+ // not the same as accepting it.
243
+ if (m.requestId !== message.requestId || m.jobId !== message.jobId) return;
244
+ if (!isPlausibleWorkerReply(data, message.requestId, message.jobId, message.operation)) {
245
+ unsettled();
246
+ return;
247
+ }
248
+ // done alone is not terminal evidence: the Worker's own close still has
249
+ // to be observed, and within the grace a late close still settles reply.
250
+ // The reply is stored once; the single close handler below decides.
251
+ reply = data as CodexCliUpdateWorkerReply;
252
+ grace = setTimeout(() => unsettled(), options.closeGraceMs ?? WORKER_CLOSE_GRACE_MS);
253
+ };
254
+ worker.addEventListener("messageerror", () => unsettled());
255
+ worker.addEventListener("close", () => {
256
+ state.closed = true;
257
+ recoverClosedCodexCliUpdateWorker(message.gate, message.fence, message.owner!, message.requestId,
258
+ message.env?.OPENCODEX_HOME);
259
+ if (grace) clearTimeout(grace);
260
+ // One close handler decides everything: a stored valid reply wins, any
261
+ // other close — before a reply, or after only implausible traffic — is
262
+ // unknown work, not a clean refusal.
263
+ if (reply !== undefined) finish({ kind: "reply", reply });
264
+ else unsettled();
265
+ }, { once: true });
266
+ worker.onerror = () => unsettled();
267
+ try {
268
+ worker.postMessage(message);
269
+ } catch {
270
+ // A synchronous post failure leaves delivery uncertain: the thread is
271
+ // alive and may (or may not) have received the run. Unknown work must
272
+ // never be downgraded to a provable pre-run refusal.
273
+ unsettled();
274
+ }
275
+ });
276
+ }
277
+
278
+ function applyFallback(planId: string, settled: DispatchSettlement): CodexCliApplyResult {
279
+ return Object.freeze(
280
+ settled.kind === "spawn_failed"
281
+ ? {
282
+ outcome: "refused" as const, reason: "preparation_failed", planId,
283
+ installedVersion: null, targetVersion: null, installerExitCode: null,
284
+ leaseRetained: false, verificationPid: null, cleanupErrors: Object.freeze([]),
285
+ }
286
+ : {
287
+ outcome: "ambiguous" as const, reason: "job_result_unknown", planId,
288
+ installedVersion: null, targetVersion: null, installerExitCode: null,
289
+ leaseRetained: true, verificationPid: null, cleanupErrors: Object.freeze([]),
290
+ },
291
+ );
292
+ }
293
+
294
+ async function runInWorker(
295
+ operation: "plan" | "apply",
296
+ fields: { readonly planId?: string; readonly channel?: CodexCliUpdateChannel },
297
+ options: CodexCliUpdateWorkerSpawnOptions & { readonly jobId?: string },
298
+ ): Promise<DispatchSettlement> {
299
+ const jobId = options.jobId ?? randomUUID();
300
+ const requestId = randomUUID();
301
+ const fence = createCodexCliUpdateFence();
302
+ const owner = allocateCodexCliUpdateGateOwner(codexCliUpdateSelectionGate());
303
+ const snapshot = options.snapshot !== undefined
304
+ ? options.snapshot
305
+ : trustedNodeLauncherContext()?.codexCliInspectionEnv ?? null;
306
+ let worker: Worker;
307
+ try {
308
+ const injectedSpawn = options.spawnWorkerFn;
309
+ worker = injectedSpawn === undefined || injectedSpawn === null
310
+ ? spawnWorker(new URL("./cli-update-worker.ts", import.meta.url).href, "cli-update-worker")
311
+ : injectedSpawn(new URL("./cli-update-worker.ts", import.meta.url).href, "cli-update-worker");
312
+ } catch {
313
+ // Spawn threw before the run message existed: provably no job code ran.
314
+ return { kind: "spawn_failed" };
315
+ }
316
+ const state: DispatchState = { settled: false, closed: false };
317
+ const cancel = () => {
318
+ if (!cancelCodexCliUpdateFence(fence)) return false;
319
+ // Async cancel delivery only rides a won CAS: the worker's real
320
+ // AbortSignal aborts its in-flight fetchArtifact download, while the
321
+ // fence remains the synchronous-section channel. A post-COMMITTED cancel
322
+ // loses the CAS and is never posted, so the live child keeps its close.
323
+ try { worker.postMessage({ type: "cancel", requestId, jobId }); } catch { /* already closing */ }
324
+ return true;
325
+ };
326
+ liveJobs.set(jobId, {
327
+ cancel,
328
+ settled: () => state.settled,
329
+ workerClosed: () => state.closed,
330
+ });
331
+ const signal = options.signal;
332
+ const onAbort = () => { cancel(); };
333
+ try {
334
+ if (signal) {
335
+ if (signal.aborted) onAbort();
336
+ else signal.addEventListener("abort", onAbort, { once: true });
337
+ }
338
+ const message: CodexCliUpdateWorkerRunMessage = {
339
+ type: "run",
340
+ requestId,
341
+ jobId,
342
+ operation,
343
+ ...(fields.planId !== undefined ? { planId: fields.planId } : {}),
344
+ ...(fields.channel !== undefined ? { channel: fields.channel } : {}),
345
+ snapshot,
346
+ gate: codexCliUpdateSelectionGate(),
347
+ fence,
348
+ owner,
349
+ ...(options.env ? { env: options.env } : {}),
350
+ };
351
+ const recover = () => {
352
+ try { worker.postMessage({ type: "recover", requestId, jobId }); } catch { /* no terminal evidence */ }
353
+ };
354
+ recoveryJobs.set(jobId, recover);
355
+ worker.addEventListener("close", () => { if (recoveryJobs.get(jobId) === recover) recoveryJobs.delete(jobId); }, { once: true });
356
+ return await dispatchWorker(worker, message, options, state);
357
+ } finally {
358
+ liveJobs.delete(jobId);
359
+ if (signal) signal.removeEventListener("abort", onAbort);
360
+ }
361
+ }
362
+
363
+ /**
364
+ * Run one confirmed apply in a fresh Worker. Results are the worker realm's
365
+ * own CodexCliApplyResult verbatim; dispatch failures synthesize the two
366
+ * honest fallbacks (refused preparation_failed only when no job code provably
367
+ * ran, otherwise ambiguous job_result_unknown with the lease unknown).
368
+ */
369
+ export async function runCodexCliUpdateApplyInWorker(
370
+ planId: string,
371
+ options: CodexCliUpdateWorkerSpawnOptions & { readonly jobId?: string } = {},
372
+ ): Promise<CodexCliApplyResult> {
373
+ const settled = await runInWorker("apply", { planId }, options);
374
+ if (settled.kind === "reply" && settled.reply.type === "done" && settled.reply.operation === "apply") {
375
+ return settled.reply.result;
376
+ }
377
+ return applyFallback(planId, settled);
378
+ }
379
+
380
+ /**
381
+ * Run one read-only plan in a fresh Worker. There is no ledger for a plan, so
382
+ * a dispatch failure surfaces exactly like today's thrown inspection error:
383
+ * the route translates it into plan_unavailable.
384
+ */
385
+ export async function runCodexCliUpdatePlanInWorker(
386
+ options: CodexCliUpdateWorkerSpawnOptions & { readonly channel?: CodexCliUpdateChannel } = {},
387
+ ): Promise<CodexCliUpdatePlan> {
388
+ const settled = await runInWorker("plan", { channel: options.channel ?? "latest" }, options);
389
+ if (settled.kind === "reply" && settled.reply.type === "done" && settled.reply.operation === "plan") {
390
+ return settled.reply.plan;
391
+ }
392
+ throw new Error("plan_unavailable");
393
+ }