@openllmsh/sdk 2.10.12-alpha.0 → 2.10.12-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -7
- package/dist/client/chat.d.ts +38 -0
- package/dist/client/chat.js +77 -0
- package/dist/client/devices.d.ts +70 -0
- package/dist/client/devices.js +172 -0
- package/dist/client/http.d.ts +24 -0
- package/dist/client/http.js +34 -0
- package/dist/client/index.d.ts +43 -0
- package/dist/client/index.js +57 -0
- package/dist/client/relay-mux.d.ts +71 -0
- package/dist/client/relay-mux.js +394 -0
- package/dist/client/types.d.ts +47 -0
- package/dist/client/types.js +5 -0
- package/dist/client/vault.d.ts +68 -0
- package/dist/client/vault.js +113 -0
- package/dist/connect/chat.d.ts +24 -0
- package/dist/connect/chat.js +25 -0
- package/dist/connect/client.d.ts +50 -0
- package/dist/connect/client.js +141 -0
- package/dist/connect/config.d.ts +22 -0
- package/dist/connect/config.js +22 -0
- package/dist/connect/errors.d.ts +32 -0
- package/dist/connect/errors.js +85 -0
- package/{connect/index.ts → dist/connect/index.d.ts} +7 -7
- package/dist/connect/index.js +23 -0
- package/dist/connect/oauth.d.ts +51 -0
- package/dist/connect/oauth.js +150 -0
- package/dist/connect/routes.d.ts +38 -0
- package/dist/connect/routes.js +175 -0
- package/dist/connect/store.d.ts +26 -0
- package/dist/connect/store.js +65 -0
- package/dist/mcp/handle.d.ts +6 -0
- package/dist/mcp/handle.js +6 -0
- package/dist/mcp/index.d.ts +15 -0
- package/dist/mcp/index.js +10 -0
- package/dist/mcp/server.d.ts +84 -0
- package/dist/mcp/server.js +168 -0
- package/dist/mcp/tools/marketplace.d.ts +94 -0
- package/dist/mcp/tools/marketplace.js +303 -0
- package/dist/mcp/tools/memory-client.d.ts +109 -0
- package/dist/mcp/tools/memory-client.js +200 -0
- package/dist/mcp/tools/memory-config.d.ts +29 -0
- package/dist/mcp/tools/memory-config.js +12 -0
- package/dist/mcp/tools/memory.d.ts +92 -0
- package/dist/mcp/tools/memory.js +312 -0
- package/dist/mcp/tools/model-priority.d.ts +16 -0
- package/dist/mcp/tools/model-priority.js +87 -0
- package/dist/mcp/tools/openllm.d.ts +75 -0
- package/dist/mcp/tools/openllm.js +715 -0
- package/dist/mcp/types.d.ts +25 -0
- package/dist/mcp/types.js +7 -0
- package/dist/openapi/call.d.ts +26 -0
- package/dist/openapi/call.js +56 -0
- package/dist/openapi/index.d.ts +2 -0
- package/dist/openapi/index.js +2 -0
- package/dist/openapi/openapi.json +80213 -0
- package/dist/openapi/operations.d.ts +14 -0
- package/dist/openapi/operations.js +2060 -0
- package/dist/protocol/access.d.ts +81 -0
- package/dist/protocol/access.js +125 -0
- package/dist/protocol/agent-prompt-text.d.ts +15 -0
- package/{protocol/agent-prompt-text.ts → dist/protocol/agent-prompt-text.js} +9 -14
- package/dist/protocol/agent.d.ts +1487 -0
- package/dist/protocol/agent.js +787 -0
- package/dist/protocol/api-key-syntax.d.ts +58 -0
- package/dist/protocol/api-key-syntax.js +73 -0
- package/dist/protocol/audio.d.ts +18 -0
- package/dist/protocol/audio.js +21 -0
- package/dist/protocol/auth.d.ts +126 -0
- package/dist/protocol/auth.js +119 -0
- package/dist/protocol/changelog.d.ts +69 -0
- package/dist/protocol/changelog.js +107 -0
- package/dist/protocol/chat.d.ts +789 -0
- package/dist/protocol/chat.js +394 -0
- package/dist/protocol/client-registry.d.ts +151 -0
- package/dist/protocol/client-registry.js +238 -0
- package/dist/protocol/config.d.ts +508 -0
- package/dist/protocol/config.js +289 -0
- package/dist/protocol/control-channel.d.ts +102 -0
- package/{protocol/control-channel.ts → dist/protocol/control-channel.js} +33 -61
- package/dist/protocol/cooldown-reason.d.ts +30 -0
- package/dist/protocol/cooldown-reason.js +44 -0
- package/dist/protocol/cost.d.ts +9 -0
- package/dist/protocol/cost.js +8 -0
- package/dist/protocol/daemon-port.d.ts +2 -0
- package/dist/protocol/daemon-port.js +28 -0
- package/dist/protocol/daemon.d.ts +2034 -0
- package/dist/protocol/daemon.js +1286 -0
- package/dist/protocol/default-chains.d.ts +15 -0
- package/dist/protocol/default-chains.js +21 -0
- package/dist/protocol/device-state.d.ts +223 -0
- package/dist/protocol/device-state.js +52 -0
- package/dist/protocol/doctor-report-local.d.ts +105 -0
- package/{protocol/doctor-report-local.ts → dist/protocol/doctor-report-local.js} +92 -196
- package/dist/protocol/doctor-report-policy.d.ts +62 -0
- package/{protocol/doctor-report-policy.ts → dist/protocol/doctor-report-policy.js} +23 -76
- package/dist/protocol/doctor-report.d.ts +406 -0
- package/dist/protocol/doctor-report.js +645 -0
- package/dist/protocol/errors.d.ts +17 -0
- package/dist/protocol/errors.js +10 -0
- package/dist/protocol/execution-selection.d.ts +92 -0
- package/{protocol/execution-selection.ts → dist/protocol/execution-selection.js} +38 -63
- package/dist/protocol/hop-grant.d.ts +28 -0
- package/{protocol/hop-grant.ts → dist/protocol/hop-grant.js} +7 -13
- package/dist/protocol/image-edit-parse.d.ts +25 -0
- package/dist/protocol/image-edit-parse.js +196 -0
- package/dist/protocol/images.d.ts +288 -0
- package/dist/protocol/images.js +229 -0
- package/dist/protocol/index.d.ts +69 -0
- package/dist/protocol/index.js +74 -0
- package/dist/protocol/inference-headers.d.ts +3 -0
- package/dist/protocol/keepalive.d.ts +36 -0
- package/dist/protocol/keepalive.js +51 -0
- package/dist/protocol/local-auth.d.ts +125 -0
- package/dist/protocol/local-auth.js +227 -0
- package/dist/protocol/local-device-control.d.ts +108 -0
- package/{protocol/local-device-control.ts → dist/protocol/local-device-control.js} +40 -70
- package/dist/protocol/local-provider.d.ts +105 -0
- package/dist/protocol/local-provider.js +213 -0
- package/dist/protocol/local-session.d.ts +70 -0
- package/dist/protocol/local-session.js +87 -0
- package/dist/protocol/marketplace.d.ts +190 -0
- package/dist/protocol/marketplace.js +140 -0
- package/{protocol/media-attempt.ts → dist/protocol/media-attempt.d.ts} +11 -50
- package/dist/protocol/media-attempt.js +50 -0
- package/dist/protocol/media-bytes.d.ts +8 -0
- package/dist/protocol/media-bytes.js +21 -0
- package/dist/protocol/media-default.d.ts +56 -0
- package/dist/protocol/media-default.js +302 -0
- package/{protocol/media-dimensions.ts → dist/protocol/media-dimensions.d.ts} +11 -78
- package/dist/protocol/media-dimensions.js +90 -0
- package/dist/protocol/media-input.d.ts +20 -0
- package/dist/protocol/media-input.js +29 -0
- package/dist/protocol/media-model.d.ts +77 -0
- package/dist/protocol/media-model.js +89 -0
- package/{protocol/media-option-issue.ts → dist/protocol/media-option-issue.d.ts} +25 -53
- package/dist/protocol/media-option-issue.js +50 -0
- package/dist/protocol/media-types.d.ts +14 -0
- package/dist/protocol/media-types.js +61 -0
- package/dist/protocol/model-match.d.ts +254 -0
- package/dist/protocol/model-match.js +760 -0
- package/dist/protocol/model-settings.d.ts +153 -0
- package/dist/protocol/model-settings.js +246 -0
- package/dist/protocol/models.d.ts +1065 -0
- package/dist/protocol/models.js +638 -0
- package/dist/protocol/mux.d.ts +350 -0
- package/dist/protocol/mux.js +595 -0
- package/{protocol/plan-surface.ts → dist/protocol/plan-surface.d.ts} +12 -26
- package/dist/protocol/plan-surface.js +39 -0
- package/dist/protocol/provider-models.d.ts +8 -0
- package/{protocol/provider-models.ts → dist/protocol/provider-models.js} +7 -9
- package/dist/protocol/provider-status.d.ts +59 -0
- package/dist/protocol/provider-status.js +142 -0
- package/dist/protocol/provider-tier.d.ts +34 -0
- package/{protocol/provider-tier.ts → dist/protocol/provider-tier.js} +9 -34
- package/dist/protocol/provider-usage.d.ts +230 -0
- package/dist/protocol/provider-usage.js +214 -0
- package/dist/protocol/providers.d.ts +2496 -0
- package/dist/protocol/providers.js +723 -0
- package/dist/protocol/public-usage-index.d.ts +449 -0
- package/dist/protocol/public-usage-index.js +279 -0
- package/dist/protocol/realtime-generated.d.ts +29 -0
- package/{protocol/realtime-generated.ts → dist/protocol/realtime-generated.js} +3 -5
- package/dist/protocol/realtime.d.ts +241 -0
- package/{protocol/realtime.ts → dist/protocol/realtime.js} +88 -155
- package/dist/protocol/registry-pointer.d.ts +24 -0
- package/dist/protocol/registry-pointer.js +78 -0
- package/dist/protocol/relay.d.ts +1152 -0
- package/{protocol/relay.ts → dist/protocol/relay.js} +237 -370
- package/dist/protocol/replay-session.d.ts +4 -0
- package/{protocol/replay-session.ts → dist/protocol/replay-session.js} +1 -8
- package/dist/protocol/responses.d.ts +303 -0
- package/dist/protocol/responses.js +240 -0
- package/dist/protocol/semver.d.ts +59 -0
- package/dist/protocol/semver.js +171 -0
- package/{protocol/setup-mode.ts → dist/protocol/setup-mode.d.ts} +4 -12
- package/dist/protocol/setup-mode.js +18 -0
- package/dist/protocol/sha256-hex.d.ts +2 -0
- package/dist/protocol/sha256-hex.js +93 -0
- package/dist/protocol/stats.d.ts +711 -0
- package/dist/protocol/stats.js +353 -0
- package/dist/protocol/streaming.d.ts +16 -0
- package/dist/protocol/streaming.js +15 -0
- package/{protocol/subscription-daemon-floors.ts → dist/protocol/subscription-daemon-floors.d.ts} +8 -14
- package/dist/protocol/subscription-daemon-floors.js +4 -0
- package/dist/protocol/subscription-provider-compat.d.ts +44 -0
- package/dist/protocol/subscription-provider-compat.js +67 -0
- package/dist/protocol/subscription-provider.d.ts +15 -0
- package/dist/protocol/subscription-provider.js +17 -0
- package/dist/protocol/team-grant.d.ts +14 -0
- package/{protocol/team-grant.ts → dist/protocol/team-grant.js} +0 -3
- package/dist/protocol/team-shareable.d.ts +6 -0
- package/{protocol/team-shareable.ts → dist/protocol/team-shareable.js} +29 -33
- package/dist/protocol/transcription-encoding.d.ts +25 -0
- package/dist/protocol/transcription-encoding.js +47 -0
- package/{protocol/url-locality-dns.ts → dist/protocol/url-locality-dns.d.ts} +1 -23
- package/dist/protocol/url-locality-dns.js +33 -0
- package/dist/protocol/url-locality.d.ts +45 -0
- package/dist/protocol/url-locality.js +288 -0
- package/dist/protocol/usage-snapshots.d.ts +8 -0
- package/{protocol/usage-snapshots.ts → dist/protocol/usage-snapshots.js} +1 -2
- package/dist/protocol/vendor-cli-install.d.ts +20 -0
- package/{protocol/vendor-cli-install.ts → dist/protocol/vendor-cli-install.js} +10 -15
- package/dist/protocol/video-job-plan.d.ts +18 -0
- package/dist/protocol/video-job-plan.js +44 -0
- package/dist/protocol/videos.d.ts +107 -0
- package/dist/protocol/videos.js +154 -0
- package/dist/tunnel/channel-envelope.d.ts +53 -0
- package/dist/tunnel/channel-envelope.js +100 -0
- package/dist/tunnel/codec.d.ts +71 -0
- package/dist/tunnel/codec.js +151 -0
- package/dist/tunnel/device-anchor.d.ts +62 -0
- package/dist/tunnel/device-anchor.js +168 -0
- package/dist/tunnel/device-control.d.ts +50 -0
- package/dist/tunnel/device-control.js +88 -0
- package/dist/tunnel/device-grant.d.ts +91 -0
- package/dist/tunnel/device-grant.js +105 -0
- package/dist/tunnel/fleet.d.ts +28 -0
- package/dist/tunnel/fleet.js +41 -0
- package/dist/tunnel/index.d.ts +22 -0
- package/dist/tunnel/index.js +22 -0
- package/dist/tunnel/mux.d.ts +64 -0
- package/dist/tunnel/mux.js +449 -0
- package/dist/tunnel/peer-link.d.ts +88 -0
- package/dist/tunnel/peer-link.js +271 -0
- package/dist/tunnel/rtc-auth.d.ts +159 -0
- package/dist/tunnel/rtc-auth.js +340 -0
- package/dist/tunnel/rtc-duplex.d.ts +52 -0
- package/dist/tunnel/rtc-duplex.js +148 -0
- package/dist/tunnel/rtc-ice.d.ts +55 -0
- package/dist/tunnel/rtc-ice.js +100 -0
- package/dist/tunnel/secure.d.ts +179 -0
- package/dist/tunnel/secure.js +936 -0
- package/dist/tunnel/stream-reset-error.d.ts +6 -0
- package/dist/tunnel/stream-reset-error.js +9 -0
- package/dist/tunnel/streams.d.ts +244 -0
- package/dist/tunnel/streams.js +1071 -0
- package/dist/tunnel/team-grant.d.ts +90 -0
- package/dist/tunnel/team-grant.js +226 -0
- package/dist/tunnel/wire-bytes.d.ts +32 -0
- package/dist/tunnel/wire-bytes.js +90 -0
- package/dist/vault/api-key.d.ts +71 -0
- package/dist/vault/api-key.js +130 -0
- package/{vault/argon2.ts → dist/vault/argon2.d.ts} +18 -53
- package/dist/vault/argon2.js +82 -0
- package/dist/vault/cli-auth-seal.d.ts +35 -0
- package/dist/vault/cli-auth-seal.js +78 -0
- package/dist/vault/cred-seal.d.ts +18 -0
- package/dist/vault/cred-seal.js +86 -0
- package/dist/vault/credential.d.ts +21 -0
- package/dist/vault/credential.js +26 -0
- package/dist/vault/crypto.d.ts +51 -0
- package/dist/vault/crypto.js +156 -0
- package/dist/vault/daemon-attest.d.ts +68 -0
- package/dist/vault/daemon-attest.js +147 -0
- package/dist/vault/derive.d.ts +34 -0
- package/dist/vault/derive.js +84 -0
- package/dist/vault/device-access.d.ts +17 -0
- package/dist/vault/device-access.js +77 -0
- package/dist/vault/device-anchor.d.ts +42 -0
- package/dist/vault/device-anchor.js +90 -0
- package/dist/vault/device-control.d.ts +80 -0
- package/{vault/device-control.ts → dist/vault/device-control.js} +46 -104
- package/dist/vault/handoff.d.ts +102 -0
- package/dist/vault/handoff.js +236 -0
- package/dist/vault/index.d.ts +21 -0
- package/dist/vault/index.js +21 -0
- package/dist/vault/passkey.d.ts +82 -0
- package/{vault/passkey.ts → dist/vault/passkey.js} +63 -153
- package/dist/vault/phrase.d.ts +40 -0
- package/{vault/phrase.ts → dist/vault/phrase.js} +17 -23
- package/dist/vault/pin.d.ts +46 -0
- package/dist/vault/pin.js +92 -0
- package/dist/vault/public-key-seal.d.ts +17 -0
- package/dist/vault/public-key-seal.js +59 -0
- package/dist/vault/seed.d.ts +96 -0
- package/dist/vault/seed.js +179 -0
- package/dist/vault/team.d.ts +134 -0
- package/dist/vault/team.js +217 -0
- package/dist/vault/vault-item.d.ts +45 -0
- package/dist/vault/vault-item.js +62 -0
- package/dist/vault/vault-migrate-digest.d.ts +10 -0
- package/dist/vault/vault-migrate-digest.js +22 -0
- package/dist/vault/wrapped.d.ts +19 -0
- package/dist/vault/wrapped.js +52 -0
- package/dist/wire/adapters/messages/anthropic-map.d.ts +8 -0
- package/dist/wire/adapters/messages/anthropic-map.js +32 -0
- package/dist/wire/adapters/messages/index.d.ts +7 -0
- package/dist/wire/adapters/messages/index.js +7 -0
- package/dist/wire/adapters/messages/reasoning-from-items.d.ts +14 -0
- package/dist/wire/adapters/messages/reasoning-from-items.js +39 -0
- package/dist/wire/adapters/messages/reasoning-signature.d.ts +81 -0
- package/dist/wire/adapters/messages/reasoning-signature.js +180 -0
- package/dist/wire/adapters/messages/request.d.ts +28 -0
- package/dist/wire/adapters/messages/request.js +490 -0
- package/dist/wire/adapters/messages/response.d.ts +10 -0
- package/dist/wire/adapters/messages/response.js +177 -0
- package/dist/wire/adapters/messages/streaming.d.ts +134 -0
- package/dist/wire/adapters/messages/streaming.js +791 -0
- package/dist/wire/adapters/messages/usage.d.ts +20 -0
- package/dist/wire/adapters/messages/usage.js +10 -0
- package/dist/wire/adapters/responses/index.d.ts +3 -0
- package/dist/wire/adapters/responses/index.js +3 -0
- package/dist/wire/adapters/responses/request.d.ts +2 -0
- package/dist/wire/adapters/responses/request.js +287 -0
- package/dist/wire/adapters/responses/response.d.ts +11 -0
- package/dist/wire/adapters/responses/response.js +69 -0
- package/dist/wire/adapters/responses/streaming.d.ts +2 -0
- package/dist/wire/adapters/responses/streaming.js +267 -0
- package/dist/wire/features/account-rank.d.ts +61 -0
- package/dist/wire/features/account-rank.js +109 -0
- package/dist/wire/features/compaction/compact-request.d.ts +69 -0
- package/dist/wire/features/compaction/compact-request.js +667 -0
- package/dist/wire/features/compaction/compaction-text.d.ts +17 -0
- package/dist/wire/features/compaction/compaction-text.js +29 -0
- package/dist/wire/features/context-demote.d.ts +15 -0
- package/dist/wire/features/context-demote.js +45 -0
- package/dist/wire/features/context-overflow-strategy.d.ts +12 -0
- package/dist/wire/features/context-overflow-strategy.js +8 -0
- package/dist/wire/features/context-skip.d.ts +120 -0
- package/{wire/features/context-skip.ts → dist/wire/features/context-skip.js} +23 -57
- package/dist/wire/features/conversation-affinity.d.ts +49 -0
- package/dist/wire/features/conversation-affinity.js +121 -0
- package/dist/wire/features/max-tokens-backfill.d.ts +50 -0
- package/dist/wire/features/max-tokens-backfill.js +118 -0
- package/dist/wire/features/model-caps.d.ts +7 -0
- package/dist/wire/features/model-caps.js +40 -0
- package/dist/wire/features/model-settings.d.ts +3 -0
- package/dist/wire/features/model-settings.js +13 -0
- package/dist/wire/features/output-limit-clamp.d.ts +14 -0
- package/dist/wire/features/output-limit-clamp.js +36 -0
- package/dist/wire/features/quota-gate.d.ts +16 -0
- package/dist/wire/features/quota-gate.js +48 -0
- package/dist/wire/index.d.ts +44 -0
- package/dist/wire/index.js +44 -0
- package/dist/wire/lib/attempt-outcome.d.ts +19 -0
- package/dist/wire/lib/attempt-outcome.js +18 -0
- package/{wire/lib/canonical/content-part.ts → dist/wire/lib/canonical/content-part.d.ts} +12 -18
- package/dist/wire/lib/canonical/content-part.js +11 -0
- package/dist/wire/lib/canonical/count-tokens-capability.d.ts +52 -0
- package/dist/wire/lib/canonical/count-tokens-capability.js +109 -0
- package/{wire/lib/canonical/encoding-select.ts → dist/wire/lib/canonical/encoding-select.d.ts} +7 -24
- package/dist/wire/lib/canonical/encoding-select.js +26 -0
- package/dist/wire/lib/canonical/image-signature.d.ts +20 -0
- package/dist/wire/lib/canonical/image-signature.js +184 -0
- package/dist/wire/lib/canonical/image-sse.d.ts +88 -0
- package/dist/wire/lib/canonical/image-sse.js +173 -0
- package/{wire/lib/canonical/message.ts → dist/wire/lib/canonical/message.d.ts} +2 -20
- package/dist/wire/lib/canonical/message.js +31 -0
- package/dist/wire/lib/canonical/token-estimate.d.ts +98 -0
- package/dist/wire/lib/canonical/token-estimate.js +230 -0
- package/dist/wire/lib/encrypted-content.d.ts +22 -0
- package/dist/wire/lib/encrypted-content.js +55 -0
- package/dist/wire/lib/error-class.d.ts +57 -0
- package/dist/wire/lib/error-class.js +97 -0
- package/dist/wire/lib/error-envelope.d.ts +20 -0
- package/dist/wire/lib/error-envelope.js +53 -0
- package/dist/wire/lib/forwarded-headers.d.ts +16 -0
- package/{wire/lib/forwarded-headers.ts → dist/wire/lib/forwarded-headers.js} +62 -72
- package/dist/wire/lib/provider-error-rules.d.ts +21 -0
- package/dist/wire/lib/provider-error-rules.js +20 -0
- package/{wire/lib/refusal.ts → dist/wire/lib/refusal.d.ts} +3 -13
- package/dist/wire/lib/refusal.js +27 -0
- package/dist/wire/lib/responses-apply-patch.d.ts +57 -0
- package/dist/wire/lib/responses-apply-patch.js +81 -0
- package/dist/wire/lib/responses-namespace.d.ts +27 -0
- package/{wire/lib/responses-namespace.ts → dist/wire/lib/responses-namespace.js} +16 -32
- package/dist/wire/lib/secret-scrub.d.ts +23 -0
- package/dist/wire/lib/secret-scrub.js +72 -0
- package/dist/wire/lib/streaming/accumulate.d.ts +12 -0
- package/dist/wire/lib/streaming/accumulate.js +187 -0
- package/dist/wire/lib/streaming/finish-reason.d.ts +20 -0
- package/dist/wire/lib/streaming/finish-reason.js +15 -0
- package/{wire/lib/streaming/peek.ts → dist/wire/lib/streaming/peek.d.ts} +13 -82
- package/dist/wire/lib/streaming/peek.js +100 -0
- package/dist/wire/lib/streaming/provider-decode.d.ts +57 -0
- package/dist/wire/lib/streaming/provider-decode.js +210 -0
- package/dist/wire/lib/streaming/response-stream.d.ts +16 -0
- package/dist/wire/lib/streaming/response-stream.js +64 -0
- package/dist/wire/lib/streaming/sse.d.ts +130 -0
- package/dist/wire/lib/streaming/sse.js +600 -0
- package/dist/wire/lib/streaming/strip-tool-calls.d.ts +14 -0
- package/dist/wire/lib/streaming/strip-tool-calls.js +75 -0
- package/dist/wire/lib/streaming/upstream-error.d.ts +32 -0
- package/dist/wire/lib/streaming/upstream-error.js +45 -0
- package/dist/wire/lib/strip-subagent-isolation.d.ts +16 -0
- package/dist/wire/lib/strip-subagent-isolation.js +240 -0
- package/dist/wire/lib/thinking-signature.d.ts +56 -0
- package/{wire/lib/thinking-signature.ts → dist/wire/lib/thinking-signature.js} +77 -84
- package/dist/wire/lib/token-ruler/bpe-core.d.ts +105 -0
- package/dist/wire/lib/token-ruler/bpe-core.js +398 -0
- package/dist/wire/lib/token-ruler/index.d.ts +2 -0
- package/dist/wire/lib/token-ruler/index.js +2 -0
- package/dist/wire/lib/token-ruler/ruler.d.ts +36 -0
- package/dist/wire/lib/token-ruler/ruler.js +50 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.d.ts +14 -0
- package/dist/wire/lib/token-ruler/vocab/claude-ranks.js +16 -0
- package/{wire/lib/token-ruler/vocab/claude.ts → dist/wire/lib/token-ruler/vocab/claude.d.ts} +2 -12
- package/dist/wire/lib/token-ruler/vocab/claude.js +8 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.d.ts +3 -0
- package/dist/wire/lib/token-ruler/vocab/o200k-ranks.js +18 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.d.ts +11 -0
- package/dist/wire/lib/token-ruler/vocab/o200k.js +6 -0
- package/dist/wire/lib/tool-name-map.d.ts +44 -0
- package/dist/wire/lib/tool-name-map.js +186 -0
- package/dist/wire/lib/tool-schema.d.ts +15 -0
- package/dist/wire/lib/tool-schema.js +307 -0
- package/dist/wire/lib/usage-observer.d.ts +9 -0
- package/dist/wire/lib/usage-observer.js +108 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.d.ts +125 -0
- package/dist/wire/providers/anthropic/adaptive-thinking.js +221 -0
- package/dist/wire/providers/anthropic/beta-headers.d.ts +44 -0
- package/{wire/providers/anthropic/beta-headers.ts → dist/wire/providers/anthropic/beta-headers.js} +57 -79
- package/dist/wire/providers/anthropic/index.d.ts +6 -0
- package/{wire/providers/anthropic/index.ts → dist/wire/providers/anthropic/index.js} +6 -6
- package/dist/wire/providers/anthropic/request.d.ts +12 -0
- package/dist/wire/providers/anthropic/request.js +456 -0
- package/dist/wire/providers/anthropic/response.d.ts +3 -0
- package/dist/wire/providers/anthropic/response.js +126 -0
- package/dist/wire/providers/anthropic/streaming.d.ts +28 -0
- package/dist/wire/providers/anthropic/streaming.js +268 -0
- package/dist/wire/providers/anthropic/web-search-domains.d.ts +7 -0
- package/dist/wire/providers/anthropic/web-search-domains.js +36 -0
- package/dist/wire/providers/chatgpt/common.d.ts +27 -0
- package/{wire/providers/chatgpt/common.ts → dist/wire/providers/chatgpt/common.js} +69 -89
- package/dist/wire/providers/chatgpt/index.d.ts +4 -0
- package/{wire/providers/chatgpt/index.ts → dist/wire/providers/chatgpt/index.js} +4 -4
- package/dist/wire/providers/chatgpt/request.d.ts +132 -0
- package/dist/wire/providers/chatgpt/request.js +696 -0
- package/dist/wire/providers/chatgpt/streaming.d.ts +69 -0
- package/dist/wire/providers/chatgpt/streaming.js +761 -0
- package/dist/wire/providers/chatgpt/web-search.d.ts +19 -0
- package/dist/wire/providers/chatgpt/web-search.js +55 -0
- package/dist/wire/providers/grok/web-search.d.ts +23 -0
- package/dist/wire/providers/grok/web-search.js +74 -0
- package/dist/wire/providers/kimi/web-search.d.ts +48 -0
- package/dist/wire/providers/kimi/web-search.js +106 -0
- package/dist/wire/providers/upstream-deny.d.ts +61 -0
- package/dist/wire/providers/upstream-deny.js +293 -0
- package/dist/wire/providers/upstream-request.d.ts +104 -0
- package/dist/wire/providers/upstream-request.js +411 -0
- package/package.json +105 -23
- package/ARCHITECTURE.md +0 -43
- package/client/chat.ts +0 -140
- package/client/devices.ts +0 -269
- package/client/http.ts +0 -72
- package/client/index.ts +0 -129
- package/client/relay-mux.ts +0 -547
- package/client/types.ts +0 -51
- package/client/vault.ts +0 -239
- package/connect/chat.ts +0 -58
- package/connect/client.ts +0 -240
- package/connect/config.ts +0 -47
- package/connect/errors.ts +0 -121
- package/connect/oauth.ts +0 -265
- package/connect/routes.ts +0 -234
- package/connect/store.ts +0 -107
- package/mcp/handle.ts +0 -24
- package/mcp/index.ts +0 -76
- package/mcp/server.ts +0 -319
- package/mcp/tools/marketplace.ts +0 -439
- package/mcp/tools/memory-client.ts +0 -297
- package/mcp/tools/memory-config.ts +0 -32
- package/mcp/tools/memory.ts +0 -369
- package/mcp/tools/model-priority.ts +0 -88
- package/mcp/tools/openllm.ts +0 -883
- package/mcp/types.ts +0 -28
- package/openapi/call.ts +0 -90
- package/openapi/index.ts +0 -8
- package/openapi/openapi.json +0 -80213
- package/openapi/operations.ts +0 -2075
- package/protocol/CONTRIBUTING.md +0 -21
- package/protocol/README.md +0 -134
- package/protocol/access.ts +0 -186
- package/protocol/agent.ts +0 -991
- package/protocol/api-key-syntax.ts +0 -105
- package/protocol/assets/openllm-light.svg +0 -18
- package/protocol/assets/openllm.svg +0 -18
- package/protocol/audio.ts +0 -29
- package/protocol/auth.ts +0 -142
- package/protocol/changelog.ts +0 -155
- package/protocol/chat.ts +0 -458
- package/protocol/client-registry.ts +0 -356
- package/protocol/config.ts +0 -345
- package/protocol/cooldown-reason.ts +0 -78
- package/protocol/cost.ts +0 -10
- package/protocol/daemon-port.ts +0 -31
- package/protocol/daemon.ts +0 -1524
- package/protocol/default-chains.ts +0 -66
- package/protocol/device-state.ts +0 -85
- package/protocol/doctor-report.ts +0 -947
- package/protocol/errors.ts +0 -14
- package/protocol/image-edit-parse.ts +0 -263
- package/protocol/images.ts +0 -298
- package/protocol/index.ts +0 -74
- package/protocol/keepalive.ts +0 -69
- package/protocol/local-auth.ts +0 -300
- package/protocol/local-provider.ts +0 -288
- package/protocol/local-session.ts +0 -118
- package/protocol/marketplace.ts +0 -187
- package/protocol/media-bytes.ts +0 -28
- package/protocol/media-default.ts +0 -357
- package/protocol/media-input.ts +0 -61
- package/protocol/media-model.ts +0 -142
- package/protocol/media-types.ts +0 -70
- package/protocol/model-match.ts +0 -1051
- package/protocol/model-settings.ts +0 -327
- package/protocol/models.ts +0 -767
- package/protocol/mux.ts +0 -722
- package/protocol/provider-status.ts +0 -206
- package/protocol/provider-usage.ts +0 -263
- package/protocol/providers.ts +0 -901
- package/protocol/public-usage-index.ts +0 -354
- package/protocol/registry-pointer.ts +0 -118
- package/protocol/responses.ts +0 -280
- package/protocol/semver.ts +0 -182
- package/protocol/sha256-hex.ts +0 -98
- package/protocol/stats.ts +0 -406
- package/protocol/streaming.ts +0 -19
- package/protocol/subscription-provider-compat.ts +0 -104
- package/protocol/subscription-provider.ts +0 -32
- package/protocol/transcription-encoding.ts +0 -76
- package/protocol/url-locality.ts +0 -288
- package/protocol/video-job-plan.ts +0 -50
- package/protocol/videos.ts +0 -227
- package/tsconfig.json +0 -14
- package/tunnel/ARCHITECTURE.md +0 -111
- package/tunnel/assets/openllm-light.svg +0 -18
- package/tunnel/assets/openllm.svg +0 -18
- package/tunnel/channel-envelope.ts +0 -139
- package/tunnel/codec.ts +0 -191
- package/tunnel/device-anchor.ts +0 -229
- package/tunnel/device-control.ts +0 -118
- package/tunnel/device-grant.ts +0 -173
- package/tunnel/fleet.ts +0 -77
- package/tunnel/index.ts +0 -22
- package/tunnel/mux.ts +0 -580
- package/tunnel/peer-link.ts +0 -390
- package/tunnel/rtc-auth.ts +0 -415
- package/tunnel/rtc-duplex.ts +0 -187
- package/tunnel/rtc-ice.ts +0 -136
- package/tunnel/secure.ts +0 -1298
- package/tunnel/stream-reset-error.ts +0 -14
- package/tunnel/streams.ts +0 -1430
- package/tunnel/team-grant.ts +0 -302
- package/tunnel/wire-bytes.ts +0 -102
- package/vault/ARCHITECTURE.md +0 -470
- package/vault/api-key.ts +0 -190
- package/vault/cli-auth-seal.ts +0 -157
- package/vault/cred-seal.ts +0 -146
- package/vault/credential.ts +0 -55
- package/vault/crypto.ts +0 -210
- package/vault/daemon-attest.ts +0 -229
- package/vault/derive.ts +0 -113
- package/vault/device-access.ts +0 -87
- package/vault/device-anchor.ts +0 -185
- package/vault/handoff.ts +0 -396
- package/vault/index.ts +0 -21
- package/vault/pin.ts +0 -153
- package/vault/public-key-seal.ts +0 -131
- package/vault/seed.ts +0 -272
- package/vault/team.ts +0 -355
- package/vault/vault-item.ts +0 -131
- package/vault/vault-migrate-digest.ts +0 -29
- package/vault/wrapped.ts +0 -77
- package/wire/ARCHITECTURE.md +0 -90
- package/wire/CONTRIBUTING.md +0 -19
- package/wire/adapters/messages/anthropic-map.ts +0 -37
- package/wire/adapters/messages/index.ts +0 -7
- package/wire/adapters/messages/reasoning-from-items.ts +0 -38
- package/wire/adapters/messages/reasoning-signature.ts +0 -243
- package/wire/adapters/messages/request.ts +0 -574
- package/wire/adapters/messages/response.ts +0 -215
- package/wire/adapters/messages/streaming.ts +0 -1027
- package/wire/adapters/messages/usage.ts +0 -43
- package/wire/adapters/responses/index.ts +0 -3
- package/wire/adapters/responses/request.ts +0 -395
- package/wire/adapters/responses/response.ts +0 -88
- package/wire/adapters/responses/streaming.ts +0 -344
- package/wire/assets/openllm-light.svg +0 -18
- package/wire/assets/openllm.svg +0 -18
- package/wire/features/account-rank.ts +0 -166
- package/wire/features/compaction/compact-request.ts +0 -862
- package/wire/features/compaction/compaction-text.ts +0 -43
- package/wire/features/context-demote.ts +0 -47
- package/wire/features/context-overflow-strategy.ts +0 -26
- package/wire/features/conversation-affinity.ts +0 -144
- package/wire/features/max-tokens-backfill.ts +0 -141
- package/wire/features/model-caps.ts +0 -53
- package/wire/features/model-settings.ts +0 -24
- package/wire/features/output-limit-clamp.ts +0 -64
- package/wire/features/quota-gate.ts +0 -85
- package/wire/index.ts +0 -44
- package/wire/lib/attempt-outcome.ts +0 -43
- package/wire/lib/canonical/count-tokens-capability.ts +0 -138
- package/wire/lib/canonical/image-signature.ts +0 -202
- package/wire/lib/canonical/image-sse.ts +0 -216
- package/wire/lib/canonical/token-estimate.ts +0 -266
- package/wire/lib/encrypted-content.ts +0 -66
- package/wire/lib/error-class.ts +0 -154
- package/wire/lib/error-envelope.ts +0 -56
- package/wire/lib/provider-error-rules.ts +0 -48
- package/wire/lib/responses-apply-patch.ts +0 -104
- package/wire/lib/secret-scrub.ts +0 -101
- package/wire/lib/streaming/accumulate.ts +0 -221
- package/wire/lib/streaming/finish-reason.ts +0 -33
- package/wire/lib/streaming/provider-decode.ts +0 -259
- package/wire/lib/streaming/response-stream.ts +0 -71
- package/wire/lib/streaming/sse.ts +0 -699
- package/wire/lib/streaming/strip-tool-calls.ts +0 -95
- package/wire/lib/streaming/upstream-error.ts +0 -58
- package/wire/lib/strip-subagent-isolation.ts +0 -284
- package/wire/lib/token-ruler/bpe-core.ts +0 -426
- package/wire/lib/token-ruler/index.ts +0 -2
- package/wire/lib/token-ruler/ruler.ts +0 -79
- package/wire/lib/token-ruler/vocab/claude-ranks.ts +0 -16
- package/wire/lib/token-ruler/vocab/o200k-ranks.ts +0 -18
- package/wire/lib/token-ruler/vocab/o200k.ts +0 -19
- package/wire/lib/tool-name-map.ts +0 -271
- package/wire/lib/tool-schema.ts +0 -353
- package/wire/lib/usage-observer.ts +0 -125
- package/wire/providers/anthropic/adaptive-thinking.ts +0 -291
- package/wire/providers/anthropic/request.ts +0 -607
- package/wire/providers/anthropic/response.ts +0 -155
- package/wire/providers/anthropic/streaming.ts +0 -315
- package/wire/providers/anthropic/web-search-domains.ts +0 -49
- package/wire/providers/chatgpt/request.ts +0 -959
- package/wire/providers/chatgpt/streaming.ts +0 -1007
- package/wire/providers/chatgpt/web-search.ts +0 -63
- package/wire/providers/grok/web-search.ts +0 -87
- package/wire/providers/kimi/web-search.ts +0 -145
- package/wire/providers/upstream-deny.ts +0 -355
- package/wire/providers/upstream-request.ts +0 -619
- /package/{protocol/inference-headers.ts → dist/protocol/inference-headers.js} +0 -0
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The vault seed — the ONE per-user vault secret (docs/plans/seed-only-vault.md).
|
|
3
|
+
*
|
|
4
|
+
* The seed is the 16 bytes of BIP39 entropy behind the 12-word recovery
|
|
5
|
+
* phrase. Everything else is derived from it in process, never stored for the
|
|
6
|
+
* account:
|
|
7
|
+
*
|
|
8
|
+
* - the vault key (DEK) — {@link deriveVaultDek};
|
|
9
|
+
* - the public vault key id the server checks a seed against —
|
|
10
|
+
* {@link deriveVaultKeyId};
|
|
11
|
+
* - the device-control seed (`./device-control.ts`).
|
|
12
|
+
*
|
|
13
|
+
* HKDF, not Argon2id: 128 bits of entropy can't be searched, and every input
|
|
14
|
+
* is fixed (constant salt and info), so no server-supplied value can steer the
|
|
15
|
+
* key — the same argument as `./device-control.ts`.
|
|
16
|
+
*
|
|
17
|
+
* The seed is stored only under an unlock method: a passkey's PRF output
|
|
18
|
+
* ({@link sealSeedWithPrf}, `user_passkeys.sealed_seed` + a local cache) or a
|
|
19
|
+
* PIN (`./pin.ts`, this browser only).
|
|
20
|
+
*/
|
|
21
|
+
/** BIP39 entropy for a 12-word phrase. */
|
|
22
|
+
export declare const SEED_BYTES = 16;
|
|
23
|
+
/** Fixed public HKDF salt for every key derived from the seed. */
|
|
24
|
+
export declare const VAULT_SEED_HKDF_SALT = "openllm-vault-seed-salt-v1";
|
|
25
|
+
/** HKDF info for the vault key (DEK). */
|
|
26
|
+
export declare const VAULT_DEK_HKDF_INFO = "openllm-vault-dek-v1";
|
|
27
|
+
/** HKDF info for the public vault key id. */
|
|
28
|
+
export declare const VAULT_KEY_ID_HKDF_INFO = "openllm-vault-key-id-v1";
|
|
29
|
+
/** HKDF info for the key that seals the seed under a passkey's PRF output. */
|
|
30
|
+
export declare const PASSKEY_SEED_HKDF_INFO = "openllm-vault-passkey-seed-v1";
|
|
31
|
+
/** A fresh random seed, for a new vault or a rotation. */
|
|
32
|
+
export declare const newSeed: () => Uint8Array;
|
|
33
|
+
/**
|
|
34
|
+
* The seed behind a typed or pasted phrase (normalised first). Throws on an
|
|
35
|
+
* invalid mnemonic — check {@link isValidSeedPhrase} to report it nicely.
|
|
36
|
+
*/
|
|
37
|
+
export declare const seedFromPhrase: (phrase: string) => Uint8Array;
|
|
38
|
+
export declare const isValidSeedPhrase: (phrase: string) => boolean;
|
|
39
|
+
/** The 12-word phrase for a seed — what the user writes down. */
|
|
40
|
+
export declare const seedToPhrase: (seed: Uint8Array) => string;
|
|
41
|
+
/** The vault key (DEK) for a seed. The caller zeroes it. */
|
|
42
|
+
export declare const deriveVaultDek: (seed: Uint8Array) => Promise<Uint8Array>;
|
|
43
|
+
/**
|
|
44
|
+
* The public vault key id for a seed, base64url. Stored as
|
|
45
|
+
* `users.vault_key_id`: the server's check that a typed phrase or a handed-off
|
|
46
|
+
* seed belongs to this vault. Reveals nothing about the seed (HKDF output
|
|
47
|
+
* under a separate info).
|
|
48
|
+
*/
|
|
49
|
+
export declare const deriveVaultKeyId: (seed: Uint8Array) => Promise<string>;
|
|
50
|
+
/** What a passkey-sealed seed is bound to. */
|
|
51
|
+
export type TSeedPasskeyBinding = {
|
|
52
|
+
/** base64url credential id, exactly as stored in `user_passkeys.id`. */
|
|
53
|
+
readonly credentialId: string;
|
|
54
|
+
/**
|
|
55
|
+
* The vault key id of the sealed seed. Changes exactly when the seed does
|
|
56
|
+
* (rotation, reset), so a version bump that keeps the seed (the one-time
|
|
57
|
+
* migration) never invalidates a passkey row.
|
|
58
|
+
*/
|
|
59
|
+
readonly vaultKeyId: string;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
* Seal the seed under a passkey's PRF output: base64 `IV || ct+tag`. The PRF
|
|
63
|
+
* output never leaves the browser, so the server can store this but never
|
|
64
|
+
* open it. Never zeroes its inputs.
|
|
65
|
+
*/
|
|
66
|
+
export declare const sealSeedWithPrf: (seed: Uint8Array, prfOutput: Uint8Array, prfSalt: Uint8Array, binding: TSeedPasskeyBinding) => Promise<string>;
|
|
67
|
+
/**
|
|
68
|
+
* Open a {@link sealSeedWithPrf} copy. Throws on a bad auth tag: another
|
|
69
|
+
* credential, another seed's key id, or a diverged PRF value.
|
|
70
|
+
*/
|
|
71
|
+
export declare const openSeedWithPrf: (sealedB64: string, prfOutput: Uint8Array, prfSalt: Uint8Array, binding: TSeedPasskeyBinding) => Promise<Uint8Array>;
|
|
72
|
+
/**
|
|
73
|
+
* The vault key tree (docs/plans/seed-only-vault.md §2a). Each branch key is
|
|
74
|
+
* HKDF from the vault root key (the DEK) under a fixed label; each leaf is
|
|
75
|
+
* HKDF from its branch under the item's stable id. A parent derives all its
|
|
76
|
+
* children, a child never its parent or siblings, and nothing is stored.
|
|
77
|
+
*
|
|
78
|
+
* A full-access holder of the root (the browser after unlock, every default
|
|
79
|
+
* API key) derives every branch, so by default every key reads what any other
|
|
80
|
+
* wrote — today's behaviour. Leaf ids must never depend on which key wrote the
|
|
81
|
+
* item (a memory's space is its scope, a chat's leaf is its session id).
|
|
82
|
+
*/
|
|
83
|
+
export declare const VAULT_BRANCHES: readonly ["credentials", "memory", "chats", "apps", "teams", "keys"];
|
|
84
|
+
export type TVaultBranch = (typeof VAULT_BRANCHES)[number];
|
|
85
|
+
/** HKDF info prefix for a branch; the branch name follows. */
|
|
86
|
+
export declare const VAULT_BRANCH_HKDF_INFO = "openllm-vault-branch-v1";
|
|
87
|
+
/** HKDF info prefix for a leaf; the branch and the leaf id follow. */
|
|
88
|
+
export declare const VAULT_LEAF_HKDF_INFO = "openllm-vault-leaf-v1";
|
|
89
|
+
/** A branch key from the vault root key (the DEK). The caller zeroes it. */
|
|
90
|
+
export declare const deriveBranchKey: (rootKey: Uint8Array, branch: TVaultBranch) => Promise<Uint8Array>;
|
|
91
|
+
/**
|
|
92
|
+
* A leaf key from its branch key and the item's stable id (session id, memory
|
|
93
|
+
* space). JSON-encoded info, so no id can collide with another branch's.
|
|
94
|
+
* The caller zeroes it.
|
|
95
|
+
*/
|
|
96
|
+
export declare const deriveLeafKey: (branchKey: Uint8Array, branch: TVaultBranch, leafId: string) => Promise<Uint8Array>;
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
import { entropyToMnemonic, mnemonicToEntropy, validateMnemonic, } from "@scure/bip39";
|
|
2
|
+
import { wordlist } from "@scure/bip39/wordlists/english.js";
|
|
3
|
+
import { aesGcmDecrypt, aesGcmEncrypt, fromB64, hkdfSha256, randomBytes, toB64, toB64Url, zero, } from "./crypto.js";
|
|
4
|
+
import { normalizePhrase, PHRASE_WORD_COUNT } from "./phrase.js";
|
|
5
|
+
/**
|
|
6
|
+
* The vault seed — the ONE per-user vault secret (docs/plans/seed-only-vault.md).
|
|
7
|
+
*
|
|
8
|
+
* The seed is the 16 bytes of BIP39 entropy behind the 12-word recovery
|
|
9
|
+
* phrase. Everything else is derived from it in process, never stored for the
|
|
10
|
+
* account:
|
|
11
|
+
*
|
|
12
|
+
* - the vault key (DEK) — {@link deriveVaultDek};
|
|
13
|
+
* - the public vault key id the server checks a seed against —
|
|
14
|
+
* {@link deriveVaultKeyId};
|
|
15
|
+
* - the device-control seed (`./device-control.ts`).
|
|
16
|
+
*
|
|
17
|
+
* HKDF, not Argon2id: 128 bits of entropy can't be searched, and every input
|
|
18
|
+
* is fixed (constant salt and info), so no server-supplied value can steer the
|
|
19
|
+
* key — the same argument as `./device-control.ts`.
|
|
20
|
+
*
|
|
21
|
+
* The seed is stored only under an unlock method: a passkey's PRF output
|
|
22
|
+
* ({@link sealSeedWithPrf}, `user_passkeys.sealed_seed` + a local cache) or a
|
|
23
|
+
* PIN (`./pin.ts`, this browser only).
|
|
24
|
+
*/
|
|
25
|
+
/** BIP39 entropy for a 12-word phrase. */
|
|
26
|
+
export const SEED_BYTES = 16;
|
|
27
|
+
/** Fixed public HKDF salt for every key derived from the seed. */
|
|
28
|
+
export const VAULT_SEED_HKDF_SALT = "openllm-vault-seed-salt-v1";
|
|
29
|
+
/** HKDF info for the vault key (DEK). */
|
|
30
|
+
export const VAULT_DEK_HKDF_INFO = "openllm-vault-dek-v1";
|
|
31
|
+
/** HKDF info for the public vault key id. */
|
|
32
|
+
export const VAULT_KEY_ID_HKDF_INFO = "openllm-vault-key-id-v1";
|
|
33
|
+
/** HKDF info for the key that seals the seed under a passkey's PRF output. */
|
|
34
|
+
export const PASSKEY_SEED_HKDF_INFO = "openllm-vault-passkey-seed-v1";
|
|
35
|
+
const DEK_BYTES = 32;
|
|
36
|
+
const KEY_ID_BYTES = 16;
|
|
37
|
+
const PRF_OUTPUT_BYTES = 32;
|
|
38
|
+
const PRF_SALT_BYTES = 32;
|
|
39
|
+
const NONCE_BYTES = 12;
|
|
40
|
+
const requireSeed = (seed) => {
|
|
41
|
+
if (seed.length !== SEED_BYTES) {
|
|
42
|
+
throw new Error(`vault seed must be ${SEED_BYTES} bytes`);
|
|
43
|
+
}
|
|
44
|
+
};
|
|
45
|
+
const saltBytes = () => new TextEncoder().encode(VAULT_SEED_HKDF_SALT);
|
|
46
|
+
/** A fresh random seed, for a new vault or a rotation. */
|
|
47
|
+
export const newSeed = () => randomBytes(SEED_BYTES);
|
|
48
|
+
/**
|
|
49
|
+
* The seed behind a typed or pasted phrase (normalised first). Throws on an
|
|
50
|
+
* invalid mnemonic — check {@link isValidSeedPhrase} to report it nicely.
|
|
51
|
+
*/
|
|
52
|
+
export const seedFromPhrase = (phrase) => {
|
|
53
|
+
if (!isValidSeedPhrase(phrase))
|
|
54
|
+
throw new Error("invalid recovery phrase");
|
|
55
|
+
const seed = mnemonicToEntropy(normalizePhrase(phrase), wordlist);
|
|
56
|
+
requireSeed(seed);
|
|
57
|
+
return seed;
|
|
58
|
+
};
|
|
59
|
+
export const isValidSeedPhrase = (phrase) => {
|
|
60
|
+
const normalized = normalizePhrase(phrase);
|
|
61
|
+
// A valid 24-word mnemonic is still not a 16-byte seed.
|
|
62
|
+
return (normalized.split(" ").length === PHRASE_WORD_COUNT &&
|
|
63
|
+
validateMnemonic(normalized, wordlist));
|
|
64
|
+
};
|
|
65
|
+
/** The 12-word phrase for a seed — what the user writes down. */
|
|
66
|
+
export const seedToPhrase = (seed) => {
|
|
67
|
+
requireSeed(seed);
|
|
68
|
+
return entropyToMnemonic(seed, wordlist);
|
|
69
|
+
};
|
|
70
|
+
/** The vault key (DEK) for a seed. The caller zeroes it. */
|
|
71
|
+
export const deriveVaultDek = (seed) => {
|
|
72
|
+
requireSeed(seed);
|
|
73
|
+
return hkdfSha256(seed, saltBytes(), VAULT_DEK_HKDF_INFO, DEK_BYTES);
|
|
74
|
+
};
|
|
75
|
+
/**
|
|
76
|
+
* The public vault key id for a seed, base64url. Stored as
|
|
77
|
+
* `users.vault_key_id`: the server's check that a typed phrase or a handed-off
|
|
78
|
+
* seed belongs to this vault. Reveals nothing about the seed (HKDF output
|
|
79
|
+
* under a separate info).
|
|
80
|
+
*/
|
|
81
|
+
export const deriveVaultKeyId = async (seed) => {
|
|
82
|
+
requireSeed(seed);
|
|
83
|
+
const id = await hkdfSha256(seed, saltBytes(), VAULT_KEY_ID_HKDF_INFO, KEY_ID_BYTES);
|
|
84
|
+
return toB64Url(id);
|
|
85
|
+
};
|
|
86
|
+
const bindingAad = (binding) => new TextEncoder().encode(`${PASSKEY_SEED_HKDF_INFO}|${binding.credentialId}|${binding.vaultKeyId}`);
|
|
87
|
+
const passkeySeedKey = (prfOutput, prfSalt) => {
|
|
88
|
+
if (prfOutput.length !== PRF_OUTPUT_BYTES) {
|
|
89
|
+
throw new Error(`PRF output must be ${PRF_OUTPUT_BYTES} bytes`);
|
|
90
|
+
}
|
|
91
|
+
if (prfSalt.length !== PRF_SALT_BYTES) {
|
|
92
|
+
throw new Error(`PRF salt must be ${PRF_SALT_BYTES} bytes`);
|
|
93
|
+
}
|
|
94
|
+
return hkdfSha256(prfOutput, prfSalt, PASSKEY_SEED_HKDF_INFO, 32);
|
|
95
|
+
};
|
|
96
|
+
/**
|
|
97
|
+
* Seal the seed under a passkey's PRF output: base64 `IV || ct+tag`. The PRF
|
|
98
|
+
* output never leaves the browser, so the server can store this but never
|
|
99
|
+
* open it. Never zeroes its inputs.
|
|
100
|
+
*/
|
|
101
|
+
export const sealSeedWithPrf = async (seed, prfOutput, prfSalt, binding) => {
|
|
102
|
+
requireSeed(seed);
|
|
103
|
+
const key = await passkeySeedKey(prfOutput, prfSalt);
|
|
104
|
+
try {
|
|
105
|
+
const nonce = randomBytes(NONCE_BYTES);
|
|
106
|
+
const ciphertext = await aesGcmEncrypt(key, nonce, seed, bindingAad(binding));
|
|
107
|
+
const out = new Uint8Array(nonce.length + ciphertext.length);
|
|
108
|
+
out.set(nonce, 0);
|
|
109
|
+
out.set(ciphertext, nonce.length);
|
|
110
|
+
return toB64(out);
|
|
111
|
+
}
|
|
112
|
+
finally {
|
|
113
|
+
zero(key);
|
|
114
|
+
}
|
|
115
|
+
};
|
|
116
|
+
/**
|
|
117
|
+
* Open a {@link sealSeedWithPrf} copy. Throws on a bad auth tag: another
|
|
118
|
+
* credential, another seed's key id, or a diverged PRF value.
|
|
119
|
+
*/
|
|
120
|
+
export const openSeedWithPrf = async (sealedB64, prfOutput, prfSalt, binding) => {
|
|
121
|
+
const sealed = fromB64(sealedB64);
|
|
122
|
+
if (sealed.length <= NONCE_BYTES)
|
|
123
|
+
throw new Error("sealed seed is too short");
|
|
124
|
+
const key = await passkeySeedKey(prfOutput, prfSalt);
|
|
125
|
+
try {
|
|
126
|
+
const seed = await aesGcmDecrypt(key, sealed.subarray(0, NONCE_BYTES), sealed.subarray(NONCE_BYTES), bindingAad(binding));
|
|
127
|
+
if (seed.length !== SEED_BYTES) {
|
|
128
|
+
zero(seed);
|
|
129
|
+
throw new Error("sealed seed did not contain a vault seed");
|
|
130
|
+
}
|
|
131
|
+
return seed;
|
|
132
|
+
}
|
|
133
|
+
finally {
|
|
134
|
+
zero(key);
|
|
135
|
+
}
|
|
136
|
+
};
|
|
137
|
+
/**
|
|
138
|
+
* The vault key tree (docs/plans/seed-only-vault.md §2a). Each branch key is
|
|
139
|
+
* HKDF from the vault root key (the DEK) under a fixed label; each leaf is
|
|
140
|
+
* HKDF from its branch under the item's stable id. A parent derives all its
|
|
141
|
+
* children, a child never its parent or siblings, and nothing is stored.
|
|
142
|
+
*
|
|
143
|
+
* A full-access holder of the root (the browser after unlock, every default
|
|
144
|
+
* API key) derives every branch, so by default every key reads what any other
|
|
145
|
+
* wrote — today's behaviour. Leaf ids must never depend on which key wrote the
|
|
146
|
+
* item (a memory's space is its scope, a chat's leaf is its session id).
|
|
147
|
+
*/
|
|
148
|
+
export const VAULT_BRANCHES = [
|
|
149
|
+
"credentials",
|
|
150
|
+
"memory",
|
|
151
|
+
"chats",
|
|
152
|
+
"apps",
|
|
153
|
+
"teams",
|
|
154
|
+
"keys",
|
|
155
|
+
];
|
|
156
|
+
/** HKDF info prefix for a branch; the branch name follows. */
|
|
157
|
+
export const VAULT_BRANCH_HKDF_INFO = "openllm-vault-branch-v1";
|
|
158
|
+
/** HKDF info prefix for a leaf; the branch and the leaf id follow. */
|
|
159
|
+
export const VAULT_LEAF_HKDF_INFO = "openllm-vault-leaf-v1";
|
|
160
|
+
const requireKey = (key, label) => {
|
|
161
|
+
if (key.length !== DEK_BYTES)
|
|
162
|
+
throw new Error(`${label} must be 32 bytes`);
|
|
163
|
+
};
|
|
164
|
+
/** A branch key from the vault root key (the DEK). The caller zeroes it. */
|
|
165
|
+
export const deriveBranchKey = async (rootKey, branch) => {
|
|
166
|
+
requireKey(rootKey, "vault root key");
|
|
167
|
+
return hkdfSha256(rootKey, saltBytes(), JSON.stringify([VAULT_BRANCH_HKDF_INFO, branch]), DEK_BYTES);
|
|
168
|
+
};
|
|
169
|
+
/**
|
|
170
|
+
* A leaf key from its branch key and the item's stable id (session id, memory
|
|
171
|
+
* space). JSON-encoded info, so no id can collide with another branch's.
|
|
172
|
+
* The caller zeroes it.
|
|
173
|
+
*/
|
|
174
|
+
export const deriveLeafKey = async (branchKey, branch, leafId) => {
|
|
175
|
+
requireKey(branchKey, "branch key");
|
|
176
|
+
if (leafId.length === 0)
|
|
177
|
+
throw new Error("leaf id must not be empty");
|
|
178
|
+
return hkdfSha256(branchKey, saltBytes(), JSON.stringify([VAULT_LEAF_HKDF_INFO, branch, leafId]), DEK_BYTES);
|
|
179
|
+
};
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* User-held team encryption (docs/plan/2026-10-26-teams.md §9).
|
|
3
|
+
*
|
|
4
|
+
* Key graph (one-way only — a team key never opens personal material):
|
|
5
|
+
*
|
|
6
|
+
* personal DEK ──seal──► team_members.sealed_team_key (T)
|
|
7
|
+
* invite secret ─HKDF(auth info)──► auth (base64url) ──sha256──► token_hash
|
|
8
|
+
* invite secret ─HKDF(wrap info)──► wrap key ──seal──► team_invites.wrapped_team_key (T)
|
|
9
|
+
* T ─HKDF──► K_mem ──seal──► embeddings.content (team rows)
|
|
10
|
+
* T ─HKDF──► K_cred ──seal──► team share credential (inner)
|
|
11
|
+
* ▲
|
|
12
|
+
* server K_srv wraps that as outer layer
|
|
13
|
+
*
|
|
14
|
+
* Domain separation:
|
|
15
|
+
* - invite auth info: {@link TEAM_INVITE_AUTH_HKDF_INFO} (browser-only → server)
|
|
16
|
+
* - invite wrap info: {@link TEAM_INVITE_HKDF_INFO} (browser-only; never sent)
|
|
17
|
+
* - memory content info: {@link TEAM_MEM_HKDF_INFO}
|
|
18
|
+
* - credential content info: {@link TEAM_CRED_HKDF_INFO}
|
|
19
|
+
*
|
|
20
|
+
* The raw fragment secret and the wrap key never leave the browser. Only the
|
|
21
|
+
* derived `auth` value is posted; the server stores `sha256(auth)` as
|
|
22
|
+
* `token_hash` and cannot unwrap T from anything it sees or stores.
|
|
23
|
+
*
|
|
24
|
+
* API-key share credentials use a two-layer envelope: the browser seals the
|
|
25
|
+
* plaintext under K_cred with AAD binding (team_id, share_id, provider,
|
|
26
|
+
* key_version); the server then wraps that ciphertext under a per-share
|
|
27
|
+
* K_srv (HMAC of the host signing secret). Neither layer alone opens the
|
|
28
|
+
* credential. Callers `zero()` T, K_mem, and K_cred after use.
|
|
29
|
+
*
|
|
30
|
+
* Personal-row paths must never receive T, K_mem, or K_cred; team-row paths
|
|
31
|
+
* must never receive the personal DEK.
|
|
32
|
+
*/
|
|
33
|
+
/** HKDF info for the invite-fragment wrap of T (browser-only). */
|
|
34
|
+
export declare const TEAM_INVITE_HKDF_INFO = "openllm-team-invite-v1";
|
|
35
|
+
/**
|
|
36
|
+
* HKDF info for the invite auth token posted to the server.
|
|
37
|
+
* Distinct from {@link TEAM_INVITE_HKDF_INFO} so seeing `auth` never yields
|
|
38
|
+
* the wrap key.
|
|
39
|
+
*/
|
|
40
|
+
export declare const TEAM_INVITE_AUTH_HKDF_INFO = "openllm-team-invite-auth-v1";
|
|
41
|
+
/** HKDF info for the team-memory content key derived from T. */
|
|
42
|
+
export declare const TEAM_MEM_HKDF_INFO = "openllm-team-mem-v1";
|
|
43
|
+
/**
|
|
44
|
+
* HKDF info for the team-credential content key derived from T.
|
|
45
|
+
* Distinct from {@link TEAM_MEM_HKDF_INFO} so K_mem never opens share
|
|
46
|
+
* credentials and K_cred never opens team memories.
|
|
47
|
+
*/
|
|
48
|
+
export declare const TEAM_CRED_HKDF_INFO = "openllm-team-cred-v1";
|
|
49
|
+
/** Fresh random team root key T. Caller owns and must eventually `zero()` it. */
|
|
50
|
+
export declare const generateTeamKey: () => Uint8Array;
|
|
51
|
+
/**
|
|
52
|
+
* Seal T under the personal vault's `teams` branch → bytes for
|
|
53
|
+
* `team_members.sealed_team_key`.
|
|
54
|
+
*
|
|
55
|
+
* Wire layout (single bytea, no separate nonce column):
|
|
56
|
+
* - tree (current): `ASCII "k1:" || nonce(12) || ct` — AES-GCM under the
|
|
57
|
+
* `teams` branch key derived from the root (DEK today);
|
|
58
|
+
* - legacy: `nonce(12) || ct` — AES-GCM under the root DEK directly.
|
|
59
|
+
* {@link openTeamKey} reads both; a legacy blob whose first three bytes
|
|
60
|
+
* happen to match the tag is tried as tree first and falls back to the
|
|
61
|
+
* DEK on auth failure.
|
|
62
|
+
*/
|
|
63
|
+
export declare const sealTeamKey: (dek: Uint8Array, teamKey: Uint8Array) => Promise<Uint8Array>;
|
|
64
|
+
/** Open a `sealed_team_key` blob under the personal root key. Caller zeros T. */
|
|
65
|
+
export declare const openTeamKey: (dek: Uint8Array, sealed: Uint8Array) => Promise<Uint8Array>;
|
|
66
|
+
/**
|
|
67
|
+
* Derive the invite auth token posted to the server:
|
|
68
|
+
* HKDF(secret, salt=invite_id, info=openllm-team-invite-auth-v1) → base64url.
|
|
69
|
+
* The raw fragment secret never leaves the browser.
|
|
70
|
+
*/
|
|
71
|
+
export declare const deriveTeamInviteAuth: (inviteSecret: string, inviteId: string) => Promise<string>;
|
|
72
|
+
/**
|
|
73
|
+
* Derive the invite wrap key: HKDF(invite_secret, salt=invite_id,
|
|
74
|
+
* info=openllm-team-invite-v1). Caller zeros the returned key. Never send
|
|
75
|
+
* this key or the raw secret to the server.
|
|
76
|
+
*/
|
|
77
|
+
export declare const deriveTeamInviteWrapKey: (inviteSecret: string, inviteId: string) => Promise<Uint8Array>;
|
|
78
|
+
/** Wrap T under the invite secret for storage on `team_invites`. */
|
|
79
|
+
export declare const wrapTeamKeyForInvite: (inviteSecret: string, inviteId: string, teamKey: Uint8Array) => Promise<Uint8Array>;
|
|
80
|
+
/** Unwrap T from an invite's `wrapped_team_key`. Caller zeros T. */
|
|
81
|
+
export declare const unwrapTeamKeyFromInvite: (inviteSecret: string, inviteId: string, wrapped: Uint8Array) => Promise<Uint8Array>;
|
|
82
|
+
/**
|
|
83
|
+
* Derive K_mem = HKDF(T, salt=empty, info=openllm-team-mem-v1).
|
|
84
|
+
* Memory code receives ONLY this key for team rows. Caller zeros it.
|
|
85
|
+
*/
|
|
86
|
+
export declare const deriveTeamMemKey: (teamKey: Uint8Array) => Promise<Uint8Array>;
|
|
87
|
+
export type TEncryptedTeamMemory = {
|
|
88
|
+
readonly ciphertext: string;
|
|
89
|
+
readonly nonce: string;
|
|
90
|
+
};
|
|
91
|
+
/** Encrypt memory content under K_mem (same wire shape as credentials). */
|
|
92
|
+
export declare const encryptTeamMemory: (memKey: Uint8Array, plaintext: string) => Promise<TEncryptedTeamMemory>;
|
|
93
|
+
/** Decrypt a team memory row under K_mem. */
|
|
94
|
+
export declare const decryptTeamMemory: (memKey: Uint8Array, ciphertextB64: string, nonceB64: string) => Promise<string>;
|
|
95
|
+
/**
|
|
96
|
+
* Derive K_cred = HKDF(T, salt=empty, info=openllm-team-cred-v1).
|
|
97
|
+
* Credential-share code receives ONLY this key for the inner envelope.
|
|
98
|
+
* Caller zeros it.
|
|
99
|
+
*/
|
|
100
|
+
export declare const deriveTeamCredKey: (teamKey: Uint8Array) => Promise<Uint8Array>;
|
|
101
|
+
/**
|
|
102
|
+
* Public facts the inner credential ciphertext is bound to as AES-GCM AAD.
|
|
103
|
+
* A row relabelled under another team/share/provider/key_version fails its
|
|
104
|
+
* auth tag instead of handing back a key for the wrong share.
|
|
105
|
+
*/
|
|
106
|
+
export type TTeamCredBinding = {
|
|
107
|
+
readonly teamId: string;
|
|
108
|
+
readonly shareId: string;
|
|
109
|
+
readonly provider: string;
|
|
110
|
+
readonly keyVersion: number;
|
|
111
|
+
};
|
|
112
|
+
export type TEncryptedTeamCredential = {
|
|
113
|
+
readonly ciphertext: string;
|
|
114
|
+
readonly nonce: string;
|
|
115
|
+
};
|
|
116
|
+
/**
|
|
117
|
+
* Encrypt a credential plaintext under K_cred with AAD binding.
|
|
118
|
+
* Returns the same wire shape as personal credentials (`ciphertext`/`nonce`
|
|
119
|
+
* base64). The browser posts this as the inner layer; the server wraps it
|
|
120
|
+
* under K_srv before storage.
|
|
121
|
+
*/
|
|
122
|
+
export declare const encryptTeamCredential: (credKey: Uint8Array, plaintext: string, binding: TTeamCredBinding) => Promise<TEncryptedTeamCredential>;
|
|
123
|
+
/** Decrypt an inner team-credential layer under K_cred + the same AAD. */
|
|
124
|
+
export declare const decryptTeamCredential: (credKey: Uint8Array, ciphertextB64: string, nonceB64: string, binding: TTeamCredBinding) => Promise<string>;
|
|
125
|
+
/**
|
|
126
|
+
* Pack an inner `{ciphertext, nonce}` pair into `IV || ct` bytes for the
|
|
127
|
+
* server's outer wrap. Inverse of {@link unpackTeamCredInner}.
|
|
128
|
+
*/
|
|
129
|
+
export declare const packTeamCredInner: (sealed: TEncryptedTeamCredential) => Uint8Array;
|
|
130
|
+
/** Unpack `IV || ct` bytes back to the inner `{ciphertext, nonce}` pair. */
|
|
131
|
+
export declare const unpackTeamCredInner: (packed: Uint8Array) => TEncryptedTeamCredential;
|
|
132
|
+
/** Browser/API helpers: b64 ↔ sealed bytes. */
|
|
133
|
+
export declare const sealedTeamKeyToB64: (sealed: Uint8Array) => string;
|
|
134
|
+
export declare const sealedTeamKeyFromB64: (b64: string) => Uint8Array;
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* User-held team encryption (docs/plan/2026-10-26-teams.md §9).
|
|
3
|
+
*
|
|
4
|
+
* Key graph (one-way only — a team key never opens personal material):
|
|
5
|
+
*
|
|
6
|
+
* personal DEK ──seal──► team_members.sealed_team_key (T)
|
|
7
|
+
* invite secret ─HKDF(auth info)──► auth (base64url) ──sha256──► token_hash
|
|
8
|
+
* invite secret ─HKDF(wrap info)──► wrap key ──seal──► team_invites.wrapped_team_key (T)
|
|
9
|
+
* T ─HKDF──► K_mem ──seal──► embeddings.content (team rows)
|
|
10
|
+
* T ─HKDF──► K_cred ──seal──► team share credential (inner)
|
|
11
|
+
* ▲
|
|
12
|
+
* server K_srv wraps that as outer layer
|
|
13
|
+
*
|
|
14
|
+
* Domain separation:
|
|
15
|
+
* - invite auth info: {@link TEAM_INVITE_AUTH_HKDF_INFO} (browser-only → server)
|
|
16
|
+
* - invite wrap info: {@link TEAM_INVITE_HKDF_INFO} (browser-only; never sent)
|
|
17
|
+
* - memory content info: {@link TEAM_MEM_HKDF_INFO}
|
|
18
|
+
* - credential content info: {@link TEAM_CRED_HKDF_INFO}
|
|
19
|
+
*
|
|
20
|
+
* The raw fragment secret and the wrap key never leave the browser. Only the
|
|
21
|
+
* derived `auth` value is posted; the server stores `sha256(auth)` as
|
|
22
|
+
* `token_hash` and cannot unwrap T from anything it sees or stores.
|
|
23
|
+
*
|
|
24
|
+
* API-key share credentials use a two-layer envelope: the browser seals the
|
|
25
|
+
* plaintext under K_cred with AAD binding (team_id, share_id, provider,
|
|
26
|
+
* key_version); the server then wraps that ciphertext under a per-share
|
|
27
|
+
* K_srv (HMAC of the host signing secret). Neither layer alone opens the
|
|
28
|
+
* credential. Callers `zero()` T, K_mem, and K_cred after use.
|
|
29
|
+
*
|
|
30
|
+
* Personal-row paths must never receive T, K_mem, or K_cred; team-row paths
|
|
31
|
+
* must never receive the personal DEK.
|
|
32
|
+
*/
|
|
33
|
+
import { aesGcmDecrypt, aesGcmEncrypt, fromB64, hkdfSha256, randomBytes, toB64, toB64Url, zero, } from "./crypto.js";
|
|
34
|
+
import { openVaultBytes, sealVaultBytes, VAULT_ITEM_TAG } from "./vault-item.js";
|
|
35
|
+
import { joinSealed, splitSealed } from "./wrapped.js";
|
|
36
|
+
/** ASCII `k1:` — same tag vault-item puts on a tree-sealed nonce string. */
|
|
37
|
+
const TEAM_KEY_TREE_TAG = new TextEncoder().encode(VAULT_ITEM_TAG);
|
|
38
|
+
const startsWithTeamKeyTreeTag = (sealed) => {
|
|
39
|
+
if (sealed.length < TEAM_KEY_TREE_TAG.length + NONCE_BYTES + 16) {
|
|
40
|
+
return false;
|
|
41
|
+
}
|
|
42
|
+
for (let i = 0; i < TEAM_KEY_TREE_TAG.length; i++) {
|
|
43
|
+
if (sealed[i] !== TEAM_KEY_TREE_TAG[i])
|
|
44
|
+
return false;
|
|
45
|
+
}
|
|
46
|
+
return true;
|
|
47
|
+
};
|
|
48
|
+
const NONCE_BYTES = 12;
|
|
49
|
+
const TEAM_KEY_BYTES = 32;
|
|
50
|
+
/** HKDF info for the invite-fragment wrap of T (browser-only). */
|
|
51
|
+
export const TEAM_INVITE_HKDF_INFO = "openllm-team-invite-v1";
|
|
52
|
+
/**
|
|
53
|
+
* HKDF info for the invite auth token posted to the server.
|
|
54
|
+
* Distinct from {@link TEAM_INVITE_HKDF_INFO} so seeing `auth` never yields
|
|
55
|
+
* the wrap key.
|
|
56
|
+
*/
|
|
57
|
+
export const TEAM_INVITE_AUTH_HKDF_INFO = "openllm-team-invite-auth-v1";
|
|
58
|
+
/** HKDF info for the team-memory content key derived from T. */
|
|
59
|
+
export const TEAM_MEM_HKDF_INFO = "openllm-team-mem-v1";
|
|
60
|
+
/**
|
|
61
|
+
* HKDF info for the team-credential content key derived from T.
|
|
62
|
+
* Distinct from {@link TEAM_MEM_HKDF_INFO} so K_mem never opens share
|
|
63
|
+
* credentials and K_cred never opens team memories.
|
|
64
|
+
*/
|
|
65
|
+
export const TEAM_CRED_HKDF_INFO = "openllm-team-cred-v1";
|
|
66
|
+
/** Fresh random team root key T. Caller owns and must eventually `zero()` it. */
|
|
67
|
+
export const generateTeamKey = () => randomBytes(TEAM_KEY_BYTES);
|
|
68
|
+
/**
|
|
69
|
+
* Seal T under the personal vault's `teams` branch → bytes for
|
|
70
|
+
* `team_members.sealed_team_key`.
|
|
71
|
+
*
|
|
72
|
+
* Wire layout (single bytea, no separate nonce column):
|
|
73
|
+
* - tree (current): `ASCII "k1:" || nonce(12) || ct` — AES-GCM under the
|
|
74
|
+
* `teams` branch key derived from the root (DEK today);
|
|
75
|
+
* - legacy: `nonce(12) || ct` — AES-GCM under the root DEK directly.
|
|
76
|
+
* {@link openTeamKey} reads both; a legacy blob whose first three bytes
|
|
77
|
+
* happen to match the tag is tried as tree first and falls back to the
|
|
78
|
+
* DEK on auth failure.
|
|
79
|
+
*/
|
|
80
|
+
export const sealTeamKey = async (dek, teamKey) => {
|
|
81
|
+
const item = await sealVaultBytes(dek, { branch: "teams" }, teamKey);
|
|
82
|
+
const nonce = fromB64(item.nonce.slice(VAULT_ITEM_TAG.length));
|
|
83
|
+
const ct = fromB64(item.ciphertext);
|
|
84
|
+
const out = new Uint8Array(TEAM_KEY_TREE_TAG.length + nonce.length + ct.length);
|
|
85
|
+
out.set(TEAM_KEY_TREE_TAG, 0);
|
|
86
|
+
out.set(nonce, TEAM_KEY_TREE_TAG.length);
|
|
87
|
+
out.set(ct, TEAM_KEY_TREE_TAG.length + nonce.length);
|
|
88
|
+
return out;
|
|
89
|
+
};
|
|
90
|
+
/** Open a `sealed_team_key` blob under the personal root key. Caller zeros T. */
|
|
91
|
+
export const openTeamKey = async (dek, sealed) => {
|
|
92
|
+
if (startsWithTeamKeyTreeTag(sealed)) {
|
|
93
|
+
const nonce = sealed.slice(TEAM_KEY_TREE_TAG.length, TEAM_KEY_TREE_TAG.length + NONCE_BYTES);
|
|
94
|
+
const ciphertext = sealed.slice(TEAM_KEY_TREE_TAG.length + NONCE_BYTES);
|
|
95
|
+
try {
|
|
96
|
+
return await openVaultBytes(dek, { branch: "teams" }, {
|
|
97
|
+
nonce: `${VAULT_ITEM_TAG}${toB64(nonce)}`,
|
|
98
|
+
ciphertext: toB64(ciphertext),
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
catch {
|
|
102
|
+
// Tag collision on a legacy blob — fall through.
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
const { nonce, ciphertext } = splitSealed(sealed, "sealed_team_key");
|
|
106
|
+
return aesGcmDecrypt(dek, nonce, ciphertext);
|
|
107
|
+
};
|
|
108
|
+
const inviteSalt = (inviteId) => new TextEncoder().encode(inviteId);
|
|
109
|
+
/**
|
|
110
|
+
* Derive the invite auth token posted to the server:
|
|
111
|
+
* HKDF(secret, salt=invite_id, info=openllm-team-invite-auth-v1) → base64url.
|
|
112
|
+
* The raw fragment secret never leaves the browser.
|
|
113
|
+
*/
|
|
114
|
+
export const deriveTeamInviteAuth = async (inviteSecret, inviteId) => {
|
|
115
|
+
const ikm = new TextEncoder().encode(inviteSecret);
|
|
116
|
+
try {
|
|
117
|
+
const authBytes = await hkdfSha256(ikm, inviteSalt(inviteId), TEAM_INVITE_AUTH_HKDF_INFO, TEAM_KEY_BYTES);
|
|
118
|
+
try {
|
|
119
|
+
return toB64Url(authBytes);
|
|
120
|
+
}
|
|
121
|
+
finally {
|
|
122
|
+
zero(authBytes);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
finally {
|
|
126
|
+
zero(ikm);
|
|
127
|
+
}
|
|
128
|
+
};
|
|
129
|
+
/**
|
|
130
|
+
* Derive the invite wrap key: HKDF(invite_secret, salt=invite_id,
|
|
131
|
+
* info=openllm-team-invite-v1). Caller zeros the returned key. Never send
|
|
132
|
+
* this key or the raw secret to the server.
|
|
133
|
+
*/
|
|
134
|
+
export const deriveTeamInviteWrapKey = async (inviteSecret, inviteId) => {
|
|
135
|
+
const ikm = new TextEncoder().encode(inviteSecret);
|
|
136
|
+
try {
|
|
137
|
+
return await hkdfSha256(ikm, inviteSalt(inviteId), TEAM_INVITE_HKDF_INFO, TEAM_KEY_BYTES);
|
|
138
|
+
}
|
|
139
|
+
finally {
|
|
140
|
+
zero(ikm);
|
|
141
|
+
}
|
|
142
|
+
};
|
|
143
|
+
/** Wrap T under the invite secret for storage on `team_invites`. */
|
|
144
|
+
export const wrapTeamKeyForInvite = async (inviteSecret, inviteId, teamKey) => {
|
|
145
|
+
const wrapKey = await deriveTeamInviteWrapKey(inviteSecret, inviteId);
|
|
146
|
+
try {
|
|
147
|
+
const nonce = randomBytes(NONCE_BYTES);
|
|
148
|
+
const ct = await aesGcmEncrypt(wrapKey, nonce, teamKey);
|
|
149
|
+
return joinSealed(nonce, ct);
|
|
150
|
+
}
|
|
151
|
+
finally {
|
|
152
|
+
zero(wrapKey);
|
|
153
|
+
}
|
|
154
|
+
};
|
|
155
|
+
/** Unwrap T from an invite's `wrapped_team_key`. Caller zeros T. */
|
|
156
|
+
export const unwrapTeamKeyFromInvite = async (inviteSecret, inviteId, wrapped) => {
|
|
157
|
+
const wrapKey = await deriveTeamInviteWrapKey(inviteSecret, inviteId);
|
|
158
|
+
try {
|
|
159
|
+
const { nonce, ciphertext } = splitSealed(wrapped, "wrapped_team_key");
|
|
160
|
+
return await aesGcmDecrypt(wrapKey, nonce, ciphertext);
|
|
161
|
+
}
|
|
162
|
+
finally {
|
|
163
|
+
zero(wrapKey);
|
|
164
|
+
}
|
|
165
|
+
};
|
|
166
|
+
/**
|
|
167
|
+
* Derive K_mem = HKDF(T, salt=empty, info=openllm-team-mem-v1).
|
|
168
|
+
* Memory code receives ONLY this key for team rows. Caller zeros it.
|
|
169
|
+
*/
|
|
170
|
+
export const deriveTeamMemKey = async (teamKey) => hkdfSha256(teamKey, new Uint8Array(0), TEAM_MEM_HKDF_INFO, TEAM_KEY_BYTES);
|
|
171
|
+
/** Encrypt memory content under K_mem (same wire shape as credentials). */
|
|
172
|
+
export const encryptTeamMemory = async (memKey, plaintext) => {
|
|
173
|
+
const nonce = randomBytes(NONCE_BYTES);
|
|
174
|
+
const ct = await aesGcmEncrypt(memKey, nonce, new TextEncoder().encode(plaintext));
|
|
175
|
+
return { ciphertext: toB64(ct), nonce: toB64(nonce) };
|
|
176
|
+
};
|
|
177
|
+
/** Decrypt a team memory row under K_mem. */
|
|
178
|
+
export const decryptTeamMemory = async (memKey, ciphertextB64, nonceB64) => {
|
|
179
|
+
const pt = await aesGcmDecrypt(memKey, fromB64(nonceB64), fromB64(ciphertextB64));
|
|
180
|
+
return new TextDecoder().decode(pt);
|
|
181
|
+
};
|
|
182
|
+
/**
|
|
183
|
+
* Derive K_cred = HKDF(T, salt=empty, info=openllm-team-cred-v1).
|
|
184
|
+
* Credential-share code receives ONLY this key for the inner envelope.
|
|
185
|
+
* Caller zeros it.
|
|
186
|
+
*/
|
|
187
|
+
export const deriveTeamCredKey = async (teamKey) => hkdfSha256(teamKey, new Uint8Array(0), TEAM_CRED_HKDF_INFO, TEAM_KEY_BYTES);
|
|
188
|
+
const teamCredAad = (binding) => new TextEncoder().encode(`${TEAM_CRED_HKDF_INFO}|${binding.teamId}|${binding.shareId}|${binding.provider}|${binding.keyVersion}`);
|
|
189
|
+
/**
|
|
190
|
+
* Encrypt a credential plaintext under K_cred with AAD binding.
|
|
191
|
+
* Returns the same wire shape as personal credentials (`ciphertext`/`nonce`
|
|
192
|
+
* base64). The browser posts this as the inner layer; the server wraps it
|
|
193
|
+
* under K_srv before storage.
|
|
194
|
+
*/
|
|
195
|
+
export const encryptTeamCredential = async (credKey, plaintext, binding) => {
|
|
196
|
+
const nonce = randomBytes(NONCE_BYTES);
|
|
197
|
+
const ct = await aesGcmEncrypt(credKey, nonce, new TextEncoder().encode(plaintext), teamCredAad(binding));
|
|
198
|
+
return { ciphertext: toB64(ct), nonce: toB64(nonce) };
|
|
199
|
+
};
|
|
200
|
+
/** Decrypt an inner team-credential layer under K_cred + the same AAD. */
|
|
201
|
+
export const decryptTeamCredential = async (credKey, ciphertextB64, nonceB64, binding) => {
|
|
202
|
+
const pt = await aesGcmDecrypt(credKey, fromB64(nonceB64), fromB64(ciphertextB64), teamCredAad(binding));
|
|
203
|
+
return new TextDecoder().decode(pt);
|
|
204
|
+
};
|
|
205
|
+
/**
|
|
206
|
+
* Pack an inner `{ciphertext, nonce}` pair into `IV || ct` bytes for the
|
|
207
|
+
* server's outer wrap. Inverse of {@link unpackTeamCredInner}.
|
|
208
|
+
*/
|
|
209
|
+
export const packTeamCredInner = (sealed) => joinSealed(fromB64(sealed.nonce), fromB64(sealed.ciphertext));
|
|
210
|
+
/** Unpack `IV || ct` bytes back to the inner `{ciphertext, nonce}` pair. */
|
|
211
|
+
export const unpackTeamCredInner = (packed) => {
|
|
212
|
+
const { nonce, ciphertext } = splitSealed(packed, "team_cred_inner");
|
|
213
|
+
return { ciphertext: toB64(ciphertext), nonce: toB64(nonce) };
|
|
214
|
+
};
|
|
215
|
+
/** Browser/API helpers: b64 ↔ sealed bytes. */
|
|
216
|
+
export const sealedTeamKeyToB64 = (sealed) => toB64(sealed);
|
|
217
|
+
export const sealedTeamKeyFromB64 = (b64) => fromB64(b64);
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { TVaultBranch } from "./seed.js";
|
|
2
|
+
/**
|
|
3
|
+
* Vault data encrypted under the key tree (docs/plans/seed-only-vault.md §2a).
|
|
4
|
+
*
|
|
5
|
+
* Every item says which key it was sealed under, in its nonce:
|
|
6
|
+
*
|
|
7
|
+
* - `k1:<base64 nonce>` — under the branch key, or the leaf key when the
|
|
8
|
+
* item names a leaf, derived from the vault root key;
|
|
9
|
+
* - a bare `<base64 nonce>` — legacy, sealed directly under the root key.
|
|
10
|
+
* Read-only, and only until the 1-week sunset; nothing writes it any more.
|
|
11
|
+
*
|
|
12
|
+
* Self-describing on purpose: a caller says only WHAT it is reading
|
|
13
|
+
* ({@link TVaultItemRef}), never which format the user is in, so items of both
|
|
14
|
+
* formats can sit side by side (mid-migration, or a server write racing a
|
|
15
|
+
* browser one) and every holder of the root key reads them all — by default
|
|
16
|
+
* every key reads what any other wrote.
|
|
17
|
+
*/
|
|
18
|
+
/** Which part of the tree an item belongs to. */
|
|
19
|
+
export type TVaultItemRef = {
|
|
20
|
+
readonly branch: TVaultBranch;
|
|
21
|
+
/** Stable id of the item's leaf (session id, memory scope); none = branch key. */
|
|
22
|
+
readonly leaf?: string;
|
|
23
|
+
};
|
|
24
|
+
export type TEncryptedVaultItem = {
|
|
25
|
+
readonly ciphertext: string;
|
|
26
|
+
readonly nonce: string;
|
|
27
|
+
};
|
|
28
|
+
/** Nonce prefix of an item sealed under the key tree. */
|
|
29
|
+
export declare const VAULT_ITEM_TAG = "k1:";
|
|
30
|
+
/** `true` when an item was sealed under the key tree, not the bare root. */
|
|
31
|
+
export declare const isTreeSealed: (nonce: string) => boolean;
|
|
32
|
+
/**
|
|
33
|
+
* Seal bytes for the vault at `ref`, from the root key. Never zeroes its
|
|
34
|
+
* inputs. Always the tree format.
|
|
35
|
+
*/
|
|
36
|
+
export declare const sealVaultBytes: (rootKey: Uint8Array, ref: TVaultItemRef, plaintext: Uint8Array) => Promise<TEncryptedVaultItem>;
|
|
37
|
+
/**
|
|
38
|
+
* Open an item of either format from the root key. Throws on a wrong key or
|
|
39
|
+
* a tampered item (auth tag). The caller zeroes the result if it is secret.
|
|
40
|
+
*/
|
|
41
|
+
export declare const openVaultBytes: (rootKey: Uint8Array, ref: TVaultItemRef, item: TEncryptedVaultItem) => Promise<Uint8Array>;
|
|
42
|
+
/** {@link sealVaultBytes} for a string. */
|
|
43
|
+
export declare const sealVaultText: (rootKey: Uint8Array, ref: TVaultItemRef, plaintext: string) => Promise<TEncryptedVaultItem>;
|
|
44
|
+
/** {@link openVaultBytes} for a string. */
|
|
45
|
+
export declare const openVaultText: (rootKey: Uint8Array, ref: TVaultItemRef, item: TEncryptedVaultItem) => Promise<string>;
|