@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,579 @@
1
+ /**
2
+ * Selection rounds for a link with several routes (structure/remote-link.md, "Routes"). A round
3
+ * probes the eligible routes in order with the pinned route probe, starts the -R tunnel on the
4
+ * first that answers as a CANDIDATE, waits for OpenSSH to confirm the remote listener was granted
5
+ * to it, and then proves readiness end to end: the Child fetches its own /v1/catalog with a fresh
6
+ * proof id, its link relay carries that request to this Home with relay authentication, and the
7
+ * Home must see the id admitted under this tunnel's generation while the same request completes
8
+ * with a catalog. Only then is the link connected.
9
+ *
10
+ * One-route links never come here. Nothing in this module stops a tunnel that may carry traffic
11
+ * for a non-failure reason; a candidate that has not proven readiness by its deadline is a failed
12
+ * route and is stopped, which is today's reconnect contract for any request on it.
13
+ */
14
+ import { randomBytes } from "node:crypto";
15
+ import { buildExecArgv, buildRouteProbeArgv, remoteOcxArgv } from "./ssh-argv";
16
+ import { isChildHealth, parseChildHttp, remoteChildHttpArgv } from "./remote-probe";
17
+ import { requireRemotePlatform } from "./remote-platform";
18
+ import { aggregateRouteClass, composeGrantTap, routeCooldownMs, routeOutcomeOfStderr, type RouteOutcomeClass } from "./route-select";
19
+ import type { RouteProofHandle, RouteProofRegistry } from "./route-proof";
20
+ import { SSH_MAX_OUTPUT_BYTES, type SshChild, type SshRunner } from "./ssh-runner";
21
+ import { effectiveLinkRoutes, type LinkRecord } from "./store";
22
+ import { exitCause, type TunnelCause } from "./tunnel-history";
23
+ import type { StderrClass, TunnelEvent, TunnelState } from "./tunnel-state";
24
+
25
+ /** One route probe, supervisor clock. */
26
+ export const ROUTE_PROBE_MS = 10_000;
27
+ /**
28
+ * A candidate's budget, twice: from its spawn to the grant of its remote listener, and then from that
29
+ * grant to its proven readiness (discovery, health and every trigger). A slow route that spends most
30
+ * of the first budget on the ssh handshake still has the whole second one for its readiness execs.
31
+ * Not measured on a real slow route. A candidate's readiness deadline is at most 2 x READY_PROOF_MS
32
+ * after its spawn; the first supervisor tick at or after that deadline stops it (SIGTERM, then SIGKILL
33
+ * after CANDIDATE_KILL_GRACE_MS).
34
+ */
35
+ export const READY_PROOF_MS = 30_000;
36
+ /** One correlated trigger at most. */
37
+ export const PROOF_ATTEMPT_MS = 15_000;
38
+ /** Between the end of one failed trigger and the next. */
39
+ export const PROOF_RETRY_MS = 2_000;
40
+ /** SIGTERM to SIGKILL, and SIGKILL to giving up on observing a stopped candidate's exit. */
41
+ export const CANDIDATE_KILL_GRACE_MS = 2_000;
42
+ /** The ssh client check, and how long an unsupported answer stands. */
43
+ export const CLIENT_CHECK_MS = 5_000;
44
+ export const CLIENT_RECHECK_MS = 10 * 60_000;
45
+ // The Child's whole effective config: enrollment accepts up to the runner maximum (#8380), so a
46
+ // Child that enrolled with a large config must also pass this step on every route.
47
+ const CONFIG_MAX_BYTES = SSH_MAX_OUTPUT_BYTES;
48
+ const CATALOG_MAX_BYTES = 4 * 1024 * 1024;
49
+
50
+ export type RouteBlock = "ssh_client_unsupported" | "stop_unconfirmed";
51
+
52
+ export interface LinkRouteStatus {
53
+ routes: Array<{ name: string; eligibleAt: number | null; lastOutcome: { class: RouteOutcomeClass; at: number } | null }>;
54
+ /** The route of the proven tunnel and when it was proven; null while none is proven. */
55
+ route: { name: string; index: number; since: number } | null;
56
+ blocked: RouteBlock | null;
57
+ }
58
+
59
+ /** What the supervisor lends a round. Every call is synchronous except the runner. */
60
+ export interface RouteRoundHost {
61
+ runner: Pick<SshRunner, "run">;
62
+ now(): number;
63
+ random(): number;
64
+ knownHostsFile(): string;
65
+ listenerPort(): number | null;
66
+ /** The record as the supervisor currently holds it. */
67
+ record(linkId: string): LinkRecord | undefined;
68
+ /** stopping, held, or an earlier tunnel that may still live (orphan-unverified). */
69
+ blocked(linkId: string): boolean;
70
+ /** Lifecycle work (reload, stop, reconnect) is running: deadlines advance, no new probe or tunnel starts. */
71
+ busy(): boolean;
72
+ /** Is this child still the link's registered tunnel? */
73
+ ownsChild(linkId: string, child: SshChild): boolean;
74
+ /** Start the -R tunnel on a route, register it as the link's child, and name its generation. */
75
+ spawnTunnel(record: LinkRecord, destination: string, stderrLine: (line: string) => boolean): { child: SshChild; generation: string; setupFailed?: boolean };
76
+ /** The operator's capture tap for this spawn, if a capture window is open. */
77
+ captureTap(linkId: string): ((line: string) => boolean) | undefined;
78
+ setEvent(linkId: string, event: TunnelEvent, cause?: TunnelCause | null): TunnelState;
79
+ /** Push a scheduled retry later without recording a transition. */
80
+ deferRetry(linkId: string, at: number): void;
81
+ /** Count one ssh attempt in the tunnel history (once per round). */
82
+ attempted(linkId: string): void;
83
+ routeProof?: RouteProofRegistry;
84
+ warn(message: string): void;
85
+ }
86
+
87
+ interface RouteBook { name: string; outcome: RouteOutcomeClass | null; outcomeAt: number | null; probeFailures: number; tunnelFailures: number; eligibleAt: number }
88
+
89
+ interface Proof {
90
+ platform?: "posix" | "windows";
91
+ port?: number;
92
+ healthy?: boolean;
93
+ inFlight: boolean;
94
+ nextAt: number;
95
+ handle?: RouteProofHandle;
96
+ }
97
+
98
+ type Phase =
99
+ | { kind: "client" }
100
+ | { kind: "probe"; route: string; startedAt: number; abort: AbortController }
101
+ | {
102
+ kind: "candidate"; route: string; child: SshChild; generation: string; spawnedAt: number;
103
+ grantedAt?: number; refused?: boolean; failure?: RouteOutcomeClass; stopAt?: number; killed?: boolean;
104
+ abort: AbortController; proof: Proof;
105
+ }
106
+ | { kind: "halted"; route: string; child: SshChild; failure: RouteOutcomeClass }
107
+ /** A probe that settled while lifecycle work ran: no deadline applies; round.resume continues it. */
108
+ | { kind: "deferred" };
109
+
110
+ interface Round {
111
+ token: number;
112
+ queue: string[];
113
+ phase: Phase;
114
+ /** New work held back while lifecycle work runs; the next free tick starts it. */
115
+ resume?: () => void;
116
+ }
117
+
118
+ interface LinkRoutes {
119
+ books: Map<string, RouteBook>;
120
+ round?: Round;
121
+ active?: { route: string; child: SshChild; since: number };
122
+ blocked: RouteBlock | null;
123
+ }
124
+
125
+ type ClientState = { kind: "unknown" } | { kind: "checking"; abort: AbortController; epoch: number } | { kind: "ok" } | { kind: "unsupported"; at: number };
126
+
127
+ export interface RouteRounds {
128
+ isMultiRoute(record: LinkRecord): boolean;
129
+ /** Start a round for a due attempt. False when the link is not multi-route. */
130
+ begin(record: LinkRecord): boolean;
131
+ tick(linkId: string): void;
132
+ /** True when this child belonged to a multi-route round or proven tunnel (the exit is handled). */
133
+ exited(linkId: string, child: SshChild, stderr: string): boolean;
134
+ /** Drop rounds and proofs: a stop, hold, reconnect or removal is taking the link down. */
135
+ cancel(linkId: string): void;
136
+ /** Forget everything about a link (removed, or no longer multi-route). */
137
+ forget(linkId: string): void;
138
+ /** A reload changed this link's route list but kept its tunnel. */
139
+ routesChanged(record: LinkRecord): void;
140
+ /** Adopt a running one-route tunnel on the alias when the link gains routes. */
141
+ adopt(record: LinkRecord, child: SshChild, connectedSince: number | null): void;
142
+ /** Proven or candidate route of a link's live child, for the reload check. */
143
+ liveRoute(linkId: string): string | undefined;
144
+ inRound(linkId: string): boolean;
145
+ status(linkId: string): LinkRouteStatus | undefined;
146
+ /** The ssh client answer changes (a reload of a multi-route record re-reads it). */
147
+ recheckClient(): void;
148
+ stop(): void;
149
+ }
150
+
151
+ export function createRouteRounds(host: RouteRoundHost): RouteRounds {
152
+ const links = new Map<string, LinkRoutes>();
153
+ let tokens = 0;
154
+ let client: ClientState = { kind: "unknown" };
155
+ let clientEpoch = 0;
156
+ let stopped = false;
157
+
158
+ const isMultiRoute = (record: LinkRecord): boolean => record.direction === "hub-initiated" && effectiveLinkRoutes(record).length > 1;
159
+
160
+ const linkFor = (record: LinkRecord): LinkRoutes => {
161
+ let link = links.get(record.id);
162
+ if (!link) { link = { books: new Map(), blocked: null }; links.set(record.id, link); }
163
+ const names = effectiveLinkRoutes(record);
164
+ for (const name of names) if (!link.books.has(name)) link.books.set(name, { name, outcome: null, outcomeAt: null, probeFailures: 0, tunnelFailures: 0, eligibleAt: 0 });
165
+ for (const name of [...link.books.keys()]) if (!names.includes(name)) link.books.delete(name);
166
+ return link;
167
+ };
168
+
169
+ const current = (linkId: string, round: Round): boolean => !stopped && links.get(linkId)?.round === round && !host.blocked(linkId);
170
+
171
+ const fail = (link: LinkRoutes, route: string, outcome: RouteOutcomeClass, kind: "probe" | "tunnel"): void => {
172
+ const book = link.books.get(route);
173
+ if (!book) return;
174
+ const n = kind === "probe" ? ++book.probeFailures : ++book.tunnelFailures;
175
+ book.outcome = outcome;
176
+ book.outcomeAt = host.now();
177
+ book.eligibleAt = host.now() + routeCooldownMs(outcome, n, host.random);
178
+ };
179
+
180
+ const minEligible = (link: LinkRoutes): number => Math.min(...[...link.books.values()].map(book => book.eligibleAt));
181
+
182
+ const aggregate = (link: LinkRoutes): StderrClass => aggregateRouteClass([...link.books.values()].map(book => book.outcome));
183
+
184
+ /** The round is over without a proven route: one reducer exit with the aggregate class. */
185
+ const endRound = (linkId: string, link: LinkRoutes): void => {
186
+ link.round = undefined;
187
+ host.routeProof?.forget(linkId);
188
+ const cls = aggregate(link);
189
+ host.setEvent(linkId, { type: "exit", now: host.now(), stderrClass: cls }, exitCause(cls));
190
+ host.deferRetry(linkId, minEligible(link));
191
+ };
192
+
193
+ const next = (linkId: string, link: LinkRoutes, round: Round): void => {
194
+ if (!current(linkId, round)) return;
195
+ if (host.busy()) {
196
+ round.phase = { kind: "deferred" };
197
+ round.resume = () => next(linkId, link, round);
198
+ return;
199
+ }
200
+ const record = host.record(linkId);
201
+ if (!record) { link.round = undefined; return; }
202
+ const route = round.queue.shift();
203
+ if (route === undefined) { endRound(linkId, link); return; }
204
+ if (!link.books.has(route)) { next(linkId, link, round); return; }
205
+ probe(linkId, link, round, record, route);
206
+ };
207
+
208
+ const probe = (linkId: string, link: LinkRoutes, round: Round, record: LinkRecord, route: string): void => {
209
+ const abort = new AbortController();
210
+ const phase: Phase = { kind: "probe", route, startedAt: host.now(), abort };
211
+ round.phase = phase;
212
+ let argv: string[];
213
+ try {
214
+ argv = buildRouteProbeArgv({ alias: record.alias, destination: route, knownHostsFile: host.knownHostsFile(), route: record.explicitRoute ?? null });
215
+ } catch {
216
+ fail(link, route, "transient", "probe");
217
+ next(linkId, link, round);
218
+ return;
219
+ }
220
+ void host.runner.run(argv, { timeoutMs: ROUTE_PROBE_MS, signal: abort.signal }).then(result => {
221
+ if (!current(linkId, round) || round.phase !== phase) return;
222
+ // Past its deadline on the supervisor clock, a result is a timeout even if the tick has not run yet.
223
+ const inTime = host.now() < phase.startedAt + ROUTE_PROBE_MS;
224
+ if (inTime && result.code === 0 && result.stdout.trim() === "ocx-link-probe") {
225
+ const book = link.books.get(route);
226
+ if (book) book.probeFailures = 0;
227
+ if (host.busy()) {
228
+ const deferred: Phase = { kind: "deferred" };
229
+ round.phase = deferred;
230
+ round.resume = () => { if (current(linkId, round) && round.phase === deferred) candidate(linkId, link, round, route); };
231
+ } else {
232
+ candidate(linkId, link, round, route);
233
+ }
234
+ return;
235
+ }
236
+ // A late answer is a timeout whatever it says: a late host-key or auth message never decides the route.
237
+ fail(link, route, !inTime || result.code === 0 ? "transient" : routeOutcomeOfStderr(result.stderr), "probe");
238
+ next(linkId, link, round);
239
+ }, () => {
240
+ if (!current(linkId, round) || round.phase !== phase) return;
241
+ fail(link, route, "transient", "probe");
242
+ next(linkId, link, round);
243
+ });
244
+ };
245
+
246
+ const candidate = (linkId: string, link: LinkRoutes, round: Round, route: string): void => {
247
+ const record = host.record(linkId);
248
+ const listenerPort = host.listenerPort();
249
+ if (!record || listenerPort === null) { endRound(linkId, link); return; }
250
+ let phase: Extract<Phase, { kind: "candidate" }> | undefined;
251
+ const tap = composeGrantTap(record.tunnelPort, listenerPort, verdict => {
252
+ if (!phase || round.phase !== phase) return;
253
+ if (verdict === "refused") { phase.refused = true; return; }
254
+ if (phase.grantedAt === undefined) { phase.grantedAt = host.now(); phase.proof.nextAt = host.now(); }
255
+ }, host.captureTap(linkId));
256
+ let spawned: { child: SshChild; generation: string };
257
+ let setupFailed = false;
258
+ try {
259
+ const result = host.spawnTunnel(record, route, tap);
260
+ spawned = result;
261
+ setupFailed = result.setupFailed === true;
262
+ } catch {
263
+ fail(link, route, "transient", "tunnel");
264
+ next(linkId, link, round);
265
+ return;
266
+ }
267
+ phase = { kind: "candidate", route, child: spawned.child, generation: spawned.generation, spawnedAt: host.now(), abort: new AbortController(), proof: { inFlight: false, nextAt: Number.POSITIVE_INFINITY } };
268
+ round.phase = phase;
269
+ // The tunnel started but could not be recorded: stop it and wait for its exit before moving on.
270
+ if (setupFailed) stopCandidate(linkId, phase, "transient");
271
+ };
272
+
273
+ /** Stop a candidate that failed as a route (today's reconnect contract for anything on it). */
274
+ const stopCandidate = (linkId: string, phase: Extract<Phase, { kind: "candidate" }>, failure: RouteOutcomeClass): void => {
275
+ if (phase.stopAt !== undefined) return;
276
+ phase.failure = failure;
277
+ phase.stopAt = host.now();
278
+ phase.abort.abort();
279
+ phase.proof.handle?.dispose();
280
+ host.routeProof?.forget(linkId);
281
+ try { phase.child.kill("SIGTERM"); } catch { /* already gone */ }
282
+ };
283
+
284
+ /**
285
+ * Until the grant: READY_PROOF_MS from spawn. After it: READY_PROOF_MS from the grant, and a grant
286
+ * seen after that first deadline (before the next tick stopped the candidate) counts from it, so the
287
+ * deadline is never later than spawn + 2 x READY_PROOF_MS.
288
+ */
289
+ const readinessDeadline = (phase: Extract<Phase, { kind: "candidate" }>): number =>
290
+ (phase.grantedAt === undefined ? phase.spawnedAt : Math.min(phase.grantedAt, phase.spawnedAt + READY_PROOF_MS)) + READY_PROOF_MS;
291
+
292
+ const proven = (linkId: string, link: LinkRoutes, round: Round, phase: Extract<Phase, { kind: "candidate" }>): void => {
293
+ // A child whose exit was already observed is never promoted, however late its proof settles.
294
+ if (!host.ownsChild(linkId, phase.child)) return;
295
+ phase.proof.handle?.dispose();
296
+ host.routeProof?.forget(linkId);
297
+ link.round = undefined;
298
+ link.active = { route: phase.route, child: phase.child, since: host.now() };
299
+ const book = link.books.get(phase.route);
300
+ if (book) { book.tunnelFailures = 0; book.probeFailures = 0; book.outcome = null; book.outcomeAt = null; book.eligibleAt = 0; }
301
+ host.setEvent(linkId, { type: "ready", now: host.now() });
302
+ void round;
303
+ };
304
+
305
+ const execOnRoute = (record: LinkRecord, route: string, argv: readonly string[], deadline: number, signal: AbortSignal, maxOutputBytes?: number) =>
306
+ host.runner.run(buildExecArgv({ alias: record.alias, destination: route, argv, knownHostsFile: host.knownHostsFile(), route: record.explicitRoute ?? null }), {
307
+ timeoutMs: Math.max(1, Math.ceil(deadline - host.now())),
308
+ signal,
309
+ ...(maxOutputBytes === undefined ? {} : { maxOutputBytes }),
310
+ });
311
+
312
+ /** One readiness attempt: discovery and identity once per candidate, then a correlated trigger. */
313
+ const attempt = async (linkId: string, link: LinkRoutes, round: Round, phase: Extract<Phase, { kind: "candidate" }>): Promise<void> => {
314
+ const record = host.record(linkId);
315
+ if (!record) return;
316
+ const live = (): boolean => current(linkId, round) && round.phase === phase && phase.stopAt === undefined
317
+ && host.ownsChild(linkId, phase.child);
318
+ const candidateDeadline = readinessDeadline(phase);
319
+ const { proof, abort } = phase;
320
+ try {
321
+ if (!proof.platform) {
322
+ proof.platform = record.remotePlatform ?? await requireRemotePlatform(host.runner, record.alias, record.explicitRoute ?? null, host.knownHostsFile(), {
323
+ destination: phase.route, timeoutMs: Math.max(1, Math.min(10_000, Math.ceil(candidateDeadline - host.now()))), signal: abort.signal,
324
+ });
325
+ if (!live()) return;
326
+ }
327
+ if (proof.port === undefined) {
328
+ const configured = await execOnRoute(record, phase.route, remoteOcxArgv(["config", "show", "--json"], proof.platform), candidateDeadline, abort.signal, CONFIG_MAX_BYTES);
329
+ if (!live()) return;
330
+ const port = configured.code === 0 ? childPortOf(configured.stdout) : undefined;
331
+ if (port === undefined) return;
332
+ proof.port = port;
333
+ }
334
+ if (!proof.healthy) {
335
+ const health = await execOnRoute(record, phase.route, remoteChildHttpArgv(proof.port, "healthz", candidateDeadline - host.now(), proof.platform), candidateDeadline, abort.signal);
336
+ if (!live()) return;
337
+ let body: unknown = null;
338
+ try { body = health.code === 0 ? parseChildHttp(health.stdout) : null; } catch { body = null; }
339
+ if (!isChildHealth(body, "client", proof.port)) return;
340
+ proof.healthy = true;
341
+ }
342
+ if (!host.routeProof) return;
343
+ const attemptDeadline = Math.min(host.now() + PROOF_ATTEMPT_MS, candidateDeadline);
344
+ const proofId = randomBytes(16).toString("hex");
345
+ proof.handle?.dispose();
346
+ proof.handle = host.routeProof.register({ linkId, apiKeyId: record.apiKeyId, generation: phase.generation, proofId, expiresAt: attemptDeadline });
347
+ const catalog = await execOnRoute(record, phase.route,
348
+ remoteChildHttpArgv(proof.port, "v1/catalog", attemptDeadline - host.now(), proof.platform, proofId), attemptDeadline, abort.signal, CATALOG_MAX_BYTES);
349
+ if (!live()) return;
350
+ let body: unknown = null;
351
+ try { body = catalog.code === 0 ? parseChildHttp(catalog.stdout) : null; } catch { body = null; }
352
+ const handle = proof.handle;
353
+ // Both deadlines hold at promotion too: a result that settles late, before the next tick, does not count.
354
+ const settledAt = host.now();
355
+ if (isCatalog(body) && handle?.admitted() && settledAt <= attemptDeadline && settledAt < candidateDeadline) {
356
+ proven(linkId, link, round, phase);
357
+ return;
358
+ }
359
+ } catch { /* a failed or aborted step; retried below while time remains */ }
360
+ finally {
361
+ proof.inFlight = false;
362
+ proof.nextAt = host.now() + PROOF_RETRY_MS;
363
+ }
364
+ };
365
+
366
+ const startClientCheck = (): void => {
367
+ if (client.kind === "checking") return;
368
+ const abort = new AbortController();
369
+ const epoch = ++clientEpoch;
370
+ client = { kind: "checking", abort, epoch };
371
+ void host.runner.run(["ssh", "-V"], { timeoutMs: CLIENT_CHECK_MS, signal: abort.signal }).then(result => {
372
+ if (stopped || clientEpoch !== epoch) return;
373
+ client = result.code === 0 && /OpenSSH/.test(result.stderr + result.stdout) ? { kind: "ok" } : { kind: "unsupported", at: host.now() };
374
+ }, () => {
375
+ if (stopped || clientEpoch !== epoch) return;
376
+ client = { kind: "unsupported", at: host.now() };
377
+ });
378
+ };
379
+
380
+ /** A round waiting for the client answer, or a fresh round that may need it. */
381
+ const proceed = (linkId: string, link: LinkRoutes, round: Round): void => {
382
+ if (client.kind === "unsupported" && host.now() >= client.at + CLIENT_RECHECK_MS) client = { kind: "unknown" };
383
+ if (client.kind === "unknown") startClientCheck();
384
+ if (client.kind === "checking") { round.phase = { kind: "client" }; return; }
385
+ if (client.kind === "unsupported") {
386
+ link.round = undefined;
387
+ link.blocked = "ssh_client_unsupported";
388
+ host.setEvent(linkId, { type: "exit", now: host.now(), stderrClass: "network" }, "unknown");
389
+ host.deferRetry(linkId, client.at + CLIENT_RECHECK_MS);
390
+ return;
391
+ }
392
+ if (link.blocked === "ssh_client_unsupported") link.blocked = null;
393
+ next(linkId, link, round);
394
+ };
395
+
396
+ return {
397
+ isMultiRoute,
398
+ begin(record) {
399
+ if (!isMultiRoute(record)) return false;
400
+ if (stopped || host.blocked(record.id)) return true;
401
+ const link = linkFor(record);
402
+ if (link.round || link.active) return true;
403
+ const now = host.now();
404
+ const queue = effectiveLinkRoutes(record).filter(name => (link.books.get(name)?.eligibleAt ?? 0) <= now);
405
+ if (queue.length === 0) { host.deferRetry(record.id, minEligible(link)); return true; }
406
+ const round: Round = { token: ++tokens, queue, phase: { kind: "client" } };
407
+ link.round = round;
408
+ host.attempted(record.id);
409
+ host.setEvent(record.id, { type: "spawn", now });
410
+ proceed(record.id, link, round);
411
+ return true;
412
+ },
413
+ tick(linkId) {
414
+ const link = links.get(linkId);
415
+ const round = link?.round;
416
+ if (!link || !round || stopped) return;
417
+ const now = host.now();
418
+ const phase = round.phase;
419
+ if (round.resume && !host.busy()) {
420
+ const resume = round.resume;
421
+ round.resume = undefined;
422
+ resume();
423
+ return;
424
+ }
425
+ if (phase.kind === "client") { if (client.kind !== "checking") proceed(linkId, link, round); return; }
426
+ if (phase.kind === "probe") {
427
+ if (now - phase.startedAt >= ROUTE_PROBE_MS) {
428
+ phase.abort.abort();
429
+ fail(link, phase.route, "transient", "probe");
430
+ next(linkId, link, round);
431
+ }
432
+ return;
433
+ }
434
+ if (phase.kind === "halted" || phase.kind === "deferred") return;
435
+ if (phase.stopAt !== undefined) {
436
+ if (!phase.killed && now - phase.stopAt >= CANDIDATE_KILL_GRACE_MS) {
437
+ phase.killed = true;
438
+ try { phase.child.kill("SIGKILL"); } catch { /* already gone */ }
439
+ }
440
+ if (now - phase.stopAt >= 2 * CANDIDATE_KILL_GRACE_MS) {
441
+ // The stopped candidate's exit was never observed: fail closed until it is.
442
+ round.phase = { kind: "halted", route: phase.route, child: phase.child, failure: phase.failure ?? "readiness" };
443
+ link.blocked = "stop_unconfirmed";
444
+ host.warn(`[link] route candidate exit unconfirmed link=${linkId}`);
445
+ }
446
+ return;
447
+ }
448
+ if (now >= readinessDeadline(phase)) {
449
+ // Unlike a one-route tunnel, which reads connected after its 5 s grace and is never stopped
450
+ // for lacking proof, a candidate with no proof by now is stopped: a granted forward whose
451
+ // relay cannot authenticate or serve looks the same as a slow one, and keeping it would
452
+ // starve the next route forever. A request already on it fails toward its caller, as on
453
+ // any reconnect; once a route is proven it is never stopped for lack of later proofs.
454
+ stopCandidate(linkId, phase, phase.grantedAt === undefined ? "grant_unobserved" : "readiness");
455
+ return;
456
+ }
457
+ if (phase.grantedAt !== undefined && !phase.proof.inFlight && now >= phase.proof.nextAt) {
458
+ phase.proof.inFlight = true;
459
+ void attempt(linkId, link, round, phase);
460
+ }
461
+ },
462
+ exited(linkId, child, stderr) {
463
+ const link = links.get(linkId);
464
+ if (!link) return false;
465
+ if (link.active?.child === child) {
466
+ const route = link.active.route;
467
+ link.active = undefined;
468
+ fail(link, route, routeOutcomeOfStderr(stderr), "tunnel");
469
+ if (!stopped) endRoundAfterActive(linkId, link);
470
+ return true;
471
+ }
472
+ const round = link.round;
473
+ const phase = round?.phase;
474
+ if (!round || !phase || (phase.kind !== "candidate" && phase.kind !== "halted") || phase.child !== child) return false;
475
+ const failure = phase.kind === "halted" ? phase.failure
476
+ : phase.failure ?? (phase.refused ? "forward" : routeOutcomeOfStderr(stderr));
477
+ if (phase.kind === "candidate") { phase.abort.abort(); phase.proof.handle?.dispose(); }
478
+ host.routeProof?.forget(linkId);
479
+ if (link.blocked === "stop_unconfirmed") link.blocked = null;
480
+ fail(link, phase.route, failure, "tunnel");
481
+ if (!stopped && !host.blocked(linkId)) next(linkId, link, round);
482
+ return true;
483
+ },
484
+ cancel(linkId) {
485
+ const link = links.get(linkId);
486
+ if (!link) return;
487
+ const phase = link.round?.phase;
488
+ if (phase?.kind === "probe" || phase?.kind === "candidate") phase.abort.abort();
489
+ if (phase?.kind === "candidate") phase.proof.handle?.dispose();
490
+ link.round = undefined;
491
+ link.active = undefined;
492
+ if (link.blocked === "stop_unconfirmed") link.blocked = null;
493
+ host.routeProof?.forget(linkId);
494
+ },
495
+ forget(linkId) {
496
+ this.cancel(linkId);
497
+ links.delete(linkId);
498
+ },
499
+ routesChanged(record) {
500
+ const link = links.get(record.id);
501
+ if (!link) return;
502
+ linkFor(record);
503
+ const round = link.round;
504
+ if (round?.phase.kind === "probe" || round?.phase.kind === "client" || round?.phase.kind === "deferred") {
505
+ // Nothing carries traffic yet: start over on the new list.
506
+ if (round.phase.kind === "probe") round.phase.abort.abort();
507
+ round.resume = undefined;
508
+ round.queue = effectiveLinkRoutes(record).filter(name => (link.books.get(name)?.eligibleAt ?? 0) <= host.now());
509
+ proceed(record.id, link, round);
510
+ return;
511
+ }
512
+ if (round) round.queue = round.queue.filter(name => link.books.has(name));
513
+ },
514
+ adopt(record, child, connectedSince) {
515
+ if (!isMultiRoute(record)) return;
516
+ const link = linkFor(record);
517
+ if (link.round || link.active) return;
518
+ if (connectedSince !== null) link.active = { route: record.alias, child, since: connectedSince };
519
+ },
520
+ liveRoute(linkId) {
521
+ const link = links.get(linkId);
522
+ const phase = link?.round?.phase;
523
+ return link?.active?.route ?? (phase && (phase.kind === "candidate" || phase.kind === "halted") ? phase.route : undefined);
524
+ },
525
+ inRound(linkId) {
526
+ return links.get(linkId)?.round !== undefined;
527
+ },
528
+ status(linkId) {
529
+ const link = links.get(linkId);
530
+ const record = host.record(linkId);
531
+ if (!link || !record) return undefined;
532
+ const names = effectiveLinkRoutes(record);
533
+ return {
534
+ routes: names.map(name => {
535
+ const book = link.books.get(name);
536
+ return {
537
+ name,
538
+ eligibleAt: book && book.eligibleAt > host.now() ? book.eligibleAt : null,
539
+ lastOutcome: book?.outcome && book.outcomeAt !== null ? { class: book.outcome, at: book.outcomeAt } : null,
540
+ };
541
+ }),
542
+ route: link.active ? { name: link.active.route, index: names.indexOf(link.active.route), since: link.active.since } : null,
543
+ blocked: link.blocked,
544
+ };
545
+ },
546
+ recheckClient() {
547
+ if (client.kind === "checking") client.abort.abort();
548
+ clientEpoch += 1;
549
+ client = { kind: "unknown" };
550
+ },
551
+ stop() {
552
+ stopped = true;
553
+ if (client.kind === "checking") client.abort.abort();
554
+ for (const linkId of [...links.keys()]) this.cancel(linkId);
555
+ },
556
+ };
557
+
558
+ function endRoundAfterActive(linkId: string, link: LinkRoutes): void {
559
+ const cls = aggregate(link);
560
+ host.setEvent(linkId, { type: "exit", now: host.now(), stderrClass: cls }, exitCause(cls));
561
+ host.deferRetry(linkId, minEligible(link));
562
+ }
563
+ }
564
+
565
+ function childPortOf(stdout: string): number | undefined {
566
+ try {
567
+ const value: unknown = JSON.parse(stdout);
568
+ if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
569
+ const port = (value as Record<string, unknown>).port;
570
+ return typeof port === "number" && Number.isInteger(port) && port >= 1 && port <= 65535 ? port : undefined;
571
+ } catch {
572
+ return undefined;
573
+ }
574
+ }
575
+
576
+ function isCatalog(value: unknown): boolean {
577
+ return !!value && typeof value === "object" && !Array.isArray(value) && Array.isArray((value as Record<string, unknown>).models);
578
+ }
579
+
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Rules for a link with several routes, as pure functions: per-route cooldowns, the one class a
3
+ * multi-route link reports to the tunnel reducer, and reading OpenSSH's own confirmation that the
4
+ * remote listener was granted to this tunnel. Nothing here starts a process, a timer or reads a
5
+ * clock; the supervisor feeds outcomes in.
6
+ */
7
+ import { sshLineClassifies } from "./ssh-capture-redact";
8
+ import { classifySshStderr, nextDelayMs, type StderrClass } from "./tunnel-state";
9
+
10
+ /**
11
+ * What one route did last. transient: network, timeout, unknown, probe deadline. readiness: the
12
+ * correlated readiness proof did not pass in time. grant_unobserved: the candidate lived to its
13
+ * deadline without OpenSSH confirming or refusing its remote listener.
14
+ */
15
+ export type RouteOutcomeClass = "transient" | "readiness" | "grant_unobserved" | "forward" | "auth" | "hostkey";
16
+
17
+ const FORWARD_COOLDOWN_MS = 60_000;
18
+ const AUTH_COOLDOWN_MS = 5 * 60_000;
19
+ const HOSTKEY_COOLDOWN_MS = 10 * 60_000;
20
+
21
+ /**
22
+ * How long a route rests after its consecutive failure number `failures` (1 for the first).
23
+ * Transient outcomes use today's reconnect backoff; forward and auth keep the Home's flat retry
24
+ * policy per route; a host-key refusal rests ten minutes and is retried only under strict checking.
25
+ */
26
+ export function routeCooldownMs(outcome: RouteOutcomeClass, failures: number, random: () => number = Math.random): number {
27
+ switch (outcome) {
28
+ case "forward": return FORWARD_COOLDOWN_MS;
29
+ case "auth": return AUTH_COOLDOWN_MS;
30
+ case "hostkey": return HOSTKEY_COOLDOWN_MS;
31
+ default: return nextDelayMs(Math.max(1, failures), random);
32
+ }
33
+ }
34
+
35
+ /** A failed probe's or tunnel's stderr, as a route outcome. */
36
+ export function routeOutcomeOfStderr(stderr: string): RouteOutcomeClass {
37
+ const cls = classifySshStderr(stderr);
38
+ if (cls === "hostkey" || cls === "auth") return cls;
39
+ if (cls === "forward" || cls === "remote_forward") return "forward";
40
+ return "transient";
41
+ }
42
+
43
+ const RECOVERABILITY: readonly RouteOutcomeClass[] = ["hostkey", "auth", "forward"];
44
+
45
+ /**
46
+ * The single class a multi-route link reports to the reducer: the most recoverable latest outcome
47
+ * over every route, cooling ones included. A route's outcome is the last failure it recorded and
48
+ * stays until that route is tried again or proven, so a route still resting after a host-key
49
+ * refusal (up to 10 minutes) counts as hostkey however old that refusal is. A route never tried
50
+ * counts as transient. Only a link whose every route's latest outcome refused the pinned key is
51
+ * terminal.
52
+ */
53
+ export function aggregateRouteClass(outcomes: readonly (RouteOutcomeClass | null)[]): StderrClass {
54
+ if (outcomes.length === 0) return "network";
55
+ let best = -1;
56
+ for (const outcome of outcomes) {
57
+ const rank = outcome === null ? -1 : RECOVERABILITY.indexOf(outcome);
58
+ // Anything not listed (transient, readiness, grant_unobserved, never tried) is retried on the transient cadence.
59
+ if (rank === -1) return "network";
60
+ best = Math.max(best, rank);
61
+ }
62
+ return RECOVERABILITY[best] as StderrClass;
63
+ }
64
+
65
+ /** OpenSSH's own debug1 line (clientloop.c): "remote forward %s for: listen %s%s%d, connect %s:%d". */
66
+ const GRANT_LINE = /^debug1: remote forward (success|failure) for: listen 127\.0\.0\.1:(\d{1,5}), connect 127\.0\.0\.1:(\d{1,5})$/;
67
+
68
+ /** granted or refused when the line is OpenSSH's answer for exactly this forward; otherwise null. */
69
+ export function parseForwardGrant(line: string, tunnelPort: number, listenerPort: number): "granted" | "refused" | null {
70
+ const match = GRANT_LINE.exec(line.endsWith("\r") ? line.slice(0, -1) : line);
71
+ if (!match || Number(match[2]) !== tunnelPort || Number(match[3]) !== listenerPort) return null;
72
+ return match[1] === "success" ? "granted" : "refused";
73
+ }
74
+
75
+ /**
76
+ * The stderr tap of a multi-route candidate (it runs with LogLevel=DEBUG1). The grant observer sees
77
+ * every line first and can neither throw nor change anything; the keep decision is exactly today's:
78
+ * the operator's capture tap when a capture window is open, otherwise sshLineClassifies, so only
79
+ * lines ssh prints at LogLevel=ERROR reach the exit classifier.
80
+ */
81
+ export function composeGrantTap(
82
+ tunnelPort: number,
83
+ listenerPort: number,
84
+ observe: (verdict: "granted" | "refused") => void,
85
+ capture?: (line: string) => boolean,
86
+ ): (line: string) => boolean {
87
+ return line => {
88
+ try {
89
+ const verdict = parseForwardGrant(line, tunnelPort, listenerPort);
90
+ if (verdict) observe(verdict);
91
+ } catch { /* an observer failure changes nothing */ }
92
+ return capture ? capture(line) : sshLineClassifies(line);
93
+ };
94
+ }
95
+