@agentuity/cli 0.0.35 → 0.0.42

package/src/tui.ts

@@ -4,7 +4,8 @@
  * Provides semantic helpers for console output with automatic icons and colors.
  * Uses Bun's built-in color support and ANSI escape codes.
  */
-
+import enquirer from 'enquirer';
+import type { OrganizationList } from '@agentuity/server';
 import type { ColorScheme } from './terminal';
 
 // Icons
@@ -17,38 +18,58 @@ const ICONS = {
 	bullet: '•',
 } as const;
 
+function shouldUseColors(): boolean {
+	return !process.env.NO_COLOR && process.env.TERM !== 'dumb' && !!process.stdout.isTTY;
+}
+
 // Color definitions (light/dark adaptive) using Bun.color
-const COLORS = {
-	success: {
-		light: Bun.color('#008000', 'ansi') || '\x1b[32m', // green
-		dark: Bun.color('#00FF00', 'ansi') || '\x1b[92m', // bright green
-	},
-	error: {
-		light: Bun.color('#CC0000', 'ansi') || '\x1b[31m', // red
-		dark: Bun.color('#FF5555', 'ansi') || '\x1b[91m', // bright red
-	},
-	warning: {
-		light: Bun.color('#B58900', 'ansi') || '\x1b[33m', // yellow
-		dark: Bun.color('#FFFF55', 'ansi') || '\x1b[93m', // bright yellow
-	},
-	info: {
-		light: Bun.color('#008B8B', 'ansi') || '\x1b[36m', // dark cyan
-		dark: Bun.color('#55FFFF', 'ansi') || '\x1b[96m', // bright cyan
-	},
-	muted: {
-		light: Bun.color('#808080', 'ansi') || '\x1b[90m', // gray
-		dark: Bun.color('#888888', 'ansi') || '\x1b[90m', // darker gray
-	},
-	bold: {
-		light: '\x1b[1m',
-		dark: '\x1b[1m',
-	},
-	link: {
-		light: '\x1b[34;4m', // blue underline (need ANSI for underline)
-		dark: '\x1b[94;4m', // bright blue underline
-	},
-	reset: '\x1b[0m',
-} as const;
+function getColors() {
+	const USE_COLORS = shouldUseColors();
+	if (!USE_COLORS) {
+		return {
+			success: { light: '', dark: '' },
+			error: { light: '', dark: '' },
+			warning: { light: '', dark: '' },
+			info: { light: '', dark: '' },
+			muted: { light: '', dark: '' },
+			bold: { light: '', dark: '' },
+			link: { light: '', dark: '' },
+			reset: '',
+		} as const;
+	}
+
+	return {
+		success: {
+			light: Bun.color('#008000', 'ansi') || '\x1b[32m', // green
+			dark: Bun.color('#00FF00', 'ansi') || '\x1b[92m', // bright green
+		},
+		error: {
+			light: Bun.color('#CC0000', 'ansi') || '\x1b[31m', // red
+			dark: Bun.color('#FF5555', 'ansi') || '\x1b[91m', // bright red
+		},
+		warning: {
+			light: Bun.color('#B58900', 'ansi') || '\x1b[33m', // yellow
+			dark: Bun.color('#FFFF55', 'ansi') || '\x1b[93m', // bright yellow
+		},
+		info: {
+			light: Bun.color('#008B8B', 'ansi') || '\x1b[36m', // dark cyan
+			dark: Bun.color('#55FFFF', 'ansi') || '\x1b[96m', // bright cyan
+		},
+		muted: {
+			light: Bun.color('#808080', 'ansi') || '\x1b[90m', // gray
+			dark: Bun.color('#888888', 'ansi') || '\x1b[90m', // darker gray
+		},
+		bold: {
+			light: '\x1b[1m',
+			dark: '\x1b[1m',
+		},
+		link: {
+			light: '\x1b[34;4m', // blue underline (need ANSI for underline)
+			dark: '\x1b[94;4m', // bright blue underline
+		},
+		reset: '\x1b[0m',
+	} as const;
+}
 
 let currentColorScheme: ColorScheme = 'dark';
 
@@ -56,7 +77,8 @@ export function setColorScheme(scheme: ColorScheme): void {
 	currentColorScheme = scheme;
 }
 
-function getColor(colorKey: keyof typeof COLORS): string {
+function getColor(colorKey: keyof ReturnType<typeof getColors>): string {
+	const COLORS = getColors();
 	const color = COLORS[colorKey];
 	if (typeof color === 'string') {
 		return color;
@@ -69,7 +91,7 @@ function getColor(colorKey: keyof typeof COLORS): string {
  */
 export function success(message: string): void {
 	const color = getColor('success');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 	console.log(`${color}${ICONS.success} ${message}${reset}`);
 }
 
@@ -78,7 +100,7 @@ export function success(message: string): void {
  */
 export function error(message: string): void {
 	const color = getColor('error');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 	console.error(`${color}${ICONS.error} ${message}${reset}`);
 }
 
@@ -87,7 +109,7 @@ export function error(message: string): void {
  */
 export function fatal(message: string): never {
 	const color = getColor('error');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 	console.error(`${color}${ICONS.error} ${message}${reset}`);
 	process.exit(1);
 }
@@ -97,7 +119,7 @@ export function fatal(message: string): never {
  */
 export function warning(message: string, asError = false): void {
 	const color = asError ? getColor('error') : getColor('warning');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 	console.log(`${color}${ICONS.warning} ${message}${reset}`);
 }
 
@@ -106,7 +128,7 @@ export function warning(message: string, asError = false): void {
  */
 export function info(message: string): void {
 	const color = getColor('info');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 	console.log(`${color}${ICONS.info} ${message}${reset}`);
 }
 
@@ -115,7 +137,7 @@ export function info(message: string): void {
  */
 export function muted(text: string): string {
 	const color = getColor('muted');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 	return `${color}${text}${reset}`;
 }
 
@@ -124,7 +146,7 @@ export function muted(text: string): string {
  */
 export function bold(text: string): string {
 	const color = getColor('bold');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 	return `${color}${text}${reset}`;
 }
 
@@ -133,7 +155,7 @@ export function bold(text: string): string {
  */
 export function link(url: string): string {
 	const color = getColor('link');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 
 	// Check if terminal supports hyperlinks (OSC 8)
 	if (supportsHyperlinks()) {
@@ -205,6 +227,15 @@ export function padLeft(str: string, length: number, pad = ' '): string {
 	return pad.repeat(length - str.length) + str;
 }
 
+interface BannerOptions {
+	padding?: number;
+	minWidth?: number;
+	topSpacer?: boolean;
+	middleSpacer?: boolean;
+	bottomSpacer?: boolean;
+	centerTitle?: boolean;
+}
+
 /**
  * Display a formatted banner with title and body content
  * Creates a bordered box around the content
@@ -212,10 +243,12 @@ export function padLeft(str: string, length: number, pad = ' '): string {
  * Uses Bun.stringWidth() for accurate width calculation with ANSI codes and unicode
  * Responsive to terminal width - adapts to narrow terminals
  */
-export function banner(title: string, body: string): void {
+export function banner(title: string, body: string, options?: BannerOptions): void {
 	// Get terminal width, default to 80 if not available, minimum 40
 	const termWidth = process.stdout.columns || 80;
-	const maxWidth = Math.max(40, Math.min(termWidth - 2, 80)); // Between 40 and 80, with 2 char margin
+	const minWidth = options?.minWidth ?? 40;
+	const maxWidth = Math.max(minWidth, Math.min(termWidth - 2, 80)); // Between 40 and 80, with 2 char margin
+	const padding = options?.padding ?? 4;
 
 	const border = {
 		topLeft: '╭',
@@ -227,19 +260,19 @@ export function banner(title: string, body: string): void {
 	};
 
 	// Split body into lines and wrap if needed
-	const bodyLines = wrapText(body, maxWidth - 4); // -4 for padding and borders
+	const bodyLines = wrapText(body, maxWidth - padding); // -4 for padding and borders
 
 	// Calculate width based on content
 	const titleWidth = getDisplayWidth(title);
 	const maxBodyWidth = Math.max(...bodyLines.map((line) => getDisplayWidth(line)));
-	const contentWidth = Math.max(titleWidth, maxBodyWidth);
-	const boxWidth = Math.min(contentWidth + 4, maxWidth); // +4 for padding
-	const innerWidth = boxWidth - 4;
+	const contentWidth = Math.max(minWidth, Math.max(titleWidth, maxBodyWidth) + padding);
+	const boxWidth = Math.min(contentWidth, maxWidth); // +N for padding
+	const innerWidth = boxWidth - padding;
 
 	// Colors
 	const borderColor = getColor('muted');
 	const titleColor = getColor('info');
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 
 	// Build banner
 	const lines: string[] = [];
@@ -249,41 +282,58 @@ export function banner(title: string, body: string): void {
 		`${borderColor}${border.topLeft}${border.horizontal.repeat(boxWidth - 2)}${border.topRight}${reset}`
 	);
 
-	// Empty line
-	lines.push(
-		`${borderColor}${border.vertical}${' '.repeat(boxWidth - 2)}${border.vertical}${reset}`
-	);
+	if (options?.topSpacer === true || options?.topSpacer === undefined) {
+		// Empty line
+		lines.push(
+			`${borderColor}${border.vertical}${' '.repeat(boxWidth - 2)}${border.vertical}${reset}`
+		);
+	}
 
 	// Title (centered and bold)
 	const titleDisplayWidth = getDisplayWidth(title);
-	const titlePadding = Math.max(0, Math.floor((innerWidth - titleDisplayWidth) / 2));
-	const titleRightPadding = Math.max(0, innerWidth - titlePadding - titleDisplayWidth);
-	const titleLine =
-		' '.repeat(titlePadding) +
-		`${titleColor}${bold(title)}${reset}` +
-		' '.repeat(titleRightPadding);
-	lines.push(
-		`${borderColor}${border.vertical} ${reset}${titleLine}${borderColor} ${border.vertical}${reset}`
-	);
+	if (options?.centerTitle === true || options?.centerTitle === undefined) {
+		const titlePadding = Math.max(0, Math.floor((innerWidth - titleDisplayWidth) / 2));
+		const titleRightPadding = Math.max(
+			0,
+			Math.max(0, innerWidth - titlePadding - titleDisplayWidth) - padding
+		);
+		const titleLine =
+			' '.repeat(titlePadding) +
+			`${titleColor}${bold(title)}${reset}` +
+			' '.repeat(titleRightPadding);
+		lines.push(
+			`${borderColor}${border.vertical} ${reset}${titleLine}${borderColor} ${border.vertical}${reset}`
+		);
+	} else {
+		const titleRightPadding = Math.max(0, Math.max(0, innerWidth - titleDisplayWidth) - padding);
+		const titleLine = `${titleColor}${bold(title)}${reset}` + ' '.repeat(titleRightPadding);
+		lines.push(
+			`${borderColor}${border.vertical} ${reset}${titleLine}${borderColor} ${border.vertical}${reset}`
+		);
+	}
 
-	// Empty line
-	lines.push(
-		`${borderColor}${border.vertical}${' '.repeat(boxWidth - 2)}${border.vertical}${reset}`
-	);
+	if (options?.middleSpacer === true || options?.middleSpacer === undefined) {
+		// Empty line
+		lines.push(
+			`${borderColor}${border.vertical}${' '.repeat(boxWidth - 2)}${border.vertical}${reset}`
+		);
+	}
 
 	// Body lines
 	for (const line of bodyLines) {
 		const lineWidth = getDisplayWidth(line);
-		const padding = Math.max(0, innerWidth - lineWidth);
+		const linePadding = Math.max(0, Math.max(0, innerWidth - lineWidth) - padding);
 		lines.push(
-			`${borderColor}${border.vertical} ${reset}${line}${' '.repeat(padding)}${borderColor} ${border.vertical}${reset}`
+			`${borderColor}${border.vertical} ${reset}${line}${' '.repeat(linePadding)}${borderColor} ${border.vertical}${reset}`
 		);
 	}
 
-	// Empty line
-	lines.push(
-		`${borderColor}${border.vertical}${' '.repeat(boxWidth - 2)}${border.vertical}${reset}`
-	);
+	if (options?.bottomSpacer === true || options?.bottomSpacer === undefined) {
+		// Empty line
+		lines.push(
+			`${borderColor}${border.vertical}${' '.repeat(boxWidth - 2)}${border.vertical}${reset}`
+		);
+	}
 
 	// Bottom border
 	lines.push(
@@ -418,6 +468,30 @@ export function showSignupBenefits(): void {
 	console.log('');
 }
 
+/**
+ * Display a message when unauthenticated to let the user know certain capabilities are disabled
+ */
+export function showLoggedOutMessage(): void {
+	const CYAN = Bun.color('yellow', 'ansi-16m');
+	const TEXT =
+		currentColorScheme === 'dark' ? Bun.color('white', 'ansi') : Bun.color('black', 'ansi');
+	const RESET = '\x1b[0m';
+
+	const lines = [
+		'╔══════════════════════════════════════════════╗',
+		`║ ⨺ Unauthenticated (local mode)               ║`,
+		'║                                              ║',
+		`║ ${TEXT}Certain capabilities such as the AI services${CYAN} ║`,
+		`║ ${TEXT}and devmode remote are unavailable when${CYAN}      ║`,
+		`║ ${TEXT}unauthenticated.${CYAN}                             ║`,
+		'╚══════════════════════════════════════════════╝',
+	];
+
+	console.log('');
+	lines.forEach((line) => console.log(CYAN + line + RESET));
+	console.log('');
+}
+
 /**
  * Copy text to clipboard
  * Returns true if successful, false otherwise
@@ -507,7 +581,7 @@ function stripAnsiCodes(str: string): string {
  * Check if a string ends with ANSI reset code
  */
 function endsWithReset(str: string): boolean {
-	return str.endsWith('\x1b[0m') || str.endsWith(COLORS.reset);
+	return str.endsWith('\x1b[0m') || str.endsWith(getColor('reset'));
 }
 
 /**
@@ -572,7 +646,7 @@ function wrapText(text: string, maxWidth: number): string[] {
 		if (leadingCodes && hasReset) {
 			for (let i = paragraphStart; i < allLines.length; i++) {
 				if (!endsWithReset(allLines[i])) {
-					allLines[i] += COLORS.reset;
+					allLines[i] += getColor('reset');
 				}
 			}
 		}
@@ -649,6 +723,26 @@ export async function spinner<T>(
 	}
 
 	const message = options.message;
+	const reset = getColor('reset');
+
+	// If no TTY, just execute the callback without animation
+	if (!process.stdout.isTTY) {
+		try {
+			const result =
+				options.type === 'progress'
+					? await options.callback(() => {})
+					: typeof options.callback === 'function'
+						? await options.callback()
+						: await options.callback;
+
+			return result;
+		} catch (err) {
+			const errorColor = getColor('error');
+			console.error(`${errorColor}${ICONS.error} ${message}${reset}`);
+			throw err;
+		}
+	}
+
 	const frames = ['◐', '◓', '◑', '◒'];
 	const spinnerColors = [
 		{ light: '\x1b[36m', dark: '\x1b[96m' }, // cyan
@@ -657,7 +751,6 @@ export async function spinner<T>(
 		{ light: '\x1b[36m', dark: '\x1b[96m' }, // cyan
 	];
 	const bold = '\x1b[1m';
-	const reset = COLORS.reset;
 	const cyanColor = { light: '\x1b[36m', dark: '\x1b[96m' }[currentColorScheme];
 
 	let frameIndex = 0;
@@ -812,7 +905,7 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 			? '\x1b[1m' + (Bun.color('#00008B', 'ansi') || '\x1b[34m')
 			: Bun.color('#FFFFFF', 'ansi') || '\x1b[97m'; // bold dark blue / white
 	const mutedColor = Bun.color('#808080', 'ansi') || '\x1b[90m';
-	const reset = COLORS.reset;
+	const reset = getColor('reset');
 
 	// Get terminal width
 	const termWidth = process.stdout.columns || 80;
@@ -905,41 +998,52 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 		// Wait for process to exit
 		const exitCode = await proc.exited;
 
-		// Move cursor up to redraw final state
+		// If clearOnSuccess is true and command succeeded, clear everything
+		if (clearOnSuccess && exitCode === 0) {
+			if (linesRendered > 0) {
+				// Move up to the command line
+				process.stdout.write(`\x1b[${linesRendered}A`);
+				// Clear each line (entire line) and move cursor back up
+				for (let i = 0; i < linesRendered; i++) {
+					process.stdout.write('\x1b[2K'); // Clear entire line
+					if (i < linesRendered - 1) {
+						process.stdout.write('\x1b[B'); // Move down one line
+					}
+				}
+				// Move cursor back up to original position
+				process.stdout.write(`\x1b[${linesRendered}A\r`);
+			}
+			return exitCode;
+		}
+
+		// Clear all rendered lines completely
 		if (linesRendered > 0) {
+			// Move up to the command line (first line of our output)
 			process.stdout.write(`\x1b[${linesRendered}A`);
+			// Move to beginning of line and clear from cursor to end of screen
+			process.stdout.write('\r\x1b[J');
 		}
 
-		// Clear all lines if clearOnSuccess is true and command succeeded
-		if (clearOnSuccess && exitCode === 0) {
-			// Clear all rendered lines
-			for (let i = 0; i < linesRendered; i++) {
-				process.stdout.write('\r\x1b[K\n');
-			}
-			// Move cursor back up
-			process.stdout.write(`\x1b[${linesRendered}A`);
+		// Determine icon based on exit code
+		const icon = exitCode === 0 ? ICONS.success : ICONS.error;
+		const statusColor = exitCode === 0 ? green : red;
 
-			// Show compact success: ✓ command
-			process.stdout.write(
-				`\r\x1b[K${green}${ICONS.success}${reset} ${cmdColor}${displayCmd}${reset}\n`
-			);
-		} else {
-			// Determine how many lines to show in final output
-			const finalLinesToShow = exitCode === 0 ? maxLinesOutput : maxLinesOnFailure;
-
-			// Show final status with appropriate color
-			const statusColor = exitCode === 0 ? green : red;
-			process.stdout.write(`\r\x1b[K${statusColor}$${reset} ${cmdColor}${displayCmd}${reset}\n`);
-
-			// Show final output lines
-			const finalOutputLines = allOutputLines.slice(-finalLinesToShow);
-			for (const line of finalOutputLines) {
-				let displayLine = line;
-				if (truncate && getDisplayWidth(displayLine) > maxLineWidth) {
-					displayLine = displayLine.slice(0, maxLineWidth - 3) + '...';
-				}
-				process.stdout.write(`\r\x1b[K${mutedColor}${displayLine}${reset}\n`);
+		// Show final status: icon + command
+		process.stdout.write(
+			`\r\x1b[K${statusColor}${icon}${reset} ${cmdColor}${displayCmd}${reset}\n`
+		);
+
+		// Determine how many lines to show in final output
+		const finalLinesToShow = exitCode === 0 ? maxLinesOutput : maxLinesOnFailure;
+
+		// Show final output lines
+		const finalOutputLines = allOutputLines.slice(-finalLinesToShow);
+		for (const line of finalOutputLines) {
+			let displayLine = line;
+			if (truncate && getDisplayWidth(displayLine) > maxLineWidth) {
+				displayLine = displayLine.slice(0, maxLineWidth - 3) + '...';
 			}
+			process.stdout.write(`\r\x1b[K${mutedColor}${displayLine}${reset}\n`);
 		}
 
 		return exitCode;
@@ -971,3 +1075,29 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 		process.stdout.write('\x1B[?25h');
 	}
 }
+
+export async function selectOrganization(
+	orgs: OrganizationList,
+	initial?: string
+): Promise<string> {
+	if (orgs.length === 0) {
+		fatal(
+			'You do not belong to any organizations.\n' +
+				'Please contact support or create an organization at https://agentuity.com'
+		);
+	}
+
+	if (orgs.length === 1) {
+		return orgs[0].id;
+	}
+
+	const response = await enquirer.prompt<{ action: string }>({
+		type: 'select',
+		name: 'action',
+		message: 'Select an organization',
+		initial,
+		choices: orgs.map((o) => ({ message: o.name, name: o.id })),
+	});
+
+	return response.action;
+}