@agentuity/cli 2.0.11 → 3.0.0-alpha.0

package/src/cmd/build/vite/static-renderer.ts

@@ -1,239 +0,0 @@
-/**
- * Static Renderer
- *
- * When `src/web/entry-server.tsx` exists, this module:
- * 1. Runs a Vite SSR build (as a subprocess to avoid in-process Bun/Vite issues)
- * 2. Imports the built entry-server.js
- * 3. Discovers routes to pre-render:
- *    - If `routeTree` is exported: auto-discovers all non-parameterized routes
- *    - If `getStaticPaths()` is exported: merges those paths in (for parameterized routes)
- *    - If neither: throws an error
- * 4. Calls render(url) for each route
- * 5. Replaces <!--app-html--> in the client template with rendered HTML
- * 6. Writes pre-rendered HTML files to .agentuity/client/
- */
-
-import { join } from 'node:path';
-import { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from 'node:fs';
-import type { Logger } from '../../../types';
-
-/** Minimal shape of a TanStack Router route tree node. */
-interface RouteTreeNode {
-	path?: string;
-	options?: { path?: string };
-	children?: Record<string, RouteTreeNode>;
-}
-
-/**
- * Walks a TanStack Router route tree and extracts all non-parameterized paths.
- * Skips layout routes (no path) and parameterized routes (containing $).
- *
- * Accumulates the full URL path through the parent chain, since child routes
- * under layout routes have relative paths (e.g., '/key-value' under a
- * '/reference/api' layout should resolve to '/reference/api/key-value').
- */
-function extractRoutePaths(node: RouteTreeNode): string[] {
-	const paths = new Set<string>();
-
-	function walk(route: RouteTreeNode, parentPath: string) {
-		const segment: string | undefined = route.path ?? route.options?.path;
-
-		// Build the full path by accumulating segments from parent routes.
-		// - Layout routes have no path (undefined) and don't contribute to the URL.
-		// - Index routes have path '/' and resolve to the parent path itself.
-		// - Leaf/layout routes have paths like '/reference/api' or '/key-value'.
-		let currentPath = parentPath;
-		if (segment && segment !== '/') {
-			// Non-root segment: append to parent path.
-			// Segments always start with '/' (TanStack Router convention).
-			currentPath = parentPath === '/' ? segment : parentPath + segment;
-		}
-
-		// Add non-parameterized, non-empty paths
-		if (currentPath && !currentPath.includes('$')) {
-			const normalized = currentPath === '/' ? '/' : currentPath.replace(/\/+$/, '');
-			if (normalized) {
-				paths.add(normalized);
-			}
-		}
-
-		// Recurse into children, passing the accumulated path
-		const children = route.children;
-		if (children && typeof children === 'object') {
-			for (const child of Object.values(children)) {
-				if (child) walk(child, currentPath);
-			}
-		}
-	}
-
-	walk(node, '');
-	return [...paths].sort();
-}
-
-export interface StaticRenderOptions {
-	rootDir: string;
-	logger: Logger;
-	dev?: boolean;
-}
-
-export interface StaticRenderResult {
-	routes: number;
-	duration: number;
-}
-
-export async function runStaticRender(options: StaticRenderOptions): Promise<StaticRenderResult> {
-	const { rootDir, logger, dev = false } = options;
-	const started = Date.now();
-
-	const clientDir = join(rootDir, '.agentuity/client');
-	const ssrOutDir = join(rootDir, '.agentuity/ssr');
-	const entryServerPath = join(rootDir, 'src/web/entry-server.tsx');
-	const templatePath = join(clientDir, 'index.html');
-
-	// Verify prerequisites
-	if (!existsSync(entryServerPath)) {
-		throw new Error(
-			'Static rendering requires src/web/entry-server.tsx. ' +
-				'This file must export a render(url: string) function and either ' +
-				'a routeTree for auto-discovery or getStaticPaths() for explicit paths.'
-		);
-	}
-
-	if (!existsSync(templatePath)) {
-		throw new Error(
-			'Client build must complete before static rendering. ' +
-				'No index.html found in .agentuity/client/'
-		);
-	}
-
-	// Step 1: Vite SSR build (subprocess)
-	// Run as a subprocess to avoid in-process Bun/Vite module resolution issues
-	// that cause @mdx-js/rollup and other plugins to fail during SSR builds.
-	// This matches the approach used for client builds in vite-builder.ts.
-	logger.debug('Running Vite SSR build for static rendering (subprocess)...');
-
-	const buildMode = dev ? 'development' : 'production';
-
-	const viteProcess = Bun.spawn(
-		[
-			'bun',
-			'x',
-			'vite',
-			'build',
-			'--ssr',
-			entryServerPath,
-			'--outDir',
-			ssrOutDir,
-			'--mode',
-			buildMode,
-		],
-		{
-			cwd: rootDir,
-			stdout: 'inherit',
-			stderr: 'inherit',
-		}
-	);
-
-	const exitCode = await viteProcess.exited;
-
-	if (exitCode !== 0) {
-		throw new Error(`Vite SSR build exited with code ${exitCode}`);
-	}
-
-	// Steps 2–4: wrapped in try-finally so SSR artifacts are always cleaned up,
-	// even if an exception is thrown during module import, validation, or rendering.
-	let routeCount = 0;
-	try {
-		// Step 2: Import the built SSR entry
-		const ssrEntryPath = join(ssrOutDir, 'entry-server.js');
-		if (!existsSync(ssrEntryPath)) {
-			throw new Error(`SSR build did not produce entry-server.js at ${ssrEntryPath}`);
-		}
-
-		const ssrModule = await import(ssrEntryPath);
-
-		if (typeof ssrModule.render !== 'function') {
-			throw new Error(
-				'entry-server.tsx must export a render(url: string) function that returns HTML string'
-			);
-		}
-
-		// Step 3: Discover routes
-		// Priority: auto-discover from routeTree + merge getStaticPaths() if present
-		const discovered = new Set<string>();
-
-		// 3a. Auto-discover from exported routeTree (skips parameterized routes)
-		if (ssrModule.routeTree) {
-			const autoRoutes = extractRoutePaths(ssrModule.routeTree);
-			for (const r of autoRoutes) {
-				discovered.add(r);
-			}
-			logger.debug(`Auto-discovered ${autoRoutes.length} routes from route tree`);
-		}
-
-		// 3b. Merge paths from getStaticPaths() if exported (for parameterized routes, etc.)
-		if (typeof ssrModule.getStaticPaths === 'function') {
-			const extraRoutes = await ssrModule.getStaticPaths();
-			if (!Array.isArray(extraRoutes)) {
-				throw new Error(
-					'getStaticPaths() must return an array of URL paths (e.g., ["/", "/about"])'
-				);
-			}
-			for (const r of extraRoutes) {
-				discovered.add(r);
-			}
-			logger.debug(`getStaticPaths() added ${extraRoutes.length} paths`);
-		}
-
-		// Must have at least one source of routes
-		if (discovered.size === 0) {
-			throw new Error(
-				'No routes to pre-render. Export routeTree from entry-server.tsx for auto-discovery, ' +
-					'or export getStaticPaths() returning an array of URL paths.'
-			);
-		}
-
-		const routes: string[] = [...discovered].sort();
-		routeCount = routes.length;
-		logger.debug(`Total: ${routes.length} routes for pre-rendering`);
-
-		// Step 4: Read template and pre-render each route
-		const template = readFileSync(templatePath, 'utf-8');
-		if (!template.includes('<!--app-html-->')) {
-			logger.warn(
-				'index.html is missing the <!--app-html--> placeholder; ' +
-					'pre-rendered content will not be injected into the page.'
-			);
-		}
-
-		for (const route of routes) {
-			try {
-				const html = await ssrModule.render(route);
-				const page = template.replace('<!--app-html-->', html);
-
-				let outPath: string;
-				if (route === '/') {
-					outPath = join(clientDir, 'index.html');
-				} else {
-					const dir = join(clientDir, route.slice(1));
-					mkdirSync(dir, { recursive: true });
-					outPath = join(dir, 'index.html');
-				}
-
-				writeFileSync(outPath, page, 'utf-8');
-			} catch (err) {
-				const message = err instanceof Error ? err.message : String(err);
-				logger.warn(`Failed to render route ${route}: ${message}`);
-				// Continue rendering other routes
-			}
-		}
-	} finally {
-		// Step 5: Clean up SSR build artifacts (always runs, even on error)
-		rmSync(ssrOutDir, { recursive: true, force: true });
-	}
-
-	const duration = Date.now() - started;
-	logger.debug(`Static rendering complete: ${routeCount} routes in ${duration}ms`);
-
-	return { routes: routeCount, duration };
-}

package/src/cmd/build/vite/tailwind-source-plugin.ts

@@ -1,73 +0,0 @@
-/**
- * Vite plugin to fix Tailwind v4 oxide scanner hang in containers
- *
- * The Tailwind v4 oxide scanner (native Rust binary) can hang or fail when
- * scanning the filesystem in containerized environments. Adding source(none)
- * to @import "tailwindcss" disables the oxide filesystem scanner, and an
- * explicit @source directive pointing at the project's src/ directory tells
- * Tailwind exactly where to find utility classes.
- *
- * @see https://github.com/tailwindlabs/tailwindcss/discussions/19661
- * @see https://tailwindcss.com/docs/detecting-classes-in-source-files
- */
-
-import { dirname, join, relative, sep } from 'node:path';
-import type { Plugin } from 'vite';
-
-export function tailwindSourcePlugin(): Plugin {
-	let root: string;
-
-	return {
-		name: 'agentuity:tailwind-source',
-		enforce: 'pre',
-
-		configResolved(config) {
-			root = config.root;
-		},
-
-		transform(code, id) {
-			// Only transform CSS files
-			if (!id.endsWith('.css')) {
-				return null;
-			}
-
-			// Check if the file contains @import "tailwindcss" (with either quote type)
-			if (!/@import\s+["']tailwindcss["']/.test(code)) {
-				return null;
-			}
-
-			// Compute relative path from CSS file to project's src/ directory
-			const cssDir = dirname(id);
-			const srcDir = join(root, 'src');
-			let relPath = relative(cssDir, srcDir).split(sep).join('/');
-			if (relPath === '') {
-				relPath = '.';
-			} else if (!relPath.startsWith('.')) {
-				relPath = './' + relPath;
-			}
-
-			// Transform @import "tailwindcss" → @import "tailwindcss" source(none)
-			// and add explicit @source so Tailwind knows where to scan for classes.
-			// Does NOT transform if source() is already specified.
-			const transformed = code.replace(
-				/@import\s+(["'])tailwindcss\1([^;]*);/g,
-				(match, quote, rest) => {
-					// If source() is already present, don't modify
-					if (/source\s*\(/.test(rest)) {
-						return match;
-					}
-					return `@import ${quote}tailwindcss${quote}${rest} source(none);\n@source "${relPath}";`;
-				}
-			);
-
-			if (transformed !== code) {
-				return {
-					code: transformed,
-					map: null,
-				};
-			}
-
-			return null;
-		},
-	};
-}

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

@@ -1,349 +0,0 @@
-/**
- * Vite Dev Server Configuration
- *
- * Vite is the primary dev server — serves frontend assets natively and proxies
- * API/WebSocket requests to the Bun backend server.
- */
-
-import { join } from 'node:path';
-import { existsSync } from 'node:fs';
-import type { InlineConfig, Plugin } from 'vite';
-import type { Logger } from '../../../types';
-
-export interface GenerateAssetServerConfigOptions {
-	rootDir: string;
-	logger: Logger;
-	workbenchPath?: string;
-	port: number; // The port Vite will listen on (user-facing)
-	backendPort: number; // The port Bun backend is running on (internal)
-	/** User-defined route mount paths from createApp({ router }) (e.g., ['/api', '/v1']) */
-	routePaths?: string[];
-	/** Live tunnel hostname (e.g. "epXXX.agentuity-us.live.internal") to add to Vite's allowedHosts */
-	liveHostname?: string;
-}
-
-/**
- * Vite plugin that injects analytics scripts in dev mode.
- *
- * In production the beacon plugin handles this at build time. In dev mode
- * the analytics config + session + beacon scripts are served by the Bun
- * backend at /_agentuity/webanalytics/* routes, but we need to inject the
- * `<script>` tags into the HTML so the browser loads them.
- */
-function devAnalyticsPlugin(): Plugin {
-	return {
-		name: 'agentuity:dev-analytics',
-		transformIndexHtml: {
-			order: 'pre',
-			handler(html) {
-				// Default analytics config — matches resolveAnalyticsConfig(undefined) in runtime
-				const config = {
-					enabled: true,
-					trackClicks: true,
-					trackScroll: true,
-					trackOutboundLinks: true,
-					trackForms: false,
-					trackWebVitals: true,
-					trackErrors: true,
-					trackSPANavigation: true,
-					isDevmode: true,
-				};
-
-				const injection =
-					`<script>window.__AGENTUITY_ANALYTICS__=${JSON.stringify(config)};</script>` +
-					'<script src="/_agentuity/webanalytics/session.js" async></script>' +
-					'<script src="/_agentuity/webanalytics/analytics.js"></script>';
-
-				if (html.includes('</head>')) {
-					return html.replace('</head>', `${injection}</head>`);
-				}
-				return html;
-			},
-		},
-	};
-}
-
-/**
- * Vite plugin that serves src/web/index.html as the SPA fallback.
- *
- * Vite's built-in SPA fallback only serves index.html from the project root.
- * Since Agentuity apps keep their HTML entry at src/web/index.html, we need
- * this plugin to rewrite the URL so Vite's built-in transform pipeline
- * (including React Fast Refresh injection) processes it correctly.
- */
-function spaFallbackPlugin(rootDir: string, routePaths: string[], workbenchPath?: string): Plugin {
-	const htmlPath = join(rootDir, 'src', 'web', 'index.html');
-	const hasHtml = existsSync(htmlPath);
-
-	return {
-		name: 'agentuity:spa-fallback',
-		configureServer(server) {
-			if (!hasHtml) return;
-
-			server.middlewares.use(async (req, res, next) => {
-				// Only handle GET/HEAD navigation requests
-				if (req.method !== 'GET' && req.method !== 'HEAD') return next();
-
-				const url = req.url || '/';
-				const pathname = url.split('?')[0] || '/';
-				const accept = req.headers.accept || '';
-				const secFetchDest = req.headers['sec-fetch-dest'] || '';
-
-				// For robustness, treat unknown GET/HEAD routes as potential SPA navigations.
-				// We still avoid intercepting assets/backend paths via the filters below.
-				// (This also makes non-browser readiness probes like fetch('/streams') work.)
-				const isDocumentRequest = secFetchDest === 'document' || accept.includes('text/html');
-
-				// Skip file requests (have an extension)
-				if (pathname !== '/' && /\.[a-zA-Z0-9]+$/.test(pathname)) return next();
-
-				// For non-document requests, only allow root path fallback.
-				// (e.g. don't turn module/script fetches into HTML accidentally)
-				if (!isDocumentRequest && pathname === '/') {
-					// allow root fallback for simple probes
-				}
-
-				// Skip Vite/module/internal asset paths
-				if (
-					pathname.startsWith('/@vite') ||
-					pathname.startsWith('/@react-refresh') ||
-					pathname.startsWith('/@id/') ||
-					pathname.startsWith('/@fs/') ||
-					pathname.startsWith('/node_modules/') ||
-					pathname.startsWith('/src/') ||
-					(pathname.startsWith('/@') && !pathname.startsWith('/_agentuity'))
-				) {
-					return next();
-				}
-
-				// Skip paths that are proxied to the Bun backend
-				if (
-					pathname.startsWith('/_agentuity') ||
-					pathname.startsWith('/_health') ||
-					pathname.startsWith('/_idle')
-				) {
-					return next();
-				}
-				// Skip workbench path (served by Bun)
-				if (
-					workbenchPath &&
-					(pathname === workbenchPath || pathname.startsWith(workbenchPath + '/'))
-				) {
-					return next();
-				}
-				for (const rp of routePaths) {
-					if (pathname === rp || pathname.startsWith(rp + '/')) return next();
-				}
-
-				// If this isn't clearly a document navigation, still allow SPA fallback
-				// for extensionless client-side routes like /streams, /rpc, /webrtc.
-				// We already excluded backend paths and asset/module paths above.
-
-				try {
-					let html = await Bun.file(htmlPath).text();
-					// Match old devHtmlHandler behavior from the generated Bun entry:
-					// rewrite relative paths so the app works from / and client-side routes.
-					html = html
-						.replace(/src="\.\//g, 'src="/src/web/')
-						.replace(/href="\.\//g, 'href="/src/web/');
-
-					// Let Vite inject HMR client, React refresh preamble, etc.
-					html = await server.transformIndexHtml(url, html, req.originalUrl);
-
-					res.statusCode = 200;
-					res.setHeader('Content-Type', 'text/html; charset=utf-8');
-					res.end(html);
-				} catch (error) {
-					next(error as Error);
-				}
-			});
-		},
-	};
-}
-
-/**
- * Generate Vite config for asset-only server (HMR + React transformation)
- */
-export async function generateAssetServerConfig(
-	options: GenerateAssetServerConfigOptions
-): Promise<InlineConfig> {
-	const {
-		rootDir,
-		logger,
-		workbenchPath,
-		port,
-		backendPort,
-		routePaths = ['/api'],
-		liveHostname,
-	} = options;
-
-	// Load path aliases from tsconfig.json if available
-	const tsconfigPath = join(rootDir, 'tsconfig.json');
-	let alias = {};
-
-	try {
-		const tsconfig = JSON.parse(await Bun.file(tsconfigPath).text());
-		const paths = tsconfig?.compilerOptions?.paths || {};
-		alias = Object.fromEntries(
-			Object.entries(paths)
-				.filter(([, value]) => {
-					const pathArray = value as string[];
-					return pathArray.length > 0 && pathArray[0] !== undefined;
-				})
-				.map(([key, value]) => {
-					const pathArray = value as string[];
-					const firstPath = pathArray[0] ?? '';
-					return [key.replace('/*', ''), join(rootDir, firstPath.replace('/*', ''))];
-				})
-		);
-	} catch {
-		// No tsconfig or no paths - that's fine
-	}
-
-	return {
-		root: rootDir,
-		base: '/',
-		clearScreen: false,
-		// Serve public assets from src/web/public/ at root path (e.g., /favicon.png)
-		// The Bun server proxies /public/* requests to Vite, rewriting to root paths
-		publicDir: join(rootDir, 'src', 'web', 'public'),
-
-		resolve: {
-			alias,
-			// Deduplicate React to prevent multiple instances (if used)
-			dedupe: ['react', 'react-dom', 'react/jsx-runtime', 'react/jsx-dev-runtime'],
-		},
-
-		// Pre-bundle dependencies to avoid issues with pre-built packages
-		// Only include @agentuity/workbench if workbench is enabled
-		optimizeDeps: {
-			include: workbenchPath ? ['@agentuity/workbench', '@agentuity/core'] : ['@agentuity/core'],
-		},
-
-		// Only allow frontend env vars (server uses process.env)
-		envPrefix: ['VITE_', 'AGENTUITY_PUBLIC_', 'PUBLIC_'],
-
-		server: {
-			// Vite is the primary dev server — listens on the user-facing port
-			port,
-			strictPort: true, // Port is pre-verified as available by findAvailablePort()
-			host: '127.0.0.1',
-
-			// When accessed via an Agentuity live tunnel, the Host header is the
-			// tunnel hostname (e.g. "epXXX.agentuity-us.live.internal"). Without
-			// adding it here, Vite 6+ rejects the request with "host not allowed".
-			...(liveHostname ? { allowedHosts: [liveHostname] } : {}),
-
-			// Proxy backend routes to Bun server (HTTP only).
-			// WebSocket upgrades are handled by the front-door TCP proxy (ws-proxy.ts)
-			// which routes them directly to the Bun backend, bypassing Vite entirely.
-			// This avoids Bun's broken node:http upgrade socket implementation.
-			proxy: {
-				// User-defined route mounts (from createApp({ router }))
-				...Object.fromEntries(
-					routePaths.map((routePath) => [
-						routePath,
-						{
-							target: `http://127.0.0.1:${backendPort}`,
-							changeOrigin: true,
-						},
-					])
-				),
-				// Agentuity system routes (workbench API, health, analytics, etc.)
-				'/_agentuity': {
-					target: `http://127.0.0.1:${backendPort}`,
-					changeOrigin: true,
-				},
-				// Workbench UI route (served by Bun, references /@fs/* paths handled by Vite)
-				...(workbenchPath
-					? {
-							[workbenchPath]: {
-								target: `http://127.0.0.1:${backendPort}`,
-								changeOrigin: true,
-							},
-						}
-					: {}),
-				// Legacy health check routes
-				'/_health': {
-					target: `http://127.0.0.1:${backendPort}`,
-					changeOrigin: true,
-				},
-				'/_idle': {
-					target: `http://127.0.0.1:${backendPort}`,
-					changeOrigin: true,
-				},
-			},
-
-			// HMR works natively — Vite is the primary server, no proxy needed
-			// Auto-detect host/protocol from page origin for tunnel support
-			hmr: true,
-
-			// Don't open browser automatically
-			open: false,
-		},
-
-		// Define environment variables for browser
-		define: {
-			...(workbenchPath
-				? { 'import.meta.env.AGENTUITY_PUBLIC_WORKBENCH_PATH': JSON.stringify(workbenchPath) }
-				: {}),
-			'import.meta.env.AGENTUITY_PUBLIC_HAS_SDK_KEY': JSON.stringify(
-				process.env.AGENTUITY_SDK_KEY ? 'true' : 'false'
-			),
-			'process.env.NODE_ENV': JSON.stringify('development'),
-		},
-
-		// Agentuity-specific plugins (Vite loads user plugins from vite.config.ts automatically)
-		plugins: await (async () => {
-			const { browserEnvPlugin } = await import('./browser-env-plugin');
-			const { publicAssetPathPlugin } = await import('./public-asset-path-plugin');
-
-			return [
-				// Browser env plugin to map process.env to import.meta.env
-				browserEnvPlugin(),
-				// Warn about incorrect public asset paths in dev mode
-				publicAssetPathPlugin({ warnInDev: true }),
-				// Inject analytics scripts in dev HTML
-				devAnalyticsPlugin(),
-				// SPA fallback: serve src/web/index.html for navigation requests
-				spaFallbackPlugin(rootDir, routePaths, workbenchPath),
-			];
-		})(),
-
-		// Suppress build-related options (this is dev-only)
-		build: {
-			rollupOptions: {
-				external: ['vite', '@agentuity/cli'],
-			},
-		},
-
-		// Custom logger to integrate with our logger
-		customLogger: {
-			info(msg: string) {
-				// Show port-related messages at info level (important for debugging port conflicts)
-				// Keep other Vite info messages (like HMR updates) at debug to avoid noise
-				if (msg.includes('Port') || msg.includes('port')) {
-					logger.info(`[Vite Asset] ${msg}`);
-				} else {
-					logger.debug(`[Vite Asset] ${msg}`);
-				}
-			},
-			warn(msg: string) {
-				logger.warn(`[Vite Asset] ${msg}`);
-			},
-			warnOnce(msg: string) {
-				logger.warn(`[Vite Asset] ${msg}`);
-			},
-			error(msg: string) {
-				logger.error(`[Vite Asset] ${msg}`);
-			},
-			clearScreen() {
-				// No-op
-			},
-			hasErrorLogged: () => false,
-			hasWarned: false,
-		},
-
-		logLevel: 'info',
-	};
-}