@agentuity/cli 1.0.24 → 1.0.26

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

@@ -1,9 +1,13 @@
+import { basename, join } from 'path';
 import { z } from 'zod';
 import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter, parseMetadataFlag, cacheTaskId } from './util';
 import { getCommand } from '../../../command-prefix';
+import { whoami } from '@agentuity/server';
 import type { TaskPriority, TaskStatus, TaskType } from '@agentuity/core';
+import { getCachedUserInfo, setCachedUserInfo } from '../../../cache';
+import { defaultProfileName } from '../../../config';
 
 const TaskCreateResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
@@ -15,6 +19,13 @@ const TaskCreateResponseSchema = z.object({
 		priority: z.string().describe('Task priority'),
 		created_at: z.string().describe('Creation timestamp'),
 	}),
+	attachment: z
+		.object({
+			id: z.string().describe('Attachment ID'),
+			filename: z.string().describe('Attached filename'),
+		})
+		.optional()
+		.describe('Attached file info (when --file is used)'),
 	durationMs: z.number().describe('Operation duration in milliseconds'),
 });
 
@@ -23,7 +34,8 @@ export const createSubcommand = createCommand({
 	aliases: ['new', 'add'],
 	description: 'Create a new task',
 	tags: ['mutating', 'slow', 'requires-auth'],
-	requires: { auth: true },
+	requires: { auth: true, apiClient: true },
+	optional: { project: true },
 	examples: [
 		{
 			command: getCommand('cloud task create "Fix login bug" --type bug --created-id agent_001'),
@@ -48,19 +60,34 @@ export const createSubcommand = createCommand({
 		}),
 		options: z.object({
 			type: z.enum(['epic', 'feature', 'enhancement', 'bug', 'task']).describe('the task type'),
-			createdId: z.string().min(1).describe('the ID of the creator (agent or user)'),
+			createdId: z
+				.string()
+				.min(1)
+				.optional()
+				.describe('the ID of the creator (agent or user, defaults to authenticated user)'),
+			createdName: z
+				.string()
+				.min(1)
+				.optional()
+				.describe('the display name of the creator (used with --created-id)'),
+			projectId: z.string().optional().describe('project ID to associate with the task'),
+			projectName: z
+				.string()
+				.optional()
+				.describe('project display name (used with --project-id)'),
 			description: z.string().optional().describe('task description'),
 			priority: z
 				.enum(['high', 'medium', 'low', 'none'])
 				.optional()
 				.describe('task priority (default: none)'),
 			status: z
-				.enum(['open', 'in_progress', 'closed'])
+				.enum(['open', 'in_progress', 'closed', 'done', 'cancelled'])
 				.optional()
 				.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'),
 			metadata: z.string().optional().describe('JSON metadata object'),
+			file: z.string().optional().describe('file path to attach to the task'),
 		}),
 		response: TaskCreateResponseSchema,
 	},
@@ -72,10 +99,65 @@ export const createSubcommand = createCommand({
 
 		const metadata = parseMetadataFlag(opts.metadata);
 
+		// Resolve creator info
+		const createdId = opts.createdId ?? ctx.auth.userId;
+		let creator: { id: string; name: string } | undefined;
+		if (opts.createdId && opts.createdName) {
+			// Explicit creator with name
+			creator = { id: opts.createdId, name: opts.createdName };
+		} else if (!opts.createdId) {
+			// Using auth userId — check cache first, then fall back to whoami API call
+			const profileName = ctx.config?.name ?? defaultProfileName;
+			const cached = getCachedUserInfo(profileName);
+			if (cached) {
+				const name = [cached.firstName, cached.lastName].filter(Boolean).join(' ');
+				if (name) {
+					creator = { id: createdId, name };
+				}
+			} else {
+				// Fetch from API and cache
+				try {
+					const user = await whoami(ctx.apiClient);
+					const name = [user.firstName, user.lastName].filter(Boolean).join(' ');
+					if (name) {
+						creator = { id: createdId, name };
+					}
+					setCachedUserInfo(profileName, createdId, user.firstName, user.lastName);
+				} catch {
+					// Fall back to no creator EntityRef — task DB will use id as name
+				}
+			}
+		}
+
+		// Resolve project info
+		let project: { id: string; name: string } | undefined;
+		if (opts.projectId) {
+			// Explicit project via flags
+			project = { id: opts.projectId, name: opts.projectName ?? opts.projectId };
+		} else if (ctx.project?.projectId) {
+			// Auto-detect from project context — read name from package.json
+			let projectName = ctx.project.projectId;
+			try {
+				const pkgPath = join(ctx.projectDir, 'package.json');
+				const pkgFile = Bun.file(pkgPath);
+				if (await pkgFile.exists()) {
+					const pkg = await pkgFile.json();
+					if (pkg.name) {
+						projectName = pkg.name;
+					}
+				}
+			} catch {
+				// Fall back to projectId as name
+			}
+			project = { id: ctx.project.projectId, name: projectName };
+		}
+
 		const task = await storage.create({
 			title: args.title,
 			type: opts.type as TaskType,
-			created_id: opts.createdId,
+			created_id: createdId,
+			creator,
+			project,
 			description: opts.description,
 			priority: opts.priority as TaskPriority,
 			status: opts.status as TaskStatus,
@@ -84,9 +166,44 @@ export const createSubcommand = createCommand({
 			metadata,
 		});
 
-		const durationMs = Date.now() - started;
 		await cacheTaskId(ctx, task.id);
 
+		// Handle --file attachment
+		let attachmentInfo: { id: string; filename: string } | undefined;
+		if (opts.file) {
+			const file = Bun.file(opts.file);
+			if (!(await file.exists())) {
+				tui.fatal(`File not found: ${opts.file}`);
+			}
+
+			const filename = basename(opts.file);
+			const contentType = file.type || 'application/octet-stream';
+			const size = file.size;
+
+			const presign = await storage.uploadAttachment(task.id, {
+				filename,
+				content_type: contentType,
+				size,
+			});
+
+			const uploadResponse = await fetch(presign.presigned_url, {
+				method: 'PUT',
+				body: file.stream(),
+				headers: {
+					'Content-Type': contentType,
+				},
+				duplex: 'half',
+			});
+			if (!uploadResponse.ok) {
+				tui.fatal(`Attachment upload failed: ${uploadResponse.statusText}`);
+			}
+
+			const attachment = await storage.confirmAttachment(presign.attachment.id);
+			attachmentInfo = { id: attachment.id, filename: attachment.filename };
+		}
+
+		const durationMs = Date.now() - started;
+
 		if (!options.json) {
 			tui.success(`Task created: ${tui.bold(task.id)}`);
 
@@ -102,6 +219,14 @@ export const createSubcommand = createCommand({
 				tableData['Description'] = task.description;
 			}
 
+			if (project) {
+				tableData['Project'] = project.name;
+			}
+
+			if (attachmentInfo) {
+				tableData['Attachment'] = `${attachmentInfo.filename} (${attachmentInfo.id})`;
+			}
+
 			tui.table([tableData], Object.keys(tableData), { layout: 'vertical', padStart: '  ' });
 		}
 
@@ -115,6 +240,7 @@ export const createSubcommand = createCommand({
 				priority: task.priority,
 				created_at: task.created_at,
 			},
+			...(attachmentInfo ? { attachment: attachmentInfo } : {}),
 			durationMs,
 		};
 	},

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

@@ -4,6 +4,13 @@ import * as tui from '../../../tui';
 import { createStorageAdapter, cacheTaskId } from './util';
 import { getCommand } from '../../../command-prefix';
 
+const EntityRefSchema = z
+	.object({
+		id: z.string(),
+		name: z.string(),
+	})
+	.optional();
+
 const TaskGetResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	task: z.object({
@@ -14,15 +21,17 @@ const TaskGetResponseSchema = z.object({
 		status: z.string().describe('Task status'),
 		priority: z.string().describe('Task priority'),
 		parent_id: z.string().optional().describe('Parent task ID'),
-		assigned_id: z.string().optional().describe('Assigned agent or user ID'),
-		created_id: z.string().describe('Creator ID'),
-		closed_id: z.string().optional().describe('Closer ID'),
+		creator: EntityRefSchema.describe('Creator'),
+		assignee: EntityRefSchema.describe('Assignee'),
+		closer: EntityRefSchema.describe('Closer'),
+		project: EntityRefSchema.describe('Project'),
 		metadata: z.record(z.string(), z.unknown()).optional().describe('Task metadata'),
 		created_at: z.string().describe('Creation timestamp'),
 		updated_at: z.string().describe('Last update timestamp'),
 		open_date: z.string().optional().describe('Date task was opened'),
 		in_progress_date: z.string().optional().describe('Date task moved to in-progress'),
 		closed_date: z.string().optional().describe('Date task was closed'),
+		cancelled_date: z.string().optional().describe('Date task was cancelled'),
 	}),
 	durationMs: z.number().describe('Operation duration in milliseconds'),
 });
@@ -78,16 +87,20 @@ export const getSubcommand = createCommand({
 				tableData['Description'] = task.description;
 			}
 
-			tableData['Creator'] = task.created_id;
-
-			if (task.assigned_id) {
-				tableData['Assigned'] = task.assigned_id;
+			if (task.creator) {
+				tableData['Creator'] = `${task.creator.name} (${task.creator.id})`;
+			}
+			if (task.assignee) {
+				tableData['Assigned'] = `${task.assignee.name} (${task.assignee.id})`;
+			}
+			if (task.project) {
+				tableData['Project'] = `${task.project.name} (${task.project.id})`;
 			}
 			if (task.parent_id) {
 				tableData['Parent'] = task.parent_id;
 			}
-			if (task.closed_id) {
-				tableData['Closed By'] = task.closed_id;
+			if (task.closer) {
+				tableData['Closed By'] = `${task.closer.name} (${task.closer.id})`;
 			}
 
 			tableData['Created'] = new Date(task.created_at).toLocaleString();
@@ -102,6 +115,9 @@ export const getSubcommand = createCommand({
 			if (task.closed_date) {
 				tableData['Closed'] = new Date(task.closed_date).toLocaleString();
 			}
+			if (task.cancelled_date) {
+				tableData['Cancelled'] = new Date(task.cancelled_date).toLocaleString();
+			}
 			tui.table([tableData], Object.keys(tableData), { layout: 'vertical', padStart: '  ' });
 
 			if (task.metadata && Object.keys(task.metadata).length > 0) {
@@ -121,15 +137,17 @@ export const getSubcommand = createCommand({
 				status: task.status,
 				priority: task.priority,
 				parent_id: task.parent_id,
-				assigned_id: task.assigned_id,
-				created_id: task.created_id,
-				closed_id: task.closed_id,
+				creator: task.creator,
+				assignee: task.assignee,
+				closer: task.closer,
+				project: task.project,
 				metadata: task.metadata,
 				created_at: task.created_at,
 				updated_at: task.updated_at,
 				open_date: task.open_date,
 				in_progress_date: task.in_progress_date,
 				closed_date: task.closed_date,
+				cancelled_date: task.cancelled_date,
 			},
 			durationMs,
 		};

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

@@ -4,6 +4,7 @@ import { createSubcommand } from './create';
 import { updateSubcommand } from './update';
 import { listSubcommand } from './list';
 import { statsSubcommand } from './stats';
+import { attachmentSubcommand } from './attachment';
 import { getCommand } from '../../../command-prefix';
 
 export const taskCommand = createCommand({
@@ -27,8 +28,19 @@ export const taskCommand = createCommand({
 			command: getCommand('cloud task update task_abc123 --status in_progress'),
 			description: 'Update task status',
 		},
+		{
+			command: getCommand('cloud task attachment upload task_abc123 ./report.pdf'),
+			description: 'Upload a file attachment to a task',
+		},
+	],
+	subcommands: [
+		getSubcommand,
+		createSubcommand,
+		updateSubcommand,
+		listSubcommand,
+		statsSubcommand,
+		attachmentSubcommand,
 	],
-	subcommands: [getSubcommand, createSubcommand, updateSubcommand, listSubcommand, statsSubcommand],
 	requires: { auth: true },
 });
 

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

@@ -14,7 +14,24 @@ const TaskListResponseSchema = z.object({
 			type: z.string(),
 			status: z.string(),
 			priority: z.string(),
-			assigned_id: z.string().optional(),
+			creator: z
+				.object({
+					id: z.string(),
+					name: z.string(),
+				})
+				.optional(),
+			assignee: z
+				.object({
+					id: z.string(),
+					name: z.string(),
+				})
+				.optional(),
+			project: z
+				.object({
+					id: z.string(),
+					name: z.string(),
+				})
+				.optional(),
 			created_at: z.string(),
 			updated_at: z.string(),
 		})
@@ -35,7 +52,9 @@ const PRIORITY_COLORS: Record<string, (s: string) => string> = {
 const STATUS_COLORS: Record<string, (s: string) => string> = {
 	open: tui.colorSuccess,
 	in_progress: tui.colorWarning,
+	done: tui.colorInfo,
 	closed: tui.muted,
+	cancelled: tui.muted,
 };
 
 function formatPriority(p: string): string {
@@ -86,7 +105,10 @@ export const listSubcommand = createCommand({
 	],
 	schema: {
 		options: z.object({
-			status: z.enum(['open', 'in_progress', 'closed']).optional().describe('filter by status'),
+			status: z
+				.enum(['open', 'in_progress', 'done', 'closed', 'cancelled'])
+				.optional()
+				.describe('filter by status'),
 			type: z
 				.enum(['epic', 'feature', 'enhancement', 'bug', 'task'])
 				.optional()
@@ -98,17 +120,7 @@ export const listSubcommand = createCommand({
 			assignedId: z.string().optional().describe('filter by assigned agent or user ID'),
 			parentId: z.string().optional().describe('filter by parent task ID'),
 			sort: z
-				.enum([
-					'created_at',
-					'updated_at',
-					'priority',
-					'status',
-					'title',
-					'type',
-					'open_date',
-					'in_progress_date',
-					'closed_date',
-				])
+				.enum(['created_at', 'updated_at', 'priority'])
 				.optional()
 				.describe('field to sort by (default: created_at)'),
 			order: z.enum(['asc', 'desc']).optional().describe('sort order (default: desc)'),
@@ -147,7 +159,8 @@ export const listSubcommand = createCommand({
 					Type: task.type,
 					Status: formatStatus(task.status),
 					Priority: formatPriority(task.priority),
-					Assigned: task.assigned_id ?? tui.muted('—'),
+					Creator: task.creator?.name ? truncate(task.creator.name, 20) : tui.muted('—'),
+					Assigned: task.assignee?.name ? truncate(task.assignee.name, 20) : tui.muted('—'),
 					Updated: new Date(task.updated_at).toLocaleDateString(),
 				}));
 
@@ -157,6 +170,7 @@ export const listSubcommand = createCommand({
 					{ name: 'Type', alignment: 'left' },
 					{ name: 'Status', alignment: 'left' },
 					{ name: 'Priority', alignment: 'left' },
+					{ name: 'Creator', alignment: 'left' },
 					{ name: 'Assigned', alignment: 'left' },
 					{ name: 'Updated', alignment: 'left' },
 				]);
@@ -175,7 +189,9 @@ export const listSubcommand = createCommand({
 				type: task.type,
 				status: task.status,
 				priority: task.priority,
-				assigned_id: task.assigned_id,
+				creator: task.creator,
+				assignee: task.assignee,
+				project: task.project,
 				created_at: task.created_at,
 				updated_at: task.updated_at,
 			})),

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

@@ -21,10 +21,10 @@ function displayStats(data: ServiceStatsData): void {
 	tui.newline();
 	console.log(`  ${tui.muted('Total:')}           ${formatNumber(svc.total)}`);
 	console.log(`  ${tui.muted('Open:')}            ${formatNumber(svc.open)}`);
-	console.log(
-		`  ${tui.muted('In Progress:')}     ${formatNumber(svc.inProgress)}`
-	);
+	console.log(`  ${tui.muted('In Progress:')}     ${formatNumber(svc.inProgress)}`);
+	console.log(`  ${tui.muted('Done:')}            ${formatNumber(svc.done)}`);
 	console.log(`  ${tui.muted('Closed:')}          ${formatNumber(svc.closed)}`);
+	console.log(`  ${tui.muted('Cancelled:')}       ${formatNumber(svc.cancelled)}`);
 }
 
 export const statsSubcommand = createCommand({

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

@@ -15,8 +15,7 @@ export interface TaskContext {
 
 export async function createStorageAdapter(ctx: TaskContext) {
 	const orgId =
-		ctx.options.orgId ??
-		(process.env.AGENTUITY_CLOUD_ORG_ID || ctx.config?.preferences?.orgId);
+		ctx.options.orgId ?? (process.env.AGENTUITY_CLOUD_ORG_ID || ctx.config?.preferences?.orgId);
 	if (!orgId) {
 		tui.fatal('Organization ID is required. Use --org-id flag or set AGENTUITY_CLOUD_ORG_ID.');
 	}
@@ -47,8 +46,7 @@ export async function cacheTaskId(
 	const profileName = ctx.config?.name ?? defaultProfileName;
 	const region = await getDefaultRegion(profileName, ctx.config);
 	const orgId =
-		ctx.options.orgId ??
-		(process.env.AGENTUITY_CLOUD_ORG_ID || ctx.config?.preferences?.orgId);
+		ctx.options.orgId ?? (process.env.AGENTUITY_CLOUD_ORG_ID || ctx.config?.preferences?.orgId);
 	await setResourceInfo('task', profileName, taskId, region, orgId);
 }
 

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

@@ -5,7 +5,12 @@ import { createWebhookAPIClient, getWebhookApiOptions } from './util';
 import { getCommand } from '../../../command-prefix';
 import { createWebhook, WebhookSchema } from '@agentuity/server';
 
-const WebhookCreateResponseSchema = WebhookSchema.pick({ id: true, name: true, url: true, created_at: true });
+const WebhookCreateResponseSchema = WebhookSchema.pick({
+	id: true,
+	name: true,
+	url: true,
+	created_at: true,
+});
 
 export const createSubcommand = createCommand({
 	name: 'create',

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

@@ -130,11 +130,10 @@ const retryDeliverySubcommand = createSubcommand({
 
 		if (!options.json) {
 			tui.success(`Retried delivery: ${tui.bold(delivery.id)}`);
-			tui.table(
-				[{ ID: delivery.id, Status: delivery.status }],
-				['ID', 'Status'],
-				{ layout: 'vertical', padStart: '  ' }
-			);
+			tui.table([{ ID: delivery.id, Status: delivery.status }], ['ID', 'Status'], {
+				layout: 'vertical',
+				padStart: '  ',
+			});
 		}
 
 		return delivery;

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

@@ -59,10 +59,7 @@ const listDestinationsSubcommand = createSubcommand({
 			} else {
 				const tableData = destinations.map((d: WebhookDestination) => {
 					const config =
-						d.type === 'url' &&
-						d.config &&
-						typeof d.config === 'object' &&
-						'url' in d.config
+						d.type === 'url' && d.config && typeof d.config === 'object' && 'url' in d.config
 							? String((d.config as Record<string, unknown>).url)
 							: JSON.stringify(d.config);
 					return {
@@ -192,7 +189,9 @@ const updateDestinationSubcommand = createSubcommand({
 		if (!options.json) {
 			tui.success(`Updated destination: ${destination.id}`);
 			const url =
-				destination.config && typeof destination.config === 'object' && 'url' in destination.config
+				destination.config &&
+				typeof destination.config === 'object' &&
+				'url' in destination.config
 					? (destination.config as Record<string, unknown>).url
 					: JSON.stringify(destination.config);
 			console.log(`  URL: ${url}`);