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

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

@@ -40,6 +40,10 @@ class Receiver extends Writable {
    *     extensions
    * @param {Boolean} [options.isServer=false] Specifies whether to operate in
    *     client or server mode
+   * @param {Number} [options.maxBufferedChunks=0] The maximum number of
+   *     buffered data chunks
+   * @param {Number} [options.maxFragments=0] The maximum number of message
+   *     fragments
    * @param {Number} [options.maxPayload=0] The maximum allowed message length
    * @param {Boolean} [options.skipUTF8Validation=false] Specifies whether or
    *     not to skip UTF-8 validation for text and close messages
@@ -54,6 +58,8 @@ class Receiver extends Writable {
     this._binaryType = options.binaryType || BINARY_TYPES[0];
     this._extensions = options.extensions || {};
     this._isServer = !!options.isServer;
+    this._maxBufferedChunks = options.maxBufferedChunks | 0;
+    this._maxFragments = options.maxFragments | 0;
     this._maxPayload = options.maxPayload | 0;
     this._skipUTF8Validation = !!options.skipUTF8Validation;
     this[kWebSocket] = undefined;
@@ -89,6 +95,22 @@ class Receiver extends Writable {
   _write(chunk, encoding, cb) {
     if (this._opcode === 0x08 && this._state == GET_INFO) return cb();
 
+    if (
+      this._maxBufferedChunks > 0 &&
+      this._buffers.length >= this._maxBufferedChunks
+    ) {
+      cb(
+        this.createError(
+          RangeError,
+          'Too many buffered chunks',
+          false,
+          1008,
+          'WS_ERR_TOO_MANY_BUFFERED_PARTS'
+        )
+      );
+      return;
+    }
+
     this._bufferedBytes += chunk.length;
     this._buffers.push(chunk);
     this.startLoop(cb);
@@ -485,6 +507,22 @@ class Receiver extends Writable {
     }
 
     if (data.length) {
+      if (
+        this._maxFragments > 0 &&
+        this._fragments.length >= this._maxFragments
+      ) {
+        const error = this.createError(
+          RangeError,
+          'Too many message fragments',
+          false,
+          1008,
+          'WS_ERR_TOO_MANY_BUFFERED_PARTS'
+        );
+
+        cb(error);
+        return;
+      }
+
       //
       // This message is not compressed so its length is the sum of the payload
       // length of all fragments.
@@ -524,6 +562,22 @@ class Receiver extends Writable {
           return;
         }
 
+        if (
+          this._maxFragments > 0 &&
+          this._fragments.length >= this._maxFragments
+        ) {
+          const error = this.createError(
+            RangeError,
+            'Too many message fragments',
+            false,
+            1008,
+            'WS_ERR_TOO_MANY_BUFFERED_PARTS'
+          );
+
+          cb(error);
+          return;
+        }
+
         this._fragments.push(buf);
       }
 

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/lib/websocket-server.js

@@ -43,6 +43,10 @@ class WebSocketServer extends EventEmitter {
    *     called
    * @param {Function} [options.handleProtocols] A hook to handle protocols
    * @param {String} [options.host] The hostname where to bind the server
+   * @param {Number} [options.maxBufferedChunks=1048576] The maximum number of
+   *     buffered data chunks
+   * @param {Number} [options.maxFragments=131072] The maximum number of message
+   *     fragments
    * @param {Number} [options.maxPayload=104857600] The maximum allowed message
    *     size
    * @param {Boolean} [options.noServer=false] Enable no server mode
@@ -65,6 +69,8 @@ class WebSocketServer extends EventEmitter {
     options = {
       allowSynchronousEvents: true,
       autoPong: true,
+      maxBufferedChunks: 1024 * 1024,
+      maxFragments: 128 * 1024,
       maxPayload: 100 * 1024 * 1024,
       skipUTF8Validation: false,
       perMessageDeflate: false,
@@ -424,6 +430,8 @@ class WebSocketServer extends EventEmitter {
 
     ws.setSocket(socket, head, {
       allowSynchronousEvents: this.options.allowSynchronousEvents,
+      maxBufferedChunks: this.options.maxBufferedChunks,
+      maxFragments: this.options.maxFragments,
       maxPayload: this.options.maxPayload,
       skipUTF8Validation: this.options.skipUTF8Validation
     });

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

@@ -201,6 +201,10 @@ class WebSocket extends EventEmitter {
    *     multiple times in the same tick
    * @param {Function} [options.generateMask] The function used to generate the
    *     masking key
+   * @param {Number} [options.maxBufferedChunks=0] The maximum number of
+   *     buffered data chunks
+   * @param {Number} [options.maxFragments=0] The maximum number of message
+   *     fragments
    * @param {Number} [options.maxPayload=0] The maximum allowed message size
    * @param {Boolean} [options.skipUTF8Validation=false] Specifies whether or
    *     not to skip UTF-8 validation for text and close messages
@@ -212,6 +216,8 @@ class WebSocket extends EventEmitter {
       binaryType: this.binaryType,
       extensions: this._extensions,
       isServer: this._isServer,
+      maxBufferedChunks: options.maxBufferedChunks,
+      maxFragments: options.maxFragments,
       maxPayload: options.maxPayload,
       skipUTF8Validation: options.skipUTF8Validation
     });
@@ -640,6 +646,10 @@ module.exports = WebSocket;
  *     masking key
  * @param {Number} [options.handshakeTimeout] Timeout in milliseconds for the
  *     handshake request
+ * @param {Number} [options.maxBufferedChunks=1048576] The maximum number of
+ *     buffered data chunks
+ * @param {Number} [options.maxFragments=131072] The maximum number of message
+ *     fragments
  * @param {Number} [options.maxPayload=104857600] The maximum allowed message
  *     size
  * @param {Number} [options.maxRedirects=10] The maximum number of redirects
@@ -660,6 +670,8 @@ function initAsClient(websocket, address, protocols, options) {
     autoPong: true,
     closeTimeout: CLOSE_TIMEOUT,
     protocolVersion: protocolVersions[1],
+    maxBufferedChunks: 1024 * 1024,
+    maxFragments: 128 * 1024,
     maxPayload: 100 * 1024 * 1024,
     skipUTF8Validation: false,
     perMessageDeflate: true,
@@ -1017,6 +1029,8 @@ function initAsClient(websocket, address, protocols, options) {
     websocket.setSocket(socket, head, {
       allowSynchronousEvents: opts.allowSynchronousEvents,
       generateMask: opts.generateMask,
+      maxBufferedChunks: opts.maxBufferedChunks,
+      maxFragments: opts.maxFragments,
       maxPayload: opts.maxPayload,
       skipUTF8Validation: opts.skipUTF8Validation
     });

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

@@ -1,6 +1,6 @@
 {
   "name": "ws",
-  "version": "8.20.0",
+  "version": "8.21.0",
   "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.31",
   "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.21.0"
   }
 }

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.31",
+  "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.21.0",
+    "@kubb/ast": "5.0.0-beta.31",
+    "@kubb/core": "5.0.0-beta.31"
   },
   "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.14",
     "@internals/utils": "0.0.0",
-    "@kubb/adapter-oas": "5.0.0-beta.3",
-    "@kubb/parser-ts": "5.0.0-beta.3"
+    "@kubb/adapter-oas": "5.0.0-beta.31",
+    "@kubb/parser-ts": "5.0.0-beta.31",
+    "@kubb/renderer-jsx": "5.0.0-beta.31"
   },
   "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"
-  ]
-}