@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.
- package/README.md +27 -7
- package/dist/client/chat.d.ts +38 -0
- package/dist/client/chat.js +77 -0
- package/dist/client/devices.d.ts +70 -0
- package/dist/client/devices.js +172 -0
- package/dist/client/http.d.ts +24 -0
- package/dist/client/http.js +34 -0
- package/dist/client/index.d.ts +43 -0
- package/dist/client/index.js +57 -0
- package/dist/client/relay-mux.d.ts +71 -0
- package/dist/client/relay-mux.js +394 -0
- package/dist/client/types.d.ts +47 -0
- package/dist/client/types.js +5 -0
- package/dist/client/vault.d.ts +68 -0
- package/dist/client/vault.js +113 -0
- package/dist/connect/chat.d.ts +24 -0
- package/dist/connect/chat.js +25 -0
- package/dist/connect/client.d.ts +50 -0
- package/dist/connect/client.js +141 -0
- package/dist/connect/config.d.ts +22 -0
- package/dist/connect/config.js +22 -0
- package/dist/connect/errors.d.ts +32 -0
- package/dist/connect/errors.js +85 -0
- package/{connect/index.ts → dist/connect/index.d.ts} +7 -7
- package/dist/connect/index.js +23 -0
- package/dist/connect/oauth.d.ts +51 -0
- package/dist/connect/oauth.js +150 -0
- package/dist/connect/routes.d.ts +38 -0
- package/dist/connect/routes.js +175 -0
- package/dist/connect/store.d.ts +26 -0
- package/dist/connect/store.js +65 -0
- package/dist/mcp/handle.d.ts +6 -0
- package/dist/mcp/handle.js +6 -0
- package/dist/mcp/index.d.ts +15 -0
- package/dist/mcp/index.js +10 -0
- package/dist/mcp/server.d.ts +84 -0
- package/dist/mcp/server.js +168 -0
- package/dist/mcp/tools/marketplace.d.ts +94 -0
- package/dist/mcp/tools/marketplace.js +303 -0
- package/dist/mcp/tools/memory-client.d.ts +109 -0
- package/dist/mcp/tools/memory-client.js +200 -0
- package/dist/mcp/tools/memory-config.d.ts +29 -0
- package/dist/mcp/tools/memory-config.js +12 -0
- package/dist/mcp/tools/memory.d.ts +92 -0
- package/dist/mcp/tools/memory.js +312 -0
- package/dist/mcp/tools/model-priority.d.ts +16 -0
- package/dist/mcp/tools/model-priority.js +87 -0
- package/dist/mcp/tools/openllm.d.ts +75 -0
- package/dist/mcp/tools/openllm.js +715 -0
- package/dist/mcp/types.d.ts +25 -0
- package/dist/mcp/types.js +7 -0
- package/dist/openapi/call.d.ts +26 -0
- package/dist/openapi/call.js +56 -0
- package/dist/openapi/index.d.ts +2 -0
- package/dist/openapi/index.js +2 -0
- package/dist/openapi/openapi.json +80213 -0
- package/dist/openapi/operations.d.ts +14 -0
- package/dist/openapi/operations.js +2060 -0
- package/dist/protocol/access.d.ts +81 -0
- package/dist/protocol/access.js +125 -0
- package/dist/protocol/agent-prompt-text.d.ts +15 -0
- package/{protocol/agent-prompt-text.ts → dist/protocol/agent-prompt-text.js} +9 -14
- package/dist/protocol/agent.d.ts +1487 -0
- package/dist/protocol/agent.js +787 -0
- package/dist/protocol/api-key-syntax.d.ts +58 -0
- package/dist/protocol/api-key-syntax.js +73 -0
- package/dist/protocol/audio.d.ts +18 -0
- package/dist/protocol/audio.js +21 -0
- package/dist/protocol/auth.d.ts +126 -0
- package/dist/protocol/auth.js +119 -0
- package/dist/protocol/changelog.d.ts +69 -0
- package/dist/protocol/changelog.js +107 -0
- package/dist/protocol/chat.d.ts +789 -0
- package/dist/protocol/chat.js +394 -0
- package/dist/protocol/client-registry.d.ts +151 -0
- package/dist/protocol/client-registry.js +238 -0
- package/dist/protocol/config.d.ts +508 -0
- package/dist/protocol/config.js +289 -0
- package/dist/protocol/control-channel.d.ts +102 -0
- package/{protocol/control-channel.ts → dist/protocol/control-channel.js} +33 -61
- package/dist/protocol/cooldown-reason.d.ts +30 -0
- package/dist/protocol/cooldown-reason.js +44 -0
- package/dist/protocol/cost.d.ts +9 -0
- package/dist/protocol/cost.js +8 -0
- package/dist/protocol/daemon-port.d.ts +2 -0
- package/dist/protocol/daemon-port.js +28 -0
- package/dist/protocol/daemon.d.ts +2034 -0
- package/dist/protocol/daemon.js +1286 -0
- package/dist/protocol/default-chains.d.ts +15 -0
- package/dist/protocol/default-chains.js +21 -0
- package/dist/protocol/device-state.d.ts +223 -0
- package/dist/protocol/device-state.js +52 -0
- package/dist/protocol/doctor-report-local.d.ts +105 -0
- package/{protocol/doctor-report-local.ts → dist/protocol/doctor-report-local.js} +92 -196
- package/dist/protocol/doctor-report-policy.d.ts +62 -0
- package/{protocol/doctor-report-policy.ts → dist/protocol/doctor-report-policy.js} +23 -76
- package/dist/protocol/doctor-report.d.ts +406 -0
- package/dist/protocol/doctor-report.js +645 -0
- package/dist/protocol/errors.d.ts +17 -0
- package/dist/protocol/errors.js +10 -0
- package/dist/protocol/execution-selection.d.ts +92 -0
- package/{protocol/execution-selection.ts → dist/protocol/execution-selection.js} +38 -63
- package/dist/protocol/hop-grant.d.ts +28 -0
- package/{protocol/hop-grant.ts → dist/protocol/hop-grant.js} +7 -13
- package/dist/protocol/image-edit-parse.d.ts +25 -0
- package/dist/protocol/image-edit-parse.js +196 -0
- package/dist/protocol/images.d.ts +288 -0
- package/dist/protocol/images.js +229 -0
- package/dist/protocol/index.d.ts +69 -0
- package/dist/protocol/index.js +74 -0
- package/dist/protocol/inference-headers.d.ts +3 -0
- package/dist/protocol/keepalive.d.ts +36 -0
- package/dist/protocol/keepalive.js +51 -0
- package/dist/protocol/local-auth.d.ts +125 -0
- package/dist/protocol/local-auth.js +227 -0
- package/dist/protocol/local-device-control.d.ts +108 -0
- package/{protocol/local-device-control.ts → dist/protocol/local-device-control.js} +40 -70
- package/dist/protocol/local-provider.d.ts +105 -0
- package/dist/protocol/local-provider.js +213 -0
- package/dist/protocol/local-session.d.ts +70 -0
- package/dist/protocol/local-session.js +87 -0
- package/dist/protocol/marketplace.d.ts +190 -0
- package/dist/protocol/marketplace.js +140 -0
- package/{protocol/media-attempt.ts → dist/protocol/media-attempt.d.ts} +11 -50
- package/dist/protocol/media-attempt.js +50 -0
- package/dist/protocol/media-bytes.d.ts +8 -0
- package/dist/protocol/media-bytes.js +21 -0
- package/dist/protocol/media-default.d.ts +56 -0
- package/dist/protocol/media-default.js +302 -0
- package/{protocol/media-dimensions.ts → dist/protocol/media-dimensions.d.ts} +11 -78
- package/dist/protocol/media-dimensions.js +90 -0
- package/dist/protocol/media-input.d.ts +20 -0
- package/dist/protocol/media-input.js +29 -0
- package/dist/protocol/media-model.d.ts +77 -0
- package/dist/protocol/media-model.js +89 -0
- package/{protocol/media-option-issue.ts → dist/protocol/media-option-issue.d.ts} +25 -53
- package/dist/protocol/media-option-issue.js +50 -0
- package/dist/protocol/media-types.d.ts +14 -0
- package/dist/protocol/media-types.js +61 -0
- package/dist/protocol/model-match.d.ts +254 -0
- package/dist/protocol/model-match.js +760 -0
- package/dist/protocol/model-settings.d.ts +153 -0
- package/dist/protocol/model-settings.js +246 -0
- package/dist/protocol/models.d.ts +1065 -0
- package/dist/protocol/models.js +638 -0
- package/dist/protocol/mux.d.ts +350 -0
- package/dist/protocol/mux.js +595 -0
- package/{protocol/plan-surface.ts → dist/protocol/plan-surface.d.ts} +12 -26
- package/dist/protocol/plan-surface.js +39 -0
- package/dist/protocol/provider-models.d.ts +8 -0
- package/{protocol/provider-models.ts → dist/protocol/provider-models.js} +7 -9
- package/dist/protocol/provider-status.d.ts +59 -0
- package/dist/protocol/provider-status.js +142 -0
- package/dist/protocol/provider-tier.d.ts +34 -0
- package/{protocol/provider-tier.ts → dist/protocol/provider-tier.js} +9 -34
- package/dist/protocol/provider-usage.d.ts +230 -0
- package/dist/protocol/provider-usage.js +214 -0
- package/dist/protocol/providers.d.ts +2496 -0
- package/dist/protocol/providers.js +723 -0
- package/dist/protocol/public-usage-index.d.ts +449 -0
- package/dist/protocol/public-usage-index.js +279 -0
- package/dist/protocol/realtime-generated.d.ts +29 -0
- package/{protocol/realtime-generated.ts → dist/protocol/realtime-generated.js} +3 -5
- package/dist/protocol/realtime.d.ts +241 -0
- package/{protocol/realtime.ts → dist/protocol/realtime.js} +88 -155
- package/dist/protocol/registry-pointer.d.ts +24 -0
- package/dist/protocol/registry-pointer.js +78 -0
- package/dist/protocol/relay.d.ts +1152 -0
- package/{protocol/relay.ts → dist/protocol/relay.js} +237 -370
- package/dist/protocol/replay-session.d.ts +4 -0
- package/{protocol/replay-session.ts → dist/protocol/replay-session.js} +1 -8
- package/dist/protocol/responses.d.ts +303 -0
- package/dist/protocol/responses.js +240 -0
- package/dist/protocol/semver.d.ts +59 -0
- package/dist/protocol/semver.js +171 -0
- package/{protocol/setup-mode.ts → dist/protocol/setup-mode.d.ts} +4 -12
- package/dist/protocol/setup-mode.js +18 -0
- package/dist/protocol/sha256-hex.d.ts +2 -0
- package/dist/protocol/sha256-hex.js +93 -0
- package/dist/protocol/stats.d.ts +711 -0
- package/dist/protocol/stats.js +353 -0
- package/dist/protocol/streaming.d.ts +16 -0
- package/dist/protocol/streaming.js +15 -0
- package/{protocol/subscription-daemon-floors.ts → dist/protocol/subscription-daemon-floors.d.ts} +8 -14
- package/dist/protocol/subscription-daemon-floors.js +4 -0
- package/dist/protocol/subscription-provider-compat.d.ts +44 -0
- package/dist/protocol/subscription-provider-compat.js +67 -0
- package/dist/protocol/subscription-provider.d.ts +15 -0
- package/dist/protocol/subscription-provider.js +17 -0
- package/dist/protocol/team-grant.d.ts +14 -0
- package/{protocol/team-grant.ts → dist/protocol/team-grant.js} +0 -3
- package/dist/protocol/team-shareable.d.ts +6 -0
- package/{protocol/team-shareable.ts → dist/protocol/team-shareable.js} +29 -33
- package/dist/protocol/transcription-encoding.d.ts +25 -0
- package/dist/protocol/transcription-encoding.js +47 -0
- package/{protocol/url-locality-dns.ts → dist/protocol/url-locality-dns.d.ts} +1 -23
- package/dist/protocol/url-locality-dns.js +33 -0
- package/dist/protocol/url-locality.d.ts +45 -0
- package/dist/protocol/url-locality.js +288 -0
- package/dist/protocol/usage-snapshots.d.ts +8 -0
- package/{protocol/usage-snapshots.ts → dist/protocol/usage-snapshots.js} +1 -2
- package/dist/protocol/vendor-cli-install.d.ts +20 -0
- package/{protocol/vendor-cli-install.ts → dist/protocol/vendor-cli-install.js} +10 -15
- package/dist/protocol/video-job-plan.d.ts +18 -0
- package/dist/protocol/video-job-plan.js +44 -0
- package/dist/protocol/videos.d.ts +107 -0
- package/dist/protocol/videos.js +154 -0
- package/dist/tunnel/channel-envelope.d.ts +53 -0
- package/dist/tunnel/channel-envelope.js +100 -0
- package/dist/tunnel/codec.d.ts +71 -0
- package/dist/tunnel/codec.js +151 -0
- package/dist/tunnel/device-anchor.d.ts +62 -0
- package/dist/tunnel/device-anchor.js +168 -0
- package/dist/tunnel/device-control.d.ts +50 -0
- package/dist/tunnel/device-control.js +88 -0
- package/dist/tunnel/device-grant.d.ts +91 -0
- package/dist/tunnel/device-grant.js +105 -0
- package/dist/tunnel/fleet.d.ts +28 -0
- package/dist/tunnel/fleet.js +41 -0
- package/dist/tunnel/index.d.ts +22 -0
- package/dist/tunnel/index.js +22 -0
- package/dist/tunnel/mux.d.ts +64 -0
- package/dist/tunnel/mux.js +449 -0
- package/dist/tunnel/peer-link.d.ts +88 -0
- package/dist/tunnel/peer-link.js +271 -0
- package/dist/tunnel/rtc-auth.d.ts +159 -0
- package/dist/tunnel/rtc-auth.js +340 -0
- package/dist/tunnel/rtc-duplex.d.ts +52 -0
- package/dist/tunnel/rtc-duplex.js +148 -0
- package/dist/tunnel/rtc-ice.d.ts +55 -0
- package/dist/tunnel/rtc-ice.js +100 -0
- package/dist/tunnel/secure.d.ts +179 -0
- package/dist/tunnel/secure.js +936 -0
- package/dist/tunnel/stream-reset-error.d.ts +6 -0
- package/dist/tunnel/stream-reset-error.js +9 -0
- package/dist/tunnel/streams.d.ts +244 -0
- package/dist/tunnel/streams.js +1071 -0
- package/dist/tunnel/team-grant.d.ts +90 -0
- package/dist/tunnel/team-grant.js +226 -0
- package/dist/tunnel/wire-bytes.d.ts +32 -0
- package/dist/tunnel/wire-bytes.js +90 -0
- package/dist/vault/api-key.d.ts +71 -0
- package/dist/vault/api-key.js +130 -0
- package/{vault/argon2.ts → dist/vault/argon2.d.ts} +18 -53
- package/dist/vault/argon2.js +82 -0
- package/dist/vault/cli-auth-seal.d.ts +35 -0
- package/dist/vault/cli-auth-seal.js +78 -0
- package/dist/vault/cred-seal.d.ts +18 -0
- package/dist/vault/cred-seal.js +86 -0
- package/dist/vault/credential.d.ts +21 -0
- package/dist/vault/credential.js +26 -0
- package/dist/vault/crypto.d.ts +51 -0
- package/dist/vault/crypto.js +156 -0
- package/dist/vault/daemon-attest.d.ts +68 -0
- package/dist/vault/daemon-attest.js +147 -0
- package/dist/vault/derive.d.ts +34 -0
- package/dist/vault/derive.js +84 -0
- package/dist/vault/device-access.d.ts +17 -0
- package/dist/vault/device-access.js +77 -0
- package/dist/vault/device-anchor.d.ts +42 -0
- package/dist/vault/device-anchor.js +90 -0
- package/dist/vault/device-control.d.ts +80 -0
- package/{vault/device-control.ts → dist/vault/device-control.js} +46 -104
- package/dist/vault/handoff.d.ts +102 -0
- package/dist/vault/handoff.js +236 -0
- package/dist/vault/index.d.ts +21 -0
- package/dist/vault/index.js +21 -0
- package/dist/vault/passkey.d.ts +82 -0
- package/{vault/passkey.ts → dist/vault/passkey.js} +63 -153
- package/dist/vault/phrase.d.ts +40 -0
- package/{vault/phrase.ts → dist/vault/phrase.js} +17 -23
- package/dist/vault/pin.d.ts +46 -0
- package/dist/vault/pin.js +92 -0
- package/dist/vault/public-key-seal.d.ts +17 -0
- package/dist/vault/public-key-seal.js +59 -0
- package/dist/vault/seed.d.ts +96 -0
- package/dist/vault/seed.js +179 -0
- package/dist/vault/team.d.ts +134 -0
- package/dist/vault/team.js +217 -0
- package/dist/vault/vault-item.d.ts +45 -0
- package/dist/vault/vault-item.js +62 -0
- package/dist/vault/vault-migrate-digest.d.ts +10 -0
- package/dist/vault/vault-migrate-digest.js +22 -0
- package/dist/vault/wrapped.d.ts +19 -0
- package/dist/vault/wrapped.js +52 -0
- package/dist/wire/adapters/messages/anthropic-map.d.ts +8 -0
- package/dist/wire/adapters/messages/anthropic-map.js +32 -0
- package/dist/wire/adapters/messages/index.d.ts +7 -0
- package/dist/wire/adapters/messages/index.js +7 -0
- package/dist/wire/adapters/messages/reasoning-from-items.d.ts +14 -0
- package/dist/wire/adapters/messages/reasoning-from-items.js +39 -0
- package/dist/wire/adapters/messages/reasoning-signature.d.ts +81 -0
- package/dist/wire/adapters/messages/reasoning-signature.js +180 -0
- package/dist/wire/adapters/messages/request.d.ts +28 -0
- package/dist/wire/adapters/messages/request.js +490 -0
- package/dist/wire/adapters/messages/response.d.ts +10 -0
- package/dist/wire/adapters/messages/response.js +177 -0
- package/dist/wire/adapters/messages/streaming.d.ts +134 -0
- package/dist/wire/adapters/messages/streaming.js +791 -0
- package/dist/wire/adapters/messages/usage.d.ts +20 -0
- package/dist/wire/adapters/messages/usage.js +10 -0
- package/dist/wire/adapters/responses/index.d.ts +3 -0
- package/dist/wire/adapters/responses/index.js +3 -0
- package/dist/wire/adapters/responses/request.d.ts +2 -0
- package/dist/wire/adapters/responses/request.js +287 -0
- package/dist/wire/adapters/responses/response.d.ts +11 -0
- package/dist/wire/adapters/responses/response.js +69 -0
- package/dist/wire/adapters/responses/streaming.d.ts +2 -0
- package/dist/wire/adapters/responses/streaming.js +267 -0
- package/dist/wire/features/account-rank.d.ts +61 -0
- package/dist/wire/features/account-rank.js +109 -0
- package/dist/wire/features/compaction/compact-request.d.ts +69 -0
- package/dist/wire/features/compaction/compact-request.js +667 -0
- package/dist/wire/features/compaction/compaction-text.d.ts +17 -0
- package/dist/wire/features/compaction/compaction-text.js +29 -0
- package/dist/wire/features/context-demote.d.ts +15 -0
- package/dist/wire/features/context-demote.js +45 -0
- package/dist/wire/features/context-overflow-strategy.d.ts +12 -0
- package/dist/wire/features/context-overflow-strategy.js +8 -0
- package/dist/wire/features/context-skip.d.ts +120 -0
- package/{wire/features/context-skip.ts → dist/wire/features/context-skip.js} +23 -57
- package/dist/wire/features/conversation-affinity.d.ts +49 -0
- package/dist/wire/features/conversation-affinity.js +121 -0
- package/dist/wire/features/max-tokens-backfill.d.ts +50 -0
- package/dist/wire/features/max-tokens-backfill.js +118 -0
- package/dist/wire/features/model-caps.d.ts +7 -0
- package/dist/wire/features/model-caps.js +40 -0
- package/dist/wire/features/model-settings.d.ts +3 -0
- package/dist/wire/features/model-settings.js +13 -0
- package/dist/wire/features/output-limit-clamp.d.ts +14 -0
- package/dist/wire/features/output-limit-clamp.js +36 -0
- package/dist/wire/features/quota-gate.d.ts +16 -0
- package/dist/wire/features/quota-gate.js +48 -0
- package/dist/wire/index.d.ts +44 -0
- package/dist/wire/index.js +44 -0
- package/dist/wire/lib/attempt-outcome.d.ts +19 -0
- package/dist/wire/lib/attempt-outcome.js +18 -0
- package/{wire/lib/canonical/content-part.ts → dist/wire/lib/canonical/content-part.d.ts} +12 -18
- package/dist/wire/lib/canonical/content-part.js +11 -0
- package/dist/wire/lib/canonical/count-tokens-capability.d.ts +52 -0
- package/dist/wire/lib/canonical/count-tokens-capability.js +109 -0
- package/{wire/lib/canonical/encoding-select.ts → dist/wire/lib/canonical/encoding-select.d.ts} +7 -24
- package/dist/wire/lib/canonical/encoding-select.js +26 -0
- package/dist/wire/lib/canonical/image-signature.d.ts +20 -0
- package/dist/wire/lib/canonical/image-signature.js +184 -0
- package/dist/wire/lib/canonical/image-sse.d.ts +88 -0
- package/dist/wire/lib/canonical/image-sse.js +173 -0
- package/{wire/lib/canonical/message.ts → dist/wire/lib/canonical/message.d.ts} +2 -20
- package/dist/wire/lib/canonical/message.js +31 -0
- package/dist/wire/lib/canonical/token-estimate.d.ts +98 -0
- package/dist/wire/lib/canonical/token-estimate.js +230 -0
- package/dist/wire/lib/encrypted-content.d.ts +22 -0
- package/dist/wire/lib/encrypted-content.js +55 -0
- package/dist/wire/lib/error-class.d.ts +57 -0
- package/dist/wire/lib/error-class.js +97 -0
- package/dist/wire/lib/error-envelope.d.ts +20 -0
- package/dist/wire/lib/error-envelope.js +53 -0
- package/dist/wire/lib/forwarded-headers.d.ts +16 -0
- package/{wire/lib/forwarded-headers.ts → dist/wire/lib/forwarded-headers.js} +62 -72
- package/dist/wire/lib/provider-error-rules.d.ts +21 -0
- package/dist/wire/lib/provider-error-rules.js +20 -0
- package/{wire/lib/refusal.ts → dist/wire/lib/refusal.d.ts} +3 -13
- package/dist/wire/lib/refusal.js +27 -0
- package/dist/wire/lib/responses-apply-patch.d.ts +57 -0
- package/dist/wire/lib/responses-apply-patch.js +81 -0
- package/dist/wire/lib/responses-namespace.d.ts +27 -0
- package/{wire/lib/responses-namespace.ts → dist/wire/lib/responses-namespace.js} +16 -32
- package/dist/wire/lib/secret-scrub.d.ts +23 -0
- package/dist/wire/lib/secret-scrub.js +72 -0
- package/dist/wire/lib/streaming/accumulate.d.ts +12 -0
- package/dist/wire/lib/streaming/accumulate.js +187 -0
- package/dist/wire/lib/streaming/finish-reason.d.ts +20 -0
- package/dist/wire/lib/streaming/finish-reason.js +15 -0
- package/{wire/lib/streaming/peek.ts → dist/wire/lib/streaming/peek.d.ts} +13 -82
- package/dist/wire/lib/streaming/peek.js +100 -0
- package/dist/wire/lib/streaming/provider-decode.d.ts +57 -0
- package/dist/wire/lib/streaming/provider-decode.js +210 -0
- package/dist/wire/lib/streaming/response-stream.d.ts +16 -0
- package/dist/wire/lib/streaming/response-stream.js +64 -0
- package/dist/wire/lib/streaming/sse.d.ts +130 -0
- package/dist/wire/lib/streaming/sse.js +600 -0
- package/dist/wire/lib/streaming/strip-tool-calls.d.ts +14 -0
- package/dist/wire/lib/streaming/strip-tool-calls.js +75 -0
- package/dist/wire/lib/streaming/upstream-error.d.ts +32 -0
- package/dist/wire/lib/streaming/upstream-error.js +45 -0
- package/dist/wire/lib/strip-subagent-isolation.d.ts +16 -0
- package/dist/wire/lib/strip-subagent-isolation.js +240 -0
- package/dist/wire/lib/thinking-signature.d.ts +56 -0
- package/{wire/lib/thinking-signature.ts → dist/wire/lib/thinking-signature.js} +77 -84
- package/dist/wire/lib/token-ruler/bpe-core.d.ts +105 -0
- package/dist/wire/lib/token-ruler/bpe-core.js +398 -0
- package/dist/wire/lib/token-ruler/index.d.ts +2 -0
- package/dist/wire/lib/token-ruler/index.js +2 -0
- package/dist/wire/lib/token-ruler/ruler.d.ts +36 -0
- package/dist/wire/lib/token-ruler/ruler.js +50 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.d.ts +14 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.js +16 -0
- package/{wire/lib/token-ruler/vocab/claude.ts → dist/wire/lib/token-ruler/vocab/claude.d.ts} +2 -12
- package/dist/wire/lib/token-ruler/vocab/claude.js +8 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.d.ts +3 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.js +18 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.d.ts +11 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.js +6 -0
- package/dist/wire/lib/tool-name-map.d.ts +44 -0
- package/dist/wire/lib/tool-name-map.js +186 -0
- package/dist/wire/lib/tool-schema.d.ts +15 -0
- package/dist/wire/lib/tool-schema.js +307 -0
- package/dist/wire/lib/usage-observer.d.ts +9 -0
- package/dist/wire/lib/usage-observer.js +108 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.d.ts +125 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.js +221 -0
- package/dist/wire/providers/anthropic/beta-headers.d.ts +44 -0
- package/{wire/providers/anthropic/beta-headers.ts → dist/wire/providers/anthropic/beta-headers.js} +57 -79
- package/dist/wire/providers/anthropic/index.d.ts +6 -0
- package/{wire/providers/anthropic/index.ts → dist/wire/providers/anthropic/index.js} +6 -6
- package/dist/wire/providers/anthropic/request.d.ts +12 -0
- package/dist/wire/providers/anthropic/request.js +456 -0
- package/dist/wire/providers/anthropic/response.d.ts +3 -0
- package/dist/wire/providers/anthropic/response.js +126 -0
- package/dist/wire/providers/anthropic/streaming.d.ts +28 -0
- package/dist/wire/providers/anthropic/streaming.js +268 -0
- package/dist/wire/providers/anthropic/web-search-domains.d.ts +7 -0
- package/dist/wire/providers/anthropic/web-search-domains.js +36 -0
- package/dist/wire/providers/chatgpt/common.d.ts +27 -0
- package/{wire/providers/chatgpt/common.ts → dist/wire/providers/chatgpt/common.js} +69 -89
- package/dist/wire/providers/chatgpt/index.d.ts +4 -0
- package/{wire/providers/chatgpt/index.ts → dist/wire/providers/chatgpt/index.js} +4 -4
- package/dist/wire/providers/chatgpt/request.d.ts +132 -0
- package/dist/wire/providers/chatgpt/request.js +696 -0
- package/dist/wire/providers/chatgpt/streaming.d.ts +69 -0
- package/dist/wire/providers/chatgpt/streaming.js +761 -0
- package/dist/wire/providers/chatgpt/web-search.d.ts +19 -0
- package/dist/wire/providers/chatgpt/web-search.js +55 -0
- package/dist/wire/providers/grok/web-search.d.ts +23 -0
- package/dist/wire/providers/grok/web-search.js +74 -0
- package/dist/wire/providers/kimi/web-search.d.ts +48 -0
- package/dist/wire/providers/kimi/web-search.js +106 -0
- package/dist/wire/providers/upstream-deny.d.ts +61 -0
- package/dist/wire/providers/upstream-deny.js +293 -0
- package/dist/wire/providers/upstream-request.d.ts +104 -0
- package/dist/wire/providers/upstream-request.js +411 -0
- package/package.json +105 -23
- package/ARCHITECTURE.md +0 -43
- package/client/chat.ts +0 -140
- package/client/devices.ts +0 -269
- package/client/http.ts +0 -72
- package/client/index.ts +0 -129
- package/client/relay-mux.ts +0 -547
- package/client/types.ts +0 -51
- package/client/vault.ts +0 -239
- package/connect/chat.ts +0 -58
- package/connect/client.ts +0 -240
- package/connect/config.ts +0 -47
- package/connect/errors.ts +0 -121
- package/connect/oauth.ts +0 -265
- package/connect/routes.ts +0 -234
- package/connect/store.ts +0 -107
- package/mcp/handle.ts +0 -24
- package/mcp/index.ts +0 -76
- package/mcp/server.ts +0 -319
- package/mcp/tools/marketplace.ts +0 -439
- package/mcp/tools/memory-client.ts +0 -297
- package/mcp/tools/memory-config.ts +0 -32
- package/mcp/tools/memory.ts +0 -369
- package/mcp/tools/model-priority.ts +0 -88
- package/mcp/tools/openllm.ts +0 -883
- package/mcp/types.ts +0 -28
- package/openapi/call.ts +0 -90
- package/openapi/index.ts +0 -8
- package/openapi/openapi.json +0 -80213
- package/openapi/operations.ts +0 -2075
- package/protocol/CONTRIBUTING.md +0 -21
- package/protocol/README.md +0 -134
- package/protocol/access.ts +0 -186
- package/protocol/agent.ts +0 -991
- package/protocol/api-key-syntax.ts +0 -105
- package/protocol/assets/openllm-light.svg +0 -18
- package/protocol/assets/openllm.svg +0 -18
- package/protocol/audio.ts +0 -29
- package/protocol/auth.ts +0 -142
- package/protocol/changelog.ts +0 -155
- package/protocol/chat.ts +0 -458
- package/protocol/client-registry.ts +0 -356
- package/protocol/config.ts +0 -345
- package/protocol/cooldown-reason.ts +0 -78
- package/protocol/cost.ts +0 -10
- package/protocol/daemon-port.ts +0 -31
- package/protocol/daemon.ts +0 -1524
- package/protocol/default-chains.ts +0 -66
- package/protocol/device-state.ts +0 -85
- package/protocol/doctor-report.ts +0 -947
- package/protocol/errors.ts +0 -14
- package/protocol/image-edit-parse.ts +0 -263
- package/protocol/images.ts +0 -298
- package/protocol/index.ts +0 -74
- package/protocol/keepalive.ts +0 -69
- package/protocol/local-auth.ts +0 -300
- package/protocol/local-provider.ts +0 -288
- package/protocol/local-session.ts +0 -118
- package/protocol/marketplace.ts +0 -187
- package/protocol/media-bytes.ts +0 -28
- package/protocol/media-default.ts +0 -357
- package/protocol/media-input.ts +0 -61
- package/protocol/media-model.ts +0 -142
- package/protocol/media-types.ts +0 -70
- package/protocol/model-match.ts +0 -1051
- package/protocol/model-settings.ts +0 -327
- package/protocol/models.ts +0 -767
- package/protocol/mux.ts +0 -722
- package/protocol/provider-status.ts +0 -206
- package/protocol/provider-usage.ts +0 -263
- package/protocol/providers.ts +0 -901
- package/protocol/public-usage-index.ts +0 -354
- package/protocol/registry-pointer.ts +0 -118
- package/protocol/responses.ts +0 -280
- package/protocol/semver.ts +0 -182
- package/protocol/sha256-hex.ts +0 -98
- package/protocol/stats.ts +0 -406
- package/protocol/streaming.ts +0 -19
- package/protocol/subscription-provider-compat.ts +0 -104
- package/protocol/subscription-provider.ts +0 -32
- package/protocol/transcription-encoding.ts +0 -76
- package/protocol/url-locality.ts +0 -288
- package/protocol/video-job-plan.ts +0 -50
- package/protocol/videos.ts +0 -227
- package/tsconfig.json +0 -14
- package/tunnel/ARCHITECTURE.md +0 -111
- package/tunnel/assets/openllm-light.svg +0 -18
- package/tunnel/assets/openllm.svg +0 -18
- package/tunnel/channel-envelope.ts +0 -139
- package/tunnel/codec.ts +0 -191
- package/tunnel/device-anchor.ts +0 -229
- package/tunnel/device-control.ts +0 -118
- package/tunnel/device-grant.ts +0 -173
- package/tunnel/fleet.ts +0 -77
- package/tunnel/index.ts +0 -22
- package/tunnel/mux.ts +0 -580
- package/tunnel/peer-link.ts +0 -390
- package/tunnel/rtc-auth.ts +0 -415
- package/tunnel/rtc-duplex.ts +0 -187
- package/tunnel/rtc-ice.ts +0 -136
- package/tunnel/secure.ts +0 -1298
- package/tunnel/stream-reset-error.ts +0 -14
- package/tunnel/streams.ts +0 -1430
- package/tunnel/team-grant.ts +0 -302
- package/tunnel/wire-bytes.ts +0 -102
- package/vault/ARCHITECTURE.md +0 -470
- package/vault/api-key.ts +0 -190
- package/vault/cli-auth-seal.ts +0 -157
- package/vault/cred-seal.ts +0 -146
- package/vault/credential.ts +0 -55
- package/vault/crypto.ts +0 -210
- package/vault/daemon-attest.ts +0 -229
- package/vault/derive.ts +0 -113
- package/vault/device-access.ts +0 -87
- package/vault/device-anchor.ts +0 -185
- package/vault/handoff.ts +0 -396
- package/vault/index.ts +0 -21
- package/vault/pin.ts +0 -153
- package/vault/public-key-seal.ts +0 -131
- package/vault/seed.ts +0 -272
- package/vault/team.ts +0 -355
- package/vault/vault-item.ts +0 -131
- package/vault/vault-migrate-digest.ts +0 -29
- package/vault/wrapped.ts +0 -77
- package/wire/ARCHITECTURE.md +0 -90
- package/wire/CONTRIBUTING.md +0 -19
- package/wire/adapters/messages/anthropic-map.ts +0 -37
- package/wire/adapters/messages/index.ts +0 -7
- package/wire/adapters/messages/reasoning-from-items.ts +0 -38
- package/wire/adapters/messages/reasoning-signature.ts +0 -243
- package/wire/adapters/messages/request.ts +0 -574
- package/wire/adapters/messages/response.ts +0 -215
- package/wire/adapters/messages/streaming.ts +0 -1027
- package/wire/adapters/messages/usage.ts +0 -43
- package/wire/adapters/responses/index.ts +0 -3
- package/wire/adapters/responses/request.ts +0 -395
- package/wire/adapters/responses/response.ts +0 -88
- package/wire/adapters/responses/streaming.ts +0 -344
- package/wire/assets/openllm-light.svg +0 -18
- package/wire/assets/openllm.svg +0 -18
- package/wire/features/account-rank.ts +0 -166
- package/wire/features/compaction/compact-request.ts +0 -862
- package/wire/features/compaction/compaction-text.ts +0 -43
- package/wire/features/context-demote.ts +0 -47
- package/wire/features/context-overflow-strategy.ts +0 -26
- package/wire/features/conversation-affinity.ts +0 -144
- package/wire/features/max-tokens-backfill.ts +0 -141
- package/wire/features/model-caps.ts +0 -53
- package/wire/features/model-settings.ts +0 -24
- package/wire/features/output-limit-clamp.ts +0 -64
- package/wire/features/quota-gate.ts +0 -85
- package/wire/index.ts +0 -44
- package/wire/lib/attempt-outcome.ts +0 -43
- package/wire/lib/canonical/count-tokens-capability.ts +0 -138
- package/wire/lib/canonical/image-signature.ts +0 -202
- package/wire/lib/canonical/image-sse.ts +0 -216
- package/wire/lib/canonical/token-estimate.ts +0 -266
- package/wire/lib/encrypted-content.ts +0 -66
- package/wire/lib/error-class.ts +0 -154
- package/wire/lib/error-envelope.ts +0 -56
- package/wire/lib/provider-error-rules.ts +0 -48
- package/wire/lib/responses-apply-patch.ts +0 -104
- package/wire/lib/secret-scrub.ts +0 -101
- package/wire/lib/streaming/accumulate.ts +0 -221
- package/wire/lib/streaming/finish-reason.ts +0 -33
- package/wire/lib/streaming/provider-decode.ts +0 -259
- package/wire/lib/streaming/response-stream.ts +0 -71
- package/wire/lib/streaming/sse.ts +0 -699
- package/wire/lib/streaming/strip-tool-calls.ts +0 -95
- package/wire/lib/streaming/upstream-error.ts +0 -58
- package/wire/lib/strip-subagent-isolation.ts +0 -284
- package/wire/lib/token-ruler/bpe-core.ts +0 -426
- package/wire/lib/token-ruler/index.ts +0 -2
- package/wire/lib/token-ruler/ruler.ts +0 -79
- package/wire/lib/token-ruler/vocab/claude-ranks.ts +0 -16
- package/wire/lib/token-ruler/vocab/o200k-ranks.ts +0 -18
- package/wire/lib/token-ruler/vocab/o200k.ts +0 -19
- package/wire/lib/tool-name-map.ts +0 -271
- package/wire/lib/tool-schema.ts +0 -353
- package/wire/lib/usage-observer.ts +0 -125
- package/wire/providers/anthropic/adaptive-thinking.ts +0 -291
- package/wire/providers/anthropic/request.ts +0 -607
- package/wire/providers/anthropic/response.ts +0 -155
- package/wire/providers/anthropic/streaming.ts +0 -315
- package/wire/providers/anthropic/web-search-domains.ts +0 -49
- package/wire/providers/chatgpt/request.ts +0 -959
- package/wire/providers/chatgpt/streaming.ts +0 -1007
- package/wire/providers/chatgpt/web-search.ts +0 -63
- package/wire/providers/grok/web-search.ts +0 -87
- package/wire/providers/kimi/web-search.ts +0 -145
- package/wire/providers/upstream-deny.ts +0 -355
- package/wire/providers/upstream-request.ts +0 -619
- /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
|
+
};
|