@bitkyc08/opencodex 2.96.0 → 2.98.0-preview.20261107

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 (465) hide show
  1. package/bin/ocx.mjs +215 -20
  2. package/gui/dist/assets/App-6TFtZsUF.css +1 -0
  3. package/gui/dist/assets/App-B8_sOxoz.js +59 -0
  4. package/gui/dist/assets/Tray-DpWEp6ee.js +1 -0
  5. package/gui/dist/assets/WantedSansVariable.split.0-Dwvb1WRx.woff2 +0 -0
  6. package/gui/dist/assets/WantedSansVariable.split.1-1wKD2RxI.woff2 +0 -0
  7. package/gui/dist/assets/WantedSansVariable.split.10-CAKA6LIP.woff2 +0 -0
  8. package/gui/dist/assets/WantedSansVariable.split.11-k5H85R4b.woff2 +0 -0
  9. package/gui/dist/assets/WantedSansVariable.split.12-BHboLsUv.woff2 +0 -0
  10. package/gui/dist/assets/WantedSansVariable.split.13-9GV377ix.woff2 +0 -0
  11. package/gui/dist/assets/WantedSansVariable.split.14-DovDXnrj.woff2 +0 -0
  12. package/gui/dist/assets/WantedSansVariable.split.15-DTdykCig.woff2 +0 -0
  13. package/gui/dist/assets/WantedSansVariable.split.16-CKz2ccgK.woff2 +0 -0
  14. package/gui/dist/assets/WantedSansVariable.split.17-Z2RD_KRZ.woff2 +0 -0
  15. package/gui/dist/assets/WantedSansVariable.split.18-BcKtfonJ.woff2 +0 -0
  16. package/gui/dist/assets/WantedSansVariable.split.19-DEQPOSZn.woff2 +0 -0
  17. package/gui/dist/assets/WantedSansVariable.split.2-DryboyuA.woff2 +0 -0
  18. package/gui/dist/assets/WantedSansVariable.split.20-Bia5JMls.woff2 +0 -0
  19. package/gui/dist/assets/WantedSansVariable.split.21-Cr4jFw-E.woff2 +0 -0
  20. package/gui/dist/assets/WantedSansVariable.split.22-DjjB69TZ.woff2 +0 -0
  21. package/gui/dist/assets/WantedSansVariable.split.23-CvUzJskt.woff2 +0 -0
  22. package/gui/dist/assets/WantedSansVariable.split.24-i_eMg5ox.woff2 +0 -0
  23. package/gui/dist/assets/WantedSansVariable.split.25-2aKHwPX-.woff2 +0 -0
  24. package/gui/dist/assets/WantedSansVariable.split.26-B6wXoCEL.woff2 +0 -0
  25. package/gui/dist/assets/WantedSansVariable.split.27-D4h1WfGM.woff2 +0 -0
  26. package/gui/dist/assets/WantedSansVariable.split.28-kvRPCStd.woff2 +0 -0
  27. package/gui/dist/assets/WantedSansVariable.split.29-DHAiwleD.woff2 +0 -0
  28. package/gui/dist/assets/WantedSansVariable.split.3-7H--eyZi.woff2 +0 -0
  29. package/gui/dist/assets/WantedSansVariable.split.30-C66cfAY2.woff2 +0 -0
  30. package/gui/dist/assets/WantedSansVariable.split.31-FDmtiNim.woff2 +0 -0
  31. package/gui/dist/assets/WantedSansVariable.split.32-DouHt2Dd.woff2 +0 -0
  32. package/gui/dist/assets/WantedSansVariable.split.33-B8HVvkJX.woff2 +0 -0
  33. package/gui/dist/assets/WantedSansVariable.split.34-BtkRu1FN.woff2 +0 -0
  34. package/gui/dist/assets/WantedSansVariable.split.35-DBylQbtk.woff2 +0 -0
  35. package/gui/dist/assets/WantedSansVariable.split.36-Sg089Kgh.woff2 +0 -0
  36. package/gui/dist/assets/WantedSansVariable.split.37-CYtvbriS.woff2 +0 -0
  37. package/gui/dist/assets/WantedSansVariable.split.38-DKkSLf8Z.woff2 +0 -0
  38. package/gui/dist/assets/WantedSansVariable.split.39-CecotKZD.woff2 +0 -0
  39. package/gui/dist/assets/WantedSansVariable.split.4-Bv8O3ZMb.woff2 +0 -0
  40. package/gui/dist/assets/WantedSansVariable.split.40-DdCvkmOU.woff2 +0 -0
  41. package/gui/dist/assets/WantedSansVariable.split.41-ESn674Hc.woff2 +0 -0
  42. package/gui/dist/assets/WantedSansVariable.split.42-DL9V7NNV.woff2 +0 -0
  43. package/gui/dist/assets/WantedSansVariable.split.43-yipO0cyk.woff2 +0 -0
  44. package/gui/dist/assets/WantedSansVariable.split.44-6rTmLZhm.woff2 +0 -0
  45. package/gui/dist/assets/WantedSansVariable.split.45-BJAj8lrm.woff2 +0 -0
  46. package/gui/dist/assets/WantedSansVariable.split.46-BDTzMn2c.woff2 +0 -0
  47. package/gui/dist/assets/WantedSansVariable.split.47-Bxd4wGgi.woff2 +0 -0
  48. package/gui/dist/assets/WantedSansVariable.split.48-DxnFBLnH.woff2 +0 -0
  49. package/gui/dist/assets/WantedSansVariable.split.49-DnVD0aOD.woff2 +0 -0
  50. package/gui/dist/assets/WantedSansVariable.split.5-B1wI2pp5.woff2 +0 -0
  51. package/gui/dist/assets/WantedSansVariable.split.50-D9JlkZd6.woff2 +0 -0
  52. package/gui/dist/assets/WantedSansVariable.split.51-D9Vw6Bu3.woff2 +0 -0
  53. package/gui/dist/assets/WantedSansVariable.split.52-ClEJk4kn.woff2 +0 -0
  54. package/gui/dist/assets/WantedSansVariable.split.53-BSXU0vh-.woff2 +0 -0
  55. package/gui/dist/assets/WantedSansVariable.split.54-EcuxkR9v.woff2 +0 -0
  56. package/gui/dist/assets/WantedSansVariable.split.55-CYiFhQX8.woff2 +0 -0
  57. package/gui/dist/assets/WantedSansVariable.split.56--Gk9g8BK.woff2 +0 -0
  58. package/gui/dist/assets/WantedSansVariable.split.57-DnkOPZcy.woff2 +0 -0
  59. package/gui/dist/assets/WantedSansVariable.split.58-9MB8504z.woff2 +0 -0
  60. package/gui/dist/assets/WantedSansVariable.split.59-ByxIsN72.woff2 +0 -0
  61. package/gui/dist/assets/WantedSansVariable.split.6-Bmk0dRVw.woff2 +0 -0
  62. package/gui/dist/assets/WantedSansVariable.split.60-Bxwx_aWQ.woff2 +0 -0
  63. package/gui/dist/assets/WantedSansVariable.split.61-DA2z5sm7.woff2 +0 -0
  64. package/gui/dist/assets/WantedSansVariable.split.62-C5iJPJZn.woff2 +0 -0
  65. package/gui/dist/assets/WantedSansVariable.split.63-DAqrmaEc.woff2 +0 -0
  66. package/gui/dist/assets/WantedSansVariable.split.64-BgXFsljb.woff2 +0 -0
  67. package/gui/dist/assets/WantedSansVariable.split.65-DKiWujvu.woff2 +0 -0
  68. package/gui/dist/assets/WantedSansVariable.split.66-8po4vUZ4.woff2 +0 -0
  69. package/gui/dist/assets/WantedSansVariable.split.67-Cy5qyI9O.woff2 +0 -0
  70. package/gui/dist/assets/WantedSansVariable.split.68-BKny7Fy3.woff2 +0 -0
  71. package/gui/dist/assets/WantedSansVariable.split.69-B4VU4u_b.woff2 +0 -0
  72. package/gui/dist/assets/WantedSansVariable.split.7-BuqwNpgA.woff2 +0 -0
  73. package/gui/dist/assets/WantedSansVariable.split.70-BCd4n346.woff2 +0 -0
  74. package/gui/dist/assets/WantedSansVariable.split.71-CkQppaWn.woff2 +0 -0
  75. package/gui/dist/assets/WantedSansVariable.split.72-Db7vaoFs.woff2 +0 -0
  76. package/gui/dist/assets/WantedSansVariable.split.73-DI80TYWl.woff2 +0 -0
  77. package/gui/dist/assets/WantedSansVariable.split.74-tMCtDAHB.woff2 +0 -0
  78. package/gui/dist/assets/WantedSansVariable.split.75-Ciw0D5WG.woff2 +0 -0
  79. package/gui/dist/assets/WantedSansVariable.split.76-DoLjFgp-.woff2 +0 -0
  80. package/gui/dist/assets/WantedSansVariable.split.77-CpT2uvMy.woff2 +0 -0
  81. package/gui/dist/assets/WantedSansVariable.split.78-CkcJ4iZ1.woff2 +0 -0
  82. package/gui/dist/assets/WantedSansVariable.split.79-DsOUJjEM.woff2 +0 -0
  83. package/gui/dist/assets/WantedSansVariable.split.8-DsjypPd6.woff2 +0 -0
  84. package/gui/dist/assets/WantedSansVariable.split.80-C0VwHTte.woff2 +0 -0
  85. package/gui/dist/assets/WantedSansVariable.split.81-DTelu57i.woff2 +0 -0
  86. package/gui/dist/assets/WantedSansVariable.split.82-BiMndGN1.woff2 +0 -0
  87. package/gui/dist/assets/WantedSansVariable.split.83-CVcC6eDG.woff2 +0 -0
  88. package/gui/dist/assets/WantedSansVariable.split.84-DlhZVt_O.woff2 +0 -0
  89. package/gui/dist/assets/WantedSansVariable.split.85-S8I2D3pA.woff2 +0 -0
  90. package/gui/dist/assets/WantedSansVariable.split.86-DozXXpH5.woff2 +0 -0
  91. package/gui/dist/assets/WantedSansVariable.split.87-Dsn0Vuuo.woff2 +0 -0
  92. package/gui/dist/assets/WantedSansVariable.split.88-iNwxxDCr.woff2 +0 -0
  93. package/gui/dist/assets/WantedSansVariable.split.89-B63u_9CZ.woff2 +0 -0
  94. package/gui/dist/assets/WantedSansVariable.split.9-Bi3IzpMI.woff2 +0 -0
  95. package/gui/dist/assets/WantedSansVariable.split.90-ByeH1Pqf.woff2 +0 -0
  96. package/gui/dist/assets/WantedSansVariable.split.91-UQLlagpm.woff2 +0 -0
  97. package/gui/dist/assets/brand-mark-VPhzz-WE.js +1 -0
  98. package/gui/dist/assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2 +0 -0
  99. package/gui/dist/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2 +0 -0
  100. package/gui/dist/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2 +0 -0
  101. package/gui/dist/assets/geist-latin-wght-normal-BgDaEnEv.woff2 +0 -0
  102. package/gui/dist/assets/geist-mono-cyrillic-ext-wght-normal-X_5orZeX.woff2 +0 -0
  103. package/gui/dist/assets/geist-mono-cyrillic-wght-normal-DiZS0aHC.woff2 +0 -0
  104. package/gui/dist/assets/geist-mono-latin-ext-wght-normal-Bwz-egvJ.woff2 +0 -0
  105. package/gui/dist/assets/geist-mono-latin-wght-normal-XN7g48iV.woff2 +0 -0
  106. package/gui/dist/assets/geist-mono-symbols2-wght-normal-CO5SzqOn.woff2 +0 -0
  107. package/gui/dist/assets/geist-mono-vietnamese-wght-normal-DadHysG0.woff2 +0 -0
  108. package/gui/dist/assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2 +0 -0
  109. package/gui/dist/assets/index-5REODpG3.css +2 -0
  110. package/gui/dist/assets/index-BWKBeK77.js +94 -0
  111. package/gui/dist/assets/segment-thumb-features-BQYzrze9.js +1 -0
  112. package/gui/dist/classic/assets/App-Bz65x1J6.js +58 -0
  113. package/gui/dist/{assets/Tray-BOPQyDbH.js → classic/assets/Tray-kk7mdO6I.js} +1 -1
  114. package/gui/dist/classic/assets/index-Dp2j8bSc.js +94 -0
  115. package/gui/dist/classic/assets/quota-summary-CvamtHjB.js +1 -0
  116. package/gui/dist/classic/index.html +47 -0
  117. package/gui/dist/favicon.png +0 -0
  118. package/gui/dist/favicon.svg +14 -0
  119. package/gui/dist/index.html +15 -2
  120. package/package.json +1 -1
  121. package/src/adapters/anthropic.ts +17 -8
  122. package/src/adapters/command-code.ts +15 -16
  123. package/src/adapters/cursor/transport-retry.ts +2 -2
  124. package/src/adapters/devin/cloud-direct/chat.ts +15 -6
  125. package/src/adapters/google.ts +7 -7
  126. package/src/adapters/kiro/adapter.ts +18 -3
  127. package/src/adapters/kiro/conversation.ts +8 -8
  128. package/src/adapters/kiro/payload.ts +45 -12
  129. package/src/adapters/kiro/stream.ts +230 -14
  130. package/src/adapters/kiro/structured-output-json.ts +191 -0
  131. package/src/adapters/kiro/structured-output-schema.ts +542 -0
  132. package/src/adapters/kiro/structured-output.ts +367 -0
  133. package/src/adapters/kiro-constants.ts +24 -1
  134. package/src/adapters/kiro-events.ts +31 -1
  135. package/src/adapters/kiro-retry.ts +3 -3
  136. package/src/adapters/kiro-tools.ts +14 -9
  137. package/src/adapters/kiro-wire.ts +9 -5
  138. package/src/adapters/ollama-native.ts +11 -1
  139. package/src/adapters/openai-chat/messages.ts +58 -5
  140. package/src/adapters/openai-chat/mistral-image-limit.ts +50 -0
  141. package/src/adapters/openai-chat/passthrough.ts +5 -3
  142. package/src/adapters/openai-chat/tool-schema.ts +83 -13
  143. package/src/adapters/openai-responses/empty-assistant.ts +15 -3
  144. package/src/adapters/openai-responses/opengateway-input.ts +18 -6
  145. package/src/adapters/openai-responses/passthrough.ts +5 -4
  146. package/src/adapters/openai-responses/reasoning.ts +9 -4
  147. package/src/adapters/openai-responses/request-strips.ts +1 -1
  148. package/src/adapters/openai-responses/tool-output-recovery.ts +79 -0
  149. package/src/adapters/physical-send.ts +3 -3
  150. package/src/adapters/qoder/live-models.ts +115 -1
  151. package/src/adapters/zed-openai-stream.ts +2 -1
  152. package/src/bridge/errors.ts +11 -2
  153. package/src/bridge/response-json.ts +2 -1
  154. package/src/bridge/sse.ts +14 -6
  155. package/src/chat/failure-verdict.ts +21 -0
  156. package/src/chat/outbound.ts +139 -21
  157. package/src/claude/failure-verdict.ts +21 -0
  158. package/src/claude/inbound-content-options.ts +15 -2
  159. package/src/claude/inbound-model-options.ts +2 -1
  160. package/src/claude/inbound-records.ts +2 -0
  161. package/src/claude/inbound.ts +17 -11
  162. package/src/claude/outbound.ts +98 -22
  163. package/src/cli/capabilities-access-remote.ts +13 -0
  164. package/src/cli/capabilities-base.ts +26 -3
  165. package/src/cli/capabilities-command.ts +12 -3
  166. package/src/cli/capabilities-provider-models.ts +3 -3
  167. package/src/cli/capability-contracts.ts +2 -0
  168. package/src/cli/codex-launch-auth.ts +30 -1
  169. package/src/cli/codex-launcher.ts +12 -5
  170. package/src/cli/codex-shim-autorestore.ts +12 -4
  171. package/src/cli/config-command.ts +11 -2
  172. package/src/cli/connect.ts +17 -2
  173. package/src/cli/dispatch.ts +14 -177
  174. package/src/cli/doctor.ts +95 -7
  175. package/src/cli/help.ts +2 -2
  176. package/src/cli/index.ts +17 -8
  177. package/src/cli/link-apply-restart.ts +9 -2
  178. package/src/cli/link.ts +1 -1
  179. package/src/cli/models.ts +124 -38
  180. package/src/cli/registry.ts +12 -4
  181. package/src/cli/restart-failure.ts +17 -0
  182. package/src/cli/root.ts +8 -0
  183. package/src/cli/stop-approval.ts +2 -2
  184. package/src/cli/sync-command.ts +243 -0
  185. package/src/cli/sync-fanout-process.ts +92 -0
  186. package/src/cli/sync-fanout.ts +161 -0
  187. package/src/cli/sync-flags.ts +10 -0
  188. package/src/cli/sync-link-status.ts +39 -0
  189. package/src/cli/sync-update-guard.ts +18 -0
  190. package/src/cli/system-restart-client.ts +5 -0
  191. package/src/cli/uninstall-client-state.ts +12 -1
  192. package/src/cli/update-restart-child.ts +13 -3
  193. package/src/cli/update-restart-home.ts +6 -3
  194. package/src/cli/update-restart.ts +36 -19
  195. package/src/client/connect.ts +35 -15
  196. package/src/client/hub-client.ts +5 -0
  197. package/src/client/link-home.ts +3 -2
  198. package/src/client/link-management-relay.ts +39 -2
  199. package/src/client/link-readiness.ts +3 -1
  200. package/src/client/machine-api.ts +2 -1
  201. package/src/client/machine-listener.ts +10 -0
  202. package/src/client/orphan-token-recovery.ts +322 -0
  203. package/src/client/restore-ownership.ts +19 -1
  204. package/src/client/runtime-restart.ts +12 -4
  205. package/src/client/runtime.ts +40 -11
  206. package/src/client/stop-routing.ts +62 -0
  207. package/src/client/sync-runtime.ts +65 -0
  208. package/src/clients/config-export.ts +32 -3
  209. package/src/codex/auth-context.ts +49 -103
  210. package/src/codex/catalog/antigravity-discovery.ts +16 -5
  211. package/src/codex/catalog/provider-models.ts +18 -12
  212. package/src/codex/forward-transport-headers.ts +35 -6
  213. package/src/codex/inject/config-toml.ts +88 -0
  214. package/src/codex/inject/multi-agent-v2.ts +30 -4
  215. package/src/codex/inject/plan.ts +34 -7
  216. package/src/codex/inject-coordination.ts +11 -0
  217. package/src/codex/inject.ts +18 -7
  218. package/src/codex/lineage.ts +13 -7
  219. package/src/codex/native-profile-api.ts +27 -1
  220. package/src/codex/quota.ts +22 -6
  221. package/src/codex/request-owned-affinity-key.ts +11 -0
  222. package/src/codex/request-owned-affinity.ts +118 -0
  223. package/src/codex/request-owned-main-pin.ts +86 -0
  224. package/src/codex/role-capability.ts +52 -41
  225. package/src/codex/routing/active-account.ts +13 -5
  226. package/src/codex/routing/selection.ts +40 -1
  227. package/src/codex/routing/thread-affinity-store.ts +916 -0
  228. package/src/codex/routing/thread-affinity.ts +90 -12
  229. package/src/codex/shim-diagnostics.ts +7 -0
  230. package/src/codex/shim-legacy-record.ts +290 -0
  231. package/src/codex/shim-windows-refresh.ts +9 -2
  232. package/src/codex/shim-wrapper-write.ts +7 -0
  233. package/src/codex/shim.ts +80 -21
  234. package/src/codex/toml-source-lines.ts +72 -13
  235. package/src/combos/failover.ts +6 -109
  236. package/src/combos/request.ts +2 -2
  237. package/src/combos/resolve.ts +29 -11
  238. package/src/config/diagnostics.ts +9 -9
  239. package/src/config/load-degrade.ts +27 -27
  240. package/src/config/process-state.ts +5 -0
  241. package/src/config/provider-validation.ts +9 -2
  242. package/src/config/removed-opencode-free-backup.ts +6 -3
  243. package/src/config/schema/leaf-validators.ts +1 -0
  244. package/src/config/tracked-runtime-inspection.ts +3 -3
  245. package/src/generated/compatibility-version.json +595 -255
  246. package/src/images/loop.ts +4 -3
  247. package/src/lib/client-error-body.ts +215 -0
  248. package/src/lib/client-retry-after.ts +66 -0
  249. package/src/lib/config-ownership-removal.ts +422 -0
  250. package/src/lib/config-ownership.ts +650 -81
  251. package/src/lib/context-overflow-verdict.ts +113 -0
  252. package/src/lib/crash-guard.ts +4 -2
  253. package/src/lib/desktop-cli-handoff.d.mts +4 -5
  254. package/src/lib/desktop-cli-handoff.mjs +18 -17
  255. package/src/lib/empty-tool-catalog.ts +25 -3
  256. package/src/lib/error-destination.ts +47 -0
  257. package/src/lib/errors.ts +1 -0
  258. package/src/lib/failure-detail.ts +66 -0
  259. package/src/lib/local-management-capability.ts +3 -1
  260. package/src/lib/messages-error-body.ts +162 -0
  261. package/src/lib/messages-sse-error-presentation.ts +93 -0
  262. package/src/lib/model-identity.ts +44 -0
  263. package/src/lib/passive-read.ts +9 -4
  264. package/src/lib/private-sqlite-path.ts +124 -0
  265. package/src/lib/response-service-tier.ts +17 -0
  266. package/src/lib/retry-after.ts +3 -0
  267. package/src/lib/socks5-fetch.ts +21 -9
  268. package/src/lib/spend-ledger-owner.ts +43 -4
  269. package/src/lib/upstream-condition.ts +142 -0
  270. package/src/lib/upstream-retry.ts +95 -12
  271. package/src/lib/windows-owner-acl.ts +22 -9
  272. package/src/lib/winsw.ts +5 -5
  273. package/src/lib/workflow-budget.ts +3 -1
  274. package/src/link/remote-platform.ts +14 -0
  275. package/src/link/remote-windows.ts +51 -9
  276. package/src/link/ssh-argv.ts +63 -10
  277. package/src/oauth/generic-account-failover.ts +13 -11
  278. package/src/oauth/index.ts +42 -73
  279. package/src/oauth/oauth-errors.ts +67 -0
  280. package/src/oauth/store.ts +21 -11
  281. package/src/protocols/codecs/messages-ir.ts +15 -9
  282. package/src/protocols/codecs/ollama.ts +197 -0
  283. package/src/protocols/encoders/adapter-events.ts +30 -7
  284. package/src/protocols/encoders/chat.ts +18 -10
  285. package/src/protocols/encoders/messages.ts +72 -28
  286. package/src/protocols/trace.ts +18 -0
  287. package/src/providers/antigravity-models.ts +45 -12
  288. package/src/providers/fastwire.ts +3 -2
  289. package/src/providers/free-directory.ts +2 -2
  290. package/src/providers/quota/anthropic-usage-windows.ts +13 -3
  291. package/src/providers/quota/vendor-probes-key.ts +60 -24
  292. package/src/providers/reasoning-metadata.ts +2 -1
  293. package/src/providers/registry/entries-extended.ts +9 -0
  294. package/src/providers/request-pacing.ts +3 -2
  295. package/src/reasoning-effort.ts +7 -2
  296. package/src/remote/hub-usage.ts +3 -0
  297. package/src/responses/apply-patch-envelope.ts +45 -19
  298. package/src/responses/compaction-history-framing.ts +5 -1
  299. package/src/responses/freeform-wrapper-scan.ts +5 -3
  300. package/src/responses/progressive-freeform-input.ts +354 -45
  301. package/src/routing/fallback-policy.ts +3 -1
  302. package/src/server/admission-model-scope.ts +17 -6
  303. package/src/server/admitted-http-turn.ts +57 -0
  304. package/src/server/anthropic-rate-limit-headers.ts +75 -3
  305. package/src/server/auth-cors.ts +5 -0
  306. package/src/server/chat-completions.ts +45 -20
  307. package/src/server/chat-native-sse.ts +52 -7
  308. package/src/server/chat-native.ts +60 -35
  309. package/src/server/claude-bridge-pool-session.ts +59 -0
  310. package/src/server/claude-messages.ts +174 -84
  311. package/src/server/context-history.ts +5 -1
  312. package/src/server/gui-static.ts +4 -1
  313. package/src/server/hub-usage.ts +7 -2
  314. package/src/server/inbound-body-admission.ts +11 -4
  315. package/src/server/index/link-management.ts +8 -0
  316. package/src/server/index/ollama-routes.ts +91 -0
  317. package/src/server/index/serve-options.ts +44 -24
  318. package/src/server/index/startup-warnings.ts +5 -12
  319. package/src/server/index/websocket-handler.ts +5 -2
  320. package/src/server/index.ts +6 -36
  321. package/src/server/inference/client-encoder-delivery.ts +9 -3
  322. package/src/server/json-serialized-bytes.ts +44 -0
  323. package/src/server/management/agent-settings-routes.ts +24 -21
  324. package/src/server/management/codex-cli-update-routes.ts +2 -1
  325. package/src/server/management/logs-usage-routes.ts +89 -4
  326. package/src/server/management/provider-routes.ts +2 -22
  327. package/src/server/management/qoder-provider-probe.ts +105 -0
  328. package/src/server/management/route-registry.ts +4 -1
  329. package/src/server/management/usage-aggregate-cache.ts +15 -5
  330. package/src/server/management/usage-source-facets.ts +38 -0
  331. package/src/server/messages-native-scope.ts +2 -1
  332. package/src/server/messages-native-tool-guard.ts +12 -4
  333. package/src/server/messages-native.ts +123 -47
  334. package/src/server/messages-response-headers.ts +25 -11
  335. package/src/server/messages-shared.ts +99 -65
  336. package/src/server/messages-sse-error-filter.ts +199 -0
  337. package/src/server/native-final-log.ts +93 -0
  338. package/src/server/ollama-inbound.ts +349 -0
  339. package/src/server/ollama-native-paths.ts +21 -0
  340. package/src/server/ollama-route-policy.ts +73 -0
  341. package/src/server/relay.ts +22 -3
  342. package/src/server/request-decompress.ts +4 -2
  343. package/src/server/request-log-failure-attribution.ts +22 -0
  344. package/src/server/request-log-failure-detail.ts +80 -0
  345. package/src/server/request-log-terminal-status.ts +4 -2
  346. package/src/server/request-log.ts +91 -42
  347. package/src/server/response-log-body.ts +6 -1
  348. package/src/server/responses/account-change-state.ts +17 -6
  349. package/src/server/responses/adapter-continuation.ts +17 -6
  350. package/src/server/responses/adapter-delivery.ts +17 -10
  351. package/src/server/responses/adapter-dispatch.ts +32 -31
  352. package/src/server/responses/anthropic-thinking-recovery.ts +3 -0
  353. package/src/server/responses/codex-auth-error.ts +24 -19
  354. package/src/server/responses/codex-ws-exchange.ts +11 -8
  355. package/src/server/responses/codex-ws-metadata.ts +94 -21
  356. package/src/server/responses/codex-ws-request.ts +3 -1
  357. package/src/server/responses/codex-ws-wire.ts +19 -3
  358. package/src/server/responses/compact.ts +57 -24
  359. package/src/server/responses/compaction-recovery.ts +4 -2
  360. package/src/server/responses/compaction-routing.ts +9 -4
  361. package/src/server/responses/core-auth.ts +32 -14
  362. package/src/server/responses/core-codex-account.ts +17 -6
  363. package/src/server/responses/core-combo-failure.ts +7 -1
  364. package/src/server/responses/core-combo-native.ts +2 -1
  365. package/src/server/responses/core-combo.ts +43 -27
  366. package/src/server/responses/core-errors.ts +24 -21
  367. package/src/server/responses/core-lifetime.ts +6 -3
  368. package/src/server/responses/core-normalize.ts +1 -0
  369. package/src/server/responses/core-options.ts +9 -0
  370. package/src/server/responses/core-pipeline.ts +4 -3
  371. package/src/server/responses/empty-completion-guard.ts +4 -1
  372. package/src/server/responses/fetch-helpers.ts +7 -1
  373. package/src/server/responses/input-admission.ts +28 -2
  374. package/src/server/responses/native-injection.ts +1 -1
  375. package/src/server/responses/native-response-json.ts +13 -4
  376. package/src/server/responses/native-response-output.ts +1 -2
  377. package/src/server/responses/non-replayable-error.ts +2 -1
  378. package/src/server/responses/pacing-overload.ts +3 -2
  379. package/src/server/responses/passthrough-delivery.ts +55 -14
  380. package/src/server/responses/passthrough-dispatch.ts +20 -18
  381. package/src/server/responses/passthrough-error.ts +9 -9
  382. package/src/server/responses/policy-fallback.ts +2 -1
  383. package/src/server/responses/request-prepare.ts +69 -48
  384. package/src/server/responses/request-transport.ts +36 -31
  385. package/src/server/responses/response-effects.ts +3 -2
  386. package/src/server/responses/run-turn-execution.ts +6 -6
  387. package/src/server/responses/sidecar-execution.ts +16 -12
  388. package/src/server/responses/spend-storage-error.ts +2 -1
  389. package/src/server/responses/terminal-guard.ts +30 -0
  390. package/src/server/responses/ws-upstream.ts +9 -0
  391. package/src/server/responses-custom-tool-repair.ts +14 -3
  392. package/src/server/responses-terminal-repair.ts +5 -2
  393. package/src/server/responses-undeclared-tool-guard.ts +39 -16
  394. package/src/server/restart-replacement.ts +3 -1
  395. package/src/server/safe-response-headers.ts +162 -13
  396. package/src/server/sse-payload-rewrite.ts +23 -11
  397. package/src/server/turn-state-handles.ts +164 -0
  398. package/src/server/workflow-refusal.ts +2 -1
  399. package/src/server/ws-bridge.ts +4 -0
  400. package/src/service/definition.ts +36 -4
  401. package/src/service/launchd.ts +89 -32
  402. package/src/service/logging.ts +34 -7
  403. package/src/service/ownership-mutation-lease.d.mts +11 -2
  404. package/src/service/ownership-mutation-lease.mjs +53 -11
  405. package/src/service/plist-xml.ts +59 -0
  406. package/src/service/state.ts +8 -0
  407. package/src/service/systemd-env.ts +2 -0
  408. package/src/service/systemd.ts +31 -7
  409. package/src/service/windows-taskxml.ts +16 -7
  410. package/src/service-manager-probe.ts +4 -10
  411. package/src/types/config.ts +2 -0
  412. package/src/types/provider.ts +2 -0
  413. package/src/types/request.ts +13 -1
  414. package/src/update/config-preflight.ts +48 -0
  415. package/src/update/index.ts +148 -26
  416. package/src/update/npm-install.d.mts +8 -0
  417. package/src/update/npm-install.mjs +20 -1
  418. package/src/update/orchestrated-admission.d.mts +4 -0
  419. package/src/update/orchestrated-admission.mjs +12 -0
  420. package/src/update/orchestrated-arguments.d.mts +12 -0
  421. package/src/update/orchestrated-arguments.mjs +64 -0
  422. package/src/update/orchestrated-child.d.mts +12 -0
  423. package/src/update/orchestrated-child.mjs +70 -0
  424. package/src/update/orchestrated-entry.ts +234 -0
  425. package/src/update/orchestrated-identity-probe-entry.ts +20 -0
  426. package/src/update/orchestrated-identity.ts +53 -0
  427. package/src/update/orchestrated-live-identity.ts +48 -0
  428. package/src/update/orchestrated-node-driver.mjs +99 -0
  429. package/src/update/orchestrated-outcome.d.mts +21 -0
  430. package/src/update/orchestrated-outcome.mjs +40 -0
  431. package/src/update/orchestrated-plan.ts +49 -0
  432. package/src/update/orchestrated-pnpm.d.mts +8 -0
  433. package/src/update/orchestrated-pnpm.mjs +33 -0
  434. package/src/update/orchestrated-session.d.mts +37 -0
  435. package/src/update/orchestrated-session.mjs +264 -0
  436. package/src/update/orchestrated-token.d.mts +10 -0
  437. package/src/update/orchestrated-token.mjs +21 -0
  438. package/src/update/orchestrated-token.ts +3 -0
  439. package/src/update/orchestrated-tree.d.mts +1 -0
  440. package/src/update/orchestrated-tree.mjs +14 -0
  441. package/src/update/pnpm-global-install.d.mts +6 -0
  442. package/src/update/pnpm-global-install.mjs +9 -2
  443. package/src/update/posix-install-supervisor-entry.mjs +6 -0
  444. package/src/update/posix-install-supervisor.d.mts +10 -0
  445. package/src/update/posix-install-supervisor.mjs +88 -0
  446. package/src/update/sync-update-mutex.d.mts +10 -0
  447. package/src/update/sync-update-mutex.mjs +164 -0
  448. package/src/update/sync-update-mutex.ts +1 -0
  449. package/src/update/test-home-guard.mjs +33 -0
  450. package/src/update/transactional-install.mjs +2 -2
  451. package/src/usage/client.ts +43 -0
  452. package/src/usage/error-detail.ts +225 -0
  453. package/src/usage/log.ts +64 -27
  454. package/src/usage/source-facets.ts +51 -0
  455. package/src/usage/source-filter.ts +65 -0
  456. package/src/usage/summary.ts +50 -8
  457. package/src/web-search/anthropic-executor.ts +105 -24
  458. package/src/web-search/executor.ts +5 -3
  459. package/src/web-search/loop.ts +33 -6
  460. package/src/web-search/progress-stream.ts +64 -5
  461. package/gui/dist/assets/App-bwugJRKn.js +0 -58
  462. package/gui/dist/assets/index-ebuVUtB7.js +0 -94
  463. package/gui/dist/assets/quota-summary-6HsrHQAy.js +0 -1
  464. /package/gui/dist/{assets → classic/assets}/App-B4j-Txmb.css +0 -0
  465. /package/gui/dist/{assets → classic/assets}/index-CHWwDo9L.css +0 -0
@@ -1,3 +1,6 @@
1
+ import { clientFacingModelText } from "../../lib/error-destination";
2
+ import { projectLocalModelRefusalLog } from "../request-log-failure-detail";
3
+ import { markProxyError, carryProxyError } from "../../lib/client-error-body";
1
4
  import { codexAdapterBuildRefusal } from "./passthrough-build-error";
2
5
  import { recoverAutoPausedAccount } from "./account-auto-pause-recovery";
3
6
  import { wasAccountAutoPaused, wasPermanentAccountRefusal } from "../../oauth/account-auto-pause";
@@ -51,7 +54,7 @@ import {
51
54
  fetchWithTransientRetry,
52
55
  fetchWithResetRetry,
53
56
  applyUpstreamRecoveryInit,
54
- SendBudgetExhaustedError,
57
+ SendBudgetExhaustedError, errorDestinationLabel,
55
58
  UpstreamRetryEvidenceError,
56
59
  prepareSameTarget429Wait,
57
60
  sleepWithAbort,
@@ -60,7 +63,7 @@ import { describeUpstreamConnectFailure } from "./upstream-error";
60
63
  import type { OpaqueBlobRecoveryGuard } from "./core-opaque-recovery";
61
64
  import type { AttemptRecoveryKind } from "../../usage/log";
62
65
  import type { OAuthAccessSnapshot } from "../../oauth";
63
- import { OAuthAccountPausedError, OAuthLoginRequiredError, OAuthTokenRefreshBusyError, publicOAuthAuthenticationErrorMessage } from "../../oauth";
66
+ import { publicOAuthErrorPresentation, OAuthAccountPausedError, OAuthLoginRequiredError, OAuthTokenRefreshBusyError, publicOAuthAuthenticationErrorMessage } from "../../oauth";
64
67
  import { getAccountSet, markAccountNeedsReauthIfGeneration } from "../../oauth/store";
65
68
  import { tryKiroAlternateAfterTerminalRefresh } from "../../oauth/kiro-terminal-failover";
66
69
  import { classifyKiroRefusal } from "../../adapters/kiro-refusal";
@@ -120,8 +123,7 @@ import { chargeWorkflowSends } from "../../lib/workflow-budget";
120
123
  import { isAntigravityValidationRefusal } from "./antigravity-validation-refusal";
121
124
  import { createAntigravityModelDenialRecovery, recoverAntigravityAccount } from "./antigravity-model-denial-recovery";
122
125
  import { unboundPoolSpendRefusalResponse } from "../workflow-refusal";
123
- import { AdmissionModelDeniedError, admissionModelDeniedResponse } from "../admission-model-scope";
124
-
126
+ import { AdmissionModelDeniedError, admissionModelDeniedResponse, projectAdmissionModelDeniedLog } from "../admission-model-scope";
125
127
  /** One responsibility of the Responses request pipeline; state owners are explicit. */
126
128
  export async function prepareAdapterExchange(
127
129
  requestContext: Pick<ResponsesRequestContext, "options" | "config" | "logCtx" | "req">,
@@ -232,8 +234,6 @@ export async function prepareAdapterExchange(
232
234
  reserveCredentialHop,
233
235
  claimAmbiguousResend,
234
236
  } = sendBudgetState;
235
-
236
-
237
237
  let selfContainedJudgment: boolean | undefined;
238
238
  // On the Antigravity direct lane the raw body carries only settings; judge the body the bridge
239
239
  // would have sent, built only if an ambiguous reset actually asks.
@@ -397,7 +397,7 @@ export async function prepareAdapterExchange(
397
397
  const headers = new Headers(original.headers);
398
398
  headers.delete("content-length");
399
399
  headers.delete("content-encoding");
400
- upstreamResponse = new Response(text, { status: original.status, statusText: original.statusText, headers });
400
+ upstreamResponse = carryProxyError(original, new Response(text, { status: original.status, statusText: original.statusText, headers }));
401
401
  return upstreamResponse;
402
402
  };
403
403
  const autoPauseEnabled = config.providers[route.providerName]?.accountAutoPause?.enabled === true;
@@ -454,7 +454,7 @@ export async function prepareAdapterExchange(
454
454
  targetKey: `${route.providerName}|${builtInitialRequest.url}|${route.modelId}`,
455
455
  countedExternally: true,
456
456
  });
457
- if (!decision.allowed) throw new SendBudgetExhaustedError(safeHostLabel(builtInitialRequest.url));
457
+ if (!decision.allowed) throw new SendBudgetExhaustedError(errorDestinationLabel(builtInitialRequest.url));
458
458
  handoffPermit = decision.permit;
459
459
  }
460
460
  const compactPrepaid = handoffPermit ?? (options.compactionRecoveryAttempted ? sendBudgetState.pendingHopPermit : undefined);
@@ -489,7 +489,7 @@ export async function prepareAdapterExchange(
489
489
  });
490
490
  // Receipt mode books the physical send at executor admission instead of here.
491
491
  if (!deferredInitial && !receiptMode && compactPrepaid && !compactPrepaidUsed) {
492
- if (!compactPrepaid.use()) throw new SendBudgetExhaustedError(safeHostLabel(builtInitialRequest.url));
492
+ if (!compactPrepaid.use()) throw new SendBudgetExhaustedError(errorDestinationLabel(builtInitialRequest.url));
493
493
  compactPrepaidUsed = true;
494
494
  }
495
495
  // Key transport keeps this metadata pending until it binds the actual selection.
@@ -505,9 +505,9 @@ export async function prepareAdapterExchange(
505
505
  modelId: route.modelId,
506
506
  onPhysicalDispatch: () => {
507
507
  if (deferredInitial) {
508
- if (!deferredInitial.beforeDispatch()) throw new SendBudgetExhaustedError(safeHostLabel(builtInitialRequest.url));
508
+ if (!deferredInitial.beforeDispatch()) throw new SendBudgetExhaustedError(errorDestinationLabel(builtInitialRequest.url));
509
509
  if (compactPrepaid && !compactPrepaidUsed) {
510
- if (!compactPrepaid.use()) throw new SendBudgetExhaustedError(safeHostLabel(builtInitialRequest.url));
510
+ if (!compactPrepaid.use()) throw new SendBudgetExhaustedError(errorDestinationLabel(builtInitialRequest.url));
511
511
  compactPrepaidUsed = true;
512
512
  }
513
513
  }
@@ -524,7 +524,7 @@ export async function prepareAdapterExchange(
524
524
  },
525
525
  {
526
526
  abortSignal: upstream.signal,
527
- label: safeHostLabel(builtInitialRequest.url),
527
+ label: safeHostLabel(builtInitialRequest.url), destination: errorDestinationLabel(builtInitialRequest.url),
528
528
  claimAmbiguousResend: claimPreHeaderResend,
529
529
  ...(sendBudgetState.adapterSendBudget?.spendEnforced || options.comboDispatchPermit || transientPolicy || resetPolicy || compactPrepaid || options.comboAttempt
530
530
  || billingPoolRequest || autoPauseEnabled
@@ -558,7 +558,7 @@ export async function prepareAdapterExchange(
558
558
  const refusal = err instanceof UpstreamRetryEvidenceError ? err.cause : err;
559
559
  if (refusal instanceof AdmissionModelDeniedError) {
560
560
  releaseCodexAuthContextProbeLease(admissionState.authCtx);
561
- return admissionModelDeniedResponse(refusal);
561
+ return admissionModelDeniedResponse(projectAdmissionModelDeniedLog(refusal, logCtx));
562
562
  }
563
563
  const codexRefusal = mapCodexAuthContextErrorToResponse(unwrapUpstreamRetryEvidenceError(err), {
564
564
  now: Date.now(), accountSelector: route.codexAccountNamespace,
@@ -569,10 +569,10 @@ export async function prepareAdapterExchange(
569
569
  }
570
570
  // A pause committed during pacing is local admission policy, not a failed upstream.
571
571
  if (refusal instanceof OAuthAccountPausedError) {
572
- return formatErrorResponse(403, "permission_error", publicOAuthAuthenticationErrorMessage(refusal));
572
+ return markProxyError(formatErrorResponse(403, "permission_error", publicOAuthAuthenticationErrorMessage(refusal)), publicOAuthErrorPresentation(refusal));
573
573
  }
574
574
  if (refusal instanceof OAuthLoginRequiredError) {
575
- return formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(refusal));
575
+ return markProxyError(formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(refusal)), publicOAuthErrorPresentation(refusal));
576
576
  }
577
577
  if (refusal instanceof AnthropicAccountCooldownError) {
578
578
  return anthropicPoolCooldownResponse(refusal, { comboAttempt: options.comboAttempt, logCtx });
@@ -583,7 +583,7 @@ export async function prepareAdapterExchange(
583
583
  // budget exists to stop. The passthrough path has answered 429 here since #4546.
584
584
  if (err instanceof SendBudgetExhaustedError) {
585
585
  return unboundPoolSpendRefusalResponse(logCtx)
586
- ?? formatErrorResponse(429, SEND_BUDGET_EXHAUSTED_CODE, err.message);
586
+ ?? markProxyError(formatErrorResponse(429, SEND_BUDGET_EXHAUSTED_CODE, err.message));
587
587
  }
588
588
  const msg = describeUpstreamConnectFailure(err, connectMs);
589
589
  return formatErrorResponse(502, "upstream_error", msg);
@@ -610,7 +610,7 @@ export async function prepareAdapterExchange(
610
610
  let imageRetryAttempted = false;
611
611
  const opaqueBlobRecoveryGuard: OpaqueBlobRecoveryGuard = { attempted: false };
612
612
  const thinkingSignatureRecovery = createAnthropicThinkingRecovery(
613
- parsed, upstream.signal, opaqueBlobRecoveryGuard, () => !sendBudgetExhausted(),
613
+ parsed, upstream.signal, opaqueBlobRecoveryGuard, () => !sendBudgetExhausted(), logCtx,
614
614
  );
615
615
  // Console Go answers a transient 400 "Invalid upload request." for bodies it accepts
616
616
  // moments later; at most one byte-identical replay is allowed per request.
@@ -781,7 +781,7 @@ export async function prepareAdapterExchange(
781
781
  if (pendingKeyMetadata) transportState.noteRoutedAttemptSend(retryEstimate, recoveryKind ?? recovery);
782
782
  const confirmDispatch = () => {
783
783
  if (refetchAllowance?.permit && !refetchPermitUsed) {
784
- if (!refetchAllowance.permit.use()) throw new SendBudgetExhaustedError(safeHostLabel(retryRequest.url));
784
+ if (!refetchAllowance.permit.use()) throw new SendBudgetExhaustedError(errorDestinationLabel(retryRequest.url));
785
785
  refetchPermitUsed = true;
786
786
  }
787
787
  if (!pendingKeyMetadata) transportState.noteRoutedAttemptSend(retryEstimate, recoveryKind ?? recovery);
@@ -799,7 +799,7 @@ export async function prepareAdapterExchange(
799
799
  providerFetch(route.provider, options.codexWsRuntimeIdentity, {
800
800
  dispatchOverride: oauthDispatch(retryRequest),
801
801
  onPhysicalDispatch: deferredRefetch ? () => {
802
- if (!deferredRefetch.beforeDispatch()) throw new SendBudgetExhaustedError(safeHostLabel(retryRequest.url));
802
+ if (!deferredRefetch.beforeDispatch()) throw new SendBudgetExhaustedError(errorDestinationLabel(retryRequest.url));
803
803
  confirmDispatch();
804
804
  } : undefined,
805
805
  providerName: route.providerName,
@@ -810,7 +810,7 @@ export async function prepareAdapterExchange(
810
810
  },
811
811
  {
812
812
  abortSignal: upstream.signal,
813
- label: safeHostLabel(retryRequest.url),
813
+ label: safeHostLabel(retryRequest.url), destination: errorDestinationLabel(retryRequest.url),
814
814
  claimAmbiguousResend: claimPreHeaderResend,
815
815
  ...(refetchAllowance
816
816
  ? {
@@ -841,7 +841,7 @@ export async function prepareAdapterExchange(
841
841
  cleanupUpstreamAbort();
842
842
  upstream.abort();
843
843
  releaseCodexAuthContextProbeLease(admissionState.authCtx);
844
- return { failed: admissionModelDeniedResponse(scopeRefusal) };
844
+ return { failed: admissionModelDeniedResponse(projectAdmissionModelDeniedLog(scopeRefusal, logCtx)) };
845
845
  }
846
846
  const codexRefusal = !options.abortSignal?.aborted && mapCodexAuthContextErrorToResponse(unwrapUpstreamRetryEvidenceError(err), {
847
847
  now: Date.now(), accountSelector: route.codexAccountNamespace,
@@ -861,10 +861,10 @@ export async function prepareAdapterExchange(
861
861
  }
862
862
  const refusal = err instanceof UpstreamRetryEvidenceError ? err.cause : err;
863
863
  if (refusal instanceof OAuthAccountPausedError) {
864
- return { failed: formatErrorResponse(403, "permission_error", publicOAuthAuthenticationErrorMessage(refusal)) };
864
+ return { failed: markProxyError(formatErrorResponse(403, "permission_error", publicOAuthAuthenticationErrorMessage(refusal)), publicOAuthErrorPresentation(refusal)) };
865
865
  }
866
866
  if (refusal instanceof OAuthLoginRequiredError) {
867
- return { failed: formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(refusal)) };
867
+ return { failed: markProxyError(formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(refusal)), publicOAuthErrorPresentation(refusal)) };
868
868
  }
869
869
  if (refusal instanceof AnthropicAccountCooldownError) {
870
870
  return { failed: anthropicPoolCooldownResponse(refusal, { comboAttempt: options.comboAttempt, logCtx }) };
@@ -873,7 +873,7 @@ export async function prepareAdapterExchange(
873
873
  // this proxy rather than the provider it never reached.
874
874
  if (err instanceof SendBudgetExhaustedError) {
875
875
  return { failed: unboundPoolSpendRefusalResponse(logCtx)
876
- ?? formatErrorResponse(429, SEND_BUDGET_EXHAUSTED_CODE, err.message) };
876
+ ?? markProxyError(formatErrorResponse(429, SEND_BUDGET_EXHAUSTED_CODE, err.message)) };
877
877
  }
878
878
  const msg = describeUpstreamConnectFailure(err, connectMs);
879
879
  return { failed: formatErrorResponse(502, "upstream_error", msg) };
@@ -975,7 +975,7 @@ export async function prepareAdapterExchange(
975
975
  try { void upstreamResponse.body?.cancel().catch(() => {}); } catch { /* already closed */ }
976
976
  releaseCodexAuthContextProbeLease(admissionState.authCtx);
977
977
  return cancelled ? clientCancelledResponse()
978
- : formatErrorResponse(503, "server_error", publicOAuthAuthenticationErrorMessage(err), { retryAfter: "1" });
978
+ : markProxyError(formatErrorResponse(503, "server_error", publicOAuthAuthenticationErrorMessage(err), { retryAfter: "1" }), publicOAuthErrorPresentation(err));
979
979
  }
980
980
  const failed = transportState.sentOAuthSnapshot;
981
981
  if (route.providerName === "google-antigravity" && !antigravityAuthRotationAttempted
@@ -1027,13 +1027,13 @@ export async function prepareAdapterExchange(
1027
1027
  }
1028
1028
  cleanupUpstreamAbort();
1029
1029
  if (err instanceof OAuthAccountPausedError) {
1030
- return formatErrorResponse(403, "permission_error", publicOAuthAuthenticationErrorMessage(err));
1030
+ return markProxyError(formatErrorResponse(403, "permission_error", publicOAuthAuthenticationErrorMessage(err)), publicOAuthErrorPresentation(err));
1031
1031
  }
1032
- return formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(err));
1032
+ return markProxyError(formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(err)), publicOAuthErrorPresentation(err));
1033
1033
  }
1034
1034
  if (route.provider.googleMode === "cloud-code-assist" && !refreshed.projectId) {
1035
1035
  cleanupUpstreamAbort();
1036
- return formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(new Error("Cloud Code Assist project is required")));
1036
+ return markProxyError(formatErrorResponse(401, "authentication_error", publicOAuthAuthenticationErrorMessage(new Error("Cloud Code Assist project is required"))));
1037
1037
  }
1038
1038
  transportState.sentOAuthSnapshot = refreshed;
1039
1039
  transportState.replayOAuthCredentialSnapshot = {
@@ -1651,7 +1651,7 @@ export async function prepareAdapterExchange(
1651
1651
  cleanupUpstreamAbort();
1652
1652
  upstream.abort();
1653
1653
  releaseCodexAuthContextProbeLease(admissionState.authCtx);
1654
- return admissionModelDeniedResponse(scopeRefusal);
1654
+ return admissionModelDeniedResponse(projectAdmissionModelDeniedLog(scopeRefusal, logCtx));
1655
1655
  }
1656
1656
  // A throw before the send — snapshot fetch, credential application, adapter
1657
1657
  // resolution — must hand the reservation back. Without this the ladder charges the
@@ -1886,15 +1886,16 @@ export async function prepareAdapterExchange(
1886
1886
  cleanupUpstreamAbort();
1887
1887
  }
1888
1888
  if (upstreamResponse.status === 413) {
1889
+ if (options.clientModelLabel) projectLocalModelRefusalLog(logCtx, options.clientModelLabel);
1889
1890
  return clientRequestedStream
1890
- ? streamingContextOverflowResponse(parsed._responseModelId ?? parsed.modelId, translatorBudget)
1891
+ ? streamingContextOverflowResponse(clientFacingModelText(options.clientModelLabel), translatorBudget)
1891
1892
  : jsonContextOverflowResponse();
1892
1893
  }
1893
1894
  const policyRefusal = rewriteUpstreamPolicyRefusal({
1894
1895
  status: upstreamResponse.status,
1895
1896
  errorText,
1896
1897
  stream: clientRequestedStream,
1897
- modelId: parsed._responseModelId ?? parsed.modelId,
1898
+ modelId: clientFacingModelText(options.clientModelLabel),
1898
1899
  // The same host check covers the openai-chat wire: both xAI hosts serve Chat too.
1899
1900
  destinationIsXai: isXaiResponsesDestination(route.provider),
1900
1901
  translatorBudget,
@@ -1,3 +1,4 @@
1
+ import { proxyErrorPresentation, isProxyError, rememberProxyErrorMessage } from "../../lib/client-error-body";
1
2
  import { anthropicRejectionPolicy, bindAnthropicRejectionPolicy, rejectedAnthropicPayloads } from "../../adapters/anthropic-rejection-memo";
2
3
  import { normalizeUpstreamErrorText, readDisplaySafeErrorText } from "./core-errors";
3
4
  import { sanitizeNonReplayableUpstreamError } from "./non-replayable-error";
@@ -28,6 +29,7 @@ export function createAnthropicThinkingRecovery(
28
29
  signal: AbortSignal,
29
30
  guard: OpaqueBlobRecoveryGuard,
30
31
  canRetry: () => boolean,
32
+ proxyErrorContext?: object,
31
33
  ) {
32
34
  let rejectedScope: OcxParsedRequest["_reasoningReplayScope"];
33
35
  let rejectedPayloads: ReadonlySet<string> | undefined;
@@ -146,6 +148,7 @@ export function createAnthropicThinkingRecovery(
146
148
  if (nonReplayable) response = await sanitizeNonReplayableUpstreamError(response, abortSignal);
147
149
  const text = await readDisplaySafeErrorText(response, abortSignal, `Provider error ${response.status}`);
148
150
  const error = normalizeUpstreamErrorText(text, `Provider error ${response.status}`);
151
+ if (proxyErrorContext && isProxyError(response)) rememberProxyErrorMessage(proxyErrorContext, error.message ?? error.safeText, { status: response.status, type: error.type ?? "upstream_error", code: error.code, presentation: proxyErrorPresentation(response) });
149
152
  return { type: "error", status: response.status, message: error.message ?? error.safeText,
150
153
  errorType: error.type ?? "upstream_error", ...(error.code ? { code: error.code } : {}),
151
154
  ...(nonReplayable ? { retryable: false } : {}) };
@@ -1,7 +1,8 @@
1
+ import { markProxyError } from "../../lib/client-error-body";
1
2
  import { CodexInstallationIdUnavailableError } from "../../codex/installation-id";
2
3
  import { formatErrorResponse } from "../../bridge";
3
4
  import {
4
- CodexAccountCooldownError,
5
+ CodexAccountCooldownError, CodexMainAccountHardLockError, CodexMainAccountCreditsOffError, CodexPoolAccountCreditsOffError, CodexReserveUnavailableError, CodexRecoveryWithheldError,
5
6
  codexMainProfileDrainingResponse,
6
7
  cooldownErrorResponse,
7
8
  CodexAuthContextError,
@@ -27,9 +28,9 @@ export interface CodexAuthContextErrorResponseOptions {
27
28
 
28
29
  export function codexModelAvailabilityErrorResponse(error: CodexModelAvailabilityError): Response {
29
30
  if (error.reason === "temporarily_unavailable") {
30
- return formatErrorResponse(429, "rate_limit_error", error.message);
31
+ return markProxyError(formatErrorResponse(429, "rate_limit_error", error.message), "model_availability");
31
32
  }
32
- return formatErrorResponse(400, "invalid_request_error", error.message);
33
+ return markProxyError(formatErrorResponse(400, "invalid_request_error", error.message), "model_availability");
33
34
  }
34
35
 
35
36
  /** Actionable sign-in guidance without guessing which upstream revocation cause occurred. */
@@ -40,7 +41,7 @@ export function nativeMainRefreshFailureResponse(error: unknown): Response {
40
41
  if (error instanceof MainAccountTokenRefreshError && error.reason === "reauth") {
41
42
  // Same sentence the quarantine produces on every later request, so the first refusal and the
42
43
  // ones after it do not describe one dead credential two different ways.
43
- return formatErrorResponse(401, "authentication_error", CODEX_MAIN_SIGN_IN_REQUIRED_MESSAGE);
44
+ return markProxyError(formatErrorResponse(401, "authentication_error", CODEX_MAIN_SIGN_IN_REQUIRED_MESSAGE));
44
45
  }
45
46
  if (error instanceof MainAccountTokenRefreshError
46
47
  || error instanceof MainAuthJsonChangedDuringRefreshError
@@ -61,17 +62,17 @@ export function nativeMainRefreshFailureResponse(error: unknown): Response {
61
62
  // bad API key and the client stops retrying. The pool path documented this trap and this one
62
63
  // walked into it anyway, which is why the test below now asserts the classification and not
63
64
  // just the sentence.
64
- const response = formatErrorResponse(
65
+ const response = markProxyError(formatErrorResponse(
65
66
  503,
66
67
  "server_busy",
67
68
  "Codex main credential refresh did not complete; retry this request. "
68
69
  + "If it keeps failing, sign in to the main Codex account again.",
69
- );
70
+ ));
70
71
  const headers = new Headers(response.headers);
71
72
  headers.set("Retry-After", "1");
72
- return new Response(response.body, { status: response.status, headers });
73
+ return markProxyError(new Response(response.body, { status: response.status, headers }));
73
74
  }
74
- return formatErrorResponse(401, "authentication_error", "No usable Codex main credential to serve this request");
75
+ return markProxyError(formatErrorResponse(401, "authentication_error", "No usable Codex main credential to serve this request"));
75
76
  }
76
77
 
77
78
  /** Shared HTTP contract for Codex auth-context failures on Responses surfaces. */
@@ -80,48 +81,52 @@ export function mapCodexAuthContextErrorToResponse(
80
81
  options: CodexAuthContextErrorResponseOptions,
81
82
  ): Response | undefined {
82
83
  if (error instanceof CodexInstallationIdUnavailableError) {
83
- return formatErrorResponse(503, "server_busy", error.message);
84
+ return markProxyError(formatErrorResponse(503, "server_busy", error.message));
84
85
  }
85
86
  if (error instanceof CodexAccountCooldownError) {
86
87
  const response = cooldownErrorResponse(error, options.now, options.accountSelector);
87
88
  // Exact class only (#7850): main hard-lock, credit, Reserve, recovery-withheld and future
88
89
  // policy subclasses keep their own retry semantics, including in combo target cooldowns.
89
- return error.constructor === CodexAccountCooldownError ? markCodexAccountCooldownResponse(response) : response;
90
+ const presentation = error instanceof CodexMainAccountHardLockError ? "hard_lock"
91
+ : error instanceof CodexRecoveryWithheldError ? "recovery"
92
+ : error instanceof CodexMainAccountCreditsOffError || error instanceof CodexPoolAccountCreditsOffError || error instanceof CodexReserveUnavailableError ? undefined
93
+ : options.accountSelector ? "cooldown_pinned" : "cooldown";
94
+ return markProxyError(error.constructor === CodexAccountCooldownError ? markCodexAccountCooldownResponse(response) : response, presentation);
90
95
  }
91
96
  if (error instanceof CodexMainProfileDrainingError) {
92
- return codexMainProfileDrainingResponse();
97
+ return markProxyError(codexMainProfileDrainingResponse());
93
98
  }
94
99
  if (error instanceof CodexThreadAffinityExpiredError) {
95
- return formatErrorResponse(
100
+ return markProxyError(formatErrorResponse(
96
101
  409,
97
102
  "invalid_request_error",
98
103
  "Codex thread account affinity expired; start a new session",
99
- );
104
+ ));
100
105
  }
101
106
  if (error instanceof CodexAuthContextError) {
102
107
  if (error.accountId === MAIN_CODEX_ACCOUNT_ID) {
103
108
  return nativeMainRefreshFailureResponse(error.cause);
104
109
  }
105
- return formatErrorResponse(
110
+ return markProxyError(formatErrorResponse(
106
111
  401,
107
112
  "authentication_error",
108
113
  "Selected Codex account needs reauthentication",
109
- );
114
+ ));
110
115
  }
111
116
  if (error instanceof CodexModelAvailabilityError) {
112
117
  return codexModelAvailabilityErrorResponse(error);
113
118
  }
114
119
  if (error instanceof CodexPoolAuthenticationError || error instanceof CodexDirectAuthenticationError) {
115
- return formatErrorResponse(401, "authentication_error",
120
+ return markProxyError(formatErrorResponse(401, "authentication_error",
116
121
  error instanceof CodexPoolAuthenticationError && error.quarantinedMain
117
- ? CODEX_MAIN_SIGN_IN_REQUIRED_MESSAGE : error.message);
122
+ ? CODEX_MAIN_SIGN_IN_REQUIRED_MESSAGE : error.message));
118
123
  }
119
124
  if (error instanceof CodexMainSubstitutionUnavailableError) {
120
- return formatErrorResponse(
125
+ return markProxyError(formatErrorResponse(
121
126
  401,
122
127
  "authentication_error",
123
128
  "No usable Codex main credential to serve this request",
124
- );
129
+ ));
125
130
  }
126
131
  return undefined;
127
132
  }
@@ -3,7 +3,7 @@ import { mergeSteeringContinuation } from "./native-steering-settings";
3
3
  import { markNativeControlResponse } from "./native-response-control";
4
4
  import type { NativeResponseControl } from "./native-response-control";
5
5
  import { MAX_CLIENT_SSE_FRAME_BYTES } from "../sse-frame-buffer";
6
- import { isSafeResponseHeader } from "../safe-response-headers";
6
+ import { isSafeResponseHeader, type ResponseMetadataContext } from "../safe-response-headers";
7
7
  import { CodexWsMetadata, type CodexWsQuotaObserver } from "./codex-ws-metadata";
8
8
  import { CODEX_RESPONSES_HTTP_URL, type PreparedCodexWsRequest } from "./codex-ws-request";
9
9
  import { CodexWsCorrelation } from "./codex-ws-correlation";
@@ -36,6 +36,8 @@ interface ExchangeOptions {
36
36
  * control exchanges and on transports without the metadata channel.
37
37
  */
38
38
  preOutputRefusalHold?: CodexWsPreOutputRefusalHold;
39
+ /** Turn-state binding and known models for the metadata this exchange relays. */
40
+ metadataContext?: ResponseMetadataContext;
39
41
  }
40
42
 
41
43
  const HTTP_HEADER_TOKEN = /^[!#$%&'*+.^_`|~0-9a-z-]+$/i;
@@ -45,7 +47,7 @@ function record(value: unknown): value is Record<string, unknown> {
45
47
  }
46
48
 
47
49
  /** Rebuild only permitted metadata: upstream framing describes a different body. */
48
- function rejectionHeaders(source: Record<string, unknown>, prelude: Headers): Headers {
50
+ function rejectionHeaders(source: Record<string, unknown>, prelude: Headers, context: ResponseMetadataContext): Headers {
49
51
  const connectionHeaders = new Set<string>();
50
52
  for (const [name, value] of Object.entries(source)) {
51
53
  if (name.toLowerCase() !== "connection" || typeof value !== "string") continue;
@@ -57,7 +59,7 @@ function rejectionHeaders(source: Record<string, unknown>, prelude: Headers): He
57
59
  // Reuse the metadata owner's count/value/family budgets and window freshness
58
60
  // rules, without publishing quota twice. Pool bookkeeping consumes the HTTP
59
61
  // projection; plain-main publication belongs only to the WS observer.
60
- const projected = new CodexWsMetadata();
62
+ const projected = new CodexWsMetadata(undefined, context);
61
63
  try {
62
64
  for (const values of [Object.fromEntries(prelude), source]) {
63
65
  const headers = Object.fromEntries(Object.entries(values).filter(([name, value]) => {
@@ -88,7 +90,7 @@ function rejectionHeaders(source: Record<string, unknown>, prelude: Headers): He
88
90
  * The one 5xx exception is the opt-in pre-output refusal below (#6969): a structured upstream
89
91
  * refusal with nothing relayed but empty lifecycle frames, which the caller may replay.
90
92
  */
91
- function wrappedRejectionResponse(payload: Record<string, unknown>, prelude: Headers): Response | null {
93
+ function wrappedRejectionResponse(payload: Record<string, unknown>, prelude: Headers, context: ResponseMetadataContext): Response | null {
92
94
  if (payload.type !== "error" || payload.stream_id !== undefined) return null;
93
95
  // The native typed wrapper has one aliased field, not two competing statuses.
94
96
  if (Object.hasOwn(payload, "status_code") && Object.hasOwn(payload, "status")) return null;
@@ -98,7 +100,7 @@ function wrappedRejectionResponse(payload: Record<string, unknown>, prelude: Hea
98
100
  if (error != null && (!record(error)
99
101
  || [error.code, error.message].some(value => value != null && typeof value !== "string"))) return null;
100
102
  if (payload.headers != null && !record(payload.headers)) return null;
101
- const headers = rejectionHeaders(record(payload.headers) ? payload.headers : {}, prelude);
103
+ const headers = rejectionHeaders(record(payload.headers) ? payload.headers : {}, prelude, context);
102
104
  return new Response(JSON.stringify({
103
105
  error: error ?? { type: "upstream_error", message: "Upstream rejected the request" },
104
106
  }), { status, headers });
@@ -118,6 +120,7 @@ function refusalErrorBody(source: unknown): Record<string, string> {
118
120
  export function codexWsExchange(options: ExchangeOptions): Promise<Response> {
119
121
  const { session, url, init, prepared, sseFallback, onQuota, beforeDispatch, bunVersion, nativeControl, beforeContinuation,
120
122
  preOutputRefusalHold } = options;
123
+ const metadataContext = options.metadataContext ?? {};
121
124
  const { frameText, headers } = prepared;
122
125
  const signal = init.signal ?? undefined;
123
126
  return new Promise<Response>((resolve, reject) => {
@@ -148,7 +151,7 @@ export function codexWsExchange(options: ExchangeOptions): Promise<Response> {
148
151
  let terminalErrorStatus: number | null = null;
149
152
  let controller: ReadableStreamDefaultController<Uint8Array> | null = null;
150
153
  const encoder = new TextEncoder();
151
- const metadata = url === CODEX_RESPONSES_HTTP_URL ? new CodexWsMetadata(onQuota) : null;
154
+ const metadata = url === CODEX_RESPONSES_HTTP_URL ? new CodexWsMetadata(onQuota, metadataContext) : null;
152
155
  const correlation = session.retainable ? new CodexWsCorrelation(session.reused, id => session.hasCompleted(id)) : null;
153
156
  let detachOwner = () => {};
154
157
  let detachSteering = () => {};
@@ -656,7 +659,7 @@ export function codexWsExchange(options: ExchangeOptions): Promise<Response> {
656
659
  // in-body delivery, so a held 429 can never become a quota rotation it was not before.
657
660
  if (metadata && sent && !responseCommitted && !deferredCommit && type === "error") {
658
661
  let rejection: Response | null;
659
- try { rejection = wrappedRejectionResponse(normalized.payload, metadata.snapshot()); }
662
+ try { rejection = wrappedRejectionResponse(normalized.payload, metadata.snapshot(), metadataContext); }
660
663
  catch (error) { failStream(error); return; }
661
664
  if (rejection) {
662
665
  terminal = true;
@@ -677,7 +680,7 @@ export function codexWsExchange(options: ExchangeOptions): Promise<Response> {
677
680
  try {
678
681
  refusalPrelude = heldHeaders ?? metadata?.snapshot() ?? new Headers();
679
682
  const declared = normalized.payload.headers;
680
- refusalHeaders = rejectionHeaders(record(declared) ? declared : {}, refusalPrelude);
683
+ refusalHeaders = rejectionHeaders(record(declared) ? declared : {}, refusalPrelude, metadataContext);
681
684
  } catch {
682
685
  refusalStatus = undefined;
683
686
  }
@@ -1,4 +1,6 @@
1
- import { isSafeResponseHeader, safeResponseHeaders } from "../safe-response-headers";
1
+ import {
2
+ CODEX_QUOTA_FAMILIES, isSafeResponseHeader, normalizeSafeResponseHeader, safeResponseHeaders, type ResponseMetadataContext,
3
+ } from "../safe-response-headers";
2
4
 
3
5
  export const CODEX_WS_METADATA_MAX_BYTES = 32 * 1024;
4
6
  export const CODEX_WS_METADATA_MAX_FAMILIES = 16;
@@ -52,35 +54,98 @@ function finiteNonnegative(value: unknown): value is number {
52
54
  return typeof value === "number" && Number.isFinite(value) && value >= 0;
53
55
  }
54
56
 
55
- function nativeLimitFamily(event: Record<string, unknown>): string | null {
56
- const raw = event.metered_limit_name ?? event.limit_name ?? "codex";
57
+ function boundedInteger(value: unknown, max: number): value is number {
58
+ return finiteNonnegative(value) && Number.isSafeInteger(value) && value <= max;
59
+ }
60
+
61
+ // Native limit ids this proxy relays, keyed by their folded spelling; the value is the canonical id.
62
+ const NATIVE_LIMIT_IDS = new Map<string, string>([
63
+ ["codex", "codex"], ...CODEX_QUOTA_FAMILIES.map(family => [`codex-${family}`, `codex_${family}`] as [string, string]),
64
+ ]);
65
+ // ChatGPT plan labels relayed in the native frame; anything else is omitted.
66
+ const PLAN_TYPES = new Set(["free", "go", "plus", "pro", "team", "business", "enterprise", "edu"]);
67
+
68
+ /** Canonical native limit id, undefined when absent, null when present but not a known id. */
69
+ function nativeLimitId(raw: unknown): string | null | undefined {
70
+ if (raw === undefined) return undefined;
57
71
  if (typeof raw !== "string") return null;
58
- const name = raw.trim().toLowerCase().replaceAll("_", "-");
59
- return name.length <= 64 && /^codex(?:-[a-z0-9-]+)?$/.test(name) ? name : null;
72
+ return NATIVE_LIMIT_IDS.get(raw.trim().toLowerCase().replaceAll("_", "-")) ?? null;
73
+ }
74
+
75
+ function nativeLimitFamily(event: Record<string, unknown>): string | null {
76
+ const id = nativeLimitId(event.metered_limit_name ?? event.limit_name ?? "codex");
77
+ return id ? id.replaceAll("_", "-") : null;
78
+ }
79
+
80
+ type QuotaWindow = { used_percent: number; window_minutes?: number; reset_at?: number };
81
+
82
+ /** A quota window rebuilt from bounded numbers: percent clamped to 100 at two decimals, integer window and reset. */
83
+ function quotaWindow(value: unknown): QuotaWindow | undefined {
84
+ if (!record(value) || !finiteNonnegative(value.used_percent)) return undefined;
85
+ const window: QuotaWindow = { used_percent: Math.round(Math.min(value.used_percent, 100) * 100) / 100 };
86
+ if (boundedInteger(value.window_minutes, 1e7)) window.window_minutes = value.window_minutes;
87
+ if (boundedInteger(value.reset_at, 1e11)) window.reset_at = value.reset_at;
88
+ return window;
60
89
  }
61
90
 
62
- function writeWindow(headers: Headers, prefix: string, value: unknown): void {
63
- if (!record(value) || !finiteNonnegative(value.used_percent)) return;
64
- headers.set(`${prefix}-used-percent`, String(value.used_percent));
65
- for (const [field, suffix] of [["window_minutes", "window-minutes"], ["reset_at", "reset-at"]]) {
66
- const number = value[field!];
67
- if (finiteNonnegative(number) && Number.isSafeInteger(number)) headers.set(`${prefix}-${suffix}`, String(number));
91
+ function writeWindow(headers: Headers, prefix: string, window: QuotaWindow | undefined): void {
92
+ if (!window) return;
93
+ headers.set(`${prefix}-used-percent`, String(window.used_percent));
94
+ if (window.window_minutes !== undefined) headers.set(`${prefix}-window-minutes`, String(window.window_minutes));
95
+ if (window.reset_at !== undefined) headers.set(`${prefix}-reset-at`, String(window.reset_at));
96
+ }
97
+
98
+ /**
99
+ * The `codex.rate_limits` frame relayed to the client, rebuilt field by field: known limit ids and
100
+ * plan labels, boolean flags and bounded quota windows. Every other field is discarded, including
101
+ * the credit balance (it is only relayed as the proxy-formatted `x-codex-credits-balance` header).
102
+ * Windows of an unknown limit id are dropped, never relabelled as ordinary quota.
103
+ */
104
+ function rateLimitsFrame(event: Record<string, unknown>): Record<string, unknown> {
105
+ const frame: Record<string, unknown> = { type: "codex.rate_limits" };
106
+ if (typeof event.plan_type === "string" && PLAN_TYPES.has(event.plan_type)) frame.plan_type = event.plan_type;
107
+ for (const field of ["metered_limit_name", "limit_name"] as const) {
108
+ const id = nativeLimitId(event[field]);
109
+ if (id) frame[field] = id;
110
+ }
111
+ if (record(event.rate_limits)) {
112
+ const limits: Record<string, unknown> = {};
113
+ for (const flag of ["allowed", "limit_reached"]) {
114
+ if (typeof event.rate_limits[flag] === "boolean") limits[flag] = event.rate_limits[flag];
115
+ }
116
+ if (nativeLimitFamily(event)) {
117
+ for (const name of ["primary", "secondary"]) {
118
+ const window = quotaWindow(event.rate_limits[name]);
119
+ if (window) limits[name] = window;
120
+ }
121
+ }
122
+ frame.rate_limits = limits;
123
+ }
124
+ if (record(event.credits)) {
125
+ const credits: Record<string, unknown> = {};
126
+ for (const flag of ["has_credits", "unlimited"]) {
127
+ if (typeof event.credits[flag] === "boolean") credits[flag] = event.credits[flag];
128
+ }
129
+ frame.credits = credits;
68
130
  }
131
+ return frame;
69
132
  }
70
133
 
71
134
  function quotaHeaders(event: Record<string, unknown>): Headers {
72
135
  const headers = new Headers();
73
136
  const family = nativeLimitFamily(event);
74
137
  if (family && record(event.rate_limits)) {
75
- writeWindow(headers, `x-${family}-primary`, event.rate_limits.primary);
76
- writeWindow(headers, `x-${family}-secondary`, event.rate_limits.secondary);
138
+ writeWindow(headers, `x-${family}-primary`, quotaWindow(event.rate_limits.primary));
139
+ writeWindow(headers, `x-${family}-secondary`, quotaWindow(event.rate_limits.secondary));
77
140
  }
78
141
  if (record(event.credits)) {
79
142
  for (const [field, suffix] of [["has_credits", "has-credits"], ["unlimited", "unlimited"]]) {
80
143
  const value = event.credits[field!];
81
144
  if (typeof value === "boolean") headers.set(`x-codex-credits-${suffix}`, String(value));
82
145
  }
83
- if (typeof event.credits.balance === "string") setMetadataHeader(headers, "x-codex-credits-balance", event.credits.balance);
146
+ const balance = typeof event.credits.balance === "string"
147
+ ? normalizeSafeResponseHeader("x-codex-credits-balance", event.credits.balance) : undefined;
148
+ if (balance !== undefined) setMetadataHeader(headers, "x-codex-credits-balance", balance);
84
149
  }
85
150
  return headers;
86
151
  }
@@ -91,13 +156,17 @@ function setMetadataHeader(headers: Headers, name: string, value: string): void
91
156
  try { headers.set(name, value); } catch { /* invalid provider header is not HTTP authority */ }
92
157
  }
93
158
 
94
- function responseHeaders(value: unknown): Headers {
159
+ function responseHeaders(value: unknown, context: ResponseMetadataContext): Headers {
95
160
  const headers = new Headers();
96
161
  if (!record(value)) return headers;
97
162
  for (const [name, field] of Object.entries(value)) {
98
163
  if (!isSafeResponseHeader(name)) continue;
99
164
  if (typeof field !== "string" && typeof field !== "number" && typeof field !== "boolean") continue;
100
- setMetadataHeader(headers, name, String(field));
165
+ const raw = String(field);
166
+ // The byte budget applies to what the upstream sent; then only a value that fits its contract stays.
167
+ if (Buffer.byteLength(raw) > CODEX_WS_METADATA_MAX_VALUE_BYTES) throw new Error("codex websocket metadata value exceeds the size limit");
168
+ const normalized = normalizeSafeResponseHeader(name, raw, context);
169
+ if (normalized !== undefined) setMetadataHeader(headers, name, normalized);
101
170
  }
102
171
  return headers;
103
172
  }
@@ -124,7 +193,7 @@ export class CodexWsMetadata {
124
193
  private preludeBytes = 0;
125
194
  private committed = false;
126
195
 
127
- constructor(private observer?: CodexWsQuotaObserver) {}
196
+ constructor(private observer?: CodexWsQuotaObserver, private readonly context: ResponseMetadataContext = {}) {}
128
197
 
129
198
  snapshot(): Headers { return new Headers(this.headers); }
130
199
 
@@ -132,7 +201,11 @@ export class CodexWsMetadata {
132
201
  seed(headers: Headers): void {
133
202
  if (this.ended || this.committed || this.headers.has(REASONING_INCLUDED_HEADER)) return;
134
203
  const value = headers.get(REASONING_INCLUDED_HEADER);
135
- if (value !== null) setMetadataHeader(this.headers, REASONING_INCLUDED_HEADER, value);
204
+ if (value === null) return;
205
+ // Codex reads this header by presence. Keep it present, but only as bytes this proxy writes:
206
+ // an exact boolean, otherwise an empty value.
207
+ const folded = value.trim().toLowerCase();
208
+ setMetadataHeader(this.headers, REASONING_INCLUDED_HEADER, folded === "true" || folded === "false" ? folded : "");
136
209
  }
137
210
 
138
211
  private publishQuota(headers: Headers): void {
@@ -152,7 +225,7 @@ export class CodexWsMetadata {
152
225
  if (bytes > CODEX_WS_METADATA_MAX_BYTES) throw new Error("codex websocket metadata frame exceeds the size limit");
153
226
  if (!this.committed) this.preludeBytes += bytes;
154
227
  if (this.preludeBytes > CODEX_WS_METADATA_MAX_BYTES) throw new Error("codex websocket metadata prelude exceeds the size limit");
155
- const updates = event.type === "codex.rate_limits" ? quotaHeaders(event) : responseHeaders(event.headers);
228
+ const updates = event.type === "codex.rate_limits" ? quotaHeaders(event) : responseHeaders(event.headers, this.context);
156
229
  const next = this.snapshot();
157
230
  for (const name of updates.keys()) {
158
231
  if (!name.endsWith("-used-percent")) continue;
@@ -167,8 +240,8 @@ export class CodexWsMetadata {
167
240
  this.publishQuota(updates);
168
241
  }
169
242
  return event.type === "codex.response.metadata"
170
- ? JSON.stringify({ type: event.type, headers: safeResponseHeaders(updates) })
171
- : JSON.stringify(event);
243
+ ? JSON.stringify({ type: event.type, headers: safeResponseHeaders(updates, this.context) })
244
+ : JSON.stringify(rateLimitsFrame(event));
172
245
  }
173
246
 
174
247
  finish(): void {