@agentuity/cli 0.0.107 → 0.0.108

package/dist/typescript-errors.js

@@ -0,0 +1,249 @@
+/**
+ * Rust-style TypeScript error formatting
+ *
+ * Formats TypeScript compiler errors in a style similar to Rust's compiler output,
+ * with source code context, error highlighting, and helpful formatting.
+ */
+import { join } from 'node:path';
+import { colorError, colorPrimary, colorInfo, colorMuted, bold, link, getDisplayWidth, getColor, plural, sourceLink, truncateToWidth, } from './tui';
+import { symbols } from './tui/symbols';
+/**
+ * Check if a GrammarItem is a TypeScript error (not a warning or other diagnostic)
+ */
+function isTsErrorItem(item) {
+    return item.type === 'Item' && item.value?.tsError?.value?.type === 'error';
+}
+/**
+ * Parse GrammarItem array into structured TypeScript errors
+ */
+function parseErrors(items) {
+    const errors = [];
+    for (const item of items) {
+        if (!isTsErrorItem(item) || !item.value)
+            continue;
+        const val = item.value;
+        errors.push({
+            path: val.path?.value ?? 'unknown',
+            line: val.cursor?.value?.line ?? 0,
+            col: val.cursor?.value?.col ?? 0,
+            errorCode: val.tsError?.value?.errorString ?? 'TS0000',
+            message: (val.message?.value ?? '').trim(),
+        });
+    }
+    return errors;
+}
+/**
+ * Read source lines with context (line before, current, line after)
+ */
+async function getSourceContext(filePath, lineNumber) {
+    try {
+        const file = Bun.file(filePath);
+        if (!(await file.exists())) {
+            return null;
+        }
+        const content = await file.text();
+        const lines = content.split('\n');
+        if (lineNumber <= 0 || lineNumber > lines.length) {
+            return null;
+        }
+        const current = lines[lineNumber - 1];
+        const before = lineNumber > 1 ? lines[lineNumber - 2] : null;
+        const after = lineNumber < lines.length ? lines[lineNumber] : null;
+        return {
+            before: before !== null && before.trim() !== '' ? before : null,
+            beforeLineNum: lineNumber - 1,
+            current,
+            after: after !== null && after.trim() !== '' ? after : null,
+            afterLineNum: lineNumber + 1,
+            total: lines.length,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Prepare error data without rendering (first pass)
+ */
+async function prepareError(error, projectDir, maxAvailableWidth) {
+    const fullPath = error.path.startsWith('/') ? error.path : `${projectDir}/${error.path}`;
+    // Error header
+    const url = link(`https://typescript.tv/errors/#${error.errorCode}`, `error[${error.errorCode}]`, getColor('error'));
+    const header = '  ' + url + colorMuted(': ') + bold(error.message);
+    // File location
+    const vscodelink = sourceLink(join(projectDir, error.path), error.line, error.col, `${error.path}:${error.line}:${error.col}`, getColor('info'));
+    const location = colorInfo(`  ${vscodelink}`);
+    const codeLines = [];
+    // Get source code context
+    const context = await getSourceContext(fullPath, error.line);
+    if (context !== null) {
+        const maxLineNum = Math.max(context.before !== null ? context.beforeLineNum : error.line, error.line, context.after !== null ? context.afterLineNum : error.line);
+        const lineNumWidth = String(maxLineNum).length;
+        const formatLineNum = (num) => String(num).padStart(lineNumWidth);
+        const padding = ' '.repeat(lineNumWidth);
+        const linePrefix = lineNumWidth + 3;
+        const truncateCodeLine = (lineNum, separator, code) => {
+            const prefixWidth = getDisplayWidth(lineNum) + getDisplayWidth(separator) + 1;
+            const availableForCode = maxAvailableWidth - prefixWidth;
+            if (availableForCode > 10 && getDisplayWidth(code) > availableForCode) {
+                return `${lineNum}${separator} ${truncateToWidth(code, availableForCode, '…')}`;
+            }
+            return `${lineNum}${separator} ${code}`;
+        };
+        if (context.beforeLineNum > 1) {
+            const dots = '.'.repeat(String(context.beforeLineNum).length);
+            const content = colorMuted(`${dots} ${symbols.bar}`);
+            codeLines.push({ content, rawWidth: getDisplayWidth(content) });
+        }
+        // Context line before (muted)
+        if (context.before !== null) {
+            const lineContent = truncateCodeLine(formatLineNum(context.beforeLineNum), ` ${symbols.bar}`, context.before);
+            const content = colorMuted(lineContent);
+            codeLines.push({ content, rawWidth: getDisplayWidth(content) });
+        }
+        // Error line (primary color)
+        const truncatedCurrent = getDisplayWidth(context.current) > maxAvailableWidth - linePrefix
+            ? truncateToWidth(context.current, maxAvailableWidth - linePrefix, '…')
+            : context.current;
+        const errorLineContent = `${colorInfo(formatLineNum(error.line))} ${colorMuted(symbols.bar)} ${colorPrimary(truncatedCurrent)}`;
+        codeLines.push({ content: errorLineContent, rawWidth: getDisplayWidth(errorLineContent) });
+        // Error pointer line with carets
+        const col = Math.max(0, error.col - 1);
+        let underlineLength = 1;
+        const restOfLine = context.current.slice(col);
+        const identifierMatch = restOfLine.match(/^[a-zA-Z_$][a-zA-Z0-9_$]*/);
+        if (identifierMatch) {
+            underlineLength = identifierMatch[0].length;
+        }
+        else {
+            const tokenMatch = restOfLine.match(/^\S+/);
+            if (tokenMatch) {
+                underlineLength = Math.min(tokenMatch[0].length, 20);
+            }
+        }
+        const maxCaretWidth = maxAvailableWidth - linePrefix;
+        const caretStart = Math.min(col, maxCaretWidth - 1);
+        const caretLen = Math.min(underlineLength, maxCaretWidth - caretStart);
+        const carets = caretLen > 0 ? '^'.repeat(caretLen) : '^';
+        const caretPadding = ' '.repeat(caretStart);
+        const caretLine = `${padding} ${colorMuted(symbols.bar)} ${caretPadding}${colorError(carets)}`;
+        codeLines.push({ content: caretLine, rawWidth: getDisplayWidth(caretLine) });
+        // Context line after (muted)
+        if (context.after !== null) {
+            const lineContent = truncateCodeLine(formatLineNum(context.afterLineNum), ` ${symbols.bar}`, context.after);
+            const content = colorMuted(lineContent);
+            codeLines.push({ content, rawWidth: getDisplayWidth(content) });
+        }
+        if (context.afterLineNum + 1 < context.total) {
+            const dots = '.'.repeat(String(context.afterLineNum).length);
+            const content = colorMuted(`${dots} ${symbols.bar}`);
+            codeLines.push({ content, rawWidth: getDisplayWidth(content) });
+        }
+    }
+    const maxContentWidth = codeLines.length > 0 ? Math.max(...codeLines.map((l) => l.rawWidth)) : 0;
+    return {
+        error,
+        header,
+        location,
+        codeLines,
+        maxContentWidth,
+    };
+}
+/**
+ * Render a prepared error with a specific box width
+ */
+function renderError(prepared, boxContentWidth) {
+    const lines = [];
+    lines.push(prepared.header);
+    lines.push(prepared.location);
+    if (prepared.codeLines.length > 0) {
+        const boxWidth = boxContentWidth + 2;
+        // Draw box
+        lines.push(colorMuted(`  ${symbols.cornerTL}${symbols.barH.repeat(boxWidth)}${symbols.cornerTR}`));
+        for (const codeLine of prepared.codeLines) {
+            const rightPad = ' '.repeat(Math.max(0, boxContentWidth - codeLine.rawWidth));
+            lines.push(colorMuted(`  ${symbols.bar}`) +
+                ` ${codeLine.content}${rightPad} ` +
+                colorMuted(symbols.bar));
+        }
+        lines.push(colorMuted(`  ${symbols.cornerBL}${symbols.barH.repeat(boxWidth)}${symbols.cornerBR}`));
+    }
+    else {
+        lines.push(colorMuted('  (source not available)'));
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Group errors by file for better organization
+ */
+function groupErrorsByFile(errors) {
+    const grouped = new Map();
+    for (const error of errors) {
+        const existing = grouped.get(error.path) ?? [];
+        existing.push(error);
+        grouped.set(error.path, existing);
+    }
+    for (const errors of grouped.values()) {
+        errors.sort((a, b) => a.line - b.line || a.col - b.col);
+    }
+    return grouped;
+}
+/**
+ * Format TypeScript errors in Rust-style output
+ */
+export async function formatTypeScriptErrors(items, options) {
+    const errors = parseErrors(items);
+    if (errors.length === 0) {
+        return '';
+    }
+    // Calculate terminal constraints
+    const terminalWidth = process.stdout.columns || 80;
+    const boxChrome = 6;
+    const maxAvailableWidth = terminalWidth - boxChrome;
+    // First pass: prepare all errors and collect their widths
+    const groupedErrors = groupErrorsByFile(errors);
+    const maxErrors = options.maxErrors ?? errors.length;
+    const preparedErrors = [];
+    let displayedCount = 0;
+    for (const [, fileErrors] of groupedErrors) {
+        for (const error of fileErrors) {
+            if (displayedCount >= maxErrors)
+                break;
+            const prepared = await prepareError(error, options.projectDir, maxAvailableWidth);
+            preparedErrors.push(prepared);
+            displayedCount++;
+        }
+        if (displayedCount >= maxErrors)
+            break;
+    }
+    // Calculate uniform box width (max content width across all errors, capped at terminal width)
+    const globalMaxContentWidth = Math.max(...preparedErrors.map((p) => p.maxContentWidth));
+    const uniformBoxContentWidth = Math.min(globalMaxContentWidth, maxAvailableWidth);
+    // Second pass: render all errors with uniform width
+    const output = [];
+    for (const prepared of preparedErrors) {
+        output.push(renderError(prepared, uniformBoxContentWidth));
+    }
+    // Summary line
+    const totalErrors = errors.length;
+    const hiddenCount = totalErrors - displayedCount;
+    let msg = bold(colorPrimary(`aborting due to ${totalErrors} TypeScript compiler ${plural(totalErrors, 'error', 'errors')}`));
+    if (hiddenCount > 0) {
+        msg += colorMuted(` (${hiddenCount} not shown)`);
+    }
+    output.push(`${bold(colorError('error'))}: ${msg}`);
+    return output.join('\n');
+}
+/**
+ * Check if the parsed result contains any errors
+ */
+export function hasErrors(items) {
+    return items.some(isTsErrorItem);
+}
+/**
+ * Get the count of errors
+ */
+export function getErrorCount(items) {
+    return items.filter(isTsErrorItem).length;
+}
+//# sourceMappingURL=typescript-errors.js.map

package/dist/typescript-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-errors.js","sourceRoot":"","sources":["../src/typescript-errors.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/cli",
-	"version": "0.0.107",
+	"version": "0.0.108",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -40,8 +40,8 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.0.107",
-		"@agentuity/server": "0.0.107",
+		"@agentuity/core": "0.0.108",
+		"@agentuity/server": "0.0.108",
 		"@datasert/cronjs-parser": "^1.4.0",
 		"@terascope/fetch-github-release": "^2.2.1",
 		"@vitejs/plugin-react": "^5.1.2",
@@ -61,7 +61,7 @@
 		"zod": "^4.1.12"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.0.107",
+		"@agentuity/test-utils": "0.0.108",
 		"@types/adm-zip": "^0.5.7",
 		"@types/bun": "latest",
 		"@types/tar-fs": "^2.0.4",

package/src/cmd/build/entry-generator.ts

@@ -67,25 +67,22 @@ export async function generateEntryFile(options: GenerateEntryOptions): Promise<
 		`  setGlobalRouter,`,
 		`  enableProcessExitProtection,`,
 		`  hasWaitUntilPending,`,
+		`  loadBuildMetadata,`,
+		`  createWorkbenchRouter,`,
+		`  bootstrapRuntimeEnv,`,
+		` patchBunS3ForStorageDev,`,
 	];
 
-	if (hasWorkbench) {
-		runtimeImports.push(`  createWorkbenchRouter,`);
-	}
-
 	const imports = [
 		`import { `,
 		...runtimeImports,
 		`} from '@agentuity/runtime';`,
 		`import type { Context } from 'hono';`,
-		`import { websocket } from 'hono/bun';`,
-		// Conditionally import serveStatic and readFileSync for web frontend or workbench support
-		hasWebFrontend || hasWorkbench ? `import { serveStatic } from 'hono/bun';` : '',
-		hasWebFrontend || hasWorkbench ? `import { readFileSync, existsSync } from 'node:fs';` : '',
+		`import { websocket${hasWebFrontend ? ', serveStatic' : ''} } from 'hono/bun';`,
+		hasWebFrontend ? `import { readFileSync, existsSync } from 'node:fs';` : '',
 	].filter(Boolean);
 
 	imports.push(`import { type LogLevel } from '@agentuity/core';`);
-	imports.push(`import { bootstrapRuntimeEnv, patchBunS3ForStorageDev } from '@agentuity/runtime';`);
 
 	// Generate route mounting code for all discovered routes
 	const routeImportsAndMounts: string[] = [];
@@ -124,13 +121,14 @@ ${routeImportsAndMounts.join('\n')}
 			: '';
 
 	// Workbench API routes mounting (if enabled)
-	const workbenchApiMount = hasWorkbench
-		? `
-// Mount workbench API routes (/_agentuity/workbench/*)
-const workbenchRouter = createWorkbenchRouter();
-app.route('/', workbenchRouter);
-`
-		: '';
+	const workbenchApiMount = `
+const hasWorkbench = ${hasWorkbench};
+if (hasWorkbench) {
+	// Mount workbench API routes (/_agentuity/workbench/*)
+	const workbenchRouter = createWorkbenchRouter();
+	app.route('/', workbenchRouter);
+}
+`;
 
 	// Asset proxy routes - Always generated, but only active at runtime when:
 	//   - NODE_ENV !== 'production' (isDevelopment())
@@ -142,20 +140,16 @@ if (isDevelopment() && process.env.VITE_PORT) {
 
 	const proxyToVite = async (c: Context) => {
 		const viteUrl = \`http://127.0.0.1:\${VITE_ASSET_PORT}\${c.req.path}\`;
-		const controller = new AbortController();
-		const timeout = setTimeout(() => controller.abort(), 10000); // 10s timeout
 		try {
 			otel.logger.debug(\`[Proxy] \${c.req.method} \${c.req.path} -> Vite:\${VITE_ASSET_PORT}\`);
-			const res = await fetch(viteUrl, { signal: controller.signal });
-			clearTimeout(timeout);
+			const res = await fetch(viteUrl, { signal: AbortSignal.timeout(10000) });
 			otel.logger.debug(\`[Proxy] \${c.req.path} -> \${res.status} (\${res.headers.get('content-type')})\`);
 			return new Response(res.body, {
 				status: res.status,
 				headers: res.headers,
 			});
 		} catch (err) {
-			clearTimeout(timeout);
-			if (err instanceof Error && err.name === 'AbortError') {
+			if (err instanceof Error && err.name === 'TimeoutError') {
 				otel.logger.error(\`Vite proxy timeout: \${c.req.path}\`);
 				return c.text('Vite asset server timeout', 504);
 			}
@@ -243,7 +237,9 @@ if (isDevelopment()) {
 	// 404 for unmatched API/system routes
 	app.all('/_agentuity/*', (c: Context) => c.notFound());
 	app.all('/api/*', (c: Context) => c.notFound());
-	${hasWorkbench ? '' : `app.all('/workbench/*', (c: Context) => c.notFound());`}
+	if (hasWorkbench) {
+		app.all('/workbench/*', (c: Context) => c.notFound());
+	}
 	
 	// SPA fallback - serve index.html for client-side routing
 	app.get('*', (c: Context) => {
@@ -276,7 +272,9 @@ if (isDevelopment()) {
 	// 404 for unmatched API/system routes (IMPORTANT: comes before SPA fallback)
 	app.all('/_agentuity/*', (c: Context) => c.notFound());
 	app.all('/api/*', (c: Context) => c.notFound());
-	${hasWorkbench ? '' : `app.all('/workbench/*', (c: Context) => c.notFound());`}
+	if (hasWorkbench) {
+		app.all('/workbench/*', (c: Context) => c.notFound());
+	}
 
 	// SPA fallback with asset protection
 	app.get('*', (c: Context) => {
@@ -293,36 +291,25 @@ if (isDevelopment()) {
 
 	// Workbench routes (if enabled) - runtime mode detection
 	const workbenchRoute = workbench?.route ?? '/workbench';
-	const workbenchRoutes = hasWorkbench
-		? `
-// Workbench routes - Runtime mode detection
-// Both dev and prod run from .agentuity/app.js (dev bundles before running)
-// So workbench-src is always in the same directory
-const workbenchSrcDir = import.meta.dir + '/workbench-src';
-const workbenchIndexPath = import.meta.dir + '/workbench/index.html';
-const workbenchIndex = existsSync(workbenchIndexPath) 
-	? readFileSync(workbenchIndexPath, 'utf-8')
-	: '';
-
-if (isDevelopment()) {
+	const workbenchRoutes = `
+if (hasWorkbench) {
 	// Development mode: Let Vite serve source files with HMR
-	app.get('${workbenchRoute}', async (c: Context) => {
-		const html = await Bun.file(workbenchSrcDir + '/index.html').text();
-		// Rewrite script/css paths to use Vite's @fs protocol
-		const withVite = html
-			.replace('src="./main.tsx"', \`src="/@fs\${workbenchSrcDir}/main.tsx"\`)
-			.replace('href="./styles.css"', \`href="/@fs\${workbenchSrcDir}/styles.css"\`);
-		return c.html(withVite);
-	});
-} else {
-	// Production mode: Serve pre-built assets
-	if (workbenchIndex) {
-		app.get('${workbenchRoute}', (c: Context) => c.html(workbenchIndex));
-		app.get('${workbenchRoute}/*', serveStatic({ root: import.meta.dir + '/workbench' }));
+	if (isDevelopment()) {
+		const workbenchSrcDir = import.meta.dir + '/workbench-src';
+		const workbenchIndexPath = import.meta.dir + '/workbench-src/index.html';
+		app.get('${workbenchRoute}', async (c: Context) => {
+			const html = await Bun.file(workbenchIndexPath).text();
+			// Rewrite script/css paths to use Vite's @fs protocol
+			const withVite = html
+				.replace('src="./main.tsx"', \`src="/@fs\${workbenchSrcDir}/main.tsx"\`)
+				.replace('href="./styles.css"', \`href="/@fs\${workbenchSrcDir}/styles.css"\`);
+			return c.html(withVite);
+		});
+	} else {
+		// Production mode disables the workbench assets
 	}
 }
-`
-		: '';
+`;
 
 	// Server startup (same for dev and prod - Bun.serve with native WebSocket)
 	const serverStartup = `
@@ -345,6 +332,7 @@ if (typeof Bun !== 'undefined') {
 	});
 	
 	// Make server available globally for health checks
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	(globalThis as any).__AGENTUITY_SERVER__ = server;
 	
 	otel.logger.info(\`Server listening on http://127.0.0.1:\${port}\`);
@@ -366,6 +354,7 @@ if (!isDevelopment()) {
 	};
 	const idleHandler = (c: Context) => {
 		// Check if server is idle (no pending requests/connections)
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
 		const server = (globalThis as any).__AGENTUITY_SERVER__;
 		if (!server) return c.text('NO', 200, { 'Content-Type': 'text/plain; charset=utf-8' });
 		
@@ -429,6 +418,9 @@ if (isDevelopment()) {
 	await bootstrapRuntimeEnv({ projectDir: import.meta.dir + '/../..' });
 }
 
+// Step 0.25: load our runtime metadata and cache it
+loadBuildMetadata();
+
 // Step 0.5: Patch Bun's S3 client for Agentuity storage endpoints
 // Agentuity storage uses virtual-hosted-style URLs (*.storage.dev)
 // This patches s3.file() to automatically set virtualHostedStyle: true

package/src/cmd/build/index.ts

@@ -5,6 +5,7 @@ import { viteBundle } from './vite-bundler';
 import * as tui from '../../tui';
 import { getCommand } from '../../command-prefix';
 import { ErrorCode } from '../../errors';
+import { typecheck } from './typecheck';
 
 const BuildResponseSchema = z.object({
 	success: z.boolean().describe('Whether the build succeeded'),
@@ -78,22 +79,24 @@ export const command = createCommand({
 			if (!opts.dev && !opts.skipTypeCheck) {
 				try {
 					tui.info('Running type check...');
-					const result = await Bun.$`bunx tsc --noEmit --skipLibCheck`
-						.cwd(absoluteProjectDir)
-						.nothrow();
-
-					if (result.exitCode === 0) {
+					const typeResult = await typecheck(absoluteProjectDir);
+					if (typeResult.success) {
 						tui.success('Type check passed');
 					} else {
-						tui.error('Type check failed:\n');
-						console.error(result.stderr.toString());
-						tui.fatal('Fix type errors before building');
+						console.error('');
+						console.error(typeResult.output);
+						console.error('');
+						const msg =
+							'errors' in typeResult ? 'Fix type errors before building' : 'Build error';
+						tui.fatal(msg, ErrorCode.BUILD_FAILED);
 					}
 				} catch (error: unknown) {
-					// If tsc fails to run, show error and fail
 					const errorMsg = error instanceof Error ? error.message : String(error);
 					tui.error(`Type check failed to run: ${errorMsg}`);
-					tui.fatal('Unable to run TypeScript type checking. Ensure TypeScript is installed.');
+					tui.fatal(
+						'Unable to run TypeScript type checking. Ensure TypeScript is installed.',
+						ErrorCode.BUILD_FAILED
+					);
 				}
 			}
 

package/src/cmd/build/typecheck.ts

@@ -0,0 +1,55 @@
+import { parse, type GrammarItem } from '../../tsc-output-parser';
+import { formatTypeScriptErrors, hasErrors } from '../../typescript-errors';
+
+interface TypeError {
+	success: false;
+	errors: GrammarItem[];
+	output: string;
+}
+
+interface TypeUnknownError {
+	success: false;
+	output: string;
+}
+
+interface TypeSuccess {
+	success: true;
+}
+
+type TypeResult = TypeError | TypeSuccess | TypeUnknownError;
+
+/**
+ * run the typescript compiler and result formatted results
+ *
+ * @param dir the absolute path to the directory containing the project (must have tsconfig.json in this folder)
+ * @returns
+ */
+export async function typecheck(dir: string): Promise<TypeResult> {
+	const result = await Bun.$`bunx tsc --noEmit --skipLibCheck --pretty false`
+		.cwd(dir)
+		.quiet()
+		.nothrow();
+
+	const output = await result.text();
+	const errors = parse(output) as GrammarItem[];
+
+	if (result.exitCode === 0) {
+		return {
+			success: true,
+		};
+	} else if (errors && hasErrors(errors)) {
+		const formattedErrors = await formatTypeScriptErrors(errors, {
+			projectDir: dir,
+		});
+		return {
+			success: false,
+			errors,
+			output: formattedErrors,
+		};
+	} else {
+		return {
+			success: false,
+			output: output || result.stderr.toString(),
+		};
+	}
+}

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

@@ -6,6 +6,7 @@
  */
 
 import { join } from 'node:path';
+import { createRequire } from 'node:module';
 import type { InlineConfig } from 'vite';
 import type { Logger } from '../../../types';
 
@@ -116,14 +117,22 @@ export async function generateAssetServerConfig(
 		},
 
 		// Plugins: User plugins first (e.g., Tailwind), then React and browser env
-		plugins: [
-			// User-defined plugins from agentuity.config.ts (e.g., Tailwind CSS)
-			...userPlugins,
-			// React plugin for JSX/TSX transformation and Fast Refresh
-			(await import('@vitejs/plugin-react')).default(),
-			// Browser env plugin to map process.env to import.meta.env
-			(await import('./browser-env-plugin')).browserEnvPlugin(),
-		],
+		// Resolve @vitejs/plugin-react from the project's node_modules
+		plugins: await (async () => {
+			const projectRequire = createRequire(join(rootDir, 'package.json'));
+			const reactPlugin = (
+				await import(projectRequire.resolve('@vitejs/plugin-react'))
+			).default();
+			const { browserEnvPlugin } = await import('./browser-env-plugin');
+			return [
+				// User-defined plugins from agentuity.config.ts (e.g., Tailwind CSS)
+				...userPlugins,
+				// React plugin for JSX/TSX transformation and Fast Refresh
+				reactPlugin,
+				// Browser env plugin to map process.env to import.meta.env
+				browserEnvPlugin(),
+			];
+		})(),
 
 		// Suppress build-related options (this is dev-only)
 		build: {

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

@@ -5,6 +5,8 @@
  * Does NOT handle API routes or WebSocket - the Bun server proxies to this.
  */
 
+import { join } from 'node:path';
+import { createRequire } from 'node:module';
 import type { ViteDevServer } from 'vite';
 import type { Logger } from '../../../types';
 import { generateAssetServerConfig } from './vite-asset-server-config';
@@ -43,8 +45,10 @@ export async function startViteAssetServer(
 		port: preferredPort,
 	});
 
-	// Dynamically import vite
-	const { createServer } = await import('vite');
+	// 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);

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

@@ -6,6 +6,7 @@
 
 import { join } from 'node:path';
 import { existsSync, renameSync, rmSync } from 'node:fs';
+import { createRequire } from 'node:module';
 import type { InlineConfig, Plugin } from 'vite';
 import type { Logger, DeployOptions } from '../../../types';
 import { browserEnvPlugin } from './browser-env-plugin';
@@ -106,8 +107,18 @@ export async function runViteBuild(options: ViteBuildOptions): Promise<void> {
 	}
 
 	// Dynamically import vite and react plugin
-	const { build: viteBuild } = await import('vite');
-	const reactModule = await import('@vitejs/plugin-react');
+	// Try project's node_modules first (for custom vite configs), fall back to CLI's
+	const projectRequire = createRequire(join(rootDir, 'package.json'));
+	let vitePath = 'vite';
+	let reactPluginPath = '@vitejs/plugin-react';
+	try {
+		vitePath = projectRequire.resolve('vite');
+		reactPluginPath = projectRequire.resolve('@vitejs/plugin-react');
+	} catch {
+		// Project doesn't have vite, use CLI's bundled version
+	}
+	const { build: viteBuild } = await import(vitePath);
+	const reactModule = await import(reactPluginPath);
 	const react = reactModule.default;
 
 	// For client/workbench, use inline config (no agentuity plugin needed)