@agentuity/cli 0.0.59 → 0.0.61

package/src/cmd/cloud/objectstore/list-keys.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 export const listKeysSubcommand = createCommand({
 	name: 'list-keys',
 	aliases: ['ls', 'list'],
@@ -12,9 +11,12 @@ export const listKeysSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('objectstore list-keys uploads')} - List all uploaded files`,
-		`${getCommand('objectstore ls assets')} - List assets (using alias)`,
-		`${getCommand('objectstore list backups')} - List all backups`,
+		{
+			command: getCommand('objectstore list-keys uploads'),
+			description: 'List all uploaded files',
+		},
+		{ command: getCommand('objectstore ls assets'), description: 'List assets (using alias)' },
+		{ command: getCommand('objectstore list backups'), description: 'List all backups' },
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/objectstore/put.ts

@@ -4,7 +4,6 @@ import * as tui from '../../../tui';
 import { isPossiblyJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const ObjectStorePutResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	bucket: z.string().describe('Bucket name'),
@@ -21,9 +20,22 @@ export const putSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('objectstore put uploads images/logo.png @./logo.png')} - Upload logo from file`,
-		`${getCommand('objectstore put assets data/config.json \'{"api":"https://api.example.com"}\'')} - Store JSON config`,
-		`${getCommand('objectstore put backups db-2024.sql @~/Downloads/backup.sql --content-type application/sql')} - Upload SQL backup`,
+		{
+			command: getCommand('objectstore put uploads images/logo.png @./logo.png'),
+			description: 'Upload logo from file',
+		},
+		{
+			command: getCommand(
+				'objectstore put assets data/config.json \'{"api":"https://api.example.com"}\''
+			),
+			description: 'Store JSON config',
+		},
+		{
+			command: getCommand(
+				'objectstore put backups db-2024.sql @~/Downloads/backup.sql --content-type application/sql'
+			),
+			description: 'Upload SQL backup',
+		},
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/objectstore/repl.ts

@@ -6,14 +6,18 @@ import * as tui from '../../../tui';
 import { isPossiblyJSON, tryParseJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 export const replSubcommand = createCommand({
 	name: 'repl',
 	description: 'Start an interactive repl for working with object storage',
 	tags: ['slow', 'requires-auth'],
 	idempotent: false,
 	requires: { auth: true, project: true },
-	examples: [`${getCommand('objectstore repl')} - Start interactive object storage session`],
+	examples: [
+		{
+			command: getCommand('objectstore repl'),
+			description: 'Start interactive object storage session',
+		},
+	],
 
 	async handler(ctx) {
 		showBanner(undefined, true);

package/src/cmd/cloud/objectstore/url.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const ObjectStoreURLResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	bucket: z.string().describe('Bucket name'),
@@ -21,9 +20,18 @@ export const urlSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('objectstore url uploads images/logo.png')} - Get public URL for logo`,
-		`${getCommand('objectstore url assets data/export.json --expires 3600')} - Get 1h temporary URL`,
-		`${getCommand('objectstore presigned backups db-2024.sql --expires 300')} - Get 5m presigned URL`,
+		{
+			command: getCommand('objectstore url uploads images/logo.png'),
+			description: 'Get public URL for logo',
+		},
+		{
+			command: getCommand('objectstore url assets data/export.json --expires 3600'),
+			description: 'Get 1h temporary URL',
+		},
+		{
+			command: getCommand('objectstore presigned backups db-2024.sql --expires 300'),
+			description: 'Get 5m presigned URL',
+		},
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/scp/download.ts

@@ -3,7 +3,6 @@ import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { getIONHost } from '../../../config';
 import { getCommand } from '../../../command-prefix';
-
 const args = z.object({
 	source: z.string().describe('the source file'),
 	destination: z.string().optional().describe('the destination file'),
@@ -20,10 +19,22 @@ export const downloadCommand = createSubcommand({
 	tags: ['read-only', 'slow', 'requires-auth', 'requires-deployment'],
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud scp download')} /var/log/app.log          # Download to current directory`,
-		`${getCommand('cloud scp download')} /var/log/app.log ./logs/  # Download to specific path`,
-		`${getCommand('cloud scp download')} /app/config.json --identifier=proj_abc123xyz`,
-		`${getCommand('cloud scp download')} ~/logs/*.log ./logs/      # Download multiple files`,
+		{
+			command: getCommand('cloud scp download /var/log/app.log'),
+			description: 'Download to current directory',
+		},
+		{
+			command: getCommand('cloud scp download /var/log/app.log ./logs/'),
+			description: 'Download to specific path',
+		},
+		{
+			command: getCommand('cloud scp download /app/config.json --identifier=proj_abc123xyz'),
+			description: 'Download from specific project',
+		},
+		{
+			command: getCommand('cloud scp download ~/logs/*.log ./logs/'),
+			description: 'Download multiple files',
+		},
 	],
 	requires: { apiClient: true, auth: true },
 	optional: { project: true },

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

@@ -1,10 +1,21 @@
 import { createCommand } from '../../../types';
 import { downloadCommand } from './download';
 import { uploadCommand } from './upload';
+import { getCommand } from '../../../command-prefix';
 
 export const scpSubcommand = createCommand({
 	name: 'scp',
 	description: 'Secure Copy commands',
 	tags: ['slow', 'requires-auth', 'requires-deployment'],
+	examples: [
+		{
+			command: getCommand('cloud scp upload ./local-file.txt /remote-path/'),
+			description: 'Upload file to deployment',
+		},
+		{
+			command: getCommand('cloud scp download /remote-file.txt ./local-path/'),
+			description: 'Download file from deployment',
+		},
+	],
 	subcommands: [downloadCommand, uploadCommand],
 });

package/src/cmd/cloud/scp/upload.ts

@@ -3,7 +3,6 @@ import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { getIONHost } from '../../../config';
 import { getCommand } from '../../../command-prefix';
-
 const args = z.object({
 	source: z.string().describe('the source file'),
 	destination: z
@@ -23,10 +22,22 @@ export const uploadCommand = createSubcommand({
 	tags: ['mutating', 'updates-resource', 'slow', 'requires-auth', 'requires-deployment'],
 	idempotent: false,
 	examples: [
-		`${getCommand('cloud scp upload')} ./config.json                # Upload to remote home directory`,
-		`${getCommand('cloud scp upload')} ./config.json /app/config.json # Upload to specific path`,
-		`${getCommand('cloud scp upload')} ./config.json --identifier=proj_abc123xyz`,
-		`${getCommand('cloud scp upload')} ./logs/*.log ~/logs/        # Upload multiple files`,
+		{
+			command: getCommand('cloud scp upload ./config.json'),
+			description: 'Upload to remote home directory',
+		},
+		{
+			command: getCommand('cloud scp upload ./config.json /app/config.json'),
+			description: 'Upload to specific path',
+		},
+		{
+			command: getCommand('cloud scp upload ./config.json --identifier=proj_abc123xyz'),
+			description: 'Upload to specific project',
+		},
+		{
+			command: getCommand('cloud scp upload ./logs/*.log ~/logs/'),
+			description: 'Upload multiple files',
+		},
 	],
 	requires: { apiClient: true, auth: true },
 	schema: {

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

@@ -17,7 +17,10 @@ export const deleteSubcommand = createSubcommand({
 	description: 'Delete a secret',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth', 'requires-project'],
 	idempotent: true,
-	examples: [getCommand('secret delete OLD_API_KEY'), getCommand('secret rm DATABASE_URL')],
+	examples: [
+		{ command: getCommand('secret delete OLD_API_KEY'), description: 'Delete item' },
+		{ command: getCommand('secret rm DATABASE_URL'), description: 'Delete item' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {
 		args: z.object({

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

@@ -2,7 +2,6 @@ import { z } from 'zod';
 import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { projectGet } from '@agentuity/server';
-import { maskSecret } from '../../../env-util';
 import { getCommand } from '../../../command-prefix';
 import { ErrorCode } from '../../../errors';
 
@@ -16,8 +15,11 @@ export const getSubcommand = createSubcommand({
 	description: 'Get a secret value',
 	tags: ['read-only', 'fast', 'requires-auth', 'requires-project'],
 	examples: [
-		getCommand('secret get DATABASE_URL'),
-		getCommand('secret get STRIPE_SECRET_KEY --no-mask'),
+		{ command: getCommand('secret get DATABASE_URL'), description: 'Get item details' },
+		{
+			command: getCommand('secret get STRIPE_SECRET_KEY --no-mask'),
+			description: 'Use no mask option',
+		},
 	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {
@@ -53,14 +55,14 @@ export const getSubcommand = createSubcommand({
 			if (process.stdout.isTTY) {
 				// Display the value, masked by default
 				if (opts?.mask) {
-					tui.success(`${args.key}=${maskSecret(value)}`);
+					tui.success(`${args.key}=${tui.maskSecret(value)}`);
 				} else {
 					tui.success(`${args.key}=${value}`);
 				}
 			} else {
 				// Display the value, masked by default
 				if (opts?.mask) {
-					console.log(`${args.key}=${maskSecret(value)}`);
+					console.log(`${args.key}=${tui.maskSecret(value)}`);
 				} else {
 					console.log(`${args.key}=${value}`);
 				}

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

@@ -31,8 +31,11 @@ export const importSubcommand = createSubcommand({
 		'requires-project',
 	],
 	examples: [
-		getCommand('secret import .env.local'),
-		getCommand('secret import .env.production.backup'),
+		{ command: getCommand('secret import .env.local'), description: 'Run .env.local command' },
+		{
+			command: getCommand('secret import .env.production.backup'),
+			description: 'Run .env.production.backup command',
+		},
 	],
 	idempotent: false,
 	requires: { auth: true, project: true, apiClient: true },

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

@@ -6,11 +6,19 @@ import { getSubcommand } from './get';
 import { deleteSubcommand } from './delete';
 import { importSubcommand } from './import';
 import { listSubcommand } from './list';
+import { getCommand } from '../../../command-prefix';
 
 export const command = createCommand({
 	name: 'secret',
 	description: 'Manage secrets for your project',
 	tags: ['fast', 'requires-auth', 'requires-project'],
+	examples: [
+		{ command: getCommand('cloud secret list'), description: 'List all secrets' },
+		{
+			command: getCommand('cloud secret set API_KEY "sk_..."'),
+			description: 'Set a secret value',
+		},
+	],
 	subcommands: [
 		listSubcommand,
 		pullSubcommand,

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

@@ -2,7 +2,6 @@ import { z } from 'zod';
 import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { projectGet } from '@agentuity/server';
-import { maskSecret } from '../../../env-util';
 import { getCommand } from '../../../command-prefix';
 
 const SecretListResponseSchema = z.record(z.string(), z.string().describe('Secret value'));
@@ -12,7 +11,10 @@ export const listSubcommand = createSubcommand({
 	aliases: ['ls'],
 	description: 'List all secrets',
 	tags: ['read-only', 'fast', 'requires-auth', 'requires-project'],
-	examples: [getCommand('secret list'), getCommand('secret list --no-mask')],
+	examples: [
+		{ command: getCommand('secret list'), description: 'List items' },
+		{ command: getCommand('secret list --no-mask'), description: 'Use no mask option' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	idempotent: true,
 	schema: {
@@ -52,7 +54,7 @@ export const listSubcommand = createSubcommand({
 				const shouldMask = opts?.mask !== false;
 				for (const key of sortedKeys) {
 					const value = secrets[key];
-					const displayValue = shouldMask ? maskSecret(value) : value;
+					const displayValue = shouldMask ? tui.maskSecret(value) : value;
 					if (process.stdout.isTTY) {
 						console.log(`${tui.bold(key)}=${displayValue}`);
 					} else {

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

@@ -24,7 +24,10 @@ export const pullSubcommand = createSubcommand({
 	description: 'Pull secrets from cloud to local .env.production file',
 	tags: ['slow', 'requires-auth', 'requires-project'],
 	idempotent: true,
-	examples: [getCommand('secret pull'), getCommand('secret pull --force')],
+	examples: [
+		{ command: getCommand('secret pull'), description: 'Run pull command' },
+		{ command: getCommand('secret pull --force'), description: 'Use force option' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	prerequisites: ['cloud deploy'],
 	schema: {

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

@@ -23,7 +23,7 @@ export const pushSubcommand = createSubcommand({
 		'requires-project',
 	],
 	idempotent: true,
-	examples: [getCommand('secret push')],
+	examples: [{ command: getCommand('secret push'), description: 'Run push command' }],
 	requires: { auth: true, project: true, apiClient: true },
 	prerequisites: ['secret set'],
 	schema: {

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

@@ -17,8 +17,14 @@ export const setSubcommand = createSubcommand({
 	tags: ['mutating', 'updates-resource', 'slow', 'requires-auth', 'requires-project'],
 	idempotent: true,
 	examples: [
-		getCommand('secret set DATABASE_URL "postgres://user:pass@host:5432/db"'),
-		getCommand('secret set STRIPE_SECRET_KEY "sk_live_..."'),
+		{
+			command: getCommand('secret set DATABASE_URL "postgres://user:pass@host:5432/db"'),
+			description: 'Run "postgres://user:pass@host:5432/db" command',
+		},
+		{
+			command: getCommand('secret set STRIPE_SECRET_KEY "sk_live_..."'),
+			description: 'Run "sk_live_..." command',
+		},
 	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {

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

@@ -104,7 +104,7 @@ export const getSubcommand = createSubcommand({
 	name: 'get',
 	description: 'Get details about a specific session',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	examples: [`${getCommand('cloud session get')} sess_abc123xyz`],
+	examples: [{ command: getCommand('cloud session get'), description: 'sess_abc123xyz' }],
 	requires: { auth: true },
 	idempotent: true,
 	schema: {

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

@@ -2,10 +2,15 @@ import { createCommand } from '../../../types';
 import { getSubcommand } from './get';
 import { listSubcommand } from './list';
 import { logsSubcommand } from './logs';
+import { getCommand } from '../../../command-prefix';
 
 export const sessionCommand = createCommand({
 	name: 'session',
 	description: 'Manage sessions',
 	tags: ['requires-auth'],
+	examples: [
+		{ command: getCommand('cloud session list'), description: 'List all sessions' },
+		{ command: getCommand('cloud session logs <id>'), description: 'View session logs' },
+	],
 	subcommands: [getSubcommand, listSubcommand, logsSubcommand],
 });

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

@@ -24,14 +24,35 @@ export const listSubcommand = createSubcommand({
 	description: 'List recent sessions',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [
-		`${getCommand('cloud session list')}                      # List 10 most recent sessions`,
-		`${getCommand('cloud session list')} --count=25           # List 25 most recent sessions`,
-		`${getCommand('cloud session list')} --project-id=proj_* # Filter by project`,
-		`${getCommand('cloud session list')} --deployment-id=*   # Filter by deployment`,
-		`${getCommand('cloud session list')} --success=true      # Only successful sessions`,
-		`${getCommand('cloud session list')} --devmode=false     # Only production sessions`,
-		`${getCommand('cloud session list')} --trigger=api       # Only API triggered sessions`,
-		`${getCommand('cloud session list')} --env=production    # Only production environment`,
+		{ command: getCommand('cloud session list'), description: 'List 10 most recent sessions' },
+		{
+			command: getCommand('cloud session list --count=25'),
+			description: 'List 25 most recent sessions',
+		},
+		{
+			command: getCommand('cloud session list --project-id=proj_*'),
+			description: 'Filter by project',
+		},
+		{
+			command: getCommand('cloud session list --deployment-id=*'),
+			description: 'Filter by deployment',
+		},
+		{
+			command: getCommand('cloud session list --success=true'),
+			description: 'Only successful sessions',
+		},
+		{
+			command: getCommand('cloud session list --devmode=false'),
+			description: 'Only production sessions',
+		},
+		{
+			command: getCommand('cloud session list --trigger=api'),
+			description: 'Only API triggered sessions',
+		},
+		{
+			command: getCommand('cloud session list --env=production'),
+			description: 'Only production environment',
+		},
 	],
 	aliases: ['ls'],
 	requires: { auth: true },

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

@@ -19,8 +19,14 @@ export const logsSubcommand = createSubcommand({
 	description: 'Get logs for a specific session',
 	tags: ['read-only', 'slow', 'requires-auth'],
 	examples: [
-		`${getCommand('cloud session logs')} sess_abc123xyz`,
-		`${getCommand('cloud session logs')} --no-timestamps  # hide timestamps`,
+		{
+			command: getCommand('cloud session logs sess_abc123xyz'),
+			description: 'View logs for session',
+		},
+		{
+			command: getCommand('cloud session logs sess_abc123xyz --no-timestamps'),
+			description: 'Hide timestamps',
+		},
 	],
 	requires: { auth: true, apiClient: true },
 	optional: { project: true },

package/src/cmd/cloud/ssh.ts

@@ -3,7 +3,6 @@ import { createSubcommand } from '../../types';
 import * as tui from '../../tui';
 import { getIONHost } from '../../config';
 import { getCommand } from '../../command-prefix';
-
 const args = z.object({
 	identifier: z.string().optional().describe('The project or deployment id to use'),
 	command: z.string().optional().describe('The command to run'),
@@ -19,12 +18,21 @@ export const sshSubcommand = createSubcommand({
 	tags: ['read-only', 'slow', 'requires-auth', 'requires-deployment'],
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud ssh')}                          # SSH into current project`,
-		`${getCommand('cloud ssh')} proj_abc123xyz           # SSH into specific project`,
-		`${getCommand('cloud ssh')} deploy_abc123xyz         # SSH into specific deployment`,
-		`${getCommand('cloud ssh')} 'ps aux'                 # Run command and exit`,
-		`${getCommand('cloud ssh')} proj_abc123xyz 'tail -f /var/log/app.log'`,
-		`${getCommand('cloud ssh')} --show                   # Show SSH command without executing`,
+		{ command: getCommand('cloud ssh'), description: 'SSH into current project' },
+		{ command: getCommand('cloud ssh proj_abc123xyz'), description: 'SSH into specific project' },
+		{
+			command: getCommand('cloud ssh deploy_abc123xyz'),
+			description: 'SSH into specific deployment',
+		},
+		{ command: getCommand("cloud ssh 'ps aux'"), description: 'Run command and exit' },
+		{
+			command: getCommand("cloud ssh proj_abc123xyz 'tail -f /var/log/app.log'"),
+			description: 'Run command on specific project',
+		},
+		{
+			command: getCommand('cloud ssh --show'),
+			description: 'Show SSH command without executing',
+		},
 	],
 	toplevel: true,
 	requires: { auth: true, apiClient: true },

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

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { createResources } from '@agentuity/server';
+import { createSubcommand as defineSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getCatalystAPIClient } from '../../../config';
+import { getCommand } from '../../../command-prefix';
+import { isDryRunMode, outputDryRun } from '../../../explain';
+
+export const createSubcommand = defineSubcommand({
+	name: 'create',
+	aliases: ['new'],
+	description: 'Create a new storage resource',
+	tags: ['mutating', 'creates-resource', 'slow', 'requires-auth', 'requires-deployment'],
+	idempotent: false,
+	requires: { auth: true, org: true, region: true },
+	examples: [
+		{ command: getCommand('cloud storage create'), description: 'Create new item' },
+		{ command: getCommand('cloud storage new'), description: 'Run new command' },
+		{ command: getCommand('--dry-run cloud storage create'), description: 'Create new item' },
+	],
+	schema: {
+		response: z.object({
+			success: z.boolean().describe('Whether creation succeeded'),
+			name: z.string().describe('Created storage bucket name'),
+		}),
+	},
+
+	async handler(ctx) {
+		const { logger, orgId, region, config, auth, options } = ctx;
+
+		// Handle dry-run mode
+		if (isDryRunMode(options)) {
+			const message = `Would create storage bucket in region: ${region}`;
+			outputDryRun(message, options);
+			if (!options.json) {
+				tui.newline();
+				tui.info('[DRY RUN] Storage creation skipped');
+			}
+			return {
+				success: false,
+				name: 'dry-run-bucket',
+			};
+		}
+
+		const catalystClient = getCatalystAPIClient(config, logger, auth);
+
+		const created = await tui.spinner({
+			message: `Creating storage in ${region}`,
+			clearOnSuccess: true,
+			callback: async () => {
+				return createResources(catalystClient, orgId, region!, [{ type: 's3' }]);
+			},
+		});
+
+		if (created.length > 0) {
+			tui.success(`Created storage: ${tui.bold(created[0].name)}`);
+			return {
+				success: true,
+				name: created[0].name,
+			};
+		} else {
+			tui.fatal('Failed to create storage');
+		}
+	},
+});