@openllmsh/sdk 2.10.12-alpha.1 → 2.10.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -7
- package/dist/client/chat.d.ts +38 -0
- package/dist/client/chat.js +77 -0
- package/dist/client/devices.d.ts +70 -0
- package/dist/client/devices.js +172 -0
- package/dist/client/http.d.ts +24 -0
- package/dist/client/http.js +34 -0
- package/dist/client/index.d.ts +43 -0
- package/dist/client/index.js +57 -0
- package/dist/client/relay-mux.d.ts +71 -0
- package/dist/client/relay-mux.js +394 -0
- package/dist/client/types.d.ts +47 -0
- package/dist/client/types.js +5 -0
- package/dist/client/vault.d.ts +68 -0
- package/dist/client/vault.js +113 -0
- package/dist/connect/chat.d.ts +24 -0
- package/dist/connect/chat.js +25 -0
- package/dist/connect/client.d.ts +50 -0
- package/dist/connect/client.js +141 -0
- package/dist/connect/config.d.ts +22 -0
- package/dist/connect/config.js +22 -0
- package/dist/connect/errors.d.ts +32 -0
- package/dist/connect/errors.js +85 -0
- package/{connect/index.ts → dist/connect/index.d.ts} +7 -7
- package/dist/connect/index.js +23 -0
- package/dist/connect/oauth.d.ts +51 -0
- package/dist/connect/oauth.js +150 -0
- package/dist/connect/routes.d.ts +38 -0
- package/dist/connect/routes.js +175 -0
- package/dist/connect/store.d.ts +26 -0
- package/dist/connect/store.js +65 -0
- package/dist/mcp/handle.d.ts +6 -0
- package/dist/mcp/handle.js +6 -0
- package/dist/mcp/index.d.ts +15 -0
- package/dist/mcp/index.js +10 -0
- package/dist/mcp/server.d.ts +84 -0
- package/dist/mcp/server.js +168 -0
- package/dist/mcp/tools/marketplace.d.ts +94 -0
- package/dist/mcp/tools/marketplace.js +303 -0
- package/dist/mcp/tools/memory-client.d.ts +109 -0
- package/dist/mcp/tools/memory-client.js +200 -0
- package/dist/mcp/tools/memory-config.d.ts +29 -0
- package/dist/mcp/tools/memory-config.js +12 -0
- package/dist/mcp/tools/memory.d.ts +92 -0
- package/dist/mcp/tools/memory.js +312 -0
- package/dist/mcp/tools/model-priority.d.ts +16 -0
- package/dist/mcp/tools/model-priority.js +87 -0
- package/dist/mcp/tools/openllm.d.ts +75 -0
- package/dist/mcp/tools/openllm.js +715 -0
- package/dist/mcp/types.d.ts +25 -0
- package/dist/mcp/types.js +7 -0
- package/dist/openapi/call.d.ts +26 -0
- package/dist/openapi/call.js +56 -0
- package/dist/openapi/index.d.ts +2 -0
- package/dist/openapi/index.js +2 -0
- package/dist/openapi/openapi.json +80213 -0
- package/dist/openapi/operations.d.ts +14 -0
- package/dist/openapi/operations.js +2060 -0
- package/dist/protocol/access.d.ts +81 -0
- package/dist/protocol/access.js +125 -0
- package/dist/protocol/agent-prompt-text.d.ts +15 -0
- package/{protocol/agent-prompt-text.ts → dist/protocol/agent-prompt-text.js} +9 -14
- package/dist/protocol/agent.d.ts +1487 -0
- package/dist/protocol/agent.js +787 -0
- package/dist/protocol/api-key-syntax.d.ts +58 -0
- package/dist/protocol/api-key-syntax.js +73 -0
- package/dist/protocol/audio.d.ts +18 -0
- package/dist/protocol/audio.js +21 -0
- package/dist/protocol/auth.d.ts +126 -0
- package/dist/protocol/auth.js +119 -0
- package/dist/protocol/changelog.d.ts +69 -0
- package/dist/protocol/changelog.js +107 -0
- package/dist/protocol/chat.d.ts +789 -0
- package/dist/protocol/chat.js +394 -0
- package/dist/protocol/client-registry.d.ts +151 -0
- package/dist/protocol/client-registry.js +238 -0
- package/dist/protocol/config.d.ts +508 -0
- package/dist/protocol/config.js +289 -0
- package/dist/protocol/control-channel.d.ts +102 -0
- package/{protocol/control-channel.ts → dist/protocol/control-channel.js} +33 -61
- package/dist/protocol/cooldown-reason.d.ts +30 -0
- package/dist/protocol/cooldown-reason.js +44 -0
- package/dist/protocol/cost.d.ts +9 -0
- package/dist/protocol/cost.js +8 -0
- package/dist/protocol/daemon-port.d.ts +2 -0
- package/dist/protocol/daemon-port.js +28 -0
- package/dist/protocol/daemon.d.ts +2034 -0
- package/dist/protocol/daemon.js +1286 -0
- package/dist/protocol/default-chains.d.ts +15 -0
- package/dist/protocol/default-chains.js +21 -0
- package/dist/protocol/device-state.d.ts +223 -0
- package/dist/protocol/device-state.js +52 -0
- package/dist/protocol/doctor-report-local.d.ts +105 -0
- package/{protocol/doctor-report-local.ts → dist/protocol/doctor-report-local.js} +92 -196
- package/dist/protocol/doctor-report-policy.d.ts +62 -0
- package/{protocol/doctor-report-policy.ts → dist/protocol/doctor-report-policy.js} +23 -76
- package/dist/protocol/doctor-report.d.ts +406 -0
- package/dist/protocol/doctor-report.js +645 -0
- package/dist/protocol/errors.d.ts +17 -0
- package/dist/protocol/errors.js +10 -0
- package/dist/protocol/execution-selection.d.ts +92 -0
- package/{protocol/execution-selection.ts → dist/protocol/execution-selection.js} +38 -63
- package/dist/protocol/hop-grant.d.ts +28 -0
- package/{protocol/hop-grant.ts → dist/protocol/hop-grant.js} +7 -13
- package/dist/protocol/image-edit-parse.d.ts +25 -0
- package/dist/protocol/image-edit-parse.js +196 -0
- package/dist/protocol/images.d.ts +288 -0
- package/dist/protocol/images.js +229 -0
- package/dist/protocol/index.d.ts +69 -0
- package/dist/protocol/index.js +74 -0
- package/dist/protocol/inference-headers.d.ts +3 -0
- package/dist/protocol/keepalive.d.ts +36 -0
- package/dist/protocol/keepalive.js +51 -0
- package/dist/protocol/local-auth.d.ts +125 -0
- package/dist/protocol/local-auth.js +227 -0
- package/dist/protocol/local-device-control.d.ts +108 -0
- package/{protocol/local-device-control.ts → dist/protocol/local-device-control.js} +40 -70
- package/dist/protocol/local-provider.d.ts +105 -0
- package/dist/protocol/local-provider.js +213 -0
- package/dist/protocol/local-session.d.ts +70 -0
- package/dist/protocol/local-session.js +87 -0
- package/dist/protocol/marketplace.d.ts +190 -0
- package/dist/protocol/marketplace.js +140 -0
- package/{protocol/media-attempt.ts → dist/protocol/media-attempt.d.ts} +11 -50
- package/dist/protocol/media-attempt.js +50 -0
- package/dist/protocol/media-bytes.d.ts +8 -0
- package/dist/protocol/media-bytes.js +21 -0
- package/dist/protocol/media-default.d.ts +56 -0
- package/dist/protocol/media-default.js +302 -0
- package/{protocol/media-dimensions.ts → dist/protocol/media-dimensions.d.ts} +11 -78
- package/dist/protocol/media-dimensions.js +90 -0
- package/dist/protocol/media-input.d.ts +20 -0
- package/dist/protocol/media-input.js +29 -0
- package/dist/protocol/media-model.d.ts +77 -0
- package/dist/protocol/media-model.js +89 -0
- package/{protocol/media-option-issue.ts → dist/protocol/media-option-issue.d.ts} +25 -53
- package/dist/protocol/media-option-issue.js +50 -0
- package/dist/protocol/media-types.d.ts +14 -0
- package/dist/protocol/media-types.js +61 -0
- package/dist/protocol/model-match.d.ts +254 -0
- package/dist/protocol/model-match.js +760 -0
- package/dist/protocol/model-settings.d.ts +153 -0
- package/dist/protocol/model-settings.js +246 -0
- package/dist/protocol/models.d.ts +1065 -0
- package/dist/protocol/models.js +638 -0
- package/dist/protocol/mux.d.ts +350 -0
- package/dist/protocol/mux.js +595 -0
- package/{protocol/plan-surface.ts → dist/protocol/plan-surface.d.ts} +12 -26
- package/dist/protocol/plan-surface.js +39 -0
- package/dist/protocol/provider-models.d.ts +8 -0
- package/{protocol/provider-models.ts → dist/protocol/provider-models.js} +7 -9
- package/dist/protocol/provider-status.d.ts +59 -0
- package/dist/protocol/provider-status.js +142 -0
- package/dist/protocol/provider-tier.d.ts +34 -0
- package/{protocol/provider-tier.ts → dist/protocol/provider-tier.js} +9 -34
- package/dist/protocol/provider-usage.d.ts +230 -0
- package/dist/protocol/provider-usage.js +214 -0
- package/dist/protocol/providers.d.ts +2496 -0
- package/dist/protocol/providers.js +723 -0
- package/dist/protocol/public-usage-index.d.ts +449 -0
- package/dist/protocol/public-usage-index.js +279 -0
- package/dist/protocol/realtime-generated.d.ts +29 -0
- package/{protocol/realtime-generated.ts → dist/protocol/realtime-generated.js} +3 -5
- package/dist/protocol/realtime.d.ts +241 -0
- package/{protocol/realtime.ts → dist/protocol/realtime.js} +88 -155
- package/dist/protocol/registry-pointer.d.ts +24 -0
- package/dist/protocol/registry-pointer.js +78 -0
- package/dist/protocol/relay.d.ts +1152 -0
- package/{protocol/relay.ts → dist/protocol/relay.js} +237 -370
- package/dist/protocol/replay-session.d.ts +4 -0
- package/{protocol/replay-session.ts → dist/protocol/replay-session.js} +1 -8
- package/dist/protocol/responses.d.ts +303 -0
- package/dist/protocol/responses.js +240 -0
- package/dist/protocol/semver.d.ts +59 -0
- package/dist/protocol/semver.js +171 -0
- package/{protocol/setup-mode.ts → dist/protocol/setup-mode.d.ts} +4 -12
- package/dist/protocol/setup-mode.js +18 -0
- package/dist/protocol/sha256-hex.d.ts +2 -0
- package/dist/protocol/sha256-hex.js +93 -0
- package/dist/protocol/stats.d.ts +711 -0
- package/dist/protocol/stats.js +353 -0
- package/dist/protocol/streaming.d.ts +16 -0
- package/dist/protocol/streaming.js +15 -0
- package/{protocol/subscription-daemon-floors.ts → dist/protocol/subscription-daemon-floors.d.ts} +8 -14
- package/dist/protocol/subscription-daemon-floors.js +4 -0
- package/dist/protocol/subscription-provider-compat.d.ts +44 -0
- package/dist/protocol/subscription-provider-compat.js +67 -0
- package/dist/protocol/subscription-provider.d.ts +15 -0
- package/dist/protocol/subscription-provider.js +17 -0
- package/dist/protocol/team-grant.d.ts +14 -0
- package/{protocol/team-grant.ts → dist/protocol/team-grant.js} +0 -3
- package/dist/protocol/team-shareable.d.ts +6 -0
- package/{protocol/team-shareable.ts → dist/protocol/team-shareable.js} +29 -33
- package/dist/protocol/transcription-encoding.d.ts +25 -0
- package/dist/protocol/transcription-encoding.js +47 -0
- package/{protocol/url-locality-dns.ts → dist/protocol/url-locality-dns.d.ts} +1 -23
- package/dist/protocol/url-locality-dns.js +33 -0
- package/dist/protocol/url-locality.d.ts +45 -0
- package/dist/protocol/url-locality.js +288 -0
- package/dist/protocol/usage-snapshots.d.ts +8 -0
- package/{protocol/usage-snapshots.ts → dist/protocol/usage-snapshots.js} +1 -2
- package/dist/protocol/vendor-cli-install.d.ts +20 -0
- package/{protocol/vendor-cli-install.ts → dist/protocol/vendor-cli-install.js} +10 -15
- package/dist/protocol/video-job-plan.d.ts +18 -0
- package/dist/protocol/video-job-plan.js +44 -0
- package/dist/protocol/videos.d.ts +107 -0
- package/dist/protocol/videos.js +154 -0
- package/dist/tunnel/channel-envelope.d.ts +53 -0
- package/dist/tunnel/channel-envelope.js +100 -0
- package/dist/tunnel/codec.d.ts +71 -0
- package/dist/tunnel/codec.js +151 -0
- package/dist/tunnel/device-anchor.d.ts +62 -0
- package/dist/tunnel/device-anchor.js +168 -0
- package/dist/tunnel/device-control.d.ts +50 -0
- package/dist/tunnel/device-control.js +88 -0
- package/dist/tunnel/device-grant.d.ts +91 -0
- package/dist/tunnel/device-grant.js +105 -0
- package/dist/tunnel/fleet.d.ts +28 -0
- package/dist/tunnel/fleet.js +41 -0
- package/dist/tunnel/index.d.ts +22 -0
- package/dist/tunnel/index.js +22 -0
- package/dist/tunnel/mux.d.ts +64 -0
- package/dist/tunnel/mux.js +449 -0
- package/dist/tunnel/peer-link.d.ts +88 -0
- package/dist/tunnel/peer-link.js +271 -0
- package/dist/tunnel/rtc-auth.d.ts +159 -0
- package/dist/tunnel/rtc-auth.js +340 -0
- package/dist/tunnel/rtc-duplex.d.ts +52 -0
- package/dist/tunnel/rtc-duplex.js +148 -0
- package/dist/tunnel/rtc-ice.d.ts +55 -0
- package/dist/tunnel/rtc-ice.js +100 -0
- package/dist/tunnel/secure.d.ts +179 -0
- package/dist/tunnel/secure.js +936 -0
- package/dist/tunnel/stream-reset-error.d.ts +6 -0
- package/dist/tunnel/stream-reset-error.js +9 -0
- package/dist/tunnel/streams.d.ts +244 -0
- package/dist/tunnel/streams.js +1071 -0
- package/dist/tunnel/team-grant.d.ts +90 -0
- package/dist/tunnel/team-grant.js +226 -0
- package/dist/tunnel/wire-bytes.d.ts +32 -0
- package/dist/tunnel/wire-bytes.js +90 -0
- package/dist/vault/api-key.d.ts +71 -0
- package/dist/vault/api-key.js +130 -0
- package/{vault/argon2.ts → dist/vault/argon2.d.ts} +18 -53
- package/dist/vault/argon2.js +82 -0
- package/dist/vault/cli-auth-seal.d.ts +35 -0
- package/dist/vault/cli-auth-seal.js +78 -0
- package/dist/vault/cred-seal.d.ts +18 -0
- package/dist/vault/cred-seal.js +86 -0
- package/dist/vault/credential.d.ts +21 -0
- package/dist/vault/credential.js +26 -0
- package/dist/vault/crypto.d.ts +51 -0
- package/dist/vault/crypto.js +156 -0
- package/dist/vault/daemon-attest.d.ts +68 -0
- package/dist/vault/daemon-attest.js +147 -0
- package/dist/vault/derive.d.ts +34 -0
- package/dist/vault/derive.js +84 -0
- package/dist/vault/device-access.d.ts +17 -0
- package/dist/vault/device-access.js +77 -0
- package/dist/vault/device-anchor.d.ts +42 -0
- package/dist/vault/device-anchor.js +90 -0
- package/dist/vault/device-control.d.ts +80 -0
- package/{vault/device-control.ts → dist/vault/device-control.js} +46 -104
- package/dist/vault/handoff.d.ts +102 -0
- package/dist/vault/handoff.js +236 -0
- package/dist/vault/index.d.ts +21 -0
- package/dist/vault/index.js +21 -0
- package/dist/vault/passkey.d.ts +82 -0
- package/{vault/passkey.ts → dist/vault/passkey.js} +63 -153
- package/dist/vault/phrase.d.ts +40 -0
- package/{vault/phrase.ts → dist/vault/phrase.js} +17 -23
- package/dist/vault/pin.d.ts +46 -0
- package/dist/vault/pin.js +92 -0
- package/dist/vault/public-key-seal.d.ts +17 -0
- package/dist/vault/public-key-seal.js +59 -0
- package/dist/vault/seed.d.ts +96 -0
- package/dist/vault/seed.js +179 -0
- package/dist/vault/team.d.ts +134 -0
- package/dist/vault/team.js +217 -0
- package/dist/vault/vault-item.d.ts +45 -0
- package/dist/vault/vault-item.js +62 -0
- package/dist/vault/vault-migrate-digest.d.ts +10 -0
- package/dist/vault/vault-migrate-digest.js +22 -0
- package/dist/vault/wrapped.d.ts +19 -0
- package/dist/vault/wrapped.js +52 -0
- package/dist/wire/adapters/messages/anthropic-map.d.ts +8 -0
- package/dist/wire/adapters/messages/anthropic-map.js +32 -0
- package/dist/wire/adapters/messages/index.d.ts +7 -0
- package/dist/wire/adapters/messages/index.js +7 -0
- package/dist/wire/adapters/messages/reasoning-from-items.d.ts +14 -0
- package/dist/wire/adapters/messages/reasoning-from-items.js +39 -0
- package/dist/wire/adapters/messages/reasoning-signature.d.ts +81 -0
- package/dist/wire/adapters/messages/reasoning-signature.js +180 -0
- package/dist/wire/adapters/messages/request.d.ts +28 -0
- package/dist/wire/adapters/messages/request.js +490 -0
- package/dist/wire/adapters/messages/response.d.ts +10 -0
- package/dist/wire/adapters/messages/response.js +177 -0
- package/dist/wire/adapters/messages/streaming.d.ts +134 -0
- package/dist/wire/adapters/messages/streaming.js +791 -0
- package/dist/wire/adapters/messages/usage.d.ts +20 -0
- package/dist/wire/adapters/messages/usage.js +10 -0
- package/dist/wire/adapters/responses/index.d.ts +3 -0
- package/dist/wire/adapters/responses/index.js +3 -0
- package/dist/wire/adapters/responses/request.d.ts +2 -0
- package/dist/wire/adapters/responses/request.js +287 -0
- package/dist/wire/adapters/responses/response.d.ts +11 -0
- package/dist/wire/adapters/responses/response.js +69 -0
- package/dist/wire/adapters/responses/streaming.d.ts +2 -0
- package/dist/wire/adapters/responses/streaming.js +267 -0
- package/dist/wire/features/account-rank.d.ts +61 -0
- package/dist/wire/features/account-rank.js +109 -0
- package/dist/wire/features/compaction/compact-request.d.ts +69 -0
- package/dist/wire/features/compaction/compact-request.js +667 -0
- package/dist/wire/features/compaction/compaction-text.d.ts +17 -0
- package/dist/wire/features/compaction/compaction-text.js +29 -0
- package/dist/wire/features/context-demote.d.ts +15 -0
- package/dist/wire/features/context-demote.js +45 -0
- package/dist/wire/features/context-overflow-strategy.d.ts +12 -0
- package/dist/wire/features/context-overflow-strategy.js +8 -0
- package/dist/wire/features/context-skip.d.ts +120 -0
- package/{wire/features/context-skip.ts → dist/wire/features/context-skip.js} +23 -57
- package/dist/wire/features/conversation-affinity.d.ts +49 -0
- package/dist/wire/features/conversation-affinity.js +121 -0
- package/dist/wire/features/max-tokens-backfill.d.ts +50 -0
- package/dist/wire/features/max-tokens-backfill.js +118 -0
- package/dist/wire/features/model-caps.d.ts +7 -0
- package/dist/wire/features/model-caps.js +40 -0
- package/dist/wire/features/model-settings.d.ts +3 -0
- package/dist/wire/features/model-settings.js +13 -0
- package/dist/wire/features/output-limit-clamp.d.ts +14 -0
- package/dist/wire/features/output-limit-clamp.js +36 -0
- package/dist/wire/features/quota-gate.d.ts +16 -0
- package/dist/wire/features/quota-gate.js +48 -0
- package/dist/wire/index.d.ts +44 -0
- package/dist/wire/index.js +44 -0
- package/dist/wire/lib/attempt-outcome.d.ts +19 -0
- package/dist/wire/lib/attempt-outcome.js +18 -0
- package/{wire/lib/canonical/content-part.ts → dist/wire/lib/canonical/content-part.d.ts} +12 -18
- package/dist/wire/lib/canonical/content-part.js +11 -0
- package/dist/wire/lib/canonical/count-tokens-capability.d.ts +52 -0
- package/dist/wire/lib/canonical/count-tokens-capability.js +109 -0
- package/{wire/lib/canonical/encoding-select.ts → dist/wire/lib/canonical/encoding-select.d.ts} +7 -24
- package/dist/wire/lib/canonical/encoding-select.js +26 -0
- package/dist/wire/lib/canonical/image-signature.d.ts +20 -0
- package/dist/wire/lib/canonical/image-signature.js +184 -0
- package/dist/wire/lib/canonical/image-sse.d.ts +88 -0
- package/dist/wire/lib/canonical/image-sse.js +173 -0
- package/{wire/lib/canonical/message.ts → dist/wire/lib/canonical/message.d.ts} +2 -20
- package/dist/wire/lib/canonical/message.js +31 -0
- package/dist/wire/lib/canonical/token-estimate.d.ts +98 -0
- package/dist/wire/lib/canonical/token-estimate.js +230 -0
- package/dist/wire/lib/encrypted-content.d.ts +22 -0
- package/dist/wire/lib/encrypted-content.js +55 -0
- package/dist/wire/lib/error-class.d.ts +57 -0
- package/dist/wire/lib/error-class.js +97 -0
- package/dist/wire/lib/error-envelope.d.ts +20 -0
- package/dist/wire/lib/error-envelope.js +53 -0
- package/dist/wire/lib/forwarded-headers.d.ts +16 -0
- package/{wire/lib/forwarded-headers.ts → dist/wire/lib/forwarded-headers.js} +62 -72
- package/dist/wire/lib/provider-error-rules.d.ts +21 -0
- package/dist/wire/lib/provider-error-rules.js +20 -0
- package/{wire/lib/refusal.ts → dist/wire/lib/refusal.d.ts} +3 -13
- package/dist/wire/lib/refusal.js +27 -0
- package/dist/wire/lib/responses-apply-patch.d.ts +57 -0
- package/dist/wire/lib/responses-apply-patch.js +81 -0
- package/dist/wire/lib/responses-namespace.d.ts +27 -0
- package/{wire/lib/responses-namespace.ts → dist/wire/lib/responses-namespace.js} +16 -32
- package/dist/wire/lib/secret-scrub.d.ts +23 -0
- package/dist/wire/lib/secret-scrub.js +72 -0
- package/dist/wire/lib/streaming/accumulate.d.ts +12 -0
- package/dist/wire/lib/streaming/accumulate.js +187 -0
- package/dist/wire/lib/streaming/finish-reason.d.ts +20 -0
- package/dist/wire/lib/streaming/finish-reason.js +15 -0
- package/{wire/lib/streaming/peek.ts → dist/wire/lib/streaming/peek.d.ts} +13 -82
- package/dist/wire/lib/streaming/peek.js +100 -0
- package/dist/wire/lib/streaming/provider-decode.d.ts +57 -0
- package/dist/wire/lib/streaming/provider-decode.js +210 -0
- package/dist/wire/lib/streaming/response-stream.d.ts +16 -0
- package/dist/wire/lib/streaming/response-stream.js +64 -0
- package/dist/wire/lib/streaming/sse.d.ts +130 -0
- package/dist/wire/lib/streaming/sse.js +600 -0
- package/dist/wire/lib/streaming/strip-tool-calls.d.ts +14 -0
- package/dist/wire/lib/streaming/strip-tool-calls.js +75 -0
- package/dist/wire/lib/streaming/upstream-error.d.ts +32 -0
- package/dist/wire/lib/streaming/upstream-error.js +45 -0
- package/dist/wire/lib/strip-subagent-isolation.d.ts +16 -0
- package/dist/wire/lib/strip-subagent-isolation.js +240 -0
- package/dist/wire/lib/thinking-signature.d.ts +56 -0
- package/{wire/lib/thinking-signature.ts → dist/wire/lib/thinking-signature.js} +77 -84
- package/dist/wire/lib/token-ruler/bpe-core.d.ts +105 -0
- package/dist/wire/lib/token-ruler/bpe-core.js +398 -0
- package/dist/wire/lib/token-ruler/index.d.ts +2 -0
- package/dist/wire/lib/token-ruler/index.js +2 -0
- package/dist/wire/lib/token-ruler/ruler.d.ts +36 -0
- package/dist/wire/lib/token-ruler/ruler.js +50 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.d.ts +14 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.js +16 -0
- package/{wire/lib/token-ruler/vocab/claude.ts → dist/wire/lib/token-ruler/vocab/claude.d.ts} +2 -12
- package/dist/wire/lib/token-ruler/vocab/claude.js +8 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.d.ts +3 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.js +18 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.d.ts +11 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.js +6 -0
- package/dist/wire/lib/tool-name-map.d.ts +44 -0
- package/dist/wire/lib/tool-name-map.js +186 -0
- package/dist/wire/lib/tool-schema.d.ts +15 -0
- package/dist/wire/lib/tool-schema.js +307 -0
- package/dist/wire/lib/usage-observer.d.ts +9 -0
- package/dist/wire/lib/usage-observer.js +108 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.d.ts +125 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.js +221 -0
- package/dist/wire/providers/anthropic/beta-headers.d.ts +44 -0
- package/{wire/providers/anthropic/beta-headers.ts → dist/wire/providers/anthropic/beta-headers.js} +57 -79
- package/dist/wire/providers/anthropic/index.d.ts +6 -0
- package/{wire/providers/anthropic/index.ts → dist/wire/providers/anthropic/index.js} +6 -6
- package/dist/wire/providers/anthropic/request.d.ts +12 -0
- package/dist/wire/providers/anthropic/request.js +456 -0
- package/dist/wire/providers/anthropic/response.d.ts +3 -0
- package/dist/wire/providers/anthropic/response.js +126 -0
- package/dist/wire/providers/anthropic/streaming.d.ts +28 -0
- package/dist/wire/providers/anthropic/streaming.js +268 -0
- package/dist/wire/providers/anthropic/web-search-domains.d.ts +7 -0
- package/dist/wire/providers/anthropic/web-search-domains.js +36 -0
- package/dist/wire/providers/chatgpt/common.d.ts +27 -0
- package/{wire/providers/chatgpt/common.ts → dist/wire/providers/chatgpt/common.js} +69 -89
- package/dist/wire/providers/chatgpt/index.d.ts +4 -0
- package/{wire/providers/chatgpt/index.ts → dist/wire/providers/chatgpt/index.js} +4 -4
- package/dist/wire/providers/chatgpt/request.d.ts +132 -0
- package/dist/wire/providers/chatgpt/request.js +696 -0
- package/dist/wire/providers/chatgpt/streaming.d.ts +69 -0
- package/dist/wire/providers/chatgpt/streaming.js +761 -0
- package/dist/wire/providers/chatgpt/web-search.d.ts +19 -0
- package/dist/wire/providers/chatgpt/web-search.js +55 -0
- package/dist/wire/providers/grok/web-search.d.ts +23 -0
- package/dist/wire/providers/grok/web-search.js +74 -0
- package/dist/wire/providers/kimi/web-search.d.ts +48 -0
- package/dist/wire/providers/kimi/web-search.js +106 -0
- package/dist/wire/providers/upstream-deny.d.ts +61 -0
- package/dist/wire/providers/upstream-deny.js +293 -0
- package/dist/wire/providers/upstream-request.d.ts +104 -0
- package/dist/wire/providers/upstream-request.js +411 -0
- package/package.json +105 -23
- package/ARCHITECTURE.md +0 -43
- package/client/chat.ts +0 -140
- package/client/devices.ts +0 -269
- package/client/http.ts +0 -72
- package/client/index.ts +0 -129
- package/client/relay-mux.ts +0 -547
- package/client/types.ts +0 -51
- package/client/vault.ts +0 -239
- package/connect/chat.ts +0 -58
- package/connect/client.ts +0 -240
- package/connect/config.ts +0 -47
- package/connect/errors.ts +0 -121
- package/connect/oauth.ts +0 -265
- package/connect/routes.ts +0 -234
- package/connect/store.ts +0 -107
- package/mcp/handle.ts +0 -24
- package/mcp/index.ts +0 -76
- package/mcp/server.ts +0 -319
- package/mcp/tools/marketplace.ts +0 -439
- package/mcp/tools/memory-client.ts +0 -297
- package/mcp/tools/memory-config.ts +0 -32
- package/mcp/tools/memory.ts +0 -369
- package/mcp/tools/model-priority.ts +0 -88
- package/mcp/tools/openllm.ts +0 -883
- package/mcp/types.ts +0 -28
- package/openapi/call.ts +0 -90
- package/openapi/index.ts +0 -8
- package/openapi/openapi.json +0 -80213
- package/openapi/operations.ts +0 -2075
- package/protocol/CONTRIBUTING.md +0 -21
- package/protocol/README.md +0 -134
- package/protocol/access.ts +0 -186
- package/protocol/agent.ts +0 -991
- package/protocol/api-key-syntax.ts +0 -105
- package/protocol/assets/openllm-light.svg +0 -18
- package/protocol/assets/openllm.svg +0 -18
- package/protocol/audio.ts +0 -29
- package/protocol/auth.ts +0 -142
- package/protocol/changelog.ts +0 -155
- package/protocol/chat.ts +0 -458
- package/protocol/client-registry.ts +0 -356
- package/protocol/config.ts +0 -345
- package/protocol/cooldown-reason.ts +0 -78
- package/protocol/cost.ts +0 -10
- package/protocol/daemon-port.ts +0 -31
- package/protocol/daemon.ts +0 -1524
- package/protocol/default-chains.ts +0 -66
- package/protocol/device-state.ts +0 -85
- package/protocol/doctor-report.ts +0 -947
- package/protocol/errors.ts +0 -14
- package/protocol/image-edit-parse.ts +0 -263
- package/protocol/images.ts +0 -298
- package/protocol/index.ts +0 -74
- package/protocol/keepalive.ts +0 -69
- package/protocol/local-auth.ts +0 -300
- package/protocol/local-provider.ts +0 -288
- package/protocol/local-session.ts +0 -118
- package/protocol/marketplace.ts +0 -187
- package/protocol/media-bytes.ts +0 -28
- package/protocol/media-default.ts +0 -357
- package/protocol/media-input.ts +0 -61
- package/protocol/media-model.ts +0 -142
- package/protocol/media-types.ts +0 -70
- package/protocol/model-match.ts +0 -1051
- package/protocol/model-settings.ts +0 -327
- package/protocol/models.ts +0 -767
- package/protocol/mux.ts +0 -722
- package/protocol/provider-status.ts +0 -206
- package/protocol/provider-usage.ts +0 -263
- package/protocol/providers.ts +0 -901
- package/protocol/public-usage-index.ts +0 -354
- package/protocol/registry-pointer.ts +0 -118
- package/protocol/responses.ts +0 -280
- package/protocol/semver.ts +0 -182
- package/protocol/sha256-hex.ts +0 -98
- package/protocol/stats.ts +0 -406
- package/protocol/streaming.ts +0 -19
- package/protocol/subscription-provider-compat.ts +0 -104
- package/protocol/subscription-provider.ts +0 -32
- package/protocol/transcription-encoding.ts +0 -76
- package/protocol/url-locality.ts +0 -288
- package/protocol/video-job-plan.ts +0 -50
- package/protocol/videos.ts +0 -227
- package/tsconfig.json +0 -14
- package/tunnel/ARCHITECTURE.md +0 -111
- package/tunnel/assets/openllm-light.svg +0 -18
- package/tunnel/assets/openllm.svg +0 -18
- package/tunnel/channel-envelope.ts +0 -139
- package/tunnel/codec.ts +0 -191
- package/tunnel/device-anchor.ts +0 -229
- package/tunnel/device-control.ts +0 -118
- package/tunnel/device-grant.ts +0 -173
- package/tunnel/fleet.ts +0 -77
- package/tunnel/index.ts +0 -22
- package/tunnel/mux.ts +0 -580
- package/tunnel/peer-link.ts +0 -390
- package/tunnel/rtc-auth.ts +0 -415
- package/tunnel/rtc-duplex.ts +0 -187
- package/tunnel/rtc-ice.ts +0 -136
- package/tunnel/secure.ts +0 -1298
- package/tunnel/stream-reset-error.ts +0 -14
- package/tunnel/streams.ts +0 -1430
- package/tunnel/team-grant.ts +0 -302
- package/tunnel/wire-bytes.ts +0 -102
- package/vault/ARCHITECTURE.md +0 -470
- package/vault/api-key.ts +0 -190
- package/vault/cli-auth-seal.ts +0 -157
- package/vault/cred-seal.ts +0 -146
- package/vault/credential.ts +0 -55
- package/vault/crypto.ts +0 -210
- package/vault/daemon-attest.ts +0 -229
- package/vault/derive.ts +0 -113
- package/vault/device-access.ts +0 -87
- package/vault/device-anchor.ts +0 -185
- package/vault/handoff.ts +0 -396
- package/vault/index.ts +0 -21
- package/vault/pin.ts +0 -153
- package/vault/public-key-seal.ts +0 -131
- package/vault/seed.ts +0 -272
- package/vault/team.ts +0 -355
- package/vault/vault-item.ts +0 -131
- package/vault/vault-migrate-digest.ts +0 -29
- package/vault/wrapped.ts +0 -77
- package/wire/ARCHITECTURE.md +0 -90
- package/wire/CONTRIBUTING.md +0 -19
- package/wire/adapters/messages/anthropic-map.ts +0 -37
- package/wire/adapters/messages/index.ts +0 -7
- package/wire/adapters/messages/reasoning-from-items.ts +0 -38
- package/wire/adapters/messages/reasoning-signature.ts +0 -243
- package/wire/adapters/messages/request.ts +0 -574
- package/wire/adapters/messages/response.ts +0 -215
- package/wire/adapters/messages/streaming.ts +0 -1027
- package/wire/adapters/messages/usage.ts +0 -43
- package/wire/adapters/responses/index.ts +0 -3
- package/wire/adapters/responses/request.ts +0 -395
- package/wire/adapters/responses/response.ts +0 -88
- package/wire/adapters/responses/streaming.ts +0 -344
- package/wire/assets/openllm-light.svg +0 -18
- package/wire/assets/openllm.svg +0 -18
- package/wire/features/account-rank.ts +0 -166
- package/wire/features/compaction/compact-request.ts +0 -862
- package/wire/features/compaction/compaction-text.ts +0 -43
- package/wire/features/context-demote.ts +0 -47
- package/wire/features/context-overflow-strategy.ts +0 -26
- package/wire/features/conversation-affinity.ts +0 -144
- package/wire/features/max-tokens-backfill.ts +0 -141
- package/wire/features/model-caps.ts +0 -53
- package/wire/features/model-settings.ts +0 -24
- package/wire/features/output-limit-clamp.ts +0 -64
- package/wire/features/quota-gate.ts +0 -85
- package/wire/index.ts +0 -44
- package/wire/lib/attempt-outcome.ts +0 -43
- package/wire/lib/canonical/count-tokens-capability.ts +0 -138
- package/wire/lib/canonical/image-signature.ts +0 -202
- package/wire/lib/canonical/image-sse.ts +0 -216
- package/wire/lib/canonical/token-estimate.ts +0 -266
- package/wire/lib/encrypted-content.ts +0 -66
- package/wire/lib/error-class.ts +0 -154
- package/wire/lib/error-envelope.ts +0 -56
- package/wire/lib/provider-error-rules.ts +0 -48
- package/wire/lib/responses-apply-patch.ts +0 -104
- package/wire/lib/secret-scrub.ts +0 -101
- package/wire/lib/streaming/accumulate.ts +0 -221
- package/wire/lib/streaming/finish-reason.ts +0 -33
- package/wire/lib/streaming/provider-decode.ts +0 -259
- package/wire/lib/streaming/response-stream.ts +0 -71
- package/wire/lib/streaming/sse.ts +0 -699
- package/wire/lib/streaming/strip-tool-calls.ts +0 -95
- package/wire/lib/streaming/upstream-error.ts +0 -58
- package/wire/lib/strip-subagent-isolation.ts +0 -284
- package/wire/lib/token-ruler/bpe-core.ts +0 -426
- package/wire/lib/token-ruler/index.ts +0 -2
- package/wire/lib/token-ruler/ruler.ts +0 -79
- package/wire/lib/token-ruler/vocab/claude-ranks.ts +0 -16
- package/wire/lib/token-ruler/vocab/o200k-ranks.ts +0 -18
- package/wire/lib/token-ruler/vocab/o200k.ts +0 -19
- package/wire/lib/tool-name-map.ts +0 -271
- package/wire/lib/tool-schema.ts +0 -353
- package/wire/lib/usage-observer.ts +0 -125
- package/wire/providers/anthropic/adaptive-thinking.ts +0 -291
- package/wire/providers/anthropic/request.ts +0 -607
- package/wire/providers/anthropic/response.ts +0 -155
- package/wire/providers/anthropic/streaming.ts +0 -315
- package/wire/providers/anthropic/web-search-domains.ts +0 -49
- package/wire/providers/chatgpt/request.ts +0 -959
- package/wire/providers/chatgpt/streaming.ts +0 -1007
- package/wire/providers/chatgpt/web-search.ts +0 -63
- package/wire/providers/grok/web-search.ts +0 -87
- package/wire/providers/kimi/web-search.ts +0 -145
- package/wire/providers/upstream-deny.ts +0 -355
- package/wire/providers/upstream-request.ts +0 -619
- /package/{protocol/inference-headers.ts → dist/protocol/inference-headers.js} +0 -0
package/protocol/url-locality.ts
DELETED
|
@@ -1,288 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Classifiers and validation for custom upstream URLs.
|
|
3
|
-
*
|
|
4
|
-
* `isLocalEndpoint` is intentionally a pure, synchronous classifier: browser
|
|
5
|
-
* routing and daemon-local code need to answer whether a literal URL names the
|
|
6
|
-
* local network without doing DNS. Hosted code must use
|
|
7
|
-
* `isSafeRemoteEndpoint` immediately before connecting; it resolves public
|
|
8
|
-
* names and rejects answers in non-public address space.
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
/** `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`. */
|
|
12
|
-
const isRfc1918 = (o: ReadonlyArray<number>): boolean => {
|
|
13
|
-
const [a, b] = o as [number, number, number, number];
|
|
14
|
-
if (a === 10) return true;
|
|
15
|
-
if (a === 172 && b >= 16 && b <= 31) return true;
|
|
16
|
-
if (a === 192 && b === 168) return true;
|
|
17
|
-
return false;
|
|
18
|
-
};
|
|
19
|
-
|
|
20
|
-
const parseIpv4 = (host: string): ReadonlyArray<number> | null => {
|
|
21
|
-
const parts = host.split(".");
|
|
22
|
-
if (parts.length !== 4) return null;
|
|
23
|
-
const octets: Array<number> = [];
|
|
24
|
-
for (const part of parts) {
|
|
25
|
-
if (!/^\d{1,3}$/.test(part)) return null;
|
|
26
|
-
const n = Number(part);
|
|
27
|
-
if (n > 255) return null;
|
|
28
|
-
octets.push(n);
|
|
29
|
-
}
|
|
30
|
-
return octets;
|
|
31
|
-
};
|
|
32
|
-
|
|
33
|
-
/**
|
|
34
|
-
* Remove trailing slashes and an optional trailing `/v1` segment.
|
|
35
|
-
*/
|
|
36
|
-
const normalizeHostRoot = (raw: string): string => {
|
|
37
|
-
const hostRoot = raw.replace(/\/+$/, "");
|
|
38
|
-
return hostRoot.replace(/\/v1$/, "");
|
|
39
|
-
};
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* Same as `normalizeHostRoot`, plus optional `/v1beta` stripping for image
|
|
43
|
-
* endpoints that may use Google-compatible discovery paths.
|
|
44
|
-
*/
|
|
45
|
-
const normalizeHostRootForImage = (raw: string): string =>
|
|
46
|
-
raw
|
|
47
|
-
.replace(/\/+$/, "")
|
|
48
|
-
.replace(/\/v1beta$/, "")
|
|
49
|
-
.replace(/\/v1$/, "");
|
|
50
|
-
|
|
51
|
-
/**
|
|
52
|
-
* Options for custom base URL normalization.
|
|
53
|
-
*/
|
|
54
|
-
type TNormalizeBaseUrlOptions = {
|
|
55
|
-
readonly trimWhitespace?: boolean;
|
|
56
|
-
};
|
|
57
|
-
|
|
58
|
-
/**
|
|
59
|
-
* Normalize a user-pasted custom base URL for OpenAI-style custom endpoints.
|
|
60
|
-
*/
|
|
61
|
-
export const normalizeBaseUrl = (
|
|
62
|
-
raw: string,
|
|
63
|
-
options: TNormalizeBaseUrlOptions = {},
|
|
64
|
-
): string => {
|
|
65
|
-
const normalized = options.trimWhitespace === true ? raw.trim() : raw;
|
|
66
|
-
return normalizeHostRoot(normalized);
|
|
67
|
-
};
|
|
68
|
-
|
|
69
|
-
/**
|
|
70
|
-
* Normalize a user-pasted custom base URL for image-style custom endpoints.
|
|
71
|
-
*/
|
|
72
|
-
export const normalizeImageBaseUrl = (
|
|
73
|
-
raw: string,
|
|
74
|
-
options: TNormalizeBaseUrlOptions = {},
|
|
75
|
-
): string => {
|
|
76
|
-
const normalized = options.trimWhitespace === true ? raw.trim() : raw;
|
|
77
|
-
return normalizeHostRootForImage(normalized);
|
|
78
|
-
};
|
|
79
|
-
|
|
80
|
-
/**
|
|
81
|
-
* WHATWG URL keeps IPv6 brackets in `hostname`. Lower-case it and remove the
|
|
82
|
-
* single root-label dot that denotes the same DNS name (`localhost.`).
|
|
83
|
-
*/
|
|
84
|
-
const normalizeHost = (raw: string): string => {
|
|
85
|
-
const lower = raw.trim().toLowerCase();
|
|
86
|
-
const bare =
|
|
87
|
-
lower.startsWith("[") && lower.endsWith("]") ? lower.slice(1, -1) : lower;
|
|
88
|
-
return bare.endsWith(".") ? bare.slice(0, -1) : bare;
|
|
89
|
-
};
|
|
90
|
-
|
|
91
|
-
const isLocalIpv4 = (o: ReadonlyArray<number>): boolean => {
|
|
92
|
-
const [a, b] = o as [number, number, number, number];
|
|
93
|
-
if (a === 127) return true;
|
|
94
|
-
if (a === 0) return true;
|
|
95
|
-
if (a === 169 && b === 254) return true;
|
|
96
|
-
return isRfc1918(o);
|
|
97
|
-
};
|
|
98
|
-
|
|
99
|
-
const isForbiddenIpv4 = (o: ReadonlyArray<number>): boolean => {
|
|
100
|
-
const [a, b, c] = o as [number, number, number, number];
|
|
101
|
-
if (isLocalIpv4(o)) return true;
|
|
102
|
-
// Carrier-grade NAT, benchmark, documentation, multicast, and reserved
|
|
103
|
-
// ranges are not public Internet targets and must not be SSRF destinations.
|
|
104
|
-
// Match the reserved blocks exactly — do not over-block neighbouring
|
|
105
|
-
// public space under the same /16 (e.g. 192.0.1.0/24 is public, only
|
|
106
|
-
// 192.0.0.0/24 and 192.0.2.0/24 are reserved; likewise 198.51.100.0/24,
|
|
107
|
-
// not 198.51.0.0/16).
|
|
108
|
-
if (a === 100 && b >= 64 && b <= 127) return true; // 100.64.0.0/10 CGNAT
|
|
109
|
-
if (a === 192 && b === 0 && c === 0) return true; // 192.0.0.0/24 IETF Protocol Assignments
|
|
110
|
-
if (a === 192 && b === 0 && c === 2) return true; // 192.0.2.0/24 TEST-NET-1
|
|
111
|
-
if (a === 192 && b === 88 && c === 99) return true; // 192.88.99.0/24 6to4 anycast (deprecated)
|
|
112
|
-
if (a === 198 && (b === 18 || b === 19)) return true; // 198.18.0.0/15 benchmark
|
|
113
|
-
if (a === 198 && b === 51 && c === 100) return true; // 198.51.100.0/24 TEST-NET-2
|
|
114
|
-
if (a === 203 && b === 0 && c === 113) return true; // 203.0.113.0/24 TEST-NET-3
|
|
115
|
-
return a >= 224; // multicast + reserved
|
|
116
|
-
};
|
|
117
|
-
|
|
118
|
-
const isLocalIpv6 = (host: string): boolean => {
|
|
119
|
-
const mapped = /^::ffff:(\d{1,3}(?:\.\d{1,3}){3})$/.exec(host);
|
|
120
|
-
if (mapped !== null) {
|
|
121
|
-
const embedded = parseIpv4(mapped[1] as string);
|
|
122
|
-
return embedded !== null && isLocalIpv4(embedded);
|
|
123
|
-
}
|
|
124
|
-
const mappedHex = /^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/.exec(host);
|
|
125
|
-
if (mappedHex !== null) {
|
|
126
|
-
const hi = Number.parseInt(mappedHex[1] as string, 16);
|
|
127
|
-
const lo = Number.parseInt(mappedHex[2] as string, 16);
|
|
128
|
-
return isLocalIpv4([hi >> 8, hi & 0xff, lo >> 8, lo & 0xff]);
|
|
129
|
-
}
|
|
130
|
-
if (host === "::1" || host === "::") return true;
|
|
131
|
-
if (/^fe[89ab][0-9a-f]:/.test(host)) return true;
|
|
132
|
-
if (/^f[cd][0-9a-f]{0,2}:/.test(host)) return true;
|
|
133
|
-
return false;
|
|
134
|
-
};
|
|
135
|
-
|
|
136
|
-
/**
|
|
137
|
-
* Expand a textual IPv6 address (no brackets, no dotted v4 tail) into 8
|
|
138
|
-
* hextets. Returns null when the form is unparseable.
|
|
139
|
-
*/
|
|
140
|
-
const parseIpv6Hextets = (host: string): ReadonlyArray<number> | null => {
|
|
141
|
-
if (host.includes(".")) return null;
|
|
142
|
-
const sides = host.split("::");
|
|
143
|
-
if (sides.length > 2) return null;
|
|
144
|
-
const parseSide = (side: string): Array<number> | null => {
|
|
145
|
-
if (side.length === 0) return [];
|
|
146
|
-
const parts = side.split(":");
|
|
147
|
-
const out: Array<number> = [];
|
|
148
|
-
for (const part of parts) {
|
|
149
|
-
if (!/^[0-9a-f]{1,4}$/.test(part)) return null;
|
|
150
|
-
out.push(Number.parseInt(part, 16));
|
|
151
|
-
}
|
|
152
|
-
return out;
|
|
153
|
-
};
|
|
154
|
-
if (sides.length === 1) {
|
|
155
|
-
const all = parseSide(sides[0] as string);
|
|
156
|
-
return all !== null && all.length === 8 ? all : null;
|
|
157
|
-
}
|
|
158
|
-
const left = parseSide(sides[0] as string);
|
|
159
|
-
const right = parseSide(sides[1] as string);
|
|
160
|
-
if (left === null || right === null) return null;
|
|
161
|
-
const fill = 8 - left.length - right.length;
|
|
162
|
-
if (fill < 1) return null;
|
|
163
|
-
return [...left, ...Array.from({ length: fill }, () => 0), ...right];
|
|
164
|
-
};
|
|
165
|
-
|
|
166
|
-
const ipv4FromHextetPair = (hi: number, lo: number): ReadonlyArray<number> => [
|
|
167
|
-
hi >> 8,
|
|
168
|
-
hi & 0xff,
|
|
169
|
-
lo >> 8,
|
|
170
|
-
lo & 0xff,
|
|
171
|
-
];
|
|
172
|
-
|
|
173
|
-
const isForbiddenIpv6 = (host: string): boolean => {
|
|
174
|
-
if (isLocalIpv6(host)) return true;
|
|
175
|
-
// IPv4-mapped dotted form (::ffff:a.b.c.d) — apply the v4 policy to the
|
|
176
|
-
// embedded address (CGNAT / docs / multicast, not only RFC1918).
|
|
177
|
-
const mapped = /^::ffff:(\d{1,3}(?:\.\d{1,3}){3})$/.exec(host);
|
|
178
|
-
if (mapped !== null) {
|
|
179
|
-
const embedded = parseIpv4(mapped[1] as string);
|
|
180
|
-
return embedded !== null && isForbiddenIpv4(embedded);
|
|
181
|
-
}
|
|
182
|
-
const mappedHex = /^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/.exec(host);
|
|
183
|
-
if (mappedHex !== null) {
|
|
184
|
-
const hi = Number.parseInt(mappedHex[1] as string, 16);
|
|
185
|
-
const lo = Number.parseInt(mappedHex[2] as string, 16);
|
|
186
|
-
return isForbiddenIpv4(ipv4FromHextetPair(hi, lo));
|
|
187
|
-
}
|
|
188
|
-
// IPv4-compatible addresses are obsolete, but still permit a textual v4
|
|
189
|
-
// tail in some resolvers. Treat them conservatively.
|
|
190
|
-
if (/^::(?:[0-9a-f]{1,4}:)?[0-9a-f]+:[0-9a-f]+$/.test(host)) return true;
|
|
191
|
-
// IPv6 documentation space (2001:db8::/32) is reserved.
|
|
192
|
-
if (host.startsWith("2001:db8:")) return true;
|
|
193
|
-
// 6to4 (2002::/16) is a deprecated transition mechanism — never a safe
|
|
194
|
-
// hosted SSRF target even when the embedded v4 looks public.
|
|
195
|
-
if (host.startsWith("2002:")) return true;
|
|
196
|
-
|
|
197
|
-
const hextets = parseIpv6Hextets(host);
|
|
198
|
-
if (hextets === null) {
|
|
199
|
-
// Fail closed on multicast / NAT64 textual prefixes we couldn't expand.
|
|
200
|
-
if (/^ff[0-9a-f]{0,2}:/.test(host)) return true;
|
|
201
|
-
if (host.startsWith("64:ff9b:")) return true;
|
|
202
|
-
return false;
|
|
203
|
-
}
|
|
204
|
-
const first = hextets[0] as number;
|
|
205
|
-
// Multicast ff00::/8.
|
|
206
|
-
if ((first & 0xff00) === 0xff00) return true;
|
|
207
|
-
// NAT64 well-known prefix 64:ff9b::/96 — last 32 bits are the embedded v4.
|
|
208
|
-
if (
|
|
209
|
-
first === 0x64 &&
|
|
210
|
-
hextets[1] === 0xff9b &&
|
|
211
|
-
hextets[2] === 0 &&
|
|
212
|
-
hextets[3] === 0 &&
|
|
213
|
-
hextets[4] === 0 &&
|
|
214
|
-
hextets[5] === 0
|
|
215
|
-
) {
|
|
216
|
-
return isForbiddenIpv4(
|
|
217
|
-
ipv4FromHextetPair(hextets[6] as number, hextets[7] as number),
|
|
218
|
-
);
|
|
219
|
-
}
|
|
220
|
-
return false;
|
|
221
|
-
};
|
|
222
|
-
|
|
223
|
-
/** True when `host` names local/private/link-local network space. */
|
|
224
|
-
export const isLocalHostname = (rawHost: string): boolean => {
|
|
225
|
-
const host = normalizeHost(rawHost);
|
|
226
|
-
if (host.length === 0) return true;
|
|
227
|
-
if (host === "localhost" || host.endsWith(".localhost")) return true;
|
|
228
|
-
if (host === "local" || host.endsWith(".local")) return true;
|
|
229
|
-
const v4 = parseIpv4(host);
|
|
230
|
-
if (v4 !== null) return isLocalIpv4(v4);
|
|
231
|
-
if (host.includes(":")) return isLocalIpv6(host);
|
|
232
|
-
return false;
|
|
233
|
-
};
|
|
234
|
-
|
|
235
|
-
/**
|
|
236
|
-
* True when `url` is unparseable, or its literal host is loopback / private /
|
|
237
|
-
* link-local / mDNS. This intentionally does not resolve DNS.
|
|
238
|
-
*/
|
|
239
|
-
export const isLocalEndpoint = (url: string): boolean => {
|
|
240
|
-
let parsed: URL;
|
|
241
|
-
try {
|
|
242
|
-
parsed = new URL(url);
|
|
243
|
-
} catch {
|
|
244
|
-
return true;
|
|
245
|
-
}
|
|
246
|
-
return isLocalHostname(parsed.hostname);
|
|
247
|
-
};
|
|
248
|
-
|
|
249
|
-
export const isForbiddenResolvedAddress = (address: string): boolean => {
|
|
250
|
-
const normalized = normalizeHost(address);
|
|
251
|
-
const v4 = parseIpv4(normalized);
|
|
252
|
-
if (v4 !== null) return isForbiddenIpv4(v4);
|
|
253
|
-
return normalized.includes(":") ? isForbiddenIpv6(normalized) : true;
|
|
254
|
-
};
|
|
255
|
-
|
|
256
|
-
/**
|
|
257
|
-
* The DNS-free half of `isSafeRemoteEndpoint` (in `url-locality-dns.ts`):
|
|
258
|
-
* a verdict when the URL alone decides it, otherwise the hostname to resolve.
|
|
259
|
-
* Kept here so this module stays importable from edge/browser bundles.
|
|
260
|
-
*/
|
|
261
|
-
export const preflightRemoteEndpoint = (
|
|
262
|
-
url: string,
|
|
263
|
-
): { readonly safe: boolean } | { readonly resolve: string } => {
|
|
264
|
-
let parsed: URL;
|
|
265
|
-
try {
|
|
266
|
-
parsed = new URL(url);
|
|
267
|
-
} catch {
|
|
268
|
-
return { safe: false };
|
|
269
|
-
}
|
|
270
|
-
if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
|
|
271
|
-
return { safe: false };
|
|
272
|
-
}
|
|
273
|
-
if (parsed.username.length > 0 || parsed.password.length > 0) {
|
|
274
|
-
return { safe: false };
|
|
275
|
-
}
|
|
276
|
-
if (isLocalHostname(parsed.hostname)) return { safe: false };
|
|
277
|
-
const literal = normalizeHost(parsed.hostname);
|
|
278
|
-
if (parseIpv4(literal) !== null || literal.includes(":")) {
|
|
279
|
-
return { safe: !isForbiddenResolvedAddress(literal) };
|
|
280
|
-
}
|
|
281
|
-
return { resolve: literal };
|
|
282
|
-
};
|
|
283
|
-
|
|
284
|
-
/** Error code every refusal path returns, so clients can branch on it. */
|
|
285
|
-
export const LOCAL_ENDPOINT_ERROR_CODE = "local_endpoint_requires_daemon";
|
|
286
|
-
|
|
287
|
-
export const localEndpointMessage = (url: string): string =>
|
|
288
|
-
`"${url}" points at a local or private network address. The hosted gateway runs on Vercel — its localhost is not your machine, so it can never reach this endpoint. Local models (Ollama, LM Studio, llama.cpp) are served by the OpenLLM daemon running on your own machine; register and use them with the daemon running and the request never leaves the box.`;
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
import { Schema as S } from "effect";
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Metadata-only signed plan for an existing video job (poll/content/cancel).
|
|
5
|
-
* Carries the job id's signed fields only — never the prompt, never aliases,
|
|
6
|
-
* never cooldown/default derivation. The cloud verifies `sig` before planning.
|
|
7
|
-
*/
|
|
8
|
-
export const VIDEO_JOB_PLAN_QUERY_KEY = "video_job";
|
|
9
|
-
export const VIDEO_JOB_PLAN_JSON_MAX_BYTES = 1024;
|
|
10
|
-
|
|
11
|
-
export const VideoJobPlanRequest = S.Struct({
|
|
12
|
-
model: S.String.check(S.isMinLength(1), S.isMaxLength(128)),
|
|
13
|
-
provider: S.String.check(S.isMinLength(1), S.isMaxLength(64)),
|
|
14
|
-
upstream_id: S.String.check(S.isMinLength(1), S.isMaxLength(256)),
|
|
15
|
-
created_at: S.Number,
|
|
16
|
-
sig: S.String.check(S.isPattern(/^[a-f0-9]{64}$/)),
|
|
17
|
-
});
|
|
18
|
-
export type TVideoJobPlanRequest = S.Schema.Type<typeof VideoJobPlanRequest>;
|
|
19
|
-
|
|
20
|
-
const decodeRequest = S.decodeUnknownResult(VideoJobPlanRequest);
|
|
21
|
-
|
|
22
|
-
const utf8ByteLength = (value: string): number =>
|
|
23
|
-
new TextEncoder().encode(value).byteLength;
|
|
24
|
-
|
|
25
|
-
export const encodeVideoJobPlanQuery = (
|
|
26
|
-
request: TVideoJobPlanRequest,
|
|
27
|
-
): string | null => {
|
|
28
|
-
const decoded = decodeRequest(request);
|
|
29
|
-
if (decoded._tag === "Failure") return null;
|
|
30
|
-
const json = JSON.stringify(decoded.success);
|
|
31
|
-
if (utf8ByteLength(json) > VIDEO_JOB_PLAN_JSON_MAX_BYTES) return null;
|
|
32
|
-
return `${VIDEO_JOB_PLAN_QUERY_KEY}=${encodeURIComponent(json)}`;
|
|
33
|
-
};
|
|
34
|
-
|
|
35
|
-
export const decodeVideoJobPlanQuery = (
|
|
36
|
-
params: URLSearchParams,
|
|
37
|
-
): TVideoJobPlanRequest | null => {
|
|
38
|
-
const raw = params.get(VIDEO_JOB_PLAN_QUERY_KEY);
|
|
39
|
-
if (raw === null || raw.length === 0) return null;
|
|
40
|
-
if (utf8ByteLength(raw) > VIDEO_JOB_PLAN_JSON_MAX_BYTES) return null;
|
|
41
|
-
let parsed: unknown;
|
|
42
|
-
try {
|
|
43
|
-
parsed = JSON.parse(raw);
|
|
44
|
-
} catch {
|
|
45
|
-
return null;
|
|
46
|
-
}
|
|
47
|
-
const decoded = decodeRequest(parsed);
|
|
48
|
-
if (decoded._tag === "Failure") return null;
|
|
49
|
-
return decoded.success;
|
|
50
|
-
};
|
package/protocol/videos.ts
DELETED
|
@@ -1,227 +0,0 @@
|
|
|
1
|
-
import { Schema as S } from "effect";
|
|
2
|
-
import { OptionalMediaModel } from "./media-input";
|
|
3
|
-
import { VideoInputMode, VideoReferenceInputs } from "./models";
|
|
4
|
-
|
|
5
|
-
export const VIDEO_INPUT_ERROR =
|
|
6
|
-
"Invalid video input. Use only canonical video fields; input_image is a starting frame, reference_images are subject references, and reference_voices are voice IDs. Unknown fields (including input_reference) are not supported.";
|
|
7
|
-
|
|
8
|
-
const ReferenceCount = S.Int.check(S.isGreaterThanOrEqualTo(0));
|
|
9
|
-
/** Metadata only: counts of inputs, never URLs, bytes, or browser media IDs. */
|
|
10
|
-
export const VideoInputReceipt = S.Struct({
|
|
11
|
-
mode: VideoInputMode,
|
|
12
|
-
starting_images: ReferenceCount,
|
|
13
|
-
subject_images: ReferenceCount,
|
|
14
|
-
voices: ReferenceCount,
|
|
15
|
-
});
|
|
16
|
-
export type TVideoInputReceipt = S.Schema.Type<typeof VideoInputReceipt>;
|
|
17
|
-
|
|
18
|
-
export const videoInputReceiptFromCounts = (
|
|
19
|
-
counts: Omit<TVideoInputReceipt, "mode">,
|
|
20
|
-
): TVideoInputReceipt => {
|
|
21
|
-
const {
|
|
22
|
-
starting_images: startingImages,
|
|
23
|
-
subject_images: subjectImages,
|
|
24
|
-
voices,
|
|
25
|
-
} = counts;
|
|
26
|
-
const mode = S.decodeUnknownSync(VideoInputMode)(
|
|
27
|
-
[
|
|
28
|
-
startingImages > 0 ? "starting_image" : "",
|
|
29
|
-
subjectImages > 0 ? "subject_images" : "",
|
|
30
|
-
voices > 0 ? "voices" : "",
|
|
31
|
-
]
|
|
32
|
-
.filter(Boolean)
|
|
33
|
-
.join("+") || "text",
|
|
34
|
-
);
|
|
35
|
-
return {
|
|
36
|
-
mode,
|
|
37
|
-
starting_images: startingImages,
|
|
38
|
-
subject_images: subjectImages,
|
|
39
|
-
voices,
|
|
40
|
-
};
|
|
41
|
-
};
|
|
42
|
-
|
|
43
|
-
export const videoInputRequirements = (
|
|
44
|
-
body: Pick<
|
|
45
|
-
TVideoGenerationInput,
|
|
46
|
-
"input_image" | "reference_images" | "reference_voices"
|
|
47
|
-
>,
|
|
48
|
-
): TVideoInputReceipt =>
|
|
49
|
-
videoInputReceiptFromCounts({
|
|
50
|
-
starting_images: body.input_image === undefined ? 0 : 1,
|
|
51
|
-
subject_images: body.reference_images?.length ?? 0,
|
|
52
|
-
voices: body.reference_voices?.length ?? 0,
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
/** Clip duration in seconds. Providers validate unsupported values. */
|
|
56
|
-
export const VideoSeconds = S.String.pipe(
|
|
57
|
-
S.annotate({
|
|
58
|
-
description:
|
|
59
|
-
"Requested duration in seconds as a numeric string. Values are not clamped; the provider validates durations accepted by the selected model.",
|
|
60
|
-
}),
|
|
61
|
-
);
|
|
62
|
-
export type TVideoSeconds = S.Schema.Type<typeof VideoSeconds>;
|
|
63
|
-
|
|
64
|
-
/** Output resolution as "WIDTHxHEIGHT" (e.g. "720x1280"). */
|
|
65
|
-
export const VideoSize = S.String.pipe(
|
|
66
|
-
S.annotate({
|
|
67
|
-
description:
|
|
68
|
-
"Requested output dimensions as WIDTHxHEIGHT (for example 1280x720 or 720x1280). Adapters preserve aspect ratio and resolution intent; the provider validates model-specific sizes.",
|
|
69
|
-
}),
|
|
70
|
-
);
|
|
71
|
-
export type TVideoSize = S.Schema.Type<typeof VideoSize>;
|
|
72
|
-
|
|
73
|
-
/** Canonical reference semantics are preserved or rejected, never silently dropped. */
|
|
74
|
-
export const VideoGenerationRequest = S.Struct({
|
|
75
|
-
model: S.String,
|
|
76
|
-
prompt: S.String,
|
|
77
|
-
seconds: S.optionalKey(VideoSeconds),
|
|
78
|
-
size: S.optionalKey(VideoSize),
|
|
79
|
-
...VideoReferenceInputs.fields,
|
|
80
|
-
}).pipe(S.annotate({ parseOptions: { onExcessProperty: "error" } }));
|
|
81
|
-
export type TVideoGenerationRequest = S.Schema.Type<
|
|
82
|
-
typeof VideoGenerationRequest
|
|
83
|
-
>;
|
|
84
|
-
|
|
85
|
-
const { model: _videoGenerationModel, ...videoGenerationInputFields } =
|
|
86
|
-
VideoGenerationRequest.fields;
|
|
87
|
-
export const VideoGenerationInput = S.Struct({
|
|
88
|
-
...videoGenerationInputFields,
|
|
89
|
-
model: OptionalMediaModel,
|
|
90
|
-
}).pipe(
|
|
91
|
-
S.annotate({
|
|
92
|
-
description:
|
|
93
|
-
"Video creation input. Only prompt is required. Send only needed optional keys; omit unused model and reference arrays rather than filling dummy empty strings or arrays.",
|
|
94
|
-
parseOptions: { onExcessProperty: "error" },
|
|
95
|
-
}),
|
|
96
|
-
);
|
|
97
|
-
export type TVideoGenerationInput = S.Schema.Type<typeof VideoGenerationInput>;
|
|
98
|
-
|
|
99
|
-
const decodeVideoInput = S.decodeUnknownResult(VideoGenerationInput, {
|
|
100
|
-
onExcessProperty: "error",
|
|
101
|
-
});
|
|
102
|
-
/** Safe diagnostics intentionally never include Effect's raw actual values. */
|
|
103
|
-
/**
|
|
104
|
-
* Effect 3's `optional` accepted an explicit `undefined`; Effect 4's
|
|
105
|
-
* `optionalKey` does not. Treat an `undefined` key as absent, as before, so
|
|
106
|
-
* in-process callers that spread optional values keep working. `null` and
|
|
107
|
-
* every other wrong type still fail, and the wire schema stays exact.
|
|
108
|
-
*/
|
|
109
|
-
export const omitUndefinedKeys = (body: unknown): unknown => {
|
|
110
|
-
if (body === null || typeof body !== "object" || Array.isArray(body)) {
|
|
111
|
-
return body;
|
|
112
|
-
}
|
|
113
|
-
return Object.fromEntries(
|
|
114
|
-
Object.entries(body).filter(([, value]) => value !== undefined),
|
|
115
|
-
);
|
|
116
|
-
};
|
|
117
|
-
|
|
118
|
-
export const parseVideoGenerationInput = (
|
|
119
|
-
body: unknown,
|
|
120
|
-
): TVideoGenerationInput => {
|
|
121
|
-
const result = decodeVideoInput(omitUndefinedKeys(body));
|
|
122
|
-
if (result._tag === "Failure") throw new Error(VIDEO_INPUT_ERROR);
|
|
123
|
-
return result.success;
|
|
124
|
-
};
|
|
125
|
-
|
|
126
|
-
/** Privacy-safe provider diagnostics; preserve corrective text, never attachment material. */
|
|
127
|
-
export const redactVideoErrorText = (
|
|
128
|
-
message: string,
|
|
129
|
-
sensitive: ReadonlyArray<string>,
|
|
130
|
-
): string => {
|
|
131
|
-
let clean = message;
|
|
132
|
-
for (const secret of sensitive) {
|
|
133
|
-
if (secret.length === 0) continue;
|
|
134
|
-
clean = clean.split(secret).join("[redacted]");
|
|
135
|
-
const encoded = secret.match(/^data:[^,]+,(.*)$/s)?.[1];
|
|
136
|
-
if (encoded) clean = clean.split(encoded).join("[redacted]");
|
|
137
|
-
}
|
|
138
|
-
return clean
|
|
139
|
-
.replace(/https?:\/\/[^\s<>"']+/gi, "[redacted-url]")
|
|
140
|
-
.replace(/data:[^\s"']+/gi, "[redacted-image]")
|
|
141
|
-
.replace(/\b[A-Za-z0-9+/]{128,}={0,2}/g, "[redacted-bytes]");
|
|
142
|
-
};
|
|
143
|
-
|
|
144
|
-
export const VideoJobStatus = S.Literals([
|
|
145
|
-
"queued",
|
|
146
|
-
"in_progress",
|
|
147
|
-
"completed",
|
|
148
|
-
"failed",
|
|
149
|
-
]);
|
|
150
|
-
export type TVideoJobStatus = S.Schema.Type<typeof VideoJobStatus>;
|
|
151
|
-
|
|
152
|
-
const VideoJobError = S.Struct({
|
|
153
|
-
code: S.optional(S.String),
|
|
154
|
-
message: S.optional(S.String),
|
|
155
|
-
});
|
|
156
|
-
|
|
157
|
-
export const VideoDeleted = S.Struct({
|
|
158
|
-
id: S.String,
|
|
159
|
-
object: S.Literals(["video.deleted"]),
|
|
160
|
-
deleted: S.Boolean,
|
|
161
|
-
});
|
|
162
|
-
export type TVideoDeleted = S.Schema.Type<typeof VideoDeleted>;
|
|
163
|
-
|
|
164
|
-
export const VideoJob = S.Struct({
|
|
165
|
-
id: S.String,
|
|
166
|
-
object: S.Literals(["video"]),
|
|
167
|
-
created_at: S.Number,
|
|
168
|
-
status: VideoJobStatus,
|
|
169
|
-
model: S.String,
|
|
170
|
-
progress: S.optional(S.Number),
|
|
171
|
-
/** Inputs actually forwarded on accepted creation; absent means unknown. */
|
|
172
|
-
input_receipt: S.optional(VideoInputReceipt),
|
|
173
|
-
seconds: S.optional(VideoSeconds),
|
|
174
|
-
size: S.optional(VideoSize),
|
|
175
|
-
error: S.optional(S.NullOr(VideoJobError)),
|
|
176
|
-
});
|
|
177
|
-
export type TVideoJob = S.Schema.Type<typeof VideoJob>;
|
|
178
|
-
|
|
179
|
-
/**
|
|
180
|
-
* Opaque video job id: provider, upstream job id, model, created-at, and the
|
|
181
|
-
* cloud's signature over all four (`s`). Only the cloud holds the signing
|
|
182
|
-
* key, so a client can't re-point a job at another model or upstream job; a
|
|
183
|
-
* daemon that creates a job asks the cloud to sign it.
|
|
184
|
-
*/
|
|
185
|
-
export type TVideoIdFields = {
|
|
186
|
-
readonly p: string;
|
|
187
|
-
readonly u: string;
|
|
188
|
-
readonly m: string;
|
|
189
|
-
readonly c: number;
|
|
190
|
-
};
|
|
191
|
-
export type TVideoIdPayload = TVideoIdFields & { readonly s: string };
|
|
192
|
-
|
|
193
|
-
export const encodeVideoId = (payload: TVideoIdPayload): string =>
|
|
194
|
-
`video_${Buffer.from(JSON.stringify(payload), "utf8").toString("base64url")}`;
|
|
195
|
-
|
|
196
|
-
export const decodeVideoId = (id: string): TVideoIdPayload | null => {
|
|
197
|
-
if (!id.startsWith("video_")) return null;
|
|
198
|
-
try {
|
|
199
|
-
const parsed: unknown = JSON.parse(
|
|
200
|
-
Buffer.from(id.slice("video_".length), "base64url").toString("utf8"),
|
|
201
|
-
);
|
|
202
|
-
if (parsed === null || typeof parsed !== "object") return null;
|
|
203
|
-
const o = parsed as Record<string, unknown>;
|
|
204
|
-
if (
|
|
205
|
-
typeof o.p !== "string" ||
|
|
206
|
-
typeof o.u !== "string" ||
|
|
207
|
-
typeof o.m !== "string" ||
|
|
208
|
-
typeof o.c !== "number" ||
|
|
209
|
-
typeof o.s !== "string" ||
|
|
210
|
-
!/^[a-f0-9]{64}$/.test(o.s)
|
|
211
|
-
) {
|
|
212
|
-
return null;
|
|
213
|
-
}
|
|
214
|
-
return { p: o.p, u: o.u, m: o.m, c: o.c, s: o.s };
|
|
215
|
-
} catch {
|
|
216
|
-
return null;
|
|
217
|
-
}
|
|
218
|
-
};
|
|
219
|
-
|
|
220
|
-
/** Body of `POST /api/daemon/video-id`: a daemon asks the cloud to sign a job it created. */
|
|
221
|
-
export const VideoIdSignRequest = S.Struct({
|
|
222
|
-
p: S.String.check(S.isMinLength(1), S.isMaxLength(64)),
|
|
223
|
-
u: S.String.check(S.isMinLength(1), S.isMaxLength(256)),
|
|
224
|
-
m: S.String.check(S.isMinLength(1), S.isMaxLength(128)),
|
|
225
|
-
c: S.Number.check(S.isInt()),
|
|
226
|
-
});
|
|
227
|
-
export const VideoIdSignResponse = S.Struct({ id: S.String });
|
package/tsconfig.json
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"compilerOptions": {
|
|
3
|
-
"target": "ES2022",
|
|
4
|
-
"lib": ["ES2022", "DOM"],
|
|
5
|
-
"module": "ESNext",
|
|
6
|
-
"moduleResolution": "bundler",
|
|
7
|
-
"strict": true,
|
|
8
|
-
"noEmit": true,
|
|
9
|
-
"skipLibCheck": true,
|
|
10
|
-
"isolatedModules": true,
|
|
11
|
-
"resolveJsonModule": true
|
|
12
|
-
},
|
|
13
|
-
"include": ["./**/*.ts", "./**/*.json"]
|
|
14
|
-
}
|
package/tunnel/ARCHITECTURE.md
DELETED
|
@@ -1,111 +0,0 @@
|
|
|
1
|
-
# `packages/sdk/tunnel` Architecture
|
|
2
|
-
|
|
3
|
-
> `@openllmsh/sdk/tunnel` is the P1 sans-I/O binary mux used between a consumer,
|
|
4
|
-
> the blind relay, and a serving daemon. It depends directly only on
|
|
5
|
-
> `@openllmsh/sdk/protocol` (which owns the Effect Schema contract): no DOM,
|
|
6
|
-
> WebSocket implementation, Bun, timers, crypto transport, database, proxy
|
|
7
|
-
> pipeline, or framework.
|
|
8
|
-
|
|
9
|
-
| Layer | Responsibility | Must not know |
|
|
10
|
-
| --- | --- | --- |
|
|
11
|
-
| `codec.ts` | Frozen binary frame layout and bounded JSON/window helpers; codec-only relay subpath (`@openllmsh/sdk/tunnel/codec`) | Stream semantics or payload schemas |
|
|
12
|
-
| `channel-envelope.ts` | 16-byte channel-UUID wrapper around one whole relay-WS mux message (`mux2`), so one relay socket multiplexes several channels | Mux stream/flow semantics or payload schemas |
|
|
13
|
-
| `mux.ts` | Per-stream credits, lifecycle, parity, backpressure; optional sender-side `maxPayloadBytes` for SCTP-sized transports | Tunnel payload shape or host I/O |
|
|
14
|
-
| `peer-link.ts` | Sans-I/O RTC-first peer-link policy: selection, bounded probe budgets, negative-cache classification, pre-dispatch retry safety and idle retention | Browser, daemon, relay, WebSocket or RTC implementation details |
|
|
15
|
-
| `streams.ts` | OPEN/CTRL/RESET helpers and fetch-shaped tunnel stream APIs (`tunnelStream` / `serveStream`) | Relay routing and WebSocket mechanics |
|
|
16
|
-
| `stream-reset-error.ts` | Typed application-level reset error | Mux lifecycle or protocol parsing |
|
|
17
|
-
| `device-grant.ts` | Canonical device-grant envelope encode/decode + message bytes (no crypto) | Vault DEK, node:crypto, host I/O |
|
|
18
|
-
| `team-grant.ts` | Origin-signed team grant encode/decode + HMAC-SHA256 WebCrypto sign/verify (`v:2`) | Vault DEK, DB, host I/O |
|
|
19
|
-
| `rtc-duplex.ts` | ~20-line `TDuplex` over `RTCDataChannel` (DOM or werift) | Mux / payload schemas / auth |
|
|
20
|
-
| `rtc-auth.ts` | Pure fingerprint binding, ICE-server, and SCTP payload-cap helpers; hosts supply seal/open | Crypto implementations, signaling |
|
|
21
|
-
| `rtc-ice.ts` | Daemon-side mDNS ICE-candidate preflight for werift | RTC signaling, mux, or payload schemas |
|
|
22
|
-
|
|
23
|
-
## Wire contract
|
|
24
|
-
|
|
25
|
-
Every **bare mux message** is exactly one mux frame. The frozen header is nine
|
|
26
|
-
bytes, big-endian: `type(u8) | stream_id(u32) | length(u32)`, followed by
|
|
27
|
-
exactly `length` payload bytes. Relay-WebSocket messages prepend the 16-byte
|
|
28
|
-
`mux2` channel envelope; the relay validates the envelope and its one mux frame,
|
|
29
|
-
then forwards the original enveloped bytes. RTC carries the bare mux frame.
|
|
30
|
-
There is no byte-stream reassembly.
|
|
31
|
-
|
|
32
|
-
OPEN, CTRL, and RESET use UTF-8 JSON in P1. DATA is opaque bytes. END has an
|
|
33
|
-
empty payload. WINDOW is exactly one u32 big-endian delta. Numeric constants
|
|
34
|
-
have one home in `codec.ts`:
|
|
35
|
-
|
|
36
|
-
- maximum payload and implicit OPEN credit: 256 KiB (frozen — do not raise
|
|
37
|
-
unilaterally);
|
|
38
|
-
- post-OPEN WINDOW boost: +768 KiB (target receive window 1 MiB; skew-safe —
|
|
39
|
-
old peers just add the WINDOW delta);
|
|
40
|
-
- receiver replenishment threshold: 64 KiB;
|
|
41
|
-
- stream zero is channel CTRL; odd ids are consumer initiated and even ids are
|
|
42
|
-
daemon initiated.
|
|
43
|
-
|
|
44
|
-
## Relay blindness
|
|
45
|
-
|
|
46
|
-
The relay authorizes a channel at setup, then routes binary messages by the
|
|
47
|
-
16-byte envelope and nine-byte frame inspection only (the codec-only
|
|
48
|
-
`@openllmsh/sdk/tunnel/channel-envelope` and `@openllmsh/sdk/tunnel/codec` subpaths;
|
|
49
|
-
never `mux.ts`, JSON, stream kinds, or flow control). Application payloads and
|
|
50
|
-
stream state stay endpoint-private.
|
|
51
|
-
|
|
52
|
-
Every relay peer speaks `mux2` and prepends the **channel-id envelope**
|
|
53
|
-
(`channel-envelope.ts`) to every binary message, so a socket can hold several
|
|
54
|
-
channels at once. The relay demuxes by the tag only after verifying the sender
|
|
55
|
-
owns that channel; it forwards the enveloped message verbatim to the other
|
|
56
|
-
endpoint. The frozen mux codec is untouched — the envelope wraps one complete
|
|
57
|
-
mux WebSocket message, not a mux frame header. RTC data channels are never
|
|
58
|
-
enveloped (no relay hop — the data channel itself is the channel).
|
|
59
|
-
|
|
60
|
-
## Landed vs future modules
|
|
61
|
-
|
|
62
|
-
**Landed on this branch (beyond the frozen mux core):**
|
|
63
|
-
|
|
64
|
-
- `device-grant.ts` — seed-gated device-access grant wire format (signed by the
|
|
65
|
-
browser with the phrase-derived device-control key; verified by the daemon).
|
|
66
|
-
Capability negotiation uses `seedgate1` from `@openllmsh/sdk/protocol`. Every
|
|
67
|
-
grant that carries `dpk` also signs its `use` — `channel` (a relay-mux
|
|
68
|
-
`channel_open`, which the relay reads in plaintext), `rtc` (bound to the
|
|
69
|
-
offer's DTLS fingerprint) or `noise` (bound to the Noise initiator's static
|
|
70
|
-
key, `noiseGrantBinding`) — and the daemon refuses a grant of one use
|
|
71
|
-
presented as another, so a harvested `channel_open` grant cannot seed-gate
|
|
72
|
-
an RTC offer or authenticate a Noise initiator. Grants without `dpk` keep
|
|
73
|
-
the legacy bytes (no `use`/`bind`) for daemons that predate the fields.
|
|
74
|
-
- `team-grant.ts` — origin-signed team device grant (HMAC-SHA256 WebCrypto,
|
|
75
|
-
`v:2`). Short-lived `{v, team_id, share_id, consumer, device_user_id,
|
|
76
|
-
device_key_id, model, n, exp[, cap_tokens]}` envelope for cross-user relay
|
|
77
|
-
admission and contributor-daemon re-check. Signed under the per-contributor
|
|
78
|
-
key derived from `NEON_AUTH_COOKIE_SECRET`; daemons pin `team_grant_key` from
|
|
79
|
-
bootstrap. The relay does not verify — it only requires a non-empty grant for
|
|
80
|
-
cross-user opens and stamps `peer_user_id`. Unknown future envelope fields are
|
|
81
|
-
ignored on decode; v1 (Ed25519) is rejected.
|
|
82
|
-
- `device-control.ts` — device-control rotation v2 wire format
|
|
83
|
-
(`label || 0x00 || {v:2, old, new, cv}`, no timestamp, signed by `old`) and
|
|
84
|
-
the shared key fingerprint (`keyFingerprint` / `formatKeyFingerprint`).
|
|
85
|
-
- `rtc-auth.ts` / `rtc-duplex.ts` / `rtc-ice.ts` — WebRTC fingerprint-bound
|
|
86
|
-
offer/answer shapes, ICE-server and SCTP payload-cap helpers, a thin
|
|
87
|
-
data-channel duplex, and daemon-side mDNS-candidate preflight for werift.
|
|
88
|
-
Hosts own signaling and crypto: the browser and consuming fleet daemon are
|
|
89
|
-
offerers, while the serving daemon's `rtc-host` is the answerer. This is the
|
|
90
|
-
one direct-path stack for browser↔daemon and daemon↔daemon traffic; relay
|
|
91
|
-
binary mux is the fallback rung when RTC is unavailable (consumers do not use
|
|
92
|
-
a JSON splice — see `@packages/daemon-relay/ARCHITECTURE.md`).
|
|
93
|
-
|
|
94
|
-
**P2: agent-sessions E2E (in this release):**
|
|
95
|
-
|
|
96
|
-
- `secure.ts` — Noise_IK duplex wrapper (P2), with optional 32-byte PSK
|
|
97
|
-
selecting Noise_IKpsk2 and `deriveTeamTunnelPsk` for team-key HKDF. Secures the mux fallback for
|
|
98
|
-
agent streams (browser path when RTC unavailable or forced off).
|
|
99
|
-
`secureMuxStream` encrypts DATA (length-prefixed Noise records) and CTRL
|
|
100
|
-
(separate key pair); RESET / END / WINDOW stay plaintext. The frozen
|
|
101
|
-
nine-byte mux layout is unchanged.
|
|
102
|
-
- `streams.ts` — `agentStream` / `acceptAgentStream` plus the shared
|
|
103
|
-
`agentSecurePrologue` / `AGENT_SECURE_PROLOGUE_INFO` contract
|
|
104
|
-
(`openllm-agent-secure-v1|<channel_id>|<stream_id>`). Browser initiator and
|
|
105
|
-
daemon responder MUST import these from here (not duplicate the string).
|
|
106
|
-
`agentStream` accepts `secure` (initiator wrap) or a custom `prepareStream`.
|
|
107
|
-
|
|
108
|
-
**Still future (not present):**
|
|
109
|
-
|
|
110
|
-
- `paths.ts` — multi-path resolver (loopback → LAN → relay) for later direct-path
|
|
111
|
-
work (P3).
|