@agentuity/cli 3.0.0-alpha.7 → 3.0.0-beta.0

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

@@ -1,132 +0,0 @@
-import { listOrgResources } from '@agentuity/server';
-import { z } from 'zod';
-import { getCommand } from '../../../command-prefix';
-import { getGlobalCatalystAPIClient } from '../../../config';
-import * as tui from '../../../tui';
-import { createSubcommand } from '../../../types';
-
-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'),
-				org_id: z.string().optional().describe('Organization ID that owns this database'),
-				org_name: z.string().optional().describe('Organization name that owns this database'),
-			})
-		)
-		.describe('List of database resources'),
-});
-
-export const listSubcommand = createSubcommand({
-	name: 'list',
-	aliases: ['ls'],
-	description: 'List database resources',
-	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true },
-	idempotent: true,
-	examples: [
-		{ command: getCommand('cloud db list'), description: 'List items' },
-		{ command: getCommand('--json cloud db list'), description: 'Show output in JSON format' },
-		{ command: getCommand('cloud db ls'), description: 'List items' },
-		{
-			command: getCommand('cloud db list --show-credentials'),
-			description: 'Use show credentials option',
-		},
-	],
-	schema: {
-		options: z.object({
-			orgId: z.string().optional().describe('filter by organization id'),
-			name: z.string().optional().describe('Filter by database name'),
-			showCredentials: z
-				.boolean()
-				.optional()
-				.describe(
-					'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', 'region'])
-				.default('created')
-				.describe('field to sort by'),
-			direction: z.enum(['asc', 'desc']).default('desc').describe('sort direction'),
-			limit: z.coerce.number().min(0).optional().describe('Maximum number of results to return'),
-			offset: z.coerce.number().min(0).optional().describe('Offset for pagination'),
-		}),
-		response: DBListResponseSchema,
-	},
-	webUrl: '/services/database',
-
-	async handler(ctx) {
-		const { logger, opts, options, auth, config } = ctx;
-
-		const catalystClient = await getGlobalCatalystAPIClient(
-			logger,
-			auth,
-			config?.name,
-			undefined,
-			config
-		);
-
-		const resources = await tui.spinner({
-			message: 'Fetching databases',
-			clearOnSuccess: true,
-			callback: async () => {
-				return listOrgResources(catalystClient, {
-					type: 'db',
-					orgId: opts?.orgId,
-					name: opts?.name,
-					sort: opts?.sort,
-					direction: opts?.direction,
-					limit: opts?.limit,
-					offset: opts?.offset,
-				});
-			},
-		});
-
-		// Mask credentials in terminal output by default, unless --show-credentials is passed
-		const shouldShowCredentials = opts.showCredentials === true;
-		const shouldMask = !options.json && !shouldShowCredentials;
-
-		// Check if resources span multiple orgs
-		const uniqueOrgIds = new Set(resources.db.map((db) => db.org_id));
-		const showOrgColumn = uniqueOrgIds.size > 1;
-
-		if (!options.json) {
-			if (resources.db.length === 0) {
-				tui.info('No databases found');
-			} else if (opts.nameOnly) {
-				for (const db of resources.db) {
-					console.log(db.name);
-				}
-			} else {
-				const tableData = resources.db.map((db) => {
-					const row: Record<string, string> = {
-						Name: db.name,
-					};
-					if (showOrgColumn) {
-						row.Organization = db.org_name || db.org_id;
-					}
-					row.Description = db.description ?? '';
-					row.Region = db.cloud_region;
-					row.URL = db.url ? (shouldMask ? tui.maskSecret(db.url) : db.url) : '';
-					return row;
-				});
-				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,
-				org_id: db.org_id,
-				org_name: db.org_name,
-			})),
-		};
-	},
-});

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

@@ -1,198 +0,0 @@
-import { DbQueryLogSchema, dbLogs, listOrgResources } from '@agentuity/server';
-import { z } from 'zod';
-import { getResourceInfo, setResourceInfo } from '../../../cache';
-import { getCommand } from '../../../command-prefix';
-import { getCatalystAPIClient, getGlobalCatalystAPIClient } from '../../../config';
-import { ErrorCode } from '../../../errors';
-import * as tui from '../../../tui';
-import { createSubcommand } from '../../../types';
-
-const DbLogsResponseSchema = z.array(DbQueryLogSchema);
-
-export const logsSubcommand = createSubcommand({
-	name: 'logs',
-	aliases: ['log'],
-	description: 'Get query logs for a specific database',
-	tags: ['read-only', 'slow', 'requires-auth'],
-	examples: [
-		{
-			command: getCommand('cloud db logs my-database'),
-			description: 'View query logs for database',
-		},
-		{
-			command: getCommand('cloud db logs my-database --limit=50'),
-			description: 'Limit to 50 log entries',
-		},
-		{
-			command: getCommand('cloud db logs my-database --has-error'),
-			description: 'Show only queries with errors',
-		},
-		{
-			command: getCommand('cloud db logs my-database --username=user123'),
-			description: 'Filter by username',
-		},
-		{
-			command: getCommand('cloud db logs my-database --command=SELECT'),
-			description: 'Filter by SQL command type',
-		},
-		{
-			command: getCommand('cloud db logs my-database --session-id=sess_abc123'),
-			description: 'Filter by session ID',
-		},
-		{
-			command: getCommand('cloud db logs my-database --show-session-id'),
-			description: 'Show session ID column',
-		},
-		{
-			command: getCommand('cloud db logs my-database --show-username'),
-			description: 'Show username column',
-		},
-		{
-			command: getCommand('cloud db logs my-database --pretty'),
-			description: 'Show full formatted SQL on separate lines',
-		},
-	],
-	requires: { auth: true },
-	optional: { org: true },
-	idempotent: true,
-	schema: {
-		args: z.object({
-			database: z.string().describe('Database name'),
-		}),
-		options: z.object({
-			startDate: z.string().optional().describe('Start date for filtering logs'),
-			endDate: z.string().optional().describe('End date for filtering logs'),
-			username: z.string().optional().describe('Filter by username'),
-			command: z.string().optional().describe('Filter by SQL command type'),
-			hasError: z.boolean().optional().describe('Show only queries with errors'),
-			sessionId: z.string().optional().describe('Filter by session ID (trace ID)'),
-			showSessionId: z.boolean().default(false).describe('Show session ID column in output'),
-			showUsername: z.boolean().default(false).describe('Show username column in output'),
-			pretty: z.boolean().default(false).describe('Show full formatted SQL on separate line'),
-			limit: z.coerce
-				.number()
-				.int()
-				.min(1)
-				.default(100)
-				.describe('Maximum number of logs to return'),
-			timestamps: z.boolean().default(true).describe('Show timestamps in output'),
-		}),
-		response: DbLogsResponseSchema,
-	},
-	async handler(ctx) {
-		const { args, options, logger, auth, config } = ctx;
-		const showTimestamps = ctx.opts.timestamps ?? true;
-		const showSessionId = ctx.opts.showSessionId ?? false;
-		const showUsername = ctx.opts.showUsername ?? false;
-		const prettySQL = ctx.opts.pretty ?? false;
-
-		const profileName = config?.name ?? 'production';
-
-		try {
-			const globalClient = await getGlobalCatalystAPIClient(
-				logger,
-				auth,
-				profileName,
-				undefined,
-				config
-			);
-
-			// Check cache first for orgId
-			const cachedInfo = await getResourceInfo('db', profileName, args.database);
-			const orgId = ctx.orgId ?? cachedInfo?.orgId;
-
-			if (!orgId) {
-				tui.fatal(
-					`Organization not found for database '${args.database}'. Run 'agentuity cloud db list' first or specify --org-id.`,
-					ErrorCode.INVALID_ARGUMENT
-				);
-			}
-
-			// Look up the database to get its region
-			const resources = await listOrgResources(globalClient, { type: 'db', orgId });
-			const database = resources.db.find((db) => db.name === args.database);
-			if (!database) {
-				tui.fatal(`Database '${args.database}' not found`, ErrorCode.RESOURCE_NOT_FOUND);
-			}
-			const region = database.cloud_region;
-
-			// Cache the database info for future lookups
-			await setResourceInfo('db', profileName, database.name, region, orgId);
-
-			// Use regional client for logs (ClickHouse queries are region-specific)
-			const catalystClient = getCatalystAPIClient(logger, auth, region, undefined, config);
-
-			const logs = await dbLogs(catalystClient, {
-				database: args.database,
-				orgId,
-				region,
-				startDate: ctx.opts.startDate,
-				endDate: ctx.opts.endDate,
-				username: ctx.opts.username,
-				command: ctx.opts.command,
-				hasError: ctx.opts.hasError,
-				sessionId: ctx.opts.sessionId,
-				limit: ctx.opts.limit,
-			});
-
-			if (!options.json) {
-				if (logs.length === 0) {
-					tui.info('No logs found for this database.');
-				} else {
-					for (const log of logs) {
-						// Format timestamp with explicit locale for consistency
-						const timestamp = showTimestamps
-							? `${tui.muted(new Date(log.timestamp).toLocaleString('en-US', { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', second: '2-digit' }).padEnd(22))} `
-							: '';
-
-						// Format command with cyan color (using info color) and consistent width
-						const commandText = log.command.padEnd(8);
-						const command = tui.colorInfo(commandText);
-
-						// Format duration with consistent width
-						const duration = `${log.duration.toFixed(2)}ms`.padStart(9);
-
-						// Format username if requested
-						const username = showUsername
-							? `${tui.muted(`[${log.username}]`.padEnd(14))} `
-							: '';
-
-						// Format session ID if requested (already has sess_ prefix from API)
-						const sessionId = showSessionId
-							? `${tui.muted((log.sessionId || '').padEnd(38))} `
-							: '';
-
-						if (prettySQL) {
-							// Pretty mode: show metadata on first line, full SQL on next line
-							console.log(
-								`${timestamp}${command} ${tui.muted(duration)} ${username}${sessionId}`
-							);
-							// Show full formatted SQL indented on next line with clear color
-							console.log(`  ${log.sql}`);
-						} else {
-							// Normal mode: truncate SQL and show inline
-							const sqlClean = log.sql
-								.replace(/[\n\r\t]+/g, ' ')
-								.replace(/\s+/g, ' ')
-								.trim();
-							const sql =
-								sqlClean.length > 100 ? `${sqlClean.substring(0, 97)}...` : sqlClean;
-							console.log(
-								`${timestamp}${command} ${tui.muted(duration)} ${username}${sessionId}${sql}`
-							);
-						}
-
-						// Show error on separate line underneath if present
-						if (log.error) {
-							console.log(tui.colorError(`  ↳ ERROR: ${log.error}`));
-						}
-					}
-				}
-			}
-
-			return logs;
-		} catch (ex) {
-			tui.fatal(`Failed to get database logs: ${ex}`, ErrorCode.API_ERROR);
-		}
-	},
-});

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

@@ -1,84 +0,0 @@
-import { dbQuery } from '@agentuity/server';
-import { z } from 'zod';
-import { getCommand } from '../../../command-prefix';
-import { getCatalystAPIClient } from '../../../config';
-import * as tui from '../../../tui';
-import { createSubcommand } from '../../../types';
-
-const DBSQLResponseSchema = z.object({
-	rows: z.array(z.record(z.string(), z.unknown())).describe('Query results'),
-	rowCount: z.number().describe('Number of rows returned'),
-	truncated: z.boolean().describe('Whether results were truncated'),
-});
-
-export const sqlSubcommand = createSubcommand({
-	name: 'sql',
-	aliases: ['exec', 'query'],
-	description: 'Execute SQL query on a database',
-	tags: ['slow', 'requires-auth'],
-	requires: { auth: true, org: true, region: true },
-	idempotent: false,
-	examples: [
-		{
-			command: `${getCommand('cloud db sql')} my-database "SELECT * FROM users LIMIT 10"`,
-			description: 'Execute SQL query',
-		},
-		{
-			command: `${getCommand('cloud db exec')} my-database "SELECT COUNT(*) FROM orders" --json`,
-			description: 'Execute query with JSON output',
-		},
-		{
-			command: `${getCommand('cloud db query')} my-database "SELECT * FROM products WHERE price > 100"`,
-			description: 'Query with filter',
-		},
-	],
-	schema: {
-		args: z.object({
-			name: z.string().describe('Database name'),
-			query: z.string().describe('SQL query to execute'),
-		}),
-		options: z.object({}),
-		response: DBSQLResponseSchema,
-	},
-
-	async handler(ctx) {
-		const { logger, args, options, orgId, region, auth } = ctx;
-
-		const catalystClient = getCatalystAPIClient(logger, auth, region, undefined, ctx.config);
-
-		const result = await tui.spinner({
-			message: `Executing query on ${args.name}`,
-			clearOnSuccess: true,
-			callback: async () => {
-				return dbQuery(catalystClient, {
-					database: args.name,
-					query: args.query,
-					orgId,
-					region,
-				});
-			},
-		});
-
-		if (!options.json) {
-			if (result.rowCount === 0) {
-				tui.info('No rows returned');
-			} else {
-				if (process.stdout.isTTY) {
-					tui.newline();
-					tui.success(
-						`Query returned ${result.rowCount} row${result.rowCount !== 1 ? 's' : ''}${result.truncated ? ' (truncated to 1000 rows)' : ''}:`
-					);
-					tui.newline();
-				}
-
-				tui.table(result.rows);
-			}
-		}
-
-		return {
-			rows: result.rows,
-			rowCount: result.rowCount,
-			truncated: result.truncated,
-		};
-	},
-});

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

@@ -1,78 +0,0 @@
-import { getServiceStats, type ServiceStatsData } from '@agentuity/server';
-import { z } from 'zod';
-import { getCommand } from '../../../command-prefix';
-import { getGlobalCatalystAPIClient } from '../../../config';
-import * as tui from '../../../tui';
-import { createCommand } from '../../../types';
-
-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 displayStats(data: ServiceStatsData): void {
-	const svc = data.services.database;
-	if (!svc) {
-		tui.info('No database data found.');
-		return;
-	}
-	tui.header('Database Statistics');
-	tui.newline();
-	console.log(`  ${tui.muted('Databases:')}       ${formatNumber(svc.databaseCount)}`);
-	console.log(`  ${tui.muted('Tables:')}          ${formatNumber(svc.totalTableCount)}`);
-	console.log(`  ${tui.muted('Records:')}         ${formatNumber(svc.totalRecordCount)}`);
-	console.log(`  ${tui.muted('Total Size:')}      ${tui.formatBytes(svc.totalSizeBytes)}`);
-}
-
-export const statsSubcommand = createCommand({
-	name: 'stats',
-	description: 'View database statistics',
-	tags: ['read-only', 'requires-auth'],
-	requires: { auth: true, org: true },
-	examples: [
-		{
-			command: getCommand('cloud db stats'),
-			description: 'View database 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,
-			undefined,
-			ctx.config
-		);
-		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: 'database',
-			start: opts.start,
-			end: opts.end,
-			orgIdHeader: orgId,
-		});
-
-		if (!options.json) {
-			displayStats(data);
-		}
-
-		return data;
-	},
-});
-
-export default statsSubcommand;