@kubb/agent 5.0.0-beta.6 → 5.0.0-beta.7

package/.output/nitro.json

@@ -1,5 +1,5 @@
 {
-  "date": "2026-05-09T18:02:50.797Z",
+  "date": "2026-05-12T10:56:59.171Z",
   "preset": "node-server",
   "framework": {
     "name": "nitro",

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

@@ -6468,7 +6468,7 @@ const fsStorage = createStorage(() => ({
     await clean(resolve(base));
   }
 }));
-var version$1 = "5.0.0-beta.6";
+var version$1 = "5.0.0-beta.7";
 function getDiagnosticInfo() {
   return {
     nodeVersion: version$2,
@@ -6905,7 +6905,7 @@ const memoryStorage = createStorage(() => {
   };
 });
 
-var version = "5.0.0-beta.6";
+var version = "5.0.0-beta.7";
 
 function isCommandMessage(msg) {
   return msg.type === "command";

package/.output/server/package.json

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

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:
 
@@ -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.6",
-  "description": "Agent server for Kubb, enabling HTTP-based access to code generation capabilities.",
+  "version": "5.0.0-beta.7",
+  "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",
@@ -43,18 +43,18 @@
     "tinyexec": "^1.1.2",
     "unstorage": "^1.17.5",
     "ws": "^8.20.0",
-    "@kubb/ast": "5.0.0-beta.6",
-    "@kubb/core": "5.0.0-beta.6"
+    "@kubb/ast": "5.0.0-beta.7",
+    "@kubb/core": "5.0.0-beta.7"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
-    "msw": "^2.14.4",
+    "msw": "^2.14.6",
     "nitropack": "^2.13.4",
-    "vite": "^8.0.11",
+    "vite": "^8.0.12",
     "@internals/utils": "0.0.0",
-    "@kubb/parser-ts": "5.0.0-beta.6",
-    "@kubb/adapter-oas": "5.0.0-beta.6",
-    "@kubb/renderer-jsx": "5.0.0-beta.6"
+    "@kubb/adapter-oas": "5.0.0-beta.7",
+    "@kubb/parser-ts": "5.0.0-beta.7",
+    "@kubb/renderer-jsx": "5.0.0-beta.7"
   },
   "engines": {
     "node": ">=22"