@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
@@ -1,5 +1,6 @@
1
1
  import type { OcxConfig } from "../types";
2
- import { GUI_PAIR_BROWSER_ORIGIN_HEADER, GUI_PAIR_CAPABILITY_HEADER, standaloneGuiPairingOrigin } from "../lib/gui-pair-capability";
2
+ import { DESKTOP_GUI_PAIR_PATH, GUI_PAIR_BROWSER_ORIGIN_HEADER, GUI_PAIR_CAPABILITY_HEADER, standaloneGuiPairingOrigin } from "../lib/gui-pair-capability";
3
+ import { desktopGuiOrigin, hasDesktopForwardingHeaders } from "../lib/desktop-gui-origin";
3
4
  import { consumeGuiPairIntent, GUI_PAIR_INTENT_HEADER } from "../lib/gui-pair-intent";
4
5
  import { createGuiPairingGrant, type GuiSessionState } from "./gui-session";
5
6
 
@@ -13,11 +14,13 @@ export class GuiPairingIntentRequiredError extends Error {
13
14
  /** The serving route must authenticate the existing process-bound capability first. */
14
15
  export function deliverGuiPairingGrant(req: Request, config: OcxConfig, state: GuiSessionState) {
15
16
  const origin = req.headers.get(GUI_PAIR_BROWSER_ORIGIN_HEADER) ?? "";
17
+ const desktop = new URL(req.url).pathname === DESKTOP_GUI_PAIR_PATH;
18
+ if (desktop && (hasDesktopForwardingHeaders(req) || desktopGuiOrigin(config, origin) !== origin)) throw new GuiPairingIntentRequiredError();
16
19
  if (config.runtimeRole !== "hub") {
17
- if (standaloneGuiPairingOrigin(config) !== origin
20
+ if ((desktop ? desktopGuiOrigin(config, origin) : standaloneGuiPairingOrigin(config)) !== origin
18
21
  || !consumeGuiPairIntent(req.headers.get(GUI_PAIR_CAPABILITY_HEADER), req.headers.get(GUI_PAIR_INTENT_HEADER))) {
19
22
  throw new GuiPairingIntentRequiredError();
20
23
  }
21
24
  }
22
- return createGuiPairingGrant(origin, config, state);
25
+ return createGuiPairingGrant(origin, config, state, Date.now(), desktop);
23
26
  }
@@ -2,6 +2,7 @@ import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
2
2
  import type { OcxConfig } from "../types";
3
3
  import { canonicalGuiBrowserOrigin, standaloneGuiPairingOrigin } from "../lib/gui-pair-capability";
4
4
  import { authorizationCredential } from "../lib/authorization-scheme";
5
+ import { desktopGuiBinding, desktopGuiOrigin } from "../lib/desktop-gui-origin";
5
6
  import {
6
7
  isAllowedManagementOrigin,
7
8
  isApiAuthRequired,
@@ -38,6 +39,9 @@ export interface GuiPairingGrantRecord {
38
39
  expiresAt: number;
39
40
  failedAttempts?: number;
40
41
  localPairing?: true;
42
+ /** Only the signed Desktop route may create this process-local purpose. */
43
+ desktopPurpose?: true;
44
+ desktopBinding?: string;
41
45
  }
42
46
 
43
47
  export interface PairingAttemptContext {
@@ -265,9 +269,10 @@ export function createGuiPairingGrant(
265
269
  config: OcxConfig,
266
270
  state: GuiSessionState,
267
271
  now = Date.now(),
272
+ desktopPurpose = false,
268
273
  ): { grant: string; browserOrigin: string; serverOrigin: string; expiresAt: number } {
269
274
  const canonicalBrowserOrigin = canonicalGuiBrowserOrigin(browserOrigin);
270
- const localOrigin = standaloneGuiPairingOrigin(config);
275
+ const localOrigin = desktopPurpose ? desktopGuiOrigin(config, browserOrigin) : standaloneGuiPairingOrigin(config);
271
276
  const localPairing = localOrigin !== null && canonicalBrowserOrigin === localOrigin;
272
277
  const serverOrigin = config.runtimeRole === "hub"
273
278
  ? canonicalHttpOrigin(config.hub?.managementPublicOrigin) : localOrigin;
@@ -275,6 +280,7 @@ export function createGuiPairingGrant(
275
280
  !canonicalBrowserOrigin
276
281
  || canonicalBrowserOrigin !== browserOrigin
277
282
  || !serverOrigin
283
+ || (desktopPurpose && !localPairing)
278
284
  || (config.runtimeRole === "hub"
279
285
  ? !isRemoteGuiBrowserOriginAllowed(canonicalBrowserOrigin, config) : !localPairing)
280
286
  ) throw new TypeError("remote GUI origin is not allowed");
@@ -289,6 +295,7 @@ export function createGuiPairingGrant(
289
295
  } while (state.pairingGrants.has(digest));
290
296
  const expiresAt = now + GUI_PAIRING_GRANT_TTL_MS;
291
297
  state.pairingGrants.set(digest, { browserOrigin: canonicalBrowserOrigin, serverOrigin, expiresAt,
298
+ ...(desktopPurpose ? { desktopPurpose: true as const, desktopBinding: desktopGuiBinding(config) } : {}),
292
299
  ...(localPairing ? { localPairing: true as const } : {}) });
293
300
  return { grant, browserOrigin: canonicalBrowserOrigin, serverOrigin, expiresAt };
294
301
  }
@@ -368,6 +375,8 @@ export function consumeGuiPairingGrant(
368
375
  return attemptContext && !source.allowed ? source : null;
369
376
  }
370
377
  const [digest, record] = found;
378
+ // A Desktop grant adds only its own scope to an existing session, never ordinary pairing.
379
+ if (record.desktopPurpose) return null;
371
380
  // A live role/config change must not turn a hub grant into local operator consent, or vice versa.
372
381
  if (record.localPairing ? !localOrigin || record.serverOrigin !== localOrigin
373
382
  : config.runtimeRole !== "hub") return null;
@@ -1,4 +1,5 @@
1
1
  import {
2
+ compressedBodyDecodeLimit,
2
3
  MAX_DECOMPRESSED_BODY_BYTES,
3
4
  resolveInboundBodyLimitBytes,
4
5
  } from "./request-decompress";
@@ -133,9 +134,19 @@ function retainUntilResponseSettles(response: Response, signal: AbortSignal, rel
133
134
  return wrapped;
134
135
  }
135
136
 
137
+ /** A body that will be decoded: any Content-Encoding other than identity. */
138
+ function encodedBody(req: Request): boolean {
139
+ const encoding = req.headers.get("content-encoding")?.trim().toLowerCase();
140
+ return encoding !== undefined && encoding !== "" && encoding !== "identity";
141
+ }
142
+
136
143
  /**
137
- * Own one raised-limit HTTP request from before body reading through response
138
- * EOF/error or settled cancellation. Call only at the admitted HTTP boundary,
144
+ * Own one raised-limit or encoded HTTP request from before body reading through response
145
+ * EOF/error or settled cancellation. An encoded body joins the shared budget at every limit
146
+ * (#3023): it reserves what it may decode to (`compressedBodyDecodeLimit` of its declared wire
147
+ * bytes, or the whole limit without a declaration) before a byte is read, and the reader shrinks
148
+ * that to the measured size, so the decoded bodies held at once stay within the budget however
149
+ * small their wire bytes are. An identity body at the default limit is not gated, as before. Call only at the admitted HTTP boundary,
139
150
  * after auth/origin checks, not from readers or internal combo/translation hops.
140
151
  * pathname is the same canonical pathname used by the server's dispatcher.
141
152
  * The optional budget/wait override isolates lifecycle tests from the process-wide owner.
@@ -151,8 +162,9 @@ export async function withRaisedInboundBodyAdmission(
151
162
  const maxBytes = resolveInboundBodyLimitBytes(configuredLimit);
152
163
  // Native Ollama generation routes are served only on the authenticated listener, so they sit in
153
164
  // their own set: the loopback oracle checks CONFIGURABLE_JSON_BODY_ROUTES against that allowlist.
165
+ const raised = maxBytes > MAX_DECOMPRESSED_BODY_BYTES;
154
166
  if (req.method !== "POST" || !(CONFIGURABLE_JSON_BODY_ROUTES.has(pathname) || OLLAMA_JSON_BODY_ROUTES.has(pathname))
155
- || maxBytes <= MAX_DECOMPRESSED_BODY_BYTES || req.signal.aborted) {
167
+ || !(raised || encodedBody(req)) || req.signal.aborted) {
156
168
  return work();
157
169
  }
158
170
  const declared = req.headers.get("content-length");
@@ -162,9 +174,10 @@ export async function withRaisedInboundBodyAdmission(
162
174
  // protocol-specific 413 win over temporary capacity refusal, unchanged.
163
175
  return work();
164
176
  }
177
+ const reservation = raised || !Number.isFinite(declaredBytes) ? maxBytes : compressedBodyDecodeLimit(declaredBytes, maxBytes);
165
178
  let lease;
166
179
  try {
167
- lease = await (options?.budget ?? inboundBodyBudget).acquire(maxBytes, req.signal, options?.maxWaitMs);
180
+ lease = await (options?.budget ?? inboundBodyBudget).acquire(reservation, req.signal, options?.maxWaitMs);
168
181
  } catch (error) {
169
182
  cancelUnreadBody(req, error);
170
183
  if (options?.onAdmissionError) return options.onAdmissionError(error);
@@ -1,7 +1,20 @@
1
1
  import { createLinkRelaySessions, type LinkCatalogServed } from "./link-relay-sessions";
2
2
  import { createLinkPeerObservations, type LinkPeerEntry } from "../../link/peer-report";
3
3
  import { createLinkActivity, type LinkActivitySnapshot } from "../../link/child-activity";
4
- import type { Server } from "bun";
4
+ import type { Server, WebSocketHandler } from "bun";
5
+ import type { RequestPolicyView } from "../auth-cors";
6
+ import type { WsData } from "../ws-bridge";
7
+ import { createLinkWebsocketGate, linkLogRefs, marksResent, upstreamCompleted, type LinkWebsocketGateDeps } from "./link-websocket";
8
+ import type { StoredMark } from "../../link/ws-activity-holds";
9
+ import { LINK_TURN_HEADER, registerLinkTurnToken, releaseLinkTurnToken } from "../link-turn";
10
+ import { LINK_WS_LIMITS, linkWebsocketTransportReady } from "./link-websocket-limits";
11
+ import { createActivityHolds, type ClearHoldsResult, type LinkHoldsSummary } from "../../link/ws-activity-holds";
12
+ import type { LinkWsCounters } from "../../link/status-projection";
13
+ import { resultKeysOf } from "../../codex/websocket-activity";
14
+ import { dirname } from "node:path";
15
+ import { createLinkTrafficBook, type LinkTrafficCounters } from "../../link/traffic";
16
+ import { buildPeerFeatures } from "../../remote/features";
17
+ import { decodeRequestBody } from "../request-decompress";
5
18
  import {
6
19
  emptyLinkStore,
7
20
  readLinkStore,
@@ -12,6 +25,7 @@ import { linkStorePath } from "../../link/paths";
12
25
  import { linkRouteAllowed } from "../../link/routes";
13
26
  import { withConfigMutationLockSync } from "../../config/mutation-lock";
14
27
  import { registerFallbackLinkResolver } from "../../routing/fallback-policy";
28
+ import { captureChildRouteDefaults } from "../../routing/home-route-intent";
15
29
 
16
30
  export const LINK_INGRESS_HOSTNAME = "opencodex-link.invalid";
17
31
 
@@ -29,6 +43,16 @@ export interface LinkListenerStartContext<T> {
29
43
  keyFingerprints?: (apiKeyId: string) => readonly string[];
30
44
  /** The Home supervisor's current tunnel connection for a link (relay-auth.ts). */
31
45
  connectionGeneration?: (linkId: string) => string | undefined;
46
+ /** The Responses WebSocket over the link (link-websocket.ts); route fakes omit it. */
47
+ responsesWebsocket?: {
48
+ /** The shared Responses handler the public listener uses; link sockets wrap it. */
49
+ handler: WebSocketHandler<WsData>;
50
+ /** linkResponsesWebsocketEnabled on the live config. */
51
+ enabled(): boolean;
52
+ policy(): RequestPolicyView;
53
+ };
54
+ /** The features named on every relay-auth answer; this build's served features when absent. */
55
+ homeFeatures?: () => readonly string[];
32
56
  }
33
57
 
34
58
  export interface LinkListenerDeps {
@@ -37,6 +61,12 @@ export interface LinkListenerDeps {
37
61
  writeStore?: (path: string, store: LinkStore) => void;
38
62
  serve?: (options: Parameters<typeof Bun.serve>[0]) => Server<unknown>;
39
63
  warn?: (message: string) => void;
64
+ /** Freezes every default Children inherit (native switches and file ownership) before this listener can serve route intent. */
65
+ captureRouteDefaults?: () => void;
66
+ /** Delay before retry `attempt` (0-based) of a failed capture; tests shorten it. */
67
+ captureRetryDelayMs?: (attempt: number) => number;
68
+ /** Test seams for the link WebSocket gate: limits, timers, socket reservation, drain state. */
69
+ websocket?: Pick<LinkWebsocketGateDeps, "limits" | "timers" | "reserveSocket" | "draining">;
40
70
  }
41
71
 
42
72
  export type LinkListenerStatus = {
@@ -54,12 +84,25 @@ export interface LinkListenerLifecycle<T> {
54
84
  start(ctx: LinkListenerStartContext<T>): void;
55
85
  ensureStarted(): Promise<void>;
56
86
  linkAdmissionKeyIds(): ReadonlySet<string>;
57
- onAuthenticatedCatalog(listener: (apiKeyId: string) => void): () => void;
58
- notifyAuthenticatedCatalog(apiKeyId: string): void;
87
+ /** A key-admitted catalog request; routeProofId is a multi-route readiness proof it carried (src/link/route-proof.ts). */
88
+ onAuthenticatedCatalog(listener: (apiKeyId: string, routeProofId?: string) => void): () => void;
89
+ notifyAuthenticatedCatalog(apiKeyId: string, routeProofId?: string): void;
59
90
  /** What this Home last learned of a Child over the link; empty until it relays a request. */
60
91
  peerObservation(linkId: string): LinkPeerEntry;
61
92
  /** Relayed model traffic for one link (D5); legacy key admissions count against every link. */
62
93
  linkActivity(linkId: string, now: number): LinkActivitySnapshot;
94
+ /** The Home's own revoke path closes this link's WebSockets (4401) in the same task. */
95
+ closeLinkSockets(linkId: string): number;
96
+ /** Design 9.3: the link's live WebSocket counters (display only, reset at restart). */
97
+ linkTransport(linkId: string): LinkWsCounters;
98
+ /** The link's WebSocket activity holds and their reasons; null when nothing holds it (D8). */
99
+ linkHolds(linkId: string): LinkHoldsSummary | null;
100
+ /** The operator's clear of one link's activity holds (D8); never called automatically. */
101
+ clearLinkHolds(linkId: string): ClearHoldsResult;
102
+ /** Resolves once relayed requests already seen have been checked against activity holds. */
103
+ activityHoldsSettled(): Promise<void>;
104
+ /** Body bytes each link carried since this lifecycle started (#3023); zeros before any traffic. */
105
+ linkTraffic(linkId: string): LinkTrafficCounters;
63
106
  /** A Child read a whole 200 `GET /v1/catalog` body through the relay. */
64
107
  onCatalogServed(listener: (served: LinkCatalogServed) => void): () => void;
65
108
  status(): LinkListenerStatus;
@@ -85,12 +128,24 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
85
128
  let ensureFlight: Promise<void> | undefined;
86
129
  let closeFlight: Promise<void> | undefined;
87
130
  let stopped = false;
88
- const authenticatedCatalogListeners = new Set<(apiKeyId: string) => void>();
131
+ const authenticatedCatalogListeners = new Set<(apiKeyId: string, routeProofId?: string) => void>();
89
132
  const catalogServedListeners = new Set<(served: LinkCatalogServed) => void>();
90
133
  let lifecycleStatus: LinkListenerStatus = { state: "off", port: null, reason: null };
91
134
  const peers = createLinkPeerObservations();
92
135
  // Lifecycle-owned so a rebind keeps the book.
93
- const activity = createLinkActivity();
136
+ // Durable link WebSocket holds (design T4 section 5) live beside links.json. Nothing is read or
137
+ // written unless a crash fence exists or a link upgrade arms one.
138
+ const holds = createActivityHolds({
139
+ dir: dirname(storePath),
140
+ limits: LINK_WS_LIMITS,
141
+ // null, not []: an unreadable store must not let crash evidence be cleaned without its links.
142
+ linkIds: () => { try { return readStore(storePath).links.map(link => link.id); } catch { return null; } },
143
+ });
144
+ holds.start();
145
+ const activity = createLinkActivity({ held: linkId => holds.count(linkId) });
146
+ // Relayed requests being checked against holds; tests and shutdown can wait for them.
147
+ const holdObservations = new Set<Promise<void>>();
148
+ const traffic = createLinkTrafficBook("content-length");
94
149
 
95
150
  const setStatus = (state: LinkListenerStatus["state"], port: number | null, reason: string | null): void => {
96
151
  lifecycleStatus = { state, port, reason };
@@ -104,10 +159,55 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
104
159
  const readStoreForAdmission = (): LinkStore => {
105
160
  try { return readStore(storePath); } catch { return emptyLinkStore(); }
106
161
  };
162
+ // The one fingerprint predicate: relay-auth verification, session consumption, and the link
163
+ // WebSocket's per-frame authorization check all read links.json uncached through it.
164
+ const fingerprintsFor = (keyId: string, linkId: string): readonly string[] => {
165
+ if (!readStoreForAdmission().links.some(link => link.id === linkId && link.apiKeyId === keyId)) return [];
166
+ return startContext?.keyFingerprints?.(keyId) ?? [];
167
+ };
168
+ // The release gate comes first: until the bounded pump lands, the switch admits nothing.
169
+ const websocketEnabled = (): boolean => linkWebsocketTransportReady() && startContext?.responsesWebsocket?.enabled() === true;
170
+ const websocketGate = createLinkWebsocketGate({
171
+ ...deps.websocket,
172
+ // The same lifecycle-owned book relayed HTTP turns count in, so restart gates see link sockets.
173
+ activity,
174
+ holds,
175
+ // The same per-link traffic book as the relayed HTTP requests: a link socket is one request in it.
176
+ traffic,
177
+ enabled: websocketEnabled,
178
+ policy: () => startContext!.responsesWebsocket!.policy(),
179
+ authorized: identity => fingerprintsFor(identity.keyId, identity.linkId).includes(identity.fingerprint),
180
+ });
107
181
  // OCX-11: the fallback policy resolves a link data key to its link id through this slot.
108
182
  const releaseFallbackLinkResolver = registerFallbackLinkResolver(keyId =>
109
183
  readStoreForAdmission().links.find(link => link.apiKeyId === keyId)?.id);
110
184
 
185
+ // Children read route intent through this listener, and that read is pure: it never captures.
186
+ // So a failed capture (a busy config lock, a damaged route-intent.json, unresolved Aside
187
+ // ownership) is owed and retried with backoff until it succeeds, the listener closes or stops,
188
+ // and again on every ensureStarted. Meanwhile every Home-only writer still captures first.
189
+ let routeDefaultsOwed = false;
190
+ let captureAttempt = 0;
191
+ let captureRetry: ReturnType<typeof setTimeout> | undefined;
192
+ const retryDelay = deps.captureRetryDelayMs ?? (attempt => Math.min(1_000 * 2 ** attempt, 300_000));
193
+ const captureRouteDefaults = (): void => {
194
+ if (captureRetry) { clearTimeout(captureRetry); captureRetry = undefined; }
195
+ try {
196
+ (deps.captureRouteDefaults ?? captureChildRouteDefaults)();
197
+ routeDefaultsOwed = false;
198
+ captureAttempt = 0;
199
+ } catch (error) {
200
+ if (!routeDefaultsOwed) warn(`⚠ Child route defaults were not captured; retrying: ${error instanceof Error ? error.message : String(error)}`);
201
+ routeDefaultsOwed = true;
202
+ if (stopped) return;
203
+ captureRetry = setTimeout(() => {
204
+ captureRetry = undefined;
205
+ if (!stopped && routeDefaultsOwed) captureRouteDefaults();
206
+ }, retryDelay(captureAttempt++));
207
+ (captureRetry as { unref?: () => void }).unref?.();
208
+ }
209
+ };
210
+
111
211
  const bindIfNeeded = (): void => {
112
212
  if (stopped || listener || !startContext) return;
113
213
  let store: LinkStore;
@@ -121,12 +221,69 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
121
221
  setStatus("off", null, null);
122
222
  return;
123
223
  }
224
+ // Capture the Children's defaults from the Home's switches and integrations as they stand at
225
+ // startup, before any Home-only command can move one. A failure leaves the listener up and is
226
+ // retried (see above).
227
+ captureRouteDefaults();
124
228
  const requestedPort = store.listenerPort ?? 0;
125
- const sessions = createLinkRelaySessions({ peers, activity, connectionGeneration: linkId => startContext?.connectionGeneration?.(linkId),
126
- catalogServed: served => { for (const listener of catalogServedListeners) listener(served); }, fingerprints: (keyId, linkId) => {
127
- if (!readStoreForAdmission().links.some(link => link.id === linkId && link.apiKeyId === keyId)) return [];
128
- return startContext?.keyFingerprints?.(keyId) ?? [];
129
- } });
229
+ const linkWebsocket = startContext.responsesWebsocket;
230
+ // The resolved inbound limit (index.ts resolves maxInboundBodyBytes), fixed at bind like the public listener's. The
231
+ // handler re-resolves the live config per request, so after a live raise without a restart a coded body between the
232
+ // two limits is accepted but releases no hold until the next bind: the safe direction (the link stays in flight).
233
+ const inboundLimit = startContext.maxRequestBodySize;
234
+ const sessions = createLinkRelaySessions({ peers, activity, traffic, homeFeatures: () => startContext?.homeFeatures?.() ?? buildPeerFeatures(), connectionGeneration: linkId => startContext?.connectionGeneration?.(linkId),
235
+ catalogServed: served => { for (const listener of catalogServedListeners) listener(served); }, fingerprints: fingerprintsFor,
236
+ ...(linkWebsocket ? { upgrade: websocketGate.upgrade, websocketAdvertised: websocketEnabled } : {}),
237
+ observeResponsesRequest: (linkId, req) => {
238
+ const header = req.headers.get("thread-id");
239
+ const threadHashOf = (body: unknown): string | null => {
240
+ const record = body && typeof body === "object" ? body as Record<string, unknown> : {};
241
+ const metadata = record.client_metadata as Record<string, unknown> | undefined;
242
+ const threadId = header || (metadata && typeof metadata.thread_id === "string" ? metadata.thread_id : "");
243
+ try { return threadId ? holds.threadHash(threadId) : null; } catch { return null; }
244
+ };
245
+ // Running marks, and while the feature is on the request-log fields of design 9.1: the pipeline reports this
246
+ // request's expanded input and its terminal (src/server/link-turn.ts), through a token header it removes before
247
+ // anything is forwarded. With the feature off and no marks, no token is set and the request is unchanged.
248
+ let token: string | null = null;
249
+ const logging = websocketEnabled();
250
+ if (logging || holds.hasMarks(linkId)) {
251
+ let resent: StoredMark[] = [];
252
+ let threadHash: string | null = null;
253
+ token = registerLinkTurnToken({
254
+ expanded(body, chain) { threadHash = threadHashOf(body); resent = chain === "unexpanded" ? [] : marksResent(holds, linkId, threadHash, body); },
255
+ expansionFailed() { resent = []; },
256
+ terminal(status, source) { if (resent.length && threadHash && upstreamCompleted(status, source)) holds.releaseMarks(linkId, threadHash, resent); },
257
+ ...(logging ? { pacedReads: true, logFields: (body: unknown) => ({ transport: "http" as const, first: false, ...linkLogRefs(holds, linkId, header?.trim() ?? "", body) }) } : {}),
258
+ });
259
+ try { req.headers.set(LINK_TURN_HEADER, token); } catch { releaseLinkTurnToken(token); token = null; }
260
+ }
261
+ // Pending result keys: only a link with a releasable hold pays for reading a copy of the body. The
262
+ // request settles only holds that exist now, as it begins (a later hold may reuse an id).
263
+ let decide: ((accepted: boolean) => void) | undefined;
264
+ const beganAt = holds.sequence();
265
+ if (holds.releasable(linkId)) {
266
+ const decision = new Promise<boolean>(resolve => { decide = resolve; });
267
+ // The copy is read and decoded only after the handler accepted the request; a refusal, the inbound budget's 503
268
+ // included, cancels it unread (#8608). A Child may send the body coded (#8594); the copy is decoded through the
269
+ // handlers' bounded reader under the same resolved inbound limit, and a body that does not decode releases nothing.
270
+ const encoding = req.headers.get("content-encoding");
271
+ const copy = req.clone();
272
+ const observation = decision.then(async accepted => {
273
+ // Never awaited: a tee's cancel waits for the other half, which a refusal may leave unread.
274
+ if (!accepted) { void copy.body?.cancel().catch(() => {}); return; }
275
+ const raw = new Uint8Array(await copy.arrayBuffer());
276
+ const body = JSON.parse(new TextDecoder().decode(decodeRequestBody(raw, encoding, inboundLimit))) as unknown;
277
+ if (!body || typeof body !== "object") return;
278
+ holds.observe(linkId, threadHashOf(body), resultKeysOf((body as Record<string, unknown>).input), beganAt);
279
+ }).catch(() => {}).finally(() => { holdObservations.delete(observation); });
280
+ holdObservations.add(observation);
281
+ }
282
+ if (token === null && !decide) return;
283
+ // Preparation claimed the token before the handler answered; dropping it again is a no-op,
284
+ // and it keeps a request that never reached preparation from leaving one behind.
285
+ return (accepted: boolean) => { if (token !== null) releaseLinkTurnToken(token); decide?.(accepted); };
286
+ } });
130
287
  let bound: Server<unknown>;
131
288
  try {
132
289
  bound = serve({
@@ -137,6 +294,8 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
137
294
  idleTimeout: 255,
138
295
  maxRequestBodySize: startContext.maxRequestBodySize,
139
296
  fetch: (req: Request, server: Server<unknown>) => sessions.dispatch(req, server as Server<T>, startContext!.dispatch),
297
+ // Only a verified link upgrade with the feature on ever reaches server.upgrade (link-websocket.ts).
298
+ ...(linkWebsocket ? { websocket: websocketGate.handler(linkWebsocket.handler) } : {}),
140
299
  } as Parameters<typeof Bun.serve>[0]);
141
300
  } catch (error) {
142
301
  reportFailure("bind", error, "bind");
@@ -176,6 +335,7 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
176
335
  }
177
336
  listener = bound as Server<T>;
178
337
  relaySessions = sessions;
338
+ websocketGate.accept();
179
339
  setStatus("listening", bound.port ?? (requestedPort > 0 ? requestedPort : null), null);
180
340
  };
181
341
 
@@ -185,6 +345,8 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
185
345
  const flight = (async () => {
186
346
  if (closeFlight) await closeFlight;
187
347
  if (stopped) return;
348
+ // An unbound listener captures in bindIfNeeded; a bound one retries an owed capture here.
349
+ if (routeDefaultsOwed && listener) captureRouteDefaults();
188
350
  bindIfNeeded();
189
351
  })();
190
352
  ensureFlight = flight.finally(() => {
@@ -196,12 +358,17 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
196
358
 
197
359
  const close = (): Promise<void> => {
198
360
  if (closeFlight) return closeFlight;
361
+ // No link is left to protect: an owed capture is retried at the next bind, not on a timer.
362
+ if (captureRetry) { clearTimeout(captureRetry); captureRetry = undefined; }
363
+ captureAttempt = 0;
199
364
  const flight = (async () => {
200
365
  if (ensureFlight) await ensureFlight;
201
366
  const current = listener;
202
367
  // Retain the bound port AND ingress ownership while an authenticated connection is
203
368
  // reserved or a dispatched response is still being consumed. No new proofs are issued.
204
369
  if (current) {
370
+ // A link WebSocket holds its session lease until its close callback; close them first.
371
+ websocketGate.closeAll();
205
372
  await relaySessions?.drain();
206
373
  await current.stop(false);
207
374
  }
@@ -230,11 +397,18 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
230
397
  authenticatedCatalogListeners.add(listener);
231
398
  return () => { authenticatedCatalogListeners.delete(listener); };
232
399
  },
233
- notifyAuthenticatedCatalog(apiKeyId) {
234
- for (const listener of authenticatedCatalogListeners) listener(apiKeyId);
400
+ notifyAuthenticatedCatalog(apiKeyId, routeProofId) {
401
+ for (const listener of authenticatedCatalogListeners) listener(apiKeyId, routeProofId);
235
402
  },
236
403
  peerObservation: linkId => peers.get(linkId),
237
404
  linkActivity: (linkId, now) => activity.snapshot(linkId, now),
405
+ // Only the Home's link removal calls this: the link's sockets close and its holds go with it.
406
+ closeLinkSockets: linkId => { const closed = websocketGate.closeLink(linkId); holds.removeLink(linkId); websocketGate.forgetTransport(linkId); return closed; },
407
+ linkTransport: linkId => websocketGate.transport(linkId),
408
+ linkHolds: linkId => holds.summary(linkId),
409
+ clearLinkHolds: linkId => holds.clear(linkId),
410
+ async activityHoldsSettled() { await Promise.all([...holdObservations]); },
411
+ linkTraffic: linkId => traffic.snapshot(linkId),
238
412
  onCatalogServed(listener) {
239
413
  catalogServedListeners.add(listener);
240
414
  return () => { catalogServedListeners.delete(listener); };
@@ -245,12 +419,16 @@ export function createLinkListenerLifecycle<T>(deps: LinkListenerDeps = {}): Lin
245
419
  close,
246
420
  async stop() {
247
421
  stopped = true;
422
+ if (captureRetry) { clearTimeout(captureRetry); captureRetry = undefined; }
248
423
  releaseFallbackLinkResolver();
249
424
  // Process shutdown is deliberately forceful, unlike last-link removal. Every
250
425
  // authenticated socket is closed, and the client transport cannot reconnect it.
251
426
  relaySessions?.abortReservations();
252
427
  if (listener) await listener.stop(true);
253
428
  await close();
429
+ websocketGate.dispose();
430
+ // Sockets are closed and their holds recorded; persist them, then mark the fence clean.
431
+ holds.stop();
254
432
  startContext = undefined;
255
433
  setStatus("off", null, null);
256
434
  },
@@ -12,7 +12,9 @@ import type { OcxConfig } from "../../types";
12
12
  import { handleManagementAPI, type ManagementApiDeps } from "../management-api";
13
13
  import type { ManagementSessionControl } from "../management-auth";
14
14
  import { runPassiveRead } from "../../lib/passive-read";
15
- import { LINK_CODEX_SETTINGS_PATH, linkManagementRouteAllowed, linkManagementTarget } from "../../link/management-routes";
15
+ import { LINK_CODEX_SETTINGS_PATH, LINK_ROUTE_INTENT_PATH, LINK_ROUTE_CATALOG_PATH, linkManagementRouteAllowed, linkManagementTarget } from "../../link/management-routes";
16
+ import { projectRouteCatalogFacts } from "../../integrations/route-intent-catalog";
17
+ import { readLinkRouteIntent } from "./route-intent-watch";
16
18
  import { projectHomeCodexSettings } from "../../link/codex-settings";
17
19
  import { homeLinkChildParity, LINK_CHILD_PARITY_MAX_BYTES, LINK_CHILD_PARITY_PATH, parseLinkChildParityReport } from "../../link/child-parity";
18
20
  import { linkStorePath } from "../../link/paths";
@@ -76,9 +78,21 @@ export async function handleLinkManagementRequest(
76
78
  deps: ManagementApiDeps,
77
79
  sessionControl?: ManagementSessionControl,
78
80
  admittedKeyId?: string,
81
+ /** Repeats link-key admission for a request that waited; see readLinkRouteIntent. */
82
+ readmit?: () => string | undefined,
79
83
  ): Promise<Response> {
80
84
  if (url.pathname === LINK_CHILD_PARITY_PATH) return handleChildParityReport(req, url, admittedKeyId);
81
85
  if (!linkManagementRouteAllowed(url, req)) return notFound();
86
+ if (url.pathname === LINK_ROUTE_CATALOG_PATH) {
87
+ if (!admittedKeyId) return refused(403, "link_key_required");
88
+ try {
89
+ if (readLinkStore(linkStorePath()).links.filter(link => link.apiKeyId === admittedKeyId).length !== 1) return refused(403, "link_mismatch");
90
+ return Response.json(projectRouteCatalogFacts(config), { headers: { "cache-control": "no-store" } });
91
+ } catch { return refused(503, "route_catalog_unavailable"); }
92
+ }
93
+ if (url.pathname === LINK_ROUTE_INTENT_PATH) {
94
+ return readLinkRouteIntent(req, config, VERSION, admittedKeyId, readmit);
95
+ }
82
96
  if (url.pathname === LINK_CODEX_SETTINGS_PATH) {
83
97
  return Response.json(projectHomeCodexSettings(config, VERSION), { headers: { "cache-control": "no-store" } });
84
98
  }