@bitkyc08/opencodex 2.93.0 → 2.95.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 (582) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-8yedBkhm.js +58 -0
  4. package/gui/dist/assets/App-B4j-Txmb.css +1 -0
  5. package/gui/dist/assets/Tray-erSMzxPG.js +1 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/index-D7DCm5eQ.js +94 -0
  8. package/gui/dist/assets/quota-summary-BK4VuQNc.js +1 -0
  9. package/gui/dist/index.html +2 -2
  10. package/gui/dist/provider-icons/t3code.svg +4 -0
  11. package/package.json +7 -4
  12. package/src/adapters/anthropic/account-metadata.ts +34 -3
  13. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  14. package/src/adapters/anthropic/passthrough.ts +5 -2
  15. package/src/adapters/anthropic.ts +27 -7
  16. package/src/adapters/antigravity-refusal.ts +29 -0
  17. package/src/adapters/base.ts +11 -1
  18. package/src/adapters/client-fingerprint.ts +43 -9
  19. package/src/adapters/coding-agent/protocol.ts +19 -9
  20. package/src/adapters/command-code-project-context.ts +3 -3
  21. package/src/adapters/command-code.ts +4 -5
  22. package/src/adapters/cursor/catalog.ts +5 -3
  23. package/src/adapters/cursor/claude-id.ts +30 -19
  24. package/src/adapters/cursor/cursor-errors.ts +5 -2
  25. package/src/adapters/cursor/h2-pool.ts +9 -7
  26. package/src/adapters/cursor/http1-bidi.ts +1 -0
  27. package/src/adapters/cursor/live-models.ts +4 -2
  28. package/src/adapters/cursor.ts +4 -1
  29. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  30. package/src/adapters/google-antigravity-replay.ts +13 -2
  31. package/src/adapters/google-antigravity-wire.ts +8 -3
  32. package/src/adapters/google-errors.ts +33 -0
  33. package/src/adapters/google-http.ts +41 -16
  34. package/src/adapters/google-wire-compiler.ts +4 -0
  35. package/src/adapters/google.ts +21 -10
  36. package/src/adapters/kiro/adapter.ts +7 -1
  37. package/src/adapters/kiro/stream.ts +19 -13
  38. package/src/adapters/kiro-events.ts +1 -0
  39. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  40. package/src/adapters/openai-chat/messages.ts +42 -17
  41. package/src/adapters/openai-chat/passthrough.ts +4 -2
  42. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  43. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  44. package/src/adapters/openai-chat/single-system.ts +24 -0
  45. package/src/adapters/openai-chat/wire.ts +9 -0
  46. package/src/adapters/openai-chat.ts +18 -17
  47. package/src/adapters/openai-responses/image-gen.ts +15 -1
  48. package/src/adapters/openai-responses/muse-tool-catalog.ts +87 -0
  49. package/src/adapters/openai-responses/passthrough.ts +53 -41
  50. package/src/adapters/openai-responses/prompt-cache.ts +3 -1
  51. package/src/adapters/openai-responses/request-strips.ts +23 -4
  52. package/src/adapters/openai-responses/tool-output-recovery.ts +21 -8
  53. package/src/adapters/openai-responses/tool-schema.ts +20 -8
  54. package/src/adapters/openai-responses/transport.ts +20 -2
  55. package/src/adapters/openai-responses/usage.ts +34 -0
  56. package/src/adapters/opencode-go-additional-tools.ts +39 -6
  57. package/src/adapters/qoder/adapter.ts +9 -15
  58. package/src/adapters/qoder/image-input.ts +52 -0
  59. package/src/adapters/routed-agent-messages.ts +3 -0
  60. package/src/adapters/unique-tool-call-ids.ts +2 -2
  61. package/src/adapters/xai-web-search.ts +6 -3
  62. package/src/adapters/zed-additional-tools.ts +51 -0
  63. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  64. package/src/adapters/zed-json-tokens.ts +166 -0
  65. package/src/adapters/zed-openai-stream.ts +723 -0
  66. package/src/adapters/zed-tool-arguments.ts +79 -0
  67. package/src/adapters/zed.ts +48 -3
  68. package/src/advisor/consult.ts +39 -5
  69. package/src/advisor/runtime.ts +12 -3
  70. package/src/bridge/errors.ts +22 -1
  71. package/src/bridge/max-output-completion.ts +41 -0
  72. package/src/bridge/response-json.ts +13 -5
  73. package/src/bridge/sse.ts +34 -14
  74. package/src/chat/inbound.ts +13 -2
  75. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  76. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +88 -0
  77. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  78. package/src/chatgpt/app-server-shim/launcher.ts +40 -6
  79. package/src/claude/compatibility.ts +5 -1
  80. package/src/claude/desktop-3p.ts +27 -6
  81. package/src/claude/desktop-first-party.ts +16 -5
  82. package/src/claude/desktop-gateway-state.ts +4 -0
  83. package/src/claude/desktop-model-visibility.ts +141 -0
  84. package/src/claude/desktop-remote-store-io.ts +8 -8
  85. package/src/claude/inbound-content-options.ts +11 -1
  86. package/src/claude/inbound-tool-loading.ts +93 -0
  87. package/src/claude/intercept/picker-listener.ts +33 -1
  88. package/src/claude/intercept/proxy-auth.ts +16 -16
  89. package/src/claude/model-info.ts +29 -4
  90. package/src/claude/outbound.ts +33 -13
  91. package/src/cli/account-main.ts +44 -5
  92. package/src/cli/capabilities-base.ts +22 -5
  93. package/src/cli/capabilities-integrations.ts +4 -4
  94. package/src/cli/capabilities-provider-models.ts +7 -0
  95. package/src/cli/chatgpt-command.ts +1 -1
  96. package/src/cli/claude-desktop.ts +139 -98
  97. package/src/cli/codex-cli-update.ts +102 -48
  98. package/src/cli/codex-launch-auth.ts +93 -0
  99. package/src/cli/codex-launch-command.ts +32 -0
  100. package/src/cli/codex-launch-diagnostics.ts +37 -0
  101. package/src/cli/codex-launch-ownership.ts +307 -0
  102. package/src/cli/codex-launch-policy.ts +84 -0
  103. package/src/cli/codex-launcher.ts +322 -0
  104. package/src/cli/codex-shim-autorestore.ts +21 -1
  105. package/src/cli/config-command.ts +9 -4
  106. package/src/cli/config-mutation.ts +13 -0
  107. package/src/cli/dispatch.ts +19 -13
  108. package/src/cli/doctor.ts +5 -5
  109. package/src/cli/effort.ts +19 -14
  110. package/src/cli/ensure-desired-integrations.ts +21 -14
  111. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  112. package/src/cli/export-command.ts +8 -4
  113. package/src/cli/help.ts +3 -1
  114. package/src/cli/index.ts +62 -73
  115. package/src/cli/init.ts +2 -2
  116. package/src/cli/integration-input.ts +12 -0
  117. package/src/cli/integration-plan-dto.ts +2 -0
  118. package/src/cli/integration-preview.ts +6 -3
  119. package/src/cli/integrations.ts +2 -1
  120. package/src/cli/internal-command.ts +29 -2
  121. package/src/cli/link-cleanup.ts +8 -23
  122. package/src/cli/link-enrollment.ts +1 -4
  123. package/src/cli/link.ts +1 -1
  124. package/src/cli/loopback-family.ts +2 -31
  125. package/src/cli/models.ts +62 -49
  126. package/src/cli/provider-cc-switch-import.ts +185 -0
  127. package/src/cli/provider.ts +151 -139
  128. package/src/cli/registry.ts +35 -3
  129. package/src/cli/restart-scope.ts +2 -2
  130. package/src/cli/root.ts +8 -6
  131. package/src/cli/start-owner-fence.ts +22 -3
  132. package/src/cli/status-link.ts +28 -0
  133. package/src/cli/status.ts +15 -0
  134. package/src/cli/stop-approval.ts +15 -1
  135. package/src/cli/stop-restore-guard.ts +48 -0
  136. package/src/cli/stop-restore.ts +117 -36
  137. package/src/cli/system-command.ts +2 -0
  138. package/src/cli/v2.ts +86 -23
  139. package/src/client/lifecycle-lock.ts +1 -1
  140. package/src/client/link-connection.ts +19 -0
  141. package/src/client/link-relay-transport.ts +25 -3
  142. package/src/client/link-tunnel.ts +10 -0
  143. package/src/client/machine-api.ts +2 -2
  144. package/src/client/machine-listener.ts +7 -1
  145. package/src/client/restore-ownership.ts +45 -0
  146. package/src/client/runtime.ts +13 -1
  147. package/src/client/state.ts +1 -1
  148. package/src/clients/client-ids.ts +7 -0
  149. package/src/clients/client-path.ts +13 -5
  150. package/src/clients/config-export/agent-clients.ts +3 -6
  151. package/src/clients/config-export/alias-selectors.ts +85 -0
  152. package/src/clients/config-export/contracts.ts +6 -25
  153. package/src/clients/config-export/dsh.ts +8 -1
  154. package/src/clients/config-export/model-metadata.ts +19 -0
  155. package/src/clients/config-export/model-names.ts +31 -0
  156. package/src/clients/config-export/qoder.ts +3 -11
  157. package/src/clients/config-export/t3code.ts +141 -0
  158. package/src/clients/config-export.ts +65 -18
  159. package/src/clients/gentle-shell-path.ts +3 -3
  160. package/src/codex/account-cooldown-response.ts +18 -0
  161. package/src/codex/account-lifecycle.ts +27 -13
  162. package/src/codex/account-store.ts +32 -6
  163. package/src/codex/app-server-processes.ts +84 -1
  164. package/src/codex/app-server-restart-service.ts +2 -2
  165. package/src/codex/auth-api/login-flow.ts +2 -2
  166. package/src/codex/auth-api/main-account-probe.ts +50 -11
  167. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  168. package/src/codex/auth-api/pool-quota-probe.ts +2 -2
  169. package/src/codex/auth-context.ts +49 -8
  170. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  171. package/src/codex/catalog/build-entries.ts +12 -13
  172. package/src/codex/catalog/bundled.ts +67 -10
  173. package/src/codex/catalog/derive-entry.ts +2 -0
  174. package/src/codex/catalog/gather-capture.ts +3 -0
  175. package/src/codex/catalog/metadata.ts +10 -10
  176. package/src/codex/catalog/model-hints.ts +36 -4
  177. package/src/codex/catalog/native-omission.ts +28 -0
  178. package/src/codex/catalog/native-priority.ts +63 -0
  179. package/src/codex/catalog/native-template.ts +58 -0
  180. package/src/codex/catalog/parsing.ts +3 -29
  181. package/src/codex/catalog/provider-models.ts +22 -5
  182. package/src/codex/catalog/retained-sync.ts +16 -6
  183. package/src/codex/catalog/write-audit.ts +18 -18
  184. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  185. package/src/codex/cli-install-provenance.ts +103 -74
  186. package/src/codex/cli-installation-identity.ts +1 -1
  187. package/src/codex/cli-installation-limits.ts +7 -0
  188. package/src/codex/cli-update-apply.ts +391 -0
  189. package/src/codex/cli-update-artifacts.ts +259 -0
  190. package/src/codex/cli-update-files.ts +100 -0
  191. package/src/codex/cli-update-inspection-context.ts +49 -0
  192. package/src/codex/cli-update-job-execution.ts +77 -0
  193. package/src/codex/cli-update-job-store-windows.ts +1082 -0
  194. package/src/codex/cli-update-job-worker.ts +385 -0
  195. package/src/codex/cli-update-job.ts +369 -0
  196. package/src/codex/cli-update-lease.ts +71 -0
  197. package/src/codex/cli-update-paths.ts +76 -0
  198. package/src/codex/cli-update-plan.ts +180 -47
  199. package/src/codex/cli-update-recovery.ts +282 -0
  200. package/src/codex/cli-update-selection-gate.ts +305 -0
  201. package/src/codex/cli-update-windows-apply.ts +308 -0
  202. package/src/codex/cli-update-windows-layout.ts +110 -0
  203. package/src/codex/cli-update-windows-observation.ts +91 -0
  204. package/src/codex/cli-update-windows-paths.ts +26 -0
  205. package/src/codex/cli-update-worker-recovery.ts +32 -0
  206. package/src/codex/cli-update-worker.ts +185 -0
  207. package/src/codex/cli-windows-plan-provenance.ts +268 -0
  208. package/src/codex/codex-home-owner.ts +9 -8
  209. package/src/codex/convergence.ts +13 -3
  210. package/src/codex/coordinator-doctor.ts +14 -8
  211. package/src/codex/desktop-app/handoff.ts +1 -1
  212. package/src/codex/desktop-app-restart.ts +32 -3
  213. package/src/codex/exec-boundary.ts +229 -0
  214. package/src/codex/forward-transport-headers.ts +80 -0
  215. package/src/codex/history-job.ts +7 -0
  216. package/src/codex/history-provider.ts +16 -12
  217. package/src/codex/history-worker.ts +20 -1
  218. package/src/codex/inject/bounded-config-reader.ts +14 -13
  219. package/src/codex/inject/restore.ts +57 -25
  220. package/src/codex/internal/history-writer.ts +2 -1
  221. package/src/codex/mac-app-bundle.ts +52 -0
  222. package/src/codex/main-account.ts +167 -29
  223. package/src/codex/native-main-auth-temp.ts +3 -2
  224. package/src/codex/native-main-lock-file.ts +13 -12
  225. package/src/codex/native-main-refresh-mode.ts +18 -3
  226. package/src/codex/native-profile-manager.ts +8 -6
  227. package/src/codex/native-profile-store.ts +9 -0
  228. package/src/codex/native-residue.ts +18 -14
  229. package/src/codex/ocx-compaction-history.ts +3 -2
  230. package/src/codex/orca-auth-source.ts +8 -7
  231. package/src/codex/prompt-text-probe.ts +211 -69
  232. package/src/codex/quota-types.ts +5 -0
  233. package/src/codex/quota.ts +58 -7
  234. package/src/codex/role-auto-assign.ts +50 -26
  235. package/src/codex/role-capability.ts +160 -0
  236. package/src/codex/role-model-history.ts +253 -0
  237. package/src/codex/role-sizing.ts +24 -6
  238. package/src/codex/routing/cooldown-math.ts +3 -2
  239. package/src/codex/runtime.ts +161 -72
  240. package/src/codex/shim-fingerprint.ts +11 -9
  241. package/src/codex/shim-inspect.ts +3 -2
  242. package/src/codex/shim-overlay.ts +22 -3
  243. package/src/codex/shim-restore-lock.ts +11 -14
  244. package/src/codex/shim-state-file.ts +22 -14
  245. package/src/codex/shim-templates.ts +5 -2
  246. package/src/codex/shim-wrapper-write.ts +137 -0
  247. package/src/codex/shim.ts +48 -126
  248. package/src/codex/transition-state.ts +5 -4
  249. package/src/codex/windows-cli-child-native.ts +119 -0
  250. package/src/codex/windows-cli-child-pipe.ts +87 -0
  251. package/src/codex/windows-cli-child.ts +260 -0
  252. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  253. package/src/codex/windows-cli-recovery.ts +39 -0
  254. package/src/codex/windows-installation-files.ts +52 -6
  255. package/src/codex/windows-npm-execution.ts +25 -0
  256. package/src/combos/failover.ts +127 -9
  257. package/src/combos/index.ts +1 -0
  258. package/src/combos/resolve.ts +60 -22
  259. package/src/config/atomic-write.ts +113 -29
  260. package/src/config/diagnostics.ts +21 -10
  261. package/src/config/initialize.ts +6 -6
  262. package/src/config/live-reconcile.ts +11 -3
  263. package/src/config/load-degrade.ts +2 -0
  264. package/src/config/owner-registry.ts +5 -4
  265. package/src/config/persist-unlocked.ts +34 -8
  266. package/src/config/persisted-mutation.ts +7 -0
  267. package/src/config/process-state.ts +32 -10
  268. package/src/config/removed-opencode-free-backup.ts +99 -0
  269. package/src/config/removed-opencode-free.ts +4 -8
  270. package/src/config/salvage.ts +2 -0
  271. package/src/config/schema/config-schema.ts +44 -1
  272. package/src/config/schema/leaf-validators.ts +22 -0
  273. package/src/config/schema/workflow-budget.ts +43 -0
  274. package/src/config/tracked-runtime-inspection.ts +188 -0
  275. package/src/config.ts +4 -4
  276. package/src/generated/compatibility-version.json +962 -434
  277. package/src/grok/inject.ts +2 -1
  278. package/src/grok/sync.ts +5 -2
  279. package/src/images/loop.ts +14 -5
  280. package/src/integrations/aside-profile-context.ts +1 -1
  281. package/src/integrations/catalog-refresh.ts +1 -1
  282. package/src/integrations/droid-settings.ts +4 -4
  283. package/src/integrations/hermes-profiles.ts +3 -3
  284. package/src/integrations/hermes-refresh.ts +28 -0
  285. package/src/integrations/model-name-guard.ts +31 -0
  286. package/src/integrations/mutation-plan.ts +17 -4
  287. package/src/integrations/ownership.ts +3 -0
  288. package/src/integrations/registry.ts +10 -1
  289. package/src/integrations/state.ts +6 -0
  290. package/src/integrations/writer.ts +64 -59
  291. package/src/lib/abort.ts +8 -4
  292. package/src/lib/bounded-body.ts +7 -1
  293. package/src/lib/bounded-file-read.ts +3 -9
  294. package/src/lib/bun-runtime-preflight.ts +9 -8
  295. package/src/lib/config-ownership.ts +4 -0
  296. package/src/lib/errors.ts +2 -0
  297. package/src/lib/eventstream-decoder.ts +3 -2
  298. package/src/lib/file-identity.ts +15 -0
  299. package/src/lib/http-response-semantics.ts +9 -6
  300. package/src/lib/inbound-body-policy.ts +11 -0
  301. package/src/lib/jsonc.ts +7 -2
  302. package/src/lib/local-chat-completion.ts +8 -6
  303. package/src/lib/local-destinations.ts +32 -3
  304. package/src/lib/local-management-capability.ts +3 -1
  305. package/src/lib/local-upstream.ts +22 -26
  306. package/src/lib/loopback-family.ts +31 -0
  307. package/src/lib/plain-data.ts +7 -5
  308. package/src/lib/process-control.ts +30 -5
  309. package/src/lib/redact-folding.ts +9 -0
  310. package/src/lib/shadow-call.ts +55 -1
  311. package/src/lib/spend-pool-alias-validation.ts +6 -6
  312. package/src/lib/state-store-registrations.ts +2 -0
  313. package/src/lib/test-home-guard.ts +37 -9
  314. package/src/lib/tool-argument-integers.ts +99 -7
  315. package/src/lib/upstream-retry.ts +6 -1
  316. package/src/lib/windows-elevation.ts +34 -11
  317. package/src/lib/windows-owner-acl.ts +272 -32
  318. package/src/lib/windows-secret-acl.ts +328 -44
  319. package/src/lib/windows-service-wrappers.ts +10 -7
  320. package/src/lib/winsw.ts +8 -4
  321. package/src/lib/workflow-budget-config.ts +39 -0
  322. package/src/link/relay-auth.ts +38 -1
  323. package/src/link/remote-platform.ts +11 -23
  324. package/src/link/remote-probe.ts +3 -1
  325. package/src/link/remote-windows.ts +150 -0
  326. package/src/link/ssh-argv.ts +13 -5
  327. package/src/link/store.ts +4 -1
  328. package/src/link/supervisor.ts +9 -0
  329. package/src/local-credentials/generation.ts +242 -0
  330. package/src/local-credentials/inventory.ts +405 -0
  331. package/src/local-credentials/observation-lease.ts +83 -0
  332. package/src/local-credentials/publication-fence.ts +81 -0
  333. package/src/local-credentials/references.ts +36 -0
  334. package/src/local-credentials/runtime-observation.ts +28 -0
  335. package/src/messaging/remote-forward-failure.ts +35 -0
  336. package/src/messaging/remote-ports.ts +27 -5
  337. package/src/messaging/remote-process.ts +30 -4
  338. package/src/messaging/remote-tunnels.ts +80 -15
  339. package/src/oauth/account-auto-pause-policy.ts +11 -0
  340. package/src/oauth/anthropic-account-refusal.ts +1 -0
  341. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  342. package/src/oauth/anthropic-routing.ts +34 -44
  343. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  344. package/src/oauth/antigravity-discovery-diagnostics.ts +65 -0
  345. package/src/oauth/chatgpt.ts +11 -9
  346. package/src/oauth/cursor.ts +8 -2
  347. package/src/oauth/generic-account-failover.ts +33 -2
  348. package/src/oauth/generic-session-affinity.ts +7 -0
  349. package/src/oauth/google-antigravity.ts +49 -12
  350. package/src/oauth/index.ts +3 -0
  351. package/src/oauth/kiro-device-login.ts +87 -30
  352. package/src/oauth/kiro-iam-identity-center.ts +107 -0
  353. package/src/oauth/store.ts +41 -11
  354. package/src/protocols/encoders/adapter-events.ts +7 -4
  355. package/src/protocols/encoders/messages.ts +1 -1
  356. package/src/providers/account-quota-disk.ts +18 -4
  357. package/src/providers/antigravity-account-roster.ts +73 -7
  358. package/src/providers/antigravity-models.ts +8 -4
  359. package/src/providers/api-key-resolve.ts +16 -3
  360. package/src/providers/cc-switch-import-bytes.ts +991 -0
  361. package/src/providers/cc-switch-import-source.ts +1083 -0
  362. package/src/providers/cc-switch-import.ts +942 -0
  363. package/src/providers/claude-cli-identity.ts +2 -0
  364. package/src/providers/codex-capacity.ts +3 -2
  365. package/src/providers/derive.ts +6 -0
  366. package/src/providers/free-directory.ts +10 -2
  367. package/src/providers/key-store.ts +7 -2
  368. package/src/providers/model-discovery-diagnostic.ts +4 -0
  369. package/src/providers/model-discovery.ts +4 -4
  370. package/src/providers/model-rename-fields.ts +2 -0
  371. package/src/providers/model-rename-migration.ts +41 -6
  372. package/src/providers/provider-id-rewrite.ts +3 -0
  373. package/src/providers/quota/antigravity.ts +6 -4
  374. package/src/providers/quota/report-cache.ts +17 -4
  375. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  376. package/src/providers/quota.ts +2 -2
  377. package/src/providers/reasoning-metadata.ts +31 -15
  378. package/src/providers/registry/entries-core.ts +1 -1
  379. package/src/providers/registry/entries-extended.ts +1 -1
  380. package/src/providers/registry/model-ids.ts +1 -0
  381. package/src/providers/registry/model-seeds.ts +2 -1
  382. package/src/providers/registry/types.ts +3 -1
  383. package/src/providers/resolved-model-policy.ts +2 -2
  384. package/src/providers/routed-config.ts +2 -0
  385. package/src/providers/stale-model-roster-migration.ts +8 -1
  386. package/src/providers/xai-transport.ts +4 -4
  387. package/src/quota-pool/assemble.ts +51 -21
  388. package/src/quota-pool/pooled.ts +162 -0
  389. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  390. package/src/remote-control/workspace-executor.ts +14 -13
  391. package/src/responses/apply-patch-envelope.ts +35 -0
  392. package/src/responses/compaction-history-framing.ts +15 -4
  393. package/src/responses/custom-tool-compat.ts +2 -1
  394. package/src/responses/item-provenance.ts +79 -0
  395. package/src/responses/namespace-tool-compat.ts +21 -3
  396. package/src/responses/turn-membership.ts +111 -0
  397. package/src/router.ts +21 -2
  398. package/src/routing/analytics.ts +3 -5
  399. package/src/routing/fallback-policy.ts +7 -3
  400. package/src/routing/health.ts +5 -3
  401. package/src/routing/history/build-file.ts +6 -0
  402. package/src/routing/history/indexer.ts +158 -31
  403. package/src/routing/history/ingest.ts +1 -1
  404. package/src/routing/history/integrity.ts +208 -0
  405. package/src/routing/history/rebuild-job.ts +20 -6
  406. package/src/routing/history/rebuild-protocol.ts +2 -1
  407. package/src/routing/history/rebuild-worker.ts +18 -0
  408. package/src/routing/history/sqlite-errors.ts +9 -0
  409. package/src/server/admission-model-scope.ts +21 -4
  410. package/src/server/advisor-admission-scope.ts +72 -0
  411. package/src/server/audio-upstream.ts +10 -2
  412. package/src/server/auth-cors.ts +28 -2
  413. package/src/server/bind-host.ts +5 -0
  414. package/src/server/capture-admission-policy.ts +91 -0
  415. package/src/server/chat-completions.ts +47 -6
  416. package/src/server/chat-native.ts +16 -11
  417. package/src/server/claude-messages.ts +99 -3
  418. package/src/server/codex-model-list.ts +47 -0
  419. package/src/server/configured-credentials.ts +5 -0
  420. package/src/server/gui-session.ts +5 -2
  421. package/src/server/inbound-body-admission.ts +21 -13
  422. package/src/server/inbound-body-budget.ts +128 -0
  423. package/src/server/index/link-listener.ts +3 -1
  424. package/src/server/index/link-relay-sessions.ts +9 -2
  425. package/src/server/index/optional-listeners.ts +1 -0
  426. package/src/server/index/serve-options.ts +21 -45
  427. package/src/server/index/websocket-handler.ts +10 -0
  428. package/src/server/index.ts +6 -5
  429. package/src/server/inference/client-encoder-delivery.ts +3 -1
  430. package/src/server/lifecycle.ts +8 -1
  431. package/src/server/management/advisor-routes.ts +26 -9
  432. package/src/server/management/agent-settings-routes.ts +455 -549
  433. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  434. package/src/server/management/claude-code-settings-patch.ts +211 -0
  435. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  436. package/src/server/management/codex-agent-role-routes.ts +80 -2
  437. package/src/server/management/codex-cli-update-routes.ts +55 -0
  438. package/src/server/management/codex-prompt-routes.ts +2 -1
  439. package/src/server/management/codex-role-auto-assign.ts +50 -6
  440. package/src/server/management/config-routes.ts +459 -384
  441. package/src/server/management/consent-session.ts +6 -0
  442. package/src/server/management/context.ts +3 -0
  443. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  444. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  445. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  446. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  447. package/src/server/management/integration-routes.ts +45 -5
  448. package/src/server/management/link-enrollment.ts +21 -32
  449. package/src/server/management/link-route-state.ts +1 -0
  450. package/src/server/management/link-routes.ts +4 -1
  451. package/src/server/management/model-routes.ts +22 -6
  452. package/src/server/management/model-rows.ts +3 -1
  453. package/src/server/management/native-integration-routes.ts +112 -38
  454. package/src/server/management/oauth-account-routes.ts +28 -11
  455. package/src/server/management/provider-overwrite-carry.ts +21 -0
  456. package/src/server/management/provider-routes.ts +3 -1
  457. package/src/server/management/route-registry.ts +10 -3
  458. package/src/server/management/session-routes.ts +20 -2
  459. package/src/server/management/shadow-call-validation.ts +43 -2
  460. package/src/server/management/shared.ts +17 -1
  461. package/src/server/management/sidebar-routes.ts +2 -1
  462. package/src/server/management/system-restart.ts +47 -7
  463. package/src/server/management/workflow-budget-routes.ts +70 -3
  464. package/src/server/management-api.ts +61 -51
  465. package/src/server/management-auth.ts +11 -3
  466. package/src/server/messages-native-eligibility.ts +6 -5
  467. package/src/server/messages-native-scope.ts +6 -1
  468. package/src/server/messages-native.ts +21 -7
  469. package/src/server/messages-shared.ts +161 -29
  470. package/src/server/persistent-gui-session.ts +155 -0
  471. package/src/server/port-reclaim.ts +29 -5
  472. package/src/server/proxy-liveness.ts +110 -33
  473. package/src/server/request-decompress.ts +5 -1
  474. package/src/server/request-log.ts +30 -2
  475. package/src/server/responses/account-change-state.ts +14 -2
  476. package/src/server/responses/adapter-continuation.ts +5 -4
  477. package/src/server/responses/adapter-delivery.ts +24 -5
  478. package/src/server/responses/adapter-dispatch.ts +39 -45
  479. package/src/server/responses/advisor-plan-slot.ts +7 -0
  480. package/src/server/responses/advisor-slot.ts +77 -48
  481. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  482. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  483. package/src/server/responses/codex-auth-error.ts +5 -1
  484. package/src/server/responses/combo-required-tool-contract.ts +29 -1
  485. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  486. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  487. package/src/server/responses/combo-stream-preflight.ts +47 -7
  488. package/src/server/responses/compact.ts +18 -8
  489. package/src/server/responses/compaction-recovery.ts +2 -1
  490. package/src/server/responses/core-auth.ts +2 -1
  491. package/src/server/responses/core-codex-account.ts +1 -0
  492. package/src/server/responses/core-combo-failure.ts +13 -6
  493. package/src/server/responses/core-combo-native.ts +6 -5
  494. package/src/server/responses/core-combo.ts +159 -25
  495. package/src/server/responses/core-lifetime.ts +4 -0
  496. package/src/server/responses/core-options.ts +16 -0
  497. package/src/server/responses/core.ts +2 -0
  498. package/src/server/responses/fetch-helpers.ts +5 -1
  499. package/src/server/responses/jev-model-invoke.ts +10 -3
  500. package/src/server/responses/memory-models.ts +3 -2
  501. package/src/server/responses/passthrough-delivery.ts +36 -8
  502. package/src/server/responses/passthrough-dispatch.ts +17 -16
  503. package/src/server/responses/policy-fallback.ts +2 -0
  504. package/src/server/responses/request-prepare.ts +14 -6
  505. package/src/server/responses/request-send-budget.ts +2 -1
  506. package/src/server/responses/request-sidecar-auth.ts +1 -0
  507. package/src/server/responses/request-transport.ts +43 -9
  508. package/src/server/responses/run-turn-execution.ts +15 -3
  509. package/src/server/responses/sidecar-execution.ts +26 -5
  510. package/src/server/responses/turn-membership.ts +30 -0
  511. package/src/server/responses-custom-tool-repair.ts +86 -11
  512. package/src/server/responses-image-gen-repair.ts +1 -1
  513. package/src/server/responses-snapshot-repair.ts +18 -4
  514. package/src/server/responses-undeclared-tool-guard.ts +4 -0
  515. package/src/server/restart-parent-ownership.ts +49 -0
  516. package/src/server/stop-teardown.ts +46 -9
  517. package/src/server/windows-tcp-drop.ts +4 -2
  518. package/src/server/workflow-refusal.ts +2 -1
  519. package/src/service/desktop-recovery-process.ts +341 -0
  520. package/src/service/desktop-recovery.ts +172 -0
  521. package/src/service/state-lock.ts +12 -11
  522. package/src/service/windows-ops.ts +6 -3
  523. package/src/service/windows-scheduler.ts +29 -6
  524. package/src/service-manager-probe.ts +53 -8
  525. package/src/stall-timeout.ts +47 -0
  526. package/src/tray/windows.ts +6 -4
  527. package/src/types/admission-policy.ts +13 -0
  528. package/src/types/config.ts +86 -10
  529. package/src/types/provider.ts +10 -0
  530. package/src/types/request.ts +8 -1
  531. package/src/types.ts +2 -0
  532. package/src/update/async-check.ts +4 -3
  533. package/src/update/bind-probe.ts +2 -2
  534. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  535. package/src/update/guarded-port-reclaim.ts +14 -0
  536. package/src/update/guarded-runtime-ops.ts +58 -0
  537. package/src/update/guarded-tray-ops.ts +9 -0
  538. package/src/update/index.ts +196 -58
  539. package/src/update/job-pinned-start.ts +53 -0
  540. package/src/update/job-supervised-restart.ts +23 -6
  541. package/src/update/job-update-home.ts +62 -0
  542. package/src/update/job-update-tray.ts +29 -0
  543. package/src/update/job-windows-restart.ts +39 -0
  544. package/src/update/job.ts +199 -193
  545. package/src/update/mutation-guard.d.mts +30 -0
  546. package/src/update/mutation-guard.mjs +103 -0
  547. package/src/update/notify.ts +2 -2
  548. package/src/update/npm-cache-preflight.mjs +4 -4
  549. package/src/update/npm-install.mjs +5 -3
  550. package/src/update/pnpm-read-policy.mjs +3 -2
  551. package/src/update/proxy-liveness-probe.mjs +2 -2
  552. package/src/update/service-home-authority.ts +35 -0
  553. package/src/update/service-home-package-only-protocol.json +1 -0
  554. package/src/update/service-home-policy.d.mts +25 -0
  555. package/src/update/service-home-policy.mjs +112 -0
  556. package/src/update/service-home-probe-entry.ts +9 -0
  557. package/src/update/service-home-probe.d.mts +15 -0
  558. package/src/update/service-home-probe.mjs +79 -0
  559. package/src/update/service-home-protocol.json +1 -0
  560. package/src/update/supervised-recovery.d.mts +2 -2
  561. package/src/update/supervised-recovery.mjs +14 -7
  562. package/src/update/transactional-install.d.mts +3 -1
  563. package/src/update/transactional-install.mjs +29 -19
  564. package/src/update/update-failure-guidance.mjs +1 -1
  565. package/src/update/worker-launch.ts +74 -4
  566. package/src/usage/log.ts +25 -4
  567. package/src/vision/anthropic-describe.ts +2 -1
  568. package/src/vision/index.ts +2 -0
  569. package/src/vision/plan.ts +4 -0
  570. package/src/vision/routed-describe.ts +38 -23
  571. package/src/web-search/anthropic-executor.ts +2 -1
  572. package/src/web-search/anthropic-history.ts +1 -0
  573. package/src/web-search/format-result.ts +3 -2
  574. package/src/web-search/header-deadline.ts +3 -2
  575. package/src/web-search/loop.ts +113 -12
  576. package/src/web-search/parse.ts +201 -40
  577. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  578. package/gui/dist/assets/App-DMps4OLk.css +0 -1
  579. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  580. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  581. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
  582. package/gui/dist/assets/quota-summary-BXu4zE8H.js +0 -1
@@ -0,0 +1,282 @@
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, withWindowsCliRecoveryStoreAsync } 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
+ /** Every attempt observes fresh records; this never caches an ACL/admission verdict. */
173
+ export async function codexCliUpdateRecoveryBlocksAdmissionAsync(configDir = getConfigDir()): Promise<boolean> {
174
+ if (process.platform !== "win32") return codexCliUpdateRecoveryBlocksAdmission(configDir);
175
+ try { lstatSync(join(configDir, "codex-cli-update-recovery")); }
176
+ catch (error) { return (error as NodeJS.ErrnoException).code !== "ENOENT"; }
177
+ try {
178
+ const canonical = realpathSync.native(configDir);
179
+ return await withWindowsCliRecoveryStoreAsync(canonical, false, async io => {
180
+ const steps = inspectRecoveryFilesSteps(io.names(), true);
181
+ let step = steps.next();
182
+ while (!step.done) {
183
+ const effect = step.value;
184
+ if (effect.kind === "publish") {
185
+ await io.write(effect.record.token + ".json", effect.record.token + ".pending", JSON.stringify(effect.record), true);
186
+ step = steps.next(undefined);
187
+ } else {
188
+ const record = JSON.parse(await io.read(effect.token + (effect.suffix ?? ".json"))) as RecoveryRecord;
189
+ if (!validRecord(record, effect.token)) throw new Error("invalid_recovery_owner");
190
+ step = steps.next(record);
191
+ }
192
+ }
193
+ return step.value;
194
+ }, true);
195
+ } catch { return true; }
196
+ }
197
+
198
+ type RecoveryInspectionStep = { kind: "read"; token: string; suffix?: string }
199
+ | { kind: "publish"; record: RecoveryRecord };
200
+ type RecoveryInspectionSteps = Generator<RecoveryInspectionStep, boolean, RecoveryRecord | undefined>;
201
+ function* childGoneSteps(record: RecoveryRecord): RecoveryInspectionSteps {
202
+ if (process.platform !== "win32") return childGone(record);
203
+ if (record.pgid === null || !record.windows?.jobName || !record.windows.creationTime) return false;
204
+ const proof = (yield { kind: "read", token: record.token, suffix: ".proof" })!;
205
+ return childGone(record, () => proof);
206
+ }
207
+ function inspectRecoveryFiles(files: string[], readRecord: (token: string, suffix?: string) => RecoveryRecord,
208
+ publishChild?: (record: RecoveryRecord) => void): boolean {
209
+ const steps = inspectRecoveryFilesSteps(files, !!publishChild);
210
+ let step = steps.next();
211
+ while (!step.done) {
212
+ const effect = step.value;
213
+ if (effect.kind === "publish") { publishChild!(effect.record); step = steps.next(undefined); }
214
+ else step = steps.next(readRecord(effect.token, effect.suffix));
215
+ }
216
+ return step.value;
217
+ }
218
+ function* inspectRecoveryFilesSteps(files: string[], publishChild: boolean): RecoveryInspectionSteps {
219
+ if (new Set(files.map(file => file.slice(0, 36))).size > 256) return true;
220
+ const terminal = new Set<string>();
221
+ const active = new Map<string, RecoveryRecord>();
222
+ for (const file of files.filter(file => file.endsWith(".terminal"))) {
223
+ const record = (yield { kind: "read", token: file.slice(0, -9), suffix: ".terminal" })!;
224
+ if (record.phase !== "terminal") return true;
225
+ terminal.add(record.token);
226
+ }
227
+ for (const file of files.filter(file => file.endsWith(".json"))) {
228
+ if (terminal.has(file.slice(0, -5))) continue;
229
+ const record = (yield { kind: "read", token: file.slice(0, -5) })!;
230
+ if (record.phase === "terminal") { terminal.add(record.token); continue; }
231
+ active.set(record.token, record);
232
+ }
233
+ const reconciled = new Map<string, RecoveryRecord>();
234
+ for (const file of files.filter(file => !file.endsWith(".json") && !file.endsWith(".terminal"))) {
235
+ if (process.platform === "win32" && /^[0-9a-f-]{36}\.proof\.pending$/.test(file)) {
236
+ if (terminal.has(file.slice(0, 36))) continue;
237
+ return true;
238
+ }
239
+ if (process.platform === "win32" && /^[0-9a-f-]{36}\.proof$/.test(file)) {
240
+ const token = file.slice(0, 36);
241
+ if (terminal.has(token) || active.get(token)?.windows?.jobName) continue;
242
+ return true;
243
+ }
244
+ const partial = /^([0-9a-f-]{36})(?:\.(?:terminal|[0-9a-f-]{36}))?\.pending$/.exec(file);
245
+ if (!partial) return true;
246
+ const token = partial[1]!;
247
+ if (terminal.has(token)) continue; // Published terminal authority shadows late writes.
248
+ const suffix = file.slice(token.length);
249
+ if (suffix !== ".pending" && suffix !== ".terminal.pending") return true;
250
+ const record = (yield { kind: "read", token, suffix })!;
251
+ const previous = active.get(token) ?? reconciled.get(token);
252
+ if (process.platform === "win32" && suffix === ".pending" && record.phase === "child") {
253
+ const armed = active.get(token);
254
+ if (!publishChild || armed?.phase !== "armed" || armed.pgid !== null
255
+ || armed.parentPid !== record.parentPid || !armed.windows?.jobName
256
+ || armed.windows.creationTime !== null || armed.windows.jobName !== record.windows?.jobName
257
+ || record.pgid === null || record.pgid > 0xffffffff || !record.windows?.creationTime
258
+ || BigInt(record.windows.creationTime) > 0xffffffffffffffffn
259
+ || !processGone(record.parentPid) || !(yield* childGoneSteps(record)) || !processGone(record.parentPid)) return true;
260
+ yield { kind: "publish", record }; // Existing protected flush/ACL/rename path; any failure fences.
261
+ reconciled.set(token, record); continue;
262
+ }
263
+ // A complete cleanup write can survive a crash before rename. Recognize
264
+ // only this owner's terminal evidence, with fresh lifetime proofs. Never
265
+ // infer completion from an armed/potential verifier publication.
266
+ if (record.phase !== "terminal" || record.pgid !== null || !processGone(record.parentPid)
267
+ || (previous && previous.parentPid !== record.parentPid)) return true;
268
+ if (previous?.phase === "child"
269
+ && !(yield* childGoneSteps(previous))) return true;
270
+ if (!processGone(record.parentPid)) return true;
271
+ reconciled.set(token, record);
272
+ }
273
+ for (const record of active.values()) {
274
+ if (reconciled.has(record.token)) continue;
275
+ // Re-probe on every admission attempt, including after a restart. A live
276
+ // or inaccessible group stays fenced until the whole group proves absent.
277
+ if (record.phase === "child" && record.pgid !== null
278
+ && processGone(record.parentPid) && (yield* childGoneSteps(record)) && processGone(record.parentPid)) continue;
279
+ return true;
280
+ }
281
+ return false;
282
+ }
@@ -0,0 +1,305 @@
1
+ /**
2
+ * Shared commit fence and selection gate for the Codex CLI update worker.
3
+ *
4
+ * The update's last synchronous turn (final process scan, prefix/preimage/
5
+ * selection guards, installer spawn) runs inside a Worker realm now, so the
6
+ * old same-event-loop-turn argument no longer excludes the parent's own
7
+ * selection-mutating operations or its session-spawn paths. Two shared-memory
8
+ * primitives carry that exclusion across realms:
9
+ *
10
+ * - FENCE (one per dispatched job): the parent's only cancellation word is
11
+ * PREPARING -> CANCELLED, and the worker's only commit word is
12
+ * PREPARING -> COMMITTED. Exactly one compareExchange wins. A cancel that
13
+ * lands first is observed by the worker's isCancelled checkpoints and by
14
+ * the commit CAS losing; a commit that lands first means the npm spawn
15
+ * already happened and a late cancel is deferred to readback.
16
+ *
17
+ * - GATE (one process-wide holder plus generation counter): PARENT_WRITE belongs to the five
18
+ * parent selection writers (runtime pin persist/clear, shim install/
19
+ * auto-restore/uninstall) and the two parent session-spawn paths (remote
20
+ * workspace child, desktop relaunch). A unique worker generation is taken by the
21
+ * update worker through installer termination and post-install readback.
22
+ * Writers report busy rather than wait: a synchronous parent writer
23
+ * must never park the event loop behind it. The gate is intentionally one
24
+ * cell for the whole process rather than per-configDir: alias/junction/case
25
+ * spellings of the same target must not split the exclusion, so a writer on
26
+ * a different configDir can also see busy until the installation settles.
27
+ *
28
+ * This module claims nothing about processes it does not own: an external
29
+ * installer, a late descendant of an earlier child, or an OS snapshot race
30
+ * stays the documented residual it always was.
31
+ */
32
+
33
+ import { codexCliUpdateRecoveryBlocksAdmission, codexCliUpdateRecoveryBlocksAdmissionAsync } from "./cli-update-recovery";
34
+ import type { CodexCliUpdateNativeChildIdentity, CodexCliUpdateNativeRecoveryProof } from "./cli-update-recovery";
35
+ import { getConfigDir } from "../config/paths";
36
+ import { resolve } from "node:path";
37
+
38
+ export const CODEX_CLI_UPDATE_FENCE_PREPARING = 0;
39
+ export const CODEX_CLI_UPDATE_FENCE_CANCELLED = 1;
40
+ export const CODEX_CLI_UPDATE_FENCE_COMMITTED = 2;
41
+ export const CODEX_CLI_UPDATE_FENCE_RECOVERING = 3;
42
+
43
+ export const CODEX_CLI_UPDATE_GATE_FREE = 0;
44
+ export const CODEX_CLI_UPDATE_GATE_PARENT_WRITE = 1;
45
+ export const CODEX_CLI_UPDATE_GATE_WORKER_COMMIT = 2;
46
+
47
+ /** Bounded wait for a parent writer's window; the worker then refuses busy. */
48
+ const WORKER_COMMIT_WAIT_DEADLINE_MS = 30_000;
49
+
50
+ export class CodexCliSelectionMutationBusyError extends Error {
51
+ constructor(message = "codex_cli_selection_busy") {
52
+ super(message);
53
+ this.name = "CodexCliSelectionMutationBusyError";
54
+ }
55
+ }
56
+
57
+ let selectionGate: SharedArrayBuffer | null = null;
58
+ let asyncParentOwner: { buffer: SharedArrayBuffer; owner: number } | null = null;
59
+ // This scope exists only during one synchronous commit turn. It is never kept
60
+ // across an await, so unrelated parent requests cannot borrow its admission.
61
+ let parentCommitScope: { buffer: SharedArrayBuffer; owner: number; configDir: string } | null = null;
62
+
63
+ /** One process-wide holder and monotonic generation counter shared across realms. */
64
+ export function codexCliUpdateSelectionGate(): SharedArrayBuffer {
65
+ selectionGate ??= new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * 2);
66
+ return selectionGate;
67
+ }
68
+
69
+ /** Diagnostic classification does not grant or release gate ownership. */
70
+ export function codexCliSelectionGateState(): "free" | "parent_write" | "worker_commit" | "unrecognized" {
71
+ const buffer = codexCliUpdateSelectionGate(), owner = Atomics.load(new Int32Array(buffer), 0);
72
+ if (owner === CODEX_CLI_UPDATE_GATE_FREE) return "free";
73
+ if (owner === CODEX_CLI_UPDATE_GATE_PARENT_WRITE
74
+ || (asyncParentOwner?.buffer === buffer && asyncParentOwner.owner === owner)) return "parent_write";
75
+ return owner >= CODEX_CLI_UPDATE_GATE_WORKER_COMMIT ? "worker_commit" : "unrecognized";
76
+ }
77
+
78
+ /** Test seam: drop the cell so each case starts from FREE on a fresh buffer. */
79
+ export function resetCodexCliSelectionGatesForTests(): void {
80
+ selectionGate = null;
81
+ asyncParentOwner = null;
82
+ }
83
+
84
+ /** Per-job fence: decision, current child pgid (0 = unpublished), terminal proof. */
85
+ export function createCodexCliUpdateFence(): SharedArrayBuffer {
86
+ return new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * 3);
87
+ }
88
+
89
+ /** The holder word IS the generation: one CAS releases exactly one owner. */
90
+ export function allocateCodexCliUpdateGateOwner(buffer: SharedArrayBuffer): number {
91
+ const view = new Int32Array(buffer);
92
+ for (;;) {
93
+ const sequence = Atomics.load(view, 1);
94
+ if (sequence >= 0x7ffffffd) throw new Error("cli_update_gate_generation_exhausted");
95
+ if (Atomics.compareExchange(view, 1, sequence, sequence + 1) === sequence) {
96
+ return sequence + CODEX_CLI_UPDATE_GATE_WORKER_COMMIT;
97
+ }
98
+ }
99
+ }
100
+ export function releaseCodexCliUpdateGateOwner(buffer: SharedArrayBuffer, owner: number): void {
101
+ Atomics.compareExchange(new Int32Array(buffer), 0, owner, CODEX_CLI_UPDATE_GATE_FREE);
102
+ }
103
+
104
+ /** Parent cancel word. True only when this CAS took PREPARING -> CANCELLED. */
105
+ export function cancelCodexCliUpdateFence(fence: SharedArrayBuffer): boolean {
106
+ return Atomics.compareExchange(new Int32Array(fence), 0,
107
+ CODEX_CLI_UPDATE_FENCE_PREPARING, CODEX_CLI_UPDATE_FENCE_CANCELLED) === CODEX_CLI_UPDATE_FENCE_PREPARING;
108
+ }
109
+
110
+ /**
111
+ * The worker-side cancellation checkpoint fed to apply's isCancelled hook.
112
+ * COMMITTED is deliberately not "cancelled": once the commit CAS lands the
113
+ * installer is a live child whose close must be observed, not a cancel.
114
+ */
115
+ export function codexCliUpdateIsCancelled(fence: SharedArrayBuffer): () => boolean {
116
+ const view = new Int32Array(fence);
117
+ return () => Atomics.load(view, 0) === CODEX_CLI_UPDATE_FENCE_CANCELLED;
118
+ }
119
+
120
+ export interface CodexCliSelectionParentWrite {
121
+ readonly entered: boolean;
122
+ /** Idempotent release; safe to call from both branches of a spawn attempt. */
123
+ exit(): void;
124
+ }
125
+
126
+ /**
127
+ * Non-blocking acquisition for the parent selection writers and session-spawn
128
+ * paths. entered === false means a commit window (or another writer) is in
129
+ * flight and the caller must surface busy immediately, never wait.
130
+ */
131
+ export function beginCodexCliSelectionParentWrite(configDir = getConfigDir()): CodexCliSelectionParentWrite {
132
+ if (parentCommitScope) {
133
+ const entered = resolve(configDir) === parentCommitScope.configDir
134
+ && Atomics.load(new Int32Array(parentCommitScope.buffer), 0) === parentCommitScope.owner;
135
+ return Object.freeze({ entered, exit() {} });
136
+ }
137
+ if (codexCliUpdateRecoveryBlocksAdmission(configDir)) return Object.freeze({ entered: false, exit() {} });
138
+ const view = new Int32Array(codexCliUpdateSelectionGate());
139
+ if (Atomics.compareExchange(view, 0, CODEX_CLI_UPDATE_GATE_FREE, CODEX_CLI_UPDATE_GATE_PARENT_WRITE)
140
+ !== CODEX_CLI_UPDATE_GATE_FREE) {
141
+ return Object.freeze({ entered: false, exit() { /* nothing held */ } });
142
+ }
143
+ let held = true;
144
+ return Object.freeze({
145
+ entered: true,
146
+ exit() {
147
+ if (!held) return;
148
+ held = false;
149
+ Atomics.compareExchange(view, 0, CODEX_CLI_UPDATE_GATE_PARENT_WRITE, CODEX_CLI_UPDATE_GATE_FREE);
150
+ },
151
+ });
152
+ }
153
+
154
+ type SynchronousParentCommit<T> = () => T & (T extends PromiseLike<unknown> ? never : unknown);
155
+ export interface CodexCliSelectionAsyncParentWrite extends CodexCliSelectionParentWrite {
156
+ /** Run existing synchronous writers under this exact fresh admission. Never await inside. */
157
+ commit<T>(run: SynchronousParentCommit<T>): T;
158
+ }
159
+ interface ParentAdmissionOptions {
160
+ configDir?: string;
161
+ signal?: AbortSignal;
162
+ /** Test seam; production always uses the fresh async recovery protocol. */
163
+ recoveryBlocksAdmission?: (configDir?: string) => Promise<boolean>;
164
+ }
165
+ /** Reserve before inspection, keep the generation across awaits, and release only that owner. */
166
+ export async function beginCodexCliSelectionParentWriteAsync(options: ParentAdmissionOptions = {}): Promise<CodexCliSelectionAsyncParentWrite> {
167
+ const refused = Object.freeze({ entered: false, exit() {}, commit<T>(_run: SynchronousParentCommit<T>): T { throw new CodexCliSelectionMutationBusyError(); } });
168
+ if (options.signal?.aborted) return refused;
169
+ const configDir = resolve(options.configDir ?? getConfigDir());
170
+ const buffer = codexCliUpdateSelectionGate(), view = new Int32Array(buffer);
171
+ const owner = allocateCodexCliUpdateGateOwner(buffer);
172
+ if (Atomics.compareExchange(view, 0, CODEX_CLI_UPDATE_GATE_FREE, owner) !== CODEX_CLI_UPDATE_GATE_FREE) return refused;
173
+ const parent = { buffer, owner };
174
+ asyncParentOwner = parent;
175
+ let held = true;
176
+ const exit = () => {
177
+ if (!held) return;
178
+ held = false;
179
+ releaseCodexCliUpdateGateOwner(buffer, owner);
180
+ if (asyncParentOwner === parent) asyncParentOwner = null;
181
+ };
182
+ try {
183
+ if (await (options.recoveryBlocksAdmission ?? codexCliUpdateRecoveryBlocksAdmissionAsync)(configDir)
184
+ || options.signal?.aborted || Atomics.load(view, 0) !== owner) { exit(); return refused; }
185
+ } catch { exit(); return refused; }
186
+ return Object.freeze({ entered: true, exit,
187
+ commit<T>(run: SynchronousParentCommit<T>): T {
188
+ if (!held || options.signal?.aborted || Atomics.load(view, 0) !== owner) throw new CodexCliSelectionMutationBusyError();
189
+ const previous = parentCommitScope;
190
+ parentCommitScope = { buffer, owner, configDir };
191
+ try { return run(); } finally { parentCommitScope = previous; }
192
+ },
193
+ });
194
+ }
195
+
196
+ /** The callback is synchronous: config critical sections retain their original no-await contract. */
197
+ export async function withCodexCliSelectionParentWriteAsync<T>(run: SynchronousParentCommit<T>, options: ParentAdmissionOptions = {}): Promise<T> {
198
+ const admission = await beginCodexCliSelectionParentWriteAsync(options);
199
+ if (!admission.entered) throw new CodexCliSelectionMutationBusyError();
200
+ try { return admission.commit<T>(run); } finally { admission.exit(); }
201
+ }
202
+
203
+ /**
204
+ * The worker's installation window. tryEnter covers the uncontended same-turn
205
+ * case; waitEnter is the bounded retry for a held parent write. commit() is
206
+ * the fence CAS issued in the same event-loop turn as the installer spawn;
207
+ * exit() releases the gate after terminal installer evidence and readback.
208
+ * Unknown installer/verifier lifetime intentionally leaves admission closed.
209
+ */
210
+ export interface CodexCliUpdateCommitWindow {
211
+ tryEnter(): boolean;
212
+ waitEnter(): Promise<boolean>;
213
+ commit(): boolean;
214
+ childStarting?(jobName?: string): CodexCliUpdateNativeRecoveryProof | void;
215
+ childStarted?(pid: number, identity?: CodexCliUpdateNativeChildIdentity): void;
216
+ exit(): void;
217
+ }
218
+
219
+ export function createWorkerCommitWindow(options: {
220
+ readonly gate: SharedArrayBuffer;
221
+ readonly fence: SharedArrayBuffer;
222
+ readonly owner?: number;
223
+ readonly recovery?: { arm(jobName?: string): CodexCliUpdateNativeRecoveryProof | void; child(pid: number, identity?: CodexCliUpdateNativeChildIdentity): void; terminal(): void };
224
+ readonly deadlineMs?: number;
225
+ /** Test seam: observe/back-off without real sleeps. */
226
+ readonly sleep?: (ms: number) => Promise<void>;
227
+ }): CodexCliUpdateCommitWindow {
228
+ const gate = new Int32Array(options.gate);
229
+ const fence = new Int32Array(options.fence);
230
+ const owner = options.owner ?? allocateCodexCliUpdateGateOwner(options.gate);
231
+ const deadlineMs = options.deadlineMs ?? WORKER_COMMIT_WAIT_DEADLINE_MS;
232
+ const sleep = options.sleep ?? (ms => new Promise<void>(resolve => setTimeout(resolve, ms)));
233
+ const cancelled = () => Atomics.load(fence, 0) === CODEX_CLI_UPDATE_FENCE_CANCELLED;
234
+ let held = false;
235
+ let cleanupRetry: ReturnType<typeof setInterval> | undefined;
236
+ const release = () => {
237
+ try { options.recovery?.terminal(); }
238
+ catch { return false; }
239
+ held = false;
240
+ releaseCodexCliUpdateGateOwner(options.gate, owner);
241
+ return true;
242
+ };
243
+ return Object.freeze({
244
+ tryEnter() {
245
+ if (cancelled()) return false;
246
+ if (!held
247
+ && Atomics.compareExchange(gate, 0, CODEX_CLI_UPDATE_GATE_FREE, owner)
248
+ === CODEX_CLI_UPDATE_GATE_FREE) {
249
+ held = true;
250
+ }
251
+ if (held && cancelled()) { held = false; releaseCodexCliUpdateGateOwner(options.gate, owner); }
252
+ return held;
253
+ },
254
+ async waitEnter() {
255
+ const deadline = Date.now() + deadlineMs;
256
+ while (!held && !cancelled()) {
257
+ if (Atomics.compareExchange(gate, 0, CODEX_CLI_UPDATE_GATE_FREE, owner)
258
+ === CODEX_CLI_UPDATE_GATE_FREE) {
259
+ held = true;
260
+ if (cancelled()) { held = false; releaseCodexCliUpdateGateOwner(options.gate, owner); }
261
+ break;
262
+ }
263
+ if (Date.now() >= deadline) break;
264
+ await sleep(1);
265
+ }
266
+ return held;
267
+ },
268
+ commit() {
269
+ if (!held || Atomics.load(gate, 0) !== owner || cancelled()) return false;
270
+ options.recovery?.arm(); // durable uncertainty precedes any possible spawn
271
+ return Atomics.compareExchange(fence, 0, CODEX_CLI_UPDATE_FENCE_PREPARING, CODEX_CLI_UPDATE_FENCE_COMMITTED)
272
+ === CODEX_CLI_UPDATE_FENCE_PREPARING;
273
+ },
274
+ childStarting(jobName?: string) {
275
+ Atomics.store(fence, 1, 0);
276
+ // Publish uncertainty BEFORE competing with parent recovery's seal.
277
+ // A close notification may precede full thread exit; no next child can
278
+ // start after the parent has sealed COMMITTED for recovery.
279
+ if (Atomics.compareExchange(fence, 0, CODEX_CLI_UPDATE_FENCE_COMMITTED, CODEX_CLI_UPDATE_FENCE_COMMITTED)
280
+ !== CODEX_CLI_UPDATE_FENCE_COMMITTED) throw new Error("cli_update_owner_recovering");
281
+ const proof = options.recovery?.arm(jobName);
282
+ // Close may seal RECOVERING while durable arming is in progress. No native
283
+ // successor may start after that seal, even if arming observed a marker.
284
+ if (Atomics.load(fence, 0) !== CODEX_CLI_UPDATE_FENCE_COMMITTED || Atomics.load(gate, 0) !== owner) {
285
+ throw new Error("cli_update_owner_recovering");
286
+ }
287
+ return proof;
288
+ },
289
+ childStarted(pid: number, identity?: CodexCliUpdateNativeChildIdentity) {
290
+ // Publication follows spawn in the same turn. Death in the gap stays unknown.
291
+ options.recovery?.child(pid, identity);
292
+ Atomics.store(fence, 1, pid);
293
+ },
294
+ exit() {
295
+ if (!held) return;
296
+ // Caller has proven no child remains. Publish that proof even if the
297
+ // durable receipt temporarily cannot be written; parent close can retry.
298
+ Atomics.store(fence, 2, 1);
299
+ if (release() || cleanupRetry) return;
300
+ cleanupRetry = setInterval(() => {
301
+ if (release()) clearInterval(cleanupRetry);
302
+ }, 250);
303
+ },
304
+ });
305
+ }