@agentuity/cli 1.0.10 → 1.0.11

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

@@ -46,6 +46,14 @@ export const listSubcommand = createSubcommand({
 					'Show credentials in plain text (default: masked in terminal, unmasked in JSON)'
 				),
 			nameOnly: z.boolean().optional().describe('Print the name only'),
+			sort: z
+				.enum(['name', 'created'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: DBListResponseSchema,
 	},
@@ -60,7 +68,12 @@ export const listSubcommand = createSubcommand({
 			message: 'Fetching databases',
 			clearOnSuccess: true,
 			callback: async () => {
-				return listOrgResources(catalystClient, { type: 'db', orgId: opts?.orgId });
+				return listOrgResources(catalystClient, {
+					type: 'db',
+					orgId: opts?.orgId,
+					sort: opts?.sort,
+					direction: opts?.direction,
+				});
 			},
 		});
 

package/src/cmd/cloud/deploy.ts

@@ -22,6 +22,7 @@ import {
 	stepSkipped,
 	stepError,
 	pauseStepUI,
+	StepInterruptError,
 	type Step,
 	type StepContext,
 } from '../../steps';
@@ -428,6 +429,13 @@ export const deploySubcommand = createSubcommand({
 			}
 		}
 
+		// Create a unified abort controller for the entire deploy flow
+		const deployAbortController = new AbortController();
+		const deployAbortHandler = () => {
+			deployAbortController.abort();
+		};
+		process.on('SIGINT', deployAbortHandler);
+
 		// Start malware check async (runs in parallel with build)
 		if (deployment) {
 			malwareCheckPromise = (async () => {
@@ -444,7 +452,8 @@ export const deploySubcommand = createSubcommand({
 					const result = await projectDeploymentMalwareCheck(
 						catalystClient,
 						deployment!.id,
-						packages
+						packages,
+						deployAbortController.signal
 					);
 					logger.debug(
 						'Malware check complete: action=%s, flagged=%d',
@@ -599,7 +608,7 @@ export const deploySubcommand = createSubcommand({
 
 					{
 						label: 'Build, Verify and Package',
-						run: async () => {
+						run: async (stepCtx: StepContext) => {
 							if (!deployment) {
 								return stepError('deployment was null');
 							}
@@ -636,6 +645,7 @@ export const deploySubcommand = createSubcommand({
 									region: project.region,
 									logger: ctx.logger,
 									deploymentOptions: opts,
+									deploymentConfig: project.deployment,
 									collector,
 								});
 								capturedOutput = [...capturedOutput, ...bundleResult.output];
@@ -643,7 +653,8 @@ export const deploySubcommand = createSubcommand({
 								instructions = await projectDeploymentUpdate(
 									apiClient,
 									deployment.id,
-									build
+									build,
+									stepCtx.signal
 								);
 								return stepSuccess(capturedOutput.length > 0 ? capturedOutput : undefined);
 							} catch (ex) {
@@ -789,6 +800,7 @@ export const deploySubcommand = createSubcommand({
 										'Content-Type': 'application/zip',
 									},
 									body: zipfile,
+									signal: stepCtx.signal,
 								});
 								ctx.logger.trace(`Upload response: ${resp.status}`);
 								if (!resp.ok) {
@@ -876,6 +888,7 @@ export const deploySubcommand = createSubcommand({
 												duplex: 'half',
 												headers,
 												body,
+												signal: stepCtx.signal,
 											})
 										);
 									}
@@ -910,11 +923,15 @@ export const deploySubcommand = createSubcommand({
 					},
 					{
 						label: 'Provision Deployment',
-						run: async () => {
+						run: async (stepCtx: StepContext) => {
 							if (!deployment) {
 								return stepError('deployment was null');
 							}
-							complete = await projectDeploymentComplete(apiClient, deployment.id);
+							complete = await projectDeploymentComplete(
+								apiClient,
+								deployment.id,
+								stepCtx.signal
+							);
 							return stepSuccess();
 						},
 					},
@@ -945,12 +962,7 @@ export const deploySubcommand = createSubcommand({
 			const maxAttempts = 600;
 			let attempts = 0;
 
-			// Create abort controller to allow Ctrl+C to interrupt polling
-			const pollAbortController = new AbortController();
-			const sigintHandler = () => {
-				pollAbortController.abort();
-			};
-			process.on('SIGINT', sigintHandler);
+			// Reuse the deploy abort controller for polling (already aborted on Ctrl+C)
 
 			try {
 				if (streamId) {
@@ -1014,7 +1026,7 @@ export const deploySubcommand = createSubcommand({
 								// Poll for deployment status
 								while (attempts < maxAttempts) {
 									// Check if user pressed Ctrl+C
-									if (pollAbortController.signal.aborted) {
+									if (deployAbortController.signal.aborted) {
 										logStreamController.abort();
 										throw new DeploymentCancelledError();
 									}
@@ -1023,7 +1035,8 @@ export const deploySubcommand = createSubcommand({
 									try {
 										statusResult = await projectDeploymentStatus(
 											apiClient,
-											deployment?.id ?? ''
+											deployment?.id ?? '',
+											deployAbortController.signal
 										);
 
 										logger.trace('status result: %s', statusResult);
@@ -1115,14 +1128,15 @@ export const deploySubcommand = createSubcommand({
 						callback: async () => {
 							while (attempts < maxAttempts) {
 								// Check if user pressed Ctrl+C
-								if (pollAbortController.signal.aborted) {
+								if (deployAbortController.signal.aborted) {
 									throw new DeploymentCancelledError();
 								}
 
 								attempts++;
 								statusResult = await projectDeploymentStatus(
 									apiClient,
-									deployment?.id ?? ''
+									deployment?.id ?? '',
+									deployAbortController.signal
 								);
 
 								if (statusResult.state === 'completed') {
@@ -1172,7 +1186,7 @@ export const deploySubcommand = createSubcommand({
 				tui.fatal('Deployment failed', ErrorCode.BUILD_FAILED);
 			} finally {
 				// Clean up signal handler
-				process.off('SIGINT', sigintHandler);
+				process.off('SIGINT', deployAbortHandler);
 			}
 
 			// Show deployment URLs
@@ -1185,15 +1199,18 @@ export const deploySubcommand = createSubcommand({
 						);
 					}
 				} else {
+					// Prefer vanity URLs, fall back to hash-based
+					const deploymentUrl =
+						complete.publicUrls.vanityDeployment ?? complete.publicUrls.deployment;
+					const latestUrl = complete.publicUrls.vanityProject ?? complete.publicUrls.latest;
 					lines.push(
 						`${tui.ICONS.arrow} ${
-							tui.bold(tui.padRight('Deployment:', 12)) +
-							tui.link(complete.publicUrls.deployment)
+							tui.bold(tui.padRight('Deployment:', 12)) + tui.link(deploymentUrl)
 						}`
 					);
 					lines.push(
 						`${tui.ICONS.arrow} ${
-							tui.bold(tui.padRight('Project:', 12)) + tui.link(complete.publicUrls.latest)
+							tui.bold(tui.padRight('Project:', 12)) + tui.link(latestUrl)
 						}`
 					);
 				}
@@ -1222,20 +1239,28 @@ export const deploySubcommand = createSubcommand({
 				logs,
 				urls: complete?.publicUrls
 					? {
-							deployment: complete.publicUrls.deployment,
-							latest: complete.publicUrls.latest,
+							deployment:
+								complete.publicUrls.vanityDeployment ?? complete.publicUrls.deployment,
+							latest: complete.publicUrls.vanityProject ?? complete.publicUrls.latest,
 							custom: complete.publicUrls.custom,
 							dashboard,
 						}
 					: undefined,
 			};
 		} catch (ex) {
+			// Handle step interruption (Ctrl+C during build steps)
+			if (ex instanceof StepInterruptError) {
+				tui.warning('Deployment cancelled');
+				process.exit(ex.exitCode);
+			}
 			collector.addGeneralError('deploy', String(ex), 'DEPLOY004');
 			if (opts.reportFile) {
 				await collector.forceWrite();
 			}
 			clearGlobalCollector();
 			tui.fatal(`unexpected error trying to deploy project. ${ex}`);
+		} finally {
+			process.off('SIGINT', deployAbortHandler);
 		}
 	},
 });

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

@@ -34,6 +34,14 @@ export const listSubcommand = createCommand({
 			orgId: z.string().optional().describe('filter by organization id'),
 			limit: z.coerce.number().optional().describe('Maximum number of queues to return'),
 			offset: z.coerce.number().optional().describe('Offset for pagination'),
+			sort: z
+				.enum(['name', 'created', 'updated'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: QueueListResponseSchema,
 	},
@@ -48,6 +56,8 @@ export const listSubcommand = createCommand({
 			{
 				limit: opts.limit,
 				offset: opts.offset,
+				sort: opts.sort,
+				direction: opts.direction,
 			},
 			queueOptions
 		);

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

@@ -75,6 +75,14 @@ export const listSubcommand = createCommand({
 			all: z.boolean().optional().describe('List all sandboxes regardless of project context'),
 			limit: z.number().optional().describe('Maximum number of results (default: 50, max: 100)'),
 			offset: z.number().optional().describe('Pagination offset'),
+			sort: z
+				.enum(['name', 'created', 'updated', 'status'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: SandboxListResponseSchema,
 	},
@@ -94,6 +102,8 @@ export const listSubcommand = createCommand({
 			status: opts.status,
 			limit: opts.limit,
 			offset: opts.offset,
+			sort: opts.sort,
+			direction: opts.direction,
 		});
 
 		// Check if results span multiple orgs

package/src/cmd/cloud/sandbox/runtime/list.ts

@@ -34,6 +34,14 @@ export const listSubcommand = createCommand({
 			limit: z.number().optional().describe('Maximum number of results'),
 			offset: z.number().optional().describe('Offset for pagination'),
 			orgId: z.string().optional().describe('filter by organization id'),
+			sort: z
+				.enum(['name', 'created'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: RuntimeListResponseSchema,
 	},
@@ -47,6 +55,8 @@ export const listSubcommand = createCommand({
 			orgId: effectiveOrgId,
 			limit: opts.limit,
 			offset: opts.offset,
+			sort: opts.sort,
+			direction: opts.direction,
 		});
 
 		if (!options.json) {

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

@@ -47,6 +47,14 @@ export const listSubcommand = createCommand({
 			limit: z.number().optional().describe('Maximum number of results'),
 			offset: z.number().optional().describe('Offset for pagination'),
 			orgId: z.string().optional().describe('filter by organization id'),
+			sort: z
+				.enum(['name', 'created', 'size'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: SnapshotListResponseSchema,
 	},
@@ -61,6 +69,8 @@ export const listSubcommand = createCommand({
 			limit: opts.limit,
 			offset: opts.offset,
 			orgId: effectiveOrgId,
+			sort: opts.sort,
+			direction: opts.direction,
 		});
 
 		if (!options.json) {

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

@@ -46,10 +46,10 @@ const SessionGetResponseSchema = z.object({
 	pending: z.boolean().describe('Pending'),
 	success: z.boolean().describe('Success'),
 	error: z.string().nullable().describe('Error message'),
-	method: z.string().describe('HTTP method'),
-	url: z.string().describe('Request URL'),
-	route_id: z.string().describe('Route ID'),
-	thread_id: z.string().describe('Thread ID'),
+	method: z.string().nullable().describe('HTTP method'),
+	url: z.string().nullable().describe('Request URL'),
+	route_id: z.string().nullable().describe('Route ID'),
+	thread_id: z.string().nullable().describe('Thread ID'),
 	agents: z
 		.array(
 			z.object({
@@ -148,10 +148,10 @@ export const getSubcommand = createSubcommand({
 				pending: session.pending,
 				success: session.success,
 				error: session.error,
-				method: session.method,
-				url: session.url,
-				route_id: session.route_id,
-				thread_id: session.thread_id,
+				method: session.method ?? null,
+				url: session.url ?? null,
+				route_id: session.route_id ?? null,
+				thread_id: session.thread_id ?? null,
 				agents: enriched.agents,
 				eval_runs: enriched.evalRuns.map((run: EvalRun) => ({
 					id: run.id,
@@ -183,8 +183,8 @@ export const getSubcommand = createSubcommand({
 			if (session.duration != null && session.end_time != null) {
 				tableData['Duration'] = `${(session.duration / 1_000_000).toFixed(0)}ms`;
 			}
-			tableData['Method'] = session.method;
-			tableData['URL'] = tui.link(session.url, session.url);
+			tableData['Method'] = session.method ?? '-';
+			tableData['URL'] = session.url ? tui.link(session.url, session.url) : '-';
 			tableData['Trigger'] = session.trigger;
 			if (session.env !== 'production') {
 				tableData['Environment'] = session.env;
@@ -204,9 +204,9 @@ export const getSubcommand = createSubcommand({
 				tableData['Route'] =
 					`${enriched.route.method.toUpperCase()} ${enriched.route.path} ${tui.muted(`(${enriched.route.id})`)}`;
 			} else {
-				tableData['Route ID'] = session.route_id;
+				tableData['Route ID'] = session.route_id ?? '-';
 			}
-			tableData['Thread ID'] = session.thread_id;
+			tableData['Thread ID'] = session.thread_id ?? '-';
 
 			tui.table([tableData], Object.keys(tableData), { layout: 'vertical', padStart: '  ' });
 

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

@@ -12,8 +12,8 @@ const SessionListResponseSchema = z.array(
 		created_at: z.string().describe('Creation timestamp'),
 		success: z.boolean().describe('Whether the session succeeded'),
 		duration: z.number().nullable().describe('Duration in nanoseconds'),
-		method: z.string().describe('HTTP method'),
-		url: z.string().describe('Request URL'),
+		method: z.string().nullable().describe('HTTP method'),
+		url: z.string().nullable().describe('Request URL'),
 		trigger: z.string().describe('Trigger type'),
 		env: z.string().describe('Environment'),
 	})
@@ -91,6 +91,14 @@ export const listSubcommand = createSubcommand({
 			success: z.coerce.boolean().optional().describe('Filter by success status (true/false)'),
 			startAfter: z.string().optional().describe('Filter by start time after (ISO 8601)'),
 			startBefore: z.string().optional().describe('Filter by start time before (ISO 8601)'),
+			sort: z
+				.enum(['created', 'updated', 'duration', 'startTime'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: SessionListResponseSchema,
 	},
@@ -109,20 +117,22 @@ export const listSubcommand = createSubcommand({
 		const projectId = opts.all || opts.orgId ? undefined : opts.projectId || project?.projectId;
 
 		try {
-			const sessions = await sessionList(catalystClient, {
-				count: opts.count,
-				orgId: opts?.orgId,
-				projectId,
-				deploymentId: opts.deploymentId,
-				trigger: opts.trigger,
-				env: opts.env,
-				devmode: opts.devmode,
-				success: opts.success,
-				threadId: opts.threadId,
-				agentIdentifier: opts.agentIdentifier,
-				startAfter: opts.startAfter,
-				startBefore: opts.startBefore,
-			});
+		const sessions = await sessionList(catalystClient, {
+			count: opts.count,
+			orgId: opts?.orgId,
+			projectId,
+			deploymentId: opts.deploymentId,
+			trigger: opts.trigger,
+			env: opts.env,
+			devmode: opts.devmode,
+			success: opts.success,
+			threadId: opts.threadId,
+			agentIdentifier: opts.agentIdentifier,
+			startAfter: opts.startAfter,
+			startBefore: opts.startBefore,
+			sort: opts.sort,
+			direction: opts.direction,
+		});
 
 			const result = sessions.map((s) => ({
 				id: s.id,
@@ -146,13 +156,13 @@ export const listSubcommand = createSubcommand({
 			}
 
 			const tableData = sessions.map((s) => {
-				const urlPath = new URL(s.url).pathname;
+				const urlPath = s.url ? new URL(s.url).pathname : '-';
 				return {
 					ID: s.id,
 					Created: new Date(s.created_at).toLocaleString(),
 					Success: s.success ? '✓' : '✗',
 					Duration: s.duration ? `${(s.duration / 1_000_000).toFixed(0)}ms` : '-',
-					Method: s.method,
+					Method: s.method ?? '-',
 					Path: urlPath.length > 50 ? urlPath.substring(0, 47) + '...' : urlPath,
 					Trigger: s.trigger,
 					Env: s.env,

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

@@ -77,6 +77,14 @@ export const listSubcommand = createSubcommand({
 					'Show credentials in plain text (default: masked in terminal, unmasked in JSON)'
 				),
 			nameOnly: z.boolean().optional().describe('Print the name only'),
+			sort: z
+				.enum(['name', 'created'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: StorageListResponseSchema,
 	},
@@ -95,7 +103,12 @@ export const listSubcommand = createSubcommand({
 			message: 'Fetching storage',
 			clearOnSuccess: true,
 			callback: async () => {
-				return listOrgResources(catalystClient, { type: 's3', orgId: opts?.orgId });
+				return listOrgResources(catalystClient, {
+					type: 's3',
+					orgId: opts?.orgId,
+					sort: opts?.sort,
+					direction: opts?.direction,
+				});
 			},
 		});
 

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

@@ -67,6 +67,14 @@ export const listSubcommand = createCommand({
 				.describe('filter by metadata (format: key=value or key1=value1,key2=value2)'),
 			projectId: z.string().optional().describe('filter by project ID'),
 			orgId: z.string().optional().describe('filter by organization ID'),
+			sort: z
+				.enum(['name', 'created', 'updated', 'size'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: ListStreamsResponseSchema,
 	},
@@ -120,14 +128,16 @@ export const listSubcommand = createCommand({
 		}
 
 		try {
-			const result = await streamList(apiClient, {
-				limit: opts.size,
-				offset: opts.offset,
-				namespace: opts.namespace,
-				metadata: metadataFilter,
-				projectId,
-				orgId: opts.orgId,
-			});
+		const result = await streamList(apiClient, {
+			limit: opts.size,
+			offset: opts.offset,
+			namespace: opts.namespace,
+			metadata: metadataFilter,
+			projectId,
+			orgId: opts.orgId,
+			sort: opts.sort,
+			direction: opts.direction,
+		});
 
 			if (options.json) {
 				console.log(JSON.stringify(result, null, 2));

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

@@ -63,6 +63,14 @@ export const listSubcommand = createSubcommand({
 			orgId: z.string().optional().describe('Filter by organization ID'),
 			projectId: z.string().optional().describe('Filter by project ID'),
 			all: z.boolean().optional().describe('List all threads regardless of project context'),
+			sort: z
+				.enum(['created', 'updated'])
+				.optional()
+				.describe('field to sort by (default: created)'),
+			direction: z
+				.enum(['asc', 'desc'])
+				.optional()
+				.describe('sort direction (default: desc)'),
 		}),
 		response: ThreadListResponseSchema,
 	},
@@ -78,11 +86,13 @@ export const listSubcommand = createSubcommand({
 		const orgId = opts.orgId;
 
 		try {
-			const threads = await threadList(catalystClient, {
-				count: opts.count,
-				orgId,
-				projectId,
-			});
+		const threads = await threadList(catalystClient, {
+			count: opts.count,
+			orgId,
+			projectId,
+			sort: opts.sort,
+			direction: opts.direction,
+		});
 
 			const result = threads.map((t: Thread) => ({
 				id: t.id,