@bitkyc08/opencodex 2.100.2 → 2.100.4

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 (644) hide show
  1. package/AGENTS_INSTALL.md +23 -1
  2. package/README.md +1 -1
  3. package/bin/ocx.mjs +40 -19
  4. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  5. package/gui/dist/assets/App-DcpyI78f.js +60 -0
  6. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-CzjPJprT.js} +1 -1
  7. package/gui/dist/assets/brand-mark-BTIi7e69.js +1 -0
  8. package/gui/dist/assets/index-DJxM-imn.css +2 -0
  9. package/gui/dist/assets/index-DVgU6S3y.js +138 -0
  10. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-Bn6Y-g3R.js} +1 -1
  11. package/gui/dist/classic/assets/App-eYJAyNHM.js +59 -0
  12. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-xHMYxLkV.js} +1 -1
  13. package/gui/dist/classic/assets/index-DSaVRW4F.js +138 -0
  14. package/gui/dist/classic/assets/quota-summary-DyzHlkFl.js +1 -0
  15. package/gui/dist/classic/index.html +1 -1
  16. package/gui/dist/index.html +2 -2
  17. package/native/ocx-child/Cargo.toml +9 -0
  18. package/native/ocx-child/src/cli.rs +404 -20
  19. package/native/ocx-child/src/codex_home.rs +99 -14
  20. package/native/ocx-child/src/daemon.rs +2 -1
  21. package/native/ocx-child/src/lib.rs +3 -0
  22. package/native/ocx-child/src/link_ws.rs +2598 -0
  23. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  24. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  25. package/native/ocx-child/src/parity.rs +5 -1
  26. package/native/ocx-child/src/platform.rs +152 -6
  27. package/native/ocx-child/src/relay.rs +150 -19
  28. package/package.json +3 -3
  29. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  30. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  31. package/src/adapters/anthropic/client-identity.ts +3 -1
  32. package/src/adapters/anthropic/passthrough.ts +9 -3
  33. package/src/adapters/anthropic/per-message-effort.ts +296 -0
  34. package/src/adapters/anthropic.ts +34 -14
  35. package/src/adapters/claude-cli/adapter.ts +1 -0
  36. package/src/adapters/client-fingerprint.ts +3 -3
  37. package/src/adapters/cursor/discovery.ts +17 -0
  38. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  39. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  40. package/src/adapters/cursor/protobuf-request.ts +8 -8
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/chat.ts +71 -14
  43. package/src/adapters/google-antigravity-wire.ts +7 -5
  44. package/src/adapters/google-errors.ts +14 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +9 -2
  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/qoder/adapter.ts +9 -1
  54. package/src/adapters/zed.ts +7 -2
  55. package/src/advisor/consult.ts +15 -4
  56. package/src/advisor/context.ts +12 -3
  57. package/src/advisor/runtime.ts +35 -5
  58. package/src/advisor/settings.ts +8 -0
  59. package/src/advisor/synthetic-tool.ts +21 -8
  60. package/src/bridge/response-json.ts +11 -2
  61. package/src/bridge/sse.ts +43 -8
  62. package/src/claude/auth-detect.ts +21 -33
  63. package/src/claude/desktop-3p.ts +11 -5
  64. package/src/claude/desktop-gateway-state.ts +2 -0
  65. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  66. package/src/claude/desktop-remote-store.ts +82 -12
  67. package/src/claude/inbound-content-options.ts +31 -16
  68. package/src/claude/outbound.ts +13 -3
  69. package/src/cli/account-api.ts +21 -1
  70. package/src/cli/account-auth.ts +83 -22
  71. package/src/cli/account-extended.ts +33 -2
  72. package/src/cli/account-key-quota.ts +34 -5
  73. package/src/cli/account.ts +4 -2
  74. package/src/cli/advisor.ts +7 -4
  75. package/src/cli/alias.ts +38 -1
  76. package/src/cli/capabilities-access-remote.ts +128 -3
  77. package/src/cli/capabilities-accounts.ts +6 -6
  78. package/src/cli/capabilities-agents-routing.ts +17 -10
  79. package/src/cli/capabilities-base.ts +49 -19
  80. package/src/cli/capabilities-integrations.ts +2 -2
  81. package/src/cli/capabilities-observe-system.ts +2 -2
  82. package/src/cli/capabilities-provider-models.ts +18 -2
  83. package/src/cli/capabilities-route-to.ts +43 -0
  84. package/src/cli/capabilities.ts +2 -0
  85. package/src/cli/capability-contracts.ts +1 -1
  86. package/src/cli/claude-desktop.ts +30 -11
  87. package/src/cli/claude.ts +17 -3
  88. package/src/cli/codex-launcher.ts +3 -1
  89. package/src/cli/codex-shim-autorestore.ts +5 -42
  90. package/src/cli/config-command.ts +14 -1
  91. package/src/cli/config-root-startup.ts +34 -0
  92. package/src/cli/connect.ts +88 -16
  93. package/src/cli/desktop-runtime-guidance.ts +1 -1
  94. package/src/cli/disconnect-runtime.ts +178 -0
  95. package/src/cli/dispatch.ts +61 -13
  96. package/src/cli/export-command.ts +1 -1
  97. package/src/cli/gui-pair-client.ts +6 -3
  98. package/src/cli/gui.ts +10 -5
  99. package/src/cli/help-catalog.ts +11 -0
  100. package/src/cli/help.ts +4 -3
  101. package/src/cli/index.ts +85 -94
  102. package/src/cli/inspect.ts +11 -2
  103. package/src/cli/integrations.ts +26 -1
  104. package/src/cli/link-apply-restart.ts +4 -2
  105. package/src/cli/link-capture.ts +64 -0
  106. package/src/cli/link-child-ops.ts +218 -40
  107. package/src/cli/link-cleanup.ts +8 -5
  108. package/src/cli/link-diagnostics.ts +67 -0
  109. package/src/cli/link-enrollment.ts +158 -12
  110. package/src/cli/link-operations.ts +52 -0
  111. package/src/cli/link-recover.ts +152 -0
  112. package/src/cli/link-routes.ts +90 -0
  113. package/src/cli/link-status-child.ts +44 -1
  114. package/src/cli/link-status-traffic.ts +34 -0
  115. package/src/cli/link.ts +315 -37
  116. package/src/cli/message-command.ts +1 -1
  117. package/src/cli/message-mcp-command.ts +23 -10
  118. package/src/cli/models-runtime.ts +3 -3
  119. package/src/cli/opencode.ts +3 -1
  120. package/src/cli/pi-sync.ts +35 -0
  121. package/src/cli/preflight-exemptions.ts +49 -0
  122. package/src/cli/registry.ts +33 -14
  123. package/src/cli/resolve.ts +23 -8
  124. package/src/cli/restart-failure.ts +15 -2
  125. package/src/cli/root.ts +5 -1
  126. package/src/cli/route-to.ts +172 -0
  127. package/src/cli/runtime-api.ts +9 -8
  128. package/src/cli/status.ts +7 -2
  129. package/src/cli/stop-approval.ts +66 -19
  130. package/src/cli/stop-report.ts +23 -0
  131. package/src/cli/stop-windows-checked.ts +304 -0
  132. package/src/cli/sync-command.ts +70 -15
  133. package/src/cli/sync-fanout.ts +74 -19
  134. package/src/cli/sync-flags.ts +40 -3
  135. package/src/cli/sync-link-status.ts +18 -2
  136. package/src/cli/sync-update-guard.ts +7 -2
  137. package/src/cli/system-command.ts +1 -1
  138. package/src/cli/system-restart-client.ts +10 -3
  139. package/src/cli/system-settings-parity.ts +2 -1
  140. package/src/cli/uninstall-plan.ts +77 -5
  141. package/src/cli/uninstall-stop.ts +152 -0
  142. package/src/cli/v2-input.ts +10 -6
  143. package/src/cli/v2-local-output.ts +3 -2
  144. package/src/cli/v2-runtime.ts +10 -3
  145. package/src/cli/v2.ts +22 -7
  146. package/src/client/connect.ts +376 -35
  147. package/src/client/desktop-refusal.ts +38 -0
  148. package/src/client/lifecycle-lock.ts +29 -4
  149. package/src/client/link-home-features.ts +27 -0
  150. package/src/client/link-home.ts +92 -4
  151. package/src/client/link-ingress.ts +21 -3
  152. package/src/client/link-join.ts +12 -2
  153. package/src/client/link-parity-reporter.ts +60 -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.ts +56 -5
  161. package/src/client/link-websocket-limits.ts +89 -0
  162. package/src/client/link-websocket.ts +586 -0
  163. package/src/client/link-ws-advertisement.ts +100 -0
  164. package/src/client/link-ws-framer.ts +241 -0
  165. package/src/client/link-ws-transport.ts +177 -0
  166. package/src/client/machine-api.ts +13 -2
  167. package/src/client/machine-listener.ts +48 -7
  168. package/src/client/route-intent-apply.ts +293 -0
  169. package/src/client/route-intent-file-originals.ts +97 -0
  170. package/src/client/route-intent-native-originals.ts +201 -0
  171. package/src/client/route-intent-watch.ts +141 -0
  172. package/src/client/runtime-restart.ts +141 -7
  173. package/src/client/runtime.ts +63 -15
  174. package/src/client/state.ts +44 -0
  175. package/src/client/sync-expectation.ts +36 -2
  176. package/src/client/sync-runtime.ts +7 -0
  177. package/src/clients/config-export/alias-selectors.ts +63 -40
  178. package/src/clients/config-export/contracts.ts +2 -0
  179. package/src/clients/config-export/nested-selectors.ts +42 -0
  180. package/src/clients/config-export.ts +22 -3
  181. package/src/codex/account-pause.ts +4 -0
  182. package/src/codex/account-runtime-state.ts +4 -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/main-account-probe.ts +3 -1
  187. package/src/codex/auth-api/main-hard-lock-refusal-read.ts +172 -0
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +61 -8
  190. package/src/codex/catalog/build-entries.ts +10 -0
  191. package/src/codex/catalog/derive-entry.ts +7 -0
  192. package/src/codex/catalog/gather-capture.ts +8 -2
  193. package/src/codex/catalog/parsing.ts +7 -3
  194. package/src/codex/catalog/provider-models.ts +54 -15
  195. package/src/codex/catalog/reserve-warn.ts +7 -5
  196. package/src/codex/catalog/reserve.ts +4 -3
  197. package/src/codex/catalog/retained-sync.ts +4 -1
  198. package/src/codex/catalog/routed-defaults.ts +35 -0
  199. package/src/codex/catalog/routed-gather.ts +1 -1
  200. package/src/codex/catalog-auto-refresh.ts +11 -0
  201. package/src/codex/cli-update-job.ts +35 -13
  202. package/src/codex/convergence.ts +4 -2
  203. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  204. package/src/codex/features.ts +2 -2
  205. package/src/codex/history-provider.ts +31 -0
  206. package/src/codex/inject/multi-agent-v2.ts +9 -3
  207. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  208. package/src/codex/inject/plan.ts +20 -2
  209. package/src/codex/inject.ts +2 -0
  210. package/src/codex/journal-config-restore.ts +217 -0
  211. package/src/codex/journal.ts +75 -6
  212. package/src/codex/loopback-target.ts +22 -8
  213. package/src/codex/main-account.ts +109 -57
  214. package/src/codex/native-main-auth-file.ts +118 -0
  215. package/src/codex/native-main-credentials.ts +270 -0
  216. package/src/codex/native-main-owner.ts +3 -0
  217. package/src/codex/native-main-refresh-mode.ts +14 -1
  218. package/src/codex/native-profile-manager.ts +4 -3
  219. package/src/codex/native-profile-store.ts +3 -61
  220. package/src/codex/orca-import.ts +10 -1
  221. package/src/codex/quota-history.ts +13 -0
  222. package/src/codex/quota-window-conflict.ts +103 -0
  223. package/src/codex/quota.ts +86 -15
  224. package/src/codex/subagent-model-fallback.ts +3 -1
  225. package/src/codex/websocket-activity.ts +171 -16
  226. package/src/codex/websocket-registry.ts +11 -4
  227. package/src/combos/cooldown-store.ts +25 -5
  228. package/src/combos/failover.ts +342 -3
  229. package/src/combos/index.ts +5 -0
  230. package/src/combos/resolve.ts +115 -19
  231. package/src/config/dashboard-trusted-proxy.ts +83 -0
  232. package/src/config/diagnostics.ts +31 -0
  233. package/src/config/feature-flags.ts +9 -0
  234. package/src/config/live-reconcile.ts +16 -4
  235. package/src/config/load-degrade.ts +14 -1
  236. package/src/config/multi-agent-surface.ts +28 -5
  237. package/src/config/pending-teardown.ts +60 -3
  238. package/src/config/persisted-mutation.ts +2 -2
  239. package/src/config/persisted-projections.ts +18 -0
  240. package/src/config/process-state.ts +176 -4
  241. package/src/config/provider-validation.ts +4 -4
  242. package/src/config/reserve-capability.ts +96 -0
  243. package/src/config/schema/config-schema.ts +12 -0
  244. package/src/config/schema/leaf-validators.ts +11 -2
  245. package/src/config/schema/routed-catalog-defaults.ts +49 -0
  246. package/src/config/windows-process-command-line.ts +107 -0
  247. package/src/config.ts +7 -7
  248. package/src/desktop-update/acquire.ts +202 -0
  249. package/src/desktop-update/cli.ts +168 -0
  250. package/src/desktop-update/drain.ts +40 -0
  251. package/src/desktop-update/headless.ts +285 -0
  252. package/src/desktop-update/image.ts +85 -0
  253. package/src/desktop-update/install.ts +53 -0
  254. package/src/desktop-update/msi.ts +72 -0
  255. package/src/desktop-update/release.ts +128 -0
  256. package/src/desktop-update/runtime.ts +155 -0
  257. package/src/desktop-update/staging.ts +118 -0
  258. package/src/desktop-update/trust.ts +45 -0
  259. package/src/generated/compatibility-version.json +1114 -442
  260. package/src/generated/model-metadata.ts +1 -1
  261. package/src/images/fulfill-video.ts +3 -3
  262. package/src/images/loop.ts +9 -2
  263. package/src/images/plan.ts +147 -11
  264. package/src/images/types.ts +13 -4
  265. package/src/images/xai-video-client.ts +72 -10
  266. package/src/integrations/model-name-guard.ts +25 -0
  267. package/src/integrations/route-intent-catalog.ts +26 -0
  268. package/src/integrations/route-intent-connected.ts +262 -0
  269. package/src/integrations/route-intent-contract.ts +55 -0
  270. package/src/integrations/route-intent-disconnect.ts +109 -0
  271. package/src/integrations/route-intent-initial.ts +64 -0
  272. package/src/integrations/route-intent-state.ts +117 -0
  273. package/src/integrations/route-intent-tick.ts +65 -0
  274. package/src/integrations/route-intent.ts +212 -0
  275. package/src/integrations/writer.ts +44 -11
  276. package/src/lib/client-retry-after.ts +29 -0
  277. package/src/lib/config-ownership.ts +13 -0
  278. package/src/lib/desktop-gui-origin.ts +28 -0
  279. package/src/lib/errors.ts +1 -1
  280. package/src/lib/gcp-adc.ts +48 -4
  281. package/src/lib/gui-pair-capability.ts +2 -1
  282. package/src/lib/messages-error-body.ts +4 -1
  283. package/src/lib/offline-resend.ts +150 -0
  284. package/src/lib/outbound-credential-registry.ts +362 -4
  285. package/src/lib/paced-stream.ts +34 -0
  286. package/src/lib/passive-key-fetch-proof.ts +30 -0
  287. package/src/lib/passive-read.ts +5 -0
  288. package/src/lib/process-control.ts +76 -12
  289. package/src/lib/provider-outbound.ts +17 -6
  290. package/src/lib/redact.ts +84 -8
  291. package/src/lib/request-failure-model.ts +2 -0
  292. package/src/lib/response-body-inactivity.ts +23 -1
  293. package/src/lib/state-store-registrations.ts +11 -0
  294. package/src/lib/state-store-sweeper.ts +4 -0
  295. package/src/lib/supervisor-markers.ts +18 -0
  296. package/src/lib/terminal-safe-text.ts +58 -0
  297. package/src/lib/translator-budget.ts +3 -2
  298. package/src/lib/upstream-retry.ts +52 -9
  299. package/src/link/alias-lock.ts +119 -0
  300. package/src/link/child-activity.ts +28 -2
  301. package/src/link/child-binary-cache-fill.d.mts +50 -0
  302. package/src/link/child-binary-cache-fill.mjs +494 -0
  303. package/src/link/child-binary-cache-start.ts +73 -0
  304. package/src/link/child-binary-source.ts +12 -5
  305. package/src/link/child-gated-ocx.ts +29 -11
  306. package/src/link/child-observations.ts +2 -1
  307. package/src/link/child-observe.ts +2 -2
  308. package/src/link/child-ops-engine.ts +159 -91
  309. package/src/link/child-ops-host.ts +138 -0
  310. package/src/link/child-ops-runners.ts +319 -0
  311. package/src/link/child-ops-scheduler.ts +207 -0
  312. package/src/link/child-ops-types.ts +89 -0
  313. package/src/link/child-parity.ts +23 -4
  314. package/src/link/child-policy.ts +93 -0
  315. package/src/link/child-update-contract.ts +12 -3
  316. package/src/link/codex-settings.ts +1 -1
  317. package/src/link/compatibility.ts +18 -1
  318. package/src/link/diagnostics-read.ts +163 -0
  319. package/src/link/diagnostics.ts +20 -7
  320. package/src/link/explicit-route.ts +209 -0
  321. package/src/link/link-recover.ts +113 -0
  322. package/src/link/management-routes.ts +3 -1
  323. package/src/link/operation-recovery-slot.ts +44 -0
  324. package/src/link/operations-journal.ts +408 -0
  325. package/src/link/peer-report.ts +1 -1
  326. package/src/link/relay-auth.ts +14 -0
  327. package/src/link/remote-plant.ts +152 -14
  328. package/src/link/remote-platform.ts +21 -10
  329. package/src/link/remote-probe.ts +11 -3
  330. package/src/link/remote-windows.ts +124 -36
  331. package/src/link/request-compression.ts +30 -0
  332. package/src/link/residual-recovery.ts +66 -0
  333. package/src/link/retirement.ts +128 -0
  334. package/src/link/route-intent-watch.ts +41 -0
  335. package/src/link/route-intent.ts +209 -0
  336. package/src/link/route-proof.ts +82 -0
  337. package/src/link/route-rounds.ts +579 -0
  338. package/src/link/route-select.ts +95 -0
  339. package/src/link/route-trust.ts +96 -0
  340. package/src/link/ssh-argv.ts +172 -24
  341. package/src/link/ssh-capture-redact.ts +253 -0
  342. package/src/link/ssh-capture.ts +497 -0
  343. package/src/link/ssh-runner.ts +141 -14
  344. package/src/link/status-projection.ts +87 -0
  345. package/src/link/store.ts +54 -1
  346. package/src/link/supervisor.ts +543 -55
  347. package/src/link/sync-fanout-classify.ts +16 -0
  348. package/src/link/sync-then-restart.ts +65 -0
  349. package/src/link/tombstones.ts +209 -0
  350. package/src/link/traffic.ts +178 -0
  351. package/src/link/ws-activity-holds.ts +474 -0
  352. package/src/local-credentials/publication-fence.ts +20 -1
  353. package/src/messaging/budget.ts +23 -5
  354. package/src/messaging/mcp-queue-rpc.ts +1 -1
  355. package/src/messaging/mcp-queue-server.ts +16 -1
  356. package/src/messaging/mcp-resume-tools.ts +25 -0
  357. package/src/messaging/remote-enrollment.ts +3 -3
  358. package/src/messaging/remote-tunnels.ts +2 -2
  359. package/src/messaging/resume-permissions.ts +27 -0
  360. package/src/messaging/rpc.ts +50 -6
  361. package/src/oauth/anthropic-continuity.ts +23 -7
  362. package/src/oauth/anthropic-routing.ts +5 -2
  363. package/src/oauth/anthropic.ts +22 -2
  364. package/src/oauth/antigravity-risk.ts +126 -0
  365. package/src/oauth/claude-keychain-read.ts +78 -68
  366. package/src/oauth/generic-account-failover.ts +89 -18
  367. package/src/oauth/generic-session-affinity.ts +10 -3
  368. package/src/oauth/index.ts +24 -6
  369. package/src/oauth/local-token-detect.ts +8 -29
  370. package/src/oauth/login-cli-errors.ts +5 -1
  371. package/src/oauth/login-cli.ts +68 -19
  372. package/src/oauth/login-flow-state.ts +26 -3
  373. package/src/oauth/meta-muse.ts +1 -1
  374. package/src/oauth/pool-kernel.ts +3 -3
  375. package/src/oauth/store.ts +7 -0
  376. package/src/oauth/xai.ts +248 -14
  377. package/src/protocols/contract.ts +4 -0
  378. package/src/protocols/encoders/messages.ts +1 -0
  379. package/src/providers/alias-template.ts +48 -0
  380. package/src/providers/anthropic-billing-ownership.ts +2 -0
  381. package/src/providers/anthropic-billing-refusal.ts +27 -3
  382. package/src/providers/anthropic-output-caps.ts +46 -0
  383. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  384. package/src/providers/antigravity-effort-families.ts +11 -3
  385. package/src/providers/antigravity-models.ts +32 -9
  386. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  387. package/src/providers/api-key-pause.ts +3 -0
  388. package/src/providers/api-key-resolve.ts +49 -7
  389. package/src/providers/api-key-response-ownership.ts +2 -0
  390. package/src/providers/api-key-selection.ts +51 -9
  391. package/src/providers/api-keys.ts +6 -2
  392. package/src/providers/cache-affinity-identity.ts +73 -0
  393. package/src/providers/cache-affinity.ts +256 -0
  394. package/src/providers/default-aliases.ts +98 -20
  395. package/src/providers/google-vertex-model-discovery.ts +515 -0
  396. package/src/providers/key-failover.ts +123 -8
  397. package/src/providers/key-store.ts +3 -3
  398. package/src/providers/kiro-models.ts +3 -5
  399. package/src/providers/label.ts +31 -5
  400. package/src/providers/mistral-transport.ts +17 -4
  401. package/src/providers/model-rename-fields.ts +5 -0
  402. package/src/providers/muse-key-quota.ts +14 -6
  403. package/src/providers/new-model-policy-runtime.ts +17 -4
  404. package/src/providers/new-model-policy.ts +30 -4
  405. package/src/providers/passive-key-observation.ts +252 -0
  406. package/src/providers/quota/account-cache.ts +2 -1
  407. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  408. package/src/providers/quota/passive-key-limits.ts +272 -0
  409. package/src/providers/quota/passive-wire-model.ts +126 -0
  410. package/src/providers/quota/report-cache.ts +61 -2
  411. package/src/providers/quota/workbuddy.ts +6 -2
  412. package/src/providers/quota-key-accounts.ts +11 -6
  413. package/src/providers/quota-types.ts +18 -0
  414. package/src/providers/quota.ts +11 -12
  415. package/src/providers/registry/entries-core.ts +34 -16
  416. package/src/providers/registry/entries-extended.ts +32 -0
  417. package/src/providers/registry/model-seeds.ts +35 -0
  418. package/src/providers/resolved-model-policy.ts +7 -0
  419. package/src/providers/routed-config.ts +8 -3
  420. package/src/providers/workbuddy-credit-balance.ts +125 -16
  421. package/src/providers/xai-transport.ts +3 -0
  422. package/src/remote/features.ts +17 -0
  423. package/src/responses/anthropic-progress.ts +10 -4
  424. package/src/responses/citation-markers.ts +231 -0
  425. package/src/responses/effort-history.ts +732 -0
  426. package/src/responses/spill-store.ts +5 -1
  427. package/src/responses/state/replay-input.ts +50 -0
  428. package/src/responses/state/replay-owner.ts +24 -0
  429. package/src/responses/state/snapshot-codec.ts +9 -0
  430. package/src/responses/state/spill-queue.ts +1 -0
  431. package/src/responses/state.ts +42 -60
  432. package/src/router.ts +2 -2
  433. package/src/routing/history/integrity.ts +41 -4
  434. package/src/routing/home-route-capture.ts +123 -0
  435. package/src/routing/home-route-intent.ts +200 -0
  436. package/src/routing/route-intent-state.ts +178 -0
  437. package/src/routing/route-to-live-settings.ts +35 -0
  438. package/src/routing/route-to-local.ts +145 -0
  439. package/src/routing/route-to-status.ts +94 -0
  440. package/src/routing/route-to-sync-child.ts +32 -0
  441. package/src/server/adapter-resolve.ts +21 -1
  442. package/src/server/admitted-http-turn.ts +3 -0
  443. package/src/server/auth-cors.ts +111 -3
  444. package/src/server/bare-upstream-error.ts +220 -0
  445. package/src/server/chat-native.ts +14 -5
  446. package/src/server/claude-messages.ts +6 -4
  447. package/src/server/codex-model-list.ts +4 -2
  448. package/src/server/configured-credentials.ts +37 -5
  449. package/src/server/direct-local-http.ts +26 -3
  450. package/src/server/gui-desktop-authorization.ts +36 -0
  451. package/src/server/gui-pair-delivery.ts +6 -3
  452. package/src/server/gui-session.ts +10 -1
  453. package/src/server/inbound-body-admission.ts +17 -4
  454. package/src/server/index/link-listener.ts +196 -12
  455. package/src/server/index/link-management.ts +15 -1
  456. package/src/server/index/link-relay-sessions.ts +87 -8
  457. package/src/server/index/link-websocket-limits.ts +136 -0
  458. package/src/server/index/link-websocket.ts +692 -0
  459. package/src/server/index/optional-listeners.ts +97 -7
  460. package/src/server/index/route-intent-watch.ts +47 -0
  461. package/src/server/index/serve-contract.ts +86 -0
  462. package/src/server/index/serve-options.ts +36 -86
  463. package/src/server/index/startup-warnings.ts +8 -2
  464. package/src/server/index/websocket-handler.ts +26 -4
  465. package/src/server/index.ts +15 -4
  466. package/src/server/inference/client-encoder-delivery.ts +2 -0
  467. package/src/server/inspection-tee.ts +39 -2
  468. package/src/server/lifecycle.ts +2 -0
  469. package/src/server/link-turn.ts +149 -0
  470. package/src/server/management/advisor-routes.ts +10 -2
  471. package/src/server/management/agent-settings-routes.ts +50 -16
  472. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  473. package/src/server/management/config-routes.ts +39 -3
  474. package/src/server/management/context.ts +9 -2
  475. package/src/server/management/desktop-authorization.ts +41 -0
  476. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  477. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  478. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  479. package/src/server/management/home-integration-decision.ts +89 -0
  480. package/src/server/management/integration-routes.ts +208 -81
  481. package/src/server/management/link-child-ops-routes.ts +145 -43
  482. package/src/server/management/link-child-preflight.ts +31 -0
  483. package/src/server/management/link-diagnostics-route.ts +29 -0
  484. package/src/server/management/link-enrollment.ts +199 -47
  485. package/src/server/management/link-operation.ts +609 -0
  486. package/src/server/management/link-recover-route.ts +103 -0
  487. package/src/server/management/link-route-edit.ts +192 -0
  488. package/src/server/management/link-route-request.ts +62 -0
  489. package/src/server/management/link-route-state.ts +83 -7
  490. package/src/server/management/link-routes.ts +553 -51
  491. package/src/server/management/link-traffic-status.ts +13 -0
  492. package/src/server/management/model-routes.ts +122 -36
  493. package/src/server/management/model-rows.ts +2 -1
  494. package/src/server/management/native-integration-routes.ts +176 -70
  495. package/src/server/management/oauth-account-routes.ts +58 -18
  496. package/src/server/management/protocol-routes.ts +7 -0
  497. package/src/server/management/provider-completion-test.ts +4 -4
  498. package/src/server/management/provider-overwrite-carry.ts +14 -0
  499. package/src/server/management/provider-routes.ts +68 -65
  500. package/src/server/management/provider-routing-quota.ts +45 -0
  501. package/src/server/management/route-registry.ts +22 -3
  502. package/src/server/management/route-to-routes.ts +257 -0
  503. package/src/server/management/static-catalog-probe.ts +33 -0
  504. package/src/server/management/system-restart.ts +4 -2
  505. package/src/server/management/usage-aggregate-cache.ts +101 -66
  506. package/src/server/management-api.ts +17 -3
  507. package/src/server/management-auth.ts +13 -1
  508. package/src/server/messages-native-preflight.ts +27 -4
  509. package/src/server/messages-native.ts +17 -5
  510. package/src/server/persistent-gui-session.ts +6 -3
  511. package/src/server/proxy-liveness.ts +87 -15
  512. package/src/server/relay-eager.ts +36 -12
  513. package/src/server/relay.ts +189 -117
  514. package/src/server/request-body-facts.ts +48 -0
  515. package/src/server/request-decompress.ts +65 -2
  516. package/src/server/request-log-account-rotation.ts +6 -0
  517. package/src/server/request-log-attempt-usage.ts +69 -0
  518. package/src/server/request-log-cache-affinity.ts +60 -0
  519. package/src/server/request-log-conversation.ts +45 -2
  520. package/src/server/request-log-terminal-status.ts +210 -24
  521. package/src/server/request-log.ts +76 -80
  522. package/src/server/reserve-capability-startup.ts +32 -0
  523. package/src/server/responses/adapter-continuation.ts +2 -1
  524. package/src/server/responses/adapter-delivery.ts +4 -0
  525. package/src/server/responses/adapter-dispatch.ts +36 -17
  526. package/src/server/responses/advisor-plan-slot.ts +33 -1
  527. package/src/server/responses/advisor-question.ts +21 -0
  528. package/src/server/responses/advisor-slot.ts +10 -3
  529. package/src/server/responses/antigravity-fault-rotation.ts +24 -0
  530. package/src/server/responses/antigravity-validation-refusal.ts +43 -6
  531. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  532. package/src/server/responses/buffered-sse-json.ts +9 -3
  533. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  534. package/src/server/responses/codex-tool-catalog.ts +156 -0
  535. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  536. package/src/server/responses/combo-selection-keepalive.ts +254 -0
  537. package/src/server/responses/combo-stream-preflight.ts +557 -54
  538. package/src/server/responses/compact.ts +32 -8
  539. package/src/server/responses/core-codex-account.ts +17 -3
  540. package/src/server/responses/core-combo-failure.ts +8 -0
  541. package/src/server/responses/core-combo.ts +55 -12
  542. package/src/server/responses/core-errors.ts +13 -7
  543. package/src/server/responses/core-lifetime.ts +3 -2
  544. package/src/server/responses/core-normalize.ts +3 -1
  545. package/src/server/responses/core-options.ts +14 -0
  546. package/src/server/responses/core.ts +23 -0
  547. package/src/server/responses/estimated-usage.ts +115 -0
  548. package/src/server/responses/fetch-helpers.ts +15 -10
  549. package/src/server/responses/jev-model-invoke.ts +7 -2
  550. package/src/server/responses/native-replay-guard.ts +57 -0
  551. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  552. package/src/server/responses/outbound-request-body.ts +29 -0
  553. package/src/server/responses/passthrough-completion.ts +109 -9
  554. package/src/server/responses/passthrough-delivery.ts +77 -18
  555. package/src/server/responses/passthrough-dispatch.ts +77 -73
  556. package/src/server/responses/policy-fallback.ts +13 -1
  557. package/src/server/responses/request-prepare.ts +59 -11
  558. package/src/server/responses/request-transport.ts +10 -3
  559. package/src/server/responses/reset-replay.ts +46 -2
  560. package/src/server/responses/run-turn-execution.ts +2 -0
  561. package/src/server/responses/sidecar-execution.ts +19 -0
  562. package/src/server/responses/terminal-error-redaction.ts +222 -25
  563. package/src/server/responses/ws-upstream.ts +2 -2
  564. package/src/server/sse-payload-rewrite.ts +3 -2
  565. package/src/server/stop-service-route.ts +85 -0
  566. package/src/server/system-env-shell.ts +12 -1
  567. package/src/server/system-env.ts +5 -3
  568. package/src/server/windows-tcp-drop.ts +21 -4
  569. package/src/server/workflow-refusal.ts +8 -0
  570. package/src/server/ws-bridge.ts +191 -12
  571. package/src/service/cli-windows-stop.ts +189 -0
  572. package/src/service/cli.ts +41 -12
  573. package/src/service/desktop-supervision.d.mts +2 -0
  574. package/src/service/desktop-supervision.mjs +5 -0
  575. package/src/service/disconnected-client-restart.ts +60 -0
  576. package/src/service/guarded-manager-target.ts +18 -1
  577. package/src/service/health.ts +99 -6
  578. package/src/service/launchd.ts +84 -31
  579. package/src/service/orchestration.ts +418 -91
  580. package/src/service/repair.ts +223 -6
  581. package/src/service/restart-proxy-stop.ts +79 -0
  582. package/src/service/service-child-ownership.ts +6 -2
  583. package/src/service/windows-checked-stop-live.ts +467 -0
  584. package/src/service/windows-checked-stop.ts +435 -0
  585. package/src/service/windows-command-line-token.ts +23 -0
  586. package/src/service/windows-guarded-manager.ts +77 -34
  587. package/src/service/windows-ops.ts +38 -56
  588. package/src/service/windows-process-evidence.ts +292 -0
  589. package/src/service/windows-process-native.ts +262 -0
  590. package/src/service/windows-service-stop.ts +321 -0
  591. package/src/service/windows-stop-binding.ts +187 -0
  592. package/src/service/windows-stop-budget.ts +123 -0
  593. package/src/service/windows-stop-confirm.ts +158 -0
  594. package/src/service/windows-stop-deadline.ts +56 -0
  595. package/src/service.ts +2 -2
  596. package/src/stall-timeout.ts +11 -0
  597. package/src/types/config.ts +57 -110
  598. package/src/types/link.ts +20 -0
  599. package/src/types/multi-agent.ts +13 -0
  600. package/src/types/provider.ts +60 -2
  601. package/src/types/request.ts +23 -0
  602. package/src/types/routed-catalog-defaults.ts +17 -0
  603. package/src/types/routing-profile.ts +90 -0
  604. package/src/types.ts +4 -0
  605. package/src/update/guarded-runtime-ops.ts +5 -7
  606. package/src/update/index.ts +26 -11
  607. package/src/update/install-detection.mjs +3 -1
  608. package/src/update/job-pinned-start.ts +2 -0
  609. package/src/update/job-windows-restart.ts +19 -32
  610. package/src/update/job.ts +12 -5
  611. package/src/update/npm-install.d.mts +11 -0
  612. package/src/update/npm-install.mjs +44 -7
  613. package/src/update/orchestrated-entry.ts +1 -1
  614. package/src/update/orchestrated-node-driver.mjs +3 -2
  615. package/src/update/orchestrated-pnpm.d.mts +4 -0
  616. package/src/update/orchestrated-pnpm.mjs +50 -6
  617. package/src/update/orchestrated-session.d.mts +3 -1
  618. package/src/update/orchestrated-session.mjs +21 -6
  619. package/src/update/pnpm-global-install.d.mts +21 -3
  620. package/src/update/pnpm-global-install.mjs +322 -19
  621. package/src/update/pnpm-store-layout.mjs +46 -0
  622. package/src/update/sync-update-mutex.d.mts +3 -2
  623. package/src/update/sync-update-mutex.mjs +57 -8
  624. package/src/update/transactional-install.d.mts +3 -1
  625. package/src/update/transactional-install.mjs +545 -12
  626. package/src/update/windows-installer-marker.d.mts +1 -0
  627. package/src/update/windows-installer-marker.mjs +44 -0
  628. package/src/usage/expected-prices.ts +8 -0
  629. package/src/usage/filter-index.ts +326 -77
  630. package/src/usage/ledger-scanner.ts +15 -0
  631. package/src/usage/link-log-fields.ts +48 -0
  632. package/src/usage/log.ts +57 -6
  633. package/src/usage/request-body.ts +37 -0
  634. package/src/usage/telemetry-contract.ts +1 -0
  635. package/src/web-search/loop.ts +3 -0
  636. package/src/web-search/passthrough-bridge.ts +7 -0
  637. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  638. package/gui/dist/assets/brand-mark-DU-0Vdkr.js +0 -1
  639. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  640. package/gui/dist/assets/index-DJEkIDAi.css +0 -2
  641. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  642. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  643. package/gui/dist/classic/assets/quota-summary-CakPe9Ni.js +0 -1
  644. 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";
@@ -44,6 +44,17 @@ export function resolveStallTimeoutMs(configuredSec: number | undefined, options
44
44
  return resolveStallTimeoutSec(configuredSec, options) * 1_000;
45
45
  }
46
46
 
47
+ /**
48
+ * The operator's explicit positive stall budget in milliseconds, or `0` when the budget is unset or
49
+ * non-positive. Native Responses SSE relays arm their silence clock from this value only (#8206):
50
+ * an explicit value applies to local and public upstreams alike, and leaving the field unset keeps
51
+ * that relay without a silence clock, as it was before the budget was enforced there.
52
+ */
53
+ export function explicitStallTimeoutMs(configuredSec: number | undefined): number {
54
+ if (typeof configuredSec !== "number" || !Number.isFinite(configuredSec) || configuredSec <= 0) return 0;
55
+ return resolveStallTimeoutMs(configuredSec);
56
+ }
57
+
47
58
  /** Header-arrival (connect) deadline applied to public upstreams when the operator sets none. */
48
59
  export const DEFAULT_CONNECT_TIMEOUT_MS = 200_000;
49
60
 
@@ -3,11 +3,19 @@ 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";
10
+ import type { OcxRoutingProfileConfig } from "./routing-profile";
8
11
  export type { AnthropicAccountPoolConfig, AnthropicModelRoute, OcxAccountPoolRotationStrategy, OcxAccountPoolQuotaWindow } from "./anthropic-account-pool";
9
12
  export type { OcxFallbackConfig, OcxFallbackDeviceConfig, OcxFallbackKind, OcxFallbackSwitches } from "./fallback";
10
13
  export type { OcxClaudeCodeToolLoadingConfig } from "./claude-tool-loading";
14
+ export type {
15
+ OcxRoutingUnknownEvidenceMode, OcxRoutingProfileCandidate, OcxRoutingProfileRequirements, OcxRoutingProfileOptimize,
16
+ OcxRoutingUnknownCostCapMode, OcxRoutingProfileLimits, OcxRoutingProfileUnknownEvidence,
17
+ OcxRoutingProfileCompatibilitySuite, OcxRoutingProfileCompatibility, OcxRoutingProfileConfig,
18
+ } from "./routing-profile";
11
19
 
12
20
  /** Public inference API exposure. Responses and Chat Completions are always served. */
13
21
  export interface OcxApiSurfacesConfig {
@@ -461,7 +469,7 @@ export interface OcxRemoteGuiConfig {
461
469
  allowInsecureHttp?: boolean;
462
470
  }
463
471
 
464
- export type OcxConnectedClientId = "codex" | "claude";
472
+ export type OcxConnectedClientId = "codex" | "claude" | "claude-desktop" | "grok" | import("../clients/client-ids").ExportClientId;
465
473
 
466
474
  /**
467
475
  * Redaction policy for management and CLI projections (#3859).
@@ -483,11 +491,6 @@ export interface OcxPrivacyConfig {
483
491
  maskEmails?: boolean;
484
492
  }
485
493
 
486
- export interface OcxLinkTransportConfig {
487
- tunnelPort: number;
488
- linkId: string;
489
- }
490
-
491
494
  export interface OcxClientConnectionConfig {
492
495
  serverUrl: string;
493
496
  managementUrl: string;
@@ -527,7 +530,7 @@ export interface OcxClientConnectionConfig {
527
530
  };
528
531
  }
529
532
 
530
- export interface OcxConfig {
533
+ export interface OcxConfig extends OcxLinkHomeConfig {
531
534
  /** Experimental macOS app-server stdout shim; absent or false disables it. */
532
535
  chatgptDesktop?: { appServerShim?: boolean };
533
536
  port: number;
@@ -581,7 +584,8 @@ export interface OcxConfig {
581
584
  defaultProvider: string;
582
585
  /** Persisted state for newly discovered provider models (#2464). Absent keeps legacy "on" behavior. */
583
586
  modelDiscovery?: {
584
- newModelPolicy?: "on" | "off";
587
+ /** `admit` appends arrivals to custom provider selections (#8236); default `on`. */
588
+ newModelPolicy?: "on" | "off" | "admit";
585
589
  knownModels?: Record<string, {
586
590
  ids: string[];
587
591
  removed: string[];
@@ -589,7 +593,14 @@ export interface OcxConfig {
589
593
  /** Consecutive successful discoveries in which an active id was absent. */
590
594
  missing?: Record<string, number>;
591
595
  }>;
592
- recentArrivals?: Record<string, Array<{ id: string; at: string }>>;
596
+ recentArrivals?: Record<string, Array<{
597
+ id: string;
598
+ at: string;
599
+ /** Appended to the provider's custom selection by the `admit` policy. */
600
+ admitted?: boolean;
601
+ /** Whether the `off` policy disabled it; absent on rows recorded before #8236. */
602
+ disabledByPolicy?: boolean;
603
+ }>>;
593
604
  };
594
605
  /** Enable the shipped model alias patterns for providers without an override. */
595
606
  defaultModelAliases?: boolean;
@@ -850,10 +861,10 @@ export interface OcxConfig {
850
861
  * Unknown windows use maxTokens alone; overflow is archived locally with a path notice.
851
862
  * Native and opaque compaction output keep their existing protocols. */
852
863
  reasoningRetention?: { enabled?: boolean; maxContextPercent?: number; maxTokens?: number };
853
- /** Canonical ChatGPT reasoning replay allowances; both default off. */
854
- nativeReasoningRetention?: { modelSwitch?: boolean; accountSwitch?: boolean };
864
+ nativeReasoningRetention?: { modelSwitch?: boolean; accountSwitch?: boolean }; // canonical ChatGPT reasoning replay allowances; both default off
855
865
  /** Per-root fan-out ceilings (src/lib/workflow-budget.ts); omitted fields keep 8 / 256 / 64. */
856
866
  workflowBudget?: { maxConcurrentChildren?: number; maxPhysicalSends?: number; maxDistinctChildren?: number };
867
+ routedCatalogDefaults?: import("./routed-catalog-defaults").OcxRoutedCatalogDefaultsConfig; // #6872; provider/model declarations win
857
868
  /** Explicit opt-in; resumes Observe only using an existing trusted certificate and endpoints. */
858
869
  desktopCompatibility?: { startOnProxyStart: boolean };
859
870
  /**
@@ -936,13 +947,8 @@ export interface OcxConfig {
936
947
  * Unset or omitted by default.
937
948
  */
938
949
  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";
950
+ /** Multi-agent surface override; mode selection and consent follow MultiAgentMode. */
951
+ multiAgentMode?: MultiAgentMode;
946
952
  /**
947
953
  * Which revision of the sub-agent surface advisory this install has answered.
948
954
  * Absent means it has answered none. Written by the dashboard, never by a mode change.
@@ -951,6 +957,7 @@ export interface OcxConfig {
951
957
  /**
952
958
  * When `multiAgentMode` is `"v2"`, keep ChatGPT-native catalog rows on v1.
953
959
  * Routed parents get v2 tools; Sol/Terra can still spawn Grok/Claude (issue #92).
960
+ * Stored but inactive under `"v2-plaintext"`, which pins ChatGPT-native rows on v2.
954
961
  */
955
962
  keepNativeChatGptOnV1?: boolean;
956
963
  /** Experimental plaintext delivery for native v2 collaboration messages; disabled unless true. */
@@ -1067,10 +1074,12 @@ export interface OcxConfig {
1067
1074
  * can hold the connection silent for minutes on a large prompt before the first header arrives.
1068
1075
  */
1069
1076
  connectTimeoutMs?: number;
1077
+ /** Opt-in (#7958): seconds (max 300) to wait for DNS after a pre-connect failure, then resend once. Unset or 0 is off. */ offlineResendWaitSec?: number;
1070
1078
  /** Graceful shutdown drain timeout (ms). Active turns are aborted after this deadline. Default 5000. */
1071
1079
  shutdownTimeoutMs?: number;
1072
- /** Advertise supports_websockets so Codex opens the WS endpoint. Default false; set true to opt in. */
1073
- websockets?: boolean;
1080
+ /** Advertise supports_websockets so Codex opens the WS endpoint. Default false; set true to opt in. */ websockets?: boolean;
1081
+ /** Accept the Responses WebSocket from linked Children over the Remote Link. Default false; needs websockets too. */ linkResponsesWebsocket?: boolean;
1082
+ /** 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
1083
  /** Experimental single-lane native OpenAI WebSocket steering; default off. */
1075
1084
  codexNativeSteering?: boolean;
1076
1085
  /** Experimental, default-off saved function-result injection on native multi-agent WebSockets. */
@@ -1101,6 +1110,10 @@ export interface OcxConfig {
1101
1110
  * non-loopback binds, whose admission token contract is unchanged.
1102
1111
  */
1103
1112
  codexDesktopAuthless?: boolean;
1113
+ /** Luna Reserve (#4961): seeded once from `codexDesktopAuthless`, then independent (absent = off). Grants no entitlement. */
1114
+ codexReserveEnabled?: boolean;
1115
+ /** Internal marker recording that one-time seed. */
1116
+ codexReserveMigration?: number;
1104
1117
  /**
1105
1118
  * Opt into Codex-owned client compaction while keeping OpenCodex routing. On an authenticated
1106
1119
  * loopback bind, inject the dedicated `opencodex` model provider instead of overriding the
@@ -1411,6 +1424,19 @@ export interface OcxConfig {
1411
1424
  tokenGuardian?: OcxTokenGuardianConfig;
1412
1425
  /** Additional exact origins allowed for CORS (e.g. HTTPS or chrome-extension://<id>). Loopback origins are always allowed. */
1413
1426
  corsAllowOrigins?: string[];
1427
+ /**
1428
+ * #8338, opt-in, standalone only: the one reverse proxy a dashboard may sit behind and still
1429
+ * remember devices. `origin` is the exact https origin the browser uses; `proxyAddresses` are
1430
+ * the proxy hop's own IP addresses as this process observes them (never a range); and
1431
+ * `trustHeaders` names the forwarded headers that carry the browser's host and scheme (default:
1432
+ * Host only, scheme from `origin`). Absent, Remember stays direct HTTPS or loopback only. Parsed by
1433
+ * src/config/dashboard-trusted-proxy.ts; enforced in managementRequestOrigin (src/server/auth-cors.ts).
1434
+ */
1435
+ dashboardTrustedProxy?: {
1436
+ origin: string;
1437
+ proxyAddresses: string[];
1438
+ trustHeaders?: Array<"x-forwarded-host" | "x-forwarded-proto">;
1439
+ };
1414
1440
  /**
1415
1441
  * OCX-11 fallback off: refuse model or provider fallback per scope, and record per-device local
1416
1442
  * fallback permission. Absent keeps every chain as it was. See src/routing/fallback-policy.ts.
@@ -1559,96 +1585,6 @@ export interface OcxComboConfig {
1559
1585
  sessionPin?: import("../combos/jev-session-pin-config").JevSessionPinConfig | null;
1560
1586
  }
1561
1587
 
1562
- export type OcxRoutingUnknownEvidenceMode = "allow" | "penalize" | "exclude";
1563
-
1564
- export interface OcxRoutingProfileCandidate {
1565
- provider: string;
1566
- model: string;
1567
- }
1568
-
1569
- export interface OcxRoutingProfileRequirements {
1570
- /** Minimum model context window in tokens. */
1571
- minContextWindow?: number;
1572
- /** Minimum remaining quota headroom fraction (0..1). */
1573
- minQuotaHeadroom?: number;
1574
- tools?: boolean;
1575
- imageInput?: boolean;
1576
- structuredOutput?: boolean;
1577
- reasoningEffort?: string;
1578
- serviceTier?: string;
1579
- localOnly?: boolean;
1580
- remoteAllowed?: boolean;
1581
- /** Special encrypted Codex task readability (ChatGPT forward pool). */
1582
- encryptedCodexTasks?: boolean;
1583
- }
1584
-
1585
- export interface OcxRoutingProfileOptimize {
1586
- latency?: number;
1587
- health?: number;
1588
- cost?: number;
1589
- quota?: number;
1590
- }
1591
-
1592
- /**
1593
- * Policy for the hard cost ceiling when a candidate has no finite cost
1594
- * estimate. `"allow"` (default) preserves the documented dry-run contract:
1595
- * the cap only excludes evidence known to exceed it, and the candidate's
1596
- * `cost.capOutcome` is `"unknown-allowed"`. `"exclude"` makes the ceiling
1597
- * fail-closed (`cost-limit-unknown` + `capOutcome: "unknown-excluded"`).
1598
- */
1599
- export type OcxRoutingUnknownCostCapMode = "allow" | "exclude";
1600
-
1601
- export interface OcxRoutingProfileLimits {
1602
- /** Hard per-request estimated-cost ceiling in USD. */
1603
- maxEstimatedCostUsd?: number;
1604
- /**
1605
- * How `maxEstimatedCostUsd` behaves when the estimate is unknown.
1606
- * Defaults to `"allow"` (eligible + `cost.capOutcome: "unknown-allowed"`);
1607
- * opt in to `"exclude"` for a true hard ceiling.
1608
- */
1609
- onUnknownCost?: OcxRoutingUnknownCostCapMode;
1610
- }
1611
-
1612
- export interface OcxRoutingProfileUnknownEvidence {
1613
- capability?: OcxRoutingUnknownEvidenceMode;
1614
- health?: OcxRoutingUnknownEvidenceMode;
1615
- quota?: OcxRoutingUnknownEvidenceMode;
1616
- cost?: OcxRoutingUnknownEvidenceMode;
1617
- }
1618
-
1619
- export interface OcxRoutingProfileCompatibilitySuite {
1620
- suiteId: string;
1621
- evidenceLayer: "protocol_conformance" | "live_route_compatibility";
1622
- }
1623
-
1624
- export interface OcxRoutingProfileCompatibility {
1625
- requiredSuites?: OcxRoutingProfileCompatibilitySuite[];
1626
- minStatus?: "PROBED" | "VERIFIED";
1627
- maxEvidenceAgeMs?: number;
1628
- unknownEvidence?: OcxRoutingUnknownEvidenceMode;
1629
- degradedEvidence?: OcxRoutingUnknownEvidenceMode;
1630
- }
1631
-
1632
- export interface OcxRoutingProfileConfig {
1633
- /**
1634
- * Explicit candidate allowlist (`provider/model` refs). No implicit
1635
- * expansion in v1.
1636
- */
1637
- candidates: OcxRoutingProfileCandidate[];
1638
- /** Optional public model name replacing the default `policy/<id>` slug. */
1639
- alias?: string;
1640
- /** Hard requirements evaluated before scoring. */
1641
- require?: OcxRoutingProfileRequirements;
1642
- /** Optimization weights; normalized deterministically. */
1643
- optimize?: OcxRoutingProfileOptimize;
1644
- limits?: OcxRoutingProfileLimits;
1645
- /** How unknown evidence is handled per dimension. */
1646
- unknownEvidence?: OcxRoutingProfileUnknownEvidence;
1647
- /** Optional Compatibility Lab policy (CL-06). */
1648
- compatibility?: OcxRoutingProfileCompatibility;
1649
- }
1650
-
1651
-
1652
1588
  export interface OcxTokenGuardianConfig {
1653
1589
  /** Global kill-switch. Default false — the guardian does nothing unless explicitly enabled. */
1654
1590
  enabled?: boolean;
@@ -1687,6 +1623,8 @@ export interface OcxImagesConfig {
1687
1623
  artifactsKeepCount?: number;
1688
1624
  /** Master switch for the video bridge. Default false — must be explicitly opted in. */
1689
1625
  videoBridgeEnabled?: boolean;
1626
+ /** Optional API-key provider that serves `video_gen` (its own baseUrl and key). Unset keeps xAI; an unusable value fails closed. */
1627
+ videoProvider?: string;
1690
1628
  /** Model for xAI video generation. Default "grok-imagine-video". */
1691
1629
  videoBridgeModel?: string;
1692
1630
  /** Max video-gen rounds before forced-final. Default 2 (video is slower than image). */
@@ -1746,6 +1684,8 @@ export interface OcxAdvisorConfig {
1746
1684
  * or a tool result after the latest user message).
1747
1685
  */
1748
1686
  policy?: "manual" | "preflight" | "adaptive";
1687
+ /** question-only sends only the worker's explicit question and disables automatic consultations. */
1688
+ contextMode?: "context" | "question-only";
1749
1689
  /** Adaptive task consultation attempts (manual + automatic). Integer 1–3, default 3. */
1750
1690
  maxConsultationsPerTask?: number;
1751
1691
  /** Advisor fetch timeout (ms). Default 120000. */
@@ -1826,6 +1766,13 @@ export interface OcxCodexPoolConfig {
1826
1766
  startIdleWindows?: boolean;
1827
1767
  /** Enable process-local affinity for caller-owned credentials; defaults off. */
1828
1768
  requestOwnedAffinity?: boolean;
1769
+ /**
1770
+ * Pool-only policy (#7410); defaults off. When true, automatic Pool resolution serves only
1771
+ * registered, eligible non-main accounts: no ordered or preserved native main, no caller-main
1772
+ * fallback, and a manual main pin is not honoured. An exhausted allowed pool refuses. Explicit
1773
+ * account selectors (including `__main__` and Reserve) and Direct mode stay outside the policy.
1774
+ */
1775
+ poolOnly?: boolean;
1829
1776
  /**
1830
1777
  * Plan keys ordinary rotation skips, matched case-insensitively against the plan stored on each
1831
1778
  * 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";