@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,27 @@
1
+ /**
2
+ * One command per operation (bit 17), by its dotted id: `items.get` is `items get`, `a.b.c` is `a b c`, a flat id
3
+ * (`getRoot`) a top-level `get-root`. The verb is the id's last segment as authored, never renamed. In a group a
4
+ * subgroup claims its name before a command, and at the root every built-in (completion, commands, config, help,
5
+ * schema, skill, version) is taken first, so a clash is suffixed as the IR suffixes ids (`version2`). Each command calls
6
+ * the embedded SDK's own method by the emitter's call plan, its body read from its flags (a multipart one part by
7
+ * part), and prints the answer with the response it came on, or a stream's events one line each (phase d).
8
+ */
9
+ import type { IR } from "../../ir/model.ts";
10
+ import type { SdkOp } from "../../ir/sdk-model.ts";
11
+ import type { GoCallPlan } from "../go/sdk-client.ts";
12
+ /** The root's own commands, each taken before an operation's. */
13
+ export declare const BUILT_INS: string[];
14
+ /** A command node: a group of others, or one operation's command. */
15
+ export type CommandNode = {
16
+ readonly name: string;
17
+ readonly fn: string;
18
+ readonly children: readonly CommandNode[];
19
+ readonly op?: {
20
+ readonly op: SdkOp;
21
+ readonly plan: GoCallPlan;
22
+ };
23
+ };
24
+ /** The command tree under the root, by the ids of every operation `ops` holds a command for. */
25
+ export declare function commandTree(ops: readonly SdkOp[], plans: Readonly<Record<string, GoCallPlan>>): CommandNode[];
26
+ /** A group's command function, then each of its children's. */
27
+ export declare function groupFuncs(node: CommandNode, path: readonly string[], ir: IR): string[][];
@@ -0,0 +1,187 @@
1
+ import { goString, lineComment } from "../shared/escape.js";
2
+ import { compareCodeUnits, NameScope, pascalWords } from "../shared/lang.js";
3
+ import { commandFlags, helpText, kebab } from "./flags.js";
4
+ /** The root's own commands, each taken before an operation's. */
5
+ export const BUILT_INS = ["commands", "completion", "config", "help", "schema", "skill", "version"];
6
+ function rawTree(ops, plans) {
7
+ const root = { groups: new Map(), leaves: new Map() };
8
+ for (const op of [...ops].sort((a, b) => compareCodeUnits(a.id, b.id))) {
9
+ let at = root;
10
+ for (const segment of op.segments.slice(0, -1)) {
11
+ if (!at.groups.has(segment))
12
+ at.groups.set(segment, { groups: new Map(), leaves: new Map() });
13
+ at = at.groups.get(segment);
14
+ }
15
+ at.leaves.set(op.segments.at(-1), { op, plan: plans[op.id] });
16
+ }
17
+ return root;
18
+ }
19
+ /** `raw` named: its groups first, then its commands, each claimed in its parent's scope; funcs claimed in `funcs`. */
20
+ function named(raw, path, scope, funcs) {
21
+ const groups = [...raw.groups].sort(([a], [b]) => compareCodeUnits(a, b));
22
+ const leaves = [...raw.leaves].sort(([a], [b]) => compareCodeUnits(a, b));
23
+ return [
24
+ ...groups.map(([segment, child]) => {
25
+ const name = scope.claim(kebab(segment));
26
+ const at = [...path, name];
27
+ return {
28
+ children: named(child, at, new NameScope(), funcs),
29
+ fn: funcs.claim(`new${pascalWords(at.join(" "))}Cmd`),
30
+ name,
31
+ };
32
+ }),
33
+ ...leaves.map(([segment, leaf]) => {
34
+ const name = scope.claim(kebab(segment));
35
+ return { children: [], fn: funcs.claim(`new${pascalWords([...path, name].join(" "))}Cmd`), name, op: leaf };
36
+ }),
37
+ ];
38
+ }
39
+ /** The command tree under the root, by the ids of every operation `ops` holds a command for. */
40
+ export function commandTree(ops, plans) {
41
+ return named(rawTree(ops, plans), [], new NameScope(BUILT_INS), new NameScope(["Root", "newClient", "failed"]));
42
+ }
43
+ /** A named type of the SDK's, as package cmd spells it: `sdk.` before each exported name. */
44
+ const qualified = (type) => type.replace(/(?<![\w.])([A-Z]\w*)/g, "sdk.$1");
45
+ /** A multipart body's statements: each file part from its opened files, each text part from its flag. */
46
+ function multipartLines(type, parts) {
47
+ const lines = [`\tvar body ${type}`];
48
+ for (const [i, part] of parts.entries()) {
49
+ if (!part.file) {
50
+ lines.push(`\tif err := cli.Set(&body.${part.field}, p.Values(${goString(part.flag)})); err != nil {`, "\t\treturn err", "\t}");
51
+ continue;
52
+ }
53
+ const file = "sdk.FilePart{Filename: upload.Filename, Data: upload.Data}";
54
+ const set = part.list ? `body.${part.field} = append(body.${part.field}, ${file})` : `body.${part.field} = ${file}`;
55
+ lines.push(`\tuploads${i}, err := p.Files(${goString(part.flag)})`, "\tif err != nil {", "\t\treturn err", "\t}", `\tfor _, upload := range uploads${i} {`, `\t\t${set}`, "\t}");
56
+ }
57
+ return lines;
58
+ }
59
+ /** The statements reading the body, and the argument passing it. */
60
+ function bodyLines(op, plan, flags) {
61
+ const { fields } = flags;
62
+ const body = op.body;
63
+ if (body === undefined)
64
+ return [[], ""];
65
+ const required = String(body.required);
66
+ const map = `map[string]string{${fields.map(([flag, key]) => `${goString(flag)}: ${goString(key)}`).join(", ")}}`;
67
+ const fail = ["\tif err != nil {", "\t\treturn err", "\t}"];
68
+ switch (body.kind) {
69
+ case "json": {
70
+ /* a pointer type decodes as well: json.Unmarshal allocates it, and an absent optional body stays nil */
71
+ const read = `\tif err := p.JSON(&body, ${required}, ${map}); err != nil {`;
72
+ return [[`\tvar body ${qualified(plan.bodyType)}`, read, "\t\treturn err", "\t}"], ", body"];
73
+ }
74
+ case "form":
75
+ return [[`\tbody, err := p.Form(${required}, ${map})`, ...fail], ", body"];
76
+ case "text":
77
+ return [[`\tbody, err := p.Text(${required})`, ...fail], ", body"];
78
+ case "multipart":
79
+ return [multipartLines(qualified(plan.bodyType), flags.parts), ", body"];
80
+ default:
81
+ return [[`\tbody, err := p.Reader(${required})`, ...fail], ", body"];
82
+ }
83
+ }
84
+ /** A stream's call: its stream opened first (its output flags checked), then each event printed as it comes. */
85
+ function streamLines(call, stream) {
86
+ const open = ["\tout, err := cli.OpenStream(c)", "\tif err != nil {", "\t\treturn err", "\t}", "\tdefer out.Close()"];
87
+ if (stream === "sse")
88
+ return [
89
+ ...open,
90
+ `\tfor event, err := range ${call} {`,
91
+ "\t\tif err != nil {",
92
+ "\t\t\treturn failed(err)",
93
+ "\t\t}",
94
+ "\t\tif !out.Event(event.Event, event.ID, event.Data) {",
95
+ "\t\t\tbreak",
96
+ "\t\t}",
97
+ "\t}",
98
+ "\treturn out.Err()",
99
+ ];
100
+ return [
101
+ ...open,
102
+ `\tconn, err := ${call}`,
103
+ "\tif err != nil {",
104
+ "\t\treturn failed(err)",
105
+ "\t}",
106
+ stream === "realtime" ? "\treturn failed(out.Resume(conn))" : "\treturn out.Converse(conn)",
107
+ ];
108
+ }
109
+ /** The call and what follows it, by what the method returns: the answer printed with the response it came on. */
110
+ function callLines(call, plan) {
111
+ const declared = Object.keys(plan.responseHeaders?.fields ?? {})
112
+ .map(goString)
113
+ .join(", ");
114
+ const answer = (data) => `\treturn cli.Print(c, cli.Answer{${data}Response: resp, Declared: []string{${declared}}})`;
115
+ if (plan.returns === "error")
116
+ return [
117
+ "\tvar resp *http.Response",
118
+ `\tif err := ${call}; err != nil {`,
119
+ "\t\treturn failed(err)",
120
+ "\t}",
121
+ answer(""),
122
+ ];
123
+ return [
124
+ "\tvar resp *http.Response",
125
+ `\tanswer, err := ${call}`,
126
+ "\tif err != nil {",
127
+ "\t\treturn failed(err)",
128
+ "\t}",
129
+ answer("Data: answer, "),
130
+ ];
131
+ }
132
+ /** An operation's command function: its flags, then the RunE that checks them, calls the SDK and prints. */
133
+ function opFunc(node, path, ir) {
134
+ const { op, plan } = node.op;
135
+ const flags = commandFlags(op, plan, ir.schemas);
136
+ const use = [node.name, ...plan.pathParams.map((name) => `<${kebab(name)}>`)].join(" ");
137
+ const [read, bodyArg] = bodyLines(op, plan, flags);
138
+ const args = plan.pathParams.map((_, i) => `, path[${i}]`).join("");
139
+ const method = ["client", ...plan.members, plan.method].join(".");
140
+ const cobra = [`Use: ${goString(use)}`, `Short: ${goString(helpText(op.summary))}`];
141
+ if (op.description !== "")
142
+ cobra.push(`Long: ${goString(helpText(op.description))}`);
143
+ const run = [
144
+ "\tif err := p.Check(); err != nil {",
145
+ "\t\treturn err",
146
+ "\t}",
147
+ ...(plan.pathParams.length > 0 ? ["\tpath := p.PathValues(args)"] : []),
148
+ `\topts := &sdk.${plan.opts}{}`,
149
+ ...flags.opts,
150
+ ...read,
151
+ "\tclient, err := newClient(c)",
152
+ "\tif err != nil {",
153
+ "\t\treturn err",
154
+ "\t}",
155
+ ...(plan.stream === null
156
+ ? callLines(`${method}(c.Context()${args}${bodyArg}, opts, sdk.WithResponseInto(&resp))`, plan)
157
+ : streamLines(`${method}(c.Context()${args}${bodyArg}, opts)`, plan.stream)),
158
+ ];
159
+ return [
160
+ ...lineComment(`${node.fn} is \`${[...path, node.name].join(" ")}\`: ${op.method} ${op.path}.`, "//"),
161
+ `func ${node.fn}() *cobra.Command {`,
162
+ `\tcmd := &cobra.Command{${cobra.join(", ")}}`,
163
+ "\tp := cli.NewParams(cmd)",
164
+ ...flags.declare,
165
+ `\tcmd.RunE = func(c *cobra.Command, ${plan.pathParams.length > 0 ? "args" : "_"} []string) error {`,
166
+ ...run.map((line) => `\t${line}`),
167
+ "\t}",
168
+ "\treturn cmd",
169
+ "}",
170
+ ];
171
+ }
172
+ /** A group's command function, then each of its children's. */
173
+ export function groupFuncs(node, path, ir) {
174
+ if (node.op !== undefined)
175
+ return [opFunc(node, path, ir)];
176
+ const at = [...path, node.name];
177
+ const children = node.children.map((child) => `${child.fn}()`).join(", ");
178
+ const own = [
179
+ ...lineComment(`${node.fn} is \`${at.join(" ")}\`, a group of commands.`, "//"),
180
+ `func ${node.fn}() *cobra.Command {`,
181
+ `\tcmd := cli.Group(&cobra.Command{Use: ${goString(node.name)}})`,
182
+ `\tcmd.AddCommand(${children})`,
183
+ "\treturn cmd",
184
+ "}",
185
+ ];
186
+ return [own, ...node.children.flatMap((child) => groupFuncs(child, at, ir))];
187
+ }
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Agent command discovery (bit 17 phase e, E1): `cmd/discovery.go`, every API command as `<bin> commands` and
3
+ * `<bin> schema` print it, sorted by path. The index is one usage line per command, `<path> <arg> --flag kind [--opt
4
+ * a|b] [--data json] (sse) # summary`, the notation an agent already reads and can copy into a call; its summary is the
5
+ * first sentence, at most 80 characters, and an enum of more than 6 values shows as `<enum:N>`. A schema adds the
6
+ * method and path, the body, the answer or the events as a type sketch (refs inlined, a recursive one by its name,
7
+ * objects past depth 3 as `{…}`), and each declared error status with its keys. Each also has a JSON form. Spec text
8
+ * reaches them only as one line through helpText, and a value an agent would copy is quoted with its controls escaped.
9
+ */
10
+ import type { IRSchema } from "../../ir/model.ts";
11
+ import { type SdkModel } from "../../ir/sdk-model.ts";
12
+ import type { CommandNode } from "./commands.ts";
13
+ /** How deep a schema sketch shows objects: deeper ones are `{…}`. */
14
+ export declare const SKETCH_DEPTH = 3;
15
+ /** The longest summary an index line carries, in characters, `…` included. */
16
+ export declare const SUMMARY_MAX = 80;
17
+ /** The most values an index line spells out for an enum: more show as `<enum:N>` (the schema lists them all). */
18
+ export declare const ENUM_MAX = 6;
19
+ /** One API command as discovery shows it. */
20
+ export type Entry = {
21
+ readonly path: string;
22
+ readonly line: string;
23
+ readonly words: string;
24
+ readonly json: string;
25
+ readonly schema: string;
26
+ readonly schemaJson: string;
27
+ };
28
+ /** A summary as the index carries it: its first sentence, at most SUMMARY_MAX characters with `…`. */
29
+ export declare function summaryOf(text: string): string;
30
+ /** `schema` as a type sketch: refs inlined, one already open by its name, objects past SKETCH_DEPTH as `{…}`. */
31
+ export declare const sketch: (schema: IRSchema, model: SdkModel) => string;
32
+ /** Every API command's entry, sorted by path. */
33
+ export declare function discoveryEntries(nodes: readonly CommandNode[], model: SdkModel): Entry[];
34
+ /** cmd/discovery.go's body: the entries as the runtime's Discovery. */
35
+ export declare function discoveryBody(entries: readonly Entry[]): string;
@@ -0,0 +1,202 @@
1
+ import { irErrorEnvelope } from "../../ir/sdk-model.js";
2
+ import { goString } from "../shared/escape.js";
3
+ import { compareCodeUnits } from "../shared/lang.js";
4
+ import { commandFlags, helpText } from "./flags.js";
5
+ /** How deep a schema sketch shows objects: deeper ones are `{…}`. */
6
+ export const SKETCH_DEPTH = 3;
7
+ /** The longest summary an index line carries, in characters, `…` included. */
8
+ export const SUMMARY_MAX = 80;
9
+ /** The most values an index line spells out for an enum: more show as `<enum:N>` (the schema lists them all). */
10
+ export const ENUM_MAX = 6;
11
+ /** Spec text on one line: helpText's, its whitespace runs one space. */
12
+ const oneLine = (text) => helpText(text).replace(/\s+/g, " ").trim();
13
+ /** A summary as the index carries it: its first sentence, at most SUMMARY_MAX characters with `…`. */
14
+ export function summaryOf(text) {
15
+ const line = oneLine(text);
16
+ const sentence = /^.*?[.!?](?=\s|$)/.exec(line)?.[0] ?? line;
17
+ const chars = [...sentence];
18
+ return chars.length <= SUMMARY_MAX ? sentence : `${chars.slice(0, SUMMARY_MAX - 1).join("")}…`;
19
+ }
20
+ /** JSON text with DEL, C1, the BOM and the line separators escaped too (JSON.stringify leaves them raw): exact, and safe. */
21
+ const json = (value) => JSON.stringify(value).replace(/[\u007f-\u009f\u2028\u2029\ufeff]/g, (ch) => `\\u${ch.charCodeAt(0).toString(16).padStart(4, "0")}`);
22
+ /** A value as a usage line shows it: bare when it is a plain word, else quoted. */
23
+ const word = (value) => (/^[\w.:/@+-]+$/.test(value) ? value : json(value));
24
+ /** A flag's value as the usage line shows it: its enum, `<enum:N>` past `enumMax`, else its kind; repeatable `...`. */
25
+ function valueOf(kind, enumMax) {
26
+ const shown = kind.enum.length === 0
27
+ ? kind.kind
28
+ : kind.enum.length > enumMax
29
+ ? `<enum:${kind.enum.length}>`
30
+ : kind.enum.map(word).join("|");
31
+ return kind.list ? `${shown}...` : shown;
32
+ }
33
+ /** One argument in a usage line: `<arg>`, `--flag value`, a boolean bare; an optional one in brackets. */
34
+ function usageWord(usage, enumMax) {
35
+ if (usage.positional)
36
+ return `<${usage.name}>`;
37
+ const bare = usage.kind.kind === "boolean" && !usage.kind.list && usage.kind.enum.length === 0;
38
+ const flag = bare ? `--${usage.name}` : `--${usage.name} ${valueOf(usage.kind, enumMax)}`;
39
+ return usage.required ? flag : `[${flag}]`;
40
+ }
41
+ /** A command's usage line: its path, its arguments, its stream kind, its summary. */
42
+ function usageLine(path, op, usage, enumMax) {
43
+ const summary = summaryOf(op.summary);
44
+ return [
45
+ path,
46
+ ...usage.map((each) => usageWord(each, enumMax)),
47
+ ...(op.stream === null ? [] : [`(${op.stream})`]),
48
+ ...(summary === "" ? [] : [`# ${summary}`]),
49
+ ].join(" ");
50
+ }
51
+ /** A field name as a sketch shows it: bare when an identifier, else quoted. */
52
+ const key = (name) => (/^[A-Za-z_$][\w$]*$/.test(name) ? name : json(name));
53
+ /** A literal as a sketch shows it: a string quoted. */
54
+ const literal = (value) => (typeof value === "string" ? json(value) : String(value));
55
+ /** An object's sketch: each field, `?` when optional, then its additional properties'; `{…}` past SKETCH_DEPTH. */
56
+ function objectSketch(schema, at) {
57
+ if (at.depth >= SKETCH_DEPTH)
58
+ return "{…}";
59
+ const below = { ...at, depth: at.depth + 1 };
60
+ const fields = schema.fields.map((f) => `${key(f.name)}${f.required ? "" : "?"}: ${shown(f.schema, below)}`);
61
+ const extra = schema.additional ? [`[key: string]: ${shown(schema.additional, below)}`] : [];
62
+ return `{${[...fields, ...extra].join(", ")}}`;
63
+ }
64
+ /** A ref's sketch: its schema inlined, or its name when it is already open (recursive) or unknown. */
65
+ function refSketch(name, at) {
66
+ const target = at.model.ir.schemas[name];
67
+ return target === undefined || at.open.includes(name) ? key(name) : shown(target, { ...at, open: [...at.open, name] });
68
+ }
69
+ /** The sketch of a schema of each kind. */
70
+ const SKETCHES = {
71
+ allOf: (s, at) => s.parts.map((part) => shown(part, at)).join(" & "),
72
+ array: (s, at) => {
73
+ const item = shown(s.items, at);
74
+ return /[|&]/.test(item) ? `(${item})[]` : `${item}[]`;
75
+ },
76
+ binary: () => "bytes",
77
+ const: (s) => literal(s.value),
78
+ nullable: (s, at) => `${shown(s.inner, at)}|null`,
79
+ object: objectSketch,
80
+ ref: (s, at) => refSketch(s.name, at),
81
+ scalar: (s) => (s.enum === undefined ? s.type : s.enum.map(literal).join("|")),
82
+ tuple: (s, at) => {
83
+ const rest = s.rest === undefined ? "" : `, ...${shown(s.rest, at)}[]`;
84
+ return `[${s.items.map((item) => shown(item, at)).join(", ")}${rest}]`;
85
+ },
86
+ union: (s, at) => s.variants.map((variant) => shown(variant, at)).join(" | "),
87
+ unknown: () => "any",
88
+ };
89
+ const shown = (schema, at) => SKETCHES[schema.kind](schema, at);
90
+ /** `schema` as a type sketch: refs inlined, one already open by its name, objects past SKETCH_DEPTH as `{…}`. */
91
+ export const sketch = (schema, model) => shown(schema, { depth: 0, model, open: [] });
92
+ /** Each declared error status, with the keys its honey error envelope names: `[status, keys]`. */
93
+ function errorsOf(op, model) {
94
+ return op.errorStatuses.map((status) => {
95
+ /* an error status is one of the operation's declared responses */
96
+ const { schema } = op.ir.responses[String(status)];
97
+ return [status, schema === undefined ? [] : (irErrorEnvelope(schema, model.resolve)?.keys ?? [])];
98
+ });
99
+ }
100
+ /** What a call sends and answers, as sketches: its body, its answer or its events. */
101
+ function shapes(op, model) {
102
+ const body = op.body === undefined
103
+ ? undefined
104
+ : op.body.kind === "json" || op.body.kind === "form"
105
+ ? sketch(op.body.schema, model)
106
+ : op.body.kind === "binary"
107
+ ? "bytes"
108
+ : op.body.kind === "text"
109
+ ? "string"
110
+ : undefined;
111
+ if (op.stream !== null)
112
+ return { body, events: op.events === undefined ? "string" : sketch(op.events, model) };
113
+ const { kind, schema } = op.success;
114
+ const returns = schema !== undefined && kind === "json"
115
+ ? sketch(schema, model)
116
+ : { binary: "bytes", json: "any", none: "nothing", text: "string" }[kind];
117
+ return { body, returns };
118
+ }
119
+ /** One argument as a JSON form carries it. */
120
+ const usageJson = (usage) => ({
121
+ enum: usage.kind.enum.length > 0 ? usage.kind.enum : undefined,
122
+ list: usage.kind.list || undefined,
123
+ name: usage.name,
124
+ required: usage.required || undefined,
125
+ type: usage.kind.kind,
126
+ });
127
+ /** One leaf command's entry. */
128
+ function entryOf(path, op, plan, model) {
129
+ const { usage } = commandFlags(op, plan, model.ir.schemas);
130
+ const args = usage.filter((each) => each.positional).map((each) => each.name);
131
+ const flags = usage.filter((each) => !each.positional).map(usageJson);
132
+ const summary = summaryOf(op.summary);
133
+ const { body, events, returns } = { events: undefined, returns: undefined, ...shapes(op, model) };
134
+ const errors = errorsOf(op, model);
135
+ const head = { args: args.length > 0 ? args : undefined, command: path, flags: flags.length > 0 ? flags : undefined };
136
+ const line = usageLine(path, op, usage, ENUM_MAX);
137
+ const full = usageLine(path, op, usage, Number.POSITIVE_INFINITY);
138
+ const schema = [
139
+ full,
140
+ `${op.method.toUpperCase()} ${oneLine(op.path)}`,
141
+ ...(body === undefined ? [] : [`--data ${body}`]),
142
+ ...(returns === undefined ? [] : [`returns ${returns}`]),
143
+ ...(events === undefined ? [] : [`events ${events}`]),
144
+ ...(errors.length === 0 ? [] : [`errors ${errors.map(([s, keys]) => [s, ...keys].join(" ")).join(", ")}`]),
145
+ ];
146
+ const schemaJson = {
147
+ ...head,
148
+ body,
149
+ errors: errors.length === 0
150
+ ? undefined
151
+ : errors.map(([status, keys]) => ({ keys: keys.length > 0 ? keys : undefined, status })),
152
+ events,
153
+ method: op.method.toUpperCase(),
154
+ path: oneLine(op.path),
155
+ returns,
156
+ stream: op.stream ?? undefined,
157
+ summary: summary === "" ? undefined : summary,
158
+ };
159
+ return {
160
+ json: json({ ...head, stream: op.stream ?? undefined, summary: summary === "" ? undefined : summary }),
161
+ line,
162
+ path,
163
+ schema: schema.join("\n"),
164
+ schemaJson: json(schemaJson),
165
+ words: `${path} ${oneLine(op.summary)}`,
166
+ };
167
+ }
168
+ /** Every leaf under `nodes`, with its command path. */
169
+ function leaves(nodes, at = []) {
170
+ return nodes.flatMap((node) => [
171
+ ...(node.op === undefined
172
+ ? []
173
+ : [[[...at, node.name].join(" "), node.op]]),
174
+ ...leaves(node.children, [...at, node.name]),
175
+ ]);
176
+ }
177
+ /** Every API command's entry, sorted by path. */
178
+ export function discoveryEntries(nodes, model) {
179
+ return leaves(nodes)
180
+ .sort(([a], [b]) => compareCodeUnits(a, b))
181
+ .map(([path, { op, plan }]) => entryOf(path, op, plan, model));
182
+ }
183
+ /** cmd/discovery.go's body: the entries as the runtime's Discovery. */
184
+ export function discoveryBody(entries) {
185
+ const fields = (e) => [
186
+ `Path: ${goString(e.path)}`,
187
+ `Line: ${goString(e.line)}`,
188
+ `Words: ${goString(e.words)}`,
189
+ `JSON: ${goString(e.json)}`,
190
+ `Schema: ${goString(e.schema)}`,
191
+ `SchemaJSON: ${goString(e.schemaJson)}`,
192
+ ].join(", ");
193
+ const doc = "// discovery is every API command as `commands` and `schema` print it, sorted by path.";
194
+ if (entries.length === 0)
195
+ return `${doc}\nvar discovery = cli.Discovery{}`;
196
+ return [
197
+ doc,
198
+ "var discovery = cli.Discovery{Entries: []cli.Entry{",
199
+ ...entries.map((e) => `\t{${fields(e)}},`),
200
+ "}}",
201
+ ].join("\n");
202
+ }
@@ -0,0 +1,59 @@
1
+ /**
2
+ * One command's parameter flags (bit 17 phase b): each path parameter positional (or by its own flag), each query and
3
+ * header parameter a typed flag, and the body from `--data` with a flag per scalar field. A flag's kind comes from its
4
+ * schema (string, integer, number, boolean, a repeatable list of those, or JSON) and its enum, which the runtime checks
5
+ * as the flag is given; its value reaches the SDK's own `<Op>Opts` field through `cli.Set`, so the SDK serializes it
6
+ * exactly as a Go caller's. Names are claimed in one scope per command beside the global flags, a clash suffixed as the
7
+ * IR suffixes ids. Spec text reaches the source only through the shared escape layer.
8
+ */
9
+ import type { IRSchema } from "../../ir/model.ts";
10
+ import type { SdkOp } from "../../ir/sdk-model.ts";
11
+ import type { GoCallPlan } from "../go/sdk-client.ts";
12
+ /** The flags every command has, and those later phases give it: a parameter never takes one of these names. */
13
+ export declare const GLOBAL_FLAGS: string[];
14
+ /** A flag's kind as the runtime checks it, whether it repeats, and its allowed values. */
15
+ export type Kind = {
16
+ readonly kind: string;
17
+ readonly list: boolean;
18
+ readonly enum: readonly string[];
19
+ };
20
+ /**
21
+ * Spec text as a terminal shows it in help: line ends as `\n`, and every other control character (C0 but tab, DEL, C1,
22
+ * the BOM, the line and paragraph separators, the bidi controls) dropped, so no spec can move the cursor, recolor a
23
+ * user's terminal or reorder what it shows.
24
+ */
25
+ export declare const helpText: (text: string) => string;
26
+ /** A name as a flag spells it: its words, lowercase, joined by `-`. */
27
+ export declare const kebab: (raw: string) => string;
28
+ /** The flag kind of a value of `schema`: a scalar, a list of scalars, else JSON. */
29
+ export declare function kindOf(schema: IRSchema, schemas: Readonly<Record<string, IRSchema>>): Kind;
30
+ /** A command's flags: the declarations, and the statements setting each Opts field from its flag. */
31
+ export type CommandFlags = {
32
+ readonly declare: readonly string[];
33
+ readonly opts: readonly string[];
34
+ /** each body flag's name to its body key */
35
+ readonly fields: readonly (readonly [string, string])[];
36
+ /** a multipart body's parts: each one's flag, its `<Op>Body` field, whether a file, whether repeated */
37
+ readonly parts: readonly PartFlag[];
38
+ /** each argument a call takes, as discovery shows it (phase e): the path ones, the parameter flags, the body */
39
+ readonly usage: readonly Usage[];
40
+ };
41
+ /** One argument as discovery shows it: a positional path parameter, else a flag, with its kind and whether required. */
42
+ export type Usage = {
43
+ readonly name: string;
44
+ readonly positional: boolean;
45
+ readonly kind: Kind;
46
+ readonly required: boolean;
47
+ /** the parameter's own name, for a path, query or header parameter */
48
+ readonly param?: string;
49
+ };
50
+ /** One multipart part's flag, `--<part>`: a value of `kind` for a text part, a path for a file part. */
51
+ export type PartFlag = {
52
+ readonly flag: string;
53
+ readonly field: string;
54
+ readonly file: boolean;
55
+ readonly list: boolean;
56
+ readonly kind?: Kind;
57
+ };
58
+ /** Each parameter flag `op` takes, path ones first, and each scalar body field's, claimed in one scope beside the global flags. */
59
+ export declare function commandFlags(op: SdkOp, plan: GoCallPlan, schemas: Readonly<Record<string, IRSchema>>): CommandFlags;