@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,308 @@
1
+ import { writeFileSync } from "node:fs";
2
+ import { randomUUID } from "node:crypto";
3
+ import { win32 } from "node:path";
4
+ import type { CodexCliApplyDeps, CodexCliApplyResult, CodexCliApplyCleanupError } from "./cli-update-apply";
5
+ import { createCodexCliUpdatePlan, createNpmConfigIsolation } from "./cli-update-plan";
6
+ import { inspectCodexCliInstall, observeCodexCliSelectedCommand } from "./cli-install-provenance";
7
+ import { holdWindowsCodexCliPlanToolchain, windowsCodexCliPlanEvidence, windowsCodexCliSelectionMatches } from "./cli-windows-plan-provenance";
8
+ import { openWindowsCliApplyAuthority, WindowsCliToolchainCleanupError, type WindowsApplyAcquisition } from "./cli-update-job-store-windows";
9
+ import { flushWindowsSecretAclReapsBeforeRemoval } from "../lib/windows-secret-acl";
10
+ import { verifyWindowsCodexCliLayout, matchesWindowsCodexCliLayout } from "./cli-update-windows-layout";
11
+ import { observeWindowsInstall, sameWindowsInstall, sameWindowsPreservedEntries, windowsCodexOwnedPath,
12
+ type WindowsInstallSnapshot } from "./cli-update-windows-observation";
13
+ import { scanCodexSessionProcesses } from "./app-server-processes";
14
+ import { startWindowsCliChild, cleanupUnstartedWindowsChild, type WindowsCliChild,
15
+ type WindowsCliChildInvocation, type WindowsCliChildResult } from "./windows-cli-child";
16
+ import { windowsNpmExecutionArgs } from "./windows-npm-execution";
17
+
18
+ type Authority = Awaited<ReturnType<typeof openWindowsCliApplyAuthority>>;
19
+ type Toolchain = NonNullable<Awaited<ReturnType<typeof holdWindowsCodexCliPlanToolchain>>>;
20
+ interface Owner { retention?: { release(): void }; authority: Authority; staging: string; toolchain: Toolchain | null; child?: WindowsCliChild;
21
+ recover?: () => Promise<boolean> }
22
+ // Strong owners survive an uncertain native wait and the HTTP/CLI caller returning.
23
+ // Never collect these as ordinary cleanup, infer terminal from a PID, or start a retry.
24
+ const retained = new Set<Owner>();
25
+ /** Explicit same-process reconciliation, using only the retained original native
26
+ * process/Job handles. Never retry installation or infer termination from a PID.
27
+ */
28
+ export async function recoverWindowsCodexCliInstallations(): Promise<number> {
29
+ let recovered = 0;
30
+ for (const owner of retained) if (await owner.recover?.()) recovered++;
31
+ return recovered;
32
+ }
33
+
34
+ function npmArgs(args: readonly string[], isolation: ReturnType<typeof createNpmConfigIsolation>) {
35
+ return [...args, "--registry=https://registry.npmjs.org", `--userconfig=${isolation.npmrc}`,
36
+ `--globalconfig=${isolation.globalNpmrc}`, `--cache=${isolation.cache}`];
37
+ }
38
+ function expectedDirectories(files: readonly { relativePath: string }[], snapshot: WindowsInstallSnapshot): boolean {
39
+ const expected = new Set<string>();
40
+ for (const file of files) {
41
+ const parts = file.relativePath.split("/");
42
+ for (let i = 3; i < parts.length; i++) expected.add(parts.slice(0, i).join("/"));
43
+ }
44
+ const directories = snapshot.directories.filter(dir => windowsCodexOwnedPath(dir.split(":")[0]!));
45
+ return directories.length === expected.size && [...expected].every(path =>
46
+ directories.some(directory => directory.startsWith(path + ":")));
47
+ }
48
+
49
+ /** Explicit apply only. Shared prefix entries are bounded preservation obligations; ARM64 refuses.
50
+ * Outcomes describe the scoped installation's observed state, never filesystem-wide no-I/O.
51
+ * The existing admission layer owns confirmed/planId and durable result persistence.
52
+ */
53
+ export async function applyWindowsCodexCliUpdate(planId: string, deps: CodexCliApplyDeps): Promise<CodexCliApplyResult> {
54
+ const cancelled = () => deps.signal?.aborted === true || deps.isCancelled?.() === true;
55
+ let owner: Owner | undefined, uncertain = false, cleanupPending = false, installerStarted = false;
56
+ let ownerRegistrationPending = false;
57
+ let installationWindowHeld = false;
58
+ let recoveryAllowed = false;
59
+ let installedVersion: string | null = null, targetVersion: string | null = null, exitCode: number | null = null;
60
+ let verificationPid: number | null = null, output: CodexCliApplyResult | undefined;
61
+ const finish = (outcome: CodexCliApplyResult["outcome"], reason: string): CodexCliApplyResult => output = {
62
+ outcome, reason, planId, installedVersion, targetVersion, installerExitCode: exitCode,
63
+ leaseRetained: uncertain || cleanupPending || ownerRegistrationPending, verificationPid, cleanupErrors: cleanupPending ? ["child_cleanup_failed"] : [],
64
+ };
65
+ const inspection = () => {
66
+ const input = { ...deps.inspectionDeps, platform: "win32" as const, observeInstallContent: true };
67
+ return { ...input, selectedCommand: observeCodexCliSelectedCommand(input) };
68
+ };
69
+ const inspect = () => (deps.inspect ?? inspectCodexCliInstall)(inspection());
70
+ const plan = () => createCodexCliUpdatePlan({ ...deps, platform: "win32", inspectionDeps: inspection() });
71
+ const settle = async (child: WindowsCliChild): Promise<WindowsCliChildResult> => {
72
+ if (!owner) throw new Error("ownership_required");
73
+
74
+ if (!child.process) {
75
+ const cleaned = await cleanupUnstartedWindowsChild(child);
76
+ uncertain = false; cleanupPending = !cleaned;
77
+ if (cleaned) owner.child = undefined;
78
+ return { terminal: true, cleanupComplete: cleaned, exitCode: null, stdout: "", failed: true, overflow: false, reason: child.setupFailure };
79
+ }
80
+ const result = await child.wait();
81
+ uncertain = !result.terminal;
82
+ cleanupPending = result.terminal && !result.cleanupComplete;
83
+ if (result.terminal && result.cleanupComplete) owner.child = undefined;
84
+ return result;
85
+ };
86
+ const startOwned = (invocation: WindowsCliChildInvocation): WindowsCliChild => {
87
+ if (!owner || owner.child) throw new Error("child_cleanup_pending");
88
+ uncertain = true; // A throwing start may already have created native resources.
89
+ const jobName = installerStarted ? `Global\\ocx-cli-${randomUUID()}` : undefined;
90
+ const proof = jobName ? deps.commitWindow?.childStarting?.(jobName) : undefined;
91
+ const child = owner.child = (deps.startWindowsChild ?? startWindowsCliChild)({ ...invocation,
92
+ recoveryJobName: jobName, recoveryProof: proof || undefined });
93
+ if (jobName && child.pid && child.creationTime) deps.commitWindow?.childStarted?.(child.pid,
94
+ { jobName, creationTime: child.creationTime });
95
+ return child;
96
+ };
97
+ const run = async (invocation: WindowsCliChildInvocation): Promise<WindowsCliChildResult> => {
98
+ if (!owner) throw new Error("ownership_required");
99
+ await owner.authority.verify();
100
+ if (!installerStarted && cancelled()) throw new Error("cancelled");
101
+ return settle(startOwned(invocation));
102
+ };
103
+ try {
104
+ if (!/^[0-9a-f]{32}$/.test(planId)) return finish("refused", "invalid_plan_id");
105
+ if (process.platform !== "win32" || process.arch !== "x64") return finish("refused", "windows_inspection_deferred");
106
+ if (cancelled()) return finish("refused", "cancelled");
107
+ const first = await inspect(), evidence = windowsCodexCliPlanEvidence(first);
108
+ installedVersion = first.packageVersion;
109
+ if (!first.managed || !evidence || evidence.arch !== "x64") return finish("refused", "mutation_evidence_unverified");
110
+ if (cancelled()) return finish("refused", "cancelled");
111
+ const initialPlan = await plan(); targetVersion = initialPlan.targetVersion;
112
+ if (cancelled()) return finish("refused", "cancelled");
113
+ if (!initialPlan.applicable) return finish("refused", initialPlan.refusal ?? "plan_refused");
114
+ if (initialPlan.planId !== planId) return finish("refused", "plan_changed");
115
+ const artifacts = initialPlan.targetArtifacts;
116
+ if (!artifacts || artifacts.platform !== "win32" || artifacts.arch !== "x64") return finish("refused", "target_artifacts_unverified");
117
+ // Root the acquisition anchor before await/Owner registration. If registration
118
+ // throws, the Worker token still owns any acquired authority through this anchor.
119
+ const anchor: { acquisition?: WindowsApplyAcquisition; authority?: Authority; owner?: Owner } = {};
120
+ const retention = deps.retainExecution?.(anchor);
121
+ let authority: Authority;
122
+ try {
123
+ authority = anchor.authority = await openWindowsCliApplyAuthority(evidence.prefix, true,
124
+ acquisition => { anchor.acquisition = acquisition; });
125
+ } catch (error) {
126
+ // Authority's finally has already attempted cleanup, without retrying failed pins.
127
+ // A rejected acquisition can still own handles even though no Authority was returned.
128
+ if (anchor.acquisition && !anchor.acquisition.releaseIfClean(retention)) {
129
+ ownerRegistrationPending = true;
130
+ return finish("ambiguous", "installer_or_readback_error");
131
+ }
132
+ if (!anchor.acquisition) retention?.release(); // Native load/validation failed before any ctx existed.
133
+ return finish("refused", error instanceof Error && error.message === "job_store_busy"
134
+ ? "installation_busy" : "installation_prefix_unsupported");
135
+ }
136
+ ownerRegistrationPending = true;
137
+ owner = anchor.owner = { retention, authority, staging: win32.join(authority.lock, "stage"), toolchain: null };
138
+ retained.add(owner);
139
+ ownerRegistrationPending = false;
140
+ let recovering = false, recoveryTerminal = false;
141
+ owner.recover = async () => {
142
+ if (!recoveryAllowed || recovering || !owner || (!recoveryTerminal
143
+ && (!uncertain || !owner.child || !owner.child.process || !owner.child.observe().terminal))) return false;
144
+ recovering = true;
145
+ try {
146
+ if (!recoveryTerminal) {
147
+ const settled = await settle(owner.child!);
148
+ if (!settled.terminal || !settled.cleanupComplete) return false;
149
+ recoveryTerminal = true; // Survives transient authority/readback failure.
150
+ }
151
+ // Readback is required before reopening the shared installation, even
152
+ // though this recovery never upgrades the earlier ambiguous job result.
153
+ await owner.authority.verify();
154
+ await observeWindowsInstall(evidence.prefix); await inspect();
155
+ if (installationWindowHeld) { deps.commitWindow!.exit(); installationWindowHeld = false; }
156
+ await flushWindowsSecretAclReapsBeforeRemoval(owner.staging);
157
+ await owner.authority.removeStaging();
158
+ if (owner.toolchain && !await owner.toolchain.release()) return false;
159
+ await owner.authority.release();
160
+ if (!owner.authority.resourcesReleased) return false;
161
+ retained.delete(owner); owner.retention?.release(); return true;
162
+ } catch { return false; } finally { recovering = false; }
163
+ };
164
+ await authority.createStaging();
165
+ if (cancelled()) return finish("refused", "cancelled");
166
+ owner.toolchain = await holdWindowsCodexCliPlanToolchain(first);
167
+ if (cancelled()) return finish("refused", "cancelled");
168
+ if (!owner.toolchain) return finish("refused", "npm_unavailable");
169
+ const isolation = createNpmConfigIsolation(owner.staging, deps.inspectionDeps?.env);
170
+ // Include Windows temp/profile names: no npm or version cache may fall back to a live home.
171
+ const env = { ...isolation.env, HOME: owner.staging, USERPROFILE: owner.staging, TEMP: owner.staging,
172
+ TMP: owner.staging, TMPDIR: owner.staging, APPDATA: owner.staging, LOCALAPPDATA: owner.staging, CODEX_HOME: owner.staging };
173
+ const invoke = (args: readonly string[], policy: WindowsCliChildInvocation["policy"]) => run({
174
+ executable: evidence.node, args: windowsNpmExecutionArgs(evidence.npmCli, npmArgs(args, isolation)), cwd: isolation.dir, env, policy,
175
+ });
176
+ const archives: string[] = [];
177
+ for (const [index, artifact] of [artifacts.main, artifacts.backing].entries()) {
178
+ if (cancelled()) return finish("refused", "cancelled");
179
+ let path: string;
180
+ if (deps.fetchArtifact) {
181
+ path = win32.join(owner.staging, `${index}.tgz`);
182
+ writeFileSync(path, await deps.fetchArtifact(artifact, deps.signal), { flag: "wx" });
183
+ } else {
184
+ const packed = await invoke(["pack", `${artifact.name}@${artifact.version}`, "--json", "--ignore-scripts",
185
+ "--pack-destination", owner.staging, "--fetch-retries=0", "--fetch-timeout=120000"], "pack");
186
+ if (!packed.terminal) return finish("ambiguous", "installer_state_unknown");
187
+ if (cleanupPending) return finish("ambiguous", "child_cleanup_unverified");
188
+ if (packed.failed || packed.overflow || packed.exitCode !== 0) throw new Error("pack_failed");
189
+ const names = JSON.parse(packed.stdout);
190
+ if (!Array.isArray(names) || names.length !== 1 || !/^[A-Za-z0-9][A-Za-z0-9._-]*\.tgz$/.test(names[0]?.filename)) throw new Error("pack_unverified");
191
+ path = win32.join(owner.staging, names[0].filename);
192
+ }
193
+ if (cancelled()) return finish("refused", "cancelled");
194
+ archives.push(path);
195
+ }
196
+ const layout = await verifyWindowsCodexCliLayout(artifacts, archives[0]!, archives[1]!);
197
+ if (cancelled()) return finish("refused", "cancelled");
198
+ const original = await observeWindowsInstall(evidence.prefix);
199
+ const fresh = await plan();
200
+ if (!fresh.applicable) return finish("refused", fresh.refusal ?? "plan_refused");
201
+ if (fresh.planId !== planId) return finish("refused", "plan_changed");
202
+ if (cancelled()) return finish("refused", "cancelled");
203
+ const args = ["install", "-g", "--prefix", evidence.prefix, "--offline", "--ignore-scripts", "--omit=optional",
204
+ "--no-audit", "--no-fund", "--package-lock=false", "--update-notifier=false",
205
+ `${artifacts.main.installName}@file:${archives[0]}`, `${artifacts.backing.installName}@file:${archives[1]}`];
206
+ const invocation: WindowsCliChildInvocation = { executable: evidence.node,
207
+ args: windowsNpmExecutionArgs(evidence.npmCli, npmArgs(args, isolation)), cwd: isolation.dir, env, policy: "installer" };
208
+ const window = deps.commitWindow;
209
+ let nativeChild: WindowsCliChild | undefined;
210
+ let injectedInstall: Promise<{ terminal: boolean; exitCode: number | null }> | undefined;
211
+ if (window) {
212
+ installationWindowHeld = window.tryEnter() || await window.waitEnter();
213
+ if (!installationWindowHeld) return finish("refused", cancelled() ? "cancelled" : "installation_busy");
214
+ }
215
+ // Renew all observations after gate acquisition, including asynchronous ACLs.
216
+ // Acquisition is bounded; the Windows observation window is not short by guarantee.
217
+ if (cancelled()) return finish("refused", "cancelled");
218
+ await owner.authority.verify();
219
+ const before = await inspect(), selected = windowsCodexCliPlanEvidence(before);
220
+ if (!selected || JSON.stringify(selected) !== JSON.stringify(evidence)
221
+ || before.installContentDigest !== initialPlan.installContentDigest
222
+ || !sameWindowsInstall(original, await observeWindowsInstall(evidence.prefix))) return finish("refused", "installation_changed");
223
+ const scan = (deps.scanProcesses ?? scanCodexSessionProcesses)(deps.processIo ?? {});
224
+ if (scan.kind !== "observed") return finish("refused", "blocked_process_state_unknown");
225
+ if (scan.processes.length) return finish("refused", "blocked_active_session");
226
+ // No await from these held-identity/selection checks through CAS and native start.
227
+ owner.authority.verifyIdentitySync();
228
+ if (!windowsCodexCliSelectionMatches(before, inspection())) return finish("refused", "installation_changed");
229
+ if (cancelled() || (window && !window.commit())) return finish("refused", "cancelled");
230
+ installerStarted = true; // CAS is the irrevocable start decision, not spawn success.
231
+ uncertain = true;
232
+ // Trusted injection must begin its start synchronously, like native Create/Assign/Resume.
233
+ if (deps.install) injectedInstall = deps.install({ bin: invocation.executable,
234
+ args: invocation.args, cwd: invocation.cwd, env: invocation.env });
235
+ else nativeChild = startOwned(invocation);
236
+ const installed = nativeChild ? await settle(nativeChild) : await injectedInstall!;
237
+ uncertain = !installed.terminal; exitCode = installed.exitCode;
238
+ if (uncertain) return finish("ambiguous", "installer_state_unknown");
239
+ if (cleanupPending) return finish("ambiguous", "child_cleanup_unverified");
240
+ await owner.authority.verify();
241
+ const observed = await observeWindowsInstall(evidence.prefix);
242
+ const after = await inspect(), afterEvidence = windowsCodexCliPlanEvidence(after);
243
+ installedVersion = after.packageVersion;
244
+ const selectedAfter = after.managed && afterEvidence && afterEvidence.prefix === evidence.prefix
245
+ && windowsCodexCliSelectionMatches(first, inspection())
246
+ && afterEvidence.launcher === evidence.launcher && afterEvidence.nodeEvidence === evidence.nodeEvidence
247
+ && afterEvidence.npmEvidence === evidence.npmEvidence;
248
+ if (!selectedAfter) return finish("ambiguous", "installation_readback_unverified");
249
+ if (after.packageVersion === targetVersion && sameWindowsPreservedEntries(original, observed)
250
+ && expectedDirectories(layout.files, observed)
251
+ && afterEvidence.backingRoot === win32.join(evidence.prefix, layout.backingRoot)
252
+ && matchesWindowsCodexCliLayout(layout, observed.files.filter(file => windowsCodexOwnedPath(file.relativePath)))) {
253
+ const version = await run({ executable: evidence.node, args: [win32.join(evidence.prefix, layout.mainRoot, "bin/codex.js"), "--version"],
254
+ cwd: owner.staging, env, policy: "version" });
255
+ verificationPid = version.terminal ? null : owner.child?.pid ?? null;
256
+ if (!version.terminal) return finish("ambiguous", "version_process_state_unknown");
257
+ if (cleanupPending) return finish("ambiguous", "child_cleanup_unverified");
258
+ if (version.failed || version.overflow || version.exitCode !== 0 || version.stdout.trim() !== `codex-cli ${targetVersion}`) {
259
+ return finish("ambiguous", "version_readback_unverified");
260
+ }
261
+ const final = await inspect(); await owner.authority.verify();
262
+ if (!windowsCodexCliSelectionMatches(after, inspection()) || final.installContentDigest !== after.installContentDigest
263
+ || !sameWindowsInstall(observed, await observeWindowsInstall(evidence.prefix))) {
264
+ return finish("ambiguous", "version_readback_unverified");
265
+ }
266
+ return finish("applied", "verified_target");
267
+ }
268
+ if (after.packageVersion === first.packageVersion && after.installContentDigest === first.installContentDigest
269
+ && sameWindowsInstall(original, observed)) return finish("not_applied", "original_install_unchanged");
270
+ return finish("ambiguous", "installation_readback_unverified");
271
+ } catch (error) {
272
+ if (error instanceof WindowsCliToolchainCleanupError) {
273
+ deps.retainExecution?.(error.acquisition);
274
+ ownerRegistrationPending = true; cleanupPending = true;
275
+ return finish("ambiguous", "installer_or_readback_error");
276
+ }
277
+ if (!installerStarted && !uncertain && !ownerRegistrationPending && cancelled()) return finish("refused", "cancelled");
278
+ if (!installerStarted && !uncertain && !ownerRegistrationPending && error instanceof Error
279
+ && ["cancelled", "installation_changed", "blocked_process_state_unknown", "blocked_active_session"].includes(error.message)) {
280
+ return finish("refused", error.message);
281
+ }
282
+ return finish(installerStarted || uncertain || ownerRegistrationPending ? "ambiguous" : "refused",
283
+ installerStarted || uncertain || ownerRegistrationPending ? "installer_or_readback_error" : "preparation_failed");
284
+ } finally {
285
+ recoveryAllowed = true;
286
+ // Readback (including the version child's descendants) is inside exclusion.
287
+ // Unknown lifetime retains the exact window instead of reopening parent paths.
288
+ if (installationWindowHeld && !uncertain && !cleanupPending) deps.commitWindow!.exit();
289
+ if (owner && !uncertain && !cleanupPending) {
290
+ const errors: CodexCliApplyCleanupError[] = [];
291
+ let resourcesReleased = true;
292
+ try {
293
+ await flushWindowsSecretAclReapsBeforeRemoval(owner.staging);
294
+ await owner.authority.removeStaging();
295
+ } catch { errors.push("staging_cleanup_failed"); resourcesReleased = false; }
296
+ try { if (owner.toolchain && !await owner.toolchain.release()) {
297
+ errors.push("lease_release_unverified"); resourcesReleased = false;
298
+ } }
299
+ catch { errors.push("lease_release_exception"); resourcesReleased = false; }
300
+ try { if (!await owner.authority.release()) errors.push("lease_release_unverified"); }
301
+ catch { errors.push("lease_release_exception"); }
302
+ resourcesReleased &&= owner.authority.resourcesReleased;
303
+ if (resourcesReleased) { retained.delete(owner); ownerRegistrationPending = false; owner.retention?.release(); }
304
+ if (output) Object.assign(output, { cleanupErrors: errors, leaseRetained: !resourcesReleased });
305
+ }
306
+ if (output) { Object.freeze(output.cleanupErrors); Object.freeze(output); }
307
+ }
308
+ }
@@ -0,0 +1,110 @@
1
+ import { createHash } from "node:crypto";
2
+ import { backingReference, codexCliArtifactSet, codexCliArtifactSetDigest, verifyCodexCliArchive,
3
+ type CodexArchiveFiles, type CodexCliArtifactSet } from "./cli-update-artifacts";
4
+ import { WINDOWS_CODEX_HEADER_BYTES, WINDOWS_CODEX_NATIVE_MEMBER } from "./cli-update-windows-paths";
5
+
6
+ export interface WindowsCodexExpectedFile { readonly relativePath: string; readonly size: number; readonly digest: string }
7
+ export interface WindowsCodexArchiveLayout {
8
+ readonly schemaVersion: 1;
9
+ readonly applicable: false;
10
+ readonly mutationAuthority: false;
11
+ readonly platform: "win32";
12
+ readonly arch: "x64";
13
+ readonly nativeHeader: "PE32+-AMD64";
14
+ readonly shimContract: "npm-cmd-shim-8-node";
15
+ readonly mainRoot: "node_modules/@openai/codex";
16
+ readonly backingRoot: "node_modules/@openai/codex-win32-x64";
17
+ readonly nativePath: string;
18
+ readonly artifactsDigest: string;
19
+ readonly contentDigest: string;
20
+ readonly files: readonly WindowsCodexExpectedFile[];
21
+ }
22
+ const MAIN = "node_modules/@openai/codex", BACKING = "node_modules/@openai/codex-win32-x64";
23
+ const PACKAGE = "@openai/codex-win32-x64";
24
+ // Exact cmd-shim@8.0.0 (ISC) output for the supported node shebang/global-prefix linkage.
25
+ // Independent captured outputs live in tests/fixtures/codex-windows-npm-shims.json.
26
+ // This is a readback contract, not a shim writer or a claim about every npm version.
27
+ const SHIMS: readonly WindowsCodexExpectedFile[] = [
28
+ { relativePath: "codex", size: 421, digest: "e4cfdce20603991a0cc30e79b7080277f934100a317f9c8b2779c0a2f8213ab2" },
29
+ { relativePath: "codex.cmd", size: 341, digest: "0ea5e45d176e31ed39d5b9aad97b58afd6b41f40023508ae5362e151335db803" },
30
+ { relativePath: "codex.ps1", size: 869, digest: "1f82c9b7d42cb3293d459d7304e67f9da76297d1cc33230a3f786c297ee0cc6a" },
31
+ ];
32
+ const object = (value: unknown): value is Record<string, any> => !!value && typeof value === "object" && !Array.isArray(value);
33
+ function manifest(files: CodexArchiveFiles): Record<string, any> {
34
+ const bytes = files.get("package.json")?.bytes;
35
+ const value: unknown = bytes && JSON.parse(bytes.toString("utf8"));
36
+ if (!object(value)) throw new Error("artifact_manifest_unverified");
37
+ return value;
38
+ }
39
+ function validateNative(files: CodexArchiveFiles): void {
40
+ const native = files.get(WINDOWS_CODEX_NATIVE_MEMBER), prefix = native?.nativePrefix;
41
+ if (!native || !prefix || prefix.length !== Math.min(native.size, WINDOWS_CODEX_HEADER_BYTES)
42
+ || prefix.length < 64 || prefix.toString("ascii", 0, 2) !== "MZ") throw new Error("artifact_windows_native_unverified");
43
+ const pe = prefix.readUInt32LE(60);
44
+ if (pe < 64 || pe > prefix.length - 26 || prefix.toString("ascii", pe, pe + 4) !== "PE\0\0"
45
+ || prefix.readUInt16LE(pe + 4) !== 0x8664 || !prefix.readUInt16LE(pe + 6)
46
+ || prefix.readUInt16LE(pe + 20) < 2 || pe + 24 + prefix.readUInt16LE(pe + 20) > native.size
47
+ || !(prefix.readUInt16LE(pe + 22) & 2) || (prefix.readUInt16LE(pe + 22) & 0x2000)
48
+ || prefix.readUInt16LE(pe + 24) !== 0x20b) throw new Error("artifact_windows_native_unverified");
49
+ }
50
+
51
+ /** Read-only artifact verification. Relative paths never select a live prefix or grant write authority.
52
+ * Uses the existing Windows package/Node lookup contract's sibling optional-package lane only.
53
+ * PE header evidence is not a signature, complete image validation or execution proof.
54
+ */
55
+ export async function verifyWindowsCodexCliLayout(set: CodexCliArtifactSet, mainSource: Buffer | string,
56
+ backingSource: Buffer | string): Promise<WindowsCodexArchiveLayout> {
57
+ if (set.platform !== "win32" || set.arch !== "x64" || set.main.name !== "@openai/codex"
58
+ || set.main.installName !== "@openai/codex" || set.backing.installName !== PACKAGE) throw new Error("artifact_platform_unverified");
59
+ const main = await verifyCodexCliArchive(mainSource, set.main, { windowsX64: true });
60
+ const backing = await verifyCodexCliArchive(backingSource, set.backing, { windowsX64: true });
61
+ const pkg = manifest(main), platform = manifest(backing);
62
+ // Reuse metadata origin/version and exact direct/alias linkage checks, rather than trusting a structural DTO.
63
+ codexCliArtifactSet({ ...pkg, dist: { integrity: set.main.integrity, tarball: set.main.tarball } },
64
+ () => ({ ...platform, dist: { integrity: set.backing.integrity, tarball: set.backing.tarball } }), "win32", "x64");
65
+ for (const name of Object.keys(pkg.optionalDependencies ?? {})) {
66
+ if (!/^@openai\/codex-(linux|darwin|win32)-(x64|arm64)$/.test(name)) throw new Error("artifact_dependency_unverified");
67
+ backingReference(pkg, name);
68
+ }
69
+ const bin = typeof pkg.bin === "string" ? pkg.bin
70
+ : object(pkg.bin) && Object.keys(pkg.bin).length === 1 ? pkg.bin.codex : null;
71
+ const entry = main.get("bin/codex.js")?.bytes;
72
+ if (typeof bin !== "string" || bin.replace(/^\.\//, "") !== "bin/codex.js" || !entry
73
+ || entry.toString("utf8").split(/\r?\n/, 1)[0] !== "#!/usr/bin/env node"
74
+ || platform.exports !== undefined || platform.bin !== undefined || Object.keys(platform.optionalDependencies ?? {}).length
75
+ || (platform.os !== undefined && (!Array.isArray(platform.os) || platform.os.length !== 1 || platform.os[0] !== "win32"))
76
+ || (platform.cpu !== undefined && (!Array.isArray(platform.cpu) || platform.cpu.length !== 1 || platform.cpu[0] !== "x64"))) {
77
+ throw new Error("artifact_backing_unverified");
78
+ }
79
+ validateNative(backing);
80
+ const files: WindowsCodexExpectedFile[] = SHIMS.map(file => ({ ...file }));
81
+ for (const [root, archive] of [[MAIN, main], [BACKING, backing]] as const) {
82
+ for (const [relative, proof] of archive) {
83
+ // npm aliases are installed as explicit sibling packages. No embedded package may shadow that lookup.
84
+ if (relative.split("/").some(part => part.toLowerCase() === "node_modules")) throw new Error("artifact_backing_unverified");
85
+ files.push({ relativePath: `${root}/${relative}`, size: proof.size, digest: proof.digest });
86
+ }
87
+ }
88
+ files.sort((a, b) => a.relativePath < b.relativePath ? -1 : a.relativePath > b.relativePath ? 1 : 0);
89
+ const artifactsDigest = codexCliArtifactSetDigest(set);
90
+ const contentDigest = createHash("sha256").update("codex-cli-windows-layout-v1\0")
91
+ .update(JSON.stringify([artifactsDigest, files])).digest("hex");
92
+ return Object.freeze({ schemaVersion: 1, applicable: false, mutationAuthority: false, platform: "win32", arch: "x64",
93
+ nativeHeader: "PE32+-AMD64", shimContract: "npm-cmd-shim-8-node", mainRoot: MAIN, backingRoot: BACKING,
94
+ nativePath: `${BACKING}/${WINDOWS_CODEX_NATIVE_MEMBER}`, artifactsDigest, contentDigest,
95
+ files: Object.freeze(files.map(file => Object.freeze(file))) });
96
+ }
97
+
98
+ /** Compare the two package roots and three shim paths, not unrelated files in the global prefix.
99
+ * No filesystem reads, mode guesses or partial matches.
100
+ * The caller still owes held-file/linkage/selection proof; equal content is not mutation authority.
101
+ */
102
+ export function matchesWindowsCodexCliLayout(expected: WindowsCodexArchiveLayout,
103
+ observed: readonly WindowsCodexExpectedFile[]): boolean {
104
+ if (expected.files.length !== observed.length) return false;
105
+ const actual = new Map(observed.map(file => [file.relativePath, file]));
106
+ return actual.size === observed.length && expected.files.every(file => {
107
+ const other = actual.get(file.relativePath);
108
+ return other?.size === file.size && other.digest === file.digest;
109
+ });
110
+ }
@@ -0,0 +1,91 @@
1
+ import { lstatSync, readdirSync } from "node:fs";
2
+ import { win32 } from "node:path";
3
+ import { inspectWindowsInstallationFiles } from "./windows-installation-files";
4
+ import { verifyWindowsEntriesAclAsync, type WindowsAclEntry } from "../lib/windows-owner-acl";
5
+ import { MAX_CODEX_MEMBER_BYTES, MAX_CODEX_UNPACKED_BYTES } from "./cli-update-artifacts";
6
+ import { windowsArchivePathValidator } from "./cli-update-windows-paths";
7
+ import type { WindowsCodexExpectedFile } from "./cli-update-windows-layout";
8
+
9
+ export interface WindowsInstallSnapshot {
10
+ readonly files: readonly (WindowsCodexExpectedFile & { readonly identity: string })[];
11
+ readonly directories: readonly string[];
12
+ readonly absent: readonly string[];
13
+ }
14
+ const roots = ["codex", "codex.cmd", "codex.ps1", "node_modules/@openai/codex",
15
+ "node_modules/@openai/codex-win32-x64", "node_modules/.package-lock.json"];
16
+ const key = (path: string) => path.replaceAll("\\", "/");
17
+ export const windowsCodexOwnedPath = (relative: string): boolean => roots.slice(0, -1).some(root =>
18
+ relative === root || relative.startsWith(root + "/"));
19
+
20
+ /** Bound the existing shared prefix, never follow links outside it. Only our separately
21
+ * pinned mutex is excluded. Unrelated packages and shims are preservation obligations,
22
+ * not installer targets. Oversized or unsupported namespaces refuse before npm starts.
23
+ */
24
+ function inventory(prefix: string) {
25
+ const paths: string[] = [], directories: string[] = [], acl: WindowsAclEntry[] = [];
26
+ const validate = windowsArchivePathValidator();
27
+ let entries = 0, total = 0n;
28
+ const walk = (relative: string) => {
29
+ if (++entries > 4096) throw new Error("installation_readback_limit");
30
+ const path = win32.join(prefix, relative), st = lstatSync(path, { bigint: true });
31
+ if (st.isSymbolicLink() || (!st.isDirectory() && !st.isFile()) || (!st.isDirectory() && st.nlink !== 1n)) {
32
+ throw new Error("installation_path_unverified");
33
+ }
34
+ validate(relative, st.isDirectory());
35
+ // Descriptor readers need extended-length targets; inventory/native identity
36
+ // paths retain their canonical DOS spelling.
37
+ acl.push({ path: win32.toNamespacedPath(path), directory: st.isDirectory(), policy: "write-private" });
38
+ if (st.isDirectory()) {
39
+ directories.push(`${relative}:${st.dev}:${st.ino}`);
40
+ for (const name of readdirSync(path).sort()) walk(`${relative}/${name}`);
41
+ } else {
42
+ total += st.size;
43
+ if (st.size > BigInt(MAX_CODEX_MEMBER_BYTES) || total > BigInt(MAX_CODEX_UNPACKED_BYTES)) throw new Error("installation_readback_limit");
44
+ paths.push(relative);
45
+ }
46
+ };
47
+ for (const relative of readdirSync(prefix).sort()) if (relative !== ".ocx-codex-cli-apply.lock") walk(relative);
48
+ const absent = roots.filter(root => !paths.includes(root) && !directories.some(dir => dir.startsWith(root + ":")));
49
+ return { paths, directories, acl, absent };
50
+ }
51
+ export function windowsInstallNamespaceSupported(prefix: string): boolean {
52
+ try { inventory(prefix); return true; } catch { return false; }
53
+ }
54
+
55
+ /** Full bounded observation of both old/new package lanes, three shims and npm hidden lock.
56
+ * Includes absence and empty directories. A positive match cannot be made by reading only
57
+ * expected filenames. No POSIX executable-bit guesses substitute for Windows identity/ACL.
58
+ */
59
+ export async function observeWindowsInstall(prefix: string): Promise<WindowsInstallSnapshot> {
60
+ const { paths, directories, absent, acl } = inventory(prefix);
61
+ // Existing ancestors are guarded by the authority; each observed child must also
62
+ // refuse writes from principals outside that same trust boundary.
63
+ for (let i = 0; i < acl.length; i += 32) {
64
+ if (!await verifyWindowsEntriesAclAsync(acl.slice(i, i + 32), 5000)) throw new Error("installation_acl_unverified");
65
+ }
66
+ const files: (WindowsCodexExpectedFile & { identity: string })[] = [];
67
+ for (let i = 0; i < paths.length; i += 12) {
68
+ const batch = paths.slice(i, i + 12);
69
+ const observed = await inspectWindowsInstallationFiles(batch.map(relative => ({
70
+ path: win32.join(prefix, relative), maxBytes: lstatSync(win32.join(prefix, relative)).size, hashOnly: true, installationDigest: true,
71
+ })));
72
+ if (observed.kind !== "observed") throw new Error("installation_file_unverified");
73
+ for (const file of observed.files) files.push({ relativePath: key(win32.relative(prefix, file.path)),
74
+ size: file.identity.size, digest: file.digest, identity: JSON.stringify(file.identity) });
75
+ }
76
+ // Detect namespace changes while the bounded observations yielded.
77
+ const again = inventory(prefix);
78
+ if (JSON.stringify([...again.directories, ...again.paths].sort()) !== JSON.stringify([...directories, ...paths].sort())
79
+ || JSON.stringify(absent) !== JSON.stringify(again.absent)) throw new Error("installation_changed");
80
+ return { files: files.sort((a, b) => a.relativePath.localeCompare(b.relativePath)), directories: directories.sort(), absent: absent.sort() };
81
+ }
82
+ export const sameWindowsInstall = (left: WindowsInstallSnapshot, right: WindowsInstallSnapshot): boolean =>
83
+ JSON.stringify(left) === JSON.stringify(right);
84
+ /** npm metadata and every bounded unrelated entry must retain bytes and identity. */
85
+ export function sameWindowsPreservedEntries(left: WindowsInstallSnapshot, right: WindowsInstallSnapshot): boolean {
86
+ const preserved = (snapshot: WindowsInstallSnapshot) => ({
87
+ files: snapshot.files.filter(file => !windowsCodexOwnedPath(file.relativePath)),
88
+ directories: snapshot.directories.filter(dir => !windowsCodexOwnedPath(dir.split(":")[0]!)),
89
+ });
90
+ return JSON.stringify(preserved(left)) === JSON.stringify(preserved(right));
91
+ }
@@ -0,0 +1,26 @@
1
+ /** Archive names only, never filesystem resolution or installation authority. */
2
+ export const WINDOWS_CODEX_NATIVE_MEMBER = "vendor/x86_64-pc-windows-msvc/bin/codex.exe";
3
+ export const WINDOWS_CODEX_HEADER_BYTES = 4096;
4
+
5
+ /** ASCII is the supported archive namespace. Refuse unknown Windows case folding. */
6
+ export function windowsArchivePathValidator(): (name: string, directory: boolean) => void {
7
+ const seen = new Map<string, { spelling: string; directory: boolean; explicit: boolean }>();
8
+ return (name, directory) => {
9
+ const relative = directory && name.endsWith("/") ? name.slice(0, -1) : name;
10
+ const parts = relative.split("/");
11
+ if (relative.length > 8192 || parts.length > 64 || parts.some(part => !part || part === "." || part === ".."
12
+ || /[^\x20-\x7e]|[<>:"\\|?*]/.test(part) || /[. ]$/.test(part)
13
+ || /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)|^(?:conin\$|conout\$)$/i.test(part))) {
14
+ throw new Error("artifact_windows_path_unverified");
15
+ }
16
+ for (let i = 0; i < parts.length; i++) {
17
+ const spelling = parts.slice(0, i + 1).join("/"), key = spelling.toLowerCase();
18
+ const isDirectory = directory || i < parts.length - 1, explicit = i === parts.length - 1;
19
+ const prior = seen.get(key);
20
+ if (prior && (prior.spelling !== spelling || prior.directory !== isDirectory || prior.explicit && explicit)) {
21
+ throw new Error("artifact_windows_path_collision");
22
+ }
23
+ seen.set(key, { spelling, directory: isDirectory, explicit: explicit || !!prior?.explicit });
24
+ }
25
+ };
26
+ }
@@ -0,0 +1,32 @@
1
+ import { codexCliUpdateGroupGone, closedWindowsCodexCliUpdateChildGone, finishClosedCodexCliUpdateRecovery } from "./cli-update-recovery";
2
+ import { CODEX_CLI_UPDATE_FENCE_COMMITTED, CODEX_CLI_UPDATE_FENCE_RECOVERING,
3
+ CODEX_CLI_UPDATE_FENCE_CANCELLED, cancelCodexCliUpdateFence, releaseCodexCliUpdateGateOwner } from "./cli-update-selection-gate";
4
+
5
+ /** Close is authority only before commit. After commit require exact group absence. */
6
+ export function recoverClosedCodexCliUpdateWorker(gate: SharedArrayBuffer, fence: SharedArrayBuffer, owner: number,
7
+ token: string, configDir?: string): void {
8
+ const view = new Int32Array(fence);
9
+ // Bun close can precede full thread exit. Prevent a late commit before
10
+ // treating PREPARING as proof that no installer can ever start.
11
+ cancelCodexCliUpdateFence(fence);
12
+ if (Atomics.load(new Int32Array(gate), 0) !== owner) return;
13
+ Atomics.compareExchange(view, 0, CODEX_CLI_UPDATE_FENCE_COMMITTED, CODEX_CLI_UPDATE_FENCE_RECOVERING);
14
+ const recover = () => {
15
+ if (Atomics.load(new Int32Array(gate), 0) !== owner) return true;
16
+ if (Atomics.load(view, 0) === CODEX_CLI_UPDATE_FENCE_CANCELLED
17
+ || Atomics.load(view, 2) === 1 || codexCliUpdateGroupGone(Atomics.load(view, 1))
18
+ || (process.platform === "win32" && Atomics.load(view, 1) > 0
19
+ && closedWindowsCodexCliUpdateChildGone(token, configDir, Atomics.load(view, 1)))) {
20
+ try { finishClosedCodexCliUpdateRecovery(token, configDir); }
21
+ catch { return false; }
22
+ releaseCodexCliUpdateGateOwner(gate, owner);
23
+ return true;
24
+ }
25
+ return false;
26
+ };
27
+ if (recover()) return;
28
+ const timer = setInterval(() => {
29
+ if (Atomics.load(new Int32Array(gate), 0) !== owner || recover()) clearInterval(timer);
30
+ }, 250);
31
+ timer.unref();
32
+ }