@bitkyc08/opencodex 2.100.2 → 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 (561) 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-BcaI-VCr.js → Tray-BV4ms9U9.js} +1 -1
  6. package/gui/dist/assets/{brand-mark-DU-0Vdkr.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/{index-DJEkIDAi.css → index-DQtCRNAw.css} +1 -1
  9. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.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-DT146AhS.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-CakPe9Ni.js → quota-summary-Dy5_wfTT.js} +1 -1
  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 +3 -3
  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/protobuf-request.ts +8 -8
  38. package/src/adapters/cursor.ts +7 -6
  39. package/src/adapters/google-antigravity-wire.ts +7 -5
  40. package/src/adapters/google-wire-compiler.ts +2 -2
  41. package/src/adapters/google.ts +9 -2
  42. package/src/adapters/kiro/payload.ts +7 -4
  43. package/src/adapters/kiro/reasoning.ts +44 -1
  44. package/src/adapters/kiro/structured-output.ts +10 -8
  45. package/src/adapters/kiro-tools.ts +61 -15
  46. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  47. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  48. package/src/adapters/zed.ts +3 -0
  49. package/src/advisor/consult.ts +15 -4
  50. package/src/advisor/context.ts +12 -3
  51. package/src/advisor/runtime.ts +35 -5
  52. package/src/advisor/settings.ts +8 -0
  53. package/src/advisor/synthetic-tool.ts +21 -8
  54. package/src/bridge/response-json.ts +11 -2
  55. package/src/bridge/sse.ts +43 -8
  56. package/src/claude/auth-detect.ts +21 -33
  57. package/src/claude/desktop-3p.ts +11 -5
  58. package/src/claude/desktop-gateway-state.ts +2 -0
  59. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  60. package/src/claude/desktop-remote-store.ts +24 -4
  61. package/src/claude/inbound-content-options.ts +31 -16
  62. package/src/claude/outbound.ts +13 -3
  63. package/src/cli/account-api.ts +17 -1
  64. package/src/cli/account-auth.ts +54 -21
  65. package/src/cli/account-key-quota.ts +34 -5
  66. package/src/cli/account.ts +4 -2
  67. package/src/cli/advisor.ts +7 -4
  68. package/src/cli/alias.ts +38 -1
  69. package/src/cli/capabilities-access-remote.ts +128 -3
  70. package/src/cli/capabilities-accounts.ts +3 -3
  71. package/src/cli/capabilities-agents-routing.ts +17 -10
  72. package/src/cli/capabilities-base.ts +41 -16
  73. package/src/cli/capabilities-integrations.ts +2 -2
  74. package/src/cli/capabilities-provider-models.ts +18 -2
  75. package/src/cli/capabilities-route-to.ts +43 -0
  76. package/src/cli/capabilities.ts +2 -0
  77. package/src/cli/capability-contracts.ts +1 -1
  78. package/src/cli/claude-desktop.ts +30 -11
  79. package/src/cli/claude.ts +17 -3
  80. package/src/cli/codex-launcher.ts +3 -1
  81. package/src/cli/codex-shim-autorestore.ts +5 -42
  82. package/src/cli/config-command.ts +14 -1
  83. package/src/cli/config-root-startup.ts +34 -0
  84. package/src/cli/connect.ts +88 -16
  85. package/src/cli/desktop-runtime-guidance.ts +1 -1
  86. package/src/cli/disconnect-runtime.ts +168 -0
  87. package/src/cli/dispatch.ts +54 -12
  88. package/src/cli/export-command.ts +1 -1
  89. package/src/cli/gui-pair-client.ts +6 -3
  90. package/src/cli/gui.ts +10 -5
  91. package/src/cli/help-catalog.ts +11 -0
  92. package/src/cli/help.ts +4 -3
  93. package/src/cli/index.ts +83 -92
  94. package/src/cli/inspect.ts +11 -2
  95. package/src/cli/integrations.ts +26 -1
  96. package/src/cli/link-capture.ts +64 -0
  97. package/src/cli/link-child-ops.ts +218 -40
  98. package/src/cli/link-cleanup.ts +8 -5
  99. package/src/cli/link-diagnostics.ts +67 -0
  100. package/src/cli/link-enrollment.ts +158 -12
  101. package/src/cli/link-operations.ts +52 -0
  102. package/src/cli/link-recover.ts +152 -0
  103. package/src/cli/link-routes.ts +87 -0
  104. package/src/cli/link-status-child.ts +44 -1
  105. package/src/cli/link-status-traffic.ts +34 -0
  106. package/src/cli/link.ts +314 -37
  107. package/src/cli/message-command.ts +1 -1
  108. package/src/cli/message-mcp-command.ts +23 -10
  109. package/src/cli/models-runtime.ts +3 -3
  110. package/src/cli/opencode.ts +3 -1
  111. package/src/cli/pi-sync.ts +35 -0
  112. package/src/cli/preflight-exemptions.ts +46 -0
  113. package/src/cli/registry.ts +28 -12
  114. package/src/cli/restart-failure.ts +5 -2
  115. package/src/cli/root.ts +5 -1
  116. package/src/cli/route-to.ts +172 -0
  117. package/src/cli/runtime-api.ts +5 -8
  118. package/src/cli/status.ts +3 -1
  119. package/src/cli/stop-approval.ts +66 -19
  120. package/src/cli/stop-report.ts +23 -0
  121. package/src/cli/stop-windows-checked.ts +304 -0
  122. package/src/cli/sync-command.ts +70 -15
  123. package/src/cli/sync-fanout.ts +74 -19
  124. package/src/cli/sync-flags.ts +40 -3
  125. package/src/cli/sync-link-status.ts +18 -2
  126. package/src/cli/sync-update-guard.ts +7 -2
  127. package/src/cli/system-restart-client.ts +3 -2
  128. package/src/cli/uninstall-plan.ts +77 -5
  129. package/src/cli/uninstall-stop.ts +152 -0
  130. package/src/cli/v2-input.ts +10 -6
  131. package/src/cli/v2-local-output.ts +3 -2
  132. package/src/cli/v2-runtime.ts +10 -3
  133. package/src/cli/v2.ts +22 -7
  134. package/src/client/connect.ts +321 -34
  135. package/src/client/link-home-features.ts +27 -0
  136. package/src/client/link-home.ts +92 -4
  137. package/src/client/link-ingress.ts +21 -3
  138. package/src/client/link-join.ts +12 -2
  139. package/src/client/link-parity-reporter.ts +60 -6
  140. package/src/client/link-relay-transport.ts +161 -36
  141. package/src/client/link-relay.ts +150 -6
  142. package/src/client/link-request-compression.ts +84 -0
  143. package/src/client/link-state.ts +11 -5
  144. package/src/client/link-status.ts +39 -1
  145. package/src/client/link-teardown.ts +1 -0
  146. package/src/client/link-tunnel.ts +56 -5
  147. package/src/client/link-websocket-limits.ts +89 -0
  148. package/src/client/link-websocket.ts +586 -0
  149. package/src/client/link-ws-advertisement.ts +100 -0
  150. package/src/client/link-ws-framer.ts +241 -0
  151. package/src/client/link-ws-transport.ts +177 -0
  152. package/src/client/machine-api.ts +13 -2
  153. package/src/client/machine-listener.ts +48 -7
  154. package/src/client/route-intent-apply.ts +293 -0
  155. package/src/client/route-intent-file-originals.ts +97 -0
  156. package/src/client/route-intent-native-originals.ts +201 -0
  157. package/src/client/route-intent-watch.ts +141 -0
  158. package/src/client/runtime-restart.ts +127 -5
  159. package/src/client/runtime.ts +61 -15
  160. package/src/client/state.ts +30 -0
  161. package/src/client/sync-expectation.ts +36 -2
  162. package/src/client/sync-runtime.ts +7 -0
  163. package/src/clients/config-export/alias-selectors.ts +63 -40
  164. package/src/clients/config-export/contracts.ts +2 -0
  165. package/src/clients/config-export/nested-selectors.ts +42 -0
  166. package/src/clients/config-export.ts +22 -3
  167. package/src/codex/account-store.ts +12 -3
  168. package/src/codex/account-usability.ts +13 -0
  169. package/src/codex/auth-api/account-list.ts +29 -3
  170. package/src/codex/auth-collision.ts +23 -22
  171. package/src/codex/auth-context.ts +21 -6
  172. package/src/codex/catalog/gather-capture.ts +8 -2
  173. package/src/codex/catalog/parsing.ts +7 -3
  174. package/src/codex/catalog/provider-models.ts +54 -15
  175. package/src/codex/catalog/retained-sync.ts +2 -1
  176. package/src/codex/catalog/routed-gather.ts +1 -1
  177. package/src/codex/catalog-auto-refresh.ts +11 -0
  178. package/src/codex/cli-update-job.ts +35 -13
  179. package/src/codex/convergence.ts +2 -2
  180. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  181. package/src/codex/features.ts +2 -2
  182. package/src/codex/history-provider.ts +31 -0
  183. package/src/codex/inject/multi-agent-v2.ts +9 -3
  184. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  185. package/src/codex/inject/plan.ts +20 -2
  186. package/src/codex/inject.ts +2 -0
  187. package/src/codex/journal-config-restore.ts +217 -0
  188. package/src/codex/journal.ts +75 -6
  189. package/src/codex/main-account.ts +23 -30
  190. package/src/codex/native-main-auth-file.ts +104 -0
  191. package/src/codex/native-profile-manager.ts +4 -3
  192. package/src/codex/native-profile-store.ts +3 -61
  193. package/src/codex/orca-import.ts +10 -1
  194. package/src/codex/quota-history.ts +13 -0
  195. package/src/codex/quota-window-conflict.ts +103 -0
  196. package/src/codex/quota.ts +23 -1
  197. package/src/codex/subagent-model-fallback.ts +3 -1
  198. package/src/codex/websocket-activity.ts +171 -16
  199. package/src/codex/websocket-registry.ts +11 -4
  200. package/src/combos/cooldown-store.ts +25 -5
  201. package/src/combos/failover.ts +330 -2
  202. package/src/config/dashboard-trusted-proxy.ts +83 -0
  203. package/src/config/diagnostics.ts +28 -0
  204. package/src/config/feature-flags.ts +9 -0
  205. package/src/config/live-reconcile.ts +10 -1
  206. package/src/config/load-degrade.ts +12 -1
  207. package/src/config/multi-agent-surface.ts +28 -5
  208. package/src/config/pending-teardown.ts +60 -3
  209. package/src/config/process-state.ts +175 -4
  210. package/src/config/provider-validation.ts +4 -4
  211. package/src/config/schema/config-schema.ts +6 -0
  212. package/src/config/schema/leaf-validators.ts +9 -2
  213. package/src/config/windows-process-command-line.ts +107 -0
  214. package/src/generated/compatibility-version.json +948 -392
  215. package/src/generated/model-metadata.ts +1 -1
  216. package/src/images/loop.ts +3 -0
  217. package/src/integrations/model-name-guard.ts +25 -0
  218. package/src/integrations/route-intent-catalog.ts +26 -0
  219. package/src/integrations/route-intent-connected.ts +262 -0
  220. package/src/integrations/route-intent-contract.ts +55 -0
  221. package/src/integrations/route-intent-disconnect.ts +109 -0
  222. package/src/integrations/route-intent-initial.ts +64 -0
  223. package/src/integrations/route-intent-state.ts +117 -0
  224. package/src/integrations/route-intent-tick.ts +65 -0
  225. package/src/integrations/route-intent.ts +212 -0
  226. package/src/integrations/writer.ts +44 -11
  227. package/src/lib/client-retry-after.ts +29 -0
  228. package/src/lib/config-ownership.ts +13 -0
  229. package/src/lib/desktop-gui-origin.ts +28 -0
  230. package/src/lib/errors.ts +1 -1
  231. package/src/lib/gui-pair-capability.ts +2 -1
  232. package/src/lib/messages-error-body.ts +4 -1
  233. package/src/lib/outbound-credential-registry.ts +362 -4
  234. package/src/lib/paced-stream.ts +34 -0
  235. package/src/lib/passive-key-fetch-proof.ts +30 -0
  236. package/src/lib/passive-read.ts +5 -0
  237. package/src/lib/process-control.ts +76 -12
  238. package/src/lib/redact.ts +84 -8
  239. package/src/lib/state-store-registrations.ts +11 -0
  240. package/src/lib/state-store-sweeper.ts +4 -0
  241. package/src/lib/supervisor-markers.ts +18 -0
  242. package/src/lib/terminal-safe-text.ts +58 -0
  243. package/src/lib/translator-budget.ts +3 -2
  244. package/src/lib/upstream-retry.ts +14 -4
  245. package/src/link/alias-lock.ts +119 -0
  246. package/src/link/child-activity.ts +28 -2
  247. package/src/link/child-binary-cache-fill.d.mts +50 -0
  248. package/src/link/child-binary-cache-fill.mjs +494 -0
  249. package/src/link/child-binary-cache-start.ts +73 -0
  250. package/src/link/child-binary-source.ts +12 -5
  251. package/src/link/child-gated-ocx.ts +29 -11
  252. package/src/link/child-observations.ts +2 -1
  253. package/src/link/child-observe.ts +2 -2
  254. package/src/link/child-ops-engine.ts +159 -91
  255. package/src/link/child-ops-host.ts +138 -0
  256. package/src/link/child-ops-runners.ts +319 -0
  257. package/src/link/child-ops-scheduler.ts +207 -0
  258. package/src/link/child-ops-types.ts +89 -0
  259. package/src/link/child-parity.ts +23 -4
  260. package/src/link/child-policy.ts +93 -0
  261. package/src/link/child-update-contract.ts +12 -3
  262. package/src/link/codex-settings.ts +1 -1
  263. package/src/link/compatibility.ts +18 -1
  264. package/src/link/diagnostics-read.ts +163 -0
  265. package/src/link/diagnostics.ts +20 -7
  266. package/src/link/explicit-route.ts +209 -0
  267. package/src/link/link-recover.ts +113 -0
  268. package/src/link/management-routes.ts +3 -1
  269. package/src/link/operation-recovery-slot.ts +44 -0
  270. package/src/link/operations-journal.ts +408 -0
  271. package/src/link/peer-report.ts +1 -1
  272. package/src/link/relay-auth.ts +14 -0
  273. package/src/link/remote-plant.ts +152 -14
  274. package/src/link/remote-platform.ts +21 -10
  275. package/src/link/remote-probe.ts +11 -3
  276. package/src/link/remote-windows.ts +50 -10
  277. package/src/link/request-compression.ts +30 -0
  278. package/src/link/residual-recovery.ts +54 -0
  279. package/src/link/retirement.ts +128 -0
  280. package/src/link/route-intent-watch.ts +41 -0
  281. package/src/link/route-intent.ts +209 -0
  282. package/src/link/route-proof.ts +82 -0
  283. package/src/link/route-rounds.ts +579 -0
  284. package/src/link/route-select.ts +95 -0
  285. package/src/link/route-trust.ts +96 -0
  286. package/src/link/ssh-argv.ts +172 -24
  287. package/src/link/ssh-capture-redact.ts +253 -0
  288. package/src/link/ssh-capture.ts +497 -0
  289. package/src/link/ssh-runner.ts +141 -14
  290. package/src/link/status-projection.ts +87 -0
  291. package/src/link/store.ts +54 -1
  292. package/src/link/supervisor.ts +543 -55
  293. package/src/link/sync-fanout-classify.ts +16 -0
  294. package/src/link/sync-then-restart.ts +65 -0
  295. package/src/link/tombstones.ts +209 -0
  296. package/src/link/traffic.ts +178 -0
  297. package/src/link/ws-activity-holds.ts +474 -0
  298. package/src/local-credentials/publication-fence.ts +20 -1
  299. package/src/messaging/mcp-queue-rpc.ts +1 -1
  300. package/src/messaging/mcp-queue-server.ts +16 -1
  301. package/src/messaging/mcp-resume-tools.ts +25 -0
  302. package/src/messaging/remote-enrollment.ts +3 -3
  303. package/src/messaging/remote-tunnels.ts +2 -2
  304. package/src/messaging/resume-permissions.ts +27 -0
  305. package/src/messaging/rpc.ts +46 -2
  306. package/src/oauth/anthropic-continuity.ts +23 -7
  307. package/src/oauth/anthropic-routing.ts +5 -2
  308. package/src/oauth/anthropic.ts +22 -2
  309. package/src/oauth/claude-keychain-read.ts +78 -68
  310. package/src/oauth/index.ts +24 -6
  311. package/src/oauth/local-token-detect.ts +8 -29
  312. package/src/oauth/login-cli-errors.ts +5 -1
  313. package/src/oauth/login-cli.ts +33 -18
  314. package/src/oauth/login-flow-state.ts +26 -3
  315. package/src/oauth/meta-muse.ts +1 -1
  316. package/src/oauth/store.ts +7 -0
  317. package/src/oauth/xai.ts +248 -14
  318. package/src/protocols/contract.ts +4 -0
  319. package/src/protocols/encoders/messages.ts +1 -0
  320. package/src/providers/alias-template.ts +48 -0
  321. package/src/providers/anthropic-billing-ownership.ts +2 -0
  322. package/src/providers/anthropic-output-caps.ts +46 -0
  323. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  324. package/src/providers/antigravity-effort-families.ts +11 -3
  325. package/src/providers/antigravity-models.ts +32 -9
  326. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  327. package/src/providers/api-key-pause.ts +3 -0
  328. package/src/providers/api-key-resolve.ts +49 -7
  329. package/src/providers/api-key-response-ownership.ts +2 -0
  330. package/src/providers/api-key-selection.ts +51 -9
  331. package/src/providers/api-keys.ts +6 -2
  332. package/src/providers/cache-affinity-identity.ts +73 -0
  333. package/src/providers/cache-affinity.ts +256 -0
  334. package/src/providers/default-aliases.ts +98 -20
  335. package/src/providers/google-vertex-model-discovery.ts +510 -0
  336. package/src/providers/key-failover.ts +123 -8
  337. package/src/providers/key-store.ts +3 -3
  338. package/src/providers/kiro-models.ts +3 -5
  339. package/src/providers/label.ts +31 -5
  340. package/src/providers/mistral-transport.ts +17 -4
  341. package/src/providers/model-rename-fields.ts +3 -0
  342. package/src/providers/muse-key-quota.ts +14 -6
  343. package/src/providers/new-model-policy-runtime.ts +17 -4
  344. package/src/providers/new-model-policy.ts +30 -4
  345. package/src/providers/passive-key-observation.ts +252 -0
  346. package/src/providers/quota/account-cache.ts +2 -1
  347. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  348. package/src/providers/quota/passive-key-limits.ts +272 -0
  349. package/src/providers/quota/passive-wire-model.ts +126 -0
  350. package/src/providers/quota/report-cache.ts +61 -2
  351. package/src/providers/quota-key-accounts.ts +11 -6
  352. package/src/providers/quota-types.ts +18 -0
  353. package/src/providers/quota.ts +11 -12
  354. package/src/providers/registry/entries-core.ts +34 -16
  355. package/src/providers/registry/entries-extended.ts +32 -0
  356. package/src/providers/registry/model-seeds.ts +35 -0
  357. package/src/providers/resolved-model-policy.ts +7 -0
  358. package/src/providers/routed-config.ts +8 -3
  359. package/src/providers/xai-transport.ts +3 -0
  360. package/src/remote/features.ts +17 -0
  361. package/src/responses/anthropic-progress.ts +10 -4
  362. package/src/responses/citation-markers.ts +231 -0
  363. package/src/responses/spill-store.ts +5 -1
  364. package/src/responses/state/replay-input.ts +50 -0
  365. package/src/responses/state/replay-owner.ts +24 -0
  366. package/src/responses/state/snapshot-codec.ts +9 -0
  367. package/src/responses/state/spill-queue.ts +1 -0
  368. package/src/responses/state.ts +42 -60
  369. package/src/router.ts +2 -2
  370. package/src/routing/home-route-capture.ts +123 -0
  371. package/src/routing/home-route-intent.ts +200 -0
  372. package/src/routing/route-intent-state.ts +178 -0
  373. package/src/routing/route-to-live-settings.ts +35 -0
  374. package/src/routing/route-to-local.ts +145 -0
  375. package/src/routing/route-to-status.ts +94 -0
  376. package/src/routing/route-to-sync-child.ts +32 -0
  377. package/src/server/adapter-resolve.ts +21 -1
  378. package/src/server/admitted-http-turn.ts +3 -0
  379. package/src/server/auth-cors.ts +98 -0
  380. package/src/server/bare-upstream-error.ts +220 -0
  381. package/src/server/chat-native.ts +14 -5
  382. package/src/server/claude-messages.ts +6 -4
  383. package/src/server/codex-model-list.ts +2 -1
  384. package/src/server/configured-credentials.ts +37 -5
  385. package/src/server/gui-desktop-authorization.ts +36 -0
  386. package/src/server/gui-pair-delivery.ts +6 -3
  387. package/src/server/gui-session.ts +10 -1
  388. package/src/server/inbound-body-admission.ts +17 -4
  389. package/src/server/index/link-listener.ts +190 -12
  390. package/src/server/index/link-management.ts +15 -1
  391. package/src/server/index/link-relay-sessions.ts +87 -8
  392. package/src/server/index/link-websocket-limits.ts +136 -0
  393. package/src/server/index/link-websocket.ts +692 -0
  394. package/src/server/index/optional-listeners.ts +97 -7
  395. package/src/server/index/route-intent-watch.ts +47 -0
  396. package/src/server/index/serve-contract.ts +86 -0
  397. package/src/server/index/serve-options.ts +35 -86
  398. package/src/server/index/startup-warnings.ts +8 -2
  399. package/src/server/index/websocket-handler.ts +26 -4
  400. package/src/server/index.ts +12 -2
  401. package/src/server/inference/client-encoder-delivery.ts +2 -0
  402. package/src/server/inspection-tee.ts +39 -2
  403. package/src/server/lifecycle.ts +2 -0
  404. package/src/server/link-turn.ts +137 -0
  405. package/src/server/management/advisor-routes.ts +10 -2
  406. package/src/server/management/agent-settings-routes.ts +50 -16
  407. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  408. package/src/server/management/context.ts +9 -2
  409. package/src/server/management/desktop-authorization.ts +41 -0
  410. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  411. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  412. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  413. package/src/server/management/home-integration-decision.ts +89 -0
  414. package/src/server/management/integration-routes.ts +208 -81
  415. package/src/server/management/link-child-ops-routes.ts +145 -43
  416. package/src/server/management/link-child-preflight.ts +31 -0
  417. package/src/server/management/link-diagnostics-route.ts +29 -0
  418. package/src/server/management/link-enrollment.ts +199 -47
  419. package/src/server/management/link-operation.ts +609 -0
  420. package/src/server/management/link-recover-route.ts +103 -0
  421. package/src/server/management/link-route-edit.ts +173 -0
  422. package/src/server/management/link-route-request.ts +62 -0
  423. package/src/server/management/link-route-state.ts +83 -7
  424. package/src/server/management/link-routes.ts +553 -51
  425. package/src/server/management/link-traffic-status.ts +13 -0
  426. package/src/server/management/model-routes.ts +122 -36
  427. package/src/server/management/model-rows.ts +2 -1
  428. package/src/server/management/native-integration-routes.ts +176 -70
  429. package/src/server/management/oauth-account-routes.ts +36 -13
  430. package/src/server/management/protocol-routes.ts +7 -0
  431. package/src/server/management/provider-completion-test.ts +4 -4
  432. package/src/server/management/provider-overwrite-carry.ts +11 -0
  433. package/src/server/management/provider-routes.ts +64 -61
  434. package/src/server/management/provider-routing-quota.ts +45 -0
  435. package/src/server/management/route-registry.ts +22 -3
  436. package/src/server/management/route-to-routes.ts +257 -0
  437. package/src/server/management/system-restart.ts +4 -2
  438. package/src/server/management/usage-aggregate-cache.ts +101 -66
  439. package/src/server/management-api.ts +17 -3
  440. package/src/server/management-auth.ts +13 -1
  441. package/src/server/messages-native-preflight.ts +27 -4
  442. package/src/server/messages-native.ts +17 -5
  443. package/src/server/persistent-gui-session.ts +6 -3
  444. package/src/server/proxy-liveness.ts +33 -6
  445. package/src/server/relay-eager.ts +36 -12
  446. package/src/server/relay.ts +183 -116
  447. package/src/server/request-body-facts.ts +48 -0
  448. package/src/server/request-decompress.ts +65 -2
  449. package/src/server/request-log-account-rotation.ts +6 -0
  450. package/src/server/request-log-attempt-usage.ts +69 -0
  451. package/src/server/request-log-cache-affinity.ts +60 -0
  452. package/src/server/request-log-conversation.ts +45 -2
  453. package/src/server/request-log-terminal-status.ts +210 -24
  454. package/src/server/request-log.ts +71 -79
  455. package/src/server/responses/adapter-continuation.ts +2 -1
  456. package/src/server/responses/adapter-delivery.ts +2 -0
  457. package/src/server/responses/adapter-dispatch.ts +5 -7
  458. package/src/server/responses/advisor-plan-slot.ts +33 -1
  459. package/src/server/responses/advisor-question.ts +21 -0
  460. package/src/server/responses/advisor-slot.ts +10 -3
  461. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  462. package/src/server/responses/buffered-sse-json.ts +9 -3
  463. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  464. package/src/server/responses/codex-tool-catalog.ts +156 -0
  465. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  466. package/src/server/responses/combo-stream-preflight.ts +557 -54
  467. package/src/server/responses/compact.ts +32 -8
  468. package/src/server/responses/core-codex-account.ts +17 -3
  469. package/src/server/responses/core-combo-failure.ts +8 -0
  470. package/src/server/responses/core-combo.ts +32 -4
  471. package/src/server/responses/core-errors.ts +5 -2
  472. package/src/server/responses/core-lifetime.ts +3 -2
  473. package/src/server/responses/core-normalize.ts +3 -1
  474. package/src/server/responses/core-options.ts +6 -0
  475. package/src/server/responses/core.ts +2 -0
  476. package/src/server/responses/fetch-helpers.ts +15 -10
  477. package/src/server/responses/native-replay-guard.ts +57 -0
  478. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  479. package/src/server/responses/outbound-request-body.ts +29 -0
  480. package/src/server/responses/passthrough-completion.ts +105 -8
  481. package/src/server/responses/passthrough-delivery.ts +31 -11
  482. package/src/server/responses/passthrough-dispatch.ts +74 -73
  483. package/src/server/responses/policy-fallback.ts +13 -1
  484. package/src/server/responses/request-prepare.ts +50 -6
  485. package/src/server/responses/request-transport.ts +10 -3
  486. package/src/server/responses/reset-replay.ts +46 -2
  487. package/src/server/responses/run-turn-execution.ts +2 -0
  488. package/src/server/responses/sidecar-execution.ts +14 -0
  489. package/src/server/responses/terminal-error-redaction.ts +222 -25
  490. package/src/server/responses/ws-upstream.ts +2 -2
  491. package/src/server/sse-payload-rewrite.ts +3 -2
  492. package/src/server/stop-service-route.ts +85 -0
  493. package/src/server/system-env-shell.ts +12 -1
  494. package/src/server/system-env.ts +5 -3
  495. package/src/server/windows-tcp-drop.ts +21 -4
  496. package/src/server/workflow-refusal.ts +8 -0
  497. package/src/server/ws-bridge.ts +191 -12
  498. package/src/service/cli-windows-stop.ts +189 -0
  499. package/src/service/cli.ts +41 -12
  500. package/src/service/disconnected-client-restart.ts +60 -0
  501. package/src/service/guarded-manager-target.ts +18 -1
  502. package/src/service/health.ts +99 -6
  503. package/src/service/launchd.ts +84 -31
  504. package/src/service/orchestration.ts +418 -91
  505. package/src/service/repair.ts +223 -6
  506. package/src/service/restart-proxy-stop.ts +79 -0
  507. package/src/service/service-child-ownership.ts +6 -2
  508. package/src/service/windows-checked-stop-live.ts +467 -0
  509. package/src/service/windows-checked-stop.ts +435 -0
  510. package/src/service/windows-command-line-token.ts +23 -0
  511. package/src/service/windows-guarded-manager.ts +77 -34
  512. package/src/service/windows-ops.ts +38 -56
  513. package/src/service/windows-process-evidence.ts +292 -0
  514. package/src/service/windows-process-native.ts +262 -0
  515. package/src/service/windows-service-stop.ts +321 -0
  516. package/src/service/windows-stop-binding.ts +187 -0
  517. package/src/service/windows-stop-budget.ts +123 -0
  518. package/src/service/windows-stop-confirm.ts +158 -0
  519. package/src/service/windows-stop-deadline.ts +56 -0
  520. package/src/service.ts +2 -2
  521. package/src/types/config.ts +42 -18
  522. package/src/types/link.ts +20 -0
  523. package/src/types/multi-agent.ts +13 -0
  524. package/src/types/provider.ts +47 -2
  525. package/src/types/request.ts +4 -0
  526. package/src/types.ts +3 -0
  527. package/src/update/guarded-runtime-ops.ts +5 -7
  528. package/src/update/index.ts +25 -10
  529. package/src/update/install-detection.mjs +3 -1
  530. package/src/update/job-pinned-start.ts +2 -0
  531. package/src/update/job-windows-restart.ts +19 -32
  532. package/src/update/job.ts +12 -5
  533. package/src/update/npm-install.d.mts +11 -0
  534. package/src/update/npm-install.mjs +44 -7
  535. package/src/update/orchestrated-entry.ts +1 -1
  536. package/src/update/orchestrated-node-driver.mjs +3 -2
  537. package/src/update/orchestrated-pnpm.d.mts +4 -0
  538. package/src/update/orchestrated-pnpm.mjs +50 -6
  539. package/src/update/orchestrated-session.d.mts +3 -1
  540. package/src/update/orchestrated-session.mjs +21 -6
  541. package/src/update/pnpm-global-install.d.mts +21 -3
  542. package/src/update/pnpm-global-install.mjs +322 -19
  543. package/src/update/pnpm-store-layout.mjs +46 -0
  544. package/src/update/sync-update-mutex.d.mts +3 -2
  545. package/src/update/sync-update-mutex.mjs +57 -8
  546. package/src/update/transactional-install.d.mts +3 -1
  547. package/src/update/transactional-install.mjs +545 -12
  548. package/src/update/windows-installer-marker.d.mts +1 -0
  549. package/src/update/windows-installer-marker.mjs +44 -0
  550. package/src/usage/expected-prices.ts +8 -0
  551. package/src/usage/filter-index.ts +326 -77
  552. package/src/usage/ledger-scanner.ts +15 -0
  553. package/src/usage/link-log-fields.ts +48 -0
  554. package/src/usage/log.ts +43 -2
  555. package/src/usage/request-body.ts +37 -0
  556. package/src/web-search/loop.ts +3 -0
  557. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  558. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  559. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  560. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  561. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,84 @@
1
+ import { compressedBodyDecodeLimit } from "../server/request-decompress";
2
+ import { createInboundBodyBudget, type InboundBodyBudget } from "../server/inbound-body-budget";
3
+ import {
4
+ LINK_REQUEST_COMPRESSIBLE_PATHS, LINK_REQUEST_COMPRESSION_MAX_BYTES, LINK_REQUEST_COMPRESSION_MIN_BYTES, LINK_REQUEST_ZSTD_FEATURE,
5
+ } from "../link/request-compression";
6
+
7
+ /**
8
+ * What all bodies being prepared at once may hold: each reserves twice its declared length (its
9
+ * bytes and their zstd form) until the Home answered and the transport flushed it or tore its request down, and a body that does not fit now streams
10
+ * unchanged instead of waiting. Four bodies at the 16 MiB bound fill it.
11
+ */
12
+ export const LINK_REQUEST_PREPARE_BUDGET_BYTES = 128 * 1024 * 1024;
13
+ export const linkRequestPrepareBudget: InboundBodyBudget = createInboundBodyBudget(LINK_REQUEST_PREPARE_BUDGET_BYTES, 0);
14
+
15
+ /** One body ready for the link: the caller's bytes and, when it paid off, their zstd form. */
16
+ export interface PreparedLinkBody { raw: Uint8Array<ArrayBuffer>; zstd: Uint8Array<ArrayBuffer> | null }
17
+
18
+ export type LinkBodyCompressor = (raw: Uint8Array) => Promise<Uint8Array>;
19
+
20
+ /** One-shot zstd, level 3, per body. Never a streaming context reused across bodies. */
21
+ export const defaultLinkBodyCompressor: LinkBodyCompressor = raw => Bun.zstdCompress(raw, { level: 3 });
22
+
23
+ /**
24
+ * Whether a request body may be buffered and compressed: a POST on a route whose Home handler
25
+ * decodes Content-Encoding, carrying no Content-Encoding of its own, with a declared length above
26
+ * the threshold and within the buffering bound. A chunked body (no declared length) streams as is.
27
+ */
28
+ export function linkRequestCompressible(url: URL, req: Request, declaredLength: string | null): boolean {
29
+ if (req.method !== "POST" || !req.body || !LINK_REQUEST_COMPRESSIBLE_PATHS.has(url.pathname)) return false;
30
+ if (req.headers.has("content-encoding") || declaredLength === null || !/^\d+$/.test(declaredLength)) return false;
31
+ const length = Number(declaredLength);
32
+ return length > LINK_REQUEST_COMPRESSION_MIN_BYTES && length <= LINK_REQUEST_COMPRESSION_MAX_BYTES;
33
+ }
34
+
35
+ /**
36
+ * Read exactly the declared bytes into one buffer. More than declared is refused, and so is a body
37
+ * that ends cleanly with fewer: forwarding that shorter slice would tell the Home it is complete.
38
+ */
39
+ export async function readDeclaredBody(body: ReadableStream<Uint8Array>, declared: number, signal: AbortSignal): Promise<Uint8Array<ArrayBuffer>> {
40
+ const reader = body.getReader();
41
+ const out = new Uint8Array(declared);
42
+ let filled = 0;
43
+ const onAbort = () => { void reader.cancel(signal.reason).catch(() => undefined); };
44
+ signal.addEventListener("abort", onAbort, { once: true });
45
+ try {
46
+ for (;;) {
47
+ signal.throwIfAborted();
48
+ const next = await reader.read();
49
+ signal.throwIfAborted();
50
+ if (next.done) break;
51
+ if (next.value.byteLength > declared - filled) throw new RangeError("link request body longer than declared");
52
+ out.set(next.value, filled);
53
+ filled += next.value.byteLength;
54
+ }
55
+ } finally {
56
+ signal.removeEventListener("abort", onAbort);
57
+ try { reader.releaseLock(); } catch { /* a pending cancel may hold it */ }
58
+ }
59
+ if (filled !== declared) throw new RangeError("link request body shorter than declared");
60
+ return out;
61
+ }
62
+
63
+ /**
64
+ * The zstd form when compression succeeds, saves bytes, and stays within the ratio the Home's
65
+ * decoder admits (`compressedBodyDecodeLimit`, the policy `link-request-zstd/1` names); otherwise
66
+ * null and the raw body goes, which the Home admits under its ordinary limit as before.
67
+ */
68
+ export async function compressLinkBody(raw: Uint8Array, compress: LinkBodyCompressor = defaultLinkBodyCompressor): Promise<Uint8Array<ArrayBuffer> | null> {
69
+ try {
70
+ const out = await compress(raw);
71
+ return out instanceof Uint8Array && out.byteLength > 0 && out.byteLength < raw.byteLength
72
+ && raw.byteLength <= compressedBodyDecodeLimit(out.byteLength, Number.POSITIVE_INFINITY) ? out as Uint8Array<ArrayBuffer> : null;
73
+ } catch {
74
+ return null;
75
+ }
76
+ }
77
+
78
+ /** The body for one connection, given the features its Home just named. */
79
+ export function chooseLinkBody(prepared: PreparedLinkBody, homeFeatures: readonly string[] | null): { body: Uint8Array<ArrayBuffer>; headers: Record<string, string> } {
80
+ if (prepared.zstd && homeFeatures?.includes(LINK_REQUEST_ZSTD_FEATURE)) {
81
+ return { body: prepared.zstd, headers: { "content-encoding": "zstd", "content-length": String(prepared.zstd.byteLength) } };
82
+ }
83
+ return { body: prepared.raw, headers: { "content-length": String(prepared.raw.byteLength) } };
84
+ }
@@ -47,22 +47,28 @@ export function childLinkMarkerPath(configDir?: string): string {
47
47
  return join(linkDir(configDir), "child-initiated.json");
48
48
  }
49
49
 
50
- /** True when the marker names `linkId`, or when a marker exists but cannot be read. */
51
- export function isChildInitiatedLink(linkId: string, path: string = childLinkMarkerPath()): boolean {
50
+ /** The Child-initiated marker: absent, naming a link, or present but unreadable. */
51
+ export function readChildLinkMarker(path: string = childLinkMarkerPath()): { kind: "absent" } | { kind: "link"; linkId: string } | { kind: "unreadable" } {
52
52
  let text: string;
53
53
  try {
54
54
  text = readFileSync(path, "utf8");
55
55
  } catch (error) {
56
- return !isMissingPathError(error);
56
+ return isMissingPathError(error) ? { kind: "absent" } : { kind: "unreadable" };
57
57
  }
58
58
  try {
59
59
  const raw = JSON.parse(text) as { linkId?: unknown };
60
- return typeof raw?.linkId !== "string" || raw.linkId === linkId;
60
+ return typeof raw?.linkId === "string" ? { kind: "link", linkId: raw.linkId } : { kind: "unreadable" };
61
61
  } catch {
62
- return true;
62
+ return { kind: "unreadable" };
63
63
  }
64
64
  }
65
65
 
66
+ /** True when the marker names `linkId`, or when a marker exists but cannot be read. */
67
+ export function isChildInitiatedLink(linkId: string, path: string = childLinkMarkerPath()): boolean {
68
+ const marker = readChildLinkMarker(path);
69
+ return marker.kind === "unreadable" || (marker.kind === "link" && marker.linkId === linkId);
70
+ }
71
+
66
72
  /**
67
73
  * Record the marker for a join made before markers existed. Called at runtime start while the
68
74
  * sidecar is still intact, so a sidecar deleted afterwards cannot turn that link into a
@@ -1,10 +1,12 @@
1
1
  import { lstatSync } from "node:fs";
2
2
  import { isMissingPathError } from "../config/atomic-write";
3
- import { readClientLinkState, childLinkMarkerPath } from "./link-state";
3
+ import { readClientLinkState, childLinkMarkerPath, isChildInitiatedLink } from "./link-state";
4
4
  import type { ClientLinkIdentity } from "../link/status-projection";
5
5
  import type { LinkStatusDto } from "../link/status-projection";
6
6
  import type { ClientLinkState } from "./link-state";
7
7
  import type { ClientLinkSupervisorStatus } from "./link-tunnel";
8
+ import { EMPTY_LINK_CHILD_PARITY } from "../link/child-parity";
9
+ import type { OcxClientConnectionConfig } from "../types";
8
10
 
9
11
  /** What the status route read from the client sidecar: the state, none, or an unreadable file. */
10
12
  export type ClientLinkSidecarRead = ClientLinkState | null | "invalid";
@@ -42,6 +44,42 @@ function childState(sidecar: ClientLinkSidecarRead, supervisor: ClientLinkSuperv
42
44
  };
43
45
  }
44
46
 
47
+ /**
48
+ * The connected Child's own link as a status row, for `?traffic=1` (#3023), which attaches its
49
+ * counters to it. Only a Child-initiated link writes a sidecar, so:
50
+ * - a sidecar for this link names the SSH alias, the direction and the tunnel state;
51
+ * - an unreadable sidecar, or one naming another link, leaves the alias unknown and the row failed
52
+ * (`sidecar_invalid`, `sidecar_mismatch`);
53
+ * - no sidecar while the durable Child-initiated marker names this link (or cannot be read) is a
54
+ * lost sidecar: failed (`sidecar_missing`), alias unknown;
55
+ * - otherwise no sidecar is a Home-initiated link, which owns no tunnel here and reads idle since it
56
+ * connected, as the management projection reads it.
57
+ * Parity fields are the Home's view and stay empty.
58
+ */
59
+ export function projectClientLinkRow(
60
+ connection: Pick<OcxClientConnectionConfig, "serverUrl" | "connectedAt"> & { link: { linkId: string; tunnelPort: number } },
61
+ sidecar: ClientLinkSidecarRead,
62
+ child: LinkStatusDto["child"],
63
+ now: number,
64
+ childInitiated: (linkId: string) => boolean = (linkId: string) => isChildInitiatedLink(linkId),
65
+ /** The Home's recorded name for a Home-initiated row; never the loopback URL this Child connects to. */
66
+ homeName: string | null = null,
67
+ ): LinkStatusDto["links"][number] {
68
+ const base = { id: connection.link.linkId, tunnelPort: connection.link.tunnelPort, ...EMPTY_LINK_CHILD_PARITY };
69
+ if (sidecar === null && childInitiated(connection.link.linkId)) {
70
+ return { ...base, alias: "unknown", direction: "client-initiated", state: "failed", since: new Date(now).toISOString(), reason: "sidecar_missing" };
71
+ }
72
+ if (sidecar === null) {
73
+ return { ...base, alias: homeName ?? "unknown", direction: "hub-initiated", state: "idle", since: connection.connectedAt, reason: null };
74
+ }
75
+ if (sidecar === "invalid" || sidecar.linkId !== connection.link.linkId) {
76
+ const reason = sidecar === "invalid" ? "sidecar_invalid" : "sidecar_mismatch";
77
+ return { ...base, alias: "unknown", direction: "client-initiated", state: "failed", since: new Date(now).toISOString(), reason };
78
+ }
79
+ const state = child ?? { state: "idle" as const, since: new Date(now).toISOString(), reason: null };
80
+ return { ...base, alias: sidecar.alias, direction: "client-initiated", state: state.state, since: state.since, reason: state.reason };
81
+ }
82
+
45
83
  /** Only client-owned evidence can establish who owns the tunnel. Unreadable evidence stays unknown. */
46
84
  export function clientLinkStatusIdentity(linkId: string): ClientLinkIdentity | null {
47
85
  try {
@@ -49,6 +49,7 @@ export async function teardownClientLink(
49
49
  alias: sidecar.alias,
50
50
  argv: remoteOcxArgv(["link", "revoke", "--link-id", sidecar.linkId]),
51
51
  knownHostsFile: deps.knownHostsFile,
52
+ route: null,
52
53
  }),
53
54
  { timeoutMs: deps.timeoutMs ?? HOME_REVOKE_TIMEOUT_MS },
54
55
  );
@@ -9,6 +9,7 @@ import { getConfigPath } from "../config/paths";
9
9
  import { readBoundedResponseBytes } from "../lib/bounded-body";
10
10
  import { linkDir, linkKnownHostsPath } from "../link/paths";
11
11
  import { buildTunnelArgv } from "../link/ssh-argv";
12
+ import { defaultSshCaptureOpener, openSshCapture, retainSshCapture, type SshCaptureOpener } from "../link/ssh-capture";
12
13
  import { createSshRunner, type SshChild, type SshRunner } from "../link/ssh-runner";
13
14
  import {
14
15
  CLIENT_TUNNEL_RETRY_POLICY,
@@ -23,6 +24,7 @@ import {
23
24
  import { isLinkPort } from "../link/ports";
24
25
  import { inspectIpv4LoopbackListener, type LoopbackOwnerLookupResult } from "../server/port-reclaim";
25
26
  import type { LinkDiagnosticSink } from "../link/diagnostics";
27
+ import { createTunnelHistoryBook, exitCause, type TunnelCause } from "../link/tunnel-history";
26
28
  import { isLinkConnection, readClientConnectionState } from "./state";
27
29
  import { clientLinkStatePath, readClientLinkState, type ClientLinkState } from "./link-state";
28
30
  import type { LinkTunnelGate, LinkAdmissionResult } from "./link-relay";
@@ -52,6 +54,8 @@ export interface ClientLinkTunnelDeps {
52
54
  runner?: SshRunner;
53
55
  configDir?: string;
54
56
  knownHostsFile?: string;
57
+ /** Opt-in SSH capture (src/link/ssh-capture.ts); defaults to the one for this configuration home. */
58
+ sshCapture?: SshCaptureOpener;
55
59
  setTimer?: (callback: () => void, ms: number) => ReturnType<typeof setTimeout>;
56
60
  clearTimer?: (timer: ReturnType<typeof setTimeout>) => void;
57
61
  }
@@ -136,6 +140,8 @@ export interface ClientLinkSupervisorDeps extends ClientLinkTunnelDeps, OrphanRe
136
140
  connectedLinkId?: () => string | null | typeof CONNECTION_UNREADABLE;
137
141
  /** Called once after the tunnel stopped because the link ended (the runtime recycles here). */
138
142
  onLinkEnded?: () => void;
143
+ /** Test seam: called once the start-up check (leftover tunnel, first spawn) has finished. */
144
+ onInitialized?: () => void;
139
145
  /** The link key for the keyed readiness probe. The runtime passes its cached key source. */
140
146
  linkKey?: () => string | null;
141
147
  /** Async local IPv4 LISTEN ownership; an unknown or foreign owner never receives the link key. */
@@ -167,6 +173,8 @@ export interface ClientTunnelPidfile {
167
173
  }
168
174
 
169
175
  const STOP_TIMEOUT_MS = 5_000;
176
+ /** A Child supervises one tunnel; its history needs one fixed key, never the link id. */
177
+ const CHILD_TUNNEL_HISTORY_KEY = "child";
170
178
  const REAP_POLL_MS = 100;
171
179
  const TIMER_MS = 1_000;
172
180
  /** Consecutive unreadable reads before the supervisor acts on them. */
@@ -381,14 +389,18 @@ export function spawnClientLinkTunnel(spec: ClientLinkTunnelSpec, deps: ClientLi
381
389
  if (!isLinkPort(spec.tunnelPort)) throw new Error("client tunnel port is outside the link range");
382
390
  const knownHostsFile = deps.knownHostsFile ?? linkKnownHostsPath(deps.configDir);
383
391
  const runner = deps.runner ?? createSshRunner();
392
+ // Off unless the operator opened a capture window on this machine; then only the level changes.
393
+ const capture = openSshCapture(deps.sshCapture ?? defaultSshCaptureOpener(linkDir(deps.configDir)), "child", spec.linkId);
384
394
  const argv = buildTunnelArgv({
385
395
  alias: spec.alias,
386
396
  direction: "L",
387
397
  bindPort: spec.tunnelPort,
388
398
  targetPort: spec.peerListenerPort,
389
399
  knownHostsFile,
400
+ ...(capture ? { logLevel: capture.logLevel } : {}),
401
+ route: null,
390
402
  });
391
- const child = runner.spawnTunnel(argv);
403
+ const child = capture ? runner.spawnTunnel(argv, { stderrLine: capture.stderrLine }) : runner.spawnTunnel(argv);
392
404
  const pidfile = clientTunnelPidfilePath(deps.configDir);
393
405
  const startTime = processStartTime(child.pid, process.platform, deps);
394
406
  try {
@@ -592,9 +604,19 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
592
604
  });
593
605
  const clearSupervisorTimer = deps.clearTimer
594
606
  ?? ((timer: ReturnType<typeof setTimeout>) => clearInterval(timer as unknown as ReturnType<typeof setInterval>));
607
+ // Capture files an earlier process wrote are deleted on time even if this one never spawns.
608
+ if (!deps.sshCapture) retainSshCapture(linkDir(deps.configDir));
595
609
  let timer: ReturnType<typeof setTimeout> | undefined;
596
610
  let started = false;
597
611
  let stopping = false;
612
+ // Told once when stop() begins or the link ends (endLink), before the tunnel is signalled (the link
613
+ // WebSocket drains here).
614
+ const stoppingListeners: Array<() => void> = [];
615
+ const notifyStopping = (): void => {
616
+ for (const listener of stoppingListeners.splice(0)) {
617
+ try { listener(); } catch { /* a listener never delays the stop */ }
618
+ }
619
+ };
598
620
  let initialized = false;
599
621
  let initializing = false;
600
622
  let onLinkEndedCalled = false;
@@ -607,6 +629,20 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
607
629
  /** Minted on every transition into connected from the process-wide sequence (relay-auth.ts). */
608
630
  let connection: string | undefined;
609
631
  let state: TunnelState = IDLE;
632
+ /**
633
+ * Child tunnel transitions go to the same bounded diagnostics file as the Home's, with the same
634
+ * fixed causes (#7297). The port is remembered past stop, which clears the live port first.
635
+ */
636
+ let lastTunnelPort: number | undefined;
637
+ // The record is built at the transition but delivered after the current synchronous step, so a
638
+ // sink that re-enters the supervisor (stop, status) never runs in the middle of a transition.
639
+ const transitionSink = deps.diagnostic;
640
+ const history = createTunnelHistoryBook({
641
+ diagnostic: transitionSink
642
+ ? record => queueMicrotask(() => { try { transitionSink(record); } catch { /* best effort */ } })
643
+ : undefined,
644
+ tunnelPort: () => lastTunnelPort,
645
+ });
610
646
  let linkId: string | null = null;
611
647
  let failure: ClientLinkSupervisorStatus | undefined;
612
648
  let tickFlight: Promise<void> | undefined;
@@ -689,9 +725,12 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
689
725
  for (const settle of [...waiters]) settle(ready);
690
726
  };
691
727
 
692
- const setState = (next: TunnelState): void => {
728
+ const setState = (next: TunnelState, cause: TunnelCause | null = null): void => {
729
+ const before = state;
693
730
  if (next.kind === "connected" && state.kind !== "connected") connection = nextLinkConnectionGeneration();
694
731
  state = next;
732
+ // Records only a real change and swallows sink errors; diagnostics never steer the lifecycle.
733
+ history.observe(CHILD_TUNNEL_HISTORY_KEY, before, next, cause, now());
695
734
  settleWaiters();
696
735
  };
697
736
 
@@ -742,6 +781,8 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
742
781
  };
743
782
 
744
783
  const endLink = async (): Promise<void> => {
784
+ // The link ended and the runtime recycles: listeners drain before the tunnel goes, as on stop().
785
+ notifyStopping();
745
786
  await stopTunnel();
746
787
  if (onLinkEndedCalled || stopping) return;
747
788
  linkId = null;
@@ -750,7 +791,7 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
750
791
  };
751
792
 
752
793
  const onExit = (stderrClass: StderrClass): void => {
753
- setState(reduceTunnel(state, { type: "exit", now: now(), stderrClass }, random, policy));
794
+ setState(reduceTunnel(state, { type: "exit", now: now(), stderrClass }, random, policy), exitCause(stderrClass));
754
795
  };
755
796
 
756
797
  const spawn = (sidecar: ClientLinkState): void => {
@@ -766,13 +807,16 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
766
807
  }, deps);
767
808
  } catch {
768
809
  // A due retry that cannot start counts as a failed retry, so the backoff keeps its step.
769
- setState(failedSpawnTunnel(state, "forward", timestamp, policy));
810
+ lastTunnelPort = sidecar.tunnelPort;
811
+ setState(failedSpawnTunnel(state, "forward", timestamp, policy), "spawn_failed");
770
812
  deps.warn?.("client link tunnel could not be started");
771
813
  return;
772
814
  }
773
815
  invalidateOwnerProof();
774
816
  linkId = sidecar.linkId;
775
817
  tunnelPort = sidecar.tunnelPort;
818
+ lastTunnelPort = sidecar.tunnelPort;
819
+ history.spawned(CHILD_TUNNEL_HISTORY_KEY);
776
820
  probe = null;
777
821
  probeFailures = 0;
778
822
  nextProbeAt = timestamp;
@@ -871,6 +915,7 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
871
915
  invalidateOwnerProof();
872
916
  linkId = afterReap.sidecar.linkId;
873
917
  tunnelPort = afterReap.sidecar.tunnelPort;
918
+ lastTunnelPort = afterReap.sidecar.tunnelPort;
874
919
  nextProbeAt = now();
875
920
  setState({ kind: "connecting", since: now() });
876
921
  return;
@@ -919,7 +964,8 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
919
964
  probe = null;
920
965
  setState(IDLE);
921
966
  }
922
- setState(reduceTunnel(state, { type: "tick", now: now() }, random, policy));
967
+ // A tick changes state only when the outage limit fails the link, so its cause is the timeout.
968
+ setState(reduceTunnel(state, { type: "tick", now: now() }, random, policy), "timeout");
923
969
  // An adopted tunnel is never killed. Failed identity or socket-owner proof keeps it
924
970
  // unprobed and unable to promote, even when the process stays alive after a timeout.
925
971
  if (state.kind === "failed" && !state.inFlight && adopted !== null) setState({ ...state, inFlight: true });
@@ -958,6 +1004,7 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
958
1004
  initialized = true;
959
1005
  initializing = false;
960
1006
  settleWaiters();
1007
+ try { deps.onInitialized?.(); } catch { /* a test seam never alters the supervisor */ }
961
1008
  }
962
1009
  };
963
1010
 
@@ -980,6 +1027,7 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
980
1027
  return;
981
1028
  }
982
1029
  stopping = true;
1030
+ notifyStopping();
983
1031
  abortProbe();
984
1032
  settleWaiters();
985
1033
  if (timer !== undefined) {
@@ -990,6 +1038,9 @@ export function createClientLinkSupervisor(deps: ClientLinkSupervisorDeps = {}):
990
1038
  await stopTunnel();
991
1039
  failure = undefined;
992
1040
  },
1041
+ onStopping(listener: () => void): void {
1042
+ stoppingListeners.push(listener);
1043
+ },
993
1044
  connectionGeneration(): string | undefined {
994
1045
  if (!started || stopping || failure !== undefined || state.kind !== "connected") return undefined;
995
1046
  return connection;
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Every cap, budget and timeout of the Responses WebSocket over a Remote Link, Child side (design T4
3
+ * sections 3.2, 3.3 and 6), in one place so review can change a number without hunting for it. The
4
+ * values are the recommended answers to the owner decisions the feature depends on (D2, D3); nothing
5
+ * here turns the feature on.
6
+ */
7
+ const KiB = 1024;
8
+ const MiB = 1024 * KiB;
9
+
10
+ export interface LinkChildWebsocketLimits {
11
+ /** Steps 5 to 9 of design 3.2 (tunnel gate, preflight, upgrade); below Codex's 15 s connect timeout. */
12
+ setupBudgetMs: number;
13
+ /** How long an upgrade waits for a Child tunnel that is connecting or reconnecting before 503. */
14
+ tunnelHoldMs: number;
15
+ /** The credential-free preflight on the upgrade's own connection. */
16
+ preflightMs: number;
17
+ /** Open plus setting-up link sockets on this Child (D3). */
18
+ openSockets: number;
19
+ /** Of those, sockets still in setup. */
20
+ settingUp: number;
21
+ /** The transport worst case one link socket reserves at admission (design 6.3). */
22
+ socketReservationBytes: number;
23
+ /** The process budget those reservations draw from (D3). */
24
+ memoryBudgetBytes: number;
25
+ /** Largest message the Home may send: one SSE event of at most 4 MiB, plus room for framing. */
26
+ homeMessageBytes: number;
27
+ /** Largest message Codex may send; advertised to Codex in the local 101 (C7). */
28
+ localMessageBytes: number;
29
+ /** Frames one Home message may be split into. */
30
+ maxFragments: number;
31
+ /** Above this many bytes buffered toward Codex, the Child stops reading the Home leg until it drains. */
32
+ downlinkPauseBytes: number;
33
+ /** Bun's send-buffer limit on the local socket; the pause above keeps sends far below it. */
34
+ localBackpressureBytes: number;
35
+ /** A close the Child starts on the Home leg waits this long for the Home's close before it destroys the socket. */
36
+ closeHandshakeMs: number;
37
+ }
38
+
39
+ export const LINK_CHILD_WS_LIMITS: Readonly<LinkChildWebsocketLimits> = Object.freeze({
40
+ setupBudgetMs: 8_000,
41
+ tunnelHoldMs: 3_000,
42
+ preflightMs: 5_000,
43
+ openSockets: 8,
44
+ settingUp: 4,
45
+ socketReservationBytes: 32 * MiB,
46
+ memoryBudgetBytes: 256 * MiB,
47
+ homeMessageBytes: 4 * MiB + 64 * KiB,
48
+ localMessageBytes: 8 * MiB,
49
+ maxFragments: 4_096,
50
+ downlinkPauseBytes: 1 * MiB,
51
+ localBackpressureBytes: 8 * MiB,
52
+ closeHandshakeMs: 5_000,
53
+ });
54
+
55
+ /** The header Codex reads on a 101 to keep larger requests off the socket (codex-rs C7). */
56
+ export const CODEX_WS_MAX_MESSAGE_HEADER = "x-codex-websocket-max-message-bytes";
57
+
58
+ /**
59
+ * Release gate, Child side. While false, every Codex upgrade gets today's 426 with no network I/O,
60
+ * whatever a Home advertises. It stays false until the framer's client conformance run (Autobahn
61
+ * fuzzingserver, design 3.3) and the Child's transport-only RSS acceptance (design 6.3) have passed.
62
+ * Tests of the relay turn it on for themselves only.
63
+ */
64
+ let childReady = false;
65
+
66
+ export function linkWebsocketChildReady(): boolean {
67
+ return childReady;
68
+ }
69
+
70
+ export function setLinkWebsocketChildReadyForTests(ready: boolean): void {
71
+ childReady = ready;
72
+ }
73
+
74
+ /**
75
+ * Test-only stall signal for the Child's HTTP relay (src/client/link-relay.ts), the counterpart of the Home's
76
+ * setLinkRelayWaitObserverForTests: told true when a relayed response has handed its reader a chunk and the
77
+ * reader has not asked for the next one, and false when it asks again or cancels, or the relay ends, after which it
78
+ * never reports true again. It is for the Child's memory acceptance (design 6.3), to see the relay hold a stalled
79
+ * reader. Null in production, where the relay builds its response exactly as without it.
80
+ */
81
+ let childRelayWaitObserver: ((waiting: boolean) => void) | null = null;
82
+
83
+ export function linkChildRelayWaitObserver(): ((waiting: boolean) => void) | null {
84
+ return childRelayWaitObserver;
85
+ }
86
+
87
+ export function setLinkChildRelayWaitObserverForTests(observer: ((waiting: boolean) => void) | null): void {
88
+ childRelayWaitObserver = observer;
89
+ }