@bitkyc08/opencodex 2.93.0 → 2.94.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (435) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-DmvwlhQq.js +58 -0
  4. package/gui/dist/assets/Tray-CZatQdoF.js +1 -0
  5. package/gui/dist/assets/index-3EPO_KbX.js +94 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/{quota-summary-BXu4zE8H.js → quota-summary-BHvWg9mi.js} +1 -1
  8. package/gui/dist/index.html +2 -2
  9. package/gui/dist/provider-icons/t3code.svg +4 -0
  10. package/package.json +7 -4
  11. package/src/adapters/anthropic/account-metadata.ts +34 -3
  12. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  13. package/src/adapters/anthropic/passthrough.ts +5 -2
  14. package/src/adapters/anthropic.ts +17 -4
  15. package/src/adapters/antigravity-refusal.ts +29 -0
  16. package/src/adapters/base.ts +11 -1
  17. package/src/adapters/client-fingerprint.ts +43 -9
  18. package/src/adapters/coding-agent/protocol.ts +19 -9
  19. package/src/adapters/command-code.ts +4 -5
  20. package/src/adapters/cursor/catalog.ts +5 -3
  21. package/src/adapters/cursor/claude-id.ts +30 -19
  22. package/src/adapters/cursor/cursor-errors.ts +5 -2
  23. package/src/adapters/cursor/h2-pool.ts +9 -7
  24. package/src/adapters/cursor/http1-bidi.ts +1 -0
  25. package/src/adapters/cursor/live-models.ts +4 -2
  26. package/src/adapters/cursor.ts +4 -1
  27. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  28. package/src/adapters/google-antigravity-replay.ts +13 -2
  29. package/src/adapters/google-antigravity-wire.ts +8 -3
  30. package/src/adapters/google-errors.ts +33 -0
  31. package/src/adapters/google-http.ts +41 -16
  32. package/src/adapters/google-wire-compiler.ts +4 -0
  33. package/src/adapters/google.ts +21 -10
  34. package/src/adapters/kiro/adapter.ts +3 -0
  35. package/src/adapters/kiro/stream.ts +18 -13
  36. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  37. package/src/adapters/openai-chat/messages.ts +22 -10
  38. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  39. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  40. package/src/adapters/openai-chat/wire.ts +9 -0
  41. package/src/adapters/openai-chat.ts +18 -17
  42. package/src/adapters/openai-responses/image-gen.ts +15 -1
  43. package/src/adapters/openai-responses/passthrough.ts +11 -34
  44. package/src/adapters/openai-responses/transport.ts +20 -2
  45. package/src/adapters/openai-responses/usage.ts +34 -0
  46. package/src/adapters/qoder/adapter.ts +9 -15
  47. package/src/adapters/qoder/image-input.ts +52 -0
  48. package/src/adapters/unique-tool-call-ids.ts +2 -2
  49. package/src/adapters/zed-additional-tools.ts +51 -0
  50. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  51. package/src/adapters/zed-json-tokens.ts +166 -0
  52. package/src/adapters/zed-openai-stream.ts +723 -0
  53. package/src/adapters/zed-tool-arguments.ts +79 -0
  54. package/src/adapters/zed.ts +53 -3
  55. package/src/advisor/consult.ts +22 -0
  56. package/src/advisor/runtime.ts +3 -0
  57. package/src/bridge/errors.ts +22 -1
  58. package/src/bridge/response-json.ts +4 -1
  59. package/src/bridge/sse.ts +21 -12
  60. package/src/chat/inbound.ts +13 -2
  61. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  62. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +83 -0
  63. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  64. package/src/claude/desktop-first-party.ts +16 -5
  65. package/src/claude/desktop-gateway-state.ts +4 -0
  66. package/src/claude/inbound-tool-loading.ts +93 -0
  67. package/src/claude/intercept/picker-listener.ts +33 -1
  68. package/src/claude/model-info.ts +29 -4
  69. package/src/claude/outbound.ts +33 -13
  70. package/src/cli/account-main.ts +43 -5
  71. package/src/cli/capabilities-base.ts +22 -5
  72. package/src/cli/capabilities-integrations.ts +4 -4
  73. package/src/cli/claude-desktop.ts +139 -98
  74. package/src/cli/codex-cli-update.ts +102 -48
  75. package/src/cli/codex-launch-auth.ts +93 -0
  76. package/src/cli/codex-launch-command.ts +32 -0
  77. package/src/cli/codex-launch-diagnostics.ts +37 -0
  78. package/src/cli/codex-launch-ownership.ts +307 -0
  79. package/src/cli/codex-launch-policy.ts +84 -0
  80. package/src/cli/codex-launcher.ts +310 -0
  81. package/src/cli/codex-shim-autorestore.ts +2 -0
  82. package/src/cli/config-command.ts +9 -4
  83. package/src/cli/config-mutation.ts +13 -0
  84. package/src/cli/dispatch.ts +13 -7
  85. package/src/cli/effort.ts +19 -14
  86. package/src/cli/ensure-desired-integrations.ts +21 -14
  87. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  88. package/src/cli/export-command.ts +8 -4
  89. package/src/cli/help.ts +3 -1
  90. package/src/cli/index.ts +58 -64
  91. package/src/cli/integration-input.ts +12 -0
  92. package/src/cli/integration-plan-dto.ts +2 -0
  93. package/src/cli/integration-preview.ts +6 -3
  94. package/src/cli/integrations.ts +2 -1
  95. package/src/cli/link-cleanup.ts +8 -23
  96. package/src/cli/link-enrollment.ts +1 -4
  97. package/src/cli/link.ts +1 -1
  98. package/src/cli/loopback-family.ts +2 -31
  99. package/src/cli/models.ts +62 -49
  100. package/src/cli/provider.ts +146 -139
  101. package/src/cli/registry.ts +34 -3
  102. package/src/cli/root.ts +2 -0
  103. package/src/cli/start-owner-fence.ts +22 -3
  104. package/src/cli/status-link.ts +28 -0
  105. package/src/cli/status.ts +15 -0
  106. package/src/cli/stop-restore-guard.ts +48 -0
  107. package/src/cli/stop-restore.ts +117 -36
  108. package/src/cli/system-command.ts +2 -0
  109. package/src/cli/v2.ts +17 -4
  110. package/src/client/lifecycle-lock.ts +1 -1
  111. package/src/client/link-connection.ts +19 -0
  112. package/src/client/link-relay-transport.ts +25 -3
  113. package/src/client/link-tunnel.ts +10 -0
  114. package/src/client/machine-listener.ts +7 -1
  115. package/src/client/restore-ownership.ts +45 -0
  116. package/src/client/runtime.ts +13 -1
  117. package/src/client/state.ts +1 -1
  118. package/src/clients/client-ids.ts +7 -0
  119. package/src/clients/client-path.ts +13 -5
  120. package/src/clients/config-export/agent-clients.ts +3 -6
  121. package/src/clients/config-export/alias-selectors.ts +85 -0
  122. package/src/clients/config-export/contracts.ts +6 -25
  123. package/src/clients/config-export/dsh.ts +8 -1
  124. package/src/clients/config-export/model-metadata.ts +19 -0
  125. package/src/clients/config-export/model-names.ts +31 -0
  126. package/src/clients/config-export/qoder.ts +3 -11
  127. package/src/clients/config-export/t3code.ts +141 -0
  128. package/src/clients/config-export.ts +51 -15
  129. package/src/clients/gentle-shell-path.ts +3 -3
  130. package/src/codex/account-lifecycle.ts +27 -13
  131. package/src/codex/account-store.ts +32 -6
  132. package/src/codex/app-server-processes.ts +84 -1
  133. package/src/codex/auth-api/main-account-probe.ts +50 -11
  134. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  135. package/src/codex/auth-context.ts +45 -4
  136. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  137. package/src/codex/catalog/build-entries.ts +12 -13
  138. package/src/codex/catalog/bundled.ts +59 -9
  139. package/src/codex/catalog/derive-entry.ts +2 -0
  140. package/src/codex/catalog/gather-capture.ts +3 -0
  141. package/src/codex/catalog/metadata.ts +6 -5
  142. package/src/codex/catalog/model-hints.ts +36 -4
  143. package/src/codex/catalog/native-priority.ts +63 -0
  144. package/src/codex/catalog/provider-models.ts +20 -4
  145. package/src/codex/catalog/retained-sync.ts +1 -1
  146. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  147. package/src/codex/cli-install-provenance.ts +57 -29
  148. package/src/codex/cli-installation-identity.ts +1 -1
  149. package/src/codex/cli-installation-limits.ts +7 -0
  150. package/src/codex/cli-update-apply.ts +391 -0
  151. package/src/codex/cli-update-artifacts.ts +257 -0
  152. package/src/codex/cli-update-files.ts +100 -0
  153. package/src/codex/cli-update-inspection-context.ts +49 -0
  154. package/src/codex/cli-update-job-execution.ts +77 -0
  155. package/src/codex/cli-update-job-store-windows.ts +1010 -0
  156. package/src/codex/cli-update-job-worker.ts +393 -0
  157. package/src/codex/cli-update-job.ts +369 -0
  158. package/src/codex/cli-update-lease.ts +71 -0
  159. package/src/codex/cli-update-paths.ts +76 -0
  160. package/src/codex/cli-update-plan.ts +180 -47
  161. package/src/codex/cli-update-recovery.ts +236 -0
  162. package/src/codex/cli-update-selection-gate.ts +235 -0
  163. package/src/codex/cli-update-windows-apply.ts +308 -0
  164. package/src/codex/cli-update-windows-layout.ts +110 -0
  165. package/src/codex/cli-update-windows-observation.ts +91 -0
  166. package/src/codex/cli-update-windows-paths.ts +26 -0
  167. package/src/codex/cli-update-worker-recovery.ts +32 -0
  168. package/src/codex/cli-update-worker.ts +185 -0
  169. package/src/codex/cli-windows-plan-provenance.ts +250 -0
  170. package/src/codex/desktop-app-restart.ts +22 -3
  171. package/src/codex/exec-boundary.ts +208 -0
  172. package/src/codex/forward-transport-headers.ts +80 -0
  173. package/src/codex/history-job.ts +7 -0
  174. package/src/codex/history-provider.ts +5 -2
  175. package/src/codex/history-worker.ts +20 -1
  176. package/src/codex/inject/restore.ts +57 -25
  177. package/src/codex/internal/history-writer.ts +2 -1
  178. package/src/codex/mac-app-bundle.ts +52 -0
  179. package/src/codex/main-account.ts +161 -23
  180. package/src/codex/native-main-auth-temp.ts +3 -2
  181. package/src/codex/native-main-refresh-mode.ts +18 -3
  182. package/src/codex/native-profile-manager.ts +8 -6
  183. package/src/codex/native-profile-store.ts +9 -0
  184. package/src/codex/ocx-compaction-history.ts +3 -2
  185. package/src/codex/prompt-text-probe.ts +211 -69
  186. package/src/codex/quota.ts +9 -0
  187. package/src/codex/role-model-history.ts +253 -0
  188. package/src/codex/runtime.ts +120 -71
  189. package/src/codex/shim-overlay.ts +22 -3
  190. package/src/codex/shim-templates.ts +5 -2
  191. package/src/codex/shim-wrapper-write.ts +136 -0
  192. package/src/codex/shim.ts +24 -125
  193. package/src/codex/windows-cli-child-native.ts +119 -0
  194. package/src/codex/windows-cli-child-pipe.ts +87 -0
  195. package/src/codex/windows-cli-child.ts +260 -0
  196. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  197. package/src/codex/windows-cli-recovery.ts +39 -0
  198. package/src/codex/windows-installation-files.ts +52 -6
  199. package/src/codex/windows-npm-execution.ts +25 -0
  200. package/src/combos/failover.ts +84 -5
  201. package/src/combos/index.ts +1 -0
  202. package/src/combos/resolve.ts +60 -22
  203. package/src/config/atomic-write.ts +75 -22
  204. package/src/config/diagnostics.ts +18 -10
  205. package/src/config/live-reconcile.ts +11 -3
  206. package/src/config/owner-registry.ts +5 -4
  207. package/src/config/persist-unlocked.ts +34 -8
  208. package/src/config/persisted-mutation.ts +7 -0
  209. package/src/config/process-state.ts +9 -5
  210. package/src/config/removed-opencode-free-backup.ts +99 -0
  211. package/src/config/removed-opencode-free.ts +4 -8
  212. package/src/config/salvage.ts +1 -0
  213. package/src/config/schema/config-schema.ts +16 -1
  214. package/src/config/schema/leaf-validators.ts +15 -0
  215. package/src/config.ts +4 -4
  216. package/src/generated/compatibility-version.json +743 -315
  217. package/src/grok/inject.ts +2 -1
  218. package/src/grok/sync.ts +5 -2
  219. package/src/images/loop.ts +14 -5
  220. package/src/integrations/catalog-refresh.ts +1 -1
  221. package/src/integrations/hermes-refresh.ts +28 -0
  222. package/src/integrations/model-name-guard.ts +31 -0
  223. package/src/integrations/mutation-plan.ts +17 -4
  224. package/src/integrations/ownership.ts +3 -0
  225. package/src/integrations/registry.ts +10 -1
  226. package/src/integrations/state.ts +6 -0
  227. package/src/integrations/writer.ts +64 -59
  228. package/src/lib/abort.ts +8 -4
  229. package/src/lib/bounded-body.ts +7 -1
  230. package/src/lib/config-ownership.ts +4 -0
  231. package/src/lib/errors.ts +2 -0
  232. package/src/lib/eventstream-decoder.ts +3 -2
  233. package/src/lib/http-response-semantics.ts +9 -6
  234. package/src/lib/inbound-body-policy.ts +11 -0
  235. package/src/lib/jsonc.ts +7 -2
  236. package/src/lib/local-management-capability.ts +3 -1
  237. package/src/lib/local-upstream.ts +22 -26
  238. package/src/lib/loopback-family.ts +31 -0
  239. package/src/lib/plain-data.ts +7 -5
  240. package/src/lib/process-control.ts +30 -5
  241. package/src/lib/shadow-call.ts +55 -1
  242. package/src/lib/tool-argument-integers.ts +99 -7
  243. package/src/lib/upstream-retry.ts +6 -1
  244. package/src/lib/windows-elevation.ts +34 -11
  245. package/src/lib/windows-owner-acl.ts +272 -32
  246. package/src/lib/windows-secret-acl.ts +310 -44
  247. package/src/lib/windows-service-wrappers.ts +10 -7
  248. package/src/lib/winsw.ts +8 -4
  249. package/src/link/relay-auth.ts +38 -1
  250. package/src/link/remote-platform.ts +11 -23
  251. package/src/link/remote-probe.ts +3 -1
  252. package/src/link/remote-windows.ts +150 -0
  253. package/src/link/ssh-argv.ts +13 -5
  254. package/src/link/store.ts +4 -1
  255. package/src/link/supervisor.ts +9 -0
  256. package/src/local-credentials/generation.ts +238 -0
  257. package/src/local-credentials/inventory.ts +281 -0
  258. package/src/local-credentials/observation-lease.ts +83 -0
  259. package/src/local-credentials/publication-fence.ts +81 -0
  260. package/src/local-credentials/references.ts +36 -0
  261. package/src/local-credentials/runtime-observation.ts +28 -0
  262. package/src/oauth/account-auto-pause-policy.ts +11 -0
  263. package/src/oauth/anthropic-account-refusal.ts +1 -0
  264. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  265. package/src/oauth/anthropic-routing.ts +34 -44
  266. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  267. package/src/oauth/chatgpt.ts +11 -9
  268. package/src/oauth/cursor.ts +8 -2
  269. package/src/oauth/generic-account-failover.ts +33 -2
  270. package/src/oauth/generic-session-affinity.ts +7 -0
  271. package/src/oauth/google-antigravity.ts +29 -5
  272. package/src/oauth/index.ts +1 -0
  273. package/src/oauth/store.ts +32 -4
  274. package/src/protocols/encoders/adapter-events.ts +7 -4
  275. package/src/protocols/encoders/messages.ts +1 -1
  276. package/src/providers/antigravity-account-roster.ts +73 -7
  277. package/src/providers/antigravity-models.ts +8 -4
  278. package/src/providers/api-key-resolve.ts +16 -3
  279. package/src/providers/claude-cli-identity.ts +2 -0
  280. package/src/providers/codex-capacity.ts +3 -2
  281. package/src/providers/free-directory.ts +10 -2
  282. package/src/providers/key-store.ts +7 -2
  283. package/src/providers/provider-id-rewrite.ts +3 -0
  284. package/src/providers/quota/antigravity.ts +6 -4
  285. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  286. package/src/providers/stale-model-roster-migration.ts +3 -0
  287. package/src/quota-pool/assemble.ts +51 -21
  288. package/src/quota-pool/pooled.ts +162 -0
  289. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  290. package/src/responses/apply-patch-envelope.ts +35 -0
  291. package/src/responses/compaction-history-framing.ts +15 -4
  292. package/src/responses/turn-membership.ts +111 -0
  293. package/src/server/advisor-admission-scope.ts +43 -0
  294. package/src/server/audio-upstream.ts +10 -2
  295. package/src/server/auth-cors.ts +23 -0
  296. package/src/server/bind-host.ts +5 -0
  297. package/src/server/chat-completions.ts +17 -2
  298. package/src/server/chat-native.ts +16 -11
  299. package/src/server/claude-messages.ts +9 -1
  300. package/src/server/codex-model-list.ts +46 -0
  301. package/src/server/gui-session.ts +5 -2
  302. package/src/server/inbound-body-admission.ts +21 -13
  303. package/src/server/inbound-body-budget.ts +128 -0
  304. package/src/server/index/link-listener.ts +3 -1
  305. package/src/server/index/link-relay-sessions.ts +9 -2
  306. package/src/server/index/optional-listeners.ts +1 -0
  307. package/src/server/index/serve-options.ts +9 -43
  308. package/src/server/index/websocket-handler.ts +7 -0
  309. package/src/server/index.ts +6 -5
  310. package/src/server/inference/client-encoder-delivery.ts +3 -1
  311. package/src/server/lifecycle.ts +8 -1
  312. package/src/server/management/advisor-routes.ts +26 -9
  313. package/src/server/management/agent-settings-routes.ts +424 -543
  314. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  315. package/src/server/management/claude-code-settings-patch.ts +211 -0
  316. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  317. package/src/server/management/codex-agent-role-routes.ts +79 -2
  318. package/src/server/management/codex-cli-update-routes.ts +55 -0
  319. package/src/server/management/codex-prompt-routes.ts +2 -1
  320. package/src/server/management/config-routes.ts +444 -380
  321. package/src/server/management/consent-session.ts +6 -0
  322. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  323. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  324. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  325. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  326. package/src/server/management/integration-routes.ts +45 -5
  327. package/src/server/management/link-enrollment.ts +21 -32
  328. package/src/server/management/link-route-state.ts +1 -0
  329. package/src/server/management/link-routes.ts +4 -1
  330. package/src/server/management/model-routes.ts +22 -6
  331. package/src/server/management/model-rows.ts +3 -1
  332. package/src/server/management/native-integration-routes.ts +90 -38
  333. package/src/server/management/oauth-account-routes.ts +8 -7
  334. package/src/server/management/route-registry.ts +8 -3
  335. package/src/server/management/session-routes.ts +20 -2
  336. package/src/server/management/shadow-call-validation.ts +43 -2
  337. package/src/server/management/sidebar-routes.ts +2 -1
  338. package/src/server/management/system-restart.ts +47 -7
  339. package/src/server/management-api.ts +61 -51
  340. package/src/server/management-auth.ts +11 -3
  341. package/src/server/messages-native.ts +21 -7
  342. package/src/server/messages-shared.ts +110 -18
  343. package/src/server/persistent-gui-session.ts +155 -0
  344. package/src/server/port-reclaim.ts +29 -5
  345. package/src/server/proxy-liveness.ts +110 -33
  346. package/src/server/request-decompress.ts +5 -1
  347. package/src/server/responses/account-change-state.ts +14 -2
  348. package/src/server/responses/adapter-continuation.ts +5 -4
  349. package/src/server/responses/adapter-delivery.ts +20 -5
  350. package/src/server/responses/adapter-dispatch.ts +39 -45
  351. package/src/server/responses/advisor-plan-slot.ts +3 -0
  352. package/src/server/responses/advisor-slot.ts +4 -2
  353. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  354. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  355. package/src/server/responses/combo-required-tool-contract.ts +2 -1
  356. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  357. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  358. package/src/server/responses/combo-stream-preflight.ts +47 -7
  359. package/src/server/responses/compact.ts +14 -7
  360. package/src/server/responses/compaction-recovery.ts +2 -1
  361. package/src/server/responses/core-auth.ts +2 -1
  362. package/src/server/responses/core-codex-account.ts +1 -0
  363. package/src/server/responses/core-combo-failure.ts +11 -6
  364. package/src/server/responses/core-combo-native.ts +6 -5
  365. package/src/server/responses/core-combo.ts +93 -20
  366. package/src/server/responses/core-options.ts +7 -0
  367. package/src/server/responses/fetch-helpers.ts +5 -1
  368. package/src/server/responses/jev-model-invoke.ts +8 -3
  369. package/src/server/responses/memory-models.ts +3 -2
  370. package/src/server/responses/passthrough-delivery.ts +36 -8
  371. package/src/server/responses/passthrough-dispatch.ts +12 -12
  372. package/src/server/responses/request-prepare.ts +10 -1
  373. package/src/server/responses/request-transport.ts +41 -6
  374. package/src/server/responses/run-turn-execution.ts +11 -3
  375. package/src/server/responses/sidecar-execution.ts +5 -0
  376. package/src/server/responses/turn-membership.ts +30 -0
  377. package/src/server/responses-custom-tool-repair.ts +86 -11
  378. package/src/server/responses-image-gen-repair.ts +1 -1
  379. package/src/server/restart-parent-ownership.ts +49 -0
  380. package/src/server/stop-teardown.ts +46 -9
  381. package/src/server/windows-tcp-drop.ts +4 -2
  382. package/src/service/desktop-recovery-process.ts +341 -0
  383. package/src/service/desktop-recovery.ts +172 -0
  384. package/src/service/windows-ops.ts +6 -3
  385. package/src/service/windows-scheduler.ts +29 -6
  386. package/src/stall-timeout.ts +47 -0
  387. package/src/tray/windows.ts +6 -4
  388. package/src/types/config.ts +61 -10
  389. package/src/types/request.ts +1 -1
  390. package/src/types.ts +1 -0
  391. package/src/update/async-check.ts +4 -3
  392. package/src/update/bind-probe.ts +2 -2
  393. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  394. package/src/update/guarded-port-reclaim.ts +14 -0
  395. package/src/update/guarded-runtime-ops.ts +58 -0
  396. package/src/update/guarded-tray-ops.ts +9 -0
  397. package/src/update/index.ts +196 -58
  398. package/src/update/job-pinned-start.ts +53 -0
  399. package/src/update/job-supervised-restart.ts +23 -6
  400. package/src/update/job-update-home.ts +62 -0
  401. package/src/update/job-update-tray.ts +29 -0
  402. package/src/update/job-windows-restart.ts +39 -0
  403. package/src/update/job.ts +179 -193
  404. package/src/update/mutation-guard.d.mts +30 -0
  405. package/src/update/mutation-guard.mjs +103 -0
  406. package/src/update/notify.ts +2 -2
  407. package/src/update/npm-cache-preflight.mjs +4 -4
  408. package/src/update/npm-install.mjs +5 -3
  409. package/src/update/pnpm-read-policy.mjs +3 -2
  410. package/src/update/proxy-liveness-probe.mjs +2 -2
  411. package/src/update/service-home-authority.ts +35 -0
  412. package/src/update/service-home-package-only-protocol.json +1 -0
  413. package/src/update/service-home-policy.d.mts +25 -0
  414. package/src/update/service-home-policy.mjs +112 -0
  415. package/src/update/service-home-probe-entry.ts +9 -0
  416. package/src/update/service-home-probe.d.mts +15 -0
  417. package/src/update/service-home-probe.mjs +79 -0
  418. package/src/update/service-home-protocol.json +1 -0
  419. package/src/update/supervised-recovery.d.mts +2 -2
  420. package/src/update/supervised-recovery.mjs +14 -7
  421. package/src/update/transactional-install.d.mts +3 -1
  422. package/src/update/transactional-install.mjs +29 -19
  423. package/src/update/update-failure-guidance.mjs +1 -1
  424. package/src/update/worker-launch.ts +3 -3
  425. package/src/vision/anthropic-describe.ts +2 -1
  426. package/src/web-search/anthropic-executor.ts +2 -1
  427. package/src/web-search/anthropic-history.ts +1 -0
  428. package/src/web-search/format-result.ts +3 -2
  429. package/src/web-search/header-deadline.ts +3 -2
  430. package/src/web-search/loop.ts +10 -4
  431. package/src/web-search/parse.ts +191 -38
  432. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  433. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  434. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  435. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
@@ -9,14 +9,27 @@
9
9
  * Desktop.
10
10
  *
11
11
  * Rules, in order:
12
- * - A running Desktop app is the supervisor. Wait for its proxy; never start a competing one.
13
- * - A durable Desktop claim with no running app: start Desktop (hidden, by the path its own
14
- * login registration recorded — LaunchServices never picks the bundle) where that is
15
- * verifiable, then wait. Elsewhere, fail with guidance. A missing Desktop process
16
- * never authorizes a CLI proxy by itself; handing ownership to the CLI stays an explicit
12
+ * - Facts re-observed after the asynchronous recovery inspection keep first refusal:
13
+ * ownership or the process list that cannot be read is not evidence of absence.
14
+ * - Verified native intent wins over every other signal: an independently verified recovery
15
+ * keeps its replacement, including without a claim, while a verified stop refuses. The
16
+ * current bundled CLI (or protected system installation) anchors the executable; the
17
+ * accepted socket, process incarnation and fresh native intent bind the recovery proof.
18
+ * - Conflicting native evidence — drift, contradiction or an unprovable observation on a
19
+ * platform that can verify — refuses even under a durable claim. A claim outranks only
20
+ * the structurally unsupported verdict of a platform with no live-image binding.
21
+ * - An unclaimed start cannot be authorized or suppressed by a name, locator file or
22
+ * unverifiable observation: unknown still refuses; otherwise the ordinary CLI cold start
23
+ * runs. Unsupported per-user installations do not acquire authority from their
24
+ * self-reported identity; use their bundled CLI.
25
+ * - A running Desktop app with a durable Desktop claim is the supervisor. Wait for its proxy;
26
+ * never start a competing one. A process name alone is not ownership evidence. A durable
27
+ * Desktop claim with no running app: start Desktop (hidden, by the path its own login
28
+ * registration recorded — LaunchServices never picks the bundle) where that is verifiable,
29
+ * then wait. Elsewhere, fail with guidance. A missing Desktop process never authorizes a
30
+ * CLI proxy by itself; an unsupported verdict beside an absent observation is
31
+ * contradictory and refuses. Handing ownership to the CLI stays an explicit
17
32
  * `ocx service install` consent step.
18
- * - Ownership or the process list that cannot be read is not evidence of absence: refuse.
19
- * - No claim and no running app: the ordinary CLI cold start.
20
33
  *
21
34
  * Concurrent shim launches share one Desktop launch through a lease file held by a live process;
22
35
  * every caller then waits on the same readiness probe.
@@ -28,6 +41,7 @@ import { homedir } from "node:os";
28
41
  import { basename, dirname, join, posix, win32 } from "node:path";
29
42
  import { getConfigDir } from "../config/paths";
30
43
  import { resolveServiceOwnership } from "../service/state";
44
+ import { inspectDesktopRecovery, type DesktopRecoveryEvidence } from "../service/desktop-recovery";
31
45
 
32
46
  export type DesktopProcessState = "running" | "absent" | "unknown";
33
47
  export type DesktopOwnershipState = "desktop" | "other" | "unknown";
@@ -36,16 +50,28 @@ export type EnsureColdStartPlan =
36
50
  | { kind: "spawn-cli" }
37
51
  | { kind: "wait-desktop" }
38
52
  | { kind: "launch-desktop" }
39
- | { kind: "refuse"; reason: "desktop-unlaunchable" | "unverified" };
53
+ | { kind: "refuse"; reason: "desktop-unlaunchable" | "desktop-stopped" | "unverified" };
40
54
 
41
55
  export function planEnsureColdStart(facts: {
42
56
  ownership: DesktopOwnershipState;
43
57
  desktopProcess: DesktopProcessState;
44
58
  platform: NodeJS.Platform;
59
+ recovery?: DesktopRecoveryEvidence;
45
60
  }): EnsureColdStartPlan {
46
- if (facts.desktopProcess === "running") return { kind: "wait-desktop" };
47
61
  if (facts.ownership === "unknown" || facts.desktopProcess === "unknown") return { kind: "refuse", reason: "unverified" };
48
- if (facts.ownership === "other") return { kind: "spawn-cli" };
62
+ if (facts.recovery?.kind === "recovering") return { kind: "wait-desktop" };
63
+ if (facts.recovery?.kind === "stopped") return { kind: "refuse", reason: "desktop-stopped" };
64
+ // Drifted or contradictory native evidence refuses even under a durable claim; the claim
65
+ // outranks only the structurally unsupported verdict of a platform with no image binding.
66
+ if (facts.recovery?.kind === "unknown" && facts.recovery.unsupported !== true) return { kind: "refuse", reason: "unverified" };
67
+ if (facts.ownership === "other") {
68
+ // An unclaimed start cannot be authorized or suppressed by an unverifiable observation.
69
+ return facts.recovery?.kind === "unknown" ? { kind: "refuse", reason: "unverified" } : { kind: "spawn-cli" };
70
+ }
71
+ if (facts.desktopProcess === "running") return { kind: "wait-desktop" };
72
+ // A matched native process beside an absent observation is contradictory; refuse rather
73
+ // than launch a new app or guess at the supervisor's state.
74
+ if (facts.recovery?.kind === "unknown") return { kind: "refuse", reason: "unverified" };
49
75
  return facts.platform === "darwin" ? { kind: "launch-desktop" } : { kind: "refuse", reason: "desktop-unlaunchable" };
50
76
  }
51
77
 
@@ -61,6 +87,7 @@ export interface DesktopColdStartDeps<T> {
61
87
  platform: NodeJS.Platform;
62
88
  ownership: () => DesktopOwnershipState;
63
89
  desktopProcess: () => DesktopProcessState;
90
+ desktopRecovery?: () => Promise<DesktopRecoveryEvidence>;
64
91
  /** Start the Desktop app hidden. Returns false when the request could not be made. */
65
92
  launchDesktop: () => boolean;
66
93
  /** Returns a release function when this caller should launch, or null when another caller already did. */
@@ -72,15 +99,18 @@ export interface DesktopColdStartDeps<T> {
72
99
  const QUIT_HINT = "To run the proxy from this CLI instead, quit OpenCodex and run `ocx service install` or `ocx start`.";
73
100
 
74
101
  export async function runDesktopColdStart<T>(deps: DesktopColdStartDeps<T>): Promise<DesktopColdStartResult<T>> {
102
+ const recovery = await deps.desktopRecovery?.();
75
103
  const plan = planEnsureColdStart({
76
104
  ownership: deps.ownership(),
77
105
  desktopProcess: deps.desktopProcess(),
78
106
  platform: deps.platform,
107
+ recovery,
79
108
  });
80
109
  if (plan.kind === "spawn-cli") return { kind: "cli" };
81
110
  if (plan.kind === "refuse") {
82
111
  return { kind: "failed", message: plan.reason === "unverified"
83
112
  ? "Could not verify whether OpenCodex Desktop manages this proxy, so no CLI proxy was started. Run `ocx doctor`, or start the proxy explicitly with `ocx start`."
113
+ : plan.reason === "desktop-stopped" ? `OpenCodex Desktop has stopped its proxy. Use Start Proxy in the OpenCodex menu. ${QUIT_HINT}`
84
114
  : `OpenCodex Desktop manages this proxy but is not running. Open OpenCodex to start it. ${QUIT_HINT}` };
85
115
  }
86
116
  if (plan.kind === "launch-desktop") {
@@ -374,6 +404,7 @@ export function productionDesktopColdStartDeps<T>(waitForProxy: (timeoutMs: numb
374
404
  } catch { return "unknown"; }
375
405
  },
376
406
  desktopProcess: () => inspectDesktopProcess(),
407
+ desktopRecovery: () => inspectDesktopRecovery(),
377
408
  launchDesktop: () => launchDesktopApp(),
378
409
  acquireLaunchLease: () => acquireDesktopLaunchLease(getConfigDir()),
379
410
  waitForProxy,
@@ -28,8 +28,8 @@
28
28
  */
29
29
  import { writeFileSync } from "node:fs";
30
30
  import { loadConfig } from "../config";
31
+ import { ClientPathError } from "../clients/client-path";
31
32
  import {
32
- ClientPathError,
33
33
  EXPORT_CLIENTS,
34
34
  EXPORT_CLIENT_IDS,
35
35
  buildClientConfigText,
@@ -39,6 +39,7 @@ import {
39
39
  type ExportModel,
40
40
  } from "../clients/config-export";
41
41
  import { opencodeCatalogFromProxyRows, type OpencodeProxyModelRow } from "./opencode";
42
+ import { integrationModelNames } from "./integration-input";
42
43
  import type { OcxConfig } from "../types";
43
44
  import {
44
45
  CliUsageError,
@@ -54,7 +55,7 @@ import {
54
55
  } from "./runtime-api";
55
56
 
56
57
  const USAGE = `Usage:
57
- ocx export --client <${EXPORT_CLIENT_IDS.join("|")}> [--json] [--out <path>] [--force]`;
58
+ ocx export --client <${EXPORT_CLIENT_IDS.join("|")}> [--model-names <alias|routed>] [--json] [--out <path>] [--force]`;
58
59
 
59
60
  export interface ExportCommandDeps extends RuntimeApiDeps {
60
61
  /** Live config seam; tests inject a fixture instead of reading the user's config. */
@@ -164,6 +165,7 @@ export async function handleExportCommand(argv: string[], deps: ExportCommandDep
164
165
  return runCliAction(async () => {
165
166
  const args = [...argv];
166
167
  const client = parseClient(args);
168
+ const modelNames = integrationModelNames(args, client, "export", USAGE);
167
169
  const wantsJson = takeFlag(args, "--json");
168
170
  const force = takeFlag(args, "--force");
169
171
  const out = takeOption(args, "--out");
@@ -172,13 +174,15 @@ export async function handleExportCommand(argv: string[], deps: ExportCommandDep
172
174
  const spec = EXPORT_CLIENTS[client];
173
175
  const root = await runtimeBaseUrl(deps);
174
176
  let built: { document: unknown; text: string };
175
- if (client === "raycast" || client === "droid" || client === "qoder" || client === "qoder-cn" || client === "workbuddy" || client === "workbuddy-ai") {
177
+ if (modelNames !== undefined || client === "t3code" || client === "raycast" || client === "droid" || client === "qoder" || client === "qoder-cn" || client === "workbuddy" || client === "workbuddy-ai") {
176
178
  // The dial address alone cannot distinguish a wildcard authenticated bind
177
179
  // from loopback. Let the live server resolve its admission/listener policy;
178
180
  // saved config can differ from the process serving this request.
181
+ const passive = client === "hermes" || client === "commandcode";
182
+ const query = `client=${client}${passive ? "&preview=1" : ""}${modelNames === undefined ? "" : `&modelNames=${modelNames}`}`;
179
183
  const exported = await runtimeRequest<{
180
184
  client: string; format: string; config: unknown; text: string;
181
- }>(`/api/client-config?client=${client}`, {}, { ...deps, baseUrl: root });
185
+ }>(`/api/client-config?${query}`, {}, { ...deps, baseUrl: root });
182
186
  if (!exported || exported.client !== client || exported.format !== spec.format
183
187
  || typeof exported.text !== "string" || exported.config === undefined) {
184
188
  throw new RuntimeApiError(`Management API returned an unexpected ${client} export payload.`, 502, null);
package/src/cli/help.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { EXPORT_CLIENT_IDS } from "../clients/client-ids";
1
2
  import { resolveHelpPath } from "./help-catalog";
2
3
  import type { Capability } from "./capabilities";
3
4
  import { MODELS_CONTEXT_DETAILS, MODELS_CONTEXT_USAGE } from "./help-models-context";
@@ -94,7 +95,7 @@ Usage:
94
95
  ocx api-key <sub> Alias of ocx access key
95
96
  ocx access <sub> External API keys and endpoint information
96
97
  ocx api <sub> Protocol paths: vocabulary, request-path preview, and policy
97
- ocx export --client <id> Print a client config wired to the running proxy (23 clients)
98
+ ocx export --client <id> Print a client config wired to the running proxy (${EXPORT_CLIENT_IDS.length} clients)
98
99
  ocx integration client <sub> Enable, disable, inspect or roll back a client integration
99
100
  ocx grok <sub> Grok Build model selection and apply
100
101
  ocx system <sub> Runtime settings, startup, sync, OpenCodex updates, and Codex CLI inspection
@@ -106,6 +107,7 @@ Usage:
106
107
  ocx chatgpt <sub> Experimental app-server shim: launch|restore|status (macOS)
107
108
  ocx claude [args...] Launch Claude Code wired to the proxy (model discovery on)
108
109
  ocx claude desktop [sub] Manage and apply Claude Desktop's four-family profile
110
+ ocx codex [args...] Launch Codex through the proxy's routing (pass-through when disabled)
109
111
  ocx opencode [args...] Launch opencode wired to the proxy (runtime provider config)
110
112
  ocx mcode [args...] Launch MiniMax Code through its managed provider
111
113
  ocx mmx text <sub> [args] Launch MiniMax CLI text through the proxy
package/src/cli/index.ts CHANGED
@@ -49,7 +49,7 @@ import {
49
49
  resolveCodexHistoryJobTarget,
50
50
  runCodexHistoryJob,
51
51
  } from "../codex/history-job";
52
- import { findCrossHomeOwner, markCrossHomeSibling, markLiveHomeSibling, reconcileStartupJournal } from "./cross-home-owner";
52
+ import { findCrossHomeOwner, markCrossHomeSibling, markLiveHomeSibling } from "./cross-home-owner";
53
53
  import { inspectClientRotationRecoveryGate, readClientConnectionState } from "../client/state";
54
54
  import {
55
55
  codexAutoStartEnabled,
@@ -71,7 +71,6 @@ import {
71
71
  } from "../config/process-state";
72
72
  import {
73
73
  claimPendingTeardown,
74
- clearPendingTeardown,
75
74
  isPendingTeardownAbandoned,
76
75
  listPendingTeardowns,
77
76
  pendingTeardownPathFor,
@@ -128,7 +127,6 @@ import { inspectGuardedManagerTarget, observeGuardedManagerStopped } from "../se
128
127
  import { summarizeStopRun, type StopOutcome, type StopRunRecord } from "./stop-report";
129
128
  import { runCli } from "./root";
130
129
  import { isProcessAlive, ProxyOwnershipRefusedError, refusalNextStep, stopProxy } from "../lib/process-control";
131
- import { directLocalHttpFetch } from "../server/direct-local-http";
132
130
  import { startupDataPlaneToken } from "../lib/service-secrets";
133
131
  import { assertNotAdminToken, diagnoseService, isServiceOwnershipError, proxyStillLiveAfterStop, serviceCommand, serviceEnvironmentOwnedHere, serviceStartableFromTray, serviceStatePaths, serviceStatusSummary, stopServiceIfInstalledDetailed, uninstallServiceIfInstalled, uninstallServiceDetailed } from "../service";
134
132
  import { acquireOwnershipMutationLease } from "../service/ownership-mutation-lease.mjs";
@@ -164,9 +162,10 @@ import { removeOwnedConfigAfterDesktopCleanup } from "./uninstall-client-state";
164
162
  import { withProcessRuntimeProvenance } from "../lib/bun-runtime";
165
163
  import { startArgv } from "../lib/self-launch-argv";
166
164
  import { initializeNodeLauncherContext } from "./launcher-context";
167
- import { assertConnectedClientStopSupported, connectedClientStopSkipLine, preflightConnectedClientStop, preserveConnectedClientRoutingOnExit, restoreSharedClientStateAfterStop } from "./stop-restore";
165
+ import { assertConnectedClientStopSupported, clearRestoredStopReceipts, connectedClientStopSkipLine, notOwnedTeardownIsAcceptable, preflightConnectedClientStop, preserveConnectedClientRoutingOnExit, restoreBoundaryOwnership, restoreSharedClientStateAfterStop, settleUnrestoredStopBoundary } from "./stop-restore";
166
+ import { stopRestoreWriteGuard } from "./stop-restore-guard";
168
167
  import { startClientRuntimeUnderOwnershipLease } from "./client-start-fence";
169
- import { recoverStartStateUnderOwnershipLease } from "./start-owner-fence";
168
+ import { recoverStartJournalAfterOwnerRecheck, recoverStartStateUnderOwnershipLease } from "./start-owner-fence";
170
169
  import { handledSignalExitCode } from "../lib/handled-signal-exit";
171
170
  import { createLocalAttestationSecret } from "../lib/local-management-attestation";
172
171
  import { MEMORY_DRAIN_RESTART_MS, REPLACEMENT_READY_TIMEOUT_MS, RESTART_REOBSERVE_RESERVE_MS } from "../lib/system-restart-contract";
@@ -372,7 +371,7 @@ async function findProxyOwnerBeforeJournalRecovery(
372
371
  const hasRuntimeOwner = readRuntimePort() !== null;
373
372
  const shouldProbe = pidSnapshot !== null || hasRuntimeOwner || options.probeConfiguredPort === true;
374
373
  // A negative answer lets the caller walk past a proxy it was supposed to find and
375
- // deletes this home's stale pid record. Supervised starts defer that write to the
374
+ // deletes this home's stale pid record. Start and ensure defer that write to the
376
375
  // lease-held owner recheck; journal recovery follows cross-home discovery.
377
376
  // One 750ms probe is not enough evidence for that (#5004) — a transport
378
377
  // failure is indistinguishable from an empty port, and the reported Windows duplicate
@@ -440,7 +439,14 @@ async function handleStart(options: { block?: boolean } = {}) {
440
439
  let siblingStart = honorSiblingMarker(process.env, consumeSiblingHandoff) !== null;
441
440
  // A restart replacement waits out its draining parent instead of refusing it, and bounds its handoff log (restart-handoff.ts).
442
441
  const restartParent = { restartParentPid: takeRestartHandoffMarkers(process.env), requestedPort, ocxService: process.env.OCX_SERVICE };
443
- const owner = await probeOwnerPastRestartParent(() => findProxyOwnerBeforeJournalRecovery({ probeConfiguredPort: true, deferPidCleanup: supervisedServiceChild }), restartParent);
442
+ const owner = await probeOwnerPastRestartParent(() => findProxyOwnerBeforeJournalRecovery({ probeConfiguredPort: true, deferPidCleanup: true }), restartParent);
443
+ if (!owner.live) siblingStart = await recoverStartStateUnderOwnershipLease({
444
+ supervised: supervisedServiceChild,
445
+ acquireLease: () => acquireOwnershipMutationLease(serviceStatePaths()),
446
+ decide: () => serviceChildOwnershipDecisionForClassifiedChild(supervisedServiceChild),
447
+ stayOut: refusal => { console.error("❌ " + refusal); process.exit(serviceStayOutExitCode()); },
448
+ recover: () => recoverStartJournalAfterOwnerRecheck(owner, siblingStart),
449
+ });
444
450
  if (owner.live) {
445
451
  // Rationale and the full decision table live on `decideStartWithLiveOwner`.
446
452
  const decision = decideStartWithLiveOwner({
@@ -469,18 +475,6 @@ async function handleStart(options: { block?: boolean } = {}) {
469
475
  + `Startup continues only for an independent OPENCODEX_HOME; one state directory has one spend-ledger writer.`,
470
476
  );
471
477
  }
472
- siblingStart = await recoverStartStateUnderOwnershipLease({
473
- supervised: supervisedServiceChild,
474
- acquireLease: () => acquireOwnershipMutationLease(serviceStatePaths()),
475
- decide: () => serviceChildOwnershipDecisionForClassifiedChild(supervisedServiceChild),
476
- stayOut: refusal => { console.error("❌ " + refusal); process.exit(serviceStayOutExitCode()); },
477
- recover: async () => {
478
- if (!owner.live && supervisedServiceChild) removePidIfValueIs(owner.pidSnapshot);
479
- if (!owner.live && !siblingStart) siblingStart = await markCrossHomeSibling();
480
- if (!siblingStart) reconcileStartupJournal();
481
- return siblingStart;
482
- },
483
- });
484
478
 
485
479
  updateRestartChild?.check();
486
480
  const clientState = readClientConnectionState();
@@ -532,7 +526,7 @@ async function handleStart(options: { block?: boolean } = {}) {
532
526
  console.error("❌ " + leasedChildOwnership.refusal);
533
527
  throw new StartCommandExit(serviceStayOutExitCode());
534
528
  }
535
- // The earlier probe owned journal cleanup. This one owns the bind decision: an
529
+ // Recovery rechecked liveness under its lease. This fence owns the bind decision: an
536
530
  // updater may have stopped the old runtime and acquired this lease for replacement.
537
531
  const fencedLive = await findLiveProxy(START_OWNERSHIP_LIVENESS);
538
532
  if (fencedLive) {
@@ -658,6 +652,7 @@ async function handleStart(options: { block?: boolean } = {}) {
658
652
  // Dashboard drain-and-restart (#563) must not tear down injection: the replacement
659
653
  // process expects Codex/Grok/env fences to still be in place. A sibling owns none of them.
660
654
  const teardown = preserveConnectedClientRoutingOnExit(decideStartExitTeardown({ sibling: siblingStart, recycling: isRecyclingForExit(), ocxService: process.env.OCX_SERVICE }));
655
+ const restoreGuard = stopRestoreWriteGuard();
661
656
  if (teardown.revertSystemEnv) {
662
657
  try { revertSystemEnv(); } catch { /* best-effort */ }
663
658
  }
@@ -666,15 +661,17 @@ async function handleStart(options: { block?: boolean } = {}) {
666
661
  if (teardown.restoreNativeCodex) {
667
662
  try {
668
663
  if (!codexHomeIsAbsent(getCodexHome())) {
669
- const restored = restoreNativeCodex();
664
+ const restored = restoreNativeCodex({ withWriteGuard: restoreGuard.run });
670
665
  if (!restored.success) {
671
666
  cleanupSucceeded = false;
672
667
  console.error(`⚠️ Native Codex restore failed during shutdown: ${restored.message}`);
673
668
  }
674
669
  }
675
670
  } catch (error) {
676
- cleanupSucceeded = false;
677
- console.error(`⚠️ Native Codex restore failed during shutdown: ${error instanceof Error ? error.message : String(error)}`);
671
+ if (restoreGuard.boundary() !== "hub-owned") {
672
+ cleanupSucceeded = false;
673
+ console.error(`⚠️ Native Codex restore failed during shutdown: ${error instanceof Error ? error.message : String(error)}`);
674
+ }
678
675
  }
679
676
  }
680
677
  // Same ownership rule as `ocx stop`: if the installed service belongs to another home, the
@@ -682,7 +679,8 @@ async function handleStart(options: { block?: boolean } = {}) {
682
679
  // left pointing nowhere. This guard also covers signal-driven exits, which is the path that
683
680
  // would otherwise bypass handleStop's gate entirely.
684
681
  if (teardown.stripGrokConfig && serviceEnvironmentOwnedHere()) {
685
- try { stripGrokConfig(); } catch { /* best-effort restore */ }
682
+ try { restoreGuard.run(() => stripGrokConfig()); }
683
+ catch { if (restoreGuard.boundary() !== "hub-owned") cleanupSucceeded = false; }
686
684
  }
687
685
  return cleanupSucceeded;
688
686
  };
@@ -709,7 +707,7 @@ async function handleStart(options: { block?: boolean } = {}) {
709
707
  void (async () => {
710
708
  let shutdownSucceeded = false;
711
709
  try {
712
- shutdownSucceeded = await drainAndShutdown(server, config.shutdownTimeoutMs ?? 5000);
710
+ shutdownSucceeded = await drainAndShutdown(server, config.shutdownTimeoutMs ?? 5000, () => { syncCleanup(); return undefined; });
713
711
  } finally {
714
712
  const restored = syncCleanup(); // idempotent (cleaned-guard); also re-run by process.on("exit")
715
713
  process.exit(restored && shutdownSucceeded ? handledSignalExitCode(signal) : 1);
@@ -814,8 +812,14 @@ function detachedStartEnvironment(): NodeJS.ProcessEnv {
814
812
  }
815
813
 
816
814
  async function handleEnsure(options: { existingIsSuccess?: boolean; forceStart?: boolean; onSpawn?: (child: ReturnType<typeof spawn>) => void } = {}): Promise<boolean> {
817
- const owner = await findProxyOwnerBeforeJournalRecovery({ probeConfiguredPort: true });
818
- if (!owner.live && !(await markCrossHomeSibling())) reconcileStartupJournal();
815
+ const owner = await findProxyOwnerBeforeJournalRecovery({ probeConfiguredPort: true, deferPidCleanup: true });
816
+ if (!owner.live) await recoverStartStateUnderOwnershipLease({
817
+ supervised: false,
818
+ acquireLease: () => acquireOwnershipMutationLease(serviceStatePaths()),
819
+ decide: () => ({ kind: "proceed" }),
820
+ stayOut: () => { throw new Error("ordinary ensure has no service stay-out decision"); },
821
+ recover: () => recoverStartJournalAfterOwnerRecheck(owner),
822
+ });
819
823
  // A later ensure can find this home's sibling alive; the other port still owns shared clients.
820
824
  if (owner.live) await markLiveHomeSibling(owner.live);
821
825
  const config = loadConfig();
@@ -850,13 +854,13 @@ async function handleEnsure(options: { existingIsSuccess?: boolean; forceStart?:
850
854
  const systemEnv = await injectSystemEnv(live.port, config).catch(() => ({ injected: false }));
851
855
  if (siblingOfLivePort() === null) reportShellHookFailure(reconcileShellHook(systemEnv.injected));
852
856
  if (!systemEnv.injected) await syncClaudeAgentDefsAtProxyStartup(config, live.port);
853
- // Refresh the Grok Build fence too (same contract as start). live.hostname is the
854
- // hostname the running proxy actually bound — config.hostname may have drifted.
855
- // The reconciler re-reads immediately before each client-file mutation; only
856
- // the live proxy's observed bind host is safe to carry across this boundary.
857
+ // Refresh the Grok Build fence too (same contract as start). Keep the observed
858
+ // bind scope for admission and its responding address for the destination.
859
+ // The reconciler re-reads immediately before each client-file mutation;
860
+ // config.hostname may have drifted from the running proxy's bind scope.
857
861
  if (siblingOfLivePort() === null) await reconcileEnsureDesiredIntegrations(
858
862
  live.port,
859
- { kind: "live", hostname: live.hostname },
863
+ { kind: "live", hostname: live.hostname, probeHostname: live.probeHostname },
860
864
  );
861
865
  console.log(`✅ Proxy running on port ${live.port}`);
862
866
  return true;
@@ -1159,8 +1163,12 @@ async function handleStopUnlocked(snapshot?: GuardedStopSnapshot) {
1159
1163
  if (connectedClientSkip) await assertConnectedClientStopSupported(exact ? { ...exact, pid } : null);
1160
1164
  claimTeardown(exact ?? configuredEndpoint(), exact ? "exact" : "guessed");
1161
1165
  const graceful = await stopProxy(pid, {
1162
- fetchFn: connectedClientSkip ? directLocalHttpFetch as typeof fetch : undefined,
1163
1166
  deferSharedTeardownNonce: teardownNonce,
1167
+ // "not-owned" is refused only for a positively identified Link connection, read at the
1168
+ // POST: an old build answers it while preserving the loopback route this stop must
1169
+ // restore. A connect committed mid-stop can make this a hub client whose answer is
1170
+ // truthful, so the entry-time skip snapshot cannot stand in for this check.
1171
+ acceptNotOwnedTeardown: notOwnedTeardownIsAcceptable(readClientConnectionState(), stoppingSibling),
1164
1172
  // Only an exact endpoint may direct the request; the configured fallback is a guess
1165
1173
  // good enough to record an obligation against, not to POST a stop to.
1166
1174
  runtimeEndpoint: exact ?? undefined,
@@ -1438,44 +1446,30 @@ async function handleStopUnlocked(snapshot?: GuardedStopSnapshot) {
1438
1446
  const restoreBlocked = ownershipBlocked || inheritedBlocks || nativeRestoreHandledByProxy || stoppingSibling || connectedClientSkip !== null;
1439
1447
  const handedOver = stopHandsTeardownOver({ requested: handoverRequested, restoreBlocked, nonce: teardownNonce,
1440
1448
  stopFailed, recoveredCount: recoveredNonces.length, proxy: record.proxy, service: record.service, deferralHonored: deferralHonoredByProxy });
1449
+ // Ownership can change while the stop awaits; only the state at the restore boundary decides (#7736).
1450
+ const boundary = restoreBlocked || handedOver ? "restore" : restoreBoundaryOwnership();
1451
+ if (boundary !== "restore") stopFailed = settleUnrestoredStopBoundary(boundary, record, teardownNonce ? [teardownNonce, ...recoveredNonces] : recoveredNonces) || stopFailed;
1441
1452
  if (handedOver) announceStopHandover();
1442
- else if (!restoreBlocked) {
1453
+ else if (!restoreBlocked && boundary === "restore") {
1443
1454
  if (recoveredNonces.length > 0) {
1444
1455
  // A previous deferred stop died before restoring, and the probe says its endpoint is
1445
1456
  // not answering. That is the whole point of leaving the receipt behind.
1446
1457
  console.log("↩️ Finishing a shared teardown left unfinished by an earlier stop.");
1447
1458
  }
1448
1459
  const restore = await restoreSharedClientStateAfterStop(reportRetainedCodexProviderTable);
1449
- record.sharedTeardown = restore.historyDeferred ? "refused" : restore.other ? "failed" : "restored";
1450
- if (restore.other) stopFailed = true;
1451
- else if (restore.historyDeferred) historyDeferredNonces = teardownNonce ? [teardownNonce, ...recoveredNonces] : recoveredNonces;
1452
- else if (restore.historyOnly) historyOnlyFailure = true;
1453
- // The obligation is discharged whether or not history metadata finalized: config and
1454
- // catalog are what a client reads, and `restore.other` already fails the stop.
1455
- //
1456
- // Each nonce names its own file, so a clear can only ever remove the obligation it
1457
- // names — never one a concurrent stop wrote. Both this run's claim and every inherited
1458
- // receipt it proved discharged are released together.
1459
- //
1460
- // A history-preflight refusal is the exception: it restored nothing, so there is
1461
- // nothing to discharge. Clearing here would drop a real obligation on the floor and
1462
- // leave the client config pointing at a proxy that is gone, with nothing on disk
1463
- // saying so — which is the whole failure the receipt exists to prevent (#4718).
1464
- if (restore.historyDeferred) {
1465
- console.error(" The shared teardown was refused before it changed anything, so it is still owed.");
1466
- console.error(" Its receipt is preserved; run 'ocx stop' again once Codex is closed to retry the restore.");
1467
- }
1468
- if (!restore.other && !restore.historyDeferred) {
1469
- const discharged = teardownNonce ? [teardownNonce, ...recoveredNonces] : recoveredNonces;
1470
- for (const nonce of discharged) {
1471
- // A receipt that survives its discharge re-triggers recovery forever, so a failed
1472
- // removal is surfaced rather than swallowed.
1473
- if (!clearPendingTeardown(nonce)) {
1474
- stopFailed = true;
1475
- record.receiptClearFailed = true;
1476
- console.error(`❌ The shared teardown finished, but its receipt could not be removed: ${pendingTeardownPathFor(nonce)}`);
1477
- console.error(" Remove it manually; otherwise every later stop and update will try to recover it again.");
1478
- }
1460
+ if (restore.boundary) stopFailed = settleUnrestoredStopBoundary(restore.boundary, record, teardownNonce ? [teardownNonce, ...recoveredNonces] : recoveredNonces) || stopFailed;
1461
+ else {
1462
+ record.sharedTeardown = restore.historyDeferred ? "refused" : restore.other ? "failed" : "restored";
1463
+ if (restore.other) stopFailed = true;
1464
+ else if (restore.historyDeferred) historyDeferredNonces = teardownNonce ? [teardownNonce, ...recoveredNonces] : recoveredNonces;
1465
+ else if (restore.historyOnly) historyOnlyFailure = true;
1466
+ // A history preflight refusal restored nothing, so the obligation survives (#4718).
1467
+ if (restore.historyDeferred) {
1468
+ console.error(" The shared teardown was refused before it changed anything, so it is still owed.");
1469
+ console.error(" Its receipt is preserved; run 'ocx stop' again once Codex is closed to retry the restore.");
1470
+ }
1471
+ if (!restore.other && !restore.historyDeferred) {
1472
+ stopFailed = clearRestoredStopReceipts(record, teardownNonce ? [teardownNonce, ...recoveredNonces] : recoveredNonces) || stopFailed;
1479
1473
  }
1480
1474
  }
1481
1475
  }
@@ -1,5 +1,6 @@
1
1
  /** Input shared by integration preview and journal commands; no writer imports. */
2
2
  import { CliUsageError, takeOptionWithSyntax } from "./runtime-api";
3
+ import { isExportModelNames, supportsAliasModelNames, type ExportModelNames } from "../clients/config-export/model-names";
3
4
 
4
5
  export function validateAsideProfile(profile: string | undefined, client: string | undefined, usage: string): void {
5
6
  if (profile === undefined) return;
@@ -18,6 +19,17 @@ export function integrationOption(args: string[], flag: string): string | undefi
18
19
  return takeOptionWithSyntax(args, flag)?.value;
19
20
  }
20
21
 
22
+ /** Explicit intent only: callers preserve omission instead of inserting a default. */
23
+ export function integrationModelNames(args: string[], client: string | undefined, operation: string, usage: string): ExportModelNames | undefined {
24
+ const value = integrationOption(args, "--model-names");
25
+ if (value === undefined) return undefined;
26
+ if (!isExportModelNames(value)) throw new CliUsageError("--model-names must be alias or routed", usage);
27
+ if (!supportsAliasModelNames(client ?? "") || !["export", "apply", "overwrite"].includes(operation)) {
28
+ throw new CliUsageError("--model-names requires Hermes or Command Code export, enable, or apply/overwrite preview", usage);
29
+ }
30
+ return value;
31
+ }
32
+
21
33
  export function integrationFlag(args: string[], flag: string): boolean {
22
34
  const occurrences = args.filter(arg => arg === flag || arg.startsWith(`${flag}=`));
23
35
  if (occurrences.length > 1) throw new CliUsageError(`${flag} was given more than once`);
@@ -31,6 +31,7 @@ export const FILE_INTEGRATION_CLIENTS = [
31
31
  "workbuddy",
32
32
  "workbuddy-ai",
33
33
  "gentle-shell",
34
+ "t3code",
34
35
  ] as const;
35
36
 
36
37
  export const INTEGRATION_REFUSAL_REASONS: ReadonlySet<string> = new Set<IntegrationRefusalReason>([
@@ -72,6 +73,7 @@ const PLAN_SCHEMA_PATHS = new Set([
72
73
  "catalog.providers.opencodex",
73
74
  "customModels.*",
74
75
  "modelConfigs.customModels.*",
76
+ "providerInstances.opencodex",
75
77
  // ZCode reads its providers from a second file; a plan for it publishes that
76
78
  // file's templates, and a path missing here is rejected as an invalid preview.
77
79
  "config.providerConfigRules.providerRules.[providerId=opencodex]",
@@ -8,7 +8,7 @@ import {
8
8
  } from "./runtime-api";
9
9
  import {
10
10
  clientIntegrationPath, validateAsideProfile, integrationOption, integrationFlag,
11
- integrationFingerprint, integrationDroidDefaults,
11
+ integrationFingerprint, integrationDroidDefaults, integrationModelNames,
12
12
  } from "./integration-input";
13
13
  import { decodeIntegrationPlan, FILE_INTEGRATION_CLIENTS, INTEGRATION_STATES, INTEGRATION_REFUSAL_REASONS } from "./integration-plan-dto";
14
14
 
@@ -17,7 +17,8 @@ const USAGE = `Usage:
17
17
  ocx integration client restore --op ID --preview [--client aside --profile N] [--confirm-drift] [--json]
18
18
  ocx integration client <enable|disable> --client ID [--profile N] [--overwrite-conflict] [--plan-fingerprint TOKEN] [--json]
19
19
  ocx integration client restore --op ID [--client aside --profile N] [--confirm-drift] [--plan-fingerprint TOKEN] [--json]
20
- Droid apply/overwrite: [--reasoning-default MODEL=EFFORT ... | --clear-reasoning-defaults]`;
20
+ Droid apply/overwrite: [--reasoning-default MODEL=EFFORT ... | --clear-reasoning-defaults]
21
+ Hermes/Command Code enable and apply/overwrite preview: [--model-names <alias|routed>]`;
21
22
 
22
23
  type Intent = {
23
24
  preview: boolean; json: boolean; client?: string; profile?: string;
@@ -41,7 +42,6 @@ function parseIntent(argv: string[]): Intent {
41
42
  const op = integrationOption(args, "--op");
42
43
  const opAlias = integrationOption(args, "--op-id");
43
44
  const selectedOperation = integrationOption(args, "--operation");
44
- if (args.length) throw new CliUsageError("Unexpected integration argument(s)", USAGE);
45
45
  if (op !== undefined && opAlias !== undefined) throw new CliUsageError("Use only one of --op and --op-id", USAGE);
46
46
  const opId = op ?? opAlias;
47
47
  if (previewFlag && action !== "restore") throw new CliUsageError("--preview applies only to restore; use the preview command", USAGE);
@@ -55,6 +55,8 @@ function parseIntent(argv: string[]): Intent {
55
55
  if (selectedOperation !== "apply" && selectedOperation !== "overwrite" && selectedOperation !== "disable") throw new CliUsageError("--operation must be apply, overwrite or disable", USAGE);
56
56
  operation = selectedOperation;
57
57
  } else operation = action === "restore" ? "restore" : action === "disable" ? "disable" : overwrite ? "overwrite" : "apply";
58
+ const modelNames = integrationModelNames(args, client, operation, USAGE);
59
+ if (args.length) throw new CliUsageError("Unexpected integration argument(s)", USAGE);
58
60
  if (action !== "restore" && !client) throw new CliUsageError("--client is required", USAGE);
59
61
  if (action === "restore" && (!opId?.trim() || (client !== undefined && (client !== "aside" || profile === undefined)))) {
60
62
  throw new CliUsageError("restore requires --op; its optional target is --client aside --profile N", USAGE);
@@ -75,6 +77,7 @@ function parseIntent(argv: string[]): Intent {
75
77
  body = { enabled: action === "enable", ...(overwrite ? { overwriteConflict: true } : {}) };
76
78
  }
77
79
  if (defaults !== undefined) body.droidReasoningDefaults = defaults;
80
+ if (modelNames !== undefined) body.modelNames = modelNames;
78
81
  if (token !== undefined) { body.operation = operation; body.planFingerprint = token; }
79
82
  return { preview, json, client, profile, operation, path, body };
80
83
  }
@@ -43,6 +43,7 @@ const CLIENT_USAGE = `Usage:
43
43
  ocx integration client sync --client aside [--json]
44
44
  enable/disable/restore accept --plan-fingerprint <token>; bound Aside operations require one profile.
45
45
  Droid enable/preview accept repeatable --reasoning-default <model=effort> or --clear-reasoning-defaults.
46
+ Hermes/Command Code enable and apply/overwrite preview accept --model-names <alias|routed>.
46
47
  --profile selects one Aside account-backed profile; omitted Aside toggles affect all profiles.`;
47
48
 
48
49
  function parseMap(raw: string): Record<string, string> {
@@ -239,7 +240,7 @@ export async function handleClientIntegrationCommand(
239
240
  const { handleIntegrationAsideSync } = await import("./integration-aside-sync");
240
241
  return handleIntegrationAsideSync(argv.slice(1), deps);
241
242
  }
242
- if (argv[0] === "preview" || argv.some(arg => ["--preview", "--plan-fingerprint", "--reasoning-default", "--clear-reasoning-defaults"]
243
+ if (argv[0] === "preview" || argv.some(arg => ["--preview", "--plan-fingerprint", "--reasoning-default", "--clear-reasoning-defaults", "--model-names"]
243
244
  .some(flag => arg === flag || arg.startsWith(`${flag}=`)))) {
244
245
  const { handleIntegrationPreviewCommand } = await import("./integration-preview");
245
246
  return handleIntegrationPreviewCommand(argv, deps, expectedClientId);
@@ -1,25 +1,11 @@
1
- /**
2
- * `ocx link cleanup`: find Home-initiated Remote Link Children that run Windows and explain how to
3
- * move each one to Hub mode. It never revokes or changes anything.
4
- *
5
- * Windows Children are refused at enrollment, but a link enrolled before that refusal existed keeps
6
- * its record, key and reverse tunnel. Its record carries no platform, so this command asks the
7
- * Child over the same pinned SSH trust the tunnel uses (`uname -s` through `sh`) and classifies the
8
- * answer with `detectRemotePlatform` (a localized cmd or PowerShell refusal gets the fixed %OS% probe).
9
- *
10
- * The recovery order matters. An ordinary `ocx link revoke` runs `ocx disconnect` on the Child
11
- * through the POSIX ocx prelude, which exits 125 on Windows, so for these Children the revoke must
12
- * be forced after the Child disconnected itself.
13
- */
1
+ /** Read-only platform and disconnect guidance for recorded Remote Link Children. */
14
2
  import { linkKnownHostsPath, linkStorePath } from "../link/paths";
15
- import { detectRemotePlatform, REMOTE_UNAME_ARGV, type RemotePlatform } from "../link/remote-platform";
16
- import { buildExecArgv } from "../link/ssh-argv";
17
- import { createSshRunner, sshFailureHint, sshRunnerErrorHint, type SshRunner } from "../link/ssh-runner";
3
+ import { requireRemotePlatform, type RemotePlatform } from "../link/remote-platform";
4
+ import { createSshRunner, sshRunnerErrorHint, type SshRunner } from "../link/ssh-runner";
18
5
  import { readLinkStore, type LinkStore } from "../link/store";
19
6
  import { CliUsageError, printData, rejectArgs, takeJsonFlag, takeOption } from "./runtime-api";
20
7
 
21
8
  const LINK_ID = /^lnk_[0-9a-f]{16}$/;
22
- const CHECK_TIMEOUT_MS = 30_000;
23
9
 
24
10
  export interface LinkCleanupDeps {
25
11
  readStore?: () => LinkStore;
@@ -39,16 +25,15 @@ export interface LinkCleanupEntry {
39
25
  export function windowsChildRecovery(linkId: string, alias: string): string[] {
40
26
  return [
41
27
  `On ${alias}, run 'ocx disconnect' and then 'ocx restart' so it stops using this link.`,
42
- `On this Home, run 'ocx link revoke --link-id ${linkId} --force --yes'. A plain revoke cannot disconnect a Windows Child remotely.`,
43
- `Then connect ${alias} in Hub mode: run 'ocx hub invite' on a Hub and the printed 'ocx connect' command on ${alias}.`,
28
+ `On this Home, run 'ocx link revoke --link-id ${linkId} --yes' to disconnect it through the recorded SSH trust.`,
29
+ `Retry Remote Link enrollment after updating Home if the remote shell or old installation cannot run the disconnect command.`,
44
30
  ];
45
31
  }
46
32
 
47
33
  async function checkPlatform(runner: SshRunner, alias: string, knownHostsFile: string): Promise<{ platform: RemotePlatform; reason: string | null }> {
48
34
  try {
49
- const result = await runner.run(buildExecArgv({ alias, argv: REMOTE_UNAME_ARGV, knownHostsFile }), { timeoutMs: CHECK_TIMEOUT_MS });
50
- const platform = await detectRemotePlatform(runner, alias, knownHostsFile, result);
51
- return { platform, reason: platform === "unknown" ? (sshFailureHint(result.stderr) ?? `ssh exited ${result.code}`) : null };
35
+ const platform = await requireRemotePlatform(runner, alias, knownHostsFile);
36
+ return { platform, reason: null };
52
37
  } catch (error) {
53
38
  return { platform: "unknown", reason: sshRunnerErrorHint(error) ?? "ssh could not run" };
54
39
  }
@@ -60,7 +45,7 @@ function humanLines(entries: LinkCleanupEntry[]): string[] {
60
45
  for (const entry of entries) {
61
46
  const label = `${entry.linkId} (${entry.alias})`;
62
47
  if (entry.platform === "windows") {
63
- lines.push(`${label}: Windows Child. Remote Link does not support Windows Children; this link predates that refusal.`);
48
+ lines.push(`${label}: Windows Child. Current Home releases support Remote Link over PowerShell; this report changes nothing.`);
64
49
  for (const [index, step] of entry.recovery.entries()) lines.push(` ${index + 1}. ${step}`);
65
50
  } else if (entry.platform === "posix") lines.push(`${label}: macOS or Linux Child; nothing to clean up.`);
66
51
  else if (entry.platform === "not_checked") lines.push(`${label}: Child-initiated; this Home has no SSH route to check it.`);
@@ -1,6 +1,5 @@
1
1
  import { createInterface } from "node:readline/promises";
2
2
  import { assertSshAlias } from "../link/ssh-argv";
3
- import { windowsChildRefusal } from "../link/remote-platform";
4
3
  import { CliUsageError, RuntimeApiError, runtimeBaseUrl, rejectArgs, takeJsonFlag, takeOption, printData } from "./runtime-api";
5
4
  import type { LinkCliDeps } from "./link";
6
5
 
@@ -84,9 +83,7 @@ export async function runLinkEnrollment(command: "probe" | "add", args: string[]
84
83
  catch (error) {
85
84
  if (error instanceof RuntimeApiError && record(error.body)) {
86
85
  const code = record(error.body.error) ? error.body.error.code : undefined;
87
- // Refused at probe or confirm, before any key or tunnel: point at Hub mode, not at a phase.
88
- // A residual response comes after key issuance; it keeps its Child recovery below.
89
- if (code === "remote_platform_unsupported" && error.body.residual !== true) throw new Error(windowsChildRefusal(alias));
86
+ if (code === "remote_platform_unsupported" && error.body.residual !== true) throw new Error("The remote shell cannot run this Remote Link workflow. Update OpenCodex on Home and check PowerShell on the Child.");
90
87
  const phase = typeof code === "string" && Object.hasOwn(PHASES, code) ? PHASES[code] : undefined;
91
88
  const message = phase ? "Remote Link failed during " + phase : error.message;
92
89
  if (phase || error.body.residual === true) throw new Error(message + (error.body.residual === true ? ". " + RECOVERY : ""));