@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,692 @@
1
+ import type { Server, ServerWebSocket, WebSocketHandler } from "bun";
2
+ import { formatErrorResponse } from "../../bridge";
3
+ import { resolveResponsesApiAuth, type RequestPolicyView } from "../auth-cors";
4
+ import { isDraining } from "../lifecycle";
5
+ import { buildResponsesWsData, selectForwardHeaders, type LinkSocketBinding, type WsData } from "../ws-bridge";
6
+ import { tryReserveCodexWebSocket } from "../../codex/websocket-registry";
7
+ import type { AdmissionReservation } from "../../lib/admission";
8
+ import { sessionLaneIdFromRequest } from "../request-log-conversation";
9
+ import { classifyUsageClient } from "../../usage/client";
10
+ import type { LinkActivity, LinkSocketActivity } from "../../link/child-activity";
11
+ import type { ActivityHolds, FingerprintMark, StoredMark } from "../../link/ws-activity-holds";
12
+ import type { LinkTrafficBook } from "../../link/traffic";
13
+ import type { LinkWsCloseReason, LinkWsCounters, LinkWsRefusal } from "../../link/status-projection";
14
+ import type { LinkTurnObserver } from "../link-turn";
15
+ import { resultKeysOf } from "../../codex/websocket-activity";
16
+ import {
17
+ LINK_WS_AGE_CLOSE, LINK_WS_DISABLED_CLOSE, LINK_WS_IDLE_CLOSE, LINK_WS_LIMITS, LINK_WS_REVOKED_CLOSE, type LinkWebsocketLimits, linkWebsocketLimitOverrides,
18
+ } from "./link-websocket-limits";
19
+
20
+ /**
21
+ * The Responses WebSocket over a Remote Link, Home side (design T4 section 2).
22
+ *
23
+ * A link upgrade is admitted only on a relay session that link-relay-sessions.ts has just consumed
24
+ * and verified on the same TCP connection (S1, S4). Admission is one synchronous function; every
25
+ * frame the socket later receives re-runs the authorization check before the shared handler sees
26
+ * it (S3), so a revoked link, a rotated or removed key, or an edited links.json stops new turns at
27
+ * the next frame and running ones at the next sweep.
28
+ */
29
+
30
+ /** The verified relay session an upgrade arrived on. release is the session's drain lease. */
31
+ export interface LinkSessionGrant {
32
+ keyId: string;
33
+ linkId: string;
34
+ fingerprint: string;
35
+ release: () => void;
36
+ }
37
+
38
+ /** handled: false leaves the request on today's path (the hub-link route table refuses it with 404). */
39
+ export type LinkUpgradeOutcome = { handled: false } | { handled: true; response: Response | undefined };
40
+
41
+ type LeaseState = "reserved" | "upgrading" | "upgraded" | "released" | "closed";
42
+
43
+ /**
44
+ * The single owner of every lease one link upgrade holds (design 2.3). Leases are released in
45
+ * reverse order, exactly once: by a refusal, abort, throw or failed upgrade before the socket
46
+ * exists, or by the socket's close callback after it does. Nothing else releases them.
47
+ */
48
+ export class LinkUpgradeLeases {
49
+ private current: LeaseState = "reserved";
50
+ private readonly releases: Array<() => void>;
51
+
52
+ constructor(session: () => void) {
53
+ this.releases = [session];
54
+ }
55
+
56
+ get state(): LeaseState { return this.current; }
57
+
58
+ /** Adds a lease while admission is still deciding; after that a late lease is returned at once. */
59
+ add(release: () => void): void {
60
+ if (this.current === "reserved") this.releases.push(release);
61
+ else release();
62
+ }
63
+
64
+ upgrading(): void { if (this.current === "reserved") this.current = "upgrading"; }
65
+
66
+ upgraded(): void { if (this.current === "upgrading") this.current = "upgraded"; }
67
+
68
+ /** Refusal, abort, throw or failed upgrade. No effect once the socket owns the leases. */
69
+ release(): void {
70
+ if (this.current !== "reserved" && this.current !== "upgrading") return;
71
+ this.current = "released";
72
+ this.drain();
73
+ }
74
+
75
+ /** The socket's close callback. */
76
+ closed(): void {
77
+ if (this.current === "upgraded") {
78
+ this.current = "closed";
79
+ this.drain();
80
+ } else this.release();
81
+ }
82
+
83
+ private drain(): void {
84
+ while (this.releases.length) {
85
+ const release = this.releases.pop()!;
86
+ try { release(); } catch { /* one failed release must not keep the others */ }
87
+ }
88
+ }
89
+ }
90
+
91
+ /** Design 2.3 step 1: exactly a Codex Responses upgrade, with nothing a browser or an extension adds. */
92
+ export function linkResponsesUpgradeShape(req: Request): boolean {
93
+ if (req.method !== "GET") return false;
94
+ let url: URL;
95
+ try { url = new URL(req.url); } catch { return false; }
96
+ if (url.pathname !== "/v1/responses" || url.search !== "") return false;
97
+ const headers = req.headers;
98
+ if (headers.get("upgrade")?.toLowerCase() !== "websocket") return false;
99
+ if (!(headers.get("connection") ?? "").toLowerCase().split(",").some(token => token.trim() === "upgrade")) return false;
100
+ if (headers.get("sec-websocket-version") !== "13" || !headers.get("sec-websocket-key")) return false;
101
+ return !headers.has("origin") && !headers.has("sec-websocket-protocol") && !headers.has("sec-websocket-extensions");
102
+ }
103
+
104
+ export interface LinkWebsocketTimers {
105
+ setInterval(callback: () => void, ms: number): unknown;
106
+ clearInterval(handle: unknown): void;
107
+ }
108
+
109
+ export interface LinkWebsocketGateDeps {
110
+ /** linkResponsesWebsocketEnabled(config), read on every upgrade and every sweep. */
111
+ enabled(): boolean;
112
+ /** The hub-link request policy (the same view serve-options admits link requests with). */
113
+ policy(): RequestPolicyView;
114
+ /**
115
+ * The authorization check: an uncached, fail-closed links.json read still names (linkId, keyId),
116
+ * and the key still has the fingerprint the session was proved with. Must not throw or await.
117
+ */
118
+ authorized(identity: { keyId: string; linkId: string; fingerprint: string }): boolean;
119
+ draining?: () => boolean;
120
+ reserveSocket?: () => AdmissionReservation<ServerWebSocket<WsData>> | null;
121
+ limits?: Partial<LinkWebsocketLimits>;
122
+ timers?: LinkWebsocketTimers;
123
+ /** Wall clock for idle, age and the drain deadline. */
124
+ now?: () => number;
125
+ /** The per-link activity book: a busy link socket counts in flight there (design T4 section 5). */
126
+ activity?: LinkActivity;
127
+ /** Durable holds: a busy close leaves one, and the crash fence is armed before the first upgrade. */
128
+ holds?: ActivityHolds;
129
+ /**
130
+ * The Home's per-link traffic book (the HTTP relay's): each link socket is one request in it, counted from open to close
131
+ * in the Child's units (message payload bytes each way); complete when any close frame ended it, where the Child also
132
+ * counts its own overload, binary and protocol closes as incomplete.
133
+ */
134
+ traffic?: LinkTrafficBook;
135
+ }
136
+
137
+ /** What the gate keeps per open link socket. */
138
+ interface SocketState {
139
+ openedAt: number;
140
+ /** When the socket last became idle; null while busy. */
141
+ idleSince: number | null;
142
+ /** When this socket started draining after the switch went off; null while on. */
143
+ drainingSince: number | null;
144
+ /** A create arrived while a turn ran during the drain: close once the turn ends. */
145
+ closeAfterTurn: boolean;
146
+ book: LinkSocketActivity | null;
147
+ unsubscribe: () => void;
148
+ /** HMAC of the socket's own thread id; undefined until known, null when it has none. */
149
+ threadHash: string | null | undefined;
150
+ /** Closed by revocation: such a close leaves no hold (design 5). */
151
+ revoked: boolean;
152
+ /** Turns that entered the pipeline on this socket; the first one is logged as continuation full, reason first. */
153
+ turnsSeen: number;
154
+ /**
155
+ * One entry per turn that entered the pipeline, keyed by the handler's turn id and written and
156
+ * cleared only by that turn's own observer and cleanup: "pending" until expansion, then its
157
+ * fingerprint, or "unknown" when expansion or hashing failed or Codex sent no turn id, and "done"
158
+ * once its own terminal arrived (no longer cut work). The turn's cleanup removes the entry.
159
+ */
160
+ captures: Map<number, FingerprintMark | "pending" | "unknown" | "done">;
161
+ }
162
+
163
+ function bodyRecord(body: unknown): Record<string, unknown> {
164
+ return body && typeof body === "object" && !Array.isArray(body) ? body as Record<string, unknown> : {};
165
+ }
166
+
167
+ function inputItems(body: Record<string, unknown>): unknown[] {
168
+ return Array.isArray(body.input) ? body.input : body.input === undefined ? [] : [body.input];
169
+ }
170
+
171
+ /** Codex's own turn id (client_metadata.turn_id); optional on Codex's side. */
172
+ function turnIdOf(body: Record<string, unknown>): string | null {
173
+ const metadata = bodyRecord(body.client_metadata);
174
+ return typeof metadata.turn_id === "string" && metadata.turn_id ? metadata.turn_id : null;
175
+ }
176
+
177
+ /** Design 5 capture: the expanded input's length and HMAC, with the turn reference. */
178
+ export function fingerprintCapture(holds: ActivityHolds, body: unknown): FingerprintMark | "unknown" {
179
+ const record = bodyRecord(body);
180
+ const turnId = turnIdOf(record);
181
+ if (!turnId) return "unknown";
182
+ try {
183
+ const items = inputItems(record);
184
+ if (items.length === 0) return "unknown";
185
+ return { n: items.length, inputHmac: holds.inputHmac(items), turnRef: holds.turnRef(turnId) };
186
+ } catch { return "unknown"; }
187
+ }
188
+
189
+ /**
190
+ * Rules (a)-(c): the fingerprinted marks of this link that a request re-sends: an inference request
191
+ * (generate is not false) of the same own thread and turn whose expanded input starts with the cut
192
+ * request's input. Rule (d), an upstream-completed terminal, is checked by the caller at the end.
193
+ */
194
+ export function marksResent(holds: ActivityHolds, linkId: string, threadHash: string | null, body: unknown): StoredMark[] {
195
+ const record = bodyRecord(body);
196
+ if (!threadHash || record.generate === false || !holds.hasMarks(linkId)) return [];
197
+ const turnId = turnIdOf(record);
198
+ if (!turnId) return [];
199
+ try {
200
+ const items = inputItems(record);
201
+ return holds.markCandidates(linkId, threadHash, holds.turnRef(turnId))
202
+ .filter(mark => items.length >= mark.n && holds.inputHmac(items.slice(0, mark.n)) === mark.inputHmac);
203
+ } catch { return []; }
204
+ }
205
+
206
+ /** Rule (d): only a terminal the upstream itself reported as completed releases a running mark; no provenance is not enough. */
207
+ export function upstreamCompleted(status: string | undefined, source: string | undefined): boolean {
208
+ return status === "completed" && source === "upstream";
209
+ }
210
+
211
+ /** Design 9.1: the hashed thread and turn refs of a link request; a ref that cannot be made is left out. */
212
+ export function linkLogRefs(holds: ActivityHolds, linkId: string, threadId: string, body: unknown): { threadRef?: string; turnRef?: string } {
213
+ const turnId = turnIdOf(bodyRecord(body));
214
+ const ref = (kind: "thread" | "turn", id: string | null): string | null => {
215
+ if (!id) return null;
216
+ try { return holds.logRef(kind, linkId, id); } catch { return null; }
217
+ };
218
+ const threadRef = ref("thread", threadId || threadIdOf(bodyRecord(body)));
219
+ const turnRef = ref("turn", turnId);
220
+ return { ...(threadRef ? { threadRef } : {}), ...(turnRef ? { turnRef } : {}) };
221
+ }
222
+
223
+ function threadIdOf(body: Record<string, unknown>): string | null {
224
+ const metadata = bodyRecord(body.client_metadata);
225
+ return typeof metadata.thread_id === "string" && metadata.thread_id ? metadata.thread_id : null;
226
+ }
227
+
228
+ const defaultTimers: LinkWebsocketTimers = {
229
+ setInterval(callback, ms) {
230
+ const handle = setInterval(callback, ms);
231
+ (handle as { unref?: () => void }).unref?.();
232
+ return handle;
233
+ },
234
+ clearInterval(handle) { clearInterval(handle as ReturnType<typeof setInterval>); },
235
+ };
236
+
237
+ function capacityRefusal(): Response {
238
+ return formatErrorResponse(426, "upgrade_required", "Remote Link WebSocket capacity reached; use HTTP.", { code: "link_websocket_capacity" });
239
+ }
240
+
241
+ function unauthorized(): Response {
242
+ return formatErrorResponse(401, "authentication_error", "opencodex API key required");
243
+ }
244
+
245
+ export function createLinkWebsocketGate(deps: LinkWebsocketGateDeps) {
246
+ const limits: LinkWebsocketLimits = { ...LINK_WS_LIMITS, ...linkWebsocketLimitOverrides(), ...deps.limits };
247
+ const timers = deps.timers ?? defaultTimers;
248
+ const draining = deps.draining ?? isDraining;
249
+ // A full shared gate lets a link upgrade reclaim an idle link socket, never a local one.
250
+ const reserveSocket = deps.reserveSocket ?? (() => tryReserveCodexWebSocket({ reclaim: "link" }));
251
+ const now = deps.now ?? Date.now;
252
+ const states = new WeakMap<ServerWebSocket<WsData>, SocketState>();
253
+ // Admission counts open plus upgrading sockets; a lease in the bundle gives each slot back.
254
+ const admitted = new Map<string, number>();
255
+ let admittedTotal = 0;
256
+ let reservedBytes = 0;
257
+ // Open sockets, by link, for the revocation hooks and the sweep.
258
+ const sockets = new Map<string, Set<ServerWebSocket<WsData>>>();
259
+ let sweepHandle: unknown;
260
+ // False from last-link close() until the next bind: a session reserved before close() must not
261
+ // become a socket close() never sees, or the listener drain would wait on it forever.
262
+ let accepting = true;
263
+ // Upgraded but not yet opened: Bun runs open() after the fetch returns, so a revoke or close() in
264
+ // between must still reach the socket. The value is the close it owes when it opens.
265
+ const pending = new Map<LinkSocketBinding, { code: number; reason: string } | null>();
266
+ // Design 9.3: display-only counters per link, in memory, reset at restart; reasons are closed sets.
267
+ const counted = new Map<string, { upgrades: number; refused: Partial<Record<LinkWsRefusal, number>>; closes: Partial<Record<LinkWsCloseReason, number>> }>();
268
+ const tally = (linkId: string, create: boolean) => {
269
+ let entry = counted.get(linkId);
270
+ if (!entry && create) { entry = { upgrades: 0, refused: {}, closes: {} }; counted.set(linkId, entry); }
271
+ return entry;
272
+ };
273
+ // Why the gate itself closed a socket; a close the gate did not start is classified by its code.
274
+ const fencedBy = new WeakMap<LinkSocketBinding, LinkWsCloseReason>();
275
+ const FENCE_REASONS = new Map<{ code: number; reason: string }, LinkWsCloseReason>([
276
+ [LINK_WS_REVOKED_CLOSE, "revoked"], [LINK_WS_DISABLED_CLOSE, "disabled"], [LINK_WS_IDLE_CLOSE, "idle"], [LINK_WS_AGE_CLOSE, "age"],
277
+ ]);
278
+
279
+ const authorized = (identity: { keyId: string; linkId: string; fingerprint: string }): boolean => {
280
+ try { return deps.authorized(identity); } catch { return false; }
281
+ };
282
+
283
+ const fence = (ws: ServerWebSocket<WsData>, close: { code: number; reason: string }): void => {
284
+ const link = ws.data.link;
285
+ if (!link || link.fenced) return;
286
+ link.fenced = true;
287
+ const why = FENCE_REASONS.get(close);
288
+ if (why) fencedBy.set(link, why);
289
+ const state = states.get(ws);
290
+ if (state && close === LINK_WS_REVOKED_CLOSE) state.revoked = true;
291
+ if (ws.data.responsesActivity) ws.data.responsesActivity.closing = true;
292
+ try { ws.data.cancel?.(); } catch { /* the close below still ends the socket */ }
293
+ try { ws.close(close.code, close.reason); } catch { /* already closing */ }
294
+ };
295
+
296
+ const allSockets = (): ServerWebSocket<WsData>[] => [...sockets.values()].flatMap(set => [...set]);
297
+
298
+ const enabledNow = (): boolean => { try { return deps.enabled(); } catch { return false; } };
299
+
300
+ /** Design 2.5: drain starts once, at the first sweep or frame that sees the switch off. */
301
+ const startDrain = (state: SocketState): void => {
302
+ if (state.drainingSince === null) state.drainingSince = now();
303
+ };
304
+
305
+ const pastDeadline = (state: SocketState): boolean =>
306
+ state.drainingSince !== null && now() - state.drainingSince >= limits.drainDeadlineMs;
307
+
308
+ /**
309
+ * Re-evaluated whenever the socket's activity changes, and by the sweep. A busy socket is never
310
+ * closed here: drain and age wait for the running turn, and idle closes need idle.
311
+ */
312
+ const settle = (ws: ServerWebSocket<WsData>, state: SocketState, fromSweep: boolean): void => {
313
+ const link = ws.data.link;
314
+ const activity = ws.data.responsesActivity;
315
+ if (!link || link.fenced || !activity) return;
316
+ if (state.drainingSince !== null) {
317
+ if (state.closeAfterTurn && !activity.running) { fence(ws, LINK_WS_DISABLED_CLOSE); return; }
318
+ if (activity.idle) { fence(ws, LINK_WS_DISABLED_CLOSE); return; }
319
+ if (pastDeadline(state)) {
320
+ if (activity.running) state.closeAfterTurn = true;
321
+ else fence(ws, LINK_WS_DISABLED_CLOSE);
322
+ }
323
+ return;
324
+ }
325
+ if (!activity.idle) return;
326
+ if (now() - state.openedAt >= limits.maxAgeMs) { fence(ws, LINK_WS_AGE_CLOSE); return; }
327
+ if (fromSweep && state.idleSince !== null && now() - state.idleSince >= limits.idleCloseMs) fence(ws, LINK_WS_IDLE_CLOSE);
328
+ };
329
+
330
+ const observe = (ws: ServerWebSocket<WsData>, state: SocketState): void => {
331
+ const activity = ws.data.responsesActivity;
332
+ if (!activity) return;
333
+ const idle = activity.idle;
334
+ if (idle && state.idleSince === null) state.idleSince = now();
335
+ if (!idle) state.idleSince = null;
336
+ state.book?.busy(!idle);
337
+ settle(ws, state, false);
338
+ };
339
+
340
+ /**
341
+ * The drain rule for one frame on a draining socket (design 2.5). Only a create is decided here;
342
+ * anything else goes to the shared handler as usual. Parses only while draining.
343
+ */
344
+ const admitWhileDraining = (ws: ServerWebSocket<WsData>, state: SocketState, raw: string | Buffer): boolean => {
345
+ let frame: Record<string, unknown> | null = null;
346
+ try { frame = JSON.parse(typeof raw === "string" ? raw : raw.toString()) as Record<string, unknown>; } catch { frame = null; }
347
+ if (!frame || frame.type !== "response.create") return true;
348
+ const activity = ws.data.responsesActivity;
349
+ if (!activity) { fence(ws, LINK_WS_DISABLED_CLOSE); return false; }
350
+ // A running turn is never cancelled by the drain: the frame is dropped and the socket closes after it.
351
+ if (activity.running) { state.closeAfterTurn = true; return false; }
352
+ if (!pastDeadline(state) && !activity.untracked && activity.returnsPending(frame.input)) return true;
353
+ fence(ws, LINK_WS_DISABLED_CLOSE);
354
+ return false;
355
+ };
356
+
357
+ /**
358
+ * Learns the socket's own thread from its first create when the handshake carried none. Release
359
+ * itself happens only when the shared handler admits a turn (onAccepted, below), so a warmup or a
360
+ * refused create never releases a hold.
361
+ */
362
+ const learnThread = (state: SocketState, raw: string | Buffer): void => {
363
+ const holds = deps.holds!;
364
+ if (state.threadHash !== undefined) return;
365
+ let frame: Record<string, unknown>;
366
+ try { frame = JSON.parse(typeof raw === "string" ? raw : raw.toString()) as Record<string, unknown>; } catch { return; }
367
+ if (frame.type !== "response.create") return;
368
+ if (state.threadHash === undefined) {
369
+ const metadata = frame.client_metadata as Record<string, unknown> | undefined;
370
+ const threadId = metadata && typeof metadata.thread_id === "string" && metadata.thread_id ? metadata.thread_id : null;
371
+ try { state.threadHash = threadId ? holds.threadHash(threadId) : null; } catch { state.threadHash = null; }
372
+ }
373
+ };
374
+
375
+ /** Design 5: a socket that closes while busy, for any reason except revocation, leaves a hold. */
376
+ const holdOnClose = (ws: ServerWebSocket<WsData>): void => {
377
+ const holds = deps.holds;
378
+ const link = ws.data.link;
379
+ const state = states.get(ws);
380
+ const activity = ws.data.responsesActivity;
381
+ if (!holds || !link || !state || state.revoked || !activity) return;
382
+ const pendingKeys = activity.pendingKeys();
383
+ if (!activity.running && pendingKeys.length === 0 && !activity.untracked) return;
384
+ // Snapshot, in this task, every turn's capture: a fingerprint becomes a mark released on its own;
385
+ // a turn that closed before its capture, or could not be fingerprinted, becomes an unknown mark.
386
+ const marks: FingerprintMark[] = [];
387
+ let unknown = 0;
388
+ for (const capture of state.captures.values()) {
389
+ if (typeof capture === "object") marks.push(capture); else if (capture !== "done") unknown += 1;
390
+ }
391
+ unknown += Math.max(0, activity.runningTurns - state.captures.size);
392
+ holds.add(link.linkId, { threadHash: state.threadHash ?? null, pendingKeys, runningMarks: unknown, marks, untracked: activity.untracked });
393
+ };
394
+
395
+ const sweep = (): void => {
396
+ const on = enabledNow();
397
+ for (const ws of allSockets()) {
398
+ const link = ws.data.link;
399
+ if (!link || link.fenced) continue;
400
+ if (!authorized(link)) { fence(ws, LINK_WS_REVOKED_CLOSE); continue; }
401
+ const state = states.get(ws);
402
+ if (!state) continue;
403
+ if (!on) startDrain(state);
404
+ settle(ws, state, true);
405
+ }
406
+ };
407
+
408
+ const track = (ws: ServerWebSocket<WsData>, linkId: string): void => {
409
+ let set = sockets.get(linkId);
410
+ if (!set) { set = new Set(); sockets.set(linkId, set); }
411
+ set.add(ws);
412
+ if (sweepHandle === undefined) sweepHandle = timers.setInterval(sweep, limits.sweepIntervalMs);
413
+ };
414
+
415
+ const untrack = (ws: ServerWebSocket<WsData>, linkId: string): void => {
416
+ const set = sockets.get(linkId);
417
+ if (set?.delete(ws) && set.size === 0) sockets.delete(linkId);
418
+ if (sockets.size === 0 && sweepHandle !== undefined) {
419
+ timers.clearInterval(sweepHandle);
420
+ sweepHandle = undefined;
421
+ }
422
+ };
423
+
424
+ const admitSlot = (linkId: string): (() => void) | null => {
425
+ const perLink = admitted.get(linkId) ?? 0;
426
+ if (perLink >= limits.perLinkSockets || admittedTotal >= limits.totalSockets) return null;
427
+ admitted.set(linkId, perLink + 1);
428
+ admittedTotal += 1;
429
+ return () => {
430
+ const left = (admitted.get(linkId) ?? 1) - 1;
431
+ if (left > 0) admitted.set(linkId, left); else admitted.delete(linkId);
432
+ admittedTotal -= 1;
433
+ };
434
+ };
435
+
436
+ const reserveMemory = (): (() => void) | null => {
437
+ if (reservedBytes + limits.socketReservationBytes > limits.memoryBudgetBytes) return null;
438
+ reservedBytes += limits.socketReservationBytes;
439
+ return () => { reservedBytes -= limits.socketReservationBytes; };
440
+ };
441
+
442
+ return {
443
+ /**
444
+ * Called by link-relay-sessions.ts right after it consumed and verified a session, for a request
445
+ * that carries an Upgrade header. Synchronous: no await between the checks and server.upgrade.
446
+ */
447
+ upgrade<T>(req: Request, server: Server<T>, grant: LinkSessionGrant): LinkUpgradeOutcome {
448
+ if (!linkResponsesUpgradeShape(req)) return { handled: false };
449
+ let on = false;
450
+ try { on = deps.enabled(); } catch { on = false; }
451
+ // Off: the request keeps today's path and today's refusal, byte for byte.
452
+ if (!on) return { handled: false };
453
+ const leases = new LinkUpgradeLeases(grant.release);
454
+ let binding: LinkSocketBinding | undefined;
455
+ const refuse = (response: Response, reason: LinkWsRefusal): LinkUpgradeOutcome => {
456
+ leases.release();
457
+ const entry = tally(grant.linkId, true)!;
458
+ entry.refused[reason] = (entry.refused[reason] ?? 0) + 1;
459
+ return { handled: true, response };
460
+ };
461
+ try {
462
+ if (req.signal.aborted) return refuse(formatErrorResponse(426, "upgrade_required", "The upgrade request was aborted."), "aborted");
463
+ if (!accepting || draining()) return refuse(formatErrorResponse(503, "server_error", "The Home is shutting down.", { code: "server_draining" }), "draining");
464
+ // S2: the credential on the upgrade is the key the relay proof was made with.
465
+ const admission = resolveResponsesApiAuth(req, deps.policy());
466
+ if (!admission || admission.kind !== "configured" || admission.keyId !== grant.keyId) return refuse(unauthorized(), "unauthorized");
467
+ if (!authorized(grant)) return refuse(unauthorized(), "unauthorized");
468
+ // Design 5: the crash fence is durable before any link socket exists; without it, no upgrade.
469
+ if (deps.holds && !deps.holds.arm()) {
470
+ return refuse(formatErrorResponse(426, "upgrade_required", "Remote Link WebSocket activity cannot be recorded; use HTTP.", { code: "link_websocket_unavailable" }), "unavailable");
471
+ }
472
+ const memory = reserveMemory();
473
+ if (!memory) return refuse(capacityRefusal(), "memory");
474
+ leases.add(memory);
475
+ const slot = admitSlot(grant.linkId);
476
+ if (!slot) return refuse(capacityRefusal(), "cap");
477
+ leases.add(slot);
478
+ const socketLease = reserveSocket();
479
+ if (!socketLease) return refuse(capacityRefusal(), "cap");
480
+ leases.add(() => socketLease.release());
481
+ const data = buildResponsesWsData(
482
+ selectForwardHeaders(req.headers),
483
+ admission,
484
+ socketLease,
485
+ sessionLaneIdFromRequest(req.headers),
486
+ classifyUsageClient(req.headers),
487
+ );
488
+ binding = { linkId: grant.linkId, keyId: grant.keyId, fingerprint: grant.fingerprint, fenced: false, leases };
489
+ data.nativeControlDisabled = true;
490
+ data.link = binding;
491
+ if (req.signal.aborted) return refuse(formatErrorResponse(426, "upgrade_required", "The upgrade request was aborted."), "aborted");
492
+ leases.upgrading();
493
+ pending.set(binding, null);
494
+ if (!(server as unknown as Server<WsData>).upgrade(req, { data })) {
495
+ pending.delete(binding);
496
+ return refuse(formatErrorResponse(426, "upgrade_required", "WebSocket upgrade failed"), "failed");
497
+ }
498
+ leases.upgraded();
499
+ tally(grant.linkId, true)!.upgrades += 1;
500
+ return { handled: true, response: undefined };
501
+ } catch {
502
+ if (binding) pending.delete(binding);
503
+ return refuse(formatErrorResponse(426, "upgrade_required", "WebSocket upgrade failed"), "failed");
504
+ }
505
+ },
506
+
507
+ /** The link listener's websocket handler: the shared Responses handler behind the link checks. */
508
+ handler(base: WebSocketHandler<WsData>): WebSocketHandler<WsData> {
509
+ return {
510
+ ...base,
511
+ maxPayloadLength: limits.maxMessageBytes,
512
+ backpressureLimit: limits.backpressureLimitBytes,
513
+ closeOnBackpressureLimit: false,
514
+ idleTimeout: 0,
515
+ perMessageDeflate: false,
516
+ open(ws) {
517
+ const link = ws.data.link;
518
+ if (!link) { ws.close(1011, "link socket without a binding"); return; }
519
+ const owed = pending.get(link) ?? null;
520
+ pending.delete(link);
521
+ track(ws, link.linkId);
522
+ link.traffic = deps.traffic?.begin(link.linkId);
523
+ base.open?.(ws);
524
+ const state: SocketState = {
525
+ openedAt: now(), idleSince: null, drainingSince: null, closeAfterTurn: false,
526
+ book: deps.activity?.beginSocket(link.linkId) ?? null, unsubscribe: () => {},
527
+ threadHash: undefined, revoked: false, captures: new Map(), turnsSeen: 0,
528
+ };
529
+ if (deps.holds) {
530
+ const holds = deps.holds;
531
+ const linkId = link.linkId;
532
+ // One observer per turn, created when the turn enters the pipeline (websocket-handler.ts).
533
+ ws.data.linkTurnObserver = (turnId: number): LinkTurnObserver => {
534
+ state.captures.set(turnId, "pending");
535
+ const ordinal = ++state.turnsSeen;
536
+ let resent: StoredMark[] = [];
537
+ const own = (value: FingerprintMark | "unknown" | "done"): void => { if (state.captures.has(turnId)) state.captures.set(turnId, value); };
538
+ return {
539
+ expanded(body, chain) {
540
+ // A delta left for the upstream proves nothing about the full input: unknown, and no match.
541
+ if (chain === "unexpanded") { own("unknown"); resent = []; return; }
542
+ own(fingerprintCapture(holds, body));
543
+ resent = marksResent(holds, linkId, state.threadHash ?? null, body);
544
+ },
545
+ expansionFailed() { own("unknown"); },
546
+ // The link WebSocket exists only while the feature is on: its turns read the upstream as the socket drains (#8601).
547
+ pacedReads: true,
548
+ logFields: body => ({ transport: "websocket", first: ordinal === 1,
549
+ ...linkLogRefs(holds, linkId, ws.data.headers?.get("thread-id")?.trim() ?? "", body) }),
550
+ terminal(status, source) {
551
+ // The turn's own entry ends with its own terminal, superseded or not.
552
+ own("done");
553
+ if (resent.length && state.threadHash && upstreamCompleted(status, source)) holds.releaseMarks(linkId, state.threadHash, resent);
554
+ },
555
+ };
556
+ };
557
+ // The turn's cleanup (websocket-handler.ts): its entry goes, whether or not a terminal came.
558
+ ws.data.linkTurnEnded = (turnId: number): void => { state.captures.delete(turnId); };
559
+ }
560
+ // Codex sends its own thread id on the handshake; a socket without it may name one in its
561
+ // first create's client_metadata (observeForHolds).
562
+ const threadId = ws.data.headers?.get("thread-id");
563
+ if (deps.holds && threadId) {
564
+ // A reference key that cannot be loaded leaves the hold operator-only rather than failing the socket.
565
+ try { state.threadHash = deps.holds.threadHash(threadId); } catch { state.threadHash = null; }
566
+ }
567
+ states.set(ws, state);
568
+ const activity = ws.data.responsesActivity;
569
+ if (activity) {
570
+ // A refused or failed turn on this socket leaves its results owed (design 5).
571
+ activity.restoreRefusedResults = true;
572
+ const stopChange = activity.onChange(() => observe(ws, state));
573
+ // An admitted turn may return results a closed socket of this link and own thread waited for.
574
+ // Each turn settles only holds that existed when it began (another socket may reuse an id later).
575
+ const beganAt = new WeakMap<object, number>();
576
+ const stopBegin = deps.holds ? activity.onBegin(input => {
577
+ if (input && typeof input === "object") beganAt.set(input, deps.holds!.sequence());
578
+ }) : () => {};
579
+ const stopAccepted = deps.holds ? activity.onAccepted(input => {
580
+ const holds = deps.holds!;
581
+ const began = input && typeof input === "object" ? beganAt.get(input) : undefined;
582
+ if (began !== undefined && holds.releasable(link.linkId)) holds.observe(link.linkId, state.threadHash ?? null, resultKeysOf(input), began);
583
+ }) : () => {};
584
+ state.unsubscribe = () => { stopChange(); stopBegin(); stopAccepted(); };
585
+ observe(ws, state);
586
+ }
587
+ // A revoke or last-link close() that ran between the upgrade and now still applies.
588
+ if (owed) fence(ws, owed);
589
+ else if (!accepting) fence(ws, LINK_WS_REVOKED_CLOSE);
590
+ },
591
+ // Bun calls drain when the send buffer empties; a link pump waits for it (design 6.2).
592
+ drain(ws) {
593
+ ws.data.link?.drained?.();
594
+ base.drain?.(ws);
595
+ },
596
+ message(ws, raw) {
597
+ const link = ws.data.link;
598
+ // Every message that reached the Home counts, as the Child counts every write that completed, fenced or not.
599
+ link?.traffic?.toHome(typeof raw === "string" ? Buffer.byteLength(raw) : raw.byteLength);
600
+ if (!link || link.fenced) return;
601
+ // S3: every message, of any type, before the shared handler can admit a turn.
602
+ if (!authorized(link)) { fence(ws, LINK_WS_REVOKED_CLOSE); return; }
603
+ const state = states.get(ws);
604
+ if (state) {
605
+ if (!enabledNow()) startDrain(state);
606
+ if (state.drainingSince !== null && !admitWhileDraining(ws, state, raw)) return;
607
+ if (deps.holds) learnThread(state, raw);
608
+ }
609
+ return base.message?.(ws, raw);
610
+ },
611
+ close(ws, code, reason) {
612
+ try {
613
+ // Snapshot before the shared close cancels the turn: a busy socket leaves a hold.
614
+ holdOnClose(ws);
615
+ // A link pump waiting for a drain stops waiting once the socket is gone.
616
+ ws.data.link?.drained?.();
617
+ base.close?.(ws, code, reason);
618
+ } finally {
619
+ const link = ws.data.link;
620
+ const state = states.get(ws);
621
+ if (state) {
622
+ state.unsubscribe();
623
+ state.book?.end();
624
+ states.delete(ws);
625
+ }
626
+ if (link) {
627
+ pending.delete(link);
628
+ untrack(ws, link.linkId);
629
+ // Counted only for a link still known: a removed link's counters are not recreated by its last closes.
630
+ const entry = tally(link.linkId, false);
631
+ const why: LinkWsCloseReason = fencedBy.get(link) ?? (code === 1000 || code === 1001 ? "client" : code === 1006 ? "dropped" : "other");
632
+ if (entry) entry.closes[why] = (entry.closes[why] ?? 0) + 1;
633
+ // Complete when a close ended it, from either side; a socket dropped without one (1006, 1015) is incomplete.
634
+ try { link.traffic?.end(code !== 1006 && code !== 1015); } catch { /* accounting never keeps a lease */ }
635
+ link.leases.closed();
636
+ }
637
+ }
638
+ },
639
+ };
640
+ },
641
+
642
+ /** Design 9.3: one link's live counters (display only). */
643
+ transport(linkId: string): LinkWsCounters {
644
+ const entry = counted.get(linkId);
645
+ return { open: sockets.get(linkId)?.size ?? 0, upgrades: entry?.upgrades ?? 0, refused: { ...entry?.refused }, closes: { ...entry?.closes } };
646
+ },
647
+
648
+ /** A removed link's counters go with it. */
649
+ forgetTransport(linkId: string): void {
650
+ counted.delete(linkId);
651
+ },
652
+
653
+ /** The Home's own revoke path, in the same task as its commit. Returns how many were closed. */
654
+ closeLink(linkId: string): number {
655
+ const set = [...(sockets.get(linkId) ?? [])];
656
+ for (const ws of set) fence(ws, LINK_WS_REVOKED_CLOSE);
657
+ let owed = 0;
658
+ for (const binding of pending.keys()) {
659
+ if (binding.linkId !== linkId) continue;
660
+ pending.set(binding, LINK_WS_REVOKED_CLOSE);
661
+ owed += 1;
662
+ }
663
+ return set.length + owed;
664
+ },
665
+
666
+ /** Last link removed: no new link socket, and every open one closes before the listener drains. */
667
+ closeAll(): number {
668
+ accepting = false;
669
+ const all = allSockets();
670
+ for (const ws of all) fence(ws, LINK_WS_REVOKED_CLOSE);
671
+ for (const binding of pending.keys()) pending.set(binding, LINK_WS_REVOKED_CLOSE);
672
+ return all.length + pending.size;
673
+ },
674
+
675
+ /** A listener bound again after close() accepts link upgrades again. */
676
+ accept(): void { accepting = true; },
677
+
678
+ sweep,
679
+
680
+ /** Process stop: the listener closes the sockets; only the timer is ours to clear. */
681
+ dispose(): void {
682
+ if (sweepHandle !== undefined) timers.clearInterval(sweepHandle);
683
+ sweepHandle = undefined;
684
+ },
685
+
686
+ snapshot(): { open: number; admitted: number; reservedBytes: number; sweeping: boolean } {
687
+ return { open: allSockets().length, admitted: admittedTotal, reservedBytes, sweeping: sweepHandle !== undefined };
688
+ },
689
+ };
690
+ }
691
+
692
+ export type LinkWebsocketGate = ReturnType<typeof createLinkWebsocketGate>;