@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
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
import { Schema as S } from "effect";
|
|
2
|
-
import { AuthEvent } from "./auth";
|
|
3
|
-
import { RelayCommandLifecycleFrame } from "./control-channel";
|
|
4
|
-
import { DaemonCommand, DaemonCommandAck } from "./daemon";
|
|
5
|
-
import { ReplaySessionId } from "./replay-session";
|
|
6
|
-
import { TEAM_GRANT_B64_MAX } from "./team-grant";
|
|
7
|
-
|
|
2
|
+
import { AuthEvent } from "./auth.js";
|
|
3
|
+
import { RelayCommandLifecycleFrame } from "./control-channel.js";
|
|
4
|
+
import { DaemonCommand, DaemonCommandAck } from "./daemon.js";
|
|
5
|
+
import { ReplaySessionId } from "./replay-session.js";
|
|
6
|
+
import { TEAM_GRANT_B64_MAX } from "./team-grant.js";
|
|
8
7
|
// ─── Daemon relay (push over a Sandbox WebSocket, in-memory routing) ──
|
|
9
8
|
//
|
|
10
9
|
// A persistent WebSocket each end (daemon AND browser) holds to a relay
|
|
@@ -15,7 +14,6 @@ import { TEAM_GRANT_B64_MAX } from "./team-grant";
|
|
|
15
14
|
// durable write the relay keeps is `api_key_activity` presence/status, read
|
|
16
15
|
// by the stateless `/v1/*` proxy + a cold dashboard load. See
|
|
17
16
|
// `docs/proposals/daemon-owned-state-stateless-relay.md`.
|
|
18
|
-
|
|
19
17
|
/** Which end a connect ticket authorizes. A `daemon` socket receives
|
|
20
18
|
* commands for its `key_id` and sends acks/status; a `watcher` socket
|
|
21
19
|
* (a dashboard tab) enqueues commands for keys its `user_id` owns and
|
|
@@ -24,40 +22,25 @@ import { TEAM_GRANT_B64_MAX } from "./team-grant";
|
|
|
24
22
|
* (origin-side tunneling): it may only open mux channels, and the relay
|
|
25
23
|
* stamps its channels `consumer:"daemon"` exactly like a peer daemon's. */
|
|
26
24
|
export const RelayRole = S.Literals(["daemon", "watcher", "origin"]);
|
|
27
|
-
export type TRelayRole = S.Schema.Type<typeof RelayRole>;
|
|
28
|
-
|
|
29
25
|
/** Bounded, open-vocabulary capability advertisement limits. */
|
|
30
26
|
export const RELAY_CAP_MAX_ITEMS = 32;
|
|
31
27
|
export const RELAY_CAP_MAX_LENGTH = 64;
|
|
32
|
-
const RelayCapability = S.String.check(
|
|
33
|
-
|
|
34
|
-
S.isMaxLength(RELAY_CAP_MAX_LENGTH),
|
|
35
|
-
);
|
|
36
|
-
const RelayCapabilities = S.Array(RelayCapability).check(
|
|
37
|
-
S.isMaxLength(RELAY_CAP_MAX_ITEMS),
|
|
38
|
-
);
|
|
39
|
-
|
|
28
|
+
const RelayCapability = S.String.check(S.isMinLength(1), S.isMaxLength(RELAY_CAP_MAX_LENGTH));
|
|
29
|
+
const RelayCapabilities = S.Array(RelayCapability).check(S.isMaxLength(RELAY_CAP_MAX_ITEMS));
|
|
40
30
|
/**
|
|
41
31
|
* Channel ids are the mux envelope's canonical UUID in text form —
|
|
42
32
|
* RFC 4122 lowercase hex with variant nibble `8|9|a|b` (matches
|
|
43
33
|
* `@openllmsh/sdk/tunnel` `isChannelId` / `CHANNEL_ID_PATTERN`).
|
|
44
34
|
*/
|
|
45
|
-
const CHANNEL_ID_PATTERN =
|
|
46
|
-
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
|
|
35
|
+
const CHANNEL_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
|
|
47
36
|
export const ChannelId = S.String.check(S.isPattern(CHANNEL_ID_PATTERN));
|
|
48
|
-
export type TChannelId = S.Schema.Type<typeof ChannelId>;
|
|
49
|
-
|
|
50
37
|
/** Bounded open-vocabulary peer errors and refusal reasons. */
|
|
51
38
|
const RelayFreeString = S.String.check(S.isMinLength(1), S.isMaxLength(200));
|
|
52
|
-
|
|
53
39
|
/** The port the in-sandbox WS server listens on — declared in `ports` at
|
|
54
40
|
* `Sandbox.getOrCreate` (cloud) and bound by the relay. A fixed internal
|
|
55
41
|
* constant (the public surface is the sandbox's own domain), shared so the
|
|
56
42
|
* provisioner's `sandbox.domain(port)` and the relay's listener agree. */
|
|
57
43
|
export const RELAY_PORT = 8080;
|
|
58
|
-
|
|
59
|
-
export type TRelayDatabaseTarget = "pre-production" | "production";
|
|
60
|
-
|
|
61
44
|
/**
|
|
62
45
|
* The relay identity (sandbox name + TTL class) for the current deployment,
|
|
63
46
|
* derived from `VERCEL_ENV` — the only remaining discriminator now that a
|
|
@@ -68,29 +51,16 @@ export type TRelayDatabaseTarget = "pre-production" | "production";
|
|
|
68
51
|
* `pre-production`. Pure (a function of its input) so the DB client, the cloud
|
|
69
52
|
* provisioner, and the in-sandbox relay all agree from the same signal.
|
|
70
53
|
*/
|
|
71
|
-
export const resolveDatabaseTarget = (
|
|
72
|
-
vercelEnv: string | undefined,
|
|
73
|
-
): TRelayDatabaseTarget =>
|
|
74
|
-
vercelEnv === "production" ? "production" : "pre-production";
|
|
75
|
-
|
|
54
|
+
export const resolveDatabaseTarget = (vercelEnv) => vercelEnv === "production" ? "production" : "pre-production";
|
|
76
55
|
/** The name of the retired daemon-relay logical-replication slot. The relay no
|
|
77
56
|
* longer subscribes it (commands route in memory) — this is kept ONLY so
|
|
78
57
|
* `packages/db/migrate.ts` can DROP a leftover slot on deploy (Phase 5
|
|
79
58
|
* demolition). The matching `daemon_relay_pub` publication is dropped by
|
|
80
59
|
* `migrations/0007_chunky_expediter.sql` using its literal name. */
|
|
81
60
|
export const RELAY_SLOT = "daemon_relay_slot";
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
* publication/slot the CDC era carried are gone). Pure derivation (no env, no
|
|
85
|
-
* I/O) so the cloud provisioner and the relay agree. */
|
|
86
|
-
export type TRelayNames = {
|
|
87
|
-
readonly relayName: string;
|
|
88
|
-
};
|
|
89
|
-
|
|
90
|
-
export const relayNamesFor = (target: TRelayDatabaseTarget): TRelayNames => ({
|
|
91
|
-
relayName: `daemon-relay-${target}`,
|
|
61
|
+
export const relayNamesFor = (target) => ({
|
|
62
|
+
relayName: `daemon-relay-${target}`,
|
|
92
63
|
});
|
|
93
|
-
|
|
94
64
|
// ─── Sandbox origin tags (deprovisioning) ─────────────────────────────
|
|
95
65
|
//
|
|
96
66
|
// The provisioner tags each relay sandbox with the stable ORIGIN that uses it
|
|
@@ -99,36 +69,24 @@ export const relayNamesFor = (target: TRelayDatabaseTarget): TRelayNames => ({
|
|
|
99
69
|
// fetches. The cleanup cron groups boxes by origin and gracefully stops a
|
|
100
70
|
// superseded box (same origin, older freshness, different bundle hash) —
|
|
101
71
|
// see `lib/relay-sandbox-cleanup.ts`.
|
|
102
|
-
|
|
103
72
|
/** Tag key: the sanitized stable origin that provisioned/uses this box. */
|
|
104
73
|
export const RELAY_TAG_ORIGIN = "origin";
|
|
105
74
|
/** Tag key: unix-ms (decimal string) of the origin's last claim/refresh. */
|
|
106
75
|
export const RELAY_TAG_ORIGIN_AT = "origin-at";
|
|
107
|
-
|
|
108
|
-
/** The env signals the origin is derived from. `localHostname` is caller-
|
|
109
|
-
* provided (`os.hostname()`) so this stays pure and testable. */
|
|
110
|
-
export type TRelayOriginInputs = {
|
|
111
|
-
readonly vercelEnv: string | undefined;
|
|
112
|
-
readonly projectProductionUrl: string | undefined;
|
|
113
|
-
readonly branchUrl: string | undefined;
|
|
114
|
-
readonly deploymentUrl: string | undefined;
|
|
115
|
-
readonly localHostname: string | undefined;
|
|
116
|
-
};
|
|
117
|
-
|
|
118
76
|
/** Sandbox tag values must be short, plain tokens. Lowercase, strip the
|
|
119
77
|
* protocol + trailing slash, squash anything outside [a-z0-9._-], cap at 64.
|
|
120
78
|
* Returns null when nothing usable remains so the caller can fall back. */
|
|
121
|
-
const sanitizeOriginTag = (raw
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
79
|
+
const sanitizeOriginTag = (raw) => {
|
|
80
|
+
if (raw === undefined)
|
|
81
|
+
return null;
|
|
82
|
+
const cleaned = raw
|
|
83
|
+
.toLowerCase()
|
|
84
|
+
.replace(/^https?:\/\//, "")
|
|
85
|
+
.replace(/\/+$/, "")
|
|
86
|
+
.replace(/[^a-z0-9._-]/g, "-")
|
|
87
|
+
.slice(0, 64);
|
|
88
|
+
return cleaned === "" ? null : cleaned;
|
|
130
89
|
};
|
|
131
|
-
|
|
132
90
|
/**
|
|
133
91
|
* The STABLE origin identity for sandbox tagging — stable across deploys of
|
|
134
92
|
* the same "place", so the cleanup cron's per-origin change detection fires:
|
|
@@ -139,21 +97,18 @@ const sanitizeOriginTag = (raw: string | undefined): string | null => {
|
|
|
139
97
|
* other's boxes.
|
|
140
98
|
* Pure (a function of its inputs) per the convention above.
|
|
141
99
|
*/
|
|
142
|
-
export const resolveRelayOrigin = (inputs
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
);
|
|
152
|
-
|
|
153
|
-
const host = sanitizeOriginTag(inputs.localHostname);
|
|
154
|
-
return host === null ? "local" : `local-${host}`;
|
|
100
|
+
export const resolveRelayOrigin = (inputs) => {
|
|
101
|
+
if (inputs.vercelEnv === "production") {
|
|
102
|
+
return sanitizeOriginTag(inputs.projectProductionUrl) ?? "production";
|
|
103
|
+
}
|
|
104
|
+
if (inputs.vercelEnv === "preview") {
|
|
105
|
+
return (sanitizeOriginTag(inputs.branchUrl) ??
|
|
106
|
+
sanitizeOriginTag(inputs.deploymentUrl) ??
|
|
107
|
+
"preview");
|
|
108
|
+
}
|
|
109
|
+
const host = sanitizeOriginTag(inputs.localHostname);
|
|
110
|
+
return host === null ? "local" : `local-${host}`;
|
|
155
111
|
};
|
|
156
|
-
|
|
157
112
|
/**
|
|
158
113
|
* The decoded claims of a connect ticket. The cloud (`/api/daemon/channel`)
|
|
159
114
|
* mints these after validating the caller (`sk-llm` key → `daemon`, Neon
|
|
@@ -165,34 +120,29 @@ export const resolveRelayOrigin = (inputs: TRelayOriginInputs): string => {
|
|
|
165
120
|
* sandbox name; `jti` is a one-shot nonce consumed by the relay.
|
|
166
121
|
*/
|
|
167
122
|
export const RelayTicketClaims = S.Struct({
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
123
|
+
role: RelayRole,
|
|
124
|
+
user_id: S.String,
|
|
125
|
+
key_id: S.optional(S.String),
|
|
126
|
+
exp: S.Number,
|
|
127
|
+
/** Relay sandbox audience, e.g. `daemon-relay-production`. */
|
|
128
|
+
aud: S.String.check(S.isMinLength(1), S.isMaxLength(128)),
|
|
129
|
+
/** Unique ticket id (base64url) — single-use within the TTL window. */
|
|
130
|
+
jti: S.String.check(S.isMinLength(16), S.isMaxLength(64)),
|
|
176
131
|
});
|
|
177
|
-
export type TRelayTicketClaims = S.Schema.Type<typeof RelayTicketClaims>;
|
|
178
|
-
|
|
179
132
|
/**
|
|
180
133
|
* Domain-separation label for the Ed25519 seed derivation. Shared by the
|
|
181
134
|
* cloud signer and the verifier so both derive the same keypair from
|
|
182
135
|
* `NEON_AUTH_COOKIE_SECRET`. The sandbox receives only the public half.
|
|
183
136
|
*/
|
|
184
137
|
export const RELAY_TICKET_SEED_LABEL = "openllm-relay-ticket-ed25519-seed-v1";
|
|
185
|
-
|
|
186
138
|
/** One ICE server entry (STUN or TURN) on the channel handshake — mirrors
|
|
187
139
|
* `RTCIceServer` so browser and daemon feed it to their peer connections
|
|
188
140
|
* verbatim. */
|
|
189
141
|
export const IceServer = S.Struct({
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
142
|
+
urls: S.Union([S.String, S.Array(S.String)]),
|
|
143
|
+
username: S.optional(S.String),
|
|
144
|
+
credential: S.optional(S.String),
|
|
193
145
|
});
|
|
194
|
-
export type TIceServer = S.Schema.Type<typeof IceServer>;
|
|
195
|
-
|
|
196
146
|
/** GET /api/daemon/channel → the live relay WSS URL + a connect ticket. Both
|
|
197
147
|
* daemon and browser dial `wss_url`, presenting `ticket` in their first
|
|
198
148
|
* `hello` frame. The URL is the sandbox's own domain (`wss://<sandbox-host>`);
|
|
@@ -201,83 +151,68 @@ export type TIceServer = S.Schema.Type<typeof IceServer>;
|
|
|
201
151
|
* cloud-served ICE config (from `OPENLLM_RTC_ICE_SERVERS`) — absent, both
|
|
202
152
|
* ends fall back to their default STUN. */
|
|
203
153
|
export const RelayChannelResponse = S.Struct({
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
154
|
+
wss_url: S.String,
|
|
155
|
+
/** Short-lived Ed25519-signed connect ticket
|
|
156
|
+
* (opaque `<b64url(claims)>.<b64url(sig)>`). */
|
|
157
|
+
ticket: S.String,
|
|
158
|
+
/** Optional cloud-served ICE servers (STUN/TURN) for RTC peers. */
|
|
159
|
+
ice_servers: S.optional(S.Array(IceServer)),
|
|
210
160
|
});
|
|
211
|
-
export type TRelayChannelResponse = S.Schema.Type<typeof RelayChannelResponse>;
|
|
212
|
-
|
|
213
161
|
// ─── WebSocket frame envelope ────────────────────────────────────────
|
|
214
162
|
//
|
|
215
163
|
// One tagged union shared by all four parties. Each variant documents its
|
|
216
164
|
// direction; a given end only emits the subset it owns and ignores the
|
|
217
165
|
// rest. JSON over text frames.
|
|
218
|
-
|
|
219
166
|
/** client → relay (first frame). A daemon may piggyback its initial
|
|
220
167
|
* status snapshot; a watcher sends ticket only. */
|
|
221
168
|
export const RelayHelloFrame = S.Struct({
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
169
|
+
type: S.Literal("hello"),
|
|
170
|
+
ticket: S.String,
|
|
171
|
+
/** Daemon protocol capability; absent daemons retain legacy compatibility. */
|
|
172
|
+
protocol_version: S.optional(S.Number),
|
|
173
|
+
/** Open-vocabulary peer capability list.
|
|
174
|
+
* Unknown capabilities preserve forward compatibility. */
|
|
175
|
+
caps: S.optional(RelayCapabilities),
|
|
176
|
+
/** Daemon only: initial per-provider `TDaemonStatus` snapshot, folded
|
|
177
|
+
* into `api_key_activity.daemon_status_json` on connect. */
|
|
178
|
+
status: S.optional(S.Unknown),
|
|
232
179
|
});
|
|
233
|
-
export type TRelayHelloFrame = S.Schema.Type<typeof RelayHelloFrame>;
|
|
234
|
-
|
|
235
180
|
/** relay → client. Handshake accepted; carries the current presence snapshot so
|
|
236
181
|
* a freshly-attached dashboard paints immediately. */
|
|
237
182
|
export const RelayWelcomeFrame = S.Struct({
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
183
|
+
type: S.Literal("welcome"),
|
|
184
|
+
/** Watcher only: the AUTHORITATIVE set of the user's key ids that have a live
|
|
185
|
+
* daemon socket on the relay right now, from its in-memory registry. The
|
|
186
|
+
* dashboard treats membership as presence — keys absent here are offline by
|
|
187
|
+
* authority of the relay that owns every socket — so a stale-`true`
|
|
188
|
+
* `api_key_activity` row (ungraceful relay death) is corrected the instant a
|
|
189
|
+
* watcher (re)connects. Live status keeps flowing via `status_push`. */
|
|
190
|
+
snapshot: S.optional(S.Array(S.String)),
|
|
191
|
+
/** Daemon only: relay-assigned connection epoch for ordered snapshots. */
|
|
192
|
+
daemon_session_id: S.optional(S.String),
|
|
193
|
+
daemon_session_started_at_ms: S.optional(S.Number),
|
|
194
|
+
protocol_version: S.optional(S.Number),
|
|
195
|
+
/** Relay capabilities. */
|
|
196
|
+
caps: S.optional(RelayCapabilities),
|
|
197
|
+
/** Per-serving-daemon capability snapshots, parallel to `snapshot`. */
|
|
198
|
+
snapshot_caps: S.optional(S.Record(S.String, RelayCapabilities)),
|
|
254
199
|
});
|
|
255
|
-
export type TRelayWelcomeFrame = S.Schema.Type<typeof RelayWelcomeFrame>;
|
|
256
|
-
|
|
257
200
|
/** relay → daemon. One command to run, routed in memory the instant the watcher
|
|
258
201
|
* enqueues it (no durable mailbox). `id` is a relay-generated uuid. */
|
|
259
202
|
export const RelayCommandFrame = S.Struct({
|
|
260
|
-
|
|
261
|
-
|
|
203
|
+
type: S.Literal("command"),
|
|
204
|
+
command: DaemonCommand,
|
|
262
205
|
});
|
|
263
|
-
export type TRelayCommandFrame = S.Schema.Type<typeof RelayCommandFrame>;
|
|
264
|
-
|
|
265
206
|
/** daemon → relay. A terminal command result; the relay forwards it to the
|
|
266
207
|
* originating watcher as a `command_lifecycle` frame (no `daemon_commands`
|
|
267
208
|
* row to update). */
|
|
268
209
|
export const RelayAckFrame = S.Struct({
|
|
269
|
-
|
|
270
|
-
|
|
210
|
+
type: S.Literal("ack"),
|
|
211
|
+
ack: DaemonCommandAck,
|
|
271
212
|
});
|
|
272
|
-
export type TRelayAckFrame = S.Schema.Type<typeof RelayAckFrame>;
|
|
273
|
-
|
|
274
213
|
/** Planned-downtime reason on a graceful `active:false` status beacon.
|
|
275
214
|
* Absent ⇒ real offline / legacy beacon (CERTAIN death). */
|
|
276
215
|
export const RelayStatusRestartReason = S.Literal("restarting");
|
|
277
|
-
export type TRelayStatusRestartReason = S.Schema.Type<
|
|
278
|
-
typeof RelayStatusRestartReason
|
|
279
|
-
>;
|
|
280
|
-
|
|
281
216
|
/** daemon → relay. Heartbeat + per-provider snapshot. `active:false` is the
|
|
282
217
|
* graceful-exit beacon. The relay folds the snapshot into
|
|
283
218
|
* `api_key_activity.daemon_status_json` (durable, read by the proxy + a cold
|
|
@@ -290,20 +225,18 @@ export type TRelayStatusRestartReason = S.Schema.Type<
|
|
|
290
225
|
* CERTAIN death (`daemon_active=false`). See
|
|
291
226
|
* `docs/audit/2026-10-20-deploy-zero-downtime.md` fix #2. */
|
|
292
227
|
export const RelayStatusFrame = S.Struct({
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
228
|
+
type: S.Literal("status"),
|
|
229
|
+
active: S.optional(S.Boolean),
|
|
230
|
+
status: S.optional(S.Unknown),
|
|
231
|
+
/** Present for protocol-v2 daemon status snapshots. */
|
|
232
|
+
daemon_session_id: S.optional(S.String),
|
|
233
|
+
status_seq: S.optional(S.Number),
|
|
234
|
+
acks: S.optional(S.Array(DaemonCommandAck)),
|
|
235
|
+
/** Planned downtime; absent ⇒ real offline / legacy beacon. */
|
|
236
|
+
reason: S.optional(RelayStatusRestartReason),
|
|
237
|
+
/** Hint for origin grace / UI: ms until this key should be back. */
|
|
238
|
+
expect_back_ms: S.optional(S.Number),
|
|
304
239
|
});
|
|
305
|
-
export type TRelayStatusFrame = S.Schema.Type<typeof RelayStatusFrame>;
|
|
306
|
-
|
|
307
240
|
/** watcher → relay. The dashboard enqueues a control command for one of the
|
|
308
241
|
* user's keys. The relay authorizes it by REGISTRY MEMBERSHIP — a watcher may
|
|
309
242
|
* address `key_id` K iff a daemon socket for K is connected with the same
|
|
@@ -311,49 +244,41 @@ export type TRelayStatusFrame = S.Schema.Type<typeof RelayStatusFrame>;
|
|
|
311
244
|
* memory. `req_id` correlates the relay's `enqueue_ack`; omit it for
|
|
312
245
|
* fire-and-forget. */
|
|
313
246
|
export const RelayEnqueueFrame = S.Struct({
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
247
|
+
type: S.Literal("enqueue"),
|
|
248
|
+
req_id: S.optional(S.String),
|
|
249
|
+
key_id: S.String,
|
|
250
|
+
kind: S.String,
|
|
251
|
+
payload: S.optional(S.Unknown),
|
|
252
|
+
replay_session_id: S.optional(ReplaySessionId),
|
|
320
253
|
});
|
|
321
|
-
export type TRelayEnqueueFrame = S.Schema.Type<typeof RelayEnqueueFrame>;
|
|
322
|
-
|
|
323
254
|
/** relay → watcher. The result of an `enqueue` carrying a `req_id`: the
|
|
324
255
|
* relay-generated command id on success, or an error (`daemon_offline` /
|
|
325
256
|
* `invalid_command`). */
|
|
326
257
|
export const RelayEnqueueAckFrame = S.Struct({
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
258
|
+
type: S.Literal("enqueue_ack"),
|
|
259
|
+
req_id: S.String,
|
|
260
|
+
ok: S.Boolean,
|
|
261
|
+
id: S.optional(S.String),
|
|
262
|
+
error: S.optional(S.String),
|
|
332
263
|
});
|
|
333
|
-
export type TRelayEnqueueAckFrame = S.Schema.Type<typeof RelayEnqueueAckFrame>;
|
|
334
|
-
|
|
335
264
|
/** relay → watcher. A daemon's status snapshot for one key landed; push it
|
|
336
265
|
* to the dashboard. */
|
|
337
266
|
export const RelayStatusPushFrame = S.Struct({
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
267
|
+
type: S.Literal("status_push"),
|
|
268
|
+
key_id: S.String,
|
|
269
|
+
status: S.Unknown,
|
|
270
|
+
daemon_session_id: S.optional(S.String),
|
|
271
|
+
daemon_session_started_at_ms: S.optional(S.Number),
|
|
272
|
+
status_seq: S.optional(S.Number),
|
|
344
273
|
});
|
|
345
|
-
export type TRelayStatusPushFrame = S.Schema.Type<typeof RelayStatusPushFrame>;
|
|
346
|
-
|
|
347
274
|
/** relay → watcher. A key's daemon presence flipped (socket open/close). */
|
|
348
275
|
export const RelayPresenceFrame = S.Struct({
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
276
|
+
type: S.Literal("presence"),
|
|
277
|
+
key_id: S.String,
|
|
278
|
+
active: S.Boolean,
|
|
279
|
+
/** Present when an active daemon advertises capabilities. */
|
|
280
|
+
caps: S.optional(RelayCapabilities),
|
|
354
281
|
});
|
|
355
|
-
export type TRelayPresenceFrame = S.Schema.Type<typeof RelayPresenceFrame>;
|
|
356
|
-
|
|
357
282
|
// ─── Subscription tunnel + device sessions (mux-only) ────────────────
|
|
358
283
|
//
|
|
359
284
|
// A consumer (browser watcher socket, or another daemon's socket) opens a
|
|
@@ -365,7 +290,6 @@ export type TRelayPresenceFrame = S.Schema.Type<typeof RelayPresenceFrame>;
|
|
|
365
290
|
// only OpenLLM-wire bytes do. The relay never decodes mux payloads. The
|
|
366
291
|
// legacy JSON `tunnel_*` / `session_*` splice frames have been removed.
|
|
367
292
|
// See `docs/features/sub-tunnel-and-chat-sessions.md`.
|
|
368
|
-
|
|
369
293
|
/**
|
|
370
294
|
* Max base64 length of a seed-gated device-grant envelope on open frames.
|
|
371
295
|
* Real envelopes are a few hundred bytes (JSON of nonce/ts/key_id/cid/aud +
|
|
@@ -376,17 +300,14 @@ export type TRelayPresenceFrame = S.Schema.Type<typeof RelayPresenceFrame>;
|
|
|
376
300
|
* the same value so decode stays aligned with Schema maxLength.
|
|
377
301
|
*/
|
|
378
302
|
export const DEVICE_GRANT_B64_MAX = 4 * 1024;
|
|
379
|
-
|
|
380
303
|
/**
|
|
381
304
|
* Internal hop marker: the serving daemon stamps this on every request it
|
|
382
305
|
* dispatches from a tunnel open so a fleet-peer walker can refuse to
|
|
383
306
|
* re-tunnel (loop guard). Not a client-facing API.
|
|
384
307
|
*/
|
|
385
308
|
export const TUNNELED_REQUEST_HEADER = "x-openllm-tunneled";
|
|
386
|
-
|
|
387
309
|
/** Response header naming the device key that served a tunneled request. */
|
|
388
310
|
export const SERVED_BY_DEVICE_HEADER = "x-openllm-served-by-device";
|
|
389
|
-
|
|
390
311
|
/**
|
|
391
312
|
* Request header pinning a follow-up to the device that served an earlier
|
|
392
313
|
* call (a video job lives on ONE device's vendor account; its id does not
|
|
@@ -396,89 +317,71 @@ export const SERVED_BY_DEVICE_HEADER = "x-openllm-served-by-device";
|
|
|
396
317
|
*/
|
|
397
318
|
export const TARGET_DEVICE_HEADER = "x-openllm-target-device";
|
|
398
319
|
export const TUNNELED_REQUEST_VALUE = "1";
|
|
399
|
-
|
|
400
320
|
// ─── Mux channels (consumer ⇄ relay ⇄ serving daemon) ─────────────────
|
|
401
|
-
|
|
402
321
|
/** consumer → relay → serving daemon. Auth runs once when opening this
|
|
403
322
|
* channel; after acceptance, all subsequent binary frames on both sockets
|
|
404
323
|
* belong to this channel. */
|
|
405
324
|
export const RelayChannelOpenFrame = S.Struct({
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
325
|
+
type: S.Literal("channel_open"),
|
|
326
|
+
channel_id: ChannelId,
|
|
327
|
+
key_id: S.String,
|
|
328
|
+
/**
|
|
329
|
+
* Who is opening the channel. The relay stamps this from the authenticated
|
|
330
|
+
* socket role before forward (`watcher` → `browser`, `daemon` → `daemon`) —
|
|
331
|
+
* clients may set it but the relay overwrites. `daemon` marks a fleet peer
|
|
332
|
+
* hop so the serving daemon skips seedgate (no vault DEK on the consumer).
|
|
333
|
+
* Omitted / `browser` is the default seed-gated path.
|
|
334
|
+
*/
|
|
335
|
+
consumer: S.optional(S.Literals(["browser", "daemon"])),
|
|
336
|
+
/**
|
|
337
|
+
* Seed-gated device grant (base64 envelope). Present when the serving
|
|
338
|
+
* daemon advertises `seedgate1`. Relay re-encodes via Schema — must be
|
|
339
|
+
* on the schema so it survives forward; never verified by the relay.
|
|
340
|
+
* Bounded so a peer cannot ship an arbitrarily large grant past re-encode.
|
|
341
|
+
*/
|
|
342
|
+
grant: S.optional(S.String.check(S.isMaxLength(DEVICE_GRANT_B64_MAX))),
|
|
343
|
+
/**
|
|
344
|
+
* Origin-signed team grant (base64 envelope). Required for cross-user
|
|
345
|
+
* admission: the relay admits when non-empty (it does NOT verify — the
|
|
346
|
+
* contributor daemon re-checks with its bootstrap `team_grant_key`).
|
|
347
|
+
* Same-user opens omit it. Opaque to the payload path; bounded like
|
|
348
|
+
* {@link DEVICE_GRANT_B64_MAX}.
|
|
349
|
+
*/
|
|
350
|
+
team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
|
|
351
|
+
/** Authenticated consumer user id. The relay replaces client input. */
|
|
352
|
+
peer_user_id: S.optional(S.String),
|
|
434
353
|
});
|
|
435
|
-
export type TRelayChannelOpenFrame = S.Schema.Type<
|
|
436
|
-
typeof RelayChannelOpenFrame
|
|
437
|
-
>;
|
|
438
|
-
|
|
439
354
|
/** Relay-to-daemon form of {@link RelayChannelOpenFrame}. The relay stamps
|
|
440
355
|
* `peer_user_id`; daemons never accept an unstamped open as same-user. */
|
|
441
356
|
export const RelayStampedChannelOpenFrame = S.Struct({
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
357
|
+
type: S.Literal("channel_open"),
|
|
358
|
+
channel_id: ChannelId,
|
|
359
|
+
key_id: S.String,
|
|
360
|
+
consumer: S.optional(S.Literals(["browser", "daemon"])),
|
|
361
|
+
grant: S.optional(S.String.check(S.isMaxLength(DEVICE_GRANT_B64_MAX))),
|
|
362
|
+
team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
|
|
363
|
+
peer_user_id: S.String,
|
|
449
364
|
});
|
|
450
|
-
export type TRelayStampedChannelOpenFrame = S.Schema.Type<
|
|
451
|
-
typeof RelayStampedChannelOpenFrame
|
|
452
|
-
>;
|
|
453
|
-
|
|
454
365
|
/** serving daemon → relay → consumer. The relay mints failure acknowledgements;
|
|
455
366
|
* an accepting daemon's acknowledgement is echoed verbatim. */
|
|
456
367
|
export const RelayChannelOpenAckFrame = S.Struct({
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
368
|
+
type: S.Literal("channel_open_ack"),
|
|
369
|
+
channel_id: ChannelId,
|
|
370
|
+
ok: S.Boolean,
|
|
371
|
+
/**
|
|
372
|
+
* Free-string on the wire so newer daemon failures remain decodable by
|
|
373
|
+
* older relay peers. Known values live in {@link ChannelOpenError}.
|
|
374
|
+
*/
|
|
375
|
+
error: S.optional(RelayFreeString),
|
|
465
376
|
});
|
|
466
|
-
export type TRelayChannelOpenAckFrame = S.Schema.Type<
|
|
467
|
-
typeof RelayChannelOpenAckFrame
|
|
468
|
-
>;
|
|
469
|
-
|
|
470
377
|
/** Either side / relay-minted. `relay_restart` is a drain signal: consumers
|
|
471
378
|
* reset in-flight streams and re-open the channel on the successor relay. */
|
|
472
379
|
export const RelayChannelCloseFrame = S.Struct({
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
380
|
+
type: S.Literal("channel_close"),
|
|
381
|
+
channel_id: ChannelId,
|
|
382
|
+
/** Free-string on the wire; known values live in ChannelCloseReason. */
|
|
383
|
+
reason: S.optional(RelayFreeString),
|
|
477
384
|
});
|
|
478
|
-
export type TRelayChannelCloseFrame = S.Schema.Type<
|
|
479
|
-
typeof RelayChannelCloseFrame
|
|
480
|
-
>;
|
|
481
|
-
|
|
482
385
|
// ─── WebRTC signaling (consumer ⇄ relay ⇄ serving daemon) ──────────────
|
|
483
386
|
//
|
|
484
387
|
// SDP + trickle ICE for a direct browser⇄daemon RTCDataChannel. The relay is
|
|
@@ -491,88 +394,68 @@ export type TRelayChannelCloseFrame = S.Schema.Type<
|
|
|
491
394
|
// `candidate` is a JSON string of an `RTCIceCandidateInit` (or the werift
|
|
492
395
|
// equivalent) so browser and daemon peers share one serialization without
|
|
493
396
|
// inventing a side-car candidate schema.
|
|
494
|
-
|
|
495
397
|
/**
|
|
496
398
|
* Soft upper bound for an SDP blob on the signaling plane. Real offers/
|
|
497
399
|
* answers are a few KB; 64 KiB leaves headroom while staying well under a
|
|
498
400
|
* typical WebSocket frame budget (~1 MiB on Cloudflare / PartySocket).
|
|
499
401
|
*/
|
|
500
402
|
export const RTC_SDP_MAX = 64 * 1024;
|
|
501
|
-
|
|
502
403
|
/**
|
|
503
404
|
* Soft upper bound for a base64 sealed fingerprint proof. Sealed-box
|
|
504
405
|
* ciphertext for the offer/answer inner is well under 2 KiB even with a
|
|
505
406
|
* nested device grant; 8 KiB is a conservative ceiling.
|
|
506
407
|
*/
|
|
507
408
|
export const RTC_FINGERPRINT_PROOF_B64_MAX = 8 * 1024;
|
|
508
|
-
|
|
509
409
|
/**
|
|
510
410
|
* Soft upper bound for a JSON-serialized `RTCIceCandidateInit`. A single
|
|
511
411
|
* candidate line + mid/mline fields is typically < 512 B; 4 KiB is generous.
|
|
512
412
|
*/
|
|
513
413
|
export const RTC_ICE_CANDIDATE_MAX = 4 * 1024;
|
|
514
|
-
|
|
515
414
|
/** consumer → relay → serving daemon. Open an RTC signaling session aimed at
|
|
516
415
|
* the daemon serving `key_id`. The consumer mints `channel_id` (uuid); the
|
|
517
416
|
* relay authorizes by registry membership and registers the pair so later
|
|
518
417
|
* `rtc_answer` / `rtc_ice` frames route by `channel_id`. */
|
|
519
418
|
export const RelayRtcOfferFrame = S.Struct({
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
/** Authenticated consumer kind. The relay replaces client input. */
|
|
532
|
-
consumer: S.optional(S.Literals(["browser", "daemon"])),
|
|
419
|
+
type: S.Literal("rtc_offer"),
|
|
420
|
+
channel_id: ChannelId,
|
|
421
|
+
key_id: S.String,
|
|
422
|
+
sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
|
|
423
|
+
fingerprint_proof: S.String.check(S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX)),
|
|
424
|
+
/** Opaque origin-signed grant required for cross-user RTC admission. */
|
|
425
|
+
team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
|
|
426
|
+
/** Authenticated consumer id. The relay replaces client input. */
|
|
427
|
+
peer_user_id: S.optional(S.String),
|
|
428
|
+
/** Authenticated consumer kind. The relay replaces client input. */
|
|
429
|
+
consumer: S.optional(S.Literals(["browser", "daemon"])),
|
|
533
430
|
});
|
|
534
|
-
export type TRelayRtcOfferFrame = S.Schema.Type<typeof RelayRtcOfferFrame>;
|
|
535
|
-
|
|
536
431
|
/** Relay-to-daemon form of {@link RelayRtcOfferFrame}. The relay stamps both
|
|
537
432
|
* identity fields; an unstamped offer is rejected as an outdated relay. */
|
|
538
433
|
export const RelayStampedRtcOfferFrame = S.Struct({
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
S.isMaxLength(
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
peer_user_id: S.String,
|
|
548
|
-
consumer: S.Literals(["browser", "daemon"]),
|
|
434
|
+
type: S.Literal("rtc_offer"),
|
|
435
|
+
channel_id: ChannelId,
|
|
436
|
+
key_id: S.String,
|
|
437
|
+
sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
|
|
438
|
+
fingerprint_proof: S.String.check(S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX)),
|
|
439
|
+
team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
|
|
440
|
+
peer_user_id: S.String,
|
|
441
|
+
consumer: S.Literals(["browser", "daemon"]),
|
|
549
442
|
});
|
|
550
|
-
export type TRelayStampedRtcOfferFrame = S.Schema.Type<
|
|
551
|
-
typeof RelayStampedRtcOfferFrame
|
|
552
|
-
>;
|
|
553
|
-
|
|
554
443
|
/** serving daemon → relay → consumer. Answer the offer for `channel_id`. */
|
|
555
444
|
export const RelayRtcAnswerFrame = S.Struct({
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX),
|
|
561
|
-
),
|
|
445
|
+
type: S.Literal("rtc_answer"),
|
|
446
|
+
channel_id: ChannelId,
|
|
447
|
+
sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
|
|
448
|
+
fingerprint_proof: S.String.check(S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX)),
|
|
562
449
|
});
|
|
563
|
-
export type TRelayRtcAnswerFrame = S.Schema.Type<typeof RelayRtcAnswerFrame>;
|
|
564
|
-
|
|
565
450
|
/** Both directions. One trickle ICE candidate for `channel_id`. `candidate` is
|
|
566
451
|
* a JSON-serialized `RTCIceCandidateInit` object (stringified by the sender,
|
|
567
452
|
* `JSON.parse`'d by the receiver) — preferred over a raw SDP candidate line
|
|
568
453
|
* for browser/werift field parity (`candidate`/`sdpMid`/`sdpMLineIndex`/…). */
|
|
569
454
|
export const RelayRtcIceFrame = S.Struct({
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
455
|
+
type: S.Literal("rtc_ice"),
|
|
456
|
+
channel_id: ChannelId,
|
|
457
|
+
candidate: S.String.check(S.isMaxLength(RTC_ICE_CANDIDATE_MAX)),
|
|
573
458
|
});
|
|
574
|
-
export type TRelayRtcIceFrame = S.Schema.Type<typeof RelayRtcIceFrame>;
|
|
575
|
-
|
|
576
459
|
/** Why a serving daemon refused an `rtc_offer`. `seedgate` = the vault DEK is
|
|
577
460
|
* locked (retry after unlock); `overloaded` = transient session cap (retry
|
|
578
461
|
* soon); `disabled` / `not_capable` / `handshake_failed` = daemon posture or
|
|
@@ -581,67 +464,55 @@ export type TRelayRtcIceFrame = S.Schema.Type<typeof RelayRtcIceFrame>;
|
|
|
581
464
|
* daemon X25519 key; consumers should refresh the cloud identity projection.
|
|
582
465
|
* `daemon_outdated` means a relay or daemon omitted a required current stamp. */
|
|
583
466
|
export const RtcNackReason = S.Literals([
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
467
|
+
"seedgate",
|
|
468
|
+
"overloaded",
|
|
469
|
+
"disabled",
|
|
470
|
+
"not_capable",
|
|
471
|
+
"handshake_failed",
|
|
472
|
+
"proof_open_failed",
|
|
473
|
+
"daemon_outdated",
|
|
591
474
|
]);
|
|
592
|
-
export type TRtcNackReason = S.Schema.Type<typeof RtcNackReason>;
|
|
593
|
-
|
|
594
475
|
/** Normalize a forward-compatible peer refusal to a generic retryable refusal. */
|
|
595
|
-
export const normalizeRtcNackReason = (reason
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
476
|
+
export const normalizeRtcNackReason = (reason) => {
|
|
477
|
+
switch (reason) {
|
|
478
|
+
case "seedgate":
|
|
479
|
+
case "overloaded":
|
|
480
|
+
case "disabled":
|
|
481
|
+
case "not_capable":
|
|
482
|
+
case "handshake_failed":
|
|
483
|
+
case "proof_open_failed":
|
|
484
|
+
case "daemon_outdated":
|
|
485
|
+
return reason;
|
|
486
|
+
default:
|
|
487
|
+
return "overloaded";
|
|
488
|
+
}
|
|
608
489
|
};
|
|
609
|
-
|
|
610
490
|
/** serving daemon or relay → consumer. Refuse the offer for `channel_id` —
|
|
611
491
|
* the explicit non-silent reject so the offerer fails fast instead of
|
|
612
492
|
* waiting out the signaling/ICE timeout. */
|
|
613
493
|
export const RelayRtcNackFrame = S.Struct({
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
494
|
+
type: S.Literal("rtc_nack"),
|
|
495
|
+
channel_id: ChannelId,
|
|
496
|
+
/**
|
|
497
|
+
* Free-string on the wire so a newer daemon refusal stays decodable. Known
|
|
498
|
+
* values live in {@link RtcNackReason}; unrecognized values are generic,
|
|
499
|
+
* non-cacheable refusals to consumers.
|
|
500
|
+
*/
|
|
501
|
+
reason: RelayFreeString,
|
|
622
502
|
});
|
|
623
|
-
export type TRelayRtcNackFrame = S.Schema.Type<typeof RelayRtcNackFrame>;
|
|
624
|
-
|
|
625
503
|
/** relay → every client. This box is superseded (a newer relay deploy is
|
|
626
504
|
* accepting): move to the box `/api/daemon/channel` now returns. The box
|
|
627
505
|
* admits no new work, finishes in-flight channels, then closes each socket
|
|
628
506
|
* with {@link RELAY_MOVED_CLOSE_CODE}. Old clients drop the unknown frame and
|
|
629
507
|
* move on that close. See `docs/plans/relay-handover.md`. */
|
|
630
508
|
export const RelayMovedFrame = S.Struct({ type: S.Literal("relay_moved") });
|
|
631
|
-
export type TRelayMovedFrame = S.Schema.Type<typeof RelayMovedFrame>;
|
|
632
|
-
|
|
633
509
|
/** Close code of a retired box's socket: reconnect immediately (no backoff).
|
|
634
510
|
* Distinct from 4000 `superseded`, so it never triggers daemon stand-down. */
|
|
635
511
|
export const RELAY_MOVED_CLOSE_CODE = 4010;
|
|
636
|
-
|
|
637
512
|
/** Keepalive (both directions). The relay pings below Cloudflare's
|
|
638
513
|
* proxied-WS idle bound; a missed pong is the relay's dead-peer signal. */
|
|
639
514
|
export const RelayPingFrame = S.Struct({ type: S.Literal("ping") });
|
|
640
|
-
export type TRelayPingFrame = S.Schema.Type<typeof RelayPingFrame>;
|
|
641
|
-
|
|
642
515
|
export const RelayPongFrame = S.Struct({ type: S.Literal("pong") });
|
|
643
|
-
export type TRelayPongFrame = S.Schema.Type<typeof RelayPongFrame>;
|
|
644
|
-
|
|
645
516
|
/**
|
|
646
517
|
* daemon → relay → watcher. Explicit subscription-auth FSM (`auth.ts`).
|
|
647
518
|
*
|
|
@@ -655,12 +526,10 @@ export type TRelayPongFrame = S.Schema.Type<typeof RelayPongFrame>;
|
|
|
655
526
|
* parse it even before they route it.
|
|
656
527
|
*/
|
|
657
528
|
export const RelayAuthFrame = S.Struct({
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
529
|
+
type: S.Literal("auth"),
|
|
530
|
+
key_id: S.String,
|
|
531
|
+
auth: AuthEvent,
|
|
661
532
|
});
|
|
662
|
-
export type TRelayAuthFrame = S.Schema.Type<typeof RelayAuthFrame>;
|
|
663
|
-
|
|
664
533
|
// NOTE: older daemon binaries also sent `received` (a per-command delivery
|
|
665
534
|
// receipt) and `resync` (a periodic "re-push my pending rows" floor). Both are
|
|
666
535
|
// retired — there is no durable mailbox to redeliver from anymore — so neither
|
|
@@ -668,7 +537,6 @@ export type TRelayAuthFrame = S.Schema.Type<typeof RelayAuthFrame>;
|
|
|
668
537
|
// fail decode and are silently dropped (`parseFrame` → null), the designed
|
|
669
538
|
// legacy tolerance. The same silent-drop applies to any unknown `type` (e.g. a
|
|
670
539
|
// future `rtc_*` peer talking to an older relay, or vice versa).
|
|
671
|
-
|
|
672
540
|
/** The full frame union, discriminated on `type`. `command_lifecycle` (relay →
|
|
673
541
|
* watcher) is the stateless-relay command receipt: the relay forwards the
|
|
674
542
|
* daemon's terminal `ack` to the originating watcher as a live lifecycle
|
|
@@ -677,26 +545,25 @@ export type TRelayAuthFrame = S.Schema.Type<typeof RelayAuthFrame>;
|
|
|
677
545
|
* `docs/proposals/daemon-owned-state-stateless-relay.md`. `auth` (daemon →
|
|
678
546
|
* relay → watcher) is the subscription-login FSM; it is not a CommandState. */
|
|
679
547
|
export const RelayFrame = S.Union([
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
548
|
+
RelayHelloFrame,
|
|
549
|
+
RelayWelcomeFrame,
|
|
550
|
+
RelayCommandFrame,
|
|
551
|
+
RelayAckFrame,
|
|
552
|
+
RelayStatusFrame,
|
|
553
|
+
RelayEnqueueFrame,
|
|
554
|
+
RelayEnqueueAckFrame,
|
|
555
|
+
RelayStatusPushFrame,
|
|
556
|
+
RelayPresenceFrame,
|
|
557
|
+
RelayCommandLifecycleFrame,
|
|
558
|
+
RelayAuthFrame,
|
|
559
|
+
RelayChannelOpenFrame,
|
|
560
|
+
RelayChannelOpenAckFrame,
|
|
561
|
+
RelayChannelCloseFrame,
|
|
562
|
+
RelayRtcOfferFrame,
|
|
563
|
+
RelayRtcAnswerFrame,
|
|
564
|
+
RelayRtcIceFrame,
|
|
565
|
+
RelayRtcNackFrame,
|
|
566
|
+
RelayMovedFrame,
|
|
567
|
+
RelayPingFrame,
|
|
568
|
+
RelayPongFrame,
|
|
701
569
|
]);
|
|
702
|
-
export type TRelayFrame = S.Schema.Type<typeof RelayFrame>;
|