@openllmsh/sdk 2.10.12-alpha.0 → 2.10.12-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,279 @@
|
|
|
1
|
+
import { Effect, Schema as S } from "effect";
|
|
2
|
+
import { PROVIDER_TIER_METHODOLOGY_VERSION } from "./provider-tier.js";
|
|
3
|
+
/**
|
|
4
|
+
* Public usage index — OpenLLM's own aggregate projection of gateway activity,
|
|
5
|
+
* published as exact figures. This is our analytics, not a re-release of any
|
|
6
|
+
* upstream vendor's data: raw counts, projected per-tier value, and period-over-
|
|
7
|
+
* period change, with no suppression, bucketing, floors, or noise. Rows are
|
|
8
|
+
* recomputed and OVERWRITTEN each rollup run (live, never frozen).
|
|
9
|
+
*/
|
|
10
|
+
/**
|
|
11
|
+
* Explicit value-methodology id on the public response. Same string as
|
|
12
|
+
* {@link PROVIDER_TIER_METHODOLOGY_VERSION} / public value `metric_version`.
|
|
13
|
+
* Cross-deployment merge MUST compare this literally — never default a peer
|
|
14
|
+
* that omits it to the local current version.
|
|
15
|
+
*/
|
|
16
|
+
export const PUBLIC_USAGE_VALUE_METHODOLOGY_VERSION = PROVIDER_TIER_METHODOLOGY_VERSION;
|
|
17
|
+
export const PublicUsageMetric = S.Literals([
|
|
18
|
+
"model_popularity",
|
|
19
|
+
"provider_popularity",
|
|
20
|
+
"value",
|
|
21
|
+
]);
|
|
22
|
+
export const PublicUsagePopularityMetrics = S.Struct({
|
|
23
|
+
users: S.Number,
|
|
24
|
+
user_days: S.Number,
|
|
25
|
+
requests: S.Number,
|
|
26
|
+
prev_users: S.NullOr(S.Number),
|
|
27
|
+
});
|
|
28
|
+
export const PublicUsageValueMetrics = S.Struct({
|
|
29
|
+
value_usd_30d: S.Number,
|
|
30
|
+
accounts: S.Number,
|
|
31
|
+
/** Valid meter-delta pairs supporting the selected value estimate. */
|
|
32
|
+
pair_count: S.Number,
|
|
33
|
+
/** Ratio clustering quality for the selected value estimate. */
|
|
34
|
+
tightness: S.Number,
|
|
35
|
+
prev_value_usd_30d: S.NullOr(S.Number),
|
|
36
|
+
});
|
|
37
|
+
/** The exact figures stored per non-marker rollup row in `metrics` jsonb. */
|
|
38
|
+
export const PublicUsageIndexMetrics = S.Union([
|
|
39
|
+
PublicUsagePopularityMetrics,
|
|
40
|
+
PublicUsageValueMetrics,
|
|
41
|
+
]);
|
|
42
|
+
/** Metadata marker that represents an otherwise empty completed bucket. */
|
|
43
|
+
export const PUBLIC_USAGE_INDEX_BUCKET_MARKER = "__bucket__";
|
|
44
|
+
/**
|
|
45
|
+
* Internal payload used only by the `__bucket__` completion marker. The value
|
|
46
|
+
* bucket's marker carries a fingerprint of the eligible (provider, account,
|
|
47
|
+
* tier) set it was derived from, so a reader can distinguish changed inputs
|
|
48
|
+
* against mere elapsed time and refresh the bucket in place. Optional: markers
|
|
49
|
+
* written before the field existed (and popularity markers) omit it.
|
|
50
|
+
*/
|
|
51
|
+
export const PublicUsageIndexMarkerMetrics = S.Struct({
|
|
52
|
+
tier_set_fingerprint: S.optional(S.String),
|
|
53
|
+
evidence_stamp: S.optional(S.String),
|
|
54
|
+
});
|
|
55
|
+
/**
|
|
56
|
+
* The metric-specific portion of a stored row. This makes a row's sibling
|
|
57
|
+
* `metric` column the discriminator for its otherwise unrelated JSON payload.
|
|
58
|
+
*/
|
|
59
|
+
export const PublicUsageIndexStoredMetric = S.Union([
|
|
60
|
+
S.Struct({
|
|
61
|
+
metric: S.Literals(["model_popularity"]),
|
|
62
|
+
subject: S.String,
|
|
63
|
+
metrics: PublicUsagePopularityMetrics,
|
|
64
|
+
}),
|
|
65
|
+
S.Struct({
|
|
66
|
+
metric: S.Literals(["provider_popularity"]),
|
|
67
|
+
subject: S.String,
|
|
68
|
+
metrics: PublicUsagePopularityMetrics,
|
|
69
|
+
}),
|
|
70
|
+
S.Struct({
|
|
71
|
+
metric: S.Literals(["value"]),
|
|
72
|
+
subject: S.String,
|
|
73
|
+
metrics: PublicUsageValueMetrics,
|
|
74
|
+
}),
|
|
75
|
+
S.Struct({
|
|
76
|
+
metric: PublicUsageMetric,
|
|
77
|
+
subject: S.Literals([PUBLIC_USAGE_INDEX_BUCKET_MARKER]),
|
|
78
|
+
metrics: PublicUsageIndexMarkerMetrics,
|
|
79
|
+
}),
|
|
80
|
+
]);
|
|
81
|
+
const PublicUsageIndexRowBase = S.Struct({
|
|
82
|
+
metric_version: S.String,
|
|
83
|
+
provider: S.String,
|
|
84
|
+
label: S.String,
|
|
85
|
+
period_start: S.String,
|
|
86
|
+
period_end: S.String,
|
|
87
|
+
updated_at: S.String,
|
|
88
|
+
});
|
|
89
|
+
/** One rollup row, matching the `public_usage_index` table. */
|
|
90
|
+
export const PublicUsageIndexRow = S.Union([
|
|
91
|
+
S.Struct({
|
|
92
|
+
...PublicUsageIndexRowBase.fields,
|
|
93
|
+
metric: S.Literals(["model_popularity"]),
|
|
94
|
+
subject: S.String,
|
|
95
|
+
metrics: PublicUsagePopularityMetrics,
|
|
96
|
+
}),
|
|
97
|
+
S.Struct({
|
|
98
|
+
...PublicUsageIndexRowBase.fields,
|
|
99
|
+
metric: S.Literals(["provider_popularity"]),
|
|
100
|
+
subject: S.String,
|
|
101
|
+
metrics: PublicUsagePopularityMetrics,
|
|
102
|
+
}),
|
|
103
|
+
S.Struct({
|
|
104
|
+
...PublicUsageIndexRowBase.fields,
|
|
105
|
+
metric: S.Literals(["value"]),
|
|
106
|
+
subject: S.String,
|
|
107
|
+
metrics: PublicUsageValueMetrics,
|
|
108
|
+
}),
|
|
109
|
+
S.Struct({
|
|
110
|
+
...PublicUsageIndexRowBase.fields,
|
|
111
|
+
metric: PublicUsageMetric,
|
|
112
|
+
subject: S.Literals([PUBLIC_USAGE_INDEX_BUCKET_MARKER]),
|
|
113
|
+
metrics: PublicUsageIndexMarkerMetrics,
|
|
114
|
+
}),
|
|
115
|
+
]);
|
|
116
|
+
/** Factual caption describing what the figures measure (not a legal hedge). */
|
|
117
|
+
export const PUBLIC_USAGE_INDEX_CAPTION = "Trends measured across OpenLLM gateway activity";
|
|
118
|
+
export const PublicModelPopularity = S.Struct({
|
|
119
|
+
/** The provider's registry `displayName` — a rendered label, not a key. */
|
|
120
|
+
provider: S.String,
|
|
121
|
+
/**
|
|
122
|
+
* The stable provider slug (`claude_code`, `openai`, …) behind that label.
|
|
123
|
+
* Same role as `PublicValueByTier.provider_slug`: anything rendering a logo,
|
|
124
|
+
* a tint or a public brand name keys off THIS, since `provider` above is a
|
|
125
|
+
* display string. Empty only for a legacy label the registry no longer knows.
|
|
126
|
+
*
|
|
127
|
+
* Decoded with a default — see the note on cross-deployment merging below.
|
|
128
|
+
*/
|
|
129
|
+
provider_slug: S.String.pipe(S.optional, S.withDecodingDefault(Effect.succeed(""))),
|
|
130
|
+
model: S.String,
|
|
131
|
+
users: S.Number,
|
|
132
|
+
user_days: S.Number,
|
|
133
|
+
requests: S.Number,
|
|
134
|
+
/**
|
|
135
|
+
* Percent change in distinct users vs the previous window; null when there
|
|
136
|
+
* is no prior period, or when the prior is too small to divide by — see
|
|
137
|
+
* `is_new` for the third state and the reader's floors for the threshold.
|
|
138
|
+
*/
|
|
139
|
+
pct_change: S.NullOr(S.Number),
|
|
140
|
+
/**
|
|
141
|
+
* The row arrived this period: it carries real activity now and the prior
|
|
142
|
+
* window had none worth comparing against. Only ever true while
|
|
143
|
+
* `pct_change` is null — the two together are a tri-state, since a percent
|
|
144
|
+
* off a negligible base is a number, not a measurement.
|
|
145
|
+
*
|
|
146
|
+
* Decoded with a default — see the note on cross-deployment merging below.
|
|
147
|
+
*/
|
|
148
|
+
is_new: S.Boolean.pipe(S.optional, S.withDecodingDefault(Effect.succeed(false))),
|
|
149
|
+
});
|
|
150
|
+
export const PublicProviderPopularity = S.Struct({
|
|
151
|
+
/** The provider's registry `displayName` — a rendered label, not a key. */
|
|
152
|
+
provider: S.String,
|
|
153
|
+
/**
|
|
154
|
+
* The stable provider slug (`claude_code`, `openai`, …) behind that label.
|
|
155
|
+
* Unlike the model rows, a provider row already stores the slug as its
|
|
156
|
+
* SUBJECT, so this is carried straight through rather than recovered from
|
|
157
|
+
* the registry. Anything rendering a logo, a tint or a public brand name
|
|
158
|
+
* keys off THIS, since `provider` above is a display string.
|
|
159
|
+
*
|
|
160
|
+
* Decoded with a default — see the note on cross-deployment merging below.
|
|
161
|
+
*/
|
|
162
|
+
provider_slug: S.String.pipe(S.optional, S.withDecodingDefault(Effect.succeed(""))),
|
|
163
|
+
users: S.Number,
|
|
164
|
+
user_days: S.Number,
|
|
165
|
+
requests: S.Number,
|
|
166
|
+
pct_change: S.NullOr(S.Number),
|
|
167
|
+
/** See `PublicModelPopularity.is_new`. */
|
|
168
|
+
is_new: S.Boolean.pipe(S.optional, S.withDecodingDefault(Effect.succeed(false))),
|
|
169
|
+
});
|
|
170
|
+
/**
|
|
171
|
+
* One period's reading for a tier, for the value trend series.
|
|
172
|
+
*
|
|
173
|
+
* Deliberately only the two fields a line needs. The calibration figures
|
|
174
|
+
* (`accounts`, `pair_count`, `tightness`) describe how well a SINGLE estimate
|
|
175
|
+
* is supported and are published on the current reading; repeating them for
|
|
176
|
+
* every historical point would multiply the payload by the number of retained
|
|
177
|
+
* buckets to say something no line can draw.
|
|
178
|
+
*/
|
|
179
|
+
export const PublicValuePoint = S.Struct({
|
|
180
|
+
/** ISO period end, and the x value of the point. */
|
|
181
|
+
period_end: S.String,
|
|
182
|
+
value_usd_30d: S.Number,
|
|
183
|
+
});
|
|
184
|
+
/**
|
|
185
|
+
* A field added to the public response AFTER deployments began reading each
|
|
186
|
+
* other's copies.
|
|
187
|
+
*
|
|
188
|
+
* `mergeConfiguredPublicUsageIndex` fetches a PEER deployment's
|
|
189
|
+
* `/api/public/usage-index` and decodes it with this schema, so a field that
|
|
190
|
+
* is merely required would make every merge fail — a permitted local fallback
|
|
191
|
+
* that is not cacheable — for the whole window in which the two deployments
|
|
192
|
+
* disagree. Decoded with a default instead: the property stays non-optional
|
|
193
|
+
* for consumers, and an older peer still parses.
|
|
194
|
+
*/
|
|
195
|
+
export const PublicValueByTier = S.Struct({
|
|
196
|
+
/**
|
|
197
|
+
* The provider's registry `displayName` — a sign-in-flow label ("Claude
|
|
198
|
+
* (Pro/Max sign-in)"), kept for callers that already read it.
|
|
199
|
+
*/
|
|
200
|
+
provider: S.String,
|
|
201
|
+
/**
|
|
202
|
+
* The stable provider slug (`claude_code`, `chatgpt`, …), split off the
|
|
203
|
+
* row's `provider:tier` subject. `provider` above is a display string and so
|
|
204
|
+
* cannot key a brand map; anything rendering a logo, a tint or a public
|
|
205
|
+
* brand name keys off THIS.
|
|
206
|
+
*
|
|
207
|
+
* Decoded with a default — see the note on cross-deployment merging below.
|
|
208
|
+
*/
|
|
209
|
+
provider_slug: S.String.pipe(S.optional, S.withDecodingDefault(Effect.succeed(""))),
|
|
210
|
+
tier: S.String,
|
|
211
|
+
/** Projected API-equivalent value of the best-calibrated subscription per 30 days. */
|
|
212
|
+
value_usd_30d: S.Number,
|
|
213
|
+
/** Eligible calibrated accounts in the tier; the figure is the best-calibrated one of them. */
|
|
214
|
+
accounts: S.Number,
|
|
215
|
+
/** Valid meter-delta pairs supporting the selected account's estimate. */
|
|
216
|
+
pair_count: S.Number,
|
|
217
|
+
/** Ratio clustering quality for the selected account's estimate. */
|
|
218
|
+
tightness: S.Number,
|
|
219
|
+
/**
|
|
220
|
+
* Percent change vs the previous window; null when there is no prior, or
|
|
221
|
+
* when the prior is a negligible fraction of the period's leading tier. A
|
|
222
|
+
* tier worth a few dollars swings by thousands of percent on one account's
|
|
223
|
+
* ordinary week, which says nothing about the tier and crowds out the
|
|
224
|
+
* figures that do. See `is_new` for the third state.
|
|
225
|
+
*/
|
|
226
|
+
pct_change: S.NullOr(S.Number),
|
|
227
|
+
/** See `PublicModelPopularity.is_new`. */
|
|
228
|
+
is_new: S.Boolean.pipe(S.optional, S.withDecodingDefault(Effect.succeed(false))),
|
|
229
|
+
/**
|
|
230
|
+
* Every retained period for this tier, oldest first, INCLUDING the current
|
|
231
|
+
* one — so a consumer plots `history` alone rather than stitching it to the
|
|
232
|
+
* top-level reading and risking a duplicated or missing final point.
|
|
233
|
+
*
|
|
234
|
+
* The buckets were always kept (`public_usage_index` is keyed on
|
|
235
|
+
* `(metric_version, metric, subject, period_start)`); it was the reader that
|
|
236
|
+
* dropped them. A tier measured for the first time has a single point, which
|
|
237
|
+
* is a fact a chart has to render rather than an error.
|
|
238
|
+
*/
|
|
239
|
+
history: S.Array(PublicValuePoint).pipe(S.optional, S.withDecodingDefault(Effect.succeed([]))),
|
|
240
|
+
});
|
|
241
|
+
export const PeriodWindow = S.Struct({
|
|
242
|
+
period_start: S.NullOr(S.String),
|
|
243
|
+
period_end: S.NullOr(S.String),
|
|
244
|
+
});
|
|
245
|
+
/**
|
|
246
|
+
* Public usage artifact: exact aggregate figures grouped for display. The
|
|
247
|
+
* top-level period is the min/max envelope across metric-specific windows,
|
|
248
|
+
* retained for backward compatibility.
|
|
249
|
+
*
|
|
250
|
+
* `value_methodology_version` identifies the recurring-value economics behind
|
|
251
|
+
* `value_by_tier`. Unlike fields decoded with defaults for mixed-version peers,
|
|
252
|
+
* this one is required on every response we emit, and a configured mandatory
|
|
253
|
+
* merge rejects a peer that omits it or reports a different string — never
|
|
254
|
+
* assume an old peer shares the local methodology, and never fall back to
|
|
255
|
+
* local-only value figures when the merge URL is set.
|
|
256
|
+
*/
|
|
257
|
+
export const PublicUsageIndexResponse = S.Struct({
|
|
258
|
+
period_start: S.NullOr(S.String),
|
|
259
|
+
period_end: S.NullOr(S.String),
|
|
260
|
+
windows: S.Struct({
|
|
261
|
+
model: PeriodWindow,
|
|
262
|
+
provider: PeriodWindow,
|
|
263
|
+
value: PeriodWindow,
|
|
264
|
+
}),
|
|
265
|
+
caption: S.Literals([PUBLIC_USAGE_INDEX_CAPTION]),
|
|
266
|
+
/**
|
|
267
|
+
* Shared with {@link PUBLIC_USAGE_VALUE_METHODOLOGY_VERSION}. Emit the
|
|
268
|
+
* constant; merge compares it literally before combining `value_by_tier`.
|
|
269
|
+
*/
|
|
270
|
+
value_methodology_version: S.String,
|
|
271
|
+
model_popularity: S.Array(PublicModelPopularity),
|
|
272
|
+
provider_popularity: S.Array(PublicProviderPopularity),
|
|
273
|
+
value_by_tier: S.Array(PublicValueByTier),
|
|
274
|
+
});
|
|
275
|
+
export function hasPublicUsageIndexData(response) {
|
|
276
|
+
return (response.model_popularity.length > 0 ||
|
|
277
|
+
response.provider_popularity.length > 0 ||
|
|
278
|
+
response.value_by_tier.length > 0);
|
|
279
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GENERATED FILE — do not edit by hand.
|
|
3
|
+
*
|
|
4
|
+
* Source of truth: the static model catalog's rows carrying
|
|
5
|
+
* `capabilities: ["realtime"]` (`packages/api/catalog/models/*`).
|
|
6
|
+
* Regenerate with:
|
|
7
|
+
*
|
|
8
|
+
* bun run build:realtime-generated
|
|
9
|
+
*
|
|
10
|
+
* `scripts/check-realtime-generated.ts` (`bun run check:realtime-generated`)
|
|
11
|
+
* fails when this artifact drifts from the catalog.
|
|
12
|
+
*
|
|
13
|
+
* WHY THIS IS GENERATED RATHER THAN LOOKED UP — the documented exception:
|
|
14
|
+
* the realtime model id is decoded by the SHIPPED daemon binary at mux
|
|
15
|
+
* admission (`RealtimeStreamOpenPayload`), so it must be a literal owned by
|
|
16
|
+
* `protocol`. `protocol` cannot import `packages/api` (layering), and a
|
|
17
|
+
* runtime catalog read would add a daemon -> API dependency at admission time
|
|
18
|
+
* and break decode compatibility with deployed binaries. Generating keeps the
|
|
19
|
+
* catalog as the ONE source while leaving the wire literal static.
|
|
20
|
+
*
|
|
21
|
+
* This artifact carries ids only — never catalog metadata — and asserts
|
|
22
|
+
* nothing about availability.
|
|
23
|
+
*/
|
|
24
|
+
/** Every realtime `provider_model_id` the catalog declares. */
|
|
25
|
+
export declare const REALTIME_MODEL_IDS: readonly ["grok-voice-latest"];
|
|
26
|
+
/** The id each realtime provider dials by default. */
|
|
27
|
+
export declare const REALTIME_DEFAULT_MODEL_BY_PROVIDER: {
|
|
28
|
+
readonly grok: "grok-voice-latest";
|
|
29
|
+
};
|
|
@@ -21,11 +21,9 @@
|
|
|
21
21
|
* This artifact carries ids only — never catalog metadata — and asserts
|
|
22
22
|
* nothing about availability.
|
|
23
23
|
*/
|
|
24
|
-
|
|
25
24
|
/** Every realtime `provider_model_id` the catalog declares. */
|
|
26
|
-
export const REALTIME_MODEL_IDS = ["grok-voice-latest"]
|
|
27
|
-
|
|
25
|
+
export const REALTIME_MODEL_IDS = ["grok-voice-latest"];
|
|
28
26
|
/** The id each realtime provider dials by default. */
|
|
29
27
|
export const REALTIME_DEFAULT_MODEL_BY_PROVIDER = {
|
|
30
|
-
|
|
31
|
-
}
|
|
28
|
+
grok: "grok-voice-latest",
|
|
29
|
+
};
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Realtime (voice) duplex session vocabulary — the supported subset only.
|
|
3
|
+
*
|
|
4
|
+
* Scope note: only Grok's text-to-audio realtime connection is live-verified
|
|
5
|
+
* (`docs/research/subscription-provider-capabilities-2026-09-17.md`,
|
|
6
|
+
* "Verified realtime audio output"). Audio INPUT, barge-in, and any event
|
|
7
|
+
* outside the closed unions below are deliberately unmodeled — an unknown or
|
|
8
|
+
* unsupported event is rejected by the parser, never forwarded blind. Widen
|
|
9
|
+
* this file (new literals, new event variants) only after a live probe
|
|
10
|
+
* verifies the addition; do not speculatively add vendor fields.
|
|
11
|
+
*
|
|
12
|
+
* Transport: this is payload vocabulary only. The mux `kind:"realtime"` OPEN
|
|
13
|
+
* envelope lives in `./mux` (`RealtimeStreamOpenPayload`, folded into
|
|
14
|
+
* `StreamOpenPayload`); the dedicated `realtime1` duplex capability is
|
|
15
|
+
* `REALTIME_DUPLEX_CAP` in `./mux`. Once a stream is open, client/server
|
|
16
|
+
* events defined here ride NDJSON-framed (one JSON value per `\n`-terminated
|
|
17
|
+
* line) over the stream's flow-controlled DATA channel — see
|
|
18
|
+
* `@openllmsh/sdk/tunnel/streams`'s `pumpRealtimeEvents` / `sendRealtimeEvent` /
|
|
19
|
+
* `realtimeStream`, which import the bounds and parsers below rather than
|
|
20
|
+
* duplicating them.
|
|
21
|
+
*/
|
|
22
|
+
import { Schema as S } from "effect";
|
|
23
|
+
/**
|
|
24
|
+
* Hard per-session lifetime. The daemon (and the consumer-side helper) both
|
|
25
|
+
* RESET the stream with `timeout` once reached, regardless of activity —
|
|
26
|
+
* shared here so neither side can drift from the other's bound.
|
|
27
|
+
*/
|
|
28
|
+
export declare const REALTIME_SESSION_MAX_LIFETIME_MS: number;
|
|
29
|
+
/** Liveness heartbeat cadence once a realtime session is open. Either peer
|
|
30
|
+
* may send `{t:"heartbeat"}` (a mux CTRL frame, `StreamCtrlPayload` in
|
|
31
|
+
* `./mux`); missing ALL inbound traffic (heartbeat or otherwise) for
|
|
32
|
+
* {@link REALTIME_HEARTBEAT_TIMEOUT_MS} RESETs with `timeout`. */
|
|
33
|
+
export declare const REALTIME_HEARTBEAT_INTERVAL_MS = 15000;
|
|
34
|
+
export declare const REALTIME_HEARTBEAT_TIMEOUT_MS = 45000;
|
|
35
|
+
/**
|
|
36
|
+
* Bound on ONE NDJSON realtime event line (JSON-encoded, UTF-8 bytes,
|
|
37
|
+
* including the trailing `\n`). Vendor audio deltas are small PCM chunks (a
|
|
38
|
+
* few KB base64 per the research probe's 107,048-byte total across many
|
|
39
|
+
* deltas) — this is a generous ceiling, not the expected size. A line (or an
|
|
40
|
+
* unterminated remainder) over this bound is a bounded-queue overflow, never
|
|
41
|
+
* a growing buffer.
|
|
42
|
+
*/
|
|
43
|
+
export declare const REALTIME_MAX_EVENT_BYTES: number;
|
|
44
|
+
export declare const REALTIME_MAX_LINE_BYTES: number;
|
|
45
|
+
/**
|
|
46
|
+
* Bound on in-flight (parsed, not-yet-delivered-to-consumer) server events a
|
|
47
|
+
* daemon-side realtime session holds before treating a slow consumer as
|
|
48
|
+
* `lagging` and ending the session — the realtime counterpart of the PTY
|
|
49
|
+
* session's bounded output queue. Shared so the daemon's queue and any
|
|
50
|
+
* future consumer-side queue agree on one number.
|
|
51
|
+
*/
|
|
52
|
+
export declare const REALTIME_MAX_QUEUED_EVENTS = 64;
|
|
53
|
+
/** Bound on one `conversation.item.create` `input_text` value. */
|
|
54
|
+
export declare const REALTIME_MAX_INPUT_TEXT_LENGTH = 4000;
|
|
55
|
+
/**
|
|
56
|
+
* Subscription realtime providers with a LIVE-VERIFIED connection. Grok only
|
|
57
|
+
* — see the module doc. Widening this is a protocol change, not a client
|
|
58
|
+
* toggle.
|
|
59
|
+
*/
|
|
60
|
+
export declare const RealtimeProvider: S.Literal<"grok">;
|
|
61
|
+
export type TRealtimeProvider = S.Schema.Type<typeof RealtimeProvider>;
|
|
62
|
+
/**
|
|
63
|
+
* The realtime model verified against `wss://api.x.ai/v1/realtime`.
|
|
64
|
+
*
|
|
65
|
+
* The id set is CATALOG-OWNED: it comes from `./realtime-generated`, a tiny
|
|
66
|
+
* artifact derived from the catalog rows declaring `capabilities:
|
|
67
|
+
* ["realtime"]`. It stays a generated literal rather than a runtime lookup
|
|
68
|
+
* because the SHIPPED daemon binary decodes this schema at mux admission —
|
|
69
|
+
* `protocol` cannot import `packages/api`, and a runtime read would add a
|
|
70
|
+
* daemon -> API dependency and break decode compat with deployed binaries.
|
|
71
|
+
* `bun run check:realtime-generated` fails on drift. Widening the set is a
|
|
72
|
+
* catalog change, not a client toggle.
|
|
73
|
+
*/
|
|
74
|
+
export declare const RealtimeModel: S.Literals<readonly ["grok-voice-latest"]>;
|
|
75
|
+
export type TRealtimeModel = S.Schema.Type<typeof RealtimeModel>;
|
|
76
|
+
/** Reuses the verified Grok TTS voice list — never duplicate that literal. */
|
|
77
|
+
export declare const RealtimeVoice: S.Literals<readonly ["eve"]>;
|
|
78
|
+
export type TRealtimeVoice = S.Schema.Type<typeof RealtimeVoice>;
|
|
79
|
+
/** Only PCM16 at 24kHz was exercised on the realtime connection. */
|
|
80
|
+
export declare const RealtimeOutputAudioFormat: S.Literal<"pcm16_24khz">;
|
|
81
|
+
export type TRealtimeOutputAudioFormat = S.Schema.Type<typeof RealtimeOutputAudioFormat>;
|
|
82
|
+
/**
|
|
83
|
+
* Mux `kind:"realtime"` OPEN payload — folded into `StreamOpenPayload` in
|
|
84
|
+
* `./mux`. Declaring `voice`/`model` here (not only inside `session.update`)
|
|
85
|
+
* lets the serving daemon refuse an unsupported combination before it ever
|
|
86
|
+
* dials the vendor.
|
|
87
|
+
*/
|
|
88
|
+
export declare const RealtimeStreamOpenPayload: S.Struct<{
|
|
89
|
+
readonly kind: S.Literal<"realtime">;
|
|
90
|
+
readonly provider: S.Literal<"grok">;
|
|
91
|
+
readonly model: S.Literals<readonly ["grok-voice-latest"]>;
|
|
92
|
+
readonly voice: S.Literals<readonly ["eve"]>;
|
|
93
|
+
}>;
|
|
94
|
+
export type TRealtimeStreamOpenPayload = S.Schema.Type<typeof RealtimeStreamOpenPayload>;
|
|
95
|
+
export declare const RealtimeSessionUpdateEvent: S.Struct<{
|
|
96
|
+
readonly type: S.Literal<"session.update">;
|
|
97
|
+
readonly session: S.Struct<{
|
|
98
|
+
readonly voice: S.Literals<readonly ["eve"]>;
|
|
99
|
+
readonly output_audio_format: S.Literal<"pcm16_24khz">;
|
|
100
|
+
readonly turn_detection: S.Struct<{
|
|
101
|
+
readonly type: S.Null;
|
|
102
|
+
}>;
|
|
103
|
+
}>;
|
|
104
|
+
}>;
|
|
105
|
+
export type TRealtimeSessionUpdateEvent = S.Schema.Type<typeof RealtimeSessionUpdateEvent>;
|
|
106
|
+
/** Text-only conversation item — audio input is unmodeled (module doc). */
|
|
107
|
+
export declare const RealtimeConversationItemCreateEvent: S.Struct<{
|
|
108
|
+
readonly type: S.Literal<"conversation.item.create">;
|
|
109
|
+
readonly item: S.Struct<{
|
|
110
|
+
readonly type: S.Literal<"message">;
|
|
111
|
+
readonly role: S.Literal<"user">;
|
|
112
|
+
readonly content: S.$Array<S.Struct<{
|
|
113
|
+
readonly type: S.Literal<"input_text">;
|
|
114
|
+
readonly text: S.String;
|
|
115
|
+
}>>;
|
|
116
|
+
}>;
|
|
117
|
+
}>;
|
|
118
|
+
export type TRealtimeConversationItemCreateEvent = S.Schema.Type<typeof RealtimeConversationItemCreateEvent>;
|
|
119
|
+
export declare const RealtimeResponseCreateEvent: S.Struct<{
|
|
120
|
+
readonly type: S.Literal<"response.create">;
|
|
121
|
+
}>;
|
|
122
|
+
export type TRealtimeResponseCreateEvent = S.Schema.Type<typeof RealtimeResponseCreateEvent>;
|
|
123
|
+
/** The entire supported client→server vocabulary. Anything else fails to
|
|
124
|
+
* parse and is dropped rather than forwarded upstream. */
|
|
125
|
+
export declare const RealtimeClientEvent: S.Union<readonly [S.Struct<{
|
|
126
|
+
readonly type: S.Literal<"session.update">;
|
|
127
|
+
readonly session: S.Struct<{
|
|
128
|
+
readonly voice: S.Literals<readonly ["eve"]>;
|
|
129
|
+
readonly output_audio_format: S.Literal<"pcm16_24khz">;
|
|
130
|
+
readonly turn_detection: S.Struct<{
|
|
131
|
+
readonly type: S.Null;
|
|
132
|
+
}>;
|
|
133
|
+
}>;
|
|
134
|
+
}>, S.Struct<{
|
|
135
|
+
readonly type: S.Literal<"conversation.item.create">;
|
|
136
|
+
readonly item: S.Struct<{
|
|
137
|
+
readonly type: S.Literal<"message">;
|
|
138
|
+
readonly role: S.Literal<"user">;
|
|
139
|
+
readonly content: S.$Array<S.Struct<{
|
|
140
|
+
readonly type: S.Literal<"input_text">;
|
|
141
|
+
readonly text: S.String;
|
|
142
|
+
}>>;
|
|
143
|
+
}>;
|
|
144
|
+
}>, S.Struct<{
|
|
145
|
+
readonly type: S.Literal<"response.create">;
|
|
146
|
+
}>]>;
|
|
147
|
+
export type TRealtimeClientEvent = S.Schema.Type<typeof RealtimeClientEvent>;
|
|
148
|
+
export declare const RealtimeSessionCreatedEvent: S.Struct<{
|
|
149
|
+
readonly type: S.Literal<"session.created">;
|
|
150
|
+
}>;
|
|
151
|
+
export declare const RealtimeSessionUpdatedEvent: S.Struct<{
|
|
152
|
+
readonly type: S.Literal<"session.updated">;
|
|
153
|
+
}>;
|
|
154
|
+
export declare const RealtimeResponseCreatedEvent: S.Struct<{
|
|
155
|
+
readonly type: S.Literal<"response.created">;
|
|
156
|
+
}>;
|
|
157
|
+
export declare const RealtimeResponseOutputAudioDeltaEvent: S.Struct<{
|
|
158
|
+
readonly type: S.Literal<"response.output_audio.delta">;
|
|
159
|
+
/** Base64-encoded PCM16/24kHz chunk. */
|
|
160
|
+
readonly delta: S.String;
|
|
161
|
+
}>;
|
|
162
|
+
export declare const RealtimeResponseOutputAudioTranscriptDeltaEvent: S.Struct<{
|
|
163
|
+
readonly type: S.Literal<"response.output_audio_transcript.delta">;
|
|
164
|
+
readonly delta: S.String;
|
|
165
|
+
}>;
|
|
166
|
+
export declare const RealtimeResponseOutputAudioDoneEvent: S.Struct<{
|
|
167
|
+
readonly type: S.Literal<"response.output_audio.done">;
|
|
168
|
+
}>;
|
|
169
|
+
export declare const RealtimeResponseDoneEvent: S.Struct<{
|
|
170
|
+
readonly type: S.Literal<"response.done">;
|
|
171
|
+
}>;
|
|
172
|
+
/** Normalized refusal/failure surfaced to the consumer in-band (distinct
|
|
173
|
+
* from a mux-level RESET, which ends the whole stream). */
|
|
174
|
+
export declare const RealtimeErrorEvent: S.Struct<{
|
|
175
|
+
readonly type: S.Literal<"error">;
|
|
176
|
+
readonly code: S.String;
|
|
177
|
+
readonly message: S.optional<S.String>;
|
|
178
|
+
}>;
|
|
179
|
+
export type TRealtimeErrorEvent = S.Schema.Type<typeof RealtimeErrorEvent>;
|
|
180
|
+
/** The entire supported server→client vocabulary. An unrecognized vendor
|
|
181
|
+
* event (or a shape that doesn't match one of these) is DROPPED by the
|
|
182
|
+
* daemon, never relayed verbatim — see `realtime-session.ts`. */
|
|
183
|
+
export declare const RealtimeServerEvent: S.Union<readonly [S.Struct<{
|
|
184
|
+
readonly type: S.Literal<"session.created">;
|
|
185
|
+
}>, S.Struct<{
|
|
186
|
+
readonly type: S.Literal<"session.updated">;
|
|
187
|
+
}>, S.Struct<{
|
|
188
|
+
readonly type: S.Literal<"response.created">;
|
|
189
|
+
}>, S.Struct<{
|
|
190
|
+
readonly type: S.Literal<"response.output_audio.delta">;
|
|
191
|
+
/** Base64-encoded PCM16/24kHz chunk. */
|
|
192
|
+
readonly delta: S.String;
|
|
193
|
+
}>, S.Struct<{
|
|
194
|
+
readonly type: S.Literal<"response.output_audio_transcript.delta">;
|
|
195
|
+
readonly delta: S.String;
|
|
196
|
+
}>, S.Struct<{
|
|
197
|
+
readonly type: S.Literal<"response.output_audio.done">;
|
|
198
|
+
}>, S.Struct<{
|
|
199
|
+
readonly type: S.Literal<"response.done">;
|
|
200
|
+
}>, S.Struct<{
|
|
201
|
+
readonly type: S.Literal<"error">;
|
|
202
|
+
readonly code: S.String;
|
|
203
|
+
readonly message: S.optional<S.String>;
|
|
204
|
+
}>]>;
|
|
205
|
+
export type TRealtimeServerEvent = S.Schema.Type<typeof RealtimeServerEvent>;
|
|
206
|
+
export declare const parseRealtimeClientEvent: (value: unknown) => TRealtimeClientEvent | null;
|
|
207
|
+
export declare const parseRealtimeServerEvent: (value: unknown) => TRealtimeServerEvent | null;
|
|
208
|
+
/**
|
|
209
|
+
* Encode one realtime event as an NDJSON line (`JSON.stringify(event) +
|
|
210
|
+
* "\n"`, UTF-8). Returns null on a non-serializable value or when the
|
|
211
|
+
* encoded line would exceed {@link REALTIME_MAX_LINE_BYTES} — callers must
|
|
212
|
+
* treat either as "do not send", never truncate.
|
|
213
|
+
*/
|
|
214
|
+
export declare const encodeRealtimeEventLine: (event: unknown) => Uint8Array | null;
|
|
215
|
+
/** Decode one NDJSON line's raw bytes into an unknown JSON value, or
|
|
216
|
+
* `undefined` on malformed UTF-8/JSON. */
|
|
217
|
+
export declare const decodeRealtimeLine: (line: Uint8Array) => unknown | undefined;
|
|
218
|
+
export type TRealtimeLineSplitResult = {
|
|
219
|
+
readonly lines: readonly Uint8Array[];
|
|
220
|
+
readonly remainder: Uint8Array;
|
|
221
|
+
};
|
|
222
|
+
/**
|
|
223
|
+
* Append `chunk` to a carried-over `remainder` and split on `\n`. Pure and
|
|
224
|
+
* allocation-bounded: the transient `combined` buffer is at most
|
|
225
|
+
* `remainder.byteLength + chunk.byteLength`, and this function is called
|
|
226
|
+
* once per inbound DATA frame (already bounded to the mux's own
|
|
227
|
+
* `MAX_PAYLOAD_BYTES`), so a caller that rejects a null result before the
|
|
228
|
+
* next call never accumulates past one frame beyond the line bound.
|
|
229
|
+
*
|
|
230
|
+
* Returns null when EITHER a newline-terminated segment OR the trailing
|
|
231
|
+
* not-yet-terminated remainder would exceed {@link REALTIME_MAX_LINE_BYTES}
|
|
232
|
+
* — callers MUST treat that as a bounded-queue overflow (RESET `lagging`),
|
|
233
|
+
* never grow the buffer further. Checking only the tail is not enough: the
|
|
234
|
+
* mux's own `MAX_PAYLOAD_BYTES` (256 KiB) is larger than
|
|
235
|
+
* `REALTIME_MAX_LINE_BYTES` (64 KiB), so a single inbound DATA frame can by
|
|
236
|
+
* itself carry a newline-terminated segment well past the line bound —
|
|
237
|
+
* that segment must be rejected before it is ever handed to
|
|
238
|
+
* `decodeRealtimeLine`/`JSON.parse`, not silently accepted because it
|
|
239
|
+
* happened to end in `\n`.
|
|
240
|
+
*/
|
|
241
|
+
export declare const splitRealtimeLines: (remainder: Uint8Array, chunk: Uint8Array) => TRealtimeLineSplitResult | null;
|