@bitkyc08/opencodex 2.93.0-preview.20261027 → 2.94.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (435) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-DmvwlhQq.js +58 -0
  4. package/gui/dist/assets/Tray-CZatQdoF.js +1 -0
  5. package/gui/dist/assets/index-3EPO_KbX.js +94 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/{quota-summary-DxToX1rV.js → quota-summary-BHvWg9mi.js} +1 -1
  8. package/gui/dist/index.html +2 -2
  9. package/gui/dist/provider-icons/t3code.svg +4 -0
  10. package/package.json +7 -4
  11. package/src/adapters/anthropic/account-metadata.ts +34 -3
  12. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  13. package/src/adapters/anthropic/passthrough.ts +5 -2
  14. package/src/adapters/anthropic.ts +17 -4
  15. package/src/adapters/antigravity-refusal.ts +29 -0
  16. package/src/adapters/base.ts +11 -1
  17. package/src/adapters/client-fingerprint.ts +43 -9
  18. package/src/adapters/coding-agent/protocol.ts +19 -9
  19. package/src/adapters/command-code.ts +4 -5
  20. package/src/adapters/cursor/catalog.ts +5 -3
  21. package/src/adapters/cursor/claude-id.ts +30 -19
  22. package/src/adapters/cursor/cursor-errors.ts +5 -2
  23. package/src/adapters/cursor/h2-pool.ts +9 -7
  24. package/src/adapters/cursor/http1-bidi.ts +1 -0
  25. package/src/adapters/cursor/live-models.ts +4 -2
  26. package/src/adapters/cursor.ts +4 -1
  27. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  28. package/src/adapters/google-antigravity-replay.ts +13 -2
  29. package/src/adapters/google-antigravity-wire.ts +8 -3
  30. package/src/adapters/google-errors.ts +33 -0
  31. package/src/adapters/google-http.ts +41 -16
  32. package/src/adapters/google-wire-compiler.ts +4 -0
  33. package/src/adapters/google.ts +21 -10
  34. package/src/adapters/kiro/adapter.ts +3 -0
  35. package/src/adapters/kiro/stream.ts +18 -13
  36. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  37. package/src/adapters/openai-chat/messages.ts +22 -10
  38. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  39. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  40. package/src/adapters/openai-chat/wire.ts +9 -0
  41. package/src/adapters/openai-chat.ts +18 -17
  42. package/src/adapters/openai-responses/image-gen.ts +15 -1
  43. package/src/adapters/openai-responses/passthrough.ts +11 -34
  44. package/src/adapters/openai-responses/transport.ts +20 -2
  45. package/src/adapters/openai-responses/usage.ts +34 -0
  46. package/src/adapters/qoder/adapter.ts +9 -15
  47. package/src/adapters/qoder/image-input.ts +52 -0
  48. package/src/adapters/unique-tool-call-ids.ts +2 -2
  49. package/src/adapters/zed-additional-tools.ts +51 -0
  50. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  51. package/src/adapters/zed-json-tokens.ts +166 -0
  52. package/src/adapters/zed-openai-stream.ts +723 -0
  53. package/src/adapters/zed-tool-arguments.ts +79 -0
  54. package/src/adapters/zed.ts +53 -3
  55. package/src/advisor/consult.ts +22 -0
  56. package/src/advisor/runtime.ts +3 -0
  57. package/src/bridge/errors.ts +22 -1
  58. package/src/bridge/response-json.ts +4 -1
  59. package/src/bridge/sse.ts +21 -12
  60. package/src/chat/inbound.ts +13 -2
  61. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  62. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +83 -0
  63. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  64. package/src/claude/desktop-first-party.ts +16 -5
  65. package/src/claude/desktop-gateway-state.ts +4 -0
  66. package/src/claude/inbound-tool-loading.ts +93 -0
  67. package/src/claude/intercept/picker-listener.ts +33 -1
  68. package/src/claude/model-info.ts +29 -4
  69. package/src/claude/outbound.ts +33 -13
  70. package/src/cli/account-main.ts +43 -5
  71. package/src/cli/capabilities-base.ts +22 -5
  72. package/src/cli/capabilities-integrations.ts +4 -4
  73. package/src/cli/claude-desktop.ts +139 -98
  74. package/src/cli/codex-cli-update.ts +102 -48
  75. package/src/cli/codex-launch-auth.ts +93 -0
  76. package/src/cli/codex-launch-command.ts +32 -0
  77. package/src/cli/codex-launch-diagnostics.ts +37 -0
  78. package/src/cli/codex-launch-ownership.ts +307 -0
  79. package/src/cli/codex-launch-policy.ts +84 -0
  80. package/src/cli/codex-launcher.ts +310 -0
  81. package/src/cli/codex-shim-autorestore.ts +2 -0
  82. package/src/cli/config-command.ts +9 -4
  83. package/src/cli/config-mutation.ts +13 -0
  84. package/src/cli/dispatch.ts +13 -7
  85. package/src/cli/effort.ts +19 -14
  86. package/src/cli/ensure-desired-integrations.ts +21 -14
  87. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  88. package/src/cli/export-command.ts +8 -4
  89. package/src/cli/help.ts +3 -1
  90. package/src/cli/index.ts +58 -64
  91. package/src/cli/integration-input.ts +12 -0
  92. package/src/cli/integration-plan-dto.ts +2 -0
  93. package/src/cli/integration-preview.ts +6 -3
  94. package/src/cli/integrations.ts +2 -1
  95. package/src/cli/link-cleanup.ts +8 -23
  96. package/src/cli/link-enrollment.ts +1 -4
  97. package/src/cli/link.ts +1 -1
  98. package/src/cli/loopback-family.ts +2 -31
  99. package/src/cli/models.ts +62 -49
  100. package/src/cli/provider.ts +146 -139
  101. package/src/cli/registry.ts +34 -3
  102. package/src/cli/root.ts +2 -0
  103. package/src/cli/start-owner-fence.ts +22 -3
  104. package/src/cli/status-link.ts +28 -0
  105. package/src/cli/status.ts +15 -0
  106. package/src/cli/stop-restore-guard.ts +48 -0
  107. package/src/cli/stop-restore.ts +117 -36
  108. package/src/cli/system-command.ts +2 -0
  109. package/src/cli/v2.ts +17 -4
  110. package/src/client/lifecycle-lock.ts +1 -1
  111. package/src/client/link-connection.ts +19 -0
  112. package/src/client/link-relay-transport.ts +25 -3
  113. package/src/client/link-tunnel.ts +10 -0
  114. package/src/client/machine-listener.ts +7 -1
  115. package/src/client/restore-ownership.ts +45 -0
  116. package/src/client/runtime.ts +13 -1
  117. package/src/client/state.ts +1 -1
  118. package/src/clients/client-ids.ts +7 -0
  119. package/src/clients/client-path.ts +13 -5
  120. package/src/clients/config-export/agent-clients.ts +3 -6
  121. package/src/clients/config-export/alias-selectors.ts +85 -0
  122. package/src/clients/config-export/contracts.ts +6 -25
  123. package/src/clients/config-export/dsh.ts +8 -1
  124. package/src/clients/config-export/model-metadata.ts +19 -0
  125. package/src/clients/config-export/model-names.ts +31 -0
  126. package/src/clients/config-export/qoder.ts +3 -11
  127. package/src/clients/config-export/t3code.ts +141 -0
  128. package/src/clients/config-export.ts +51 -15
  129. package/src/clients/gentle-shell-path.ts +3 -3
  130. package/src/codex/account-lifecycle.ts +27 -13
  131. package/src/codex/account-store.ts +32 -6
  132. package/src/codex/app-server-processes.ts +84 -1
  133. package/src/codex/auth-api/main-account-probe.ts +50 -11
  134. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  135. package/src/codex/auth-context.ts +45 -4
  136. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  137. package/src/codex/catalog/build-entries.ts +12 -13
  138. package/src/codex/catalog/bundled.ts +59 -9
  139. package/src/codex/catalog/derive-entry.ts +2 -0
  140. package/src/codex/catalog/gather-capture.ts +3 -0
  141. package/src/codex/catalog/metadata.ts +6 -5
  142. package/src/codex/catalog/model-hints.ts +36 -4
  143. package/src/codex/catalog/native-priority.ts +63 -0
  144. package/src/codex/catalog/provider-models.ts +20 -4
  145. package/src/codex/catalog/retained-sync.ts +1 -1
  146. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  147. package/src/codex/cli-install-provenance.ts +57 -29
  148. package/src/codex/cli-installation-identity.ts +1 -1
  149. package/src/codex/cli-installation-limits.ts +7 -0
  150. package/src/codex/cli-update-apply.ts +391 -0
  151. package/src/codex/cli-update-artifacts.ts +257 -0
  152. package/src/codex/cli-update-files.ts +100 -0
  153. package/src/codex/cli-update-inspection-context.ts +49 -0
  154. package/src/codex/cli-update-job-execution.ts +77 -0
  155. package/src/codex/cli-update-job-store-windows.ts +1010 -0
  156. package/src/codex/cli-update-job-worker.ts +393 -0
  157. package/src/codex/cli-update-job.ts +369 -0
  158. package/src/codex/cli-update-lease.ts +71 -0
  159. package/src/codex/cli-update-paths.ts +76 -0
  160. package/src/codex/cli-update-plan.ts +180 -47
  161. package/src/codex/cli-update-recovery.ts +236 -0
  162. package/src/codex/cli-update-selection-gate.ts +235 -0
  163. package/src/codex/cli-update-windows-apply.ts +308 -0
  164. package/src/codex/cli-update-windows-layout.ts +110 -0
  165. package/src/codex/cli-update-windows-observation.ts +91 -0
  166. package/src/codex/cli-update-windows-paths.ts +26 -0
  167. package/src/codex/cli-update-worker-recovery.ts +32 -0
  168. package/src/codex/cli-update-worker.ts +185 -0
  169. package/src/codex/cli-windows-plan-provenance.ts +250 -0
  170. package/src/codex/desktop-app-restart.ts +22 -3
  171. package/src/codex/exec-boundary.ts +208 -0
  172. package/src/codex/forward-transport-headers.ts +80 -0
  173. package/src/codex/history-job.ts +7 -0
  174. package/src/codex/history-provider.ts +5 -2
  175. package/src/codex/history-worker.ts +20 -1
  176. package/src/codex/inject/restore.ts +57 -25
  177. package/src/codex/internal/history-writer.ts +2 -1
  178. package/src/codex/mac-app-bundle.ts +52 -0
  179. package/src/codex/main-account.ts +161 -23
  180. package/src/codex/native-main-auth-temp.ts +3 -2
  181. package/src/codex/native-main-refresh-mode.ts +18 -3
  182. package/src/codex/native-profile-manager.ts +8 -6
  183. package/src/codex/native-profile-store.ts +9 -0
  184. package/src/codex/ocx-compaction-history.ts +3 -2
  185. package/src/codex/prompt-text-probe.ts +211 -69
  186. package/src/codex/quota.ts +9 -0
  187. package/src/codex/role-model-history.ts +253 -0
  188. package/src/codex/runtime.ts +120 -71
  189. package/src/codex/shim-overlay.ts +22 -3
  190. package/src/codex/shim-templates.ts +5 -2
  191. package/src/codex/shim-wrapper-write.ts +136 -0
  192. package/src/codex/shim.ts +24 -125
  193. package/src/codex/windows-cli-child-native.ts +119 -0
  194. package/src/codex/windows-cli-child-pipe.ts +87 -0
  195. package/src/codex/windows-cli-child.ts +260 -0
  196. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  197. package/src/codex/windows-cli-recovery.ts +39 -0
  198. package/src/codex/windows-installation-files.ts +52 -6
  199. package/src/codex/windows-npm-execution.ts +25 -0
  200. package/src/combos/failover.ts +84 -5
  201. package/src/combos/index.ts +1 -0
  202. package/src/combos/resolve.ts +60 -22
  203. package/src/config/atomic-write.ts +75 -22
  204. package/src/config/diagnostics.ts +18 -10
  205. package/src/config/live-reconcile.ts +11 -3
  206. package/src/config/owner-registry.ts +5 -4
  207. package/src/config/persist-unlocked.ts +34 -8
  208. package/src/config/persisted-mutation.ts +7 -0
  209. package/src/config/process-state.ts +9 -5
  210. package/src/config/removed-opencode-free-backup.ts +99 -0
  211. package/src/config/removed-opencode-free.ts +4 -8
  212. package/src/config/salvage.ts +1 -0
  213. package/src/config/schema/config-schema.ts +16 -1
  214. package/src/config/schema/leaf-validators.ts +15 -0
  215. package/src/config.ts +4 -4
  216. package/src/generated/compatibility-version.json +743 -315
  217. package/src/grok/inject.ts +2 -1
  218. package/src/grok/sync.ts +5 -2
  219. package/src/images/loop.ts +14 -5
  220. package/src/integrations/catalog-refresh.ts +1 -1
  221. package/src/integrations/hermes-refresh.ts +28 -0
  222. package/src/integrations/model-name-guard.ts +31 -0
  223. package/src/integrations/mutation-plan.ts +17 -4
  224. package/src/integrations/ownership.ts +3 -0
  225. package/src/integrations/registry.ts +10 -1
  226. package/src/integrations/state.ts +6 -0
  227. package/src/integrations/writer.ts +64 -59
  228. package/src/lib/abort.ts +8 -4
  229. package/src/lib/bounded-body.ts +7 -1
  230. package/src/lib/config-ownership.ts +4 -0
  231. package/src/lib/errors.ts +2 -0
  232. package/src/lib/eventstream-decoder.ts +3 -2
  233. package/src/lib/http-response-semantics.ts +9 -6
  234. package/src/lib/inbound-body-policy.ts +11 -0
  235. package/src/lib/jsonc.ts +7 -2
  236. package/src/lib/local-management-capability.ts +3 -1
  237. package/src/lib/local-upstream.ts +22 -26
  238. package/src/lib/loopback-family.ts +31 -0
  239. package/src/lib/plain-data.ts +7 -5
  240. package/src/lib/process-control.ts +30 -5
  241. package/src/lib/shadow-call.ts +55 -1
  242. package/src/lib/tool-argument-integers.ts +99 -7
  243. package/src/lib/upstream-retry.ts +6 -1
  244. package/src/lib/windows-elevation.ts +34 -11
  245. package/src/lib/windows-owner-acl.ts +272 -32
  246. package/src/lib/windows-secret-acl.ts +310 -44
  247. package/src/lib/windows-service-wrappers.ts +10 -7
  248. package/src/lib/winsw.ts +8 -4
  249. package/src/link/relay-auth.ts +38 -1
  250. package/src/link/remote-platform.ts +11 -23
  251. package/src/link/remote-probe.ts +3 -1
  252. package/src/link/remote-windows.ts +150 -0
  253. package/src/link/ssh-argv.ts +13 -5
  254. package/src/link/store.ts +4 -1
  255. package/src/link/supervisor.ts +9 -0
  256. package/src/local-credentials/generation.ts +238 -0
  257. package/src/local-credentials/inventory.ts +281 -0
  258. package/src/local-credentials/observation-lease.ts +83 -0
  259. package/src/local-credentials/publication-fence.ts +81 -0
  260. package/src/local-credentials/references.ts +36 -0
  261. package/src/local-credentials/runtime-observation.ts +28 -0
  262. package/src/oauth/account-auto-pause-policy.ts +11 -0
  263. package/src/oauth/anthropic-account-refusal.ts +1 -0
  264. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  265. package/src/oauth/anthropic-routing.ts +34 -44
  266. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  267. package/src/oauth/chatgpt.ts +11 -9
  268. package/src/oauth/cursor.ts +8 -2
  269. package/src/oauth/generic-account-failover.ts +33 -2
  270. package/src/oauth/generic-session-affinity.ts +7 -0
  271. package/src/oauth/google-antigravity.ts +29 -5
  272. package/src/oauth/index.ts +1 -0
  273. package/src/oauth/store.ts +32 -4
  274. package/src/protocols/encoders/adapter-events.ts +7 -4
  275. package/src/protocols/encoders/messages.ts +1 -1
  276. package/src/providers/antigravity-account-roster.ts +73 -7
  277. package/src/providers/antigravity-models.ts +8 -4
  278. package/src/providers/api-key-resolve.ts +16 -3
  279. package/src/providers/claude-cli-identity.ts +2 -0
  280. package/src/providers/codex-capacity.ts +3 -2
  281. package/src/providers/free-directory.ts +10 -2
  282. package/src/providers/key-store.ts +7 -2
  283. package/src/providers/provider-id-rewrite.ts +3 -0
  284. package/src/providers/quota/antigravity.ts +6 -4
  285. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  286. package/src/providers/stale-model-roster-migration.ts +3 -0
  287. package/src/quota-pool/assemble.ts +51 -21
  288. package/src/quota-pool/pooled.ts +162 -0
  289. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  290. package/src/responses/apply-patch-envelope.ts +35 -0
  291. package/src/responses/compaction-history-framing.ts +15 -4
  292. package/src/responses/turn-membership.ts +111 -0
  293. package/src/server/advisor-admission-scope.ts +43 -0
  294. package/src/server/audio-upstream.ts +10 -2
  295. package/src/server/auth-cors.ts +23 -0
  296. package/src/server/bind-host.ts +5 -0
  297. package/src/server/chat-completions.ts +17 -2
  298. package/src/server/chat-native.ts +16 -11
  299. package/src/server/claude-messages.ts +9 -1
  300. package/src/server/codex-model-list.ts +46 -0
  301. package/src/server/gui-session.ts +5 -2
  302. package/src/server/inbound-body-admission.ts +21 -13
  303. package/src/server/inbound-body-budget.ts +128 -0
  304. package/src/server/index/link-listener.ts +3 -1
  305. package/src/server/index/link-relay-sessions.ts +9 -2
  306. package/src/server/index/optional-listeners.ts +1 -0
  307. package/src/server/index/serve-options.ts +9 -43
  308. package/src/server/index/websocket-handler.ts +7 -0
  309. package/src/server/index.ts +6 -5
  310. package/src/server/inference/client-encoder-delivery.ts +3 -1
  311. package/src/server/lifecycle.ts +8 -1
  312. package/src/server/management/advisor-routes.ts +26 -9
  313. package/src/server/management/agent-settings-routes.ts +424 -543
  314. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  315. package/src/server/management/claude-code-settings-patch.ts +211 -0
  316. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  317. package/src/server/management/codex-agent-role-routes.ts +79 -2
  318. package/src/server/management/codex-cli-update-routes.ts +55 -0
  319. package/src/server/management/codex-prompt-routes.ts +2 -1
  320. package/src/server/management/config-routes.ts +444 -380
  321. package/src/server/management/consent-session.ts +6 -0
  322. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  323. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  324. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  325. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  326. package/src/server/management/integration-routes.ts +45 -5
  327. package/src/server/management/link-enrollment.ts +21 -32
  328. package/src/server/management/link-route-state.ts +1 -0
  329. package/src/server/management/link-routes.ts +4 -1
  330. package/src/server/management/model-routes.ts +22 -6
  331. package/src/server/management/model-rows.ts +3 -1
  332. package/src/server/management/native-integration-routes.ts +90 -38
  333. package/src/server/management/oauth-account-routes.ts +8 -7
  334. package/src/server/management/route-registry.ts +8 -3
  335. package/src/server/management/session-routes.ts +20 -2
  336. package/src/server/management/shadow-call-validation.ts +43 -2
  337. package/src/server/management/sidebar-routes.ts +2 -1
  338. package/src/server/management/system-restart.ts +47 -7
  339. package/src/server/management-api.ts +61 -51
  340. package/src/server/management-auth.ts +11 -3
  341. package/src/server/messages-native.ts +21 -7
  342. package/src/server/messages-shared.ts +110 -18
  343. package/src/server/persistent-gui-session.ts +155 -0
  344. package/src/server/port-reclaim.ts +29 -5
  345. package/src/server/proxy-liveness.ts +110 -33
  346. package/src/server/request-decompress.ts +5 -1
  347. package/src/server/responses/account-change-state.ts +14 -2
  348. package/src/server/responses/adapter-continuation.ts +5 -4
  349. package/src/server/responses/adapter-delivery.ts +20 -5
  350. package/src/server/responses/adapter-dispatch.ts +39 -45
  351. package/src/server/responses/advisor-plan-slot.ts +3 -0
  352. package/src/server/responses/advisor-slot.ts +4 -2
  353. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  354. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  355. package/src/server/responses/combo-required-tool-contract.ts +2 -1
  356. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  357. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  358. package/src/server/responses/combo-stream-preflight.ts +47 -7
  359. package/src/server/responses/compact.ts +14 -7
  360. package/src/server/responses/compaction-recovery.ts +2 -1
  361. package/src/server/responses/core-auth.ts +2 -1
  362. package/src/server/responses/core-codex-account.ts +1 -0
  363. package/src/server/responses/core-combo-failure.ts +11 -6
  364. package/src/server/responses/core-combo-native.ts +6 -5
  365. package/src/server/responses/core-combo.ts +93 -20
  366. package/src/server/responses/core-options.ts +7 -0
  367. package/src/server/responses/fetch-helpers.ts +5 -1
  368. package/src/server/responses/jev-model-invoke.ts +8 -3
  369. package/src/server/responses/memory-models.ts +3 -2
  370. package/src/server/responses/passthrough-delivery.ts +36 -8
  371. package/src/server/responses/passthrough-dispatch.ts +12 -12
  372. package/src/server/responses/request-prepare.ts +10 -1
  373. package/src/server/responses/request-transport.ts +41 -6
  374. package/src/server/responses/run-turn-execution.ts +11 -3
  375. package/src/server/responses/sidecar-execution.ts +5 -0
  376. package/src/server/responses/turn-membership.ts +30 -0
  377. package/src/server/responses-custom-tool-repair.ts +86 -11
  378. package/src/server/responses-image-gen-repair.ts +1 -1
  379. package/src/server/restart-parent-ownership.ts +49 -0
  380. package/src/server/stop-teardown.ts +46 -9
  381. package/src/server/windows-tcp-drop.ts +4 -2
  382. package/src/service/desktop-recovery-process.ts +341 -0
  383. package/src/service/desktop-recovery.ts +172 -0
  384. package/src/service/windows-ops.ts +6 -3
  385. package/src/service/windows-scheduler.ts +29 -6
  386. package/src/stall-timeout.ts +47 -0
  387. package/src/tray/windows.ts +6 -4
  388. package/src/types/config.ts +61 -10
  389. package/src/types/request.ts +1 -1
  390. package/src/types.ts +1 -0
  391. package/src/update/async-check.ts +4 -3
  392. package/src/update/bind-probe.ts +2 -2
  393. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  394. package/src/update/guarded-port-reclaim.ts +14 -0
  395. package/src/update/guarded-runtime-ops.ts +58 -0
  396. package/src/update/guarded-tray-ops.ts +9 -0
  397. package/src/update/index.ts +196 -58
  398. package/src/update/job-pinned-start.ts +53 -0
  399. package/src/update/job-supervised-restart.ts +23 -6
  400. package/src/update/job-update-home.ts +62 -0
  401. package/src/update/job-update-tray.ts +29 -0
  402. package/src/update/job-windows-restart.ts +39 -0
  403. package/src/update/job.ts +179 -193
  404. package/src/update/mutation-guard.d.mts +30 -0
  405. package/src/update/mutation-guard.mjs +103 -0
  406. package/src/update/notify.ts +2 -2
  407. package/src/update/npm-cache-preflight.mjs +4 -4
  408. package/src/update/npm-install.mjs +5 -3
  409. package/src/update/pnpm-read-policy.mjs +3 -2
  410. package/src/update/proxy-liveness-probe.mjs +2 -2
  411. package/src/update/service-home-authority.ts +35 -0
  412. package/src/update/service-home-package-only-protocol.json +1 -0
  413. package/src/update/service-home-policy.d.mts +25 -0
  414. package/src/update/service-home-policy.mjs +112 -0
  415. package/src/update/service-home-probe-entry.ts +9 -0
  416. package/src/update/service-home-probe.d.mts +15 -0
  417. package/src/update/service-home-probe.mjs +79 -0
  418. package/src/update/service-home-protocol.json +1 -0
  419. package/src/update/supervised-recovery.d.mts +2 -2
  420. package/src/update/supervised-recovery.mjs +14 -7
  421. package/src/update/transactional-install.d.mts +3 -1
  422. package/src/update/transactional-install.mjs +29 -19
  423. package/src/update/update-failure-guidance.mjs +1 -1
  424. package/src/update/worker-launch.ts +3 -3
  425. package/src/vision/anthropic-describe.ts +2 -1
  426. package/src/web-search/anthropic-executor.ts +2 -1
  427. package/src/web-search/anthropic-history.ts +1 -0
  428. package/src/web-search/format-result.ts +3 -2
  429. package/src/web-search/header-deadline.ts +3 -2
  430. package/src/web-search/loop.ts +10 -4
  431. package/src/web-search/parse.ts +191 -38
  432. package/gui/dist/assets/App-CJZoq-uF.js +0 -58
  433. package/gui/dist/assets/Tray-BWQPcgZn.js +0 -1
  434. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
  435. package/gui/dist/assets/index-Xfct8owH.js +0 -94
@@ -0,0 +1,208 @@
1
+ import { accessSync, constants, statSync } from "node:fs";
2
+ import { posix } from "node:path";
3
+ import { codexExecInvocation } from "./exec-invocation";
4
+ import type { SpawnInvocation } from "../lib/win-exec";
5
+ import { macCodexAppBundleFor, realpathOrNull } from "./mac-app-bundle";
6
+ import {
7
+ untrustedChatgptBundleReason,
8
+ untrustedChatgptBundleReasonAsync,
9
+ } from "../chatgpt/app-server-shim/bundle-trust";
10
+
11
+ /**
12
+ * macOS execution-boundary trust for a resolved Codex target.
13
+ *
14
+ * Discovery and the resolver memo answer "which command would we run"; they are
15
+ * deliberately exec-free and never prove trust. Every actual spawn/exec of a
16
+ * Codex binary goes through this module instead: on darwin the command is
17
+ * resolved with real execvp semantics (empty PATH segment = spawn cwd,
18
+ * relative PATH entries resolve against that cwd, a slash in the command makes
19
+ * it cwd/absolute-relative and PATH is skipped), classified by the shared
20
+ * known-Codex-bundle classifier, and — when the lexical or canonical path sits
21
+ * inside a ChatGPT.app or Codex.app bundle at any location — checked by the shared
22
+ * signature/ownership policy before the same canonical target is returned for
23
+ * execution. Anything else, including binaries inside third-party app bundles,
24
+ * is passed through to the shared launcher unchanged.
25
+ *
26
+ * The check is one-shot per invocation and deliberately not memoized:
27
+ * directory-service group membership, signature state, and directory-entry
28
+ * ownership can change between resolve and exec, so a cached "trusted" answer
29
+ * would invent a trust lifetime the platform does not provide.
30
+ */
31
+ export class CodexExecTrustError extends Error {
32
+ readonly reason: string;
33
+ readonly code = "CODEX_EXEC_UNTRUSTED";
34
+ constructor(reason: string) {
35
+ super("untrusted Codex exec target: " + reason);
36
+ this.name = "CodexExecTrustError";
37
+ this.reason = reason;
38
+ }
39
+ }
40
+
41
+ /** Default execvp search path on darwin when the spawn env carries no PATH (_CS_PATH). */
42
+ const DARWIN_DEFAULT_PATH = "/usr/bin:/bin:/usr/sbin:/sbin";
43
+
44
+ export interface CodexExecBoundaryDeps {
45
+ /** Spawn environment; PATH resolution uses exactly this list. */
46
+ env?: NodeJS.ProcessEnv;
47
+ platform?: NodeJS.Platform;
48
+ /** Working directory the spawn will use; empty/relative PATH segments resolve against it. */
49
+ cwd?: string;
50
+ /** Existence probe: win32 passthrough PATH resolution and POSIX EACCES classification. */
51
+ exists?: (path: string) => boolean;
52
+ /** POSIX spawnability predicate: regular file + X_OK. */
53
+ executable?: (path: string) => boolean;
54
+ /** Canonicalizer; returns null when the path cannot be resolved. */
55
+ realpath?: (path: string) => string | null;
56
+ macBundleTrustReason?: (bundleRoot: string, binary: string) => string | null;
57
+ }
58
+
59
+ export interface CodexExecBoundaryAsyncDeps extends Omit<CodexExecBoundaryDeps, "macBundleTrustReason"> {
60
+ signal?: AbortSignal;
61
+ /**
62
+ * Async twin of the sync trust check. It MUST honor the forwarded signal:
63
+ * once aborted it settles promptly, and any children it owns (dscl/codesign)
64
+ * are killed and reaped before it settles - the boundary awaits it, so a
65
+ * check that ignores the signal stalls the caller; one that abandons its
66
+ * children leaks processes.
67
+ */
68
+ macBundleTrustReasonAsync?: (bundleRoot: string, binary: string, signal?: AbortSignal) => Promise<string | null>;
69
+ }
70
+
71
+ /** Same contract as workspace-executable's candidate check: regular file and executable bit. */
72
+ function executableTarget(path: string): boolean {
73
+ try {
74
+ if (!statSync(path).isFile()) return false;
75
+ accessSync(path, constants.X_OK);
76
+ return true;
77
+ } catch {
78
+ return false;
79
+ }
80
+ }
81
+
82
+ function spawnError(command: string, code: "ENOENT" | "EACCES"): Error {
83
+ return Object.assign(new Error("spawn " + command + " " + code), { code });
84
+ }
85
+
86
+ /** Non-executability alone must not masquerade as "not found"; existence is probed separately. */
87
+ function existsTarget(path: string, deps: CodexExecBoundaryDeps): boolean {
88
+ if (deps.exists) { try { return deps.exists(path); } catch { return false; } }
89
+ try { statSync(path); return true; } catch { return false; }
90
+ }
91
+
92
+ /** execvp-style PATH resolution: first executable regular file wins; empty segment means cwd. */
93
+ function resolveDarwinExecPath(command: string, deps: CodexExecBoundaryDeps): { path: string } | { error: Error } {
94
+ const env = deps.env ?? process.env;
95
+ const cwd = deps.cwd ?? process.cwd();
96
+ const executable = deps.executable ?? executableTarget;
97
+ const dirOf = (segment: string): string =>
98
+ segment === "" ? cwd : segment.startsWith("/") ? segment : posix.resolve(cwd, segment);
99
+ if (command.includes("/")) {
100
+ const candidate = dirOf(command);
101
+ if (executable(candidate)) return { path: candidate };
102
+ return { error: spawnError(command, existsTarget(candidate, deps) ? "EACCES" : "ENOENT") };
103
+ }
104
+ const pathValue = env.PATH === undefined ? DARWIN_DEFAULT_PATH : env.PATH;
105
+ let denied = false;
106
+ for (const segment of pathValue.split(":")) {
107
+ const candidate = dirOf(segment) + "/" + command;
108
+ if (executable(candidate)) return { path: candidate };
109
+ if (existsTarget(candidate, deps)) denied = true;
110
+ }
111
+ return { error: spawnError(command, denied ? "EACCES" : "ENOENT") };
112
+ }
113
+
114
+ /**
115
+ * Canonical (bundleRoot, binary) pair when the resolved path classifies into a
116
+ * known Codex desktop bundle, else null. The pair is always consistent:
117
+ * both halves are canonicalized together so a symlinked HOME or a PATH alias
118
+ * cannot split the containment check, and a bundle member that cannot be
119
+ * canonicalized refuses rather than escaping the known-bundle classification.
120
+ */
121
+ function darwinBundleTarget(resolved: string, deps: CodexExecBoundaryDeps): { bundle: string; binary: string } | null {
122
+ const realpath = deps.realpath ?? realpathOrNull;
123
+ const bundle = macCodexAppBundleFor(resolved, { env: deps.env, platform: deps.platform, realpath });
124
+ if (!bundle) return null;
125
+ const binary = realpath(resolved);
126
+ if (binary === null) throw new CodexExecTrustError("cannot canonicalize the app-bundle exec target");
127
+ const canonicalBundle = realpath(bundle);
128
+ if (canonicalBundle === null) throw new CodexExecTrustError("cannot canonicalize the app bundle");
129
+ if (!binary.startsWith(canonicalBundle + "/Contents/")) {
130
+ throw new CodexExecTrustError("the app-bundle exec target is outside bundle Contents");
131
+ }
132
+ return { bundle: canonicalBundle, binary };
133
+ }
134
+
135
+ /** Classification of this exact validated invocation, not a reusable trust grant. */
136
+ interface ValidatedCodexExecTarget {
137
+ readonly invocation: SpawnInvocation;
138
+ readonly macAppBundle: boolean;
139
+ }
140
+
141
+ export function validatedCodexExecTarget(
142
+ command: string,
143
+ args: readonly string[],
144
+ deps: CodexExecBoundaryDeps = {},
145
+ ): ValidatedCodexExecTarget {
146
+ if ((deps.platform ?? process.platform) !== "darwin") {
147
+ return { invocation: codexExecInvocation(command, args, deps.platform ?? process.platform, { env: deps.env, exists: deps.exists }), macAppBundle: false };
148
+ }
149
+ const resolved = resolveDarwinExecPath(command, deps);
150
+ if ("error" in resolved) throw resolved.error;
151
+ const target = darwinBundleTarget(resolved.path, deps);
152
+ if (target) {
153
+ const reason = (deps.macBundleTrustReason ?? untrustedChatgptBundleReason)(target.bundle, target.binary);
154
+ if (reason) throw new CodexExecTrustError(reason);
155
+ return { invocation: { file: target.binary, args: [...args], options: {} }, macAppBundle: true };
156
+ }
157
+ return { invocation: { file: resolved.path, args: [...args], options: {} }, macAppBundle: false };
158
+ }
159
+
160
+ export async function validatedCodexExecTargetAsync(
161
+ command: string,
162
+ args: readonly string[],
163
+ deps: CodexExecBoundaryAsyncDeps = {},
164
+ ): Promise<ValidatedCodexExecTarget> {
165
+ deps.signal?.throwIfAborted();
166
+ if ((deps.platform ?? process.platform) !== "darwin") {
167
+ return { invocation: codexExecInvocation(command, args, deps.platform ?? process.platform, { env: deps.env, exists: deps.exists }), macAppBundle: false };
168
+ }
169
+ const resolved = resolveDarwinExecPath(command, deps);
170
+ if ("error" in resolved) throw resolved.error;
171
+ const target = darwinBundleTarget(resolved.path, deps);
172
+ if (target) {
173
+ const reason = await (deps.macBundleTrustReasonAsync
174
+ ? deps.macBundleTrustReasonAsync(target.bundle, target.binary, deps.signal)
175
+ : untrustedChatgptBundleReasonAsync(target.bundle, target.binary, undefined, deps.signal));
176
+ if (reason) throw new CodexExecTrustError(reason);
177
+ deps.signal?.throwIfAborted();
178
+ return { invocation: { file: target.binary, args: [...args], options: {} }, macAppBundle: true };
179
+ }
180
+ deps.signal?.throwIfAborted();
181
+ return { invocation: { file: resolved.path, args: [...args], options: {} }, macAppBundle: false };
182
+ }
183
+
184
+ export function validatedCodexExecInvocation(
185
+ command: string, args: readonly string[], deps: CodexExecBoundaryDeps = {},
186
+ ): SpawnInvocation {
187
+ return validatedCodexExecTarget(command, args, deps).invocation;
188
+ }
189
+
190
+ export async function validatedCodexExecInvocationAsync(
191
+ command: string, args: readonly string[], deps: CodexExecBoundaryAsyncDeps = {},
192
+ ): Promise<SpawnInvocation> {
193
+ const target = await validatedCodexExecTargetAsync(command, args, deps);
194
+ deps.signal?.throwIfAborted();
195
+ return target.invocation;
196
+ }
197
+
198
+ /** Assert a single already-located executable; returns the canonical target to exec. */
199
+ export function assertCodexExecTargetTrusted(command: string, deps: CodexExecBoundaryDeps = {}): string {
200
+ return validatedCodexExecInvocation(command, [], deps).file;
201
+ }
202
+
203
+ export async function assertCodexExecTargetTrustedAsync(
204
+ command: string,
205
+ deps: CodexExecBoundaryAsyncDeps = {},
206
+ ): Promise<string> {
207
+ return (await validatedCodexExecInvocationAsync(command, [], deps)).file;
208
+ }
@@ -1,10 +1,90 @@
1
+ import { createHmac } from "node:crypto";
2
+
1
3
  /** Native request metadata shared by the HTTP adapter and WS preparation. */
2
4
  export const CODEX_RESPONSES_LITE_HEADER = "x-openai-internal-codex-responses-lite";
3
5
  export const CODEX_RESPONSES_LITE_METADATA_KEY = "ws_request_header_x_openai_internal_codex_responses_lite";
4
6
  export const CODEX_ROUTING_HINT_HEADER = "x-codex-routing-hint";
7
+ export const CODEX_INSTALLATION_ID_HEADER = "x-codex-installation-id";
8
+ export const CODEX_TURN_METADATA_HEADER = "x-codex-turn-metadata";
9
+ export const CODEX_TURN_STATE_HEADER = "x-codex-turn-state";
10
+ export const CODEX_ATTESTATION_HEADER = "x-oai-attestation";
5
11
 
6
12
  const MAX_ROUTING_MODEL_BYTES = 256;
7
13
  const MAX_ROUTING_TIER_BYTES = 64;
14
+ const INSTALL_BODY_KEY = "opencodex-codex-pool-install-body-v1";
15
+ const INSTALL_TAG_KEY = "opencodex-codex-pool-install-tag-v1";
16
+ const UUID_V4_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
17
+ const MAX_TURN_METADATA_BYTES = 32 * 1024;
18
+
19
+ function accountTagForUuidPrefix(account: string, prefix20Hex: string): string {
20
+ return createHmac("sha256", INSTALL_TAG_KEY).update(`${account}\0${prefix20Hex.toLowerCase()}`).digest("hex").slice(0, 12);
21
+ }
22
+
23
+ /**
24
+ * Deterministic, idempotent RFC 4122 v4 UUID isolated per (chatgptAccountId, callerInstallationId).
25
+ * Calling it twice with the same chatgptAccountId returns the identical UUID without double-hashing.
26
+ */
27
+ export function deriveCodexAccountInstallationId(chatgptAccountId: string, callerInstallationId: string): string {
28
+ const account = chatgptAccountId.trim();
29
+ const raw = callerInstallationId.trim();
30
+ if (!account || !raw) return callerInstallationId;
31
+ if (UUID_V4_RE.test(raw)) {
32
+ const hex = raw.replace(/-/g, "").toLowerCase();
33
+ if (hex.slice(20, 32) === accountTagForUuidPrefix(account, hex.slice(0, 20))) {
34
+ return raw.toLowerCase();
35
+ }
36
+ }
37
+ const h = createHmac("sha256", INSTALL_BODY_KEY).update(`${account}\0${raw}`).digest("hex");
38
+ const variant = ((Number.parseInt(h[16]!, 16) & 0x3) | 0x8).toString(16);
39
+ const prefix20 = `${h.slice(0, 8)}${h.slice(8, 12)}4${h.slice(13, 16)}${variant}${h.slice(17, 20)}`;
40
+ const node12 = accountTagForUuidPrefix(account, prefix20);
41
+ return `${prefix20.slice(0, 8)}-${prefix20.slice(8, 12)}-${prefix20.slice(12, 16)}-${prefix20.slice(16, 20)}-${node12}`;
42
+ }
43
+
44
+ export function rewriteTurnMetadataInstallationId(rawMetadata: string, chatgptAccountId: string): string {
45
+ if (!chatgptAccountId.trim() || Buffer.byteLength(rawMetadata, "utf8") > MAX_TURN_METADATA_BYTES) return rawMetadata;
46
+ let parsed: unknown;
47
+ try { parsed = JSON.parse(rawMetadata); } catch { return rawMetadata; }
48
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return rawMetadata;
49
+ const record = parsed as Record<string, unknown>;
50
+ if (typeof record.installation_id !== "string" || !record.installation_id.trim()) return rawMetadata;
51
+ const nextId = deriveCodexAccountInstallationId(chatgptAccountId, record.installation_id);
52
+ if (nextId === record.installation_id) return rawMetadata;
53
+ return JSON.stringify({ ...record, installation_id: nextId });
54
+ }
55
+
56
+ export function isolateCodexPoolAccountHeaders(headers: Headers, chatgptAccountId: string): void {
57
+ headers.delete(CODEX_ATTESTATION_HEADER);
58
+ if (!chatgptAccountId.trim()) return;
59
+ const installId = headers.get(CODEX_INSTALLATION_ID_HEADER);
60
+ if (installId && installId.trim()) {
61
+ headers.set(CODEX_INSTALLATION_ID_HEADER, deriveCodexAccountInstallationId(chatgptAccountId, installId));
62
+ }
63
+ const turnMeta = headers.get(CODEX_TURN_METADATA_HEADER);
64
+ if (turnMeta) {
65
+ headers.set(CODEX_TURN_METADATA_HEADER, rewriteTurnMetadataInstallationId(turnMeta, chatgptAccountId));
66
+ }
67
+ }
68
+
69
+ export function isolateCodexPoolClientMetadata(body: unknown, chatgptAccountId: string | undefined): unknown {
70
+ if (!chatgptAccountId?.trim() || !body || typeof body !== "object" || Array.isArray(body)) return body;
71
+ const record = body as Record<string, unknown>;
72
+ const cm = record.client_metadata;
73
+ if (!cm || typeof cm !== "object" || Array.isArray(cm)) return body;
74
+ const meta = cm as Record<string, unknown>;
75
+ let nextMeta: Record<string, unknown> | undefined;
76
+ const rawInstallId = meta[CODEX_INSTALLATION_ID_HEADER];
77
+ if (typeof rawInstallId === "string" && rawInstallId.trim()) {
78
+ const nextId = deriveCodexAccountInstallationId(chatgptAccountId, rawInstallId);
79
+ if (nextId !== rawInstallId) nextMeta = { ...meta, [CODEX_INSTALLATION_ID_HEADER]: nextId };
80
+ }
81
+ const rawTurnMeta = (nextMeta ?? meta)[CODEX_TURN_METADATA_HEADER];
82
+ if (typeof rawTurnMeta === "string" && rawTurnMeta.trim()) {
83
+ const rewritten = rewriteTurnMetadataInstallationId(rawTurnMeta, chatgptAccountId);
84
+ if (rewritten !== rawTurnMeta) nextMeta = { ...(nextMeta ?? meta), [CODEX_TURN_METADATA_HEADER]: rewritten };
85
+ }
86
+ return nextMeta ? { ...record, client_metadata: nextMeta } : body;
87
+ }
8
88
 
9
89
  function isRoutingHintComponent(value: unknown, maxBytes: number): value is string {
10
90
  // Printable non-whitespace ASCII makes code-unit length equal to byte length.
@@ -27,6 +27,7 @@ import { currentHistoryDbBusyTimeoutMs, resolveExistingHistoryBackupPath } from
27
27
  import { spawnWorker } from "../lib/worker-embed";
28
28
  import type { CodexHistoryFailureReason, CodexHistoryVerifiedNoopProof } from "./history-provider";
29
29
  import { getCodexHome, resolveCodexStateDbPath } from "./paths";
30
+ import type { RestoreOwnershipRefusal } from "../client/restore-ownership";
30
31
 
31
32
  /**
32
33
  * Resolve the paths a history job needs, at CALL time.
@@ -103,6 +104,7 @@ export interface CodexHistoryJobRequest {
103
104
  readonly canonicalBackupPath: string;
104
105
  readonly operation: CodexHistoryWorkerOperation;
105
106
  readonly expectedDesiredEnabled?: boolean;
107
+ readonly guardStopOwnership?: boolean;
106
108
  }
107
109
 
108
110
  export type CodexHistoryJobOutcome =
@@ -111,6 +113,7 @@ export type CodexHistoryJobOutcome =
111
113
  | { readonly kind: "blocked"; readonly reason: "busy" | "database" | "unsafe-path" | "desired_disabled" | "desired_enabled" }
112
114
  | { readonly kind: "failed"; readonly reason: "worker-error" | "worker-died" | "timeout";
113
115
  readonly message: string; readonly historyFailureReason?: CodexHistoryFailureReason;
116
+ readonly restoreBoundary?: RestoreOwnershipRefusal;
114
117
  /** Specific integrity condition when `historyFailureReason` is `"integrity"`. */
115
118
  readonly historyIntegrityCode?: string;
116
119
  readonly rows?: number; readonly files?: number };
@@ -178,6 +181,8 @@ function isPlausibleWorkerResult(
178
181
  || message.reason === "desired_disabled" || message.reason === "desired_enabled";
179
182
  case "error":
180
183
  return typeof message.message === "string"
184
+ && (message.restoreBoundary === undefined || (target?.operation === "restore-openai"
185
+ && (message.restoreBoundary === "hub-owned" || message.restoreBoundary === "unproven")))
181
186
  && (message.rows === undefined || (Number.isSafeInteger(message.rows) && Number(message.rows) >= 0))
182
187
  && (message.files === undefined || (Number.isSafeInteger(message.files) && Number(message.files) >= 0))
183
188
  && ((message.rows === undefined && message.files === undefined)
@@ -307,6 +312,7 @@ function classifyWorkerResult(result: HistoryWorkerResult): CodexHistoryJobOutco
307
312
  kind: "failed",
308
313
  reason: "worker-error",
309
314
  message: redactWorkerMessage(result.message),
315
+ ...(result.restoreBoundary ? { restoreBoundary: result.restoreBoundary } : {}),
310
316
  ...(result.reason ? { historyFailureReason: result.reason } : {}),
311
317
  ...(result.integrityCode ? { historyIntegrityCode: result.integrityCode } : {}),
312
318
  ...(result.rows !== undefined && result.files !== undefined
@@ -438,6 +444,7 @@ export async function runCodexHistoryJob(
438
444
  canonicalStateDbPath: request.canonicalStateDbPath,
439
445
  canonicalBackupPath: request.canonicalBackupPath,
440
446
  ...(request.expectedDesiredEnabled === undefined ? {} : { expectedDesiredEnabled: request.expectedDesiredEnabled }),
447
+ ...(request.guardStopOwnership ? { guardStopOwnership: true } : {}),
441
448
  // A Worker is a fresh module realm: it would otherwise open state_5.sqlite with this
442
449
  // module's default rather than the timeout this process resolved. Production sends the
443
450
  // same codex-rs-matching 5s the Worker would have used on its own.
@@ -1368,7 +1368,7 @@ export function syncCodexHistoryProvider(
1368
1368
  provider: CodexHistoryProvider,
1369
1369
  stateDbPath = resolveCodexStateDbPath(),
1370
1370
  backupPath = resolveExistingHistoryBackupPath(stateDbPath),
1371
- opts: { skipWhenProvablyNoop?: boolean } = {},
1371
+ opts: { skipWhenProvablyNoop?: boolean; withWriteGuard?: <T>(write: () => T) => T } = {},
1372
1372
  ): CodexHistorySyncResult {
1373
1373
  // Opt-in steady-state gate (Design B loopback callers only): default semantics of
1374
1374
  // this exported API are unchanged — legacy stop/restore paths never pass the flag.
@@ -1377,7 +1377,10 @@ export function syncCodexHistoryProvider(
1377
1377
  return { rows: 0, files: 0 };
1378
1378
  }
1379
1379
  try {
1380
- const retried = withHistoryRetryResult(() => syncCodexHistoryProviderUnsafe(provider, stateDbPath, backupPath));
1380
+ // The guard encloses the entire synchronous attempt: DB CAS/commit, every rollout
1381
+ // append and manifest consumption/finalization. No ownership publication can interleave.
1382
+ const write = () => syncCodexHistoryProviderUnsafe(provider, stateDbPath, backupPath);
1383
+ const retried = withHistoryRetryResult(() => opts.withWriteGuard ? opts.withWriteGuard(write) : write());
1381
1384
  return retried.ok ? retried.value : { rows: 0, files: 0, failed: true, failureReason: retried.reason };
1382
1385
  } catch (error) {
1383
1386
  if (error instanceof CodexHistoryIntegrityError) {
@@ -26,6 +26,7 @@
26
26
  import { withHistoryWriteSerialization } from "./history-lock";
27
27
  import { loadConfig } from "../config";
28
28
  import { shouldSyncCodexOnStart } from "./desired-state";
29
+ import { stopRestoreWriteGuard, type RestoreOwnershipRefusal } from "../client/restore-ownership";
29
30
  import {
30
31
  writeHistoryProviderTransition,
31
32
  writeLegacyOpenaiHistoryRecovery,
@@ -63,6 +64,8 @@ export interface HistoryWorkerRunMessage {
63
64
  readonly canonicalBackupPath: string;
64
65
  /** When set, prove this transition's desired direction while H is held. */
65
66
  readonly expectedDesiredEnabled?: boolean;
67
+ /** Stop restoration must revalidate connection ownership inside H, under C. */
68
+ readonly guardStopOwnership?: boolean;
66
69
  /**
67
70
  * The parent realm's `state_5.sqlite` busy timeout. A Worker cannot observe a parent that
68
71
  * resolved a different window, for the same reason the homes below are explicit.
@@ -81,6 +84,7 @@ export type HistoryWorkerResult =
81
84
  readonly reason: "busy" | "database" | "unsafe-path" | "desired_disabled" | "desired_enabled" }
82
85
  | { readonly type: "error"; readonly requestId: string; readonly jobId: string;
83
86
  readonly message: string; readonly reason?: CodexHistoryFailureReason;
87
+ readonly restoreBoundary?: RestoreOwnershipRefusal;
84
88
  /** Specific integrity condition, so a non-retryable one can be named as such. */
85
89
  readonly integrityCode?: string;
86
90
  readonly rows?: number; readonly files?: number };
@@ -114,6 +118,8 @@ export function isHistoryWorkerRunMessage(data: unknown): data is HistoryWorkerR
114
118
  && nonEmpty(message.canonicalStateDbPath)
115
119
  && nonEmpty(message.canonicalBackupPath)
116
120
  && (message.expectedDesiredEnabled === undefined || typeof message.expectedDesiredEnabled === "boolean")
121
+ && (message.guardStopOwnership === undefined
122
+ || (message.guardStopOwnership === true && message.operation === "restore-openai"))
117
123
  && (message.busyTimeoutMs === undefined
118
124
  || (typeof message.busyTimeoutMs === "number"
119
125
  && Number.isFinite(message.busyTimeoutMs)
@@ -159,7 +165,16 @@ export function runHistoryUnitUnderLock(
159
165
  // manifest-backed original metadata. The provider is derived from the operation,
160
166
  // never from a caller; only recover-legacy-openai force-labels bare routed rows.
161
167
  const provider = operation === "apply-opencodex" ? "opencodex" : "openai";
162
- return writeHistoryProviderTransition(permit, target, provider);
168
+ const guard = message.guardStopOwnership ? stopRestoreWriteGuard() : undefined;
169
+ try {
170
+ // H is already held. The provider takes C only for synchronous attempts, so
171
+ // there is no C -> H edge and no C lease spans the parent's Worker await.
172
+ return writeHistoryProviderTransition(permit, target, provider, guard?.run);
173
+ } catch (error) {
174
+ const boundary = guard?.boundary();
175
+ if (boundary && boundary !== "restore") return { restoreBoundary: boundary };
176
+ throw error;
177
+ }
163
178
  },
164
179
  );
165
180
 
@@ -167,6 +182,10 @@ export function runHistoryUnitUnderLock(
167
182
  return { type: "blocked", requestId, jobId, reason: acquired.reason };
168
183
  }
169
184
  const result = acquired.value;
185
+ if ("restoreBoundary" in result) {
186
+ return { type: "error", requestId, jobId, message: `stop_restore_${result.restoreBoundary}`,
187
+ restoreBoundary: result.restoreBoundary };
188
+ }
170
189
  if ("desiredStateChanged" in result) {
171
190
  return {
172
191
  type: "blocked",