@kubb/cli 5.0.0-beta.49 → 5.0.0-beta.50

package/dist/run-Bm3WebIl.js

@@ -1,121 +0,0 @@
-import "./chunk-CRm0XQPb.js";
-import { t as getErrorMessage } from "./errors-CoxrNXaA.js";
-import { t as spawnAsync } from "./shell-BrqyJdB7.js";
-import { i as agentDefaults } from "./constants-84a47qA-.js";
-import { createRequire } from "node:module";
-import { styleText } from "node:util";
-import path from "node:path";
-import { Telemetry } from "@kubb/core";
-import process from "node:process";
-import * as clack from "@clack/prompts";
-import net from "node:net";
-//#region src/runners/agent/utils.ts
-/**
-* Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.
-*/
-function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }) {
-	const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port;
-	const resolvedHost = host !== agentDefaults.host ? host : process.env.HOST ?? agentDefaults.host;
-	const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === "true";
-	const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === "true";
-	const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd();
-	const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile);
-	return {
-		port: resolvedPort,
-		host: resolvedHost,
-		allowWrite: resolvedAllowWrite,
-		allowAll: resolvedAllowAll,
-		agentConfigPath,
-		env: {
-			...process.env,
-			PORT: resolvedPort,
-			HOST: resolvedHost,
-			KUBB_AGENT_ROOT: agentRoot,
-			KUBB_AGENT_CONFIG: agentConfigPath,
-			KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),
-			KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),
-			KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,
-			KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
-			KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl
-		}
-	};
-}
-function isPortAvailable(port, host) {
-	return new Promise((resolve) => {
-		const server = net.createServer();
-		server.once("error", () => resolve(false));
-		server.once("listening", () => {
-			server.close();
-			resolve(true);
-		});
-		server.listen(port, host);
-	});
-}
-//#endregion
-//#region src/runners/agent/run.ts
-/**
-* Spawns the Kubb Agent HTTP server as a Node.js subprocess.
-* Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.
-*/
-async function run({ port, host, configPath, allowWrite, allowAll, version }) {
-	const hrStart = process.hrtime();
-	const report = (status) => Telemetry.send(Telemetry.build({
-		command: "agent",
-		kubbVersion: version,
-		hrStart,
-		status
-	}));
-	try {
-		try {
-			process.loadEnvFile();
-		} catch {}
-		const require = createRequire(import.meta.url);
-		let agentPkgPath;
-		try {
-			agentPkgPath = require.resolve("@kubb/agent/package.json");
-		} catch (_e) {
-			console.error(styleText("red", "The @kubb/agent package is not installed."));
-			console.error("");
-			console.error("Install it with:");
-			console.error(styleText("cyan", "  npm install @kubb/agent"));
-			console.error(styleText("cyan", "  # or"));
-			console.error(styleText("cyan", "  pnpm install @kubb/agent"));
-			console.error("");
-			process.exit(1);
-		}
-		const agentDir = path.dirname(agentPkgPath);
-		const serverPath = path.join(agentDir, agentDefaults.serverEntryPath);
-		const resolvedEnv = resolveAgentStartEnvironment({
-			port,
-			host,
-			configPath,
-			allowWrite,
-			allowAll
-		});
-		const numericPort = Number(resolvedEnv.port);
-		if (!Number.isInteger(numericPort) || numericPort <= 0) throw new Error(`Invalid port "${resolvedEnv.port}". Provide a positive integer with --port or PORT.`);
-		clack.log.step(styleText("cyan", "Starting agent server..."));
-		clack.log.info(styleText("dim", `Config: ${resolvedEnv.agentConfigPath}`));
-		clack.log.info(styleText("dim", `Host: ${resolvedEnv.host}`));
-		clack.log.info(styleText("dim", `Port: ${resolvedEnv.port}`));
-		if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) clack.log.warn(styleText("yellow", "Filesystem writes disabled. Use --allow-write or --allow-all to enable."));
-		if (!await isPortAvailable(numericPort, resolvedEnv.host)) {
-			clack.log.error(styleText("red", `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`));
-			process.exit(1);
-		}
-		await spawnAsync(process.execPath, [serverPath], {
-			env: resolvedEnv.env,
-			cwd: process.cwd()
-		});
-		await report("success");
-	} catch (error) {
-		await report("failed");
-		clack.log.error(styleText("red", "Failed to start agent server"));
-		clack.log.error(getErrorMessage(error));
-		process.exit(1);
-	}
-}
-//#endregion
-export { run };
-
-//# sourceMappingURL=run-Bm3WebIl.js.map

package/dist/run-Bm3WebIl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-Bm3WebIl.js","names":[],"sources":["../src/runners/agent/utils.ts","../src/runners/agent/run.ts"],"sourcesContent":["import net from 'node:net'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { agentDefaults } from '../../constants.ts'\n\ntype AgentStartEnvironmentInput = {\n  /**\n   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n   */\n  port: string | undefined\n  /**\n   * Hostname the HTTP server binds to.\n   */\n  host: string\n  /**\n   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n   */\n  configPath: string | undefined\n  /**\n   * Grants the agent permission to write generated files to the filesystem.\n   */\n  allowWrite: boolean\n  /**\n   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n   */\n  allowAll: boolean\n}\n\ntype ResolvedAgentStartEnvironment = {\n  /**\n   * Final port string after merging CLI flag, `PORT` env var, and the default.\n   */\n  port: string\n  /**\n   * Final hostname after merging CLI flag, `HOST` env var, and the default.\n   */\n  host: string\n  /**\n   * Effective write-permission flag, accounting for `allowAll` and `KUBB_AGENT_ALLOW_WRITE`.\n   */\n  allowWrite: boolean\n  /**\n   * Effective all-permissions flag, accounting for `KUBB_AGENT_ALLOW_ALL`.\n   */\n  allowAll: boolean\n  /**\n   * Absolute path to the Kubb config file passed to the agent subprocess.\n   */\n  agentConfigPath: string\n  /**\n   * Merged `process.env` object with all resolved agent environment variables applied.\n   */\n  env: NodeJS.ProcessEnv\n}\n\n/**\n * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.\n */\nexport function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }: AgentStartEnvironmentInput): ResolvedAgentStartEnvironment {\n  const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port\n  const resolvedHost = host !== agentDefaults.host ? host : (process.env.HOST ?? agentDefaults.host)\n  const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === 'true'\n  const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === 'true'\n  const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd()\n  const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile)\n\n  return {\n    port: resolvedPort,\n    host: resolvedHost,\n    allowWrite: resolvedAllowWrite,\n    allowAll: resolvedAllowAll,\n    agentConfigPath,\n    env: {\n      ...process.env,\n      PORT: resolvedPort,\n      HOST: resolvedHost,\n      KUBB_AGENT_ROOT: agentRoot,\n      KUBB_AGENT_CONFIG: agentConfigPath,\n      KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),\n      KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),\n      KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,\n      KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,\n      KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl,\n    },\n  }\n}\n\nexport function isPortAvailable(port: number, host: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const server = net.createServer()\n    server.once('error', () => resolve(false))\n    server.once('listening', () => {\n      server.close()\n      resolve(true)\n    })\n    server.listen(port, host)\n  })\n}\n","import { createRequire } from 'node:module'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport * as clack from '@clack/prompts'\nimport { spawnAsync, getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\nimport { agentDefaults } from '../../constants.ts'\nimport { isPortAvailable, resolveAgentStartEnvironment } from './utils.ts'\n\ntype AgentStartOptions = {\n  /**\n   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n   */\n  port: string | undefined\n  /**\n   * Hostname the HTTP server binds to.\n   *\n   * @default 'localhost'\n   */\n  host: string\n  /**\n   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n   */\n  configPath: string | undefined\n  /**\n   * Grants the agent permission to write generated files to the filesystem.\n   */\n  allowWrite: boolean\n  /**\n   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n   */\n  allowAll: boolean\n  /**\n   * Current `@kubb/cli` version string, used for the telemetry payload.\n   */\n  version: string\n}\n\n/**\n * Spawns the Kubb Agent HTTP server as a Node.js subprocess.\n * Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.\n */\nexport async function run({ port, host, configPath, allowWrite, allowAll, version }: AgentStartOptions): Promise<void> {\n  const hrStart = process.hrtime()\n  const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'agent', kubbVersion: version, hrStart, status }))\n\n  try {\n    // Load .env file into process.env using Node.js built-in (v20.12.0+)\n    try {\n      process.loadEnvFile()\n    } catch {\n      // .env file may not exist. Ignore\n    }\n\n    // Resolve the @kubb/agent package path, createRequire is CJS/ESM compatible (import.meta.resolve is ESM-only)\n    const require = createRequire(import.meta.url)\n    let agentPkgPath: string\n    try {\n      agentPkgPath = require.resolve('@kubb/agent/package.json')\n    } catch (_e) {\n      console.error(styleText('red', 'The @kubb/agent package is not installed.'))\n      console.error('')\n      console.error('Install it with:')\n      console.error(styleText('cyan', '  npm install @kubb/agent'))\n      console.error(styleText('cyan', '  # or'))\n      console.error(styleText('cyan', '  pnpm install @kubb/agent'))\n      console.error('')\n      process.exit(1)\n    }\n    const agentDir = path.dirname(agentPkgPath)\n    const serverPath = path.join(agentDir, agentDefaults.serverEntryPath)\n\n    const resolvedEnv = resolveAgentStartEnvironment({\n      port,\n      host,\n      configPath,\n      allowWrite,\n      allowAll,\n    })\n    const numericPort = Number(resolvedEnv.port)\n\n    if (!Number.isInteger(numericPort) || numericPort <= 0) {\n      throw new Error(`Invalid port \"${resolvedEnv.port}\". Provide a positive integer with --port or PORT.`)\n    }\n\n    clack.log.step(styleText('cyan', 'Starting agent server...'))\n    clack.log.info(styleText('dim', `Config: ${resolvedEnv.agentConfigPath}`))\n    clack.log.info(styleText('dim', `Host: ${resolvedEnv.host}`))\n    clack.log.info(styleText('dim', `Port: ${resolvedEnv.port}`))\n    if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) {\n      clack.log.warn(styleText('yellow', 'Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))\n    }\n\n    if (!(await isPortAvailable(numericPort, resolvedEnv.host))) {\n      clack.log.error(styleText('red', `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`))\n      process.exit(1)\n    }\n\n    // Spawns the server as a detached background process so the CLI can exit independently.\n    // Reuse the runtime that launched the CLI (Bun or Node) via process.execPath so the\n    // agent stays on the same runtime instead of forcing a `node` binary that may be absent.\n    await spawnAsync(process.execPath, [serverPath], {\n      env: resolvedEnv.env,\n      cwd: process.cwd(),\n    })\n\n    await report('success')\n  } catch (error) {\n    await report('failed')\n    clack.log.error(styleText('red', 'Failed to start agent server'))\n    clack.log.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":"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"}

package/dist/run-CZC17tSi.cjs

@@ -1,125 +0,0 @@
-const require_chunk = require("./chunk-Bx3C2hgW.cjs");
-const require_errors = require("./errors-DykI11xo.cjs");
-const require_shell = require("./shell-Lh-vLWwH.cjs");
-const require_constants = require("./constants-BtmponZ3.cjs");
-let node_util = require("node:util");
-let node_path = require("node:path");
-node_path = require_chunk.__toESM(node_path, 1);
-let _kubb_core = require("@kubb/core");
-let node_module = require("node:module");
-let node_process = require("node:process");
-node_process = require_chunk.__toESM(node_process, 1);
-let _clack_prompts = require("@clack/prompts");
-_clack_prompts = require_chunk.__toESM(_clack_prompts, 1);
-let node_net = require("node:net");
-node_net = require_chunk.__toESM(node_net, 1);
-//#region src/runners/agent/utils.ts
-/**
-* Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.
-*/
-function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }) {
-	const resolvedPort = port ?? node_process.default.env.PORT ?? require_constants.agentDefaults.port;
-	const resolvedHost = host !== require_constants.agentDefaults.host ? host : node_process.default.env.HOST ?? require_constants.agentDefaults.host;
-	const resolvedAllowAll = allowAll || node_process.default.env.KUBB_AGENT_ALLOW_ALL === "true";
-	const resolvedAllowWrite = resolvedAllowAll || allowWrite || node_process.default.env.KUBB_AGENT_ALLOW_WRITE === "true";
-	const agentRoot = node_process.default.env.KUBB_AGENT_ROOT ?? node_process.default.cwd();
-	const agentConfigPath = node_path.default.resolve(node_process.default.cwd(), configPath || node_process.default.env.KUBB_AGENT_CONFIG || require_constants.agentDefaults.configFile);
-	return {
-		port: resolvedPort,
-		host: resolvedHost,
-		allowWrite: resolvedAllowWrite,
-		allowAll: resolvedAllowAll,
-		agentConfigPath,
-		env: {
-			...node_process.default.env,
-			PORT: resolvedPort,
-			HOST: resolvedHost,
-			KUBB_AGENT_ROOT: agentRoot,
-			KUBB_AGENT_CONFIG: agentConfigPath,
-			KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),
-			KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),
-			KUBB_AGENT_TOKEN: node_process.default.env.KUBB_AGENT_TOKEN,
-			KUBB_AGENT_RETRY_TIMEOUT: node_process.default.env.KUBB_AGENT_RETRY_TIMEOUT ?? require_constants.agentDefaults.retryTimeout,
-			KUBB_STUDIO_URL: node_process.default.env.KUBB_STUDIO_URL ?? require_constants.agentDefaults.studioUrl
-		}
-	};
-}
-function isPortAvailable(port, host) {
-	return new Promise((resolve) => {
-		const server = node_net.default.createServer();
-		server.once("error", () => resolve(false));
-		server.once("listening", () => {
-			server.close();
-			resolve(true);
-		});
-		server.listen(port, host);
-	});
-}
-//#endregion
-//#region src/runners/agent/run.ts
-/**
-* Spawns the Kubb Agent HTTP server as a Node.js subprocess.
-* Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.
-*/
-async function run({ port, host, configPath, allowWrite, allowAll, version }) {
-	const hrStart = node_process.default.hrtime();
-	const report = (status) => _kubb_core.Telemetry.send(_kubb_core.Telemetry.build({
-		command: "agent",
-		kubbVersion: version,
-		hrStart,
-		status
-	}));
-	try {
-		try {
-			node_process.default.loadEnvFile();
-		} catch {}
-		const require = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
-		let agentPkgPath;
-		try {
-			agentPkgPath = require.resolve("@kubb/agent/package.json");
-		} catch (_e) {
-			console.error((0, node_util.styleText)("red", "The @kubb/agent package is not installed."));
-			console.error("");
-			console.error("Install it with:");
-			console.error((0, node_util.styleText)("cyan", "  npm install @kubb/agent"));
-			console.error((0, node_util.styleText)("cyan", "  # or"));
-			console.error((0, node_util.styleText)("cyan", "  pnpm install @kubb/agent"));
-			console.error("");
-			node_process.default.exit(1);
-		}
-		const agentDir = node_path.default.dirname(agentPkgPath);
-		const serverPath = node_path.default.join(agentDir, require_constants.agentDefaults.serverEntryPath);
-		const resolvedEnv = resolveAgentStartEnvironment({
-			port,
-			host,
-			configPath,
-			allowWrite,
-			allowAll
-		});
-		const numericPort = Number(resolvedEnv.port);
-		if (!Number.isInteger(numericPort) || numericPort <= 0) throw new Error(`Invalid port "${resolvedEnv.port}". Provide a positive integer with --port or PORT.`);
-		_clack_prompts.log.step((0, node_util.styleText)("cyan", "Starting agent server..."));
-		_clack_prompts.log.info((0, node_util.styleText)("dim", `Config: ${resolvedEnv.agentConfigPath}`));
-		_clack_prompts.log.info((0, node_util.styleText)("dim", `Host: ${resolvedEnv.host}`));
-		_clack_prompts.log.info((0, node_util.styleText)("dim", `Port: ${resolvedEnv.port}`));
-		if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) _clack_prompts.log.warn((0, node_util.styleText)("yellow", "Filesystem writes disabled. Use --allow-write or --allow-all to enable."));
-		if (!await isPortAvailable(numericPort, resolvedEnv.host)) {
-			_clack_prompts.log.error((0, node_util.styleText)("red", `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`));
-			node_process.default.exit(1);
-		}
-		await require_shell.spawnAsync(node_process.default.execPath, [serverPath], {
-			env: resolvedEnv.env,
-			cwd: node_process.default.cwd()
-		});
-		await report("success");
-	} catch (error) {
-		await report("failed");
-		_clack_prompts.log.error((0, node_util.styleText)("red", "Failed to start agent server"));
-		_clack_prompts.log.error(require_errors.getErrorMessage(error));
-		node_process.default.exit(1);
-	}
-}
-//#endregion
-exports.run = run;
-
-//# sourceMappingURL=run-CZC17tSi.cjs.map

package/dist/run-CZC17tSi.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-CZC17tSi.cjs","names":["process","agentDefaults","path","net","process","Telemetry","path","agentDefaults","spawnAsync","getErrorMessage"],"sources":["../src/runners/agent/utils.ts","../src/runners/agent/run.ts"],"sourcesContent":["import net from 'node:net'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { agentDefaults } from '../../constants.ts'\n\ntype AgentStartEnvironmentInput = {\n  /**\n   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n   */\n  port: string | undefined\n  /**\n   * Hostname the HTTP server binds to.\n   */\n  host: string\n  /**\n   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n   */\n  configPath: string | undefined\n  /**\n   * Grants the agent permission to write generated files to the filesystem.\n   */\n  allowWrite: boolean\n  /**\n   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n   */\n  allowAll: boolean\n}\n\ntype ResolvedAgentStartEnvironment = {\n  /**\n   * Final port string after merging CLI flag, `PORT` env var, and the default.\n   */\n  port: string\n  /**\n   * Final hostname after merging CLI flag, `HOST` env var, and the default.\n   */\n  host: string\n  /**\n   * Effective write-permission flag, accounting for `allowAll` and `KUBB_AGENT_ALLOW_WRITE`.\n   */\n  allowWrite: boolean\n  /**\n   * Effective all-permissions flag, accounting for `KUBB_AGENT_ALLOW_ALL`.\n   */\n  allowAll: boolean\n  /**\n   * Absolute path to the Kubb config file passed to the agent subprocess.\n   */\n  agentConfigPath: string\n  /**\n   * Merged `process.env` object with all resolved agent environment variables applied.\n   */\n  env: NodeJS.ProcessEnv\n}\n\n/**\n * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.\n */\nexport function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }: AgentStartEnvironmentInput): ResolvedAgentStartEnvironment {\n  const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port\n  const resolvedHost = host !== agentDefaults.host ? host : (process.env.HOST ?? agentDefaults.host)\n  const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === 'true'\n  const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === 'true'\n  const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd()\n  const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile)\n\n  return {\n    port: resolvedPort,\n    host: resolvedHost,\n    allowWrite: resolvedAllowWrite,\n    allowAll: resolvedAllowAll,\n    agentConfigPath,\n    env: {\n      ...process.env,\n      PORT: resolvedPort,\n      HOST: resolvedHost,\n      KUBB_AGENT_ROOT: agentRoot,\n      KUBB_AGENT_CONFIG: agentConfigPath,\n      KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),\n      KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),\n      KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,\n      KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,\n      KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl,\n    },\n  }\n}\n\nexport function isPortAvailable(port: number, host: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const server = net.createServer()\n    server.once('error', () => resolve(false))\n    server.once('listening', () => {\n      server.close()\n      resolve(true)\n    })\n    server.listen(port, host)\n  })\n}\n","import { createRequire } from 'node:module'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport * as clack from '@clack/prompts'\nimport { spawnAsync, getErrorMessage } from '@internals/utils'\nimport { Telemetry } from '@kubb/core'\nimport { agentDefaults } from '../../constants.ts'\nimport { isPortAvailable, resolveAgentStartEnvironment } from './utils.ts'\n\ntype AgentStartOptions = {\n  /**\n   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).\n   */\n  port: string | undefined\n  /**\n   * Hostname the HTTP server binds to.\n   *\n   * @default 'localhost'\n   */\n  host: string\n  /**\n   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.\n   */\n  configPath: string | undefined\n  /**\n   * Grants the agent permission to write generated files to the filesystem.\n   */\n  allowWrite: boolean\n  /**\n   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.\n   */\n  allowAll: boolean\n  /**\n   * Current `@kubb/cli` version string, used for the telemetry payload.\n   */\n  version: string\n}\n\n/**\n * Spawns the Kubb Agent HTTP server as a Node.js subprocess.\n * Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.\n */\nexport async function run({ port, host, configPath, allowWrite, allowAll, version }: AgentStartOptions): Promise<void> {\n  const hrStart = process.hrtime()\n  const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'agent', kubbVersion: version, hrStart, status }))\n\n  try {\n    // Load .env file into process.env using Node.js built-in (v20.12.0+)\n    try {\n      process.loadEnvFile()\n    } catch {\n      // .env file may not exist. Ignore\n    }\n\n    // Resolve the @kubb/agent package path, createRequire is CJS/ESM compatible (import.meta.resolve is ESM-only)\n    const require = createRequire(import.meta.url)\n    let agentPkgPath: string\n    try {\n      agentPkgPath = require.resolve('@kubb/agent/package.json')\n    } catch (_e) {\n      console.error(styleText('red', 'The @kubb/agent package is not installed.'))\n      console.error('')\n      console.error('Install it with:')\n      console.error(styleText('cyan', '  npm install @kubb/agent'))\n      console.error(styleText('cyan', '  # or'))\n      console.error(styleText('cyan', '  pnpm install @kubb/agent'))\n      console.error('')\n      process.exit(1)\n    }\n    const agentDir = path.dirname(agentPkgPath)\n    const serverPath = path.join(agentDir, agentDefaults.serverEntryPath)\n\n    const resolvedEnv = resolveAgentStartEnvironment({\n      port,\n      host,\n      configPath,\n      allowWrite,\n      allowAll,\n    })\n    const numericPort = Number(resolvedEnv.port)\n\n    if (!Number.isInteger(numericPort) || numericPort <= 0) {\n      throw new Error(`Invalid port \"${resolvedEnv.port}\". Provide a positive integer with --port or PORT.`)\n    }\n\n    clack.log.step(styleText('cyan', 'Starting agent server...'))\n    clack.log.info(styleText('dim', `Config: ${resolvedEnv.agentConfigPath}`))\n    clack.log.info(styleText('dim', `Host: ${resolvedEnv.host}`))\n    clack.log.info(styleText('dim', `Port: ${resolvedEnv.port}`))\n    if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) {\n      clack.log.warn(styleText('yellow', 'Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))\n    }\n\n    if (!(await isPortAvailable(numericPort, resolvedEnv.host))) {\n      clack.log.error(styleText('red', `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`))\n      process.exit(1)\n    }\n\n    // Spawns the server as a detached background process so the CLI can exit independently.\n    // Reuse the runtime that launched the CLI (Bun or Node) via process.execPath so the\n    // agent stays on the same runtime instead of forcing a `node` binary that may be absent.\n    await spawnAsync(process.execPath, [serverPath], {\n      env: resolvedEnv.env,\n      cwd: process.cwd(),\n    })\n\n    await report('success')\n  } catch (error) {\n    await report('failed')\n    clack.log.error(styleText('red', 'Failed to start agent server'))\n    clack.log.error(getErrorMessage(error))\n    process.exit(1)\n  }\n}\n"],"mappings":"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"}

package/dist/run-CvEVkbIx.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-CvEVkbIx.js","names":["process","process"],"sources":["../../../internals/utils/src/packageManager.ts","../../../internals/shared/src/init.ts","../src/runners/init/utils.ts","../src/runners/init/run.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\n/**\n * Supported package manager identifiers.\n *\n * @example\n * ```ts\n * const pm: PackageManagerName = 'pnpm'\n * ```\n */\nexport type PackageManagerName = 'npm' | 'pnpm' | 'yarn' | 'bun'\n\n/**\n * Metadata describing a package manager's lock file and install command.\n */\nexport interface PackageManagerInfo {\n  /**\n   * Identifier used in CLI commands, e.g. `pnpm`, `yarn`.\n   */\n  name: PackageManagerName\n  /**\n   * Lock file name that uniquely identifies this package manager in a project root.\n   */\n  lockFile: string\n  /**\n   * Subcommands passed to the package manager binary to install a dev dependency.\n   */\n  installCommand: ReadonlyArray<string>\n}\n/**\n * Metadata for each supported package manager, keyed by its short name.\n *\n * @example\n * ```ts\n * packageManagers.pnpm.installCommand // ['add', '-D']\n * packageManagers.npm.lockFile        // 'package-lock.json'\n * ```\n */\nconst packageManagers: Record<PackageManagerName, PackageManagerInfo> = {\n  pnpm: {\n    name: 'pnpm',\n    lockFile: 'pnpm-lock.yaml',\n    installCommand: ['add', '-D'],\n  },\n  yarn: {\n    name: 'yarn',\n    lockFile: 'yarn.lock',\n    installCommand: ['add', '-D'],\n  },\n  bun: {\n    name: 'bun',\n    lockFile: 'bun.lockb',\n    installCommand: ['add', '-d'],\n  },\n  npm: {\n    name: 'npm',\n    lockFile: 'package-lock.json',\n    installCommand: ['install', '--save-dev'],\n  },\n}\n\n/**\n * Minimal shape of `package.json` fields read during detection.\n */\ntype PackageJson = {\n  /**\n   * The `packageManager` field from `package.json` (e.g. `\"pnpm@9.0.0\"`).\n   */\n  packageManager?: string\n}\n\n/**\n * Detects the active package manager for the given directory.\n * Resolution order: `packageManager` field in `package.json`, then presence of a lock file.\n * Falls back to `npm` when no signal is found.\n *\n * @example\n * ```ts\n * detectPackageManager('/my/project') // { name: 'pnpm', lockFile: 'pnpm-lock.yaml', ... }\n * detectPackageManager()              // falls back to npm when no lock file is found\n * ```\n */\nexport function detectPackageManager(cwd: string = process.cwd()): PackageManagerInfo {\n  const packageJsonPath = join(cwd, 'package.json')\n  if (existsSync(packageJsonPath)) {\n    try {\n      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as PackageJson\n      const pmField = packageJson.packageManager\n      if (typeof pmField === 'string') {\n        const name = pmField.split('@')[0]\n        if (name && name in packageManagers) {\n          return packageManagers[name as PackageManagerName]\n        }\n      }\n    } catch {\n      // Continue to lock file detection\n    }\n  }\n\n  for (const pm of Object.values(packageManagers)) {\n    if (existsSync(join(cwd, pm.lockFile))) {\n      return pm\n    }\n  }\n\n  return packageManagers.npm\n}\n","import { pluginDefaultConfigs } from './constants.ts'\nimport type { PluginOption } from './types.ts'\n\nexport function generateConfigFile({\n  selectedPlugins,\n  inputPath,\n  outputPath,\n}: {\n  selectedPlugins: PluginOption[]\n  inputPath: string\n  outputPath: string\n}): string {\n  const imports = selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join('\\n')\n\n  const pluginConfigs = selectedPlugins\n    .map((plugin) => {\n      const config = (pluginDefaultConfigs as Record<string, string>)[plugin.value] ?? `${plugin.importName}()`\n      return `    ${config},`\n    })\n    .join('\\n')\n\n  return `import { defineConfig } from 'kubb'\n${imports}\n\nexport default defineConfig({\n  root: '.',\n  input: {\n    path: '${inputPath}',\n  },\n  output: {\n    path: '${outputPath}',\n    clean: true,\n  },\n  plugins: [\n${pluginConfigs}\n  ],\n})\n`\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport type { PackageManagerInfo, PackageManagerName } from '@internals/utils'\nimport { spawnAsync } from '@internals/utils'\n\n/**\n * Returns `true` when a `package.json` exists at `cwd`.\n */\nexport function hasPackageJson(cwd: string = process.cwd()): boolean {\n  return fs.existsSync(path.join(cwd, 'package.json'))\n}\n\n/**\n * Initializes a new `package.json` at `cwd` using the detected package manager.\n */\nexport async function initPackageJson(cwd: string, packageManager: PackageManagerInfo): Promise<void> {\n  const commands: Record<PackageManagerName, Array<string>> = {\n    npm: ['init', '-y'],\n    pnpm: ['init'],\n    yarn: ['init', '-y'],\n    bun: ['init', '-y'],\n  }\n\n  await spawnAsync(packageManager.name, commands[packageManager.name], { cwd })\n}\n\n/**\n * Installs the given packages at `cwd` using the detected package manager.\n */\nexport async function installPackages(packages: Array<string>, packageManager: PackageManagerInfo, cwd: string = process.cwd()): Promise<void> {\n  await spawnAsync(packageManager.name, [...packageManager.installCommand, ...packages], { cwd })\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport * as clack from '@clack/prompts'\nimport { detectPackageManager } from '@internals/utils'\nimport { availablePlugins, generateConfigFile, initDefaults, KUBB_CONFIG_FILENAME, type PluginOption } from '@internals/shared'\nimport { hasPackageJson, initPackageJson, installPackages } from './utils.ts'\n\nfunction cancelAndExit(message = 'Operation canceled.'): never {\n  clack.cancel(message)\n  process.exit(0)\n}\n\ntype InitOptions = {\n  /**\n   * When `true`, skips all interactive prompts and uses default values.\n   */\n  yes: boolean\n  /**\n   * Current `@kubb/cli` version string, shown in the outro and used for package installation.\n   */\n  version: string\n  /**\n   * Input path flag value from `--input`. When provided, skips the input prompt.\n   */\n  input?: string\n  /**\n   * Output directory flag value from `--output`. When provided, skips the output prompt.\n   */\n  output?: string\n  /**\n   * Comma-separated plugin list from `--plugins`, e.g. `'plugin-ts,plugin-zod'`. When provided, skips the plugin selection prompt.\n   */\n  plugins?: string\n}\n\n/**\n * Runs the interactive Kubb scaffolding wizard.\n * Detects the package manager, prompts for input/output paths and plugins, installs packages, and writes `kubb.config.ts`.\n * Pass `yes: true` to skip all prompts and use defaults.\n */\nexport async function run({ yes, version, input: inputFlag, output: outputFlag, plugins: pluginsFlag }: InitOptions): Promise<void> {\n  const cwd = process.cwd()\n\n  clack.intro(styleText('bgCyan', styleText('black', ' Kubb Init ')))\n\n  /**\n   * Returns `flag` when provided, the `defaultValue` when `yes` is set,\n   * or calls `prompt()` for interactive input. Exits on cancellation.\n   */\n  async function resolveOrPrompt<T>(flag: T | undefined, defaultValue: T, logLabel: string, prompt: () => Promise<T | symbol>): Promise<T> {\n    if (flag !== undefined) {\n      clack.log.info(`${logLabel}: ${styleText('cyan', String(flag))}`)\n      return flag\n    }\n    if (yes) {\n      clack.log.info(`${logLabel}: ${styleText('cyan', String(defaultValue))}`)\n      return defaultValue\n    }\n    const result = await prompt()\n    if (clack.isCancel(result)) cancelAndExit()\n    return result as T\n  }\n\n  try {\n    // Check/create package.json, detect package manager once after the block\n    if (!hasPackageJson(cwd)) {\n      if (!yes) {\n        const shouldInit = await clack.confirm({\n          message: 'No package.json found. Would you like to create one?',\n          initialValue: true,\n        })\n\n        if (clack.isCancel(shouldInit) || !shouldInit) {\n          cancelAndExit()\n        }\n      }\n\n      const packageManager = detectPackageManager(cwd)\n      const spinner = clack.spinner()\n      spinner.start(`Initializing package.json with ${packageManager.name}`)\n      await initPackageJson(cwd, packageManager)\n      spinner.stop(`Created package.json with ${packageManager.name}`)\n    }\n\n    const packageManager = detectPackageManager(cwd)\n    if (hasPackageJson(cwd)) {\n      clack.log.info(`Detected package manager: ${styleText('cyan', packageManager.name)}`)\n    }\n\n    // Prompt for OpenAPI spec path\n    const inputPath = await resolveOrPrompt(inputFlag, initDefaults.inputPath, 'Using input path', () =>\n      clack.text({\n        message: 'Where is your OpenAPI specification located?',\n        placeholder: initDefaults.inputPath,\n        defaultValue: initDefaults.inputPath,\n        validate: (value) => {\n          if (!value) return 'Input path is required'\n        },\n      }),\n    )\n\n    // Prompt for output directory\n    const outputPath = await resolveOrPrompt(outputFlag, initDefaults.outputPath, 'Using output path', () =>\n      clack.text({\n        message: 'Where should the generated files be output?',\n        placeholder: initDefaults.outputPath,\n        defaultValue: initDefaults.outputPath,\n        validate: (value) => {\n          if (!value) return 'Output path is required'\n        },\n      }),\n    )\n\n    // Plugin selection\n    const defaultPlugins = availablePlugins.filter((p) => (initDefaults.plugins as ReadonlyArray<string>).includes(p.value))\n    const pluginLabel = (plugins: Array<PluginOption>) => styleText('cyan', plugins.map((p) => p.label).join(', '))\n\n    const selectedPlugins: Array<PluginOption> = await (async () => {\n      if (pluginsFlag) {\n        const requested = pluginsFlag\n          .split(',')\n          .map((v) => v.trim())\n          .filter(Boolean)\n        const plugins = availablePlugins.filter((p) => requested.includes(p.value))\n        if (plugins.length === 0) {\n          clack.log.warn(`No valid plugins found in --plugins value; falling back to default: ${pluginLabel(defaultPlugins)}`)\n          return defaultPlugins\n        }\n        clack.log.info(`Using plugins: ${pluginLabel(plugins)}`)\n        return plugins\n      }\n      if (yes) {\n        clack.log.info(`Using plugins: ${pluginLabel(defaultPlugins)}`)\n        return defaultPlugins\n      }\n      const values = await clack.multiselect({\n        message: 'Select plugins to use:',\n        options: availablePlugins.map(({ value, label, hint }) => ({ value, label, hint })),\n        initialValues: [...initDefaults.plugins],\n        required: true,\n      })\n      if (clack.isCancel(values)) cancelAndExit()\n      return availablePlugins.filter((p) => (values as Array<string>).includes(p.value))\n    })()\n\n    // Install packages\n    const packagesToInstall = ['kubb', ...selectedPlugins.map((p) => p.packageName)]\n\n    const spinner = clack.spinner()\n    spinner.start(`Installing ${packagesToInstall.length} packages with ${packageManager.name}`)\n\n    try {\n      await installPackages(packagesToInstall, packageManager, cwd)\n      spinner.stop(`Installed ${packagesToInstall.length} packages`)\n    } catch (error) {\n      spinner.stop('Installation failed')\n      throw error\n    }\n\n    // Generate config file\n    const configSpinner = clack.spinner()\n    configSpinner.start(`Creating ${KUBB_CONFIG_FILENAME}`)\n\n    const configContent = generateConfigFile({ selectedPlugins, inputPath, outputPath })\n    const configPath = path.join(cwd, KUBB_CONFIG_FILENAME)\n\n    if (fs.existsSync(configPath)) {\n      configSpinner.stop(`${KUBB_CONFIG_FILENAME} already exists`)\n\n      if (!yes) {\n        const shouldOverwrite = await clack.confirm({\n          message: `${KUBB_CONFIG_FILENAME} already exists. Overwrite?`,\n          initialValue: false,\n        })\n\n        if (clack.isCancel(shouldOverwrite) || !shouldOverwrite) {\n          cancelAndExit('Keeping existing configuration. Packages have been installed.')\n        }\n      }\n\n      configSpinner.start(`Overwriting ${KUBB_CONFIG_FILENAME}`)\n    }\n\n    await fs.promises.writeFile(configPath, configContent, 'utf-8')\n\n    configSpinner.stop(`Created ${KUBB_CONFIG_FILENAME}`)\n\n    clack.outro(\n      styleText('green', '✓ All set!') +\n        '\\n\\n' +\n        styleText('dim', 'Next steps:') +\n        '\\n' +\n        styleText('cyan', `  1. Make sure your OpenAPI spec is at: ${inputPath}`) +\n        '\\n' +\n        styleText('cyan', '  2. Generate code with: npx kubb generate') +\n        '\\n' +\n        styleText('cyan', '     Or start a stream server with: npx kubb agent start') +\n        '\\n' +\n        styleText('cyan', `  3. Find generated files in: ${outputPath}`) +\n        '\\n\\n' +\n        styleText('dim', `Using ${packageManager.name} • Kubb v${version}`),\n    )\n  } catch (error) {\n    clack.log.error(styleText('red', 'An error occurred during initialization'))\n    if (error instanceof Error) {\n      clack.log.error(error.message)\n    }\n    process.exit(1)\n  }\n}\n"],"mappings":"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"}

package/src/commands/agent/start.ts

@@ -1,50 +0,0 @@
-import { defineCommand } from '@internals/utils'
-import { version } from '../../../package.json'
-import { agentDefaults } from '../../constants.ts'
-
-export const command = defineCommand({
-  name: 'start',
-  description:
-    'Start the Kubb Agent HTTP server. Exposes a REST API that accepts a kubb.config.ts patch and returns generated code as a stream. Use --allow-write to also write files to disk.',
-  examples: ['kubb agent start', 'kubb agent start --port 4000', 'kubb agent start --allow-write', 'kubb agent start --config ./kubb.config.ts --allow-all'],
-  options: {
-    config: {
-      type: 'string',
-      description: 'Path to the Kubb config file',
-      short: 'c',
-    },
-    port: {
-      type: 'string',
-      description: 'Port the HTTP server listens on',
-      short: 'p',
-      default: agentDefaults.port,
-    },
-    host: {
-      type: 'string',
-      description: 'Hostname the HTTP server binds to',
-      default: agentDefaults.host,
-    },
-    'allow-write': {
-      type: 'boolean',
-      description: 'Write generated files to the filesystem. When omitted, output is streamed only and no files are written.',
-      default: false,
-    },
-    'allow-all': {
-      type: 'boolean',
-      description: 'Grant all permissions (implies --allow-write).',
-      default: false,
-    },
-  },
-  async run({ values }) {
-    const { run } = await import('../../runners/agent/run.ts')
-
-    await run({
-      port: values.port !== undefined ? values.port : undefined,
-      host: values.host,
-      configPath: values.config,
-      allowWrite: values['allow-write'],
-      allowAll: values['allow-all'],
-      version,
-    })
-  },
-})

package/src/commands/agent.ts

@@ -1,10 +0,0 @@
-import { defineCommand } from '@internals/utils'
-import { command as startCommand } from './agent/start.ts'
-
-export const command = defineCommand({
-  name: 'agent',
-  description:
-    'Manage the Kubb Agent — an HTTP server that lets AI agents trigger code generation programmatically via a REST API. Useful when an AI workflow needs to generate code without direct CLI access.',
-  examples: ['kubb agent start', 'kubb agent start --port 4000 --allow-write', 'kubb agent start --config ./kubb.config.ts --allow-all'],
-  subCommands: [startCommand],
-})

package/src/runners/agent/run.ts

@@ -1,115 +0,0 @@
-import { createRequire } from 'node:module'
-import path from 'node:path'
-import process from 'node:process'
-import { styleText } from 'node:util'
-import * as clack from '@clack/prompts'
-import { spawnAsync, getErrorMessage } from '@internals/utils'
-import { Telemetry } from '@kubb/core'
-import { agentDefaults } from '../../constants.ts'
-import { isPortAvailable, resolveAgentStartEnvironment } from './utils.ts'
-
-type AgentStartOptions = {
-  /**
-   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).
-   */
-  port: string | undefined
-  /**
-   * Hostname the HTTP server binds to.
-   *
-   * @default 'localhost'
-   */
-  host: string
-  /**
-   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.
-   */
-  configPath: string | undefined
-  /**
-   * Grants the agent permission to write generated files to the filesystem.
-   */
-  allowWrite: boolean
-  /**
-   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.
-   */
-  allowAll: boolean
-  /**
-   * Current `@kubb/cli` version string, used for the telemetry payload.
-   */
-  version: string
-}
-
-/**
- * Spawns the Kubb Agent HTTP server as a Node.js subprocess.
- * Resolves config from CLI flags and environment variables, validates the port, and exits with code 1 on failure.
- */
-export async function run({ port, host, configPath, allowWrite, allowAll, version }: AgentStartOptions): Promise<void> {
-  const hrStart = process.hrtime()
-  const report = (status: 'success' | 'failed') => Telemetry.send(Telemetry.build({ command: 'agent', kubbVersion: version, hrStart, status }))
-
-  try {
-    // Load .env file into process.env using Node.js built-in (v20.12.0+)
-    try {
-      process.loadEnvFile()
-    } catch {
-      // .env file may not exist. Ignore
-    }
-
-    // Resolve the @kubb/agent package path, createRequire is CJS/ESM compatible (import.meta.resolve is ESM-only)
-    const require = createRequire(import.meta.url)
-    let agentPkgPath: string
-    try {
-      agentPkgPath = require.resolve('@kubb/agent/package.json')
-    } catch (_e) {
-      console.error(styleText('red', 'The @kubb/agent package is not installed.'))
-      console.error('')
-      console.error('Install it with:')
-      console.error(styleText('cyan', '  npm install @kubb/agent'))
-      console.error(styleText('cyan', '  # or'))
-      console.error(styleText('cyan', '  pnpm install @kubb/agent'))
-      console.error('')
-      process.exit(1)
-    }
-    const agentDir = path.dirname(agentPkgPath)
-    const serverPath = path.join(agentDir, agentDefaults.serverEntryPath)
-
-    const resolvedEnv = resolveAgentStartEnvironment({
-      port,
-      host,
-      configPath,
-      allowWrite,
-      allowAll,
-    })
-    const numericPort = Number(resolvedEnv.port)
-
-    if (!Number.isInteger(numericPort) || numericPort <= 0) {
-      throw new Error(`Invalid port "${resolvedEnv.port}". Provide a positive integer with --port or PORT.`)
-    }
-
-    clack.log.step(styleText('cyan', 'Starting agent server...'))
-    clack.log.info(styleText('dim', `Config: ${resolvedEnv.agentConfigPath}`))
-    clack.log.info(styleText('dim', `Host: ${resolvedEnv.host}`))
-    clack.log.info(styleText('dim', `Port: ${resolvedEnv.port}`))
-    if (!resolvedEnv.allowWrite && !resolvedEnv.allowAll) {
-      clack.log.warn(styleText('yellow', 'Filesystem writes disabled. Use --allow-write or --allow-all to enable.'))
-    }
-
-    if (!(await isPortAvailable(numericPort, resolvedEnv.host))) {
-      clack.log.error(styleText('red', `Port ${resolvedEnv.port} is already in use. Stop the existing process or choose a different port with --port.`))
-      process.exit(1)
-    }
-
-    // Spawns the server as a detached background process so the CLI can exit independently.
-    // Reuse the runtime that launched the CLI (Bun or Node) via process.execPath so the
-    // agent stays on the same runtime instead of forcing a `node` binary that may be absent.
-    await spawnAsync(process.execPath, [serverPath], {
-      env: resolvedEnv.env,
-      cwd: process.cwd(),
-    })
-
-    await report('success')
-  } catch (error) {
-    await report('failed')
-    clack.log.error(styleText('red', 'Failed to start agent server'))
-    clack.log.error(getErrorMessage(error))
-    process.exit(1)
-  }
-}

package/src/runners/agent/utils.ts

@@ -1,98 +0,0 @@
-import net from 'node:net'
-import path from 'node:path'
-import process from 'node:process'
-import { agentDefaults } from '../../constants.ts'
-
-type AgentStartEnvironmentInput = {
-  /**
-   * TCP port for the HTTP server. When `undefined`, falls back to `PORT` env var or the default (`3000`).
-   */
-  port: string | undefined
-  /**
-   * Hostname the HTTP server binds to.
-   */
-  host: string
-  /**
-   * Explicit path to the Kubb config file. When `undefined`, falls back to `KUBB_AGENT_CONFIG` or the default filename.
-   */
-  configPath: string | undefined
-  /**
-   * Grants the agent permission to write generated files to the filesystem.
-   */
-  allowWrite: boolean
-  /**
-   * Grants all agent permissions, including filesystem writes. Implies `allowWrite`.
-   */
-  allowAll: boolean
-}
-
-type ResolvedAgentStartEnvironment = {
-  /**
-   * Final port string after merging CLI flag, `PORT` env var, and the default.
-   */
-  port: string
-  /**
-   * Final hostname after merging CLI flag, `HOST` env var, and the default.
-   */
-  host: string
-  /**
-   * Effective write-permission flag, accounting for `allowAll` and `KUBB_AGENT_ALLOW_WRITE`.
-   */
-  allowWrite: boolean
-  /**
-   * Effective all-permissions flag, accounting for `KUBB_AGENT_ALLOW_ALL`.
-   */
-  allowAll: boolean
-  /**
-   * Absolute path to the Kubb config file passed to the agent subprocess.
-   */
-  agentConfigPath: string
-  /**
-   * Merged `process.env` object with all resolved agent environment variables applied.
-   */
-  env: NodeJS.ProcessEnv
-}
-
-/**
- * Resolves the environment passed to the detached agent process using CLI values first, then environment values, then CLI defaults.
- */
-export function resolveAgentStartEnvironment({ port, host, configPath, allowWrite, allowAll }: AgentStartEnvironmentInput): ResolvedAgentStartEnvironment {
-  const resolvedPort = port ?? process.env.PORT ?? agentDefaults.port
-  const resolvedHost = host !== agentDefaults.host ? host : (process.env.HOST ?? agentDefaults.host)
-  const resolvedAllowAll = allowAll || process.env.KUBB_AGENT_ALLOW_ALL === 'true'
-  const resolvedAllowWrite = resolvedAllowAll || allowWrite || process.env.KUBB_AGENT_ALLOW_WRITE === 'true'
-  const agentRoot = process.env.KUBB_AGENT_ROOT ?? process.cwd()
-  const agentConfigPath = path.resolve(process.cwd(), configPath || process.env.KUBB_AGENT_CONFIG || agentDefaults.configFile)
-
-  return {
-    port: resolvedPort,
-    host: resolvedHost,
-    allowWrite: resolvedAllowWrite,
-    allowAll: resolvedAllowAll,
-    agentConfigPath,
-    env: {
-      ...process.env,
-      PORT: resolvedPort,
-      HOST: resolvedHost,
-      KUBB_AGENT_ROOT: agentRoot,
-      KUBB_AGENT_CONFIG: agentConfigPath,
-      KUBB_AGENT_ALLOW_WRITE: String(resolvedAllowWrite),
-      KUBB_AGENT_ALLOW_ALL: String(resolvedAllowAll),
-      KUBB_AGENT_TOKEN: process.env.KUBB_AGENT_TOKEN,
-      KUBB_AGENT_RETRY_TIMEOUT: process.env.KUBB_AGENT_RETRY_TIMEOUT ?? agentDefaults.retryTimeout,
-      KUBB_STUDIO_URL: process.env.KUBB_STUDIO_URL ?? agentDefaults.studioUrl,
-    },
-  }
-}
-
-export function isPortAvailable(port: number, host: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    const server = net.createServer()
-    server.once('error', () => resolve(false))
-    server.once('listening', () => {
-      server.close()
-      resolve(true)
-    })
-    server.listen(port, host)
-  })
-}