@openllmsh/sdk 2.10.12-alpha.0 → 2.10.12-alpha.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 (634) hide show
  1. package/README.md +27 -7
  2. package/dist/client/chat.d.ts +38 -0
  3. package/dist/client/chat.js +77 -0
  4. package/dist/client/devices.d.ts +70 -0
  5. package/dist/client/devices.js +172 -0
  6. package/dist/client/http.d.ts +24 -0
  7. package/dist/client/http.js +34 -0
  8. package/dist/client/index.d.ts +43 -0
  9. package/dist/client/index.js +57 -0
  10. package/dist/client/relay-mux.d.ts +71 -0
  11. package/dist/client/relay-mux.js +394 -0
  12. package/dist/client/types.d.ts +47 -0
  13. package/dist/client/types.js +5 -0
  14. package/dist/client/vault.d.ts +68 -0
  15. package/dist/client/vault.js +113 -0
  16. package/dist/connect/chat.d.ts +24 -0
  17. package/dist/connect/chat.js +25 -0
  18. package/dist/connect/client.d.ts +50 -0
  19. package/dist/connect/client.js +141 -0
  20. package/dist/connect/config.d.ts +22 -0
  21. package/dist/connect/config.js +22 -0
  22. package/dist/connect/errors.d.ts +32 -0
  23. package/dist/connect/errors.js +85 -0
  24. package/{connect/index.ts → dist/connect/index.d.ts} +7 -7
  25. package/dist/connect/index.js +23 -0
  26. package/dist/connect/oauth.d.ts +51 -0
  27. package/dist/connect/oauth.js +150 -0
  28. package/dist/connect/routes.d.ts +38 -0
  29. package/dist/connect/routes.js +175 -0
  30. package/dist/connect/store.d.ts +26 -0
  31. package/dist/connect/store.js +65 -0
  32. package/dist/mcp/handle.d.ts +6 -0
  33. package/dist/mcp/handle.js +6 -0
  34. package/dist/mcp/index.d.ts +15 -0
  35. package/dist/mcp/index.js +10 -0
  36. package/dist/mcp/server.d.ts +84 -0
  37. package/dist/mcp/server.js +168 -0
  38. package/dist/mcp/tools/marketplace.d.ts +94 -0
  39. package/dist/mcp/tools/marketplace.js +303 -0
  40. package/dist/mcp/tools/memory-client.d.ts +109 -0
  41. package/dist/mcp/tools/memory-client.js +200 -0
  42. package/dist/mcp/tools/memory-config.d.ts +29 -0
  43. package/dist/mcp/tools/memory-config.js +12 -0
  44. package/dist/mcp/tools/memory.d.ts +92 -0
  45. package/dist/mcp/tools/memory.js +312 -0
  46. package/dist/mcp/tools/model-priority.d.ts +16 -0
  47. package/dist/mcp/tools/model-priority.js +87 -0
  48. package/dist/mcp/tools/openllm.d.ts +75 -0
  49. package/dist/mcp/tools/openllm.js +715 -0
  50. package/dist/mcp/types.d.ts +25 -0
  51. package/dist/mcp/types.js +7 -0
  52. package/dist/openapi/call.d.ts +26 -0
  53. package/dist/openapi/call.js +56 -0
  54. package/dist/openapi/index.d.ts +2 -0
  55. package/dist/openapi/index.js +2 -0
  56. package/dist/openapi/openapi.json +80213 -0
  57. package/dist/openapi/operations.d.ts +14 -0
  58. package/dist/openapi/operations.js +2060 -0
  59. package/dist/protocol/access.d.ts +81 -0
  60. package/dist/protocol/access.js +125 -0
  61. package/dist/protocol/agent-prompt-text.d.ts +15 -0
  62. package/{protocol/agent-prompt-text.ts → dist/protocol/agent-prompt-text.js} +9 -14
  63. package/dist/protocol/agent.d.ts +1487 -0
  64. package/dist/protocol/agent.js +787 -0
  65. package/dist/protocol/api-key-syntax.d.ts +58 -0
  66. package/dist/protocol/api-key-syntax.js +73 -0
  67. package/dist/protocol/audio.d.ts +18 -0
  68. package/dist/protocol/audio.js +21 -0
  69. package/dist/protocol/auth.d.ts +126 -0
  70. package/dist/protocol/auth.js +119 -0
  71. package/dist/protocol/changelog.d.ts +69 -0
  72. package/dist/protocol/changelog.js +107 -0
  73. package/dist/protocol/chat.d.ts +789 -0
  74. package/dist/protocol/chat.js +394 -0
  75. package/dist/protocol/client-registry.d.ts +151 -0
  76. package/dist/protocol/client-registry.js +238 -0
  77. package/dist/protocol/config.d.ts +508 -0
  78. package/dist/protocol/config.js +289 -0
  79. package/dist/protocol/control-channel.d.ts +102 -0
  80. package/{protocol/control-channel.ts → dist/protocol/control-channel.js} +33 -61
  81. package/dist/protocol/cooldown-reason.d.ts +30 -0
  82. package/dist/protocol/cooldown-reason.js +44 -0
  83. package/dist/protocol/cost.d.ts +9 -0
  84. package/dist/protocol/cost.js +8 -0
  85. package/dist/protocol/daemon-port.d.ts +2 -0
  86. package/dist/protocol/daemon-port.js +28 -0
  87. package/dist/protocol/daemon.d.ts +2034 -0
  88. package/dist/protocol/daemon.js +1286 -0
  89. package/dist/protocol/default-chains.d.ts +15 -0
  90. package/dist/protocol/default-chains.js +21 -0
  91. package/dist/protocol/device-state.d.ts +223 -0
  92. package/dist/protocol/device-state.js +52 -0
  93. package/dist/protocol/doctor-report-local.d.ts +105 -0
  94. package/{protocol/doctor-report-local.ts → dist/protocol/doctor-report-local.js} +92 -196
  95. package/dist/protocol/doctor-report-policy.d.ts +62 -0
  96. package/{protocol/doctor-report-policy.ts → dist/protocol/doctor-report-policy.js} +23 -76
  97. package/dist/protocol/doctor-report.d.ts +406 -0
  98. package/dist/protocol/doctor-report.js +645 -0
  99. package/dist/protocol/errors.d.ts +17 -0
  100. package/dist/protocol/errors.js +10 -0
  101. package/dist/protocol/execution-selection.d.ts +92 -0
  102. package/{protocol/execution-selection.ts → dist/protocol/execution-selection.js} +38 -63
  103. package/dist/protocol/hop-grant.d.ts +28 -0
  104. package/{protocol/hop-grant.ts → dist/protocol/hop-grant.js} +7 -13
  105. package/dist/protocol/image-edit-parse.d.ts +25 -0
  106. package/dist/protocol/image-edit-parse.js +196 -0
  107. package/dist/protocol/images.d.ts +288 -0
  108. package/dist/protocol/images.js +229 -0
  109. package/dist/protocol/index.d.ts +69 -0
  110. package/dist/protocol/index.js +74 -0
  111. package/dist/protocol/inference-headers.d.ts +3 -0
  112. package/dist/protocol/keepalive.d.ts +36 -0
  113. package/dist/protocol/keepalive.js +51 -0
  114. package/dist/protocol/local-auth.d.ts +125 -0
  115. package/dist/protocol/local-auth.js +227 -0
  116. package/dist/protocol/local-device-control.d.ts +108 -0
  117. package/{protocol/local-device-control.ts → dist/protocol/local-device-control.js} +40 -70
  118. package/dist/protocol/local-provider.d.ts +105 -0
  119. package/dist/protocol/local-provider.js +213 -0
  120. package/dist/protocol/local-session.d.ts +70 -0
  121. package/dist/protocol/local-session.js +87 -0
  122. package/dist/protocol/marketplace.d.ts +190 -0
  123. package/dist/protocol/marketplace.js +140 -0
  124. package/{protocol/media-attempt.ts → dist/protocol/media-attempt.d.ts} +11 -50
  125. package/dist/protocol/media-attempt.js +50 -0
  126. package/dist/protocol/media-bytes.d.ts +8 -0
  127. package/dist/protocol/media-bytes.js +21 -0
  128. package/dist/protocol/media-default.d.ts +56 -0
  129. package/dist/protocol/media-default.js +302 -0
  130. package/{protocol/media-dimensions.ts → dist/protocol/media-dimensions.d.ts} +11 -78
  131. package/dist/protocol/media-dimensions.js +90 -0
  132. package/dist/protocol/media-input.d.ts +20 -0
  133. package/dist/protocol/media-input.js +29 -0
  134. package/dist/protocol/media-model.d.ts +77 -0
  135. package/dist/protocol/media-model.js +89 -0
  136. package/{protocol/media-option-issue.ts → dist/protocol/media-option-issue.d.ts} +25 -53
  137. package/dist/protocol/media-option-issue.js +50 -0
  138. package/dist/protocol/media-types.d.ts +14 -0
  139. package/dist/protocol/media-types.js +61 -0
  140. package/dist/protocol/model-match.d.ts +254 -0
  141. package/dist/protocol/model-match.js +760 -0
  142. package/dist/protocol/model-settings.d.ts +153 -0
  143. package/dist/protocol/model-settings.js +246 -0
  144. package/dist/protocol/models.d.ts +1065 -0
  145. package/dist/protocol/models.js +638 -0
  146. package/dist/protocol/mux.d.ts +350 -0
  147. package/dist/protocol/mux.js +595 -0
  148. package/{protocol/plan-surface.ts → dist/protocol/plan-surface.d.ts} +12 -26
  149. package/dist/protocol/plan-surface.js +39 -0
  150. package/dist/protocol/provider-models.d.ts +8 -0
  151. package/{protocol/provider-models.ts → dist/protocol/provider-models.js} +7 -9
  152. package/dist/protocol/provider-status.d.ts +59 -0
  153. package/dist/protocol/provider-status.js +142 -0
  154. package/dist/protocol/provider-tier.d.ts +34 -0
  155. package/{protocol/provider-tier.ts → dist/protocol/provider-tier.js} +9 -34
  156. package/dist/protocol/provider-usage.d.ts +230 -0
  157. package/dist/protocol/provider-usage.js +214 -0
  158. package/dist/protocol/providers.d.ts +2496 -0
  159. package/dist/protocol/providers.js +723 -0
  160. package/dist/protocol/public-usage-index.d.ts +449 -0
  161. package/dist/protocol/public-usage-index.js +279 -0
  162. package/dist/protocol/realtime-generated.d.ts +29 -0
  163. package/{protocol/realtime-generated.ts → dist/protocol/realtime-generated.js} +3 -5
  164. package/dist/protocol/realtime.d.ts +241 -0
  165. package/{protocol/realtime.ts → dist/protocol/realtime.js} +88 -155
  166. package/dist/protocol/registry-pointer.d.ts +24 -0
  167. package/dist/protocol/registry-pointer.js +78 -0
  168. package/dist/protocol/relay.d.ts +1152 -0
  169. package/{protocol/relay.ts → dist/protocol/relay.js} +237 -370
  170. package/dist/protocol/replay-session.d.ts +4 -0
  171. package/{protocol/replay-session.ts → dist/protocol/replay-session.js} +1 -8
  172. package/dist/protocol/responses.d.ts +303 -0
  173. package/dist/protocol/responses.js +240 -0
  174. package/dist/protocol/semver.d.ts +59 -0
  175. package/dist/protocol/semver.js +171 -0
  176. package/{protocol/setup-mode.ts → dist/protocol/setup-mode.d.ts} +4 -12
  177. package/dist/protocol/setup-mode.js +18 -0
  178. package/dist/protocol/sha256-hex.d.ts +2 -0
  179. package/dist/protocol/sha256-hex.js +93 -0
  180. package/dist/protocol/stats.d.ts +711 -0
  181. package/dist/protocol/stats.js +353 -0
  182. package/dist/protocol/streaming.d.ts +16 -0
  183. package/dist/protocol/streaming.js +15 -0
  184. package/{protocol/subscription-daemon-floors.ts → dist/protocol/subscription-daemon-floors.d.ts} +8 -14
  185. package/dist/protocol/subscription-daemon-floors.js +4 -0
  186. package/dist/protocol/subscription-provider-compat.d.ts +44 -0
  187. package/dist/protocol/subscription-provider-compat.js +67 -0
  188. package/dist/protocol/subscription-provider.d.ts +15 -0
  189. package/dist/protocol/subscription-provider.js +17 -0
  190. package/dist/protocol/team-grant.d.ts +14 -0
  191. package/{protocol/team-grant.ts → dist/protocol/team-grant.js} +0 -3
  192. package/dist/protocol/team-shareable.d.ts +6 -0
  193. package/{protocol/team-shareable.ts → dist/protocol/team-shareable.js} +29 -33
  194. package/dist/protocol/transcription-encoding.d.ts +25 -0
  195. package/dist/protocol/transcription-encoding.js +47 -0
  196. package/{protocol/url-locality-dns.ts → dist/protocol/url-locality-dns.d.ts} +1 -23
  197. package/dist/protocol/url-locality-dns.js +33 -0
  198. package/dist/protocol/url-locality.d.ts +45 -0
  199. package/dist/protocol/url-locality.js +288 -0
  200. package/dist/protocol/usage-snapshots.d.ts +8 -0
  201. package/{protocol/usage-snapshots.ts → dist/protocol/usage-snapshots.js} +1 -2
  202. package/dist/protocol/vendor-cli-install.d.ts +20 -0
  203. package/{protocol/vendor-cli-install.ts → dist/protocol/vendor-cli-install.js} +10 -15
  204. package/dist/protocol/video-job-plan.d.ts +18 -0
  205. package/dist/protocol/video-job-plan.js +44 -0
  206. package/dist/protocol/videos.d.ts +107 -0
  207. package/dist/protocol/videos.js +154 -0
  208. package/dist/tunnel/channel-envelope.d.ts +53 -0
  209. package/dist/tunnel/channel-envelope.js +100 -0
  210. package/dist/tunnel/codec.d.ts +71 -0
  211. package/dist/tunnel/codec.js +151 -0
  212. package/dist/tunnel/device-anchor.d.ts +62 -0
  213. package/dist/tunnel/device-anchor.js +168 -0
  214. package/dist/tunnel/device-control.d.ts +50 -0
  215. package/dist/tunnel/device-control.js +88 -0
  216. package/dist/tunnel/device-grant.d.ts +91 -0
  217. package/dist/tunnel/device-grant.js +105 -0
  218. package/dist/tunnel/fleet.d.ts +28 -0
  219. package/dist/tunnel/fleet.js +41 -0
  220. package/dist/tunnel/index.d.ts +22 -0
  221. package/dist/tunnel/index.js +22 -0
  222. package/dist/tunnel/mux.d.ts +64 -0
  223. package/dist/tunnel/mux.js +449 -0
  224. package/dist/tunnel/peer-link.d.ts +88 -0
  225. package/dist/tunnel/peer-link.js +271 -0
  226. package/dist/tunnel/rtc-auth.d.ts +159 -0
  227. package/dist/tunnel/rtc-auth.js +340 -0
  228. package/dist/tunnel/rtc-duplex.d.ts +52 -0
  229. package/dist/tunnel/rtc-duplex.js +148 -0
  230. package/dist/tunnel/rtc-ice.d.ts +55 -0
  231. package/dist/tunnel/rtc-ice.js +100 -0
  232. package/dist/tunnel/secure.d.ts +179 -0
  233. package/dist/tunnel/secure.js +936 -0
  234. package/dist/tunnel/stream-reset-error.d.ts +6 -0
  235. package/dist/tunnel/stream-reset-error.js +9 -0
  236. package/dist/tunnel/streams.d.ts +244 -0
  237. package/dist/tunnel/streams.js +1071 -0
  238. package/dist/tunnel/team-grant.d.ts +90 -0
  239. package/dist/tunnel/team-grant.js +226 -0
  240. package/dist/tunnel/wire-bytes.d.ts +32 -0
  241. package/dist/tunnel/wire-bytes.js +90 -0
  242. package/dist/vault/api-key.d.ts +71 -0
  243. package/dist/vault/api-key.js +130 -0
  244. package/{vault/argon2.ts → dist/vault/argon2.d.ts} +18 -53
  245. package/dist/vault/argon2.js +82 -0
  246. package/dist/vault/cli-auth-seal.d.ts +35 -0
  247. package/dist/vault/cli-auth-seal.js +78 -0
  248. package/dist/vault/cred-seal.d.ts +18 -0
  249. package/dist/vault/cred-seal.js +86 -0
  250. package/dist/vault/credential.d.ts +21 -0
  251. package/dist/vault/credential.js +26 -0
  252. package/dist/vault/crypto.d.ts +51 -0
  253. package/dist/vault/crypto.js +156 -0
  254. package/dist/vault/daemon-attest.d.ts +68 -0
  255. package/dist/vault/daemon-attest.js +147 -0
  256. package/dist/vault/derive.d.ts +34 -0
  257. package/dist/vault/derive.js +84 -0
  258. package/dist/vault/device-access.d.ts +17 -0
  259. package/dist/vault/device-access.js +77 -0
  260. package/dist/vault/device-anchor.d.ts +42 -0
  261. package/dist/vault/device-anchor.js +90 -0
  262. package/dist/vault/device-control.d.ts +80 -0
  263. package/{vault/device-control.ts → dist/vault/device-control.js} +46 -104
  264. package/dist/vault/handoff.d.ts +102 -0
  265. package/dist/vault/handoff.js +236 -0
  266. package/dist/vault/index.d.ts +21 -0
  267. package/dist/vault/index.js +21 -0
  268. package/dist/vault/passkey.d.ts +82 -0
  269. package/{vault/passkey.ts → dist/vault/passkey.js} +63 -153
  270. package/dist/vault/phrase.d.ts +40 -0
  271. package/{vault/phrase.ts → dist/vault/phrase.js} +17 -23
  272. package/dist/vault/pin.d.ts +46 -0
  273. package/dist/vault/pin.js +92 -0
  274. package/dist/vault/public-key-seal.d.ts +17 -0
  275. package/dist/vault/public-key-seal.js +59 -0
  276. package/dist/vault/seed.d.ts +96 -0
  277. package/dist/vault/seed.js +179 -0
  278. package/dist/vault/team.d.ts +134 -0
  279. package/dist/vault/team.js +217 -0
  280. package/dist/vault/vault-item.d.ts +45 -0
  281. package/dist/vault/vault-item.js +62 -0
  282. package/dist/vault/vault-migrate-digest.d.ts +10 -0
  283. package/dist/vault/vault-migrate-digest.js +22 -0
  284. package/dist/vault/wrapped.d.ts +19 -0
  285. package/dist/vault/wrapped.js +52 -0
  286. package/dist/wire/adapters/messages/anthropic-map.d.ts +8 -0
  287. package/dist/wire/adapters/messages/anthropic-map.js +32 -0
  288. package/dist/wire/adapters/messages/index.d.ts +7 -0
  289. package/dist/wire/adapters/messages/index.js +7 -0
  290. package/dist/wire/adapters/messages/reasoning-from-items.d.ts +14 -0
  291. package/dist/wire/adapters/messages/reasoning-from-items.js +39 -0
  292. package/dist/wire/adapters/messages/reasoning-signature.d.ts +81 -0
  293. package/dist/wire/adapters/messages/reasoning-signature.js +180 -0
  294. package/dist/wire/adapters/messages/request.d.ts +28 -0
  295. package/dist/wire/adapters/messages/request.js +490 -0
  296. package/dist/wire/adapters/messages/response.d.ts +10 -0
  297. package/dist/wire/adapters/messages/response.js +177 -0
  298. package/dist/wire/adapters/messages/streaming.d.ts +134 -0
  299. package/dist/wire/adapters/messages/streaming.js +791 -0
  300. package/dist/wire/adapters/messages/usage.d.ts +20 -0
  301. package/dist/wire/adapters/messages/usage.js +10 -0
  302. package/dist/wire/adapters/responses/index.d.ts +3 -0
  303. package/dist/wire/adapters/responses/index.js +3 -0
  304. package/dist/wire/adapters/responses/request.d.ts +2 -0
  305. package/dist/wire/adapters/responses/request.js +287 -0
  306. package/dist/wire/adapters/responses/response.d.ts +11 -0
  307. package/dist/wire/adapters/responses/response.js +69 -0
  308. package/dist/wire/adapters/responses/streaming.d.ts +2 -0
  309. package/dist/wire/adapters/responses/streaming.js +267 -0
  310. package/dist/wire/features/account-rank.d.ts +61 -0
  311. package/dist/wire/features/account-rank.js +109 -0
  312. package/dist/wire/features/compaction/compact-request.d.ts +69 -0
  313. package/dist/wire/features/compaction/compact-request.js +667 -0
  314. package/dist/wire/features/compaction/compaction-text.d.ts +17 -0
  315. package/dist/wire/features/compaction/compaction-text.js +29 -0
  316. package/dist/wire/features/context-demote.d.ts +15 -0
  317. package/dist/wire/features/context-demote.js +45 -0
  318. package/dist/wire/features/context-overflow-strategy.d.ts +12 -0
  319. package/dist/wire/features/context-overflow-strategy.js +8 -0
  320. package/dist/wire/features/context-skip.d.ts +120 -0
  321. package/{wire/features/context-skip.ts → dist/wire/features/context-skip.js} +23 -57
  322. package/dist/wire/features/conversation-affinity.d.ts +49 -0
  323. package/dist/wire/features/conversation-affinity.js +121 -0
  324. package/dist/wire/features/max-tokens-backfill.d.ts +50 -0
  325. package/dist/wire/features/max-tokens-backfill.js +118 -0
  326. package/dist/wire/features/model-caps.d.ts +7 -0
  327. package/dist/wire/features/model-caps.js +40 -0
  328. package/dist/wire/features/model-settings.d.ts +3 -0
  329. package/dist/wire/features/model-settings.js +13 -0
  330. package/dist/wire/features/output-limit-clamp.d.ts +14 -0
  331. package/dist/wire/features/output-limit-clamp.js +36 -0
  332. package/dist/wire/features/quota-gate.d.ts +16 -0
  333. package/dist/wire/features/quota-gate.js +48 -0
  334. package/dist/wire/index.d.ts +44 -0
  335. package/dist/wire/index.js +44 -0
  336. package/dist/wire/lib/attempt-outcome.d.ts +19 -0
  337. package/dist/wire/lib/attempt-outcome.js +18 -0
  338. package/{wire/lib/canonical/content-part.ts → dist/wire/lib/canonical/content-part.d.ts} +12 -18
  339. package/dist/wire/lib/canonical/content-part.js +11 -0
  340. package/dist/wire/lib/canonical/count-tokens-capability.d.ts +52 -0
  341. package/dist/wire/lib/canonical/count-tokens-capability.js +109 -0
  342. package/{wire/lib/canonical/encoding-select.ts → dist/wire/lib/canonical/encoding-select.d.ts} +7 -24
  343. package/dist/wire/lib/canonical/encoding-select.js +26 -0
  344. package/dist/wire/lib/canonical/image-signature.d.ts +20 -0
  345. package/dist/wire/lib/canonical/image-signature.js +184 -0
  346. package/dist/wire/lib/canonical/image-sse.d.ts +88 -0
  347. package/dist/wire/lib/canonical/image-sse.js +173 -0
  348. package/{wire/lib/canonical/message.ts → dist/wire/lib/canonical/message.d.ts} +2 -20
  349. package/dist/wire/lib/canonical/message.js +31 -0
  350. package/dist/wire/lib/canonical/token-estimate.d.ts +98 -0
  351. package/dist/wire/lib/canonical/token-estimate.js +230 -0
  352. package/dist/wire/lib/encrypted-content.d.ts +22 -0
  353. package/dist/wire/lib/encrypted-content.js +55 -0
  354. package/dist/wire/lib/error-class.d.ts +57 -0
  355. package/dist/wire/lib/error-class.js +97 -0
  356. package/dist/wire/lib/error-envelope.d.ts +20 -0
  357. package/dist/wire/lib/error-envelope.js +53 -0
  358. package/dist/wire/lib/forwarded-headers.d.ts +16 -0
  359. package/{wire/lib/forwarded-headers.ts → dist/wire/lib/forwarded-headers.js} +62 -72
  360. package/dist/wire/lib/provider-error-rules.d.ts +21 -0
  361. package/dist/wire/lib/provider-error-rules.js +20 -0
  362. package/{wire/lib/refusal.ts → dist/wire/lib/refusal.d.ts} +3 -13
  363. package/dist/wire/lib/refusal.js +27 -0
  364. package/dist/wire/lib/responses-apply-patch.d.ts +57 -0
  365. package/dist/wire/lib/responses-apply-patch.js +81 -0
  366. package/dist/wire/lib/responses-namespace.d.ts +27 -0
  367. package/{wire/lib/responses-namespace.ts → dist/wire/lib/responses-namespace.js} +16 -32
  368. package/dist/wire/lib/secret-scrub.d.ts +23 -0
  369. package/dist/wire/lib/secret-scrub.js +72 -0
  370. package/dist/wire/lib/streaming/accumulate.d.ts +12 -0
  371. package/dist/wire/lib/streaming/accumulate.js +187 -0
  372. package/dist/wire/lib/streaming/finish-reason.d.ts +20 -0
  373. package/dist/wire/lib/streaming/finish-reason.js +15 -0
  374. package/{wire/lib/streaming/peek.ts → dist/wire/lib/streaming/peek.d.ts} +13 -82
  375. package/dist/wire/lib/streaming/peek.js +100 -0
  376. package/dist/wire/lib/streaming/provider-decode.d.ts +57 -0
  377. package/dist/wire/lib/streaming/provider-decode.js +210 -0
  378. package/dist/wire/lib/streaming/response-stream.d.ts +16 -0
  379. package/dist/wire/lib/streaming/response-stream.js +64 -0
  380. package/dist/wire/lib/streaming/sse.d.ts +130 -0
  381. package/dist/wire/lib/streaming/sse.js +600 -0
  382. package/dist/wire/lib/streaming/strip-tool-calls.d.ts +14 -0
  383. package/dist/wire/lib/streaming/strip-tool-calls.js +75 -0
  384. package/dist/wire/lib/streaming/upstream-error.d.ts +32 -0
  385. package/dist/wire/lib/streaming/upstream-error.js +45 -0
  386. package/dist/wire/lib/strip-subagent-isolation.d.ts +16 -0
  387. package/dist/wire/lib/strip-subagent-isolation.js +240 -0
  388. package/dist/wire/lib/thinking-signature.d.ts +56 -0
  389. package/{wire/lib/thinking-signature.ts → dist/wire/lib/thinking-signature.js} +77 -84
  390. package/dist/wire/lib/token-ruler/bpe-core.d.ts +105 -0
  391. package/dist/wire/lib/token-ruler/bpe-core.js +398 -0
  392. package/dist/wire/lib/token-ruler/index.d.ts +2 -0
  393. package/dist/wire/lib/token-ruler/index.js +2 -0
  394. package/dist/wire/lib/token-ruler/ruler.d.ts +36 -0
  395. package/dist/wire/lib/token-ruler/ruler.js +50 -0
  396. package/dist/wire/lib/token-ruler/vocab/claude-ranks.d.ts +14 -0
  397. package/dist/wire/lib/token-ruler/vocab/claude-ranks.js +16 -0
  398. package/{wire/lib/token-ruler/vocab/claude.ts → dist/wire/lib/token-ruler/vocab/claude.d.ts} +2 -12
  399. package/dist/wire/lib/token-ruler/vocab/claude.js +8 -0
  400. package/dist/wire/lib/token-ruler/vocab/o200k-ranks.d.ts +3 -0
  401. package/dist/wire/lib/token-ruler/vocab/o200k-ranks.js +18 -0
  402. package/dist/wire/lib/token-ruler/vocab/o200k.d.ts +11 -0
  403. package/dist/wire/lib/token-ruler/vocab/o200k.js +6 -0
  404. package/dist/wire/lib/tool-name-map.d.ts +44 -0
  405. package/dist/wire/lib/tool-name-map.js +186 -0
  406. package/dist/wire/lib/tool-schema.d.ts +15 -0
  407. package/dist/wire/lib/tool-schema.js +307 -0
  408. package/dist/wire/lib/usage-observer.d.ts +9 -0
  409. package/dist/wire/lib/usage-observer.js +108 -0
  410. package/dist/wire/providers/anthropic/adaptive-thinking.d.ts +125 -0
  411. package/dist/wire/providers/anthropic/adaptive-thinking.js +221 -0
  412. package/dist/wire/providers/anthropic/beta-headers.d.ts +44 -0
  413. package/{wire/providers/anthropic/beta-headers.ts → dist/wire/providers/anthropic/beta-headers.js} +57 -79
  414. package/dist/wire/providers/anthropic/index.d.ts +6 -0
  415. package/{wire/providers/anthropic/index.ts → dist/wire/providers/anthropic/index.js} +6 -6
  416. package/dist/wire/providers/anthropic/request.d.ts +12 -0
  417. package/dist/wire/providers/anthropic/request.js +456 -0
  418. package/dist/wire/providers/anthropic/response.d.ts +3 -0
  419. package/dist/wire/providers/anthropic/response.js +126 -0
  420. package/dist/wire/providers/anthropic/streaming.d.ts +28 -0
  421. package/dist/wire/providers/anthropic/streaming.js +268 -0
  422. package/dist/wire/providers/anthropic/web-search-domains.d.ts +7 -0
  423. package/dist/wire/providers/anthropic/web-search-domains.js +36 -0
  424. package/dist/wire/providers/chatgpt/common.d.ts +27 -0
  425. package/{wire/providers/chatgpt/common.ts → dist/wire/providers/chatgpt/common.js} +69 -89
  426. package/dist/wire/providers/chatgpt/index.d.ts +4 -0
  427. package/{wire/providers/chatgpt/index.ts → dist/wire/providers/chatgpt/index.js} +4 -4
  428. package/dist/wire/providers/chatgpt/request.d.ts +132 -0
  429. package/dist/wire/providers/chatgpt/request.js +696 -0
  430. package/dist/wire/providers/chatgpt/streaming.d.ts +69 -0
  431. package/dist/wire/providers/chatgpt/streaming.js +761 -0
  432. package/dist/wire/providers/chatgpt/web-search.d.ts +19 -0
  433. package/dist/wire/providers/chatgpt/web-search.js +55 -0
  434. package/dist/wire/providers/grok/web-search.d.ts +23 -0
  435. package/dist/wire/providers/grok/web-search.js +74 -0
  436. package/dist/wire/providers/kimi/web-search.d.ts +48 -0
  437. package/dist/wire/providers/kimi/web-search.js +106 -0
  438. package/dist/wire/providers/upstream-deny.d.ts +61 -0
  439. package/dist/wire/providers/upstream-deny.js +293 -0
  440. package/dist/wire/providers/upstream-request.d.ts +104 -0
  441. package/dist/wire/providers/upstream-request.js +411 -0
  442. package/package.json +105 -23
  443. package/ARCHITECTURE.md +0 -43
  444. package/client/chat.ts +0 -140
  445. package/client/devices.ts +0 -269
  446. package/client/http.ts +0 -72
  447. package/client/index.ts +0 -129
  448. package/client/relay-mux.ts +0 -547
  449. package/client/types.ts +0 -51
  450. package/client/vault.ts +0 -239
  451. package/connect/chat.ts +0 -58
  452. package/connect/client.ts +0 -240
  453. package/connect/config.ts +0 -47
  454. package/connect/errors.ts +0 -121
  455. package/connect/oauth.ts +0 -265
  456. package/connect/routes.ts +0 -234
  457. package/connect/store.ts +0 -107
  458. package/mcp/handle.ts +0 -24
  459. package/mcp/index.ts +0 -76
  460. package/mcp/server.ts +0 -319
  461. package/mcp/tools/marketplace.ts +0 -439
  462. package/mcp/tools/memory-client.ts +0 -297
  463. package/mcp/tools/memory-config.ts +0 -32
  464. package/mcp/tools/memory.ts +0 -369
  465. package/mcp/tools/model-priority.ts +0 -88
  466. package/mcp/tools/openllm.ts +0 -883
  467. package/mcp/types.ts +0 -28
  468. package/openapi/call.ts +0 -90
  469. package/openapi/index.ts +0 -8
  470. package/openapi/openapi.json +0 -80213
  471. package/openapi/operations.ts +0 -2075
  472. package/protocol/CONTRIBUTING.md +0 -21
  473. package/protocol/README.md +0 -134
  474. package/protocol/access.ts +0 -186
  475. package/protocol/agent.ts +0 -991
  476. package/protocol/api-key-syntax.ts +0 -105
  477. package/protocol/assets/openllm-light.svg +0 -18
  478. package/protocol/assets/openllm.svg +0 -18
  479. package/protocol/audio.ts +0 -29
  480. package/protocol/auth.ts +0 -142
  481. package/protocol/changelog.ts +0 -155
  482. package/protocol/chat.ts +0 -458
  483. package/protocol/client-registry.ts +0 -356
  484. package/protocol/config.ts +0 -345
  485. package/protocol/cooldown-reason.ts +0 -78
  486. package/protocol/cost.ts +0 -10
  487. package/protocol/daemon-port.ts +0 -31
  488. package/protocol/daemon.ts +0 -1524
  489. package/protocol/default-chains.ts +0 -66
  490. package/protocol/device-state.ts +0 -85
  491. package/protocol/doctor-report.ts +0 -947
  492. package/protocol/errors.ts +0 -14
  493. package/protocol/image-edit-parse.ts +0 -263
  494. package/protocol/images.ts +0 -298
  495. package/protocol/index.ts +0 -74
  496. package/protocol/keepalive.ts +0 -69
  497. package/protocol/local-auth.ts +0 -300
  498. package/protocol/local-provider.ts +0 -288
  499. package/protocol/local-session.ts +0 -118
  500. package/protocol/marketplace.ts +0 -187
  501. package/protocol/media-bytes.ts +0 -28
  502. package/protocol/media-default.ts +0 -357
  503. package/protocol/media-input.ts +0 -61
  504. package/protocol/media-model.ts +0 -142
  505. package/protocol/media-types.ts +0 -70
  506. package/protocol/model-match.ts +0 -1051
  507. package/protocol/model-settings.ts +0 -327
  508. package/protocol/models.ts +0 -767
  509. package/protocol/mux.ts +0 -722
  510. package/protocol/provider-status.ts +0 -206
  511. package/protocol/provider-usage.ts +0 -263
  512. package/protocol/providers.ts +0 -901
  513. package/protocol/public-usage-index.ts +0 -354
  514. package/protocol/registry-pointer.ts +0 -118
  515. package/protocol/responses.ts +0 -280
  516. package/protocol/semver.ts +0 -182
  517. package/protocol/sha256-hex.ts +0 -98
  518. package/protocol/stats.ts +0 -406
  519. package/protocol/streaming.ts +0 -19
  520. package/protocol/subscription-provider-compat.ts +0 -104
  521. package/protocol/subscription-provider.ts +0 -32
  522. package/protocol/transcription-encoding.ts +0 -76
  523. package/protocol/url-locality.ts +0 -288
  524. package/protocol/video-job-plan.ts +0 -50
  525. package/protocol/videos.ts +0 -227
  526. package/tsconfig.json +0 -14
  527. package/tunnel/ARCHITECTURE.md +0 -111
  528. package/tunnel/assets/openllm-light.svg +0 -18
  529. package/tunnel/assets/openllm.svg +0 -18
  530. package/tunnel/channel-envelope.ts +0 -139
  531. package/tunnel/codec.ts +0 -191
  532. package/tunnel/device-anchor.ts +0 -229
  533. package/tunnel/device-control.ts +0 -118
  534. package/tunnel/device-grant.ts +0 -173
  535. package/tunnel/fleet.ts +0 -77
  536. package/tunnel/index.ts +0 -22
  537. package/tunnel/mux.ts +0 -580
  538. package/tunnel/peer-link.ts +0 -390
  539. package/tunnel/rtc-auth.ts +0 -415
  540. package/tunnel/rtc-duplex.ts +0 -187
  541. package/tunnel/rtc-ice.ts +0 -136
  542. package/tunnel/secure.ts +0 -1298
  543. package/tunnel/stream-reset-error.ts +0 -14
  544. package/tunnel/streams.ts +0 -1430
  545. package/tunnel/team-grant.ts +0 -302
  546. package/tunnel/wire-bytes.ts +0 -102
  547. package/vault/ARCHITECTURE.md +0 -470
  548. package/vault/api-key.ts +0 -190
  549. package/vault/cli-auth-seal.ts +0 -157
  550. package/vault/cred-seal.ts +0 -146
  551. package/vault/credential.ts +0 -55
  552. package/vault/crypto.ts +0 -210
  553. package/vault/daemon-attest.ts +0 -229
  554. package/vault/derive.ts +0 -113
  555. package/vault/device-access.ts +0 -87
  556. package/vault/device-anchor.ts +0 -185
  557. package/vault/handoff.ts +0 -396
  558. package/vault/index.ts +0 -21
  559. package/vault/pin.ts +0 -153
  560. package/vault/public-key-seal.ts +0 -131
  561. package/vault/seed.ts +0 -272
  562. package/vault/team.ts +0 -355
  563. package/vault/vault-item.ts +0 -131
  564. package/vault/vault-migrate-digest.ts +0 -29
  565. package/vault/wrapped.ts +0 -77
  566. package/wire/ARCHITECTURE.md +0 -90
  567. package/wire/CONTRIBUTING.md +0 -19
  568. package/wire/adapters/messages/anthropic-map.ts +0 -37
  569. package/wire/adapters/messages/index.ts +0 -7
  570. package/wire/adapters/messages/reasoning-from-items.ts +0 -38
  571. package/wire/adapters/messages/reasoning-signature.ts +0 -243
  572. package/wire/adapters/messages/request.ts +0 -574
  573. package/wire/adapters/messages/response.ts +0 -215
  574. package/wire/adapters/messages/streaming.ts +0 -1027
  575. package/wire/adapters/messages/usage.ts +0 -43
  576. package/wire/adapters/responses/index.ts +0 -3
  577. package/wire/adapters/responses/request.ts +0 -395
  578. package/wire/adapters/responses/response.ts +0 -88
  579. package/wire/adapters/responses/streaming.ts +0 -344
  580. package/wire/assets/openllm-light.svg +0 -18
  581. package/wire/assets/openllm.svg +0 -18
  582. package/wire/features/account-rank.ts +0 -166
  583. package/wire/features/compaction/compact-request.ts +0 -862
  584. package/wire/features/compaction/compaction-text.ts +0 -43
  585. package/wire/features/context-demote.ts +0 -47
  586. package/wire/features/context-overflow-strategy.ts +0 -26
  587. package/wire/features/conversation-affinity.ts +0 -144
  588. package/wire/features/max-tokens-backfill.ts +0 -141
  589. package/wire/features/model-caps.ts +0 -53
  590. package/wire/features/model-settings.ts +0 -24
  591. package/wire/features/output-limit-clamp.ts +0 -64
  592. package/wire/features/quota-gate.ts +0 -85
  593. package/wire/index.ts +0 -44
  594. package/wire/lib/attempt-outcome.ts +0 -43
  595. package/wire/lib/canonical/count-tokens-capability.ts +0 -138
  596. package/wire/lib/canonical/image-signature.ts +0 -202
  597. package/wire/lib/canonical/image-sse.ts +0 -216
  598. package/wire/lib/canonical/token-estimate.ts +0 -266
  599. package/wire/lib/encrypted-content.ts +0 -66
  600. package/wire/lib/error-class.ts +0 -154
  601. package/wire/lib/error-envelope.ts +0 -56
  602. package/wire/lib/provider-error-rules.ts +0 -48
  603. package/wire/lib/responses-apply-patch.ts +0 -104
  604. package/wire/lib/secret-scrub.ts +0 -101
  605. package/wire/lib/streaming/accumulate.ts +0 -221
  606. package/wire/lib/streaming/finish-reason.ts +0 -33
  607. package/wire/lib/streaming/provider-decode.ts +0 -259
  608. package/wire/lib/streaming/response-stream.ts +0 -71
  609. package/wire/lib/streaming/sse.ts +0 -699
  610. package/wire/lib/streaming/strip-tool-calls.ts +0 -95
  611. package/wire/lib/streaming/upstream-error.ts +0 -58
  612. package/wire/lib/strip-subagent-isolation.ts +0 -284
  613. package/wire/lib/token-ruler/bpe-core.ts +0 -426
  614. package/wire/lib/token-ruler/index.ts +0 -2
  615. package/wire/lib/token-ruler/ruler.ts +0 -79
  616. package/wire/lib/token-ruler/vocab/claude-ranks.ts +0 -16
  617. package/wire/lib/token-ruler/vocab/o200k-ranks.ts +0 -18
  618. package/wire/lib/token-ruler/vocab/o200k.ts +0 -19
  619. package/wire/lib/tool-name-map.ts +0 -271
  620. package/wire/lib/tool-schema.ts +0 -353
  621. package/wire/lib/usage-observer.ts +0 -125
  622. package/wire/providers/anthropic/adaptive-thinking.ts +0 -291
  623. package/wire/providers/anthropic/request.ts +0 -607
  624. package/wire/providers/anthropic/response.ts +0 -155
  625. package/wire/providers/anthropic/streaming.ts +0 -315
  626. package/wire/providers/anthropic/web-search-domains.ts +0 -49
  627. package/wire/providers/chatgpt/request.ts +0 -959
  628. package/wire/providers/chatgpt/streaming.ts +0 -1007
  629. package/wire/providers/chatgpt/web-search.ts +0 -63
  630. package/wire/providers/grok/web-search.ts +0 -87
  631. package/wire/providers/kimi/web-search.ts +0 -145
  632. package/wire/providers/upstream-deny.ts +0 -355
  633. package/wire/providers/upstream-request.ts +0 -619
  634. /package/{protocol/inference-headers.ts → dist/protocol/inference-headers.js} +0 -0
@@ -1,1051 +0,0 @@
1
- /**
2
- * Generic model identity matching — the ONE engine behind two different
3
- * questions the gateway asks about a model name:
4
- *
5
- * 1. **Request resolution** — "the caller typed `grok`; which model that
6
- * they can actually use did they mean?" → `selectRequestModel`.
7
- * 2. **Metadata inheritance** — "this discovered model has no catalog
8
- * card; whose authored metadata is the nearest fit?" →
9
- * `selectMetadataDonor`.
10
- *
11
- * Both share parsing and identity comparison and DELIBERATELY do not share
12
- * a winner ordering: a request wants the NEWEST available model, while
13
- * inheritance wants the nearest known PREDECESSOR. Donor availability is
14
- * irrelevant — a disconnected provider's authored card still describes the
15
- * model.
16
- *
17
- * This module is pure and provider-agnostic. It holds no provider slug, no
18
- * family name, no model policy table, and it never fetches, reads a
19
- * catalog, touches a DB, or triggers auth/discovery. Every naming exception
20
- * (which `/`-prefixes are routing namespaces, which words are meaningful
21
- * variants, which families use hyphen versions or were renamed) arrives as
22
- * DATA in `TModelIdentityRules`, authored next to the model definitions
23
- * that need it.
24
- *
25
- * What it will NOT guess: a release version is a dotted numeric token
26
- * (`4.7`, `4.10`) or a catalog-declared hyphen version (`opus-4-8`).
27
- * Dates, context windows, parameter counts and quantization suffixes are
28
- * never versions — a wrong guess there silently reroutes traffic, so an
29
- * unknown version stays null and the caller keeps its existing behaviour.
30
- */
31
-
32
- /** A release version as integers, most significant first. */
33
- export type TModelVersion = ReadonlyArray<number>;
34
-
35
- /**
36
- * Everything provider-specific the engine is allowed to know — and all
37
- * of it is DERIVED from a model corpus by {@link deriveModelIdentityRules},
38
- * never authored. There is no rule table to maintain: adding a model row
39
- * is the only thing anyone has to do.
40
- */
41
- export type TModelIdentityRules = {
42
- /**
43
- * The ONLY prefixes that may be split off before a `/`. A custom
44
- * upstream id can legitimately contain slashes, so anything unlisted
45
- * keeps its id whole.
46
- */
47
- readonly namespaces?: ReadonlyArray<string>;
48
- /**
49
- * Words the corpus shows AFTER a version span (`sol`, `mini`,
50
- * `flash`). A token outside this set is family text, which is what
51
- * keeps a truncated shorthand like `5.6-s` from being read as a
52
- * request for a variant called `s`.
53
- */
54
- readonly variantTokens?: ReadonlyArray<string>;
55
- /**
56
- * Word-stems the corpus has shown carrying a generation number
57
- * (`kimi-k2.5`/`kimi-k3` → `k`).
58
- *
59
- * It exists because `k3` and `q4` are the SAME shape: a word welded to
60
- * a number. One is a generation, the other is quantization, and no
61
- * amount of structure separates them — only the observation that the
62
- * catalog shows `k` varying across several numbers while `q` does not.
63
- * Absent evidence the engine declines to guess, which is why a bare
64
- * parse leaves `kimi-k3` versionless rather than inventing a version.
65
- */
66
- readonly versionStems?: ReadonlyArray<string>;
67
- };
68
-
69
- /**
70
- * A parsed identity. `raw` and `providerModelId` keep their original
71
- * spelling because they are the EXECUTION identity; only the comparable
72
- * fields (`family`, `variants`) are case-normalised.
73
- */
74
- export type TModelIdentity = {
75
- readonly raw: string;
76
- /** Set only when a recognised namespace prefixed the id. */
77
- readonly provider: string | null;
78
- readonly providerModelId: string;
79
- readonly family: string;
80
- readonly version: TModelVersion | null;
81
- readonly versionText: string | null;
82
- /** A date-like suffix. Kept apart from the version on purpose. */
83
- readonly snapshot: string | null;
84
- /** Sorted and de-duped so two identities compare by value. */
85
- readonly variants: ReadonlyArray<string>;
86
- };
87
-
88
- type TCompiledRules = {
89
- readonly namespaces: ReadonlySet<string>;
90
- readonly variantTokens: ReadonlySet<string>;
91
- readonly versionStems: ReadonlySet<string>;
92
- };
93
-
94
- const EMPTY_COMPILED: TCompiledRules = {
95
- namespaces: new Set<string>(),
96
- variantTokens: new Set<string>(),
97
- versionStems: new Set<string>(),
98
- };
99
-
100
- /**
101
- * Patterns are compiled ONCE per rules object and cached against it, so a
102
- * catalog index built from one rules value never recompiles per row.
103
- */
104
- const compiledCache = new WeakMap<TModelIdentityRules, TCompiledRules>();
105
-
106
- const compileRules = (
107
- rules: TModelIdentityRules | undefined,
108
- ): TCompiledRules => {
109
- if (rules === undefined) return EMPTY_COMPILED;
110
- const cached = compiledCache.get(rules);
111
- if (cached !== undefined) return cached;
112
-
113
- const compiled: TCompiledRules = {
114
- namespaces: new Set(
115
- (rules.namespaces ?? []).map((value) => value.toLowerCase()),
116
- ),
117
- variantTokens: new Set(
118
- (rules.variantTokens ?? []).map((value) => value.toLowerCase()),
119
- ),
120
- versionStems: new Set(
121
- (rules.versionStems ?? []).map((value) => value.toLowerCase()),
122
- ),
123
- };
124
- compiledCache.set(rules, compiled);
125
- return compiled;
126
- };
127
-
128
- /**
129
- * Date-like suffixes, longest/most specific shape first. Stripped BEFORE
130
- * version parsing so a dotted date can never be read as `1.2.3`.
131
- */
132
- const SNAPSHOT_PATTERNS: ReadonlyArray<RegExp> = [
133
- /[-_@](\d{4}-\d{2}-\d{2})$/,
134
- /[-_@](\d{4}\.\d{2}\.\d{2})$/,
135
- /[-_@](\d{8})$/,
136
- // A ZERO-PADDED build number — Google's `-001` / `-002`, OpenAI's
137
- // `-0125`. Listed last so a date always wins.
138
- //
139
- // The leading zero is the whole discriminator, and it is why this is
140
- // not simply "three or four digits". A release number is written the
141
- // way the vendor says it (`4`, `4.0`, `4-8`, and one day `999` or
142
- // `1000`) and is never padded to a fixed width, so a padded run can
143
- // only be a build id, while an unpadded one is left alone to be read
144
- // as the version or family text it is. `imagen-4.0-generate-001`
145
- // therefore keeps `[4, 0]` as its version and carries `001` as its
146
- // snapshot, which is what makes the `-002` rebuild the SAME model
147
- // rather than a family of its own.
148
- /[-_@](0\d{2,3})$/,
149
- ];
150
-
151
- /**
152
- * Tokenisation keeps `.` INSIDE a token so a dotted version survives as
153
- * one unit (`grok-4.7` → `grok` + `4.7`). Everything else separates.
154
- */
155
- const TOKEN_SPLIT = /[-/_\s:]+/;
156
-
157
- /** A whole token that is nothing but a dotted number: `4.7`, `4.10.1`. */
158
- const DOTTED_VERSION = /^(\d+(?:\.\d+)+)$/;
159
- /** A dotted number glued to a leading word: `qwen3.6`. */
160
- const SUFFIXED_DOTTED_VERSION = /^(.*?)(\d+(?:\.\d+)+)$/;
161
- /** A whole token that is a bare integer: the `4` and `8` of `opus-4-8`. */
162
- const INTEGER_TOKEN = /^\d+$/;
163
- /**
164
- * A word with a generation number welded onto it: `k3`, `qwen3`, `o4`.
165
- *
166
- * The letter/digit ORDER is the whole discriminator, and it is what
167
- * separates a version from a size. Letters-then-digits is a generation
168
- * (`k3`); digits-then-letters is a measurement — parameter counts
169
- * (`8b`, `32b`), context windows (`16k`, `128k`), quantization, and
170
- * `4o`-style suffixes — and never matches here.
171
- */
172
- const ATTACHED_VERSION = /^([A-Za-z]+)(\d+)$/;
173
-
174
- type TVersionSpan = {
175
- readonly stem: ReadonlyArray<string>;
176
- readonly version: TModelVersion;
177
- readonly versionText: string;
178
- readonly rest: ReadonlyArray<string>;
179
- };
180
-
181
- /**
182
- * Locate the release version STRUCTURALLY, with no vocabulary at all.
183
- *
184
- * Two shapes, in order:
185
- * 1. a dotted number, alone (`4.7`) or glued to a word (`qwen3.6`);
186
- * 2. otherwise, a run of bare integers that FOLLOWS a word — this is
187
- * what makes `opus-4-8` and `fable-5` versions of one family
188
- * without anyone authoring a regex for either.
189
- *
190
- * What it refuses is as important as what it accepts. The run must be
191
- * preceded by a word, so an id that is only digits has no version.
192
- * Snapshots are stripped before this runs, so a date can never reach it.
193
- * Sizes, context windows and quantization (`8b`, `128k`, `1.5b`) carry a
194
- * letter and therefore match neither shape. That is the whole
195
- * no-speculative-parsing rule, expressed as structure rather than as a
196
- * list somebody has to maintain.
197
- */
198
- const findVersionSpan = (
199
- tokens: ReadonlyArray<string>,
200
- versionStems: ReadonlySet<string>,
201
- ): TVersionSpan | null => {
202
- for (let i = 0; i < tokens.length; i += 1) {
203
- const token = tokens[i] as string;
204
- const dotted = token.match(DOTTED_VERSION);
205
- if (dotted?.[1] !== undefined) {
206
- return {
207
- stem: tokens.slice(0, i),
208
- version: toVersionTuple(dotted[1]) ?? [],
209
- versionText: dotted[1],
210
- rest: tokens.slice(i + 1),
211
- };
212
- }
213
- const suffixed = token.match(SUFFIXED_DOTTED_VERSION);
214
- if (suffixed?.[2] !== undefined && suffixed[1] !== undefined) {
215
- const head = suffixed[1];
216
- return {
217
- stem:
218
- head.length > 0 ? [...tokens.slice(0, i), head] : tokens.slice(0, i),
219
- version: toVersionTuple(suffixed[2]) ?? [],
220
- versionText: suffixed[2],
221
- rest: tokens.slice(i + 1),
222
- };
223
- }
224
- const attached = token.match(ATTACHED_VERSION);
225
- if (
226
- attached?.[1] !== undefined &&
227
- attached[2] !== undefined &&
228
- versionStems.has(attached[1].toLowerCase())
229
- ) {
230
- return {
231
- stem: [...tokens.slice(0, i), attached[1]],
232
- version: [Number.parseInt(attached[2], 10)],
233
- versionText: attached[2],
234
- rest: tokens.slice(i + 1),
235
- };
236
- }
237
- }
238
-
239
- for (let i = 1; i < tokens.length; i += 1) {
240
- if (!INTEGER_TOKEN.test(tokens[i] as string)) continue;
241
- let end = i;
242
- while (
243
- end + 1 < tokens.length &&
244
- INTEGER_TOKEN.test(tokens[end + 1] as string)
245
- )
246
- end += 1;
247
- const run = tokens.slice(i, end + 1);
248
- return {
249
- stem: tokens.slice(0, i),
250
- version: run.map((part) => Number.parseInt(part, 10)),
251
- versionText: run.join("-"),
252
- rest: tokens.slice(end + 1),
253
- };
254
- }
255
- return null;
256
- };
257
-
258
- const toVersionTuple = (text: string): TModelVersion | null => {
259
- const parts = text
260
- .split(/[-.]/)
261
- .filter((part) => part.length > 0)
262
- .map((part) => Number.parseInt(part, 10));
263
- if (parts.length === 0 || parts.some((part) => Number.isNaN(part)))
264
- return null;
265
- return parts;
266
- };
267
-
268
- const splitNamespace = (
269
- raw: string,
270
- namespaces: ReadonlySet<string>,
271
- ): { readonly provider: string | null; readonly providerModelId: string } => {
272
- const slash = raw.indexOf("/");
273
- if (slash <= 0) return { provider: null, providerModelId: raw };
274
- const head = raw.slice(0, slash);
275
- if (!namespaces.has(head.toLowerCase()))
276
- return { provider: null, providerModelId: raw };
277
- return { provider: head, providerModelId: raw.slice(slash + 1) };
278
- };
279
-
280
- const uniqueSorted = (values: ReadonlyArray<string>): ReadonlyArray<string> =>
281
- [...new Set(values)].sort();
282
-
283
- /** The id with any date-like suffix removed, plus the suffix itself. */
284
- const splitSnapshot = (
285
- value: string,
286
- ): { readonly remainder: string; readonly snapshot: string | null } => {
287
- for (const pattern of SNAPSHOT_PATTERNS) {
288
- const hit = value.match(pattern);
289
- if (hit?.[1] !== undefined && hit.index !== undefined)
290
- return { remainder: value.slice(0, hit.index), snapshot: hit[1] };
291
- }
292
- return { remainder: value, snapshot: null };
293
- };
294
-
295
- const stripSnapshot = (value: string): string => splitSnapshot(value).remainder;
296
-
297
- const parseIdentity = (
298
- raw: string,
299
- compiled: TCompiledRules,
300
- splitNamespacePrefix: boolean,
301
- ): TModelIdentity => {
302
- const { provider, providerModelId } = splitNamespacePrefix
303
- ? splitNamespace(raw, compiled.namespaces)
304
- : { provider: null, providerModelId: raw };
305
-
306
- const { remainder, snapshot } = splitSnapshot(providerModelId);
307
-
308
- const allTokens = remainder
309
- .toLowerCase()
310
- .split(TOKEN_SPLIT)
311
- .filter((token) => token.length > 0);
312
-
313
- // The version span is read structurally from the id itself.
314
- const span = findVersionSpan(allTokens, compiled.versionStems);
315
- const version: TModelVersion | null = span === null ? null : span.version;
316
- const versionText: string | null = span === null ? null : span.versionText;
317
-
318
- // Variant vocabulary stays a SET rather than "whatever followed the
319
- // version", because a query is parsed by the same code as a catalog
320
- // id: `5.6-s` is a truncated shorthand, not a request for a variant
321
- // called `s`. A token the corpus has never shown after a version is
322
- // therefore family text, and the boundary tier can still prefix-match
323
- // it. The set itself is derived, never authored — see
324
- // `deriveModelIdentityRules`.
325
- //
326
- // POSITION decides first, though. A variant MODIFIES a family, so it
327
- // can only appear after the version the family is a version OF: the
328
- // `tts` of `gemini-2.5-flash-preview-tts` is a modifier, while the
329
- // `tts` of `tts-1` IS the family. Classifying by vocabulary alone let
330
- // the second one evaporate into a variant, leaving an EMPTY family
331
- // that compared equal to every other empty one — which is how
332
- // `openai/tts-2` came to inherit another vendor's voices.
333
- const variants: string[] = [];
334
- let familyTokens: string[];
335
- if (span === null) {
336
- // No version means nothing to modify, so there is no variant to
337
- // read: the whole name is the identity. This is also what keeps a
338
- // versionless id and a versionless QUERY parsing alike, so the
339
- // shorthand `grok-code` still reaches `grok-code-1.2`.
340
- familyTokens = [...allTokens];
341
- } else {
342
- familyTokens = [...span.stem];
343
- for (const token of span.rest) {
344
- if (compiled.variantTokens.has(token)) variants.push(token);
345
- else familyTokens.push(token);
346
- }
347
- }
348
-
349
- return {
350
- raw,
351
- provider,
352
- providerModelId,
353
- family: familyTokens.join("-"),
354
- version,
355
- versionText,
356
- snapshot,
357
- variants: uniqueSorted(variants),
358
- };
359
- };
360
-
361
- /**
362
- * Parse a model id into its comparable parts. Pure and total — an
363
- * unparseable id simply yields a family with no version, which every
364
- * caller treats as "no confident match" rather than an error.
365
- *
366
- * A recognised routing namespace is split off, so this is the parser for
367
- * REQUEST input (`cursor/grok-4.7`). For an id that already arrived with
368
- * its provider alongside it, use `parseUpstreamModelIdentity`.
369
- */
370
- export const parseModelIdentity = (
371
- raw: string,
372
- rules?: TModelIdentityRules,
373
- ): TModelIdentity => parseIdentity(raw, compileRules(rules), true);
374
-
375
- /**
376
- * Parse an UPSTREAM model id whose provider is already known separately.
377
- *
378
- * No namespace is ever split off here: a custom endpoint may legitimately
379
- * serve `openai/gpt-5.6`, and that whole string is the id to send
380
- * upstream. Splitting it because `openai` happens to be a routing
381
- * namespace elsewhere would corrupt the execution identity of a model
382
- * belonging to a different provider.
383
- */
384
- export const parseUpstreamModelIdentity = (
385
- providerModelId: string,
386
- rules?: TModelIdentityRules,
387
- ): TModelIdentity => parseIdentity(providerModelId, compileRules(rules), false);
388
-
389
- /** One row of the corpus the rules are derived from. */
390
- export type TModelCorpusEntry = {
391
- readonly provider: string;
392
- readonly providerModelId: string;
393
- };
394
-
395
- const derivedCache = new WeakMap<object, TModelIdentityRules>();
396
-
397
- /**
398
- * Derive the identity rules from the model corpus ITSELF — the catalog
399
- * teaches the engine its own vocabulary, so adding a model row requires
400
- * no rule maintenance anywhere.
401
- *
402
- * Two things are derived, and nothing else:
403
- *
404
- * - `namespaces`: the provider slugs the corpus actually contains, so
405
- * `cursor/grok-4.7` splits while a custom endpoint's `org/model`
406
- * stays whole.
407
- * - `variantTokens`: every non-numeric token the corpus shows AFTER a
408
- * version span (`gpt-5.6-sol` → `sol`, `sora-2-pro` → `pro`). That
409
- * is what separates `gpt-5.4` from `gpt-5.4-mini` and keeps
410
- * `gemini-3.5-flash` from donating to `gemini-3.1-pro`, with no list
411
- * to maintain.
412
- *
413
- * Family and version structure is NOT derived: it is read structurally
414
- * per id (see `findVersionSpan`), so `claude-fable-5` and
415
- * `claude-fable-5-1` are one family at versions `[5]` and `[5,1]`
416
- * whether or not any sibling exists to compare them against.
417
- *
418
- * Memoised on the identity of the array passed in, so a catalog built
419
- * once yields ONE rules object for the process — which is what keeps the
420
- * per-object pattern cache, and any candidate index a caller keys off
421
- * it, from missing on every request.
422
- */
423
- export const deriveModelIdentityRules = (
424
- models: ReadonlyArray<TModelCorpusEntry>,
425
- ): TModelIdentityRules => {
426
- const cached = derivedCache.get(models);
427
- if (cached !== undefined) return cached;
428
-
429
- const namespaces = new Set<string>();
430
- const variantTokens = new Set<string>();
431
- const tokenised: Array<ReadonlyArray<string>> = [];
432
- // Pass 1 — evidence. Which word-stems does this corpus actually show
433
- // carrying a generation number, and across how many DISTINCT numbers?
434
- // One sighting is not a series (`q4` alone is quantization); two or
435
- // more is (`k2.5`, `k2.6`, `k3`).
436
- const stemNumbers = new Map<string, Set<string>>();
437
- const note = (stem: string, numeric: string): void => {
438
- const key = stem.toLowerCase();
439
- const seen = stemNumbers.get(key);
440
- if (seen === undefined) stemNumbers.set(key, new Set([numeric]));
441
- else seen.add(numeric);
442
- };
443
- for (const model of models) {
444
- if (model.provider.length > 0) namespaces.add(model.provider.toLowerCase());
445
- const tokens = stripSnapshot(model.providerModelId.toLowerCase())
446
- .split(TOKEN_SPLIT)
447
- .filter((token) => token.length > 0);
448
- tokenised.push(tokens);
449
- for (const token of tokens) {
450
- const suffixed = token.match(SUFFIXED_DOTTED_VERSION);
451
- if (
452
- suffixed?.[1] !== undefined &&
453
- suffixed[2] !== undefined &&
454
- suffixed[1].length > 0
455
- ) {
456
- note(suffixed[1], suffixed[2]);
457
- continue;
458
- }
459
- const attached = token.match(ATTACHED_VERSION);
460
- if (attached?.[1] !== undefined && attached[2] !== undefined)
461
- note(attached[1], attached[2]);
462
- }
463
- }
464
- const versionStems = new Set(
465
- [...stemNumbers].filter(([, seen]) => seen.size > 1).map(([stem]) => stem),
466
- );
467
-
468
- // Pass 2 — the same evidence read from the OTHER spelling. A word the
469
- // corpus shows immediately before a separated version token is
470
- // carrying that release just as plainly as a welded one does
471
- // (`imagen-4.0-…`, `veo-3.1-…`), and here the number's role is not in
472
- // doubt — it was already read as a version — so one sighting is
473
- // enough. That is what lets a compressed `imagen5`/`veo4` land in its
474
- // own family instead of becoming a family nobody has ever seen.
475
- //
476
- // Collected into a SEPARATE set and merged only once the pass is over:
477
- // feeding a stem back into the set mid-loop would let a row parsed
478
- // early change how a later row parses, so the rules would depend on
479
- // the order the catalog happens to list its providers in.
480
- const precedingStems = new Set<string>();
481
- for (const tokens of tokenised) {
482
- const span = findVersionSpan(tokens, versionStems);
483
- const last = span?.stem[span.stem.length - 1];
484
- if (last !== undefined && /^[a-z]+$/.test(last)) precedingStems.add(last);
485
- }
486
- for (const stem of precedingStems) versionStems.add(stem);
487
-
488
- // Pass 3 — vocabulary. With the evidence in hand the spans are final,
489
- // so whatever trails one is a variant.
490
- for (const tokens of tokenised) {
491
- const span = findVersionSpan(tokens, versionStems);
492
- if (span === null) continue;
493
- for (const token of span.rest) {
494
- if (!INTEGER_TOKEN.test(token)) variantTokens.add(token);
495
- }
496
- }
497
-
498
- // Variant matching stays STRICT on purpose. An earlier pass derived
499
- // "family-inherent" variants — tokens every member of a family
500
- // happens to carry — and dropped them from the comparison, so that a
501
- // compressed `veo4` could reach `veo-3.1-generate-preview`. It is not
502
- // worth it: in a sparse corner of the catalog (one family with two
503
- // rows, or a subscription twin pair) a genuinely meaningful `flash` /
504
- // `mini` / `pro` is "always present" by accident, and erasing it
505
- // donates a specialised model's facts to a new BASE model. The real
506
- // successors — `imagen-5.0-generate-001`, `veo-4.0-generate-preview`
507
- // — carry the same post-version variants as their predecessors
508
- // anyway, so relaxing the version range already covers them.
509
- const derived: TModelIdentityRules = Object.freeze({
510
- namespaces: Object.freeze([...namespaces].sort()),
511
- variantTokens: Object.freeze([...variantTokens].sort()),
512
- versionStems: Object.freeze([...versionStems].sort()),
513
- });
514
- derivedCache.set(models, derived);
515
- return derived;
516
- };
517
-
518
- /**
519
- * Ascending numeric comparison. Shorter tuples are zero-padded (`4` ==
520
- * `4.0`) and an unknown version sorts lowest, so a versionless entry never
521
- * outranks a known release.
522
- */
523
- export const compareModelVersion = (
524
- a: TModelVersion | null,
525
- b: TModelVersion | null,
526
- ): number => {
527
- if (a === null && b === null) return 0;
528
- if (a === null) return -1;
529
- if (b === null) return 1;
530
- const length = Math.max(a.length, b.length);
531
- for (let i = 0; i < length; i += 1) {
532
- const left = a[i] ?? 0;
533
- const right = b[i] ?? 0;
534
- if (left !== right) return left < right ? -1 : 1;
535
- }
536
- return 0;
537
- };
538
-
539
- /**
540
- * Same comparable family.
541
- *
542
- * Families are derived from the ids themselves, so two spellings of one
543
- * family already agree by construction and there is nothing left for a
544
- * rename table to reconcile.
545
- */
546
- export const isComparableFamily = (
547
- a: TModelIdentity,
548
- b: TModelIdentity,
549
- ): boolean => a.family.length > 0 && a.family === b.family;
550
-
551
- /** Identical meaningful variants — never a cross-variant match. */
552
- export const isSameVariant = (a: TModelIdentity, b: TModelIdentity): boolean =>
553
- a.variants.length === b.variants.length &&
554
- a.variants.every((variant, index) => variant === b.variants[index]);
555
-
556
- /** One eligible row, already carrying its parsed identity. */
557
- export type TModelCandidate<TValue> = {
558
- /** Full routing id — the final, totally-ordered tie-break. */
559
- readonly id: string;
560
- readonly provider: string;
561
- readonly identity: TModelIdentity;
562
- /** The caller's entry, returned untouched. */
563
- readonly value: TValue;
564
- /** Preferred class; LOWER wins (e.g. subscription 0, metered 1). */
565
- readonly classRank?: number;
566
- /** Authored provider priority within a class; lower wins. */
567
- readonly providerRank?: number;
568
- };
569
-
570
- export type TModelCandidateInput<TValue> = {
571
- readonly id: string;
572
- readonly provider: string;
573
- readonly providerModelId: string;
574
- readonly value: TValue;
575
- readonly classRank?: number;
576
- readonly providerRank?: number;
577
- };
578
-
579
- export const buildModelCandidate = <TValue>(
580
- input: TModelCandidateInput<TValue>,
581
- rules?: TModelIdentityRules,
582
- ): TModelCandidate<TValue> => ({
583
- id: input.id,
584
- provider: input.provider,
585
- identity: parseUpstreamModelIdentity(input.providerModelId, rules),
586
- value: input.value,
587
- ...(input.classRank === undefined ? {} : { classRank: input.classRank }),
588
- ...(input.providerRank === undefined
589
- ? {}
590
- : { providerRank: input.providerRank }),
591
- });
592
-
593
- /** Build a whole index at once; rule patterns compile once for the batch. */
594
- export const buildModelCandidates = <TValue>(
595
- inputs: ReadonlyArray<TModelCandidateInput<TValue>>,
596
- rules?: TModelIdentityRules,
597
- ): ReadonlyArray<TModelCandidate<TValue>> =>
598
- inputs.map((input) => buildModelCandidate(input, rules));
599
-
600
- export type TModelMatchReason =
601
- | "exact_id"
602
- | "exact_provider_model_id"
603
- | "terminal_suffix"
604
- | "family_version"
605
- | "family_newest"
606
- | "prefix"
607
- | "boundary";
608
-
609
- export type TModelSelection<TValue> =
610
- | {
611
- readonly kind: "selected";
612
- readonly candidate: TModelCandidate<TValue>;
613
- readonly reason: TModelMatchReason;
614
- /** Every candidate that survived narrowing, best first. */
615
- readonly considered: ReadonlyArray<TModelCandidate<TValue>>;
616
- }
617
- | {
618
- readonly kind: "ambiguous";
619
- readonly reason: TModelMatchReason;
620
- readonly candidates: ReadonlyArray<TModelCandidate<TValue>>;
621
- }
622
- | { readonly kind: "none" };
623
-
624
- export type TSelectRequestModelOptions<TValue> = {
625
- readonly rules?: TModelIdentityRules;
626
- /**
627
- * Eligibility runs BEFORE any narrowing, which is the whole point: an
628
- * unavailable newest version must not eliminate an available older one.
629
- */
630
- readonly isEligible?: (candidate: TModelCandidate<TValue>) => boolean;
631
- };
632
-
633
- const MAX_RANK = Number.MAX_SAFE_INTEGER;
634
-
635
- const compareStrings = (a: string, b: string): number =>
636
- a === b ? 0 : a < b ? -1 : 1;
637
-
638
- /**
639
- * Snapshot precedence at an equal version, as a TOTAL order.
640
- *
641
- * Two rules, both unconditional, because a comparator that only
642
- * sometimes consults a key can produce a cycle (A beats B on snapshot,
643
- * B beats C on provider, C beats A on snapshot):
644
- *
645
- * 1. A STABLE ALIAS outranks any pinned build. The alias is the id
646
- * the vendor keeps pointing at its current build, so it is what a
647
- * family shorthand means; this also preserves the pre-existing
648
- * behaviour for every family that has one.
649
- * 2. Between two builds the NEWER wins — `-002` over `-001`, the
650
- * later date over the earlier — instead of whichever id happened
651
- * to sort first alphabetically.
652
- *
653
- * Builds are compared by their digits as a number, so dates and short
654
- * build ids each order correctly among themselves and the mixed case
655
- * (which no real family produces) is still deterministic.
656
- */
657
- const snapshotOrdinal = (snapshot: string | null): number =>
658
- snapshot === null
659
- ? Number.NEGATIVE_INFINITY
660
- : Number(snapshot.replace(/\D/g, ""));
661
-
662
- const compareSnapshots = (a: TModelIdentity, b: TModelIdentity): number => {
663
- const aliasA = a.snapshot === null;
664
- const aliasB = b.snapshot === null;
665
- if (aliasA !== aliasB) return aliasA ? -1 : 1;
666
- if (aliasA) return 0;
667
- const left = snapshotOrdinal(a.snapshot);
668
- const right = snapshotOrdinal(b.snapshot);
669
- if (left !== right && Number.isFinite(left) && Number.isFinite(right))
670
- return left < right ? 1 : -1;
671
- return compareStrings(a.snapshot ?? "", b.snapshot ?? "");
672
- };
673
-
674
- /**
675
- * Total order for EQUIVALENT request candidates, best first: newest
676
- * version, then preferred class, then authored provider rank, then
677
- * snapshot precedence, then provider slug, then full id. Version leads
678
- * deliberately — an older subscription model must not beat a newer
679
- * available one on provider preference alone — and snapshot precedence
680
- * sits ahead of the provider/id tie so a rebuild is chosen for being
681
- * newer rather than for sorting later.
682
- *
683
- * Every component is a total order on a key and they are composed
684
- * lexicographically, so the result is total, transitive and free of
685
- * cycles regardless of which fields the candidates happen to carry.
686
- */
687
- export const compareRequestCandidates = <TValue>(
688
- a: TModelCandidate<TValue>,
689
- b: TModelCandidate<TValue>,
690
- ): number => {
691
- const byVersion = compareModelVersion(b.identity.version, a.identity.version);
692
- if (byVersion !== 0) return byVersion;
693
- const byClass = (a.classRank ?? MAX_RANK) - (b.classRank ?? MAX_RANK);
694
- if (byClass !== 0) return byClass;
695
- const byProviderRank =
696
- (a.providerRank ?? MAX_RANK) - (b.providerRank ?? MAX_RANK);
697
- if (byProviderRank !== 0) return byProviderRank;
698
- const bySnapshot = compareSnapshots(a.identity, b.identity);
699
- if (bySnapshot !== 0) return bySnapshot;
700
- const byProvider = compareStrings(
701
- a.provider.toLowerCase(),
702
- b.provider.toLowerCase(),
703
- );
704
- if (byProvider !== 0) return byProvider;
705
- return compareStrings(a.id, b.id);
706
- };
707
-
708
- /** Escape a literal for embedding in a `RegExp` source. */
709
- const escapeRegExp = (value: string): string =>
710
- value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
711
-
712
- /**
713
- * Hyphen-boundary matcher, preserving the existing shorthand rules: a
714
- * single word must be a WHOLE token (so `sol` misses `solstice`), while a
715
- * multi-segment shorthand may prefix-match after a boundary (`5.6-s` hits
716
- * `gpt-5.6-sol`).
717
- *
718
- * Compiled ONCE per query — the segment count is read from the text as the
719
- * caller typed it, which is why this cannot be derived from the parsed
720
- * family: parsing lifts the version out, and `5.6-s` would collapse to the
721
- * single token `s` and silently become a whole-token match.
722
- */
723
- const compileBoundaryMatcher = (query: string): RegExp | null => {
724
- if (query.length === 0) return null;
725
- const escaped = escapeRegExp(query);
726
- const multiSegment = query.split("-").filter((s) => s.length > 0).length > 1;
727
- return new RegExp(
728
- multiSegment ? `(?:^|-)${escaped}` : `(?:^|-)${escaped}(?:$|-)`,
729
- );
730
- };
731
-
732
- const isVersionPrefix = (
733
- constraint: TModelVersion,
734
- candidate: TModelVersion | null,
735
- ): boolean =>
736
- candidate !== null &&
737
- constraint.length <= candidate.length &&
738
- constraint.every((part, index) => candidate[index] === part);
739
-
740
- const hasAllVariants = (
741
- query: TModelIdentity,
742
- candidate: TModelIdentity,
743
- ): boolean =>
744
- query.variants.every((variant) => candidate.variants.includes(variant));
745
-
746
- /**
747
- * Split candidates into comparable-family groups. More than one group means
748
- * the input spans unrelated families (`pro`, `mini`) and must stay
749
- * ambiguous rather than picking an unrelated model.
750
- */
751
- const groupByFamily = <TValue>(
752
- candidates: ReadonlyArray<TModelCandidate<TValue>>,
753
- ): ReadonlyArray<ReadonlyArray<TModelCandidate<TValue>>> => {
754
- const groups: Array<Array<TModelCandidate<TValue>>> = [];
755
- for (const candidate of candidates) {
756
- const group = groups.find((existing) => {
757
- const head = existing[0];
758
- return (
759
- head !== undefined &&
760
- isComparableFamily(head.identity, candidate.identity)
761
- );
762
- });
763
- if (group === undefined) groups.push([candidate]);
764
- else group.push(candidate);
765
- }
766
- return groups;
767
- };
768
-
769
- const variantKey = (identity: TModelIdentity): string =>
770
- identity.variants.join("\u0000");
771
-
772
- /**
773
- * True when the NEWEST generation among `ordered` offers more than one
774
- * distinct variant set. Used only for tiers where the query names fewer
775
- * variants than the candidates carry (`gpt-5.6` vs `gpt-5.6-luna` /
776
- * `-sol` / `-terra`): the caller did not say which sibling, so picking
777
- * one by slug order would be a guess. Rows sharing a variant set across
778
- * providers are ONE choice (provider preference still decides between
779
- * them), and an older generation's extra variants never cause ambiguity.
780
- */
781
- const hasCompetingVariantsAtNewest = <TValue>(
782
- ordered: ReadonlyArray<TModelCandidate<TValue>>,
783
- ): boolean => {
784
- const best = ordered[0];
785
- if (best === undefined) return false;
786
- const keys = new Set<string>();
787
- for (const c of ordered) {
788
- if (compareModelVersion(c.identity.version, best.identity.version) !== 0)
789
- continue;
790
- keys.add(variantKey(c.identity));
791
- if (keys.size > 1) return true;
792
- }
793
- return false;
794
- };
795
-
796
- const decide = <TValue>(
797
- matches: ReadonlyArray<TModelCandidate<TValue>>,
798
- reason: TModelMatchReason,
799
- variantOpen = false,
800
- ): TModelSelection<TValue> => {
801
- const ordered = [...matches].sort(compareRequestCandidates);
802
- const best = ordered[0];
803
- if (best === undefined) return { kind: "none" };
804
- if (groupByFamily(ordered).length > 1)
805
- return { kind: "ambiguous", reason, candidates: ordered };
806
- if (variantOpen && hasCompetingVariantsAtNewest(ordered))
807
- return { kind: "ambiguous", reason, candidates: ordered };
808
- return { kind: "selected", candidate: best, reason, considered: ordered };
809
- };
810
-
811
- /**
812
- * Resolve a possibly-imprecise request model against already-scoped
813
- * candidates.
814
- *
815
- * Stages, in order: eligibility → exact identity → intent narrowing →
816
- * newest within the family → deterministic tie-break. Explicit input is
817
- * never upgraded: an exact `grok-4.6` stays on 4.6 even when 4.7 is
818
- * available, and a version fragment (`grok-4.6`) only ever selects a
819
- * maximum WITHIN that fragment.
820
- *
821
- * Nothing here decides availability, auth, or surface support — the caller
822
- * expresses all of that through `isEligible`, and a `none`/`ambiguous`
823
- * result means the caller keeps its existing passthrough/error behaviour.
824
- */
825
- export const selectRequestModel = <TValue>(
826
- query: string,
827
- candidates: ReadonlyArray<TModelCandidate<TValue>>,
828
- options: TSelectRequestModelOptions<TValue> = {},
829
- ): TModelSelection<TValue> => {
830
- const rules = options.rules;
831
- const trimmed = query.trim();
832
- if (trimmed.length === 0) return { kind: "none" };
833
-
834
- const eligible =
835
- options.isEligible === undefined
836
- ? candidates
837
- : candidates.filter(options.isEligible);
838
- if (eligible.length === 0) return { kind: "none" };
839
-
840
- const lowered = trimmed.toLowerCase();
841
-
842
- const exactId = eligible.filter((c) => c.id.toLowerCase() === lowered);
843
- if (exactId.length > 0) return decide(exactId, "exact_id");
844
-
845
- const exactProviderModelId = eligible.filter(
846
- (c) => c.identity.providerModelId.toLowerCase() === lowered,
847
- );
848
- if (exactProviderModelId.length > 0)
849
- return decide(exactProviderModelId, "exact_provider_model_id");
850
-
851
- const intent = parseModelIdentity(trimmed, rules);
852
-
853
- let pool = eligible;
854
- if (intent.provider !== null) {
855
- const wanted = intent.provider.toLowerCase();
856
- pool = pool.filter((c) => c.provider.toLowerCase() === wanted);
857
- }
858
- if (intent.version !== null) {
859
- pool = pool.filter((c) =>
860
- isVersionPrefix(intent.version as TModelVersion, c.identity.version),
861
- );
862
- }
863
- if (intent.snapshot !== null) {
864
- pool = pool.filter((c) => c.identity.snapshot === intent.snapshot);
865
- }
866
- if (pool.length === 0) return { kind: "none" };
867
-
868
- // A family-less query (pure variant words such as `pro`) matches any
869
- // family; the group check below is what keeps it honest.
870
- const familyExact = (c: TModelCandidate<TValue>): boolean =>
871
- intent.family.length === 0 || isComparableFamily(intent, c.identity);
872
- // Both matchers compile once per query, never per candidate row. The
873
- // second one matches the id as TYPED against the upstream id, which is
874
- // what keeps version-carrying shorthand (`5.6-s` → `gpt-5.6-sol`)
875
- // working: the family alone has already lost the `5.6`.
876
- const familyMatcher = compileBoundaryMatcher(intent.family);
877
- const upstreamMatcher = compileBoundaryMatcher(
878
- intent.providerModelId.toLowerCase(),
879
- );
880
- const familyBoundary = (c: TModelCandidate<TValue>): boolean =>
881
- (familyMatcher?.test(c.identity.family) ?? false) ||
882
- (upstreamMatcher?.test(c.identity.providerModelId.toLowerCase()) ?? false);
883
-
884
- const versionReason: TModelMatchReason =
885
- intent.version === null ? "family_newest" : "family_version";
886
-
887
- // Narrowing tiers, strongest first. The first non-empty tier decides, so
888
- // an exact-family plain model always beats a boundary or variant sibling.
889
- // Evaluated LAZILY: the overwhelmingly common exact-family hit never
890
- // scans the pool three more times.
891
- // An id that ENDS with the query on a token boundary is a named model,
892
- // not a family shorthand: `fable-5` means `claude-fable-5` and must not
893
- // drift onto the later `claude-fable-5-1`. It therefore outranks the
894
- // newest-in-family tiers, while still obeying the eligibility, provider
895
- // and variant constraints applied above.
896
- const terminalSuffix = `-${intent.providerModelId.toLowerCase()}`;
897
-
898
- const tiers: ReadonlyArray<{
899
- readonly matches: (c: TModelCandidate<TValue>) => boolean;
900
- readonly reason: TModelMatchReason;
901
- /** Query leaves some candidate variants unspecified. */
902
- readonly variantOpen?: boolean;
903
- }> = [
904
- {
905
- matches: (c) =>
906
- c.identity.providerModelId.toLowerCase().endsWith(terminalSuffix) &&
907
- hasAllVariants(intent, c.identity),
908
- reason: "terminal_suffix",
909
- variantOpen: true,
910
- },
911
- {
912
- matches: (c) => familyExact(c) && isSameVariant(intent, c.identity),
913
- reason: versionReason,
914
- },
915
- {
916
- matches: (c) => familyExact(c) && hasAllVariants(intent, c.identity),
917
- reason: versionReason,
918
- variantOpen: true,
919
- },
920
- {
921
- matches: (c) => familyBoundary(c) && isSameVariant(intent, c.identity),
922
- reason: "boundary",
923
- },
924
- {
925
- matches: (c) => familyBoundary(c) && hasAllVariants(intent, c.identity),
926
- reason: "prefix",
927
- variantOpen: true,
928
- },
929
- ];
930
-
931
- for (const tier of tiers) {
932
- const matches = pool.filter(tier.matches);
933
- if (matches.length === 0) continue;
934
- return decide(matches, tier.reason, tier.variantOpen === true);
935
- }
936
- return { kind: "none" };
937
- };
938
-
939
- export type TDonorRelation =
940
- | "exact"
941
- | "same_provider_predecessor"
942
- | "cross_provider_predecessor";
943
-
944
- export type TDonorSelection<TValue> =
945
- | {
946
- readonly kind: "donor";
947
- readonly donor: TModelCandidate<TValue>;
948
- readonly relation: TDonorRelation;
949
- }
950
- | { readonly kind: "none" };
951
-
952
- export type TSelectMetadataDonorOptions<TValue> = {
953
- readonly rules?: TModelIdentityRules;
954
- /** Exclude deprecated/synthesized rows — the caller owns that fact. */
955
- readonly isEligibleDonor?: (candidate: TModelCandidate<TValue>) => boolean;
956
- };
957
-
958
- /**
959
- * Pick the nearest authored donor for a target identity.
960
- *
961
- * Classes, strongest first: an exact id, then the greatest same-provider
962
- * version NOT EXCEEDING the target, then the same across providers. A
963
- * successor is never a donor — borrowing from a version that does not
964
- * exist yet would present a guess as a fact — and an unrelated family
965
- * yields `none` so the caller keeps its existing unknown-metadata
966
- * behaviour rather than inheriting from a nearest string.
967
- *
968
- * The engine returns a donor and a RELATION only. Which fields may be
969
- * inherited, and which (identity, lifecycle, routing policy, repair flags)
970
- * may never be, is the catalog's policy, not this module's.
971
- */
972
- export const selectMetadataDonor = <TValue>(
973
- target: TModelIdentity,
974
- donors: ReadonlyArray<TModelCandidate<TValue>>,
975
- options: TSelectMetadataDonorOptions<TValue> = {},
976
- ): TDonorSelection<TValue> => {
977
- const pool =
978
- options.isEligibleDonor === undefined
979
- ? donors
980
- : donors.filter(options.isEligibleDonor);
981
- if (pool.length === 0) return { kind: "none" };
982
-
983
- const targetProvider = target.provider?.toLowerCase() ?? null;
984
- const isSameProvider = (candidate: TModelCandidate<TValue>): boolean =>
985
- targetProvider !== null &&
986
- candidate.provider.toLowerCase() === targetProvider;
987
-
988
- const best = (
989
- matches: ReadonlyArray<TModelCandidate<TValue>>,
990
- ): TModelCandidate<TValue> | undefined =>
991
- [...matches].sort(compareRequestCandidates)[0];
992
-
993
- const lowered = target.providerModelId.toLowerCase();
994
- const exact = pool.filter(
995
- (c) => c.identity.providerModelId.toLowerCase() === lowered,
996
- );
997
- if (exact.length > 0) {
998
- const sameProvider = exact.filter(isSameProvider);
999
- const donor = best(sameProvider.length > 0 ? sameProvider : exact);
1000
- if (donor !== undefined) return { kind: "donor", donor, relation: "exact" };
1001
- }
1002
-
1003
- // A donor must not be a SUCCESSOR: borrowing from a version that does
1004
- // not exist yet presents a guess as a fact. That is the only version
1005
- // constraint.
1006
- //
1007
- // There was also a same-MAJOR gate here, on the theory that a major
1008
- // bump is where a vendor changes the facts. In practice it fenced off
1009
- // almost every media line the catalog actually has — `gpt-image-3`,
1010
- // `whisper-2`, `text-embedding-4-small`, the next Imagen and Veo —
1011
- // because those families number their generations in the major
1012
- // position, so EVERY successor was a major bump and inherited
1013
- // nothing. The gate is removed deliberately: what a donor may
1014
- // contribute is already constrained by category (identity, lifecycle,
1015
- // routing, repair flags and rates never cross; a cross-provider donor
1016
- // additionally contributes no provider-serving fact), everything it
1017
- // does contribute fills only fields the target left UNKNOWN, and the
1018
- // result is reported as inherited. A nearest known predecessor is
1019
- // better information than nothing, and the ordering below still
1020
- // prefers the closest one — so a same-major predecessor, when one
1021
- // exists, is the one chosen.
1022
- const withinInheritableRange = (donor: TModelIdentity): boolean => {
1023
- if (target.version === null || donor.version === null) return true;
1024
- return compareModelVersion(donor.version, target.version) <= 0;
1025
- };
1026
-
1027
- const predecessors = pool.filter(
1028
- (c) =>
1029
- isComparableFamily(target, c.identity) &&
1030
- isSameVariant(target, c.identity) &&
1031
- withinInheritableRange(c.identity),
1032
- );
1033
- if (predecessors.length === 0) return { kind: "none" };
1034
-
1035
- const sameProvider = predecessors.filter(isSameProvider);
1036
- const sameProviderDonor = best(sameProvider);
1037
- if (sameProviderDonor !== undefined)
1038
- return {
1039
- kind: "donor",
1040
- donor: sameProviderDonor,
1041
- relation: "same_provider_predecessor",
1042
- };
1043
-
1044
- const crossProviderDonor = best(predecessors);
1045
- if (crossProviderDonor === undefined) return { kind: "none" };
1046
- return {
1047
- kind: "donor",
1048
- donor: crossProviderDonor,
1049
- relation: "cross_provider_predecessor",
1050
- };
1051
- };