@agentuity/cli 1.0.53 → 1.0.55

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

@@ -18,7 +18,7 @@ const EnvDeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createSubcommand({
 	name: 'delete',
-	aliases: ['del', 'remove', 'rm'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete one or more environment variables or secrets',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	idempotent: true,

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

@@ -15,6 +15,7 @@ const EnvGetResponseSchema = z.object({
 
 export const getSubcommand = createSubcommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get an environment variable or secret value',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [

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

@@ -20,6 +20,7 @@ const EvalGetResponseSchema = z.object({
 
 export const getSubcommand = createSubcommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get details about a specific eval',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [

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

@@ -5,6 +5,7 @@ import { getCommand } from '../../../command-prefix';
 
 export const evalCommand = createCommand({
 	name: 'eval',
+	aliases: ['evals'],
 	description: 'Manage evals',
 	tags: ['requires-auth'],
 	examples: [

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

@@ -21,6 +21,7 @@ const EvalListResponseSchema = z.array(
 
 export const listSubcommand = createSubcommand({
 	name: 'list',
+	aliases: ['ls'],
 	description: 'List evals',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [
@@ -42,7 +43,6 @@ export const listSubcommand = createSubcommand({
 			description: 'List all evals regardless of project context',
 		},
 	],
-	aliases: ['ls'],
 	requires: { auth: true, apiClient: true },
 	optional: { project: true },
 	idempotent: true,

package/src/cmd/cloud/eval-run/get.ts

@@ -25,6 +25,7 @@ const EvalRunGetResponseSchema = z.object({
 
 export const getSubcommand = createSubcommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get details about a specific eval run',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [

package/src/cmd/cloud/eval-run/index.ts

@@ -5,6 +5,7 @@ import { getCommand } from '../../../command-prefix';
 
 export const evalRunCommand = createCommand({
 	name: 'eval-run',
+	aliases: ['eval-runs'],
 	description: 'Manage eval runs',
 	tags: ['requires-auth'],
 	examples: [

package/src/cmd/cloud/eval-run/list.ts

@@ -22,6 +22,7 @@ const EvalRunListResponseSchema = z.array(
 
 export const listSubcommand = createSubcommand({
 	name: 'list',
+	aliases: ['ls'],
 	description: 'List eval runs',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [
@@ -51,7 +52,6 @@ export const listSubcommand = createSubcommand({
 			description: 'List all eval runs regardless of project context',
 		},
 	],
-	aliases: ['ls'],
 	requires: { auth: true, apiClient: true },
 	optional: { project: true },
 	idempotent: true,

package/src/cmd/cloud/keyvalue/delete-namespace.ts

@@ -6,7 +6,7 @@ import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
 export const deleteNamespaceSubcommand = createCommand({
 	name: 'delete-namespace',
-	aliases: ['rm-namespace'],
+	aliases: ['rm-namespace', 'del-namespace', 'remove-namespace', 'terminate-namespace'],
 	description: 'Delete a keyvalue namespace and all its keys',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	idempotent: true,

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

@@ -12,7 +12,7 @@ const KVDeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createCommand({
 	name: 'delete',
-	aliases: ['del', 'rm', 'remove'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete a key from the keyvalue storage',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	idempotent: true,

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

@@ -13,6 +13,7 @@ const KVGetResponseSchema = z.object({
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get a value from the keyvalue storage',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true, region: true },

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

@@ -13,7 +13,7 @@ import { getCommand } from '../../../command-prefix';
 
 export const command = createCommand({
 	name: 'keyvalue',
-	aliases: ['kv'],
+	aliases: ['kv', 'keyvalues'],
 	description: 'Manage keyvalue storage for your projects',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [

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

@@ -26,7 +26,7 @@ export const deleteSubcommand = createSubcommand({
 			description: 'Delete a machine without confirmation',
 		},
 	],
-	aliases: ['rm', 'remove'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	requires: { auth: true, org: true },
 	idempotent: false,
 	schema: {

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

@@ -13,7 +13,7 @@ const OAuthClientDeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createSubcommand({
 	name: 'delete',
-	aliases: ['del', 'rm'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete an OAuth application',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	idempotent: true,

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

@@ -8,6 +8,7 @@ import { createOAuthClient } from './util';
 
 export const getSubcommand = createSubcommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get a specific OAuth application',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [

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

@@ -14,6 +14,7 @@ const QueueCreateResponseSchema = z.object({
 
 export const createSubcommand = createCommand({
 	name: 'create',
+	aliases: ['new'],
 	description: 'Create a new queue',
 	tags: ['mutating', 'creates-resource', 'requires-auth'],
 	requires: { auth: true, org: true },

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

@@ -13,7 +13,7 @@ const DeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createCommand({
 	name: 'delete',
-	aliases: ['rm'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete a queue by name',
 	tags: ['mutating', 'deletes-resource', 'requires-auth'],
 	requires: { auth: true },

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

@@ -54,6 +54,7 @@ function displayMessage(message: Message): void {
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get queue or message details',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true },

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

@@ -11,7 +11,7 @@ const RedisGetResponseSchema = z.object({
 
 export const showSubcommand = createSubcommand({
 	name: 'show',
-	aliases: ['info'],
+	aliases: ['info', 'get'],
 	description: 'Show Redis connection URL',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true, org: true, region: true },

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

@@ -17,6 +17,7 @@ const CheckpointCreateResponseSchema = z.object({
 
 export const createSubcommand = createCommand({
 	name: 'create',
+	aliases: ['new'],
 	description: 'Create a disk checkpoint of the sandbox filesystem',
 	tags: ['slow', 'requires-auth'],
 	requires: { auth: true, apiClient: true },

package/src/cmd/cloud/sandbox/checkpoint/delete.ts

@@ -15,7 +15,7 @@ const CheckpointDeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createCommand({
 	name: 'delete',
-	aliases: ['del', 'rm', 'remove'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete a disk checkpoint',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	requires: { auth: true, apiClient: true },

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

@@ -7,7 +7,7 @@ import { getCommand } from '../../../../command-prefix';
 
 export const checkpointCommand = createCommand({
 	name: 'checkpoint',
-	aliases: ['ckpt'],
+	aliases: ['ckpt', 'checkpoints'],
 	description: 'Manage disk checkpoints for sandbox filesystem',
 	tags: ['slow', 'requires-auth'],
 	requires: { auth: true, apiClient: true },

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

@@ -27,6 +27,7 @@ const SandboxCreateResponseSchema = z.object({
 
 export const createSubcommand = createCommand({
 	name: 'create',
+	aliases: ['new'],
 	description: 'Create an interactive sandbox for multiple executions',
 	tags: ['slow', 'requires-auth'],
 	requires: { auth: true, region: true, org: true },

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

@@ -14,7 +14,7 @@ const SandboxDeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createCommand({
 	name: 'delete',
-	aliases: ['del', 'remove', 'destroy'],
+	aliases: ['rm', 'del', 'remove', 'destroy', 'terminate'],
 	description: 'Delete a sandbox',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	requires: { auth: true, apiClient: true },

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

@@ -218,12 +218,21 @@ export const execSubcommand = createCommand({
 			const stderrOutput =
 				!isCombinedOutput && stderrStreamUrl ? stderrChunks.join('') : undefined;
 
-			if (!options.json) {
-				if (finalExecution.exitCode === 0) {
-					// no op
-				} else if (finalExecution.exitCode !== undefined) {
+			if (finalExecution.exitCode !== undefined && finalExecution.exitCode !== 0) {
+				if (!options.json) {
 					tui.error(`failed with exit code ${finalExecution.exitCode} in ${duration}ms`);
-				} else {
+				}
+				process.exitCode = finalExecution.exitCode;
+			} else if (finalExecution.exitCode === undefined) {
+				const failStatuses = ['failed', 'error', 'timeout', 'killed'];
+				if (failStatuses.includes(finalExecution.status)) {
+					if (!options.json) {
+						tui.error(
+							`Execution ${tui.bold(finalExecution.executionId)} ${finalExecution.status} in ${duration}ms`
+						);
+					}
+					process.exitCode = 1;
+				} else if (!options.json) {
 					tui.info(
 						`Execution ${tui.bold(finalExecution.executionId)} - Status: ${finalExecution.status}`
 					);

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

@@ -10,7 +10,7 @@ export const command = createCommand({
 	tags: ['read-only', 'requires-auth'],
 	examples: [
 		{
-			command: getCommand('cloud sandbox execution list snbx_abc123'),
+			command: getCommand('cloud sandbox execution list sbx_abc123'),
 			description: 'List executions for a sandbox',
 		},
 		{

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

@@ -29,11 +29,11 @@ export const listSubcommand = createCommand({
 	idempotent: true,
 	examples: [
 		{
-			command: getCommand('cloud sandbox execution list snbx_abc123'),
+			command: getCommand('cloud sandbox execution list sbx_abc123'),
 			description: 'List executions for a sandbox',
 		},
 		{
-			command: getCommand('cloud sandbox execution list snbx_abc123 --limit 10'),
+			command: getCommand('cloud sandbox execution list sbx_abc123 --limit 10'),
 			description: 'List with a limit',
 		},
 	],

package/src/cmd/cloud/sandbox/{cp.ts → fs/cp.ts}

@@ -1,11 +1,11 @@
 import { z } from 'zod';
 import { readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from 'node:fs';
 import { dirname, resolve, basename, join, relative } from 'node:path';
-import { createCommand } from '../../../types';
-import { toForwardSlash } from '../../../utils/normalize-path';
-import * as tui from '../../../tui';
-import { createSandboxClient } from './util';
-import { getCommand } from '../../../command-prefix';
+import { createCommand } from '../../../../types';
+import { toForwardSlash } from '../../../../utils/normalize-path';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
 import {
 	sandboxWriteFiles,
 	sandboxReadFile,
@@ -31,7 +31,7 @@ function parsePath(pathArg: string): ParsedPath {
 	}
 	const prefix = pathArg.slice(0, colonIndex);
 	const path = pathArg.slice(colonIndex + 1);
-	if (prefix.startsWith('snbx_') || prefix.startsWith('sbx_')) {
+	if (prefix.startsWith('sbx_')) {
 		return { sandboxId: prefix, path };
 	}
 	return { sandboxId: null, path: pathArg };
@@ -59,24 +59,24 @@ export const cpSubcommand = createCommand({
 	requires: { auth: true, apiClient: true },
 	examples: [
 		{
-			command: getCommand('cloud sandbox cp ./local-file.txt sbx_abc123:/path/to/file.txt'),
+			command: getCommand('cloud sandbox fs cp ./local-file.txt sbx_abc123:/path/to/file.txt'),
 			description: 'Copy a local file to a sandbox',
 		},
 		{
-			command: getCommand('cloud sandbox cp sbx_abc123:/path/to/file.txt ./local-file.txt'),
+			command: getCommand('cloud sandbox fs cp sbx_abc123:/path/to/file.txt ./local-file.txt'),
 			description: 'Copy a file from a sandbox to local',
 		},
 		{
-			command: getCommand('cloud sandbox cp --recursive ./local-dir sbx_abc123:/path/to/dir'),
+			command: getCommand('cloud sandbox fs cp --recursive ./local-dir sbx_abc123:/path/to/dir'),
 			description: 'Copy a local directory to a sandbox recursively',
 		},
 		{
-			command: getCommand('cloud sandbox cp -r sbx_abc123:/path/to/dir ./local-dir'),
+			command: getCommand('cloud sandbox fs cp -r sbx_abc123:/path/to/dir ./local-dir'),
 			description: 'Copy a directory from a sandbox to local recursively',
 		},
 		{
 			command: getCommand(
-				'cloud sandbox cp --strict ./local-file.txt sbx_abc123:/path/to/file.txt'
+				'cloud sandbox fs cp --strict ./local-file.txt sbx_abc123:/path/to/file.txt'
 			),
 			description: 'Copy a file, failing if the target directory does not exist',
 		},
@@ -296,7 +296,7 @@ async function uploadSingleFile(
 				logger.fatal(
 					`Target directory does not exist: ${parentDir}\n` +
 						`Use without --strict to auto-create parent directories, or create it first with:\n` +
-						`  ${getCommand(`cloud sandbox mkdir ${sandboxId} ${parentDir} -p`)}`
+						`  ${getCommand(`cloud sandbox fs mkdir ${sandboxId} ${parentDir} -p`)}`
 				);
 			}
 		}
@@ -364,7 +364,7 @@ async function uploadDirectory(
 				logger.fatal(
 					`Target directory does not exist: ${parentDir}\n` +
 						`Use without --strict to auto-create parent directories, or create it first with:\n` +
-						`  ${getCommand(`cloud sandbox mkdir ${sandboxId} ${parentDir} -p`)}`
+						`  ${getCommand(`cloud sandbox fs mkdir ${sandboxId} ${parentDir} -p`)}`
 				);
 			}
 		}

package/src/cmd/cloud/sandbox/{download.ts → fs/download.ts}

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 import { writeFileSync } from 'node:fs';
-import { createCommand } from '../../../types';
-import * as tui from '../../../tui';
-import { createSandboxClient } from './util';
-import { getCommand } from '../../../command-prefix';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
 import { sandboxDownloadArchive, sandboxResolve } from '@agentuity/server';
 
 export const downloadSubcommand = createCommand({
@@ -14,15 +14,15 @@ export const downloadSubcommand = createCommand({
 	requires: { auth: true, apiClient: true },
 	examples: [
 		{
-			command: getCommand('cloud sandbox download sbx_abc123 ./backup.tar.gz'),
+			command: getCommand('cloud sandbox fs download sbx_abc123 ./backup.tar.gz'),
 			description: 'Download sandbox files as tar.gz archive',
 		},
 		{
-			command: getCommand('cloud sandbox download sbx_abc123 ./backup.zip --format zip'),
+			command: getCommand('cloud sandbox fs download sbx_abc123 ./backup.zip --format zip'),
 			description: 'Download sandbox files as zip archive',
 		},
 		{
-			command: getCommand('cloud sandbox download sbx_abc123 ./backup.tar.gz --path /subdir'),
+			command: getCommand('cloud sandbox fs download sbx_abc123 ./backup.tar.gz --path /subdir'),
 			description: 'Download only a specific directory',
 		},
 	],

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

@@ -0,0 +1,36 @@
+import { createCommand } from '../../../../types';
+import { getCommand } from '../../../../command-prefix';
+import { rmSubcommand } from './rm';
+import { mkdirSubcommand } from './mkdir';
+import { rmdirSubcommand } from './rmdir';
+import { lsSubcommand } from './ls';
+import { cpSubcommand } from './cp';
+import { downloadSubcommand } from './download';
+import { uploadSubcommand } from './upload';
+
+export const command = createCommand({
+	name: 'fs',
+	aliases: ['files', 'file'],
+	description: 'Filesystem operations for sandboxes',
+	tags: ['slow', 'requires-auth'],
+	examples: [
+		{
+			command: getCommand('cloud sandbox fs ls sbx_abc123'),
+			description: 'List files in a sandbox',
+		},
+		{
+			command: getCommand('cloud sandbox fs cp ./file.txt sbx_abc123:/path/to/file.txt'),
+			description: 'Copy a file to a sandbox',
+		},
+	],
+	subcommands: [
+		lsSubcommand,
+		cpSubcommand,
+		rmSubcommand,
+		mkdirSubcommand,
+		rmdirSubcommand,
+		downloadSubcommand,
+		uploadSubcommand,
+	],
+	requires: { auth: true, org: true },
+});

package/src/cmd/cloud/sandbox/{ls.ts → fs/ls.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { createCommand } from '../../../types';
-import * as tui from '../../../tui';
-import { createSandboxClient } from './util';
-import { getCommand } from '../../../command-prefix';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
 import { sandboxListFiles, sandboxResolve } from '@agentuity/server';
 
 const FileInfoSchema = z.object({
@@ -19,26 +19,26 @@ const LsResponseSchema = z.object({
 });
 
 export const lsSubcommand = createCommand({
-	name: 'files',
-	aliases: ['lsf'],
+	name: 'ls',
+	aliases: ['list', 'dir'],
 	description: 'List files in a sandbox directory',
 	tags: ['slow', 'requires-auth'],
 	requires: { auth: true, apiClient: true },
 	examples: [
 		{
-			command: getCommand('cloud sandbox files sbx_abc123'),
+			command: getCommand('cloud sandbox fs ls sbx_abc123'),
 			description: 'List files in the sandbox root directory',
 		},
 		{
-			command: getCommand('cloud sandbox files sbx_abc123 /path/to/dir'),
+			command: getCommand('cloud sandbox fs ls sbx_abc123 /path/to/dir'),
 			description: 'List files in a specific directory',
 		},
 		{
-			command: getCommand('cloud sandbox files sbx_abc123 -l'),
+			command: getCommand('cloud sandbox fs ls sbx_abc123 -l'),
 			description: 'List files with permissions and modification time',
 		},
 		{
-			command: getCommand('cloud sandbox files sbx_abc123 --json'),
+			command: getCommand('cloud sandbox fs ls sbx_abc123 --json'),
 			description: 'List files with JSON output',
 		},
 	],

package/src/cmd/cloud/sandbox/{mkdir.ts → fs/mkdir.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { createCommand } from '../../../types';
-import * as tui from '../../../tui';
-import { createSandboxClient } from './util';
-import { getCommand } from '../../../command-prefix';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
 import { sandboxMkDir, sandboxResolve } from '@agentuity/server';
 
 const MkDirResponseSchema = z.object({
@@ -17,11 +17,11 @@ export const mkdirSubcommand = createCommand({
 	requires: { auth: true, apiClient: true },
 	examples: [
 		{
-			command: getCommand('cloud sandbox mkdir sbx_abc123 /path/to/dir'),
+			command: getCommand('cloud sandbox fs mkdir sbx_abc123 /path/to/dir'),
 			description: 'Create a directory in the sandbox',
 		},
 		{
-			command: getCommand('cloud sandbox mkdir sbx_abc123 /path/to/nested/dir -p'),
+			command: getCommand('cloud sandbox fs mkdir sbx_abc123 /path/to/nested/dir -p'),
 			description: 'Create nested directories recursively',
 		},
 	],

package/src/cmd/cloud/sandbox/{rm.ts → fs/rm.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { createCommand } from '../../../types';
-import * as tui from '../../../tui';
-import { createSandboxClient } from './util';
-import { getCommand } from '../../../command-prefix';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
 import { sandboxRmFile, sandboxResolve } from '@agentuity/server';
 
 const RmFileResponseSchema = z.object({
@@ -12,12 +12,13 @@ const RmFileResponseSchema = z.object({
 
 export const rmSubcommand = createCommand({
 	name: 'rm',
+	aliases: ['del', 'remove'],
 	description: 'Remove a file from a sandbox',
 	tags: ['slow', 'requires-auth'],
 	requires: { auth: true, apiClient: true },
 	examples: [
 		{
-			command: getCommand('cloud sandbox rm sbx_abc123 /path/to/file.txt'),
+			command: getCommand('cloud sandbox fs rm sbx_abc123 /path/to/file.txt'),
 			description: 'Remove a file from the sandbox',
 		},
 	],

package/src/cmd/cloud/sandbox/{rmdir.ts → fs/rmdir.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { createCommand } from '../../../types';
-import * as tui from '../../../tui';
-import { createSandboxClient } from './util';
-import { getCommand } from '../../../command-prefix';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
 import { sandboxRmDir, sandboxResolve } from '@agentuity/server';
 
 const RmDirResponseSchema = z.object({
@@ -17,11 +17,11 @@ export const rmdirSubcommand = createCommand({
 	requires: { auth: true, apiClient: true },
 	examples: [
 		{
-			command: getCommand('cloud sandbox rmdir sbx_abc123 /path/to/dir'),
+			command: getCommand('cloud sandbox fs rmdir sbx_abc123 /path/to/dir'),
 			description: 'Remove an empty directory from the sandbox',
 		},
 		{
-			command: getCommand('cloud sandbox rmdir sbx_abc123 /path/to/dir -r'),
+			command: getCommand('cloud sandbox fs rmdir sbx_abc123 /path/to/dir -r'),
 			description: 'Remove a directory and all its contents recursively',
 		},
 	],

package/src/cmd/cloud/sandbox/{upload.ts → fs/upload.ts}

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 import { readFileSync, statSync } from 'node:fs';
-import { createCommand } from '../../../types';
-import * as tui from '../../../tui';
-import { createSandboxClient } from './util';
-import { getCommand } from '../../../command-prefix';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
 import { sandboxUploadArchive, sandboxResolve } from '@agentuity/server';
 
 export const uploadSubcommand = createCommand({
@@ -14,15 +14,15 @@ export const uploadSubcommand = createCommand({
 	requires: { auth: true, apiClient: true },
 	examples: [
 		{
-			command: getCommand('cloud sandbox upload sbx_abc123 ./archive.tar.gz'),
+			command: getCommand('cloud sandbox fs upload sbx_abc123 ./archive.tar.gz'),
 			description: 'Upload and extract a tar.gz archive to sandbox root',
 		},
 		{
-			command: getCommand('cloud sandbox upload sbx_abc123 ./archive.zip --path /subdir'),
+			command: getCommand('cloud sandbox fs upload sbx_abc123 ./archive.zip --path /subdir'),
 			description: 'Upload and extract a zip archive to a specific directory',
 		},
 		{
-			command: getCommand('cloud sandbox upload sbx_abc123 ./archive.bin --format tar.gz'),
+			command: getCommand('cloud sandbox fs upload sbx_abc123 ./archive.bin --format tar.gz'),
 			description: 'Upload with explicit format specification',
 		},
 	],

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

@@ -7,15 +7,9 @@ import { getSubcommand } from './get';
 import { deleteSubcommand } from './delete';
 import { snapshotCommand } from './snapshot';
 import { runtimeCommand } from './runtime';
-import { cpSubcommand } from './cp';
+import { command as fsCommand } from './fs';
 import { command as executionCommand } from './execution';
 import { command as jobCommand } from './job';
-import { mkdirSubcommand } from './mkdir';
-import { rmdirSubcommand } from './rmdir';
-import { rmSubcommand } from './rm';
-import { lsSubcommand } from './ls';
-import { downloadSubcommand } from './download';
-import { uploadSubcommand } from './upload';
 import { envSubcommand } from './env';
 import { pauseSubcommand } from './pause';
 import { resumeSubcommand } from './resume';
@@ -52,15 +46,9 @@ export const command = createCommand({
 		deleteSubcommand,
 		snapshotCommand,
 		runtimeCommand,
-		cpSubcommand,
+		fsCommand,
 		executionCommand,
 		jobCommand,
-		mkdirSubcommand,
-		rmdirSubcommand,
-		rmSubcommand,
-		lsSubcommand,
-		downloadSubcommand,
-		uploadSubcommand,
 		envSubcommand,
 		pauseSubcommand,
 		resumeSubcommand,