@agentuity/cli 1.0.36 → 1.0.37

package/src/cmd/coder/inspect.ts

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+import { createSubcommand } from '../../types';
+import * as tui from '../../tui';
+import { getCommand } from '../../command-prefix';
+import { ErrorCode } from '../../errors';
+import { resolveHubUrl, hubFetchHeaders } from './hub-url';
+
+function formatRelativeTime(isoDate: string): string {
+	const diffMs = Date.now() - new Date(isoDate).getTime();
+	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 inspectSubcommand = createSubcommand({
+	name: 'inspect',
+	description: 'Show detailed information about a Coder Hub session',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	examples: [
+		{
+			command: getCommand('coder inspect codesess_abc123'),
+			description: 'Inspect a session by ID',
+		},
+		{
+			command: getCommand('coder inspect 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({
+			hubUrl: z.string().optional().describe('Hub URL override'),
+		}),
+	},
+	async handler(ctx) {
+		const { args, options, opts } = ctx;
+		const sessionId = args.session_id;
+		const hubUrl = await resolveHubUrl(opts?.hubUrl);
+
+		if (!hubUrl) {
+			tui.fatal(
+				'Could not find a running Coder Hub.\n\nEither:\n  - Start the Hub with: bun run dev\n  - Set AGENTUITY_CODER_HUB_URL environment variable\n  - Pass --hub-url flag',
+				ErrorCode.NETWORK_ERROR
+			);
+			return;
+		}
+
+		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 {
+			const resp = await fetch(`${hubUrl}/api/hub/session/${encodeURIComponent(sessionId)}`, {
+				headers: hubFetchHeaders(),
+				signal: AbortSignal.timeout(10_000),
+			});
+			if (resp.status === 404) {
+				tui.fatal(`Session not found: ${sessionId}`, ErrorCode.RESOURCE_NOT_FOUND);
+				return;
+			}
+			if (resp.status === 410) {
+				tui.fatal(`Session has shut down: ${sessionId}`, ErrorCode.RESOURCE_NOT_FOUND);
+				return;
+			}
+			if (!resp.ok) {
+				tui.fatal(
+					`Hub returned ${resp.status}: ${resp.statusText}. Is the Coder Hub running at ${hubUrl}?`,
+					ErrorCode.API_ERROR
+				);
+				return;
+			}
+			data = (await resp.json()) as typeof data;
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			tui.fatal(
+				`Could not connect to Coder Hub at ${hubUrl}: ${msg}\n\nSet AGENTUITY_CODER_HUB_URL or start the Hub with: bun run dev`,
+				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:');
+		if (data.participants.length === 0) {
+			console.log('    (none)');
+		} else {
+			for (const p of data.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
+		if (data.tasks.length > 0) {
+			console.log();
+			console.log('  Tasks:');
+			for (const t of data.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/list.ts

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+import { createSubcommand } from '../../types';
+import * as tui from '../../tui';
+import { getCommand } from '../../command-prefix';
+import { ErrorCode } from '../../errors';
+import { resolveHubUrl, hubFetchHeaders } from './hub-url';
+
+function formatRelativeTime(isoDate: string): string {
+	const diffMs = Date.now() - new Date(isoDate).getTime();
+	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`;
+}
+
+const SessionListResponseSchema = z.array(
+	z.object({
+		sessionId: z.string().describe('Session ID'),
+		label: z.string().describe('Human-readable session label'),
+		status: z.string().describe('Session status'),
+		mode: z.string().describe('Session mode (sandbox or tui)'),
+		createdAt: z.string().describe('Creation timestamp'),
+		taskCount: z.number().describe('Number of tasks'),
+		subAgentCount: z.number().describe('Number of sub-agents'),
+		observerCount: z.number().describe('Number of observers'),
+		participantCount: z.number().describe('Total participant count'),
+	})
+);
+
+export const listSubcommand = createSubcommand({
+	name: 'list',
+	description: 'List active Coder Hub 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,
+	schema: {
+		options: z.object({
+			hubUrl: z.string().optional().describe('Hub URL override'),
+		}),
+		response: SessionListResponseSchema,
+	},
+	async handler(ctx) {
+		const { options, opts } = ctx;
+		const hubUrl = await resolveHubUrl(opts?.hubUrl);
+
+		if (!hubUrl) {
+			tui.fatal(
+				'Could not find a running Coder Hub.\n\nEither:\n  - Start the Hub with: bun run dev\n  - Set AGENTUITY_CODER_HUB_URL environment variable\n  - Pass --hub-url flag',
+				ErrorCode.NETWORK_ERROR
+			);
+			return [];
+		}
+
+		let data: {
+			sessions: {
+				websocket: Array<{
+					sessionId: string;
+					label: string;
+					status: string;
+					mode: string;
+					createdAt: string;
+					taskCount: number;
+					subAgentCount: number;
+					observerCount: number;
+					participantCount: number;
+				}>;
+				sandbox: Array<Record<string, unknown>>;
+			};
+			total: number;
+		};
+
+		try {
+			const resp = await fetch(`${hubUrl}/api/hub/sessions`, {
+				headers: hubFetchHeaders(),
+				signal: AbortSignal.timeout(10_000),
+			});
+			if (!resp.ok) {
+				tui.fatal(
+					`Hub returned ${resp.status}: ${resp.statusText}. Is the Coder Hub running at ${hubUrl}?`,
+					ErrorCode.API_ERROR
+				);
+				return [];
+			}
+			data = (await resp.json()) as typeof data;
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			tui.fatal(
+				`Could not connect to Coder Hub at ${hubUrl}: ${msg}\n\nSet AGENTUITY_CODER_HUB_URL or start the Hub with: bun run dev`,
+				ErrorCode.NETWORK_ERROR
+			);
+			return [];
+		}
+
+		const sessions = data.sessions.websocket;
+
+		if (options.json) {
+			return sessions;
+		}
+
+		if (sessions.length === 0) {
+			tui.info('No active Coder Hub sessions.');
+			return [];
+		}
+
+		const tableData = sessions.map((s) => ({
+			'Session ID': s.sessionId.length > 20 ? s.sessionId.slice(0, 17) + '...' : s.sessionId,
+			Label: s.label || '-',
+			Status: s.status,
+			Mode: s.mode,
+			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: 'Observers', alignment: 'right' },
+			{ name: 'Agents', alignment: 'right' },
+			{ name: 'Tasks', alignment: 'right' },
+			{ name: 'Created', alignment: 'right' },
+		]);
+
+		return sessions;
+	},
+});