@openllmsh/sdk 2.10.12-alpha.1 → 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
@@ -0,0 +1,595 @@
1
+ /**
2
+ * Binary mux payload vocabulary.
3
+ *
4
+ * Binary mux frames are deliberately outside `RelayFrame`: the relay routes on
5
+ * the 9-byte header (defined by `@openllmsh/sdk/tunnel/codec`) and never imports
6
+ * these payload schemas. The 16-byte channel-id envelope (`mux2`) tags each
7
+ * binary message, so one WebSocket can carry several channels concurrently.
8
+ */
9
+ import { Schema as S } from "effect";
10
+ import * as Result from "effect/Result";
11
+ import { AgentStreamOpenPayload } from "./agent.js";
12
+ import { HOP_GRANT_B64_MAX } from "./hop-grant.js";
13
+ import { OPENLLM_CHAIN_HEADER, OPENLLM_RESOLVED_MODEL_HEADER, } from "./inference-headers.js";
14
+ import { RealtimeStreamOpenPayload } from "./realtime.js";
15
+ import { TEAM_GRANT_B64_MAX } from "./team-grant.js";
16
+ /**
17
+ * Capability advertising support for the binary mux wire format: the 16-byte
18
+ * channel-UUID envelope (`@openllmsh/sdk/tunnel` `channel-envelope.ts`) wrapping
19
+ * each binary WebSocket message, so one relay socket can carry several channels
20
+ * (one per (consumer, serving) pair). The wire string stays `"mux2"` — the
21
+ * legacy `"mux1"` single-channel framing has been removed entirely.
22
+ */
23
+ export const MUX_CAP = "mux2";
24
+ /** Returns whether an open-vocabulary capability list advertises mux support. */
25
+ export const hasMuxCap = (caps) => caps?.includes(MUX_CAP) ?? false;
26
+ /**
27
+ * Capability advertising WebRTC data-channel mux hosting (browser ↔ daemon).
28
+ * Layered on by the daemon when RTC responder support is compiled in.
29
+ */
30
+ export const RTC_CAP = "rtc1";
31
+ /** Cross-user team RTC admission (outer + sealed team grant required). */
32
+ export const TEAM_RTC_CAP = "team-rtc1";
33
+ /** Returns whether an open-vocabulary capability list advertises RTC support. */
34
+ export const hasRtcCap = (caps) => caps?.includes(RTC_CAP) ?? false;
35
+ /**
36
+ * Capability advertising seed-gated device-grant enforcement on channel /
37
+ * tunnel / RTC open. Layered on by the daemon when a device-access pubkey is
38
+ * pinned from bootstrap.
39
+ */
40
+ export const SEEDGATE_CAP = "seedgate1";
41
+ /**
42
+ * Daemon can serve team-shared inference (verifies origin team grants, local
43
+ * cap, kill switch). Advertised on bootstrap caps, mux hello, and
44
+ * `DaemonStatus.control_caps`. Older daemons omit it and are never offered as
45
+ * contributors.
46
+ */
47
+ export const TEAM_SERVE_CAP = "team_serve";
48
+ /** Returns whether an open-vocabulary capability list advertises seedgate. */
49
+ export const hasSeedgateCap = (caps) => caps?.includes(SEEDGATE_CAP) ?? false;
50
+ /**
51
+ * HTTP media over the existing mux `kind:"tunnel"` stream (STT / TTS / image
52
+ * generations / image edits). Old peers omit this; consumers MUST fail closed
53
+ * before OPEN rather than send unknown surfaces.
54
+ *
55
+ * Advertisement is owned by the daemon hello/status list and MUST stay off
56
+ * until the listener/walker actually serves these surfaces.
57
+ */
58
+ export const MEDIA_HTTP_CAP = "media1";
59
+ export const hasMediaHttpCap = (caps) => caps?.includes(MEDIA_HTTP_CAP) ?? false;
60
+ /**
61
+ * POST `/v1/videos` (create job) over mux `kind:"tunnel"`. Distinct from
62
+ * `media1` so a media1-only daemon never receives `video_create` OPEN.
63
+ * Consumers MUST check {@link hasMediaHttpVideoCap} before OPEN.
64
+ * GET poll/content stay off the mux (POST-only).
65
+ */
66
+ export const MEDIA_HTTP_VIDEO_CAP = "media2";
67
+ export const hasMediaHttpVideoCap = (caps) => caps?.includes(MEDIA_HTTP_VIDEO_CAP) ?? false;
68
+ /**
69
+ * The dedicated duplex realtime mux kind (`kind:"realtime"` in
70
+ * {@link StreamOpenPayload}, vocabulary in `./realtime`). A distinct kind
71
+ * from `kind:"tunnel"` (request/response HTTP) and `kind:"agent"` —
72
+ * never overload either for a long-lived bidirectional voice session.
73
+ *
74
+ * NOT YET ADVERTISED: a daemon must add this to its capability list only
75
+ * once (a) a provider delegate actually exposes `credentialForRealtime` and
76
+ * (b) the local runtime path (dial → translate → bound) is wired end to
77
+ * end. An old/unadvertising peer's `kind:"realtime"` OPEN still gets a
78
+ * typed `realtime_unsupported` RESET before any session work starts — "old
79
+ * peer fails before OPEN" is a CONSUMER-side responsibility (check
80
+ * `hasRealtimeDuplexCap` on the peer's caps before calling
81
+ * `@openllmsh/sdk/tunnel/streams`'s `realtimeStream`), not something the wire
82
+ * format itself can enforce.
83
+ */
84
+ export const REALTIME_DUPLEX_CAP = "realtime1";
85
+ export const hasRealtimeDuplexCap = (caps) => caps?.includes(REALTIME_DUPLEX_CAP) ?? false;
86
+ /**
87
+ * Bounded capture for tunneled media HTTP bodies (multipart/binary). Distinct
88
+ * from media-persistence limits. Daemon/cloud request readers should import
89
+ * this rather than duplicating the literal.
90
+ */
91
+ export const TUNNEL_MEDIA_MAX_BODY_BYTES = 20 * 1024 * 1024;
92
+ /**
93
+ * Normalizes an optional relay version for observability only. Feature gating is
94
+ * capability-based, never version-based.
95
+ */
96
+ export const relayProtocolVersionOf = (frame) => frame.protocol_version ?? 1;
97
+ /** The `/v1` surface a tunneled request targets. A closed vocabulary — the
98
+ * serving daemon maps it to its OWN local endpoint path, so no free URL path
99
+ * ever crosses the relay (mirrors the listener's surface discriminator).
100
+ *
101
+ * Validated by the SERVING DAEMON at stream open (mux); the relay never
102
+ * decodes it.
103
+ */
104
+ export const TunnelSurface = S.Literals([
105
+ "chat_completions",
106
+ "messages",
107
+ "responses",
108
+ "responses_compact",
109
+ "audio_transcriptions",
110
+ "audio_speech",
111
+ "images_generations",
112
+ "images_edits",
113
+ "video_create",
114
+ "video_retrieve",
115
+ "video_content",
116
+ ]);
117
+ export const MEDIA_HTTP_TUNNEL_SURFACES = [
118
+ "audio_transcriptions",
119
+ "audio_speech",
120
+ "images_generations",
121
+ "images_edits",
122
+ "video_create",
123
+ ];
124
+ export const isMediaHttpTunnelSurface = (surface) => MEDIA_HTTP_TUNNEL_SURFACES.includes(surface);
125
+ export const requiredMediaHttpCap = (surface) => {
126
+ if (surface === "video_create" ||
127
+ surface === "video_retrieve" ||
128
+ surface === "video_content") {
129
+ return MEDIA_HTTP_VIDEO_CAP;
130
+ }
131
+ if (isMediaHttpTunnelSurface(surface))
132
+ return MEDIA_HTTP_CAP;
133
+ return null;
134
+ };
135
+ /** Fail closed: never OPEN a media surface the peer has not advertised. */
136
+ export const peerSupportsTunnelSurface = (caps, surface) => {
137
+ const required = requiredMediaHttpCap(surface);
138
+ if (required === null)
139
+ return true;
140
+ return caps?.includes(required) ?? false;
141
+ };
142
+ const TUNNEL_CONTENT_TYPE_MAX = 256;
143
+ export const ALLOWED_TUNNEL_ACCEPT = [
144
+ "application/json",
145
+ "text/event-stream",
146
+ "audio/mpeg",
147
+ "audio/wav",
148
+ "audio/l16",
149
+ "application/octet-stream",
150
+ "image/png",
151
+ "image/jpeg",
152
+ "image/webp",
153
+ "video/mp4",
154
+ ];
155
+ /**
156
+ * Parse `name=value` / `name="quoted"` Content-Type parameters. Rejects CRLF,
157
+ * NUL, empty names, and duplicate keys (including duplicate `boundary`).
158
+ */
159
+ const contentTypeParams = (rest) => {
160
+ const params = new Map();
161
+ let i = 0;
162
+ while (i < rest.length) {
163
+ while (rest[i] === " " || rest[i] === "\t")
164
+ i += 1;
165
+ if (i >= rest.length)
166
+ break;
167
+ const eq = rest.indexOf("=", i);
168
+ if (eq < 0)
169
+ return null;
170
+ const name = rest.slice(i, eq).trim().toLowerCase();
171
+ if (name === "" || name.includes("\r") || name.includes("\n"))
172
+ return null;
173
+ if (params.has(name))
174
+ return null;
175
+ i = eq + 1;
176
+ if (rest[i] === '"') {
177
+ i += 1;
178
+ let value = "";
179
+ while (i < rest.length) {
180
+ const ch = rest[i];
181
+ if (ch === "\\") {
182
+ i += 1;
183
+ if (i >= rest.length)
184
+ return null;
185
+ value += rest[i];
186
+ i += 1;
187
+ continue;
188
+ }
189
+ if (ch === '"') {
190
+ i += 1;
191
+ break;
192
+ }
193
+ if (ch === "\r" || ch === "\n" || ch === "\0")
194
+ return null;
195
+ value += ch;
196
+ i += 1;
197
+ }
198
+ params.set(name, value);
199
+ }
200
+ else {
201
+ const semi = rest.indexOf(";", i);
202
+ const end = semi < 0 ? rest.length : semi;
203
+ const value = rest.slice(i, end).trim();
204
+ if (value === "" ||
205
+ value.includes("\r") ||
206
+ value.includes("\n") ||
207
+ value.includes("\0")) {
208
+ return null;
209
+ }
210
+ params.set(name, value);
211
+ i = end;
212
+ }
213
+ if (rest[i] === ";")
214
+ i += 1;
215
+ else if (i < rest.length && rest[i] !== " " && rest[i] !== "\t") {
216
+ return null;
217
+ }
218
+ }
219
+ return params;
220
+ };
221
+ /**
222
+ * Allowlisted request Content-Type. Multipart MUST carry exactly one
223
+ * `boundary` (quoted or token). Original spelling is preserved on success
224
+ * so the FormData delimiter in the body still matches the header.
225
+ */
226
+ export const isAllowedTunnelRequestContentType = (raw) => {
227
+ if (raw.length === 0 || raw.length > TUNNEL_CONTENT_TYPE_MAX)
228
+ return false;
229
+ if (raw.includes("\r") || raw.includes("\n") || raw.includes("\0")) {
230
+ return false;
231
+ }
232
+ const slash = raw.indexOf("/");
233
+ if (slash < 0)
234
+ return false;
235
+ const semi = raw.indexOf(";");
236
+ const type = (semi < 0 ? raw : raw.slice(0, semi)).trim().toLowerCase();
237
+ const params = semi < 0
238
+ ? new Map()
239
+ : contentTypeParams(raw.slice(semi + 1));
240
+ if (params === null)
241
+ return false;
242
+ if (type === "application/json") {
243
+ const charset = params.get("charset");
244
+ if (charset !== undefined && charset.toLowerCase() !== "utf-8")
245
+ return false;
246
+ for (const key of params.keys()) {
247
+ if (key !== "charset")
248
+ return false;
249
+ }
250
+ return true;
251
+ }
252
+ if (type === "application/octet-stream") {
253
+ return params.size === 0;
254
+ }
255
+ if (type === "multipart/form-data") {
256
+ const boundary = params.get("boundary");
257
+ if (boundary === undefined || boundary === "")
258
+ return false;
259
+ for (const key of params.keys()) {
260
+ if (key !== "boundary")
261
+ return false;
262
+ }
263
+ return true;
264
+ }
265
+ return false;
266
+ };
267
+ export const TunnelAccept = S.Literals(ALLOWED_TUNNEL_ACCEPT);
268
+ export const TunnelRequestContentType = S.String.check(S.isMaxLength(TUNNEL_CONTENT_TYPE_MAX), S.makeFilter(isAllowedTunnelRequestContentType, {
269
+ message: "unsupported tunnel content-type",
270
+ }));
271
+ /** Speech persistence is daemon-owned unless the browser opts in and receives
272
+ * this acknowledgement. Internal HTTP names bridge the closed mux metadata;
273
+ * the request header is never forwarded to the cloud or provider. */
274
+ export const MEDIA_PERSISTENCE_REQUEST_HEADER = "x-openllm-media-persistence";
275
+ export const MEDIA_PERSISTENCE_RESPONSE_HEADER = "x-openllm-media-persistence-ack";
276
+ export const MEDIA_PERSISTENCE_BROWSER = "browser";
277
+ export const MEDIA_URL_RESPONSE_HEADER = "x-openllm-media-url";
278
+ export const TUNNEL_MEDIA_URL_MAX_LENGTH = 2048;
279
+ /**
280
+ * Why a durable media URL is ABSENT from an otherwise successful media
281
+ * response. Presence of {@link MEDIA_URL_RESPONSE_HEADER} is the ONLY proof
282
+ * that the cloud library row exists; this header is what separates a serving
283
+ * daemon that tried to persist and failed from one that never advertises
284
+ * durability at all (an older daemon, or a surface that hands persistence to
285
+ * the browser). Without it a consumer cannot tell a dead promise apart from
286
+ * an unsupported one.
287
+ *
288
+ * Deliberately a CLOSED set of coarse categories: no URLs, no credentials,
289
+ * no provider payloads, no byte counts — the value crosses the relay and is
290
+ * shown to a model, so it carries a reason and nothing else.
291
+ */
292
+ export const MEDIA_ERROR_RESPONSE_HEADER = "x-openllm-media-error";
293
+ export const MEDIA_PERSIST_ERRORS = [
294
+ /** The cloud ingest answered, but not with success. */
295
+ "ingest_rejected",
296
+ /** Transport never reached a usable ingest response. */
297
+ "ingest_unreachable",
298
+ /** Ingest exceeded the daemon's upload budget. */
299
+ "ingest_timeout",
300
+ /** Ingest answered 2xx with a body the daemon could not trust. */
301
+ "ingest_invalid_response",
302
+ /** Persistence failed for an uncategorized reason. */
303
+ "ingest_failed",
304
+ ];
305
+ export const MediaPersistError = S.Literals(MEDIA_PERSIST_ERRORS);
306
+ const isMediaPersistError = (value) => MEDIA_PERSIST_ERRORS.includes(value);
307
+ /** The ONLY request headers a consumer may forward — a closed struct, not a
308
+ * free map, per the relay's reviewable-vocabulary posture. Everything else
309
+ * (auth, plan params) is the serving daemon's own business.
310
+ *
311
+ * Validated by the SERVING DAEMON at stream open (mux); the relay never
312
+ * decodes it.
313
+ */
314
+ export const TunnelForwardHeaders = S.Struct({
315
+ media_persistence: S.optional(S.Literal(MEDIA_PERSISTENCE_BROWSER)),
316
+ content_type: S.optional(TunnelRequestContentType),
317
+ accept: S.optional(TunnelAccept),
318
+ anthropic_version: S.optional(S.String.check(S.isMaxLength(32))),
319
+ // Preserve whole flags; the mux codec bounds the complete OPEN payload.
320
+ anthropic_beta: S.optional(S.String),
321
+ user_agent: S.optional(S.String.check(S.isMaxLength(512))),
322
+ /** Opaque video job id for GET retrieve/content mux follow-up. */
323
+ video_id: S.optional(S.String.check(S.isMaxLength(256), S.isPattern(/^[A-Za-z0-9._-]+$/))),
324
+ /**
325
+ * Origin-signed team grant for this request. Mapped to
326
+ * `x-openllm-team-grant` on the in-process `/v1` Request; the serving
327
+ * daemon re-verifies model / local cap / kill switch. Same-user hops omit it.
328
+ */
329
+ team_grant: S.optional(S.String.check(S.isMaxLength(TEAM_GRANT_B64_MAX))),
330
+ /**
331
+ * Origin-signed hop grant for a capped key's request. Mapped to
332
+ * `x-openllm-hop-grant` on the in-process `/v1` Request; the serving
333
+ * daemon forwards it on its plan fetch, which returns the one granted hop
334
+ * bound to the key's cap hold. Uncapped keys omit it.
335
+ */
336
+ hop_grant: S.optional(S.String.check(S.isMaxLength(HOP_GRANT_B64_MAX))),
337
+ });
338
+ /** Response metadata carried by the mux `res_head` CTRL payload.
339
+ *
340
+ * Validated by the SERVING DAEMON at stream open (mux); the relay never
341
+ * decodes it.
342
+ */
343
+ export const TUNNEL_RESOLVED_MODEL_MAX = 256;
344
+ export const TUNNEL_CHAIN_MAX = 4096;
345
+ export const TunnelResponseHeaders = S.Struct({
346
+ media_url: S.optional(S.String.check(S.isMaxLength(TUNNEL_MEDIA_URL_MAX_LENGTH))),
347
+ media_persistence: S.optional(S.Literal(MEDIA_PERSISTENCE_BROWSER)),
348
+ /** Why `media_url` is absent — see {@link MEDIA_ERROR_RESPONSE_HEADER}. */
349
+ media_error: S.optional(MediaPersistError),
350
+ content_type: S.optional(S.String.check(S.isMaxLength(128))),
351
+ is_sse: S.optional(S.Boolean),
352
+ /** Winning hop id — maps to {@link OPENLLM_RESOLVED_MODEL_HEADER}. */
353
+ resolved_model: S.optional(S.String.check(S.isMaxLength(TUNNEL_RESOLVED_MODEL_MAX))),
354
+ /** Comma-separated attempted hops — maps to {@link OPENLLM_CHAIN_HEADER}. */
355
+ chain: S.optional(S.String.check(S.isMaxLength(TUNNEL_CHAIN_MAX))),
356
+ });
357
+ const boundedOptional = (value, max) => {
358
+ if (value === null || value.length === 0 || value.length > max)
359
+ return undefined;
360
+ return value;
361
+ };
362
+ /** Copy closed mux res_head fields onto an HTTP Headers object. */
363
+ export const applyTunnelResponseHeadersToHttp = (headers, res) => {
364
+ if (res.media_url !== undefined) {
365
+ headers.set(MEDIA_URL_RESPONSE_HEADER, res.media_url);
366
+ }
367
+ if (res.media_persistence === MEDIA_PERSISTENCE_BROWSER) {
368
+ headers.set(MEDIA_PERSISTENCE_RESPONSE_HEADER, MEDIA_PERSISTENCE_BROWSER);
369
+ }
370
+ if (res.media_error !== undefined) {
371
+ headers.set(MEDIA_ERROR_RESPONSE_HEADER, res.media_error);
372
+ }
373
+ if (res.content_type !== undefined) {
374
+ headers.set("content-type", res.content_type);
375
+ }
376
+ if (res.resolved_model !== undefined) {
377
+ headers.set(OPENLLM_RESOLVED_MODEL_HEADER, res.resolved_model);
378
+ }
379
+ if (res.chain !== undefined) {
380
+ headers.set(OPENLLM_CHAIN_HEADER, res.chain);
381
+ }
382
+ };
383
+ /** Project HTTP response headers onto the closed mux res_head struct. */
384
+ export const tunnelResponseHeadersFromHttp = (headers) => {
385
+ const contentType = headers.get("content-type") ?? undefined;
386
+ const mediaUrl = boundedOptional(headers.get(MEDIA_URL_RESPONSE_HEADER), TUNNEL_MEDIA_URL_MAX_LENGTH);
387
+ const resolved = boundedOptional(headers.get(OPENLLM_RESOLVED_MODEL_HEADER), TUNNEL_RESOLVED_MODEL_MAX);
388
+ const chain = boundedOptional(headers.get(OPENLLM_CHAIN_HEADER), TUNNEL_CHAIN_MAX);
389
+ const mediaError = headers.get(MEDIA_ERROR_RESPONSE_HEADER);
390
+ return {
391
+ ...(mediaUrl === undefined ? {} : { media_url: mediaUrl }),
392
+ ...(mediaError !== null && isMediaPersistError(mediaError)
393
+ ? { media_error: mediaError }
394
+ : {}),
395
+ ...(headers.get(MEDIA_PERSISTENCE_RESPONSE_HEADER) ===
396
+ MEDIA_PERSISTENCE_BROWSER
397
+ ? { media_persistence: MEDIA_PERSISTENCE_BROWSER }
398
+ : {}),
399
+ ...(contentType === undefined
400
+ ? {}
401
+ : { content_type: contentType.slice(0, 128) }),
402
+ is_sse: contentType?.includes("text/event-stream") === true,
403
+ ...(resolved === undefined ? {} : { resolved_model: resolved }),
404
+ ...(chain === undefined ? {} : { chain }),
405
+ };
406
+ };
407
+ /** A channel-level admission failure. */
408
+ export const ChannelOpenError = S.Literals([
409
+ "daemon_offline",
410
+ "not_capable",
411
+ "unauthorized",
412
+ "channel_exists",
413
+ "overloaded",
414
+ ]);
415
+ /** A channel-level teardown reason. */
416
+ export const ChannelCloseReason = S.Literals([
417
+ "done",
418
+ "channel_exists",
419
+ "consumer_gone",
420
+ "daemon_gone",
421
+ "relay_restart",
422
+ "protocol_error",
423
+ "overloaded",
424
+ ]);
425
+ /** Consumer-initiated inference stream OPEN payload. */
426
+ export const TunnelStreamOpenPayload = S.Struct({
427
+ kind: S.Literal("tunnel"),
428
+ method: S.Literal("POST"),
429
+ surface: TunnelSurface,
430
+ headers: S.optional(TunnelForwardHeaders),
431
+ consumer: S.optional(S.Literals(["browser", "daemon"])),
432
+ });
433
+ /** JSON payload of a mux OPEN frame. */
434
+ export const StreamOpenPayload = S.Union([
435
+ TunnelStreamOpenPayload,
436
+ AgentStreamOpenPayload,
437
+ RealtimeStreamOpenPayload,
438
+ ]);
439
+ /** JSON payload of a mux CTRL frame. Unknown control tags are intentionally
440
+ * not accepted here so callers can drop them for forward compatibility. */
441
+ export const StreamCtrlPayload = S.Union([
442
+ S.Struct({
443
+ t: S.Literal("open_ack"),
444
+ ok: S.Boolean,
445
+ live: S.optional(S.Boolean),
446
+ /** Daemon-minted, monotonically increasing stream-open generation. */
447
+ generation: S.optional(S.Number.check(S.isInt(), S.isGreaterThanOrEqualTo(0))),
448
+ initial_credit: S.optional(S.Number.check(S.isInt(), S.isGreaterThanOrEqualTo(0))),
449
+ /** Present on nacks (`ok:false`) — same vocabulary as `StreamResetCode`
450
+ * open failures (`agent_unavailable`, `realtime_busy`, …). */
451
+ error: S.optional(S.String.check(S.isMaxLength(64))),
452
+ message: S.optional(S.String.check(S.isMaxLength(256))),
453
+ }),
454
+ S.Struct({
455
+ t: S.Literal("res_head"),
456
+ status: S.Number.check(S.isInt(), S.isBetween({ minimum: 200, maximum: 599 })),
457
+ res_headers: S.optional(TunnelResponseHeaders),
458
+ }),
459
+ /** End of an attach replay (an agent `attach` re-emits prior events, then
460
+ * this marker). */
461
+ S.Struct({ t: S.Literal("replay_done") }),
462
+ /** Browser device-session visibility; ignored by daemons predating it. */
463
+ S.Struct({ t: S.Literal("focus") }),
464
+ S.Struct({ t: S.Literal("blur") }),
465
+ S.Struct({ t: S.Literal("close"), intent: S.Literals(["detach", "kill"]) }),
466
+ /** Realtime (`kind:"realtime"`) liveness — either peer may send this while
467
+ * NDJSON event traffic is naturally quiet (e.g. waiting on the user).
468
+ * Carries no data; its arrival IS the signal. */
469
+ S.Struct({ t: S.Literal("heartbeat") }),
470
+ ]);
471
+ /** Per-stream failure codes. Channel admission errors deliberately do not live
472
+ * here; those use `ChannelOpenError`. A CLOSED vocabulary that only grows:
473
+ * retired PTY codes stay so old peers keep decoding what they receive. */
474
+ export const StreamResetCode = S.Literals([
475
+ "tunnel_refused",
476
+ "tunnel_busy",
477
+ "invalid_tunnel",
478
+ "overloaded",
479
+ /** Retired PTY mirroring. A legacy `kind:"session"` OPEN is reset with
480
+ * this code (old browsers already decode it). */
481
+ "pty_unsupported",
482
+ "cli_not_installed",
483
+ "session_not_found",
484
+ "session_busy",
485
+ "spawn_failed",
486
+ "dispatch_failed",
487
+ "timeout",
488
+ "protocol_error",
489
+ "peer_gone",
490
+ /** The consumer fell behind the daemon's bounded session-output queue. */
491
+ "lagging",
492
+ /** Retired: remote PTY sessions used to be opt-in. Kept so old peers decode. */
493
+ "sessions_disabled",
494
+ /** This daemon does not (yet) serve `kind:"realtime"` — no provider
495
+ * delegate exposes `credentialForRealtime`, or the runtime path isn't
496
+ * wired. Mirrors `pty_unsupported`. */
497
+ "realtime_unsupported",
498
+ /** Max concurrent realtime sessions reached on this daemon. Mirrors
499
+ * `tunnel_busy` / `session_busy`. */
500
+ "realtime_busy",
501
+ /** Admission refused for a reason OTHER than capacity — no credential
502
+ * available (stale refresh, not logged in), or the vendor connection
503
+ * itself failed before any event was exchanged. Retryable after the
504
+ * underlying cause (e.g. re-login) clears. */
505
+ "realtime_refused",
506
+ /** The cloud's signed plan for this OPEN's `provider`/`model` was missing,
507
+ * unsigned/tampered, unreachable, or did not resolve to exactly that hop —
508
+ * the same account/entitlement gate every other subscription surface
509
+ * (`planSignatureOk`) enforces before a vendor dial. Distinct from
510
+ * `realtime_refused` (a credential-layer failure): this is a POLICY
511
+ * refusal, and it fires before the daemon ever asks its delegate for a
512
+ * credential. Never retryable by simply reconnecting — the caller needs a
513
+ * plan the cloud actually signed for this provider/model. */
514
+ "realtime_policy_refused",
515
+ /** A seed-gated stream kind (`agent`) opened on a channel whose consumer
516
+ * presented no valid device grant. Unlock the vault, then retry. */
517
+ "unauthorized",
518
+ /** This daemon advertises no agent engine handler (or it is not wired). */
519
+ "agent_unavailable",
520
+ /** Max concurrent agent sessions reached on this daemon. */
521
+ "agent_busy",
522
+ /** The daemon's device-control pin is not anchored (first-use / legacy, or
523
+ * no install anchor): agent sessions fail closed. Fix with "Set up device
524
+ * sessions" (`openllm login sk-llm-<key>.<anchor>`). */
525
+ "device_not_anchored",
526
+ /** Retired: older daemons emitted this when a separate enabled flag was off.
527
+ * Current daemons only emit `device_not_anchored` (sessions on == anchor).
528
+ * Kept in the closed vocabulary so old peers still decode. */
529
+ "device_sessions_disabled",
530
+ ]);
531
+ /** JSON payload of a mux RESET frame. */
532
+ export const StreamResetPayload = S.Struct({
533
+ code: StreamResetCode,
534
+ message: S.optional(S.String.check(S.isMaxLength(256))),
535
+ });
536
+ const parse = (schema, value) => {
537
+ const result = S.decodeUnknownResult(schema)(value);
538
+ return Result.isSuccess(result) ? result.success : null;
539
+ };
540
+ const hasOnlyKeys = (value, keys) => typeof value === "object" &&
541
+ value !== null &&
542
+ !Array.isArray(value) &&
543
+ Object.keys(value).every((key) => keys.includes(key));
544
+ /** Raw `kind` of an already-parsed OPEN JSON value, before schema decode —
545
+ * lets a host gate or retire a kind (e.g. legacy `"session"`) that the
546
+ * current {@link StreamOpenPayload} no longer accepts. */
547
+ export const streamOpenKindOf = (value) => {
548
+ if (typeof value !== "object" || value === null || Array.isArray(value))
549
+ return null;
550
+ const kind = value.kind;
551
+ return typeof kind === "string" ? kind : null;
552
+ };
553
+ /** Mux OPEN kinds that no longer exist on the wire. A host resets them with
554
+ * {@link RETIRED_STREAM_KIND_RESET} rather than a generic invalid-OPEN. */
555
+ export const RETIRED_STREAM_KINDS = new Set(["session"]);
556
+ export const RETIRED_STREAM_KIND_RESET = {
557
+ code: "pty_unsupported",
558
+ message: "remote terminal sessions were replaced by agent sessions; reload the app",
559
+ };
560
+ /** Decodes an already-parsed mux OPEN JSON value, returning null on failure. */
561
+ export const parseStreamOpenPayload = (value) => {
562
+ // Allowlist matches StreamOpenPayload union keys (tunnel + agent +
563
+ // realtime) exactly so the filter and Schema cannot disagree.
564
+ if (!hasOnlyKeys(value, [
565
+ "kind",
566
+ "method",
567
+ "surface",
568
+ "headers",
569
+ "consumer",
570
+ "provider",
571
+ "model",
572
+ "voice",
573
+ ])) {
574
+ return null;
575
+ }
576
+ if ("headers" in value &&
577
+ !hasOnlyKeys(value.headers, [
578
+ "content_type",
579
+ "accept",
580
+ "anthropic_version",
581
+ "anthropic_beta",
582
+ "user_agent",
583
+ "media_persistence",
584
+ "video_id",
585
+ "team_grant",
586
+ "hop_grant",
587
+ ])) {
588
+ return null;
589
+ }
590
+ return parse(StreamOpenPayload, value);
591
+ };
592
+ /** Decodes an already-parsed mux CTRL JSON value, returning null on failure. */
593
+ export const parseStreamCtrlPayload = (value) => parse(StreamCtrlPayload, value);
594
+ /** Decodes an already-parsed mux RESET JSON value, returning null on failure. */
595
+ export const parseStreamResetPayload = (value) => parse(StreamResetPayload, value);
@@ -1,7 +1,5 @@
1
1
  import { Schema as S } from "effect";
2
- import type { TMediaDefaultSurface } from "./media-default";
3
- import { MediaDefaultSurface } from "./media-default";
4
-
2
+ import type { TMediaDefaultSurface } from "./media-default.js";
5
3
  /**
6
4
  * The surface an EXPLICIT-model plan fetch is for.
7
5
  *
@@ -25,35 +23,23 @@ import { MediaDefaultSurface } from "./media-default";
25
23
  * behaviour — an older compiled daemon never sends it, and a plan it
26
24
  * fetches must keep working exactly as before.
27
25
  */
28
- export const PLAN_SURFACE_QUERY_KEY = "surface";
29
-
26
+ export declare const PLAN_SURFACE_QUERY_KEY = "surface";
30
27
  /** A surface a plan can be scoped to — the media-default surface set. */
31
- export const PlanSurface = MediaDefaultSurface;
28
+ export declare const PlanSurface: S.Literals<readonly ["image", "image_edit", "transcription", "speech", "video", "embeddings"]>;
32
29
  export type TPlanSurface = TMediaDefaultSurface;
33
-
34
- const decodeSurface = S.decodeUnknownResult(PlanSurface);
35
-
36
- export const encodePlanSurfaceQueryValue = (surface: TPlanSurface): string =>
37
- surface;
38
-
30
+ export declare const encodePlanSurfaceQueryValue: (surface: TPlanSurface) => string;
39
31
  /**
40
32
  * `absent` (no surface stated) and `invalid` (stated, unrecognised) are
41
33
  * deliberately different results: the first must keep the legacy default,
42
34
  * the second is our own client sending something wrong and is worth a 400
43
35
  * rather than being silently planned on the wrong surface.
44
36
  */
45
- export type TPlanSurfaceQuery =
46
- | { readonly kind: "absent" }
47
- | { readonly kind: "surface"; readonly surface: TPlanSurface }
48
- | { readonly kind: "invalid" };
49
-
50
- export const decodePlanSurfaceQuery = (
51
- params: URLSearchParams,
52
- ): TPlanSurfaceQuery => {
53
- const raw = params.get(PLAN_SURFACE_QUERY_KEY);
54
- if (raw === null || raw.length === 0) return { kind: "absent" };
55
- const decoded = decodeSurface(raw);
56
- return decoded._tag === "Success"
57
- ? { kind: "surface", surface: decoded.success }
58
- : { kind: "invalid" };
37
+ export type TPlanSurfaceQuery = {
38
+ readonly kind: "absent";
39
+ } | {
40
+ readonly kind: "surface";
41
+ readonly surface: TPlanSurface;
42
+ } | {
43
+ readonly kind: "invalid";
59
44
  };
45
+ export declare const decodePlanSurfaceQuery: (params: URLSearchParams) => TPlanSurfaceQuery;