@kubb/agent 4.26.1 → 4.27.0

package/.output/nitro.json

@@ -1,5 +1,5 @@
 {
-  "date": "2026-02-20T09:55:19.475Z",
+  "date": "2026-02-20T15:31:19.159Z",
   "preset": "node-server",
   "framework": {
     "name": "nitro",

package/.output/server/chunks/nitro/nitro.mjs

@@ -5654,7 +5654,7 @@ var _b, _cache, _cwd, _SLASHES, _PackageManager_instances, match_fn;
 function isInputPath(config) {
   return typeof (config == null ? void 0 : config.input) === "object" && config.input !== null && "path" in config.input;
 }
-var version$1 = "4.26.1";
+var version$1 = "4.27.0";
 function getDiagnosticInfo() {
   return {
     nodeVersion: version$2,
@@ -5720,7 +5720,7 @@ async function setup(options) {
     await clean(definedConfig.output.path);
   }
   const fabric = createFabric();
-  fabric.use(fsPlugin, { dryRun: !definedConfig.output.write });
+  fabric.use(fsPlugin);
   fabric.use(typescriptParser);
   fabric.context.on("files:processing:start", (files) => {
     events.emit("files:processing:start", files);
@@ -5737,7 +5737,7 @@ async function setup(options) {
       source
     });
     if (source) {
-      await write(file.path, source, { sanity: false });
+      if (definedConfig.output.write) await write(file.path, source, { sanity: false });
       sources.set(file.path, source);
     }
   });
@@ -6291,6 +6291,43 @@ async function getCosmiConfig(configPath) {
   }
 }
 
+function getFactoryName(packageName) {
+  const match = packageName.match(/\/plugin-(.+)$/);
+  if (!match) {
+    return packageName;
+  }
+  return `plugin-${match[1]}`.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+async function resolvePlugins(plugins) {
+  return Promise.all(
+    plugins.map(async ({ name, options }) => {
+      const mod = await import(name);
+      const factoryName = getFactoryName(name);
+      const factory = mod[factoryName];
+      if (typeof factory !== "function") {
+        throw new Error(`Plugin factory "${factoryName}" not found in package "${name}"`);
+      }
+      return factory(options != null ? options : {});
+    })
+  );
+}
+
+function readStudioConfig(configPath) {
+  const studioConfigPath = path$1.join(path$1.dirname(configPath), "kubb.config.studio.json");
+  if (!existsSync(studioConfigPath)) {
+    return null;
+  }
+  try {
+    return JSON.parse(readFileSync(studioConfigPath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function writeStudioConfig(configPath, config) {
+  const studioConfigPath = path$1.join(path$1.dirname(configPath), "kubb.config.studio.json");
+  writeFileSync(studioConfigPath, JSON.stringify(config, null, 2), "utf-8");
+}
+
 const WEBSOCKET_READY = 1;
 const WEBSOCKET_CONNECTING = 0;
 function createWebsocket(url, options) {
@@ -6420,7 +6457,7 @@ function setupEventsStream(ws, events) {
   });
 }
 
-var version = "4.26.1";
+var version = "4.27.0";
 
 const _zcw7I4pYH8OiCfaDcjy_x7I6IH1tLDQR3W_yRZgP6E = defineNitroPlugin(async (nitro) => {
   const studioUrl = process$1.env.KUBB_STUDIO_URL || "https://studio.kubb.dev";
@@ -6428,11 +6465,15 @@ const _zcw7I4pYH8OiCfaDcjy_x7I6IH1tLDQR3W_yRZgP6E = defineNitroPlugin(async (nit
   const configPath = process$1.env.KUBB_CONFIG || "kubb.config.ts";
   const noCache = process$1.env.KUBB_AGENT_NO_CACHE === "true";
   const retryInterval = process$1.env.KUBB_RETRY_TIMEOUT ? Number.parseInt(process$1.env.KUBB_RETRY_TIMEOUT, 10) : 3e4;
+  const root = process$1.env.KUBB_ROOT || process$1.cwd();
+  const allowAll = process$1.env.KUBB_ALLOW_ALL === "true";
+  const allowWrite = allowAll || process$1.env.KUBB_ALLOW_WRITE === "true";
   if (!token) {
     logger.warn("KUBB_AGENT_TOKEN not set", "cannot authenticate with studio");
     return null;
   }
-  const result = await getCosmiConfig(configPath);
+  const resolvedConfigPath = path$1.isAbsolute(configPath) ? configPath : path$1.resolve(root, configPath);
+  const result = await getCosmiConfig(resolvedConfigPath);
   const configs = await getConfigs(result.config, {});
   if (configs.length === 0) {
     throw new Error("No configs found");
@@ -6444,7 +6485,6 @@ const _zcw7I4pYH8OiCfaDcjy_x7I6IH1tLDQR3W_yRZgP6E = defineNitroPlugin(async (nit
       Authorization: `Bearer ${token}`
     }
   };
-  const root = process$1.env.KUBB_ROOT || config.root || process$1.cwd();
   events.on("hook:start", async ({ id, command, args }) => {
     const commandWithArgs = (args == null ? void 0 : args.length) ? `${command} ${args.join(" ")}` : command;
     if (!id) {
@@ -6532,57 +6572,56 @@ const _zcw7I4pYH8OiCfaDcjy_x7I6IH1tLDQR3W_yRZgP6E = defineNitroPlugin(async (nit
       }, 3e4);
       setupEventsStream(ws, events);
       ws.addEventListener("message", async (message) => {
-        var _a;
-        const data = JSON.parse(message.data);
-        if (isCommandMessage(data)) {
-          if (data.command === "generate") {
-            await generate({
-              config: {
-                ...config,
-                root
-              },
-              events
-            });
-            logger.success("Generated command success");
-          }
-          if (data.command === "connect") {
-            let specContent;
-            if (config && "path" in config.input) {
-              const specPath = path$1.resolve(process$1.cwd(), config.root, config.input.path);
-              try {
-                specContent = readFileSync(specPath, "utf-8");
-              } catch {
-              }
-            }
-            sendAgentMessage(ws, {
-              type: "connected",
-              payload: {
-                version,
-                configPath: process$1.env.KUBB_CONFIG || "",
-                spec: specContent,
+        var _a, _b, _c;
+        try {
+          const data = JSON.parse(message.data);
+          if (isCommandMessage(data)) {
+            if (data.command === "generate") {
+              const studioConfig = readStudioConfig(resolvedConfigPath);
+              const patch = (_a = data.payload) != null ? _a : studioConfig;
+              const resolvedPlugins = await resolvePlugins(patch.plugins);
+              await generate({
                 config: {
-                  name: config.name,
-                  root: config.root,
-                  input: {
-                    path: "path" in config.input ? config.input.path : void 0
-                  },
+                  ...config,
+                  plugins: patch ? resolvedPlugins : config.plugins,
+                  root,
                   output: {
-                    path: config.output.path,
-                    write: config.output.write,
-                    extension: config.output.extension,
-                    barrelType: config.output.barrelType
+                    ...config.output,
+                    write: allowWrite
+                  }
+                },
+                events
+              });
+              if (allowWrite) {
+                writeStudioConfig(resolvedConfigPath, data.payload);
+              }
+              logger.success("Generated command success");
+            }
+            if (data.command === "connect") {
+              sendAgentMessage(ws, {
+                type: "connected",
+                payload: {
+                  version,
+                  configPath,
+                  permissions: {
+                    allowAll,
+                    allowWrite
                   },
-                  plugins: (_a = config.plugins) == null ? void 0 : _a.map((plugin) => ({
-                    name: `@kubb/${plugin.name}`,
-                    options: serializePluginOptions(plugin.options)
-                  }))
+                  config: {
+                    plugins: (_b = config.plugins) == null ? void 0 : _b.map((plugin) => ({
+                      name: `@kubb/${plugin.name}`,
+                      options: serializePluginOptions(plugin.options)
+                    }))
+                  }
                 }
-              }
-            });
+              });
+            }
+            return;
           }
-          return;
+          logger.warn(`Unknown message type from Kubb Studio: ${message.data}`);
+        } catch (error) {
+          logger.error(`[unhandledRejection] ${(_c = error == null ? void 0 : error.message) != null ? _c : error}`);
         }
-        logger.warn(`Unknown message type from Kubb Studio: ${message.data}`);
       });
     } catch (error) {
       deleteCachedSession(token);

package/.output/server/chunks/nitro/nitro.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.mjs","sources":["../../../../../../node_modules/.pnpm/destr@2.0.5/node_modules/destr/dist/index.mjs","../../../../../../node_modules/.pnpm/ufo@1.6.3/node_modules/ufo/dist/index.mjs","../../../../../../node_modules/.pnpm/radix3@1.1.2/node_modules/radix3/dist/index.mjs","../../../../../../node_modules/.pnpm/defu@6.1.4/node_modules/defu/dist/defu.mjs","../../../../../../node_modules/.pnpm/node-mock-http@1.0.4/node_modules/node-mock-http/dist/index.mjs","../../../../../../node_modules/.pnpm/h3@1.15.5/node_modules/h3/dist/index.mjs","../../../../../../node_modules/.pnpm/hookable@5.5.3/node_modules/hookable/dist/index.mjs","../../../../../../node_modules/.pnpm/node-fetch-native@1.6.7/node_modules/node-fetch-native/dist/native.mjs","../../../../../../node_modules/.pnpm/ofetch@1.5.1/node_modules/ofetch/dist/shared/ofetch.CWycOUEr.mjs","../../../../../../node_modules/.pnpm/ofetch@1.5.1/node_modules/ofetch/dist/node.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/dist/shared/unstorage.zVDD2mZo.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/dist/index.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/drivers/utils/index.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/drivers/utils/node-fs.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/drivers/fs-lite.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/storage.mjs","../../../../../../node_modules/.pnpm/ohash@2.0.11/node_modules/ohash/dist/crypto/node/index.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/hash.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/cache.mjs","../../../../../../node_modules/.pnpm/klona@2.0.6/node_modules/klona/dist/index.mjs","../../../../../../node_modules/.pnpm/scule@1.3.0/node_modules/scule/dist/index.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/utils.env.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/config.mjs","../../../../../../node_modules/.pnpm/unctx@2.5.0/node_modules/unctx/dist/index.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/context.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/route-rules.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/utils.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/error/utils.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/error/prod.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/plugin.mjs","../../../../../core/dist/chunk-iVr_oF3V.js","../../../../../core/dist/fs-Parec-wn.js","../../../../../core/dist/transformers-8ju9ixkG.js","../../../../../core/dist/getBarrelFiles-gRyVPFBP.js","../../../../../core/dist/utils.js","../../../../server/types/agent.ts","../../../../server/utils/logger.ts","../../../../server/utils/sessionManager.ts","../../../../server/utils/api.ts","../../../../../core/dist/index.js","../../../../server/utils/executeHooks.ts","../../../../server/utils/generate.ts","../../../../server/utils/getCosmiConfig.ts","../../../../server/utils/ws.ts","../../../../server/plugins/studio.ts","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/app.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/lib/http-graceful-shutdown.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/shutdown.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/presets/node/runtime/node-server.mjs"],"names":["createRouter","f","h","i","l","createError","mergeHeaders","s","nodeFetch","Headers","Headers$1","AbortController$1","normalizeKey","defineDriver","DRIVER_NAME","fsPromises","fsp","_inlineAppConfig","createRadixRouter","__defProp","_b","_options","__privateAdd","__privateGet","__privateSet","pLimit","path","_a","__privateMethod","version","fs","error","process","result","nitroApp","callNodeRequestHandler","fetchNodeRequestHandler","gracefulShutdown","HttpsServer","HttpServer"],"mappings":"","x_google_ignoreList":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,45,46,47,48]}
+{"version":3,"file":"nitro.mjs","sources":["../../../../../../node_modules/.pnpm/destr@2.0.5/node_modules/destr/dist/index.mjs","../../../../../../node_modules/.pnpm/ufo@1.6.3/node_modules/ufo/dist/index.mjs","../../../../../../node_modules/.pnpm/radix3@1.1.2/node_modules/radix3/dist/index.mjs","../../../../../../node_modules/.pnpm/defu@6.1.4/node_modules/defu/dist/defu.mjs","../../../../../../node_modules/.pnpm/node-mock-http@1.0.4/node_modules/node-mock-http/dist/index.mjs","../../../../../../node_modules/.pnpm/h3@1.15.5/node_modules/h3/dist/index.mjs","../../../../../../node_modules/.pnpm/hookable@5.5.3/node_modules/hookable/dist/index.mjs","../../../../../../node_modules/.pnpm/node-fetch-native@1.6.7/node_modules/node-fetch-native/dist/native.mjs","../../../../../../node_modules/.pnpm/ofetch@1.5.1/node_modules/ofetch/dist/shared/ofetch.CWycOUEr.mjs","../../../../../../node_modules/.pnpm/ofetch@1.5.1/node_modules/ofetch/dist/node.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/dist/shared/unstorage.zVDD2mZo.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/dist/index.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/drivers/utils/index.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/drivers/utils/node-fs.mjs","../../../../../../node_modules/.pnpm/unstorage@1.17.4_db0@0.3.4_ioredis@5.9.3/node_modules/unstorage/drivers/fs-lite.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/storage.mjs","../../../../../../node_modules/.pnpm/ohash@2.0.11/node_modules/ohash/dist/crypto/node/index.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/hash.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/cache.mjs","../../../../../../node_modules/.pnpm/klona@2.0.6/node_modules/klona/dist/index.mjs","../../../../../../node_modules/.pnpm/scule@1.3.0/node_modules/scule/dist/index.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/utils.env.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/config.mjs","../../../../../../node_modules/.pnpm/unctx@2.5.0/node_modules/unctx/dist/index.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/context.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/route-rules.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/utils.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/error/utils.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/error/prod.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/plugin.mjs","../../../../../core/dist/chunk-iVr_oF3V.js","../../../../../core/dist/fs-Parec-wn.js","../../../../../core/dist/transformers-8ju9ixkG.js","../../../../../core/dist/getBarrelFiles-gRyVPFBP.js","../../../../../core/dist/utils.js","../../../../server/types/agent.ts","../../../../server/utils/logger.ts","../../../../server/utils/sessionManager.ts","../../../../server/utils/api.ts","../../../../../core/dist/index.js","../../../../server/utils/executeHooks.ts","../../../../server/utils/generate.ts","../../../../server/utils/getCosmiConfig.ts","../../../../server/utils/resolvePlugins.ts","../../../../server/utils/studioConfig.ts","../../../../server/utils/ws.ts","../../../../server/plugins/studio.ts","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/app.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/lib/http-graceful-shutdown.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/runtime/internal/shutdown.mjs","../../../../../../node_modules/.pnpm/nitropack@2.13.1_encoding@0.1.13_rolldown@1.0.0-rc.1/node_modules/nitropack/dist/presets/node/runtime/node-server.mjs"],"names":["createRouter","f","h","i","l","createError","mergeHeaders","s","nodeFetch","Headers","Headers$1","AbortController$1","normalizeKey","defineDriver","DRIVER_NAME","fsPromises","fsp","_inlineAppConfig","createRadixRouter","__defProp","_b","_options","__privateAdd","__privateGet","__privateSet","pLimit","path","_a","__privateMethod","version","fs","error","process","result","nitroApp","callNodeRequestHandler","fetchNodeRequestHandler","gracefulShutdown","HttpsServer","HttpServer"],"mappings":"","x_google_ignoreList":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,47,48,49,50]}

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/agent-prod",
-  "version": "4.26.1",
+  "version": "4.27.0",
   "type": "module",
   "private": true,
   "dependencies": {

package/README.md

@@ -54,6 +54,8 @@ The server will be available at `http://localhost:4000`.
 - `KUBB_STUDIO_URL` - Studio connection URL (e.g., `http://localhost:3000`)
 - `KUBB_AGENT_TOKEN` - Authentication token for Studio connection
 - `KUBB_AGENT_NO_CACHE` - Disable session caching (set to `true` to skip cache)
+- `KUBB_ALLOW_WRITE` - Allow writing generated files to the filesystem (set to `true` to enable). When `false` (default), no files are written and the config patch is not persisted.
+- `KUBB_ALLOW_ALL` - Grant all permissions including filesystem writes. Implies `KUBB_ALLOW_WRITE=true`.
 
 ### Automatic .env Loading
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/agent",
-  "version": "4.26.1",
+  "version": "4.27.0",
   "description": "Agent server for Kubb, enabling HTTP-based access to code generation capabilities.",
   "keywords": [
     "agent",
@@ -45,7 +45,20 @@
     "picocolors": "^1.1.1",
     "string-argv": "^0.3.2",
     "ws": "^8.19.0",
-    "@kubb/core": "4.26.1"
+    "@kubb/core": "4.27.0",
+    "@kubb/plugin-client": "4.27.0",
+    "@kubb/plugin-cypress": "4.27.0",
+    "@kubb/plugin-faker": "4.27.0",
+    "@kubb/plugin-msw": "4.27.0",
+    "@kubb/plugin-oas": "4.27.0",
+    "@kubb/plugin-react-query": "4.27.0",
+    "@kubb/plugin-redoc": "4.27.0",
+    "@kubb/plugin-solid-query": "4.27.0",
+    "@kubb/plugin-svelte-query": "4.27.0",
+    "@kubb/plugin-swr": "4.27.0",
+    "@kubb/plugin-ts": "4.27.0",
+    "@kubb/plugin-vue-query": "4.27.0",
+    "@kubb/plugin-zod": "4.27.0"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",