@openllmsh/sdk 2.10.12-alpha.1 → 2.10.12-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -7
- package/dist/client/chat.d.ts +38 -0
- package/dist/client/chat.js +77 -0
- package/dist/client/devices.d.ts +70 -0
- package/dist/client/devices.js +172 -0
- package/dist/client/http.d.ts +24 -0
- package/dist/client/http.js +34 -0
- package/dist/client/index.d.ts +43 -0
- package/dist/client/index.js +57 -0
- package/dist/client/relay-mux.d.ts +71 -0
- package/dist/client/relay-mux.js +394 -0
- package/dist/client/types.d.ts +47 -0
- package/dist/client/types.js +5 -0
- package/dist/client/vault.d.ts +68 -0
- package/dist/client/vault.js +113 -0
- package/dist/connect/chat.d.ts +24 -0
- package/dist/connect/chat.js +25 -0
- package/dist/connect/client.d.ts +50 -0
- package/dist/connect/client.js +141 -0
- package/dist/connect/config.d.ts +22 -0
- package/dist/connect/config.js +22 -0
- package/dist/connect/errors.d.ts +32 -0
- package/dist/connect/errors.js +85 -0
- package/{connect/index.ts → dist/connect/index.d.ts} +7 -7
- package/dist/connect/index.js +23 -0
- package/dist/connect/oauth.d.ts +51 -0
- package/dist/connect/oauth.js +150 -0
- package/dist/connect/routes.d.ts +38 -0
- package/dist/connect/routes.js +175 -0
- package/dist/connect/store.d.ts +26 -0
- package/dist/connect/store.js +65 -0
- package/dist/mcp/handle.d.ts +6 -0
- package/dist/mcp/handle.js +6 -0
- package/dist/mcp/index.d.ts +15 -0
- package/dist/mcp/index.js +10 -0
- package/dist/mcp/server.d.ts +84 -0
- package/dist/mcp/server.js +168 -0
- package/dist/mcp/tools/marketplace.d.ts +94 -0
- package/dist/mcp/tools/marketplace.js +303 -0
- package/dist/mcp/tools/memory-client.d.ts +109 -0
- package/dist/mcp/tools/memory-client.js +200 -0
- package/dist/mcp/tools/memory-config.d.ts +29 -0
- package/dist/mcp/tools/memory-config.js +12 -0
- package/dist/mcp/tools/memory.d.ts +92 -0
- package/dist/mcp/tools/memory.js +312 -0
- package/dist/mcp/tools/model-priority.d.ts +16 -0
- package/dist/mcp/tools/model-priority.js +87 -0
- package/dist/mcp/tools/openllm.d.ts +75 -0
- package/dist/mcp/tools/openllm.js +715 -0
- package/dist/mcp/types.d.ts +25 -0
- package/dist/mcp/types.js +7 -0
- package/dist/openapi/call.d.ts +26 -0
- package/dist/openapi/call.js +56 -0
- package/dist/openapi/index.d.ts +2 -0
- package/dist/openapi/index.js +2 -0
- package/dist/openapi/openapi.json +80213 -0
- package/dist/openapi/operations.d.ts +14 -0
- package/dist/openapi/operations.js +2060 -0
- package/dist/protocol/access.d.ts +81 -0
- package/dist/protocol/access.js +125 -0
- package/dist/protocol/agent-prompt-text.d.ts +15 -0
- package/{protocol/agent-prompt-text.ts → dist/protocol/agent-prompt-text.js} +9 -14
- package/dist/protocol/agent.d.ts +1487 -0
- package/dist/protocol/agent.js +787 -0
- package/dist/protocol/api-key-syntax.d.ts +58 -0
- package/dist/protocol/api-key-syntax.js +73 -0
- package/dist/protocol/audio.d.ts +18 -0
- package/dist/protocol/audio.js +21 -0
- package/dist/protocol/auth.d.ts +126 -0
- package/dist/protocol/auth.js +119 -0
- package/dist/protocol/changelog.d.ts +69 -0
- package/dist/protocol/changelog.js +107 -0
- package/dist/protocol/chat.d.ts +789 -0
- package/dist/protocol/chat.js +394 -0
- package/dist/protocol/client-registry.d.ts +151 -0
- package/dist/protocol/client-registry.js +238 -0
- package/dist/protocol/config.d.ts +508 -0
- package/dist/protocol/config.js +289 -0
- package/dist/protocol/control-channel.d.ts +102 -0
- package/{protocol/control-channel.ts → dist/protocol/control-channel.js} +33 -61
- package/dist/protocol/cooldown-reason.d.ts +30 -0
- package/dist/protocol/cooldown-reason.js +44 -0
- package/dist/protocol/cost.d.ts +9 -0
- package/dist/protocol/cost.js +8 -0
- package/dist/protocol/daemon-port.d.ts +2 -0
- package/dist/protocol/daemon-port.js +28 -0
- package/dist/protocol/daemon.d.ts +2034 -0
- package/dist/protocol/daemon.js +1286 -0
- package/dist/protocol/default-chains.d.ts +15 -0
- package/dist/protocol/default-chains.js +21 -0
- package/dist/protocol/device-state.d.ts +223 -0
- package/dist/protocol/device-state.js +52 -0
- package/dist/protocol/doctor-report-local.d.ts +105 -0
- package/{protocol/doctor-report-local.ts → dist/protocol/doctor-report-local.js} +92 -196
- package/dist/protocol/doctor-report-policy.d.ts +62 -0
- package/{protocol/doctor-report-policy.ts → dist/protocol/doctor-report-policy.js} +23 -76
- package/dist/protocol/doctor-report.d.ts +406 -0
- package/dist/protocol/doctor-report.js +645 -0
- package/dist/protocol/errors.d.ts +17 -0
- package/dist/protocol/errors.js +10 -0
- package/dist/protocol/execution-selection.d.ts +92 -0
- package/{protocol/execution-selection.ts → dist/protocol/execution-selection.js} +38 -63
- package/dist/protocol/hop-grant.d.ts +28 -0
- package/{protocol/hop-grant.ts → dist/protocol/hop-grant.js} +7 -13
- package/dist/protocol/image-edit-parse.d.ts +25 -0
- package/dist/protocol/image-edit-parse.js +196 -0
- package/dist/protocol/images.d.ts +288 -0
- package/dist/protocol/images.js +229 -0
- package/dist/protocol/index.d.ts +69 -0
- package/dist/protocol/index.js +74 -0
- package/dist/protocol/inference-headers.d.ts +3 -0
- package/dist/protocol/keepalive.d.ts +36 -0
- package/dist/protocol/keepalive.js +51 -0
- package/dist/protocol/local-auth.d.ts +125 -0
- package/dist/protocol/local-auth.js +227 -0
- package/dist/protocol/local-device-control.d.ts +108 -0
- package/{protocol/local-device-control.ts → dist/protocol/local-device-control.js} +40 -70
- package/dist/protocol/local-provider.d.ts +105 -0
- package/dist/protocol/local-provider.js +213 -0
- package/dist/protocol/local-session.d.ts +70 -0
- package/dist/protocol/local-session.js +87 -0
- package/dist/protocol/marketplace.d.ts +190 -0
- package/dist/protocol/marketplace.js +140 -0
- package/{protocol/media-attempt.ts → dist/protocol/media-attempt.d.ts} +11 -50
- package/dist/protocol/media-attempt.js +50 -0
- package/dist/protocol/media-bytes.d.ts +8 -0
- package/dist/protocol/media-bytes.js +21 -0
- package/dist/protocol/media-default.d.ts +56 -0
- package/dist/protocol/media-default.js +302 -0
- package/{protocol/media-dimensions.ts → dist/protocol/media-dimensions.d.ts} +11 -78
- package/dist/protocol/media-dimensions.js +90 -0
- package/dist/protocol/media-input.d.ts +20 -0
- package/dist/protocol/media-input.js +29 -0
- package/dist/protocol/media-model.d.ts +77 -0
- package/dist/protocol/media-model.js +89 -0
- package/{protocol/media-option-issue.ts → dist/protocol/media-option-issue.d.ts} +25 -53
- package/dist/protocol/media-option-issue.js +50 -0
- package/dist/protocol/media-types.d.ts +14 -0
- package/dist/protocol/media-types.js +61 -0
- package/dist/protocol/model-match.d.ts +254 -0
- package/dist/protocol/model-match.js +760 -0
- package/dist/protocol/model-settings.d.ts +153 -0
- package/dist/protocol/model-settings.js +246 -0
- package/dist/protocol/models.d.ts +1065 -0
- package/dist/protocol/models.js +638 -0
- package/dist/protocol/mux.d.ts +350 -0
- package/dist/protocol/mux.js +595 -0
- package/{protocol/plan-surface.ts → dist/protocol/plan-surface.d.ts} +12 -26
- package/dist/protocol/plan-surface.js +39 -0
- package/dist/protocol/provider-models.d.ts +8 -0
- package/{protocol/provider-models.ts → dist/protocol/provider-models.js} +7 -9
- package/dist/protocol/provider-status.d.ts +59 -0
- package/dist/protocol/provider-status.js +142 -0
- package/dist/protocol/provider-tier.d.ts +34 -0
- package/{protocol/provider-tier.ts → dist/protocol/provider-tier.js} +9 -34
- package/dist/protocol/provider-usage.d.ts +230 -0
- package/dist/protocol/provider-usage.js +214 -0
- package/dist/protocol/providers.d.ts +2496 -0
- package/dist/protocol/providers.js +723 -0
- package/dist/protocol/public-usage-index.d.ts +449 -0
- package/dist/protocol/public-usage-index.js +279 -0
- package/dist/protocol/realtime-generated.d.ts +29 -0
- package/{protocol/realtime-generated.ts → dist/protocol/realtime-generated.js} +3 -5
- package/dist/protocol/realtime.d.ts +241 -0
- package/{protocol/realtime.ts → dist/protocol/realtime.js} +88 -155
- package/dist/protocol/registry-pointer.d.ts +24 -0
- package/dist/protocol/registry-pointer.js +78 -0
- package/dist/protocol/relay.d.ts +1152 -0
- package/{protocol/relay.ts → dist/protocol/relay.js} +237 -370
- package/dist/protocol/replay-session.d.ts +4 -0
- package/{protocol/replay-session.ts → dist/protocol/replay-session.js} +1 -8
- package/dist/protocol/responses.d.ts +303 -0
- package/dist/protocol/responses.js +240 -0
- package/dist/protocol/semver.d.ts +59 -0
- package/dist/protocol/semver.js +171 -0
- package/{protocol/setup-mode.ts → dist/protocol/setup-mode.d.ts} +4 -12
- package/dist/protocol/setup-mode.js +18 -0
- package/dist/protocol/sha256-hex.d.ts +2 -0
- package/dist/protocol/sha256-hex.js +93 -0
- package/dist/protocol/stats.d.ts +711 -0
- package/dist/protocol/stats.js +353 -0
- package/dist/protocol/streaming.d.ts +16 -0
- package/dist/protocol/streaming.js +15 -0
- package/{protocol/subscription-daemon-floors.ts → dist/protocol/subscription-daemon-floors.d.ts} +8 -14
- package/dist/protocol/subscription-daemon-floors.js +4 -0
- package/dist/protocol/subscription-provider-compat.d.ts +44 -0
- package/dist/protocol/subscription-provider-compat.js +67 -0
- package/dist/protocol/subscription-provider.d.ts +15 -0
- package/dist/protocol/subscription-provider.js +17 -0
- package/dist/protocol/team-grant.d.ts +14 -0
- package/{protocol/team-grant.ts → dist/protocol/team-grant.js} +0 -3
- package/dist/protocol/team-shareable.d.ts +6 -0
- package/{protocol/team-shareable.ts → dist/protocol/team-shareable.js} +29 -33
- package/dist/protocol/transcription-encoding.d.ts +25 -0
- package/dist/protocol/transcription-encoding.js +47 -0
- package/{protocol/url-locality-dns.ts → dist/protocol/url-locality-dns.d.ts} +1 -23
- package/dist/protocol/url-locality-dns.js +33 -0
- package/dist/protocol/url-locality.d.ts +45 -0
- package/dist/protocol/url-locality.js +288 -0
- package/dist/protocol/usage-snapshots.d.ts +8 -0
- package/{protocol/usage-snapshots.ts → dist/protocol/usage-snapshots.js} +1 -2
- package/dist/protocol/vendor-cli-install.d.ts +20 -0
- package/{protocol/vendor-cli-install.ts → dist/protocol/vendor-cli-install.js} +10 -15
- package/dist/protocol/video-job-plan.d.ts +18 -0
- package/dist/protocol/video-job-plan.js +44 -0
- package/dist/protocol/videos.d.ts +107 -0
- package/dist/protocol/videos.js +154 -0
- package/dist/tunnel/channel-envelope.d.ts +53 -0
- package/dist/tunnel/channel-envelope.js +100 -0
- package/dist/tunnel/codec.d.ts +71 -0
- package/dist/tunnel/codec.js +151 -0
- package/dist/tunnel/device-anchor.d.ts +62 -0
- package/dist/tunnel/device-anchor.js +168 -0
- package/dist/tunnel/device-control.d.ts +50 -0
- package/dist/tunnel/device-control.js +88 -0
- package/dist/tunnel/device-grant.d.ts +91 -0
- package/dist/tunnel/device-grant.js +105 -0
- package/dist/tunnel/fleet.d.ts +28 -0
- package/dist/tunnel/fleet.js +41 -0
- package/dist/tunnel/index.d.ts +22 -0
- package/dist/tunnel/index.js +22 -0
- package/dist/tunnel/mux.d.ts +64 -0
- package/dist/tunnel/mux.js +449 -0
- package/dist/tunnel/peer-link.d.ts +88 -0
- package/dist/tunnel/peer-link.js +271 -0
- package/dist/tunnel/rtc-auth.d.ts +159 -0
- package/dist/tunnel/rtc-auth.js +340 -0
- package/dist/tunnel/rtc-duplex.d.ts +52 -0
- package/dist/tunnel/rtc-duplex.js +148 -0
- package/dist/tunnel/rtc-ice.d.ts +55 -0
- package/dist/tunnel/rtc-ice.js +100 -0
- package/dist/tunnel/secure.d.ts +179 -0
- package/dist/tunnel/secure.js +936 -0
- package/dist/tunnel/stream-reset-error.d.ts +6 -0
- package/dist/tunnel/stream-reset-error.js +9 -0
- package/dist/tunnel/streams.d.ts +244 -0
- package/dist/tunnel/streams.js +1071 -0
- package/dist/tunnel/team-grant.d.ts +90 -0
- package/dist/tunnel/team-grant.js +226 -0
- package/dist/tunnel/wire-bytes.d.ts +32 -0
- package/dist/tunnel/wire-bytes.js +90 -0
- package/dist/vault/api-key.d.ts +71 -0
- package/dist/vault/api-key.js +130 -0
- package/{vault/argon2.ts → dist/vault/argon2.d.ts} +18 -53
- package/dist/vault/argon2.js +82 -0
- package/dist/vault/cli-auth-seal.d.ts +35 -0
- package/dist/vault/cli-auth-seal.js +78 -0
- package/dist/vault/cred-seal.d.ts +18 -0
- package/dist/vault/cred-seal.js +86 -0
- package/dist/vault/credential.d.ts +21 -0
- package/dist/vault/credential.js +26 -0
- package/dist/vault/crypto.d.ts +51 -0
- package/dist/vault/crypto.js +156 -0
- package/dist/vault/daemon-attest.d.ts +68 -0
- package/dist/vault/daemon-attest.js +147 -0
- package/dist/vault/derive.d.ts +34 -0
- package/dist/vault/derive.js +84 -0
- package/dist/vault/device-access.d.ts +17 -0
- package/dist/vault/device-access.js +77 -0
- package/dist/vault/device-anchor.d.ts +42 -0
- package/dist/vault/device-anchor.js +90 -0
- package/dist/vault/device-control.d.ts +80 -0
- package/{vault/device-control.ts → dist/vault/device-control.js} +46 -104
- package/dist/vault/handoff.d.ts +102 -0
- package/dist/vault/handoff.js +236 -0
- package/dist/vault/index.d.ts +21 -0
- package/dist/vault/index.js +21 -0
- package/dist/vault/passkey.d.ts +82 -0
- package/{vault/passkey.ts → dist/vault/passkey.js} +63 -153
- package/dist/vault/phrase.d.ts +40 -0
- package/{vault/phrase.ts → dist/vault/phrase.js} +17 -23
- package/dist/vault/pin.d.ts +46 -0
- package/dist/vault/pin.js +92 -0
- package/dist/vault/public-key-seal.d.ts +17 -0
- package/dist/vault/public-key-seal.js +59 -0
- package/dist/vault/seed.d.ts +96 -0
- package/dist/vault/seed.js +179 -0
- package/dist/vault/team.d.ts +134 -0
- package/dist/vault/team.js +217 -0
- package/dist/vault/vault-item.d.ts +45 -0
- package/dist/vault/vault-item.js +62 -0
- package/dist/vault/vault-migrate-digest.d.ts +10 -0
- package/dist/vault/vault-migrate-digest.js +22 -0
- package/dist/vault/wrapped.d.ts +19 -0
- package/dist/vault/wrapped.js +52 -0
- package/dist/wire/adapters/messages/anthropic-map.d.ts +8 -0
- package/dist/wire/adapters/messages/anthropic-map.js +32 -0
- package/dist/wire/adapters/messages/index.d.ts +7 -0
- package/dist/wire/adapters/messages/index.js +7 -0
- package/dist/wire/adapters/messages/reasoning-from-items.d.ts +14 -0
- package/dist/wire/adapters/messages/reasoning-from-items.js +39 -0
- package/dist/wire/adapters/messages/reasoning-signature.d.ts +81 -0
- package/dist/wire/adapters/messages/reasoning-signature.js +180 -0
- package/dist/wire/adapters/messages/request.d.ts +28 -0
- package/dist/wire/adapters/messages/request.js +490 -0
- package/dist/wire/adapters/messages/response.d.ts +10 -0
- package/dist/wire/adapters/messages/response.js +177 -0
- package/dist/wire/adapters/messages/streaming.d.ts +134 -0
- package/dist/wire/adapters/messages/streaming.js +791 -0
- package/dist/wire/adapters/messages/usage.d.ts +20 -0
- package/dist/wire/adapters/messages/usage.js +10 -0
- package/dist/wire/adapters/responses/index.d.ts +3 -0
- package/dist/wire/adapters/responses/index.js +3 -0
- package/dist/wire/adapters/responses/request.d.ts +2 -0
- package/dist/wire/adapters/responses/request.js +287 -0
- package/dist/wire/adapters/responses/response.d.ts +11 -0
- package/dist/wire/adapters/responses/response.js +69 -0
- package/dist/wire/adapters/responses/streaming.d.ts +2 -0
- package/dist/wire/adapters/responses/streaming.js +267 -0
- package/dist/wire/features/account-rank.d.ts +61 -0
- package/dist/wire/features/account-rank.js +109 -0
- package/dist/wire/features/compaction/compact-request.d.ts +69 -0
- package/dist/wire/features/compaction/compact-request.js +667 -0
- package/dist/wire/features/compaction/compaction-text.d.ts +17 -0
- package/dist/wire/features/compaction/compaction-text.js +29 -0
- package/dist/wire/features/context-demote.d.ts +15 -0
- package/dist/wire/features/context-demote.js +45 -0
- package/dist/wire/features/context-overflow-strategy.d.ts +12 -0
- package/dist/wire/features/context-overflow-strategy.js +8 -0
- package/dist/wire/features/context-skip.d.ts +120 -0
- package/{wire/features/context-skip.ts → dist/wire/features/context-skip.js} +23 -57
- package/dist/wire/features/conversation-affinity.d.ts +49 -0
- package/dist/wire/features/conversation-affinity.js +121 -0
- package/dist/wire/features/max-tokens-backfill.d.ts +50 -0
- package/dist/wire/features/max-tokens-backfill.js +118 -0
- package/dist/wire/features/model-caps.d.ts +7 -0
- package/dist/wire/features/model-caps.js +40 -0
- package/dist/wire/features/model-settings.d.ts +3 -0
- package/dist/wire/features/model-settings.js +13 -0
- package/dist/wire/features/output-limit-clamp.d.ts +14 -0
- package/dist/wire/features/output-limit-clamp.js +36 -0
- package/dist/wire/features/quota-gate.d.ts +16 -0
- package/dist/wire/features/quota-gate.js +48 -0
- package/dist/wire/index.d.ts +44 -0
- package/dist/wire/index.js +44 -0
- package/dist/wire/lib/attempt-outcome.d.ts +19 -0
- package/dist/wire/lib/attempt-outcome.js +18 -0
- package/{wire/lib/canonical/content-part.ts → dist/wire/lib/canonical/content-part.d.ts} +12 -18
- package/dist/wire/lib/canonical/content-part.js +11 -0
- package/dist/wire/lib/canonical/count-tokens-capability.d.ts +52 -0
- package/dist/wire/lib/canonical/count-tokens-capability.js +109 -0
- package/{wire/lib/canonical/encoding-select.ts → dist/wire/lib/canonical/encoding-select.d.ts} +7 -24
- package/dist/wire/lib/canonical/encoding-select.js +26 -0
- package/dist/wire/lib/canonical/image-signature.d.ts +20 -0
- package/dist/wire/lib/canonical/image-signature.js +184 -0
- package/dist/wire/lib/canonical/image-sse.d.ts +88 -0
- package/dist/wire/lib/canonical/image-sse.js +173 -0
- package/{wire/lib/canonical/message.ts → dist/wire/lib/canonical/message.d.ts} +2 -20
- package/dist/wire/lib/canonical/message.js +31 -0
- package/dist/wire/lib/canonical/token-estimate.d.ts +98 -0
- package/dist/wire/lib/canonical/token-estimate.js +230 -0
- package/dist/wire/lib/encrypted-content.d.ts +22 -0
- package/dist/wire/lib/encrypted-content.js +55 -0
- package/dist/wire/lib/error-class.d.ts +57 -0
- package/dist/wire/lib/error-class.js +97 -0
- package/dist/wire/lib/error-envelope.d.ts +20 -0
- package/dist/wire/lib/error-envelope.js +53 -0
- package/dist/wire/lib/forwarded-headers.d.ts +16 -0
- package/{wire/lib/forwarded-headers.ts → dist/wire/lib/forwarded-headers.js} +62 -72
- package/dist/wire/lib/provider-error-rules.d.ts +21 -0
- package/dist/wire/lib/provider-error-rules.js +20 -0
- package/{wire/lib/refusal.ts → dist/wire/lib/refusal.d.ts} +3 -13
- package/dist/wire/lib/refusal.js +27 -0
- package/dist/wire/lib/responses-apply-patch.d.ts +57 -0
- package/dist/wire/lib/responses-apply-patch.js +81 -0
- package/dist/wire/lib/responses-namespace.d.ts +27 -0
- package/{wire/lib/responses-namespace.ts → dist/wire/lib/responses-namespace.js} +16 -32
- package/dist/wire/lib/secret-scrub.d.ts +23 -0
- package/dist/wire/lib/secret-scrub.js +72 -0
- package/dist/wire/lib/streaming/accumulate.d.ts +12 -0
- package/dist/wire/lib/streaming/accumulate.js +187 -0
- package/dist/wire/lib/streaming/finish-reason.d.ts +20 -0
- package/dist/wire/lib/streaming/finish-reason.js +15 -0
- package/{wire/lib/streaming/peek.ts → dist/wire/lib/streaming/peek.d.ts} +13 -82
- package/dist/wire/lib/streaming/peek.js +100 -0
- package/dist/wire/lib/streaming/provider-decode.d.ts +57 -0
- package/dist/wire/lib/streaming/provider-decode.js +210 -0
- package/dist/wire/lib/streaming/response-stream.d.ts +16 -0
- package/dist/wire/lib/streaming/response-stream.js +64 -0
- package/dist/wire/lib/streaming/sse.d.ts +130 -0
- package/dist/wire/lib/streaming/sse.js +600 -0
- package/dist/wire/lib/streaming/strip-tool-calls.d.ts +14 -0
- package/dist/wire/lib/streaming/strip-tool-calls.js +75 -0
- package/dist/wire/lib/streaming/upstream-error.d.ts +32 -0
- package/dist/wire/lib/streaming/upstream-error.js +45 -0
- package/dist/wire/lib/strip-subagent-isolation.d.ts +16 -0
- package/dist/wire/lib/strip-subagent-isolation.js +240 -0
- package/dist/wire/lib/thinking-signature.d.ts +56 -0
- package/{wire/lib/thinking-signature.ts → dist/wire/lib/thinking-signature.js} +77 -84
- package/dist/wire/lib/token-ruler/bpe-core.d.ts +105 -0
- package/dist/wire/lib/token-ruler/bpe-core.js +398 -0
- package/dist/wire/lib/token-ruler/index.d.ts +2 -0
- package/dist/wire/lib/token-ruler/index.js +2 -0
- package/dist/wire/lib/token-ruler/ruler.d.ts +36 -0
- package/dist/wire/lib/token-ruler/ruler.js +50 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.d.ts +14 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.js +16 -0
- package/{wire/lib/token-ruler/vocab/claude.ts → dist/wire/lib/token-ruler/vocab/claude.d.ts} +2 -12
- package/dist/wire/lib/token-ruler/vocab/claude.js +8 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.d.ts +3 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.js +18 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.d.ts +11 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.js +6 -0
- package/dist/wire/lib/tool-name-map.d.ts +44 -0
- package/dist/wire/lib/tool-name-map.js +186 -0
- package/dist/wire/lib/tool-schema.d.ts +15 -0
- package/dist/wire/lib/tool-schema.js +307 -0
- package/dist/wire/lib/usage-observer.d.ts +9 -0
- package/dist/wire/lib/usage-observer.js +108 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.d.ts +125 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.js +221 -0
- package/dist/wire/providers/anthropic/beta-headers.d.ts +44 -0
- package/{wire/providers/anthropic/beta-headers.ts → dist/wire/providers/anthropic/beta-headers.js} +57 -79
- package/dist/wire/providers/anthropic/index.d.ts +6 -0
- package/{wire/providers/anthropic/index.ts → dist/wire/providers/anthropic/index.js} +6 -6
- package/dist/wire/providers/anthropic/request.d.ts +12 -0
- package/dist/wire/providers/anthropic/request.js +456 -0
- package/dist/wire/providers/anthropic/response.d.ts +3 -0
- package/dist/wire/providers/anthropic/response.js +126 -0
- package/dist/wire/providers/anthropic/streaming.d.ts +28 -0
- package/dist/wire/providers/anthropic/streaming.js +268 -0
- package/dist/wire/providers/anthropic/web-search-domains.d.ts +7 -0
- package/dist/wire/providers/anthropic/web-search-domains.js +36 -0
- package/dist/wire/providers/chatgpt/common.d.ts +27 -0
- package/{wire/providers/chatgpt/common.ts → dist/wire/providers/chatgpt/common.js} +69 -89
- package/dist/wire/providers/chatgpt/index.d.ts +4 -0
- package/{wire/providers/chatgpt/index.ts → dist/wire/providers/chatgpt/index.js} +4 -4
- package/dist/wire/providers/chatgpt/request.d.ts +132 -0
- package/dist/wire/providers/chatgpt/request.js +696 -0
- package/dist/wire/providers/chatgpt/streaming.d.ts +69 -0
- package/dist/wire/providers/chatgpt/streaming.js +761 -0
- package/dist/wire/providers/chatgpt/web-search.d.ts +19 -0
- package/dist/wire/providers/chatgpt/web-search.js +55 -0
- package/dist/wire/providers/grok/web-search.d.ts +23 -0
- package/dist/wire/providers/grok/web-search.js +74 -0
- package/dist/wire/providers/kimi/web-search.d.ts +48 -0
- package/dist/wire/providers/kimi/web-search.js +106 -0
- package/dist/wire/providers/upstream-deny.d.ts +61 -0
- package/dist/wire/providers/upstream-deny.js +293 -0
- package/dist/wire/providers/upstream-request.d.ts +104 -0
- package/dist/wire/providers/upstream-request.js +411 -0
- package/package.json +105 -23
- package/ARCHITECTURE.md +0 -43
- package/client/chat.ts +0 -140
- package/client/devices.ts +0 -269
- package/client/http.ts +0 -72
- package/client/index.ts +0 -129
- package/client/relay-mux.ts +0 -547
- package/client/types.ts +0 -51
- package/client/vault.ts +0 -239
- package/connect/chat.ts +0 -58
- package/connect/client.ts +0 -240
- package/connect/config.ts +0 -47
- package/connect/errors.ts +0 -121
- package/connect/oauth.ts +0 -265
- package/connect/routes.ts +0 -234
- package/connect/store.ts +0 -107
- package/mcp/handle.ts +0 -24
- package/mcp/index.ts +0 -76
- package/mcp/server.ts +0 -319
- package/mcp/tools/marketplace.ts +0 -439
- package/mcp/tools/memory-client.ts +0 -297
- package/mcp/tools/memory-config.ts +0 -32
- package/mcp/tools/memory.ts +0 -369
- package/mcp/tools/model-priority.ts +0 -88
- package/mcp/tools/openllm.ts +0 -883
- package/mcp/types.ts +0 -28
- package/openapi/call.ts +0 -90
- package/openapi/index.ts +0 -8
- package/openapi/openapi.json +0 -80213
- package/openapi/operations.ts +0 -2075
- package/protocol/CONTRIBUTING.md +0 -21
- package/protocol/README.md +0 -134
- package/protocol/access.ts +0 -186
- package/protocol/agent.ts +0 -991
- package/protocol/api-key-syntax.ts +0 -105
- package/protocol/assets/openllm-light.svg +0 -18
- package/protocol/assets/openllm.svg +0 -18
- package/protocol/audio.ts +0 -29
- package/protocol/auth.ts +0 -142
- package/protocol/changelog.ts +0 -155
- package/protocol/chat.ts +0 -458
- package/protocol/client-registry.ts +0 -356
- package/protocol/config.ts +0 -345
- package/protocol/cooldown-reason.ts +0 -78
- package/protocol/cost.ts +0 -10
- package/protocol/daemon-port.ts +0 -31
- package/protocol/daemon.ts +0 -1524
- package/protocol/default-chains.ts +0 -66
- package/protocol/device-state.ts +0 -85
- package/protocol/doctor-report.ts +0 -947
- package/protocol/errors.ts +0 -14
- package/protocol/image-edit-parse.ts +0 -263
- package/protocol/images.ts +0 -298
- package/protocol/index.ts +0 -74
- package/protocol/keepalive.ts +0 -69
- package/protocol/local-auth.ts +0 -300
- package/protocol/local-provider.ts +0 -288
- package/protocol/local-session.ts +0 -118
- package/protocol/marketplace.ts +0 -187
- package/protocol/media-bytes.ts +0 -28
- package/protocol/media-default.ts +0 -357
- package/protocol/media-input.ts +0 -61
- package/protocol/media-model.ts +0 -142
- package/protocol/media-types.ts +0 -70
- package/protocol/model-match.ts +0 -1051
- package/protocol/model-settings.ts +0 -327
- package/protocol/models.ts +0 -767
- package/protocol/mux.ts +0 -722
- package/protocol/provider-status.ts +0 -206
- package/protocol/provider-usage.ts +0 -263
- package/protocol/providers.ts +0 -901
- package/protocol/public-usage-index.ts +0 -354
- package/protocol/registry-pointer.ts +0 -118
- package/protocol/responses.ts +0 -280
- package/protocol/semver.ts +0 -182
- package/protocol/sha256-hex.ts +0 -98
- package/protocol/stats.ts +0 -406
- package/protocol/streaming.ts +0 -19
- package/protocol/subscription-provider-compat.ts +0 -104
- package/protocol/subscription-provider.ts +0 -32
- package/protocol/transcription-encoding.ts +0 -76
- package/protocol/url-locality.ts +0 -288
- package/protocol/video-job-plan.ts +0 -50
- package/protocol/videos.ts +0 -227
- package/tsconfig.json +0 -14
- package/tunnel/ARCHITECTURE.md +0 -111
- package/tunnel/assets/openllm-light.svg +0 -18
- package/tunnel/assets/openllm.svg +0 -18
- package/tunnel/channel-envelope.ts +0 -139
- package/tunnel/codec.ts +0 -191
- package/tunnel/device-anchor.ts +0 -229
- package/tunnel/device-control.ts +0 -118
- package/tunnel/device-grant.ts +0 -173
- package/tunnel/fleet.ts +0 -77
- package/tunnel/index.ts +0 -22
- package/tunnel/mux.ts +0 -580
- package/tunnel/peer-link.ts +0 -390
- package/tunnel/rtc-auth.ts +0 -415
- package/tunnel/rtc-duplex.ts +0 -187
- package/tunnel/rtc-ice.ts +0 -136
- package/tunnel/secure.ts +0 -1298
- package/tunnel/stream-reset-error.ts +0 -14
- package/tunnel/streams.ts +0 -1430
- package/tunnel/team-grant.ts +0 -302
- package/tunnel/wire-bytes.ts +0 -102
- package/vault/ARCHITECTURE.md +0 -470
- package/vault/api-key.ts +0 -190
- package/vault/cli-auth-seal.ts +0 -157
- package/vault/cred-seal.ts +0 -146
- package/vault/credential.ts +0 -55
- package/vault/crypto.ts +0 -210
- package/vault/daemon-attest.ts +0 -229
- package/vault/derive.ts +0 -113
- package/vault/device-access.ts +0 -87
- package/vault/device-anchor.ts +0 -185
- package/vault/handoff.ts +0 -396
- package/vault/index.ts +0 -21
- package/vault/pin.ts +0 -153
- package/vault/public-key-seal.ts +0 -131
- package/vault/seed.ts +0 -272
- package/vault/team.ts +0 -355
- package/vault/vault-item.ts +0 -131
- package/vault/vault-migrate-digest.ts +0 -29
- package/vault/wrapped.ts +0 -77
- package/wire/ARCHITECTURE.md +0 -90
- package/wire/CONTRIBUTING.md +0 -19
- package/wire/adapters/messages/anthropic-map.ts +0 -37
- package/wire/adapters/messages/index.ts +0 -7
- package/wire/adapters/messages/reasoning-from-items.ts +0 -38
- package/wire/adapters/messages/reasoning-signature.ts +0 -243
- package/wire/adapters/messages/request.ts +0 -574
- package/wire/adapters/messages/response.ts +0 -215
- package/wire/adapters/messages/streaming.ts +0 -1027
- package/wire/adapters/messages/usage.ts +0 -43
- package/wire/adapters/responses/index.ts +0 -3
- package/wire/adapters/responses/request.ts +0 -395
- package/wire/adapters/responses/response.ts +0 -88
- package/wire/adapters/responses/streaming.ts +0 -344
- package/wire/assets/openllm-light.svg +0 -18
- package/wire/assets/openllm.svg +0 -18
- package/wire/features/account-rank.ts +0 -166
- package/wire/features/compaction/compact-request.ts +0 -862
- package/wire/features/compaction/compaction-text.ts +0 -43
- package/wire/features/context-demote.ts +0 -47
- package/wire/features/context-overflow-strategy.ts +0 -26
- package/wire/features/conversation-affinity.ts +0 -144
- package/wire/features/max-tokens-backfill.ts +0 -141
- package/wire/features/model-caps.ts +0 -53
- package/wire/features/model-settings.ts +0 -24
- package/wire/features/output-limit-clamp.ts +0 -64
- package/wire/features/quota-gate.ts +0 -85
- package/wire/index.ts +0 -44
- package/wire/lib/attempt-outcome.ts +0 -43
- package/wire/lib/canonical/count-tokens-capability.ts +0 -138
- package/wire/lib/canonical/image-signature.ts +0 -202
- package/wire/lib/canonical/image-sse.ts +0 -216
- package/wire/lib/canonical/token-estimate.ts +0 -266
- package/wire/lib/encrypted-content.ts +0 -66
- package/wire/lib/error-class.ts +0 -154
- package/wire/lib/error-envelope.ts +0 -56
- package/wire/lib/provider-error-rules.ts +0 -48
- package/wire/lib/responses-apply-patch.ts +0 -104
- package/wire/lib/secret-scrub.ts +0 -101
- package/wire/lib/streaming/accumulate.ts +0 -221
- package/wire/lib/streaming/finish-reason.ts +0 -33
- package/wire/lib/streaming/provider-decode.ts +0 -259
- package/wire/lib/streaming/response-stream.ts +0 -71
- package/wire/lib/streaming/sse.ts +0 -699
- package/wire/lib/streaming/strip-tool-calls.ts +0 -95
- package/wire/lib/streaming/upstream-error.ts +0 -58
- package/wire/lib/strip-subagent-isolation.ts +0 -284
- package/wire/lib/token-ruler/bpe-core.ts +0 -426
- package/wire/lib/token-ruler/index.ts +0 -2
- package/wire/lib/token-ruler/ruler.ts +0 -79
- package/wire/lib/token-ruler/vocab/claude-ranks.ts +0 -16
- package/wire/lib/token-ruler/vocab/o200k-ranks.ts +0 -18
- package/wire/lib/token-ruler/vocab/o200k.ts +0 -19
- package/wire/lib/tool-name-map.ts +0 -271
- package/wire/lib/tool-schema.ts +0 -353
- package/wire/lib/usage-observer.ts +0 -125
- package/wire/providers/anthropic/adaptive-thinking.ts +0 -291
- package/wire/providers/anthropic/request.ts +0 -607
- package/wire/providers/anthropic/response.ts +0 -155
- package/wire/providers/anthropic/streaming.ts +0 -315
- package/wire/providers/anthropic/web-search-domains.ts +0 -49
- package/wire/providers/chatgpt/request.ts +0 -959
- package/wire/providers/chatgpt/streaming.ts +0 -1007
- package/wire/providers/chatgpt/web-search.ts +0 -63
- package/wire/providers/grok/web-search.ts +0 -87
- package/wire/providers/kimi/web-search.ts +0 -145
- package/wire/providers/upstream-deny.ts +0 -355
- package/wire/providers/upstream-request.ts +0 -619
- /package/{protocol/inference-headers.ts → dist/protocol/inference-headers.js} +0 -0
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Origin-signed team device grant. Short-lived admission for a cross-user
|
|
3
|
+
* relay mux channel: the consumer may reach one contributor device for one
|
|
4
|
+
* model. Wire is labelled canonical JSON + HMAC-SHA256 (WebCrypto) under the
|
|
5
|
+
* per-contributor key derived at origin
|
|
6
|
+
* (`HMAC-SHA256(NEON_AUTH_COOKIE_SECRET, "openllm-team-grant-v1:" + userId)`).
|
|
7
|
+
* The contributor daemon verifies with the same key from bootstrap
|
|
8
|
+
* (`team_grant_key`). The relay does NOT verify — it only stamps
|
|
9
|
+
* `peer_user_id` and requires a non-empty `team_grant` for cross-user opens.
|
|
10
|
+
*
|
|
11
|
+
* Unknown future envelope fields are ignored on decode; the signed message is
|
|
12
|
+
* rebuilt from the known field set only, so a v2 verifier stays compatible
|
|
13
|
+
* when optional fields are added later (each optional is part of the signed
|
|
14
|
+
* bytes only when present). v1 (Ed25519) envelopes are rejected.
|
|
15
|
+
*/
|
|
16
|
+
import { TEAM_GRANT_B64_MAX } from "@openllmsh/sdk/protocol";
|
|
17
|
+
export { TEAM_GRANT_B64_MAX };
|
|
18
|
+
/** Canonical message label for the signed JSON body (format version). */
|
|
19
|
+
export declare const TEAM_GRANT_LABEL = "openllm-team-grant-v2";
|
|
20
|
+
export declare const TEAM_GRANT_VERSION: 2;
|
|
21
|
+
export declare const TEAM_GRANT_NONCE_BYTES = 16;
|
|
22
|
+
/** Room a direct-leg body may grow by after the caller measures it (the
|
|
23
|
+
* concrete model id and the output-limit field it gains). The caller
|
|
24
|
+
* reserves it inside `estimated_tokens`, so it is never outside a hold. */
|
|
25
|
+
export declare const TEAM_LEG_INPUT_SLACK_TOKENS = 64;
|
|
26
|
+
export type TTeamGrant = {
|
|
27
|
+
readonly v: 2;
|
|
28
|
+
readonly team_id: string;
|
|
29
|
+
readonly share_id: string;
|
|
30
|
+
/** Consumer user id (the member opening the channel). */
|
|
31
|
+
readonly consumer: string;
|
|
32
|
+
/** Contributor account that owns the serving device. */
|
|
33
|
+
readonly device_user_id: string;
|
|
34
|
+
/** Serving daemon api_key id. */
|
|
35
|
+
readonly device_key_id: string;
|
|
36
|
+
/** Model id the grant authorises on that device. */
|
|
37
|
+
readonly model: string;
|
|
38
|
+
/** 16-byte nonce, standard base64. */
|
|
39
|
+
readonly n: string;
|
|
40
|
+
/** Expiry, ms since epoch. */
|
|
41
|
+
readonly exp: number;
|
|
42
|
+
/**
|
|
43
|
+
* Optional local monthly token cap the contributor daemon enforces as a
|
|
44
|
+
* second line (origin already reserves). Absent = no local hard cap.
|
|
45
|
+
*/
|
|
46
|
+
readonly cap_tokens?: number;
|
|
47
|
+
/**
|
|
48
|
+
* Reservation-backed input bound on a direct leg: the caller's estimate
|
|
49
|
+
* plus {@link TEAM_LEG_INPUT_SLACK_TOKENS} for its own body edits.
|
|
50
|
+
*/
|
|
51
|
+
readonly max_input_tokens?: number;
|
|
52
|
+
/** Reservation-backed output bound on a direct leg. */
|
|
53
|
+
readonly max_output_tokens?: number;
|
|
54
|
+
readonly direct_leg?: true;
|
|
55
|
+
};
|
|
56
|
+
export type TTeamGrantEnvelope = TTeamGrant & {
|
|
57
|
+
readonly sig: string;
|
|
58
|
+
};
|
|
59
|
+
export type TTeamGrantSignFields = Omit<TTeamGrant, "v" | "n" | "exp"> & {
|
|
60
|
+
readonly n?: string;
|
|
61
|
+
readonly exp?: number;
|
|
62
|
+
readonly v?: 2;
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
|
|
66
|
+
* Fixed key order `v, team_id, share_id, consumer, device_user_id,
|
|
67
|
+
* device_key_id, model, n, exp[, cap_tokens]`.
|
|
68
|
+
*/
|
|
69
|
+
export declare const buildTeamGrantMessage: (fields: TTeamGrant) => Uint8Array;
|
|
70
|
+
/** base64(JSON) envelope encoding for the wire. */
|
|
71
|
+
export declare const encodeTeamGrant: (envelope: TTeamGrantEnvelope) => string;
|
|
72
|
+
/**
|
|
73
|
+
* Strict decode. An unknown key is refused, never ignored: a future
|
|
74
|
+
* restriction an older peer can't read must fail closed. Returns null on any
|
|
75
|
+
* unknown key or field mismatch (including rejected v1 envelopes).
|
|
76
|
+
*/
|
|
77
|
+
export declare const decodeTeamGrant: (b64: string) => TTeamGrantEnvelope | null;
|
|
78
|
+
export declare const hmacSha256Hex: (key: string, message: Uint8Array) => Promise<string | null>;
|
|
79
|
+
/**
|
|
80
|
+
* Sign a team grant with the per-contributor HMAC key (hex string, same
|
|
81
|
+
* shape as `perUserTeamGrantKey` / bootstrap `team_grant_key`). Returns the
|
|
82
|
+
* wire token, or null when the key is empty / HMAC fails.
|
|
83
|
+
*/
|
|
84
|
+
export declare const signTeamGrant: (fields: TTeamGrant, hmacKey: string) => Promise<string | null>;
|
|
85
|
+
/**
|
|
86
|
+
* Verify a team-grant wire token against a per-contributor HMAC key.
|
|
87
|
+
* Returns the grant fields when the signature matches (constant-time) and
|
|
88
|
+
* `exp > nowMs`; otherwise null. Never throws. Rejects v1 envelopes.
|
|
89
|
+
*/
|
|
90
|
+
export declare const verifyTeamGrant: (token: string, hmacKey: string, nowMs: number) => Promise<TTeamGrant | null>;
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Origin-signed team device grant. Short-lived admission for a cross-user
|
|
3
|
+
* relay mux channel: the consumer may reach one contributor device for one
|
|
4
|
+
* model. Wire is labelled canonical JSON + HMAC-SHA256 (WebCrypto) under the
|
|
5
|
+
* per-contributor key derived at origin
|
|
6
|
+
* (`HMAC-SHA256(NEON_AUTH_COOKIE_SECRET, "openllm-team-grant-v1:" + userId)`).
|
|
7
|
+
* The contributor daemon verifies with the same key from bootstrap
|
|
8
|
+
* (`team_grant_key`). The relay does NOT verify — it only stamps
|
|
9
|
+
* `peer_user_id` and requires a non-empty `team_grant` for cross-user opens.
|
|
10
|
+
*
|
|
11
|
+
* Unknown future envelope fields are ignored on decode; the signed message is
|
|
12
|
+
* rebuilt from the known field set only, so a v2 verifier stays compatible
|
|
13
|
+
* when optional fields are added later (each optional is part of the signed
|
|
14
|
+
* bytes only when present). v1 (Ed25519) envelopes are rejected.
|
|
15
|
+
*/
|
|
16
|
+
import { TEAM_GRANT_B64_MAX } from "@openllmsh/sdk/protocol";
|
|
17
|
+
import { decodeB64Json, encodeB64Json, isB64OfLength, isNonEmptyString, labelledMessage, } from "./wire-bytes.js";
|
|
18
|
+
export { TEAM_GRANT_B64_MAX };
|
|
19
|
+
/** Canonical message label for the signed JSON body (format version). */
|
|
20
|
+
export const TEAM_GRANT_LABEL = "openllm-team-grant-v2";
|
|
21
|
+
export const TEAM_GRANT_VERSION = 2;
|
|
22
|
+
export const TEAM_GRANT_NONCE_BYTES = 16;
|
|
23
|
+
/** Room a direct-leg body may grow by after the caller measures it (the
|
|
24
|
+
* concrete model id and the output-limit field it gains). The caller
|
|
25
|
+
* reserves it inside `estimated_tokens`, so it is never outside a hold. */
|
|
26
|
+
export const TEAM_LEG_INPUT_SLACK_TOKENS = 64;
|
|
27
|
+
const isValidNonce = (value) => isB64OfLength(value, TEAM_GRANT_NONCE_BYTES);
|
|
28
|
+
const isPositiveInt = (value) => typeof value === "number" &&
|
|
29
|
+
Number.isFinite(value) &&
|
|
30
|
+
Number.isInteger(value) &&
|
|
31
|
+
value > 0;
|
|
32
|
+
const isHex = (value) => value.length > 0 && value.length % 2 === 0 && /^[0-9a-f]+$/i.test(value);
|
|
33
|
+
const hexOf = (bytes) => {
|
|
34
|
+
let out = "";
|
|
35
|
+
for (let i = 0; i < bytes.length; i++) {
|
|
36
|
+
out += bytes[i].toString(16).padStart(2, "0");
|
|
37
|
+
}
|
|
38
|
+
return out;
|
|
39
|
+
};
|
|
40
|
+
const bytesOfHex = (hex) => {
|
|
41
|
+
if (!isHex(hex))
|
|
42
|
+
return null;
|
|
43
|
+
const out = new Uint8Array(hex.length / 2);
|
|
44
|
+
for (let i = 0; i < out.length; i++) {
|
|
45
|
+
const byte = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
|
|
46
|
+
if (!Number.isFinite(byte))
|
|
47
|
+
return null;
|
|
48
|
+
out[i] = byte;
|
|
49
|
+
}
|
|
50
|
+
return out;
|
|
51
|
+
};
|
|
52
|
+
/** Constant-time compare of equal-length byte arrays. */
|
|
53
|
+
const timingSafeEqual = (a, b) => {
|
|
54
|
+
if (a.length !== b.length)
|
|
55
|
+
return false;
|
|
56
|
+
let diff = 0;
|
|
57
|
+
for (let i = 0; i < a.length; i++) {
|
|
58
|
+
diff |= a[i] ^ b[i];
|
|
59
|
+
}
|
|
60
|
+
return diff === 0;
|
|
61
|
+
};
|
|
62
|
+
/**
|
|
63
|
+
* Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
|
|
64
|
+
* Fixed key order `v, team_id, share_id, consumer, device_user_id,
|
|
65
|
+
* device_key_id, model, n, exp[, cap_tokens]`.
|
|
66
|
+
*/
|
|
67
|
+
export const buildTeamGrantMessage = (fields) => labelledMessage(TEAM_GRANT_LABEL, JSON.stringify({
|
|
68
|
+
v: fields.v,
|
|
69
|
+
team_id: fields.team_id,
|
|
70
|
+
share_id: fields.share_id,
|
|
71
|
+
consumer: fields.consumer,
|
|
72
|
+
device_user_id: fields.device_user_id,
|
|
73
|
+
device_key_id: fields.device_key_id,
|
|
74
|
+
model: fields.model,
|
|
75
|
+
n: fields.n,
|
|
76
|
+
exp: fields.exp,
|
|
77
|
+
...(fields.cap_tokens === undefined
|
|
78
|
+
? {}
|
|
79
|
+
: { cap_tokens: fields.cap_tokens }),
|
|
80
|
+
...(fields.direct_leg === undefined
|
|
81
|
+
? {}
|
|
82
|
+
: { direct_leg: fields.direct_leg }),
|
|
83
|
+
...(fields.max_input_tokens === undefined
|
|
84
|
+
? {}
|
|
85
|
+
: { max_input_tokens: fields.max_input_tokens }),
|
|
86
|
+
...(fields.max_output_tokens === undefined
|
|
87
|
+
? {}
|
|
88
|
+
: { max_output_tokens: fields.max_output_tokens }),
|
|
89
|
+
}));
|
|
90
|
+
/** base64(JSON) envelope encoding for the wire. */
|
|
91
|
+
export const encodeTeamGrant = (envelope) => encodeB64Json(envelope, TEAM_GRANT_B64_MAX, "team grant exceeds TEAM_GRANT_B64_MAX");
|
|
92
|
+
/** Every key a grant envelope may carry; anything else is refused. */
|
|
93
|
+
const TEAM_GRANT_KEYS = new Set([
|
|
94
|
+
"v",
|
|
95
|
+
"team_id",
|
|
96
|
+
"share_id",
|
|
97
|
+
"consumer",
|
|
98
|
+
"device_user_id",
|
|
99
|
+
"device_key_id",
|
|
100
|
+
"model",
|
|
101
|
+
"n",
|
|
102
|
+
"exp",
|
|
103
|
+
"cap_tokens",
|
|
104
|
+
"direct_leg",
|
|
105
|
+
"max_input_tokens",
|
|
106
|
+
"max_output_tokens",
|
|
107
|
+
"sig",
|
|
108
|
+
]);
|
|
109
|
+
/**
|
|
110
|
+
* Strict decode. An unknown key is refused, never ignored: a future
|
|
111
|
+
* restriction an older peer can't read must fail closed. Returns null on any
|
|
112
|
+
* unknown key or field mismatch (including rejected v1 envelopes).
|
|
113
|
+
*/
|
|
114
|
+
export const decodeTeamGrant = (b64) => {
|
|
115
|
+
const o = decodeB64Json(b64, TEAM_GRANT_B64_MAX);
|
|
116
|
+
if (o === null)
|
|
117
|
+
return null;
|
|
118
|
+
if (Object.keys(o).some((key) => !TEAM_GRANT_KEYS.has(key)))
|
|
119
|
+
return null;
|
|
120
|
+
if (o.v !== TEAM_GRANT_VERSION)
|
|
121
|
+
return null;
|
|
122
|
+
if (!isNonEmptyString(o.team_id))
|
|
123
|
+
return null;
|
|
124
|
+
if (!isNonEmptyString(o.share_id))
|
|
125
|
+
return null;
|
|
126
|
+
if (!isNonEmptyString(o.consumer))
|
|
127
|
+
return null;
|
|
128
|
+
if (!isNonEmptyString(o.device_user_id))
|
|
129
|
+
return null;
|
|
130
|
+
if (!isNonEmptyString(o.device_key_id))
|
|
131
|
+
return null;
|
|
132
|
+
if (!isNonEmptyString(o.model))
|
|
133
|
+
return null;
|
|
134
|
+
if (!isValidNonce(o.n))
|
|
135
|
+
return null;
|
|
136
|
+
if (!isPositiveInt(o.exp))
|
|
137
|
+
return null;
|
|
138
|
+
if (!isNonEmptyString(o.sig) || !isHex(o.sig))
|
|
139
|
+
return null;
|
|
140
|
+
let capTokens;
|
|
141
|
+
if (o.cap_tokens !== undefined) {
|
|
142
|
+
if (!isPositiveInt(o.cap_tokens))
|
|
143
|
+
return null;
|
|
144
|
+
capTokens = o.cap_tokens;
|
|
145
|
+
}
|
|
146
|
+
if (o.direct_leg !== undefined && o.direct_leg !== true)
|
|
147
|
+
return null;
|
|
148
|
+
if (o.direct_leg === true &&
|
|
149
|
+
(!Number.isSafeInteger(o.max_input_tokens) ||
|
|
150
|
+
o.max_input_tokens < 0 ||
|
|
151
|
+
!isPositiveInt(o.max_output_tokens)))
|
|
152
|
+
return null;
|
|
153
|
+
if (o.direct_leg !== true &&
|
|
154
|
+
(o.max_output_tokens !== undefined || o.max_input_tokens !== undefined))
|
|
155
|
+
return null;
|
|
156
|
+
return {
|
|
157
|
+
v: TEAM_GRANT_VERSION,
|
|
158
|
+
team_id: o.team_id,
|
|
159
|
+
share_id: o.share_id,
|
|
160
|
+
consumer: o.consumer,
|
|
161
|
+
device_user_id: o.device_user_id,
|
|
162
|
+
device_key_id: o.device_key_id,
|
|
163
|
+
model: o.model,
|
|
164
|
+
n: o.n,
|
|
165
|
+
exp: o.exp,
|
|
166
|
+
...(capTokens === undefined ? {} : { cap_tokens: capTokens }),
|
|
167
|
+
...(o.direct_leg === true && isPositiveInt(o.max_output_tokens)
|
|
168
|
+
? {
|
|
169
|
+
direct_leg: true,
|
|
170
|
+
max_input_tokens: o.max_input_tokens,
|
|
171
|
+
max_output_tokens: o.max_output_tokens,
|
|
172
|
+
}
|
|
173
|
+
: {}),
|
|
174
|
+
sig: o.sig.toLowerCase(),
|
|
175
|
+
};
|
|
176
|
+
};
|
|
177
|
+
export const hmacSha256Hex = async (key, message) => {
|
|
178
|
+
if (key.length === 0)
|
|
179
|
+
return null;
|
|
180
|
+
try {
|
|
181
|
+
const cryptoKey = await globalThis.crypto.subtle.importKey("raw", new TextEncoder().encode(key), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
|
|
182
|
+
const sig = new Uint8Array(await globalThis.crypto.subtle.sign("HMAC", cryptoKey, message));
|
|
183
|
+
return hexOf(sig);
|
|
184
|
+
}
|
|
185
|
+
catch {
|
|
186
|
+
return null;
|
|
187
|
+
}
|
|
188
|
+
};
|
|
189
|
+
/**
|
|
190
|
+
* Sign a team grant with the per-contributor HMAC key (hex string, same
|
|
191
|
+
* shape as `perUserTeamGrantKey` / bootstrap `team_grant_key`). Returns the
|
|
192
|
+
* wire token, or null when the key is empty / HMAC fails.
|
|
193
|
+
*/
|
|
194
|
+
export const signTeamGrant = async (fields, hmacKey) => {
|
|
195
|
+
const message = buildTeamGrantMessage(fields);
|
|
196
|
+
const sig = await hmacSha256Hex(hmacKey, message);
|
|
197
|
+
if (sig === null)
|
|
198
|
+
return null;
|
|
199
|
+
return encodeTeamGrant({ ...fields, sig });
|
|
200
|
+
};
|
|
201
|
+
/**
|
|
202
|
+
* Verify a team-grant wire token against a per-contributor HMAC key.
|
|
203
|
+
* Returns the grant fields when the signature matches (constant-time) and
|
|
204
|
+
* `exp > nowMs`; otherwise null. Never throws. Rejects v1 envelopes.
|
|
205
|
+
*/
|
|
206
|
+
export const verifyTeamGrant = async (token, hmacKey, nowMs) => {
|
|
207
|
+
const envelope = decodeTeamGrant(token);
|
|
208
|
+
if (envelope === null)
|
|
209
|
+
return null;
|
|
210
|
+
if (envelope.exp <= nowMs)
|
|
211
|
+
return null;
|
|
212
|
+
if (hmacKey.length === 0)
|
|
213
|
+
return null;
|
|
214
|
+
const { sig, ...fields } = envelope;
|
|
215
|
+
const message = buildTeamGrantMessage(fields);
|
|
216
|
+
const expected = await hmacSha256Hex(hmacKey, message);
|
|
217
|
+
if (expected === null)
|
|
218
|
+
return null;
|
|
219
|
+
const a = bytesOfHex(expected);
|
|
220
|
+
const b = bytesOfHex(sig);
|
|
221
|
+
if (a === null || b === null)
|
|
222
|
+
return null;
|
|
223
|
+
if (!timingSafeEqual(a, b))
|
|
224
|
+
return null;
|
|
225
|
+
return fields;
|
|
226
|
+
};
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The two byte-level primitives every signed control-plane envelope shares
|
|
3
|
+
* (device grants, control-key rotations, device-sessions commands, daemon
|
|
4
|
+
* attestations): the canonical signed bytes and the base64(JSON) wire form.
|
|
5
|
+
* Bytes + JSON only — no crypto.
|
|
6
|
+
*/
|
|
7
|
+
/** Standard (padded) base64 of `bytes`. */
|
|
8
|
+
export declare const toB64Bytes: (bytes: Uint8Array) => string;
|
|
9
|
+
/** Inverse of {@link toB64Bytes}; null when `b64` is not valid standard base64. */
|
|
10
|
+
export declare const fromB64Bytes: (b64: string) => Uint8Array | null;
|
|
11
|
+
/**
|
|
12
|
+
* Canonical signed bytes: `utf8(label) || 0x00 || utf8(json)`. Callers build
|
|
13
|
+
* `json` from an object literal in a fixed key order, so identical fields
|
|
14
|
+
* give identical bytes on every runtime.
|
|
15
|
+
*/
|
|
16
|
+
export declare const labelledMessage: (label: string, json: string) => Uint8Array;
|
|
17
|
+
/**
|
|
18
|
+
* `base64(utf8(JSON.stringify(value)))`. Throws `RangeError(overflow)` when
|
|
19
|
+
* the result is longer than `max`, so an oversized envelope never reaches
|
|
20
|
+
* the wire.
|
|
21
|
+
*/
|
|
22
|
+
export declare const encodeB64Json: (value: unknown, max: number, overflow: string) => string;
|
|
23
|
+
/**
|
|
24
|
+
* Strict inverse of {@link encodeB64Json}: the parsed JSON object, or null
|
|
25
|
+
* when `b64` is empty, longer than `max`, not base64, not UTF-8, not JSON, or
|
|
26
|
+
* not a plain (non-array) object. Field validation is the caller's.
|
|
27
|
+
*/
|
|
28
|
+
export declare const decodeB64Json: (b64: string, max: number) => Record<string, unknown> | null;
|
|
29
|
+
/** A non-empty string field. */
|
|
30
|
+
export declare const isNonEmptyString: (value: unknown) => value is string;
|
|
31
|
+
/** True when `value` is standard base64 of exactly `bytes` bytes (a nonce). */
|
|
32
|
+
export declare const isB64OfLength: (value: unknown, bytes: number) => value is string;
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The two byte-level primitives every signed control-plane envelope shares
|
|
3
|
+
* (device grants, control-key rotations, device-sessions commands, daemon
|
|
4
|
+
* attestations): the canonical signed bytes and the base64(JSON) wire form.
|
|
5
|
+
* Bytes + JSON only — no crypto.
|
|
6
|
+
*/
|
|
7
|
+
/** Standard (padded) base64 of `bytes`. */
|
|
8
|
+
export const toB64Bytes = (bytes) => {
|
|
9
|
+
let bin = "";
|
|
10
|
+
for (let i = 0; i < bytes.length; i++) {
|
|
11
|
+
bin += String.fromCharCode(bytes[i]);
|
|
12
|
+
}
|
|
13
|
+
return btoa(bin);
|
|
14
|
+
};
|
|
15
|
+
/** Inverse of {@link toB64Bytes}; null when `b64` is not valid standard base64. */
|
|
16
|
+
export const fromB64Bytes = (b64) => {
|
|
17
|
+
try {
|
|
18
|
+
const bin = atob(b64);
|
|
19
|
+
const out = new Uint8Array(bin.length);
|
|
20
|
+
for (let i = 0; i < bin.length; i++)
|
|
21
|
+
out[i] = bin.charCodeAt(i);
|
|
22
|
+
return out;
|
|
23
|
+
}
|
|
24
|
+
catch {
|
|
25
|
+
return null;
|
|
26
|
+
}
|
|
27
|
+
};
|
|
28
|
+
/**
|
|
29
|
+
* Canonical signed bytes: `utf8(label) || 0x00 || utf8(json)`. Callers build
|
|
30
|
+
* `json` from an object literal in a fixed key order, so identical fields
|
|
31
|
+
* give identical bytes on every runtime.
|
|
32
|
+
*/
|
|
33
|
+
export const labelledMessage = (label, json) => {
|
|
34
|
+
const enc = new TextEncoder();
|
|
35
|
+
const head = enc.encode(label);
|
|
36
|
+
const body = enc.encode(json);
|
|
37
|
+
const out = new Uint8Array(head.length + 1 + body.length);
|
|
38
|
+
out.set(head, 0);
|
|
39
|
+
out[head.length] = 0x00;
|
|
40
|
+
out.set(body, head.length + 1);
|
|
41
|
+
return out;
|
|
42
|
+
};
|
|
43
|
+
/**
|
|
44
|
+
* `base64(utf8(JSON.stringify(value)))`. Throws `RangeError(overflow)` when
|
|
45
|
+
* the result is longer than `max`, so an oversized envelope never reaches
|
|
46
|
+
* the wire.
|
|
47
|
+
*/
|
|
48
|
+
export const encodeB64Json = (value, max, overflow) => {
|
|
49
|
+
const b64 = toB64Bytes(new TextEncoder().encode(JSON.stringify(value)));
|
|
50
|
+
if (b64.length > max)
|
|
51
|
+
throw new RangeError(overflow);
|
|
52
|
+
return b64;
|
|
53
|
+
};
|
|
54
|
+
/**
|
|
55
|
+
* Strict inverse of {@link encodeB64Json}: the parsed JSON object, or null
|
|
56
|
+
* when `b64` is empty, longer than `max`, not base64, not UTF-8, not JSON, or
|
|
57
|
+
* not a plain (non-array) object. Field validation is the caller's.
|
|
58
|
+
*/
|
|
59
|
+
export const decodeB64Json = (b64, max) => {
|
|
60
|
+
if (b64.length === 0 || b64.length > max)
|
|
61
|
+
return null;
|
|
62
|
+
let parsed;
|
|
63
|
+
try {
|
|
64
|
+
const bin = atob(b64);
|
|
65
|
+
const bytes = new Uint8Array(bin.length);
|
|
66
|
+
for (let i = 0; i < bin.length; i++)
|
|
67
|
+
bytes[i] = bin.charCodeAt(i);
|
|
68
|
+
parsed = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
|
|
69
|
+
}
|
|
70
|
+
catch {
|
|
71
|
+
return null;
|
|
72
|
+
}
|
|
73
|
+
if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
74
|
+
return null;
|
|
75
|
+
}
|
|
76
|
+
return parsed;
|
|
77
|
+
};
|
|
78
|
+
/** A non-empty string field. */
|
|
79
|
+
export const isNonEmptyString = (value) => typeof value === "string" && value.length > 0;
|
|
80
|
+
/** True when `value` is standard base64 of exactly `bytes` bytes (a nonce). */
|
|
81
|
+
export const isB64OfLength = (value, bytes) => {
|
|
82
|
+
if (!isNonEmptyString(value))
|
|
83
|
+
return false;
|
|
84
|
+
try {
|
|
85
|
+
return atob(value).length === bytes;
|
|
86
|
+
}
|
|
87
|
+
catch {
|
|
88
|
+
return false;
|
|
89
|
+
}
|
|
90
|
+
};
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { OPENLLM_API_KEY_PREFIX } from "@openllmsh/sdk/protocol";
|
|
2
|
+
export { OPENLLM_API_KEY_PREFIX as API_KEY_PREFIX };
|
|
3
|
+
/**
|
|
4
|
+
* `sk-llm-{id}.{secret}` parser. The id is the api_keys row primary
|
|
5
|
+
* key (base64url, no padding); the secret is 32 random bytes
|
|
6
|
+
* base64url-encoded. Returns null on any shape mismatch — the proxy
|
|
7
|
+
* auth path treats null as "no key supplied".
|
|
8
|
+
*/
|
|
9
|
+
export declare const parseApiKey: (raw: string) => {
|
|
10
|
+
readonly id: string;
|
|
11
|
+
readonly secret: Uint8Array;
|
|
12
|
+
} | null;
|
|
13
|
+
/**
|
|
14
|
+
* Derive the per-key AES wrap key from the secret half of the
|
|
15
|
+
* `sk-llm-...` token. Same on both sides of the handshake — the
|
|
16
|
+
* browser uses it to wrap the DEK at mint time, the server uses it
|
|
17
|
+
* to unwrap on every request.
|
|
18
|
+
*/
|
|
19
|
+
export declare const deriveApiWrapKey: (apiKeySecret: Uint8Array, apiKeyId: string) => Promise<Uint8Array>;
|
|
20
|
+
/**
|
|
21
|
+
* Unwrap a `dek_for_key` row column. The stored layout is
|
|
22
|
+
* `IV (12) || ciphertext+tag`, base64-encoded.
|
|
23
|
+
*
|
|
24
|
+
* Unversioned on purpose, unlike the phrase and PIN wraps: this key comes from
|
|
25
|
+
* HKDF over the API-key secret, which has no cost parameters to re-tune, so
|
|
26
|
+
* there is nothing a stamp could ever select between.
|
|
27
|
+
*/
|
|
28
|
+
export declare const unwrapDekForKey: (dekForKeyB64: string, apiWrapKey: Uint8Array) => Promise<Uint8Array>;
|
|
29
|
+
export type TMintedApiKey = {
|
|
30
|
+
/** Body for `POST /api/keys` — server persists row keyed by id. */
|
|
31
|
+
readonly row: {
|
|
32
|
+
readonly id: string;
|
|
33
|
+
readonly dek_for_key: string;
|
|
34
|
+
readonly secret_ciphertext: string;
|
|
35
|
+
readonly secret_nonce: string;
|
|
36
|
+
readonly vault_version: number;
|
|
37
|
+
};
|
|
38
|
+
/**
|
|
39
|
+
* The `sk-llm-{id}.{secret}` string shown ONCE. The server never
|
|
40
|
+
* sees this in plaintext; an AES-GCM(sk-llm, DEK) copy ships with
|
|
41
|
+
* the row so the dashboard can re-display it when the vault is
|
|
42
|
+
* unlocked.
|
|
43
|
+
*/
|
|
44
|
+
readonly sk_llm: string;
|
|
45
|
+
};
|
|
46
|
+
/**
|
|
47
|
+
* Mint a new API key client-side. The browser:
|
|
48
|
+
* 1. picks `(api_key_id, api_key_secret)`,
|
|
49
|
+
* 2. derives `api_wrap_key = HKDF(secret, id)`,
|
|
50
|
+
* 3. wraps the user's DEK under it,
|
|
51
|
+
* 4. ALSO encrypts the full sk-llm string under the user's DEK so
|
|
52
|
+
* the dashboard can re-display it when unlocked,
|
|
53
|
+
* 5. POSTs `{ id, dek_for_key, secret_ciphertext, secret_nonce,
|
|
54
|
+
* vault_version }` to `/api/keys`,
|
|
55
|
+
* 6. shows `sk-llm-{id}.{secret_b64url}` once.
|
|
56
|
+
*/
|
|
57
|
+
export declare const mintApiKey: (dek: Uint8Array, vaultVersion: number) => Promise<TMintedApiKey>;
|
|
58
|
+
/** The secret columns of an `api_keys` row re-wrapped under a new DEK. */
|
|
59
|
+
export type TRewrappedApiKey = {
|
|
60
|
+
readonly dek_for_key: string;
|
|
61
|
+
readonly secret_ciphertext: string;
|
|
62
|
+
readonly secret_nonce: string;
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* Re-wrap an existing API key for a new DEK (the seed-only vault's one-time
|
|
66
|
+
* migration, docs/plans/seed-only-vault.md). The browser opens the key's
|
|
67
|
+
* `secret_ciphertext` with the OLD DEK to get the `sk-llm` token, then calls
|
|
68
|
+
* this with the NEW DEK: the token itself is unchanged, so every daemon and
|
|
69
|
+
* client holding it keeps working. Never zeroes its inputs.
|
|
70
|
+
*/
|
|
71
|
+
export declare const rewrapApiKey: (skLlm: string, newDek: Uint8Array) => Promise<TRewrappedApiKey>;
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { isOpenllmApiKeySyntax, OPENLLM_API_KEY_ID_BYTES, OPENLLM_API_KEY_PREFIX, OPENLLM_API_KEY_SECRET_BYTES, } from "@openllmsh/sdk/protocol";
|
|
2
|
+
import { aesGcmDecrypt, aesGcmEncrypt, fromB64, fromB64Url, hkdfSha256, randomBytes, toB64, toB64Url, } from "./crypto.js";
|
|
3
|
+
import { sealVaultText } from "./vault-item.js";
|
|
4
|
+
import { joinSealed, splitSealed } from "./wrapped.js";
|
|
5
|
+
const DEK_BYTES = 32;
|
|
6
|
+
const HKDF_INFO = "api-key-v1";
|
|
7
|
+
const NONCE_BYTES = 12;
|
|
8
|
+
export { OPENLLM_API_KEY_PREFIX as API_KEY_PREFIX };
|
|
9
|
+
/**
|
|
10
|
+
* `sk-llm-{id}.{secret}` parser. The id is the api_keys row primary
|
|
11
|
+
* key (base64url, no padding); the secret is 32 random bytes
|
|
12
|
+
* base64url-encoded. Returns null on any shape mismatch — the proxy
|
|
13
|
+
* auth path treats null as "no key supplied".
|
|
14
|
+
*/
|
|
15
|
+
export const parseApiKey = (raw) => {
|
|
16
|
+
if (!isOpenllmApiKeySyntax(raw))
|
|
17
|
+
return null;
|
|
18
|
+
const rest = raw.slice(OPENLLM_API_KEY_PREFIX.length);
|
|
19
|
+
const dot = rest.indexOf(".");
|
|
20
|
+
if (dot <= 0 || dot === rest.length - 1)
|
|
21
|
+
return null;
|
|
22
|
+
const id = rest.slice(0, dot);
|
|
23
|
+
try {
|
|
24
|
+
const secret = fromB64Url(rest.slice(dot + 1));
|
|
25
|
+
if (secret.length !== OPENLLM_API_KEY_SECRET_BYTES)
|
|
26
|
+
return null;
|
|
27
|
+
return { id, secret };
|
|
28
|
+
}
|
|
29
|
+
catch {
|
|
30
|
+
return null;
|
|
31
|
+
}
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* Derive the per-key AES wrap key from the secret half of the
|
|
35
|
+
* `sk-llm-...` token. Same on both sides of the handshake — the
|
|
36
|
+
* browser uses it to wrap the DEK at mint time, the server uses it
|
|
37
|
+
* to unwrap on every request.
|
|
38
|
+
*/
|
|
39
|
+
export const deriveApiWrapKey = (apiKeySecret, apiKeyId) => {
|
|
40
|
+
return hkdfSha256(apiKeySecret, fromB64Url(apiKeyId), HKDF_INFO, 32);
|
|
41
|
+
};
|
|
42
|
+
/**
|
|
43
|
+
* Unwrap a `dek_for_key` row column. The stored layout is
|
|
44
|
+
* `IV (12) || ciphertext+tag`, base64-encoded.
|
|
45
|
+
*
|
|
46
|
+
* Unversioned on purpose, unlike the phrase and PIN wraps: this key comes from
|
|
47
|
+
* HKDF over the API-key secret, which has no cost parameters to re-tune, so
|
|
48
|
+
* there is nothing a stamp could ever select between.
|
|
49
|
+
*/
|
|
50
|
+
export const unwrapDekForKey = async (dekForKeyB64, apiWrapKey) => {
|
|
51
|
+
const { nonce, ciphertext } = splitSealed(fromB64(dekForKeyB64), "dek_for_key blob");
|
|
52
|
+
const dek = await aesGcmDecrypt(apiWrapKey, nonce, ciphertext);
|
|
53
|
+
// This runs on the proxy hot path for every `/v1/*` request. A DEK of the
|
|
54
|
+
// wrong size would otherwise surface several frames later as an opaque
|
|
55
|
+
// WebCrypto key-length error on whichever credential happened to decrypt first.
|
|
56
|
+
if (dek.length !== DEK_BYTES) {
|
|
57
|
+
dek.fill(0);
|
|
58
|
+
throw new Error("dek_for_key did not contain a 32-byte key");
|
|
59
|
+
}
|
|
60
|
+
return dek;
|
|
61
|
+
};
|
|
62
|
+
const newApiKeyId = () => toB64Url(randomBytes(OPENLLM_API_KEY_ID_BYTES));
|
|
63
|
+
/**
|
|
64
|
+
* Mint a new API key client-side. The browser:
|
|
65
|
+
* 1. picks `(api_key_id, api_key_secret)`,
|
|
66
|
+
* 2. derives `api_wrap_key = HKDF(secret, id)`,
|
|
67
|
+
* 3. wraps the user's DEK under it,
|
|
68
|
+
* 4. ALSO encrypts the full sk-llm string under the user's DEK so
|
|
69
|
+
* the dashboard can re-display it when unlocked,
|
|
70
|
+
* 5. POSTs `{ id, dek_for_key, secret_ciphertext, secret_nonce,
|
|
71
|
+
* vault_version }` to `/api/keys`,
|
|
72
|
+
* 6. shows `sk-llm-{id}.{secret_b64url}` once.
|
|
73
|
+
*/
|
|
74
|
+
export const mintApiKey = async (dek, vaultVersion) => {
|
|
75
|
+
const apiKeyId = newApiKeyId();
|
|
76
|
+
const apiKeySecret = randomBytes(OPENLLM_API_KEY_SECRET_BYTES);
|
|
77
|
+
const wrapKey = await deriveApiWrapKey(apiKeySecret, apiKeyId);
|
|
78
|
+
try {
|
|
79
|
+
const nonce = randomBytes(NONCE_BYTES);
|
|
80
|
+
const ct = await aesGcmEncrypt(wrapKey, nonce, dek);
|
|
81
|
+
const dekForKey = joinSealed(nonce, ct);
|
|
82
|
+
const skLlm = `${OPENLLM_API_KEY_PREFIX}${apiKeyId}.${toB64Url(apiKeySecret)}`;
|
|
83
|
+
// Wrap the full token under the `keys` branch so the dashboard can
|
|
84
|
+
// re-display it later. Distinct from `dek_for_key` (still under the
|
|
85
|
+
// API-key wrap key — the server needs the root).
|
|
86
|
+
const sealedSecret = await sealVaultText(dek, { branch: "keys" }, skLlm);
|
|
87
|
+
return {
|
|
88
|
+
row: {
|
|
89
|
+
id: apiKeyId,
|
|
90
|
+
dek_for_key: toB64(dekForKey),
|
|
91
|
+
secret_ciphertext: sealedSecret.ciphertext,
|
|
92
|
+
secret_nonce: sealedSecret.nonce,
|
|
93
|
+
vault_version: vaultVersion,
|
|
94
|
+
},
|
|
95
|
+
sk_llm: skLlm,
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
finally {
|
|
99
|
+
wrapKey.fill(0);
|
|
100
|
+
}
|
|
101
|
+
};
|
|
102
|
+
/**
|
|
103
|
+
* Re-wrap an existing API key for a new DEK (the seed-only vault's one-time
|
|
104
|
+
* migration, docs/plans/seed-only-vault.md). The browser opens the key's
|
|
105
|
+
* `secret_ciphertext` with the OLD DEK to get the `sk-llm` token, then calls
|
|
106
|
+
* this with the NEW DEK: the token itself is unchanged, so every daemon and
|
|
107
|
+
* client holding it keeps working. Never zeroes its inputs.
|
|
108
|
+
*/
|
|
109
|
+
export const rewrapApiKey = async (skLlm, newDek) => {
|
|
110
|
+
if (newDek.length !== DEK_BYTES)
|
|
111
|
+
throw new Error("DEK must be 32 bytes");
|
|
112
|
+
const parsed = parseApiKey(skLlm);
|
|
113
|
+
if (parsed === null)
|
|
114
|
+
throw new Error("not an OpenLLM API key");
|
|
115
|
+
const wrapKey = await deriveApiWrapKey(parsed.secret, parsed.id);
|
|
116
|
+
try {
|
|
117
|
+
const nonce = randomBytes(NONCE_BYTES);
|
|
118
|
+
const dekForKey = joinSealed(nonce, await aesGcmEncrypt(wrapKey, nonce, newDek));
|
|
119
|
+
const sealedSecret = await sealVaultText(newDek, { branch: "keys" }, skLlm);
|
|
120
|
+
return {
|
|
121
|
+
dek_for_key: toB64(dekForKey),
|
|
122
|
+
secret_ciphertext: sealedSecret.ciphertext,
|
|
123
|
+
secret_nonce: sealedSecret.nonce,
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
finally {
|
|
127
|
+
wrapKey.fill(0);
|
|
128
|
+
parsed.secret.fill(0);
|
|
129
|
+
}
|
|
130
|
+
};
|