@beryl-so/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vibe Monitor, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,270 @@
+<!-- GENERATED by `npm run docs` — edit the command registry (src/commands/), not this file. -->
+
+# beryl CLI
+
+Beryl on the command line: create projects, watch the agent explore and author tests,
+trigger runs in CI, manage everything the web app can — plus an MCP server (`beryl mcp`)
+that exposes every command to coding agents.
+
+## Quickstart — one command
+
+```bash
+npx @beryl-so/cli@latest init
+```
+
+Signs you in, pins this repo to a project (creating it if needed — the agent starts
+exploring and authoring tests immediately), and wires the MCP server into Claude Code
+or Cursor. Safe to re-run.
+
+## Install
+
+```bash
+npm install -g @beryl-so/cli   # `beryl` on your PATH
+npx @beryl-so/cli@latest …    # or run one-off without installing
+```
+
+From the monorepo (development): `cd cli && npm install && npm run build && npm link`.
+
+## Authenticate
+
+```bash
+beryl login                  # emailed one-time code; mints + stores a personal access token
+export BERYL_API_KEY=beryl_pat_…   # CI: use a token from Account → API tokens
+```
+
+Defaults can be pinned per repo in a `.beryl.json` (`{"workspace": "…", "project": "…"}`)
+or globally via `beryl workspaces use` / `beryl projects use`.
+Precedence: flags > `BERYL_*` env > `.beryl.json` > `~/.config/beryl/config.json`.
+
+## CI in one line
+
+```bash
+beryl runs trigger --url-override "$PREVIEW_URL" --watch --timeout 30
+```
+
+Exit codes: `0` success / all tests passed · `1` failure · `2` usage error · `3` auth error.
+
+## MCP server
+
+```bash
+claude mcp add beryl -- npx -y @beryl-so/cli mcp    # no install needed
+claude mcp add beryl -- beryl mcp                    # or, with the CLI installed
+```
+
+Every non-interactive command below is exposed as an MCP tool with the same name
+(spaces and dashes become underscores).
+
+## Commands
+
+### init
+
+| Command | Summary |
+| --- | --- |
+| `beryl init` | Set up Beryl in this repo — sign in, pin a project, wire up your coding agent |
+
+### login
+
+| Command | Summary |
+| --- | --- |
+| `beryl login` | Authenticate the CLI with your Beryl account |
+
+### logout
+
+| Command | Summary |
+| --- | --- |
+| `beryl logout` | Remove the stored token from the CLI config |
+
+### whoami
+
+| Command | Summary |
+| --- | --- |
+| `beryl whoami` | Show the signed-in account and the CLI's resolved defaults |
+
+### tokens
+
+| Command | Summary |
+| --- | --- |
+| `beryl tokens list` | List your personal access tokens |
+| `beryl tokens create <name>` | Mint a new personal access token (shown once) |
+| `beryl tokens revoke <token-id>` | Revoke a personal access token |
+
+### workspaces
+
+| Command | Summary |
+| --- | --- |
+| `beryl workspaces list` | List workspaces you belong to |
+| `beryl workspaces get` | Show one workspace |
+| `beryl workspaces create <name>` | Create a workspace |
+| `beryl workspaces update` | Rename a workspace or change its visibility |
+| `beryl workspaces delete` | Delete a workspace and everything in it |
+| `beryl workspaces use <workspace>` | Set the default workspace for future commands |
+| `beryl workspaces history` | Show the workspace's action history (who did what, when) |
+| `beryl workspaces leave` | Leave a workspace you are a member of |
+
+### members
+
+| Command | Summary |
+| --- | --- |
+| `beryl members list` | List workspace members |
+| `beryl members set-role <user-id> <role>` | Change a member's role |
+| `beryl members remove <user-id>` | Remove a member from the workspace |
+
+### invites
+
+| Command | Summary |
+| --- | --- |
+| `beryl invites send <email>` | Invite someone to the workspace by email |
+| `beryl invites list` | List the workspace's outstanding invitations |
+| `beryl invites revoke <invitation-id>` | Revoke a pending invitation |
+| `beryl invites mine` | List invitations sent to you |
+| `beryl invites accept <invitation>` | Accept an invitation (by id, or by the token from the invite email) |
+| `beryl invites decline <invitation-id>` | Decline an invitation |
+
+### projects
+
+| Command | Summary |
+| --- | --- |
+| `beryl projects list` | List projects in the workspace |
+| `beryl projects get` | Show one project, including its current exploration state |
+| `beryl projects create <url>` | Create a project — the agent starts exploring and authoring tests immediately |
+| `beryl projects rename <name>` | Rename a project |
+| `beryl projects delete` | Delete a project and all its tests and runs |
+| `beryl projects re-explore` | Send the agent back in — run/heal existing tests and discover new flows |
+| `beryl projects report` | Aggregate quality report across recent runs (pass rates, flaky tests, trend) |
+| `beryl projects reusable-auth <url>` | Check whether a saved login can be reused for a URL before creating a project |
+| `beryl projects use <project>` | Set the default project for future commands |
+
+### envs
+
+| Command | Summary |
+| --- | --- |
+| `beryl envs list` | List a project's environments |
+| `beryl envs get <env-id>` | Show one environment |
+| `beryl envs create <name> <url>` | Add an environment (e.g. staging) to a project |
+| `beryl envs update <env-id>` | Update an environment's name, URL, or auth settings |
+| `beryl envs delete <env-id>` | Delete an environment |
+
+### schedule
+
+| Command | Summary |
+| --- | --- |
+| `beryl schedule get` | Show the project's daily/weekly run schedule |
+| `beryl schedule set` | Enable scheduled runs (daily, or weekly on a given day) |
+| `beryl schedule disable` | Turn scheduled runs off |
+
+### tests
+
+| Command | Summary |
+| --- | --- |
+| `beryl tests list` | List the project's tests with their latest result |
+| `beryl tests get <test-id>` | Show one test |
+| `beryl tests plan <test-id>` | Print a test's current step plan (JSON) |
+| `beryl tests create` | Create a test case from a JSON action plan — for tests authored locally, e.g. by your coding agent |
+| `beryl tests set-plan <test-id>` | Replace a test's step plan from a JSON file (creates a new version) |
+| `beryl tests recompile <test-id>` | Validate + verify an edited plan against the live site before persisting |
+| `beryl tests versions <test-id>` | List a test's version history |
+| `beryl tests version <test-id> <version-no>` | Show one specific version of a test (including its plan) |
+| `beryl tests diff <test-id> <from> <to>` | Diff two versions of a test's plan |
+| `beryl tests restore <test-id> <version-no>` | Restore a test to an earlier version |
+| `beryl tests reset <test-id>` | Discard user edits and return the test to its latest system-authored version |
+| `beryl tests heal <test-id> <state>` | Turn self-healing on or off for a test |
+| `beryl tests history <test-id>` | Pass/fail history, streak, and stability for a test |
+| `beryl tests script <test-id>` | Print the rendered Playwright spec for a test |
+| `beryl tests export <test-ids...>` | Export tests as Playwright .spec.ts files in a ZIP |
+
+### runs
+
+| Command | Summary |
+| --- | --- |
+| `beryl runs trigger` | Trigger a test run (whole suite, a subset, or one environment) |
+| `beryl runs list` | List recent runs |
+| `beryl runs get <run-id>` | Show one run with its per-test results |
+| `beryl runs watch <run-id>` | Attach to a run and stream progress until it finishes |
+| `beryl runs cancel <run-id>` | Cancel an in-flight run |
+| `beryl runs report <run-id>` | Show the generated report for a run |
+| `beryl runs download <run-id>` | Download a run's full results as JSON |
+| `beryl runs explain <result-id>` | AI explanation of why a test result failed |
+
+### explorations
+
+| Command | Summary |
+| --- | --- |
+| `beryl explorations list` | List the agent's exploration passes for a project |
+| `beryl explorations get <exploration-id>` | Show one exploration: authored tests, abandoned flows, coverage, frontier |
+| `beryl explorations steps <exploration-id>` | List every step the agent took in an exploration |
+| `beryl explorations watch <exploration-id>` | Stream an exploration live — watch the agent explore and author tests |
+
+### config
+
+| Command | Summary |
+| --- | --- |
+| `beryl config vars list` | List the project's config variables (visible to the agent during runs) |
+| `beryl config vars set <key> <value>` | Create or update a config variable |
+| `beryl config vars delete <key>` | Delete a config variable |
+| `beryl config secrets list` | List the project's secrets (values are never returned) |
+| `beryl config secrets set <key> <value>` | Create a secret (write-only; re-setting a key replaces it) |
+| `beryl config secrets delete <key>` | Delete a secret |
+| `beryl config files list` | List files uploaded for the agent to use (e.g. CSVs, upload fixtures) |
+| `beryl config files upload <file>` | Upload a file |
+| `beryl config files download <file-id>` | Get a short-lived download URL for a file |
+| `beryl config files delete <file-id>` | Delete an uploaded file |
+
+### credentials
+
+| Command | Summary |
+| --- | --- |
+| `beryl credentials list` | List the workspace's saved logins |
+| `beryl credentials get <credential-id>` | Show one saved login (status and freshness — never the session itself) |
+| `beryl credentials projects <credential-id>` | List the projects using a saved login |
+| `beryl credentials delete <credential-id>` | Delete a saved login |
+| `beryl credentials attach <credential-id>` | Attach a saved login to a project |
+| `beryl credentials detach` | Detach the project's saved login |
+| `beryl credentials recapture <credential-id>` | Start a re-capture for an expiring saved login (returns a live browser URL) |
+| `beryl credentials capture` | Capture a login for the project interactively: log in once in a real browser |
+
+### auth-capture
+
+| Command | Summary |
+| --- | --- |
+| `beryl auth-capture start` | Start a login-capture browser session for the project (non-interactive) |
+| `beryl auth-capture capture <session-id>` | Capture the session after the user has logged in via the live-view URL |
+| `beryl auth-capture refresh <session-id>` | Capture a refreshed session for a project whose login is expiring |
+| `beryl auth-capture release <session-id>` | Release a login-capture browser session without capturing |
+
+### account
+
+| Command | Summary |
+| --- | --- |
+| `beryl account get` | Show your account profile |
+| `beryl account update` | Update your profile |
+| `beryl account deletion-preview` | Preview what deleting your account would remove or leave |
+
+### feedback
+
+| Command | Summary |
+| --- | --- |
+| `beryl feedback send <message>` | Send product feedback to the Beryl team |
+
+### billing
+
+| Command | Summary |
+| --- | --- |
+| `beryl billing usage` | Show plan usage: services and weekly AI units |
+| `beryl billing subscription` | Show the workspace's subscription |
+| `beryl billing invoices` | List recent invoices |
+| `beryl billing portal` | Get a Stripe billing-portal link for the workspace |
+
+### mcp
+
+| Command | Summary |
+| --- | --- |
+| `beryl mcp` | Run the Beryl MCP server (stdio) — every CLI command as an agent tool |
+
+Run `beryl <command> --help` for flags and examples.
+
+## Global flags
+
+- `--json` — Print machine-readable JSON (NDJSON for streams)
+- `--api-url` — API base URL (default https://api.beryl.so)
+- `--token` — Personal access token (overrides config/BERYL_API_KEY)
+- `--help` — Show help

package/dist/adapters/cli.js

@@ -0,0 +1,270 @@
+import fs from "node:fs";
+import { loadConfig } from "../config.js";
+import { createContext } from "../context.js";
+import { CliError, EXIT_OK, EXIT_USAGE, UsageError } from "../errors.js";
+import { ApiClient } from "../http.js";
+import { autoFormat, bold, cyan, dim } from "../output.js";
+import { commandGroups, findCommand } from "../registry/index.js";
+export const GLOBAL_FLAGS = [
+    { name: "json", description: "Print machine-readable JSON (NDJSON for streams)" },
+    { name: "api-url", description: "API base URL (default https://api.beryl.so)", value: true },
+    { name: "token", description: "Personal access token (overrides config/BERYL_API_KEY)", value: true },
+    { name: "help", description: "Show help", alias: "h" },
+];
+export function cliVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
+        return pkg.version;
+    }
+    catch {
+        return "unknown";
+    }
+}
+export function parseArgv(spec, tokens) {
+    const flags = {};
+    const positional = [];
+    let json = false;
+    let apiUrl;
+    let token;
+    let help = false;
+    let flagsDone = false;
+    const specFlags = spec.flags ?? [];
+    const byName = new Map(specFlags.map((f) => [f.name, f]));
+    for (let i = 0; i < tokens.length; i++) {
+        const tok = tokens[i];
+        if (flagsDone || !tok.startsWith("-") || tok === "-") {
+            positional.push(tok);
+            continue;
+        }
+        if (tok === "--") {
+            flagsDone = true;
+            continue;
+        }
+        if (tok === "-h" || tok === "--help") {
+            help = true;
+            continue;
+        }
+        const eq = tok.indexOf("=");
+        const name = (eq === -1 ? tok : tok.slice(0, eq)).replace(/^--?/, "");
+        const inline = eq === -1 ? undefined : tok.slice(eq + 1);
+        const takeValue = (flagName) => {
+            if (inline !== undefined)
+                return inline;
+            const next = tokens[++i];
+            if (next === undefined)
+                throw new UsageError(`--${flagName} needs a value`);
+            return next;
+        };
+        // A command-declared flag wins over the like-named global (e.g. `login --token`).
+        if (byName.has(name)) {
+            const f = byName.get(name);
+            if (f.type === "boolean") {
+                flags[name] = inline !== undefined ? inline !== "false" : true;
+            }
+            else if (f.type === "strings") {
+                const list = flags[name] ?? [];
+                list.push(takeValue(name));
+                flags[name] = list;
+            }
+            else {
+                const value = takeValue(name);
+                if (f.enum && !f.enum.includes(value)) {
+                    throw new UsageError(`--${name} must be one of: ${f.enum.join(", ")}`);
+                }
+                flags[name] = value;
+            }
+        }
+        else if (name === "json") {
+            json = true;
+        }
+        else if (name === "api-url") {
+            apiUrl = takeValue(name);
+        }
+        else if (name === "token") {
+            token = takeValue(name);
+        }
+        else if (name.startsWith("no-") && byName.get(name.slice(3))?.type === "boolean") {
+            flags[name.slice(3)] = false;
+        }
+        else {
+            throw new UsageError(`Unknown flag --${name} for \`beryl ${spec.name}\``);
+        }
+    }
+    for (const f of specFlags) {
+        if (flags[f.name] === undefined && f.default !== undefined)
+            flags[f.name] = f.default;
+        if (f.required && flags[f.name] === undefined) {
+            throw new UsageError(`--${f.name} is required for \`beryl ${spec.name}\``);
+        }
+    }
+    const args = {};
+    const specArgs = spec.args ?? [];
+    let cursor = 0;
+    for (const a of specArgs) {
+        if (a.variadic) {
+            const rest = positional.slice(cursor);
+            cursor = positional.length;
+            if (a.required && rest.length === 0)
+                throw new UsageError(`Missing <${a.name}>`);
+            args[a.name] = rest;
+        }
+        else {
+            const value = positional[cursor++];
+            if (value === undefined) {
+                if (a.required)
+                    throw new UsageError(`Missing <${a.name}>\n\n${usageLine(spec)}`);
+            }
+            else {
+                args[a.name] = value;
+            }
+        }
+    }
+    if (cursor < positional.length) {
+        throw new UsageError(`Unexpected argument "${positional[cursor]}"\n\n${usageLine(spec)}`);
+    }
+    return { input: { args, flags }, json, apiUrl, token, help };
+}
+export function usageLine(spec) {
+    const args = (spec.args ?? [])
+        .map((a) => {
+        const inner = a.variadic ? `${a.name}...` : a.name;
+        return a.required ? `<${inner}>` : `[${inner}]`;
+    })
+        .join(" ");
+    return `Usage: beryl ${spec.name}${args ? " " + args : ""} [flags]`;
+}
+export function commandHelp(spec) {
+    const lines = [spec.summary, "", usageLine(spec)];
+    if (spec.description)
+        lines.push("", spec.description);
+    if (spec.args?.length) {
+        lines.push("", bold("Arguments:"));
+        for (const a of spec.args)
+            lines.push(`  ${cyan(a.name.padEnd(16))} ${a.description}`);
+    }
+    if (spec.flags?.length) {
+        lines.push("", bold("Flags:"));
+        for (const f of spec.flags) {
+            const label = `--${f.name}${f.type === "boolean" ? "" : ` <${f.placeholder ?? f.type}>`}`;
+            const suffix = f.enum ? ` (${f.enum.join("|")})` : "";
+            lines.push(`  ${cyan(label.padEnd(24))} ${f.description}${suffix}`);
+        }
+    }
+    lines.push("", bold("Global flags:"));
+    for (const g of GLOBAL_FLAGS) {
+        lines.push(`  ${cyan(("--" + g.name).padEnd(24))} ${g.description}`);
+    }
+    if (spec.examples?.length) {
+        lines.push("", bold("Examples:"));
+        for (const e of spec.examples)
+            lines.push(`  ${dim(e)}`);
+    }
+    return lines.join("\n");
+}
+export function rootHelp() {
+    const lines = [
+        `${bold("beryl")} ${dim("v" + cliVersion())} — AI-agent web testing from the command line`,
+        "",
+        "Usage: beryl <command> [args] [flags]",
+        "",
+    ];
+    for (const [group, specs] of commandGroups()) {
+        if (specs.length === 1 && specs[0].name === group) {
+            lines.push(`  ${cyan(group.padEnd(14))} ${specs[0].summary}`);
+        }
+        else {
+            lines.push(`  ${cyan(group.padEnd(14))} ${specs
+                .map((s) => s.name.split(" ").slice(1).join(" "))
+                .join(", ")}`);
+        }
+    }
+    lines.push("", `Run ${cyan("beryl <command> --help")} for details, ${cyan("beryl login")} to get started.`, `Docs: ${cyan("https://beryl.so/docs/cli")}`);
+    return lines.join("\n");
+}
+function groupHelp(group, specs) {
+    const lines = [`${bold("beryl " + group)} — subcommands:`, ""];
+    for (const spec of specs) {
+        lines.push(`  ${cyan(spec.name.padEnd(28))} ${spec.summary}`);
+    }
+    lines.push("", `Run ${cyan(`beryl ${group} <subcommand> --help`)} for details.`);
+    return lines.join("\n");
+}
+export async function runCli(argv) {
+    const words = [];
+    let rest = argv;
+    for (const tok of argv) {
+        if (tok.startsWith("-"))
+            break;
+        words.push(tok);
+    }
+    if (argv.includes("--version") || argv[0] === "version") {
+        process.stdout.write(cliVersion() + "\n");
+        return EXIT_OK;
+    }
+    if (words[0] === "help") {
+        words.shift();
+        rest = [...words, "--help"];
+    }
+    if (words.length === 0) {
+        process.stdout.write(rootHelp() + "\n");
+        return argv.length === 0 || argv.includes("--help") || argv.includes("-h")
+            ? EXIT_OK
+            : EXIT_USAGE;
+    }
+    const found = findCommand(words);
+    if (!found) {
+        const groups = commandGroups();
+        const group = groups.get(words[0]);
+        if (group && words.length === 1) {
+            process.stdout.write(groupHelp(words[0], group) + "\n");
+            return EXIT_OK;
+        }
+        process.stderr.write(`Unknown command: ${words.join(" ")}\n\nRun \`beryl --help\` for the command list.\n`);
+        return EXIT_USAGE;
+    }
+    const { spec } = found;
+    const tokens = rest.slice(found.consumed);
+    let parsed;
+    try {
+        parsed = parseArgv(spec, tokens);
+    }
+    catch (err) {
+        if (err instanceof UsageError) {
+            process.stderr.write(err.message + "\n");
+            return err.exitCode;
+        }
+        throw err;
+    }
+    if (parsed.help) {
+        process.stdout.write(commandHelp(spec) + "\n");
+        return EXIT_OK;
+    }
+    const config = loadConfig();
+    if (parsed.apiUrl)
+        config.apiUrl = parsed.apiUrl;
+    if (parsed.token)
+        config.token = parsed.token;
+    const client = new ApiClient(config.apiUrl, config.token);
+    const ctx = createContext({ client, config, json: parsed.json });
+    try {
+        const result = (await spec.run(ctx, parsed.input)) ?? {};
+        if (parsed.json) {
+            if (result.data !== undefined)
+                process.stdout.write(JSON.stringify(result.data) + "\n");
+        }
+        else if (result.human !== undefined) {
+            process.stdout.write(result.human + "\n");
+        }
+        else if (result.data !== undefined) {
+            process.stdout.write(autoFormat(result.data) + "\n");
+        }
+        return result.exitCode ?? EXIT_OK;
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            process.stderr.write(err.message + "\n");
+            return err.exitCode;
+        }
+        throw err;
+    }
+}

package/dist/adapters/mcp.js

@@ -0,0 +1,106 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { createContext } from "../context.js";
+import { CliError } from "../errors.js";
+import { commands } from "../registry/index.js";
+import { cliVersion } from "./cli.js";
+export function toolName(spec) {
+    return spec.name.replace(/ /g, "_").replace(/-/g, "_");
+}
+export function mcpTools() {
+    return commands.filter((c) => !c.interactive && !c.hidden && c.name !== "mcp");
+}
+export function toolInputSchema(spec) {
+    const properties = {};
+    const required = [];
+    for (const a of spec.args ?? []) {
+        properties[a.name] = a.variadic
+            ? { type: "array", items: { type: "string" }, description: a.description }
+            : { type: "string", description: a.description };
+        if (a.required)
+            required.push(a.name);
+    }
+    for (const f of spec.flags ?? []) {
+        properties[f.name] =
+            f.type === "strings"
+                ? { type: "array", items: { type: "string" }, description: f.description }
+                : { type: f.type, description: f.description, ...(f.enum ? { enum: f.enum } : {}) };
+        if (f.required)
+            required.push(f.name);
+    }
+    return { type: "object", properties, ...(required.length ? { required } : {}) };
+}
+function toInput(spec, params) {
+    const args = {};
+    const flags = {};
+    const argNames = new Set((spec.args ?? []).map((a) => a.name));
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (argNames.has(key)) {
+            args[key] = value;
+        }
+        else {
+            flags[key] = value;
+        }
+    }
+    return { args, flags };
+}
+export async function serveMcp(baseCtx) {
+    const server = new Server({ name: "beryl", version: cliVersion() }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: mcpTools().map((spec) => ({
+            name: toolName(spec),
+            description: spec.description ? `${spec.summary}. ${spec.description}` : spec.summary,
+            inputSchema: toolInputSchema(spec),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const spec = mcpTools().find((c) => toolName(c) === request.params.name);
+        if (!spec) {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${request.params.name}` }],
+                isError: true,
+            };
+        }
+        const lines = [];
+        const push = (text) => {
+            lines.push(text);
+            // Long watches can stream hundreds of events; keep the tool result bounded.
+            if (lines.length > 400)
+                lines.splice(0, lines.length - 400);
+        };
+        const ctx = createContext({
+            client: baseCtx.client,
+            config: baseCtx.config,
+            json: true,
+            interactive: false,
+            out: push,
+            err: push,
+        });
+        try {
+            const result = (await spec.run(ctx, toInput(spec, request.params.arguments ?? {}))) ?? {};
+            const parts = [...lines];
+            if (result.data !== undefined)
+                parts.push(JSON.stringify(result.data, null, 2));
+            else if (result.human)
+                parts.push(result.human);
+            return {
+                content: [{ type: "text", text: parts.join("\n") || "ok" }],
+                isError: result.exitCode !== undefined && result.exitCode !== 0,
+            };
+        }
+        catch (err) {
+            const message = err instanceof CliError ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: [...lines, message].join("\n") }],
+                isError: true,
+            };
+        }
+    });
+    await server.connect(new StdioServerTransport());
+    await new Promise((resolve) => {
+        server.onclose = resolve;
+    });
+}