@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.
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
@@ -1,12 +1,9 @@
1
- import { argon2id } from "hash-wasm";
2
-
3
1
  export type TArgon2Params = {
4
- readonly parallelism: number;
5
- readonly iterations: number;
6
- readonly memorySize: number;
7
- readonly hashLength: number;
2
+ readonly parallelism: number;
3
+ readonly iterations: number;
4
+ readonly memorySize: number;
5
+ readonly hashLength: number;
8
6
  };
9
-
10
7
  /**
11
8
  * Every set of Argon2id parameters this build knows how to derive with,
12
9
  * keyed by the version stamped into the blob that was wrapped with them.
@@ -36,30 +33,24 @@ export type TArgon2Params = {
36
33
  * parallelism 1 — single-thread to keep WASM portable
37
34
  * hashLength 32 bytes — direct AES-GCM key
38
35
  */
39
- export const KDF_PARAMS_BY_VERSION = {
40
- 1: {
41
- parallelism: 1,
42
- iterations: 3,
43
- memorySize: 64 * 1024,
44
- hashLength: 32,
45
- },
46
- } as const satisfies Record<number, TArgon2Params>;
47
-
36
+ export declare const KDF_PARAMS_BY_VERSION: {
37
+ readonly 1: {
38
+ readonly parallelism: 1;
39
+ readonly iterations: 3;
40
+ readonly memorySize: number;
41
+ readonly hashLength: 32;
42
+ };
43
+ };
48
44
  export type TKdfVersion = keyof typeof KDF_PARAMS_BY_VERSION;
49
-
50
45
  /** The version fresh wraps are produced under. */
51
- export const CURRENT_KDF_VERSION: TKdfVersion = 1;
52
-
46
+ export declare const CURRENT_KDF_VERSION: TKdfVersion;
53
47
  /**
54
48
  * The version an unstamped blob is from. Not a guess — stamping was
55
49
  * introduced alongside version 2's *possibility*, so everything unstamped
56
50
  * predates it and was necessarily derived with v1 parameters.
57
51
  */
58
- export const LEGACY_KDF_VERSION: TKdfVersion = 1;
59
-
60
- export const isKdfVersion = (n: number): n is TKdfVersion =>
61
- Object.hasOwn(KDF_PARAMS_BY_VERSION, n);
62
-
52
+ export declare const LEGACY_KDF_VERSION: TKdfVersion;
53
+ export declare const isKdfVersion: (n: number) => n is TKdfVersion;
63
54
  /**
64
55
  * Narrow a declared version to one this build can derive, or fail loudly.
65
56
  *
@@ -67,18 +58,8 @@ export const isKdfVersion = (n: number): n is TKdfVersion =>
67
58
  * older than the vault — an app-update problem with a clear answer, not the
68
59
  * silent "wrong password" an unknown-params derivation would masquerade as.
69
60
  */
70
- export const requireKdfVersion = (version: number): TKdfVersion => {
71
- if (!isKdfVersion(version)) {
72
- throw new Error(
73
- `vault blob was wrapped with unknown KDF version ${version} — this build is too old to open it`,
74
- );
75
- }
76
- return version;
77
- };
78
-
79
- export const kdfParamsFor = (version: number): TArgon2Params =>
80
- KDF_PARAMS_BY_VERSION[requireKdfVersion(version)];
81
-
61
+ export declare const requireKdfVersion: (version: number) => TKdfVersion;
62
+ export declare const kdfParamsFor: (version: number) => TArgon2Params;
82
63
  /**
83
64
  * Derive a 32-byte wrap key from a secret (recovery phrase or PIN) and a salt.
84
65
  *
@@ -87,20 +68,4 @@ export const kdfParamsFor = (version: number): TArgon2Params =>
87
68
  * brick this module exists to prevent. Lazy-loaded WASM (~50 KB); the first
88
69
  * call pays the cold start.
89
70
  */
90
- export const deriveWrapKey = async (
91
- secret: string,
92
- saltBytes: Uint8Array,
93
- version: TKdfVersion = CURRENT_KDF_VERSION,
94
- ): Promise<Uint8Array> => {
95
- const params = kdfParamsFor(version);
96
- const hash = await argon2id({
97
- password: secret,
98
- salt: saltBytes,
99
- parallelism: params.parallelism,
100
- iterations: params.iterations,
101
- memorySize: params.memorySize,
102
- hashLength: params.hashLength,
103
- outputType: "binary",
104
- });
105
- return hash;
106
- };
71
+ export declare const deriveWrapKey: (secret: string, saltBytes: Uint8Array, version?: TKdfVersion) => Promise<Uint8Array>;
@@ -0,0 +1,82 @@
1
+ import { argon2id } from "hash-wasm";
2
+ /**
3
+ * Every set of Argon2id parameters this build knows how to derive with,
4
+ * keyed by the version stamped into the blob that was wrapped with them.
5
+ *
6
+ * READ THIS BEFORE TOUCHING A PARAMETER. Changing any value changes the
7
+ * derived `wrap_key`, which makes every AES-GCM auth tag produced under the
8
+ * old value fail. Because the design is zero-knowledge there is no
9
+ * server-side escape hatch: editing a row here in place would ship as an
10
+ * instant, PERMANENT lock-out of every existing vault — the correct recovery
11
+ * phrase included — and every provider credential in them.
12
+ *
13
+ * So parameters are append-only. To re-tune:
14
+ *
15
+ * 1. add a NEW version key with the new numbers, leaving every existing
16
+ * entry byte-identical forever;
17
+ * 2. bump {@link CURRENT_KDF_VERSION} so fresh wraps use it;
18
+ * 3. leave the old entries in place — they are the only way the blobs
19
+ * already on disk can ever be opened again.
20
+ *
21
+ * Version 1 is the original, and is also what an UNSTAMPED blob means: every
22
+ * blob written before stamping existed was produced with exactly these
23
+ * numbers. See `./wrapped.ts` for the on-disk encoding.
24
+ *
25
+ * v1 — conservative-but-tolerable on mobile browsers in 2026:
26
+ * memorySize 64 MiB — high enough to make GPU attacks expensive
27
+ * iterations 3 — recommended baseline
28
+ * parallelism 1 — single-thread to keep WASM portable
29
+ * hashLength 32 bytes — direct AES-GCM key
30
+ */
31
+ export const KDF_PARAMS_BY_VERSION = {
32
+ 1: {
33
+ parallelism: 1,
34
+ iterations: 3,
35
+ memorySize: 64 * 1024,
36
+ hashLength: 32,
37
+ },
38
+ };
39
+ /** The version fresh wraps are produced under. */
40
+ export const CURRENT_KDF_VERSION = 1;
41
+ /**
42
+ * The version an unstamped blob is from. Not a guess — stamping was
43
+ * introduced alongside version 2's *possibility*, so everything unstamped
44
+ * predates it and was necessarily derived with v1 parameters.
45
+ */
46
+ export const LEGACY_KDF_VERSION = 1;
47
+ export const isKdfVersion = (n) => Object.hasOwn(KDF_PARAMS_BY_VERSION, n);
48
+ /**
49
+ * Narrow a declared version to one this build can derive, or fail loudly.
50
+ *
51
+ * A blob stamped with a version this build doesn't carry means the browser is
52
+ * older than the vault — an app-update problem with a clear answer, not the
53
+ * silent "wrong password" an unknown-params derivation would masquerade as.
54
+ */
55
+ export const requireKdfVersion = (version) => {
56
+ if (!isKdfVersion(version)) {
57
+ throw new Error(`vault blob was wrapped with unknown KDF version ${version} — this build is too old to open it`);
58
+ }
59
+ return version;
60
+ };
61
+ export const kdfParamsFor = (version) => KDF_PARAMS_BY_VERSION[requireKdfVersion(version)];
62
+ /**
63
+ * Derive a 32-byte wrap key from a secret (recovery phrase or PIN) and a salt.
64
+ *
65
+ * `version` MUST be the version the blob being opened declares — never
66
+ * "whatever is current". Passing the current version to an old blob is the
67
+ * brick this module exists to prevent. Lazy-loaded WASM (~50 KB); the first
68
+ * call pays the cold start.
69
+ */
70
+ export const deriveWrapKey = async (secret, saltBytes, version = CURRENT_KDF_VERSION) => {
71
+ const params = kdfParamsFor(version);
72
+ const hash = await argon2id({
73
+ password: secret,
74
+ salt: saltBytes,
75
+ parallelism: params.parallelism,
76
+ iterations: params.iterations,
77
+ memorySize: params.memorySize,
78
+ hashLength: params.hashLength,
79
+ outputType: "binary",
80
+ });
81
+ return hash;
82
+ };
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Seal an ordinary `sk-llm` API key to a CLI caller's ephemeral X25519
3
+ * public key during OpenLLM CLI OAuth login handover
4
+ * (`docs/plan/2026-11-01-cli-install-onboarding.md` §2).
5
+ *
6
+ * Same envelope shape as the connector seal, but a distinct domain and AAD
7
+ * so connector and CLI ciphertext are not interchangeable. The server is a
8
+ * mailbox: it stores only the JSON envelope.
9
+ */
10
+ import type { TX25519Keypair } from "./handoff.js";
11
+ import { generateResumableX25519Keypair, generateX25519Keypair, importX25519PrivateKey } from "./handoff.js";
12
+ export declare const CLI_AUTH_SEAL_DOMAIN = "openllm-cli-auth-seal-v1";
13
+ export type TCliAuthSealBinding = {
14
+ readonly userId: string;
15
+ readonly authorizationId: string;
16
+ /** Recipient (CLI) X25519 public key, base64 SPKI DER. */
17
+ readonly recipientPublicKeyB64: string;
18
+ };
19
+ export type TCliAuthSealed = {
20
+ readonly v: 1;
21
+ readonly epk: string;
22
+ readonly nonce: string;
23
+ readonly ct: string;
24
+ };
25
+ /** Caller retains ownership of plaintext; the temporary copy is wiped. */
26
+ export declare const sealCliAuth: (binding: TCliAuthSealBinding, plaintext: Uint8Array) => Promise<TCliAuthSealed>;
27
+ /** Caller owns the returned plaintext and must wipe it when finished. */
28
+ export declare const openCliAuth: (binding: TCliAuthSealBinding, sealed: TCliAuthSealed, privateKey: CryptoKey) => Promise<Uint8Array>;
29
+ /** Alias kept for CLI call-site parity with the old `cli-auth-crypto` names. */
30
+ export declare const generateCliAuthKeypair: typeof generateX25519Keypair;
31
+ /** Alias kept for CLI call-site parity with the old `cli-auth-crypto` names. */
32
+ export declare const openCliAuthSealed: typeof openCliAuth;
33
+ export declare const importCliAuthPrivateKey: typeof importX25519PrivateKey;
34
+ export declare const generateResumableCliAuthKeypair: typeof generateResumableX25519Keypair;
35
+ export type TCliAuthKeypair = TX25519Keypair;
@@ -0,0 +1,78 @@
1
+ /**
2
+ * Seal an ordinary `sk-llm` API key to a CLI caller's ephemeral X25519
3
+ * public key during OpenLLM CLI OAuth login handover
4
+ * (`docs/plan/2026-11-01-cli-install-onboarding.md` §2).
5
+ *
6
+ * Same envelope shape as the connector seal, but a distinct domain and AAD
7
+ * so connector and CLI ciphertext are not interchangeable. The server is a
8
+ * mailbox: it stores only the JSON envelope.
9
+ */
10
+ import { aesGcmDecrypt, aesGcmEncrypt, fromB64, hkdfSha256, randomBytes, toB64, zero, } from "./crypto.js";
11
+ import { generateResumableX25519Keypair, generateX25519Keypair, importX25519PrivateKey, } from "./handoff.js";
12
+ export const CLI_AUTH_SEAL_DOMAIN = "openllm-cli-auth-seal-v1";
13
+ const aad = (binding) => new TextEncoder().encode(JSON.stringify([
14
+ CLI_AUTH_SEAL_DOMAIN,
15
+ binding.userId,
16
+ binding.authorizationId,
17
+ binding.recipientPublicKeyB64,
18
+ ]));
19
+ const decode = (value) => {
20
+ if (typeof value !== "string" ||
21
+ !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value))
22
+ throw new Error("Invalid sealed envelope encoding");
23
+ const bytes = fromB64(value);
24
+ if (toB64(bytes) !== value)
25
+ throw new Error("Invalid sealed envelope encoding");
26
+ return bytes;
27
+ };
28
+ const deriveKey = async (privateKey, peerB64, epk, recipient) => {
29
+ const peer = await crypto.subtle.importKey("spki", decode(peerB64), { name: "X25519" }, false, []);
30
+ const shared = new Uint8Array(await crypto.subtle.deriveBits({ name: "X25519", public: peer }, privateKey, 256));
31
+ try {
32
+ return await hkdfSha256(shared, new Uint8Array(0), JSON.stringify([CLI_AUTH_SEAL_DOMAIN, epk, recipient]), 32);
33
+ }
34
+ finally {
35
+ zero(shared);
36
+ }
37
+ };
38
+ /** Caller retains ownership of plaintext; the temporary copy is wiped. */
39
+ export const sealCliAuth = async (binding, plaintext) => {
40
+ const eph = await generateX25519Keypair();
41
+ const key = await deriveKey(eph.privateKey, binding.recipientPublicKeyB64, eph.publicKeyB64, binding.recipientPublicKeyB64);
42
+ const copy = new Uint8Array(plaintext);
43
+ try {
44
+ const nonce = randomBytes(12);
45
+ return {
46
+ v: 1,
47
+ epk: eph.publicKeyB64,
48
+ nonce: toB64(nonce),
49
+ ct: toB64(await aesGcmEncrypt(key, nonce, copy, aad(binding))),
50
+ };
51
+ }
52
+ finally {
53
+ zero(key);
54
+ zero(copy);
55
+ }
56
+ };
57
+ /** Caller owns the returned plaintext and must wipe it when finished. */
58
+ export const openCliAuth = async (binding, sealed, privateKey) => {
59
+ if (typeof sealed !== "object" || sealed === null || sealed.v !== 1)
60
+ throw new Error("Invalid sealed envelope");
61
+ const nonce = decode(sealed.nonce);
62
+ const ct = decode(sealed.ct);
63
+ if (nonce.length !== 12 || ct.length < 16 || typeof sealed.epk !== "string")
64
+ throw new Error("Invalid sealed envelope");
65
+ const key = await deriveKey(privateKey, sealed.epk, sealed.epk, binding.recipientPublicKeyB64);
66
+ try {
67
+ return await aesGcmDecrypt(key, nonce, ct, aad(binding));
68
+ }
69
+ finally {
70
+ zero(key);
71
+ }
72
+ };
73
+ /** Alias kept for CLI call-site parity with the old `cli-auth-crypto` names. */
74
+ export const generateCliAuthKeypair = generateX25519Keypair;
75
+ /** Alias kept for CLI call-site parity with the old `cli-auth-crypto` names. */
76
+ export const openCliAuthSealed = openCliAuth;
77
+ export const importCliAuthPrivateKey = importX25519PrivateKey;
78
+ export const generateResumableCliAuthKeypair = generateResumableX25519Keypair;
@@ -0,0 +1,18 @@
1
+ import type { TX25519Keypair } from "./handoff.js";
2
+ import { generateX25519Keypair } from "./handoff.js";
3
+ export declare const CRED_SEAL_HKDF_INFO = "openllm-cred-seal-v1";
4
+ /** Ephemeral X25519 pair used as an RTC answer seal recipient. */
5
+ export type TEphKeypair = TX25519Keypair;
6
+ export declare const generateEphKeypair: typeof generateX25519Keypair;
7
+ /** Seal `plaintext` to a recipient's X25519 public key (SPKI DER, base64). */
8
+ export declare const sealToDaemon: (recipientPubB64SpkiDer: string, plaintext: string) => Promise<string>;
9
+ /**
10
+ * Open a cred-seal blob with any X25519 private key (daemon identity or eph).
11
+ * Null on any failure.
12
+ */
13
+ export declare const openCredSealed: (sealedB64: string, privateKey: CryptoKey) => Promise<string | null>;
14
+ /**
15
+ * Open a sealed blob with an in-memory ephemeral private key (RTC answer path).
16
+ * Alias of {@link openCredSealed}.
17
+ */
18
+ export declare const openSealedFromEph: (sealedB64: string, ephPrivateKey: CryptoKey) => Promise<string | null>;
@@ -0,0 +1,86 @@
1
+ /**
2
+ * X25519 sealed-box for daemon credentials (browser ↔ daemon).
3
+ *
4
+ * Wire: `base64(JSON{ epk, iv, ct })` where `epk` is the ephemeral X25519
5
+ * public key (SPKI DER, base64), `iv` is a 12-byte AES-GCM nonce, and `ct` is
6
+ * ciphertext‖tag. Scheme: ephemeral X25519 → ECDH → HKDF-SHA256(salt = ∅,
7
+ * info = "openllm-cred-seal-v1", 32 bytes) → AES-256-GCM.
8
+ *
9
+ * Byte-identical with the historical `lib/daemon-seal.ts` /
10
+ * `packages/cli/daemon/src/keypair.ts` sealed-box so cloud-relayed blobs stay
11
+ * interoperable.
12
+ */
13
+ import { aesGcmDecrypt, aesGcmEncrypt, fromB64, hkdfSha256, randomBytes, toB64, zero, } from "./crypto.js";
14
+ import { generateX25519Keypair } from "./handoff.js";
15
+ export const CRED_SEAL_HKDF_INFO = "openllm-cred-seal-v1";
16
+ export const generateEphKeypair = generateX25519Keypair;
17
+ const deriveCredKey = async (privateKey, peerSpkiB64) => {
18
+ const peer = await crypto.subtle.importKey("spki", fromB64(peerSpkiB64), { name: "X25519" }, false, []);
19
+ const shared = new Uint8Array(await crypto.subtle.deriveBits({ name: "X25519", public: peer }, privateKey, 256));
20
+ try {
21
+ return await hkdfSha256(shared, new Uint8Array(0), CRED_SEAL_HKDF_INFO, 32);
22
+ }
23
+ finally {
24
+ zero(shared);
25
+ }
26
+ };
27
+ /** Seal `plaintext` to a recipient's X25519 public key (SPKI DER, base64). */
28
+ export const sealToDaemon = async (recipientPubB64SpkiDer, plaintext) => {
29
+ const subtle = globalThis.crypto.subtle;
30
+ const recipient = await subtle.importKey("spki", fromB64(recipientPubB64SpkiDer), { name: "X25519" }, false, []);
31
+ // Ephemeral keypair — extractable so we can publish its public key as `epk`.
32
+ const eph = (await subtle.generateKey({ name: "X25519" }, true, [
33
+ "deriveBits",
34
+ ]));
35
+ const shared = new Uint8Array(await subtle.deriveBits({ name: "X25519", public: recipient }, eph.privateKey, 256));
36
+ let key;
37
+ try {
38
+ key = await hkdfSha256(shared, new Uint8Array(0), CRED_SEAL_HKDF_INFO, 32);
39
+ }
40
+ finally {
41
+ zero(shared);
42
+ }
43
+ try {
44
+ const iv = randomBytes(12);
45
+ const ct = await aesGcmEncrypt(key, iv, new TextEncoder().encode(plaintext));
46
+ const epk = new Uint8Array(await subtle.exportKey("spki", eph.publicKey));
47
+ const packed = { epk: toB64(epk), iv: toB64(iv), ct: toB64(ct) };
48
+ return toB64(new TextEncoder().encode(JSON.stringify(packed)));
49
+ }
50
+ finally {
51
+ zero(key);
52
+ }
53
+ };
54
+ /**
55
+ * Open a cred-seal blob with any X25519 private key (daemon identity or eph).
56
+ * Null on any failure.
57
+ */
58
+ export const openCredSealed = async (sealedB64, privateKey) => {
59
+ try {
60
+ const packed = JSON.parse(new TextDecoder().decode(fromB64(sealedB64)));
61
+ if (packed === null || typeof packed !== "object")
62
+ return null;
63
+ const { epk, iv, ct } = packed;
64
+ if (typeof epk !== "string" ||
65
+ typeof iv !== "string" ||
66
+ typeof ct !== "string") {
67
+ return null;
68
+ }
69
+ const key = await deriveCredKey(privateKey, epk);
70
+ try {
71
+ const plain = await aesGcmDecrypt(key, fromB64(iv), fromB64(ct));
72
+ return new TextDecoder().decode(plain);
73
+ }
74
+ finally {
75
+ zero(key);
76
+ }
77
+ }
78
+ catch {
79
+ return null;
80
+ }
81
+ };
82
+ /**
83
+ * Open a sealed blob with an in-memory ephemeral private key (RTC answer path).
84
+ * Alias of {@link openCredSealed}.
85
+ */
86
+ export const openSealedFromEph = (sealedB64, ephPrivateKey) => openCredSealed(sealedB64, ephPrivateKey);
@@ -0,0 +1,21 @@
1
+ export type TEncryptedCredential = {
2
+ readonly ciphertext: string;
3
+ readonly nonce: string;
4
+ };
5
+ /**
6
+ * Encrypt a credential plaintext under the user's DEK (root key).
7
+ *
8
+ * @deprecated Seal vault data with {@link sealVaultText} /
9
+ * {@link sealVaultBytes} from `./vault-item` under the matching branch
10
+ * (`credentials`, `memory`, `chats`, `apps`, `keys`, `teams`). Kept for
11
+ * legacy-path tests and the one-week read sunset of untagged rows.
12
+ */
13
+ export declare const encryptCredential: (dek: Uint8Array, plaintext: string) => Promise<TEncryptedCredential>;
14
+ /**
15
+ * Decrypt a credential row sealed directly under the DEK.
16
+ *
17
+ * @deprecated Open vault data with {@link openVaultText} /
18
+ * {@link openVaultBytes} from `./vault-item` (handles both tree-tagged
19
+ * and legacy untagged items). Kept for legacy-path tests.
20
+ */
21
+ export declare const decryptCredential: (dek: Uint8Array, ciphertextB64: string, nonceB64: string) => Promise<string>;
@@ -0,0 +1,26 @@
1
+ import { aesGcmDecrypt, aesGcmEncrypt, fromB64, randomBytes, toB64, } from "./crypto.js";
2
+ const NONCE_BYTES = 12;
3
+ /**
4
+ * Encrypt a credential plaintext under the user's DEK (root key).
5
+ *
6
+ * @deprecated Seal vault data with {@link sealVaultText} /
7
+ * {@link sealVaultBytes} from `./vault-item` under the matching branch
8
+ * (`credentials`, `memory`, `chats`, `apps`, `keys`, `teams`). Kept for
9
+ * legacy-path tests and the one-week read sunset of untagged rows.
10
+ */
11
+ export const encryptCredential = async (dek, plaintext) => {
12
+ const nonce = randomBytes(NONCE_BYTES);
13
+ const ct = await aesGcmEncrypt(dek, nonce, new TextEncoder().encode(plaintext));
14
+ return { ciphertext: toB64(ct), nonce: toB64(nonce) };
15
+ };
16
+ /**
17
+ * Decrypt a credential row sealed directly under the DEK.
18
+ *
19
+ * @deprecated Open vault data with {@link openVaultText} /
20
+ * {@link openVaultBytes} from `./vault-item` (handles both tree-tagged
21
+ * and legacy untagged items). Kept for legacy-path tests.
22
+ */
23
+ export const decryptCredential = async (dek, ciphertextB64, nonceB64) => {
24
+ const pt = await aesGcmDecrypt(dek, fromB64(nonceB64), fromB64(ciphertextB64));
25
+ return new TextDecoder().decode(pt);
26
+ };
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Pure WebCrypto primitives shared by every vault flow. Runs in any
3
+ * runtime that exposes `globalThis.crypto.subtle` — browser, Node 24+,
4
+ * Edge, Bun. Nothing in this file is server- or browser-specific;
5
+ * everything is bytes-in/bytes-out.
6
+ *
7
+ * Wire / on-disk encoding is base64 (`toB64` / `fromB64`) — keeps the
8
+ * existing text-column infrastructure (drizzle, neon HTTP driver,
9
+ * migrations) carrying the blobs without a bytea customType.
10
+ */
11
+ export declare const randomBytes: (length: number) => Uint8Array;
12
+ export declare const toB64: (bytes: Uint8Array) => string;
13
+ export declare const fromB64: (b64: string) => Uint8Array;
14
+ export declare const toB64Url: (bytes: Uint8Array) => string;
15
+ export declare const fromB64Url: (b64url: string) => Uint8Array;
16
+ /**
17
+ * AES-256-GCM encrypt. `nonce` MUST be 12 bytes. The auth tag is
18
+ * appended to the ciphertext by WebCrypto — `aesGcmDecrypt` expects
19
+ * the same shape. Reusing a (key, nonce) pair across two encrypts
20
+ * is a critical failure; callers must pass `randomBytes(12)` fresh
21
+ * each call.
22
+ *
23
+ * `additionalData` (optional AAD) is authenticated but not encrypted:
24
+ * the ciphertext only opens under the exact same bytes. Used to bind a
25
+ * blob to the public facts it is filed under (see `./passkey.ts`).
26
+ */
27
+ export declare const aesGcmEncrypt: (key: Uint8Array, nonce: Uint8Array, plaintext: Uint8Array, additionalData?: Uint8Array) => Promise<Uint8Array>;
28
+ export declare const aesGcmDecrypt: (key: Uint8Array, nonce: Uint8Array, ciphertext: Uint8Array, additionalData?: Uint8Array) => Promise<Uint8Array>;
29
+ /**
30
+ * HKDF-SHA256. Used to derive `api_wrap_key` from a 32-byte
31
+ * `api_key_secret` plus the public `api_key_id` as salt. Input is
32
+ * already high-entropy so HKDF (not Argon2) is the correct choice.
33
+ */
34
+ export declare const hkdfSha256: (ikm: Uint8Array, salt: Uint8Array, info: string, bytes: number) => Promise<Uint8Array>;
35
+ /**
36
+ * Best-effort overwrite of sensitive bytes. JS engines may have
37
+ * already copied the buffer elsewhere; this is hygiene, not a
38
+ * guarantee. Pair with `finally{}` blocks at the end of any function
39
+ * that touches a DEK or plaintext credential.
40
+ */
41
+ export declare const zero: (bytes: Uint8Array) => void;
42
+ /**
43
+ * A uniform integer in `[0, max)` from the CSPRNG.
44
+ *
45
+ * Rejection-sampled rather than `% max`, which skews toward the low end when
46
+ * `max` doesn't divide 2^32. Used where `Math.random()` would do the job but
47
+ * shouldn't be within reach of anything cryptographic — a UI helper that
48
+ * migrates into key material later is a real way to end up with a predictable
49
+ * secret, and the cost of never having that conversation is one function.
50
+ */
51
+ export declare const randomInt: (max: number) => number;
@@ -0,0 +1,156 @@
1
+ /**
2
+ * Pure WebCrypto primitives shared by every vault flow. Runs in any
3
+ * runtime that exposes `globalThis.crypto.subtle` — browser, Node 24+,
4
+ * Edge, Bun. Nothing in this file is server- or browser-specific;
5
+ * everything is bytes-in/bytes-out.
6
+ *
7
+ * Wire / on-disk encoding is base64 (`toB64` / `fromB64`) — keeps the
8
+ * existing text-column infrastructure (drizzle, neon HTTP driver,
9
+ * migrations) carrying the blobs without a bytea customType.
10
+ */
11
+ const subtle = () => {
12
+ const s = globalThis.crypto?.subtle;
13
+ if (s === undefined) {
14
+ throw new Error("WebCrypto SubtleCrypto is not available in this runtime");
15
+ }
16
+ return s;
17
+ };
18
+ export const randomBytes = (length) => {
19
+ return globalThis.crypto.getRandomValues(new Uint8Array(length));
20
+ };
21
+ export const toB64 = (bytes) => {
22
+ let bin = "";
23
+ for (let i = 0; i < bytes.length; i++) {
24
+ bin += String.fromCharCode(bytes[i]);
25
+ }
26
+ return btoa(bin);
27
+ };
28
+ export const fromB64 = (b64) => {
29
+ const bin = atob(b64);
30
+ const out = new Uint8Array(bin.length);
31
+ for (let i = 0; i < bin.length; i++)
32
+ out[i] = bin.charCodeAt(i);
33
+ return out;
34
+ };
35
+ export const toB64Url = (bytes) => {
36
+ return toB64(bytes)
37
+ .replace(/\+/g, "-")
38
+ .replace(/\//g, "_")
39
+ .replace(/=+$/, "");
40
+ };
41
+ export const fromB64Url = (b64url) => {
42
+ const pad = b64url.length % 4 === 0 ? "" : "=".repeat(4 - (b64url.length % 4));
43
+ return fromB64(b64url.replace(/-/g, "+").replace(/_/g, "/") + pad);
44
+ };
45
+ /**
46
+ * A standalone copy of a view's bytes — what `importKey`/`deriveBits` need,
47
+ * since a `Uint8Array` may be a window onto a larger buffer.
48
+ *
49
+ * Returned as a `Uint8Array` rather than a bare `ArrayBuffer` so the caller
50
+ * can `zero()` it. Every caller here does: the copy holds the same key
51
+ * material as its source, and a source that is faithfully zeroed while an
52
+ * unzeroed duplicate lingers is the hygiene contract at the bottom of this
53
+ * file quietly not being kept.
54
+ */
55
+ const copyOf = (bytes) => new Uint8Array(bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength));
56
+ const importAesGcmKey = async (keyBytes) => {
57
+ // WebCrypto copies key data into the CryptoKey during import, so wiping our
58
+ // copy afterwards leaves the key usable and the bytes gone.
59
+ const copy = copyOf(keyBytes);
60
+ try {
61
+ return await subtle().importKey("raw", copy, "AES-GCM", false, ["encrypt", "decrypt"]);
62
+ }
63
+ finally {
64
+ zero(copy);
65
+ }
66
+ };
67
+ const gcmParams = (nonce, additionalData) => additionalData === undefined
68
+ ? { name: "AES-GCM", iv: nonce }
69
+ : {
70
+ name: "AES-GCM",
71
+ iv: nonce,
72
+ additionalData: additionalData,
73
+ };
74
+ /**
75
+ * AES-256-GCM encrypt. `nonce` MUST be 12 bytes. The auth tag is
76
+ * appended to the ciphertext by WebCrypto — `aesGcmDecrypt` expects
77
+ * the same shape. Reusing a (key, nonce) pair across two encrypts
78
+ * is a critical failure; callers must pass `randomBytes(12)` fresh
79
+ * each call.
80
+ *
81
+ * `additionalData` (optional AAD) is authenticated but not encrypted:
82
+ * the ciphertext only opens under the exact same bytes. Used to bind a
83
+ * blob to the public facts it is filed under (see `./passkey.ts`).
84
+ */
85
+ export const aesGcmEncrypt = async (key, nonce, plaintext, additionalData) => {
86
+ if (key.length !== 32)
87
+ throw new Error("AES-GCM key must be 32 bytes");
88
+ if (nonce.length !== 12)
89
+ throw new Error("AES-GCM nonce must be 12 bytes");
90
+ const cryptoKey = await importAesGcmKey(key);
91
+ const ct = await subtle().encrypt(gcmParams(nonce, additionalData), cryptoKey, plaintext);
92
+ return new Uint8Array(ct);
93
+ };
94
+ export const aesGcmDecrypt = async (key, nonce, ciphertext, additionalData) => {
95
+ if (key.length !== 32)
96
+ throw new Error("AES-GCM key must be 32 bytes");
97
+ if (nonce.length !== 12)
98
+ throw new Error("AES-GCM nonce must be 12 bytes");
99
+ const cryptoKey = await importAesGcmKey(key);
100
+ const pt = await subtle().decrypt(gcmParams(nonce, additionalData), cryptoKey, ciphertext);
101
+ return new Uint8Array(pt);
102
+ };
103
+ /**
104
+ * HKDF-SHA256. Used to derive `api_wrap_key` from a 32-byte
105
+ * `api_key_secret` plus the public `api_key_id` as salt. Input is
106
+ * already high-entropy so HKDF (not Argon2) is the correct choice.
107
+ */
108
+ export const hkdfSha256 = async (ikm, salt, info, bytes) => {
109
+ const ikmCopy = copyOf(ikm);
110
+ let key;
111
+ try {
112
+ key = await subtle().importKey("raw", ikmCopy, "HKDF", false, ["deriveBits"]);
113
+ }
114
+ finally {
115
+ zero(ikmCopy);
116
+ }
117
+ // The salt is public (it's the api_key_id), so its copy needs no wipe.
118
+ const out = await subtle().deriveBits({
119
+ name: "HKDF",
120
+ hash: "SHA-256",
121
+ salt: copyOf(salt),
122
+ info: new TextEncoder().encode(info),
123
+ }, key, bytes * 8);
124
+ return new Uint8Array(out);
125
+ };
126
+ /**
127
+ * Best-effort overwrite of sensitive bytes. JS engines may have
128
+ * already copied the buffer elsewhere; this is hygiene, not a
129
+ * guarantee. Pair with `finally{}` blocks at the end of any function
130
+ * that touches a DEK or plaintext credential.
131
+ */
132
+ export const zero = (bytes) => {
133
+ bytes.fill(0);
134
+ };
135
+ /**
136
+ * A uniform integer in `[0, max)` from the CSPRNG.
137
+ *
138
+ * Rejection-sampled rather than `% max`, which skews toward the low end when
139
+ * `max` doesn't divide 2^32. Used where `Math.random()` would do the job but
140
+ * shouldn't be within reach of anything cryptographic — a UI helper that
141
+ * migrates into key material later is a real way to end up with a predictable
142
+ * secret, and the cost of never having that conversation is one function.
143
+ */
144
+ export const randomInt = (max) => {
145
+ if (!Number.isInteger(max) || max <= 0) {
146
+ throw new Error("randomInt: max must be a positive integer");
147
+ }
148
+ const limit = Math.floor(0x1_0000_0000 / max) * max;
149
+ const buf = new Uint32Array(1);
150
+ let n;
151
+ do {
152
+ globalThis.crypto.getRandomValues(buf);
153
+ n = buf[0];
154
+ } while (n >= limit);
155
+ return n % max;
156
+ };