@agentuity/cli 0.0.60 → 0.0.62

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

@@ -11,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: {

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: 'Set the DATABASE_URL environment secret',
+		},
+		{
+			command: getCommand('secret set STRIPE_SECRET_KEY "sk_live_..."'),
+			description: 'Set the STRIPE_SECRET_KEY environment secret',
+		},
 	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {

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

@@ -1,7 +1,13 @@
 import { z } from 'zod';
 import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
-import { sessionGet, type SpanNode, type EvalRun, type AgentInfo } from '@agentuity/server';
+import {
+	sessionGet,
+	type SpanNode,
+	type EvalRun,
+	type AgentInfo,
+	APIError,
+} from '@agentuity/server';
 import { getCommand } from '../../../command-prefix';
 import { ErrorCode } from '../../../errors';
 import { getCatalystAPIClient } from '../../../config';
@@ -104,7 +110,12 @@ 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 sess_abc123xyz'),
+			description: 'Get a session by ID',
+		},
+	],
 	requires: { auth: true },
 	idempotent: true,
 	schema: {
@@ -233,6 +244,9 @@ export const getSubcommand = createSubcommand({
 
 			return result;
 		} catch (ex) {
+			if (ex instanceof APIError && ex.status === 404) {
+				tui.fatal(`Session ${args.session_id} not found`, ErrorCode.RESOURCE_NOT_FOUND);
+			}
 			tui.fatal(
 				`Failed to get session: ${ex instanceof Error ? ex.message : String(ex)}`,
 				ErrorCode.API_ERROR

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

@@ -14,9 +14,18 @@ export const createSubcommand = defineSubcommand({
 	idempotent: false,
 	requires: { auth: true, org: true, region: true },
 	examples: [
-		getCommand('cloud storage create'),
-		getCommand('cloud storage new'),
-		getCommand('--dry-run cloud storage create'),
+		{
+			command: getCommand('cloud storage create'),
+			description: 'Create a new cloud storage bucket',
+		},
+		{
+			command: getCommand('cloud storage new'),
+			description: 'Alias for "cloud storage create" (shorthand "new")',
+		},
+		{
+			command: getCommand('--dry-run cloud storage create'),
+			description: 'Dry-run: display what would be created without making changes',
+		},
 	],
 	schema: {
 		response: z.object({

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

@@ -17,10 +17,22 @@ export const deleteSubcommand = createSubcommand({
 	idempotent: false,
 	requires: { auth: true, org: true, region: true },
 	examples: [
-		getCommand('cloud storage delete my-bucket'),
-		getCommand('cloud storage rm my-bucket file.txt'),
-		getCommand('cloud storage delete'),
-		getCommand('--dry-run cloud storage delete my-bucket'),
+		{
+			command: getCommand('cloud storage delete my-bucket'),
+			description: 'Delete a storage bucket',
+		},
+		{
+			command: getCommand('cloud storage rm my-bucket file.txt'),
+			description: 'Delete a file from a bucket',
+		},
+		{
+			command: getCommand('cloud storage delete'),
+			description: 'Interactive selection to delete a bucket',
+		},
+		{
+			command: getCommand('--dry-run cloud storage delete my-bucket'),
+			description: 'Dry-run: show what would be deleted without making changes',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -14,10 +14,22 @@ export const downloadSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud storage download')} my-bucket file.txt`,
-		`${getCommand('cloud storage download')} my-bucket file.txt output.txt`,
-		`${getCommand('cloud storage download')} my-bucket file.txt - > output.txt`,
-		`${getCommand('cloud storage download')} my-bucket file.txt --metadata`,
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt`,
+			description: 'Download file from bucket',
+		},
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt output.txt`,
+			description: 'Download file to specific path',
+		},
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt - > output.txt`,
+			description: 'Download file to stdout',
+		},
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt --metadata`,
+			description: 'Download metadata only',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -22,9 +22,18 @@ export const getSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud storage get')} my-bucket`,
-		`${getCommand('cloud storage show')} my-bucket`,
-		`${getCommand('cloud storage get')} my-bucket --show-credentials`,
+		{
+			command: `${getCommand('cloud storage get')} my-bucket`,
+			description: 'Get bucket details',
+		},
+		{
+			command: `${getCommand('cloud storage show')} my-bucket`,
+			description: 'Show bucket information',
+		},
+		{
+			command: `${getCommand('cloud storage get')} my-bucket --show-credentials`,
+			description: 'Get bucket with credentials',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -5,12 +5,20 @@ import { deleteSubcommand } from './delete';
 import { getSubcommand } from './get';
 import { uploadSubcommand } from './upload';
 import { downloadSubcommand } from './download';
+import { getCommand } from '../../../command-prefix';
 
 export const storageCommand = createCommand({
 	name: 'storage',
 	aliases: ['s3'],
 	description: 'Manage storage resources',
 	tags: ['slow', 'requires-auth', 'requires-deployment'],
+	examples: [
+		{ command: getCommand('cloud storage list'), description: 'List all storage resources' },
+		{
+			command: getCommand('cloud storage upload ./file.txt'),
+			description: 'Upload file to storage',
+		},
+	],
 	subcommands: [
 		createSubcommand,
 		listSubcommand,

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

@@ -40,12 +40,21 @@ export const listSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		getCommand('cloud storage list'),
-		getCommand('cloud storage list my-bucket'),
-		getCommand('cloud storage list my-bucket path/prefix'),
-		getCommand('--json cloud storage list'),
-		getCommand('cloud storage ls'),
-		getCommand('cloud storage list --show-credentials'),
+		{ command: getCommand('cloud storage list'), description: 'List items' },
+		{ command: getCommand('cloud storage list my-bucket'), description: 'List items' },
+		{
+			command: getCommand('cloud storage list my-bucket path/prefix'),
+			description: 'List items',
+		},
+		{
+			command: getCommand('--json cloud storage list'),
+			description: 'Show output in JSON format',
+		},
+		{ command: getCommand('cloud storage ls'), description: 'List items' },
+		{
+			command: getCommand('cloud storage list --show-credentials'),
+			description: 'Use show credentials option',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -59,6 +68,7 @@ export const listSubcommand = createSubcommand({
 				.describe(
 					'Show credentials in plain text (default: masked in terminal, unmasked in JSON)'
 				),
+			nameOnly: z.boolean().optional().describe('Print the name only'),
 		}),
 		response: StorageListResponseSchema,
 	},
@@ -118,14 +128,22 @@ export const listSubcommand = createSubcommand({
 				if (objects.length === 0) {
 					tui.info('No files found');
 				} else {
-					tui.info(
-						tui.bold(`Files in ${args.name}${args.prefix ? ` (prefix: ${args.prefix})` : ''}`)
-					);
-					tui.newline();
-					for (const obj of objects) {
-						console.log(
-							`${obj.key}  ${tui.muted(`(${obj.size} bytes, ${obj.lastModified})`)}`
+					if (opts.nameOnly) {
+						for (const obj of objects) {
+							console.log(obj.key);
+						}
+					} else {
+						tui.info(
+							tui.bold(
+								`Files in ${args.name}${args.prefix ? ` (prefix: ${args.prefix})` : ''}`
+							)
 						);
+						tui.newline();
+						for (const obj of objects) {
+							console.log(
+								`${obj.key}  ${tui.muted(`(${obj.size} bytes, ${obj.lastModified})`)}`
+							);
+						}
 					}
 				}
 			}
@@ -161,9 +179,15 @@ export const listSubcommand = createSubcommand({
 			if (resources.s3.length === 0) {
 				tui.info('No storage buckets found');
 			} else {
-				tui.info(tui.bold('Storage'));
-				tui.newline();
+				if (!opts.nameOnly) {
+					tui.info(tui.bold('Storage'));
+					tui.newline();
+				}
 				for (const s3 of resources.s3) {
+					if (opts.nameOnly) {
+						console.log(s3.bucket_name);
+						continue;
+					}
 					console.log(tui.bold(s3.bucket_name));
 					if (s3.access_key) {
 						const displayAccessKey = shouldMask

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

@@ -16,9 +16,18 @@ export const uploadSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: false,
 	examples: [
-		`${getCommand('cloud storage upload')} my-bucket file.txt`,
-		`${getCommand('cloud storage put')} my-bucket file.txt --content-type text/plain`,
-		`cat file.txt | ${getCommand('cloud storage upload')} my-bucket -`,
+		{
+			command: `${getCommand('cloud storage upload')} my-bucket file.txt`,
+			description: 'Upload file to bucket',
+		},
+		{
+			command: `${getCommand('cloud storage put')} my-bucket file.txt --content-type text/plain`,
+			description: 'Upload file with content type',
+		},
+		{
+			command: `cat file.txt | ${getCommand('cloud storage upload')} my-bucket -`,
+			description: 'Upload from stdin',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -66,18 +75,24 @@ export const uploadSubcommand = createSubcommand({
 			);
 		}
 
+		// TODO: we need to optimize this to not load the entire file in memory!
+
 		// Read file content
 		let fileContent: Buffer;
 		let actualFilename: string;
 
 		if (args.filename === '-') {
-			// Read from STDIN
-			const chunks: Buffer[] = [];
-			for await (const chunk of Bun.stdin.stream()) {
-				chunks.push(Buffer.from(chunk));
+			// Read from STDIN (binary-safe)
+			try {
+				const arrayBuffer = await Bun.readableStreamToArrayBuffer(Bun.stdin.stream());
+				fileContent = Buffer.from(arrayBuffer);
+				actualFilename = 'stdin';
+			} catch (error) {
+				tui.fatal(
+					`Cannot read from stdin: ${error instanceof Error ? error.message : String(error)}`,
+					ErrorCode.FILE_NOT_FOUND
+				);
 			}
-			fileContent = Buffer.concat(chunks);
-			actualFilename = 'stdin';
 		} else {
 			// Read from file
 			const file = Bun.file(args.filename);

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const DeleteStreamResponseSchema = z.object({
 	id: z.string().describe('Stream ID'),
 });
@@ -16,9 +15,15 @@ export const deleteSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('stream delete stream-id-123')} - Delete a stream`,
-		`${getCommand('stream rm stream-id-456')} - Delete stream (using alias)`,
-		`${getCommand('stream del stream-id-789')} - Delete stream (using alias)`,
+		{ command: getCommand('stream delete stream-id-123'), description: 'Delete a stream' },
+		{
+			command: getCommand('stream rm stream-id-456'),
+			description: 'Delete stream (using alias)',
+		},
+		{
+			command: getCommand('stream del stream-id-789'),
+			description: 'Delete stream (using alias)',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 function formatBytes(bytes: number): string {
 	if (bytes === 0) return '0 B';
 	if (bytes < 1024) return `${bytes} B`;
@@ -27,10 +26,16 @@ export const getSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('stream get stream-id-123')} - Get stream details`,
-		`${getCommand('stream get stream-id-123 --json')} - Get stream as JSON`,
-		`${getCommand('stream get stream-id-123 --output stream.dat')} - Download stream to file`,
-		`${getCommand('stream get stream-id-123 -o stream.dat')} - Download stream (short flag)`,
+		{ command: getCommand('stream get stream-id-123'), description: 'Get stream details' },
+		{ command: getCommand('stream get stream-id-123 --json'), description: 'Get stream as JSON' },
+		{
+			command: getCommand('stream get stream-id-123 --output stream.dat'),
+			description: 'Download stream to file',
+		},
+		{
+			command: getCommand('stream get stream-id-123 -o stream.dat'),
+			description: 'Download stream (short flag)',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -2,12 +2,17 @@ import { createCommand } from '../../../types';
 import listSubcommand from './list';
 import getSubcommand from './get';
 import deleteSubcommand from './delete';
+import { getCommand } from '../../../command-prefix';
 
 export const streamCommand = createCommand({
 	name: 'stream',
 	aliases: ['streams'],
 	description: 'Manage streams',
 	tags: ['slow', 'requires-auth'],
+	examples: [
+		{ command: getCommand('cloud stream list'), description: 'List all streams' },
+		{ command: getCommand('cloud stream get <id>'), description: 'Get stream details' },
+	],
 	subcommands: [listSubcommand, getSubcommand, deleteSubcommand],
 });
 

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 function formatBytes(bytes: number): string {
 	if (bytes === 0) return '0 B';
 	if (bytes < 1024) return `${bytes} B`;
@@ -33,11 +32,17 @@ export const listSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('stream list')} - List all streams`,
-		`${getCommand('stream ls --size 50')} - List 50 most recent streams`,
-		`${getCommand('stream list --name agent-logs')} - Filter by name`,
-		`${getCommand('stream list --metadata type=export')} - Filter by metadata`,
-		`${getCommand('stream ls --json')} - Output as JSON`,
+		{ command: getCommand('cloud stream list'), description: 'List all streams' },
+		{
+			command: getCommand('cloud stream ls --size 50'),
+			description: 'List 50 most recent streams',
+		},
+		{ command: getCommand('cloud stream list --name agent-logs'), description: 'Filter by name' },
+		{
+			command: getCommand('cloud stream list --metadata type=export'),
+			description: 'Filter by metadata',
+		},
+		{ command: getCommand('cloud stream ls --json'), description: 'Output as JSON' },
 	],
 	schema: {
 		options: z.object({

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

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { threadDelete, APIError } from '@agentuity/server';
+import { getCommand } from '../../../command-prefix';
+import { ErrorCode } from '../../../errors';
+import { getCatalystAPIClient } from '../../../config';
+
+export const deleteSubcommand = createSubcommand({
+	name: 'delete',
+	description: 'Delete a thread',
+	tags: ['destructive', 'requires-auth'],
+	examples: [
+		{
+			command: getCommand('cloud thread delete thrd_abc123xyz'),
+			description: 'Delete a thread by ID',
+		},
+	],
+	aliases: ['rm'],
+	requires: { auth: true },
+	schema: {
+		args: z.object({
+			thread_id: z.string().describe('Thread ID'),
+		}),
+	},
+	async handler(ctx) {
+		const { config, logger, auth, args } = ctx;
+		const catalystClient = getCatalystAPIClient(config, logger, auth);
+
+		try {
+			await threadDelete(catalystClient, { id: args.thread_id });
+			tui.success(`Thread ${args.thread_id} deleted successfully`);
+		} catch (ex) {
+			if (ex instanceof APIError && ex.status === 404) {
+				tui.fatal(`Thread ${args.thread_id} not found`, ErrorCode.RESOURCE_NOT_FOUND);
+				return;
+			}
+			tui.fatal(
+				`Failed to delete thread: ${ex instanceof Error ? ex.message : String(ex)}`,
+				ErrorCode.API_ERROR
+			);
+		}
+	},
+});