@kubb/agent 5.0.0-beta.3 → 5.0.0-beta.30

package/.output/server/node_modules/ws/lib/sender.js

@@ -4,6 +4,9 @@
 
 const { Duplex } = require('stream');
 const { randomFillSync } = require('crypto');
+const {
+  types: { isUint8Array }
+} = require('util');
 
 const PerMessageDeflate = require('./permessage-deflate');
 const { EMPTY_BUFFER, kWebSocket, NOOP } = require('./constants');
@@ -200,8 +203,10 @@ class Sender {
 
       if (typeof data === 'string') {
         buf.write(data, 2);
-      } else {
+      } else if (isUint8Array(data)) {
         buf.set(data, 2);
+      } else {
+        throw new TypeError('Second argument must be a string or a Uint8Array');
       }
     }
 

package/.output/server/node_modules/ws/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ws",
-  "version": "8.20.0",
+  "version": "8.20.1",
   "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
   "keywords": [
     "HyBi",

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/agent-prod",
-  "version": "5.0.0-beta.3",
+  "version": "5.0.0-beta.30",
   "type": "module",
   "private": true,
   "dependencies": {
@@ -9,21 +9,18 @@
     "@logtail/tools": "0.5.8",
     "@logtail/types": "0.5.8",
     "@msgpack/msgpack": "2.8.0",
-    "@rolldown/binding-linux-x64-gnu": "1.0.0-rc.17",
-    "@rolldown/pluginutils": "1.0.0-rc.17",
     "anymatch": "3.1.3",
     "chokidar": "5.0.0",
     "consola": "3.4.2",
-    "fflate": "0.8.2",
+    "fflate": "0.8.3",
+    "jiti": "2.7.0",
     "normalize-path": "3.0.0",
     "picomatch": "2.3.2",
     "readdirp": "5.0.0",
-    "remeda": "2.34.0",
-    "rolldown": "1.0.0-rc.17",
+    "remeda": "2.34.1",
     "serialize-error": "8.1.0",
     "stack-trace": "0.0.10",
     "tinyexec": "1.1.2",
-    "unrun": "0.2.37",
-    "ws": "8.20.0"
+    "ws": "8.20.1"
   }
 }

package/README.md

@@ -1,33 +1,41 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo" width="200" />
-</p>
-
-# @kubb/agent
-
-Kubb Agent Server — HTTP server for code generation powered by [Nitro](https://nitro.build) with WebSocket integration for real-time Studio communication.
-
-## Features
-
-- 🚀 Fast HTTP server built with [Nitro](https://nitro.build)
-- 📡 RESTful API endpoints for code generation
-- 🔧 Easy integration with Kubb configuration
-- 📊 Health and info endpoints
-- 🔗 Bidirectional WebSocket with Kubb Studio
-- 🖥️ Machine binding — token locked to the registered machine via stable `machineToken`
-- 💾 Automatic session caching for faster reconnects
-- ⚡ Production-ready
+<div align="center">
+  <h1>@kubb/agent</h1>
+  <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
+    <img width="180" src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo">
+  </a>
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Coverage][coverage-src]][coverage-href]
+[![License][license-src]][license-href]
+[![Sponsors][sponsors-src]][sponsors-href]
+
+<h4>
+<a href="https://kubb.dev/" target="_blank">Documentation</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Request Feature</a>
+</h4>
+</div>
+
+HTTP agent server for Kubb, built on [Nitro](https://nitro.build). It exposes REST endpoints for triggering code generation, a health check, and a bidirectional WebSocket connection to Kubb Studio. Machine tokens are derived from the machine's network identity so they survive restarts. Sessions are cached locally to speed up reconnects.
 
 ## Installation
 
 The agent server is installed as part of `@kubb/cli`:
 
 ```bash
+bun add -D @kubb/cli
+# or
 pnpm add -D @kubb/cli
+# or
+npm install -D @kubb/cli
 ```
 
 ## Usage
 
-### Via CLI (Recommended)
+### Via CLI
 
 Start the agent server using the Kubb CLI:
 
@@ -112,7 +120,7 @@ The `agent_kv` named volume persists the KV store (session cache, machine token)
 | `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_STUDIO_URL`          | `https://kubb.studio`          | 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`).                                     |
@@ -132,7 +140,7 @@ PORT=3000
 KUBB_AGENT_ROOT=/path/to/your/project
 KUBB_AGENT_CONFIG=/path/to/your/project/kubb.config.ts
 KUBB_AGENT_TOKEN=your-token-here
-KUBB_STUDIO_URL=https://studio.kubb.dev
+KUBB_STUDIO_URL=https://kubb.studio
 ```
 
 2. **Run the agent:**
@@ -159,13 +167,15 @@ On startup the agent performs these steps before opening a WebSocket:
 2. **Create session** — calls `POST /api/agent/session/create` (includes `machineToken` for verification) and receives a WebSocket URL.
 3. **Connect** — opens a WebSocket to the returned URL using the `Authorization` header for authentication.
 
-### Connection Features
+### Connection features
 
-- **Automatic reconnection**: Caches session tokens to speed up reconnects
-- **Real-time events**: Streams generation progress and events
-- **Command handling**: Receives `generate` and `connect` commands from Studio
-- **Graceful shutdown**: Notifies Studio when disconnecting
-- **Session management**: 24-hour session expiration with auto-refresh; Studio re-validates session validity on every incoming agent message and disconnects immediately if revoked or expired
+| Feature                | Description                                                                                                                                   |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| Automatic reconnection | Caches session tokens to speed up reconnects                                                                                                  |
+| Real-time events       | Streams generation progress and events                                                                                                        |
+| Command handling       | Receives `generate` and `connect` commands from Studio                                                                                        |
+| Graceful shutdown      | Notifies Studio when disconnecting                                                                                                            |
+| Session management     | 24-hour session expiration with auto-refresh; Studio re-validates every incoming message and disconnects if the session is revoked or expired |
 
 ### Session Caching
 
@@ -324,3 +334,28 @@ npx kubb agent start
 ```
 
 You'll receive a stream of events as the code generation progresses.
+
+## Supporting Kubb
+
+Kubb is an open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
+
+- [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
+
+<p align="center">
+  <a href="https://github.com/sponsors/stijnvanhulle">
+    <img src="https://raw.githubusercontent.com/stijnvanhulle/sponsors/main/sponsors.svg" alt="My sponsors" />
+  </a>
+</p>
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/@kubb/agent?flat&colorA=18181B&colorB=f58517
+[npm-version-href]: https://npmjs.com/package/@kubb/agent
+[npm-downloads-src]: https://img.shields.io/npm/dm/@kubb/agent?flat&colorA=18181B&colorB=f58517
+[npm-downloads-href]: https://npmjs.com/package/@kubb/agent
+[license-src]: https://img.shields.io/github/license/kubb-labs/kubb.svg?flat&colorA=18181B&colorB=f58517
+[license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
+[coverage-src]: https://img.shields.io/codecov/c/github/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517
+[coverage-href]: https://www.npmjs.com/package/@kubb/agent
+[sponsors-src]: https://img.shields.io/github/sponsors/stijnvanhulle?style=flat&colorA=18181B&colorB=f58517
+[sponsors-href]: https://github.com/sponsors/stijnvanhulle/

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@kubb/agent",
-  "version": "5.0.0-beta.3",
-  "description": "Agent server for Kubb, enabling HTTP-based access to code generation capabilities.",
+  "version": "5.0.0-beta.30",
+  "description": "HTTP agent server for Kubb. Exposes code generation via REST API and WebSocket with real-time Kubb Studio integration, machine binding, and Docker support.",
   "keywords": [
     "agent",
-    "code-generation",
     "codegen",
+    "docker",
     "http",
     "kubb",
     "openapi",
     "server",
-    "swagger",
-    "typescript"
+    "typescript",
+    "websocket"
   ],
   "license": "AGPL-3.0-or-later",
   "author": "stijnvanhulle",
@@ -38,22 +38,23 @@
   "dependencies": {
     "@logtail/node": "^0.5.8",
     "consola": "^3.4.2",
-    "remeda": "^2.34.0",
+    "jiti": "^2.7.0",
+    "remeda": "^2.34.1",
     "tinyexec": "^1.1.2",
-    "unrun": "^0.2.37",
     "unstorage": "^1.17.5",
-    "ws": "^8.20.0",
-    "@kubb/ast": "5.0.0-beta.3",
-    "@kubb/core": "5.0.0-beta.3"
+    "ws": "^8.20.1",
+    "@kubb/ast": "5.0.0-beta.30",
+    "@kubb/core": "5.0.0-beta.30"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
-    "msw": "^2.14.2",
+    "msw": "^2.14.6",
     "nitropack": "^2.13.4",
-    "vite": "^8.0.10",
+    "vite": "^8.0.13",
+    "@kubb/adapter-oas": "5.0.0-beta.30",
     "@internals/utils": "0.0.0",
-    "@kubb/adapter-oas": "5.0.0-beta.3",
-    "@kubb/parser-ts": "5.0.0-beta.3"
+    "@kubb/parser-ts": "5.0.0-beta.30",
+    "@kubb/renderer-jsx": "5.0.0-beta.30"
   },
   "engines": {
     "node": ">=22"

package/.output/server/node_modules/@rolldown/binding-linux-x64-gnu/package.json

@@ -1,40 +0,0 @@
-{
-  "name": "@rolldown/binding-linux-x64-gnu",
-  "version": "1.0.0-rc.17",
-  "cpu": [
-    "x64"
-  ],
-  "main": "rolldown-binding.linux-x64-gnu.node",
-  "files": [
-    "rolldown-binding.linux-x64-gnu.node"
-  ],
-  "description": "Fast JavaScript/TypeScript bundler in Rust with Rollup-compatible API.",
-  "keywords": [
-    "bundler",
-    "esbuild",
-    "parcel",
-    "rolldown",
-    "rollup",
-    "webpack"
-  ],
-  "homepage": "https://rolldown.rs/",
-  "license": "MIT",
-  "engines": {
-    "node": "^20.19.0 || >=22.12.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/rolldown/rolldown.git",
-    "directory": "packages/rolldown"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "os": [
-    "linux"
-  ],
-  "libc": [
-    "glibc"
-  ]
-}

package/.output/server/node_modules/@rolldown/pluginutils/dist/filter/composable-filters.js

@@ -1,256 +0,0 @@
-import { cleanUrl, extractQueryWithoutFragment } from "../utils.js";
-class And {
-    kind;
-    args;
-    constructor(...args) {
-        if (args.length === 0) {
-            throw new Error('`And` expects at least one operand');
-        }
-        this.args = args;
-        this.kind = 'and';
-    }
-}
-class Or {
-    kind;
-    args;
-    constructor(...args) {
-        if (args.length === 0) {
-            throw new Error('`Or` expects at least one operand');
-        }
-        this.args = args;
-        this.kind = 'or';
-    }
-}
-class Not {
-    kind;
-    expr;
-    constructor(expr) {
-        this.expr = expr;
-        this.kind = 'not';
-    }
-}
-class Id {
-    kind;
-    pattern;
-    params;
-    constructor(pattern, params) {
-        this.pattern = pattern;
-        this.kind = 'id';
-        this.params = params ?? {
-            cleanUrl: false,
-        };
-    }
-}
-class ImporterId {
-    kind;
-    pattern;
-    params;
-    constructor(pattern, params) {
-        this.pattern = pattern;
-        this.kind = 'importerId';
-        this.params = params ?? {
-            cleanUrl: false,
-        };
-    }
-}
-class ModuleType {
-    kind;
-    pattern;
-    constructor(pattern) {
-        this.pattern = pattern;
-        this.kind = 'moduleType';
-    }
-}
-class Code {
-    kind;
-    pattern;
-    constructor(expr) {
-        this.pattern = expr;
-        this.kind = 'code';
-    }
-}
-class Query {
-    kind;
-    key;
-    pattern;
-    constructor(key, pattern) {
-        this.pattern = pattern;
-        this.key = key;
-        this.kind = 'query';
-    }
-}
-class Include {
-    kind;
-    expr;
-    constructor(expr) {
-        this.expr = expr;
-        this.kind = 'include';
-    }
-}
-class Exclude {
-    kind;
-    expr;
-    constructor(expr) {
-        this.expr = expr;
-        this.kind = 'exclude';
-    }
-}
-export function and(...args) {
-    return new And(...args);
-}
-export function or(...args) {
-    return new Or(...args);
-}
-export function not(expr) {
-    return new Not(expr);
-}
-export function id(pattern, params) {
-    return new Id(pattern, params);
-}
-export function importerId(pattern, params) {
-    return new ImporterId(pattern, params);
-}
-export function moduleType(pattern) {
-    return new ModuleType(pattern);
-}
-export function code(pattern) {
-    return new Code(pattern);
-}
-/*
- * There are three kinds of conditions are supported:
- * 1. `boolean`: if the value is `true`, the key must exist and be truthy. if the value is `false`, the key must not exist or be falsy.
- * 2. `string`: the key must exist and be equal to the value.
- * 3. `RegExp`: the key must exist and match the value.
- */
-export function query(key, pattern) {
-    return new Query(key, pattern);
-}
-export function include(expr) {
-    return new Include(expr);
-}
-export function exclude(expr) {
-    return new Exclude(expr);
-}
-/**
- * convert a queryObject to FilterExpression like
- * ```js
- *   and(query(k1, v1), query(k2, v2))
- * ```
- * @param queryFilterObject The query filter object needs to be matched.
- * @returns a `And` FilterExpression
- */
-export function queries(queryFilter) {
-    let arr = Object.entries(queryFilter).map(([key, value]) => {
-        return new Query(key, value);
-    });
-    return and(...arr);
-}
-export function interpreter(exprs, code, id, moduleType, importerId) {
-    let arr = [];
-    if (Array.isArray(exprs)) {
-        arr = exprs;
-    }
-    else {
-        arr = [exprs];
-    }
-    return interpreterImpl(arr, code, id, moduleType, importerId);
-}
-export function interpreterImpl(expr, code, id, moduleType, importerId, ctx = {}) {
-    let hasInclude = false;
-    for (const e of expr) {
-        switch (e.kind) {
-            case 'include': {
-                hasInclude = true;
-                if (exprInterpreter(e.expr, code, id, moduleType, importerId, ctx)) {
-                    return true;
-                }
-                break;
-            }
-            case 'exclude': {
-                if (exprInterpreter(e.expr, code, id, moduleType, importerId, ctx)) {
-                    return false;
-                }
-                break;
-            }
-        }
-    }
-    return !hasInclude;
-}
-export function exprInterpreter(expr, code, id, moduleType, importerId, ctx = {}) {
-    switch (expr.kind) {
-        case 'and': {
-            return expr.args.every((e) => exprInterpreter(e, code, id, moduleType, importerId, ctx));
-        }
-        case 'or': {
-            return expr.args.some((e) => exprInterpreter(e, code, id, moduleType, importerId, ctx));
-        }
-        case 'not': {
-            return !exprInterpreter(expr.expr, code, id, moduleType, importerId, ctx);
-        }
-        case 'id': {
-            if (id === undefined) {
-                throw new Error('`id` is required for `id` expression');
-            }
-            let idToMatch = id;
-            if (expr.params.cleanUrl) {
-                idToMatch = cleanUrl(idToMatch);
-            }
-            return typeof expr.pattern === 'string'
-                ? idToMatch === expr.pattern
-                : expr.pattern.test(idToMatch);
-        }
-        case 'importerId': {
-            if (importerId === undefined) {
-                return false; // Entry files have no importer, so no match
-            }
-            let importerIdToMatch = importerId;
-            if (expr.params.cleanUrl) {
-                importerIdToMatch = cleanUrl(importerIdToMatch);
-            }
-            return typeof expr.pattern === 'string'
-                ? importerIdToMatch === expr.pattern
-                : expr.pattern.test(importerIdToMatch);
-        }
-        case 'moduleType': {
-            if (moduleType === undefined) {
-                throw new Error('`moduleType` is required for `moduleType` expression');
-            }
-            return moduleType === expr.pattern;
-        }
-        case 'code': {
-            if (code === undefined) {
-                throw new Error('`code` is required for `code` expression');
-            }
-            return typeof expr.pattern === 'string'
-                ? code.includes(expr.pattern)
-                : expr.pattern.test(code);
-        }
-        case 'query': {
-            if (id === undefined) {
-                throw new Error('`id` is required for `Query` expression');
-            }
-            if (!ctx.urlSearchParamsCache) {
-                let queryString = extractQueryWithoutFragment(id);
-                ctx.urlSearchParamsCache = new URLSearchParams(queryString);
-            }
-            let urlParams = ctx.urlSearchParamsCache;
-            if (typeof expr.pattern === 'boolean') {
-                if (expr.pattern) {
-                    return urlParams.has(expr.key);
-                }
-                else {
-                    return !urlParams.has(expr.key);
-                }
-            }
-            else if (typeof expr.pattern === 'string') {
-                return urlParams.get(expr.key) === expr.pattern;
-            }
-            else {
-                return expr.pattern.test(urlParams.get(expr.key) ?? '');
-            }
-        }
-        default: {
-            throw new Error(`Expression ${JSON.stringify(expr)} is not expected.`);
-        }
-    }
-}

package/.output/server/node_modules/@rolldown/pluginutils/dist/filter/filter-vite-plugins.js

@@ -1,75 +0,0 @@
-/**
- * Filters out Vite plugins that have `apply: 'serve'` set.
- *
- * Since Rolldown operates in build mode, plugins marked with `apply: 'serve'`
- * are intended only for Vite's dev server and should be excluded from the build process.
- *
- * @param plugins - Array of plugins (can include nested arrays)
- * @returns Filtered array with serve-only plugins removed
- *
- * @example
- * ```ts
- * import { defineConfig } from 'rolldown';
- * import { filterVitePlugins } from '@rolldown/pluginutils';
- * import viteReact from '@vitejs/plugin-react';
- *
- * export default defineConfig({
- *   plugins: filterVitePlugins([
- *     viteReact(),
- *     {
- *       name: 'dev-only',
- *       apply: 'serve', // This will be filtered out
- *       // ...
- *     }
- *   ])
- * });
- * ```
- */
-export function filterVitePlugins(plugins) {
-    if (!plugins) {
-        return [];
-    }
-    const pluginArray = Array.isArray(plugins) ? plugins : [plugins];
-    const result = [];
-    for (const plugin of pluginArray) {
-        // Skip falsy values
-        if (!plugin) {
-            continue;
-        }
-        // Handle nested arrays recursively
-        if (Array.isArray(plugin)) {
-            result.push(...filterVitePlugins(plugin));
-            continue;
-        }
-        // Check if plugin has apply property
-        const pluginWithApply = plugin;
-        if ('apply' in pluginWithApply) {
-            const applyValue = pluginWithApply.apply;
-            // If apply is a function, call it with build mode
-            if (typeof applyValue === 'function') {
-                try {
-                    const shouldApply = applyValue({}, // config object
-                    { command: 'build', mode: 'production' });
-                    if (shouldApply) {
-                        result.push(plugin);
-                    }
-                }
-                catch {
-                    // If function throws, include the plugin to be safe
-                    result.push(plugin);
-                }
-            } // If apply is 'serve', skip this plugin
-            else if (applyValue === 'serve') {
-                continue;
-            } // If apply is 'build' or anything else, include it
-            else {
-                result.push(plugin);
-            }
-        }
-        else {
-            // No apply property, include the plugin
-            result.push(plugin);
-        }
-    }
-    return result;
-}

package/.output/server/node_modules/@rolldown/pluginutils/dist/filter/index.js

@@ -1,3 +0,0 @@
-export * from "./composable-filters.js";
-export * from "./filter-vite-plugins.js";
-export * from "./simple-filters.js";