@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,147 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "io"
7
+ "slices"
8
+ "strings"
9
+ "unicode"
10
+
11
+ "github.com/spf13/cobra"
12
+ )
13
+
14
+ // Entry is one API command as discovery shows it: its path, its usage line, the words a search
15
+ // matches, its schema, and each of those as JSON.
16
+ type Entry struct {
17
+ Path, Line, Words, JSON, Schema, SchemaJSON string
18
+ }
19
+
20
+ // Discovery is every API command's entry, sorted by path.
21
+ type Discovery struct {
22
+ Entries []Entry
23
+ }
24
+
25
+ // the help groups: the commands that call the API, and those that never do
26
+ const (
27
+ apiGroup = "api"
28
+ localGroup = "local"
29
+ )
30
+
31
+ // the index's first line: the commands that never call the API
32
+ const localLine = "local: commands completion config schema skill"
33
+
34
+ // discover adds the local commands: `commands` (and `commands search`), `schema` and `skill`.
35
+ // The index is text even when piped (the CLI's own reference, not an answer); --json gives one
36
+ // object per line.
37
+ func discover(root *cobra.Command, app App) {
38
+ d := app.Discovery
39
+ commands := &cobra.Command{
40
+ Use: "commands",
41
+ Short: "list every command, one usage line each (text even when piped; --json: one object per line)",
42
+ GroupID: localGroup,
43
+ Args: cobra.NoArgs,
44
+ RunE: func(c *cobra.Command, _ []string) error { return d.print(c, d.Entries, true) },
45
+ }
46
+ commands.AddCommand(&cobra.Command{
47
+ Use: "search <query>",
48
+ Short: "the 5 commands sharing the most words with the query",
49
+ Args: cobra.MinimumNArgs(1),
50
+ RunE: func(c *cobra.Command, args []string) error {
51
+ return d.print(c, d.search(strings.Join(args, " ")), false)
52
+ },
53
+ })
54
+ schema := &cobra.Command{
55
+ Use: "schema <command>",
56
+ Short: "a command's request and answer: usage, method and path, body, result or events, errors",
57
+ GroupID: localGroup,
58
+ Args: cobra.MinimumNArgs(1),
59
+ RunE: func(c *cobra.Command, args []string) error {
60
+ path := strings.Join(args, " ")
61
+ at := slices.IndexFunc(d.Entries, func(e Entry) bool { return e.Path == path })
62
+ if at < 0 {
63
+ return Usage("no command %q: see %s commands", path, c.Root().Name())
64
+ }
65
+ text := d.Entries[at].Schema
66
+ if jsonAsked(c) {
67
+ text = d.Entries[at].SchemaJSON
68
+ }
69
+ _, err := io.WriteString(c.OutOrStdout(), text+"\n")
70
+ return err
71
+ },
72
+ }
73
+ skill := &cobra.Command{
74
+ Use: "skill",
75
+ Short: "print the agent skill (SKILL.md) this CLI ships",
76
+ GroupID: localGroup,
77
+ Args: cobra.NoArgs,
78
+ RunE: func(c *cobra.Command, _ []string) error {
79
+ _, err := io.WriteString(c.OutOrStdout(), app.Skill)
80
+ return err
81
+ },
82
+ }
83
+ root.AddCommand(commands, schema, skill)
84
+ }
85
+
86
+ // jsonAsked is whether the run asked for JSON: --json, or --format json or ndjson.
87
+ func jsonAsked(c *cobra.Command) bool {
88
+ on, _ := c.Flags().GetBool("json")
89
+ format, _ := c.Flags().GetString("format")
90
+ return on || format == "json" || format == "ndjson"
91
+ }
92
+
93
+ // print writes entries: their usage lines (the local line first when local), or a JSON object each.
94
+ func (d Discovery) print(c *cobra.Command, entries []Entry, local bool) error {
95
+ var b strings.Builder
96
+ asJSON := jsonAsked(c)
97
+ if local && !asJSON {
98
+ b.WriteString(localLine + "\n")
99
+ }
100
+ for _, e := range entries {
101
+ if asJSON {
102
+ b.WriteString(e.JSON + "\n")
103
+ } else {
104
+ b.WriteString(e.Line + "\n")
105
+ }
106
+ }
107
+ _, err := io.WriteString(c.OutOrStdout(), b.String())
108
+ return err
109
+ }
110
+
111
+ // search is the 5 entries sharing the most words with query, ties in path order; one sharing
112
+ // none is never a hit.
113
+ func (d Discovery) search(query string) []Entry {
114
+ asked := wordsOf(query)
115
+ type hit struct{ at, score int }
116
+ var hits []hit
117
+ for i, e := range d.Entries {
118
+ have := wordsOf(e.Words)
119
+ score := 0
120
+ for _, w := range asked {
121
+ if slices.Contains(have, w) {
122
+ score++
123
+ }
124
+ }
125
+ if score > 0 {
126
+ hits = append(hits, hit{i, score})
127
+ }
128
+ }
129
+ slices.SortStableFunc(hits, func(a, b hit) int { return b.score - a.score })
130
+ out := make([]Entry, 0, 5)
131
+ for _, h := range hits[:min(5, len(hits))] {
132
+ out = append(out, d.Entries[h.at])
133
+ }
134
+ return out
135
+ }
136
+
137
+ // wordsOf is text's distinct lowercase words: its runs of letters and digits.
138
+ func wordsOf(text string) []string {
139
+ var out []string
140
+ split := func(r rune) bool { return !unicode.IsLetter(r) && !unicode.IsDigit(r) }
141
+ for _, w := range strings.FieldsFunc(strings.ToLower(text), split) {
142
+ if !slices.Contains(out, w) {
143
+ out = append(out, w)
144
+ }
145
+ }
146
+ return out
147
+ }
@@ -0,0 +1,174 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "bytes"
7
+ "encoding/json"
8
+ "regexp"
9
+ "strings"
10
+ "text/tabwriter"
11
+ )
12
+
13
+ // a mapping key YAML reads as itself, unquoted
14
+ var plainKey = regexp.MustCompile(`^[A-Za-z_][A-Za-z0-9_-]*$`)
15
+
16
+ // keys a YAML reader would take as a boolean or null, so they are quoted
17
+ var yamlWords = map[string]bool{
18
+ "true": true, "false": true, "null": true, "yes": true, "no": true, "on": true, "off": true, "y": true, "n": true,
19
+ }
20
+
21
+ // yamlOf is a decoded JSON value as a YAML document: block mappings and sequences, every string
22
+ // double-quoted as JSON writes it (a YAML double-quoted scalar), numbers and booleans as they are.
23
+ func yamlOf(value any) string {
24
+ var out strings.Builder
25
+ writeYAML(&out, value, "")
26
+ return out.String()
27
+ }
28
+
29
+ func writeYAML(out *strings.Builder, value any, indent string) {
30
+ switch v := value.(type) {
31
+ case map[string]any:
32
+ if len(v) == 0 {
33
+ out.WriteString(indent + "{}\n")
34
+ return
35
+ }
36
+ for _, key := range sortedKeys(v) {
37
+ out.WriteString(indent + yamlKey(key) + ":")
38
+ writeNested(out, v[key], indent+" ")
39
+ }
40
+ case []any:
41
+ if len(v) == 0 {
42
+ out.WriteString(indent + "[]\n")
43
+ return
44
+ }
45
+ for _, item := range v {
46
+ var nested strings.Builder
47
+ writeYAML(&nested, item, indent+" ")
48
+ out.WriteString(indent + "- " + strings.TrimPrefix(nested.String(), indent+" "))
49
+ }
50
+ default:
51
+ out.WriteString(indent + yamlScalar(v) + "\n")
52
+ }
53
+ }
54
+
55
+ // writeNested writes a mapping's value after its key: a scalar or an empty collection on the
56
+ // key's line, anything else on the lines below.
57
+ func writeNested(out *strings.Builder, value any, indent string) {
58
+ switch v := value.(type) {
59
+ case map[string]any:
60
+ if len(v) > 0 {
61
+ out.WriteString("\n")
62
+ writeYAML(out, v, indent)
63
+ return
64
+ }
65
+ case []any:
66
+ if len(v) > 0 {
67
+ out.WriteString("\n")
68
+ writeYAML(out, v, indent)
69
+ return
70
+ }
71
+ }
72
+ var line strings.Builder
73
+ writeYAML(&line, value, "")
74
+ out.WriteString(" " + line.String())
75
+ }
76
+
77
+ func yamlKey(key string) string {
78
+ if plainKey.MatchString(key) && !yamlWords[strings.ToLower(key)] {
79
+ return key
80
+ }
81
+ return yamlScalar(key)
82
+ }
83
+
84
+ // yamlScalar is a scalar's YAML: its JSON, which YAML 1.2 reads as the same value.
85
+ func yamlScalar(value any) string {
86
+ line, _ := compact(value)
87
+ return strings.TrimSuffix(string(line), "\n")
88
+ }
89
+
90
+ // tableOf is a decoded JSON value as a table for a person: a list of objects one row each under
91
+ // a column per key, an object a row per key, anything else one value per line.
92
+ func tableOf(value any) []byte {
93
+ var out bytes.Buffer
94
+ w := tabwriter.NewWriter(&out, 0, 0, 2, ' ', 0)
95
+ switch v := value.(type) {
96
+ case []any:
97
+ if columns, ok := columnsOf(v); ok {
98
+ writeRow(w, upper(columns))
99
+ for _, item := range v {
100
+ row := item.(map[string]any)
101
+ cells := make([]string, len(columns))
102
+ for i, column := range columns {
103
+ cells[i] = cell(row[column])
104
+ }
105
+ writeRow(w, cells)
106
+ }
107
+ break
108
+ }
109
+ for _, item := range v {
110
+ writeRow(w, []string{cell(item)})
111
+ }
112
+ case map[string]any:
113
+ for _, key := range sortedKeys(v) {
114
+ writeRow(w, []string{escapeControls(key, false), cell(v[key])})
115
+ }
116
+ default:
117
+ writeRow(w, []string{cell(v)})
118
+ }
119
+ w.Flush()
120
+ // an empty last cell leaves padding behind it: no line ends in spaces
121
+ lines := strings.Split(out.String(), "\n")
122
+ for i, line := range lines {
123
+ lines[i] = strings.TrimRight(line, " ")
124
+ }
125
+ return []byte(strings.Join(lines, "\n"))
126
+ }
127
+
128
+ // columnsOf is the keys of every object in items, in order; false unless every item is an object.
129
+ func columnsOf(items []any) ([]string, bool) {
130
+ seen := map[string]any{}
131
+ for _, item := range items {
132
+ row, ok := item.(map[string]any)
133
+ if !ok {
134
+ return nil, false
135
+ }
136
+ for key := range row {
137
+ seen[key] = nil
138
+ }
139
+ }
140
+ return sortedKeys(seen), len(items) > 0
141
+ }
142
+
143
+ func upper(columns []string) []string {
144
+ out := make([]string, len(columns))
145
+ for i, column := range columns {
146
+ out[i] = strings.ToUpper(escapeControls(column, false))
147
+ }
148
+ return out
149
+ }
150
+
151
+ func writeRow(w *tabwriter.Writer, cells []string) {
152
+ w.Write([]byte(strings.Join(cells, "\t") + "\n"))
153
+ }
154
+
155
+ // cell is a value as one table cell: a string as it is, its control characters escaped (a
156
+ // newline or tab too, so the row holds); a number or boolean as written; a list or object as
157
+ // compact JSON; nothing for null.
158
+ func cell(value any) string {
159
+ switch v := value.(type) {
160
+ case nil:
161
+ return ""
162
+ case string:
163
+ return escapeControls(v, false)
164
+ case json.Number:
165
+ return v.String()
166
+ case bool:
167
+ if v {
168
+ return "true"
169
+ }
170
+ return "false"
171
+ }
172
+ line, _ := compact(value)
173
+ return strings.TrimSuffix(string(line), "\n")
174
+ }
@@ -0,0 +1,117 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "fmt"
7
+ "net/http"
8
+ "regexp"
9
+ "slices"
10
+ "sort"
11
+ "strings"
12
+ )
13
+
14
+ // the text a redacted secret is written as
15
+ const redacted = "[redacted]"
16
+
17
+ // a realtime dial's resume cursor
18
+ var resumeCursor = regexp.MustCompile(`([?&](?:reconnect_token|last_event_id)=)[^&#]*`)
19
+
20
+ // LogRequest writes a request to stderr under --verbose: its method and URL, then its headers,
21
+ // each secret redacted.
22
+ func (c Config) LogRequest(method, url string, header http.Header) {
23
+ if !c.Verbose {
24
+ return
25
+ }
26
+ fmt.Fprintf(c.log, "> %s %s\n", method, c.redact(resumeCursor.ReplaceAllString(url, "${1}"+redacted)))
27
+ c.logHeaders(">", header)
28
+ }
29
+
30
+ // LogResponse writes a response's status and headers to stderr under --verbose, each secret redacted.
31
+ func (c Config) LogResponse(status int, header http.Header) {
32
+ if !c.Verbose {
33
+ return
34
+ }
35
+ fmt.Fprintf(c.log, "< %d\n", status)
36
+ c.logHeaders("<", header)
37
+ }
38
+
39
+ func (c Config) logHeaders(mark string, header http.Header) {
40
+ names := make([]string, 0, len(header))
41
+ for name := range header {
42
+ names = append(names, name)
43
+ }
44
+ sort.Strings(names)
45
+ for _, name := range names {
46
+ for _, value := range header[name] {
47
+ if secretHeader(name) {
48
+ value = redacted
49
+ }
50
+ fmt.Fprintf(c.log, "%s %s: %s\n", mark, strings.ToLower(name), c.redact(value))
51
+ }
52
+ }
53
+ }
54
+
55
+ // secretHeader is whether a header's value is a credential: by its name, whatever its value.
56
+ func secretHeader(name string) bool {
57
+ lower := strings.ToLower(name)
58
+ switch lower {
59
+ case "authorization", "proxy-authorization", "cookie", "set-cookie", "last-event-id":
60
+ return true
61
+ }
62
+ for _, word := range []string{"key", "token", "secret", "password", "session", "auth"} {
63
+ if strings.Contains(lower, word) {
64
+ return true
65
+ }
66
+ }
67
+ return false
68
+ }
69
+
70
+ // redact replaces each of the run's secrets in text, wherever it appears (a URL's query, say).
71
+ func (c Config) redact(text string) string {
72
+ for _, secret := range c.secrets {
73
+ text = strings.ReplaceAll(text, secret, redacted)
74
+ }
75
+ return text
76
+ }
77
+
78
+ // secretsOf is the run's secret values: the API key, and each header whose name marks a
79
+ // credential, each also as the SDK escapes it into a URL (a key holding + / = travels so).
80
+ func secretsOf(cfg Config) []string {
81
+ var secrets []string
82
+ add := func(secret string) {
83
+ for _, form := range []string{secret, escaped(secret, "-_.!~*'()", false), escaped(secret, "*-._", true)} {
84
+ if !slices.Contains(secrets, form) {
85
+ secrets = append(secrets, form)
86
+ }
87
+ }
88
+ }
89
+ if cfg.APIKey != "" {
90
+ add(cfg.APIKey)
91
+ }
92
+ for name, value := range cfg.Headers {
93
+ if value != "" && secretHeader(name) {
94
+ add(value)
95
+ }
96
+ }
97
+ return secrets
98
+ }
99
+
100
+ // escaped is s percent-encoded as the SDK encodes it: every byte but letters, digits and keep;
101
+ // "-_.!~*'()" is a path segment's (encodeURIComponent), "*-._" with a space as '+' a query
102
+ // value's (URLSearchParams).
103
+ func escaped(s, keep string, spaceAsPlus bool) string {
104
+ var b strings.Builder
105
+ for i := 0; i < len(s); i++ {
106
+ c := s[i]
107
+ switch {
108
+ case (c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || strings.IndexByte(keep, c) >= 0:
109
+ b.WriteByte(c)
110
+ case c == ' ' && spaceAsPlus:
111
+ b.WriteByte('+')
112
+ default:
113
+ fmt.Fprintf(&b, "%%%02X", c)
114
+ }
115
+ }
116
+ return b.String()
117
+ }
@@ -0,0 +1,247 @@
1
+ // Code generated by honey. DO NOT EDIT.
2
+
3
+ package cli
4
+
5
+ import (
6
+ "bytes"
7
+ "encoding/json"
8
+ "fmt"
9
+ "io"
10
+ "net/http"
11
+ "os"
12
+ "sort"
13
+ "strings"
14
+
15
+ "github.com/spf13/cobra"
16
+ )
17
+
18
+ // Answer is one call's outcome as the CLI prints it: the SDK's decoded data (bytes and text as
19
+ // they came), the response it arrived on, and the response headers the operation declares.
20
+ type Answer struct {
21
+ Data any
22
+ Response *http.Response
23
+ Declared []string
24
+ }
25
+
26
+ // output is how a run prints: its format, whether it wraps the answer, and where it writes.
27
+ type output struct {
28
+ format string
29
+ include bool
30
+ raw bool
31
+ file string
32
+ }
33
+
34
+ // outputFlags declares the flags that choose how an answer is printed.
35
+ func outputFlags(root *cobra.Command) {
36
+ f := root.PersistentFlags()
37
+ f.String("format", "", "json, ndjson, yaml or table (default table on a terminal, json otherwise)")
38
+ f.Bool("json", false, "print one line of compact JSON: --format json")
39
+ f.StringP("output", "o", "", "write the answer to this file instead of standard output")
40
+ f.BoolP("include", "i", false, "print {status, headers, data}: the declared response headers beside the data")
41
+ f.Bool("raw", false, "print {status, headers, body}: the response as it came")
42
+ }
43
+
44
+ // outputOf resolves c's output flags; stdout is where the answer goes when no file is named.
45
+ func outputOf(c *cobra.Command, stdout io.Writer) (output, error) {
46
+ flags := c.Flags()
47
+ o := output{}
48
+ o.file, _ = flags.GetString("output")
49
+ o.include, _ = flags.GetBool("include")
50
+ o.raw, _ = flags.GetBool("raw")
51
+ o.format, _ = flags.GetString("format")
52
+ asJSON, _ := flags.GetBool("json")
53
+ switch {
54
+ case asJSON && o.format != "" && o.format != "json":
55
+ return output{format: "json"}, Usage("--json and --format %s disagree", o.format)
56
+ case asJSON:
57
+ o.format = "json"
58
+ case o.format == "" && o.file == "" && terminal(stdout):
59
+ o.format = "table"
60
+ case o.format == "":
61
+ o.format = "json"
62
+ }
63
+ switch o.format {
64
+ case "json", "ndjson", "yaml", "table":
65
+ return o, nil
66
+ }
67
+ return output{format: "json"}, Usage("--format %q: want json, ndjson, yaml or table", o.format)
68
+ }
69
+
70
+ // terminal is whether w is a terminal a person reads.
71
+ func terminal(w io.Writer) bool {
72
+ file, ok := w.(*os.File)
73
+ if !ok {
74
+ return false
75
+ }
76
+ info, err := file.Stat()
77
+ return err == nil && info.Mode()&os.ModeCharDevice != 0
78
+ }
79
+
80
+ // Print writes an answer by the run's output flags: to the file -o names, else to stdout.
81
+ func Print(c *cobra.Command, answer Answer) error {
82
+ o, err := outputOf(c, c.OutOrStdout())
83
+ if err != nil {
84
+ return err
85
+ }
86
+ text, err := o.render(answer, terminal(c.OutOrStdout()) && o.file == "")
87
+ if err != nil {
88
+ return err
89
+ }
90
+ if o.file != "" {
91
+ if err := os.WriteFile(o.file, text, 0o644); err != nil {
92
+ return Usage("-o: %v", err)
93
+ }
94
+ return nil
95
+ }
96
+ _, err = c.OutOrStdout().Write(text)
97
+ return err
98
+ }
99
+
100
+ // render is the bytes an answer prints as; tty is whether they reach a terminal.
101
+ func (o output) render(answer Answer, tty bool) ([]byte, error) {
102
+ if o.raw {
103
+ return o.encode(rawOf(answer))
104
+ }
105
+ if data, ok := answer.Data.([]byte); ok {
106
+ if o.include || tty {
107
+ return nil, Usage("the answer is binary: write it with -o <file>, or pipe it")
108
+ }
109
+ return data, nil
110
+ }
111
+ if o.include {
112
+ return o.encode(map[string]any{"status": statusOf(answer), "headers": declared(answer), "data": answer.Data})
113
+ }
114
+ switch data := answer.Data.(type) {
115
+ case nil:
116
+ return nil, nil
117
+ case string:
118
+ if tty {
119
+ data = escapeControls(data, true)
120
+ }
121
+ return []byte(data), nil
122
+ }
123
+ return o.encode(answer.Data)
124
+ }
125
+
126
+ func statusOf(answer Answer) int {
127
+ if answer.Response == nil {
128
+ return 0
129
+ }
130
+ return answer.Response.StatusCode
131
+ }
132
+
133
+ // declared is each declared response header the answer carried, by its lowercase name.
134
+ func declared(answer Answer) map[string]string {
135
+ out := map[string]string{}
136
+ if answer.Response == nil {
137
+ return out
138
+ }
139
+ for _, name := range answer.Declared {
140
+ if values := answer.Response.Header.Values(name); len(values) > 0 {
141
+ out[strings.ToLower(name)] = strings.Join(values, ", ")
142
+ }
143
+ }
144
+ return out
145
+ }
146
+
147
+ // rawOf is the response as it came: its status, every header, and its body as text.
148
+ func rawOf(answer Answer) map[string]any {
149
+ headers := map[string]string{}
150
+ body := ""
151
+ if answer.Response != nil {
152
+ for name, values := range answer.Response.Header {
153
+ headers[strings.ToLower(name)] = strings.Join(values, ", ")
154
+ }
155
+ if answer.Response.Body != nil {
156
+ read, _ := io.ReadAll(answer.Response.Body)
157
+ body = string(read)
158
+ }
159
+ }
160
+ return map[string]any{"status": statusOf(answer), "headers": headers, "body": body}
161
+ }
162
+
163
+ // encode writes v in the run's format, each line or document ended.
164
+ func (o output) encode(v any) ([]byte, error) {
165
+ line, err := compact(v)
166
+ if err != nil || o.format == "json" {
167
+ return line, err
168
+ }
169
+ var value any
170
+ decoder := json.NewDecoder(bytes.NewReader(line))
171
+ decoder.UseNumber()
172
+ if err := decoder.Decode(&value); err != nil {
173
+ return nil, err
174
+ }
175
+ switch o.format {
176
+ case "ndjson":
177
+ return ndjson(value)
178
+ case "yaml":
179
+ return []byte(yamlOf(value)), nil
180
+ }
181
+ return tableOf(value), nil
182
+ }
183
+
184
+ // compact is v as one line of JSON, the line ended: <, > and & as themselves, and DEL and the
185
+ // C1 controls (which Go leaves raw, and a terminal may act on) escaped, the value the same.
186
+ func compact(v any) ([]byte, error) {
187
+ var out bytes.Buffer
188
+ encoder := json.NewEncoder(&out)
189
+ encoder.SetEscapeHTML(false)
190
+ if err := encoder.Encode(v); err != nil {
191
+ return nil, err
192
+ }
193
+ var safe bytes.Buffer
194
+ for _, r := range out.String() {
195
+ if r >= 0x7f && r <= 0x9f {
196
+ fmt.Fprintf(&safe, "\\u%04x", r)
197
+ continue
198
+ }
199
+ safe.WriteRune(r)
200
+ }
201
+ return safe.Bytes(), nil
202
+ }
203
+
204
+ // ndjson is a list as one compact line per item; anything else as one line.
205
+ func ndjson(value any) ([]byte, error) {
206
+ items, ok := value.([]any)
207
+ if !ok {
208
+ return compact(value)
209
+ }
210
+ var out bytes.Buffer
211
+ for _, item := range items {
212
+ line, err := compact(item)
213
+ if err != nil {
214
+ return nil, err
215
+ }
216
+ out.Write(line)
217
+ }
218
+ return out.Bytes(), nil
219
+ }
220
+
221
+ // escapeControls writes each control character as its Go escape (\x1b), so data never drives a
222
+ // terminal; newlines and tabs stay as they are when keepLines.
223
+ func escapeControls(text string, keepLines bool) string {
224
+ var out strings.Builder
225
+ for _, r := range text {
226
+ switch {
227
+ case keepLines && (r == '\n' || r == '\t'):
228
+ out.WriteRune(r)
229
+ case r < 0x20 || (r >= 0x7f && r <= 0x9f) || r == 0x2028 || r == 0x2029 || r == 0xfeff:
230
+ quoted := fmt.Sprintf("%+q", string(r))
231
+ out.WriteString(quoted[1 : len(quoted)-1])
232
+ default:
233
+ out.WriteRune(r)
234
+ }
235
+ }
236
+ return out.String()
237
+ }
238
+
239
+ // sortedKeys is a map's keys in order.
240
+ func sortedKeys(m map[string]any) []string {
241
+ keys := make([]string, 0, len(m))
242
+ for key := range m {
243
+ keys = append(keys, key)
244
+ }
245
+ sort.Strings(keys)
246
+ return keys
247
+ }