@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
@@ -1,6 +1,26 @@
1
1
  import type { ServiceChildOwnershipDecision } from "../service/service-child-ownership";
2
+ import { removePidIfValueIs } from "../config/process-state";
3
+ import { observeProxyLiveness, START_OWNERSHIP_LIVENESS, type LiveProxy } from "../server/proxy-liveness";
4
+ import { markCrossHomeSibling, reconcileStartupJournal } from "./cross-home-owner";
2
5
 
3
- /** Fence shared client-state recovery against a claim committed after the early owner probe. */
6
+ /** Called only under the ownership lease; a negative early probe grants no mutation authority. */
7
+ export async function recoverStartJournalAfterOwnerRecheck(
8
+ owner: { live: LiveProxy | null; pidSnapshot: number | null },
9
+ sibling = false,
10
+ ): Promise<boolean> {
11
+ const observation = await observeProxyLiveness(START_OWNERSHIP_LIVENESS);
12
+ owner.live = observation.live;
13
+ if (owner.live) return sibling;
14
+ if (observation.kind !== "absent") {
15
+ throw new Error("Proxy ownership is unverified; startup refused. PID record and recovery journal were preserved. Retry when the owner can be verified.");
16
+ }
17
+ removePidIfValueIs(owner.pidSnapshot);
18
+ if (!sibling) sibling = await markCrossHomeSibling();
19
+ if (!sibling) reconcileStartupJournal();
20
+ return sibling;
21
+ }
22
+
23
+ /** Hold ownership stable through the final liveness check and shared-state recovery. */
4
24
  export async function recoverStartStateUnderOwnershipLease(deps: {
5
25
  supervised: boolean;
6
26
  acquireLease: () => { release(): void };
@@ -8,7 +28,6 @@ export async function recoverStartStateUnderOwnershipLease(deps: {
8
28
  stayOut: (refusal: string) => never;
9
29
  recover: () => Promise<boolean>;
10
30
  }): Promise<boolean> {
11
- if (!deps.supervised) return deps.recover();
12
31
  const lease = deps.acquireLease();
13
32
  let released = false;
14
33
  const release = () => {
@@ -17,7 +36,7 @@ export async function recoverStartStateUnderOwnershipLease(deps: {
17
36
  lease.release();
18
37
  };
19
38
  try {
20
- const decision = deps.decide();
39
+ const decision = deps.supervised ? deps.decide() : { kind: "proceed" as const };
21
40
  if (decision.kind === "stay-out") {
22
41
  // stayOut exits the process, so a finally block would never release the lease.
23
42
  release();
@@ -0,0 +1,28 @@
1
+ import { isLinkConnectionGeneration } from "../link/relay-auth";
2
+ import { validateReadyzBody, type LiveProxy } from "../server/proxy-liveness";
3
+
4
+ const STATUS_LINK_TIMEOUT_MS = 2_000;
5
+
6
+ /**
7
+ * `ocx status --json` `link.connectionGeneration` on a Remote Link Child: the tunnel connection the
8
+ * live client runtime names in a ready `/readyz`. It changes on every tunnel connect and on a
9
+ * runtime restart. Undefined, never null, when no client runtime answers ready with a valid
10
+ * value; it never fails the status report.
11
+ */
12
+ export async function collectLinkConnectionGeneration(
13
+ live: Pick<LiveProxy, "pid" | "port" | "role"> | null,
14
+ deps: { fetchImpl?: typeof fetch } = {},
15
+ ): Promise<string | undefined> {
16
+ if (!live || live.role !== "client") return undefined;
17
+ try {
18
+ const response = await (deps.fetchImpl ?? fetch)(`http://127.0.0.1:${live.port}/readyz`, {
19
+ signal: AbortSignal.timeout(STATUS_LINK_TIMEOUT_MS), redirect: "manual",
20
+ });
21
+ if (response.status !== 200) return undefined;
22
+ const body: unknown = await response.json();
23
+ if (!validateReadyzBody(body, live.port, live.pid === null ? {} : { expectedPid: live.pid })?.ready) return undefined;
24
+ const link = (body as { link?: unknown }).link;
25
+ const generation = link && typeof link === "object" ? (link as { connectionGeneration?: unknown }).connectionGeneration : undefined;
26
+ return isLinkConnectionGeneration(generation) ? generation : undefined;
27
+ } catch { return undefined; }
28
+ }
package/src/cli/status.ts CHANGED
@@ -38,6 +38,8 @@ import { LOCAL_MANAGEMENT_READ_PATHS } from "../lib/local-management-capability"
38
38
  import { fetchBoundLocalManagementRead } from "../server/local-management-read-client";
39
39
  import { collectAppliedCodexSettingsStatus, type CliAppliedCodexSettingsStatus } from "./status-codex-settings";
40
40
  import { installDetectionStatus, type InstallDetectionStatus } from "./status-install";
41
+ import { collectLocalCredentials, type LocalCredentialSnapshot } from "../local-credentials/inventory";
42
+ import { collectLinkConnectionGeneration } from "./status-link";
41
43
 
42
44
  /**
43
45
  * The state of the data-plane admission secret the SERVICE will use. State only -- never the value.
@@ -119,6 +121,14 @@ export type CliRemoteHubStatus = {
119
121
  };
120
122
 
121
123
  export type CliStatusJson = {
124
+ /**
125
+ * This installation's stored provider credentials, counted passively, with an opaque generation
126
+ * that changes on every credential publication. Omitted when the count cannot be proven complete
127
+ * or no live runtime observes the stores; absence never means zero.
128
+ */
129
+ localCredentials?: LocalCredentialSnapshot;
130
+ /** On a Remote Link Child: the current tunnel connection (`src/cli/status-link.ts`). Omitted when unknown. */
131
+ link?: { connectionGeneration: string };
122
132
  mainAccountHardLock?: CodexMainAccountPolicyHealth;
123
133
  /** OCX-11 fallback state; see src/cli/status-fallback.ts. */
124
134
  fallback?: import("./status-fallback").StatusFallback;
@@ -924,6 +934,9 @@ export async function collectStatus(options: { mainAccountPolicy?: boolean } = {
924
934
  deps: { findLiveProxy: async () => live },
925
935
  })
926
936
  : undefined;
937
+ // Child attestations for GOAT; local reads only, never the Home's projection.
938
+ const localCredentials = options.mainAccountPolicy ? await collectLocalCredentials() : undefined;
939
+ const connectionGeneration = options.mainAccountPolicy ? await collectLinkConnectionGeneration(live) : undefined;
927
940
  const pidFile = readPid();
928
941
  // Preserve an authoritative null from orphan/legacy liveness — do not restore pidFile.
929
942
  const pid = resolveStatusPid(live, pidFile);
@@ -1080,6 +1093,8 @@ export async function collectStatus(options: { mainAccountPolicy?: boolean } = {
1080
1093
  json: {
1081
1094
  ...(mainAccountHardLock ? { mainAccountHardLock } : {}),
1082
1095
  ...(fallback ? { fallback } : {}),
1096
+ ...(localCredentials === undefined ? {} : { localCredentials }),
1097
+ ...(connectionGeneration === undefined ? {} : { link: { connectionGeneration } }),
1083
1098
  schemaVersion: 1,
1084
1099
  runtimeRole: config.runtimeRole ?? "standalone",
1085
1100
  proxy: {
@@ -0,0 +1,48 @@
1
+ import { withConfigMutationLockSync } from "../config";
2
+ import { inspectStopRestoreOwnership } from "../client/restore-ownership";
3
+ export { inspectStopRestoreOwnership, stopRestoreWriteGuard } from "../client/restore-ownership";
4
+ import type { StopRunRecord } from "./stop-report";
5
+ import { clearPendingTeardown, pendingTeardownPathFor } from "../config/pending-teardown";
6
+
7
+ type RestoreRecord = Pick<StopRunRecord, "sharedTeardown" | "receiptClearFailed">;
8
+
9
+ function refuse(record: RestoreRecord): true {
10
+ record.sharedTeardown = "refused";
11
+ console.error("❌ The client connection could not be confirmed (it may be changing); restoration stopped and the obligation is kept. Rerun 'ocx stop'.");
12
+ return true;
13
+ }
14
+
15
+ /** Only the named, discharged nonces are removed; C covers both ownership and unlink. */
16
+ export function clearRestoredStopReceipts(record: RestoreRecord, nonces: string[], restored = true): boolean {
17
+ let entered = false;
18
+ try {
19
+ return withConfigMutationLockSync(() => {
20
+ entered = true;
21
+ const boundary = inspectStopRestoreOwnership();
22
+ if (boundary === "unproven" || boundary === "restore" && !restored) return refuse(record);
23
+ if (boundary === "hub-owned") {
24
+ record.sharedTeardown = "skipped";
25
+ console.log("↩️ A hub connection was committed while this stop ran; it owns Codex routing, its catalog and the Grok config, so restoration stopped.");
26
+ }
27
+ let failed = false;
28
+ for (const nonce of nonces) {
29
+ if (!clearPendingTeardown(nonce)) {
30
+ failed = true;
31
+ record.receiptClearFailed = true;
32
+ console.error(`❌ The shared teardown was discharged, but its receipt could not be removed: ${pendingTeardownPathFor(nonce)}`);
33
+ console.error(" Remove it manually; otherwise every later stop and update will try to recover it again.");
34
+ }
35
+ }
36
+ return failed;
37
+ });
38
+ } catch {
39
+ if (entered) record.receiptClearFailed = true;
40
+ return refuse(record);
41
+ }
42
+ }
43
+
44
+ export function settleUnrestoredStopBoundary(
45
+ boundary: "hub-owned" | "unproven", record: RestoreRecord, nonces: string[],
46
+ ): boolean {
47
+ return boundary === "unproven" ? refuse(record) : clearRestoredStopReceipts(record, nonces, false);
48
+ }
@@ -2,20 +2,32 @@ import { restoreNativeCodexAsync } from "../codex/inject";
2
2
  import type { RetainedCodexProviderTable } from "../codex/inject/restore";
3
3
  import { stripGrokConfig } from "../grok/inject";
4
4
  import { readClientConnectionState, type ClientConnectionState } from "../client/state";
5
+ import { withClientLifecycleSync } from "../client/lifecycle-lock";
6
+ import type { RestoreBoundaryOwnership } from "../client/restore-ownership";
7
+ export type { RestoreBoundaryOwnership } from "../client/restore-ownership";
8
+ import { inspectStopRestoreOwnership, stopRestoreWriteGuard } from "./stop-restore-guard";
9
+ export { clearRestoredStopReceipts, settleUnrestoredStopBoundary } from "./stop-restore-guard";
5
10
  import { readPid, readRuntimePort } from "../config/process-state";
6
11
  import { loadConfig } from "../config";
7
- import { configuredAdminToken } from "../lib/admin-secrets";
8
12
  import { readBoundedResponseBody } from "../lib/bounded-body";
9
- import { gracefulStopHost, isProcessAlive, ProxyOwnershipRefusedError } from "../lib/process-control";
13
+ import { createLocalAttestationChallenge, LOCAL_ATTESTATION_CHALLENGE_HEADER, LOCAL_ATTESTATION_PROOF_HEADER, verifyLocalAttestationProof } from "../lib/local-management-attestation";
14
+ import { LOCAL_MANAGEMENT_READ_PATHS } from "../lib/local-management-capability";
15
+ import { gracefulStopHost, isProcessAlive, ProxyOwnershipRefusedError, stopRequestFetch as directStopRequestFetch } from "../lib/process-control";
10
16
  import { directLocalHttpFetch } from "../server/direct-local-http";
17
+ import { fetchBoundLocalManagementRead } from "../server/local-management-read-client";
18
+ import { isSharedTeardownDeferredOnExit } from "../server/stop-teardown";
11
19
  import { findLiveProxy, probeEndpointLiveness, proveLiveProxyOwnedByHome } from "../server/proxy-liveness";
12
20
  import { observeGuardedManagerStopped } from "../service/guarded-manager-target";
13
21
  import type { StartExitTeardown } from "./dispatch";
14
22
  import type { StopOutcome } from "./stop-report";
15
23
 
16
- /** Re-read ownership when an ordinary runtime actually exits, including after API drain. */
24
+ /** Honor accepted API deferral, otherwise re-read connection ownership on ordinary exit. */
17
25
  export function preserveConnectedClientRoutingOnExit(teardown: StartExitTeardown): StartExitTeardown {
18
- return readClientConnectionState().kind === "connected"
26
+ if (isSharedTeardownDeferredOnExit()) {
27
+ return { ...teardown, restoreNativeCodex: false, stripGrokConfig: false };
28
+ }
29
+ const connection = readClientConnectionState();
30
+ return connection.kind === "connected" && connection.value.transport !== "link"
19
31
  ? { ...teardown, restoreNativeCodex: false, stripGrokConfig: false }
20
32
  : teardown;
21
33
  }
@@ -27,34 +39,53 @@ const unsupportedConnectedStop = () => new ProxyOwnershipRefusedError(
27
39
  "connected_client_stop_unsupported",
28
40
  );
29
41
 
30
- /** A positive, PID-bound contract is required; old and new builds may share a version. */
42
+ /** Require the pinned runtime's proof before accepting its shutdown contract. */
31
43
  export async function assertConnectedClientStopSupported(target: ConnectedStopTarget | null): Promise<void> {
32
44
  if (!target) throw unsupportedConnectedStop();
33
45
  if (!isProcessAlive(target.pid)) return; // A manager may already have ended this exact target.
34
- const origin = `http://${gracefulStopHost(target.hostname)}:${target.port}`;
46
+ const runtime = readRuntimePort(target.pid);
47
+ if (!runtime?.attestationSecret || runtime.pid !== target.pid || runtime.port !== target.port
48
+ || gracefulStopHost(runtime.hostname) !== gracefulStopHost(target.hostname)) throw unsupportedConnectedStop();
49
+ const endpoint = { ...target, hostname: gracefulStopHost(runtime.hostname) };
50
+ const readPinnedRuntime = () => {
51
+ const current = readRuntimePort(target.pid);
52
+ return current?.pid === runtime.pid && current.port === runtime.port && current.hostname === runtime.hostname
53
+ && current.attestationSecret === runtime.attestationSecret ? current : null;
54
+ };
55
+ const origin = `http://${endpoint.hostname}:${endpoint.port}`;
56
+ const deadline = Date.now() + CONNECTED_STOP_PROBE_MS;
35
57
  const signal = AbortSignal.timeout(CONNECTED_STOP_PROBE_MS);
36
- const probe = async (path: string, authenticated: boolean): Promise<Record<string, unknown> | null> => {
37
- try {
38
- const headers: Record<string, string> = {};
39
- if (authenticated) {
40
- const token = configuredAdminToken(process.env.OPENCODEX_HOME?.trim() || undefined, process.env);
41
- if (token) headers["x-opencodex-api-key"] = token;
42
- }
43
- const response = await directLocalHttpFetch(`${origin}${path}`, { method: "GET", headers, redirect: "error", signal },
44
- { timeoutMs: CONNECTED_STOP_PROBE_MS });
45
- if (!response.ok) { void response.body?.cancel().catch(() => {}); return null; }
46
- const body = await readBoundedResponseBody(response, { maxBytes: 4096, signal, fatalUtf8: true });
47
- if (body.truncated) return null;
48
- const parsed: unknown = JSON.parse(body.text);
49
- return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Record<string, unknown> : null;
50
- } catch { return null; }
58
+ const readDocument = async (response: Response): Promise<Record<string, unknown> | null> => {
59
+ if (!response.ok) { void response.body?.cancel().catch(() => {}); return null; }
60
+ const body = await readBoundedResponseBody(response, { maxBytes: 4096, signal, fatalUtf8: true });
61
+ if (body.truncated) return null;
62
+ const parsed: unknown = JSON.parse(body.text);
63
+ return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Record<string, unknown> : null;
51
64
  };
52
- const health = await probe("/healthz", false);
53
- // The native machine listener has always preserved integrations on signal and 404s /api/stop.
54
- if (health?.service === "opencodex" && health.role === "client" && health.pid === target.pid) return;
55
- const capability = await probe("/api/stop", true);
56
- if (capability?.schema === "ocx-stop-capabilities/1"
57
- && capability.pid === target.pid && capability.connectedClientOwnership === true) return;
65
+ try {
66
+ const nonce = createLocalAttestationChallenge();
67
+ const response = await directLocalHttpFetch(`${origin}/healthz`, {
68
+ method: "GET", headers: { [LOCAL_ATTESTATION_CHALLENGE_HEADER]: nonce }, redirect: "error", signal,
69
+ }, { timeoutMs: CONNECTED_STOP_PROBE_MS });
70
+ if (!readPinnedRuntime() || !verifyLocalAttestationProof(runtime.attestationSecret, nonce, target.pid, target.port,
71
+ response.headers.get(LOCAL_ATTESTATION_PROOF_HEADER))) {
72
+ void response.body?.cancel().catch(() => {});
73
+ throw unsupportedConnectedStop();
74
+ }
75
+ const health = await readDocument(response);
76
+ if (!readPinnedRuntime() || health?.service !== "opencodex" || health.pid !== target.pid) throw unsupportedConnectedStop();
77
+ // Native machine listeners preserve integrations on signal and have no /api/stop route.
78
+ if (health.role === "client") return;
79
+ const remaining = deadline - Date.now();
80
+ if (remaining <= 0) throw unsupportedConnectedStop();
81
+ const read = await fetchBoundLocalManagementRead({ ...endpoint, source: "runtime" }, LOCAL_MANAGEMENT_READ_PATHS.stop, {
82
+ readRuntime: readPinnedRuntime, timeoutMs: remaining, requireResponseProof: true,
83
+ });
84
+ if (read.kind !== "response") throw unsupportedConnectedStop();
85
+ const capability = await readDocument(read.response);
86
+ if (readPinnedRuntime() && capability?.schema === "ocx-stop-capabilities/1"
87
+ && capability.pid === target.pid && capability.connectedClientOwnership === true) return;
88
+ } catch { /* A missing or replaced runtime never grants shutdown authority. */ }
58
89
  throw unsupportedConnectedStop();
59
90
  }
60
91
 
@@ -102,17 +133,61 @@ export async function preflightConnectedClientStop(approved?: ConnectedStopTarge
102
133
  * The line `ocx stop` prints in place of the shared teardown on a connected client, or null
103
134
  * when this home is not one (#7563).
104
135
  *
105
- * A hub client or Remote Link Child gets its Codex routing and catalog from `ocx connect` /
106
- * `ocx sync`, and its client runtime never writes them on start. The standalone teardown
136
+ * A hub client gets its Codex routing and catalog from `ocx connect` / `ocx sync`, and its
137
+ * client runtime never writes them on start. The standalone teardown
107
138
  * restored native Codex, rewrote the catalog and stripped the Grok block, and nothing on the
108
139
  * client put any of it back: `ocx start` brought the runtime up with Codex still native and
109
140
  * Grok unconfigured. Leaving them in place makes stop/start a round trip; `ocx disconnect`
110
- * remains the teardown that owns them, with its own ownership checks.
141
+ * remains the teardown that owns them, with its own ownership checks. A Remote Link Child
142
+ * is deliberately excluded: its unauthenticated loopback route is unsafe after the listener exits.
111
143
  */
112
144
  export function connectedClientStopSkipLine(state: ClientConnectionState): string | null {
113
- if (state.kind !== "connected") return null;
114
- const role = state.value.transport === "link" ? "Remote Link Child" : "hub client";
115
- return `↩️ Codex routing, its catalog and the Grok config stay as they are: this ${role}'s connection owns them, and 'ocx start' serves them again. To hand Codex back to its own account, run 'ocx disconnect'.`;
145
+ if (state.kind !== "connected" || state.value.transport === "link") return null;
146
+ return `↩️ Codex routing, its catalog and the Grok config stay as they are: this hub client's connection owns them, and 'ocx start' serves them again. To hand Codex back to its own account, run 'ocx disconnect'.`;
147
+ }
148
+
149
+ /**
150
+ * Transport for the authenticated `POST /api/stop`. The target is always this machine's own
151
+ * runtime, so the request never consults HTTP(S)_PROXY/ALL_PROXY, whatever the connection
152
+ * state is or becomes while the stop awaits: an environment proxy must never receive the admin
153
+ * token. Restoration ownership is decided separately.
154
+ */
155
+ export function stopRequestFetch(): typeof fetch {
156
+ return directStopRequestFetch as typeof fetch;
157
+ }
158
+
159
+ /**
160
+ * Whether the stop caller may accept `sharedTeardown: "not-owned"` as teardown confirmation.
161
+ *
162
+ * Refused only for a positively identified Link connection: its unauthenticated loopback
163
+ * route is unsafe once the listener exits, only an old build answers `not-owned` for one,
164
+ * and it says so while preserving the route this stop must restore. Everything else — a
165
+ * sibling, a hub connection, or no connection at all — has nothing that answer skipped.
166
+ * Callers pass the state read at the POST, not at stop entry: a connect or disconnect
167
+ * committed while the stop is still awaiting decides the ownership the answer describes.
168
+ */
169
+ export function notOwnedTeardownIsAcceptable(state: ClientConnectionState, stoppingSibling: boolean): boolean {
170
+ return stoppingSibling || state.kind !== "connected" || state.value.transport !== "link";
171
+ }
172
+
173
+ /**
174
+ * Re-read connection ownership at the parent restore boundary (#7736). A hub connection
175
+ * committed while the stop was in flight owns Codex routing, the catalog and Grok, so the
176
+ * stop must not restore over it. `ocx connect`/`ocx disconnect` publish connection state
177
+ * under the client lifecycle lock (L), so this early read takes L. Each subsequent write
178
+ * repeats the check under C via stopRestoreWriteGuard; the early read grants no write authority.
179
+ * A busy or failing lock proves nothing either way.
180
+ */
181
+ export function restoreBoundaryOwnership(deps: {
182
+ read?: typeof readClientConnectionState;
183
+ withLifecycle?: typeof withClientLifecycleSync;
184
+ } = {}): RestoreBoundaryOwnership {
185
+ const read = deps.read ?? readClientConnectionState;
186
+ try {
187
+ return (deps.withLifecycle ?? withClientLifecycleSync)(() => inspectStopRestoreOwnership(read));
188
+ } catch {
189
+ return "unproven";
190
+ }
116
191
  }
117
192
 
118
193
  /**
@@ -134,12 +209,14 @@ export function connectedClientStopSkipLine(state: ClientConnectionState): strin
134
209
  */
135
210
  export async function restoreSharedClientStateAfterStop(
136
211
  reportRetainedCodexProviderTable: (retained: RetainedCodexProviderTable) => void,
137
- ): Promise<{ historyOnly: boolean; historyDeferred: boolean; other: boolean }> {
212
+ ): Promise<{ historyOnly: boolean; historyDeferred: boolean; other: boolean; boundary?: "hub-owned" | "unproven" }> {
138
213
  let historyOnly = false;
139
214
  let historyDeferred = false;
140
215
  let other = false;
216
+ const guard = stopRestoreWriteGuard();
141
217
  try {
142
- const result = await restoreNativeCodexAsync();
218
+ const result = await restoreNativeCodexAsync({ withWriteGuard: guard.run });
219
+ if (guard.boundary() !== "restore") throw new Error("stop_restore_ownership_changed");
143
220
  if (result.success) {
144
221
  console.log(`↩️ ${result.message}`);
145
222
  if (result.retainedCodexProviderTable) {
@@ -169,16 +246,20 @@ export async function restoreSharedClientStateAfterStop(
169
246
  console.error(`⚠️ ${result.message}`);
170
247
  }
171
248
  } catch (error) {
249
+ const boundary = guard.boundary();
250
+ if (boundary !== "restore") return { historyOnly: false, historyDeferred: false, other: false, boundary };
172
251
  other = true;
173
252
  console.error(`⚠️ Native Codex restore failed: ${error instanceof Error ? error.message : String(error)}`);
174
253
  }
175
254
 
176
255
  // A refused or thrown Grok strip is actionable because it would point Grok at a dead proxy.
177
256
  try {
178
- const grok = stripGrokConfig();
257
+ const grok = guard.run(() => stripGrokConfig());
179
258
  if (grok.changed) console.log(`↩️ ${grok.message}`);
180
259
  else if (!grok.ok) { other = true; console.error(`⚠️ ${grok.message}`); }
181
260
  } catch (error) {
261
+ const boundary = guard.boundary();
262
+ if (boundary !== "restore") return { historyOnly, historyDeferred, other, boundary };
182
263
  other = true;
183
264
  console.error(`⚠️ Grok config restore failed: ${error instanceof Error ? error.message : String(error)}`);
184
265
  }
@@ -29,6 +29,8 @@ const USAGE = `Usage:
29
29
  ocx system codex-cli-update attest [--json]
30
30
  ocx system codex-cli-update attest --candidate <absolute-path> --npm-prefix <absolute-path> --npm-cli <absolute-path> --node <absolute-path> [--json]
31
31
  ocx system codex-cli-update plan [--channel latest] [--json]
32
+ ocx system codex-cli-update apply --plan-id <32-hex> --yes [--request-id <key>] [--json]
33
+ ocx system codex-cli-update status <job-id> [--json]
32
34
  ocx system update check [--channel <latest|preview>] [--json]
33
35
  ocx system update run [--channel <latest|preview>] [--restart <on|off>] --yes [--json]
34
36
  ocx system update status <job-id> [--json]
package/src/cli/v2.ts CHANGED
@@ -17,7 +17,8 @@ import { localV2State, v2LocalSyncResult, type V2LocalSync } from "./v2-local-ou
17
17
  import { execFileSync } from "node:child_process";
18
18
  import { getAgentsEnabled, getAgentsMaxDepth, getLogicalMaxThreads, getMultiAgentModeHintText, getSubagentDeveloperInstructions, hasAgentsMaxThreads, isMultiAgentV2Enabled, setMultiAgentModeHintText, transitionMultiAgentV2 } from "../codex/features";
19
19
 
20
- import { commandInvocation, type SpawnInvocation } from "../lib/win-exec";
20
+ import type { ResolveDeps, SpawnInvocation } from "../lib/win-exec";
21
+ import { validatedCodexExecInvocation } from "../codex/exec-boundary";
21
22
  import { deleteConfigTopLevelKey, loadConfig, saveConfig } from "../config";
22
23
  import { resolveAndPersistCodexRuntime, type ResolveCodexRuntimeDeps } from "../codex/runtime";
23
24
 
@@ -33,8 +34,9 @@ export interface V2CliDeps {
33
34
  }
34
35
 
35
36
  export type CodexFeaturesInvocationDeps =
36
- & Parameters<typeof commandInvocation>[3]
37
- & Pick<ResolveCodexRuntimeDeps, "existsSync" | "execFileSync" | "configDir" | "readFileSync">
37
+ & ResolveDeps
38
+ & Pick<ResolveCodexRuntimeDeps, "existsSync" | "execFileSync" | "configDir" | "readFileSync"
39
+ | "readBundleIdentifier" | "macBundleTrustReason" | "executable" | "realpath">
38
40
  & { requireAvailable?: boolean };
39
41
 
40
42
  /**
@@ -58,12 +60,23 @@ export function codexFeaturesInvocation(
58
60
  execFileSync: deps.execFileSync,
59
61
  configDir: deps.configDir,
60
62
  readFileSync: deps.readFileSync,
63
+ readBundleIdentifier: deps.readBundleIdentifier,
64
+ macBundleTrustReason: deps.macBundleTrustReason,
65
+ executable: deps.executable,
66
+ realpath: deps.realpath,
61
67
  });
62
68
  if (deps.requireAvailable && resolved.runtime.source === "fallback" && resolved.runtime.version === null) {
63
69
  throw Object.assign(new Error("spawn codex ENOENT"), { code: "ENOENT" });
64
70
  }
65
71
  const command = resolved.runtime.command || "codex";
66
- return commandInvocation(command, ["features", action, feature], platform, deps);
72
+ return validatedCodexExecInvocation(command, ["features", action, feature], {
73
+ env: deps.env,
74
+ platform,
75
+ exists: deps.exists,
76
+ executable: deps.executable,
77
+ realpath: deps.realpath,
78
+ macBundleTrustReason: deps.macBundleTrustReason,
79
+ });
67
80
  }
68
81
 
69
82
  /**
@@ -42,7 +42,7 @@ function preparePath(lockPath: string): void {
42
42
  mkdirSync(directory, { recursive: true, mode: 0o700 });
43
43
  assertPath(directory, true);
44
44
  if (process.platform !== "win32") chmodSync(directory, 0o700);
45
- hardenSecretDir(directory, { required: true });
45
+ hardenSecretDir(directory, { required: true, verifyExistingRuntimeDirectory: true });
46
46
  // Create privately before SQLite opens it; refuse an existing symlink or hardlink
47
47
  // before chmod/ACL operations or the database constructor can follow it.
48
48
  try { closeSync(openSync(lockPath, "wx", 0o600)); }
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The last tunnel connection a Home-initiated link's Home proved to this Child (relay-auth.ts).
3
+ * Every authenticated relay answer replaces it: a bound generation records it, and an answer
4
+ * without one (an older Home, a missing or mismatched proof) makes it unknown. Process memory
5
+ * only, so a restart forgets it.
6
+ */
7
+ const verified = new Map<string, string>();
8
+
9
+ export function recordVerifiedHomeConnection(linkId: string, generation: string): void {
10
+ verified.set(linkId, generation);
11
+ }
12
+
13
+ export function forgetVerifiedHomeConnection(linkId: string): void {
14
+ verified.delete(linkId);
15
+ }
16
+
17
+ export function verifiedHomeConnection(linkId: string): string | undefined {
18
+ return verified.get(linkId);
19
+ }
@@ -8,9 +8,11 @@ import { packageVersion } from "../lib/package-version";
8
8
  import { linkPeerReportHeaders } from "../link/peer-report";
9
9
  import { buildPeerFeatures } from "../remote/features";
10
10
  import {
11
- LINK_RELAY_AUTH_PATH, LINK_RELAY_AUTH_TIMEOUT_MS, LINK_RELAY_AUTH_VERSION,
12
- LINK_RELAY_PROBE_HEADER, LINK_RELAY_SESSION_HEADER, linkRelayChallenge, linkRelayProofMatches,
11
+ LINK_RELAY_AUTH_PATH, LINK_RELAY_AUTH_TIMEOUT_MS, LINK_RELAY_AUTH_VERSION, LINK_RELAY_CONNECTION_HEADER,
12
+ LINK_RELAY_CONNECTION_PROOF_HEADER, LINK_RELAY_PROBE_HEADER, LINK_RELAY_SESSION_HEADER, linkConnectionProof,
13
+ linkRelayChallenge, linkRelayProofMatches,
13
14
  } from "../link/relay-auth";
15
+ import { forgetVerifiedHomeConnection, recordVerifiedHomeConnection } from "./link-connection";
14
16
 
15
17
  export interface BoundLinkRelayTarget {
16
18
  tunnelPort: number;
@@ -172,6 +174,22 @@ function relayChallenge(target: BoundLinkRelayTarget, origin: URL) {
172
174
  return { challenge, probe, headers: peerReport };
173
175
  }
174
176
 
177
+ /**
178
+ * Called only after the Home's relay proof verified. Keep its connection generation when its own
179
+ * proof binds it to this nonce and key; otherwise the connection is unknown, never the old value.
180
+ */
181
+ function noteHomeConnection(target: BoundLinkRelayTarget, nonce: string, headers: IncomingMessage["headers"]): void {
182
+ if (!target.linkId || !target.apiKeyId) return;
183
+ const generation = headers[LINK_RELAY_CONNECTION_HEADER];
184
+ const proof = headers[LINK_RELAY_CONNECTION_PROOF_HEADER];
185
+ const expected = typeof generation === "string"
186
+ ? linkConnectionProof(serviceApiTokenFingerprint(target.admissionKey), target.apiKeyId, target.linkId, nonce, generation)
187
+ : null;
188
+ if (typeof generation === "string" && typeof proof === "string" && linkRelayProofMatches(proof, expected)) {
189
+ recordVerifiedHomeConnection(target.linkId, generation);
190
+ } else forgetVerifiedHomeConnection(target.linkId);
191
+ }
192
+
175
193
  /**
176
194
  * The outcome of the credential-free preflight alone: `ok` when the Home answered with a proof
177
195
  * only the holder of the link key can make, `unrecognized` for a peer without the route (404),
@@ -201,7 +219,10 @@ export async function probeLinkRelayPreflight(
201
219
  method: "GET", signal: deadline.signal, headers: { ...request.headers, [LINK_RELAY_PROBE_HEADER]: "1" },
202
220
  }, agent);
203
221
  const proof = response.headers["x-opencodex-link-proof"];
204
- if (response.statusCode === 204 && typeof proof === "string" && linkRelayProofMatches(proof, request.challenge.expected)) return "ok";
222
+ if (response.statusCode === 204 && typeof proof === "string" && linkRelayProofMatches(proof, request.challenge.expected)) {
223
+ noteHomeConnection(target, request.challenge.nonce, response.headers);
224
+ return "ok";
225
+ }
205
226
  return response.statusCode === 404 ? "unrecognized" : "auth_failed";
206
227
  } catch {
207
228
  return "unreachable";
@@ -236,6 +257,7 @@ export async function fetchBoundLinkRelay(
236
257
  if (response.statusCode !== 204 || typeof proof !== "string" || !linkRelayProofMatches(proof, challenge.expected)) {
237
258
  throw new LinkRelayAuthenticationError(response.statusCode === 404);
238
259
  }
260
+ noteHomeConnection(target, challenge.nonce, response.headers);
239
261
  // Drain the credential-free response before the Agent can reuse its socket.
240
262
  for await (const chunk of response) {
241
263
  if (chunk.length) throw new LinkRelayAuthenticationError();
@@ -26,6 +26,7 @@ import type { LinkDiagnosticSink } from "../link/diagnostics";
26
26
  import { isLinkConnection, readClientConnectionState } from "./state";
27
27
  import { clientLinkStatePath, readClientLinkState, type ClientLinkState } from "./link-state";
28
28
  import type { LinkTunnelGate, LinkAdmissionResult } from "./link-relay";
29
+ import { nextLinkConnectionGeneration } from "../link/relay-auth";
29
30
 
30
31
  /**
31
32
  * The client-owned `ssh -N -L 127.0.0.1:<tunnelPort>:127.0.0.1:<peerListenerPort> <alias>`
@@ -106,6 +107,8 @@ export interface ClientLinkSupervisor extends LinkTunnelGate {
106
107
  /** Stops the tunnel (TERM, up to 5 s, KILL). The runtime calls this before stopping its listener. */
107
108
  stop(): Promise<void>;
108
109
  status(): ClientLinkSupervisorStatus;
110
+ /** Changes on every transition into connected, initial or recovery; undefined while not connected. */
111
+ connectionGeneration(): string | undefined;
109
112
  }
110
113
 
111
114
  /** Read-only status bridge for a client whose persisted sidecar cannot be trusted. */
@@ -601,6 +604,8 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
601
604
  let adoptedRecord: ClientTunnelPidfile | null = null;
602
605
  let tunnelPort: number | null = null;
603
606
  let ownerGeneration = 0;
607
+ /** Minted on every transition into connected from the process-wide sequence (relay-auth.ts). */
608
+ let connection: string | undefined;
604
609
  let state: TunnelState = IDLE;
605
610
  let linkId: string | null = null;
606
611
  let failure: ClientLinkSupervisorStatus | undefined;
@@ -685,6 +690,7 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
685
690
  };
686
691
 
687
692
  const setState = (next: TunnelState): void => {
693
+ if (next.kind === "connected" && state.kind !== "connected") connection = nextLinkConnectionGeneration();
688
694
  state = next;
689
695
  settleWaiters();
690
696
  };
@@ -984,6 +990,10 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
984
990
  await stopTunnel();
985
991
  failure = undefined;
986
992
  },
993
+ connectionGeneration(): string | undefined {
994
+ if (!started || stopping || failure !== undefined || state.kind !== "connected") return undefined;
995
+ return connection;
996
+ },
987
997
  status(): ClientLinkSupervisorStatus {
988
998
  if (failure) return failure;
989
999
  if (!child && !linkId && adopted === null) return { kind: "stopped" };
@@ -41,6 +41,7 @@ import { linkRouteAllowed } from "../link/routes";
41
41
  import { linkHomeName, linkHomePhrase } from "./link-home";
42
42
  import { relayLinkManagementRead } from "./link-management-relay";
43
43
  import type { ClientRestartAdmission } from "./runtime-restart";
44
+ import { isLinkConnectionGeneration } from "../link/relay-auth";
44
45
 
45
46
  const VERSION = packageVersion("0.0.0");
46
47
  const GUI_SPA_PATHS = new Set([
@@ -72,6 +73,8 @@ export interface MachineListenerDeps {
72
73
  * with `link.reason` while it is not; `/healthz` is unaffected (`link-readiness.ts`).
73
74
  */
74
75
  linkReadiness?: () => LinkReadiness | Promise<LinkReadiness>;
76
+ /** Link mode: the current tunnel connection, reported by a ready `/readyz` for `ocx status`. */
77
+ linkConnectionGeneration?: () => string | undefined;
75
78
  /**
76
79
  * The bound restart (OCX-6). With it, `/healthz` proves this process's identity to a challenge,
77
80
  * advertises `restartCapability` and `startedAt`, and `POST /api/system/restart` accepts a
@@ -204,7 +207,10 @@ export function startMachineListener(
204
207
  return Response.json({ ...identity, status: "pending", ...facts, link: { state: "unavailable", reason: link.reason } },
205
208
  { status: 503, headers: { "Retry-After": "1", "Cache-Control": "no-store" } });
206
209
  }
207
- return Response.json({ ...identity, status: "ready", ...facts, ...(link ? { link: { state: "available" } } : {}) });
210
+ let connectionGeneration: string | undefined;
211
+ try { connectionGeneration = link ? deps.linkConnectionGeneration?.() : undefined; } catch { connectionGeneration = undefined; }
212
+ const linkBody = isLinkConnectionGeneration(connectionGeneration) ? { state: "available", connectionGeneration } : { state: "available" };
213
+ return Response.json({ ...identity, status: "ready", ...facts, ...(link ? { link: linkBody } : {}) });
208
214
  }
209
215
  if (url.pathname.startsWith("/api/machine/hub-relay/")) {
210
216
  if (!relayEnabled) return json404(req);