@openllmsh/sdk 2.10.12-alpha.1 → 2.10.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -7
- package/dist/client/chat.d.ts +38 -0
- package/dist/client/chat.js +77 -0
- package/dist/client/devices.d.ts +70 -0
- package/dist/client/devices.js +172 -0
- package/dist/client/http.d.ts +24 -0
- package/dist/client/http.js +34 -0
- package/dist/client/index.d.ts +43 -0
- package/dist/client/index.js +57 -0
- package/dist/client/relay-mux.d.ts +71 -0
- package/dist/client/relay-mux.js +394 -0
- package/dist/client/types.d.ts +47 -0
- package/dist/client/types.js +5 -0
- package/dist/client/vault.d.ts +68 -0
- package/dist/client/vault.js +113 -0
- package/dist/connect/chat.d.ts +24 -0
- package/dist/connect/chat.js +25 -0
- package/dist/connect/client.d.ts +50 -0
- package/dist/connect/client.js +141 -0
- package/dist/connect/config.d.ts +22 -0
- package/dist/connect/config.js +22 -0
- package/dist/connect/errors.d.ts +32 -0
- package/dist/connect/errors.js +85 -0
- package/{connect/index.ts → dist/connect/index.d.ts} +7 -7
- package/dist/connect/index.js +23 -0
- package/dist/connect/oauth.d.ts +51 -0
- package/dist/connect/oauth.js +150 -0
- package/dist/connect/routes.d.ts +38 -0
- package/dist/connect/routes.js +175 -0
- package/dist/connect/store.d.ts +26 -0
- package/dist/connect/store.js +65 -0
- package/dist/mcp/handle.d.ts +6 -0
- package/dist/mcp/handle.js +6 -0
- package/dist/mcp/index.d.ts +15 -0
- package/dist/mcp/index.js +10 -0
- package/dist/mcp/server.d.ts +84 -0
- package/dist/mcp/server.js +168 -0
- package/dist/mcp/tools/marketplace.d.ts +94 -0
- package/dist/mcp/tools/marketplace.js +303 -0
- package/dist/mcp/tools/memory-client.d.ts +109 -0
- package/dist/mcp/tools/memory-client.js +200 -0
- package/dist/mcp/tools/memory-config.d.ts +29 -0
- package/dist/mcp/tools/memory-config.js +12 -0
- package/dist/mcp/tools/memory.d.ts +92 -0
- package/dist/mcp/tools/memory.js +312 -0
- package/dist/mcp/tools/model-priority.d.ts +16 -0
- package/dist/mcp/tools/model-priority.js +87 -0
- package/dist/mcp/tools/openllm.d.ts +75 -0
- package/dist/mcp/tools/openllm.js +715 -0
- package/dist/mcp/types.d.ts +25 -0
- package/dist/mcp/types.js +7 -0
- package/dist/openapi/call.d.ts +26 -0
- package/dist/openapi/call.js +56 -0
- package/dist/openapi/index.d.ts +2 -0
- package/dist/openapi/index.js +2 -0
- package/dist/openapi/openapi.json +80213 -0
- package/dist/openapi/operations.d.ts +14 -0
- package/dist/openapi/operations.js +2060 -0
- package/dist/protocol/access.d.ts +81 -0
- package/dist/protocol/access.js +125 -0
- package/dist/protocol/agent-prompt-text.d.ts +15 -0
- package/{protocol/agent-prompt-text.ts → dist/protocol/agent-prompt-text.js} +9 -14
- package/dist/protocol/agent.d.ts +1487 -0
- package/dist/protocol/agent.js +787 -0
- package/dist/protocol/api-key-syntax.d.ts +58 -0
- package/dist/protocol/api-key-syntax.js +73 -0
- package/dist/protocol/audio.d.ts +18 -0
- package/dist/protocol/audio.js +21 -0
- package/dist/protocol/auth.d.ts +126 -0
- package/dist/protocol/auth.js +119 -0
- package/dist/protocol/changelog.d.ts +69 -0
- package/dist/protocol/changelog.js +107 -0
- package/dist/protocol/chat.d.ts +789 -0
- package/dist/protocol/chat.js +394 -0
- package/dist/protocol/client-registry.d.ts +151 -0
- package/dist/protocol/client-registry.js +238 -0
- package/dist/protocol/config.d.ts +508 -0
- package/dist/protocol/config.js +289 -0
- package/dist/protocol/control-channel.d.ts +102 -0
- package/{protocol/control-channel.ts → dist/protocol/control-channel.js} +33 -61
- package/dist/protocol/cooldown-reason.d.ts +30 -0
- package/dist/protocol/cooldown-reason.js +44 -0
- package/dist/protocol/cost.d.ts +9 -0
- package/dist/protocol/cost.js +8 -0
- package/dist/protocol/daemon-port.d.ts +2 -0
- package/dist/protocol/daemon-port.js +28 -0
- package/dist/protocol/daemon.d.ts +2034 -0
- package/dist/protocol/daemon.js +1286 -0
- package/dist/protocol/default-chains.d.ts +15 -0
- package/dist/protocol/default-chains.js +21 -0
- package/dist/protocol/device-state.d.ts +223 -0
- package/dist/protocol/device-state.js +52 -0
- package/dist/protocol/doctor-report-local.d.ts +105 -0
- package/{protocol/doctor-report-local.ts → dist/protocol/doctor-report-local.js} +92 -196
- package/dist/protocol/doctor-report-policy.d.ts +62 -0
- package/{protocol/doctor-report-policy.ts → dist/protocol/doctor-report-policy.js} +23 -76
- package/dist/protocol/doctor-report.d.ts +406 -0
- package/dist/protocol/doctor-report.js +645 -0
- package/dist/protocol/errors.d.ts +17 -0
- package/dist/protocol/errors.js +10 -0
- package/dist/protocol/execution-selection.d.ts +92 -0
- package/{protocol/execution-selection.ts → dist/protocol/execution-selection.js} +38 -63
- package/dist/protocol/hop-grant.d.ts +28 -0
- package/{protocol/hop-grant.ts → dist/protocol/hop-grant.js} +7 -13
- package/dist/protocol/image-edit-parse.d.ts +25 -0
- package/dist/protocol/image-edit-parse.js +196 -0
- package/dist/protocol/images.d.ts +288 -0
- package/dist/protocol/images.js +229 -0
- package/dist/protocol/index.d.ts +69 -0
- package/dist/protocol/index.js +74 -0
- package/dist/protocol/inference-headers.d.ts +3 -0
- package/dist/protocol/keepalive.d.ts +36 -0
- package/dist/protocol/keepalive.js +51 -0
- package/dist/protocol/local-auth.d.ts +125 -0
- package/dist/protocol/local-auth.js +227 -0
- package/dist/protocol/local-device-control.d.ts +108 -0
- package/{protocol/local-device-control.ts → dist/protocol/local-device-control.js} +40 -70
- package/dist/protocol/local-provider.d.ts +105 -0
- package/dist/protocol/local-provider.js +213 -0
- package/dist/protocol/local-session.d.ts +70 -0
- package/dist/protocol/local-session.js +87 -0
- package/dist/protocol/marketplace.d.ts +190 -0
- package/dist/protocol/marketplace.js +140 -0
- package/{protocol/media-attempt.ts → dist/protocol/media-attempt.d.ts} +11 -50
- package/dist/protocol/media-attempt.js +50 -0
- package/dist/protocol/media-bytes.d.ts +8 -0
- package/dist/protocol/media-bytes.js +21 -0
- package/dist/protocol/media-default.d.ts +56 -0
- package/dist/protocol/media-default.js +302 -0
- package/{protocol/media-dimensions.ts → dist/protocol/media-dimensions.d.ts} +11 -78
- package/dist/protocol/media-dimensions.js +90 -0
- package/dist/protocol/media-input.d.ts +20 -0
- package/dist/protocol/media-input.js +29 -0
- package/dist/protocol/media-model.d.ts +77 -0
- package/dist/protocol/media-model.js +89 -0
- package/{protocol/media-option-issue.ts → dist/protocol/media-option-issue.d.ts} +25 -53
- package/dist/protocol/media-option-issue.js +50 -0
- package/dist/protocol/media-types.d.ts +14 -0
- package/dist/protocol/media-types.js +61 -0
- package/dist/protocol/model-match.d.ts +254 -0
- package/dist/protocol/model-match.js +760 -0
- package/dist/protocol/model-settings.d.ts +153 -0
- package/dist/protocol/model-settings.js +246 -0
- package/dist/protocol/models.d.ts +1065 -0
- package/dist/protocol/models.js +638 -0
- package/dist/protocol/mux.d.ts +350 -0
- package/dist/protocol/mux.js +595 -0
- package/{protocol/plan-surface.ts → dist/protocol/plan-surface.d.ts} +12 -26
- package/dist/protocol/plan-surface.js +39 -0
- package/dist/protocol/provider-models.d.ts +8 -0
- package/{protocol/provider-models.ts → dist/protocol/provider-models.js} +7 -9
- package/dist/protocol/provider-status.d.ts +59 -0
- package/dist/protocol/provider-status.js +142 -0
- package/dist/protocol/provider-tier.d.ts +34 -0
- package/{protocol/provider-tier.ts → dist/protocol/provider-tier.js} +9 -34
- package/dist/protocol/provider-usage.d.ts +230 -0
- package/dist/protocol/provider-usage.js +214 -0
- package/dist/protocol/providers.d.ts +2496 -0
- package/dist/protocol/providers.js +723 -0
- package/dist/protocol/public-usage-index.d.ts +449 -0
- package/dist/protocol/public-usage-index.js +279 -0
- package/dist/protocol/realtime-generated.d.ts +29 -0
- package/{protocol/realtime-generated.ts → dist/protocol/realtime-generated.js} +3 -5
- package/dist/protocol/realtime.d.ts +241 -0
- package/{protocol/realtime.ts → dist/protocol/realtime.js} +88 -155
- package/dist/protocol/registry-pointer.d.ts +24 -0
- package/dist/protocol/registry-pointer.js +78 -0
- package/dist/protocol/relay.d.ts +1152 -0
- package/{protocol/relay.ts → dist/protocol/relay.js} +237 -370
- package/dist/protocol/replay-session.d.ts +4 -0
- package/{protocol/replay-session.ts → dist/protocol/replay-session.js} +1 -8
- package/dist/protocol/responses.d.ts +303 -0
- package/dist/protocol/responses.js +240 -0
- package/dist/protocol/semver.d.ts +59 -0
- package/dist/protocol/semver.js +171 -0
- package/{protocol/setup-mode.ts → dist/protocol/setup-mode.d.ts} +4 -12
- package/dist/protocol/setup-mode.js +18 -0
- package/dist/protocol/sha256-hex.d.ts +2 -0
- package/dist/protocol/sha256-hex.js +93 -0
- package/dist/protocol/stats.d.ts +711 -0
- package/dist/protocol/stats.js +353 -0
- package/dist/protocol/streaming.d.ts +16 -0
- package/dist/protocol/streaming.js +15 -0
- package/{protocol/subscription-daemon-floors.ts → dist/protocol/subscription-daemon-floors.d.ts} +8 -14
- package/dist/protocol/subscription-daemon-floors.js +4 -0
- package/dist/protocol/subscription-provider-compat.d.ts +44 -0
- package/dist/protocol/subscription-provider-compat.js +67 -0
- package/dist/protocol/subscription-provider.d.ts +15 -0
- package/dist/protocol/subscription-provider.js +17 -0
- package/dist/protocol/team-grant.d.ts +14 -0
- package/{protocol/team-grant.ts → dist/protocol/team-grant.js} +0 -3
- package/dist/protocol/team-shareable.d.ts +6 -0
- package/{protocol/team-shareable.ts → dist/protocol/team-shareable.js} +29 -33
- package/dist/protocol/transcription-encoding.d.ts +25 -0
- package/dist/protocol/transcription-encoding.js +47 -0
- package/{protocol/url-locality-dns.ts → dist/protocol/url-locality-dns.d.ts} +1 -23
- package/dist/protocol/url-locality-dns.js +33 -0
- package/dist/protocol/url-locality.d.ts +45 -0
- package/dist/protocol/url-locality.js +288 -0
- package/dist/protocol/usage-snapshots.d.ts +8 -0
- package/{protocol/usage-snapshots.ts → dist/protocol/usage-snapshots.js} +1 -2
- package/dist/protocol/vendor-cli-install.d.ts +20 -0
- package/{protocol/vendor-cli-install.ts → dist/protocol/vendor-cli-install.js} +10 -15
- package/dist/protocol/video-job-plan.d.ts +18 -0
- package/dist/protocol/video-job-plan.js +44 -0
- package/dist/protocol/videos.d.ts +107 -0
- package/dist/protocol/videos.js +154 -0
- package/dist/tunnel/channel-envelope.d.ts +53 -0
- package/dist/tunnel/channel-envelope.js +100 -0
- package/dist/tunnel/codec.d.ts +71 -0
- package/dist/tunnel/codec.js +151 -0
- package/dist/tunnel/device-anchor.d.ts +62 -0
- package/dist/tunnel/device-anchor.js +168 -0
- package/dist/tunnel/device-control.d.ts +50 -0
- package/dist/tunnel/device-control.js +88 -0
- package/dist/tunnel/device-grant.d.ts +91 -0
- package/dist/tunnel/device-grant.js +105 -0
- package/dist/tunnel/fleet.d.ts +28 -0
- package/dist/tunnel/fleet.js +41 -0
- package/dist/tunnel/index.d.ts +22 -0
- package/dist/tunnel/index.js +22 -0
- package/dist/tunnel/mux.d.ts +64 -0
- package/dist/tunnel/mux.js +449 -0
- package/dist/tunnel/peer-link.d.ts +88 -0
- package/dist/tunnel/peer-link.js +271 -0
- package/dist/tunnel/rtc-auth.d.ts +159 -0
- package/dist/tunnel/rtc-auth.js +340 -0
- package/dist/tunnel/rtc-duplex.d.ts +52 -0
- package/dist/tunnel/rtc-duplex.js +148 -0
- package/dist/tunnel/rtc-ice.d.ts +55 -0
- package/dist/tunnel/rtc-ice.js +100 -0
- package/dist/tunnel/secure.d.ts +179 -0
- package/dist/tunnel/secure.js +936 -0
- package/dist/tunnel/stream-reset-error.d.ts +6 -0
- package/dist/tunnel/stream-reset-error.js +9 -0
- package/dist/tunnel/streams.d.ts +244 -0
- package/dist/tunnel/streams.js +1071 -0
- package/dist/tunnel/team-grant.d.ts +90 -0
- package/dist/tunnel/team-grant.js +226 -0
- package/dist/tunnel/wire-bytes.d.ts +32 -0
- package/dist/tunnel/wire-bytes.js +90 -0
- package/dist/vault/api-key.d.ts +71 -0
- package/dist/vault/api-key.js +130 -0
- package/{vault/argon2.ts → dist/vault/argon2.d.ts} +18 -53
- package/dist/vault/argon2.js +82 -0
- package/dist/vault/cli-auth-seal.d.ts +35 -0
- package/dist/vault/cli-auth-seal.js +78 -0
- package/dist/vault/cred-seal.d.ts +18 -0
- package/dist/vault/cred-seal.js +86 -0
- package/dist/vault/credential.d.ts +21 -0
- package/dist/vault/credential.js +26 -0
- package/dist/vault/crypto.d.ts +51 -0
- package/dist/vault/crypto.js +156 -0
- package/dist/vault/daemon-attest.d.ts +68 -0
- package/dist/vault/daemon-attest.js +147 -0
- package/dist/vault/derive.d.ts +34 -0
- package/dist/vault/derive.js +84 -0
- package/dist/vault/device-access.d.ts +17 -0
- package/dist/vault/device-access.js +77 -0
- package/dist/vault/device-anchor.d.ts +42 -0
- package/dist/vault/device-anchor.js +90 -0
- package/dist/vault/device-control.d.ts +80 -0
- package/{vault/device-control.ts → dist/vault/device-control.js} +46 -104
- package/dist/vault/handoff.d.ts +102 -0
- package/dist/vault/handoff.js +236 -0
- package/dist/vault/index.d.ts +21 -0
- package/dist/vault/index.js +21 -0
- package/dist/vault/passkey.d.ts +82 -0
- package/{vault/passkey.ts → dist/vault/passkey.js} +63 -153
- package/dist/vault/phrase.d.ts +40 -0
- package/{vault/phrase.ts → dist/vault/phrase.js} +17 -23
- package/dist/vault/pin.d.ts +46 -0
- package/dist/vault/pin.js +92 -0
- package/dist/vault/public-key-seal.d.ts +17 -0
- package/dist/vault/public-key-seal.js +59 -0
- package/dist/vault/seed.d.ts +96 -0
- package/dist/vault/seed.js +179 -0
- package/dist/vault/team.d.ts +134 -0
- package/dist/vault/team.js +217 -0
- package/dist/vault/vault-item.d.ts +45 -0
- package/dist/vault/vault-item.js +62 -0
- package/dist/vault/vault-migrate-digest.d.ts +10 -0
- package/dist/vault/vault-migrate-digest.js +22 -0
- package/dist/vault/wrapped.d.ts +19 -0
- package/dist/vault/wrapped.js +52 -0
- package/dist/wire/adapters/messages/anthropic-map.d.ts +8 -0
- package/dist/wire/adapters/messages/anthropic-map.js +32 -0
- package/dist/wire/adapters/messages/index.d.ts +7 -0
- package/dist/wire/adapters/messages/index.js +7 -0
- package/dist/wire/adapters/messages/reasoning-from-items.d.ts +14 -0
- package/dist/wire/adapters/messages/reasoning-from-items.js +39 -0
- package/dist/wire/adapters/messages/reasoning-signature.d.ts +81 -0
- package/dist/wire/adapters/messages/reasoning-signature.js +180 -0
- package/dist/wire/adapters/messages/request.d.ts +28 -0
- package/dist/wire/adapters/messages/request.js +490 -0
- package/dist/wire/adapters/messages/response.d.ts +10 -0
- package/dist/wire/adapters/messages/response.js +177 -0
- package/dist/wire/adapters/messages/streaming.d.ts +134 -0
- package/dist/wire/adapters/messages/streaming.js +791 -0
- package/dist/wire/adapters/messages/usage.d.ts +20 -0
- package/dist/wire/adapters/messages/usage.js +10 -0
- package/dist/wire/adapters/responses/index.d.ts +3 -0
- package/dist/wire/adapters/responses/index.js +3 -0
- package/dist/wire/adapters/responses/request.d.ts +2 -0
- package/dist/wire/adapters/responses/request.js +287 -0
- package/dist/wire/adapters/responses/response.d.ts +11 -0
- package/dist/wire/adapters/responses/response.js +69 -0
- package/dist/wire/adapters/responses/streaming.d.ts +2 -0
- package/dist/wire/adapters/responses/streaming.js +267 -0
- package/dist/wire/features/account-rank.d.ts +61 -0
- package/dist/wire/features/account-rank.js +109 -0
- package/dist/wire/features/compaction/compact-request.d.ts +69 -0
- package/dist/wire/features/compaction/compact-request.js +667 -0
- package/dist/wire/features/compaction/compaction-text.d.ts +17 -0
- package/dist/wire/features/compaction/compaction-text.js +29 -0
- package/dist/wire/features/context-demote.d.ts +15 -0
- package/dist/wire/features/context-demote.js +45 -0
- package/dist/wire/features/context-overflow-strategy.d.ts +12 -0
- package/dist/wire/features/context-overflow-strategy.js +8 -0
- package/dist/wire/features/context-skip.d.ts +120 -0
- package/{wire/features/context-skip.ts → dist/wire/features/context-skip.js} +23 -57
- package/dist/wire/features/conversation-affinity.d.ts +49 -0
- package/dist/wire/features/conversation-affinity.js +121 -0
- package/dist/wire/features/max-tokens-backfill.d.ts +50 -0
- package/dist/wire/features/max-tokens-backfill.js +118 -0
- package/dist/wire/features/model-caps.d.ts +7 -0
- package/dist/wire/features/model-caps.js +40 -0
- package/dist/wire/features/model-settings.d.ts +3 -0
- package/dist/wire/features/model-settings.js +13 -0
- package/dist/wire/features/output-limit-clamp.d.ts +14 -0
- package/dist/wire/features/output-limit-clamp.js +36 -0
- package/dist/wire/features/quota-gate.d.ts +16 -0
- package/dist/wire/features/quota-gate.js +48 -0
- package/dist/wire/index.d.ts +44 -0
- package/dist/wire/index.js +44 -0
- package/dist/wire/lib/attempt-outcome.d.ts +19 -0
- package/dist/wire/lib/attempt-outcome.js +18 -0
- package/{wire/lib/canonical/content-part.ts → dist/wire/lib/canonical/content-part.d.ts} +12 -18
- package/dist/wire/lib/canonical/content-part.js +11 -0
- package/dist/wire/lib/canonical/count-tokens-capability.d.ts +52 -0
- package/dist/wire/lib/canonical/count-tokens-capability.js +109 -0
- package/{wire/lib/canonical/encoding-select.ts → dist/wire/lib/canonical/encoding-select.d.ts} +7 -24
- package/dist/wire/lib/canonical/encoding-select.js +26 -0
- package/dist/wire/lib/canonical/image-signature.d.ts +20 -0
- package/dist/wire/lib/canonical/image-signature.js +184 -0
- package/dist/wire/lib/canonical/image-sse.d.ts +88 -0
- package/dist/wire/lib/canonical/image-sse.js +173 -0
- package/{wire/lib/canonical/message.ts → dist/wire/lib/canonical/message.d.ts} +2 -20
- package/dist/wire/lib/canonical/message.js +31 -0
- package/dist/wire/lib/canonical/token-estimate.d.ts +98 -0
- package/dist/wire/lib/canonical/token-estimate.js +230 -0
- package/dist/wire/lib/encrypted-content.d.ts +22 -0
- package/dist/wire/lib/encrypted-content.js +55 -0
- package/dist/wire/lib/error-class.d.ts +57 -0
- package/dist/wire/lib/error-class.js +97 -0
- package/dist/wire/lib/error-envelope.d.ts +20 -0
- package/dist/wire/lib/error-envelope.js +53 -0
- package/dist/wire/lib/forwarded-headers.d.ts +16 -0
- package/{wire/lib/forwarded-headers.ts → dist/wire/lib/forwarded-headers.js} +62 -72
- package/dist/wire/lib/provider-error-rules.d.ts +21 -0
- package/dist/wire/lib/provider-error-rules.js +20 -0
- package/{wire/lib/refusal.ts → dist/wire/lib/refusal.d.ts} +3 -13
- package/dist/wire/lib/refusal.js +27 -0
- package/dist/wire/lib/responses-apply-patch.d.ts +57 -0
- package/dist/wire/lib/responses-apply-patch.js +81 -0
- package/dist/wire/lib/responses-namespace.d.ts +27 -0
- package/{wire/lib/responses-namespace.ts → dist/wire/lib/responses-namespace.js} +16 -32
- package/dist/wire/lib/secret-scrub.d.ts +23 -0
- package/dist/wire/lib/secret-scrub.js +72 -0
- package/dist/wire/lib/streaming/accumulate.d.ts +12 -0
- package/dist/wire/lib/streaming/accumulate.js +187 -0
- package/dist/wire/lib/streaming/finish-reason.d.ts +20 -0
- package/dist/wire/lib/streaming/finish-reason.js +15 -0
- package/{wire/lib/streaming/peek.ts → dist/wire/lib/streaming/peek.d.ts} +13 -82
- package/dist/wire/lib/streaming/peek.js +100 -0
- package/dist/wire/lib/streaming/provider-decode.d.ts +57 -0
- package/dist/wire/lib/streaming/provider-decode.js +210 -0
- package/dist/wire/lib/streaming/response-stream.d.ts +16 -0
- package/dist/wire/lib/streaming/response-stream.js +64 -0
- package/dist/wire/lib/streaming/sse.d.ts +130 -0
- package/dist/wire/lib/streaming/sse.js +600 -0
- package/dist/wire/lib/streaming/strip-tool-calls.d.ts +14 -0
- package/dist/wire/lib/streaming/strip-tool-calls.js +75 -0
- package/dist/wire/lib/streaming/upstream-error.d.ts +32 -0
- package/dist/wire/lib/streaming/upstream-error.js +45 -0
- package/dist/wire/lib/strip-subagent-isolation.d.ts +16 -0
- package/dist/wire/lib/strip-subagent-isolation.js +240 -0
- package/dist/wire/lib/thinking-signature.d.ts +56 -0
- package/{wire/lib/thinking-signature.ts → dist/wire/lib/thinking-signature.js} +77 -84
- package/dist/wire/lib/token-ruler/bpe-core.d.ts +105 -0
- package/dist/wire/lib/token-ruler/bpe-core.js +398 -0
- package/dist/wire/lib/token-ruler/index.d.ts +2 -0
- package/dist/wire/lib/token-ruler/index.js +2 -0
- package/dist/wire/lib/token-ruler/ruler.d.ts +36 -0
- package/dist/wire/lib/token-ruler/ruler.js +50 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.d.ts +14 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.js +16 -0
- package/{wire/lib/token-ruler/vocab/claude.ts → dist/wire/lib/token-ruler/vocab/claude.d.ts} +2 -12
- package/dist/wire/lib/token-ruler/vocab/claude.js +8 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.d.ts +3 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.js +18 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.d.ts +11 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.js +6 -0
- package/dist/wire/lib/tool-name-map.d.ts +44 -0
- package/dist/wire/lib/tool-name-map.js +186 -0
- package/dist/wire/lib/tool-schema.d.ts +15 -0
- package/dist/wire/lib/tool-schema.js +307 -0
- package/dist/wire/lib/usage-observer.d.ts +9 -0
- package/dist/wire/lib/usage-observer.js +108 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.d.ts +125 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.js +221 -0
- package/dist/wire/providers/anthropic/beta-headers.d.ts +44 -0
- package/{wire/providers/anthropic/beta-headers.ts → dist/wire/providers/anthropic/beta-headers.js} +57 -79
- package/dist/wire/providers/anthropic/index.d.ts +6 -0
- package/{wire/providers/anthropic/index.ts → dist/wire/providers/anthropic/index.js} +6 -6
- package/dist/wire/providers/anthropic/request.d.ts +12 -0
- package/dist/wire/providers/anthropic/request.js +456 -0
- package/dist/wire/providers/anthropic/response.d.ts +3 -0
- package/dist/wire/providers/anthropic/response.js +126 -0
- package/dist/wire/providers/anthropic/streaming.d.ts +28 -0
- package/dist/wire/providers/anthropic/streaming.js +268 -0
- package/dist/wire/providers/anthropic/web-search-domains.d.ts +7 -0
- package/dist/wire/providers/anthropic/web-search-domains.js +36 -0
- package/dist/wire/providers/chatgpt/common.d.ts +27 -0
- package/{wire/providers/chatgpt/common.ts → dist/wire/providers/chatgpt/common.js} +69 -89
- package/dist/wire/providers/chatgpt/index.d.ts +4 -0
- package/{wire/providers/chatgpt/index.ts → dist/wire/providers/chatgpt/index.js} +4 -4
- package/dist/wire/providers/chatgpt/request.d.ts +132 -0
- package/dist/wire/providers/chatgpt/request.js +696 -0
- package/dist/wire/providers/chatgpt/streaming.d.ts +69 -0
- package/dist/wire/providers/chatgpt/streaming.js +761 -0
- package/dist/wire/providers/chatgpt/web-search.d.ts +19 -0
- package/dist/wire/providers/chatgpt/web-search.js +55 -0
- package/dist/wire/providers/grok/web-search.d.ts +23 -0
- package/dist/wire/providers/grok/web-search.js +74 -0
- package/dist/wire/providers/kimi/web-search.d.ts +48 -0
- package/dist/wire/providers/kimi/web-search.js +106 -0
- package/dist/wire/providers/upstream-deny.d.ts +61 -0
- package/dist/wire/providers/upstream-deny.js +293 -0
- package/dist/wire/providers/upstream-request.d.ts +104 -0
- package/dist/wire/providers/upstream-request.js +411 -0
- package/package.json +105 -23
- package/ARCHITECTURE.md +0 -43
- package/client/chat.ts +0 -140
- package/client/devices.ts +0 -269
- package/client/http.ts +0 -72
- package/client/index.ts +0 -129
- package/client/relay-mux.ts +0 -547
- package/client/types.ts +0 -51
- package/client/vault.ts +0 -239
- package/connect/chat.ts +0 -58
- package/connect/client.ts +0 -240
- package/connect/config.ts +0 -47
- package/connect/errors.ts +0 -121
- package/connect/oauth.ts +0 -265
- package/connect/routes.ts +0 -234
- package/connect/store.ts +0 -107
- package/mcp/handle.ts +0 -24
- package/mcp/index.ts +0 -76
- package/mcp/server.ts +0 -319
- package/mcp/tools/marketplace.ts +0 -439
- package/mcp/tools/memory-client.ts +0 -297
- package/mcp/tools/memory-config.ts +0 -32
- package/mcp/tools/memory.ts +0 -369
- package/mcp/tools/model-priority.ts +0 -88
- package/mcp/tools/openllm.ts +0 -883
- package/mcp/types.ts +0 -28
- package/openapi/call.ts +0 -90
- package/openapi/index.ts +0 -8
- package/openapi/openapi.json +0 -80213
- package/openapi/operations.ts +0 -2075
- package/protocol/CONTRIBUTING.md +0 -21
- package/protocol/README.md +0 -134
- package/protocol/access.ts +0 -186
- package/protocol/agent.ts +0 -991
- package/protocol/api-key-syntax.ts +0 -105
- package/protocol/assets/openllm-light.svg +0 -18
- package/protocol/assets/openllm.svg +0 -18
- package/protocol/audio.ts +0 -29
- package/protocol/auth.ts +0 -142
- package/protocol/changelog.ts +0 -155
- package/protocol/chat.ts +0 -458
- package/protocol/client-registry.ts +0 -356
- package/protocol/config.ts +0 -345
- package/protocol/cooldown-reason.ts +0 -78
- package/protocol/cost.ts +0 -10
- package/protocol/daemon-port.ts +0 -31
- package/protocol/daemon.ts +0 -1524
- package/protocol/default-chains.ts +0 -66
- package/protocol/device-state.ts +0 -85
- package/protocol/doctor-report.ts +0 -947
- package/protocol/errors.ts +0 -14
- package/protocol/image-edit-parse.ts +0 -263
- package/protocol/images.ts +0 -298
- package/protocol/index.ts +0 -74
- package/protocol/keepalive.ts +0 -69
- package/protocol/local-auth.ts +0 -300
- package/protocol/local-provider.ts +0 -288
- package/protocol/local-session.ts +0 -118
- package/protocol/marketplace.ts +0 -187
- package/protocol/media-bytes.ts +0 -28
- package/protocol/media-default.ts +0 -357
- package/protocol/media-input.ts +0 -61
- package/protocol/media-model.ts +0 -142
- package/protocol/media-types.ts +0 -70
- package/protocol/model-match.ts +0 -1051
- package/protocol/model-settings.ts +0 -327
- package/protocol/models.ts +0 -767
- package/protocol/mux.ts +0 -722
- package/protocol/provider-status.ts +0 -206
- package/protocol/provider-usage.ts +0 -263
- package/protocol/providers.ts +0 -901
- package/protocol/public-usage-index.ts +0 -354
- package/protocol/registry-pointer.ts +0 -118
- package/protocol/responses.ts +0 -280
- package/protocol/semver.ts +0 -182
- package/protocol/sha256-hex.ts +0 -98
- package/protocol/stats.ts +0 -406
- package/protocol/streaming.ts +0 -19
- package/protocol/subscription-provider-compat.ts +0 -104
- package/protocol/subscription-provider.ts +0 -32
- package/protocol/transcription-encoding.ts +0 -76
- package/protocol/url-locality.ts +0 -288
- package/protocol/video-job-plan.ts +0 -50
- package/protocol/videos.ts +0 -227
- package/tsconfig.json +0 -14
- package/tunnel/ARCHITECTURE.md +0 -111
- package/tunnel/assets/openllm-light.svg +0 -18
- package/tunnel/assets/openllm.svg +0 -18
- package/tunnel/channel-envelope.ts +0 -139
- package/tunnel/codec.ts +0 -191
- package/tunnel/device-anchor.ts +0 -229
- package/tunnel/device-control.ts +0 -118
- package/tunnel/device-grant.ts +0 -173
- package/tunnel/fleet.ts +0 -77
- package/tunnel/index.ts +0 -22
- package/tunnel/mux.ts +0 -580
- package/tunnel/peer-link.ts +0 -390
- package/tunnel/rtc-auth.ts +0 -415
- package/tunnel/rtc-duplex.ts +0 -187
- package/tunnel/rtc-ice.ts +0 -136
- package/tunnel/secure.ts +0 -1298
- package/tunnel/stream-reset-error.ts +0 -14
- package/tunnel/streams.ts +0 -1430
- package/tunnel/team-grant.ts +0 -302
- package/tunnel/wire-bytes.ts +0 -102
- package/vault/ARCHITECTURE.md +0 -470
- package/vault/api-key.ts +0 -190
- package/vault/cli-auth-seal.ts +0 -157
- package/vault/cred-seal.ts +0 -146
- package/vault/credential.ts +0 -55
- package/vault/crypto.ts +0 -210
- package/vault/daemon-attest.ts +0 -229
- package/vault/derive.ts +0 -113
- package/vault/device-access.ts +0 -87
- package/vault/device-anchor.ts +0 -185
- package/vault/handoff.ts +0 -396
- package/vault/index.ts +0 -21
- package/vault/pin.ts +0 -153
- package/vault/public-key-seal.ts +0 -131
- package/vault/seed.ts +0 -272
- package/vault/team.ts +0 -355
- package/vault/vault-item.ts +0 -131
- package/vault/vault-migrate-digest.ts +0 -29
- package/vault/wrapped.ts +0 -77
- package/wire/ARCHITECTURE.md +0 -90
- package/wire/CONTRIBUTING.md +0 -19
- package/wire/adapters/messages/anthropic-map.ts +0 -37
- package/wire/adapters/messages/index.ts +0 -7
- package/wire/adapters/messages/reasoning-from-items.ts +0 -38
- package/wire/adapters/messages/reasoning-signature.ts +0 -243
- package/wire/adapters/messages/request.ts +0 -574
- package/wire/adapters/messages/response.ts +0 -215
- package/wire/adapters/messages/streaming.ts +0 -1027
- package/wire/adapters/messages/usage.ts +0 -43
- package/wire/adapters/responses/index.ts +0 -3
- package/wire/adapters/responses/request.ts +0 -395
- package/wire/adapters/responses/response.ts +0 -88
- package/wire/adapters/responses/streaming.ts +0 -344
- package/wire/assets/openllm-light.svg +0 -18
- package/wire/assets/openllm.svg +0 -18
- package/wire/features/account-rank.ts +0 -166
- package/wire/features/compaction/compact-request.ts +0 -862
- package/wire/features/compaction/compaction-text.ts +0 -43
- package/wire/features/context-demote.ts +0 -47
- package/wire/features/context-overflow-strategy.ts +0 -26
- package/wire/features/conversation-affinity.ts +0 -144
- package/wire/features/max-tokens-backfill.ts +0 -141
- package/wire/features/model-caps.ts +0 -53
- package/wire/features/model-settings.ts +0 -24
- package/wire/features/output-limit-clamp.ts +0 -64
- package/wire/features/quota-gate.ts +0 -85
- package/wire/index.ts +0 -44
- package/wire/lib/attempt-outcome.ts +0 -43
- package/wire/lib/canonical/count-tokens-capability.ts +0 -138
- package/wire/lib/canonical/image-signature.ts +0 -202
- package/wire/lib/canonical/image-sse.ts +0 -216
- package/wire/lib/canonical/token-estimate.ts +0 -266
- package/wire/lib/encrypted-content.ts +0 -66
- package/wire/lib/error-class.ts +0 -154
- package/wire/lib/error-envelope.ts +0 -56
- package/wire/lib/provider-error-rules.ts +0 -48
- package/wire/lib/responses-apply-patch.ts +0 -104
- package/wire/lib/secret-scrub.ts +0 -101
- package/wire/lib/streaming/accumulate.ts +0 -221
- package/wire/lib/streaming/finish-reason.ts +0 -33
- package/wire/lib/streaming/provider-decode.ts +0 -259
- package/wire/lib/streaming/response-stream.ts +0 -71
- package/wire/lib/streaming/sse.ts +0 -699
- package/wire/lib/streaming/strip-tool-calls.ts +0 -95
- package/wire/lib/streaming/upstream-error.ts +0 -58
- package/wire/lib/strip-subagent-isolation.ts +0 -284
- package/wire/lib/token-ruler/bpe-core.ts +0 -426
- package/wire/lib/token-ruler/index.ts +0 -2
- package/wire/lib/token-ruler/ruler.ts +0 -79
- package/wire/lib/token-ruler/vocab/claude-ranks.ts +0 -16
- package/wire/lib/token-ruler/vocab/o200k-ranks.ts +0 -18
- package/wire/lib/token-ruler/vocab/o200k.ts +0 -19
- package/wire/lib/tool-name-map.ts +0 -271
- package/wire/lib/tool-schema.ts +0 -353
- package/wire/lib/usage-observer.ts +0 -125
- package/wire/providers/anthropic/adaptive-thinking.ts +0 -291
- package/wire/providers/anthropic/request.ts +0 -607
- package/wire/providers/anthropic/response.ts +0 -155
- package/wire/providers/anthropic/streaming.ts +0 -315
- package/wire/providers/anthropic/web-search-domains.ts +0 -49
- package/wire/providers/chatgpt/request.ts +0 -959
- package/wire/providers/chatgpt/streaming.ts +0 -1007
- package/wire/providers/chatgpt/web-search.ts +0 -63
- package/wire/providers/grok/web-search.ts +0 -87
- package/wire/providers/kimi/web-search.ts +0 -145
- package/wire/providers/upstream-deny.ts +0 -355
- package/wire/providers/upstream-request.ts +0 -619
- /package/{protocol/inference-headers.ts → dist/protocol/inference-headers.js} +0 -0
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The P1 mux wire codec. This module is dependency-free by design so the
|
|
3
|
+
* relay can validate and forward a frame without learning its payload shape.
|
|
4
|
+
*/
|
|
5
|
+
export const FRAME_HEADER_BYTES = 9;
|
|
6
|
+
export const MAX_PAYLOAD_BYTES = 256 * 1024;
|
|
7
|
+
/**
|
|
8
|
+
* Implicit per-stream credit at OPEN on every peer. Frozen for skew-safety —
|
|
9
|
+
* never raise this unilaterally. Newer peers advertise extra credit with an
|
|
10
|
+
* immediate WINDOW after OPEN ({@link STREAM_WINDOW_BOOST_BYTES}).
|
|
11
|
+
*/
|
|
12
|
+
export const INITIAL_STREAM_WINDOW_BYTES = 256 * 1024;
|
|
13
|
+
/**
|
|
14
|
+
* Extra receive credit granted right after OPEN via a WINDOW frame. Old peers
|
|
15
|
+
* accept the WINDOW (additive sendCredit); new peers start receiveCredit at
|
|
16
|
+
* {@link TARGET_STREAM_WINDOW_BYTES}. Total target window = initial + boost.
|
|
17
|
+
*/
|
|
18
|
+
export const STREAM_WINDOW_BOOST_BYTES = 768 * 1024;
|
|
19
|
+
/** Effective receive window on peers that send the post-OPEN boost. */
|
|
20
|
+
export const TARGET_STREAM_WINDOW_BYTES = INITIAL_STREAM_WINDOW_BYTES + STREAM_WINDOW_BOOST_BYTES;
|
|
21
|
+
/**
|
|
22
|
+
* Emit WINDOW once this many bytes have been consumed since the last grant.
|
|
23
|
+
* Lower than half the initial window so high-RTT paths replenish sooner.
|
|
24
|
+
*/
|
|
25
|
+
export const WINDOW_REPLENISH_THRESHOLD = 64 * 1024;
|
|
26
|
+
export const STREAM_ID_CTRL = 0;
|
|
27
|
+
export const MAX_STREAM_ID = 0xffff_ffff;
|
|
28
|
+
export const FRAME_TYPE = {
|
|
29
|
+
open: 0x01,
|
|
30
|
+
data: 0x02,
|
|
31
|
+
end: 0x03,
|
|
32
|
+
reset: 0x04,
|
|
33
|
+
window: 0x05,
|
|
34
|
+
ctrl: 0x06,
|
|
35
|
+
};
|
|
36
|
+
const encoder = new TextEncoder();
|
|
37
|
+
const decoder = new TextDecoder();
|
|
38
|
+
export const isKnownFrameType = (value) => value === FRAME_TYPE.open ||
|
|
39
|
+
value === FRAME_TYPE.data ||
|
|
40
|
+
value === FRAME_TYPE.end ||
|
|
41
|
+
value === FRAME_TYPE.reset ||
|
|
42
|
+
value === FRAME_TYPE.window ||
|
|
43
|
+
value === FRAME_TYPE.ctrl;
|
|
44
|
+
export const isConsumerStreamId = (streamId) => Number.isInteger(streamId) &&
|
|
45
|
+
streamId > 0 &&
|
|
46
|
+
streamId <= MAX_STREAM_ID &&
|
|
47
|
+
streamId % 2 === 1;
|
|
48
|
+
const isUint32 = (value) => Number.isInteger(value) && value >= 0 && value <= MAX_STREAM_ID;
|
|
49
|
+
/** Return the fixed header without allocating a payload view. */
|
|
50
|
+
export const peekFrameHeader = (bytes) => {
|
|
51
|
+
if (bytes.byteLength < FRAME_HEADER_BYTES)
|
|
52
|
+
return null;
|
|
53
|
+
const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
|
|
54
|
+
return {
|
|
55
|
+
type: bytes[0],
|
|
56
|
+
streamId: view.getUint32(1, false),
|
|
57
|
+
length: view.getUint32(5, false),
|
|
58
|
+
};
|
|
59
|
+
};
|
|
60
|
+
/** Encode one whole WebSocket message. Caller contract violations throw RangeError. */
|
|
61
|
+
export const encodeFrame = (frame) => {
|
|
62
|
+
if (!isKnownFrameType(frame.type))
|
|
63
|
+
throw new RangeError("unknown frame type");
|
|
64
|
+
if (!isUint32(frame.streamId))
|
|
65
|
+
throw new RangeError("stream id must be a u32");
|
|
66
|
+
if (frame.payload.byteLength > MAX_PAYLOAD_BYTES) {
|
|
67
|
+
throw new RangeError("payload exceeds MAX_PAYLOAD_BYTES");
|
|
68
|
+
}
|
|
69
|
+
const encoded = new Uint8Array(FRAME_HEADER_BYTES + frame.payload.byteLength);
|
|
70
|
+
const view = new DataView(encoded.buffer, encoded.byteOffset, encoded.byteLength);
|
|
71
|
+
encoded[0] = frame.type;
|
|
72
|
+
view.setUint32(1, frame.streamId, false);
|
|
73
|
+
view.setUint32(5, frame.payload.byteLength, false);
|
|
74
|
+
encoded.set(frame.payload, FRAME_HEADER_BYTES);
|
|
75
|
+
return encoded;
|
|
76
|
+
};
|
|
77
|
+
/**
|
|
78
|
+
* Cheap mux-frame shape check (header type / length / payload cap) without
|
|
79
|
+
* allocating a {@link TFrame}. Used by the blind relay forward path.
|
|
80
|
+
*/
|
|
81
|
+
export const isValidMuxFrame = (bytes) => {
|
|
82
|
+
const header = peekFrameHeader(bytes);
|
|
83
|
+
if (header === null)
|
|
84
|
+
return false;
|
|
85
|
+
if (!isKnownFrameType(header.type))
|
|
86
|
+
return false;
|
|
87
|
+
if (header.length > MAX_PAYLOAD_BYTES)
|
|
88
|
+
return false;
|
|
89
|
+
return header.length === bytes.byteLength - FRAME_HEADER_BYTES;
|
|
90
|
+
};
|
|
91
|
+
/** Decode one whole message. Never throws and never allocates from a claimed length. */
|
|
92
|
+
export const decodeFrame = (bytes) => {
|
|
93
|
+
const header = peekFrameHeader(bytes);
|
|
94
|
+
if (header === null)
|
|
95
|
+
return { ok: false, error: "truncated_header" };
|
|
96
|
+
if (!isKnownFrameType(header.type)) {
|
|
97
|
+
return { ok: false, error: "unknown_frame_type" };
|
|
98
|
+
}
|
|
99
|
+
if (header.length > MAX_PAYLOAD_BYTES) {
|
|
100
|
+
return { ok: false, error: "payload_too_large" };
|
|
101
|
+
}
|
|
102
|
+
if (header.length !== bytes.byteLength - FRAME_HEADER_BYTES) {
|
|
103
|
+
return { ok: false, error: "length_mismatch" };
|
|
104
|
+
}
|
|
105
|
+
return {
|
|
106
|
+
ok: true,
|
|
107
|
+
frame: {
|
|
108
|
+
type: header.type,
|
|
109
|
+
streamId: header.streamId,
|
|
110
|
+
payload: bytes.subarray(FRAME_HEADER_BYTES),
|
|
111
|
+
},
|
|
112
|
+
};
|
|
113
|
+
};
|
|
114
|
+
export const windowPayload = (delta) => {
|
|
115
|
+
if (!isUint32(delta))
|
|
116
|
+
throw new RangeError("window delta must be a u32");
|
|
117
|
+
const payload = new Uint8Array(4);
|
|
118
|
+
new DataView(payload.buffer).setUint32(0, delta, false);
|
|
119
|
+
return payload;
|
|
120
|
+
};
|
|
121
|
+
export const decodeWindowPayload = (payload) => {
|
|
122
|
+
if (payload.byteLength !== 4)
|
|
123
|
+
return null;
|
|
124
|
+
return new DataView(payload.buffer, payload.byteOffset, payload.byteLength).getUint32(0, false);
|
|
125
|
+
};
|
|
126
|
+
export const encodeJsonPayload = (value) => {
|
|
127
|
+
let text;
|
|
128
|
+
try {
|
|
129
|
+
text = JSON.stringify(value);
|
|
130
|
+
}
|
|
131
|
+
catch {
|
|
132
|
+
throw new RangeError("value is not JSON serializable");
|
|
133
|
+
}
|
|
134
|
+
if (text === undefined)
|
|
135
|
+
throw new RangeError("value is not JSON serializable");
|
|
136
|
+
const payload = encoder.encode(text);
|
|
137
|
+
if (payload.byteLength > MAX_PAYLOAD_BYTES) {
|
|
138
|
+
throw new RangeError("JSON payload exceeds MAX_PAYLOAD_BYTES");
|
|
139
|
+
}
|
|
140
|
+
return payload;
|
|
141
|
+
};
|
|
142
|
+
export const decodeJsonPayload = (payload) => {
|
|
143
|
+
if (payload.byteLength > MAX_PAYLOAD_BYTES)
|
|
144
|
+
return undefined;
|
|
145
|
+
try {
|
|
146
|
+
return JSON.parse(decoder.decode(payload));
|
|
147
|
+
}
|
|
148
|
+
catch {
|
|
149
|
+
return undefined;
|
|
150
|
+
}
|
|
151
|
+
};
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/** HKDF info for the per-key pair secret. */
|
|
2
|
+
export declare const DEVICE_PAIR_HKDF_INFO = "openllm-pair-v1";
|
|
3
|
+
/** Raw bytes in an anchor: control pubkey (32) || pair secret (32). */
|
|
4
|
+
export declare const DEVICE_ANCHOR_BYTES = 64;
|
|
5
|
+
export declare const DEVICE_ANCHOR_LENGTH = 86;
|
|
6
|
+
export declare const DEVICE_PAIR_SECRET_BYTES = 32;
|
|
7
|
+
/** Domain label of the dpk proof MAC input. */
|
|
8
|
+
export declare const DPK_PROOF_LABEL = "openllm-dpk-proof-v1";
|
|
9
|
+
/** base64url of a 32-byte HMAC-SHA256. */
|
|
10
|
+
export declare const DPK_PROOF_LENGTH = 43;
|
|
11
|
+
/** base64url, unpadded. */
|
|
12
|
+
export declare const toB64UrlBytes: (bytes: Uint8Array) => string;
|
|
13
|
+
/** Strict unpadded base64url → bytes; null on any foreign character. */
|
|
14
|
+
export declare const fromB64UrlBytes: (value: string) => Uint8Array | null;
|
|
15
|
+
/** Ed25519 raw (32 bytes) → base64(SPKI DER), the form daemons pin. */
|
|
16
|
+
export declare const ed25519SpkiB64FromRaw: (raw: Uint8Array) => string;
|
|
17
|
+
export type TDeviceAnchor = {
|
|
18
|
+
/** The account control public key, base64(SPKI DER). */
|
|
19
|
+
readonly controlPubkey: string;
|
|
20
|
+
/** `HKDF(control seed, utf8(key_id), "openllm-pair-v1")`, 32 bytes. */
|
|
21
|
+
readonly pairSecret: Uint8Array;
|
|
22
|
+
};
|
|
23
|
+
/** `base64url(control raw || pair secret)`. */
|
|
24
|
+
export declare const encodeDeviceAnchor: (controlPubkeyRaw: Uint8Array, pairSecret: Uint8Array) => string;
|
|
25
|
+
/** Decode an anchor; null unless exactly 86 base64url chars of 64 bytes. */
|
|
26
|
+
export declare const decodeDeviceAnchor: (anchor: string) => TDeviceAnchor | null;
|
|
27
|
+
/**
|
|
28
|
+
* MAC input of the dpk proof:
|
|
29
|
+
* `utf8("openllm-dpk-proof-v1") || utf8(key_id) || utf8(dpk)` — plain
|
|
30
|
+
* concatenation, unambiguous because `key_id` is the fixed-length (14 char)
|
|
31
|
+
* api key id. `dpk` is the daemon's X25519 SPKI DER, base64 — exactly
|
|
32
|
+
* `DaemonStatus.pubkey`.
|
|
33
|
+
*/
|
|
34
|
+
export declare const buildDpkProofMessage: (keyId: string, dpk: string) => Uint8Array;
|
|
35
|
+
/** True when `proof` has the shape of a dpk proof (43 base64url chars). */
|
|
36
|
+
export declare const isDpkProofSyntax: (proof: string) => boolean;
|
|
37
|
+
/** Domain label of the signed device-sessions disable. */
|
|
38
|
+
export declare const DEVICE_SESSIONS_DISABLE_LABEL = "openllm-device-sessions-disable-v1";
|
|
39
|
+
export declare const DEVICE_SESSIONS_DISABLE_VERSION: 1;
|
|
40
|
+
/** A disable older (or further in the future) than this is refused. */
|
|
41
|
+
export declare const DEVICE_SESSIONS_DISABLE_TS_WINDOW_MS: number;
|
|
42
|
+
export declare const DEVICE_SESSIONS_DISABLE_B64_MAX = 1024;
|
|
43
|
+
export type TDeviceSessionsDisableFields = {
|
|
44
|
+
readonly v: 1;
|
|
45
|
+
/** The target daemon's api key id — a command for another key is refused. */
|
|
46
|
+
readonly key_id: string;
|
|
47
|
+
/** ms since epoch; must be fresh. */
|
|
48
|
+
readonly ts: number;
|
|
49
|
+
/** 16 random bytes, base64url — makes every statement unique. */
|
|
50
|
+
readonly nonce: string;
|
|
51
|
+
};
|
|
52
|
+
export type TDeviceSessionsDisableEnvelope = TDeviceSessionsDisableFields & {
|
|
53
|
+
/** Ed25519 signature by the control key, base64. */
|
|
54
|
+
readonly sig: string;
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`, fixed key
|
|
58
|
+
* order `v, key_id, ts, nonce`. Disable-only — there is no enable field.
|
|
59
|
+
*/
|
|
60
|
+
export declare const buildDeviceSessionsDisableMessage: (fields: TDeviceSessionsDisableFields) => Uint8Array;
|
|
61
|
+
export declare const encodeDeviceSessionsDisable: (envelope: TDeviceSessionsDisableEnvelope) => string;
|
|
62
|
+
export declare const decodeDeviceSessionsDisable: (b64: string) => TDeviceSessionsDisableEnvelope | null;
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Device trust anchor + daemon-key proof — the wire formats only. Bytes +
|
|
3
|
+
* JSON, no crypto: the browser computes with WebCrypto (`@openllmsh/sdk/vault`
|
|
4
|
+
* `device-anchor.ts`), the daemon with node:crypto
|
|
5
|
+
* (`packages/cli/daemon/src/device-anchor.ts`).
|
|
6
|
+
*
|
|
7
|
+
* - **Anchor** = base64url(control pubkey raw 32 || pair_secret 32), where
|
|
8
|
+
* `pair_secret = HKDF-SHA256(ikm = control seed, salt = utf8(key_id),
|
|
9
|
+
* info = "openllm-pair-v1", 32)`. It rides the install / setup command as a
|
|
10
|
+
* suffix of the API key (`sk-llm-<id>.<secret>.<anchor>`) and NEVER leaves
|
|
11
|
+
* the device: the daemon splits it off and keeps it in the runtime env file.
|
|
12
|
+
* - **dpk proof** = `HMAC-SHA256(pair_secret, "openllm-dpk-proof-v1" ||
|
|
13
|
+
* key_id || dpk)`, base64url. The daemon publishes it in its status; any browser
|
|
14
|
+
* holding the control seed recomputes `pair_secret` and verifies it, so the
|
|
15
|
+
* daemon's static X25519 key is trusted without a first-use window.
|
|
16
|
+
*
|
|
17
|
+
* Device sessions on == the anchor is present. Re-enable is install / update /
|
|
18
|
+
* login / desktop with the sessions toggle on. The only remote control is a
|
|
19
|
+
* signed **disable** (strips the anchor); a compromised cloud cannot forge it.
|
|
20
|
+
*/
|
|
21
|
+
import { isOpenllmDeviceAnchorSyntax, OPENLLM_DEVICE_ANCHOR_LENGTH, } from "@openllmsh/sdk/protocol";
|
|
22
|
+
import { decodeB64Json, encodeB64Json, labelledMessage, toB64Bytes, } from "./wire-bytes.js";
|
|
23
|
+
/** HKDF info for the per-key pair secret. */
|
|
24
|
+
export const DEVICE_PAIR_HKDF_INFO = "openllm-pair-v1";
|
|
25
|
+
/** Raw bytes in an anchor: control pubkey (32) || pair secret (32). */
|
|
26
|
+
export const DEVICE_ANCHOR_BYTES = 64;
|
|
27
|
+
export const DEVICE_ANCHOR_LENGTH = OPENLLM_DEVICE_ANCHOR_LENGTH;
|
|
28
|
+
export const DEVICE_PAIR_SECRET_BYTES = 32;
|
|
29
|
+
const ED25519_RAW_BYTES = 32;
|
|
30
|
+
/** Domain label of the dpk proof MAC input. */
|
|
31
|
+
export const DPK_PROOF_LABEL = "openllm-dpk-proof-v1";
|
|
32
|
+
/** base64url of a 32-byte HMAC-SHA256. */
|
|
33
|
+
export const DPK_PROOF_LENGTH = 43;
|
|
34
|
+
/** DER SPKI prefix of an Ed25519 public key. */
|
|
35
|
+
const ED25519_SPKI_PREFIX = new Uint8Array([
|
|
36
|
+
0x30, 0x2a, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x03, 0x21, 0x00,
|
|
37
|
+
]);
|
|
38
|
+
const B64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
|
|
39
|
+
/** base64url, unpadded. */
|
|
40
|
+
export const toB64UrlBytes = (bytes) => toB64Bytes(bytes).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
|
|
41
|
+
/** Strict unpadded base64url → bytes; null on any foreign character. */
|
|
42
|
+
export const fromB64UrlBytes = (value) => {
|
|
43
|
+
for (const ch of value) {
|
|
44
|
+
if (!B64URL_ALPHABET.includes(ch))
|
|
45
|
+
return null;
|
|
46
|
+
}
|
|
47
|
+
if (value.length % 4 === 1)
|
|
48
|
+
return null;
|
|
49
|
+
const padded = value.replace(/-/g, "+").replace(/_/g, "/") +
|
|
50
|
+
"=".repeat((4 - (value.length % 4)) % 4);
|
|
51
|
+
try {
|
|
52
|
+
const bin = atob(padded);
|
|
53
|
+
const out = new Uint8Array(bin.length);
|
|
54
|
+
for (let i = 0; i < bin.length; i++)
|
|
55
|
+
out[i] = bin.charCodeAt(i);
|
|
56
|
+
return out;
|
|
57
|
+
}
|
|
58
|
+
catch {
|
|
59
|
+
return null;
|
|
60
|
+
}
|
|
61
|
+
};
|
|
62
|
+
/** Ed25519 raw (32 bytes) → base64(SPKI DER), the form daemons pin. */
|
|
63
|
+
export const ed25519SpkiB64FromRaw = (raw) => {
|
|
64
|
+
if (raw.length !== ED25519_RAW_BYTES) {
|
|
65
|
+
throw new RangeError("ed25519 raw public key must be 32 bytes");
|
|
66
|
+
}
|
|
67
|
+
const spki = new Uint8Array(ED25519_SPKI_PREFIX.length + raw.length);
|
|
68
|
+
spki.set(ED25519_SPKI_PREFIX, 0);
|
|
69
|
+
spki.set(raw, ED25519_SPKI_PREFIX.length);
|
|
70
|
+
return toB64Bytes(spki);
|
|
71
|
+
};
|
|
72
|
+
/** `base64url(control raw || pair secret)`. */
|
|
73
|
+
export const encodeDeviceAnchor = (controlPubkeyRaw, pairSecret) => {
|
|
74
|
+
if (controlPubkeyRaw.length !== ED25519_RAW_BYTES) {
|
|
75
|
+
throw new RangeError("anchor control key must be 32 raw bytes");
|
|
76
|
+
}
|
|
77
|
+
if (pairSecret.length !== DEVICE_PAIR_SECRET_BYTES) {
|
|
78
|
+
throw new RangeError("anchor pair secret must be 32 bytes");
|
|
79
|
+
}
|
|
80
|
+
const bytes = new Uint8Array(DEVICE_ANCHOR_BYTES);
|
|
81
|
+
bytes.set(controlPubkeyRaw, 0);
|
|
82
|
+
bytes.set(pairSecret, ED25519_RAW_BYTES);
|
|
83
|
+
return toB64UrlBytes(bytes);
|
|
84
|
+
};
|
|
85
|
+
/** Decode an anchor; null unless exactly 86 base64url chars of 64 bytes. */
|
|
86
|
+
export const decodeDeviceAnchor = (anchor) => {
|
|
87
|
+
if (!isOpenllmDeviceAnchorSyntax(anchor))
|
|
88
|
+
return null;
|
|
89
|
+
const bytes = fromB64UrlBytes(anchor);
|
|
90
|
+
if (bytes === null || bytes.length !== DEVICE_ANCHOR_BYTES)
|
|
91
|
+
return null;
|
|
92
|
+
return {
|
|
93
|
+
controlPubkey: ed25519SpkiB64FromRaw(bytes.slice(0, ED25519_RAW_BYTES)),
|
|
94
|
+
pairSecret: bytes.slice(ED25519_RAW_BYTES),
|
|
95
|
+
};
|
|
96
|
+
};
|
|
97
|
+
/**
|
|
98
|
+
* MAC input of the dpk proof:
|
|
99
|
+
* `utf8("openllm-dpk-proof-v1") || utf8(key_id) || utf8(dpk)` — plain
|
|
100
|
+
* concatenation, unambiguous because `key_id` is the fixed-length (14 char)
|
|
101
|
+
* api key id. `dpk` is the daemon's X25519 SPKI DER, base64 — exactly
|
|
102
|
+
* `DaemonStatus.pubkey`.
|
|
103
|
+
*/
|
|
104
|
+
export const buildDpkProofMessage = (keyId, dpk) => {
|
|
105
|
+
const enc = new TextEncoder();
|
|
106
|
+
const label = enc.encode(DPK_PROOF_LABEL);
|
|
107
|
+
const kid = enc.encode(keyId);
|
|
108
|
+
const key = enc.encode(dpk);
|
|
109
|
+
const out = new Uint8Array(label.length + kid.length + key.length);
|
|
110
|
+
out.set(label, 0);
|
|
111
|
+
out.set(kid, label.length);
|
|
112
|
+
out.set(key, label.length + kid.length);
|
|
113
|
+
return out;
|
|
114
|
+
};
|
|
115
|
+
/** True when `proof` has the shape of a dpk proof (43 base64url chars). */
|
|
116
|
+
export const isDpkProofSyntax = (proof) => proof.length === DPK_PROOF_LENGTH && fromB64UrlBytes(proof)?.length === 32;
|
|
117
|
+
/** Domain label of the signed device-sessions disable. */
|
|
118
|
+
export const DEVICE_SESSIONS_DISABLE_LABEL = "openllm-device-sessions-disable-v1";
|
|
119
|
+
export const DEVICE_SESSIONS_DISABLE_VERSION = 1;
|
|
120
|
+
/** A disable older (or further in the future) than this is refused. */
|
|
121
|
+
export const DEVICE_SESSIONS_DISABLE_TS_WINDOW_MS = 5 * 60 * 1000;
|
|
122
|
+
export const DEVICE_SESSIONS_DISABLE_B64_MAX = 1024;
|
|
123
|
+
/**
|
|
124
|
+
* Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`, fixed key
|
|
125
|
+
* order `v, key_id, ts, nonce`. Disable-only — there is no enable field.
|
|
126
|
+
*/
|
|
127
|
+
export const buildDeviceSessionsDisableMessage = (fields) => labelledMessage(DEVICE_SESSIONS_DISABLE_LABEL, JSON.stringify({
|
|
128
|
+
v: fields.v,
|
|
129
|
+
key_id: fields.key_id,
|
|
130
|
+
ts: fields.ts,
|
|
131
|
+
nonce: fields.nonce,
|
|
132
|
+
}));
|
|
133
|
+
export const encodeDeviceSessionsDisable = (envelope) => encodeB64Json({
|
|
134
|
+
v: envelope.v,
|
|
135
|
+
key_id: envelope.key_id,
|
|
136
|
+
ts: envelope.ts,
|
|
137
|
+
nonce: envelope.nonce,
|
|
138
|
+
sig: envelope.sig,
|
|
139
|
+
}, DEVICE_SESSIONS_DISABLE_B64_MAX, "device sessions disable exceeds its wire cap");
|
|
140
|
+
export const decodeDeviceSessionsDisable = (b64) => {
|
|
141
|
+
const o = decodeB64Json(b64, DEVICE_SESSIONS_DISABLE_B64_MAX);
|
|
142
|
+
if (o === null)
|
|
143
|
+
return null;
|
|
144
|
+
if (o.v !== DEVICE_SESSIONS_DISABLE_VERSION)
|
|
145
|
+
return null;
|
|
146
|
+
if (typeof o.key_id !== "string" || o.key_id.length === 0)
|
|
147
|
+
return null;
|
|
148
|
+
if (typeof o.ts !== "number" ||
|
|
149
|
+
!Number.isInteger(o.ts) ||
|
|
150
|
+
!Number.isFinite(o.ts) ||
|
|
151
|
+
o.ts <= 0) {
|
|
152
|
+
return null;
|
|
153
|
+
}
|
|
154
|
+
if (typeof o.nonce !== "string" || o.nonce.length === 0)
|
|
155
|
+
return null;
|
|
156
|
+
if (typeof o.sig !== "string" || o.sig.length === 0)
|
|
157
|
+
return null;
|
|
158
|
+
// Refuse a leftover enable-shaped payload from older clients.
|
|
159
|
+
if ("enable" in o)
|
|
160
|
+
return null;
|
|
161
|
+
return {
|
|
162
|
+
v: DEVICE_SESSIONS_DISABLE_VERSION,
|
|
163
|
+
key_id: o.key_id,
|
|
164
|
+
ts: o.ts,
|
|
165
|
+
nonce: o.nonce,
|
|
166
|
+
sig: o.sig,
|
|
167
|
+
};
|
|
168
|
+
};
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Device-control rotation wire format + key fingerprint helper.
|
|
3
|
+
*
|
|
4
|
+
* Shared by the browser (which signs rotations with the old control seed)
|
|
5
|
+
* and the daemon (which verifies them against its pinned control pubkey).
|
|
6
|
+
* Bytes + JSON only — no crypto. The v2 format drops the timestamp window
|
|
7
|
+
* that made stored statements unusable: being signed by the current pin is
|
|
8
|
+
* enough, because freshly derived phrases never repeat keys.
|
|
9
|
+
*/
|
|
10
|
+
export declare const DEVICE_CONTROL_ROTATE_LABEL = "openllm-device-control-rotate-v2";
|
|
11
|
+
export declare const DEVICE_CONTROL_ROTATE_VERSION: 2;
|
|
12
|
+
/** Alias used by `@openllmsh/sdk/vault` `signDeviceControlRotation`. */
|
|
13
|
+
export declare const DEVICE_CONTROL_ROTATION_VERSION: 2;
|
|
14
|
+
/** Soft wire cap — matches attestation envelopes. */
|
|
15
|
+
export declare const DEVICE_CONTROL_ROTATION_B64_MAX = 1024;
|
|
16
|
+
/** Most statements bootstrap hands a daemon / a daemon walks per attempt. */
|
|
17
|
+
export declare const DEVICE_CONTROL_ROTATION_CHAIN_MAX = 8;
|
|
18
|
+
export type TDeviceControlRotationFields = {
|
|
19
|
+
readonly v: 2;
|
|
20
|
+
/** Current (old) control public key, SPKI base64. */
|
|
21
|
+
readonly old: string;
|
|
22
|
+
/** Next control public key, SPKI base64. */
|
|
23
|
+
readonly new: string;
|
|
24
|
+
/** New control / vault version — must exceed the daemon's pin version. */
|
|
25
|
+
readonly cv: number;
|
|
26
|
+
};
|
|
27
|
+
export type TDeviceControlRotationEnvelope = TDeviceControlRotationFields & {
|
|
28
|
+
readonly sig: string;
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
|
|
32
|
+
* Fixed key order `v, old, new, cv`.
|
|
33
|
+
*/
|
|
34
|
+
export declare const buildDeviceControlRotationMessage: (fields: Omit<TDeviceControlRotationFields, "v"> & {
|
|
35
|
+
readonly v?: 2;
|
|
36
|
+
}) => Uint8Array;
|
|
37
|
+
export declare const encodeDeviceControlRotation: (envelope: TDeviceControlRotationEnvelope) => string;
|
|
38
|
+
export declare const decodeDeviceControlRotation: (b64: string) => TDeviceControlRotationEnvelope | null;
|
|
39
|
+
/**
|
|
40
|
+
* Short fingerprint of an SPKI (base64): SHA-256, first 16 hex chars as
|
|
41
|
+
* four groups of four (`abcd efgh ijkl mnop`). Used in verify-device UI
|
|
42
|
+
* and `openllm daemon identity` output.
|
|
43
|
+
*/
|
|
44
|
+
export declare const keyFingerprint: (spkiB64: string) => Promise<string>;
|
|
45
|
+
/**
|
|
46
|
+
* The {@link keyFingerprint} format from a precomputed SHA-256 digest of the
|
|
47
|
+
* SPKI DER — lets the daemon compute it synchronously with node:crypto while
|
|
48
|
+
* every surface prints the identical string.
|
|
49
|
+
*/
|
|
50
|
+
export declare const formatKeyFingerprint: (sha256Digest: Uint8Array) => string;
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Device-control rotation wire format + key fingerprint helper.
|
|
3
|
+
*
|
|
4
|
+
* Shared by the browser (which signs rotations with the old control seed)
|
|
5
|
+
* and the daemon (which verifies them against its pinned control pubkey).
|
|
6
|
+
* Bytes + JSON only — no crypto. The v2 format drops the timestamp window
|
|
7
|
+
* that made stored statements unusable: being signed by the current pin is
|
|
8
|
+
* enough, because freshly derived phrases never repeat keys.
|
|
9
|
+
*/
|
|
10
|
+
import { decodeB64Json, encodeB64Json, labelledMessage } from "./wire-bytes.js";
|
|
11
|
+
export const DEVICE_CONTROL_ROTATE_LABEL = "openllm-device-control-rotate-v2";
|
|
12
|
+
export const DEVICE_CONTROL_ROTATE_VERSION = 2;
|
|
13
|
+
/** Alias used by `@openllmsh/sdk/vault` `signDeviceControlRotation`. */
|
|
14
|
+
export const DEVICE_CONTROL_ROTATION_VERSION = DEVICE_CONTROL_ROTATE_VERSION;
|
|
15
|
+
/** Soft wire cap — matches attestation envelopes. */
|
|
16
|
+
export const DEVICE_CONTROL_ROTATION_B64_MAX = 1024;
|
|
17
|
+
/** Most statements bootstrap hands a daemon / a daemon walks per attempt. */
|
|
18
|
+
export const DEVICE_CONTROL_ROTATION_CHAIN_MAX = 8;
|
|
19
|
+
/**
|
|
20
|
+
* Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
|
|
21
|
+
* Fixed key order `v, old, new, cv`.
|
|
22
|
+
*/
|
|
23
|
+
export const buildDeviceControlRotationMessage = (fields) => labelledMessage(DEVICE_CONTROL_ROTATE_LABEL, JSON.stringify({
|
|
24
|
+
v: DEVICE_CONTROL_ROTATE_VERSION,
|
|
25
|
+
old: fields.old,
|
|
26
|
+
new: fields.new,
|
|
27
|
+
cv: fields.cv,
|
|
28
|
+
}));
|
|
29
|
+
export const encodeDeviceControlRotation = (envelope) => encodeB64Json(envelope, DEVICE_CONTROL_ROTATION_B64_MAX, "device control rotation exceeds DEVICE_CONTROL_ROTATION_B64_MAX");
|
|
30
|
+
export const decodeDeviceControlRotation = (b64) => {
|
|
31
|
+
const o = decodeB64Json(b64, DEVICE_CONTROL_ROTATION_B64_MAX);
|
|
32
|
+
if (o === null)
|
|
33
|
+
return null;
|
|
34
|
+
if (o.v !== DEVICE_CONTROL_ROTATE_VERSION)
|
|
35
|
+
return null;
|
|
36
|
+
if (typeof o.old !== "string" || o.old.length === 0)
|
|
37
|
+
return null;
|
|
38
|
+
if (typeof o.new !== "string" || o.new.length === 0)
|
|
39
|
+
return null;
|
|
40
|
+
if (o.old === o.new)
|
|
41
|
+
return null;
|
|
42
|
+
if (typeof o.cv !== "number" || !Number.isInteger(o.cv) || o.cv < 1) {
|
|
43
|
+
return null;
|
|
44
|
+
}
|
|
45
|
+
if (typeof o.sig !== "string" || o.sig.length === 0)
|
|
46
|
+
return null;
|
|
47
|
+
return {
|
|
48
|
+
v: DEVICE_CONTROL_ROTATE_VERSION,
|
|
49
|
+
old: o.old,
|
|
50
|
+
new: o.new,
|
|
51
|
+
cv: o.cv,
|
|
52
|
+
sig: o.sig,
|
|
53
|
+
};
|
|
54
|
+
};
|
|
55
|
+
/**
|
|
56
|
+
* Short fingerprint of an SPKI (base64): SHA-256, first 16 hex chars as
|
|
57
|
+
* four groups of four (`abcd efgh ijkl mnop`). Used in verify-device UI
|
|
58
|
+
* and `openllm daemon identity` output.
|
|
59
|
+
*/
|
|
60
|
+
export const keyFingerprint = async (spkiB64) => {
|
|
61
|
+
let spki;
|
|
62
|
+
try {
|
|
63
|
+
const bin = atob(spkiB64);
|
|
64
|
+
spki = new Uint8Array(bin.length);
|
|
65
|
+
for (let i = 0; i < bin.length; i++)
|
|
66
|
+
spki[i] = bin.charCodeAt(i);
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
throw new Error("keyFingerprint: malformed SPKI base64");
|
|
70
|
+
}
|
|
71
|
+
const digest = new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", spki));
|
|
72
|
+
return formatKeyFingerprint(digest);
|
|
73
|
+
};
|
|
74
|
+
/**
|
|
75
|
+
* The {@link keyFingerprint} format from a precomputed SHA-256 digest of the
|
|
76
|
+
* SPKI DER — lets the daemon compute it synchronously with node:crypto while
|
|
77
|
+
* every surface prints the identical string.
|
|
78
|
+
*/
|
|
79
|
+
export const formatKeyFingerprint = (sha256Digest) => {
|
|
80
|
+
if (sha256Digest.length < 8) {
|
|
81
|
+
throw new Error("formatKeyFingerprint: digest too short");
|
|
82
|
+
}
|
|
83
|
+
let hex = "";
|
|
84
|
+
for (let i = 0; i < 8; i++) {
|
|
85
|
+
hex += sha256Digest[i].toString(16).padStart(2, "0");
|
|
86
|
+
}
|
|
87
|
+
return `${hex.slice(0, 4)} ${hex.slice(4, 8)} ${hex.slice(8, 12)} ${hex.slice(12, 16)}`;
|
|
88
|
+
};
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Canonical device-grant wire format shared by the browser (which
|
|
3
|
+
* SIGNS grants with the account device-control key — derived from the
|
|
4
|
+
* recovery phrase, never the DEK; see `device-control.ts`) and the
|
|
5
|
+
* daemon (which VERIFIES them against its pinned control pubkey). Bytes + JSON only — no crypto lives
|
|
6
|
+
* here. Wire size cap is owned by protocol and re-exported.
|
|
7
|
+
*/
|
|
8
|
+
import { DEVICE_GRANT_B64_MAX } from "@openllmsh/sdk/protocol";
|
|
9
|
+
export { DEVICE_GRANT_B64_MAX };
|
|
10
|
+
export declare const DEVICE_GRANT_LABEL = "openllm-device-grant-v1";
|
|
11
|
+
export declare const DEVICE_GRANT_VERSION: 1;
|
|
12
|
+
export declare const DEVICE_GRANT_TS_WINDOW_MS = 120000;
|
|
13
|
+
export declare const DEVICE_GRANT_NONCE_BYTES = 16;
|
|
14
|
+
export type TDeviceGrantFields = {
|
|
15
|
+
readonly v: 1;
|
|
16
|
+
/** 16-byte nonce, base64. */
|
|
17
|
+
readonly n: string;
|
|
18
|
+
/** ms since epoch at signing time. */
|
|
19
|
+
readonly ts: number;
|
|
20
|
+
/** The daemon's api key id. */
|
|
21
|
+
readonly key_id: string;
|
|
22
|
+
/** channel_id / tunnel_id / rtc channel_id being granted. */
|
|
23
|
+
readonly cid: string;
|
|
24
|
+
/** Daemon X25519 pubkey b64 ("" when unknown — legacy tunnel path). */
|
|
25
|
+
readonly aud: string;
|
|
26
|
+
/**
|
|
27
|
+
* The daemon X25519 pubkey (SPKI DER, base64) the signer TRUSTS — taken
|
|
28
|
+
* from a daemon attestation signed by the device-control key
|
|
29
|
+
* (`@openllmsh/sdk/vault` `daemon-attest.ts`), not from the cloud — and used as
|
|
30
|
+
* the Noise_IK responder key (`secure.ts`) on the relay mux. The daemon
|
|
31
|
+
* refuses a grant whose `dpk` is not its own key. Absent on legacy grants;
|
|
32
|
+
* when absent it is also absent from the signed message, so legacy bytes
|
|
33
|
+
* are unchanged.
|
|
34
|
+
*/
|
|
35
|
+
readonly dpk?: string;
|
|
36
|
+
/**
|
|
37
|
+
* What the grant authorises ({@link TDeviceGrantUse}). Signed, so a grant
|
|
38
|
+
* minted for one purpose is refused for another: the relay sees every
|
|
39
|
+
* `channel_open` grant in plaintext, and without this it could replay one
|
|
40
|
+
* inside its own RTC offer or Noise handshake. Absent on legacy grants
|
|
41
|
+
* (and then absent from the signed message); required wherever `dpk` is.
|
|
42
|
+
*/
|
|
43
|
+
readonly use?: TDeviceGrantUse;
|
|
44
|
+
/**
|
|
45
|
+
* The channel the grant is bound to, for uses that have one: the browser's
|
|
46
|
+
* DTLS fingerprint (`rtc`, the offer's sealed `fb`) or its Noise static key
|
|
47
|
+
* (`noise`, raw 32 bytes base64). A relay that harvests the grant cannot
|
|
48
|
+
* stand in for either.
|
|
49
|
+
*/
|
|
50
|
+
readonly bind?: string;
|
|
51
|
+
};
|
|
52
|
+
/**
|
|
53
|
+
* - `channel`: a relay-mux `channel_open` (seen by the relay in plaintext).
|
|
54
|
+
* - `rtc`: an RTC offer's sealed grant; `bind` is the offer's DTLS fingerprint.
|
|
55
|
+
* - `noise`: the relay-mux agent Noise_IK message-1 payload; `bind` is the
|
|
56
|
+
* initiator's static key.
|
|
57
|
+
*/
|
|
58
|
+
export declare const DEVICE_GRANT_USES: readonly ["channel", "rtc", "noise"];
|
|
59
|
+
export type TDeviceGrantUse = (typeof DEVICE_GRANT_USES)[number];
|
|
60
|
+
/**
|
|
61
|
+
* The `bind` of a `noise` grant: the initiator's raw 32-byte Noise static
|
|
62
|
+
* key, base64. Signer and verifier both derive it here so the bytes agree.
|
|
63
|
+
*/
|
|
64
|
+
export declare const noiseGrantBinding: (initiatorStatic: Uint8Array) => string;
|
|
65
|
+
export type TDeviceGrantEnvelope = TDeviceGrantFields & {
|
|
66
|
+
readonly sig: string;
|
|
67
|
+
};
|
|
68
|
+
/**
|
|
69
|
+
* Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
|
|
70
|
+
*
|
|
71
|
+
* The JSON is canonical-by-construction: it is produced by
|
|
72
|
+
* `JSON.stringify` of an object literal written in the fixed field
|
|
73
|
+
* order `v, n, ts, key_id, cid, aud[, dpk][, use][, bind]` (each optional
|
|
74
|
+
* field only when present, so legacy grant bytes are unchanged).
|
|
75
|
+
* ECMAScript guarantees own string-keyed property enumeration (and
|
|
76
|
+
* therefore stringify output) follows insertion order, so building the
|
|
77
|
+
* literal in that order yields identical bytes for identical fields on
|
|
78
|
+
* every runtime.
|
|
79
|
+
*/
|
|
80
|
+
export declare const buildDeviceGrantMessage: (fields: TDeviceGrantFields) => Uint8Array;
|
|
81
|
+
/** base64(JSON) envelope encoding for the wire. */
|
|
82
|
+
export declare const encodeDeviceGrant: (envelope: TDeviceGrantEnvelope) => string;
|
|
83
|
+
/**
|
|
84
|
+
* Strict decode: returns null on any shape mismatch. `aud` may be the
|
|
85
|
+
* empty string (legacy tunnel path); `dpk`, `use` and `bind` may be absent
|
|
86
|
+
* (legacy grant) but, when present, `dpk` and `bind` must be non-empty
|
|
87
|
+
* strings and `use` one of {@link DEVICE_GRANT_USES}; every other string field must be
|
|
88
|
+
* non-empty, `v` must be exactly 1, `n` base64 of
|
|
89
|
+
* {@link DEVICE_GRANT_NONCE_BYTES} bytes, and `ts` a finite positive integer.
|
|
90
|
+
*/
|
|
91
|
+
export declare const decodeDeviceGrant: (b64: string) => TDeviceGrantEnvelope | null;
|