@agentuity/cli 1.0.47 → 2.0.0-beta.0

package/src/cmd/build/vite/bun-dev-server.ts

@@ -1,8 +1,12 @@
 /**
  * Bun Dev Server
  *
- * Runs Bun server that handles ALL app logic (HTTP + WebSocket) and proxies
- * frontend asset requests to Vite asset server for HMR support.
+ * Spawns Bun with --hot as a subprocess. Bun's --hot mode re-evaluates changed
+ * modules and hot-swaps the default export's `fetch` handler on the running
+ * server — no process restart, no port rebind, no dropped connections.
+ *
+ * The user's app.ts exports the result of createApp() which includes `fetch`
+ * and `port` properties that Bun uses to manage the server lifecycle.
  */
 
 import type { Logger } from '../../../types';
@@ -11,15 +15,11 @@ import { getAgentEnv } from '../../../agent-detection';
 export interface BunDevServerOptions {
 	rootDir: string;
 	port?: number;
-	projectId?: string;
-	orgId?: string;
-	deploymentId?: string;
 	logger: Logger;
-	vitePort: number; // Port of already-running Vite asset server
-	inspect?: boolean; // Enable bun debugger
-	inspectWait?: boolean; // Enable bun debugger and wait for connection
-	inspectBrk?: boolean; // Enable bun debugger with breakpoint at first line
-	noBundle?: boolean; // Run src/generated/app.ts directly without bundling
+	vitePort: number;
+	inspect?: boolean;
+	inspectWait?: boolean;
+	inspectBrk?: boolean;
 }
 
 export interface BunDevServerResult {
@@ -27,173 +27,97 @@ export interface BunDevServerResult {
 }
 
 /**
- * Start Bun dev server (Vite asset server must already be running)
- *
- * IMPORTANT: This function assumes that the dev bundle has already been built:
- * - Entry file generated at src/generated/app.ts (with workbench config if enabled)
- * - Bundled to .agentuity/app.js with LLM patches applied
- *
- * The bundle is loaded here to ensure AI Gateway routing patches are active.
- * Vite port is read from process.env.VITE_PORT at runtime.
+ * Start Bun dev server with --hot (Vite asset server must already be running).
  *
- * When debugger flags (inspect, inspectWait, inspectBrk) are passed, bun is spawned
- * as a subprocess to enable passing the debugger CLI flags.
+ * Uses `bun --hot` so Bun watches all imported files and hot-swaps the fetch
+ * handler on the running server. The server stays up — only the changed modules
+ * are re-evaluated.
  */
 export async function startBunDevServer(options: BunDevServerOptions): Promise<BunDevServerResult> {
-	const {
-		rootDir,
-		port = 3500,
-		logger,
-		vitePort,
-		inspect,
-		inspectWait,
-		inspectBrk,
-		noBundle,
-	} = options;
+	const { rootDir, port = 3500, logger, vitePort, inspect, inspectWait, inspectBrk } = options;
 
 	logger.debug('Starting Bun dev server (Vite already running on port %d)...', vitePort);
 
-	const appPath = noBundle ? `${rootDir}/src/generated/app.ts` : `${rootDir}/.agentuity/app.js`;
+	const appPath = `${rootDir}/app.ts`;
 
-	// Verify entry file exists before attempting to load
 	const appFile = Bun.file(appPath);
 	if (!(await appFile.exists())) {
-		throw new Error(
-			noBundle
-				? `Generated entry not found at ${appPath}. Run the dev command to generate it.`
-				: `Dev bundle not found at ${appPath}. The bundle must be generated before starting the dev server.`
-		);
+		throw new Error(`App entry not found at ${appPath}.`);
 	}
 
-	// Set PORT env var so the generated app uses the correct port
 	process.env.PORT = String(port);
 
-	// Check if any debugger flag is enabled
-	const useDebugger = inspect || inspectWait || inspectBrk;
-
-	if (useDebugger) {
-		// Spawn bun as subprocess with debugger flag
-		logger.debug('📦 Spawning bun with debugger enabled...');
-
-		// Determine which debugger flag to use (priority: inspectBrk > inspectWait > inspect)
-		let debugFlag: string;
-		if (inspectBrk) {
-			debugFlag = '--inspect-brk';
-		} else if (inspectWait) {
-			debugFlag = '--inspect-wait';
-		} else {
-			debugFlag = '--inspect';
-		}
+	const args: string[] = ['bun'];
 
-		logger.debug('Using debugger flag: %s', debugFlag);
+	// --hot: in-process hot reload — re-evaluates changed modules and swaps
+	// the default export's fetch handler without restarting the process.
+	// --no-clear-screen: don't clear terminal on reload (CLI manages output)
+	args.push('--hot', '--no-clear-screen');
 
-		const bunProcess = Bun.spawn(['bun', debugFlag, 'run', appPath], {
-			cwd: rootDir,
-			stdout: 'inherit',
-			stderr: 'inherit',
-			env: {
-				...process.env,
-				...getAgentEnv(),
-				PORT: String(port),
-			},
-		});
+	if (inspectBrk) {
+		args.push('--inspect-brk');
+	} else if (inspectWait) {
+		args.push('--inspect-wait');
+	} else if (inspect) {
+		args.push('--inspect');
+	}
 
-		// Store the process globally so it can be killed on shutdown
-		// eslint-disable-next-line @typescript-eslint/no-explicit-any
-		(globalThis as any).__AGENTUITY_BUN_SUBPROCESS__ = bunProcess;
-
-		// Wait for server to actually start listening
-		const maxRetries = 50;
-		const retryDelay = 100;
-		let serverReady = false;
-
-		for (let i = 0; i < maxRetries; i++) {
-			try {
-				await fetch(`http://127.0.0.1:${port}/`, {
-					method: 'HEAD',
-					signal: AbortSignal.timeout(1000),
-				});
-				// Any response (even 404) means server is listening
-				serverReady = true;
-				break;
-			} catch {
-				// Connection refused or timeout - server not ready yet
-			}
-			// Wait before next check
-			await new Promise((resolve) => setTimeout(resolve, retryDelay));
-		}
+	args.push('run', appPath);
 
-		if (!serverReady) {
-			// Kill the subprocess if server didn't start
-			try {
-				bunProcess.kill();
-			} catch (err) {
-				logger.debug('Error killing subprocess during startup failure: %s', err);
-			}
-			throw new Error(
-				`Bun server failed to start on port ${port} after ${maxRetries * retryDelay}ms`
-			);
-		}
+	logger.debug('Spawning bun subprocess: %s', args.join(' '));
 
-		logger.debug(`Bun dev server started on http://127.0.0.1:${port} with debugger enabled`);
-		logger.debug(`Asset requests (/@vite/*, /src/web/*, etc.) proxied to Vite:${vitePort}`);
-	} else {
-		// Load the app entry - this will start Bun.serve() internally
-		// In bundle mode: imports .agentuity/app.js (with build-time LLM patches)
-		// In no-bundle mode: imports src/generated/app.ts directly (with runtime patches)
-		logger.debug('Loading app from: %s (noBundle: %s)', appPath, !!noBundle);
-		logger.debug('📦 Loading app entry (Bun server will start)...');
-
-		// Import the generated app with cache-busting query parameter.
-		// Bun's module cache is keyed by the full specifier including query string,
-		// so adding a unique timestamp forces a fresh import on each reload.
-		const cacheBuster = `?t=${Date.now()}`;
-		try {
-			await import(appPath + cacheBuster);
-		} catch (err) {
-			const errorMessage = err instanceof Error ? err.message : String(err);
-			logger.error('Failed to import generated app from %s: %s', appPath, errorMessage);
-			throw new Error(`Failed to load generated app: ${errorMessage}`);
-		}
+	const bunProcess = Bun.spawn(args, {
+		cwd: rootDir,
+		stdout: 'inherit',
+		stderr: 'inherit',
+		env: {
+			...process.env,
+			...getAgentEnv(),
+			PORT: String(port),
+		},
+	});
+
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	(globalThis as any).__AGENTUITY_BUN_SUBPROCESS__ = bunProcess;
+
+	// Wait for server to start listening
+	const maxRetries = 50;
+	const retryDelay = 100;
+	let serverReady = false;
 
-		// Wait for server to actually start listening
-		// The generated app sets (globalThis as any).__AGENTUITY_SERVER__ when server starts
-		const maxRetries = 50; // Increased retries for slower systems
-		const retryDelay = 100; // ms
-		let serverReady = false;
-
-		for (let i = 0; i < maxRetries; i++) {
-			// Check if global server object exists
-			// eslint-disable-next-line @typescript-eslint/no-explicit-any
-			if ((globalThis as any).__AGENTUITY_SERVER__) {
-				// Server object exists, now verify it's actually listening by making a request
-				try {
-					await fetch(`http://127.0.0.1:${port}/`, {
-						method: 'HEAD',
-						signal: AbortSignal.timeout(1000),
-					});
-					// Any response (even 404) means server is listening
-					serverReady = true;
-					break;
-				} catch {
-					// Connection refused or timeout - server not ready yet
-				}
-			}
-			// Wait before next check
-			await new Promise((resolve) => setTimeout(resolve, retryDelay));
+	for (let i = 0; i < maxRetries; i++) {
+		if (bunProcess.exitCode !== null) {
+			throw new Error(`Bun subprocess exited with code ${bunProcess.exitCode} during startup`);
 		}
 
-		if (!serverReady) {
-			throw new Error(
-				`Bun server failed to start on port ${port} after ${maxRetries * retryDelay}ms`
-			);
+		try {
+			await fetch(`http://127.0.0.1:${port}/`, {
+				method: 'HEAD',
+				signal: AbortSignal.timeout(1000),
+			});
+			serverReady = true;
+			break;
+		} catch {
+			// Not ready yet
 		}
+		await new Promise((resolve) => setTimeout(resolve, retryDelay));
+	}
 
-		logger.debug(`Bun dev server started on http://127.0.0.1:${port}`);
-		logger.debug(`Asset requests (/@vite/*, /src/web/*, etc.) proxied to Vite:${vitePort}`);
+	if (!serverReady) {
+		try {
+			bunProcess.kill();
+		} catch (err) {
+			logger.debug('Error killing subprocess during startup failure: %s', err);
+		}
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		(globalThis as any).__AGENTUITY_BUN_SUBPROCESS__ = undefined;
+		throw new Error(
+			`Bun server failed to start on port ${port} after ${maxRetries * retryDelay}ms`
+		);
 	}
 
-	return {
-		bunServerPort: port,
-	};
+	logger.debug(`Bun dev server started on http://127.0.0.1:${port} (--hot mode)`);
+	logger.debug(`Proxied to Vite:${vitePort}`);
+
+	return { bunServerPort: port };
 }

package/src/cmd/build/vite/docs-generator.ts

@@ -18,7 +18,6 @@ This directory contains auto-generated TypeScript files created by the Agentuity
 ## Generated Files
 
 - \`registry.ts\` - Agent registry from \`src/agent/**\`
-- \`routes.ts\` - Route registry from \`src/api/**\`
 - \`app.ts\` - Application entry point
 - \`analytics-config.ts\` - Web analytics configuration from \`agentuity.json\`
 - \`webanalytics.ts\` - Web analytics injection and route registration
@@ -63,7 +62,6 @@ const AGENTS_MD_CONTENT = `# AI Agent Instructions
 ## What Gets Generated
 
 - \`registry.ts\` - Built from agent discovery in \`src/agent/\`
-- \`routes.ts\` - Built from route discovery in \`src/api/\`
 - \`app.ts\` - Entry point assembled from project configuration
 - \`analytics-config.ts\` - Web analytics configuration from \`agentuity.json\`
 - \`webanalytics.ts\` - Web analytics injection and route registration

package/src/cmd/build/vite/index.ts

@@ -3,13 +3,10 @@ import { join } from 'node:path';
 import { createLogger } from '@agentuity/server';
 import type { LogLevel, DeployOptions } from '../../../types';
 import { discoverAgents, type AgentMetadata } from './agent-discovery';
-import { discoverRoutes, type RouteMetadata, type RouteInfo } from './route-discovery';
-import { generateAgentRegistry, generateRouteRegistry } from './registry-generator';
+import { discoverRoutes, type RouteMetadata } from './route-discovery';
 import { generateLifecycleTypes } from './lifecycle-generator';
 import { generateEnvTypes } from './env-types-generator';
 import { generateMetadata, writeMetadataFile, generateRouteMapping } from './metadata-generator';
-import { generateEntryFile } from '../entry-generator';
-import { loadAgentuityConfig, getWorkbenchConfig } from './config-loader';
 
 // Re-export plugins
 export { browserEnvPlugin } from './browser-env-plugin';
@@ -59,7 +56,6 @@ export function agentuityPlugin(options: AgentuityPluginOptions): Plugin {
 	// Store discovered metadata
 	let agents: AgentMetadata[] = [];
 	let routes: RouteMetadata[] = [];
-	let routeInfoList: RouteInfo[] = [];
 
 	logger.trace('Initializing Agentuity Vite plugin', { dev, rootDir, projectId, deploymentId });
 
@@ -73,31 +69,12 @@ export function agentuityPlugin(options: AgentuityPluginOptions): Plugin {
 		async buildStart() {
 			logger.trace('buildStart: Discovering agents and routes');
 
-			// Load agentuity.config.ts for entry file generation
-			const config = await loadAgentuityConfig(rootDir, logger);
-			const workbenchConfig = getWorkbenchConfig(config, dev);
-
-			// Note: Workbench files are generated in runAllBuilds() BEFORE builds start (dev mode only)
-			// We just need the config here for entry file generation
-
 			// Discover agents (read-only)
 			agents = await discoverAgents(srcDir, projectId, deploymentId, logger);
 
 			// Discover routes (read-only)
 			const routeDiscovery = await discoverRoutes(srcDir, projectId, deploymentId, logger);
 			routes = routeDiscovery.routes;
-			routeInfoList = routeDiscovery.routeInfoList;
-
-			// Generate registries
-			if (agents.length > 0) {
-				generateAgentRegistry(srcDir, agents);
-				logger.trace('Generated agent registry with %d agent(s)', agents.length);
-			}
-
-			if (routeInfoList.length > 0) {
-				await generateRouteRegistry(srcDir, routeInfoList, agents);
-				logger.trace('Generated route registry with %d route(s)', routeInfoList.length);
-			}
 
 			// Generate lifecycle types
 			logger.debug('[vite-plugin] About to call generateLifecycleTypes');
@@ -115,17 +92,6 @@ export function agentuityPlugin(options: AgentuityPluginOptions): Plugin {
 			});
 			logger.debug(`[vite-plugin] generateEnvTypes returned: ${envTypesResult}`);
 
-			// Generate entry file (pass workbench and analytics config)
-			await generateEntryFile({
-				rootDir,
-				projectId,
-				deploymentId,
-				logger,
-				mode: dev ? 'dev' : 'prod',
-				workbench: workbenchConfig.configured ? workbenchConfig : undefined,
-				analytics: config?.analytics,
-			});
-
 			logger.trace('buildStart: Discovery complete');
 		},
 
@@ -137,9 +103,6 @@ export function agentuityPlugin(options: AgentuityPluginOptions): Plugin {
 			if (id === 'virtual:agentuity/agents') {
 				return '\0virtual:agentuity/agents';
 			}
-			if (id === 'virtual:agentuity/routes') {
-				return '\0virtual:agentuity/routes';
-			}
 			return null;
 		},
 
@@ -152,10 +115,6 @@ export function agentuityPlugin(options: AgentuityPluginOptions): Plugin {
 				// Re-export from generated registry
 				return `export { agentRegistry } from '../src/generated/registry.js';`;
 			}
-			if (id === '\0virtual:agentuity/routes') {
-				// Re-export from generated route registry
-				return `export { routeRegistry } from '../src/generated/routes.js';`;
-			}
 			return null;
 		},