@bitkyc08/opencodex 2.100.2 → 2.100.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (561) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-BV4ms9U9.js} +1 -1
  6. package/gui/dist/assets/{brand-mark-DU-0Vdkr.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/{index-DJEkIDAi.css → index-DQtCRNAw.css} +1 -1
  9. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/{quota-summary-CakPe9Ni.js → quota-summary-Dy5_wfTT.js} +1 -1
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +3 -3
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/protobuf-request.ts +8 -8
  38. package/src/adapters/cursor.ts +7 -6
  39. package/src/adapters/google-antigravity-wire.ts +7 -5
  40. package/src/adapters/google-wire-compiler.ts +2 -2
  41. package/src/adapters/google.ts +9 -2
  42. package/src/adapters/kiro/payload.ts +7 -4
  43. package/src/adapters/kiro/reasoning.ts +44 -1
  44. package/src/adapters/kiro/structured-output.ts +10 -8
  45. package/src/adapters/kiro-tools.ts +61 -15
  46. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  47. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  48. package/src/adapters/zed.ts +3 -0
  49. package/src/advisor/consult.ts +15 -4
  50. package/src/advisor/context.ts +12 -3
  51. package/src/advisor/runtime.ts +35 -5
  52. package/src/advisor/settings.ts +8 -0
  53. package/src/advisor/synthetic-tool.ts +21 -8
  54. package/src/bridge/response-json.ts +11 -2
  55. package/src/bridge/sse.ts +43 -8
  56. package/src/claude/auth-detect.ts +21 -33
  57. package/src/claude/desktop-3p.ts +11 -5
  58. package/src/claude/desktop-gateway-state.ts +2 -0
  59. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  60. package/src/claude/desktop-remote-store.ts +24 -4
  61. package/src/claude/inbound-content-options.ts +31 -16
  62. package/src/claude/outbound.ts +13 -3
  63. package/src/cli/account-api.ts +17 -1
  64. package/src/cli/account-auth.ts +54 -21
  65. package/src/cli/account-key-quota.ts +34 -5
  66. package/src/cli/account.ts +4 -2
  67. package/src/cli/advisor.ts +7 -4
  68. package/src/cli/alias.ts +38 -1
  69. package/src/cli/capabilities-access-remote.ts +128 -3
  70. package/src/cli/capabilities-accounts.ts +3 -3
  71. package/src/cli/capabilities-agents-routing.ts +17 -10
  72. package/src/cli/capabilities-base.ts +41 -16
  73. package/src/cli/capabilities-integrations.ts +2 -2
  74. package/src/cli/capabilities-provider-models.ts +18 -2
  75. package/src/cli/capabilities-route-to.ts +43 -0
  76. package/src/cli/capabilities.ts +2 -0
  77. package/src/cli/capability-contracts.ts +1 -1
  78. package/src/cli/claude-desktop.ts +30 -11
  79. package/src/cli/claude.ts +17 -3
  80. package/src/cli/codex-launcher.ts +3 -1
  81. package/src/cli/codex-shim-autorestore.ts +5 -42
  82. package/src/cli/config-command.ts +14 -1
  83. package/src/cli/config-root-startup.ts +34 -0
  84. package/src/cli/connect.ts +88 -16
  85. package/src/cli/desktop-runtime-guidance.ts +1 -1
  86. package/src/cli/disconnect-runtime.ts +168 -0
  87. package/src/cli/dispatch.ts +54 -12
  88. package/src/cli/export-command.ts +1 -1
  89. package/src/cli/gui-pair-client.ts +6 -3
  90. package/src/cli/gui.ts +10 -5
  91. package/src/cli/help-catalog.ts +11 -0
  92. package/src/cli/help.ts +4 -3
  93. package/src/cli/index.ts +83 -92
  94. package/src/cli/inspect.ts +11 -2
  95. package/src/cli/integrations.ts +26 -1
  96. package/src/cli/link-capture.ts +64 -0
  97. package/src/cli/link-child-ops.ts +218 -40
  98. package/src/cli/link-cleanup.ts +8 -5
  99. package/src/cli/link-diagnostics.ts +67 -0
  100. package/src/cli/link-enrollment.ts +158 -12
  101. package/src/cli/link-operations.ts +52 -0
  102. package/src/cli/link-recover.ts +152 -0
  103. package/src/cli/link-routes.ts +87 -0
  104. package/src/cli/link-status-child.ts +44 -1
  105. package/src/cli/link-status-traffic.ts +34 -0
  106. package/src/cli/link.ts +314 -37
  107. package/src/cli/message-command.ts +1 -1
  108. package/src/cli/message-mcp-command.ts +23 -10
  109. package/src/cli/models-runtime.ts +3 -3
  110. package/src/cli/opencode.ts +3 -1
  111. package/src/cli/pi-sync.ts +35 -0
  112. package/src/cli/preflight-exemptions.ts +46 -0
  113. package/src/cli/registry.ts +28 -12
  114. package/src/cli/restart-failure.ts +5 -2
  115. package/src/cli/root.ts +5 -1
  116. package/src/cli/route-to.ts +172 -0
  117. package/src/cli/runtime-api.ts +5 -8
  118. package/src/cli/status.ts +3 -1
  119. package/src/cli/stop-approval.ts +66 -19
  120. package/src/cli/stop-report.ts +23 -0
  121. package/src/cli/stop-windows-checked.ts +304 -0
  122. package/src/cli/sync-command.ts +70 -15
  123. package/src/cli/sync-fanout.ts +74 -19
  124. package/src/cli/sync-flags.ts +40 -3
  125. package/src/cli/sync-link-status.ts +18 -2
  126. package/src/cli/sync-update-guard.ts +7 -2
  127. package/src/cli/system-restart-client.ts +3 -2
  128. package/src/cli/uninstall-plan.ts +77 -5
  129. package/src/cli/uninstall-stop.ts +152 -0
  130. package/src/cli/v2-input.ts +10 -6
  131. package/src/cli/v2-local-output.ts +3 -2
  132. package/src/cli/v2-runtime.ts +10 -3
  133. package/src/cli/v2.ts +22 -7
  134. package/src/client/connect.ts +321 -34
  135. package/src/client/link-home-features.ts +27 -0
  136. package/src/client/link-home.ts +92 -4
  137. package/src/client/link-ingress.ts +21 -3
  138. package/src/client/link-join.ts +12 -2
  139. package/src/client/link-parity-reporter.ts +60 -6
  140. package/src/client/link-relay-transport.ts +161 -36
  141. package/src/client/link-relay.ts +150 -6
  142. package/src/client/link-request-compression.ts +84 -0
  143. package/src/client/link-state.ts +11 -5
  144. package/src/client/link-status.ts +39 -1
  145. package/src/client/link-teardown.ts +1 -0
  146. package/src/client/link-tunnel.ts +56 -5
  147. package/src/client/link-websocket-limits.ts +89 -0
  148. package/src/client/link-websocket.ts +586 -0
  149. package/src/client/link-ws-advertisement.ts +100 -0
  150. package/src/client/link-ws-framer.ts +241 -0
  151. package/src/client/link-ws-transport.ts +177 -0
  152. package/src/client/machine-api.ts +13 -2
  153. package/src/client/machine-listener.ts +48 -7
  154. package/src/client/route-intent-apply.ts +293 -0
  155. package/src/client/route-intent-file-originals.ts +97 -0
  156. package/src/client/route-intent-native-originals.ts +201 -0
  157. package/src/client/route-intent-watch.ts +141 -0
  158. package/src/client/runtime-restart.ts +127 -5
  159. package/src/client/runtime.ts +61 -15
  160. package/src/client/state.ts +30 -0
  161. package/src/client/sync-expectation.ts +36 -2
  162. package/src/client/sync-runtime.ts +7 -0
  163. package/src/clients/config-export/alias-selectors.ts +63 -40
  164. package/src/clients/config-export/contracts.ts +2 -0
  165. package/src/clients/config-export/nested-selectors.ts +42 -0
  166. package/src/clients/config-export.ts +22 -3
  167. package/src/codex/account-store.ts +12 -3
  168. package/src/codex/account-usability.ts +13 -0
  169. package/src/codex/auth-api/account-list.ts +29 -3
  170. package/src/codex/auth-collision.ts +23 -22
  171. package/src/codex/auth-context.ts +21 -6
  172. package/src/codex/catalog/gather-capture.ts +8 -2
  173. package/src/codex/catalog/parsing.ts +7 -3
  174. package/src/codex/catalog/provider-models.ts +54 -15
  175. package/src/codex/catalog/retained-sync.ts +2 -1
  176. package/src/codex/catalog/routed-gather.ts +1 -1
  177. package/src/codex/catalog-auto-refresh.ts +11 -0
  178. package/src/codex/cli-update-job.ts +35 -13
  179. package/src/codex/convergence.ts +2 -2
  180. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  181. package/src/codex/features.ts +2 -2
  182. package/src/codex/history-provider.ts +31 -0
  183. package/src/codex/inject/multi-agent-v2.ts +9 -3
  184. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  185. package/src/codex/inject/plan.ts +20 -2
  186. package/src/codex/inject.ts +2 -0
  187. package/src/codex/journal-config-restore.ts +217 -0
  188. package/src/codex/journal.ts +75 -6
  189. package/src/codex/main-account.ts +23 -30
  190. package/src/codex/native-main-auth-file.ts +104 -0
  191. package/src/codex/native-profile-manager.ts +4 -3
  192. package/src/codex/native-profile-store.ts +3 -61
  193. package/src/codex/orca-import.ts +10 -1
  194. package/src/codex/quota-history.ts +13 -0
  195. package/src/codex/quota-window-conflict.ts +103 -0
  196. package/src/codex/quota.ts +23 -1
  197. package/src/codex/subagent-model-fallback.ts +3 -1
  198. package/src/codex/websocket-activity.ts +171 -16
  199. package/src/codex/websocket-registry.ts +11 -4
  200. package/src/combos/cooldown-store.ts +25 -5
  201. package/src/combos/failover.ts +330 -2
  202. package/src/config/dashboard-trusted-proxy.ts +83 -0
  203. package/src/config/diagnostics.ts +28 -0
  204. package/src/config/feature-flags.ts +9 -0
  205. package/src/config/live-reconcile.ts +10 -1
  206. package/src/config/load-degrade.ts +12 -1
  207. package/src/config/multi-agent-surface.ts +28 -5
  208. package/src/config/pending-teardown.ts +60 -3
  209. package/src/config/process-state.ts +175 -4
  210. package/src/config/provider-validation.ts +4 -4
  211. package/src/config/schema/config-schema.ts +6 -0
  212. package/src/config/schema/leaf-validators.ts +9 -2
  213. package/src/config/windows-process-command-line.ts +107 -0
  214. package/src/generated/compatibility-version.json +948 -392
  215. package/src/generated/model-metadata.ts +1 -1
  216. package/src/images/loop.ts +3 -0
  217. package/src/integrations/model-name-guard.ts +25 -0
  218. package/src/integrations/route-intent-catalog.ts +26 -0
  219. package/src/integrations/route-intent-connected.ts +262 -0
  220. package/src/integrations/route-intent-contract.ts +55 -0
  221. package/src/integrations/route-intent-disconnect.ts +109 -0
  222. package/src/integrations/route-intent-initial.ts +64 -0
  223. package/src/integrations/route-intent-state.ts +117 -0
  224. package/src/integrations/route-intent-tick.ts +65 -0
  225. package/src/integrations/route-intent.ts +212 -0
  226. package/src/integrations/writer.ts +44 -11
  227. package/src/lib/client-retry-after.ts +29 -0
  228. package/src/lib/config-ownership.ts +13 -0
  229. package/src/lib/desktop-gui-origin.ts +28 -0
  230. package/src/lib/errors.ts +1 -1
  231. package/src/lib/gui-pair-capability.ts +2 -1
  232. package/src/lib/messages-error-body.ts +4 -1
  233. package/src/lib/outbound-credential-registry.ts +362 -4
  234. package/src/lib/paced-stream.ts +34 -0
  235. package/src/lib/passive-key-fetch-proof.ts +30 -0
  236. package/src/lib/passive-read.ts +5 -0
  237. package/src/lib/process-control.ts +76 -12
  238. package/src/lib/redact.ts +84 -8
  239. package/src/lib/state-store-registrations.ts +11 -0
  240. package/src/lib/state-store-sweeper.ts +4 -0
  241. package/src/lib/supervisor-markers.ts +18 -0
  242. package/src/lib/terminal-safe-text.ts +58 -0
  243. package/src/lib/translator-budget.ts +3 -2
  244. package/src/lib/upstream-retry.ts +14 -4
  245. package/src/link/alias-lock.ts +119 -0
  246. package/src/link/child-activity.ts +28 -2
  247. package/src/link/child-binary-cache-fill.d.mts +50 -0
  248. package/src/link/child-binary-cache-fill.mjs +494 -0
  249. package/src/link/child-binary-cache-start.ts +73 -0
  250. package/src/link/child-binary-source.ts +12 -5
  251. package/src/link/child-gated-ocx.ts +29 -11
  252. package/src/link/child-observations.ts +2 -1
  253. package/src/link/child-observe.ts +2 -2
  254. package/src/link/child-ops-engine.ts +159 -91
  255. package/src/link/child-ops-host.ts +138 -0
  256. package/src/link/child-ops-runners.ts +319 -0
  257. package/src/link/child-ops-scheduler.ts +207 -0
  258. package/src/link/child-ops-types.ts +89 -0
  259. package/src/link/child-parity.ts +23 -4
  260. package/src/link/child-policy.ts +93 -0
  261. package/src/link/child-update-contract.ts +12 -3
  262. package/src/link/codex-settings.ts +1 -1
  263. package/src/link/compatibility.ts +18 -1
  264. package/src/link/diagnostics-read.ts +163 -0
  265. package/src/link/diagnostics.ts +20 -7
  266. package/src/link/explicit-route.ts +209 -0
  267. package/src/link/link-recover.ts +113 -0
  268. package/src/link/management-routes.ts +3 -1
  269. package/src/link/operation-recovery-slot.ts +44 -0
  270. package/src/link/operations-journal.ts +408 -0
  271. package/src/link/peer-report.ts +1 -1
  272. package/src/link/relay-auth.ts +14 -0
  273. package/src/link/remote-plant.ts +152 -14
  274. package/src/link/remote-platform.ts +21 -10
  275. package/src/link/remote-probe.ts +11 -3
  276. package/src/link/remote-windows.ts +50 -10
  277. package/src/link/request-compression.ts +30 -0
  278. package/src/link/residual-recovery.ts +54 -0
  279. package/src/link/retirement.ts +128 -0
  280. package/src/link/route-intent-watch.ts +41 -0
  281. package/src/link/route-intent.ts +209 -0
  282. package/src/link/route-proof.ts +82 -0
  283. package/src/link/route-rounds.ts +579 -0
  284. package/src/link/route-select.ts +95 -0
  285. package/src/link/route-trust.ts +96 -0
  286. package/src/link/ssh-argv.ts +172 -24
  287. package/src/link/ssh-capture-redact.ts +253 -0
  288. package/src/link/ssh-capture.ts +497 -0
  289. package/src/link/ssh-runner.ts +141 -14
  290. package/src/link/status-projection.ts +87 -0
  291. package/src/link/store.ts +54 -1
  292. package/src/link/supervisor.ts +543 -55
  293. package/src/link/sync-fanout-classify.ts +16 -0
  294. package/src/link/sync-then-restart.ts +65 -0
  295. package/src/link/tombstones.ts +209 -0
  296. package/src/link/traffic.ts +178 -0
  297. package/src/link/ws-activity-holds.ts +474 -0
  298. package/src/local-credentials/publication-fence.ts +20 -1
  299. package/src/messaging/mcp-queue-rpc.ts +1 -1
  300. package/src/messaging/mcp-queue-server.ts +16 -1
  301. package/src/messaging/mcp-resume-tools.ts +25 -0
  302. package/src/messaging/remote-enrollment.ts +3 -3
  303. package/src/messaging/remote-tunnels.ts +2 -2
  304. package/src/messaging/resume-permissions.ts +27 -0
  305. package/src/messaging/rpc.ts +46 -2
  306. package/src/oauth/anthropic-continuity.ts +23 -7
  307. package/src/oauth/anthropic-routing.ts +5 -2
  308. package/src/oauth/anthropic.ts +22 -2
  309. package/src/oauth/claude-keychain-read.ts +78 -68
  310. package/src/oauth/index.ts +24 -6
  311. package/src/oauth/local-token-detect.ts +8 -29
  312. package/src/oauth/login-cli-errors.ts +5 -1
  313. package/src/oauth/login-cli.ts +33 -18
  314. package/src/oauth/login-flow-state.ts +26 -3
  315. package/src/oauth/meta-muse.ts +1 -1
  316. package/src/oauth/store.ts +7 -0
  317. package/src/oauth/xai.ts +248 -14
  318. package/src/protocols/contract.ts +4 -0
  319. package/src/protocols/encoders/messages.ts +1 -0
  320. package/src/providers/alias-template.ts +48 -0
  321. package/src/providers/anthropic-billing-ownership.ts +2 -0
  322. package/src/providers/anthropic-output-caps.ts +46 -0
  323. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  324. package/src/providers/antigravity-effort-families.ts +11 -3
  325. package/src/providers/antigravity-models.ts +32 -9
  326. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  327. package/src/providers/api-key-pause.ts +3 -0
  328. package/src/providers/api-key-resolve.ts +49 -7
  329. package/src/providers/api-key-response-ownership.ts +2 -0
  330. package/src/providers/api-key-selection.ts +51 -9
  331. package/src/providers/api-keys.ts +6 -2
  332. package/src/providers/cache-affinity-identity.ts +73 -0
  333. package/src/providers/cache-affinity.ts +256 -0
  334. package/src/providers/default-aliases.ts +98 -20
  335. package/src/providers/google-vertex-model-discovery.ts +510 -0
  336. package/src/providers/key-failover.ts +123 -8
  337. package/src/providers/key-store.ts +3 -3
  338. package/src/providers/kiro-models.ts +3 -5
  339. package/src/providers/label.ts +31 -5
  340. package/src/providers/mistral-transport.ts +17 -4
  341. package/src/providers/model-rename-fields.ts +3 -0
  342. package/src/providers/muse-key-quota.ts +14 -6
  343. package/src/providers/new-model-policy-runtime.ts +17 -4
  344. package/src/providers/new-model-policy.ts +30 -4
  345. package/src/providers/passive-key-observation.ts +252 -0
  346. package/src/providers/quota/account-cache.ts +2 -1
  347. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  348. package/src/providers/quota/passive-key-limits.ts +272 -0
  349. package/src/providers/quota/passive-wire-model.ts +126 -0
  350. package/src/providers/quota/report-cache.ts +61 -2
  351. package/src/providers/quota-key-accounts.ts +11 -6
  352. package/src/providers/quota-types.ts +18 -0
  353. package/src/providers/quota.ts +11 -12
  354. package/src/providers/registry/entries-core.ts +34 -16
  355. package/src/providers/registry/entries-extended.ts +32 -0
  356. package/src/providers/registry/model-seeds.ts +35 -0
  357. package/src/providers/resolved-model-policy.ts +7 -0
  358. package/src/providers/routed-config.ts +8 -3
  359. package/src/providers/xai-transport.ts +3 -0
  360. package/src/remote/features.ts +17 -0
  361. package/src/responses/anthropic-progress.ts +10 -4
  362. package/src/responses/citation-markers.ts +231 -0
  363. package/src/responses/spill-store.ts +5 -1
  364. package/src/responses/state/replay-input.ts +50 -0
  365. package/src/responses/state/replay-owner.ts +24 -0
  366. package/src/responses/state/snapshot-codec.ts +9 -0
  367. package/src/responses/state/spill-queue.ts +1 -0
  368. package/src/responses/state.ts +42 -60
  369. package/src/router.ts +2 -2
  370. package/src/routing/home-route-capture.ts +123 -0
  371. package/src/routing/home-route-intent.ts +200 -0
  372. package/src/routing/route-intent-state.ts +178 -0
  373. package/src/routing/route-to-live-settings.ts +35 -0
  374. package/src/routing/route-to-local.ts +145 -0
  375. package/src/routing/route-to-status.ts +94 -0
  376. package/src/routing/route-to-sync-child.ts +32 -0
  377. package/src/server/adapter-resolve.ts +21 -1
  378. package/src/server/admitted-http-turn.ts +3 -0
  379. package/src/server/auth-cors.ts +98 -0
  380. package/src/server/bare-upstream-error.ts +220 -0
  381. package/src/server/chat-native.ts +14 -5
  382. package/src/server/claude-messages.ts +6 -4
  383. package/src/server/codex-model-list.ts +2 -1
  384. package/src/server/configured-credentials.ts +37 -5
  385. package/src/server/gui-desktop-authorization.ts +36 -0
  386. package/src/server/gui-pair-delivery.ts +6 -3
  387. package/src/server/gui-session.ts +10 -1
  388. package/src/server/inbound-body-admission.ts +17 -4
  389. package/src/server/index/link-listener.ts +190 -12
  390. package/src/server/index/link-management.ts +15 -1
  391. package/src/server/index/link-relay-sessions.ts +87 -8
  392. package/src/server/index/link-websocket-limits.ts +136 -0
  393. package/src/server/index/link-websocket.ts +692 -0
  394. package/src/server/index/optional-listeners.ts +97 -7
  395. package/src/server/index/route-intent-watch.ts +47 -0
  396. package/src/server/index/serve-contract.ts +86 -0
  397. package/src/server/index/serve-options.ts +35 -86
  398. package/src/server/index/startup-warnings.ts +8 -2
  399. package/src/server/index/websocket-handler.ts +26 -4
  400. package/src/server/index.ts +12 -2
  401. package/src/server/inference/client-encoder-delivery.ts +2 -0
  402. package/src/server/inspection-tee.ts +39 -2
  403. package/src/server/lifecycle.ts +2 -0
  404. package/src/server/link-turn.ts +137 -0
  405. package/src/server/management/advisor-routes.ts +10 -2
  406. package/src/server/management/agent-settings-routes.ts +50 -16
  407. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  408. package/src/server/management/context.ts +9 -2
  409. package/src/server/management/desktop-authorization.ts +41 -0
  410. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  411. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  412. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  413. package/src/server/management/home-integration-decision.ts +89 -0
  414. package/src/server/management/integration-routes.ts +208 -81
  415. package/src/server/management/link-child-ops-routes.ts +145 -43
  416. package/src/server/management/link-child-preflight.ts +31 -0
  417. package/src/server/management/link-diagnostics-route.ts +29 -0
  418. package/src/server/management/link-enrollment.ts +199 -47
  419. package/src/server/management/link-operation.ts +609 -0
  420. package/src/server/management/link-recover-route.ts +103 -0
  421. package/src/server/management/link-route-edit.ts +173 -0
  422. package/src/server/management/link-route-request.ts +62 -0
  423. package/src/server/management/link-route-state.ts +83 -7
  424. package/src/server/management/link-routes.ts +553 -51
  425. package/src/server/management/link-traffic-status.ts +13 -0
  426. package/src/server/management/model-routes.ts +122 -36
  427. package/src/server/management/model-rows.ts +2 -1
  428. package/src/server/management/native-integration-routes.ts +176 -70
  429. package/src/server/management/oauth-account-routes.ts +36 -13
  430. package/src/server/management/protocol-routes.ts +7 -0
  431. package/src/server/management/provider-completion-test.ts +4 -4
  432. package/src/server/management/provider-overwrite-carry.ts +11 -0
  433. package/src/server/management/provider-routes.ts +64 -61
  434. package/src/server/management/provider-routing-quota.ts +45 -0
  435. package/src/server/management/route-registry.ts +22 -3
  436. package/src/server/management/route-to-routes.ts +257 -0
  437. package/src/server/management/system-restart.ts +4 -2
  438. package/src/server/management/usage-aggregate-cache.ts +101 -66
  439. package/src/server/management-api.ts +17 -3
  440. package/src/server/management-auth.ts +13 -1
  441. package/src/server/messages-native-preflight.ts +27 -4
  442. package/src/server/messages-native.ts +17 -5
  443. package/src/server/persistent-gui-session.ts +6 -3
  444. package/src/server/proxy-liveness.ts +33 -6
  445. package/src/server/relay-eager.ts +36 -12
  446. package/src/server/relay.ts +183 -116
  447. package/src/server/request-body-facts.ts +48 -0
  448. package/src/server/request-decompress.ts +65 -2
  449. package/src/server/request-log-account-rotation.ts +6 -0
  450. package/src/server/request-log-attempt-usage.ts +69 -0
  451. package/src/server/request-log-cache-affinity.ts +60 -0
  452. package/src/server/request-log-conversation.ts +45 -2
  453. package/src/server/request-log-terminal-status.ts +210 -24
  454. package/src/server/request-log.ts +71 -79
  455. package/src/server/responses/adapter-continuation.ts +2 -1
  456. package/src/server/responses/adapter-delivery.ts +2 -0
  457. package/src/server/responses/adapter-dispatch.ts +5 -7
  458. package/src/server/responses/advisor-plan-slot.ts +33 -1
  459. package/src/server/responses/advisor-question.ts +21 -0
  460. package/src/server/responses/advisor-slot.ts +10 -3
  461. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  462. package/src/server/responses/buffered-sse-json.ts +9 -3
  463. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  464. package/src/server/responses/codex-tool-catalog.ts +156 -0
  465. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  466. package/src/server/responses/combo-stream-preflight.ts +557 -54
  467. package/src/server/responses/compact.ts +32 -8
  468. package/src/server/responses/core-codex-account.ts +17 -3
  469. package/src/server/responses/core-combo-failure.ts +8 -0
  470. package/src/server/responses/core-combo.ts +32 -4
  471. package/src/server/responses/core-errors.ts +5 -2
  472. package/src/server/responses/core-lifetime.ts +3 -2
  473. package/src/server/responses/core-normalize.ts +3 -1
  474. package/src/server/responses/core-options.ts +6 -0
  475. package/src/server/responses/core.ts +2 -0
  476. package/src/server/responses/fetch-helpers.ts +15 -10
  477. package/src/server/responses/native-replay-guard.ts +57 -0
  478. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  479. package/src/server/responses/outbound-request-body.ts +29 -0
  480. package/src/server/responses/passthrough-completion.ts +105 -8
  481. package/src/server/responses/passthrough-delivery.ts +31 -11
  482. package/src/server/responses/passthrough-dispatch.ts +74 -73
  483. package/src/server/responses/policy-fallback.ts +13 -1
  484. package/src/server/responses/request-prepare.ts +50 -6
  485. package/src/server/responses/request-transport.ts +10 -3
  486. package/src/server/responses/reset-replay.ts +46 -2
  487. package/src/server/responses/run-turn-execution.ts +2 -0
  488. package/src/server/responses/sidecar-execution.ts +14 -0
  489. package/src/server/responses/terminal-error-redaction.ts +222 -25
  490. package/src/server/responses/ws-upstream.ts +2 -2
  491. package/src/server/sse-payload-rewrite.ts +3 -2
  492. package/src/server/stop-service-route.ts +85 -0
  493. package/src/server/system-env-shell.ts +12 -1
  494. package/src/server/system-env.ts +5 -3
  495. package/src/server/windows-tcp-drop.ts +21 -4
  496. package/src/server/workflow-refusal.ts +8 -0
  497. package/src/server/ws-bridge.ts +191 -12
  498. package/src/service/cli-windows-stop.ts +189 -0
  499. package/src/service/cli.ts +41 -12
  500. package/src/service/disconnected-client-restart.ts +60 -0
  501. package/src/service/guarded-manager-target.ts +18 -1
  502. package/src/service/health.ts +99 -6
  503. package/src/service/launchd.ts +84 -31
  504. package/src/service/orchestration.ts +418 -91
  505. package/src/service/repair.ts +223 -6
  506. package/src/service/restart-proxy-stop.ts +79 -0
  507. package/src/service/service-child-ownership.ts +6 -2
  508. package/src/service/windows-checked-stop-live.ts +467 -0
  509. package/src/service/windows-checked-stop.ts +435 -0
  510. package/src/service/windows-command-line-token.ts +23 -0
  511. package/src/service/windows-guarded-manager.ts +77 -34
  512. package/src/service/windows-ops.ts +38 -56
  513. package/src/service/windows-process-evidence.ts +292 -0
  514. package/src/service/windows-process-native.ts +262 -0
  515. package/src/service/windows-service-stop.ts +321 -0
  516. package/src/service/windows-stop-binding.ts +187 -0
  517. package/src/service/windows-stop-budget.ts +123 -0
  518. package/src/service/windows-stop-confirm.ts +158 -0
  519. package/src/service/windows-stop-deadline.ts +56 -0
  520. package/src/service.ts +2 -2
  521. package/src/types/config.ts +42 -18
  522. package/src/types/link.ts +20 -0
  523. package/src/types/multi-agent.ts +13 -0
  524. package/src/types/provider.ts +47 -2
  525. package/src/types/request.ts +4 -0
  526. package/src/types.ts +3 -0
  527. package/src/update/guarded-runtime-ops.ts +5 -7
  528. package/src/update/index.ts +25 -10
  529. package/src/update/install-detection.mjs +3 -1
  530. package/src/update/job-pinned-start.ts +2 -0
  531. package/src/update/job-windows-restart.ts +19 -32
  532. package/src/update/job.ts +12 -5
  533. package/src/update/npm-install.d.mts +11 -0
  534. package/src/update/npm-install.mjs +44 -7
  535. package/src/update/orchestrated-entry.ts +1 -1
  536. package/src/update/orchestrated-node-driver.mjs +3 -2
  537. package/src/update/orchestrated-pnpm.d.mts +4 -0
  538. package/src/update/orchestrated-pnpm.mjs +50 -6
  539. package/src/update/orchestrated-session.d.mts +3 -1
  540. package/src/update/orchestrated-session.mjs +21 -6
  541. package/src/update/pnpm-global-install.d.mts +21 -3
  542. package/src/update/pnpm-global-install.mjs +322 -19
  543. package/src/update/pnpm-store-layout.mjs +46 -0
  544. package/src/update/sync-update-mutex.d.mts +3 -2
  545. package/src/update/sync-update-mutex.mjs +57 -8
  546. package/src/update/transactional-install.d.mts +3 -1
  547. package/src/update/transactional-install.mjs +545 -12
  548. package/src/update/windows-installer-marker.d.mts +1 -0
  549. package/src/update/windows-installer-marker.mjs +44 -0
  550. package/src/usage/expected-prices.ts +8 -0
  551. package/src/usage/filter-index.ts +326 -77
  552. package/src/usage/ledger-scanner.ts +15 -0
  553. package/src/usage/link-log-fields.ts +48 -0
  554. package/src/usage/log.ts +43 -2
  555. package/src/usage/request-body.ts +37 -0
  556. package/src/web-search/loop.ts +3 -0
  557. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  558. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  559. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  560. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  561. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,158 @@
1
+ /**
2
+ * Part B of the checked Windows service stop (#7771, 030 "Part B"), run by the caller
3
+ * after its graceful child stop: the port is free and stays free for one relaunch period,
4
+ * no wrapper of this home is running, and a remaining listener is classified.
5
+ *
6
+ * 1. Sample the port until it has been free for the 6 s hold, measured between sample
7
+ * starts, within the window from windowsPartBWindowMs (6-12 s, starting now). A loop that
8
+ * relaunches the proxy late breaks the streak.
9
+ * 2. Then, under one 5 s cap, run the final enumeration and, if the port is still held,
10
+ * identify its listener. The enumeration must show no wrapper-image process carrying
11
+ * this home's path token; an unreadable table is non-success, and a wrapper started
12
+ * after bind makes the stop survived even with the port free.
13
+ * 3. A remaining listener is ours (survived), foreign (portHeldByForeign) or left by an
14
+ * owner that has exited, which is not foreign: the caller's reclaim clears that one.
15
+ *
16
+ * Every effect is injected; nothing calls this yet.
17
+ */
18
+ import type { WindowsStopProcessEntry } from "./windows-process-evidence";
19
+ import { windowsHomeWrapperPids } from "./windows-stop-binding";
20
+ import { runCapped, windowsStopClock, type WindowsStopClock } from "./windows-checked-stop";
21
+ import { commandLineHasPathToken } from "./windows-command-line-token";
22
+ import { WINDOWS_STOP_CAPS, windowsPartBWindowMs } from "./windows-stop-budget";
23
+
24
+ type MaybePromise<T> = T | Promise<T>;
25
+
26
+ export type WindowsPortSample =
27
+ | { state: "free" }
28
+ | { state: "listening"; ownerPid: number | null }
29
+ | { state: "unknown" };
30
+
31
+ /** ours = this installation's identity answers; exited = the owning process is gone. */
32
+ export type WindowsListenerIdentity = "ours" | "foreign" | "exited" | "unknown";
33
+
34
+ export interface WindowsStopConfirmDeps {
35
+ clock?: WindowsStopClock;
36
+ port: number;
37
+ /** Time left in the caller's deadline when Part B starts. */
38
+ remainingMs: number;
39
+ reserveMs?: number;
40
+ canonicalPaths: readonly string[];
41
+ selfPid?: number;
42
+ samplePort(port: number, timeoutMs: number): MaybePromise<WindowsPortSample>;
43
+ identifyListener(port: number, ownerPid: number | null, timeoutMs: number): MaybePromise<WindowsListenerIdentity>;
44
+ enumerate(timeoutMs: number): MaybePromise<readonly WindowsStopProcessEntry[] | null>;
45
+ }
46
+
47
+ export type WindowsStopConfirmOutcome = "freed" | "survived" | "port-held-by-foreign" | "unconfirmed" | "unknown";
48
+
49
+ export interface WindowsStopConfirmResult {
50
+ outcome: WindowsStopConfirmOutcome;
51
+ portHeldByForeign: boolean;
52
+ reason: "evidence-unreadable" | null;
53
+ detail: string;
54
+ port: number;
55
+ windowMs: number;
56
+ listener: { ownerPid: number | null; identity: WindowsListenerIdentity } | null;
57
+ /** Wrapper-image processes of this home found by the final enumeration. */
58
+ lateWrappers: number[];
59
+ }
60
+
61
+ const C = WINDOWS_STOP_CAPS;
62
+ const SAMPLE_INTERVAL_MS = 250;
63
+
64
+ export async function confirmWindowsStopFreed(deps: WindowsStopConfirmDeps): Promise<WindowsStopConfirmResult> {
65
+ const clock = deps.clock ?? windowsStopClock;
66
+ const windowMs = windowsPartBWindowMs(deps.remainingMs, deps.reserveMs ?? C.reserve);
67
+ const windowEnd = clock.now() + windowMs;
68
+ const result: WindowsStopConfirmResult = {
69
+ outcome: "unknown", portHeldByForeign: false, reason: null, detail: "",
70
+ port: deps.port, windowMs, listener: null, lateWrappers: [],
71
+ };
72
+ const finish = (outcome: WindowsStopConfirmOutcome, detail: string): WindowsStopConfirmResult => {
73
+ result.outcome = outcome;
74
+ result.portHeldByForeign = outcome === "port-held-by-foreign";
75
+ result.reason = outcome === "unknown" ? "evidence-unreadable" : null;
76
+ result.detail = detail;
77
+ return result;
78
+ };
79
+
80
+ let freeSince: number | null = null;
81
+ let held = false;
82
+ let last: WindowsPortSample = { state: "unknown" };
83
+ for (;;) {
84
+ const startedAt = clock.now();
85
+ const sample = await runCapped(clock, C.partBClosingSample, timeoutMs => deps.samplePort(deps.port, timeoutMs));
86
+ last = sample.ok ? sample.value : { state: "unknown" };
87
+ if (last.state === "free") {
88
+ freeSince ??= startedAt;
89
+ if (startedAt - freeSince >= C.partBHoldFloor) {
90
+ held = true;
91
+ break;
92
+ }
93
+ } else {
94
+ freeSince = null;
95
+ }
96
+ const left = windowEnd - clock.now();
97
+ if (left <= 0) break;
98
+ await clock.sleep(Math.min(SAMPLE_INTERVAL_MS, left));
99
+ }
100
+
101
+ const listening = last.state === "listening" ? last : null;
102
+ const [snapshot, identity] = await Promise.all([
103
+ runCapped(clock, C.partBFinalEnumeration, deps.enumerate),
104
+ listening
105
+ ? runCapped(clock, C.partBFinalEnumeration,
106
+ timeoutMs => deps.identifyListener(deps.port, listening.ownerPid, timeoutMs))
107
+ : Promise.resolve(null),
108
+ ]);
109
+ if (listening) {
110
+ result.listener = {
111
+ ownerPid: listening.ownerPid,
112
+ identity: identity && identity.ok ? identity.value : "unknown",
113
+ };
114
+ }
115
+
116
+ const processes = snapshot.ok ? snapshot.value : null;
117
+ if (processes) {
118
+ result.lateWrappers = windowsHomeWrapperPids(processes, deps.canonicalPaths, deps.selfPid ?? process.pid);
119
+ }
120
+ if (result.lateWrappers.length > 0) return finish("survived", "a wrapper of this home is running after the stop");
121
+ if (result.listener?.identity === "ours") return finish("survived", "this installation answers on the port again");
122
+ if (processes === null) return finish("unknown", "the final process list could not be read");
123
+ const unnamed = processes.some(entry => entry.name === null && entry.pid !== (deps.selfPid ?? process.pid)
124
+ && deps.canonicalPaths.some(path => commandLineHasPathToken(entry.commandLine, path)));
125
+ if (unnamed) return finish("unknown", "a process carrying this home's paths has an unreadable image name");
126
+ if (held) return finish("freed", "the port stayed free for the hold and no wrapper of this home is running");
127
+ if (result.listener?.identity === "foreign") return finish("port-held-by-foreign", "another program holds the port");
128
+ if (result.listener?.identity === "exited") {
129
+ return finish("unconfirmed", "the port is held by a listener whose owner has exited");
130
+ }
131
+ if (last.state === "free") return finish("unconfirmed", "the port was not free for the whole hold within the window");
132
+ return finish("unknown", "the port state could not be read");
133
+ }
134
+
135
+ /**
136
+ * Which port Part B watches: the runtime-port record when present, else the port baked
137
+ * into the wrapper script, else the configured port.
138
+ */
139
+ export function resolveWindowsStopPort(sources: {
140
+ runtimePort: () => number | null;
141
+ wrapperPort: () => number | null;
142
+ configuredPort: () => number;
143
+ }): { port: number; source: "runtime" | "wrapper" | "config" } {
144
+ const valid = (value: number | null): value is number =>
145
+ value !== null && Number.isSafeInteger(value) && value > 0 && value <= 65_535;
146
+ const read = (get: () => number | null): number | null => {
147
+ try {
148
+ return get();
149
+ } catch {
150
+ return null;
151
+ }
152
+ };
153
+ const runtime = read(sources.runtimePort);
154
+ if (valid(runtime)) return { port: runtime, source: "runtime" };
155
+ const wrapper = read(sources.wrapperPort);
156
+ if (valid(wrapper)) return { port: wrapper, source: "wrapper" };
157
+ return { port: sources.configuredPort(), source: "config" };
158
+ }
@@ -0,0 +1,56 @@
1
+ /**
2
+ * The checked Windows stop's deadline (#7771, 030 "Time budget"). Kept free of the stop
3
+ * machinery because the CLI dispatcher, which loads on every command, records it.
4
+ *
5
+ * ocx stop reads --deadline-ms <n> or OCX_STOP_DEADLINE_MS (the flag wins; an empty or
6
+ * invalid variable counts as absent) and records the resolved budget as a command-start
7
+ * deadline: performance.now() counts from performance.timeOrigin, so N ms of budget at
8
+ * command start is the Part A clock value N. Every other caller starts the default 60 s
9
+ * when its stop phase begins, not when the process did -- installFreshWindowsSchedulerSafely
10
+ * reaches the stop only after registration and the UAC prompt, so measuring from process
11
+ * start would refuse `unverified-budget` a stop that had its whole budget left.
12
+ */
13
+ import { DEFAULT_WINDOWS_STOP_DEADLINE_MS } from "./windows-stop-budget";
14
+
15
+ export const STOP_DEADLINE_ENV = "OCX_STOP_DEADLINE_MS";
16
+
17
+ /** A positive decimal integer of milliseconds, or null (absent, empty or invalid). */
18
+ export function parseStopDeadlineMs(raw: string | undefined | null): number | null {
19
+ if (raw === undefined || raw === null) return null;
20
+ const trimmed = raw.trim();
21
+ if (!/^\d+$/.test(trimmed)) return null;
22
+ const value = Number(trimmed);
23
+ return Number.isSafeInteger(value) && value > 0 ? value : null;
24
+ }
25
+
26
+ /** The flag wins; an empty or invalid variable is absent; neither means 60 s. */
27
+ export function resolveStopDeadlineMs(flagMs: number | null | undefined, env: NodeJS.ProcessEnv = process.env): number {
28
+ if (typeof flagMs === "number" && Number.isSafeInteger(flagMs) && flagMs > 0) return flagMs;
29
+ return parseStopDeadlineMs(env[STOP_DEADLINE_ENV]) ?? DEFAULT_WINDOWS_STOP_DEADLINE_MS;
30
+ }
31
+
32
+ /** ocx stop's command-start deadline, or null while no command recorded one. */
33
+ let commandDeadlineMs: number | null = null;
34
+ /** The unconfigured caller's deadline, armed once when its stop phase first asks. */
35
+ let phaseDeadlineAt: number | null = null;
36
+
37
+ /**
38
+ * ocx stop records its resolved deadline here once its arguments are parsed. A new value
39
+ * is an absolute command-start deadline; null clears it and re-arms the stop phase, so the
40
+ * next unconfigured caller measures its own 60 s from when it gets there.
41
+ */
42
+ export function setStopDeadlineMs(ms: number | null): void {
43
+ commandDeadlineMs = ms;
44
+ phaseDeadlineAt = null;
45
+ }
46
+
47
+ /**
48
+ * The absolute deadline on the Part A clock (ms since process start). An explicit command
49
+ * deadline wins; otherwise the first call in a stop phase arms the default 60 s and every
50
+ * later call inside that phase keeps it -- one deadline governs the whole stop.
51
+ */
52
+ export function windowsStopDeadlineAt(now: number = performance.now()): number {
53
+ if (commandDeadlineMs !== null) return commandDeadlineMs;
54
+ if (phaseDeadlineAt === null) phaseDeadlineAt = now + DEFAULT_WINDOWS_STOP_DEADLINE_MS;
55
+ return phaseDeadlineAt;
56
+ }
package/src/service.ts CHANGED
@@ -25,13 +25,13 @@ export { decodeSchtasksOutput, setQuerySchtasksForTests, formatWindowsSchedulerS
25
25
  export type { WindowsSchedulerXmlState } from "./service/windows-taskxml";
26
26
  export { buildWindowsServiceScript, buildWindowsSchtasksCreateArgs, buildWindowsSchtasksCreateArgsForXml, buildWindowsLauncherVbs, buildWindowsTaskXml, buildWindowsTaskXmlDocument, windowsTaskRegistrationOwnedByAttempt, windowsTaskRegistrationHealthy, readWindowsSchedulerXmlState } from "./service/windows-taskxml";
27
27
  export type { WindowsSchedulerRegistrationStageDeps, FreshWindowsSchedulerRegistrationDeps, RemoveNativeWindowsServiceDeps } from "./service/windows-ops";
28
- export { windowsListenPort, winswListenPort, writeServiceDefinitionFile, definitionCarriesCredential, stageWindowsSchedulerRegistrationXml, stageElevatedSchedulerRegistration, describeElevatedRegistrationFailure, registerFreshWindowsSchedulerTask, removeNativeWindowsServiceForScheduler, assertWindowsNativeServiceAccountSupported, isWindowsSchedulerEndBenign, stopWindows, stopWindowsChecked, classifyWindowsServiceStop } from "./service/windows-ops";
28
+ export { windowsListenPort, winswListenPort, writeServiceDefinitionFile, definitionCarriesCredential, stageWindowsSchedulerRegistrationXml, stageElevatedSchedulerRegistration, describeElevatedRegistrationFailure, registerFreshWindowsSchedulerTask, removeNativeWindowsServiceForScheduler, assertWindowsNativeServiceAccountSupported, isWindowsSchedulerEndBenign, stopWindows } from "./service/windows-ops";
29
29
  export type { ServiceRepairVerb, RepairServiceDeps } from "./service/repair";
30
30
  export { repairService, foreignServiceOwnerRefusal, unknownServiceOwnerRefusal } from "./service/repair";
31
31
  export type { ServiceChildOwnershipDecision } from "./service/service-child-ownership";
32
32
  export { serviceChildOwnershipDecision, serviceChildStayOutExitCode } from "./service/service-child-ownership";
33
33
  export type { ServiceInstallPreparationDeps, FreshWindowsSchedulerInstallDeps, ServiceStopOutcome, ServiceUninstallOutcome } from "./service/orchestration";
34
- export { proxyStillLiveAfterStop, prepareServiceInstall, installServiceSafely, installFreshWindowsSchedulerSafely, installedServiceRespawnRisk, stopServiceIfInstalledDetailed, setUninstallServiceHooksForTests, uninstallServiceDetailed, uninstallServiceIfInstalled, isServiceInstalled, isServiceViable } from "./service/orchestration";
34
+ export { proxyStillLiveAfterStop, prepareServiceInstall, installServiceSafely, installFreshWindowsSchedulerSafely, installedServiceRespawnRisk, stopServiceIfInstalledDetailed, stopServiceIfInstalledReport, setUninstallServiceHooksForTests, uninstallServiceDetailed, uninstallServiceIfInstalled, isServiceInstalled, isServiceViable } from "./service/orchestration";
35
35
  export type { ServiceDiagnostic, WindowsTaskDiagnosticIdentityDeps, WindowsServiceDiagnosticInputs, LaunchdServiceDiagnosticInputs } from "./service/diagnostics";
36
36
  export { bakedServicePathsDiagnostic, serviceStartableFromTray, resolveWindowsTaskDiagnosticUserId, deriveWindowsServiceDiagnostic, deriveWindowsServiceDiagnosticForCurrentUser, deriveLaunchdServiceDiagnostic, diagnoseService, serviceStatusSummary, serviceStatusReport } from "./service/diagnostics";
37
37
  export type { ParsedServiceArgs, ServiceInstallationState, ServiceInstallationProbe, ServiceInstallationProbeHooks, ServiceCommandPlan } from "./service/cli";
@@ -3,8 +3,10 @@ import type { CodexAccount } from "./accounts";
3
3
  import type { AnthropicAccountPoolConfig, OcxAccountPoolRotationStrategy } from "./anthropic-account-pool";
4
4
  import type { AnthropicInstanceId } from "../providers/anthropic-instance-id";
5
5
  import type { OcxFallbackConfig } from "./fallback";
6
+ import type { MultiAgentMode } from "./multi-agent";
6
7
  import type { OcxTelemetryConfig } from "./telemetry";
7
8
  import type { OcxClaudeCodeToolLoadingConfig } from "./claude-tool-loading";
9
+ import type { OcxLinkHomeConfig, OcxLinkTransportConfig } from "./link";
8
10
  export type { AnthropicAccountPoolConfig, AnthropicModelRoute, OcxAccountPoolRotationStrategy, OcxAccountPoolQuotaWindow } from "./anthropic-account-pool";
9
11
  export type { OcxFallbackConfig, OcxFallbackDeviceConfig, OcxFallbackKind, OcxFallbackSwitches } from "./fallback";
10
12
  export type { OcxClaudeCodeToolLoadingConfig } from "./claude-tool-loading";
@@ -461,7 +463,7 @@ export interface OcxRemoteGuiConfig {
461
463
  allowInsecureHttp?: boolean;
462
464
  }
463
465
 
464
- export type OcxConnectedClientId = "codex" | "claude";
466
+ export type OcxConnectedClientId = "codex" | "claude" | "claude-desktop" | "grok" | import("../clients/client-ids").ExportClientId;
465
467
 
466
468
  /**
467
469
  * Redaction policy for management and CLI projections (#3859).
@@ -483,11 +485,6 @@ export interface OcxPrivacyConfig {
483
485
  maskEmails?: boolean;
484
486
  }
485
487
 
486
- export interface OcxLinkTransportConfig {
487
- tunnelPort: number;
488
- linkId: string;
489
- }
490
-
491
488
  export interface OcxClientConnectionConfig {
492
489
  serverUrl: string;
493
490
  managementUrl: string;
@@ -527,7 +524,7 @@ export interface OcxClientConnectionConfig {
527
524
  };
528
525
  }
529
526
 
530
- export interface OcxConfig {
527
+ export interface OcxConfig extends OcxLinkHomeConfig {
531
528
  /** Experimental macOS app-server stdout shim; absent or false disables it. */
532
529
  chatgptDesktop?: { appServerShim?: boolean };
533
530
  port: number;
@@ -581,7 +578,8 @@ export interface OcxConfig {
581
578
  defaultProvider: string;
582
579
  /** Persisted state for newly discovered provider models (#2464). Absent keeps legacy "on" behavior. */
583
580
  modelDiscovery?: {
584
- newModelPolicy?: "on" | "off";
581
+ /** `admit` appends arrivals to custom provider selections (#8236); default `on`. */
582
+ newModelPolicy?: "on" | "off" | "admit";
585
583
  knownModels?: Record<string, {
586
584
  ids: string[];
587
585
  removed: string[];
@@ -589,7 +587,14 @@ export interface OcxConfig {
589
587
  /** Consecutive successful discoveries in which an active id was absent. */
590
588
  missing?: Record<string, number>;
591
589
  }>;
592
- recentArrivals?: Record<string, Array<{ id: string; at: string }>>;
590
+ recentArrivals?: Record<string, Array<{
591
+ id: string;
592
+ at: string;
593
+ /** Appended to the provider's custom selection by the `admit` policy. */
594
+ admitted?: boolean;
595
+ /** Whether the `off` policy disabled it; absent on rows recorded before #8236. */
596
+ disabledByPolicy?: boolean;
597
+ }>>;
593
598
  };
594
599
  /** Enable the shipped model alias patterns for providers without an override. */
595
600
  defaultModelAliases?: boolean;
@@ -936,13 +941,8 @@ export interface OcxConfig {
936
941
  * Unset or omitted by default.
937
942
  */
938
943
  blockedModelRedirects?: Record<string, string>;
939
- /**
940
- * 3-state multi-agent surface override:
941
- * - "v1": force ALL models to v1 surface (override upstream pins)
942
- * - "default" | undefined: respect upstream model pins (sol/terra=v2, luna=v1, rest=codex flag)
943
- * - "v2": force ALL models to v2 surface (override upstream pins)
944
- */
945
- multiAgentMode?: "v1" | "default" | "v2";
944
+ /** Multi-agent surface override; mode selection and consent follow MultiAgentMode. */
945
+ multiAgentMode?: MultiAgentMode;
946
946
  /**
947
947
  * Which revision of the sub-agent surface advisory this install has answered.
948
948
  * Absent means it has answered none. Written by the dashboard, never by a mode change.
@@ -951,6 +951,7 @@ export interface OcxConfig {
951
951
  /**
952
952
  * When `multiAgentMode` is `"v2"`, keep ChatGPT-native catalog rows on v1.
953
953
  * Routed parents get v2 tools; Sol/Terra can still spawn Grok/Claude (issue #92).
954
+ * Stored but inactive under `"v2-plaintext"`, which pins ChatGPT-native rows on v2.
954
955
  */
955
956
  keepNativeChatGptOnV1?: boolean;
956
957
  /** Experimental plaintext delivery for native v2 collaboration messages; disabled unless true. */
@@ -1069,8 +1070,9 @@ export interface OcxConfig {
1069
1070
  connectTimeoutMs?: number;
1070
1071
  /** Graceful shutdown drain timeout (ms). Active turns are aborted after this deadline. Default 5000. */
1071
1072
  shutdownTimeoutMs?: number;
1072
- /** Advertise supports_websockets so Codex opens the WS endpoint. Default false; set true to opt in. */
1073
- websockets?: boolean;
1073
+ /** Advertise supports_websockets so Codex opens the WS endpoint. Default false; set true to opt in. */ websockets?: boolean;
1074
+ /** Accept the Responses WebSocket from linked Children over the Remote Link. Default false; needs websockets too. */ linkResponsesWebsocket?: boolean;
1075
+ /** On a Remote Link Child: true keeps Codex on HTTP over the link even when the Home offers the link WebSocket. Default: follow the Home. */ linkResponsesWebsocketOptOut?: boolean;
1074
1076
  /** Experimental single-lane native OpenAI WebSocket steering; default off. */
1075
1077
  codexNativeSteering?: boolean;
1076
1078
  /** Experimental, default-off saved function-result injection on native multi-agent WebSockets. */
@@ -1411,6 +1413,19 @@ export interface OcxConfig {
1411
1413
  tokenGuardian?: OcxTokenGuardianConfig;
1412
1414
  /** Additional exact origins allowed for CORS (e.g. HTTPS or chrome-extension://<id>). Loopback origins are always allowed. */
1413
1415
  corsAllowOrigins?: string[];
1416
+ /**
1417
+ * #8338, opt-in, standalone only: the one reverse proxy a dashboard may sit behind and still
1418
+ * remember devices. `origin` is the exact https origin the browser uses; `proxyAddresses` are
1419
+ * the proxy hop's own IP addresses as this process observes them (never a range); and
1420
+ * `trustHeaders` names the forwarded headers that carry the browser's host and scheme (default:
1421
+ * Host only, scheme from `origin`). Absent, Remember stays direct HTTPS or loopback only. Parsed by
1422
+ * src/config/dashboard-trusted-proxy.ts; enforced in managementRequestOrigin (src/server/auth-cors.ts).
1423
+ */
1424
+ dashboardTrustedProxy?: {
1425
+ origin: string;
1426
+ proxyAddresses: string[];
1427
+ trustHeaders?: Array<"x-forwarded-host" | "x-forwarded-proto">;
1428
+ };
1414
1429
  /**
1415
1430
  * OCX-11 fallback off: refuse model or provider fallback per scope, and record per-device local
1416
1431
  * fallback permission. Absent keeps every chain as it was. See src/routing/fallback-policy.ts.
@@ -1746,6 +1761,8 @@ export interface OcxAdvisorConfig {
1746
1761
  * or a tool result after the latest user message).
1747
1762
  */
1748
1763
  policy?: "manual" | "preflight" | "adaptive";
1764
+ /** question-only sends only the worker's explicit question and disables automatic consultations. */
1765
+ contextMode?: "context" | "question-only";
1749
1766
  /** Adaptive task consultation attempts (manual + automatic). Integer 1–3, default 3. */
1750
1767
  maxConsultationsPerTask?: number;
1751
1768
  /** Advisor fetch timeout (ms). Default 120000. */
@@ -1826,6 +1843,13 @@ export interface OcxCodexPoolConfig {
1826
1843
  startIdleWindows?: boolean;
1827
1844
  /** Enable process-local affinity for caller-owned credentials; defaults off. */
1828
1845
  requestOwnedAffinity?: boolean;
1846
+ /**
1847
+ * Pool-only policy (#7410); defaults off. When true, automatic Pool resolution serves only
1848
+ * registered, eligible non-main accounts: no ordered or preserved native main, no caller-main
1849
+ * fallback, and a manual main pin is not honoured. An exhausted allowed pool refuses. Explicit
1850
+ * account selectors (including `__main__` and Reserve) and Direct mode stay outside the policy.
1851
+ */
1852
+ poolOnly?: boolean;
1829
1853
  /**
1830
1854
  * Plan keys ordinary rotation skips, matched case-insensitively against the plan stored on each
1831
1855
  * account. Absent or empty means no policy.
@@ -0,0 +1,20 @@
1
+ /** A link-mode Child's saved tunnel: the local port its link reaches the Home through. */
2
+ export interface OcxLinkTransportConfig {
3
+ tunnelPort: number;
4
+ linkId: string;
5
+ }
6
+
7
+ /** Home-side Remote Link settings. */
8
+ export interface OcxLinkHomeConfig {
9
+ /**
10
+ * Whether this Home tells its Children it accepts per-body zstd request bodies (#3023). Absent or
11
+ * true: it does, and a Child compresses bodies above 1 KiB. False: it stops naming the capability,
12
+ * and its Children send identity bodies exactly as before it existed. Read at proxy start.
13
+ *
14
+ * Compression lets someone who can both put chosen text into a request body beside a secret and
15
+ * see the sizes of many such requests guess the secret from how well each one compresses. On a
16
+ * link that is whoever sees its traffic: a relay operator or anyone on the network path, because
17
+ * the tunnel hides content but not sizes.
18
+ */
19
+ linkRequestCompression?: boolean;
20
+ }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Multi-agent surface override:
3
+ * - "v1": force ALL models to v1 surface (override upstream pins)
4
+ * - "default" | undefined: respect upstream model pins (sol/terra=v2, luna=v1, rest=codex flag)
5
+ * - "v2": force ALL models to v2 surface (override upstream pins)
6
+ * - "v2-plaintext": force ALL models to v2 surface via catalog pins while the global
7
+ * `multi_agent_v2` feature stays disabled. Selecting the mode is itself the explicit
8
+ * opt-in to plaintext delivery of native v2 collaboration messages; the separate
9
+ * `plaintextV2AgentMessages` flag is not required and is never rewritten by a mode change.
10
+ * The "v2-plaintext" literal must never be written into `multi_agent_version`,
11
+ * whose values Codex validates.
12
+ */
13
+ export type MultiAgentMode = "v1" | "default" | "v2" | "v2-plaintext";
@@ -10,6 +10,21 @@ import type { AnthropicAccountPoolConfig } from "./anthropic-account-pool";
10
10
  */
11
11
  export type RefreshPolicy = "proactive" | "lazy-only" | "disabled";
12
12
 
13
+ /**
14
+ * Per-provider conversation affinity to the credential that served a conversation's
15
+ * last turn, so that credential's upstream prompt cache is read again instead of
16
+ * rebuilt on another key. `auto` keeps a binding only while the cache it built is
17
+ * measured to be worth keeping and still warm; `session` keeps it while the
18
+ * credential stays eligible; `turn` only across immediate continuations; `off`
19
+ * disables binding entirely. See src/providers/cache-affinity.ts.
20
+ */
21
+ export type CacheAffinityMode = "auto" | "session" | "turn" | "off";
22
+
23
+ /** Provider cache-affinity outcome recorded on a request-log row. */
24
+ export type CacheAffinityOutcome = "kept" | "bound" | "released";
25
+ /** Why that outcome happened; mirrors the store's keep reasons plus lifecycle outcomes. */
26
+ export type CacheAffinityLogReason = "cache" | "session" | "turn" | "continuation" | "new" | "quota" | "auth";
27
+
13
28
  /** Request-owned identity of the configured key, before env/keychain resolution. */
14
29
  export interface ProviderApiKeySelection {
15
30
  entryId?: string;
@@ -17,6 +32,10 @@ export interface ProviderApiKeySelection {
17
32
  revision?: string;
18
33
  /** Request-local allocation; does not replace the saved active key. */
19
34
  distributed?: boolean;
35
+ /** Request-local cache-affinity pick; survives selection re-reads while its entry stays live. */
36
+ cacheAffinity?: boolean;
37
+ /** Opaque process-local credential and destination generation for an affinity pick. */
38
+ cacheAffinityGeneration?: string;
20
39
  }
21
40
 
22
41
  export interface OpenRouterProviderRouting {
@@ -296,6 +315,8 @@ export interface ModelCapabilities extends ReasoningCapabilities {
296
315
  deepseekImageFiles?: boolean;
297
316
  /** Images a first-party Mistral Chat request may carry for this model; older ones are pruned. */
298
317
  mistralMaxImages?: number;
318
+ /** Exact-model Responses custom-tool support; absent inherits the provider contract. */
319
+ responsesCustomTools?: boolean;
299
320
  }
300
321
 
301
322
  /**
@@ -313,6 +334,12 @@ export interface OcxProviderConfig {
313
334
  alias?: string;
314
335
  /** Native model id -> short, slash-free request alias. */
315
336
  modelAliases?: Record<string, string>;
337
+ /**
338
+ * Opt-in alias template for models without a manual or built-in alias (#7705), for example
339
+ * `{providerAlias}-{modelBasename}`. Derived at resolution time and never written back; only the
340
+ * literal `{providerAlias}` and `{modelBasename}` placeholders are allowed.
341
+ */
342
+ aliasTemplate?: string;
316
343
  /** Display-only labels for exact native model ids discovered under this provider. */
317
344
  modelDisplayNames?: Record<string, string>;
318
345
  /** Override the global built-in model-alias switch for this provider. */
@@ -649,8 +676,11 @@ export interface OcxProviderConfig {
649
676
  * visible. Empty/undefined = no opt-in (default behavior). See #1690.
650
677
  */
651
678
  retainModels?: string[];
652
- /** Override for newly discovered models. Absent/"inherit" uses the install policy. */
653
- newModelPolicy?: "on" | "off" | "inherit";
679
+ /**
680
+ * Override for newly discovered models. Absent/"inherit" uses the install policy. `admit`
681
+ * appends arrivals to a custom `selectedModels` (never a preset-derived one).
682
+ */
683
+ newModelPolicy?: "on" | "off" | "admit" | "inherit";
654
684
  /**
655
685
  * Model-preset marker for `selectedModels` (#2465). Absent means "all", exactly today's
656
686
  * semantics — an existing provider is never narrowed by an upgrade.
@@ -1060,6 +1090,14 @@ export interface OcxProviderConfig {
1060
1090
  * fields. Default off; only enable for providers that document this parameter.
1061
1091
  */
1062
1092
  promptCacheKey?: boolean;
1093
+ /**
1094
+ * Conversation affinity to the key-pool credential that served a conversation's
1095
+ * last turn, so its upstream prompt cache is read again on the next turn instead
1096
+ * of rebuilt on another key. Only affects providers with 2+ key-pool entries;
1097
+ * eligibility (cooldowns, pacing, disabled keys) always outranks the preference.
1098
+ * Default `auto`. See src/providers/cache-affinity.ts.
1099
+ */
1100
+ cacheAffinity?: CacheAffinityMode;
1063
1101
  /**
1064
1102
  * Opt-in: forward caller `service_tier` values to the upstream `/chat/completions` body.
1065
1103
  * On a classified route it governs foreign values (for example `flex`), not proxy-owned
@@ -1168,6 +1206,13 @@ export interface OcxProviderConfig {
1168
1206
  * other EOFs remain truncation errors. Absent = strict default behavior.
1169
1207
  */
1170
1208
  anthropicEofTolerance?: boolean;
1209
+ /**
1210
+ * Claude Code's typed Advisor server tool (`advisor_20260301`) on the translated Messages lane.
1211
+ * Absent: forwarded only to an `anthropic`-adapter provider on first-party `api.anthropic.com`.
1212
+ * `true`: an Anthropic-compatible gateway that runs it receives the declaration, its history and
1213
+ * the `advisor-tool-2026-03-01` beta too. `false`: never forwarded, even first-party.
1214
+ */
1215
+ forwardAdvisorTool?: boolean;
1171
1216
  /**
1172
1217
  * Model ids that do NOT accept image inputs. The proxy gives them "eyes" via the vision sidecar:
1173
1218
  * attached images are described by a gpt vision model and replaced with text before the call.
@@ -93,6 +93,8 @@ export interface OcxParsedRequest {
93
93
  * adapter ends a system block there so the breakpoint stays off the per-turn tail.
94
94
  */
95
95
  _anthropicSystemCachePrefix?: string;
96
+ /** The request arrived on the Anthropic Messages surface (Claude Code, Claude Desktop). */
97
+ _anthropicInbound?: boolean;
96
98
  /**
97
99
  * Boundary between replayed history and this turn's newly appended input. Usually the
98
100
  * items the proxy restored from local previous_response_id state; also set when the
@@ -146,6 +148,8 @@ export interface OcxParsedRequest {
146
148
  _dropForeignReasoningItemIds?: boolean;
147
149
  /** Final-route opt-in: emit v2 collaboration message arguments as plaintext on ChatGPT. */
148
150
  _plaintextV2AgentMessages?: boolean;
151
+ _plaintextV2Decision?: boolean;
152
+ _plaintextV2EverPrepared?: boolean;
149
153
  /**
150
154
  * Optional authenticated tenant/operator namespace for Cursor thread→conversation derivation.
151
155
  * When absent (single-operator local proxy), derivation stays local-scoped.
package/src/types.ts CHANGED
@@ -122,6 +122,9 @@ export type {
122
122
 
123
123
  export type {
124
124
  RefreshPolicy,
125
+ CacheAffinityMode,
126
+ CacheAffinityOutcome,
127
+ CacheAffinityLogReason,
125
128
  OpenRouterProviderRouting,
126
129
  VercelGatewayRouting,
127
130
  ResponsesItemIdRepairConfig,
@@ -4,8 +4,7 @@ import { atomicWriteFile } from "../config/atomic-write";
4
4
  import { removePid, removeRuntimePort } from "../config/process-state";
5
5
  import { dropWindowsTcpRowsForLocalPort } from "../server/windows-tcp-drop";
6
6
  import { stopWinswService } from "../lib/winsw";
7
- import { stopWindows } from "../service";
8
- import { killWindowsSchedulerWrappers } from "../lib/windows-service-wrappers";
7
+ import { runWindowsServiceStopPartA } from "../service/windows-service-stop";
9
8
  import { guardedRun, guardedKill, guardedExecFileSync, materializeMutationData, UpdateMutationRefusedError, type UpdateMutationAuthorizer } from "./mutation-guard.mjs";
10
9
 
11
10
  export type KillProxy = typeof killProxy;
@@ -50,9 +49,8 @@ export function guardedDropWindowsTcp(authorize: (kind: "runtime") => boolean, p
50
49
  export function guardedStopWinsw(authorize: UpdateMutationAuthorizer) {
51
50
  return stopWinswService(mutationGate(authorize, "service"));
52
51
  }
53
- export function guardedStopWindows(authorize: UpdateMutationAuthorizer) {
54
- return stopWindows(mutationGate(authorize, "service"));
55
- }
56
- export function guardedKillWindowsWrappers(authorize: UpdateMutationAuthorizer, paths: Parameters<typeof killWindowsSchedulerWrappers>[0]) {
57
- return killWindowsSchedulerWrappers(materializeMutationData(paths), mutationGate(authorize, "service"));
52
+ /** Part A of the checked Windows stop (#7771), the service gate at entry and before each terminate. */
53
+ export async function guardedStopWindowsChecked(authorize: UpdateMutationAuthorizer) {
54
+ // The update worker descends from the service-run proxy, so its own wrapper is fair game.
55
+ return (await runWindowsServiceStopPartA({ authorize: mutationGate(authorize, "service"), allowUnderOwnWrapper: true })).outcome;
58
56
  }