@bitkyc08/opencodex 2.93.0 → 2.94.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (435) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-DmvwlhQq.js +58 -0
  4. package/gui/dist/assets/Tray-CZatQdoF.js +1 -0
  5. package/gui/dist/assets/index-3EPO_KbX.js +94 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/{quota-summary-BXu4zE8H.js → quota-summary-BHvWg9mi.js} +1 -1
  8. package/gui/dist/index.html +2 -2
  9. package/gui/dist/provider-icons/t3code.svg +4 -0
  10. package/package.json +7 -4
  11. package/src/adapters/anthropic/account-metadata.ts +34 -3
  12. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  13. package/src/adapters/anthropic/passthrough.ts +5 -2
  14. package/src/adapters/anthropic.ts +17 -4
  15. package/src/adapters/antigravity-refusal.ts +29 -0
  16. package/src/adapters/base.ts +11 -1
  17. package/src/adapters/client-fingerprint.ts +43 -9
  18. package/src/adapters/coding-agent/protocol.ts +19 -9
  19. package/src/adapters/command-code.ts +4 -5
  20. package/src/adapters/cursor/catalog.ts +5 -3
  21. package/src/adapters/cursor/claude-id.ts +30 -19
  22. package/src/adapters/cursor/cursor-errors.ts +5 -2
  23. package/src/adapters/cursor/h2-pool.ts +9 -7
  24. package/src/adapters/cursor/http1-bidi.ts +1 -0
  25. package/src/adapters/cursor/live-models.ts +4 -2
  26. package/src/adapters/cursor.ts +4 -1
  27. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  28. package/src/adapters/google-antigravity-replay.ts +13 -2
  29. package/src/adapters/google-antigravity-wire.ts +8 -3
  30. package/src/adapters/google-errors.ts +33 -0
  31. package/src/adapters/google-http.ts +41 -16
  32. package/src/adapters/google-wire-compiler.ts +4 -0
  33. package/src/adapters/google.ts +21 -10
  34. package/src/adapters/kiro/adapter.ts +3 -0
  35. package/src/adapters/kiro/stream.ts +18 -13
  36. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  37. package/src/adapters/openai-chat/messages.ts +22 -10
  38. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  39. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  40. package/src/adapters/openai-chat/wire.ts +9 -0
  41. package/src/adapters/openai-chat.ts +18 -17
  42. package/src/adapters/openai-responses/image-gen.ts +15 -1
  43. package/src/adapters/openai-responses/passthrough.ts +11 -34
  44. package/src/adapters/openai-responses/transport.ts +20 -2
  45. package/src/adapters/openai-responses/usage.ts +34 -0
  46. package/src/adapters/qoder/adapter.ts +9 -15
  47. package/src/adapters/qoder/image-input.ts +52 -0
  48. package/src/adapters/unique-tool-call-ids.ts +2 -2
  49. package/src/adapters/zed-additional-tools.ts +51 -0
  50. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  51. package/src/adapters/zed-json-tokens.ts +166 -0
  52. package/src/adapters/zed-openai-stream.ts +723 -0
  53. package/src/adapters/zed-tool-arguments.ts +79 -0
  54. package/src/adapters/zed.ts +53 -3
  55. package/src/advisor/consult.ts +22 -0
  56. package/src/advisor/runtime.ts +3 -0
  57. package/src/bridge/errors.ts +22 -1
  58. package/src/bridge/response-json.ts +4 -1
  59. package/src/bridge/sse.ts +21 -12
  60. package/src/chat/inbound.ts +13 -2
  61. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  62. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +83 -0
  63. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  64. package/src/claude/desktop-first-party.ts +16 -5
  65. package/src/claude/desktop-gateway-state.ts +4 -0
  66. package/src/claude/inbound-tool-loading.ts +93 -0
  67. package/src/claude/intercept/picker-listener.ts +33 -1
  68. package/src/claude/model-info.ts +29 -4
  69. package/src/claude/outbound.ts +33 -13
  70. package/src/cli/account-main.ts +43 -5
  71. package/src/cli/capabilities-base.ts +22 -5
  72. package/src/cli/capabilities-integrations.ts +4 -4
  73. package/src/cli/claude-desktop.ts +139 -98
  74. package/src/cli/codex-cli-update.ts +102 -48
  75. package/src/cli/codex-launch-auth.ts +93 -0
  76. package/src/cli/codex-launch-command.ts +32 -0
  77. package/src/cli/codex-launch-diagnostics.ts +37 -0
  78. package/src/cli/codex-launch-ownership.ts +307 -0
  79. package/src/cli/codex-launch-policy.ts +84 -0
  80. package/src/cli/codex-launcher.ts +310 -0
  81. package/src/cli/codex-shim-autorestore.ts +2 -0
  82. package/src/cli/config-command.ts +9 -4
  83. package/src/cli/config-mutation.ts +13 -0
  84. package/src/cli/dispatch.ts +13 -7
  85. package/src/cli/effort.ts +19 -14
  86. package/src/cli/ensure-desired-integrations.ts +21 -14
  87. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  88. package/src/cli/export-command.ts +8 -4
  89. package/src/cli/help.ts +3 -1
  90. package/src/cli/index.ts +58 -64
  91. package/src/cli/integration-input.ts +12 -0
  92. package/src/cli/integration-plan-dto.ts +2 -0
  93. package/src/cli/integration-preview.ts +6 -3
  94. package/src/cli/integrations.ts +2 -1
  95. package/src/cli/link-cleanup.ts +8 -23
  96. package/src/cli/link-enrollment.ts +1 -4
  97. package/src/cli/link.ts +1 -1
  98. package/src/cli/loopback-family.ts +2 -31
  99. package/src/cli/models.ts +62 -49
  100. package/src/cli/provider.ts +146 -139
  101. package/src/cli/registry.ts +34 -3
  102. package/src/cli/root.ts +2 -0
  103. package/src/cli/start-owner-fence.ts +22 -3
  104. package/src/cli/status-link.ts +28 -0
  105. package/src/cli/status.ts +15 -0
  106. package/src/cli/stop-restore-guard.ts +48 -0
  107. package/src/cli/stop-restore.ts +117 -36
  108. package/src/cli/system-command.ts +2 -0
  109. package/src/cli/v2.ts +17 -4
  110. package/src/client/lifecycle-lock.ts +1 -1
  111. package/src/client/link-connection.ts +19 -0
  112. package/src/client/link-relay-transport.ts +25 -3
  113. package/src/client/link-tunnel.ts +10 -0
  114. package/src/client/machine-listener.ts +7 -1
  115. package/src/client/restore-ownership.ts +45 -0
  116. package/src/client/runtime.ts +13 -1
  117. package/src/client/state.ts +1 -1
  118. package/src/clients/client-ids.ts +7 -0
  119. package/src/clients/client-path.ts +13 -5
  120. package/src/clients/config-export/agent-clients.ts +3 -6
  121. package/src/clients/config-export/alias-selectors.ts +85 -0
  122. package/src/clients/config-export/contracts.ts +6 -25
  123. package/src/clients/config-export/dsh.ts +8 -1
  124. package/src/clients/config-export/model-metadata.ts +19 -0
  125. package/src/clients/config-export/model-names.ts +31 -0
  126. package/src/clients/config-export/qoder.ts +3 -11
  127. package/src/clients/config-export/t3code.ts +141 -0
  128. package/src/clients/config-export.ts +51 -15
  129. package/src/clients/gentle-shell-path.ts +3 -3
  130. package/src/codex/account-lifecycle.ts +27 -13
  131. package/src/codex/account-store.ts +32 -6
  132. package/src/codex/app-server-processes.ts +84 -1
  133. package/src/codex/auth-api/main-account-probe.ts +50 -11
  134. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  135. package/src/codex/auth-context.ts +45 -4
  136. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  137. package/src/codex/catalog/build-entries.ts +12 -13
  138. package/src/codex/catalog/bundled.ts +59 -9
  139. package/src/codex/catalog/derive-entry.ts +2 -0
  140. package/src/codex/catalog/gather-capture.ts +3 -0
  141. package/src/codex/catalog/metadata.ts +6 -5
  142. package/src/codex/catalog/model-hints.ts +36 -4
  143. package/src/codex/catalog/native-priority.ts +63 -0
  144. package/src/codex/catalog/provider-models.ts +20 -4
  145. package/src/codex/catalog/retained-sync.ts +1 -1
  146. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  147. package/src/codex/cli-install-provenance.ts +57 -29
  148. package/src/codex/cli-installation-identity.ts +1 -1
  149. package/src/codex/cli-installation-limits.ts +7 -0
  150. package/src/codex/cli-update-apply.ts +391 -0
  151. package/src/codex/cli-update-artifacts.ts +257 -0
  152. package/src/codex/cli-update-files.ts +100 -0
  153. package/src/codex/cli-update-inspection-context.ts +49 -0
  154. package/src/codex/cli-update-job-execution.ts +77 -0
  155. package/src/codex/cli-update-job-store-windows.ts +1010 -0
  156. package/src/codex/cli-update-job-worker.ts +393 -0
  157. package/src/codex/cli-update-job.ts +369 -0
  158. package/src/codex/cli-update-lease.ts +71 -0
  159. package/src/codex/cli-update-paths.ts +76 -0
  160. package/src/codex/cli-update-plan.ts +180 -47
  161. package/src/codex/cli-update-recovery.ts +236 -0
  162. package/src/codex/cli-update-selection-gate.ts +235 -0
  163. package/src/codex/cli-update-windows-apply.ts +308 -0
  164. package/src/codex/cli-update-windows-layout.ts +110 -0
  165. package/src/codex/cli-update-windows-observation.ts +91 -0
  166. package/src/codex/cli-update-windows-paths.ts +26 -0
  167. package/src/codex/cli-update-worker-recovery.ts +32 -0
  168. package/src/codex/cli-update-worker.ts +185 -0
  169. package/src/codex/cli-windows-plan-provenance.ts +250 -0
  170. package/src/codex/desktop-app-restart.ts +22 -3
  171. package/src/codex/exec-boundary.ts +208 -0
  172. package/src/codex/forward-transport-headers.ts +80 -0
  173. package/src/codex/history-job.ts +7 -0
  174. package/src/codex/history-provider.ts +5 -2
  175. package/src/codex/history-worker.ts +20 -1
  176. package/src/codex/inject/restore.ts +57 -25
  177. package/src/codex/internal/history-writer.ts +2 -1
  178. package/src/codex/mac-app-bundle.ts +52 -0
  179. package/src/codex/main-account.ts +161 -23
  180. package/src/codex/native-main-auth-temp.ts +3 -2
  181. package/src/codex/native-main-refresh-mode.ts +18 -3
  182. package/src/codex/native-profile-manager.ts +8 -6
  183. package/src/codex/native-profile-store.ts +9 -0
  184. package/src/codex/ocx-compaction-history.ts +3 -2
  185. package/src/codex/prompt-text-probe.ts +211 -69
  186. package/src/codex/quota.ts +9 -0
  187. package/src/codex/role-model-history.ts +253 -0
  188. package/src/codex/runtime.ts +120 -71
  189. package/src/codex/shim-overlay.ts +22 -3
  190. package/src/codex/shim-templates.ts +5 -2
  191. package/src/codex/shim-wrapper-write.ts +136 -0
  192. package/src/codex/shim.ts +24 -125
  193. package/src/codex/windows-cli-child-native.ts +119 -0
  194. package/src/codex/windows-cli-child-pipe.ts +87 -0
  195. package/src/codex/windows-cli-child.ts +260 -0
  196. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  197. package/src/codex/windows-cli-recovery.ts +39 -0
  198. package/src/codex/windows-installation-files.ts +52 -6
  199. package/src/codex/windows-npm-execution.ts +25 -0
  200. package/src/combos/failover.ts +84 -5
  201. package/src/combos/index.ts +1 -0
  202. package/src/combos/resolve.ts +60 -22
  203. package/src/config/atomic-write.ts +75 -22
  204. package/src/config/diagnostics.ts +18 -10
  205. package/src/config/live-reconcile.ts +11 -3
  206. package/src/config/owner-registry.ts +5 -4
  207. package/src/config/persist-unlocked.ts +34 -8
  208. package/src/config/persisted-mutation.ts +7 -0
  209. package/src/config/process-state.ts +9 -5
  210. package/src/config/removed-opencode-free-backup.ts +99 -0
  211. package/src/config/removed-opencode-free.ts +4 -8
  212. package/src/config/salvage.ts +1 -0
  213. package/src/config/schema/config-schema.ts +16 -1
  214. package/src/config/schema/leaf-validators.ts +15 -0
  215. package/src/config.ts +4 -4
  216. package/src/generated/compatibility-version.json +743 -315
  217. package/src/grok/inject.ts +2 -1
  218. package/src/grok/sync.ts +5 -2
  219. package/src/images/loop.ts +14 -5
  220. package/src/integrations/catalog-refresh.ts +1 -1
  221. package/src/integrations/hermes-refresh.ts +28 -0
  222. package/src/integrations/model-name-guard.ts +31 -0
  223. package/src/integrations/mutation-plan.ts +17 -4
  224. package/src/integrations/ownership.ts +3 -0
  225. package/src/integrations/registry.ts +10 -1
  226. package/src/integrations/state.ts +6 -0
  227. package/src/integrations/writer.ts +64 -59
  228. package/src/lib/abort.ts +8 -4
  229. package/src/lib/bounded-body.ts +7 -1
  230. package/src/lib/config-ownership.ts +4 -0
  231. package/src/lib/errors.ts +2 -0
  232. package/src/lib/eventstream-decoder.ts +3 -2
  233. package/src/lib/http-response-semantics.ts +9 -6
  234. package/src/lib/inbound-body-policy.ts +11 -0
  235. package/src/lib/jsonc.ts +7 -2
  236. package/src/lib/local-management-capability.ts +3 -1
  237. package/src/lib/local-upstream.ts +22 -26
  238. package/src/lib/loopback-family.ts +31 -0
  239. package/src/lib/plain-data.ts +7 -5
  240. package/src/lib/process-control.ts +30 -5
  241. package/src/lib/shadow-call.ts +55 -1
  242. package/src/lib/tool-argument-integers.ts +99 -7
  243. package/src/lib/upstream-retry.ts +6 -1
  244. package/src/lib/windows-elevation.ts +34 -11
  245. package/src/lib/windows-owner-acl.ts +272 -32
  246. package/src/lib/windows-secret-acl.ts +310 -44
  247. package/src/lib/windows-service-wrappers.ts +10 -7
  248. package/src/lib/winsw.ts +8 -4
  249. package/src/link/relay-auth.ts +38 -1
  250. package/src/link/remote-platform.ts +11 -23
  251. package/src/link/remote-probe.ts +3 -1
  252. package/src/link/remote-windows.ts +150 -0
  253. package/src/link/ssh-argv.ts +13 -5
  254. package/src/link/store.ts +4 -1
  255. package/src/link/supervisor.ts +9 -0
  256. package/src/local-credentials/generation.ts +238 -0
  257. package/src/local-credentials/inventory.ts +281 -0
  258. package/src/local-credentials/observation-lease.ts +83 -0
  259. package/src/local-credentials/publication-fence.ts +81 -0
  260. package/src/local-credentials/references.ts +36 -0
  261. package/src/local-credentials/runtime-observation.ts +28 -0
  262. package/src/oauth/account-auto-pause-policy.ts +11 -0
  263. package/src/oauth/anthropic-account-refusal.ts +1 -0
  264. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  265. package/src/oauth/anthropic-routing.ts +34 -44
  266. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  267. package/src/oauth/chatgpt.ts +11 -9
  268. package/src/oauth/cursor.ts +8 -2
  269. package/src/oauth/generic-account-failover.ts +33 -2
  270. package/src/oauth/generic-session-affinity.ts +7 -0
  271. package/src/oauth/google-antigravity.ts +29 -5
  272. package/src/oauth/index.ts +1 -0
  273. package/src/oauth/store.ts +32 -4
  274. package/src/protocols/encoders/adapter-events.ts +7 -4
  275. package/src/protocols/encoders/messages.ts +1 -1
  276. package/src/providers/antigravity-account-roster.ts +73 -7
  277. package/src/providers/antigravity-models.ts +8 -4
  278. package/src/providers/api-key-resolve.ts +16 -3
  279. package/src/providers/claude-cli-identity.ts +2 -0
  280. package/src/providers/codex-capacity.ts +3 -2
  281. package/src/providers/free-directory.ts +10 -2
  282. package/src/providers/key-store.ts +7 -2
  283. package/src/providers/provider-id-rewrite.ts +3 -0
  284. package/src/providers/quota/antigravity.ts +6 -4
  285. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  286. package/src/providers/stale-model-roster-migration.ts +3 -0
  287. package/src/quota-pool/assemble.ts +51 -21
  288. package/src/quota-pool/pooled.ts +162 -0
  289. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  290. package/src/responses/apply-patch-envelope.ts +35 -0
  291. package/src/responses/compaction-history-framing.ts +15 -4
  292. package/src/responses/turn-membership.ts +111 -0
  293. package/src/server/advisor-admission-scope.ts +43 -0
  294. package/src/server/audio-upstream.ts +10 -2
  295. package/src/server/auth-cors.ts +23 -0
  296. package/src/server/bind-host.ts +5 -0
  297. package/src/server/chat-completions.ts +17 -2
  298. package/src/server/chat-native.ts +16 -11
  299. package/src/server/claude-messages.ts +9 -1
  300. package/src/server/codex-model-list.ts +46 -0
  301. package/src/server/gui-session.ts +5 -2
  302. package/src/server/inbound-body-admission.ts +21 -13
  303. package/src/server/inbound-body-budget.ts +128 -0
  304. package/src/server/index/link-listener.ts +3 -1
  305. package/src/server/index/link-relay-sessions.ts +9 -2
  306. package/src/server/index/optional-listeners.ts +1 -0
  307. package/src/server/index/serve-options.ts +9 -43
  308. package/src/server/index/websocket-handler.ts +7 -0
  309. package/src/server/index.ts +6 -5
  310. package/src/server/inference/client-encoder-delivery.ts +3 -1
  311. package/src/server/lifecycle.ts +8 -1
  312. package/src/server/management/advisor-routes.ts +26 -9
  313. package/src/server/management/agent-settings-routes.ts +424 -543
  314. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  315. package/src/server/management/claude-code-settings-patch.ts +211 -0
  316. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  317. package/src/server/management/codex-agent-role-routes.ts +79 -2
  318. package/src/server/management/codex-cli-update-routes.ts +55 -0
  319. package/src/server/management/codex-prompt-routes.ts +2 -1
  320. package/src/server/management/config-routes.ts +444 -380
  321. package/src/server/management/consent-session.ts +6 -0
  322. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  323. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  324. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  325. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  326. package/src/server/management/integration-routes.ts +45 -5
  327. package/src/server/management/link-enrollment.ts +21 -32
  328. package/src/server/management/link-route-state.ts +1 -0
  329. package/src/server/management/link-routes.ts +4 -1
  330. package/src/server/management/model-routes.ts +22 -6
  331. package/src/server/management/model-rows.ts +3 -1
  332. package/src/server/management/native-integration-routes.ts +90 -38
  333. package/src/server/management/oauth-account-routes.ts +8 -7
  334. package/src/server/management/route-registry.ts +8 -3
  335. package/src/server/management/session-routes.ts +20 -2
  336. package/src/server/management/shadow-call-validation.ts +43 -2
  337. package/src/server/management/sidebar-routes.ts +2 -1
  338. package/src/server/management/system-restart.ts +47 -7
  339. package/src/server/management-api.ts +61 -51
  340. package/src/server/management-auth.ts +11 -3
  341. package/src/server/messages-native.ts +21 -7
  342. package/src/server/messages-shared.ts +110 -18
  343. package/src/server/persistent-gui-session.ts +155 -0
  344. package/src/server/port-reclaim.ts +29 -5
  345. package/src/server/proxy-liveness.ts +110 -33
  346. package/src/server/request-decompress.ts +5 -1
  347. package/src/server/responses/account-change-state.ts +14 -2
  348. package/src/server/responses/adapter-continuation.ts +5 -4
  349. package/src/server/responses/adapter-delivery.ts +20 -5
  350. package/src/server/responses/adapter-dispatch.ts +39 -45
  351. package/src/server/responses/advisor-plan-slot.ts +3 -0
  352. package/src/server/responses/advisor-slot.ts +4 -2
  353. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  354. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  355. package/src/server/responses/combo-required-tool-contract.ts +2 -1
  356. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  357. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  358. package/src/server/responses/combo-stream-preflight.ts +47 -7
  359. package/src/server/responses/compact.ts +14 -7
  360. package/src/server/responses/compaction-recovery.ts +2 -1
  361. package/src/server/responses/core-auth.ts +2 -1
  362. package/src/server/responses/core-codex-account.ts +1 -0
  363. package/src/server/responses/core-combo-failure.ts +11 -6
  364. package/src/server/responses/core-combo-native.ts +6 -5
  365. package/src/server/responses/core-combo.ts +93 -20
  366. package/src/server/responses/core-options.ts +7 -0
  367. package/src/server/responses/fetch-helpers.ts +5 -1
  368. package/src/server/responses/jev-model-invoke.ts +8 -3
  369. package/src/server/responses/memory-models.ts +3 -2
  370. package/src/server/responses/passthrough-delivery.ts +36 -8
  371. package/src/server/responses/passthrough-dispatch.ts +12 -12
  372. package/src/server/responses/request-prepare.ts +10 -1
  373. package/src/server/responses/request-transport.ts +41 -6
  374. package/src/server/responses/run-turn-execution.ts +11 -3
  375. package/src/server/responses/sidecar-execution.ts +5 -0
  376. package/src/server/responses/turn-membership.ts +30 -0
  377. package/src/server/responses-custom-tool-repair.ts +86 -11
  378. package/src/server/responses-image-gen-repair.ts +1 -1
  379. package/src/server/restart-parent-ownership.ts +49 -0
  380. package/src/server/stop-teardown.ts +46 -9
  381. package/src/server/windows-tcp-drop.ts +4 -2
  382. package/src/service/desktop-recovery-process.ts +341 -0
  383. package/src/service/desktop-recovery.ts +172 -0
  384. package/src/service/windows-ops.ts +6 -3
  385. package/src/service/windows-scheduler.ts +29 -6
  386. package/src/stall-timeout.ts +47 -0
  387. package/src/tray/windows.ts +6 -4
  388. package/src/types/config.ts +61 -10
  389. package/src/types/request.ts +1 -1
  390. package/src/types.ts +1 -0
  391. package/src/update/async-check.ts +4 -3
  392. package/src/update/bind-probe.ts +2 -2
  393. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  394. package/src/update/guarded-port-reclaim.ts +14 -0
  395. package/src/update/guarded-runtime-ops.ts +58 -0
  396. package/src/update/guarded-tray-ops.ts +9 -0
  397. package/src/update/index.ts +196 -58
  398. package/src/update/job-pinned-start.ts +53 -0
  399. package/src/update/job-supervised-restart.ts +23 -6
  400. package/src/update/job-update-home.ts +62 -0
  401. package/src/update/job-update-tray.ts +29 -0
  402. package/src/update/job-windows-restart.ts +39 -0
  403. package/src/update/job.ts +179 -193
  404. package/src/update/mutation-guard.d.mts +30 -0
  405. package/src/update/mutation-guard.mjs +103 -0
  406. package/src/update/notify.ts +2 -2
  407. package/src/update/npm-cache-preflight.mjs +4 -4
  408. package/src/update/npm-install.mjs +5 -3
  409. package/src/update/pnpm-read-policy.mjs +3 -2
  410. package/src/update/proxy-liveness-probe.mjs +2 -2
  411. package/src/update/service-home-authority.ts +35 -0
  412. package/src/update/service-home-package-only-protocol.json +1 -0
  413. package/src/update/service-home-policy.d.mts +25 -0
  414. package/src/update/service-home-policy.mjs +112 -0
  415. package/src/update/service-home-probe-entry.ts +9 -0
  416. package/src/update/service-home-probe.d.mts +15 -0
  417. package/src/update/service-home-probe.mjs +79 -0
  418. package/src/update/service-home-protocol.json +1 -0
  419. package/src/update/supervised-recovery.d.mts +2 -2
  420. package/src/update/supervised-recovery.mjs +14 -7
  421. package/src/update/transactional-install.d.mts +3 -1
  422. package/src/update/transactional-install.mjs +29 -19
  423. package/src/update/update-failure-guidance.mjs +1 -1
  424. package/src/update/worker-launch.ts +3 -3
  425. package/src/vision/anthropic-describe.ts +2 -1
  426. package/src/web-search/anthropic-executor.ts +2 -1
  427. package/src/web-search/anthropic-history.ts +1 -0
  428. package/src/web-search/format-result.ts +3 -2
  429. package/src/web-search/header-deadline.ts +3 -2
  430. package/src/web-search/loop.ts +10 -4
  431. package/src/web-search/parse.ts +191 -38
  432. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  433. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  434. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  435. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
@@ -0,0 +1,369 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { chmodSync, closeSync, constants, fsyncSync, fstatSync, lstatSync, mkdirSync, openSync,
3
+ readFileSync, readSync, realpathSync, renameSync, rmdirSync, unlinkSync, writeFileSync } from "node:fs";
4
+ import { dirname, join, resolve } from "node:path";
5
+ import { getConfigDir } from "../config";
6
+ import { assertTrustedCodexCliAncestry } from "./cli-update-paths";
7
+ import type { CodexCliApplyResult } from "./cli-update-apply";
8
+ import { CODEX_CLI_JOB_REASONS as SAFE_REASONS, CODEX_CLI_JOB_CLEANUP_ERRORS,
9
+ CODEX_CLI_JOB_STORE_DIR, CODEX_CLI_JOB_STORE_FILE, CODEX_CLI_JOB_STORE_LOCK, CODEX_CLI_JOB_STORE_MAX_BYTES,
10
+ CodexCliJobStoreBusyError, normalizeCodexCliJobResult, runCodexCliUpdateJobWork } from "./cli-update-job-execution";
11
+
12
+ const MAX_JOBS = 64;
13
+ type JobStatus = "queued" | "running" | "applied" | "not_applied" | "refused" | "ambiguous";
14
+
15
+ interface StoredJob {
16
+ id: string; requestKey: string; payloadHash: string; generation: string; revision: number;
17
+ status: JobStatus; createdAt: string; updatedAt: string; planId: string;
18
+ outcome: CodexCliApplyResult["outcome"] | null; reason: string | null;
19
+ cleanupErrors: readonly string[]; leaseRetained: boolean;
20
+ }
21
+ interface Store { version: 1; jobs: StoredJob[] }
22
+ export interface CodexCliUpdateJobDto {
23
+ readonly jobId: string; readonly status: "queued" | "running" | "applied" | "not_applied" | "refused" | "ambiguous";
24
+ readonly ownerState: "active" | "unknown" | "finished"; readonly lifetimeUncertain: boolean;
25
+ readonly childState: "not_started" | "active_or_not_observed" | "terminal" | "unknown";
26
+ readonly leaseState: "not_acquired_or_released" | "retained" | "unknown";
27
+ readonly createdAt: string; readonly updatedAt: string; readonly planId: string;
28
+ readonly outcome: CodexCliApplyResult["outcome"] | null; readonly reason: string | null;
29
+ readonly cleanupErrors: readonly string[];
30
+ }
31
+
32
+ const live = new Map<string, string>();
33
+ const started = new Set<string>();
34
+ const digest = (text: string) => createHash("sha256").update(text).digest("hex");
35
+ const now = () => new Date().toISOString();
36
+
37
+ function paths(configDir = getConfigDir()) {
38
+ const config = resolve(configDir);
39
+ const dir = join(config, CODEX_CLI_JOB_STORE_DIR);
40
+ return { config, dir, file: join(dir, CODEX_CLI_JOB_STORE_FILE), lock: join(dir, CODEX_CLI_JOB_STORE_LOCK) };
41
+ }
42
+ function assertTrustedConfigAncestry(parent: string) {
43
+ try { assertTrustedCodexCliAncestry(parent); }
44
+ catch { throw new Error("unsafe_store"); }
45
+ }
46
+ function prepare(configDir?: string, create = false, createConfigRoot = false) {
47
+ const p = paths(configDir);
48
+ if (process.platform === "win32" || process.geteuid?.() === undefined) throw new Error("unsupported_store");
49
+ const parent = dirname(p.config);
50
+ const parentStat = lstatSync(parent);
51
+ if (!parentStat.isDirectory() || parentStat.isSymbolicLink() || parentStat.uid !== process.geteuid()
52
+ || (parentStat.mode & 0o022) !== 0 || (parentStat.mode & 0o300) !== 0o300
53
+ || realpathSync.native(parent) !== parent) throw new Error("unsafe_store");
54
+ assertTrustedConfigAncestry(parent);
55
+ let configStat: ReturnType<typeof lstatSync>;
56
+ try { configStat = lstatSync(p.config); }
57
+ catch (error) {
58
+ if ((error as NodeJS.ErrnoException).code !== "ENOENT" || !createConfigRoot) throw error;
59
+ const parentIdentity = { dev: parentStat.dev, ino: parentStat.ino };
60
+ let created = false;
61
+ try { mkdirSync(p.config, { mode: 0o700 }); created = true; }
62
+ catch (mkdirError) { if ((mkdirError as NodeJS.ErrnoException).code !== "EEXIST") throw mkdirError; }
63
+ const parentAfter = lstatSync(parent);
64
+ if (parentAfter.dev !== parentIdentity.dev || parentAfter.ino !== parentIdentity.ino
65
+ || !parentAfter.isDirectory() || parentAfter.isSymbolicLink() || parentAfter.uid !== process.geteuid()
66
+ || (parentAfter.mode & 0o022) !== 0 || (parentAfter.mode & 0o300) !== 0o300
67
+ || realpathSync.native(parent) !== parent) {
68
+ throw new Error("unsafe_store");
69
+ }
70
+ configStat = lstatSync(p.config);
71
+ if (!configStat.isDirectory() || configStat.isSymbolicLink() || configStat.uid !== process.geteuid()
72
+ || realpathSync.native(p.config) !== p.config) throw new Error("unsafe_store");
73
+ if (created && ((configStat.mode & 0o077) !== 0 || (configStat.mode & 0o700) !== 0o700)) {
74
+ throw new Error("unsafe_store");
75
+ }
76
+ configStat = lstatSync(p.config);
77
+ }
78
+ if (!configStat.isDirectory() || configStat.isSymbolicLink() || realpathSync.native(p.config) !== p.config
79
+ || (configStat.mode & 0o022) !== 0) throw new Error("unsafe_store");
80
+ if (create) {
81
+ if (configStat.uid !== process.geteuid()) throw new Error("unsupported_store");
82
+ try { mkdirSync(p.dir, { mode: 0o700 }); chmodSync(p.dir, 0o700); }
83
+ catch (error) { if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error; }
84
+ }
85
+ const stat = lstatSync(p.dir);
86
+ if (!stat.isDirectory() || stat.isSymbolicLink() || stat.uid !== configStat.uid || (stat.mode & 0o077) !== 0
87
+ || realpathSync.native(p.dir) !== p.dir) throw new Error("unsafe_store");
88
+ return p;
89
+ }
90
+ /** Shared ledger-body validation used by the POSIX reader and the Windows backend adapter. */
91
+ function parseStoreBody(body: string | null): Store {
92
+ if (body === null) return { version: 1, jobs: [] };
93
+ const value = JSON.parse(body) as Store;
94
+ if (value.version !== 1 || !Array.isArray(value.jobs) || value.jobs.length > MAX_JOBS
95
+ || value.jobs.some(job => !job || typeof job !== "object" || !/^[0-9a-f-]{36}$/.test(job.id)
96
+ || !/^[0-9a-f]{64}$/.test(job.requestKey) || !/^[0-9a-f]{64}$/.test(job.payloadHash)
97
+ || !/^[0-9a-f-]{36}$/.test(job.generation) || !Number.isSafeInteger(job.revision) || job.revision < 0
98
+ || !["queued", "running", "applied", "not_applied", "refused", "ambiguous"].includes(job.status)
99
+ || typeof job.planId !== "string" || !/^[0-9a-f]{32}$/.test(job.planId)
100
+ || (job.reason !== null && (typeof job.reason !== "string" || !SAFE_REASONS.has(job.reason)))
101
+ || !Array.isArray(job.cleanupErrors) || job.cleanupErrors.length > 8
102
+ || job.cleanupErrors.some((item: unknown) => typeof item !== "string" || !CODEX_CLI_JOB_CLEANUP_ERRORS.has(item))
103
+ || typeof job.leaseRetained !== "boolean"
104
+ || typeof job.createdAt !== "string" || typeof job.updatedAt !== "string")) throw new Error("invalid_store");
105
+ return value;
106
+ }
107
+ function readStore(configDir?: string): Store {
108
+ let p: ReturnType<typeof paths>;
109
+ try { p = prepare(configDir); }
110
+ catch (error) { if ((error as NodeJS.ErrnoException).code === "ENOENT") return { version: 1, jobs: [] }; throw error; }
111
+ let fd: number | undefined;
112
+ try {
113
+ fd = openSync(p.file, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
114
+ const stat = fstatSync(fd);
115
+ if (!stat.isFile() || stat.size > CODEX_CLI_JOB_STORE_MAX_BYTES || (stat.mode & 0o077) !== 0
116
+ || stat.uid !== process.geteuid?.() || stat.nlink !== 1) throw new Error("unsafe_store");
117
+ const lexical = lstatSync(p.file);
118
+ if (lexical.isSymbolicLink() || lexical.dev !== stat.dev || lexical.ino !== stat.ino) throw new Error("unsafe_store");
119
+ const bytes = Buffer.alloc(CODEX_CLI_JOB_STORE_MAX_BYTES + 1);
120
+ const length = readSync(fd, bytes, 0, bytes.length, 0);
121
+ if (length > CODEX_CLI_JOB_STORE_MAX_BYTES) throw new Error("unsafe_store");
122
+ return parseStoreBody(bytes.subarray(0, length).toString("utf8"));
123
+ } finally { if (fd !== undefined) closeSync(fd); }
124
+ }
125
+ function rollbackInitializingLock(p: ReturnType<typeof paths>, lockIdentity: { dev: number; ino: number }, ownerIdentity?: { dev: number; ino: number }) {
126
+ try {
127
+ const ownsDirectory = () => {
128
+ const stat = lstatSync(p.lock);
129
+ return stat.isDirectory() && !stat.isSymbolicLink() && stat.dev === lockIdentity.dev && stat.ino === lockIdentity.ino
130
+ && stat.uid === process.geteuid?.() && (stat.mode & 0o077) === 0 && realpathSync.native(p.lock) === p.lock;
131
+ };
132
+ if (!ownsDirectory()) return;
133
+ if (ownerIdentity) {
134
+ const owner = join(p.lock, "owner.json");
135
+ const fd = openSync(owner, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
136
+ try {
137
+ const stat = fstatSync(fd), lexical = lstatSync(owner);
138
+ if (!stat.isFile() || stat.uid !== process.geteuid?.() || stat.nlink !== 1 || (stat.mode & 0o077) !== 0
139
+ || stat.dev !== ownerIdentity.dev || stat.ino !== ownerIdentity.ino || lexical.isSymbolicLink()
140
+ || lexical.dev !== stat.dev || lexical.ino !== stat.ino || !ownsDirectory()) return;
141
+ } finally { closeSync(fd); }
142
+ unlinkSync(owner);
143
+ }
144
+ // This call created the directory. Never remove a replacement or nonempty lock.
145
+ if (ownsDirectory()) rmdirSync(p.lock);
146
+ } catch { /* Unprovable initialization ownership stays fail-closed. */ }
147
+ }
148
+ /**
149
+ * POSIX admission mutex. Acquisition and release stay synchronous; the ledger body
150
+ * may await, so the lock directory is held until fn settles rather than until it returns.
151
+ */
152
+ async function withLock<T>(configDir: string | undefined, fn: (p: ReturnType<typeof paths>) => T | Promise<T>, createConfigRoot = false): Promise<T> {
153
+ const p = prepare(configDir, true, createConfigRoot);
154
+ let lockIdentity: { dev: number; ino: number } | undefined;
155
+ let ownerIdentity: { dev: number; ino: number } | undefined;
156
+ const owner = join(p.lock, "owner.json");
157
+ const record = JSON.stringify({ version: 1, token: randomUUID() });
158
+ try {
159
+ try { mkdirSync(p.lock, { mode: 0o700 }); }
160
+ catch (error) {
161
+ if ((error as NodeJS.ErrnoException).code === "EEXIST") throw new CodexCliJobStoreBusyError();
162
+ throw error;
163
+ }
164
+ const lockStat = lstatSync(p.lock);
165
+ if (!lockStat.isDirectory() || lockStat.isSymbolicLink() || lockStat.uid !== process.geteuid?.()
166
+ || (lockStat.mode & 0o077) !== 0 || realpathSync.native(p.lock) !== p.lock) throw new Error("unsafe_store");
167
+ lockIdentity = { dev: lockStat.dev, ino: lockStat.ino };
168
+ try {
169
+ const fd = openSync(owner, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
170
+ try { ownerIdentity = fstatSync(fd); writeFileSync(fd, record); fsyncSync(fd); } finally { closeSync(fd); }
171
+ } catch (error) {
172
+ rollbackInitializingLock(p, lockIdentity, ownerIdentity);
173
+ lockIdentity = undefined;
174
+ throw error;
175
+ }
176
+ return await fn(p);
177
+ } finally {
178
+ if (lockIdentity && ownerIdentity) {
179
+ try {
180
+ const dir = lstatSync(p.lock);
181
+ const fd = openSync(owner, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
182
+ try {
183
+ const stat = fstatSync(fd);
184
+ if (dir.dev === lockIdentity.dev && dir.ino === lockIdentity.ino && stat.isFile()
185
+ && stat.size <= 1024 && stat.uid === process.geteuid?.() && stat.nlink === 1
186
+ && stat.dev === ownerIdentity.dev && stat.ino === ownerIdentity.ino
187
+ && readFileSync(fd, "utf8") === record) {
188
+ unlinkSync(owner); rmdirSync(p.lock);
189
+ }
190
+ } finally { closeSync(fd); }
191
+ } catch { /* Fail closed; a leftover lock blocks future admission. */ }
192
+ }
193
+ }
194
+ }
195
+ function writeStore(p: ReturnType<typeof paths>, store: Store) {
196
+ const body = JSON.stringify(store);
197
+ if (Buffer.byteLength(body) > CODEX_CLI_JOB_STORE_MAX_BYTES) throw new Error("store_full");
198
+ const temp = join(p.dir, `.jobs-${randomUUID()}.tmp`);
199
+ let fd: number | undefined;
200
+ try {
201
+ fd = openSync(temp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
202
+ writeFileSync(fd, body); fsyncSync(fd); closeSync(fd); fd = undefined;
203
+ renameSync(temp, p.file);
204
+ const dirFd = openSync(p.dir, constants.O_RDONLY);
205
+ try { fsyncSync(dirFd); } finally { closeSync(dirFd); }
206
+ } finally {
207
+ if (fd !== undefined) closeSync(fd);
208
+ try { unlinkSync(temp); } catch { /* already renamed */ }
209
+ }
210
+ }
211
+ function validStore(configDir?: string): Store {
212
+ try { return readStore(configDir); }
213
+ catch (error) {
214
+ if ((error as NodeJS.ErrnoException).code === "ENOENT") return { version: 1, jobs: [] };
215
+ throw error;
216
+ }
217
+ }
218
+ type LifecycleInput = Pick<StoredJob, "status" | "outcome" | "reason" | "cleanupErrors" | "leaseRetained"> & { active: boolean };
219
+ type LifecycleProjection = Pick<CodexCliUpdateJobDto, "status" | "ownerState" | "lifetimeUncertain" | "childState" | "leaseState" | "outcome" | "reason">;
220
+
221
+ /** Project only states supported by persisted evidence; retention booleans alone are ambiguous. */
222
+ export function projectCodexCliUpdateJobLifecycle(job: LifecycleInput): LifecycleProjection {
223
+ const ownerUnknown = job.status === "queued" || job.status === "running" ? !job.active : false;
224
+ const uncertain = ownerUnknown || job.outcome === "ambiguous";
225
+ const leaseReleaseUnconfirmed = job.cleanupErrors.some(error =>
226
+ error === "lease_release_unverified" || error === "lease_release_exception");
227
+ const retainedWithEvidence = job.leaseRetained && !leaseReleaseUnconfirmed
228
+ && (job.reason === "installer_state_unknown" || job.reason === "version_process_state_unknown"
229
+ || job.reason === "installer_or_readback_error" || job.reason === "child_cleanup_unverified");
230
+ const childUnknown = ownerUnknown || job.reason === "job_result_unknown"
231
+ || job.reason === "installer_state_unknown" || job.reason === "version_process_state_unknown"
232
+ || (job.reason === "installer_or_readback_error" && job.leaseRetained);
233
+ const childState = childUnknown ? "unknown" : job.status === "queued" || job.outcome === "refused" ? "not_started"
234
+ : job.status === "running" ? "active_or_not_observed" : "terminal";
235
+ const leaseState = ownerUnknown || job.status === "queued" || job.status === "running"
236
+ || job.reason === "job_result_unknown" || leaseReleaseUnconfirmed ? "unknown"
237
+ : retainedWithEvidence ? "retained" : job.leaseRetained ? "unknown" : "not_acquired_or_released";
238
+ return Object.freeze({ status: uncertain ? "ambiguous" : job.status,
239
+ ownerState: job.active ? "active" : ownerUnknown ? "unknown" : "finished", lifetimeUncertain: uncertain,
240
+ childState, leaseState, outcome: ownerUnknown ? "ambiguous" : job.outcome,
241
+ reason: ownerUnknown ? "owner_state_unknown" : job.reason });
242
+ }
243
+
244
+ function dto(job: StoredJob): CodexCliUpdateJobDto {
245
+ const lifecycle = projectCodexCliUpdateJobLifecycle({ ...job, active: live.get(job.id) === job.generation });
246
+ return Object.freeze({ jobId: job.id, ...lifecycle,
247
+ createdAt: job.createdAt, updatedAt: job.updatedAt, planId: job.planId,
248
+ cleanupErrors: Object.freeze([...job.cleanupErrors]) });
249
+ }
250
+
251
+ /**
252
+ * Platform ledger primitives behind one admission lock. The POSIX branch wraps the
253
+ * synchronous fs helpers; the Windows branch binds the handle-pinned backend in
254
+ * cli-update-job-store-windows.ts. Every lifecycle rule below is written once
255
+ * against this surface so both backends project the identical DTO.
256
+ */
257
+ interface LedgerIo {
258
+ readStore(): Promise<Store>;
259
+ writeStore(store: Store): Promise<void>;
260
+ }
261
+
262
+ /**
263
+ * One admission lock, one store body. The Windows backend loads lazily so the
264
+ * FFI-bearing module stays out of the POSIX import graph.
265
+ */
266
+ async function withLedgerLock<T>(configDir: string | undefined, createConfigRoot: boolean,
267
+ fn: (io: LedgerIo) => Promise<T>): Promise<T> {
268
+ if (process.platform === "win32") {
269
+ const { withWindowsJobStoreLock } = await import("./cli-update-job-store-windows");
270
+ return withWindowsJobStoreLock(configDir, createConfigRoot, io => fn({
271
+ readStore: async () => parseStoreBody(await io.readStore()),
272
+ writeStore: async store => { await io.writeStore(JSON.stringify(store)); },
273
+ }));
274
+ }
275
+ return withLock(configDir, p => fn({
276
+ readStore: async () => validStore(configDir),
277
+ writeStore: async store => { writeStore(p, store); },
278
+ }), createConfigRoot);
279
+ }
280
+
281
+ /** Lock-free status read through the platform backend. */
282
+ async function readLedgerStore(configDir?: string): Promise<Store> {
283
+ if (process.platform === "win32") {
284
+ const { readWindowsJobStore } = await import("./cli-update-job-store-windows");
285
+ return parseStoreBody(await readWindowsJobStore(configDir));
286
+ }
287
+ return readStore(configDir);
288
+ }
289
+
290
+ export async function readCodexCliUpdateJob(jobId: string, configDir?: string): Promise<CodexCliUpdateJobDto | null> {
291
+ if (!/^[0-9a-f-]{36}$/.test(jobId)) return null;
292
+ const job = (await readLedgerStore(configDir)).jobs.find(item => item.id === jobId);
293
+ return job ? dto(job) : null;
294
+ }
295
+
296
+ /** Persist dedupe admission before returning; a duplicate key never schedules a second installer. */
297
+ export async function admitCodexCliUpdateJob(input: { requestId: string; planId: string; confirmed: true; configDir?: string }):
298
+ Promise<{ kind: "accepted" | "duplicate"; job: CodexCliUpdateJobDto; generation: string }> {
299
+ if (input.confirmed !== true || !/^[A-Za-z0-9._:-]{8,128}$/.test(input.requestId)
300
+ || !/^[0-9a-f]{32}$/.test(input.planId)) throw new Error("invalid_request");
301
+ const requestKey = digest(input.requestId);
302
+ const payloadHash = digest(JSON.stringify({ planId: input.planId }));
303
+ return withLedgerLock(input.configDir, true, async io => {
304
+ const store = await io.readStore();
305
+ const existing = store.jobs.find(job => job.requestKey === requestKey);
306
+ if (existing) {
307
+ if (existing.payloadHash !== payloadHash) throw new Error("idempotency_conflict");
308
+ return { kind: "duplicate", job: dto(existing), generation: existing.generation };
309
+ }
310
+ if (store.jobs.length >= MAX_JOBS) throw new Error("store_full");
311
+ const stamp = now();
312
+ const record: StoredJob = { id: randomUUID(), requestKey, payloadHash, generation: randomUUID(), revision: 0,
313
+ status: "queued", createdAt: stamp, updatedAt: stamp, planId: input.planId, outcome: null,
314
+ reason: null, cleanupErrors: [], leaseRetained: false };
315
+ store.jobs.push(record); await io.writeStore(store);
316
+ live.set(record.id, record.generation);
317
+ return { kind: "accepted", job: dto(record), generation: record.generation };
318
+ });
319
+ }
320
+
321
+ /** Updates are generation/revision fenced so an old worker cannot replace a newer state. */
322
+ export async function finishCodexCliUpdateJob(jobId: string, generation: string, expectedRevision: number,
323
+ result: CodexCliApplyResult, configDir?: string): Promise<CodexCliUpdateJobDto | null> {
324
+ return withLedgerLock(configDir, false, async io => {
325
+ const store = await io.readStore();
326
+ const index = store.jobs.findIndex(job => job.id === jobId);
327
+ if (index < 0) return null;
328
+ const current = store.jobs[index]!;
329
+ const safe = normalizeCodexCliJobResult(result);
330
+ // A rename can succeed before a directory-fsync error. Retry the same
331
+ // completed revision while this generation still owns it, never the engine.
332
+ if (current.generation === generation && current.revision === expectedRevision + 1
333
+ && live.get(jobId) === generation && started.has(jobId)
334
+ && current.outcome === safe.outcome && current.reason === safe.reason
335
+ && current.leaseRetained === safe.leaseRetained
336
+ && JSON.stringify(current.cleanupErrors) === JSON.stringify(safe.cleanupErrors)) {
337
+ await io.writeStore(store); live.delete(jobId); started.delete(jobId); return dto(current);
338
+ }
339
+ if (current.generation !== generation || current.revision !== expectedRevision
340
+ || live.get(jobId) !== generation || !started.has(jobId)) return dto(current);
341
+ const next: StoredJob = { ...current, revision: current.revision + 1, status: safe.outcome,
342
+ outcome: safe.outcome, reason: safe.reason, cleanupErrors: safe.cleanupErrors, leaseRetained: safe.leaseRetained, updatedAt: now() };
343
+ store.jobs[index] = next; await io.writeStore(store); live.delete(jobId); started.delete(jobId);
344
+ return dto(next);
345
+ });
346
+ }
347
+
348
+ export async function runCodexCliUpdateJob(jobId: string, generation: string, run: () => Promise<CodexCliApplyResult>, configDir?: string): Promise<CodexCliUpdateJobDto | null> {
349
+ // Reserve this invocation before any asynchronous store admission/publication.
350
+ // A contender must never release the admitted generation while its owner yields.
351
+ const ownsExecution = live.get(jobId) === generation && !started.has(jobId);
352
+ if (ownsExecution) started.add(jobId);
353
+ return runCodexCliUpdateJobWork(run, {
354
+ begin: () => withLedgerLock(configDir, false, async io => {
355
+ const store = await io.readStore(); const index = store.jobs.findIndex(job => job.id === jobId);
356
+ if (index < 0 || store.jobs[index]!.generation !== generation) throw new Error("job_generation_changed");
357
+ if (!ownsExecution || live.get(jobId) !== generation) throw new Error("job_not_owned");
358
+ const current = store.jobs[index]!; const next = { ...current, revision: current.revision + 1, status: "running" as const, updatedAt: now() };
359
+ store.jobs[index] = next; await io.writeStore(store); return next.revision;
360
+ }),
361
+ finish: (revision, result) => finishCodexCliUpdateJob(jobId, generation, revision, result, configDir),
362
+ read: () => readCodexCliUpdateJob(jobId, configDir),
363
+ release: () => {
364
+ if (ownsExecution && live.get(jobId) === generation) {
365
+ live.delete(jobId); started.delete(jobId);
366
+ }
367
+ },
368
+ });
369
+ }
@@ -0,0 +1,71 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { closeSync, constants, fstatSync, lstatSync, mkdirSync, openSync, readFileSync,
3
+ realpathSync, rmdirSync, unlinkSync, writeFileSync } from "node:fs";
4
+ import { join } from "node:path";
5
+ import { assertTrustedCodexCliAncestry } from "./cli-update-paths";
6
+
7
+ export type CodexCliApplyLeaseResult = { readonly kind: "acquired"; release(): boolean }
8
+ | { readonly kind: "busy" | "prefix_unsupported" | "unavailable" };
9
+ /** Installation-unit mutex. No stale/empty-owner recovery and no token delegation. */
10
+ export function acquireCodexCliApplyLease(prefix: string): CodexCliApplyLeaseResult {
11
+ let fd: number | undefined;
12
+ let lockIdentity: { dev: number; ino: number } | undefined;
13
+ let ownerIdentity: { dev: number; ino: number } | undefined;
14
+ const path = join(prefix, ".ocx-codex-cli-apply.lock");
15
+ const owner = join(path, "owner.json");
16
+ const record = JSON.stringify({ version: 1, pid: process.pid, token: randomUUID() });
17
+ const release = () => {
18
+ let current: number | undefined;
19
+ let released = false;
20
+ try {
21
+ if (!lockIdentity || !ownerIdentity) return false;
22
+ const directory = lstatSync(path);
23
+ if (!directory.isDirectory() || directory.isSymbolicLink()
24
+ || directory.dev !== lockIdentity.dev || directory.ino !== lockIdentity.ino) return false;
25
+ current = openSync(owner, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
26
+ const identity = fstatSync(current);
27
+ if (!identity.isFile() || identity.size !== Buffer.byteLength(record)
28
+ || identity.dev !== ownerIdentity.dev || identity.ino !== ownerIdentity.ino
29
+ || readFileSync(current, "utf8") !== record) return false;
30
+ const lexical = lstatSync(owner);
31
+ if (lexical.isSymbolicLink() || lexical.dev !== identity.dev || lexical.ino !== identity.ino) return false;
32
+ unlinkSync(owner);
33
+ rmdirSync(path);
34
+ lockIdentity = undefined;
35
+ released = true;
36
+ } catch { return false; }
37
+ finally {
38
+ if (current !== undefined) { try { closeSync(current); } catch { released = false; } }
39
+ }
40
+ return released;
41
+ };
42
+ try {
43
+ try { assertTrustedCodexCliAncestry(prefix); }
44
+ catch { return { kind: "prefix_unsupported" }; }
45
+ const root = lstatSync(prefix);
46
+ if (!root.isDirectory() || root.isSymbolicLink() || realpathSync.native(prefix) !== prefix
47
+ || (root.mode & 0o022) !== 0 || root.uid !== process.geteuid?.()) return { kind: "prefix_unsupported" };
48
+ try { mkdirSync(path, { mode: 0o700 }); }
49
+ catch (error) {
50
+ if ((error as NodeJS.ErrnoException).code === "EEXIST") return { kind: "busy" };
51
+ throw error;
52
+ }
53
+ lockIdentity = lstatSync(path);
54
+ fd = openSync(owner, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
55
+ ownerIdentity = fstatSync(fd);
56
+ writeFileSync(fd, record);
57
+ const completed = fd;
58
+ fd = undefined;
59
+ closeSync(completed);
60
+ return { kind: "acquired", release };
61
+ } catch {
62
+ if (fd !== undefined) {
63
+ const owned = fd; fd = undefined;
64
+ try { closeSync(owned); } catch { return { kind: "unavailable" }; }
65
+ }
66
+ // Only a positively identified owner is eligible for cleanup. Empty or
67
+ // suspicious directories intentionally remain busy for operator inspection.
68
+ if (ownerIdentity) release();
69
+ return { kind: "unavailable" };
70
+ }
71
+ }
@@ -0,0 +1,76 @@
1
+ import { chmodSync, lstatSync, mkdtempSync, readdirSync, realpathSync, statSync } from "node:fs";
2
+ import { dirname, join, resolve } from "node:path";
3
+
4
+ /** Shared by durable admission, the installation lease and apply staging. */
5
+ export function assertTrustedCodexCliAncestry(path: string): void {
6
+ const uid = process.geteuid?.();
7
+ if (uid === undefined) throw new Error("untrusted_posix_path");
8
+ for (let current = resolve(path); ;) {
9
+ const stat = lstatSync(current);
10
+ if (!stat.isDirectory() || stat.isSymbolicLink() || realpathSync.native(current) !== current
11
+ || (stat.uid !== uid && stat.uid !== 0)
12
+ || ((stat.mode & 0o022) !== 0 && !(stat.uid === 0 && (stat.mode & 0o1000) !== 0))) {
13
+ throw new Error("untrusted_posix_path");
14
+ }
15
+ const parent = dirname(current);
16
+ if (parent === current) return;
17
+ current = parent;
18
+ }
19
+ }
20
+
21
+ type DirectoryIdentity = { dev: number; ino: number; uid: number; mode: number };
22
+ export type CodexCliMutationPaths = ReadonlyMap<string, DirectoryIdentity>;
23
+ const MAX_PATH_ENTRIES = 16_384;
24
+
25
+ /** npm can replace more than the two approved packages: validate all existing
26
+ * directories under the prefix, including bin, scopes and npm's rename parents.
27
+ * Absent directories are safe to create only below this protected namespace.
28
+ */
29
+ export function observeCodexCliMutationPaths(root: string): CodexCliMutationPaths {
30
+ assertTrustedCodexCliAncestry(root);
31
+ const directories = new Map<string, DirectoryIdentity>();
32
+ let entries = 0;
33
+ const walk = (path: string) => {
34
+ if (++entries > MAX_PATH_ENTRIES) throw new Error("untrusted_posix_path");
35
+ const stat = lstatSync(path);
36
+ // npm's executable links are files; directory links are never traversed.
37
+ if (stat.isSymbolicLink()) {
38
+ if (statSync(path).isDirectory()) throw new Error("untrusted_posix_path");
39
+ return;
40
+ }
41
+ if (!stat.isDirectory()) return;
42
+ if (realpathSync.native(path) !== path || (stat.uid !== process.geteuid?.() && stat.uid !== 0)
43
+ || (stat.mode & 0o022) !== 0) throw new Error("untrusted_posix_path");
44
+ directories.set(path, { dev: stat.dev, ino: stat.ino, uid: stat.uid, mode: stat.mode });
45
+ for (const entry of readdirSync(path)) walk(join(path, entry));
46
+ const after = lstatSync(path);
47
+ if (after.dev !== stat.dev || after.ino !== stat.ino || after.mode !== stat.mode || after.uid !== stat.uid) {
48
+ throw new Error("untrusted_posix_path");
49
+ }
50
+ };
51
+ walk(root);
52
+ return directories;
53
+ }
54
+
55
+ export function sameCodexCliMutationPaths(before: CodexCliMutationPaths, after: CodexCliMutationPaths): boolean {
56
+ return before.size === after.size && [...before].every(([path, identity]) => {
57
+ const next = after.get(path);
58
+ return next && identity.dev === next.dev && identity.ino === next.ino
59
+ && identity.uid === next.uid && identity.mode === next.mode;
60
+ });
61
+ }
62
+
63
+ /** Canonicalize the chosen root before creation. Root-owned sticky ancestors
64
+ * protect this same-owner, private child from other users' rename operations.
65
+ * Unsafe TMPDIR is an explicit refusal, never an ambient fallback.
66
+ */
67
+ export function createCodexCliApplyStaging(temporaryRoot: string): string {
68
+ const root = realpathSync.native(temporaryRoot);
69
+ assertTrustedCodexCliAncestry(root);
70
+ const stage = mkdtempSync(join(root, "ocx-codex-cli-apply-"));
71
+ chmodSync(stage, 0o700);
72
+ assertTrustedCodexCliAncestry(stage);
73
+ const stat = lstatSync(stage);
74
+ if (stat.uid !== process.geteuid?.() || (stat.mode & 0o077) !== 0) throw new Error("untrusted_posix_path");
75
+ return stage;
76
+ }