argsbarg 7.1.2 → 7.1.4

package/examples/full-example-json/docs/cli.md

@@ -14,6 +14,7 @@ Argsbarg schema-first copy template (@sg schemagen, JSON schemas, REST CRUD)
 
 - `echo` — Echo a message (MCP-friendly leaf).
 - `render-json` — Echo a JSON message (schema-first JSON leaf demo).
+- `shape-area` — Compute the area of a circle or rectangle (union-input JSON leaf demo).
 - `status` — Show app version.
 - `workspaces` — Workspace collection and CRUD.
 
@@ -205,11 +206,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ##### `full-example-json echo mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 #### `full-example-json echo http`
 
@@ -422,11 +423,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ##### `full-example-json render-json mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 #### `full-example-json render-json http`
 
@@ -457,6 +458,223 @@ HTTP API server for tools.
 | `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
 | `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
 
+### `full-example-json shape-area`
+
+Compute the area of a circle or rectangle (union-input JSON leaf demo).
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+#### `full-example-json shape-area version`
+
+Print the program version.
+
+#### `full-example-json shape-area configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+##### `full-example-json shape-area configure install`
+
+Install agent artifacts and bootstrap app config.
+
+##### `full-example-json shape-area configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+##### `full-example-json shape-area configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+#### `full-example-json shape-area docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+##### `full-example-json shape-area docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json shape-area docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json shape-area docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json shape-area docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json shape-area docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json shape-area docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### `full-example-json shape-area mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
+
+##### `full-example-json shape-area mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
+
+#### `full-example-json shape-area http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
 ### `full-example-json status`
 
 Show app version.
@@ -667,11 +885,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ##### `full-example-json status mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 #### `full-example-json status http`
 
@@ -894,11 +1112,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces get mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ##### `full-example-json workspaces get http`
 
@@ -1111,11 +1329,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces post mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ##### `full-example-json workspaces post http`
 
@@ -1339,11 +1557,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id get mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id get http`
 
@@ -1556,11 +1774,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id put mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id put http`
 
@@ -1773,11 +1991,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id patch mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id patch http`
 
@@ -1990,11 +2208,11 @@ MCP server and bundle tools.
 
 #### Subcommands
 
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id delete mcp bundle`
 
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>.
 
 ###### `full-example-json workspaces :id delete http`
 

package/examples/full-example-json/docs/http.md

@@ -61,6 +61,7 @@ See the argsbarg [logging guide](https://github.com/bdombro/bun-argsbarg/blob/ma
 
 - `POST /echo` (CLI: `full-example-json echo`) — Echo a message (MCP-friendly leaf).
 - `POST /render-json` (CLI: `full-example-json render-json`) — Echo a JSON message (schema-first JSON leaf demo).
+- `POST /shape-area` (CLI: `full-example-json shape-area`) — Compute the area of a circle or rectangle (union-input JSON leaf demo).
 - `POST /status` (CLI: `full-example-json status`) — Show app version.
 - `GET /workspaces` (CLI: `full-example-json workspaces get`) — List workspaces.
 - `POST /workspaces` (CLI: `full-example-json workspaces post`) — Create a workspace.

package/examples/full-example-json/docs/mcp.md

@@ -93,6 +93,7 @@ full-example-json mcp
 
 - `full-example-json echo` — echo — Echo a message (MCP-friendly leaf).
 - `full-example-json render-json` — render-json — Echo a JSON message (schema-first JSON leaf demo).
+- `full-example-json shape-area` — shape-area — Compute the area of a circle or rectangle (union-input JSON leaf demo).
 - `full-example-json status` — status — Show app version.
 - `full-example-json workspaces :id delete` — workspaces :id delete — Delete a workspace.
 - `full-example-json workspaces :id get` — workspaces :id get — Get one workspace.
@@ -101,6 +102,23 @@ full-example-json mcp
 - `full-example-json workspaces get` — workspaces get — List workspaces.
 - `full-example-json workspaces post` — workspaces post — Create a workspace.
 
+## Tool sizes
+
+Clients read tool definitions with their own limits — a definition or description past those is truncated or read incompletely. Default limits here: description 2,048 chars, definition 51,200 bytes / 2,000 lines (override with `mcpServer.sizeLimits`).
+
+| Tool | Description (chars) | Definition (bytes) | Definition (lines) | Status |
+| --- | --- | --- | --- | --- |
+| `echo` | 42 | 326 | 17 | ok |
+| `render_json` | 64 | 443 | 19 | ok |
+| `shape_area` | 84 | 1,769 | 72 | ok |
+| `status` | 26 | 512 | 24 | ok |
+| `workspaces__id_delete` | 43 | 205 | 9 | ok |
+| `workspaces__id_get` | 39 | 198 | 9 | ok |
+| `workspaces__id_patch` | 46 | 430 | 19 | ok |
+| `workspaces__id_put` | 41 | 423 | 19 | ok |
+| `workspaces_get` | 33 | 188 | 9 | ok |
+| `workspaces_post` | 37 | 416 | 19 | ok |
+
 ## Tool arguments
 
 Arguments are a flat JSON object keyed by long option and positional names (hyphenated option names are valid keys).

package/examples/full-example-json/docs/openapi.json

@@ -18,6 +18,10 @@
       "name": "render-json",
       "description": "Echo a JSON message (schema-first JSON leaf demo)."
     },
+    {
+      "name": "shape-area",
+      "description": "Compute the area of a circle or rectangle (union-input JSON leaf demo)."
+    },
     {
       "name": "status",
       "description": "Show app version."
@@ -476,6 +480,157 @@
         }
       }
     },
+    "/shape-area": {
+      "post": {
+        "tags": [
+          "shape-area"
+        ],
+        "operationId": "_shape-area",
+        "summary": "Compute the area of a circle or rectangle (union-input JSON leaf demo).",
+        "responses": {
+          "201": {
+            "description": "Successful invocation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid arguments or help requested",
+            "content": {
+              "application/json; charset=utf-8": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not found",
+            "content": {
+              "application/json; charset=utf-8": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Handler error",
+            "content": {
+              "application/json; charset=utf-8": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Not ready or missing required config",
+            "content": {
+              "application/json; charset=utf-8": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json; charset=utf-8": {
+              "schema": {
+                "$schema": "http://json-schema.org/draft-07/schema#",
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "kind": {
+                        "type": "string",
+                        "const": "circle",
+                        "description": "Shape discriminator."
+                      },
+                      "radius": {
+                        "type": "number",
+                        "description": "Circle radius."
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "radius"
+                    ],
+                    "additionalProperties": false,
+                    "description": "A circle, measured by radius."
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "kind": {
+                        "type": "string",
+                        "const": "rect",
+                        "description": "Shape discriminator."
+                      },
+                      "width": {
+                        "type": "number",
+                        "description": "Rectangle width."
+                      },
+                      "height": {
+                        "type": "number",
+                        "description": "Rectangle height."
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "width",
+                      "height"
+                    ],
+                    "additionalProperties": false,
+                    "description": "A rectangle, measured by width and height."
+                  }
+                ],
+                "description": "Shape to measure: a circle or a rectangle."
+              }
+            }
+          }
+        }
+      }
+    },
     "/status": {
       "post": {
         "tags": [

package/examples/full-example-json/justfile

@@ -4,8 +4,10 @@ set shell := ["bash", "-eu", "-o", "pipefail", "-c"]
 export PATH := justfile_directory() + "/node_modules/.bin:" + env_var("PATH")
 
 brew_prefix := `brew --prefix`
-tap_parent := brew_prefix + "/Library/Taps/{tapOrg}"
-tap_path := tap_parent + "/homebrew-{tapRepo}"
+# Homebrew tap (org/repo); `argsbarg create` rewrites this literal to the new project's tap
+tap := "bdombro/bun-argsbarg"
+tap_parent := brew_prefix + "/Library/Taps/" + replace_regex(tap, "/.*", "")
+tap_path := tap_parent + "/homebrew-" + replace_regex(tap, ".*/", "")
 
 # List available recipes (default)
 _:
@@ -111,7 +113,7 @@ schemagen:
 # Install bun/npm dependencies and generate schemas
 setup:
     bun install
-    test -f node_modules/argsbarg/bin/argsbarg && ln -sf ../argsbarg/bin/argsbarg node_modules/.bin/argsbarg
+    test -f node_modules/argsbarg/bin/argsbarg && ln -sf ../argsbarg/bin/argsbarg node_modules/.bin/argsbarg # argsbarg-dev-only: fix link for file:../.. installs
     just schemagen
 
 # Run unit tests (after check)

package/examples/full-example-json/src/commands/shape-area/__generated__/ShapeAreaInputSchema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "anyOf": [
+    {
+      "$ref": "#/definitions/Circle"
+    },
+    {
+      "$ref": "#/definitions/Rect"
+    }
+  ],
+  "description": "Shape to measure: a circle or a rectangle.",
+  "definitions": {
+    "Circle": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "circle",
+          "description": "Shape discriminator."
+        },
+        "radius": {
+          "type": "number",
+          "description": "Circle radius."
+        }
+      },
+      "required": [
+        "kind",
+        "radius"
+      ],
+      "additionalProperties": false,
+      "description": "A circle, measured by radius."
+    },
+    "Rect": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "rect",
+          "description": "Shape discriminator."
+        },
+        "width": {
+          "type": "number",
+          "description": "Rectangle width."
+        },
+        "height": {
+          "type": "number",
+          "description": "Rectangle height."
+        }
+      },
+      "required": [
+        "kind",
+        "width",
+        "height"
+      ],
+      "additionalProperties": false,
+      "description": "A rectangle, measured by width and height."
+    }
+  }
+}

package/examples/full-example-json/src/commands/shape-area/__generated__/index.ts

@@ -0,0 +1,5 @@
+// Auto-generated by argsbarg schemagen — do not edit by hand.
+
+import ShapeAreaInputSchemaJson from "./ShapeAreaInputSchema.json";
+
+export const ShapeAreaInputSchema = ShapeAreaInputSchemaJson as Record<string, unknown>;

package/examples/full-example-json/src/commands/shape-area/command.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, test } from "bun:test";
+import { Cli, type CliProgram } from "argsbarg";
+import { shapeAreaTestProgram } from "./command.ts";
+
+const baseProgram = {
+  key: "full-example",
+  version: "1.0.0",
+  description: "Demo.",
+  httpServer: { enabled: true },
+  commands: [],
+} satisfies CliProgram;
+
+describe("shape-area command", () => {
+  const cli = new Cli(shapeAreaTestProgram(baseProgram));
+
+  test("computes the area for each union branch", async () => {
+    const rect = await cli.invoke(["shape-area"], {
+      invocation: "http",
+      toolArgs: { kind: "rect", width: 2, height: 3 },
+    });
+    expect(rect.response?.body).toEqual({ area: 6 });
+
+    const circle = await cli.invoke(["shape-area"], { invocation: "http", toolArgs: { kind: "circle", radius: 1 } });
+    expect(circle.response?.body).toEqual({ area: Math.PI });
+  });
+
+  test("rejects fields from the wrong branch via inputSchema", async () => {
+    const result = await cli.invoke(["shape-area"], {
+      invocation: "http",
+      toolArgs: { kind: "circle", radius: 1, width: 2 },
+    });
+    expect(result.kind).toBe("error");
+  });
+});