@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,30 @@
1
+ export type UpdateMutationKind = "runtime" | "service" | "tray" | "shim" | "package" | "publish" | "package-publish" | "own-child" | "own-tray";
2
+ export type UpdateMutationAuthorizer = (kind: UpdateMutationKind) => boolean;
3
+ export declare function createMutationAuthorizer(policy: {
4
+ check(): boolean; checkPackage(): boolean; readonly serviceAllowed: boolean;
5
+ }): UpdateMutationAuthorizer;
6
+ export declare function materializeMutationData<T>(value: T): T;
7
+ export declare class UpdateMutationRefusedError extends Error { code: "EUPDATEAUTHORITY"; }
8
+ export declare function guardedRun<K extends UpdateMutationKind, A extends any[], R>(authorize: (kind: K) => boolean, kind: K,
9
+ operation: (...args: A) => R, args: A): R;
10
+ export declare const guardedSpawn: (authorize: UpdateMutationAuthorizer, kind: UpdateMutationKind,
11
+ ...args: Parameters<typeof import("node:child_process").spawn>) => import("node:child_process").ChildProcess;
12
+ export declare function guardedSpawnSync<K extends UpdateMutationKind>(authorize: (kind: K) => boolean, kind: K,
13
+ file: string, args: readonly string[], options: import("node:child_process").SpawnSyncOptionsWithStringEncoding,
14
+ native?: typeof import("node:child_process").spawnSync): import("node:child_process").SpawnSyncReturns<string>;
15
+ export declare function guardedSpawnSync<K extends UpdateMutationKind>(authorize: (kind: K) => boolean, kind: K,
16
+ file: string, args: readonly string[], options?: import("node:child_process").SpawnSyncOptions,
17
+ native?: typeof import("node:child_process").spawnSync): import("node:child_process").SpawnSyncReturns<Buffer>;
18
+ export declare const guardedExecFile: (authorize: UpdateMutationAuthorizer, kind: UpdateMutationKind,
19
+ file: string, args: readonly string[], options: import("node:child_process").ExecFileOptions,
20
+ callback?: (...args: any[]) => void) => import("node:child_process").ChildProcess;
21
+ export declare const guardedExecFileSync: <K extends UpdateMutationKind>(authorize: (kind: K) => boolean, kind: K,
22
+ ...args: Parameters<typeof import("node:child_process").execFileSync>) => string | Buffer;
23
+ export declare function guardedKill<K extends UpdateMutationKind>(authorize: (kind: K) => boolean, kind: K, pid: number, signal?: NodeJS.Signals | number): boolean;
24
+ export declare function guardedRenameSync(authorize: (kind: "package") => boolean, from: string, to: string, native?: typeof import("node:fs").renameSync): void;
25
+ export declare function ownedArtifactRm(target: string, options: import("node:fs").RmOptions, native?: typeof import("node:fs").rmSync): void;
26
+ export declare function ownedArtifactUnlink(target: string): void;
27
+ export declare function probeProcessAlive(pid: number): true;
28
+ export declare function relayOwnSignal(signal: NodeJS.Signals): true;
29
+ export declare function guardedExit(authorize: UpdateMutationAuthorizer, kind: "publish" | "package-publish", code: number): never;
30
+ export { spawn as probeSpawn, spawnSync as probeSpawnSync } from "node:child_process";
@@ -0,0 +1,103 @@
1
+ import { spawn, spawnSync, execFile, execFileSync } from "node:child_process";
2
+ import { renameSync, rmSync, unlinkSync } from "node:fs";
3
+
4
+ /**
5
+ * One synchronous authority gate shared by Node, Bun and worker lanes. A home refusal
6
+ * (including a throwing inspector) is permanent for this attempt. Service absence is
7
+ * a skipped service action, not a refusal of authorized foreground runtime cleanup.
8
+ * Package-only publication grants no runtime authority. Cleanup kinds are deliberately
9
+ * narrow: callers must retain the exact live ChildProcess or their own pre-stop tray.
10
+ * @param {{ check(): boolean, checkPackage(): boolean, readonly serviceAllowed: boolean }} policy
11
+ */
12
+ export function createMutationAuthorizer(policy) {
13
+ let refused = false;
14
+ /** @param {"runtime" | "service" | "tray" | "shim" | "package" | "publish" | "package-publish" | "own-child" | "own-tray"} kind */
15
+ return function authorizeMutation(kind) {
16
+ // These complete an already authorized operation; they never discover a new target,
17
+ // install/refresh a tray, or start/restart a runtime or a service.
18
+ if (kind === "own-child" || kind === "own-tray") return true;
19
+ if (refused) return false;
20
+ try {
21
+ const allowed = (kind === "package" || kind === "package-publish" ? policy.checkPackage() : policy.check()) === true;
22
+ refused = !allowed;
23
+ return allowed && (kind !== "service" || policy.serviceAllowed === true);
24
+ } catch {
25
+ refused = true;
26
+ return false;
27
+ }
28
+ };
29
+ }
30
+
31
+ /** Copy data before the final gate. Never carry a caller's prototype, getter,
32
+ * iterator, coercion hook or Proxy into the primitive. Functions are not data.
33
+ * Cycles are rejected; caller prototypes are discarded rather than passed to native coercion. */
34
+ export function materializeMutationData(value, ancestors = new Set()) {
35
+ if (value === null || ["undefined", "string", "number", "boolean", "bigint"].includes(typeof value)) return value;
36
+ if (typeof value !== "object") throw new TypeError("Update mutation arguments must be plain data");
37
+ if (ancestors.has(value)) throw new TypeError("Cyclic update mutation data");
38
+ ancestors.add(value);
39
+ try {
40
+ if (Array.isArray(value)) {
41
+ const length = value.length, copy = [];
42
+ for (let i = 0; i < length; i++) copy.push(materializeMutationData(value[i], ancestors));
43
+ return copy;
44
+ }
45
+ const copy = Object.create(null);
46
+ for (const key of Reflect.ownKeys(value)) {
47
+ if (Object.prototype.propertyIsEnumerable.call(value, key)) copy[key] = materializeMutationData(value[key], ancestors);
48
+ }
49
+ return copy;
50
+ } finally { ancestors.delete(value); }
51
+ }
52
+
53
+ export class UpdateMutationRefusedError extends Error {
54
+ constructor() { super("Automatic update mutation refused; check 'ocx service status'."); this.code = "EUPDATEAUTHORITY"; }
55
+ }
56
+
57
+ /** The operation slot is a trusted, thunk-free primitive adapter. It must consume
58
+ * only its arguments, never close over unmaterialized caller data or do preparation.
59
+ * No callback slots are supported here: helpers with synchronous callbacks must
60
+ * guard their actual primitive after those callbacks, not wrap the orchestration. */
61
+ export function guardedRun(authorizeMutation, kind, operation, args) {
62
+ const data = materializeMutationData(args);
63
+ if (authorizeMutation(kind) !== true) throw new UpdateMutationRefusedError();
64
+ return operation(...data);
65
+ }
66
+
67
+ export function guardedSpawn(authorize, kind, file, args, options) {
68
+ return guardedRun(authorize, kind, spawn, [file, args, options]);
69
+ }
70
+ export function guardedSpawnSync(authorize, kind, file, args, options, native = spawnSync) {
71
+ return guardedRun(authorize, kind, native, [file, args, options]);
72
+ }
73
+ // execFile's final callback is an explicitly documented native callback slot: it
74
+ // runs on later completion/error events, never synchronously in native dispatch.
75
+ export function guardedExecFile(authorize, kind, file, args, options, callback) {
76
+ const data = materializeMutationData([file, args, options]);
77
+ if (callback !== undefined && typeof callback !== "function") throw new TypeError("Invalid execFile callback");
78
+ if (authorize(kind) !== true) throw new UpdateMutationRefusedError();
79
+ return execFile(...data, callback);
80
+ }
81
+ export function guardedExecFileSync(authorize, kind, file, args, options) {
82
+ return guardedRun(authorize, kind, execFileSync, [file, args, options]);
83
+ }
84
+ export function guardedKill(authorize, kind, pid, signal) {
85
+ return guardedRun(authorize, kind, process.kill.bind(process), [pid, signal]);
86
+ }
87
+ export function guardedRenameSync(authorize, from, to, native = renameSync) {
88
+ return guardedRun(authorize, "package", native, [from, to]);
89
+ }
90
+ /** Only private transaction artifacts or boot recovery's verified dead package.
91
+ * These bounded completions do not acquire runtime/service/home authority. */
92
+ export function ownedArtifactRm(target, options, native = rmSync) {
93
+ const data = materializeMutationData([target, options]);
94
+ return native(...data);
95
+ }
96
+ export function ownedArtifactUnlink(target) { return unlinkSync(materializeMutationData(target)); }
97
+ export function probeProcessAlive(pid) { return process.kill(materializeMutationData(pid), 0); }
98
+ export function relayOwnSignal(signal) { return process.kill(process.pid, materializeMutationData(signal)); }
99
+ export function guardedExit(authorize, kind, code) { return guardedRun(authorize, kind, process.exit.bind(process), [code]); }
100
+
101
+ // Explicit probe/ordinary-launch adapters. These do not convey update authority;
102
+ // callers are pinned by the inventory, and cannot use them for control commands.
103
+ export { spawn as probeSpawn, spawnSync as probeSpawnSync };
@@ -1,4 +1,4 @@
1
- import { spawn } from "node:child_process";
1
+ import { probeSpawn } from "./mutation-guard.mjs";
2
2
  import { existsSync, readFileSync } from "node:fs";
3
3
  import { join } from "node:path";
4
4
  import { isatty } from "node:tty";
@@ -189,7 +189,7 @@ export function triggerBackgroundRefreshIfStale(channel: Channel, cache: Version
189
189
  const commandArgs = ["__refresh-version", channel];
190
190
  const args = selfLaunchArgv(commandArgs);
191
191
  if (args.length > commandArgs.length && (!args[0] || !existsSync(args[0]))) return;
192
- const child = spawn(process.execPath, args, {
192
+ const child = probeSpawn(process.execPath, args, {
193
193
  detached: true,
194
194
  stdio: "ignore",
195
195
  windowsHide: true,
@@ -1,5 +1,5 @@
1
1
  import { lstatSync, readdirSync, realpathSync, statSync } from "node:fs";
2
- import { spawnSync } from "node:child_process";
2
+ import { probeSpawnSync } from "./mutation-guard.mjs";
3
3
  import { homedir } from "node:os";
4
4
  import { dirname, isAbsolute, resolve } from "node:path";
5
5
  import { fileURLToPath } from "node:url";
@@ -194,7 +194,7 @@ export function resolveNpmCachePath(options = {}) {
194
194
  // able to choose the cache that install is pinned to.
195
195
  const invocation = (options.invocationFn ?? npmInvocation)(["config", "get", "cache", "--global"], platform, env);
196
196
  if (!invocation) return { ok: false, reason: "npm_unavailable" };
197
- const npm = (options.spawnSyncFn ?? spawnSync)(invocation.file, invocation.args, {
197
+ const npm = (options.spawnSyncFn ?? probeSpawnSync)(invocation.file, invocation.args, {
198
198
  encoding: "utf8",
199
199
  timeout: options.timeoutMs ?? NPM_CONFIG_TIMEOUT_MS,
200
200
  windowsHide: true,
@@ -273,8 +273,8 @@ function runPreflightWorker(options) {
273
273
  const workerArgs = [fileURLToPath(import.meta.url), WORKER_ARG];
274
274
  if ((options.platform ?? process.platform) === "win32") workerArgs.push(ROOT_ONLY_ARG);
275
275
  if (options.cachePath !== undefined) workerArgs.push(options.cachePath);
276
- const spawn = options.spawnSyncFn ?? spawnSync;
277
- const result = spawn(
276
+ const probeSpawn = options.spawnSyncFn ?? probeSpawnSync;
277
+ const result = probeSpawn(
278
278
  options.execPath ?? process.execPath,
279
279
  workerArgs,
280
280
  {
@@ -1,6 +1,6 @@
1
1
  // Windows Node-launcher compatibility code. The install owns its entire process tree until
2
2
  // exit is proved; a timeout signal alone never authorizes stage removal.
3
- import { spawn } from "node:child_process";
3
+ import { guardedSpawn, materializeMutationData } from "./mutation-guard.mjs";
4
4
  import { dirname, join, win32 } from "node:path";
5
5
  import { fileURLToPath } from "node:url";
6
6
 
@@ -11,7 +11,9 @@ function quoteWindowsArg(value) {
11
11
  return '"' + value.replace(/(\\*)"/g, '$1$1\\"').replace(/(\\*)$/, "$1$1") + '"';
12
12
  }
13
13
 
14
- export async function runNpmInstall(invocation, { env = process.env, timeoutMs = 180000 } = {}) {
14
+ export async function runNpmInstall(invocation, { env = process.env, timeoutMs = 180000, authorizeMutation = () => false } = {}) {
15
+ invocation = materializeMutationData(invocation);
16
+ env = materializeMutationData(env);
15
17
  if (!invocation) return { status: 1, processTreeExited: true, error: { code: "ENOENT", message: "npm invocation unavailable" } };
16
18
  if (process.platform === "win32") {
17
19
  // Resolve from the same absolute system directory as the hardened cmd hop.
@@ -22,7 +24,7 @@ export async function runNpmInstall(invocation, { env = process.env, timeoutMs =
22
24
  const supervisor = win32.join(root, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
23
25
  const helper = join(dirname(fileURLToPath(import.meta.url)), "npm-install-job.ps1");
24
26
  return new Promise(resolve => {
25
- const child = spawn(supervisor, ["-NoLogo", "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", helper], {
27
+ const child = guardedSpawn(authorizeMutation, "package", supervisor, ["-NoLogo", "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", helper], {
26
28
  env, windowsHide: true, stdio: ["pipe", "pipe", "pipe"],
27
29
  });
28
30
  let output = "";
@@ -1,4 +1,5 @@
1
- import { mkdtempSync, lstatSync, writeFileSync, unlinkSync, rmdirSync } from "node:fs";
1
+ import { ownedArtifactUnlink } from "./mutation-guard.mjs";
2
+ import { mkdtempSync, lstatSync, writeFileSync, rmdirSync } from "node:fs";
2
3
  import { tmpdir } from "node:os";
3
4
  import { dirname, join } from "node:path";
4
5
  import { fileURLToPath } from "node:url";
@@ -26,7 +27,7 @@ export function withPnpmCommandCwd(args, run) {
26
27
  }
27
28
  // Never recursively remove pnpm-created or replacement contents.
28
29
  for (const name of files) {
29
- try { unlinkSync(join(cwd, name)); }
30
+ try { ownedArtifactUnlink(join(cwd, name)); }
30
31
  catch (error) { if (error?.code !== "ENOENT") throw error; }
31
32
  }
32
33
  rmdirSync(cwd);
@@ -1,4 +1,4 @@
1
- import { spawnSync } from "node:child_process";
1
+ import { probeSpawnSync } from "./mutation-guard.mjs";
2
2
 
3
3
  /**
4
4
  * Is something still answering `/healthz` as an opencodex proxy on this endpoint?
@@ -97,7 +97,7 @@ export function probeProxyLiveness(port, hostname = "127.0.0.1", timeoutMs = 150
97
97
  "});",
98
98
  ].join("\n");
99
99
  try {
100
- const probe = spawnSync(
100
+ const probe = probeSpawnSync(
101
101
  process.execPath,
102
102
  ["-e", script, host, String(port), String(timeoutMs)],
103
103
  { encoding: "utf8", timeout: timeoutMs + 1500, windowsHide: true },
@@ -0,0 +1,35 @@
1
+ import { isDeepStrictEqual } from "node:util";
2
+ import { createHash } from "node:crypto";
3
+ import { resolveCodexSqliteHome } from "../codex/paths";
4
+ import { inspectNativeCodexOwnership, type OwnershipDeps } from "../integrations/native/ownership-preflight";
5
+ import { compareServicePathToInstall, currentServiceHomes, inspectServiceStateEvidence, resolveServiceState, serviceStatePaths } from "../service/state";
6
+
7
+ export { createUpdateServiceHomePolicy, updateServiceHomeRefusal } from "./service-home-policy.mjs";
8
+ export type UpdateServiceHomeAuthority = import("./service-home-policy.mjs").UpdateServiceHomeAuthority;
9
+ export type UpdateServiceHomeInspector = () => UpdateServiceHomeAuthority;
10
+
11
+ /** Automatic restart authority, distinct from the interactive guard's fail-open policy. */
12
+ export function inspectUpdateServiceHome(deps: OwnershipDeps = {}): UpdateServiceHomeAuthority {
13
+ try {
14
+ const paths = deps.statePaths ?? serviceStatePaths();
15
+ const homes = deps.currentHomes ?? currentServiceHomes();
16
+ const before = resolveServiceState(inspectServiceStateEvidence(paths));
17
+ if (before.kind === "unknown") return { kind: "unknown" };
18
+ const ownership = inspectNativeCodexOwnership({ ...deps, statePaths: paths, currentHomes: homes });
19
+ if (ownership.ownership === "unknown") return { kind: "unknown" };
20
+ // 'owned' alone includes no record and no registration. Preserve that absence.
21
+ let kind: UpdateServiceHomeAuthority["kind"] = ownership.ownership === "foreign" ? "foreign" : before.kind === "none" ? "absent" : "same";
22
+ if (kind === "same" && before.kind === "state" && before.state.codexSqliteHome !== undefined) {
23
+ const sqlite = compareServicePathToInstall(before.state.codexSqliteHome,
24
+ resolveCodexSqliteHome({ codexHome: homes.codexHome }), { realpathSync: deps.realpathSync });
25
+ if (sqlite !== "same") kind = sqlite === "different" ? "foreign" : "unknown";
26
+ }
27
+ const after = resolveServiceState(inspectServiceStateEvidence(paths));
28
+ if (!isDeepStrictEqual(before, after) || !isDeepStrictEqual(homes, deps.currentHomes ?? currentServiceHomes())) {
29
+ return { kind: "unknown" };
30
+ }
31
+ return kind === "foreign" ? { kind, subject: createHash("sha256").update(JSON.stringify({ before, homes })).digest("hex") } : { kind };
32
+ } catch {
33
+ return { kind: "unknown" };
34
+ }
35
+ }
@@ -0,0 +1 @@
1
+ {"schemaVersion":1,"packageOnlyProtocolVersion":2,"entry":"__update-package-only-probe"}
@@ -0,0 +1,25 @@
1
+ export type UpdateServiceHomeAuthority = {
2
+ readonly kind: "same" | "foreign" | "unknown" | "absent" | "invalid";
3
+ readonly subject?: string;
4
+ };
5
+ export interface UpdateServiceHomePolicy {
6
+ authorizeMutation: import("./mutation-guard.mjs").UpdateMutationAuthorizer;
7
+ readonly initial: UpdateServiceHomeAuthority;
8
+ readonly serviceAllowed: boolean;
9
+ readonly packageOnly: boolean;
10
+ checkPackage(home?: UpdateServiceHomeAuthority): boolean;
11
+ check(home?: UpdateServiceHomeAuthority): boolean;
12
+ }
13
+ export declare const UPDATE_HOME_SCHEMA_VERSION: 1;
14
+ export declare const UPDATE_HOME_LAUNCHER_PROTOCOL: 1;
15
+ export declare const UPDATE_PACKAGE_ONLY_EXIT_CODE: 75;
16
+ export declare const UPDATE_PACKAGE_ONLY_PROTOCOL_VERSION: 2;
17
+ export declare const UPDATE_WORKER_HOME_FLAG: "--update-worker-home";
18
+ export declare function updateWorkerHomeArgv(home: UpdateServiceHomeAuthority | undefined): string | null;
19
+ export declare function parseUpdateWorkerHome(argv: readonly string[]): UpdateServiceHomeAuthority | undefined;
20
+ export declare function isUpdateHomeProbe(args: string[]): boolean;
21
+ export declare function parseUpdateHomeProbe(value: unknown, options?: { requireLauncher?: boolean }): UpdateServiceHomeAuthority;
22
+ export declare function createUpdateServiceHomePolicy(inspect: () => UpdateServiceHomeAuthority,
23
+ refuse: (message: string) => void, packageOnly?: boolean,
24
+ delegatedBaseline?: UpdateServiceHomeAuthority): UpdateServiceHomePolicy;
25
+ export declare function updateServiceHomeRefusal(authority: UpdateServiceHomeAuthority): string | null;
@@ -0,0 +1,112 @@
1
+ import { createMutationAuthorizer } from "./mutation-guard.mjs";
2
+ /** Pure policy shared by the Node launcher and Bun update paths. */
3
+ /** @typedef {{ readonly kind: "same" | "foreign" | "unknown" | "absent" | "invalid", readonly subject?: string }} UpdateServiceHomeAuthority */
4
+
5
+ export const UPDATE_HOME_SCHEMA_VERSION = 1;
6
+ export const UPDATE_HOME_LAUNCHER_PROTOCOL = 1;
7
+ export const UPDATE_PACKAGE_ONLY_EXIT_CODE = 75;
8
+ /** v2 children accept the delegated parent baseline argv; v1 launchers never see it. */
9
+ export const UPDATE_PACKAGE_ONLY_PROTOCOL_VERSION = 2;
10
+ export const UPDATE_WORKER_HOME_FLAG = "--update-worker-home";
11
+
12
+ /** Encode the parent's verified baseline for the delegated launcher. All four observed
13
+ * kinds travel: an omitted baseline would let the child mint authority the parent never
14
+ * held (parent same/foreign, child observing unknown), and --update-package-only alone
15
+ * only restricts control without preserving which baseline authorized replacement.
16
+ * null means the baseline cannot be encoded and delegation must be refused.
17
+ * @param {UpdateServiceHomeAuthority | undefined} home @returns {string | null} */
18
+ export function updateWorkerHomeArgv(home) {
19
+ if (home?.kind === "same" || home?.kind === "absent" || home?.kind === "unknown") return home.kind;
20
+ if (home?.kind === "foreign" && typeof home.subject === "string" && /^[a-f0-9]{64}$/.test(home.subject))
21
+ return `foreign:${home.subject}`;
22
+ return null;
23
+ }
24
+
25
+ /** The baseline a v2 delegating parent pinned for this update. Absent flag → undefined:
26
+ * the entry was self-launched (direct `ocx update`) and inspects itself. Malformed,
27
+ * duplicated or `=`-joined shapes → { kind: "invalid" }, a synthetic baseline that fails
28
+ * every check instead of falling back to a fresh inspection.
29
+ * @param {readonly string[]} argv @returns {UpdateServiceHomeAuthority | undefined} */
30
+ export function parseUpdateWorkerHome(argv) {
31
+ let at = -1;
32
+ for (let i = 0; i < argv.length; i++) {
33
+ if (argv[i] === UPDATE_WORKER_HOME_FLAG) {
34
+ if (at >= 0) return { kind: "invalid" };
35
+ at = i;
36
+ } else if (argv[i].startsWith(`${UPDATE_WORKER_HOME_FLAG}=`)) return { kind: "invalid" };
37
+ }
38
+ if (at < 0) return undefined;
39
+ const value = argv[at + 1];
40
+ if (value === "same" || value === "absent" || value === "unknown") return { kind: value };
41
+ const foreign = typeof value === "string" ? /^foreign:([a-f0-9]{64})$/.exec(value) : null;
42
+ return foreign ? { kind: "foreign", subject: foreign[1] } : { kind: "invalid" };
43
+ }
44
+
45
+ /** Exact argv only: malformed variants must not enter the ordinary status collector.
46
+ * @param {string[]} args */
47
+ export function isUpdateHomeProbe(args) {
48
+ return args.length === 1 && args[0] === "__update-home-probe";
49
+ }
50
+
51
+ /** @param {unknown} value @param {{ requireLauncher?: boolean }} [options]
52
+ * @returns {UpdateServiceHomeAuthority} */
53
+ export function parseUpdateHomeProbe(value, { requireLauncher = false } = {}) {
54
+ if (!value || typeof value !== "object" || Array.isArray(value)) return { kind: "unknown" };
55
+ const record = /** @type {Record<string, unknown>} */ (value);
56
+ const keys = Object.keys(record);
57
+ if (keys.some(key => !["schemaVersion", "kind", "subject", "launcherProtocolVersion"].includes(key))
58
+ || record.schemaVersion !== UPDATE_HOME_SCHEMA_VERSION
59
+ || (requireLauncher && record.launcherProtocolVersion !== UPDATE_HOME_LAUNCHER_PROTOCOL)
60
+ || (record.launcherProtocolVersion !== undefined && record.launcherProtocolVersion !== UPDATE_HOME_LAUNCHER_PROTOCOL)) return { kind: "unknown" };
61
+ if (record.kind === "foreign") {
62
+ return typeof record.subject === "string" && /^[a-f0-9]{64}$/.test(record.subject)
63
+ ? { kind: "foreign", subject: record.subject } : { kind: "unknown" };
64
+ }
65
+ if (record.subject !== undefined) return { kind: "unknown" };
66
+ return record.kind === "same" || record.kind === "absent" || record.kind === "unknown"
67
+ ? { kind: record.kind } : { kind: "unknown" };
68
+ }
69
+
70
+ /** A foreign registration never manages this foreground runtime. A changed claim is not absence.
71
+ * @param {() => UpdateServiceHomeAuthority} inspect @param {(message: string) => void} refuse
72
+ * @param {boolean} [packageOnly] A parent's restriction can only remove runtime authority.
73
+ * @param {UpdateServiceHomeAuthority} [delegatedBaseline] A v2 parent's verified baseline;
74
+ * when present it replaces inspection so the child cannot launder a changed home. */
75
+ export function createUpdateServiceHomePolicy(inspect, refuse, packageOnly = false, delegatedBaseline) {
76
+ const initial = delegatedBaseline ?? inspect();
77
+ let current = initial;
78
+ packageOnly ||= initial.kind === "unknown";
79
+ const checkAuthority = (home) => {
80
+ current = home;
81
+ const allowed = initial.kind === "same" ? home.kind === "same" || home.kind === "absent"
82
+ : initial.kind === "absent" ? home.kind === "absent"
83
+ : initial.kind === "foreign" && home.kind === "foreign" && initial.subject !== undefined && initial.subject === home.subject;
84
+ if (allowed) return true;
85
+ refuse(updateServiceHomeRefusal(home)
86
+ ?? "Automatic update restart refused: service registration authority changed. Check 'ocx service status' before restarting manually.");
87
+ return false;
88
+ };
89
+ const policy = {
90
+ initial,
91
+ packageOnly,
92
+ get serviceAllowed() { return !packageOnly && initial.kind === "same" && current.kind === "same"; },
93
+ checkPackage(home = inspect()) {
94
+ return initial.kind === "unknown" && home.kind === "unknown" || checkAuthority(home);
95
+ },
96
+ check(home = inspect()) {
97
+ if (!packageOnly) return checkAuthority(home);
98
+ refuse(updateServiceHomeRefusal({ kind: "unknown" }));
99
+ return false;
100
+ },
101
+ };
102
+ return { ...policy, get serviceAllowed() { return policy.serviceAllowed; }, authorizeMutation: createMutationAuthorizer(policy) };
103
+ }
104
+
105
+ /** Static persisted guidance: never echo recorded paths or a probe's error output.
106
+ * @param {UpdateServiceHomeAuthority} authority @returns {string | null} */
107
+ export function updateServiceHomeRefusal(authority) {
108
+ if (authority.kind === "same" || authority.kind === "absent") return null;
109
+ return authority.kind === "foreign"
110
+ ? "Automatic update restart refused: the installed service belongs to different directories. Run 'ocx service status' from the registered installation; no restart was authorized."
111
+ : "Automatic update restart refused: service registration ownership could not be verified. Check 'ocx service status' and the recorded installation before restarting manually.";
112
+ }
@@ -0,0 +1,9 @@
1
+ import { inspectUpdateServiceHome } from "./service-home-authority";
2
+ import { isUpdateHomeProbe } from "./service-home-policy.mjs";
3
+
4
+ // This entry deliberately does not import the CLI root, status collector or launcher.
5
+ // --no-env-file is supplied by the Node parent; malformed/old entrypoints are unknown.
6
+ if (import.meta.main) {
7
+ if (!isUpdateHomeProbe(process.argv.slice(2))) process.exit(1);
8
+ console.log(JSON.stringify({ schemaVersion: 1, ...inspectUpdateServiceHome() }));
9
+ }
@@ -0,0 +1,15 @@
1
+ import type { UpdateServiceHomeAuthority } from "./service-home-policy.mjs";
2
+ import type { SpawnSyncOptionsWithStringEncoding } from "node:child_process";
3
+ export declare const UPDATE_HOME_PROBE_ARGS: string[];
4
+ export declare function supportsUpdateHomeProbe(launcher: string, read?: (path: string) => string): boolean;
5
+ export declare function updateHomeProbeEnvironment(env: Record<string, string | undefined>,
6
+ homes: { codexHome: string; opencodexHome: string }): Record<string, string | undefined>;
7
+ export declare function probeUpdateLauncherHome(launcher: string, run: Parameters<typeof probeUpdateServiceHome>[0],
8
+ node: string, env: Record<string, string | undefined>, read?: (path: string) => string): UpdateServiceHomeAuthority;
9
+ export declare function probeUpdateServiceHome(
10
+ run: (bin: string, args: string[], options: SpawnSyncOptionsWithStringEncoding) => { status: number | null; stdout?: unknown; error?: unknown; signal?: unknown },
11
+ bin: string, prefix: string[], options?: { requireLauncher?: boolean; env?: Record<string, string | undefined> },
12
+ ): UpdateServiceHomeAuthority;
13
+
14
+ export declare function probeUpdatePackageOnlyLauncher(launcher: string, run: Parameters<typeof probeUpdateServiceHome>[0],
15
+ node: string, env: Record<string, string | undefined>, read?: (path: string) => string): boolean;
@@ -0,0 +1,79 @@
1
+ import { parseUpdateHomeProbe, UPDATE_PACKAGE_ONLY_PROTOCOL_VERSION } from "./service-home-policy.mjs";
2
+ import { readFileSync, statSync } from "node:fs";
3
+ import { dirname, join } from "node:path";
4
+
5
+ export const UPDATE_HOME_PROBE_ARGS = ["__update-home-probe"];
6
+
7
+ /** A trusted installed-file compatibility claim, not a tamper attestation.
8
+ * Never execute an old launcher merely to ask whether it supports this protocol.
9
+ * @param {string} launcher @param {(path: string) => string} [read] */
10
+ export function supportsUpdateHomeProbe(launcher, read = path => {
11
+ if (statSync(path).size > 4096) throw new Error("oversized declaration");
12
+ return readFileSync(path, "utf8");
13
+ }) {
14
+ try {
15
+ const value = JSON.parse(read(join(dirname(launcher), "..", "src", "update", "service-home-protocol.json")));
16
+ return value?.schemaVersion === 1 && value?.launcherProtocolVersion === 1
17
+ && value?.entry === "__update-home-probe" && Object.keys(value).length === 3;
18
+ } catch { return false; }
19
+ }
20
+
21
+ /** Preserve user/home/auth inputs; remove only internal launch/service/delegation tokens.
22
+ * @param {Record<string, string | undefined>} env
23
+ * @param {{ codexHome: string, opencodexHome: string }} homes */
24
+ export function updateHomeProbeEnvironment(env, homes) {
25
+ const clean = { ...env, CODEX_HOME: homes.codexHome, OPENCODEX_HOME: homes.opencodexHome };
26
+ for (const key of ["OCX_NODE_LAUNCH_CONTEXT", "OCX_PRE_BUN_ANTHROPIC_ENV", "OCX_SERVICE", "OCX_SERVICE_MANAGED",
27
+ "OCX_UPDATE_RESTART_CHILD", "OCX_OWNERSHIP_MUTATION_LEASE_TOKEN", "OCX_SIBLING_OF_PORT", "OCX_SIBLING_HANDOFF_NONCE",
28
+ "OCX_BUN_RUNTIME_SOURCE", "OCX_BUN_RUNTIME_PATH"]) delete clean[key];
29
+ return clean;
30
+ }
31
+
32
+ /** @param {string} launcher @param {Parameters<typeof probeUpdateServiceHome>[0]} run
33
+ * @param {string} node @param {Record<string, string | undefined>} env
34
+ * @param {(path: string) => string} [read] */
35
+ export function probeUpdateLauncherHome(launcher, run, node, env, read) {
36
+ if (!supportsUpdateHomeProbe(launcher, read)) return { kind: "unknown" };
37
+ return probeUpdateServiceHome(run, node, [launcher], { requireLauncher: true, env });
38
+ }
39
+
40
+ /** A narrow local subprocess protocol. It never falls back to ordinary status.
41
+ * @param {(bin: string, args: string[], options: object) => { status: number | null, stdout?: unknown, error?: unknown, signal?: unknown }} run
42
+ * @param {string} bin @param {string[]} prefix
43
+ * @param {{ requireLauncher?: boolean, env?: Record<string, string | undefined> }} [options]
44
+ * @returns {import('./service-home-policy.mjs').UpdateServiceHomeAuthority} */
45
+ export function probeUpdateServiceHome(run, bin, prefix, { requireLauncher = false, env } = {}) {
46
+ try {
47
+ const result = run(bin, [...prefix, ...UPDATE_HOME_PROBE_ARGS], {
48
+ encoding: "utf8", timeout: 8_000, maxBuffer: 4096, windowsHide: true,
49
+ stdio: ["ignore", "pipe", "ignore"], ...(env ? { env } : {}),
50
+ });
51
+ if (result.status !== 0 || result.error || result.signal || typeof result.stdout !== "string"
52
+ || Buffer.byteLength(result.stdout, "utf8") > 4096) return { kind: "unknown" };
53
+ return parseUpdateHomeProbe(JSON.parse(result.stdout), { requireLauncher });
54
+ } catch { return { kind: "unknown" }; }
55
+ }
56
+
57
+ /** Separate capability: keep the original home-probe declaration readable by running v1 updaters.
58
+ * @param {string} launcher @param {Parameters<typeof probeUpdateServiceHome>[0]} run
59
+ * @param {string} node @param {Record<string, string | undefined>} env
60
+ * @param {(path: string) => string} [read] */
61
+ export function probeUpdatePackageOnlyLauncher(launcher, run, node, env, read = path => {
62
+ if (statSync(path).size > 4096) throw new Error("oversized declaration");
63
+ return readFileSync(path, "utf8");
64
+ }) {
65
+ if (!supportsUpdateHomeProbe(launcher, read)) return false;
66
+ try {
67
+ const declaration = JSON.parse(read(join(dirname(launcher), "..", "src", "update", "service-home-package-only-protocol.json")));
68
+ if (declaration?.schemaVersion !== 1 || declaration?.packageOnlyProtocolVersion !== UPDATE_PACKAGE_ONLY_PROTOCOL_VERSION
69
+ || declaration?.entry !== "__update-package-only-probe" || Object.keys(declaration).length !== 3) return false;
70
+ const result = run(node, [launcher, "__update-package-only-probe"], {
71
+ encoding: "utf8", timeout: 8_000, maxBuffer: 4096, windowsHide: true,
72
+ stdio: ["ignore", "pipe", "ignore"], env,
73
+ });
74
+ if (result.status !== 0 || result.error || result.signal || typeof result.stdout !== "string"
75
+ || Buffer.byteLength(result.stdout, "utf8") > 4096) return false;
76
+ const response = JSON.parse(result.stdout);
77
+ return response?.schemaVersion === 1 && response?.packageOnlyProtocolVersion === UPDATE_PACKAGE_ONLY_PROTOCOL_VERSION && Object.keys(response).length === 2;
78
+ } catch { return false; }
79
+ }
@@ -0,0 +1 @@
1
+ {"schemaVersion":1,"launcherProtocolVersion":1,"entry":"__update-home-probe"}
@@ -13,8 +13,8 @@ export declare const SYSTEMD_SERVICE_UNIT: string;
13
13
  export declare function parseLaunchdJobPid(printOutput: string): number | null;
14
14
  export declare function parseSystemdMainPid(showOutput: string): number | null;
15
15
  export declare function hasRestartableServiceManager(deps?: ServiceManagerDeps): boolean;
16
- export declare function restartServiceManagerJob(deps?: ServiceManagerDeps):
17
- { ok: true } | { ok: false; reason: string; unsettled?: true };
16
+ export declare function restartServiceManagerJob(deps?: ServiceManagerDeps, authorizeMutation?: import("./mutation-guard.mjs").UpdateMutationAuthorizer):
17
+ { ok: true } | { ok: false; reason: string; unsettled?: true; refused?: true };
18
18
  export declare function freshServingPid(recordPid: number, staleRecordPid: number | null): number | null;
19
19
  export declare function unsettledManagerWarning(port: number): string;
20
20
  export declare function readServiceManagerPid(deps?: ServiceManagerDeps): number | null;
@@ -1,4 +1,4 @@
1
- import { spawnSync } from "node:child_process";
1
+ import { guardedRun, guardedSpawnSync, UpdateMutationRefusedError } from "./mutation-guard.mjs";
2
2
 
3
3
  /**
4
4
  * Manager-mediated runtime recovery after an update (#7043).
@@ -26,7 +26,7 @@ function positivePid(value) {
26
26
  return Number.isSafeInteger(pid) && pid > 0 ? pid : null;
27
27
  }
28
28
 
29
- function defaultRun(file, args) {
29
+ function defaultRun(file, args, authorizeMutation = () => true) {
30
30
  // An armed test process must never reach the developer's real launchd or systemd job;
31
31
  // same refusal as `assertLiveServiceManagerAllowed` for the TypeScript service layer.
32
32
  if (process.env.OCX_TEST_HOME_GUARD === "1") {
@@ -37,7 +37,7 @@ function defaultRun(file, args) {
37
37
  const env = file === "systemctl" && !process.env.XDG_RUNTIME_DIR && typeof process.getuid === "function"
38
38
  ? { ...process.env, XDG_RUNTIME_DIR: `/run/user/${process.getuid()}` }
39
39
  : process.env;
40
- const result = spawnSync(file, args, { encoding: "utf8", timeout: 20_000, windowsHide: true, env });
40
+ const result = guardedSpawnSync(authorizeMutation, "service", file, args, { encoding: "utf8", timeout: 20_000, windowsHide: true, env });
41
41
  if (result.error) {
42
42
  // A timeout kills only the waiting client; the manager's queued job keeps running.
43
43
  const timedOut = result.error.code === "ETIMEDOUT";
@@ -79,17 +79,24 @@ export function hasRestartableServiceManager(deps = {}) {
79
79
  * waiting while the manager may still complete the restart: callers must not start a competing
80
80
  * proxy on that answer.
81
81
  */
82
- export function restartServiceManagerJob(deps = {}) {
83
- const { platform, uid, run } = resolve(deps);
82
+ export function restartServiceManagerJob(deps = {}, authorizeMutation = () => false) {
83
+ try {
84
+ const { platform, uid } = resolve(deps);
85
+ const run = deps.run ?? ((file, args) => defaultRun(file, args, authorizeMutation));
84
86
  const result = platform === "darwin"
85
- ? run("/bin/launchctl", ["kickstart", "-k", launchdTarget(uid)])
87
+ ? guardedRun(authorizeMutation, "service", run, ["/bin/launchctl", ["kickstart", "-k", launchdTarget(uid)]])
86
88
  : platform === "linux"
87
- ? run("systemctl", ["--user", "restart", SYSTEMD_SERVICE_UNIT])
89
+ ? guardedRun(authorizeMutation, "service", run, ["systemctl", ["--user", "restart", SYSTEMD_SERVICE_UNIT]])
88
90
  : null;
89
91
  if (result === null) return { ok: false, reason: "no launchd or systemd manager on this platform" };
90
92
  if (result.timedOut) return { ok: false, unsettled: true, reason: "the service manager did not finish the restart in time" };
91
93
  if (!result.ok) return { ok: false, reason: result.stderr.split("\n")[0] || "the service manager refused the restart" };
92
94
  return { ok: true };
95
+ } catch (error) {
96
+ return error instanceof UpdateMutationRefusedError
97
+ ? { ok: false, refused: true, reason: "Automatic service restart refused; check 'ocx service status'." }
98
+ : { ok: false, reason: "the service manager restart failed" };
99
+ }
93
100
  }
94
101
 
95
102
  /** The manager's main PID for the job, or null when it reports none. Never throws. */
@@ -39,12 +39,14 @@ type NpmUpdateOptions = {
39
39
  runNpm: (args: string[]) => NpmInstallResult;
40
40
  /** npm cache root the pre-flight resolved and checked; pinned with `--cache` for staging. */
41
41
  cachePath?: string;
42
+ /** Synchronous authorization after staging/verification, immediately before the live swap. */
43
+ mayReplacePackage?: () => boolean;
42
44
  log?: (line: string) => void;
43
45
  deps?: UpdateFsDeps;
44
46
  };
45
47
  type NpmUpdateResult = {
46
48
  ok: boolean;
47
- phase: "stage" | "verify" | "swap-backup" | "swap-live" | "post-verify" | "double-fault" | "done";
49
+ phase: "stage" | "verify" | "authorize" | "swap-backup" | "swap-live" | "post-verify" | "double-fault" | "done";
48
50
  error?: string;
49
51
  rolledBack?: boolean;
50
52
  backup?: string;