@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.
- package/LICENSE +21 -0
- package/README.md +619 -2
- package/bin/honey-clients.js +94 -0
- package/dist/cli.d.ts +102 -0
- package/dist/cli.js +190 -0
- package/dist/emit/cli/channels.d.ts +73 -0
- package/dist/emit/cli/channels.js +197 -0
- package/dist/emit/cli/commands.d.ts +27 -0
- package/dist/emit/cli/commands.js +187 -0
- package/dist/emit/cli/discovery.d.ts +35 -0
- package/dist/emit/cli/discovery.js +202 -0
- package/dist/emit/cli/flags.d.ts +59 -0
- package/dist/emit/cli/flags.js +186 -0
- package/dist/emit/cli/index.d.ts +1 -0
- package/dist/emit/cli/index.js +1 -0
- package/dist/emit/cli/install.d.ts +37 -0
- package/dist/emit/cli/install.js +88 -0
- package/dist/emit/cli/layout.d.ts +23 -0
- package/dist/emit/cli/layout.js +118 -0
- package/dist/emit/cli/module.d.ts +30 -0
- package/dist/emit/cli/module.js +186 -0
- package/dist/emit/cli/release.d.ts +40 -0
- package/dist/emit/cli/release.js +183 -0
- package/dist/emit/cli/skills.d.ts +11 -0
- package/dist/emit/cli/skills.js +56 -0
- package/dist/emit/csharp/errors.d.ts +7 -0
- package/dist/emit/csharp/errors.js +69 -0
- package/dist/emit/csharp/index.d.ts +1 -0
- package/dist/emit/csharp/index.js +1 -0
- package/dist/emit/csharp/json.d.ts +13 -0
- package/dist/emit/csharp/json.js +113 -0
- package/dist/emit/csharp/realtime.d.ts +10 -0
- package/dist/emit/csharp/realtime.js +33 -0
- package/dist/emit/csharp/sdk-answer.d.ts +48 -0
- package/dist/emit/csharp/sdk-answer.js +85 -0
- package/dist/emit/csharp/sdk-body.d.ts +10 -0
- package/dist/emit/csharp/sdk-body.js +87 -0
- package/dist/emit/csharp/sdk-client.d.ts +32 -0
- package/dist/emit/csharp/sdk-client.js +177 -0
- package/dist/emit/csharp/sdk-csproj.d.ts +36 -0
- package/dist/emit/csharp/sdk-csproj.js +136 -0
- package/dist/emit/csharp/sdk-doc.d.ts +12 -0
- package/dist/emit/csharp/sdk-doc.js +35 -0
- package/dist/emit/csharp/sdk-method.d.ts +26 -0
- package/dist/emit/csharp/sdk-method.js +187 -0
- package/dist/emit/csharp/sdk-plan.d.ts +38 -0
- package/dist/emit/csharp/sdk-plan.js +1 -0
- package/dist/emit/csharp/sdk.d.ts +40 -0
- package/dist/emit/csharp/sdk.js +105 -0
- package/dist/emit/csharp/sse.d.ts +18 -0
- package/dist/emit/csharp/sse.js +29 -0
- package/dist/emit/csharp/transport.d.ts +11 -0
- package/dist/emit/csharp/transport.js +67 -0
- package/dist/emit/csharp/types-enum.d.ts +19 -0
- package/dist/emit/csharp/types-enum.js +63 -0
- package/dist/emit/csharp/types-names.d.ts +33 -0
- package/dist/emit/csharp/types-names.js +182 -0
- package/dist/emit/csharp/types-record.d.ts +25 -0
- package/dist/emit/csharp/types-record.js +65 -0
- package/dist/emit/csharp/types-union.d.ts +27 -0
- package/dist/emit/csharp/types-union.js +113 -0
- package/dist/emit/csharp/types.d.ts +36 -0
- package/dist/emit/csharp/types.js +126 -0
- package/dist/emit/csharp/ws.d.ts +20 -0
- package/dist/emit/csharp/ws.js +14 -0
- package/dist/emit/go/errors.d.ts +7 -0
- package/dist/emit/go/errors.js +44 -0
- package/dist/emit/go/http.d.ts +11 -0
- package/dist/emit/go/http.js +50 -0
- package/dist/emit/go/index.d.ts +1 -0
- package/dist/emit/go/index.js +1 -0
- package/dist/emit/go/module-path.d.ts +2 -0
- package/dist/emit/go/module-path.js +27 -0
- package/dist/emit/go/sdk-answer.d.ts +28 -0
- package/dist/emit/go/sdk-answer.js +41 -0
- package/dist/emit/go/sdk-body.d.ts +24 -0
- package/dist/emit/go/sdk-body.js +76 -0
- package/dist/emit/go/sdk-client.d.ts +29 -0
- package/dist/emit/go/sdk-client.js +141 -0
- package/dist/emit/go/sdk-method.d.ts +68 -0
- package/dist/emit/go/sdk-method.js +172 -0
- package/dist/emit/go/sdk-mirror.d.ts +23 -0
- package/dist/emit/go/sdk-mirror.js +97 -0
- package/dist/emit/go/sdk-opts.d.ts +55 -0
- package/dist/emit/go/sdk-opts.js +100 -0
- package/dist/emit/go/sdk.d.ts +26 -0
- package/dist/emit/go/sdk.js +111 -0
- package/dist/emit/go/sse.d.ts +16 -0
- package/dist/emit/go/sse.js +26 -0
- package/dist/emit/go/types-codec.d.ts +15 -0
- package/dist/emit/go/types-codec.js +171 -0
- package/dist/emit/go/types-names.d.ts +14 -0
- package/dist/emit/go/types-names.js +64 -0
- package/dist/emit/go/types-struct.d.ts +29 -0
- package/dist/emit/go/types-struct.js +65 -0
- package/dist/emit/go/types-union.d.ts +17 -0
- package/dist/emit/go/types-union.js +84 -0
- package/dist/emit/go/types.d.ts +32 -0
- package/dist/emit/go/types.js +177 -0
- package/dist/emit/go/ws.d.ts +12 -0
- package/dist/emit/go/ws.js +70 -0
- package/dist/emit/java/gradle.d.ts +57 -0
- package/dist/emit/java/gradle.js +221 -0
- package/dist/emit/java/index.d.ts +2 -0
- package/dist/emit/java/index.js +2 -0
- package/dist/emit/java/json.d.ts +13 -0
- package/dist/emit/java/json.js +84 -0
- package/dist/emit/java/layout-ast.d.ts +146 -0
- package/dist/emit/java/layout-ast.js +102 -0
- package/dist/emit/java/layout-decl.d.ts +20 -0
- package/dist/emit/java/layout-decl.js +155 -0
- package/dist/emit/java/layout-doc.d.ts +55 -0
- package/dist/emit/java/layout-doc.js +166 -0
- package/dist/emit/java/layout-dot.d.ts +18 -0
- package/dist/emit/java/layout-dot.js +127 -0
- package/dist/emit/java/layout-strings.d.ts +8 -0
- package/dist/emit/java/layout-strings.js +76 -0
- package/dist/emit/java/layout-types.d.ts +11 -0
- package/dist/emit/java/layout-types.js +95 -0
- package/dist/emit/java/layout-visitor.d.ts +38 -0
- package/dist/emit/java/layout-visitor.js +232 -0
- package/dist/emit/java/layout.d.ts +61 -0
- package/dist/emit/java/layout.js +121 -0
- package/dist/emit/java/models-enum.d.ts +17 -0
- package/dist/emit/java/models-enum.js +51 -0
- package/dist/emit/java/models-names.d.ts +29 -0
- package/dist/emit/java/models-names.js +97 -0
- package/dist/emit/java/models-record.d.ts +24 -0
- package/dist/emit/java/models-record.js +79 -0
- package/dist/emit/java/models-union.d.ts +27 -0
- package/dist/emit/java/models-union.js +86 -0
- package/dist/emit/java/models.d.ts +28 -0
- package/dist/emit/java/models.js +118 -0
- package/dist/emit/java/realtime.d.ts +50 -0
- package/dist/emit/java/realtime.js +69 -0
- package/dist/emit/java/sdk-client.d.ts +66 -0
- package/dist/emit/java/sdk-client.js +207 -0
- package/dist/emit/java/sdk-decl.d.ts +11 -0
- package/dist/emit/java/sdk-decl.js +63 -0
- package/dist/emit/java/sdk-errors.d.ts +13 -0
- package/dist/emit/java/sdk-errors.js +141 -0
- package/dist/emit/java/sdk-headers.d.ts +12 -0
- package/dist/emit/java/sdk-headers.js +74 -0
- package/dist/emit/java/sdk-mirror.d.ts +14 -0
- package/dist/emit/java/sdk-mirror.js +107 -0
- package/dist/emit/java/sdk-models.d.ts +16 -0
- package/dist/emit/java/sdk-models.js +68 -0
- package/dist/emit/java/sdk-op.d.ts +57 -0
- package/dist/emit/java/sdk-op.js +216 -0
- package/dist/emit/java/sdk-params.d.ts +38 -0
- package/dist/emit/java/sdk-params.js +133 -0
- package/dist/emit/java/sdk-plan.d.ts +52 -0
- package/dist/emit/java/sdk-plan.js +1 -0
- package/dist/emit/java/sdk-record.d.ts +16 -0
- package/dist/emit/java/sdk-record.js +99 -0
- package/dist/emit/java/sdk.d.ts +49 -0
- package/dist/emit/java/sdk.js +216 -0
- package/dist/emit/java/sse.d.ts +35 -0
- package/dist/emit/java/sse.js +57 -0
- package/dist/emit/java/ws.d.ts +27 -0
- package/dist/emit/java/ws.js +31 -0
- package/dist/emit/mcp/annotations.d.ts +15 -0
- package/dist/emit/mcp/annotations.js +15 -0
- package/dist/emit/mcp/files.d.ts +18 -0
- package/dist/emit/mcp/files.js +42 -0
- package/dist/emit/mcp/index.d.ts +3 -0
- package/dist/emit/mcp/index.js +3 -0
- package/dist/emit/mcp/literal.d.ts +2 -0
- package/dist/emit/mcp/literal.js +33 -0
- package/dist/emit/mcp/mounted.d.ts +21 -0
- package/dist/emit/mcp/mounted.js +89 -0
- package/dist/emit/mcp/output-schema.d.ts +18 -0
- package/dist/emit/mcp/output-schema.js +38 -0
- package/dist/emit/mcp/registry.d.ts +23 -0
- package/dist/emit/mcp/registry.js +83 -0
- package/dist/emit/mcp/runtime.d.ts +10 -0
- package/dist/emit/mcp/runtime.js +47 -0
- package/dist/emit/mcp/schema.d.ts +19 -0
- package/dist/emit/mcp/schema.js +88 -0
- package/dist/emit/mcp/server.d.ts +30 -0
- package/dist/emit/mcp/server.js +246 -0
- package/dist/emit/mcp/tools.d.ts +51 -0
- package/dist/emit/mcp/tools.js +153 -0
- package/dist/emit/python/errors.d.ts +8 -0
- package/dist/emit/python/errors.js +68 -0
- package/dist/emit/python/index.d.ts +1 -0
- package/dist/emit/python/index.js +1 -0
- package/dist/emit/python/realtime.d.ts +10 -0
- package/dist/emit/python/realtime.js +33 -0
- package/dist/emit/python/sdk-answer.d.ts +49 -0
- package/dist/emit/python/sdk-answer.js +89 -0
- package/dist/emit/python/sdk-body.d.ts +11 -0
- package/dist/emit/python/sdk-body.js +40 -0
- package/dist/emit/python/sdk-client.d.ts +36 -0
- package/dist/emit/python/sdk-client.js +163 -0
- package/dist/emit/python/sdk-doc.d.ts +9 -0
- package/dist/emit/python/sdk-doc.js +32 -0
- package/dist/emit/python/sdk-imports.d.ts +14 -0
- package/dist/emit/python/sdk-imports.js +38 -0
- package/dist/emit/python/sdk-method.d.ts +29 -0
- package/dist/emit/python/sdk-method.js +183 -0
- package/dist/emit/python/sdk-plan.d.ts +33 -0
- package/dist/emit/python/sdk-plan.js +1 -0
- package/dist/emit/python/sdk-pyproject.d.ts +27 -0
- package/dist/emit/python/sdk-pyproject.js +103 -0
- package/dist/emit/python/sdk.d.ts +22 -0
- package/dist/emit/python/sdk.js +154 -0
- package/dist/emit/python/sse.d.ts +12 -0
- package/dist/emit/python/sse.js +23 -0
- package/dist/emit/python/transport.d.ts +15 -0
- package/dist/emit/python/transport.js +60 -0
- package/dist/emit/python/types-dict.d.ts +31 -0
- package/dist/emit/python/types-dict.js +45 -0
- package/dist/emit/python/types-names.d.ts +16 -0
- package/dist/emit/python/types-names.js +52 -0
- package/dist/emit/python/types-union.d.ts +32 -0
- package/dist/emit/python/types-union.js +46 -0
- package/dist/emit/python/types.d.ts +36 -0
- package/dist/emit/python/types.js +128 -0
- package/dist/emit/python/ws.d.ts +14 -0
- package/dist/emit/python/ws.js +16 -0
- package/dist/emit/rust/errors.d.ts +7 -0
- package/dist/emit/rust/errors.js +107 -0
- package/dist/emit/rust/http.d.ts +13 -0
- package/dist/emit/rust/http.js +67 -0
- package/dist/emit/rust/index.d.ts +1 -0
- package/dist/emit/rust/index.js +1 -0
- package/dist/emit/rust/realtime.d.ts +11 -0
- package/dist/emit/rust/realtime.js +29 -0
- package/dist/emit/rust/sdk-body.d.ts +19 -0
- package/dist/emit/rust/sdk-body.js +53 -0
- package/dist/emit/rust/sdk-cargo.d.ts +43 -0
- package/dist/emit/rust/sdk-cargo.js +178 -0
- package/dist/emit/rust/sdk-client.d.ts +25 -0
- package/dist/emit/rust/sdk-client.js +108 -0
- package/dist/emit/rust/sdk-method.d.ts +15 -0
- package/dist/emit/rust/sdk-method.js +119 -0
- package/dist/emit/rust/sdk-opts.d.ts +58 -0
- package/dist/emit/rust/sdk-opts.js +117 -0
- package/dist/emit/rust/sdk-plan.d.ts +33 -0
- package/dist/emit/rust/sdk-plan.js +1 -0
- package/dist/emit/rust/sdk.d.ts +23 -0
- package/dist/emit/rust/sdk.js +111 -0
- package/dist/emit/rust/sse.d.ts +19 -0
- package/dist/emit/rust/sse.js +20 -0
- package/dist/emit/rust/types-enum.d.ts +13 -0
- package/dist/emit/rust/types-enum.js +62 -0
- package/dist/emit/rust/types-names.d.ts +19 -0
- package/dist/emit/rust/types-names.js +66 -0
- package/dist/emit/rust/types-struct.d.ts +21 -0
- package/dist/emit/rust/types-struct.js +59 -0
- package/dist/emit/rust/types-union.d.ts +24 -0
- package/dist/emit/rust/types-union.js +97 -0
- package/dist/emit/rust/types.d.ts +34 -0
- package/dist/emit/rust/types.js +105 -0
- package/dist/emit/rust/ws.d.ts +21 -0
- package/dist/emit/rust/ws.js +20 -0
- package/dist/emit/shared/escape.d.ts +55 -0
- package/dist/emit/shared/escape.js +144 -0
- package/dist/emit/shared/format.d.ts +24 -0
- package/dist/emit/shared/format.js +23 -0
- package/dist/emit/shared/gofmt.d.ts +3 -0
- package/dist/emit/shared/gofmt.js +26 -0
- package/dist/emit/shared/lang.d.ts +60 -0
- package/dist/emit/shared/lang.js +233 -0
- package/dist/emit/shared/literals.d.ts +4 -0
- package/dist/emit/shared/literals.js +31 -0
- package/dist/emit/shared/metadata.d.ts +106 -0
- package/dist/emit/shared/metadata.js +130 -0
- package/dist/emit/shared/mirror.d.ts +22 -0
- package/dist/emit/shared/mirror.js +26 -0
- package/dist/emit/shared/ruff.d.ts +3 -0
- package/dist/emit/shared/ruff.js +31 -0
- package/dist/emit/shared/rustfmt.d.ts +3 -0
- package/dist/emit/shared/rustfmt.js +32 -0
- package/dist/emit/shared/status-keys.d.ts +7 -0
- package/dist/emit/shared/status-keys.js +67 -0
- package/dist/emit/shared/type-emitter.d.ts +19 -0
- package/dist/emit/shared/type-emitter.js +100 -0
- package/dist/emit/ts/app-client.d.ts +4 -0
- package/dist/emit/ts/app-client.js +68 -0
- package/dist/emit/ts/http.d.ts +20 -0
- package/dist/emit/ts/http.js +74 -0
- package/dist/emit/ts/package.d.ts +36 -0
- package/dist/emit/ts/package.js +126 -0
- package/dist/emit/ts/route-tree.d.ts +68 -0
- package/dist/emit/ts/route-tree.js +240 -0
- package/dist/emit/ts/sdk-types-preamble.d.ts +14 -0
- package/dist/emit/ts/sdk-types-preamble.js +123 -0
- package/dist/emit/ts/sdk-types.d.ts +13 -0
- package/dist/emit/ts/sdk-types.js +213 -0
- package/dist/emit/ts/sdk.d.ts +21 -0
- package/dist/emit/ts/sdk.js +173 -0
- package/dist/emit/ts/service-map.d.ts +40 -0
- package/dist/emit/ts/service-map.js +171 -0
- package/dist/emit/ts/tanstack-query.d.ts +12 -0
- package/dist/emit/ts/tanstack-query.js +156 -0
- package/dist/emit/ts/type-gen.d.ts +26 -0
- package/dist/emit/ts/type-gen.js +255 -0
- package/dist/emit/ts/webhooks.d.ts +19 -0
- package/dist/emit/ts/webhooks.js +81 -0
- package/dist/extract/chain.d.ts +34 -0
- package/dist/extract/chain.js +84 -0
- package/dist/extract/extract.d.ts +41 -0
- package/dist/extract/extract.js +191 -0
- package/dist/extract/serialize.d.ts +34 -0
- package/dist/extract/serialize.js +295 -0
- package/dist/extract/walk.d.ts +47 -0
- package/dist/extract/walk.js +109 -0
- package/dist/gen/args.d.ts +28 -0
- package/dist/gen/args.js +133 -0
- package/dist/gen/formatters.d.ts +62 -0
- package/dist/gen/formatters.js +146 -0
- package/dist/gen/process.d.ts +13 -0
- package/dist/gen/process.js +35 -0
- package/dist/gen/shipped.d.ts +17 -0
- package/dist/gen/shipped.js +55 -0
- package/dist/gen/targets.d.ts +93 -0
- package/dist/gen/targets.js +171 -0
- package/dist/gen/write.d.ts +33 -0
- package/dist/gen/write.js +118 -0
- package/dist/index.d.ts +13 -0
- package/dist/index.js +15 -0
- package/dist/ir/build.d.ts +37 -0
- package/dist/ir/build.js +152 -0
- package/dist/ir/load.d.ts +11 -0
- package/dist/ir/load.js +112 -0
- package/dist/ir/model.d.ts +206 -0
- package/dist/ir/model.js +5 -0
- package/dist/ir/resolve-refs.d.ts +11 -0
- package/dist/ir/resolve-refs.js +66 -0
- package/dist/ir/resource-tree.d.ts +9 -0
- package/dist/ir/resource-tree.js +53 -0
- package/dist/ir/route-tree-intern.d.ts +18 -0
- package/dist/ir/route-tree-intern.js +174 -0
- package/dist/ir/schema.d.ts +11 -0
- package/dist/ir/schema.js +192 -0
- package/dist/ir/sdk-model.d.ts +86 -0
- package/dist/ir/sdk-model.js +204 -0
- package/dist/ir/slots.d.ts +42 -0
- package/dist/ir/slots.js +245 -0
- package/dist/runtime/cli/body.go +176 -0
- package/dist/runtime/cli/config.go +243 -0
- package/dist/runtime/cli/discovery.go +147 -0
- package/dist/runtime/cli/format.go +174 -0
- package/dist/runtime/cli/log.go +117 -0
- package/dist/runtime/cli/output.go +247 -0
- package/dist/runtime/cli/params.go +197 -0
- package/dist/runtime/cli/run.go +226 -0
- package/dist/runtime/cli/socket.go +60 -0
- package/dist/runtime/cli/stream.go +217 -0
- package/dist/runtime/cli/target.go +117 -0
- package/dist/runtime/csharp/Adapters.cs +183 -0
- package/dist/runtime/csharp/Auth.cs +56 -0
- package/dist/runtime/csharp/Body.cs +135 -0
- package/dist/runtime/csharp/Config.cs +161 -0
- package/dist/runtime/csharp/Envelope.cs +149 -0
- package/dist/runtime/csharp/Errors.cs +194 -0
- package/dist/runtime/csharp/Events.cs +155 -0
- package/dist/runtime/csharp/Exchange.cs +247 -0
- package/dist/runtime/csharp/Handler.cs +103 -0
- package/dist/runtime/csharp/Hooks.cs +128 -0
- package/dist/runtime/csharp/Invalidation.cs +102 -0
- package/dist/runtime/csharp/Json.cs +144 -0
- package/dist/runtime/csharp/Log.cs +48 -0
- package/dist/runtime/csharp/Operation.cs +33 -0
- package/dist/runtime/csharp/Path.cs +65 -0
- package/dist/runtime/csharp/Query.cs +72 -0
- package/dist/runtime/csharp/Realtime.cs +118 -0
- package/dist/runtime/csharp/RealtimeLoop.cs +236 -0
- package/dist/runtime/csharp/Redirect.cs +53 -0
- package/dist/runtime/csharp/Result.cs +57 -0
- package/dist/runtime/csharp/Sse.cs +122 -0
- package/dist/runtime/csharp/Stale.cs +151 -0
- package/dist/runtime/csharp/Transport.cs +143 -0
- package/dist/runtime/csharp/TransportLongPoll.cs +63 -0
- package/dist/runtime/csharp/TransportSse.cs +54 -0
- package/dist/runtime/csharp/TransportWs.cs +40 -0
- package/dist/runtime/csharp/Wire.cs +109 -0
- package/dist/runtime/csharp/Ws.cs +300 -0
- package/dist/runtime/csharp/WsDial.cs +127 -0
- package/dist/runtime/go/auth.go +127 -0
- package/dist/runtime/go/body.go +129 -0
- package/dist/runtime/go/config.go +75 -0
- package/dist/runtime/go/errors.go +185 -0
- package/dist/runtime/go/export.go +37 -0
- package/dist/runtime/go/hooks.go +53 -0
- package/dist/runtime/go/invalidation.go +112 -0
- package/dist/runtime/go/log.go +92 -0
- package/dist/runtime/go/nullable.go +64 -0
- package/dist/runtime/go/options.go +118 -0
- package/dist/runtime/go/path.go +156 -0
- package/dist/runtime/go/query.go +147 -0
- package/dist/runtime/go/realtime.go +239 -0
- package/dist/runtime/go/realtime_loop.go +208 -0
- package/dist/runtime/go/redirect.go +124 -0
- package/dist/runtime/go/request.go +222 -0
- package/dist/runtime/go/result.go +86 -0
- package/dist/runtime/go/sse.go +186 -0
- package/dist/runtime/go/stale.go +229 -0
- package/dist/runtime/go/stream.go +105 -0
- package/dist/runtime/go/transport.go +242 -0
- package/dist/runtime/go/transport_longpoll.go +121 -0
- package/dist/runtime/go/transport_sse.go +175 -0
- package/dist/runtime/go/ws.go +205 -0
- package/dist/runtime/java/Answer.java +107 -0
- package/dist/runtime/java/ApiException.java +110 -0
- package/dist/runtime/java/BinaryBody.java +36 -0
- package/dist/runtime/java/Body.java +105 -0
- package/dist/runtime/java/Call.java +23 -0
- package/dist/runtime/java/CallLog.java +51 -0
- package/dist/runtime/java/ClientConfig.java +233 -0
- package/dist/runtime/java/ConnectionState.java +12 -0
- package/dist/runtime/java/Credential.java +58 -0
- package/dist/runtime/java/Deadline.java +38 -0
- package/dist/runtime/java/Decode.java +181 -0
- package/dist/runtime/java/Envelope.java +141 -0
- package/dist/runtime/java/ErrorEnvelope.java +23 -0
- package/dist/runtime/java/EventStream.java +129 -0
- package/dist/runtime/java/Exchange.java +62 -0
- package/dist/runtime/java/FilePart.java +5 -0
- package/dist/runtime/java/Flight.java +306 -0
- package/dist/runtime/java/HoneyException.java +14 -0
- package/dist/runtime/java/Hooks.java +47 -0
- package/dist/runtime/java/Hops.java +133 -0
- package/dist/runtime/java/InvalidationConfig.java +73 -0
- package/dist/runtime/java/Json.java +23 -0
- package/dist/runtime/java/Keepalive.java +60 -0
- package/dist/runtime/java/LogEntry.java +14 -0
- package/dist/runtime/java/LongPollAdapter.java +68 -0
- package/dist/runtime/java/Operation.java +21 -0
- package/dist/runtime/java/Opt.java +121 -0
- package/dist/runtime/java/Pump.java +160 -0
- package/dist/runtime/java/RawResponse.java +48 -0
- package/dist/runtime/java/Realtime.java +152 -0
- package/dist/runtime/java/RealtimeLoop.java +371 -0
- package/dist/runtime/java/RedirectPolicy.java +13 -0
- package/dist/runtime/java/Redirects.java +126 -0
- package/dist/runtime/java/RequestContext.java +78 -0
- package/dist/runtime/java/RequestHook.java +9 -0
- package/dist/runtime/java/RequestOptions.java +91 -0
- package/dist/runtime/java/ResponseContext.java +70 -0
- package/dist/runtime/java/ResponseHook.java +12 -0
- package/dist/runtime/java/Result.java +32 -0
- package/dist/runtime/java/ResumableConnection.java +165 -0
- package/dist/runtime/java/SdkException.java +11 -0
- package/dist/runtime/java/Socket.java +301 -0
- package/dist/runtime/java/Sse.java +171 -0
- package/dist/runtime/java/SseAdapter.java +61 -0
- package/dist/runtime/java/SseEvent.java +10 -0
- package/dist/runtime/java/StaleMeta.java +16 -0
- package/dist/runtime/java/StaleTracker.java +287 -0
- package/dist/runtime/java/Transport.java +16 -0
- package/dist/runtime/java/TransportAdapter.java +14 -0
- package/dist/runtime/java/TransportConnection.java +15 -0
- package/dist/runtime/java/TransportKind.java +12 -0
- package/dist/runtime/java/TransportMessage.java +9 -0
- package/dist/runtime/java/TransportOptions.java +138 -0
- package/dist/runtime/java/TypedWebSocket.java +83 -0
- package/dist/runtime/java/UrlPath.java +49 -0
- package/dist/runtime/java/UrlQuery.java +99 -0
- package/dist/runtime/java/WsAdapter.java +52 -0
- package/dist/runtime/java/WsClose.java +47 -0
- package/dist/runtime/java/WsDial.java +148 -0
- package/dist/runtime/java/WsMessage.java +18 -0
- package/dist/runtime/mcp/call.ts +167 -0
- package/dist/runtime/mcp/files.ts +183 -0
- package/dist/runtime/mcp/guard.ts +176 -0
- package/dist/runtime/mcp/http.ts +159 -0
- package/dist/runtime/mcp/jsonrpc.ts +50 -0
- package/dist/runtime/mcp/listen.ts +76 -0
- package/dist/runtime/mcp/mount.ts +123 -0
- package/dist/runtime/mcp/protocol.ts +219 -0
- package/dist/runtime/mcp/reader.ts +57 -0
- package/dist/runtime/mcp/result.ts +85 -0
- package/dist/runtime/mcp/stdio.ts +79 -0
- package/dist/runtime/mcp/stream.ts +62 -0
- package/dist/runtime/python/__init__.py +2 -0
- package/dist/runtime/python/auth.py +67 -0
- package/dist/runtime/python/body.py +83 -0
- package/dist/runtime/python/config.py +139 -0
- package/dist/runtime/python/errors.py +213 -0
- package/dist/runtime/python/events.py +152 -0
- package/dist/runtime/python/exchange.py +298 -0
- package/dist/runtime/python/hooks.py +86 -0
- package/dist/runtime/python/invalidation.py +57 -0
- package/dist/runtime/python/log.py +60 -0
- package/dist/runtime/python/operation.py +25 -0
- package/dist/runtime/python/path.py +41 -0
- package/dist/runtime/python/query.py +48 -0
- package/dist/runtime/python/realtime.py +244 -0
- package/dist/runtime/python/redirect.py +93 -0
- package/dist/runtime/python/result.py +58 -0
- package/dist/runtime/python/send_async.py +189 -0
- package/dist/runtime/python/send_sync.py +105 -0
- package/dist/runtime/python/sse.py +81 -0
- package/dist/runtime/python/stale.py +94 -0
- package/dist/runtime/python/transport.py +157 -0
- package/dist/runtime/python/transport_longpoll.py +60 -0
- package/dist/runtime/python/transport_sse.py +60 -0
- package/dist/runtime/python/transport_ws.py +57 -0
- package/dist/runtime/python/ws.py +276 -0
- package/dist/runtime/rust/Cargo.lock +1763 -0
- package/dist/runtime/rust/answer.rs +120 -0
- package/dist/runtime/rust/auth.rs +80 -0
- package/dist/runtime/rust/body.rs +150 -0
- package/dist/runtime/rust/call.rs +200 -0
- package/dist/runtime/rust/config.rs +254 -0
- package/dist/runtime/rust/envelope.rs +84 -0
- package/dist/runtime/rust/errors.rs +235 -0
- package/dist/runtime/rust/events.rs +177 -0
- package/dist/runtime/rust/exchange.rs +287 -0
- package/dist/runtime/rust/hooks.rs +63 -0
- package/dist/runtime/rust/invalidation.rs +84 -0
- package/dist/runtime/rust/log.rs +88 -0
- package/dist/runtime/rust/nullable.rs +13 -0
- package/dist/runtime/rust/path.rs +83 -0
- package/dist/runtime/rust/query.rs +84 -0
- package/dist/runtime/rust/realtime.rs +182 -0
- package/dist/runtime/rust/realtime_loop.rs +177 -0
- package/dist/runtime/rust/redirect.rs +121 -0
- package/dist/runtime/rust/request.rs +178 -0
- package/dist/runtime/rust/result.rs +101 -0
- package/dist/runtime/rust/sse.rs +104 -0
- package/dist/runtime/rust/stale.rs +209 -0
- package/dist/runtime/rust/transport.rs +221 -0
- package/dist/runtime/rust/transport_longpoll.rs +108 -0
- package/dist/runtime/rust/transport_sse.rs +91 -0
- package/dist/runtime/rust/transport_ws.rs +75 -0
- package/dist/runtime/rust/ws.rs +322 -0
- package/dist/runtime/ts/app-types.ts +200 -0
- package/dist/runtime/ts/app.ts +104 -0
- package/dist/runtime/ts/config.ts +124 -0
- package/dist/runtime/ts/defaults.ts +48 -0
- package/dist/runtime/ts/error.ts +113 -0
- package/dist/runtime/ts/hooks.ts +92 -0
- package/dist/runtime/ts/http.ts +228 -0
- package/dist/runtime/ts/media-type.ts +36 -0
- package/dist/runtime/ts/path.ts +152 -0
- package/dist/runtime/ts/realtime-connection.ts +296 -0
- package/dist/runtime/ts/realtime-transports.ts +149 -0
- package/dist/runtime/ts/realtime.ts +293 -0
- package/dist/runtime/ts/redirect-policy.ts +17 -0
- package/dist/runtime/ts/redirects.ts +74 -0
- package/dist/runtime/ts/request.ts +239 -0
- package/dist/runtime/ts/response.ts +219 -0
- package/dist/runtime/ts/sdk-realtime.ts +10 -0
- package/dist/runtime/ts/sdk-sse.ts +55 -0
- package/dist/runtime/ts/sdk-ws.ts +21 -0
- package/dist/runtime/ts/sdk.ts +242 -0
- package/dist/runtime/ts/sse.ts +175 -0
- package/dist/runtime/ts/stale.ts +137 -0
- package/dist/runtime/ts/stream.ts +87 -0
- package/dist/runtime/ts/webhook.ts +116 -0
- package/dist/runtime/ts/ws.ts +155 -0
- package/dist/runtime/ts-tanstack-query/invalidate.ts +152 -0
- package/dist/runtime/ts-tanstack-query/query.ts +261 -0
- package/package.json +84 -5
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package cli
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"encoding/json"
|
|
7
|
+
"fmt"
|
|
8
|
+
"reflect"
|
|
9
|
+
"slices"
|
|
10
|
+
"strconv"
|
|
11
|
+
"strings"
|
|
12
|
+
|
|
13
|
+
"github.com/spf13/cobra"
|
|
14
|
+
)
|
|
15
|
+
|
|
16
|
+
// Params are one command's parameter flags: each value checked against its kind and its enum as
|
|
17
|
+
// it is given, so a bad one is a usage error before anything is sent.
|
|
18
|
+
type Params struct {
|
|
19
|
+
cmd *cobra.Command
|
|
20
|
+
paths []string
|
|
21
|
+
required []string
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
// value is one parameter flag's: the raw values given, each already checked.
|
|
25
|
+
type value struct {
|
|
26
|
+
kind string
|
|
27
|
+
list bool
|
|
28
|
+
enum []string
|
|
29
|
+
values []string
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
func (v *value) String() string { return strings.Join(v.values, ",") }
|
|
33
|
+
|
|
34
|
+
func (v *value) Type() string {
|
|
35
|
+
if v.list {
|
|
36
|
+
return v.kind + "s"
|
|
37
|
+
}
|
|
38
|
+
return v.kind
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
func (v *value) Set(raw string) error {
|
|
42
|
+
if err := check(v.kind, raw); err != nil {
|
|
43
|
+
return err
|
|
44
|
+
}
|
|
45
|
+
if len(v.enum) > 0 && !slices.Contains(v.enum, raw) {
|
|
46
|
+
return fmt.Errorf("must be one of %s", strings.Join(v.enum, ", "))
|
|
47
|
+
}
|
|
48
|
+
if v.list {
|
|
49
|
+
v.values = append(v.values, raw)
|
|
50
|
+
} else {
|
|
51
|
+
v.values = []string{raw}
|
|
52
|
+
}
|
|
53
|
+
return nil
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
// check is whether raw reads as kind: integer, number, boolean, json, or any string.
|
|
57
|
+
func check(kind, raw string) error {
|
|
58
|
+
var err error
|
|
59
|
+
switch kind {
|
|
60
|
+
case "integer":
|
|
61
|
+
_, err = strconv.ParseInt(raw, 10, 64)
|
|
62
|
+
case "number":
|
|
63
|
+
_, err = strconv.ParseFloat(raw, 64)
|
|
64
|
+
case "boolean":
|
|
65
|
+
if raw != "true" && raw != "false" {
|
|
66
|
+
err = fmt.Errorf("not true or false")
|
|
67
|
+
}
|
|
68
|
+
case "json":
|
|
69
|
+
if !json.Valid([]byte(raw)) {
|
|
70
|
+
err = fmt.Errorf("not JSON")
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
// a number is sent as its JSON literal: NaN, Inf, hex and a leading + are not one
|
|
74
|
+
if err == nil && (kind == "integer" || kind == "number") && !json.Valid([]byte(raw)) {
|
|
75
|
+
err = fmt.Errorf("not JSON")
|
|
76
|
+
}
|
|
77
|
+
if err != nil {
|
|
78
|
+
return fmt.Errorf("not %s %s", article(kind), kind)
|
|
79
|
+
}
|
|
80
|
+
return nil
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
func article(kind string) string {
|
|
84
|
+
if kind == "integer" {
|
|
85
|
+
return "an"
|
|
86
|
+
}
|
|
87
|
+
return "a"
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// NewParams holds cmd's parameter flags.
|
|
91
|
+
func NewParams(cmd *cobra.Command) *Params { return &Params{cmd: cmd} }
|
|
92
|
+
|
|
93
|
+
// Flag declares --name of kind (string, integer, number, boolean or json), repeatable when list,
|
|
94
|
+
// limited to enum when one is given, its values completing; a required one must be given.
|
|
95
|
+
func (p *Params) Flag(name, kind string, list, required bool, usage string, enum ...string) {
|
|
96
|
+
if len(enum) > 0 {
|
|
97
|
+
usage = strings.TrimSpace(usage + " (one of " + strings.Join(enum, ", ") + ")")
|
|
98
|
+
}
|
|
99
|
+
if required {
|
|
100
|
+
usage = strings.TrimSpace(usage + " (required)")
|
|
101
|
+
}
|
|
102
|
+
flag := p.cmd.Flags().VarPF(&value{kind: kind, list: list, enum: enum}, name, "", usage)
|
|
103
|
+
if len(enum) > 0 {
|
|
104
|
+
p.cmd.RegisterFlagCompletionFunc(name, cobra.FixedCompletions(enum, cobra.ShellCompDirectiveNoFileComp))
|
|
105
|
+
}
|
|
106
|
+
if kind == "boolean" && !list {
|
|
107
|
+
flag.NoOptDefVal = "true"
|
|
108
|
+
}
|
|
109
|
+
if required {
|
|
110
|
+
p.required = append(p.required, name)
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// Values is what --name was given; none when it was not.
|
|
115
|
+
func (p *Params) Values(name string) []string {
|
|
116
|
+
return p.cmd.Flags().Lookup(name).Value.(*value).values
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
// Path declares the path parameters, in path order: each given positionally, or by its own flag.
|
|
120
|
+
func (p *Params) Path(names ...string) {
|
|
121
|
+
p.paths = names
|
|
122
|
+
for _, name := range names {
|
|
123
|
+
p.Flag(name, "string", false, false, "the "+name+" path parameter, when not given positionally")
|
|
124
|
+
}
|
|
125
|
+
p.cmd.Args = p.positional
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
// positional refuses a call whose positional arguments are not the path parameters left unflagged.
|
|
129
|
+
func (p *Params) positional(_ *cobra.Command, args []string) error {
|
|
130
|
+
var want []string
|
|
131
|
+
for _, name := range p.paths {
|
|
132
|
+
if !p.cmd.Flags().Changed(name) {
|
|
133
|
+
want = append(want, "<"+name+">")
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
if len(args) != len(want) {
|
|
137
|
+
return Usage("%s takes %d argument(s) %s, got %d", p.cmd.CommandPath(), len(want), strings.Join(want, " "), len(args))
|
|
138
|
+
}
|
|
139
|
+
return nil
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// PathValues is each path parameter's value, in path order: its flag's, else the next positional one.
|
|
143
|
+
func (p *Params) PathValues(args []string) []string {
|
|
144
|
+
out := make([]string, len(p.paths))
|
|
145
|
+
for i, name := range p.paths {
|
|
146
|
+
if given := p.Values(name); len(given) > 0 {
|
|
147
|
+
out[i] = given[0]
|
|
148
|
+
continue
|
|
149
|
+
}
|
|
150
|
+
out[i], args = args[0], args[1:]
|
|
151
|
+
}
|
|
152
|
+
return out
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
// Check refuses a call missing a required flag, before anything is sent.
|
|
156
|
+
func (p *Params) Check() error {
|
|
157
|
+
for _, name := range p.required {
|
|
158
|
+
if !p.cmd.Flags().Changed(name) {
|
|
159
|
+
return Usage("%s needs --%s", p.cmd.CommandPath(), name)
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
return nil
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
// Set stores values in dst, converted to its type: nothing when none were given.
|
|
166
|
+
func Set[T any](dst *T, values []string) error {
|
|
167
|
+
if len(values) == 0 {
|
|
168
|
+
return nil
|
|
169
|
+
}
|
|
170
|
+
if err := assign(reflect.ValueOf(dst).Elem(), values); err != nil {
|
|
171
|
+
return Usage("%v", err)
|
|
172
|
+
}
|
|
173
|
+
return nil
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
func assign(v reflect.Value, values []string) error {
|
|
177
|
+
switch v.Kind() {
|
|
178
|
+
case reflect.Pointer:
|
|
179
|
+
v.Set(reflect.New(v.Type().Elem()))
|
|
180
|
+
return assign(v.Elem(), values)
|
|
181
|
+
case reflect.Slice:
|
|
182
|
+
items := reflect.MakeSlice(v.Type(), len(values), len(values))
|
|
183
|
+
for i := range values {
|
|
184
|
+
if err := assign(items.Index(i), values[i:i+1]); err != nil {
|
|
185
|
+
return err
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
v.Set(items)
|
|
189
|
+
return nil
|
|
190
|
+
case reflect.String:
|
|
191
|
+
v.SetString(values[0])
|
|
192
|
+
return nil
|
|
193
|
+
default:
|
|
194
|
+
// a number or a boolean is its JSON literal (check lets only those through); anything else is JSON
|
|
195
|
+
return json.Unmarshal([]byte(values[0]), v.Addr().Interface())
|
|
196
|
+
}
|
|
197
|
+
}
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
// Package cli is the generated CLI's runtime: the root command and its global flags, the settings
|
|
4
|
+
// each run resolves, the parameter flags, and the run that maps an outcome to the exit code a
|
|
5
|
+
// script branches on.
|
|
6
|
+
package cli
|
|
7
|
+
|
|
8
|
+
import (
|
|
9
|
+
"context"
|
|
10
|
+
"errors"
|
|
11
|
+
"fmt"
|
|
12
|
+
"io"
|
|
13
|
+
"net"
|
|
14
|
+
"os"
|
|
15
|
+
"os/signal"
|
|
16
|
+
|
|
17
|
+
"github.com/spf13/cobra"
|
|
18
|
+
)
|
|
19
|
+
|
|
20
|
+
// Version is the CLI's version: a release links it in with
|
|
21
|
+
// -ldflags "-X <module>/internal/cli.Version=v1.2.3".
|
|
22
|
+
var Version = "dev"
|
|
23
|
+
|
|
24
|
+
// The exit codes, so a script tells a mistake in the call from a failed one.
|
|
25
|
+
const (
|
|
26
|
+
ExitOK = 0 // success
|
|
27
|
+
ExitError = 1 // the API answered 4xx, or anything not named below failed
|
|
28
|
+
ExitServer = 2 // the API answered 5xx
|
|
29
|
+
ExitTransport = 3 // no answer: the connection failed or the call timed out
|
|
30
|
+
ExitUsage = 4 // the call was wrong: an unknown command or flag, a bad value, a bad config
|
|
31
|
+
ExitRedirect = 5 // the API answered with a redirect the CLI does not follow
|
|
32
|
+
ExitInterrupted = 130 // interrupted (Ctrl-C)
|
|
33
|
+
)
|
|
34
|
+
|
|
35
|
+
// UsageError is a mistake in how the CLI was called: an unknown command or flag, a bad value.
|
|
36
|
+
type UsageError struct{ msg string }
|
|
37
|
+
|
|
38
|
+
func (e *UsageError) Error() string { return e.msg }
|
|
39
|
+
|
|
40
|
+
// Usage is a UsageError with a formatted message.
|
|
41
|
+
func Usage(format string, args ...any) error {
|
|
42
|
+
return &UsageError{msg: fmt.Sprintf(format, args...)}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// APIError is an answer outside 2xx: its status, and the error key and message its body carried.
|
|
46
|
+
type APIError struct {
|
|
47
|
+
Status int
|
|
48
|
+
Key string
|
|
49
|
+
Message string
|
|
50
|
+
Err error
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
func (e *APIError) Error() string { return e.Err.Error() }
|
|
54
|
+
|
|
55
|
+
func (e *APIError) Unwrap() error { return e.Err }
|
|
56
|
+
|
|
57
|
+
// App is the CLI: its binary, its one-line description, its environment variables' prefix, the
|
|
58
|
+
// API's default base URL (none when it declares no server), its commands as discovery shows
|
|
59
|
+
// them, and the agent skill it ships.
|
|
60
|
+
type App struct {
|
|
61
|
+
Name string
|
|
62
|
+
Short string
|
|
63
|
+
EnvPrefix string
|
|
64
|
+
Server string
|
|
65
|
+
Discovery Discovery
|
|
66
|
+
Skill string
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// Root is the CLI's root command: the API's commands in one help group, the local ones
|
|
70
|
+
// (commands, completion, config, schema, skill, help) in another, a two-line banner pointing an
|
|
71
|
+
// agent at discovery, --version printing the version alone, the global flags, and an unknown
|
|
72
|
+
// command or flag a usage error.
|
|
73
|
+
func Root(app App, api ...*cobra.Command) *cobra.Command {
|
|
74
|
+
banner := fmt.Sprintf("Agents: `%[1]s commands` lists every command, one line each.\n"+
|
|
75
|
+
"`%[1]s schema <command>` shows one's request and answer; `%[1]s config` shows where calls go.", app.Name)
|
|
76
|
+
root := &cobra.Command{
|
|
77
|
+
Use: app.Name, Short: app.Short, Long: app.Short + "\n\n" + banner,
|
|
78
|
+
Version: Version, SilenceErrors: true, SilenceUsage: true,
|
|
79
|
+
}
|
|
80
|
+
root.SetVersionTemplate("{{.Version}}\n")
|
|
81
|
+
root.SetFlagErrorFunc(func(_ *cobra.Command, err error) error { return &UsageError{msg: err.Error()} })
|
|
82
|
+
if len(api) > 0 {
|
|
83
|
+
root.AddGroup(&cobra.Group{ID: apiGroup, Title: "API commands:"})
|
|
84
|
+
for _, cmd := range api {
|
|
85
|
+
cmd.GroupID = apiGroup
|
|
86
|
+
}
|
|
87
|
+
root.AddCommand(api...)
|
|
88
|
+
}
|
|
89
|
+
root.AddGroup(&cobra.Group{ID: localGroup, Title: "Local commands:"})
|
|
90
|
+
root.SetHelpCommandGroupID(localGroup)
|
|
91
|
+
root.SetCompletionCommandGroupID(localGroup)
|
|
92
|
+
globalFlags(root, app)
|
|
93
|
+
outputFlags(root)
|
|
94
|
+
discover(root, app)
|
|
95
|
+
configCommand(root)
|
|
96
|
+
Group(root)
|
|
97
|
+
return root
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// Group makes cmd a command that holds others: an argument naming none of them is a usage error,
|
|
101
|
+
// and no argument prints its help.
|
|
102
|
+
func Group(cmd *cobra.Command) *cobra.Command {
|
|
103
|
+
cmd.Args = func(c *cobra.Command, args []string) error {
|
|
104
|
+
if len(args) > 0 {
|
|
105
|
+
return Usage("unknown command %q for %q", args[0], c.CommandPath())
|
|
106
|
+
}
|
|
107
|
+
return nil
|
|
108
|
+
}
|
|
109
|
+
cmd.RunE = func(c *cobra.Command, _ []string) error { return c.Help() }
|
|
110
|
+
return cmd
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
// Run runs root with args, writing to stdout and stderr, and returns the exit code its outcome
|
|
114
|
+
// maps to; an error is printed to stderr after the CLI's name. Ctrl-C cancels the call in flight.
|
|
115
|
+
func Run(root *cobra.Command, args []string, stdout, stderr io.Writer) int {
|
|
116
|
+
ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt)
|
|
117
|
+
defer stop()
|
|
118
|
+
root.SetArgs(args)
|
|
119
|
+
root.SetOut(stdout)
|
|
120
|
+
root.SetErr(stderr)
|
|
121
|
+
cmd, err := root.ExecuteContextC(ctx)
|
|
122
|
+
/* a stream Ctrl-C ends returns no error: the interrupt is the outcome */
|
|
123
|
+
interrupted := ctx.Err() != nil
|
|
124
|
+
if err != nil {
|
|
125
|
+
report(cmd, err, interrupted)
|
|
126
|
+
}
|
|
127
|
+
switch {
|
|
128
|
+
case interrupted:
|
|
129
|
+
return ExitInterrupted
|
|
130
|
+
case err == nil:
|
|
131
|
+
return ExitOK
|
|
132
|
+
}
|
|
133
|
+
return Exit(err)
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
// report writes err to stderr: under JSON (--json, or stdout not a terminal) as one line of
|
|
137
|
+
// {"error": {kind, status, errorKey, message}}, else after the CLI's name.
|
|
138
|
+
func report(cmd *cobra.Command, err error, interrupted bool) {
|
|
139
|
+
err = redirectHint(cmd, err)
|
|
140
|
+
stderr := cmd.ErrOrStderr()
|
|
141
|
+
if o, _ := outputOf(cmd, cmd.OutOrStdout()); o.format != "json" {
|
|
142
|
+
fmt.Fprintf(stderr, "%s: %s\n", cmd.Root().Name(), escapeControls(err.Error(), false))
|
|
143
|
+
return
|
|
144
|
+
}
|
|
145
|
+
line, _ := compact(map[string]any{"error": described(err, interrupted)})
|
|
146
|
+
stderr.Write(line)
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
// redirectHint is err, a redirect the run did not follow named with the way out; the run's own
|
|
150
|
+
// redirect setting decides, since under follow a redirect carrying a body is still not followed.
|
|
151
|
+
func redirectHint(cmd *cobra.Command, err error) error {
|
|
152
|
+
var api *APIError
|
|
153
|
+
if !errors.As(err, &api) || api.Status < 300 || api.Status > 399 || redirectOf(cmd) == "follow" {
|
|
154
|
+
return err
|
|
155
|
+
}
|
|
156
|
+
hinted := *api
|
|
157
|
+
hinted.Message = fmt.Sprintf("the API answered %d, a redirect not followed: rerun with --redirect follow to follow it", api.Status)
|
|
158
|
+
hinted.Err = errors.New(hinted.Message)
|
|
159
|
+
return &hinted
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// described is err as a script reads it: its kind, and for an API answer its status and key.
|
|
163
|
+
func described(err error, interrupted bool) map[string]any {
|
|
164
|
+
out := map[string]any{"kind": kindOf(err, interrupted), "message": err.Error()}
|
|
165
|
+
var api *APIError
|
|
166
|
+
if errors.As(err, &api) {
|
|
167
|
+
out["status"] = api.Status
|
|
168
|
+
if api.Key != "" {
|
|
169
|
+
out["errorKey"] = api.Key
|
|
170
|
+
}
|
|
171
|
+
if api.Message != "" {
|
|
172
|
+
out["message"] = api.Message
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
return out
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
func kindOf(err error, interrupted bool) string {
|
|
179
|
+
var usage *UsageError
|
|
180
|
+
var api *APIError
|
|
181
|
+
var network net.Error
|
|
182
|
+
var closed *Closed
|
|
183
|
+
switch {
|
|
184
|
+
case interrupted:
|
|
185
|
+
return "interrupted"
|
|
186
|
+
case errors.As(err, &usage):
|
|
187
|
+
return "usage"
|
|
188
|
+
case errors.As(err, &api):
|
|
189
|
+
return "api"
|
|
190
|
+
case errors.Is(err, context.DeadlineExceeded), errors.As(err, &network) && network.Timeout():
|
|
191
|
+
return "timeout"
|
|
192
|
+
case errors.As(err, &network), errors.As(err, &closed), errors.Is(err, io.ErrUnexpectedEOF):
|
|
193
|
+
return "transport"
|
|
194
|
+
}
|
|
195
|
+
return "error"
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
// Exit is the code for err: 0 for none, then by its kind (the Exit constants).
|
|
199
|
+
func Exit(err error) int {
|
|
200
|
+
if err == nil {
|
|
201
|
+
return ExitOK
|
|
202
|
+
}
|
|
203
|
+
switch kindOf(err, false) {
|
|
204
|
+
case "usage":
|
|
205
|
+
return ExitUsage
|
|
206
|
+
case "api":
|
|
207
|
+
var api *APIError
|
|
208
|
+
errors.As(err, &api)
|
|
209
|
+
return statusExit(api.Status)
|
|
210
|
+
case "timeout", "transport":
|
|
211
|
+
return ExitTransport
|
|
212
|
+
}
|
|
213
|
+
return ExitError
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
// statusExit is the code for an answer's status outside 2xx.
|
|
217
|
+
func statusExit(status int) int {
|
|
218
|
+
switch {
|
|
219
|
+
case status >= 500:
|
|
220
|
+
return ExitServer
|
|
221
|
+
case status >= 400:
|
|
222
|
+
return ExitError
|
|
223
|
+
default:
|
|
224
|
+
return ExitRedirect
|
|
225
|
+
}
|
|
226
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package cli
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"bufio"
|
|
7
|
+
"context"
|
|
8
|
+
"errors"
|
|
9
|
+
|
|
10
|
+
"github.com/coder/websocket"
|
|
11
|
+
)
|
|
12
|
+
|
|
13
|
+
// Socket is a WebSocket connection as the SDK opens it.
|
|
14
|
+
type Socket interface {
|
|
15
|
+
Send(ctx context.Context, data any) error
|
|
16
|
+
Read(ctx context.Context) ([]byte, error)
|
|
17
|
+
Close(code websocket.StatusCode, reason string) error
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
// Converse sends each standard-input line as a text frame, reading on after its end, and prints
|
|
21
|
+
// each message as one line until the server closes, --take is met (a close frame 1000) or the run
|
|
22
|
+
// is interrupted (a close frame 1000 "interrupted").
|
|
23
|
+
func (s *Stream) Converse(conn Socket) error {
|
|
24
|
+
/* reads outlive Ctrl-C, so the close frame goes out and is answered */
|
|
25
|
+
ctx := context.WithoutCancel(s.c.Context())
|
|
26
|
+
stop := context.AfterFunc(s.c.Context(), func() { conn.Close(websocket.StatusNormalClosure, "interrupted") })
|
|
27
|
+
defer stop()
|
|
28
|
+
go func() {
|
|
29
|
+
lines := bufio.NewScanner(s.c.InOrStdin())
|
|
30
|
+
for lines.Scan() {
|
|
31
|
+
if conn.Send(ctx, lines.Text()) != nil {
|
|
32
|
+
return
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}()
|
|
36
|
+
for {
|
|
37
|
+
message, err := conn.Read(ctx)
|
|
38
|
+
if err != nil {
|
|
39
|
+
return closedOf(err, s.c.Context().Err() != nil)
|
|
40
|
+
}
|
|
41
|
+
if !s.Write(textOf(message)) {
|
|
42
|
+
conn.Close(websocket.StatusNormalClosure, "")
|
|
43
|
+
return s.err
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
// closedOf is a read's end as the command's outcome: none for a normal close or an interrupt.
|
|
49
|
+
func closedOf(err error, interrupted bool) error {
|
|
50
|
+
var closed websocket.CloseError
|
|
51
|
+
switch {
|
|
52
|
+
case interrupted:
|
|
53
|
+
return nil
|
|
54
|
+
case !errors.As(err, &closed):
|
|
55
|
+
return &Closed{Code: -1, Err: err}
|
|
56
|
+
case closed.Code == websocket.StatusNormalClosure, closed.Code == websocket.StatusGoingAway:
|
|
57
|
+
return nil
|
|
58
|
+
}
|
|
59
|
+
return &Closed{Code: int(closed.Code), Reason: closed.Reason, Err: err}
|
|
60
|
+
}
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
// Code generated by honey. DO NOT EDIT.
|
|
2
|
+
|
|
3
|
+
package cli
|
|
4
|
+
|
|
5
|
+
import (
|
|
6
|
+
"encoding/base64"
|
|
7
|
+
"encoding/json"
|
|
8
|
+
"fmt"
|
|
9
|
+
"io"
|
|
10
|
+
"os"
|
|
11
|
+
"unicode/utf8"
|
|
12
|
+
|
|
13
|
+
"github.com/spf13/cobra"
|
|
14
|
+
)
|
|
15
|
+
|
|
16
|
+
// Stream is where a stream command prints: each event as one line of compact JSON (a YAML
|
|
17
|
+
// document under yaml), until --take is met.
|
|
18
|
+
type Stream struct {
|
|
19
|
+
c *cobra.Command
|
|
20
|
+
o output
|
|
21
|
+
out io.Writer
|
|
22
|
+
file *os.File
|
|
23
|
+
take int
|
|
24
|
+
seen int
|
|
25
|
+
err error
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
// Take declares --take, the number of events a stream command prints before it ends.
|
|
29
|
+
func (p *Params) Take() {
|
|
30
|
+
p.cmd.Flags().Int("take", 0, "end after this many events (default: until the stream ends)")
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
// MaxReconnects declares --max-reconnects, how often a realtime command reconnects before it fails.
|
|
34
|
+
func (p *Params) MaxReconnects() {
|
|
35
|
+
p.cmd.Flags().Int("max-reconnects", 0, "reconnect at most this many times: 1 or more; default 5")
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
// Reconnects is --max-reconnects as given, 1 or more; 0 when it was not, the SDK's default.
|
|
39
|
+
func (p *Params) Reconnects() (int, error) {
|
|
40
|
+
if !p.cmd.Flags().Changed("max-reconnects") {
|
|
41
|
+
return 0, nil
|
|
42
|
+
}
|
|
43
|
+
n, _ := p.cmd.Flags().GetInt("max-reconnects")
|
|
44
|
+
if n < 1 {
|
|
45
|
+
return 0, Usage("--max-reconnects %d: want 1 or more", n)
|
|
46
|
+
}
|
|
47
|
+
return n, nil
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
// OpenStream checks a stream command's output flags before anything is sent: -i and --raw take one
|
|
51
|
+
// answer, --take is 1 or more, and a table prints as ndjson (one warning when it was asked for).
|
|
52
|
+
func OpenStream(c *cobra.Command) (*Stream, error) {
|
|
53
|
+
o, err := outputOf(c, c.OutOrStdout())
|
|
54
|
+
if err != nil {
|
|
55
|
+
return nil, err
|
|
56
|
+
}
|
|
57
|
+
if o.include || o.raw {
|
|
58
|
+
return nil, Usage("-i and --raw take one answer: %s streams", c.CommandPath())
|
|
59
|
+
}
|
|
60
|
+
take, _ := c.Flags().GetInt("take")
|
|
61
|
+
if c.Flags().Changed("take") && take < 1 {
|
|
62
|
+
return nil, Usage("--take %d: want 1 or more", take)
|
|
63
|
+
}
|
|
64
|
+
if o.format == "table" {
|
|
65
|
+
if c.Flags().Changed("format") {
|
|
66
|
+
fmt.Fprintf(c.ErrOrStderr(), "%s: a stream prints no table: ndjson instead\n", c.Root().Name())
|
|
67
|
+
}
|
|
68
|
+
o.format = "ndjson"
|
|
69
|
+
}
|
|
70
|
+
s := &Stream{c: c, o: o, out: c.OutOrStdout(), take: take}
|
|
71
|
+
if o.file != "" {
|
|
72
|
+
if s.file, err = os.Create(o.file); err != nil {
|
|
73
|
+
return nil, Usage("-o: %v", err)
|
|
74
|
+
}
|
|
75
|
+
s.out = s.file
|
|
76
|
+
}
|
|
77
|
+
return s, nil
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// Close closes the file -o names, if any.
|
|
81
|
+
func (s *Stream) Close() {
|
|
82
|
+
if s.file != nil {
|
|
83
|
+
s.file.Close()
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// Err is the first write that failed, if any.
|
|
88
|
+
func (s *Stream) Err() error { return s.err }
|
|
89
|
+
|
|
90
|
+
// an event line: the event's name and id when set, its data
|
|
91
|
+
type eventLine struct {
|
|
92
|
+
Event string `json:"event,omitempty"`
|
|
93
|
+
ID string `json:"id,omitempty"`
|
|
94
|
+
Data any `json:"data"`
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
// Event prints a server-sent event, its data as JSON when it is; false once the stream should end.
|
|
98
|
+
func (s *Stream) Event(name, id string, data any) bool {
|
|
99
|
+
if text, ok := data.(string); ok {
|
|
100
|
+
data = textOf([]byte(text))
|
|
101
|
+
}
|
|
102
|
+
return s.Write(eventLine{Event: name, ID: id, Data: data})
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
// Write prints one value as the stream's next line; false once --take is met or a write failed.
|
|
106
|
+
func (s *Stream) Write(v any) bool {
|
|
107
|
+
line, err := compact(v)
|
|
108
|
+
if err == nil && s.o.format == "yaml" {
|
|
109
|
+
var text []byte
|
|
110
|
+
if text, err = s.o.encode(v); err == nil {
|
|
111
|
+
line = append([]byte("---\n"), text...)
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
if err == nil {
|
|
115
|
+
_, err = s.out.Write(line)
|
|
116
|
+
}
|
|
117
|
+
if err != nil {
|
|
118
|
+
s.err = err
|
|
119
|
+
return false
|
|
120
|
+
}
|
|
121
|
+
s.seen++
|
|
122
|
+
return s.take == 0 || s.seen < s.take
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// textOf is a message's bytes as printed: its JSON when it is JSON, else a string, and
|
|
126
|
+
// {"bytes": base64} when it is not UTF-8 (a string would lose them).
|
|
127
|
+
func textOf(raw []byte) any {
|
|
128
|
+
switch {
|
|
129
|
+
case !utf8.Valid(raw):
|
|
130
|
+
return map[string]string{"bytes": base64.StdEncoding.EncodeToString(raw)}
|
|
131
|
+
case json.Valid(raw):
|
|
132
|
+
return json.RawMessage(raw)
|
|
133
|
+
}
|
|
134
|
+
return string(raw)
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
// Closed is a connection the server closed with a code other than 1000 or 1001, or that dropped
|
|
138
|
+
// (code -1): a transport failure.
|
|
139
|
+
type Closed struct {
|
|
140
|
+
Code int
|
|
141
|
+
Reason string
|
|
142
|
+
Err error
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
func (e *Closed) Error() string {
|
|
146
|
+
if e.Code < 0 {
|
|
147
|
+
return fmt.Sprintf("the connection dropped: %v", e.Err)
|
|
148
|
+
}
|
|
149
|
+
return fmt.Sprintf("the server closed the connection: %d %s", e.Code, e.Reason)
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
// Feed is a realtime connection as the SDK opens it.
|
|
153
|
+
type Feed interface {
|
|
154
|
+
Events() <-chan any
|
|
155
|
+
Errors() <-chan error
|
|
156
|
+
Cursor() (lastEventID, reconnectToken string)
|
|
157
|
+
Close() error
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
// Resume prints each event a realtime feed delivers until it ends, --take is met or the run is
|
|
161
|
+
// interrupted; then its cursor, to resume from.
|
|
162
|
+
func (s *Stream) Resume(feed Feed) error {
|
|
163
|
+
err := s.follow(feed)
|
|
164
|
+
feed.Close()
|
|
165
|
+
s.Cursor(feed.Cursor())
|
|
166
|
+
return err
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
func (s *Stream) follow(feed Feed) error {
|
|
170
|
+
for {
|
|
171
|
+
select {
|
|
172
|
+
case <-s.c.Context().Done():
|
|
173
|
+
return nil
|
|
174
|
+
case err := <-feed.Errors():
|
|
175
|
+
return err
|
|
176
|
+
case v, ok := <-feed.Events():
|
|
177
|
+
if !ok {
|
|
178
|
+
return nil
|
|
179
|
+
}
|
|
180
|
+
if text, isText := v.(string); isText {
|
|
181
|
+
v = textOf([]byte(text))
|
|
182
|
+
}
|
|
183
|
+
if !s.Write(v) {
|
|
184
|
+
return s.err
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
// Cursor writes where a feed stopped to stderr, to resume from with --reconnect-token and
|
|
191
|
+
// --last-event-id: one JSON line under JSON, else after the CLI's name; nothing when there is none.
|
|
192
|
+
func (s *Stream) Cursor(lastEventID, reconnectToken string) {
|
|
193
|
+
if lastEventID == "" && reconnectToken == "" {
|
|
194
|
+
return
|
|
195
|
+
}
|
|
196
|
+
stderr := s.c.ErrOrStderr()
|
|
197
|
+
if s.o.format != "json" {
|
|
198
|
+
var flags string
|
|
199
|
+
if reconnectToken != "" {
|
|
200
|
+
flags += " --reconnect-token " + reconnectToken
|
|
201
|
+
}
|
|
202
|
+
if lastEventID != "" {
|
|
203
|
+
flags += " --last-event-id " + lastEventID
|
|
204
|
+
}
|
|
205
|
+
fmt.Fprintf(stderr, "%s: resume with%s\n", s.c.Root().Name(), escapeControls(flags, false))
|
|
206
|
+
return
|
|
207
|
+
}
|
|
208
|
+
cursor := map[string]string{}
|
|
209
|
+
if lastEventID != "" {
|
|
210
|
+
cursor["lastEventId"] = lastEventID
|
|
211
|
+
}
|
|
212
|
+
if reconnectToken != "" {
|
|
213
|
+
cursor["reconnectToken"] = reconnectToken
|
|
214
|
+
}
|
|
215
|
+
line, _ := compact(map[string]any{"resume": cursor})
|
|
216
|
+
stderr.Write(line)
|
|
217
|
+
}
|