@bitkyc08/opencodex 2.100.2 → 2.100.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (561) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-BV4ms9U9.js} +1 -1
  6. package/gui/dist/assets/{brand-mark-DU-0Vdkr.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/{index-DJEkIDAi.css → index-DQtCRNAw.css} +1 -1
  9. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/{quota-summary-CakPe9Ni.js → quota-summary-Dy5_wfTT.js} +1 -1
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +3 -3
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/protobuf-request.ts +8 -8
  38. package/src/adapters/cursor.ts +7 -6
  39. package/src/adapters/google-antigravity-wire.ts +7 -5
  40. package/src/adapters/google-wire-compiler.ts +2 -2
  41. package/src/adapters/google.ts +9 -2
  42. package/src/adapters/kiro/payload.ts +7 -4
  43. package/src/adapters/kiro/reasoning.ts +44 -1
  44. package/src/adapters/kiro/structured-output.ts +10 -8
  45. package/src/adapters/kiro-tools.ts +61 -15
  46. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  47. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  48. package/src/adapters/zed.ts +3 -0
  49. package/src/advisor/consult.ts +15 -4
  50. package/src/advisor/context.ts +12 -3
  51. package/src/advisor/runtime.ts +35 -5
  52. package/src/advisor/settings.ts +8 -0
  53. package/src/advisor/synthetic-tool.ts +21 -8
  54. package/src/bridge/response-json.ts +11 -2
  55. package/src/bridge/sse.ts +43 -8
  56. package/src/claude/auth-detect.ts +21 -33
  57. package/src/claude/desktop-3p.ts +11 -5
  58. package/src/claude/desktop-gateway-state.ts +2 -0
  59. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  60. package/src/claude/desktop-remote-store.ts +24 -4
  61. package/src/claude/inbound-content-options.ts +31 -16
  62. package/src/claude/outbound.ts +13 -3
  63. package/src/cli/account-api.ts +17 -1
  64. package/src/cli/account-auth.ts +54 -21
  65. package/src/cli/account-key-quota.ts +34 -5
  66. package/src/cli/account.ts +4 -2
  67. package/src/cli/advisor.ts +7 -4
  68. package/src/cli/alias.ts +38 -1
  69. package/src/cli/capabilities-access-remote.ts +128 -3
  70. package/src/cli/capabilities-accounts.ts +3 -3
  71. package/src/cli/capabilities-agents-routing.ts +17 -10
  72. package/src/cli/capabilities-base.ts +41 -16
  73. package/src/cli/capabilities-integrations.ts +2 -2
  74. package/src/cli/capabilities-provider-models.ts +18 -2
  75. package/src/cli/capabilities-route-to.ts +43 -0
  76. package/src/cli/capabilities.ts +2 -0
  77. package/src/cli/capability-contracts.ts +1 -1
  78. package/src/cli/claude-desktop.ts +30 -11
  79. package/src/cli/claude.ts +17 -3
  80. package/src/cli/codex-launcher.ts +3 -1
  81. package/src/cli/codex-shim-autorestore.ts +5 -42
  82. package/src/cli/config-command.ts +14 -1
  83. package/src/cli/config-root-startup.ts +34 -0
  84. package/src/cli/connect.ts +88 -16
  85. package/src/cli/desktop-runtime-guidance.ts +1 -1
  86. package/src/cli/disconnect-runtime.ts +168 -0
  87. package/src/cli/dispatch.ts +54 -12
  88. package/src/cli/export-command.ts +1 -1
  89. package/src/cli/gui-pair-client.ts +6 -3
  90. package/src/cli/gui.ts +10 -5
  91. package/src/cli/help-catalog.ts +11 -0
  92. package/src/cli/help.ts +4 -3
  93. package/src/cli/index.ts +83 -92
  94. package/src/cli/inspect.ts +11 -2
  95. package/src/cli/integrations.ts +26 -1
  96. package/src/cli/link-capture.ts +64 -0
  97. package/src/cli/link-child-ops.ts +218 -40
  98. package/src/cli/link-cleanup.ts +8 -5
  99. package/src/cli/link-diagnostics.ts +67 -0
  100. package/src/cli/link-enrollment.ts +158 -12
  101. package/src/cli/link-operations.ts +52 -0
  102. package/src/cli/link-recover.ts +152 -0
  103. package/src/cli/link-routes.ts +87 -0
  104. package/src/cli/link-status-child.ts +44 -1
  105. package/src/cli/link-status-traffic.ts +34 -0
  106. package/src/cli/link.ts +314 -37
  107. package/src/cli/message-command.ts +1 -1
  108. package/src/cli/message-mcp-command.ts +23 -10
  109. package/src/cli/models-runtime.ts +3 -3
  110. package/src/cli/opencode.ts +3 -1
  111. package/src/cli/pi-sync.ts +35 -0
  112. package/src/cli/preflight-exemptions.ts +46 -0
  113. package/src/cli/registry.ts +28 -12
  114. package/src/cli/restart-failure.ts +5 -2
  115. package/src/cli/root.ts +5 -1
  116. package/src/cli/route-to.ts +172 -0
  117. package/src/cli/runtime-api.ts +5 -8
  118. package/src/cli/status.ts +3 -1
  119. package/src/cli/stop-approval.ts +66 -19
  120. package/src/cli/stop-report.ts +23 -0
  121. package/src/cli/stop-windows-checked.ts +304 -0
  122. package/src/cli/sync-command.ts +70 -15
  123. package/src/cli/sync-fanout.ts +74 -19
  124. package/src/cli/sync-flags.ts +40 -3
  125. package/src/cli/sync-link-status.ts +18 -2
  126. package/src/cli/sync-update-guard.ts +7 -2
  127. package/src/cli/system-restart-client.ts +3 -2
  128. package/src/cli/uninstall-plan.ts +77 -5
  129. package/src/cli/uninstall-stop.ts +152 -0
  130. package/src/cli/v2-input.ts +10 -6
  131. package/src/cli/v2-local-output.ts +3 -2
  132. package/src/cli/v2-runtime.ts +10 -3
  133. package/src/cli/v2.ts +22 -7
  134. package/src/client/connect.ts +321 -34
  135. package/src/client/link-home-features.ts +27 -0
  136. package/src/client/link-home.ts +92 -4
  137. package/src/client/link-ingress.ts +21 -3
  138. package/src/client/link-join.ts +12 -2
  139. package/src/client/link-parity-reporter.ts +60 -6
  140. package/src/client/link-relay-transport.ts +161 -36
  141. package/src/client/link-relay.ts +150 -6
  142. package/src/client/link-request-compression.ts +84 -0
  143. package/src/client/link-state.ts +11 -5
  144. package/src/client/link-status.ts +39 -1
  145. package/src/client/link-teardown.ts +1 -0
  146. package/src/client/link-tunnel.ts +56 -5
  147. package/src/client/link-websocket-limits.ts +89 -0
  148. package/src/client/link-websocket.ts +586 -0
  149. package/src/client/link-ws-advertisement.ts +100 -0
  150. package/src/client/link-ws-framer.ts +241 -0
  151. package/src/client/link-ws-transport.ts +177 -0
  152. package/src/client/machine-api.ts +13 -2
  153. package/src/client/machine-listener.ts +48 -7
  154. package/src/client/route-intent-apply.ts +293 -0
  155. package/src/client/route-intent-file-originals.ts +97 -0
  156. package/src/client/route-intent-native-originals.ts +201 -0
  157. package/src/client/route-intent-watch.ts +141 -0
  158. package/src/client/runtime-restart.ts +127 -5
  159. package/src/client/runtime.ts +61 -15
  160. package/src/client/state.ts +30 -0
  161. package/src/client/sync-expectation.ts +36 -2
  162. package/src/client/sync-runtime.ts +7 -0
  163. package/src/clients/config-export/alias-selectors.ts +63 -40
  164. package/src/clients/config-export/contracts.ts +2 -0
  165. package/src/clients/config-export/nested-selectors.ts +42 -0
  166. package/src/clients/config-export.ts +22 -3
  167. package/src/codex/account-store.ts +12 -3
  168. package/src/codex/account-usability.ts +13 -0
  169. package/src/codex/auth-api/account-list.ts +29 -3
  170. package/src/codex/auth-collision.ts +23 -22
  171. package/src/codex/auth-context.ts +21 -6
  172. package/src/codex/catalog/gather-capture.ts +8 -2
  173. package/src/codex/catalog/parsing.ts +7 -3
  174. package/src/codex/catalog/provider-models.ts +54 -15
  175. package/src/codex/catalog/retained-sync.ts +2 -1
  176. package/src/codex/catalog/routed-gather.ts +1 -1
  177. package/src/codex/catalog-auto-refresh.ts +11 -0
  178. package/src/codex/cli-update-job.ts +35 -13
  179. package/src/codex/convergence.ts +2 -2
  180. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  181. package/src/codex/features.ts +2 -2
  182. package/src/codex/history-provider.ts +31 -0
  183. package/src/codex/inject/multi-agent-v2.ts +9 -3
  184. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  185. package/src/codex/inject/plan.ts +20 -2
  186. package/src/codex/inject.ts +2 -0
  187. package/src/codex/journal-config-restore.ts +217 -0
  188. package/src/codex/journal.ts +75 -6
  189. package/src/codex/main-account.ts +23 -30
  190. package/src/codex/native-main-auth-file.ts +104 -0
  191. package/src/codex/native-profile-manager.ts +4 -3
  192. package/src/codex/native-profile-store.ts +3 -61
  193. package/src/codex/orca-import.ts +10 -1
  194. package/src/codex/quota-history.ts +13 -0
  195. package/src/codex/quota-window-conflict.ts +103 -0
  196. package/src/codex/quota.ts +23 -1
  197. package/src/codex/subagent-model-fallback.ts +3 -1
  198. package/src/codex/websocket-activity.ts +171 -16
  199. package/src/codex/websocket-registry.ts +11 -4
  200. package/src/combos/cooldown-store.ts +25 -5
  201. package/src/combos/failover.ts +330 -2
  202. package/src/config/dashboard-trusted-proxy.ts +83 -0
  203. package/src/config/diagnostics.ts +28 -0
  204. package/src/config/feature-flags.ts +9 -0
  205. package/src/config/live-reconcile.ts +10 -1
  206. package/src/config/load-degrade.ts +12 -1
  207. package/src/config/multi-agent-surface.ts +28 -5
  208. package/src/config/pending-teardown.ts +60 -3
  209. package/src/config/process-state.ts +175 -4
  210. package/src/config/provider-validation.ts +4 -4
  211. package/src/config/schema/config-schema.ts +6 -0
  212. package/src/config/schema/leaf-validators.ts +9 -2
  213. package/src/config/windows-process-command-line.ts +107 -0
  214. package/src/generated/compatibility-version.json +948 -392
  215. package/src/generated/model-metadata.ts +1 -1
  216. package/src/images/loop.ts +3 -0
  217. package/src/integrations/model-name-guard.ts +25 -0
  218. package/src/integrations/route-intent-catalog.ts +26 -0
  219. package/src/integrations/route-intent-connected.ts +262 -0
  220. package/src/integrations/route-intent-contract.ts +55 -0
  221. package/src/integrations/route-intent-disconnect.ts +109 -0
  222. package/src/integrations/route-intent-initial.ts +64 -0
  223. package/src/integrations/route-intent-state.ts +117 -0
  224. package/src/integrations/route-intent-tick.ts +65 -0
  225. package/src/integrations/route-intent.ts +212 -0
  226. package/src/integrations/writer.ts +44 -11
  227. package/src/lib/client-retry-after.ts +29 -0
  228. package/src/lib/config-ownership.ts +13 -0
  229. package/src/lib/desktop-gui-origin.ts +28 -0
  230. package/src/lib/errors.ts +1 -1
  231. package/src/lib/gui-pair-capability.ts +2 -1
  232. package/src/lib/messages-error-body.ts +4 -1
  233. package/src/lib/outbound-credential-registry.ts +362 -4
  234. package/src/lib/paced-stream.ts +34 -0
  235. package/src/lib/passive-key-fetch-proof.ts +30 -0
  236. package/src/lib/passive-read.ts +5 -0
  237. package/src/lib/process-control.ts +76 -12
  238. package/src/lib/redact.ts +84 -8
  239. package/src/lib/state-store-registrations.ts +11 -0
  240. package/src/lib/state-store-sweeper.ts +4 -0
  241. package/src/lib/supervisor-markers.ts +18 -0
  242. package/src/lib/terminal-safe-text.ts +58 -0
  243. package/src/lib/translator-budget.ts +3 -2
  244. package/src/lib/upstream-retry.ts +14 -4
  245. package/src/link/alias-lock.ts +119 -0
  246. package/src/link/child-activity.ts +28 -2
  247. package/src/link/child-binary-cache-fill.d.mts +50 -0
  248. package/src/link/child-binary-cache-fill.mjs +494 -0
  249. package/src/link/child-binary-cache-start.ts +73 -0
  250. package/src/link/child-binary-source.ts +12 -5
  251. package/src/link/child-gated-ocx.ts +29 -11
  252. package/src/link/child-observations.ts +2 -1
  253. package/src/link/child-observe.ts +2 -2
  254. package/src/link/child-ops-engine.ts +159 -91
  255. package/src/link/child-ops-host.ts +138 -0
  256. package/src/link/child-ops-runners.ts +319 -0
  257. package/src/link/child-ops-scheduler.ts +207 -0
  258. package/src/link/child-ops-types.ts +89 -0
  259. package/src/link/child-parity.ts +23 -4
  260. package/src/link/child-policy.ts +93 -0
  261. package/src/link/child-update-contract.ts +12 -3
  262. package/src/link/codex-settings.ts +1 -1
  263. package/src/link/compatibility.ts +18 -1
  264. package/src/link/diagnostics-read.ts +163 -0
  265. package/src/link/diagnostics.ts +20 -7
  266. package/src/link/explicit-route.ts +209 -0
  267. package/src/link/link-recover.ts +113 -0
  268. package/src/link/management-routes.ts +3 -1
  269. package/src/link/operation-recovery-slot.ts +44 -0
  270. package/src/link/operations-journal.ts +408 -0
  271. package/src/link/peer-report.ts +1 -1
  272. package/src/link/relay-auth.ts +14 -0
  273. package/src/link/remote-plant.ts +152 -14
  274. package/src/link/remote-platform.ts +21 -10
  275. package/src/link/remote-probe.ts +11 -3
  276. package/src/link/remote-windows.ts +50 -10
  277. package/src/link/request-compression.ts +30 -0
  278. package/src/link/residual-recovery.ts +54 -0
  279. package/src/link/retirement.ts +128 -0
  280. package/src/link/route-intent-watch.ts +41 -0
  281. package/src/link/route-intent.ts +209 -0
  282. package/src/link/route-proof.ts +82 -0
  283. package/src/link/route-rounds.ts +579 -0
  284. package/src/link/route-select.ts +95 -0
  285. package/src/link/route-trust.ts +96 -0
  286. package/src/link/ssh-argv.ts +172 -24
  287. package/src/link/ssh-capture-redact.ts +253 -0
  288. package/src/link/ssh-capture.ts +497 -0
  289. package/src/link/ssh-runner.ts +141 -14
  290. package/src/link/status-projection.ts +87 -0
  291. package/src/link/store.ts +54 -1
  292. package/src/link/supervisor.ts +543 -55
  293. package/src/link/sync-fanout-classify.ts +16 -0
  294. package/src/link/sync-then-restart.ts +65 -0
  295. package/src/link/tombstones.ts +209 -0
  296. package/src/link/traffic.ts +178 -0
  297. package/src/link/ws-activity-holds.ts +474 -0
  298. package/src/local-credentials/publication-fence.ts +20 -1
  299. package/src/messaging/mcp-queue-rpc.ts +1 -1
  300. package/src/messaging/mcp-queue-server.ts +16 -1
  301. package/src/messaging/mcp-resume-tools.ts +25 -0
  302. package/src/messaging/remote-enrollment.ts +3 -3
  303. package/src/messaging/remote-tunnels.ts +2 -2
  304. package/src/messaging/resume-permissions.ts +27 -0
  305. package/src/messaging/rpc.ts +46 -2
  306. package/src/oauth/anthropic-continuity.ts +23 -7
  307. package/src/oauth/anthropic-routing.ts +5 -2
  308. package/src/oauth/anthropic.ts +22 -2
  309. package/src/oauth/claude-keychain-read.ts +78 -68
  310. package/src/oauth/index.ts +24 -6
  311. package/src/oauth/local-token-detect.ts +8 -29
  312. package/src/oauth/login-cli-errors.ts +5 -1
  313. package/src/oauth/login-cli.ts +33 -18
  314. package/src/oauth/login-flow-state.ts +26 -3
  315. package/src/oauth/meta-muse.ts +1 -1
  316. package/src/oauth/store.ts +7 -0
  317. package/src/oauth/xai.ts +248 -14
  318. package/src/protocols/contract.ts +4 -0
  319. package/src/protocols/encoders/messages.ts +1 -0
  320. package/src/providers/alias-template.ts +48 -0
  321. package/src/providers/anthropic-billing-ownership.ts +2 -0
  322. package/src/providers/anthropic-output-caps.ts +46 -0
  323. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  324. package/src/providers/antigravity-effort-families.ts +11 -3
  325. package/src/providers/antigravity-models.ts +32 -9
  326. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  327. package/src/providers/api-key-pause.ts +3 -0
  328. package/src/providers/api-key-resolve.ts +49 -7
  329. package/src/providers/api-key-response-ownership.ts +2 -0
  330. package/src/providers/api-key-selection.ts +51 -9
  331. package/src/providers/api-keys.ts +6 -2
  332. package/src/providers/cache-affinity-identity.ts +73 -0
  333. package/src/providers/cache-affinity.ts +256 -0
  334. package/src/providers/default-aliases.ts +98 -20
  335. package/src/providers/google-vertex-model-discovery.ts +510 -0
  336. package/src/providers/key-failover.ts +123 -8
  337. package/src/providers/key-store.ts +3 -3
  338. package/src/providers/kiro-models.ts +3 -5
  339. package/src/providers/label.ts +31 -5
  340. package/src/providers/mistral-transport.ts +17 -4
  341. package/src/providers/model-rename-fields.ts +3 -0
  342. package/src/providers/muse-key-quota.ts +14 -6
  343. package/src/providers/new-model-policy-runtime.ts +17 -4
  344. package/src/providers/new-model-policy.ts +30 -4
  345. package/src/providers/passive-key-observation.ts +252 -0
  346. package/src/providers/quota/account-cache.ts +2 -1
  347. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  348. package/src/providers/quota/passive-key-limits.ts +272 -0
  349. package/src/providers/quota/passive-wire-model.ts +126 -0
  350. package/src/providers/quota/report-cache.ts +61 -2
  351. package/src/providers/quota-key-accounts.ts +11 -6
  352. package/src/providers/quota-types.ts +18 -0
  353. package/src/providers/quota.ts +11 -12
  354. package/src/providers/registry/entries-core.ts +34 -16
  355. package/src/providers/registry/entries-extended.ts +32 -0
  356. package/src/providers/registry/model-seeds.ts +35 -0
  357. package/src/providers/resolved-model-policy.ts +7 -0
  358. package/src/providers/routed-config.ts +8 -3
  359. package/src/providers/xai-transport.ts +3 -0
  360. package/src/remote/features.ts +17 -0
  361. package/src/responses/anthropic-progress.ts +10 -4
  362. package/src/responses/citation-markers.ts +231 -0
  363. package/src/responses/spill-store.ts +5 -1
  364. package/src/responses/state/replay-input.ts +50 -0
  365. package/src/responses/state/replay-owner.ts +24 -0
  366. package/src/responses/state/snapshot-codec.ts +9 -0
  367. package/src/responses/state/spill-queue.ts +1 -0
  368. package/src/responses/state.ts +42 -60
  369. package/src/router.ts +2 -2
  370. package/src/routing/home-route-capture.ts +123 -0
  371. package/src/routing/home-route-intent.ts +200 -0
  372. package/src/routing/route-intent-state.ts +178 -0
  373. package/src/routing/route-to-live-settings.ts +35 -0
  374. package/src/routing/route-to-local.ts +145 -0
  375. package/src/routing/route-to-status.ts +94 -0
  376. package/src/routing/route-to-sync-child.ts +32 -0
  377. package/src/server/adapter-resolve.ts +21 -1
  378. package/src/server/admitted-http-turn.ts +3 -0
  379. package/src/server/auth-cors.ts +98 -0
  380. package/src/server/bare-upstream-error.ts +220 -0
  381. package/src/server/chat-native.ts +14 -5
  382. package/src/server/claude-messages.ts +6 -4
  383. package/src/server/codex-model-list.ts +2 -1
  384. package/src/server/configured-credentials.ts +37 -5
  385. package/src/server/gui-desktop-authorization.ts +36 -0
  386. package/src/server/gui-pair-delivery.ts +6 -3
  387. package/src/server/gui-session.ts +10 -1
  388. package/src/server/inbound-body-admission.ts +17 -4
  389. package/src/server/index/link-listener.ts +190 -12
  390. package/src/server/index/link-management.ts +15 -1
  391. package/src/server/index/link-relay-sessions.ts +87 -8
  392. package/src/server/index/link-websocket-limits.ts +136 -0
  393. package/src/server/index/link-websocket.ts +692 -0
  394. package/src/server/index/optional-listeners.ts +97 -7
  395. package/src/server/index/route-intent-watch.ts +47 -0
  396. package/src/server/index/serve-contract.ts +86 -0
  397. package/src/server/index/serve-options.ts +35 -86
  398. package/src/server/index/startup-warnings.ts +8 -2
  399. package/src/server/index/websocket-handler.ts +26 -4
  400. package/src/server/index.ts +12 -2
  401. package/src/server/inference/client-encoder-delivery.ts +2 -0
  402. package/src/server/inspection-tee.ts +39 -2
  403. package/src/server/lifecycle.ts +2 -0
  404. package/src/server/link-turn.ts +137 -0
  405. package/src/server/management/advisor-routes.ts +10 -2
  406. package/src/server/management/agent-settings-routes.ts +50 -16
  407. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  408. package/src/server/management/context.ts +9 -2
  409. package/src/server/management/desktop-authorization.ts +41 -0
  410. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  411. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  412. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  413. package/src/server/management/home-integration-decision.ts +89 -0
  414. package/src/server/management/integration-routes.ts +208 -81
  415. package/src/server/management/link-child-ops-routes.ts +145 -43
  416. package/src/server/management/link-child-preflight.ts +31 -0
  417. package/src/server/management/link-diagnostics-route.ts +29 -0
  418. package/src/server/management/link-enrollment.ts +199 -47
  419. package/src/server/management/link-operation.ts +609 -0
  420. package/src/server/management/link-recover-route.ts +103 -0
  421. package/src/server/management/link-route-edit.ts +173 -0
  422. package/src/server/management/link-route-request.ts +62 -0
  423. package/src/server/management/link-route-state.ts +83 -7
  424. package/src/server/management/link-routes.ts +553 -51
  425. package/src/server/management/link-traffic-status.ts +13 -0
  426. package/src/server/management/model-routes.ts +122 -36
  427. package/src/server/management/model-rows.ts +2 -1
  428. package/src/server/management/native-integration-routes.ts +176 -70
  429. package/src/server/management/oauth-account-routes.ts +36 -13
  430. package/src/server/management/protocol-routes.ts +7 -0
  431. package/src/server/management/provider-completion-test.ts +4 -4
  432. package/src/server/management/provider-overwrite-carry.ts +11 -0
  433. package/src/server/management/provider-routes.ts +64 -61
  434. package/src/server/management/provider-routing-quota.ts +45 -0
  435. package/src/server/management/route-registry.ts +22 -3
  436. package/src/server/management/route-to-routes.ts +257 -0
  437. package/src/server/management/system-restart.ts +4 -2
  438. package/src/server/management/usage-aggregate-cache.ts +101 -66
  439. package/src/server/management-api.ts +17 -3
  440. package/src/server/management-auth.ts +13 -1
  441. package/src/server/messages-native-preflight.ts +27 -4
  442. package/src/server/messages-native.ts +17 -5
  443. package/src/server/persistent-gui-session.ts +6 -3
  444. package/src/server/proxy-liveness.ts +33 -6
  445. package/src/server/relay-eager.ts +36 -12
  446. package/src/server/relay.ts +183 -116
  447. package/src/server/request-body-facts.ts +48 -0
  448. package/src/server/request-decompress.ts +65 -2
  449. package/src/server/request-log-account-rotation.ts +6 -0
  450. package/src/server/request-log-attempt-usage.ts +69 -0
  451. package/src/server/request-log-cache-affinity.ts +60 -0
  452. package/src/server/request-log-conversation.ts +45 -2
  453. package/src/server/request-log-terminal-status.ts +210 -24
  454. package/src/server/request-log.ts +71 -79
  455. package/src/server/responses/adapter-continuation.ts +2 -1
  456. package/src/server/responses/adapter-delivery.ts +2 -0
  457. package/src/server/responses/adapter-dispatch.ts +5 -7
  458. package/src/server/responses/advisor-plan-slot.ts +33 -1
  459. package/src/server/responses/advisor-question.ts +21 -0
  460. package/src/server/responses/advisor-slot.ts +10 -3
  461. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  462. package/src/server/responses/buffered-sse-json.ts +9 -3
  463. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  464. package/src/server/responses/codex-tool-catalog.ts +156 -0
  465. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  466. package/src/server/responses/combo-stream-preflight.ts +557 -54
  467. package/src/server/responses/compact.ts +32 -8
  468. package/src/server/responses/core-codex-account.ts +17 -3
  469. package/src/server/responses/core-combo-failure.ts +8 -0
  470. package/src/server/responses/core-combo.ts +32 -4
  471. package/src/server/responses/core-errors.ts +5 -2
  472. package/src/server/responses/core-lifetime.ts +3 -2
  473. package/src/server/responses/core-normalize.ts +3 -1
  474. package/src/server/responses/core-options.ts +6 -0
  475. package/src/server/responses/core.ts +2 -0
  476. package/src/server/responses/fetch-helpers.ts +15 -10
  477. package/src/server/responses/native-replay-guard.ts +57 -0
  478. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  479. package/src/server/responses/outbound-request-body.ts +29 -0
  480. package/src/server/responses/passthrough-completion.ts +105 -8
  481. package/src/server/responses/passthrough-delivery.ts +31 -11
  482. package/src/server/responses/passthrough-dispatch.ts +74 -73
  483. package/src/server/responses/policy-fallback.ts +13 -1
  484. package/src/server/responses/request-prepare.ts +50 -6
  485. package/src/server/responses/request-transport.ts +10 -3
  486. package/src/server/responses/reset-replay.ts +46 -2
  487. package/src/server/responses/run-turn-execution.ts +2 -0
  488. package/src/server/responses/sidecar-execution.ts +14 -0
  489. package/src/server/responses/terminal-error-redaction.ts +222 -25
  490. package/src/server/responses/ws-upstream.ts +2 -2
  491. package/src/server/sse-payload-rewrite.ts +3 -2
  492. package/src/server/stop-service-route.ts +85 -0
  493. package/src/server/system-env-shell.ts +12 -1
  494. package/src/server/system-env.ts +5 -3
  495. package/src/server/windows-tcp-drop.ts +21 -4
  496. package/src/server/workflow-refusal.ts +8 -0
  497. package/src/server/ws-bridge.ts +191 -12
  498. package/src/service/cli-windows-stop.ts +189 -0
  499. package/src/service/cli.ts +41 -12
  500. package/src/service/disconnected-client-restart.ts +60 -0
  501. package/src/service/guarded-manager-target.ts +18 -1
  502. package/src/service/health.ts +99 -6
  503. package/src/service/launchd.ts +84 -31
  504. package/src/service/orchestration.ts +418 -91
  505. package/src/service/repair.ts +223 -6
  506. package/src/service/restart-proxy-stop.ts +79 -0
  507. package/src/service/service-child-ownership.ts +6 -2
  508. package/src/service/windows-checked-stop-live.ts +467 -0
  509. package/src/service/windows-checked-stop.ts +435 -0
  510. package/src/service/windows-command-line-token.ts +23 -0
  511. package/src/service/windows-guarded-manager.ts +77 -34
  512. package/src/service/windows-ops.ts +38 -56
  513. package/src/service/windows-process-evidence.ts +292 -0
  514. package/src/service/windows-process-native.ts +262 -0
  515. package/src/service/windows-service-stop.ts +321 -0
  516. package/src/service/windows-stop-binding.ts +187 -0
  517. package/src/service/windows-stop-budget.ts +123 -0
  518. package/src/service/windows-stop-confirm.ts +158 -0
  519. package/src/service/windows-stop-deadline.ts +56 -0
  520. package/src/service.ts +2 -2
  521. package/src/types/config.ts +42 -18
  522. package/src/types/link.ts +20 -0
  523. package/src/types/multi-agent.ts +13 -0
  524. package/src/types/provider.ts +47 -2
  525. package/src/types/request.ts +4 -0
  526. package/src/types.ts +3 -0
  527. package/src/update/guarded-runtime-ops.ts +5 -7
  528. package/src/update/index.ts +25 -10
  529. package/src/update/install-detection.mjs +3 -1
  530. package/src/update/job-pinned-start.ts +2 -0
  531. package/src/update/job-windows-restart.ts +19 -32
  532. package/src/update/job.ts +12 -5
  533. package/src/update/npm-install.d.mts +11 -0
  534. package/src/update/npm-install.mjs +44 -7
  535. package/src/update/orchestrated-entry.ts +1 -1
  536. package/src/update/orchestrated-node-driver.mjs +3 -2
  537. package/src/update/orchestrated-pnpm.d.mts +4 -0
  538. package/src/update/orchestrated-pnpm.mjs +50 -6
  539. package/src/update/orchestrated-session.d.mts +3 -1
  540. package/src/update/orchestrated-session.mjs +21 -6
  541. package/src/update/pnpm-global-install.d.mts +21 -3
  542. package/src/update/pnpm-global-install.mjs +322 -19
  543. package/src/update/pnpm-store-layout.mjs +46 -0
  544. package/src/update/sync-update-mutex.d.mts +3 -2
  545. package/src/update/sync-update-mutex.mjs +57 -8
  546. package/src/update/transactional-install.d.mts +3 -1
  547. package/src/update/transactional-install.mjs +545 -12
  548. package/src/update/windows-installer-marker.d.mts +1 -0
  549. package/src/update/windows-installer-marker.mjs +44 -0
  550. package/src/usage/expected-prices.ts +8 -0
  551. package/src/usage/filter-index.ts +326 -77
  552. package/src/usage/ledger-scanner.ts +15 -0
  553. package/src/usage/link-log-fields.ts +48 -0
  554. package/src/usage/log.ts +43 -2
  555. package/src/usage/request-body.ts +37 -0
  556. package/src/web-search/loop.ts +3 -0
  557. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  558. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  559. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  560. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  561. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -47,7 +47,7 @@ const DATA: Record<string, readonly Row[]> = {
47
47
  "azure-openai": [["gpt-4.1",1047576,32768,"text,image",0,null,2,8,0.5,0],["gpt-4o",128000,16384,"text,image",0,null,2.5,10,1.25,0],["gpt-4o-mini",128000,16384,"text,image",0,null,0.15,0.6,0.075,0],["o3",200000,100000,"text,image",1,null,2,8,0.5,0],["o3-mini",200000,100000,"text",1,null,1.1,4.4,0.55,0]],
48
48
  "cerebras": [["gemma-4-31b",131072,40960,"text,image",1,null,0.99,1.49,0,0],["gpt-oss-120b",131072,40960,"text",1,null,0.35,0.75,0,0],["llama3.1-8b",32000,8000,"text",0,null,0.1,0.1,0,0],["qwen-3-235b-a22b-instruct-2507",131000,32000,"text",0,null,0.6,1.2,0,0],["qwen-3-coder-480b",131072,32768,"text",0,null,0,0,0,0],["zai-glm-4.6",131072,32768,"text",0,null,0,0,0,0],["zai-glm-4.7",131072,40960,"text",1,null,2.25,2.75,2.25,0]],
49
49
  "deepseek": [["deepseek-v4-flash",1048576,384000,"text",1,null,0.14,0.28,0.0028,0],["deepseek-v4-pro",1048576,384000,"text",1,null,0.435,0.87,0.003625,0]],
50
- "google": [["deep-research-max-preview-04-2026",131072,65536,"text,image",1,null,2,12,0.2,0],["deep-research-preview-04-2026",131072,65536,"text,image",1,null,2,12,0.2,0],["gemini-1.5-flash",1000000,8192,"text,image",0,null,0.075,0.3,0.01875,0],["gemini-1.5-flash-8b",1000000,8192,"text,image",0,null,0.0375,0.15,0.01,0],["gemini-1.5-pro",1000000,8192,"text,image",0,null,1.25,5,0.3125,0],["gemini-2.0-flash",1048576,8192,"text,image",0,null,0.1,0.4,0.025,0],["gemini-2.0-flash-lite",1048576,8192,"text,image",0,null,0.075,0.3,0,0],["gemini-2.5-computer-use-preview-10-2025",131072,65536,"text,image",1,null,1.25,10,0,0],["gemini-2.5-flash",1048576,65536,"text,image",1,null,0.3,2.5,0.03,0],["gemini-2.5-flash-lite",1048576,65536,"text,image",1,null,0.1,0.4,0.01,0],["gemini-2.5-flash-lite-preview-06-17",1048576,65536,"text,image",1,null,0.1,0.4,0.025,0],["gemini-2.5-flash-lite-preview-09-2025",1048576,65536,"text,image",1,null,0.1,0.4,0.025,0],["gemini-2.5-flash-preview-04-17",1048576,65536,"text,image",1,null,0.15,0.6,0.0375,0],["gemini-2.5-flash-preview-05-20",1048576,65536,"text,image",1,null,0.15,0.6,0.0375,0],["gemini-2.5-flash-preview-09-2025",1048576,65536,"text,image",1,null,0.3,2.5,0.075,0],["gemini-2.5-pro",1048576,65536,"text,image",1,null,1.25,10,0.125,0],["gemini-2.5-pro-preview-05-06",1048576,65536,"text,image",1,null,1.25,10,0.31,0],["gemini-2.5-pro-preview-06-05",1048576,65536,"text,image",1,null,1.25,10,0.31,0],["gemini-3-flash-preview",1048576,65536,"text,image",1,null,0.5,3,0.05,0],["gemini-3-pro-preview",1048576,65536,"text,image",1,null,2,12,0.2,0],["gemini-3.1-flash-lite",1048576,65536,"text,image",1,null,0.25,1.5,0.025,0],["gemini-3.1-flash-lite-image",65536,65536,"text,image",1,null,0.25,30,0,0],["gemini-3.1-flash-lite-preview",1048576,65536,"text,image",1,null,0.25,1.5,0.025,0],["gemini-3.1-flash-live-preview",131072,65536,"text,image",1,null,0.75,4.5,0,0],["gemini-3.1-pro-preview",1048576,65536,"text,image",1,null,2,12,0.2,0],["gemini-3.1-pro-preview-customtools",1048576,65536,"text,image",1,null,2,12,0.2,0],["gemini-3.5-flash",1048576,65536,"text,image",1,null,1.5,9,0.15,0],["gemini-3.5-flash-lite",1048576,65536,"text,image",1,null,0.3,2.5,0.03,0],["gemini-3.6-flash",1048576,65536,"text,image",1,null,1.5,7.5,0.15,0],["gemini-3.7-flash",1048576,65536,"text,image",1],["gemini-3.8-flash",1048576,65536,"text,image",1],["gemini-4-argon",1048576,65536,"text,image",1],["gemini-flash-latest",1048576,65536,"text,image",1,null,1.5,9,0.15,0],["gemini-flash-lite-latest",1048576,65536,"text,image",1,null,0.25,1.5,0.025,0],["gemini-live-2.5-flash",128000,8000,"text,image",1,null,0.5,2,0,0],["gemini-live-2.5-flash-preview-native-audio",131072,65536,"text",1,null,0.5,2,0,0],["gemini-robotics-er-1.6-preview",131072,65536,"text,image",1,null,1,5,0,0],["gemma-3-27b-it",131072,8192,"text,image",0,null,0,0,0,0],["gemma-4-26b",256000,8192,"text,image",1,null,0,0,0,0],["gemma-4-26b-a4b-it",262144,32768,"text,image",1,null,0,0,0,0],["gemma-4-26b-it",256000,8192,"text,image",1,null,0,0,0,0],["gemma-4-31b",256000,8192,"text,image",1,null,0,0,0,0],["gemma-4-31b-it",262144,32768,"text,image",1,null,0,0,0,0],["gemma-4-E2B-it",131072,8192,"text,image",1,null,0,0,0,0],["gemma-4-E4B-it",131072,8192,"text,image",1,null,0,0,0,0]],
50
+ "google": [["deep-research-max-preview-04-2026",131072,65536,"text,image",1,null,2,12,0.2,0],["deep-research-preview-04-2026",131072,65536,"text,image",1,null,2,12,0.2,0],["gemini-1.5-flash",1000000,8192,"text,image",0,null,0.075,0.3,0.01875,0],["gemini-1.5-flash-8b",1000000,8192,"text,image",0,null,0.0375,0.15,0.01,0],["gemini-1.5-pro",1000000,8192,"text,image",0,null,1.25,5,0.3125,0],["gemini-2.0-flash",1048576,8192,"text,image",0,null,0.1,0.4,0.025,0],["gemini-2.0-flash-lite",1048576,8192,"text,image",0,null,0.075,0.3,0,0],["gemini-2.5-computer-use-preview-10-2025",131072,65536,"text,image",1,null,1.25,10,0,0],["gemini-2.5-flash",1048576,65536,"text,image",1,null,0.3,2.5,0.03,0],["gemini-2.5-flash-lite",1048576,65536,"text,image",1,null,0.1,0.4,0.01,0],["gemini-2.5-flash-lite-preview-06-17",1048576,65536,"text,image",1,null,0.1,0.4,0.025,0],["gemini-2.5-flash-lite-preview-09-2025",1048576,65536,"text,image",1,null,0.1,0.4,0.025,0],["gemini-2.5-flash-preview-04-17",1048576,65536,"text,image",1,null,0.15,0.6,0.0375,0],["gemini-2.5-flash-preview-05-20",1048576,65536,"text,image",1,null,0.15,0.6,0.0375,0],["gemini-2.5-flash-preview-09-2025",1048576,65536,"text,image",1,null,0.3,2.5,0.075,0],["gemini-2.5-pro",1048576,65536,"text,image",1,null,1.25,10,0.125,0],["gemini-2.5-pro-preview-05-06",1048576,65536,"text,image",1,null,1.25,10,0.31,0],["gemini-2.5-pro-preview-06-05",1048576,65536,"text,image",1,null,1.25,10,0.31,0],["gemini-3-flash-preview",1048576,65536,"text,image",1,null,0.5,3,0.05,0],["gemini-3-pro-preview",1048576,65536,"text,image",1,null,2,12,0.2,0],["gemini-3.1-flash-lite",1048576,65536,"text,image",1,null,0.25,1.5,0.025,0],["gemini-3.1-flash-lite-image",65536,65536,"text,image",1,null,0.25,30,0,0],["gemini-3.1-flash-lite-preview",1048576,65536,"text,image",1,null,0.25,1.5,0.025,0],["gemini-3.1-flash-live-preview",131072,65536,"text,image",1,null,0.75,4.5,0,0],["gemini-3.1-pro-preview",1048576,65536,"text,image",1,null,2,12,0.2,0],["gemini-3.1-pro-preview-customtools",1048576,65536,"text,image",1,null,2,12,0.2,0],["gemini-3.5-flash",1048576,65536,"text,image",1,null,1.5,9,0.15,0],["gemini-3.5-flash-lite",1048576,65536,"text,image",1,null,0.3,2.5,0.03,0],["gemini-3.6-flash",1048576,65536,"text,image",1,null,1.5,7.5,0.15,0],["gemini-3.7-flash",1048576,65536,"text,image",1],["gemini-3.8-flash",1048576,65536,"text,image",1],["gemini-4-argon",1048576,65536,"text,image",1],["gemini-4-carbon",1048576,65536,"text,image",1],["gemini-4-hydrogen",1048576,65536,"text,image",1],["gemini-flash-latest",1048576,65536,"text,image",1,null,1.5,9,0.15,0],["gemini-flash-lite-latest",1048576,65536,"text,image",1,null,0.25,1.5,0.025,0],["gemini-live-2.5-flash",128000,8000,"text,image",1,null,0.5,2,0,0],["gemini-live-2.5-flash-preview-native-audio",131072,65536,"text",1,null,0.5,2,0,0],["gemini-robotics-er-1.6-preview",131072,65536,"text,image",1,null,1,5,0,0],["gemma-3-27b-it",131072,8192,"text,image",0,null,0,0,0,0],["gemma-4-26b",256000,8192,"text,image",1,null,0,0,0,0],["gemma-4-26b-a4b-it",262144,32768,"text,image",1,null,0,0,0,0],["gemma-4-26b-it",256000,8192,"text,image",1,null,0,0,0,0],["gemma-4-31b",256000,8192,"text,image",1,null,0,0,0,0],["gemma-4-31b-it",262144,32768,"text,image",1,null,0,0,0,0],["gemma-4-E2B-it",131072,8192,"text,image",1,null,0,0,0,0],["gemma-4-E4B-it",131072,8192,"text,image",1,null,0,0,0,0]],
51
51
  "minimax": [["MiniMax-M2",196608,128000,"text",1,null,0.3,1.2,0,0],["MiniMax-M2.1",204800,131072,"text",1,null,0.3,1.2,0,0],["MiniMax-M2.5",204800,131072,"text",1,null,0.3,1.2,0.03,0.375],["MiniMax-M2.5-highspeed",204800,131072,"text",1,null,0.6,2.4,0.06,0.375],["MiniMax-M2.5-lightning",204800,32000,"text",1,null,0.3,2.4,0,0],["MiniMax-M2.7",204800,131072,"text",1,null,0.3,1.2,0.06,0.375],["MiniMax-M2.7-highspeed",204800,131072,"text",1,null,0.6,2.4,0.06,0.375],["minimax-m3",512000,128000,"text,image",1,null,0.6,2.4,0.12,0],["MiniMax-M3",1000000,128000,"text,image,video",1,null,0.3,1.2,0.06,0],["MiniMax-M3.1-Flash",1000000,524288,"text,image,video",1,null,0.15,0.6,0.015,0]],
52
52
  "mistral": [["codestral-latest",256000,4096,"text",0,null,0.3,0.9,0,0],["devstral-2512",262144,262144,"text",0,null,0.4,2,0,0],["devstral-latest",262144,262144,"text",0,null,0.4,2,0,0],["devstral-medium-2507",128000,128000,"text",0,null,0.4,2,0,0],["devstral-medium-latest",262144,262144,"text",0,null,0.4,2,0,0],["devstral-small-2505",128000,128000,"text",0,null,0.1,0.3,0,0],["devstral-small-2507",128000,128000,"text",0,null,0.1,0.3,0,0],["labs-devstral-small-2512",256000,256000,"text,image",0,null,0,0,0,0],["magistral-medium-latest",128000,16384,"text",1,null,2,5,0,0],["magistral-small",128000,128000,"text",1,null,0.5,1.5,0,0],["ministral-3b-latest",128000,128000,"text",0,null,0.04,0.04,0,0],["ministral-8b-latest",128000,128000,"text",0,null,0.1,0.1,0,0],["mistral-large-2411",131072,16384,"text",0,null,2,6,0,0],["mistral-large-2512",262144,262144,"text,image",0,null,0.5,1.5,0,0],["mistral-large-latest",262144,262144,"text,image",0,null,0.5,1.5,0,0],["mistral-medium-2505",131072,131072,"text,image",0,null,0.4,2,0,0],["mistral-medium-2508",262144,262144,"text,image",0,null,0.4,2,0,0],["mistral-medium-2604",262144,262144,"text,image",1,null,1.5,7.5,0,0],["mistral-medium-latest",262144,262144,"text,image",1,null,1.5,7.5,0,0],["mistral-nemo",128000,128000,"text",0,null,0.15,0.15,0,0],["mistral-small-2506",128000,16384,"text,image",0,null,0.1,0.3,0,0],["mistral-small-2603",256000,256000,"text,image",1,null,0.15,0.6,0,0],["mistral-small-latest",256000,256000,"text,image",1,null,0.15,0.6,0,0],["open-mistral-7b",8000,8000,"text",0,null,0.25,0.25,0,0],["open-mistral-nemo",128000,128000,"text",0,null,0.15,0.15,0,0],["open-mixtral-8x22b",64000,64000,"text",0,null,2,6,0,0],["open-mixtral-8x7b",32000,32000,"text",0,null,0.7,0.7,0,0],["pixtral-12b",128000,128000,"text,image",0,null,0.15,0.15,0,0],["pixtral-large-latest",128000,128000,"text,image",0,null,2,6,0,0]],
53
53
  "moonshot": [["kimi-k2.5",262144,65536,"text,image",1,null,0,0,0,0]],
@@ -391,6 +391,8 @@ export interface ImageBridgeDeps {
391
391
  forceEmptyResponseId?: boolean;
392
392
  /** Responses inbound only: deliver a non-retryable upstream refusal as `response.failed`. */
393
393
  terminalRefusalAsFailed?: boolean;
394
+ /** False for Chat/Messages inbound: their clients never parse `<oai-mem-citation>`, so text stays raw. */
395
+ escapeMemoryCitationTags?: boolean;
394
396
  }
395
397
 
396
398
  /**
@@ -1221,6 +1223,7 @@ export async function runWithImageBridge(deps: ImageBridgeDeps): Promise<Respons
1221
1223
  ...(deps.clientToolCatalogRestriction ? { ...deps.clientToolCatalogRestriction, enforceDeclaredToolNames: false } : {}),
1222
1224
  ...(deps.forceEmptyResponseId ? { responseId: "" } : {}),
1223
1225
  ...(deps.terminalRefusalAsFailed ? { terminalRefusalAsFailed: true } : {}),
1226
+ ...(deps.escapeMemoryCitationTags === false ? { escapeMemoryCitationTags: false } : {}),
1224
1227
  hideThinkingSummary: parsed.options.hideThinkingSummary,
1225
1228
  chatRawReasoningVisible: deps.chatRawReasoningVisible,
1226
1229
  hideRawReasoning: parsed.options.hideRawReasoning,
@@ -1,16 +1,41 @@
1
1
  import { namedExportContext } from "../clients/config-export/alias-selectors";
2
+ import { attachNestedSelectors } from "../clients/config-export/nested-selectors";
2
3
  import { supportsAliasModelNames } from "../clients/config-export/model-names";
3
4
  import type { OcxConfig } from "../types";
4
5
  import { observeIntegration, type IntegrationPlanOperation, type IntegrationWriteInput } from "./mutation-plan";
5
6
  import { exportContextOf } from "./state";
6
7
  import type { WriteRefused } from "./writer";
7
8
 
9
+ /**
10
+ * Pi's raw nested selectors were proven against the serving configuration when the roster loaded
11
+ * (#8172). A configuration or inventory change during the coordinator awaits retires that proof, so
12
+ * a selector that no longer reaches the same model refuses the write instead of being installed.
13
+ */
14
+ function staleNestedSelectorRefusal(
15
+ input: IntegrationWriteInput,
16
+ liveConfig: OcxConfig,
17
+ operation: IntegrationPlanOperation,
18
+ ): WriteRefused | null {
19
+ if ((operation !== "apply" && operation !== "overwrite") || input.clientId !== "pi") return null;
20
+ const captured = exportContextOf(input).models;
21
+ if (!captured.some(model => model.nestedNamespaced !== undefined)) return null;
22
+ const current = attachNestedSelectors(liveConfig, captured);
23
+ const stale = captured.some((model, index) => model.nestedNamespaced !== undefined
24
+ && model.nestedNamespaced !== current[index]?.nestedNamespaced);
25
+ return stale ? {
26
+ ok: false, clientId: input.clientId, state: "conflict", reason: "conflict",
27
+ message: "model selectors changed while applying; retry with the current catalog",
28
+ } : null;
29
+ }
30
+
8
31
  /** Final synchronous admission after all coordinator awaits, before maintenance or writes. */
9
32
  export function staleModelNameRefusal(
10
33
  input: IntegrationWriteInput,
11
34
  liveConfig: OcxConfig,
12
35
  operation: IntegrationPlanOperation,
13
36
  ): WriteRefused | null {
37
+ const nested = staleNestedSelectorRefusal(input, liveConfig, operation);
38
+ if (nested) return nested;
14
39
  if ((operation !== "apply" && operation !== "overwrite") || !supportsAliasModelNames(input.clientId)
15
40
  || (input.modelNames !== undefined && input.modelNames !== "alias")) return null;
16
41
  const context = { ...exportContextOf(input), modelNames: "alias" as const };
@@ -0,0 +1,26 @@
1
+ /** Passive routing facts only. No catalog discovery, persistence, targets, or credentials. */
2
+ import { comboPublicModelId, isValidComboId } from "../combos/identifiers";
3
+ import type { OcxConfig } from "../types";
4
+
5
+ export const MAX_ROUTE_CATALOG_BYTES = 1024 * 1024;
6
+ export interface RouteCatalogFacts { version: 1; combos: Array<{ publicId: string; comboId: string }> }
7
+ export function parseRouteCatalogFacts(raw: unknown): RouteCatalogFacts | null {
8
+ if (!raw || typeof raw !== "object" || Array.isArray(raw) || Object.keys(raw).sort().join(",") !== "combos,version"
9
+ || !("version" in raw) || raw.version !== 1 || !("combos" in raw) || !Array.isArray(raw.combos) || raw.combos.length > 4096) return null;
10
+ const seen = new Set<string>();
11
+ const combos: RouteCatalogFacts["combos"] = [];
12
+ for (const row of raw.combos) {
13
+ if (!row || typeof row !== "object" || Array.isArray(row) || Object.keys(row).sort().join(",") !== "comboId,publicId"
14
+ || typeof row.comboId !== "string" || !isValidComboId(row.comboId) || typeof row.publicId !== "string"
15
+ || !row.publicId || row.publicId.length > 512 || /[\x00-\x1f\x7f]/.test(row.publicId) || seen.has(row.publicId)) return null;
16
+ seen.add(row.publicId); combos.push({ publicId: row.publicId, comboId: row.comboId });
17
+ }
18
+ return { version: 1, combos };
19
+ }
20
+ export function projectRouteCatalogFacts(config: OcxConfig): RouteCatalogFacts {
21
+ const facts = parseRouteCatalogFacts({ version: 1, combos: Object.entries(config.combos ?? {}).map(([comboId, combo]) => ({
22
+ publicId: comboPublicModelId(comboId, combo), comboId,
23
+ })) });
24
+ if (!facts || Buffer.byteLength(JSON.stringify(facts)) > MAX_ROUTE_CATALOG_BYTES) throw new Error("Route catalog facts are invalid or too large");
25
+ return facts;
26
+ }
@@ -0,0 +1,262 @@
1
+ /** Read-only Home fetches, followed by local materialization under the caller's sync fence. */
2
+ import type { ExportModel } from "../clients/config-export";
3
+ import { loadConfig } from "../config";
4
+ import { withClientLifecycleSync } from "../client/lifecycle-lock";
5
+ import { nativeOpenAiSlugs } from "../codex/catalog/metadata";
6
+ import { COMBO_NAMESPACE } from "../combos/identifiers";
7
+ import type { LocalRouteIntentOptions } from "../client/route-intent-apply";
8
+ import { clearHomeRouteIntentRecord, fetchHomeRouteIntent, homeRouteIntentReceipt, linkBoundFetch, readHomeRouteIntentRecord,
9
+ writeHomeRouteIntentRecord, type LinkHomeConnection, type LinkHomeDeps } from "../client/link-home";
10
+ import { readBoundedResponseBytes } from "../lib/bounded-body";
11
+ import { ROUTE_CLIENT_IDS, type HomeRouteIntentDocument } from "../link/route-intent";
12
+ import type { OcxClientConnectionConfig } from "../types";
13
+ import type { RouteIntentReceipt } from "./route-intent-contract";
14
+ import { clearRouteIntentUnappliedProof, effectiveRouteIntent, readLocalRouteIntentOff, readRouteIntentReceipt, readRouteIntentReceiptStrict,
15
+ writeRouteIntentReceipt } from "./route-intent-state";
16
+ import { resolveInitialRouteIntent, initialRouteOutcomeMetadata } from "./route-intent-initial";
17
+ import { LINK_ROUTE_CATALOG_PATH } from "../link/management-routes";
18
+ import { MAX_ROUTE_CATALOG_BYTES, parseRouteCatalogFacts } from "./route-intent-catalog";
19
+ import { canonicalizeReasoningEfforts, isDeclaredReasoningEffort } from "../reasoning-effort";
20
+
21
+ /** Modalities the exporters serialize; anything else a served row declares is dropped. */
22
+ const SERVED_INPUT_MODALITIES: ReadonlySet<string> = new Set(["text", "image", "video", "audio"]);
23
+ const MAX_SERVED_EFFORTS = 16;
24
+
25
+ /**
26
+ * The capability fields a Home's `/v1/models` row carries (see `modelCapabilityFields` in
27
+ * `src/server/models-capabilities.ts`), read strictly from the served document.
28
+ *
29
+ * The row is remote input, so every value is type- and range-checked here and a malformed
30
+ * field is dropped rather than forwarded: one bad modality or a non-numeric window would
31
+ * either empty a Pi config or make a client offer a control the Home cannot honour. Nothing
32
+ * is synthesized — a field the row omits stays absent, exactly as `toExportModel` projects
33
+ * the local `/api/models` rows.
34
+ */
35
+ function servedCapabilities(row: object): Partial<ExportModel> {
36
+ const capabilities = "capabilities" in row && row.capabilities && typeof row.capabilities === "object"
37
+ && !Array.isArray(row.capabilities) ? row.capabilities as Record<string, unknown> : {};
38
+ const top = row as Record<string, unknown>;
39
+ const limit = (value: unknown): number | undefined => typeof value === "number" && Number.isSafeInteger(value) && value > 0
40
+ ? value : undefined;
41
+ const flag = (value: unknown): boolean | undefined => typeof value === "boolean" ? value : undefined;
42
+ const modalities = (value: unknown): string[] | undefined => {
43
+ if (!Array.isArray(value)) return undefined;
44
+ const kept: string[] = [];
45
+ for (const entry of value) {
46
+ if (typeof entry !== "string" || !SERVED_INPUT_MODALITIES.has(entry) || kept.includes(entry)) continue;
47
+ kept.push(entry);
48
+ }
49
+ return kept.length > 0 ? kept : undefined;
50
+ };
51
+ const efforts = (value: unknown): string[] | undefined => {
52
+ if (!Array.isArray(value)) return undefined;
53
+ const kept: string[] = [];
54
+ for (const entry of value) {
55
+ const effort = typeof entry === "string" ? entry
56
+ : entry && typeof entry === "object" && "value" in entry && typeof entry.value === "string" ? entry.value : undefined;
57
+ if (effort === undefined || !isDeclaredReasoningEffort(effort) || kept.includes(effort)) continue;
58
+ kept.push(effort);
59
+ if (kept.length >= MAX_SERVED_EFFORTS) break;
60
+ }
61
+ return kept.length > 0 ? canonicalizeReasoningEfforts(kept) : undefined;
62
+ };
63
+ const contextWindow = limit(top.context_window) ?? limit(top.context_length) ?? limit(capabilities.context_length);
64
+ const maxTokens = limit(top.max_output_tokens) ?? limit(capabilities.max_output_tokens);
65
+ const inputModalities = modalities(capabilities.input_modalities);
66
+ const reasoningEfforts = efforts(top.reasoning_efforts) ?? efforts(capabilities.reasoning_effort);
67
+ const supportsReasoning = flag(capabilities.supports_reasoning);
68
+ const supportsThinkingToggle = flag(capabilities.supports_thinking_toggle);
69
+ const supportsReasoningEffort = flag(capabilities.supports_reasoning_effort);
70
+ const defaultThinkingEnabled = flag(capabilities.default_thinking_enabled);
71
+ const declaredDefault = typeof top.reasoning_effort === "string" && isDeclaredReasoningEffort(top.reasoning_effort)
72
+ ? top.reasoning_effort
73
+ : Array.isArray(top.reasoning_efforts)
74
+ ? top.reasoning_efforts.find(option => option && typeof option === "object" && "default" in option && option.default === true
75
+ && "value" in option && typeof option.value === "string")?.value
76
+ : undefined;
77
+ const defaultReasoningEffort = declaredDefault !== undefined && reasoningEfforts?.includes(declaredDefault) ? declaredDefault : undefined;
78
+ return {
79
+ ...(contextWindow !== undefined ? { contextWindow } : {}),
80
+ ...(maxTokens !== undefined ? { maxTokens } : {}),
81
+ ...(inputModalities ? { inputModalities } : {}),
82
+ ...(reasoningEfforts ? { reasoningEfforts } : {}),
83
+ ...(supportsReasoning !== undefined ? { supportsReasoning } : {}),
84
+ ...(supportsThinkingToggle !== undefined ? { supportsThinkingToggle } : {}),
85
+ ...(supportsReasoningEffort !== undefined ? { supportsReasoningEffort } : {}),
86
+ ...(defaultThinkingEnabled !== undefined ? { defaultThinkingEnabled } : {}),
87
+ ...(defaultReasoningEffort !== undefined ? { defaultReasoningEffort } : {}),
88
+ };
89
+ }
90
+
91
+ export interface PreparedConnectedRouteIntent { document: HomeRouteIntentDocument; fetchedAt: string; stale: boolean; localOnly?: true }
92
+
93
+ /**
94
+ * The Home's `/v1/models` expands a listed combo into synthetic selectors the route catalog does
95
+ * not list: `<base>--fast` (src/server/fast-row.ts) and `<base>--<effort>` (src/server/effort-row.ts).
96
+ * Such a row routes to its base combo, so its identity is the base's when that base is verified.
97
+ * Returns the base public id the selector grammar names, or undefined when it is not one.
98
+ */
99
+ function expandedComboBase(publicId: string): string | undefined {
100
+ const separator = publicId.lastIndexOf("--");
101
+ if (separator <= 0) return undefined;
102
+ const suffix = publicId.slice(separator + 2);
103
+ if (suffix !== "fast" && (suffix === "none" || !isDeclaredReasoningEffort(suffix))) return undefined;
104
+ return publicId.slice(0, separator);
105
+ }
106
+
107
+ /** Provisioning preview; connect records its enabled-only choices after enrollment. */
108
+ export function initialConnectRouteIntent(
109
+ prepared: PreparedConnectedRouteIntent | undefined, selected: OcxClientConnectionConfig["selectedClients"], explicit = false,
110
+ ): PreparedConnectedRouteIntent | undefined {
111
+ if (!prepared || !explicit) return prepared;
112
+ const document = structuredClone(prepared.document);
113
+ for (const client of ROUTE_CLIENT_IDS) {
114
+ const enabled = selected.includes(client);
115
+ if (client === "codex" || client === "claude" || enabled) {
116
+ document.clients[client] = { ...document.clients[client], enabled };
117
+ document.sources[client] = "device";
118
+ }
119
+ }
120
+ return { ...prepared, document };
121
+ }
122
+
123
+ export async function prepareConnectedRouteIntent(
124
+ connection: LinkHomeConnection, token: string, deps?: LinkHomeDeps, beforeWrite?: () => void,
125
+ ): Promise<PreparedConnectedRouteIntent | undefined> {
126
+ if (connection.transport !== "link" || !connection.link) return undefined;
127
+ const fetched = await fetchHomeRouteIntent(connection, token, deps);
128
+ if (fetched.kind === "fresh") return { document: resolveInitialRouteIntent(connection.link.linkId, fetched.document, beforeWrite), fetchedAt: new Date().toISOString(), stale: false };
129
+ const previous = fetched.kind === "failed" ? readHomeRouteIntentRecord(connection.link.linkId) : null;
130
+ return previous ? { document: resolveInitialRouteIntent(connection.link.linkId, previous.document, beforeWrite), fetchedAt: previous.fetchedAt, stale: true } : undefined;
131
+ }
132
+
133
+ export function connectedRouteSelectedClients(prepared: PreparedConnectedRouteIntent | undefined, fallback: OcxClientConnectionConfig["selectedClients"]) {
134
+ const off = new Set(readLocalRouteIntentOff());
135
+ return prepared ? effectiveRouteIntent(prepared.document).selectedClients : fallback.filter(id => !off.has(id));
136
+ }
137
+
138
+ /** Read the exact /v1/models rows this Child relays, preserving ids byte-for-byte. */
139
+ export async function loadConnectedRouteModels(connection: LinkHomeConnection, token: string, deps: LinkHomeDeps = {}): Promise<ExportModel[]> {
140
+ if (!connection.link) throw new Error("A Link connection is required for the local served roster");
141
+ const fetchImpl = deps.fetchImpl ?? linkBoundFetch(connection, token);
142
+ const response = await fetchImpl(`http://127.0.0.1:${connection.link.tunnelPort}/v1/models`, {
143
+ method: "GET", headers: { authorization: `Bearer ${token}` }, redirect: "manual", signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000),
144
+ });
145
+ if (!response.ok) { await response.body?.cancel(); throw new Error("The Child served model roster is unavailable"); }
146
+ const body = await readBoundedResponseBytes(response, { maxBytes: 8 * 1024 * 1024, signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000) });
147
+ if (body.oversized) throw new Error("The Child served model roster is too large");
148
+ const raw: unknown = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(body.bytes));
149
+ if (!raw || typeof raw !== "object" || !("data" in raw) || !Array.isArray(raw.data)) throw new Error("Invalid Child served model roster");
150
+ const seen = new Set<string>();
151
+ const nativeIds = new Set(nativeOpenAiSlugs());
152
+ const comboIdentity = new Map<string, string>();
153
+ if (raw.data.some(row => row && typeof row === "object" && row.is_combo === true)) {
154
+ // is_combo describes the inbound adapter in owned_by. This separate passive projection
155
+ // contains only public selectors and canonical combo keys, never model discovery.
156
+ const response = await fetchImpl(`http://127.0.0.1:${connection.link.tunnelPort}${LINK_ROUTE_CATALOG_PATH}`, {
157
+ method: "GET", headers: { authorization: `Bearer ${token}` }, redirect: "manual", signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000),
158
+ });
159
+ if (!response.ok) { await response.body?.cancel(); throw new Error("Combo route identity is unavailable"); }
160
+ const body = await readBoundedResponseBytes(response, { maxBytes: MAX_ROUTE_CATALOG_BYTES, signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000) });
161
+ if (body.oversized) throw new Error("Combo metadata is too large");
162
+ const facts = parseRouteCatalogFacts(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(body.bytes)));
163
+ if (!facts) throw new Error("Invalid combo route metadata");
164
+ for (const row of facts.combos) comboIdentity.set(row.publicId, row.comboId);
165
+ }
166
+ return raw.data.flatMap((row: unknown): ExportModel[] => {
167
+ if (!row || typeof row !== "object" || !("id" in row) || typeof row.id !== "string" || !row.id || seen.has(row.id)) {
168
+ throw new Error("Invalid or duplicate Child served model identifier");
169
+ }
170
+ seen.add(row.id);
171
+ const owner = "owned_by" in row ? row.owned_by : undefined;
172
+ if ("is_combo" in row && row.is_combo === true) {
173
+ const listed = comboIdentity.get(row.id);
174
+ const base = listed === undefined ? expandedComboBase(row.id) : undefined;
175
+ // An expanded selector whose base is not verified is left out on its own: it never fails
176
+ // the rest of the roster, and its id is never trusted.
177
+ if (base !== undefined && !comboIdentity.has(base)) return [];
178
+ const id = listed ?? (base === undefined ? undefined : comboIdentity.get(base));
179
+ if (!id) throw new Error("The served combo has no verified route identity");
180
+ return [{ namespaced: row.id, provider: COMBO_NAMESPACE, id, ...servedCapabilities(row) }];
181
+ }
182
+ const canonical = "native_id" in row ? row.native_id : row.id;
183
+ if (typeof canonical !== "string" || !canonical || canonical !== canonical.trim() || canonical.length > 4096 || /[\x00-\x1f\x7f]/.test(canonical)) {
184
+ throw new Error("Invalid canonical served model identity");
185
+ }
186
+ const slash = canonical.indexOf("/");
187
+ const native = slash < 0 && owner !== COMBO_NAMESPACE && (nativeIds.has(canonical) || owner === "openai");
188
+ if (slash < 0 && !native) throw new Error("The served alias has no verified canonical route identity");
189
+ if (!native && (slash === 0 || slash === canonical.length - 1)) throw new Error("Invalid canonical routed model identity");
190
+ return [{ namespaced: row.id, provider: native ? "openai" : canonical.slice(0, slash),
191
+ id: native ? canonical : canonical.slice(slash + 1), ...(native ? { native: true } : {}), ...servedCapabilities(row) }];
192
+ });
193
+ }
194
+
195
+ export async function applyConnectedRouteIntent(
196
+ connection: OcxClientConnectionConfig, token: string, prepared: PreparedConnectedRouteIntent | undefined,
197
+ options: LocalRouteIntentOptions, deps: LinkHomeDeps = {},
198
+ ): Promise<RouteIntentReceipt | undefined> {
199
+ if (!connection.link) return undefined;
200
+ const localOff = readLocalRouteIntentOff(options.statePath);
201
+ if (!prepared && localOff.length > 0) {
202
+ const previous = readRouteIntentReceipt(options.statePath);
203
+ const document: HomeRouteIntentDocument = previous?.document ?? { version: 1, home: { name: "Home", version: "unavailable" },
204
+ clients: Object.fromEntries(ROUTE_CLIENT_IDS.map(id => [id, { enabled: connection.selectedClients.includes(id) }])) as HomeRouteIntentDocument["clients"],
205
+ sources: Object.fromEntries(ROUTE_CLIENT_IDS.map(id => [id, "builtin"])) as HomeRouteIntentDocument["sources"] };
206
+ prepared = { document, stale: true, fetchedAt: new Date().toISOString(), localOnly: true };
207
+ options = { ...options, onlyClients: localOff };
208
+ }
209
+ if (!prepared) return undefined;
210
+ const { materializeLocalRouteIntent } = await import("../client/route-intent-apply");
211
+ const intent = prepared;
212
+ const linkId = connection.link.linkId;
213
+ const guard = options.beforeWrite ?? (() => {});
214
+ const previousModels = readRouteIntentReceipt(options.statePath)?.models ?? [];
215
+ const local = loadConfig();
216
+ const config = { ...local, hostname: "127.0.0.1", unauthenticatedLoopbackListener: undefined };
217
+ const previousHomeRecord = readHomeRouteIntentRecord(linkId);
218
+ const { createIntegrationStateStore } = await import("./store");
219
+ const { captureFileIntentOriginals } = await import("../client/route-intent-file-originals");
220
+ const store = options.store ?? createIntegrationStateStore();
221
+ withClientLifecycleSync(() => {
222
+ guard();
223
+ // An apply begins here: from now on only a receipt can prove what this link left behind.
224
+ clearRouteIntentUnappliedProof(options.statePath);
225
+ // Write-ahead, before any client changes: which file integrations were standalone. Only a
226
+ // receipt read strictly proves a first apply; a corrupt one refuses here, before an owner the
227
+ // link created could be recorded as standalone and the receipt naming it replaced.
228
+ captureFileIntentOriginals(linkId, readRouteIntentReceiptStrict(options.statePath)?.linkId === undefined, store.readRecordsStrict());
229
+ // A failed materialization must not leave the separately reportable Home proof current.
230
+ clearHomeRouteIntentRecord();
231
+ }, options.lifecycleLockDeps);
232
+ const persist = (receipt: RouteIntentReceipt) => {
233
+ receipt.outcomes = receipt.outcomes.map(initialRouteOutcomeMetadata(linkId, intent.document));
234
+ withClientLifecycleSync(() => {
235
+ guard();
236
+ writeRouteIntentReceipt(receipt, options.statePath);
237
+ if (intent.localOnly) { clearHomeRouteIntentRecord(); return; }
238
+ const record = homeRouteIntentReceipt(linkId, intent.document, intent.fetchedAt, receipt.appliedAt, receipt.outcomes, previousHomeRecord);
239
+ try { writeHomeRouteIntentRecord(record); }
240
+ catch (error) { clearHomeRouteIntentRecord(); throw error; }
241
+ }, options.lifecycleLockDeps);
242
+ };
243
+ // Disable and opt-out need no catalog. Their proven outcomes survive an offline Home;
244
+ // every enabled client stays stale until its local served model roster is available.
245
+ const effective = effectiveRouteIntent(intent.document, options.statePath);
246
+ const off = ROUTE_CLIENT_IDS.filter(id => !effective.clients[id].enabled && (!options.onlyClients || options.onlyClients.includes(id)));
247
+ const receipt = await materializeLocalRouteIntent(config, intent.document, previousModels, { ...options, onlyClients: off });
248
+ persist(receipt);
249
+ if (intent.localOnly) { receipt.catalogPending = true; persist(receipt); return receipt; }
250
+ if (off.length === ROUTE_CLIENT_IDS.length) return receipt;
251
+ let models: ExportModel[];
252
+ try { models = await loadConnectedRouteModels(connection, token, deps); }
253
+ catch {
254
+ guard();
255
+ receipt.catalogPending = true;
256
+ persist(receipt);
257
+ return receipt;
258
+ }
259
+ const applied = await materializeLocalRouteIntent(config, intent.document, models, options);
260
+ persist(applied);
261
+ return applied;
262
+ }
@@ -0,0 +1,55 @@
1
+ import type { ExportModel } from "../clients/config-export";
2
+ import type { HomeRouteIntentDocument, RouteClientId, RouteClientIntent, RouteClientOutcome } from "../link/route-intent";
3
+ import type { OcxConfig } from "../types";
4
+ import type { IntegrationStateStore } from "./store";
5
+
6
+ export type { RouteClientOutcome } from "../link/route-intent";
7
+
8
+ export interface RouteIntentReceipt {
9
+ version: 1;
10
+ linkId?: string;
11
+ /** Last local served roster, retained for offline owned-conflict recovery. No credentials. */
12
+ models?: readonly ExportModel[];
13
+ document: HomeRouteIntentDocument;
14
+ clients: Record<RouteClientId, RouteClientIntent>;
15
+ sources: Record<RouteClientId, "builtin" | "default" | "device" | "native" | "local">;
16
+ selectedClients: RouteClientId[];
17
+ outcomes: RouteClientOutcome[];
18
+ /** Null if any client failed, conflicts, or is not installed. Never a partial success. */
19
+ appliedRouteIntentDigest: string | null;
20
+ appliedAt: string;
21
+ /** Off intents are proved, while enabled clients await the local served model roster. */
22
+ catalogPending?: true;
23
+ }
24
+
25
+ export interface RouteIntentApplyInput {
26
+ config: OcxConfig;
27
+ linkId?: string;
28
+ document: HomeRouteIntentDocument;
29
+ /** The local served roster, never Home-generated client contributions. */
30
+ models: readonly ExportModel[];
31
+ home?: string;
32
+ env?: NodeJS.ProcessEnv;
33
+ store?: IntegrationStateStore;
34
+ /** Isolates local opt-outs and receipts; defaults to the local config directory. */
35
+ statePath?: string;
36
+ /** Home passes an empty list; undefined reads this Child's persistent local opt-outs. */
37
+ localOff?: readonly RouteClientId[];
38
+ overwriteConflict?: boolean;
39
+ /** When a client toggle grants takeover, other clients retain ordinary conflict checks. */
40
+ overwriteClient?: RouteClientId;
41
+ /** Rechecks connection/runtime ownership immediately before each writer commits. */
42
+ beforeWrite?: () => void;
43
+ /** Reconcile only explicit local opt-outs when no Home document is available. */
44
+ onlyClients?: readonly RouteClientId[];
45
+ /** Clients skipped by onlyClients keep the previous receipt outcome for the same client intent. */
46
+ retainSkippedOutcomes?: boolean;
47
+ /** Explicit disconnect recovery only: snapshot an owned conflicting block, then remove it. */
48
+ recoverConflicts?: boolean;
49
+ /** Lifecycle exclusion around async file writers; native adapters manage their own lock order. */
50
+ withFileWrites?: <T>(work: () => Promise<T>) => Promise<T>;
51
+ withReceiptWrite?: (write: () => void) => void;
52
+ now?: () => Date;
53
+ /** Native adapters retain their existing ownership/journal implementations. */
54
+ applyNative?: (client: "codex" | "claude" | "claude-desktop" | "grok", intent: RouteClientIntent) => Promise<RouteClientOutcome>;
55
+ }
@@ -0,0 +1,109 @@
1
+ /** File clients drain before disconnect removes its connection and service credential. */
2
+ import { loadConfig } from "../config";
3
+ import { lstatSync } from "node:fs";
4
+ import { readClientConnectionState, sameClientConnectionOwner } from "../client/state";
5
+ import { withClientLifecycle, withClientLifecycleSync, type ClientLifecycleLockDeps } from "../client/lifecycle-lock";
6
+ import { readDesktopDisconnectReceipt, type DesktopDisconnectReceipt } from "../claude/desktop-remote-store";
7
+ import { readServiceApiTokenState } from "../lib/service-secrets";
8
+ import { readLocalRouteIntentOff, readRouteIntentReceiptStrict, readRouteIntentUnappliedProof } from "./route-intent-state";
9
+ import { homeRouteIntentPath } from "../client/link-home";
10
+ import type { OcxClientConnectionConfig } from "../types";
11
+
12
+ /** Droid's empty-roster contribution has no selectors, so its generic classifier cannot prove absence. */
13
+ async function droidRoutingAbsent(port: number): Promise<boolean> {
14
+ const { INTEGRATION_CLIENTS } = await import("./registry");
15
+ const { defaultIntegrationIO, loadTarget } = await import("./config-io");
16
+ const { createIntegrationStateStore } = await import("./store");
17
+ const target = loadTarget(defaultIntegrationIO(createIntegrationStateStore()), INTEGRATION_CLIENTS.droid.configPath());
18
+ if (!target.ok) return false;
19
+ if (target.before === null) return true;
20
+ try {
21
+ const value: unknown = JSON.parse(target.before);
22
+ if (!value || typeof value !== "object" || Array.isArray(value)) return false;
23
+ const rows = (value as Record<string, unknown>).customModels;
24
+ if (rows === undefined) return true;
25
+ if (!Array.isArray(rows)) return false;
26
+ return rows.every(row => {
27
+ if (!row || typeof row !== "object" || Array.isArray(row)) return false;
28
+ if (typeof row.displayName === "string" && row.displayName.startsWith("OpenCodex:")) return false;
29
+ if (typeof row.baseUrl !== "string") return false;
30
+ const url = new URL(row.baseUrl);
31
+ return !(["127.0.0.1", "localhost", "[::1]"].includes(url.hostname) && url.port === String(port));
32
+ });
33
+ } catch { return false; }
34
+ }
35
+
36
+ export async function cleanupConnectedRouteIntent(
37
+ connection: OcxClientConnectionConfig, expected: DesktopDisconnectReceipt, lifecycleLockDeps?: ClientLifecycleLockDeps, recoverConflicts = false,
38
+ ): Promise<void> {
39
+ const receipt = readRouteIntentReceiptStrict();
40
+ if (!receipt) {
41
+ let homeReceiptPresent = false;
42
+ try { lstatSync(homeRouteIntentPath()); homeReceiptPresent = true; }
43
+ catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; }
44
+ if (connection.link) {
45
+ const { createIntegrationStateStore } = await import("./store");
46
+ const { isIntegrationClientId } = await import("./registry");
47
+ const { readIntegrationState } = await import("./state");
48
+ const { listAsideProfileStores } = await import("./aside-profile-context");
49
+ const store = createIntegrationStateStore();
50
+ const records = store.readRecordsStrict();
51
+ // Connect proved, for this exact connection, that no route apply has begun (`--no-sync`, an
52
+ // older Home). An ownership record then predates the link: it is the person's standalone
53
+ // integration, which disconnect keeps. Unowned routing residue still refuses below.
54
+ const proof = readRouteIntentUnappliedProof();
55
+ const neverApplied = !homeReceiptPresent && proof?.linkId === connection.link.linkId && proof.connectedAt === connection.connectedAt;
56
+ const owned = !neverApplied && (Object.keys(records).length > 0
57
+ || listAsideProfileStores(store).some(child => Object.keys(child.store.readRecordsStrict()).length > 0));
58
+ const standalone = (id: string) => neverApplied && records[id as keyof typeof records] !== undefined;
59
+ const config = loadConfig();
60
+ // Older Homes and --no-sync may never invoke the controller. Only disk absence,
61
+ // not selectedClients alone, proves those file clients have nothing to drain.
62
+ const unproved = connection.selectedClients.some(id => id !== "codex" && id !== "claude" && !standalone(id)
63
+ && (!isIntegrationClientId(id) || readIntegrationState({ clientId: id, config, port: config.port, models: [], store }).state !== "absent"));
64
+ const droidUnproved = connection.selectedClients.includes("droid") && !standalone("droid") && !await droidRoutingAbsent(config.port);
65
+ if (homeReceiptPresent || owned || unproved || droidUnproved) {
66
+ throw new Error("Route intent cleanup receipt is missing; preserve the connection and repair its route ownership evidence before disconnect");
67
+ }
68
+ }
69
+ return;
70
+ }
71
+ // A valid unbound receipt is standalone Home state, not evidence of a Child apply.
72
+ if (receipt.linkId === undefined) return;
73
+ if (!connection.link || receipt.linkId !== connection.link.linkId) throw new Error("Route intent cleanup receipt belongs to another context; preserve it before disconnect");
74
+ const guard = () => {
75
+ const pending = readDesktopDisconnectReceipt();
76
+ const current = readClientConnectionState();
77
+ const token = readServiceApiTokenState();
78
+ if (pending.kind !== "valid" || JSON.stringify(pending.value) !== JSON.stringify(expected)
79
+ || current.kind !== "connected" || !sameClientConnectionOwner(current.value, connection)
80
+ || current.value.pendingOperation || token.kind !== "present" || token.fingerprint !== connection.tokenFingerprint) {
81
+ throw new Error("client_disconnect_owner_changed");
82
+ }
83
+ };
84
+ const local = loadConfig();
85
+ const { cleanupRouteIntent } = await import("./route-intent");
86
+ const { stripGrokConfig } = await import("../grok/inject");
87
+ const { injectClaudeAgentDefs } = await import("../claude/agents-inject");
88
+ const config = { ...local, hostname: "127.0.0.1", unauthenticatedLoopbackListener: undefined };
89
+ // Integrations the Child owned before this link come back instead of being removed; a local
90
+ // opt-out is the person's own later choice and wins.
91
+ const { readFileIntentOriginals } = await import("../client/route-intent-file-originals");
92
+ const originals = readFileIntentOriginals();
93
+ const optedOut = new Set<string>(readLocalRouteIntentOff());
94
+ const standalone = originals?.linkId === connection.link.linkId
95
+ ? Object.fromEntries(Object.entries(originals.clients).filter(([client]) => !optedOut.has(client))) : {};
96
+ const outcomes = await cleanupRouteIntent({ config, linkId: connection.link.linkId, document: receipt.document, models: receipt.models ?? [], beforeWrite: guard, recoverConflicts,
97
+ withReceiptWrite: write => withClientLifecycleSync(() => { guard(); write(); }, lifecycleLockDeps),
98
+ withFileWrites: work => withClientLifecycle(work, lifecycleLockDeps) }, standalone);
99
+ if (outcomes.some(row => row.outcome !== "current")) throw new Error("Route intent cleanup was partial; ownership and disconnect receipts retained. Repair the conflicting client and rerun ocx disconnect.");
100
+ withClientLifecycleSync(() => {
101
+ guard();
102
+ const grok = stripGrokConfig();
103
+ if (!grok.ok) throw new Error("Grok route cleanup was partial; rerun ocx disconnect after repair");
104
+ const config = loadConfig();
105
+ const agents = injectClaudeAgentDefs({ ...config, claudeCode: { ...config.claudeCode, enabled: false } }, {});
106
+ if (agents === null) throw new Error("Claude route cleanup was partial; rerun ocx disconnect after repair");
107
+ guard();
108
+ }, lifecycleLockDeps);
109
+ }
@@ -0,0 +1,64 @@
1
+ /** Provisioning choices are local enabled-only overrides, never writes to Home policy. */
2
+ import { mkdirSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { atomicWriteFileNoFollow } from "../config/atomic-write";
5
+ import { readBoundedRegularFileSync } from "../lib/bounded-file-read";
6
+ import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
7
+ import { isRouteClientId, ROUTE_CLIENT_IDS, type HomeRouteIntentDocument, type RouteClientId, type RouteClientOutcome } from "../link/route-intent";
8
+ import { routeIntentStatePath } from "./route-intent-state";
9
+
10
+ type InitialSelection = Partial<Record<RouteClientId, { enabled: boolean; revision: number }>>;
11
+ function recordPath(linkId: string, root: string): string {
12
+ if (!/^lnk_[0-9a-f]{16}$/.test(linkId)) throw new Error("Invalid initial route intent link identity");
13
+ return join(root, `initial-${linkId}.json`);
14
+ }
15
+ export function readInitialRouteIntent(linkId: string, root = routeIntentStatePath()): InitialSelection {
16
+ let raw: unknown;
17
+ try { raw = JSON.parse(readBoundedRegularFileSync(recordPath(linkId, root), 64 * 1024).toString("utf8")); }
18
+ catch (error) { if ((error as NodeJS.ErrnoException).code === "ENOENT") return {}; throw new Error("Initial route selection is unreadable"); }
19
+ if (!raw || typeof raw !== "object" || Array.isArray(raw) || !("version" in raw) || raw.version !== 1
20
+ || !("linkId" in raw) || raw.linkId !== linkId || !("clients" in raw) || !raw.clients || typeof raw.clients !== "object" || Array.isArray(raw.clients)) {
21
+ throw new Error("Invalid initial route selection");
22
+ }
23
+ const clients: InitialSelection = {};
24
+ for (const [id, entry] of Object.entries(raw.clients)) {
25
+ if (!isRouteClientId(id) || !entry || typeof entry !== "object" || Array.isArray(entry)
26
+ || Object.keys(entry).sort().join(",") !== "enabled,revision" || !("enabled" in entry) || typeof entry.enabled !== "boolean"
27
+ || !("revision" in entry) || !Number.isSafeInteger(entry.revision) || Number(entry.revision) < 0) throw new Error("Invalid initial route selection client");
28
+ clients[id] = { enabled: entry.enabled, revision: Number(entry.revision) };
29
+ }
30
+ return clients;
31
+ }
32
+ function writeInitial(linkId: string, clients: InitialSelection, root: string): void {
33
+ assertNotRealHomeUnderTest(root); mkdirSync(root, { recursive: true, mode: 0o700 });
34
+ atomicWriteFileNoFollow(recordPath(linkId, root), JSON.stringify({ version: 1, linkId, clients }));
35
+ }
36
+ export function recordInitialRouteIntent(linkId: string, document: HomeRouteIntentDocument | undefined, selected: readonly RouteClientId[], root = routeIntentStatePath()): void {
37
+ const clients: InitialSelection = {};
38
+ for (const id of ROUTE_CLIENT_IDS) if (id === "codex" || id === "claude" || selected.includes(id)) {
39
+ clients[id] = { enabled: selected.includes(id), revision: document?.clientRevisions?.[id] ?? 0 };
40
+ }
41
+ writeInitial(linkId, clients, root);
42
+ }
43
+ export function resolveInitialRouteIntent(linkId: string, document: HomeRouteIntentDocument, beforeWrite: () => void = () => {}, root = routeIntentStatePath()): HomeRouteIntentDocument {
44
+ const clients = readInitialRouteIntent(linkId, root);
45
+ const next = structuredClone(document);
46
+ let removed = false;
47
+ for (const id of ROUTE_CLIENT_IDS) {
48
+ const initial = clients[id]; if (!initial) continue;
49
+ if ((document.clientRevisions?.[id] ?? 0) !== initial.revision) { delete clients[id]; removed = true; continue; }
50
+ next.clients[id] = { ...next.clients[id], enabled: initial.enabled };
51
+ next.sources[id] = "device";
52
+ }
53
+ if (removed) { beforeWrite(); writeInitial(linkId, clients, root); }
54
+ return next;
55
+ }
56
+ export function initialRouteOutcomeMetadata(linkId: string, document: HomeRouteIntentDocument, root = routeIntentStatePath()) {
57
+ const initial = readInitialRouteIntent(linkId, root);
58
+ return (row: RouteClientOutcome): RouteClientOutcome => {
59
+ const entry = initial[row.client];
60
+ return entry && entry.revision === (document.clientRevisions?.[row.client] ?? 0)
61
+ ? { ...row, initialIntent: { enabled: entry.enabled }, initialRevision: entry.revision } : row;
62
+ };
63
+ }
64
+ export function clearInitialRouteIntent(linkId: string, root = routeIntentStatePath()): void { writeInitial(linkId, {}, root); }