@openllmsh/sdk 2.10.12-alpha.1 → 2.10.12-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,89 @@
|
|
|
1
|
+
import { Schema as S } from "effect";
|
|
2
|
+
import { DEFAULT_TIER_ALIASES } from "./models.js";
|
|
3
|
+
/**
|
|
4
|
+
* One shared rule for a media request's `model` field — used by the cloud
|
|
5
|
+
* media handlers, the daemon plan endpoint, and the daemon front door.
|
|
6
|
+
*
|
|
7
|
+
* Pure: no I/O, no catalog, no plan fetch. Hosts still expand family names,
|
|
8
|
+
* walk default chains, and load credentials; this only decides whether the
|
|
9
|
+
* field means "omit → default", "resolve this id/family", or "refuse: chat
|
|
10
|
+
* alias on a media surface".
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* Surfaces that participate in media model decisions. Embeddings is included
|
|
14
|
+
* even though its default chain is curated differently from the `media`
|
|
15
|
+
* default class — an omitted embeddings model still means "walk the default
|
|
16
|
+
* chain", and a chat alias on `/v1/embeddings` is still refused.
|
|
17
|
+
*/
|
|
18
|
+
export const MediaModelSurface = S.Literals([
|
|
19
|
+
"image",
|
|
20
|
+
"image_edit",
|
|
21
|
+
"transcription",
|
|
22
|
+
"speech",
|
|
23
|
+
"video",
|
|
24
|
+
"embeddings",
|
|
25
|
+
]);
|
|
26
|
+
export const CHAT_ALIAS_ON_MEDIA_SURFACE_CODE = "chat_alias_on_media_surface";
|
|
27
|
+
/** Built-in chat tier aliases — always refused on a media surface. */
|
|
28
|
+
export const isDefaultChatTierAlias = (raw) => DEFAULT_TIER_ALIASES.includes(raw);
|
|
29
|
+
const EXAMPLE_MODEL = {
|
|
30
|
+
embeddings: "openai/text-embedding-3-small",
|
|
31
|
+
image: "google/nano-banana-pro",
|
|
32
|
+
image_edit: "chatgpt/gpt-image-1",
|
|
33
|
+
transcription: "openai/whisper-1",
|
|
34
|
+
speech: "openai/tts-1",
|
|
35
|
+
video: "google/veo-3.1-fast-generate-preview",
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* Example catalog id for a surface — used in the refuse message so the
|
|
39
|
+
* caller sees what a concrete media model looks like.
|
|
40
|
+
*/
|
|
41
|
+
export const mediaModelSurfaceExample = (surface) => EXAMPLE_MODEL[surface];
|
|
42
|
+
export const chatAliasOnMediaSurfaceMessage = (alias, surface) => `"${alias}" is a chat alias; pass a ${surface} model (e.g. "${mediaModelSurfaceExample(surface)}") or omit model`;
|
|
43
|
+
/**
|
|
44
|
+
* Names that are chat-only aliases for this surface: the built-in tiers
|
|
45
|
+
* always, plus any user fallback group whose chain has no model with the
|
|
46
|
+
* surface's capability. Family names (`grok`) are never in this set.
|
|
47
|
+
*/
|
|
48
|
+
export const mediaChatOnlyAliasNames = (params) => {
|
|
49
|
+
const names = new Set(DEFAULT_TIER_ALIASES);
|
|
50
|
+
for (const group of params.fallbackGroups) {
|
|
51
|
+
if (!group.models.some(params.modelHasSurfaceCapability)) {
|
|
52
|
+
names.add(group.name);
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
return names;
|
|
56
|
+
};
|
|
57
|
+
const nameSetOf = (names) => (names instanceof Set ? names : new Set(names));
|
|
58
|
+
/**
|
|
59
|
+
* Classify a media request's `model` field before dispatch / plan expansion.
|
|
60
|
+
*
|
|
61
|
+
* `chatOnlyAliasNames` must include at least {@link DEFAULT_TIER_ALIASES};
|
|
62
|
+
* hosts build the full set with {@link mediaChatOnlyAliasNames}. A family
|
|
63
|
+
* name that resolves per surface (`grok` on images) is never in that set
|
|
64
|
+
* and falls through to `resolve_family`.
|
|
65
|
+
*/
|
|
66
|
+
export const decideMediaModelField = (args) => {
|
|
67
|
+
if (args.field.kind === "invalid")
|
|
68
|
+
return { kind: "invalid_model_field" };
|
|
69
|
+
if (args.field.kind === "absent") {
|
|
70
|
+
return { kind: "omit_default", surface: args.surface };
|
|
71
|
+
}
|
|
72
|
+
const aliasNames = nameSetOf(args.chatOnlyAliasNames);
|
|
73
|
+
// Tiers are refused even if a host forgot to put them in the set.
|
|
74
|
+
if (isDefaultChatTierAlias(args.field.value) ||
|
|
75
|
+
aliasNames.has(args.field.value)) {
|
|
76
|
+
return {
|
|
77
|
+
kind: "refuse_chat_alias",
|
|
78
|
+
surface: args.surface,
|
|
79
|
+
alias: args.field.value,
|
|
80
|
+
code: CHAT_ALIAS_ON_MEDIA_SURFACE_CODE,
|
|
81
|
+
message: chatAliasOnMediaSurfaceMessage(args.field.value, args.surface),
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
return {
|
|
85
|
+
kind: "resolve_family",
|
|
86
|
+
surface: args.surface,
|
|
87
|
+
rawId: args.field.value,
|
|
88
|
+
};
|
|
89
|
+
};
|
|
@@ -14,77 +14,49 @@
|
|
|
14
14
|
* fresh model guess), and the refusal stays ACTIONABLE — `supported` carries
|
|
15
15
|
* alternatives that came from a FACT, never an invented suggestion.
|
|
16
16
|
*/
|
|
17
|
-
|
|
18
17
|
/** Why a single option cannot be served. */
|
|
19
|
-
export type TMediaOptionIssueCode =
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
18
|
+
export type TMediaOptionIssueCode =
|
|
19
|
+
/** The model/wire has no such knob at all. */
|
|
20
|
+
"unsupported_param"
|
|
21
|
+
/** The knob exists, but not with the value that was sent. */
|
|
22
|
+
| "unsupported_value";
|
|
25
23
|
/** One structured, machine-readable reason a media option cannot be served. */
|
|
26
24
|
export type TMediaOptionIssue = {
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
25
|
+
/** Request field name, exactly as the caller spelled it on the wire. */
|
|
26
|
+
readonly param: string;
|
|
27
|
+
/** Caller-facing sentence; safe to echo verbatim. */
|
|
28
|
+
readonly message: string;
|
|
29
|
+
readonly code: TMediaOptionIssueCode;
|
|
30
|
+
/**
|
|
31
|
+
* Values/alternatives this model DOES accept for `param`, when a catalog or
|
|
32
|
+
* published-wire fact states them. Omitted rather than guessed — an empty
|
|
33
|
+
* or invented list is worse than no list, because it reads as authoritative.
|
|
34
|
+
*/
|
|
35
|
+
readonly supported?: ReadonlyArray<string>;
|
|
38
36
|
};
|
|
39
|
-
|
|
40
37
|
/**
|
|
41
38
|
* A complete pre-dispatch refusal. `issues` is the whole locally-known set;
|
|
42
39
|
* `param`/`message` are the flattened view for the error envelope.
|
|
43
40
|
*/
|
|
44
41
|
export type TMediaOptionRejection = {
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
42
|
+
readonly param: string;
|
|
43
|
+
readonly message: string;
|
|
44
|
+
readonly issues: ReadonlyArray<TMediaOptionIssue>;
|
|
48
45
|
};
|
|
49
|
-
|
|
50
46
|
/**
|
|
51
47
|
* Flatten a collected issue list into a rejection, or `null` when the request
|
|
52
48
|
* is clean. The aggregate `message` concatenates EVERY issue message so a
|
|
53
49
|
* text-only client still learns about all of them — the staircase this whole
|
|
54
50
|
* shape exists to end would otherwise reappear for exactly those clients.
|
|
55
51
|
*/
|
|
56
|
-
export const mediaOptionRejection
|
|
57
|
-
issues: ReadonlyArray<TMediaOptionIssue>,
|
|
58
|
-
): TMediaOptionRejection | null => {
|
|
59
|
-
const first = issues[0];
|
|
60
|
-
if (first === undefined) return null;
|
|
61
|
-
return {
|
|
62
|
-
param: first.param,
|
|
63
|
-
message: issues.map((issue) => issue.message).join(" "),
|
|
64
|
-
issues,
|
|
65
|
-
};
|
|
66
|
-
};
|
|
67
|
-
|
|
52
|
+
export declare const mediaOptionRejection: (issues: ReadonlyArray<TMediaOptionIssue>) => TMediaOptionRejection | null;
|
|
68
53
|
/**
|
|
69
54
|
* Standard sentence for an option the resolved model has no field for.
|
|
70
55
|
* Centralised so every adapter's refusal reads the same way and any
|
|
71
56
|
* `supported` alternatives are appended in one place.
|
|
72
57
|
*/
|
|
73
|
-
export const unsupportedParamIssue
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
})
|
|
78
|
-
const supported =
|
|
79
|
-
params.supported !== undefined && params.supported.length > 0
|
|
80
|
-
? ` Supported here: ${params.supported.join(", ")}.`
|
|
81
|
-
: "";
|
|
82
|
-
return {
|
|
83
|
-
param: params.param,
|
|
84
|
-
code: "unsupported_param",
|
|
85
|
-
message: `"${params.param}" ${params.reason}${supported}`,
|
|
86
|
-
...(params.supported !== undefined && params.supported.length > 0
|
|
87
|
-
? { supported: params.supported }
|
|
88
|
-
: {}),
|
|
89
|
-
};
|
|
90
|
-
};
|
|
58
|
+
export declare const unsupportedParamIssue: (params: {
|
|
59
|
+
readonly param: string;
|
|
60
|
+
readonly reason: string;
|
|
61
|
+
readonly supported?: ReadonlyArray<string>;
|
|
62
|
+
}) => TMediaOptionIssue;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ONE shared shape for "this media request carries options the resolved model
|
|
3
|
+
* cannot honour", used by every media adapter that validates before dispatch.
|
|
4
|
+
*
|
|
5
|
+
* It lives in `protocol` because the OpenAI image adapter, the Google image
|
|
6
|
+
* adapter and the daemon's walkers all answer the same question and each used
|
|
7
|
+
* to answer it with its own ad-hoc `{ param, message }` record — unreadable
|
|
8
|
+
* uniformly by a caller, and flattened to a string by the handlers. Sharing
|
|
9
|
+
* the SHAPE is not sharing a capability table: every adapter still derives its
|
|
10
|
+
* own issues from its own catalog facts / published wire schema.
|
|
11
|
+
*
|
|
12
|
+
* Two guarantees: all known issues in ONE failure (a first-failure validator
|
|
13
|
+
* turns a five-field request into a five-round-trip staircase, each trip a
|
|
14
|
+
* fresh model guess), and the refusal stays ACTIONABLE — `supported` carries
|
|
15
|
+
* alternatives that came from a FACT, never an invented suggestion.
|
|
16
|
+
*/
|
|
17
|
+
/**
|
|
18
|
+
* Flatten a collected issue list into a rejection, or `null` when the request
|
|
19
|
+
* is clean. The aggregate `message` concatenates EVERY issue message so a
|
|
20
|
+
* text-only client still learns about all of them — the staircase this whole
|
|
21
|
+
* shape exists to end would otherwise reappear for exactly those clients.
|
|
22
|
+
*/
|
|
23
|
+
export const mediaOptionRejection = (issues) => {
|
|
24
|
+
const first = issues[0];
|
|
25
|
+
if (first === undefined)
|
|
26
|
+
return null;
|
|
27
|
+
return {
|
|
28
|
+
param: first.param,
|
|
29
|
+
message: issues.map((issue) => issue.message).join(" "),
|
|
30
|
+
issues,
|
|
31
|
+
};
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* Standard sentence for an option the resolved model has no field for.
|
|
35
|
+
* Centralised so every adapter's refusal reads the same way and any
|
|
36
|
+
* `supported` alternatives are appended in one place.
|
|
37
|
+
*/
|
|
38
|
+
export const unsupportedParamIssue = (params) => {
|
|
39
|
+
const supported = params.supported !== undefined && params.supported.length > 0
|
|
40
|
+
? ` Supported here: ${params.supported.join(", ")}.`
|
|
41
|
+
: "";
|
|
42
|
+
return {
|
|
43
|
+
param: params.param,
|
|
44
|
+
code: "unsupported_param",
|
|
45
|
+
message: `"${params.param}" ${params.reason}${supported}`,
|
|
46
|
+
...(params.supported !== undefined && params.supported.length > 0
|
|
47
|
+
? { supported: params.supported }
|
|
48
|
+
: {}),
|
|
49
|
+
};
|
|
50
|
+
};
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/** Kinds of stored media (mirrors `MediaKind` in `@openllm/schema`). */
|
|
2
|
+
export type TMediaTypeKind = "image" | "audio" | "video" | "document";
|
|
3
|
+
/**
|
|
4
|
+
* Allowed content types → { extension, media kind }. A closed list so the
|
|
5
|
+
* store cannot be used as a generic file host. Blobs are PUBLIC, so nothing
|
|
6
|
+
* a browser would run on the blob origin (HTML, SVG, JS) is on it. The chat
|
|
7
|
+
* composer's picker and the daemon's attachment store read this same list.
|
|
8
|
+
*/
|
|
9
|
+
export declare const MEDIA_TYPES: Readonly<Record<string, {
|
|
10
|
+
readonly ext: string;
|
|
11
|
+
readonly kind: TMediaTypeKind;
|
|
12
|
+
}>>;
|
|
13
|
+
/** Extension → MIME, inverting `MEDIA_TYPES` (first MIME per extension). */
|
|
14
|
+
export declare const MIME_BY_MEDIA_EXT: Readonly<Record<string, string>>;
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Allowed content types → { extension, media kind }. A closed list so the
|
|
3
|
+
* store cannot be used as a generic file host. Blobs are PUBLIC, so nothing
|
|
4
|
+
* a browser would run on the blob origin (HTML, SVG, JS) is on it. The chat
|
|
5
|
+
* composer's picker and the daemon's attachment store read this same list.
|
|
6
|
+
*/
|
|
7
|
+
export const MEDIA_TYPES = {
|
|
8
|
+
"image/png": { ext: "png", kind: "image" },
|
|
9
|
+
"image/jpeg": { ext: "jpg", kind: "image" },
|
|
10
|
+
"image/webp": { ext: "webp", kind: "image" },
|
|
11
|
+
"image/gif": { ext: "gif", kind: "image" },
|
|
12
|
+
"image/avif": { ext: "avif", kind: "image" },
|
|
13
|
+
"image/heic": { ext: "heic", kind: "image" },
|
|
14
|
+
"image/heif": { ext: "heif", kind: "image" },
|
|
15
|
+
"image/bmp": { ext: "bmp", kind: "image" },
|
|
16
|
+
"image/tiff": { ext: "tiff", kind: "image" },
|
|
17
|
+
"application/pdf": { ext: "pdf", kind: "document" },
|
|
18
|
+
"text/plain": { ext: "txt", kind: "document" },
|
|
19
|
+
"text/markdown": { ext: "md", kind: "document" },
|
|
20
|
+
"text/csv": { ext: "csv", kind: "document" },
|
|
21
|
+
"application/json": { ext: "json", kind: "document" },
|
|
22
|
+
"application/rtf": { ext: "rtf", kind: "document" },
|
|
23
|
+
"application/msword": { ext: "doc", kind: "document" },
|
|
24
|
+
"application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
|
|
25
|
+
ext: "docx",
|
|
26
|
+
kind: "document",
|
|
27
|
+
},
|
|
28
|
+
"application/vnd.ms-excel": { ext: "xls", kind: "document" },
|
|
29
|
+
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
|
|
30
|
+
ext: "xlsx",
|
|
31
|
+
kind: "document",
|
|
32
|
+
},
|
|
33
|
+
"application/vnd.ms-powerpoint": { ext: "ppt", kind: "document" },
|
|
34
|
+
"application/vnd.openxmlformats-officedocument.presentationml.presentation": {
|
|
35
|
+
ext: "pptx",
|
|
36
|
+
kind: "document",
|
|
37
|
+
},
|
|
38
|
+
"audio/mpeg": { ext: "mp3", kind: "audio" },
|
|
39
|
+
"audio/mp3": { ext: "mp3", kind: "audio" },
|
|
40
|
+
"audio/wav": { ext: "wav", kind: "audio" },
|
|
41
|
+
"audio/x-wav": { ext: "wav", kind: "audio" },
|
|
42
|
+
"audio/ogg": { ext: "ogg", kind: "audio" },
|
|
43
|
+
"audio/aac": { ext: "aac", kind: "audio" },
|
|
44
|
+
"audio/flac": { ext: "flac", kind: "audio" },
|
|
45
|
+
"audio/opus": { ext: "opus", kind: "audio" },
|
|
46
|
+
"audio/mp4": { ext: "m4a", kind: "audio" },
|
|
47
|
+
"audio/x-m4a": { ext: "m4a", kind: "audio" },
|
|
48
|
+
"audio/webm": { ext: "weba", kind: "audio" },
|
|
49
|
+
"audio/aiff": { ext: "aiff", kind: "audio" },
|
|
50
|
+
"video/mp4": { ext: "mp4", kind: "video" },
|
|
51
|
+
"video/webm": { ext: "webm", kind: "video" },
|
|
52
|
+
"video/quicktime": { ext: "mov", kind: "video" },
|
|
53
|
+
"video/x-m4v": { ext: "m4v", kind: "video" },
|
|
54
|
+
"video/x-matroska": { ext: "mkv", kind: "video" },
|
|
55
|
+
"video/x-msvideo": { ext: "avi", kind: "video" },
|
|
56
|
+
"video/mpeg": { ext: "mpeg", kind: "video" },
|
|
57
|
+
};
|
|
58
|
+
/** Extension → MIME, inverting `MEDIA_TYPES` (first MIME per extension). */
|
|
59
|
+
export const MIME_BY_MEDIA_EXT = Object.fromEntries(Object.entries(MEDIA_TYPES)
|
|
60
|
+
.reverse()
|
|
61
|
+
.map(([mime, { ext }]) => [ext, mime]));
|
|
@@ -0,0 +1,254 @@
|
|
|
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
|
+
/** A release version as integers, most significant first. */
|
|
32
|
+
export type TModelVersion = ReadonlyArray<number>;
|
|
33
|
+
/**
|
|
34
|
+
* Everything provider-specific the engine is allowed to know — and all
|
|
35
|
+
* of it is DERIVED from a model corpus by {@link deriveModelIdentityRules},
|
|
36
|
+
* never authored. There is no rule table to maintain: adding a model row
|
|
37
|
+
* is the only thing anyone has to do.
|
|
38
|
+
*/
|
|
39
|
+
export type TModelIdentityRules = {
|
|
40
|
+
/**
|
|
41
|
+
* The ONLY prefixes that may be split off before a `/`. A custom
|
|
42
|
+
* upstream id can legitimately contain slashes, so anything unlisted
|
|
43
|
+
* keeps its id whole.
|
|
44
|
+
*/
|
|
45
|
+
readonly namespaces?: ReadonlyArray<string>;
|
|
46
|
+
/**
|
|
47
|
+
* Words the corpus shows AFTER a version span (`sol`, `mini`,
|
|
48
|
+
* `flash`). A token outside this set is family text, which is what
|
|
49
|
+
* keeps a truncated shorthand like `5.6-s` from being read as a
|
|
50
|
+
* request for a variant called `s`.
|
|
51
|
+
*/
|
|
52
|
+
readonly variantTokens?: ReadonlyArray<string>;
|
|
53
|
+
/**
|
|
54
|
+
* Word-stems the corpus has shown carrying a generation number
|
|
55
|
+
* (`kimi-k2.5`/`kimi-k3` → `k`).
|
|
56
|
+
*
|
|
57
|
+
* It exists because `k3` and `q4` are the SAME shape: a word welded to
|
|
58
|
+
* a number. One is a generation, the other is quantization, and no
|
|
59
|
+
* amount of structure separates them — only the observation that the
|
|
60
|
+
* catalog shows `k` varying across several numbers while `q` does not.
|
|
61
|
+
* Absent evidence the engine declines to guess, which is why a bare
|
|
62
|
+
* parse leaves `kimi-k3` versionless rather than inventing a version.
|
|
63
|
+
*/
|
|
64
|
+
readonly versionStems?: ReadonlyArray<string>;
|
|
65
|
+
};
|
|
66
|
+
/**
|
|
67
|
+
* A parsed identity. `raw` and `providerModelId` keep their original
|
|
68
|
+
* spelling because they are the EXECUTION identity; only the comparable
|
|
69
|
+
* fields (`family`, `variants`) are case-normalised.
|
|
70
|
+
*/
|
|
71
|
+
export type TModelIdentity = {
|
|
72
|
+
readonly raw: string;
|
|
73
|
+
/** Set only when a recognised namespace prefixed the id. */
|
|
74
|
+
readonly provider: string | null;
|
|
75
|
+
readonly providerModelId: string;
|
|
76
|
+
readonly family: string;
|
|
77
|
+
readonly version: TModelVersion | null;
|
|
78
|
+
readonly versionText: string | null;
|
|
79
|
+
/** A date-like suffix. Kept apart from the version on purpose. */
|
|
80
|
+
readonly snapshot: string | null;
|
|
81
|
+
/** Sorted and de-duped so two identities compare by value. */
|
|
82
|
+
readonly variants: ReadonlyArray<string>;
|
|
83
|
+
};
|
|
84
|
+
/**
|
|
85
|
+
* Parse a model id into its comparable parts. Pure and total — an
|
|
86
|
+
* unparseable id simply yields a family with no version, which every
|
|
87
|
+
* caller treats as "no confident match" rather than an error.
|
|
88
|
+
*
|
|
89
|
+
* A recognised routing namespace is split off, so this is the parser for
|
|
90
|
+
* REQUEST input (`cursor/grok-4.7`). For an id that already arrived with
|
|
91
|
+
* its provider alongside it, use `parseUpstreamModelIdentity`.
|
|
92
|
+
*/
|
|
93
|
+
export declare const parseModelIdentity: (raw: string, rules?: TModelIdentityRules) => TModelIdentity;
|
|
94
|
+
/**
|
|
95
|
+
* Parse an UPSTREAM model id whose provider is already known separately.
|
|
96
|
+
*
|
|
97
|
+
* No namespace is ever split off here: a custom endpoint may legitimately
|
|
98
|
+
* serve `openai/gpt-5.6`, and that whole string is the id to send
|
|
99
|
+
* upstream. Splitting it because `openai` happens to be a routing
|
|
100
|
+
* namespace elsewhere would corrupt the execution identity of a model
|
|
101
|
+
* belonging to a different provider.
|
|
102
|
+
*/
|
|
103
|
+
export declare const parseUpstreamModelIdentity: (providerModelId: string, rules?: TModelIdentityRules) => TModelIdentity;
|
|
104
|
+
/** One row of the corpus the rules are derived from. */
|
|
105
|
+
export type TModelCorpusEntry = {
|
|
106
|
+
readonly provider: string;
|
|
107
|
+
readonly providerModelId: string;
|
|
108
|
+
};
|
|
109
|
+
/**
|
|
110
|
+
* Derive the identity rules from the model corpus ITSELF — the catalog
|
|
111
|
+
* teaches the engine its own vocabulary, so adding a model row requires
|
|
112
|
+
* no rule maintenance anywhere.
|
|
113
|
+
*
|
|
114
|
+
* Two things are derived, and nothing else:
|
|
115
|
+
*
|
|
116
|
+
* - `namespaces`: the provider slugs the corpus actually contains, so
|
|
117
|
+
* `cursor/grok-4.7` splits while a custom endpoint's `org/model`
|
|
118
|
+
* stays whole.
|
|
119
|
+
* - `variantTokens`: every non-numeric token the corpus shows AFTER a
|
|
120
|
+
* version span (`gpt-5.6-sol` → `sol`, `sora-2-pro` → `pro`). That
|
|
121
|
+
* is what separates `gpt-5.4` from `gpt-5.4-mini` and keeps
|
|
122
|
+
* `gemini-3.5-flash` from donating to `gemini-3.1-pro`, with no list
|
|
123
|
+
* to maintain.
|
|
124
|
+
*
|
|
125
|
+
* Family and version structure is NOT derived: it is read structurally
|
|
126
|
+
* per id (see `findVersionSpan`), so `claude-fable-5` and
|
|
127
|
+
* `claude-fable-5-1` are one family at versions `[5]` and `[5,1]`
|
|
128
|
+
* whether or not any sibling exists to compare them against.
|
|
129
|
+
*
|
|
130
|
+
* Memoised on the identity of the array passed in, so a catalog built
|
|
131
|
+
* once yields ONE rules object for the process — which is what keeps the
|
|
132
|
+
* per-object pattern cache, and any candidate index a caller keys off
|
|
133
|
+
* it, from missing on every request.
|
|
134
|
+
*/
|
|
135
|
+
export declare const deriveModelIdentityRules: (models: ReadonlyArray<TModelCorpusEntry>) => TModelIdentityRules;
|
|
136
|
+
/**
|
|
137
|
+
* Ascending numeric comparison. Shorter tuples are zero-padded (`4` ==
|
|
138
|
+
* `4.0`) and an unknown version sorts lowest, so a versionless entry never
|
|
139
|
+
* outranks a known release.
|
|
140
|
+
*/
|
|
141
|
+
export declare const compareModelVersion: (a: TModelVersion | null, b: TModelVersion | null) => number;
|
|
142
|
+
/**
|
|
143
|
+
* Same comparable family.
|
|
144
|
+
*
|
|
145
|
+
* Families are derived from the ids themselves, so two spellings of one
|
|
146
|
+
* family already agree by construction and there is nothing left for a
|
|
147
|
+
* rename table to reconcile.
|
|
148
|
+
*/
|
|
149
|
+
export declare const isComparableFamily: (a: TModelIdentity, b: TModelIdentity) => boolean;
|
|
150
|
+
/** Identical meaningful variants — never a cross-variant match. */
|
|
151
|
+
export declare const isSameVariant: (a: TModelIdentity, b: TModelIdentity) => boolean;
|
|
152
|
+
/** One eligible row, already carrying its parsed identity. */
|
|
153
|
+
export type TModelCandidate<TValue> = {
|
|
154
|
+
/** Full routing id — the final, totally-ordered tie-break. */
|
|
155
|
+
readonly id: string;
|
|
156
|
+
readonly provider: string;
|
|
157
|
+
readonly identity: TModelIdentity;
|
|
158
|
+
/** The caller's entry, returned untouched. */
|
|
159
|
+
readonly value: TValue;
|
|
160
|
+
/** Preferred class; LOWER wins (e.g. subscription 0, metered 1). */
|
|
161
|
+
readonly classRank?: number;
|
|
162
|
+
/** Authored provider priority within a class; lower wins. */
|
|
163
|
+
readonly providerRank?: number;
|
|
164
|
+
};
|
|
165
|
+
export type TModelCandidateInput<TValue> = {
|
|
166
|
+
readonly id: string;
|
|
167
|
+
readonly provider: string;
|
|
168
|
+
readonly providerModelId: string;
|
|
169
|
+
readonly value: TValue;
|
|
170
|
+
readonly classRank?: number;
|
|
171
|
+
readonly providerRank?: number;
|
|
172
|
+
};
|
|
173
|
+
export declare const buildModelCandidate: <TValue>(input: TModelCandidateInput<TValue>, rules?: TModelIdentityRules) => TModelCandidate<TValue>;
|
|
174
|
+
/** Build a whole index at once; rule patterns compile once for the batch. */
|
|
175
|
+
export declare const buildModelCandidates: <TValue>(inputs: ReadonlyArray<TModelCandidateInput<TValue>>, rules?: TModelIdentityRules) => ReadonlyArray<TModelCandidate<TValue>>;
|
|
176
|
+
export type TModelMatchReason = "exact_id" | "exact_provider_model_id" | "terminal_suffix" | "family_version" | "family_newest" | "prefix" | "boundary";
|
|
177
|
+
export type TModelSelection<TValue> = {
|
|
178
|
+
readonly kind: "selected";
|
|
179
|
+
readonly candidate: TModelCandidate<TValue>;
|
|
180
|
+
readonly reason: TModelMatchReason;
|
|
181
|
+
/** Every candidate that survived narrowing, best first. */
|
|
182
|
+
readonly considered: ReadonlyArray<TModelCandidate<TValue>>;
|
|
183
|
+
} | {
|
|
184
|
+
readonly kind: "ambiguous";
|
|
185
|
+
readonly reason: TModelMatchReason;
|
|
186
|
+
readonly candidates: ReadonlyArray<TModelCandidate<TValue>>;
|
|
187
|
+
} | {
|
|
188
|
+
readonly kind: "none";
|
|
189
|
+
};
|
|
190
|
+
export type TSelectRequestModelOptions<TValue> = {
|
|
191
|
+
readonly rules?: TModelIdentityRules;
|
|
192
|
+
/**
|
|
193
|
+
* Eligibility runs BEFORE any narrowing, which is the whole point: an
|
|
194
|
+
* unavailable newest version must not eliminate an available older one.
|
|
195
|
+
*/
|
|
196
|
+
readonly isEligible?: (candidate: TModelCandidate<TValue>) => boolean;
|
|
197
|
+
};
|
|
198
|
+
/**
|
|
199
|
+
* Total order for EQUIVALENT request candidates, best first: newest
|
|
200
|
+
* version, then preferred class, then authored provider rank, then
|
|
201
|
+
* snapshot precedence, then provider slug, then full id. Version leads
|
|
202
|
+
* deliberately — an older subscription model must not beat a newer
|
|
203
|
+
* available one on provider preference alone — and snapshot precedence
|
|
204
|
+
* sits ahead of the provider/id tie so a rebuild is chosen for being
|
|
205
|
+
* newer rather than for sorting later.
|
|
206
|
+
*
|
|
207
|
+
* Every component is a total order on a key and they are composed
|
|
208
|
+
* lexicographically, so the result is total, transitive and free of
|
|
209
|
+
* cycles regardless of which fields the candidates happen to carry.
|
|
210
|
+
*/
|
|
211
|
+
export declare const compareRequestCandidates: <TValue>(a: TModelCandidate<TValue>, b: TModelCandidate<TValue>) => number;
|
|
212
|
+
/**
|
|
213
|
+
* Resolve a possibly-imprecise request model against already-scoped
|
|
214
|
+
* candidates.
|
|
215
|
+
*
|
|
216
|
+
* Stages, in order: eligibility → exact identity → intent narrowing →
|
|
217
|
+
* newest within the family → deterministic tie-break. Explicit input is
|
|
218
|
+
* never upgraded: an exact `grok-4.6` stays on 4.6 even when 4.7 is
|
|
219
|
+
* available, and a version fragment (`grok-4.6`) only ever selects a
|
|
220
|
+
* maximum WITHIN that fragment.
|
|
221
|
+
*
|
|
222
|
+
* Nothing here decides availability, auth, or surface support — the caller
|
|
223
|
+
* expresses all of that through `isEligible`, and a `none`/`ambiguous`
|
|
224
|
+
* result means the caller keeps its existing passthrough/error behaviour.
|
|
225
|
+
*/
|
|
226
|
+
export declare const selectRequestModel: <TValue>(query: string, candidates: ReadonlyArray<TModelCandidate<TValue>>, options?: TSelectRequestModelOptions<TValue>) => TModelSelection<TValue>;
|
|
227
|
+
export type TDonorRelation = "exact" | "same_provider_predecessor" | "cross_provider_predecessor";
|
|
228
|
+
export type TDonorSelection<TValue> = {
|
|
229
|
+
readonly kind: "donor";
|
|
230
|
+
readonly donor: TModelCandidate<TValue>;
|
|
231
|
+
readonly relation: TDonorRelation;
|
|
232
|
+
} | {
|
|
233
|
+
readonly kind: "none";
|
|
234
|
+
};
|
|
235
|
+
export type TSelectMetadataDonorOptions<TValue> = {
|
|
236
|
+
readonly rules?: TModelIdentityRules;
|
|
237
|
+
/** Exclude deprecated/synthesized rows — the caller owns that fact. */
|
|
238
|
+
readonly isEligibleDonor?: (candidate: TModelCandidate<TValue>) => boolean;
|
|
239
|
+
};
|
|
240
|
+
/**
|
|
241
|
+
* Pick the nearest authored donor for a target identity.
|
|
242
|
+
*
|
|
243
|
+
* Classes, strongest first: an exact id, then the greatest same-provider
|
|
244
|
+
* version NOT EXCEEDING the target, then the same across providers. A
|
|
245
|
+
* successor is never a donor — borrowing from a version that does not
|
|
246
|
+
* exist yet would present a guess as a fact — and an unrelated family
|
|
247
|
+
* yields `none` so the caller keeps its existing unknown-metadata
|
|
248
|
+
* behaviour rather than inheriting from a nearest string.
|
|
249
|
+
*
|
|
250
|
+
* The engine returns a donor and a RELATION only. Which fields may be
|
|
251
|
+
* inherited, and which (identity, lifecycle, routing policy, repair flags)
|
|
252
|
+
* may never be, is the catalog's policy, not this module's.
|
|
253
|
+
*/
|
|
254
|
+
export declare const selectMetadataDonor: <TValue>(target: TModelIdentity, donors: ReadonlyArray<TModelCandidate<TValue>>, options?: TSelectMetadataDonorOptions<TValue>) => TDonorSelection<TValue>;
|