@agentuity/cli 1.0.23 → 1.0.25

package/src/cache/user-cache.ts

@@ -0,0 +1,93 @@
+import { Database } from 'bun:sqlite';
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+import { getDefaultConfigDir } from '../config';
+
+let db: Database | null = null;
+
+/**
+ * Get or create the database connection synchronously.
+ * Reuses the existing resource.db file for consistency.
+ */
+function getDatabase(): Database {
+	if (db) return db;
+
+	const configDir = getDefaultConfigDir();
+	mkdirSync(configDir, { recursive: true });
+
+	db = new Database(join(configDir, 'resource.db'));
+	db.run(`
+		CREATE TABLE IF NOT EXISTS user_info_cache (
+			profile TEXT PRIMARY KEY,
+			user_id TEXT NOT NULL,
+			first_name TEXT NOT NULL,
+			last_name TEXT NOT NULL,
+			cached_at INTEGER NOT NULL
+		)
+	`);
+	return db;
+}
+
+/**
+ * Get cached user info for a profile.
+ * Returns null if not found in cache.
+ */
+export function getCachedUserInfo(
+	profile: string
+): { userId: string; firstName: string; lastName: string } | null {
+	try {
+		const row = getDatabase()
+			.query<
+				{ user_id: string; first_name: string; last_name: string },
+				[string]
+			>('SELECT user_id, first_name, last_name FROM user_info_cache WHERE profile = ?')
+			.get(profile);
+		if (!row) return null;
+		return {
+			userId: row.user_id,
+			firstName: row.first_name,
+			lastName: row.last_name,
+		};
+	} catch {
+		// Non-critical — return null on error
+		return null;
+	}
+}
+
+/**
+ * Cache user info for a profile.
+ * Upserts the entry so repeated calls are safe.
+ */
+export function setCachedUserInfo(
+	profile: string,
+	userId: string,
+	firstName: string,
+	lastName: string
+): void {
+	try {
+		getDatabase().run(
+			`INSERT INTO user_info_cache (profile, user_id, first_name, last_name, cached_at)
+			 VALUES (?, ?, ?, ?, ?)
+			 ON CONFLICT(profile) DO UPDATE SET
+				user_id = excluded.user_id,
+				first_name = excluded.first_name,
+				last_name = excluded.last_name,
+				cached_at = excluded.cached_at`,
+			[profile, userId, firstName, lastName, Date.now()]
+		);
+	} catch {
+		// Non-critical — caching failure shouldn't block CLI
+	}
+}
+
+/**
+ * Clear cached user info for a profile.
+ * Called on logout to ensure stale data is removed.
+ */
+export function clearCachedUserInfo(profile: string): void {
+	try {
+		getDatabase().run('DELETE FROM user_info_cache WHERE profile = ?', [profile]);
+	} catch {
+		// Non-critical — cache cleanup failure shouldn't block logout
+	}
+}

package/src/cmd/auth/logout.ts

@@ -1,5 +1,6 @@
 import { createSubcommand } from '../../types';
-import { clearAuth } from '../../config';
+import { clearAuth, defaultProfileName } from '../../config';
+import { clearCachedUserInfo } from '../../cache';
 import * as tui from '../../tui';
 import { getCommand } from '../../command-prefix';
 
@@ -17,6 +18,7 @@ export const logoutCommand = createSubcommand({
 	async handler(ctx) {
 		const { options } = ctx;
 		await clearAuth();
+		clearCachedUserInfo(ctx.config?.name ?? defaultProfileName);
 		if (!options.json) {
 			tui.success('You have been logged out');
 		}

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

@@ -18,14 +18,27 @@ interface GenerateEntryOptions {
 	workbench?: WorkbenchConfig;
 	analytics?: boolean | AnalyticsConfig;
 	vitePort?: number; // Port of Vite asset server (dev mode only)
+	noBundle?: boolean; // Skip bundling — apply runtime patches instead
+	/** Pre-discovered routes to avoid redundant route discovery */
+	preDiscoveredRoutes?: Awaited<ReturnType<typeof discoverRoutes>>['routeInfoList'];
 }
 
 /**
  * Generate entry file with clean Vite-native architecture
  */
 export async function generateEntryFile(options: GenerateEntryOptions): Promise<void> {
-	const { rootDir, projectId, deploymentId, logger, mode, workbench, analytics, vitePort } =
-		options;
+	const {
+		rootDir,
+		projectId,
+		deploymentId,
+		logger,
+		mode,
+		workbench,
+		analytics,
+		vitePort,
+		noBundle,
+		preDiscoveredRoutes,
+	} = options;
 
 	const srcDir = join(rootDir, 'src');
 	const generatedDir = join(srcDir, 'generated');
@@ -41,8 +54,10 @@ export async function generateEntryFile(options: GenerateEntryOptions): Promise<
 		await generateWebAnalyticsFile({ rootDir, logger, analytics });
 	}
 
-	// Discover routes to determine which files need to be imported
-	const { routeInfoList } = await discoverRoutes(srcDir, projectId, deploymentId, logger);
+	// Use pre-discovered routes if available, otherwise discover them
+	const routeInfoList =
+		preDiscoveredRoutes ??
+		(await discoverRoutes(srcDir, projectId, deploymentId, logger)).routeInfoList;
 
 	// Check for web and workbench
 	const hasWebFrontend =
@@ -87,6 +102,10 @@ export async function generateEntryFile(options: GenerateEntryOptions): Promise<
 		`  runShutdown,`,
 	];
 
+	if (noBundle) {
+		runtimeImports.push(`  applyDevPatches,`);
+	}
+
 	if (hasWebFrontend) {
 		runtimeImports.push(`  mimeTypes,`);
 	}
@@ -610,6 +629,15 @@ if (isDevelopment()) {
 }
 `;
 
+	const devPatchesStep = noBundle
+		? `
+// Step 0.1: Apply runtime dev patches (--experimental-no-bundle mode)
+// Replaces build-time Bun.build patches for LLM gateway routing, AI SDK telemetry, and OTel spans
+if (isDevelopment()) {
+	await applyDevPatches();
+}
+`
+		: '';
 	const code = `// @generated
 // Auto-generated by Agentuity
 // DO NOT EDIT - This file is regenerated on every build
@@ -626,6 +654,8 @@ if (isDevelopment()) {
 	await bootstrapRuntimeEnv({ projectDir: import.meta.dir + '/../..' });
 }
 
+${devPatchesStep}
+
 // Step 0.25: load our runtime metadata and cache it
 loadBuildMetadata();
 

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

@@ -19,6 +19,7 @@ export interface BunDevServerOptions {
 	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
 }
 
 export interface BunDevServerResult {
@@ -39,17 +40,28 @@ export interface BunDevServerResult {
  * as a subprocess to enable passing the debugger CLI flags.
  */
 export async function startBunDevServer(options: BunDevServerOptions): Promise<BunDevServerResult> {
-	const { rootDir, port = 3500, logger, vitePort, inspect, inspectWait, inspectBrk } = options;
+	const {
+		rootDir,
+		port = 3500,
+		logger,
+		vitePort,
+		inspect,
+		inspectWait,
+		inspectBrk,
+		noBundle,
+	} = options;
 
 	logger.debug('Starting Bun dev server (Vite already running on port %d)...', vitePort);
 
-	const appPath = `${rootDir}/.agentuity/app.js`;
+	const appPath = noBundle ? `${rootDir}/src/generated/app.ts` : `${rootDir}/.agentuity/app.js`;
 
-	// Verify bundle exists before attempting to load
+	// Verify entry file exists before attempting to load
 	const appFile = Bun.file(appPath);
 	if (!(await appFile.exists())) {
 		throw new Error(
-			`Dev bundle not found at ${appPath}. The bundle must be generated before starting the dev server.`
+			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.`
 		);
 	}
 
@@ -126,11 +138,11 @@ export async function startBunDevServer(options: BunDevServerOptions): Promise<B
 		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 bundled app - this will start Bun.serve() internally
-		// IMPORTANT: We must import the bundled .agentuity/app.js (NOT src/generated/app.ts)
-		// because the bundled version has LLM provider patches applied that enable AI Gateway routing.
-		// Importing the source file directly would bypass these patches.
-		logger.debug('📦 Loading bundled app (Bun server will start)...');
+		// 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,

package/src/cmd/cloud/db/index.ts

@@ -5,6 +5,7 @@ import { deleteSubcommand } from './delete';
 import { getSubcommand } from './get';
 import { logsSubcommand } from './logs';
 import { sqlSubcommand } from './sql';
+import { statsSubcommand } from './stats';
 import { getCommand } from '../../../command-prefix';
 
 export const dbCommand = createCommand({
@@ -23,5 +24,6 @@ export const dbCommand = createCommand({
 		deleteSubcommand,
 		logsSubcommand,
 		sqlSubcommand,
+		statsSubcommand,
 	],
 });

package/src/cmd/cloud/db/stats.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getGlobalCatalystAPIClient } from '../../../config';
+import { getCommand } from '../../../command-prefix';
+import { getServiceStats, type ServiceStatsData } from '@agentuity/server';
+
+function formatNumber(n: number): string {
+	if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+	if (n >= 1_000) return `${(n / 1_000).toFixed(1)}K`;
+	return String(n);
+}
+
+function displayStats(data: ServiceStatsData): void {
+	const svc = data.services.database;
+	if (!svc) {
+		tui.info('No database data found.');
+		return;
+	}
+	tui.header('Database Statistics');
+	tui.newline();
+	console.log(`  ${tui.muted('Databases:')}       ${formatNumber(svc.databaseCount)}`);
+	console.log(`  ${tui.muted('Tables:')}          ${formatNumber(svc.totalTableCount)}`);
+	console.log(`  ${tui.muted('Records:')}         ${formatNumber(svc.totalRecordCount)}`);
+	console.log(`  ${tui.muted('Total Size:')}      ${tui.formatBytes(svc.totalSizeBytes)}`);
+}
+
+export const statsSubcommand = createCommand({
+	name: 'stats',
+	description: 'View database statistics',
+	tags: ['read-only', 'requires-auth'],
+	requires: { auth: true, org: true },
+	examples: [
+		{
+			command: getCommand('cloud db stats'),
+			description: 'View database statistics',
+		},
+	],
+	schema: {
+		options: z.object({
+			start: z.string().optional().describe('Start time (ISO 8601)'),
+			end: z.string().optional().describe('End time (ISO 8601)'),
+		}),
+	},
+	idempotent: true,
+
+	async handler(ctx) {
+		const { opts, options } = ctx;
+		const client = await getGlobalCatalystAPIClient(ctx.logger, ctx.auth, ctx.config?.name);
+		const orgId = ctx.orgId ?? ctx.options.orgId ?? ctx.config?.preferences?.orgId;
+
+		if (!orgId) {
+			ctx.logger.fatal('Organization ID is required. Use --org-id or set a preferred org.');
+			return;
+		}
+
+		const data = await getServiceStats(client, orgId, {
+			service: 'database',
+			start: opts.start,
+			end: opts.end,
+			orgIdHeader: orgId,
+		});
+
+		if (!options.json) {
+			displayStats(data);
+		}
+
+		return data;
+	},
+});
+
+export default statsSubcommand;

package/src/cmd/cloud/email/create.ts

@@ -3,7 +3,8 @@ import enquirer from 'enquirer';
 import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { setResourceInfo } from '../../../cache';
-import { createEmailAdapter, resolveEmailOrgId, resolveEmailRegion, EmailAddressSchema } from './util';
+import { createEmailAdapter, resolveEmailOrgId, EmailAddressSchema } from './util';
+import { defaultProfileName, getDefaultRegion } from '../../../config';
 
 export const createSubcommand = createCommand({
 	name: 'create',
@@ -13,10 +14,7 @@ export const createSubcommand = createCommand({
 	requires: { auth: true },
 	schema: {
 		options: z.object({
-			localPart: z
-				.string()
-				.optional()
-				.describe('Local part for the email address (before @)'),
+			localPart: z.string().optional().describe('Local part for the email address (before @)'),
 		}),
 		response: EmailAddressSchema,
 	},
@@ -29,21 +27,30 @@ export const createSubcommand = createCommand({
 			const answer = await enquirer.prompt<{ local_part: string }>({
 				type: 'input',
 				name: 'local_part',
-				message: 'Local part (username):',
+				message: 'Email address or username (e.g. "support" or "support@agentuity.email"):',
 			});
 			localPart = answer.local_part?.trim();
 		}
 
 		if (!localPart) {
-			tui.fatal('Local part is required');
+			tui.fatal('Email address or username is required');
 		}
 
-		const email = createEmailAdapter(ctx);
+		// If user entered a full email, extract just the local part
+		if (localPart.includes('@')) {
+			localPart = localPart.split('@')[0]?.trim() ?? '';
+		}
+
+		if (!localPart) {
+			tui.fatal('Email address or username is required');
+		}
+
+		const profileName = config?.name ?? defaultProfileName;
+		const region = await getDefaultRegion(profileName, ctx.config);
+		const email = await createEmailAdapter(ctx, region);
 		const address = await email.createAddress(localPart);
 
-		const profileName = config?.name ?? 'production';
 		const orgId = resolveEmailOrgId(ctx);
-		const region = resolveEmailRegion(ctx);
 		await setResourceInfo('email', profileName, address.id, region, orgId);
 
 		if (!options.json) {

package/src/cmd/cloud/email/delete.ts

@@ -36,7 +36,7 @@ export const deleteSubcommand = createCommand({
 			}
 		}
 
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		await email.deleteAddress(args.id);
 
 		if (!options.json) {

package/src/cmd/cloud/email/destination/delete.ts

@@ -43,11 +43,15 @@ export const deleteSubcommand = createCommand({
 			);
 			if (!ok) {
 				tui.info('Cancelled');
-				return { success: false, address_id: args.address_id, destination_id: args.destination_id };
+				return {
+					success: false,
+					address_id: args.address_id,
+					destination_id: args.destination_id,
+				};
 			}
 		}
 
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		await email.deleteDestination(args.address_id, args.destination_id);
 
 		if (!options.json) {

package/src/cmd/cloud/email/destination/list.ts

@@ -19,7 +19,7 @@ export const listSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		const destinations = await email.listDestinations(args.address_id);
 
 		if (!options.json) {

package/src/cmd/cloud/email/destination/url.ts

@@ -2,7 +2,8 @@ import { z } from 'zod';
 import { createCommand } from '../../../../types';
 import * as tui from '../../../../tui';
 import { setResourceInfo } from '../../../../cache';
-import { createEmailAdapter, resolveEmailOrgId, resolveEmailRegion } from '../util';
+import { createEmailAdapter, resolveEmailOrgId } from '../util';
+import { defaultProfileName, getDefaultRegion } from '../../../../config';
 import { DestinationSchema } from './schemas';
 
 export const urlSubcommand = createCommand({
@@ -41,12 +42,12 @@ export const urlSubcommand = createCommand({
 			destinationConfig.method = opts.method;
 		}
 
-		const email = createEmailAdapter(ctx);
+		const profileName = config?.name ?? defaultProfileName;
+		const region = await getDefaultRegion(profileName, ctx.config);
+		const email = await createEmailAdapter(ctx, region);
 		const destination = await email.createDestination(args.address_id, 'url', destinationConfig);
 
-		const profileName = config?.name ?? 'production';
 		const orgId = resolveEmailOrgId(ctx);
-		const region = resolveEmailRegion(ctx);
 		setResourceInfo('email', profileName, destination.id, region, orgId).catch(() => {
 			// Non-blocking: destination was already created successfully
 		});

package/src/cmd/cloud/email/get.ts

@@ -17,7 +17,7 @@ export const getSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		const address = await email.getAddress(args.id);
 
 		if (!address) {
@@ -35,9 +35,7 @@ export const getSubcommand = createCommand({
 						Provider: address.provider ?? '-',
 						Config: address.config ? JSON.stringify(address.config) : '-',
 						Created: new Date(address.created_at).toLocaleString(),
-						Updated: address.updated_at
-							? new Date(address.updated_at).toLocaleString()
-							: '-',
+						Updated: address.updated_at ? new Date(address.updated_at).toLocaleString() : '-',
 					},
 				],
 				['ID', 'Email', 'Project', 'Provider', 'Config', 'Created', 'Updated'],

package/src/cmd/cloud/email/inbound/get.ts

@@ -18,7 +18,7 @@ export const getSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		const inbound = await email.getInbound(args.id);
 
 		if (!inbound) {
@@ -35,13 +35,12 @@ export const getSubcommand = createCommand({
 						To: inbound.to,
 						Subject: inbound.subject ?? '-',
 						Text: truncate(inbound.text),
-						Status: inbound.status ?? '-',
 						Received: inbound.received_at
 							? new Date(inbound.received_at).toLocaleString()
 							: '-',
 					},
 				],
-				['ID', 'From', 'To', 'Subject', 'Text', 'Status', 'Received'],
+				['ID', 'From', 'To', 'Subject', 'Text', 'Received'],
 				{ layout: 'vertical', padStart: '  ' }
 			);
 		}

package/src/cmd/cloud/email/inbound/list.ts

@@ -19,7 +19,7 @@ export const listSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { opts, options } = ctx;
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		const inbound = await email.listInbound(opts.addressId);
 
 		if (!options.json) {
@@ -29,7 +29,6 @@ export const listSubcommand = createCommand({
 					From: item.from,
 					To: item.to,
 					Subject: item.subject ?? '-',
-					Status: item.status ?? '-',
 					Received: item.received_at ? new Date(item.received_at).toLocaleString() : '-',
 				})),
 				[
@@ -37,7 +36,6 @@ export const listSubcommand = createCommand({
 					{ name: 'From', alignment: 'left' },
 					{ name: 'To', alignment: 'left' },
 					{ name: 'Subject', alignment: 'left' },
-					{ name: 'Status', alignment: 'left' },
 					{ name: 'Received', alignment: 'left' },
 				]
 			);

package/src/cmd/cloud/email/inbound/schemas.ts

@@ -6,6 +6,8 @@ export const EmailInboundSchema = z.object({
 	to: z.string(),
 	subject: z.string().optional(),
 	text: z.string().optional(),
-	status: z.string().optional(),
+	html: z.string().optional(),
 	received_at: z.string().optional(),
+	headers: z.record(z.string(), z.unknown()).optional(),
+	attachments: z.array(z.unknown()).optional(),
 });

package/src/cmd/cloud/email/index.ts

@@ -7,6 +7,7 @@ import { destinationCommand } from './destination';
 import { sendSubcommand } from './send';
 import { inboundCommand } from './inbound';
 import { outboundCommand } from './outbound';
+import { statsSubcommand } from './stats';
 
 export const emailCommand = createCommand({
 	name: 'email',
@@ -22,6 +23,7 @@ export const emailCommand = createCommand({
 		sendSubcommand,
 		inboundCommand,
 		outboundCommand,
+		statsSubcommand,
 	],
 	requires: { auth: true },
 });

package/src/cmd/cloud/email/list.ts

@@ -15,7 +15,7 @@ export const listSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { options } = ctx;
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		const addresses = await email.listAddresses();
 
 		if (!options.json) {
@@ -37,7 +37,14 @@ export const listSubcommand = createCommand({
 			);
 		}
 
-		return addresses;
+		return addresses.map((item) => ({
+			id: item.id,
+			email: item.email,
+			project_id: item.project_id,
+			provider: item.provider,
+			created_at: item.created_at,
+			updated_at: item.updated_at,
+		}));
 	},
 });
 

package/src/cmd/cloud/email/outbound/get.ts

@@ -18,7 +18,7 @@ export const getSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		const outbound = await email.getOutbound(args.id);
 
 		if (!outbound) {
@@ -37,12 +37,12 @@ export const getSubcommand = createCommand({
 						Text: truncate(outbound.text),
 						Status: outbound.status ?? '-',
 						Error: outbound.error ?? '-',
-						Sent: outbound.sent_at
-							? new Date(outbound.sent_at).toLocaleString()
+						Created: outbound.created_at
+							? new Date(outbound.created_at).toLocaleString()
 							: '-',
 					},
 				],
-				['ID', 'From', 'To', 'Subject', 'Text', 'Status', 'Error', 'Sent'],
+				['ID', 'From', 'To', 'Subject', 'Text', 'Status', 'Error', 'Created'],
 				{ layout: 'vertical', padStart: '  ' }
 			);
 		}

package/src/cmd/cloud/email/outbound/list.ts

@@ -19,7 +19,7 @@ export const listSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { opts, options } = ctx;
-		const email = createEmailAdapter(ctx);
+		const email = await createEmailAdapter(ctx);
 		const outbound = await email.listOutbound(opts.addressId);
 
 		if (!options.json) {
@@ -30,7 +30,7 @@ export const listSubcommand = createCommand({
 					To: item.to,
 					Subject: item.subject ?? '-',
 					Status: item.status ?? '-',
-					Sent: item.sent_at ? new Date(item.sent_at).toLocaleString() : '-',
+					Created: item.created_at ? new Date(item.created_at).toLocaleString() : '-',
 				})),
 				[
 					{ name: 'ID', alignment: 'left' },
@@ -38,7 +38,7 @@ export const listSubcommand = createCommand({
 					{ name: 'To', alignment: 'left' },
 					{ name: 'Subject', alignment: 'left' },
 					{ name: 'Status', alignment: 'left' },
-					{ name: 'Sent', alignment: 'left' },
+					{ name: 'Created', alignment: 'left' },
 				]
 			);
 		}

package/src/cmd/cloud/email/outbound/schemas.ts

@@ -9,7 +9,7 @@ export const EmailOutboundSchema = z.object({
 	html: z.string().optional(),
 	status: z.string().optional(),
 	error: z.string().optional(),
-	sent_at: z.string().optional(),
 	created_at: z.string().optional(),
-	updated_at: z.string().optional(),
+	headers: z.record(z.string(), z.unknown()).optional(),
+	attachments: z.array(z.unknown()).optional(),
 });