@jsonstudio/llms 0.4.2

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 (538) hide show
  1. package/README.md +265 -0
  2. package/dist/api/index.d.ts +10 -0
  3. package/dist/api/index.js +11 -0
  4. package/dist/api/llmswitch-config.d.ts +15 -0
  5. package/dist/api/llmswitch-config.js +415 -0
  6. package/dist/api/llmswitch-types.d.ts +412 -0
  7. package/dist/api/llmswitch-types.js +60 -0
  8. package/dist/bridge/routecodex-adapter.d.ts +74 -0
  9. package/dist/bridge/routecodex-adapter.js +226 -0
  10. package/dist/config/index.d.ts +3 -0
  11. package/dist/config/index.js +5 -0
  12. package/dist/config-unified/enhanced-path-resolver.d.ts +5 -0
  13. package/dist/config-unified/enhanced-path-resolver.js +38 -0
  14. package/dist/config-unified/unified-config.d.ts +26 -0
  15. package/dist/config-unified/unified-config.js +187 -0
  16. package/dist/conversion/codec-registry.d.ts +10 -0
  17. package/dist/conversion/codec-registry.js +25 -0
  18. package/dist/conversion/codecs/anthropic-openai-codec.d.ts +23 -0
  19. package/dist/conversion/codecs/anthropic-openai-codec.js +546 -0
  20. package/dist/conversion/codecs/gemini-openai-codec.d.ts +16 -0
  21. package/dist/conversion/codecs/gemini-openai-codec.js +437 -0
  22. package/dist/conversion/codecs/openai-openai-codec.d.ts +12 -0
  23. package/dist/conversion/codecs/openai-openai-codec.js +125 -0
  24. package/dist/conversion/codecs/responses-openai-codec.d.ts +12 -0
  25. package/dist/conversion/codecs/responses-openai-codec.js +154 -0
  26. package/dist/conversion/config/config-manager.d.ts +212 -0
  27. package/dist/conversion/config/config-manager.js +310 -0
  28. package/dist/conversion/conversion-v3/adapters/index.d.ts +2 -0
  29. package/dist/conversion/conversion-v3/adapters/index.js +1 -0
  30. package/dist/conversion/conversion-v3/adapters/v3-to-standard-adapter.d.ts +38 -0
  31. package/dist/conversion/conversion-v3/adapters/v3-to-standard-adapter.js +55 -0
  32. package/dist/conversion/conversion-v3/compatibility/compatibility-profiles.d.ts +22 -0
  33. package/dist/conversion/conversion-v3/compatibility/compatibility-profiles.js +84 -0
  34. package/dist/conversion/conversion-v3/compatibility/compatibility-stages.d.ts +4 -0
  35. package/dist/conversion/conversion-v3/compatibility/compatibility-stages.js +285 -0
  36. package/dist/conversion/conversion-v3/compatibility/index.d.ts +3 -0
  37. package/dist/conversion/conversion-v3/compatibility/index.js +2 -0
  38. package/dist/conversion/conversion-v3/config/default-configs.d.ts +48 -0
  39. package/dist/conversion/conversion-v3/config/default-configs.js +1083 -0
  40. package/dist/conversion/conversion-v3/config/index.d.ts +5 -0
  41. package/dist/conversion/conversion-v3/config/index.js +5 -0
  42. package/dist/conversion/conversion-v3/config/pipeline-config-manager.d.ts +49 -0
  43. package/dist/conversion/conversion-v3/config/pipeline-config-manager.js +65 -0
  44. package/dist/conversion/conversion-v3/index.d.ts +11 -0
  45. package/dist/conversion/conversion-v3/index.js +17 -0
  46. package/dist/conversion/conversion-v3/nodes/index.d.ts +56 -0
  47. package/dist/conversion/conversion-v3/nodes/index.js +149 -0
  48. package/dist/conversion/conversion-v3/nodes/input/anthropic-input-node.d.ts +25 -0
  49. package/dist/conversion/conversion-v3/nodes/input/anthropic-input-node.js +56 -0
  50. package/dist/conversion/conversion-v3/nodes/input/base-input-node.d.ts +75 -0
  51. package/dist/conversion/conversion-v3/nodes/input/base-input-node.js +237 -0
  52. package/dist/conversion/conversion-v3/nodes/input/chat-input-node.d.ts +25 -0
  53. package/dist/conversion/conversion-v3/nodes/input/chat-input-node.js +56 -0
  54. package/dist/conversion/conversion-v3/nodes/input/chat-shape-helpers.d.ts +4 -0
  55. package/dist/conversion/conversion-v3/nodes/input/chat-shape-helpers.js +197 -0
  56. package/dist/conversion/conversion-v3/nodes/input/gemini-input-node.d.ts +16 -0
  57. package/dist/conversion/conversion-v3/nodes/input/gemini-input-node.js +125 -0
  58. package/dist/conversion/conversion-v3/nodes/input/index.d.ts +8 -0
  59. package/dist/conversion/conversion-v3/nodes/input/index.js +8 -0
  60. package/dist/conversion/conversion-v3/nodes/input/input-decision.d.ts +46 -0
  61. package/dist/conversion/conversion-v3/nodes/input/input-decision.js +125 -0
  62. package/dist/conversion/conversion-v3/nodes/input/responses-input-node.d.ts +20 -0
  63. package/dist/conversion/conversion-v3/nodes/input/responses-input-node.js +51 -0
  64. package/dist/conversion/conversion-v3/nodes/output/anthropic-output-node.d.ts +71 -0
  65. package/dist/conversion/conversion-v3/nodes/output/anthropic-output-node.js +320 -0
  66. package/dist/conversion/conversion-v3/nodes/output/base-output-node.d.ts +116 -0
  67. package/dist/conversion/conversion-v3/nodes/output/base-output-node.js +512 -0
  68. package/dist/conversion/conversion-v3/nodes/output/index.d.ts +7 -0
  69. package/dist/conversion/conversion-v3/nodes/output/index.js +7 -0
  70. package/dist/conversion/conversion-v3/nodes/output/openai-output-node.d.ts +71 -0
  71. package/dist/conversion/conversion-v3/nodes/output/openai-output-node.js +293 -0
  72. package/dist/conversion/conversion-v3/nodes/output/output-decision.d.ts +68 -0
  73. package/dist/conversion/conversion-v3/nodes/output/output-decision.js +161 -0
  74. package/dist/conversion/conversion-v3/nodes/output/responses-output-node.d.ts +64 -0
  75. package/dist/conversion/conversion-v3/nodes/output/responses-output-node.js +323 -0
  76. package/dist/conversion/conversion-v3/nodes/process/base-process-node.d.ts +72 -0
  77. package/dist/conversion/conversion-v3/nodes/process/base-process-node.js +246 -0
  78. package/dist/conversion/conversion-v3/nodes/process/chat-process-node.d.ts +135 -0
  79. package/dist/conversion/conversion-v3/nodes/process/chat-process-node.js +854 -0
  80. package/dist/conversion/conversion-v3/nodes/process/compatibility-process-node.d.ts +29 -0
  81. package/dist/conversion/conversion-v3/nodes/process/compatibility-process-node.js +181 -0
  82. package/dist/conversion/conversion-v3/nodes/process/index.d.ts +10 -0
  83. package/dist/conversion/conversion-v3/nodes/process/index.js +10 -0
  84. package/dist/conversion/conversion-v3/nodes/process/passthrough-process-node.d.ts +59 -0
  85. package/dist/conversion/conversion-v3/nodes/process/passthrough-process-node.js +243 -0
  86. package/dist/conversion/conversion-v3/nodes/process/response-process-node.d.ts +17 -0
  87. package/dist/conversion/conversion-v3/nodes/process/response-process-node.js +213 -0
  88. package/dist/conversion/conversion-v3/nodes/process/tool-process-node.d.ts +26 -0
  89. package/dist/conversion/conversion-v3/nodes/process/tool-process-node.js +299 -0
  90. package/dist/conversion/conversion-v3/nodes/process/virtual-router-process-node.d.ts +40 -0
  91. package/dist/conversion/conversion-v3/nodes/process/virtual-router-process-node.js +430 -0
  92. package/dist/conversion/conversion-v3/nodes/response/anthropic-response-input-node.d.ts +12 -0
  93. package/dist/conversion/conversion-v3/nodes/response/anthropic-response-input-node.js +129 -0
  94. package/dist/conversion/conversion-v3/nodes/response/chat-to-responses-response-node.d.ts +15 -0
  95. package/dist/conversion/conversion-v3/nodes/response/chat-to-responses-response-node.js +57 -0
  96. package/dist/conversion/conversion-v3/nodes/response/index.d.ts +4 -0
  97. package/dist/conversion/conversion-v3/nodes/response/index.js +4 -0
  98. package/dist/conversion/conversion-v3/nodes/response/openai-response-input-node.d.ts +15 -0
  99. package/dist/conversion/conversion-v3/nodes/response/openai-response-input-node.js +87 -0
  100. package/dist/conversion/conversion-v3/nodes/response/response-utils.d.ts +1 -0
  101. package/dist/conversion/conversion-v3/nodes/response/response-utils.js +1 -0
  102. package/dist/conversion/conversion-v3/nodes/response/responses-response-input-node.d.ts +12 -0
  103. package/dist/conversion/conversion-v3/nodes/response/responses-response-input-node.js +67 -0
  104. package/dist/conversion/conversion-v3/nodes/sse/index.d.ts +3 -0
  105. package/dist/conversion/conversion-v3/nodes/sse/index.js +3 -0
  106. package/dist/conversion/conversion-v3/nodes/sse/sse-input-node.d.ts +27 -0
  107. package/dist/conversion/conversion-v3/nodes/sse/sse-input-node.js +165 -0
  108. package/dist/conversion/conversion-v3/nodes/sse/sse-output-node.d.ts +19 -0
  109. package/dist/conversion/conversion-v3/nodes/sse/sse-output-node.js +267 -0
  110. package/dist/conversion/conversion-v3/nodes/sse/sse-passthrough-node.d.ts +18 -0
  111. package/dist/conversion/conversion-v3/nodes/sse/sse-passthrough-node.js +48 -0
  112. package/dist/conversion/conversion-v3/pipelines/index.d.ts +6 -0
  113. package/dist/conversion/conversion-v3/pipelines/index.js +6 -0
  114. package/dist/conversion/conversion-v3/pipelines/super-pipeline.d.ts +112 -0
  115. package/dist/conversion/conversion-v3/pipelines/super-pipeline.js +566 -0
  116. package/dist/conversion/conversion-v3/response/provider-response-converter.d.ts +28 -0
  117. package/dist/conversion/conversion-v3/response/provider-response-converter.js +249 -0
  118. package/dist/conversion/conversion-v3/sse/index.d.ts +140 -0
  119. package/dist/conversion/conversion-v3/sse/index.js +115 -0
  120. package/dist/conversion/conversion-v3/sse/json-to-sse/anthropic-json-to-sse-converter.d.ts +11 -0
  121. package/dist/conversion/conversion-v3/sse/json-to-sse/anthropic-json-to-sse-converter.js +79 -0
  122. package/dist/conversion/conversion-v3/sse/json-to-sse/chat-json-to-sse-converter.d.ts +79 -0
  123. package/dist/conversion/conversion-v3/sse/json-to-sse/chat-json-to-sse-converter.js +296 -0
  124. package/dist/conversion/conversion-v3/sse/json-to-sse/event-generators/chat.d.ts +55 -0
  125. package/dist/conversion/conversion-v3/sse/json-to-sse/event-generators/chat.js +233 -0
  126. package/dist/conversion/conversion-v3/sse/json-to-sse/event-generators/responses.d.ts +99 -0
  127. package/dist/conversion/conversion-v3/sse/json-to-sse/event-generators/responses.js +599 -0
  128. package/dist/conversion/conversion-v3/sse/json-to-sse/index.d.ts +6 -0
  129. package/dist/conversion/conversion-v3/sse/json-to-sse/index.js +7 -0
  130. package/dist/conversion/conversion-v3/sse/json-to-sse/responses-json-to-sse-converter.d.ts +79 -0
  131. package/dist/conversion/conversion-v3/sse/json-to-sse/responses-json-to-sse-converter.js +322 -0
  132. package/dist/conversion/conversion-v3/sse/json-to-sse/sequencers/chat-sequencer.d.ts +37 -0
  133. package/dist/conversion/conversion-v3/sse/json-to-sse/sequencers/chat-sequencer.js +218 -0
  134. package/dist/conversion/conversion-v3/sse/json-to-sse/sequencers/responses-sequencer.d.ts +40 -0
  135. package/dist/conversion/conversion-v3/sse/json-to-sse/sequencers/responses-sequencer.js +263 -0
  136. package/dist/conversion/conversion-v3/sse/registry/sse-codec-registry.d.ts +32 -0
  137. package/dist/conversion/conversion-v3/sse/registry/sse-codec-registry.js +106 -0
  138. package/dist/conversion/conversion-v3/sse/shared/chat-serializer.d.ts +4 -0
  139. package/dist/conversion/conversion-v3/sse/shared/chat-serializer.js +40 -0
  140. package/dist/conversion/conversion-v3/sse/shared/constants.d.ts +272 -0
  141. package/dist/conversion/conversion-v3/sse/shared/constants.js +321 -0
  142. package/dist/conversion/conversion-v3/sse/shared/serializers/base-serializer.d.ts +158 -0
  143. package/dist/conversion/conversion-v3/sse/shared/serializers/base-serializer.js +210 -0
  144. package/dist/conversion/conversion-v3/sse/shared/serializers/chat-event-serializer.d.ts +82 -0
  145. package/dist/conversion/conversion-v3/sse/shared/serializers/chat-event-serializer.js +275 -0
  146. package/dist/conversion/conversion-v3/sse/shared/serializers/index.d.ts +39 -0
  147. package/dist/conversion/conversion-v3/sse/shared/serializers/index.js +54 -0
  148. package/dist/conversion/conversion-v3/sse/shared/serializers/responses-event-serializer.d.ts +123 -0
  149. package/dist/conversion/conversion-v3/sse/shared/serializers/responses-event-serializer.js +356 -0
  150. package/dist/conversion/conversion-v3/sse/shared/serializers/types.d.ts +51 -0
  151. package/dist/conversion/conversion-v3/sse/shared/serializers/types.js +4 -0
  152. package/dist/conversion/conversion-v3/sse/shared/utils.d.ts +254 -0
  153. package/dist/conversion/conversion-v3/sse/shared/utils.js +543 -0
  154. package/dist/conversion/conversion-v3/sse/shared/writer.d.ts +111 -0
  155. package/dist/conversion/conversion-v3/sse/shared/writer.js +268 -0
  156. package/dist/conversion/conversion-v3/sse/sse-to-json/anthropic-sse-to-json-converter.d.ts +13 -0
  157. package/dist/conversion/conversion-v3/sse/sse-to-json/anthropic-sse-to-json-converter.js +139 -0
  158. package/dist/conversion/conversion-v3/sse/sse-to-json/builders/response-builder.d.ts +165 -0
  159. package/dist/conversion/conversion-v3/sse/sse-to-json/builders/response-builder.js +776 -0
  160. package/dist/conversion/conversion-v3/sse/sse-to-json/chat-sse-to-json-converter.d.ts +106 -0
  161. package/dist/conversion/conversion-v3/sse/sse-to-json/chat-sse-to-json-converter.js +540 -0
  162. package/dist/conversion/conversion-v3/sse/sse-to-json/index.d.ts +6 -0
  163. package/dist/conversion/conversion-v3/sse/sse-to-json/index.js +7 -0
  164. package/dist/conversion/conversion-v3/sse/sse-to-json/parsers/sse-parser.d.ts +73 -0
  165. package/dist/conversion/conversion-v3/sse/sse-to-json/parsers/sse-parser.js +332 -0
  166. package/dist/conversion/conversion-v3/sse/sse-to-json/responses-sse-to-json-converter.d.ts +59 -0
  167. package/dist/conversion/conversion-v3/sse/sse-to-json/responses-sse-to-json-converter.js +270 -0
  168. package/dist/conversion/conversion-v3/sse/types/anthropic-types.d.ts +87 -0
  169. package/dist/conversion/conversion-v3/sse/types/anthropic-types.js +5 -0
  170. package/dist/conversion/conversion-v3/sse/types/chat-types.d.ts +308 -0
  171. package/dist/conversion/conversion-v3/sse/types/chat-types.js +32 -0
  172. package/dist/conversion/conversion-v3/sse/types/conversion-context.d.ts +211 -0
  173. package/dist/conversion/conversion-v3/sse/types/conversion-context.js +20 -0
  174. package/dist/conversion/conversion-v3/sse/types/core-interfaces.d.ts +90 -0
  175. package/dist/conversion/conversion-v3/sse/types/core-interfaces.js +5 -0
  176. package/dist/conversion/conversion-v3/sse/types/index.d.ts +14 -0
  177. package/dist/conversion/conversion-v3/sse/types/index.js +7 -0
  178. package/dist/conversion/conversion-v3/sse/types/responses-types.d.ts +328 -0
  179. package/dist/conversion/conversion-v3/sse/types/responses-types.js +38 -0
  180. package/dist/conversion/conversion-v3/sse/types/sse-events.d.ts +180 -0
  181. package/dist/conversion/conversion-v3/sse/types/sse-events.js +150 -0
  182. package/dist/conversion/conversion-v3/sse/types/stream-state.d.ts +204 -0
  183. package/dist/conversion/conversion-v3/sse/types/stream-state.js +44 -0
  184. package/dist/conversion/conversion-v3/sse/types/utility-types.d.ts +230 -0
  185. package/dist/conversion/conversion-v3/sse/types/utility-types.js +49 -0
  186. package/dist/conversion/conversion-v3/standards/context-adapter.d.ts +146 -0
  187. package/dist/conversion/conversion-v3/standards/context-adapter.js +438 -0
  188. package/dist/conversion/conversion-v3/standards/errors.d.ts +38 -0
  189. package/dist/conversion/conversion-v3/standards/errors.js +27 -0
  190. package/dist/conversion/conversion-v3/standards/index.d.ts +15 -0
  191. package/dist/conversion/conversion-v3/standards/index.js +11 -0
  192. package/dist/conversion/conversion-v3/standards/node-capabilities.d.ts +123 -0
  193. package/dist/conversion/conversion-v3/standards/node-capabilities.js +330 -0
  194. package/dist/conversion/conversion-v3/standards/pipeline-context.d.ts +237 -0
  195. package/dist/conversion/conversion-v3/standards/pipeline-context.js +84 -0
  196. package/dist/conversion/conversion-v3/standards/pipeline-node.d.ts +196 -0
  197. package/dist/conversion/conversion-v3/standards/pipeline-node.js +316 -0
  198. package/dist/conversion/conversion-v3/standards/snapshot-handles.d.ts +24 -0
  199. package/dist/conversion/conversion-v3/standards/snapshot-handles.js +49 -0
  200. package/dist/conversion/conversion-v3/types/config-types.d.ts +242 -0
  201. package/dist/conversion/conversion-v3/types/config-types.js +13 -0
  202. package/dist/conversion/conversion-v3/types/index.d.ts +8 -0
  203. package/dist/conversion/conversion-v3/types/index.js +11 -0
  204. package/dist/conversion/conversion-v3/types/node-types.d.ts +211 -0
  205. package/dist/conversion/conversion-v3/types/node-types.js +20 -0
  206. package/dist/conversion/conversion-v3/types/pipeline-types.d.ts +246 -0
  207. package/dist/conversion/conversion-v3/types/pipeline-types.js +26 -0
  208. package/dist/conversion/conversion-v3/types/request-types.d.ts +293 -0
  209. package/dist/conversion/conversion-v3/types/request-types.js +26 -0
  210. package/dist/conversion/conversion-v3/utils/provider-payload-sanitizer.d.ts +10 -0
  211. package/dist/conversion/conversion-v3/utils/provider-payload-sanitizer.js +103 -0
  212. package/dist/conversion/conversion-v3/validations/index.d.ts +8 -0
  213. package/dist/conversion/conversion-v3/validations/index.js +7 -0
  214. package/dist/conversion/conversion-v3/validations/node-graph-validator.d.ts +116 -0
  215. package/dist/conversion/conversion-v3/validations/node-graph-validator.js +505 -0
  216. package/dist/conversion/conversion-v3/validations/tool-governance-enforcer.d.ts +139 -0
  217. package/dist/conversion/conversion-v3/validations/tool-governance-enforcer.js +338 -0
  218. package/dist/conversion/hub/config/types.d.ts +26 -0
  219. package/dist/conversion/hub/config/types.js +1 -0
  220. package/dist/conversion/hub/core/detour-registry.d.ts +9 -0
  221. package/dist/conversion/hub/core/detour-registry.js +23 -0
  222. package/dist/conversion/hub/core/hub-context.d.ts +21 -0
  223. package/dist/conversion/hub/core/hub-context.js +1 -0
  224. package/dist/conversion/hub/core/index.d.ts +3 -0
  225. package/dist/conversion/hub/core/index.js +3 -0
  226. package/dist/conversion/hub/core/stage-driver.d.ts +30 -0
  227. package/dist/conversion/hub/core/stage-driver.js +31 -0
  228. package/dist/conversion/hub/format-adapters/anthropic-format-adapter.d.ts +16 -0
  229. package/dist/conversion/hub/format-adapters/anthropic-format-adapter.js +23 -0
  230. package/dist/conversion/hub/format-adapters/chat-format-adapter.d.ts +17 -0
  231. package/dist/conversion/hub/format-adapters/chat-format-adapter.js +23 -0
  232. package/dist/conversion/hub/format-adapters/gemini-format-adapter.d.ts +16 -0
  233. package/dist/conversion/hub/format-adapters/gemini-format-adapter.js +23 -0
  234. package/dist/conversion/hub/format-adapters/index.d.ts +21 -0
  235. package/dist/conversion/hub/format-adapters/index.js +4 -0
  236. package/dist/conversion/hub/format-adapters/responses-format-adapter.d.ts +17 -0
  237. package/dist/conversion/hub/format-adapters/responses-format-adapter.js +23 -0
  238. package/dist/conversion/hub/hub-feature.d.ts +1 -0
  239. package/dist/conversion/hub/hub-feature.js +25 -0
  240. package/dist/conversion/hub/node-support.d.ts +19 -0
  241. package/dist/conversion/hub/node-support.js +115 -0
  242. package/dist/conversion/hub/pipeline/hub-pipeline.d.ts +68 -0
  243. package/dist/conversion/hub/pipeline/hub-pipeline.js +421 -0
  244. package/dist/conversion/hub/pipelines/inbound.d.ts +22 -0
  245. package/dist/conversion/hub/pipelines/inbound.js +64 -0
  246. package/dist/conversion/hub/pipelines/outbound.d.ts +22 -0
  247. package/dist/conversion/hub/pipelines/outbound.js +57 -0
  248. package/dist/conversion/hub/process/chat-process.d.ts +13 -0
  249. package/dist/conversion/hub/process/chat-process.js +50 -0
  250. package/dist/conversion/hub/registry.d.ts +28 -0
  251. package/dist/conversion/hub/registry.js +98 -0
  252. package/dist/conversion/hub/response/chat-response-utils.d.ts +6 -0
  253. package/dist/conversion/hub/response/chat-response-utils.js +89 -0
  254. package/dist/conversion/hub/response/provider-response.d.ts +20 -0
  255. package/dist/conversion/hub/response/provider-response.js +196 -0
  256. package/dist/conversion/hub/response/response-mappers.d.ts +19 -0
  257. package/dist/conversion/hub/response/response-mappers.js +23 -0
  258. package/dist/conversion/hub/response/response-runtime.d.ts +3 -0
  259. package/dist/conversion/hub/response/response-runtime.js +206 -0
  260. package/dist/conversion/hub/semantic-mappers/anthropic-mapper.d.ts +7 -0
  261. package/dist/conversion/hub/semantic-mappers/anthropic-mapper.js +308 -0
  262. package/dist/conversion/hub/semantic-mappers/chat-mapper.d.ts +7 -0
  263. package/dist/conversion/hub/semantic-mappers/chat-mapper.js +304 -0
  264. package/dist/conversion/hub/semantic-mappers/gemini-mapper.d.ts +7 -0
  265. package/dist/conversion/hub/semantic-mappers/gemini-mapper.js +477 -0
  266. package/dist/conversion/hub/semantic-mappers/index.d.ts +4 -0
  267. package/dist/conversion/hub/semantic-mappers/index.js +4 -0
  268. package/dist/conversion/hub/semantic-mappers/responses-mapper.d.ts +21 -0
  269. package/dist/conversion/hub/semantic-mappers/responses-mapper.js +379 -0
  270. package/dist/conversion/hub/snapshot-recorder.d.ts +12 -0
  271. package/dist/conversion/hub/snapshot-recorder.js +69 -0
  272. package/dist/conversion/hub/standardized-bridge.d.ts +12 -0
  273. package/dist/conversion/hub/standardized-bridge.js +248 -0
  274. package/dist/conversion/hub/types/chat-envelope.d.ts +67 -0
  275. package/dist/conversion/hub/types/chat-envelope.js +1 -0
  276. package/dist/conversion/hub/types/chat-schema.d.ts +112 -0
  277. package/dist/conversion/hub/types/chat-schema.js +1 -0
  278. package/dist/conversion/hub/types/errors.d.ts +5 -0
  279. package/dist/conversion/hub/types/errors.js +13 -0
  280. package/dist/conversion/hub/types/format-envelope.d.ts +7 -0
  281. package/dist/conversion/hub/types/format-envelope.js +1 -0
  282. package/dist/conversion/hub/types/index.d.ts +6 -0
  283. package/dist/conversion/hub/types/index.js +6 -0
  284. package/dist/conversion/hub/types/json.d.ts +9 -0
  285. package/dist/conversion/hub/types/json.js +9 -0
  286. package/dist/conversion/hub/types/node.d.ts +31 -0
  287. package/dist/conversion/hub/types/node.js +1 -0
  288. package/dist/conversion/hub/types/standardized.d.ts +94 -0
  289. package/dist/conversion/hub/types/standardized.js +1 -0
  290. package/dist/conversion/index.d.ts +28 -0
  291. package/dist/conversion/index.js +28 -0
  292. package/dist/conversion/responses/responses-openai-bridge.d.ts +95 -0
  293. package/dist/conversion/responses/responses-openai-bridge.js +1330 -0
  294. package/dist/conversion/schema-validator.d.ts +7 -0
  295. package/dist/conversion/schema-validator.js +67 -0
  296. package/dist/conversion/shared/args-mapping.d.ts +18 -0
  297. package/dist/conversion/shared/args-mapping.js +213 -0
  298. package/dist/conversion/shared/chat-request-filters.d.ts +9 -0
  299. package/dist/conversion/shared/chat-request-filters.js +74 -0
  300. package/dist/conversion/shared/jsonish.d.ts +3 -0
  301. package/dist/conversion/shared/jsonish.js +177 -0
  302. package/dist/conversion/shared/mcp-injection.d.ts +2 -0
  303. package/dist/conversion/shared/mcp-injection.js +89 -0
  304. package/dist/conversion/shared/media.d.ts +1 -0
  305. package/dist/conversion/shared/media.js +9 -0
  306. package/dist/conversion/shared/openai-finalizer.d.ts +9 -0
  307. package/dist/conversion/shared/openai-finalizer.js +104 -0
  308. package/dist/conversion/shared/openai-message-normalize.d.ts +1 -0
  309. package/dist/conversion/shared/openai-message-normalize.js +442 -0
  310. package/dist/conversion/shared/payload-budget.d.ts +13 -0
  311. package/dist/conversion/shared/payload-budget.js +248 -0
  312. package/dist/conversion/shared/reasoning-mapping.d.ts +5 -0
  313. package/dist/conversion/shared/reasoning-mapping.js +8 -0
  314. package/dist/conversion/shared/responses-conversation-store.d.ts +41 -0
  315. package/dist/conversion/shared/responses-conversation-store.js +285 -0
  316. package/dist/conversion/shared/responses-id-utils.d.ts +7 -0
  317. package/dist/conversion/shared/responses-id-utils.js +29 -0
  318. package/dist/conversion/shared/responses-instructions.d.ts +1 -0
  319. package/dist/conversion/shared/responses-instructions.js +113 -0
  320. package/dist/conversion/shared/responses-metadata.d.ts +1 -0
  321. package/dist/conversion/shared/responses-metadata.js +1 -0
  322. package/dist/conversion/shared/responses-request-adapter.d.ts +66 -0
  323. package/dist/conversion/shared/responses-request-adapter.js +461 -0
  324. package/dist/conversion/shared/snapshot-hooks.d.ts +12 -0
  325. package/dist/conversion/shared/snapshot-hooks.js +7 -0
  326. package/dist/conversion/shared/streaming-text-extractor.d.ts +26 -0
  327. package/dist/conversion/shared/streaming-text-extractor.js +145 -0
  328. package/dist/conversion/shared/text-markup-normalizer.d.ts +9 -0
  329. package/dist/conversion/shared/text-markup-normalizer.js +319 -0
  330. package/dist/conversion/shared/tool-canonicalizer.d.ts +2 -0
  331. package/dist/conversion/shared/tool-canonicalizer.js +50 -0
  332. package/dist/conversion/shared/tool-filter-pipeline.d.ts +17 -0
  333. package/dist/conversion/shared/tool-filter-pipeline.js +79 -0
  334. package/dist/conversion/shared/tool-governor.d.ts +27 -0
  335. package/dist/conversion/shared/tool-governor.js +269 -0
  336. package/dist/conversion/shared/tool-harvester.d.ts +31 -0
  337. package/dist/conversion/shared/tool-harvester.js +321 -0
  338. package/dist/conversion/shared/tool-mapping.d.ts +10 -0
  339. package/dist/conversion/shared/tool-mapping.js +10 -0
  340. package/dist/conversion/shared/tooling.d.ts +26 -0
  341. package/dist/conversion/shared/tooling.js +143 -0
  342. package/dist/conversion/types.d.ts +33 -0
  343. package/dist/conversion/types.js +1 -0
  344. package/dist/core/index.d.ts +6 -0
  345. package/dist/core/index.js +9 -0
  346. package/dist/core/llmswitch-engine-v2.d.ts +132 -0
  347. package/dist/core/llmswitch-engine-v2.js +649 -0
  348. package/dist/core/llmswitch-factory-v2.d.ts +123 -0
  349. package/dist/core/llmswitch-factory-v2.js +521 -0
  350. package/dist/endpoints/base-endpoint-handler.d.ts +128 -0
  351. package/dist/endpoints/base-endpoint-handler.js +545 -0
  352. package/dist/endpoints/chat-endpoint-handler.d.ts +115 -0
  353. package/dist/endpoints/chat-endpoint-handler.js +218 -0
  354. package/dist/endpoints/endpoint-router.d.ts +127 -0
  355. package/dist/endpoints/endpoint-router.js +438 -0
  356. package/dist/endpoints/index.d.ts +13 -0
  357. package/dist/endpoints/index.js +11 -0
  358. package/dist/endpoints/messages-endpoint-handler.d.ts +171 -0
  359. package/dist/endpoints/messages-endpoint-handler.js +238 -0
  360. package/dist/endpoints/responses-endpoint-handler.d.ts +147 -0
  361. package/dist/endpoints/responses-endpoint-handler.js +233 -0
  362. package/dist/filters/builtin/add-fields-filter.d.ts +8 -0
  363. package/dist/filters/builtin/add-fields-filter.js +16 -0
  364. package/dist/filters/builtin/blacklist-filter.d.ts +8 -0
  365. package/dist/filters/builtin/blacklist-filter.js +19 -0
  366. package/dist/filters/builtin/whitelist-filter.d.ts +8 -0
  367. package/dist/filters/builtin/whitelist-filter.js +19 -0
  368. package/dist/filters/engine.d.ts +16 -0
  369. package/dist/filters/engine.js +167 -0
  370. package/dist/filters/index.d.ts +19 -0
  371. package/dist/filters/index.js +24 -0
  372. package/dist/filters/special/request-streaming-to-nonstreaming.d.ts +12 -0
  373. package/dist/filters/special/request-streaming-to-nonstreaming.js +27 -0
  374. package/dist/filters/special/request-tool-choice-policy.d.ts +11 -0
  375. package/dist/filters/special/request-tool-choice-policy.js +27 -0
  376. package/dist/filters/special/request-tool-list-filter.d.ts +11 -0
  377. package/dist/filters/special/request-tool-list-filter.js +167 -0
  378. package/dist/filters/special/request-toolcalls-stringify.d.ts +10 -0
  379. package/dist/filters/special/request-toolcalls-stringify.js +44 -0
  380. package/dist/filters/special/request-tools-normalize.d.ts +12 -0
  381. package/dist/filters/special/request-tools-normalize.js +140 -0
  382. package/dist/filters/special/response-finish-invariants.d.ts +11 -0
  383. package/dist/filters/special/response-finish-invariants.js +30 -0
  384. package/dist/filters/special/response-openai-to-responses-bridge.d.ts +13 -0
  385. package/dist/filters/special/response-openai-to-responses-bridge.js +24 -0
  386. package/dist/filters/special/response-tool-arguments-blacklist.d.ts +12 -0
  387. package/dist/filters/special/response-tool-arguments-blacklist.js +63 -0
  388. package/dist/filters/special/response-tool-arguments-schema-converge.d.ts +13 -0
  389. package/dist/filters/special/response-tool-arguments-schema-converge.js +63 -0
  390. package/dist/filters/special/response-tool-arguments-stringify.d.ts +9 -0
  391. package/dist/filters/special/response-tool-arguments-stringify.js +134 -0
  392. package/dist/filters/special/response-tool-arguments-toon-decode.d.ts +10 -0
  393. package/dist/filters/special/response-tool-arguments-toon-decode.js +94 -0
  394. package/dist/filters/special/response-tool-arguments-whitelist.d.ts +11 -0
  395. package/dist/filters/special/response-tool-arguments-whitelist.js +56 -0
  396. package/dist/filters/special/response-tool-text-canonicalize.d.ts +10 -0
  397. package/dist/filters/special/response-tool-text-canonicalize.js +20 -0
  398. package/dist/filters/special/tool-filter-hooks.d.ts +19 -0
  399. package/dist/filters/special/tool-filter-hooks.js +341 -0
  400. package/dist/filters/special/tool-post-constraints.d.ts +31 -0
  401. package/dist/filters/special/tool-post-constraints.js +120 -0
  402. package/dist/filters/types.d.ts +68 -0
  403. package/dist/filters/types.js +3 -0
  404. package/dist/filters/utils/fieldmap-loader.d.ts +2 -0
  405. package/dist/filters/utils/fieldmap-loader.js +16 -0
  406. package/dist/filters/utils/snapshot-writer.d.ts +10 -0
  407. package/dist/filters/utils/snapshot-writer.js +47 -0
  408. package/dist/guidance/index.d.ts +3 -0
  409. package/dist/guidance/index.js +228 -0
  410. package/dist/hooks/hooks-integration.d.ts +161 -0
  411. package/dist/hooks/hooks-integration.js +519 -0
  412. package/dist/hooks/index.d.ts +10 -0
  413. package/dist/hooks/index.js +13 -0
  414. package/dist/html-to-markdown.d.ts +5 -0
  415. package/dist/html-to-markdown.js +66 -0
  416. package/dist/http/sse-response.d.ts +22 -0
  417. package/dist/http/sse-response.js +103 -0
  418. package/dist/index.d.ts +10 -0
  419. package/dist/index.js +10 -0
  420. package/dist/router/virtual-router/bootstrap.d.ts +6 -0
  421. package/dist/router/virtual-router/bootstrap.js +620 -0
  422. package/dist/router/virtual-router/classifier.d.ts +10 -0
  423. package/dist/router/virtual-router/classifier.js +99 -0
  424. package/dist/router/virtual-router/engine.d.ts +35 -0
  425. package/dist/router/virtual-router/engine.js +260 -0
  426. package/dist/router/virtual-router/error-center.d.ts +10 -0
  427. package/dist/router/virtual-router/error-center.js +39 -0
  428. package/dist/router/virtual-router/features.d.ts +3 -0
  429. package/dist/router/virtual-router/features.js +162 -0
  430. package/dist/router/virtual-router/health-manager.d.ts +18 -0
  431. package/dist/router/virtual-router/health-manager.js +98 -0
  432. package/dist/router/virtual-router/load-balancer.d.ts +18 -0
  433. package/dist/router/virtual-router/load-balancer.js +67 -0
  434. package/dist/router/virtual-router/provider-registry.d.ts +11 -0
  435. package/dist/router/virtual-router/provider-registry.js +74 -0
  436. package/dist/router/virtual-router/types.d.ts +206 -0
  437. package/dist/router/virtual-router/types.js +31 -0
  438. package/dist/sse/index.d.ts +140 -0
  439. package/dist/sse/index.js +115 -0
  440. package/dist/sse/json-to-sse/anthropic-json-to-sse-converter.d.ts +11 -0
  441. package/dist/sse/json-to-sse/anthropic-json-to-sse-converter.js +79 -0
  442. package/dist/sse/json-to-sse/chat-json-to-sse-converter.d.ts +79 -0
  443. package/dist/sse/json-to-sse/chat-json-to-sse-converter.js +296 -0
  444. package/dist/sse/json-to-sse/event-generators/chat.d.ts +55 -0
  445. package/dist/sse/json-to-sse/event-generators/chat.js +233 -0
  446. package/dist/sse/json-to-sse/event-generators/responses.d.ts +99 -0
  447. package/dist/sse/json-to-sse/event-generators/responses.js +599 -0
  448. package/dist/sse/json-to-sse/index.d.ts +6 -0
  449. package/dist/sse/json-to-sse/index.js +7 -0
  450. package/dist/sse/json-to-sse/responses-json-to-sse-converter.d.ts +79 -0
  451. package/dist/sse/json-to-sse/responses-json-to-sse-converter.js +322 -0
  452. package/dist/sse/json-to-sse/sequencers/chat-sequencer.d.ts +37 -0
  453. package/dist/sse/json-to-sse/sequencers/chat-sequencer.js +218 -0
  454. package/dist/sse/json-to-sse/sequencers/responses-sequencer.d.ts +40 -0
  455. package/dist/sse/json-to-sse/sequencers/responses-sequencer.js +263 -0
  456. package/dist/sse/registry/sse-codec-registry.d.ts +32 -0
  457. package/dist/sse/registry/sse-codec-registry.js +106 -0
  458. package/dist/sse/shared/chat-serializer.d.ts +4 -0
  459. package/dist/sse/shared/chat-serializer.js +40 -0
  460. package/dist/sse/shared/constants.d.ts +272 -0
  461. package/dist/sse/shared/constants.js +321 -0
  462. package/dist/sse/shared/serializers/base-serializer.d.ts +158 -0
  463. package/dist/sse/shared/serializers/base-serializer.js +210 -0
  464. package/dist/sse/shared/serializers/chat-event-serializer.d.ts +82 -0
  465. package/dist/sse/shared/serializers/chat-event-serializer.js +275 -0
  466. package/dist/sse/shared/serializers/index.d.ts +39 -0
  467. package/dist/sse/shared/serializers/index.js +54 -0
  468. package/dist/sse/shared/serializers/responses-event-serializer.d.ts +123 -0
  469. package/dist/sse/shared/serializers/responses-event-serializer.js +356 -0
  470. package/dist/sse/shared/serializers/types.d.ts +51 -0
  471. package/dist/sse/shared/serializers/types.js +4 -0
  472. package/dist/sse/shared/utils.d.ts +254 -0
  473. package/dist/sse/shared/utils.js +543 -0
  474. package/dist/sse/shared/writer.d.ts +111 -0
  475. package/dist/sse/shared/writer.js +268 -0
  476. package/dist/sse/sse-to-json/anthropic-sse-to-json-converter.d.ts +13 -0
  477. package/dist/sse/sse-to-json/anthropic-sse-to-json-converter.js +139 -0
  478. package/dist/sse/sse-to-json/builders/response-builder.d.ts +165 -0
  479. package/dist/sse/sse-to-json/builders/response-builder.js +776 -0
  480. package/dist/sse/sse-to-json/chat-sse-to-json-converter.d.ts +106 -0
  481. package/dist/sse/sse-to-json/chat-sse-to-json-converter.js +540 -0
  482. package/dist/sse/sse-to-json/index.d.ts +6 -0
  483. package/dist/sse/sse-to-json/index.js +7 -0
  484. package/dist/sse/sse-to-json/parsers/sse-parser.d.ts +73 -0
  485. package/dist/sse/sse-to-json/parsers/sse-parser.js +340 -0
  486. package/dist/sse/sse-to-json/responses-sse-to-json-converter.d.ts +59 -0
  487. package/dist/sse/sse-to-json/responses-sse-to-json-converter.js +270 -0
  488. package/dist/sse/types/anthropic-types.d.ts +87 -0
  489. package/dist/sse/types/anthropic-types.js +5 -0
  490. package/dist/sse/types/chat-types.d.ts +308 -0
  491. package/dist/sse/types/chat-types.js +32 -0
  492. package/dist/sse/types/conversion-context.d.ts +211 -0
  493. package/dist/sse/types/conversion-context.js +20 -0
  494. package/dist/sse/types/core-interfaces.d.ts +90 -0
  495. package/dist/sse/types/core-interfaces.js +5 -0
  496. package/dist/sse/types/index.d.ts +14 -0
  497. package/dist/sse/types/index.js +7 -0
  498. package/dist/sse/types/responses-types.d.ts +328 -0
  499. package/dist/sse/types/responses-types.js +38 -0
  500. package/dist/sse/types/sse-events.d.ts +180 -0
  501. package/dist/sse/types/sse-events.js +150 -0
  502. package/dist/sse/types/stream-state.d.ts +204 -0
  503. package/dist/sse/types/stream-state.js +44 -0
  504. package/dist/sse/types/utility-types.d.ts +230 -0
  505. package/dist/sse/types/utility-types.js +49 -0
  506. package/dist/tools/proxy/anthropic-tool-proxy.d.ts +19 -0
  507. package/dist/tools/proxy/anthropic-tool-proxy.js +57 -0
  508. package/dist/tools/proxy/executors/web-fetch.d.ts +6 -0
  509. package/dist/tools/proxy/executors/web-fetch.js +39 -0
  510. package/dist/tools/proxy/registry.d.ts +8 -0
  511. package/dist/tools/proxy/registry.js +14 -0
  512. package/dist/tools/proxy/types.d.ts +29 -0
  513. package/dist/tools/proxy/types.js +1 -0
  514. package/dist/tools/tool-registry.d.ts +8 -0
  515. package/dist/tools/tool-registry.js +154 -0
  516. package/dist/tools/web-fetch-html.d.ts +15 -0
  517. package/dist/tools/web-fetch-html.js +83 -0
  518. package/dist/utils/conversion-adapter.d.ts +65 -0
  519. package/dist/utils/conversion-adapter.js +183 -0
  520. package/dist/utils/error-factory.d.ts +88 -0
  521. package/dist/utils/error-factory.js +138 -0
  522. package/dist/utils/error-utils.d.ts +334 -0
  523. package/dist/utils/error-utils.js +782 -0
  524. package/dist/utils/index.d.ts +8 -0
  525. package/dist/utils/index.js +13 -0
  526. package/dist/utils/performance-utils.d.ts +205 -0
  527. package/dist/utils/performance-utils.js +440 -0
  528. package/dist/utils/profile-mapper.d.ts +32 -0
  529. package/dist/utils/profile-mapper.js +269 -0
  530. package/dist/utils/request-processor.d.ts +52 -0
  531. package/dist/utils/request-processor.js +210 -0
  532. package/dist/utils/request-utils.d.ts +117 -0
  533. package/dist/utils/request-utils.js +333 -0
  534. package/dist/utils/response-utils.d.ts +127 -0
  535. package/dist/utils/response-utils.js +516 -0
  536. package/dist/utils/token-counter.d.ts +89 -0
  537. package/dist/utils/token-counter.js +541 -0
  538. package/package.json +65 -0
@@ -0,0 +1,98 @@
1
+ const DEFAULT_CONFIG = {
2
+ failureThreshold: 3,
3
+ cooldownMs: 30_000,
4
+ fatalCooldownMs: 120_000
5
+ };
6
+ export class ProviderHealthManager {
7
+ states = new Map();
8
+ config = DEFAULT_CONFIG;
9
+ configure(config) {
10
+ if (config) {
11
+ const normalizedCooldown = Math.max(5_000, config.cooldownMs ?? DEFAULT_CONFIG.cooldownMs);
12
+ const fatalCooldownCandidate = config.fatalCooldownMs ?? DEFAULT_CONFIG.fatalCooldownMs ?? normalizedCooldown;
13
+ this.config = {
14
+ failureThreshold: Math.max(1, config.failureThreshold ?? DEFAULT_CONFIG.failureThreshold),
15
+ cooldownMs: normalizedCooldown,
16
+ fatalCooldownMs: Math.max(fatalCooldownCandidate, normalizedCooldown)
17
+ };
18
+ }
19
+ }
20
+ registerProviders(providerKeys) {
21
+ for (const key of providerKeys) {
22
+ if (!this.states.has(key)) {
23
+ this.states.set(key, {
24
+ providerKey: key,
25
+ state: 'healthy',
26
+ failureCount: 0
27
+ });
28
+ }
29
+ }
30
+ }
31
+ recordFailure(providerKey, reason) {
32
+ const state = this.getState(providerKey);
33
+ state.failureCount += 1;
34
+ state.lastFailureAt = Date.now();
35
+ if (reason) {
36
+ state.reason = reason;
37
+ }
38
+ if (state.failureCount >= this.config.failureThreshold) {
39
+ state.state = 'tripped';
40
+ state.cooldownExpiresAt = Date.now() + this.config.cooldownMs;
41
+ if (reason) {
42
+ state.reason = reason;
43
+ }
44
+ }
45
+ return state;
46
+ }
47
+ recordSuccess(providerKey) {
48
+ const state = this.getState(providerKey);
49
+ state.failureCount = 0;
50
+ state.state = 'healthy';
51
+ state.cooldownExpiresAt = undefined;
52
+ state.lastFailureAt = undefined;
53
+ state.reason = undefined;
54
+ return state;
55
+ }
56
+ tripProvider(providerKey, reason, cooldownOverrideMs) {
57
+ const state = this.getState(providerKey);
58
+ state.failureCount = Math.max(state.failureCount, this.config.failureThreshold);
59
+ state.state = 'tripped';
60
+ state.reason = reason;
61
+ const ttl = cooldownOverrideMs ?? this.config.fatalCooldownMs ?? this.config.cooldownMs;
62
+ state.cooldownExpiresAt = Date.now() + ttl;
63
+ state.lastFailureAt = Date.now();
64
+ return state;
65
+ }
66
+ isAvailable(providerKey) {
67
+ const state = this.getState(providerKey);
68
+ if (state.state === 'healthy') {
69
+ return true;
70
+ }
71
+ if (state.cooldownExpiresAt && Date.now() >= state.cooldownExpiresAt) {
72
+ this.recordSuccess(providerKey);
73
+ return true;
74
+ }
75
+ return false;
76
+ }
77
+ getSnapshot() {
78
+ return Array.from(this.states.values()).map((state) => ({
79
+ providerKey: state.providerKey,
80
+ state: state.state,
81
+ failureCount: state.failureCount,
82
+ cooldownExpiresAt: state.cooldownExpiresAt
83
+ }));
84
+ }
85
+ getConfig() {
86
+ return { ...this.config };
87
+ }
88
+ getState(providerKey) {
89
+ if (!this.states.has(providerKey)) {
90
+ this.states.set(providerKey, {
91
+ providerKey,
92
+ state: 'healthy',
93
+ failureCount: 0
94
+ });
95
+ }
96
+ return this.states.get(providerKey);
97
+ }
98
+ }
@@ -0,0 +1,18 @@
1
+ import type { LoadBalancingPolicy } from './types.js';
2
+ export interface LoadBalancingOptions {
3
+ routeName: string;
4
+ candidates: string[];
5
+ stickyKey?: string;
6
+ availabilityCheck: (providerKey: string) => boolean;
7
+ }
8
+ export declare class RouteLoadBalancer {
9
+ private policy;
10
+ private readonly states;
11
+ constructor(policy?: LoadBalancingPolicy);
12
+ updatePolicy(policy?: LoadBalancingPolicy): void;
13
+ select(options: LoadBalancingOptions): string | null;
14
+ private selectRoundRobin;
15
+ private selectWeighted;
16
+ private selectSticky;
17
+ private getState;
18
+ }
@@ -0,0 +1,67 @@
1
+ export class RouteLoadBalancer {
2
+ policy;
3
+ states = new Map();
4
+ constructor(policy) {
5
+ this.policy = policy ?? { strategy: 'round-robin' };
6
+ }
7
+ updatePolicy(policy) {
8
+ if (policy) {
9
+ this.policy = policy;
10
+ }
11
+ }
12
+ select(options) {
13
+ const available = options.candidates.filter((candidate) => options.availabilityCheck(candidate));
14
+ if (available.length === 0) {
15
+ return null;
16
+ }
17
+ switch (this.policy.strategy) {
18
+ case 'sticky':
19
+ return this.selectSticky(options.routeName, available, options.stickyKey);
20
+ case 'weighted':
21
+ return this.selectWeighted(available);
22
+ default:
23
+ return this.selectRoundRobin(options.routeName, available);
24
+ }
25
+ }
26
+ selectRoundRobin(routeName, candidates) {
27
+ const state = this.getState(routeName);
28
+ const choice = candidates[state.pointer % candidates.length];
29
+ state.pointer = (state.pointer + 1) % candidates.length;
30
+ return choice;
31
+ }
32
+ selectWeighted(candidates) {
33
+ if (!this.policy.weights) {
34
+ return candidates[0];
35
+ }
36
+ const weights = candidates.map((candidate) => Math.max(1, this.policy.weights?.[candidate] ?? 1));
37
+ const total = weights.reduce((sum, weight) => sum + weight, 0);
38
+ const threshold = Math.random() * total;
39
+ let running = 0;
40
+ for (let i = 0; i < candidates.length; i += 1) {
41
+ running += weights[i];
42
+ if (running >= threshold) {
43
+ return candidates[i];
44
+ }
45
+ }
46
+ return candidates[candidates.length - 1];
47
+ }
48
+ selectSticky(routeName, candidates, stickyKey) {
49
+ if (!stickyKey) {
50
+ return this.selectRoundRobin(routeName, candidates);
51
+ }
52
+ const state = this.getState(routeName);
53
+ const pinned = state.stickyMap.get(stickyKey);
54
+ if (pinned && candidates.includes(pinned)) {
55
+ return pinned;
56
+ }
57
+ const choice = this.selectRoundRobin(routeName, candidates);
58
+ state.stickyMap.set(stickyKey, choice);
59
+ return choice;
60
+ }
61
+ getState(routeName) {
62
+ if (!this.states.has(routeName)) {
63
+ this.states.set(routeName, { pointer: 0, stickyMap: new Map() });
64
+ }
65
+ return this.states.get(routeName);
66
+ }
67
+ }
@@ -0,0 +1,11 @@
1
+ import type { ProviderProfile, TargetMetadata } from './types.js';
2
+ export declare class ProviderRegistry {
3
+ private readonly providers;
4
+ constructor(profiles?: Record<string, ProviderProfile>);
5
+ load(profiles: Record<string, ProviderProfile>): void;
6
+ get(providerKey: string): ProviderProfile;
7
+ has(providerKey: string): boolean;
8
+ listKeys(): string[];
9
+ buildTarget(providerKey: string): TargetMetadata;
10
+ private static normalizeProfile;
11
+ }
@@ -0,0 +1,74 @@
1
+ import { VirtualRouterError, VirtualRouterErrorCode } from './types.js';
2
+ export class ProviderRegistry {
3
+ providers = new Map();
4
+ constructor(profiles) {
5
+ if (profiles) {
6
+ this.load(profiles);
7
+ }
8
+ }
9
+ load(profiles) {
10
+ this.providers.clear();
11
+ for (const [key, profile] of Object.entries(profiles)) {
12
+ const normalized = ProviderRegistry.normalizeProfile(key, profile);
13
+ this.providers.set(normalized.providerKey, normalized);
14
+ }
15
+ }
16
+ get(providerKey) {
17
+ const profile = this.providers.get(providerKey);
18
+ if (!profile) {
19
+ throw new VirtualRouterError(`Provider ${providerKey} is not registered`, VirtualRouterErrorCode.CONFIG_ERROR, {
20
+ providerKey
21
+ });
22
+ }
23
+ return profile;
24
+ }
25
+ has(providerKey) {
26
+ return this.providers.has(providerKey);
27
+ }
28
+ listKeys() {
29
+ return Array.from(this.providers.keys());
30
+ }
31
+ buildTarget(providerKey) {
32
+ const profile = this.get(providerKey);
33
+ const modelId = profile.modelId ?? deriveModelId(profile.providerKey);
34
+ if (!modelId) {
35
+ throw new VirtualRouterError(`Provider ${providerKey} is missing model identifier`, VirtualRouterErrorCode.CONFIG_ERROR, { providerKey });
36
+ }
37
+ return {
38
+ providerKey: profile.providerKey,
39
+ providerType: profile.providerType,
40
+ outboundProfile: profile.outboundProfile,
41
+ compatibilityProfile: profile.compatibilityProfile,
42
+ runtimeKey: profile.runtimeKey,
43
+ modelId,
44
+ processMode: profile.processMode || 'chat'
45
+ };
46
+ }
47
+ static normalizeProfile(key, profile) {
48
+ const providerKey = profile.providerKey ?? key;
49
+ const modelId = profile.modelId ?? deriveModelId(providerKey);
50
+ return {
51
+ providerKey,
52
+ providerType: profile.providerType,
53
+ endpoint: profile.endpoint,
54
+ auth: profile.auth,
55
+ outboundProfile: profile.outboundProfile,
56
+ compatibilityProfile: profile.compatibilityProfile,
57
+ runtimeKey: profile.runtimeKey,
58
+ modelId,
59
+ processMode: profile.processMode || 'chat'
60
+ };
61
+ }
62
+ }
63
+ function deriveModelId(providerKey) {
64
+ if (!providerKey)
65
+ return undefined;
66
+ const firstDot = providerKey.indexOf('.');
67
+ if (firstDot <= 0 || firstDot === providerKey.length - 1)
68
+ return undefined;
69
+ const remainder = providerKey.slice(firstDot + 1);
70
+ const secondDot = remainder.indexOf('.');
71
+ if (secondDot <= 0 || secondDot === remainder.length - 1)
72
+ return remainder.trim() || undefined;
73
+ return remainder.slice(secondDot + 1).trim() || undefined;
74
+ }
@@ -0,0 +1,206 @@
1
+ /**
2
+ * Virtual Router 类型定义
3
+ */
4
+ import type { StandardizedRequest } from '../../conversion/hub/types/standardized.js';
5
+ export declare const DEFAULT_ROUTE = "default";
6
+ export declare const ROUTE_PRIORITY: string[];
7
+ export type RoutingPools = Record<string, string[]>;
8
+ export interface ProviderAuthConfig {
9
+ type: 'apiKey' | 'oauth';
10
+ secretRef?: string;
11
+ value?: string;
12
+ tokenFile?: string;
13
+ tokenUrl?: string;
14
+ deviceCodeUrl?: string;
15
+ clientId?: string;
16
+ clientSecret?: string;
17
+ scopes?: string[];
18
+ authorizationUrl?: string;
19
+ userInfoUrl?: string;
20
+ refreshUrl?: string;
21
+ oauthProviderId?: string;
22
+ rawType?: string;
23
+ }
24
+ export interface ProviderProfile {
25
+ providerKey: string;
26
+ providerType: string;
27
+ endpoint: string;
28
+ auth: ProviderAuthConfig;
29
+ outboundProfile: string;
30
+ compatibilityProfile?: string;
31
+ runtimeKey?: string;
32
+ modelId?: string;
33
+ processMode?: 'chat' | 'passthrough';
34
+ }
35
+ export interface ProviderRuntimeProfile {
36
+ runtimeKey: string;
37
+ providerId: string;
38
+ keyAlias: string;
39
+ providerType: string;
40
+ endpoint: string;
41
+ headers?: Record<string, string>;
42
+ auth: ProviderAuthConfig;
43
+ outboundProfile: string;
44
+ compatibilityProfile?: string;
45
+ modelId?: string;
46
+ processMode?: 'chat' | 'passthrough';
47
+ }
48
+ export interface VirtualRouterClassifierConfig {
49
+ longContextThresholdTokens?: number;
50
+ thinkingKeywords?: string[];
51
+ codingKeywords?: string[];
52
+ backgroundKeywords?: string[];
53
+ visionKeywords?: string[];
54
+ }
55
+ export interface LoadBalancingPolicy {
56
+ strategy: 'round-robin' | 'weighted' | 'sticky';
57
+ weights?: Record<string, number>;
58
+ }
59
+ export interface ProviderHealthConfig {
60
+ failureThreshold: number;
61
+ cooldownMs: number;
62
+ fatalCooldownMs?: number;
63
+ }
64
+ export interface VirtualRouterConfig {
65
+ routing: RoutingPools;
66
+ providers: Record<string, ProviderProfile>;
67
+ classifier: VirtualRouterClassifierConfig;
68
+ loadBalancing?: LoadBalancingPolicy;
69
+ health?: ProviderHealthConfig;
70
+ }
71
+ export type VirtualRouterProviderDefinition = Record<string, unknown>;
72
+ export interface VirtualRouterBootstrapInput extends Record<string, unknown> {
73
+ virtualrouter?: Record<string, unknown>;
74
+ providers?: Record<string, VirtualRouterProviderDefinition>;
75
+ routing?: Record<string, unknown>;
76
+ classifier?: VirtualRouterClassifierConfig;
77
+ loadBalancing?: LoadBalancingPolicy;
78
+ health?: ProviderHealthConfig;
79
+ }
80
+ export type ProviderRuntimeMap = Record<string, ProviderRuntimeProfile>;
81
+ export interface VirtualRouterBootstrapResult {
82
+ config: VirtualRouterConfig;
83
+ runtime: ProviderRuntimeMap;
84
+ targetRuntime: Record<string, ProviderRuntimeProfile>;
85
+ providers: Record<string, ProviderProfile>;
86
+ routing: RoutingPools;
87
+ }
88
+ export interface RouterMetadataInput {
89
+ requestId: string;
90
+ entryEndpoint: string;
91
+ processMode: 'chat' | 'passthrough';
92
+ stream: boolean;
93
+ direction: 'request' | 'response';
94
+ providerProtocol?: string;
95
+ stage?: 'inbound' | 'outbound' | 'response';
96
+ routeHint?: string;
97
+ }
98
+ export interface RoutingFeatures {
99
+ requestId: string;
100
+ model: string;
101
+ totalMessages: number;
102
+ userTextSample: string;
103
+ toolCount: number;
104
+ hasTools: boolean;
105
+ hasToolCallResponses: boolean;
106
+ hasVisionTool: boolean;
107
+ hasImageAttachment: boolean;
108
+ hasWebTool: boolean;
109
+ hasCodingTool: boolean;
110
+ hasThinkingKeyword: boolean;
111
+ estimatedTokens: number;
112
+ metadata: RouterMetadataInput;
113
+ }
114
+ export interface ClassificationResult {
115
+ routeName: string;
116
+ confidence: number;
117
+ reasoning: string;
118
+ fallback: boolean;
119
+ candidates?: string[];
120
+ }
121
+ export interface RoutingDecision {
122
+ routeName: string;
123
+ providerKey: string;
124
+ confidence: number;
125
+ reasoning: string;
126
+ fallback: boolean;
127
+ pool: string[];
128
+ }
129
+ export interface TargetMetadata {
130
+ providerKey: string;
131
+ providerType: string;
132
+ outboundProfile: string;
133
+ compatibilityProfile?: string;
134
+ runtimeKey?: string;
135
+ modelId: string;
136
+ processMode?: 'chat' | 'passthrough';
137
+ }
138
+ export declare enum VirtualRouterErrorCode {
139
+ NO_STANDARDIZED_REQUEST = "NO_STANDARDIZED_REQUEST",
140
+ ROUTE_NOT_FOUND = "ROUTE_NOT_FOUND",
141
+ PROVIDER_NOT_AVAILABLE = "PROVIDER_NOT_AVAILABLE",
142
+ CONFIG_ERROR = "CONFIG_ERROR"
143
+ }
144
+ export declare class VirtualRouterError extends Error {
145
+ readonly code: VirtualRouterErrorCode;
146
+ readonly details?: Record<string, unknown>;
147
+ constructor(message: string, code: VirtualRouterErrorCode, details?: Record<string, unknown>);
148
+ }
149
+ export interface RoutingDiagnostics {
150
+ routeName: string;
151
+ providerKey: string;
152
+ reasoning: string;
153
+ fallback: boolean;
154
+ pool: string[];
155
+ confidence: number;
156
+ }
157
+ export interface RoutingStatusSnapshot {
158
+ routes: Record<string, {
159
+ providers: string[];
160
+ hits: number;
161
+ lastUsedProvider?: string;
162
+ }>;
163
+ health: ProviderHealthState[];
164
+ }
165
+ export interface ProviderHealthState {
166
+ providerKey: string;
167
+ state: 'healthy' | 'tripped';
168
+ failureCount: number;
169
+ cooldownExpiresAt?: number;
170
+ reason?: string;
171
+ }
172
+ export interface ProviderFailureEvent {
173
+ providerKey: string;
174
+ routeName?: string;
175
+ reason?: string;
176
+ fatal?: boolean;
177
+ statusCode?: number;
178
+ errorCode?: string;
179
+ retryable?: boolean;
180
+ affectsHealth?: boolean;
181
+ cooldownOverrideMs?: number;
182
+ metadata?: Record<string, unknown>;
183
+ }
184
+ export interface ProviderErrorRuntimeMetadata {
185
+ requestId: string;
186
+ routeName?: string;
187
+ providerKey?: string;
188
+ providerId?: string;
189
+ providerType?: string;
190
+ providerProtocol?: string;
191
+ pipelineId?: string;
192
+ target?: TargetMetadata | Record<string, unknown>;
193
+ }
194
+ export interface ProviderErrorEvent {
195
+ code: string;
196
+ message: string;
197
+ stage: string;
198
+ status?: number;
199
+ recoverable?: boolean;
200
+ runtime: ProviderErrorRuntimeMetadata;
201
+ timestamp: number;
202
+ details?: Record<string, unknown>;
203
+ }
204
+ export interface FeatureBuilder {
205
+ build(request: StandardizedRequest, metadata: RouterMetadataInput): RoutingFeatures;
206
+ }
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Virtual Router 类型定义
3
+ */
4
+ export const DEFAULT_ROUTE = 'default';
5
+ export const ROUTE_PRIORITY = [
6
+ 'vision',
7
+ 'websearch',
8
+ 'coding',
9
+ 'tools',
10
+ 'longcontext',
11
+ 'thinking',
12
+ 'background',
13
+ DEFAULT_ROUTE
14
+ ];
15
+ export var VirtualRouterErrorCode;
16
+ (function (VirtualRouterErrorCode) {
17
+ VirtualRouterErrorCode["NO_STANDARDIZED_REQUEST"] = "NO_STANDARDIZED_REQUEST";
18
+ VirtualRouterErrorCode["ROUTE_NOT_FOUND"] = "ROUTE_NOT_FOUND";
19
+ VirtualRouterErrorCode["PROVIDER_NOT_AVAILABLE"] = "PROVIDER_NOT_AVAILABLE";
20
+ VirtualRouterErrorCode["CONFIG_ERROR"] = "CONFIG_ERROR";
21
+ })(VirtualRouterErrorCode || (VirtualRouterErrorCode = {}));
22
+ export class VirtualRouterError extends Error {
23
+ code;
24
+ details;
25
+ constructor(message, code, details) {
26
+ super(message);
27
+ this.code = code;
28
+ this.details = details;
29
+ this.name = 'VirtualRouterError';
30
+ }
31
+ }
@@ -0,0 +1,140 @@
1
+ /**
2
+ * SSE双向转换模块统一导出
3
+ * 支持Chat和Responses协议的JSON↔SSE双向转换
4
+ */
5
+ import type { ChatCompletionResponse, ChatJsonToSseOptions, ResponsesJsonToSseOptions, ResponsesResponse, SseToChatJsonOptions, SseToResponsesJsonOptions } from './types/index.js';
6
+ import type { AnthropicMessageResponse } from './types/anthropic-types.js';
7
+ import { ChatSseToJsonConverter as ChatSseToJsonConverterCtor } from './sse-to-json/index.js';
8
+ import { ResponsesSseToJsonConverter as ResponsesSseToJsonConverterCtor } from './sse-to-json/index.js';
9
+ import { AnthropicJsonToSseConverter as AnthropicJsonToSseConverterCtor } from './json-to-sse/anthropic-json-to-sse-converter.js';
10
+ import { AnthropicSseToJsonConverter as AnthropicSseToJsonConverterCtor } from './sse-to-json/anthropic-sse-to-json-converter.js';
11
+ export { ChatJsonToSseConverter } from './json-to-sse/index.js';
12
+ export { ChatSseToJsonConverter } from './sse-to-json/index.js';
13
+ export { ResponsesJsonToSseConverter } from './json-to-sse/index.js';
14
+ export { ResponsesSseToJsonConverter } from './sse-to-json/index.js';
15
+ export * from './shared/utils.js';
16
+ export * from './types/index.js';
17
+ /**
18
+ * 工厂函数:创建Chat协议转换器
19
+ */
20
+ export declare function createChatConverters(): {
21
+ jsonToSse: import("./json-to-sse/chat-json-to-sse-converter.js").ChatJsonToSseConverterRefactored;
22
+ sseToJson: ChatSseToJsonConverterCtor;
23
+ /**
24
+ * 执行完整的回环测试
25
+ */
26
+ roundTrip(input: ChatCompletionResponse, options: ChatJsonToSseOptions & SseToChatJsonOptions): Promise<ChatCompletionResponse>;
27
+ };
28
+ /**
29
+ * 工厂函数:创建Responses协议转换器
30
+ */
31
+ export declare function createResponsesConverters(): {
32
+ jsonToSse: import("./json-to-sse/responses-json-to-sse-converter.js").ResponsesJsonToSseConverterRefactored;
33
+ sseToJson: ResponsesSseToJsonConverterCtor;
34
+ /**
35
+ * 执行完整的回环测试
36
+ */
37
+ roundTrip(input: ResponsesResponse, options: ResponsesJsonToSseOptions & SseToResponsesJsonOptions): Promise<ResponsesResponse>;
38
+ };
39
+ /**
40
+ * 工厂函数:创建Anthropic协议转换器
41
+ */
42
+ export declare function createAnthropicConverters(): {
43
+ jsonToSse: AnthropicJsonToSseConverterCtor;
44
+ sseToJson: AnthropicSseToJsonConverterCtor;
45
+ roundTrip(input: AnthropicMessageResponse, options: {
46
+ requestId: string;
47
+ model: string;
48
+ }): Promise<AnthropicMessageResponse>;
49
+ };
50
+ /**
51
+ * 工厂函数:创建完整的双向转换器(支持Chat和Responses协议)
52
+ */
53
+ export declare function createBidirectionalConverters(): {
54
+ chat: {
55
+ jsonToSse: import("./json-to-sse/chat-json-to-sse-converter.js").ChatJsonToSseConverterRefactored;
56
+ sseToJson: ChatSseToJsonConverterCtor;
57
+ /**
58
+ * 执行完整的回环测试
59
+ */
60
+ roundTrip(input: ChatCompletionResponse, options: ChatJsonToSseOptions & SseToChatJsonOptions): Promise<ChatCompletionResponse>;
61
+ };
62
+ responses: {
63
+ jsonToSse: import("./json-to-sse/responses-json-to-sse-converter.js").ResponsesJsonToSseConverterRefactored;
64
+ sseToJson: ResponsesSseToJsonConverterCtor;
65
+ /**
66
+ * 执行完整的回环测试
67
+ */
68
+ roundTrip(input: ResponsesResponse, options: ResponsesJsonToSseOptions & SseToResponsesJsonOptions): Promise<ResponsesResponse>;
69
+ };
70
+ anthropic: {
71
+ jsonToSse: AnthropicJsonToSseConverterCtor;
72
+ sseToJson: AnthropicSseToJsonConverterCtor;
73
+ roundTrip(input: AnthropicMessageResponse, options: {
74
+ requestId: string;
75
+ model: string;
76
+ }): Promise<AnthropicMessageResponse>;
77
+ };
78
+ /**
79
+ * 自动检测协议类型并执行转换
80
+ */
81
+ autoConvert(input: any, options?: any): Promise<ChatCompletionResponse | ResponsesResponse | AnthropicMessageResponse>;
82
+ };
83
+ /**
84
+ * 默认转换器实例
85
+ */
86
+ export declare const chatConverters: {
87
+ jsonToSse: import("./json-to-sse/chat-json-to-sse-converter.js").ChatJsonToSseConverterRefactored;
88
+ sseToJson: ChatSseToJsonConverterCtor;
89
+ /**
90
+ * 执行完整的回环测试
91
+ */
92
+ roundTrip(input: ChatCompletionResponse, options: ChatJsonToSseOptions & SseToChatJsonOptions): Promise<ChatCompletionResponse>;
93
+ };
94
+ export declare const responsesConverters: {
95
+ jsonToSse: import("./json-to-sse/responses-json-to-sse-converter.js").ResponsesJsonToSseConverterRefactored;
96
+ sseToJson: ResponsesSseToJsonConverterCtor;
97
+ /**
98
+ * 执行完整的回环测试
99
+ */
100
+ roundTrip(input: ResponsesResponse, options: ResponsesJsonToSseOptions & SseToResponsesJsonOptions): Promise<ResponsesResponse>;
101
+ };
102
+ export declare const bidirectionalConverters: {
103
+ chat: {
104
+ jsonToSse: import("./json-to-sse/chat-json-to-sse-converter.js").ChatJsonToSseConverterRefactored;
105
+ sseToJson: ChatSseToJsonConverterCtor;
106
+ /**
107
+ * 执行完整的回环测试
108
+ */
109
+ roundTrip(input: ChatCompletionResponse, options: ChatJsonToSseOptions & SseToChatJsonOptions): Promise<ChatCompletionResponse>;
110
+ };
111
+ responses: {
112
+ jsonToSse: import("./json-to-sse/responses-json-to-sse-converter.js").ResponsesJsonToSseConverterRefactored;
113
+ sseToJson: ResponsesSseToJsonConverterCtor;
114
+ /**
115
+ * 执行完整的回环测试
116
+ */
117
+ roundTrip(input: ResponsesResponse, options: ResponsesJsonToSseOptions & SseToResponsesJsonOptions): Promise<ResponsesResponse>;
118
+ };
119
+ anthropic: {
120
+ jsonToSse: AnthropicJsonToSseConverterCtor;
121
+ sseToJson: AnthropicSseToJsonConverterCtor;
122
+ roundTrip(input: AnthropicMessageResponse, options: {
123
+ requestId: string;
124
+ model: string;
125
+ }): Promise<AnthropicMessageResponse>;
126
+ };
127
+ /**
128
+ * 自动检测协议类型并执行转换
129
+ */
130
+ autoConvert(input: any, options?: any): Promise<ChatCompletionResponse | ResponsesResponse | AnthropicMessageResponse>;
131
+ };
132
+ export declare const anthropicConverters: {
133
+ jsonToSse: AnthropicJsonToSseConverterCtor;
134
+ sseToJson: AnthropicSseToJsonConverterCtor;
135
+ roundTrip(input: AnthropicMessageResponse, options: {
136
+ requestId: string;
137
+ model: string;
138
+ }): Promise<AnthropicMessageResponse>;
139
+ };
140
+ export { defaultSseCodecRegistry, SseCodecRegistry, type SseCodec, type SseProtocol, type JsonToSseContext, type SseToJsonContext, type NormalizeSseContext } from './registry/sse-codec-registry.js';