@agentuity/cli 0.0.12 → 0.0.15

package/src/tui.ts

@@ -82,6 +82,16 @@ export function error(message: string): void {
 	console.error(`${color}${ICONS.error} ${message}${reset}`);
 }
 
+/**
+ * Print an error message with a red X and then exit
+ */
+export function fatal(message: string): never {
+	const color = getColor('error');
+	const reset = COLORS.reset;
+	console.error(`${color}${ICONS.error} ${message}${reset}`);
+	process.exit(1);
+}
+
 /**
  * Print a warning message with a yellow warning icon
  */
@@ -200,9 +210,13 @@ export function padLeft(str: string, length: number, pad = ' '): string {
  * Creates a bordered box around the content
  *
  * 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 {
-	const maxWidth = 80;
+	// 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 border = {
 		topLeft: '╭',
 		topRight: '╮',
@@ -377,6 +391,33 @@ export async function confirm(message: string, defaultValue = true): Promise<boo
 	});
 }
 
+/**
+ * Display a signup benefits box with cyan border
+ * Shows the value proposition for creating an Agentuity account
+ */
+export function showSignupBenefits(): void {
+	const CYAN = Bun.color('cyan', 'ansi-16m');
+	const TEXT =
+		currentColorScheme === 'dark' ? Bun.color('white', 'ansi') : Bun.color('black', 'ansi');
+	const RESET = '\x1b[0m';
+
+	const lines = [
+		'╔════════════════════════════════════════════╗',
+		`║ ⨺ Signup for Agentuity             ${muted('free')}${CYAN}    ║`,
+		'║                                            ║',
+		`║ ✓ ${TEXT}Cloud deployment, previews and CI/CD${CYAN}     ║`,
+		`║ ✓ ${TEXT}AI Gateway, KV, Vector and more${CYAN}          ║`,
+		`║ ✓ ${TEXT}Observability, Tracing and Logging${CYAN}       ║`,
+		`║ ✓ ${TEXT}Organization and Team support${CYAN}            ║`,
+		`║ ✓ ${TEXT}And much more!${CYAN}                           ║`,
+		'╚════════════════════════════════════════════╝',
+	];
+
+	console.log('');
+	lines.forEach((line) => console.log(CYAN + line + RESET));
+	console.log('');
+}
+
 /**
  * Copy text to clipboard
  * Returns true if successful, false otherwise
@@ -443,9 +484,36 @@ function getDisplayWidth(str: string): number {
 	return Bun.stringWidth(withoutOSC8);
 }
 
+/**
+ * Extract ANSI codes from the beginning of a string
+ */
+function extractLeadingAnsiCodes(str: string): string {
+	// Match ANSI escape sequences at the start of the string
+	// eslint-disable-next-line no-control-regex
+	const match = str.match(/^(\x1b\[[0-9;]*m)+/);
+	return match ? match[0] : '';
+}
+
+/**
+ * Strip ANSI codes from a string
+ */
+function stripAnsiCodes(str: string): string {
+	// Remove all ANSI escape sequences
+	// eslint-disable-next-line no-control-regex
+	return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+/**
+ * Check if a string ends with ANSI reset code
+ */
+function endsWithReset(str: string): boolean {
+	return str.endsWith('\x1b[0m') || str.endsWith(COLORS.reset);
+}
+
 /**
  * Wrap text to a maximum width
  * Handles explicit newlines and word wrapping
+ * Preserves ANSI color codes across wrapped lines
  */
 function wrapText(text: string, maxWidth: number): string[] {
 	const allLines: string[] = [];
@@ -460,6 +528,13 @@ function wrapText(text: string, maxWidth: number): string[] {
 			continue;
 		}
 
+		// Record starting index for this paragraph's lines
+		const paragraphStart = allLines.length;
+
+		// Extract any leading ANSI codes from the paragraph
+		const leadingCodes = extractLeadingAnsiCodes(paragraph);
+		const hasReset = endsWithReset(paragraph);
+
 		// Wrap each paragraph
 		const words = paragraph.split(' ');
 		let currentLine = '';
@@ -477,13 +552,30 @@ function wrapText(text: string, maxWidth: number): string[] {
 				}
 				// If the word itself is longer than maxWidth, just use it as is
 				// (better to have a long line than break in the middle)
-				currentLine = word;
+				// But if we have leading codes and this isn't the first line, apply them
+				if (leadingCodes && currentLine) {
+					// Strip any existing codes from the word to avoid duplication
+					const strippedWord = stripAnsiCodes(word);
+					currentLine = leadingCodes + strippedWord;
+				} else {
+					currentLine = word;
+				}
 			}
 		}
 
 		if (currentLine) {
 			allLines.push(currentLine);
 		}
+
+		// If the original paragraph had ANSI codes and ended with reset,
+		// ensure each wrapped line ends with reset (only for this paragraph's lines)
+		if (leadingCodes && hasReset) {
+			for (let i = paragraphStart; i < allLines.length; i++) {
+				if (!endsWithReset(allLines[i])) {
+					allLines[i] += COLORS.reset;
+				}
+			}
+		}
 	}
 
 	return allLines.length > 0 ? allLines : [''];
@@ -658,6 +750,20 @@ export interface CommandRunnerOptions {
 	 * Defaults to false
 	 */
 	clearOnSuccess?: boolean;
+	/**
+	 * If true or undefined, will truncate each line of output
+	 */
+	truncate?: boolean;
+
+	/**
+	 * If undefined, will show up to 3 last lines of output while running. Customize the number with this property.
+	 */
+	maxLinesOutput?: number;
+
+	/**
+	 * If undefined, will show up to 10 last lines on failure. Customize the number with this property.
+	 */
+	maxLinesOnFailure?: number;
 }
 
 /**
@@ -671,7 +777,16 @@ export interface CommandRunnerOptions {
  * Shows the last 3 lines of output as it streams.
  */
 export async function runCommand(options: CommandRunnerOptions): Promise<number> {
-	const { command, cmd, cwd, env, clearOnSuccess = false } = options;
+	const {
+		command,
+		cmd,
+		cwd,
+		env,
+		clearOnSuccess = false,
+		truncate = true,
+		maxLinesOutput = 3,
+		maxLinesOnFailure = 10,
+	} = options;
 	const isTTY = process.stdout.isTTY;
 
 	// If not a TTY, just run the command normally and log output
@@ -746,7 +861,7 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 	};
 
 	// Initial display
-	renderOutput(3);
+	renderOutput(maxLinesOutput);
 
 	try {
 		// Spawn the command
@@ -810,7 +925,7 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 			);
 		} else {
 			// Determine how many lines to show in final output
-			const finalLinesToShow = exitCode === 0 ? 3 : 10;
+			const finalLinesToShow = exitCode === 0 ? maxLinesOutput : maxLinesOnFailure;
 
 			// Show final status with appropriate color
 			const statusColor = exitCode === 0 ? green : red;
@@ -820,7 +935,7 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 			const finalOutputLines = allOutputLines.slice(-finalLinesToShow);
 			for (const line of finalOutputLines) {
 				let displayLine = line;
-				if (getDisplayWidth(displayLine) > maxLineWidth) {
+				if (truncate && getDisplayWidth(displayLine) > maxLineWidth) {
 					displayLine = displayLine.slice(0, maxLineWidth - 3) + '...';
 				}
 				process.stdout.write(`\r\x1b[K${mutedColor}${displayLine}${reset}\n`);

package/src/types.ts

@@ -150,6 +150,7 @@ export type CommandContext<
 // Helper to create subcommands with proper type inference
 export function createSubcommand<
 	TRequiresAuth extends boolean,
+	TOptionalAuth extends boolean | string,
 	TArgsSchema extends z.ZodType | undefined,
 	TOptionsSchema extends z.ZodType | undefined,
 >(definition: {
@@ -158,6 +159,7 @@ export function createSubcommand<
 	aliases?: string[];
 	toplevel?: boolean;
 	requiresAuth?: TRequiresAuth;
+	optionalAuth?: TOptionalAuth;
 	schema?: TArgsSchema extends z.ZodType
 		? TOptionsSchema extends z.ZodType
 			? { args: TArgsSchema; options: TOptionsSchema }
@@ -166,7 +168,15 @@ export function createSubcommand<
 			? { options: TOptionsSchema }
 			: never;
 	handler(
-		ctx: CommandContext<TRequiresAuth extends true ? true : false, TArgsSchema, TOptionsSchema>
+		ctx: CommandContext<
+			TRequiresAuth extends true
+				? true
+				: TOptionalAuth extends true | string
+					? true | false
+					: false,
+			TArgsSchema,
+			TOptionsSchema
+		>
 	): void | Promise<void>;
 }): SubcommandDefinition {
 	return definition as unknown as SubcommandDefinition;
@@ -175,6 +185,7 @@ export function createSubcommand<
 // Helper to create commands with proper type inference
 export function createCommand<
 	TRequiresAuth extends boolean,
+	TOptionalAuth extends boolean | string,
 	TArgsSchema extends z.ZodType | undefined,
 	TOptionsSchema extends z.ZodType | undefined,
 >(definition: {
@@ -183,6 +194,7 @@ export function createCommand<
 	aliases?: string[];
 	hidden?: boolean;
 	requiresAuth?: TRequiresAuth;
+	optionalAuth?: TOptionalAuth;
 	schema?: TArgsSchema extends z.ZodType
 		? TOptionsSchema extends z.ZodType
 			? { args: TArgsSchema; options: TOptionsSchema }
@@ -191,7 +203,15 @@ export function createCommand<
 			? { options: TOptionsSchema }
 			: never;
 	handler?(
-		ctx: CommandContext<TRequiresAuth extends true ? true : false, TArgsSchema, TOptionsSchema>
+		ctx: CommandContext<
+			TRequiresAuth extends true
+				? true
+				: TOptionalAuth extends true | string
+					? true | false
+					: false,
+			TArgsSchema,
+			TOptionsSchema
+		>
 	): void | Promise<void>;
 	subcommands?: SubcommandDefinition[];
 }): CommandDefinition {
@@ -206,6 +226,7 @@ export type SubcommandDefinition =
 			aliases?: string[];
 			toplevel?: boolean;
 			requiresAuth: true;
+			optionalAuth?: false | string;
 			schema?: CommandSchemas;
 			handler(ctx: CommandContext): void | Promise<void>;
 	  }
@@ -215,6 +236,17 @@ export type SubcommandDefinition =
 			aliases?: string[];
 			toplevel?: boolean;
 			requiresAuth?: false;
+			optionalAuth: true | string;
+			schema?: CommandSchemas;
+			handler(ctx: CommandContext): void | Promise<void>;
+	  }
+	| {
+			name: string;
+			description: string;
+			aliases?: string[];
+			toplevel?: boolean;
+			requiresAuth?: false;
+			optionalAuth?: false;
 			schema?: CommandSchemas;
 			handler(ctx: CommandContext): void | Promise<void>;
 	  };
@@ -227,6 +259,18 @@ export type CommandDefinition =
 			aliases?: string[];
 			hidden?: boolean;
 			requiresAuth: true;
+			optionalAuth?: false | string;
+			schema?: CommandSchemas;
+			handler?(ctx: CommandContext): void | Promise<void>;
+			subcommands?: SubcommandDefinition[];
+	  }
+	| {
+			name: string;
+			description: string;
+			aliases?: string[];
+			hidden?: boolean;
+			requiresAuth?: false;
+			optionalAuth: true | string;
 			schema?: CommandSchemas;
 			handler?(ctx: CommandContext): void | Promise<void>;
 			subcommands?: SubcommandDefinition[];
@@ -237,6 +281,7 @@ export type CommandDefinition =
 			aliases?: string[];
 			hidden?: boolean;
 			requiresAuth?: false;
+			optionalAuth?: false;
 			schema?: CommandSchemas;
 			handler?(ctx: CommandContext): void | Promise<void>;
 			subcommands?: SubcommandDefinition[];