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

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 +135 -5
@@ -0,0 +1,197 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "encoding/json"
7
+ "fmt"
8
+ "reflect"
9
+ "slices"
10
+ "strconv"
11
+ "strings"
12
+
13
+ "github.com/spf13/cobra"
14
+ )
15
+
16
+ // Params are one command's parameter flags: each value checked against its kind and its enum as
17
+ // it is given, so a bad one is a usage error before anything is sent.
18
+ type Params struct {
19
+ cmd *cobra.Command
20
+ paths []string
21
+ required []string
22
+ }
23
+
24
+ // value is one parameter flag's: the raw values given, each already checked.
25
+ type value struct {
26
+ kind string
27
+ list bool
28
+ enum []string
29
+ values []string
30
+ }
31
+
32
+ func (v *value) String() string { return strings.Join(v.values, ",") }
33
+
34
+ func (v *value) Type() string {
35
+ if v.list {
36
+ return v.kind + "s"
37
+ }
38
+ return v.kind
39
+ }
40
+
41
+ func (v *value) Set(raw string) error {
42
+ if err := check(v.kind, raw); err != nil {
43
+ return err
44
+ }
45
+ if len(v.enum) > 0 && !slices.Contains(v.enum, raw) {
46
+ return fmt.Errorf("must be one of %s", strings.Join(v.enum, ", "))
47
+ }
48
+ if v.list {
49
+ v.values = append(v.values, raw)
50
+ } else {
51
+ v.values = []string{raw}
52
+ }
53
+ return nil
54
+ }
55
+
56
+ // check is whether raw reads as kind: integer, number, boolean, json, or any string.
57
+ func check(kind, raw string) error {
58
+ var err error
59
+ switch kind {
60
+ case "integer":
61
+ _, err = strconv.ParseInt(raw, 10, 64)
62
+ case "number":
63
+ _, err = strconv.ParseFloat(raw, 64)
64
+ case "boolean":
65
+ if raw != "true" && raw != "false" {
66
+ err = fmt.Errorf("not true or false")
67
+ }
68
+ case "json":
69
+ if !json.Valid([]byte(raw)) {
70
+ err = fmt.Errorf("not JSON")
71
+ }
72
+ }
73
+ // a number is sent as its JSON literal: NaN, Inf, hex and a leading + are not one
74
+ if err == nil && (kind == "integer" || kind == "number") && !json.Valid([]byte(raw)) {
75
+ err = fmt.Errorf("not JSON")
76
+ }
77
+ if err != nil {
78
+ return fmt.Errorf("not %s %s", article(kind), kind)
79
+ }
80
+ return nil
81
+ }
82
+
83
+ func article(kind string) string {
84
+ if kind == "integer" {
85
+ return "an"
86
+ }
87
+ return "a"
88
+ }
89
+
90
+ // NewParams holds cmd's parameter flags.
91
+ func NewParams(cmd *cobra.Command) *Params { return &Params{cmd: cmd} }
92
+
93
+ // Flag declares --name of kind (string, integer, number, boolean or json), repeatable when list,
94
+ // limited to enum when one is given, its values completing; a required one must be given.
95
+ func (p *Params) Flag(name, kind string, list, required bool, usage string, enum ...string) {
96
+ if len(enum) > 0 {
97
+ usage = strings.TrimSpace(usage + " (one of " + strings.Join(enum, ", ") + ")")
98
+ }
99
+ if required {
100
+ usage = strings.TrimSpace(usage + " (required)")
101
+ }
102
+ flag := p.cmd.Flags().VarPF(&value{kind: kind, list: list, enum: enum}, name, "", usage)
103
+ if len(enum) > 0 {
104
+ p.cmd.RegisterFlagCompletionFunc(name, cobra.FixedCompletions(enum, cobra.ShellCompDirectiveNoFileComp))
105
+ }
106
+ if kind == "boolean" && !list {
107
+ flag.NoOptDefVal = "true"
108
+ }
109
+ if required {
110
+ p.required = append(p.required, name)
111
+ }
112
+ }
113
+
114
+ // Values is what --name was given; none when it was not.
115
+ func (p *Params) Values(name string) []string {
116
+ return p.cmd.Flags().Lookup(name).Value.(*value).values
117
+ }
118
+
119
+ // Path declares the path parameters, in path order: each given positionally, or by its own flag.
120
+ func (p *Params) Path(names ...string) {
121
+ p.paths = names
122
+ for _, name := range names {
123
+ p.Flag(name, "string", false, false, "the "+name+" path parameter, when not given positionally")
124
+ }
125
+ p.cmd.Args = p.positional
126
+ }
127
+
128
+ // positional refuses a call whose positional arguments are not the path parameters left unflagged.
129
+ func (p *Params) positional(_ *cobra.Command, args []string) error {
130
+ var want []string
131
+ for _, name := range p.paths {
132
+ if !p.cmd.Flags().Changed(name) {
133
+ want = append(want, "<"+name+">")
134
+ }
135
+ }
136
+ if len(args) != len(want) {
137
+ return Usage("%s takes %d argument(s) %s, got %d", p.cmd.CommandPath(), len(want), strings.Join(want, " "), len(args))
138
+ }
139
+ return nil
140
+ }
141
+
142
+ // PathValues is each path parameter's value, in path order: its flag's, else the next positional one.
143
+ func (p *Params) PathValues(args []string) []string {
144
+ out := make([]string, len(p.paths))
145
+ for i, name := range p.paths {
146
+ if given := p.Values(name); len(given) > 0 {
147
+ out[i] = given[0]
148
+ continue
149
+ }
150
+ out[i], args = args[0], args[1:]
151
+ }
152
+ return out
153
+ }
154
+
155
+ // Check refuses a call missing a required flag, before anything is sent.
156
+ func (p *Params) Check() error {
157
+ for _, name := range p.required {
158
+ if !p.cmd.Flags().Changed(name) {
159
+ return Usage("%s needs --%s", p.cmd.CommandPath(), name)
160
+ }
161
+ }
162
+ return nil
163
+ }
164
+
165
+ // Set stores values in dst, converted to its type: nothing when none were given.
166
+ func Set[T any](dst *T, values []string) error {
167
+ if len(values) == 0 {
168
+ return nil
169
+ }
170
+ if err := assign(reflect.ValueOf(dst).Elem(), values); err != nil {
171
+ return Usage("%v", err)
172
+ }
173
+ return nil
174
+ }
175
+
176
+ func assign(v reflect.Value, values []string) error {
177
+ switch v.Kind() {
178
+ case reflect.Pointer:
179
+ v.Set(reflect.New(v.Type().Elem()))
180
+ return assign(v.Elem(), values)
181
+ case reflect.Slice:
182
+ items := reflect.MakeSlice(v.Type(), len(values), len(values))
183
+ for i := range values {
184
+ if err := assign(items.Index(i), values[i:i+1]); err != nil {
185
+ return err
186
+ }
187
+ }
188
+ v.Set(items)
189
+ return nil
190
+ case reflect.String:
191
+ v.SetString(values[0])
192
+ return nil
193
+ default:
194
+ // a number or a boolean is its JSON literal (check lets only those through); anything else is JSON
195
+ return json.Unmarshal([]byte(values[0]), v.Addr().Interface())
196
+ }
197
+ }
@@ -0,0 +1,226 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ // Package cli is the generated CLI's runtime: the root command and its global flags, the settings
4
+ // each run resolves, the parameter flags, and the run that maps an outcome to the exit code a
5
+ // script branches on.
6
+ package cli
7
+
8
+ import (
9
+ "context"
10
+ "errors"
11
+ "fmt"
12
+ "io"
13
+ "net"
14
+ "os"
15
+ "os/signal"
16
+
17
+ "github.com/spf13/cobra"
18
+ )
19
+
20
+ // Version is the CLI's version: a release links it in with
21
+ // -ldflags "-X <module>/internal/cli.Version=v1.2.3".
22
+ var Version = "dev"
23
+
24
+ // The exit codes, so a script tells a mistake in the call from a failed one.
25
+ const (
26
+ ExitOK = 0 // success
27
+ ExitError = 1 // the API answered 4xx, or anything not named below failed
28
+ ExitServer = 2 // the API answered 5xx
29
+ ExitTransport = 3 // no answer: the connection failed or the call timed out
30
+ ExitUsage = 4 // the call was wrong: an unknown command or flag, a bad value, a bad config
31
+ ExitRedirect = 5 // the API answered with a redirect the CLI does not follow
32
+ ExitInterrupted = 130 // interrupted (Ctrl-C)
33
+ )
34
+
35
+ // UsageError is a mistake in how the CLI was called: an unknown command or flag, a bad value.
36
+ type UsageError struct{ msg string }
37
+
38
+ func (e *UsageError) Error() string { return e.msg }
39
+
40
+ // Usage is a UsageError with a formatted message.
41
+ func Usage(format string, args ...any) error {
42
+ return &UsageError{msg: fmt.Sprintf(format, args...)}
43
+ }
44
+
45
+ // APIError is an answer outside 2xx: its status, and the error key and message its body carried.
46
+ type APIError struct {
47
+ Status int
48
+ Key string
49
+ Message string
50
+ Err error
51
+ }
52
+
53
+ func (e *APIError) Error() string { return e.Err.Error() }
54
+
55
+ func (e *APIError) Unwrap() error { return e.Err }
56
+
57
+ // App is the CLI: its binary, its one-line description, its environment variables' prefix, the
58
+ // API's default base URL (none when it declares no server), its commands as discovery shows
59
+ // them, and the agent skill it ships.
60
+ type App struct {
61
+ Name string
62
+ Short string
63
+ EnvPrefix string
64
+ Server string
65
+ Discovery Discovery
66
+ Skill string
67
+ }
68
+
69
+ // Root is the CLI's root command: the API's commands in one help group, the local ones
70
+ // (commands, completion, config, schema, skill, help) in another, a two-line banner pointing an
71
+ // agent at discovery, --version printing the version alone, the global flags, and an unknown
72
+ // command or flag a usage error.
73
+ func Root(app App, api ...*cobra.Command) *cobra.Command {
74
+ banner := fmt.Sprintf("Agents: `%[1]s commands` lists every command, one line each.\n"+
75
+ "`%[1]s schema <command>` shows one's request and answer; `%[1]s config` shows where calls go.", app.Name)
76
+ root := &cobra.Command{
77
+ Use: app.Name, Short: app.Short, Long: app.Short + "\n\n" + banner,
78
+ Version: Version, SilenceErrors: true, SilenceUsage: true,
79
+ }
80
+ root.SetVersionTemplate("{{.Version}}\n")
81
+ root.SetFlagErrorFunc(func(_ *cobra.Command, err error) error { return &UsageError{msg: err.Error()} })
82
+ if len(api) > 0 {
83
+ root.AddGroup(&cobra.Group{ID: apiGroup, Title: "API commands:"})
84
+ for _, cmd := range api {
85
+ cmd.GroupID = apiGroup
86
+ }
87
+ root.AddCommand(api...)
88
+ }
89
+ root.AddGroup(&cobra.Group{ID: localGroup, Title: "Local commands:"})
90
+ root.SetHelpCommandGroupID(localGroup)
91
+ root.SetCompletionCommandGroupID(localGroup)
92
+ globalFlags(root, app)
93
+ outputFlags(root)
94
+ discover(root, app)
95
+ configCommand(root)
96
+ Group(root)
97
+ return root
98
+ }
99
+
100
+ // Group makes cmd a command that holds others: an argument naming none of them is a usage error,
101
+ // and no argument prints its help.
102
+ func Group(cmd *cobra.Command) *cobra.Command {
103
+ cmd.Args = func(c *cobra.Command, args []string) error {
104
+ if len(args) > 0 {
105
+ return Usage("unknown command %q for %q", args[0], c.CommandPath())
106
+ }
107
+ return nil
108
+ }
109
+ cmd.RunE = func(c *cobra.Command, _ []string) error { return c.Help() }
110
+ return cmd
111
+ }
112
+
113
+ // Run runs root with args, writing to stdout and stderr, and returns the exit code its outcome
114
+ // maps to; an error is printed to stderr after the CLI's name. Ctrl-C cancels the call in flight.
115
+ func Run(root *cobra.Command, args []string, stdout, stderr io.Writer) int {
116
+ ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt)
117
+ defer stop()
118
+ root.SetArgs(args)
119
+ root.SetOut(stdout)
120
+ root.SetErr(stderr)
121
+ cmd, err := root.ExecuteContextC(ctx)
122
+ /* a stream Ctrl-C ends returns no error: the interrupt is the outcome */
123
+ interrupted := ctx.Err() != nil
124
+ if err != nil {
125
+ report(cmd, err, interrupted)
126
+ }
127
+ switch {
128
+ case interrupted:
129
+ return ExitInterrupted
130
+ case err == nil:
131
+ return ExitOK
132
+ }
133
+ return Exit(err)
134
+ }
135
+
136
+ // report writes err to stderr: under JSON (--json, or stdout not a terminal) as one line of
137
+ // {"error": {kind, status, errorKey, message}}, else after the CLI's name.
138
+ func report(cmd *cobra.Command, err error, interrupted bool) {
139
+ err = redirectHint(cmd, err)
140
+ stderr := cmd.ErrOrStderr()
141
+ if o, _ := outputOf(cmd, cmd.OutOrStdout()); o.format != "json" {
142
+ fmt.Fprintf(stderr, "%s: %s\n", cmd.Root().Name(), escapeControls(err.Error(), false))
143
+ return
144
+ }
145
+ line, _ := compact(map[string]any{"error": described(err, interrupted)})
146
+ stderr.Write(line)
147
+ }
148
+
149
+ // redirectHint is err, a redirect the run did not follow named with the way out; the run's own
150
+ // redirect setting decides, since under follow a redirect carrying a body is still not followed.
151
+ func redirectHint(cmd *cobra.Command, err error) error {
152
+ var api *APIError
153
+ if !errors.As(err, &api) || api.Status < 300 || api.Status > 399 || redirectOf(cmd) == "follow" {
154
+ return err
155
+ }
156
+ hinted := *api
157
+ hinted.Message = fmt.Sprintf("the API answered %d, a redirect not followed: rerun with --redirect follow to follow it", api.Status)
158
+ hinted.Err = errors.New(hinted.Message)
159
+ return &hinted
160
+ }
161
+
162
+ // described is err as a script reads it: its kind, and for an API answer its status and key.
163
+ func described(err error, interrupted bool) map[string]any {
164
+ out := map[string]any{"kind": kindOf(err, interrupted), "message": err.Error()}
165
+ var api *APIError
166
+ if errors.As(err, &api) {
167
+ out["status"] = api.Status
168
+ if api.Key != "" {
169
+ out["errorKey"] = api.Key
170
+ }
171
+ if api.Message != "" {
172
+ out["message"] = api.Message
173
+ }
174
+ }
175
+ return out
176
+ }
177
+
178
+ func kindOf(err error, interrupted bool) string {
179
+ var usage *UsageError
180
+ var api *APIError
181
+ var network net.Error
182
+ var closed *Closed
183
+ switch {
184
+ case interrupted:
185
+ return "interrupted"
186
+ case errors.As(err, &usage):
187
+ return "usage"
188
+ case errors.As(err, &api):
189
+ return "api"
190
+ case errors.Is(err, context.DeadlineExceeded), errors.As(err, &network) && network.Timeout():
191
+ return "timeout"
192
+ case errors.As(err, &network), errors.As(err, &closed), errors.Is(err, io.ErrUnexpectedEOF):
193
+ return "transport"
194
+ }
195
+ return "error"
196
+ }
197
+
198
+ // Exit is the code for err: 0 for none, then by its kind (the Exit constants).
199
+ func Exit(err error) int {
200
+ if err == nil {
201
+ return ExitOK
202
+ }
203
+ switch kindOf(err, false) {
204
+ case "usage":
205
+ return ExitUsage
206
+ case "api":
207
+ var api *APIError
208
+ errors.As(err, &api)
209
+ return statusExit(api.Status)
210
+ case "timeout", "transport":
211
+ return ExitTransport
212
+ }
213
+ return ExitError
214
+ }
215
+
216
+ // statusExit is the code for an answer's status outside 2xx.
217
+ func statusExit(status int) int {
218
+ switch {
219
+ case status >= 500:
220
+ return ExitServer
221
+ case status >= 400:
222
+ return ExitError
223
+ default:
224
+ return ExitRedirect
225
+ }
226
+ }
@@ -0,0 +1,60 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "bufio"
7
+ "context"
8
+ "errors"
9
+
10
+ "github.com/coder/websocket"
11
+ )
12
+
13
+ // Socket is a WebSocket connection as the SDK opens it.
14
+ type Socket interface {
15
+ Send(ctx context.Context, data any) error
16
+ Read(ctx context.Context) ([]byte, error)
17
+ Close(code websocket.StatusCode, reason string) error
18
+ }
19
+
20
+ // Converse sends each standard-input line as a text frame, reading on after its end, and prints
21
+ // each message as one line until the server closes, --take is met (a close frame 1000) or the run
22
+ // is interrupted (a close frame 1000 "interrupted").
23
+ func (s *Stream) Converse(conn Socket) error {
24
+ /* reads outlive Ctrl-C, so the close frame goes out and is answered */
25
+ ctx := context.WithoutCancel(s.c.Context())
26
+ stop := context.AfterFunc(s.c.Context(), func() { conn.Close(websocket.StatusNormalClosure, "interrupted") })
27
+ defer stop()
28
+ go func() {
29
+ lines := bufio.NewScanner(s.c.InOrStdin())
30
+ for lines.Scan() {
31
+ if conn.Send(ctx, lines.Text()) != nil {
32
+ return
33
+ }
34
+ }
35
+ }()
36
+ for {
37
+ message, err := conn.Read(ctx)
38
+ if err != nil {
39
+ return closedOf(err, s.c.Context().Err() != nil)
40
+ }
41
+ if !s.Write(textOf(message)) {
42
+ conn.Close(websocket.StatusNormalClosure, "")
43
+ return s.err
44
+ }
45
+ }
46
+ }
47
+
48
+ // closedOf is a read's end as the command's outcome: none for a normal close or an interrupt.
49
+ func closedOf(err error, interrupted bool) error {
50
+ var closed websocket.CloseError
51
+ switch {
52
+ case interrupted:
53
+ return nil
54
+ case !errors.As(err, &closed):
55
+ return &Closed{Code: -1, Err: err}
56
+ case closed.Code == websocket.StatusNormalClosure, closed.Code == websocket.StatusGoingAway:
57
+ return nil
58
+ }
59
+ return &Closed{Code: int(closed.Code), Reason: closed.Reason, Err: err}
60
+ }
@@ -0,0 +1,217 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "encoding/base64"
7
+ "encoding/json"
8
+ "fmt"
9
+ "io"
10
+ "os"
11
+ "unicode/utf8"
12
+
13
+ "github.com/spf13/cobra"
14
+ )
15
+
16
+ // Stream is where a stream command prints: each event as one line of compact JSON (a YAML
17
+ // document under yaml), until --take is met.
18
+ type Stream struct {
19
+ c *cobra.Command
20
+ o output
21
+ out io.Writer
22
+ file *os.File
23
+ take int
24
+ seen int
25
+ err error
26
+ }
27
+
28
+ // Take declares --take, the number of events a stream command prints before it ends.
29
+ func (p *Params) Take() {
30
+ p.cmd.Flags().Int("take", 0, "end after this many events (default: until the stream ends)")
31
+ }
32
+
33
+ // MaxReconnects declares --max-reconnects, how often a realtime command reconnects before it fails.
34
+ func (p *Params) MaxReconnects() {
35
+ p.cmd.Flags().Int("max-reconnects", 0, "reconnect at most this many times: 1 or more; default 5")
36
+ }
37
+
38
+ // Reconnects is --max-reconnects as given, 1 or more; 0 when it was not, the SDK's default.
39
+ func (p *Params) Reconnects() (int, error) {
40
+ if !p.cmd.Flags().Changed("max-reconnects") {
41
+ return 0, nil
42
+ }
43
+ n, _ := p.cmd.Flags().GetInt("max-reconnects")
44
+ if n < 1 {
45
+ return 0, Usage("--max-reconnects %d: want 1 or more", n)
46
+ }
47
+ return n, nil
48
+ }
49
+
50
+ // OpenStream checks a stream command's output flags before anything is sent: -i and --raw take one
51
+ // answer, --take is 1 or more, and a table prints as ndjson (one warning when it was asked for).
52
+ func OpenStream(c *cobra.Command) (*Stream, error) {
53
+ o, err := outputOf(c, c.OutOrStdout())
54
+ if err != nil {
55
+ return nil, err
56
+ }
57
+ if o.include || o.raw {
58
+ return nil, Usage("-i and --raw take one answer: %s streams", c.CommandPath())
59
+ }
60
+ take, _ := c.Flags().GetInt("take")
61
+ if c.Flags().Changed("take") && take < 1 {
62
+ return nil, Usage("--take %d: want 1 or more", take)
63
+ }
64
+ if o.format == "table" {
65
+ if c.Flags().Changed("format") {
66
+ fmt.Fprintf(c.ErrOrStderr(), "%s: a stream prints no table: ndjson instead\n", c.Root().Name())
67
+ }
68
+ o.format = "ndjson"
69
+ }
70
+ s := &Stream{c: c, o: o, out: c.OutOrStdout(), take: take}
71
+ if o.file != "" {
72
+ if s.file, err = os.Create(o.file); err != nil {
73
+ return nil, Usage("-o: %v", err)
74
+ }
75
+ s.out = s.file
76
+ }
77
+ return s, nil
78
+ }
79
+
80
+ // Close closes the file -o names, if any.
81
+ func (s *Stream) Close() {
82
+ if s.file != nil {
83
+ s.file.Close()
84
+ }
85
+ }
86
+
87
+ // Err is the first write that failed, if any.
88
+ func (s *Stream) Err() error { return s.err }
89
+
90
+ // an event line: the event's name and id when set, its data
91
+ type eventLine struct {
92
+ Event string `json:"event,omitempty"`
93
+ ID string `json:"id,omitempty"`
94
+ Data any `json:"data"`
95
+ }
96
+
97
+ // Event prints a server-sent event, its data as JSON when it is; false once the stream should end.
98
+ func (s *Stream) Event(name, id string, data any) bool {
99
+ if text, ok := data.(string); ok {
100
+ data = textOf([]byte(text))
101
+ }
102
+ return s.Write(eventLine{Event: name, ID: id, Data: data})
103
+ }
104
+
105
+ // Write prints one value as the stream's next line; false once --take is met or a write failed.
106
+ func (s *Stream) Write(v any) bool {
107
+ line, err := compact(v)
108
+ if err == nil && s.o.format == "yaml" {
109
+ var text []byte
110
+ if text, err = s.o.encode(v); err == nil {
111
+ line = append([]byte("---\n"), text...)
112
+ }
113
+ }
114
+ if err == nil {
115
+ _, err = s.out.Write(line)
116
+ }
117
+ if err != nil {
118
+ s.err = err
119
+ return false
120
+ }
121
+ s.seen++
122
+ return s.take == 0 || s.seen < s.take
123
+ }
124
+
125
+ // textOf is a message's bytes as printed: its JSON when it is JSON, else a string, and
126
+ // {"bytes": base64} when it is not UTF-8 (a string would lose them).
127
+ func textOf(raw []byte) any {
128
+ switch {
129
+ case !utf8.Valid(raw):
130
+ return map[string]string{"bytes": base64.StdEncoding.EncodeToString(raw)}
131
+ case json.Valid(raw):
132
+ return json.RawMessage(raw)
133
+ }
134
+ return string(raw)
135
+ }
136
+
137
+ // Closed is a connection the server closed with a code other than 1000 or 1001, or that dropped
138
+ // (code -1): a transport failure.
139
+ type Closed struct {
140
+ Code int
141
+ Reason string
142
+ Err error
143
+ }
144
+
145
+ func (e *Closed) Error() string {
146
+ if e.Code < 0 {
147
+ return fmt.Sprintf("the connection dropped: %v", e.Err)
148
+ }
149
+ return fmt.Sprintf("the server closed the connection: %d %s", e.Code, e.Reason)
150
+ }
151
+
152
+ // Feed is a realtime connection as the SDK opens it.
153
+ type Feed interface {
154
+ Events() <-chan any
155
+ Errors() <-chan error
156
+ Cursor() (lastEventID, reconnectToken string)
157
+ Close() error
158
+ }
159
+
160
+ // Resume prints each event a realtime feed delivers until it ends, --take is met or the run is
161
+ // interrupted; then its cursor, to resume from.
162
+ func (s *Stream) Resume(feed Feed) error {
163
+ err := s.follow(feed)
164
+ feed.Close()
165
+ s.Cursor(feed.Cursor())
166
+ return err
167
+ }
168
+
169
+ func (s *Stream) follow(feed Feed) error {
170
+ for {
171
+ select {
172
+ case <-s.c.Context().Done():
173
+ return nil
174
+ case err := <-feed.Errors():
175
+ return err
176
+ case v, ok := <-feed.Events():
177
+ if !ok {
178
+ return nil
179
+ }
180
+ if text, isText := v.(string); isText {
181
+ v = textOf([]byte(text))
182
+ }
183
+ if !s.Write(v) {
184
+ return s.err
185
+ }
186
+ }
187
+ }
188
+ }
189
+
190
+ // Cursor writes where a feed stopped to stderr, to resume from with --reconnect-token and
191
+ // --last-event-id: one JSON line under JSON, else after the CLI's name; nothing when there is none.
192
+ func (s *Stream) Cursor(lastEventID, reconnectToken string) {
193
+ if lastEventID == "" && reconnectToken == "" {
194
+ return
195
+ }
196
+ stderr := s.c.ErrOrStderr()
197
+ if s.o.format != "json" {
198
+ var flags string
199
+ if reconnectToken != "" {
200
+ flags += " --reconnect-token " + reconnectToken
201
+ }
202
+ if lastEventID != "" {
203
+ flags += " --last-event-id " + lastEventID
204
+ }
205
+ fmt.Fprintf(stderr, "%s: resume with%s\n", s.c.Root().Name(), escapeControls(flags, false))
206
+ return
207
+ }
208
+ cursor := map[string]string{}
209
+ if lastEventID != "" {
210
+ cursor["lastEventId"] = lastEventID
211
+ }
212
+ if reconnectToken != "" {
213
+ cursor["reconnectToken"] = reconnectToken
214
+ }
215
+ line, _ := compact(map[string]any{"resume": cursor})
216
+ stderr.Write(line)
217
+ }