@bitkyc08/opencodex 2.100.2 → 2.100.4

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 (644) hide show
  1. package/AGENTS_INSTALL.md +23 -1
  2. package/README.md +1 -1
  3. package/bin/ocx.mjs +40 -19
  4. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  5. package/gui/dist/assets/App-DcpyI78f.js +60 -0
  6. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-CzjPJprT.js} +1 -1
  7. package/gui/dist/assets/brand-mark-BTIi7e69.js +1 -0
  8. package/gui/dist/assets/index-DJxM-imn.css +2 -0
  9. package/gui/dist/assets/index-DVgU6S3y.js +138 -0
  10. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-Bn6Y-g3R.js} +1 -1
  11. package/gui/dist/classic/assets/App-eYJAyNHM.js +59 -0
  12. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-xHMYxLkV.js} +1 -1
  13. package/gui/dist/classic/assets/index-DSaVRW4F.js +138 -0
  14. package/gui/dist/classic/assets/quota-summary-DyzHlkFl.js +1 -0
  15. package/gui/dist/classic/index.html +1 -1
  16. package/gui/dist/index.html +2 -2
  17. package/native/ocx-child/Cargo.toml +9 -0
  18. package/native/ocx-child/src/cli.rs +404 -20
  19. package/native/ocx-child/src/codex_home.rs +99 -14
  20. package/native/ocx-child/src/daemon.rs +2 -1
  21. package/native/ocx-child/src/lib.rs +3 -0
  22. package/native/ocx-child/src/link_ws.rs +2598 -0
  23. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  24. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  25. package/native/ocx-child/src/parity.rs +5 -1
  26. package/native/ocx-child/src/platform.rs +152 -6
  27. package/native/ocx-child/src/relay.rs +150 -19
  28. package/package.json +3 -3
  29. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  30. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  31. package/src/adapters/anthropic/client-identity.ts +3 -1
  32. package/src/adapters/anthropic/passthrough.ts +9 -3
  33. package/src/adapters/anthropic/per-message-effort.ts +296 -0
  34. package/src/adapters/anthropic.ts +34 -14
  35. package/src/adapters/claude-cli/adapter.ts +1 -0
  36. package/src/adapters/client-fingerprint.ts +3 -3
  37. package/src/adapters/cursor/discovery.ts +17 -0
  38. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  39. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  40. package/src/adapters/cursor/protobuf-request.ts +8 -8
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/chat.ts +71 -14
  43. package/src/adapters/google-antigravity-wire.ts +7 -5
  44. package/src/adapters/google-errors.ts +14 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +9 -2
  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/qoder/adapter.ts +9 -1
  54. package/src/adapters/zed.ts +7 -2
  55. package/src/advisor/consult.ts +15 -4
  56. package/src/advisor/context.ts +12 -3
  57. package/src/advisor/runtime.ts +35 -5
  58. package/src/advisor/settings.ts +8 -0
  59. package/src/advisor/synthetic-tool.ts +21 -8
  60. package/src/bridge/response-json.ts +11 -2
  61. package/src/bridge/sse.ts +43 -8
  62. package/src/claude/auth-detect.ts +21 -33
  63. package/src/claude/desktop-3p.ts +11 -5
  64. package/src/claude/desktop-gateway-state.ts +2 -0
  65. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  66. package/src/claude/desktop-remote-store.ts +82 -12
  67. package/src/claude/inbound-content-options.ts +31 -16
  68. package/src/claude/outbound.ts +13 -3
  69. package/src/cli/account-api.ts +21 -1
  70. package/src/cli/account-auth.ts +83 -22
  71. package/src/cli/account-extended.ts +33 -2
  72. package/src/cli/account-key-quota.ts +34 -5
  73. package/src/cli/account.ts +4 -2
  74. package/src/cli/advisor.ts +7 -4
  75. package/src/cli/alias.ts +38 -1
  76. package/src/cli/capabilities-access-remote.ts +128 -3
  77. package/src/cli/capabilities-accounts.ts +6 -6
  78. package/src/cli/capabilities-agents-routing.ts +17 -10
  79. package/src/cli/capabilities-base.ts +49 -19
  80. package/src/cli/capabilities-integrations.ts +2 -2
  81. package/src/cli/capabilities-observe-system.ts +2 -2
  82. package/src/cli/capabilities-provider-models.ts +18 -2
  83. package/src/cli/capabilities-route-to.ts +43 -0
  84. package/src/cli/capabilities.ts +2 -0
  85. package/src/cli/capability-contracts.ts +1 -1
  86. package/src/cli/claude-desktop.ts +30 -11
  87. package/src/cli/claude.ts +17 -3
  88. package/src/cli/codex-launcher.ts +3 -1
  89. package/src/cli/codex-shim-autorestore.ts +5 -42
  90. package/src/cli/config-command.ts +14 -1
  91. package/src/cli/config-root-startup.ts +34 -0
  92. package/src/cli/connect.ts +88 -16
  93. package/src/cli/desktop-runtime-guidance.ts +1 -1
  94. package/src/cli/disconnect-runtime.ts +178 -0
  95. package/src/cli/dispatch.ts +61 -13
  96. package/src/cli/export-command.ts +1 -1
  97. package/src/cli/gui-pair-client.ts +6 -3
  98. package/src/cli/gui.ts +10 -5
  99. package/src/cli/help-catalog.ts +11 -0
  100. package/src/cli/help.ts +4 -3
  101. package/src/cli/index.ts +85 -94
  102. package/src/cli/inspect.ts +11 -2
  103. package/src/cli/integrations.ts +26 -1
  104. package/src/cli/link-apply-restart.ts +4 -2
  105. package/src/cli/link-capture.ts +64 -0
  106. package/src/cli/link-child-ops.ts +218 -40
  107. package/src/cli/link-cleanup.ts +8 -5
  108. package/src/cli/link-diagnostics.ts +67 -0
  109. package/src/cli/link-enrollment.ts +158 -12
  110. package/src/cli/link-operations.ts +52 -0
  111. package/src/cli/link-recover.ts +152 -0
  112. package/src/cli/link-routes.ts +90 -0
  113. package/src/cli/link-status-child.ts +44 -1
  114. package/src/cli/link-status-traffic.ts +34 -0
  115. package/src/cli/link.ts +315 -37
  116. package/src/cli/message-command.ts +1 -1
  117. package/src/cli/message-mcp-command.ts +23 -10
  118. package/src/cli/models-runtime.ts +3 -3
  119. package/src/cli/opencode.ts +3 -1
  120. package/src/cli/pi-sync.ts +35 -0
  121. package/src/cli/preflight-exemptions.ts +49 -0
  122. package/src/cli/registry.ts +33 -14
  123. package/src/cli/resolve.ts +23 -8
  124. package/src/cli/restart-failure.ts +15 -2
  125. package/src/cli/root.ts +5 -1
  126. package/src/cli/route-to.ts +172 -0
  127. package/src/cli/runtime-api.ts +9 -8
  128. package/src/cli/status.ts +7 -2
  129. package/src/cli/stop-approval.ts +66 -19
  130. package/src/cli/stop-report.ts +23 -0
  131. package/src/cli/stop-windows-checked.ts +304 -0
  132. package/src/cli/sync-command.ts +70 -15
  133. package/src/cli/sync-fanout.ts +74 -19
  134. package/src/cli/sync-flags.ts +40 -3
  135. package/src/cli/sync-link-status.ts +18 -2
  136. package/src/cli/sync-update-guard.ts +7 -2
  137. package/src/cli/system-command.ts +1 -1
  138. package/src/cli/system-restart-client.ts +10 -3
  139. package/src/cli/system-settings-parity.ts +2 -1
  140. package/src/cli/uninstall-plan.ts +77 -5
  141. package/src/cli/uninstall-stop.ts +152 -0
  142. package/src/cli/v2-input.ts +10 -6
  143. package/src/cli/v2-local-output.ts +3 -2
  144. package/src/cli/v2-runtime.ts +10 -3
  145. package/src/cli/v2.ts +22 -7
  146. package/src/client/connect.ts +376 -35
  147. package/src/client/desktop-refusal.ts +38 -0
  148. package/src/client/lifecycle-lock.ts +29 -4
  149. package/src/client/link-home-features.ts +27 -0
  150. package/src/client/link-home.ts +92 -4
  151. package/src/client/link-ingress.ts +21 -3
  152. package/src/client/link-join.ts +12 -2
  153. package/src/client/link-parity-reporter.ts +60 -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.ts +56 -5
  161. package/src/client/link-websocket-limits.ts +89 -0
  162. package/src/client/link-websocket.ts +586 -0
  163. package/src/client/link-ws-advertisement.ts +100 -0
  164. package/src/client/link-ws-framer.ts +241 -0
  165. package/src/client/link-ws-transport.ts +177 -0
  166. package/src/client/machine-api.ts +13 -2
  167. package/src/client/machine-listener.ts +48 -7
  168. package/src/client/route-intent-apply.ts +293 -0
  169. package/src/client/route-intent-file-originals.ts +97 -0
  170. package/src/client/route-intent-native-originals.ts +201 -0
  171. package/src/client/route-intent-watch.ts +141 -0
  172. package/src/client/runtime-restart.ts +141 -7
  173. package/src/client/runtime.ts +63 -15
  174. package/src/client/state.ts +44 -0
  175. package/src/client/sync-expectation.ts +36 -2
  176. package/src/client/sync-runtime.ts +7 -0
  177. package/src/clients/config-export/alias-selectors.ts +63 -40
  178. package/src/clients/config-export/contracts.ts +2 -0
  179. package/src/clients/config-export/nested-selectors.ts +42 -0
  180. package/src/clients/config-export.ts +22 -3
  181. package/src/codex/account-pause.ts +4 -0
  182. package/src/codex/account-runtime-state.ts +4 -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/main-account-probe.ts +3 -1
  187. package/src/codex/auth-api/main-hard-lock-refusal-read.ts +172 -0
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +61 -8
  190. package/src/codex/catalog/build-entries.ts +10 -0
  191. package/src/codex/catalog/derive-entry.ts +7 -0
  192. package/src/codex/catalog/gather-capture.ts +8 -2
  193. package/src/codex/catalog/parsing.ts +7 -3
  194. package/src/codex/catalog/provider-models.ts +54 -15
  195. package/src/codex/catalog/reserve-warn.ts +7 -5
  196. package/src/codex/catalog/reserve.ts +4 -3
  197. package/src/codex/catalog/retained-sync.ts +4 -1
  198. package/src/codex/catalog/routed-defaults.ts +35 -0
  199. package/src/codex/catalog/routed-gather.ts +1 -1
  200. package/src/codex/catalog-auto-refresh.ts +11 -0
  201. package/src/codex/cli-update-job.ts +35 -13
  202. package/src/codex/convergence.ts +4 -2
  203. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  204. package/src/codex/features.ts +2 -2
  205. package/src/codex/history-provider.ts +31 -0
  206. package/src/codex/inject/multi-agent-v2.ts +9 -3
  207. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  208. package/src/codex/inject/plan.ts +20 -2
  209. package/src/codex/inject.ts +2 -0
  210. package/src/codex/journal-config-restore.ts +217 -0
  211. package/src/codex/journal.ts +75 -6
  212. package/src/codex/loopback-target.ts +22 -8
  213. package/src/codex/main-account.ts +109 -57
  214. package/src/codex/native-main-auth-file.ts +118 -0
  215. package/src/codex/native-main-credentials.ts +270 -0
  216. package/src/codex/native-main-owner.ts +3 -0
  217. package/src/codex/native-main-refresh-mode.ts +14 -1
  218. package/src/codex/native-profile-manager.ts +4 -3
  219. package/src/codex/native-profile-store.ts +3 -61
  220. package/src/codex/orca-import.ts +10 -1
  221. package/src/codex/quota-history.ts +13 -0
  222. package/src/codex/quota-window-conflict.ts +103 -0
  223. package/src/codex/quota.ts +86 -15
  224. package/src/codex/subagent-model-fallback.ts +3 -1
  225. package/src/codex/websocket-activity.ts +171 -16
  226. package/src/codex/websocket-registry.ts +11 -4
  227. package/src/combos/cooldown-store.ts +25 -5
  228. package/src/combos/failover.ts +342 -3
  229. package/src/combos/index.ts +5 -0
  230. package/src/combos/resolve.ts +115 -19
  231. package/src/config/dashboard-trusted-proxy.ts +83 -0
  232. package/src/config/diagnostics.ts +31 -0
  233. package/src/config/feature-flags.ts +9 -0
  234. package/src/config/live-reconcile.ts +16 -4
  235. package/src/config/load-degrade.ts +14 -1
  236. package/src/config/multi-agent-surface.ts +28 -5
  237. package/src/config/pending-teardown.ts +60 -3
  238. package/src/config/persisted-mutation.ts +2 -2
  239. package/src/config/persisted-projections.ts +18 -0
  240. package/src/config/process-state.ts +176 -4
  241. package/src/config/provider-validation.ts +4 -4
  242. package/src/config/reserve-capability.ts +96 -0
  243. package/src/config/schema/config-schema.ts +12 -0
  244. package/src/config/schema/leaf-validators.ts +11 -2
  245. package/src/config/schema/routed-catalog-defaults.ts +49 -0
  246. package/src/config/windows-process-command-line.ts +107 -0
  247. package/src/config.ts +7 -7
  248. package/src/desktop-update/acquire.ts +202 -0
  249. package/src/desktop-update/cli.ts +168 -0
  250. package/src/desktop-update/drain.ts +40 -0
  251. package/src/desktop-update/headless.ts +285 -0
  252. package/src/desktop-update/image.ts +85 -0
  253. package/src/desktop-update/install.ts +53 -0
  254. package/src/desktop-update/msi.ts +72 -0
  255. package/src/desktop-update/release.ts +128 -0
  256. package/src/desktop-update/runtime.ts +155 -0
  257. package/src/desktop-update/staging.ts +118 -0
  258. package/src/desktop-update/trust.ts +45 -0
  259. package/src/generated/compatibility-version.json +1114 -442
  260. package/src/generated/model-metadata.ts +1 -1
  261. package/src/images/fulfill-video.ts +3 -3
  262. package/src/images/loop.ts +9 -2
  263. package/src/images/plan.ts +147 -11
  264. package/src/images/types.ts +13 -4
  265. package/src/images/xai-video-client.ts +72 -10
  266. package/src/integrations/model-name-guard.ts +25 -0
  267. package/src/integrations/route-intent-catalog.ts +26 -0
  268. package/src/integrations/route-intent-connected.ts +262 -0
  269. package/src/integrations/route-intent-contract.ts +55 -0
  270. package/src/integrations/route-intent-disconnect.ts +109 -0
  271. package/src/integrations/route-intent-initial.ts +64 -0
  272. package/src/integrations/route-intent-state.ts +117 -0
  273. package/src/integrations/route-intent-tick.ts +65 -0
  274. package/src/integrations/route-intent.ts +212 -0
  275. package/src/integrations/writer.ts +44 -11
  276. package/src/lib/client-retry-after.ts +29 -0
  277. package/src/lib/config-ownership.ts +13 -0
  278. package/src/lib/desktop-gui-origin.ts +28 -0
  279. package/src/lib/errors.ts +1 -1
  280. package/src/lib/gcp-adc.ts +48 -4
  281. package/src/lib/gui-pair-capability.ts +2 -1
  282. package/src/lib/messages-error-body.ts +4 -1
  283. package/src/lib/offline-resend.ts +150 -0
  284. package/src/lib/outbound-credential-registry.ts +362 -4
  285. package/src/lib/paced-stream.ts +34 -0
  286. package/src/lib/passive-key-fetch-proof.ts +30 -0
  287. package/src/lib/passive-read.ts +5 -0
  288. package/src/lib/process-control.ts +76 -12
  289. package/src/lib/provider-outbound.ts +17 -6
  290. package/src/lib/redact.ts +84 -8
  291. package/src/lib/request-failure-model.ts +2 -0
  292. package/src/lib/response-body-inactivity.ts +23 -1
  293. package/src/lib/state-store-registrations.ts +11 -0
  294. package/src/lib/state-store-sweeper.ts +4 -0
  295. package/src/lib/supervisor-markers.ts +18 -0
  296. package/src/lib/terminal-safe-text.ts +58 -0
  297. package/src/lib/translator-budget.ts +3 -2
  298. package/src/lib/upstream-retry.ts +52 -9
  299. package/src/link/alias-lock.ts +119 -0
  300. package/src/link/child-activity.ts +28 -2
  301. package/src/link/child-binary-cache-fill.d.mts +50 -0
  302. package/src/link/child-binary-cache-fill.mjs +494 -0
  303. package/src/link/child-binary-cache-start.ts +73 -0
  304. package/src/link/child-binary-source.ts +12 -5
  305. package/src/link/child-gated-ocx.ts +29 -11
  306. package/src/link/child-observations.ts +2 -1
  307. package/src/link/child-observe.ts +2 -2
  308. package/src/link/child-ops-engine.ts +159 -91
  309. package/src/link/child-ops-host.ts +138 -0
  310. package/src/link/child-ops-runners.ts +319 -0
  311. package/src/link/child-ops-scheduler.ts +207 -0
  312. package/src/link/child-ops-types.ts +89 -0
  313. package/src/link/child-parity.ts +23 -4
  314. package/src/link/child-policy.ts +93 -0
  315. package/src/link/child-update-contract.ts +12 -3
  316. package/src/link/codex-settings.ts +1 -1
  317. package/src/link/compatibility.ts +18 -1
  318. package/src/link/diagnostics-read.ts +163 -0
  319. package/src/link/diagnostics.ts +20 -7
  320. package/src/link/explicit-route.ts +209 -0
  321. package/src/link/link-recover.ts +113 -0
  322. package/src/link/management-routes.ts +3 -1
  323. package/src/link/operation-recovery-slot.ts +44 -0
  324. package/src/link/operations-journal.ts +408 -0
  325. package/src/link/peer-report.ts +1 -1
  326. package/src/link/relay-auth.ts +14 -0
  327. package/src/link/remote-plant.ts +152 -14
  328. package/src/link/remote-platform.ts +21 -10
  329. package/src/link/remote-probe.ts +11 -3
  330. package/src/link/remote-windows.ts +124 -36
  331. package/src/link/request-compression.ts +30 -0
  332. package/src/link/residual-recovery.ts +66 -0
  333. package/src/link/retirement.ts +128 -0
  334. package/src/link/route-intent-watch.ts +41 -0
  335. package/src/link/route-intent.ts +209 -0
  336. package/src/link/route-proof.ts +82 -0
  337. package/src/link/route-rounds.ts +579 -0
  338. package/src/link/route-select.ts +95 -0
  339. package/src/link/route-trust.ts +96 -0
  340. package/src/link/ssh-argv.ts +172 -24
  341. package/src/link/ssh-capture-redact.ts +253 -0
  342. package/src/link/ssh-capture.ts +497 -0
  343. package/src/link/ssh-runner.ts +141 -14
  344. package/src/link/status-projection.ts +87 -0
  345. package/src/link/store.ts +54 -1
  346. package/src/link/supervisor.ts +543 -55
  347. package/src/link/sync-fanout-classify.ts +16 -0
  348. package/src/link/sync-then-restart.ts +65 -0
  349. package/src/link/tombstones.ts +209 -0
  350. package/src/link/traffic.ts +178 -0
  351. package/src/link/ws-activity-holds.ts +474 -0
  352. package/src/local-credentials/publication-fence.ts +20 -1
  353. package/src/messaging/budget.ts +23 -5
  354. package/src/messaging/mcp-queue-rpc.ts +1 -1
  355. package/src/messaging/mcp-queue-server.ts +16 -1
  356. package/src/messaging/mcp-resume-tools.ts +25 -0
  357. package/src/messaging/remote-enrollment.ts +3 -3
  358. package/src/messaging/remote-tunnels.ts +2 -2
  359. package/src/messaging/resume-permissions.ts +27 -0
  360. package/src/messaging/rpc.ts +50 -6
  361. package/src/oauth/anthropic-continuity.ts +23 -7
  362. package/src/oauth/anthropic-routing.ts +5 -2
  363. package/src/oauth/anthropic.ts +22 -2
  364. package/src/oauth/antigravity-risk.ts +126 -0
  365. package/src/oauth/claude-keychain-read.ts +78 -68
  366. package/src/oauth/generic-account-failover.ts +89 -18
  367. package/src/oauth/generic-session-affinity.ts +10 -3
  368. package/src/oauth/index.ts +24 -6
  369. package/src/oauth/local-token-detect.ts +8 -29
  370. package/src/oauth/login-cli-errors.ts +5 -1
  371. package/src/oauth/login-cli.ts +68 -19
  372. package/src/oauth/login-flow-state.ts +26 -3
  373. package/src/oauth/meta-muse.ts +1 -1
  374. package/src/oauth/pool-kernel.ts +3 -3
  375. package/src/oauth/store.ts +7 -0
  376. package/src/oauth/xai.ts +248 -14
  377. package/src/protocols/contract.ts +4 -0
  378. package/src/protocols/encoders/messages.ts +1 -0
  379. package/src/providers/alias-template.ts +48 -0
  380. package/src/providers/anthropic-billing-ownership.ts +2 -0
  381. package/src/providers/anthropic-billing-refusal.ts +27 -3
  382. package/src/providers/anthropic-output-caps.ts +46 -0
  383. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  384. package/src/providers/antigravity-effort-families.ts +11 -3
  385. package/src/providers/antigravity-models.ts +32 -9
  386. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  387. package/src/providers/api-key-pause.ts +3 -0
  388. package/src/providers/api-key-resolve.ts +49 -7
  389. package/src/providers/api-key-response-ownership.ts +2 -0
  390. package/src/providers/api-key-selection.ts +51 -9
  391. package/src/providers/api-keys.ts +6 -2
  392. package/src/providers/cache-affinity-identity.ts +73 -0
  393. package/src/providers/cache-affinity.ts +256 -0
  394. package/src/providers/default-aliases.ts +98 -20
  395. package/src/providers/google-vertex-model-discovery.ts +515 -0
  396. package/src/providers/key-failover.ts +123 -8
  397. package/src/providers/key-store.ts +3 -3
  398. package/src/providers/kiro-models.ts +3 -5
  399. package/src/providers/label.ts +31 -5
  400. package/src/providers/mistral-transport.ts +17 -4
  401. package/src/providers/model-rename-fields.ts +5 -0
  402. package/src/providers/muse-key-quota.ts +14 -6
  403. package/src/providers/new-model-policy-runtime.ts +17 -4
  404. package/src/providers/new-model-policy.ts +30 -4
  405. package/src/providers/passive-key-observation.ts +252 -0
  406. package/src/providers/quota/account-cache.ts +2 -1
  407. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  408. package/src/providers/quota/passive-key-limits.ts +272 -0
  409. package/src/providers/quota/passive-wire-model.ts +126 -0
  410. package/src/providers/quota/report-cache.ts +61 -2
  411. package/src/providers/quota/workbuddy.ts +6 -2
  412. package/src/providers/quota-key-accounts.ts +11 -6
  413. package/src/providers/quota-types.ts +18 -0
  414. package/src/providers/quota.ts +11 -12
  415. package/src/providers/registry/entries-core.ts +34 -16
  416. package/src/providers/registry/entries-extended.ts +32 -0
  417. package/src/providers/registry/model-seeds.ts +35 -0
  418. package/src/providers/resolved-model-policy.ts +7 -0
  419. package/src/providers/routed-config.ts +8 -3
  420. package/src/providers/workbuddy-credit-balance.ts +125 -16
  421. package/src/providers/xai-transport.ts +3 -0
  422. package/src/remote/features.ts +17 -0
  423. package/src/responses/anthropic-progress.ts +10 -4
  424. package/src/responses/citation-markers.ts +231 -0
  425. package/src/responses/effort-history.ts +732 -0
  426. package/src/responses/spill-store.ts +5 -1
  427. package/src/responses/state/replay-input.ts +50 -0
  428. package/src/responses/state/replay-owner.ts +24 -0
  429. package/src/responses/state/snapshot-codec.ts +9 -0
  430. package/src/responses/state/spill-queue.ts +1 -0
  431. package/src/responses/state.ts +42 -60
  432. package/src/router.ts +2 -2
  433. package/src/routing/history/integrity.ts +41 -4
  434. package/src/routing/home-route-capture.ts +123 -0
  435. package/src/routing/home-route-intent.ts +200 -0
  436. package/src/routing/route-intent-state.ts +178 -0
  437. package/src/routing/route-to-live-settings.ts +35 -0
  438. package/src/routing/route-to-local.ts +145 -0
  439. package/src/routing/route-to-status.ts +94 -0
  440. package/src/routing/route-to-sync-child.ts +32 -0
  441. package/src/server/adapter-resolve.ts +21 -1
  442. package/src/server/admitted-http-turn.ts +3 -0
  443. package/src/server/auth-cors.ts +111 -3
  444. package/src/server/bare-upstream-error.ts +220 -0
  445. package/src/server/chat-native.ts +14 -5
  446. package/src/server/claude-messages.ts +6 -4
  447. package/src/server/codex-model-list.ts +4 -2
  448. package/src/server/configured-credentials.ts +37 -5
  449. package/src/server/direct-local-http.ts +26 -3
  450. package/src/server/gui-desktop-authorization.ts +36 -0
  451. package/src/server/gui-pair-delivery.ts +6 -3
  452. package/src/server/gui-session.ts +10 -1
  453. package/src/server/inbound-body-admission.ts +17 -4
  454. package/src/server/index/link-listener.ts +196 -12
  455. package/src/server/index/link-management.ts +15 -1
  456. package/src/server/index/link-relay-sessions.ts +87 -8
  457. package/src/server/index/link-websocket-limits.ts +136 -0
  458. package/src/server/index/link-websocket.ts +692 -0
  459. package/src/server/index/optional-listeners.ts +97 -7
  460. package/src/server/index/route-intent-watch.ts +47 -0
  461. package/src/server/index/serve-contract.ts +86 -0
  462. package/src/server/index/serve-options.ts +36 -86
  463. package/src/server/index/startup-warnings.ts +8 -2
  464. package/src/server/index/websocket-handler.ts +26 -4
  465. package/src/server/index.ts +15 -4
  466. package/src/server/inference/client-encoder-delivery.ts +2 -0
  467. package/src/server/inspection-tee.ts +39 -2
  468. package/src/server/lifecycle.ts +2 -0
  469. package/src/server/link-turn.ts +149 -0
  470. package/src/server/management/advisor-routes.ts +10 -2
  471. package/src/server/management/agent-settings-routes.ts +50 -16
  472. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  473. package/src/server/management/config-routes.ts +39 -3
  474. package/src/server/management/context.ts +9 -2
  475. package/src/server/management/desktop-authorization.ts +41 -0
  476. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  477. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  478. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  479. package/src/server/management/home-integration-decision.ts +89 -0
  480. package/src/server/management/integration-routes.ts +208 -81
  481. package/src/server/management/link-child-ops-routes.ts +145 -43
  482. package/src/server/management/link-child-preflight.ts +31 -0
  483. package/src/server/management/link-diagnostics-route.ts +29 -0
  484. package/src/server/management/link-enrollment.ts +199 -47
  485. package/src/server/management/link-operation.ts +609 -0
  486. package/src/server/management/link-recover-route.ts +103 -0
  487. package/src/server/management/link-route-edit.ts +192 -0
  488. package/src/server/management/link-route-request.ts +62 -0
  489. package/src/server/management/link-route-state.ts +83 -7
  490. package/src/server/management/link-routes.ts +553 -51
  491. package/src/server/management/link-traffic-status.ts +13 -0
  492. package/src/server/management/model-routes.ts +122 -36
  493. package/src/server/management/model-rows.ts +2 -1
  494. package/src/server/management/native-integration-routes.ts +176 -70
  495. package/src/server/management/oauth-account-routes.ts +58 -18
  496. package/src/server/management/protocol-routes.ts +7 -0
  497. package/src/server/management/provider-completion-test.ts +4 -4
  498. package/src/server/management/provider-overwrite-carry.ts +14 -0
  499. package/src/server/management/provider-routes.ts +68 -65
  500. package/src/server/management/provider-routing-quota.ts +45 -0
  501. package/src/server/management/route-registry.ts +22 -3
  502. package/src/server/management/route-to-routes.ts +257 -0
  503. package/src/server/management/static-catalog-probe.ts +33 -0
  504. package/src/server/management/system-restart.ts +4 -2
  505. package/src/server/management/usage-aggregate-cache.ts +101 -66
  506. package/src/server/management-api.ts +17 -3
  507. package/src/server/management-auth.ts +13 -1
  508. package/src/server/messages-native-preflight.ts +27 -4
  509. package/src/server/messages-native.ts +17 -5
  510. package/src/server/persistent-gui-session.ts +6 -3
  511. package/src/server/proxy-liveness.ts +87 -15
  512. package/src/server/relay-eager.ts +36 -12
  513. package/src/server/relay.ts +189 -117
  514. package/src/server/request-body-facts.ts +48 -0
  515. package/src/server/request-decompress.ts +65 -2
  516. package/src/server/request-log-account-rotation.ts +6 -0
  517. package/src/server/request-log-attempt-usage.ts +69 -0
  518. package/src/server/request-log-cache-affinity.ts +60 -0
  519. package/src/server/request-log-conversation.ts +45 -2
  520. package/src/server/request-log-terminal-status.ts +210 -24
  521. package/src/server/request-log.ts +76 -80
  522. package/src/server/reserve-capability-startup.ts +32 -0
  523. package/src/server/responses/adapter-continuation.ts +2 -1
  524. package/src/server/responses/adapter-delivery.ts +4 -0
  525. package/src/server/responses/adapter-dispatch.ts +36 -17
  526. package/src/server/responses/advisor-plan-slot.ts +33 -1
  527. package/src/server/responses/advisor-question.ts +21 -0
  528. package/src/server/responses/advisor-slot.ts +10 -3
  529. package/src/server/responses/antigravity-fault-rotation.ts +24 -0
  530. package/src/server/responses/antigravity-validation-refusal.ts +43 -6
  531. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  532. package/src/server/responses/buffered-sse-json.ts +9 -3
  533. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  534. package/src/server/responses/codex-tool-catalog.ts +156 -0
  535. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  536. package/src/server/responses/combo-selection-keepalive.ts +254 -0
  537. package/src/server/responses/combo-stream-preflight.ts +557 -54
  538. package/src/server/responses/compact.ts +32 -8
  539. package/src/server/responses/core-codex-account.ts +17 -3
  540. package/src/server/responses/core-combo-failure.ts +8 -0
  541. package/src/server/responses/core-combo.ts +55 -12
  542. package/src/server/responses/core-errors.ts +13 -7
  543. package/src/server/responses/core-lifetime.ts +3 -2
  544. package/src/server/responses/core-normalize.ts +3 -1
  545. package/src/server/responses/core-options.ts +14 -0
  546. package/src/server/responses/core.ts +23 -0
  547. package/src/server/responses/estimated-usage.ts +115 -0
  548. package/src/server/responses/fetch-helpers.ts +15 -10
  549. package/src/server/responses/jev-model-invoke.ts +7 -2
  550. package/src/server/responses/native-replay-guard.ts +57 -0
  551. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  552. package/src/server/responses/outbound-request-body.ts +29 -0
  553. package/src/server/responses/passthrough-completion.ts +109 -9
  554. package/src/server/responses/passthrough-delivery.ts +77 -18
  555. package/src/server/responses/passthrough-dispatch.ts +77 -73
  556. package/src/server/responses/policy-fallback.ts +13 -1
  557. package/src/server/responses/request-prepare.ts +59 -11
  558. package/src/server/responses/request-transport.ts +10 -3
  559. package/src/server/responses/reset-replay.ts +46 -2
  560. package/src/server/responses/run-turn-execution.ts +2 -0
  561. package/src/server/responses/sidecar-execution.ts +19 -0
  562. package/src/server/responses/terminal-error-redaction.ts +222 -25
  563. package/src/server/responses/ws-upstream.ts +2 -2
  564. package/src/server/sse-payload-rewrite.ts +3 -2
  565. package/src/server/stop-service-route.ts +85 -0
  566. package/src/server/system-env-shell.ts +12 -1
  567. package/src/server/system-env.ts +5 -3
  568. package/src/server/windows-tcp-drop.ts +21 -4
  569. package/src/server/workflow-refusal.ts +8 -0
  570. package/src/server/ws-bridge.ts +191 -12
  571. package/src/service/cli-windows-stop.ts +189 -0
  572. package/src/service/cli.ts +41 -12
  573. package/src/service/desktop-supervision.d.mts +2 -0
  574. package/src/service/desktop-supervision.mjs +5 -0
  575. package/src/service/disconnected-client-restart.ts +60 -0
  576. package/src/service/guarded-manager-target.ts +18 -1
  577. package/src/service/health.ts +99 -6
  578. package/src/service/launchd.ts +84 -31
  579. package/src/service/orchestration.ts +418 -91
  580. package/src/service/repair.ts +223 -6
  581. package/src/service/restart-proxy-stop.ts +79 -0
  582. package/src/service/service-child-ownership.ts +6 -2
  583. package/src/service/windows-checked-stop-live.ts +467 -0
  584. package/src/service/windows-checked-stop.ts +435 -0
  585. package/src/service/windows-command-line-token.ts +23 -0
  586. package/src/service/windows-guarded-manager.ts +77 -34
  587. package/src/service/windows-ops.ts +38 -56
  588. package/src/service/windows-process-evidence.ts +292 -0
  589. package/src/service/windows-process-native.ts +262 -0
  590. package/src/service/windows-service-stop.ts +321 -0
  591. package/src/service/windows-stop-binding.ts +187 -0
  592. package/src/service/windows-stop-budget.ts +123 -0
  593. package/src/service/windows-stop-confirm.ts +158 -0
  594. package/src/service/windows-stop-deadline.ts +56 -0
  595. package/src/service.ts +2 -2
  596. package/src/stall-timeout.ts +11 -0
  597. package/src/types/config.ts +57 -110
  598. package/src/types/link.ts +20 -0
  599. package/src/types/multi-agent.ts +13 -0
  600. package/src/types/provider.ts +60 -2
  601. package/src/types/request.ts +23 -0
  602. package/src/types/routed-catalog-defaults.ts +17 -0
  603. package/src/types/routing-profile.ts +90 -0
  604. package/src/types.ts +4 -0
  605. package/src/update/guarded-runtime-ops.ts +5 -7
  606. package/src/update/index.ts +26 -11
  607. package/src/update/install-detection.mjs +3 -1
  608. package/src/update/job-pinned-start.ts +2 -0
  609. package/src/update/job-windows-restart.ts +19 -32
  610. package/src/update/job.ts +12 -5
  611. package/src/update/npm-install.d.mts +11 -0
  612. package/src/update/npm-install.mjs +44 -7
  613. package/src/update/orchestrated-entry.ts +1 -1
  614. package/src/update/orchestrated-node-driver.mjs +3 -2
  615. package/src/update/orchestrated-pnpm.d.mts +4 -0
  616. package/src/update/orchestrated-pnpm.mjs +50 -6
  617. package/src/update/orchestrated-session.d.mts +3 -1
  618. package/src/update/orchestrated-session.mjs +21 -6
  619. package/src/update/pnpm-global-install.d.mts +21 -3
  620. package/src/update/pnpm-global-install.mjs +322 -19
  621. package/src/update/pnpm-store-layout.mjs +46 -0
  622. package/src/update/sync-update-mutex.d.mts +3 -2
  623. package/src/update/sync-update-mutex.mjs +57 -8
  624. package/src/update/transactional-install.d.mts +3 -1
  625. package/src/update/transactional-install.mjs +545 -12
  626. package/src/update/windows-installer-marker.d.mts +1 -0
  627. package/src/update/windows-installer-marker.mjs +44 -0
  628. package/src/usage/expected-prices.ts +8 -0
  629. package/src/usage/filter-index.ts +326 -77
  630. package/src/usage/ledger-scanner.ts +15 -0
  631. package/src/usage/link-log-fields.ts +48 -0
  632. package/src/usage/log.ts +57 -6
  633. package/src/usage/request-body.ts +37 -0
  634. package/src/usage/telemetry-contract.ts +1 -0
  635. package/src/web-search/loop.ts +3 -0
  636. package/src/web-search/passthrough-bridge.ts +7 -0
  637. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  638. package/gui/dist/assets/brand-mark-DU-0Vdkr.js +0 -1
  639. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  640. package/gui/dist/assets/index-DJEkIDAi.css +0 -2
  641. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  642. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  643. package/gui/dist/classic/assets/quota-summary-CakPe9Ni.js +0 -1
  644. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,96 @@
1
+ /**
2
+ * The link known_hosts file as a route edit must find it (structure/remote-link.md, "Routes"). It is
3
+ * private and written only by putKnownHost, one "<alias> <keytype> <base64>" line per alias; releases
4
+ * before HashKnownHosts=no was passed to the probe (#6891) recorded that line hashed ("|1|salt|hash")
5
+ * on a Home whose ssh_config hashes known_hosts. With HostKeyAlias=<alias>, OpenSSH looks a key up
6
+ * under the alias alone: it compares plain names without case, and it lowercases the alias before
7
+ * hashing it, so a hashed line matches exactly when it is HMAC-SHA1(salt, lowercased alias). A link
8
+ * trusts exactly its record's key only when every line matching the alias that way carries that key
9
+ * and no line is a pattern, list, [host]:port form or marker that could match it too.
10
+ */
11
+ import { createHash, createHmac } from "node:crypto";
12
+ import { isSshAlias } from "./ssh-argv";
13
+
14
+ export type RouteTrustCheck = { ok: true; line: string } | { ok: false; code: "pin_mismatch" | "trust_file_unexpected" };
15
+
16
+ const KEY_TYPE = /^[a-z0-9][a-z0-9@.-]{0,63}$/;
17
+ const BASE64 = /^[A-Za-z0-9+/]+={0,2}$/;
18
+ // OpenSSH's hashed host field: a 20-byte salt and a 20-byte HMAC-SHA1, both in base64.
19
+ const HASHED = /^\|1\|([A-Za-z0-9+/]{27}=)\|([A-Za-z0-9+/]{27}=)$/;
20
+
21
+ /** OpenSSH's SHA256 fingerprint of a public key blob given in base64. */
22
+ export function keyFingerprint(base64: string): string {
23
+ return "SHA256:" + createHash("sha256").update(Buffer.from(base64, "base64")).digest("base64").replace(/=+$/, "");
24
+ }
25
+
26
+ function hostField(line: string): string {
27
+ return line.trim().split(/\s+/)[0] ?? "";
28
+ }
29
+
30
+ /** Does this host field name alias for an OpenSSH lookup with HostKeyAlias=<alias>? */
31
+ function hostMatches(host: string, alias: string): boolean {
32
+ const hashed = HASHED.exec(host);
33
+ if (!hashed) return host.toLowerCase() === alias.toLowerCase();
34
+ return createHmac("sha1", Buffer.from(hashed[1]!, "base64")).update(alias.toLowerCase()).digest("base64") === hashed[2];
35
+ }
36
+
37
+ function meaningful(line: string): boolean {
38
+ const trimmed = line.trim();
39
+ return trimmed !== "" && !trimmed.startsWith("#");
40
+ }
41
+
42
+ /**
43
+ * Whole-file check, then the lines that match alias (plain without case, or hashed), which must all
44
+ * carry one key: the key OpenSSH will accept for it. Any pattern, host list, [host]:port form, marker
45
+ * or malformed hashed field fails the whole file; a well-formed hashed line for another name is
46
+ * another host's line.
47
+ */
48
+ export function aliasTrustLine(text: string, alias: string): RouteTrustCheck {
49
+ const lines = text.split(/\r?\n/).filter(meaningful);
50
+ for (const line of lines) {
51
+ const [host, type, key] = line.trim().split(/\s+/);
52
+ // isSshAlias admits no * ? ! , | and no leading [ or @, so a valid host field is one literal name.
53
+ if (!host || !type || !key || !(isSshAlias(host) || HASHED.test(host)) || !KEY_TYPE.test(type) || !BASE64.test(key)) return { ok: false, code: "trust_file_unexpected" };
54
+ }
55
+ const matches = lines.filter(line => hostMatches(hostField(line), alias));
56
+ if (matches.length === 0) return { ok: false, code: "pin_mismatch" };
57
+ // OpenSSH accepts any matching line, so several lines are one pin only when they all carry the same
58
+ // key: legacy files hold a hashed line per confirmation, or a hashed line beside a later plain one.
59
+ const keyOf = (line: string) => line.trim().split(/\s+/).slice(1, 3).join(" ");
60
+ const pinned = keyOf(matches[0]!);
61
+ return matches.every(line => keyOf(line) === pinned) ? { ok: true, line: matches[0]!.trim() } : { ok: false, code: "pin_mismatch" };
62
+ }
63
+
64
+ /** aliasTrustLine, and that one line's key has the pinned fingerprint. */
65
+ export function checkRouteTrust(text: string, alias: string, fingerprint: string | null): RouteTrustCheck {
66
+ const found = aliasTrustLine(text, alias);
67
+ if (!found.ok) return found;
68
+ if (fingerprint === null) return { ok: false, code: "pin_mismatch" };
69
+ const key = found.line.split(/\s+/)[2]!;
70
+ return keyFingerprint(key) === fingerprint ? found : { ok: false, code: "pin_mismatch" };
71
+ }
72
+
73
+ /** The file's meaningful lines without any line OpenSSH would use for alias (any case, or hashed). */
74
+ export function withoutAliasLines(text: string, alias: string): string[] {
75
+ // Every line OpenSSH would use for the alias goes, a hashed one included, so a confirmation replaces it.
76
+ return text.split(/\r?\n/).filter(line => line && !hostMatches(hostField(line), alias) && !line.startsWith(alias + ","));
77
+ }
78
+
79
+ export type ConfirmedLineTrust = "trusted" | "trust_file_unexpected" | "key_changed";
80
+
81
+ /**
82
+ * Does the file still trust exactly the key a confirmation wrote for alias? It must pass the same
83
+ * whole-file check as a route edit (`trust_file_unexpected` otherwise: OpenCodex writes this file
84
+ * only with plain one-alias lines, so another shape is a hand edit this check cannot rule out), and
85
+ * every line for the alias, which may be several (a legacy hashed line beside a later plain one),
86
+ * must carry the confirmed key type and key (`key_changed` otherwise). The probe computed the
87
+ * confirmed fingerprint from the line it wrote (ssh-keygen -l), so that line carries it.
88
+ */
89
+ export function confirmedLineTrust(text: string, alias: string, confirmedLine: string): ConfirmedLineTrust {
90
+ const found = aliasTrustLine(text, alias);
91
+ if (!found.ok) return found.code === "trust_file_unexpected" ? "trust_file_unexpected" : "key_changed";
92
+ // The host field may be another spelling of the alias (putKnownHost replaces every case variant);
93
+ // the key type and key are what OpenSSH will accept.
94
+ return found.line.split(/\s+/).slice(1, 3).join(" ") === confirmedLine.trim().split(/\s+/).slice(1, 3).join(" ") ? "trusted" : "key_changed";
95
+ }
96
+
@@ -1,3 +1,4 @@
1
+ import { isRouteClientId, type RouteClientId } from "./route-intent";
1
2
  /**
2
3
  * Argument vectors for the system OpenSSH client used by machine links.
3
4
  *
@@ -19,7 +20,8 @@
19
20
  */
20
21
 
21
22
  import { isAbsolute } from "node:path";
22
- import { POWERSHELL_ENCODED_MAX, PowerShellCommandTooLongError, windowsGatedOcxArgv, windowsOcxArgv } from "./remote-windows";
23
+ import { ExplicitRouteError, explicitRouteSshOptions, type ExplicitRoute } from "./explicit-route";
24
+ import { POWERSHELL_ENCODED_MAX, PowerShellCommandTooLongError, ROUTE_OVERWRITE_MIN_CHILD_VERSION, windowsGatedOcxArgv, windowsOcxArgv, windowsOverwriteSyncArgv } from "./remote-windows";
23
25
 
24
26
  export type TunnelDirection = "R" | "L";
25
27
 
@@ -67,8 +69,40 @@ function optionPath(path: string): string {
67
69
  return /\s/.test(path) ? `"${path}"` : path;
68
70
  }
69
71
 
70
- function commonOptions(alias: string, knownHostsFile: string, strict: "yes" | "accept-new"): string[] {
72
+ /** ERROR everywhere; DEBUG1 only for a tunnel spawned while opt-in SSH capture is on (src/link/ssh-capture.ts). */
73
+ export type SshLogLevel = "ERROR" | "DEBUG1";
74
+
75
+ /**
76
+ * The link's explicit route (src/link/explicit-route.ts) as command-line options, which ssh takes before
77
+ * anything in ssh_config. It names how to reach the link's own alias, so it is refused with any other
78
+ * destination; null adds nothing, which is the argv of a link without one.
79
+ */
80
+ function routeOptions(route: ExplicitRoute | null | undefined, alias: string, destination: string): RouteArgs {
81
+ if (!route) return NO_ROUTE;
82
+ if (destination !== alias) throw new LinkSshArgumentError("an explicit route reaches the link alias only");
83
+ try {
84
+ // Decided by the route itself, never by what its options happen to be: a link with a route reads no ssh_config.
85
+ return { configFile: ["-F", "none"], options: explicitRouteSshOptions(route) };
86
+ } catch (error) {
87
+ if (error instanceof ExplicitRouteError) throw new LinkSshArgumentError(error.message);
88
+ throw error;
89
+ }
90
+ }
91
+
92
+ /**
93
+ * What a route adds to the argv. configFile is ["-F", "none"] for every explicit route and comes first: an explicit route
94
+ * names the transport, user and port and the host key is pinned, so such a link reads no ssh_config at all (list-valued
95
+ * settings such as forwards, SendEnv and IdentityFile would add to ours, a RemoteCommand would break every exec, and no
96
+ * option can remove a configured forward from the tunnel). A route's identity file (link.route/2) narrows what remains:
97
+ * with -F none the defaults still offer the agent's keys and ~/.ssh/id_*, so IdentitiesOnly=yes and IdentityAgent=none
98
+ * leave that one IdentityFile. Links without a route keep reading the owner's ssh_config, which is how they reach their host.
99
+ */
100
+ interface RouteArgs { configFile: readonly string[]; options: readonly string[] }
101
+ const NO_ROUTE: RouteArgs = { configFile: [], options: [] };
102
+
103
+ function commonOptions(alias: string, knownHostsFile: string, strict: "yes" | "accept-new", logLevel: SshLogLevel, route: RouteArgs): string[] {
71
104
  return [
105
+ ...route.configFile,
72
106
  "-o", "BatchMode=yes",
73
107
  "-o", "ConnectTimeout=10",
74
108
  "-o", "ServerAliveInterval=15",
@@ -87,12 +121,18 @@ function commonOptions(alias: string, knownHostsFile: string, strict: "yes" | "a
87
121
  "-o", "ForwardAgent=no",
88
122
  "-o", "ForwardX11=no",
89
123
  "-o", "PermitLocalCommand=no",
90
- "-o", "LogLevel=ERROR",
124
+ "-o", `LogLevel=${logLevel}`,
125
+ ...route.options,
91
126
  ];
92
127
  }
93
128
 
94
129
  export interface TunnelArgvOptions {
95
130
  alias: string;
131
+ /**
132
+ * Where ssh connects, when it is another route to the same machine. HostKeyAlias stays alias, so
133
+ * the route is checked against the key pinned for the link. Omitted: alias (today's argv).
134
+ */
135
+ destination?: string;
96
136
  /** "R": listen on the remote host and reach this host. "L": listen here and reach the remote host. */
97
137
  direction: TunnelDirection;
98
138
  /** Port the forward listens on (remote for "R", local for "L"). */
@@ -100,37 +140,55 @@ export interface TunnelArgvOptions {
100
140
  /** Port the forward connects to on the other side's 127.0.0.1. */
101
141
  targetPort: number;
102
142
  knownHostsFile: string;
143
+ /** Defaults to ERROR. DEBUG1 is requested only by opt-in SSH capture; the argv is otherwise unchanged. */
144
+ logLevel?: SshLogLevel;
145
+ /**
146
+ * The link's explicit route, or null. Required so every caller decides: a Home-initiated link passes
147
+ * its record's explicitRoute (absent: null); Child-initiated and messaging commands pass null.
148
+ */
149
+ route: ExplicitRoute | null;
103
150
  }
104
151
 
105
152
  export function buildTunnelArgv(options: TunnelArgvOptions): string[] {
106
153
  const alias = assertSshAlias(options.alias);
154
+ const destination = assertSshAlias(options.destination ?? alias);
107
155
  const bind = assertPort(options.bindPort, "bindPort");
108
156
  const target = assertPort(options.targetPort, "targetPort");
109
157
  if (options.direction !== "R" && options.direction !== "L") throw new LinkSshArgumentError("direction must be R or L");
158
+ const logLevel = options.logLevel ?? "ERROR";
159
+ if (logLevel !== "ERROR" && logLevel !== "DEBUG1") throw new LinkSshArgumentError("logLevel must be ERROR or DEBUG1");
110
160
  return [
111
161
  "ssh", "-N", "-T",
112
- ...commonOptions(alias, options.knownHostsFile, "yes"),
162
+ ...commonOptions(alias, options.knownHostsFile, "yes", logLevel, routeOptions(options.route, alias, destination)),
113
163
  "-o", "ExitOnForwardFailure=yes",
114
164
  `-${options.direction}`, `127.0.0.1:${bind}:127.0.0.1:${target}`,
115
- "--", alias,
165
+ "--", destination,
116
166
  ];
117
167
  }
118
168
 
119
169
  export interface ExecArgvOptions {
120
170
  alias: string;
171
+ /** Another route to the same machine; HostKeyAlias stays alias. Omitted: alias. */
172
+ destination?: string;
121
173
  /** Remote argv. The command must be sh; its arguments are quoted for the remote shell. */
122
174
  argv: readonly string[];
123
175
  knownHostsFile: string;
176
+ /**
177
+ * The link's explicit route, or null. Required so every caller decides: a Home-initiated link passes
178
+ * its record's explicitRoute (absent: null); Child-initiated and messaging commands pass null.
179
+ */
180
+ route: ExplicitRoute | null;
124
181
  }
125
182
 
126
183
  export function buildExecArgv(options: ExecArgvOptions): string[] {
127
184
  const alias = assertSshAlias(options.alias);
185
+ const destination = assertSshAlias(options.destination ?? alias);
128
186
  if (options.argv.length === 0) throw new LinkSshArgumentError("remote argv must not be empty");
129
187
  return [
130
188
  "ssh", "-T",
131
- ...commonOptions(alias, options.knownHostsFile, "yes"),
189
+ ...commonOptions(alias, options.knownHostsFile, "yes", "ERROR", routeOptions(options.route, alias, destination)),
132
190
  "-o", "ClearAllForwardings=yes",
133
- "--", alias,
191
+ "--", destination,
134
192
  quoteRemote(options.argv),
135
193
  ];
136
194
  }
@@ -257,6 +315,11 @@ export interface ProbeArgvOptions {
257
315
  alias: string;
258
316
  /** An empty, private, temporary file. The probe records the offered host key here. */
259
317
  tempKnownHostsFile: string;
318
+ /**
319
+ * The link's explicit route, or null. Required so every caller decides: a Home-initiated link passes
320
+ * its record's explicitRoute (absent: null); Child-initiated and messaging commands pass null.
321
+ */
322
+ route: ExplicitRoute | null;
260
323
  }
261
324
 
262
325
  /**
@@ -268,13 +331,44 @@ export function buildProbeArgv(options: ProbeArgvOptions): string[] {
268
331
  const alias = assertSshAlias(options.alias);
269
332
  return [
270
333
  "ssh", "-T",
271
- ...commonOptions(alias, options.tempKnownHostsFile, "accept-new"),
334
+ ...commonOptions(alias, options.tempKnownHostsFile, "accept-new", "ERROR", routeOptions(options.route, alias, alias)),
272
335
  "-o", "ClearAllForwardings=yes",
273
336
  "--", alias,
274
337
  "echo ocx-link-probe",
275
338
  ];
276
339
  }
277
340
 
341
+ export interface RouteProbeArgvOptions {
342
+ /** The link's alias: the name its host key is pinned under. */
343
+ alias: string;
344
+ /** The route being tried. */
345
+ destination: string;
346
+ /** The link known_hosts file. It is only read: the route must offer the key already pinned. */
347
+ knownHostsFile: string;
348
+ /**
349
+ * The link's explicit route, or null. Required so every caller decides: a Home-initiated link passes
350
+ * its record's explicitRoute (absent: null); Child-initiated and messaging commands pass null.
351
+ */
352
+ route: ExplicitRoute | null;
353
+ }
354
+
355
+ /**
356
+ * Does this route reach the pinned machine and accept our key? Strict host-key checking against
357
+ * the link file under HostKeyAlias=alias: a route that answers with any other key fails with "Host
358
+ * key verification failed" and nothing is learned or written. Success prints exactly ocx-link-probe.
359
+ */
360
+ export function buildRouteProbeArgv(options: RouteProbeArgvOptions): string[] {
361
+ const alias = assertSshAlias(options.alias);
362
+ const destination = assertSshAlias(options.destination);
363
+ return [
364
+ "ssh", "-T",
365
+ ...commonOptions(alias, options.knownHostsFile, "yes", "ERROR", routeOptions(options.route, alias, destination)),
366
+ "-o", "ClearAllForwardings=yes",
367
+ "--", destination,
368
+ "echo ocx-link-probe",
369
+ ];
370
+ }
371
+
278
372
  /**
279
373
  * Locale-independent Windows check for a host whose SSH shell is cmd.exe or PowerShell. Both run
280
374
  * `cmd /c echo %OS%`, and cmd expands it to `Windows_NT` regardless of display language. The
@@ -283,13 +377,14 @@ export function buildProbeArgv(options: ProbeArgvOptions): string[] {
283
377
  export const WINDOWS_OS_PROBE = "cmd /c echo %OS%";
284
378
 
285
379
  /** Run WINDOWS_OS_PROBE against an already trusted (pinned or just-probed) host key only. */
286
- export function buildWindowsProbeArgv(options: { alias: string; knownHostsFile: string }): string[] {
380
+ export function buildWindowsProbeArgv(options: { alias: string; knownHostsFile: string; destination?: string; route: ExplicitRoute | null }): string[] {
287
381
  const alias = assertSshAlias(options.alias);
382
+ const destination = assertSshAlias(options.destination ?? alias);
288
383
  return [
289
384
  "ssh", "-T",
290
- ...commonOptions(alias, options.knownHostsFile, "yes"),
385
+ ...commonOptions(alias, options.knownHostsFile, "yes", "ERROR", routeOptions(options.route, alias, destination)),
291
386
  "-o", "ClearAllForwardings=yes",
292
- "--", alias,
387
+ "--", destination,
293
388
  WINDOWS_OS_PROBE,
294
389
  ];
295
390
  }
@@ -323,8 +418,9 @@ export function quoteRemote(argv: readonly string[]): string {
323
418
  }
324
419
 
325
420
  /** Minimum served ocx for a gated command. Closed set: the literals are spliced into awk and PowerShell. */
326
- export type GatedMinVersion = "2.93.0" | "2.97.0";
327
- export type GatedLacksMarker = "child-ocx-lacks-expect-link" | "child-ocx-lacks-orchestrated-update";
421
+ export { ROUTE_OVERWRITE_MIN_CHILD_VERSION };
422
+ export type GatedMinVersion = "2.93.0" | "2.97.0" | "2.100.0";
423
+ export type GatedLacksMarker = "child-ocx-lacks-expect-link" | "child-ocx-lacks-orchestrated-update" | "child-ocx-lacks-overwrite";
328
424
  export interface GatedOcxCommand {
329
425
  minVersion: GatedMinVersion;
330
426
  lacksMarker: GatedLacksMarker;
@@ -337,18 +433,26 @@ export interface GatedOcxCommand {
337
433
  /** With acceptEphemeral, print ocx-fanout:selected-kind:ocx-child when the selected candidate is ocx-child.
338
434
  * Set only by remotePinnedSyncArgv when a restart is requested (ocx-child ignores the restart flags). */
339
435
  reportSelectedKind?: boolean;
436
+ /**
437
+ * A4: what the script does with the Node launcher of a package install whose census pair sits under node_modules.
438
+ * "none": nothing. "report": print ocx-fanout:launcher:available|unavailable (the plan probe; never exits for it).
439
+ * "apply": exec <node> <root>/bin/ocx.mjs with the arguments, or exit 121 child-node-unavailable when no Node answers.
440
+ * A closed union spliced as a literal; only the Home's parsed plan (installer npm or pnpm) chooses "apply".
441
+ */
442
+ launcher: "none" | "report" | "apply";
340
443
  args: readonly string[];
341
444
  }
342
445
  export const GATED_VERSION_PARTS: Readonly<Record<GatedMinVersion, readonly [string, string, string]>> = {
343
- "2.93.0": ["2", "93", "0"], "2.97.0": ["2", "97", "0"],
446
+ "2.93.0": ["2", "93", "0"], "2.97.0": ["2", "97", "0"], "2.100.0": ["2", "100", "0"],
344
447
  };
345
- const LACKS_MARKERS: ReadonlySet<string> = new Set(["child-ocx-lacks-expect-link", "child-ocx-lacks-orchestrated-update"]);
448
+ const LACKS_MARKERS: ReadonlySet<string> = new Set(["child-ocx-lacks-expect-link", "child-ocx-lacks-orchestrated-update", "child-ocx-lacks-overwrite"]);
346
449
  export const LINK_ID_PATTERN = /^lnk_[0-9a-f]{16}$/;
347
450
 
348
451
  function assertGated(cmd: GatedOcxCommand): readonly [string, string, string] {
349
452
  const parts = Object.hasOwn(GATED_VERSION_PARTS, cmd.minVersion) ? GATED_VERSION_PARTS[cmd.minVersion] : undefined;
350
453
  if (!parts || !LACKS_MARKERS.has(cmd.lacksMarker)) throw new LinkSshArgumentError("invalid gated ocx command");
351
454
  if (cmd.args.length === 0 || cmd.args.some(arg => arg.includes("\0"))) throw new LinkSshArgumentError("invalid gated ocx arguments");
455
+ if (cmd.launcher !== "none" && cmd.launcher !== "report" && cmd.launcher !== "apply") throw new LinkSshArgumentError("invalid gated ocx launcher");
352
456
  return parts;
353
457
  }
354
458
 
@@ -356,10 +460,14 @@ function assertGated(cmd: GatedOcxCommand): readonly [string, string, string] {
356
460
  * The pinned script for one gate: select a candidate, read its version inside the remote script, refuse below the
357
461
  * minimum, then exec it with "$@". OCX_NO_DESKTOP_HANDOFF=1 makes a package launcher answer --version for itself and
358
462
  * run the command itself, so a Desktop handoff can never pass the gate on behalf of an older launcher.
463
+ * With launcher "report" or "apply" and a census pair under node_modules that ships bin/ocx.mjs, the script looks for a
464
+ * Node that answers --version within 10 s (the npm prefix's bin/node first, then PATH) before the temp dir is removed.
359
465
  */
360
466
  function remoteGatedScript(cmd: GatedOcxCommand): string {
361
467
  const [major, minor, patch] = assertGated(cmd);
362
- const ephemeral = cmd.acceptEphemeral ? "" : `
468
+ const overwriteEphemeral = cmd.lacksMarker === "child-ocx-lacks-overwrite" ? `
469
+ case "\${c##*/}" in ocx-child*) printf '%s\\n' 'ocx-fanout:child-ephemeral-no-overwrite' >&2; exit 121;; esac` : "";
470
+ const ephemeral = cmd.acceptEphemeral || overwriteEphemeral ? "" : `
363
471
  case "\${c##*/}" in ocx-child*) printf '%s\\n' 'ocx-fanout:child-ocx-ephemeral' >&2; exit 121;; esac`;
364
472
  // Only a pinned sync that carries a restart asks for this, so the plain sync's stderr stays exact.
365
473
  const kind = cmd.acceptEphemeral && cmd.reportSelectedKind ? `
@@ -376,9 +484,26 @@ umask 077
376
484
  dir=$(mktemp -d "\${TMPDIR:-/tmp}/ocx-fanout.XXXXXXXX") || exit 127
377
485
  tmp=$dir/version; ready=$dir/ready
378
486
  trap 'rm -rf "$dir"' EXIT HUP INT TERM
487
+ launcher=${cmd.launcher}
488
+ node_ok() {
489
+ ( ulimit -c 0; exec "$1" --version ) >/dev/null 2>&1 & np=$!
490
+ ( sleep 10 & ntimer=$!; trap 'kill "$ntimer" 2>/dev/null; wait "$ntimer" 2>/dev/null; exit' TERM HUP INT; : > "$ready"; wait "$ntimer" 2>/dev/null; kill -9 "$np" 2>/dev/null ) >/dev/null 2>&1 & nwd=$!
491
+ while [ ! -f "$ready" ]; do kill -0 "$nwd" 2>/dev/null || break; sleep 0.01 >/dev/null 2>&1; done
492
+ { wait "$np"; nstatus=$?; } 2>/dev/null
493
+ kill "$nwd" 2>/dev/null; wait "$nwd" 2>/dev/null; rm -f "$ready"
494
+ [ "$nstatus" -eq 0 ]
495
+ }
496
+ find_launcher_node() {
497
+ node_bin=
498
+ case "$1" in */lib/node_modules/@bitkyc08/opencodex)
499
+ n=\${1%/lib/node_modules/@bitkyc08/opencodex}/bin/node
500
+ if [ -x "$n" ] && node_ok "$n"; then node_bin=$n; return 0; fi;; esac
501
+ n=$(command -v node 2>/dev/null) && [ -x "$n" ] && node_ok "$n" && node_bin=$n
502
+ return 0
503
+ }
379
504
  try_ocx() {
380
505
  c=$1; shift
381
- [ -x "$c" ] || return
506
+ [ -x "$c" ] || return${overwriteEphemeral}
382
507
  ( ulimit -c 0; ulimit -f 1; exec "$c" \${ocx_entry:+"$ocx_entry"} --version ) >"$tmp" 2>/dev/null & vp=$!
383
508
  ( sleep 10 & timer=$!; trap 'kill "$timer" 2>/dev/null; wait "$timer" 2>/dev/null; exit' TERM HUP INT; : > "$ready"; wait "$timer" 2>/dev/null; kill -9 "$vp" 2>/dev/null ) >/dev/null 2>&1 & watchdog=$!
384
509
  while [ ! -f "$ready" ]; do kill -0 "$watchdog" 2>/dev/null || break; sleep 0.01 >/dev/null 2>&1; done
@@ -409,8 +534,22 @@ try_ocx() {
409
534
  status=$?
410
535
  if [ "$status" -eq 1 ]; then printf '%s\\n' 'ocx-fanout:${cmd.lacksMarker}' >&2; exit 121; fi
411
536
  if [ "$status" -ne 0 ]; then printf '%s\\n' 'ocx-fanout:child-ocx-version-unknown' >&2; exit 121; fi${ephemeral}
537
+ root=; [ -n "$ocx_entry" ] && root=\${ocx_entry%/src/cli/index.ts}
538
+ case "$root" in */node_modules/*) [ -f "$root/bin/ocx.mjs" ] || root=;; *) root=;; esac
539
+ node_bin=; if [ -n "$root" ] && [ "$launcher" != none ]; then find_launcher_node "$root"; fi
412
540
  rm -rf "$dir"; trap - EXIT HUP INT TERM
413
541
  printf 'ocx-fanout:selected:%s\\n' "$version" >&2${kind}${entry}${clock}
542
+ if [ -n "$root" ] && [ "$launcher" = report ]; then
543
+ if [ -n "$node_bin" ]; then printf '%s\\n' 'ocx-fanout:launcher:available' >&2
544
+ else printf '%s\\n' 'ocx-fanout:launcher:unavailable' >&2; fi
545
+ fi
546
+ if [ -n "$root" ] && [ "$launcher" = apply ]; then
547
+ [ -n "$node_bin" ] || { printf '%s\\n' 'ocx-fanout:child-node-unavailable' >&2; exit 121; }
548
+ printf '%s\\n' 'ocx-fanout:launcher:exec' >&2
549
+ printf '%s\\n' 'ocx-fanout:stdout-begin'
550
+ unset OCX_UPDATE_ORCHESTRATED_CHILD
551
+ exec "$node_bin" "$root/bin/ocx.mjs" "$@"
552
+ fi
414
553
  printf '%s\\n' 'ocx-fanout:stdout-begin'
415
554
  exec "$c" \${ocx_entry:+"$ocx_entry"} "$@"
416
555
  }
@@ -422,7 +561,8 @@ export function remoteGatedOcxArgv(cmd: GatedOcxCommand, platform: "posix" | "wi
422
561
  const versionParts = assertGated(cmd);
423
562
  if (platform === "windows") {
424
563
  // A dropped channel kills the orchestrating parent with the Job, so no Windows apply is ever built (D20).
425
- if (cmd.args[0] === "update" && cmd.args.includes("--yes")) throw new LinkSshArgumentError("unsupported:windows-apply");
564
+ // Only a plan is ever built for Windows: an update spelled without --plan (or a future mutating flag) is refused.
565
+ if (cmd.args[0] === "update" && (!cmd.args.includes("--plan") || cmd.args.includes("--yes"))) throw new LinkSshArgumentError("unsupported:windows-apply");
426
566
  try {
427
567
  return windowsGatedOcxArgv({ ...cmd, versionParts });
428
568
  } catch (error) {
@@ -434,17 +574,25 @@ export function remoteGatedOcxArgv(cmd: GatedOcxCommand, platform: "posix" | "wi
434
574
  }
435
575
 
436
576
  export type ChildRestartRequest = "app-server" | "codex";
437
- export interface PinnedSyncOptions { restart?: ChildRestartRequest }
577
+ export interface PinnedSyncOptions { restart?: ChildRestartRequest; overwrite?: boolean; overwriteClient?: RouteClientId }
438
578
  const RESTART_FLAG: Readonly<Record<ChildRestartRequest, string>> = { "app-server": "--restart-app-server-only", codex: "--restart-codex" };
439
579
 
440
- export function remotePinnedSyncArgv(linkId: string, platform: "posix" | "windows" = "posix", opts: PinnedSyncOptions = {}): string[] {
580
+ export function remotePinnedSyncArgv(linkId: string, platform: "posix" | "windows" = "posix", opts: PinnedSyncOptions | boolean = {}, overwriteClient?: RouteClientId): string[] {
581
+ if (typeof opts === "boolean") opts = { overwrite: opts, ...(overwriteClient !== undefined ? { overwriteClient } : {}) };
582
+ else if (overwriteClient !== undefined) throw new LinkSshArgumentError("invalid overwrite client");
583
+ const overwrite = opts.overwrite === true;
584
+ overwriteClient = opts.overwriteClient;
585
+ if (overwriteClient !== undefined && (!overwrite || !isRouteClientId(overwriteClient))) throw new LinkSshArgumentError("invalid overwrite client");
441
586
  if (!LINK_ID_PATTERN.test(linkId)) throw new LinkSshArgumentError("invalid link id");
442
587
  if (opts.restart !== undefined && !Object.hasOwn(RESTART_FLAG, opts.restart)) throw new LinkSshArgumentError("invalid restart request");
443
588
  // D20: the Home never sends a restart to a Windows Child.
444
589
  if (opts.restart !== undefined && platform === "windows") throw new LinkSshArgumentError("unsupported:windows-restart");
445
590
  const restart = opts.restart === undefined ? [] : [RESTART_FLAG[opts.restart]];
446
- return remoteGatedOcxArgv({ minVersion: "2.93.0", lacksMarker: "child-ocx-lacks-expect-link", acceptEphemeral: true,
447
- reportEntry: false, reportClock: false, reportSelectedKind: restart.length > 0,
448
- args: ["sync", "--expect-link", linkId, "--json", ...restart] }, platform);
591
+ if (overwrite && platform === "windows") {
592
+ try { return windowsOverwriteSyncArgv(linkId, true, overwriteClient); }
593
+ catch (error) { if (error instanceof PowerShellCommandTooLongError) throw new LinkSshArgumentError("windows-command-too-long"); throw error; }
594
+ }
595
+ return remoteGatedOcxArgv({ minVersion: overwrite ? "2.100.0" : "2.93.0", lacksMarker: overwrite ? "child-ocx-lacks-overwrite" : "child-ocx-lacks-expect-link", acceptEphemeral: !overwrite,
596
+ reportEntry: false, reportClock: false, reportSelectedKind: restart.length > 0, launcher: "none",
597
+ args: ["sync", "--expect-link", linkId, "--json", ...restart, ...(overwrite ? ["--overwrite-conflict"] : []), ...(overwriteClient ? ["--overwrite-client", overwriteClient] : [])] }, platform);
449
598
  }
450
-