@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.
- 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 +135 -5
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.nio.charset.StandardCharsets;
|
|
5
|
+
import java.util.ArrayList;
|
|
6
|
+
import java.util.List;
|
|
7
|
+
import tools.jackson.databind.JsonNode;
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Encodes a query: each arg once per item, names and values form-encoded, an unset or empty value
|
|
11
|
+
* sent as nothing.
|
|
12
|
+
*/
|
|
13
|
+
final class UrlQuery {
|
|
14
|
+
private UrlQuery() {}
|
|
15
|
+
|
|
16
|
+
/** The query string of {@code args}, without the {@code ?}. */
|
|
17
|
+
static String encode(List<Call.Arg> args) {
|
|
18
|
+
StringBuilder query = new StringBuilder();
|
|
19
|
+
for (Call.Arg arg : args) {
|
|
20
|
+
for (String text : texts(arg.value())) {
|
|
21
|
+
append(query, arg.name(), text);
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
return query.toString();
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* The texts of {@code value}: each item of an array, else the value itself, unset ones dropped.
|
|
29
|
+
*/
|
|
30
|
+
static List<String> texts(JsonNode value) {
|
|
31
|
+
List<String> texts = new ArrayList<>();
|
|
32
|
+
if (value != null && value.isArray()) {
|
|
33
|
+
for (JsonNode item : value) {
|
|
34
|
+
addIfText(texts, item);
|
|
35
|
+
}
|
|
36
|
+
} else {
|
|
37
|
+
addIfText(texts, value);
|
|
38
|
+
}
|
|
39
|
+
return texts;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
private static void addIfText(List<String> texts, JsonNode value) {
|
|
43
|
+
String text = text(value);
|
|
44
|
+
if (text != null) {
|
|
45
|
+
texts.add(text);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* The text of one value: a string as it is, an empty object as nothing, any other value as its
|
|
51
|
+
* JSON.
|
|
52
|
+
*/
|
|
53
|
+
static String text(JsonNode value) {
|
|
54
|
+
if (value == null || value.isNull() || value.isMissingNode()) {
|
|
55
|
+
return null;
|
|
56
|
+
}
|
|
57
|
+
if (value.isString()) {
|
|
58
|
+
return value.asString();
|
|
59
|
+
}
|
|
60
|
+
if (value.isObject() && value.isEmpty()) {
|
|
61
|
+
return null;
|
|
62
|
+
}
|
|
63
|
+
return value.toString();
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** Appends {@code name=text}, joined to what is there by {@code &}. */
|
|
67
|
+
static void append(StringBuilder query, String name, String text) {
|
|
68
|
+
if (query.length() > 0) {
|
|
69
|
+
query.append('&');
|
|
70
|
+
}
|
|
71
|
+
form(query, name);
|
|
72
|
+
query.append('=');
|
|
73
|
+
form(query, text);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
private static void form(StringBuilder query, String text) {
|
|
77
|
+
String[] words = text.split(" ", -1);
|
|
78
|
+
for (int i = 0; i < words.length; i++) {
|
|
79
|
+
if (i > 0) {
|
|
80
|
+
query.append('+');
|
|
81
|
+
}
|
|
82
|
+
escape(query, words[i], "*-._");
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* Appends {@code value} with each byte but the letters, digits and {@code safe} percent-encoded.
|
|
88
|
+
*/
|
|
89
|
+
static void escape(StringBuilder out, String value, String safe) {
|
|
90
|
+
for (byte b : value.getBytes(StandardCharsets.UTF_8)) {
|
|
91
|
+
char c = (char) (b & 0xFF);
|
|
92
|
+
if (c < 128 && (Character.isLetterOrDigit(c) || safe.indexOf(c) >= 0)) {
|
|
93
|
+
out.append(c);
|
|
94
|
+
} else {
|
|
95
|
+
out.append('%').append(String.format("%02X", b & 0xFF));
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* A realtime call's WebSocket: its own upgrade with the cursor as query params, no hook and no log
|
|
6
|
+
* on the dial.
|
|
7
|
+
*/
|
|
8
|
+
final class WsAdapter implements TransportAdapter, RealtimeLoop.Dialed {
|
|
9
|
+
private final Realtime dial;
|
|
10
|
+
|
|
11
|
+
WsAdapter(Realtime dial) {
|
|
12
|
+
this.dial = dial;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
@Override
|
|
16
|
+
public Realtime dial() {
|
|
17
|
+
return dial;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
@Override
|
|
21
|
+
public String name() {
|
|
22
|
+
return "ws";
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
@Override
|
|
26
|
+
public TransportKind kind() {
|
|
27
|
+
return TransportKind.WS;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Dials the call's socket; {@code url} is a caller's adapter's. */
|
|
31
|
+
@Override
|
|
32
|
+
public TransportConnection connect(String url, TransportOptions options) {
|
|
33
|
+
TypedWebSocket socket = dial.socket(options);
|
|
34
|
+
return new TransportConnection() {
|
|
35
|
+
@Override
|
|
36
|
+
public TransportMessage receive() {
|
|
37
|
+
WsMessage message = socket.receive();
|
|
38
|
+
return message == null ? null : new TransportMessage(message.text(), null, null);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
@Override
|
|
42
|
+
public void send(String text) {
|
|
43
|
+
socket.send(text);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
@Override
|
|
47
|
+
public void close() {
|
|
48
|
+
socket.close();
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
/** A WebSocket close: its status code and its reason. */
|
|
5
|
+
public record WsClose(int status, String reason) {
|
|
6
|
+
/**
|
|
7
|
+
* Refuses a status no client may send, before any frame: ConfigException, the socket left open.
|
|
8
|
+
*/
|
|
9
|
+
static void check(int status) {
|
|
10
|
+
if (!sendable(status)) {
|
|
11
|
+
throw new ConfigException(
|
|
12
|
+
"a WebSocket client can't close with status "
|
|
13
|
+
+ status
|
|
14
|
+
+ ": 1000, 1001, 1008, 1011 or 3000-4999");
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Whether a client may send {@code status}: the JDK sends 1000, 1001, 1008, 1011 and 3000-4999
|
|
20
|
+
* alone.
|
|
21
|
+
*/
|
|
22
|
+
static boolean sendable(int status) {
|
|
23
|
+
return status == 1000
|
|
24
|
+
|| status == 1001
|
|
25
|
+
|| status == 1008
|
|
26
|
+
|| status == 1011
|
|
27
|
+
|| (status >= 3000 && status <= 4999);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* {@code reason} cut to 123 UTF-8 bytes on a code point: a close frame holds 125, the code two.
|
|
32
|
+
*/
|
|
33
|
+
static String cut(String reason) {
|
|
34
|
+
int bytes = 0;
|
|
35
|
+
int at = 0;
|
|
36
|
+
while (at < reason.length()) {
|
|
37
|
+
int point = reason.codePointAt(at);
|
|
38
|
+
int size = point < 0x80 ? 1 : point < 0x800 ? 2 : point < 0x10000 ? 3 : 4;
|
|
39
|
+
if (bytes + size > 123) {
|
|
40
|
+
break;
|
|
41
|
+
}
|
|
42
|
+
bytes += size;
|
|
43
|
+
at += Character.charCount(point);
|
|
44
|
+
}
|
|
45
|
+
return reason.substring(0, at);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.net.URI;
|
|
5
|
+
import java.net.http.HttpResponse;
|
|
6
|
+
import java.net.http.HttpTimeoutException;
|
|
7
|
+
import java.net.http.WebSocket;
|
|
8
|
+
import java.net.http.WebSocketHandshakeException;
|
|
9
|
+
import java.nio.charset.StandardCharsets;
|
|
10
|
+
import java.time.Duration;
|
|
11
|
+
import java.util.Arrays;
|
|
12
|
+
import java.util.List;
|
|
13
|
+
import java.util.Locale;
|
|
14
|
+
import java.util.Map;
|
|
15
|
+
import java.util.TreeMap;
|
|
16
|
+
import java.util.UUID;
|
|
17
|
+
import java.util.concurrent.CancellationException;
|
|
18
|
+
import java.util.concurrent.CompletableFuture;
|
|
19
|
+
import java.util.concurrent.ExecutionException;
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* A WebSocket call's dial: the path checked, the call's headers layered (a fresh X-Request-Id, the
|
|
23
|
+
* config's, the call's, the options', the credential) with no hook and no log, a restricted name
|
|
24
|
+
* refused by name, the subprotocols offered, the call's timeout bounding the handshake alone. A
|
|
25
|
+
* refusal is its status exception (its body read at most 64 KiB); no redirect is followed.
|
|
26
|
+
*/
|
|
27
|
+
final class WsDial {
|
|
28
|
+
private static final int ERROR_CAP = 64 * 1024;
|
|
29
|
+
|
|
30
|
+
private WsDial() {}
|
|
31
|
+
|
|
32
|
+
static TypedWebSocket open(
|
|
33
|
+
Exchange exchange, Operation op, Call call, RequestOptions given, List<String> protocols) {
|
|
34
|
+
RequestOptions options = given == null ? RequestOptions.NONE : given;
|
|
35
|
+
ClientConfig config = exchange.config();
|
|
36
|
+
if (java.lang.Thread.currentThread().isInterrupted()) {
|
|
37
|
+
throw new CancellationException("the call was canceled");
|
|
38
|
+
}
|
|
39
|
+
String origin = options.baseUrl() != null ? options.baseUrl() : config.baseUrl();
|
|
40
|
+
String path = UrlPath.expand(op.template(), op.names(), call.path());
|
|
41
|
+
String query = UrlQuery.encode(call.query());
|
|
42
|
+
String base = origin.replaceAll("/+$", "").replaceFirst("^http", "ws");
|
|
43
|
+
URI url = URI.create(base + path + (query.isEmpty() ? "" : "?" + query));
|
|
44
|
+
WebSocket.Builder builder = exchange.http().newWebSocketBuilder();
|
|
45
|
+
headers(exchange, call, options).forEach(builder::header);
|
|
46
|
+
if (protocols != null && !protocols.isEmpty()) {
|
|
47
|
+
builder.subprotocols(
|
|
48
|
+
protocols.get(0), protocols.subList(1, protocols.size()).toArray(String[]::new));
|
|
49
|
+
}
|
|
50
|
+
Duration bound = options.timeout() != null ? options.timeout() : config.timeout();
|
|
51
|
+
if (bound != null && !bound.isZero()) {
|
|
52
|
+
builder.connectTimeout(bound);
|
|
53
|
+
}
|
|
54
|
+
Socket socket = new Socket(Keepalive.EVERY);
|
|
55
|
+
CompletableFuture<WebSocket> dial = builder.buildAsync(url, socket);
|
|
56
|
+
try {
|
|
57
|
+
dial.get();
|
|
58
|
+
} catch (InterruptedException e) {
|
|
59
|
+
dial.cancel(true);
|
|
60
|
+
java.lang.Thread.currentThread().interrupt();
|
|
61
|
+
throw new CancellationException("the call was canceled");
|
|
62
|
+
} catch (ExecutionException e) {
|
|
63
|
+
throw refused(e.getCause(), op.route(), bound, protocols, options.raw(), url);
|
|
64
|
+
}
|
|
65
|
+
if (options.raw() != null) {
|
|
66
|
+
options.raw().fill(101, Map.of(), new byte[0], url);
|
|
67
|
+
}
|
|
68
|
+
return new TypedWebSocket(socket);
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** The dial's headers, layered as a call's; a restricted name or a value with CR/LF refused. */
|
|
72
|
+
private static Map<String, String> headers(Exchange exchange, Call call, RequestOptions options) {
|
|
73
|
+
Map<String, String> headers = new TreeMap<>(String.CASE_INSENSITIVE_ORDER);
|
|
74
|
+
headers.put("X-Request-Id", UUID.randomUUID().toString());
|
|
75
|
+
headers.putAll(exchange.config().headers());
|
|
76
|
+
for (Call.Arg arg : call.headers()) {
|
|
77
|
+
String text = UrlQuery.text(arg.value());
|
|
78
|
+
if (text != null) {
|
|
79
|
+
headers.put(arg.name(), text);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
headers.putAll(options.headers());
|
|
83
|
+
Credential credential = exchange.credential();
|
|
84
|
+
String token = credential.token();
|
|
85
|
+
if (token != null && !token.isEmpty()) {
|
|
86
|
+
headers.put(credential.header(), credential.prefix() + token);
|
|
87
|
+
}
|
|
88
|
+
for (String name : headers.keySet()) {
|
|
89
|
+
if (name.toLowerCase(Locale.ROOT).startsWith("sec-websocket-")) {
|
|
90
|
+
throw new ConfigException("the " + name + " header is restricted and cannot be sent");
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
Hops.validate(headers);
|
|
94
|
+
return headers;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* What a failed dial throws: a refusal's status exception, a 101 the JDK refused, a timeout, a
|
|
99
|
+
* connection.
|
|
100
|
+
*/
|
|
101
|
+
private static RuntimeException refused(
|
|
102
|
+
Throwable cause,
|
|
103
|
+
String route,
|
|
104
|
+
Duration bound,
|
|
105
|
+
List<String> protocols,
|
|
106
|
+
RawResponse raw,
|
|
107
|
+
URI url) {
|
|
108
|
+
if (cause instanceof WebSocketHandshakeException handshake) {
|
|
109
|
+
HttpResponse<?> answer = handshake.getResponse();
|
|
110
|
+
Map<String, String> headers = new TreeMap<>();
|
|
111
|
+
answer
|
|
112
|
+
.headers()
|
|
113
|
+
.map()
|
|
114
|
+
.forEach(
|
|
115
|
+
(name, values) ->
|
|
116
|
+
headers.put(name.toLowerCase(Locale.ROOT), String.join(", ", values)));
|
|
117
|
+
if (answer.statusCode() == 101) {
|
|
118
|
+
String chosen = headers.get("sec-websocket-protocol");
|
|
119
|
+
boolean unoffered =
|
|
120
|
+
chosen != null
|
|
121
|
+
&& !chosen.isEmpty()
|
|
122
|
+
&& (protocols == null || !protocols.contains(chosen));
|
|
123
|
+
return new ApiConnectionException(
|
|
124
|
+
"the WebSocket handshake failed"
|
|
125
|
+
+ (unoffered
|
|
126
|
+
? ": the server chose subprotocol " + chosen + ", which was not offered"
|
|
127
|
+
: ""),
|
|
128
|
+
null);
|
|
129
|
+
}
|
|
130
|
+
Object given = answer.body();
|
|
131
|
+
byte[] body =
|
|
132
|
+
given instanceof byte[] bytes
|
|
133
|
+
? bytes
|
|
134
|
+
: given == null ? new byte[0] : given.toString().getBytes(StandardCharsets.UTF_8);
|
|
135
|
+
body = Arrays.copyOf(body, Math.min(body.length, ERROR_CAP));
|
|
136
|
+
if (raw != null) {
|
|
137
|
+
raw.fill(answer.statusCode(), headers, body, url);
|
|
138
|
+
}
|
|
139
|
+
return ApiException.of(new ApiException.Failure(answer.statusCode(), headers, body));
|
|
140
|
+
}
|
|
141
|
+
if (cause instanceof HttpTimeoutException) {
|
|
142
|
+
return new ApiTimeoutException(route + " timed out after " + bound.toMillis() + " ms", cause);
|
|
143
|
+
}
|
|
144
|
+
String detail =
|
|
145
|
+
cause.getMessage() == null ? cause.getClass().getSimpleName() : cause.getMessage();
|
|
146
|
+
return new ApiConnectionException(route + ": " + detail, cause);
|
|
147
|
+
}
|
|
148
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
// @generated by honey. DO NOT EDIT.
|
|
2
|
+
package honey.runtime;
|
|
3
|
+
|
|
4
|
+
import java.nio.charset.StandardCharsets;
|
|
5
|
+
|
|
6
|
+
/** One whole WebSocket message: its kind and its bytes. */
|
|
7
|
+
public record WsMessage(Type type, byte[] data) {
|
|
8
|
+
/** A message's kind. */
|
|
9
|
+
public enum Type {
|
|
10
|
+
TEXT,
|
|
11
|
+
BINARY
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
/** The message as UTF-8 text, an invalid sequence as U+FFFD. */
|
|
15
|
+
public String text() {
|
|
16
|
+
return new String(data, StandardCharsets.UTF_8);
|
|
17
|
+
}
|
|
18
|
+
}
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A tool's call through the API's TS SDK (bit 18): each tool as tools.gen.ts describes it, bound to the SDK client's
|
|
3
|
+
* safe twin (bit 21 i1), a collect to the client's own stream. Its arguments pass guard.ts first, else nothing is
|
|
4
|
+
* sent. They go back into the SDK's input groups (each parameter under its own name: path, query or header; the body
|
|
5
|
+
* as JSON, a form, base64-decoded bytes at most 1 MiB, or text, a raw body under its content type), the SDK member the
|
|
6
|
+
* operation sits at is called with the session's abort, and its Result becomes the tool's result as result.ts shapes
|
|
7
|
+
* it, scrubbed of the API key; an event stream's, the collect stream.ts runs. Bit 21 c: a multipart form's parts are arguments, sent as multipart whether or not a file is.
|
|
8
|
+
* Bit 21 g: data-less FileInputs are staged first (files.ts), an input request or a refusal the answer.
|
|
9
|
+
*/
|
|
10
|
+
import { decoded, type Files, fileOf, staged } from "./files.ts"
|
|
11
|
+
import { redactor, refusal } from "./guard.ts"
|
|
12
|
+
import { type Answer, BYTES_MAX, failureOf, json, successOf, unanswered } from "./result.ts"
|
|
13
|
+
import type { Outcome, Tool } from "./protocol.ts"
|
|
14
|
+
import { collected } from "./stream.ts"
|
|
15
|
+
|
|
16
|
+
/** The SDK input group a parameter goes in. */
|
|
17
|
+
export type Group = "params" | "search" | "headers"
|
|
18
|
+
|
|
19
|
+
/** One tool as tools.gen.ts holds it: what tools/list shows, and how each argument reaches the SDK's input. */
|
|
20
|
+
export type ToolSpec = {
|
|
21
|
+
readonly name: string
|
|
22
|
+
readonly description?: string
|
|
23
|
+
readonly inputSchema: Record<string, unknown>
|
|
24
|
+
/** the SDK member the operation sits at, key by key from the client */
|
|
25
|
+
readonly member: readonly string[]
|
|
26
|
+
/** each parameter argument: its property, its SDK input group, the parameter's own name */
|
|
27
|
+
readonly args: readonly (readonly [property: string, group: Group, name: string])[]
|
|
28
|
+
/** the body argument's property, how it is sent, and a raw body's content type, when the operation takes a body */
|
|
29
|
+
readonly body?: readonly [property: string, field: "json" | "form" | "bytes" | "text", contentType?: string]
|
|
30
|
+
readonly outputSchema?: Record<string, unknown>
|
|
31
|
+
/** whether structuredContent wraps the answer as `{result, headers}` */
|
|
32
|
+
readonly wrap?: true
|
|
33
|
+
readonly annotations?: Record<string, boolean>
|
|
34
|
+
/** an event stream's collect: its `max_events` and `last_event_id` properties */
|
|
35
|
+
readonly collect?: readonly [max: string, lastEventId: string]
|
|
36
|
+
/** a multipart form's parts: property, name in the form, kind */
|
|
37
|
+
readonly parts?: readonly (readonly [property: string, name: string, kind: "text" | "file" | "files"])[]
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* How tools call: the secrets to scrub, a call's bound in ms, a collect's own client, whose answer runs `seen`, and the
|
|
42
|
+
* inline file bytes a call may carry.
|
|
43
|
+
*/
|
|
44
|
+
export type Binding = {
|
|
45
|
+
readonly secrets: readonly string[]
|
|
46
|
+
readonly timeout: number
|
|
47
|
+
readonly opening: (seen: () => void) => SdkClient
|
|
48
|
+
readonly inline?: number
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** The SDK client a tool drives: its members walked key by key to the operation's method. */
|
|
52
|
+
export type SdkClient = { readonly safe: object }
|
|
53
|
+
|
|
54
|
+
/** The SDK input `args` make for `spec`: each parameter in its group, the body in its field; or why it cannot be sent. */
|
|
55
|
+
function inputOf(spec: ToolSpec, args: Record<string, unknown>): Record<string, unknown> | string {
|
|
56
|
+
const input: Record<string, Record<string, unknown>> = { headers: {}, params: {}, search: {} }
|
|
57
|
+
for (const [property, group, name] of spec.args) {
|
|
58
|
+
const value = args[property]
|
|
59
|
+
if (value !== undefined)
|
|
60
|
+
(input[group] as Record<string, unknown>)[name] = group === "headers" ? String(value) : value
|
|
61
|
+
}
|
|
62
|
+
if (spec.body === undefined || args[spec.body[0]] === undefined) return input
|
|
63
|
+
const [property, field, contentType] = spec.body
|
|
64
|
+
const value = args[property]
|
|
65
|
+
if (field === "json" || field === "form") return { ...input, [field]: value }
|
|
66
|
+
;(input.headers as Record<string, unknown>)["content-type"] = contentType
|
|
67
|
+
if (field === "text") return { ...input, body: value }
|
|
68
|
+
const bytes = decoded(String(value))
|
|
69
|
+
if (bytes === undefined) return `Invalid arguments: ${property} is not base64`
|
|
70
|
+
return bytes.byteLength > BYTES_MAX
|
|
71
|
+
? `Invalid arguments: ${property} is past the ${BYTES_MAX}-byte cap`
|
|
72
|
+
: { ...input, body: bytes }
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* `input` with `args`' form as its multipart body, each file uploaded, read, fetched or decoded; else the answer. An
|
|
77
|
+
* input with no parts, or a refusal, is as it came.
|
|
78
|
+
*/
|
|
79
|
+
async function formed(
|
|
80
|
+
input: Record<string, unknown> | string,
|
|
81
|
+
spec: ToolSpec,
|
|
82
|
+
args: Record<string, unknown>,
|
|
83
|
+
files: Files & { readonly signal: AbortSignal; readonly cap: number; left: number },
|
|
84
|
+
) {
|
|
85
|
+
if (typeof input === "string" || spec.parts === undefined) return input
|
|
86
|
+
const items = spec.parts.flatMap(([property, name, kind]) =>
|
|
87
|
+
[args[property] ?? []].flat().map((item, at) => {
|
|
88
|
+
const label = `${property}${kind === "files" ? `[${at}]` : ""}`
|
|
89
|
+
return [label, name, kind === "text" ? undefined : (item as Record<string, unknown>), item] as const
|
|
90
|
+
}),
|
|
91
|
+
)
|
|
92
|
+
const values = items.flatMap(([label, , file]) => (file ? [[label, file] as const] : []))
|
|
93
|
+
const taken = await staged(spec.name, args, values, files)
|
|
94
|
+
if (!(taken instanceof Map)) return taken
|
|
95
|
+
const form = new FormData()
|
|
96
|
+
for (const [label, name, value, item] of items) {
|
|
97
|
+
const file = value && (await fileOf(value, { ...files, taken }, files))
|
|
98
|
+
if (typeof file === "string") return `Invalid arguments: ${label} ${file}`
|
|
99
|
+
if (file)
|
|
100
|
+
form.append(name, new Blob([file.bytes as Uint8Array<ArrayBuffer>], { type: file.type }), file.name ?? name)
|
|
101
|
+
else form.append(name, typeof item === "string" ? item : JSON.stringify(item))
|
|
102
|
+
}
|
|
103
|
+
/* fetch's own multipart encoding, its boundary in the content type */
|
|
104
|
+
const encoded = new Response(form)
|
|
105
|
+
const headers = { ...(input.headers as object), "content-type": encoded.headers.get("content-type") }
|
|
106
|
+
return { ...input, body: new Uint8Array(await encoded.arrayBuffer()), headers }
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/** The method at `member` on `client`, with the object it is called on. */
|
|
110
|
+
function methodAt(client: object, member: readonly string[]): [owner: unknown, method: unknown] {
|
|
111
|
+
let owner: unknown = client
|
|
112
|
+
let method: unknown = client
|
|
113
|
+
for (const key of member) {
|
|
114
|
+
owner = method
|
|
115
|
+
method = (method as Record<string, unknown>)[key]
|
|
116
|
+
}
|
|
117
|
+
return [owner, method]
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/** `specs` as tools calling `client.safe` as `binding` says, every result scrubbed of the secrets. */
|
|
121
|
+
export function bindTools(specs: readonly ToolSpec[], client: SdkClient, binding: Binding): Tool[] {
|
|
122
|
+
const scrub = redactor(binding.secrets)
|
|
123
|
+
return specs.map((spec) => ({
|
|
124
|
+
call: async (args, signal, progress, files) => {
|
|
125
|
+
const paths = spec.args.filter(([, group]) => group === "params").map(([property]) => property)
|
|
126
|
+
const cap = binding.inline ?? BYTES_MAX
|
|
127
|
+
const input = await formed(refusal(spec.inputSchema, paths, args) ?? inputOf(spec, args), spec, args, {
|
|
128
|
+
...files,
|
|
129
|
+
cap,
|
|
130
|
+
left: cap,
|
|
131
|
+
signal,
|
|
132
|
+
})
|
|
133
|
+
if (typeof input === "string") return json(scrub({ message: input }), true)
|
|
134
|
+
if ("inputRequired" in input || "invalid" in input) return input as Outcome
|
|
135
|
+
let opened = false
|
|
136
|
+
const [owner, method] = methodAt(spec.collect ? binding.opening(() => (opened = true)) : client.safe, spec.member)
|
|
137
|
+
const send = (more: object) => (method as (input: unknown) => unknown).call(owner, { ...input, ...more })
|
|
138
|
+
try {
|
|
139
|
+
if (spec.collect)
|
|
140
|
+
return await collected(spec.collect, args, send, {
|
|
141
|
+
opened: () => opened,
|
|
142
|
+
progress,
|
|
143
|
+
scrub,
|
|
144
|
+
signal,
|
|
145
|
+
timeout: binding.timeout,
|
|
146
|
+
})
|
|
147
|
+
const answer = (await send({ signal })) as Answer
|
|
148
|
+
const { status } = answer.response
|
|
149
|
+
if (answer.ok) return { ...successOf(spec, answer, scrub), _meta: { "honey/status": status } }
|
|
150
|
+
/* an error status's JSON object body speaks for it, any other answer its error */
|
|
151
|
+
const { body } = answer.error as { body?: unknown }
|
|
152
|
+
const error = body && typeof body === "object" && !Array.isArray(body) ? body : answer.error
|
|
153
|
+
return { ...failureOf({ error, status }, scrub), _meta: { "honey/status": status } }
|
|
154
|
+
} catch (error) {
|
|
155
|
+
const status = (error as { status?: unknown } | null)?.status
|
|
156
|
+
return typeof status === "number"
|
|
157
|
+
? { ...failureOf({ error, status }, scrub), _meta: { "honey/status": status } }
|
|
158
|
+
: unanswered(error, scrub)
|
|
159
|
+
}
|
|
160
|
+
},
|
|
161
|
+
...(spec.description === undefined ? {} : { description: spec.description }),
|
|
162
|
+
inputSchema: spec.inputSchema,
|
|
163
|
+
...(spec.outputSchema === undefined ? {} : { outputSchema: spec.outputSchema }),
|
|
164
|
+
...(spec.annotations === undefined ? {} : { annotations: spec.annotations }),
|
|
165
|
+
name: spec.name,
|
|
166
|
+
}))
|
|
167
|
+
}
|