@workerstack/clients 0.0.0-stage → 1.0.0-rc.23

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 (558) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +619 -2
  3. package/bin/honey-clients.js +94 -0
  4. package/dist/cli.d.ts +102 -0
  5. package/dist/cli.js +190 -0
  6. package/dist/emit/cli/channels.d.ts +73 -0
  7. package/dist/emit/cli/channels.js +197 -0
  8. package/dist/emit/cli/commands.d.ts +27 -0
  9. package/dist/emit/cli/commands.js +187 -0
  10. package/dist/emit/cli/discovery.d.ts +35 -0
  11. package/dist/emit/cli/discovery.js +202 -0
  12. package/dist/emit/cli/flags.d.ts +59 -0
  13. package/dist/emit/cli/flags.js +186 -0
  14. package/dist/emit/cli/index.d.ts +1 -0
  15. package/dist/emit/cli/index.js +1 -0
  16. package/dist/emit/cli/install.d.ts +37 -0
  17. package/dist/emit/cli/install.js +88 -0
  18. package/dist/emit/cli/layout.d.ts +23 -0
  19. package/dist/emit/cli/layout.js +118 -0
  20. package/dist/emit/cli/module.d.ts +30 -0
  21. package/dist/emit/cli/module.js +186 -0
  22. package/dist/emit/cli/release.d.ts +40 -0
  23. package/dist/emit/cli/release.js +183 -0
  24. package/dist/emit/cli/skills.d.ts +11 -0
  25. package/dist/emit/cli/skills.js +56 -0
  26. package/dist/emit/csharp/errors.d.ts +7 -0
  27. package/dist/emit/csharp/errors.js +69 -0
  28. package/dist/emit/csharp/index.d.ts +1 -0
  29. package/dist/emit/csharp/index.js +1 -0
  30. package/dist/emit/csharp/json.d.ts +13 -0
  31. package/dist/emit/csharp/json.js +113 -0
  32. package/dist/emit/csharp/realtime.d.ts +10 -0
  33. package/dist/emit/csharp/realtime.js +33 -0
  34. package/dist/emit/csharp/sdk-answer.d.ts +48 -0
  35. package/dist/emit/csharp/sdk-answer.js +85 -0
  36. package/dist/emit/csharp/sdk-body.d.ts +10 -0
  37. package/dist/emit/csharp/sdk-body.js +87 -0
  38. package/dist/emit/csharp/sdk-client.d.ts +32 -0
  39. package/dist/emit/csharp/sdk-client.js +177 -0
  40. package/dist/emit/csharp/sdk-csproj.d.ts +36 -0
  41. package/dist/emit/csharp/sdk-csproj.js +136 -0
  42. package/dist/emit/csharp/sdk-doc.d.ts +12 -0
  43. package/dist/emit/csharp/sdk-doc.js +35 -0
  44. package/dist/emit/csharp/sdk-method.d.ts +26 -0
  45. package/dist/emit/csharp/sdk-method.js +187 -0
  46. package/dist/emit/csharp/sdk-plan.d.ts +38 -0
  47. package/dist/emit/csharp/sdk-plan.js +1 -0
  48. package/dist/emit/csharp/sdk.d.ts +40 -0
  49. package/dist/emit/csharp/sdk.js +105 -0
  50. package/dist/emit/csharp/sse.d.ts +18 -0
  51. package/dist/emit/csharp/sse.js +29 -0
  52. package/dist/emit/csharp/transport.d.ts +11 -0
  53. package/dist/emit/csharp/transport.js +67 -0
  54. package/dist/emit/csharp/types-enum.d.ts +19 -0
  55. package/dist/emit/csharp/types-enum.js +63 -0
  56. package/dist/emit/csharp/types-names.d.ts +33 -0
  57. package/dist/emit/csharp/types-names.js +182 -0
  58. package/dist/emit/csharp/types-record.d.ts +25 -0
  59. package/dist/emit/csharp/types-record.js +65 -0
  60. package/dist/emit/csharp/types-union.d.ts +27 -0
  61. package/dist/emit/csharp/types-union.js +113 -0
  62. package/dist/emit/csharp/types.d.ts +36 -0
  63. package/dist/emit/csharp/types.js +126 -0
  64. package/dist/emit/csharp/ws.d.ts +20 -0
  65. package/dist/emit/csharp/ws.js +14 -0
  66. package/dist/emit/go/errors.d.ts +7 -0
  67. package/dist/emit/go/errors.js +44 -0
  68. package/dist/emit/go/http.d.ts +11 -0
  69. package/dist/emit/go/http.js +50 -0
  70. package/dist/emit/go/index.d.ts +1 -0
  71. package/dist/emit/go/index.js +1 -0
  72. package/dist/emit/go/module-path.d.ts +2 -0
  73. package/dist/emit/go/module-path.js +27 -0
  74. package/dist/emit/go/sdk-answer.d.ts +28 -0
  75. package/dist/emit/go/sdk-answer.js +41 -0
  76. package/dist/emit/go/sdk-body.d.ts +24 -0
  77. package/dist/emit/go/sdk-body.js +76 -0
  78. package/dist/emit/go/sdk-client.d.ts +29 -0
  79. package/dist/emit/go/sdk-client.js +141 -0
  80. package/dist/emit/go/sdk-method.d.ts +68 -0
  81. package/dist/emit/go/sdk-method.js +172 -0
  82. package/dist/emit/go/sdk-mirror.d.ts +23 -0
  83. package/dist/emit/go/sdk-mirror.js +97 -0
  84. package/dist/emit/go/sdk-opts.d.ts +55 -0
  85. package/dist/emit/go/sdk-opts.js +100 -0
  86. package/dist/emit/go/sdk.d.ts +26 -0
  87. package/dist/emit/go/sdk.js +111 -0
  88. package/dist/emit/go/sse.d.ts +16 -0
  89. package/dist/emit/go/sse.js +26 -0
  90. package/dist/emit/go/types-codec.d.ts +15 -0
  91. package/dist/emit/go/types-codec.js +171 -0
  92. package/dist/emit/go/types-names.d.ts +14 -0
  93. package/dist/emit/go/types-names.js +64 -0
  94. package/dist/emit/go/types-struct.d.ts +29 -0
  95. package/dist/emit/go/types-struct.js +65 -0
  96. package/dist/emit/go/types-union.d.ts +17 -0
  97. package/dist/emit/go/types-union.js +84 -0
  98. package/dist/emit/go/types.d.ts +32 -0
  99. package/dist/emit/go/types.js +177 -0
  100. package/dist/emit/go/ws.d.ts +12 -0
  101. package/dist/emit/go/ws.js +70 -0
  102. package/dist/emit/java/gradle.d.ts +57 -0
  103. package/dist/emit/java/gradle.js +221 -0
  104. package/dist/emit/java/index.d.ts +2 -0
  105. package/dist/emit/java/index.js +2 -0
  106. package/dist/emit/java/json.d.ts +13 -0
  107. package/dist/emit/java/json.js +84 -0
  108. package/dist/emit/java/layout-ast.d.ts +146 -0
  109. package/dist/emit/java/layout-ast.js +102 -0
  110. package/dist/emit/java/layout-decl.d.ts +20 -0
  111. package/dist/emit/java/layout-decl.js +155 -0
  112. package/dist/emit/java/layout-doc.d.ts +55 -0
  113. package/dist/emit/java/layout-doc.js +166 -0
  114. package/dist/emit/java/layout-dot.d.ts +18 -0
  115. package/dist/emit/java/layout-dot.js +127 -0
  116. package/dist/emit/java/layout-strings.d.ts +8 -0
  117. package/dist/emit/java/layout-strings.js +76 -0
  118. package/dist/emit/java/layout-types.d.ts +11 -0
  119. package/dist/emit/java/layout-types.js +95 -0
  120. package/dist/emit/java/layout-visitor.d.ts +38 -0
  121. package/dist/emit/java/layout-visitor.js +232 -0
  122. package/dist/emit/java/layout.d.ts +61 -0
  123. package/dist/emit/java/layout.js +121 -0
  124. package/dist/emit/java/models-enum.d.ts +17 -0
  125. package/dist/emit/java/models-enum.js +51 -0
  126. package/dist/emit/java/models-names.d.ts +29 -0
  127. package/dist/emit/java/models-names.js +97 -0
  128. package/dist/emit/java/models-record.d.ts +24 -0
  129. package/dist/emit/java/models-record.js +79 -0
  130. package/dist/emit/java/models-union.d.ts +27 -0
  131. package/dist/emit/java/models-union.js +86 -0
  132. package/dist/emit/java/models.d.ts +28 -0
  133. package/dist/emit/java/models.js +118 -0
  134. package/dist/emit/java/realtime.d.ts +50 -0
  135. package/dist/emit/java/realtime.js +69 -0
  136. package/dist/emit/java/sdk-client.d.ts +66 -0
  137. package/dist/emit/java/sdk-client.js +207 -0
  138. package/dist/emit/java/sdk-decl.d.ts +11 -0
  139. package/dist/emit/java/sdk-decl.js +63 -0
  140. package/dist/emit/java/sdk-errors.d.ts +13 -0
  141. package/dist/emit/java/sdk-errors.js +141 -0
  142. package/dist/emit/java/sdk-headers.d.ts +12 -0
  143. package/dist/emit/java/sdk-headers.js +74 -0
  144. package/dist/emit/java/sdk-mirror.d.ts +14 -0
  145. package/dist/emit/java/sdk-mirror.js +107 -0
  146. package/dist/emit/java/sdk-models.d.ts +16 -0
  147. package/dist/emit/java/sdk-models.js +68 -0
  148. package/dist/emit/java/sdk-op.d.ts +57 -0
  149. package/dist/emit/java/sdk-op.js +216 -0
  150. package/dist/emit/java/sdk-params.d.ts +38 -0
  151. package/dist/emit/java/sdk-params.js +133 -0
  152. package/dist/emit/java/sdk-plan.d.ts +52 -0
  153. package/dist/emit/java/sdk-plan.js +1 -0
  154. package/dist/emit/java/sdk-record.d.ts +16 -0
  155. package/dist/emit/java/sdk-record.js +99 -0
  156. package/dist/emit/java/sdk.d.ts +49 -0
  157. package/dist/emit/java/sdk.js +216 -0
  158. package/dist/emit/java/sse.d.ts +35 -0
  159. package/dist/emit/java/sse.js +57 -0
  160. package/dist/emit/java/ws.d.ts +27 -0
  161. package/dist/emit/java/ws.js +31 -0
  162. package/dist/emit/mcp/annotations.d.ts +15 -0
  163. package/dist/emit/mcp/annotations.js +15 -0
  164. package/dist/emit/mcp/files.d.ts +18 -0
  165. package/dist/emit/mcp/files.js +42 -0
  166. package/dist/emit/mcp/index.d.ts +3 -0
  167. package/dist/emit/mcp/index.js +3 -0
  168. package/dist/emit/mcp/literal.d.ts +2 -0
  169. package/dist/emit/mcp/literal.js +33 -0
  170. package/dist/emit/mcp/mounted.d.ts +21 -0
  171. package/dist/emit/mcp/mounted.js +89 -0
  172. package/dist/emit/mcp/output-schema.d.ts +18 -0
  173. package/dist/emit/mcp/output-schema.js +38 -0
  174. package/dist/emit/mcp/registry.d.ts +23 -0
  175. package/dist/emit/mcp/registry.js +83 -0
  176. package/dist/emit/mcp/runtime.d.ts +10 -0
  177. package/dist/emit/mcp/runtime.js +47 -0
  178. package/dist/emit/mcp/schema.d.ts +19 -0
  179. package/dist/emit/mcp/schema.js +88 -0
  180. package/dist/emit/mcp/server.d.ts +30 -0
  181. package/dist/emit/mcp/server.js +246 -0
  182. package/dist/emit/mcp/tools.d.ts +51 -0
  183. package/dist/emit/mcp/tools.js +153 -0
  184. package/dist/emit/python/errors.d.ts +8 -0
  185. package/dist/emit/python/errors.js +68 -0
  186. package/dist/emit/python/index.d.ts +1 -0
  187. package/dist/emit/python/index.js +1 -0
  188. package/dist/emit/python/realtime.d.ts +10 -0
  189. package/dist/emit/python/realtime.js +33 -0
  190. package/dist/emit/python/sdk-answer.d.ts +49 -0
  191. package/dist/emit/python/sdk-answer.js +89 -0
  192. package/dist/emit/python/sdk-body.d.ts +11 -0
  193. package/dist/emit/python/sdk-body.js +40 -0
  194. package/dist/emit/python/sdk-client.d.ts +36 -0
  195. package/dist/emit/python/sdk-client.js +163 -0
  196. package/dist/emit/python/sdk-doc.d.ts +9 -0
  197. package/dist/emit/python/sdk-doc.js +32 -0
  198. package/dist/emit/python/sdk-imports.d.ts +14 -0
  199. package/dist/emit/python/sdk-imports.js +38 -0
  200. package/dist/emit/python/sdk-method.d.ts +29 -0
  201. package/dist/emit/python/sdk-method.js +183 -0
  202. package/dist/emit/python/sdk-plan.d.ts +33 -0
  203. package/dist/emit/python/sdk-plan.js +1 -0
  204. package/dist/emit/python/sdk-pyproject.d.ts +27 -0
  205. package/dist/emit/python/sdk-pyproject.js +103 -0
  206. package/dist/emit/python/sdk.d.ts +22 -0
  207. package/dist/emit/python/sdk.js +154 -0
  208. package/dist/emit/python/sse.d.ts +12 -0
  209. package/dist/emit/python/sse.js +23 -0
  210. package/dist/emit/python/transport.d.ts +15 -0
  211. package/dist/emit/python/transport.js +60 -0
  212. package/dist/emit/python/types-dict.d.ts +31 -0
  213. package/dist/emit/python/types-dict.js +45 -0
  214. package/dist/emit/python/types-names.d.ts +16 -0
  215. package/dist/emit/python/types-names.js +52 -0
  216. package/dist/emit/python/types-union.d.ts +32 -0
  217. package/dist/emit/python/types-union.js +46 -0
  218. package/dist/emit/python/types.d.ts +36 -0
  219. package/dist/emit/python/types.js +128 -0
  220. package/dist/emit/python/ws.d.ts +14 -0
  221. package/dist/emit/python/ws.js +16 -0
  222. package/dist/emit/rust/errors.d.ts +7 -0
  223. package/dist/emit/rust/errors.js +107 -0
  224. package/dist/emit/rust/http.d.ts +13 -0
  225. package/dist/emit/rust/http.js +67 -0
  226. package/dist/emit/rust/index.d.ts +1 -0
  227. package/dist/emit/rust/index.js +1 -0
  228. package/dist/emit/rust/realtime.d.ts +11 -0
  229. package/dist/emit/rust/realtime.js +29 -0
  230. package/dist/emit/rust/sdk-body.d.ts +19 -0
  231. package/dist/emit/rust/sdk-body.js +53 -0
  232. package/dist/emit/rust/sdk-cargo.d.ts +43 -0
  233. package/dist/emit/rust/sdk-cargo.js +178 -0
  234. package/dist/emit/rust/sdk-client.d.ts +25 -0
  235. package/dist/emit/rust/sdk-client.js +108 -0
  236. package/dist/emit/rust/sdk-method.d.ts +15 -0
  237. package/dist/emit/rust/sdk-method.js +119 -0
  238. package/dist/emit/rust/sdk-opts.d.ts +58 -0
  239. package/dist/emit/rust/sdk-opts.js +117 -0
  240. package/dist/emit/rust/sdk-plan.d.ts +33 -0
  241. package/dist/emit/rust/sdk-plan.js +1 -0
  242. package/dist/emit/rust/sdk.d.ts +23 -0
  243. package/dist/emit/rust/sdk.js +111 -0
  244. package/dist/emit/rust/sse.d.ts +19 -0
  245. package/dist/emit/rust/sse.js +20 -0
  246. package/dist/emit/rust/types-enum.d.ts +13 -0
  247. package/dist/emit/rust/types-enum.js +62 -0
  248. package/dist/emit/rust/types-names.d.ts +19 -0
  249. package/dist/emit/rust/types-names.js +66 -0
  250. package/dist/emit/rust/types-struct.d.ts +21 -0
  251. package/dist/emit/rust/types-struct.js +59 -0
  252. package/dist/emit/rust/types-union.d.ts +24 -0
  253. package/dist/emit/rust/types-union.js +97 -0
  254. package/dist/emit/rust/types.d.ts +34 -0
  255. package/dist/emit/rust/types.js +105 -0
  256. package/dist/emit/rust/ws.d.ts +21 -0
  257. package/dist/emit/rust/ws.js +20 -0
  258. package/dist/emit/shared/escape.d.ts +55 -0
  259. package/dist/emit/shared/escape.js +144 -0
  260. package/dist/emit/shared/format.d.ts +24 -0
  261. package/dist/emit/shared/format.js +23 -0
  262. package/dist/emit/shared/gofmt.d.ts +3 -0
  263. package/dist/emit/shared/gofmt.js +26 -0
  264. package/dist/emit/shared/lang.d.ts +60 -0
  265. package/dist/emit/shared/lang.js +233 -0
  266. package/dist/emit/shared/literals.d.ts +4 -0
  267. package/dist/emit/shared/literals.js +31 -0
  268. package/dist/emit/shared/metadata.d.ts +106 -0
  269. package/dist/emit/shared/metadata.js +130 -0
  270. package/dist/emit/shared/mirror.d.ts +22 -0
  271. package/dist/emit/shared/mirror.js +26 -0
  272. package/dist/emit/shared/ruff.d.ts +3 -0
  273. package/dist/emit/shared/ruff.js +31 -0
  274. package/dist/emit/shared/rustfmt.d.ts +3 -0
  275. package/dist/emit/shared/rustfmt.js +32 -0
  276. package/dist/emit/shared/status-keys.d.ts +7 -0
  277. package/dist/emit/shared/status-keys.js +67 -0
  278. package/dist/emit/shared/type-emitter.d.ts +19 -0
  279. package/dist/emit/shared/type-emitter.js +100 -0
  280. package/dist/emit/ts/app-client.d.ts +4 -0
  281. package/dist/emit/ts/app-client.js +68 -0
  282. package/dist/emit/ts/http.d.ts +20 -0
  283. package/dist/emit/ts/http.js +74 -0
  284. package/dist/emit/ts/package.d.ts +36 -0
  285. package/dist/emit/ts/package.js +126 -0
  286. package/dist/emit/ts/route-tree.d.ts +68 -0
  287. package/dist/emit/ts/route-tree.js +240 -0
  288. package/dist/emit/ts/sdk-types-preamble.d.ts +14 -0
  289. package/dist/emit/ts/sdk-types-preamble.js +123 -0
  290. package/dist/emit/ts/sdk-types.d.ts +13 -0
  291. package/dist/emit/ts/sdk-types.js +213 -0
  292. package/dist/emit/ts/sdk.d.ts +21 -0
  293. package/dist/emit/ts/sdk.js +173 -0
  294. package/dist/emit/ts/service-map.d.ts +40 -0
  295. package/dist/emit/ts/service-map.js +171 -0
  296. package/dist/emit/ts/tanstack-query.d.ts +12 -0
  297. package/dist/emit/ts/tanstack-query.js +156 -0
  298. package/dist/emit/ts/type-gen.d.ts +26 -0
  299. package/dist/emit/ts/type-gen.js +255 -0
  300. package/dist/emit/ts/webhooks.d.ts +19 -0
  301. package/dist/emit/ts/webhooks.js +81 -0
  302. package/dist/extract/chain.d.ts +34 -0
  303. package/dist/extract/chain.js +84 -0
  304. package/dist/extract/extract.d.ts +41 -0
  305. package/dist/extract/extract.js +191 -0
  306. package/dist/extract/serialize.d.ts +34 -0
  307. package/dist/extract/serialize.js +295 -0
  308. package/dist/extract/walk.d.ts +47 -0
  309. package/dist/extract/walk.js +109 -0
  310. package/dist/gen/args.d.ts +28 -0
  311. package/dist/gen/args.js +133 -0
  312. package/dist/gen/formatters.d.ts +62 -0
  313. package/dist/gen/formatters.js +146 -0
  314. package/dist/gen/process.d.ts +13 -0
  315. package/dist/gen/process.js +35 -0
  316. package/dist/gen/shipped.d.ts +17 -0
  317. package/dist/gen/shipped.js +55 -0
  318. package/dist/gen/targets.d.ts +93 -0
  319. package/dist/gen/targets.js +171 -0
  320. package/dist/gen/write.d.ts +33 -0
  321. package/dist/gen/write.js +118 -0
  322. package/dist/index.d.ts +13 -0
  323. package/dist/index.js +15 -0
  324. package/dist/ir/build.d.ts +37 -0
  325. package/dist/ir/build.js +152 -0
  326. package/dist/ir/load.d.ts +11 -0
  327. package/dist/ir/load.js +112 -0
  328. package/dist/ir/model.d.ts +206 -0
  329. package/dist/ir/model.js +5 -0
  330. package/dist/ir/resolve-refs.d.ts +11 -0
  331. package/dist/ir/resolve-refs.js +66 -0
  332. package/dist/ir/resource-tree.d.ts +9 -0
  333. package/dist/ir/resource-tree.js +53 -0
  334. package/dist/ir/route-tree-intern.d.ts +18 -0
  335. package/dist/ir/route-tree-intern.js +174 -0
  336. package/dist/ir/schema.d.ts +11 -0
  337. package/dist/ir/schema.js +192 -0
  338. package/dist/ir/sdk-model.d.ts +86 -0
  339. package/dist/ir/sdk-model.js +204 -0
  340. package/dist/ir/slots.d.ts +42 -0
  341. package/dist/ir/slots.js +245 -0
  342. package/dist/runtime/cli/body.go +176 -0
  343. package/dist/runtime/cli/config.go +243 -0
  344. package/dist/runtime/cli/discovery.go +147 -0
  345. package/dist/runtime/cli/format.go +174 -0
  346. package/dist/runtime/cli/log.go +117 -0
  347. package/dist/runtime/cli/output.go +247 -0
  348. package/dist/runtime/cli/params.go +197 -0
  349. package/dist/runtime/cli/run.go +226 -0
  350. package/dist/runtime/cli/socket.go +60 -0
  351. package/dist/runtime/cli/stream.go +217 -0
  352. package/dist/runtime/cli/target.go +117 -0
  353. package/dist/runtime/csharp/Adapters.cs +183 -0
  354. package/dist/runtime/csharp/Auth.cs +56 -0
  355. package/dist/runtime/csharp/Body.cs +135 -0
  356. package/dist/runtime/csharp/Config.cs +161 -0
  357. package/dist/runtime/csharp/Envelope.cs +149 -0
  358. package/dist/runtime/csharp/Errors.cs +194 -0
  359. package/dist/runtime/csharp/Events.cs +155 -0
  360. package/dist/runtime/csharp/Exchange.cs +247 -0
  361. package/dist/runtime/csharp/Handler.cs +103 -0
  362. package/dist/runtime/csharp/Hooks.cs +128 -0
  363. package/dist/runtime/csharp/Invalidation.cs +102 -0
  364. package/dist/runtime/csharp/Json.cs +144 -0
  365. package/dist/runtime/csharp/Log.cs +48 -0
  366. package/dist/runtime/csharp/Operation.cs +33 -0
  367. package/dist/runtime/csharp/Path.cs +65 -0
  368. package/dist/runtime/csharp/Query.cs +72 -0
  369. package/dist/runtime/csharp/Realtime.cs +118 -0
  370. package/dist/runtime/csharp/RealtimeLoop.cs +236 -0
  371. package/dist/runtime/csharp/Redirect.cs +53 -0
  372. package/dist/runtime/csharp/Result.cs +57 -0
  373. package/dist/runtime/csharp/Sse.cs +122 -0
  374. package/dist/runtime/csharp/Stale.cs +151 -0
  375. package/dist/runtime/csharp/Transport.cs +143 -0
  376. package/dist/runtime/csharp/TransportLongPoll.cs +63 -0
  377. package/dist/runtime/csharp/TransportSse.cs +54 -0
  378. package/dist/runtime/csharp/TransportWs.cs +40 -0
  379. package/dist/runtime/csharp/Wire.cs +109 -0
  380. package/dist/runtime/csharp/Ws.cs +300 -0
  381. package/dist/runtime/csharp/WsDial.cs +127 -0
  382. package/dist/runtime/go/auth.go +127 -0
  383. package/dist/runtime/go/body.go +129 -0
  384. package/dist/runtime/go/config.go +75 -0
  385. package/dist/runtime/go/errors.go +185 -0
  386. package/dist/runtime/go/export.go +37 -0
  387. package/dist/runtime/go/hooks.go +53 -0
  388. package/dist/runtime/go/invalidation.go +112 -0
  389. package/dist/runtime/go/log.go +92 -0
  390. package/dist/runtime/go/nullable.go +64 -0
  391. package/dist/runtime/go/options.go +118 -0
  392. package/dist/runtime/go/path.go +156 -0
  393. package/dist/runtime/go/query.go +147 -0
  394. package/dist/runtime/go/realtime.go +239 -0
  395. package/dist/runtime/go/realtime_loop.go +208 -0
  396. package/dist/runtime/go/redirect.go +124 -0
  397. package/dist/runtime/go/request.go +222 -0
  398. package/dist/runtime/go/result.go +86 -0
  399. package/dist/runtime/go/sse.go +186 -0
  400. package/dist/runtime/go/stale.go +229 -0
  401. package/dist/runtime/go/stream.go +105 -0
  402. package/dist/runtime/go/transport.go +242 -0
  403. package/dist/runtime/go/transport_longpoll.go +121 -0
  404. package/dist/runtime/go/transport_sse.go +175 -0
  405. package/dist/runtime/go/ws.go +205 -0
  406. package/dist/runtime/java/Answer.java +107 -0
  407. package/dist/runtime/java/ApiException.java +110 -0
  408. package/dist/runtime/java/BinaryBody.java +36 -0
  409. package/dist/runtime/java/Body.java +105 -0
  410. package/dist/runtime/java/Call.java +23 -0
  411. package/dist/runtime/java/CallLog.java +51 -0
  412. package/dist/runtime/java/ClientConfig.java +233 -0
  413. package/dist/runtime/java/ConnectionState.java +12 -0
  414. package/dist/runtime/java/Credential.java +58 -0
  415. package/dist/runtime/java/Deadline.java +38 -0
  416. package/dist/runtime/java/Decode.java +181 -0
  417. package/dist/runtime/java/Envelope.java +141 -0
  418. package/dist/runtime/java/ErrorEnvelope.java +23 -0
  419. package/dist/runtime/java/EventStream.java +129 -0
  420. package/dist/runtime/java/Exchange.java +62 -0
  421. package/dist/runtime/java/FilePart.java +5 -0
  422. package/dist/runtime/java/Flight.java +306 -0
  423. package/dist/runtime/java/HoneyException.java +14 -0
  424. package/dist/runtime/java/Hooks.java +47 -0
  425. package/dist/runtime/java/Hops.java +133 -0
  426. package/dist/runtime/java/InvalidationConfig.java +73 -0
  427. package/dist/runtime/java/Json.java +23 -0
  428. package/dist/runtime/java/Keepalive.java +60 -0
  429. package/dist/runtime/java/LogEntry.java +14 -0
  430. package/dist/runtime/java/LongPollAdapter.java +68 -0
  431. package/dist/runtime/java/Operation.java +21 -0
  432. package/dist/runtime/java/Opt.java +121 -0
  433. package/dist/runtime/java/Pump.java +160 -0
  434. package/dist/runtime/java/RawResponse.java +48 -0
  435. package/dist/runtime/java/Realtime.java +152 -0
  436. package/dist/runtime/java/RealtimeLoop.java +371 -0
  437. package/dist/runtime/java/RedirectPolicy.java +13 -0
  438. package/dist/runtime/java/Redirects.java +126 -0
  439. package/dist/runtime/java/RequestContext.java +78 -0
  440. package/dist/runtime/java/RequestHook.java +9 -0
  441. package/dist/runtime/java/RequestOptions.java +91 -0
  442. package/dist/runtime/java/ResponseContext.java +70 -0
  443. package/dist/runtime/java/ResponseHook.java +12 -0
  444. package/dist/runtime/java/Result.java +32 -0
  445. package/dist/runtime/java/ResumableConnection.java +165 -0
  446. package/dist/runtime/java/SdkException.java +11 -0
  447. package/dist/runtime/java/Socket.java +301 -0
  448. package/dist/runtime/java/Sse.java +171 -0
  449. package/dist/runtime/java/SseAdapter.java +61 -0
  450. package/dist/runtime/java/SseEvent.java +10 -0
  451. package/dist/runtime/java/StaleMeta.java +16 -0
  452. package/dist/runtime/java/StaleTracker.java +287 -0
  453. package/dist/runtime/java/Transport.java +16 -0
  454. package/dist/runtime/java/TransportAdapter.java +14 -0
  455. package/dist/runtime/java/TransportConnection.java +15 -0
  456. package/dist/runtime/java/TransportKind.java +12 -0
  457. package/dist/runtime/java/TransportMessage.java +9 -0
  458. package/dist/runtime/java/TransportOptions.java +138 -0
  459. package/dist/runtime/java/TypedWebSocket.java +83 -0
  460. package/dist/runtime/java/UrlPath.java +49 -0
  461. package/dist/runtime/java/UrlQuery.java +99 -0
  462. package/dist/runtime/java/WsAdapter.java +52 -0
  463. package/dist/runtime/java/WsClose.java +47 -0
  464. package/dist/runtime/java/WsDial.java +148 -0
  465. package/dist/runtime/java/WsMessage.java +18 -0
  466. package/dist/runtime/mcp/call.ts +167 -0
  467. package/dist/runtime/mcp/files.ts +183 -0
  468. package/dist/runtime/mcp/guard.ts +176 -0
  469. package/dist/runtime/mcp/http.ts +159 -0
  470. package/dist/runtime/mcp/jsonrpc.ts +50 -0
  471. package/dist/runtime/mcp/listen.ts +76 -0
  472. package/dist/runtime/mcp/mount.ts +123 -0
  473. package/dist/runtime/mcp/protocol.ts +219 -0
  474. package/dist/runtime/mcp/reader.ts +57 -0
  475. package/dist/runtime/mcp/result.ts +85 -0
  476. package/dist/runtime/mcp/stdio.ts +79 -0
  477. package/dist/runtime/mcp/stream.ts +62 -0
  478. package/dist/runtime/python/__init__.py +2 -0
  479. package/dist/runtime/python/auth.py +67 -0
  480. package/dist/runtime/python/body.py +83 -0
  481. package/dist/runtime/python/config.py +139 -0
  482. package/dist/runtime/python/errors.py +213 -0
  483. package/dist/runtime/python/events.py +152 -0
  484. package/dist/runtime/python/exchange.py +298 -0
  485. package/dist/runtime/python/hooks.py +86 -0
  486. package/dist/runtime/python/invalidation.py +57 -0
  487. package/dist/runtime/python/log.py +60 -0
  488. package/dist/runtime/python/operation.py +25 -0
  489. package/dist/runtime/python/path.py +41 -0
  490. package/dist/runtime/python/query.py +48 -0
  491. package/dist/runtime/python/realtime.py +244 -0
  492. package/dist/runtime/python/redirect.py +93 -0
  493. package/dist/runtime/python/result.py +58 -0
  494. package/dist/runtime/python/send_async.py +189 -0
  495. package/dist/runtime/python/send_sync.py +105 -0
  496. package/dist/runtime/python/sse.py +81 -0
  497. package/dist/runtime/python/stale.py +94 -0
  498. package/dist/runtime/python/transport.py +157 -0
  499. package/dist/runtime/python/transport_longpoll.py +60 -0
  500. package/dist/runtime/python/transport_sse.py +60 -0
  501. package/dist/runtime/python/transport_ws.py +57 -0
  502. package/dist/runtime/python/ws.py +276 -0
  503. package/dist/runtime/rust/Cargo.lock +1763 -0
  504. package/dist/runtime/rust/answer.rs +120 -0
  505. package/dist/runtime/rust/auth.rs +80 -0
  506. package/dist/runtime/rust/body.rs +150 -0
  507. package/dist/runtime/rust/call.rs +200 -0
  508. package/dist/runtime/rust/config.rs +254 -0
  509. package/dist/runtime/rust/envelope.rs +84 -0
  510. package/dist/runtime/rust/errors.rs +235 -0
  511. package/dist/runtime/rust/events.rs +177 -0
  512. package/dist/runtime/rust/exchange.rs +287 -0
  513. package/dist/runtime/rust/hooks.rs +63 -0
  514. package/dist/runtime/rust/invalidation.rs +84 -0
  515. package/dist/runtime/rust/log.rs +88 -0
  516. package/dist/runtime/rust/nullable.rs +13 -0
  517. package/dist/runtime/rust/path.rs +83 -0
  518. package/dist/runtime/rust/query.rs +84 -0
  519. package/dist/runtime/rust/realtime.rs +182 -0
  520. package/dist/runtime/rust/realtime_loop.rs +177 -0
  521. package/dist/runtime/rust/redirect.rs +121 -0
  522. package/dist/runtime/rust/request.rs +178 -0
  523. package/dist/runtime/rust/result.rs +101 -0
  524. package/dist/runtime/rust/sse.rs +104 -0
  525. package/dist/runtime/rust/stale.rs +209 -0
  526. package/dist/runtime/rust/transport.rs +221 -0
  527. package/dist/runtime/rust/transport_longpoll.rs +108 -0
  528. package/dist/runtime/rust/transport_sse.rs +91 -0
  529. package/dist/runtime/rust/transport_ws.rs +75 -0
  530. package/dist/runtime/rust/ws.rs +322 -0
  531. package/dist/runtime/ts/app-types.ts +200 -0
  532. package/dist/runtime/ts/app.ts +104 -0
  533. package/dist/runtime/ts/config.ts +124 -0
  534. package/dist/runtime/ts/defaults.ts +48 -0
  535. package/dist/runtime/ts/error.ts +113 -0
  536. package/dist/runtime/ts/hooks.ts +92 -0
  537. package/dist/runtime/ts/http.ts +228 -0
  538. package/dist/runtime/ts/media-type.ts +36 -0
  539. package/dist/runtime/ts/path.ts +152 -0
  540. package/dist/runtime/ts/realtime-connection.ts +296 -0
  541. package/dist/runtime/ts/realtime-transports.ts +149 -0
  542. package/dist/runtime/ts/realtime.ts +293 -0
  543. package/dist/runtime/ts/redirect-policy.ts +17 -0
  544. package/dist/runtime/ts/redirects.ts +74 -0
  545. package/dist/runtime/ts/request.ts +239 -0
  546. package/dist/runtime/ts/response.ts +219 -0
  547. package/dist/runtime/ts/sdk-realtime.ts +10 -0
  548. package/dist/runtime/ts/sdk-sse.ts +55 -0
  549. package/dist/runtime/ts/sdk-ws.ts +21 -0
  550. package/dist/runtime/ts/sdk.ts +242 -0
  551. package/dist/runtime/ts/sse.ts +175 -0
  552. package/dist/runtime/ts/stale.ts +137 -0
  553. package/dist/runtime/ts/stream.ts +87 -0
  554. package/dist/runtime/ts/webhook.ts +116 -0
  555. package/dist/runtime/ts/ws.ts +155 -0
  556. package/dist/runtime/ts-tanstack-query/invalidate.ts +152 -0
  557. package/dist/runtime/ts-tanstack-query/query.ts +261 -0
  558. package/package.json +84 -5
@@ -0,0 +1,99 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.nio.charset.StandardCharsets;
5
+ import java.util.ArrayList;
6
+ import java.util.List;
7
+ import tools.jackson.databind.JsonNode;
8
+
9
+ /**
10
+ * Encodes a query: each arg once per item, names and values form-encoded, an unset or empty value
11
+ * sent as nothing.
12
+ */
13
+ final class UrlQuery {
14
+ private UrlQuery() {}
15
+
16
+ /** The query string of {@code args}, without the {@code ?}. */
17
+ static String encode(List<Call.Arg> args) {
18
+ StringBuilder query = new StringBuilder();
19
+ for (Call.Arg arg : args) {
20
+ for (String text : texts(arg.value())) {
21
+ append(query, arg.name(), text);
22
+ }
23
+ }
24
+ return query.toString();
25
+ }
26
+
27
+ /**
28
+ * The texts of {@code value}: each item of an array, else the value itself, unset ones dropped.
29
+ */
30
+ static List<String> texts(JsonNode value) {
31
+ List<String> texts = new ArrayList<>();
32
+ if (value != null && value.isArray()) {
33
+ for (JsonNode item : value) {
34
+ addIfText(texts, item);
35
+ }
36
+ } else {
37
+ addIfText(texts, value);
38
+ }
39
+ return texts;
40
+ }
41
+
42
+ private static void addIfText(List<String> texts, JsonNode value) {
43
+ String text = text(value);
44
+ if (text != null) {
45
+ texts.add(text);
46
+ }
47
+ }
48
+
49
+ /**
50
+ * The text of one value: a string as it is, an empty object as nothing, any other value as its
51
+ * JSON.
52
+ */
53
+ static String text(JsonNode value) {
54
+ if (value == null || value.isNull() || value.isMissingNode()) {
55
+ return null;
56
+ }
57
+ if (value.isString()) {
58
+ return value.asString();
59
+ }
60
+ if (value.isObject() && value.isEmpty()) {
61
+ return null;
62
+ }
63
+ return value.toString();
64
+ }
65
+
66
+ /** Appends {@code name=text}, joined to what is there by {@code &}. */
67
+ static void append(StringBuilder query, String name, String text) {
68
+ if (query.length() > 0) {
69
+ query.append('&');
70
+ }
71
+ form(query, name);
72
+ query.append('=');
73
+ form(query, text);
74
+ }
75
+
76
+ private static void form(StringBuilder query, String text) {
77
+ String[] words = text.split(" ", -1);
78
+ for (int i = 0; i < words.length; i++) {
79
+ if (i > 0) {
80
+ query.append('+');
81
+ }
82
+ escape(query, words[i], "*-._");
83
+ }
84
+ }
85
+
86
+ /**
87
+ * Appends {@code value} with each byte but the letters, digits and {@code safe} percent-encoded.
88
+ */
89
+ static void escape(StringBuilder out, String value, String safe) {
90
+ for (byte b : value.getBytes(StandardCharsets.UTF_8)) {
91
+ char c = (char) (b & 0xFF);
92
+ if (c < 128 && (Character.isLetterOrDigit(c) || safe.indexOf(c) >= 0)) {
93
+ out.append(c);
94
+ } else {
95
+ out.append('%').append(String.format("%02X", b & 0xFF));
96
+ }
97
+ }
98
+ }
99
+ }
@@ -0,0 +1,52 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ /**
5
+ * A realtime call's WebSocket: its own upgrade with the cursor as query params, no hook and no log
6
+ * on the dial.
7
+ */
8
+ final class WsAdapter implements TransportAdapter, RealtimeLoop.Dialed {
9
+ private final Realtime dial;
10
+
11
+ WsAdapter(Realtime dial) {
12
+ this.dial = dial;
13
+ }
14
+
15
+ @Override
16
+ public Realtime dial() {
17
+ return dial;
18
+ }
19
+
20
+ @Override
21
+ public String name() {
22
+ return "ws";
23
+ }
24
+
25
+ @Override
26
+ public TransportKind kind() {
27
+ return TransportKind.WS;
28
+ }
29
+
30
+ /** Dials the call's socket; {@code url} is a caller's adapter's. */
31
+ @Override
32
+ public TransportConnection connect(String url, TransportOptions options) {
33
+ TypedWebSocket socket = dial.socket(options);
34
+ return new TransportConnection() {
35
+ @Override
36
+ public TransportMessage receive() {
37
+ WsMessage message = socket.receive();
38
+ return message == null ? null : new TransportMessage(message.text(), null, null);
39
+ }
40
+
41
+ @Override
42
+ public void send(String text) {
43
+ socket.send(text);
44
+ }
45
+
46
+ @Override
47
+ public void close() {
48
+ socket.close();
49
+ }
50
+ };
51
+ }
52
+ }
@@ -0,0 +1,47 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ /** A WebSocket close: its status code and its reason. */
5
+ public record WsClose(int status, String reason) {
6
+ /**
7
+ * Refuses a status no client may send, before any frame: ConfigException, the socket left open.
8
+ */
9
+ static void check(int status) {
10
+ if (!sendable(status)) {
11
+ throw new ConfigException(
12
+ "a WebSocket client can't close with status "
13
+ + status
14
+ + ": 1000, 1001, 1008, 1011 or 3000-4999");
15
+ }
16
+ }
17
+
18
+ /**
19
+ * Whether a client may send {@code status}: the JDK sends 1000, 1001, 1008, 1011 and 3000-4999
20
+ * alone.
21
+ */
22
+ static boolean sendable(int status) {
23
+ return status == 1000
24
+ || status == 1001
25
+ || status == 1008
26
+ || status == 1011
27
+ || (status >= 3000 && status <= 4999);
28
+ }
29
+
30
+ /**
31
+ * {@code reason} cut to 123 UTF-8 bytes on a code point: a close frame holds 125, the code two.
32
+ */
33
+ static String cut(String reason) {
34
+ int bytes = 0;
35
+ int at = 0;
36
+ while (at < reason.length()) {
37
+ int point = reason.codePointAt(at);
38
+ int size = point < 0x80 ? 1 : point < 0x800 ? 2 : point < 0x10000 ? 3 : 4;
39
+ if (bytes + size > 123) {
40
+ break;
41
+ }
42
+ bytes += size;
43
+ at += Character.charCount(point);
44
+ }
45
+ return reason.substring(0, at);
46
+ }
47
+ }
@@ -0,0 +1,148 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.net.URI;
5
+ import java.net.http.HttpResponse;
6
+ import java.net.http.HttpTimeoutException;
7
+ import java.net.http.WebSocket;
8
+ import java.net.http.WebSocketHandshakeException;
9
+ import java.nio.charset.StandardCharsets;
10
+ import java.time.Duration;
11
+ import java.util.Arrays;
12
+ import java.util.List;
13
+ import java.util.Locale;
14
+ import java.util.Map;
15
+ import java.util.TreeMap;
16
+ import java.util.UUID;
17
+ import java.util.concurrent.CancellationException;
18
+ import java.util.concurrent.CompletableFuture;
19
+ import java.util.concurrent.ExecutionException;
20
+
21
+ /**
22
+ * A WebSocket call's dial: the path checked, the call's headers layered (a fresh X-Request-Id, the
23
+ * config's, the call's, the options', the credential) with no hook and no log, a restricted name
24
+ * refused by name, the subprotocols offered, the call's timeout bounding the handshake alone. A
25
+ * refusal is its status exception (its body read at most 64 KiB); no redirect is followed.
26
+ */
27
+ final class WsDial {
28
+ private static final int ERROR_CAP = 64 * 1024;
29
+
30
+ private WsDial() {}
31
+
32
+ static TypedWebSocket open(
33
+ Exchange exchange, Operation op, Call call, RequestOptions given, List<String> protocols) {
34
+ RequestOptions options = given == null ? RequestOptions.NONE : given;
35
+ ClientConfig config = exchange.config();
36
+ if (java.lang.Thread.currentThread().isInterrupted()) {
37
+ throw new CancellationException("the call was canceled");
38
+ }
39
+ String origin = options.baseUrl() != null ? options.baseUrl() : config.baseUrl();
40
+ String path = UrlPath.expand(op.template(), op.names(), call.path());
41
+ String query = UrlQuery.encode(call.query());
42
+ String base = origin.replaceAll("/+$", "").replaceFirst("^http", "ws");
43
+ URI url = URI.create(base + path + (query.isEmpty() ? "" : "?" + query));
44
+ WebSocket.Builder builder = exchange.http().newWebSocketBuilder();
45
+ headers(exchange, call, options).forEach(builder::header);
46
+ if (protocols != null && !protocols.isEmpty()) {
47
+ builder.subprotocols(
48
+ protocols.get(0), protocols.subList(1, protocols.size()).toArray(String[]::new));
49
+ }
50
+ Duration bound = options.timeout() != null ? options.timeout() : config.timeout();
51
+ if (bound != null && !bound.isZero()) {
52
+ builder.connectTimeout(bound);
53
+ }
54
+ Socket socket = new Socket(Keepalive.EVERY);
55
+ CompletableFuture<WebSocket> dial = builder.buildAsync(url, socket);
56
+ try {
57
+ dial.get();
58
+ } catch (InterruptedException e) {
59
+ dial.cancel(true);
60
+ java.lang.Thread.currentThread().interrupt();
61
+ throw new CancellationException("the call was canceled");
62
+ } catch (ExecutionException e) {
63
+ throw refused(e.getCause(), op.route(), bound, protocols, options.raw(), url);
64
+ }
65
+ if (options.raw() != null) {
66
+ options.raw().fill(101, Map.of(), new byte[0], url);
67
+ }
68
+ return new TypedWebSocket(socket);
69
+ }
70
+
71
+ /** The dial's headers, layered as a call's; a restricted name or a value with CR/LF refused. */
72
+ private static Map<String, String> headers(Exchange exchange, Call call, RequestOptions options) {
73
+ Map<String, String> headers = new TreeMap<>(String.CASE_INSENSITIVE_ORDER);
74
+ headers.put("X-Request-Id", UUID.randomUUID().toString());
75
+ headers.putAll(exchange.config().headers());
76
+ for (Call.Arg arg : call.headers()) {
77
+ String text = UrlQuery.text(arg.value());
78
+ if (text != null) {
79
+ headers.put(arg.name(), text);
80
+ }
81
+ }
82
+ headers.putAll(options.headers());
83
+ Credential credential = exchange.credential();
84
+ String token = credential.token();
85
+ if (token != null && !token.isEmpty()) {
86
+ headers.put(credential.header(), credential.prefix() + token);
87
+ }
88
+ for (String name : headers.keySet()) {
89
+ if (name.toLowerCase(Locale.ROOT).startsWith("sec-websocket-")) {
90
+ throw new ConfigException("the " + name + " header is restricted and cannot be sent");
91
+ }
92
+ }
93
+ Hops.validate(headers);
94
+ return headers;
95
+ }
96
+
97
+ /**
98
+ * What a failed dial throws: a refusal's status exception, a 101 the JDK refused, a timeout, a
99
+ * connection.
100
+ */
101
+ private static RuntimeException refused(
102
+ Throwable cause,
103
+ String route,
104
+ Duration bound,
105
+ List<String> protocols,
106
+ RawResponse raw,
107
+ URI url) {
108
+ if (cause instanceof WebSocketHandshakeException handshake) {
109
+ HttpResponse<?> answer = handshake.getResponse();
110
+ Map<String, String> headers = new TreeMap<>();
111
+ answer
112
+ .headers()
113
+ .map()
114
+ .forEach(
115
+ (name, values) ->
116
+ headers.put(name.toLowerCase(Locale.ROOT), String.join(", ", values)));
117
+ if (answer.statusCode() == 101) {
118
+ String chosen = headers.get("sec-websocket-protocol");
119
+ boolean unoffered =
120
+ chosen != null
121
+ && !chosen.isEmpty()
122
+ && (protocols == null || !protocols.contains(chosen));
123
+ return new ApiConnectionException(
124
+ "the WebSocket handshake failed"
125
+ + (unoffered
126
+ ? ": the server chose subprotocol " + chosen + ", which was not offered"
127
+ : ""),
128
+ null);
129
+ }
130
+ Object given = answer.body();
131
+ byte[] body =
132
+ given instanceof byte[] bytes
133
+ ? bytes
134
+ : given == null ? new byte[0] : given.toString().getBytes(StandardCharsets.UTF_8);
135
+ body = Arrays.copyOf(body, Math.min(body.length, ERROR_CAP));
136
+ if (raw != null) {
137
+ raw.fill(answer.statusCode(), headers, body, url);
138
+ }
139
+ return ApiException.of(new ApiException.Failure(answer.statusCode(), headers, body));
140
+ }
141
+ if (cause instanceof HttpTimeoutException) {
142
+ return new ApiTimeoutException(route + " timed out after " + bound.toMillis() + " ms", cause);
143
+ }
144
+ String detail =
145
+ cause.getMessage() == null ? cause.getClass().getSimpleName() : cause.getMessage();
146
+ return new ApiConnectionException(route + ": " + detail, cause);
147
+ }
148
+ }
@@ -0,0 +1,18 @@
1
+ // @generated by honey. DO NOT EDIT.
2
+ package honey.runtime;
3
+
4
+ import java.nio.charset.StandardCharsets;
5
+
6
+ /** One whole WebSocket message: its kind and its bytes. */
7
+ public record WsMessage(Type type, byte[] data) {
8
+ /** A message's kind. */
9
+ public enum Type {
10
+ TEXT,
11
+ BINARY
12
+ }
13
+
14
+ /** The message as UTF-8 text, an invalid sequence as U+FFFD. */
15
+ public String text() {
16
+ return new String(data, StandardCharsets.UTF_8);
17
+ }
18
+ }
@@ -0,0 +1,167 @@
1
+ /**
2
+ * A tool's call through the API's TS SDK (bit 18): each tool as tools.gen.ts describes it, bound to the SDK client's
3
+ * safe twin (bit 21 i1), a collect to the client's own stream. Its arguments pass guard.ts first, else nothing is
4
+ * sent. They go back into the SDK's input groups (each parameter under its own name: path, query or header; the body
5
+ * as JSON, a form, base64-decoded bytes at most 1 MiB, or text, a raw body under its content type), the SDK member the
6
+ * operation sits at is called with the session's abort, and its Result becomes the tool's result as result.ts shapes
7
+ * it, scrubbed of the API key; an event stream's, the collect stream.ts runs. Bit 21 c: a multipart form's parts are arguments, sent as multipart whether or not a file is.
8
+ * Bit 21 g: data-less FileInputs are staged first (files.ts), an input request or a refusal the answer.
9
+ */
10
+ import { decoded, type Files, fileOf, staged } from "./files.ts"
11
+ import { redactor, refusal } from "./guard.ts"
12
+ import { type Answer, BYTES_MAX, failureOf, json, successOf, unanswered } from "./result.ts"
13
+ import type { Outcome, Tool } from "./protocol.ts"
14
+ import { collected } from "./stream.ts"
15
+
16
+ /** The SDK input group a parameter goes in. */
17
+ export type Group = "params" | "search" | "headers"
18
+
19
+ /** One tool as tools.gen.ts holds it: what tools/list shows, and how each argument reaches the SDK's input. */
20
+ export type ToolSpec = {
21
+ readonly name: string
22
+ readonly description?: string
23
+ readonly inputSchema: Record<string, unknown>
24
+ /** the SDK member the operation sits at, key by key from the client */
25
+ readonly member: readonly string[]
26
+ /** each parameter argument: its property, its SDK input group, the parameter's own name */
27
+ readonly args: readonly (readonly [property: string, group: Group, name: string])[]
28
+ /** the body argument's property, how it is sent, and a raw body's content type, when the operation takes a body */
29
+ readonly body?: readonly [property: string, field: "json" | "form" | "bytes" | "text", contentType?: string]
30
+ readonly outputSchema?: Record<string, unknown>
31
+ /** whether structuredContent wraps the answer as `{result, headers}` */
32
+ readonly wrap?: true
33
+ readonly annotations?: Record<string, boolean>
34
+ /** an event stream's collect: its `max_events` and `last_event_id` properties */
35
+ readonly collect?: readonly [max: string, lastEventId: string]
36
+ /** a multipart form's parts: property, name in the form, kind */
37
+ readonly parts?: readonly (readonly [property: string, name: string, kind: "text" | "file" | "files"])[]
38
+ }
39
+
40
+ /**
41
+ * How tools call: the secrets to scrub, a call's bound in ms, a collect's own client, whose answer runs `seen`, and the
42
+ * inline file bytes a call may carry.
43
+ */
44
+ export type Binding = {
45
+ readonly secrets: readonly string[]
46
+ readonly timeout: number
47
+ readonly opening: (seen: () => void) => SdkClient
48
+ readonly inline?: number
49
+ }
50
+
51
+ /** The SDK client a tool drives: its members walked key by key to the operation's method. */
52
+ export type SdkClient = { readonly safe: object }
53
+
54
+ /** The SDK input `args` make for `spec`: each parameter in its group, the body in its field; or why it cannot be sent. */
55
+ function inputOf(spec: ToolSpec, args: Record<string, unknown>): Record<string, unknown> | string {
56
+ const input: Record<string, Record<string, unknown>> = { headers: {}, params: {}, search: {} }
57
+ for (const [property, group, name] of spec.args) {
58
+ const value = args[property]
59
+ if (value !== undefined)
60
+ (input[group] as Record<string, unknown>)[name] = group === "headers" ? String(value) : value
61
+ }
62
+ if (spec.body === undefined || args[spec.body[0]] === undefined) return input
63
+ const [property, field, contentType] = spec.body
64
+ const value = args[property]
65
+ if (field === "json" || field === "form") return { ...input, [field]: value }
66
+ ;(input.headers as Record<string, unknown>)["content-type"] = contentType
67
+ if (field === "text") return { ...input, body: value }
68
+ const bytes = decoded(String(value))
69
+ if (bytes === undefined) return `Invalid arguments: ${property} is not base64`
70
+ return bytes.byteLength > BYTES_MAX
71
+ ? `Invalid arguments: ${property} is past the ${BYTES_MAX}-byte cap`
72
+ : { ...input, body: bytes }
73
+ }
74
+
75
+ /**
76
+ * `input` with `args`' form as its multipart body, each file uploaded, read, fetched or decoded; else the answer. An
77
+ * input with no parts, or a refusal, is as it came.
78
+ */
79
+ async function formed(
80
+ input: Record<string, unknown> | string,
81
+ spec: ToolSpec,
82
+ args: Record<string, unknown>,
83
+ files: Files & { readonly signal: AbortSignal; readonly cap: number; left: number },
84
+ ) {
85
+ if (typeof input === "string" || spec.parts === undefined) return input
86
+ const items = spec.parts.flatMap(([property, name, kind]) =>
87
+ [args[property] ?? []].flat().map((item, at) => {
88
+ const label = `${property}${kind === "files" ? `[${at}]` : ""}`
89
+ return [label, name, kind === "text" ? undefined : (item as Record<string, unknown>), item] as const
90
+ }),
91
+ )
92
+ const values = items.flatMap(([label, , file]) => (file ? [[label, file] as const] : []))
93
+ const taken = await staged(spec.name, args, values, files)
94
+ if (!(taken instanceof Map)) return taken
95
+ const form = new FormData()
96
+ for (const [label, name, value, item] of items) {
97
+ const file = value && (await fileOf(value, { ...files, taken }, files))
98
+ if (typeof file === "string") return `Invalid arguments: ${label} ${file}`
99
+ if (file)
100
+ form.append(name, new Blob([file.bytes as Uint8Array<ArrayBuffer>], { type: file.type }), file.name ?? name)
101
+ else form.append(name, typeof item === "string" ? item : JSON.stringify(item))
102
+ }
103
+ /* fetch's own multipart encoding, its boundary in the content type */
104
+ const encoded = new Response(form)
105
+ const headers = { ...(input.headers as object), "content-type": encoded.headers.get("content-type") }
106
+ return { ...input, body: new Uint8Array(await encoded.arrayBuffer()), headers }
107
+ }
108
+
109
+ /** The method at `member` on `client`, with the object it is called on. */
110
+ function methodAt(client: object, member: readonly string[]): [owner: unknown, method: unknown] {
111
+ let owner: unknown = client
112
+ let method: unknown = client
113
+ for (const key of member) {
114
+ owner = method
115
+ method = (method as Record<string, unknown>)[key]
116
+ }
117
+ return [owner, method]
118
+ }
119
+
120
+ /** `specs` as tools calling `client.safe` as `binding` says, every result scrubbed of the secrets. */
121
+ export function bindTools(specs: readonly ToolSpec[], client: SdkClient, binding: Binding): Tool[] {
122
+ const scrub = redactor(binding.secrets)
123
+ return specs.map((spec) => ({
124
+ call: async (args, signal, progress, files) => {
125
+ const paths = spec.args.filter(([, group]) => group === "params").map(([property]) => property)
126
+ const cap = binding.inline ?? BYTES_MAX
127
+ const input = await formed(refusal(spec.inputSchema, paths, args) ?? inputOf(spec, args), spec, args, {
128
+ ...files,
129
+ cap,
130
+ left: cap,
131
+ signal,
132
+ })
133
+ if (typeof input === "string") return json(scrub({ message: input }), true)
134
+ if ("inputRequired" in input || "invalid" in input) return input as Outcome
135
+ let opened = false
136
+ const [owner, method] = methodAt(spec.collect ? binding.opening(() => (opened = true)) : client.safe, spec.member)
137
+ const send = (more: object) => (method as (input: unknown) => unknown).call(owner, { ...input, ...more })
138
+ try {
139
+ if (spec.collect)
140
+ return await collected(spec.collect, args, send, {
141
+ opened: () => opened,
142
+ progress,
143
+ scrub,
144
+ signal,
145
+ timeout: binding.timeout,
146
+ })
147
+ const answer = (await send({ signal })) as Answer
148
+ const { status } = answer.response
149
+ if (answer.ok) return { ...successOf(spec, answer, scrub), _meta: { "honey/status": status } }
150
+ /* an error status's JSON object body speaks for it, any other answer its error */
151
+ const { body } = answer.error as { body?: unknown }
152
+ const error = body && typeof body === "object" && !Array.isArray(body) ? body : answer.error
153
+ return { ...failureOf({ error, status }, scrub), _meta: { "honey/status": status } }
154
+ } catch (error) {
155
+ const status = (error as { status?: unknown } | null)?.status
156
+ return typeof status === "number"
157
+ ? { ...failureOf({ error, status }, scrub), _meta: { "honey/status": status } }
158
+ : unanswered(error, scrub)
159
+ }
160
+ },
161
+ ...(spec.description === undefined ? {} : { description: spec.description }),
162
+ inputSchema: spec.inputSchema,
163
+ ...(spec.outputSchema === undefined ? {} : { outputSchema: spec.outputSchema }),
164
+ ...(spec.annotations === undefined ? {} : { annotations: spec.annotations }),
165
+ name: spec.name,
166
+ }))
167
+ }