@agentuity/cli 2.0.0-beta.0 → 2.0.0-beta.1

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

@@ -7,14 +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 { mkdirSubcommand } from './mkdir';
-import { rmdirSubcommand } from './rmdir';
-import { rmSubcommand } from './rm';
-import { lsSubcommand } from './ls';
-import { downloadSubcommand } from './download';
-import { uploadSubcommand } from './upload';
+import { command as jobCommand } from './job';
 import { envSubcommand } from './env';
 import { pauseSubcommand } from './pause';
 import { resumeSubcommand } from './resume';
@@ -51,14 +46,9 @@ export const command = createCommand({
 		deleteSubcommand,
 		snapshotCommand,
 		runtimeCommand,
-		cpSubcommand,
+		fsCommand,
 		executionCommand,
-		mkdirSubcommand,
-		rmdirSubcommand,
-		rmSubcommand,
-		lsSubcommand,
-		downloadSubcommand,
-		uploadSubcommand,
+		jobCommand,
 		envSubcommand,
 		pauseSubcommand,
 		resumeSubcommand,

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

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
+import { jobCreate, sandboxResolve } from '@agentuity/server';
+
+export const createSubcommand = createCommand({
+	name: 'create',
+	aliases: ['new'],
+	description: 'Create a background job in a sandbox',
+	tags: ['requires-auth'],
+	requires: { auth: true, apiClient: true },
+	examples: [
+		{
+			command: getCommand('cloud sandbox job create sbx_abc123 -- bun run build'),
+			description: 'Create a background job',
+		},
+		{
+			command: getCommand('cloud sandbox job create sbx_abc123 -- npm install'),
+			description: 'Run npm install as a background job',
+		},
+	],
+
+	schema: {
+		args: z.object({
+			sandboxId: z.string().describe('Sandbox ID'),
+			command: z.array(z.string()).describe('Command and arguments to run as a background job'),
+		}),
+		options: z.object({}),
+	},
+
+	async handler(ctx) {
+		const { args, options, auth, logger, apiClient } = ctx;
+
+		const sandboxInfo = await sandboxResolve(apiClient, args.sandboxId);
+		const { region, orgId } = sandboxInfo;
+
+		const client = createSandboxClient(logger, auth, region);
+
+		const job = await jobCreate(client, {
+			sandboxId: args.sandboxId,
+			options: {
+				command: args.command,
+			},
+			orgId,
+		});
+
+		if (options.json) {
+			return job;
+		}
+
+		tui.success(`Created job ${tui.bold(job.jobId)}`);
+		tui.info(`Status: ${job.status}`);
+		tui.muted(
+			`Use 'agentuity cloud sandbox job get ${args.sandboxId} ${job.jobId}' to check status`
+		);
+
+		return job;
+	},
+});
+
+export default createSubcommand;

package/src/cmd/cloud/sandbox/job/destroy.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { getCommand } from '../../../../command-prefix';
+import { jobStop, sandboxResolve } from '@agentuity/server';
+
+export const destroySubcommand = createCommand({
+	name: 'destroy',
+	aliases: ['stop', 'terminate'],
+	description: 'Terminate a running job',
+	tags: ['requires-auth'],
+	requires: { auth: true, apiClient: true },
+	examples: [
+		{
+			command: getCommand('cloud sandbox job destroy sbx_abc123 job_xyz789'),
+			description: 'Terminate a job gracefully',
+		},
+		{
+			command: getCommand('cloud sandbox job destroy sbx_abc123 job_xyz789 --force'),
+			description: 'Force kill a job',
+		},
+	],
+
+	schema: {
+		args: z.object({
+			sandboxId: z.string().describe('Sandbox ID'),
+			jobId: z.string().describe('Job ID'),
+		}),
+		options: z.object({
+			force: z
+				.boolean()
+				.default(false)
+				.describe('Force kill the job (SIGKILL instead of SIGTERM)'),
+		}),
+	},
+
+	async handler(ctx) {
+		const { args, opts, options, auth, logger, apiClient } = ctx;
+
+		const sandboxInfo = await sandboxResolve(apiClient, args.sandboxId);
+		const { region, orgId } = sandboxInfo;
+
+		const client = createSandboxClient(logger, auth, region);
+
+		const job = await jobStop(client, {
+			sandboxId: args.sandboxId,
+			jobId: args.jobId,
+			force: opts.force,
+			orgId,
+		});
+
+		if (options.json) {
+			return job;
+		}
+
+		if (job.status === 'cancelled') {
+			tui.success(`Job ${tui.bold(job.jobId)} terminated`);
+		} else {
+			tui.info(`Job ${tui.bold(job.jobId)} status: ${job.status}`);
+		}
+
+		return job;
+	},
+});
+
+export default destroySubcommand;

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

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { jobGet, sandboxResolve } from '@agentuity/server';
+
+export const getSubcommand = createCommand({
+	name: 'get',
+	aliases: ['show', 'info'],
+	description: 'Get details of a specific job',
+	tags: ['read-only', 'requires-auth'],
+	requires: { auth: true, apiClient: true },
+
+	schema: {
+		args: z.object({
+			sandboxId: z.string().describe('Sandbox ID'),
+			jobId: z.string().describe('Job ID'),
+		}),
+		options: z.object({}),
+	},
+
+	async handler(ctx) {
+		const { args, options, auth, logger, apiClient } = ctx;
+
+		const sandboxInfo = await sandboxResolve(apiClient, args.sandboxId);
+		const { region, orgId } = sandboxInfo;
+
+		const client = createSandboxClient(logger, auth, region);
+
+		const job = await jobGet(client, {
+			sandboxId: args.sandboxId,
+			jobId: args.jobId,
+			orgId,
+		});
+
+		if (options.json) {
+			return job;
+		}
+
+		const statusText =
+			job.status === 'completed'
+				? tui.colorSuccess(job.status)
+				: job.status === 'failed'
+					? tui.colorError(job.status)
+					: job.status === 'running'
+						? tui.colorWarning(job.status)
+						: tui.colorMuted(job.status);
+
+		tui.info(`Job ${tui.bold(job.jobId)}`);
+		console.log('');
+		console.log(`  Status:     ${statusText}`);
+		console.log(`  Sandbox:    ${job.sandboxId}`);
+		console.log(`  Command:    ${job.command.join(' ')}`);
+
+		if (job.exitCode !== undefined && job.exitCode !== null) {
+			console.log(`  Exit code:  ${job.exitCode}`);
+		}
+		if (job.startedAt) {
+			console.log(`  Started:    ${job.startedAt}`);
+		}
+		if (job.completedAt) {
+			console.log(`  Completed:  ${job.completedAt}`);
+		}
+		if (job.error) {
+			console.log(`  Error:      ${tui.colorError(job.error)}`);
+		}
+		if (job.stdoutStreamUrl) {
+			console.log(`  Stdout:     ${job.stdoutStreamUrl}`);
+		}
+		if (job.stderrStreamUrl) {
+			console.log(`  Stderr:     ${job.stderrStreamUrl}`);
+		}
+
+		return job;
+	},
+});
+
+export default getSubcommand;

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

@@ -0,0 +1,31 @@
+import { createCommand } from '../../../../types';
+import { getSubcommand } from './get';
+import { listSubcommand } from './list';
+import { createSubcommand } from './create';
+import { destroySubcommand } from './destroy';
+import { getCommand } from '../../../../command-prefix';
+
+export const command = createCommand({
+	name: 'job',
+	aliases: ['jobs'],
+	description: 'Manage background jobs in a sandbox',
+	tags: ['requires-auth'],
+	examples: [
+		{
+			command: getCommand('cloud sandbox job create sbx_abc123 -- bun run build'),
+			description: 'Create a background job',
+		},
+		{
+			command: getCommand('cloud sandbox job list sbx_abc123'),
+			description: 'List jobs for a sandbox',
+		},
+		{
+			command: getCommand('cloud sandbox job destroy sbx_abc123 job_xyz789'),
+			description: 'Terminate a running job',
+		},
+	],
+	subcommands: [createSubcommand, getSubcommand, listSubcommand, destroySubcommand],
+	requires: { auth: true, org: true },
+});
+
+export default command;

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

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createSandboxClient } from '../util';
+import { jobList, sandboxResolve } from '@agentuity/server';
+
+export const listSubcommand = createCommand({
+	name: 'list',
+	description: 'List jobs for a sandbox',
+	tags: ['read-only', 'requires-auth'],
+	requires: { auth: true, apiClient: true },
+
+	schema: {
+		args: z.object({
+			sandboxId: z.string().describe('Sandbox ID'),
+		}),
+		options: z.object({
+			limit: z.coerce
+				.number()
+				.int()
+				.min(1)
+				.max(100)
+				.default(20)
+				.describe('Maximum number of jobs to list'),
+		}),
+	},
+
+	async handler(ctx) {
+		const { args, opts, options, auth, logger, apiClient } = ctx;
+
+		const sandboxInfo = await sandboxResolve(apiClient, args.sandboxId);
+		const { region, orgId } = sandboxInfo;
+
+		const client = createSandboxClient(logger, auth, region);
+
+		const result = await jobList(client, {
+			sandboxId: args.sandboxId,
+			orgId,
+			limit: opts.limit,
+		});
+
+		if (options.json) {
+			return result;
+		}
+
+		if (result.jobs.length === 0) {
+			tui.info('No jobs found');
+			return result;
+		}
+
+		tui.info(`Jobs for sandbox ${tui.bold(args.sandboxId)}:`);
+		console.log('');
+
+		for (const job of result.jobs) {
+			const statusText =
+				job.status === 'completed'
+					? tui.colorSuccess(job.status)
+					: job.status === 'failed'
+						? tui.colorError(job.status)
+						: job.status === 'running'
+							? tui.colorWarning(job.status)
+							: tui.colorMuted(job.status);
+			console.log(
+				`  ${tui.bold(job.jobId)} ${statusText} ${tui.colorMuted(job.command.join(' '))}`
+			);
+			if (job.exitCode !== undefined && job.exitCode !== null) {
+				console.log(`    Exit code: ${job.exitCode}`);
+			}
+			if (job.startedAt) {
+				console.log(`    Started: ${job.startedAt}`);
+			}
+			if (job.completedAt) {
+				console.log(`    Completed: ${job.completedAt}`);
+			}
+		}
+
+		return result;
+	},
+});
+
+export default listSubcommand;

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

@@ -4,7 +4,7 @@ import { getCommand } from '../../../../command-prefix';
 
 export const runtimeCommand = createCommand({
 	name: 'runtime',
-	aliases: ['rt'],
+	aliases: ['rt', 'runtimes'],
 	description: 'Manage sandbox runtimes',
 	tags: ['slow', 'requires-auth'],
 	examples: [

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

@@ -21,6 +21,7 @@ const SnapshotCreateResponseSchema = z.object({
 
 export const createSubcommand = createCommand({
 	name: 'create',
+	aliases: ['new'],
 	description: 'Create a snapshot from a sandbox',
 	tags: ['slow', 'requires-auth'],
 	requires: { auth: true, org: true },

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

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

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

@@ -10,7 +10,7 @@ import { getCommand } from '../../../../command-prefix';
 
 export const snapshotCommand = createCommand({
 	name: 'snapshot',
-	aliases: ['snap'],
+	aliases: ['snap', 'snapshots'],
 	description: 'Manage sandbox snapshots',
 	tags: ['slow', 'requires-auth'],
 	examples: [

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

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

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

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

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

@@ -19,6 +19,7 @@ const DeliveryGetResponseSchema = z.object({
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get delivery details',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true },

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

@@ -18,6 +18,7 @@ const CreateDestinationResponseSchema = z.object({
 
 export const createSubcommand = createCommand({
 	name: 'create',
+	aliases: ['new'],
 	description: 'Create destination for a schedule',
 	tags: ['mutating', 'creates-resource', 'requires-auth'],
 	requires: { auth: true },

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

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

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

@@ -18,6 +18,7 @@ const DestinationGetResponseSchema = z.object({
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get destination details',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true },

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

@@ -30,6 +30,7 @@ const ScheduleGetResponseSchema = z.object({
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get schedule details',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true },

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

@@ -108,6 +108,7 @@ function printTimeline(node: SpanNode, prefix: string, isLast = true): void {
 
 export const getSubcommand = createSubcommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get details about a specific session',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [

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

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

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

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

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

@@ -13,7 +13,7 @@ import { createS3Client } from './utils';
 
 export const deleteSubcommand = createSubcommand({
 	name: 'delete',
-	aliases: ['rm', 'del', 'remove'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete a storage resource, file, or folder',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth', 'requires-deployment'],
 	idempotent: false,

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

@@ -10,7 +10,7 @@ const DeleteStreamResponseSchema = z.object({
 
 export const deleteSubcommand = createCommand({
 	name: 'delete',
-	aliases: ['del', 'rm'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete a stream by ID (soft delete)',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	idempotent: true,

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

@@ -24,6 +24,7 @@ const GetStreamResponseSchema = z.object({
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get detailed information about a specific stream',
 	tags: ['read-only', 'slow', 'requires-auth'],
 	requires: { auth: true, apiClient: true },

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

@@ -60,7 +60,7 @@ const TaskDeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createCommand({
 	name: 'delete',
-	aliases: ['del', 'rm'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Soft-delete a task by ID or batch-delete tasks by filter',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	requires: { auth: true },

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

@@ -12,6 +12,7 @@ import { getCommand } from '../../../command-prefix';
 
 export const taskCommand = createCommand({
 	name: 'task',
+	aliases: ['tasks'],
 	description: 'Manage tasks for your projects',
 	tags: ['requires-auth', 'slow'],
 	examples: [

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

@@ -16,7 +16,7 @@ export const deleteSubcommand = createSubcommand({
 			description: 'Delete a thread by ID',
 		},
 	],
-	aliases: ['rm'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	requires: { auth: true },
 	schema: {
 		args: z.object({

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

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

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

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

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

@@ -18,6 +18,7 @@ const ThreadListResponseSchema = z.array(
 
 export const listSubcommand = createSubcommand({
 	name: 'list',
+	aliases: ['ls'],
 	description: 'List recent threads',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [
@@ -39,7 +40,6 @@ export const listSubcommand = createSubcommand({
 			description: 'List all threads regardless of project context',
 		},
 	],
-	aliases: ['ls'],
 	requires: { auth: true },
 	optional: { project: true },
 	idempotent: true,

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

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

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

@@ -15,7 +15,7 @@ const VectorDeleteResponseSchema = z.object({
 
 export const deleteSubcommand = createCommand({
 	name: 'delete',
-	aliases: ['del', 'rm'],
+	aliases: ['rm', 'del', 'remove', 'terminate'],
 	description: 'Delete one or more vectors by key',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	requires: { auth: true, region: true },

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

@@ -15,6 +15,7 @@ const VectorGetResponseSchema = z.object({
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get a specific vector entry by key',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true, region: true },

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

@@ -10,7 +10,7 @@ import { getCommand } from '../../../command-prefix';
 
 export const vectorCommand = createCommand({
 	name: 'vector',
-	aliases: ['vec'],
+	aliases: ['vec', 'vectors'],
 	description: 'Manage vector storage for your projects',
 	tags: ['requires-auth', 'slow'],
 	examples: [

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

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

package/src/cmd/cloud/webhook/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 webhook by ID',
 	tags: ['mutating', 'deletes-resource', 'requires-auth'],
 	requires: { auth: true },

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

@@ -7,6 +7,7 @@ import { getWebhook, WebhookSchema } from '@agentuity/server';
 
 export const getSubcommand = createCommand({
 	name: 'get',
+	aliases: ['show', 'info'],
 	description: 'Get webhook details',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true },