@agentuity/cli 0.1.11 → 0.1.13

package/src/cmd/auth/login.ts

@@ -1,5 +1,6 @@
+import { z } from 'zod';
 import { createSubcommand } from '../../types';
-import { getAppBaseURL } from '../../api';
+import { getAPIBaseURL, getAppBaseURL } from '../../api';
 import { saveAuth } from '../../config';
 import { generateLoginCode, pollForLoginCompletion } from './api';
 import * as tui from '../../tui';
@@ -17,8 +18,53 @@ export const loginCommand = createSubcommand({
 		{ command: getCommand('auth login'), description: 'Login to account' },
 		{ command: getCommand('login'), description: 'Login to account' },
 	],
+	schema: {
+		options: z.object({
+			setupToken: z.string().optional().describe('Use a one-time use setup token'),
+		}),
+		response: z.object({ success: z.boolean() }),
+	},
 	async handler(ctx) {
-		const { logger, config, apiClient } = ctx;
+		const { logger, config, apiClient, opts, options } = ctx;
+
+		if (opts.setupToken) {
+			const url = getAPIBaseURL(config);
+			try {
+				const res = await fetch(
+					`${url}/cli/auth/setup-token/${encodeURIComponent(opts.setupToken)}`,
+					{
+						signal: AbortSignal.timeout(5000),
+					}
+				);
+				if (res.ok) {
+					const result = (await res.json()) as {
+						success: boolean;
+						message: string;
+						data?: { apiKey: string; expiresAt: number; userId: string };
+					};
+					if (result.success && result.data) {
+						await saveAuth({
+							apiKey: result.data.apiKey,
+							userId: result.data.userId,
+							expires: new Date(result.data.expiresAt),
+						});
+						if (!options.json) {
+							tui.success('Welcome to Agentuity! You are now logged in');
+						}
+						return { success: true };
+					}
+				} else {
+					throw new Error(await res.text());
+				}
+			} catch (ex) {
+				if (options.json) {
+					return {
+						success: false,
+					};
+				}
+				tui.error(`error validating the setup token: ${ex}`);
+			}
+		}
 
 		const appUrl = getAppBaseURL(config);
 
@@ -32,7 +78,7 @@ export const loginCommand = createSubcommand({
 			});
 
 			if (!code) {
-				return;
+				return { success: false };
 			}
 
 			const authURL = `${appUrl}/auth/cli?code=${code}`;
@@ -84,11 +130,17 @@ export const loginCommand = createSubcommand({
 				expires: result.expires,
 			});
 
-			tui.newline();
-			tui.success('Welcome to Agentuity! You are now logged in');
+			if (!options.json) {
+				tui.newline();
+				tui.success('Welcome to Agentuity! You are now logged in');
+			}
+
+			return { success: true };
 		} catch (error) {
 			logger.trace(error);
 			logger.fatal('Login failed: %s', error, ErrorCode.AUTH_FAILED);
 		}
+
+		return { success: false };
 	},
 });

package/src/cmd/build/patch/_util.ts

@@ -17,9 +17,13 @@ export interface PatchModule {
 
 export function generateEnvWarning(envkey: string): string {
 	return `if (process.env.AGENTUITY_ENVIRONMENT === 'development' || process.env.NODE_ENV !== 'production') {
-      console.error('The required environment variable ${envkey} must be set in your project .env file or in your local system environment.');
+      console.error('[ERROR] No credentials found for this AI provider. To fix this, either:');
+      console.error('  1. Login to Agentuity Cloud (agentuity auth login) to use the AI Gateway (recommended)');
+      console.error('  2. Set ${envkey} in your .env file to use the provider directly');
      } else {
-      console.error('The required environment variable ${envkey} is required for this project. Use "agentuity env set ${envkey}" to set it and redeploy your project.');
+      console.error('[ERROR] The environment variable ${envkey} is required. Either:');
+      console.error('  1. Use Agentuity Cloud AI Gateway by ensuring AGENTUITY_SDK_KEY is configured');
+      console.error('  2. Set ${envkey} using "agentuity env set ${envkey}" and redeploy');
      }
 `;
 }

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

@@ -43,12 +43,20 @@ export const getSubcommand = createSubcommand({
 		}
 
 		// Display agent details
-		console.log(tui.bold('ID:          ') + agent.identifier);
-		console.log(tui.bold('Name:        ') + agent.name);
-		console.log(tui.bold('Description: ') + (agent.description || 'N/A'));
-		console.log(tui.bold('Dev Mode:    ') + (agent.devmode ? 'Yes' : 'No'));
-		console.log(tui.bold('Created:     ') + new Date(agent.createdAt).toLocaleString());
-		console.log(tui.bold('Updated:     ') + new Date(agent.updatedAt).toLocaleString());
+		tui.table(
+			[
+				{
+					ID: agent.identifier,
+					Name: agent.name,
+					Description: agent.description || 'N/A',
+					'Dev Mode': agent.devmode ? 'Yes' : 'No',
+					Created: new Date(agent.createdAt).toLocaleString(),
+					Updated: new Date(agent.updatedAt).toLocaleString(),
+				},
+			],
+			['ID', 'Name', 'Description', 'Dev Mode', 'Created', 'Updated'],
+			{ layout: 'vertical', padStart: '  ' }
+		);
 
 		// Display metadata if present
 		if (agent.metadata && Object.keys(agent.metadata).length > 0) {

package/src/cmd/cloud/db/create.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { createResources, APIError } from '@agentuity/server';
+import { createResources, APIError, validateDatabaseName } from '@agentuity/server';
 import { createSubcommand as defineSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { getCatalystAPIClient } from '../../../config';
@@ -24,6 +24,7 @@ export const createSubcommand = defineSubcommand({
 	schema: {
 		options: z.object({
 			name: z.string().optional().describe('Custom database name'),
+			description: z.string().optional().describe('Optional database description'),
 		}),
 		response: z.object({
 			success: z.boolean().describe('Whether creation succeeded'),
@@ -34,11 +35,22 @@ export const createSubcommand = defineSubcommand({
 	async handler(ctx) {
 		const { logger, opts, orgId, region, auth, options } = ctx;
 
+		// Validate database name if provided
+		if (opts.name) {
+			const validation = validateDatabaseName(opts.name);
+			if (!validation.valid) {
+				tui.fatal(validation.error!, ErrorCode.INVALID_ARGUMENT);
+			}
+		}
+
 		// Handle dry-run mode
 		if (isDryRunMode(options)) {
-			const message = opts.name
+			let message = opts.name
 				? `Would create database with name: ${opts.name} in region: ${region}`
 				: `Would create database in region: ${region}`;
+			if (opts.description) {
+				message += ` with description: "${opts.description}"`;
+			}
 			outputDryRun(message, options);
 			if (!options.json) {
 				tui.newline();
@@ -58,7 +70,7 @@ export const createSubcommand = defineSubcommand({
 				clearOnSuccess: true,
 				callback: async () => {
 					return await createResources(catalystClient, orgId, region!, [
-						{ type: 'db', name: opts.name },
+						{ type: 'db', name: opts.name, description: opts.description },
 					]);
 				},
 			});

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

@@ -10,6 +10,7 @@ import { getResourceInfo, setResourceInfo } from '../../../cache';
 const DBGetResponseSchema = z
 	.object({
 		name: z.string().describe('Database name'),
+		description: z.string().optional().describe('Database description'),
 		url: z.string().optional().describe('Database connection URL'),
 	})
 	.or(
@@ -171,15 +172,25 @@ export const getSubcommand = createSubcommand({
 		const shouldMask = !options.json && !shouldShowCredentials;
 
 		if (!options.json) {
-			console.log(tui.bold('Name: ') + db.name);
+			const tableData: Record<string, string> = {
+				Name: tui.bold(db.name),
+			};
+			if (db.description) {
+				tableData['Description'] = db.description;
+			}
+			if (db.cloud_region) {
+				tableData['Region'] = db.cloud_region;
+			}
 			if (db.url) {
-				const displayUrl = shouldMask ? tui.maskSecret(db.url) : db.url;
-				console.log(tui.bold('URL:  ') + displayUrl);
+				tableData['URL'] = shouldMask ? tui.maskSecret(db.url) : db.url;
 			}
+
+			tui.table([tableData], Object.keys(tableData), { layout: 'vertical', padStart: '  ' });
 		}
 
 		return {
 			name: db.name,
+			description: db.description ?? undefined,
 			url: db.url ?? undefined,
 		};
 	},

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

@@ -4,13 +4,13 @@ import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { getGlobalCatalystAPIClient } from '../../../config';
 import { getCommand } from '../../../command-prefix';
-import { setResourceInfo } from '../../../cache';
 
 const DBListResponseSchema = z.object({
 	databases: z
 		.array(
 			z.object({
 				name: z.string().describe('Database name'),
+				description: z.string().optional().describe('Database description'),
 				url: z.string().optional().describe('Database connection URL'),
 				cloud_region: z.string().optional().describe('Cloud region where database is hosted'),
 			})
@@ -23,7 +23,7 @@ export const listSubcommand = createSubcommand({
 	aliases: ['ls'],
 	description: 'List database resources',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, org: true },
+	requires: { auth: true },
 	idempotent: true,
 	examples: [
 		{ command: getCommand('cloud db list'), description: 'List items' },
@@ -49,24 +49,18 @@ export const listSubcommand = createSubcommand({
 	webUrl: '/services/database',
 
 	async handler(ctx) {
-		const { logger, opts, options, orgId, auth, config } = ctx;
+		const { logger, opts, options, auth, config } = ctx;
 
 		const catalystClient = await getGlobalCatalystAPIClient(logger, auth, config?.name);
 
-		const profileName = config?.name ?? 'production';
 		const resources = await tui.spinner({
-			message: `Fetching databases for ${orgId}`,
+			message: 'Fetching databases',
 			clearOnSuccess: true,
 			callback: async () => {
-				return listOrgResources(catalystClient, { type: 'db', orgId });
+				return listOrgResources(catalystClient, { type: 'db' });
 			},
 		});
 
-		// Cache each database with its region and orgId for future lookups
-		for (const db of resources.db) {
-			await setResourceInfo('db', profileName, db.name, db.cloud_region, orgId);
-		}
-
 		// Mask credentials in terminal output by default, unless --show-credentials is passed
 		const shouldShowCredentials = opts.showCredentials === true;
 		const shouldMask = !options.json && !shouldShowCredentials;
@@ -74,29 +68,25 @@ export const listSubcommand = createSubcommand({
 		if (!options.json) {
 			if (resources.db.length === 0) {
 				tui.info('No databases found');
-			} else {
-				if (!opts.nameOnly) {
-					tui.info(tui.bold('Databases'));
-					tui.newline();
-				}
+			} else if (opts.nameOnly) {
 				for (const db of resources.db) {
-					if (opts.nameOnly) {
-						console.log(db.name);
-						continue;
-					}
-					console.log(tui.bold(db.name));
-					if (db.url) {
-						const displayUrl = shouldMask ? tui.maskSecret(db.url) : db.url;
-						console.log(` URL: ${tui.muted(displayUrl)}`);
-					}
-					tui.newline();
+					console.log(db.name);
 				}
+			} else {
+				const tableData = resources.db.map((db) => ({
+					Name: db.name,
+					Description: db.description ?? '',
+					Region: db.cloud_region,
+					URL: db.url ? (shouldMask ? tui.maskSecret(db.url) : db.url) : '',
+				}));
+				tui.table(tableData);
 			}
 		}
 
 		return {
 			databases: resources.db.map((db) => ({
 				name: db.name,
+				description: db.description ?? undefined,
 				url: db.url ?? undefined,
 				cloud_region: db.cloud_region,
 			})),

package/src/cmd/cloud/deployment/show.ts

@@ -90,82 +90,88 @@ export const showSubcommand = createSubcommand({
 
 			// Skip TUI output in JSON mode
 			if (!options.json) {
-				const maxWidth = 18;
-				console.log(tui.bold('ID:'.padEnd(maxWidth)) + deployment.id);
-				console.log(tui.bold('Project:'.padEnd(maxWidth)) + projectId);
-				console.log(tui.bold('State:'.padEnd(maxWidth)) + (deployment.state || 'unknown'));
-				console.log(tui.bold('Active:'.padEnd(maxWidth)) + (deployment.active ? 'Yes' : 'No'));
-				console.log(
-					tui.bold('Created:'.padEnd(maxWidth)) +
-						new Date(deployment.createdAt).toLocaleString()
-				);
+				const tableData: Record<string, string> = {
+					ID: deployment.id,
+					Project: projectId,
+					State: deployment.state || 'unknown',
+					Active: deployment.active ? 'Yes' : 'No',
+					Created: new Date(deployment.createdAt).toLocaleString(),
+				};
 				if (deployment.updatedAt) {
-					console.log(
-						tui.bold('Updated:'.padEnd(maxWidth)) +
-							new Date(deployment.updatedAt).toLocaleString()
-					);
+					tableData['Updated'] = new Date(deployment.updatedAt).toLocaleString();
 				}
 				if (deployment.message) {
-					console.log(tui.bold('Message:'.padEnd(maxWidth)) + deployment.message);
+					tableData['Message'] = deployment.message;
 				}
 				if (deployment.tags.length > 0) {
-					console.log(tui.bold('Tags:'.padEnd(maxWidth)) + deployment.tags.join(', '));
+					tableData['Tags'] = deployment.tags.join(', ');
 				}
 				if (deployment.customDomains && deployment.customDomains.length > 0) {
-					console.log(
-						tui.bold('Domains:'.padEnd(maxWidth)) + deployment.customDomains.join(', ')
-					);
+					tableData['Domains'] = deployment.customDomains.join(', ');
 				}
 				if (deployment.cloudRegion) {
-					console.log(tui.bold('Region:'.padEnd(maxWidth)) + deployment.cloudRegion);
+					tableData['Region'] = deployment.cloudRegion;
 				}
 				if (deployment.resourceDb) {
-					console.log(tui.bold('Database:'.padEnd(maxWidth)) + deployment.resourceDb);
+					tableData['Database'] = deployment.resourceDb;
 				}
 				if (deployment.resourceStorage) {
-					console.log(tui.bold('Storage:'.padEnd(maxWidth)) + deployment.resourceStorage);
+					tableData['Storage'] = deployment.resourceStorage;
 				}
 				if (deployment.deploymentLogsURL) {
-					console.log(
-						tui.bold('Deployment Logs:'.padEnd(maxWidth)) +
-							tui.link(deployment.deploymentLogsURL)
-					);
+					tableData['Deployment Logs'] = tui.link(deployment.deploymentLogsURL);
 				}
 				if (deployment.buildLogsURL) {
-					console.log(
-						tui.bold('Build Logs:'.padEnd(maxWidth)) + tui.link(deployment.buildLogsURL)
-					);
+					tableData['Build Logs'] = tui.link(deployment.buildLogsURL);
 				}
 
+				tui.table([tableData], Object.keys(tableData), { layout: 'vertical', padStart: '  ' });
+
 				// Git metadata
 				const git = deployment.metadata?.git;
 				if (git) {
-					tui.newline();
-					tui.info('Git Information');
-					if (git.repo) console.log(`  Repo:     ${git.repo}`);
-					if (git.branch) console.log(`  Branch:   ${git.branch}`);
-					if (git.commit) console.log(`  Commit:   ${git.commit}`);
-					if (git.message) console.log(`  Message:  ${git.message}`);
-					if (git.url) console.log(`  URL:      ${git.url}`);
-					if (git.trigger) console.log(`  Trigger:  ${git.trigger}`);
-					if (git.provider) console.log(`  Provider: ${git.provider}`);
-					if (git.event) console.log(`  Event:    ${git.event}`);
+					const gitData: Record<string, string> = {};
+					if (git.repo) gitData['Repo'] = git.repo;
+					if (git.branch) gitData['Branch'] = git.branch;
+					if (git.commit) gitData['Commit'] = git.commit;
+					if (git.message) gitData['Message'] = git.message;
+					if (git.url) gitData['URL'] = git.url;
+					if (git.trigger) gitData['Trigger'] = git.trigger;
+					if (git.provider) gitData['Provider'] = git.provider;
+					if (git.event) gitData['Event'] = git.event;
 					if (git.pull_request) {
-						console.log(`  PR:       #${git.pull_request.number}`);
-						if (git.pull_request.url) console.log(`  PR URL:   ${git.pull_request.url}`);
+						gitData['PR'] = `#${git.pull_request.number}`;
+						if (git.pull_request.url) gitData['PR URL'] = git.pull_request.url;
+					}
+					if (git.buildUrl) gitData['Build'] = git.buildUrl;
+
+					if (Object.keys(gitData).length > 0) {
+						tui.newline();
+						tui.info('Git Information');
+						tui.table([gitData], Object.keys(gitData), {
+							layout: 'vertical',
+							padStart: '  ',
+						});
 					}
-					if (git.buildUrl) console.log(`  Build:    ${git.buildUrl}`);
 				}
 
 				// Build metadata
 				const build = deployment.metadata?.build;
 				if (build) {
-					tui.newline();
-					tui.info('Build Information');
-					if (build.agentuity) console.log(`  Agentuity: ${build.agentuity}`);
-					if (build.bun) console.log(`  Bun:       ${build.bun}`);
-					if (build.platform) console.log(`  Platform:  ${build.platform}`);
-					if (build.arch) console.log(`  Arch:      ${build.arch}`);
+					const buildData: Record<string, string> = {};
+					if (build.agentuity) buildData['Agentuity'] = build.agentuity;
+					if (build.bun) buildData['Bun'] = build.bun;
+					if (build.platform) buildData['Platform'] = build.platform;
+					if (build.arch) buildData['Arch'] = build.arch;
+
+					if (Object.keys(buildData).length > 0) {
+						tui.newline();
+						tui.info('Build Information');
+						tui.table([buildData], Object.keys(buildData), {
+							layout: 'vertical',
+							padStart: '  ',
+						});
+					}
 				}
 			}
 

package/src/cmd/cloud/sandbox/create.ts

@@ -25,6 +25,7 @@ export const createSubcommand = createCommand({
 	description: 'Create an interactive sandbox for multiple executions',
 	tags: ['slow', 'requires-auth'],
 	requires: { auth: true, region: true, org: true },
+	optional: { project: true },
 	examples: [
 		{
 			command: getCommand('cloud sandbox create'),
@@ -46,6 +47,10 @@ export const createSubcommand = createCommand({
 			command: getCommand('cloud sandbox create --env KEY=VAL'),
 			description: 'Create a sandbox with a specific environment variable',
 		},
+		{
+			command: getCommand('cloud sandbox create --project-id proj_123'),
+			description: 'Create a sandbox associated with a specific project',
+		},
 	],
 	schema: {
 		options: z.object({
@@ -72,12 +77,21 @@ export const createSubcommand = createCommand({
 				.optional()
 				.describe('Apt packages to install (can be specified multiple times)'),
 			metadata: z.string().optional().describe('JSON object of user-defined metadata'),
+			port: z
+				.number()
+				.int()
+				.min(1024)
+				.max(65535)
+				.optional()
+				.describe('Port to expose from the sandbox to the outside Internet (1024-65535)'),
+			projectId: z.string().optional().describe('Project ID to associate this sandbox with'),
 		}),
 		response: SandboxCreateResponseSchema,
 	},
 
 	async handler(ctx) {
-		const { opts, options, auth, region, config, logger, orgId } = ctx;
+		const { opts, options, auth, region, config, logger, orgId, project } = ctx;
+		const projectId = opts.projectId || project?.projectId;
 		const client = createSandboxClient(logger, auth, region);
 		const started = Date.now();
 
@@ -152,6 +166,7 @@ export const createSubcommand = createCommand({
 
 		const result = await sandboxCreate(client, {
 			options: {
+				projectId,
 				runtime: opts.runtime,
 				runtimeId: opts.runtimeId,
 				name: opts.name,
@@ -164,7 +179,10 @@ export const createSubcommand = createCommand({
 								disk: opts.disk,
 							}
 						: undefined,
-				network: opts.network ? { enabled: true } : undefined,
+				network:
+					opts.network || opts.port
+						? { enabled: opts.network || opts.port !== undefined, port: opts.port }
+						: undefined,
 				timeout: opts.idleTimeout ? { idle: opts.idleTimeout } : undefined,
 				env: Object.keys(envMap).length > 0 ? envMap : undefined,
 				command: hasFiles ? { exec: [], files } : undefined,

package/src/cmd/cloud/sandbox/execution/get.ts

@@ -55,36 +55,39 @@ export const getSubcommand = createCommand({
 							? tui.colorError
 							: tui.colorMuted;
 
-			console.log(`${tui.muted('Execution:')}       ${tui.bold(result.executionId)}`);
-			console.log(`${tui.muted('Sandbox:')}         ${result.sandboxId}`);
-			console.log(`${tui.muted('Status:')}          ${statusColor(result.status)}`);
+			const tableData: Record<string, string | number> = {
+				Execution: tui.bold(result.executionId),
+				Sandbox: result.sandboxId,
+				Status: statusColor(result.status),
+			};
+
 			if (result.exitCode !== undefined) {
 				const exitCodeColor = result.exitCode === 0 ? tui.colorSuccess : tui.colorError;
-				console.log(
-					`${tui.muted('Exit Code:')}       ${exitCodeColor(String(result.exitCode))}`
-				);
+				tableData['Exit Code'] = exitCodeColor(String(result.exitCode));
 			}
 			if (result.durationMs !== undefined) {
-				console.log(`${tui.muted('Duration:')}        ${result.durationMs}ms`);
+				tableData['Duration'] = `${result.durationMs}ms`;
 			}
 			if (result.startedAt) {
-				console.log(`${tui.muted('Started:')}         ${result.startedAt}`);
+				tableData['Started'] = result.startedAt;
 			}
 			if (result.completedAt) {
-				console.log(`${tui.muted('Completed:')}       ${result.completedAt}`);
+				tableData['Completed'] = result.completedAt;
 			}
 			if (result.error) {
-				console.log(`${tui.muted('Error:')}           ${tui.colorError(result.error)}`);
+				tableData['Error'] = tui.colorError(result.error);
 			}
 			if (result.stdoutStreamUrl) {
-				console.log(`${tui.muted('Stdout:')}          ${result.stdoutStreamUrl}`);
+				tableData['Stdout'] = result.stdoutStreamUrl;
 			}
 			if (result.stderrStreamUrl) {
-				console.log(`${tui.muted('Stderr:')}          ${result.stderrStreamUrl}`);
+				tableData['Stderr'] = result.stderrStreamUrl;
 			}
 			if (result.command && result.command.length > 0) {
-				console.log(`${tui.muted('Command:')}         ${result.command.join(' ')}`);
+				tableData['Command'] = result.command.join(' ');
 			}
+
+			tui.table([tableData], Object.keys(tableData), { layout: 'vertical', padStart: '  ' });
 		}
 
 		return {