@agentuity/cli 3.0.0-alpha.7 → 3.0.0-beta.0

package/src/cmd/coder/get.ts

@@ -1,199 +0,0 @@
-import { z } from 'zod';
-import {
-	CoderClient,
-	CoderSessionArchivedError,
-	CoderSessionNotFoundError,
-} from '@agentuity/core/coder';
-import { ValidationOutputError } from '@agentuity/core';
-
-import { createSubcommand } from '../../types';
-import * as tui from '../../tui';
-import { getCommand } from '../../command-prefix';
-import { ErrorCode } from '../../errors';
-
-function formatRelativeTime(isoDate: string): string {
-	const parsed = new Date(isoDate).getTime();
-	if (Number.isNaN(parsed)) return 'unknown';
-	const diffMs = Math.max(0, Date.now() - parsed);
-	const seconds = Math.floor(diffMs / 1000);
-	if (seconds < 60) return `${seconds}s ago`;
-	const minutes = Math.floor(seconds / 60);
-	if (minutes < 60) return `${minutes}m ago`;
-	const hours = Math.floor(minutes / 60);
-	if (hours < 24) return `${hours}h ago`;
-	const days = Math.floor(hours / 24);
-	return `${days}d ago`;
-}
-
-function formatDuration(ms: number): string {
-	const seconds = Math.floor(ms / 1000);
-	if (seconds < 60) return `${seconds}s`;
-	const minutes = Math.floor(seconds / 60);
-	const remainSec = seconds % 60;
-	if (minutes < 60) return `${minutes}m ${remainSec}s`;
-	const hours = Math.floor(minutes / 60);
-	const remainMin = minutes % 60;
-	return `${hours}h ${remainMin}m`;
-}
-
-export const getSubcommand = createSubcommand({
-	name: 'get',
-	aliases: ['show', 'inspect'],
-	description: 'Show detailed information about a Coder session',
-	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, org: true },
-	examples: [
-		{
-			command: getCommand('coder get codesess_abc123'),
-			description: 'Get a session by ID',
-		},
-		{
-			command: getCommand('coder get codesess_abc123 --json'),
-			description: 'Get session details as JSON',
-		},
-	],
-	idempotent: true,
-	schema: {
-		args: z.object({
-			session_id: z.string().describe('Coder session ID to inspect'),
-		}),
-		options: z.object({
-			url: z.string().optional().describe('Coder API URL override'),
-		}),
-	},
-	async handler(ctx) {
-		const { args, options, opts } = ctx;
-		const sessionId = args.session_id;
-		const client = new CoderClient({
-			apiKey: ctx.auth.apiKey,
-			url: opts?.url,
-			orgId: ctx.orgId,
-		});
-
-		let data: {
-			sessionId: string;
-			label: string;
-			status: string;
-			createdAt: string;
-			mode: string;
-			context?: {
-				branch?: string;
-				workingDirectory?: string;
-			};
-			participants?: Array<{
-				id: string;
-				role: string;
-				transport: string;
-				connectedAt: string;
-				idle: boolean;
-			}>;
-			tasks?: Array<{
-				taskId: string;
-				agent: string;
-				status: string;
-				prompt: string;
-				duration?: number;
-				startedAt: string;
-				completedAt?: string;
-			}>;
-			agentActivity?: Record<
-				string,
-				{
-					name: string;
-					status: string;
-					currentTool?: string;
-					toolCallCount: number;
-					lastActivity: number;
-				}
-			>;
-		};
-
-		try {
-			data = (await client.getSession(sessionId)) as unknown as typeof data;
-		} catch (err) {
-			if (err instanceof CoderSessionNotFoundError) {
-				tui.fatal(`Session not found: ${sessionId}`, ErrorCode.RESOURCE_NOT_FOUND);
-				return;
-			}
-			if (err instanceof CoderSessionArchivedError) {
-				tui.fatal(`Session has shut down: ${sessionId}`, ErrorCode.RESOURCE_NOT_FOUND);
-				return;
-			}
-
-			if (err instanceof ValidationOutputError) {
-				ctx.logger.trace('Validation response URL: %s', err.url ?? 'unknown');
-				ctx.logger.trace('Validation issues: %s', JSON.stringify(err.issues, null, 2));
-			}
-			const msg = err instanceof Error ? err.message : String(err);
-			tui.fatal(`Failed to inspect Coder session ${sessionId}: ${msg}`, ErrorCode.NETWORK_ERROR);
-			return;
-		}
-
-		if (options.json) {
-			return data;
-		}
-
-		// Header
-		const label = data.label || data.sessionId;
-		console.log();
-		console.log(`  Session: ${label} (${data.sessionId})`);
-		const parts = [`Status: ${data.status}`, `Mode: ${data.mode}`];
-		if (data.context?.branch) parts.push(`Branch: ${data.context.branch}`);
-		console.log(`  ${parts.join(' | ')}`);
-		console.log(`  Created: ${data.createdAt}`);
-
-		// Participants
-		console.log();
-		console.log('  Participants:');
-		const participants = data.participants ?? [];
-		if (participants.length === 0) {
-			console.log('    (none)');
-		} else {
-			for (const p of participants) {
-				const idle = p.idle ? '  (idle)' : '';
-				const connected = p.connectedAt
-					? `  connected ${formatRelativeTime(p.connectedAt)}`
-					: '';
-				console.log(
-					`    ${p.id.padEnd(12)} ${p.role.padEnd(10)} ${p.transport}${connected}${idle}`
-				);
-			}
-		}
-
-		// Tasks
-		const tasks = data.tasks ?? [];
-		if (tasks.length > 0) {
-			console.log();
-			console.log('  Tasks:');
-			for (const t of tasks) {
-				const dur = t.duration ? formatDuration(t.duration) : '-';
-				const prompt = t.prompt.length > 40 ? t.prompt.slice(0, 37) + '...' : t.prompt;
-				console.log(
-					`    ${t.taskId.padEnd(10)} ${t.agent.padEnd(10)} ${t.status.padEnd(10)} ${prompt.padEnd(42)} ${dur}`
-				);
-			}
-		}
-
-		// Agent Activity
-		const agents = Object.values(data.agentActivity ?? {});
-		if (agents.length > 0) {
-			console.log();
-			console.log('  Agent Activity:');
-			for (const a of agents) {
-				const tool = a.currentTool
-					? `${a.currentTool} (${a.toolCallCount} calls)`
-					: `${a.toolCallCount} calls`;
-				const lastAct = a.lastActivity
-					? formatRelativeTime(new Date(a.lastActivity).toISOString())
-					: '-';
-				console.log(
-					`    ${a.name.padEnd(12)} ${a.status.padEnd(8)} ${tool.padEnd(28)} last: ${lastAct}`
-				);
-			}
-		}
-
-		console.log();
-
-		return data;
-	},
-});

package/src/cmd/coder/index.ts

@@ -1,81 +0,0 @@
-import { createCommand } from '../../types';
-import { listSubcommand } from './list';
-import { getSubcommand } from './get';
-import { startSubcommand } from './start';
-import { createCoderSubcommand } from './create';
-import { deleteSubcommand } from './delete';
-import { archiveSubcommand } from './archive';
-import { updateSubcommand } from './update';
-import { usersSubcommand } from './users';
-import { loopSubcommand } from './loop';
-import { replaySubcommand } from './replay';
-import { participantsSubcommand } from './participants';
-import { eventsSubcommand } from './events';
-import { workspaceCommand } from './workspace';
-import { skillCommand } from './skill';
-import { getCommand } from '../../command-prefix';
-
-export const command = createCommand({
-	name: 'coder',
-	description: 'Coder session management commands',
-	tags: ['requires-auth'],
-	examples: [
-		{
-			command: getCommand('coder start'),
-			description: 'Start a coding session connected to Coder',
-		},
-		{
-			command: getCommand('coder start --dir ~/path/to/my/project'),
-			description: 'Start a coding session from a specific local project directory',
-		},
-		{
-			command: getCommand('coder create "Build a REST API"'),
-			description: 'Create a new Coder session with a task',
-		},
-		{
-			command: getCommand('coder ls'),
-			description: 'List all active Coder sessions',
-		},
-		{
-			command: getCommand('coder get <session-id>'),
-			description: 'Show detailed session information',
-		},
-		{
-			command: getCommand('coder users'),
-			description: 'List known Coder users',
-		},
-		{
-			command: getCommand('coder loop <session-id>'),
-			description: 'Get loop state for a session',
-		},
-		{
-			command: getCommand('coder events <session-id> --limit 100'),
-			description: 'Show recent event history for a session',
-		},
-		{
-			command: getCommand('coder workspace list'),
-			description: 'List Coder workspaces',
-		},
-		{
-			command: getCommand('coder skill list'),
-			description: 'List saved skills',
-		},
-	],
-	subcommands: [
-		startSubcommand,
-		createCoderSubcommand,
-		listSubcommand,
-		getSubcommand,
-		updateSubcommand,
-		deleteSubcommand,
-		archiveSubcommand,
-		usersSubcommand,
-		loopSubcommand,
-		replaySubcommand,
-		participantsSubcommand,
-		eventsSubcommand,
-		workspaceCommand,
-		skillCommand,
-	],
-	requires: { auth: true, org: true },
-});

package/src/cmd/coder/list.ts

@@ -1,106 +0,0 @@
-import { z } from 'zod';
-import {
-	CoderClient,
-	type CoderSessionListItem,
-	CoderSessionListItemSchema,
-} from '@agentuity/core/coder';
-import { ValidationOutputError } from '@agentuity/core';
-import { createSubcommand } from '../../types';
-import * as tui from '../../tui';
-import { getCommand } from '../../command-prefix';
-import { ErrorCode } from '../../errors';
-
-function formatRelativeTime(isoDate: string): string {
-	const parsed = new Date(isoDate).getTime();
-	if (Number.isNaN(parsed)) return 'unknown';
-	const diffMs = Math.max(0, Date.now() - parsed);
-	const seconds = Math.floor(diffMs / 1000);
-	if (seconds < 60) return `${seconds}s ago`;
-	const minutes = Math.floor(seconds / 60);
-	if (minutes < 60) return `${minutes}m ago`;
-	const hours = Math.floor(minutes / 60);
-	if (hours < 24) return `${hours}h ago`;
-	const days = Math.floor(hours / 24);
-	return `${days}d ago`;
-}
-
-export const listSubcommand = createSubcommand({
-	name: 'list',
-	description: 'List active Coder sessions',
-	tags: ['read-only', 'fast', 'requires-auth'],
-	examples: [
-		{
-			command: getCommand('coder ls'),
-			description: 'List all active sessions',
-		},
-		{
-			command: getCommand('coder list --json'),
-			description: 'List sessions as JSON',
-		},
-	],
-	aliases: ['ls'],
-	idempotent: true,
-	requires: { auth: true, org: true },
-	schema: {
-		options: z.object({
-			url: z.string().optional().describe('Coder API URL override'),
-		}),
-		response: z.array(CoderSessionListItemSchema),
-	},
-	async handler(ctx) {
-		const { options, opts } = ctx;
-		const client = new CoderClient({
-			apiKey: ctx.auth.apiKey,
-			url: opts?.url,
-			orgId: ctx.orgId,
-		});
-
-		let sessions: CoderSessionListItem[] = [];
-		try {
-			const response = await client.listSessions();
-			sessions = response.sessions;
-		} catch (err) {
-			if (err instanceof ValidationOutputError) {
-				ctx.logger.trace('Validation response URL: %s', err.url ?? 'unknown');
-				ctx.logger.trace('Validation issues: %s', JSON.stringify(err.issues, null, 2));
-			}
-			const msg = err instanceof Error ? err.message : String(err);
-			tui.fatal(`Failed to list Coder sessions: ${msg}`, ErrorCode.NETWORK_ERROR);
-		}
-
-		if (options.json) {
-			return sessions;
-		}
-
-		if (sessions.length === 0) {
-			tui.info('No active Coder sessions.');
-			return [];
-		}
-
-		const tableData = sessions.map((s) => ({
-			'Session ID': s.sessionId,
-			Label: s.label || '-',
-			Status: s.status,
-			Mode: s.mode,
-			Owner: s.owner?.name ?? s.owner?.userId ?? '-',
-			Observers: String(s.observerCount),
-			Agents: String(s.subAgentCount),
-			Tasks: String(s.taskCount),
-			Created: formatRelativeTime(s.createdAt),
-		}));
-
-		tui.table(tableData, [
-			{ name: 'Session ID', alignment: 'left' },
-			{ name: 'Label', alignment: 'left' },
-			{ name: 'Status', alignment: 'center' },
-			{ name: 'Mode', alignment: 'center' },
-			{ name: 'Owner', alignment: 'left' },
-			{ name: 'Observers', alignment: 'right' },
-			{ name: 'Agents', alignment: 'right' },
-			{ name: 'Tasks', alignment: 'right' },
-			{ name: 'Created', alignment: 'right' },
-		]);
-
-		return sessions;
-	},
-});

package/src/cmd/coder/loop.ts

@@ -1,85 +0,0 @@
-import { z } from 'zod';
-import { CoderClient } from '@agentuity/core/coder';
-import { ValidationOutputError } from '@agentuity/core';
-import { createSubcommand } from '../../types';
-import * as tui from '../../tui';
-import { getCommand } from '../../command-prefix';
-import { ErrorCode } from '../../errors';
-
-export const loopSubcommand = createSubcommand({
-	name: 'loop',
-	description: 'Get loop-mode state for a Coder session',
-	tags: ['read-only', 'fast', 'requires-auth'],
-	idempotent: true,
-	requires: { auth: true, org: true },
-	examples: [
-		{
-			command: getCommand('coder loop codesess_abc123'),
-			description: 'Show loop state for a session',
-		},
-		{
-			command: getCommand('coder loop codesess_abc123 --json'),
-			description: 'Get loop state as JSON',
-		},
-	],
-	schema: {
-		args: z.object({
-			sessionId: z.string().describe('Session ID to inspect loop state for'),
-		}),
-		options: z.object({
-			url: z.string().optional().describe('Coder API URL override'),
-		}),
-	},
-	async handler(ctx) {
-		const { args, opts, options } = ctx;
-		const client = new CoderClient({
-			apiKey: ctx.auth.apiKey,
-			url: opts?.url,
-			orgId: ctx.orgId,
-		});
-
-		try {
-			const state = await client.getLoopState(args.sessionId);
-
-			if (options.json) {
-				return state;
-			}
-
-			const rows: Array<{ Field: string; Value: string }> = [
-				{ Field: 'Session ID', Value: state.sessionId },
-				{ Field: 'Workflow Mode', Value: state.workflowMode },
-			];
-
-			if (!state.loop) {
-				rows.push({ Field: 'Loop Status', Value: 'not active' });
-			} else {
-				rows.push({ Field: 'Loop Status', Value: state.loop.status });
-				rows.push({ Field: 'Iteration', Value: String(state.loop.iteration) });
-				rows.push({
-					Field: 'Max Iterations',
-					Value: String(state.loop.maxIterations ?? '-'),
-				});
-				rows.push({ Field: 'Goal', Value: state.loop.goal ?? '-' });
-				rows.push({ Field: 'Summary', Value: state.loop.summary ?? '-' });
-				rows.push({ Field: 'Next Action', Value: state.loop.nextAction ?? '-' });
-			}
-
-			tui.table(rows, [
-				{ name: 'Field', alignment: 'left' },
-				{ name: 'Value', alignment: 'left' },
-			]);
-
-			return state;
-		} catch (err) {
-			if (err instanceof ValidationOutputError) {
-				ctx.logger.trace('Validation response URL: %s', err.url ?? 'unknown');
-				ctx.logger.trace('Validation issues: %s', JSON.stringify(err.issues, null, 2));
-			}
-			const msg = err instanceof Error ? err.message : String(err);
-			tui.fatal(
-				`Failed to get loop state for ${args.sessionId}: ${msg}`,
-				ErrorCode.NETWORK_ERROR
-			);
-		}
-	},
-});

package/src/cmd/coder/participants.ts

@@ -1,100 +0,0 @@
-import { z } from 'zod';
-import { CoderClient } from '@agentuity/core/coder';
-import { ValidationOutputError } from '@agentuity/core';
-import { createSubcommand } from '../../types';
-import * as tui from '../../tui';
-import { getCommand } from '../../command-prefix';
-import { ErrorCode } from '../../errors';
-
-function formatRelativeTime(isoDate: string): string {
-	const parsed = new Date(isoDate).getTime();
-	if (Number.isNaN(parsed)) return 'unknown';
-	const diffMs = Math.max(0, Date.now() - parsed);
-	const seconds = Math.floor(diffMs / 1000);
-	if (seconds < 60) return `${seconds}s ago`;
-	const minutes = Math.floor(seconds / 60);
-	if (minutes < 60) return `${minutes}m ago`;
-	const hours = Math.floor(minutes / 60);
-	if (hours < 24) return `${hours}h ago`;
-	const days = Math.floor(hours / 24);
-	return `${days}d ago`;
-}
-
-export const participantsSubcommand = createSubcommand({
-	name: 'participants',
-	aliases: ['participant', 'members'],
-	description: 'List participants for a Coder session',
-	tags: ['read-only', 'fast', 'requires-auth'],
-	idempotent: true,
-	requires: { auth: true, org: true },
-	examples: [
-		{
-			command: getCommand('coder participants codesess_abc123'),
-			description: 'List session participants',
-		},
-		{
-			command: getCommand('coder participants codesess_abc123 --json'),
-			description: 'Get session participants as JSON',
-		},
-	],
-	schema: {
-		args: z.object({
-			sessionId: z.string().describe('Session ID to list participants for'),
-		}),
-		options: z.object({
-			url: z.string().optional().describe('Coder API URL override'),
-		}),
-	},
-	async handler(ctx) {
-		const { args, opts, options } = ctx;
-		const client = new CoderClient({
-			apiKey: ctx.auth.apiKey,
-			url: opts?.url,
-			orgId: ctx.orgId,
-		});
-
-		try {
-			const data = await client.listParticipants(args.sessionId);
-
-			if (options.json) {
-				return data;
-			}
-
-			if (data.participants.length === 0) {
-				tui.info(`No participants found for session ${args.sessionId}.`);
-				return data;
-			}
-
-			tui.table(
-				data.participants.map((p) => ({
-					ID: p.id,
-					Role: p.role,
-					'Agent Role': p.agentRole ?? '-',
-					Transport: p.transport ?? '-',
-					Connected: p.connectedAt ? formatRelativeTime(p.connectedAt) : '-',
-					'Last Activity': p.lastActivityAt ? formatRelativeTime(p.lastActivityAt) : '-',
-				})),
-				[
-					{ name: 'ID', alignment: 'left' },
-					{ name: 'Role', alignment: 'left' },
-					{ name: 'Agent Role', alignment: 'left' },
-					{ name: 'Transport', alignment: 'center' },
-					{ name: 'Connected', alignment: 'right' },
-					{ name: 'Last Activity', alignment: 'right' },
-				]
-			);
-
-			return data;
-		} catch (err) {
-			if (err instanceof ValidationOutputError) {
-				ctx.logger.trace('Validation response URL: %s', err.url ?? 'unknown');
-				ctx.logger.trace('Validation issues: %s', JSON.stringify(err.issues, null, 2));
-			}
-			const msg = err instanceof Error ? err.message : String(err);
-			tui.fatal(
-				`Failed to list participants for session ${args.sessionId}: ${msg}`,
-				ErrorCode.NETWORK_ERROR
-			);
-		}
-	},
-});

package/src/cmd/coder/replay.ts

@@ -1,58 +0,0 @@
-import { z } from 'zod';
-import { CoderClient } from '@agentuity/core/coder';
-import { ValidationOutputError } from '@agentuity/core';
-import { createSubcommand } from '../../types';
-import * as tui from '../../tui';
-import { getCommand } from '../../command-prefix';
-import { ErrorCode } from '../../errors';
-
-export const replaySubcommand = createSubcommand({
-	name: 'replay',
-	description: 'Get replay data for a Coder session',
-	tags: ['read-only', 'requires-auth'],
-	idempotent: true,
-	requires: { auth: true, org: true },
-	examples: [
-		{
-			command: getCommand('coder replay codesess_abc123 --json'),
-			description: 'Get replay data as JSON',
-		},
-	],
-	schema: {
-		args: z.object({
-			sessionId: z.string().describe('Session ID to get replay data for'),
-		}),
-		options: z.object({
-			url: z.string().optional().describe('Coder API URL override'),
-		}),
-	},
-	async handler(ctx) {
-		const { args, opts, options } = ctx;
-		const client = new CoderClient({
-			apiKey: ctx.auth.apiKey,
-			url: opts?.url,
-			orgId: ctx.orgId,
-		});
-
-		try {
-			const replay = await client.getReplay(args.sessionId);
-
-			if (!options.json) {
-				tui.info('Replay data is shown as JSON because it is a complex payload.');
-				tui.output(JSON.stringify(replay, null, 2));
-			}
-
-			return replay;
-		} catch (err) {
-			if (err instanceof ValidationOutputError) {
-				ctx.logger.trace('Validation response URL: %s', err.url ?? 'unknown');
-				ctx.logger.trace('Validation issues: %s', JSON.stringify(err.issues, null, 2));
-			}
-			const msg = err instanceof Error ? err.message : String(err);
-			tui.fatal(
-				`Failed to get replay for session ${args.sessionId}: ${msg}`,
-				ErrorCode.NETWORK_ERROR
-			);
-		}
-	},
-});