@bitkyc08/opencodex 2.100.2 → 2.100.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (561) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-BV4ms9U9.js} +1 -1
  6. package/gui/dist/assets/{brand-mark-DU-0Vdkr.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/{index-DJEkIDAi.css → index-DQtCRNAw.css} +1 -1
  9. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/{quota-summary-CakPe9Ni.js → quota-summary-Dy5_wfTT.js} +1 -1
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +3 -3
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/protobuf-request.ts +8 -8
  38. package/src/adapters/cursor.ts +7 -6
  39. package/src/adapters/google-antigravity-wire.ts +7 -5
  40. package/src/adapters/google-wire-compiler.ts +2 -2
  41. package/src/adapters/google.ts +9 -2
  42. package/src/adapters/kiro/payload.ts +7 -4
  43. package/src/adapters/kiro/reasoning.ts +44 -1
  44. package/src/adapters/kiro/structured-output.ts +10 -8
  45. package/src/adapters/kiro-tools.ts +61 -15
  46. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  47. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  48. package/src/adapters/zed.ts +3 -0
  49. package/src/advisor/consult.ts +15 -4
  50. package/src/advisor/context.ts +12 -3
  51. package/src/advisor/runtime.ts +35 -5
  52. package/src/advisor/settings.ts +8 -0
  53. package/src/advisor/synthetic-tool.ts +21 -8
  54. package/src/bridge/response-json.ts +11 -2
  55. package/src/bridge/sse.ts +43 -8
  56. package/src/claude/auth-detect.ts +21 -33
  57. package/src/claude/desktop-3p.ts +11 -5
  58. package/src/claude/desktop-gateway-state.ts +2 -0
  59. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  60. package/src/claude/desktop-remote-store.ts +24 -4
  61. package/src/claude/inbound-content-options.ts +31 -16
  62. package/src/claude/outbound.ts +13 -3
  63. package/src/cli/account-api.ts +17 -1
  64. package/src/cli/account-auth.ts +54 -21
  65. package/src/cli/account-key-quota.ts +34 -5
  66. package/src/cli/account.ts +4 -2
  67. package/src/cli/advisor.ts +7 -4
  68. package/src/cli/alias.ts +38 -1
  69. package/src/cli/capabilities-access-remote.ts +128 -3
  70. package/src/cli/capabilities-accounts.ts +3 -3
  71. package/src/cli/capabilities-agents-routing.ts +17 -10
  72. package/src/cli/capabilities-base.ts +41 -16
  73. package/src/cli/capabilities-integrations.ts +2 -2
  74. package/src/cli/capabilities-provider-models.ts +18 -2
  75. package/src/cli/capabilities-route-to.ts +43 -0
  76. package/src/cli/capabilities.ts +2 -0
  77. package/src/cli/capability-contracts.ts +1 -1
  78. package/src/cli/claude-desktop.ts +30 -11
  79. package/src/cli/claude.ts +17 -3
  80. package/src/cli/codex-launcher.ts +3 -1
  81. package/src/cli/codex-shim-autorestore.ts +5 -42
  82. package/src/cli/config-command.ts +14 -1
  83. package/src/cli/config-root-startup.ts +34 -0
  84. package/src/cli/connect.ts +88 -16
  85. package/src/cli/desktop-runtime-guidance.ts +1 -1
  86. package/src/cli/disconnect-runtime.ts +168 -0
  87. package/src/cli/dispatch.ts +54 -12
  88. package/src/cli/export-command.ts +1 -1
  89. package/src/cli/gui-pair-client.ts +6 -3
  90. package/src/cli/gui.ts +10 -5
  91. package/src/cli/help-catalog.ts +11 -0
  92. package/src/cli/help.ts +4 -3
  93. package/src/cli/index.ts +83 -92
  94. package/src/cli/inspect.ts +11 -2
  95. package/src/cli/integrations.ts +26 -1
  96. package/src/cli/link-capture.ts +64 -0
  97. package/src/cli/link-child-ops.ts +218 -40
  98. package/src/cli/link-cleanup.ts +8 -5
  99. package/src/cli/link-diagnostics.ts +67 -0
  100. package/src/cli/link-enrollment.ts +158 -12
  101. package/src/cli/link-operations.ts +52 -0
  102. package/src/cli/link-recover.ts +152 -0
  103. package/src/cli/link-routes.ts +87 -0
  104. package/src/cli/link-status-child.ts +44 -1
  105. package/src/cli/link-status-traffic.ts +34 -0
  106. package/src/cli/link.ts +314 -37
  107. package/src/cli/message-command.ts +1 -1
  108. package/src/cli/message-mcp-command.ts +23 -10
  109. package/src/cli/models-runtime.ts +3 -3
  110. package/src/cli/opencode.ts +3 -1
  111. package/src/cli/pi-sync.ts +35 -0
  112. package/src/cli/preflight-exemptions.ts +46 -0
  113. package/src/cli/registry.ts +28 -12
  114. package/src/cli/restart-failure.ts +5 -2
  115. package/src/cli/root.ts +5 -1
  116. package/src/cli/route-to.ts +172 -0
  117. package/src/cli/runtime-api.ts +5 -8
  118. package/src/cli/status.ts +3 -1
  119. package/src/cli/stop-approval.ts +66 -19
  120. package/src/cli/stop-report.ts +23 -0
  121. package/src/cli/stop-windows-checked.ts +304 -0
  122. package/src/cli/sync-command.ts +70 -15
  123. package/src/cli/sync-fanout.ts +74 -19
  124. package/src/cli/sync-flags.ts +40 -3
  125. package/src/cli/sync-link-status.ts +18 -2
  126. package/src/cli/sync-update-guard.ts +7 -2
  127. package/src/cli/system-restart-client.ts +3 -2
  128. package/src/cli/uninstall-plan.ts +77 -5
  129. package/src/cli/uninstall-stop.ts +152 -0
  130. package/src/cli/v2-input.ts +10 -6
  131. package/src/cli/v2-local-output.ts +3 -2
  132. package/src/cli/v2-runtime.ts +10 -3
  133. package/src/cli/v2.ts +22 -7
  134. package/src/client/connect.ts +321 -34
  135. package/src/client/link-home-features.ts +27 -0
  136. package/src/client/link-home.ts +92 -4
  137. package/src/client/link-ingress.ts +21 -3
  138. package/src/client/link-join.ts +12 -2
  139. package/src/client/link-parity-reporter.ts +60 -6
  140. package/src/client/link-relay-transport.ts +161 -36
  141. package/src/client/link-relay.ts +150 -6
  142. package/src/client/link-request-compression.ts +84 -0
  143. package/src/client/link-state.ts +11 -5
  144. package/src/client/link-status.ts +39 -1
  145. package/src/client/link-teardown.ts +1 -0
  146. package/src/client/link-tunnel.ts +56 -5
  147. package/src/client/link-websocket-limits.ts +89 -0
  148. package/src/client/link-websocket.ts +586 -0
  149. package/src/client/link-ws-advertisement.ts +100 -0
  150. package/src/client/link-ws-framer.ts +241 -0
  151. package/src/client/link-ws-transport.ts +177 -0
  152. package/src/client/machine-api.ts +13 -2
  153. package/src/client/machine-listener.ts +48 -7
  154. package/src/client/route-intent-apply.ts +293 -0
  155. package/src/client/route-intent-file-originals.ts +97 -0
  156. package/src/client/route-intent-native-originals.ts +201 -0
  157. package/src/client/route-intent-watch.ts +141 -0
  158. package/src/client/runtime-restart.ts +127 -5
  159. package/src/client/runtime.ts +61 -15
  160. package/src/client/state.ts +30 -0
  161. package/src/client/sync-expectation.ts +36 -2
  162. package/src/client/sync-runtime.ts +7 -0
  163. package/src/clients/config-export/alias-selectors.ts +63 -40
  164. package/src/clients/config-export/contracts.ts +2 -0
  165. package/src/clients/config-export/nested-selectors.ts +42 -0
  166. package/src/clients/config-export.ts +22 -3
  167. package/src/codex/account-store.ts +12 -3
  168. package/src/codex/account-usability.ts +13 -0
  169. package/src/codex/auth-api/account-list.ts +29 -3
  170. package/src/codex/auth-collision.ts +23 -22
  171. package/src/codex/auth-context.ts +21 -6
  172. package/src/codex/catalog/gather-capture.ts +8 -2
  173. package/src/codex/catalog/parsing.ts +7 -3
  174. package/src/codex/catalog/provider-models.ts +54 -15
  175. package/src/codex/catalog/retained-sync.ts +2 -1
  176. package/src/codex/catalog/routed-gather.ts +1 -1
  177. package/src/codex/catalog-auto-refresh.ts +11 -0
  178. package/src/codex/cli-update-job.ts +35 -13
  179. package/src/codex/convergence.ts +2 -2
  180. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  181. package/src/codex/features.ts +2 -2
  182. package/src/codex/history-provider.ts +31 -0
  183. package/src/codex/inject/multi-agent-v2.ts +9 -3
  184. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  185. package/src/codex/inject/plan.ts +20 -2
  186. package/src/codex/inject.ts +2 -0
  187. package/src/codex/journal-config-restore.ts +217 -0
  188. package/src/codex/journal.ts +75 -6
  189. package/src/codex/main-account.ts +23 -30
  190. package/src/codex/native-main-auth-file.ts +104 -0
  191. package/src/codex/native-profile-manager.ts +4 -3
  192. package/src/codex/native-profile-store.ts +3 -61
  193. package/src/codex/orca-import.ts +10 -1
  194. package/src/codex/quota-history.ts +13 -0
  195. package/src/codex/quota-window-conflict.ts +103 -0
  196. package/src/codex/quota.ts +23 -1
  197. package/src/codex/subagent-model-fallback.ts +3 -1
  198. package/src/codex/websocket-activity.ts +171 -16
  199. package/src/codex/websocket-registry.ts +11 -4
  200. package/src/combos/cooldown-store.ts +25 -5
  201. package/src/combos/failover.ts +330 -2
  202. package/src/config/dashboard-trusted-proxy.ts +83 -0
  203. package/src/config/diagnostics.ts +28 -0
  204. package/src/config/feature-flags.ts +9 -0
  205. package/src/config/live-reconcile.ts +10 -1
  206. package/src/config/load-degrade.ts +12 -1
  207. package/src/config/multi-agent-surface.ts +28 -5
  208. package/src/config/pending-teardown.ts +60 -3
  209. package/src/config/process-state.ts +175 -4
  210. package/src/config/provider-validation.ts +4 -4
  211. package/src/config/schema/config-schema.ts +6 -0
  212. package/src/config/schema/leaf-validators.ts +9 -2
  213. package/src/config/windows-process-command-line.ts +107 -0
  214. package/src/generated/compatibility-version.json +948 -392
  215. package/src/generated/model-metadata.ts +1 -1
  216. package/src/images/loop.ts +3 -0
  217. package/src/integrations/model-name-guard.ts +25 -0
  218. package/src/integrations/route-intent-catalog.ts +26 -0
  219. package/src/integrations/route-intent-connected.ts +262 -0
  220. package/src/integrations/route-intent-contract.ts +55 -0
  221. package/src/integrations/route-intent-disconnect.ts +109 -0
  222. package/src/integrations/route-intent-initial.ts +64 -0
  223. package/src/integrations/route-intent-state.ts +117 -0
  224. package/src/integrations/route-intent-tick.ts +65 -0
  225. package/src/integrations/route-intent.ts +212 -0
  226. package/src/integrations/writer.ts +44 -11
  227. package/src/lib/client-retry-after.ts +29 -0
  228. package/src/lib/config-ownership.ts +13 -0
  229. package/src/lib/desktop-gui-origin.ts +28 -0
  230. package/src/lib/errors.ts +1 -1
  231. package/src/lib/gui-pair-capability.ts +2 -1
  232. package/src/lib/messages-error-body.ts +4 -1
  233. package/src/lib/outbound-credential-registry.ts +362 -4
  234. package/src/lib/paced-stream.ts +34 -0
  235. package/src/lib/passive-key-fetch-proof.ts +30 -0
  236. package/src/lib/passive-read.ts +5 -0
  237. package/src/lib/process-control.ts +76 -12
  238. package/src/lib/redact.ts +84 -8
  239. package/src/lib/state-store-registrations.ts +11 -0
  240. package/src/lib/state-store-sweeper.ts +4 -0
  241. package/src/lib/supervisor-markers.ts +18 -0
  242. package/src/lib/terminal-safe-text.ts +58 -0
  243. package/src/lib/translator-budget.ts +3 -2
  244. package/src/lib/upstream-retry.ts +14 -4
  245. package/src/link/alias-lock.ts +119 -0
  246. package/src/link/child-activity.ts +28 -2
  247. package/src/link/child-binary-cache-fill.d.mts +50 -0
  248. package/src/link/child-binary-cache-fill.mjs +494 -0
  249. package/src/link/child-binary-cache-start.ts +73 -0
  250. package/src/link/child-binary-source.ts +12 -5
  251. package/src/link/child-gated-ocx.ts +29 -11
  252. package/src/link/child-observations.ts +2 -1
  253. package/src/link/child-observe.ts +2 -2
  254. package/src/link/child-ops-engine.ts +159 -91
  255. package/src/link/child-ops-host.ts +138 -0
  256. package/src/link/child-ops-runners.ts +319 -0
  257. package/src/link/child-ops-scheduler.ts +207 -0
  258. package/src/link/child-ops-types.ts +89 -0
  259. package/src/link/child-parity.ts +23 -4
  260. package/src/link/child-policy.ts +93 -0
  261. package/src/link/child-update-contract.ts +12 -3
  262. package/src/link/codex-settings.ts +1 -1
  263. package/src/link/compatibility.ts +18 -1
  264. package/src/link/diagnostics-read.ts +163 -0
  265. package/src/link/diagnostics.ts +20 -7
  266. package/src/link/explicit-route.ts +209 -0
  267. package/src/link/link-recover.ts +113 -0
  268. package/src/link/management-routes.ts +3 -1
  269. package/src/link/operation-recovery-slot.ts +44 -0
  270. package/src/link/operations-journal.ts +408 -0
  271. package/src/link/peer-report.ts +1 -1
  272. package/src/link/relay-auth.ts +14 -0
  273. package/src/link/remote-plant.ts +152 -14
  274. package/src/link/remote-platform.ts +21 -10
  275. package/src/link/remote-probe.ts +11 -3
  276. package/src/link/remote-windows.ts +50 -10
  277. package/src/link/request-compression.ts +30 -0
  278. package/src/link/residual-recovery.ts +54 -0
  279. package/src/link/retirement.ts +128 -0
  280. package/src/link/route-intent-watch.ts +41 -0
  281. package/src/link/route-intent.ts +209 -0
  282. package/src/link/route-proof.ts +82 -0
  283. package/src/link/route-rounds.ts +579 -0
  284. package/src/link/route-select.ts +95 -0
  285. package/src/link/route-trust.ts +96 -0
  286. package/src/link/ssh-argv.ts +172 -24
  287. package/src/link/ssh-capture-redact.ts +253 -0
  288. package/src/link/ssh-capture.ts +497 -0
  289. package/src/link/ssh-runner.ts +141 -14
  290. package/src/link/status-projection.ts +87 -0
  291. package/src/link/store.ts +54 -1
  292. package/src/link/supervisor.ts +543 -55
  293. package/src/link/sync-fanout-classify.ts +16 -0
  294. package/src/link/sync-then-restart.ts +65 -0
  295. package/src/link/tombstones.ts +209 -0
  296. package/src/link/traffic.ts +178 -0
  297. package/src/link/ws-activity-holds.ts +474 -0
  298. package/src/local-credentials/publication-fence.ts +20 -1
  299. package/src/messaging/mcp-queue-rpc.ts +1 -1
  300. package/src/messaging/mcp-queue-server.ts +16 -1
  301. package/src/messaging/mcp-resume-tools.ts +25 -0
  302. package/src/messaging/remote-enrollment.ts +3 -3
  303. package/src/messaging/remote-tunnels.ts +2 -2
  304. package/src/messaging/resume-permissions.ts +27 -0
  305. package/src/messaging/rpc.ts +46 -2
  306. package/src/oauth/anthropic-continuity.ts +23 -7
  307. package/src/oauth/anthropic-routing.ts +5 -2
  308. package/src/oauth/anthropic.ts +22 -2
  309. package/src/oauth/claude-keychain-read.ts +78 -68
  310. package/src/oauth/index.ts +24 -6
  311. package/src/oauth/local-token-detect.ts +8 -29
  312. package/src/oauth/login-cli-errors.ts +5 -1
  313. package/src/oauth/login-cli.ts +33 -18
  314. package/src/oauth/login-flow-state.ts +26 -3
  315. package/src/oauth/meta-muse.ts +1 -1
  316. package/src/oauth/store.ts +7 -0
  317. package/src/oauth/xai.ts +248 -14
  318. package/src/protocols/contract.ts +4 -0
  319. package/src/protocols/encoders/messages.ts +1 -0
  320. package/src/providers/alias-template.ts +48 -0
  321. package/src/providers/anthropic-billing-ownership.ts +2 -0
  322. package/src/providers/anthropic-output-caps.ts +46 -0
  323. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  324. package/src/providers/antigravity-effort-families.ts +11 -3
  325. package/src/providers/antigravity-models.ts +32 -9
  326. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  327. package/src/providers/api-key-pause.ts +3 -0
  328. package/src/providers/api-key-resolve.ts +49 -7
  329. package/src/providers/api-key-response-ownership.ts +2 -0
  330. package/src/providers/api-key-selection.ts +51 -9
  331. package/src/providers/api-keys.ts +6 -2
  332. package/src/providers/cache-affinity-identity.ts +73 -0
  333. package/src/providers/cache-affinity.ts +256 -0
  334. package/src/providers/default-aliases.ts +98 -20
  335. package/src/providers/google-vertex-model-discovery.ts +510 -0
  336. package/src/providers/key-failover.ts +123 -8
  337. package/src/providers/key-store.ts +3 -3
  338. package/src/providers/kiro-models.ts +3 -5
  339. package/src/providers/label.ts +31 -5
  340. package/src/providers/mistral-transport.ts +17 -4
  341. package/src/providers/model-rename-fields.ts +3 -0
  342. package/src/providers/muse-key-quota.ts +14 -6
  343. package/src/providers/new-model-policy-runtime.ts +17 -4
  344. package/src/providers/new-model-policy.ts +30 -4
  345. package/src/providers/passive-key-observation.ts +252 -0
  346. package/src/providers/quota/account-cache.ts +2 -1
  347. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  348. package/src/providers/quota/passive-key-limits.ts +272 -0
  349. package/src/providers/quota/passive-wire-model.ts +126 -0
  350. package/src/providers/quota/report-cache.ts +61 -2
  351. package/src/providers/quota-key-accounts.ts +11 -6
  352. package/src/providers/quota-types.ts +18 -0
  353. package/src/providers/quota.ts +11 -12
  354. package/src/providers/registry/entries-core.ts +34 -16
  355. package/src/providers/registry/entries-extended.ts +32 -0
  356. package/src/providers/registry/model-seeds.ts +35 -0
  357. package/src/providers/resolved-model-policy.ts +7 -0
  358. package/src/providers/routed-config.ts +8 -3
  359. package/src/providers/xai-transport.ts +3 -0
  360. package/src/remote/features.ts +17 -0
  361. package/src/responses/anthropic-progress.ts +10 -4
  362. package/src/responses/citation-markers.ts +231 -0
  363. package/src/responses/spill-store.ts +5 -1
  364. package/src/responses/state/replay-input.ts +50 -0
  365. package/src/responses/state/replay-owner.ts +24 -0
  366. package/src/responses/state/snapshot-codec.ts +9 -0
  367. package/src/responses/state/spill-queue.ts +1 -0
  368. package/src/responses/state.ts +42 -60
  369. package/src/router.ts +2 -2
  370. package/src/routing/home-route-capture.ts +123 -0
  371. package/src/routing/home-route-intent.ts +200 -0
  372. package/src/routing/route-intent-state.ts +178 -0
  373. package/src/routing/route-to-live-settings.ts +35 -0
  374. package/src/routing/route-to-local.ts +145 -0
  375. package/src/routing/route-to-status.ts +94 -0
  376. package/src/routing/route-to-sync-child.ts +32 -0
  377. package/src/server/adapter-resolve.ts +21 -1
  378. package/src/server/admitted-http-turn.ts +3 -0
  379. package/src/server/auth-cors.ts +98 -0
  380. package/src/server/bare-upstream-error.ts +220 -0
  381. package/src/server/chat-native.ts +14 -5
  382. package/src/server/claude-messages.ts +6 -4
  383. package/src/server/codex-model-list.ts +2 -1
  384. package/src/server/configured-credentials.ts +37 -5
  385. package/src/server/gui-desktop-authorization.ts +36 -0
  386. package/src/server/gui-pair-delivery.ts +6 -3
  387. package/src/server/gui-session.ts +10 -1
  388. package/src/server/inbound-body-admission.ts +17 -4
  389. package/src/server/index/link-listener.ts +190 -12
  390. package/src/server/index/link-management.ts +15 -1
  391. package/src/server/index/link-relay-sessions.ts +87 -8
  392. package/src/server/index/link-websocket-limits.ts +136 -0
  393. package/src/server/index/link-websocket.ts +692 -0
  394. package/src/server/index/optional-listeners.ts +97 -7
  395. package/src/server/index/route-intent-watch.ts +47 -0
  396. package/src/server/index/serve-contract.ts +86 -0
  397. package/src/server/index/serve-options.ts +35 -86
  398. package/src/server/index/startup-warnings.ts +8 -2
  399. package/src/server/index/websocket-handler.ts +26 -4
  400. package/src/server/index.ts +12 -2
  401. package/src/server/inference/client-encoder-delivery.ts +2 -0
  402. package/src/server/inspection-tee.ts +39 -2
  403. package/src/server/lifecycle.ts +2 -0
  404. package/src/server/link-turn.ts +137 -0
  405. package/src/server/management/advisor-routes.ts +10 -2
  406. package/src/server/management/agent-settings-routes.ts +50 -16
  407. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  408. package/src/server/management/context.ts +9 -2
  409. package/src/server/management/desktop-authorization.ts +41 -0
  410. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  411. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  412. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  413. package/src/server/management/home-integration-decision.ts +89 -0
  414. package/src/server/management/integration-routes.ts +208 -81
  415. package/src/server/management/link-child-ops-routes.ts +145 -43
  416. package/src/server/management/link-child-preflight.ts +31 -0
  417. package/src/server/management/link-diagnostics-route.ts +29 -0
  418. package/src/server/management/link-enrollment.ts +199 -47
  419. package/src/server/management/link-operation.ts +609 -0
  420. package/src/server/management/link-recover-route.ts +103 -0
  421. package/src/server/management/link-route-edit.ts +173 -0
  422. package/src/server/management/link-route-request.ts +62 -0
  423. package/src/server/management/link-route-state.ts +83 -7
  424. package/src/server/management/link-routes.ts +553 -51
  425. package/src/server/management/link-traffic-status.ts +13 -0
  426. package/src/server/management/model-routes.ts +122 -36
  427. package/src/server/management/model-rows.ts +2 -1
  428. package/src/server/management/native-integration-routes.ts +176 -70
  429. package/src/server/management/oauth-account-routes.ts +36 -13
  430. package/src/server/management/protocol-routes.ts +7 -0
  431. package/src/server/management/provider-completion-test.ts +4 -4
  432. package/src/server/management/provider-overwrite-carry.ts +11 -0
  433. package/src/server/management/provider-routes.ts +64 -61
  434. package/src/server/management/provider-routing-quota.ts +45 -0
  435. package/src/server/management/route-registry.ts +22 -3
  436. package/src/server/management/route-to-routes.ts +257 -0
  437. package/src/server/management/system-restart.ts +4 -2
  438. package/src/server/management/usage-aggregate-cache.ts +101 -66
  439. package/src/server/management-api.ts +17 -3
  440. package/src/server/management-auth.ts +13 -1
  441. package/src/server/messages-native-preflight.ts +27 -4
  442. package/src/server/messages-native.ts +17 -5
  443. package/src/server/persistent-gui-session.ts +6 -3
  444. package/src/server/proxy-liveness.ts +33 -6
  445. package/src/server/relay-eager.ts +36 -12
  446. package/src/server/relay.ts +183 -116
  447. package/src/server/request-body-facts.ts +48 -0
  448. package/src/server/request-decompress.ts +65 -2
  449. package/src/server/request-log-account-rotation.ts +6 -0
  450. package/src/server/request-log-attempt-usage.ts +69 -0
  451. package/src/server/request-log-cache-affinity.ts +60 -0
  452. package/src/server/request-log-conversation.ts +45 -2
  453. package/src/server/request-log-terminal-status.ts +210 -24
  454. package/src/server/request-log.ts +71 -79
  455. package/src/server/responses/adapter-continuation.ts +2 -1
  456. package/src/server/responses/adapter-delivery.ts +2 -0
  457. package/src/server/responses/adapter-dispatch.ts +5 -7
  458. package/src/server/responses/advisor-plan-slot.ts +33 -1
  459. package/src/server/responses/advisor-question.ts +21 -0
  460. package/src/server/responses/advisor-slot.ts +10 -3
  461. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  462. package/src/server/responses/buffered-sse-json.ts +9 -3
  463. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  464. package/src/server/responses/codex-tool-catalog.ts +156 -0
  465. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  466. package/src/server/responses/combo-stream-preflight.ts +557 -54
  467. package/src/server/responses/compact.ts +32 -8
  468. package/src/server/responses/core-codex-account.ts +17 -3
  469. package/src/server/responses/core-combo-failure.ts +8 -0
  470. package/src/server/responses/core-combo.ts +32 -4
  471. package/src/server/responses/core-errors.ts +5 -2
  472. package/src/server/responses/core-lifetime.ts +3 -2
  473. package/src/server/responses/core-normalize.ts +3 -1
  474. package/src/server/responses/core-options.ts +6 -0
  475. package/src/server/responses/core.ts +2 -0
  476. package/src/server/responses/fetch-helpers.ts +15 -10
  477. package/src/server/responses/native-replay-guard.ts +57 -0
  478. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  479. package/src/server/responses/outbound-request-body.ts +29 -0
  480. package/src/server/responses/passthrough-completion.ts +105 -8
  481. package/src/server/responses/passthrough-delivery.ts +31 -11
  482. package/src/server/responses/passthrough-dispatch.ts +74 -73
  483. package/src/server/responses/policy-fallback.ts +13 -1
  484. package/src/server/responses/request-prepare.ts +50 -6
  485. package/src/server/responses/request-transport.ts +10 -3
  486. package/src/server/responses/reset-replay.ts +46 -2
  487. package/src/server/responses/run-turn-execution.ts +2 -0
  488. package/src/server/responses/sidecar-execution.ts +14 -0
  489. package/src/server/responses/terminal-error-redaction.ts +222 -25
  490. package/src/server/responses/ws-upstream.ts +2 -2
  491. package/src/server/sse-payload-rewrite.ts +3 -2
  492. package/src/server/stop-service-route.ts +85 -0
  493. package/src/server/system-env-shell.ts +12 -1
  494. package/src/server/system-env.ts +5 -3
  495. package/src/server/windows-tcp-drop.ts +21 -4
  496. package/src/server/workflow-refusal.ts +8 -0
  497. package/src/server/ws-bridge.ts +191 -12
  498. package/src/service/cli-windows-stop.ts +189 -0
  499. package/src/service/cli.ts +41 -12
  500. package/src/service/disconnected-client-restart.ts +60 -0
  501. package/src/service/guarded-manager-target.ts +18 -1
  502. package/src/service/health.ts +99 -6
  503. package/src/service/launchd.ts +84 -31
  504. package/src/service/orchestration.ts +418 -91
  505. package/src/service/repair.ts +223 -6
  506. package/src/service/restart-proxy-stop.ts +79 -0
  507. package/src/service/service-child-ownership.ts +6 -2
  508. package/src/service/windows-checked-stop-live.ts +467 -0
  509. package/src/service/windows-checked-stop.ts +435 -0
  510. package/src/service/windows-command-line-token.ts +23 -0
  511. package/src/service/windows-guarded-manager.ts +77 -34
  512. package/src/service/windows-ops.ts +38 -56
  513. package/src/service/windows-process-evidence.ts +292 -0
  514. package/src/service/windows-process-native.ts +262 -0
  515. package/src/service/windows-service-stop.ts +321 -0
  516. package/src/service/windows-stop-binding.ts +187 -0
  517. package/src/service/windows-stop-budget.ts +123 -0
  518. package/src/service/windows-stop-confirm.ts +158 -0
  519. package/src/service/windows-stop-deadline.ts +56 -0
  520. package/src/service.ts +2 -2
  521. package/src/types/config.ts +42 -18
  522. package/src/types/link.ts +20 -0
  523. package/src/types/multi-agent.ts +13 -0
  524. package/src/types/provider.ts +47 -2
  525. package/src/types/request.ts +4 -0
  526. package/src/types.ts +3 -0
  527. package/src/update/guarded-runtime-ops.ts +5 -7
  528. package/src/update/index.ts +25 -10
  529. package/src/update/install-detection.mjs +3 -1
  530. package/src/update/job-pinned-start.ts +2 -0
  531. package/src/update/job-windows-restart.ts +19 -32
  532. package/src/update/job.ts +12 -5
  533. package/src/update/npm-install.d.mts +11 -0
  534. package/src/update/npm-install.mjs +44 -7
  535. package/src/update/orchestrated-entry.ts +1 -1
  536. package/src/update/orchestrated-node-driver.mjs +3 -2
  537. package/src/update/orchestrated-pnpm.d.mts +4 -0
  538. package/src/update/orchestrated-pnpm.mjs +50 -6
  539. package/src/update/orchestrated-session.d.mts +3 -1
  540. package/src/update/orchestrated-session.mjs +21 -6
  541. package/src/update/pnpm-global-install.d.mts +21 -3
  542. package/src/update/pnpm-global-install.mjs +322 -19
  543. package/src/update/pnpm-store-layout.mjs +46 -0
  544. package/src/update/sync-update-mutex.d.mts +3 -2
  545. package/src/update/sync-update-mutex.mjs +57 -8
  546. package/src/update/transactional-install.d.mts +3 -1
  547. package/src/update/transactional-install.mjs +545 -12
  548. package/src/update/windows-installer-marker.d.mts +1 -0
  549. package/src/update/windows-installer-marker.mjs +44 -0
  550. package/src/usage/expected-prices.ts +8 -0
  551. package/src/usage/filter-index.ts +326 -77
  552. package/src/usage/ledger-scanner.ts +15 -0
  553. package/src/usage/link-log-fields.ts +48 -0
  554. package/src/usage/log.ts +43 -2
  555. package/src/usage/request-body.ts +37 -0
  556. package/src/web-search/loop.ts +3 -0
  557. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  558. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  559. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  560. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  561. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,510 @@
1
+ import { getModelMetadata, getModelMetadataCaseInsensitive } from "../generated/model-metadata";
2
+ import {
3
+ bindVertexRequestAuthority,
4
+ GCP_CREDENTIAL_MARKER_PREFIX,
5
+ gcpCredentialMarkerAccount,
6
+ getVertexAccessTokenWithAuthority,
7
+ vertexRequestAuthorityIsCurrent,
8
+ } from "../lib/gcp-adc";
9
+ import type { OcxProviderConfig } from "../types";
10
+ import { resolveProviderApiKey } from "./api-key-resolve";
11
+ import { captureVertexAmbientKey } from "./vertex-environment-authority";
12
+ import { extractGoogleAiStudioModelItems } from "./google-ai-studio-model-discovery";
13
+ import {
14
+ extractModelEnvelopeRows,
15
+ isValidModelDiscoveryModelId,
16
+ readBoundedDiscoveryJson,
17
+ resolveProviderModelDiscoveryUrl,
18
+ type ProviderModelItemsResult,
19
+ type ProviderModelsApiItem,
20
+ } from "./model-discovery";
21
+ import { MODEL_DISCOVERY_MAX_MODELS, MODEL_DISCOVERY_MAX_RESPONSE_BYTES } from "./model-discovery-limits";
22
+ import {
23
+ effectiveGoogleMode,
24
+ getProviderRegistryEntry,
25
+ mergeRegistryStaticHeaders,
26
+ providerMatchesRegistryTransport,
27
+ registryEntryForProviderDestination,
28
+ } from "./registry";
29
+ import { resolveProviderTransport } from "./xai-transport";
30
+
31
+ const VERTEX_PUBLISHER_MODEL_PREFIX = "publishers/google/models/";
32
+ const VERTEX_GENERATIVE_MODEL_ID = /^(?:gemini|gemma)-/i;
33
+ const VERTEX_NON_CHAT_SKU = /(?:^|-)embedding(?:-|$)|-tts(?:-|$)|-transcribe(?:-|$)|(?:^|-)live(?:-|$)/i;
34
+ const VERTEX_TRAILING_API_VERSION = /\/v1(?:beta1?)?$/i;
35
+
36
+ /** Time budget for one Vertex discovery: ADC token resolution, then every follow-up page. */
37
+ export const VERTEX_DISCOVERY_TIMEOUT_MS = 8_000;
38
+ /** Request ceiling for one listing, first page included (pageSize=300, so 1,500 rows). */
39
+ export const VERTEX_DISCOVERY_MAX_PAGES = 5;
40
+ const VERTEX_PAGE_TOKEN_MAX_LENGTH = 4_096;
41
+
42
+ /**
43
+ * Vertex SKUs whose model card lists function calling as "Not supported". An agent client sends
44
+ * function declarations on every turn, so publishing one of these rows offers a model that cannot
45
+ * finish a tool loop. Checked 2026-11-13 against the Gemini Enterprise Agent Platform model cards:
46
+ * gemini-3.1-flash-lite-image, gemini-3.1-flash-image, gemini-3-pro-image(-preview) and
47
+ * gemini-2.5-flash-image (docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/*).
48
+ */
49
+ const VERTEX_NO_FUNCTION_CALLING_MODELS = new Set([
50
+ "gemini-3.1-flash-lite-image",
51
+ "gemini-3.1-flash-image",
52
+ "gemini-3-pro-image",
53
+ "gemini-3-pro-image-preview",
54
+ "gemini-2.5-flash-image",
55
+ "gemini-2.5-flash-image-preview",
56
+ "gemini-2.0-flash-preview-image-generation",
57
+ ]);
58
+
59
+ /**
60
+ * Image-output Gemini SKUs (`-image` / `-image-generation` segments). Every such card checked
61
+ * above lists function calling as unsupported, so an unlisted one stays out until its card says
62
+ * otherwise; publishing it would be a guess about tool support rather than evidence.
63
+ */
64
+ const VERTEX_IMAGE_OUTPUT_SKU = /-image(?:-|$)/i;
65
+
66
+ /** Whether a discovered Vertex publisher model can run a client's function-calling loop. */
67
+ export function vertexModelSupportsFunctionCalling(modelId: string): boolean {
68
+ const lower = modelId.toLowerCase();
69
+ return !VERTEX_NO_FUNCTION_CALLING_MODELS.has(lower) && !VERTEX_IMAGE_OUTPUT_SKU.test(lower);
70
+ }
71
+
72
+ /**
73
+ * Whether every configured API key (or the actively selected pool key) is paused on a Vertex row.
74
+ */
75
+ function isVertexApiKeyPoolPaused(provider: OcxProviderConfig | undefined): boolean {
76
+ if (!provider || provider.authMode === "oauth" || provider.authMode === "forward" || provider.authMode === "local") {
77
+ return false;
78
+ }
79
+ const pool = provider.apiKeyPool;
80
+ if (!pool?.length) return false;
81
+ if (pool.every(entry => entry.disabled === true)) return true;
82
+ const ref = provider._apiKeyAttempt?.reference ?? provider.apiKey;
83
+ if (!ref?.trim()) return false;
84
+ return pool.some(entry => entry.disabled === true && entry.key === ref)
85
+ && !pool.some(entry => !entry.disabled && entry.key === ref);
86
+ }
87
+
88
+ /** A `keychain:` or `$ENV` reference names one credential; it never widens to ambient ones. */
89
+ function isExplicitKeyReference(value: string | undefined): value is string {
90
+ return typeof value === "string" && (value.startsWith("keychain:") || value.startsWith("$"));
91
+ }
92
+
93
+ /**
94
+ * The credential a Vertex discovery request uses, chosen in the same order and on the same bytes
95
+ * as inference, so discovery can never publish another account's roster under this provider:
96
+ *
97
+ * 1. `usableResolvedApiKey` (routed-config): a `gcp-sa:` marker passes through verbatim; anything
98
+ * else is resolved (`keychain:` / `$ENV`) and a blank result counts as no key. No trimming.
99
+ * 2. `snapshotVertexEnvironment` (routed-config): an explicit `keychain:` / `$ENV` reference that
100
+ * resolved to nothing usable fails closed (`key` undefined), never reaching
101
+ * `GOOGLE_CLOUD_API_KEY` or host ADC. A value that is a `gcp-sa:` marker, configured directly
102
+ * or reached through a reference, selects ADC for that stored service account.
103
+ * 3. `resolveVertexApiKey` (Google adapter): `N/A` and `<...>` placeholders are not keys; then
104
+ * `GOOGLE_CLOUD_API_KEY`, then host ADC.
105
+ *
106
+ * `tests/adapters/google/vertex-model-discovery.test.ts` checks this against the credential the
107
+ * inference adapter actually sends for the same rows.
108
+ */
109
+ export type VertexDiscoveryCredential =
110
+ | { kind: "api-key"; key: string | undefined; ambient?: true }
111
+ | { kind: "adc"; marker?: string };
112
+
113
+ export function selectVertexDiscoveryCredential(provider: OcxProviderConfig): VertexDiscoveryCredential {
114
+ const configured = provider.apiKey;
115
+ const reference = provider._apiKeyAttempt?.reference ?? configured;
116
+ // A routed row already carries the resolved value beside its reference; never resolve it twice.
117
+ const alreadyResolved = provider._apiKeyAttempt !== undefined && reference !== configured;
118
+ let value: string | undefined;
119
+ if (alreadyResolved || (typeof configured === "string" && configured.startsWith(GCP_CREDENTIAL_MARKER_PREFIX))) {
120
+ value = configured;
121
+ } else {
122
+ const resolved = resolveProviderApiKey(configured);
123
+ value = typeof resolved === "string" && resolved.trim().length > 0 ? resolved : undefined;
124
+ }
125
+ if (isExplicitKeyReference(reference)
126
+ && (!value?.trim() || value === "N/A" || value.startsWith("<") || reference === "keychain:")) {
127
+ return { kind: "api-key", key: undefined };
128
+ }
129
+ if (value?.startsWith(GCP_CREDENTIAL_MARKER_PREFIX)) return { kind: "adc", marker: value };
130
+ const key = value && !value.startsWith("<") && value !== "N/A" ? value : undefined;
131
+ if (key) return { kind: "api-key", key };
132
+ const ambientKey = process.env.GOOGLE_CLOUD_API_KEY;
133
+ return ambientKey ? { kind: "api-key", key: ambientKey, ambient: true } : { kind: "adc" };
134
+ }
135
+
136
+ /** Whether a Vertex provider row authenticates discovery with an API key rather than GCP ADC. */
137
+ export function usesVertexApiKeyForDiscovery(provider: OcxProviderConfig): boolean {
138
+ return selectVertexDiscoveryCredential(provider).kind === "api-key";
139
+ }
140
+
141
+ /**
142
+ * Synchronous Vertex discovery credential snapshot for passive (`observed`) catalog gathers.
143
+ *
144
+ * ADC token exchange is async, so passive gathers without an API key return `undefined` and
145
+ * either reuse a fresh model cache or degrade cleanly without sending an unauthenticated GET.
146
+ */
147
+ export function resolveObservedVertexDiscoveryToken(provider: OcxProviderConfig): string | undefined {
148
+ return resolveObservedVertexDiscoveryAuth(provider)?.token;
149
+ }
150
+
151
+ /** The passive gather's credential with its authority bound, for the same send-time checks. */
152
+ export function resolveObservedVertexDiscoveryAuth(provider: OcxProviderConfig): VertexDiscoveryAuth | undefined {
153
+ if (provider.authMode === "forward" || isVertexApiKeyPoolPaused(provider)) return undefined;
154
+ const selection = selectVertexDiscoveryCredential(provider);
155
+ return selection.kind === "api-key" ? apiKeyDiscoveryAuth(selection) : undefined;
156
+ }
157
+
158
+ /**
159
+ * A resolved discovery credential bound to the selection that produced it. The token alone cannot
160
+ * say where it belongs: an ADC bearer placed in `x-goog-api-key` would leak to the wrong scheme.
161
+ */
162
+ export interface VertexDiscoveryAuth {
163
+ token: string;
164
+ kind: "api-key" | "adc";
165
+ marker?: string;
166
+ }
167
+
168
+ function sameVertexSelection(left: VertexDiscoveryCredential, right: VertexDiscoveryCredential): boolean {
169
+ if (left.kind === "api-key") return right.kind === "api-key" && left.key === right.key;
170
+ return right.kind === "adc" && left.marker === right.marker;
171
+ }
172
+
173
+ /**
174
+ * An API-key auth. A key read from `GOOGLE_CLOUD_API_KEY` is bound to the ambient-key authority
175
+ * observed when it was read (`captureVertexAmbientKey`, the record inference binds), so an A→B→A
176
+ * change of the variable invalidates it even though the bytes match again.
177
+ */
178
+ function apiKeyDiscoveryAuth(selection: { key: string | undefined; ambient?: true }): VertexDiscoveryAuth | undefined {
179
+ if (!selection.key) return undefined;
180
+ const auth: VertexDiscoveryAuth = { token: selection.key, kind: "api-key" };
181
+ if (selection.ambient) bindVertexRequestAuthority(auth, "", selection.key, { ambientKey: captureVertexAmbientKey(selection.key) });
182
+ return auth;
183
+ }
184
+
185
+ /**
186
+ * Resolve the Vertex model-discovery credential (API key or GCP ADC access token) with its kind.
187
+ *
188
+ * `signal` bounds the ADC exchange by the discovery time budget; without it a stalled token
189
+ * endpoint would hold discovery through every token retry. Paused key pools, unreadable explicit
190
+ * references and malformed `gcp-sa:` markers return `undefined` and never reach ambient credentials.
191
+ * The selection is taken again after the exchange: if it changed meanwhile (an ambient key appeared,
192
+ * a reference now resolves elsewhere) the token is discarded rather than sent under the new selection.
193
+ * An ADC token is bound to the source and generation that minted it through the same
194
+ * `bindVertexRequestAuthority` record inference uses, so a replaced host ADC file or a credential
195
+ * replaced behind the same `gcp-sa:` marker invalidates it before the next send.
196
+ */
197
+ export async function resolveVertexDiscoveryAuth(
198
+ provider: OcxProviderConfig,
199
+ signal: AbortSignal = vertexDiscoveryDeadline(),
200
+ ): Promise<VertexDiscoveryAuth | undefined> {
201
+ if (provider.authMode === "forward" || isVertexApiKeyPoolPaused(provider)) return undefined;
202
+ const selection = selectVertexDiscoveryCredential(provider);
203
+ if (selection.kind === "api-key") return apiKeyDiscoveryAuth(selection);
204
+ let authority: Awaited<ReturnType<typeof getVertexAccessTokenWithAuthority>>;
205
+ try {
206
+ const markerAccount = gcpCredentialMarkerAccount(selection.marker);
207
+ authority = await getVertexAccessTokenWithAuthority({ signal, ...(markerAccount ? { markerAccount } : {}) });
208
+ } catch {
209
+ return undefined;
210
+ }
211
+ if (!sameVertexSelection(selection, selectVertexDiscoveryCredential(provider))) return undefined;
212
+ const auth: VertexDiscoveryAuth = { token: authority.token, kind: "adc", ...(selection.marker ? { marker: selection.marker } : {}) };
213
+ bindVertexRequestAuthority(auth, "", `Bearer ${authority.token}`, {
214
+ source: authority.source,
215
+ generation: authority.generation,
216
+ ...(authority.markerAccount ? { markerAccount: authority.markerAccount } : {}),
217
+ });
218
+ return auth;
219
+ }
220
+
221
+ /** The token from `resolveVertexDiscoveryAuth`, for callers that only need to know one exists. */
222
+ export async function resolveVertexDiscoveryToken(
223
+ provider: OcxProviderConfig,
224
+ signal?: AbortSignal,
225
+ ): Promise<string | undefined> {
226
+ return (await resolveVertexDiscoveryAuth(provider, signal))?.token;
227
+ }
228
+
229
+ /**
230
+ * Send-time check, run before every discovery request (`beforeSend`): the row still selects the
231
+ * credential this token came from, an ADC token's source and generation are still current (the
232
+ * check inference runs before dispatch), and the outgoing headers carry it in that scheme's header
233
+ * and not the other one. Any change cancels the send, first page and follow-up pages alike, so a
234
+ * token never reaches a scheme or an authority it was not issued for.
235
+ */
236
+ export function vertexDiscoveryAuthIsCurrent(
237
+ provider: OcxProviderConfig,
238
+ auth: VertexDiscoveryAuth,
239
+ headers: Record<string, string>,
240
+ ): boolean {
241
+ if (provider.authMode === "forward" || isVertexApiKeyPoolPaused(provider)) return false;
242
+ // ADC source/generation and the ambient-key generation, exactly as inference checks them. Checked
243
+ // first so every send-time check also observes the current ambient key, as inference does.
244
+ if (!vertexRequestAuthorityIsCurrent(auth)) return false;
245
+ const current = selectVertexDiscoveryCredential(provider);
246
+ const issued: VertexDiscoveryCredential = auth.kind === "api-key"
247
+ ? { kind: "api-key", key: auth.token }
248
+ : { kind: "adc", ...(auth.marker ? { marker: auth.marker } : {}) };
249
+ if (!sameVertexSelection(issued, current)) return false;
250
+ const header = (name: string): string | undefined =>
251
+ Object.entries(headers).find(([key]) => key.toLowerCase() === name)?.[1];
252
+ const bearer = `Bearer ${auth.token}`;
253
+ return auth.kind === "api-key"
254
+ ? header("x-goog-api-key") === auth.token && header("authorization") !== bearer
255
+ : header("authorization") === bearer && header("x-goog-api-key") !== auth.token;
256
+ }
257
+
258
+ /**
259
+ * Build the Vertex AI Publisher Models discovery request (`GET /v1beta1/publishers/google/models`).
260
+ *
261
+ * URL construction is strictly independent of `apiKey` so `captureModelsRequest` sentinel checks
262
+ * remain invariant across `undefined` and `REQUEST_CREDENTIAL_SENTINEL`.
263
+ */
264
+ export function buildVertexModelsDiscoveryRequest(
265
+ effectiveProvider: OcxProviderConfig,
266
+ apiKey: string | undefined,
267
+ headers: Record<string, string>,
268
+ resolveUrl: (defaultUrl: string) => string,
269
+ ): { url: string; headers: Record<string, string> } {
270
+ const base = effectiveProvider.baseUrl.replace(/\/+$/, "").replace(VERTEX_TRAILING_API_VERSION, "");
271
+ if (usesVertexApiKeyForDiscovery(effectiveProvider)) {
272
+ if (apiKey) headers["x-goog-api-key"] = apiKey;
273
+ } else {
274
+ if (apiKey) headers.Authorization = `Bearer ${apiKey}`;
275
+ const project = effectiveProvider.project?.trim()
276
+ || process.env.GOOGLE_CLOUD_PROJECT?.trim()
277
+ || process.env.GCLOUD_PROJECT?.trim();
278
+ if (project && project.toLowerCase() !== "auto") {
279
+ headers["x-goog-user-project"] = project;
280
+ }
281
+ }
282
+ // Vertex ModelGardenService.ListPublisherModels enforces a maximum pageSize of 300
283
+ // (values > 300 return HTTP 400 INVALID_ARGUMENT); later pages follow nextPageToken.
284
+ return {
285
+ url: resolveUrl(`${base}/v1beta1/publishers/google/models?pageSize=300`),
286
+ headers,
287
+ };
288
+ }
289
+
290
+ /**
291
+ * Build a Vertex AI Publisher Models request when the provider row resolves to non-OAuth `vertex` mode,
292
+ * or return `undefined` so callers delegate to the default `buildModelsRequest` builder.
293
+ */
294
+ export function buildVertexProviderModelsRequest(
295
+ providerName: string,
296
+ prov: OcxProviderConfig,
297
+ apiKey: string | undefined,
298
+ ): { method?: "POST"; url: string; headers: Record<string, string> } | undefined {
299
+ if (prov.authMode === "oauth") return undefined;
300
+ const effectiveProvider = resolveProviderTransport(providerName, prov);
301
+ if (effectiveGoogleMode(providerName, effectiveProvider) !== "vertex") return undefined;
302
+ const registryStaticHeaders = providerMatchesRegistryTransport(providerName, effectiveProvider)
303
+ ? getProviderRegistryEntry(providerName)?.staticHeaders
304
+ : undefined;
305
+ const headers: Record<string, string> = {
306
+ ...(mergeRegistryStaticHeaders(registryStaticHeaders, effectiveProvider.headers) ?? {}),
307
+ };
308
+ const resolveUrl = (defaultUrl: string): string => resolveProviderModelDiscoveryUrl(
309
+ providerName,
310
+ prov,
311
+ effectiveProvider.baseUrl,
312
+ defaultUrl,
313
+ );
314
+ return buildVertexModelsDiscoveryRequest(effectiveProvider, apiKey, headers, resolveUrl);
315
+ }
316
+
317
+ export type VertexPublisherModelListing =
318
+ | { ok: true; value: unknown }
319
+ | { ok: false; reason: "incomplete"; diagnostic: string };
320
+
321
+ /** Wrap a discovery response so the bytes actually read from its body can be counted. */
322
+ export function countDiscoveryResponseBytes(response: Response): { response: Response; bytes: () => number } {
323
+ let total = 0;
324
+ if (!response.body) return { response, bytes: () => total };
325
+ const counted = response.body.pipeThrough(new TransformStream<Uint8Array, Uint8Array>({
326
+ transform(chunk, controller) {
327
+ total += chunk.byteLength;
328
+ controller.enqueue(chunk);
329
+ },
330
+ }));
331
+ return { response: new Response(counted, { status: response.status, headers: response.headers }), bytes: () => total };
332
+ }
333
+
334
+ /** The single deadline one Vertex discovery shares across ADC, the first request and every page. */
335
+ export function vertexDiscoveryDeadline(cancel?: AbortSignal): AbortSignal {
336
+ const budget = AbortSignal.timeout(VERTEX_DISCOVERY_TIMEOUT_MS);
337
+ return cancel ? AbortSignal.any([cancel, budget]) : budget;
338
+ }
339
+
340
+ function nextVertexPageToken(page: Record<string, unknown>): string | undefined | null {
341
+ const token = page.nextPageToken;
342
+ if (token === undefined || token === "") return undefined;
343
+ return typeof token === "string" && token.length <= VERTEX_PAGE_TOKEN_MAX_LENGTH ? token : null;
344
+ }
345
+
346
+ /**
347
+ * Follow `nextPageToken` across Vertex `publisherModels` pages and merge them into one envelope.
348
+ *
349
+ * One listing is bounded three ways: at most `VERTEX_DISCOVERY_MAX_PAGES` requests, at most the
350
+ * discovery row limit across every page, and at most the discovery byte limit across every page
351
+ * (`firstPageBytes` is the byte count the caller read for page one). Every page runs under the
352
+ * caller's `signal`, the same deadline that bounded ADC and the first request. When a bound, a
353
+ * page request, the deadline, a repeated token, or a follow-up page that is not a Vertex page
354
+ * stops the walk before the last page, the listing is reported incomplete: publishing the pages
355
+ * already read as the authoritative roster would drop every model on the pages that were not.
356
+ *
357
+ * A first page without a `publisherModels` array is returned unchanged for the caller's generic
358
+ * envelope handling (an OpenAI-compatible gateway in front of Vertex).
359
+ */
360
+ export async function collectVertexPublisherModelPages(
361
+ firstUrl: string,
362
+ firstValue: unknown,
363
+ limits: { maxModels: number; maxResponseBytes: number; firstPageBytes?: number; signal?: AbortSignal },
364
+ fetchPage: (url: string, signal: AbortSignal) => Promise<Response>,
365
+ ): Promise<VertexPublisherModelListing> {
366
+ const first = firstValue !== null && typeof firstValue === "object" && !Array.isArray(firstValue)
367
+ ? firstValue as Record<string, unknown>
368
+ : undefined;
369
+ // Google omits an empty repeated field, so a token-only first page is an empty Vertex page.
370
+ const tokenOnlyFirstPage = first !== undefined && first.publisherModels === undefined
371
+ && typeof first.nextPageToken === "string" && Object.keys(first).every(key => key === "nextPageToken");
372
+ if (!first || (!Array.isArray(first.publisherModels) && !tokenOnlyFirstPage)) return { ok: true, value: firstValue };
373
+ let token = nextVertexPageToken(first);
374
+ if (token === undefined) return { ok: true, value: firstValue };
375
+
376
+ const maxRows = Math.min(limits.maxModels, MODEL_DISCOVERY_MAX_MODELS);
377
+ const maxBytes = Math.min(limits.maxResponseBytes, MODEL_DISCOVERY_MAX_RESPONSE_BYTES);
378
+ const rows: unknown[] = Array.isArray(first.publisherModels) ? [...first.publisherModels] : [];
379
+ let bytes = limits.firstPageBytes ?? new TextEncoder().encode(JSON.stringify(firstValue)).byteLength;
380
+ const seenTokens = new Set<string>();
381
+ const signal = limits.signal ?? vertexDiscoveryDeadline();
382
+ const incomplete = (diagnostic: string): VertexPublisherModelListing =>
383
+ ({ ok: false, reason: "incomplete", diagnostic: `${diagnostic} after ${seenTokens.size + 1} page(s) and ${rows.length} row(s)` });
384
+
385
+ while (token !== undefined) {
386
+ if (token === null) return incomplete("returned a malformed nextPageToken");
387
+ if (seenTokens.has(token)) return incomplete("repeated a nextPageToken");
388
+ if (seenTokens.size + 1 >= VERTEX_DISCOVERY_MAX_PAGES) return incomplete(`exceeded the ${VERTEX_DISCOVERY_MAX_PAGES}-request page limit`);
389
+ if (rows.length > maxRows) return incomplete(`exceeded the ${maxRows}-row model limit`);
390
+ if (bytes >= maxBytes) return incomplete(`exceeded the ${maxBytes}-byte listing limit`);
391
+ seenTokens.add(token);
392
+ const pageUrl = new URL(firstUrl);
393
+ pageUrl.searchParams.set("pageToken", token);
394
+ let page: Record<string, unknown> | undefined;
395
+ try {
396
+ const response = await fetchPage(pageUrl.toString(), signal);
397
+ if (!response.ok) {
398
+ try { void response.body?.cancel().catch(() => undefined); } catch { /* best effort */ }
399
+ return incomplete(`page request failed with HTTP ${response.status}`);
400
+ }
401
+ const counted = countDiscoveryResponseBytes(response);
402
+ const read = await readBoundedDiscoveryJson(counted.response, maxBytes - bytes);
403
+ bytes += counted.bytes();
404
+ if (!read.ok) {
405
+ return incomplete(read.reason === "response_too_large" ? `exceeded the ${maxBytes}-byte listing limit` : "returned an invalid page");
406
+ }
407
+ const value = read.value;
408
+ page = value !== null && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : undefined;
409
+ } catch {
410
+ return incomplete(signal.aborted ? "exceeded the discovery time budget" : "page request failed");
411
+ }
412
+ // Google omits an empty repeated field, so an empty Vertex page is `{}` or carries only its
413
+ // token. Anything else without `publisherModels` (a gateway `data[]`, an error body) is not a
414
+ // Vertex page, and treating it as an empty last page would publish page one as the whole roster.
415
+ const vertexPage = page !== undefined && (Array.isArray(page.publisherModels)
416
+ || (page.publisherModels === undefined && Object.keys(page).every(key => key === "nextPageToken")));
417
+ if (!page || !vertexPage) {
418
+ return incomplete("returned a malformed page");
419
+ }
420
+ if (Array.isArray(page.publisherModels)) rows.push(...page.publisherModels);
421
+ token = nextVertexPageToken(page);
422
+ }
423
+ if (rows.length > maxRows) return incomplete(`exceeded the ${maxRows}-row model limit`);
424
+ return { ok: true, value: { publisherModels: rows } };
425
+ }
426
+
427
+ type ReasoningLadders = Readonly<Record<string, readonly string[]>> | undefined;
428
+
429
+ /**
430
+ * The reasoning ladders the Google adapter will serialize for this row. `routedProviderConfig`
431
+ * fills `modelReasoningEfforts` from the provider's own registry entry when the row matches it,
432
+ * and from the destination entry (`google-vertex` for aiplatform hosts) otherwise; the adapter
433
+ * then writes `thinkingConfig` only for a laddered model. Reading the same entry keeps discovery
434
+ * from advertising a rung the request would silently drop (an unladdered `gemini-3-pro`).
435
+ */
436
+ function vertexReasoningLadders(providerName: string, provider: OcxProviderConfig): ReasoningLadders {
437
+ const entry = providerMatchesRegistryTransport(providerName, provider)
438
+ ? getProviderRegistryEntry(providerName)
439
+ : registryEntryForProviderDestination(provider);
440
+ return entry?.modelReasoningEfforts;
441
+ }
442
+
443
+ /**
444
+ * Extracts and normalizes generative Gemini/Gemma model items from a Vertex AI
445
+ * `/v1beta1/publishers/google/models` response payload (`{ publisherModels: [...] }`).
446
+ *
447
+ * Strips the `publishers/google/models/` prefix, filters out non-`generateContent` SKUs
448
+ * (embeddings, TTS, transcription, Live API, Imagen/Veo) and SKUs without function calling, and
449
+ * enriches rows with vendored token/modality metadata and the registry's reasoning ladder.
450
+ */
451
+ export function extractGoogleVertexModelItems(
452
+ value: unknown,
453
+ maxModels: number,
454
+ ladders?: ReasoningLadders,
455
+ ): ProviderModelItemsResult {
456
+ const envelope = extractModelEnvelopeRows(value, maxModels, ["publisherModels"]);
457
+ if (!envelope.ok) return envelope;
458
+
459
+ const items: ProviderModelsApiItem[] = [];
460
+ const seen = new Set<string>();
461
+ for (const raw of envelope.rows) {
462
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
463
+ continue;
464
+ }
465
+ const name = Reflect.get(raw, "name");
466
+ if (!isValidModelDiscoveryModelId(name)) continue;
467
+ const id = name.startsWith(VERTEX_PUBLISHER_MODEL_PREFIX)
468
+ ? name.slice(VERTEX_PUBLISHER_MODEL_PREFIX.length)
469
+ : name;
470
+ if (!isValidModelDiscoveryModelId(id) || seen.has(id)) continue;
471
+ if (!VERTEX_GENERATIVE_MODEL_ID.test(id) || VERTEX_NON_CHAT_SKU.test(id)) continue;
472
+ if (!vertexModelSupportsFunctionCalling(id)) continue;
473
+ seen.add(id);
474
+
475
+ const meta = getModelMetadata("google", id) ?? getModelMetadataCaseInsensitive("google", id);
476
+ const efforts = ladders && Object.hasOwn(ladders, id) ? ladders[id] : undefined;
477
+ items.push({
478
+ id,
479
+ owned_by: "google",
480
+ ...(meta?.contextWindow !== undefined
481
+ ? { context_length: meta.contextWindow, max_input_tokens: meta.contextWindow }
482
+ : {}),
483
+ ...(meta?.maxTokens !== undefined ? { max_output_tokens: meta.maxTokens } : {}),
484
+ ...(meta?.input?.length ? { input_modalities: [...meta.input] } : {}),
485
+ ...(efforts?.length ? { reasoning_efforts: [...efforts] } : {}),
486
+ });
487
+ }
488
+ return { ok: true, items, rawCount: envelope.rows.length };
489
+ }
490
+
491
+ /**
492
+ * Dispatch native Google model-list extraction for AI Studio (`models[]`) or Vertex AI
493
+ * (`publisherModels[]`), returning `undefined` when the payload uses an OpenAI-compatible
494
+ * gateway envelope (`data[]` or top-level array) so callers fall back cleanly.
495
+ */
496
+ export function extractGoogleNativeModelItems(
497
+ providerName: string,
498
+ provider: OcxProviderConfig,
499
+ value: unknown,
500
+ maxModels: number,
501
+ ): ProviderModelItemsResult | undefined {
502
+ const googleMode = effectiveGoogleMode(providerName, provider);
503
+ const result = googleMode === "ai-studio"
504
+ ? extractGoogleAiStudioModelItems(value, maxModels)
505
+ : googleMode === "vertex"
506
+ ? extractGoogleVertexModelItems(value, maxModels, vertexReasoningLadders(providerName, provider))
507
+ : undefined;
508
+ if (!result) return undefined;
509
+ return result.ok || result.reason === "too_many_models" ? result : undefined;
510
+ }