@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,151 @@
1
+ /**
2
+ * The P1 mux wire codec. This module is dependency-free by design so the
3
+ * relay can validate and forward a frame without learning its payload shape.
4
+ */
5
+ export const FRAME_HEADER_BYTES = 9;
6
+ export const MAX_PAYLOAD_BYTES = 256 * 1024;
7
+ /**
8
+ * Implicit per-stream credit at OPEN on every peer. Frozen for skew-safety —
9
+ * never raise this unilaterally. Newer peers advertise extra credit with an
10
+ * immediate WINDOW after OPEN ({@link STREAM_WINDOW_BOOST_BYTES}).
11
+ */
12
+ export const INITIAL_STREAM_WINDOW_BYTES = 256 * 1024;
13
+ /**
14
+ * Extra receive credit granted right after OPEN via a WINDOW frame. Old peers
15
+ * accept the WINDOW (additive sendCredit); new peers start receiveCredit at
16
+ * {@link TARGET_STREAM_WINDOW_BYTES}. Total target window = initial + boost.
17
+ */
18
+ export const STREAM_WINDOW_BOOST_BYTES = 768 * 1024;
19
+ /** Effective receive window on peers that send the post-OPEN boost. */
20
+ export const TARGET_STREAM_WINDOW_BYTES = INITIAL_STREAM_WINDOW_BYTES + STREAM_WINDOW_BOOST_BYTES;
21
+ /**
22
+ * Emit WINDOW once this many bytes have been consumed since the last grant.
23
+ * Lower than half the initial window so high-RTT paths replenish sooner.
24
+ */
25
+ export const WINDOW_REPLENISH_THRESHOLD = 64 * 1024;
26
+ export const STREAM_ID_CTRL = 0;
27
+ export const MAX_STREAM_ID = 0xffff_ffff;
28
+ export const FRAME_TYPE = {
29
+ open: 0x01,
30
+ data: 0x02,
31
+ end: 0x03,
32
+ reset: 0x04,
33
+ window: 0x05,
34
+ ctrl: 0x06,
35
+ };
36
+ const encoder = new TextEncoder();
37
+ const decoder = new TextDecoder();
38
+ export const isKnownFrameType = (value) => value === FRAME_TYPE.open ||
39
+ value === FRAME_TYPE.data ||
40
+ value === FRAME_TYPE.end ||
41
+ value === FRAME_TYPE.reset ||
42
+ value === FRAME_TYPE.window ||
43
+ value === FRAME_TYPE.ctrl;
44
+ export const isConsumerStreamId = (streamId) => Number.isInteger(streamId) &&
45
+ streamId > 0 &&
46
+ streamId <= MAX_STREAM_ID &&
47
+ streamId % 2 === 1;
48
+ const isUint32 = (value) => Number.isInteger(value) && value >= 0 && value <= MAX_STREAM_ID;
49
+ /** Return the fixed header without allocating a payload view. */
50
+ export const peekFrameHeader = (bytes) => {
51
+ if (bytes.byteLength < FRAME_HEADER_BYTES)
52
+ return null;
53
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
54
+ return {
55
+ type: bytes[0],
56
+ streamId: view.getUint32(1, false),
57
+ length: view.getUint32(5, false),
58
+ };
59
+ };
60
+ /** Encode one whole WebSocket message. Caller contract violations throw RangeError. */
61
+ export const encodeFrame = (frame) => {
62
+ if (!isKnownFrameType(frame.type))
63
+ throw new RangeError("unknown frame type");
64
+ if (!isUint32(frame.streamId))
65
+ throw new RangeError("stream id must be a u32");
66
+ if (frame.payload.byteLength > MAX_PAYLOAD_BYTES) {
67
+ throw new RangeError("payload exceeds MAX_PAYLOAD_BYTES");
68
+ }
69
+ const encoded = new Uint8Array(FRAME_HEADER_BYTES + frame.payload.byteLength);
70
+ const view = new DataView(encoded.buffer, encoded.byteOffset, encoded.byteLength);
71
+ encoded[0] = frame.type;
72
+ view.setUint32(1, frame.streamId, false);
73
+ view.setUint32(5, frame.payload.byteLength, false);
74
+ encoded.set(frame.payload, FRAME_HEADER_BYTES);
75
+ return encoded;
76
+ };
77
+ /**
78
+ * Cheap mux-frame shape check (header type / length / payload cap) without
79
+ * allocating a {@link TFrame}. Used by the blind relay forward path.
80
+ */
81
+ export const isValidMuxFrame = (bytes) => {
82
+ const header = peekFrameHeader(bytes);
83
+ if (header === null)
84
+ return false;
85
+ if (!isKnownFrameType(header.type))
86
+ return false;
87
+ if (header.length > MAX_PAYLOAD_BYTES)
88
+ return false;
89
+ return header.length === bytes.byteLength - FRAME_HEADER_BYTES;
90
+ };
91
+ /** Decode one whole message. Never throws and never allocates from a claimed length. */
92
+ export const decodeFrame = (bytes) => {
93
+ const header = peekFrameHeader(bytes);
94
+ if (header === null)
95
+ return { ok: false, error: "truncated_header" };
96
+ if (!isKnownFrameType(header.type)) {
97
+ return { ok: false, error: "unknown_frame_type" };
98
+ }
99
+ if (header.length > MAX_PAYLOAD_BYTES) {
100
+ return { ok: false, error: "payload_too_large" };
101
+ }
102
+ if (header.length !== bytes.byteLength - FRAME_HEADER_BYTES) {
103
+ return { ok: false, error: "length_mismatch" };
104
+ }
105
+ return {
106
+ ok: true,
107
+ frame: {
108
+ type: header.type,
109
+ streamId: header.streamId,
110
+ payload: bytes.subarray(FRAME_HEADER_BYTES),
111
+ },
112
+ };
113
+ };
114
+ export const windowPayload = (delta) => {
115
+ if (!isUint32(delta))
116
+ throw new RangeError("window delta must be a u32");
117
+ const payload = new Uint8Array(4);
118
+ new DataView(payload.buffer).setUint32(0, delta, false);
119
+ return payload;
120
+ };
121
+ export const decodeWindowPayload = (payload) => {
122
+ if (payload.byteLength !== 4)
123
+ return null;
124
+ return new DataView(payload.buffer, payload.byteOffset, payload.byteLength).getUint32(0, false);
125
+ };
126
+ export const encodeJsonPayload = (value) => {
127
+ let text;
128
+ try {
129
+ text = JSON.stringify(value);
130
+ }
131
+ catch {
132
+ throw new RangeError("value is not JSON serializable");
133
+ }
134
+ if (text === undefined)
135
+ throw new RangeError("value is not JSON serializable");
136
+ const payload = encoder.encode(text);
137
+ if (payload.byteLength > MAX_PAYLOAD_BYTES) {
138
+ throw new RangeError("JSON payload exceeds MAX_PAYLOAD_BYTES");
139
+ }
140
+ return payload;
141
+ };
142
+ export const decodeJsonPayload = (payload) => {
143
+ if (payload.byteLength > MAX_PAYLOAD_BYTES)
144
+ return undefined;
145
+ try {
146
+ return JSON.parse(decoder.decode(payload));
147
+ }
148
+ catch {
149
+ return undefined;
150
+ }
151
+ };
@@ -0,0 +1,62 @@
1
+ /** HKDF info for the per-key pair secret. */
2
+ export declare const DEVICE_PAIR_HKDF_INFO = "openllm-pair-v1";
3
+ /** Raw bytes in an anchor: control pubkey (32) || pair secret (32). */
4
+ export declare const DEVICE_ANCHOR_BYTES = 64;
5
+ export declare const DEVICE_ANCHOR_LENGTH = 86;
6
+ export declare const DEVICE_PAIR_SECRET_BYTES = 32;
7
+ /** Domain label of the dpk proof MAC input. */
8
+ export declare const DPK_PROOF_LABEL = "openllm-dpk-proof-v1";
9
+ /** base64url of a 32-byte HMAC-SHA256. */
10
+ export declare const DPK_PROOF_LENGTH = 43;
11
+ /** base64url, unpadded. */
12
+ export declare const toB64UrlBytes: (bytes: Uint8Array) => string;
13
+ /** Strict unpadded base64url → bytes; null on any foreign character. */
14
+ export declare const fromB64UrlBytes: (value: string) => Uint8Array | null;
15
+ /** Ed25519 raw (32 bytes) → base64(SPKI DER), the form daemons pin. */
16
+ export declare const ed25519SpkiB64FromRaw: (raw: Uint8Array) => string;
17
+ export type TDeviceAnchor = {
18
+ /** The account control public key, base64(SPKI DER). */
19
+ readonly controlPubkey: string;
20
+ /** `HKDF(control seed, utf8(key_id), "openllm-pair-v1")`, 32 bytes. */
21
+ readonly pairSecret: Uint8Array;
22
+ };
23
+ /** `base64url(control raw || pair secret)`. */
24
+ export declare const encodeDeviceAnchor: (controlPubkeyRaw: Uint8Array, pairSecret: Uint8Array) => string;
25
+ /** Decode an anchor; null unless exactly 86 base64url chars of 64 bytes. */
26
+ export declare const decodeDeviceAnchor: (anchor: string) => TDeviceAnchor | null;
27
+ /**
28
+ * MAC input of the dpk proof:
29
+ * `utf8("openllm-dpk-proof-v1") || utf8(key_id) || utf8(dpk)` — plain
30
+ * concatenation, unambiguous because `key_id` is the fixed-length (14 char)
31
+ * api key id. `dpk` is the daemon's X25519 SPKI DER, base64 — exactly
32
+ * `DaemonStatus.pubkey`.
33
+ */
34
+ export declare const buildDpkProofMessage: (keyId: string, dpk: string) => Uint8Array;
35
+ /** True when `proof` has the shape of a dpk proof (43 base64url chars). */
36
+ export declare const isDpkProofSyntax: (proof: string) => boolean;
37
+ /** Domain label of the signed device-sessions disable. */
38
+ export declare const DEVICE_SESSIONS_DISABLE_LABEL = "openllm-device-sessions-disable-v1";
39
+ export declare const DEVICE_SESSIONS_DISABLE_VERSION: 1;
40
+ /** A disable older (or further in the future) than this is refused. */
41
+ export declare const DEVICE_SESSIONS_DISABLE_TS_WINDOW_MS: number;
42
+ export declare const DEVICE_SESSIONS_DISABLE_B64_MAX = 1024;
43
+ export type TDeviceSessionsDisableFields = {
44
+ readonly v: 1;
45
+ /** The target daemon's api key id — a command for another key is refused. */
46
+ readonly key_id: string;
47
+ /** ms since epoch; must be fresh. */
48
+ readonly ts: number;
49
+ /** 16 random bytes, base64url — makes every statement unique. */
50
+ readonly nonce: string;
51
+ };
52
+ export type TDeviceSessionsDisableEnvelope = TDeviceSessionsDisableFields & {
53
+ /** Ed25519 signature by the control key, base64. */
54
+ readonly sig: string;
55
+ };
56
+ /**
57
+ * Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`, fixed key
58
+ * order `v, key_id, ts, nonce`. Disable-only — there is no enable field.
59
+ */
60
+ export declare const buildDeviceSessionsDisableMessage: (fields: TDeviceSessionsDisableFields) => Uint8Array;
61
+ export declare const encodeDeviceSessionsDisable: (envelope: TDeviceSessionsDisableEnvelope) => string;
62
+ export declare const decodeDeviceSessionsDisable: (b64: string) => TDeviceSessionsDisableEnvelope | null;
@@ -0,0 +1,168 @@
1
+ /**
2
+ * Device trust anchor + daemon-key proof — the wire formats only. Bytes +
3
+ * JSON, no crypto: the browser computes with WebCrypto (`@openllmsh/sdk/vault`
4
+ * `device-anchor.ts`), the daemon with node:crypto
5
+ * (`packages/cli/daemon/src/device-anchor.ts`).
6
+ *
7
+ * - **Anchor** = base64url(control pubkey raw 32 || pair_secret 32), where
8
+ * `pair_secret = HKDF-SHA256(ikm = control seed, salt = utf8(key_id),
9
+ * info = "openllm-pair-v1", 32)`. It rides the install / setup command as a
10
+ * suffix of the API key (`sk-llm-<id>.<secret>.<anchor>`) and NEVER leaves
11
+ * the device: the daemon splits it off and keeps it in the runtime env file.
12
+ * - **dpk proof** = `HMAC-SHA256(pair_secret, "openllm-dpk-proof-v1" ||
13
+ * key_id || dpk)`, base64url. The daemon publishes it in its status; any browser
14
+ * holding the control seed recomputes `pair_secret` and verifies it, so the
15
+ * daemon's static X25519 key is trusted without a first-use window.
16
+ *
17
+ * Device sessions on == the anchor is present. Re-enable is install / update /
18
+ * login / desktop with the sessions toggle on. The only remote control is a
19
+ * signed **disable** (strips the anchor); a compromised cloud cannot forge it.
20
+ */
21
+ import { isOpenllmDeviceAnchorSyntax, OPENLLM_DEVICE_ANCHOR_LENGTH, } from "@openllmsh/sdk/protocol";
22
+ import { decodeB64Json, encodeB64Json, labelledMessage, toB64Bytes, } from "./wire-bytes.js";
23
+ /** HKDF info for the per-key pair secret. */
24
+ export const DEVICE_PAIR_HKDF_INFO = "openllm-pair-v1";
25
+ /** Raw bytes in an anchor: control pubkey (32) || pair secret (32). */
26
+ export const DEVICE_ANCHOR_BYTES = 64;
27
+ export const DEVICE_ANCHOR_LENGTH = OPENLLM_DEVICE_ANCHOR_LENGTH;
28
+ export const DEVICE_PAIR_SECRET_BYTES = 32;
29
+ const ED25519_RAW_BYTES = 32;
30
+ /** Domain label of the dpk proof MAC input. */
31
+ export const DPK_PROOF_LABEL = "openllm-dpk-proof-v1";
32
+ /** base64url of a 32-byte HMAC-SHA256. */
33
+ export const DPK_PROOF_LENGTH = 43;
34
+ /** DER SPKI prefix of an Ed25519 public key. */
35
+ const ED25519_SPKI_PREFIX = new Uint8Array([
36
+ 0x30, 0x2a, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x03, 0x21, 0x00,
37
+ ]);
38
+ const B64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
39
+ /** base64url, unpadded. */
40
+ export const toB64UrlBytes = (bytes) => toB64Bytes(bytes).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
41
+ /** Strict unpadded base64url → bytes; null on any foreign character. */
42
+ export const fromB64UrlBytes = (value) => {
43
+ for (const ch of value) {
44
+ if (!B64URL_ALPHABET.includes(ch))
45
+ return null;
46
+ }
47
+ if (value.length % 4 === 1)
48
+ return null;
49
+ const padded = value.replace(/-/g, "+").replace(/_/g, "/") +
50
+ "=".repeat((4 - (value.length % 4)) % 4);
51
+ try {
52
+ const bin = atob(padded);
53
+ const out = new Uint8Array(bin.length);
54
+ for (let i = 0; i < bin.length; i++)
55
+ out[i] = bin.charCodeAt(i);
56
+ return out;
57
+ }
58
+ catch {
59
+ return null;
60
+ }
61
+ };
62
+ /** Ed25519 raw (32 bytes) → base64(SPKI DER), the form daemons pin. */
63
+ export const ed25519SpkiB64FromRaw = (raw) => {
64
+ if (raw.length !== ED25519_RAW_BYTES) {
65
+ throw new RangeError("ed25519 raw public key must be 32 bytes");
66
+ }
67
+ const spki = new Uint8Array(ED25519_SPKI_PREFIX.length + raw.length);
68
+ spki.set(ED25519_SPKI_PREFIX, 0);
69
+ spki.set(raw, ED25519_SPKI_PREFIX.length);
70
+ return toB64Bytes(spki);
71
+ };
72
+ /** `base64url(control raw || pair secret)`. */
73
+ export const encodeDeviceAnchor = (controlPubkeyRaw, pairSecret) => {
74
+ if (controlPubkeyRaw.length !== ED25519_RAW_BYTES) {
75
+ throw new RangeError("anchor control key must be 32 raw bytes");
76
+ }
77
+ if (pairSecret.length !== DEVICE_PAIR_SECRET_BYTES) {
78
+ throw new RangeError("anchor pair secret must be 32 bytes");
79
+ }
80
+ const bytes = new Uint8Array(DEVICE_ANCHOR_BYTES);
81
+ bytes.set(controlPubkeyRaw, 0);
82
+ bytes.set(pairSecret, ED25519_RAW_BYTES);
83
+ return toB64UrlBytes(bytes);
84
+ };
85
+ /** Decode an anchor; null unless exactly 86 base64url chars of 64 bytes. */
86
+ export const decodeDeviceAnchor = (anchor) => {
87
+ if (!isOpenllmDeviceAnchorSyntax(anchor))
88
+ return null;
89
+ const bytes = fromB64UrlBytes(anchor);
90
+ if (bytes === null || bytes.length !== DEVICE_ANCHOR_BYTES)
91
+ return null;
92
+ return {
93
+ controlPubkey: ed25519SpkiB64FromRaw(bytes.slice(0, ED25519_RAW_BYTES)),
94
+ pairSecret: bytes.slice(ED25519_RAW_BYTES),
95
+ };
96
+ };
97
+ /**
98
+ * MAC input of the dpk proof:
99
+ * `utf8("openllm-dpk-proof-v1") || utf8(key_id) || utf8(dpk)` — plain
100
+ * concatenation, unambiguous because `key_id` is the fixed-length (14 char)
101
+ * api key id. `dpk` is the daemon's X25519 SPKI DER, base64 — exactly
102
+ * `DaemonStatus.pubkey`.
103
+ */
104
+ export const buildDpkProofMessage = (keyId, dpk) => {
105
+ const enc = new TextEncoder();
106
+ const label = enc.encode(DPK_PROOF_LABEL);
107
+ const kid = enc.encode(keyId);
108
+ const key = enc.encode(dpk);
109
+ const out = new Uint8Array(label.length + kid.length + key.length);
110
+ out.set(label, 0);
111
+ out.set(kid, label.length);
112
+ out.set(key, label.length + kid.length);
113
+ return out;
114
+ };
115
+ /** True when `proof` has the shape of a dpk proof (43 base64url chars). */
116
+ export const isDpkProofSyntax = (proof) => proof.length === DPK_PROOF_LENGTH && fromB64UrlBytes(proof)?.length === 32;
117
+ /** Domain label of the signed device-sessions disable. */
118
+ export const DEVICE_SESSIONS_DISABLE_LABEL = "openllm-device-sessions-disable-v1";
119
+ export const DEVICE_SESSIONS_DISABLE_VERSION = 1;
120
+ /** A disable older (or further in the future) than this is refused. */
121
+ export const DEVICE_SESSIONS_DISABLE_TS_WINDOW_MS = 5 * 60 * 1000;
122
+ export const DEVICE_SESSIONS_DISABLE_B64_MAX = 1024;
123
+ /**
124
+ * Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`, fixed key
125
+ * order `v, key_id, ts, nonce`. Disable-only — there is no enable field.
126
+ */
127
+ export const buildDeviceSessionsDisableMessage = (fields) => labelledMessage(DEVICE_SESSIONS_DISABLE_LABEL, JSON.stringify({
128
+ v: fields.v,
129
+ key_id: fields.key_id,
130
+ ts: fields.ts,
131
+ nonce: fields.nonce,
132
+ }));
133
+ export const encodeDeviceSessionsDisable = (envelope) => encodeB64Json({
134
+ v: envelope.v,
135
+ key_id: envelope.key_id,
136
+ ts: envelope.ts,
137
+ nonce: envelope.nonce,
138
+ sig: envelope.sig,
139
+ }, DEVICE_SESSIONS_DISABLE_B64_MAX, "device sessions disable exceeds its wire cap");
140
+ export const decodeDeviceSessionsDisable = (b64) => {
141
+ const o = decodeB64Json(b64, DEVICE_SESSIONS_DISABLE_B64_MAX);
142
+ if (o === null)
143
+ return null;
144
+ if (o.v !== DEVICE_SESSIONS_DISABLE_VERSION)
145
+ return null;
146
+ if (typeof o.key_id !== "string" || o.key_id.length === 0)
147
+ return null;
148
+ if (typeof o.ts !== "number" ||
149
+ !Number.isInteger(o.ts) ||
150
+ !Number.isFinite(o.ts) ||
151
+ o.ts <= 0) {
152
+ return null;
153
+ }
154
+ if (typeof o.nonce !== "string" || o.nonce.length === 0)
155
+ return null;
156
+ if (typeof o.sig !== "string" || o.sig.length === 0)
157
+ return null;
158
+ // Refuse a leftover enable-shaped payload from older clients.
159
+ if ("enable" in o)
160
+ return null;
161
+ return {
162
+ v: DEVICE_SESSIONS_DISABLE_VERSION,
163
+ key_id: o.key_id,
164
+ ts: o.ts,
165
+ nonce: o.nonce,
166
+ sig: o.sig,
167
+ };
168
+ };
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Device-control rotation wire format + key fingerprint helper.
3
+ *
4
+ * Shared by the browser (which signs rotations with the old control seed)
5
+ * and the daemon (which verifies them against its pinned control pubkey).
6
+ * Bytes + JSON only — no crypto. The v2 format drops the timestamp window
7
+ * that made stored statements unusable: being signed by the current pin is
8
+ * enough, because freshly derived phrases never repeat keys.
9
+ */
10
+ export declare const DEVICE_CONTROL_ROTATE_LABEL = "openllm-device-control-rotate-v2";
11
+ export declare const DEVICE_CONTROL_ROTATE_VERSION: 2;
12
+ /** Alias used by `@openllmsh/sdk/vault` `signDeviceControlRotation`. */
13
+ export declare const DEVICE_CONTROL_ROTATION_VERSION: 2;
14
+ /** Soft wire cap — matches attestation envelopes. */
15
+ export declare const DEVICE_CONTROL_ROTATION_B64_MAX = 1024;
16
+ /** Most statements bootstrap hands a daemon / a daemon walks per attempt. */
17
+ export declare const DEVICE_CONTROL_ROTATION_CHAIN_MAX = 8;
18
+ export type TDeviceControlRotationFields = {
19
+ readonly v: 2;
20
+ /** Current (old) control public key, SPKI base64. */
21
+ readonly old: string;
22
+ /** Next control public key, SPKI base64. */
23
+ readonly new: string;
24
+ /** New control / vault version — must exceed the daemon's pin version. */
25
+ readonly cv: number;
26
+ };
27
+ export type TDeviceControlRotationEnvelope = TDeviceControlRotationFields & {
28
+ readonly sig: string;
29
+ };
30
+ /**
31
+ * Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
32
+ * Fixed key order `v, old, new, cv`.
33
+ */
34
+ export declare const buildDeviceControlRotationMessage: (fields: Omit<TDeviceControlRotationFields, "v"> & {
35
+ readonly v?: 2;
36
+ }) => Uint8Array;
37
+ export declare const encodeDeviceControlRotation: (envelope: TDeviceControlRotationEnvelope) => string;
38
+ export declare const decodeDeviceControlRotation: (b64: string) => TDeviceControlRotationEnvelope | null;
39
+ /**
40
+ * Short fingerprint of an SPKI (base64): SHA-256, first 16 hex chars as
41
+ * four groups of four (`abcd efgh ijkl mnop`). Used in verify-device UI
42
+ * and `openllm daemon identity` output.
43
+ */
44
+ export declare const keyFingerprint: (spkiB64: string) => Promise<string>;
45
+ /**
46
+ * The {@link keyFingerprint} format from a precomputed SHA-256 digest of the
47
+ * SPKI DER — lets the daemon compute it synchronously with node:crypto while
48
+ * every surface prints the identical string.
49
+ */
50
+ export declare const formatKeyFingerprint: (sha256Digest: Uint8Array) => string;
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Device-control rotation wire format + key fingerprint helper.
3
+ *
4
+ * Shared by the browser (which signs rotations with the old control seed)
5
+ * and the daemon (which verifies them against its pinned control pubkey).
6
+ * Bytes + JSON only — no crypto. The v2 format drops the timestamp window
7
+ * that made stored statements unusable: being signed by the current pin is
8
+ * enough, because freshly derived phrases never repeat keys.
9
+ */
10
+ import { decodeB64Json, encodeB64Json, labelledMessage } from "./wire-bytes.js";
11
+ export const DEVICE_CONTROL_ROTATE_LABEL = "openllm-device-control-rotate-v2";
12
+ export const DEVICE_CONTROL_ROTATE_VERSION = 2;
13
+ /** Alias used by `@openllmsh/sdk/vault` `signDeviceControlRotation`. */
14
+ export const DEVICE_CONTROL_ROTATION_VERSION = DEVICE_CONTROL_ROTATE_VERSION;
15
+ /** Soft wire cap — matches attestation envelopes. */
16
+ export const DEVICE_CONTROL_ROTATION_B64_MAX = 1024;
17
+ /** Most statements bootstrap hands a daemon / a daemon walks per attempt. */
18
+ export const DEVICE_CONTROL_ROTATION_CHAIN_MAX = 8;
19
+ /**
20
+ * Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
21
+ * Fixed key order `v, old, new, cv`.
22
+ */
23
+ export const buildDeviceControlRotationMessage = (fields) => labelledMessage(DEVICE_CONTROL_ROTATE_LABEL, JSON.stringify({
24
+ v: DEVICE_CONTROL_ROTATE_VERSION,
25
+ old: fields.old,
26
+ new: fields.new,
27
+ cv: fields.cv,
28
+ }));
29
+ export const encodeDeviceControlRotation = (envelope) => encodeB64Json(envelope, DEVICE_CONTROL_ROTATION_B64_MAX, "device control rotation exceeds DEVICE_CONTROL_ROTATION_B64_MAX");
30
+ export const decodeDeviceControlRotation = (b64) => {
31
+ const o = decodeB64Json(b64, DEVICE_CONTROL_ROTATION_B64_MAX);
32
+ if (o === null)
33
+ return null;
34
+ if (o.v !== DEVICE_CONTROL_ROTATE_VERSION)
35
+ return null;
36
+ if (typeof o.old !== "string" || o.old.length === 0)
37
+ return null;
38
+ if (typeof o.new !== "string" || o.new.length === 0)
39
+ return null;
40
+ if (o.old === o.new)
41
+ return null;
42
+ if (typeof o.cv !== "number" || !Number.isInteger(o.cv) || o.cv < 1) {
43
+ return null;
44
+ }
45
+ if (typeof o.sig !== "string" || o.sig.length === 0)
46
+ return null;
47
+ return {
48
+ v: DEVICE_CONTROL_ROTATE_VERSION,
49
+ old: o.old,
50
+ new: o.new,
51
+ cv: o.cv,
52
+ sig: o.sig,
53
+ };
54
+ };
55
+ /**
56
+ * Short fingerprint of an SPKI (base64): SHA-256, first 16 hex chars as
57
+ * four groups of four (`abcd efgh ijkl mnop`). Used in verify-device UI
58
+ * and `openllm daemon identity` output.
59
+ */
60
+ export const keyFingerprint = async (spkiB64) => {
61
+ let spki;
62
+ try {
63
+ const bin = atob(spkiB64);
64
+ spki = new Uint8Array(bin.length);
65
+ for (let i = 0; i < bin.length; i++)
66
+ spki[i] = bin.charCodeAt(i);
67
+ }
68
+ catch {
69
+ throw new Error("keyFingerprint: malformed SPKI base64");
70
+ }
71
+ const digest = new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", spki));
72
+ return formatKeyFingerprint(digest);
73
+ };
74
+ /**
75
+ * The {@link keyFingerprint} format from a precomputed SHA-256 digest of the
76
+ * SPKI DER — lets the daemon compute it synchronously with node:crypto while
77
+ * every surface prints the identical string.
78
+ */
79
+ export const formatKeyFingerprint = (sha256Digest) => {
80
+ if (sha256Digest.length < 8) {
81
+ throw new Error("formatKeyFingerprint: digest too short");
82
+ }
83
+ let hex = "";
84
+ for (let i = 0; i < 8; i++) {
85
+ hex += sha256Digest[i].toString(16).padStart(2, "0");
86
+ }
87
+ return `${hex.slice(0, 4)} ${hex.slice(4, 8)} ${hex.slice(8, 12)} ${hex.slice(12, 16)}`;
88
+ };
@@ -0,0 +1,91 @@
1
+ /**
2
+ * Canonical device-grant wire format shared by the browser (which
3
+ * SIGNS grants with the account device-control key — derived from the
4
+ * recovery phrase, never the DEK; see `device-control.ts`) and the
5
+ * daemon (which VERIFIES them against its pinned control pubkey). Bytes + JSON only — no crypto lives
6
+ * here. Wire size cap is owned by protocol and re-exported.
7
+ */
8
+ import { DEVICE_GRANT_B64_MAX } from "@openllmsh/sdk/protocol";
9
+ export { DEVICE_GRANT_B64_MAX };
10
+ export declare const DEVICE_GRANT_LABEL = "openllm-device-grant-v1";
11
+ export declare const DEVICE_GRANT_VERSION: 1;
12
+ export declare const DEVICE_GRANT_TS_WINDOW_MS = 120000;
13
+ export declare const DEVICE_GRANT_NONCE_BYTES = 16;
14
+ export type TDeviceGrantFields = {
15
+ readonly v: 1;
16
+ /** 16-byte nonce, base64. */
17
+ readonly n: string;
18
+ /** ms since epoch at signing time. */
19
+ readonly ts: number;
20
+ /** The daemon's api key id. */
21
+ readonly key_id: string;
22
+ /** channel_id / tunnel_id / rtc channel_id being granted. */
23
+ readonly cid: string;
24
+ /** Daemon X25519 pubkey b64 ("" when unknown — legacy tunnel path). */
25
+ readonly aud: string;
26
+ /**
27
+ * The daemon X25519 pubkey (SPKI DER, base64) the signer TRUSTS — taken
28
+ * from a daemon attestation signed by the device-control key
29
+ * (`@openllmsh/sdk/vault` `daemon-attest.ts`), not from the cloud — and used as
30
+ * the Noise_IK responder key (`secure.ts`) on the relay mux. The daemon
31
+ * refuses a grant whose `dpk` is not its own key. Absent on legacy grants;
32
+ * when absent it is also absent from the signed message, so legacy bytes
33
+ * are unchanged.
34
+ */
35
+ readonly dpk?: string;
36
+ /**
37
+ * What the grant authorises ({@link TDeviceGrantUse}). Signed, so a grant
38
+ * minted for one purpose is refused for another: the relay sees every
39
+ * `channel_open` grant in plaintext, and without this it could replay one
40
+ * inside its own RTC offer or Noise handshake. Absent on legacy grants
41
+ * (and then absent from the signed message); required wherever `dpk` is.
42
+ */
43
+ readonly use?: TDeviceGrantUse;
44
+ /**
45
+ * The channel the grant is bound to, for uses that have one: the browser's
46
+ * DTLS fingerprint (`rtc`, the offer's sealed `fb`) or its Noise static key
47
+ * (`noise`, raw 32 bytes base64). A relay that harvests the grant cannot
48
+ * stand in for either.
49
+ */
50
+ readonly bind?: string;
51
+ };
52
+ /**
53
+ * - `channel`: a relay-mux `channel_open` (seen by the relay in plaintext).
54
+ * - `rtc`: an RTC offer's sealed grant; `bind` is the offer's DTLS fingerprint.
55
+ * - `noise`: the relay-mux agent Noise_IK message-1 payload; `bind` is the
56
+ * initiator's static key.
57
+ */
58
+ export declare const DEVICE_GRANT_USES: readonly ["channel", "rtc", "noise"];
59
+ export type TDeviceGrantUse = (typeof DEVICE_GRANT_USES)[number];
60
+ /**
61
+ * The `bind` of a `noise` grant: the initiator's raw 32-byte Noise static
62
+ * key, base64. Signer and verifier both derive it here so the bytes agree.
63
+ */
64
+ export declare const noiseGrantBinding: (initiatorStatic: Uint8Array) => string;
65
+ export type TDeviceGrantEnvelope = TDeviceGrantFields & {
66
+ readonly sig: string;
67
+ };
68
+ /**
69
+ * Canonical signed bytes: `utf8(LABEL) || 0x00 || utf8(json)`.
70
+ *
71
+ * The JSON is canonical-by-construction: it is produced by
72
+ * `JSON.stringify` of an object literal written in the fixed field
73
+ * order `v, n, ts, key_id, cid, aud[, dpk][, use][, bind]` (each optional
74
+ * field only when present, so legacy grant bytes are unchanged).
75
+ * ECMAScript guarantees own string-keyed property enumeration (and
76
+ * therefore stringify output) follows insertion order, so building the
77
+ * literal in that order yields identical bytes for identical fields on
78
+ * every runtime.
79
+ */
80
+ export declare const buildDeviceGrantMessage: (fields: TDeviceGrantFields) => Uint8Array;
81
+ /** base64(JSON) envelope encoding for the wire. */
82
+ export declare const encodeDeviceGrant: (envelope: TDeviceGrantEnvelope) => string;
83
+ /**
84
+ * Strict decode: returns null on any shape mismatch. `aud` may be the
85
+ * empty string (legacy tunnel path); `dpk`, `use` and `bind` may be absent
86
+ * (legacy grant) but, when present, `dpk` and `bind` must be non-empty
87
+ * strings and `use` one of {@link DEVICE_GRANT_USES}; every other string field must be
88
+ * non-empty, `v` must be exactly 1, `n` base64 of
89
+ * {@link DEVICE_GRANT_NONCE_BYTES} bytes, and `ts` a finite positive integer.
90
+ */
91
+ export declare const decodeDeviceGrant: (b64: string) => TDeviceGrantEnvelope | null;