@agentuity/cli 0.0.53 → 0.0.55

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

@@ -35,7 +35,7 @@ export const getSubcommand = createSubcommand({
 	idempotent: true,
 
 	async handler(ctx) {
-		const { args, opts, apiClient, project } = ctx;
+		const { args, opts, apiClient, project, options } = ctx;
 
 		// Fetch project with unmasked secrets
 		const projectData = await tui.spinner('Fetching secrets', () => {
@@ -49,19 +49,21 @@ export const getSubcommand = createSubcommand({
 			tui.fatal(`Secret '${args.key}' not found`, ErrorCode.RESOURCE_NOT_FOUND);
 		}
 
-		if (process.stdout.isTTY) {
-			// Display the value, masked by default
-			if (opts?.mask) {
-				tui.success(`${args.key}=${maskSecret(value)}`);
+		if (!options.json) {
+			if (process.stdout.isTTY) {
+				// Display the value, masked by default
+				if (opts?.mask) {
+					tui.success(`${args.key}=${maskSecret(value)}`);
+				} else {
+					tui.success(`${args.key}=${value}`);
+				}
 			} else {
-				tui.success(`${args.key}=${value}`);
-			}
-		} else {
-			// Display the value, masked by default
-			if (opts?.mask) {
-				console.log(`${args.key}=${maskSecret(value)}`);
-			} else {
-				console.log(`${args.key}=${value}`);
+				// Display the value, masked by default
+				if (opts?.mask) {
+					console.log(`${args.key}=${maskSecret(value)}`);
+				} else {
+					console.log(`${args.key}=${value}`);
+				}
 			}
 		}
 

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

@@ -26,7 +26,7 @@ export const listSubcommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { opts, apiClient, project } = ctx;
+		const { opts, apiClient, project, options } = ctx;
 
 		// Fetch project with unmasked secrets
 		const projectData = await tui.spinner('Fetching secrets', () => {
@@ -35,28 +35,30 @@ export const listSubcommand = createSubcommand({
 
 		const secrets = projectData.secrets || {};
 
-		if (Object.keys(secrets).length === 0) {
-			tui.info('No secrets found');
-			return {};
-		}
-
-		// Display the secrets
-		if (process.stdout.isTTY) {
-			tui.newline();
-			tui.success(`Secrets (${Object.keys(secrets).length}):`);
-			tui.newline();
-		}
-
-		const sortedKeys = Object.keys(secrets).sort();
-		// For secrets, masking is enabled by default in TTY (can be disabled with --no-mask)
-		const shouldMask = opts?.mask !== false;
-		for (const key of sortedKeys) {
-			const value = secrets[key];
-			const displayValue = shouldMask ? maskSecret(value) : value;
-			if (process.stdout.isTTY) {
-				console.log(`${tui.bold(key)}=${displayValue}`);
+		// Skip TUI output in JSON mode
+		if (!options.json) {
+			if (Object.keys(secrets).length === 0) {
+				tui.info('No secrets found');
 			} else {
-				console.log(`${key}=${displayValue}`);
+				// Display the secrets
+				if (process.stdout.isTTY) {
+					tui.newline();
+					tui.success(`Secrets (${Object.keys(secrets).length}):`);
+					tui.newline();
+				}
+
+				const sortedKeys = Object.keys(secrets).sort();
+				// For secrets, masking is enabled by default in TTY (can be disabled with --no-mask)
+				const shouldMask = opts?.mask !== false;
+				for (const key of sortedKeys) {
+					const value = secrets[key];
+					const displayValue = shouldMask ? maskSecret(value) : value;
+					if (process.stdout.isTTY) {
+						console.log(`${tui.bold(key)}=${displayValue}`);
+					} else {
+						console.log(`${key}=${displayValue}`);
+					}
+				}
 			}
 		}
 

package/src/cmd/cloud/session/logs.ts

@@ -32,29 +32,30 @@ export const logsSubcommand = createSubcommand({
 		response: SessionLogsResponseSchema,
 	},
 	async handler(ctx) {
-		const { apiClient, args } = ctx;
+		const { apiClient, args, options } = ctx;
 
 		try {
 			const logs = await sessionLogs(apiClient, { id: args.session_id });
 
-			if (logs.length === 0) {
-				tui.info('No logs found for this session.');
-				return [];
-			}
-
-			tui.banner(`Logs for Session ${args.session_id}`, `${logs.length} log entries`);
+			if (!options.json) {
+				if (logs.length === 0) {
+					tui.info('No logs found for this session.');
+				} else {
+					tui.banner(`Logs for Session ${args.session_id}`, `${logs.length} log entries`);
 
-			for (const log of logs) {
-				const timestamp = new Date(log.timestamp).toLocaleTimeString();
-				const severity = log.severity.padEnd(5);
-				const severityColor =
-					log.severity === 'ERROR'
-						? tui.error(severity)
-						: log.severity === 'WARN'
-							? tui.warning(severity)
-							: tui.muted(severity);
+					for (const log of logs) {
+						const timestamp = new Date(log.timestamp).toLocaleTimeString();
+						const severity = log.severity.padEnd(5);
+						const severityColor =
+							log.severity === 'ERROR'
+								? tui.error(severity)
+								: log.severity === 'WARN'
+									? tui.warning(severity)
+									: tui.muted(severity);
 
-				console.log(`${tui.muted(timestamp)} ${severityColor} ${log.body}`);
+						console.log(`${tui.muted(timestamp)} ${severityColor} ${log.body}`);
+					}
+				}
 			}
 
 			return logs;

package/src/cmd/dev/agents.ts

@@ -46,22 +46,30 @@ export const agentsSubcommand = createSubcommand({
 				.describe('Output format: json or table'),
 			verbose: z.boolean().optional().default(false).describe('Show full IDs and descriptions'),
 		}),
+		response: z.array(AgentSchema),
 	},
 	async handler(ctx) {
-		const { opts, apiClient, project } = ctx;
+		const { opts, apiClient, project, options } = ctx;
 		const projectId = project.projectId;
 		const format = opts?.format ?? 'table';
 		const verbose = opts?.verbose ?? false;
 
 		const deploymentId = opts?.deploymentId;
 		const queryParams = deploymentId ? `?deploymentId=${deploymentId}` : '';
-		const response = await tui.spinner('Fetching agents', async () => {
-			return apiClient.request(
-				'GET',
-				`/cli/agent/${projectId}${queryParams}`,
-				AgentsResponseSchema
-			);
-		});
+
+		const response = options.json
+			? await apiClient.request(
+					'GET',
+					`/cli/agent/${projectId}${queryParams}`,
+					AgentsResponseSchema
+				)
+			: await tui.spinner('Fetching agents', async () => {
+					return apiClient.request(
+						'GET',
+						`/cli/agent/${projectId}${queryParams}`,
+						AgentsResponseSchema
+					);
+				});
 
 		if (!response.success) {
 			tui.fatal(`Failed to fetch agents: ${response.message ?? 'Unknown error'}`);
@@ -69,54 +77,66 @@ export const agentsSubcommand = createSubcommand({
 
 		const agents = response.data;
 
-		if (format === 'json') {
+		if (format === 'json' && !options.json) {
 			console.log(JSON.stringify(agents, null, 2));
-			return;
+			return agents;
 		}
 
-		tui.info(`Agents (${agents.length})`);
-		if (agents.length === 0) {
-			tui.muted('No agents found');
-		} else {
-			console.table(
-				agents.map((agent) => ({
-					name: agent.name,
-					id: verbose ? agent.id : abbreviate(agent.id, 20),
-					identifier: verbose ? agent.identifier : abbreviate(agent.identifier, 20),
-					deployment: abbreviate(agent.deploymentId, 20),
-					version: verbose
-						? (agent.version ?? 'N/A')
-						: (abbreviate(agent.version, 20) ?? 'N/A'),
-					evals: agent.evals.length,
-					createdAt: new Date(agent.createdAt).toLocaleString(),
-				})),
-				['name', 'id', 'identifier', 'deployment', 'version', 'evals', 'createdAt']
-			);
+		if (!options.json) {
+			tui.info(`Agents (${agents.length})`);
+			if (agents.length === 0) {
+				tui.muted('No agents found');
+			} else {
+				console.table(
+					agents.map((agent) => ({
+						name: agent.name,
+						id: verbose ? agent.id : abbreviate(agent.id, 20),
+						identifier: verbose ? agent.identifier : abbreviate(agent.identifier, 20),
+						deployment: abbreviate(agent.deploymentId, 20),
+						version: verbose
+							? (agent.version ?? 'N/A')
+							: (abbreviate(agent.version, 20) ?? 'N/A'),
+						evals: agent.evals.length,
+						createdAt: new Date(agent.createdAt).toLocaleString(),
+					})),
+					['name', 'id', 'identifier', 'deployment', 'version', 'evals', 'createdAt']
+				);
 
-			// Show evals for each agent
-			for (const agent of agents) {
-				if (agent.evals.length > 0) {
-					console.log(`\n  Evals for ${agent.name}:`);
-					console.table(
-						agent.evals.map((evalItem) => ({
-							name: evalItem.name,
-							id: verbose ? evalItem.id : abbreviate(evalItem.id, 20),
-							identifier: verbose
-								? (evalItem.identifier ?? 'N/A')
-								: (abbreviate(evalItem.identifier, 20) ?? 'N/A'),
-							deployment: abbreviate(evalItem.deploymentId, 20),
-							version: verbose
-								? (evalItem.version ?? 'N/A')
-								: (abbreviate(evalItem.version, 20) ?? 'N/A'),
-							description: verbose
-								? (evalItem.description ?? 'N/A')
-								: abbreviateDescription(evalItem.description),
-							createdAt: new Date(evalItem.createdAt).toLocaleString(),
-						})),
-						['name', 'id', 'identifier', 'deployment', 'version', 'description', 'createdAt']
-					);
+				// Show evals for each agent
+				for (const agent of agents) {
+					if (agent.evals.length > 0) {
+						console.log(`\n  Evals for ${agent.name}:`);
+						console.table(
+							agent.evals.map((evalItem) => ({
+								name: evalItem.name,
+								id: verbose ? evalItem.id : abbreviate(evalItem.id, 20),
+								identifier: verbose
+									? (evalItem.identifier ?? 'N/A')
+									: (abbreviate(evalItem.identifier, 20) ?? 'N/A'),
+								deployment: abbreviate(evalItem.deploymentId, 20),
+								version: verbose
+									? (evalItem.version ?? 'N/A')
+									: (abbreviate(evalItem.version, 20) ?? 'N/A'),
+								description: verbose
+									? (evalItem.description ?? 'N/A')
+									: abbreviateDescription(evalItem.description),
+								createdAt: new Date(evalItem.createdAt).toLocaleString(),
+							})),
+							[
+								'name',
+								'id',
+								'identifier',
+								'deployment',
+								'version',
+								'description',
+								'createdAt',
+							]
+						);
+					}
 				}
 			}
 		}
+
+		return agents;
 	},
 });

package/src/cmd/dev/index.ts

@@ -236,6 +236,7 @@ export const command = createCommand({
 		let showInitialReadyMessage = true;
 		let serverStartTime = 0;
 		let gravityClient: Bun.Subprocess | undefined;
+		let initialStartupComplete = false;
 
 		if (gravityBin && devmode && project) {
 			const sdkKey = await loadProjectSDKKey(rootDir);
@@ -259,7 +260,7 @@ export const command = createCommand({
 								'--url',
 								config?.overrides?.gravity_url ?? 'grpc://devmode.agentuity.com',
 								'--log-level',
-								'error',
+								process.env.AGENTUITY_GRAVITY_LOG_LEVEL ?? 'error',
 							],
 							{
 								cwd: rootDir,
@@ -326,6 +327,7 @@ export const command = createCommand({
 			logger.trace('Killing dev server (pid: %d)', pid);
 			shuttingDownForRestart = true;
 			running = false;
+			process.kill(pid, 'SIGINT');
 			try {
 				// Kill the process group (negative PID kills entire group)
 				process.kill(-pid, 'SIGTERM');
@@ -411,17 +413,10 @@ export const command = createCommand({
 					logger.trace('Initial server start');
 				}
 				logger.trace('Starting typecheck and build...');
-				await Promise.all([
-					tui.runCommand({
-						command: 'tsc',
-						cmd: ['bunx', 'tsc', '--noEmit'],
-						cwd: rootDir,
-						clearOnSuccess: true,
-						truncate: false,
-						maxLinesOutput: 2,
-						maxLinesOnFailure: 15,
-					}),
-					tui.spinner('Building project', async () => {
+				await tui.spinner({
+					message: 'Building project',
+					clearOnSuccess: true,
+					callback: async () => {
 						try {
 							logger.trace('Bundle starting...');
 							building = true;
@@ -430,17 +425,31 @@ export const command = createCommand({
 								dev: true,
 								projectId: project?.projectId,
 								deploymentId,
+								port: opts.port,
 							});
 							building = false;
 							buildCompletedAt = Date.now();
 							logger.trace('Bundle completed successfully');
+							logger.trace('tsc starting...');
+							await tui.runCommand({
+								command: 'tsc',
+								cmd: ['bunx', 'tsc', '--noEmit'],
+								cwd: rootDir,
+								clearOnSuccess: true,
+								truncate: false,
+								maxLinesOutput: 2,
+								maxLinesOnFailure: 15,
+							});
+							logger.trace('tsc completed successfully');
 						} catch (error) {
 							building = false;
 							logger.trace('Bundle failed: %s', error);
 							failure('Build failed');
+							return;
 						}
-					}),
-				]);
+					},
+				});
+
 				logger.trace('Typecheck and build completed');
 
 				if (failed) {
@@ -539,8 +548,14 @@ export const command = createCommand({
 
 				if (showInitialReadyMessage) {
 					showInitialReadyMessage = false;
+					// Clear any lingering spinner/command output - clear everything below cursor
+					process.stderr.write('\x1B[J'); // Clear from cursor to end of screen
+					process.stdout.write('\x1B[J'); // Clear from cursor to end of screen
 					logger.info('DevMode ready 🚀');
 					logger.trace('Initial ready message logged');
+					// Mark initial startup complete immediately to prevent watcher restarts
+					initialStartupComplete = true;
+					logger.trace('Initial startup complete, file watcher restarts now enabled');
 				}
 
 				logger.trace('Attaching exit handler to dev server process...');
@@ -632,6 +647,7 @@ export const command = createCommand({
 		logger.trace('Starting initial build and server');
 		await restart();
 		logger.trace('Initial restart completed, setting up watchers');
+		logger.trace('initialStartupComplete is now: %s', initialStartupComplete);
 
 		// Setup keyboard shortcuts (only if we have a TTY)
 		if (canDoInput) {
@@ -741,6 +757,17 @@ export const command = createCommand({
 				const watcher = watch(watchDir, { recursive: true }, (eventType, changedFile) => {
 					const absPath = changedFile ? resolve(watchDir, changedFile) : watchDir;
 
+					// Ignore file changes during initial startup to prevent spurious restarts
+					if (!initialStartupComplete) {
+						logger.trace(
+							'File change ignored (initial startup): %s (event: %s, file: %s)',
+							watchDir,
+							eventType,
+							changedFile
+						);
+						return;
+					}
+
 					// Ignore file changes during active build to prevent loops
 					if (building) {
 						logger.trace(

package/src/cmd/profile/create.ts

@@ -59,7 +59,7 @@ export const createCommand = createSubcommand({
 			return logger.fatal(
 				`Profile "${name}" already exists at ${existing.filename}`,
 				ErrorCode.RESOURCE_ALREADY_EXISTS
-			);
+			) as never;
 		}
 
 		await ensureConfigDir();
@@ -103,10 +103,10 @@ export const createCommand = createSubcommand({
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
 			const stack = error instanceof Error ? error.stack : undefined;
-			logger.fatal(
+			return logger.fatal(
 				`Failed to create profile: ${message}${stack ? `\n${stack}` : ''}`,
 				ErrorCode.INTERNAL_ERROR
-			);
+			) as never;
 		}
 	},
 });

package/src/cmd/profile/delete.ts

@@ -43,7 +43,7 @@ export const deleteCommand = createSubcommand({
 		const profile = profiles.find((p) => p.name === name);
 
 		if (!profile) {
-			return logger.fatal(`Profile "${name}" not found`, ErrorCode.RESOURCE_NOT_FOUND);
+			return logger.fatal(`Profile "${name}" not found`, ErrorCode.RESOURCE_NOT_FOUND) as never;
 		}
 
 		// Ask for confirmation unless --confirm flag is passed
@@ -66,7 +66,10 @@ export const deleteCommand = createSubcommand({
 
 			return { success: true, name };
 		} catch (error) {
-			logger.fatal(`Failed to delete profile: ${error}`);
+			return logger.fatal(
+				`Failed to delete profile: ${error}`,
+				ErrorCode.FILE_WRITE_ERROR
+			) as never;
 		}
 	},
 });

package/src/cmd/profile/list.ts

@@ -1,9 +1,18 @@
+import { z } from 'zod';
 import { createSubcommand } from '../../types';
 import { fetchProfiles } from '../../config';
 import { basename, dirname } from 'node:path';
 import * as tui from '../../tui';
 import { getCommand } from '../../command-prefix';
 
+const ProfileListResponseSchema = z.array(
+	z.object({
+		name: z.string().describe('Profile name'),
+		filename: z.string().describe('Profile file path'),
+		selected: z.boolean().describe('Whether this profile is currently selected'),
+	})
+);
+
 export const listCommand = createSubcommand({
 	name: 'list',
 	description: 'List all available profiles',
@@ -11,21 +20,32 @@ export const listCommand = createSubcommand({
 	idempotent: true,
 	aliases: ['ls'],
 	examples: [getCommand('profile list'), getCommand('profile ls')],
+	schema: {
+		response: ProfileListResponseSchema,
+	},
 
-	async handler() {
+	async handler(ctx) {
+		const { options } = ctx;
 		const profiles = await fetchProfiles();
 
-		if (profiles.length === 0) {
-			tui.info('No profiles found');
-			return;
+		if (!options.json) {
+			if (profiles.length === 0) {
+				tui.info('No profiles found');
+			} else {
+				console.log('Available profiles:');
+				for (const profile of profiles) {
+					const marker = profile.selected ? '•' : ' ';
+					const name = tui.padRight(profile.name, 15, ' ');
+					const path = `${basename(dirname(profile.filename))}/${basename(profile.filename)}`;
+					console.log(`${marker} ${name} ${tui.muted(path)}`);
+				}
+			}
 		}
 
-		console.log('Available profiles:');
-		for (const profile of profiles) {
-			const marker = profile.selected ? '•' : ' ';
-			const name = tui.padRight(profile.name, 15, ' ');
-			const path = `${basename(dirname(profile.filename))}/${basename(profile.filename)}`;
-			console.log(`${marker} ${name} ${tui.muted(path)}`);
-		}
+		return profiles.map((p) => ({
+			name: p.name,
+			filename: p.filename,
+			selected: p.selected,
+		}));
 	},
 });

package/src/cmd/profile/show.ts

@@ -19,9 +19,6 @@ export const showCommand = createSubcommand({
 		getCommand('profile show staging --json'),
 	],
 	schema: {
-		options: z.object({
-			json: z.boolean().optional().describe('Show the JSON config'),
-		}),
 		args: z
 			.object({
 				name: z.string().optional().describe('Profile name to show (optional)'),
@@ -32,7 +29,7 @@ export const showCommand = createSubcommand({
 	idempotent: true,
 
 	async handler(ctx) {
-		const { logger, args, opts } = ctx;
+		const { logger, args, options } = ctx;
 
 		try {
 			let current = false;
@@ -47,19 +44,25 @@ export const showCommand = createSubcommand({
 			const profile = profiles.find((p) => p.name === name);
 
 			if (!profile) {
-				return logger.fatal(`Profile "${name}" not found`, ErrorCode.RESOURCE_NOT_FOUND);
+				return logger.fatal(
+					`Profile "${name}" not found`,
+					ErrorCode.RESOURCE_NOT_FOUND
+				) as never;
 			}
 
 			const profilePath = profile.filename;
 			current = profile.selected;
 
-			tui.info(`Profile: ${profilePath}`);
-
 			const content = await loadConfig(current ? undefined : profilePath);
+			if (!content) {
+				return logger.fatal(
+					`Failed to load profile configuration`,
+					ErrorCode.INTERNAL_ERROR
+				) as never;
+			}
 
-			if (opts?.json) {
-				console.log(JSON.stringify(content, null, 2));
-			} else {
+			if (!options.json) {
+				tui.info(`Profile: ${profilePath}`);
 				tui.newline();
 				const textContent = await readFile(profilePath, 'utf-8');
 				console.log(textContent);
@@ -68,9 +71,9 @@ export const showCommand = createSubcommand({
 			return content;
 		} catch (error) {
 			if (error instanceof Error) {
-				logger.fatal(`Failed to show profile: ${error.message}`);
+				return logger.fatal(`Failed to show profile: ${error.message}`) as never;
 			} else {
-				logger.fatal('Failed to show profile');
+				return logger.fatal('Failed to show profile') as never;
 			}
 		}
 	},

package/src/cmd/project/delete.ts

@@ -59,7 +59,7 @@ export const deleteSubcommand = createSubcommand({
 
 			if (projects.length === 0) {
 				tui.info('No projects found to delete');
-				return;
+				return { success: false, projectIds: [], count: 0 };
 			}
 
 			// Sort projects by name

package/src/cmd/version/index.ts

@@ -24,7 +24,11 @@ export const command = createCommand({
 			return version;
 		} catch (error) {
 			const logger = createLogger();
-			logger.fatal('Failed to retrieve version: %s', error, ErrorCode.INTERNAL_ERROR);
+			return logger.fatal(
+				'Failed to retrieve version: %s',
+				error,
+				ErrorCode.INTERNAL_ERROR
+			) as never;
 		}
 	},
 });

package/src/tui.ts

@@ -831,7 +831,9 @@ export async function spinner<T>(
 						: await options.callback;
 
 			// If clearOnSuccess is true, don't show success message
-			if (!options.clearOnSuccess) {
+			// Also skip success message in JSON mode
+			const isJsonMode = outputOptions?.json === true;
+			if (!options.clearOnSuccess && !isJsonMode) {
 				const successColor = getColor('success');
 				console.error(`${successColor}${ICONS.success} ${message}${reset}`);
 			}