@agentuity/cli 0.0.104 → 0.0.106

package/src/env-util.ts

@@ -9,27 +9,10 @@ export interface EnvVars {
 }
 
 /**
- * Find the appropriate .env file to use for user environment variables.
- * Always returns .env.production path (will be created if needed).
- * .env should only contain AGENTUITY_SDK_KEY.
- */
-export async function findEnvFile(dir: string): Promise<string> {
-	return join(dir, '.env.production');
-}
-
-/**
- * Find an existing env file for reading.
- * Preference: .env.production > .env
+ * Find an existing .env file for reading.
  */
 export async function findExistingEnvFile(dir: string): Promise<string> {
-	const productionEnv = join(dir, '.env.production');
-	const defaultEnv = join(dir, '.env');
-
-	if (await Bun.file(productionEnv).exists()) {
-		return productionEnv;
-	}
-
-	return defaultEnv;
+	return join(dir, '.env');
 }
 
 /**
@@ -194,9 +177,15 @@ export function filterAgentuitySdkKeys(vars: EnvVars): EnvVars {
 	return filtered;
 }
 
+/**
+ * Keys that should always be treated as secrets (exact match)
+ */
+const secretExactKeys = ['DATABASE_URL'];
+
 /**
  * Split env vars into env and secrets based on key names
  * Convention: Keys ending with _SECRET, _KEY, _TOKEN, _PASSWORD are secrets
+ * Also treats DATABASE_URL as a secret since it contains credentials
  */
 export function splitEnvAndSecrets(vars: EnvVars): {
 	env: EnvVars;
@@ -213,9 +202,10 @@ export function splitEnvAndSecrets(vars: EnvVars): {
 			continue;
 		}
 
-		const isSecret = secretSuffixes.some((suffix) => key.endsWith(suffix));
+		const isSecretByExactMatch = secretExactKeys.includes(key);
+		const isSecretBySuffix = secretSuffixes.some((suffix) => key.endsWith(suffix));
 
-		if (isSecret) {
+		if (isSecretByExactMatch || isSecretBySuffix) {
 			secrets[key] = value;
 		} else {
 			env[key] = value;
@@ -353,3 +343,44 @@ export function looksLikeSecret(key: string, value: string): boolean {
 
 	return false;
 }
+
+/**
+ * Add resource environment variables to the .env file.
+ * Merges with existing variables, overwriting any that already exist.
+ */
+export async function addResourceEnvVars(dir: string, envVars: EnvVars): Promise<void> {
+	const envPath = join(dir, '.env');
+	const existing = await readEnvFile(envPath);
+	const merged = { ...existing, ...envVars };
+	await writeEnvFile(envPath, merged);
+}
+
+/**
+ * Remove resource environment variables from the .env file.
+ * Only removes the specified keys if they exist.
+ */
+export async function removeResourceEnvVars(dir: string, keys: string[]): Promise<void> {
+	const envPath = join(dir, '.env');
+	const existing = await readEnvFile(envPath);
+
+	let changed = false;
+	for (const key of keys) {
+		if (key in existing) {
+			delete existing[key];
+			changed = true;
+		}
+	}
+
+	if (changed) {
+		await writeEnvFile(envPath, existing);
+	}
+}
+
+/**
+ * Get the value of a specific key from the .env file
+ */
+export async function getEnvVar(dir: string, key: string): Promise<string | undefined> {
+	const envPath = join(dir, '.env');
+	const existing = await readEnvFile(envPath);
+	return existing[key];
+}

package/src/tui.ts

@@ -1722,6 +1722,85 @@ export interface TableColumn {
 	alignment?: 'left' | 'right' | 'center';
 }
 
+/**
+ * Table options
+ */
+export interface TableOptions {
+	/**
+	 * If true, returns the table as a string instead of printing to stdout
+	 */
+	render?: boolean;
+	/**
+	 * Force a specific layout mode
+	 * - 'horizontal': Traditional table with columns side by side
+	 * - 'vertical': Stacked format with "Column: value" on separate lines
+	 * - 'auto': Automatically choose based on terminal width (default)
+	 */
+	layout?: 'horizontal' | 'vertical' | 'auto';
+}
+
+/**
+ * Calculate the minimum width needed to display a horizontal table
+ * Accounts for column padding, borders, and content width
+ */
+function calculateTableWidth<T extends Record<string, unknown>>(
+	data: T[],
+	columnNames: string[]
+): number {
+	const columnWidths = columnNames.map((colName) => {
+		let maxWidth = getDisplayWidth(colName);
+		for (const row of data) {
+			const value = row[colName];
+			const valueStr = value !== undefined && value !== null ? String(value) : '';
+			const valueWidth = getDisplayWidth(valueStr);
+			if (valueWidth > maxWidth) {
+				maxWidth = valueWidth;
+			}
+		}
+		return maxWidth;
+	});
+
+	// Add padding (1 space each side) and border characters per column
+	// cli-table3 uses: │ col1 │ col2 │ = 3 chars per column + 1 for final border
+	const paddingPerColumn = 3;
+	const totalWidth = columnWidths.reduce((sum, w) => sum + w + paddingPerColumn, 0) + 1;
+
+	return totalWidth;
+}
+
+/**
+ * Render table in vertical (stacked) format for narrow terminals
+ */
+function renderVerticalTable<T extends Record<string, unknown>>(
+	data: T[],
+	columnNames: string[]
+): string {
+	const lines: string[] = [];
+	const mutedColor = getColor('muted');
+	const reset = getColor('reset');
+
+	// Calculate max column name width for alignment
+	const maxLabelWidth = Math.max(...columnNames.map((name) => 1 + getDisplayWidth(name)));
+
+	for (let i = 0; i < data.length; i++) {
+		const row = data[i];
+
+		for (const colName of columnNames) {
+			const value = row[colName];
+			const valueStr = value !== undefined && value !== null ? String(value) : '';
+			const paddedLabel = `${colName}:`.padEnd(maxLabelWidth);
+			lines.push(`${mutedColor}${paddedLabel}${reset}  ${valueStr}`);
+		}
+
+		// Add empty line between rows (but not after last row)
+		if (i < data.length - 1) {
+			lines.push('');
+		}
+	}
+
+	return lines.join('\n') + '\n';
+}
+
 /**
  * Display data in a formatted table using cli-table3
  *
@@ -1729,6 +1808,9 @@ export interface TableColumn {
  * 1. Simple mode: Pass data array and optional column names
  * 2. Advanced mode: Pass column configurations with custom names and alignment
  *
+ * Automatically switches between horizontal (wide) and vertical (narrow) layouts
+ * based on terminal width. Use the `layout` option to force a specific mode.
+ *
  * @param data - Array of data objects to display
  * @param columns - Column names or column configurations
  * @param options - Additional options
@@ -1737,23 +1819,8 @@ export interface TableColumn {
 export function table<T extends Record<string, unknown>>(
 	data: T[],
 	columns?: (keyof T)[] | TableColumn[],
-	options?: { render?: boolean }
+	options?: TableOptions
 ): string | void {
-	// eslint-disable-next-line @typescript-eslint/no-require-imports
-	const Table = require('cli-table3') as new (options?: {
-		head?: string[];
-		colAligns?: Array<'left' | 'right' | 'center'>;
-		wordWrap?: boolean;
-		style?: {
-			head?: string[];
-			border?: string[];
-		};
-		colors?: boolean;
-	}) => {
-		push(row: unknown[]): void;
-		toString(): string;
-	};
-
 	if (!data || data.length === 0) {
 		return options?.render ? '' : undefined;
 	}
@@ -1764,14 +1831,11 @@ 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
@@ -1780,31 +1844,59 @@ export function table<T extends Record<string, unknown>>(
 				? Object.keys(data[0])
 				: [];
 		colAligns = columnNames.map(() => 'left' as 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
-	});
+	// Determine layout mode
+	const layout = options?.layout ?? 'auto';
+	const termWidth = process.stdout.columns || 80;
+	const tableWidth = calculateTableWidth(data, columnNames);
+	const useVertical = layout === 'vertical' || (layout === 'auto' && tableWidth > termWidth);
 
-	// Add rows to table
-	for (const row of data) {
-		const rowData: unknown[] = [];
-		for (const colName of columnNames) {
-			const value = row[colName];
-			rowData.push(value !== undefined && value !== null ? String(value) : '');
+	let output: string;
+
+	if (useVertical) {
+		output = renderVerticalTable(data, columnNames);
+	} else {
+		// eslint-disable-next-line @typescript-eslint/no-require-imports
+		const Table = require('cli-table3') as new (options?: {
+			head?: string[];
+			colAligns?: Array<'left' | 'right' | 'center'>;
+			wordWrap?: boolean;
+			style?: {
+				head?: string[];
+				border?: string[];
+			};
+			colors?: boolean;
+		}) => {
+			push(row: unknown[]): void;
+			toString(): string;
+		};
+
+		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
+		for (const row of data) {
+			const rowData: unknown[] = [];
+			for (const colName of columnNames) {
+				const value = row[colName];
+				rowData.push(value !== undefined && value !== null ? String(value) : '');
+			}
+			t.push(rowData);
 		}
-		t.push(rowData);
-	}
 
-	const output = t.toString();
+		output = t.toString();
+	}
 
 	if (options?.render) {
 		return output;

package/src/types.ts

@@ -34,6 +34,7 @@ export const ConfigSchema = zod.object({
 			transport_url: zod.url().optional().describe('Override transport URL'),
 			stream_url: zod.url().optional().describe('Override stream URL'),
 			kv_url: zod.url().optional().describe('Override keyvalue URL'),
+			sandbox_url: zod.url().optional().describe('Override sandbox URL'),
 			vector_url: zod.url().optional().describe('Override vector store URL'),
 			catalyst_url: zod.url().optional().describe('Override catalyst URL'),
 			ion_url: zod.url().optional().describe('Override ion URL'),
@@ -228,6 +229,7 @@ export interface CommandSchemas {
 	args?: z.ZodType;
 	options?: z.ZodType;
 	response?: z.ZodType;
+	aliases?: Record<string, string[]>;
 }
 
 export type ProjectConfig = zod.infer<typeof ProjectSchema>;
@@ -377,18 +379,18 @@ export function createSubcommand<
 	schema?: A extends z.ZodType
 		? Op extends z.ZodType
 			? Res extends z.ZodType
-				? { args: A; options: Op; response: Res }
-				: { args: A; options: Op; response?: z.ZodType }
+				? { args: A; options: Op; response: Res; aliases?: Record<string, string[]> }
+				: { args: A; options: Op; response?: z.ZodType; aliases?: Record<string, string[]> }
 			: Res extends z.ZodType
-				? { args: A; response: Res }
-				: { args: A; response?: z.ZodType }
+				? { args: A; response: Res; aliases?: Record<string, string[]> }
+				: { args: A; response?: z.ZodType; aliases?: Record<string, string[]> }
 		: Op extends z.ZodType
 			? Res extends z.ZodType
-				? { options: Op; response: Res }
-				: { options: Op; response?: z.ZodType }
+				? { options: Op; response: Res; aliases?: Record<string, string[]> }
+				: { options: Op; response?: z.ZodType; aliases?: Record<string, string[]> }
 			: Res extends z.ZodType
-				? { response: Res }
-				: { response?: z.ZodType };
+				? { response: Res; aliases?: Record<string, string[]> }
+				: { response?: z.ZodType; aliases?: Record<string, string[]> };
 	handler(
 		ctx: CommandContext<R, O, A, Op>
 	): Res extends z.ZodType ? z.infer<Res> | Promise<z.infer<Res>> : unknown | Promise<unknown>;
@@ -422,18 +424,18 @@ export function createCommand<
 	schema?: A extends z.ZodType
 		? Op extends z.ZodType
 			? Res extends z.ZodType
-				? { args: A; options: Op; response: Res }
-				: { args: A; options: Op; response?: z.ZodType }
+				? { args: A; options: Op; response: Res; aliases?: Record<string, string[]> }
+				: { args: A; options: Op; response?: z.ZodType; aliases?: Record<string, string[]> }
 			: Res extends z.ZodType
-				? { args: A; response: Res }
-				: { args: A; response?: z.ZodType }
+				? { args: A; response: Res; aliases?: Record<string, string[]> }
+				: { args: A; response?: z.ZodType; aliases?: Record<string, string[]> }
 		: Op extends z.ZodType
 			? Res extends z.ZodType
-				? { options: Op; response: Res }
-				: { options: Op; response?: z.ZodType }
+				? { options: Op; response: Res; aliases?: Record<string, string[]> }
+				: { options: Op; response?: z.ZodType; aliases?: Record<string, string[]> }
 			: Res extends z.ZodType
-				? { response: Res }
-				: { response?: z.ZodType };
+				? { response: Res; aliases?: Record<string, string[]> }
+				: { response?: z.ZodType; aliases?: Record<string, string[]> };
 	handler?(
 		ctx: CommandContext<R, O, A, Op>
 	): Res extends z.ZodType ? z.infer<Res> | Promise<z.infer<Res>> : unknown | Promise<unknown>;