@bitkyc08/opencodex 2.100.1 → 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 (624) 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-BV4ms9U9.js +1 -0
  6. package/gui/dist/assets/{brand-mark-nr3ziR-T.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/index-DQtCRNAw.css +2 -0
  9. package/gui/dist/assets/{segment-thumb-features-DKCVUUTi.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-BedmOsE7.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-Dy5_wfTT.js +1 -0
  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 +6 -4
  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/native-exec.ts +3 -2
  38. package/src/adapters/cursor/protobuf-request.ts +8 -8
  39. package/src/adapters/cursor/tool-guidance.ts +3 -3
  40. package/src/adapters/cursor/tool-wording.ts +10 -1
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/tool-schema.ts +20 -2
  43. package/src/adapters/google-antigravity-wire.ts +15 -6
  44. package/src/adapters/google-truncation.ts +4 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +17 -4
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/openai-chat/tool-schema.ts +9 -0
  54. package/src/adapters/openai-responses/tool-schema.ts +18 -4
  55. package/src/adapters/run-turn-queue.ts +139 -5
  56. package/src/adapters/upstream-http-error.ts +4 -2
  57. package/src/adapters/zed.ts +3 -0
  58. package/src/advisor/consult.ts +15 -4
  59. package/src/advisor/context.ts +12 -3
  60. package/src/advisor/runtime.ts +35 -5
  61. package/src/advisor/settings.ts +8 -0
  62. package/src/advisor/synthetic-tool.ts +21 -8
  63. package/src/bridge/response-json.ts +11 -2
  64. package/src/bridge/sse.ts +51 -9
  65. package/src/claude/auth-detect.ts +21 -33
  66. package/src/claude/chat-tool-dispatch.ts +233 -0
  67. package/src/claude/desktop-3p.ts +11 -5
  68. package/src/claude/desktop-gateway-state.ts +2 -0
  69. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  70. package/src/claude/desktop-remote-store.ts +24 -4
  71. package/src/claude/inbound-content-options.ts +31 -16
  72. package/src/claude/inbound-tool-loading.ts +42 -17
  73. package/src/claude/outbound.ts +13 -3
  74. package/src/cli/account-api.ts +23 -1
  75. package/src/cli/account-auth.ts +54 -21
  76. package/src/cli/account-extended.ts +60 -6
  77. package/src/cli/account-key-quota.ts +56 -7
  78. package/src/cli/account.ts +5 -3
  79. package/src/cli/advisor.ts +7 -4
  80. package/src/cli/alias.ts +38 -1
  81. package/src/cli/capabilities-access-remote.ts +137 -2
  82. package/src/cli/capabilities-accounts.ts +3 -3
  83. package/src/cli/capabilities-agents-routing.ts +17 -10
  84. package/src/cli/capabilities-base.ts +43 -18
  85. package/src/cli/capabilities-integrations.ts +2 -2
  86. package/src/cli/capabilities-provider-models.ts +18 -2
  87. package/src/cli/capabilities-route-to.ts +43 -0
  88. package/src/cli/capabilities.ts +2 -0
  89. package/src/cli/capability-contracts.ts +1 -1
  90. package/src/cli/claude-desktop.ts +30 -11
  91. package/src/cli/claude.ts +36 -17
  92. package/src/cli/codex-launcher.ts +3 -1
  93. package/src/cli/codex-shim-autorestore.ts +5 -42
  94. package/src/cli/config-command.ts +38 -2
  95. package/src/cli/config-root-startup.ts +34 -0
  96. package/src/cli/connect.ts +124 -19
  97. package/src/cli/desktop-runtime-guidance.ts +1 -1
  98. package/src/cli/disconnect-runtime.ts +168 -0
  99. package/src/cli/dispatch.ts +54 -12
  100. package/src/cli/export-command.ts +1 -1
  101. package/src/cli/gui-pair-client.ts +29 -5
  102. package/src/cli/gui.ts +10 -5
  103. package/src/cli/help-catalog.ts +11 -0
  104. package/src/cli/help.ts +5 -4
  105. package/src/cli/hub.ts +18 -1
  106. package/src/cli/index.ts +83 -92
  107. package/src/cli/inspect.ts +11 -2
  108. package/src/cli/integrations.ts +26 -1
  109. package/src/cli/link-capture.ts +64 -0
  110. package/src/cli/link-child-ops.ts +314 -0
  111. package/src/cli/link-cleanup.ts +8 -5
  112. package/src/cli/link-diagnostics.ts +67 -0
  113. package/src/cli/link-enrollment.ts +158 -12
  114. package/src/cli/link-operations.ts +52 -0
  115. package/src/cli/link-recover.ts +152 -0
  116. package/src/cli/link-routes.ts +87 -0
  117. package/src/cli/link-status-child.ts +137 -0
  118. package/src/cli/link-status-traffic.ts +34 -0
  119. package/src/cli/link.ts +327 -37
  120. package/src/cli/message-command.ts +1 -1
  121. package/src/cli/message-mcp-command.ts +23 -10
  122. package/src/cli/models-runtime.ts +3 -3
  123. package/src/cli/opencode.ts +3 -1
  124. package/src/cli/pi-sync.ts +35 -0
  125. package/src/cli/preflight-exemptions.ts +46 -0
  126. package/src/cli/registry.ts +29 -12
  127. package/src/cli/restart-failure.ts +5 -2
  128. package/src/cli/root.ts +5 -1
  129. package/src/cli/route-to.ts +172 -0
  130. package/src/cli/runtime-api.ts +5 -8
  131. package/src/cli/status.ts +3 -1
  132. package/src/cli/stop-approval.ts +66 -19
  133. package/src/cli/stop-report.ts +23 -0
  134. package/src/cli/stop-windows-checked.ts +304 -0
  135. package/src/cli/sync-command.ts +70 -13
  136. package/src/cli/sync-fanout.ts +81 -99
  137. package/src/cli/sync-flags.ts +40 -3
  138. package/src/cli/sync-link-status.ts +18 -2
  139. package/src/cli/sync-update-guard.ts +7 -2
  140. package/src/cli/system-restart-client.ts +3 -2
  141. package/src/cli/uninstall-plan.ts +77 -5
  142. package/src/cli/uninstall-stop.ts +152 -0
  143. package/src/cli/v2-input.ts +10 -6
  144. package/src/cli/v2-local-output.ts +3 -2
  145. package/src/cli/v2-runtime.ts +10 -3
  146. package/src/cli/v2.ts +22 -7
  147. package/src/client/connect.ts +321 -34
  148. package/src/client/link-home-features.ts +27 -0
  149. package/src/client/link-home.ts +92 -4
  150. package/src/client/link-ingress.ts +21 -3
  151. package/src/client/link-join.ts +12 -2
  152. package/src/client/link-parity-reporter.ts +60 -6
  153. package/src/client/link-readiness.ts +16 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel-status.ts +76 -0
  161. package/src/client/link-tunnel.ts +56 -5
  162. package/src/client/link-websocket-limits.ts +89 -0
  163. package/src/client/link-websocket.ts +586 -0
  164. package/src/client/link-ws-advertisement.ts +100 -0
  165. package/src/client/link-ws-framer.ts +241 -0
  166. package/src/client/link-ws-transport.ts +177 -0
  167. package/src/client/machine-api.ts +13 -2
  168. package/src/client/machine-listener.ts +48 -7
  169. package/src/client/route-intent-apply.ts +293 -0
  170. package/src/client/route-intent-file-originals.ts +97 -0
  171. package/src/client/route-intent-native-originals.ts +201 -0
  172. package/src/client/route-intent-watch.ts +141 -0
  173. package/src/client/runtime-restart.ts +127 -5
  174. package/src/client/runtime.ts +61 -15
  175. package/src/client/state.ts +30 -0
  176. package/src/client/sync-expectation.ts +36 -2
  177. package/src/client/sync-runtime.ts +7 -0
  178. package/src/clients/config-export/alias-selectors.ts +63 -40
  179. package/src/clients/config-export/contracts.ts +2 -0
  180. package/src/clients/config-export/nested-selectors.ts +42 -0
  181. package/src/clients/config-export.ts +36 -4
  182. package/src/codex/account-resume-health.ts +41 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/login-flow.ts +6 -0
  187. package/src/codex/auth-api/routes.ts +35 -2
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +21 -6
  190. package/src/codex/catalog/gather-capture.ts +10 -2
  191. package/src/codex/catalog/parsing.ts +7 -3
  192. package/src/codex/catalog/provider-models.ts +67 -23
  193. package/src/codex/catalog/retained-sync.ts +2 -1
  194. package/src/codex/catalog/routed-gather.ts +1 -1
  195. package/src/codex/catalog-auto-refresh.ts +11 -0
  196. package/src/codex/cli-update-job.ts +35 -13
  197. package/src/codex/convergence-types.ts +2 -0
  198. package/src/codex/convergence.ts +2 -2
  199. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  200. package/src/codex/features.ts +2 -2
  201. package/src/codex/history-provider.ts +31 -0
  202. package/src/codex/inject/multi-agent-v2.ts +9 -3
  203. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  204. package/src/codex/inject/plan.ts +20 -2
  205. package/src/codex/inject.ts +2 -0
  206. package/src/codex/journal-config-restore.ts +217 -0
  207. package/src/codex/journal.ts +75 -6
  208. package/src/codex/main-account.ts +23 -30
  209. package/src/codex/native-main-auth-file.ts +104 -0
  210. package/src/codex/native-profile-manager.ts +4 -3
  211. package/src/codex/native-profile-store.ts +3 -61
  212. package/src/codex/orca-import.ts +10 -1
  213. package/src/codex/quota-history.ts +13 -0
  214. package/src/codex/quota-window-conflict.ts +103 -0
  215. package/src/codex/quota.ts +134 -7
  216. package/src/codex/subagent-model-fallback.ts +3 -1
  217. package/src/codex/websocket-activity.ts +171 -16
  218. package/src/codex/websocket-registry.ts +11 -4
  219. package/src/combos/cooldown-store.ts +228 -0
  220. package/src/combos/failover.ts +760 -35
  221. package/src/config/dashboard-trusted-proxy.ts +83 -0
  222. package/src/config/diagnostics.ts +28 -0
  223. package/src/config/feature-flags.ts +9 -0
  224. package/src/config/live-reconcile.ts +10 -1
  225. package/src/config/load-degrade.ts +12 -1
  226. package/src/config/multi-agent-surface.ts +28 -5
  227. package/src/config/pending-teardown.ts +60 -3
  228. package/src/config/process-state.ts +175 -4
  229. package/src/config/provider-validation.ts +4 -4
  230. package/src/config/salvage.ts +1 -0
  231. package/src/config/schema/config-schema.ts +12 -3
  232. package/src/config/schema/leaf-validators.ts +43 -14
  233. package/src/config/windows-process-command-line.ts +107 -0
  234. package/src/generated/compatibility-version.json +1077 -429
  235. package/src/generated/model-metadata.ts +1 -1
  236. package/src/images/loop.ts +3 -0
  237. package/src/integrations/model-name-guard.ts +25 -0
  238. package/src/integrations/route-intent-catalog.ts +26 -0
  239. package/src/integrations/route-intent-connected.ts +262 -0
  240. package/src/integrations/route-intent-contract.ts +55 -0
  241. package/src/integrations/route-intent-disconnect.ts +109 -0
  242. package/src/integrations/route-intent-initial.ts +64 -0
  243. package/src/integrations/route-intent-state.ts +117 -0
  244. package/src/integrations/route-intent-tick.ts +65 -0
  245. package/src/integrations/route-intent.ts +212 -0
  246. package/src/integrations/writer.ts +44 -11
  247. package/src/lib/catalog-etag.ts +10 -0
  248. package/src/lib/client-error-body.ts +15 -0
  249. package/src/lib/client-retry-after.ts +29 -0
  250. package/src/lib/config-ownership.ts +13 -0
  251. package/src/lib/context-overflow-verdict.ts +266 -9
  252. package/src/lib/desktop-gui-origin.ts +28 -0
  253. package/src/lib/errors.ts +1 -1
  254. package/src/lib/failure-detail.ts +72 -3
  255. package/src/lib/gui-pair-capability.ts +2 -1
  256. package/src/lib/hard-refusal.ts +259 -0
  257. package/src/lib/messages-error-body.ts +4 -1
  258. package/src/lib/outbound-credential-registry.ts +362 -4
  259. package/src/lib/paced-stream.ts +34 -0
  260. package/src/lib/passive-key-fetch-proof.ts +30 -0
  261. package/src/lib/passive-read.ts +5 -0
  262. package/src/lib/process-control.ts +76 -12
  263. package/src/lib/redact.ts +84 -8
  264. package/src/lib/state-store-registrations.ts +11 -0
  265. package/src/lib/state-store-sweeper.ts +4 -0
  266. package/src/lib/supervisor-markers.ts +18 -0
  267. package/src/lib/terminal-safe-text.ts +58 -0
  268. package/src/lib/translator-budget.ts +3 -2
  269. package/src/lib/upstream-retry.ts +14 -4
  270. package/src/link/alias-lock.ts +119 -0
  271. package/src/link/child-activity.ts +83 -0
  272. package/src/link/child-binary-cache-fill.d.mts +50 -0
  273. package/src/link/child-binary-cache-fill.mjs +494 -0
  274. package/src/link/child-binary-cache-start.ts +73 -0
  275. package/src/link/child-binary-source.ts +12 -5
  276. package/src/link/child-catalog-freshness.ts +149 -0
  277. package/src/link/child-gated-ocx.ts +135 -0
  278. package/src/link/child-observations.ts +206 -0
  279. package/src/link/child-observe.ts +121 -0
  280. package/src/link/child-ops-engine.ts +230 -0
  281. package/src/link/child-ops-host.ts +138 -0
  282. package/src/link/child-ops-runners.ts +319 -0
  283. package/src/link/child-ops-scheduler.ts +207 -0
  284. package/src/link/child-ops-types.ts +89 -0
  285. package/src/link/child-parity.ts +23 -4
  286. package/src/link/child-policy.ts +93 -0
  287. package/src/link/child-update-contract.ts +174 -0
  288. package/src/link/codex-settings.ts +1 -1
  289. package/src/link/compatibility.ts +18 -1
  290. package/src/link/diagnostics-read.ts +163 -0
  291. package/src/link/diagnostics.ts +20 -7
  292. package/src/link/explicit-route.ts +209 -0
  293. package/src/link/link-recover.ts +113 -0
  294. package/src/link/management-routes.ts +3 -1
  295. package/src/link/operation-recovery-slot.ts +44 -0
  296. package/src/link/operations-journal.ts +408 -0
  297. package/src/link/paths.ts +5 -0
  298. package/src/link/peer-report.ts +1 -1
  299. package/src/link/relay-auth.ts +14 -0
  300. package/src/link/remote-plant.ts +152 -14
  301. package/src/link/remote-platform.ts +21 -10
  302. package/src/link/remote-probe.ts +11 -3
  303. package/src/link/remote-windows.ts +88 -12
  304. package/src/link/request-compression.ts +30 -0
  305. package/src/link/residual-recovery.ts +54 -0
  306. package/src/link/retirement.ts +128 -0
  307. package/src/link/route-intent-watch.ts +41 -0
  308. package/src/link/route-intent.ts +209 -0
  309. package/src/link/route-proof.ts +82 -0
  310. package/src/link/route-rounds.ts +579 -0
  311. package/src/link/route-select.ts +95 -0
  312. package/src/link/route-trust.ts +96 -0
  313. package/src/link/ssh-argv.ts +285 -43
  314. package/src/link/ssh-capture-redact.ts +253 -0
  315. package/src/link/ssh-capture.ts +497 -0
  316. package/src/link/ssh-runner.ts +141 -14
  317. package/src/link/status-projection.ts +160 -0
  318. package/src/link/store.ts +54 -1
  319. package/src/link/supervisor.ts +543 -55
  320. package/src/link/sync-fanout-classify.ts +114 -0
  321. package/src/link/sync-then-restart.ts +65 -0
  322. package/src/link/tombstones.ts +209 -0
  323. package/src/link/traffic.ts +178 -0
  324. package/src/link/tunnel-state.ts +10 -4
  325. package/src/link/ws-activity-holds.ts +474 -0
  326. package/src/local-credentials/publication-fence.ts +20 -1
  327. package/src/messaging/mcp-queue-rpc.ts +3 -2
  328. package/src/messaging/mcp-queue-server.ts +21 -1
  329. package/src/messaging/mcp-reply-tools.ts +24 -9
  330. package/src/messaging/mcp-reply-wait.ts +70 -0
  331. package/src/messaging/mcp-resume-tools.ts +25 -0
  332. package/src/messaging/remote-enrollment.ts +3 -3
  333. package/src/messaging/remote-tunnels.ts +2 -2
  334. package/src/messaging/resume-permissions.ts +27 -0
  335. package/src/messaging/rpc.ts +46 -2
  336. package/src/oauth/account-resume-health.ts +60 -0
  337. package/src/oauth/anthropic-continuity.ts +23 -7
  338. package/src/oauth/anthropic-routing.ts +5 -2
  339. package/src/oauth/anthropic.ts +22 -2
  340. package/src/oauth/claude-keychain-read.ts +78 -68
  341. package/src/oauth/index.ts +25 -6
  342. package/src/oauth/local-token-detect.ts +8 -29
  343. package/src/oauth/login-cli-errors.ts +5 -1
  344. package/src/oauth/login-cli.ts +33 -18
  345. package/src/oauth/login-flow-state.ts +26 -3
  346. package/src/oauth/meta-muse.ts +1 -1
  347. package/src/oauth/store.ts +51 -1
  348. package/src/oauth/xai.ts +248 -14
  349. package/src/protocols/contract.ts +4 -0
  350. package/src/protocols/encoders/messages.ts +1 -0
  351. package/src/providers/alias-template.ts +48 -0
  352. package/src/providers/anthropic-billing-ownership.ts +2 -0
  353. package/src/providers/anthropic-output-caps.ts +46 -0
  354. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  355. package/src/providers/antigravity-effort-families.ts +11 -3
  356. package/src/providers/antigravity-models.ts +32 -9
  357. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  358. package/src/providers/api-key-pause-state.ts +23 -0
  359. package/src/providers/api-key-pause.ts +71 -10
  360. package/src/providers/api-key-resolve.ts +49 -7
  361. package/src/providers/api-key-response-ownership.ts +2 -0
  362. package/src/providers/api-key-selection-capture.ts +3 -1
  363. package/src/providers/api-key-selection.ts +54 -11
  364. package/src/providers/api-keys.ts +24 -7
  365. package/src/providers/cache-affinity-identity.ts +73 -0
  366. package/src/providers/cache-affinity.ts +256 -0
  367. package/src/providers/claude-cli-usage-state.ts +11 -6
  368. package/src/providers/claude-cli-usage.ts +27 -9
  369. package/src/providers/codex-capacity.ts +11 -2
  370. package/src/providers/default-aliases.ts +98 -20
  371. package/src/providers/google-vertex-model-discovery.ts +510 -0
  372. package/src/providers/key-failover.ts +136 -14
  373. package/src/providers/key-store.ts +3 -3
  374. package/src/providers/kiro-models.ts +3 -5
  375. package/src/providers/label.ts +31 -5
  376. package/src/providers/mistral-transport.ts +17 -4
  377. package/src/providers/model-discovery-config.ts +31 -0
  378. package/src/providers/model-discovery-diagnostic.ts +34 -3
  379. package/src/providers/model-discovery.ts +43 -7
  380. package/src/providers/model-rename-fields.ts +5 -0
  381. package/src/providers/muse-key-quota.ts +14 -6
  382. package/src/providers/new-model-policy-runtime.ts +17 -4
  383. package/src/providers/new-model-policy.ts +30 -4
  384. package/src/providers/openai-sidecar.ts +15 -2
  385. package/src/providers/passive-key-observation.ts +252 -0
  386. package/src/providers/provider-id-rewrite.ts +3 -0
  387. package/src/providers/quota/account-cache.ts +53 -34
  388. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  389. package/src/providers/quota/anthropic-usage-windows.ts +19 -9
  390. package/src/providers/quota/passive-key-limits.ts +272 -0
  391. package/src/providers/quota/passive-wire-model.ts +126 -0
  392. package/src/providers/quota/report-cache.ts +112 -5
  393. package/src/providers/quota/vendor-probes-key.ts +73 -0
  394. package/src/providers/quota/vendor-probes-oauth.ts +57 -3
  395. package/src/providers/quota-key-accounts.ts +22 -10
  396. package/src/providers/quota-mistral-budget.ts +18 -0
  397. package/src/providers/quota-types.ts +43 -0
  398. package/src/providers/quota.ts +31 -32
  399. package/src/providers/reasoning-metadata.ts +1051 -12
  400. package/src/providers/registry/entries-core.ts +34 -16
  401. package/src/providers/registry/entries-extended.ts +32 -0
  402. package/src/providers/registry/model-seeds.ts +35 -0
  403. package/src/providers/resolved-model-policy.ts +7 -0
  404. package/src/providers/routed-config.ts +8 -3
  405. package/src/providers/xai-transport.ts +3 -0
  406. package/src/quota/reset-observer.ts +4 -2
  407. package/src/quota/reset-seen-store.ts +9 -0
  408. package/src/quota/window-mapping.ts +1 -0
  409. package/src/quota-pool/assemble.ts +4 -1
  410. package/src/remote/features.ts +17 -0
  411. package/src/responses/anthropic-progress.ts +10 -4
  412. package/src/responses/citation-markers.ts +231 -0
  413. package/src/responses/hosted-tool-policy.ts +56 -12
  414. package/src/responses/spill-store.ts +5 -1
  415. package/src/responses/state/replay-input.ts +50 -0
  416. package/src/responses/state/replay-owner.ts +24 -0
  417. package/src/responses/state/snapshot-codec.ts +9 -0
  418. package/src/responses/state/spill-queue.ts +1 -0
  419. package/src/responses/state.ts +42 -60
  420. package/src/router.ts +4 -2
  421. package/src/routing/home-route-capture.ts +123 -0
  422. package/src/routing/home-route-intent.ts +200 -0
  423. package/src/routing/route-intent-state.ts +178 -0
  424. package/src/routing/route-to-live-settings.ts +35 -0
  425. package/src/routing/route-to-local.ts +145 -0
  426. package/src/routing/route-to-status.ts +94 -0
  427. package/src/routing/route-to-sync-child.ts +32 -0
  428. package/src/server/adapter-resolve.ts +21 -1
  429. package/src/server/admitted-http-turn.ts +3 -0
  430. package/src/server/auth-cors.ts +109 -8
  431. package/src/server/bare-upstream-error.ts +220 -0
  432. package/src/server/catalog-download.ts +3 -5
  433. package/src/server/chat-native.ts +25 -7
  434. package/src/server/claude-messages.ts +8 -5
  435. package/src/server/codex-model-list.ts +2 -1
  436. package/src/server/configured-credentials.ts +37 -5
  437. package/src/server/gui-desktop-authorization.ts +36 -0
  438. package/src/server/gui-pair-delivery.ts +6 -3
  439. package/src/server/gui-session.ts +10 -1
  440. package/src/server/images.ts +41 -13
  441. package/src/server/inbound-body-admission.ts +17 -4
  442. package/src/server/index/link-listener.ts +203 -11
  443. package/src/server/index/link-management.ts +15 -1
  444. package/src/server/index/link-relay-sessions.ts +128 -8
  445. package/src/server/index/link-websocket-limits.ts +136 -0
  446. package/src/server/index/link-websocket.ts +692 -0
  447. package/src/server/index/optional-listeners.ts +115 -7
  448. package/src/server/index/route-intent-watch.ts +47 -0
  449. package/src/server/index/serve-contract.ts +86 -0
  450. package/src/server/index/serve-options.ts +35 -86
  451. package/src/server/index/startup-warnings.ts +8 -2
  452. package/src/server/index/websocket-handler.ts +26 -4
  453. package/src/server/index.ts +12 -2
  454. package/src/server/inference/client-encoder-delivery.ts +2 -0
  455. package/src/server/inspection-tee.ts +39 -2
  456. package/src/server/lifecycle.ts +2 -0
  457. package/src/server/link-turn.ts +137 -0
  458. package/src/server/management/advisor-routes.ts +10 -2
  459. package/src/server/management/agent-settings-routes.ts +50 -16
  460. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  461. package/src/server/management/config-routes.ts +7 -1
  462. package/src/server/management/context.ts +9 -2
  463. package/src/server/management/desktop-authorization.ts +41 -0
  464. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  465. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  466. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  467. package/src/server/management/home-integration-decision.ts +89 -0
  468. package/src/server/management/integration-routes.ts +208 -81
  469. package/src/server/management/link-child-ops-routes.ts +218 -0
  470. package/src/server/management/link-child-preflight.ts +31 -0
  471. package/src/server/management/link-diagnostics-route.ts +29 -0
  472. package/src/server/management/link-enrollment.ts +199 -47
  473. package/src/server/management/link-operation.ts +609 -0
  474. package/src/server/management/link-recover-route.ts +103 -0
  475. package/src/server/management/link-route-edit.ts +173 -0
  476. package/src/server/management/link-route-request.ts +62 -0
  477. package/src/server/management/link-route-state.ts +92 -6
  478. package/src/server/management/link-routes.ts +563 -51
  479. package/src/server/management/link-traffic-status.ts +13 -0
  480. package/src/server/management/model-routes.ts +122 -36
  481. package/src/server/management/model-rows.ts +2 -1
  482. package/src/server/management/native-integration-routes.ts +176 -70
  483. package/src/server/management/oauth-account-routes.ts +69 -17
  484. package/src/server/management/protocol-routes.ts +7 -0
  485. package/src/server/management/provider-completion-test.ts +4 -4
  486. package/src/server/management/provider-overwrite-carry.ts +39 -3
  487. package/src/server/management/provider-routes.ts +80 -72
  488. package/src/server/management/provider-routing-quota.ts +45 -0
  489. package/src/server/management/route-registry.ts +25 -3
  490. package/src/server/management/route-to-routes.ts +257 -0
  491. package/src/server/management/system-restart.ts +4 -2
  492. package/src/server/management/usage-aggregate-cache.ts +101 -66
  493. package/src/server/management-api.ts +17 -3
  494. package/src/server/management-auth.ts +13 -1
  495. package/src/server/messages-native-preflight.ts +27 -4
  496. package/src/server/messages-native.ts +22 -5
  497. package/src/server/persistent-gui-session.ts +6 -3
  498. package/src/server/proxy-liveness.ts +33 -6
  499. package/src/server/relay-eager.ts +36 -12
  500. package/src/server/relay.ts +183 -116
  501. package/src/server/request-body-facts.ts +48 -0
  502. package/src/server/request-decompress.ts +65 -2
  503. package/src/server/request-log-account-rotation.ts +6 -0
  504. package/src/server/request-log-attempt-usage.ts +69 -0
  505. package/src/server/request-log-cache-affinity.ts +60 -0
  506. package/src/server/request-log-conversation.ts +45 -2
  507. package/src/server/request-log-failure-detail.ts +59 -1
  508. package/src/server/request-log-terminal-status.ts +210 -24
  509. package/src/server/request-log.ts +71 -79
  510. package/src/server/responses/adapter-continuation.ts +2 -1
  511. package/src/server/responses/adapter-delivery.ts +2 -0
  512. package/src/server/responses/adapter-dispatch.ts +40 -51
  513. package/src/server/responses/advisor-plan-slot.ts +33 -1
  514. package/src/server/responses/advisor-question.ts +21 -0
  515. package/src/server/responses/advisor-slot.ts +10 -3
  516. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  517. package/src/server/responses/buffered-sse-json.ts +9 -3
  518. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  519. package/src/server/responses/codex-tool-catalog.ts +156 -0
  520. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  521. package/src/server/responses/combo-stream-preflight.ts +701 -81
  522. package/src/server/responses/compact.ts +47 -12
  523. package/src/server/responses/context-overflow.ts +58 -2
  524. package/src/server/responses/core-codex-account.ts +17 -3
  525. package/src/server/responses/core-combo-failure.ts +37 -4
  526. package/src/server/responses/core-combo-native.ts +3 -1
  527. package/src/server/responses/core-combo.ts +62 -7
  528. package/src/server/responses/core-errors.ts +8 -3
  529. package/src/server/responses/core-lifetime.ts +3 -2
  530. package/src/server/responses/core-normalize.ts +3 -1
  531. package/src/server/responses/core-opaque-recovery.ts +45 -2
  532. package/src/server/responses/core-options.ts +18 -0
  533. package/src/server/responses/core.ts +2 -0
  534. package/src/server/responses/fetch-helpers.ts +15 -10
  535. package/src/server/responses/native-replay-guard.ts +57 -0
  536. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  537. package/src/server/responses/outbound-request-body.ts +29 -0
  538. package/src/server/responses/passthrough-completion.ts +105 -8
  539. package/src/server/responses/passthrough-delivery.ts +31 -11
  540. package/src/server/responses/passthrough-dispatch.ts +99 -106
  541. package/src/server/responses/policy-fallback.ts +13 -1
  542. package/src/server/responses/request-prepare.ts +50 -6
  543. package/src/server/responses/request-transport.ts +53 -17
  544. package/src/server/responses/reset-replay.ts +104 -4
  545. package/src/server/responses/run-turn-execution.ts +58 -30
  546. package/src/server/responses/sidecar-execution.ts +14 -0
  547. package/src/server/responses/terminal-error-redaction.ts +222 -25
  548. package/src/server/responses/ws-upstream.ts +2 -2
  549. package/src/server/sse-payload-rewrite.ts +3 -2
  550. package/src/server/stop-service-route.ts +85 -0
  551. package/src/server/system-env-shell.ts +12 -1
  552. package/src/server/system-env.ts +5 -3
  553. package/src/server/windows-tcp-drop.ts +21 -4
  554. package/src/server/workflow-refusal.ts +8 -0
  555. package/src/server/ws-bridge.ts +191 -12
  556. package/src/service/cli-windows-stop.ts +189 -0
  557. package/src/service/cli.ts +41 -12
  558. package/src/service/disconnected-client-restart.ts +60 -0
  559. package/src/service/guarded-manager-target.ts +18 -1
  560. package/src/service/health.ts +99 -6
  561. package/src/service/launchd.ts +84 -31
  562. package/src/service/orchestration.ts +418 -91
  563. package/src/service/repair.ts +223 -6
  564. package/src/service/restart-proxy-stop.ts +79 -0
  565. package/src/service/service-child-ownership.ts +6 -2
  566. package/src/service/windows-checked-stop-live.ts +467 -0
  567. package/src/service/windows-checked-stop.ts +435 -0
  568. package/src/service/windows-command-line-token.ts +23 -0
  569. package/src/service/windows-guarded-manager.ts +77 -34
  570. package/src/service/windows-ops.ts +38 -56
  571. package/src/service/windows-process-evidence.ts +292 -0
  572. package/src/service/windows-process-native.ts +262 -0
  573. package/src/service/windows-service-stop.ts +321 -0
  574. package/src/service/windows-stop-binding.ts +187 -0
  575. package/src/service/windows-stop-budget.ts +123 -0
  576. package/src/service/windows-stop-confirm.ts +158 -0
  577. package/src/service/windows-stop-deadline.ts +56 -0
  578. package/src/service.ts +2 -2
  579. package/src/types/claude-tool-loading.ts +48 -0
  580. package/src/types/config.ts +47 -53
  581. package/src/types/link.ts +20 -0
  582. package/src/types/multi-agent.ts +13 -0
  583. package/src/types/provider.ts +68 -2
  584. package/src/types/request.ts +4 -0
  585. package/src/types.ts +4 -0
  586. package/src/update/guarded-runtime-ops.ts +5 -7
  587. package/src/update/index.ts +25 -10
  588. package/src/update/install-detection.mjs +3 -1
  589. package/src/update/job-pinned-start.ts +2 -0
  590. package/src/update/job-windows-restart.ts +19 -32
  591. package/src/update/job.ts +12 -5
  592. package/src/update/npm-install.d.mts +11 -0
  593. package/src/update/npm-install.mjs +44 -7
  594. package/src/update/orchestrated-entry.ts +1 -1
  595. package/src/update/orchestrated-node-driver.mjs +3 -2
  596. package/src/update/orchestrated-pnpm.d.mts +4 -0
  597. package/src/update/orchestrated-pnpm.mjs +50 -6
  598. package/src/update/orchestrated-session.d.mts +3 -1
  599. package/src/update/orchestrated-session.mjs +21 -6
  600. package/src/update/pnpm-global-install.d.mts +21 -3
  601. package/src/update/pnpm-global-install.mjs +322 -19
  602. package/src/update/pnpm-store-layout.mjs +46 -0
  603. package/src/update/sync-update-mutex.d.mts +3 -2
  604. package/src/update/sync-update-mutex.mjs +57 -8
  605. package/src/update/transactional-install.d.mts +3 -1
  606. package/src/update/transactional-install.mjs +545 -12
  607. package/src/update/windows-installer-marker.d.mts +1 -0
  608. package/src/update/windows-installer-marker.mjs +44 -0
  609. package/src/usage/expected-prices.ts +8 -0
  610. package/src/usage/filter-index.ts +326 -77
  611. package/src/usage/ledger-scanner.ts +15 -0
  612. package/src/usage/link-log-fields.ts +48 -0
  613. package/src/usage/log.ts +43 -2
  614. package/src/usage/request-body.ts +37 -0
  615. package/src/web-search/loop.ts +3 -0
  616. package/src/web-search/parse.ts +21 -2
  617. package/gui/dist/assets/App-g3Cm2xhZ.js +0 -59
  618. package/gui/dist/assets/Tray-BMDkAiXy.js +0 -1
  619. package/gui/dist/assets/index-Bziu8gTy.css +0 -2
  620. package/gui/dist/assets/index-OYzhQUNP.js +0 -94
  621. package/gui/dist/classic/assets/App-CgPBKUP-.js +0 -58
  622. package/gui/dist/classic/assets/index-BR-HhNrp.js +0 -94
  623. package/gui/dist/classic/assets/quota-summary-CXKhvSmQ.js +0 -1
  624. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,321 @@
1
+ /**
2
+ * Caller side of the checked Windows service stop (#7771, 030 "Where it sits").
3
+ *
4
+ * Every Windows stop path reaches Part A and Part B through this module: ocx stop with and
5
+ * without a consent snapshot, ocx uninstall, /api/stop, ocx service stop / uninstall /
6
+ * remove, prepareServiceInstall and the updater. It owns:
7
+ *
8
+ * - the stop deadline (030 "Time budget"): --deadline-ms or OCX_STOP_DEADLINE_MS for
9
+ * ocx stop, measured from the command's start (performance.now() counts from
10
+ * performance.timeOrigin, the process start, so the deadline is an absolute value on the
11
+ * Part A clock); every other caller starts the default 60 s when its stop phase begins,
12
+ * because registration and the UAC prompt can come first;
13
+ * - the admission inputs and the mapping of Part A onto ServiceStopOutcome;
14
+ * - the Part A record a teardown receipt carries, so /api/stop can skip a second Part A;
15
+ * - a hook seam so caller tests run hermetically (no schtasks, PowerShell or FFI).
16
+ */
17
+ import { loadConfig } from "../config";
18
+ import { endpointsToProve, type ProbeEndpoint } from "../cli/uninstall-plan";
19
+ import { probeEndpointLiveness, type EndpointLiveness } from "../server/proxy-liveness";
20
+ import type { PendingTeardownPartA } from "../config/pending-teardown";
21
+ import { readRuntimePort } from "../config/process-state";
22
+ import type { WinswStatus } from "../lib/winsw";
23
+ import type { ServiceStopOutcome } from "./orchestration";
24
+ import { guardedStopWindowsServiceChecked, stopWindowsServiceChecked, windowsStopClock, type WindowsCheckedStopDeps, type WindowsCheckedStopOptions, type WindowsCheckedStopResult, type WindowsStopAdmission, type WindowsStopReason } from "./windows-checked-stop";
25
+ import { stopperUnderHomeWrapper, windowsCheckedStopLiveDeps, windowsStopConfirmLiveDeps, type WindowsCheckedStopLiveOptions } from "./windows-checked-stop-live";
26
+ import { windowsListenPort } from "./windows-ops";
27
+ import type { WindowsStopProcessEntry } from "./windows-process-evidence";
28
+ import { confirmWindowsStopFreed, resolveWindowsStopPort, type WindowsStopConfirmResult } from "./windows-stop-confirm";
29
+ import { windowsStopDeadlineAt } from "./windows-stop-deadline";
30
+
31
+ export { parseStopDeadlineMs, resolveStopDeadlineMs, setStopDeadlineMs, STOP_DEADLINE_ENV, windowsStopDeadlineAt } from "./windows-stop-deadline";
32
+
33
+ /** Time left on the stop deadline, measured on the Part A clock (one clock read). */
34
+ export function windowsStopRemainingMs(now: () => number = windowsStopClock.now): number {
35
+ const at = now();
36
+ return windowsStopDeadlineAt(at) - at;
37
+ }
38
+
39
+ export function configuredShutdownTimeoutMs(): number | undefined {
40
+ try {
41
+ const value = loadConfig().shutdownTimeoutMs;
42
+ return typeof value === "number" && value > 0 ? value : undefined;
43
+ } catch {
44
+ return undefined;
45
+ }
46
+ }
47
+
48
+ export function windowsStopAdmission(input: {
49
+ orphanDiscovery: boolean;
50
+ inheritedReceipts?: number;
51
+ partB?: boolean;
52
+ }): WindowsStopAdmission {
53
+ return {
54
+ deadlineAt: windowsStopDeadlineAt(),
55
+ budget: {
56
+ orphanDiscovery: input.orphanDiscovery,
57
+ inheritedReceipts: input.inheritedReceipts ?? 0,
58
+ shutdownTimeoutMs: configuredShutdownTimeoutMs(),
59
+ partB: input.partB ?? true,
60
+ },
61
+ };
62
+ }
63
+
64
+ export interface WindowsPartARequest {
65
+ admission?: WindowsStopAdmission;
66
+ /** The evidence snapshot (windowsProcessSnapshot) a guarded revalidation already read. */
67
+ bindSnapshot?: readonly WindowsStopProcessEntry[];
68
+ /** The updater's authorizer: throws to refuse, at entry, before each manager stop and before each terminate. */
69
+ authorize?: () => void | Promise<void>;
70
+ /**
71
+ * A hard cap (the route: 6 s with a receipt, 4 s for a stray sweep). An overrun answers
72
+ * unknown, and nothing further is changed: the manager commands and every terminate are
73
+ * gated off once the cap has passed.
74
+ */
75
+ capMs?: number;
76
+ /**
77
+ * The stopping process may descend from this home's wrapper. Only the /api/stop route
78
+ * (it IS the wrapped proxy) and the updater (its worker descends from the service-run
79
+ * proxy) pass true; every interactive caller refuses such a stop with nothing changed.
80
+ */
81
+ allowUnderOwnWrapper?: boolean;
82
+ }
83
+
84
+ export interface WindowsPartBRequest {
85
+ port: number;
86
+ remainingMs: number;
87
+ /** The final enumeration; the guarded path wraps it to share the table it read. */
88
+ snapshot?: (timeoutMs: number) => Promise<readonly WindowsStopProcessEntry[] | null>;
89
+ }
90
+
91
+ export interface WindowsServiceStopHooks {
92
+ partA?: (request: WindowsPartARequest) => Promise<WindowsCheckedStopResult>;
93
+ /** Run the real Part A against these deps instead of the live ones. */
94
+ liveDeps?: (options: WindowsCheckedStopLiveOptions) => WindowsCheckedStopDeps;
95
+ partB?: (request: WindowsPartBRequest) => Promise<WindowsStopConfirmResult>;
96
+ /** The evidence snapshot the guarded inspection and the bind share. */
97
+ snapshot?: () => Promise<readonly WindowsStopProcessEntry[] | null>;
98
+ schedulePid?: () => Promise<number | null>;
99
+ /** The route's registration re-check against a receipt's Part A record. */
100
+ registration?: () => Promise<{ scheduler: "present" | "absent" | "unknown"; winsw: WinswStatus }>;
101
+ }
102
+
103
+ let hooks: WindowsServiceStopHooks | null = null;
104
+
105
+ /** Test-only: replace Part A / Part B / the evidence reads with hermetic fakes. */
106
+ export function setWindowsServiceStopHooksForTests(next: WindowsServiceStopHooks | null): void {
107
+ hooks = next;
108
+ }
109
+
110
+ export function windowsServiceStopHooks(): WindowsServiceStopHooks | null {
111
+ return hooks;
112
+ }
113
+
114
+ function unknownResult(detail: string): WindowsCheckedStopResult {
115
+ return {
116
+ outcome: "unknown", reason: "evidence-unreadable", detail,
117
+ registration: { scheduler: "unknown", winsw: "unknown" },
118
+ bound: [], unbound: [], terminated: [], changed: false,
119
+ };
120
+ }
121
+
122
+ export const UNDER_OWN_WRAPPER_DETAIL = "this stop runs under this home's service wrapper; run it from a separate terminal";
123
+
124
+ /** Part A with the live dependencies (or the test hook), optionally capped. */
125
+ export async function runWindowsServiceStopPartA(request: WindowsPartARequest = {}): Promise<WindowsCheckedStopResult> {
126
+ let expired = false;
127
+ let underOwnWrapper = false;
128
+ const options: WindowsCheckedStopOptions = {
129
+ ...(request.admission ? { admission: request.admission } : {}),
130
+ ...(request.bindSnapshot ? { bindSnapshot: request.bindSnapshot } : {}),
131
+ };
132
+ const run = async (): Promise<WindowsCheckedStopResult> => {
133
+ if (hooks?.partA) return hooks.partA(request);
134
+ const live: WindowsCheckedStopLiveOptions = { gate: () => !expired };
135
+ const base = (hooks?.liveDeps ?? windowsCheckedStopLiveDeps)(live);
136
+ const selfPid = base.selfPid ?? process.pid;
137
+ const guard = (table: readonly WindowsStopProcessEntry[] | null): boolean =>
138
+ !request.allowUnderOwnWrapper && table !== null && stopperUnderHomeWrapper(table, base.canonicalPaths, selfPid);
139
+ // The guarded path binds on a snapshot it already read: check it before anything runs.
140
+ if (request.bindSnapshot && guard(request.bindSnapshot)) return unknownResult(UNDER_OWN_WRAPPER_DETAIL);
141
+ // Otherwise the bind enumeration is checked as it arrives; a hit reads as an unreadable
142
+ // table, which Part A answers before /end when a manager is registered.
143
+ const deps = {
144
+ ...base,
145
+ enumerate: async (timeoutMs: number) => {
146
+ const table = await base.enumerate(timeoutMs);
147
+ if (!guard(table)) return table;
148
+ underOwnWrapper = true;
149
+ return null;
150
+ },
151
+ };
152
+ const authorize = async (): Promise<void> => {
153
+ if (expired) throw new Error("the checked stop's cap has passed");
154
+ await request.authorize?.();
155
+ };
156
+ const result = await (request.authorize || request.capMs !== undefined
157
+ ? guardedStopWindowsServiceChecked(authorize, deps, options)
158
+ : stopWindowsServiceChecked(deps, options));
159
+ // The refusal is the answer whatever the stray path would have concluded: with nothing
160
+ // registered an unreadable enumeration reads as absent ("nothing to end"), which would
161
+ // let the caller stop the child and restore shared config beneath this home's own looping
162
+ // wrapper. Nothing has been changed at this point in either path, so it is unknown.
163
+ if (underOwnWrapper) {
164
+ result.outcome = "unknown";
165
+ result.reason = "evidence-unreadable";
166
+ result.detail = UNDER_OWN_WRAPPER_DETAIL;
167
+ result.changed = false;
168
+ }
169
+ return result;
170
+ };
171
+ if (request.capMs === undefined) return run();
172
+ const work = run().catch(error => {
173
+ if (error && typeof error === "object" && "partial" in error) return (error as { partial: WindowsCheckedStopResult }).partial;
174
+ throw error;
175
+ });
176
+ let timer: ReturnType<typeof setTimeout> | undefined;
177
+ const cap = new Promise<null>(resolve => { timer = setTimeout(() => resolve(null), request.capMs); });
178
+ try {
179
+ const result = await Promise.race([work, cap]);
180
+ if (result === null) {
181
+ expired = true;
182
+ work.catch(() => undefined);
183
+ return unknownResult("the checked stop did not finish within its cap");
184
+ }
185
+ return result;
186
+ } finally {
187
+ if (timer) clearTimeout(timer);
188
+ }
189
+ }
190
+
191
+ /** Part A onto the existing ServiceStopOutcome (030 "Outcomes"). */
192
+ export function serviceStopOutcomeFromWindows(result: WindowsCheckedStopResult): ServiceStopOutcome {
193
+ switch (result.outcome) {
194
+ case "absent": return "absent";
195
+ case "stopped": return "stopped";
196
+ case "unknown": return "state-unknown";
197
+ default: return "failed";
198
+ }
199
+ }
200
+
201
+ /** The additive ocx-stop/1 serviceStopReason for a Part A result, if it has one. */
202
+ export function windowsStopReason(result: WindowsCheckedStopResult | null | undefined): WindowsStopReason | undefined {
203
+ if (!result || result.outcome === "stopped" || result.outcome === "absent") return undefined;
204
+ return result.reason ?? undefined;
205
+ }
206
+
207
+ /** One operator-facing line for a Part A result that was not stopped/absent. */
208
+ export function describeWindowsPartA(result: WindowsCheckedStopResult): string {
209
+ switch (result.reason) {
210
+ case "access-denied":
211
+ return "The Windows service stop was denied for this account; run the stop from an elevated terminal.";
212
+ case "unbound-wrapper":
213
+ return "A service wrapper of this home is running but could not be tied to the service; end the wscript.exe/cmd.exe running the opencodex service script, then retry.";
214
+ case "unverified-budget":
215
+ return "The remaining time cannot hold a verified Windows service stop, so nothing was changed; retry from a terminal.";
216
+ case "evidence-unreadable":
217
+ return "The Windows service or process state could not be read (" + result.detail + "); nothing that could not be verified was stopped.";
218
+ default:
219
+ return "The Windows service manager or its wrapper is still running (" + result.detail + ").";
220
+ }
221
+ }
222
+
223
+ /** What a teardown receipt records after Part A (030 "/api/stop"). */
224
+ export function windowsPartARecord(result: WindowsCheckedStopResult): PendingTeardownPartA | null {
225
+ if (result.outcome !== "stopped" && result.outcome !== "absent") return null;
226
+ return {
227
+ partA: result.outcome,
228
+ manager: {
229
+ scheduler: result.registration.scheduler === "present",
230
+ winsw: result.registration.winsw !== "nonexistent" && result.registration.winsw !== "unknown",
231
+ },
232
+ wrappers: result.bound.map(wrapper => ({ pid: wrapper.pid, startTime: wrapper.startTime })),
233
+ };
234
+ }
235
+
236
+ /**
237
+ * Every endpoint this home could be serving on, exactly the set `ocx uninstall` proves.
238
+ *
239
+ * The receipt endpoint is ONE candidate; a stale runtime record naming a closed port must
240
+ * not stand in for the configured port where a live listener can sit (#3008, #7771).
241
+ */
242
+ export function windowsRemovalEndpoints(): ProbeEndpoint[] {
243
+ let config: { port?: number; hostname?: string } = {};
244
+ try { config = loadConfig(); } catch { /* defaults below */ }
245
+ return endpointsToProve(readRuntimePort(), config);
246
+ }
247
+
248
+ /**
249
+ * Definitive absence on EVERY candidate. "unknown" is not absence: a listener that
250
+ * accepts connections but withholds /healthz, or one that times out, is exactly the state
251
+ * where deleting a registration or installing over it is most harmful.
252
+ */
253
+ export async function endpointsAllDead(
254
+ endpoints: readonly ProbeEndpoint[],
255
+ probe: (endpoint: ProbeEndpoint) => Promise<EndpointLiveness> = probeEndpointLiveness,
256
+ ): Promise<{ dead: boolean; live: number[]; unknown: number[] }> {
257
+ const results = await Promise.all(endpoints.map(async endpoint => (
258
+ await probe(endpoint).catch((): EndpointLiveness => "unknown")
259
+ )));
260
+ const live: number[] = [];
261
+ const unknown: number[] = [];
262
+ endpoints.forEach((endpoint, index) => {
263
+ const answer = results[index];
264
+ if (answer === "live") live.push(endpoint.port);
265
+ else if (answer !== "dead") unknown.push(endpoint.port);
266
+ });
267
+ // No candidate is not proof of anything.
268
+ return { dead: endpoints.length > 0 && live.length === 0 && unknown.length === 0, live, unknown };
269
+ }
270
+
271
+ /**
272
+ * The endpoint a teardown receipt should name: the runtime record when it has one, the
273
+ * configured address otherwise. `exact` is the only source a stop may defer against.
274
+ */
275
+ export function windowsReceiptEndpoint(): { endpoint: { hostname: string; port: number }; source: "exact" | "guessed" } {
276
+ const runtime = readRuntimePort();
277
+ if (runtime?.port) return { endpoint: { hostname: runtime.hostname ?? "127.0.0.1", port: runtime.port }, source: "exact" };
278
+ try {
279
+ const config = loadConfig();
280
+ return { endpoint: { hostname: config.hostname ?? "127.0.0.1", port: typeof config.port === "number" && config.port > 0 ? config.port : 10100 }, source: "guessed" };
281
+ } catch {
282
+ return { endpoint: { hostname: "127.0.0.1", port: 10100 }, source: "guessed" };
283
+ }
284
+ }
285
+
286
+ /** The port Part B watches: runtime record, then the wrapper's baked port, then the config. */
287
+ export function windowsServiceStopPort(): number {
288
+ return resolveWindowsStopPort({
289
+ runtimePort: () => readRuntimePort()?.port ?? null,
290
+ wrapperPort: () => windowsListenPort(),
291
+ configuredPort: () => {
292
+ try {
293
+ const port = loadConfig().port;
294
+ return typeof port === "number" && port > 0 ? port : 10100;
295
+ } catch {
296
+ return 10100;
297
+ }
298
+ },
299
+ }).port;
300
+ }
301
+
302
+ /** Part B with the live dependencies (or the test hook). */
303
+ export async function confirmWindowsServiceStop(request: WindowsPartBRequest): Promise<WindowsStopConfirmResult> {
304
+ if (hooks?.partB) return hooks.partB(request);
305
+ return confirmWindowsStopFreed(windowsStopConfirmLiveDeps(request.port, request.remainingMs,
306
+ request.snapshot ? { snapshot: request.snapshot } : {}));
307
+ }
308
+
309
+ /** One operator-facing line for a Part B result other than freed. */
310
+ export function describeWindowsPartB(result: WindowsStopConfirmResult): string {
311
+ if (result.outcome === "port-held-by-foreign") {
312
+ const owner = result.listener?.ownerPid ? " (PID " + result.listener.ownerPid + ")" : "";
313
+ return "Another program" + owner + " holds port " + result.port + " after the stop.";
314
+ }
315
+ if (result.outcome === "survived") {
316
+ return result.lateWrappers.length > 0
317
+ ? "A service wrapper of this home started again after the stop; it can relaunch the proxy."
318
+ : "The proxy answers on port " + result.port + " again after the stop; it is being respawned.";
319
+ }
320
+ return "Port " + result.port + " could not be confirmed free after the stop (" + result.detail + ").";
321
+ }
@@ -0,0 +1,187 @@
1
+ /**
2
+ * Which processes the checked Windows stop may terminate (#7771, 030 "Binding rule").
3
+ *
4
+ * A process is bound, and only a bound process is ever terminated, when ALL hold:
5
+ *
6
+ * 1. its image is wscript.exe, cscript.exe or cmd.exe. The proxy child is observed for
7
+ * lineage only and is never a target;
8
+ * 2. its command line carries this home's canonical launcher VBS or service script path
9
+ * as a complete token (commandLineHasPathToken);
10
+ * 3. lineage: it is an ancestor of the identity-checked child, or a descendant of a bound
11
+ * wrapper (which covers "its parent is a bound wrapper"), or its parent is the Task
12
+ * Scheduler service host proven by the SCM PID, or, only while this home's task is
13
+ * registered, its parent is gone. A parent PID that is not in the table, or whose
14
+ * creation time is later than the wrapper's (a reused PID), counts as gone;
15
+ * 4. a creation time was read for it.
16
+ *
17
+ * A wrapper that passes 1-2 but fails lineage (a launcher started by hand from a live
18
+ * shell, an orphan while no task is registered) is reported as unbound and never touched.
19
+ * A candidate whose evidence cannot be read is reported as unreadable, never skipped and
20
+ * never killed: a matching wrapper without a creation time or image name, a matching
21
+ * wrapper whose parent PID is unreadable while the task is registered, and a wrapper-image
22
+ * process with no readable command line that descends from a bound wrapper or, while a
23
+ * manager is registered, is an ancestor of the child.
24
+ *
25
+ * Pure: the caller supplies the snapshot and every fact; nothing here reads the machine.
26
+ */
27
+ import { createHash } from "node:crypto";
28
+
29
+ import { commandLineHasPathToken } from "./windows-command-line-token";
30
+ import type { WindowsStopProcessEntry } from "./windows-process-evidence";
31
+
32
+ const WRAPPER_IMAGES = new Set(["wscript.exe", "cscript.exe", "cmd.exe"]);
33
+ const DEPTH_LIMIT = 32;
34
+
35
+ export interface WindowsStopBindingContext {
36
+ processes: readonly WindowsStopProcessEntry[];
37
+ /** This home's canonical launcher VBS and service script paths. */
38
+ canonicalPaths: readonly string[];
39
+ /** The identity-checked proxy child (readPid), when there is one. */
40
+ childPid: number | null;
41
+ /** This home's OpenCodex Task Scheduler task is registered (enables "parent gone"). */
42
+ taskRegistered: boolean;
43
+ /** Any manager (task or WinSW) is registered: unreadable ancestors of the child count. */
44
+ managerRegistered: boolean;
45
+ /** PID of the Task Scheduler service host from the SCM; null disables that clause. */
46
+ scheduleServicePid: number | null;
47
+ /** The stopping process itself, never a candidate. */
48
+ selfPid?: number;
49
+ }
50
+
51
+ /** What a later receipt records about one bound wrapper. The command line is only digested. */
52
+ export interface WindowsBoundWrapper {
53
+ pid: number;
54
+ startTime: number;
55
+ image: string;
56
+ parentPid: number | null;
57
+ commandLineDigest: string;
58
+ }
59
+
60
+ export interface WindowsStopBinding {
61
+ /** Terminate order: the deepest bound wrapper first (the looping cmd.exe before its launcher). */
62
+ bound: WindowsBoundWrapper[];
63
+ /** Match image and path but fail lineage. Never terminated; alive at the end = unbound-wrapper. */
64
+ unbound: { pid: number; startTime: number | null }[];
65
+ /** Candidates whose evidence cannot be read; any entry makes the stop unknown. */
66
+ unreadable: number[];
67
+ /** The child as observed in the snapshot, for lineage and a WinSW survival check. */
68
+ child: { pid: number; startTime: number | null } | null;
69
+ }
70
+
71
+ /** The lowercased image name when it is one of the three wrapper images, else null. */
72
+ export function windowsWrapperImage(name: string | null | undefined): string | null {
73
+ if (!name) return null;
74
+ const base = name.trim().toLowerCase().split(/[\\/]/).pop() ?? "";
75
+ return WRAPPER_IMAGES.has(base) ? base : null;
76
+ }
77
+
78
+ function digest(commandLine: string): string {
79
+ return createHash("sha256").update(commandLine, "utf8").digest("hex");
80
+ }
81
+
82
+ type ParentLink = WindowsStopProcessEntry | "gone" | "unreadable";
83
+
84
+ export function bindWindowsStopWrappers(context: WindowsStopBindingContext): WindowsStopBinding {
85
+ const processes = context.processes.filter(entry => entry.pid !== context.selfPid);
86
+ const byPid = new Map(processes.map(entry => [entry.pid, entry]));
87
+
88
+ const parentLink = (entry: WindowsStopProcessEntry): ParentLink => {
89
+ if (entry.parentPid === null) return "unreadable";
90
+ const parent = byPid.get(entry.parentPid);
91
+ if (!parent) return "gone";
92
+ if (entry.startTime !== null && parent.startTime !== null && parent.startTime > entry.startTime) return "gone";
93
+ return parent;
94
+ };
95
+ const ancestors = (entry: WindowsStopProcessEntry): WindowsStopProcessEntry[] => {
96
+ const chain: WindowsStopProcessEntry[] = [];
97
+ const seen = new Set<number>([entry.pid]);
98
+ let current = entry;
99
+ for (let depth = 0; depth < DEPTH_LIMIT; depth += 1) {
100
+ const link = parentLink(current);
101
+ if (typeof link === "string" || seen.has(link.pid)) break;
102
+ seen.add(link.pid);
103
+ chain.push(link);
104
+ current = link;
105
+ }
106
+ return chain;
107
+ };
108
+
109
+ const childEntry = context.childPid === null ? undefined : byPid.get(context.childPid);
110
+ const childAncestors = new Set(childEntry ? ancestors(childEntry).map(entry => entry.pid) : []);
111
+ const matchesPath = (entry: WindowsStopProcessEntry): boolean =>
112
+ context.canonicalPaths.some(path => commandLineHasPathToken(entry.commandLine, path));
113
+
114
+ const unreadable = new Set<number>();
115
+ const candidates: WindowsStopProcessEntry[] = [];
116
+ for (const entry of processes) {
117
+ if (entry.pid === context.childPid || !matchesPath(entry)) continue;
118
+ if (entry.name === null) unreadable.add(entry.pid);
119
+ else if (windowsWrapperImage(entry.name)) candidates.push(entry);
120
+ }
121
+
122
+ const bound = new Set<number>();
123
+ const descendsFromBound = (entry: WindowsStopProcessEntry): boolean =>
124
+ ancestors(entry).some(ancestor => bound.has(ancestor.pid));
125
+ const lineage = (entry: WindowsStopProcessEntry): boolean => {
126
+ if (childAncestors.has(entry.pid) || descendsFromBound(entry)) return true;
127
+ const link = parentLink(entry);
128
+ if (link === "gone") return context.taskRegistered;
129
+ if (link === "unreadable") return false;
130
+ return context.scheduleServicePid !== null && link.pid === context.scheduleServicePid;
131
+ };
132
+ for (let changed = true; changed;) {
133
+ changed = false;
134
+ for (const entry of candidates) {
135
+ if (bound.has(entry.pid) || entry.startTime === null) continue;
136
+ if (lineage(entry)) {
137
+ bound.add(entry.pid);
138
+ changed = true;
139
+ }
140
+ }
141
+ }
142
+
143
+ const unbound: WindowsStopBinding["unbound"] = [];
144
+ for (const entry of candidates) {
145
+ if (bound.has(entry.pid)) continue;
146
+ if (entry.startTime === null) unreadable.add(entry.pid);
147
+ else if (context.taskRegistered && parentLink(entry) === "unreadable") unreadable.add(entry.pid);
148
+ else unbound.push({ pid: entry.pid, startTime: entry.startTime });
149
+ }
150
+
151
+ for (const entry of processes) {
152
+ if (entry.pid === context.childPid || entry.commandLine?.trim() || !windowsWrapperImage(entry.name)) continue;
153
+ if (descendsFromBound(entry) || (context.managerRegistered && childAncestors.has(entry.pid))) {
154
+ unreadable.add(entry.pid);
155
+ }
156
+ }
157
+
158
+ const boundEntries = candidates.filter(entry => bound.has(entry.pid));
159
+ const depth = (entry: WindowsStopProcessEntry): number =>
160
+ ancestors(entry).filter(ancestor => bound.has(ancestor.pid)).length;
161
+ boundEntries.sort((a, b) => depth(b) - depth(a) || a.pid - b.pid);
162
+
163
+ return {
164
+ bound: boundEntries.map(entry => ({
165
+ pid: entry.pid,
166
+ startTime: entry.startTime!,
167
+ image: windowsWrapperImage(entry.name)!,
168
+ parentPid: entry.parentPid,
169
+ commandLineDigest: digest(entry.commandLine ?? ""),
170
+ })),
171
+ unbound,
172
+ unreadable: [...unreadable].sort((a, b) => a - b),
173
+ child: childEntry ? { pid: childEntry.pid, startTime: childEntry.startTime } : null,
174
+ };
175
+ }
176
+
177
+ /** Wrapper-image processes still carrying this home's paths (Part B's final enumeration). */
178
+ export function windowsHomeWrapperPids(
179
+ processes: readonly WindowsStopProcessEntry[],
180
+ canonicalPaths: readonly string[],
181
+ selfPid?: number,
182
+ ): number[] {
183
+ return processes
184
+ .filter(entry => entry.pid !== selfPid && windowsWrapperImage(entry.name)
185
+ && canonicalPaths.some(path => commandLineHasPathToken(entry.commandLine, path)))
186
+ .map(entry => entry.pid);
187
+ }
@@ -0,0 +1,123 @@
1
+ /**
2
+ * Time budget of the checked Windows stop (#7771, 030 "Time budget").
3
+ *
4
+ * One deadline governs the whole stop. Admission runs after Part A's registration probe
5
+ * and before anything changes: it adds up the worst case of every step still to come and
6
+ * refuses (unverified-budget, nothing changed) when the time left cannot hold it. Every
7
+ * step after admission that waits on the machine has a cap, and these constants are those
8
+ * caps. Opening the bind-time watches and the caller's authorizer are not capped; the
9
+ * authorizer runs inside the terminateAndWait window and is bounded by its caller.
10
+ *
11
+ * Pure arithmetic; the callers own the clock.
12
+ */
13
+
14
+ /** Caps of the individual steps, in ms. Part A and Part B enforce exactly these. */
15
+ export const WINDOWS_STOP_CAPS = {
16
+ registrationProbe: 2_000,
17
+ enumeration: 5_000,
18
+ scheduleServicePid: 2_000,
19
+ taskEnd: 2_000,
20
+ winswStopCommand: 2_000,
21
+ winswPollMargin: 2_000,
22
+ /** Terminate calls and the bind-time handle wait share this window. */
23
+ terminateAndWait: 3_000,
24
+ managerState: 1_000,
25
+ orphanDiscovery: 3_000,
26
+ postAnswer: 10_000,
27
+ forcedKill: 5_000,
28
+ forcedExitWait: 5_000,
29
+ childExitMargin: 3_000,
30
+ inheritedReceiptProbe: 3_000,
31
+ partBHoldFloor: 6_000,
32
+ partBWindowCeiling: 12_000,
33
+ /**
34
+ * A port sample may start at the very end of the window (the hold is measured between
35
+ * sample starts), so the closing sample can run this long past it. 030 did not count it.
36
+ */
37
+ partBClosingSample: 500,
38
+ partBFinalEnumeration: 5_000,
39
+ reserve: 3_000,
40
+ } as const;
41
+
42
+ /** The <stoptimeout> of the generated WinSW definition. */
43
+ export const DEFAULT_WINSW_STOP_TIMEOUT_MS = 20_000;
44
+ /** shutdownTimeoutMs default the child exit row is computed from. */
45
+ export const DEFAULT_SHUTDOWN_TIMEOUT_MS = 5_000;
46
+ /** Deadline of a caller that passes none (a terminal, a script, an older Desktop). */
47
+ export const DEFAULT_WINDOWS_STOP_DEADLINE_MS = 60_000;
48
+
49
+ export interface WindowsStopBudgetInput {
50
+ /** What Part A's registration probe found. */
51
+ managers: { scheduler: boolean; winsw: boolean; stray: boolean };
52
+ /** The bind reuses an enumeration that already ran (guarded: revalidateManager's). */
53
+ enumerationReused: boolean;
54
+ /** Snapshotless stop without a PID file, or after WinSW stopped the proxy. */
55
+ orphanDiscovery: boolean;
56
+ shutdownTimeoutMs?: number;
57
+ /** Abandoned teardown receipts whose endpoints are probed (two hosts each). */
58
+ inheritedReceipts?: number;
59
+ winswStopTimeoutMs?: number;
60
+ /** Part B runs after Part A (false only where 030 skips it, such as the route). */
61
+ partB?: boolean;
62
+ }
63
+
64
+ export interface WindowsStopBudgetRow {
65
+ step: "part-a" | "orphan-discovery" | "post-answer" | "child-exit" | "inherited-receipts" | "part-b" | "reserve";
66
+ ms: number;
67
+ }
68
+
69
+ export interface WindowsStopBudget {
70
+ rows: WindowsStopBudgetRow[];
71
+ totalMs: number;
72
+ }
73
+
74
+ const C = WINDOWS_STOP_CAPS;
75
+
76
+ /** Worst case of Part A still to come after its registration probe. */
77
+ export function windowsPartAWorstCaseMs(input: Pick<WindowsStopBudgetInput, "managers" | "enumerationReused" | "winswStopTimeoutMs">): number {
78
+ const { scheduler, winsw, stray } = input.managers;
79
+ const enumeration = input.enumerationReused ? 0 : C.enumeration;
80
+ let ms = 0;
81
+ if (scheduler) ms += enumeration + C.taskEnd + C.terminateAndWait + C.managerState;
82
+ else if (!stray) ms += enumeration + C.terminateAndWait;
83
+ if (winsw) {
84
+ const stopTimeout = input.winswStopTimeoutMs ?? DEFAULT_WINSW_STOP_TIMEOUT_MS;
85
+ // The service stop itself is capped at <stoptimeout> plus a margin.
86
+ ms += C.winswStopCommand + stopTimeout + C.winswPollMargin + C.managerState;
87
+ }
88
+ // Nothing registered: the stray enumeration already ran in the registration step.
89
+ if (!scheduler && !winsw && stray) ms += C.terminateAndWait + C.managerState;
90
+ return ms;
91
+ }
92
+
93
+ /**
94
+ * Part B's sampling window: min(12 s, remaining - closing sample - final enumeration -
95
+ * reserve), floor 6 s.
96
+ */
97
+ export function windowsPartBWindowMs(remainingMs: number, reserveMs: number = C.reserve): number {
98
+ const room = remainingMs - C.partBClosingSample - C.partBFinalEnumeration - reserveMs;
99
+ return Math.max(C.partBHoldFloor, Math.min(C.partBWindowCeiling, room));
100
+ }
101
+
102
+ /** The worst case of everything still to come at admission, row by row. */
103
+ export function windowsStopWorstCase(input: WindowsStopBudgetInput): WindowsStopBudget {
104
+ const { scheduler, winsw, stray } = input.managers;
105
+ // WinSW stops the proxy itself, so the POST and the child exit ladder do not apply to it.
106
+ const winswOnly = winsw && !scheduler && !stray;
107
+ const shutdown = input.shutdownTimeoutMs ?? DEFAULT_SHUTDOWN_TIMEOUT_MS;
108
+ const rows: WindowsStopBudgetRow[] = [
109
+ { step: "part-a", ms: windowsPartAWorstCaseMs(input) },
110
+ ];
111
+ if (input.orphanDiscovery) rows.push({ step: "orphan-discovery", ms: C.orphanDiscovery });
112
+ if (!winswOnly) {
113
+ rows.push({ step: "post-answer", ms: C.postAnswer });
114
+ rows.push({ step: "child-exit", ms: shutdown + C.childExitMargin + C.forcedKill + C.forcedExitWait });
115
+ }
116
+ const receipts = input.inheritedReceipts ?? 0;
117
+ if (receipts > 0) rows.push({ step: "inherited-receipts", ms: receipts * C.inheritedReceiptProbe });
118
+ if (input.partB ?? true) {
119
+ rows.push({ step: "part-b", ms: C.partBHoldFloor + C.partBClosingSample + C.partBFinalEnumeration });
120
+ }
121
+ rows.push({ step: "reserve", ms: C.reserve });
122
+ return { rows, totalMs: rows.reduce((sum, row) => sum + row.ms, 0) };
123
+ }