@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,10 +1,9 @@
1
1
  import { Schema as S } from "effect";
2
- import { AuthEvent } from "./auth";
3
- import { RelayCommandLifecycleFrame } from "./control-channel";
4
- import { DaemonCommand, DaemonCommandAck } from "./daemon";
5
- import { ReplaySessionId } from "./replay-session";
6
- import { TEAM_GRANT_B64_MAX } from "./team-grant";
7
-
2
+ import { AuthEvent } from "./auth.js";
3
+ import { RelayCommandLifecycleFrame } from "./control-channel.js";
4
+ import { DaemonCommand, DaemonCommandAck } from "./daemon.js";
5
+ import { ReplaySessionId } from "./replay-session.js";
6
+ import { TEAM_GRANT_B64_MAX } from "./team-grant.js";
8
7
  // ─── Daemon relay (push over a Sandbox WebSocket, in-memory routing) ──
9
8
  //
10
9
  // A persistent WebSocket each end (daemon AND browser) holds to a relay
@@ -15,7 +14,6 @@ import { TEAM_GRANT_B64_MAX } from "./team-grant";
15
14
  // durable write the relay keeps is `api_key_activity` presence/status, read
16
15
  // by the stateless `/v1/*` proxy + a cold dashboard load. See
17
16
  // `docs/proposals/daemon-owned-state-stateless-relay.md`.
18
-
19
17
  /** Which end a connect ticket authorizes. A `daemon` socket receives
20
18
  * commands for its `key_id` and sends acks/status; a `watcher` socket
21
19
  * (a dashboard tab) enqueues commands for keys its `user_id` owns and
@@ -24,40 +22,25 @@ import { TEAM_GRANT_B64_MAX } from "./team-grant";
24
22
  * (origin-side tunneling): it may only open mux channels, and the relay
25
23
  * stamps its channels `consumer:"daemon"` exactly like a peer daemon's. */
26
24
  export const RelayRole = S.Literals(["daemon", "watcher", "origin"]);
27
- export type TRelayRole = S.Schema.Type<typeof RelayRole>;
28
-
29
25
  /** Bounded, open-vocabulary capability advertisement limits. */
30
26
  export const RELAY_CAP_MAX_ITEMS = 32;
31
27
  export const RELAY_CAP_MAX_LENGTH = 64;
32
- const RelayCapability = S.String.check(
33
- S.isMinLength(1),
34
- S.isMaxLength(RELAY_CAP_MAX_LENGTH),
35
- );
36
- const RelayCapabilities = S.Array(RelayCapability).check(
37
- S.isMaxLength(RELAY_CAP_MAX_ITEMS),
38
- );
39
-
28
+ const RelayCapability = S.String.check(S.isMinLength(1), S.isMaxLength(RELAY_CAP_MAX_LENGTH));
29
+ const RelayCapabilities = S.Array(RelayCapability).check(S.isMaxLength(RELAY_CAP_MAX_ITEMS));
40
30
  /**
41
31
  * Channel ids are the mux envelope's canonical UUID in text form —
42
32
  * RFC 4122 lowercase hex with variant nibble `8|9|a|b` (matches
43
33
  * `@openllmsh/sdk/tunnel` `isChannelId` / `CHANNEL_ID_PATTERN`).
44
34
  */
45
- const CHANNEL_ID_PATTERN =
46
- /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
35
+ const CHANNEL_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
47
36
  export const ChannelId = S.String.check(S.isPattern(CHANNEL_ID_PATTERN));
48
- export type TChannelId = S.Schema.Type<typeof ChannelId>;
49
-
50
37
  /** Bounded open-vocabulary peer errors and refusal reasons. */
51
38
  const RelayFreeString = S.String.check(S.isMinLength(1), S.isMaxLength(200));
52
-
53
39
  /** The port the in-sandbox WS server listens on — declared in `ports` at
54
40
  * `Sandbox.getOrCreate` (cloud) and bound by the relay. A fixed internal
55
41
  * constant (the public surface is the sandbox's own domain), shared so the
56
42
  * provisioner's `sandbox.domain(port)` and the relay's listener agree. */
57
43
  export const RELAY_PORT = 8080;
58
-
59
- export type TRelayDatabaseTarget = "pre-production" | "production";
60
-
61
44
  /**
62
45
  * The relay identity (sandbox name + TTL class) for the current deployment,
63
46
  * derived from `VERCEL_ENV` — the only remaining discriminator now that a
@@ -68,29 +51,16 @@ export type TRelayDatabaseTarget = "pre-production" | "production";
68
51
  * `pre-production`. Pure (a function of its input) so the DB client, the cloud
69
52
  * provisioner, and the in-sandbox relay all agree from the same signal.
70
53
  */
71
- export const resolveDatabaseTarget = (
72
- vercelEnv: string | undefined,
73
- ): TRelayDatabaseTarget =>
74
- vercelEnv === "production" ? "production" : "pre-production";
75
-
54
+ export const resolveDatabaseTarget = (vercelEnv) => vercelEnv === "production" ? "production" : "pre-production";
76
55
  /** The name of the retired daemon-relay logical-replication slot. The relay no
77
56
  * longer subscribes it (commands route in memory) — this is kept ONLY so
78
57
  * `packages/db/migrate.ts` can DROP a leftover slot on deploy (Phase 5
79
58
  * demolition). The matching `daemon_relay_pub` publication is dropped by
80
59
  * `migrations/0007_chunky_expediter.sql` using its literal name. */
81
60
  export const RELAY_SLOT = "daemon_relay_slot";
82
-
83
- /** The per-environment relay identity — just the sandbox name now (the
84
- * publication/slot the CDC era carried are gone). Pure derivation (no env, no
85
- * I/O) so the cloud provisioner and the relay agree. */
86
- export type TRelayNames = {
87
- readonly relayName: string;
88
- };
89
-
90
- export const relayNamesFor = (target: TRelayDatabaseTarget): TRelayNames => ({
91
- relayName: `daemon-relay-${target}`,
61
+ export const relayNamesFor = (target) => ({
62
+ relayName: `daemon-relay-${target}`,
92
63
  });
93
-
94
64
  // ─── Sandbox origin tags (deprovisioning) ─────────────────────────────
95
65
  //
96
66
  // The provisioner tags each relay sandbox with the stable ORIGIN that uses it
@@ -99,36 +69,24 @@ export const relayNamesFor = (target: TRelayDatabaseTarget): TRelayNames => ({
99
69
  // fetches. The cleanup cron groups boxes by origin and gracefully stops a
100
70
  // superseded box (same origin, older freshness, different bundle hash) —
101
71
  // see `lib/relay-sandbox-cleanup.ts`.
102
-
103
72
  /** Tag key: the sanitized stable origin that provisioned/uses this box. */
104
73
  export const RELAY_TAG_ORIGIN = "origin";
105
74
  /** Tag key: unix-ms (decimal string) of the origin's last claim/refresh. */
106
75
  export const RELAY_TAG_ORIGIN_AT = "origin-at";
107
-
108
- /** The env signals the origin is derived from. `localHostname` is caller-
109
- * provided (`os.hostname()`) so this stays pure and testable. */
110
- export type TRelayOriginInputs = {
111
- readonly vercelEnv: string | undefined;
112
- readonly projectProductionUrl: string | undefined;
113
- readonly branchUrl: string | undefined;
114
- readonly deploymentUrl: string | undefined;
115
- readonly localHostname: string | undefined;
116
- };
117
-
118
76
  /** Sandbox tag values must be short, plain tokens. Lowercase, strip the
119
77
  * protocol + trailing slash, squash anything outside [a-z0-9._-], cap at 64.
120
78
  * Returns null when nothing usable remains so the caller can fall back. */
121
- const sanitizeOriginTag = (raw: string | undefined): string | null => {
122
- if (raw === undefined) return null;
123
- const cleaned = raw
124
- .toLowerCase()
125
- .replace(/^https?:\/\//, "")
126
- .replace(/\/+$/, "")
127
- .replace(/[^a-z0-9._-]/g, "-")
128
- .slice(0, 64);
129
- return cleaned === "" ? null : cleaned;
79
+ const sanitizeOriginTag = (raw) => {
80
+ if (raw === undefined)
81
+ return null;
82
+ const cleaned = raw
83
+ .toLowerCase()
84
+ .replace(/^https?:\/\//, "")
85
+ .replace(/\/+$/, "")
86
+ .replace(/[^a-z0-9._-]/g, "-")
87
+ .slice(0, 64);
88
+ return cleaned === "" ? null : cleaned;
130
89
  };
131
-
132
90
  /**
133
91
  * The STABLE origin identity for sandbox tagging — stable across deploys of
134
92
  * the same "place", so the cleanup cron's per-origin change detection fires:
@@ -139,21 +97,18 @@ const sanitizeOriginTag = (raw: string | undefined): string | null => {
139
97
  * other's boxes.
140
98
  * Pure (a function of its inputs) per the convention above.
141
99
  */
142
- export const resolveRelayOrigin = (inputs: TRelayOriginInputs): string => {
143
- if (inputs.vercelEnv === "production") {
144
- return sanitizeOriginTag(inputs.projectProductionUrl) ?? "production";
145
- }
146
- if (inputs.vercelEnv === "preview") {
147
- return (
148
- sanitizeOriginTag(inputs.branchUrl) ??
149
- sanitizeOriginTag(inputs.deploymentUrl) ??
150
- "preview"
151
- );
152
- }
153
- const host = sanitizeOriginTag(inputs.localHostname);
154
- return host === null ? "local" : `local-${host}`;
100
+ export const resolveRelayOrigin = (inputs) => {
101
+ if (inputs.vercelEnv === "production") {
102
+ return sanitizeOriginTag(inputs.projectProductionUrl) ?? "production";
103
+ }
104
+ if (inputs.vercelEnv === "preview") {
105
+ return (sanitizeOriginTag(inputs.branchUrl) ??
106
+ sanitizeOriginTag(inputs.deploymentUrl) ??
107
+ "preview");
108
+ }
109
+ const host = sanitizeOriginTag(inputs.localHostname);
110
+ return host === null ? "local" : `local-${host}`;
155
111
  };
156
-
157
112
  /**
158
113
  * The decoded claims of a connect ticket. The cloud (`/api/daemon/channel`)
159
114
  * mints these after validating the caller (`sk-llm` key → `daemon`, Neon
@@ -165,34 +120,29 @@ export const resolveRelayOrigin = (inputs: TRelayOriginInputs): string => {
165
120
  * sandbox name; `jti` is a one-shot nonce consumed by the relay.
166
121
  */
167
122
  export const RelayTicketClaims = S.Struct({
168
- role: RelayRole,
169
- user_id: S.String,
170
- key_id: S.optional(S.String),
171
- exp: S.Number,
172
- /** Relay sandbox audience, e.g. `daemon-relay-production`. */
173
- aud: S.String.check(S.isMinLength(1), S.isMaxLength(128)),
174
- /** Unique ticket id (base64url) — single-use within the TTL window. */
175
- jti: S.String.check(S.isMinLength(16), S.isMaxLength(64)),
123
+ role: RelayRole,
124
+ user_id: S.String,
125
+ key_id: S.optional(S.String),
126
+ exp: S.Number,
127
+ /** Relay sandbox audience, e.g. `daemon-relay-production`. */
128
+ aud: S.String.check(S.isMinLength(1), S.isMaxLength(128)),
129
+ /** Unique ticket id (base64url) — single-use within the TTL window. */
130
+ jti: S.String.check(S.isMinLength(16), S.isMaxLength(64)),
176
131
  });
177
- export type TRelayTicketClaims = S.Schema.Type<typeof RelayTicketClaims>;
178
-
179
132
  /**
180
133
  * Domain-separation label for the Ed25519 seed derivation. Shared by the
181
134
  * cloud signer and the verifier so both derive the same keypair from
182
135
  * `NEON_AUTH_COOKIE_SECRET`. The sandbox receives only the public half.
183
136
  */
184
137
  export const RELAY_TICKET_SEED_LABEL = "openllm-relay-ticket-ed25519-seed-v1";
185
-
186
138
  /** One ICE server entry (STUN or TURN) on the channel handshake — mirrors
187
139
  * `RTCIceServer` so browser and daemon feed it to their peer connections
188
140
  * verbatim. */
189
141
  export const IceServer = S.Struct({
190
- urls: S.Union([S.String, S.Array(S.String)]),
191
- username: S.optional(S.String),
192
- credential: S.optional(S.String),
142
+ urls: S.Union([S.String, S.Array(S.String)]),
143
+ username: S.optional(S.String),
144
+ credential: S.optional(S.String),
193
145
  });
194
- export type TIceServer = S.Schema.Type<typeof IceServer>;
195
-
196
146
  /** GET /api/daemon/channel → the live relay WSS URL + a connect ticket. Both
197
147
  * daemon and browser dial `wss_url`, presenting `ticket` in their first
198
148
  * `hello` frame. The URL is the sandbox's own domain (`wss://<sandbox-host>`);
@@ -201,83 +151,68 @@ export type TIceServer = S.Schema.Type<typeof IceServer>;
201
151
  * cloud-served ICE config (from `OPENLLM_RTC_ICE_SERVERS`) — absent, both
202
152
  * ends fall back to their default STUN. */
203
153
  export const RelayChannelResponse = S.Struct({
204
- wss_url: S.String,
205
- /** Short-lived Ed25519-signed connect ticket
206
- * (opaque `<b64url(claims)>.<b64url(sig)>`). */
207
- ticket: S.String,
208
- /** Optional cloud-served ICE servers (STUN/TURN) for RTC peers. */
209
- ice_servers: S.optional(S.Array(IceServer)),
154
+ wss_url: S.String,
155
+ /** Short-lived Ed25519-signed connect ticket
156
+ * (opaque `<b64url(claims)>.<b64url(sig)>`). */
157
+ ticket: S.String,
158
+ /** Optional cloud-served ICE servers (STUN/TURN) for RTC peers. */
159
+ ice_servers: S.optional(S.Array(IceServer)),
210
160
  });
211
- export type TRelayChannelResponse = S.Schema.Type<typeof RelayChannelResponse>;
212
-
213
161
  // ─── WebSocket frame envelope ────────────────────────────────────────
214
162
  //
215
163
  // One tagged union shared by all four parties. Each variant documents its
216
164
  // direction; a given end only emits the subset it owns and ignores the
217
165
  // rest. JSON over text frames.
218
-
219
166
  /** client → relay (first frame). A daemon may piggyback its initial
220
167
  * status snapshot; a watcher sends ticket only. */
221
168
  export const RelayHelloFrame = S.Struct({
222
- type: S.Literal("hello"),
223
- ticket: S.String,
224
- /** Daemon protocol capability; absent daemons retain legacy compatibility. */
225
- protocol_version: S.optional(S.Number),
226
- /** Open-vocabulary peer capability list.
227
- * Unknown capabilities preserve forward compatibility. */
228
- caps: S.optional(RelayCapabilities),
229
- /** Daemon only: initial per-provider `TDaemonStatus` snapshot, folded
230
- * into `api_key_activity.daemon_status_json` on connect. */
231
- status: S.optional(S.Unknown),
169
+ type: S.Literal("hello"),
170
+ ticket: S.String,
171
+ /** Daemon protocol capability; absent daemons retain legacy compatibility. */
172
+ protocol_version: S.optional(S.Number),
173
+ /** Open-vocabulary peer capability list.
174
+ * Unknown capabilities preserve forward compatibility. */
175
+ caps: S.optional(RelayCapabilities),
176
+ /** Daemon only: initial per-provider `TDaemonStatus` snapshot, folded
177
+ * into `api_key_activity.daemon_status_json` on connect. */
178
+ status: S.optional(S.Unknown),
232
179
  });
233
- export type TRelayHelloFrame = S.Schema.Type<typeof RelayHelloFrame>;
234
-
235
180
  /** relay → client. Handshake accepted; carries the current presence snapshot so
236
181
  * a freshly-attached dashboard paints immediately. */
237
182
  export const RelayWelcomeFrame = S.Struct({
238
- type: S.Literal("welcome"),
239
- /** Watcher only: the AUTHORITATIVE set of the user's key ids that have a live
240
- * daemon socket on the relay right now, from its in-memory registry. The
241
- * dashboard treats membership as presence — keys absent here are offline by
242
- * authority of the relay that owns every socket — so a stale-`true`
243
- * `api_key_activity` row (ungraceful relay death) is corrected the instant a
244
- * watcher (re)connects. Live status keeps flowing via `status_push`. */
245
- snapshot: S.optional(S.Array(S.String)),
246
- /** Daemon only: relay-assigned connection epoch for ordered snapshots. */
247
- daemon_session_id: S.optional(S.String),
248
- daemon_session_started_at_ms: S.optional(S.Number),
249
- protocol_version: S.optional(S.Number),
250
- /** Relay capabilities. */
251
- caps: S.optional(RelayCapabilities),
252
- /** Per-serving-daemon capability snapshots, parallel to `snapshot`. */
253
- snapshot_caps: S.optional(S.Record(S.String, RelayCapabilities)),
183
+ type: S.Literal("welcome"),
184
+ /** Watcher only: the AUTHORITATIVE set of the user's key ids that have a live
185
+ * daemon socket on the relay right now, from its in-memory registry. The
186
+ * dashboard treats membership as presence — keys absent here are offline by
187
+ * authority of the relay that owns every socket — so a stale-`true`
188
+ * `api_key_activity` row (ungraceful relay death) is corrected the instant a
189
+ * watcher (re)connects. Live status keeps flowing via `status_push`. */
190
+ snapshot: S.optional(S.Array(S.String)),
191
+ /** Daemon only: relay-assigned connection epoch for ordered snapshots. */
192
+ daemon_session_id: S.optional(S.String),
193
+ daemon_session_started_at_ms: S.optional(S.Number),
194
+ protocol_version: S.optional(S.Number),
195
+ /** Relay capabilities. */
196
+ caps: S.optional(RelayCapabilities),
197
+ /** Per-serving-daemon capability snapshots, parallel to `snapshot`. */
198
+ snapshot_caps: S.optional(S.Record(S.String, RelayCapabilities)),
254
199
  });
255
- export type TRelayWelcomeFrame = S.Schema.Type<typeof RelayWelcomeFrame>;
256
-
257
200
  /** relay → daemon. One command to run, routed in memory the instant the watcher
258
201
  * enqueues it (no durable mailbox). `id` is a relay-generated uuid. */
259
202
  export const RelayCommandFrame = S.Struct({
260
- type: S.Literal("command"),
261
- command: DaemonCommand,
203
+ type: S.Literal("command"),
204
+ command: DaemonCommand,
262
205
  });
263
- export type TRelayCommandFrame = S.Schema.Type<typeof RelayCommandFrame>;
264
-
265
206
  /** daemon → relay. A terminal command result; the relay forwards it to the
266
207
  * originating watcher as a `command_lifecycle` frame (no `daemon_commands`
267
208
  * row to update). */
268
209
  export const RelayAckFrame = S.Struct({
269
- type: S.Literal("ack"),
270
- ack: DaemonCommandAck,
210
+ type: S.Literal("ack"),
211
+ ack: DaemonCommandAck,
271
212
  });
272
- export type TRelayAckFrame = S.Schema.Type<typeof RelayAckFrame>;
273
-
274
213
  /** Planned-downtime reason on a graceful `active:false` status beacon.
275
214
  * Absent ⇒ real offline / legacy beacon (CERTAIN death). */
276
215
  export const RelayStatusRestartReason = S.Literal("restarting");
277
- export type TRelayStatusRestartReason = S.Schema.Type<
278
- typeof RelayStatusRestartReason
279
- >;
280
-
281
216
  /** daemon → relay. Heartbeat + per-provider snapshot. `active:false` is the
282
217
  * graceful-exit beacon. The relay folds the snapshot into
283
218
  * `api_key_activity.daemon_status_json` (durable, read by the proxy + a cold
@@ -290,20 +225,18 @@ export type TRelayStatusRestartReason = S.Schema.Type<
290
225
  * CERTAIN death (`daemon_active=false`). See
291
226
  * `docs/audit/2026-10-20-deploy-zero-downtime.md` fix #2. */
292
227
  export const RelayStatusFrame = S.Struct({
293
- type: S.Literal("status"),
294
- active: S.optional(S.Boolean),
295
- status: S.optional(S.Unknown),
296
- /** Present for protocol-v2 daemon status snapshots. */
297
- daemon_session_id: S.optional(S.String),
298
- status_seq: S.optional(S.Number),
299
- acks: S.optional(S.Array(DaemonCommandAck)),
300
- /** Planned downtime; absent ⇒ real offline / legacy beacon. */
301
- reason: S.optional(RelayStatusRestartReason),
302
- /** Hint for origin grace / UI: ms until this key should be back. */
303
- expect_back_ms: S.optional(S.Number),
228
+ type: S.Literal("status"),
229
+ active: S.optional(S.Boolean),
230
+ status: S.optional(S.Unknown),
231
+ /** Present for protocol-v2 daemon status snapshots. */
232
+ daemon_session_id: S.optional(S.String),
233
+ status_seq: S.optional(S.Number),
234
+ acks: S.optional(S.Array(DaemonCommandAck)),
235
+ /** Planned downtime; absent ⇒ real offline / legacy beacon. */
236
+ reason: S.optional(RelayStatusRestartReason),
237
+ /** Hint for origin grace / UI: ms until this key should be back. */
238
+ expect_back_ms: S.optional(S.Number),
304
239
  });
305
- export type TRelayStatusFrame = S.Schema.Type<typeof RelayStatusFrame>;
306
-
307
240
  /** watcher → relay. The dashboard enqueues a control command for one of the
308
241
  * user's keys. The relay authorizes it by REGISTRY MEMBERSHIP — a watcher may
309
242
  * address `key_id` K iff a daemon socket for K is connected with the same
@@ -311,49 +244,41 @@ export type TRelayStatusFrame = S.Schema.Type<typeof RelayStatusFrame>;
311
244
  * memory. `req_id` correlates the relay's `enqueue_ack`; omit it for
312
245
  * fire-and-forget. */
313
246
  export const RelayEnqueueFrame = S.Struct({
314
- type: S.Literal("enqueue"),
315
- req_id: S.optional(S.String),
316
- key_id: S.String,
317
- kind: S.String,
318
- payload: S.optional(S.Unknown),
319
- replay_session_id: S.optional(ReplaySessionId),
247
+ type: S.Literal("enqueue"),
248
+ req_id: S.optional(S.String),
249
+ key_id: S.String,
250
+ kind: S.String,
251
+ payload: S.optional(S.Unknown),
252
+ replay_session_id: S.optional(ReplaySessionId),
320
253
  });
321
- export type TRelayEnqueueFrame = S.Schema.Type<typeof RelayEnqueueFrame>;
322
-
323
254
  /** relay → watcher. The result of an `enqueue` carrying a `req_id`: the
324
255
  * relay-generated command id on success, or an error (`daemon_offline` /
325
256
  * `invalid_command`). */
326
257
  export const RelayEnqueueAckFrame = S.Struct({
327
- type: S.Literal("enqueue_ack"),
328
- req_id: S.String,
329
- ok: S.Boolean,
330
- id: S.optional(S.String),
331
- error: S.optional(S.String),
258
+ type: S.Literal("enqueue_ack"),
259
+ req_id: S.String,
260
+ ok: S.Boolean,
261
+ id: S.optional(S.String),
262
+ error: S.optional(S.String),
332
263
  });
333
- export type TRelayEnqueueAckFrame = S.Schema.Type<typeof RelayEnqueueAckFrame>;
334
-
335
264
  /** relay → watcher. A daemon's status snapshot for one key landed; push it
336
265
  * to the dashboard. */
337
266
  export const RelayStatusPushFrame = S.Struct({
338
- type: S.Literal("status_push"),
339
- key_id: S.String,
340
- status: S.Unknown,
341
- daemon_session_id: S.optional(S.String),
342
- daemon_session_started_at_ms: S.optional(S.Number),
343
- status_seq: S.optional(S.Number),
267
+ type: S.Literal("status_push"),
268
+ key_id: S.String,
269
+ status: S.Unknown,
270
+ daemon_session_id: S.optional(S.String),
271
+ daemon_session_started_at_ms: S.optional(S.Number),
272
+ status_seq: S.optional(S.Number),
344
273
  });
345
- export type TRelayStatusPushFrame = S.Schema.Type<typeof RelayStatusPushFrame>;
346
-
347
274
  /** relay → watcher. A key's daemon presence flipped (socket open/close). */
348
275
  export const RelayPresenceFrame = S.Struct({
349
- type: S.Literal("presence"),
350
- key_id: S.String,
351
- active: S.Boolean,
352
- /** Present when an active daemon advertises capabilities. */
353
- caps: S.optional(RelayCapabilities),
276
+ type: S.Literal("presence"),
277
+ key_id: S.String,
278
+ active: S.Boolean,
279
+ /** Present when an active daemon advertises capabilities. */
280
+ caps: S.optional(RelayCapabilities),
354
281
  });
355
- export type TRelayPresenceFrame = S.Schema.Type<typeof RelayPresenceFrame>;
356
-
357
282
  // ─── Subscription tunnel + device sessions (mux-only) ────────────────
358
283
  //
359
284
  // A consumer (browser watcher socket, or another daemon's socket) opens a
@@ -365,7 +290,6 @@ export type TRelayPresenceFrame = S.Schema.Type<typeof RelayPresenceFrame>;
365
290
  // only OpenLLM-wire bytes do. The relay never decodes mux payloads. The
366
291
  // legacy JSON `tunnel_*` / `session_*` splice frames have been removed.
367
292
  // See `docs/features/sub-tunnel-and-chat-sessions.md`.
368
-
369
293
  /**
370
294
  * Max base64 length of a seed-gated device-grant envelope on open frames.
371
295
  * Real envelopes are a few hundred bytes (JSON of nonce/ts/key_id/cid/aud +
@@ -376,17 +300,14 @@ export type TRelayPresenceFrame = S.Schema.Type<typeof RelayPresenceFrame>;
376
300
  * the same value so decode stays aligned with Schema maxLength.
377
301
  */
378
302
  export const DEVICE_GRANT_B64_MAX = 4 * 1024;
379
-
380
303
  /**
381
304
  * Internal hop marker: the serving daemon stamps this on every request it
382
305
  * dispatches from a tunnel open so a fleet-peer walker can refuse to
383
306
  * re-tunnel (loop guard). Not a client-facing API.
384
307
  */
385
308
  export const TUNNELED_REQUEST_HEADER = "x-openllm-tunneled";
386
-
387
309
  /** Response header naming the device key that served a tunneled request. */
388
310
  export const SERVED_BY_DEVICE_HEADER = "x-openllm-served-by-device";
389
-
390
311
  /**
391
312
  * Request header pinning a follow-up to the device that served an earlier
392
313
  * call (a video job lives on ONE device's vendor account; its id does not
@@ -396,89 +317,71 @@ export const SERVED_BY_DEVICE_HEADER = "x-openllm-served-by-device";
396
317
  */
397
318
  export const TARGET_DEVICE_HEADER = "x-openllm-target-device";
398
319
  export const TUNNELED_REQUEST_VALUE = "1";
399
-
400
320
  // ─── Mux channels (consumer ⇄ relay ⇄ serving daemon) ─────────────────
401
-
402
321
  /** consumer → relay → serving daemon. Auth runs once when opening this
403
322
  * channel; after acceptance, all subsequent binary frames on both sockets
404
323
  * belong to this channel. */
405
324
  export const RelayChannelOpenFrame = S.Struct({
406
- type: S.Literal("channel_open"),
407
- channel_id: ChannelId,
408
- key_id: S.String,
409
- /**
410
- * Who is opening the channel. The relay stamps this from the authenticated
411
- * socket role before forward (`watcher` → `browser`, `daemon` → `daemon`) —
412
- * clients may set it but the relay overwrites. `daemon` marks a fleet peer
413
- * hop so the serving daemon skips seedgate (no vault DEK on the consumer).
414
- * Omitted / `browser` is the default seed-gated path.
415
- */
416
- consumer: S.optional(S.Literals(["browser", "daemon"])),
417
- /**
418
- * Seed-gated device grant (base64 envelope). Present when the serving
419
- * daemon advertises `seedgate1`. Relay re-encodes via Schema — must be
420
- * on the schema so it survives forward; never verified by the relay.
421
- * Bounded so a peer cannot ship an arbitrarily large grant past re-encode.
422
- */
423
- grant: S.optional(S.String.check(S.isMaxLength(DEVICE_GRANT_B64_MAX))),
424
- /**
425
- * Origin-signed team grant (base64 envelope). Required for cross-user
426
- * admission: the relay admits when non-empty (it does NOT verify — the
427
- * contributor daemon re-checks with its bootstrap `team_grant_key`).
428
- * Same-user opens omit it. Opaque to the payload path; bounded like
429
- * {@link DEVICE_GRANT_B64_MAX}.
430
- */
431
- team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
432
- /** Authenticated consumer user id. The relay replaces client input. */
433
- peer_user_id: S.optional(S.String),
325
+ type: S.Literal("channel_open"),
326
+ channel_id: ChannelId,
327
+ key_id: S.String,
328
+ /**
329
+ * Who is opening the channel. The relay stamps this from the authenticated
330
+ * socket role before forward (`watcher` → `browser`, `daemon` → `daemon`) —
331
+ * clients may set it but the relay overwrites. `daemon` marks a fleet peer
332
+ * hop so the serving daemon skips seedgate (no vault DEK on the consumer).
333
+ * Omitted / `browser` is the default seed-gated path.
334
+ */
335
+ consumer: S.optional(S.Literals(["browser", "daemon"])),
336
+ /**
337
+ * Seed-gated device grant (base64 envelope). Present when the serving
338
+ * daemon advertises `seedgate1`. Relay re-encodes via Schema — must be
339
+ * on the schema so it survives forward; never verified by the relay.
340
+ * Bounded so a peer cannot ship an arbitrarily large grant past re-encode.
341
+ */
342
+ grant: S.optional(S.String.check(S.isMaxLength(DEVICE_GRANT_B64_MAX))),
343
+ /**
344
+ * Origin-signed team grant (base64 envelope). Required for cross-user
345
+ * admission: the relay admits when non-empty (it does NOT verify — the
346
+ * contributor daemon re-checks with its bootstrap `team_grant_key`).
347
+ * Same-user opens omit it. Opaque to the payload path; bounded like
348
+ * {@link DEVICE_GRANT_B64_MAX}.
349
+ */
350
+ team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
351
+ /** Authenticated consumer user id. The relay replaces client input. */
352
+ peer_user_id: S.optional(S.String),
434
353
  });
435
- export type TRelayChannelOpenFrame = S.Schema.Type<
436
- typeof RelayChannelOpenFrame
437
- >;
438
-
439
354
  /** Relay-to-daemon form of {@link RelayChannelOpenFrame}. The relay stamps
440
355
  * `peer_user_id`; daemons never accept an unstamped open as same-user. */
441
356
  export const RelayStampedChannelOpenFrame = S.Struct({
442
- type: S.Literal("channel_open"),
443
- channel_id: ChannelId,
444
- key_id: S.String,
445
- consumer: S.optional(S.Literals(["browser", "daemon"])),
446
- grant: S.optional(S.String.check(S.isMaxLength(DEVICE_GRANT_B64_MAX))),
447
- team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
448
- peer_user_id: S.String,
357
+ type: S.Literal("channel_open"),
358
+ channel_id: ChannelId,
359
+ key_id: S.String,
360
+ consumer: S.optional(S.Literals(["browser", "daemon"])),
361
+ grant: S.optional(S.String.check(S.isMaxLength(DEVICE_GRANT_B64_MAX))),
362
+ team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
363
+ peer_user_id: S.String,
449
364
  });
450
- export type TRelayStampedChannelOpenFrame = S.Schema.Type<
451
- typeof RelayStampedChannelOpenFrame
452
- >;
453
-
454
365
  /** serving daemon → relay → consumer. The relay mints failure acknowledgements;
455
366
  * an accepting daemon's acknowledgement is echoed verbatim. */
456
367
  export const RelayChannelOpenAckFrame = S.Struct({
457
- type: S.Literal("channel_open_ack"),
458
- channel_id: ChannelId,
459
- ok: S.Boolean,
460
- /**
461
- * Free-string on the wire so newer daemon failures remain decodable by
462
- * older relay peers. Known values live in {@link ChannelOpenError}.
463
- */
464
- error: S.optional(RelayFreeString),
368
+ type: S.Literal("channel_open_ack"),
369
+ channel_id: ChannelId,
370
+ ok: S.Boolean,
371
+ /**
372
+ * Free-string on the wire so newer daemon failures remain decodable by
373
+ * older relay peers. Known values live in {@link ChannelOpenError}.
374
+ */
375
+ error: S.optional(RelayFreeString),
465
376
  });
466
- export type TRelayChannelOpenAckFrame = S.Schema.Type<
467
- typeof RelayChannelOpenAckFrame
468
- >;
469
-
470
377
  /** Either side / relay-minted. `relay_restart` is a drain signal: consumers
471
378
  * reset in-flight streams and re-open the channel on the successor relay. */
472
379
  export const RelayChannelCloseFrame = S.Struct({
473
- type: S.Literal("channel_close"),
474
- channel_id: ChannelId,
475
- /** Free-string on the wire; known values live in ChannelCloseReason. */
476
- reason: S.optional(RelayFreeString),
380
+ type: S.Literal("channel_close"),
381
+ channel_id: ChannelId,
382
+ /** Free-string on the wire; known values live in ChannelCloseReason. */
383
+ reason: S.optional(RelayFreeString),
477
384
  });
478
- export type TRelayChannelCloseFrame = S.Schema.Type<
479
- typeof RelayChannelCloseFrame
480
- >;
481
-
482
385
  // ─── WebRTC signaling (consumer ⇄ relay ⇄ serving daemon) ──────────────
483
386
  //
484
387
  // SDP + trickle ICE for a direct browser⇄daemon RTCDataChannel. The relay is
@@ -491,88 +394,68 @@ export type TRelayChannelCloseFrame = S.Schema.Type<
491
394
  // `candidate` is a JSON string of an `RTCIceCandidateInit` (or the werift
492
395
  // equivalent) so browser and daemon peers share one serialization without
493
396
  // inventing a side-car candidate schema.
494
-
495
397
  /**
496
398
  * Soft upper bound for an SDP blob on the signaling plane. Real offers/
497
399
  * answers are a few KB; 64 KiB leaves headroom while staying well under a
498
400
  * typical WebSocket frame budget (~1 MiB on Cloudflare / PartySocket).
499
401
  */
500
402
  export const RTC_SDP_MAX = 64 * 1024;
501
-
502
403
  /**
503
404
  * Soft upper bound for a base64 sealed fingerprint proof. Sealed-box
504
405
  * ciphertext for the offer/answer inner is well under 2 KiB even with a
505
406
  * nested device grant; 8 KiB is a conservative ceiling.
506
407
  */
507
408
  export const RTC_FINGERPRINT_PROOF_B64_MAX = 8 * 1024;
508
-
509
409
  /**
510
410
  * Soft upper bound for a JSON-serialized `RTCIceCandidateInit`. A single
511
411
  * candidate line + mid/mline fields is typically < 512 B; 4 KiB is generous.
512
412
  */
513
413
  export const RTC_ICE_CANDIDATE_MAX = 4 * 1024;
514
-
515
414
  /** consumer → relay → serving daemon. Open an RTC signaling session aimed at
516
415
  * the daemon serving `key_id`. The consumer mints `channel_id` (uuid); the
517
416
  * relay authorizes by registry membership and registers the pair so later
518
417
  * `rtc_answer` / `rtc_ice` frames route by `channel_id`. */
519
418
  export const RelayRtcOfferFrame = S.Struct({
520
- type: S.Literal("rtc_offer"),
521
- channel_id: ChannelId,
522
- key_id: S.String,
523
- sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
524
- fingerprint_proof: S.String.check(
525
- S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX),
526
- ),
527
- /** Opaque origin-signed grant required for cross-user RTC admission. */
528
- team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
529
- /** Authenticated consumer id. The relay replaces client input. */
530
- peer_user_id: S.optional(S.String),
531
- /** Authenticated consumer kind. The relay replaces client input. */
532
- consumer: S.optional(S.Literals(["browser", "daemon"])),
419
+ type: S.Literal("rtc_offer"),
420
+ channel_id: ChannelId,
421
+ key_id: S.String,
422
+ sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
423
+ fingerprint_proof: S.String.check(S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX)),
424
+ /** Opaque origin-signed grant required for cross-user RTC admission. */
425
+ team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
426
+ /** Authenticated consumer id. The relay replaces client input. */
427
+ peer_user_id: S.optional(S.String),
428
+ /** Authenticated consumer kind. The relay replaces client input. */
429
+ consumer: S.optional(S.Literals(["browser", "daemon"])),
533
430
  });
534
- export type TRelayRtcOfferFrame = S.Schema.Type<typeof RelayRtcOfferFrame>;
535
-
536
431
  /** Relay-to-daemon form of {@link RelayRtcOfferFrame}. The relay stamps both
537
432
  * identity fields; an unstamped offer is rejected as an outdated relay. */
538
433
  export const RelayStampedRtcOfferFrame = S.Struct({
539
- type: S.Literal("rtc_offer"),
540
- channel_id: ChannelId,
541
- key_id: S.String,
542
- sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
543
- fingerprint_proof: S.String.check(
544
- S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX),
545
- ),
546
- team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
547
- peer_user_id: S.String,
548
- consumer: S.Literals(["browser", "daemon"]),
434
+ type: S.Literal("rtc_offer"),
435
+ channel_id: ChannelId,
436
+ key_id: S.String,
437
+ sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
438
+ fingerprint_proof: S.String.check(S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX)),
439
+ team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
440
+ peer_user_id: S.String,
441
+ consumer: S.Literals(["browser", "daemon"]),
549
442
  });
550
- export type TRelayStampedRtcOfferFrame = S.Schema.Type<
551
- typeof RelayStampedRtcOfferFrame
552
- >;
553
-
554
443
  /** serving daemon → relay → consumer. Answer the offer for `channel_id`. */
555
444
  export const RelayRtcAnswerFrame = S.Struct({
556
- type: S.Literal("rtc_answer"),
557
- channel_id: ChannelId,
558
- sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
559
- fingerprint_proof: S.String.check(
560
- S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX),
561
- ),
445
+ type: S.Literal("rtc_answer"),
446
+ channel_id: ChannelId,
447
+ sdp: S.String.check(S.isMaxLength(RTC_SDP_MAX)),
448
+ fingerprint_proof: S.String.check(S.isMaxLength(RTC_FINGERPRINT_PROOF_B64_MAX)),
562
449
  });
563
- export type TRelayRtcAnswerFrame = S.Schema.Type<typeof RelayRtcAnswerFrame>;
564
-
565
450
  /** Both directions. One trickle ICE candidate for `channel_id`. `candidate` is
566
451
  * a JSON-serialized `RTCIceCandidateInit` object (stringified by the sender,
567
452
  * `JSON.parse`'d by the receiver) — preferred over a raw SDP candidate line
568
453
  * for browser/werift field parity (`candidate`/`sdpMid`/`sdpMLineIndex`/…). */
569
454
  export const RelayRtcIceFrame = S.Struct({
570
- type: S.Literal("rtc_ice"),
571
- channel_id: ChannelId,
572
- candidate: S.String.check(S.isMaxLength(RTC_ICE_CANDIDATE_MAX)),
455
+ type: S.Literal("rtc_ice"),
456
+ channel_id: ChannelId,
457
+ candidate: S.String.check(S.isMaxLength(RTC_ICE_CANDIDATE_MAX)),
573
458
  });
574
- export type TRelayRtcIceFrame = S.Schema.Type<typeof RelayRtcIceFrame>;
575
-
576
459
  /** Why a serving daemon refused an `rtc_offer`. `seedgate` = the vault DEK is
577
460
  * locked (retry after unlock); `overloaded` = transient session cap (retry
578
461
  * soon); `disabled` / `not_capable` / `handshake_failed` = daemon posture or
@@ -581,67 +464,55 @@ export type TRelayRtcIceFrame = S.Schema.Type<typeof RelayRtcIceFrame>;
581
464
  * daemon X25519 key; consumers should refresh the cloud identity projection.
582
465
  * `daemon_outdated` means a relay or daemon omitted a required current stamp. */
583
466
  export const RtcNackReason = S.Literals([
584
- "seedgate",
585
- "overloaded",
586
- "disabled",
587
- "not_capable",
588
- "handshake_failed",
589
- "proof_open_failed",
590
- "daemon_outdated",
467
+ "seedgate",
468
+ "overloaded",
469
+ "disabled",
470
+ "not_capable",
471
+ "handshake_failed",
472
+ "proof_open_failed",
473
+ "daemon_outdated",
591
474
  ]);
592
- export type TRtcNackReason = S.Schema.Type<typeof RtcNackReason>;
593
-
594
475
  /** Normalize a forward-compatible peer refusal to a generic retryable refusal. */
595
- export const normalizeRtcNackReason = (reason: string): TRtcNackReason => {
596
- switch (reason) {
597
- case "seedgate":
598
- case "overloaded":
599
- case "disabled":
600
- case "not_capable":
601
- case "handshake_failed":
602
- case "proof_open_failed":
603
- case "daemon_outdated":
604
- return reason;
605
- default:
606
- return "overloaded";
607
- }
476
+ export const normalizeRtcNackReason = (reason) => {
477
+ switch (reason) {
478
+ case "seedgate":
479
+ case "overloaded":
480
+ case "disabled":
481
+ case "not_capable":
482
+ case "handshake_failed":
483
+ case "proof_open_failed":
484
+ case "daemon_outdated":
485
+ return reason;
486
+ default:
487
+ return "overloaded";
488
+ }
608
489
  };
609
-
610
490
  /** serving daemon or relay → consumer. Refuse the offer for `channel_id` —
611
491
  * the explicit non-silent reject so the offerer fails fast instead of
612
492
  * waiting out the signaling/ICE timeout. */
613
493
  export const RelayRtcNackFrame = S.Struct({
614
- type: S.Literal("rtc_nack"),
615
- channel_id: ChannelId,
616
- /**
617
- * Free-string on the wire so a newer daemon refusal stays decodable. Known
618
- * values live in {@link RtcNackReason}; unrecognized values are generic,
619
- * non-cacheable refusals to consumers.
620
- */
621
- reason: RelayFreeString,
494
+ type: S.Literal("rtc_nack"),
495
+ channel_id: ChannelId,
496
+ /**
497
+ * Free-string on the wire so a newer daemon refusal stays decodable. Known
498
+ * values live in {@link RtcNackReason}; unrecognized values are generic,
499
+ * non-cacheable refusals to consumers.
500
+ */
501
+ reason: RelayFreeString,
622
502
  });
623
- export type TRelayRtcNackFrame = S.Schema.Type<typeof RelayRtcNackFrame>;
624
-
625
503
  /** relay → every client. This box is superseded (a newer relay deploy is
626
504
  * accepting): move to the box `/api/daemon/channel` now returns. The box
627
505
  * admits no new work, finishes in-flight channels, then closes each socket
628
506
  * with {@link RELAY_MOVED_CLOSE_CODE}. Old clients drop the unknown frame and
629
507
  * move on that close. See `docs/plans/relay-handover.md`. */
630
508
  export const RelayMovedFrame = S.Struct({ type: S.Literal("relay_moved") });
631
- export type TRelayMovedFrame = S.Schema.Type<typeof RelayMovedFrame>;
632
-
633
509
  /** Close code of a retired box's socket: reconnect immediately (no backoff).
634
510
  * Distinct from 4000 `superseded`, so it never triggers daemon stand-down. */
635
511
  export const RELAY_MOVED_CLOSE_CODE = 4010;
636
-
637
512
  /** Keepalive (both directions). The relay pings below Cloudflare's
638
513
  * proxied-WS idle bound; a missed pong is the relay's dead-peer signal. */
639
514
  export const RelayPingFrame = S.Struct({ type: S.Literal("ping") });
640
- export type TRelayPingFrame = S.Schema.Type<typeof RelayPingFrame>;
641
-
642
515
  export const RelayPongFrame = S.Struct({ type: S.Literal("pong") });
643
- export type TRelayPongFrame = S.Schema.Type<typeof RelayPongFrame>;
644
-
645
516
  /**
646
517
  * daemon → relay → watcher. Explicit subscription-auth FSM (`auth.ts`).
647
518
  *
@@ -655,12 +526,10 @@ export type TRelayPongFrame = S.Schema.Type<typeof RelayPongFrame>;
655
526
  * parse it even before they route it.
656
527
  */
657
528
  export const RelayAuthFrame = S.Struct({
658
- type: S.Literal("auth"),
659
- key_id: S.String,
660
- auth: AuthEvent,
529
+ type: S.Literal("auth"),
530
+ key_id: S.String,
531
+ auth: AuthEvent,
661
532
  });
662
- export type TRelayAuthFrame = S.Schema.Type<typeof RelayAuthFrame>;
663
-
664
533
  // NOTE: older daemon binaries also sent `received` (a per-command delivery
665
534
  // receipt) and `resync` (a periodic "re-push my pending rows" floor). Both are
666
535
  // retired — there is no durable mailbox to redeliver from anymore — so neither
@@ -668,7 +537,6 @@ export type TRelayAuthFrame = S.Schema.Type<typeof RelayAuthFrame>;
668
537
  // fail decode and are silently dropped (`parseFrame` → null), the designed
669
538
  // legacy tolerance. The same silent-drop applies to any unknown `type` (e.g. a
670
539
  // future `rtc_*` peer talking to an older relay, or vice versa).
671
-
672
540
  /** The full frame union, discriminated on `type`. `command_lifecycle` (relay →
673
541
  * watcher) is the stateless-relay command receipt: the relay forwards the
674
542
  * daemon's terminal `ack` to the originating watcher as a live lifecycle
@@ -677,26 +545,25 @@ export type TRelayAuthFrame = S.Schema.Type<typeof RelayAuthFrame>;
677
545
  * `docs/proposals/daemon-owned-state-stateless-relay.md`. `auth` (daemon →
678
546
  * relay → watcher) is the subscription-login FSM; it is not a CommandState. */
679
547
  export const RelayFrame = S.Union([
680
- RelayHelloFrame,
681
- RelayWelcomeFrame,
682
- RelayCommandFrame,
683
- RelayAckFrame,
684
- RelayStatusFrame,
685
- RelayEnqueueFrame,
686
- RelayEnqueueAckFrame,
687
- RelayStatusPushFrame,
688
- RelayPresenceFrame,
689
- RelayCommandLifecycleFrame,
690
- RelayAuthFrame,
691
- RelayChannelOpenFrame,
692
- RelayChannelOpenAckFrame,
693
- RelayChannelCloseFrame,
694
- RelayRtcOfferFrame,
695
- RelayRtcAnswerFrame,
696
- RelayRtcIceFrame,
697
- RelayRtcNackFrame,
698
- RelayMovedFrame,
699
- RelayPingFrame,
700
- RelayPongFrame,
548
+ RelayHelloFrame,
549
+ RelayWelcomeFrame,
550
+ RelayCommandFrame,
551
+ RelayAckFrame,
552
+ RelayStatusFrame,
553
+ RelayEnqueueFrame,
554
+ RelayEnqueueAckFrame,
555
+ RelayStatusPushFrame,
556
+ RelayPresenceFrame,
557
+ RelayCommandLifecycleFrame,
558
+ RelayAuthFrame,
559
+ RelayChannelOpenFrame,
560
+ RelayChannelOpenAckFrame,
561
+ RelayChannelCloseFrame,
562
+ RelayRtcOfferFrame,
563
+ RelayRtcAnswerFrame,
564
+ RelayRtcIceFrame,
565
+ RelayRtcNackFrame,
566
+ RelayMovedFrame,
567
+ RelayPingFrame,
568
+ RelayPongFrame,
701
569
  ]);
702
- export type TRelayFrame = S.Schema.Type<typeof RelayFrame>;