@kubb/agent 5.0.0-alpha.48 → 5.0.0-alpha.49

package/.output/nitro.json

@@ -1,5 +1,5 @@
 {
-  "date": "2026-04-19T08:11:44.537Z",
+  "date": "2026-04-19T17:00:21.900Z",
   "preset": "node-server",
   "framework": {
     "name": "nitro",

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

@@ -6,7 +6,7 @@ import http, { Server as Server$1 } from 'node:http';
 import https, { Server } from 'node:https';
 import { EventEmitter } from 'node:events';
 import { Buffer as Buffer$1 } from 'node:buffer';
-import { promises, existsSync } from 'node:fs';
+import { promises, existsSync, readdirSync } from 'node:fs';
 import path$1, { resolve, dirname, relative, join, extname, posix } from 'node:path';
 import anymatch from 'anymatch';
 import { createHash, randomBytes } from 'node:crypto';
@@ -4501,13 +4501,23 @@ async function isFormatterAvailable(formatter) {
 }
 async function detectFormatter() {
   const formatterNames = /* @__PURE__ */ new Set([
-    "biome",
     "oxfmt",
+    "biome",
     "prettier"
   ]);
   for (const formatter of formatterNames) if (await isFormatterAvailable(formatter)) return formatter;
   return null;
 }
+function findLintableFiles(dir) {
+  try {
+    return readdirSync(dir, {
+      withFileTypes: true,
+      recursive: true
+    }).filter((d) => d.isFile()).map((d) => `${d.parentPath}/${d.name}`);
+  } catch {
+    return [];
+  }
+}
 const linters = {
   eslint: {
     command: "eslint",
@@ -4525,7 +4535,7 @@ const linters = {
   },
   oxlint: {
     command: "oxlint",
-    args: (outputPath) => ["--fix", outputPath],
+    args: (outputPath) => ["--fix", ...findLintableFiles(outputPath)],
     errorMessage: "Oxlint not found"
   }
 };
@@ -4538,8 +4548,8 @@ async function isLinterAvailable(linter) {
 }
 async function detectLinter() {
   const linterNames = /* @__PURE__ */ new Set([
-    "biome",
     "oxlint",
+    "biome",
     "eslint"
   ]);
   for (const linter of linterNames) if (await isLinterAvailable(linter)) return linter;
@@ -4612,7 +4622,9 @@ async function createAgentSession({ token, studioUrl }) {
     logger.info("Created agent session with Studio");
     return data;
   } catch (error) {
-    throw new Error("Failed to get agent session from Kubb Studio", { cause: error });
+    throw new Error("Failed to get agent session from Kubb Studio", {
+      cause: error
+    });
   }
 }
 async function registerAgent({ token, studioUrl, poolSize }) {
@@ -4645,7 +4657,9 @@ async function disconnect({ sessionId, token, studioUrl }) {
     });
     logger.success(`[${maskedSessionKey}] Disconnected from Studio`);
   } catch (error) {
-    throw new Error("Failed to notify Studio of disconnection on exit", { cause: error });
+    throw new Error("Failed to notify Studio of disconnection on exit", {
+      cause: error
+    });
   }
 }
 
@@ -6277,7 +6291,7 @@ const fsStorage = createStorage(() => ({
     await clean(resolve(base));
   }
 }));
-var version$1 = "5.0.0-alpha.48";
+var version$1 = "5.0.0-alpha.49";
 function getDiagnosticInfo() {
   return {
     nodeVersion: version$2,
@@ -6957,7 +6971,7 @@ const memoryStorage = createStorage(() => {
   };
 });
 
-var version = "5.0.0-alpha.48";
+var version = "5.0.0-alpha.49";
 
 function isCommandMessage(msg) {
   return msg.type === "command";
@@ -7036,7 +7050,7 @@ async function generate({ config, hooks }) {
     if (formatter === "auto") {
       const detectedFormatter = await detectFormatter();
       if (!detectedFormatter) {
-        await hooks.emit("kubb:warn", "No formatter found (biome, prettier, or oxfmt). Skipping formatting.");
+        await hooks.emit("kubb:warn", "No formatter found (oxfmt, biome, or prettier). Skipping formatting.");
       } else {
         formatter = detectedFormatter;
         await hooks.emit("kubb:info", `Auto-detected formatter: ${formatter}`);
@@ -7070,7 +7084,7 @@ async function generate({ config, hooks }) {
     if (linter === "auto") {
       const detectedLinter = await detectLinter();
       if (!detectedLinter) {
-        await hooks.emit("kubb:warn", "No linter found (biome, oxlint, or eslint). Skipping linting.");
+        await hooks.emit("kubb:warn", "No linter found (oxlint, biome, or eslint). Skipping linting.");
       } else {
         linter = detectedLinter;
         await hooks.emit("kubb:info", `Auto-detected linter: ${styleText("dim", linter)}`);
@@ -7253,10 +7267,22 @@ function setupHookListener(hooks, root) {
         throwOnError: true
       });
       console.log(result.stdout.trimEnd());
-      await hooks.emit("kubb:hook:end", { command, args, id, success: true, error: null });
+      await hooks.emit("kubb:hook:end", {
+        command,
+        args,
+        id,
+        success: true,
+        error: null
+      });
     } catch (_err) {
       const errorMessage = new Error(`Hook execute failed: ${commandWithArgs}`);
-      await hooks.emit("kubb:hook:end", { command, args, id, success: false, error: errorMessage });
+      await hooks.emit("kubb:hook:end", {
+        command,
+        args,
+        id,
+        success: false,
+        error: errorMessage
+      });
       await hooks.emit("kubb:error", errorMessage);
     }
   });
@@ -7430,7 +7456,9 @@ async function connectToStudio(options) {
   try {
     setupHookListener(hooks, root);
     const { sessionId, wsUrl, isSandbox } = initialSession != null ? initialSession : await createAgentSession({ token, studioUrl });
-    const ws = createWebsocket(wsUrl, { headers: { Authorization: `Bearer ${token}` } });
+    const ws = createWebsocket(wsUrl, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
     const maskedWsUrl = maskString(wsUrl);
     const maskedSessionId = maskString(sessionId);
     const effectiveAllowAll = isSandbox ? false : allowAll;
@@ -7516,7 +7544,10 @@ async function connectToStudio(options) {
               logger.warn(`[${maskedSessionId}] Input override via payload is only supported in sandbox mode and will be ignored`);
             }
             if (data.payload && effectiveWrite) {
-              await saveStudioConfigToStorage({ sessionId, config: data.payload }).catch((err) => {
+              await saveStudioConfigToStorage({
+                sessionId,
+                config: data.payload
+              }).catch((err) => {
                 logger.warn(`[${maskedSessionId}] Failed to save studio config: ${err == null ? void 0 : err.message}`);
               });
             }
@@ -7525,7 +7556,10 @@ async function connectToStudio(options) {
                 ...config,
                 root,
                 input: inputOverride != null ? inputOverride : config.input,
-                output: { ...config.output, storage: effectiveWrite ? fsStorage() : memoryStorage() },
+                output: {
+                  ...config.output,
+                  storage: effectiveWrite ? fsStorage() : memoryStorage()
+                },
                 plugins
               },
               hooks
@@ -7541,7 +7575,11 @@ async function connectToStudio(options) {
               payload: {
                 version,
                 configPath,
-                permissions: { allowAll: effectiveAllowAll, allowWrite: effectiveWrite, allowPublish: effectivePublish },
+                permissions: {
+                  allowAll: effectiveAllowAll,
+                  allowWrite: effectiveWrite,
+                  allowPublish: effectivePublish
+                },
                 config: {
                   plugins: config.plugins.map((plugin) => ({
                     name: `@kubb/${plugin.name}`,
@@ -7578,7 +7616,9 @@ async function connectToStudio(options) {
       }
     });
   } catch (error) {
-    throw new Error(`[unhandledRejection] ${(_a = error == null ? void 0 : error.message) != null ? _a : error}`, { cause: error });
+    throw new Error(`[unhandledRejection] ${(_a = error == null ? void 0 : error.message) != null ? _a : error}`, {
+      cause: error
+    });
   }
 }
 

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/agent-prod",
-  "version": "5.0.0-alpha.48",
+  "version": "5.0.0-alpha.49",
   "type": "module",
   "private": true,
   "dependencies": {

package/README.md

@@ -88,7 +88,7 @@ services:
       - agent_kv:/kubb/agent/.kubb/data
     restart: unless-stopped
     healthcheck:
-      test: ["CMD", "node", "-e", "fetch('http://localhost:3000/api/health').then(r => r.ok ? process.exit(0) : process.exit(1)).catch(() => process.exit(1))"]
+      test: ['CMD', 'node', '-e', "fetch('http://localhost:3000/api/health').then(r => r.ok ? process.exit(0) : process.exit(1)).catch(() => process.exit(1))"]
       interval: 15s
       timeout: 10s
       start_period: 60s
@@ -106,18 +106,18 @@ The `agent_kv` named volume persists the KV store (session cache, machine token)
 
 ### Environment Variables
 
-| Variable                     | Default | Description |
-|------------------------------|---|---|
-| `KUBB_AGENT_CONFIG`          | `kubb.config.ts` | Path to your Kubb config file. Relative paths are resolved against `KUBB_AGENT_ROOT`. |
-| `KUBB_AGENT_ROOT`            | `/kubb/agent` (Docker) / `cwd` | Root directory for resolving relative paths. |
-| `PORT`                       | `3000` | Server port. |
-| `HOST`                       | `0.0.0.0` | Server host. |
-| `KUBB_STUDIO_URL`            | `https://studio.kubb.dev` | Kubb Studio WebSocket URL. |
-| `KUBB_AGENT_TOKEN`           | _(empty)_ | Authentication token for Studio. Required to connect. |
-| `KUBB_AGENT_ALLOW_WRITE`     | `false` | Set to `true` to allow writing generated files to disk. |
-| `KUBB_AGENT_ALLOW_ALL`       | `false` | Set to `true` to grant all permissions (implies `KUBB_AGENT_ALLOW_WRITE=true`). |
-| `KUBB_AGENT_RETRY_TIMEOUT`             | `30000` | Milliseconds to wait before retrying a failed Studio connection. |
-| `KUBB_AGENT_HEARTBEAT_URL`             | _(empty)_ | URL to call every 5 minutes to signal the agent is alive (e.g. a Healthchecks.io ping URL). Leave empty to disable. |
+| Variable                   | Default                        | Description                                                                                                         |
+| -------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
+| `KUBB_AGENT_CONFIG`        | `kubb.config.ts`               | Path to your Kubb config file. Relative paths are resolved against `KUBB_AGENT_ROOT`.                               |
+| `KUBB_AGENT_ROOT`          | `/kubb/agent` (Docker) / `cwd` | Root directory for resolving relative paths.                                                                        |
+| `PORT`                     | `3000`                         | Server port.                                                                                                        |
+| `HOST`                     | `0.0.0.0`                      | Server host.                                                                                                        |
+| `KUBB_STUDIO_URL`          | `https://studio.kubb.dev`      | Kubb Studio WebSocket URL.                                                                                          |
+| `KUBB_AGENT_TOKEN`         | _(empty)_                      | Authentication token for Studio. Required to connect.                                                               |
+| `KUBB_AGENT_ALLOW_WRITE`   | `false`                        | Set to `true` to allow writing generated files to disk.                                                             |
+| `KUBB_AGENT_ALLOW_ALL`     | `false`                        | Set to `true` to grant all permissions (implies `KUBB_AGENT_ALLOW_WRITE=true`).                                     |
+| `KUBB_AGENT_RETRY_TIMEOUT` | `30000`                        | Milliseconds to wait before retrying a failed Studio connection.                                                    |
+| `KUBB_AGENT_HEARTBEAT_URL` | _(empty)_                      | URL to call every 5 minutes to signal the agent is alive (e.g. a Healthchecks.io ping URL). Leave empty to disable. |
 
 ### Automatic .env Loading
 
@@ -126,6 +126,7 @@ The agent automatically loads a `.env` file from the current working directory i
 ## Quick Start
 
 1. **Create `.env` file:**
+
 ```env
 PORT=3000
 KUBB_AGENT_ROOT=/path/to/your/project
@@ -135,11 +136,13 @@ KUBB_STUDIO_URL=https://studio.kubb.dev
 ```
 
 2. **Run the agent:**
+
 ```bash
 npx kubb agent start
 ```
 
 3. **Agent is now available at:**
+
 ```
 http://localhost:3000
 ```
@@ -167,6 +170,7 @@ On startup the agent performs these steps before opening a WebSocket:
 ### Session Caching
 
 Sessions are cached in `./.kubb/data` (relative to the working directory, or `agent_kv` volume in Docker) for faster reconnects:
+
 - Tokens are hashed (non-reversible) for security
 - Sessions auto-expire after 24 hours
 - Use `--no-cache` flag to disable caching
@@ -177,6 +181,7 @@ Sessions are cached in `./.kubb/data` (relative to the working directory, or `ag
 ### Messages Sent by Agent
 
 **Connected** — sent in response to a `connect` command
+
 ```json
 {
   "type": "connected",
@@ -188,15 +193,14 @@ Sessions are cached in `./.kubb/data` (relative to the working directory, or `ag
       "allowWrite": false
     },
     "config": {
-      "plugins": [
-        { "name": "@kubb/plugin-ts", "options": {} }
-      ]
+      "plugins": [{ "name": "@kubb/plugin-ts", "options": {} }]
     }
   }
 }
 ```
 
 **Data Events** — streamed during code generation
+
 ```json
 {
   "type": "data",
@@ -211,6 +215,7 @@ Sessions are cached in `./.kubb/data` (relative to the working directory, or `ag
 Available `payload.type` values: `plugin:start`, `plugin:end`, `files:processing:start`, `file:processing:update`, `files:processing:end`, `generation:start`, `generation:end`, `info`, `success`, `warn`, `error`.
 
 **Ping** — sent every 30 seconds to keep the connection alive
+
 ```json
 { "type": "ping" }
 ```
@@ -218,6 +223,7 @@ Available `payload.type` values: `plugin:start`, `plugin:end`, `files:processing
 ### Messages Received from Studio
 
 **Generate Command** — triggers code generation
+
 ```json
 {
   "type": "command",
@@ -225,11 +231,13 @@ Available `payload.type` values: `plugin:start`, `plugin:end`, `files:processing
   "payload": { "plugins": [] }
 }
 ```
+
 `payload` is optional. When omitted, the agent falls back to `kubb.config.studio.json` (a temporal config file next to `kubb.config.ts`), and then to the config loaded from disk.
 
 The `payload` may also include an `input` field containing a raw OpenAPI / Swagger spec (YAML or JSON string). **This field is only honoured in sandbox mode** — outside of sandbox it is silently ignored for security reasons. See [Sandbox Mode](#sandbox-mode) below.
 
 **Connect Command** — requests agent info
+
 ```json
 {
   "type": "command",
@@ -242,19 +250,19 @@ The `payload` may also include an `input` field containing a raw OpenAPI / Swagg
 ```
 
 **Pong** — sent by Studio in response to an agent ping
+
 ```json
 { "type": "pong" }
 ```
 
 **Status** — sent by Studio with information about connected agents
+
 ```json
 {
   "type": "status",
   "message": "...",
   "connectedAgents": 1,
-  "agents": [
-    { "name": "...", "connectedAt": "..." }
-  ]
+  "agents": [{ "name": "...", "connectedAt": "..." }]
 }
 ```
 
@@ -262,11 +270,11 @@ The `payload` may also include an `input` field containing a raw OpenAPI / Swagg
 
 When Kubb Studio provisions a session for the **Sandbox Agent** (the shared agent hosted by Studio itself), it sets `isSandbox: true` in the session response. In sandbox mode the agent behaves differently from a user-owned agent:
 
-| behavior | Normal agent | Sandbox agent |
-|---|---|---|
-| Write generated files to disk | ✅ (when `KUBB_AGENT_ALLOW_WRITE=true`) | ❌ Never |
-| Read `input.path` from disk | ✅ | ✅ (falls back when no inline input supplied) |
-| Accept inline `input` in generate payload | ❌ Ignored | ✅ |
+| behavior                                  | Normal agent                            | Sandbox agent                                 |
+| ----------------------------------------- | --------------------------------------- | --------------------------------------------- |
+| Write generated files to disk             | ✅ (when `KUBB_AGENT_ALLOW_WRITE=true`) | ❌ Never                                      |
+| Read `input.path` from disk               | ✅                                      | ✅ (falls back when no inline input supplied) |
+| Accept inline `input` in generate payload | ❌ Ignored                              | ✅                                            |
 
 ### Why no filesystem writes?
 
@@ -282,14 +290,12 @@ Because the sandbox agent cannot read arbitrary files from disk, callers must su
   "command": "generate",
   "payload": {
     "input": "openapi: 3.0.0\ninfo:\n  title: Pet Store\n  version: 1.0.0\n...",
-    "plugins": [
-      { "name": "@kubb/plugin-ts", "options": {} }
-    ]
+    "plugins": [{ "name": "@kubb/plugin-ts", "options": {} }]
   }
 }
 ```
 
-The `input` value is treated as `InputData` (i.e. `{ data: "<content>" }`) and overrides the `input` from the loaded config for that generation cycle.  **Outside of sandbox mode this field is ignored.**
+The `input` value is treated as `InputData` (i.e. `{ data: "<content>" }`) and overrides the `input` from the loaded config for that generation cycle. **Outside of sandbox mode this field is ignored.**
 
 ## Configuration Example
 
@@ -307,10 +313,7 @@ export default defineConfig({
   output: {
     path: './src/generated',
   },
-  plugins: [
-    pluginOas(),
-    pluginTs(),
-  ],
+  plugins: [pluginOas(), pluginTs()],
 })
 ```
 

package/package.json

@@ -1,36 +1,40 @@
 {
   "name": "@kubb/agent",
-  "version": "5.0.0-alpha.48",
+  "version": "5.0.0-alpha.49",
   "description": "Agent server for Kubb, enabling HTTP-based access to code generation capabilities.",
   "keywords": [
     "agent",
-    "server",
+    "code-generation",
+    "codegen",
     "http",
     "kubb",
-    "code-generation",
     "openapi",
+    "server",
     "swagger",
-    "typescript",
-    "codegen"
+    "typescript"
   ],
+  "license": "AGPL-3.0-or-later",
+  "author": "stijnvanhulle",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kubb-labs/kubb.git",
     "directory": "packages/agent"
   },
-  "license": "AGPL-3.0-or-later",
-  "author": "stijnvanhulle",
-  "sideEffects": false,
-  "type": "module",
-  "exports": {
-    "./package.json": "./package.json"
-  },
   "files": [
     ".output",
     "!/**/**.test.**",
     "!/**/__tests__/**",
     "!/**/__snapshots__/**"
   ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "dependencies": {
     "@logtail/node": "^0.5.8",
     "consola": "^3.4.2",
@@ -39,8 +43,8 @@
     "tinyexec": "^1.1.1",
     "unstorage": "^1.17.5",
     "ws": "^8.20.0",
-    "@kubb/ast": "5.0.0-alpha.48",
-    "@kubb/core": "5.0.0-alpha.48"
+    "@kubb/core": "5.0.0-alpha.49",
+    "@kubb/ast": "5.0.0-alpha.49"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
@@ -48,22 +52,18 @@
     "nitropack": "^2.13.3",
     "vite": "^8.0.8",
     "@internals/utils": "0.0.0",
-    "@kubb/adapter-oas": "5.0.0-alpha.48",
-    "@kubb/parser-ts": "5.0.0-alpha.48"
+    "@kubb/adapter-oas": "5.0.0-alpha.49",
+    "@kubb/parser-ts": "5.0.0-alpha.49"
   },
   "engines": {
     "node": ">=22"
   },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
   "scripts": {
     "build": "nitro build",
     "clean": "npx rimraf ./dist .output",
-    "lint": "bun biome lint .",
+    "lint": "oxlint .",
     "start": "node .output/server/index.mjs",
-    "lint:fix": "bun biome lint --fix --unsafe .",
+    "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
     "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
     "dev": "nitro dev",