@kubb/cli 5.0.0-beta.4 → 5.0.0-beta.41

package/README.md

@@ -1,95 +1,253 @@
 <div align="center">
-  <h1>Kubb Cli</h1>
   <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
-    <img width="180" src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo">
+    <img src="https://kubb.dev/og.png" alt="Kubb banner">
   </a>
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![Coverage][coverage-src]][coverage-href]
+[![Stars][stars-src]][stars-href]
 [![License][license-src]][license-href]
-[![Sponsors][sponsors-src]][sponsors-href]
+[![Node][node-src]][node-href]
 
 <h4>
-    <a href="https://codesandbox.io/s/github/kubb-labs/kubb/tree/main//examples/typescript" target="_blank">View Demo</a>
-    <span> · </span>
-      <a href="https://kubb.dev/" target="_blank">Documentation</a>
-    <span> · </span>
-      <a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
-    <span> · </span>
-      <a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Request Feature</a>
-  </h4>
+<a href="https://kubb.dev" target="_blank">Documentation</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Request Feature</a>
+</h4>
 </div>
 
+<br />
+
+# @kubb/cli
+
+### The command-line interface for Kubb
+
+Official CLI for Kubb. Run `kubb generate` to transform OpenAPI/Swagger specs into TypeScript types, API clients, hooks, validators, and mocks. Includes interactive project setup (`kubb init`), spec validation, watch mode, MCP server, and agent server commands.
+
+## Installation
+
+```bash
+bun add -D @kubb/cli
+# or
+pnpm add -D @kubb/cli
+# or
+npm install -D @kubb/cli
+```
+
 ## Commands
 
+- [`kubb init`](#kubb-init) — scaffold a new project
+- [`kubb generate`](#kubb-generate) — run code generation
+- [`kubb validate`](#kubb-validate) — validate an OpenAPI spec
+- [`kubb mcp`](#kubb-mcp) — start the MCP server for AI assistants
+- [`kubb agent start`](#kubb-agent-start) — start the HTTP agent server
+
+---
+
 ### `kubb init`
 
-Initialize a new Kubb project with an interactive setup wizard.
+Scaffold a `kubb.config.ts` and install plugins for code generation from an OpenAPI spec. Run without flags for an interactive setup wizard, or pass flags to skip the prompts.
 
 ```bash
 npx kubb init
 ```
 
-Use the `-y` / `--yes` flag to skip all prompts and accept the defaults:
+#### Options
+
+| Flag               | Short | Type    | Default          | Description                                |
+| ------------------ | ----- | ------- | ---------------- | ------------------------------------------ |
+| `--yes`            | `-y`  | boolean | `false`          | Skip all prompts and use defaults          |
+| `--input <path>`   | `-i`  | string  | `./openapi.yaml` | Path to the OpenAPI specification          |
+| `--output <path>`  | `-o`  | string  | `./src/gen`      | Output directory for generated files       |
+| `--plugins <list>` |       | string  |                  | Comma-separated list of plugins to install |
+
+Available plugin values for `--plugins`: `plugin-ts`, `plugin-client`, `plugin-react-query`, `plugin-vue-query`, `plugin-zod`, `plugin-faker`, `plugin-msw`, `plugin-cypress`, `plugin-mcp`, `plugin-redoc`.
+
+#### Examples
 
 ```bash
-npx kubb init -y
-```
+# Interactive wizard
+npx kubb init
 
-Defaults when using `-y`:
+# Accept all defaults
+npx kubb init --yes
 
-- Input path: `./openapi.yaml`
-- Output path: `./src/gen`
-- Plugins: OpenAPI Parser + TypeScript
+# Fully non-interactive
+npx kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod
+
+# Select specific plugins only
+npx kubb init --plugins plugin-ts,plugin-client,plugin-react-query
+```
 
-This command will:
+The wizard will:
 
-1. Detect or create a `package.json` if it doesn't exist
-2. Prompt you for your OpenAPI specification path (default: `./openapi.yaml`)
-3. Ask for the output directory for generated files (default: `./src/gen`)
-4. Let you select which Kubb plugins to use (default: OpenAPI Parser + TypeScript)
+1. Detect or create a `package.json` if one does not exist
+2. Prompt for your OpenAPI specification path (default: `./openapi.yaml`)
+3. Ask for the output directory (default: `./src/gen`)
+4. Let you choose which plugins to install
 5. Install the selected packages using your package manager (npm, pnpm, yarn, or bun)
-6. Generate a `kubb.config.ts` file with your chosen configuration
+6. Generate a `kubb.config.ts` with your chosen configuration
+
+---
 
 ### `kubb generate`
 
-Generate files based on your `kubb.config.ts` configuration.
+Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads `kubb.config.ts` by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.
 
 ```bash
 npx kubb generate
 ```
 
-Options:
+#### Options
+
+| Flag                 | Short | Type    | Default | Description                                                                                         |
+| -------------------- | ----- | ------- | ------- | --------------------------------------------------------------------------------------------------- |
+| `[input]`            |       | string  |         | OpenAPI file path — overrides `input.path` in the config                                            |
+| `--config <path>`    | `-c`  | string  |         | Path to the Kubb config file                                                                        |
+| `--logLevel <level>` | `-l`  | string  | `info`  | Log level: `silent`, `info`, or `verbose`                                                           |
+| `--watch`            | `-w`  | boolean | `false` | Re-generate whenever the input file changes                                                         |
+| `--verbose`          | `-v`  | boolean | `false` | Override log level to `verbose`                                                                     |
+| `--silent`           | `-s`  | boolean | `false` | Override log level to `silent`                                                                      |
+| `--reporter <names>` |       | string  | `cli`   | Reporters that render the run, comma-separated: `cli`, `json`, `file`. Overrides `config.reporters` |
+
+#### Examples
+
+```bash
+# Use kubb.config.ts in the current directory
+npx kubb generate
+
+# Override the input spec without editing the config
+npx kubb generate ./openapi.yaml
+
+# Point to a custom config file
+npx kubb generate --config ./configs/kubb.config.ts
+
+# Watch for changes and regenerate automatically
+npx kubb generate --watch
 
-- `-c, --config <path>` - Path to the Kubb config file
-- `-l, --logLevel <level>` - Set log level (silent, info, verbose, debug)
-- `-w, --watch` - Watch mode based on the input file
-- `-d, --debug` - Enable debug mode
-- `-v, --verbose` - Enable verbose mode
-- `-s, --silent` - Enable silent mode
+# Verbose output
+npx kubb generate --verbose
+
+# Write a JSON run report alongside the CLI output
+npx kubb generate --reporter cli,json
+```
+
+---
 
 ### `kubb validate`
 
-Validate a Swagger/OpenAPI file.
+Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running `generate` to catch spec issues early.
+
+```bash
+npx kubb validate --input <path-or-url>
+```
+
+#### Options
+
+| Flag             | Short | Type   | Required | Description                                         |
+| ---------------- | ----- | ------ | -------- | --------------------------------------------------- |
+| `--input <path>` | `-i`  | string | ✅       | Path or URL to the OpenAPI/Swagger file to validate |
+
+#### Examples
 
 ```bash
-npx kubb validate <path-to-openapi>
+# Validate a local file
+npx kubb validate --input ./openapi.yaml
+
+# Validate a remote spec
+npx kubb validate --input https://petstore3.swagger.io/api/v3/openapi.json
 ```
 
+---
+
 ### `kubb mcp`
 
-Start the MCP server to enable the MCP client to interact with the LLM.
+Start a Model Context Protocol (MCP) server that exposes Kubb code generation as a tool for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect — the assistant can then call `kubb generate` directly without leaving the chat.
+
+Runs over **stdio** by default (compatible with all MCP clients). Pass `--port` to expose an HTTP server instead.
 
 ```bash
 npx kubb mcp
 ```
 
+#### Options
+
+| Flag                | Short | Type   | Default     | Description                               |
+| ------------------- | ----- | ------ | ----------- | ----------------------------------------- |
+| `--port <number>`   | `-p`  | string |             | Port for HTTP MCP server (omit for stdio) |
+| `--host <hostname>` |       | string | `localhost` | Hostname to bind to (HTTP mode only)      |
+
+#### Examples
+
+```bash
+# stdio mode (recommended for Claude Desktop, Cursor, etc.)
+npx kubb mcp
+
+# HTTP mode
+npx kubb mcp --port 3001
+```
+
+#### MCP client configuration
+
+Add the following to your MCP client config (e.g. Claude Desktop's `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "kubb": {
+      "command": "npx",
+      "args": ["kubb", "mcp"]
+    }
+  }
+}
+```
+
+---
+
+### `kubb agent start`
+
+Start the Kubb Agent HTTP server. Exposes a REST API that accepts a `kubb.config.ts` patch and returns generated code as a stream. Use `--allow-write` to also write files to disk.
+
+```bash
+npx kubb agent start
+```
+
+#### Options
+
+| Flag                | Short | Type    | Default   | Description                                                       |
+| ------------------- | ----- | ------- | --------- | ----------------------------------------------------------------- |
+| `--config <path>`   | `-c`  | string  |           | Path to the Kubb config file                                      |
+| `--port <number>`   | `-p`  | string  | `3000`    | Port the HTTP server listens on                                   |
+| `--host <hostname>` |       | string  | `0.0.0.0` | Hostname the HTTP server binds to                                 |
+| `--allow-write`     |       | boolean | `false`   | Write generated files to disk (otherwise output is streamed only) |
+| `--allow-all`       |       | boolean | `false`   | Grant all permissions (implies `--allow-write`)                   |
+
+#### Examples
+
+```bash
+# Start with defaults
+npx kubb agent start
+
+# Custom port
+npx kubb agent start --port 4000
+
+# Allow writing files to disk
+npx kubb agent start --allow-write
+
+# Full permissions with custom config
+npx kubb agent start --config ./kubb.config.ts --allow-all
+```
+
+See the [`@kubb/agent` README](../agent/README.md) for full environment variable reference, Docker setup, WebSocket API, and Studio integration.
+
 ## Supporting Kubb
 
-Kubb uses an MIT-licensed open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
+Kubb is an open source project, and its development is funded entirely by sponsors. If you would like to become a sponsor, please consider:
 
 - [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
+- [See sponsorship tiers and our sponsors](https://kubb.dev/sponsors)
 
 <p align="center">
   <a href="https://github.com/sponsors/stijnvanhulle">
@@ -97,19 +255,19 @@ Kubb uses an MIT-licensed open source project with its ongoing development made
   </a>
 </p>
 
+## License
+
+[MIT](https://github.com/kubb-labs/kubb/blob/main/licenses/LICENSE-MIT)
+
 <!-- Badges -->
 
-[npm-version-src]: https://img.shields.io/npm/v/@kubb/cli?flat&colorA=18181B&colorB=f58517
-[npm-version-href]: https://npmjs.com/package/@kubb/cli
-[npm-downloads-src]: https://img.shields.io/npm/dm/@kubb/cli?flat&colorA=18181B&colorB=f58517
-[npm-downloads-href]: https://npmjs.com/package/@kubb/cli
-[license-src]: https://img.shields.io/github/license/kubb-labs/kubb.svg?flat&colorA=18181B&colorB=f58517
+[npm-version-src]: https://shieldcn.dev/npm/v/@kubb/cli.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-version-href]: https://npmx.dev/package/@kubb/cli
+[npm-downloads-src]: https://shieldcn.dev/npm/dm/@kubb/cli.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-downloads-href]: https://npmx.dev/package/@kubb/cli
+[stars-src]: https://shieldcn.dev/github/stars/kubb-labs/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[stars-href]: https://github.com/kubb-labs/kubb
+[license-src]: https://shieldcn.dev/npm/license/@kubb/cli.svg?variant=secondary&size=xs&theme=zinc
 [license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
-[build-src]: https://img.shields.io/github/actions/workflow/status/kubb-labs/kubb/ci.yaml?style=flat&colorA=18181B&colorB=f58517
-[build-href]: https://www.npmjs.com/package/@kubb/cli
-[minified-src]: https://img.shields.io/bundlephobia/min/@kubb/cli?style=flat&colorA=18181B&colorB=f58517
-[minified-href]: https://www.npmjs.com/package/@kubb/cli
-[coverage-src]: https://img.shields.io/codecov/c/github/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517
-[coverage-href]: https://www.npmjs.com/package/@kubb/cli
-[sponsors-src]: https://img.shields.io/github/sponsors/stijnvanhulle?style=flat&colorA=18181B&colorB=f58517
-[sponsors-href]: https://github.com/sponsors/stijnvanhulle/
+[node-src]: https://shieldcn.dev/npm/node/@kubb/cli.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[node-href]: https://npmx.dev/package/@kubb/cli

package/dist/agent-D3K_-kiv.js

@@ -0,0 +1,68 @@
+import "./chunk-CRm0XQPb.js";
+import { n as defineCommand } from "./define-DNG1U8ha.js";
+import { t as version } from "./package-BCwMApnr.js";
+import { i as agentDefaults } from "./constants-84a47qA-.js";
+//#endregion
+//#region src/commands/agent.ts
+const command = defineCommand({
+	name: "agent",
+	description: "Manage the Kubb Agent — an HTTP server that lets AI agents trigger code generation programmatically via a REST API. Useful when an AI workflow needs to generate code without direct CLI access.",
+	examples: [
+		"kubb agent start",
+		"kubb agent start --port 4000 --allow-write",
+		"kubb agent start --config ./kubb.config.ts --allow-all"
+	],
+	subCommands: [defineCommand({
+		name: "start",
+		description: "Start the Kubb Agent HTTP server. Exposes a REST API that accepts a kubb.config.ts patch and returns generated code as a stream. Use --allow-write to also write files to disk.",
+		examples: [
+			"kubb agent start",
+			"kubb agent start --port 4000",
+			"kubb agent start --allow-write",
+			"kubb agent start --config ./kubb.config.ts --allow-all"
+		],
+		options: {
+			config: {
+				type: "string",
+				description: "Path to the Kubb config file",
+				short: "c"
+			},
+			port: {
+				type: "string",
+				description: "Port the HTTP server listens on",
+				short: "p",
+				default: agentDefaults.port
+			},
+			host: {
+				type: "string",
+				description: "Hostname the HTTP server binds to",
+				default: agentDefaults.host
+			},
+			"allow-write": {
+				type: "boolean",
+				description: "Write generated files to the filesystem. When omitted, output is streamed only and no files are written.",
+				default: false
+			},
+			"allow-all": {
+				type: "boolean",
+				description: "Grant all permissions (implies --allow-write).",
+				default: false
+			}
+		},
+		async run({ values }) {
+			const { run } = await import("./run-BQ3Qj0xB.js");
+			await run({
+				port: values.port !== void 0 ? values.port : void 0,
+				host: values.host,
+				configPath: values.config,
+				allowWrite: values["allow-write"],
+				allowAll: values["allow-all"],
+				version
+			});
+		}
+	})]
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=agent-D3K_-kiv.js.map

package/dist/agent-D3K_-kiv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-D3K_-kiv.js","names":["command","startCommand"],"sources":["../src/commands/agent/start.ts","../src/commands/agent.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../../package.json'\nimport { agentDefaults } from '../../constants.ts'\n\nexport const command = defineCommand({\n  name: 'start',\n  description:\n    'Start the Kubb Agent HTTP server. Exposes a REST API that accepts a kubb.config.ts patch and returns generated code as a stream. Use --allow-write to also write files to disk.',\n  examples: ['kubb agent start', 'kubb agent start --port 4000', 'kubb agent start --allow-write', 'kubb agent start --config ./kubb.config.ts --allow-all'],\n  options: {\n    config: {\n      type: 'string',\n      description: 'Path to the Kubb config file',\n      short: 'c',\n    },\n    port: {\n      type: 'string',\n      description: 'Port the HTTP server listens on',\n      short: 'p',\n      default: agentDefaults.port,\n    },\n    host: {\n      type: 'string',\n      description: 'Hostname the HTTP server binds to',\n      default: agentDefaults.host,\n    },\n    'allow-write': {\n      type: 'boolean',\n      description: 'Write generated files to the filesystem. When omitted, output is streamed only and no files are written.',\n      default: false,\n    },\n    'allow-all': {\n      type: 'boolean',\n      description: 'Grant all permissions (implies --allow-write).',\n      default: false,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../../runners/agent/run.ts')\n\n    await run({\n      port: values.port !== undefined ? values.port : undefined,\n      host: values.host,\n      configPath: values.config,\n      allowWrite: values['allow-write'],\n      allowAll: values['allow-all'],\n      version,\n    })\n  },\n})\n","import { defineCommand } from '@internals/utils'\nimport { command as startCommand } from './agent/start.ts'\n\nexport const command = defineCommand({\n  name: 'agent',\n  description:\n    'Manage the Kubb Agent — an HTTP server that lets AI agents trigger code generation programmatically via a REST API. Useful when an AI workflow needs to generate code without direct CLI access.',\n  examples: ['kubb agent start', 'kubb agent start --port 4000 --allow-write', 'kubb agent start --config ./kubb.config.ts --allow-all'],\n  subCommands: [startCommand],\n})\n"],"mappings":";;;;;;ACGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EAAC;EAAoB;EAA8C;CAAwD;CACrI,aAAa,CDJQ,cAAc;EACnC,MAAM;EACN,aACE;EACF,UAAU;GAAC;GAAoB;GAAgC;GAAkC;EAAwD;EACzJ,SAAS;GACP,QAAQ;IACN,MAAM;IACN,aAAa;IACb,OAAO;GACT;GACA,MAAM;IACJ,MAAM;IACN,aAAa;IACb,OAAO;IACP,SAAS,cAAc;GACzB;GACA,MAAM;IACJ,MAAM;IACN,aAAa;IACb,SAAS,cAAc;GACzB;GACA,eAAe;IACb,MAAM;IACN,aAAa;IACb,SAAS;GACX;GACA,aAAa;IACX,MAAM;IACN,aAAa;IACb,SAAS;GACX;EACF;EACA,MAAM,IAAI,EAAE,UAAU;GACpB,MAAM,EAAE,QAAQ,MAAM,OAAO;GAE7B,MAAM,IAAI;IACR,MAAM,OAAO,SAAS,KAAA,IAAY,OAAO,OAAO,KAAA;IAChD,MAAM,OAAO;IACb,YAAY,OAAO;IACnB,YAAY,OAAO;IACnB,UAAU,OAAO;IACjB;GACF,CAAC;EACH;CACF,CCzCgBC,CAAY;AAC5B,CAAC"}

package/dist/agent-DTqKBULa.cjs

@@ -0,0 +1,70 @@
+require("./chunk-Bx3C2hgW.cjs");
+const require_define = require("./define-C4AB3POr.cjs");
+const require_package = require("./package-DPe5CA4S.cjs");
+const require_constants = require("./constants-BtmponZ3.cjs");
+//#region src/commands/agent/start.ts
+const command$1 = require_define.defineCommand({
+	name: "start",
+	description: "Start the Kubb Agent HTTP server. Exposes a REST API that accepts a kubb.config.ts patch and returns generated code as a stream. Use --allow-write to also write files to disk.",
+	examples: [
+		"kubb agent start",
+		"kubb agent start --port 4000",
+		"kubb agent start --allow-write",
+		"kubb agent start --config ./kubb.config.ts --allow-all"
+	],
+	options: {
+		config: {
+			type: "string",
+			description: "Path to the Kubb config file",
+			short: "c"
+		},
+		port: {
+			type: "string",
+			description: "Port the HTTP server listens on",
+			short: "p",
+			default: require_constants.agentDefaults.port
+		},
+		host: {
+			type: "string",
+			description: "Hostname the HTTP server binds to",
+			default: require_constants.agentDefaults.host
+		},
+		"allow-write": {
+			type: "boolean",
+			description: "Write generated files to the filesystem. When omitted, output is streamed only and no files are written.",
+			default: false
+		},
+		"allow-all": {
+			type: "boolean",
+			description: "Grant all permissions (implies --allow-write).",
+			default: false
+		}
+	},
+	async run({ values }) {
+		const { run } = await Promise.resolve().then(() => require("./run-D-s2LdlW.cjs"));
+		await run({
+			port: values.port !== void 0 ? values.port : void 0,
+			host: values.host,
+			configPath: values.config,
+			allowWrite: values["allow-write"],
+			allowAll: values["allow-all"],
+			version: require_package.version
+		});
+	}
+});
+//#endregion
+//#region src/commands/agent.ts
+const command = require_define.defineCommand({
+	name: "agent",
+	description: "Manage the Kubb Agent — an HTTP server that lets AI agents trigger code generation programmatically via a REST API. Useful when an AI workflow needs to generate code without direct CLI access.",
+	examples: [
+		"kubb agent start",
+		"kubb agent start --port 4000 --allow-write",
+		"kubb agent start --config ./kubb.config.ts --allow-all"
+	],
+	subCommands: [command$1]
+});
+//#endregion
+exports.command = command;
+
+//# sourceMappingURL=agent-DTqKBULa.cjs.map

package/dist/agent-DTqKBULa.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-DTqKBULa.cjs","names":["command","defineCommand","agentDefaults","defineCommand","startCommand"],"sources":["../src/commands/agent/start.ts","../src/commands/agent.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../../package.json'\nimport { agentDefaults } from '../../constants.ts'\n\nexport const command = defineCommand({\n  name: 'start',\n  description:\n    'Start the Kubb Agent HTTP server. Exposes a REST API that accepts a kubb.config.ts patch and returns generated code as a stream. Use --allow-write to also write files to disk.',\n  examples: ['kubb agent start', 'kubb agent start --port 4000', 'kubb agent start --allow-write', 'kubb agent start --config ./kubb.config.ts --allow-all'],\n  options: {\n    config: {\n      type: 'string',\n      description: 'Path to the Kubb config file',\n      short: 'c',\n    },\n    port: {\n      type: 'string',\n      description: 'Port the HTTP server listens on',\n      short: 'p',\n      default: agentDefaults.port,\n    },\n    host: {\n      type: 'string',\n      description: 'Hostname the HTTP server binds to',\n      default: agentDefaults.host,\n    },\n    'allow-write': {\n      type: 'boolean',\n      description: 'Write generated files to the filesystem. When omitted, output is streamed only and no files are written.',\n      default: false,\n    },\n    'allow-all': {\n      type: 'boolean',\n      description: 'Grant all permissions (implies --allow-write).',\n      default: false,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../../runners/agent/run.ts')\n\n    await run({\n      port: values.port !== undefined ? values.port : undefined,\n      host: values.host,\n      configPath: values.config,\n      allowWrite: values['allow-write'],\n      allowAll: values['allow-all'],\n      version,\n    })\n  },\n})\n","import { defineCommand } from '@internals/utils'\nimport { command as startCommand } from './agent/start.ts'\n\nexport const command = defineCommand({\n  name: 'agent',\n  description:\n    'Manage the Kubb Agent — an HTTP server that lets AI agents trigger code generation programmatically via a REST API. Useful when an AI workflow needs to generate code without direct CLI access.',\n  examples: ['kubb agent start', 'kubb agent start --port 4000 --allow-write', 'kubb agent start --config ./kubb.config.ts --allow-all'],\n  subCommands: [startCommand],\n})\n"],"mappings":";;;;;AAIA,MAAaA,YAAUC,eAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EAAC;EAAoB;EAAgC;EAAkC;CAAwD;CACzJ,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;EACT;EACA,MAAM;GACJ,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAASC,kBAAAA,cAAc;EACzB;EACA,MAAM;GACJ,MAAM;GACN,aAAa;GACb,SAASA,kBAAAA,cAAc;EACzB;EACA,eAAe;GACb,MAAM;GACN,aAAa;GACb,SAAS;EACX;EACA,aAAa;GACX,MAAM;GACN,aAAa;GACb,SAAS;EACX;CACF;CACA,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAA,QAAA,QAAA,EAAA,WAAA,QAAM,oBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,MAAM,OAAO,SAAS,KAAA,IAAY,OAAO,OAAO,KAAA;GAChD,MAAM,OAAO;GACb,YAAY,OAAO;GACnB,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,SAAA,gBAAA;EACF,CAAC;CACH;AACF,CAAC;;;AC9CD,MAAa,UAAUC,eAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EAAC;EAAoB;EAA8C;CAAwD;CACrI,aAAa,CAACC,SAAY;AAC5B,CAAC"}

package/dist/{chunk--u3MIqq1.js → chunk-CRm0XQPb.js}

@@ -1,3 +1,4 @@
+import "node:module";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", {

package/dist/constants-84a47qA-.js

@@ -0,0 +1,35 @@
+import { t as KUBB_CONFIG_FILENAME } from "./constants-C94RKp3A.js";
+//#region src/constants.ts
+/**
+* NPM registry endpoint used to check for @kubb/cli updates.
+*/
+const KUBB_NPM_PACKAGE_URL = "https://registry.npmjs.org/@kubb/cli/latest";
+"─".repeat(27);
+/**
+* Glob pattern for paths the file watcher ignores.
+*/
+const WATCHER_IGNORED_PATHS = "**/{.git,node_modules}/**";
+/**
+* Flags that short-circuit execution (help/version), no telemetry notice is shown.
+*/
+const QUIET_FLAGS = new Set([
+	"--help",
+	"-h",
+	"--version",
+	"-v"
+]);
+const agentDefaults = {
+	port: "3000",
+	host: "localhost",
+	configFile: KUBB_CONFIG_FILENAME,
+	retryTimeout: "30000",
+	studioUrl: "https://kubb.studio",
+	/**
+	* Relative path from the @kubb/agent package root to the server entry.
+	*/
+	serverEntryPath: ".output/server/index.mjs"
+};
+//#endregion
+export { agentDefaults as i, QUIET_FLAGS as n, WATCHER_IGNORED_PATHS as r, KUBB_NPM_PACKAGE_URL as t };
+
+//# sourceMappingURL=constants-84a47qA-.js.map

package/dist/constants-84a47qA-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-84a47qA-.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { KUBB_CONFIG_FILENAME } from '@internals/shared'\n\n/**\n * NPM registry endpoint used to check for @kubb/cli updates.\n */\nexport const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const\n\n/**\n * Horizontal rule rendered above/below the plain-logger generation summary.\n */\nexport const SUMMARY_SEPARATOR = '─'.repeat(27)\n\n/**\n * Glob pattern for paths the file watcher ignores.\n */\nexport const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/**\n * Flags that short-circuit execution (help/version), no telemetry notice is shown.\n */\nexport const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)\n\nexport const agentDefaults = {\n  port: '3000',\n  host: 'localhost',\n  configFile: KUBB_CONFIG_FILENAME,\n  retryTimeout: '30000',\n  studioUrl: 'https://kubb.studio',\n  /**\n   * Relative path from the @kubb/agent package root to the server entry.\n   */\n  serverEntryPath: '.output/server/index.mjs',\n} as const\n"],"mappings":";;;;;AAKA,MAAa,uBAAuB;AAKH,IAAI,OAAO,EAAE;;;;AAK9C,MAAa,wBAAwB;;;;AAKrC,MAAa,cAAc,IAAI,IAAI;CAAC;CAAU;CAAM;CAAa;AAAI,CAAU;AAE/E,MAAa,gBAAgB;CAC3B,MAAM;CACN,MAAM;CACN,YAAY;CACZ,cAAc;CACd,WAAW;;;;CAIX,iBAAiB;AACnB"}

package/dist/constants-AHhyFH15.cjs

@@ -0,0 +1,139 @@
+//#region ../../internals/shared/src/constants.ts
+const KUBB_CONFIG_FILENAME = "kubb.config.ts";
+const initDefaults = {
+	inputPath: "./openapi.yaml",
+	outputPath: "./src/gen",
+	plugins: ["plugin-ts"]
+};
+const availablePlugins = [
+	{
+		value: "plugin-ts",
+		label: "TypeScript",
+		hint: "Recommended",
+		packageName: "@kubb/plugin-ts",
+		importName: "pluginTs",
+		category: "types"
+	},
+	{
+		value: "plugin-client",
+		label: "Client (Fetch/Axios)",
+		packageName: "@kubb/plugin-client",
+		importName: "pluginClient",
+		category: "client"
+	},
+	{
+		value: "plugin-react-query",
+		label: "React Query / TanStack Query",
+		packageName: "@kubb/plugin-react-query",
+		importName: "pluginReactQuery",
+		category: "framework"
+	},
+	{
+		value: "plugin-vue-query",
+		label: "Vue Query",
+		packageName: "@kubb/plugin-vue-query",
+		importName: "pluginVueQuery",
+		category: "framework"
+	},
+	{
+		value: "plugin-zod",
+		label: "Zod Schemas",
+		packageName: "@kubb/plugin-zod",
+		importName: "pluginZod",
+		category: "validation"
+	},
+	{
+		value: "plugin-faker",
+		label: "Faker.js Mocks",
+		packageName: "@kubb/plugin-faker",
+		importName: "pluginFaker",
+		category: "mocks"
+	},
+	{
+		value: "plugin-msw",
+		label: "MSW Handlers",
+		packageName: "@kubb/plugin-msw",
+		importName: "pluginMsw",
+		category: "mocks"
+	},
+	{
+		value: "plugin-cypress",
+		label: "Cypress Tests",
+		packageName: "@kubb/plugin-cypress",
+		importName: "pluginCypress",
+		category: "testing"
+	},
+	{
+		value: "plugin-mcp",
+		label: "MCP Server (AI / Model Context Protocol)",
+		packageName: "@kubb/plugin-mcp",
+		importName: "pluginMcp",
+		category: "ai"
+	},
+	{
+		value: "plugin-redoc",
+		label: "ReDoc Documentation",
+		packageName: "@kubb/plugin-redoc",
+		importName: "pluginRedoc",
+		category: "documentation"
+	}
+];
+const pluginDefaultConfigs = {
+	"plugin-ts": `pluginTs({
+      output: { path: 'models' },
+    })`,
+	"plugin-client": `pluginClient({
+      output: { path: 'clients' },
+    })`,
+	"plugin-react-query": `pluginReactQuery({
+      output: { path: 'hooks' },
+    })`,
+	"plugin-vue-query": `pluginVueQuery({
+      output: { path: 'hooks' },
+    })`,
+	"plugin-zod": `pluginZod({
+      output: { path: 'zod' },
+    })`,
+	"plugin-faker": `pluginFaker({
+      output: { path: 'mocks' },
+    })`,
+	"plugin-msw": `pluginMsw({
+      output: { path: 'msw' },
+    })`,
+	"plugin-cypress": `pluginCypress({
+      output: { path: 'cypress' },
+    })`,
+	"plugin-mcp": `pluginMcp({
+      output: { path: 'mcp' },
+    })`,
+	"plugin-redoc": `pluginRedoc({
+      output: { path: 'redoc' },
+    })`
+};
+//#endregion
+Object.defineProperty(exports, "KUBB_CONFIG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return KUBB_CONFIG_FILENAME;
+	}
+});
+Object.defineProperty(exports, "availablePlugins", {
+	enumerable: true,
+	get: function() {
+		return availablePlugins;
+	}
+});
+Object.defineProperty(exports, "initDefaults", {
+	enumerable: true,
+	get: function() {
+		return initDefaults;
+	}
+});
+Object.defineProperty(exports, "pluginDefaultConfigs", {
+	enumerable: true,
+	get: function() {
+		return pluginDefaultConfigs;
+	}
+});
+
+//# sourceMappingURL=constants-AHhyFH15.cjs.map