@kubb/mcp 5.0.0-beta.36 → 5.0.0-beta.37

package/README.md

@@ -116,7 +116,7 @@ Generate code from OpenAPI/Swagger specifications using Kubb configuration.
 - `config` (string, optional): Path to kubb.config.ts file. If not provided, looks for kubb.config.ts in current directory
 - `input` (string, optional): Path to OpenAPI/Swagger spec file (overrides config file setting)
 - `output` (string, optional): Output directory path (overrides config file setting)
-- `logLevel` (enum, optional): Control logging verbosity - `'silent'`, `'error'`, `'warn'`, `'info'`, `'verbose'`, `'debug'` (default: 'info')
+- `logLevel` (enum, optional): Control logging verbosity, one of `'silent'`, `'info'`, `'verbose'` (default: 'info')
 
 **Examples:**
 

package/dist/index.cjs

@@ -42,7 +42,7 @@ let jiti = require("jiti");
 let node_process = require("node:process");
 node_process = __toESM(node_process, 1);
 //#region package.json
-var version = "5.0.0-beta.36";
+var version = "5.0.0-beta.37";
 //#endregion
 //#region ../../internals/utils/src/errors.ts
 /**
@@ -158,6 +158,24 @@ var AsyncEventEmitter = class {
 		return this.#emitter.listenerCount(eventName);
 	}
 	/**
+	* Raises or lowers the per-event listener ceiling before Node warns about a memory leak.
+	* Set this above the expected listener count when many listeners attach by design.
+	*
+	* @example
+	* ```ts
+	* emitter.setMaxListeners(40)
+	* ```
+	*/
+	setMaxListeners(max) {
+		this.#emitter.setMaxListeners(max);
+	}
+	/**
+	* Returns the current per-event listener ceiling.
+	*/
+	getMaxListeners() {
+		return this.#emitter.getMaxListeners();
+	}
+	/**
 	* Removes all listeners from every event channel.
 	*
 	* @example
@@ -190,20 +208,37 @@ const generateSchema = valibot.object({
 	output: valibot.optional(valibot.pipe(valibot.string(), valibot.minLength(1), valibot.description("Output directory path (overrides config)"))),
 	logLevel: valibot.optional(valibot.pipe(valibot.picklist([
 		"silent",
-		"error",
-		"warn",
 		"info",
-		"verbose",
-		"debug"
+		"verbose"
 	]), valibot.description("Log level for build output")), "info")
 });
 //#endregion
+//#region src/utils/formatDiagnostics.ts
+/**
+* Renders serialized diagnostics as a plain-text block for an AI assistant. Each entry
+* keeps the stable `code`, the source pointer, the suggested fix, and the docs link, so
+* the agent can act on the problem rather than parsing a bare message. No ANSI styling,
+* unlike the CLI renderer.
+*/
+function formatDiagnostics(diagnostics) {
+	return diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)).join("\n\n");
+}
+function formatDiagnostic(diagnostic) {
+	const { code, severity, message, location, help, plugin, docsUrl } = diagnostic;
+	const lines = [`${severity} ${plugin ? `${plugin}(${code})` : code}: ${message}`];
+	if (location && "pointer" in location) lines.push(`  at ${location.pointer}`);
+	if (help) lines.push(`  help: ${help}`);
+	if (docsUrl) lines.push(`  docs: ${docsUrl}`);
+	return lines.join("\n");
+}
+//#endregion
 //#region src/types.ts
 const NotifyTypes = {
 	INFO: "INFO",
 	SUCCESS: "SUCCESS",
 	ERROR: "ERROR",
 	WARN: "WARN",
+	DIAGNOSTIC: "DIAGNOSTIC",
 	PLUGIN_START: "PLUGIN_START",
 	PLUGIN_END: "PLUGIN_END",
 	FILES_START: "FILES_START",
@@ -341,8 +376,8 @@ const generateTool = (0, tmcp_tool.defineTool)({
 	try {
 		const hooks = new AsyncEventEmitter();
 		const messages = [];
-		const notify = async (type, message, _data) => {
-			messages.push(`${type}: ${message}`);
+		const notify = async (type, message, data) => {
+			messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`);
 		};
 		hooks.on("kubb:info", async ({ message }) => {
 			await notify(NotifyTypes.INFO, message);
@@ -356,6 +391,9 @@ const generateTool = (0, tmcp_tool.defineTool)({
 		hooks.on("kubb:warn", async ({ message }) => {
 			await notify(NotifyTypes.WARN, message);
 		});
+		hooks.on("kubb:diagnostic", async ({ diagnostic }) => {
+			await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, _kubb_core.Diagnostics.serialize(diagnostic));
+		});
 		hooks.on("kubb:plugin:start", async ({ plugin }) => {
 			await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`);
 		});
@@ -412,18 +450,20 @@ const generateTool = (0, tmcp_tool.defineTool)({
 		await kubb.setup();
 		await notify(NotifyTypes.SETUP_END, "Kubb setup complete");
 		await notify(NotifyTypes.BUILD_START, "Starting build");
-		const { files, failedPlugins, error } = await kubb.safeBuild();
+		const { files, diagnostics } = await kubb.safeBuild();
 		await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`);
-		if (error || failedPlugins.size > 0) {
-			const allErrors = [error, ...Array.from(failedPlugins).filter((it) => it.error).map((it) => it.error)].filter(Boolean);
-			await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`);
-			return tmcp_utils.tool.error(`Build failed:\n${allErrors.map((err) => err.message).join("\n")}\n\n${messages.join("\n")}`);
+		const problems = diagnostics.filter(_kubb_core.isProblemDiagnostic);
+		const errors = problems.filter((diagnostic) => diagnostic.severity === "error");
+		if (errors.length > 0) {
+			await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${errors.length} diagnostic(s)`);
+			const serialized = problems.map((diagnostic) => _kubb_core.Diagnostics.serialize(diagnostic));
+			return tmcp_utils.tool.error(`Build failed:\n${formatDiagnostics(serialized)}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``);
 		}
 		await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`);
 		return tmcp_utils.tool.text(`Build completed successfully!\n\nGenerated ${files.length} files\n\n${messages.join("\n")}`);
 	} catch (caughtError) {
-		const error = toError(caughtError);
-		return tmcp_utils.tool.error(`Build error: ${error.message}\n${error.stack ?? ""}`);
+		const serialized = _kubb_core.Diagnostics.serialize(_kubb_core.Diagnostics.from(caughtError));
+		return tmcp_utils.tool.error(`Build error:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``);
 	}
 });
 //#endregion
@@ -608,7 +648,8 @@ const validateTool = (0, tmcp_tool.defineTool)({
 		await mod.adapterOas().validate(input, { throwOnError: true });
 		return tmcp_utils.tool.text(`Validation successful: ${input}`);
 	} catch (err) {
-		return tmcp_utils.tool.error(`Validation failed:\n${err instanceof Error ? err.message : String(err)}`);
+		const serialized = _kubb_core.Diagnostics.serialize(_kubb_core.Diagnostics.from(err));
+		return tmcp_utils.tool.error(`Validation failed:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``);
 	}
 });
 //#endregion

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["#emitter","NodeEventEmitter","#emitAll","v","jiti","path","path","tool","v","path","process","fs","tool","v","tool","McpServer","ValibotJsonSchemaAdapter","StdioTransport","HttpTransport","http"],"sources":["../package.json","../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/promise.ts","../src/schemas/generateSchema.ts","../src/types.ts","../src/constants.ts","../src/utils/loadUserConfig.ts","../src/utils/resolveCwd.ts","../src/utils/resolveUserConfig.ts","../src/tools/generate.ts","../../../internals/shared/src/constants.ts","../../../internals/shared/src/init.ts","../src/schemas/initSchema.ts","../src/tools/init.ts","../src/schemas/validateSchema.ts","../src/tools/validate.ts","../src/server.ts","../src/index.ts"],"sourcesContent":["","/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n  /**\n   * Maximum number of listeners per event before Node emits a memory-leak warning.\n   * @default 10\n   */\n  constructor(maxListener = 10) {\n    this.#emitter.setMaxListeners(maxListener)\n  }\n\n  #emitter = new NodeEventEmitter()\n\n  /**\n   * Emits `eventName` and awaits all registered listeners sequentially.\n   * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n   *\n   * @example\n   * ```ts\n   * await emitter.emit('build', 'petstore')\n   * ```\n   */\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> | void {\n    const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n    if (listeners.length === 0) {\n      return\n    }\n\n    return this.#emitAll(eventName, listeners, eventArgs)\n  }\n\n  async #emitAll<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listeners: Array<AsyncListener<TEvents[TEventName]>>,\n    eventArgs: TEvents[TEventName],\n  ): Promise<void> {\n    for (const listener of listeners) {\n      try {\n        await listener(...eventArgs)\n      } catch (err) {\n        let serializedArgs: string\n        try {\n          serializedArgs = JSON.stringify(eventArgs)\n        } catch {\n          serializedArgs = String(eventArgs)\n        }\n        throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n      }\n    }\n  }\n\n  /**\n   * Registers a persistent listener for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', async (name) => { console.log(name) })\n   * ```\n   */\n  on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Registers a one-shot listener that removes itself after the first invocation.\n   *\n   * @example\n   * ```ts\n   * emitter.onOnce('build', async (name) => { console.log(name) })\n   * ```\n   */\n  onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n      this.off(eventName, wrapper)\n      return handler(...args)\n    }\n    this.on(eventName, wrapper)\n  }\n\n  /**\n   * Removes a previously registered listener.\n   *\n   * @example\n   * ```ts\n   * emitter.off('build', handler)\n   * ```\n   */\n  off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Returns the number of listeners registered for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', handler)\n   * emitter.listenerCount('build') // 1\n   * ```\n   */\n  listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n    return this.#emitter.listenerCount(eventName)\n  }\n\n  /**\n   * Removes all listeners from every event channel.\n   *\n   * @example\n   * ```ts\n   * emitter.removeAll()\n   * ```\n   */\n  removeAll(): void {\n    this.#emitter.removeAllListeners()\n  }\n}\n","function* chunks<T>(arr: readonly T[], size: number): Generator<T[]> {\n  for (let i = 0; i < arr.length; i += size) {\n    yield arr.slice(i, i + size)\n  }\n}\n\nexport type ForBatchesOptions = {\n  /**\n   * Maximum batch size handed to `process`.\n   * Parallel dispatch within a batch is the caller's responsibility\n   * (typically via `Promise.all(batch.map(...))`).\n   */\n  concurrency: number\n  /**\n   * Called after every batch.\n   *\n   * Use a cheap, idempotent callback (e.g. one that short-circuits when there\n   * is nothing new to do). The helper does not coalesce calls — if you need\n   * throttling, do it inside `flush` itself.\n   */\n  flush?: () => Promise<void>\n}\n\n/**\n * Slices `source` into batches of `concurrency` items and awaits `process` for each batch.\n * Accepts both plain arrays (sync) and `AsyncIterable` (streaming).\n *\n * `process` controls whether items inside a batch run in parallel; this helper only\n * controls batch size and per-batch flushing.\n *\n * @example\n * ```ts\n * // parallel dispatch inside each batch\n * await forBatches(schemas, (batch) => Promise.all(batch.map(process)), { concurrency: 8 })\n *\n * // async iterable with a flush after every batch\n * await forBatches(stream.schemas, (batch) => dispatch(batch), { concurrency: 8, flush })\n * ```\n */\nexport async function forBatches<T>(\n  source: readonly T[] | AsyncIterable<T>,\n  process: (batch: T[]) => Promise<unknown>,\n  options: ForBatchesOptions,\n): Promise<void> {\n  const { concurrency, flush } = options\n\n  if (Array.isArray(source)) {\n    for (const batch of chunks(source, concurrency)) {\n      await process(batch)\n      if (flush) await flush()\n    }\n    return\n  }\n\n  const batch: T[] = []\n  for await (const item of source) {\n    batch.push(item)\n    if (batch.length >= concurrency) {\n      await process(batch.splice(0))\n\n      if (flush) await flush()\n    }\n  }\n  if (batch.length > 0) {\n    await process(batch.splice(0))\n\n    if (flush) await flush()\n  }\n}\n\n/**\n * Runs `work`, passing `flush` as its periodic-flush callback, then calls\n * `flush` once more to drain any items that did not cross a flush boundary.\n *\n * @example\n * ```ts\n * await withDrain(\n *   (flush) => processItems(items, { flush }),\n *   () => writeRemainingFiles(),\n * )\n * ```\n */\nexport async function withDrain(work: (flush: () => Promise<void>) => Promise<void>, flush: () => Promise<void>): Promise<void> {\n  await work(flush)\n  await flush()\n}\n\n/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n\n/**\n * Returns a wrapper that caches the result of the first invocation and replays\n * it for every subsequent call, ignoring later arguments.\n *\n * Works for sync and async factories — for async, the cached value is the\n * promise itself, so concurrent callers share one in-flight execution and\n * cannot race each other.\n *\n * @example\n * ```ts\n * const loadDocument = once(async (path: string) => parse(await readFile(path)))\n * const a = loadDocument('./a.yaml') // parses\n * const b = loadDocument('./b.yaml') // returns the cached promise from the first call\n * ```\n */\nexport function once<TArgs extends unknown[], TReturn>(factory: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn {\n  let cache: { value: TReturn } | undefined\n  return (...args: TArgs): TReturn => {\n    if (!cache) cache = { value: factory(...args) }\n    return cache.value\n  }\n}\n\ntype Store<TKey, TValue> = {\n  has(key: TKey): boolean\n  get(key: TKey): TValue | undefined\n  set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n  return (key: TKey): TValue => {\n    if (store.has(key)) return store.get(key)!\n    const value = factory(key)\n    store.set(key, value)\n    return value\n  }\n}\n\n/**\n * Wraps a plain array in a reusable `AsyncIterable`.\n * Each `[Symbol.asyncIterator]()` call returns a fresh generator so the\n * iterable can be consumed multiple times (e.g. once per plugin pre-scan).\n *\n * @example\n * ```ts\n * const stream = arrayToAsyncIterable([1, 2, 3])\n * for await (const n of stream) console.log(n) // 1, 2, 3\n * ```\n */\nexport function arrayToAsyncIterable<T>(arr: readonly T[]): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator]() {\n      return (async function* () {\n        yield* arr\n      })()\n    },\n  }\n}\n","import * as v from 'valibot'\n\nexport const generateSchema = v.object({\n  config: v.optional(\n    v.pipe(v.string(), v.minLength(1), v.description('Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory')),\n  ),\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),\n  logLevel: v.optional(\n    v.pipe(v.picklist(['silent', 'error', 'warn', 'info', 'verbose', 'debug']), v.description('Log level for build output')),\n    'info',\n  ),\n})\n","export const NotifyTypes = {\n  INFO: 'INFO',\n  SUCCESS: 'SUCCESS',\n  ERROR: 'ERROR',\n  WARN: 'WARN',\n  PLUGIN_START: 'PLUGIN_START',\n  PLUGIN_END: 'PLUGIN_END',\n  FILES_START: 'FILES_START',\n  FILES_UPDATE: 'FILES_UPDATE',\n  FILES_END: 'FILES_END',\n  GENERATION_START: 'GENERATION_START',\n  GENERATION_END: 'GENERATION_END',\n  CONFIG_LOADED: 'CONFIG_LOADED',\n  CONFIG_ERROR: 'CONFIG_ERROR',\n  CONFIG_READY: 'CONFIG_READY',\n  SETUP_START: 'SETUP_START',\n  SETUP_END: 'SETUP_END',\n  BUILD_START: 'BUILD_START',\n  BUILD_END: 'BUILD_END',\n  BUILD_FAILED: 'BUILD_FAILED',\n  BUILD_SUCCESS: 'BUILD_SUCCESS',\n  FATAL_ERROR: 'FATAL_ERROR',\n} as const\n","export const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])\n","import { existsSync } from 'node:fs'\nimport path from 'node:path'\nimport type { Config } from '@kubb/core'\nimport { createJiti } from 'jiti'\nimport { ALLOWED_CONFIG_EXTENSIONS } from '../constants.ts'\nimport { NotifyTypes } from '../types.ts'\n\ntype NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>\n\nconst jiti = createJiti(import.meta.url, {\n  jsx: {\n    runtime: 'automatic',\n    importSource: '@kubb/renderer-jsx',\n  },\n  moduleCache: false,\n})\n\nconst loadedModules = new Map<string, unknown>()\n\nasync function loadModule(filePath: string): Promise<unknown> {\n  const ext = path.extname(filePath)\n  if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n    throw new Error(`Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`)\n  }\n  if (loadedModules.has(filePath)) {\n    return loadedModules.get(filePath)\n  }\n  const mod = await jiti.import(filePath, { default: true })\n  loadedModules.set(filePath, mod)\n  return mod\n}\n\nexport async function loadUserConfig(configPath: string | undefined, { notify }: { notify: NotifyFunction }): Promise<{ userConfig: Config; cwd: string }> {\n  if (configPath) {\n    const ext = path.extname(configPath)\n    if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n      const msg = `Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const base = path.resolve(process.cwd())\n    const resolvedConfigPath = path.resolve(base, configPath)\n    const relative = path.relative(base, resolvedConfigPath)\n    if (relative.startsWith('..') || path.isAbsolute(relative)) {\n      const msg = 'Invalid config file path: must be within the current working directory'\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const cwd = path.dirname(resolvedConfigPath)\n    try {\n      const userConfig = (await loadModule(resolvedConfigPath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${resolvedConfigPath}`)\n      return { userConfig, cwd }\n    } catch (error) {\n      const msg = `Failed to load config: ${error instanceof Error ? error.message : String(error)}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n  }\n\n  const cwd = process.cwd()\n  const configFileNames = ['kubb.config.ts', 'kubb.config.mts', 'kubb.config.cts', 'kubb.config.js', 'kubb.config.cjs']\n\n  for (const configFileName of configFileNames) {\n    const configFilePath = path.resolve(process.cwd(), configFileName)\n    if (!existsSync(configFilePath)) continue\n    try {\n      const userConfig = (await loadModule(configFilePath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`)\n      return { userConfig, cwd }\n    } catch (err) {\n      await notify(NotifyTypes.CONFIG_ERROR, `Failed to load ${configFileName}: ${err instanceof Error ? err.message : String(err)}`)\n    }\n  }\n\n  await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')\n  throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)\n}\n","import path from 'node:path'\nimport type { Config } from '@kubb/core'\n\n/**\n * Determine the root directory based on userConfig.root and resolvedConfigDir\n * 1. If userConfig.root exists and is absolute, use it as-is\n * 2. If userConfig.root exists and is relative, resolve it relative to config directory\n * 3. Otherwise, use the config directory as root\n */\nexport function resolveCwd(userConfig: Config, cwd: string): string {\n  if (userConfig.root) {\n    if (path.isAbsolute(userConfig.root)) {\n      return userConfig.root\n    }\n\n    return path.resolve(cwd, userConfig.root)\n  }\n\n  return cwd\n}\n","import { isPromise } from '@internals/utils'\nimport type { CLIOptions, Config, PossibleConfig } from '@kubb/core'\n\nexport type ResolveUserConfigOptions = {\n  configPath?: string\n  logLevel?: string\n}\n\nexport async function resolveUserConfig(config: PossibleConfig<CLIOptions>, options: ResolveUserConfigOptions): Promise<Config> {\n  const result = typeof config === 'function' ? config({ logLevel: options.logLevel as CLIOptions['logLevel'], config: options.configPath }) : config\n  const resolved = isPromise(result) ? await result : result\n  return (Array.isArray(resolved) ? resolved[0] : resolved) as Config\n}\n","import { AsyncEventEmitter, toError } from '@internals/utils'\nimport { type Config, createKubb, type KubbHooks } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport type * as v from 'valibot'\nimport { generateSchema } from '../schemas/generateSchema.ts'\nimport { NotifyTypes } from '../types.ts'\nimport { loadUserConfig } from '../utils/loadUserConfig.ts'\nimport { resolveCwd } from '../utils/resolveCwd.ts'\nimport { resolveUserConfig } from '../utils/resolveUserConfig.ts'\n\nexport const generateTool = defineTool(\n  {\n    name: 'generate',\n    description: 'Generate OpenAPI spec helpers using Kubb configuration',\n    schema: generateSchema,\n  },\n  async function generate(schema: v.InferInput<typeof generateSchema>) {\n    const { config: configPath, input, output, logLevel } = schema\n\n    try {\n      const hooks = new AsyncEventEmitter<KubbHooks>()\n      const messages: Array<string> = []\n\n      const notify = async (type: string, message: string, _data?: Record<string, unknown>) => {\n        messages.push(`${type}: ${message}`)\n      }\n\n      hooks.on('kubb:info', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.INFO, message)\n      })\n\n      hooks.on('kubb:success', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.SUCCESS, message)\n      })\n\n      hooks.on('kubb:error', async ({ error }: { error: Error }) => {\n        await notify(NotifyTypes.ERROR, error.message)\n      })\n\n      hooks.on('kubb:warn', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.WARN, message)\n      })\n\n      hooks.on('kubb:plugin:start', async ({ plugin }) => {\n        await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)\n      })\n\n      hooks.on('kubb:plugin:end', async ({ plugin, duration }) => {\n        await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${plugin.name}`, { duration })\n      })\n\n      hooks.on('kubb:files:processing:start', async () => {\n        await notify(NotifyTypes.FILES_START, 'Starting file processing')\n      })\n\n      hooks.on('kubb:files:processing:update', async ({ files }: { files: Array<{ file: { name: string } }> }) => {\n        await notify(NotifyTypes.FILES_UPDATE, `Processing ${files.length} files`)\n      })\n\n      hooks.on('kubb:files:processing:end', async () => {\n        await notify(NotifyTypes.FILES_END, 'File processing complete')\n      })\n\n      hooks.on('kubb:generation:start', async () => {\n        await notify(NotifyTypes.GENERATION_START, 'Generation started')\n      })\n\n      hooks.on('kubb:generation:end', async () => {\n        await notify(NotifyTypes.GENERATION_END, 'Generation ended')\n      })\n\n      let userConfig: Config\n      let cwd: string\n\n      try {\n        const configResult = await loadUserConfig(configPath, { notify })\n        userConfig = configResult.userConfig\n        cwd = configResult.cwd\n\n        if (Array.isArray(userConfig)) {\n          throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')\n        }\n\n        userConfig = await resolveUserConfig(userConfig, {\n          configPath,\n          logLevel,\n        })\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error)\n        await notify(NotifyTypes.CONFIG_ERROR, errorMessage)\n        return tool.error(errorMessage)\n      }\n\n      const inputPath = input ?? (userConfig.input && 'path' in userConfig.input ? userConfig.input.path : undefined)\n\n      const config: Config = {\n        ...userConfig,\n        root: resolveCwd(userConfig, cwd),\n        input: inputPath\n          ? {\n              ...userConfig.input,\n              path: inputPath,\n            }\n          : userConfig.input,\n        output: output\n          ? {\n              ...userConfig.output,\n              path: output,\n            }\n          : userConfig.output,\n      }\n\n      await notify(NotifyTypes.CONFIG_READY, 'Configuration ready')\n      await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')\n\n      const kubb = createKubb(config, { hooks })\n      await kubb.setup()\n      await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')\n\n      await notify(NotifyTypes.BUILD_START, 'Starting build')\n      const { files, failedPlugins, error } = await kubb.safeBuild()\n      await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)\n\n      if (error || failedPlugins.size > 0) {\n        const allErrors: Array<Error> = [\n          error,\n          ...Array.from(failedPlugins)\n            .filter((it) => it.error)\n            .map((it) => it.error),\n        ].filter(Boolean)\n\n        await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`)\n\n        return tool.error(`Build failed:\\n${allErrors.map((err) => err.message).join('\\n')}\\n\\n${messages.join('\\n')}`)\n      }\n\n      await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)\n\n      return tool.text(`Build completed successfully!\\n\\nGenerated ${files.length} files\\n\\n${messages.join('\\n')}`)\n    } catch (caughtError) {\n      const error = toError(caughtError)\n      return tool.error(`Build error: ${error.message}\\n${error.stack ?? ''}`)\n    }\n  },\n)\n","import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: PluginOption[] = [\n  {\n    value: 'plugin-ts',\n    label: 'TypeScript',\n    hint: 'Recommended',\n    packageName: '@kubb/plugin-ts',\n    importName: 'pluginTs',\n    category: 'types',\n  },\n  {\n    value: 'plugin-client',\n    label: 'Client (Fetch/Axios)',\n    packageName: '@kubb/plugin-client',\n    importName: 'pluginClient',\n    category: 'client',\n  },\n  {\n    value: 'plugin-react-query',\n    label: 'React Query / TanStack Query',\n    packageName: '@kubb/plugin-react-query',\n    importName: 'pluginReactQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-vue-query',\n    label: 'Vue Query',\n    packageName: '@kubb/plugin-vue-query',\n    importName: 'pluginVueQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-zod',\n    label: 'Zod Schemas',\n    packageName: '@kubb/plugin-zod',\n    importName: 'pluginZod',\n    category: 'validation',\n  },\n  {\n    value: 'plugin-faker',\n    label: 'Faker.js Mocks',\n    packageName: '@kubb/plugin-faker',\n    importName: 'pluginFaker',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-msw',\n    label: 'MSW Handlers',\n    packageName: '@kubb/plugin-msw',\n    importName: 'pluginMsw',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-cypress',\n    label: 'Cypress Tests',\n    packageName: '@kubb/plugin-cypress',\n    importName: 'pluginCypress',\n    category: 'testing',\n  },\n  {\n    value: 'plugin-mcp',\n    label: 'MCP Server (AI / Model Context Protocol)',\n    packageName: '@kubb/plugin-mcp',\n    importName: 'pluginMcp',\n    category: 'ai',\n  },\n  {\n    value: 'plugin-redoc',\n    label: 'ReDoc Documentation',\n    packageName: '@kubb/plugin-redoc',\n    importName: 'pluginRedoc',\n    category: 'documentation',\n  },\n]\n\nexport const pluginDefaultConfigs = {\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n  'plugin-cypress': `pluginCypress({\n      output: { path: 'cypress' },\n    })`,\n  'plugin-mcp': `pluginMcp({\n      output: { path: 'mcp' },\n    })`,\n  'plugin-redoc': `pluginRedoc({\n      output: { path: 'redoc' },\n    })`,\n} as const satisfies Record<string, string>\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n  selectedPlugins,\n  inputPath,\n  outputPath,\n}: {\n  selectedPlugins: PluginOption[]\n  inputPath: string\n  outputPath: string\n}): string {\n  const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n  const pluginConfigs = selectedPlugins\n    .map((plugin) => {\n      const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n      return `    ${config},`\n    })\n    .join('\\n')\n\n  return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n  root: '.',\n  input: {\n    path: '${inputPath}',\n  },\n  output: {\n    path: '${outputPath}',\n    clean: true,\n  },\n  plugins: [\n${pluginConfigs}\n  ],\n})\n`\n}\n","import * as v from 'valibot'\n\nexport const initSchema = v.object({\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI spec (default: ./openapi.yaml)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory (default: ./src/gen)'))),\n  plugins: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Comma-separated list of plugins: plugin-ts,plugin-zod,...'))),\n})\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { availablePlugins, generateConfigFile, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { initSchema } from '../schemas/initSchema.ts'\n\nexport function resolvePlugins(pluginsFlag: string | undefined): Array<PluginOption> {\n  if (!pluginsFlag) {\n    return []\n  }\n  const requested = pluginsFlag\n    .split(',')\n    .map((v) => v.trim())\n    .filter(Boolean)\n  return availablePlugins.filter((p) => requested.includes(p.value))\n}\n\nexport const initTool = defineTool(\n  {\n    name: 'init',\n    description: 'Scaffold a kubb.config.ts in the current directory (non-interactive). Does not install packages.',\n    schema: initSchema,\n  },\n  async ({ input = './openapi.yaml', output = './src/gen', plugins }) => {\n    const selected = resolvePlugins(plugins)\n    const content = generateConfigFile({ selectedPlugins: selected, inputPath: input, outputPath: output })\n    const dest = path.join(process.cwd(), KUBB_CONFIG_FILENAME)\n    if (fs.existsSync(dest)) {\n      return tool.error(`${KUBB_CONFIG_FILENAME} already exists at ${dest}. Delete it first before running init again.`)\n    }\n    fs.writeFileSync(dest, content, 'utf-8')\n    const packageList = ['kubb', ...selected.map((p) => p.packageName)].join(' ')\n    return tool.text(`Created kubb.config.ts\\n\\nInstall packages:\\n  npm install ${packageList}\\n\\nThen run:\\n  npx kubb generate`)\n  },\n)\n","import * as v from 'valibot'\n\nexport const validateSchema = v.object({\n  input: v.pipe(v.string(), v.minLength(1), v.description('Path or URL to the OpenAPI/Swagger specification')),\n})\n","import { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { validateSchema } from '../schemas/validateSchema.ts'\n\nexport const validateTool = defineTool(\n  {\n    name: 'validate',\n    description: 'Validate an OpenAPI/Swagger specification file or URL',\n    schema: validateSchema,\n  },\n  async ({ input }) => {\n    let mod: typeof import('@kubb/adapter-oas')\n    try {\n      mod = await import('@kubb/adapter-oas')\n    } catch {\n      return tool.error('The validate tool requires @kubb/adapter-oas.\\nInstall: npm install @kubb/adapter-oas')\n    }\n    try {\n      await mod.adapterOas().validate(input, { throwOnError: true })\n      return tool.text(`Validation successful: ${input}`)\n    } catch (err) {\n      return tool.error(`Validation failed:\\n${err instanceof Error ? err.message : String(err)}`)\n    }\n  },\n)\n","import http from 'node:http'\nimport { createRequestListener } from '@remix-run/node-fetch-server'\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'\nimport { HttpTransport } from '@tmcp/transport-http'\nimport { StdioTransport } from '@tmcp/transport-stdio'\nimport { McpServer } from 'tmcp'\nimport { version } from '../package.json'\nimport { generateTool } from './tools/generate.ts'\nimport { initTool } from './tools/init.ts'\nimport { validateTool } from './tools/validate.ts'\n\nexport type ServerOptions = {\n  port?: number\n  host?: string\n}\n\nexport function createMcpServer() {\n  const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter(), capabilities: { tools: {} } })\n  server.tools([generateTool, validateTool, initTool])\n  return server\n}\n\nexport async function startServer({ port, host = 'localhost' }: ServerOptions = {}) {\n  const server = createMcpServer()\n\n  if (port === undefined) {\n    new StdioTransport(server).listen()\n    return\n  }\n\n  const transport = new HttpTransport(server, { path: '/mcp' })\n  const httpServer = http.createServer(\n    createRequestListener(async (request) => {\n      const response = await transport.respond(request)\n      return response ?? new Response('Not Found', { status: 404 })\n    }),\n  )\n  httpServer.listen(port, host, () => {\n    console.log(`Kubb MCP server on http://${host}:${port}`)\n  })\n\n  const closeServer = () => httpServer.close()\n  process.once('SIGINT', closeServer)\n  process.once('SIGTERM', closeServer)\n  httpServer.once('close', () => {\n    process.off('SIGINT', closeServer)\n    process.off('SIGTERM', closeServer)\n  })\n}\n","import { startServer } from './server.ts'\n\nexport { createMcpServer } from './server.ts'\nexport type { ServerOptions } from './server.ts'\n\nexport async function run(_argv?: Array<string>, options?: import('./server.ts').ServerOptions): Promise<void> {\n  await startServer(options)\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["#emitter","NodeEventEmitter","#emitAll","v","jiti","path","path","Diagnostics","tool","isProblemDiagnostic","v","path","process","fs","tool","v","tool","Diagnostics","McpServer","ValibotJsonSchemaAdapter","StdioTransport","HttpTransport","http"],"sources":["../package.json","../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/promise.ts","../src/schemas/generateSchema.ts","../src/utils/formatDiagnostics.ts","../src/types.ts","../src/constants.ts","../src/utils/loadUserConfig.ts","../src/utils/resolveCwd.ts","../src/utils/resolveUserConfig.ts","../src/tools/generate.ts","../../../internals/shared/src/constants.ts","../../../internals/shared/src/init.ts","../src/schemas/initSchema.ts","../src/tools/init.ts","../src/schemas/validateSchema.ts","../src/tools/validate.ts","../src/server.ts","../src/index.ts"],"sourcesContent":["","/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n  /**\n   * Maximum number of listeners per event before Node emits a memory-leak warning.\n   * @default 10\n   */\n  constructor(maxListener = 10) {\n    this.#emitter.setMaxListeners(maxListener)\n  }\n\n  #emitter = new NodeEventEmitter()\n\n  /**\n   * Emits `eventName` and awaits all registered listeners sequentially.\n   * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n   *\n   * @example\n   * ```ts\n   * await emitter.emit('build', 'petstore')\n   * ```\n   */\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> | void {\n    const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n    if (listeners.length === 0) {\n      return\n    }\n\n    return this.#emitAll(eventName, listeners, eventArgs)\n  }\n\n  async #emitAll<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listeners: Array<AsyncListener<TEvents[TEventName]>>,\n    eventArgs: TEvents[TEventName],\n  ): Promise<void> {\n    for (const listener of listeners) {\n      try {\n        await listener(...eventArgs)\n      } catch (err) {\n        let serializedArgs: string\n        try {\n          serializedArgs = JSON.stringify(eventArgs)\n        } catch {\n          serializedArgs = String(eventArgs)\n        }\n        throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n      }\n    }\n  }\n\n  /**\n   * Registers a persistent listener for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', async (name) => { console.log(name) })\n   * ```\n   */\n  on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Registers a one-shot listener that removes itself after the first invocation.\n   *\n   * @example\n   * ```ts\n   * emitter.onOnce('build', async (name) => { console.log(name) })\n   * ```\n   */\n  onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n      this.off(eventName, wrapper)\n      return handler(...args)\n    }\n    this.on(eventName, wrapper)\n  }\n\n  /**\n   * Removes a previously registered listener.\n   *\n   * @example\n   * ```ts\n   * emitter.off('build', handler)\n   * ```\n   */\n  off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Returns the number of listeners registered for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', handler)\n   * emitter.listenerCount('build') // 1\n   * ```\n   */\n  listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n    return this.#emitter.listenerCount(eventName)\n  }\n\n  /**\n   * Raises or lowers the per-event listener ceiling before Node warns about a memory leak.\n   * Set this above the expected listener count when many listeners attach by design.\n   *\n   * @example\n   * ```ts\n   * emitter.setMaxListeners(40)\n   * ```\n   */\n  setMaxListeners(max: number): void {\n    this.#emitter.setMaxListeners(max)\n  }\n\n  /**\n   * Returns the current per-event listener ceiling.\n   */\n  getMaxListeners(): number {\n    return this.#emitter.getMaxListeners()\n  }\n\n  /**\n   * Removes all listeners from every event channel.\n   *\n   * @example\n   * ```ts\n   * emitter.removeAll()\n   * ```\n   */\n  removeAll(): void {\n    this.#emitter.removeAllListeners()\n  }\n}\n","function* chunks<T>(arr: readonly T[], size: number): Generator<T[]> {\n  for (let i = 0; i < arr.length; i += size) {\n    yield arr.slice(i, i + size)\n  }\n}\n\nexport type ForBatchesOptions = {\n  /**\n   * Maximum batch size handed to `process`.\n   * Parallel dispatch within a batch is the caller's responsibility\n   * (typically via `Promise.all(batch.map(...))`).\n   */\n  concurrency: number\n  /**\n   * Called after every batch.\n   *\n   * Use a cheap, idempotent callback (e.g. one that short-circuits when there\n   * is nothing new to do). The helper does not coalesce calls — if you need\n   * throttling, do it inside `flush` itself.\n   */\n  flush?: () => Promise<void>\n}\n\n/**\n * Slices `source` into batches of `concurrency` items and awaits `process` for each batch.\n * Accepts both plain arrays (sync) and `AsyncIterable` (streaming).\n *\n * `process` controls whether items inside a batch run in parallel; this helper only\n * controls batch size and per-batch flushing.\n *\n * @example\n * ```ts\n * // parallel dispatch inside each batch\n * await forBatches(schemas, (batch) => Promise.all(batch.map(process)), { concurrency: 8 })\n *\n * // async iterable with a flush after every batch\n * await forBatches(stream.schemas, (batch) => dispatch(batch), { concurrency: 8, flush })\n * ```\n */\nexport async function forBatches<T>(\n  source: readonly T[] | AsyncIterable<T>,\n  process: (batch: T[]) => Promise<unknown>,\n  options: ForBatchesOptions,\n): Promise<void> {\n  const { concurrency, flush } = options\n\n  if (Array.isArray(source)) {\n    for (const batch of chunks(source, concurrency)) {\n      await process(batch)\n      if (flush) await flush()\n    }\n    return\n  }\n\n  const batch: T[] = []\n  for await (const item of source) {\n    batch.push(item)\n    if (batch.length >= concurrency) {\n      await process(batch.splice(0))\n\n      if (flush) await flush()\n    }\n  }\n  if (batch.length > 0) {\n    await process(batch.splice(0))\n\n    if (flush) await flush()\n  }\n}\n\n/**\n * Runs `work`, passing `flush` as its periodic-flush callback, then calls\n * `flush` once more to drain any items that did not cross a flush boundary.\n *\n * @example\n * ```ts\n * await withDrain(\n *   (flush) => processItems(items, { flush }),\n *   () => writeRemainingFiles(),\n * )\n * ```\n */\nexport async function withDrain(work: (flush: () => Promise<void>) => Promise<void>, flush: () => Promise<void>): Promise<void> {\n  await work(flush)\n  await flush()\n}\n\n/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n\n/**\n * Returns a wrapper that caches the result of the first invocation and replays\n * it for every subsequent call, ignoring later arguments.\n *\n * Works for sync and async factories — for async, the cached value is the\n * promise itself, so concurrent callers share one in-flight execution and\n * cannot race each other.\n *\n * @example\n * ```ts\n * const loadDocument = once(async (path: string) => parse(await readFile(path)))\n * const a = loadDocument('./a.yaml') // parses\n * const b = loadDocument('./b.yaml') // returns the cached promise from the first call\n * ```\n */\nexport function once<TArgs extends unknown[], TReturn>(factory: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn {\n  let cache: { value: TReturn } | undefined\n  return (...args: TArgs): TReturn => {\n    if (!cache) cache = { value: factory(...args) }\n    return cache.value\n  }\n}\n\ntype Store<TKey, TValue> = {\n  has(key: TKey): boolean\n  get(key: TKey): TValue | undefined\n  set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n  return (key: TKey): TValue => {\n    if (store.has(key)) return store.get(key)!\n    const value = factory(key)\n    store.set(key, value)\n    return value\n  }\n}\n\n/**\n * Wraps a plain array in a reusable `AsyncIterable`.\n * Each `[Symbol.asyncIterator]()` call returns a fresh generator so the\n * iterable can be consumed multiple times (e.g. once per plugin pre-scan).\n *\n * @example\n * ```ts\n * const stream = arrayToAsyncIterable([1, 2, 3])\n * for await (const n of stream) console.log(n) // 1, 2, 3\n * ```\n */\nexport function arrayToAsyncIterable<T>(arr: readonly T[]): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator]() {\n      return (async function* () {\n        yield* arr\n      })()\n    },\n  }\n}\n","import * as v from 'valibot'\n\nexport const generateSchema = v.object({\n  config: v.optional(\n    v.pipe(v.string(), v.minLength(1), v.description('Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory')),\n  ),\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),\n  logLevel: v.optional(\n    v.pipe(v.picklist(['silent', 'info', 'verbose']), v.description('Log level for build output')),\n    'info',\n  ),\n})\n","import type { SerializedDiagnostic } from '@kubb/core'\n\n/**\n * Renders serialized diagnostics as a plain-text block for an AI assistant. Each entry\n * keeps the stable `code`, the source pointer, the suggested fix, and the docs link, so\n * the agent can act on the problem rather than parsing a bare message. No ANSI styling,\n * unlike the CLI renderer.\n */\nexport function formatDiagnostics(diagnostics: ReadonlyArray<SerializedDiagnostic>): string {\n  return diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)).join('\\n\\n')\n}\n\nfunction formatDiagnostic(diagnostic: SerializedDiagnostic): string {\n  const { code, severity, message, location, help, plugin, docsUrl } = diagnostic\n  const rule = plugin ? `${plugin}(${code})` : code\n  const lines = [`${severity} ${rule}: ${message}`]\n\n  if (location && 'pointer' in location) {\n    lines.push(`  at ${location.pointer}`)\n  }\n  if (help) {\n    lines.push(`  help: ${help}`)\n  }\n  if (docsUrl) {\n    lines.push(`  docs: ${docsUrl}`)\n  }\n\n  return lines.join('\\n')\n}\n","export const NotifyTypes = {\n  INFO: 'INFO',\n  SUCCESS: 'SUCCESS',\n  ERROR: 'ERROR',\n  WARN: 'WARN',\n  DIAGNOSTIC: 'DIAGNOSTIC',\n  PLUGIN_START: 'PLUGIN_START',\n  PLUGIN_END: 'PLUGIN_END',\n  FILES_START: 'FILES_START',\n  FILES_UPDATE: 'FILES_UPDATE',\n  FILES_END: 'FILES_END',\n  GENERATION_START: 'GENERATION_START',\n  GENERATION_END: 'GENERATION_END',\n  CONFIG_LOADED: 'CONFIG_LOADED',\n  CONFIG_ERROR: 'CONFIG_ERROR',\n  CONFIG_READY: 'CONFIG_READY',\n  SETUP_START: 'SETUP_START',\n  SETUP_END: 'SETUP_END',\n  BUILD_START: 'BUILD_START',\n  BUILD_END: 'BUILD_END',\n  BUILD_FAILED: 'BUILD_FAILED',\n  BUILD_SUCCESS: 'BUILD_SUCCESS',\n  FATAL_ERROR: 'FATAL_ERROR',\n} as const\n","export const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])\n","import { existsSync } from 'node:fs'\nimport path from 'node:path'\nimport type { Config } from '@kubb/core'\nimport { createJiti } from 'jiti'\nimport { ALLOWED_CONFIG_EXTENSIONS } from '../constants.ts'\nimport { NotifyTypes } from '../types.ts'\n\ntype NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>\n\nconst jiti = createJiti(import.meta.url, {\n  jsx: {\n    runtime: 'automatic',\n    importSource: '@kubb/renderer-jsx',\n  },\n  moduleCache: false,\n})\n\nconst loadedModules = new Map<string, unknown>()\n\nasync function loadModule(filePath: string): Promise<unknown> {\n  const ext = path.extname(filePath)\n  if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n    throw new Error(`Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`)\n  }\n  if (loadedModules.has(filePath)) {\n    return loadedModules.get(filePath)\n  }\n  const mod = await jiti.import(filePath, { default: true })\n  loadedModules.set(filePath, mod)\n  return mod\n}\n\nexport async function loadUserConfig(configPath: string | undefined, { notify }: { notify: NotifyFunction }): Promise<{ userConfig: Config; cwd: string }> {\n  if (configPath) {\n    const ext = path.extname(configPath)\n    if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n      const msg = `Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const base = path.resolve(process.cwd())\n    const resolvedConfigPath = path.resolve(base, configPath)\n    const relative = path.relative(base, resolvedConfigPath)\n    if (relative.startsWith('..') || path.isAbsolute(relative)) {\n      const msg = 'Invalid config file path: must be within the current working directory'\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const cwd = path.dirname(resolvedConfigPath)\n    try {\n      const userConfig = (await loadModule(resolvedConfigPath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${resolvedConfigPath}`)\n      return { userConfig, cwd }\n    } catch (error) {\n      const msg = `Failed to load config: ${error instanceof Error ? error.message : String(error)}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n  }\n\n  const cwd = process.cwd()\n  const configFileNames = ['kubb.config.ts', 'kubb.config.mts', 'kubb.config.cts', 'kubb.config.js', 'kubb.config.cjs']\n\n  for (const configFileName of configFileNames) {\n    const configFilePath = path.resolve(process.cwd(), configFileName)\n    if (!existsSync(configFilePath)) continue\n    try {\n      const userConfig = (await loadModule(configFilePath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`)\n      return { userConfig, cwd }\n    } catch (err) {\n      await notify(NotifyTypes.CONFIG_ERROR, `Failed to load ${configFileName}: ${err instanceof Error ? err.message : String(err)}`)\n    }\n  }\n\n  await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')\n  throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)\n}\n","import path from 'node:path'\nimport type { Config } from '@kubb/core'\n\n/**\n * Determine the root directory based on userConfig.root and resolvedConfigDir\n * 1. If userConfig.root exists and is absolute, use it as-is\n * 2. If userConfig.root exists and is relative, resolve it relative to config directory\n * 3. Otherwise, use the config directory as root\n */\nexport function resolveCwd(userConfig: Config, cwd: string): string {\n  if (userConfig.root) {\n    if (path.isAbsolute(userConfig.root)) {\n      return userConfig.root\n    }\n\n    return path.resolve(cwd, userConfig.root)\n  }\n\n  return cwd\n}\n","import { isPromise } from '@internals/utils'\nimport type { CLIOptions, Config, PossibleConfig } from '@kubb/core'\n\nexport type ResolveUserConfigOptions = {\n  configPath?: string\n  logLevel?: string\n}\n\nexport async function resolveUserConfig(config: PossibleConfig<CLIOptions>, options: ResolveUserConfigOptions): Promise<Config> {\n  const result = typeof config === 'function' ? config({ logLevel: options.logLevel as CLIOptions['logLevel'], config: options.configPath }) : config\n  const resolved = isPromise(result) ? await result : result\n  return (Array.isArray(resolved) ? resolved[0] : resolved) as Config\n}\n","import { AsyncEventEmitter } from '@internals/utils'\nimport { type Config, createKubb, type Diagnostic, Diagnostics, isProblemDiagnostic, type KubbHooks } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport type * as v from 'valibot'\nimport { generateSchema } from '../schemas/generateSchema.ts'\nimport { formatDiagnostics } from '../utils/formatDiagnostics.ts'\nimport { NotifyTypes } from '../types.ts'\nimport { loadUserConfig } from '../utils/loadUserConfig.ts'\nimport { resolveCwd } from '../utils/resolveCwd.ts'\nimport { resolveUserConfig } from '../utils/resolveUserConfig.ts'\n\nexport const generateTool = defineTool(\n  {\n    name: 'generate',\n    description: 'Generate OpenAPI spec helpers using Kubb configuration',\n    schema: generateSchema,\n  },\n  async function generate(schema: v.InferInput<typeof generateSchema>) {\n    const { config: configPath, input, output, logLevel } = schema\n\n    try {\n      const hooks = new AsyncEventEmitter<KubbHooks>()\n      const messages: Array<string> = []\n\n      const notify = async (type: string, message: string, data?: Record<string, unknown>) => {\n        messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`)\n      }\n\n      hooks.on('kubb:info', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.INFO, message)\n      })\n\n      hooks.on('kubb:success', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.SUCCESS, message)\n      })\n\n      hooks.on('kubb:error', async ({ error }: { error: Error }) => {\n        await notify(NotifyTypes.ERROR, error.message)\n      })\n\n      hooks.on('kubb:warn', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.WARN, message)\n      })\n\n      hooks.on('kubb:diagnostic', async ({ diagnostic }: { diagnostic: Diagnostic }) => {\n        await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, Diagnostics.serialize(diagnostic))\n      })\n\n      hooks.on('kubb:plugin:start', async ({ plugin }) => {\n        await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)\n      })\n\n      hooks.on('kubb:plugin:end', async ({ plugin, duration }) => {\n        await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${plugin.name}`, { duration })\n      })\n\n      hooks.on('kubb:files:processing:start', async () => {\n        await notify(NotifyTypes.FILES_START, 'Starting file processing')\n      })\n\n      hooks.on('kubb:files:processing:update', async ({ files }: { files: Array<{ file: { name: string } }> }) => {\n        await notify(NotifyTypes.FILES_UPDATE, `Processing ${files.length} files`)\n      })\n\n      hooks.on('kubb:files:processing:end', async () => {\n        await notify(NotifyTypes.FILES_END, 'File processing complete')\n      })\n\n      hooks.on('kubb:generation:start', async () => {\n        await notify(NotifyTypes.GENERATION_START, 'Generation started')\n      })\n\n      hooks.on('kubb:generation:end', async () => {\n        await notify(NotifyTypes.GENERATION_END, 'Generation ended')\n      })\n\n      let userConfig: Config\n      let cwd: string\n\n      try {\n        const configResult = await loadUserConfig(configPath, { notify })\n        userConfig = configResult.userConfig\n        cwd = configResult.cwd\n\n        if (Array.isArray(userConfig)) {\n          throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')\n        }\n\n        userConfig = await resolveUserConfig(userConfig, {\n          configPath,\n          logLevel,\n        })\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error)\n        await notify(NotifyTypes.CONFIG_ERROR, errorMessage)\n        return tool.error(errorMessage)\n      }\n\n      const inputPath = input ?? (userConfig.input && 'path' in userConfig.input ? userConfig.input.path : undefined)\n\n      const config: Config = {\n        ...userConfig,\n        root: resolveCwd(userConfig, cwd),\n        input: inputPath\n          ? {\n              ...userConfig.input,\n              path: inputPath,\n            }\n          : userConfig.input,\n        output: output\n          ? {\n              ...userConfig.output,\n              path: output,\n            }\n          : userConfig.output,\n      }\n\n      await notify(NotifyTypes.CONFIG_READY, 'Configuration ready')\n      await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')\n\n      const kubb = createKubb(config, { hooks })\n      await kubb.setup()\n      await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')\n\n      await notify(NotifyTypes.BUILD_START, 'Starting build')\n      const { files, diagnostics } = await kubb.safeBuild()\n      await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)\n\n      const problems = diagnostics.filter(isProblemDiagnostic)\n      const errors = problems.filter((diagnostic) => diagnostic.severity === 'error')\n      if (errors.length > 0) {\n        await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${errors.length} diagnostic(s)`)\n\n        const serialized = problems.map((diagnostic) => Diagnostics.serialize(diagnostic))\n        return tool.error(`Build failed:\\n${formatDiagnostics(serialized)}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n      }\n\n      await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)\n\n      return tool.text(`Build completed successfully!\\n\\nGenerated ${files.length} files\\n\\n${messages.join('\\n')}`)\n    } catch (caughtError) {\n      const serialized = Diagnostics.serialize(Diagnostics.from(caughtError))\n      return tool.error(`Build error:\\n${formatDiagnostics([serialized])}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n    }\n  },\n)\n","import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: PluginOption[] = [\n  {\n    value: 'plugin-ts',\n    label: 'TypeScript',\n    hint: 'Recommended',\n    packageName: '@kubb/plugin-ts',\n    importName: 'pluginTs',\n    category: 'types',\n  },\n  {\n    value: 'plugin-client',\n    label: 'Client (Fetch/Axios)',\n    packageName: '@kubb/plugin-client',\n    importName: 'pluginClient',\n    category: 'client',\n  },\n  {\n    value: 'plugin-react-query',\n    label: 'React Query / TanStack Query',\n    packageName: '@kubb/plugin-react-query',\n    importName: 'pluginReactQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-vue-query',\n    label: 'Vue Query',\n    packageName: '@kubb/plugin-vue-query',\n    importName: 'pluginVueQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-zod',\n    label: 'Zod Schemas',\n    packageName: '@kubb/plugin-zod',\n    importName: 'pluginZod',\n    category: 'validation',\n  },\n  {\n    value: 'plugin-faker',\n    label: 'Faker.js Mocks',\n    packageName: '@kubb/plugin-faker',\n    importName: 'pluginFaker',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-msw',\n    label: 'MSW Handlers',\n    packageName: '@kubb/plugin-msw',\n    importName: 'pluginMsw',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-cypress',\n    label: 'Cypress Tests',\n    packageName: '@kubb/plugin-cypress',\n    importName: 'pluginCypress',\n    category: 'testing',\n  },\n  {\n    value: 'plugin-mcp',\n    label: 'MCP Server (AI / Model Context Protocol)',\n    packageName: '@kubb/plugin-mcp',\n    importName: 'pluginMcp',\n    category: 'ai',\n  },\n  {\n    value: 'plugin-redoc',\n    label: 'ReDoc Documentation',\n    packageName: '@kubb/plugin-redoc',\n    importName: 'pluginRedoc',\n    category: 'documentation',\n  },\n]\n\nexport const pluginDefaultConfigs = {\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n  'plugin-cypress': `pluginCypress({\n      output: { path: 'cypress' },\n    })`,\n  'plugin-mcp': `pluginMcp({\n      output: { path: 'mcp' },\n    })`,\n  'plugin-redoc': `pluginRedoc({\n      output: { path: 'redoc' },\n    })`,\n} as const satisfies Record<string, string>\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n  selectedPlugins,\n  inputPath,\n  outputPath,\n}: {\n  selectedPlugins: PluginOption[]\n  inputPath: string\n  outputPath: string\n}): string {\n  const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n  const pluginConfigs = selectedPlugins\n    .map((plugin) => {\n      const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n      return `    ${config},`\n    })\n    .join('\\n')\n\n  return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n  root: '.',\n  input: {\n    path: '${inputPath}',\n  },\n  output: {\n    path: '${outputPath}',\n    clean: true,\n  },\n  plugins: [\n${pluginConfigs}\n  ],\n})\n`\n}\n","import * as v from 'valibot'\n\nexport const initSchema = v.object({\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI spec (default: ./openapi.yaml)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory (default: ./src/gen)'))),\n  plugins: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Comma-separated list of plugins: plugin-ts,plugin-zod,...'))),\n})\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { availablePlugins, generateConfigFile, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { initSchema } from '../schemas/initSchema.ts'\n\nexport function resolvePlugins(pluginsFlag: string | undefined): Array<PluginOption> {\n  if (!pluginsFlag) {\n    return []\n  }\n  const requested = pluginsFlag\n    .split(',')\n    .map((v) => v.trim())\n    .filter(Boolean)\n  return availablePlugins.filter((p) => requested.includes(p.value))\n}\n\nexport const initTool = defineTool(\n  {\n    name: 'init',\n    description: 'Scaffold a kubb.config.ts in the current directory (non-interactive). Does not install packages.',\n    schema: initSchema,\n  },\n  async ({ input = './openapi.yaml', output = './src/gen', plugins }) => {\n    const selected = resolvePlugins(plugins)\n    const content = generateConfigFile({ selectedPlugins: selected, inputPath: input, outputPath: output })\n    const dest = path.join(process.cwd(), KUBB_CONFIG_FILENAME)\n    if (fs.existsSync(dest)) {\n      return tool.error(`${KUBB_CONFIG_FILENAME} already exists at ${dest}. Delete it first before running init again.`)\n    }\n    fs.writeFileSync(dest, content, 'utf-8')\n    const packageList = ['kubb', ...selected.map((p) => p.packageName)].join(' ')\n    return tool.text(`Created kubb.config.ts\\n\\nInstall packages:\\n  npm install ${packageList}\\n\\nThen run:\\n  npx kubb generate`)\n  },\n)\n","import * as v from 'valibot'\n\nexport const validateSchema = v.object({\n  input: v.pipe(v.string(), v.minLength(1), v.description('Path or URL to the OpenAPI/Swagger specification')),\n})\n","import { Diagnostics } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { validateSchema } from '../schemas/validateSchema.ts'\nimport { formatDiagnostics } from '../utils/formatDiagnostics.ts'\n\nexport const validateTool = defineTool(\n  {\n    name: 'validate',\n    description: 'Validate an OpenAPI/Swagger specification file or URL',\n    schema: validateSchema,\n  },\n  async ({ input }) => {\n    let mod: typeof import('@kubb/adapter-oas')\n    try {\n      mod = await import('@kubb/adapter-oas')\n    } catch {\n      return tool.error('The validate tool requires @kubb/adapter-oas.\\nInstall: npm install @kubb/adapter-oas')\n    }\n    try {\n      await mod.adapterOas().validate(input, { throwOnError: true })\n      return tool.text(`Validation successful: ${input}`)\n    } catch (err) {\n      const serialized = Diagnostics.serialize(Diagnostics.from(err))\n      return tool.error(`Validation failed:\\n${formatDiagnostics([serialized])}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n    }\n  },\n)\n","import http from 'node:http'\nimport { createRequestListener } from '@remix-run/node-fetch-server'\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'\nimport { HttpTransport } from '@tmcp/transport-http'\nimport { StdioTransport } from '@tmcp/transport-stdio'\nimport { McpServer } from 'tmcp'\nimport { version } from '../package.json'\nimport { generateTool } from './tools/generate.ts'\nimport { initTool } from './tools/init.ts'\nimport { validateTool } from './tools/validate.ts'\n\nexport type ServerOptions = {\n  port?: number\n  host?: string\n}\n\nexport function createMcpServer() {\n  const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter(), capabilities: { tools: {} } })\n  server.tools([generateTool, validateTool, initTool])\n  return server\n}\n\nexport async function startServer({ port, host = 'localhost' }: ServerOptions = {}) {\n  const server = createMcpServer()\n\n  if (port === undefined) {\n    new StdioTransport(server).listen()\n    return\n  }\n\n  const transport = new HttpTransport(server, { path: '/mcp' })\n  const httpServer = http.createServer(\n    createRequestListener(async (request) => {\n      const response = await transport.respond(request)\n      return response ?? new Response('Not Found', { status: 404 })\n    }),\n  )\n  httpServer.listen(port, host, () => {\n    console.log(`Kubb MCP server on http://${host}:${port}`)\n  })\n\n  const closeServer = () => httpServer.close()\n  process.once('SIGINT', closeServer)\n  process.once('SIGTERM', closeServer)\n  httpServer.once('close', () => {\n    process.off('SIGINT', closeServer)\n    process.off('SIGTERM', closeServer)\n  })\n}\n","import { startServer } from './server.ts'\n\nexport { createMcpServer } from './server.ts'\nexport type { ServerOptions } from './server.ts'\n\nexport async function run(_argv?: Array<string>, options?: import('./server.ts').ServerOptions): Promise<void> {\n  await startServer(options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC8BA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE;;;;;;;;;;;;;;ACbA,IAAa,oBAAb,MAAoF;;;;;CAKlF,YAAY,cAAc,IAAI;EAC5B,KAAKA,SAAS,gBAAgB,WAAW;CAC3C;CAEA,WAAW,IAAIC,YAAAA,aAAiB;;;;;;;;;;CAWhC,KAAgD,WAAuB,GAAG,WAAsD;EAC9H,MAAM,YAAY,KAAKD,SAAS,UAAU,SAAS;EAEnD,IAAI,UAAU,WAAW,GACvB;EAGF,OAAO,KAAKE,SAAS,WAAW,WAAW,SAAS;CACtD;CAEA,MAAMA,SACJ,WACA,WACA,WACe;EACf,KAAK,MAAM,YAAY,WACrB,IAAI;GACF,MAAM,SAAS,GAAG,SAAS;EAC7B,SAAS,KAAK;GACZ,IAAI;GACJ,IAAI;IACF,iBAAiB,KAAK,UAAU,SAAS;GAC3C,QAAQ;IACN,iBAAiB,OAAO,SAAS;GACnC;GACA,MAAM,IAAI,MAAM,gCAAgC,UAAU,mBAAmB,kBAAkB,EAAE,OAAO,QAAQ,GAAG,EAAE,CAAC;EACxH;CAEJ;;;;;;;;;CAUA,GAA8C,WAAuB,SAAmD;EACtH,KAAKF,SAAS,GAAG,WAAW,OAAmC;CACjE;;;;;;;;;CAUA,OAAkD,WAAuB,SAAmD;EAC1H,MAAM,WAA+C,GAAG,SAAS;GAC/D,KAAK,IAAI,WAAW,OAAO;GAC3B,OAAO,QAAQ,GAAG,IAAI;EACxB;EACA,KAAK,GAAG,WAAW,OAAO;CAC5B;;;;;;;;;CAUA,IAA+C,WAAuB,SAAmD;EACvH,KAAKA,SAAS,IAAI,WAAW,OAAmC;CAClE;;;;;;;;;;CAWA,cAAyD,WAA+B;EACtF,OAAO,KAAKA,SAAS,cAAc,SAAS;CAC9C;;;;;;;;;;CAWA,gBAAgB,KAAmB;EACjC,KAAKA,SAAS,gBAAgB,GAAG;CACnC;;;;CAKA,kBAA0B;EACxB,OAAO,KAAKA,SAAS,gBAAgB;CACvC;;;;;;;;;CAUA,YAAkB;EAChB,KAAKA,SAAS,mBAAmB;CACnC;AACF;;;;;;;;;;;AC/CA,SAAgB,UAAa,QAAkD;CAC7E,OAAO,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAQ,OAAmC,YAAY;AAC3G;;;AC1GA,MAAa,iBAAiBG,QAAE,OAAO;CACrC,QAAQA,QAAE,SACRA,QAAE,KAAKA,QAAE,OAAO,GAAGA,QAAE,UAAU,CAAC,GAAGA,QAAE,YAAY,iIAAiI,CAAC,CACrL;CACA,OAAOA,QAAE,SAASA,QAAE,KAAKA,QAAE,OAAO,GAAGA,QAAE,UAAU,CAAC,GAAGA,QAAE,YAAY,sDAAsD,CAAC,CAAC;CAC3H,QAAQA,QAAE,SAASA,QAAE,KAAKA,QAAE,OAAO,GAAGA,QAAE,UAAU,CAAC,GAAGA,QAAE,YAAY,0CAA0C,CAAC,CAAC;CAChH,UAAUA,QAAE,SACVA,QAAE,KAAKA,QAAE,SAAS;EAAC;EAAU;EAAQ;CAAS,CAAC,GAAGA,QAAE,YAAY,4BAA4B,CAAC,GAC7F,MACF;AACF,CAAC;;;;;;;;;ACJD,SAAgB,kBAAkB,aAA0D;CAC1F,OAAO,YAAY,KAAK,eAAe,iBAAiB,UAAU,CAAC,EAAE,KAAK,MAAM;AAClF;AAEA,SAAS,iBAAiB,YAA0C;CAClE,MAAM,EAAE,MAAM,UAAU,SAAS,UAAU,MAAM,QAAQ,YAAY;CAErE,MAAM,QAAQ,CAAC,GAAG,SAAS,GADd,SAAS,GAAG,OAAO,GAAG,KAAK,KAAK,KACV,IAAI,SAAS;CAEhD,IAAI,YAAY,aAAa,UAC3B,MAAM,KAAK,QAAQ,SAAS,SAAS;CAEvC,IAAI,MACF,MAAM,KAAK,WAAW,MAAM;CAE9B,IAAI,SACF,MAAM,KAAK,WAAW,SAAS;CAGjC,OAAO,MAAM,KAAK,IAAI;AACxB;;;AC5BA,MAAa,cAAc;CACzB,MAAM;CACN,SAAS;CACT,OAAO;CACP,MAAM;CACN,YAAY;CACZ,cAAc;CACd,YAAY;CACZ,aAAa;CACb,cAAc;CACd,WAAW;CACX,kBAAkB;CAClB,gBAAgB;CAChB,eAAe;CACf,cAAc;CACd,cAAc;CACd,aAAa;CACb,WAAW;CACX,aAAa;CACb,WAAW;CACX,cAAc;CACd,eAAe;CACf,aAAa;AACf;;;ACvBA,MAAa,4BAA4B,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAQ;CAAO;CAAQ;AAAM,CAAC;;;ACS/F,MAAMC,UAAAA,GAAAA,KAAAA,YAAAA,QAAAA,KAAAA,EAAAA,cAAAA,UAAAA,EAAAA,MAAmC;CACvC,KAAK;EACH,SAAS;EACT,cAAc;CAChB;CACA,aAAa;AACf,CAAC;AAED,MAAM,gCAAgB,IAAI,IAAqB;AAE/C,eAAe,WAAW,UAAoC;CAC5D,MAAM,MAAMC,UAAAA,QAAK,QAAQ,QAAQ;CACjC,IAAI,CAAC,0BAA0B,IAAI,GAAG,GACpC,MAAM,IAAI,MAAM,kCAAkC,IAAI,cAAc,CAAC,GAAG,yBAAyB,EAAE,KAAK,IAAI,GAAG;CAEjH,IAAI,cAAc,IAAI,QAAQ,GAC5B,OAAO,cAAc,IAAI,QAAQ;CAEnC,MAAM,MAAM,MAAMD,OAAK,OAAO,UAAU,EAAE,SAAS,KAAK,CAAC;CACzD,cAAc,IAAI,UAAU,GAAG;CAC/B,OAAO;AACT;AAEA,eAAsB,eAAe,YAAgC,EAAE,UAAoF;CACzJ,IAAI,YAAY;EACd,MAAM,MAAMC,UAAAA,QAAK,QAAQ,UAAU;EACnC,IAAI,CAAC,0BAA0B,IAAI,GAAG,GAAG;GACvC,MAAM,MAAM,kCAAkC,IAAI,cAAc,CAAC,GAAG,yBAAyB,EAAE,KAAK,IAAI;GACxG,MAAM,OAAO,YAAY,cAAc,GAAG;GAC1C,MAAM,IAAI,MAAM,GAAG;EACrB;EACA,MAAM,OAAOA,UAAAA,QAAK,QAAQ,QAAQ,IAAI,CAAC;EACvC,MAAM,qBAAqBA,UAAAA,QAAK,QAAQ,MAAM,UAAU;EACxD,MAAM,WAAWA,UAAAA,QAAK,SAAS,MAAM,kBAAkB;EACvD,IAAI,SAAS,WAAW,IAAI,KAAKA,UAAAA,QAAK,WAAW,QAAQ,GAAG;GAC1D,MAAM,MAAM;GACZ,MAAM,OAAO,YAAY,cAAc,GAAG;GAC1C,MAAM,IAAI,MAAM,GAAG;EACrB;EACA,MAAM,MAAMA,UAAAA,QAAK,QAAQ,kBAAkB;EAC3C,IAAI;GACF,MAAM,aAAc,MAAM,WAAW,kBAAkB;GACvD,MAAM,OAAO,YAAY,eAAe,sBAAsB,oBAAoB;GAClF,OAAO;IAAE;IAAY;GAAI;EAC3B,SAAS,OAAO;GACd,MAAM,MAAM,0BAA0B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC3F,MAAM,OAAO,YAAY,cAAc,GAAG;GAC1C,MAAM,IAAI,MAAM,GAAG;EACrB;CACF;CAEA,MAAM,MAAM,QAAQ,IAAI;CACxB,MAAM,kBAAkB;EAAC;EAAkB;EAAmB;EAAmB;EAAkB;CAAiB;CAEpH,KAAK,MAAM,kBAAkB,iBAAiB;EAC5C,MAAM,iBAAiBA,UAAAA,QAAK,QAAQ,QAAQ,IAAI,GAAG,cAAc;EACjE,IAAI,EAAA,GAAA,QAAA,YAAY,cAAc,GAAG;EACjC,IAAI;GACF,MAAM,aAAc,MAAM,WAAW,cAAc;GACnD,MAAM,OAAO,YAAY,eAAe,UAAU,eAAe,wBAAwB;GACzF,OAAO;IAAE;IAAY;GAAI;EAC3B,SAAS,KAAK;GACZ,MAAM,OAAO,YAAY,cAAc,kBAAkB,eAAe,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,GAAG;EAChI;CACF;CAEA,MAAM,OAAO,YAAY,cAAc,sBAAsB;CAC7D,MAAM,IAAI,MAAM,wEAAwE,gBAAgB,KAAK,IAAI,GAAG;AACtH;;;;;;;;;ACpEA,SAAgB,WAAW,YAAoB,KAAqB;CAClE,IAAI,WAAW,MAAM;EACnB,IAAIC,UAAAA,QAAK,WAAW,WAAW,IAAI,GACjC,OAAO,WAAW;EAGpB,OAAOA,UAAAA,QAAK,QAAQ,KAAK,WAAW,IAAI;CAC1C;CAEA,OAAO;AACT;;;ACXA,eAAsB,kBAAkB,QAAoC,SAAoD;CAC9H,MAAM,SAAS,OAAO,WAAW,aAAa,OAAO;EAAE,UAAU,QAAQ;EAAoC,QAAQ,QAAQ;CAAW,CAAC,IAAI;CAC7I,MAAM,WAAW,UAAU,MAAM,IAAI,MAAM,SAAS;CACpD,OAAQ,MAAM,QAAQ,QAAQ,IAAI,SAAS,KAAK;AAClD;;;ACAA,MAAa,gBAAA,GAAA,UAAA,YACX;CACE,MAAM;CACN,aAAa;CACb,QAAQ;AACV,GACA,eAAe,SAAS,QAA6C;CACnE,MAAM,EAAE,QAAQ,YAAY,OAAO,QAAQ,aAAa;CAExD,IAAI;EACF,MAAM,QAAQ,IAAI,kBAA6B;EAC/C,MAAM,WAA0B,CAAC;EAEjC,MAAM,SAAS,OAAO,MAAc,SAAiB,SAAmC;GACtF,SAAS,KAAK,OAAO,GAAG,KAAK,IAAI,QAAQ,GAAG,KAAK,UAAU,IAAI,MAAM,GAAG,KAAK,IAAI,SAAS;EAC5F;EAEA,MAAM,GAAG,aAAa,OAAO,EAAE,cAAmC;GAChE,MAAM,OAAO,YAAY,MAAM,OAAO;EACxC,CAAC;EAED,MAAM,GAAG,gBAAgB,OAAO,EAAE,cAAmC;GACnE,MAAM,OAAO,YAAY,SAAS,OAAO;EAC3C,CAAC;EAED,MAAM,GAAG,cAAc,OAAO,EAAE,YAA8B;GAC5D,MAAM,OAAO,YAAY,OAAO,MAAM,OAAO;EAC/C,CAAC;EAED,MAAM,GAAG,aAAa,OAAO,EAAE,cAAmC;GAChE,MAAM,OAAO,YAAY,MAAM,OAAO;EACxC,CAAC;EAED,MAAM,GAAG,mBAAmB,OAAO,EAAE,iBAA6C;GAChF,MAAM,OAAO,YAAY,YAAY,WAAW,SAASC,WAAAA,YAAY,UAAU,UAAU,CAAC;EAC5F,CAAC;EAED,MAAM,GAAG,qBAAqB,OAAO,EAAE,aAAa;GAClD,MAAM,OAAO,YAAY,cAAc,oBAAoB,OAAO,MAAM;EAC1E,CAAC;EAED,MAAM,GAAG,mBAAmB,OAAO,EAAE,QAAQ,eAAe;GAC1D,MAAM,OAAO,YAAY,YAAY,oBAAoB,OAAO,QAAQ,EAAE,SAAS,CAAC;EACtF,CAAC;EAED,MAAM,GAAG,+BAA+B,YAAY;GAClD,MAAM,OAAO,YAAY,aAAa,0BAA0B;EAClE,CAAC;EAED,MAAM,GAAG,gCAAgC,OAAO,EAAE,YAA0D;GAC1G,MAAM,OAAO,YAAY,cAAc,cAAc,MAAM,OAAO,OAAO;EAC3E,CAAC;EAED,MAAM,GAAG,6BAA6B,YAAY;GAChD,MAAM,OAAO,YAAY,WAAW,0BAA0B;EAChE,CAAC;EAED,MAAM,GAAG,yBAAyB,YAAY;GAC5C,MAAM,OAAO,YAAY,kBAAkB,oBAAoB;EACjE,CAAC;EAED,MAAM,GAAG,uBAAuB,YAAY;GAC1C,MAAM,OAAO,YAAY,gBAAgB,kBAAkB;EAC7D,CAAC;EAED,IAAI;EACJ,IAAI;EAEJ,IAAI;GACF,MAAM,eAAe,MAAM,eAAe,YAAY,EAAE,OAAO,CAAC;GAChE,aAAa,aAAa;GAC1B,MAAM,aAAa;GAEnB,IAAI,MAAM,QAAQ,UAAU,GAC1B,MAAM,IAAI,MAAM,2GAA2G;GAG7H,aAAa,MAAM,kBAAkB,YAAY;IAC/C;IACA;GACF,CAAC;EACH,SAAS,OAAO;GACd,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC1E,MAAM,OAAO,YAAY,cAAc,YAAY;GACnD,OAAOC,WAAAA,KAAK,MAAM,YAAY;EAChC;EAEA,MAAM,YAAY,UAAU,WAAW,SAAS,UAAU,WAAW,QAAQ,WAAW,MAAM,OAAO,KAAA;EAErG,MAAM,SAAiB;GACrB,GAAG;GACH,MAAM,WAAW,YAAY,GAAG;GAChC,OAAO,YACH;IACE,GAAG,WAAW;IACd,MAAM;GACR,IACA,WAAW;GACf,QAAQ,SACJ;IACE,GAAG,WAAW;IACd,MAAM;GACR,IACA,WAAW;EACjB;EAEA,MAAM,OAAO,YAAY,cAAc,qBAAqB;EAC5D,MAAM,OAAO,YAAY,aAAa,iBAAiB;EAEvD,MAAM,QAAA,GAAA,WAAA,YAAkB,QAAQ,EAAE,MAAM,CAAC;EACzC,MAAM,KAAK,MAAM;EACjB,MAAM,OAAO,YAAY,WAAW,qBAAqB;EAEzD,MAAM,OAAO,YAAY,aAAa,gBAAgB;EACtD,MAAM,EAAE,OAAO,gBAAgB,MAAM,KAAK,UAAU;EACpD,MAAM,OAAO,YAAY,WAAW,8BAA8B,MAAM,OAAO,OAAO;EAEtF,MAAM,WAAW,YAAY,OAAOC,WAAAA,mBAAmB;EACvD,MAAM,SAAS,SAAS,QAAQ,eAAe,WAAW,aAAa,OAAO;EAC9E,IAAI,OAAO,SAAS,GAAG;GACrB,MAAM,OAAO,YAAY,cAAc,qBAAqB,OAAO,OAAO,eAAe;GAEzF,MAAM,aAAa,SAAS,KAAK,eAAeF,WAAAA,YAAY,UAAU,UAAU,CAAC;GACjF,OAAOC,WAAAA,KAAK,MAAM,kBAAkB,kBAAkB,UAAU,EAAE,kBAAkB,KAAK,UAAU,YAAY,MAAM,CAAC,EAAE,SAAS;EACnI;EAEA,MAAM,OAAO,YAAY,eAAe,4CAA4C,MAAM,OAAO,OAAO;EAExG,OAAOA,WAAAA,KAAK,KAAK,8CAA8C,MAAM,OAAO,YAAY,SAAS,KAAK,IAAI,GAAG;CAC/G,SAAS,aAAa;EACpB,MAAM,aAAaD,WAAAA,YAAY,UAAUA,WAAAA,YAAY,KAAK,WAAW,CAAC;EACtE,OAAOC,WAAAA,KAAK,MAAM,iBAAiB,kBAAkB,CAAC,UAAU,CAAC,EAAE,kBAAkB,KAAK,UAAU,YAAY,MAAM,CAAC,EAAE,SAAS;CACpI;AACF,CACF;;;AChJA,MAAa,uBAAuB;AAQpC,MAAa,mBAAmC;CAC9C;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;CACA;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;CACZ;AACF;AAEA,MAAa,uBAAuB;CAClC,aAAa;;;CAGb,iBAAiB;;;CAGjB,sBAAsB;;;CAGtB,oBAAoB;;;CAGpB,cAAc;;;CAGd,gBAAgB;;;CAGhB,cAAc;;;CAGd,kBAAkB;;;CAGlB,cAAc;;;CAGd,gBAAgB;;;AAGlB;;;AChHA,SAAgB,mBAAmB,EACjC,iBACA,WACA,cAKS;CAUT,OAAO;EATS,gBAAgB,KAAK,WAAW,YAAY,OAAO,WAAW,WAAW,OAAO,YAAY,EAAE,EAAE,KAAK,IAU/G,EAAE;;;;;aAKG,UAAU;;;aAGV,WAAW;;;;EAhBA,gBACnB,KAAK,WAAW;EAEf,OAAO,OADS,qBAAgD,OAAO,UAAU,GAAG,OAAO,WAAW,IACjF;CACvB,CAAC,EACA,KAAK,IAeI,EAAE;;;;AAIhB;;;ACpCA,MAAa,aAAaE,QAAE,OAAO;CACjC,OAAOA,QAAE,SAASA,QAAE,KAAKA,QAAE,OAAO,GAAGA,QAAE,UAAU,CAAC,GAAGA,QAAE,YAAY,gDAAgD,CAAC,CAAC;CACrH,QAAQA,QAAE,SAASA,QAAE,KAAKA,QAAE,OAAO,GAAGA,QAAE,UAAU,CAAC,GAAGA,QAAE,YAAY,uCAAuC,CAAC,CAAC;CAC7G,SAASA,QAAE,SAASA,QAAE,KAAKA,QAAE,OAAO,GAAGA,QAAE,UAAU,CAAC,GAAGA,QAAE,YAAY,2DAA2D,CAAC,CAAC;AACpI,CAAC;;;ACED,SAAgB,eAAe,aAAsD;CACnF,IAAI,CAAC,aACH,OAAO,CAAC;CAEV,MAAM,YAAY,YACf,MAAM,GAAG,EACT,KAAK,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;CACjB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,SAAS,EAAE,KAAK,CAAC;AACnE;AAEA,MAAa,YAAA,GAAA,UAAA,YACX;CACE,MAAM;CACN,aAAa;CACb,QAAQ;AACV,GACA,OAAO,EAAE,QAAQ,kBAAkB,SAAS,aAAa,cAAc;CACrE,MAAM,WAAW,eAAe,OAAO;CACvC,MAAM,UAAU,mBAAmB;EAAE,iBAAiB;EAAU,WAAW;EAAO,YAAY;CAAO,CAAC;CACtG,MAAM,OAAOC,UAAAA,QAAK,KAAKC,aAAAA,QAAQ,IAAI,GAAG,oBAAoB;CAC1D,IAAIC,QAAAA,QAAG,WAAW,IAAI,GACpB,OAAOC,WAAAA,KAAK,MAAM,GAAG,qBAAqB,qBAAqB,KAAK,6CAA6C;CAEnH,QAAA,QAAG,cAAc,MAAM,SAAS,OAAO;CACvC,MAAM,cAAc,CAAC,QAAQ,GAAG,SAAS,KAAK,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,GAAG;CAC5E,OAAOA,WAAAA,KAAK,KAAK,8DAA8D,YAAY,mCAAmC;AAChI,CACF;;;AClCA,MAAa,iBAAiBC,QAAE,OAAO,EACrC,OAAOA,QAAE,KAAKA,QAAE,OAAO,GAAGA,QAAE,UAAU,CAAC,GAAGA,QAAE,YAAY,kDAAkD,CAAC,EAC7G,CAAC;;;ACED,MAAa,gBAAA,GAAA,UAAA,YACX;CACE,MAAM;CACN,aAAa;CACb,QAAQ;AACV,GACA,OAAO,EAAE,YAAY;CACnB,IAAI;CACJ,IAAI;EACF,MAAM,MAAM,OAAO;CACrB,QAAQ;EACN,OAAOC,WAAAA,KAAK,MAAM,uFAAuF;CAC3G;CACA,IAAI;EACF,MAAM,IAAI,WAAW,EAAE,SAAS,OAAO,EAAE,cAAc,KAAK,CAAC;EAC7D,OAAOA,WAAAA,KAAK,KAAK,0BAA0B,OAAO;CACpD,SAAS,KAAK;EACZ,MAAM,aAAaC,WAAAA,YAAY,UAAUA,WAAAA,YAAY,KAAK,GAAG,CAAC;EAC9D,OAAOD,WAAAA,KAAK,MAAM,uBAAuB,kBAAkB,CAAC,UAAU,CAAC,EAAE,kBAAkB,KAAK,UAAU,YAAY,MAAM,CAAC,EAAE,SAAS;CAC1I;AACF,CACF;;;ACXA,SAAgB,kBAAkB;CAChC,MAAM,SAAS,IAAIE,KAAAA,UAAU;EAAE,MAAM;EAAQ;CAAQ,GAAG;EAAE,SAAS,IAAIC,sBAAAA,yBAAyB;EAAG,cAAc,EAAE,OAAO,CAAC,EAAE;CAAE,CAAC;CAChI,OAAO,MAAM;EAAC;EAAc;EAAc;CAAQ,CAAC;CACnD,OAAO;AACT;AAEA,eAAsB,YAAY,EAAE,MAAM,OAAO,gBAA+B,CAAC,GAAG;CAClF,MAAM,SAAS,gBAAgB;CAE/B,IAAI,SAAS,KAAA,GAAW;EACtB,IAAIC,sBAAAA,eAAe,MAAM,EAAE,OAAO;EAClC;CACF;CAEA,MAAM,YAAY,IAAIC,qBAAAA,cAAc,QAAQ,EAAE,MAAM,OAAO,CAAC;CAC5D,MAAM,aAAaC,UAAAA,QAAK,cAAA,GAAA,6BAAA,uBACA,OAAO,YAAY;EAEvC,OAAO,MADgB,UAAU,QAAQ,OAAO,KAC7B,IAAI,SAAS,aAAa,EAAE,QAAQ,IAAI,CAAC;CAC9D,CAAC,CACH;CACA,WAAW,OAAO,MAAM,YAAY;EAClC,QAAQ,IAAI,6BAA6B,KAAK,GAAG,MAAM;CACzD,CAAC;CAED,MAAM,oBAAoB,WAAW,MAAM;CAC3C,QAAQ,KAAK,UAAU,WAAW;CAClC,QAAQ,KAAK,WAAW,WAAW;CACnC,WAAW,KAAK,eAAe;EAC7B,QAAQ,IAAI,UAAU,WAAW;EACjC,QAAQ,IAAI,WAAW,WAAW;CACpC,CAAC;AACH;;;AC3CA,eAAsB,IAAI,OAAuB,SAA8D;CAC7G,MAAM,YAAY,OAAO;AAC3B"}

package/dist/index.js

@@ -8,14 +8,14 @@ import { McpServer } from "tmcp";
 import { EventEmitter } from "node:events";
 import fs, { existsSync } from "node:fs";
 import path from "node:path";
-import { createKubb } from "@kubb/core";
+import { Diagnostics, createKubb, isProblemDiagnostic } from "@kubb/core";
 import { defineTool } from "tmcp/tool";
 import { tool } from "tmcp/utils";
 import * as v from "valibot";
 import { createJiti } from "jiti";
 import process$1 from "node:process";
 //#region package.json
-var version = "5.0.0-beta.36";
+var version = "5.0.0-beta.37";
 //#endregion
 //#region ../../internals/utils/src/errors.ts
 /**
@@ -131,6 +131,24 @@ var AsyncEventEmitter = class {
 		return this.#emitter.listenerCount(eventName);
 	}
 	/**
+	* Raises or lowers the per-event listener ceiling before Node warns about a memory leak.
+	* Set this above the expected listener count when many listeners attach by design.
+	*
+	* @example
+	* ```ts
+	* emitter.setMaxListeners(40)
+	* ```
+	*/
+	setMaxListeners(max) {
+		this.#emitter.setMaxListeners(max);
+	}
+	/**
+	* Returns the current per-event listener ceiling.
+	*/
+	getMaxListeners() {
+		return this.#emitter.getMaxListeners();
+	}
+	/**
 	* Removes all listeners from every event channel.
 	*
 	* @example
@@ -163,20 +181,37 @@ const generateSchema = v.object({
 	output: v.optional(v.pipe(v.string(), v.minLength(1), v.description("Output directory path (overrides config)"))),
 	logLevel: v.optional(v.pipe(v.picklist([
 		"silent",
-		"error",
-		"warn",
 		"info",
-		"verbose",
-		"debug"
+		"verbose"
 	]), v.description("Log level for build output")), "info")
 });
 //#endregion
+//#region src/utils/formatDiagnostics.ts
+/**
+* Renders serialized diagnostics as a plain-text block for an AI assistant. Each entry
+* keeps the stable `code`, the source pointer, the suggested fix, and the docs link, so
+* the agent can act on the problem rather than parsing a bare message. No ANSI styling,
+* unlike the CLI renderer.
+*/
+function formatDiagnostics(diagnostics) {
+	return diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)).join("\n\n");
+}
+function formatDiagnostic(diagnostic) {
+	const { code, severity, message, location, help, plugin, docsUrl } = diagnostic;
+	const lines = [`${severity} ${plugin ? `${plugin}(${code})` : code}: ${message}`];
+	if (location && "pointer" in location) lines.push(`  at ${location.pointer}`);
+	if (help) lines.push(`  help: ${help}`);
+	if (docsUrl) lines.push(`  docs: ${docsUrl}`);
+	return lines.join("\n");
+}
+//#endregion
 //#region src/types.ts
 const NotifyTypes = {
 	INFO: "INFO",
 	SUCCESS: "SUCCESS",
 	ERROR: "ERROR",
 	WARN: "WARN",
+	DIAGNOSTIC: "DIAGNOSTIC",
 	PLUGIN_START: "PLUGIN_START",
 	PLUGIN_END: "PLUGIN_END",
 	FILES_START: "FILES_START",
@@ -314,8 +349,8 @@ const generateTool = defineTool({
 	try {
 		const hooks = new AsyncEventEmitter();
 		const messages = [];
-		const notify = async (type, message, _data) => {
-			messages.push(`${type}: ${message}`);
+		const notify = async (type, message, data) => {
+			messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`);
 		};
 		hooks.on("kubb:info", async ({ message }) => {
 			await notify(NotifyTypes.INFO, message);
@@ -329,6 +364,9 @@ const generateTool = defineTool({
 		hooks.on("kubb:warn", async ({ message }) => {
 			await notify(NotifyTypes.WARN, message);
 		});
+		hooks.on("kubb:diagnostic", async ({ diagnostic }) => {
+			await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, Diagnostics.serialize(diagnostic));
+		});
 		hooks.on("kubb:plugin:start", async ({ plugin }) => {
 			await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`);
 		});
@@ -385,18 +423,20 @@ const generateTool = defineTool({
 		await kubb.setup();
 		await notify(NotifyTypes.SETUP_END, "Kubb setup complete");
 		await notify(NotifyTypes.BUILD_START, "Starting build");
-		const { files, failedPlugins, error } = await kubb.safeBuild();
+		const { files, diagnostics } = await kubb.safeBuild();
 		await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`);
-		if (error || failedPlugins.size > 0) {
-			const allErrors = [error, ...Array.from(failedPlugins).filter((it) => it.error).map((it) => it.error)].filter(Boolean);
-			await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`);
-			return tool.error(`Build failed:\n${allErrors.map((err) => err.message).join("\n")}\n\n${messages.join("\n")}`);
+		const problems = diagnostics.filter(isProblemDiagnostic);
+		const errors = problems.filter((diagnostic) => diagnostic.severity === "error");
+		if (errors.length > 0) {
+			await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${errors.length} diagnostic(s)`);
+			const serialized = problems.map((diagnostic) => Diagnostics.serialize(diagnostic));
+			return tool.error(`Build failed:\n${formatDiagnostics(serialized)}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``);
 		}
 		await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`);
 		return tool.text(`Build completed successfully!\n\nGenerated ${files.length} files\n\n${messages.join("\n")}`);
 	} catch (caughtError) {
-		const error = toError(caughtError);
-		return tool.error(`Build error: ${error.message}\n${error.stack ?? ""}`);
+		const serialized = Diagnostics.serialize(Diagnostics.from(caughtError));
+		return tool.error(`Build error:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``);
 	}
 });
 //#endregion
@@ -578,7 +618,8 @@ const validateTool = defineTool({
 		await mod.adapterOas().validate(input, { throwOnError: true });
 		return tool.text(`Validation successful: ${input}`);
 	} catch (err) {
-		return tool.error(`Validation failed:\n${err instanceof Error ? err.message : String(err)}`);
+		const serialized = Diagnostics.serialize(Diagnostics.from(err));
+		return tool.error(`Validation failed:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``);
 	}
 });
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#emitter","NodeEventEmitter","#emitAll","process"],"sources":["../package.json","../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/promise.ts","../src/schemas/generateSchema.ts","../src/types.ts","../src/constants.ts","../src/utils/loadUserConfig.ts","../src/utils/resolveCwd.ts","../src/utils/resolveUserConfig.ts","../src/tools/generate.ts","../../../internals/shared/src/constants.ts","../../../internals/shared/src/init.ts","../src/schemas/initSchema.ts","../src/tools/init.ts","../src/schemas/validateSchema.ts","../src/tools/validate.ts","../src/server.ts","../src/index.ts"],"sourcesContent":["","/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n  /**\n   * Maximum number of listeners per event before Node emits a memory-leak warning.\n   * @default 10\n   */\n  constructor(maxListener = 10) {\n    this.#emitter.setMaxListeners(maxListener)\n  }\n\n  #emitter = new NodeEventEmitter()\n\n  /**\n   * Emits `eventName` and awaits all registered listeners sequentially.\n   * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n   *\n   * @example\n   * ```ts\n   * await emitter.emit('build', 'petstore')\n   * ```\n   */\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> | void {\n    const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n    if (listeners.length === 0) {\n      return\n    }\n\n    return this.#emitAll(eventName, listeners, eventArgs)\n  }\n\n  async #emitAll<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listeners: Array<AsyncListener<TEvents[TEventName]>>,\n    eventArgs: TEvents[TEventName],\n  ): Promise<void> {\n    for (const listener of listeners) {\n      try {\n        await listener(...eventArgs)\n      } catch (err) {\n        let serializedArgs: string\n        try {\n          serializedArgs = JSON.stringify(eventArgs)\n        } catch {\n          serializedArgs = String(eventArgs)\n        }\n        throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n      }\n    }\n  }\n\n  /**\n   * Registers a persistent listener for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', async (name) => { console.log(name) })\n   * ```\n   */\n  on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Registers a one-shot listener that removes itself after the first invocation.\n   *\n   * @example\n   * ```ts\n   * emitter.onOnce('build', async (name) => { console.log(name) })\n   * ```\n   */\n  onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n      this.off(eventName, wrapper)\n      return handler(...args)\n    }\n    this.on(eventName, wrapper)\n  }\n\n  /**\n   * Removes a previously registered listener.\n   *\n   * @example\n   * ```ts\n   * emitter.off('build', handler)\n   * ```\n   */\n  off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Returns the number of listeners registered for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', handler)\n   * emitter.listenerCount('build') // 1\n   * ```\n   */\n  listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n    return this.#emitter.listenerCount(eventName)\n  }\n\n  /**\n   * Removes all listeners from every event channel.\n   *\n   * @example\n   * ```ts\n   * emitter.removeAll()\n   * ```\n   */\n  removeAll(): void {\n    this.#emitter.removeAllListeners()\n  }\n}\n","function* chunks<T>(arr: readonly T[], size: number): Generator<T[]> {\n  for (let i = 0; i < arr.length; i += size) {\n    yield arr.slice(i, i + size)\n  }\n}\n\nexport type ForBatchesOptions = {\n  /**\n   * Maximum batch size handed to `process`.\n   * Parallel dispatch within a batch is the caller's responsibility\n   * (typically via `Promise.all(batch.map(...))`).\n   */\n  concurrency: number\n  /**\n   * Called after every batch.\n   *\n   * Use a cheap, idempotent callback (e.g. one that short-circuits when there\n   * is nothing new to do). The helper does not coalesce calls — if you need\n   * throttling, do it inside `flush` itself.\n   */\n  flush?: () => Promise<void>\n}\n\n/**\n * Slices `source` into batches of `concurrency` items and awaits `process` for each batch.\n * Accepts both plain arrays (sync) and `AsyncIterable` (streaming).\n *\n * `process` controls whether items inside a batch run in parallel; this helper only\n * controls batch size and per-batch flushing.\n *\n * @example\n * ```ts\n * // parallel dispatch inside each batch\n * await forBatches(schemas, (batch) => Promise.all(batch.map(process)), { concurrency: 8 })\n *\n * // async iterable with a flush after every batch\n * await forBatches(stream.schemas, (batch) => dispatch(batch), { concurrency: 8, flush })\n * ```\n */\nexport async function forBatches<T>(\n  source: readonly T[] | AsyncIterable<T>,\n  process: (batch: T[]) => Promise<unknown>,\n  options: ForBatchesOptions,\n): Promise<void> {\n  const { concurrency, flush } = options\n\n  if (Array.isArray(source)) {\n    for (const batch of chunks(source, concurrency)) {\n      await process(batch)\n      if (flush) await flush()\n    }\n    return\n  }\n\n  const batch: T[] = []\n  for await (const item of source) {\n    batch.push(item)\n    if (batch.length >= concurrency) {\n      await process(batch.splice(0))\n\n      if (flush) await flush()\n    }\n  }\n  if (batch.length > 0) {\n    await process(batch.splice(0))\n\n    if (flush) await flush()\n  }\n}\n\n/**\n * Runs `work`, passing `flush` as its periodic-flush callback, then calls\n * `flush` once more to drain any items that did not cross a flush boundary.\n *\n * @example\n * ```ts\n * await withDrain(\n *   (flush) => processItems(items, { flush }),\n *   () => writeRemainingFiles(),\n * )\n * ```\n */\nexport async function withDrain(work: (flush: () => Promise<void>) => Promise<void>, flush: () => Promise<void>): Promise<void> {\n  await work(flush)\n  await flush()\n}\n\n/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n\n/**\n * Returns a wrapper that caches the result of the first invocation and replays\n * it for every subsequent call, ignoring later arguments.\n *\n * Works for sync and async factories — for async, the cached value is the\n * promise itself, so concurrent callers share one in-flight execution and\n * cannot race each other.\n *\n * @example\n * ```ts\n * const loadDocument = once(async (path: string) => parse(await readFile(path)))\n * const a = loadDocument('./a.yaml') // parses\n * const b = loadDocument('./b.yaml') // returns the cached promise from the first call\n * ```\n */\nexport function once<TArgs extends unknown[], TReturn>(factory: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn {\n  let cache: { value: TReturn } | undefined\n  return (...args: TArgs): TReturn => {\n    if (!cache) cache = { value: factory(...args) }\n    return cache.value\n  }\n}\n\ntype Store<TKey, TValue> = {\n  has(key: TKey): boolean\n  get(key: TKey): TValue | undefined\n  set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n  return (key: TKey): TValue => {\n    if (store.has(key)) return store.get(key)!\n    const value = factory(key)\n    store.set(key, value)\n    return value\n  }\n}\n\n/**\n * Wraps a plain array in a reusable `AsyncIterable`.\n * Each `[Symbol.asyncIterator]()` call returns a fresh generator so the\n * iterable can be consumed multiple times (e.g. once per plugin pre-scan).\n *\n * @example\n * ```ts\n * const stream = arrayToAsyncIterable([1, 2, 3])\n * for await (const n of stream) console.log(n) // 1, 2, 3\n * ```\n */\nexport function arrayToAsyncIterable<T>(arr: readonly T[]): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator]() {\n      return (async function* () {\n        yield* arr\n      })()\n    },\n  }\n}\n","import * as v from 'valibot'\n\nexport const generateSchema = v.object({\n  config: v.optional(\n    v.pipe(v.string(), v.minLength(1), v.description('Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory')),\n  ),\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),\n  logLevel: v.optional(\n    v.pipe(v.picklist(['silent', 'error', 'warn', 'info', 'verbose', 'debug']), v.description('Log level for build output')),\n    'info',\n  ),\n})\n","export const NotifyTypes = {\n  INFO: 'INFO',\n  SUCCESS: 'SUCCESS',\n  ERROR: 'ERROR',\n  WARN: 'WARN',\n  PLUGIN_START: 'PLUGIN_START',\n  PLUGIN_END: 'PLUGIN_END',\n  FILES_START: 'FILES_START',\n  FILES_UPDATE: 'FILES_UPDATE',\n  FILES_END: 'FILES_END',\n  GENERATION_START: 'GENERATION_START',\n  GENERATION_END: 'GENERATION_END',\n  CONFIG_LOADED: 'CONFIG_LOADED',\n  CONFIG_ERROR: 'CONFIG_ERROR',\n  CONFIG_READY: 'CONFIG_READY',\n  SETUP_START: 'SETUP_START',\n  SETUP_END: 'SETUP_END',\n  BUILD_START: 'BUILD_START',\n  BUILD_END: 'BUILD_END',\n  BUILD_FAILED: 'BUILD_FAILED',\n  BUILD_SUCCESS: 'BUILD_SUCCESS',\n  FATAL_ERROR: 'FATAL_ERROR',\n} as const\n","export const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])\n","import { existsSync } from 'node:fs'\nimport path from 'node:path'\nimport type { Config } from '@kubb/core'\nimport { createJiti } from 'jiti'\nimport { ALLOWED_CONFIG_EXTENSIONS } from '../constants.ts'\nimport { NotifyTypes } from '../types.ts'\n\ntype NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>\n\nconst jiti = createJiti(import.meta.url, {\n  jsx: {\n    runtime: 'automatic',\n    importSource: '@kubb/renderer-jsx',\n  },\n  moduleCache: false,\n})\n\nconst loadedModules = new Map<string, unknown>()\n\nasync function loadModule(filePath: string): Promise<unknown> {\n  const ext = path.extname(filePath)\n  if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n    throw new Error(`Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`)\n  }\n  if (loadedModules.has(filePath)) {\n    return loadedModules.get(filePath)\n  }\n  const mod = await jiti.import(filePath, { default: true })\n  loadedModules.set(filePath, mod)\n  return mod\n}\n\nexport async function loadUserConfig(configPath: string | undefined, { notify }: { notify: NotifyFunction }): Promise<{ userConfig: Config; cwd: string }> {\n  if (configPath) {\n    const ext = path.extname(configPath)\n    if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n      const msg = `Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const base = path.resolve(process.cwd())\n    const resolvedConfigPath = path.resolve(base, configPath)\n    const relative = path.relative(base, resolvedConfigPath)\n    if (relative.startsWith('..') || path.isAbsolute(relative)) {\n      const msg = 'Invalid config file path: must be within the current working directory'\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const cwd = path.dirname(resolvedConfigPath)\n    try {\n      const userConfig = (await loadModule(resolvedConfigPath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${resolvedConfigPath}`)\n      return { userConfig, cwd }\n    } catch (error) {\n      const msg = `Failed to load config: ${error instanceof Error ? error.message : String(error)}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n  }\n\n  const cwd = process.cwd()\n  const configFileNames = ['kubb.config.ts', 'kubb.config.mts', 'kubb.config.cts', 'kubb.config.js', 'kubb.config.cjs']\n\n  for (const configFileName of configFileNames) {\n    const configFilePath = path.resolve(process.cwd(), configFileName)\n    if (!existsSync(configFilePath)) continue\n    try {\n      const userConfig = (await loadModule(configFilePath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`)\n      return { userConfig, cwd }\n    } catch (err) {\n      await notify(NotifyTypes.CONFIG_ERROR, `Failed to load ${configFileName}: ${err instanceof Error ? err.message : String(err)}`)\n    }\n  }\n\n  await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')\n  throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)\n}\n","import path from 'node:path'\nimport type { Config } from '@kubb/core'\n\n/**\n * Determine the root directory based on userConfig.root and resolvedConfigDir\n * 1. If userConfig.root exists and is absolute, use it as-is\n * 2. If userConfig.root exists and is relative, resolve it relative to config directory\n * 3. Otherwise, use the config directory as root\n */\nexport function resolveCwd(userConfig: Config, cwd: string): string {\n  if (userConfig.root) {\n    if (path.isAbsolute(userConfig.root)) {\n      return userConfig.root\n    }\n\n    return path.resolve(cwd, userConfig.root)\n  }\n\n  return cwd\n}\n","import { isPromise } from '@internals/utils'\nimport type { CLIOptions, Config, PossibleConfig } from '@kubb/core'\n\nexport type ResolveUserConfigOptions = {\n  configPath?: string\n  logLevel?: string\n}\n\nexport async function resolveUserConfig(config: PossibleConfig<CLIOptions>, options: ResolveUserConfigOptions): Promise<Config> {\n  const result = typeof config === 'function' ? config({ logLevel: options.logLevel as CLIOptions['logLevel'], config: options.configPath }) : config\n  const resolved = isPromise(result) ? await result : result\n  return (Array.isArray(resolved) ? resolved[0] : resolved) as Config\n}\n","import { AsyncEventEmitter, toError } from '@internals/utils'\nimport { type Config, createKubb, type KubbHooks } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport type * as v from 'valibot'\nimport { generateSchema } from '../schemas/generateSchema.ts'\nimport { NotifyTypes } from '../types.ts'\nimport { loadUserConfig } from '../utils/loadUserConfig.ts'\nimport { resolveCwd } from '../utils/resolveCwd.ts'\nimport { resolveUserConfig } from '../utils/resolveUserConfig.ts'\n\nexport const generateTool = defineTool(\n  {\n    name: 'generate',\n    description: 'Generate OpenAPI spec helpers using Kubb configuration',\n    schema: generateSchema,\n  },\n  async function generate(schema: v.InferInput<typeof generateSchema>) {\n    const { config: configPath, input, output, logLevel } = schema\n\n    try {\n      const hooks = new AsyncEventEmitter<KubbHooks>()\n      const messages: Array<string> = []\n\n      const notify = async (type: string, message: string, _data?: Record<string, unknown>) => {\n        messages.push(`${type}: ${message}`)\n      }\n\n      hooks.on('kubb:info', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.INFO, message)\n      })\n\n      hooks.on('kubb:success', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.SUCCESS, message)\n      })\n\n      hooks.on('kubb:error', async ({ error }: { error: Error }) => {\n        await notify(NotifyTypes.ERROR, error.message)\n      })\n\n      hooks.on('kubb:warn', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.WARN, message)\n      })\n\n      hooks.on('kubb:plugin:start', async ({ plugin }) => {\n        await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)\n      })\n\n      hooks.on('kubb:plugin:end', async ({ plugin, duration }) => {\n        await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${plugin.name}`, { duration })\n      })\n\n      hooks.on('kubb:files:processing:start', async () => {\n        await notify(NotifyTypes.FILES_START, 'Starting file processing')\n      })\n\n      hooks.on('kubb:files:processing:update', async ({ files }: { files: Array<{ file: { name: string } }> }) => {\n        await notify(NotifyTypes.FILES_UPDATE, `Processing ${files.length} files`)\n      })\n\n      hooks.on('kubb:files:processing:end', async () => {\n        await notify(NotifyTypes.FILES_END, 'File processing complete')\n      })\n\n      hooks.on('kubb:generation:start', async () => {\n        await notify(NotifyTypes.GENERATION_START, 'Generation started')\n      })\n\n      hooks.on('kubb:generation:end', async () => {\n        await notify(NotifyTypes.GENERATION_END, 'Generation ended')\n      })\n\n      let userConfig: Config\n      let cwd: string\n\n      try {\n        const configResult = await loadUserConfig(configPath, { notify })\n        userConfig = configResult.userConfig\n        cwd = configResult.cwd\n\n        if (Array.isArray(userConfig)) {\n          throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')\n        }\n\n        userConfig = await resolveUserConfig(userConfig, {\n          configPath,\n          logLevel,\n        })\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error)\n        await notify(NotifyTypes.CONFIG_ERROR, errorMessage)\n        return tool.error(errorMessage)\n      }\n\n      const inputPath = input ?? (userConfig.input && 'path' in userConfig.input ? userConfig.input.path : undefined)\n\n      const config: Config = {\n        ...userConfig,\n        root: resolveCwd(userConfig, cwd),\n        input: inputPath\n          ? {\n              ...userConfig.input,\n              path: inputPath,\n            }\n          : userConfig.input,\n        output: output\n          ? {\n              ...userConfig.output,\n              path: output,\n            }\n          : userConfig.output,\n      }\n\n      await notify(NotifyTypes.CONFIG_READY, 'Configuration ready')\n      await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')\n\n      const kubb = createKubb(config, { hooks })\n      await kubb.setup()\n      await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')\n\n      await notify(NotifyTypes.BUILD_START, 'Starting build')\n      const { files, failedPlugins, error } = await kubb.safeBuild()\n      await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)\n\n      if (error || failedPlugins.size > 0) {\n        const allErrors: Array<Error> = [\n          error,\n          ...Array.from(failedPlugins)\n            .filter((it) => it.error)\n            .map((it) => it.error),\n        ].filter(Boolean)\n\n        await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`)\n\n        return tool.error(`Build failed:\\n${allErrors.map((err) => err.message).join('\\n')}\\n\\n${messages.join('\\n')}`)\n      }\n\n      await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)\n\n      return tool.text(`Build completed successfully!\\n\\nGenerated ${files.length} files\\n\\n${messages.join('\\n')}`)\n    } catch (caughtError) {\n      const error = toError(caughtError)\n      return tool.error(`Build error: ${error.message}\\n${error.stack ?? ''}`)\n    }\n  },\n)\n","import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: PluginOption[] = [\n  {\n    value: 'plugin-ts',\n    label: 'TypeScript',\n    hint: 'Recommended',\n    packageName: '@kubb/plugin-ts',\n    importName: 'pluginTs',\n    category: 'types',\n  },\n  {\n    value: 'plugin-client',\n    label: 'Client (Fetch/Axios)',\n    packageName: '@kubb/plugin-client',\n    importName: 'pluginClient',\n    category: 'client',\n  },\n  {\n    value: 'plugin-react-query',\n    label: 'React Query / TanStack Query',\n    packageName: '@kubb/plugin-react-query',\n    importName: 'pluginReactQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-vue-query',\n    label: 'Vue Query',\n    packageName: '@kubb/plugin-vue-query',\n    importName: 'pluginVueQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-zod',\n    label: 'Zod Schemas',\n    packageName: '@kubb/plugin-zod',\n    importName: 'pluginZod',\n    category: 'validation',\n  },\n  {\n    value: 'plugin-faker',\n    label: 'Faker.js Mocks',\n    packageName: '@kubb/plugin-faker',\n    importName: 'pluginFaker',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-msw',\n    label: 'MSW Handlers',\n    packageName: '@kubb/plugin-msw',\n    importName: 'pluginMsw',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-cypress',\n    label: 'Cypress Tests',\n    packageName: '@kubb/plugin-cypress',\n    importName: 'pluginCypress',\n    category: 'testing',\n  },\n  {\n    value: 'plugin-mcp',\n    label: 'MCP Server (AI / Model Context Protocol)',\n    packageName: '@kubb/plugin-mcp',\n    importName: 'pluginMcp',\n    category: 'ai',\n  },\n  {\n    value: 'plugin-redoc',\n    label: 'ReDoc Documentation',\n    packageName: '@kubb/plugin-redoc',\n    importName: 'pluginRedoc',\n    category: 'documentation',\n  },\n]\n\nexport const pluginDefaultConfigs = {\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n  'plugin-cypress': `pluginCypress({\n      output: { path: 'cypress' },\n    })`,\n  'plugin-mcp': `pluginMcp({\n      output: { path: 'mcp' },\n    })`,\n  'plugin-redoc': `pluginRedoc({\n      output: { path: 'redoc' },\n    })`,\n} as const satisfies Record<string, string>\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n  selectedPlugins,\n  inputPath,\n  outputPath,\n}: {\n  selectedPlugins: PluginOption[]\n  inputPath: string\n  outputPath: string\n}): string {\n  const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n  const pluginConfigs = selectedPlugins\n    .map((plugin) => {\n      const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n      return `    ${config},`\n    })\n    .join('\\n')\n\n  return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n  root: '.',\n  input: {\n    path: '${inputPath}',\n  },\n  output: {\n    path: '${outputPath}',\n    clean: true,\n  },\n  plugins: [\n${pluginConfigs}\n  ],\n})\n`\n}\n","import * as v from 'valibot'\n\nexport const initSchema = v.object({\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI spec (default: ./openapi.yaml)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory (default: ./src/gen)'))),\n  plugins: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Comma-separated list of plugins: plugin-ts,plugin-zod,...'))),\n})\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { availablePlugins, generateConfigFile, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { initSchema } from '../schemas/initSchema.ts'\n\nexport function resolvePlugins(pluginsFlag: string | undefined): Array<PluginOption> {\n  if (!pluginsFlag) {\n    return []\n  }\n  const requested = pluginsFlag\n    .split(',')\n    .map((v) => v.trim())\n    .filter(Boolean)\n  return availablePlugins.filter((p) => requested.includes(p.value))\n}\n\nexport const initTool = defineTool(\n  {\n    name: 'init',\n    description: 'Scaffold a kubb.config.ts in the current directory (non-interactive). Does not install packages.',\n    schema: initSchema,\n  },\n  async ({ input = './openapi.yaml', output = './src/gen', plugins }) => {\n    const selected = resolvePlugins(plugins)\n    const content = generateConfigFile({ selectedPlugins: selected, inputPath: input, outputPath: output })\n    const dest = path.join(process.cwd(), KUBB_CONFIG_FILENAME)\n    if (fs.existsSync(dest)) {\n      return tool.error(`${KUBB_CONFIG_FILENAME} already exists at ${dest}. Delete it first before running init again.`)\n    }\n    fs.writeFileSync(dest, content, 'utf-8')\n    const packageList = ['kubb', ...selected.map((p) => p.packageName)].join(' ')\n    return tool.text(`Created kubb.config.ts\\n\\nInstall packages:\\n  npm install ${packageList}\\n\\nThen run:\\n  npx kubb generate`)\n  },\n)\n","import * as v from 'valibot'\n\nexport const validateSchema = v.object({\n  input: v.pipe(v.string(), v.minLength(1), v.description('Path or URL to the OpenAPI/Swagger specification')),\n})\n","import { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { validateSchema } from '../schemas/validateSchema.ts'\n\nexport const validateTool = defineTool(\n  {\n    name: 'validate',\n    description: 'Validate an OpenAPI/Swagger specification file or URL',\n    schema: validateSchema,\n  },\n  async ({ input }) => {\n    let mod: typeof import('@kubb/adapter-oas')\n    try {\n      mod = await import('@kubb/adapter-oas')\n    } catch {\n      return tool.error('The validate tool requires @kubb/adapter-oas.\\nInstall: npm install @kubb/adapter-oas')\n    }\n    try {\n      await mod.adapterOas().validate(input, { throwOnError: true })\n      return tool.text(`Validation successful: ${input}`)\n    } catch (err) {\n      return tool.error(`Validation failed:\\n${err instanceof Error ? err.message : String(err)}`)\n    }\n  },\n)\n","import http from 'node:http'\nimport { createRequestListener } from '@remix-run/node-fetch-server'\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'\nimport { HttpTransport } from '@tmcp/transport-http'\nimport { StdioTransport } from '@tmcp/transport-stdio'\nimport { McpServer } from 'tmcp'\nimport { version } from '../package.json'\nimport { generateTool } from './tools/generate.ts'\nimport { initTool } from './tools/init.ts'\nimport { validateTool } from './tools/validate.ts'\n\nexport type ServerOptions = {\n  port?: number\n  host?: string\n}\n\nexport function createMcpServer() {\n  const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter(), capabilities: { tools: {} } })\n  server.tools([generateTool, validateTool, initTool])\n  return server\n}\n\nexport async function startServer({ port, host = 'localhost' }: ServerOptions = {}) {\n  const server = createMcpServer()\n\n  if (port === undefined) {\n    new StdioTransport(server).listen()\n    return\n  }\n\n  const transport = new HttpTransport(server, { path: '/mcp' })\n  const httpServer = http.createServer(\n    createRequestListener(async (request) => {\n      const response = await transport.respond(request)\n      return response ?? new Response('Not Found', { status: 404 })\n    }),\n  )\n  httpServer.listen(port, host, () => {\n    console.log(`Kubb MCP server on http://${host}:${port}`)\n  })\n\n  const closeServer = () => httpServer.close()\n  process.once('SIGINT', closeServer)\n  process.once('SIGTERM', closeServer)\n  httpServer.once('close', () => {\n    process.off('SIGINT', closeServer)\n    process.off('SIGTERM', closeServer)\n  })\n}\n","import { startServer } from './server.ts'\n\nexport { createMcpServer } from './server.ts'\nexport type { ServerOptions } from './server.ts'\n\nexport async function run(_argv?: Array<string>, options?: import('./server.ts').ServerOptions): Promise<void> {\n  await startServer(options)\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#emitter","NodeEventEmitter","#emitAll","process"],"sources":["../package.json","../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/promise.ts","../src/schemas/generateSchema.ts","../src/utils/formatDiagnostics.ts","../src/types.ts","../src/constants.ts","../src/utils/loadUserConfig.ts","../src/utils/resolveCwd.ts","../src/utils/resolveUserConfig.ts","../src/tools/generate.ts","../../../internals/shared/src/constants.ts","../../../internals/shared/src/init.ts","../src/schemas/initSchema.ts","../src/tools/init.ts","../src/schemas/validateSchema.ts","../src/tools/validate.ts","../src/server.ts","../src/index.ts"],"sourcesContent":["","/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n  /**\n   * Maximum number of listeners per event before Node emits a memory-leak warning.\n   * @default 10\n   */\n  constructor(maxListener = 10) {\n    this.#emitter.setMaxListeners(maxListener)\n  }\n\n  #emitter = new NodeEventEmitter()\n\n  /**\n   * Emits `eventName` and awaits all registered listeners sequentially.\n   * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n   *\n   * @example\n   * ```ts\n   * await emitter.emit('build', 'petstore')\n   * ```\n   */\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> | void {\n    const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n    if (listeners.length === 0) {\n      return\n    }\n\n    return this.#emitAll(eventName, listeners, eventArgs)\n  }\n\n  async #emitAll<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listeners: Array<AsyncListener<TEvents[TEventName]>>,\n    eventArgs: TEvents[TEventName],\n  ): Promise<void> {\n    for (const listener of listeners) {\n      try {\n        await listener(...eventArgs)\n      } catch (err) {\n        let serializedArgs: string\n        try {\n          serializedArgs = JSON.stringify(eventArgs)\n        } catch {\n          serializedArgs = String(eventArgs)\n        }\n        throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n      }\n    }\n  }\n\n  /**\n   * Registers a persistent listener for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', async (name) => { console.log(name) })\n   * ```\n   */\n  on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Registers a one-shot listener that removes itself after the first invocation.\n   *\n   * @example\n   * ```ts\n   * emitter.onOnce('build', async (name) => { console.log(name) })\n   * ```\n   */\n  onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n      this.off(eventName, wrapper)\n      return handler(...args)\n    }\n    this.on(eventName, wrapper)\n  }\n\n  /**\n   * Removes a previously registered listener.\n   *\n   * @example\n   * ```ts\n   * emitter.off('build', handler)\n   * ```\n   */\n  off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n    this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n  }\n\n  /**\n   * Returns the number of listeners registered for `eventName`.\n   *\n   * @example\n   * ```ts\n   * emitter.on('build', handler)\n   * emitter.listenerCount('build') // 1\n   * ```\n   */\n  listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n    return this.#emitter.listenerCount(eventName)\n  }\n\n  /**\n   * Raises or lowers the per-event listener ceiling before Node warns about a memory leak.\n   * Set this above the expected listener count when many listeners attach by design.\n   *\n   * @example\n   * ```ts\n   * emitter.setMaxListeners(40)\n   * ```\n   */\n  setMaxListeners(max: number): void {\n    this.#emitter.setMaxListeners(max)\n  }\n\n  /**\n   * Returns the current per-event listener ceiling.\n   */\n  getMaxListeners(): number {\n    return this.#emitter.getMaxListeners()\n  }\n\n  /**\n   * Removes all listeners from every event channel.\n   *\n   * @example\n   * ```ts\n   * emitter.removeAll()\n   * ```\n   */\n  removeAll(): void {\n    this.#emitter.removeAllListeners()\n  }\n}\n","function* chunks<T>(arr: readonly T[], size: number): Generator<T[]> {\n  for (let i = 0; i < arr.length; i += size) {\n    yield arr.slice(i, i + size)\n  }\n}\n\nexport type ForBatchesOptions = {\n  /**\n   * Maximum batch size handed to `process`.\n   * Parallel dispatch within a batch is the caller's responsibility\n   * (typically via `Promise.all(batch.map(...))`).\n   */\n  concurrency: number\n  /**\n   * Called after every batch.\n   *\n   * Use a cheap, idempotent callback (e.g. one that short-circuits when there\n   * is nothing new to do). The helper does not coalesce calls — if you need\n   * throttling, do it inside `flush` itself.\n   */\n  flush?: () => Promise<void>\n}\n\n/**\n * Slices `source` into batches of `concurrency` items and awaits `process` for each batch.\n * Accepts both plain arrays (sync) and `AsyncIterable` (streaming).\n *\n * `process` controls whether items inside a batch run in parallel; this helper only\n * controls batch size and per-batch flushing.\n *\n * @example\n * ```ts\n * // parallel dispatch inside each batch\n * await forBatches(schemas, (batch) => Promise.all(batch.map(process)), { concurrency: 8 })\n *\n * // async iterable with a flush after every batch\n * await forBatches(stream.schemas, (batch) => dispatch(batch), { concurrency: 8, flush })\n * ```\n */\nexport async function forBatches<T>(\n  source: readonly T[] | AsyncIterable<T>,\n  process: (batch: T[]) => Promise<unknown>,\n  options: ForBatchesOptions,\n): Promise<void> {\n  const { concurrency, flush } = options\n\n  if (Array.isArray(source)) {\n    for (const batch of chunks(source, concurrency)) {\n      await process(batch)\n      if (flush) await flush()\n    }\n    return\n  }\n\n  const batch: T[] = []\n  for await (const item of source) {\n    batch.push(item)\n    if (batch.length >= concurrency) {\n      await process(batch.splice(0))\n\n      if (flush) await flush()\n    }\n  }\n  if (batch.length > 0) {\n    await process(batch.splice(0))\n\n    if (flush) await flush()\n  }\n}\n\n/**\n * Runs `work`, passing `flush` as its periodic-flush callback, then calls\n * `flush` once more to drain any items that did not cross a flush boundary.\n *\n * @example\n * ```ts\n * await withDrain(\n *   (flush) => processItems(items, { flush }),\n *   () => writeRemainingFiles(),\n * )\n * ```\n */\nexport async function withDrain(work: (flush: () => Promise<void>) => Promise<void>, flush: () => Promise<void>): Promise<void> {\n  await work(flush)\n  await flush()\n}\n\n/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n\n/**\n * Returns a wrapper that caches the result of the first invocation and replays\n * it for every subsequent call, ignoring later arguments.\n *\n * Works for sync and async factories — for async, the cached value is the\n * promise itself, so concurrent callers share one in-flight execution and\n * cannot race each other.\n *\n * @example\n * ```ts\n * const loadDocument = once(async (path: string) => parse(await readFile(path)))\n * const a = loadDocument('./a.yaml') // parses\n * const b = loadDocument('./b.yaml') // returns the cached promise from the first call\n * ```\n */\nexport function once<TArgs extends unknown[], TReturn>(factory: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn {\n  let cache: { value: TReturn } | undefined\n  return (...args: TArgs): TReturn => {\n    if (!cache) cache = { value: factory(...args) }\n    return cache.value\n  }\n}\n\ntype Store<TKey, TValue> = {\n  has(key: TKey): boolean\n  get(key: TKey): TValue | undefined\n  set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n  return (key: TKey): TValue => {\n    if (store.has(key)) return store.get(key)!\n    const value = factory(key)\n    store.set(key, value)\n    return value\n  }\n}\n\n/**\n * Wraps a plain array in a reusable `AsyncIterable`.\n * Each `[Symbol.asyncIterator]()` call returns a fresh generator so the\n * iterable can be consumed multiple times (e.g. once per plugin pre-scan).\n *\n * @example\n * ```ts\n * const stream = arrayToAsyncIterable([1, 2, 3])\n * for await (const n of stream) console.log(n) // 1, 2, 3\n * ```\n */\nexport function arrayToAsyncIterable<T>(arr: readonly T[]): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator]() {\n      return (async function* () {\n        yield* arr\n      })()\n    },\n  }\n}\n","import * as v from 'valibot'\n\nexport const generateSchema = v.object({\n  config: v.optional(\n    v.pipe(v.string(), v.minLength(1), v.description('Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory')),\n  ),\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),\n  logLevel: v.optional(\n    v.pipe(v.picklist(['silent', 'info', 'verbose']), v.description('Log level for build output')),\n    'info',\n  ),\n})\n","import type { SerializedDiagnostic } from '@kubb/core'\n\n/**\n * Renders serialized diagnostics as a plain-text block for an AI assistant. Each entry\n * keeps the stable `code`, the source pointer, the suggested fix, and the docs link, so\n * the agent can act on the problem rather than parsing a bare message. No ANSI styling,\n * unlike the CLI renderer.\n */\nexport function formatDiagnostics(diagnostics: ReadonlyArray<SerializedDiagnostic>): string {\n  return diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)).join('\\n\\n')\n}\n\nfunction formatDiagnostic(diagnostic: SerializedDiagnostic): string {\n  const { code, severity, message, location, help, plugin, docsUrl } = diagnostic\n  const rule = plugin ? `${plugin}(${code})` : code\n  const lines = [`${severity} ${rule}: ${message}`]\n\n  if (location && 'pointer' in location) {\n    lines.push(`  at ${location.pointer}`)\n  }\n  if (help) {\n    lines.push(`  help: ${help}`)\n  }\n  if (docsUrl) {\n    lines.push(`  docs: ${docsUrl}`)\n  }\n\n  return lines.join('\\n')\n}\n","export const NotifyTypes = {\n  INFO: 'INFO',\n  SUCCESS: 'SUCCESS',\n  ERROR: 'ERROR',\n  WARN: 'WARN',\n  DIAGNOSTIC: 'DIAGNOSTIC',\n  PLUGIN_START: 'PLUGIN_START',\n  PLUGIN_END: 'PLUGIN_END',\n  FILES_START: 'FILES_START',\n  FILES_UPDATE: 'FILES_UPDATE',\n  FILES_END: 'FILES_END',\n  GENERATION_START: 'GENERATION_START',\n  GENERATION_END: 'GENERATION_END',\n  CONFIG_LOADED: 'CONFIG_LOADED',\n  CONFIG_ERROR: 'CONFIG_ERROR',\n  CONFIG_READY: 'CONFIG_READY',\n  SETUP_START: 'SETUP_START',\n  SETUP_END: 'SETUP_END',\n  BUILD_START: 'BUILD_START',\n  BUILD_END: 'BUILD_END',\n  BUILD_FAILED: 'BUILD_FAILED',\n  BUILD_SUCCESS: 'BUILD_SUCCESS',\n  FATAL_ERROR: 'FATAL_ERROR',\n} as const\n","export const ALLOWED_CONFIG_EXTENSIONS = new Set(['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'])\n","import { existsSync } from 'node:fs'\nimport path from 'node:path'\nimport type { Config } from '@kubb/core'\nimport { createJiti } from 'jiti'\nimport { ALLOWED_CONFIG_EXTENSIONS } from '../constants.ts'\nimport { NotifyTypes } from '../types.ts'\n\ntype NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>\n\nconst jiti = createJiti(import.meta.url, {\n  jsx: {\n    runtime: 'automatic',\n    importSource: '@kubb/renderer-jsx',\n  },\n  moduleCache: false,\n})\n\nconst loadedModules = new Map<string, unknown>()\n\nasync function loadModule(filePath: string): Promise<unknown> {\n  const ext = path.extname(filePath)\n  if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n    throw new Error(`Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`)\n  }\n  if (loadedModules.has(filePath)) {\n    return loadedModules.get(filePath)\n  }\n  const mod = await jiti.import(filePath, { default: true })\n  loadedModules.set(filePath, mod)\n  return mod\n}\n\nexport async function loadUserConfig(configPath: string | undefined, { notify }: { notify: NotifyFunction }): Promise<{ userConfig: Config; cwd: string }> {\n  if (configPath) {\n    const ext = path.extname(configPath)\n    if (!ALLOWED_CONFIG_EXTENSIONS.has(ext)) {\n      const msg = `Invalid config file extension \"${ext}\". Allowed: ${[...ALLOWED_CONFIG_EXTENSIONS].join(', ')}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const base = path.resolve(process.cwd())\n    const resolvedConfigPath = path.resolve(base, configPath)\n    const relative = path.relative(base, resolvedConfigPath)\n    if (relative.startsWith('..') || path.isAbsolute(relative)) {\n      const msg = 'Invalid config file path: must be within the current working directory'\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n    const cwd = path.dirname(resolvedConfigPath)\n    try {\n      const userConfig = (await loadModule(resolvedConfigPath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${resolvedConfigPath}`)\n      return { userConfig, cwd }\n    } catch (error) {\n      const msg = `Failed to load config: ${error instanceof Error ? error.message : String(error)}`\n      await notify(NotifyTypes.CONFIG_ERROR, msg)\n      throw new Error(msg)\n    }\n  }\n\n  const cwd = process.cwd()\n  const configFileNames = ['kubb.config.ts', 'kubb.config.mts', 'kubb.config.cts', 'kubb.config.js', 'kubb.config.cjs']\n\n  for (const configFileName of configFileNames) {\n    const configFilePath = path.resolve(process.cwd(), configFileName)\n    if (!existsSync(configFilePath)) continue\n    try {\n      const userConfig = (await loadModule(configFilePath)) as Config\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`)\n      return { userConfig, cwd }\n    } catch (err) {\n      await notify(NotifyTypes.CONFIG_ERROR, `Failed to load ${configFileName}: ${err instanceof Error ? err.message : String(err)}`)\n    }\n  }\n\n  await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')\n  throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)\n}\n","import path from 'node:path'\nimport type { Config } from '@kubb/core'\n\n/**\n * Determine the root directory based on userConfig.root and resolvedConfigDir\n * 1. If userConfig.root exists and is absolute, use it as-is\n * 2. If userConfig.root exists and is relative, resolve it relative to config directory\n * 3. Otherwise, use the config directory as root\n */\nexport function resolveCwd(userConfig: Config, cwd: string): string {\n  if (userConfig.root) {\n    if (path.isAbsolute(userConfig.root)) {\n      return userConfig.root\n    }\n\n    return path.resolve(cwd, userConfig.root)\n  }\n\n  return cwd\n}\n","import { isPromise } from '@internals/utils'\nimport type { CLIOptions, Config, PossibleConfig } from '@kubb/core'\n\nexport type ResolveUserConfigOptions = {\n  configPath?: string\n  logLevel?: string\n}\n\nexport async function resolveUserConfig(config: PossibleConfig<CLIOptions>, options: ResolveUserConfigOptions): Promise<Config> {\n  const result = typeof config === 'function' ? config({ logLevel: options.logLevel as CLIOptions['logLevel'], config: options.configPath }) : config\n  const resolved = isPromise(result) ? await result : result\n  return (Array.isArray(resolved) ? resolved[0] : resolved) as Config\n}\n","import { AsyncEventEmitter } from '@internals/utils'\nimport { type Config, createKubb, type Diagnostic, Diagnostics, isProblemDiagnostic, type KubbHooks } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport type * as v from 'valibot'\nimport { generateSchema } from '../schemas/generateSchema.ts'\nimport { formatDiagnostics } from '../utils/formatDiagnostics.ts'\nimport { NotifyTypes } from '../types.ts'\nimport { loadUserConfig } from '../utils/loadUserConfig.ts'\nimport { resolveCwd } from '../utils/resolveCwd.ts'\nimport { resolveUserConfig } from '../utils/resolveUserConfig.ts'\n\nexport const generateTool = defineTool(\n  {\n    name: 'generate',\n    description: 'Generate OpenAPI spec helpers using Kubb configuration',\n    schema: generateSchema,\n  },\n  async function generate(schema: v.InferInput<typeof generateSchema>) {\n    const { config: configPath, input, output, logLevel } = schema\n\n    try {\n      const hooks = new AsyncEventEmitter<KubbHooks>()\n      const messages: Array<string> = []\n\n      const notify = async (type: string, message: string, data?: Record<string, unknown>) => {\n        messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`)\n      }\n\n      hooks.on('kubb:info', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.INFO, message)\n      })\n\n      hooks.on('kubb:success', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.SUCCESS, message)\n      })\n\n      hooks.on('kubb:error', async ({ error }: { error: Error }) => {\n        await notify(NotifyTypes.ERROR, error.message)\n      })\n\n      hooks.on('kubb:warn', async ({ message }: { message: string }) => {\n        await notify(NotifyTypes.WARN, message)\n      })\n\n      hooks.on('kubb:diagnostic', async ({ diagnostic }: { diagnostic: Diagnostic }) => {\n        await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, Diagnostics.serialize(diagnostic))\n      })\n\n      hooks.on('kubb:plugin:start', async ({ plugin }) => {\n        await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)\n      })\n\n      hooks.on('kubb:plugin:end', async ({ plugin, duration }) => {\n        await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${plugin.name}`, { duration })\n      })\n\n      hooks.on('kubb:files:processing:start', async () => {\n        await notify(NotifyTypes.FILES_START, 'Starting file processing')\n      })\n\n      hooks.on('kubb:files:processing:update', async ({ files }: { files: Array<{ file: { name: string } }> }) => {\n        await notify(NotifyTypes.FILES_UPDATE, `Processing ${files.length} files`)\n      })\n\n      hooks.on('kubb:files:processing:end', async () => {\n        await notify(NotifyTypes.FILES_END, 'File processing complete')\n      })\n\n      hooks.on('kubb:generation:start', async () => {\n        await notify(NotifyTypes.GENERATION_START, 'Generation started')\n      })\n\n      hooks.on('kubb:generation:end', async () => {\n        await notify(NotifyTypes.GENERATION_END, 'Generation ended')\n      })\n\n      let userConfig: Config\n      let cwd: string\n\n      try {\n        const configResult = await loadUserConfig(configPath, { notify })\n        userConfig = configResult.userConfig\n        cwd = configResult.cwd\n\n        if (Array.isArray(userConfig)) {\n          throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')\n        }\n\n        userConfig = await resolveUserConfig(userConfig, {\n          configPath,\n          logLevel,\n        })\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error)\n        await notify(NotifyTypes.CONFIG_ERROR, errorMessage)\n        return tool.error(errorMessage)\n      }\n\n      const inputPath = input ?? (userConfig.input && 'path' in userConfig.input ? userConfig.input.path : undefined)\n\n      const config: Config = {\n        ...userConfig,\n        root: resolveCwd(userConfig, cwd),\n        input: inputPath\n          ? {\n              ...userConfig.input,\n              path: inputPath,\n            }\n          : userConfig.input,\n        output: output\n          ? {\n              ...userConfig.output,\n              path: output,\n            }\n          : userConfig.output,\n      }\n\n      await notify(NotifyTypes.CONFIG_READY, 'Configuration ready')\n      await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')\n\n      const kubb = createKubb(config, { hooks })\n      await kubb.setup()\n      await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')\n\n      await notify(NotifyTypes.BUILD_START, 'Starting build')\n      const { files, diagnostics } = await kubb.safeBuild()\n      await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)\n\n      const problems = diagnostics.filter(isProblemDiagnostic)\n      const errors = problems.filter((diagnostic) => diagnostic.severity === 'error')\n      if (errors.length > 0) {\n        await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${errors.length} diagnostic(s)`)\n\n        const serialized = problems.map((diagnostic) => Diagnostics.serialize(diagnostic))\n        return tool.error(`Build failed:\\n${formatDiagnostics(serialized)}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n      }\n\n      await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)\n\n      return tool.text(`Build completed successfully!\\n\\nGenerated ${files.length} files\\n\\n${messages.join('\\n')}`)\n    } catch (caughtError) {\n      const serialized = Diagnostics.serialize(Diagnostics.from(caughtError))\n      return tool.error(`Build error:\\n${formatDiagnostics([serialized])}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n    }\n  },\n)\n","import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: PluginOption[] = [\n  {\n    value: 'plugin-ts',\n    label: 'TypeScript',\n    hint: 'Recommended',\n    packageName: '@kubb/plugin-ts',\n    importName: 'pluginTs',\n    category: 'types',\n  },\n  {\n    value: 'plugin-client',\n    label: 'Client (Fetch/Axios)',\n    packageName: '@kubb/plugin-client',\n    importName: 'pluginClient',\n    category: 'client',\n  },\n  {\n    value: 'plugin-react-query',\n    label: 'React Query / TanStack Query',\n    packageName: '@kubb/plugin-react-query',\n    importName: 'pluginReactQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-vue-query',\n    label: 'Vue Query',\n    packageName: '@kubb/plugin-vue-query',\n    importName: 'pluginVueQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-zod',\n    label: 'Zod Schemas',\n    packageName: '@kubb/plugin-zod',\n    importName: 'pluginZod',\n    category: 'validation',\n  },\n  {\n    value: 'plugin-faker',\n    label: 'Faker.js Mocks',\n    packageName: '@kubb/plugin-faker',\n    importName: 'pluginFaker',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-msw',\n    label: 'MSW Handlers',\n    packageName: '@kubb/plugin-msw',\n    importName: 'pluginMsw',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-cypress',\n    label: 'Cypress Tests',\n    packageName: '@kubb/plugin-cypress',\n    importName: 'pluginCypress',\n    category: 'testing',\n  },\n  {\n    value: 'plugin-mcp',\n    label: 'MCP Server (AI / Model Context Protocol)',\n    packageName: '@kubb/plugin-mcp',\n    importName: 'pluginMcp',\n    category: 'ai',\n  },\n  {\n    value: 'plugin-redoc',\n    label: 'ReDoc Documentation',\n    packageName: '@kubb/plugin-redoc',\n    importName: 'pluginRedoc',\n    category: 'documentation',\n  },\n]\n\nexport const pluginDefaultConfigs = {\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n  'plugin-cypress': `pluginCypress({\n      output: { path: 'cypress' },\n    })`,\n  'plugin-mcp': `pluginMcp({\n      output: { path: 'mcp' },\n    })`,\n  'plugin-redoc': `pluginRedoc({\n      output: { path: 'redoc' },\n    })`,\n} as const satisfies Record<string, string>\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n  selectedPlugins,\n  inputPath,\n  outputPath,\n}: {\n  selectedPlugins: PluginOption[]\n  inputPath: string\n  outputPath: string\n}): string {\n  const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n  const pluginConfigs = selectedPlugins\n    .map((plugin) => {\n      const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n      return `    ${config},`\n    })\n    .join('\\n')\n\n  return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n  root: '.',\n  input: {\n    path: '${inputPath}',\n  },\n  output: {\n    path: '${outputPath}',\n    clean: true,\n  },\n  plugins: [\n${pluginConfigs}\n  ],\n})\n`\n}\n","import * as v from 'valibot'\n\nexport const initSchema = v.object({\n  input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI spec (default: ./openapi.yaml)'))),\n  output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory (default: ./src/gen)'))),\n  plugins: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Comma-separated list of plugins: plugin-ts,plugin-zod,...'))),\n})\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { availablePlugins, generateConfigFile, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { initSchema } from '../schemas/initSchema.ts'\n\nexport function resolvePlugins(pluginsFlag: string | undefined): Array<PluginOption> {\n  if (!pluginsFlag) {\n    return []\n  }\n  const requested = pluginsFlag\n    .split(',')\n    .map((v) => v.trim())\n    .filter(Boolean)\n  return availablePlugins.filter((p) => requested.includes(p.value))\n}\n\nexport const initTool = defineTool(\n  {\n    name: 'init',\n    description: 'Scaffold a kubb.config.ts in the current directory (non-interactive). Does not install packages.',\n    schema: initSchema,\n  },\n  async ({ input = './openapi.yaml', output = './src/gen', plugins }) => {\n    const selected = resolvePlugins(plugins)\n    const content = generateConfigFile({ selectedPlugins: selected, inputPath: input, outputPath: output })\n    const dest = path.join(process.cwd(), KUBB_CONFIG_FILENAME)\n    if (fs.existsSync(dest)) {\n      return tool.error(`${KUBB_CONFIG_FILENAME} already exists at ${dest}. Delete it first before running init again.`)\n    }\n    fs.writeFileSync(dest, content, 'utf-8')\n    const packageList = ['kubb', ...selected.map((p) => p.packageName)].join(' ')\n    return tool.text(`Created kubb.config.ts\\n\\nInstall packages:\\n  npm install ${packageList}\\n\\nThen run:\\n  npx kubb generate`)\n  },\n)\n","import * as v from 'valibot'\n\nexport const validateSchema = v.object({\n  input: v.pipe(v.string(), v.minLength(1), v.description('Path or URL to the OpenAPI/Swagger specification')),\n})\n","import { Diagnostics } from '@kubb/core'\nimport { defineTool } from 'tmcp/tool'\nimport { tool } from 'tmcp/utils'\nimport { validateSchema } from '../schemas/validateSchema.ts'\nimport { formatDiagnostics } from '../utils/formatDiagnostics.ts'\n\nexport const validateTool = defineTool(\n  {\n    name: 'validate',\n    description: 'Validate an OpenAPI/Swagger specification file or URL',\n    schema: validateSchema,\n  },\n  async ({ input }) => {\n    let mod: typeof import('@kubb/adapter-oas')\n    try {\n      mod = await import('@kubb/adapter-oas')\n    } catch {\n      return tool.error('The validate tool requires @kubb/adapter-oas.\\nInstall: npm install @kubb/adapter-oas')\n    }\n    try {\n      await mod.adapterOas().validate(input, { throwOnError: true })\n      return tool.text(`Validation successful: ${input}`)\n    } catch (err) {\n      const serialized = Diagnostics.serialize(Diagnostics.from(err))\n      return tool.error(`Validation failed:\\n${formatDiagnostics([serialized])}\\n\\n\\`\\`\\`json\\n${JSON.stringify(serialized, null, 2)}\\n\\`\\`\\``)\n    }\n  },\n)\n","import http from 'node:http'\nimport { createRequestListener } from '@remix-run/node-fetch-server'\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot'\nimport { HttpTransport } from '@tmcp/transport-http'\nimport { StdioTransport } from '@tmcp/transport-stdio'\nimport { McpServer } from 'tmcp'\nimport { version } from '../package.json'\nimport { generateTool } from './tools/generate.ts'\nimport { initTool } from './tools/init.ts'\nimport { validateTool } from './tools/validate.ts'\n\nexport type ServerOptions = {\n  port?: number\n  host?: string\n}\n\nexport function createMcpServer() {\n  const server = new McpServer({ name: 'Kubb', version }, { adapter: new ValibotJsonSchemaAdapter(), capabilities: { tools: {} } })\n  server.tools([generateTool, validateTool, initTool])\n  return server\n}\n\nexport async function startServer({ port, host = 'localhost' }: ServerOptions = {}) {\n  const server = createMcpServer()\n\n  if (port === undefined) {\n    new StdioTransport(server).listen()\n    return\n  }\n\n  const transport = new HttpTransport(server, { path: '/mcp' })\n  const httpServer = http.createServer(\n    createRequestListener(async (request) => {\n      const response = await transport.respond(request)\n      return response ?? new Response('Not Found', { status: 404 })\n    }),\n  )\n  httpServer.listen(port, host, () => {\n    console.log(`Kubb MCP server on http://${host}:${port}`)\n  })\n\n  const closeServer = () => httpServer.close()\n  process.once('SIGINT', closeServer)\n  process.once('SIGTERM', closeServer)\n  httpServer.once('close', () => {\n    process.off('SIGINT', closeServer)\n    process.off('SIGTERM', closeServer)\n  })\n}\n","import { startServer } from './server.ts'\n\nexport { createMcpServer } from './server.ts'\nexport type { ServerOptions } from './server.ts'\n\nexport async function run(_argv?: Array<string>, options?: import('./server.ts').ServerOptions): Promise<void> {\n  await startServer(options)\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/mcp",
-  "version": "5.0.0-beta.36",
+  "version": "5.0.0-beta.37",
   "description": "MCP server for Kubb. Exposes code generation as a tool over the Model Context Protocol so AI assistants like Claude, Cursor, and other MCP-compatible clients can generate TypeScript types, clients, and more from OpenAPI specs.",
   "keywords": [
     "ai",
@@ -54,16 +54,16 @@
     "jiti": "^2.7.0",
     "tmcp": "^1.19.4",
     "valibot": "^1.4.1",
-    "@kubb/adapter-oas": "5.0.0-beta.36",
-    "@kubb/core": "5.0.0-beta.36"
+    "@kubb/adapter-oas": "5.0.0-beta.37",
+    "@kubb/core": "5.0.0-beta.37"
   },
   "devDependencies": {
     "@internals/shared": "0.0.0",
     "@internals/utils": "0.0.0",
-    "@kubb/renderer-jsx": "5.0.0-beta.36"
+    "@kubb/renderer-jsx": "5.0.0-beta.37"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.36"
+    "@kubb/renderer-jsx": "5.0.0-beta.37"
   },
   "size-limit": [
     {

package/src/schemas/generateSchema.ts

@@ -7,7 +7,7 @@ export const generateSchema = v.object({
   input: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Path to OpenAPI/Swagger spec file (overrides config)'))),
   output: v.optional(v.pipe(v.string(), v.minLength(1), v.description('Output directory path (overrides config)'))),
   logLevel: v.optional(
-    v.pipe(v.picklist(['silent', 'error', 'warn', 'info', 'verbose', 'debug']), v.description('Log level for build output')),
+    v.pipe(v.picklist(['silent', 'info', 'verbose']), v.description('Log level for build output')),
     'info',
   ),
 })

package/src/tools/generate.ts

@@ -1,9 +1,10 @@
-import { AsyncEventEmitter, toError } from '@internals/utils'
-import { type Config, createKubb, type KubbHooks } from '@kubb/core'
+import { AsyncEventEmitter } from '@internals/utils'
+import { type Config, createKubb, type Diagnostic, Diagnostics, isProblemDiagnostic, type KubbHooks } from '@kubb/core'
 import { defineTool } from 'tmcp/tool'
 import { tool } from 'tmcp/utils'
 import type * as v from 'valibot'
 import { generateSchema } from '../schemas/generateSchema.ts'
+import { formatDiagnostics } from '../utils/formatDiagnostics.ts'
 import { NotifyTypes } from '../types.ts'
 import { loadUserConfig } from '../utils/loadUserConfig.ts'
 import { resolveCwd } from '../utils/resolveCwd.ts'
@@ -22,8 +23,8 @@ export const generateTool = defineTool(
       const hooks = new AsyncEventEmitter<KubbHooks>()
       const messages: Array<string> = []
 
-      const notify = async (type: string, message: string, _data?: Record<string, unknown>) => {
-        messages.push(`${type}: ${message}`)
+      const notify = async (type: string, message: string, data?: Record<string, unknown>) => {
+        messages.push(data ? `${type}: ${message} ${JSON.stringify(data)}` : `${type}: ${message}`)
       }
 
       hooks.on('kubb:info', async ({ message }: { message: string }) => {
@@ -42,6 +43,10 @@ export const generateTool = defineTool(
         await notify(NotifyTypes.WARN, message)
       })
 
+      hooks.on('kubb:diagnostic', async ({ diagnostic }: { diagnostic: Diagnostic }) => {
+        await notify(NotifyTypes.DIAGNOSTIC, diagnostic.message, Diagnostics.serialize(diagnostic))
+      })
+
       hooks.on('kubb:plugin:start', async ({ plugin }) => {
         await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${plugin.name}`)
       })
@@ -119,28 +124,24 @@ export const generateTool = defineTool(
       await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')
 
       await notify(NotifyTypes.BUILD_START, 'Starting build')
-      const { files, failedPlugins, error } = await kubb.safeBuild()
+      const { files, diagnostics } = await kubb.safeBuild()
       await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)
 
-      if (error || failedPlugins.size > 0) {
-        const allErrors: Array<Error> = [
-          error,
-          ...Array.from(failedPlugins)
-            .filter((it) => it.error)
-            .map((it) => it.error),
-        ].filter(Boolean)
-
-        await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`)
+      const problems = diagnostics.filter(isProblemDiagnostic)
+      const errors = problems.filter((diagnostic) => diagnostic.severity === 'error')
+      if (errors.length > 0) {
+        await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${errors.length} diagnostic(s)`)
 
-        return tool.error(`Build failed:\n${allErrors.map((err) => err.message).join('\n')}\n\n${messages.join('\n')}`)
+        const serialized = problems.map((diagnostic) => Diagnostics.serialize(diagnostic))
+        return tool.error(`Build failed:\n${formatDiagnostics(serialized)}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``)
       }
 
       await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`)
 
       return tool.text(`Build completed successfully!\n\nGenerated ${files.length} files\n\n${messages.join('\n')}`)
     } catch (caughtError) {
-      const error = toError(caughtError)
-      return tool.error(`Build error: ${error.message}\n${error.stack ?? ''}`)
+      const serialized = Diagnostics.serialize(Diagnostics.from(caughtError))
+      return tool.error(`Build error:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``)
     }
   },
 )

package/src/tools/validate.ts

@@ -1,6 +1,8 @@
+import { Diagnostics } from '@kubb/core'
 import { defineTool } from 'tmcp/tool'
 import { tool } from 'tmcp/utils'
 import { validateSchema } from '../schemas/validateSchema.ts'
+import { formatDiagnostics } from '../utils/formatDiagnostics.ts'
 
 export const validateTool = defineTool(
   {
@@ -19,7 +21,8 @@ export const validateTool = defineTool(
       await mod.adapterOas().validate(input, { throwOnError: true })
       return tool.text(`Validation successful: ${input}`)
     } catch (err) {
-      return tool.error(`Validation failed:\n${err instanceof Error ? err.message : String(err)}`)
+      const serialized = Diagnostics.serialize(Diagnostics.from(err))
+      return tool.error(`Validation failed:\n${formatDiagnostics([serialized])}\n\n\`\`\`json\n${JSON.stringify(serialized, null, 2)}\n\`\`\``)
     }
   },
 )

package/src/types.ts

@@ -3,6 +3,7 @@ export const NotifyTypes = {
   SUCCESS: 'SUCCESS',
   ERROR: 'ERROR',
   WARN: 'WARN',
+  DIAGNOSTIC: 'DIAGNOSTIC',
   PLUGIN_START: 'PLUGIN_START',
   PLUGIN_END: 'PLUGIN_END',
   FILES_START: 'FILES_START',

package/src/utils/formatDiagnostics.ts

@@ -0,0 +1,29 @@
+import type { SerializedDiagnostic } from '@kubb/core'
+
+/**
+ * Renders serialized diagnostics as a plain-text block for an AI assistant. Each entry
+ * keeps the stable `code`, the source pointer, the suggested fix, and the docs link, so
+ * the agent can act on the problem rather than parsing a bare message. No ANSI styling,
+ * unlike the CLI renderer.
+ */
+export function formatDiagnostics(diagnostics: ReadonlyArray<SerializedDiagnostic>): string {
+  return diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)).join('\n\n')
+}
+
+function formatDiagnostic(diagnostic: SerializedDiagnostic): string {
+  const { code, severity, message, location, help, plugin, docsUrl } = diagnostic
+  const rule = plugin ? `${plugin}(${code})` : code
+  const lines = [`${severity} ${rule}: ${message}`]
+
+  if (location && 'pointer' in location) {
+    lines.push(`  at ${location.pointer}`)
+  }
+  if (help) {
+    lines.push(`  help: ${help}`)
+  }
+  if (docsUrl) {
+    lines.push(`  docs: ${docsUrl}`)
+  }
+
+  return lines.join('\n')
+}