@bitkyc08/opencodex 2.100.1 → 2.100.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (624) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/Tray-BV4ms9U9.js +1 -0
  6. package/gui/dist/assets/{brand-mark-nr3ziR-T.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/index-DQtCRNAw.css +2 -0
  9. package/gui/dist/assets/{segment-thumb-features-DKCVUUTi.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-BedmOsE7.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/quota-summary-Dy5_wfTT.js +1 -0
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +6 -4
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/native-exec.ts +3 -2
  38. package/src/adapters/cursor/protobuf-request.ts +8 -8
  39. package/src/adapters/cursor/tool-guidance.ts +3 -3
  40. package/src/adapters/cursor/tool-wording.ts +10 -1
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/tool-schema.ts +20 -2
  43. package/src/adapters/google-antigravity-wire.ts +15 -6
  44. package/src/adapters/google-truncation.ts +4 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +17 -4
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/openai-chat/tool-schema.ts +9 -0
  54. package/src/adapters/openai-responses/tool-schema.ts +18 -4
  55. package/src/adapters/run-turn-queue.ts +139 -5
  56. package/src/adapters/upstream-http-error.ts +4 -2
  57. package/src/adapters/zed.ts +3 -0
  58. package/src/advisor/consult.ts +15 -4
  59. package/src/advisor/context.ts +12 -3
  60. package/src/advisor/runtime.ts +35 -5
  61. package/src/advisor/settings.ts +8 -0
  62. package/src/advisor/synthetic-tool.ts +21 -8
  63. package/src/bridge/response-json.ts +11 -2
  64. package/src/bridge/sse.ts +51 -9
  65. package/src/claude/auth-detect.ts +21 -33
  66. package/src/claude/chat-tool-dispatch.ts +233 -0
  67. package/src/claude/desktop-3p.ts +11 -5
  68. package/src/claude/desktop-gateway-state.ts +2 -0
  69. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  70. package/src/claude/desktop-remote-store.ts +24 -4
  71. package/src/claude/inbound-content-options.ts +31 -16
  72. package/src/claude/inbound-tool-loading.ts +42 -17
  73. package/src/claude/outbound.ts +13 -3
  74. package/src/cli/account-api.ts +23 -1
  75. package/src/cli/account-auth.ts +54 -21
  76. package/src/cli/account-extended.ts +60 -6
  77. package/src/cli/account-key-quota.ts +56 -7
  78. package/src/cli/account.ts +5 -3
  79. package/src/cli/advisor.ts +7 -4
  80. package/src/cli/alias.ts +38 -1
  81. package/src/cli/capabilities-access-remote.ts +137 -2
  82. package/src/cli/capabilities-accounts.ts +3 -3
  83. package/src/cli/capabilities-agents-routing.ts +17 -10
  84. package/src/cli/capabilities-base.ts +43 -18
  85. package/src/cli/capabilities-integrations.ts +2 -2
  86. package/src/cli/capabilities-provider-models.ts +18 -2
  87. package/src/cli/capabilities-route-to.ts +43 -0
  88. package/src/cli/capabilities.ts +2 -0
  89. package/src/cli/capability-contracts.ts +1 -1
  90. package/src/cli/claude-desktop.ts +30 -11
  91. package/src/cli/claude.ts +36 -17
  92. package/src/cli/codex-launcher.ts +3 -1
  93. package/src/cli/codex-shim-autorestore.ts +5 -42
  94. package/src/cli/config-command.ts +38 -2
  95. package/src/cli/config-root-startup.ts +34 -0
  96. package/src/cli/connect.ts +124 -19
  97. package/src/cli/desktop-runtime-guidance.ts +1 -1
  98. package/src/cli/disconnect-runtime.ts +168 -0
  99. package/src/cli/dispatch.ts +54 -12
  100. package/src/cli/export-command.ts +1 -1
  101. package/src/cli/gui-pair-client.ts +29 -5
  102. package/src/cli/gui.ts +10 -5
  103. package/src/cli/help-catalog.ts +11 -0
  104. package/src/cli/help.ts +5 -4
  105. package/src/cli/hub.ts +18 -1
  106. package/src/cli/index.ts +83 -92
  107. package/src/cli/inspect.ts +11 -2
  108. package/src/cli/integrations.ts +26 -1
  109. package/src/cli/link-capture.ts +64 -0
  110. package/src/cli/link-child-ops.ts +314 -0
  111. package/src/cli/link-cleanup.ts +8 -5
  112. package/src/cli/link-diagnostics.ts +67 -0
  113. package/src/cli/link-enrollment.ts +158 -12
  114. package/src/cli/link-operations.ts +52 -0
  115. package/src/cli/link-recover.ts +152 -0
  116. package/src/cli/link-routes.ts +87 -0
  117. package/src/cli/link-status-child.ts +137 -0
  118. package/src/cli/link-status-traffic.ts +34 -0
  119. package/src/cli/link.ts +327 -37
  120. package/src/cli/message-command.ts +1 -1
  121. package/src/cli/message-mcp-command.ts +23 -10
  122. package/src/cli/models-runtime.ts +3 -3
  123. package/src/cli/opencode.ts +3 -1
  124. package/src/cli/pi-sync.ts +35 -0
  125. package/src/cli/preflight-exemptions.ts +46 -0
  126. package/src/cli/registry.ts +29 -12
  127. package/src/cli/restart-failure.ts +5 -2
  128. package/src/cli/root.ts +5 -1
  129. package/src/cli/route-to.ts +172 -0
  130. package/src/cli/runtime-api.ts +5 -8
  131. package/src/cli/status.ts +3 -1
  132. package/src/cli/stop-approval.ts +66 -19
  133. package/src/cli/stop-report.ts +23 -0
  134. package/src/cli/stop-windows-checked.ts +304 -0
  135. package/src/cli/sync-command.ts +70 -13
  136. package/src/cli/sync-fanout.ts +81 -99
  137. package/src/cli/sync-flags.ts +40 -3
  138. package/src/cli/sync-link-status.ts +18 -2
  139. package/src/cli/sync-update-guard.ts +7 -2
  140. package/src/cli/system-restart-client.ts +3 -2
  141. package/src/cli/uninstall-plan.ts +77 -5
  142. package/src/cli/uninstall-stop.ts +152 -0
  143. package/src/cli/v2-input.ts +10 -6
  144. package/src/cli/v2-local-output.ts +3 -2
  145. package/src/cli/v2-runtime.ts +10 -3
  146. package/src/cli/v2.ts +22 -7
  147. package/src/client/connect.ts +321 -34
  148. package/src/client/link-home-features.ts +27 -0
  149. package/src/client/link-home.ts +92 -4
  150. package/src/client/link-ingress.ts +21 -3
  151. package/src/client/link-join.ts +12 -2
  152. package/src/client/link-parity-reporter.ts +60 -6
  153. package/src/client/link-readiness.ts +16 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel-status.ts +76 -0
  161. package/src/client/link-tunnel.ts +56 -5
  162. package/src/client/link-websocket-limits.ts +89 -0
  163. package/src/client/link-websocket.ts +586 -0
  164. package/src/client/link-ws-advertisement.ts +100 -0
  165. package/src/client/link-ws-framer.ts +241 -0
  166. package/src/client/link-ws-transport.ts +177 -0
  167. package/src/client/machine-api.ts +13 -2
  168. package/src/client/machine-listener.ts +48 -7
  169. package/src/client/route-intent-apply.ts +293 -0
  170. package/src/client/route-intent-file-originals.ts +97 -0
  171. package/src/client/route-intent-native-originals.ts +201 -0
  172. package/src/client/route-intent-watch.ts +141 -0
  173. package/src/client/runtime-restart.ts +127 -5
  174. package/src/client/runtime.ts +61 -15
  175. package/src/client/state.ts +30 -0
  176. package/src/client/sync-expectation.ts +36 -2
  177. package/src/client/sync-runtime.ts +7 -0
  178. package/src/clients/config-export/alias-selectors.ts +63 -40
  179. package/src/clients/config-export/contracts.ts +2 -0
  180. package/src/clients/config-export/nested-selectors.ts +42 -0
  181. package/src/clients/config-export.ts +36 -4
  182. package/src/codex/account-resume-health.ts +41 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/login-flow.ts +6 -0
  187. package/src/codex/auth-api/routes.ts +35 -2
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +21 -6
  190. package/src/codex/catalog/gather-capture.ts +10 -2
  191. package/src/codex/catalog/parsing.ts +7 -3
  192. package/src/codex/catalog/provider-models.ts +67 -23
  193. package/src/codex/catalog/retained-sync.ts +2 -1
  194. package/src/codex/catalog/routed-gather.ts +1 -1
  195. package/src/codex/catalog-auto-refresh.ts +11 -0
  196. package/src/codex/cli-update-job.ts +35 -13
  197. package/src/codex/convergence-types.ts +2 -0
  198. package/src/codex/convergence.ts +2 -2
  199. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  200. package/src/codex/features.ts +2 -2
  201. package/src/codex/history-provider.ts +31 -0
  202. package/src/codex/inject/multi-agent-v2.ts +9 -3
  203. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  204. package/src/codex/inject/plan.ts +20 -2
  205. package/src/codex/inject.ts +2 -0
  206. package/src/codex/journal-config-restore.ts +217 -0
  207. package/src/codex/journal.ts +75 -6
  208. package/src/codex/main-account.ts +23 -30
  209. package/src/codex/native-main-auth-file.ts +104 -0
  210. package/src/codex/native-profile-manager.ts +4 -3
  211. package/src/codex/native-profile-store.ts +3 -61
  212. package/src/codex/orca-import.ts +10 -1
  213. package/src/codex/quota-history.ts +13 -0
  214. package/src/codex/quota-window-conflict.ts +103 -0
  215. package/src/codex/quota.ts +134 -7
  216. package/src/codex/subagent-model-fallback.ts +3 -1
  217. package/src/codex/websocket-activity.ts +171 -16
  218. package/src/codex/websocket-registry.ts +11 -4
  219. package/src/combos/cooldown-store.ts +228 -0
  220. package/src/combos/failover.ts +760 -35
  221. package/src/config/dashboard-trusted-proxy.ts +83 -0
  222. package/src/config/diagnostics.ts +28 -0
  223. package/src/config/feature-flags.ts +9 -0
  224. package/src/config/live-reconcile.ts +10 -1
  225. package/src/config/load-degrade.ts +12 -1
  226. package/src/config/multi-agent-surface.ts +28 -5
  227. package/src/config/pending-teardown.ts +60 -3
  228. package/src/config/process-state.ts +175 -4
  229. package/src/config/provider-validation.ts +4 -4
  230. package/src/config/salvage.ts +1 -0
  231. package/src/config/schema/config-schema.ts +12 -3
  232. package/src/config/schema/leaf-validators.ts +43 -14
  233. package/src/config/windows-process-command-line.ts +107 -0
  234. package/src/generated/compatibility-version.json +1077 -429
  235. package/src/generated/model-metadata.ts +1 -1
  236. package/src/images/loop.ts +3 -0
  237. package/src/integrations/model-name-guard.ts +25 -0
  238. package/src/integrations/route-intent-catalog.ts +26 -0
  239. package/src/integrations/route-intent-connected.ts +262 -0
  240. package/src/integrations/route-intent-contract.ts +55 -0
  241. package/src/integrations/route-intent-disconnect.ts +109 -0
  242. package/src/integrations/route-intent-initial.ts +64 -0
  243. package/src/integrations/route-intent-state.ts +117 -0
  244. package/src/integrations/route-intent-tick.ts +65 -0
  245. package/src/integrations/route-intent.ts +212 -0
  246. package/src/integrations/writer.ts +44 -11
  247. package/src/lib/catalog-etag.ts +10 -0
  248. package/src/lib/client-error-body.ts +15 -0
  249. package/src/lib/client-retry-after.ts +29 -0
  250. package/src/lib/config-ownership.ts +13 -0
  251. package/src/lib/context-overflow-verdict.ts +266 -9
  252. package/src/lib/desktop-gui-origin.ts +28 -0
  253. package/src/lib/errors.ts +1 -1
  254. package/src/lib/failure-detail.ts +72 -3
  255. package/src/lib/gui-pair-capability.ts +2 -1
  256. package/src/lib/hard-refusal.ts +259 -0
  257. package/src/lib/messages-error-body.ts +4 -1
  258. package/src/lib/outbound-credential-registry.ts +362 -4
  259. package/src/lib/paced-stream.ts +34 -0
  260. package/src/lib/passive-key-fetch-proof.ts +30 -0
  261. package/src/lib/passive-read.ts +5 -0
  262. package/src/lib/process-control.ts +76 -12
  263. package/src/lib/redact.ts +84 -8
  264. package/src/lib/state-store-registrations.ts +11 -0
  265. package/src/lib/state-store-sweeper.ts +4 -0
  266. package/src/lib/supervisor-markers.ts +18 -0
  267. package/src/lib/terminal-safe-text.ts +58 -0
  268. package/src/lib/translator-budget.ts +3 -2
  269. package/src/lib/upstream-retry.ts +14 -4
  270. package/src/link/alias-lock.ts +119 -0
  271. package/src/link/child-activity.ts +83 -0
  272. package/src/link/child-binary-cache-fill.d.mts +50 -0
  273. package/src/link/child-binary-cache-fill.mjs +494 -0
  274. package/src/link/child-binary-cache-start.ts +73 -0
  275. package/src/link/child-binary-source.ts +12 -5
  276. package/src/link/child-catalog-freshness.ts +149 -0
  277. package/src/link/child-gated-ocx.ts +135 -0
  278. package/src/link/child-observations.ts +206 -0
  279. package/src/link/child-observe.ts +121 -0
  280. package/src/link/child-ops-engine.ts +230 -0
  281. package/src/link/child-ops-host.ts +138 -0
  282. package/src/link/child-ops-runners.ts +319 -0
  283. package/src/link/child-ops-scheduler.ts +207 -0
  284. package/src/link/child-ops-types.ts +89 -0
  285. package/src/link/child-parity.ts +23 -4
  286. package/src/link/child-policy.ts +93 -0
  287. package/src/link/child-update-contract.ts +174 -0
  288. package/src/link/codex-settings.ts +1 -1
  289. package/src/link/compatibility.ts +18 -1
  290. package/src/link/diagnostics-read.ts +163 -0
  291. package/src/link/diagnostics.ts +20 -7
  292. package/src/link/explicit-route.ts +209 -0
  293. package/src/link/link-recover.ts +113 -0
  294. package/src/link/management-routes.ts +3 -1
  295. package/src/link/operation-recovery-slot.ts +44 -0
  296. package/src/link/operations-journal.ts +408 -0
  297. package/src/link/paths.ts +5 -0
  298. package/src/link/peer-report.ts +1 -1
  299. package/src/link/relay-auth.ts +14 -0
  300. package/src/link/remote-plant.ts +152 -14
  301. package/src/link/remote-platform.ts +21 -10
  302. package/src/link/remote-probe.ts +11 -3
  303. package/src/link/remote-windows.ts +88 -12
  304. package/src/link/request-compression.ts +30 -0
  305. package/src/link/residual-recovery.ts +54 -0
  306. package/src/link/retirement.ts +128 -0
  307. package/src/link/route-intent-watch.ts +41 -0
  308. package/src/link/route-intent.ts +209 -0
  309. package/src/link/route-proof.ts +82 -0
  310. package/src/link/route-rounds.ts +579 -0
  311. package/src/link/route-select.ts +95 -0
  312. package/src/link/route-trust.ts +96 -0
  313. package/src/link/ssh-argv.ts +285 -43
  314. package/src/link/ssh-capture-redact.ts +253 -0
  315. package/src/link/ssh-capture.ts +497 -0
  316. package/src/link/ssh-runner.ts +141 -14
  317. package/src/link/status-projection.ts +160 -0
  318. package/src/link/store.ts +54 -1
  319. package/src/link/supervisor.ts +543 -55
  320. package/src/link/sync-fanout-classify.ts +114 -0
  321. package/src/link/sync-then-restart.ts +65 -0
  322. package/src/link/tombstones.ts +209 -0
  323. package/src/link/traffic.ts +178 -0
  324. package/src/link/tunnel-state.ts +10 -4
  325. package/src/link/ws-activity-holds.ts +474 -0
  326. package/src/local-credentials/publication-fence.ts +20 -1
  327. package/src/messaging/mcp-queue-rpc.ts +3 -2
  328. package/src/messaging/mcp-queue-server.ts +21 -1
  329. package/src/messaging/mcp-reply-tools.ts +24 -9
  330. package/src/messaging/mcp-reply-wait.ts +70 -0
  331. package/src/messaging/mcp-resume-tools.ts +25 -0
  332. package/src/messaging/remote-enrollment.ts +3 -3
  333. package/src/messaging/remote-tunnels.ts +2 -2
  334. package/src/messaging/resume-permissions.ts +27 -0
  335. package/src/messaging/rpc.ts +46 -2
  336. package/src/oauth/account-resume-health.ts +60 -0
  337. package/src/oauth/anthropic-continuity.ts +23 -7
  338. package/src/oauth/anthropic-routing.ts +5 -2
  339. package/src/oauth/anthropic.ts +22 -2
  340. package/src/oauth/claude-keychain-read.ts +78 -68
  341. package/src/oauth/index.ts +25 -6
  342. package/src/oauth/local-token-detect.ts +8 -29
  343. package/src/oauth/login-cli-errors.ts +5 -1
  344. package/src/oauth/login-cli.ts +33 -18
  345. package/src/oauth/login-flow-state.ts +26 -3
  346. package/src/oauth/meta-muse.ts +1 -1
  347. package/src/oauth/store.ts +51 -1
  348. package/src/oauth/xai.ts +248 -14
  349. package/src/protocols/contract.ts +4 -0
  350. package/src/protocols/encoders/messages.ts +1 -0
  351. package/src/providers/alias-template.ts +48 -0
  352. package/src/providers/anthropic-billing-ownership.ts +2 -0
  353. package/src/providers/anthropic-output-caps.ts +46 -0
  354. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  355. package/src/providers/antigravity-effort-families.ts +11 -3
  356. package/src/providers/antigravity-models.ts +32 -9
  357. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  358. package/src/providers/api-key-pause-state.ts +23 -0
  359. package/src/providers/api-key-pause.ts +71 -10
  360. package/src/providers/api-key-resolve.ts +49 -7
  361. package/src/providers/api-key-response-ownership.ts +2 -0
  362. package/src/providers/api-key-selection-capture.ts +3 -1
  363. package/src/providers/api-key-selection.ts +54 -11
  364. package/src/providers/api-keys.ts +24 -7
  365. package/src/providers/cache-affinity-identity.ts +73 -0
  366. package/src/providers/cache-affinity.ts +256 -0
  367. package/src/providers/claude-cli-usage-state.ts +11 -6
  368. package/src/providers/claude-cli-usage.ts +27 -9
  369. package/src/providers/codex-capacity.ts +11 -2
  370. package/src/providers/default-aliases.ts +98 -20
  371. package/src/providers/google-vertex-model-discovery.ts +510 -0
  372. package/src/providers/key-failover.ts +136 -14
  373. package/src/providers/key-store.ts +3 -3
  374. package/src/providers/kiro-models.ts +3 -5
  375. package/src/providers/label.ts +31 -5
  376. package/src/providers/mistral-transport.ts +17 -4
  377. package/src/providers/model-discovery-config.ts +31 -0
  378. package/src/providers/model-discovery-diagnostic.ts +34 -3
  379. package/src/providers/model-discovery.ts +43 -7
  380. package/src/providers/model-rename-fields.ts +5 -0
  381. package/src/providers/muse-key-quota.ts +14 -6
  382. package/src/providers/new-model-policy-runtime.ts +17 -4
  383. package/src/providers/new-model-policy.ts +30 -4
  384. package/src/providers/openai-sidecar.ts +15 -2
  385. package/src/providers/passive-key-observation.ts +252 -0
  386. package/src/providers/provider-id-rewrite.ts +3 -0
  387. package/src/providers/quota/account-cache.ts +53 -34
  388. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  389. package/src/providers/quota/anthropic-usage-windows.ts +19 -9
  390. package/src/providers/quota/passive-key-limits.ts +272 -0
  391. package/src/providers/quota/passive-wire-model.ts +126 -0
  392. package/src/providers/quota/report-cache.ts +112 -5
  393. package/src/providers/quota/vendor-probes-key.ts +73 -0
  394. package/src/providers/quota/vendor-probes-oauth.ts +57 -3
  395. package/src/providers/quota-key-accounts.ts +22 -10
  396. package/src/providers/quota-mistral-budget.ts +18 -0
  397. package/src/providers/quota-types.ts +43 -0
  398. package/src/providers/quota.ts +31 -32
  399. package/src/providers/reasoning-metadata.ts +1051 -12
  400. package/src/providers/registry/entries-core.ts +34 -16
  401. package/src/providers/registry/entries-extended.ts +32 -0
  402. package/src/providers/registry/model-seeds.ts +35 -0
  403. package/src/providers/resolved-model-policy.ts +7 -0
  404. package/src/providers/routed-config.ts +8 -3
  405. package/src/providers/xai-transport.ts +3 -0
  406. package/src/quota/reset-observer.ts +4 -2
  407. package/src/quota/reset-seen-store.ts +9 -0
  408. package/src/quota/window-mapping.ts +1 -0
  409. package/src/quota-pool/assemble.ts +4 -1
  410. package/src/remote/features.ts +17 -0
  411. package/src/responses/anthropic-progress.ts +10 -4
  412. package/src/responses/citation-markers.ts +231 -0
  413. package/src/responses/hosted-tool-policy.ts +56 -12
  414. package/src/responses/spill-store.ts +5 -1
  415. package/src/responses/state/replay-input.ts +50 -0
  416. package/src/responses/state/replay-owner.ts +24 -0
  417. package/src/responses/state/snapshot-codec.ts +9 -0
  418. package/src/responses/state/spill-queue.ts +1 -0
  419. package/src/responses/state.ts +42 -60
  420. package/src/router.ts +4 -2
  421. package/src/routing/home-route-capture.ts +123 -0
  422. package/src/routing/home-route-intent.ts +200 -0
  423. package/src/routing/route-intent-state.ts +178 -0
  424. package/src/routing/route-to-live-settings.ts +35 -0
  425. package/src/routing/route-to-local.ts +145 -0
  426. package/src/routing/route-to-status.ts +94 -0
  427. package/src/routing/route-to-sync-child.ts +32 -0
  428. package/src/server/adapter-resolve.ts +21 -1
  429. package/src/server/admitted-http-turn.ts +3 -0
  430. package/src/server/auth-cors.ts +109 -8
  431. package/src/server/bare-upstream-error.ts +220 -0
  432. package/src/server/catalog-download.ts +3 -5
  433. package/src/server/chat-native.ts +25 -7
  434. package/src/server/claude-messages.ts +8 -5
  435. package/src/server/codex-model-list.ts +2 -1
  436. package/src/server/configured-credentials.ts +37 -5
  437. package/src/server/gui-desktop-authorization.ts +36 -0
  438. package/src/server/gui-pair-delivery.ts +6 -3
  439. package/src/server/gui-session.ts +10 -1
  440. package/src/server/images.ts +41 -13
  441. package/src/server/inbound-body-admission.ts +17 -4
  442. package/src/server/index/link-listener.ts +203 -11
  443. package/src/server/index/link-management.ts +15 -1
  444. package/src/server/index/link-relay-sessions.ts +128 -8
  445. package/src/server/index/link-websocket-limits.ts +136 -0
  446. package/src/server/index/link-websocket.ts +692 -0
  447. package/src/server/index/optional-listeners.ts +115 -7
  448. package/src/server/index/route-intent-watch.ts +47 -0
  449. package/src/server/index/serve-contract.ts +86 -0
  450. package/src/server/index/serve-options.ts +35 -86
  451. package/src/server/index/startup-warnings.ts +8 -2
  452. package/src/server/index/websocket-handler.ts +26 -4
  453. package/src/server/index.ts +12 -2
  454. package/src/server/inference/client-encoder-delivery.ts +2 -0
  455. package/src/server/inspection-tee.ts +39 -2
  456. package/src/server/lifecycle.ts +2 -0
  457. package/src/server/link-turn.ts +137 -0
  458. package/src/server/management/advisor-routes.ts +10 -2
  459. package/src/server/management/agent-settings-routes.ts +50 -16
  460. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  461. package/src/server/management/config-routes.ts +7 -1
  462. package/src/server/management/context.ts +9 -2
  463. package/src/server/management/desktop-authorization.ts +41 -0
  464. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  465. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  466. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  467. package/src/server/management/home-integration-decision.ts +89 -0
  468. package/src/server/management/integration-routes.ts +208 -81
  469. package/src/server/management/link-child-ops-routes.ts +218 -0
  470. package/src/server/management/link-child-preflight.ts +31 -0
  471. package/src/server/management/link-diagnostics-route.ts +29 -0
  472. package/src/server/management/link-enrollment.ts +199 -47
  473. package/src/server/management/link-operation.ts +609 -0
  474. package/src/server/management/link-recover-route.ts +103 -0
  475. package/src/server/management/link-route-edit.ts +173 -0
  476. package/src/server/management/link-route-request.ts +62 -0
  477. package/src/server/management/link-route-state.ts +92 -6
  478. package/src/server/management/link-routes.ts +563 -51
  479. package/src/server/management/link-traffic-status.ts +13 -0
  480. package/src/server/management/model-routes.ts +122 -36
  481. package/src/server/management/model-rows.ts +2 -1
  482. package/src/server/management/native-integration-routes.ts +176 -70
  483. package/src/server/management/oauth-account-routes.ts +69 -17
  484. package/src/server/management/protocol-routes.ts +7 -0
  485. package/src/server/management/provider-completion-test.ts +4 -4
  486. package/src/server/management/provider-overwrite-carry.ts +39 -3
  487. package/src/server/management/provider-routes.ts +80 -72
  488. package/src/server/management/provider-routing-quota.ts +45 -0
  489. package/src/server/management/route-registry.ts +25 -3
  490. package/src/server/management/route-to-routes.ts +257 -0
  491. package/src/server/management/system-restart.ts +4 -2
  492. package/src/server/management/usage-aggregate-cache.ts +101 -66
  493. package/src/server/management-api.ts +17 -3
  494. package/src/server/management-auth.ts +13 -1
  495. package/src/server/messages-native-preflight.ts +27 -4
  496. package/src/server/messages-native.ts +22 -5
  497. package/src/server/persistent-gui-session.ts +6 -3
  498. package/src/server/proxy-liveness.ts +33 -6
  499. package/src/server/relay-eager.ts +36 -12
  500. package/src/server/relay.ts +183 -116
  501. package/src/server/request-body-facts.ts +48 -0
  502. package/src/server/request-decompress.ts +65 -2
  503. package/src/server/request-log-account-rotation.ts +6 -0
  504. package/src/server/request-log-attempt-usage.ts +69 -0
  505. package/src/server/request-log-cache-affinity.ts +60 -0
  506. package/src/server/request-log-conversation.ts +45 -2
  507. package/src/server/request-log-failure-detail.ts +59 -1
  508. package/src/server/request-log-terminal-status.ts +210 -24
  509. package/src/server/request-log.ts +71 -79
  510. package/src/server/responses/adapter-continuation.ts +2 -1
  511. package/src/server/responses/adapter-delivery.ts +2 -0
  512. package/src/server/responses/adapter-dispatch.ts +40 -51
  513. package/src/server/responses/advisor-plan-slot.ts +33 -1
  514. package/src/server/responses/advisor-question.ts +21 -0
  515. package/src/server/responses/advisor-slot.ts +10 -3
  516. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  517. package/src/server/responses/buffered-sse-json.ts +9 -3
  518. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  519. package/src/server/responses/codex-tool-catalog.ts +156 -0
  520. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  521. package/src/server/responses/combo-stream-preflight.ts +701 -81
  522. package/src/server/responses/compact.ts +47 -12
  523. package/src/server/responses/context-overflow.ts +58 -2
  524. package/src/server/responses/core-codex-account.ts +17 -3
  525. package/src/server/responses/core-combo-failure.ts +37 -4
  526. package/src/server/responses/core-combo-native.ts +3 -1
  527. package/src/server/responses/core-combo.ts +62 -7
  528. package/src/server/responses/core-errors.ts +8 -3
  529. package/src/server/responses/core-lifetime.ts +3 -2
  530. package/src/server/responses/core-normalize.ts +3 -1
  531. package/src/server/responses/core-opaque-recovery.ts +45 -2
  532. package/src/server/responses/core-options.ts +18 -0
  533. package/src/server/responses/core.ts +2 -0
  534. package/src/server/responses/fetch-helpers.ts +15 -10
  535. package/src/server/responses/native-replay-guard.ts +57 -0
  536. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  537. package/src/server/responses/outbound-request-body.ts +29 -0
  538. package/src/server/responses/passthrough-completion.ts +105 -8
  539. package/src/server/responses/passthrough-delivery.ts +31 -11
  540. package/src/server/responses/passthrough-dispatch.ts +99 -106
  541. package/src/server/responses/policy-fallback.ts +13 -1
  542. package/src/server/responses/request-prepare.ts +50 -6
  543. package/src/server/responses/request-transport.ts +53 -17
  544. package/src/server/responses/reset-replay.ts +104 -4
  545. package/src/server/responses/run-turn-execution.ts +58 -30
  546. package/src/server/responses/sidecar-execution.ts +14 -0
  547. package/src/server/responses/terminal-error-redaction.ts +222 -25
  548. package/src/server/responses/ws-upstream.ts +2 -2
  549. package/src/server/sse-payload-rewrite.ts +3 -2
  550. package/src/server/stop-service-route.ts +85 -0
  551. package/src/server/system-env-shell.ts +12 -1
  552. package/src/server/system-env.ts +5 -3
  553. package/src/server/windows-tcp-drop.ts +21 -4
  554. package/src/server/workflow-refusal.ts +8 -0
  555. package/src/server/ws-bridge.ts +191 -12
  556. package/src/service/cli-windows-stop.ts +189 -0
  557. package/src/service/cli.ts +41 -12
  558. package/src/service/disconnected-client-restart.ts +60 -0
  559. package/src/service/guarded-manager-target.ts +18 -1
  560. package/src/service/health.ts +99 -6
  561. package/src/service/launchd.ts +84 -31
  562. package/src/service/orchestration.ts +418 -91
  563. package/src/service/repair.ts +223 -6
  564. package/src/service/restart-proxy-stop.ts +79 -0
  565. package/src/service/service-child-ownership.ts +6 -2
  566. package/src/service/windows-checked-stop-live.ts +467 -0
  567. package/src/service/windows-checked-stop.ts +435 -0
  568. package/src/service/windows-command-line-token.ts +23 -0
  569. package/src/service/windows-guarded-manager.ts +77 -34
  570. package/src/service/windows-ops.ts +38 -56
  571. package/src/service/windows-process-evidence.ts +292 -0
  572. package/src/service/windows-process-native.ts +262 -0
  573. package/src/service/windows-service-stop.ts +321 -0
  574. package/src/service/windows-stop-binding.ts +187 -0
  575. package/src/service/windows-stop-budget.ts +123 -0
  576. package/src/service/windows-stop-confirm.ts +158 -0
  577. package/src/service/windows-stop-deadline.ts +56 -0
  578. package/src/service.ts +2 -2
  579. package/src/types/claude-tool-loading.ts +48 -0
  580. package/src/types/config.ts +47 -53
  581. package/src/types/link.ts +20 -0
  582. package/src/types/multi-agent.ts +13 -0
  583. package/src/types/provider.ts +68 -2
  584. package/src/types/request.ts +4 -0
  585. package/src/types.ts +4 -0
  586. package/src/update/guarded-runtime-ops.ts +5 -7
  587. package/src/update/index.ts +25 -10
  588. package/src/update/install-detection.mjs +3 -1
  589. package/src/update/job-pinned-start.ts +2 -0
  590. package/src/update/job-windows-restart.ts +19 -32
  591. package/src/update/job.ts +12 -5
  592. package/src/update/npm-install.d.mts +11 -0
  593. package/src/update/npm-install.mjs +44 -7
  594. package/src/update/orchestrated-entry.ts +1 -1
  595. package/src/update/orchestrated-node-driver.mjs +3 -2
  596. package/src/update/orchestrated-pnpm.d.mts +4 -0
  597. package/src/update/orchestrated-pnpm.mjs +50 -6
  598. package/src/update/orchestrated-session.d.mts +3 -1
  599. package/src/update/orchestrated-session.mjs +21 -6
  600. package/src/update/pnpm-global-install.d.mts +21 -3
  601. package/src/update/pnpm-global-install.mjs +322 -19
  602. package/src/update/pnpm-store-layout.mjs +46 -0
  603. package/src/update/sync-update-mutex.d.mts +3 -2
  604. package/src/update/sync-update-mutex.mjs +57 -8
  605. package/src/update/transactional-install.d.mts +3 -1
  606. package/src/update/transactional-install.mjs +545 -12
  607. package/src/update/windows-installer-marker.d.mts +1 -0
  608. package/src/update/windows-installer-marker.mjs +44 -0
  609. package/src/usage/expected-prices.ts +8 -0
  610. package/src/usage/filter-index.ts +326 -77
  611. package/src/usage/ledger-scanner.ts +15 -0
  612. package/src/usage/link-log-fields.ts +48 -0
  613. package/src/usage/log.ts +43 -2
  614. package/src/usage/request-body.ts +37 -0
  615. package/src/web-search/loop.ts +3 -0
  616. package/src/web-search/parse.ts +21 -2
  617. package/gui/dist/assets/App-g3Cm2xhZ.js +0 -59
  618. package/gui/dist/assets/Tray-BMDkAiXy.js +0 -1
  619. package/gui/dist/assets/index-Bziu8gTy.css +0 -2
  620. package/gui/dist/assets/index-OYzhQUNP.js +0 -94
  621. package/gui/dist/classic/assets/App-CgPBKUP-.js +0 -58
  622. package/gui/dist/classic/assets/index-BR-HhNrp.js +0 -94
  623. package/gui/dist/classic/assets/quota-summary-CXKhvSmQ.js +0 -1
  624. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -1,10 +1,14 @@
1
1
  import { parseResetCooldownMs } from "../codex/routing";
2
- import { classifyError, isCyberPolicyCode } from "../lib/errors";
2
+ import { CYBER_POLICY_FALLBACK_MESSAGE, TERMINAL_REFUSAL_FALLBACK_MESSAGE, classifyError, isCyberPolicyCode, isCyberPolicyMessage, isRateLimitOrQuotaFailureMessage, isSubscriptionGateMessage, isTerminalRefusalCode, safetyRefusalCodeFromMessage } from "../lib/errors";
3
+ import { isHardPolicyOrOriginRefusal } from "../lib/hard-refusal";
3
4
  import { isNonReplayableUpstreamCode } from "../lib/upstream-retry";
4
5
  import { isAnthropicBillingFailure } from "../providers/anthropic-billing-refusal";
6
+ import { hasConflictingReasoningEffortCode } from "../providers/reasoning-metadata";
5
7
  import { isKiroAccountProfileRefusal } from "../adapters/kiro-refusal";
6
8
  import type { OcxComboTarget } from "../types";
7
9
  import { targetKey } from "./types";
10
+ import { PersistedCooldownMap } from "./cooldown-store";
11
+ import { registerOptionalShutdownHook } from "../lib/optional-shutdown-hooks";
8
12
  import { isDefiniteContextOverflow } from "../lib/context-overflow-verdict";
9
13
 
10
14
  // The verdict lives in a dependency-free leaf so the presentation classifier can share it.
@@ -48,9 +52,11 @@ const HTTP_MONTH_INDEX: Record<string, number> = {
48
52
  };
49
53
 
50
54
  /** Map<`${comboId}\0${provider/model}`, TargetCooldown> */
51
- const targetCooldowns = new Map<string, TargetCooldown>();
52
55
  // Never reset: an in-flight reservation may still refer to an entry cleared from the map.
53
56
  let nextCooldownRevision = 0;
57
+ // Disk-backed (combo-cooldowns.json): a restart keeps every live, reset-aware cooldown.
58
+ const targetCooldowns = new PersistedCooldownMap<TargetCooldown>(() => ++nextCooldownRevision);
59
+ registerOptionalShutdownHook("combo-target-cooldowns", () => targetCooldowns.flushForShutdown());
54
60
  let lastReconciledGeneration = 0;
55
61
  let liveComboTargets = new Set<string>();
56
62
 
@@ -164,7 +170,7 @@ export function isComboTargetInCooldown(
164
170
  const entry = targetCooldowns.get(key);
165
171
  if (!entry) return false;
166
172
  if (entry.cooldownUntil <= now) {
167
- targetCooldowns.delete(key);
173
+ targetCooldowns.dropLocal(key);
168
174
  return false;
169
175
  }
170
176
  return true;
@@ -180,7 +186,7 @@ export function comboTargetCooldownExpiry(
180
186
  const entry = targetCooldowns.get(key);
181
187
  if (!entry) return undefined;
182
188
  if (entry.cooldownUntil <= now) {
183
- targetCooldowns.delete(key);
189
+ targetCooldowns.dropLocal(key);
184
190
  return undefined;
185
191
  }
186
192
  return entry.cooldownUntil;
@@ -203,7 +209,7 @@ export function clearComboTargetCooldownIfUnchanged(
203
209
  expectedRevision: number,
204
210
  ): void {
205
211
  const key = cooldownMapKey(comboId, target);
206
- if (targetCooldowns.get(key)?.revision === expectedRevision) targetCooldowns.delete(key);
212
+ if (targetCooldowns.get(key)?.revision === expectedRevision) targetCooldowns.dropLocal(key);
207
213
  }
208
214
 
209
215
  export function isTransientRequestRateLimit(input: {
@@ -233,7 +239,7 @@ export function remainingComboCooldownMs(comboId: string, now = Date.now()): num
233
239
  if (!key.startsWith(prefix)) continue;
234
240
  const remaining = cooldown.cooldownUntil - now;
235
241
  if (remaining <= 0) {
236
- targetCooldowns.delete(key);
242
+ targetCooldowns.dropLocal(key);
237
243
  continue;
238
244
  }
239
245
  if (soonest === undefined || remaining < soonest) soonest = remaining;
@@ -351,7 +357,7 @@ export function sweepExpiredComboTargetCooldowns(now = Date.now()): number {
351
357
  let removed = 0;
352
358
  for (const [key, cooldown] of targetCooldowns) {
353
359
  if (cooldown.cooldownUntil > now) continue;
354
- targetCooldowns.delete(key);
360
+ targetCooldowns.dropLocal(key);
355
361
  removed += 1;
356
362
  }
357
363
  return removed;
@@ -360,28 +366,352 @@ export function sweepExpiredComboTargetCooldowns(now = Date.now()): number {
360
366
  /** Clear all cooldowns, one combo, or only the supplied target keys within that combo. */
361
367
  export function clearComboTargetCooldowns(comboId?: string, targetKeys?: Iterable<string>): void {
362
368
  if (comboId === undefined) {
363
- targetCooldowns.clear();
369
+ targetCooldowns.clearAllPersisted();
364
370
  liveComboTargets.clear();
365
371
  lastReconciledGeneration = 0;
366
372
  return;
367
373
  }
368
374
  const prefix = `${comboId}\0`;
369
375
  if (targetKeys !== undefined) {
370
- for (const key of targetKeys) targetCooldowns.delete(`${prefix}${key}`);
376
+ targetCooldowns.clearPersisted([...targetKeys].map(key => `${prefix}${key}`));
371
377
  return;
372
378
  }
373
- for (const key of targetCooldowns.keys()) {
374
- if (key.startsWith(prefix)) targetCooldowns.delete(key);
375
- }
379
+ targetCooldowns.clearPrefixPersisted(prefix);
376
380
  }
377
381
 
378
382
  export type ComboFailureDecision = "hop" | "stop";
379
383
  export type ComboFailureCooldownScope = "none" | "target" | "provider";
380
384
 
381
- function normalizedFailureCode(code?: string | null): string {
385
+ function normalizedFailureCode(code?: string | number | null): string {
386
+ if (typeof code === "number") return Number.isFinite(code) ? String(code) : "";
382
387
  return code?.trim().toLowerCase().replaceAll("-", "_") ?? "";
383
388
  }
384
389
 
390
+ /** Parse one bounded error body or single SSE data frame into its root record. */
391
+ function parseErrorEnvelope(message: string): Record<string, unknown> | undefined {
392
+ if (message.length > 16_384) return undefined;
393
+ let text = message.trim();
394
+ const proxyPrefix = /^Provider error \d{3}: /.exec(text);
395
+ if (proxyPrefix) text = text.slice(proxyPrefix[0].length).trim();
396
+ if (text.startsWith("data:") && !text.includes("\n")) text = text.slice("data:".length).trim();
397
+ try {
398
+ const payload: unknown = JSON.parse(text);
399
+ if (!payload || typeof payload !== "object" || Array.isArray(payload)) return undefined;
400
+ return payload as Record<string, unknown>;
401
+ } catch {
402
+ return undefined;
403
+ }
404
+ }
405
+
406
+ /**
407
+ * The one error record an envelope carries: its own `error`, else the root when that root states
408
+ * the failure itself. HTTP consumption and the SSE preflight both select through here so the two
409
+ * transports cannot disagree about which record speaks.
410
+ *
411
+ * A `response.error` alone is deliberately not a carrier here. Under a bare frame it is not an
412
+ * error event at all, so reading it on HTTP only made the same envelope hop on one transport and
413
+ * stop on the other; leaving it unread is the behavior both transports had.
414
+ */
415
+ export function envelopeErrorRecord(root: Record<string, unknown>): Record<string, unknown> | undefined {
416
+ const error = root.error;
417
+ if (error !== null && typeof error === "object" && !Array.isArray(error)) {
418
+ const record = { ...(error as Record<string, unknown>) };
419
+ if (typeof record.detail !== "string" && typeof root.detail === "string") {
420
+ record.detail = root.detail;
421
+ }
422
+ return record;
423
+ }
424
+ if (typeof root.message === "string" || typeof root.detail === "string") {
425
+ return root;
426
+ }
427
+ return undefined;
428
+ }
429
+
430
+ /** Parse one bounded error record from an HTTP 400 body or a single SSE data frame. */
431
+ export function http400ErrorRecord(message: string): Record<string, unknown> | undefined {
432
+ const root = parseErrorEnvelope(message);
433
+ return root ? envelopeErrorRecord(root) : undefined;
434
+ }
435
+
436
+ /** A record's own structured code as a string; blank, absent and non-finite values state none. */
437
+ export function envelopeRecordCode(record: Record<string, unknown> | undefined): string | undefined {
438
+ if (!record) return undefined;
439
+ const code = record.code;
440
+ if (typeof code === "number") {
441
+ return Number.isFinite(code) ? String(code) : undefined;
442
+ }
443
+ return typeof code === "string" && code.trim() !== "" ? code : undefined;
444
+ }
445
+
446
+ /**
447
+ * The envelope root's own structured code, when it states one beside a nested record.
448
+ *
449
+ * The nested record is what normalization selects for display and classification, so this is
450
+ * the only place a root verdict survives. Numeric codes are stringified the way the decision
451
+ * normalizes them. An absent, empty or whitespace-only code is no verdict at all.
452
+ */
453
+ export function upstreamEnvelopeRootCode(message: string): string | undefined {
454
+ return envelopeRecordCode(parseErrorEnvelope(message));
455
+ }
456
+
457
+ /** Check whether a parsed error record or raw diagnostic text represents a malformed response_format. */
458
+ export function isMalformedResponseFormatRecord(record?: Record<string, unknown>, rawText?: string): boolean {
459
+ const fields = record
460
+ ? [record.message, record.detail].filter((value): value is string => typeof value === "string")
461
+ : [];
462
+ if (rawText) fields.push(rawText);
463
+ return fields.some(detail =>
464
+ /\binvalid schema(?: for)? response_format\b/i.test(detail)
465
+ || /\bresponse_format(?:\.[a-z_]+)*\s+must be (?:one of|valid|a valid)\b/i.test(detail));
466
+ }
467
+
468
+ /** Identify known malformed structured-output diagnostics that must remain terminal. */
469
+ export function isMalformedResponseFormatRequest(status: number, message: string): boolean {
470
+ if (status !== 400) return false;
471
+ return isMalformedResponseFormatRecord(http400ErrorRecord(message), message);
472
+ }
473
+
474
+ /** Check whether a parsed error record matches OpenRouter's uncoded numeric-400 opaque wrapper. */
475
+ export function isOpenRouterOpaque400Record(record?: Record<string, unknown>): boolean {
476
+ if (!record) return false;
477
+ const metadata = record.metadata;
478
+ const errorType = record.type === "error" ? undefined : record.type;
479
+ return record.message === "Provider returned error"
480
+ && (record.code === 400 || record.code === "400")
481
+ && errorType === undefined
482
+ && metadata !== null && typeof metadata === "object" && !Array.isArray(metadata)
483
+ && (metadata as Record<string, unknown>).raw === "ERROR";
484
+ }
485
+
486
+ /** Recognize OpenRouter's uncoded numeric-400 wrapper for an opaque provider failure. */
487
+ export function isOpenRouterOpaque400Envelope(message: string): boolean {
488
+ const root = parseErrorEnvelope(message);
489
+ return !!root && isOpenRouterOpaque400EnvelopeRoot(root);
490
+ }
491
+
492
+ /**
493
+ * The same verdict for an already parsed envelope root, which is what the SSE preflight holds.
494
+ * Both transports entering here is what keeps their answers equal.
495
+ */
496
+ export function isOpenRouterOpaque400EnvelopeRoot(root: Record<string, unknown>): boolean {
497
+ return isOpenRouterOpaque400Record(envelopeErrorRecord(root)) && !envelopeRootStatesVerdict(root);
498
+ }
499
+
500
+ /**
501
+ * Root codes that state a request verdict of their own, so the record beside them does not
502
+ * speak for the envelope.
503
+ *
504
+ * Membership is a correctness question, not a formatting one: an equality test against `"400"`
505
+ * made every other root code -- including a blank one and the codes that are ordinary combo hop
506
+ * signals -- suppress the opaque verdict, so HTTP stopped on failures SSE advanced past. Each
507
+ * entry here is a code `comboFailureDecision` reaches its terminal arms with when read alone.
508
+ * Content refusals are the shared {@link isTerminalRefusalCode} set; the post-send codes are the
509
+ * ones {@link isNonReplayableUpstreamCode} owns; the rest are the generic request verdicts and the
510
+ * origin's own refusal.
511
+ */
512
+ const ROOT_VERDICT_CODES = new Set([
513
+ "origin_rejected",
514
+ "content_policy_violation",
515
+ "context_length_exceeded",
516
+ "invalid_request_error",
517
+ "client_closed_request",
518
+ "client_cancelled",
519
+ ]);
520
+
521
+ /** A root code that is itself a hard stop or terminal request verdict; blank means "no verdict". */
522
+ function rootCodeStatesVerdict(code: string): boolean {
523
+ const normalized = normalizedFailureCode(code);
524
+ return ROOT_VERDICT_CODES.has(normalized)
525
+ || isTerminalRefusalCode(normalized)
526
+ || isNonReplayableUpstreamCode(normalized);
527
+ }
528
+
529
+ /**
530
+ * Does the envelope root name its own verdict? A non-`"error"` type and any terminal root code do;
531
+ * a blank, absent, numeric-`400` or hop-signal code does not, so the nested record keeps speaking.
532
+ */
533
+ function envelopeRootStatesVerdict(root: Record<string, unknown>): boolean {
534
+ const { type } = root;
535
+ if (type !== undefined && type !== null && type !== "error") return true;
536
+ const code = envelopeRecordCode(root);
537
+ return code !== undefined && rootCodeStatesVerdict(code);
538
+ }
539
+
540
+ /** Check whether an uncoded numeric 400 is an opaque OpenRouter failure that may safely advance without cooling. */
541
+ function isUncodedUpstream400(
542
+ status: number,
543
+ message: string,
544
+ code?: string | number | null,
545
+ options?: {
546
+ malformedResponseFormat?: boolean;
547
+ openRouterOpaque400?: boolean;
548
+ },
549
+ ): boolean {
550
+ const normalized = normalizedFailureCode(code);
551
+ if (status !== 400 || (normalized !== "" && normalized !== "400")) return false;
552
+ const malformed = options?.malformedResponseFormat !== undefined
553
+ ? options.malformedResponseFormat
554
+ : isMalformedResponseFormatRequest(status, message);
555
+ if (malformed) return false;
556
+ return options?.openRouterOpaque400 !== undefined
557
+ ? options.openRouterOpaque400
558
+ : isOpenRouterOpaque400Envelope(message);
559
+ }
560
+
561
+ /**
562
+ * xAI can reject a model/account effort rung with this exact vendor envelope. It is target-local
563
+ * evidence for a combo: the same model may accept a lower rung, or a later target may accept the
564
+ * request. Keep the match exact so unrelated invalid arguments stay terminal.
565
+ */
566
+ const EXACT_EFFORT_COMPATIBLE_CODES = new Set(["", "invalid_request_error", "invalid_argument"]);
567
+ const EXACT_EFFORT_COMPATIBLE_TYPES = new Set(["", "invalid_request_error", "upstream_error"]);
568
+
569
+ function hasIncompatibleDiagnosticCarrier(val: unknown, depth = 0): boolean {
570
+ if (val === undefined || val === null) return false;
571
+ if (depth > 8) return true;
572
+ if (Array.isArray(val)) {
573
+ if (val.length > 32) return true;
574
+ for (const item of val) {
575
+ if (hasIncompatibleDiagnosticCarrier(item, depth + 1)) return true;
576
+ }
577
+ return false;
578
+ }
579
+ if (typeof val === "string") {
580
+ try {
581
+ const parsed = JSON.parse(val);
582
+ if (parsed && typeof parsed === "object") {
583
+ return hasIncompatibleDiagnosticCarrier(parsed, depth + 1);
584
+ }
585
+ return true;
586
+ } catch {
587
+ return true;
588
+ }
589
+ }
590
+ if (typeof val === "object") {
591
+ const rec = val as Record<string, unknown>;
592
+ if (rec.param !== undefined && rec.param !== null) {
593
+ if (typeof rec.param !== "string") return true;
594
+ const param = rec.param.trim().toLowerCase();
595
+ if (param.length > 0 && param !== "reasoning_effort" && param !== "reasoning.effort") return true;
596
+ }
597
+ if (rec.code !== undefined && rec.code !== null) {
598
+ if (typeof rec.code !== "string") return true;
599
+ if (!EXACT_EFFORT_COMPATIBLE_CODES.has(normalizedFailureCode(rec.code))) return true;
600
+ }
601
+ if (rec.type !== undefined && rec.type !== null) {
602
+ if (typeof rec.type !== "string") return true;
603
+ if (!EXACT_EFFORT_COMPATIBLE_TYPES.has(normalizedFailureCode(rec.type))) return true;
604
+ }
605
+ if (rec.error !== undefined && rec.error !== null) {
606
+ if (hasIncompatibleDiagnosticCarrier(rec.error, depth + 1)) return true;
607
+ }
608
+ if (rec.response !== undefined && rec.response !== null) {
609
+ if (hasIncompatibleDiagnosticCarrier(rec.response, depth + 1)) return true;
610
+ }
611
+ if (rec.last_error !== undefined && rec.last_error !== null) {
612
+ if (hasIncompatibleDiagnosticCarrier(rec.last_error, depth + 1)) return true;
613
+ }
614
+ if (rec.details !== undefined && rec.details !== null) {
615
+ if (hasIncompatibleDiagnosticCarrier(rec.details, depth + 1)) return true;
616
+ }
617
+ if (rec.detail !== undefined && rec.detail !== null) {
618
+ if (hasIncompatibleDiagnosticCarrier(rec.detail, depth + 1)) return true;
619
+ }
620
+ if (rec.errors !== undefined && rec.errors !== null) {
621
+ if (hasIncompatibleDiagnosticCarrier(rec.errors, depth + 1)) return true;
622
+ }
623
+ if (rec.message !== undefined && rec.message !== null) {
624
+ if (typeof rec.message !== "string" || rec.message !== "Invalid reasoning effort.") return true;
625
+ }
626
+ return false;
627
+ }
628
+ return false;
629
+ }
630
+
631
+ function isExactInvalidReasoningEffortRefusal(status: number, message: string, code?: string | null): boolean {
632
+ if (status !== 400 || message.length > 16_384) return false;
633
+ if (code !== undefined && code !== null && typeof code !== "string") return false;
634
+ const outerCode = normalizedFailureCode(code);
635
+ if (!EXACT_EFFORT_COMPATIBLE_CODES.has(outerCode)) return false;
636
+ if (isHardPolicyOrOriginRefusal(message) || hasConflictingReasoningEffortCode(message)) return false;
637
+ let text = message.trim();
638
+ for (let depth = 0; depth < 3; depth += 1) {
639
+ if (text.startsWith("Provider error 400: ")) text = text.slice("Provider error 400: ".length).trim();
640
+ if (text.startsWith("data:") && !text.includes("\n")) text = text.slice("data:".length).trim();
641
+ let payload: unknown;
642
+ try { payload = JSON.parse(text); } catch { return false; };
643
+ if (!payload || typeof payload !== "object" || Array.isArray(payload)) return false;
644
+ const root = payload as Record<string, unknown>;
645
+ if (root.code !== undefined && root.code !== null && typeof root.code !== "string") return false;
646
+ if (root.type !== undefined && root.type !== null && typeof root.type !== "string") return false;
647
+ if (root.message !== undefined && root.message !== null && typeof root.message !== "string") return false;
648
+ if (root.param !== undefined && root.param !== null) {
649
+ if (typeof root.param !== "string") return false;
650
+ const param = root.param.trim().toLowerCase();
651
+ if (param !== "reasoning_effort" && param !== "reasoning.effort") return false;
652
+ }
653
+ const rootCode = normalizedFailureCode(root.code as string | undefined);
654
+ const rootType = normalizedFailureCode(root.type as string | undefined);
655
+ if (!EXACT_EFFORT_COMPATIBLE_CODES.has(rootCode)) return false;
656
+ if (!EXACT_EFFORT_COMPATIBLE_TYPES.has(rootType)) return false;
657
+ if (root.response !== undefined && root.response !== null) return false;
658
+ if (root.last_error !== undefined && root.last_error !== null) return false;
659
+ if (hasIncompatibleDiagnosticCarrier(root.details)) return false;
660
+ if (hasIncompatibleDiagnosticCarrier(root.detail)) return false;
661
+ if (hasIncompatibleDiagnosticCarrier(root.errors)) return false;
662
+ if (rootCode === "invalid_argument"
663
+ && root.error === "Invalid reasoning effort."
664
+ && (root.type === undefined || root.type === "invalid_request_error")
665
+ && (root.param === undefined || root.param === "reasoning_effort" || root.param === "reasoning.effort")) {
666
+ if (root.message !== undefined && root.message !== null && root.message !== "Invalid reasoning effort.") return false;
667
+ return true;
668
+ }
669
+ const error = root.error;
670
+ if (!error || typeof error !== "object" || Array.isArray(error)) return false;
671
+ const record = error as Record<string, unknown>;
672
+ if (record.code !== undefined && record.code !== null && typeof record.code !== "string") return false;
673
+ if (record.type !== undefined && record.type !== null && typeof record.type !== "string") return false;
674
+ if (record.message !== undefined && record.message !== null && typeof record.message !== "string") return false;
675
+ if (record.error !== undefined && record.error !== null && typeof record.error !== "string") return false;
676
+ if (record.param !== undefined && record.param !== null) {
677
+ if (typeof record.param !== "string") return false;
678
+ const param = record.param.trim().toLowerCase();
679
+ if (param !== "reasoning_effort" && param !== "reasoning.effort") return false;
680
+ }
681
+ if (root.param !== undefined && root.param !== null && record.param !== undefined && record.param !== null) {
682
+ if (root.param.trim().toLowerCase() !== record.param.trim().toLowerCase()) return false;
683
+ }
684
+ const errorCode = normalizedFailureCode(record.code as string | undefined);
685
+ const errorType = normalizedFailureCode(record.type as string | undefined);
686
+ if (!EXACT_EFFORT_COMPATIBLE_CODES.has(errorCode)) return false;
687
+ if (!EXACT_EFFORT_COMPATIBLE_TYPES.has(errorType)) return false;
688
+ if (record.response !== undefined && record.response !== null) return false;
689
+ if (record.last_error !== undefined && record.last_error !== null) return false;
690
+ if (hasIncompatibleDiagnosticCarrier(record.details)) return false;
691
+ if (hasIncompatibleDiagnosticCarrier(record.detail)) return false;
692
+ if (hasIncompatibleDiagnosticCarrier(record.errors)) return false;
693
+ if (record.type === "upstream_error" && typeof record.message === "string"
694
+ && record.message.startsWith("Provider error 400: ")
695
+ && EXACT_EFFORT_COMPATIBLE_CODES.has(errorCode)) {
696
+ text = record.message;
697
+ continue;
698
+ }
699
+ if (root.type === "upstream_error" && typeof root.message === "string"
700
+ && root.message.startsWith("Provider error 400: ")
701
+ && EXACT_EFFORT_COMPATIBLE_CODES.has(rootCode)) {
702
+ text = root.message;
703
+ continue;
704
+ }
705
+ if (root.message !== undefined && root.message !== null && root.message !== "Invalid reasoning effort.") return false;
706
+ if (record.error !== undefined && record.error !== null && record.error !== "Invalid reasoning effort.") return false;
707
+ return record.type === "invalid_request_error"
708
+ && record.message === "Invalid reasoning effort."
709
+ && EXACT_EFFORT_COMPATIBLE_CODES.has(errorCode)
710
+ && (record.param === undefined || record.param === "reasoning_effort" || record.param === "reasoning.effort");
711
+ }
712
+ return false;
713
+ }
714
+
385
715
  /**
386
716
  * A spent account window, by structured code or upstream prose. Status is deliberately not
387
717
  * consulted: the ChatGPT Codex backend reports a depleted plan window as HTTP 502
@@ -489,6 +819,9 @@ const REQUEST_SHAPE_FAILURE_CODES = new Set([
489
819
  // A route that cannot read the request's media (image input to a text-only CLI route) is
490
820
  // healthy for every other request, so cooling it would only block unrelated turns.
491
821
  "unsupported_input_modality",
822
+ // A request whose token cap was reached before output was produced is request-specific;
823
+ // the candidate remains healthy for subsequent requests with larger limits.
824
+ "zero_output_token_limit",
492
825
  ]);
493
826
 
494
827
  /** Credential/billing failures that every target sharing the provider inherits. */
@@ -509,6 +842,7 @@ const PROVIDER_SCOPED_FAILURE_CODES = new Set([
509
842
  * Image rejection requires `param: input` and an exact model-scoped prefix.
510
843
  */
511
844
  function isRequestLocalTargetIncompatibility(status: number, message: string, code?: string | null): boolean {
845
+ if (isExactInvalidReasoningEffortRefusal(status, message, code)) return true;
512
846
  if (status !== 400 || message.length > 16_384) return false;
513
847
  const genericCodes = new Set(["", "invalid_request_error", "unsupported_parameter", "unsupported_value"]);
514
848
  if (!genericCodes.has(normalizedFailureCode(code))) return false;
@@ -518,10 +852,20 @@ function isRequestLocalTargetIncompatibility(status: number, message: string, co
518
852
  let payload: unknown;
519
853
  try { payload = JSON.parse(text); } catch { return false; }
520
854
  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return false;
521
- const error = (payload as Record<string, unknown>).error;
855
+ const root = payload as Record<string, unknown>;
856
+ if (root.code !== undefined && root.code !== null && typeof root.code !== "string") return false;
857
+ if (root.type !== undefined && root.type !== null && typeof root.type !== "string") return false;
858
+ if (root.param !== undefined && root.param !== null && typeof root.param !== "string") return false;
859
+ const rootCode = normalizedFailureCode(root.code as string | undefined);
860
+ if (!genericCodes.has(rootCode)) return false;
861
+ if (root.type !== undefined && root.type !== null && root.type !== "invalid_request_error" && root.type !== "upstream_error") return false;
862
+ const error = root.error;
522
863
  if (!error || typeof error !== "object" || Array.isArray(error)) return false;
523
864
  const e = error as Record<string, unknown>;
524
865
  if (e.code !== undefined && e.code !== null && typeof e.code !== "string") return false;
866
+ if (root.param !== undefined && root.param !== null && typeof e.param === "string") {
867
+ if (root.param.trim().toLowerCase() !== e.param.trim().toLowerCase()) return false;
868
+ }
525
869
  const errorCode = normalizedFailureCode(typeof e.code === "string" ? e.code : undefined);
526
870
  if (!genericCodes.has(errorCode) || typeof e.message !== "string") return false;
527
871
  if (e.type !== "invalid_request_error" && e.type !== "upstream_error") return false;
@@ -644,13 +988,339 @@ function isResponseFormatCapabilityRefusal(
644
988
  return false;
645
989
  }
646
990
 
991
+ /** The classification text the combo path bounds a body to (src/server/responses/core-errors.ts). */
992
+ const MODERATION_EVIDENCE_LIMIT = 500;
993
+
994
+ /** The structured codes that state a provider or gateway moderation verdict. */
995
+ const MODERATION_REFUSAL_CODES = new Set(["moderation_refusal", "content_filter"]);
996
+
997
+ /**
998
+ * Every other code or type a moderation refusal body may carry. Anything outside this list, at any
999
+ * depth, is evidence of something else and the body keeps dev's decision: the hop is granted only
1000
+ * to bodies whose structured fields all agree that this is a moderation refusal.
1001
+ */
1002
+ const MODERATION_COMPATIBLE_VALUES = new Set([
1003
+ ...MODERATION_REFUSAL_CODES,
1004
+ "invalid_request_error", "error", "ai_apicallerror", "responsibleaipolicyviolation", "400", "422",
1005
+ ]);
1006
+
1007
+ /** Keys whose values are structured verdicts; folded (lowercase, underscores and hyphens removed). */
1008
+ const MODERATION_VERDICT_KEYS = new Set(["code", "type", "errorcode", "errortype", "reason"]);
1009
+
1010
+ /** Fold a key for comparison: lowercase, underscores and hyphens removed. */
1011
+ function foldKey(key: string): string {
1012
+ return key.toLowerCase().replace(/[_-]/g, "");
1013
+ }
1014
+
1015
+ /** Keys that state an HTTP status; any stated status other than 400/422 is evidence of its own. */
1016
+ const MODERATION_STATUS_KEYS = new Set(["status", "statuscode", "httpstatus", "httpstatuscode"]);
1017
+
1018
+ /** Identifier fields a refusal envelope may carry: a bare token or number, never prose. */
1019
+ const MODERATION_ID_KEYS = new Set(["id", "requestid", "object", "model", "name", "sequencenumber", "createdat"]);
1020
+
1021
+ /**
1022
+ * Keys a gateway's routing metadata (providerMetadata) must not use: a field that names a state,
1023
+ * status, code or safety verdict is evidence of its own, so only plain routing tokens pass.
1024
+ */
1025
+ const ROUTING_METADATA_EVIDENCE_KEY = /safety|violation|block|polic|account|suspend|disabl|deactivat|ban|status|state|error|code|reason|quota|billing|limit|credit|payment/i;
1026
+
1027
+ /**
1028
+ * Azure's per-category filter results: the moderation verdict's own detail. Only its own shape
1029
+ * passes: category objects of flags and numbers, a `severity` of safe/low/medium/high, bare
1030
+ * `id`/`url`/`license` tokens, and compatible codes. Any other text, or a key that names a
1031
+ * state, status, error or message, is evidence of its own.
1032
+ */
1033
+ const MODERATION_RESULT_KEY = /^(?:contentfilterresults?|promptfilterresults)$/;
1034
+ const FILTER_RESULT_EVIDENCE_KEY = /account|status|state|quota|billing|payment|credit|limit|error|message|reason|note|description|detail(?!s$)/i;
1035
+
1036
+ /**
1037
+ * Response-object fields of a Responses terminal event (`response.failed`) that echo the caller's
1038
+ * request or report usage. They say nothing about the failure and are not read.
1039
+ */
1040
+ const RESPONSE_REQUEST_ECHO_KEYS = new Set([
1041
+ "instructions", "tools", "toolchoice", "text", "reasoning", "input", "output", "prompt", "include",
1042
+ "user", "safetyidentifier", "promptcachekey", "promptcacheretention", "previousresponseid", "conversation",
1043
+ "temperature", "topp", "toplogprobs", "maxoutputtokens", "maxtoolcalls", "paralleltoolcalls", "truncation",
1044
+ "store", "servicetier", "background", "usage",
1045
+ ]);
1046
+
1047
+ /**
1048
+ * The whole prose a moderation refusal may carry, after whitespace is collapsed: one verdict
1049
+ * sentence (the gateway's own refusal copy, OpenAI's and Azure's included), optionally followed by
1050
+ * the category list, the advice to change the prompt and retry, and Azure's documentation pointer.
1051
+ * Any other wording (an account, model, parameter or billing problem, in any phrasing) does not
1052
+ * match, so the body keeps dev's decision; only known shapes are admitted.
1053
+ */
1054
+ const MODERATION_REFUSAL_PROSE = new RegExp("^(?:"
1055
+ + "(?:content )?(?:refused|flagged|blocked|rejected|filtered)(?: by (?:the )?(?:moderation|content filter))?\\.?"
1056
+ + "|(?:(?:the|your) )?(?:input|request|prompt|content|message|response|output)(?: (?:was|has been|is))?"
1057
+ + " (?:refused|flagged|blocked|rejected|filtered)(?: by (?:the )?(?:moderation|content filter)(?: system)?)?\\.?"
1058
+ + "|the response was filtered due to the prompt triggering azure openai'?s content management policy\\.?"
1059
+ + "|(?:your )?(?:input|request|prompt|content) violated (?:the )?content (?:safety|management|filtering) polic(?:y|ies)\\.?"
1060
+ + ")(?:"
1061
+ + " categor(?:y|ies): [a-z][a-z/_-]*(?:(?:,? and |, )[a-z][a-z/_-]*)*\\.?"
1062
+ + "| please (?:modify|revise|rephrase|change|adjust|edit) (?:your|the) (?:prompt|input|request|message)(?: and (?:retry|try again))?\\.?"
1063
+ + "| (?:please )?(?:retry|try again)(?: later)?\\.?"
1064
+ + "| to learn more about our content filtering policies please read our documentation: https://[^ ]+"
1065
+ + ")*$", "i");
1066
+
1067
+ /** Whether a prose string is a known moderation refusal copy and nothing else (bounded, linear). */
1068
+ function isModerationRefusalProse(text: string): boolean {
1069
+ if (text.length > 2_000) return false;
1070
+ return MODERATION_REFUSAL_PROSE.test(text.replace(/\s+/g, " ").trim());
1071
+ }
1072
+
1073
+ /**
1074
+ * Safety-system wording in any of its upstream phrasings ("rejected as a result of our safety
1075
+ * system", "for safety reasons", "considered high risk"). A safety refusal is the upstream's own
1076
+ * terminal verdict, broader than the exact copies safetyRefusalCodeFromMessage names.
1077
+ */
1078
+ const SAFETY_SYSTEM_WORDING = /\bsafety[\s_-]+(?:systems?|reasons?)\b|\bhigh[\s_-]+risk\b/i;
1079
+
1080
+ /** Billing, quota and account-state wording: evidence about the provider, not about the prompt. */
1081
+ const PROVIDER_STATE_WORDING =
1082
+ /\bcredit[\s_-]+balance\b|\bquota\b|\bbilling\b|\bpayment[\s_-]+required\b|\binsufficient[\s_-]+(?:quota|balance|funds|credits?)\b|\b(?:account|organi[sz]ation|api[\s_-]*key)\b[^.]{0,40}?\b(?:suspended|disabled|deactivated|banned|inactive|not[\s_-]+active)\b|\brate[\s_-]+limit/i;
1083
+
1084
+ /** A refusal names the prompt or input it refused; any other `param` is a validation error. */
1085
+ function isAllowedModerationParam(param: string): boolean {
1086
+ const p = param.trim().toLowerCase();
1087
+ return p === "prompt" || p === "input" || p === "messages"
1088
+ || p.startsWith("input[") || p.startsWith("input.") || p.startsWith("messages[") || p.startsWith("messages.");
1089
+ }
1090
+
1091
+ /**
1092
+ * Any hard-refusal token in any spelling. A moderation code beside one is not evidence that another
1093
+ * target may serve the request: the client must not retry these.
1094
+ */
1095
+ const HARD_STOP_TOKEN =
1096
+ /(?<![a-z0-9])(?:cyber_policy|origin_rejected|bio_policy|misalignment_policy_violation|invalid_prompt|content_policy_violation|context_length_exceeded|client_closed_request|client_cancelled|upstream_no_response|upstream_closed_before_response|upstream_reset_replay_refused)(?![a-z0-9])/i;
1097
+
1098
+ /** JSON \uXXXX escapes decoded, so an escaped code cannot slip past {@link HARD_STOP_TOKEN}. */
1099
+ function withJsonEscapesDecoded(text: string): string {
1100
+ return text.replace(/\\u([0-9a-fA-F]{4})/g, (_match, hex: string) => String.fromCharCode(Number.parseInt(hex, 16)));
1101
+ }
1102
+
1103
+ /**
1104
+ * Whether any hard-refusal token appears in any spelling: JSON escapes decoded (including \n, \t
1105
+ * and \r), camel humps split, and hyphens, dots, slashes and whitespace folded to underscores.
1106
+ */
1107
+ function namesHardStopToken(text: string): boolean {
1108
+ return HARD_STOP_TOKEN.test(withJsonEscapesDecoded(text)
1109
+ .replace(/\\[ntr]/g, "_")
1110
+ .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
1111
+ .replace(/[-.\s/]+/g, "_"));
1112
+ }
1113
+
1114
+ /** Whether the caller's status and structured code leave room for a moderation hop at all. */
1115
+ function moderationCodeAllowsHop(status: number, normalizedCode: string): boolean {
1116
+ if (status !== 400 && status !== 422) return false;
1117
+ return normalizedCode === "" || MODERATION_COMPATIBLE_VALUES.has(normalizedCode);
1118
+ }
1119
+
1120
+ /**
1121
+ * The moderation hop for one decision. A caller that read the complete bounded body (the combo
1122
+ * failure reader, the stream preflight, the policy path) passes its whole-body verdict; the
1123
+ * structured code of this decision can still veto it. Without one, the message decides.
1124
+ */
1125
+ function providerModerationHop(
1126
+ status: number, message: string, rawCode: string | null | undefined, wholeBody?: boolean, malformedResponseFormat?: boolean,
1127
+ ): boolean {
1128
+ // A malformed response_format diagnostic the reader saw in the whole body stays terminal.
1129
+ if (malformedResponseFormat === true) return false;
1130
+ if (wholeBody === undefined) return isProviderModerationRefusal(status, message, rawCode);
1131
+ return wholeBody && moderationCodeAllowsHop(status, normalizedFailureCode(rawCode));
1132
+ }
1133
+
1134
+ /** Strip this proxy's wrapper prefixes and a single-line SSE data field; undefined unless JSON. */
1135
+ function moderationEnvelope(message: string): unknown {
1136
+ let text = message.trim();
1137
+ for (let depth = 0; depth < 3; depth += 1) {
1138
+ const prefix = ["Provider error 400: ", "Provider error 422: ", "Provider error: ", "Gateway error 400: ", "Gateway error 422: ", "Gateway error: "]
1139
+ .find(candidate => text.startsWith(candidate));
1140
+ if (prefix) text = text.slice(prefix.length).trim();
1141
+ if (text.startsWith("data:") && !text.includes("\n")) text = text.slice("data:".length).trim();
1142
+ }
1143
+ try { return JSON.parse(text); } catch { return undefined; }
1144
+ }
1145
+
1146
+ /**
1147
+ * Walk a refusal envelope (bounded) against the closed shape of a moderation refusal. Returns whether
1148
+ * a moderation code was seen, or null when the body carries anything else: an unknown field, prose
1149
+ * that is not refusal copy, a param outside the prompt or input, a stated status other than 400/422,
1150
+ * an incompatible code, or more nesting than a refusal envelope has. Only known shapes hop; anything
1151
+ * unrecognized keeps dev's decision.
1152
+ */
1153
+ function moderationVerdictFields(payload: unknown): boolean | null {
1154
+ let seen = false;
1155
+ let nodes = 0;
1156
+ const verdict = (field: unknown, key: string, depth: number): boolean => {
1157
+ if (field === null || field === undefined) return true;
1158
+ // A Responses terminal event names itself in its root `type` (`response.failed`): that is the
1159
+ // transport's label for the carrier, not the upstream's verdict.
1160
+ if (depth === 0 && key === "type" && typeof field === "string" && /^response\.[a-z_.]+$/.test(field)) return true;
1161
+ if (typeof field !== "string" && typeof field !== "number") return false;
1162
+ const normalized = normalizedFailureCode(field);
1163
+ if (normalized === "") return typeof field === "string";
1164
+ if (!MODERATION_COMPATIBLE_VALUES.has(normalized)) return false;
1165
+ // Only a code states the provider's moderation verdict. A `type` or an incomplete `reason` of
1166
+ // content_filter may sit beside it, but alone it is a model's own output filter, which stays
1167
+ // terminal (structure/transports/responses.md).
1168
+ if (MODERATION_REFUSAL_CODES.has(normalized) && (foldKey(key) === "code" || foldKey(key) === "errorcode")) seen = true;
1169
+ return true;
1170
+ };
1171
+ const visitFilterResult = (value: unknown, depth: number): boolean => {
1172
+ if (++nodes > 512 || depth > 8) return false;
1173
+ if (value === null || typeof value === "boolean" || typeof value === "number") return true;
1174
+ if (Array.isArray(value)) return value.every(item => visitFilterResult(item, depth + 1));
1175
+ if (typeof value !== "object") return false;
1176
+ return Object.entries(value as Record<string, unknown>).every(([key, field]) => {
1177
+ const folded = foldKey(key);
1178
+ if (MODERATION_VERDICT_KEYS.has(folded)) return verdict(field, key, depth);
1179
+ if (!/^[a-z][a-z0-9_]*$/i.test(key) || FILTER_RESULT_EVIDENCE_KEY.test(key)) return false;
1180
+ if (typeof field === "string") {
1181
+ return folded === "severity" ? /^(?:safe|low|medium|high)$/i.test(field)
1182
+ : (folded === "id" || folded === "url" || folded === "license") && !/\s/.test(field);
1183
+ }
1184
+ return visitFilterResult(field, depth + 1);
1185
+ });
1186
+ };
1187
+ // A gateway's routing metadata: plain tokens, numbers and flags only, under keys that name no state.
1188
+ const visitRoutingMetadata = (value: unknown, depth: number): boolean => {
1189
+ if (++nodes > 512 || depth > 8) return false;
1190
+ if (value === null || typeof value === "number" || typeof value === "boolean") return true;
1191
+ if (typeof value === "string") return !/\s/.test(value);
1192
+ if (Array.isArray(value)) return value.every(item => visitRoutingMetadata(item, depth + 1));
1193
+ if (typeof value !== "object") return false;
1194
+ return Object.entries(value as Record<string, unknown>).every(([key, field]) =>
1195
+ !ROUTING_METADATA_EVIDENCE_KEY.test(key) && visitRoutingMetadata(field, depth + 1));
1196
+ };
1197
+ const visit = (value: unknown, depth: number, responseObject: boolean): boolean => {
1198
+ if (++nodes > 512 || depth > 8) return false;
1199
+ if (!value || typeof value !== "object" || Array.isArray(value)) return false;
1200
+ const record = value as Record<string, unknown>;
1201
+ const responseCarrier = depth === 0 && typeof record.type === "string" && /^response\.[a-z_.]+$/.test(record.type);
1202
+ for (const [key, field] of Object.entries(record)) {
1203
+ const folded = foldKey(key);
1204
+ if (responseObject && RESPONSE_REQUEST_ECHO_KEYS.has(folded)) continue;
1205
+ if (MODERATION_VERDICT_KEYS.has(folded)) {
1206
+ if (!verdict(field, key, depth)) return false;
1207
+ } else if (MODERATION_STATUS_KEYS.has(folded)) {
1208
+ if (field === null) continue;
1209
+ const stated = typeof field === "number" ? field
1210
+ : typeof field === "string" && /^\d{3}$/.test(field.trim()) ? Number(field) : undefined;
1211
+ if (stated !== undefined ? stated !== 400 && stated !== 422
1212
+ : !(typeof field === "string" && /^(?:failed|incomplete|error)$/i.test(field.trim()))) return false;
1213
+ } else if (folded === "message") {
1214
+ if (field !== null && field !== "" && !(typeof field === "string" && isModerationRefusalProse(field))) return false;
1215
+ } else if (folded === "param") {
1216
+ // A param names what the filter inspected: the prompt or input. Any other param is a
1217
+ // validation error.
1218
+ if (field !== null && typeof field === "object" && !Array.isArray(field)) {
1219
+ // An SDK error object in the param slot (an AI gateway's wrapped error) is read as a record.
1220
+ if (!visit(field, depth + 1, false)) return false;
1221
+ } else if (field !== null && field !== "" && !(typeof field === "string" && isAllowedModerationParam(field))) return false;
1222
+ } else if (MODERATION_ID_KEYS.has(folded)) {
1223
+ if (field !== null && typeof field !== "number" && !(typeof field === "string" && !/\s/.test(field))) return false;
1224
+ } else if (folded === "isretryable") {
1225
+ if (field !== null && typeof field !== "boolean") return false;
1226
+ } else if (depth === 0 && folded === "providermetadata") {
1227
+ if (!visitRoutingMetadata(field, depth + 1)) return false;
1228
+ } else if (MODERATION_RESULT_KEY.test(folded)) {
1229
+ if (!visitFilterResult(field, depth + 1)) return false;
1230
+ } else if (folded === "error") {
1231
+ if (field === null) continue;
1232
+ if (typeof field === "string" ? !isModerationRefusalProse(field) : !visit(field, depth + 1, false)) return false;
1233
+ } else if (folded === "innererror" || (responseObject && folded === "incompletedetails")) {
1234
+ if (field !== null && !visit(field, depth + 1, false)) return false;
1235
+ } else if (responseObject && folded === "metadata") {
1236
+ // The caller's own request metadata; a refusal never needs it, so only an empty one passes.
1237
+ if (field !== null && !(typeof field === "object" && !Array.isArray(field) && Object.keys(field).length === 0)) return false;
1238
+ } else if (responseCarrier && key === "response") {
1239
+ if (!visit(field, depth + 1, true)) return false;
1240
+ } else {
1241
+ return false;
1242
+ }
1243
+ }
1244
+ return true;
1245
+ };
1246
+ return visit(payload, 0, false) ? seen : null;
1247
+ }
1248
+
1249
+ /**
1250
+ * A provider or gateway moderation refusal on HTTP 400/422 is target-local in a heterogeneous
1251
+ * combo: this provider's filter refused the prompt, and another target may serve it.
1252
+ *
1253
+ * Granted narrowly, on structured evidence only. The verdict must be a structured
1254
+ * `moderation_refusal` or `content_filter` code (the caller's or one in the body), every other
1255
+ * code or type anywhere in the body must be compatible with it, and no hard-refusal token, safety or
1256
+ * terminal copy, malformed response_format diagnostic, subscription gate, or anything the shared
1257
+ * classifier files more specifically than a generic invalid request may appear. Prose alone never
1258
+ * hops: wording can be echoed back, and a body that carries both prose and another signal is not
1259
+ * evidence that the next target may serve the request.
1260
+ */
1261
+ export function isProviderModerationRefusal(
1262
+ status: number,
1263
+ message: string,
1264
+ code?: string | null,
1265
+ /** True when `message` is the complete bounded body rather than a possibly cut classification text. */
1266
+ complete = false,
1267
+ ): boolean {
1268
+ const normalizedCode = normalizedFailureCode(code);
1269
+ if (!moderationCodeAllowsHop(status, normalizedCode)) return false;
1270
+ const callerStatesModeration = MODERATION_REFUSAL_CODES.has(normalizedCode);
1271
+ if (!message) return callerStatesModeration;
1272
+ // Hop only on evidence seen whole: the combo path classifies at most the first
1273
+ // MODERATION_EVIDENCE_LIMIT characters of a body, and the body readers pass `complete` instead.
1274
+ if (!complete && message.length >= MODERATION_EVIDENCE_LIMIT) return false;
1275
+ // The same bound as the bounded body readers (64 KiB), so no carrier silently loses a refusal.
1276
+ if (message.length > 65_536) return false;
1277
+ const lower = message.toLowerCase();
1278
+ if (namesHardStopToken(message) || isHardPolicyOrOriginRefusal(message)
1279
+ || safetyRefusalCodeFromMessage(message) !== undefined || SAFETY_SYSTEM_WORDING.test(message)
1280
+ || isCyberPolicyMessage(message)
1281
+ || lower.includes(CYBER_POLICY_FALLBACK_MESSAGE.toLowerCase())
1282
+ || lower.includes(TERMINAL_REFUSAL_FALLBACK_MESSAGE.toLowerCase())
1283
+ || isMalformedResponseFormatRequest(status, message)
1284
+ || isSubscriptionGateMessage(lower)
1285
+ // Quota, billing and account-state wording is provider evidence with its own cooldown, even
1286
+ // where the classifier files a 400 carrying it as a generic invalid request.
1287
+ || isRateLimitOrQuotaFailureMessage(message) || isAnthropicBillingFailure(400, message, undefined)
1288
+ || PROVIDER_STATE_WORDING.test(message)
1289
+ // Classified as a 400: classifyError maps an untyped 422 to upstream_error.
1290
+ || classifyError(400, "upstream_error", message).code !== "invalid_request_error") {
1291
+ return false;
1292
+ }
1293
+ const envelope = moderationEnvelope(message);
1294
+ if (envelope === undefined) {
1295
+ // Plain text carries no structured fields; only the caller's code can state the verdict, and a
1296
+ // body that looks like JSON but does not parse (cut or malformed) never hops.
1297
+ return callerStatesModeration && !/^\s*(?:data:\s*)?[[{]/.test(message) && isModerationRefusalProse(message);
1298
+ }
1299
+ // An envelope root that states a verdict code of its own (invalid_request_error, origin,
1300
+ // context length, cancellation...) keeps it, as everywhere else in this file.
1301
+ if (envelope && typeof envelope === "object" && !Array.isArray(envelope)) {
1302
+ const rootCode = (envelope as Record<string, unknown>).code;
1303
+ if (typeof rootCode === "string" && rootCodeStatesVerdict(rootCode)) return false;
1304
+ }
1305
+ const seen = moderationVerdictFields(envelope);
1306
+ return seen !== null && (seen || callerStatesModeration);
1307
+ }
1308
+
1309
+ /** Return the narrowest cooldown scope supported by this target's failure evidence. */
647
1310
  export function comboFailureCooldownScope(
648
1311
  status: number,
649
1312
  message: string,
650
- options?: { code?: string | null },
1313
+ options?: {
1314
+ code?: string | number | null;
1315
+ malformedResponseFormat?: boolean;
1316
+ openRouterOpaque400?: boolean;
1317
+ /** Whole-body moderation verdict from a reader that saw the complete bounded body. */
1318
+ providerModerationRefusal?: boolean;
1319
+ },
651
1320
  ): ComboFailureCooldownScope {
652
- const code = normalizedFailureCode(options?.code);
653
- if (isAnthropicBillingFailure(status, message, options?.code)) return "provider";
1321
+ const rawCode = typeof options?.code === "number" ? String(options.code) : options?.code;
1322
+ const code = normalizedFailureCode(rawCode);
1323
+ if (isAnthropicBillingFailure(status, message, rawCode)) return "provider";
654
1324
  // Request-shape refusals first: an oversized request must not cool a healthy target.
655
1325
  // A native transport can surface a zero-output model overflow as a generic
656
1326
  // upstream_server_error carrying precise context-window prose, so consult the bounded
@@ -658,19 +1328,26 @@ export function comboFailureCooldownScope(
658
1328
  if (
659
1329
  status === 413
660
1330
  || REQUEST_SHAPE_FAILURE_CODES.has(code)
661
- || isRequestLocalFreePromptCap(status, message, options?.code)
662
- || isProviderTargetContextOverflow(status, message, options?.code)
1331
+ || isRequestLocalFreePromptCap(status, message, rawCode)
1332
+ || isProviderTargetContextOverflow(status, message, rawCode)
663
1333
  || isDefiniteContextOverflow(status, message)
664
- || isRequestLocalTargetIncompatibility(status, message, options?.code)
1334
+ || isRequestLocalTargetIncompatibility(status, message, rawCode)
665
1335
  // A capability gap says the target is healthy and the request did not fit it, which is the
666
1336
  // same reason every other entry here refuses to cool a target.
667
- || isResponseFormatCapabilityRefusal(status, message, options?.code)
1337
+ || isResponseFormatCapabilityRefusal(status, message, rawCode)
668
1338
  ) return "none";
669
- if (isProviderScopedQuotaCap(status, message, options?.code)) return "provider";
1339
+ if (isProviderScopedQuotaCap(status, message, rawCode)) return "provider";
670
1340
  // A rejected or unpaid credential is provider-wide evidence: every target that routes
671
1341
  // through the same provider row carries the same key and will fail identically.
672
1342
  if (status === 401 || status === 402 || status === 403) return "provider";
673
1343
  if (PROVIDER_SCOPED_FAILURE_CODES.has(code)) return "provider";
1344
+ // A moderation verdict is target-local, but only after quota and credential evidence had its
1345
+ // say: a refusing key beside moderation prose still cools its provider.
1346
+ if (providerModerationHop(status, message, rawCode, options?.providerModerationRefusal, options?.malformedResponseFormat)) return "none";
1347
+ // OpenRouter's opaque numeric-code wrapper may be target-specific (for example a gateway
1348
+ // rejecting a model's translated payload). It may advance the combo, but says nothing about
1349
+ // target health and must not quarantine the target.
1350
+ if (isUncodedUpstream400(status, message, rawCode, options)) return "none";
674
1351
  return "target";
675
1352
  }
676
1353
 
@@ -783,15 +1460,57 @@ export function codexAccountModelRefusal(
783
1460
  return codexAccountModelRefusalPayload(status, payload);
784
1461
  }
785
1462
 
1463
+ /**
1464
+ * Decide whether a zero-output combo failure can move to another eligible target.
1465
+ *
1466
+ * `rootCode` is the envelope root's own structured code when the record `code` came from is a
1467
+ * nested one. Told about both, this applies the same rule for every transport: each code must
1468
+ * authorize the hop on its own, so a root hard stop is never hidden behind a retryable record
1469
+ * and a retryable pair is not stopped merely because the envelope states them twice.
1470
+ */
786
1471
  export function comboFailureDecision(
787
1472
  status: number,
788
1473
  message: string,
789
1474
  options?: {
790
- code?: string | null;
1475
+ code?: string | number | null;
1476
+ /** The envelope root's own code when it differs from `code`; absent or blank states none. */
1477
+ rootCode?: string | number | null;
791
1478
  codexModelRefusal?: CodexAccountModelRefusal;
792
1479
  failedAdapter?: string;
793
1480
  /** The caller proved the failure is an adapter-normalized plan refusal (`isModelNotInPlanRefusal`). */
794
1481
  verifiedPlanRefusal?: boolean;
1482
+ malformedResponseFormat?: boolean;
1483
+ openRouterOpaque400?: boolean;
1484
+ /** Whole-body moderation verdict from a reader that saw the complete bounded body. */
1485
+ providerModerationRefusal?: boolean;
1486
+ },
1487
+ ): ComboFailureDecision {
1488
+ const rootRawCode = typeof options?.rootCode === "number" ? String(options.rootCode) : options?.rootCode;
1489
+ const nestedRawCode = typeof options?.code === "number" ? String(options.code) : options?.code;
1490
+ const rootCode = normalizedFailureCode(rootRawCode);
1491
+ const nestedCode = normalizedFailureCode(nestedRawCode);
1492
+ if (rootCode !== "" && rootCode !== nestedCode) {
1493
+ if (nestedCode === "") return decideComboFailure(status, message, { ...options, code: rootRawCode });
1494
+ const rootDecision = decideComboFailure(status, message, { ...options, code: rootRawCode });
1495
+ if (rootDecision === "stop") return "stop";
1496
+ return decideComboFailure(status, message, { ...options, code: nestedRawCode }) === "hop"
1497
+ ? "hop" : "stop";
1498
+ }
1499
+ return decideComboFailure(status, message, options);
1500
+ }
1501
+
1502
+ function decideComboFailure(
1503
+ status: number,
1504
+ message: string,
1505
+ options?: {
1506
+ code?: string | number | null;
1507
+ codexModelRefusal?: CodexAccountModelRefusal;
1508
+ failedAdapter?: string;
1509
+ verifiedPlanRefusal?: boolean;
1510
+ malformedResponseFormat?: boolean;
1511
+ openRouterOpaque400?: boolean;
1512
+ /** Whole-body moderation verdict from a reader that saw the complete bounded body. */
1513
+ providerModerationRefusal?: boolean;
795
1514
  },
796
1515
  ): ComboFailureDecision {
797
1516
  if (status === 499) return "stop";
@@ -799,14 +1518,15 @@ export function comboFailureDecision(
799
1518
  // Structured form of the same hard refusal. The prose test above misses it when the origin
800
1519
  // reports the code out of band, and every hop rule below -- including the context-overflow
801
1520
  // one -- must stay subordinate to it.
802
- if (normalizedFailureCode(options?.code) === "origin_rejected") return "stop";
1521
+ const rawCode = typeof options?.code === "number" ? String(options.code) : options?.code;
1522
+ if (normalizedFailureCode(rawCode) === "origin_rejected") return "stop";
803
1523
  // The origin may already be executing this turn (the Codex WebSocket relay sent the create
804
1524
  // frame and never saw a response event). Hopping would send the same request to a second
805
1525
  // target while the first may still be generating; the honest status goes to the client.
806
- if (isNonReplayableUpstreamCode(options?.code)) return "stop";
1526
+ if (isNonReplayableUpstreamCode(rawCode)) return "stop";
807
1527
  // Cyber policy is a hard non-retryable refusal — honor structured code even when
808
1528
  // classificationText was truncated before the JSON code field.
809
- if (isCyberPolicyCode(options?.code)) return "stop";
1529
+ if (isCyberPolicyCode(rawCode)) return "stop";
810
1530
  // HTTP consumers retain hard codes before truncation; SSE metadata owns its selected carrier.
811
1531
  if (options?.codexModelRefusal === undefined && codexAccountModelRefusalHardStopCode(status, message)) return "stop";
812
1532
  const modelRefusal = status === 400
@@ -817,13 +1537,13 @@ export function comboFailureDecision(
817
1537
  // however: another provider/model in the declared combo can still serve the request.
818
1538
  // Require structured lifecycle code or explicit model+lifecycle prose so unrelated
819
1539
  // application-level 410 responses remain fail-closed.
820
- if (isModelLifecycleGone(status, message, options?.code)) return "hop";
1540
+ if (isModelLifecycleGone(status, message, rawCode)) return "hop";
821
1541
  const error = classifyError(status, "upstream_error", message);
822
1542
  if (isCyberPolicyCode(error.code)) return "stop";
823
1543
  // A provider can expose its own target hard cap with a non-semantic vendor code
824
1544
  // (for example 5059 + invalid_request_prompt_too_long). That is evidence that this
825
1545
  // target is too small, not that every later combo target is incapable of serving it.
826
- if (isProviderTargetContextOverflow(status, message, options?.code)) return "hop";
1546
+ if (isProviderTargetContextOverflow(status, message, rawCode)) return "hop";
827
1547
  // A definite context-window refusal is target-local inside a heterogeneous combo: this model
828
1548
  // cannot hold the turn, but a later target may have a larger window. Two boundaries keep this
829
1549
  // safe. It is reached only after cancellation, structured origin/cyber refusals and
@@ -850,16 +1570,16 @@ export function comboFailureDecision(
850
1570
  // an upstream already controls other hop signals (429, 5xx), and traversal is finite: policy
851
1571
  // tries each candidate once via `tried`, and combo excludes each attempted target. So this is
852
1572
  // structured-code-only, not provably local.
853
- if (options?.code === "input_admission_refused" || error.code === "input_admission_refused") {
1573
+ if (rawCode === "input_admission_refused" || error.code === "input_admission_refused") {
854
1574
  return "hop";
855
1575
  }
856
- if (isProviderScopedQuotaCap(status, message, options?.code || error.code)) {
1576
+ if (isProviderScopedQuotaCap(status, message, rawCode || error.code)) {
857
1577
  return "hop";
858
1578
  }
859
1579
  // A model-scoped rejection is target-local: this provider does not serve THIS model, which
860
1580
  // says nothing about the next combo target. Structured code only, plus the explicit prose
861
1581
  // form upstreams emit when they carry no code, so an unrelated 400 stays terminal.
862
- const failureCode = normalizedFailureCode(options?.code || error.code);
1582
+ const failureCode = normalizedFailureCode(rawCode || error.code);
863
1583
  // The input-modality refusal is the same kind of verdict: this route cannot read the turn's
864
1584
  // media, and a later target may. Its 400 would otherwise end the chain as invalid_request_error.
865
1585
  if (["model_not_found", "model_unavailable", "unsupported_model", "unsupported_input_modality"].includes(failureCode)) {
@@ -873,13 +1593,14 @@ export function comboFailureDecision(
873
1593
  // `free_rate_limited` no longer routes through `isProviderScopedQuotaCap` (it is a
874
1594
  // per-request cap, not provider-wide evidence), so keep its hop verdict explicit here.
875
1595
  if (failureCode === "free_rate_limited") return "hop";
876
- if (isRequestLocalTargetIncompatibility(status, message, options?.code)) return "hop";
1596
+ if (isRequestLocalTargetIncompatibility(status, message, rawCode)) return "hop";
877
1597
  // Must precede the generic `invalid_request_error` stop below, which is where this refusal
878
1598
  // ended the chain: the gateway reports `type: "invalid_request_error"`, so the classifier
879
1599
  // reaches that list and returns terminal before anything can ask whether the next target
880
1600
  // could have served the request (#4903).
881
- if (isResponseFormatCapabilityRefusal(status, message, options?.code)) return "hop";
882
- if (isAnthropicBillingFailure(status, message, options?.code)) return "hop";
1601
+ if (isResponseFormatCapabilityRefusal(status, message, rawCode)) return "hop";
1602
+ if (providerModerationHop(status, message, rawCode, options?.providerModerationRefusal, options?.malformedResponseFormat)) return "hop";
1603
+ if (isAnthropicBillingFailure(status, message, rawCode)) return "hop";
883
1604
  // Kiro's body validator rejects the request for the identity it was routed under. The account
884
1605
  // layer rotates logins first; this is the no-alternate case, so the next combo target is the
885
1606
  // only remaining chance to serve the turn. Only a caller that knows the failed target is a Kiro
@@ -889,7 +1610,11 @@ export function comboFailureDecision(
889
1610
  // A structured account-window exhaustion code is provider-state evidence even inside a
890
1611
  // 400 / invalid_request_error envelope, so it must precede that stop. Exhaustion prose alone
891
1612
  // never reaches this arm: a validation error can quote quota wording back (#7625).
892
- if (hasAccountExhaustionCode(options?.code)) return "hop";
1613
+ if (hasAccountExhaustionCode(rawCode)) return "hop";
1614
+ // OpenRouter can wrap an opaque provider failure as a numeric 400 with `metadata.raw: "ERROR"`
1615
+ // and no type. Let a heterogeneous combo try another target in this case, while keeping
1616
+ // malformed response_format diagnostics terminal and preserving any structured code.
1617
+ if (isUncodedUpstream400(status, message, rawCode, options)) return "hop";
893
1618
  if (["origin_rejected", "context_length_exceeded", "invalid_request_error"].includes(error.code ?? "")) {
894
1619
  return "stop";
895
1620
  }