@openllmsh/sdk 2.10.12-alpha.1 → 2.10.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (634) hide show
  1. package/README.md +27 -7
  2. package/dist/client/chat.d.ts +38 -0
  3. package/dist/client/chat.js +77 -0
  4. package/dist/client/devices.d.ts +70 -0
  5. package/dist/client/devices.js +172 -0
  6. package/dist/client/http.d.ts +24 -0
  7. package/dist/client/http.js +34 -0
  8. package/dist/client/index.d.ts +43 -0
  9. package/dist/client/index.js +57 -0
  10. package/dist/client/relay-mux.d.ts +71 -0
  11. package/dist/client/relay-mux.js +394 -0
  12. package/dist/client/types.d.ts +47 -0
  13. package/dist/client/types.js +5 -0
  14. package/dist/client/vault.d.ts +68 -0
  15. package/dist/client/vault.js +113 -0
  16. package/dist/connect/chat.d.ts +24 -0
  17. package/dist/connect/chat.js +25 -0
  18. package/dist/connect/client.d.ts +50 -0
  19. package/dist/connect/client.js +141 -0
  20. package/dist/connect/config.d.ts +22 -0
  21. package/dist/connect/config.js +22 -0
  22. package/dist/connect/errors.d.ts +32 -0
  23. package/dist/connect/errors.js +85 -0
  24. package/{connect/index.ts → dist/connect/index.d.ts} +7 -7
  25. package/dist/connect/index.js +23 -0
  26. package/dist/connect/oauth.d.ts +51 -0
  27. package/dist/connect/oauth.js +150 -0
  28. package/dist/connect/routes.d.ts +38 -0
  29. package/dist/connect/routes.js +175 -0
  30. package/dist/connect/store.d.ts +26 -0
  31. package/dist/connect/store.js +65 -0
  32. package/dist/mcp/handle.d.ts +6 -0
  33. package/dist/mcp/handle.js +6 -0
  34. package/dist/mcp/index.d.ts +15 -0
  35. package/dist/mcp/index.js +10 -0
  36. package/dist/mcp/server.d.ts +84 -0
  37. package/dist/mcp/server.js +168 -0
  38. package/dist/mcp/tools/marketplace.d.ts +94 -0
  39. package/dist/mcp/tools/marketplace.js +303 -0
  40. package/dist/mcp/tools/memory-client.d.ts +109 -0
  41. package/dist/mcp/tools/memory-client.js +200 -0
  42. package/dist/mcp/tools/memory-config.d.ts +29 -0
  43. package/dist/mcp/tools/memory-config.js +12 -0
  44. package/dist/mcp/tools/memory.d.ts +92 -0
  45. package/dist/mcp/tools/memory.js +312 -0
  46. package/dist/mcp/tools/model-priority.d.ts +16 -0
  47. package/dist/mcp/tools/model-priority.js +87 -0
  48. package/dist/mcp/tools/openllm.d.ts +75 -0
  49. package/dist/mcp/tools/openllm.js +715 -0
  50. package/dist/mcp/types.d.ts +25 -0
  51. package/dist/mcp/types.js +7 -0
  52. package/dist/openapi/call.d.ts +26 -0
  53. package/dist/openapi/call.js +56 -0
  54. package/dist/openapi/index.d.ts +2 -0
  55. package/dist/openapi/index.js +2 -0
  56. package/dist/openapi/openapi.json +80213 -0
  57. package/dist/openapi/operations.d.ts +14 -0
  58. package/dist/openapi/operations.js +2060 -0
  59. package/dist/protocol/access.d.ts +81 -0
  60. package/dist/protocol/access.js +125 -0
  61. package/dist/protocol/agent-prompt-text.d.ts +15 -0
  62. package/{protocol/agent-prompt-text.ts → dist/protocol/agent-prompt-text.js} +9 -14
  63. package/dist/protocol/agent.d.ts +1487 -0
  64. package/dist/protocol/agent.js +787 -0
  65. package/dist/protocol/api-key-syntax.d.ts +58 -0
  66. package/dist/protocol/api-key-syntax.js +73 -0
  67. package/dist/protocol/audio.d.ts +18 -0
  68. package/dist/protocol/audio.js +21 -0
  69. package/dist/protocol/auth.d.ts +126 -0
  70. package/dist/protocol/auth.js +119 -0
  71. package/dist/protocol/changelog.d.ts +69 -0
  72. package/dist/protocol/changelog.js +107 -0
  73. package/dist/protocol/chat.d.ts +789 -0
  74. package/dist/protocol/chat.js +394 -0
  75. package/dist/protocol/client-registry.d.ts +151 -0
  76. package/dist/protocol/client-registry.js +238 -0
  77. package/dist/protocol/config.d.ts +508 -0
  78. package/dist/protocol/config.js +289 -0
  79. package/dist/protocol/control-channel.d.ts +102 -0
  80. package/{protocol/control-channel.ts → dist/protocol/control-channel.js} +33 -61
  81. package/dist/protocol/cooldown-reason.d.ts +30 -0
  82. package/dist/protocol/cooldown-reason.js +44 -0
  83. package/dist/protocol/cost.d.ts +9 -0
  84. package/dist/protocol/cost.js +8 -0
  85. package/dist/protocol/daemon-port.d.ts +2 -0
  86. package/dist/protocol/daemon-port.js +28 -0
  87. package/dist/protocol/daemon.d.ts +2034 -0
  88. package/dist/protocol/daemon.js +1286 -0
  89. package/dist/protocol/default-chains.d.ts +15 -0
  90. package/dist/protocol/default-chains.js +21 -0
  91. package/dist/protocol/device-state.d.ts +223 -0
  92. package/dist/protocol/device-state.js +52 -0
  93. package/dist/protocol/doctor-report-local.d.ts +105 -0
  94. package/{protocol/doctor-report-local.ts → dist/protocol/doctor-report-local.js} +92 -196
  95. package/dist/protocol/doctor-report-policy.d.ts +62 -0
  96. package/{protocol/doctor-report-policy.ts → dist/protocol/doctor-report-policy.js} +23 -76
  97. package/dist/protocol/doctor-report.d.ts +406 -0
  98. package/dist/protocol/doctor-report.js +645 -0
  99. package/dist/protocol/errors.d.ts +17 -0
  100. package/dist/protocol/errors.js +10 -0
  101. package/dist/protocol/execution-selection.d.ts +92 -0
  102. package/{protocol/execution-selection.ts → dist/protocol/execution-selection.js} +38 -63
  103. package/dist/protocol/hop-grant.d.ts +28 -0
  104. package/{protocol/hop-grant.ts → dist/protocol/hop-grant.js} +7 -13
  105. package/dist/protocol/image-edit-parse.d.ts +25 -0
  106. package/dist/protocol/image-edit-parse.js +196 -0
  107. package/dist/protocol/images.d.ts +288 -0
  108. package/dist/protocol/images.js +229 -0
  109. package/dist/protocol/index.d.ts +69 -0
  110. package/dist/protocol/index.js +74 -0
  111. package/dist/protocol/inference-headers.d.ts +3 -0
  112. package/dist/protocol/keepalive.d.ts +36 -0
  113. package/dist/protocol/keepalive.js +51 -0
  114. package/dist/protocol/local-auth.d.ts +125 -0
  115. package/dist/protocol/local-auth.js +227 -0
  116. package/dist/protocol/local-device-control.d.ts +108 -0
  117. package/{protocol/local-device-control.ts → dist/protocol/local-device-control.js} +40 -70
  118. package/dist/protocol/local-provider.d.ts +105 -0
  119. package/dist/protocol/local-provider.js +213 -0
  120. package/dist/protocol/local-session.d.ts +70 -0
  121. package/dist/protocol/local-session.js +87 -0
  122. package/dist/protocol/marketplace.d.ts +190 -0
  123. package/dist/protocol/marketplace.js +140 -0
  124. package/{protocol/media-attempt.ts → dist/protocol/media-attempt.d.ts} +11 -50
  125. package/dist/protocol/media-attempt.js +50 -0
  126. package/dist/protocol/media-bytes.d.ts +8 -0
  127. package/dist/protocol/media-bytes.js +21 -0
  128. package/dist/protocol/media-default.d.ts +56 -0
  129. package/dist/protocol/media-default.js +302 -0
  130. package/{protocol/media-dimensions.ts → dist/protocol/media-dimensions.d.ts} +11 -78
  131. package/dist/protocol/media-dimensions.js +90 -0
  132. package/dist/protocol/media-input.d.ts +20 -0
  133. package/dist/protocol/media-input.js +29 -0
  134. package/dist/protocol/media-model.d.ts +77 -0
  135. package/dist/protocol/media-model.js +89 -0
  136. package/{protocol/media-option-issue.ts → dist/protocol/media-option-issue.d.ts} +25 -53
  137. package/dist/protocol/media-option-issue.js +50 -0
  138. package/dist/protocol/media-types.d.ts +14 -0
  139. package/dist/protocol/media-types.js +61 -0
  140. package/dist/protocol/model-match.d.ts +254 -0
  141. package/dist/protocol/model-match.js +760 -0
  142. package/dist/protocol/model-settings.d.ts +153 -0
  143. package/dist/protocol/model-settings.js +246 -0
  144. package/dist/protocol/models.d.ts +1065 -0
  145. package/dist/protocol/models.js +638 -0
  146. package/dist/protocol/mux.d.ts +350 -0
  147. package/dist/protocol/mux.js +595 -0
  148. package/{protocol/plan-surface.ts → dist/protocol/plan-surface.d.ts} +12 -26
  149. package/dist/protocol/plan-surface.js +39 -0
  150. package/dist/protocol/provider-models.d.ts +8 -0
  151. package/{protocol/provider-models.ts → dist/protocol/provider-models.js} +7 -9
  152. package/dist/protocol/provider-status.d.ts +59 -0
  153. package/dist/protocol/provider-status.js +142 -0
  154. package/dist/protocol/provider-tier.d.ts +34 -0
  155. package/{protocol/provider-tier.ts → dist/protocol/provider-tier.js} +9 -34
  156. package/dist/protocol/provider-usage.d.ts +230 -0
  157. package/dist/protocol/provider-usage.js +214 -0
  158. package/dist/protocol/providers.d.ts +2496 -0
  159. package/dist/protocol/providers.js +723 -0
  160. package/dist/protocol/public-usage-index.d.ts +449 -0
  161. package/dist/protocol/public-usage-index.js +279 -0
  162. package/dist/protocol/realtime-generated.d.ts +29 -0
  163. package/{protocol/realtime-generated.ts → dist/protocol/realtime-generated.js} +3 -5
  164. package/dist/protocol/realtime.d.ts +241 -0
  165. package/{protocol/realtime.ts → dist/protocol/realtime.js} +88 -155
  166. package/dist/protocol/registry-pointer.d.ts +24 -0
  167. package/dist/protocol/registry-pointer.js +78 -0
  168. package/dist/protocol/relay.d.ts +1152 -0
  169. package/{protocol/relay.ts → dist/protocol/relay.js} +237 -370
  170. package/dist/protocol/replay-session.d.ts +4 -0
  171. package/{protocol/replay-session.ts → dist/protocol/replay-session.js} +1 -8
  172. package/dist/protocol/responses.d.ts +303 -0
  173. package/dist/protocol/responses.js +240 -0
  174. package/dist/protocol/semver.d.ts +59 -0
  175. package/dist/protocol/semver.js +171 -0
  176. package/{protocol/setup-mode.ts → dist/protocol/setup-mode.d.ts} +4 -12
  177. package/dist/protocol/setup-mode.js +18 -0
  178. package/dist/protocol/sha256-hex.d.ts +2 -0
  179. package/dist/protocol/sha256-hex.js +93 -0
  180. package/dist/protocol/stats.d.ts +711 -0
  181. package/dist/protocol/stats.js +353 -0
  182. package/dist/protocol/streaming.d.ts +16 -0
  183. package/dist/protocol/streaming.js +15 -0
  184. package/{protocol/subscription-daemon-floors.ts → dist/protocol/subscription-daemon-floors.d.ts} +8 -14
  185. package/dist/protocol/subscription-daemon-floors.js +4 -0
  186. package/dist/protocol/subscription-provider-compat.d.ts +44 -0
  187. package/dist/protocol/subscription-provider-compat.js +67 -0
  188. package/dist/protocol/subscription-provider.d.ts +15 -0
  189. package/dist/protocol/subscription-provider.js +17 -0
  190. package/dist/protocol/team-grant.d.ts +14 -0
  191. package/{protocol/team-grant.ts → dist/protocol/team-grant.js} +0 -3
  192. package/dist/protocol/team-shareable.d.ts +6 -0
  193. package/{protocol/team-shareable.ts → dist/protocol/team-shareable.js} +29 -33
  194. package/dist/protocol/transcription-encoding.d.ts +25 -0
  195. package/dist/protocol/transcription-encoding.js +47 -0
  196. package/{protocol/url-locality-dns.ts → dist/protocol/url-locality-dns.d.ts} +1 -23
  197. package/dist/protocol/url-locality-dns.js +33 -0
  198. package/dist/protocol/url-locality.d.ts +45 -0
  199. package/dist/protocol/url-locality.js +288 -0
  200. package/dist/protocol/usage-snapshots.d.ts +8 -0
  201. package/{protocol/usage-snapshots.ts → dist/protocol/usage-snapshots.js} +1 -2
  202. package/dist/protocol/vendor-cli-install.d.ts +20 -0
  203. package/{protocol/vendor-cli-install.ts → dist/protocol/vendor-cli-install.js} +10 -15
  204. package/dist/protocol/video-job-plan.d.ts +18 -0
  205. package/dist/protocol/video-job-plan.js +44 -0
  206. package/dist/protocol/videos.d.ts +107 -0
  207. package/dist/protocol/videos.js +154 -0
  208. package/dist/tunnel/channel-envelope.d.ts +53 -0
  209. package/dist/tunnel/channel-envelope.js +100 -0
  210. package/dist/tunnel/codec.d.ts +71 -0
  211. package/dist/tunnel/codec.js +151 -0
  212. package/dist/tunnel/device-anchor.d.ts +62 -0
  213. package/dist/tunnel/device-anchor.js +168 -0
  214. package/dist/tunnel/device-control.d.ts +50 -0
  215. package/dist/tunnel/device-control.js +88 -0
  216. package/dist/tunnel/device-grant.d.ts +91 -0
  217. package/dist/tunnel/device-grant.js +105 -0
  218. package/dist/tunnel/fleet.d.ts +28 -0
  219. package/dist/tunnel/fleet.js +41 -0
  220. package/dist/tunnel/index.d.ts +22 -0
  221. package/dist/tunnel/index.js +22 -0
  222. package/dist/tunnel/mux.d.ts +64 -0
  223. package/dist/tunnel/mux.js +449 -0
  224. package/dist/tunnel/peer-link.d.ts +88 -0
  225. package/dist/tunnel/peer-link.js +271 -0
  226. package/dist/tunnel/rtc-auth.d.ts +159 -0
  227. package/dist/tunnel/rtc-auth.js +340 -0
  228. package/dist/tunnel/rtc-duplex.d.ts +52 -0
  229. package/dist/tunnel/rtc-duplex.js +148 -0
  230. package/dist/tunnel/rtc-ice.d.ts +55 -0
  231. package/dist/tunnel/rtc-ice.js +100 -0
  232. package/dist/tunnel/secure.d.ts +179 -0
  233. package/dist/tunnel/secure.js +936 -0
  234. package/dist/tunnel/stream-reset-error.d.ts +6 -0
  235. package/dist/tunnel/stream-reset-error.js +9 -0
  236. package/dist/tunnel/streams.d.ts +244 -0
  237. package/dist/tunnel/streams.js +1071 -0
  238. package/dist/tunnel/team-grant.d.ts +90 -0
  239. package/dist/tunnel/team-grant.js +226 -0
  240. package/dist/tunnel/wire-bytes.d.ts +32 -0
  241. package/dist/tunnel/wire-bytes.js +90 -0
  242. package/dist/vault/api-key.d.ts +71 -0
  243. package/dist/vault/api-key.js +130 -0
  244. package/{vault/argon2.ts → dist/vault/argon2.d.ts} +18 -53
  245. package/dist/vault/argon2.js +82 -0
  246. package/dist/vault/cli-auth-seal.d.ts +35 -0
  247. package/dist/vault/cli-auth-seal.js +78 -0
  248. package/dist/vault/cred-seal.d.ts +18 -0
  249. package/dist/vault/cred-seal.js +86 -0
  250. package/dist/vault/credential.d.ts +21 -0
  251. package/dist/vault/credential.js +26 -0
  252. package/dist/vault/crypto.d.ts +51 -0
  253. package/dist/vault/crypto.js +156 -0
  254. package/dist/vault/daemon-attest.d.ts +68 -0
  255. package/dist/vault/daemon-attest.js +147 -0
  256. package/dist/vault/derive.d.ts +34 -0
  257. package/dist/vault/derive.js +84 -0
  258. package/dist/vault/device-access.d.ts +17 -0
  259. package/dist/vault/device-access.js +77 -0
  260. package/dist/vault/device-anchor.d.ts +42 -0
  261. package/dist/vault/device-anchor.js +90 -0
  262. package/dist/vault/device-control.d.ts +80 -0
  263. package/{vault/device-control.ts → dist/vault/device-control.js} +46 -104
  264. package/dist/vault/handoff.d.ts +102 -0
  265. package/dist/vault/handoff.js +236 -0
  266. package/dist/vault/index.d.ts +21 -0
  267. package/dist/vault/index.js +21 -0
  268. package/dist/vault/passkey.d.ts +82 -0
  269. package/{vault/passkey.ts → dist/vault/passkey.js} +63 -153
  270. package/dist/vault/phrase.d.ts +40 -0
  271. package/{vault/phrase.ts → dist/vault/phrase.js} +17 -23
  272. package/dist/vault/pin.d.ts +46 -0
  273. package/dist/vault/pin.js +92 -0
  274. package/dist/vault/public-key-seal.d.ts +17 -0
  275. package/dist/vault/public-key-seal.js +59 -0
  276. package/dist/vault/seed.d.ts +96 -0
  277. package/dist/vault/seed.js +179 -0
  278. package/dist/vault/team.d.ts +134 -0
  279. package/dist/vault/team.js +217 -0
  280. package/dist/vault/vault-item.d.ts +45 -0
  281. package/dist/vault/vault-item.js +62 -0
  282. package/dist/vault/vault-migrate-digest.d.ts +10 -0
  283. package/dist/vault/vault-migrate-digest.js +22 -0
  284. package/dist/vault/wrapped.d.ts +19 -0
  285. package/dist/vault/wrapped.js +52 -0
  286. package/dist/wire/adapters/messages/anthropic-map.d.ts +8 -0
  287. package/dist/wire/adapters/messages/anthropic-map.js +32 -0
  288. package/dist/wire/adapters/messages/index.d.ts +7 -0
  289. package/dist/wire/adapters/messages/index.js +7 -0
  290. package/dist/wire/adapters/messages/reasoning-from-items.d.ts +14 -0
  291. package/dist/wire/adapters/messages/reasoning-from-items.js +39 -0
  292. package/dist/wire/adapters/messages/reasoning-signature.d.ts +81 -0
  293. package/dist/wire/adapters/messages/reasoning-signature.js +180 -0
  294. package/dist/wire/adapters/messages/request.d.ts +28 -0
  295. package/dist/wire/adapters/messages/request.js +490 -0
  296. package/dist/wire/adapters/messages/response.d.ts +10 -0
  297. package/dist/wire/adapters/messages/response.js +177 -0
  298. package/dist/wire/adapters/messages/streaming.d.ts +134 -0
  299. package/dist/wire/adapters/messages/streaming.js +791 -0
  300. package/dist/wire/adapters/messages/usage.d.ts +20 -0
  301. package/dist/wire/adapters/messages/usage.js +10 -0
  302. package/dist/wire/adapters/responses/index.d.ts +3 -0
  303. package/dist/wire/adapters/responses/index.js +3 -0
  304. package/dist/wire/adapters/responses/request.d.ts +2 -0
  305. package/dist/wire/adapters/responses/request.js +287 -0
  306. package/dist/wire/adapters/responses/response.d.ts +11 -0
  307. package/dist/wire/adapters/responses/response.js +69 -0
  308. package/dist/wire/adapters/responses/streaming.d.ts +2 -0
  309. package/dist/wire/adapters/responses/streaming.js +267 -0
  310. package/dist/wire/features/account-rank.d.ts +61 -0
  311. package/dist/wire/features/account-rank.js +109 -0
  312. package/dist/wire/features/compaction/compact-request.d.ts +69 -0
  313. package/dist/wire/features/compaction/compact-request.js +667 -0
  314. package/dist/wire/features/compaction/compaction-text.d.ts +17 -0
  315. package/dist/wire/features/compaction/compaction-text.js +29 -0
  316. package/dist/wire/features/context-demote.d.ts +15 -0
  317. package/dist/wire/features/context-demote.js +45 -0
  318. package/dist/wire/features/context-overflow-strategy.d.ts +12 -0
  319. package/dist/wire/features/context-overflow-strategy.js +8 -0
  320. package/dist/wire/features/context-skip.d.ts +120 -0
  321. package/{wire/features/context-skip.ts → dist/wire/features/context-skip.js} +23 -57
  322. package/dist/wire/features/conversation-affinity.d.ts +49 -0
  323. package/dist/wire/features/conversation-affinity.js +121 -0
  324. package/dist/wire/features/max-tokens-backfill.d.ts +50 -0
  325. package/dist/wire/features/max-tokens-backfill.js +118 -0
  326. package/dist/wire/features/model-caps.d.ts +7 -0
  327. package/dist/wire/features/model-caps.js +40 -0
  328. package/dist/wire/features/model-settings.d.ts +3 -0
  329. package/dist/wire/features/model-settings.js +13 -0
  330. package/dist/wire/features/output-limit-clamp.d.ts +14 -0
  331. package/dist/wire/features/output-limit-clamp.js +36 -0
  332. package/dist/wire/features/quota-gate.d.ts +16 -0
  333. package/dist/wire/features/quota-gate.js +48 -0
  334. package/dist/wire/index.d.ts +44 -0
  335. package/dist/wire/index.js +44 -0
  336. package/dist/wire/lib/attempt-outcome.d.ts +19 -0
  337. package/dist/wire/lib/attempt-outcome.js +18 -0
  338. package/{wire/lib/canonical/content-part.ts → dist/wire/lib/canonical/content-part.d.ts} +12 -18
  339. package/dist/wire/lib/canonical/content-part.js +11 -0
  340. package/dist/wire/lib/canonical/count-tokens-capability.d.ts +52 -0
  341. package/dist/wire/lib/canonical/count-tokens-capability.js +109 -0
  342. package/{wire/lib/canonical/encoding-select.ts → dist/wire/lib/canonical/encoding-select.d.ts} +7 -24
  343. package/dist/wire/lib/canonical/encoding-select.js +26 -0
  344. package/dist/wire/lib/canonical/image-signature.d.ts +20 -0
  345. package/dist/wire/lib/canonical/image-signature.js +184 -0
  346. package/dist/wire/lib/canonical/image-sse.d.ts +88 -0
  347. package/dist/wire/lib/canonical/image-sse.js +173 -0
  348. package/{wire/lib/canonical/message.ts → dist/wire/lib/canonical/message.d.ts} +2 -20
  349. package/dist/wire/lib/canonical/message.js +31 -0
  350. package/dist/wire/lib/canonical/token-estimate.d.ts +98 -0
  351. package/dist/wire/lib/canonical/token-estimate.js +230 -0
  352. package/dist/wire/lib/encrypted-content.d.ts +22 -0
  353. package/dist/wire/lib/encrypted-content.js +55 -0
  354. package/dist/wire/lib/error-class.d.ts +57 -0
  355. package/dist/wire/lib/error-class.js +97 -0
  356. package/dist/wire/lib/error-envelope.d.ts +20 -0
  357. package/dist/wire/lib/error-envelope.js +53 -0
  358. package/dist/wire/lib/forwarded-headers.d.ts +16 -0
  359. package/{wire/lib/forwarded-headers.ts → dist/wire/lib/forwarded-headers.js} +62 -72
  360. package/dist/wire/lib/provider-error-rules.d.ts +21 -0
  361. package/dist/wire/lib/provider-error-rules.js +20 -0
  362. package/{wire/lib/refusal.ts → dist/wire/lib/refusal.d.ts} +3 -13
  363. package/dist/wire/lib/refusal.js +27 -0
  364. package/dist/wire/lib/responses-apply-patch.d.ts +57 -0
  365. package/dist/wire/lib/responses-apply-patch.js +81 -0
  366. package/dist/wire/lib/responses-namespace.d.ts +27 -0
  367. package/{wire/lib/responses-namespace.ts → dist/wire/lib/responses-namespace.js} +16 -32
  368. package/dist/wire/lib/secret-scrub.d.ts +23 -0
  369. package/dist/wire/lib/secret-scrub.js +72 -0
  370. package/dist/wire/lib/streaming/accumulate.d.ts +12 -0
  371. package/dist/wire/lib/streaming/accumulate.js +187 -0
  372. package/dist/wire/lib/streaming/finish-reason.d.ts +20 -0
  373. package/dist/wire/lib/streaming/finish-reason.js +15 -0
  374. package/{wire/lib/streaming/peek.ts → dist/wire/lib/streaming/peek.d.ts} +13 -82
  375. package/dist/wire/lib/streaming/peek.js +100 -0
  376. package/dist/wire/lib/streaming/provider-decode.d.ts +57 -0
  377. package/dist/wire/lib/streaming/provider-decode.js +210 -0
  378. package/dist/wire/lib/streaming/response-stream.d.ts +16 -0
  379. package/dist/wire/lib/streaming/response-stream.js +64 -0
  380. package/dist/wire/lib/streaming/sse.d.ts +130 -0
  381. package/dist/wire/lib/streaming/sse.js +600 -0
  382. package/dist/wire/lib/streaming/strip-tool-calls.d.ts +14 -0
  383. package/dist/wire/lib/streaming/strip-tool-calls.js +75 -0
  384. package/dist/wire/lib/streaming/upstream-error.d.ts +32 -0
  385. package/dist/wire/lib/streaming/upstream-error.js +45 -0
  386. package/dist/wire/lib/strip-subagent-isolation.d.ts +16 -0
  387. package/dist/wire/lib/strip-subagent-isolation.js +240 -0
  388. package/dist/wire/lib/thinking-signature.d.ts +56 -0
  389. package/{wire/lib/thinking-signature.ts → dist/wire/lib/thinking-signature.js} +77 -84
  390. package/dist/wire/lib/token-ruler/bpe-core.d.ts +105 -0
  391. package/dist/wire/lib/token-ruler/bpe-core.js +398 -0
  392. package/dist/wire/lib/token-ruler/index.d.ts +2 -0
  393. package/dist/wire/lib/token-ruler/index.js +2 -0
  394. package/dist/wire/lib/token-ruler/ruler.d.ts +36 -0
  395. package/dist/wire/lib/token-ruler/ruler.js +50 -0
  396. package/dist/wire/lib/token-ruler/vocab/claude-ranks.d.ts +14 -0
  397. package/dist/wire/lib/token-ruler/vocab/claude-ranks.js +16 -0
  398. package/{wire/lib/token-ruler/vocab/claude.ts → dist/wire/lib/token-ruler/vocab/claude.d.ts} +2 -12
  399. package/dist/wire/lib/token-ruler/vocab/claude.js +8 -0
  400. package/dist/wire/lib/token-ruler/vocab/o200k-ranks.d.ts +3 -0
  401. package/dist/wire/lib/token-ruler/vocab/o200k-ranks.js +18 -0
  402. package/dist/wire/lib/token-ruler/vocab/o200k.d.ts +11 -0
  403. package/dist/wire/lib/token-ruler/vocab/o200k.js +6 -0
  404. package/dist/wire/lib/tool-name-map.d.ts +44 -0
  405. package/dist/wire/lib/tool-name-map.js +186 -0
  406. package/dist/wire/lib/tool-schema.d.ts +15 -0
  407. package/dist/wire/lib/tool-schema.js +307 -0
  408. package/dist/wire/lib/usage-observer.d.ts +9 -0
  409. package/dist/wire/lib/usage-observer.js +108 -0
  410. package/dist/wire/providers/anthropic/adaptive-thinking.d.ts +125 -0
  411. package/dist/wire/providers/anthropic/adaptive-thinking.js +221 -0
  412. package/dist/wire/providers/anthropic/beta-headers.d.ts +44 -0
  413. package/{wire/providers/anthropic/beta-headers.ts → dist/wire/providers/anthropic/beta-headers.js} +57 -79
  414. package/dist/wire/providers/anthropic/index.d.ts +6 -0
  415. package/{wire/providers/anthropic/index.ts → dist/wire/providers/anthropic/index.js} +6 -6
  416. package/dist/wire/providers/anthropic/request.d.ts +12 -0
  417. package/dist/wire/providers/anthropic/request.js +456 -0
  418. package/dist/wire/providers/anthropic/response.d.ts +3 -0
  419. package/dist/wire/providers/anthropic/response.js +126 -0
  420. package/dist/wire/providers/anthropic/streaming.d.ts +28 -0
  421. package/dist/wire/providers/anthropic/streaming.js +268 -0
  422. package/dist/wire/providers/anthropic/web-search-domains.d.ts +7 -0
  423. package/dist/wire/providers/anthropic/web-search-domains.js +36 -0
  424. package/dist/wire/providers/chatgpt/common.d.ts +27 -0
  425. package/{wire/providers/chatgpt/common.ts → dist/wire/providers/chatgpt/common.js} +69 -89
  426. package/dist/wire/providers/chatgpt/index.d.ts +4 -0
  427. package/{wire/providers/chatgpt/index.ts → dist/wire/providers/chatgpt/index.js} +4 -4
  428. package/dist/wire/providers/chatgpt/request.d.ts +132 -0
  429. package/dist/wire/providers/chatgpt/request.js +696 -0
  430. package/dist/wire/providers/chatgpt/streaming.d.ts +69 -0
  431. package/dist/wire/providers/chatgpt/streaming.js +761 -0
  432. package/dist/wire/providers/chatgpt/web-search.d.ts +19 -0
  433. package/dist/wire/providers/chatgpt/web-search.js +55 -0
  434. package/dist/wire/providers/grok/web-search.d.ts +23 -0
  435. package/dist/wire/providers/grok/web-search.js +74 -0
  436. package/dist/wire/providers/kimi/web-search.d.ts +48 -0
  437. package/dist/wire/providers/kimi/web-search.js +106 -0
  438. package/dist/wire/providers/upstream-deny.d.ts +61 -0
  439. package/dist/wire/providers/upstream-deny.js +293 -0
  440. package/dist/wire/providers/upstream-request.d.ts +104 -0
  441. package/dist/wire/providers/upstream-request.js +411 -0
  442. package/package.json +105 -23
  443. package/ARCHITECTURE.md +0 -43
  444. package/client/chat.ts +0 -140
  445. package/client/devices.ts +0 -269
  446. package/client/http.ts +0 -72
  447. package/client/index.ts +0 -129
  448. package/client/relay-mux.ts +0 -547
  449. package/client/types.ts +0 -51
  450. package/client/vault.ts +0 -239
  451. package/connect/chat.ts +0 -58
  452. package/connect/client.ts +0 -240
  453. package/connect/config.ts +0 -47
  454. package/connect/errors.ts +0 -121
  455. package/connect/oauth.ts +0 -265
  456. package/connect/routes.ts +0 -234
  457. package/connect/store.ts +0 -107
  458. package/mcp/handle.ts +0 -24
  459. package/mcp/index.ts +0 -76
  460. package/mcp/server.ts +0 -319
  461. package/mcp/tools/marketplace.ts +0 -439
  462. package/mcp/tools/memory-client.ts +0 -297
  463. package/mcp/tools/memory-config.ts +0 -32
  464. package/mcp/tools/memory.ts +0 -369
  465. package/mcp/tools/model-priority.ts +0 -88
  466. package/mcp/tools/openllm.ts +0 -883
  467. package/mcp/types.ts +0 -28
  468. package/openapi/call.ts +0 -90
  469. package/openapi/index.ts +0 -8
  470. package/openapi/openapi.json +0 -80213
  471. package/openapi/operations.ts +0 -2075
  472. package/protocol/CONTRIBUTING.md +0 -21
  473. package/protocol/README.md +0 -134
  474. package/protocol/access.ts +0 -186
  475. package/protocol/agent.ts +0 -991
  476. package/protocol/api-key-syntax.ts +0 -105
  477. package/protocol/assets/openllm-light.svg +0 -18
  478. package/protocol/assets/openllm.svg +0 -18
  479. package/protocol/audio.ts +0 -29
  480. package/protocol/auth.ts +0 -142
  481. package/protocol/changelog.ts +0 -155
  482. package/protocol/chat.ts +0 -458
  483. package/protocol/client-registry.ts +0 -356
  484. package/protocol/config.ts +0 -345
  485. package/protocol/cooldown-reason.ts +0 -78
  486. package/protocol/cost.ts +0 -10
  487. package/protocol/daemon-port.ts +0 -31
  488. package/protocol/daemon.ts +0 -1524
  489. package/protocol/default-chains.ts +0 -66
  490. package/protocol/device-state.ts +0 -85
  491. package/protocol/doctor-report.ts +0 -947
  492. package/protocol/errors.ts +0 -14
  493. package/protocol/image-edit-parse.ts +0 -263
  494. package/protocol/images.ts +0 -298
  495. package/protocol/index.ts +0 -74
  496. package/protocol/keepalive.ts +0 -69
  497. package/protocol/local-auth.ts +0 -300
  498. package/protocol/local-provider.ts +0 -288
  499. package/protocol/local-session.ts +0 -118
  500. package/protocol/marketplace.ts +0 -187
  501. package/protocol/media-bytes.ts +0 -28
  502. package/protocol/media-default.ts +0 -357
  503. package/protocol/media-input.ts +0 -61
  504. package/protocol/media-model.ts +0 -142
  505. package/protocol/media-types.ts +0 -70
  506. package/protocol/model-match.ts +0 -1051
  507. package/protocol/model-settings.ts +0 -327
  508. package/protocol/models.ts +0 -767
  509. package/protocol/mux.ts +0 -722
  510. package/protocol/provider-status.ts +0 -206
  511. package/protocol/provider-usage.ts +0 -263
  512. package/protocol/providers.ts +0 -901
  513. package/protocol/public-usage-index.ts +0 -354
  514. package/protocol/registry-pointer.ts +0 -118
  515. package/protocol/responses.ts +0 -280
  516. package/protocol/semver.ts +0 -182
  517. package/protocol/sha256-hex.ts +0 -98
  518. package/protocol/stats.ts +0 -406
  519. package/protocol/streaming.ts +0 -19
  520. package/protocol/subscription-provider-compat.ts +0 -104
  521. package/protocol/subscription-provider.ts +0 -32
  522. package/protocol/transcription-encoding.ts +0 -76
  523. package/protocol/url-locality.ts +0 -288
  524. package/protocol/video-job-plan.ts +0 -50
  525. package/protocol/videos.ts +0 -227
  526. package/tsconfig.json +0 -14
  527. package/tunnel/ARCHITECTURE.md +0 -111
  528. package/tunnel/assets/openllm-light.svg +0 -18
  529. package/tunnel/assets/openllm.svg +0 -18
  530. package/tunnel/channel-envelope.ts +0 -139
  531. package/tunnel/codec.ts +0 -191
  532. package/tunnel/device-anchor.ts +0 -229
  533. package/tunnel/device-control.ts +0 -118
  534. package/tunnel/device-grant.ts +0 -173
  535. package/tunnel/fleet.ts +0 -77
  536. package/tunnel/index.ts +0 -22
  537. package/tunnel/mux.ts +0 -580
  538. package/tunnel/peer-link.ts +0 -390
  539. package/tunnel/rtc-auth.ts +0 -415
  540. package/tunnel/rtc-duplex.ts +0 -187
  541. package/tunnel/rtc-ice.ts +0 -136
  542. package/tunnel/secure.ts +0 -1298
  543. package/tunnel/stream-reset-error.ts +0 -14
  544. package/tunnel/streams.ts +0 -1430
  545. package/tunnel/team-grant.ts +0 -302
  546. package/tunnel/wire-bytes.ts +0 -102
  547. package/vault/ARCHITECTURE.md +0 -470
  548. package/vault/api-key.ts +0 -190
  549. package/vault/cli-auth-seal.ts +0 -157
  550. package/vault/cred-seal.ts +0 -146
  551. package/vault/credential.ts +0 -55
  552. package/vault/crypto.ts +0 -210
  553. package/vault/daemon-attest.ts +0 -229
  554. package/vault/derive.ts +0 -113
  555. package/vault/device-access.ts +0 -87
  556. package/vault/device-anchor.ts +0 -185
  557. package/vault/handoff.ts +0 -396
  558. package/vault/index.ts +0 -21
  559. package/vault/pin.ts +0 -153
  560. package/vault/public-key-seal.ts +0 -131
  561. package/vault/seed.ts +0 -272
  562. package/vault/team.ts +0 -355
  563. package/vault/vault-item.ts +0 -131
  564. package/vault/vault-migrate-digest.ts +0 -29
  565. package/vault/wrapped.ts +0 -77
  566. package/wire/ARCHITECTURE.md +0 -90
  567. package/wire/CONTRIBUTING.md +0 -19
  568. package/wire/adapters/messages/anthropic-map.ts +0 -37
  569. package/wire/adapters/messages/index.ts +0 -7
  570. package/wire/adapters/messages/reasoning-from-items.ts +0 -38
  571. package/wire/adapters/messages/reasoning-signature.ts +0 -243
  572. package/wire/adapters/messages/request.ts +0 -574
  573. package/wire/adapters/messages/response.ts +0 -215
  574. package/wire/adapters/messages/streaming.ts +0 -1027
  575. package/wire/adapters/messages/usage.ts +0 -43
  576. package/wire/adapters/responses/index.ts +0 -3
  577. package/wire/adapters/responses/request.ts +0 -395
  578. package/wire/adapters/responses/response.ts +0 -88
  579. package/wire/adapters/responses/streaming.ts +0 -344
  580. package/wire/assets/openllm-light.svg +0 -18
  581. package/wire/assets/openllm.svg +0 -18
  582. package/wire/features/account-rank.ts +0 -166
  583. package/wire/features/compaction/compact-request.ts +0 -862
  584. package/wire/features/compaction/compaction-text.ts +0 -43
  585. package/wire/features/context-demote.ts +0 -47
  586. package/wire/features/context-overflow-strategy.ts +0 -26
  587. package/wire/features/conversation-affinity.ts +0 -144
  588. package/wire/features/max-tokens-backfill.ts +0 -141
  589. package/wire/features/model-caps.ts +0 -53
  590. package/wire/features/model-settings.ts +0 -24
  591. package/wire/features/output-limit-clamp.ts +0 -64
  592. package/wire/features/quota-gate.ts +0 -85
  593. package/wire/index.ts +0 -44
  594. package/wire/lib/attempt-outcome.ts +0 -43
  595. package/wire/lib/canonical/count-tokens-capability.ts +0 -138
  596. package/wire/lib/canonical/image-signature.ts +0 -202
  597. package/wire/lib/canonical/image-sse.ts +0 -216
  598. package/wire/lib/canonical/token-estimate.ts +0 -266
  599. package/wire/lib/encrypted-content.ts +0 -66
  600. package/wire/lib/error-class.ts +0 -154
  601. package/wire/lib/error-envelope.ts +0 -56
  602. package/wire/lib/provider-error-rules.ts +0 -48
  603. package/wire/lib/responses-apply-patch.ts +0 -104
  604. package/wire/lib/secret-scrub.ts +0 -101
  605. package/wire/lib/streaming/accumulate.ts +0 -221
  606. package/wire/lib/streaming/finish-reason.ts +0 -33
  607. package/wire/lib/streaming/provider-decode.ts +0 -259
  608. package/wire/lib/streaming/response-stream.ts +0 -71
  609. package/wire/lib/streaming/sse.ts +0 -699
  610. package/wire/lib/streaming/strip-tool-calls.ts +0 -95
  611. package/wire/lib/streaming/upstream-error.ts +0 -58
  612. package/wire/lib/strip-subagent-isolation.ts +0 -284
  613. package/wire/lib/token-ruler/bpe-core.ts +0 -426
  614. package/wire/lib/token-ruler/index.ts +0 -2
  615. package/wire/lib/token-ruler/ruler.ts +0 -79
  616. package/wire/lib/token-ruler/vocab/claude-ranks.ts +0 -16
  617. package/wire/lib/token-ruler/vocab/o200k-ranks.ts +0 -18
  618. package/wire/lib/token-ruler/vocab/o200k.ts +0 -19
  619. package/wire/lib/tool-name-map.ts +0 -271
  620. package/wire/lib/tool-schema.ts +0 -353
  621. package/wire/lib/usage-observer.ts +0 -125
  622. package/wire/providers/anthropic/adaptive-thinking.ts +0 -291
  623. package/wire/providers/anthropic/request.ts +0 -607
  624. package/wire/providers/anthropic/response.ts +0 -155
  625. package/wire/providers/anthropic/streaming.ts +0 -315
  626. package/wire/providers/anthropic/web-search-domains.ts +0 -49
  627. package/wire/providers/chatgpt/request.ts +0 -959
  628. package/wire/providers/chatgpt/streaming.ts +0 -1007
  629. package/wire/providers/chatgpt/web-search.ts +0 -63
  630. package/wire/providers/grok/web-search.ts +0 -87
  631. package/wire/providers/kimi/web-search.ts +0 -145
  632. package/wire/providers/upstream-deny.ts +0 -355
  633. package/wire/providers/upstream-request.ts +0 -619
  634. /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>;