@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,103 @@
1
+ import { recoverRemoteChild } from "../../link/link-recover";
2
+ import { operationRecoveryResolver, type LinkRecoveryTarget } from "../../link/operation-recovery-slot";
3
+ import { readTombstones, removeTombstone, tombstonesPath } from "../../link/tombstones";
4
+ import { readLinkRetirement } from "../../link/retirement";
5
+ import { effectiveLinkRoutes } from "../../link/store";
6
+ import { withConfigMutationLockSync } from "../../config/mutation-lock";
7
+ import type { ManagementContext } from "./context";
8
+ import { readManagementJsonBodyOr } from "./body";
9
+ import { serialized } from "./link-enrollment";
10
+ import { underAliasLock } from "./link-operation";
11
+ import { fail, isRecord, knownHostsFile, readStoreFor, runnerFor, type LinkRouteState } from "./link-route-state";
12
+
13
+ const LINK_ID = /^lnk_[0-9a-f]{16}$/;
14
+ const OPERATION_ID = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$/;
15
+
16
+ const noStore = { headers: { "cache-control": "no-store" } };
17
+
18
+ /** GET /api/link/recover: the forced revokes still waiting for cleanup (no fingerprints, no routes). */
19
+ export function handleLinkRecoverList(): Response {
20
+ let store;
21
+ try { store = readTombstones(tombstonesPath()); } catch {
22
+ return fail("tombstone_store_unreadable", "The link tombstone file cannot be read; it was left as it is.", 503);
23
+ }
24
+ return Response.json({
25
+ tombstones: store.tombstones.map(t => ({ linkId: t.linkId, alias: t.alias, revokedAt: t.revokedAt, ...(t.remotePlatform ? { remotePlatform: t.remotePlatform } : {}) })),
26
+ }, noStore);
27
+ }
28
+
29
+ /**
30
+ * POST /api/link/recover {linkId} | {operationId}: clean an ephemeral Child a forced revoke (a
31
+ * tombstone) or an interrupted enrollment (the O1 journal) left behind. The tombstone or journal
32
+ * entry is settled only on the Child's receipt bound to that link.
33
+ */
34
+ export async function handleLinkRecover(ctx: ManagementContext, state: LinkRouteState): Promise<Response> {
35
+ const body = await readManagementJsonBodyOr(ctx.req, null);
36
+ const fields: Record<string, unknown> = isRecord(body) ? body : {};
37
+ const keys = Object.keys(fields);
38
+ const only = (key: string, pattern: RegExp): string | null => {
39
+ const value = fields[key];
40
+ return keys.length === 1 && keys[0] === key && typeof value === "string" && pattern.test(value) ? value : null;
41
+ };
42
+ const linkId = only("linkId", LINK_ID);
43
+ const operationId = only("operationId", OPERATION_ID);
44
+ if (!linkId && !operationId) return fail("invalid_body", "Send exactly one of linkId (lnk_ and 16 hex digits) or operationId.", 400);
45
+
46
+ let target: LinkRecoveryTarget;
47
+ if (linkId) {
48
+ if (readStoreFor(ctx).links.some(link => link.id === linkId)) {
49
+ return fail("link_present", "This link still exists; revoke it with --purge instead.", 409);
50
+ }
51
+ let found;
52
+ try { found = readTombstones(tombstonesPath()).tombstones.find(t => t.linkId === linkId); } catch {
53
+ return fail("tombstone_store_unreadable", "The link tombstone file cannot be read; it was left as it is.", 503);
54
+ }
55
+ if (!found) return fail("tombstone_not_found", "No forced revoke of this link is waiting for cleanup.", 404);
56
+ target = {
57
+ linkId: found.linkId, alias: found.alias, hostKeyFingerprint: found.hostKeyFingerprint,
58
+ ...(found.remotePlatform ? { remotePlatform: found.remotePlatform } : {}),
59
+ ...(found.explicitRoute ? { explicitRoute: found.explicitRoute } : {}),
60
+ };
61
+ } else {
62
+ const resolver = operationRecoveryResolver();
63
+ if (!resolver) return fail("operation_journal_unavailable", "This Home has no link operation journal; recover by --link-id.", 409);
64
+ const lookup = resolver.lookup(operationId!);
65
+ if (lookup.kind === "not_found") return fail("operation_not_found", "No link operation has this id.", 404);
66
+ if (lookup.kind === "not_residual") return fail("operation_not_residual", "This link operation left nothing on its Child to recover.", 409);
67
+ target = lookup.target;
68
+ }
69
+
70
+ // Under the alias lock enrollment and revoke take (src/link/alias-lock.ts, across processes) and the per-alias
71
+ // operation set within this runtime, both keyed without case.
72
+ return underAliasLock(ctx, target.alias, true, () => serialized(state, target.alias, async () => {
73
+ // Under the lock a removal of this link takes: the link must still be gone, and its removal finished. A retirement
74
+ // receipt still outstanding (#8416) means the revoke has not settled; recovering now would let its retry act on a
75
+ // Child already cleaned (and, before, write a fresh tombstone for it).
76
+ if (readStoreFor(ctx).links.some(link => link.id === target.linkId)) {
77
+ return fail("link_present", "This link still exists; revoke it with --purge instead.", 409);
78
+ }
79
+ let pending: boolean;
80
+ try { pending = readLinkRetirement(target.linkId) !== null; } catch { pending = true; }
81
+ if (pending) {
82
+ return fail("link_retirement_pending", "This link's removal is unfinished; repeat ocx link revoke for it to finish, then recover.", 409);
83
+ }
84
+ // A Home-initiated link that still names this alias may own the Child now: a re-enrollment, or one whose
85
+ // revoke ran its disconnect but did not commit (journalled or not). Recover would then settle the old
86
+ // link and purge the binary under it, so it waits until no such link exists. Read under the lock. Every route a
87
+ // link may reach the machine by counts, not only its primary alias (effectiveLinkRoutes).
88
+ const wanted = target.alias.toLowerCase();
89
+ if (readStoreFor(ctx).links.some(link => link.direction === "hub-initiated"
90
+ && [link.alias, ...effectiveLinkRoutes(link)].some(route => route.toLowerCase() === wanted))) {
91
+ return fail("alias_linked", "A link to this machine's alias still exists, so its Child may belong to that link. Leave that link: no status check on the machine can show it is stale, since an attach of it still in progress can show no link or an earlier one, and state that cannot be read shows none. This tombstone waits until that link is removed; then run ocx link recover again. Revoking that link (after settling any open operation on it) ends it and disconnects the machine if the machine runs it, so do that only if you mean to end that link. A person on this Home can instead forget this tombstone once the machine is confirmed clean or gone.", 409);
92
+ }
93
+ const outcome = await recoverRemoteChild(runnerFor(ctx), target, knownHostsFile(ctx));
94
+ if (!outcome.ok) return fail(outcome.code, outcome.message, outcome.status, outcome.hint);
95
+ try {
96
+ withConfigMutationLockSync(() => { removeTombstone(target.linkId, tombstonesPath()); });
97
+ if (operationId) operationRecoveryResolver()?.settle(operationId);
98
+ } catch {
99
+ return fail("tombstone_remove_failed", "The Child was cleaned, but its tombstone could not be removed; run recover again.", 503);
100
+ }
101
+ return Response.json({ linkId: target.linkId, outcome: "clean", purged: outcome.purged }, noStore);
102
+ }));
103
+ }
@@ -0,0 +1,173 @@
1
+ /**
2
+ * GET and POST /api/link/{id}/routes: list, add, remove and reorder a Home-initiated link's routes
3
+ * (structure/remote-link.md, "Routes"). The pin never changes here: alias, hostKeyFingerprint and the
4
+ * link known_hosts file are only read. A new route is stored only after it proved the pinned key
5
+ * over itself, against a private snapshot of the one pinned line. Responses carry fixed codes and a
6
+ * class word, never ssh output.
7
+ */
8
+ import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
9
+ import { tmpdir } from "node:os";
10
+ import { join } from "node:path";
11
+ import { withConfigMutationLockSync } from "../../config/mutation-lock";
12
+ import { checkRouteTrust } from "../../link/route-trust";
13
+ import { routeOutcomeOfStderr } from "../../link/route-select";
14
+ import { buildRouteProbeArgv, isSshAlias } from "../../link/ssh-argv";
15
+ import { effectiveLinkRoutes, MAX_LINK_ROUTES, type LinkRecord } from "../../link/store";
16
+ import type { ManagementContext } from "./context";
17
+ import { readManagementJsonBodyOr } from "./body";
18
+ import { serialized } from "./link-enrollment";
19
+ import { exactBody, fail, knownHostsFile, readStoreFor, runnerFor, writeStoreFor, type LinkRouteState } from "./link-route-state";
20
+
21
+ const LINK_ID = /^lnk_[0-9a-f]{16}$/;
22
+ export const ROUTE_PROBE_TIMEOUT_MS = 15_000;
23
+
24
+ type Edit =
25
+ | { op: "add"; route: string; position?: number }
26
+ | { op: "remove"; route: string }
27
+ | { op: "order"; routes: string[] };
28
+
29
+ /** The fields a route edit proves against: a change to any of them means another link now. */
30
+ const IDENTITY = ["id", "alias", "direction", "hostKeyFingerprint", "tunnelPort", "apiKeyId", "createdAt"] as const;
31
+
32
+ function sameIdentity(left: LinkRecord, right: LinkRecord): boolean {
33
+ return IDENTITY.every(key => left[key] === right[key]);
34
+ }
35
+
36
+ function sameList(left: readonly string[], right: readonly string[]): boolean {
37
+ return left.length === right.length && left.every((value, index) => value === right[index]);
38
+ }
39
+
40
+ function routesBody(record: LinkRecord): { linkId: string; pin: string; routes: string[]; exclusive?: true } {
41
+ return { linkId: record.id, pin: record.alias, routes: effectiveLinkRoutes(record), ...(record.exclusive ? { exclusive: true as const } : {}) };
42
+ }
43
+
44
+ /** An exclusive link has one route, its alias, fixed at enrollment (structure/remote-link.md, "Explicit route"). */
45
+ function exclusiveRefusal(): Response {
46
+ return fail("link_exclusive", "This link is exclusive: its one route is fixed, so routes cannot be added, removed or reordered.", 409);
47
+ }
48
+
49
+ function document(record: LinkRecord): Response {
50
+ return Response.json(routesBody(record), { headers: { "cache-control": "no-store" } });
51
+ }
52
+
53
+ function parseEdit(value: unknown): Edit | null {
54
+ const add = exactBody(value, ["op", "route"]) ?? exactBody(value, ["op", "route", "position"]);
55
+ if (add && (add.op === "add" || add.op === "remove") && typeof add.route === "string" && isSshAlias(add.route)) {
56
+ if (add.op === "remove") return "position" in add ? null : { op: "remove", route: add.route };
57
+ if (add.position !== undefined && (typeof add.position !== "number" || !Number.isInteger(add.position) || add.position < 0)) return null;
58
+ return { op: "add", route: add.route, ...(add.position === undefined ? {} : { position: add.position as number }) };
59
+ }
60
+ const order = exactBody(value, ["op", "routes"]);
61
+ if (order && order.op === "order" && Array.isArray(order.routes) && order.routes.length >= 1 && order.routes.length <= MAX_LINK_ROUTES
62
+ && order.routes.every(route => typeof route === "string" && isSshAlias(route))) {
63
+ return { op: "order", routes: [...order.routes as string[]] };
64
+ }
65
+ return null;
66
+ }
67
+
68
+ export async function handleLinkRouteEdit(ctx: ManagementContext, state: LinkRouteState, id: string): Promise<Response> {
69
+ if (!LINK_ID.test(id)) return fail("invalid_link_id", "The link id is invalid.", 400);
70
+ const record = readStoreFor(ctx).links.find(link => link.id === id);
71
+ if (!record) return fail("link_not_found", "The link was not found.", 404);
72
+ if (record.direction !== "hub-initiated") return fail("link_not_home_initiated", "Only a Home-initiated link has routes.", 409);
73
+ if (ctx.req.method === "GET") return document(record);
74
+ if (record.exclusive) return exclusiveRefusal();
75
+ const edit = parseEdit(await readManagementJsonBodyOr(ctx.req, null));
76
+ if (!edit) return fail("invalid_body", "The body must be {op:\"add\",route,position?}, {op:\"remove\",route} or {op:\"order\",routes}.", 400);
77
+ const current = effectiveLinkRoutes(record);
78
+ let next: string[];
79
+ if (edit.op === "add") {
80
+ if (current.includes(edit.route)) return fail("route_exists", "The link already has this route.", 409);
81
+ if (current.length >= MAX_LINK_ROUTES) return fail("route_limit", "A link has at most " + MAX_LINK_ROUTES + " routes.", 409);
82
+ const position = edit.position ?? current.indexOf(record.alias);
83
+ if (position > current.length) return fail("invalid_body", "The position is out of range.", 400);
84
+ next = [...current.slice(0, position), edit.route, ...current.slice(position)];
85
+ } else if (edit.op === "remove") {
86
+ if (edit.route === record.alias) return fail("route_is_pin", "The link's own alias is its pinned name and stays in the list.", 409);
87
+ if (!current.includes(edit.route)) return fail("route_not_found", "The link has no such route.", 404);
88
+ next = current.filter(route => route !== edit.route);
89
+ } else {
90
+ if (edit.routes.length !== current.length || new Set(edit.routes).size !== edit.routes.length
91
+ || !edit.routes.every(route => current.includes(route))) {
92
+ return fail("route_order_mismatch", "The new order must list exactly the link's current routes.", 409);
93
+ }
94
+ next = edit.routes;
95
+ }
96
+ // Same exclusion as removal and Child jobs: the per-alias set, then the link's job reservation,
97
+ // held across the snapshot, the probe, the commit and the reload; the mutation lock only at commit.
98
+ return serialized(state, record.alias, async () => {
99
+ const { childOpsEngineFor } = await import("./link-child-ops-routes");
100
+ const release = childOpsEngineFor(state).reserve(id);
101
+ if (!release) return fail("link_operation_in_progress", "Another operation holds this link; try again when it ends.", 409);
102
+ try {
103
+ return await applyEdit(ctx, state, record, current, next, edit.op === "add" ? edit.route : null);
104
+ } finally {
105
+ release();
106
+ }
107
+ });
108
+ }
109
+
110
+ async function applyEdit(ctx: ManagementContext, state: LinkRouteState, record: LinkRecord, current: string[], next: string[], added: string | null): Promise<Response> {
111
+ const hostsPath = knownHostsFile(ctx);
112
+ let pinned: string | null = null;
113
+ if (added !== null) {
114
+ const trust = checkRouteTrust(readTrustFile(hostsPath), record.alias, record.hostKeyFingerprint);
115
+ if (!trust.ok) {
116
+ return trust.code === "pin_mismatch"
117
+ ? fail("pin_mismatch", "The link's known_hosts entry is not exactly its pinned key.", 409)
118
+ : fail("trust_file_unexpected", "The link known_hosts file has a line this check cannot rule out.", 409);
119
+ }
120
+ pinned = trust.line;
121
+ const refused = await proveRoute(ctx, record, added, pinned);
122
+ if (refused) return refused;
123
+ }
124
+ const outcome = withConfigMutationLockSync((): "link_changed" | "pin_changed" | "link_exclusive" | LinkRecord => {
125
+ const fresh = readStoreFor(ctx);
126
+ const target = fresh.links.find(link => link.id === record.id);
127
+ if (target?.exclusive) return "link_exclusive";
128
+ if (!target || !sameIdentity(target, record) || !sameList(effectiveLinkRoutes(target), current)) return "link_changed";
129
+ if (pinned !== null) {
130
+ const trust = checkRouteTrust(readTrustFile(hostsPath), record.alias, record.hostKeyFingerprint);
131
+ if (!trust.ok || trust.line !== pinned) return "pin_changed";
132
+ }
133
+ if (next.length === 1 && next[0] === target.alias) delete target.routes;
134
+ else target.routes = [...next];
135
+ writeStoreFor(ctx, fresh);
136
+ return target;
137
+ });
138
+ if (outcome === "link_exclusive") return exclusiveRefusal();
139
+ if (outcome === "link_changed") return fail("link_changed", "The link changed while its routes were being edited; read it again.", 409);
140
+ if (outcome === "pin_changed") return fail("pin_changed", "The link's pinned key changed while the route was being proved.", 409);
141
+ try { await state.supervisor.reload(); } catch {
142
+ // The store holds the edit, the running tunnels may not: say so instead of reporting success.
143
+ console.warn("[link] route edit stored; tunnel reload failed linkId=" + record.id);
144
+ const message = "The routes were stored, but the running proxy did not apply them. Restart the proxy to apply them.";
145
+ return Response.json({ error: { code: "routes_stored_reload_failed", message, ...routesBody(outcome) } }, { status: 500, headers: { "cache-control": "no-store" } });
146
+ }
147
+ return document(outcome);
148
+ }
149
+
150
+ function readTrustFile(path: string): string {
151
+ try { return readFileSync(path, "utf8"); } catch { return ""; }
152
+ }
153
+
154
+ /** Probe the route against a private copy of the one pinned line; null when it proved the key. */
155
+ async function proveRoute(ctx: ManagementContext, record: LinkRecord, route: string, pinned: string): Promise<Response | null> {
156
+ const dir = mkdtempSync(join(tmpdir(), "ocx-link-route-"));
157
+ try {
158
+ const snapshot = join(dir, "known_hosts");
159
+ writeFileSync(snapshot, pinned + "\n", { mode: 0o600 });
160
+ let cause: string;
161
+ try {
162
+ const result = await runnerFor(ctx).run(buildRouteProbeArgv({ alias: record.alias, destination: route, knownHostsFile: snapshot, route: record.explicitRoute ?? null }), { timeoutMs: ROUTE_PROBE_TIMEOUT_MS });
163
+ if (result.code === 0 && result.stdout.trim() === "ocx-link-probe") return null;
164
+ cause = result.code === 0 ? "transient" : routeOutcomeOfStderr(result.stderr);
165
+ } catch {
166
+ cause = "transient";
167
+ }
168
+ return Response.json({ error: { code: "route_unproven", message: "The route did not prove the link's pinned host key.", cause } }, { status: 409, headers: { "cache-control": "no-store" } });
169
+ } finally {
170
+ rmSync(dir, { recursive: true, force: true });
171
+ }
172
+ }
173
+
@@ -0,0 +1,62 @@
1
+ /**
2
+ * The explicit route fields of a link enrollment request (structure/remote-link.md, "Explicit route").
3
+ * probe, confirm-host and apply each accept optional explicitRoute and exclusive beside their own keys.
4
+ * probe binds them to the pending host; confirm-host and apply must name the same values (absent is
5
+ * none), so a probe made by another caller with another route can never be confirmed or applied here.
6
+ */
7
+ import { checkExplicitRoute, IDENTITY_FILE_GUIDANCE, identityFileProblem, sameExplicitRoute, type ExplicitRoute } from "../../link/explicit-route";
8
+ import { fail, isRecord } from "./link-route-state";
9
+
10
+ export interface RouteRequest {
11
+ explicitRoute: ExplicitRoute | null;
12
+ exclusive: boolean;
13
+ }
14
+
15
+ export const NO_ROUTE_REQUEST: RouteRequest = { explicitRoute: null, exclusive: false };
16
+
17
+ /**
18
+ * The body without the route keys, and the route it asked for; a refusal is a 400 before any SSH. Only the form is checked
19
+ * here: the identity file itself is checked by identityFileRefusal where a request is about to run SSH, so a repeat of a
20
+ * journalled apply replays its recorded outcome (or answers operation_mismatch) whatever its key file looks like now.
21
+ */
22
+ export function splitRouteRequest(value: unknown): { body: unknown; route: RouteRequest } | { error: Response } {
23
+ if (!isRecord(value) || (!("explicitRoute" in value) && !("exclusive" in value))) return { body: value, route: NO_ROUTE_REQUEST };
24
+ const { explicitRoute, exclusive, ...body } = value;
25
+ if (exclusive !== undefined && exclusive !== true) return { error: fail("invalid_body", "exclusive must be true when present.", 400) };
26
+ let route: ExplicitRoute | null = null;
27
+ if (explicitRoute !== undefined) {
28
+ const checked = checkExplicitRoute(explicitRoute);
29
+ if (!checked.ok) return { error: fail("invalid_explicit_route", "explicitRoute must be {proxyCommand, user, port} with an optional identityFile, in the accepted form.", 400, checked.reason) };
30
+ route = checked.route;
31
+ if (exclusive !== true) return { error: fail("explicit_route_requires_exclusive", "A link with an explicit route must be exclusive.", 400) };
32
+ }
33
+ return { body, route: { explicitRoute: route, exclusive: exclusive === true } };
34
+ }
35
+
36
+ /**
37
+ * The 400 for a route whose identity file this Home cannot use, from its metadata only (the hint is a fixed code); null
38
+ * without one. probe and confirm-host check it before their SSH, apply after its replay and before its journal entry.
39
+ */
40
+ export function identityFileRefusal(route: ExplicitRoute | null, platform: NodeJS.Platform = process.platform): Response | null {
41
+ const problem = route?.identityFile === undefined ? null : identityFileProblem(route.identityFile, platform);
42
+ if (!problem) return null;
43
+ return fail("invalid_identity_file", IDENTITY_FILE_GUIDANCE[problem], 400, problem);
44
+ }
45
+
46
+ /** The route a pending or confirmed host was probed with. */
47
+ export function routeOf(host: { explicitRoute?: ExplicitRoute; exclusive?: true }): RouteRequest {
48
+ return { explicitRoute: host.explicitRoute ?? null, exclusive: host.exclusive === true };
49
+ }
50
+
51
+ export function sameRouteRequest(left: RouteRequest, right: RouteRequest): boolean {
52
+ return left.exclusive === right.exclusive && sameExplicitRoute(left.explicitRoute, right.explicitRoute);
53
+ }
54
+
55
+ /** The optional record fields for a route request: nothing at all for a link without one. */
56
+ export function routeFields(route: RouteRequest): { explicitRoute?: ExplicitRoute; exclusive?: true } {
57
+ return { ...(route.explicitRoute ? { explicitRoute: route.explicitRoute } : {}), ...(route.exclusive ? { exclusive: true as const } : {}) };
58
+ }
59
+
60
+ export function routeMismatch(): Response {
61
+ return fail("route_mismatch", "The explicit route or exclusive flag differs from the one the host was probed with; probe the host again.", 409);
62
+ }
@@ -4,8 +4,10 @@ import { dirname } from "node:path";
4
4
  import { linkKnownHostsPath, linkStorePath } from "../../link/paths";
5
5
  import { clearCompensationFailed, compensationPath, markCompensationFailed } from "../../link/compensation";
6
6
  import { readLinkStore, writeLinkStore, type LinkStore } from "../../link/store";
7
+ import { withoutAliasLines } from "../../link/route-trust";
7
8
  import { boundHint, createSshRunner, type SshRunner } from "../../link/ssh-runner";
8
9
  import { withConfigMutationLockSync } from "../../config/mutation-lock";
10
+ import { reconcileHomeRouteDevices } from "../../routing/home-route-intent";
9
11
  import type { ManagementContext } from "./context";
10
12
  import { issueApiKeyInProcess, revokeApiKeyInProcess, type IssuedApiKey } from "./oauth-account-routes";
11
13
 
@@ -19,6 +21,9 @@ export interface PendingLinkHost {
19
21
  remotePlatform?: "posix" | "windows";
20
22
  runtimeKind?: "full" | "ephemeral" | "missing";
21
23
  targetTriple?: import("../../link/child-binary-source").ChildTargetTriple | null;
24
+ /** The explicit route every SSH command of this enrollment uses; the record keeps it (link-route-request.ts). */
25
+ explicitRoute?: import("../../link/explicit-route").ExplicitRoute;
26
+ exclusive?: true;
22
27
  }
23
28
 
24
29
  export interface ConfirmedLinkHost extends PendingLinkHost {
@@ -35,6 +40,22 @@ export interface LinkRouteListener {
35
40
  onAuthenticatedCatalog(listener: (apiKeyId: string) => void): () => void;
36
41
  /** Optional so route fakes stay small; without it every link reports an unknown peer. */
37
42
  peerObservation?(linkId: string): import("../../link/peer-report").LinkPeerEntry;
43
+ /** Optional: without it every link's activity reads unknown (never idle). */
44
+ linkActivity?(linkId: string, now: number): import("../../link/child-activity").LinkActivitySnapshot;
45
+ /** Optional: closes the link's Responses WebSockets after a revoke commits (route fakes omit it). */
46
+ closeLinkSockets?(linkId: string): number;
47
+ /** Optional: the link's live WebSocket counters (design 9.3); without it every row reports zeros. */
48
+ linkTransport?(linkId: string): import("../../link/status-projection").LinkWsCounters;
49
+ /** Optional: the link's WebSocket activity holds and their reasons; null when nothing holds it (D8). */
50
+ linkHolds?(linkId: string): import("../../link/ws-activity-holds").LinkHoldsSummary | null;
51
+ /** Optional: the operator's clear of one link's activity holds (D8). */
52
+ clearLinkHolds?(linkId: string): import("../../link/ws-activity-holds").ClearHoldsResult;
53
+ /** Optional: without it a Home row's traffic reads zero since now. */
54
+ linkTraffic?(linkId: string): import("../../link/traffic").LinkTrafficCounters;
55
+ /** Optional: without it only the cached pull in child-observations.json is known. */
56
+ catalogPull?(linkId: string): import("../../link/child-catalog-freshness").CatalogPull | null;
57
+ /** Optional: persist pulls held inside the recorder's 30 s write window (best effort). */
58
+ flushCatalogPulls?(): void;
38
59
  }
39
60
 
40
61
  export interface LinkRouteState {
@@ -44,6 +65,10 @@ export interface LinkRouteState {
44
65
  compensationFailures?: Map<string, { since: string; reason: "compensation_failed" }>;
45
66
  supervisor: import("../../link/supervisor").LinkSupervisor;
46
67
  listener: LinkRouteListener;
68
+ /** The process-wide engine (sharedChildOpsEngine), cached on first use; a direct test may set its own. */
69
+ childOps?: import("../../link/child-ops-engine").ChildOpsEngine;
70
+ /** The Home catalog revision read on `?children=1`; defaults to the shared production monitor. */
71
+ catalogRevision?: import("../../link/child-catalog-freshness").CatalogRevisionMonitor;
47
72
  }
48
73
 
49
74
  export function fail(code: string, message: string, status: number, hint?: string): Response {
@@ -118,15 +143,34 @@ export function knownHostsFile(ctx: ManagementContext): string {
118
143
 
119
144
  export function putKnownHost(path: string, alias: string, line: string): string {
120
145
  const before = (() => { try { return readFileSync(path, "utf8"); } catch { return ""; } })();
121
- const lines = before.split(/\r?\n/).filter(value => value && !value.startsWith(`${alias} `) && !value.startsWith(`${alias},`));
146
+ // OpenSSH compares known_hosts names without case, so every spelling of the alias is replaced.
147
+ const lines = withoutAliasLines(before, alias);
122
148
  lines.push(line.trim());
123
149
  mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
124
150
  atomicWriteFile(path, `${lines.join("\n")}\n`);
125
151
  return before;
126
152
  }
127
153
 
128
- export function issueKey(ctx: ManagementContext, name: string): IssuedApiKey {
129
- return (ctx.deps.issueApiKey ?? issueApiKeyInProcess)(ctx.config, name);
154
+ /**
155
+ * confirm-host's only write. Inside the config mutation lock, immediately before writing, a
156
+ * Home-initiated link that owns this alias (ignoring case) with another fingerprint refuses it: a
157
+ * link's routes trust exactly its record's key, and a confirmation must not replace that key.
158
+ * False when refused; nothing is written then.
159
+ */
160
+ export function putConfirmedKnownHost(ctx: ManagementContext, alias: string, line: string, fingerprint: string): boolean {
161
+ return withConfigMutationLockSync(() => {
162
+ const wanted = alias.toLowerCase();
163
+ const conflict = readStoreFor(ctx).links.some(link => link.direction === "hub-initiated"
164
+ && link.alias.toLowerCase() === wanted && link.hostKeyFingerprint !== fingerprint);
165
+ if (conflict) return false;
166
+ putKnownHost(knownHostsFile(ctx), alias, line);
167
+ return true;
168
+ });
169
+ }
170
+
171
+ export function issueKey(ctx: ManagementContext, name: string, reservedId?: string): IssuedApiKey {
172
+ const issue = ctx.deps.issueApiKey ?? issueApiKeyInProcess;
173
+ return reservedId === undefined ? issue(ctx.config, name) : issue(ctx.config, name, reservedId);
130
174
  }
131
175
 
132
176
  export function revokeKey(ctx: ManagementContext, id: string): boolean {
@@ -155,19 +199,60 @@ export function compensationFailure(ctx: ManagementContext, state: LinkRouteStat
155
199
  return fail("compensation_failed", "The link compensation could not be completed.", 500);
156
200
  }
157
201
 
158
- export async function compensateNewLink(ctx: ManagementContext, state: LinkRouteState, record: LinkStore["links"][number]): Promise<Response | null> {
202
+ // All last-link closures share the listener, including failed-enrollment compensation.
203
+ const listenerReconciliations = new WeakMap<LinkRouteListener, Promise<void>>();
204
+ export async function reconcileLinkListener(ctx: ManagementContext, listener: LinkRouteListener): Promise<void> {
205
+ const previous = listenerReconciliations.get(listener);
206
+ const flight = (async () => {
207
+ if (previous) await previous.catch(() => {});
208
+ if (readStoreFor(ctx).links.length === 0) await listener.close();
209
+ if (readStoreFor(ctx).links.length > 0) {
210
+ await listener.ensureStarted();
211
+ if (readStoreFor(ctx).links.length > 0 && listener.status().state !== "listening") {
212
+ throw new Error("link listener unavailable");
213
+ }
214
+ }
215
+ })();
216
+ listenerReconciliations.set(listener, flight);
217
+ try { await flight; } finally { if (listenerReconciliations.get(listener) === flight) listenerReconciliations.delete(listener); }
218
+ }
219
+
220
+ /** A link that was never stored, or not restored, whose issued key could not be revoked. */
221
+ export function keyCleanupFailed(): Response {
222
+ return fail("key_cleanup_failed", "The link was not created, but its issued key could not be revoked; revoke the leftover link key under API keys.", 500);
223
+ }
224
+
225
+ /**
226
+ * Undo a new link. When its key will not revoke, the record is kept (stored again if absent) so the
227
+ * leftover key stays attached to a visible link. `stillValid` guards that re-insert: it runs inside
228
+ * the same lock as the write, and a record that no longer passes it (its alias or pin changed while
229
+ * this waited) is never stored; the key is reported instead (`key_cleanup_failed`).
230
+ */
231
+ export async function compensateNewLink(ctx: ManagementContext, state: LinkRouteState, record: LinkStore["links"][number], stillValid?: (current: LinkStore) => boolean): Promise<Response | null> {
159
232
  const revoked = revokeKeyIdempotent(ctx, record.apiKeyId);
160
233
  if (!revoked) {
161
234
  try { await state.supervisor.stopLink(record.id); } catch { /* retain the record and failure marker */ }
235
+ let rejected = false, uncertain = false;
162
236
  try {
163
237
  withConfigMutationLockSync(() => {
164
238
  const current = readStoreFor(ctx);
165
239
  if (!current.links.some(link => link.id === record.id)) {
240
+ if (stillValid && !stillValid(current)) { rejected = true; return; }
166
241
  writeStoreFor(ctx, { ...current, links: [...current.links, record] });
167
242
  }
168
243
  });
169
244
  } catch {
170
- // The in-memory marker still makes the residual visible when persistence is unavailable.
245
+ // Whether the link is stored is now unknown. The in-memory marker shows it if it is; the
246
+ // response says the key may be left over either way.
247
+ uncertain = true;
248
+ }
249
+ if (rejected) {
250
+ console.warn("[link] new link no longer valid after a failed store write; its issued key could not be revoked");
251
+ return keyCleanupFailed();
252
+ }
253
+ if (uncertain) {
254
+ compensationFailure(ctx, state, record, "revoke");
255
+ return fail("link_cleanup_uncertain", "The link could not be undone: whether it is stored is unknown and its issued key could not be revoked. Check the link status, remove the link if it is listed, and revoke the leftover link key under API keys if it remains.", 500);
171
256
  }
172
257
  return compensationFailure(ctx, state, record, "revoke");
173
258
  }
@@ -181,11 +266,12 @@ export async function compensateNewLink(ctx: ManagementContext, state: LinkRoute
181
266
  if (filtered.links.length !== current.links.length) {
182
267
  writeStoreFor(ctx, filtered);
183
268
  }
269
+ reconcileHomeRouteDevices(filtered.links.map(link => link.id));
184
270
  return filtered;
185
271
  });
186
272
  clearCompensationFailed(record.id, compensationPath());
187
273
  state.compensationFailures?.delete(record.id);
188
- if (next.links.length === 0) await state.listener.close();
274
+ if (next.links.length === 0) await reconcileLinkListener(ctx, state.listener);
189
275
  return null;
190
276
  } catch {
191
277
  return compensationFailure(ctx, state, record, "store");