@bitkyc08/opencodex 2.100.1 → 2.100.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (624) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/Tray-BV4ms9U9.js +1 -0
  6. package/gui/dist/assets/{brand-mark-nr3ziR-T.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/index-DQtCRNAw.css +2 -0
  9. package/gui/dist/assets/{segment-thumb-features-DKCVUUTi.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-BedmOsE7.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/quota-summary-Dy5_wfTT.js +1 -0
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +6 -4
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/native-exec.ts +3 -2
  38. package/src/adapters/cursor/protobuf-request.ts +8 -8
  39. package/src/adapters/cursor/tool-guidance.ts +3 -3
  40. package/src/adapters/cursor/tool-wording.ts +10 -1
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/tool-schema.ts +20 -2
  43. package/src/adapters/google-antigravity-wire.ts +15 -6
  44. package/src/adapters/google-truncation.ts +4 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +17 -4
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/openai-chat/tool-schema.ts +9 -0
  54. package/src/adapters/openai-responses/tool-schema.ts +18 -4
  55. package/src/adapters/run-turn-queue.ts +139 -5
  56. package/src/adapters/upstream-http-error.ts +4 -2
  57. package/src/adapters/zed.ts +3 -0
  58. package/src/advisor/consult.ts +15 -4
  59. package/src/advisor/context.ts +12 -3
  60. package/src/advisor/runtime.ts +35 -5
  61. package/src/advisor/settings.ts +8 -0
  62. package/src/advisor/synthetic-tool.ts +21 -8
  63. package/src/bridge/response-json.ts +11 -2
  64. package/src/bridge/sse.ts +51 -9
  65. package/src/claude/auth-detect.ts +21 -33
  66. package/src/claude/chat-tool-dispatch.ts +233 -0
  67. package/src/claude/desktop-3p.ts +11 -5
  68. package/src/claude/desktop-gateway-state.ts +2 -0
  69. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  70. package/src/claude/desktop-remote-store.ts +24 -4
  71. package/src/claude/inbound-content-options.ts +31 -16
  72. package/src/claude/inbound-tool-loading.ts +42 -17
  73. package/src/claude/outbound.ts +13 -3
  74. package/src/cli/account-api.ts +23 -1
  75. package/src/cli/account-auth.ts +54 -21
  76. package/src/cli/account-extended.ts +60 -6
  77. package/src/cli/account-key-quota.ts +56 -7
  78. package/src/cli/account.ts +5 -3
  79. package/src/cli/advisor.ts +7 -4
  80. package/src/cli/alias.ts +38 -1
  81. package/src/cli/capabilities-access-remote.ts +137 -2
  82. package/src/cli/capabilities-accounts.ts +3 -3
  83. package/src/cli/capabilities-agents-routing.ts +17 -10
  84. package/src/cli/capabilities-base.ts +43 -18
  85. package/src/cli/capabilities-integrations.ts +2 -2
  86. package/src/cli/capabilities-provider-models.ts +18 -2
  87. package/src/cli/capabilities-route-to.ts +43 -0
  88. package/src/cli/capabilities.ts +2 -0
  89. package/src/cli/capability-contracts.ts +1 -1
  90. package/src/cli/claude-desktop.ts +30 -11
  91. package/src/cli/claude.ts +36 -17
  92. package/src/cli/codex-launcher.ts +3 -1
  93. package/src/cli/codex-shim-autorestore.ts +5 -42
  94. package/src/cli/config-command.ts +38 -2
  95. package/src/cli/config-root-startup.ts +34 -0
  96. package/src/cli/connect.ts +124 -19
  97. package/src/cli/desktop-runtime-guidance.ts +1 -1
  98. package/src/cli/disconnect-runtime.ts +168 -0
  99. package/src/cli/dispatch.ts +54 -12
  100. package/src/cli/export-command.ts +1 -1
  101. package/src/cli/gui-pair-client.ts +29 -5
  102. package/src/cli/gui.ts +10 -5
  103. package/src/cli/help-catalog.ts +11 -0
  104. package/src/cli/help.ts +5 -4
  105. package/src/cli/hub.ts +18 -1
  106. package/src/cli/index.ts +83 -92
  107. package/src/cli/inspect.ts +11 -2
  108. package/src/cli/integrations.ts +26 -1
  109. package/src/cli/link-capture.ts +64 -0
  110. package/src/cli/link-child-ops.ts +314 -0
  111. package/src/cli/link-cleanup.ts +8 -5
  112. package/src/cli/link-diagnostics.ts +67 -0
  113. package/src/cli/link-enrollment.ts +158 -12
  114. package/src/cli/link-operations.ts +52 -0
  115. package/src/cli/link-recover.ts +152 -0
  116. package/src/cli/link-routes.ts +87 -0
  117. package/src/cli/link-status-child.ts +137 -0
  118. package/src/cli/link-status-traffic.ts +34 -0
  119. package/src/cli/link.ts +327 -37
  120. package/src/cli/message-command.ts +1 -1
  121. package/src/cli/message-mcp-command.ts +23 -10
  122. package/src/cli/models-runtime.ts +3 -3
  123. package/src/cli/opencode.ts +3 -1
  124. package/src/cli/pi-sync.ts +35 -0
  125. package/src/cli/preflight-exemptions.ts +46 -0
  126. package/src/cli/registry.ts +29 -12
  127. package/src/cli/restart-failure.ts +5 -2
  128. package/src/cli/root.ts +5 -1
  129. package/src/cli/route-to.ts +172 -0
  130. package/src/cli/runtime-api.ts +5 -8
  131. package/src/cli/status.ts +3 -1
  132. package/src/cli/stop-approval.ts +66 -19
  133. package/src/cli/stop-report.ts +23 -0
  134. package/src/cli/stop-windows-checked.ts +304 -0
  135. package/src/cli/sync-command.ts +70 -13
  136. package/src/cli/sync-fanout.ts +81 -99
  137. package/src/cli/sync-flags.ts +40 -3
  138. package/src/cli/sync-link-status.ts +18 -2
  139. package/src/cli/sync-update-guard.ts +7 -2
  140. package/src/cli/system-restart-client.ts +3 -2
  141. package/src/cli/uninstall-plan.ts +77 -5
  142. package/src/cli/uninstall-stop.ts +152 -0
  143. package/src/cli/v2-input.ts +10 -6
  144. package/src/cli/v2-local-output.ts +3 -2
  145. package/src/cli/v2-runtime.ts +10 -3
  146. package/src/cli/v2.ts +22 -7
  147. package/src/client/connect.ts +321 -34
  148. package/src/client/link-home-features.ts +27 -0
  149. package/src/client/link-home.ts +92 -4
  150. package/src/client/link-ingress.ts +21 -3
  151. package/src/client/link-join.ts +12 -2
  152. package/src/client/link-parity-reporter.ts +60 -6
  153. package/src/client/link-readiness.ts +16 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel-status.ts +76 -0
  161. package/src/client/link-tunnel.ts +56 -5
  162. package/src/client/link-websocket-limits.ts +89 -0
  163. package/src/client/link-websocket.ts +586 -0
  164. package/src/client/link-ws-advertisement.ts +100 -0
  165. package/src/client/link-ws-framer.ts +241 -0
  166. package/src/client/link-ws-transport.ts +177 -0
  167. package/src/client/machine-api.ts +13 -2
  168. package/src/client/machine-listener.ts +48 -7
  169. package/src/client/route-intent-apply.ts +293 -0
  170. package/src/client/route-intent-file-originals.ts +97 -0
  171. package/src/client/route-intent-native-originals.ts +201 -0
  172. package/src/client/route-intent-watch.ts +141 -0
  173. package/src/client/runtime-restart.ts +127 -5
  174. package/src/client/runtime.ts +61 -15
  175. package/src/client/state.ts +30 -0
  176. package/src/client/sync-expectation.ts +36 -2
  177. package/src/client/sync-runtime.ts +7 -0
  178. package/src/clients/config-export/alias-selectors.ts +63 -40
  179. package/src/clients/config-export/contracts.ts +2 -0
  180. package/src/clients/config-export/nested-selectors.ts +42 -0
  181. package/src/clients/config-export.ts +36 -4
  182. package/src/codex/account-resume-health.ts +41 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/login-flow.ts +6 -0
  187. package/src/codex/auth-api/routes.ts +35 -2
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +21 -6
  190. package/src/codex/catalog/gather-capture.ts +10 -2
  191. package/src/codex/catalog/parsing.ts +7 -3
  192. package/src/codex/catalog/provider-models.ts +67 -23
  193. package/src/codex/catalog/retained-sync.ts +2 -1
  194. package/src/codex/catalog/routed-gather.ts +1 -1
  195. package/src/codex/catalog-auto-refresh.ts +11 -0
  196. package/src/codex/cli-update-job.ts +35 -13
  197. package/src/codex/convergence-types.ts +2 -0
  198. package/src/codex/convergence.ts +2 -2
  199. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  200. package/src/codex/features.ts +2 -2
  201. package/src/codex/history-provider.ts +31 -0
  202. package/src/codex/inject/multi-agent-v2.ts +9 -3
  203. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  204. package/src/codex/inject/plan.ts +20 -2
  205. package/src/codex/inject.ts +2 -0
  206. package/src/codex/journal-config-restore.ts +217 -0
  207. package/src/codex/journal.ts +75 -6
  208. package/src/codex/main-account.ts +23 -30
  209. package/src/codex/native-main-auth-file.ts +104 -0
  210. package/src/codex/native-profile-manager.ts +4 -3
  211. package/src/codex/native-profile-store.ts +3 -61
  212. package/src/codex/orca-import.ts +10 -1
  213. package/src/codex/quota-history.ts +13 -0
  214. package/src/codex/quota-window-conflict.ts +103 -0
  215. package/src/codex/quota.ts +134 -7
  216. package/src/codex/subagent-model-fallback.ts +3 -1
  217. package/src/codex/websocket-activity.ts +171 -16
  218. package/src/codex/websocket-registry.ts +11 -4
  219. package/src/combos/cooldown-store.ts +228 -0
  220. package/src/combos/failover.ts +760 -35
  221. package/src/config/dashboard-trusted-proxy.ts +83 -0
  222. package/src/config/diagnostics.ts +28 -0
  223. package/src/config/feature-flags.ts +9 -0
  224. package/src/config/live-reconcile.ts +10 -1
  225. package/src/config/load-degrade.ts +12 -1
  226. package/src/config/multi-agent-surface.ts +28 -5
  227. package/src/config/pending-teardown.ts +60 -3
  228. package/src/config/process-state.ts +175 -4
  229. package/src/config/provider-validation.ts +4 -4
  230. package/src/config/salvage.ts +1 -0
  231. package/src/config/schema/config-schema.ts +12 -3
  232. package/src/config/schema/leaf-validators.ts +43 -14
  233. package/src/config/windows-process-command-line.ts +107 -0
  234. package/src/generated/compatibility-version.json +1077 -429
  235. package/src/generated/model-metadata.ts +1 -1
  236. package/src/images/loop.ts +3 -0
  237. package/src/integrations/model-name-guard.ts +25 -0
  238. package/src/integrations/route-intent-catalog.ts +26 -0
  239. package/src/integrations/route-intent-connected.ts +262 -0
  240. package/src/integrations/route-intent-contract.ts +55 -0
  241. package/src/integrations/route-intent-disconnect.ts +109 -0
  242. package/src/integrations/route-intent-initial.ts +64 -0
  243. package/src/integrations/route-intent-state.ts +117 -0
  244. package/src/integrations/route-intent-tick.ts +65 -0
  245. package/src/integrations/route-intent.ts +212 -0
  246. package/src/integrations/writer.ts +44 -11
  247. package/src/lib/catalog-etag.ts +10 -0
  248. package/src/lib/client-error-body.ts +15 -0
  249. package/src/lib/client-retry-after.ts +29 -0
  250. package/src/lib/config-ownership.ts +13 -0
  251. package/src/lib/context-overflow-verdict.ts +266 -9
  252. package/src/lib/desktop-gui-origin.ts +28 -0
  253. package/src/lib/errors.ts +1 -1
  254. package/src/lib/failure-detail.ts +72 -3
  255. package/src/lib/gui-pair-capability.ts +2 -1
  256. package/src/lib/hard-refusal.ts +259 -0
  257. package/src/lib/messages-error-body.ts +4 -1
  258. package/src/lib/outbound-credential-registry.ts +362 -4
  259. package/src/lib/paced-stream.ts +34 -0
  260. package/src/lib/passive-key-fetch-proof.ts +30 -0
  261. package/src/lib/passive-read.ts +5 -0
  262. package/src/lib/process-control.ts +76 -12
  263. package/src/lib/redact.ts +84 -8
  264. package/src/lib/state-store-registrations.ts +11 -0
  265. package/src/lib/state-store-sweeper.ts +4 -0
  266. package/src/lib/supervisor-markers.ts +18 -0
  267. package/src/lib/terminal-safe-text.ts +58 -0
  268. package/src/lib/translator-budget.ts +3 -2
  269. package/src/lib/upstream-retry.ts +14 -4
  270. package/src/link/alias-lock.ts +119 -0
  271. package/src/link/child-activity.ts +83 -0
  272. package/src/link/child-binary-cache-fill.d.mts +50 -0
  273. package/src/link/child-binary-cache-fill.mjs +494 -0
  274. package/src/link/child-binary-cache-start.ts +73 -0
  275. package/src/link/child-binary-source.ts +12 -5
  276. package/src/link/child-catalog-freshness.ts +149 -0
  277. package/src/link/child-gated-ocx.ts +135 -0
  278. package/src/link/child-observations.ts +206 -0
  279. package/src/link/child-observe.ts +121 -0
  280. package/src/link/child-ops-engine.ts +230 -0
  281. package/src/link/child-ops-host.ts +138 -0
  282. package/src/link/child-ops-runners.ts +319 -0
  283. package/src/link/child-ops-scheduler.ts +207 -0
  284. package/src/link/child-ops-types.ts +89 -0
  285. package/src/link/child-parity.ts +23 -4
  286. package/src/link/child-policy.ts +93 -0
  287. package/src/link/child-update-contract.ts +174 -0
  288. package/src/link/codex-settings.ts +1 -1
  289. package/src/link/compatibility.ts +18 -1
  290. package/src/link/diagnostics-read.ts +163 -0
  291. package/src/link/diagnostics.ts +20 -7
  292. package/src/link/explicit-route.ts +209 -0
  293. package/src/link/link-recover.ts +113 -0
  294. package/src/link/management-routes.ts +3 -1
  295. package/src/link/operation-recovery-slot.ts +44 -0
  296. package/src/link/operations-journal.ts +408 -0
  297. package/src/link/paths.ts +5 -0
  298. package/src/link/peer-report.ts +1 -1
  299. package/src/link/relay-auth.ts +14 -0
  300. package/src/link/remote-plant.ts +152 -14
  301. package/src/link/remote-platform.ts +21 -10
  302. package/src/link/remote-probe.ts +11 -3
  303. package/src/link/remote-windows.ts +88 -12
  304. package/src/link/request-compression.ts +30 -0
  305. package/src/link/residual-recovery.ts +54 -0
  306. package/src/link/retirement.ts +128 -0
  307. package/src/link/route-intent-watch.ts +41 -0
  308. package/src/link/route-intent.ts +209 -0
  309. package/src/link/route-proof.ts +82 -0
  310. package/src/link/route-rounds.ts +579 -0
  311. package/src/link/route-select.ts +95 -0
  312. package/src/link/route-trust.ts +96 -0
  313. package/src/link/ssh-argv.ts +285 -43
  314. package/src/link/ssh-capture-redact.ts +253 -0
  315. package/src/link/ssh-capture.ts +497 -0
  316. package/src/link/ssh-runner.ts +141 -14
  317. package/src/link/status-projection.ts +160 -0
  318. package/src/link/store.ts +54 -1
  319. package/src/link/supervisor.ts +543 -55
  320. package/src/link/sync-fanout-classify.ts +114 -0
  321. package/src/link/sync-then-restart.ts +65 -0
  322. package/src/link/tombstones.ts +209 -0
  323. package/src/link/traffic.ts +178 -0
  324. package/src/link/tunnel-state.ts +10 -4
  325. package/src/link/ws-activity-holds.ts +474 -0
  326. package/src/local-credentials/publication-fence.ts +20 -1
  327. package/src/messaging/mcp-queue-rpc.ts +3 -2
  328. package/src/messaging/mcp-queue-server.ts +21 -1
  329. package/src/messaging/mcp-reply-tools.ts +24 -9
  330. package/src/messaging/mcp-reply-wait.ts +70 -0
  331. package/src/messaging/mcp-resume-tools.ts +25 -0
  332. package/src/messaging/remote-enrollment.ts +3 -3
  333. package/src/messaging/remote-tunnels.ts +2 -2
  334. package/src/messaging/resume-permissions.ts +27 -0
  335. package/src/messaging/rpc.ts +46 -2
  336. package/src/oauth/account-resume-health.ts +60 -0
  337. package/src/oauth/anthropic-continuity.ts +23 -7
  338. package/src/oauth/anthropic-routing.ts +5 -2
  339. package/src/oauth/anthropic.ts +22 -2
  340. package/src/oauth/claude-keychain-read.ts +78 -68
  341. package/src/oauth/index.ts +25 -6
  342. package/src/oauth/local-token-detect.ts +8 -29
  343. package/src/oauth/login-cli-errors.ts +5 -1
  344. package/src/oauth/login-cli.ts +33 -18
  345. package/src/oauth/login-flow-state.ts +26 -3
  346. package/src/oauth/meta-muse.ts +1 -1
  347. package/src/oauth/store.ts +51 -1
  348. package/src/oauth/xai.ts +248 -14
  349. package/src/protocols/contract.ts +4 -0
  350. package/src/protocols/encoders/messages.ts +1 -0
  351. package/src/providers/alias-template.ts +48 -0
  352. package/src/providers/anthropic-billing-ownership.ts +2 -0
  353. package/src/providers/anthropic-output-caps.ts +46 -0
  354. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  355. package/src/providers/antigravity-effort-families.ts +11 -3
  356. package/src/providers/antigravity-models.ts +32 -9
  357. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  358. package/src/providers/api-key-pause-state.ts +23 -0
  359. package/src/providers/api-key-pause.ts +71 -10
  360. package/src/providers/api-key-resolve.ts +49 -7
  361. package/src/providers/api-key-response-ownership.ts +2 -0
  362. package/src/providers/api-key-selection-capture.ts +3 -1
  363. package/src/providers/api-key-selection.ts +54 -11
  364. package/src/providers/api-keys.ts +24 -7
  365. package/src/providers/cache-affinity-identity.ts +73 -0
  366. package/src/providers/cache-affinity.ts +256 -0
  367. package/src/providers/claude-cli-usage-state.ts +11 -6
  368. package/src/providers/claude-cli-usage.ts +27 -9
  369. package/src/providers/codex-capacity.ts +11 -2
  370. package/src/providers/default-aliases.ts +98 -20
  371. package/src/providers/google-vertex-model-discovery.ts +510 -0
  372. package/src/providers/key-failover.ts +136 -14
  373. package/src/providers/key-store.ts +3 -3
  374. package/src/providers/kiro-models.ts +3 -5
  375. package/src/providers/label.ts +31 -5
  376. package/src/providers/mistral-transport.ts +17 -4
  377. package/src/providers/model-discovery-config.ts +31 -0
  378. package/src/providers/model-discovery-diagnostic.ts +34 -3
  379. package/src/providers/model-discovery.ts +43 -7
  380. package/src/providers/model-rename-fields.ts +5 -0
  381. package/src/providers/muse-key-quota.ts +14 -6
  382. package/src/providers/new-model-policy-runtime.ts +17 -4
  383. package/src/providers/new-model-policy.ts +30 -4
  384. package/src/providers/openai-sidecar.ts +15 -2
  385. package/src/providers/passive-key-observation.ts +252 -0
  386. package/src/providers/provider-id-rewrite.ts +3 -0
  387. package/src/providers/quota/account-cache.ts +53 -34
  388. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  389. package/src/providers/quota/anthropic-usage-windows.ts +19 -9
  390. package/src/providers/quota/passive-key-limits.ts +272 -0
  391. package/src/providers/quota/passive-wire-model.ts +126 -0
  392. package/src/providers/quota/report-cache.ts +112 -5
  393. package/src/providers/quota/vendor-probes-key.ts +73 -0
  394. package/src/providers/quota/vendor-probes-oauth.ts +57 -3
  395. package/src/providers/quota-key-accounts.ts +22 -10
  396. package/src/providers/quota-mistral-budget.ts +18 -0
  397. package/src/providers/quota-types.ts +43 -0
  398. package/src/providers/quota.ts +31 -32
  399. package/src/providers/reasoning-metadata.ts +1051 -12
  400. package/src/providers/registry/entries-core.ts +34 -16
  401. package/src/providers/registry/entries-extended.ts +32 -0
  402. package/src/providers/registry/model-seeds.ts +35 -0
  403. package/src/providers/resolved-model-policy.ts +7 -0
  404. package/src/providers/routed-config.ts +8 -3
  405. package/src/providers/xai-transport.ts +3 -0
  406. package/src/quota/reset-observer.ts +4 -2
  407. package/src/quota/reset-seen-store.ts +9 -0
  408. package/src/quota/window-mapping.ts +1 -0
  409. package/src/quota-pool/assemble.ts +4 -1
  410. package/src/remote/features.ts +17 -0
  411. package/src/responses/anthropic-progress.ts +10 -4
  412. package/src/responses/citation-markers.ts +231 -0
  413. package/src/responses/hosted-tool-policy.ts +56 -12
  414. package/src/responses/spill-store.ts +5 -1
  415. package/src/responses/state/replay-input.ts +50 -0
  416. package/src/responses/state/replay-owner.ts +24 -0
  417. package/src/responses/state/snapshot-codec.ts +9 -0
  418. package/src/responses/state/spill-queue.ts +1 -0
  419. package/src/responses/state.ts +42 -60
  420. package/src/router.ts +4 -2
  421. package/src/routing/home-route-capture.ts +123 -0
  422. package/src/routing/home-route-intent.ts +200 -0
  423. package/src/routing/route-intent-state.ts +178 -0
  424. package/src/routing/route-to-live-settings.ts +35 -0
  425. package/src/routing/route-to-local.ts +145 -0
  426. package/src/routing/route-to-status.ts +94 -0
  427. package/src/routing/route-to-sync-child.ts +32 -0
  428. package/src/server/adapter-resolve.ts +21 -1
  429. package/src/server/admitted-http-turn.ts +3 -0
  430. package/src/server/auth-cors.ts +109 -8
  431. package/src/server/bare-upstream-error.ts +220 -0
  432. package/src/server/catalog-download.ts +3 -5
  433. package/src/server/chat-native.ts +25 -7
  434. package/src/server/claude-messages.ts +8 -5
  435. package/src/server/codex-model-list.ts +2 -1
  436. package/src/server/configured-credentials.ts +37 -5
  437. package/src/server/gui-desktop-authorization.ts +36 -0
  438. package/src/server/gui-pair-delivery.ts +6 -3
  439. package/src/server/gui-session.ts +10 -1
  440. package/src/server/images.ts +41 -13
  441. package/src/server/inbound-body-admission.ts +17 -4
  442. package/src/server/index/link-listener.ts +203 -11
  443. package/src/server/index/link-management.ts +15 -1
  444. package/src/server/index/link-relay-sessions.ts +128 -8
  445. package/src/server/index/link-websocket-limits.ts +136 -0
  446. package/src/server/index/link-websocket.ts +692 -0
  447. package/src/server/index/optional-listeners.ts +115 -7
  448. package/src/server/index/route-intent-watch.ts +47 -0
  449. package/src/server/index/serve-contract.ts +86 -0
  450. package/src/server/index/serve-options.ts +35 -86
  451. package/src/server/index/startup-warnings.ts +8 -2
  452. package/src/server/index/websocket-handler.ts +26 -4
  453. package/src/server/index.ts +12 -2
  454. package/src/server/inference/client-encoder-delivery.ts +2 -0
  455. package/src/server/inspection-tee.ts +39 -2
  456. package/src/server/lifecycle.ts +2 -0
  457. package/src/server/link-turn.ts +137 -0
  458. package/src/server/management/advisor-routes.ts +10 -2
  459. package/src/server/management/agent-settings-routes.ts +50 -16
  460. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  461. package/src/server/management/config-routes.ts +7 -1
  462. package/src/server/management/context.ts +9 -2
  463. package/src/server/management/desktop-authorization.ts +41 -0
  464. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  465. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  466. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  467. package/src/server/management/home-integration-decision.ts +89 -0
  468. package/src/server/management/integration-routes.ts +208 -81
  469. package/src/server/management/link-child-ops-routes.ts +218 -0
  470. package/src/server/management/link-child-preflight.ts +31 -0
  471. package/src/server/management/link-diagnostics-route.ts +29 -0
  472. package/src/server/management/link-enrollment.ts +199 -47
  473. package/src/server/management/link-operation.ts +609 -0
  474. package/src/server/management/link-recover-route.ts +103 -0
  475. package/src/server/management/link-route-edit.ts +173 -0
  476. package/src/server/management/link-route-request.ts +62 -0
  477. package/src/server/management/link-route-state.ts +92 -6
  478. package/src/server/management/link-routes.ts +563 -51
  479. package/src/server/management/link-traffic-status.ts +13 -0
  480. package/src/server/management/model-routes.ts +122 -36
  481. package/src/server/management/model-rows.ts +2 -1
  482. package/src/server/management/native-integration-routes.ts +176 -70
  483. package/src/server/management/oauth-account-routes.ts +69 -17
  484. package/src/server/management/protocol-routes.ts +7 -0
  485. package/src/server/management/provider-completion-test.ts +4 -4
  486. package/src/server/management/provider-overwrite-carry.ts +39 -3
  487. package/src/server/management/provider-routes.ts +80 -72
  488. package/src/server/management/provider-routing-quota.ts +45 -0
  489. package/src/server/management/route-registry.ts +25 -3
  490. package/src/server/management/route-to-routes.ts +257 -0
  491. package/src/server/management/system-restart.ts +4 -2
  492. package/src/server/management/usage-aggregate-cache.ts +101 -66
  493. package/src/server/management-api.ts +17 -3
  494. package/src/server/management-auth.ts +13 -1
  495. package/src/server/messages-native-preflight.ts +27 -4
  496. package/src/server/messages-native.ts +22 -5
  497. package/src/server/persistent-gui-session.ts +6 -3
  498. package/src/server/proxy-liveness.ts +33 -6
  499. package/src/server/relay-eager.ts +36 -12
  500. package/src/server/relay.ts +183 -116
  501. package/src/server/request-body-facts.ts +48 -0
  502. package/src/server/request-decompress.ts +65 -2
  503. package/src/server/request-log-account-rotation.ts +6 -0
  504. package/src/server/request-log-attempt-usage.ts +69 -0
  505. package/src/server/request-log-cache-affinity.ts +60 -0
  506. package/src/server/request-log-conversation.ts +45 -2
  507. package/src/server/request-log-failure-detail.ts +59 -1
  508. package/src/server/request-log-terminal-status.ts +210 -24
  509. package/src/server/request-log.ts +71 -79
  510. package/src/server/responses/adapter-continuation.ts +2 -1
  511. package/src/server/responses/adapter-delivery.ts +2 -0
  512. package/src/server/responses/adapter-dispatch.ts +40 -51
  513. package/src/server/responses/advisor-plan-slot.ts +33 -1
  514. package/src/server/responses/advisor-question.ts +21 -0
  515. package/src/server/responses/advisor-slot.ts +10 -3
  516. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  517. package/src/server/responses/buffered-sse-json.ts +9 -3
  518. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  519. package/src/server/responses/codex-tool-catalog.ts +156 -0
  520. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  521. package/src/server/responses/combo-stream-preflight.ts +701 -81
  522. package/src/server/responses/compact.ts +47 -12
  523. package/src/server/responses/context-overflow.ts +58 -2
  524. package/src/server/responses/core-codex-account.ts +17 -3
  525. package/src/server/responses/core-combo-failure.ts +37 -4
  526. package/src/server/responses/core-combo-native.ts +3 -1
  527. package/src/server/responses/core-combo.ts +62 -7
  528. package/src/server/responses/core-errors.ts +8 -3
  529. package/src/server/responses/core-lifetime.ts +3 -2
  530. package/src/server/responses/core-normalize.ts +3 -1
  531. package/src/server/responses/core-opaque-recovery.ts +45 -2
  532. package/src/server/responses/core-options.ts +18 -0
  533. package/src/server/responses/core.ts +2 -0
  534. package/src/server/responses/fetch-helpers.ts +15 -10
  535. package/src/server/responses/native-replay-guard.ts +57 -0
  536. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  537. package/src/server/responses/outbound-request-body.ts +29 -0
  538. package/src/server/responses/passthrough-completion.ts +105 -8
  539. package/src/server/responses/passthrough-delivery.ts +31 -11
  540. package/src/server/responses/passthrough-dispatch.ts +99 -106
  541. package/src/server/responses/policy-fallback.ts +13 -1
  542. package/src/server/responses/request-prepare.ts +50 -6
  543. package/src/server/responses/request-transport.ts +53 -17
  544. package/src/server/responses/reset-replay.ts +104 -4
  545. package/src/server/responses/run-turn-execution.ts +58 -30
  546. package/src/server/responses/sidecar-execution.ts +14 -0
  547. package/src/server/responses/terminal-error-redaction.ts +222 -25
  548. package/src/server/responses/ws-upstream.ts +2 -2
  549. package/src/server/sse-payload-rewrite.ts +3 -2
  550. package/src/server/stop-service-route.ts +85 -0
  551. package/src/server/system-env-shell.ts +12 -1
  552. package/src/server/system-env.ts +5 -3
  553. package/src/server/windows-tcp-drop.ts +21 -4
  554. package/src/server/workflow-refusal.ts +8 -0
  555. package/src/server/ws-bridge.ts +191 -12
  556. package/src/service/cli-windows-stop.ts +189 -0
  557. package/src/service/cli.ts +41 -12
  558. package/src/service/disconnected-client-restart.ts +60 -0
  559. package/src/service/guarded-manager-target.ts +18 -1
  560. package/src/service/health.ts +99 -6
  561. package/src/service/launchd.ts +84 -31
  562. package/src/service/orchestration.ts +418 -91
  563. package/src/service/repair.ts +223 -6
  564. package/src/service/restart-proxy-stop.ts +79 -0
  565. package/src/service/service-child-ownership.ts +6 -2
  566. package/src/service/windows-checked-stop-live.ts +467 -0
  567. package/src/service/windows-checked-stop.ts +435 -0
  568. package/src/service/windows-command-line-token.ts +23 -0
  569. package/src/service/windows-guarded-manager.ts +77 -34
  570. package/src/service/windows-ops.ts +38 -56
  571. package/src/service/windows-process-evidence.ts +292 -0
  572. package/src/service/windows-process-native.ts +262 -0
  573. package/src/service/windows-service-stop.ts +321 -0
  574. package/src/service/windows-stop-binding.ts +187 -0
  575. package/src/service/windows-stop-budget.ts +123 -0
  576. package/src/service/windows-stop-confirm.ts +158 -0
  577. package/src/service/windows-stop-deadline.ts +56 -0
  578. package/src/service.ts +2 -2
  579. package/src/types/claude-tool-loading.ts +48 -0
  580. package/src/types/config.ts +47 -53
  581. package/src/types/link.ts +20 -0
  582. package/src/types/multi-agent.ts +13 -0
  583. package/src/types/provider.ts +68 -2
  584. package/src/types/request.ts +4 -0
  585. package/src/types.ts +4 -0
  586. package/src/update/guarded-runtime-ops.ts +5 -7
  587. package/src/update/index.ts +25 -10
  588. package/src/update/install-detection.mjs +3 -1
  589. package/src/update/job-pinned-start.ts +2 -0
  590. package/src/update/job-windows-restart.ts +19 -32
  591. package/src/update/job.ts +12 -5
  592. package/src/update/npm-install.d.mts +11 -0
  593. package/src/update/npm-install.mjs +44 -7
  594. package/src/update/orchestrated-entry.ts +1 -1
  595. package/src/update/orchestrated-node-driver.mjs +3 -2
  596. package/src/update/orchestrated-pnpm.d.mts +4 -0
  597. package/src/update/orchestrated-pnpm.mjs +50 -6
  598. package/src/update/orchestrated-session.d.mts +3 -1
  599. package/src/update/orchestrated-session.mjs +21 -6
  600. package/src/update/pnpm-global-install.d.mts +21 -3
  601. package/src/update/pnpm-global-install.mjs +322 -19
  602. package/src/update/pnpm-store-layout.mjs +46 -0
  603. package/src/update/sync-update-mutex.d.mts +3 -2
  604. package/src/update/sync-update-mutex.mjs +57 -8
  605. package/src/update/transactional-install.d.mts +3 -1
  606. package/src/update/transactional-install.mjs +545 -12
  607. package/src/update/windows-installer-marker.d.mts +1 -0
  608. package/src/update/windows-installer-marker.mjs +44 -0
  609. package/src/usage/expected-prices.ts +8 -0
  610. package/src/usage/filter-index.ts +326 -77
  611. package/src/usage/ledger-scanner.ts +15 -0
  612. package/src/usage/link-log-fields.ts +48 -0
  613. package/src/usage/log.ts +43 -2
  614. package/src/usage/request-body.ts +37 -0
  615. package/src/web-search/loop.ts +3 -0
  616. package/src/web-search/parse.ts +21 -2
  617. package/gui/dist/assets/App-g3Cm2xhZ.js +0 -59
  618. package/gui/dist/assets/Tray-BMDkAiXy.js +0 -1
  619. package/gui/dist/assets/index-Bziu8gTy.css +0 -2
  620. package/gui/dist/assets/index-OYzhQUNP.js +0 -94
  621. package/gui/dist/classic/assets/App-CgPBKUP-.js +0 -58
  622. package/gui/dist/classic/assets/index-BR-HhNrp.js +0 -94
  623. package/gui/dist/classic/assets/quota-summary-CXKhvSmQ.js +0 -1
  624. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,178 @@
1
+ /** Home-owned desired policy. Reads never create or repair a file. */
2
+ import { chmodSync, lstatSync, mkdirSync, readFileSync } from "node:fs";
3
+ import { dirname, join } from "node:path";
4
+ import { atomicWriteFile, isMissingPathError } from "../config/atomic-write";
5
+ import { withConfigMutationLockSync } from "../config/mutation-lock";
6
+ import { getConfigDir } from "../config/paths";
7
+ import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
8
+ import { hardenSecretDir } from "../lib/windows-secret-acl";
9
+ import { emptyRouteIntentState, HOME_NATIVE_ROUTE_CLIENTS, isHomeNativeRouteClient, isRouteClientId, parseRouteClientIntent,
10
+ type HomeNativeRouteClientId, type RouteClientId, type RouteClientIntent, type RouteIntentState } from "../link/route-intent";
11
+ export type { RouteIntentState } from "../link/route-intent";
12
+
13
+ const MAX_STATE_BYTES = 1024 * 1024;
14
+ export function routeIntentStatePath(): string { return join(getConfigDir(), "route-intent.json"); }
15
+
16
+ /**
17
+ * `route-intent.json` exists but cannot be read or parsed. Writers answer it with a typed refusal
18
+ * that names the file, because only the operator can fix or remove it.
19
+ */
20
+ export class RouteIntentStateUnreadableError extends Error {
21
+ readonly path: string;
22
+ constructor(path: string, cause: unknown) {
23
+ super(`Route intent in ${path} could not be read; nothing was changed. Inspect it, fix or remove it, then retry.`, { cause });
24
+ this.name = "RouteIntentStateUnreadableError";
25
+ this.path = path;
26
+ }
27
+ }
28
+ function deviceIdAllowed(value: string): boolean {
29
+ return /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,255}$/.test(value) && !["__proto__", "constructor", "prototype"].includes(value);
30
+ }
31
+ function parseIntentMap(value: unknown): Partial<Record<RouteClientId, RouteClientIntent>> {
32
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("invalid route intent map");
33
+ const result: Partial<Record<RouteClientId, RouteClientIntent>> = {};
34
+ for (const [client, raw] of Object.entries(value)) {
35
+ if (!isRouteClientId(client)) throw new Error("unknown route client");
36
+ const intent = parseRouteClientIntent(raw, client);
37
+ if (!intent) throw new Error("invalid route client intent");
38
+ result[client] = intent;
39
+ }
40
+ return result;
41
+ }
42
+ export function parseRouteIntentState(value: unknown): RouteIntentState {
43
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("invalid route intent state");
44
+ const raw = value as Record<string, unknown>;
45
+ if (raw.version !== 1 || Object.keys(raw).some(key => !["version", "defaults", "devices", "revisions"].includes(key)) || !Object.hasOwn(raw, "defaults") || !Object.hasOwn(raw, "devices")
46
+ || !raw.devices || typeof raw.devices !== "object" || Array.isArray(raw.devices)) throw new Error("invalid route intent state");
47
+ const state = emptyRouteIntentState();
48
+ state.defaults = parseIntentMap(raw.defaults);
49
+ for (const [id, map] of Object.entries(raw.devices)) {
50
+ if (!deviceIdAllowed(id)) throw new Error("invalid route device id");
51
+ state.devices[id] = parseIntentMap(map);
52
+ }
53
+ if (raw.revisions !== undefined) {
54
+ if (!raw.revisions || typeof raw.revisions !== "object" || Array.isArray(raw.revisions)) throw new Error("invalid route device revisions");
55
+ state.revisions = {};
56
+ for (const [id, map] of Object.entries(raw.revisions)) {
57
+ if (!deviceIdAllowed(id) || !map || typeof map !== "object" || Array.isArray(map)) throw new Error("invalid route device revisions");
58
+ const revisions: Partial<Record<RouteClientId, number>> = {};
59
+ for (const [client, revision] of Object.entries(map)) {
60
+ if (!isRouteClientId(client) || typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 0) throw new Error("invalid route client revision");
61
+ revisions[client] = revision;
62
+ }
63
+ state.revisions[id] = revisions;
64
+ }
65
+ }
66
+ return state;
67
+ }
68
+ export function readRouteIntentState(path = routeIntentStatePath()): RouteIntentState {
69
+ try {
70
+ const stat = lstatSync(path);
71
+ if (!stat.isFile() || stat.size > MAX_STATE_BYTES) throw new Error("invalid route intent state file");
72
+ return parseRouteIntentState(JSON.parse(readFileSync(path, "utf8")));
73
+ } catch (error) {
74
+ if (isMissingPathError(error)) return emptyRouteIntentState();
75
+ throw new RouteIntentStateUnreadableError(path, error);
76
+ }
77
+ }
78
+ function writeState(state: RouteIntentState, path: string): void {
79
+ const dir = dirname(path);
80
+ assertNotRealHomeUnderTest(dir);
81
+ const body = `${JSON.stringify(state, null, 2)}\n`;
82
+ if (Buffer.byteLength(body) > MAX_STATE_BYTES) throw new Error("route intent state too large");
83
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
84
+ if (process.platform === "win32") hardenSecretDir(dir, { required: true });
85
+ else chmodSync(dir, 0o700);
86
+ atomicWriteFile(path, body);
87
+ }
88
+ export function writeRouteIntentState(state: RouteIntentState, path = routeIntentStatePath()): void {
89
+ const parsed = parseRouteIntentState(state);
90
+ withConfigMutationLockSync(() => writeState(parsed, path), dirname(path));
91
+ }
92
+ export function updateRouteIntentState(update: (state: RouteIntentState) => RouteIntentState, path = routeIntentStatePath()): RouteIntentState {
93
+ return withConfigMutationLockSync(() => {
94
+ const next = parseRouteIntentState(update(readRouteIntentState(path)));
95
+ writeState(next, path);
96
+ return next;
97
+ }, dirname(path));
98
+ }
99
+ export function setRouteClientIntent(client: RouteClientId, intent: RouteClientIntent, deviceId?: string): RouteIntentState {
100
+ const parsed = parseRouteClientIntent(intent, client);
101
+ if (!isRouteClientId(client) || !parsed || (deviceId !== undefined && !deviceIdAllowed(deviceId))) throw new Error("invalid route intent selection");
102
+ if (deviceId === "home" && isHomeNativeRouteClient(client)) throw new Error("A Home native decision is its native switch; use recordHomeNativeDecision");
103
+ return updateRouteIntentState(state => {
104
+ const map = deviceId === undefined ? state.defaults : (state.devices[deviceId] ??= {});
105
+ map[client] = { ...map[client], ...parsed };
106
+ if (deviceId !== undefined) advanceRevision(state, deviceId, client);
107
+ return state;
108
+ });
109
+ }
110
+ export function clearRouteClientIntent(client: RouteClientId, deviceId: string): RouteIntentState {
111
+ if (!isRouteClientId(client) || !deviceIdAllowed(deviceId)) throw new Error("invalid route intent selection");
112
+ if (deviceId === "home" && isHomeNativeRouteClient(client)) throw new Error("A Home native decision is its native switch; use recordHomeNativeDecision");
113
+ return updateRouteIntentState(state => {
114
+ const map = state.devices[deviceId];
115
+ if (map) { delete map[client]; if (Object.keys(map).length === 0) delete state.devices[deviceId]; }
116
+ advanceRevision(state, deviceId, client);
117
+ return state;
118
+ });
119
+ }
120
+
121
+ /**
122
+ * Earlier versions recorded Home native decisions as `devices.home` entries. The Home's native
123
+ * switches govern those clients now, so such an entry is dropped instead of pinning anything.
124
+ */
125
+ export function dropHomeNativeOverrides(state: RouteIntentState, clients: readonly HomeNativeRouteClientId[] = HOME_NATIVE_ROUTE_CLIENTS): void {
126
+ const map = state.devices.home;
127
+ if (!map) return;
128
+ for (const client of clients) delete map[client];
129
+ if (Object.keys(map).length === 0) delete state.devices.home;
130
+ }
131
+
132
+ /** Drops those legacy entries from the file, writing only when one is there. */
133
+ export function dropLegacyHomeNativeOverrides(): void {
134
+ withConfigMutationLockSync(() => {
135
+ const map = readRouteIntentState().devices.home;
136
+ if (!map || !HOME_NATIVE_ROUTE_CLIENTS.some(client => map[client] !== undefined)) return;
137
+ updateRouteIntentState(state => { dropHomeNativeOverrides(state); return state; });
138
+ });
139
+ }
140
+
141
+ /**
142
+ * Bookkeeping for a Home decision about a native client, which itself is written to the Home's
143
+ * native switch. No `devices.home` entry is kept. The caller has already captured the Children's
144
+ * native defaults (src/routing/home-route-capture.ts), so the switch never becomes one.
145
+ */
146
+ export function recordHomeNativeDecision(client: HomeNativeRouteClientId): RouteIntentState {
147
+ return updateRouteIntentState(state => {
148
+ dropHomeNativeOverrides(state, [client]);
149
+ return state;
150
+ });
151
+ }
152
+
153
+ /** ocx sync applies route intent to every Home client once the file holds a default or a Home entry. */
154
+ export function homeRouteIntentInUse(state: RouteIntentState): boolean {
155
+ return Object.keys(state.defaults).length > 0 || Object.keys(state.devices.home ?? {}).length > 0;
156
+ }
157
+
158
+ /**
159
+ * A file integration toggle on the Home (the dashboard, `PUT /api/client-integrations/<id>`) is the
160
+ * Home's own decision for that client. Once the Home uses route intent, ocx sync applies it to every
161
+ * client, so the toggle is recorded as a `devices.home` entry and Children keep their defaults.
162
+ * Without route intent nothing is written. Returns whether a decision was recorded.
163
+ */
164
+ export function recordHomeFileIntegrationDecision(client: RouteClientId, intent: RouteClientIntent): boolean {
165
+ if (isHomeNativeRouteClient(client) || client === "aside") return false;
166
+ return withConfigMutationLockSync(() => {
167
+ if (!homeRouteIntentInUse(readRouteIntentState())) return false;
168
+ setRouteClientIntent(client, intent, "home");
169
+ return true;
170
+ });
171
+ }
172
+
173
+ function advanceRevision(state: RouteIntentState, deviceId: string, client: RouteClientId): void {
174
+ const revisions = ((state.revisions ??= {})[deviceId] ??= {});
175
+ const next = (revisions[client] ?? 0) + 1;
176
+ if (!Number.isSafeInteger(next)) throw new Error("route device revision exhausted");
177
+ revisions[client] = next;
178
+ }
@@ -0,0 +1,35 @@
1
+ import { readConfigDiagnostics, withConfigMutationLockSync } from "../config";
2
+ import type { OcxConfig } from "../types";
3
+
4
+ /** Reflect controller-owned fields from current durable state, preserving concurrent settings. */
5
+ export function mirrorRouteNativeSettings(live: OcxConfig, current: OcxConfig): void {
6
+ for (const client of ["codex", "grok", "claude-desktop"] as const) {
7
+ const value = current.clientIntegrations?.[client];
8
+ if (value !== undefined) (live.clientIntegrations ??= {})[client] = value;
9
+ else if (live.clientIntegrations) delete live.clientIntegrations[client];
10
+ }
11
+ for (const key of ["enabled", "authModeMigratedAt"] as const) {
12
+ const value = current.claudeCode?.[key];
13
+ if (value !== undefined) live.claudeCode = { ...live.claudeCode, [key]: value };
14
+ else if (live.claudeCode) delete live.claudeCode[key];
15
+ }
16
+ const messages = current.apiSurfaces?.messages?.enabled;
17
+ if (messages !== undefined) live.apiSurfaces = { ...live.apiSurfaces, messages: { ...live.apiSurfaces?.messages, enabled: messages } };
18
+ else if (live.apiSurfaces?.messages) delete live.apiSurfaces.messages.enabled;
19
+ }
20
+
21
+ export function refreshRouteNativeSettings(live: OcxConfig): void {
22
+ withConfigMutationLockSync(() => {
23
+ const latest = readConfigDiagnostics();
24
+ if (latest.source !== "file" || latest.error) throw new Error("config_unavailable");
25
+ mirrorRouteNativeSettings(live, latest.config);
26
+ });
27
+ }
28
+
29
+ /** A copy carrying the durable native switches; another process may have changed them. */
30
+ export function withDurableRouteNativeSettings(config: OcxConfig): OcxConfig {
31
+ const copy = structuredClone(config);
32
+ const latest = readConfigDiagnostics();
33
+ if (latest.source === "file" && !latest.error) mirrorRouteNativeSettings(copy, latest.config);
34
+ return copy;
35
+ }
@@ -0,0 +1,145 @@
1
+ /** Local CLI reads/applies never relay management writes from a Child to its Home. */
2
+ import { readClientConnectionState } from "../client/state";
3
+ import { withLinkApply } from "../client/link-home";
4
+ import { projectHomeRouteIntent, ROUTE_CLIENT_IDS, type RouteClientId, type RouteClientIntent, type RouteClientOutcome } from "../link/route-intent";
5
+ import { HomeAsideIntentDerivationError, initializeHomeRouteIntentDefaults, readHomeRouteIntentState, readHomeRouteIntentStateAsideTolerant } from "./home-route-intent";
6
+ import { captureHomeRouteDefaults } from "./home-route-capture";
7
+ import { routeToAsideUnresolved, routeToDeviceStatus, type RouteToDeviceStatus, type RouteToStatus } from "./route-to-status";
8
+ import { withDurableRouteNativeSettings } from "./route-to-live-settings";
9
+ import { dropLegacyHomeNativeOverrides, readRouteIntentState, type RouteIntentState } from "./route-intent-state";
10
+ import { readLocalRouteIntentOff, readRouteIntentReceipt, setLocalRouteIntentOff } from "../integrations/route-intent";
11
+ import type { LinkChildContext } from "../cli/link-child";
12
+ import type { OcxConfig } from "../types";
13
+
14
+ /**
15
+ * The Home's status row. Existing Aside ownership without stable userIds and no saved Home Aside
16
+ * decision is reported as unresolved Aside (with `HOME_ASIDE_UNRESOLVED_MESSAGE` in the response)
17
+ * and every other client as usual, so a full sync that left Aside alone can still report the rest.
18
+ */
19
+ export function readHomeRouteToStatus(config: OcxConfig, version: string): RouteToDeviceStatus {
20
+ const local = withDurableRouteNativeSettings(config);
21
+ const { state, asideUnresolved } = readHomeRouteIntentStateAsideTolerant(local);
22
+ const document = projectHomeRouteIntent(local, version, "home", state);
23
+ const receipt = readRouteIntentReceipt();
24
+ const status = routeToDeviceStatus("home", "home", document, receipt?.outcomes ?? [], receipt?.appliedRouteIntentDigest ?? null);
25
+ return asideUnresolved && state.devices.home?.aside === undefined ? routeToAsideUnresolved(status) : status;
26
+ }
27
+
28
+ /** What a full Home sync tells the person when it leaves Aside alone. */
29
+ export const HOME_ASIDE_UNRESOLVED_MESSAGE = "Aside was left unchanged on this Home: its existing Aside profiles have no stable userIds in Aside's accounts.json, so route intent cannot name them. Repair the manifest, or decide Aside for the Home with ocx route to aside on|off --device home.";
30
+
31
+ /**
32
+ * `onlyClient` is the client a single Home write decides: only that client is materialized on the
33
+ * Home. For a native client the decision (`onlyIntent`, else the default Children inherit) is
34
+ * written through the Home's native switch. A sync passes none and never writes a Home native
35
+ * switch: each native client is refreshed to match the switch as it is.
36
+ *
37
+ * A full sync on a Home whose existing Aside ownership cannot be named by stable userIds, and that
38
+ * has no saved Aside decision, leaves Aside exactly as it is and applies every other client, calling
39
+ * `onAsideUnresolved`. A Home upgraded with such profiles therefore keeps a working `ocx sync`;
40
+ * only a write that decides Aside still refuses until the person resolves it.
41
+ *
42
+ * `homeAsideDecision` is the one exception: an explicit `--device home` Aside write is the Home's
43
+ * own decision, so it is applied without deriving the Children's Aside default, which stays absent.
44
+ * The saved `devices.home.aside` entry is what a later full sync reads, so it keeps the decision.
45
+ */
46
+ export async function syncHomeRouteTo(config: OcxConfig, version: string, overwriteConflict = false, overwriteClient?: RouteClientId, commit?: () => void,
47
+ deps: { loadModels?: typeof import("../server/management/model-rows").loadExportModels; materialize?: typeof import("../client/route-intent-apply").materializeLocalRouteIntent;
48
+ onlyClient?: RouteClientId; onlyIntent?: () => RouteClientIntent | undefined; onAsideUnresolved?: (message: string) => void;
49
+ homeAsideDecision?: boolean } = {}): Promise<RouteClientOutcome[]> {
50
+ return withLinkApply(async () => {
51
+ commit?.();
52
+ const local = withDurableRouteNativeSettings(config);
53
+ // A Home-only Aside decision never needs the Children's Aside default; only a write that sets
54
+ // that default (or a full sync reading it) does.
55
+ const leaveAside = deps.homeAsideDecision === true || deps.onlyClient === undefined || deps.onlyClient !== "aside";
56
+ let asideUnresolved = false;
57
+ // The Home's own apply is Home-only: it captures the Children's native defaults only once the
58
+ // Home has a link. A default write's commit above has already captured them. Without a link it
59
+ // saves no defaults, and only drops a legacy devices.home native entry if one is there.
60
+ // A saved Home Aside entry means this apply must not derive the Children's Aside default at all.
61
+ const homeAsideSaved = readRouteIntentState().devices.home?.aside !== undefined;
62
+ try {
63
+ if (homeAsideSaved) captureHomeRouteDefaults(undefined, { whenLinked: true });
64
+ else initializeHomeRouteIntentDefaults(local, version, undefined, { whenLinked: true });
65
+ }
66
+ catch (error) {
67
+ if (!(error instanceof HomeAsideIntentDerivationError) || !leaveAside) throw error;
68
+ // Save what can be saved: the native defaults, never a guessed Aside default.
69
+ captureHomeRouteDefaults(undefined, { whenLinked: true });
70
+ asideUnresolved = true;
71
+ }
72
+ dropLegacyHomeNativeOverrides();
73
+ const decidedIntent = deps.onlyIntent?.();
74
+ let state;
75
+ try { state = readHomeRouteIntentState(local); }
76
+ catch (error) {
77
+ if (!(error instanceof HomeAsideIntentDerivationError) || !leaveAside) throw error;
78
+ asideUnresolved = true;
79
+ // A placeholder so the document is complete; Aside is excluded from materialization below.
80
+ // This placeholder is never saved as a default.
81
+ const pinned: RouteIntentState = readRouteIntentState();
82
+ pinned.defaults.aside = { enabled: false };
83
+ state = readHomeRouteIntentState(local, { state: pinned });
84
+ }
85
+ if (asideUnresolved && (state.devices.home?.aside !== undefined || readRouteIntentState().defaults.aside !== undefined)) asideUnresolved = false;
86
+ const document = projectHomeRouteIntent(local, version, "home", state,
87
+ { decidedClient: deps.onlyClient, ...(decidedIntent ? { decidedIntent } : {}) });
88
+ const { loadExportModels } = await import("../server/management/model-rows");
89
+ const { materializeLocalRouteIntent } = await import("../client/route-intent-apply");
90
+ const materialize = deps.materialize ?? materializeLocalRouteIntent;
91
+ const only = deps.onlyClient !== undefined ? [deps.onlyClient]
92
+ : asideUnresolved ? ROUTE_CLIENT_IDS.filter(client => client !== "aside") : undefined;
93
+ // A single-client write keeps the other clients' last proven outcomes in the Home receipt.
94
+ const scope = only ? { retainSkippedOutcomes: true, ...(deps.onlyClient ? { decidedClient: deps.onlyClient } : {}) } : {};
95
+ const off = ROUTE_CLIENT_IDS.filter(client => !document.clients[client].enabled && (!only || only.includes(client)));
96
+ // Disabling needs no catalog. The off pass keeps the receipt's last served roster, so a decision
97
+ // that only turns clients off completes here without waiting for unrelated model discovery.
98
+ const previousModels = readRouteIntentReceipt()?.models ?? [];
99
+ const offReceipt = await materialize(local, document, previousModels, { overwriteConflict, overwriteClient, onlyClients: off, ...scope });
100
+ if (only && only.every(client => off.includes(client))) {
101
+ if (asideUnresolved) deps.onAsideUnresolved?.(HOME_ASIDE_UNRESOLVED_MESSAGE);
102
+ return asideUnresolved ? offReceipt.outcomes.filter(row => row.client !== "aside") : offReceipt.outcomes;
103
+ }
104
+ const receipt = await materialize(local, document, await (deps.loadModels ?? loadExportModels)(local), { overwriteConflict, overwriteClient,
105
+ ...(only ? { onlyClients: only } : {}), ...scope });
106
+ if (asideUnresolved) deps.onAsideUnresolved?.(HOME_ASIDE_UNRESOLVED_MESSAGE);
107
+ return asideUnresolved ? receipt.outcomes.filter(row => row.client !== "aside") : receipt.outcomes;
108
+ });
109
+ }
110
+
111
+ function assertChild(context: LinkChildContext): void {
112
+ const state = readClientConnectionState();
113
+ if (state.kind !== "connected" || state.value.transport !== "link" || state.value.link?.linkId !== context.linkId) {
114
+ throw new Error("The Remote Link connection changed; retry against the current device");
115
+ }
116
+ }
117
+
118
+ export function readLocalRouteToStatus(context: LinkChildContext): RouteToStatus {
119
+ assertChild(context);
120
+ const receipt = readRouteIntentReceipt();
121
+ if (!receipt) throw new Error("This Child has no recorded route intent. Run ocx route to sync to read and apply its Home intent");
122
+ const stale = receipt.outcomes.filter(row => row.outcome === "stale").map(row => row.client);
123
+ return { schema: "ocx.route-to/1", devices: [routeToDeviceStatus(context.linkId, "this", receipt.document,
124
+ receipt.outcomes, receipt.appliedRouteIntentDigest, readLocalRouteIntentOff())],
125
+ ...(receipt.catalogPending || stale.length ? { deferred: { reason: "intent_or_catalog_pending" as const, clients: stale } } : {}) };
126
+ }
127
+
128
+ export async function syncLocalRouteTo(context: LinkChildContext, overwriteConflict = false,
129
+ deps: { sync?: typeof import("../client/connect").syncConnectedClient } = {}): Promise<RouteToStatus> {
130
+ assertChild(context);
131
+ const { syncConnectedClient } = await import("../client/connect");
132
+ const result = await (deps.sync ?? syncConnectedClient)({ expect: { kind: "link", linkId: context.linkId }, overwriteConflict });
133
+ const status = readLocalRouteToStatus(context);
134
+ if (result.stale) status.deferred ??= { reason: "intent_or_catalog_pending", clients: status.devices[0]!.clients.filter(row => row.applied === "stale").map(row => row.client) };
135
+ return status;
136
+ }
137
+
138
+ export async function setLocalRouteToOff(context: LinkChildContext, client: RouteClientId, off: boolean): Promise<RouteToStatus> {
139
+ await withLinkApply(async () => {
140
+ assertChild(context);
141
+ setLocalRouteIntentOff(client, off);
142
+ });
143
+ // The existing sync takes the lifecycle/config locks and checks the pinned connection again.
144
+ return syncLocalRouteTo(context);
145
+ }
@@ -0,0 +1,94 @@
1
+ import { ROUTE_CLIENT_IDS, routeClientIntentDigest, routeIntentDigest, type HomeRouteIntentDocument, type RouteClientId, type RouteClientOutcome } from "../link/route-intent";
2
+
3
+ export interface RouteToClientStatus {
4
+ client: RouteClientId;
5
+ /**
6
+ * `unresolved`: only Aside, on a device that follows the Children's Aside default while the Home's
7
+ * existing Aside ownership cannot be named by stable userIds. Nothing decides it yet, so it is
8
+ * neither on nor off; the status carries a warning saying how to resolve it.
9
+ */
10
+ intent: "on" | "off" | "unresolved";
11
+ /** `native`: a Home row governed by the Home's own persisted native switch. */
12
+ source: "builtin" | "default" | "device" | "native" | "local";
13
+ applied: RouteClientOutcome["outcome"] | null;
14
+ target?: string;
15
+ }
16
+
17
+ export interface RouteToDeviceStatus {
18
+ id: string;
19
+ alias: string;
20
+ desiredDigest: string;
21
+ appliedRouteIntentDigest: string | null;
22
+ clients: RouteToClientStatus[];
23
+ /**
24
+ * Present only on a device that never reads route intent: an ephemeral `ocx-child` refreshes the
25
+ * Home catalog through ocx sync and nothing else, so it has no client rows.
26
+ */
27
+ routeIntent?: "unsupported";
28
+ reason?: typeof EPHEMERAL_NO_ROUTE_INTENT;
29
+ }
30
+
31
+ /** Why an ephemeral `ocx-child` link has no route intent. */
32
+ export const EPHEMERAL_NO_ROUTE_INTENT = "ephemeral-child-no-route-intent" as const;
33
+
34
+ export type RouteToSyncRow = { id: string; state: "synced" | "failed" | "pending" | "unsupported"; reason?: string };
35
+
36
+ export interface RouteToStatus {
37
+ schema: "ocx.route-to/1";
38
+ devices: RouteToDeviceStatus[];
39
+ syncs?: RouteToSyncRow[];
40
+ deferred?: { reason: "intent_or_catalog_pending"; clients: RouteClientId[] };
41
+ /** Actionable notices about clients the request left alone, such as unresolved Aside on the Home. */
42
+ warnings?: string[];
43
+ }
44
+
45
+ /** The status row of an ephemeral Child: route intent is unsupported, never stale or pending. */
46
+ export function unsupportedRouteToDevice(id: string, alias: string): RouteToDeviceStatus {
47
+ return { id, alias, desiredDigest: "", appliedRouteIntentDigest: null, clients: [], routeIntent: "unsupported", reason: EPHEMERAL_NO_ROUTE_INTENT };
48
+ }
49
+
50
+ /** Report a device's Aside row as unresolved: its projected placeholder is not a decision. */
51
+ export function routeToAsideUnresolved(device: RouteToDeviceStatus): RouteToDeviceStatus {
52
+ return { ...device, clients: device.clients.map(row => row.client === "aside"
53
+ ? { client: "aside", intent: "unresolved", source: row.source, applied: null } : row) };
54
+ }
55
+
56
+ /**
57
+ * Compare receipts with today's intent: an outcome recorded for an earlier intent is stale, never
58
+ * current. That includes an earlier conflict or failure, which says nothing about the new intent.
59
+ */
60
+ export function routeToDeviceStatus(
61
+ id: string,
62
+ alias: string,
63
+ document: HomeRouteIntentDocument,
64
+ outcomes: readonly RouteClientOutcome[],
65
+ appliedDigest: string | null,
66
+ localOff: readonly RouteClientId[] = [],
67
+ ): RouteToDeviceStatus {
68
+ const effective = structuredClone(document);
69
+ for (const row of outcomes) {
70
+ if (row.initialIntent && row.initialRevision === (document.clientRevisions?.[row.client] ?? 0)) {
71
+ effective.clients[row.client] = { ...effective.clients[row.client], ...row.initialIntent };
72
+ effective.sources[row.client] = "device";
73
+ }
74
+ }
75
+ const desiredDigest = routeIntentDigest(effective);
76
+ return {
77
+ id, alias, desiredDigest, appliedRouteIntentDigest: appliedDigest,
78
+ clients: ROUTE_CLIENT_IDS.map(client => {
79
+ const outcome = outcomes.find(row => row.client === client);
80
+ const disabledLocally = localOff.includes(client) || outcome?.source === "local";
81
+ // A receipt without per-client digests only proves its whole-document digest for current rows.
82
+ const outdated = outcome !== undefined && !disabledLocally && outcome.outcome !== "stale"
83
+ && (outcome.intentDigest ? outcome.intentDigest !== routeClientIntentDigest(effective, client)
84
+ : outcome.outcome === "current" && desiredDigest !== appliedDigest);
85
+ return {
86
+ client,
87
+ intent: disabledLocally ? "off" : effective.clients[client].enabled ? "on" : "off",
88
+ source: disabledLocally ? "local" : effective.sources[client],
89
+ applied: outdated ? "stale" : outcome?.outcome ?? null,
90
+ ...(outcome?.target ? { target: outcome.target } : {}),
91
+ };
92
+ }),
93
+ };
94
+ }
@@ -0,0 +1,32 @@
1
+ import { buildExecArgv, remotePinnedSyncArgv } from "../link/ssh-argv";
2
+ import { classifySyncResult } from "../cli/sync-fanout";
3
+ import { requireRemotePlatformFramed } from "../link/remote-platform";
4
+ import { knownHostsFile, runnerFor } from "../server/management/link-route-state";
5
+ import type { ManagementContext } from "../server/management/context";
6
+ import type { RouteClientId } from "../link/route-intent";
7
+ import type { LinkRecord } from "../link/store";
8
+ import { homeRouteIntentWatch } from "../link/route-intent-watch";
9
+ import { EPHEMERAL_NO_ROUTE_INTENT, type RouteToSyncRow } from "./route-to-status";
10
+
11
+ /** Reuse pinned sync: never run on a machine that has disconnected or joined another Home. */
12
+ export async function syncRouteToChild(link: LinkRecord, ctx: ManagementContext, overwriteConflict = false, overwriteClient?: RouteClientId): Promise<Omit<RouteToSyncRow, "id">> {
13
+ // An ephemeral ocx-child never reads route intent; its catalog sync would apply none of it.
14
+ if (link.childKind === "ephemeral") return { state: "unsupported", reason: EPHEMERAL_NO_ROUTE_INTENT };
15
+ if (link.direction === "client-initiated") {
16
+ const notified = homeRouteIntentWatch.notify(link.id);
17
+ return { state: "pending", reason: overwriteConflict
18
+ ? "Reconciliation requested without conflict overwrite; run ocx route to sync --overwrite-conflict on the Child to authorize local overwrites"
19
+ : notified ? "Immediate reconciliation requested; awaiting the Child apply report"
20
+ : "No active Child watcher; pending next sync tick. Run ocx route to sync on the Child for immediate apply" };
21
+ }
22
+ try {
23
+ const runner = runnerFor(ctx);
24
+ const knownHosts = knownHostsFile(ctx);
25
+ const platform = link.remotePlatform ?? await requireRemotePlatformFramed(runner, link.alias, link.explicitRoute ?? null, knownHosts);
26
+ const result = await runner.run(buildExecArgv({ alias: link.alias, knownHostsFile: knownHosts, route: link.explicitRoute ?? null, argv: remotePinnedSyncArgv(link.id, platform, overwriteConflict, overwriteClient) }), { timeoutMs: 60_000, maxOutputBytes: 64 * 1024 });
27
+ const verdict = classifySyncResult(result);
28
+ return verdict.state === "synced" ? { state: "synced" } : { state: "failed", reason: verdict.reason ?? "child-sync-failed" };
29
+ } catch {
30
+ return { state: "failed", reason: "child-sync-unavailable" };
31
+ }
32
+ }
@@ -12,6 +12,26 @@ function selectWire(provider: OcxProviderConfig, adapter: string): OcxProviderCo
12
12
  return { ...provider, adapter, ...(stripMarker ? { apiKey: undefined } : {}) };
13
13
  }
14
14
 
15
+ /**
16
+ * Project only the captured exact-model custom-tool contract onto a call-local provider copy.
17
+ * The captured route policy already folds the provider value under any model declaration, so a
18
+ * refreshed transport cannot add or keep a capability the captured route did not resolve. Native
19
+ * compact uses this alone: it keeps the provider's own wire and credential.
20
+ */
21
+ export function projectCapturedCustomToolPolicy(
22
+ provider: OcxProviderConfig,
23
+ staticPolicy: ResolvedModelPolicy | undefined,
24
+ ): OcxProviderConfig {
25
+ if (!staticPolicy) return provider;
26
+ const supportsResponsesCustomTools = staticPolicy.model.supportsResponsesCustomTools;
27
+ if (supportsResponsesCustomTools === provider.supportsResponsesCustomTools) return provider;
28
+ if (supportsResponsesCustomTools === undefined) {
29
+ const { supportsResponsesCustomTools: _discardedLiveCapability, ...captured } = provider;
30
+ return captured;
31
+ }
32
+ return { ...provider, supportsResponsesCustomTools };
33
+ }
34
+
15
35
  /**
16
36
  * Resolve the wire a single model should use: a hard pin first, then a configured
17
37
  * per-model override, then a registry default for a mixed-wire provider, then the provider's
@@ -35,7 +55,7 @@ export function resolveWireProtocolOverride(
35
55
  // RouteResult policy is recaptured for the original inbound protocol whenever routing selects
36
56
  // or replaces a destination, so every downstream rebuild consumes the same adapter authority.
37
57
  if (staticPolicy) {
38
- return selectWire(providerConfig, staticPolicy.model.adapter);
58
+ return projectCapturedCustomToolPolicy(selectWire(providerConfig, staticPolicy.model.adapter), staticPolicy);
39
59
  }
40
60
  const pinned = pinnedWireAdapter(providerName, modelId, providerConfig);
41
61
  if (pinned && providerConfig.adapter !== pinned) {
@@ -3,6 +3,7 @@ import { withCors, type RequestPolicyView } from "./auth-cors";
3
3
  import { runAdmittedBodyWork } from "./inbound-body-admission";
4
4
  import { tryAdmitTurn, type ActiveTurnLease } from "./lifecycle";
5
5
  import { addFinalRequestLog } from "./request-log";
6
+ import { requestBodyFactsHolder } from "./request-body-facts";
6
7
  import { sessionLaneIdFromRequest } from "./request-log-conversation";
7
8
  import { admitHttpWorkflowTurn, workflowDecisionRefusalResponse, type WorkflowRefusalLog } from "./workflow-refusal";
8
9
 
@@ -23,6 +24,8 @@ export function createAdmittedHttpTurn(
23
24
  options?: AdmittedHttpTurnOptions,
24
25
  ): Promise<Response> {
25
26
  const map = (response: Response) => options?.mapRefusal ? options.mapRefusal(response) : response;
27
+ // The row carries the size and encoding of the body this turn's handler reads from `req` (#3023).
28
+ if (refusalLog) refusalLog.logCtx.requestBodyHolder ??= requestBodyFactsHolder(req);
26
29
  const lease = tryAdmitTurn(sessionLaneIdFromRequest(req.headers), req.signal);
27
30
  if (!lease) {
28
31
  const response = serverBusyResponse(req, "active turns", policy);