@agentuity/cli 2.0.11 → 3.0.0-alpha.0

package/src/cmd/build/vite/vite-asset-server.ts

@@ -1,154 +0,0 @@
-/**
- * Vite Dev Server (Primary)
- *
- * Starts Vite as the primary dev server on the user-facing port.
- * Serves frontend assets natively and proxies API/WebSocket requests
- * to the Bun backend server.
- */
-
-import { join } from 'node:path';
-import { createRequire } from 'node:module';
-import { createServer as createNetServer } from 'node:net';
-import type { ViteDevServer } from 'vite';
-import type { Logger } from '../../../types';
-import { generateAssetServerConfig } from './vite-asset-server-config';
-
-export interface ViteAssetServerResult {
-	server: ViteDevServer;
-	port: number;
-}
-
-export interface StartViteAssetServerOptions {
-	rootDir: string;
-	logger: Logger;
-	workbenchPath?: string;
-	port?: number; // Preferred user-facing port (default: 3500)
-	backendPort: number; // Port of the Bun backend server
-	/** User-defined route mount paths from createApp({ router }) */
-	routePaths?: string[];
-	/** Live tunnel hostname to add to Vite's allowedHosts */
-	liveHostname?: string;
-}
-
-/**
- * Check if a specific port is available on the given host.
- */
-function isPortAvailable(port: number, host: string): Promise<boolean> {
-	return new Promise((resolve) => {
-		const server = createNetServer();
-		server.once('error', () => {
-			resolve(false);
-		});
-		server.listen(port, host, () => {
-			server.close(() => {
-				resolve(true);
-			});
-		});
-	});
-}
-
-/**
- * Find an available port starting from the preferred port.
- * Tries incrementing ports up to maxAttempts times.
- */
-async function findAvailablePort(
-	preferredPort: number,
-	host: string = '127.0.0.1',
-	maxAttempts: number = 20
-): Promise<number> {
-	for (let attempt = 0; attempt < maxAttempts; attempt++) {
-		const port = preferredPort + attempt;
-		const available = await isPortAvailable(port, host);
-		if (available) {
-			return port;
-		}
-	}
-	throw new Error(
-		`Could not find an available port after ${maxAttempts} attempts starting from ${preferredPort}`
-	);
-}
-
-/**
- * Start Vite asset server on a dynamically-chosen port
- * Returns the server instance and the actual port number
- */
-export async function startViteAssetServer(
-	options: StartViteAssetServerOptions
-): Promise<ViteAssetServerResult> {
-	const {
-		rootDir,
-		logger,
-		workbenchPath,
-		port: preferredPort = 3500,
-		backendPort,
-		routePaths,
-		liveHostname,
-	} = options;
-
-	logger.debug('Starting Vite dev server (primary, proxying backend on port %d)...', backendPort);
-
-	// Find an available port for the user-facing Vite server
-	const availablePort = await findAvailablePort(preferredPort, '127.0.0.1');
-
-	if (availablePort !== preferredPort) {
-		logger.info(
-			`Port ${preferredPort} is in use, using port ${availablePort} for Vite dev server`
-		);
-	}
-
-	// Generate config with proxy to Bun backend
-	const config = await generateAssetServerConfig({
-		rootDir,
-		logger,
-		workbenchPath,
-		port: availablePort,
-		backendPort,
-		routePaths,
-		liveHostname,
-	});
-
-	// Dynamically import vite from the project's node_modules
-	// This ensures we resolve from the target project directory, not the CWD
-	const projectRequire = createRequire(join(rootDir, 'package.json'));
-	const { createServer } = await import(projectRequire.resolve('vite'));
-
-	// Create Vite server with config
-	const server = await createServer(config);
-
-	// Start listening with timeout to prevent hangs
-	const STARTUP_TIMEOUT_MS = 30000; // 30 seconds
-
-	try {
-		await Promise.race([
-			server.listen(),
-			new Promise<never>((_, reject) => {
-				const timeoutId = setTimeout(() => {
-					reject(
-						new Error(
-							`Vite asset server failed to start within ${STARTUP_TIMEOUT_MS / 1000}s`
-						)
-					);
-				}, STARTUP_TIMEOUT_MS);
-				// Clean up timeout when listen succeeds (via finally in the outer try)
-				server.httpServer?.once('listening', () => clearTimeout(timeoutId));
-			}),
-		]);
-	} catch (error) {
-		// Attempt to close the server on failure
-		try {
-			await server.close();
-		} catch {
-			// Ignore close errors
-		}
-		throw error;
-	}
-
-	// Port was pre-verified and strictPort:true ensures Vite uses exactly this port
-	const actualPort = availablePort;
-
-	logger.debug(`Vite dev server running on port ${actualPort} (primary)`);
-	logger.debug(`Frontend: HMR, React transformation, source maps (native)`);
-	logger.debug(`Backend: proxying to Bun on port ${backendPort}`);
-
-	return { server, port: actualPort };
-}

package/src/cmd/build/vite/vite-builder.ts

@@ -1,503 +0,0 @@
-/**
- * Vite Builder
- *
- * Utilities for running Vite builds (client, server, workbench)
- */
-
-import { join } from 'node:path';
-import { existsSync, rmSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
-import { createHash } from 'node:crypto';
-import { createRequire } from 'node:module';
-import type { InlineConfig } from 'vite';
-import type { Logger, DeployOptions } from '../../../types';
-import type { BuildReportCollector } from '../../../build-report';
-
-/**
- * Read the pre-built beacon script from @agentuity/frontend package.
- * Tries multiple resolution strategies for workspace/installed/symlink scenarios.
- */
-async function readBeaconScript(projectRoot: string): Promise<string> {
-	let frontendPath: string | null = null;
-
-	try {
-		frontendPath = await Bun.resolve('@agentuity/frontend', projectRoot);
-	} catch {
-		// Not found from project root
-	}
-
-	if (!frontendPath) {
-		try {
-			const thisDir = new URL('.', import.meta.url).pathname;
-			frontendPath = await Bun.resolve('@agentuity/frontend', thisDir);
-		} catch {
-			// Not found from CLI directory
-		}
-	}
-
-	if (!frontendPath) {
-		try {
-			const projectRequire = createRequire(join(projectRoot, 'package.json'));
-			frontendPath = projectRequire.resolve('@agentuity/frontend');
-		} catch {
-			// Not found via createRequire
-		}
-	}
-
-	if (!frontendPath) {
-		throw new Error(
-			'Could not resolve @agentuity/frontend. Ensure the package is installed and built.'
-		);
-	}
-
-	const packageDir = join(frontendPath, '..');
-	const beaconPath = join(packageDir, 'beacon.js');
-
-	const beaconFile = Bun.file(beaconPath);
-	if (!(await beaconFile.exists())) {
-		throw new Error(
-			`Beacon script not found at ${beaconPath}. Run "bun run build" in @agentuity/frontend first.`
-		);
-	}
-
-	return beaconFile.text();
-}
-
-/**
- * Post-build step: inject the analytics beacon into the built index.html.
- *
- * 1. Reads the beacon script from @agentuity/frontend
- * 2. Writes it as a content-hashed asset file
- * 3. Injects a <script data-agentuity-beacon> tag into the HTML
- *
- * This runs after `vite build` completes so it works regardless of the
- * user's vite.config.ts — no Vite plugin required.
- */
-async function injectBeacon(rootDir: string, cdnBaseUrl: string, logger: Logger): Promise<void> {
-	const clientDir = join(rootDir, '.agentuity/client');
-	const indexHtmlPath = join(clientDir, 'index.html');
-
-	if (!existsSync(indexHtmlPath)) {
-		logger.debug('No index.html found, skipping beacon injection');
-		return;
-	}
-
-	let beaconCode: string;
-	try {
-		beaconCode = await readBeaconScript(rootDir);
-	} catch (error) {
-		logger.warn(
-			'Failed to read beacon script, skipping injection: %s',
-			error instanceof Error ? error.message : String(error)
-		);
-		return;
-	}
-
-	// Write beacon as a content-hashed asset (matches Vite's naming convention)
-	const hash = createHash('sha256').update(beaconCode).digest('hex').slice(0, 8);
-	const beaconFileName = `agentuity-beacon-${hash}.js`;
-	const assetsDir = join(clientDir, 'assets');
-	mkdirSync(assetsDir, { recursive: true });
-	writeFileSync(join(assetsDir, beaconFileName), beaconCode);
-
-	// If a Vite manifest exists, add the beacon so the metadata generator
-	// includes it in the asset list. When no manifest exists, the directory
-	// scanner in metadata-generator.ts picks up assets/ directly.
-	const manifestPath = join(clientDir, '.vite', 'manifest.json');
-	if (existsSync(manifestPath)) {
-		const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
-		manifest['agentuity-beacon'] = { file: `assets/${beaconFileName}` };
-		writeFileSync(manifestPath, JSON.stringify(manifest));
-	}
-
-	// Build the beacon URL using the CDN base
-	const normalizedBase = cdnBaseUrl.endsWith('/') ? cdnBaseUrl : `${cdnBaseUrl}/`;
-	const beaconUrl = `${normalizedBase}assets/${beaconFileName}`;
-
-	// Inject the script tag into index.html
-	// The script must be sync (no async/defer) to patch history API before router loads.
-	// The data-agentuity-beacon attribute is the marker the runtime looks for.
-	const beaconScript = `<script data-agentuity-beacon src="${beaconUrl}"></script>`;
-
-	let html = readFileSync(indexHtmlPath, 'utf-8');
-	if (html.includes('</head>')) {
-		html = html.replace('</head>', `${beaconScript}</head>`);
-	} else if (html.includes('<body')) {
-		html = html.replace(/<body([^>]*)>/, `<body$1>${beaconScript}`);
-	} else {
-		html = beaconScript + html;
-	}
-
-	writeFileSync(indexHtmlPath, html);
-	logger.debug('Injected analytics beacon: %s', beaconUrl);
-}
-
-export interface ViteBuildOptions {
-	rootDir: string;
-	mode: 'client' | 'server' | 'workbench';
-	dev?: boolean;
-	port?: number;
-	projectId?: string;
-	orgId?: string;
-	region?: string;
-	deploymentId?: string;
-	workbenchRoute?: string;
-	workbenchEnabled?: boolean;
-	/** Whether analytics is enabled (for beacon injection in client build) */
-	analyticsEnabled?: boolean;
-	logger: Logger;
-	deploymentOptions?: DeployOptions;
-	/** Deployment config from agentuity.json (resources, mode, dependencies, domains) */
-	deploymentConfig?: Record<string, unknown>;
-	/** Optional collector for structured error reporting */
-	collector?: BuildReportCollector;
-	/** Optional config profile name (e.g., 'staging', 'test') for .env.{profile} files */
-	profile?: string;
-}
-
-/**
- * Run a Vite build for the specified mode
- * Uses inline Vite config (customizable via agentuity.config.ts)
- */
-export async function runViteBuild(options: ViteBuildOptions): Promise<void> {
-	const { rootDir, mode, dev = false, logger, profile } = options;
-
-	logger.debug(`Running Vite build for mode: ${mode}`);
-
-	// For server mode, use Bun.build (preserves process.env at runtime)
-	if (mode === 'server') {
-		const srcDir = join(rootDir, 'src');
-
-		// Generate documentation files (if they don't exist)
-		const { generateDocumentation } = await import('./docs-generator');
-		await generateDocumentation(srcDir, logger);
-
-		// Generate/update prompt files in dev mode only (non-blocking)
-		if (dev) {
-			import('./prompt-generator')
-				.then(({ generatePromptFiles }) => generatePromptFiles(srcDir, logger))
-				.catch((err) => logger.warn('Failed to generate prompt files: %s', err.message));
-		}
-
-		// Generate lifecycle types (if setup() exists)
-		const { generateLifecycleTypes } = await import('./lifecycle-generator');
-		await generateLifecycleTypes(rootDir, srcDir, logger);
-
-		// Generate environment types from local .env files
-		const { generateEnvTypes } = await import('./env-types-generator');
-		await generateEnvTypes({
-			rootDir,
-			srcDir,
-			logger,
-			isProduction: !dev,
-			profile,
-		});
-
-		// Build with Bun.build (app.ts is the entrypoint)
-		const { installExternalsAndBuild } = await import('./server-bundler');
-		await installExternalsAndBuild({
-			rootDir,
-			dev,
-			logger,
-		});
-		return;
-	}
-
-	// Dynamically import vite for workbench builds
-	const { build: viteBuild } = await import('vite');
-
-	// For client/workbench, use inline config with vite.config.ts loading
-	let viteConfig: InlineConfig;
-
-	if (mode === 'client') {
-		// For client builds, spawn vite as a subprocess.
-		// This avoids issues with Bun's module loading that cause problems
-		// with certain plugins like @sveltejs/vite-plugin-svelte.
-		// The vite.config.ts in the project handles all configuration.
-		const buildMode = dev ? 'development' : 'production';
-		const clientOutDir = join(rootDir, '.agentuity/client');
-
-		// Ensure vite.config.ts exists (fallback for projects created before v2 template update)
-		const viteConfigPath = join(rootDir, 'vite.config.ts');
-		if (!existsSync(viteConfigPath)) {
-			logger.debug('Generating fallback vite.config.ts');
-			const fallbackConfig = `import react from '@vitejs/plugin-react';
-import { defineConfig } from 'vite';
-import { join } from 'node:path';
-
-export default defineConfig({
-	plugins: [react()],
-	root: '.',
-	build: {
-		rollupOptions: {
-			input: join(__dirname, 'src/web/index.html'),
-		},
-	},
-});
-`;
-			await Bun.write(viteConfigPath, fallbackConfig);
-		}
-
-		// Construct CDN base URL for production builds so Vite prefixes all
-		// asset URLs (CSS, JS chunks) with the CDN origin instead of "/".
-		const cdnBaseUrl =
-			!dev && options.deploymentId
-				? `https://${options.region === 'local' ? 'localstack-static-assets.t3.storageapi.dev' : 'cdn.agentuity.com'}/${options.deploymentId}/client/`
-				: undefined;
-
-		const args = [
-			'bun',
-			'x',
-			'vite',
-			'build',
-			'--mode',
-			buildMode,
-			'--outDir',
-			clientOutDir,
-			'--logLevel',
-			'error',
-			'--clearScreen',
-			'false',
-		];
-		if (cdnBaseUrl) {
-			args.push('--base', cdnBaseUrl);
-		}
-
-		logger.debug('Spawning vite build for client (subprocess mode)');
-		logger.debug('  outDir: %s', clientOutDir);
-		logger.debug('  mode: %s', buildMode);
-		if (cdnBaseUrl) {
-			logger.debug('  base (CDN): %s', cdnBaseUrl);
-		}
-
-		const viteProcess = Bun.spawn(args, {
-			cwd: rootDir,
-			stdout: 'inherit',
-			stderr: 'inherit',
-		});
-
-		const exitCode = await viteProcess.exited;
-
-		if (exitCode !== 0) {
-			throw new Error(`Vite build exited with code ${exitCode}`);
-		}
-
-		logger.debug('Vite build complete for mode: client');
-		return;
-	} else if (mode === 'workbench') {
-		const { workbenchRoute = '/workbench' } = options;
-		// Ensure route ends with / for Vite base
-		const base = workbenchRoute.endsWith('/') ? workbenchRoute : `${workbenchRoute}/`;
-
-		// Workbench is built with React (internal UI)
-		// Use CLI's bundled React plugin since workbench is our code
-		const reactModule = await import('@vitejs/plugin-react');
-		const react = reactModule.default;
-
-		viteConfig = {
-			root: join(rootDir, '.agentuity/workbench-src'), // Use generated workbench source
-			base, // All workbench assets are under the configured route
-			plugins: [react()],
-			envPrefix: ['VITE_', 'AGENTUITY_PUBLIC_', 'PUBLIC_'],
-			build: {
-				outDir: join(rootDir, '.agentuity/workbench'),
-				rollupOptions: {
-					input: join(rootDir, '.agentuity/workbench-src/index.html'),
-				},
-				manifest: true,
-				emptyOutDir: true,
-			},
-			logLevel: 'warn',
-		};
-	} else {
-		throw new Error(`Unknown build mode: ${mode}`);
-	}
-
-	// For workbench mode, use programmatic vite build
-	const buildMode = dev ? 'development' : 'production';
-
-	await viteBuild({
-		...viteConfig,
-		mode: buildMode,
-	});
-
-	logger.debug(`Vite build complete for mode: ${mode}`);
-}
-
-interface BuildResult {
-	workbench: { included: boolean; duration: number };
-	client: { included: boolean; duration: number };
-	server: { included: boolean; duration: number };
-	static: { included: boolean; duration: number; routes: number };
-}
-
-/**
- * Run all builds in sequence: client -> workbench (if enabled) -> server
- */
-export async function runAllBuilds(options: Omit<ViteBuildOptions, 'mode'>): Promise<BuildResult> {
-	const { rootDir, projectId = '', dev = false, logger, collector } = options;
-
-	if (!dev) {
-		rmSync(join(rootDir, '.agentuity'), { force: true, recursive: true });
-	}
-
-	const result: BuildResult = {
-		workbench: { included: false, duration: 0 },
-		client: { included: false, duration: 0 },
-		server: { included: false, duration: 0 },
-		static: { included: false, duration: 0, routes: 0 },
-	};
-
-	// Load runtime config from createApp() in app.ts (v2 approach)
-	const { getWorkbenchConfig, loadRuntimeConfig } = await import('./config-loader');
-	const runtimeConfig = await loadRuntimeConfig(rootDir, logger);
-
-	const workbenchConfig = getWorkbenchConfig(dev, runtimeConfig);
-	// Generate workbench files BEFORE any builds if enabled (dev mode only)
-	if (workbenchConfig.enabled) {
-		logger.debug('Workbench enabled (dev mode), generating files before build...');
-		const { generateWorkbenchFiles } = await import('./workbench-generator');
-		await generateWorkbenchFiles(rootDir, projectId, workbenchConfig, logger);
-	}
-
-	// 1. Discover agents and routes BEFORE builds
-	logger.debug('Discovering agents and routes...');
-	const { discoverAgents } = await import('./agent-discovery');
-	const { discoverRoutes } = await import('./route-discovery');
-
-	const srcDir = join(rootDir, 'src');
-	const agentMetadata = await discoverAgents(
-		srcDir,
-		projectId,
-		options.deploymentId || '',
-		logger
-	);
-	const { routes } = await discoverRoutes(srcDir, projectId, options.deploymentId || '', logger);
-
-	// Agent metadata is used for metadata.json generation (no registry codegen needed)
-
-	// Check if web frontend exists
-	const hasWebFrontend = await Bun.file(join(rootDir, 'src', 'web', 'index.html')).exists();
-
-	// Check if analytics is enabled
-	// v2: analytics config comes from createApp()
-	const analyticsFromRuntime = runtimeConfig?.analytics;
-	const analyticsEnabled =
-		analyticsFromRuntime !== undefined ? analyticsFromRuntime !== false : true;
-
-	// 2. Build client (only if web frontend exists)
-	if (hasWebFrontend) {
-		logger.debug('Building client assets...');
-		const endClientDiagnostic = collector?.startDiagnostic('client-build');
-		const started = Date.now();
-		await runViteBuild({
-			...options,
-			mode: 'client',
-			workbenchEnabled: workbenchConfig.enabled,
-			workbenchRoute: workbenchConfig.route,
-			analyticsEnabled,
-		});
-
-		// Normalize index.html location: vite may output to src/web/index.html
-		// depending on the project's vite.config.ts configuration
-		const clientDir = join(rootDir, '.agentuity/client');
-		const nestedIndexHtml = join(clientDir, 'src/web/index.html');
-		const rootIndexHtml = join(clientDir, 'index.html');
-		if (existsSync(nestedIndexHtml) && !existsSync(rootIndexHtml)) {
-			const { renameSync, mkdirSync: mkdirSyncFs } = await import('node:fs');
-			// Ensure target directory exists
-			mkdirSyncFs(clientDir, { recursive: true });
-			renameSync(nestedIndexHtml, rootIndexHtml);
-			logger.debug('Moved index.html from src/web/ to client root');
-		}
-
-		// Post-build: inject analytics beacon into the built HTML.
-		// Must run AFTER the index.html normalization above (Vite may
-		// output to src/web/index.html which gets moved to the client root).
-		const isLocalRegion = options.region === 'local';
-		const cdnDomain = isLocalRegion
-			? 'localstack-static-assets.t3.storageapi.dev'
-			: 'cdn.agentuity.com';
-		const cdnBaseUrl =
-			!dev && options.deploymentId
-				? `https://${cdnDomain}/${options.deploymentId}/client/`
-				: undefined;
-
-		if (cdnBaseUrl && analyticsEnabled) {
-			await injectBeacon(rootDir, cdnBaseUrl, logger);
-		}
-
-		result.client.included = true;
-		result.client.duration = Date.now() - started;
-		endClientDiagnostic?.();
-	} else {
-		logger.debug('Skipping client build - no src/web/index.html found');
-	}
-
-	// 2b. Static rendering (if entry-server.tsx exists)
-	const entryServerPath = join(rootDir, 'src', 'web', 'entry-server.tsx');
-	if (existsSync(entryServerPath) && hasWebFrontend) {
-		logger.debug('Running static rendering (pre-rendering all routes)...');
-		const endStaticDiagnostic = collector?.startDiagnostic('static-render');
-		const { runStaticRender } = await import('./static-renderer');
-		const staticResult = await runStaticRender({
-			rootDir,
-			logger,
-			dev,
-		});
-		result.static.included = true;
-		result.static.duration = staticResult.duration;
-		result.static.routes = staticResult.routes;
-		endStaticDiagnostic?.();
-	}
-
-	// 3. Build workbench (if enabled in config)
-	if (workbenchConfig.enabled) {
-		logger.debug('Building workbench assets...');
-		const endWorkbenchDiagnostic = collector?.startDiagnostic('workbench-build');
-		const started = Date.now();
-		await runViteBuild({
-			...options,
-			mode: 'workbench',
-			workbenchRoute: workbenchConfig.route,
-			workbenchEnabled: true,
-		});
-		result.workbench.included = true;
-		result.workbench.duration = Date.now() - started;
-		endWorkbenchDiagnostic?.();
-	}
-
-	// 4. Build server
-	logger.debug('Building server...');
-	const endServerDiagnostic = collector?.startDiagnostic('server-build');
-	const serverStarted = Date.now();
-	await runViteBuild({ ...options, mode: 'server' });
-	result.server.included = true;
-	result.server.duration = Date.now() - serverStarted;
-	endServerDiagnostic?.();
-
-	// 5. Generate metadata (after all builds complete)
-	logger.debug('Generating metadata...');
-	const endMetadataDiagnostic = collector?.startDiagnostic('metadata-generation');
-	const { generateMetadata, writeMetadataFile } = await import('./metadata-generator');
-
-	// Generate metadata
-	const metadata = await generateMetadata({
-		rootDir,
-		projectId,
-		orgId: options.orgId,
-		deploymentId: options.deploymentId,
-		agents: agentMetadata,
-		routes,
-		logger,
-		dev,
-		deploymentOptions: options.deploymentOptions,
-		deploymentConfig: options.deploymentConfig,
-	});
-
-	writeMetadataFile(rootDir, metadata, dev, logger);
-	endMetadataDiagnostic?.();
-	logger.debug('Registry and metadata generation complete');
-
-	logger.debug('All builds complete');
-	return result;
-}