@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,314 @@
1
+ import type { ChildItemState, ChildJob, ChildJobItem, ChildOp } from "../link/child-ops-types";
2
+ import { CATALOG_FANOUT, CHILD_CODEX_RESTART, CHILD_UPDATES, type ChildPolicyRead } from "../link/child-policy";
3
+ import { CliUsageError, RuntimeApiError, printData, rejectArgs, takeFlag, takeIntegerOption, takeJsonFlag, takeOption } from "./runtime-api";
4
+ import type { LinkCliDeps } from "./link";
5
+
6
+ type LinkRequest = <T>(path: string, init: RequestInit, deps: LinkCliDeps) => Promise<T>;
7
+
8
+ export interface LinkCheckDeps extends LinkCliDeps {
9
+ /** Test seams for the job poll. */
10
+ sleep?: (ms: number) => Promise<void>;
11
+ now?: () => number;
12
+ }
13
+
14
+ export const LINK_CHECK_POLL_MS = 2_000;
15
+ export const OLD_HOME_MESSAGE = "This Home does not support Child operations; update the Home.";
16
+ export const NO_ELIGIBLE_LINKS_MESSAGE = "This Home has no links.";
17
+ export const RUNTIME_ROLE_CLIENT_MESSAGE = "This machine is a Child; run Child operations on its Home.";
18
+ export const LINK_NOT_HOME_INITIATED_MESSAGE = "This link was started from the Child, so the Home cannot run operations on it.";
19
+ export const LINK_OPERATION_IN_PROGRESS_MESSAGE = "Another operation is running on this link; wait for it to finish, then try again.";
20
+ export const LOOPBACK_REQUIRED_MESSAGE = "Child operations from the CLI need a Home bound to loopback; on this Home they are not available, and the dashboard has no controls for them.";
21
+ const CONFLICT_MESSAGES: Readonly<Record<string, string>> = {
22
+ no_eligible_links: NO_ELIGIBLE_LINKS_MESSAGE,
23
+ runtime_role_client: RUNTIME_ROLE_CLIENT_MESSAGE,
24
+ link_not_home_initiated: LINK_NOT_HOME_INITIATED_MESSAGE,
25
+ link_operation_in_progress: LINK_OPERATION_IN_PROGRESS_MESSAGE,
26
+ };
27
+
28
+ /** How long one item may run once it has started: the sum of its runner's own SSH bounds plus a margin. */
29
+ export const CHILD_ITEM_WAIT_MS: Readonly<Record<ChildOp, number>> = {
30
+ observe: 120_000, // wp2's value: one 60 s plan probe, one read-only inspection
31
+ sync: 420_000, // platform probe 30 s + two pinned syncs of 180 s
32
+ "restart-codex": 420_000,
33
+ update: 2_100_000, // probe 30 s + identity sync 180 s + plan 60 s + apply 900 s + 120 s grace
34
+ // + post-update sync with retry 2 × 360 s + 30 s
35
+ };
36
+ /** Never poll longer than this from submission, queued or not; the Home keeps a finished job one hour. */
37
+ export const CHILD_JOB_WAIT_CAP_MS = 10_800_000;
38
+
39
+ export type LinkChildVerb = "update" | "sync" | "restart-codex";
40
+ export const LINK_CHILD_OPS_USAGE = [
41
+ " ocx link update (--link-id <id> | --all) --yes [--no-wait] [--json]",
42
+ " ocx link sync (--link-id <id> | --all) [--no-wait] [--json]",
43
+ " ocx link sync --link-id <id> (--restart-app-server-only | --restart-codex --yes) [--ignore-activity] [--no-wait] [--json]",
44
+ " ocx link restart-codex --link-id <id> [--scope app-server|codex] --yes [--ignore-activity] [--no-wait] [--json]",
45
+ " ocx link policy [--updates off|notify|auto-when-idle] [--catalog-fanout auto|manual] [--child-codex-restart never|app-server-when-idle] [--idle-after-minutes <1-60>] [--json]",
46
+ " ocx link activity clear --link-id <id> [--json]",
47
+ ] as const;
48
+
49
+ const LINK_ID = /^lnk_[0-9a-f]{16}$/;
50
+ const JOB_ID = /^ljob_[0-9a-f]{16}$/;
51
+ const SUCCESS: ReadonlySet<string> = new Set<ChildItemState>(["succeeded", "up-to-date"]);
52
+ const PARTIAL: ReadonlySet<string> = new Set<ChildItemState>(["busy", "offline", "refused", "owner-action", "unsupported"]);
53
+
54
+ const isRecord = (value: unknown): value is Record<string, unknown> => value !== null && typeof value === "object" && !Array.isArray(value);
55
+ const errorCode = (error: RuntimeApiError): unknown => (error.body as { error?: { code?: unknown } } | null)?.error?.code;
56
+
57
+ /**
58
+ * Read an `ocx.link.child-job/1` document. Tolerant from its first release (G1, audit H5): known keys are type-checked,
59
+ * unknown keys at job, item, `sync` and `restart` level are dropped, and an unknown string in an enum field is kept
60
+ * for display, so this CLI keeps polling a later Home whose items carry more. A known key of the wrong type throws.
61
+ */
62
+ export function validateChildJob(value: unknown): ChildJob {
63
+ const fail = (field: string): never => { throw new Error(`invalid link API response: job ${field}`); };
64
+ const text = (target: unknown, field: string): string => typeof target === "string" && target.length <= 256 ? target : fail(field);
65
+ const nullableText = (target: unknown, field: string): string | null => target === null ? null : text(target, field);
66
+ if (!isRecord(value)) return fail("object");
67
+ if (value.schema !== "ocx.link.child-job/1") fail("schema");
68
+ if (!Array.isArray(value.items)) fail("items");
69
+ const jobId = text(value.jobId, "jobId");
70
+ if (!JOB_ID.test(jobId)) fail("jobId");
71
+ const items = (value.items as unknown[]).map((raw, index): ChildJobItem => {
72
+ if (!isRecord(raw)) return fail(`item ${index}`);
73
+ const item: ChildJobItem & Record<string, unknown> = {
74
+ linkId: text(raw.linkId, `item ${index} linkId`), alias: text(raw.alias, `item ${index} alias`),
75
+ state: text(raw.state, `item ${index} state`) as ChildItemState, reason: nullableText(raw.reason, `item ${index} reason`),
76
+ startedAt: nullableText(raw.startedAt, `item ${index} startedAt`), finishedAt: nullableText(raw.finishedAt, `item ${index} finishedAt`),
77
+ };
78
+ if (raw.hint !== undefined) item.hint = text(raw.hint, `item ${index} hint`);
79
+ if (raw.fromVersion !== undefined) item.fromVersion = text(raw.fromVersion, `item ${index} fromVersion`);
80
+ if (raw.toVersion !== undefined) item.toVersion = text(raw.toVersion, `item ${index} toVersion`);
81
+ for (const key of ["sync", "restart"] as const) {
82
+ if (raw[key] === undefined || raw[key] === null) continue;
83
+ const nested = raw[key];
84
+ if (!isRecord(nested)) return fail(`item ${index} ${key}`);
85
+ const field = key === "sync" ? "state" : "outcome";
86
+ // Open enum strings are kept for display, so the nested shape is only checked for strings here.
87
+ (item as Record<string, unknown>)[key] = { [field]: text(nested[field], `item ${index} ${key}.${field}`),
88
+ // A wp3 Home always sends restart.requested; an older document may not.
89
+ ...(key === "restart" && nested.requested !== undefined ? { requested: text(nested.requested, `item ${index} restart.requested`) } : {}),
90
+ ...(nested.reason === undefined ? {} : { reason: nullableText(nested.reason, `item ${index} ${key}.reason`) }) };
91
+ }
92
+ return item;
93
+ });
94
+ return {
95
+ schema: "ocx.link.child-job/1", jobId, op: text(value.op, "op") as ChildJob["op"], trigger: text(value.trigger, "trigger") as ChildJob["trigger"],
96
+ restart: text(value.restart, "restart") as ChildJob["restart"], state: text(value.state, "state") as ChildJob["state"],
97
+ ...(value.ignoreActivity === undefined ? {} : { ignoreActivity: value.ignoreActivity === true ? true as const : fail("ignoreActivity") }),
98
+ createdAt: text(value.createdAt, "createdAt"), finishedAt: nullableText(value.finishedAt, "finishedAt"), items,
99
+ };
100
+ }
101
+
102
+ /**
103
+ * D15: 0 every item succeeded or up-to-date with nothing withheld; 6 any item needs the operator; 1 any failure or an
104
+ * unknown state. A success that carries a reason (restart-skipped:link-active, post-update-sync-failed,
105
+ * restart-result-unknown) or whose requested restart did not go out is partial.
106
+ */
107
+ export function linkCheckExitCode(job: ChildJob): number {
108
+ let code = 0;
109
+ for (const item of job.items) {
110
+ if (SUCCESS.has(item.state)) {
111
+ if (item.reason !== null || (item.restart !== undefined && item.restart.outcome !== "requested")) code = Math.max(code, 6);
112
+ continue;
113
+ }
114
+ if (PARTIAL.has(item.state)) code = Math.max(code, 6);
115
+ else return 1;
116
+ }
117
+ return code;
118
+ }
119
+
120
+ function readJob(response: unknown): ChildJob {
121
+ if (!isRecord(response) || Object.keys(response).length !== 1 || !("job" in response)) throw new Error("invalid link API response: job envelope");
122
+ return validateChildJob(response.job);
123
+ }
124
+
125
+ async function waitForChildJob(job: ChildJob, deps: LinkCheckDeps, request: LinkRequest): Promise<{ job: ChildJob; done: boolean }> {
126
+ const sleep = deps.sleep ?? ((ms: number) => new Promise<void>(resolve => setTimeout(resolve, ms)));
127
+ const now = deps.now ?? Date.now;
128
+ const cap = now() + CHILD_JOB_WAIT_CAP_MS;
129
+ const perItem = Object.hasOwn(CHILD_ITEM_WAIT_MS, job.op) ? CHILD_ITEM_WAIT_MS[job.op] : CHILD_ITEM_WAIT_MS.update;
130
+ const lanes = job.op === "update" ? 1 : 3;
131
+ const budget = (current: ChildJob): number =>
132
+ Math.ceil(current.items.filter(item => item.finishedAt === null).length / lanes) * perItem + 30_000;
133
+ let deadline = now() + budget(job);
134
+ while (job.state !== "done") {
135
+ // A queued item has not started its SSH work: while one waits behind another job, the deadline moves with it.
136
+ if (job.items.some(item => item.state === "queued")) deadline = Math.max(deadline, now() + budget(job));
137
+ if (now() >= Math.min(deadline, cap)) return { job, done: false };
138
+ await sleep(LINK_CHECK_POLL_MS);
139
+ job = readJob(await request<unknown>(`/api/link/children/jobs/${encodeURIComponent(job.jobId)}`, {}, deps));
140
+ }
141
+ return { job, done: true };
142
+ }
143
+
144
+ /** The Child-operation routes' refusals as operator messages; a request that is not a Child operation passes nothing in op. */
145
+ function childOpsRefusal(error: unknown, op: ChildOp | null): never {
146
+ if (error instanceof RuntimeApiError) {
147
+ // A new Home answers link_not_found for a mistyped id; an older Home has no such route at all.
148
+ if (error.status === 404 && errorCode(error) !== "link_not_found") throw new RuntimeApiError(OLD_HOME_MESSAGE, 404, error.body);
149
+ // Revision 6 F3: a Home with observe only (wp2) refuses every other op as invalid_body; this CLI always sends a valid body.
150
+ if (error.status === 400 && op !== null && op !== "observe" && errorCode(error) === "invalid_body") throw new RuntimeApiError(OLD_HOME_MESSAGE, 404, error.body);
151
+ // Every 409 still exits 5; the conflicts that are not "another operation holds the link" say what happened.
152
+ if (error.status === 409) {
153
+ const code = errorCode(error);
154
+ const message = typeof code === "string" && Object.hasOwn(CONFLICT_MESSAGES, code) ? CONFLICT_MESSAGES[code] : undefined;
155
+ if (message) throw new RuntimeApiError(message, 409, error.body);
156
+ }
157
+ // Revision 4 (4529521950): a Home not bound to loopback refuses the admin token on its TCP listener.
158
+ if (error.status === 403) throw new RuntimeApiError(LOOPBACK_REQUIRED_MESSAGE, 403, error.body);
159
+ }
160
+ throw error;
161
+ }
162
+
163
+ /** POST one operation, then wait for it unless told not to; prints the job document and returns the verdict exit. */
164
+ async function submitChildJob(body: { op: ChildOp; linkIds: string[] | "all"; restart?: "app-server" | "codex"; ignoreActivity?: true }, wait: boolean,
165
+ deps: LinkCheckDeps, request: LinkRequest): Promise<number> {
166
+ let job: ChildJob;
167
+ try {
168
+ job = readJob(await request<unknown>("/api/link/children/operations", {
169
+ method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body),
170
+ }, deps));
171
+ } catch (error) { childOpsRefusal(error, body.op); }
172
+ if (!wait) {
173
+ console.log(JSON.stringify(job));
174
+ return job.state === "done" ? linkCheckExitCode(job) : 0;
175
+ }
176
+ const waited = await waitForChildJob(job, deps, request);
177
+ console.log(JSON.stringify(waited.job));
178
+ if (!waited.done) {
179
+ console.error(`Error: job_still_running: ${waited.job.jobId} has not finished; read it again with GET /api/link/children/jobs/${waited.job.jobId}.`);
180
+ return 1;
181
+ }
182
+ return linkCheckExitCode(waited.job);
183
+ }
184
+
185
+ /** `ocx link check (--link-id <id> | --all) [--no-wait] [--json]`: run the observe operation and return the exit code. */
186
+ export async function runLinkCheck(args: string[], deps: LinkCheckDeps, request: LinkRequest, usage: string): Promise<number> {
187
+ takeJsonFlag(args);
188
+ const all = takeFlag(args, "--all");
189
+ const noWait = takeFlag(args, "--no-wait");
190
+ const linkIds: string[] = [];
191
+ for (let id = takeOption(args, "--link-id"); id !== undefined; id = takeOption(args, "--link-id")) {
192
+ if (!LINK_ID.test(id)) throw new CliUsageError("check requires valid --link-id values", usage);
193
+ if (!linkIds.includes(id)) linkIds.push(id);
194
+ }
195
+ rejectArgs(args, usage);
196
+ if (all === (linkIds.length > 0)) throw new CliUsageError("check requires --link-id <id> or --all, not both", usage);
197
+ if (linkIds.length > 64) throw new CliUsageError("check accepts at most 64 --link-id values", usage);
198
+ return submitChildJob({ op: "observe", linkIds: all ? "all" : linkIds }, !noWait, deps, request);
199
+ }
200
+
201
+ export function parseChildOpArgs(verb: LinkChildVerb, args: string[], usage: string):
202
+ { body: { op: LinkChildVerb; linkIds: string[] | "all"; restart?: "app-server" | "codex"; ignoreActivity?: true }; wait: boolean } {
203
+ takeJsonFlag(args);
204
+ const noWait = takeFlag(args, "--no-wait");
205
+ const all = takeFlag(args, "--all");
206
+ const yes = takeFlag(args, "--yes");
207
+ // D8: the operator's explicit restart past activity; it ends running work on that Child.
208
+ const ignoreActivity = takeFlag(args, "--ignore-activity");
209
+ // Repeatable like ocx link check; a restart needs exactly one.
210
+ const linkIds: string[] = [];
211
+ for (let id = takeOption(args, "--link-id"); id !== undefined; id = takeOption(args, "--link-id")) {
212
+ if (!LINK_ID.test(id)) throw new CliUsageError(`${verb} requires valid --link-id values`, usage);
213
+ if (!linkIds.includes(id)) linkIds.push(id);
214
+ }
215
+ let restart: "app-server" | "codex" | undefined;
216
+ if (verb === "sync") {
217
+ const narrow = takeFlag(args, "--restart-app-server-only");
218
+ const full = takeFlag(args, "--restart-codex");
219
+ if (narrow && full) throw new CliUsageError("choose one of --restart-app-server-only and --restart-codex", usage);
220
+ restart = narrow ? "app-server" : full ? "codex" : undefined;
221
+ }
222
+ if (verb === "restart-codex") {
223
+ const scope = takeOption(args, "--scope") ?? "app-server";
224
+ if (scope !== "app-server" && scope !== "codex") throw new CliUsageError("--scope must be app-server or codex", usage);
225
+ if (!yes) throw new CliUsageError("restart-codex ends running Codex turns on the Child; pass --yes", usage);
226
+ restart = scope;
227
+ }
228
+ rejectArgs(args, usage);
229
+ if (all === (linkIds.length > 0)) throw new CliUsageError(`${verb} requires --link-id <id> or --all, not both`, usage);
230
+ if (linkIds.length > 64) throw new CliUsageError(`${verb} accepts at most 64 --link-id values`, usage);
231
+ // Revision 6 F5: an update stops the Child's runtime and ends the turns relayed for it, so it is confirmed like a restart.
232
+ if (verb === "update" && !yes) throw new CliUsageError("update restarts OpenCodex on each Child and ends its running turns; pass --yes", usage);
233
+ // A2 / M8: a restart names one link, and the codex scope (quit and relaunch the desktop app) needs --yes on every verb.
234
+ if (restart !== undefined && (all || linkIds.length !== 1)) throw new CliUsageError(`${verb} with a restart needs exactly one --link-id; --all is refused`, usage);
235
+ if (restart === "codex" && !yes) throw new CliUsageError("--restart-codex quits the Child's Codex app and ends its turns; pass --yes", usage);
236
+ if (yes && restart === undefined && verb !== "update") throw new CliUsageError("--yes only confirms a restart or an update", usage);
237
+ if (ignoreActivity && restart === undefined) throw new CliUsageError("--ignore-activity applies only to a restart of one --link-id", usage);
238
+ return { body: { op: verb, linkIds: all ? "all" : linkIds, ...(restart ? { restart } : {}), ...(ignoreActivity ? { ignoreActivity: true as const } : {}) }, wait: !noWait };
239
+ }
240
+
241
+ /** `ocx link update|sync|restart-codex`: one job over the link's pinned SSH trust; prints it and returns the verdict exit. */
242
+ export async function runLinkChildOp(verb: LinkChildVerb, args: string[], deps: LinkCheckDeps, request: LinkRequest, usage: string): Promise<number> {
243
+ const parsed = parseChildOpArgs(verb, args, usage);
244
+ return submitChildJob(parsed.body, parsed.wait, deps, request);
245
+ }
246
+
247
+ /** Exactly {policy: {four knobs}, warning}; anything else is an invalid response (strict, like the policy file). */
248
+ export function validatePolicyRead(value: unknown): ChildPolicyRead {
249
+ const fail = (): never => { throw new Error("invalid link API response: child policy"); };
250
+ if (!isRecord(value) || Object.keys(value).length !== 2 || !isRecord(value.policy)) return fail();
251
+ const { policy, warning } = value;
252
+ if (warning !== null && warning !== "policy-file-invalid") return fail();
253
+ const keys = Object.keys(policy);
254
+ if (keys.length !== 4 || !(CATALOG_FANOUT as readonly unknown[]).includes(policy.catalogFanout)
255
+ || !(CHILD_CODEX_RESTART as readonly unknown[]).includes(policy.childCodexRestart) || !(CHILD_UPDATES as readonly unknown[]).includes(policy.updates)
256
+ || typeof policy.idleAfterMs !== "number" || !Number.isSafeInteger(policy.idleAfterMs) || policy.idleAfterMs <= 0) return fail();
257
+ return { policy: { catalogFanout: policy.catalogFanout, childCodexRestart: policy.childCodexRestart, updates: policy.updates,
258
+ idleAfterMs: policy.idleAfterMs } as ChildPolicyRead["policy"], warning: warning as ChildPolicyRead["warning"] };
259
+ }
260
+
261
+ /** `ocx link policy`: read the Home's Child policy, or change the knobs named by flags (one PUT of only those keys). */
262
+ export async function runLinkPolicy(args: string[], deps: LinkCliDeps, request: LinkRequest, usage: string): Promise<void> {
263
+ const json = takeJsonFlag(args);
264
+ const patch: Record<string, string | number> = {};
265
+ const pick = (flag: string, key: string, allowed: readonly string[]): void => {
266
+ const value = takeOption(args, flag);
267
+ if (value === undefined) return;
268
+ if (!allowed.includes(value)) throw new CliUsageError(`${flag} must be one of ${allowed.join(", ")}`, usage);
269
+ patch[key] = value;
270
+ };
271
+ pick("--updates", "updates", CHILD_UPDATES);
272
+ pick("--catalog-fanout", "catalogFanout", CATALOG_FANOUT);
273
+ pick("--child-codex-restart", "childCodexRestart", CHILD_CODEX_RESTART);
274
+ const minutes = takeIntegerOption(args, "--idle-after-minutes", { min: 1, max: 60 });
275
+ if (minutes !== undefined) patch.idleAfterMs = minutes * 60_000;
276
+ rejectArgs(args, usage);
277
+ let read: ChildPolicyRead;
278
+ try {
279
+ read = validatePolicyRead(Object.keys(patch).length === 0
280
+ ? await request<unknown>("/api/link/children/policy", {}, deps)
281
+ : await request<unknown>("/api/link/children/policy", { method: "PUT", headers: { "content-type": "application/json" }, body: JSON.stringify(patch) }, deps));
282
+ } catch (error) { childOpsRefusal(error, null); }
283
+ printData(read, json, [
284
+ `catalog fan-out: ${read.policy.catalogFanout}`, `Child Codex restart: ${read.policy.childCodexRestart}`,
285
+ `updates: ${read.policy.updates}`, `idle after: ${read.policy.idleAfterMs / 60_000} min`,
286
+ ...(read.warning ? ["The policy file is invalid; automatic catalog fan-out and updates are off. To turn them back on, pass --catalog-fanout auto and an --updates mode; a setting you do not name stays off."] : []),
287
+ ]);
288
+ }
289
+
290
+
291
+ /**
292
+ * `ocx link activity clear --link-id <id>` (D8): the operator forgets one link's WebSocket activity holds, including an
293
+ * unknown state left by a Home crash, so automatic and activity-gated Child restarts may run again. Never automatic.
294
+ */
295
+ export async function runLinkActivity(args: string[], deps: LinkCliDeps, request: LinkRequest, usage: string): Promise<void> {
296
+ const verb = args.shift();
297
+ if (verb !== "clear") throw new CliUsageError("link activity requires: clear --link-id <id>", usage);
298
+ const json = takeJsonFlag(args);
299
+ const linkId = takeOption(args, "--link-id");
300
+ if (!linkId || !LINK_ID.test(linkId)) throw new CliUsageError("link activity clear requires a valid --link-id", usage);
301
+ rejectArgs(args, usage);
302
+ let response: unknown;
303
+ try {
304
+ response = await request<unknown>("/api/link/children/activity/clear", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ linkId }) }, deps);
305
+ } catch (error) { childOpsRefusal(error, null); }
306
+ if (!isRecord(response) || response.linkId !== linkId || (response.cleared !== null && !isRecord(response.cleared))) throw new Error("invalid link API response: activity clear");
307
+ const cleared = response.cleared as { holds?: unknown; unknown?: unknown } | null;
308
+ const holds = cleared && Array.isArray(cleared.holds) ? cleared.holds.length : 0;
309
+ const unknown = cleared && typeof cleared.unknown === "string" ? cleared.unknown : null;
310
+ printData({ linkId, cleared }, json, [cleared === null
311
+ ? `Nothing held ${linkId}.`
312
+ : `Cleared ${holds} activity hold${holds === 1 ? "" : "s"}${unknown ? ` and the unknown state (${unknown})` : ""} on ${linkId}; automatic and activity-gated restarts of this Child may run again.`]);
313
+ }
314
+
@@ -1,6 +1,7 @@
1
1
  /** Read-only platform and disconnect guidance for recorded Remote Link Children. */
2
2
  import { linkKnownHostsPath, linkStorePath } from "../link/paths";
3
3
  import { requireRemotePlatform, type RemotePlatform } from "../link/remote-platform";
4
+ import type { ExplicitRoute } from "../link/explicit-route";
4
5
  import { createSshRunner, sshRunnerErrorHint, type SshRunner } from "../link/ssh-runner";
5
6
  import { readLinkStore, type LinkStore } from "../link/store";
6
7
  import { CliUsageError, printData, rejectArgs, takeJsonFlag, takeOption } from "./runtime-api";
@@ -24,15 +25,17 @@ export interface LinkCleanupEntry {
24
25
 
25
26
  export function windowsChildRecovery(linkId: string, alias: string): string[] {
26
27
  return [
27
- `On ${alias}, run 'ocx disconnect' and then 'ocx restart' so it stops using this link.`,
28
- `On this Home, run 'ocx link revoke --link-id ${linkId} --yes' to disconnect it through the recorded SSH trust.`,
28
+ // The bound disconnect (#8662) acts only while the machine is connected to this link; an older ocx refuses the flag before it
29
+ // acts on the link, and then the check comes first. The revoke runs as printed: --yes belongs to --force, which skips cleanup.
30
+ `On ${alias}, run 'ocx disconnect --expect-link ${linkId}' and, if it disconnected, 'ocx restart': it disconnects only while the machine is connected to this link. An OpenCodex older than that flag refuses it as a usage error before it acts on the link; then run 'ocx disconnect' and 'ocx restart' only if 'ocx connect status --json' shows this link's id, right after that check. If it shows another link, a hub or another Home, or its state cannot be read, leave it.`,
31
+ `On this Home, run 'ocx link revoke --link-id ${linkId}' to disconnect it through the recorded SSH trust; it disconnects only while the machine is connected to this link.`,
29
32
  `Retry Remote Link enrollment after updating Home if the remote shell or old installation cannot run the disconnect command.`,
30
33
  ];
31
34
  }
32
35
 
33
- async function checkPlatform(runner: SshRunner, alias: string, knownHostsFile: string): Promise<{ platform: RemotePlatform; reason: string | null }> {
36
+ async function checkPlatform(runner: SshRunner, alias: string, route: ExplicitRoute | null, knownHostsFile: string): Promise<{ platform: RemotePlatform; reason: string | null }> {
34
37
  try {
35
- const platform = await requireRemotePlatform(runner, alias, knownHostsFile);
38
+ const platform = await requireRemotePlatform(runner, alias, route, knownHostsFile);
36
39
  return { platform, reason: null };
37
40
  } catch (error) {
38
41
  return { platform: "unknown", reason: sshRunnerErrorHint(error) ?? "ssh could not run" };
@@ -69,7 +72,7 @@ export async function runLinkCleanup(args: string[], deps: LinkCleanupDeps, usag
69
72
  // One at a time: each check is a bounded SSH command, and order keeps the report stable.
70
73
  for (const record of records) {
71
74
  const checked = record.direction === "hub-initiated"
72
- ? await checkPlatform(runner, record.alias, knownHostsFile)
75
+ ? await checkPlatform(runner, record.alias, record.explicitRoute ?? null, knownHostsFile)
73
76
  : { platform: "not_checked" as const, reason: null };
74
77
  entries.push({
75
78
  linkId: record.id, alias: record.alias, direction: record.direction, ...checked,
@@ -0,0 +1,67 @@
1
+ import {
2
+ LINK_DIAGNOSTICS_DEFAULT_LIMIT, LINK_DIAGNOSTICS_MAX_LIMIT, LINK_DIAGNOSTICS_SCHEMA, linkDiagnosticsPath, readLinkDiagnostics,
3
+ type LinkDiagnosticEntry, type LinkDiagnosticsReadResult,
4
+ } from "../link/diagnostics-read";
5
+ import { CliUsageError, printData, rejectArgs, takeIntegerOption, takeJsonFlag, takeOption } from "./runtime-api";
6
+
7
+ export const LINK_DIAGNOSTICS_USAGE = "ocx link diagnostics [--limit <n>] [--since <iso-time|epoch-ms>] [--json]";
8
+
9
+ /** What --json prints: the reader's sanitized result plus the schema and the local path. */
10
+ export type LinkDiagnosticsDocument = { schema: typeof LINK_DIAGNOSTICS_SCHEMA; path: string } & LinkDiagnosticsReadResult;
11
+
12
+ function parseSince(raw: string | undefined, usage: string): number | undefined {
13
+ if (raw === undefined) return undefined;
14
+ const value = /^\d+$/.test(raw) ? Number(raw) : /^\d{4}-\d{2}-\d{2}/.test(raw) ? Date.parse(raw) : Number.NaN;
15
+ if (!Number.isSafeInteger(value) || value < 0) throw new CliUsageError("--since must be an ISO time or epoch milliseconds", usage);
16
+ return value;
17
+ }
18
+
19
+ const HEADER = ["TIME", "EVENT", "OUTCOME", "STATE", "ATTEMPT", "PORT"] as const;
20
+
21
+ function row(record: LinkDiagnosticEntry): string[] {
22
+ const state = record.previousState && record.state ? record.previousState + " -> " + record.state : record.state ?? "-";
23
+ return [
24
+ record.timestamp !== undefined ? new Date(record.timestamp).toISOString() : "-",
25
+ record.event,
26
+ record.suppressed ? record.outcome + " (+" + record.suppressed + " suppressed)" : record.outcome,
27
+ state,
28
+ record.attempt !== undefined ? String(record.attempt) : "-",
29
+ record.tunnelPort !== undefined ? String(record.tunnelPort) : "-",
30
+ ];
31
+ }
32
+
33
+ function table(records: readonly LinkDiagnosticEntry[]): string[] {
34
+ const cells = [[...HEADER], ...records.map(row)];
35
+ const widths = HEADER.map((_, column) => Math.max(...cells.map(cellsOfRow => cellsOfRow[column]!.length)));
36
+ return cells.map(cellsOfRow => cellsOfRow.map((cell, column) => cell.padEnd(widths[column]!)).join(" ").trimEnd());
37
+ }
38
+
39
+ function humanLines(document: LinkDiagnosticsDocument): string[] {
40
+ const { files, records, matched, skipped, path } = document;
41
+ const lines: string[] = [];
42
+ if (files.every(file => file.state === "absent")) return ["No Remote Link diagnostics recorded yet: " + path];
43
+ if (records.length === 0) lines.push("No matching Remote Link diagnostics in " + path);
44
+ else lines.push(...table(records), "", "Showing " + records.length + " of " + matched + " records from " + path);
45
+ for (const file of files) {
46
+ if (file.state === "refused") lines.push(file.name + " was not read: it is not a regular file in a regular link directory.");
47
+ else if (file.state === "unreadable") lines.push(file.name + " could not be read.");
48
+ else if (file.truncated) lines.push(file.name + " is larger than 256 KiB; only its newest 256 KiB were read.");
49
+ }
50
+ if (skipped > 0) lines.push(skipped + " unreadable or unrecognized line" + (skipped === 1 ? " was" : "s were") + " skipped.");
51
+ return lines;
52
+ }
53
+
54
+ /**
55
+ * `ocx link diagnostics`: read this computer's bounded link diagnostics file directly. It never
56
+ * contacts the proxy, loads the config, creates or hardens a directory, or writes anything.
57
+ */
58
+ export async function runLinkDiagnostics(args: string[], deps: { linkConfigDir?: string }, usage: string): Promise<void> {
59
+ const wantsJson = takeJsonFlag(args);
60
+ const limit = takeIntegerOption(args, "--limit", { min: 1, max: LINK_DIAGNOSTICS_MAX_LIMIT }) ?? LINK_DIAGNOSTICS_DEFAULT_LIMIT;
61
+ const since = parseSince(takeOption(args, "--since"), usage);
62
+ rejectArgs(args, usage);
63
+ const result = await readLinkDiagnostics({ configDir: deps.linkConfigDir, limit, since });
64
+ const document: LinkDiagnosticsDocument = { schema: LINK_DIAGNOSTICS_SCHEMA, path: linkDiagnosticsPath(deps.linkConfigDir), ...result };
65
+ // The human lines are built only when shown, so nothing in them can fail a --json read.
66
+ printData(document, wantsJson, wantsJson ? [] : humanLines(document));
67
+ }