@agentuity/cli 1.0.23 → 1.0.25

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

@@ -147,14 +147,17 @@ export const getSubcommand = createCommand({
 			if (resourceParts.length > 0) {
 				tableData['Resources'] = resourceParts.join(', ');
 			}
-			if (result.metadata && Object.keys(result.metadata).length > 0) {
-				tableData['Metadata'] = JSON.stringify(result.metadata);
-			}
 			if (result.url) {
 				tableData['URL'] = tui.link(result.url);
 			}
 
 			tui.table([tableData], Object.keys(tableData), { layout: 'vertical', padStart: '  ' });
+
+			if (result.metadata && Object.keys(result.metadata).length > 0) {
+				tui.newline();
+				tui.header('Metadata');
+				tui.json(result.metadata);
+			}
 		}
 
 		return {

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

@@ -18,6 +18,8 @@ import { uploadSubcommand } from './upload';
 import { envSubcommand } from './env';
 import { pauseSubcommand } from './pause';
 import { resumeSubcommand } from './resume';
+import { checkpointCommand } from './checkpoint';
+import { statsSubcommand } from './stats';
 import { getCommand } from '../../../command-prefix';
 
 export const command = createCommand({
@@ -59,6 +61,8 @@ export const command = createCommand({
 		envSubcommand,
 		pauseSubcommand,
 		resumeSubcommand,
+		checkpointCommand,
+		statsSubcommand,
 	],
 	requires: { auth: true, org: true },
 });

package/src/cmd/cloud/sandbox/snapshot/build.ts

@@ -358,7 +358,9 @@ export const buildSubcommand = createCommand({
 			description: 'Build using a custom build file',
 		},
 		{
-			command: getCommand('cloud sandbox snapshot build . --env API_KEY=secret --tag production'),
+			command: getCommand(
+				'cloud sandbox snapshot build . --env API_KEY=secret --tag production'
+			),
 			description: 'Build with environment variable substitution and custom tag',
 		},
 		{
@@ -379,7 +381,10 @@ export const buildSubcommand = createCommand({
 				.string()
 				.optional()
 				.describe('Path to build file (defaults to agentuity-snapshot.[json|yaml|yml])'),
-			env: z.array(z.string()).optional().describe('Environment variable substitution (KEY=VALUE)'),
+			env: z
+				.array(z.string())
+				.optional()
+				.describe('Environment variable substitution (KEY=VALUE)'),
 			name: z.string().optional().describe('Snapshot name (overrides build file)'),
 			tag: z.string().optional().describe('Snapshot tag (defaults to "latest")'),
 			description: z.string().optional().describe('Snapshot description (overrides build file)'),
@@ -529,7 +534,9 @@ export const buildSubcommand = createCommand({
 
 		if (opts.tag) {
 			if (opts.tag.length > MAX_SNAPSHOT_TAG_LENGTH) {
-				logger.fatal(`Invalid snapshot tag: must be at most ${MAX_SNAPSHOT_TAG_LENGTH} characters`);
+				logger.fatal(
+					`Invalid snapshot tag: must be at most ${MAX_SNAPSHOT_TAG_LENGTH} characters`
+				);
 			}
 			if (!SNAPSHOT_TAG_REGEX.test(opts.tag)) {
 				logger.fatal(
@@ -576,7 +583,12 @@ export const buildSubcommand = createCommand({
 				message: 'Validating apt dependencies...',
 				type: 'simple',
 				callback: async () => {
-					return await validateAptDependencies(buildConfig.dependencies!, region, config, logger);
+					return await validateAptDependencies(
+						buildConfig.dependencies!,
+						region,
+						config,
+						logger
+					);
 				},
 			});
 
@@ -676,7 +688,7 @@ export const buildSubcommand = createCommand({
 
 				if (buildConfig.dependencies && buildConfig.dependencies.length > 0) {
 					console.log('');
-					tui.info('Dependencies:');
+					tui.header('Dependencies');
 					for (const dep of buildConfig.dependencies) {
 						console.log(`  ${tui.muted('•')} ${dep}`);
 					}
@@ -684,7 +696,7 @@ export const buildSubcommand = createCommand({
 
 				if (buildConfig.packages && buildConfig.packages.length > 0) {
 					console.log('');
-					tui.info('Packages (npm/bun):');
+					tui.header('Packages (npm/bun)');
 					for (const pkg of buildConfig.packages) {
 						console.log(`  ${tui.muted('•')} ${pkg}`);
 					}
@@ -692,7 +704,7 @@ export const buildSubcommand = createCommand({
 
 				if (finalEnv && Object.keys(finalEnv).length > 0) {
 					console.log('');
-					tui.info('Environment:');
+					tui.header('Environment');
 					for (const [envKey, envValue] of Object.entries(finalEnv)) {
 						console.log(`  ${tui.muted('•')} ${envKey}=${tui.maskSecret(envValue)}`);
 					}
@@ -700,7 +712,7 @@ export const buildSubcommand = createCommand({
 
 				if (fileList.length > 0) {
 					console.log('');
-					tui.info('Files:');
+					tui.header('Files');
 					printFileTree(fileList);
 				}
 			}
@@ -890,7 +902,11 @@ export const buildSubcommand = createCommand({
 						clearOnError: true,
 						callback: async (updateProgress) => {
 							const uploadFile = Bun.file(uploadPath);
-							const progressStream = createProgressStream(uploadFile, uploadSize, updateProgress);
+							const progressStream = createProgressStream(
+								uploadFile,
+								uploadSize,
+								updateProgress
+							);
 							await snapshotUpload(client, {
 								snapshotId: initResult.snapshotId!,
 								body: progressStream,
@@ -933,7 +949,10 @@ export const buildSubcommand = createCommand({
 							'Malware Detected',
 							`Your snapshot was rejected because it contains malware.\n\nVirus: ${virusName}\n\nPlease remove the infected files and try again.`
 						);
-						tui.fatal('Snapshot build failed due to malware detection', ErrorCode.MALWARE_DETECTED);
+						tui.fatal(
+							'Snapshot build failed due to malware detection',
+							ErrorCode.MALWARE_DETECTED
+						);
 					}
 
 					throw err;
@@ -980,7 +999,7 @@ export const buildSubcommand = createCommand({
 
 				if (buildConfig.dependencies && buildConfig.dependencies.length > 0) {
 					console.log('');
-					tui.info('Dependencies:');
+					tui.header('Dependencies');
 					for (const dep of buildConfig.dependencies) {
 						console.log(`  ${tui.muted('•')} ${dep}`);
 					}
@@ -988,7 +1007,7 @@ export const buildSubcommand = createCommand({
 
 				if (buildConfig.packages && buildConfig.packages.length > 0) {
 					console.log('');
-					tui.info('Packages (npm/bun):');
+					tui.header('Packages (npm/bun)');
 					for (const pkg of buildConfig.packages) {
 						console.log(`  ${tui.muted('•')} ${pkg}`);
 					}
@@ -996,7 +1015,7 @@ export const buildSubcommand = createCommand({
 
 				if (finalEnv && Object.keys(finalEnv).length > 0) {
 					console.log('');
-					tui.info('Environment:');
+					tui.header('Environment');
 					for (const [envKey, envValue] of Object.entries(finalEnv)) {
 						console.log(`  ${tui.muted('•')} ${envKey}=${tui.maskSecret(envValue)}`);
 					}
@@ -1004,7 +1023,7 @@ export const buildSubcommand = createCommand({
 
 				if (finalMetadata && Object.keys(finalMetadata).length > 0) {
 					console.log('');
-					tui.info('Metadata:');
+					tui.header('Metadata');
 					for (const key of Object.keys(finalMetadata)) {
 						console.log(`  ${tui.muted('•')} ${key}=${finalMetadata[key]}`);
 					}
@@ -1012,7 +1031,7 @@ export const buildSubcommand = createCommand({
 
 				if (snapshot.files && snapshot.files.length > 0) {
 					console.log('');
-					tui.info('Files:');
+					tui.header('Files');
 					printFileTree(snapshot.files);
 				}
 			}

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

@@ -138,7 +138,7 @@ export const getSubcommand = createCommand({
 				Object.keys(snapshot.userMetadata).length > 0
 			) {
 				console.log('');
-				tui.info('Metadata:');
+				tui.header('Metadata');
 				for (const [key, value] of Object.entries(snapshot.userMetadata)) {
 					console.log(`  ${tui.muted('•')} ${key}=${value}`);
 				}
@@ -146,13 +146,13 @@ export const getSubcommand = createCommand({
 
 			if (snapshot.files && snapshot.files.length > 0) {
 				console.log('');
-				tui.info('Files:');
+				tui.header('Files');
 				printFileTree(snapshot.files);
 			}
 
 			if (activeSandboxes.length > 0) {
 				console.log('');
-				tui.info(`Attached Sandboxes (${activeSandboxes.length}):`);
+				tui.header(`Attached Sandboxes (${activeSandboxes.length}):`);
 				printSandboxTree(activeSandboxes);
 			}
 		}

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

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getGlobalCatalystAPIClient } from '../../../config';
+import { getCommand } from '../../../command-prefix';
+import { getServiceStats, type ServiceStatsData } from '@agentuity/server';
+
+function formatNumber(n: number): string {
+	if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+	if (n >= 1_000) return `${(n / 1_000).toFixed(1)}K`;
+	return String(n);
+}
+
+function formatLatency(ms: number): string {
+	if (ms >= 1000) return `${(ms / 1000).toFixed(1)}s`;
+	return `${Math.round(ms)}ms`;
+}
+
+function displayStats(data: ServiceStatsData): void {
+	const svc = data.services.sandbox;
+	if (!svc) {
+		tui.info('No sandbox data found.');
+		return;
+	}
+	tui.header('Sandbox Statistics');
+	tui.newline();
+	console.log(
+		`  ${tui.muted('Active:')}          ${formatNumber(svc.totalActive)} (${svc.running} running, ${svc.idle} idle, ${svc.creating} creating)`
+	);
+	console.log(`  ${tui.muted('Executions:')}      ${formatNumber(svc.totalExecutions)}`);
+	console.log(`  ${tui.muted('CPU Time:')}        ${formatLatency(svc.totalCpuTimeMs)}`);
+	console.log(`  ${tui.muted('Memory:')}          ${tui.formatBytes(svc.totalMemoryByteSec)}`);
+	console.log(
+		`  ${tui.muted('Network Out:')}     ${tui.formatBytes(svc.totalNetworkEgressBytes)}`
+	);
+}
+
+export const statsSubcommand = createCommand({
+	name: 'stats',
+	description: 'View sandbox statistics',
+	tags: ['read-only', 'requires-auth'],
+	requires: { auth: true, org: true },
+	examples: [
+		{
+			command: getCommand('cloud sandbox stats'),
+			description: 'View sandbox statistics',
+		},
+	],
+	schema: {
+		options: z.object({
+			start: z.string().optional().describe('Start time (ISO 8601)'),
+			end: z.string().optional().describe('End time (ISO 8601)'),
+		}),
+	},
+	idempotent: true,
+
+	async handler(ctx) {
+		const { opts, options } = ctx;
+		const client = await getGlobalCatalystAPIClient(ctx.logger, ctx.auth, ctx.config?.name);
+		const orgId = ctx.orgId ?? ctx.options.orgId ?? ctx.config?.preferences?.orgId;
+
+		if (!orgId) {
+			ctx.logger.fatal('Organization ID is required. Use --org-id or set a preferred org.');
+			return;
+		}
+
+		const data = await getServiceStats(client, orgId, {
+			service: 'sandbox',
+			start: opts.start,
+			end: opts.end,
+			orgIdHeader: orgId,
+		});
+
+		if (!options.json) {
+			displayStats(data);
+		}
+
+		return data;
+	},
+});
+
+export default statsSubcommand;

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

@@ -32,8 +32,7 @@ export const createSubcommand = createCommand({
 	name: 'create',
 	description: 'Create a schedule',
 	tags: ['mutating', 'creates-resource', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	examples: [
 		{
 			command: getCommand("cloud schedule create --name nightly --expression '0 0 * * *'"),
@@ -51,7 +50,7 @@ export const createSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { opts, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 		const result = await schedule.create({
 			name: opts.name,
 			expression: opts.expression,
@@ -66,7 +65,7 @@ export const createSubcommand = createCommand({
 						Name: result.schedule.name,
 						ID: result.schedule.id,
 						Expression: result.schedule.expression,
-						Description: result.schedule.description ?? '-',
+						Description: result.schedule.description || '-',
 						'Next Due': result.schedule.due_date,
 						Created: new Date(result.schedule.created_at).toLocaleString(),
 					},

package/src/cmd/cloud/schedule/delete.ts

@@ -14,11 +14,13 @@ export const deleteSubcommand = createCommand({
 	aliases: ['rm'],
 	description: 'Delete a schedule',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	idempotent: true,
 	examples: [
-		{ command: getCommand('cloud schedule delete sched_abc123'), description: 'Delete a schedule' },
+		{
+			command: getCommand('cloud schedule delete sched_abc123'),
+			description: 'Delete a schedule',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -29,7 +31,7 @@ export const deleteSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 		await schedule.delete(args.schedule_id);
 
 		if (!options.json) {

package/src/cmd/cloud/schedule/delivery/get.ts

@@ -21,8 +21,7 @@ export const getSubcommand = createCommand({
 	name: 'get',
 	description: 'Get delivery details',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	idempotent: true,
 	examples: [
 		{
@@ -52,7 +51,7 @@ export const getSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, opts, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 		const delivery = await schedule.getDelivery(args.schedule_id, args.delivery_id, {
 			limit: opts.limit,
 			offset: opts.offset,
@@ -73,7 +72,7 @@ export const getSubcommand = createCommand({
 
 			if (delivery.response) {
 				tui.newline();
-				tui.info('Response');
+				tui.header('Response');
 				tui.json(delivery.response);
 			}
 		}

package/src/cmd/cloud/schedule/delivery/list.ts

@@ -24,8 +24,7 @@ export const listSubcommand = createCommand({
 	aliases: ['ls'],
 	description: 'List deliveries for a schedule',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	idempotent: true,
 	examples: [
 		{
@@ -46,7 +45,7 @@ export const listSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, opts, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 		const result = await schedule.listDeliveries(args.schedule_id, {
 			limit: opts.limit,
 			offset: opts.offset,
@@ -57,19 +56,21 @@ export const listSubcommand = createCommand({
 				tui.info('No deliveries found');
 			} else {
 				tui.table(
-					result.deliveries.map((delivery: {
-						id: string;
-						date: string;
-						status: 'pending' | 'success' | 'failed';
-						retries: number;
-						schedule_destination_id: string;
-					}) => ({
-						ID: delivery.id,
-						Date: new Date(delivery.date).toLocaleString(),
-						Status: delivery.status,
-						Retries: delivery.retries,
-						'Destination ID': delivery.schedule_destination_id,
-					})),
+					result.deliveries.map(
+						(delivery: {
+							id: string;
+							date: string;
+							status: 'pending' | 'success' | 'failed';
+							retries: number;
+							schedule_destination_id: string;
+						}) => ({
+							ID: delivery.id,
+							Date: new Date(delivery.date).toLocaleString(),
+							Status: delivery.status,
+							Retries: delivery.retries,
+							'Destination ID': delivery.schedule_destination_id,
+						})
+					),
 					['ID', 'Date', 'Status', 'Retries', 'Destination ID']
 				);
 			}

package/src/cmd/cloud/schedule/destination/create.ts

@@ -20,15 +20,18 @@ export const createSubcommand = createCommand({
 	name: 'create',
 	description: 'Create destination for a schedule',
 	tags: ['mutating', 'creates-resource', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	examples: [
 		{
-			command: getCommand('cloud schedule destination create url sched_abc123 https://example.com'),
+			command: getCommand(
+				'cloud schedule destination create url sched_abc123 https://example.com'
+			),
 			description: 'Create URL destination',
 		},
 		{
-			command: getCommand('cloud schedule destination create url sched_abc123 https://example.com --method POST'),
+			command: getCommand(
+				'cloud schedule destination create url sched_abc123 https://example.com --method POST'
+			),
 			description: 'Create URL destination with POST method',
 		},
 	],
@@ -48,12 +51,16 @@ export const createSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, opts, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 
 		if (args.type === 'sandbox' && !args.target.startsWith('sbx_')) {
 			tui.fatal('Sandbox target must start with "sbx_"');
 		}
-		if (args.type === 'url' && !args.target.startsWith('http://') && !args.target.startsWith('https://')) {
+		if (
+			args.type === 'url' &&
+			!args.target.startsWith('http://') &&
+			!args.target.startsWith('https://')
+		) {
 			tui.fatal('URL target must start with http:// or https://');
 		}
 
@@ -95,12 +102,17 @@ export const createSubcommand = createCommand({
 					{
 						ID: result.destination.id,
 						Type: result.destination.type,
-						Config: JSON.stringify(result.destination.config),
 					},
 				],
 				undefined,
 				{ layout: 'vertical' }
 			);
+
+			if (result.destination.config && Object.keys(result.destination.config).length > 0) {
+				tui.newline();
+				tui.header('Config');
+				tui.json(result.destination.config);
+			}
 		}
 
 		return result;

package/src/cmd/cloud/schedule/destination/delete.ts

@@ -14,8 +14,7 @@ export const deleteSubcommand = createCommand({
 	aliases: ['rm'],
 	description: 'Delete a destination',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	idempotent: true,
 	examples: [
 		{
@@ -32,7 +31,7 @@ export const deleteSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 		await schedule.deleteDestination(args.destination_id);
 
 		if (!options.json) {

package/src/cmd/cloud/schedule/destination/get.ts

@@ -20,8 +20,7 @@ export const getSubcommand = createCommand({
 	name: 'get',
 	description: 'Get destination details',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	idempotent: true,
 	examples: [
 		{
@@ -39,24 +38,25 @@ export const getSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 		const destination = await schedule.getDestination(args.schedule_id, args.destination_id);
 
 		if (!options.json) {
-			tui.table(
-				[
-					{
-						ID: destination.id,
-						'Schedule ID': destination.schedule_id,
-						Type: destination.type,
-						Config: JSON.stringify(destination.config),
-						Created: new Date(destination.created_at).toLocaleString(),
-						Updated: new Date(destination.updated_at).toLocaleString(),
-					},
-				],
-				undefined,
-				{ layout: 'vertical' }
-			);
+			const details: Record<string, unknown> = {
+				ID: destination.id,
+				'Schedule ID': destination.schedule_id,
+				Type: destination.type,
+				Created: new Date(destination.created_at).toLocaleString(),
+				Updated: new Date(destination.updated_at).toLocaleString(),
+			};
+
+			tui.table([details], undefined, { layout: 'vertical' });
+
+			if (destination.config && Object.keys(destination.config).length > 0) {
+				tui.newline();
+				tui.header('Config');
+				tui.json(destination.config);
+			}
 		}
 
 		return { destination };

package/src/cmd/cloud/schedule/destination/index.ts

@@ -18,7 +18,9 @@ export const command = createCommand({
 			description: 'List destinations',
 		},
 		{
-			command: getCommand('cloud schedule destination create url sched_abc123 https://example.com'),
+			command: getCommand(
+				'cloud schedule destination create url sched_abc123 https://example.com'
+			),
 			description: 'Create URL destination',
 		},
 	],

package/src/cmd/cloud/schedule/destination/list.ts

@@ -23,8 +23,7 @@ export const listSubcommand = createCommand({
 	aliases: ['ls'],
 	description: 'List destinations for a schedule',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, region: true },
-	optional: { project: true },
+	requires: { auth: true },
 	idempotent: true,
 	examples: [
 		{
@@ -41,7 +40,7 @@ export const listSubcommand = createCommand({
 
 	async handler(ctx) {
 		const { args, options } = ctx;
-		const schedule = createScheduleAdapter(ctx);
+		const schedule = await createScheduleAdapter(ctx);
 		const result = await schedule.get(args.schedule_id);
 
 		if (!options.json) {
@@ -49,18 +48,26 @@ export const listSubcommand = createCommand({
 				tui.info('No destinations configured');
 			} else {
 				tui.table(
-					result.destinations.map((destination: {
-						id: string;
-						type: 'url' | 'sandbox';
-						config: Record<string, unknown>;
-						created_at: string;
-					}) => ({
-						ID: destination.id,
-						Type: destination.type,
-						Config: JSON.stringify(destination.config),
-						Created: new Date(destination.created_at).toLocaleString(),
-					})),
-					['ID', 'Type', 'Config', 'Created']
+					result.destinations.map(
+						(destination: {
+							id: string;
+							type: 'url' | 'sandbox';
+							config: Record<string, unknown>;
+							created_at: string;
+						}) => {
+							const configDisplay =
+								destination.type === 'url' && destination.config?.url
+									? String(destination.config.url)
+									: JSON.stringify(destination.config);
+							return {
+								ID: destination.id,
+								Type: destination.type,
+								URL: configDisplay,
+								Created: new Date(destination.created_at).toLocaleString(),
+							};
+						}
+					),
+					['ID', 'Type', 'URL', 'Created']
 				);
 			}
 		}