@bitkyc08/opencodex 2.100.1 → 2.100.3

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 (624) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/Tray-BV4ms9U9.js +1 -0
  6. package/gui/dist/assets/{brand-mark-nr3ziR-T.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/index-DQtCRNAw.css +2 -0
  9. package/gui/dist/assets/{segment-thumb-features-DKCVUUTi.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-BedmOsE7.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/quota-summary-Dy5_wfTT.js +1 -0
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +6 -4
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/native-exec.ts +3 -2
  38. package/src/adapters/cursor/protobuf-request.ts +8 -8
  39. package/src/adapters/cursor/tool-guidance.ts +3 -3
  40. package/src/adapters/cursor/tool-wording.ts +10 -1
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/tool-schema.ts +20 -2
  43. package/src/adapters/google-antigravity-wire.ts +15 -6
  44. package/src/adapters/google-truncation.ts +4 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +17 -4
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/openai-chat/tool-schema.ts +9 -0
  54. package/src/adapters/openai-responses/tool-schema.ts +18 -4
  55. package/src/adapters/run-turn-queue.ts +139 -5
  56. package/src/adapters/upstream-http-error.ts +4 -2
  57. package/src/adapters/zed.ts +3 -0
  58. package/src/advisor/consult.ts +15 -4
  59. package/src/advisor/context.ts +12 -3
  60. package/src/advisor/runtime.ts +35 -5
  61. package/src/advisor/settings.ts +8 -0
  62. package/src/advisor/synthetic-tool.ts +21 -8
  63. package/src/bridge/response-json.ts +11 -2
  64. package/src/bridge/sse.ts +51 -9
  65. package/src/claude/auth-detect.ts +21 -33
  66. package/src/claude/chat-tool-dispatch.ts +233 -0
  67. package/src/claude/desktop-3p.ts +11 -5
  68. package/src/claude/desktop-gateway-state.ts +2 -0
  69. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  70. package/src/claude/desktop-remote-store.ts +24 -4
  71. package/src/claude/inbound-content-options.ts +31 -16
  72. package/src/claude/inbound-tool-loading.ts +42 -17
  73. package/src/claude/outbound.ts +13 -3
  74. package/src/cli/account-api.ts +23 -1
  75. package/src/cli/account-auth.ts +54 -21
  76. package/src/cli/account-extended.ts +60 -6
  77. package/src/cli/account-key-quota.ts +56 -7
  78. package/src/cli/account.ts +5 -3
  79. package/src/cli/advisor.ts +7 -4
  80. package/src/cli/alias.ts +38 -1
  81. package/src/cli/capabilities-access-remote.ts +137 -2
  82. package/src/cli/capabilities-accounts.ts +3 -3
  83. package/src/cli/capabilities-agents-routing.ts +17 -10
  84. package/src/cli/capabilities-base.ts +43 -18
  85. package/src/cli/capabilities-integrations.ts +2 -2
  86. package/src/cli/capabilities-provider-models.ts +18 -2
  87. package/src/cli/capabilities-route-to.ts +43 -0
  88. package/src/cli/capabilities.ts +2 -0
  89. package/src/cli/capability-contracts.ts +1 -1
  90. package/src/cli/claude-desktop.ts +30 -11
  91. package/src/cli/claude.ts +36 -17
  92. package/src/cli/codex-launcher.ts +3 -1
  93. package/src/cli/codex-shim-autorestore.ts +5 -42
  94. package/src/cli/config-command.ts +38 -2
  95. package/src/cli/config-root-startup.ts +34 -0
  96. package/src/cli/connect.ts +124 -19
  97. package/src/cli/desktop-runtime-guidance.ts +1 -1
  98. package/src/cli/disconnect-runtime.ts +168 -0
  99. package/src/cli/dispatch.ts +54 -12
  100. package/src/cli/export-command.ts +1 -1
  101. package/src/cli/gui-pair-client.ts +29 -5
  102. package/src/cli/gui.ts +10 -5
  103. package/src/cli/help-catalog.ts +11 -0
  104. package/src/cli/help.ts +5 -4
  105. package/src/cli/hub.ts +18 -1
  106. package/src/cli/index.ts +83 -92
  107. package/src/cli/inspect.ts +11 -2
  108. package/src/cli/integrations.ts +26 -1
  109. package/src/cli/link-capture.ts +64 -0
  110. package/src/cli/link-child-ops.ts +314 -0
  111. package/src/cli/link-cleanup.ts +8 -5
  112. package/src/cli/link-diagnostics.ts +67 -0
  113. package/src/cli/link-enrollment.ts +158 -12
  114. package/src/cli/link-operations.ts +52 -0
  115. package/src/cli/link-recover.ts +152 -0
  116. package/src/cli/link-routes.ts +87 -0
  117. package/src/cli/link-status-child.ts +137 -0
  118. package/src/cli/link-status-traffic.ts +34 -0
  119. package/src/cli/link.ts +327 -37
  120. package/src/cli/message-command.ts +1 -1
  121. package/src/cli/message-mcp-command.ts +23 -10
  122. package/src/cli/models-runtime.ts +3 -3
  123. package/src/cli/opencode.ts +3 -1
  124. package/src/cli/pi-sync.ts +35 -0
  125. package/src/cli/preflight-exemptions.ts +46 -0
  126. package/src/cli/registry.ts +29 -12
  127. package/src/cli/restart-failure.ts +5 -2
  128. package/src/cli/root.ts +5 -1
  129. package/src/cli/route-to.ts +172 -0
  130. package/src/cli/runtime-api.ts +5 -8
  131. package/src/cli/status.ts +3 -1
  132. package/src/cli/stop-approval.ts +66 -19
  133. package/src/cli/stop-report.ts +23 -0
  134. package/src/cli/stop-windows-checked.ts +304 -0
  135. package/src/cli/sync-command.ts +70 -13
  136. package/src/cli/sync-fanout.ts +81 -99
  137. package/src/cli/sync-flags.ts +40 -3
  138. package/src/cli/sync-link-status.ts +18 -2
  139. package/src/cli/sync-update-guard.ts +7 -2
  140. package/src/cli/system-restart-client.ts +3 -2
  141. package/src/cli/uninstall-plan.ts +77 -5
  142. package/src/cli/uninstall-stop.ts +152 -0
  143. package/src/cli/v2-input.ts +10 -6
  144. package/src/cli/v2-local-output.ts +3 -2
  145. package/src/cli/v2-runtime.ts +10 -3
  146. package/src/cli/v2.ts +22 -7
  147. package/src/client/connect.ts +321 -34
  148. package/src/client/link-home-features.ts +27 -0
  149. package/src/client/link-home.ts +92 -4
  150. package/src/client/link-ingress.ts +21 -3
  151. package/src/client/link-join.ts +12 -2
  152. package/src/client/link-parity-reporter.ts +60 -6
  153. package/src/client/link-readiness.ts +16 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel-status.ts +76 -0
  161. package/src/client/link-tunnel.ts +56 -5
  162. package/src/client/link-websocket-limits.ts +89 -0
  163. package/src/client/link-websocket.ts +586 -0
  164. package/src/client/link-ws-advertisement.ts +100 -0
  165. package/src/client/link-ws-framer.ts +241 -0
  166. package/src/client/link-ws-transport.ts +177 -0
  167. package/src/client/machine-api.ts +13 -2
  168. package/src/client/machine-listener.ts +48 -7
  169. package/src/client/route-intent-apply.ts +293 -0
  170. package/src/client/route-intent-file-originals.ts +97 -0
  171. package/src/client/route-intent-native-originals.ts +201 -0
  172. package/src/client/route-intent-watch.ts +141 -0
  173. package/src/client/runtime-restart.ts +127 -5
  174. package/src/client/runtime.ts +61 -15
  175. package/src/client/state.ts +30 -0
  176. package/src/client/sync-expectation.ts +36 -2
  177. package/src/client/sync-runtime.ts +7 -0
  178. package/src/clients/config-export/alias-selectors.ts +63 -40
  179. package/src/clients/config-export/contracts.ts +2 -0
  180. package/src/clients/config-export/nested-selectors.ts +42 -0
  181. package/src/clients/config-export.ts +36 -4
  182. package/src/codex/account-resume-health.ts +41 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/login-flow.ts +6 -0
  187. package/src/codex/auth-api/routes.ts +35 -2
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +21 -6
  190. package/src/codex/catalog/gather-capture.ts +10 -2
  191. package/src/codex/catalog/parsing.ts +7 -3
  192. package/src/codex/catalog/provider-models.ts +67 -23
  193. package/src/codex/catalog/retained-sync.ts +2 -1
  194. package/src/codex/catalog/routed-gather.ts +1 -1
  195. package/src/codex/catalog-auto-refresh.ts +11 -0
  196. package/src/codex/cli-update-job.ts +35 -13
  197. package/src/codex/convergence-types.ts +2 -0
  198. package/src/codex/convergence.ts +2 -2
  199. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  200. package/src/codex/features.ts +2 -2
  201. package/src/codex/history-provider.ts +31 -0
  202. package/src/codex/inject/multi-agent-v2.ts +9 -3
  203. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  204. package/src/codex/inject/plan.ts +20 -2
  205. package/src/codex/inject.ts +2 -0
  206. package/src/codex/journal-config-restore.ts +217 -0
  207. package/src/codex/journal.ts +75 -6
  208. package/src/codex/main-account.ts +23 -30
  209. package/src/codex/native-main-auth-file.ts +104 -0
  210. package/src/codex/native-profile-manager.ts +4 -3
  211. package/src/codex/native-profile-store.ts +3 -61
  212. package/src/codex/orca-import.ts +10 -1
  213. package/src/codex/quota-history.ts +13 -0
  214. package/src/codex/quota-window-conflict.ts +103 -0
  215. package/src/codex/quota.ts +134 -7
  216. package/src/codex/subagent-model-fallback.ts +3 -1
  217. package/src/codex/websocket-activity.ts +171 -16
  218. package/src/codex/websocket-registry.ts +11 -4
  219. package/src/combos/cooldown-store.ts +228 -0
  220. package/src/combos/failover.ts +760 -35
  221. package/src/config/dashboard-trusted-proxy.ts +83 -0
  222. package/src/config/diagnostics.ts +28 -0
  223. package/src/config/feature-flags.ts +9 -0
  224. package/src/config/live-reconcile.ts +10 -1
  225. package/src/config/load-degrade.ts +12 -1
  226. package/src/config/multi-agent-surface.ts +28 -5
  227. package/src/config/pending-teardown.ts +60 -3
  228. package/src/config/process-state.ts +175 -4
  229. package/src/config/provider-validation.ts +4 -4
  230. package/src/config/salvage.ts +1 -0
  231. package/src/config/schema/config-schema.ts +12 -3
  232. package/src/config/schema/leaf-validators.ts +43 -14
  233. package/src/config/windows-process-command-line.ts +107 -0
  234. package/src/generated/compatibility-version.json +1077 -429
  235. package/src/generated/model-metadata.ts +1 -1
  236. package/src/images/loop.ts +3 -0
  237. package/src/integrations/model-name-guard.ts +25 -0
  238. package/src/integrations/route-intent-catalog.ts +26 -0
  239. package/src/integrations/route-intent-connected.ts +262 -0
  240. package/src/integrations/route-intent-contract.ts +55 -0
  241. package/src/integrations/route-intent-disconnect.ts +109 -0
  242. package/src/integrations/route-intent-initial.ts +64 -0
  243. package/src/integrations/route-intent-state.ts +117 -0
  244. package/src/integrations/route-intent-tick.ts +65 -0
  245. package/src/integrations/route-intent.ts +212 -0
  246. package/src/integrations/writer.ts +44 -11
  247. package/src/lib/catalog-etag.ts +10 -0
  248. package/src/lib/client-error-body.ts +15 -0
  249. package/src/lib/client-retry-after.ts +29 -0
  250. package/src/lib/config-ownership.ts +13 -0
  251. package/src/lib/context-overflow-verdict.ts +266 -9
  252. package/src/lib/desktop-gui-origin.ts +28 -0
  253. package/src/lib/errors.ts +1 -1
  254. package/src/lib/failure-detail.ts +72 -3
  255. package/src/lib/gui-pair-capability.ts +2 -1
  256. package/src/lib/hard-refusal.ts +259 -0
  257. package/src/lib/messages-error-body.ts +4 -1
  258. package/src/lib/outbound-credential-registry.ts +362 -4
  259. package/src/lib/paced-stream.ts +34 -0
  260. package/src/lib/passive-key-fetch-proof.ts +30 -0
  261. package/src/lib/passive-read.ts +5 -0
  262. package/src/lib/process-control.ts +76 -12
  263. package/src/lib/redact.ts +84 -8
  264. package/src/lib/state-store-registrations.ts +11 -0
  265. package/src/lib/state-store-sweeper.ts +4 -0
  266. package/src/lib/supervisor-markers.ts +18 -0
  267. package/src/lib/terminal-safe-text.ts +58 -0
  268. package/src/lib/translator-budget.ts +3 -2
  269. package/src/lib/upstream-retry.ts +14 -4
  270. package/src/link/alias-lock.ts +119 -0
  271. package/src/link/child-activity.ts +83 -0
  272. package/src/link/child-binary-cache-fill.d.mts +50 -0
  273. package/src/link/child-binary-cache-fill.mjs +494 -0
  274. package/src/link/child-binary-cache-start.ts +73 -0
  275. package/src/link/child-binary-source.ts +12 -5
  276. package/src/link/child-catalog-freshness.ts +149 -0
  277. package/src/link/child-gated-ocx.ts +135 -0
  278. package/src/link/child-observations.ts +206 -0
  279. package/src/link/child-observe.ts +121 -0
  280. package/src/link/child-ops-engine.ts +230 -0
  281. package/src/link/child-ops-host.ts +138 -0
  282. package/src/link/child-ops-runners.ts +319 -0
  283. package/src/link/child-ops-scheduler.ts +207 -0
  284. package/src/link/child-ops-types.ts +89 -0
  285. package/src/link/child-parity.ts +23 -4
  286. package/src/link/child-policy.ts +93 -0
  287. package/src/link/child-update-contract.ts +174 -0
  288. package/src/link/codex-settings.ts +1 -1
  289. package/src/link/compatibility.ts +18 -1
  290. package/src/link/diagnostics-read.ts +163 -0
  291. package/src/link/diagnostics.ts +20 -7
  292. package/src/link/explicit-route.ts +209 -0
  293. package/src/link/link-recover.ts +113 -0
  294. package/src/link/management-routes.ts +3 -1
  295. package/src/link/operation-recovery-slot.ts +44 -0
  296. package/src/link/operations-journal.ts +408 -0
  297. package/src/link/paths.ts +5 -0
  298. package/src/link/peer-report.ts +1 -1
  299. package/src/link/relay-auth.ts +14 -0
  300. package/src/link/remote-plant.ts +152 -14
  301. package/src/link/remote-platform.ts +21 -10
  302. package/src/link/remote-probe.ts +11 -3
  303. package/src/link/remote-windows.ts +88 -12
  304. package/src/link/request-compression.ts +30 -0
  305. package/src/link/residual-recovery.ts +54 -0
  306. package/src/link/retirement.ts +128 -0
  307. package/src/link/route-intent-watch.ts +41 -0
  308. package/src/link/route-intent.ts +209 -0
  309. package/src/link/route-proof.ts +82 -0
  310. package/src/link/route-rounds.ts +579 -0
  311. package/src/link/route-select.ts +95 -0
  312. package/src/link/route-trust.ts +96 -0
  313. package/src/link/ssh-argv.ts +285 -43
  314. package/src/link/ssh-capture-redact.ts +253 -0
  315. package/src/link/ssh-capture.ts +497 -0
  316. package/src/link/ssh-runner.ts +141 -14
  317. package/src/link/status-projection.ts +160 -0
  318. package/src/link/store.ts +54 -1
  319. package/src/link/supervisor.ts +543 -55
  320. package/src/link/sync-fanout-classify.ts +114 -0
  321. package/src/link/sync-then-restart.ts +65 -0
  322. package/src/link/tombstones.ts +209 -0
  323. package/src/link/traffic.ts +178 -0
  324. package/src/link/tunnel-state.ts +10 -4
  325. package/src/link/ws-activity-holds.ts +474 -0
  326. package/src/local-credentials/publication-fence.ts +20 -1
  327. package/src/messaging/mcp-queue-rpc.ts +3 -2
  328. package/src/messaging/mcp-queue-server.ts +21 -1
  329. package/src/messaging/mcp-reply-tools.ts +24 -9
  330. package/src/messaging/mcp-reply-wait.ts +70 -0
  331. package/src/messaging/mcp-resume-tools.ts +25 -0
  332. package/src/messaging/remote-enrollment.ts +3 -3
  333. package/src/messaging/remote-tunnels.ts +2 -2
  334. package/src/messaging/resume-permissions.ts +27 -0
  335. package/src/messaging/rpc.ts +46 -2
  336. package/src/oauth/account-resume-health.ts +60 -0
  337. package/src/oauth/anthropic-continuity.ts +23 -7
  338. package/src/oauth/anthropic-routing.ts +5 -2
  339. package/src/oauth/anthropic.ts +22 -2
  340. package/src/oauth/claude-keychain-read.ts +78 -68
  341. package/src/oauth/index.ts +25 -6
  342. package/src/oauth/local-token-detect.ts +8 -29
  343. package/src/oauth/login-cli-errors.ts +5 -1
  344. package/src/oauth/login-cli.ts +33 -18
  345. package/src/oauth/login-flow-state.ts +26 -3
  346. package/src/oauth/meta-muse.ts +1 -1
  347. package/src/oauth/store.ts +51 -1
  348. package/src/oauth/xai.ts +248 -14
  349. package/src/protocols/contract.ts +4 -0
  350. package/src/protocols/encoders/messages.ts +1 -0
  351. package/src/providers/alias-template.ts +48 -0
  352. package/src/providers/anthropic-billing-ownership.ts +2 -0
  353. package/src/providers/anthropic-output-caps.ts +46 -0
  354. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  355. package/src/providers/antigravity-effort-families.ts +11 -3
  356. package/src/providers/antigravity-models.ts +32 -9
  357. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  358. package/src/providers/api-key-pause-state.ts +23 -0
  359. package/src/providers/api-key-pause.ts +71 -10
  360. package/src/providers/api-key-resolve.ts +49 -7
  361. package/src/providers/api-key-response-ownership.ts +2 -0
  362. package/src/providers/api-key-selection-capture.ts +3 -1
  363. package/src/providers/api-key-selection.ts +54 -11
  364. package/src/providers/api-keys.ts +24 -7
  365. package/src/providers/cache-affinity-identity.ts +73 -0
  366. package/src/providers/cache-affinity.ts +256 -0
  367. package/src/providers/claude-cli-usage-state.ts +11 -6
  368. package/src/providers/claude-cli-usage.ts +27 -9
  369. package/src/providers/codex-capacity.ts +11 -2
  370. package/src/providers/default-aliases.ts +98 -20
  371. package/src/providers/google-vertex-model-discovery.ts +510 -0
  372. package/src/providers/key-failover.ts +136 -14
  373. package/src/providers/key-store.ts +3 -3
  374. package/src/providers/kiro-models.ts +3 -5
  375. package/src/providers/label.ts +31 -5
  376. package/src/providers/mistral-transport.ts +17 -4
  377. package/src/providers/model-discovery-config.ts +31 -0
  378. package/src/providers/model-discovery-diagnostic.ts +34 -3
  379. package/src/providers/model-discovery.ts +43 -7
  380. package/src/providers/model-rename-fields.ts +5 -0
  381. package/src/providers/muse-key-quota.ts +14 -6
  382. package/src/providers/new-model-policy-runtime.ts +17 -4
  383. package/src/providers/new-model-policy.ts +30 -4
  384. package/src/providers/openai-sidecar.ts +15 -2
  385. package/src/providers/passive-key-observation.ts +252 -0
  386. package/src/providers/provider-id-rewrite.ts +3 -0
  387. package/src/providers/quota/account-cache.ts +53 -34
  388. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  389. package/src/providers/quota/anthropic-usage-windows.ts +19 -9
  390. package/src/providers/quota/passive-key-limits.ts +272 -0
  391. package/src/providers/quota/passive-wire-model.ts +126 -0
  392. package/src/providers/quota/report-cache.ts +112 -5
  393. package/src/providers/quota/vendor-probes-key.ts +73 -0
  394. package/src/providers/quota/vendor-probes-oauth.ts +57 -3
  395. package/src/providers/quota-key-accounts.ts +22 -10
  396. package/src/providers/quota-mistral-budget.ts +18 -0
  397. package/src/providers/quota-types.ts +43 -0
  398. package/src/providers/quota.ts +31 -32
  399. package/src/providers/reasoning-metadata.ts +1051 -12
  400. package/src/providers/registry/entries-core.ts +34 -16
  401. package/src/providers/registry/entries-extended.ts +32 -0
  402. package/src/providers/registry/model-seeds.ts +35 -0
  403. package/src/providers/resolved-model-policy.ts +7 -0
  404. package/src/providers/routed-config.ts +8 -3
  405. package/src/providers/xai-transport.ts +3 -0
  406. package/src/quota/reset-observer.ts +4 -2
  407. package/src/quota/reset-seen-store.ts +9 -0
  408. package/src/quota/window-mapping.ts +1 -0
  409. package/src/quota-pool/assemble.ts +4 -1
  410. package/src/remote/features.ts +17 -0
  411. package/src/responses/anthropic-progress.ts +10 -4
  412. package/src/responses/citation-markers.ts +231 -0
  413. package/src/responses/hosted-tool-policy.ts +56 -12
  414. package/src/responses/spill-store.ts +5 -1
  415. package/src/responses/state/replay-input.ts +50 -0
  416. package/src/responses/state/replay-owner.ts +24 -0
  417. package/src/responses/state/snapshot-codec.ts +9 -0
  418. package/src/responses/state/spill-queue.ts +1 -0
  419. package/src/responses/state.ts +42 -60
  420. package/src/router.ts +4 -2
  421. package/src/routing/home-route-capture.ts +123 -0
  422. package/src/routing/home-route-intent.ts +200 -0
  423. package/src/routing/route-intent-state.ts +178 -0
  424. package/src/routing/route-to-live-settings.ts +35 -0
  425. package/src/routing/route-to-local.ts +145 -0
  426. package/src/routing/route-to-status.ts +94 -0
  427. package/src/routing/route-to-sync-child.ts +32 -0
  428. package/src/server/adapter-resolve.ts +21 -1
  429. package/src/server/admitted-http-turn.ts +3 -0
  430. package/src/server/auth-cors.ts +109 -8
  431. package/src/server/bare-upstream-error.ts +220 -0
  432. package/src/server/catalog-download.ts +3 -5
  433. package/src/server/chat-native.ts +25 -7
  434. package/src/server/claude-messages.ts +8 -5
  435. package/src/server/codex-model-list.ts +2 -1
  436. package/src/server/configured-credentials.ts +37 -5
  437. package/src/server/gui-desktop-authorization.ts +36 -0
  438. package/src/server/gui-pair-delivery.ts +6 -3
  439. package/src/server/gui-session.ts +10 -1
  440. package/src/server/images.ts +41 -13
  441. package/src/server/inbound-body-admission.ts +17 -4
  442. package/src/server/index/link-listener.ts +203 -11
  443. package/src/server/index/link-management.ts +15 -1
  444. package/src/server/index/link-relay-sessions.ts +128 -8
  445. package/src/server/index/link-websocket-limits.ts +136 -0
  446. package/src/server/index/link-websocket.ts +692 -0
  447. package/src/server/index/optional-listeners.ts +115 -7
  448. package/src/server/index/route-intent-watch.ts +47 -0
  449. package/src/server/index/serve-contract.ts +86 -0
  450. package/src/server/index/serve-options.ts +35 -86
  451. package/src/server/index/startup-warnings.ts +8 -2
  452. package/src/server/index/websocket-handler.ts +26 -4
  453. package/src/server/index.ts +12 -2
  454. package/src/server/inference/client-encoder-delivery.ts +2 -0
  455. package/src/server/inspection-tee.ts +39 -2
  456. package/src/server/lifecycle.ts +2 -0
  457. package/src/server/link-turn.ts +137 -0
  458. package/src/server/management/advisor-routes.ts +10 -2
  459. package/src/server/management/agent-settings-routes.ts +50 -16
  460. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  461. package/src/server/management/config-routes.ts +7 -1
  462. package/src/server/management/context.ts +9 -2
  463. package/src/server/management/desktop-authorization.ts +41 -0
  464. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  465. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  466. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  467. package/src/server/management/home-integration-decision.ts +89 -0
  468. package/src/server/management/integration-routes.ts +208 -81
  469. package/src/server/management/link-child-ops-routes.ts +218 -0
  470. package/src/server/management/link-child-preflight.ts +31 -0
  471. package/src/server/management/link-diagnostics-route.ts +29 -0
  472. package/src/server/management/link-enrollment.ts +199 -47
  473. package/src/server/management/link-operation.ts +609 -0
  474. package/src/server/management/link-recover-route.ts +103 -0
  475. package/src/server/management/link-route-edit.ts +173 -0
  476. package/src/server/management/link-route-request.ts +62 -0
  477. package/src/server/management/link-route-state.ts +92 -6
  478. package/src/server/management/link-routes.ts +563 -51
  479. package/src/server/management/link-traffic-status.ts +13 -0
  480. package/src/server/management/model-routes.ts +122 -36
  481. package/src/server/management/model-rows.ts +2 -1
  482. package/src/server/management/native-integration-routes.ts +176 -70
  483. package/src/server/management/oauth-account-routes.ts +69 -17
  484. package/src/server/management/protocol-routes.ts +7 -0
  485. package/src/server/management/provider-completion-test.ts +4 -4
  486. package/src/server/management/provider-overwrite-carry.ts +39 -3
  487. package/src/server/management/provider-routes.ts +80 -72
  488. package/src/server/management/provider-routing-quota.ts +45 -0
  489. package/src/server/management/route-registry.ts +25 -3
  490. package/src/server/management/route-to-routes.ts +257 -0
  491. package/src/server/management/system-restart.ts +4 -2
  492. package/src/server/management/usage-aggregate-cache.ts +101 -66
  493. package/src/server/management-api.ts +17 -3
  494. package/src/server/management-auth.ts +13 -1
  495. package/src/server/messages-native-preflight.ts +27 -4
  496. package/src/server/messages-native.ts +22 -5
  497. package/src/server/persistent-gui-session.ts +6 -3
  498. package/src/server/proxy-liveness.ts +33 -6
  499. package/src/server/relay-eager.ts +36 -12
  500. package/src/server/relay.ts +183 -116
  501. package/src/server/request-body-facts.ts +48 -0
  502. package/src/server/request-decompress.ts +65 -2
  503. package/src/server/request-log-account-rotation.ts +6 -0
  504. package/src/server/request-log-attempt-usage.ts +69 -0
  505. package/src/server/request-log-cache-affinity.ts +60 -0
  506. package/src/server/request-log-conversation.ts +45 -2
  507. package/src/server/request-log-failure-detail.ts +59 -1
  508. package/src/server/request-log-terminal-status.ts +210 -24
  509. package/src/server/request-log.ts +71 -79
  510. package/src/server/responses/adapter-continuation.ts +2 -1
  511. package/src/server/responses/adapter-delivery.ts +2 -0
  512. package/src/server/responses/adapter-dispatch.ts +40 -51
  513. package/src/server/responses/advisor-plan-slot.ts +33 -1
  514. package/src/server/responses/advisor-question.ts +21 -0
  515. package/src/server/responses/advisor-slot.ts +10 -3
  516. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  517. package/src/server/responses/buffered-sse-json.ts +9 -3
  518. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  519. package/src/server/responses/codex-tool-catalog.ts +156 -0
  520. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  521. package/src/server/responses/combo-stream-preflight.ts +701 -81
  522. package/src/server/responses/compact.ts +47 -12
  523. package/src/server/responses/context-overflow.ts +58 -2
  524. package/src/server/responses/core-codex-account.ts +17 -3
  525. package/src/server/responses/core-combo-failure.ts +37 -4
  526. package/src/server/responses/core-combo-native.ts +3 -1
  527. package/src/server/responses/core-combo.ts +62 -7
  528. package/src/server/responses/core-errors.ts +8 -3
  529. package/src/server/responses/core-lifetime.ts +3 -2
  530. package/src/server/responses/core-normalize.ts +3 -1
  531. package/src/server/responses/core-opaque-recovery.ts +45 -2
  532. package/src/server/responses/core-options.ts +18 -0
  533. package/src/server/responses/core.ts +2 -0
  534. package/src/server/responses/fetch-helpers.ts +15 -10
  535. package/src/server/responses/native-replay-guard.ts +57 -0
  536. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  537. package/src/server/responses/outbound-request-body.ts +29 -0
  538. package/src/server/responses/passthrough-completion.ts +105 -8
  539. package/src/server/responses/passthrough-delivery.ts +31 -11
  540. package/src/server/responses/passthrough-dispatch.ts +99 -106
  541. package/src/server/responses/policy-fallback.ts +13 -1
  542. package/src/server/responses/request-prepare.ts +50 -6
  543. package/src/server/responses/request-transport.ts +53 -17
  544. package/src/server/responses/reset-replay.ts +104 -4
  545. package/src/server/responses/run-turn-execution.ts +58 -30
  546. package/src/server/responses/sidecar-execution.ts +14 -0
  547. package/src/server/responses/terminal-error-redaction.ts +222 -25
  548. package/src/server/responses/ws-upstream.ts +2 -2
  549. package/src/server/sse-payload-rewrite.ts +3 -2
  550. package/src/server/stop-service-route.ts +85 -0
  551. package/src/server/system-env-shell.ts +12 -1
  552. package/src/server/system-env.ts +5 -3
  553. package/src/server/windows-tcp-drop.ts +21 -4
  554. package/src/server/workflow-refusal.ts +8 -0
  555. package/src/server/ws-bridge.ts +191 -12
  556. package/src/service/cli-windows-stop.ts +189 -0
  557. package/src/service/cli.ts +41 -12
  558. package/src/service/disconnected-client-restart.ts +60 -0
  559. package/src/service/guarded-manager-target.ts +18 -1
  560. package/src/service/health.ts +99 -6
  561. package/src/service/launchd.ts +84 -31
  562. package/src/service/orchestration.ts +418 -91
  563. package/src/service/repair.ts +223 -6
  564. package/src/service/restart-proxy-stop.ts +79 -0
  565. package/src/service/service-child-ownership.ts +6 -2
  566. package/src/service/windows-checked-stop-live.ts +467 -0
  567. package/src/service/windows-checked-stop.ts +435 -0
  568. package/src/service/windows-command-line-token.ts +23 -0
  569. package/src/service/windows-guarded-manager.ts +77 -34
  570. package/src/service/windows-ops.ts +38 -56
  571. package/src/service/windows-process-evidence.ts +292 -0
  572. package/src/service/windows-process-native.ts +262 -0
  573. package/src/service/windows-service-stop.ts +321 -0
  574. package/src/service/windows-stop-binding.ts +187 -0
  575. package/src/service/windows-stop-budget.ts +123 -0
  576. package/src/service/windows-stop-confirm.ts +158 -0
  577. package/src/service/windows-stop-deadline.ts +56 -0
  578. package/src/service.ts +2 -2
  579. package/src/types/claude-tool-loading.ts +48 -0
  580. package/src/types/config.ts +47 -53
  581. package/src/types/link.ts +20 -0
  582. package/src/types/multi-agent.ts +13 -0
  583. package/src/types/provider.ts +68 -2
  584. package/src/types/request.ts +4 -0
  585. package/src/types.ts +4 -0
  586. package/src/update/guarded-runtime-ops.ts +5 -7
  587. package/src/update/index.ts +25 -10
  588. package/src/update/install-detection.mjs +3 -1
  589. package/src/update/job-pinned-start.ts +2 -0
  590. package/src/update/job-windows-restart.ts +19 -32
  591. package/src/update/job.ts +12 -5
  592. package/src/update/npm-install.d.mts +11 -0
  593. package/src/update/npm-install.mjs +44 -7
  594. package/src/update/orchestrated-entry.ts +1 -1
  595. package/src/update/orchestrated-node-driver.mjs +3 -2
  596. package/src/update/orchestrated-pnpm.d.mts +4 -0
  597. package/src/update/orchestrated-pnpm.mjs +50 -6
  598. package/src/update/orchestrated-session.d.mts +3 -1
  599. package/src/update/orchestrated-session.mjs +21 -6
  600. package/src/update/pnpm-global-install.d.mts +21 -3
  601. package/src/update/pnpm-global-install.mjs +322 -19
  602. package/src/update/pnpm-store-layout.mjs +46 -0
  603. package/src/update/sync-update-mutex.d.mts +3 -2
  604. package/src/update/sync-update-mutex.mjs +57 -8
  605. package/src/update/transactional-install.d.mts +3 -1
  606. package/src/update/transactional-install.mjs +545 -12
  607. package/src/update/windows-installer-marker.d.mts +1 -0
  608. package/src/update/windows-installer-marker.mjs +44 -0
  609. package/src/usage/expected-prices.ts +8 -0
  610. package/src/usage/filter-index.ts +326 -77
  611. package/src/usage/ledger-scanner.ts +15 -0
  612. package/src/usage/link-log-fields.ts +48 -0
  613. package/src/usage/log.ts +43 -2
  614. package/src/usage/request-body.ts +37 -0
  615. package/src/web-search/loop.ts +3 -0
  616. package/src/web-search/parse.ts +21 -2
  617. package/gui/dist/assets/App-g3Cm2xhZ.js +0 -59
  618. package/gui/dist/assets/Tray-BMDkAiXy.js +0 -1
  619. package/gui/dist/assets/index-Bziu8gTy.css +0 -2
  620. package/gui/dist/assets/index-OYzhQUNP.js +0 -94
  621. package/gui/dist/classic/assets/App-CgPBKUP-.js +0 -58
  622. package/gui/dist/classic/assets/index-BR-HhNrp.js +0 -94
  623. package/gui/dist/classic/assets/quota-summary-CXKhvSmQ.js +0 -1
  624. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,168 @@
1
+ /**
2
+ * `ocx disconnect` ends the connection in the durable state; the runtime that served it keeps
3
+ * running until something restarts it. Left alone it still answered as a client, so the machine
4
+ * was neither a working Child nor standalone, and a Home could not link it again. Disconnect
5
+ * therefore restarts that runtime itself (the same restart as `ocx restart`, which a disconnected
6
+ * client runtime hands to whichever owner holds it), bound to the runtime generation it observed,
7
+ * and exits 0 only when no client runtime remained or a live standalone runtime answers afterwards.
8
+ * Every other outcome exits 1, so a Home-driven leave stops before its own `ocx restart`.
9
+ */
10
+ import type { ProxyRestartIo, ProxyRestartLive, ProxyRestartRequestOutcome } from "./tray-proxy";
11
+ import { RESTART_OWNERS, type RestartOwner } from "../client/runtime-restart";
12
+
13
+ function isHandledRestartOwner(value: string | undefined): value is RestartOwner {
14
+ return value !== undefined && (RESTART_OWNERS as readonly string[]).includes(value);
15
+ }
16
+
17
+ /**
18
+ * One runtime process: its runtime record. The attestation secret is created per process
19
+ * (src/lib/local-management-attestation.ts createLocalAttestationSecret), so a new process at a
20
+ * reused pid has a different one.
21
+ */
22
+ export interface RuntimeGeneration {
23
+ pid: number;
24
+ port: number;
25
+ hostname?: string;
26
+ attestationSecret: string;
27
+ /** The owner the runtime classified from positive evidence; absent for a bare flag or an older runtime. */
28
+ restartOwner?: string;
29
+ }
30
+
31
+ export type DisconnectClientState =
32
+ | { kind: "disconnected" }
33
+ | { kind: "connected" }
34
+ | { kind: "invalid" | "mismatched"; reason: string };
35
+
36
+ export interface DisconnectRuntimeDeps {
37
+ /** Liveness that separates a confirmed absence from a probe that could not decide. */
38
+ observe: () => Promise<
39
+ | { kind: "live"; live: { pid: number | null; port: number; role?: string } }
40
+ | { kind: "absent" | "unknown"; live: null }
41
+ >;
42
+ /** The runtime record of the observed runtime, only when it names that pid and port. */
43
+ capture: (live: { pid: number | null; port: number }) => RuntimeGeneration | null;
44
+ /** The durable client state, read right before the restart. */
45
+ connectionState: () => DisconnectClientState;
46
+ /**
47
+ * `ocx restart` bound to this generation (see {@link bindRestartToRuntime}). `refusedBy` names a
48
+ * supervisor that refused it: an owning service manager whose relaunch could not be proven.
49
+ */
50
+ restart: (target: RuntimeGeneration) => Promise<{ ok: boolean; refusedBy?: "service-unproven" }>;
51
+ json: boolean;
52
+ info?: (line: string) => void;
53
+ error?: (line: string) => void;
54
+ }
55
+
56
+ /**
57
+ * Bind a restart to one runtime generation. The restart discovers its target again, and a connect
58
+ * that committed in between can have started a new client runtime there, even at a reused pid.
59
+ * The request goes out only for the captured pid and port, and the runtime record it attests and
60
+ * derives the restart capability from is the captured one: a different process cannot prove that
61
+ * secret, so it is refused before the restart request is sent, and its listener would reject the
62
+ * capability anyway. A runtime that is gone gets no generic start.
63
+ */
64
+ export function bindRestartToRuntime(
65
+ io: ProxyRestartIo,
66
+ target: RuntimeGeneration,
67
+ request: (previous: ProxyRestartLive, readRuntime: (pid: number) => RuntimeGeneration | null) => ProxyRestartRequestOutcome | Promise<ProxyRestartRequestOutcome>,
68
+ ): ProxyRestartIo {
69
+ return {
70
+ ...io,
71
+ startWhenStopped: () => ({ status: "skipped" }),
72
+ requestInPlaceRestart: previous => (previous.pid !== target.pid || previous.port !== target.port
73
+ ? { accepted: false, uncertain: false, error: new Error("restart_target_changed") }
74
+ : request(previous, pid => (pid === target.pid ? target : null))),
75
+ };
76
+ }
77
+
78
+ /** What is known about the runtime answering when the advice is given. */
79
+ export type AnsweringRuntime =
80
+ | { kind: "captured"; pid: number | null; refusedBy?: "service-unproven" }
81
+ | { kind: "different"; pid: number | null }
82
+ | { kind: "unknown" }
83
+ | { kind: "none" };
84
+
85
+ /**
86
+ * The only source of recovery advice for every exit-1 outcome of this step. A plain
87
+ * `ocx restart` is advised only while the state read now is disconnected and either the captured
88
+ * runtime is still the one answering, or nothing answers at all (a start, nothing to interrupt).
89
+ * Any other state gets what was seen and `ocx status` inspection, never a restart.
90
+ */
91
+ export function recoveryAdvice(state: DisconnectClientState, answering: AnsweringRuntime): string {
92
+ if (state.kind === "connected") {
93
+ return "A new connection is in use on this machine; inspect it with ocx status and ocx connect status and do not restart it. If this machine should leave its Home, run ocx disconnect again.";
94
+ }
95
+ if (state.kind !== "disconnected") {
96
+ return `The client state is ${state.kind} (${state.reason}). Inspect it with ocx connect status and ocx status, fix the client state, then run ocx disconnect again.`;
97
+ }
98
+ switch (answering.kind) {
99
+ case "captured": return answering.refusedBy
100
+ ? `The client runtime${answering.pid ? ` (pid ${answering.pid})` : ""} still serves the old connection, and its service manager did not allow a restart from here. Restart it through the manager: ocx service restart (check ocx service status).`
101
+ : `The client runtime${answering.pid ? ` (pid ${answering.pid})` : ""} still serves the old connection. Run on this machine: ocx restart`;
102
+ case "different": return `A different client runtime${answering.pid ? ` (pid ${answering.pid})` : ""} answers now, so it was not restarted; inspect it with ocx status and ocx connect status before restarting anything.`;
103
+ case "unknown": return "Which runtime answers could not be determined; inspect with ocx status and ocx connect status, and restart a client runtime only while ocx connect status reports disconnected.";
104
+ case "none": return "No runtime answers; start one with ocx restart (or the desktop app or ocx service start, whichever owns it).";
105
+ }
106
+ }
107
+
108
+ /**
109
+ * Exit 0 only when no client runtime remains and the state is disconnected: read once after the
110
+ * observation when no runtime or a non-client runtime answered, and again after a restart. Every
111
+ * exit-1 outcome is a headline plus {@link recoveryAdvice} computed from the state read at that point.
112
+ */
113
+ export async function restartRuntimeAfterDisconnect(deps: DisconnectRuntimeDeps): Promise<number> {
114
+ const info = deps.info ?? (line => console.log(line));
115
+ const error = deps.error ?? (line => console.error(line));
116
+ const fail = (headline: string, answering: AnsweringRuntime): number => {
117
+ error(`${headline} ${recoveryAdvice(deps.connectionState(), answering)}`);
118
+ return 1;
119
+ };
120
+ const observed = await deps.observe();
121
+ if (observed.kind === "unknown") {
122
+ return fail("Disconnected, but this machine could not confirm whether the client runtime stopped: a recorded OpenCodex process did not answer.", { kind: "unknown" });
123
+ }
124
+ const client = observed.kind === "live" && observed.live.role === "client" ? observed.live : null;
125
+ // Captured before the state is read: a runtime a later connect starts is a later generation.
126
+ const target = client ? deps.capture(client) : null;
127
+ if (client && !target) {
128
+ return fail(`Disconnected, but this machine could not identify the running client runtime${client.pid ? ` (pid ${client.pid})` : ""}: its runtime record is missing or names another process, so it was not restarted.`, { kind: "unknown" });
129
+ }
130
+ // Only a record that states an owner this step handles (written by a runtime with this change:
131
+ // the desktop app, a service manager with a current marker, or no supervisor) is restarted. Any
132
+ // other record, a bare OCX_SERVICE=1 runtime or one started before this change, is left exactly
133
+ // as origin/dev's `ocx disconnect` left it: no restart request, the disconnect's own exit 0.
134
+ if (target && !isHandledRestartOwner(target.restartOwner)) return 0;
135
+ const before = deps.connectionState();
136
+ if (before.kind !== "disconnected") {
137
+ error(`Disconnect finished, but the client runtime was not restarted. ${recoveryAdvice(before, { kind: "unknown" })}`);
138
+ return 1;
139
+ }
140
+ if (!client || !target) return 0;
141
+ // A --json caller reads one document from stdout; restart progress goes to stderr.
142
+ const originalLog = console.log;
143
+ if (deps.json) console.log = (...args: unknown[]) => console.error(...args);
144
+ let ok = false;
145
+ let refusedBy: "service-unproven" | undefined;
146
+ try { ({ ok, refusedBy } = await deps.restart(target)); } finally { console.log = originalLog; }
147
+ const after = await deps.observe();
148
+ if (after.kind === "live" && after.live.role !== "client") {
149
+ const late = deps.connectionState();
150
+ if (late.kind !== "disconnected") {
151
+ error(`The client runtime was restarted, but the client state changed meanwhile. ${recoveryAdvice(late, { kind: "unknown" })}`);
152
+ return 1;
153
+ }
154
+ (deps.json ? error : info)("The client runtime was restarted; this machine now runs standalone OpenCodex.");
155
+ return 0;
156
+ }
157
+ if (after.kind === "live") {
158
+ const answering = deps.capture(after.live);
159
+ const who: AnsweringRuntime = !answering ? { kind: "unknown" }
160
+ : answering.attestationSecret === target.attestationSecret ? { kind: "captured", pid: after.live.pid, ...(refusedBy ? { refusedBy } : {}) }
161
+ : { kind: "different", pid: after.live.pid };
162
+ if (ok && who.kind === "captured") {
163
+ return fail("The restart completed, but the runtime still answers as a client.", { kind: "unknown" });
164
+ }
165
+ return fail(ok ? "The restart completed, but a client runtime answers." : "Disconnected, but the restart did not complete.", who);
166
+ }
167
+ return fail("Disconnected, but this machine could not confirm a standalone runtime afterwards.", after.kind === "absent" ? { kind: "none" } : { kind: "unknown" });
168
+ }
@@ -1,4 +1,4 @@
1
- import type { ProxyRestartStartOutcome } from "./tray-proxy";
1
+ import type { ProxyRestartIo, ProxyRestartStartOutcome } from "./tray-proxy";
2
2
  import type { RestartSupervisor } from "./restart-failure";
3
3
  /**
4
4
  * Registry-driven command dispatch (Phase 3 of the CLI deepening).
@@ -21,11 +21,11 @@ import { printUnknownCommand } from "./help-recovery";
21
21
  import {
22
22
  HUB_GATED_SKIP_MESSAGE,
23
23
  localClientSkipMessage,
24
- setIntegrationEnabled,
25
24
  shouldSyncCodexOnStart,
26
25
  type LocalClientSkipReason,
27
26
  } from "../codex/desired-state";
28
27
  import { siblingSkipMessage } from "../codex/sibling-start";
28
+ import { setHomeIntegrationEnabled, type HomeIntegrationResult } from "../routing/home-route-capture";
29
29
  import { syncModelsToCodex } from "../codex/sync";
30
30
  import { collectOrcaCodexHomeDiagnostic } from "../codex/home";
31
31
  import { restoreNativeCodexAsync, type CodexNativeRestoreResult } from "../codex/inject";
@@ -35,6 +35,7 @@ import { normalizeUpdateChannel, runGuiUpdateWorker } from "../update/job";
35
35
  import { isJsonOption, takeFlag } from "./runtime-api";
36
36
  import { printStopSummary, type StopOutcome } from "./stop-report";
37
37
  import { parseStopApproval, type StopApproval } from "./stop-approval";
38
+ import { resolveStopDeadlineMs, setStopDeadlineMs } from "../service/windows-stop-deadline";
38
39
  import type { ResolveArgs } from "./resolve";
39
40
  import type { ClientConnectionState } from "../client/state";
40
41
  import { OCX_NATIVE_REPLAY_RECOVERY_NOTE } from "../responses/compaction";
@@ -60,7 +61,8 @@ export interface CliDispatchDeps {
60
61
  handleTrayProxyStart: (existingIsSuccess?: boolean) => Promise<boolean>;
61
62
  handleTrayProxyRestart: () => Promise<void>;
62
63
  handleRestartStartWhenStopped: (recoveringLiveRestart?: boolean) => Promise<ProxyRestartStartOutcome>;
63
- handleProxyRestart: (startWhenStopped: (recoveringLiveRestart: boolean) => Promise<ProxyRestartStartOutcome>, onSupervised?: (supervisor: RestartSupervisor) => void) => Promise<boolean>;
64
+ /** `bindIo` lets a caller bind the restart to one target (ocx disconnect: src/cli/disconnect-runtime.ts). */
65
+ handleProxyRestart: (startWhenStopped: (recoveringLiveRestart: boolean) => Promise<ProxyRestartStartOutcome>, onSupervised?: (supervisor: RestartSupervisor) => void, bindIo?: (io: ProxyRestartIo, deadlineAt: number) => ProxyRestartIo) => Promise<boolean>;
64
66
  handleUninstall: () => Promise<void>;
65
67
  handleStatus: () => Promise<void>;
66
68
  handleRecoverHistory: () => Promise<void>;
@@ -89,6 +91,12 @@ export function selectDefaultGuiUrl(
89
91
  return `http://${guiHost}:${live?.port ?? config.port ?? 10100}`;
90
92
  }
91
93
 
94
+ /** An unavailable route-intent file names the file to repair; the other refusals keep their reason. */
95
+ function desiredStateRefusal(desired: Extract<HomeIntegrationResult, { ok: false }>): string {
96
+ return desired.reason === "unavailable" ? `Codex desired state was not saved (unavailable): ${desired.message}`
97
+ : `Codex desired state was not saved (${desired.reason}).`;
98
+ }
99
+
92
100
  const commandRunners: Record<string, CommandRunner> = {
93
101
  init: async () => {
94
102
  const { runInit } = await import("./init");
@@ -110,9 +118,11 @@ const commandRunners: Record<string, CommandRunner> = {
110
118
  stop: async deps => {
111
119
  const parsed = parseStopApproval(deps.args.slice(1));
112
120
  if (!parsed.ok) {
113
- console.error("Usage: ocx stop [--json [--expect-pid <pid> --expect-port <port> --expect-hostname <host> --expect-config-home <home> --expect-cli-version <version> --expect-compatibility-token <hex>]]");
121
+ console.error("Usage: ocx stop [--deadline-ms <ms>] [--json [--expect-pid <pid> --expect-port <port> --expect-hostname <host> --expect-config-home <home> --expect-cli-version <version> --expect-compatibility-token <hex>]]");
114
122
  return 64;
115
123
  }
124
+ // #7771: the Windows checked stop's deadline, from this process's start (flag, then env, then 60 s).
125
+ setStopDeadlineMs(resolveStopDeadlineMs(parsed.deadlineMs));
116
126
  // Downtime warning lives HERE, not in handleStop: `restart`/tray-restart callers
117
127
  // re-start the proxy immediately, so warning there would contradict the next line.
118
128
  const warning = "⚠️ Codex/Claude requests through the proxy will fail until it is restarted ('ocx start' or 'ocx service start').";
@@ -173,13 +183,13 @@ const commandRunners: Record<string, CommandRunner> = {
173
183
  if (!live) {
174
184
  return emitBack(false, "No running proxy found. Run 'ocx start' — it injects opencodex automatically.", 1);
175
185
  }
176
- const desired = setIntegrationEnabled("codex", true);
186
+ const desired = setHomeIntegrationEnabled("codex", true);
177
187
  if (!desired.ok) {
178
- return emitBack(false, `Codex desired state was not saved (${desired.reason}).`, desired.reason === "conflict" ? 2 : 1);
188
+ return emitBack(false, desiredStateRefusal(desired), desired.reason === "conflict" ? 2 : 1);
179
189
  }
180
190
  const synced = await syncModelsToCodex(live.port);
181
191
  if (synced.status === "skipped") {
182
- // `setIntegrationEnabled` above just committed ON, so a skip here is NOT the toggle and
192
+ // `setHomeIntegrationEnabled` above just committed ON, so a skip here is NOT the toggle and
183
193
  // is not a competing writer either — on a hub it is the role gate. Telling the operator
184
194
  // to "retry after the competing integration change finishes" sent them waiting for a
185
195
  // writer that does not exist (#4236).
@@ -200,15 +210,15 @@ const commandRunners: Record<string, CommandRunner> = {
200
210
  if (removeProviderTable && !restoreJson) {
201
211
  console.log("⚠️ Removing [model_providers.opencodex] means conversations already tagged opencodex will stop opening.");
202
212
  }
203
- const desired = setIntegrationEnabled("codex", false);
213
+ const desired = setHomeIntegrationEnabled("codex", false);
204
214
  if (!desired.ok) {
205
215
  if (restoreJson) {
206
216
  // Machine-readable contract: every restore --json outcome emits one
207
217
  // schema-complete envelope on stdout, including pre-machinery failures.
208
218
  const { skippedRestoreEnvelope } = await import("../codex/inject");
209
- console.log(JSON.stringify(skippedRestoreEnvelope(false, `Codex desired state was not saved (${desired.reason}).`)));
219
+ console.log(JSON.stringify(skippedRestoreEnvelope(false, desiredStateRefusal(desired))));
210
220
  } else {
211
- console.error(`Codex desired state was not saved (${desired.reason}).`);
221
+ console.error(desiredStateRefusal(desired));
212
222
  }
213
223
  return desired.reason === "conflict" ? 2 : 1;
214
224
  }
@@ -423,7 +433,35 @@ const commandRunners: Record<string, CommandRunner> = {
423
433
  },
424
434
  disconnect: async deps => {
425
435
  const { handleDisconnectCommand } = await import("./connect");
426
- return await handleDisconnectCommand(deps.args.slice(1));
436
+ const code = await handleDisconnectCommand(deps.args.slice(1));
437
+ // Token recovery refuses any live client runtime and leaves nothing to restart.
438
+ if (code !== 0 || deps.args.includes("--orphaned-token")) return code;
439
+ const { bindRestartToRuntime, restartRuntimeAfterDisconnect } = await import("./disconnect-runtime");
440
+ const { observeProxyLiveness } = await import("../server/proxy-liveness");
441
+ const { readClientConnectionStateWithEvidence } = await import("../client/state");
442
+ const { readRuntimePort } = await import("../config/process-state");
443
+ const { requestBoundSystemRestart } = await import("./system-restart-client");
444
+ return await restartRuntimeAfterDisconnect({
445
+ observe: () => observeProxyLiveness({ attempts: 2 }),
446
+ capture: live => {
447
+ if (live.pid === null) return null;
448
+ const record = readRuntimePort(live.pid);
449
+ return record?.attestationSecret && record.pid === live.pid && record.port === live.port
450
+ ? { ...record, attestationSecret: record.attestationSecret } : null;
451
+ },
452
+ connectionState: () => {
453
+ const state = readClientConnectionStateWithEvidence();
454
+ return state.kind === "invalid" || state.kind === "mismatched" ? { kind: state.kind, reason: state.reason } : { kind: state.kind };
455
+ },
456
+ restart: async target => {
457
+ let refusedBy: "service-unproven" | undefined;
458
+ const ok = await deps.handleProxyRestart(deps.handleRestartStartWhenStopped, supervisor => { if (supervisor === "service-unproven") refusedBy = supervisor; }, (io, deadlineAt) =>
459
+ bindRestartToRuntime(io, target, (previous, readRuntime) =>
460
+ requestBoundSystemRestart(previous as Parameters<typeof requestBoundSystemRestart>[0], deadlineAt, { readRuntime: readRuntime as typeof readRuntimePort })));
461
+ return { ok, ...(refusedBy ? { refusedBy } : {}) };
462
+ },
463
+ json: deps.args.includes("--json"),
464
+ });
427
465
  },
428
466
  catalog: async deps => {
429
467
  const { handleCatalogCommand } = await import("./catalog");
@@ -752,8 +790,12 @@ const commandRunners: Record<string, CommandRunner> = {
752
790
  return await handleCompanionCommand(deps.args.slice(1), { findLiveProxy: deps.findLiveProxy });
753
791
  },
754
792
  route: async deps => {
793
+ if (deps.args[1] === "to") {
794
+ const { handleRouteToCommand } = await import("./route-to");
795
+ return await handleRouteToCommand(deps.args.slice(2), { findLiveProxy: deps.findLiveProxy });
796
+ }
755
797
  if (deps.args[1] !== "combo" && deps.args[1] !== "policy") {
756
- console.error("Usage: ocx route <combo|policy> <subcommand>");
798
+ console.error("Usage: ocx route <to|combo|policy> <subcommand>");
757
799
  return 2;
758
800
  }
759
801
  if (deps.args[1] === "combo") {
@@ -174,7 +174,7 @@ export async function handleExportCommand(argv: string[], deps: ExportCommandDep
174
174
  const spec = EXPORT_CLIENTS[client];
175
175
  const root = await runtimeBaseUrl(deps);
176
176
  let built: { document: unknown; text: string };
177
- if (modelNames !== undefined || client === "t3code" || client === "raycast" || client === "droid" || client === "qoder" || client === "qoder-cn" || client === "workbuddy" || client === "workbuddy-ai") {
177
+ if (modelNames !== undefined || client === "pi" || client === "t3code" || client === "raycast" || client === "droid" || client === "qoder" || client === "qoder-cn" || client === "workbuddy" || client === "workbuddy-ai") {
178
178
  // The dial address alone cannot distinguish a wildcard authenticated bind
179
179
  // from loopback. Let the live server resolve its admission/listener policy;
180
180
  // saved config can differ from the process serving this request.
@@ -17,6 +17,7 @@ import {
17
17
  GUI_PAIR_METHOD,
18
18
  GUI_PAIR_NONCE_HEADER,
19
19
  GUI_PAIR_PATH,
20
+ DESKTOP_GUI_PAIR_PATH,
20
21
  canonicalGuiBrowserOrigin,
21
22
  canonicalHttpOrigin,
22
23
  createGuiPairCapability,
@@ -31,9 +32,10 @@ import {
31
32
 
32
33
  export type GuiPairRequestResult =
33
34
  | { kind: "created"; grant: string; browserOrigin: string; serverOrigin: string; expiresAt: number }
34
- | { kind: "unavailable"; reason: "unattested-target" | "runtime-mismatch" | "attestation" | "capability" | "transport" | "rejected" | "local-intent" };
35
+ | { kind: "unavailable"; reason: "unattested-target" | "runtime-mismatch" | "attestation" | "capability" | "transport" | "rejected" | "local-intent" | "origin-refused" | "rate-limited" };
35
36
 
36
37
  export interface GuiPairClientDeps {
38
+ desktopPurpose?: boolean;
37
39
  fetchImpl?: typeof fetch;
38
40
  readRuntime?: (pid: number) => RuntimePortState | null;
39
41
  createChallenge?: () => string;
@@ -57,6 +59,27 @@ function sameRuntime(left: RuntimePortState, right: RuntimePortState | null): bo
57
59
  && timingSafeEqual(leftSecret, rightSecret);
58
60
  }
59
61
 
62
+ /**
63
+ * Which refusal the grant route sent, as one fixed word; the body itself never surfaces.
64
+ *
65
+ * Only the route's plain 403 "GUI pairing grant refused" (no `code`) means its loaded config did not
66
+ * admit this origin, the one case an allow-list edit or a restart can cure (#8319). Its 429 is the
67
+ * per-minute grant limit. A coded refusal, a capability refusal and anything else stay `rejected`,
68
+ * so the caller does not send an operator to edit a correct allow-list (#8495 review).
69
+ *
70
+ * This is a heuristic: the route answers the same uncoded 403 for any unexpected failure inside
71
+ * grant creation, not only for a refused origin. Those are rare and the advice (check the two origin
72
+ * settings, restart) is harmless there; an explicit server code would make it exact.
73
+ */
74
+ async function refusalReason(response: Response): Promise<"origin-refused" | "rate-limited" | "rejected"> {
75
+ if (response.status === 429) return "rate-limited";
76
+ if (response.status !== 403) return "rejected";
77
+ const body: unknown = await response.json().catch(() => null);
78
+ if (!body || typeof body !== "object" || Array.isArray(body)) return "rejected";
79
+ const record = body as Record<string, unknown>;
80
+ return record.error === "GUI pairing grant refused" && record.code === undefined ? "origin-refused" : "rejected";
81
+ }
82
+
60
83
  function parseCreatedResult(value: unknown, browserOrigin: string): GuiPairRequestResult | null {
61
84
  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
62
85
  const record = value as Record<string, unknown>;
@@ -129,11 +152,12 @@ export async function requestBoundGuiPairingGrant(
129
152
  return { kind: "unavailable", reason: "runtime-mismatch" };
130
153
  }
131
154
  const expiresAt = (deps.now ?? Date.now)() + GUI_PAIR_CAPABILITY_TTL_MS;
155
+ const path = deps.desktopPurpose ? DESKTOP_GUI_PAIR_PATH : GUI_PAIR_PATH;
132
156
  const capability = createGuiPairCapability(
133
157
  runtime.attestationSecret,
134
158
  challenge,
135
159
  GUI_PAIR_METHOD,
136
- GUI_PAIR_PATH,
160
+ path,
137
161
  browserOrigin,
138
162
  target.pid,
139
163
  target.port,
@@ -142,10 +166,10 @@ export async function requestBoundGuiPairingGrant(
142
166
  if (!capability) return { kind: "unavailable", reason: "capability" };
143
167
  let intent: GuiPairIntent | undefined;
144
168
  try {
145
- if (deps.requireLocalIntent !== false) intent = (deps.createIntent ?? createGuiPairIntent)(capability);
169
+ if (deps.desktopPurpose || deps.requireLocalIntent !== false) intent = (deps.createIntent ?? createGuiPairIntent)(capability);
146
170
  } catch { return { kind: "unavailable", reason: "local-intent" }; }
147
171
  try {
148
- const response = await fetchImpl(`${baseUrl}${GUI_PAIR_PATH}`, {
172
+ const response = await fetchImpl(`${baseUrl}${path}`, {
149
173
  method: GUI_PAIR_METHOD,
150
174
  headers: {
151
175
  "Content-Length": "0",
@@ -158,7 +182,7 @@ export async function requestBoundGuiPairingGrant(
158
182
  },
159
183
  signal: AbortSignal.timeout(timeoutMs),
160
184
  });
161
- if (!response.ok) return { kind: "unavailable", reason: "rejected" };
185
+ if (!response.ok) return { kind: "unavailable", reason: await refusalReason(response) };
162
186
  const result = parseCreatedResult(await response.json().catch(() => null), browserOrigin);
163
187
  return result ?? { kind: "unavailable", reason: "rejected" };
164
188
  } catch {
package/src/cli/gui.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import type { OcxConfig } from "../types";
2
+ import { desktopGuiOrigin } from "../lib/desktop-gui-origin";
2
3
  import { canonicalGuiBrowserOrigin, standaloneGuiPairingOrigin } from "../lib/gui-pair-capability";
3
4
  import { findLiveProxy, type LiveProxy } from "../server/proxy-liveness";
4
5
  import {
@@ -8,7 +9,7 @@ import {
8
9
  } from "./gui-pair-client";
9
10
  import type { RuntimeApiDeps } from "./runtime-api";
10
11
 
11
- const GUI_USAGE = "ocx gui [pair --origin <browser-origin> [--json]]";
12
+ const GUI_USAGE = "ocx gui [pair [--desktop] --origin <browser-origin> [--json]]";
12
13
  const PAIRING_WARNING = "Pairing grants are secret, single-use, and expire quickly. Do not save them.";
13
14
 
14
15
  export interface GuiCommandDeps extends RuntimeApiDeps {
@@ -28,11 +29,13 @@ function allowedPairingOrigin(origin: string, config: OcxConfig): boolean {
28
29
  return (config.corsAllowOrigins ?? []).some(value => canonicalGuiBrowserOrigin(value) === origin);
29
30
  }
30
31
 
31
- function parsePairArgs(args: string[]): { origin: string; json: boolean } | null {
32
+ function parsePairArgs(args: string[]): { origin: string; json: boolean; desktop: boolean } | null {
32
33
  let origin: string | undefined;
33
34
  let json = false;
35
+ let desktop = false;
34
36
  for (let index = 0; index < args.length; index++) {
35
37
  const arg = args[index]!;
38
+ if (arg === "--desktop" && !desktop) { desktop = true; continue; }
36
39
  if (arg === "--json" && !json) {
37
40
  json = true;
38
41
  continue;
@@ -45,7 +48,7 @@ function parsePairArgs(args: string[]): { origin: string; json: boolean } | null
45
48
  }
46
49
  return null;
47
50
  }
48
- return origin ? { origin, json } : null;
51
+ return origin ? { origin, json, desktop } : null;
49
52
  }
50
53
 
51
54
  export async function runGuiCommand(args: string[], deps: GuiCommandDeps): Promise<number> {
@@ -61,8 +64,9 @@ export async function runGuiCommand(args: string[], deps: GuiCommandDeps): Promi
61
64
  return 1;
62
65
  }
63
66
  const config = deps.loadConfig();
64
- if (!allowedPairingOrigin(canonicalOrigin, config)) {
65
- console.error("Pairing requires the standalone configured literal loopback origin, or an allowed hub origin.");
67
+ if (!(parsed.desktop ? desktopGuiOrigin(config, canonicalOrigin) === canonicalOrigin : allowedPairingOrigin(canonicalOrigin, config))) {
68
+ console.error(parsed.desktop ? "Desktop authorization requires the standalone local dashboard origin and its exact listening port."
69
+ : "Pairing requires the standalone configured literal loopback origin, or an allowed hub origin.");
66
70
  return 1;
67
71
  }
68
72
  const target = await (deps.findLiveProxy ?? findLiveProxy)();
@@ -78,6 +82,7 @@ export async function runGuiCommand(args: string[], deps: GuiCommandDeps): Promi
78
82
  const result = await (deps.requestPairingGrant ?? requestBoundGuiPairingGrant)(target, canonicalOrigin, {
79
83
  ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
80
84
  requireLocalIntent: config.runtimeRole !== "hub",
85
+ desktopPurpose: parsed.desktop,
81
86
  });
82
87
  if (result.kind !== "created") {
83
88
  console.error(result.reason === "local-intent"
@@ -1,5 +1,6 @@
1
1
  import { CAPABILITIES, type Capability } from "./capabilities";
2
2
  import { CLI_COMMANDS, findCommand, type CliCommandEntry } from "./registry";
3
+ import { EXPORT_CLIENT_IDS } from "../clients/client-ids";
3
4
 
4
5
  export type HelpResolution =
5
6
  | { kind: "entry"; entry: CliCommandEntry; canonicalName: string; capability?: Capability; children: readonly Capability[] }
@@ -88,6 +89,16 @@ export function resolveHelpPath(requested: readonly string[]): HelpResolution {
88
89
  const capability = declared.find(candidate => candidate.command.length === path.length && startsWithPath(candidate.command, path));
89
90
  const children = declared.filter(candidate => candidate.command.length > path.length && startsWithPath(candidate.command, path));
90
91
  if (capability) return { kind: "capability", path, capability, children };
92
+ // Clients and modes are operands of one capability, not registry leaves. Resolve their
93
+ // help without multiplying the generated operating surface by every client/action pair.
94
+ if (path[0] === "route" && path[1] === "to" && path.length >= 3
95
+ && ["codex", "claude", "claude-desktop", "grok", ...EXPORT_CLIENT_IDS].includes(path[2])) {
96
+ const owner = declared.find(candidate => candidate.command.join(" ") === "route to");
97
+ if (owner && path.length === 3) return { kind: "prefix", path, children: ["on", "off", "inherit"].map(action => ({ ...owner, command: [...path, action] })) };
98
+ if (owner && path.length === 4 && ["on", "off", "inherit"].includes(path[3])) {
99
+ return { kind: "capability", path, capability: { ...owner, command: path }, children: [] };
100
+ }
101
+ }
91
102
  if (children.length) return { kind: "prefix", path, children };
92
103
 
93
104
  for (let length = Math.min(path.length - 1, MAX_DOCUMENTED_DEPTH); length > 1; length--) {
package/src/cli/help.ts CHANGED
@@ -51,6 +51,7 @@ Usage:
51
51
  ocx disconnect Restore local state and clear the hub connection
52
52
  ocx sync [--local-only] [--json] [--restart-codex] Sync models and linked Children
53
53
  --expect-link <id> | --expect-hub-key <id>: only from that Home/hub key (exit 5 otherwise)
54
+ --child <id>: only those Children; --restart-children[=app-server | =codex --yes]: restart their Codex
54
55
  ocx sync-cache [--restart-codex]
55
56
  Refresh Codex's model cache from the active catalog
56
57
  ocx catalog pull <https-url> Install a validated remote catalog and refresh the Codex cache
@@ -63,11 +64,11 @@ Usage:
63
64
  ocx debug <scope> provider/usage/injection/claude on|off|status|reset
64
65
  ocx login <provider> OAuth or API-key provider login (ocx login codex for Codex/ChatGPT)
65
66
  ocx logout <provider> Remove a stored OAuth login
66
- ocx gui [pair --origin <browser-origin> [--json]]
67
- Open the dashboard or create a single-use remote pairing grant
67
+ ocx gui [pair [--desktop] --origin <browser-origin> [--json]]
68
+ Open the dashboard, pair a remote GUI, or authorize local Desktop changes (--desktop)
68
69
  ocx hub invite [--json] Print a ready-to-run \`ocx connect\` line for one more machine
69
70
  (hub only; see \`ocx help hub\` for the one-port topology)
70
- ocx link <sub> Machine links over SSH (port|issue|revoke|status)
71
+ ocx link <sub> Machine links over SSH (port|issue|revoke|status|check)
71
72
  ocx update [--tag <tag>] Update opencodex (keeps preview installs on @preview)
72
73
  ocx restart Stop and restart the proxy
73
74
  ocx v2 <sub> multi_agent_v2 surface (status|on|off|mode|keep-native-v1|threads|mode-hint)
@@ -86,7 +87,7 @@ Usage:
86
87
  ocx fallback <sub> Turn model or provider fallback off per scope; per-device local fallback
87
88
  ocx observe <sub> Logs, usage, storage, memory, and debug data
88
89
  ocx inspect <sub> Effective config, catalog, analytics, pacing, client-config
89
- ocx route <sub> Routing features (combo, policy)
90
+ ocx route <sub> Routing features (to, combo, policy)
90
91
  ocx logs [filters] Alias of ocx observe logs
91
92
  ocx usage [--range <today|1d|7d|30d|all>] [--provider <name>] [--model <id>] [--top <1-1000>]
92
93
  Token and estimated-cost report (alias of ocx observe usage)
package/src/cli/hub.ts CHANGED
@@ -7,7 +7,7 @@ import {
7
7
  type GuiPairRequestResult,
8
8
  } from "./gui-pair-client";
9
9
  import type { RuntimeApiDeps } from "./runtime-api";
10
- import { HUB_DISABLE_USAGE, runHubDisable, type HubDisableDeps } from "./hub-disable";
10
+ import { HUB_DISABLE_USAGE, hubDisableRestartHint, runHubDisable, type HubDisableDeps } from "./hub-disable";
11
11
 
12
12
  export const HUB_USAGE =
13
13
  "ocx hub invite [--json] [--data-url <origin>] [--management-url <origin>] [--clients codex,claude]\n " + HUB_DISABLE_USAGE;
@@ -32,6 +32,8 @@ export interface HubCommandDeps extends RuntimeApiDeps, HubDisableDeps {
32
32
  browserOrigin: string,
33
33
  deps?: GuiPairClientDeps,
34
34
  ) => Promise<GuiPairRequestResult>;
35
+ /** Supervisor-aware "Restart to apply: …" line; injected so tests do not probe the machine. */
36
+ restartHint?: () => string;
35
37
  }
36
38
 
37
39
  export interface HubInviteOptions {
@@ -333,6 +335,21 @@ async function runInvite(args: string[], deps: HubCommandDeps): Promise<number>
333
335
  });
334
336
  if (result.kind !== "created") {
335
337
  console.error(`Minting a pairing code failed (${result.reason}).`);
338
+ if (result.reason === "origin-refused") {
339
+ // #8319: the CLI picks the origin from the config on disk, but the running hub checks it
340
+ // against the config it is running with, so an allow-list edited since then can be refused
341
+ // until a restart. The reason code alone did not say which origin, setting, or step.
342
+ console.error(
343
+ `The running hub refused to mint a code bound to browser origin ${browserOrigin}. It admits only `
344
+ + "hub.managementPublicOrigin and the corsAllowOrigins entries it is running with, which can predate "
345
+ + "a recent 'ocx config set'. If you changed either, restart the hub and invite again.",
346
+ );
347
+ console.error((deps.restartHint ?? hubDisableRestartHint)());
348
+ } else if (result.reason === "rate-limited") {
349
+ // The 429 covers both the per-minute grant limit and the cap on unused codes, which only
350
+ // clears as earlier codes are used or expire (five minutes), so the advice fits both.
351
+ console.error("The hub is limiting new pairing codes (a per-minute limit and a cap on unused codes). Wait for earlier codes to be used or expire, then invite again.");
352
+ }
336
353
  return 1;
337
354
  }
338
355
  const payload: HubInvitePayload = {