@openllmsh/sdk 2.10.12-alpha.1 → 2.10.12

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
@@ -0,0 +1,760 @@
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
+ const EMPTY_COMPILED = {
32
+ namespaces: new Set(),
33
+ variantTokens: new Set(),
34
+ versionStems: new Set(),
35
+ };
36
+ /**
37
+ * Patterns are compiled ONCE per rules object and cached against it, so a
38
+ * catalog index built from one rules value never recompiles per row.
39
+ */
40
+ const compiledCache = new WeakMap();
41
+ const compileRules = (rules) => {
42
+ if (rules === undefined)
43
+ return EMPTY_COMPILED;
44
+ const cached = compiledCache.get(rules);
45
+ if (cached !== undefined)
46
+ return cached;
47
+ const compiled = {
48
+ namespaces: new Set((rules.namespaces ?? []).map((value) => value.toLowerCase())),
49
+ variantTokens: new Set((rules.variantTokens ?? []).map((value) => value.toLowerCase())),
50
+ versionStems: new Set((rules.versionStems ?? []).map((value) => value.toLowerCase())),
51
+ };
52
+ compiledCache.set(rules, compiled);
53
+ return compiled;
54
+ };
55
+ /**
56
+ * Date-like suffixes, longest/most specific shape first. Stripped BEFORE
57
+ * version parsing so a dotted date can never be read as `1.2.3`.
58
+ */
59
+ const SNAPSHOT_PATTERNS = [
60
+ /[-_@](\d{4}-\d{2}-\d{2})$/,
61
+ /[-_@](\d{4}\.\d{2}\.\d{2})$/,
62
+ /[-_@](\d{8})$/,
63
+ // A ZERO-PADDED build number — Google's `-001` / `-002`, OpenAI's
64
+ // `-0125`. Listed last so a date always wins.
65
+ //
66
+ // The leading zero is the whole discriminator, and it is why this is
67
+ // not simply "three or four digits". A release number is written the
68
+ // way the vendor says it (`4`, `4.0`, `4-8`, and one day `999` or
69
+ // `1000`) and is never padded to a fixed width, so a padded run can
70
+ // only be a build id, while an unpadded one is left alone to be read
71
+ // as the version or family text it is. `imagen-4.0-generate-001`
72
+ // therefore keeps `[4, 0]` as its version and carries `001` as its
73
+ // snapshot, which is what makes the `-002` rebuild the SAME model
74
+ // rather than a family of its own.
75
+ /[-_@](0\d{2,3})$/,
76
+ ];
77
+ /**
78
+ * Tokenisation keeps `.` INSIDE a token so a dotted version survives as
79
+ * one unit (`grok-4.7` → `grok` + `4.7`). Everything else separates.
80
+ */
81
+ const TOKEN_SPLIT = /[-/_\s:]+/;
82
+ /** A whole token that is nothing but a dotted number: `4.7`, `4.10.1`. */
83
+ const DOTTED_VERSION = /^(\d+(?:\.\d+)+)$/;
84
+ /** A dotted number glued to a leading word: `qwen3.6`. */
85
+ const SUFFIXED_DOTTED_VERSION = /^(.*?)(\d+(?:\.\d+)+)$/;
86
+ /** A whole token that is a bare integer: the `4` and `8` of `opus-4-8`. */
87
+ const INTEGER_TOKEN = /^\d+$/;
88
+ /**
89
+ * A word with a generation number welded onto it: `k3`, `qwen3`, `o4`.
90
+ *
91
+ * The letter/digit ORDER is the whole discriminator, and it is what
92
+ * separates a version from a size. Letters-then-digits is a generation
93
+ * (`k3`); digits-then-letters is a measurement — parameter counts
94
+ * (`8b`, `32b`), context windows (`16k`, `128k`), quantization, and
95
+ * `4o`-style suffixes — and never matches here.
96
+ */
97
+ const ATTACHED_VERSION = /^([A-Za-z]+)(\d+)$/;
98
+ /**
99
+ * Locate the release version STRUCTURALLY, with no vocabulary at all.
100
+ *
101
+ * Two shapes, in order:
102
+ * 1. a dotted number, alone (`4.7`) or glued to a word (`qwen3.6`);
103
+ * 2. otherwise, a run of bare integers that FOLLOWS a word — this is
104
+ * what makes `opus-4-8` and `fable-5` versions of one family
105
+ * without anyone authoring a regex for either.
106
+ *
107
+ * What it refuses is as important as what it accepts. The run must be
108
+ * preceded by a word, so an id that is only digits has no version.
109
+ * Snapshots are stripped before this runs, so a date can never reach it.
110
+ * Sizes, context windows and quantization (`8b`, `128k`, `1.5b`) carry a
111
+ * letter and therefore match neither shape. That is the whole
112
+ * no-speculative-parsing rule, expressed as structure rather than as a
113
+ * list somebody has to maintain.
114
+ */
115
+ const findVersionSpan = (tokens, versionStems) => {
116
+ for (let i = 0; i < tokens.length; i += 1) {
117
+ const token = tokens[i];
118
+ const dotted = token.match(DOTTED_VERSION);
119
+ if (dotted?.[1] !== undefined) {
120
+ return {
121
+ stem: tokens.slice(0, i),
122
+ version: toVersionTuple(dotted[1]) ?? [],
123
+ versionText: dotted[1],
124
+ rest: tokens.slice(i + 1),
125
+ };
126
+ }
127
+ const suffixed = token.match(SUFFIXED_DOTTED_VERSION);
128
+ if (suffixed?.[2] !== undefined && suffixed[1] !== undefined) {
129
+ const head = suffixed[1];
130
+ return {
131
+ stem: head.length > 0 ? [...tokens.slice(0, i), head] : tokens.slice(0, i),
132
+ version: toVersionTuple(suffixed[2]) ?? [],
133
+ versionText: suffixed[2],
134
+ rest: tokens.slice(i + 1),
135
+ };
136
+ }
137
+ const attached = token.match(ATTACHED_VERSION);
138
+ if (attached?.[1] !== undefined &&
139
+ attached[2] !== undefined &&
140
+ versionStems.has(attached[1].toLowerCase())) {
141
+ return {
142
+ stem: [...tokens.slice(0, i), attached[1]],
143
+ version: [Number.parseInt(attached[2], 10)],
144
+ versionText: attached[2],
145
+ rest: tokens.slice(i + 1),
146
+ };
147
+ }
148
+ }
149
+ for (let i = 1; i < tokens.length; i += 1) {
150
+ if (!INTEGER_TOKEN.test(tokens[i]))
151
+ continue;
152
+ let end = i;
153
+ while (end + 1 < tokens.length &&
154
+ INTEGER_TOKEN.test(tokens[end + 1]))
155
+ end += 1;
156
+ const run = tokens.slice(i, end + 1);
157
+ return {
158
+ stem: tokens.slice(0, i),
159
+ version: run.map((part) => Number.parseInt(part, 10)),
160
+ versionText: run.join("-"),
161
+ rest: tokens.slice(end + 1),
162
+ };
163
+ }
164
+ return null;
165
+ };
166
+ const toVersionTuple = (text) => {
167
+ const parts = text
168
+ .split(/[-.]/)
169
+ .filter((part) => part.length > 0)
170
+ .map((part) => Number.parseInt(part, 10));
171
+ if (parts.length === 0 || parts.some((part) => Number.isNaN(part)))
172
+ return null;
173
+ return parts;
174
+ };
175
+ const splitNamespace = (raw, namespaces) => {
176
+ const slash = raw.indexOf("/");
177
+ if (slash <= 0)
178
+ return { provider: null, providerModelId: raw };
179
+ const head = raw.slice(0, slash);
180
+ if (!namespaces.has(head.toLowerCase()))
181
+ return { provider: null, providerModelId: raw };
182
+ return { provider: head, providerModelId: raw.slice(slash + 1) };
183
+ };
184
+ const uniqueSorted = (values) => [...new Set(values)].sort();
185
+ /** The id with any date-like suffix removed, plus the suffix itself. */
186
+ const splitSnapshot = (value) => {
187
+ for (const pattern of SNAPSHOT_PATTERNS) {
188
+ const hit = value.match(pattern);
189
+ if (hit?.[1] !== undefined && hit.index !== undefined)
190
+ return { remainder: value.slice(0, hit.index), snapshot: hit[1] };
191
+ }
192
+ return { remainder: value, snapshot: null };
193
+ };
194
+ const stripSnapshot = (value) => splitSnapshot(value).remainder;
195
+ const parseIdentity = (raw, compiled, splitNamespacePrefix) => {
196
+ const { provider, providerModelId } = splitNamespacePrefix
197
+ ? splitNamespace(raw, compiled.namespaces)
198
+ : { provider: null, providerModelId: raw };
199
+ const { remainder, snapshot } = splitSnapshot(providerModelId);
200
+ const allTokens = remainder
201
+ .toLowerCase()
202
+ .split(TOKEN_SPLIT)
203
+ .filter((token) => token.length > 0);
204
+ // The version span is read structurally from the id itself.
205
+ const span = findVersionSpan(allTokens, compiled.versionStems);
206
+ const version = span === null ? null : span.version;
207
+ const versionText = span === null ? null : span.versionText;
208
+ // Variant vocabulary stays a SET rather than "whatever followed the
209
+ // version", because a query is parsed by the same code as a catalog
210
+ // id: `5.6-s` is a truncated shorthand, not a request for a variant
211
+ // called `s`. A token the corpus has never shown after a version is
212
+ // therefore family text, and the boundary tier can still prefix-match
213
+ // it. The set itself is derived, never authored — see
214
+ // `deriveModelIdentityRules`.
215
+ //
216
+ // POSITION decides first, though. A variant MODIFIES a family, so it
217
+ // can only appear after the version the family is a version OF: the
218
+ // `tts` of `gemini-2.5-flash-preview-tts` is a modifier, while the
219
+ // `tts` of `tts-1` IS the family. Classifying by vocabulary alone let
220
+ // the second one evaporate into a variant, leaving an EMPTY family
221
+ // that compared equal to every other empty one — which is how
222
+ // `openai/tts-2` came to inherit another vendor's voices.
223
+ const variants = [];
224
+ let familyTokens;
225
+ if (span === null) {
226
+ // No version means nothing to modify, so there is no variant to
227
+ // read: the whole name is the identity. This is also what keeps a
228
+ // versionless id and a versionless QUERY parsing alike, so the
229
+ // shorthand `grok-code` still reaches `grok-code-1.2`.
230
+ familyTokens = [...allTokens];
231
+ }
232
+ else {
233
+ familyTokens = [...span.stem];
234
+ for (const token of span.rest) {
235
+ if (compiled.variantTokens.has(token))
236
+ variants.push(token);
237
+ else
238
+ familyTokens.push(token);
239
+ }
240
+ }
241
+ return {
242
+ raw,
243
+ provider,
244
+ providerModelId,
245
+ family: familyTokens.join("-"),
246
+ version,
247
+ versionText,
248
+ snapshot,
249
+ variants: uniqueSorted(variants),
250
+ };
251
+ };
252
+ /**
253
+ * Parse a model id into its comparable parts. Pure and total — an
254
+ * unparseable id simply yields a family with no version, which every
255
+ * caller treats as "no confident match" rather than an error.
256
+ *
257
+ * A recognised routing namespace is split off, so this is the parser for
258
+ * REQUEST input (`cursor/grok-4.7`). For an id that already arrived with
259
+ * its provider alongside it, use `parseUpstreamModelIdentity`.
260
+ */
261
+ export const parseModelIdentity = (raw, rules) => parseIdentity(raw, compileRules(rules), true);
262
+ /**
263
+ * Parse an UPSTREAM model id whose provider is already known separately.
264
+ *
265
+ * No namespace is ever split off here: a custom endpoint may legitimately
266
+ * serve `openai/gpt-5.6`, and that whole string is the id to send
267
+ * upstream. Splitting it because `openai` happens to be a routing
268
+ * namespace elsewhere would corrupt the execution identity of a model
269
+ * belonging to a different provider.
270
+ */
271
+ export const parseUpstreamModelIdentity = (providerModelId, rules) => parseIdentity(providerModelId, compileRules(rules), false);
272
+ const derivedCache = new WeakMap();
273
+ /**
274
+ * Derive the identity rules from the model corpus ITSELF — the catalog
275
+ * teaches the engine its own vocabulary, so adding a model row requires
276
+ * no rule maintenance anywhere.
277
+ *
278
+ * Two things are derived, and nothing else:
279
+ *
280
+ * - `namespaces`: the provider slugs the corpus actually contains, so
281
+ * `cursor/grok-4.7` splits while a custom endpoint's `org/model`
282
+ * stays whole.
283
+ * - `variantTokens`: every non-numeric token the corpus shows AFTER a
284
+ * version span (`gpt-5.6-sol` → `sol`, `sora-2-pro` → `pro`). That
285
+ * is what separates `gpt-5.4` from `gpt-5.4-mini` and keeps
286
+ * `gemini-3.5-flash` from donating to `gemini-3.1-pro`, with no list
287
+ * to maintain.
288
+ *
289
+ * Family and version structure is NOT derived: it is read structurally
290
+ * per id (see `findVersionSpan`), so `claude-fable-5` and
291
+ * `claude-fable-5-1` are one family at versions `[5]` and `[5,1]`
292
+ * whether or not any sibling exists to compare them against.
293
+ *
294
+ * Memoised on the identity of the array passed in, so a catalog built
295
+ * once yields ONE rules object for the process — which is what keeps the
296
+ * per-object pattern cache, and any candidate index a caller keys off
297
+ * it, from missing on every request.
298
+ */
299
+ export const deriveModelIdentityRules = (models) => {
300
+ const cached = derivedCache.get(models);
301
+ if (cached !== undefined)
302
+ return cached;
303
+ const namespaces = new Set();
304
+ const variantTokens = new Set();
305
+ const tokenised = [];
306
+ // Pass 1 — evidence. Which word-stems does this corpus actually show
307
+ // carrying a generation number, and across how many DISTINCT numbers?
308
+ // One sighting is not a series (`q4` alone is quantization); two or
309
+ // more is (`k2.5`, `k2.6`, `k3`).
310
+ const stemNumbers = new Map();
311
+ const note = (stem, numeric) => {
312
+ const key = stem.toLowerCase();
313
+ const seen = stemNumbers.get(key);
314
+ if (seen === undefined)
315
+ stemNumbers.set(key, new Set([numeric]));
316
+ else
317
+ seen.add(numeric);
318
+ };
319
+ for (const model of models) {
320
+ if (model.provider.length > 0)
321
+ namespaces.add(model.provider.toLowerCase());
322
+ const tokens = stripSnapshot(model.providerModelId.toLowerCase())
323
+ .split(TOKEN_SPLIT)
324
+ .filter((token) => token.length > 0);
325
+ tokenised.push(tokens);
326
+ for (const token of tokens) {
327
+ const suffixed = token.match(SUFFIXED_DOTTED_VERSION);
328
+ if (suffixed?.[1] !== undefined &&
329
+ suffixed[2] !== undefined &&
330
+ suffixed[1].length > 0) {
331
+ note(suffixed[1], suffixed[2]);
332
+ continue;
333
+ }
334
+ const attached = token.match(ATTACHED_VERSION);
335
+ if (attached?.[1] !== undefined && attached[2] !== undefined)
336
+ note(attached[1], attached[2]);
337
+ }
338
+ }
339
+ const versionStems = new Set([...stemNumbers].filter(([, seen]) => seen.size > 1).map(([stem]) => stem));
340
+ // Pass 2 — the same evidence read from the OTHER spelling. A word the
341
+ // corpus shows immediately before a separated version token is
342
+ // carrying that release just as plainly as a welded one does
343
+ // (`imagen-4.0-…`, `veo-3.1-…`), and here the number's role is not in
344
+ // doubt — it was already read as a version — so one sighting is
345
+ // enough. That is what lets a compressed `imagen5`/`veo4` land in its
346
+ // own family instead of becoming a family nobody has ever seen.
347
+ //
348
+ // Collected into a SEPARATE set and merged only once the pass is over:
349
+ // feeding a stem back into the set mid-loop would let a row parsed
350
+ // early change how a later row parses, so the rules would depend on
351
+ // the order the catalog happens to list its providers in.
352
+ const precedingStems = new Set();
353
+ for (const tokens of tokenised) {
354
+ const span = findVersionSpan(tokens, versionStems);
355
+ const last = span?.stem[span.stem.length - 1];
356
+ if (last !== undefined && /^[a-z]+$/.test(last))
357
+ precedingStems.add(last);
358
+ }
359
+ for (const stem of precedingStems)
360
+ versionStems.add(stem);
361
+ // Pass 3 — vocabulary. With the evidence in hand the spans are final,
362
+ // so whatever trails one is a variant.
363
+ for (const tokens of tokenised) {
364
+ const span = findVersionSpan(tokens, versionStems);
365
+ if (span === null)
366
+ continue;
367
+ for (const token of span.rest) {
368
+ if (!INTEGER_TOKEN.test(token))
369
+ variantTokens.add(token);
370
+ }
371
+ }
372
+ // Variant matching stays STRICT on purpose. An earlier pass derived
373
+ // "family-inherent" variants — tokens every member of a family
374
+ // happens to carry — and dropped them from the comparison, so that a
375
+ // compressed `veo4` could reach `veo-3.1-generate-preview`. It is not
376
+ // worth it: in a sparse corner of the catalog (one family with two
377
+ // rows, or a subscription twin pair) a genuinely meaningful `flash` /
378
+ // `mini` / `pro` is "always present" by accident, and erasing it
379
+ // donates a specialised model's facts to a new BASE model. The real
380
+ // successors — `imagen-5.0-generate-001`, `veo-4.0-generate-preview`
381
+ // — carry the same post-version variants as their predecessors
382
+ // anyway, so relaxing the version range already covers them.
383
+ const derived = Object.freeze({
384
+ namespaces: Object.freeze([...namespaces].sort()),
385
+ variantTokens: Object.freeze([...variantTokens].sort()),
386
+ versionStems: Object.freeze([...versionStems].sort()),
387
+ });
388
+ derivedCache.set(models, derived);
389
+ return derived;
390
+ };
391
+ /**
392
+ * Ascending numeric comparison. Shorter tuples are zero-padded (`4` ==
393
+ * `4.0`) and an unknown version sorts lowest, so a versionless entry never
394
+ * outranks a known release.
395
+ */
396
+ export const compareModelVersion = (a, b) => {
397
+ if (a === null && b === null)
398
+ return 0;
399
+ if (a === null)
400
+ return -1;
401
+ if (b === null)
402
+ return 1;
403
+ const length = Math.max(a.length, b.length);
404
+ for (let i = 0; i < length; i += 1) {
405
+ const left = a[i] ?? 0;
406
+ const right = b[i] ?? 0;
407
+ if (left !== right)
408
+ return left < right ? -1 : 1;
409
+ }
410
+ return 0;
411
+ };
412
+ /**
413
+ * Same comparable family.
414
+ *
415
+ * Families are derived from the ids themselves, so two spellings of one
416
+ * family already agree by construction and there is nothing left for a
417
+ * rename table to reconcile.
418
+ */
419
+ export const isComparableFamily = (a, b) => a.family.length > 0 && a.family === b.family;
420
+ /** Identical meaningful variants — never a cross-variant match. */
421
+ export const isSameVariant = (a, b) => a.variants.length === b.variants.length &&
422
+ a.variants.every((variant, index) => variant === b.variants[index]);
423
+ export const buildModelCandidate = (input, rules) => ({
424
+ id: input.id,
425
+ provider: input.provider,
426
+ identity: parseUpstreamModelIdentity(input.providerModelId, rules),
427
+ value: input.value,
428
+ ...(input.classRank === undefined ? {} : { classRank: input.classRank }),
429
+ ...(input.providerRank === undefined
430
+ ? {}
431
+ : { providerRank: input.providerRank }),
432
+ });
433
+ /** Build a whole index at once; rule patterns compile once for the batch. */
434
+ export const buildModelCandidates = (inputs, rules) => inputs.map((input) => buildModelCandidate(input, rules));
435
+ const MAX_RANK = Number.MAX_SAFE_INTEGER;
436
+ const compareStrings = (a, b) => a === b ? 0 : a < b ? -1 : 1;
437
+ /**
438
+ * Snapshot precedence at an equal version, as a TOTAL order.
439
+ *
440
+ * Two rules, both unconditional, because a comparator that only
441
+ * sometimes consults a key can produce a cycle (A beats B on snapshot,
442
+ * B beats C on provider, C beats A on snapshot):
443
+ *
444
+ * 1. A STABLE ALIAS outranks any pinned build. The alias is the id
445
+ * the vendor keeps pointing at its current build, so it is what a
446
+ * family shorthand means; this also preserves the pre-existing
447
+ * behaviour for every family that has one.
448
+ * 2. Between two builds the NEWER wins — `-002` over `-001`, the
449
+ * later date over the earlier — instead of whichever id happened
450
+ * to sort first alphabetically.
451
+ *
452
+ * Builds are compared by their digits as a number, so dates and short
453
+ * build ids each order correctly among themselves and the mixed case
454
+ * (which no real family produces) is still deterministic.
455
+ */
456
+ const snapshotOrdinal = (snapshot) => snapshot === null
457
+ ? Number.NEGATIVE_INFINITY
458
+ : Number(snapshot.replace(/\D/g, ""));
459
+ const compareSnapshots = (a, b) => {
460
+ const aliasA = a.snapshot === null;
461
+ const aliasB = b.snapshot === null;
462
+ if (aliasA !== aliasB)
463
+ return aliasA ? -1 : 1;
464
+ if (aliasA)
465
+ return 0;
466
+ const left = snapshotOrdinal(a.snapshot);
467
+ const right = snapshotOrdinal(b.snapshot);
468
+ if (left !== right && Number.isFinite(left) && Number.isFinite(right))
469
+ return left < right ? 1 : -1;
470
+ return compareStrings(a.snapshot ?? "", b.snapshot ?? "");
471
+ };
472
+ /**
473
+ * Total order for EQUIVALENT request candidates, best first: newest
474
+ * version, then preferred class, then authored provider rank, then
475
+ * snapshot precedence, then provider slug, then full id. Version leads
476
+ * deliberately — an older subscription model must not beat a newer
477
+ * available one on provider preference alone — and snapshot precedence
478
+ * sits ahead of the provider/id tie so a rebuild is chosen for being
479
+ * newer rather than for sorting later.
480
+ *
481
+ * Every component is a total order on a key and they are composed
482
+ * lexicographically, so the result is total, transitive and free of
483
+ * cycles regardless of which fields the candidates happen to carry.
484
+ */
485
+ export const compareRequestCandidates = (a, b) => {
486
+ const byVersion = compareModelVersion(b.identity.version, a.identity.version);
487
+ if (byVersion !== 0)
488
+ return byVersion;
489
+ const byClass = (a.classRank ?? MAX_RANK) - (b.classRank ?? MAX_RANK);
490
+ if (byClass !== 0)
491
+ return byClass;
492
+ const byProviderRank = (a.providerRank ?? MAX_RANK) - (b.providerRank ?? MAX_RANK);
493
+ if (byProviderRank !== 0)
494
+ return byProviderRank;
495
+ const bySnapshot = compareSnapshots(a.identity, b.identity);
496
+ if (bySnapshot !== 0)
497
+ return bySnapshot;
498
+ const byProvider = compareStrings(a.provider.toLowerCase(), b.provider.toLowerCase());
499
+ if (byProvider !== 0)
500
+ return byProvider;
501
+ return compareStrings(a.id, b.id);
502
+ };
503
+ /** Escape a literal for embedding in a `RegExp` source. */
504
+ const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
505
+ /**
506
+ * Hyphen-boundary matcher, preserving the existing shorthand rules: a
507
+ * single word must be a WHOLE token (so `sol` misses `solstice`), while a
508
+ * multi-segment shorthand may prefix-match after a boundary (`5.6-s` hits
509
+ * `gpt-5.6-sol`).
510
+ *
511
+ * Compiled ONCE per query — the segment count is read from the text as the
512
+ * caller typed it, which is why this cannot be derived from the parsed
513
+ * family: parsing lifts the version out, and `5.6-s` would collapse to the
514
+ * single token `s` and silently become a whole-token match.
515
+ */
516
+ const compileBoundaryMatcher = (query) => {
517
+ if (query.length === 0)
518
+ return null;
519
+ const escaped = escapeRegExp(query);
520
+ const multiSegment = query.split("-").filter((s) => s.length > 0).length > 1;
521
+ return new RegExp(multiSegment ? `(?:^|-)${escaped}` : `(?:^|-)${escaped}(?:$|-)`);
522
+ };
523
+ const isVersionPrefix = (constraint, candidate) => candidate !== null &&
524
+ constraint.length <= candidate.length &&
525
+ constraint.every((part, index) => candidate[index] === part);
526
+ const hasAllVariants = (query, candidate) => query.variants.every((variant) => candidate.variants.includes(variant));
527
+ /**
528
+ * Split candidates into comparable-family groups. More than one group means
529
+ * the input spans unrelated families (`pro`, `mini`) and must stay
530
+ * ambiguous rather than picking an unrelated model.
531
+ */
532
+ const groupByFamily = (candidates) => {
533
+ const groups = [];
534
+ for (const candidate of candidates) {
535
+ const group = groups.find((existing) => {
536
+ const head = existing[0];
537
+ return (head !== undefined &&
538
+ isComparableFamily(head.identity, candidate.identity));
539
+ });
540
+ if (group === undefined)
541
+ groups.push([candidate]);
542
+ else
543
+ group.push(candidate);
544
+ }
545
+ return groups;
546
+ };
547
+ const variantKey = (identity) => identity.variants.join("\u0000");
548
+ /**
549
+ * True when the NEWEST generation among `ordered` offers more than one
550
+ * distinct variant set. Used only for tiers where the query names fewer
551
+ * variants than the candidates carry (`gpt-5.6` vs `gpt-5.6-luna` /
552
+ * `-sol` / `-terra`): the caller did not say which sibling, so picking
553
+ * one by slug order would be a guess. Rows sharing a variant set across
554
+ * providers are ONE choice (provider preference still decides between
555
+ * them), and an older generation's extra variants never cause ambiguity.
556
+ */
557
+ const hasCompetingVariantsAtNewest = (ordered) => {
558
+ const best = ordered[0];
559
+ if (best === undefined)
560
+ return false;
561
+ const keys = new Set();
562
+ for (const c of ordered) {
563
+ if (compareModelVersion(c.identity.version, best.identity.version) !== 0)
564
+ continue;
565
+ keys.add(variantKey(c.identity));
566
+ if (keys.size > 1)
567
+ return true;
568
+ }
569
+ return false;
570
+ };
571
+ const decide = (matches, reason, variantOpen = false) => {
572
+ const ordered = [...matches].sort(compareRequestCandidates);
573
+ const best = ordered[0];
574
+ if (best === undefined)
575
+ return { kind: "none" };
576
+ if (groupByFamily(ordered).length > 1)
577
+ return { kind: "ambiguous", reason, candidates: ordered };
578
+ if (variantOpen && hasCompetingVariantsAtNewest(ordered))
579
+ return { kind: "ambiguous", reason, candidates: ordered };
580
+ return { kind: "selected", candidate: best, reason, considered: ordered };
581
+ };
582
+ /**
583
+ * Resolve a possibly-imprecise request model against already-scoped
584
+ * candidates.
585
+ *
586
+ * Stages, in order: eligibility → exact identity → intent narrowing →
587
+ * newest within the family → deterministic tie-break. Explicit input is
588
+ * never upgraded: an exact `grok-4.6` stays on 4.6 even when 4.7 is
589
+ * available, and a version fragment (`grok-4.6`) only ever selects a
590
+ * maximum WITHIN that fragment.
591
+ *
592
+ * Nothing here decides availability, auth, or surface support — the caller
593
+ * expresses all of that through `isEligible`, and a `none`/`ambiguous`
594
+ * result means the caller keeps its existing passthrough/error behaviour.
595
+ */
596
+ export const selectRequestModel = (query, candidates, options = {}) => {
597
+ const rules = options.rules;
598
+ const trimmed = query.trim();
599
+ if (trimmed.length === 0)
600
+ return { kind: "none" };
601
+ const eligible = options.isEligible === undefined
602
+ ? candidates
603
+ : candidates.filter(options.isEligible);
604
+ if (eligible.length === 0)
605
+ return { kind: "none" };
606
+ const lowered = trimmed.toLowerCase();
607
+ const exactId = eligible.filter((c) => c.id.toLowerCase() === lowered);
608
+ if (exactId.length > 0)
609
+ return decide(exactId, "exact_id");
610
+ const exactProviderModelId = eligible.filter((c) => c.identity.providerModelId.toLowerCase() === lowered);
611
+ if (exactProviderModelId.length > 0)
612
+ return decide(exactProviderModelId, "exact_provider_model_id");
613
+ const intent = parseModelIdentity(trimmed, rules);
614
+ let pool = eligible;
615
+ if (intent.provider !== null) {
616
+ const wanted = intent.provider.toLowerCase();
617
+ pool = pool.filter((c) => c.provider.toLowerCase() === wanted);
618
+ }
619
+ if (intent.version !== null) {
620
+ pool = pool.filter((c) => isVersionPrefix(intent.version, c.identity.version));
621
+ }
622
+ if (intent.snapshot !== null) {
623
+ pool = pool.filter((c) => c.identity.snapshot === intent.snapshot);
624
+ }
625
+ if (pool.length === 0)
626
+ return { kind: "none" };
627
+ // A family-less query (pure variant words such as `pro`) matches any
628
+ // family; the group check below is what keeps it honest.
629
+ const familyExact = (c) => intent.family.length === 0 || isComparableFamily(intent, c.identity);
630
+ // Both matchers compile once per query, never per candidate row. The
631
+ // second one matches the id as TYPED against the upstream id, which is
632
+ // what keeps version-carrying shorthand (`5.6-s` → `gpt-5.6-sol`)
633
+ // working: the family alone has already lost the `5.6`.
634
+ const familyMatcher = compileBoundaryMatcher(intent.family);
635
+ const upstreamMatcher = compileBoundaryMatcher(intent.providerModelId.toLowerCase());
636
+ const familyBoundary = (c) => (familyMatcher?.test(c.identity.family) ?? false) ||
637
+ (upstreamMatcher?.test(c.identity.providerModelId.toLowerCase()) ?? false);
638
+ const versionReason = intent.version === null ? "family_newest" : "family_version";
639
+ // Narrowing tiers, strongest first. The first non-empty tier decides, so
640
+ // an exact-family plain model always beats a boundary or variant sibling.
641
+ // Evaluated LAZILY: the overwhelmingly common exact-family hit never
642
+ // scans the pool three more times.
643
+ // An id that ENDS with the query on a token boundary is a named model,
644
+ // not a family shorthand: `fable-5` means `claude-fable-5` and must not
645
+ // drift onto the later `claude-fable-5-1`. It therefore outranks the
646
+ // newest-in-family tiers, while still obeying the eligibility, provider
647
+ // and variant constraints applied above.
648
+ const terminalSuffix = `-${intent.providerModelId.toLowerCase()}`;
649
+ const tiers = [
650
+ {
651
+ matches: (c) => c.identity.providerModelId.toLowerCase().endsWith(terminalSuffix) &&
652
+ hasAllVariants(intent, c.identity),
653
+ reason: "terminal_suffix",
654
+ variantOpen: true,
655
+ },
656
+ {
657
+ matches: (c) => familyExact(c) && isSameVariant(intent, c.identity),
658
+ reason: versionReason,
659
+ },
660
+ {
661
+ matches: (c) => familyExact(c) && hasAllVariants(intent, c.identity),
662
+ reason: versionReason,
663
+ variantOpen: true,
664
+ },
665
+ {
666
+ matches: (c) => familyBoundary(c) && isSameVariant(intent, c.identity),
667
+ reason: "boundary",
668
+ },
669
+ {
670
+ matches: (c) => familyBoundary(c) && hasAllVariants(intent, c.identity),
671
+ reason: "prefix",
672
+ variantOpen: true,
673
+ },
674
+ ];
675
+ for (const tier of tiers) {
676
+ const matches = pool.filter(tier.matches);
677
+ if (matches.length === 0)
678
+ continue;
679
+ return decide(matches, tier.reason, tier.variantOpen === true);
680
+ }
681
+ return { kind: "none" };
682
+ };
683
+ /**
684
+ * Pick the nearest authored donor for a target identity.
685
+ *
686
+ * Classes, strongest first: an exact id, then the greatest same-provider
687
+ * version NOT EXCEEDING the target, then the same across providers. A
688
+ * successor is never a donor — borrowing from a version that does not
689
+ * exist yet would present a guess as a fact — and an unrelated family
690
+ * yields `none` so the caller keeps its existing unknown-metadata
691
+ * behaviour rather than inheriting from a nearest string.
692
+ *
693
+ * The engine returns a donor and a RELATION only. Which fields may be
694
+ * inherited, and which (identity, lifecycle, routing policy, repair flags)
695
+ * may never be, is the catalog's policy, not this module's.
696
+ */
697
+ export const selectMetadataDonor = (target, donors, options = {}) => {
698
+ const pool = options.isEligibleDonor === undefined
699
+ ? donors
700
+ : donors.filter(options.isEligibleDonor);
701
+ if (pool.length === 0)
702
+ return { kind: "none" };
703
+ const targetProvider = target.provider?.toLowerCase() ?? null;
704
+ const isSameProvider = (candidate) => targetProvider !== null &&
705
+ candidate.provider.toLowerCase() === targetProvider;
706
+ const best = (matches) => [...matches].sort(compareRequestCandidates)[0];
707
+ const lowered = target.providerModelId.toLowerCase();
708
+ const exact = pool.filter((c) => c.identity.providerModelId.toLowerCase() === lowered);
709
+ if (exact.length > 0) {
710
+ const sameProvider = exact.filter(isSameProvider);
711
+ const donor = best(sameProvider.length > 0 ? sameProvider : exact);
712
+ if (donor !== undefined)
713
+ return { kind: "donor", donor, relation: "exact" };
714
+ }
715
+ // A donor must not be a SUCCESSOR: borrowing from a version that does
716
+ // not exist yet presents a guess as a fact. That is the only version
717
+ // constraint.
718
+ //
719
+ // There was also a same-MAJOR gate here, on the theory that a major
720
+ // bump is where a vendor changes the facts. In practice it fenced off
721
+ // almost every media line the catalog actually has — `gpt-image-3`,
722
+ // `whisper-2`, `text-embedding-4-small`, the next Imagen and Veo —
723
+ // because those families number their generations in the major
724
+ // position, so EVERY successor was a major bump and inherited
725
+ // nothing. The gate is removed deliberately: what a donor may
726
+ // contribute is already constrained by category (identity, lifecycle,
727
+ // routing, repair flags and rates never cross; a cross-provider donor
728
+ // additionally contributes no provider-serving fact), everything it
729
+ // does contribute fills only fields the target left UNKNOWN, and the
730
+ // result is reported as inherited. A nearest known predecessor is
731
+ // better information than nothing, and the ordering below still
732
+ // prefers the closest one — so a same-major predecessor, when one
733
+ // exists, is the one chosen.
734
+ const withinInheritableRange = (donor) => {
735
+ if (target.version === null || donor.version === null)
736
+ return true;
737
+ return compareModelVersion(donor.version, target.version) <= 0;
738
+ };
739
+ const predecessors = pool.filter((c) => isComparableFamily(target, c.identity) &&
740
+ isSameVariant(target, c.identity) &&
741
+ withinInheritableRange(c.identity));
742
+ if (predecessors.length === 0)
743
+ return { kind: "none" };
744
+ const sameProvider = predecessors.filter(isSameProvider);
745
+ const sameProviderDonor = best(sameProvider);
746
+ if (sameProviderDonor !== undefined)
747
+ return {
748
+ kind: "donor",
749
+ donor: sameProviderDonor,
750
+ relation: "same_provider_predecessor",
751
+ };
752
+ const crossProviderDonor = best(predecessors);
753
+ if (crossProviderDonor === undefined)
754
+ return { kind: "none" };
755
+ return {
756
+ kind: "donor",
757
+ donor: crossProviderDonor,
758
+ relation: "cross_provider_predecessor",
759
+ };
760
+ };