@agentuity/cli 0.0.60 → 0.0.62

package/src/steps.ts

@@ -7,7 +7,7 @@
 
 import type { ColorScheme } from './terminal';
 import type { LogLevel } from './types';
-import { ValidationError } from '@agentuity/server';
+import { ValidationInputError, ValidationOutputError, type IssuesType } from '@agentuity/server';
 
 /**
  * Get the appropriate exit function (Bun.exit or process.exit)
@@ -201,6 +201,17 @@ export async function runSteps(steps: Step[], logLevel?: LogLevel): Promise<void
 	}
 }
 
+function printValidationIssues(issues?: IssuesType) {
+	const errorColor = getColor('red');
+	console.error(`${errorColor}Validation details:${COLORS.reset}`);
+	if (issues) {
+		for (const issue of issues) {
+			const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+			console.error(`  ${path}: ${issue.message}`);
+		}
+	}
+}
+
 /**
  * Run steps with animated TUI (original behavior)
  */
@@ -283,12 +294,11 @@ async function runStepsTUI(state: StepState[]): Promise<void> {
 			if (step.outcome?.status === 'error') {
 				const errorColor = getColor('red');
 				console.error(`\n${errorColor}Error: ${step.outcome.message}${COLORS.reset}`);
-				if (step.outcome.cause instanceof ValidationError) {
-					console.error(`${errorColor}Validation details:${COLORS.reset}`);
-					for (const issue of step.outcome.cause.issues) {
-						const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
-						console.error(`  ${path}: ${issue.message}`);
-					}
+				if (
+					step.outcome.cause instanceof ValidationInputError ||
+					step.outcome.cause instanceof ValidationOutputError
+				) {
+					printValidationIssues(step.outcome.cause.issues);
 				}
 				console.error('');
 				process.stdout.write('\x1B[?25h'); // Show cursor
@@ -342,12 +352,11 @@ async function runStepsPlain(state: StepState[]): Promise<void> {
 			console.log(`${redColor}${ICONS.error}${COLORS.reset} ${step.label}`);
 			const errorColor = getColor('red');
 			console.error(`\n${errorColor}Error: ${step.outcome.message}${COLORS.reset}`);
-			if (step.outcome.cause instanceof ValidationError) {
-				console.error(`${errorColor}Validation details:${COLORS.reset}`);
-				for (const issue of step.outcome.cause.issues) {
-					const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
-					console.error(`  ${path}: ${issue.message}`);
-				}
+			if (
+				step.outcome.cause instanceof ValidationInputError ||
+				step.outcome.cause instanceof ValidationOutputError
+			) {
+				printValidationIssues(step.outcome.cause.issues);
 			}
 			console.error('');
 			process.exit(1);

package/src/tui.ts

@@ -49,6 +49,7 @@ function getColors() {
 			muted: { light: '', dark: '' },
 			bold: { light: '', dark: '' },
 			link: { light: '', dark: '' },
+			primary: { light: '', dark: '' },
 			reset: '',
 		} as const;
 	}
@@ -82,6 +83,10 @@ function getColors() {
 			light: '\x1b[34;4m', // blue underline (need ANSI for underline)
 			dark: '\x1b[94;4m', // bright blue underline
 		},
+		primary: {
+			light: Bun.color('#000000', 'ansi') || '\x1b[30m', // black
+			dark: Bun.color('#FFFFFF', 'ansi') || '\x1b[97m', // white
+		},
 		reset: '\x1b[0m',
 	} as const;
 }
@@ -139,6 +144,12 @@ export function colorMuted(text: string): string {
 	return `${color}${text}${reset}`;
 }
 
+export function colorPrimary(text: string): string {
+	const color = getColor('primary');
+	const reset = getColor('reset');
+	return `${color}${text}${reset}`;
+}
+
 /**
  * Get the appropriate color function for a log severity level
  */
@@ -241,25 +252,15 @@ export function bold(text: string): string {
  * Used for table headings
  */
 export function heading(text: string): string {
-	const USE_COLORS = shouldUseColors();
-	if (!USE_COLORS) {
-		return text;
-	}
-
-	// For light mode: use inverse (black bg, white text)
-	// For dark mode: use white bold
-	const style = isDarkMode()
-		? '\x1b[1;37m' // bold white
-		: '\x1b[7m'; // inverse
+	const color = getColor('info');
 	const reset = getColor('reset');
-	return `${style}${text}${reset}`;
+	return `${color}${text}${reset}`;
 }
 
 /**
  * Format text as a link (blue and underlined)
  */
-export function link(url: string, title?: string): string {
-	const color = getColor('link');
+export function link(url: string, title?: string, color = getColor('link')): string {
 	const reset = getColor('reset');
 
 	// Check if terminal supports hyperlinks (OSC 8) and colors are enabled
@@ -1439,6 +1440,11 @@ export function table<T extends Record<string, unknown>>(
 		head?: string[];
 		colAligns?: Array<'left' | 'right' | 'center'>;
 		wordWrap?: boolean;
+		style?: {
+			head?: string[];
+			border?: string[];
+		};
+		colors?: boolean;
 	}) => {
 		push(row: unknown[]): void;
 		toString(): string;
@@ -1454,11 +1460,14 @@ export function table<T extends Record<string, unknown>>(
 	let columnNames: string[];
 	let colAligns: Array<'left' | 'right' | 'center'>;
 
+	let headings: string[];
+
 	if (isAdvancedMode) {
 		// Advanced mode: use provided column configurations
 		const columnConfigs = columns as TableColumn[];
 		columnNames = columnConfigs.map((col) => col.name);
 		colAligns = columnConfigs.map((col) => col.alignment || 'left');
+		headings = columnNames.map((name) => heading(name));
 	} else {
 		// Simple mode: determine column names from data or columns parameter
 		columnNames = columns
@@ -1467,15 +1476,18 @@ export function table<T extends Record<string, unknown>>(
 				? Object.keys(data[0])
 				: [];
 		colAligns = columnNames.map(() => 'left' as const);
+		headings = columnNames.map((name) => heading(name));
 	}
 
-	// Apply heading style to column names
-	const headings = columnNames.map((name) => heading(name));
-
 	const t = new Table({
 		head: headings,
 		colAligns,
 		wordWrap: true,
+		style: {
+			head: [], // Disable cli-table3's default red styling - we apply our own via heading()
+			border: [], // Disable default border styling too
+		},
+		colors: false, // Completely disable cli-table3's color system to preserve our ANSI codes
 	});
 
 	// Add rows to table

package/src/types.ts

@@ -127,6 +127,11 @@ export interface PaginationInfo {
 	};
 }
 
+export interface CommandExample {
+	command: string;
+	description: string;
+}
+
 export interface CommandSchemas {
 	args?: z.ZodType;
 	options?: z.ZodType;
@@ -263,7 +268,7 @@ export function createSubcommand<
 	toplevel?: boolean;
 	requires?: R;
 	optional?: O;
-	examples?: string[];
+	examples?: CommandExample[];
 	idempotent?: boolean;
 	prerequisites?: string[];
 	pagination?: PaginationInfo;
@@ -304,7 +309,7 @@ export function createCommand<
 	hidden?: boolean;
 	requires?: R;
 	optional?: O;
-	examples?: string[];
+	examples?: CommandExample[];
 	idempotent?: boolean;
 	prerequisites?: string[];
 	pagination?: PaginationInfo;
@@ -338,7 +343,7 @@ type CommandDefBase =
 			description: string;
 			aliases?: string[];
 			banner?: boolean;
-			examples?: string[];
+			examples?: CommandExample[];
 			idempotent?: boolean;
 			prerequisites?: string[];
 			pagination?: PaginationInfo;
@@ -352,7 +357,7 @@ type CommandDefBase =
 			description: string;
 			aliases?: string[];
 			banner?: boolean;
-			examples?: string[];
+			examples?: CommandExample[];
 			idempotent?: boolean;
 			prerequisites?: string[];
 			pagination?: PaginationInfo;
@@ -369,7 +374,7 @@ type SubcommandDefBase =
 			aliases?: string[];
 			toplevel?: boolean;
 			banner?: boolean;
-			examples?: string[];
+			examples?: CommandExample[];
 			idempotent?: boolean;
 			prerequisites?: string[];
 			pagination?: PaginationInfo;
@@ -384,7 +389,7 @@ type SubcommandDefBase =
 			aliases?: string[];
 			toplevel?: boolean;
 			banner?: boolean;
-			examples?: string[];
+			examples?: CommandExample[];
 			idempotent?: boolean;
 			prerequisites?: string[];
 			pagination?: PaginationInfo;

package/src/utils/date.ts

@@ -1,3 +1,7 @@
+import { StructuredError } from '@agentuity/core';
+
+const InvalidDateFormatError = StructuredError('InvalidDateFormatError')<{ input: string }>();
+
 /**
  * Parse duration string (e.g., "1h", "2d", "1y") or ISO date to ISO date string
  *
@@ -16,7 +20,7 @@ export function parseExpiresAt(input: string): string {
 		// Validate it's a valid date
 		const date = new Date(input);
 		if (isNaN(date.getTime())) {
-			throw new Error(`Invalid date format: ${input}`);
+			throw new InvalidDateFormatError({ input, message: `Invalid date format: ${input}` });
 		}
 		return date.toISOString();
 	}
@@ -26,9 +30,10 @@ export function parseExpiresAt(input: string): string {
 	const match = input.match(durationRegex);
 
 	if (!match) {
-		throw new Error(
-			`Invalid expires-at format: ${input}. Use ISO date (2025-12-31T23:59:59Z) or duration (1h, 2d, 1y)`
-		);
+		throw new InvalidDateFormatError({
+			input,
+			message: `Invalid expires-at format: ${input}. Use ISO date (2025-12-31T23:59:59Z) or duration (1h, 2d, 1y)`,
+		});
 	}
 
 	const [, amount, unit] = match;