@agentuity/cli 1.0.35 → 1.0.37

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/cli",
-	"version": "1.0.35",
+	"version": "1.0.37",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -41,9 +41,9 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/auth": "1.0.35",
-		"@agentuity/core": "1.0.35",
-		"@agentuity/server": "1.0.35",
+		"@agentuity/auth": "1.0.37",
+		"@agentuity/core": "1.0.37",
+		"@agentuity/server": "1.0.37",
 		"@datasert/cronjs-parser": "^1.4.0",
 		"@vitejs/plugin-react": "^5.1.2",
 		"acorn-loose": "^8.5.2",
@@ -60,10 +60,10 @@
 		"typescript": "^5.9.0",
 		"vite": "^7.2.7",
 		"zod": "^4.3.5",
-		"@agentuity/frontend": "1.0.35"
+		"@agentuity/frontend": "1.0.37"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "1.0.35",
+		"@agentuity/test-utils": "1.0.37",
 		"@types/adm-zip": "^0.5.7",
 		"@types/bun": "latest",
 		"@types/tar-fs": "^2.0.4",

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

@@ -13,14 +13,14 @@ export const createNamespaceSubcommand = createCommand({
 	optional: { project: true },
 	examples: [
 		{
-			command: getCommand('kv create-namespace production'),
+			command: getCommand('cloud kv create-namespace production'),
 			description: 'Create production namespace',
 		},
 		{
-			command: getCommand('kv create staging'),
+			command: getCommand('cloud kv create staging'),
 			description: 'Create staging namespace (using alias)',
 		},
-		{ command: getCommand('kv create cache'), description: 'Create cache namespace' },
+		{ command: getCommand('cloud kv create cache'), description: 'Create cache namespace' },
 	],
 	schema: {
 		args: z.object({

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

@@ -14,21 +14,23 @@ export const deleteNamespaceSubcommand = createCommand({
 	optional: { project: true },
 	examples: [
 		{
-			command: getCommand('kv delete-namespace staging'),
+			command: getCommand('cloud kv delete-namespace staging'),
 			description: 'Delete staging namespace (interactive)',
 		},
 		{
-			command: getCommand('kv rm-namespace cache --confirm'),
+			command: getCommand('cloud kv rm-namespace cache --confirm'),
 			description: 'Delete cache without confirmation',
 		},
 		{
-			command: getCommand('kv delete-namespace production --confirm'),
+			command: getCommand('cloud kv delete-namespace production --confirm'),
 			description: 'Force delete production',
 		},
 	],
 	schema: {
 		args: z.object({
 			name: z.string().min(1).max(64).describe('the namespace name'),
+		}),
+		options: z.object({
 			confirm: z
 				.boolean()
 				.optional()
@@ -43,10 +45,10 @@ export const deleteNamespaceSubcommand = createCommand({
 	},
 
 	async handler(ctx) {
-		const { args } = ctx;
+		const { args, opts } = ctx;
 		const kv = await createStorageAdapter(ctx);
 
-		if (!args.confirm) {
+		if (!opts?.confirm) {
 			if (!process.stdin.isTTY) {
 				tui.fatal(
 					'No TTY and --confirm is not set. Refusing to delete',

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

@@ -19,10 +19,16 @@ export const deleteSubcommand = createCommand({
 	requires: { auth: true, region: true },
 	optional: { project: true },
 	examples: [
-		{ command: getCommand('kv delete production user:123'), description: 'Delete user data' },
-		{ command: getCommand('kv delete cache session:abc'), description: 'Delete cached session' },
 		{
-			command: getCommand('kv rm staging cache:homepage'),
+			command: getCommand('cloud kv delete production user:123'),
+			description: 'Delete user data',
+		},
+		{
+			command: getCommand('cloud kv delete cache session:abc'),
+			description: 'Delete cached session',
+		},
+		{
+			command: getCommand('cloud kv rm staging cache:homepage'),
 			description: 'Delete homepage cache (using alias)',
 		},
 	],

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

@@ -18,9 +18,12 @@ export const getSubcommand = createCommand({
 	requires: { auth: true, region: true },
 	optional: { project: true },
 	examples: [
-		{ command: getCommand('kv get production user:123'), description: 'Get user data' },
-		{ command: getCommand('kv get cache session:abc'), description: 'Get cached session' },
-		{ command: getCommand('kv get staging cache:homepage'), description: 'Get homepage cache' },
+		{ command: getCommand('cloud kv get production user:123'), description: 'Get user data' },
+		{ command: getCommand('cloud kv get cache session:abc'), description: 'Get cached session' },
+		{
+			command: getCommand('cloud kv get staging cache:homepage'),
+			description: 'Get homepage cache',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -17,9 +17,15 @@ export const keysSubcommand = createCommand({
 	optional: { project: true },
 	idempotent: true,
 	examples: [
-		{ command: getCommand('kv keys production'), description: 'List all keys in production' },
-		{ command: getCommand('kv ls cache'), description: 'List all cached keys (using alias)' },
-		{ command: getCommand('kv list staging'), description: 'List all staging keys' },
+		{
+			command: getCommand('cloud kv keys production'),
+			description: 'List all keys in production',
+		},
+		{
+			command: getCommand('cloud kv ls cache'),
+			description: 'List all cached keys (using alias)',
+		},
+		{ command: getCommand('cloud kv list staging'), description: 'List all staging keys' },
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/keyvalue/list-namespaces.ts

@@ -13,9 +13,9 @@ export const listNamespacesSubcommand = createCommand({
 	requires: { auth: true, region: true },
 	optional: { project: true },
 	examples: [
-		{ command: getCommand('kv list-namespaces'), description: 'List all namespaces' },
-		{ command: getCommand('kv namespaces'), description: 'List namespaces (using alias)' },
-		{ command: getCommand('kv ns'), description: 'List namespaces (short alias)' },
+		{ command: getCommand('cloud kv list-namespaces'), description: 'List all namespaces' },
+		{ command: getCommand('cloud kv namespaces'), description: 'List namespaces (using alias)' },
+		{ command: getCommand('cloud kv ns'), description: 'List namespaces (short alias)' },
 	],
 	schema: {
 		options: z.object({

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

@@ -13,7 +13,9 @@ export const replSubcommand = createCommand({
 	idempotent: false,
 	requires: { auth: true, region: true },
 	optional: { project: true },
-	examples: [{ command: getCommand('kv repl'), description: 'Start interactive KV session' }],
+	examples: [
+		{ command: getCommand('cloud kv repl'), description: 'Start interactive KV session' },
+	],
 
 	async handler(ctx) {
 		showBanner(undefined, true);

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

@@ -25,14 +25,17 @@ export const searchSubcommand = createCommand({
 	idempotent: true,
 	examples: [
 		{
-			command: getCommand('kv search production user'),
+			command: getCommand('cloud kv search production user'),
 			description: 'Find all user-related keys',
 		},
 		{
-			command: getCommand('kv search cache session'),
+			command: getCommand('cloud kv search cache session'),
 			description: 'Find all session keys in cache',
 		},
-		{ command: getCommand('kv search staging config'), description: 'Find all config keys' },
+		{
+			command: getCommand('cloud kv search staging config'),
+			description: 'Find all config keys',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -24,16 +24,16 @@ export const setSubcommand = createCommand({
 	examples: [
 		{
 			command: getCommand(
-				'kv set production user:123 \'{"name":"Alice","email":"alice@example.com"}\''
+				'cloud kv set production user:123 \'{"name":"Alice","email":"alice@example.com"}\''
 			),
 			description: 'Store user data',
 		},
 		{
-			command: getCommand('kv set cache session:abc "session-data-here" --ttl 3600'),
+			command: getCommand('cloud kv set cache session:abc "session-data-here" --ttl 3600'),
 			description: 'Store session with 1h TTL',
 		},
 		{
-			command: getCommand('kv set staging cache:homepage "<!DOCTYPE html>..." --ttl 600'),
+			command: getCommand('cloud kv set staging cache:homepage "<!DOCTYPE html>..." --ttl 600'),
 			description: 'Cache homepage for 10m',
 		},
 	],
@@ -42,6 +42,8 @@ export const setSubcommand = createCommand({
 			namespace: z.string().min(1).max(64).describe('the namespace name'),
 			key: z.string().min(1).max(64).describe('the key name'),
 			value: z.string().min(1).describe('the value'),
+		}),
+		options: z.object({
 			ttl: z.coerce
 				.number()
 				.refine((val) => val >= 0, {
@@ -54,11 +56,11 @@ export const setSubcommand = createCommand({
 	},
 
 	async handler(ctx) {
-		const { args, options } = ctx;
+		const { args, opts, options } = ctx;
 		const started = Date.now();
 		const storage = await createStorageAdapter(ctx);
 		const contentType = isPossiblyJSON(args.value) ? 'application/json' : 'text/plain';
-		const ttl = args.ttl;
+		const ttl = opts?.ttl;
 		await storage.set(args.namespace, args.key, args.value, {
 			contentType,
 			ttl,

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

@@ -40,12 +40,15 @@ export const statsSubcommand = createCommand({
 	optional: { project: true },
 	idempotent: true,
 	examples: [
-		{ command: getCommand('kv stats'), description: 'Show stats for all namespaces' },
+		{ command: getCommand('cloud kv stats'), description: 'Show stats for all namespaces' },
 		{
-			command: getCommand('kv stats production'),
+			command: getCommand('cloud kv stats production'),
 			description: 'Show stats for production namespace',
 		},
-		{ command: getCommand('kv stats cache'), description: 'Show stats for cache namespace' },
+		{
+			command: getCommand('cloud kv stats cache'),
+			description: 'Show stats for cache namespace',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -3,6 +3,7 @@ import { createSubcommand, createCommand } from '../../../types';
 import { getCommand } from '../../../command-prefix';
 import { saveRegion, clearRegion } from '../../../config';
 import * as tui from '../../../tui';
+import { listSubcommand } from './list';
 
 const selectCommand = createSubcommand({
 	name: 'select',
@@ -150,8 +151,9 @@ export const regionSubcommand = createCommand({
 	description: 'Manage default cloud region preference',
 	tags: ['fast'],
 	examples: [
+		{ command: getCommand('cloud region list'), description: 'List available regions' },
 		{ command: getCommand('cloud region select'), description: 'Set default region' },
 		{ command: getCommand('cloud region current'), description: 'Show current default' },
 	],
-	subcommands: [selectCommand, unselectCommand, currentCommand],
+	subcommands: [listSubcommand, selectCommand, unselectCommand, currentCommand],
 });

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

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { createSubcommand } from '../../../types';
+import { getCommand } from '../../../command-prefix';
+import * as tui from '../../../tui';
+
+const RegionSchema = z.object({
+	region: z.string().describe('Region code'),
+	description: z.string().describe('Human-readable region description'),
+	default: z.boolean().describe('Whether this is the default region'),
+});
+
+export const listSubcommand = createSubcommand({
+	name: 'list',
+	description: 'List available cloud regions',
+	aliases: ['ls'],
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true, regions: true },
+	idempotent: true,
+	examples: [
+		{ command: getCommand('cloud region list'), description: 'List all available regions' },
+		{
+			command: getCommand('cloud region ls'),
+			description: 'List all available regions (short alias)',
+		},
+		{
+			command: getCommand('--json cloud region list'),
+			description: 'List regions in JSON format',
+		},
+	],
+	schema: {
+		response: z.array(RegionSchema),
+	},
+
+	async handler(ctx) {
+		const { regions, options, config } = ctx;
+		const defaultRegion = config?.preferences?.region ?? null;
+
+		const result = regions.map((r) => ({
+			region: r.region,
+			description: r.description,
+			default: r.region === defaultRegion,
+		}));
+
+		if (!options.json) {
+			tui.info(`Regions (${regions.length})`);
+
+			const tableData = regions.map((r) => ({
+				Code: r.region,
+				Description: r.description,
+				Default: r.region === defaultRegion ? 'Yes' : '',
+			}));
+
+			tui.table(tableData, [
+				{ name: 'Code', alignment: 'left' },
+				{ name: 'Description', alignment: 'left' },
+				{ name: 'Default', alignment: 'center' },
+			]);
+		}
+
+		return result;
+	},
+});

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

@@ -42,6 +42,10 @@ const SandboxCpResponseSchema = z.object({
 	destination: z.string().describe('Destination path'),
 	bytesTransferred: z.number().describe('Number of bytes transferred'),
 	filesTransferred: z.number().describe('Number of files transferred'),
+	directoriesCreated: z
+		.array(z.string())
+		.optional()
+		.describe('Parent directories auto-created on the destination'),
 });
 
 export const cpSubcommand = createCommand({
@@ -156,6 +160,30 @@ function getAllFiles(dirPath: string, basePath: string = dirPath): string[] {
 	return files;
 }
 
+/**
+ * Computes the parent directories that would be auto-created by the server
+ * when writing files to the given paths. Filters out directories that always
+ * exist in a sandbox (/, /home, /home/agentuity).
+ */
+function getImplicitDirectories(filePaths: string[]): string[] {
+	const dirs = new Set<string>();
+	// Directories that always exist in a sandbox
+	const knownDirs = new Set(['/', '/home', '/home/agentuity']);
+
+	for (const filePath of filePaths) {
+		let dir = dirname(filePath);
+		while (dir && dir !== '.' && dir !== '/') {
+			if (!knownDirs.has(dir)) {
+				dirs.add(dir);
+			}
+			const parent = dirname(dir);
+			if (parent === dir) break;
+			dir = parent;
+		}
+	}
+	return Array.from(dirs).sort();
+}
+
 async function uploadToSandbox(
 	client: APIClient,
 	logger: Logger,
@@ -234,11 +262,13 @@ async function uploadSingleFile(
 		tui.success(`Copied ${displayPath} → ${sandboxId}:${targetPath} (${buffer.length} bytes)`);
 	}
 
+	const implicitDirs = getImplicitDirectories([targetPath]);
 	return {
 		source: displayPath,
 		destination: `${sandboxId}:${targetPath}`,
 		bytesTransferred: buffer.length,
 		filesTransferred: 1,
+		directoriesCreated: implicitDirs.length > 0 ? implicitDirs : undefined,
 	};
 }
 
@@ -281,11 +311,13 @@ async function uploadDirectory(
 		);
 	}
 
+	const implicitDirs = getImplicitDirectories(files.map((f) => f.path));
 	return {
 		source: localDir,
 		destination: `${sandboxId}:${baseRemotePath}`,
 		bytesTransferred: totalBytes,
 		filesTransferred: allFiles.length,
+		directoriesCreated: implicitDirs.length > 0 ? implicitDirs : undefined,
 	};
 }
 

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

@@ -15,6 +15,14 @@ const SandboxExecResponseSchema = z.object({
 	status: z.string().describe('Execution status'),
 	exitCode: z.number().optional().describe('Exit code (if completed)'),
 	durationMs: z.number().optional().describe('Duration in milliseconds (if completed)'),
+	stdout: z
+		.string()
+		.optional()
+		.describe('Standard output (only when separate streams are available)'),
+	stderr: z
+		.string()
+		.optional()
+		.describe('Standard error output (only when separate streams are available)'),
 	output: z.string().optional().describe('Combined stdout/stderr output'),
 });
 
@@ -68,16 +76,6 @@ export const execSubcommand = createCommand({
 		process.on('SIGINT', handleSignal);
 		process.on('SIGTERM', handleSignal);
 
-		const outputChunks: string[] = [];
-
-		// For JSON output, capture to buffer; otherwise stream to process
-		const stdout = options.json
-			? createCaptureStream((chunk) => outputChunks.push(chunk))
-			: process.stdout;
-		const stderr = options.json
-			? createCaptureStream((chunk) => outputChunks.push(chunk))
-			: process.stderr;
-
 		try {
 			const execution = await sandboxExecute(client, {
 				sandboxId: args.sandboxId,
@@ -98,24 +96,69 @@ export const execSubcommand = createCommand({
 			const isCombinedOutput =
 				stdoutStreamUrl && stderrStreamUrl && stdoutStreamUrl === stderrStreamUrl;
 
+			// Set up stream capture — in JSON mode, capture to buffers;
+			// when streams are separate, capture stdout/stderr independently
+			const outputChunks: string[] = [];
+			const stdoutChunks: string[] = [];
+			const stderrChunks: string[] = [];
+
+			let stdoutWritable: NodeJS.WritableStream;
+			let stderrWritable: NodeJS.WritableStream;
+
+			if (options.json) {
+				if (isCombinedOutput) {
+					// Combined stream: can't distinguish stdout from stderr
+					stdoutWritable = createCaptureStream((chunk) => outputChunks.push(chunk));
+					stderrWritable = createCaptureStream((chunk) => outputChunks.push(chunk));
+				} else {
+					// Separate streams: capture each independently and also to combined output
+					stdoutWritable = createCaptureStream((chunk) => {
+						stdoutChunks.push(chunk);
+						outputChunks.push(chunk);
+					});
+					stderrWritable = createCaptureStream((chunk) => {
+						stderrChunks.push(chunk);
+						outputChunks.push(chunk);
+					});
+				}
+			} else {
+				stdoutWritable = process.stdout;
+				stderrWritable = process.stderr;
+			}
+
 			if (isCombinedOutput) {
 				// Stream combined output to stdout only to avoid duplicates
 				logger.debug('using combined output stream (stdout === stderr): %s', stdoutStreamUrl);
 				streamPromises.push(
-					streamUrlToWritable(stdoutStreamUrl, stdout, streamAbortController.signal, logger)
+					streamUrlToWritable(
+						stdoutStreamUrl,
+						stdoutWritable,
+						streamAbortController.signal,
+						logger
+					)
 				);
 			} else {
 				if (stdoutStreamUrl) {
 					logger.debug('starting stdout stream from: %s', stdoutStreamUrl);
 					streamPromises.push(
-						streamUrlToWritable(stdoutStreamUrl, stdout, streamAbortController.signal, logger)
+						streamUrlToWritable(
+							stdoutStreamUrl,
+							stdoutWritable,
+							streamAbortController.signal,
+							logger
+						)
 					);
 				}
 
 				if (stderrStreamUrl) {
 					logger.debug('starting stderr stream from: %s', stderrStreamUrl);
 					streamPromises.push(
-						streamUrlToWritable(stderrStreamUrl, stderr, streamAbortController.signal, logger)
+						streamUrlToWritable(
+							stderrStreamUrl,
+							stderrWritable,
+							streamAbortController.signal,
+							logger
+						)
 					);
 				}
 			}
@@ -145,6 +188,10 @@ export const execSubcommand = createCommand({
 
 			const duration = Date.now() - started;
 			const output = outputChunks.join('');
+			const stdoutOutput =
+				!isCombinedOutput && stdoutStreamUrl ? stdoutChunks.join('') : undefined;
+			const stderrOutput =
+				!isCombinedOutput && stderrStreamUrl ? stderrChunks.join('') : undefined;
 
 			if (!options.json) {
 				if (finalExecution.exitCode === 0) {
@@ -163,6 +210,8 @@ export const execSubcommand = createCommand({
 				status: finalExecution.status,
 				exitCode: finalExecution.exitCode,
 				durationMs: finalExecution.durationMs,
+				stdout: options.json ? stdoutOutput : undefined,
+				stderr: options.json ? stderrOutput : undefined,
 				output: options.json ? output : undefined,
 			};
 		} finally {

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

@@ -18,6 +18,10 @@ const TaskCreateResponseSchema = z.object({
 		status: z.string().describe('Task status'),
 		priority: z.string().describe('Task priority'),
 		created_at: z.string().describe('Creation timestamp'),
+		tags: z
+			.array(z.object({ id: z.string(), name: z.string() }))
+			.optional()
+			.describe('Tags attached to the task'),
 	}),
 	attachment: z
 		.object({
@@ -47,6 +51,12 @@ export const createSubcommand = createCommand({
 			),
 			description: 'Create a feature with priority and description',
 		},
+		{
+			command: getCommand(
+				'cloud task create "Fix login bug" --type bug --tag sandbox --tag regression'
+			),
+			description: 'Create a task with tags (auto-creates tags that do not exist)',
+		},
 		{
 			command: getCommand(
 				'cloud task create "Q1 Planning" --type epic --created-id agent_001 --metadata \'{"team":"engineering"}\''
@@ -90,6 +100,10 @@ export const createSubcommand = createCommand({
 				.describe('initial task status (default: open)'),
 			parentId: z.string().optional().describe('parent task ID for subtasks'),
 			assignedId: z.string().optional().describe('ID of the assigned agent or user'),
+			tag: z
+				.array(z.string())
+				.optional()
+				.describe('tag name to attach (repeatable, auto-creates missing tags)'),
 			metadata: z.string().optional().describe('JSON metadata object'),
 			file: z.string().optional().describe('file path to attach to the task'),
 		}),
@@ -172,6 +186,7 @@ export const createSubcommand = createCommand({
 			status: opts.status as TaskStatus,
 			parent_id: opts.parentId,
 			assigned_id: opts.assignedId,
+			tag_ids: opts.tag,
 			metadata,
 		});
 
@@ -228,6 +243,10 @@ export const createSubcommand = createCommand({
 				tableData['Description'] = task.description;
 			}
 
+			if (task.tags?.length) {
+				tableData['Tags'] = task.tags.map((t) => t.name).join(', ');
+			}
+
 			if (project) {
 				tableData['Project'] = project.name;
 			}
@@ -248,6 +267,9 @@ export const createSubcommand = createCommand({
 				status: task.status,
 				priority: task.priority,
 				created_at: task.created_at,
+				...(task.tags?.length
+					? { tags: task.tags.map((t) => ({ id: t.id, name: t.name })) }
+					: {}),
 			},
 			...(attachmentInfo ? { attachment: attachmentInfo } : {}),
 			durationMs,