@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
@@ -13,8 +13,14 @@ export type TcpQuad = {
13
13
  state: string;
14
14
  };
15
15
 
16
- /** Parse netstat -ano rows whose local address uses `port`. Exported for tests. */
17
- export function parseTcpQuadsForLocalPort(output: string, port: number): TcpQuad[] {
16
+ /**
17
+ * Parse netstat -ano rows whose local address uses `port`. Exported for tests.
18
+ *
19
+ * `ownerPids` restricts the rows to those the listed processes own. A row left by a process
20
+ * that has exited is that process's to clear; a program that took the port between scans owns
21
+ * its own rows, and resetting them would break a connection this stop does not own.
22
+ */
23
+ export function parseTcpQuadsForLocalPort(output: string, port: number, ownerPids?: readonly number[]): TcpQuad[] {
18
24
  const rows: TcpQuad[] = [];
19
25
  const portSuffix = `:${port}`;
20
26
  for (const rawLine of output.split(/\r?\n/)) {
@@ -26,6 +32,10 @@ export function parseTcpQuadsForLocalPort(output: string, port: number): TcpQuad
26
32
  const remote = parts[2]!;
27
33
  const state = parts[3]!;
28
34
  if (!local.endsWith(portSuffix) && !local.endsWith(`]:${port}`)) continue;
35
+ if (ownerPids !== undefined) {
36
+ const rowPid = Number(parts[4]);
37
+ if (!Number.isSafeInteger(rowPid) || !ownerPids.includes(rowPid)) continue;
38
+ }
29
39
  const localAddr = stripPort(local, port);
30
40
  const remoteParsed = splitHostPort(remote);
31
41
  if (!localAddr || !remoteParsed) continue;
@@ -134,10 +144,17 @@ function readNetstatAno(): string {
134
144
  /**
135
145
  * Force-delete IPv4 TCP rows bound to `localPort` via SetTcpEntry(DELETE_TCB).
136
146
  * Does not kill foreign processes — only resets sockets so the listen port can bind again.
147
+ * `ownerPids` restricts the deletion to rows those processes own (see
148
+ * parseTcpQuadsForLocalPort); omitted, every row on the port is cleared, which is what the
149
+ * hard-kill path wants and what a stale-port sweep must not do.
137
150
  * Bare IPv6 rows (`::1`, `::`, etc.) are skipped (not coerced into IPv4 wildcards);
138
151
  * IPv6 TCB reclamation is unsupported on this path.
139
152
  */
140
- export function dropWindowsTcpRowsForLocalPort(port: number, mayMutate?: () => boolean): WindowsTcpDropResult {
153
+ export function dropWindowsTcpRowsForLocalPort(
154
+ port: number,
155
+ mayMutate?: () => boolean,
156
+ ownerPids?: readonly number[],
157
+ ): WindowsTcpDropResult {
141
158
  if (process.platform !== "win32" || !Number.isFinite(port) || port <= 0) {
142
159
  return { dropped: 0, skippedIpv6: 0, accessDenied: 0 };
143
160
  }
@@ -151,7 +168,7 @@ export function dropWindowsTcpRowsForLocalPort(port: number, mayMutate?: () => b
151
168
  return { dropped: 0, skippedIpv6: 0, accessDenied: 0 };
152
169
  }
153
170
 
154
- const rows = parseTcpQuadsForLocalPort(output, Math.trunc(port));
171
+ const rows = parseTcpQuadsForLocalPort(output, Math.trunc(port), ownerPids);
155
172
  let dropped = 0;
156
173
  let skippedIpv6 = 0;
157
174
  let accessDenied = 0;
@@ -31,6 +31,7 @@ import {
31
31
  type WorkflowSpendDenialDetail,
32
32
  } from "../lib/workflow-budget";
33
33
  import { currentWorkflowBudgetPolicy } from "../lib/workflow-budget-config";
34
+ import { SEND_BUDGET_EXHAUSTED_CODE } from "../lib/errors";
34
35
 
35
36
  /**
36
37
  * What a caller needs to hand over for the refusal to become a row on `/api/logs`.
@@ -152,6 +153,13 @@ export function unboundPoolSpendRefusalResponse(logCtx: RequestLogContext): Resp
152
153
  return workflowRefusalResponse("workflow-spend-exhausted", logCtx, undefined, undefined, detail);
153
154
  }
154
155
 
156
+ /** Preserve affinity when the proxy, rather than the serving credential, refuses a send. */
157
+ export function adapterSendBudgetRefusal(logCtx: RequestLogContext, rootId: string | undefined, message: string): Response {
158
+ logCtx.terminalSource = "synthetic";
159
+ return unboundPoolSpendRefusalResponse(logCtx) ?? workflowSendCeilingRefusalResponse(logCtx, rootId)
160
+ ?? markProxyError(formatErrorResponse(429, SEND_BUDGET_EXHAUSTED_CODE, message));
161
+ }
162
+
155
163
  /**
156
164
  * Admit one HTTP turn against its root workflow budget.
157
165
  *
@@ -1,5 +1,7 @@
1
1
  import { isolateCodexPoolAccountHeaders } from "../codex/forward-transport-headers";
2
+ import { isUntypedBareUpstreamError } from "./bare-upstream-error";
2
3
  import type { NativeResponseControl } from "./responses/native-response-control";
4
+ import type { HandleResponsesOptions } from "./responses/core-options";
3
5
  import type { ServerWebSocket } from "bun";
4
6
  import { responsesJsonEventSequence } from "./responses-json-events";
5
7
  import { FORWARD_HEADERS } from "../adapters/openai-responses";
@@ -8,7 +10,8 @@ import { headersForCodexAuthContext } from "../codex/auth-context";
8
10
  import type { ResponsesTerminalStatus } from "../bridge";
9
11
  import type { DataPlaneAdmission } from "./auth-cors";
10
12
  import type { AdmissionLease, AdmissionReservation } from "../lib/admission";
11
- import { BoundedSseFrameBuffer } from "./sse-frame-buffer";
13
+ import { BoundedSseFrameBuffer, MAX_CLIENT_SSE_FRAME_BYTES } from "./sse-frame-buffer";
14
+ import type { LinkTrafficFlow } from "../link/traffic";
12
15
  import { sseDataPayload as parseSseBlock } from "./sse-payload-rewrite";
13
16
  import { safeResponseHeaders } from "./safe-response-headers";
14
17
  import type { AudioSocketTarget } from "./audio-dictation";
@@ -18,6 +21,7 @@ import { isProxyError } from "../lib/client-error-body";
18
21
  import { WORKFLOW_LOCAL_REFUSAL_HEADER } from "../lib/workflow-budget";
19
22
  import { NativeContinuationRefusalError } from "./responses/native-continuation-refusal";
20
23
  import type { UsageClient } from "../usage/client";
24
+ import { LINK_WS_LIMITS, linkPumpTimer, linkPumpWaitObserver } from "./index/link-websocket-limits";
21
25
 
22
26
  export { safeResponseHeaders } from "./safe-response-headers";
23
27
 
@@ -40,6 +44,8 @@ export interface WsData {
40
44
  * attribution.
41
45
  */
42
46
  admission?: DataPlaneAdmission;
47
+ /** Local-only loopback replay identity; revalidated each turn without retaining its secret. */
48
+ replayPrincipal?: HandleResponsesOptions["replayPrincipal"];
43
49
  authContext?: CodexAuthContext; // last resolved account decision for observability/registry cleanup
44
50
  cancel?: () => void; // cancels the in-flight stream reader/fetch
45
51
  turnId?: number; // monotonically increasing per socket; prevents stale frames after replacement turns
@@ -77,6 +83,29 @@ export interface WsData {
77
83
  /** Turn/account ownership retained for the complete sideband socket lifetime. */
78
84
  liveTurnAdmissionLease?: AdmissionLease;
79
85
  admissionLease?: AdmissionReservation<ServerWebSocket<WsData>>;
86
+ /** Set only on Remote Link sockets: native steering and injection are unavailable there. */
87
+ nativeControlDisabled?: boolean;
88
+ /** Present only on a Remote Link socket (src/server/index/link-websocket.ts). */
89
+ link?: LinkSocketBinding;
90
+ /** Remote Link sockets only: one observer per admitted turn, by the handler's turn id. */
91
+ linkTurnObserver?: (turnId: number) => import("./link-turn").LinkTurnObserver;
92
+ /** Remote Link sockets only: the turn's cleanup ran, so its capture entry goes. */
93
+ linkTurnEnded?: (turnId: number) => void;
94
+ }
95
+
96
+ /** The verified identity and lease owner of one Remote Link socket; no secret is kept. */
97
+ export interface LinkSocketBinding {
98
+ readonly linkId: string;
99
+ readonly keyId: string;
100
+ readonly fingerprint: string;
101
+ /** Set once the socket is fenced (revoked or switched off); later frames are dropped. */
102
+ fenced: boolean;
103
+ /** Releases every lease of the upgrade exactly once, from the close callback. */
104
+ readonly leases: { closed(): void };
105
+ /** Set by the link pump while it waits for Bun's drain; the link handler calls it on drain and close. */
106
+ drained?: () => void;
107
+ /** This socket's flow in the Home's per-link traffic book: message payload bytes each way (link-websocket.ts). */
108
+ traffic?: LinkTrafficFlow;
80
109
  }
81
110
 
82
111
  export interface LiveSidebandUpstreamFailure {
@@ -112,12 +141,14 @@ export function buildResponsesWsData(
112
141
  admissionLease?: AdmissionReservation<ServerWebSocket<WsData>>,
113
142
  sessionLaneId?: string,
114
143
  client?: UsageClient,
144
+ replayPrincipal?: HandleResponsesOptions["replayPrincipal"],
115
145
  ): WsData {
116
146
  // Auth is handshake-time only on this path: the per-frame contexts have no
117
147
  // request headers left to re-resolve from, so the decision rides along here.
118
148
  return {
119
149
  headers,
120
150
  admission,
151
+ ...(replayPrincipal ? { replayPrincipal } : {}),
121
152
  ...(client ? { client } : {}),
122
153
  ...(admissionLease ? { admissionLease } : {}),
123
154
  ...(sessionLaneId ? { sessionLaneId } : {}),
@@ -192,6 +223,9 @@ export function sendTextFrame(ws: ServerWebSocket<WsData>, payload: string): voi
192
223
  const result = ws.send(payload);
193
224
  if (result === 0) throw new WsSendDroppedError();
194
225
  // Bun returns -1 when queued with backpressure. That is accepted; a later 0 is the hard failure.
226
+ // A link socket counts what Bun took, queued or written; a local socket has no flow and pays one property read.
227
+ const flow = ws.data.link?.traffic;
228
+ if (flow) flow.fromHome(Buffer.byteLength(payload));
195
229
  }
196
230
 
197
231
  export function sendJsonFrame(ws: ServerWebSocket<WsData>, payload: Record<string, unknown>): void {
@@ -269,6 +303,8 @@ export async function pumpResponsesSseToWebSocket(
269
303
  untilEof?: boolean;
270
304
  onTerminal?: ResponsesTerminalReporter;
271
305
  onSsePayload?: ResponsesPayloadObserver;
306
+ /** The body is the upstream itself (native control), so no relay tail follows a bare envelope. */
307
+ rawUpstream?: boolean;
272
308
  } = {},
273
309
  ): Promise<void> {
274
310
  const reader = sseStream.getReader();
@@ -282,10 +318,55 @@ export async function pumpResponsesSseToWebSocket(
282
318
  };
283
319
  const cancel = () => {
284
320
  clientCancelled = true;
321
+ wakeLinkWait?.();
285
322
  void reader.cancel().catch(() => {});
286
323
  };
287
324
  ws.data.cancel = cancel;
288
325
 
326
+ // Remote Link sockets only (design T4 6.2): after a send that leaves more than the threshold
327
+ // buffered, wait for Bun's drain before the next event, even within one upstream chunk, and feed
328
+ // the framer one bounded slice of a chunk at a time. Local sockets keep the single synchronous loop.
329
+ const link = ws.data.link;
330
+ let wakeLinkWait: (() => void) | undefined;
331
+ let linkStopped = false;
332
+ const waitForLinkDrain = async (): Promise<void> => {
333
+ if (!link || ws.getBufferedAmount() <= LINK_WS_LIMITS.sendThresholdBytes) return;
334
+ let stalled = false;
335
+ const observer = linkPumpWaitObserver();
336
+ observer?.(true);
337
+ await new Promise<void>(resolve => {
338
+ const clock = linkPumpTimer();
339
+ // One deadline for the whole wait, however many drain callbacks arrive before it ends.
340
+ const timer = clock.start(() => { stalled = true; done(); }, LINK_WS_LIMITS.sendStallMs);
341
+ function done(): void {
342
+ clock.stop(timer);
343
+ if (link!.drained === drained) link!.drained = undefined;
344
+ if (wakeLinkWait === done) wakeLinkWait = undefined;
345
+ resolve();
346
+ }
347
+ // Bun's drain means "ready for more", not "below the threshold": re-check on every callback.
348
+ function drained(): void {
349
+ if (!clientCancelled && ws.readyState === OPEN && ws.getBufferedAmount() > LINK_WS_LIMITS.sendThresholdBytes) return;
350
+ done();
351
+ }
352
+ link.drained = drained;
353
+ wakeLinkWait = done;
354
+ });
355
+ observer?.(false);
356
+ if (stalled && !clientCancelled) {
357
+ try { ws.close(1011, "link websocket send stalled"); } catch { /* already closing */ }
358
+ throw new WsSendDroppedError();
359
+ }
360
+ };
361
+ const slicesOf = (chunk: Uint8Array): Uint8Array[] => {
362
+ if (!link || chunk.byteLength <= LINK_WS_LIMITS.framerSliceBytes) return [chunk];
363
+ const slices: Uint8Array[] = [];
364
+ for (let offset = 0; offset < chunk.byteLength; offset += LINK_WS_LIMITS.framerSliceBytes) {
365
+ slices.push(chunk.subarray(offset, offset + LINK_WS_LIMITS.framerSliceBytes));
366
+ }
367
+ return slices;
368
+ };
369
+
289
370
  const decoder = new TextDecoder();
290
371
  const framer = new BoundedSseFrameBuffer();
291
372
  let terminalSeen = false;
@@ -294,12 +375,22 @@ export async function pumpResponsesSseToWebSocket(
294
375
  const handlePayload = (payload: string): boolean => {
295
376
  if (!isCurrent()) return true;
296
377
  if (payload === "[DONE]") return false;
297
- try {
298
- options.onSsePayload?.(payload);
299
- } catch {
300
- /* payload observation must not affect WebSocket delivery */
301
- }
302
378
  const type = payloadType(payload);
379
+ let untypedBare = false;
380
+ if (!type) {
381
+ try { untypedBare = isUntypedBareUpstreamError(JSON.parse(payload)); } catch { /* protocol error below */ }
382
+ }
383
+ // A relayed stream follows an untyped envelope with its own response.failed, so the envelope
384
+ // waits for it. A raw upstream body has no such tail: the envelope stays the protocol error
385
+ // it always was and is not recorded as a verdict the client never received.
386
+ if (!(untypedBare && options.rawUpstream)) {
387
+ try {
388
+ options.onSsePayload?.(payload);
389
+ } catch {
390
+ /* payload observation must not affect WebSocket delivery */
391
+ }
392
+ }
393
+ if (untypedBare && !options.rawUpstream) return false;
303
394
  if (!type) {
304
395
  reportTerminal("incomplete");
305
396
  sendProtocolError(ws, 502, "Invalid JSON payload in upstream SSE frame");
@@ -322,14 +413,22 @@ export async function pumpResponsesSseToWebSocket(
322
413
  };
323
414
 
324
415
  try {
325
- while (!terminalSeen) {
416
+ reading: while (!terminalSeen) {
326
417
  const { done, value } = await reader.read();
327
418
  if (done) break;
328
- for (const frame of framer.feed(value)) {
329
- const payload = parseSseBlock(decoder.decode(frame.block));
330
- if (payload && handlePayload(payload)) break;
419
+ for (const slice of slicesOf(value)) {
420
+ for (const frame of framer.feed(slice)) {
421
+ const payload = parseSseBlock(decoder.decode(frame.block));
422
+ if (payload && handlePayload(payload)) continue reading;
423
+ if (link) {
424
+ await waitForLinkDrain();
425
+ if (clientCancelled || ws.readyState !== OPEN) { linkStopped = true; break reading; }
426
+ }
427
+ }
331
428
  }
332
429
  }
430
+ // A link pump stopped by a cancel or close mid-chunk has nothing left to deliver or report.
431
+ if (linkStopped) return;
333
432
  const tail = framer.finish();
334
433
  if (!terminalSeen && tail.byteLength > 0) {
335
434
  const payload = parseSseBlock(decoder.decode(tail));
@@ -394,6 +493,81 @@ export function sendResponsesJsonAsEvents(
394
493
  onTerminal?.(finalStatus);
395
494
  }
396
495
 
496
+ /**
497
+ * Remote Link sockets only (design T4 6.2): wait until the send buffer is at or below the threshold, re-checking on
498
+ * every drain callback, under one stall deadline for the whole wait. A stall closes the socket with 1011 and throws,
499
+ * as the SSE pump does; a closed socket or a cancelled turn ends the wait, and only a live, current turn's stall
500
+ * closes the socket.
501
+ */
502
+ async function waitForLinkSendRoom(ws: ServerWebSocket<WsData>, turn: { cancelled: boolean; wake?: () => void; isCurrent: () => boolean }): Promise<void> {
503
+ const link = ws.data.link;
504
+ if (!link || turn.cancelled || ws.getBufferedAmount() <= LINK_WS_LIMITS.sendThresholdBytes) return;
505
+ let stalled = false;
506
+ const observer = linkPumpWaitObserver();
507
+ observer?.(true);
508
+ await new Promise<void>(resolve => {
509
+ const clock = linkPumpTimer();
510
+ const timer = clock.start(() => { stalled = true; done(); }, LINK_WS_LIMITS.sendStallMs);
511
+ function done(): void {
512
+ clock.stop(timer);
513
+ if (link!.drained === drained) link!.drained = undefined;
514
+ if (turn.wake === done) turn.wake = undefined;
515
+ resolve();
516
+ }
517
+ function drained(): void {
518
+ if (!turn.cancelled && ws.readyState === OPEN && ws.getBufferedAmount() > LINK_WS_LIMITS.sendThresholdBytes) return;
519
+ done();
520
+ }
521
+ link.drained = drained;
522
+ turn.wake = done;
523
+ });
524
+ observer?.(false);
525
+ if (stalled && !turn.cancelled && turn.isCurrent()) {
526
+ try { ws.close(1011, "link websocket send stalled"); } catch { /* already closing */ }
527
+ throw new WsSendDroppedError();
528
+ }
529
+ }
530
+
531
+ /**
532
+ * sendResponsesJsonAsEvents for a link socket: each synthesized event waits for send room first, the turn's cancel
533
+ * (supersession or close) ends that wait, and an event larger than the client frame limit is never sent: the turn
534
+ * ends incomplete with the 502 error frame the SSE pump sends for an oversized upstream frame.
535
+ */
536
+ async function sendResponsesJsonAsLinkEvents(
537
+ ws: ServerWebSocket<WsData>,
538
+ response: Record<string, unknown>,
539
+ isCurrent: () => boolean,
540
+ onTerminal?: ResponsesTerminalReporter,
541
+ onPayload?: ResponsesPayloadObserver,
542
+ ): Promise<void> {
543
+ const finalStatus = response.status === "failed" || response.status === "incomplete" ? response.status : "completed";
544
+ const turn: { cancelled: boolean; wake?: () => void; isCurrent: () => boolean } = { cancelled: false, isCurrent };
545
+ const previous = ws.data.cancel;
546
+ const cancel = () => {
547
+ turn.cancelled = true;
548
+ turn.wake?.();
549
+ previous?.();
550
+ };
551
+ ws.data.cancel = cancel;
552
+ try {
553
+ for (const frame of responsesJsonEventSequence(response)) {
554
+ await waitForLinkSendRoom(ws, turn);
555
+ if (turn.cancelled || !isCurrent() || ws.readyState !== OPEN) return;
556
+ const text = JSON.stringify(frame);
557
+ if (Buffer.byteLength(text) > MAX_CLIENT_SSE_FRAME_BYTES) {
558
+ onTerminal?.("incomplete");
559
+ sendJsonFrame(ws, buildWsErrorFrame(502, protocolError("synthesized response event exceeded " + MAX_CLIENT_SSE_FRAME_BYTES + " bytes")));
560
+ return;
561
+ }
562
+ try { onPayload?.(text); } catch { /* payload observation must not affect WebSocket delivery */ }
563
+ sendTextFrame(ws, text);
564
+ }
565
+ onTerminal?.(finalStatus);
566
+ } finally {
567
+ if (ws.data.cancel === cancel) ws.data.cancel = previous;
568
+ }
569
+ }
570
+
397
571
  function errorPayloadFromText(text: string): Record<string, unknown> {
398
572
  try {
399
573
  const json = JSON.parse(text) as { error?: unknown };
@@ -417,6 +591,7 @@ export async function sendResponseToWebSocket(
417
591
  untilEof?: boolean;
418
592
  onTerminal?: ResponsesTerminalReporter;
419
593
  onSsePayload?: ResponsesPayloadObserver;
594
+ rawUpstream?: boolean;
420
595
  } = {},
421
596
  ): Promise<void> {
422
597
  if (!isCurrent()) {
@@ -451,6 +626,7 @@ export async function sendResponseToWebSocket(
451
626
  untilEof: options.untilEof,
452
627
  onTerminal: options.onTerminal,
453
628
  onSsePayload: options.onSsePayload,
629
+ rawUpstream: options.rawUpstream,
454
630
  });
455
631
  return;
456
632
  }
@@ -459,7 +635,8 @@ export async function sendResponseToWebSocket(
459
635
  const text = await response.text();
460
636
  if (!isCurrent()) return;
461
637
  const json = JSON.parse(text) as Record<string, unknown>;
462
- sendResponsesJsonAsEvents(ws, json, options.onTerminal, options.onSsePayload);
638
+ if (ws.data.link) await sendResponsesJsonAsLinkEvents(ws, json, isCurrent, options.onTerminal, options.onSsePayload);
639
+ else sendResponsesJsonAsEvents(ws, json, options.onTerminal, options.onSsePayload);
463
640
  return;
464
641
  }
465
642
 
@@ -474,6 +651,7 @@ export async function sendResponseToWebSocket(
474
651
  untilEof: options.untilEof,
475
652
  onTerminal: options.onTerminal,
476
653
  onSsePayload: options.onSsePayload,
654
+ rawUpstream: options.rawUpstream,
477
655
  });
478
656
  return;
479
657
  }
@@ -483,7 +661,8 @@ export async function sendResponseToWebSocket(
483
661
  const trimmed = text.trim();
484
662
  if (trimmed.startsWith("{")) {
485
663
  const json = JSON.parse(trimmed) as Record<string, unknown>;
486
- sendResponsesJsonAsEvents(ws, json, options.onTerminal, options.onSsePayload);
664
+ if (ws.data.link) await sendResponsesJsonAsLinkEvents(ws, json, isCurrent, options.onTerminal, options.onSsePayload);
665
+ else sendResponsesJsonAsEvents(ws, json, options.onTerminal, options.onSsePayload);
487
666
  return;
488
667
  }
489
668
 
@@ -0,0 +1,189 @@
1
+ /**
2
+ * ocx service stop / uninstall / remove on Windows (#7771, 030 "Where it sits").
3
+ *
4
+ * - stop: Part A instead of stopWindows; a result other than stopped/absent refuses and
5
+ * leaves the proxy alone. Then a teardown receipt is claimed before the tracked proxy is
6
+ * stopped, so the proxy defers the shared teardown to this command. When the claim fails
7
+ * while this home owns the shared teardown, no undeferred child stop is sent: a wrapper
8
+ * appearing later could relaunch the proxy after its own teardown ran. Part B replaces
9
+ * the legacy survivor check after a Part A stopped. With an absent Part A every candidate
10
+ * endpoint must be proven dead before restore; the receipt is kept otherwise.
11
+ * - uninstall / remove: Part A before the task is deleted (a looping wrapper used to
12
+ * outlive its task, #764), refusing on anything but stopped/absent, then a receipt that
13
+ * carries Part A's record before the tracked proxy stop (Part A leaves the task
14
+ * registered, so a receipt-less POST answers 409 respawnable_service), then Part B. The
15
+ * receipt is kept until the caller's restore succeeds.
16
+ */
17
+ import { clearPendingTeardown, claimPendingTeardown } from "../config/pending-teardown";
18
+ import { readClientConnectionState } from "../client/state";
19
+ import type { ProbeEndpoint } from "../cli/uninstall-plan";
20
+ import { probeEndpointLiveness, type EndpointLiveness } from "../server/proxy-liveness";
21
+ import { resolveTrackedProxyTarget, stopTrackedProxyForServiceCommand } from "./orchestration";
22
+ import {
23
+ confirmWindowsServiceStop,
24
+ describeWindowsPartA,
25
+ describeWindowsPartB,
26
+ endpointsAllDead,
27
+ runWindowsServiceStopPartA,
28
+ windowsPartARecord,
29
+ windowsRemovalEndpoints,
30
+ windowsServiceStopPort,
31
+ windowsStopAdmission,
32
+ windowsStopRemainingMs,
33
+ } from "./windows-service-stop";
34
+ import { WINDOWS_STOP_CAPS } from "./windows-stop-budget";
35
+
36
+ export interface WindowsServiceStopCommandIo {
37
+ ownsSharedTeardown?: () => boolean;
38
+ claim?: typeof claimPendingTeardown;
39
+ stopTracked?: typeof stopTrackedProxyForServiceCommand;
40
+ resolveTarget?: typeof resolveTrackedProxyTarget;
41
+ /**
42
+ * Tri-state probe of an endpoint. Only a definitive "dead" on EVERY candidate permits
43
+ * deleting the task; "live" and "unknown" refuse and keep the receipt.
44
+ */
45
+ endpointLiveness?: (endpoint: { hostname: string; port: number }) => Promise<EndpointLiveness>;
46
+ /**
47
+ * Every endpoint this home could be serving on, for the absent-Part-A proof. Defaults to
48
+ * `endpointsToProve(readRuntimePort(), loadConfig())` — the set `ocx uninstall` proves.
49
+ */
50
+ endpoints?: () => ProbeEndpoint[];
51
+ }
52
+
53
+ /** Shared teardown belongs to this home unless a client connection owns the routing. */
54
+ function ownsSharedTeardownByDefault(): boolean {
55
+ try {
56
+ return readClientConnectionState().kind !== "connected";
57
+ } catch {
58
+ return true;
59
+ }
60
+ }
61
+
62
+ function withNonce(nonce: string | undefined): { ok: true; nonce?: string } {
63
+ return nonce ? { ok: true, nonce } : { ok: true };
64
+ }
65
+
66
+ /**
67
+ * Everything ocx service stop does before its restore. ok=false means the command fails
68
+ * and restores nothing; nonce is the receipt to complete once the restore succeeded.
69
+ */
70
+ export async function windowsServiceStopBeforeRestore(io: WindowsServiceStopCommandIo = {}): Promise<{ ok: boolean; nonce?: string }> {
71
+ const port = windowsServiceStopPort();
72
+ const partA = await runWindowsServiceStopPartA({ admission: windowsStopAdmission({ orphanDiscovery: true }) });
73
+ if (partA.outcome !== "stopped" && partA.outcome !== "absent") {
74
+ console.error("❌ service stop did not take effect: the Windows service could not be proven stopped (" + partA.outcome + ").");
75
+ console.error(" " + describeWindowsPartA(partA));
76
+ console.error(" The proxy was left running and native Codex was NOT restored.");
77
+ return { ok: false };
78
+ }
79
+ let nonce: string | undefined;
80
+ const target = await (io.resolveTarget ?? resolveTrackedProxyTarget)();
81
+ if (target && (io.ownsSharedTeardown ?? ownsSharedTeardownByDefault)()) {
82
+ if (!target.endpoint) { console.error("❌ service stop cannot defer teardown without the target's endpoint."); return { ok: false }; }
83
+ try {
84
+ nonce = (io.claim ?? claimPendingTeardown)(target.endpoint, "exact", process.pid, undefined, windowsPartARecord(partA)).nonce;
85
+ } catch (error) {
86
+ console.error("❌ service stop could not record its deferred-teardown receipt: " + (error instanceof Error ? error.message : String(error)));
87
+ console.error(" The proxy was left running: stopping it without the receipt would let it tear down client config while a wrapper can still relaunch it.");
88
+ return { ok: false };
89
+ }
90
+ }
91
+ const endpoints = partA.outcome === "absent" ? (io.endpoints ?? windowsRemovalEndpoints)() : [];
92
+ if (target?.endpoint && partA.outcome === "absent" && !endpoints.some(e => e.hostname === target.endpoint!.hostname && e.port === target.endpoint!.port)) endpoints.push(target.endpoint);
93
+ await (io.stopTracked ?? stopTrackedProxyForServiceCommand)({
94
+ target,
95
+ ...(nonce ? { deferSharedTeardownNonce: nonce } : {}),
96
+ skipPortWait: partA.outcome === "stopped",
97
+ orphanDiscoveryCapMs: WINDOWS_STOP_CAPS.orphanDiscovery,
98
+ });
99
+ if (partA.outcome === "absent") {
100
+ const proof = await endpointsAllDead(endpoints, io.endpointLiveness ?? probeEndpointLiveness);
101
+ if (proof.dead) return withNonce(nonce);
102
+ console.error(proof.live.length ? "❌ service stop did not take effect: a proxy is still listening on port " + proof.live.join(", ") + "."
103
+ : "❌ service stop did not take effect: endpoint liveness could not be confirmed on port " + proof.unknown.join(", ") + ".");
104
+ console.error(" Native Codex was NOT restored; the teardown receipt is kept for a later stop.");
105
+ return { ok: false };
106
+ }
107
+ const partB = await confirmWindowsServiceStop({ port: target?.endpoint?.port ?? port, remainingMs: windowsStopRemainingMs() });
108
+ if (partB.outcome === "freed") return withNonce(nonce);
109
+ if (partB.outcome === "port-held-by-foreign") {
110
+ console.warn("⚠️ " + describeWindowsPartB(partB));
111
+ return withNonce(nonce);
112
+ }
113
+ console.error("❌ service stop did not take effect: " + describeWindowsPartB(partB));
114
+ console.error(" Native Codex was NOT restored; the teardown receipt is kept so a later stop can finish it.");
115
+ return { ok: false };
116
+ }
117
+
118
+ /** After a successful restore: the obligation the receipt recorded is discharged. */
119
+ export function completeWindowsServiceStopReceipt(nonce: string | undefined, clear: (nonce: string) => boolean = clearPendingTeardown): void {
120
+ if (!nonce) return;
121
+ if (!clear(nonce)) console.warn("⚠️ The deferred-teardown receipt could not be removed; the next 'ocx stop' will finish it.");
122
+ }
123
+
124
+ /**
125
+ * ocx service uninstall / remove: stop and confirm before the task is deleted.
126
+ *
127
+ * Part A leaves the scheduler task registered, so a receipt-less POST still answers
128
+ * `respawnable_service` (409) and the uninstall then refuses with the proxy left running.
129
+ * The receipt is therefore claimed with Part A's record before the child stop, exactly as
130
+ * `ocx service stop` does, and kept until the caller's restore succeeds.
131
+ */
132
+ export async function windowsServiceRemovalStop(
133
+ io: Pick<WindowsServiceStopCommandIo, "stopTracked" | "resolveTarget" | "ownsSharedTeardown" | "claim" | "endpointLiveness" | "endpoints"> = {},
134
+ ): Promise<{ ok: boolean; nonce?: string }> {
135
+ const port = windowsServiceStopPort();
136
+ const partA = await runWindowsServiceStopPartA({ admission: windowsStopAdmission({ orphanDiscovery: true }) });
137
+ if (partA.outcome !== "stopped" && partA.outcome !== "absent") {
138
+ console.error("❌ Service uninstall refused: the Windows service could not be proven stopped (" + partA.outcome + "), so the task was not deleted.");
139
+ console.error(" " + describeWindowsPartA(partA));
140
+ return { ok: false };
141
+ }
142
+ let nonce: string | undefined;
143
+ const target = await (io.resolveTarget ?? resolveTrackedProxyTarget)();
144
+ const endpoints = partA.outcome === "absent" ? (io.endpoints ?? windowsRemovalEndpoints)() : [];
145
+ if (target?.endpoint && partA.outcome === "absent" && !endpoints.some(e => e.hostname === target.endpoint!.hostname && e.port === target.endpoint!.port)) endpoints.push(target.endpoint);
146
+ if (target && (io.ownsSharedTeardown ?? ownsSharedTeardownByDefault)()) {
147
+ if (!target.endpoint) { console.error("❌ Service uninstall cannot defer teardown without the target's endpoint."); return { ok: false }; }
148
+ try {
149
+ nonce = (io.claim ?? claimPendingTeardown)(target.endpoint, "exact", process.pid, undefined, windowsPartARecord(partA)).nonce;
150
+ } catch (error) {
151
+ console.error("❌ Service uninstall could not record its deferred-teardown receipt: " + (error instanceof Error ? error.message : String(error)));
152
+ console.error(" The proxy was left running: stopping it without the receipt would let it tear down client config while the task can still relaunch it.");
153
+ return { ok: false };
154
+ }
155
+ }
156
+ await (io.stopTracked ?? stopTrackedProxyForServiceCommand)({
157
+ target,
158
+ ...(nonce ? { deferSharedTeardownNonce: nonce } : {}),
159
+ skipPortWait: partA.outcome === "stopped",
160
+ orphanDiscoveryCapMs: WINDOWS_STOP_CAPS.orphanDiscovery,
161
+ });
162
+ if (partA.outcome === "absent") {
163
+ // "absent" says no manager is registered, not that nothing is serving. `findLiveProxy`
164
+ // inside the tracked stop can return null when its discovery cap runs out while the
165
+ // endpoint is live, and `proxyStillLiveAfterStop` returns that same null for a probe
166
+ // that timed out or failed — which the old branch read as success. Ask the endpoints
167
+ // themselves, tri-state, and delete the task only when EVERY candidate is definitively
168
+ // "dead": the receipt endpoint is only one of the addresses this home can serve on, and
169
+ // a stale runtime record pointing at a closed port used to prove removal while the
170
+ // configured port had a live listener. No respawn hold: with no manager registered
171
+ // there is nothing to relaunch the proxy.
172
+ const proof = await endpointsAllDead(endpoints, io.endpointLiveness ?? probeEndpointLiveness);
173
+ if (proof.dead) return withNonce(nonce);
174
+ console.error(proof.live.length > 0
175
+ ? "❌ Service uninstall refused: a proxy is still listening on port " + proof.live.join(", ") + "."
176
+ : "❌ Service uninstall refused: the endpoint on port " + (proof.unknown.join(", ") || port) + " could not be confirmed down.");
177
+ console.error(" The task was not deleted. Stop that proxy, then re-run 'ocx service uninstall'.");
178
+ return { ok: false };
179
+ }
180
+ const partB = await confirmWindowsServiceStop({ port: target?.endpoint?.port ?? port, remainingMs: windowsStopRemainingMs() });
181
+ if (partB.outcome === "freed") return withNonce(nonce);
182
+ if (partB.outcome === "port-held-by-foreign") {
183
+ console.warn("⚠️ " + describeWindowsPartB(partB));
184
+ return withNonce(nonce);
185
+ }
186
+ console.error("❌ Service uninstall refused: " + describeWindowsPartB(partB) + " The task was not deleted.");
187
+ console.error(" The teardown receipt is kept so a later stop can finish it.");
188
+ return { ok: false };
189
+ }