@kubb/agent 5.0.0-alpha.34 → 5.0.0-alpha.36

package/.output/server/node_modules/@kubb/plugin-mcp/dist/generators-BqkMrcs9.js

@@ -0,0 +1,274 @@
+import "./chunk--u3MIqq1.js";
+import { t as Server } from "./Server-H3SwqhwF.js";
+import path from "node:path";
+import { pluginTsName } from "@kubb/plugin-ts";
+import { pluginZodName } from "@kubb/plugin-zod";
+import { Client } from "@kubb/plugin-client/components";
+import { createReactGenerator } from "@kubb/plugin-oas/generators";
+import { useOas, useOperationManager } from "@kubb/plugin-oas/hooks";
+import { getBanner, getFooter } from "@kubb/plugin-oas/utils";
+import { File } from "@kubb/react-fabric";
+import { Fragment, jsx, jsxs } from "@kubb/react-fabric/jsx-runtime";
+import { usePluginManager } from "@kubb/core/hooks";
+//#region src/generators/mcpGenerator.tsx
+const mcpGenerator = createReactGenerator({
+	name: "mcp",
+	Operation({ config, operation, generator, plugin }) {
+		const { options } = plugin;
+		const oas = useOas();
+		const { getSchemas, getName, getFile } = useOperationManager(generator);
+		const mcp = {
+			name: getName(operation, {
+				type: "function",
+				suffix: "handler"
+			}),
+			file: getFile(operation)
+		};
+		const type = {
+			file: getFile(operation, { pluginKey: [pluginTsName] }),
+			schemas: getSchemas(operation, {
+				pluginKey: [pluginTsName],
+				type: "type"
+			})
+		};
+		return /* @__PURE__ */ jsxs(File, {
+			baseName: mcp.file.baseName,
+			path: mcp.file.path,
+			meta: mcp.file.meta,
+			banner: getBanner({
+				oas,
+				output: options.output
+			}),
+			footer: getFooter({
+				oas,
+				output: options.output
+			}),
+			children: [
+				options.client.importPath ? /* @__PURE__ */ jsxs(Fragment, { children: [
+					/* @__PURE__ */ jsx(File.Import, {
+						name: "fetch",
+						path: options.client.importPath
+					}),
+					/* @__PURE__ */ jsx(File.Import, {
+						name: [
+							"Client",
+							"RequestConfig",
+							"ResponseErrorConfig"
+						],
+						path: options.client.importPath,
+						isTypeOnly: true
+					}),
+					options.client.dataReturnType === "full" && /* @__PURE__ */ jsx(File.Import, {
+						name: ["ResponseConfig"],
+						path: options.client.importPath,
+						isTypeOnly: true
+					})
+				] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+					/* @__PURE__ */ jsx(File.Import, {
+						name: ["fetch"],
+						root: mcp.file.path,
+						path: path.resolve(config.root, config.output.path, ".kubb/fetch.ts")
+					}),
+					/* @__PURE__ */ jsx(File.Import, {
+						name: [
+							"Client",
+							"RequestConfig",
+							"ResponseErrorConfig"
+						],
+						root: mcp.file.path,
+						path: path.resolve(config.root, config.output.path, ".kubb/fetch.ts"),
+						isTypeOnly: true
+					}),
+					options.client.dataReturnType === "full" && /* @__PURE__ */ jsx(File.Import, {
+						name: ["ResponseConfig"],
+						root: mcp.file.path,
+						path: path.resolve(config.root, config.output.path, ".kubb/fetch.ts"),
+						isTypeOnly: true
+					})
+				] }),
+				/* @__PURE__ */ jsx(File.Import, {
+					name: ["buildFormData"],
+					root: mcp.file.path,
+					path: path.resolve(config.root, config.output.path, ".kubb/config.ts")
+				}),
+				/* @__PURE__ */ jsx(File.Import, {
+					name: ["CallToolResult"],
+					path: "@modelcontextprotocol/sdk/types",
+					isTypeOnly: true
+				}),
+				/* @__PURE__ */ jsx(File.Import, {
+					name: [
+						type.schemas.request?.name,
+						type.schemas.response.name,
+						type.schemas.pathParams?.name,
+						type.schemas.queryParams?.name,
+						type.schemas.headerParams?.name,
+						...type.schemas.statusCodes?.map((item) => item.name) || []
+					].filter(Boolean),
+					root: mcp.file.path,
+					path: type.file.path,
+					isTypeOnly: true
+				}),
+				/* @__PURE__ */ jsxs(Client, {
+					name: mcp.name,
+					isConfigurable: false,
+					returnType: "Promise<CallToolResult>",
+					baseURL: options.client.baseURL,
+					operation,
+					typeSchemas: type.schemas,
+					zodSchemas: void 0,
+					dataReturnType: options.client.dataReturnType || "data",
+					paramsType: "object",
+					paramsCasing: options.client?.paramsCasing || options.paramsCasing,
+					pathParamsType: "object",
+					parser: "client",
+					children: [options.client.dataReturnType === "data" && `return {
+            content: [
+              {
+                type: 'text',
+                text: JSON.stringify(res.data)
+              }
+            ],
+            structuredContent: { data: res.data }
+           }`, options.client.dataReturnType === "full" && `return {
+            content: [
+              {
+                type: 'text',
+                text: JSON.stringify(res)
+              }
+            ],
+            structuredContent: { data: res.data }
+           }`]
+				})
+			]
+		});
+	}
+});
+//#endregion
+//#region src/generators/serverGenerator.tsx
+const serverGenerator = createReactGenerator({
+	name: "operations",
+	Operations({ operations, generator, plugin }) {
+		const pluginManager = usePluginManager();
+		const { options } = plugin;
+		const oas = useOas();
+		const { getFile, getName, getSchemas } = useOperationManager(generator);
+		const name = "server";
+		const file = pluginManager.getFile({
+			name,
+			extname: ".ts",
+			pluginKey: plugin.key
+		});
+		const jsonFile = pluginManager.getFile({
+			name: ".mcp",
+			extname: ".json",
+			pluginKey: plugin.key
+		});
+		const operationsMapped = operations.map((operation) => {
+			return {
+				tool: {
+					name: operation.getOperationId() || operation.getSummary() || `${operation.method.toUpperCase()} ${operation.path}`,
+					title: operation.getSummary() || void 0,
+					description: operation.getDescription() || `Make a ${operation.method.toUpperCase()} request to ${operation.path}`
+				},
+				mcp: {
+					name: getName(operation, {
+						type: "function",
+						suffix: "handler"
+					}),
+					file: getFile(operation)
+				},
+				zod: {
+					name: getName(operation, {
+						type: "function",
+						pluginKey: [pluginZodName]
+					}),
+					schemas: getSchemas(operation, {
+						pluginKey: [pluginZodName],
+						type: "function"
+					}),
+					file: getFile(operation, { pluginKey: [pluginZodName] })
+				},
+				type: { schemas: getSchemas(operation, {
+					pluginKey: [pluginTsName],
+					type: "type"
+				}) }
+			};
+		});
+		const imports = operationsMapped.flatMap(({ mcp, zod }) => {
+			return [/* @__PURE__ */ jsx(File.Import, {
+				name: [mcp.name],
+				root: file.path,
+				path: mcp.file.path
+			}, mcp.name), /* @__PURE__ */ jsx(File.Import, {
+				name: [
+					zod.schemas.request?.name,
+					zod.schemas.pathParams?.name,
+					zod.schemas.queryParams?.name,
+					zod.schemas.headerParams?.name,
+					zod.schemas.response?.name
+				].filter(Boolean),
+				root: file.path,
+				path: zod.file.path
+			}, zod.name)];
+		});
+		return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(File, {
+			baseName: file.baseName,
+			path: file.path,
+			meta: file.meta,
+			banner: getBanner({
+				oas,
+				output: options.output,
+				config: pluginManager.config
+			}),
+			footer: getFooter({
+				oas,
+				output: options.output
+			}),
+			children: [
+				/* @__PURE__ */ jsx(File.Import, {
+					name: ["McpServer"],
+					path: "@modelcontextprotocol/sdk/server/mcp"
+				}),
+				/* @__PURE__ */ jsx(File.Import, {
+					name: ["z"],
+					path: "zod"
+				}),
+				/* @__PURE__ */ jsx(File.Import, {
+					name: ["StdioServerTransport"],
+					path: "@modelcontextprotocol/sdk/server/stdio"
+				}),
+				imports,
+				/* @__PURE__ */ jsx(Server, {
+					name,
+					serverName: oas.api.info?.title,
+					serverVersion: oas.getVersion(),
+					paramsCasing: options.paramsCasing,
+					operations: operationsMapped
+				})
+			]
+		}), /* @__PURE__ */ jsx(File, {
+			baseName: jsonFile.baseName,
+			path: jsonFile.path,
+			meta: jsonFile.meta,
+			children: /* @__PURE__ */ jsx(File.Source, {
+				name,
+				children: `
+          {
+            "mcpServers": {
+              "${oas.api.info?.title || "server"}": {
+                "type": "stdio",
+                "command": "npx",
+                "args": ["tsx", "${file.path}"]
+              }
+            }
+          }
+          `
+			})
+		})] });
+	}
+});
+//#endregion
+export { mcpGenerator as n, serverGenerator as t };
+
+//# sourceMappingURL=generators-BqkMrcs9.js.map

package/.output/server/node_modules/@kubb/plugin-mcp/dist/index.js

@@ -0,0 +1,122 @@
+import "./chunk--u3MIqq1.js";
+import { n as camelCase } from "./Server-H3SwqhwF.js";
+import { n as mcpGenerator, t as serverGenerator } from "./generators-BqkMrcs9.js";
+import path from "node:path";
+import { definePlugin, getBarrelFiles, getMode } from "@kubb/core";
+import { pluginClientName } from "@kubb/plugin-client";
+import { source } from "@kubb/plugin-client/templates/clients/axios.source";
+import { source as source$1 } from "@kubb/plugin-client/templates/clients/fetch.source";
+import { source as source$2 } from "@kubb/plugin-client/templates/config.source";
+import { OperationGenerator, pluginOasName } from "@kubb/plugin-oas";
+import { pluginTsName } from "@kubb/plugin-ts";
+import { pluginZodName } from "@kubb/plugin-zod";
+//#region src/plugin.ts
+const pluginMcpName = "plugin-mcp";
+const pluginMcp = definePlugin((options) => {
+	const { output = {
+		path: "mcp",
+		barrelType: "named"
+	}, group, exclude = [], include, override = [], transformers = {}, generators = [mcpGenerator, serverGenerator].filter(Boolean), contentType, paramsCasing, client } = options;
+	const clientName = client?.client ?? "axios";
+	const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : void 0);
+	return {
+		name: pluginMcpName,
+		options: {
+			output,
+			group,
+			paramsCasing,
+			client: {
+				client: clientName,
+				clientType: client?.clientType ?? "function",
+				importPath: clientImportPath,
+				dataReturnType: client?.dataReturnType ?? "data",
+				bundle: client?.bundle,
+				baseURL: client?.baseURL,
+				paramsCasing: client?.paramsCasing
+			}
+		},
+		pre: [
+			pluginOasName,
+			pluginTsName,
+			pluginZodName
+		].filter(Boolean),
+		resolvePath(baseName, pathMode, options) {
+			const root = path.resolve(this.config.root, this.config.output.path);
+			if ((pathMode ?? getMode(path.resolve(root, output.path))) === "single")
+ /**
+			* when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend
+			* Other plugins then need to call addOrAppend instead of just add from the fileManager class
+			*/
+			return path.resolve(root, output.path);
+			if (group && (options?.group?.path || options?.group?.tag)) {
+				const groupName = group?.name ? group.name : (ctx) => {
+					if (group?.type === "path") return `${ctx.group.split("/")[1]}`;
+					return `${camelCase(ctx.group)}Requests`;
+				};
+				return path.resolve(root, output.path, groupName({ group: group.type === "path" ? options.group.path : options.group.tag }), baseName);
+			}
+			return path.resolve(root, output.path, baseName);
+		},
+		resolveName(name, type) {
+			const resolvedName = camelCase(name, { isFile: type === "file" });
+			if (type) return transformers?.name?.(resolvedName, type) || resolvedName;
+			return resolvedName;
+		},
+		async install() {
+			const root = path.resolve(this.config.root, this.config.output.path);
+			const mode = getMode(path.resolve(root, output.path));
+			const oas = await this.getOas();
+			const baseURL = await this.getBaseURL();
+			if (baseURL) this.plugin.options.client.baseURL = baseURL;
+			const hasClientPlugin = !!this.pluginManager.getPluginByKey([pluginClientName]);
+			if (this.plugin.options.client.bundle && !hasClientPlugin && !this.plugin.options.client.importPath) await this.addFile({
+				baseName: "fetch.ts",
+				path: path.resolve(root, ".kubb/fetch.ts"),
+				sources: [{
+					name: "fetch",
+					value: this.plugin.options.client.client === "fetch" ? source$1 : source,
+					isExportable: true,
+					isIndexable: true
+				}],
+				imports: [],
+				exports: []
+			});
+			if (!hasClientPlugin) await this.addFile({
+				baseName: "config.ts",
+				path: path.resolve(root, ".kubb/config.ts"),
+				sources: [{
+					name: "config",
+					value: source$2,
+					isExportable: false,
+					isIndexable: false
+				}],
+				imports: [],
+				exports: []
+			});
+			const files = await new OperationGenerator(this.plugin.options, {
+				fabric: this.fabric,
+				oas,
+				pluginManager: this.pluginManager,
+				events: this.events,
+				plugin: this.plugin,
+				contentType,
+				exclude,
+				include,
+				override,
+				mode
+			}).build(...generators);
+			await this.upsertFile(...files);
+			const barrelFiles = await getBarrelFiles(this.fabric.files, {
+				type: output.barrelType ?? "named",
+				root,
+				output,
+				meta: { pluginKey: this.plugin.key }
+			});
+			await this.upsertFile(...barrelFiles);
+		}
+	};
+});
+//#endregion
+export { pluginMcp, pluginMcpName };
+
+//# sourceMappingURL=index.js.map

package/.output/server/node_modules/@kubb/plugin-mcp/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@kubb/plugin-mcp",
+  "version": "4.37.2",
+  "description": "Model Context Protocol (MCP) plugin for Kubb, generating MCP-compatible tools and schemas from OpenAPI specifications for AI assistants.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "claude",
+    "ai-tools",
+    "openapi",
+    "swagger",
+    "typescript",
+    "code-generator",
+    "codegen",
+    "plugins",
+    "kubb"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kubb-labs/kubb.git",
+    "directory": "packages/plugin-mcp"
+  },
+  "license": "MIT",
+  "author": "stijnvanhulle",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./components": {
+      "import": "./dist/components.js",
+      "require": "./dist/components.cjs"
+    },
+    "./generators": {
+      "import": "./dist/generators.js",
+      "require": "./dist/generators.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "utils": [
+        "./dist/utils.d.ts"
+      ],
+      "hooks": [
+        "./dist/hooks.d.ts"
+      ],
+      "components": [
+        "./dist/components.d.ts"
+      ],
+      "generators": [
+        "./dist/generators.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "!/**/**.test.**",
+    "!/**/__tests__/**",
+    "!/**/__snapshots__/**"
+  ],
+  "size-limit": [
+    {
+      "path": "./dist/*.js",
+      "limit": "510 KiB",
+      "gzip": true
+    }
+  ],
+  "dependencies": {
+    "@kubb/react-fabric": "0.14.0",
+    "@kubb/core": "4.37.2",
+    "@kubb/oas": "4.37.2",
+    "@kubb/plugin-client": "4.37.2",
+    "@kubb/plugin-oas": "4.37.2",
+    "@kubb/plugin-ts": "4.37.2",
+    "@kubb/plugin-zod": "4.37.2"
+  },
+  "devDependencies": {
+    "@internals/utils": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "scripts": {
+    "build": "tsdown && size-limit",
+    "clean": "npx rimraf ./dist",
+    "lint": "bun biome lint .",
+    "lint:fix": "bun biome lint --fix --unsafe .",
+    "release": "pnpm publish --no-git-check",
+    "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
+    "start": "tsdown --watch",
+    "test": "vitest --passWithNoTests",
+    "typecheck": "tsc -p ./tsconfig.json --noEmit --emitDeclarationOnly false"
+  }
+}

package/.output/server/node_modules/@kubb/plugin-msw/dist/chunk--u3MIqq1.js

@@ -0,0 +1,8 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", {
+	value,
+	configurable: true
+});
+//#endregion
+export { __name as t };