@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
@@ -32,6 +32,335 @@ export function isCredentialName(name: string): boolean {
32
32
  return SENSITIVE_KEY_PATTERN.test(name) || CREDENTIAL_HEADER_NAME.test(name);
33
33
  }
34
34
 
35
+ /** True for a request-correlation header: an identifier, not a credential, and never recorded. */
36
+ export function isCorrelationHeaderName(name: string): boolean {
37
+ return CORRELATION_HEADER_NAME.test(name);
38
+ }
39
+
40
+ /** Characters of a text a sent-value guard reads: a caller emits no copy beyond them. */
41
+ export const SENT_VALUE_GUARD_SCAN_CHARS = 8_192;
42
+ /** Excerpt windows produced beyond this many (repeats included) make a credential set fail closed. */
43
+ export const MAX_CREDENTIAL_EXCERPT_WINDOWS = 65_536;
44
+
45
+ function spellings(part: string): string[] {
46
+ const escaped = JSON.stringify(part).slice(1, -1);
47
+ return escaped === part ? [part] : [part, escaped];
48
+ }
49
+
50
+ /**
51
+ * The 8-character excerpt windows of a credential value: every window of each token between
52
+ * separators (whitespace, commas, semicolons, "=", quotes, backslashes), auth scheme words left out.
53
+ * A window never spans a separator, so scheme or field-name text cannot form one, while an opaque
54
+ * value containing "=" still has every token of 8+ characters covered.
55
+ * Generation stops once `max` windows are produced (repeats count), so a caller that sees more than
56
+ * `max` back knows coverage would be unbounded and fails closed.
57
+ */
58
+ export function credentialExcerptWindows(value: string, max = MAX_CREDENTIAL_EXCERPT_WINDOWS): string[] {
59
+ const windows: string[] = [];
60
+ for (const token of value.split(/[\s,;="\\]+/)) {
61
+ if (token.length < CREDENTIAL_SUBSTRING_MIN_LENGTH || AUTH_SCHEMES.has(token.toLowerCase())) continue;
62
+ for (let at = 0; at + CREDENTIAL_SUBSTRING_MIN_LENGTH <= token.length; at++) {
63
+ windows.push(token.slice(at, at + CREDENTIAL_SUBSTRING_MIN_LENGTH));
64
+ if (windows.length > max) return windows;
65
+ }
66
+ }
67
+ return windows;
68
+ }
69
+
70
+ /** Whether text holds any of the excerpt windows, reading at most the guard's scan window. */
71
+ export function containsExcerptWindow(text: string, windows: ReadonlySet<string>): boolean {
72
+ if (windows.size === 0) return false;
73
+ const head = text.length > SENT_VALUE_GUARD_SCAN_CHARS ? text.slice(0, SENT_VALUE_GUARD_SCAN_CHARS) : text;
74
+ for (let at = 0; at + CREDENTIAL_SUBSTRING_MIN_LENGTH <= head.length; at++) {
75
+ if (windows.has(head.slice(at, at + CREDENTIAL_SUBSTRING_MIN_LENGTH))) return true;
76
+ }
77
+ return false;
78
+ }
79
+
80
+
81
+ /**
82
+ * Whether text repeats a value these outbound headers carry, decided from this request's own
83
+ * headers so no global eviction can open it. A credential-named component is recognized whole at
84
+ * any length and by any excerpt of 8+ characters (its 8-character windows, capped: past the cap the
85
+ * guard fails closed); any other non-correlation component is recognized when 8+ characters of it
86
+ * occur whole. Only the first {@link SENT_VALUE_GUARD_SCAN_CHARS} characters are read, so work is
87
+ * bounded; callers emit nothing beyond them.
88
+ */
89
+ interface SentValueIndex {
90
+ wholeCredential: Set<string>;
91
+ credentialWindows: Set<string>;
92
+ contained: string[];
93
+ overflow: boolean;
94
+ }
95
+
96
+ function indexSentValues(headers: Record<string, string>, credentialOnly = false): SentValueIndex {
97
+ const wholeCredential = new Set<string>();
98
+ const credentialWindows = new Set<string>();
99
+ const contained: string[] = [];
100
+ let overflow = false;
101
+ let produced = 0;
102
+ for (const [name, value] of Object.entries(headers)) {
103
+ const credentialNamed = isCredentialName(name);
104
+ if (!credentialNamed && CORRELATION_HEADER_NAME.test(name)) continue;
105
+ for (const part of credentialComponents(value)) {
106
+ if (!credentialNamed) {
107
+ if (!credentialOnly && part.length >= CREDENTIAL_SUBSTRING_MIN_LENGTH) contained.push(...spellings(part));
108
+ continue;
109
+ }
110
+ for (const spelling of spellings(part)) {
111
+ wholeCredential.add(spelling);
112
+ if (overflow) continue;
113
+ const windows = credentialExcerptWindows(spelling, MAX_CREDENTIAL_EXCERPT_WINDOWS - produced);
114
+ produced += windows.length;
115
+ if (produced > MAX_CREDENTIAL_EXCERPT_WINDOWS) overflow = true;
116
+ else for (const window of windows) credentialWindows.add(window);
117
+ }
118
+ }
119
+ }
120
+ return { wholeCredential, credentialWindows, contained, overflow };
121
+ }
122
+
123
+ function scanHead(text: string): string {
124
+ return text.length > SENT_VALUE_GUARD_SCAN_CHARS ? text.slice(0, SENT_VALUE_GUARD_SCAN_CHARS) : text;
125
+ }
126
+
127
+ export function createSentValueGuard(headers: Record<string, string>): (text: string) => boolean {
128
+ const { wholeCredential, credentialWindows, contained, overflow } = indexSentValues(headers);
129
+ const containedIndex = new SecretIndex(contained);
130
+ return (text) => {
131
+ if (overflow) return true;
132
+ const head = scanHead(text);
133
+ if (wholeCredential.has(head)) return true;
134
+ for (let at = 0; at + CREDENTIAL_SUBSTRING_MIN_LENGTH <= head.length; at++) {
135
+ if (credentialWindows.has(head.slice(at, at + CREDENTIAL_SUBSTRING_MIN_LENGTH))) return true;
136
+ }
137
+ return markSubstringSpans(head, containedIndex, undefined) !== undefined;
138
+ };
139
+ }
140
+
141
+ /**
142
+ * The span-masking form of {@link createSentValueGuard}: it returns the scanned head of text with
143
+ * only the characters that repeat a sent value replaced (every matching 8-character window of a
144
+ * credential token, every contained non-credential value), so the surrounding copy, such as refusal
145
+ * wording a reader classifies, survives. The whole head is replaced when it equals a credential, and
146
+ * everything is replaced past the window cap.
147
+ */
148
+ export function createSentValueMask(
149
+ headers: Record<string, string>,
150
+ replacement: string,
151
+ options: { credentialOnly?: boolean; wholeText?: boolean } = {},
152
+ ): (text: string) => string {
153
+ // `credentialOnly`: only credential-named values (whole and by excerpt), for copy where other
154
+ // header values (a content type, a user agent) are ordinary text that must stay readable.
155
+ // `wholeText`: read and return all of the text (linear work), for genuine Responses terminals whose
156
+ // output must not be cut; the default reads and returns only the guard's scan window.
157
+ const { wholeCredential, credentialWindows, contained, overflow } = indexSentValues(headers, options.credentialOnly);
158
+ const containedIndex = new SecretIndex(contained);
159
+ return (text) => {
160
+ if (overflow) return replacement;
161
+ const head = options.wholeText ? text : scanHead(text);
162
+ if (wholeCredential.has(head)) return replacement;
163
+ // Matching windows are marked in the same pass that finds them, so the work stays linear in the
164
+ // text length however many distinct windows match (a rescan per window would be quadratic).
165
+ let covered: Uint8Array | undefined;
166
+ for (let at = 0; at + CREDENTIAL_SUBSTRING_MIN_LENGTH <= head.length; at++) {
167
+ if (!credentialWindows.has(head.slice(at, at + CREDENTIAL_SUBSTRING_MIN_LENGTH))) continue;
168
+ covered ??= new Uint8Array(head.length);
169
+ covered.fill(1, at, at + CREDENTIAL_SUBSTRING_MIN_LENGTH);
170
+ }
171
+ covered = markSubstringSpans(head, containedIndex, covered);
172
+ return covered === undefined ? head : renderCoveredSpans(head, covered, replacement);
173
+ };
174
+ }
175
+
176
+ /**
177
+ * Replace every span of text a secret covers: the whole text when it equals a whole-only value, and
178
+ * every occurrence of each substring value. Coverage is marked on the original text before anything
179
+ * is replaced, so overlapping values are replaced as one union and no part of either survives
180
+ * between them. Pass a {@link SecretIndex} built once when the same secrets mask many strings: the
181
+ * work per call is then linear in that string, independent of how many secrets there are.
182
+ */
183
+ export function maskSecretSpans(text: string, replacement: string, substrings: Iterable<string> | SecretIndex, wholeOnly: Iterable<string> = []): string {
184
+ for (const value of wholeOnly) if (value && text === value) return replacement;
185
+ const covered = markSubstringSpans(text, substrings instanceof SecretIndex ? substrings : new SecretIndex(substrings), undefined);
186
+ return covered === undefined ? text : renderCoveredSpans(text, covered, replacement);
187
+ }
188
+
189
+ /**
190
+ * Secrets prepared for {@link maskSecretSpans}: deduplicated, 8+ character secrets grouped by their
191
+ * first 8 characters with each group sorted by length, shorter ones grouped by length. Built once
192
+ * per request, so masking each string of a frame does not rebuild it. Border tables are computed
193
+ * lazily, at most once per secret, and charged to the call that needs them.
194
+ */
195
+ export class SecretIndex {
196
+ readonly byPrefix = new Map<string, string[]>();
197
+ readonly shortByLength = new Map<number, Set<string>>();
198
+ readonly bordered = new Map<string, boolean>();
199
+
200
+ constructor(substrings: Iterable<string>) {
201
+ for (const secret of new Set(substrings)) {
202
+ if (!secret) continue;
203
+ if (secret.length >= CREDENTIAL_SUBSTRING_MIN_LENGTH) {
204
+ const prefix = secret.slice(0, CREDENTIAL_SUBSTRING_MIN_LENGTH);
205
+ const group = this.byPrefix.get(prefix);
206
+ if (group) group.push(secret);
207
+ else this.byPrefix.set(prefix, [secret]);
208
+ } else {
209
+ const group = this.shortByLength.get(secret.length) ?? new Set<string>();
210
+ group.add(secret);
211
+ this.shortByLength.set(secret.length, group);
212
+ }
213
+ }
214
+ for (const group of this.byPrefix.values()) group.sort((a, b) => a.length - b.length);
215
+ }
216
+ }
217
+
218
+ function markSubstringSpans(text: string, index: SecretIndex, initial: Uint8Array | undefined): Uint8Array | undefined {
219
+ // One pass over the text finds every secret, however many there are: secrets of 8+ characters are
220
+ // looked up by the 8 characters at each position, shorter ones by a slice of their own length (at
221
+ // most seven passes). A prefix group is walked shortest first and stops at the first secret that
222
+ // cannot fit in the text left, so only candidates that fit are visited, and each is charged:
223
+ // confirming it, building its border table, and the one scan of a confirmed self-overlapping
224
+ // secret. The budget is proportional to the text; past it the whole text is covered (fail closed),
225
+ // so neither the frame nor the secret set can make the work superlinear.
226
+ const n = text.length;
227
+ let covered = initial;
228
+ for (const [length, group] of index.shortByLength) {
229
+ for (let at = 0; at + length <= n; at++) {
230
+ if (!group.has(text.slice(at, at + length))) continue;
231
+ covered ??= new Uint8Array(n);
232
+ covered.fill(1, at, at + length);
233
+ }
234
+ }
235
+ if (index.byPrefix.size === 0) return covered;
236
+ const budget = { steps: MATCH_WORK_PER_CHAR * n + MATCH_WORK_FLOOR };
237
+ const scanned = new Set<string>();
238
+ for (let at = 0; at + CREDENTIAL_SUBSTRING_MIN_LENGTH <= n; at++) {
239
+ const group = index.byPrefix.get(text.slice(at, at + CREDENTIAL_SUBSTRING_MIN_LENGTH));
240
+ if (group === undefined) continue;
241
+ for (const secret of group) {
242
+ if (secret.length > n - at) break;
243
+ if (scanned.has(secret)) continue;
244
+ // Charged by the characters actually compared, so a prefix shared by absent secrets costs
245
+ // little while near-copies of a long secret at every position still exhaust the budget.
246
+ const matched = matchedLength(text, at, secret);
247
+ budget.steps -= matched + 1;
248
+ if (budget.steps < 0) return (covered ?? new Uint8Array(n)).fill(1);
249
+ if (matched < secret.length) continue;
250
+ covered ??= new Uint8Array(n);
251
+ let selfOverlapping = index.bordered.get(secret);
252
+ if (selfOverlapping === undefined) {
253
+ budget.steps -= secret.length;
254
+ if (budget.steps < 0) return covered.fill(1);
255
+ selfOverlapping = hasBorder(secret);
256
+ index.bordered.set(secret, selfOverlapping);
257
+ }
258
+ if (selfOverlapping) {
259
+ // A confirmed self-overlapping secret is found from here on by one Knuth-Morris-Pratt scan,
260
+ // so a prefix shared by many secrets that are absent never starts a scan.
261
+ scanned.add(secret);
262
+ budget.steps -= n - at;
263
+ if (budget.steps < 0) return covered.fill(1);
264
+ markOverlappingOccurrences(text, secret, at, covered);
265
+ continue;
266
+ }
267
+ covered.fill(1, at, at + secret.length);
268
+ }
269
+ }
270
+ return covered;
271
+ }
272
+
273
+ /** Confirmation and scan work one masking call may spend per text character before it fails closed. */
274
+ const MATCH_WORK_PER_CHAR = 8;
275
+ const MATCH_WORK_FLOOR = 256;
276
+
277
+ /**
278
+ * Whether text contains any indexed secret, in one pass over text with the same charged walk as
279
+ * {@link maskSecretSpans}: it stops at the first confirmed occurrence, and reports true once the
280
+ * budget runs out (fail closed), so a check of a long upstream message against many values is linear.
281
+ */
282
+ export function containsIndexedSecret(text: string, index: SecretIndex): boolean {
283
+ const n = text.length;
284
+ for (const [length, group] of index.shortByLength) {
285
+ for (let at = 0; at + length <= n; at++) if (group.has(text.slice(at, at + length))) return true;
286
+ }
287
+ if (index.byPrefix.size === 0) return false;
288
+ let budget = MATCH_WORK_PER_CHAR * n + MATCH_WORK_FLOOR;
289
+ for (let at = 0; at + CREDENTIAL_SUBSTRING_MIN_LENGTH <= n; at++) {
290
+ const group = index.byPrefix.get(text.slice(at, at + CREDENTIAL_SUBSTRING_MIN_LENGTH));
291
+ if (group === undefined) continue;
292
+ for (const secret of group) {
293
+ if (secret.length > n - at) break;
294
+ const matched = matchedLength(text, at, secret);
295
+ budget -= matched + 1;
296
+ if (budget < 0) return true;
297
+ if (matched === secret.length) return true;
298
+ }
299
+ }
300
+ return false;
301
+ }
302
+
303
+ /**
304
+ * How many leading characters of secret match text at at (the index already matched the first 8):
305
+ * secret.length exactly when the whole secret occurs there. A candidate is charged this plus one,
306
+ * the comparison work it actually cost.
307
+ */
308
+ function matchedLength(text: string, at: number, secret: string): number {
309
+ let i = CREDENTIAL_SUBSTRING_MIN_LENGTH;
310
+ while (i < secret.length && text.charCodeAt(at + i) === secret.charCodeAt(i)) i++;
311
+ return i;
312
+ }
313
+
314
+ /** Whether a proper prefix of the secret is also its suffix, so two occurrences can overlap. */
315
+ function hasBorder(secret: string): boolean {
316
+ return borderTable(secret)[secret.length - 1]! > 0;
317
+ }
318
+
319
+ function borderTable(secret: string): Int32Array {
320
+ const m = secret.length;
321
+ const fail = new Int32Array(m);
322
+ for (let i = 1, k = 0; i < m; i++) {
323
+ while (k > 0 && secret.charCodeAt(i) !== secret.charCodeAt(k)) k = fail[k - 1]!;
324
+ if (secret.charCodeAt(i) === secret.charCodeAt(k)) k++;
325
+ fail[i] = k;
326
+ }
327
+ return fail;
328
+ }
329
+
330
+ /**
331
+ * Mark every occurrence of secret at or after from, overlapping ones included, in one
332
+ * Knuth-Morris-Pratt pass: linear in the text even when a long repetitive secret overlaps itself at
333
+ * every position (restarting a search one character after each match would recheck it there).
334
+ */
335
+ function markOverlappingOccurrences(text: string, secret: string, from: number, covered: Uint8Array): void {
336
+ const m = secret.length;
337
+ const fail = borderTable(secret);
338
+ let markedTo = 0;
339
+ for (let i = from, k = 0; i < text.length; i++) {
340
+ while (k > 0 && text.charCodeAt(i) !== secret.charCodeAt(k)) k = fail[k - 1]!;
341
+ if (text.charCodeAt(i) === secret.charCodeAt(k)) k++;
342
+ if (k === m) {
343
+ const end = i + 1;
344
+ covered.fill(1, Math.max(end - m, markedTo), end);
345
+ markedTo = end;
346
+ k = fail[m - 1]!;
347
+ }
348
+ }
349
+ }
350
+
351
+ function renderCoveredSpans(text: string, covered: Uint8Array, replacement: string): string {
352
+ let out = "";
353
+ let at = 0;
354
+ while (at < text.length) {
355
+ const run = covered[at];
356
+ let next = at + 1;
357
+ while (next < text.length && covered[next] === run) next++;
358
+ out += run ? replacement : text.slice(at, next);
359
+ at = next;
360
+ }
361
+ return out;
362
+ }
363
+
35
364
  /**
36
365
  * Values of RFC 9110 auth-params (token BWS "=" BWS ( token / quoted-string )), cookie pairs and
37
366
  * other name=value pairs, in one linear pass: every character is visited a bounded number of times,
@@ -113,14 +442,30 @@ export function credentialComponents(value: string): string[] {
113
442
  }
114
443
 
115
444
  /** Exact equality at any length at or above minLength; containment for values of 8+ characters. */
116
- export function credentialSetMatches(values: Iterable<string>, has: (value: string) => boolean, value: string, minLength = 1): boolean {
445
+ export function credentialSetMatches(
446
+ values: Iterable<string>,
447
+ has: (value: string) => boolean,
448
+ value: string,
449
+ minLength = 1,
450
+ index?: SecretIndex,
451
+ ): boolean {
117
452
  if (value.length >= minLength && has(value)) return true;
453
+ // An index of the containment-eligible values makes the check one pass over value, however many
454
+ // values there are; it must hold exactly the values of max(minLength, 8)+ characters.
455
+ if (index !== undefined) return containsIndexedSecret(value, index);
118
456
  for (const secret of values) {
119
457
  if (secret.length >= Math.max(minLength, CREDENTIAL_SUBSTRING_MIN_LENGTH) && value.includes(secret)) return true;
120
458
  }
121
459
  return false;
122
460
  }
123
461
 
462
+ /** The containment-eligible index {@link credentialSetMatches} takes for these values. */
463
+ export function credentialContainmentIndex(values: Iterable<string>, minLength = 1): SecretIndex {
464
+ const eligible: string[] = [];
465
+ for (const secret of values) if (secret.length >= Math.max(minLength, CREDENTIAL_SUBSTRING_MIN_LENGTH)) eligible.push(secret);
466
+ return new SecretIndex(eligible);
467
+ }
468
+
124
469
  export interface OutboundCredentialRegistryOptions {
125
470
  maxEntries?: number;
126
471
  maxBytes?: number;
@@ -131,6 +476,7 @@ export interface OutboundCredentialRegistryOptions {
131
476
  class BoundedValueSet {
132
477
  readonly values = new Map<string, number>();
133
478
  private totalBytes = 0;
479
+ private index: SecretIndex | undefined;
134
480
  complete = true;
135
481
  constructor(private readonly maxEntries: number, private readonly maxBytes: number, private readonly maxValueBytes: number) {}
136
482
 
@@ -148,6 +494,7 @@ class BoundedValueSet {
148
494
  }
149
495
  this.values.set(value, bytes);
150
496
  this.totalBytes += bytes;
497
+ this.index = undefined;
151
498
  while (this.values.size > this.maxEntries || this.totalBytes > this.maxBytes) {
152
499
  const oldest = this.values.keys().next().value as string;
153
500
  this.totalBytes -= this.values.get(oldest)!;
@@ -157,30 +504,41 @@ class BoundedValueSet {
157
504
  }
158
505
 
159
506
  matches(value: string, minLength: number): boolean {
160
- return credentialSetMatches(this.values.keys(), candidate => this.values.has(candidate), value, minLength);
507
+ // Each set is always matched with the same minLength; the index is rebuilt after the set changes.
508
+ this.index ??= credentialContainmentIndex(this.values.keys(), minLength);
509
+ return credentialSetMatches(this.values.keys(), candidate => this.values.has(candidate), value, minLength, this.index);
161
510
  }
162
511
  }
163
512
 
164
513
  export class OutboundCredentialRegistry {
165
514
  private readonly strict: BoundedValueSet;
166
515
  private readonly observed: BoundedValueSet;
516
+ private readonly maxValueBytes: number;
167
517
 
168
518
  constructor(options: OutboundCredentialRegistryOptions = {}) {
169
519
  const entries = options.maxEntries ?? 4096;
170
520
  const bytes = options.maxBytes ?? 1 << 20;
171
521
  const valueBytes = options.maxValueBytes ?? 16_384;
522
+ this.maxValueBytes = valueBytes;
172
523
  this.strict = new BoundedValueSet(entries, bytes, valueBytes);
173
524
  this.observed = new BoundedValueSet(entries, bytes, valueBytes);
174
525
  }
175
526
 
176
- /** Record the components of every value in headers that are about to be sent. */
527
+ /**
528
+ * Record the components of every value in headers that are about to be sent. A component too
529
+ * large to keep, credential-named or not, marks the registry incomplete: no bounded record can
530
+ * recognize every excerpt of it, so every caller fails closed instead.
531
+ */
177
532
  remember(headers: HeadersInit | Headers | undefined): void {
178
533
  if (!headers) return;
179
534
  new Headers(headers).forEach((value, name) => {
180
535
  const strict = isCredentialName(name);
181
536
  if (!strict && CORRELATION_HEADER_NAME.test(name)) return;
182
537
  const tier = strict ? this.strict : this.observed;
183
- for (const part of credentialComponents(value)) tier.add(part);
538
+ for (const part of credentialComponents(value)) {
539
+ tier.add(part);
540
+ if (Buffer.byteLength(part, "utf8") > this.maxValueBytes) this.strict.complete = false;
541
+ }
184
542
  });
185
543
  }
186
544
 
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Pacing that travels with a stream (#8601).
3
+ *
4
+ * A Remote Link turn while the link WebSocket feature is on reads its upstream body only as its client drains. Each
5
+ * relay stage between the upstream and the client normally keeps one chunk queued ahead of its reader; a stage whose
6
+ * source is paced queues none instead and marks its own output, so the whole chain pulls on demand. Streams that were
7
+ * never marked keep their default queue: every other request is unchanged.
8
+ */
9
+ const paced = new WeakSet<ReadableStream<Uint8Array>>();
10
+
11
+ /** How far a reader of a paced stream may get ahead of its own reader: one chunk, never a byte allowance. */
12
+ export const PACED_READ_AHEAD_BYTES = 1;
13
+
14
+ /** Mark a stream whose reads must follow its reader's demand. */
15
+ export function markPacedStream(stream: ReadableStream<Uint8Array>): ReadableStream<Uint8Array> {
16
+ paced.add(stream);
17
+ return stream;
18
+ }
19
+
20
+ /** Whether a stream was marked paced, or carries the mark of a paced source. */
21
+ export function isPacedStream(stream: ReadableStream<Uint8Array> | null | undefined): boolean {
22
+ return stream ? paced.has(stream) : false;
23
+ }
24
+
25
+ /** The queuing strategy for a stage reading `source`: none ahead when the source is paced, the default otherwise. */
26
+ export function pacedQueuingStrategy(source: ReadableStream<Uint8Array> | null | undefined): QueuingStrategy<Uint8Array> | undefined {
27
+ return source && paced.has(source) ? { highWaterMark: 0 } : undefined;
28
+ }
29
+
30
+ /** Carry a paced source's mark to the stage's output. */
31
+ export function carryPacedStream<T extends ReadableStream<Uint8Array>>(source: ReadableStream<Uint8Array> | null | undefined, output: T): T {
32
+ if (source && paced.has(source)) paced.add(output);
33
+ return output;
34
+ }
@@ -0,0 +1,30 @@
1
+ /** Process-local proof that an executor preserves destination and credential headers. */
2
+ const proven = new WeakSet<typeof globalThis.fetch>();
3
+ const deferred = new WeakSet<typeof globalThis.fetch>();
4
+
5
+ /** A trusted transport calls this hook immediately before its physical executor. */
6
+ export const PASSIVE_KEY_SEND = Symbol("passive-key-send");
7
+
8
+ export function markPassiveKeyDeferred<T extends typeof globalThis.fetch>(fetcher: T): T {
9
+ deferred.add(fetcher);
10
+ return fetcher;
11
+ }
12
+
13
+ export function isPassiveKeyDeferred(fetcher: typeof globalThis.fetch): boolean {
14
+ return deferred.has(fetcher);
15
+ }
16
+
17
+ export function inheritPassiveKeyProof<T extends typeof globalThis.fetch>(wrapper: T, inner: typeof globalThis.fetch): T {
18
+ if (isPassiveKeyTransparent(inner)) markPassiveKeyTransparent(wrapper);
19
+ if (isPassiveKeyDeferred(inner)) markPassiveKeyDeferred(wrapper);
20
+ return wrapper;
21
+ }
22
+
23
+ export function markPassiveKeyTransparent<T extends typeof globalThis.fetch>(fetcher: T): T {
24
+ proven.add(fetcher);
25
+ return fetcher;
26
+ }
27
+
28
+ export function isPassiveKeyTransparent(fetcher: typeof globalThis.fetch): boolean {
29
+ return proven.has(fetcher);
30
+ }
@@ -30,6 +30,11 @@ export function runPassiveRead<T>(run: () => Promise<T>, options: { onDiagnostic
30
30
  return passive.run(options, run);
31
31
  }
32
32
 
33
+ /** The same boundary for synchronous cache projections. */
34
+ export function runPassiveReadSync<T>(run: () => T): T {
35
+ return passive.run(passive.getStore() ?? {}, run);
36
+ }
37
+
33
38
  export function isPassiveRead(): boolean {
34
39
  return passive.getStore() !== undefined;
35
40
  }
@@ -61,6 +61,46 @@ export interface GracefulStopIo {
61
61
  * endpoint the stop never contacted — and recovery probes exactly that endpoint.
62
62
  */
63
63
  runtimeEndpoint?: { hostname: string; port: number };
64
+ /**
65
+ * Send the stop only to `runtimeEndpoint`: without one, no request is sent and the runtime
66
+ * record is not read again. A caller whose deferral receipt names the endpoint it resolved sets
67
+ * this, so a record published in between cannot direct the request, and the receipt, elsewhere.
68
+ */
69
+ runtimeEndpointOnly?: boolean;
70
+ /**
71
+ * Asked again immediately before the forced-stop fallback signals `pid`; false refuses the
72
+ * signal (killProxy throws). A caller that proved which process it may stop rechecks that here,
73
+ * so a pid reused after the graceful attempt is never signalled.
74
+ */
75
+ mayTerminate?: () => boolean;
76
+ /**
77
+ * Windows checked stop (#7771): Part B confirms the port after this stop returns and
78
+ * owns the wait, so the 15 s waitForStoppedPort here is skipped (030 "Time budget").
79
+ */
80
+ skipPortWait?: boolean;
81
+ /**
82
+ * Whether a graceful stop that did not confirm may fall back to the platform kill ladder.
83
+ *
84
+ * `ocx uninstall` sets this false when its Part A did not end stopped/absent: a manager
85
+ * that would not stop can respawn the proxy, and `taskkill /T /F` under it is exactly the
86
+ * forced stop the checked Windows stop exists to prevent. A 409 refusal never reaches the
87
+ * fallback either way. Defaults to true, which is every other caller's behaviour.
88
+ */
89
+ allowForcedFallback?: boolean;
90
+ /**
91
+ * The forced ladder, injectable so the rule above can be proven without signalling a
92
+ * process. Production callers omit it and get {@link killProxy}.
93
+ */
94
+ forceKill?: (pid: number) => void;
95
+ /**
96
+ * The post-stop port wait, injectable so a test can present a verified listener without
97
+ * starting one. Production callers omit it and get `reclaimListenPort`.
98
+ */
99
+ reclaimPort?: (
100
+ port: number,
101
+ hostname: string,
102
+ opts: { timeoutMs?: number; intervalMs?: number; scanIntervalMs?: number; killOcxHolders?: boolean; onlyKillPids?: number[] },
103
+ ) => Promise<boolean>;
64
104
  }
65
105
 
66
106
  /**
@@ -235,7 +275,7 @@ async function stopProxyGracefullyDetailed(
235
275
  const done = (result: GracefulStopResult): { result: GracefulStopResult; refusal: StopRefusal } =>
236
276
  ({ result, refusal });
237
277
  const readRuntime = io.readRuntime ?? readRuntimePort;
238
- const runtime = io.runtimeEndpoint ?? readRuntime(pid);
278
+ const runtime = io.runtimeEndpoint ?? (io.runtimeEndpointOnly ? null : readRuntime(pid));
239
279
  if (!runtime?.port) return done(false);
240
280
  const env = io.env ?? process.env;
241
281
  const headers: Record<string, string> = {};
@@ -319,7 +359,7 @@ function drainDeadlineMs(): number {
319
359
  /** Graceful-first stop: management-API drain, then the platform kill ladder. */
320
360
  export async function stopProxy(pid: number, io: GracefulStopIo = {}): Promise<boolean> {
321
361
  if (!isProcessAlive(pid)) return false;
322
- const runtime = io.runtimeEndpoint ?? readRuntimePort(pid);
362
+ const runtime = io.skipPortWait ? null : io.runtimeEndpoint ?? (io.runtimeEndpointOnly ? null : readRuntimePort(pid));
323
363
  const { result: graceful, refusal } = await stopProxyGracefullyDetailed(pid, io);
324
364
  if (graceful === "refused") {
325
365
  // The proxy refused on purpose. Forcing would strip shared config while whatever owns
@@ -334,39 +374,62 @@ export async function stopProxy(pid: number, io: GracefulStopIo = {}): Promise<b
334
374
  if (graceful === "teardown-unconfirmed") {
335
375
  // Exit was observed, so do not enter the forced-stop fallback. Returning false keeps
336
376
  // shared restoration with `ocx stop` instead of claiming that the proxy completed it.
337
- await waitForStoppedPort(runtime, pid);
377
+ await waitForStoppedPort(runtime, pid, io);
338
378
  return false;
339
379
  }
340
380
  if (graceful) {
341
- await waitForStoppedPort(runtime, pid);
381
+ await waitForStoppedPort(runtime, pid, io);
342
382
  return true;
343
383
  }
344
- killProxy(pid);
345
- await waitForStoppedPort(runtime, pid);
384
+ if (io.allowForcedFallback === false) {
385
+ // The caller forbade the forced ladder (a manager that would not stop may respawn the
386
+ // proxy). Report the unconfirmed stop; the caller keeps its failure recorded.
387
+ await waitForStoppedPort(runtime, pid, io);
388
+ return false;
389
+ }
390
+ // Written as a literal killProxy(pid, ...) call so the refusal-before-kill ordering stays
391
+ // checkable in source (tests/providers/xai/grok-lifecycle.test.ts); the seam only swaps it.
392
+ if (io.forceKill) io.forceKill(pid);
393
+ else killProxy(pid, io.mayTerminate);
394
+ await waitForStoppedPort(runtime, pid, io);
346
395
  return false;
347
396
  }
348
397
 
349
- /** After stop/kill, wait for the former listen port to become bindable (Windows drain). */
398
+ /**
399
+ * After stop/kill, wait for the former listen port to become bindable (Windows drain).
400
+ *
401
+ * The wait is OBSERVATIONAL whenever the caller forbade the forced ladder
402
+ * (`allowForcedFallback === false`). Reclaiming with `killOcxHolders` would terminate a
403
+ * verified listener through `killProxy`, which is the forced stop that refusal exists to
404
+ * prevent: a manager that would not stop may respawn the proxy, so a survivor must be
405
+ * reported rather than killed. The wait still runs and still returns; it only stops being
406
+ * allowed to change anything.
407
+ */
350
408
  async function waitForStoppedPort(
351
409
  runtime: { port: number; hostname?: string } | null | undefined,
352
410
  stoppedPid?: number,
411
+ io: GracefulStopIo = {},
353
412
  ): Promise<void> {
354
413
  if (!runtime?.port) return;
414
+ const mayKill = io.allowForcedFallback !== false;
355
415
  try {
356
- const { reclaimListenPort } = await import("../server/port-reclaim");
357
- await reclaimListenPort(runtime.port, runtime.hostname ?? "127.0.0.1", {
416
+ const reclaim = io.reclaimPort ?? (await import("../server/port-reclaim")).reclaimListenPort;
417
+ await reclaim(runtime.port, runtime.hostname ?? "127.0.0.1", {
358
418
  timeoutMs: 15_000,
359
419
  intervalMs: 100,
360
420
  scanIntervalMs: 500,
361
421
  // Only the process we just stopped — never kill a newly started twin proxy.
362
- killOcxHolders: !!(stoppedPid && stoppedPid > 0),
363
- onlyKillPids: stoppedPid && stoppedPid > 0 ? [stoppedPid] : [],
422
+ killOcxHolders: mayKill && !!(stoppedPid && stoppedPid > 0),
423
+ onlyKillPids: mayKill && stoppedPid && stoppedPid > 0 ? [stoppedPid] : [],
364
424
  });
365
425
  } catch {
366
426
  /* best-effort — callers that need a hard guarantee reclaim again before bind */
367
427
  }
368
428
  }
369
429
 
430
+ /** taskkill in the forced fallback; it had no timeout before #7771. */
431
+ export const FORCED_TASKKILL_TIMEOUT_MS = 5_000;
432
+
370
433
  export function killProxy(pid: number, mayTerminate?: () => boolean): void {
371
434
  if (!isProcessAlive(pid)) return;
372
435
  const authorize = () => {
@@ -381,7 +444,8 @@ export function killProxy(pid: number, mayTerminate?: () => boolean): void {
381
444
  const args = ["/PID", String(pid), "/T", "/F"];
382
445
  authorize();
383
446
  try {
384
- execFileSync(taskkill, args, { stdio: "pipe", windowsHide: true });
447
+ // Capped (#7771): the checked stop's budget counts the forced kill at 5 s.
448
+ execFileSync(taskkill, args, { stdio: "pipe", windowsHide: true, timeout: FORCED_TASKKILL_TIMEOUT_MS });
385
449
  } catch (err) {
386
450
  if (isProcessAlive(pid)) throw err;
387
451
  }