@roj-ai/cli 0.0.2

package/dist/repl/session-picker.d.ts

@@ -0,0 +1,6 @@
+import { SessionId } from '@roj-ai/shared';
+import type { RpcClient } from '@roj-ai/shared/rpc';
+import * as readline from 'node:readline';
+export declare function pickSession(client: RpcClient, rl: readline.Interface): Promise<SessionId>;
+export declare function createNewSession(client: RpcClient, rl: readline.Interface): Promise<SessionId>;
+//# sourceMappingURL=session-picker.d.ts.map

package/dist/repl/session-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-picker.d.ts","sourceRoot":"","sources":["../../src/repl/session-picker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAiBzC,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CA8B/F;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CA4BpG"}

package/dist/repl/session-picker.js

@@ -0,0 +1,60 @@
+import { SessionId } from '@roj-ai/shared';
+import { unwrap } from '../unwrap.js';
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RESET = '\x1b[0m';
+function ask(rl, question) {
+    return new Promise(resolve => {
+        rl.question(question, resolve);
+    });
+}
+function isSessionMetadata(data) {
+    return typeof data === 'object' && data !== null && 'sessionId' in data && 'presetId' in data;
+}
+export async function pickSession(client, rl) {
+    const { sessions: rawSessions } = unwrap(await client.call('sessions.list', { status: 'active', limit: 20, order: 'desc' }));
+    const sessions = rawSessions.filter(isSessionMetadata);
+    console.log();
+    console.log(`${BOLD}Active sessions:${RESET}`);
+    for (let i = 0; i < sessions.length; i++) {
+        const s = sessions[i];
+        const date = new Date(s.createdAt).toLocaleString();
+        const name = s.name ? ` - ${s.name}` : '';
+        console.log(`  ${BOLD}${i + 1})${RESET} ${s.sessionId.slice(0, 8)}... ${DIM}[${s.presetId}]${RESET}${name} ${DIM}${date}${RESET}`);
+    }
+    console.log(`  ${BOLD}n)${RESET} Create new session`);
+    console.log();
+    const choice = await ask(rl, 'Select session: ');
+    if (choice.toLowerCase() === 'n') {
+        return createNewSession(client, rl);
+    }
+    const index = parseInt(choice, 10) - 1;
+    if (index >= 0 && index < sessions.length) {
+        return sessions[index].sessionId;
+    }
+    console.log('Invalid choice, try again.');
+    return pickSession(client, rl);
+}
+export async function createNewSession(client, rl) {
+    const { presets } = unwrap(await client.call('presets.list', {}));
+    if (presets.length === 0) {
+        throw new Error('No presets available on the server.');
+    }
+    console.log();
+    console.log(`${BOLD}Available presets:${RESET}`);
+    for (let i = 0; i < presets.length; i++) {
+        const p = presets[i];
+        const desc = p.description ? ` - ${p.description}` : '';
+        console.log(`  ${BOLD}${i + 1})${RESET} ${p.name}${DIM}${desc}${RESET}`);
+    }
+    console.log();
+    const choice = await ask(rl, 'Select preset: ');
+    const index = parseInt(choice, 10) - 1;
+    if (index < 0 || index >= presets.length) {
+        console.log('Invalid choice, try again.');
+        return createNewSession(client, rl);
+    }
+    const { sessionId } = unwrap(await client.call('sessions.create', { presetId: presets[index].id }));
+    console.log(`Session created: ${sessionId}`);
+    return SessionId(sessionId);
+}

package/dist/unwrap.d.ts

@@ -0,0 +1,4 @@
+import type { Result } from '@roj-ai/shared/rpc';
+import type { RpcErrorInfo } from '@roj-ai/shared/rpc';
+export declare function unwrap<T>(result: Result<T, RpcErrorInfo>): T;
+//# sourceMappingURL=unwrap.d.ts.map

package/dist/unwrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwrap.d.ts","sourceRoot":"","sources":["../src/unwrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAG5D"}

package/dist/unwrap.js

@@ -0,0 +1,6 @@
+import { RpcError } from '@roj-ai/shared/rpc';
+export function unwrap(result) {
+    if (result.ok)
+        return result.value;
+    throw new RpcError(0, result.error);
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+	"name": "@roj-ai/cli",
+	"version": "0.0.2",
+	"type": "module",
+	"main": "./src/main.ts",
+	"files": [
+		"src",
+		"dist"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"dev": "bun run src/main.ts",
+		"build": "tsc",
+		"type-check": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@roj-ai/sdk": "^0.0.2",
+		"@roj-ai/shared": "^0.0.2",
+		"@roj-ai/transport": "^0.0.2"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"typescript": "^5.7.2"
+	}
+}

package/src/client.ts

@@ -0,0 +1,41 @@
+import { RpcClient } from '@roj-ai/shared/rpc'
+import type { ProtocolDef, RawMessageListener } from '@roj-ai/transport'
+import { bunWebSocketFactory } from '@roj-ai/transport/bun'
+import { ClientConnection } from '@roj-ai/transport/client'
+
+export function createCliClient(baseUrl: string): RpcClient {
+	return new RpcClient(baseUrl)
+}
+
+export type WsConnection = ClientConnection<ProtocolDef, ProtocolDef>
+
+export type NotificationHandlers = Record<string, (payload: unknown) => void>
+
+export function connectWebSocket(
+	baseUrl: string,
+	sessionId: string,
+	handlers: NotificationHandlers,
+): WsConnection {
+	const url = new URL('/ws/spa', baseUrl)
+	url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:'
+	url.searchParams.set('sessionId', sessionId)
+
+	const connection = new ClientConnection<ProtocolDef, ProtocolDef>({
+		url: url.toString(),
+		wsFactory: bunWebSocketFactory,
+		reconnect: {
+			baseDelayMs: 1000,
+			maxDelayMs: 10000,
+			maxAttempts: 10,
+		},
+	})
+
+	const listener: RawMessageListener = (type, payload) => {
+		const handler = handlers[type]
+		if (handler) {
+			handler(payload)
+		}
+	}
+	connection.setRawMessageListener(listener)
+	return connection
+}

package/src/commands/answer.ts

@@ -0,0 +1,27 @@
+import { AgentId, ChatMessageId } from '@roj-ai/shared'
+import type { RpcClient } from '@roj-ai/shared/rpc'
+import { unwrap } from '../unwrap.js'
+
+export async function answerCommand(
+	client: RpcClient,
+	sessionId: string,
+	questionId: string,
+	answer: string,
+	json: boolean,
+): Promise<void> {
+	const session = unwrap(await client.call('sessions.get', { sessionId }))
+	if (!session.entryAgentId) {
+		console.error('No entry agent found for session.')
+		process.exit(1)
+	}
+	const result = unwrap(
+		await client.call('user-chat.answerQuestion', { sessionId, agentId: AgentId(session.entryAgentId), questionId: ChatMessageId(questionId), answer }),
+	)
+
+	if (json) {
+		console.log(JSON.stringify(result))
+		return
+	}
+
+	console.log('Answer submitted.')
+}

package/src/commands/debug-format.ts

@@ -0,0 +1,299 @@
+import type { LLMCallLogEntry } from '@roj-ai/sdk'
+import type { DomainEvent } from '@roj-ai/sdk'
+import type {
+	AgentTreeNode,
+	ConversationMessageView,
+	GetAgentDetailResponse,
+	GetMetricsResponse,
+	GlobalMailboxMessage,
+	TimelineItem,
+} from '@roj-ai/shared'
+
+// ANSI color codes
+const RESET = '\x1b[0m'
+const BOLD = '\x1b[1m'
+const DIM = '\x1b[2m'
+const CYAN = '\x1b[36m'
+const GREEN = '\x1b[32m'
+const YELLOW = '\x1b[33m'
+const RED = '\x1b[31m'
+const MAGENTA = '\x1b[35m'
+
+export function truncate(str: string, maxLen: number): string {
+	if (str.length <= maxLen) return str
+	return str.slice(0, maxLen - 1) + '\u2026'
+}
+
+function formatDuration(ms: number | undefined): string {
+	if (ms === undefined) return '-'
+	if (ms < 1000) return `${ms}ms`
+	return `${(ms / 1000).toFixed(1)}s`
+}
+
+function formatTimestamp(ts: number): string {
+	return new Date(ts).toLocaleTimeString()
+}
+
+function statusColor(status: string): string {
+	switch (status) {
+		case 'idle':
+		case 'success':
+			return GREEN
+		case 'thinking':
+		case 'responding':
+		case 'running':
+			return YELLOW
+		case 'error':
+			return RED
+		default:
+			return ''
+	}
+}
+
+// ============================================================================
+// Agent Tree
+// ============================================================================
+
+export function formatAgentTree(nodes: AgentTreeNode[]): string {
+	const lines: string[] = []
+	for (let i = 0; i < nodes.length; i++) {
+		const isLast = i === nodes.length - 1
+		formatTreeNode(lines, nodes[i], '', isLast)
+	}
+	return lines.join('\n')
+}
+
+function formatCost(cost: number): string {
+	if (cost >= 1) return `$${cost.toFixed(2)}`
+	return `$${cost.toFixed(4)}`
+}
+
+function formatTreeNode(lines: string[], node: AgentTreeNode, prefix: string, isLast: boolean): void {
+	const connector = isLast ? '\u2514\u2500\u2500 ' : '\u251c\u2500\u2500 '
+	const childPrefix = prefix + (isLast ? '    ' : '\u2502   ')
+	const color = statusColor(node.status)
+
+	// Line 1: name + status
+	lines.push(`${prefix}${connector}${BOLD}${node.definitionName}${RESET} ${color}[${node.status}]${RESET}`)
+
+	// Line 2: cost + badges + id
+	const details: string[] = []
+	if (node.cost > 0) details.push(`${GREEN}${formatCost(node.cost)}${RESET}`)
+	if (node.isExecuting) details.push(`${YELLOW}executing${RESET}`)
+	if (node.mailboxCount > 0) details.push(`${CYAN}${node.mailboxCount} msgs${RESET}`)
+	if (node.pendingToolCalls > 0) details.push(`${MAGENTA}${node.pendingToolCalls} tools${RESET}`)
+	const detailStr = details.length > 0 ? details.join(` ${DIM}\u00b7${RESET} `) + '  ' : ''
+	lines.push(`${childPrefix}${detailStr}${DIM}${node.id}${RESET}`)
+
+	// Children
+	for (let i = 0; i < node.children.length; i++) {
+		const childIsLast = i === node.children.length - 1
+		formatTreeNode(lines, node.children[i], childPrefix, childIsLast)
+	}
+}
+
+// ============================================================================
+// Agent Detail
+// ============================================================================
+
+export function formatAgentDetail(detail: GetAgentDetailResponse): string {
+	const lines: string[] = []
+	const color = statusColor(detail.status)
+
+	// Header
+	lines.push(`${BOLD}Agent: ${detail.definitionName}${RESET}`)
+	lines.push(`  ID:     ${detail.id}`)
+	lines.push(`  Status: ${color}${detail.status}${RESET}`)
+	lines.push(`  Parent: ${detail.parentId ?? 'none'}`)
+
+	// Mailbox
+	lines.push('')
+	lines.push(`${BOLD}Mailbox${RESET} (${detail.mailbox.length} messages)`)
+	if (detail.mailbox.length === 0) {
+		lines.push(`  ${DIM}(empty)${RESET}`)
+	} else {
+		for (const msg of detail.mailbox) {
+			const consumed = msg.consumed ? `${DIM}[consumed]${RESET}` : `${YELLOW}[pending]${RESET}`
+			lines.push(`  ${msg.from} ${consumed}: ${truncate(msg.content, 80)}`)
+		}
+	}
+
+	// Conversation
+	lines.push('')
+	lines.push(`${BOLD}Conversation${RESET} (${detail.conversationHistory.length} messages)`)
+	if (detail.conversationHistory.length === 0) {
+		lines.push(`  ${DIM}(empty)${RESET}`)
+	} else {
+		for (const msg of detail.conversationHistory) {
+			lines.push(formatConversationMessage(msg))
+		}
+	}
+
+	// Pending Tool Calls
+	if (detail.pendingToolCalls.length > 0) {
+		lines.push('')
+		lines.push(`${BOLD}Pending Tool Calls${RESET} (${detail.pendingToolCalls.length})`)
+		for (const tc of detail.pendingToolCalls) {
+			lines.push(`  ${MAGENTA}${tc.name}${RESET} [${tc.status}] ${DIM}${tc.id}${RESET}`)
+			if (tc.input) {
+				lines.push(`    Input: ${truncate(JSON.stringify(tc.input), 100)}`)
+			}
+		}
+	}
+
+	return lines.join('\n')
+}
+
+function formatConversationMessage(msg: ConversationMessageView): string {
+	switch (msg.role) {
+		case 'user':
+			return `  ${GREEN}user:${RESET} ${truncate(typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content), 100)}`
+		case 'assistant': {
+			const content = msg.content ? truncate(msg.content, 100) : ''
+			const toolsInfo = msg.toolCalls?.length ? ` ${DIM}[${msg.toolCalls.length} tool calls]${RESET}` : ''
+			return `  ${CYAN}assistant:${RESET} ${content}${toolsInfo}`
+		}
+		case 'tool': {
+			const errTag = msg.isError ? `${RED}[error]${RESET} ` : ''
+			return `  ${MAGENTA}tool(${msg.toolCallId}):${RESET} ${errTag}${truncate(msg.content, 100)}`
+		}
+		case 'system':
+			return `  ${DIM}system: ${truncate(msg.content, 100)}${RESET}`
+	}
+}
+
+// ============================================================================
+// Timeline
+// ============================================================================
+
+export function formatTimelineItem(item: TimelineItem): string {
+	const status = `${statusColor(item.status)}${item.status}${RESET}`
+	const duration = formatDuration(item.durationMs)
+	const time = formatTimestamp(item.startedAt)
+
+	switch (item.type) {
+		case 'llm': {
+			const model = item.model ?? '-'
+			const tokens = item.promptTokens !== undefined ? `${item.promptTokens}/${item.completionTokens}` : '-'
+			return `${time}  ${CYAN}llm${RESET}      ${item.agentName.padEnd(20)}  ${status.padEnd(20)}  ${duration.padStart(8)}  ${model}  ${tokens}`
+		}
+		case 'tool': {
+			const toolName = item.toolName ?? '-'
+			return `${time}  ${MAGENTA}tool${RESET}     ${item.agentName.padEnd(20)}  ${status.padEnd(20)}  ${duration.padStart(8)}  ${toolName}`
+		}
+		case 'compaction': {
+			const info = item.originalTokens !== undefined
+				? `${item.originalTokens} -> ${item.compactedTokens} tokens, ${item.messagesRemoved} msgs removed`
+				: ''
+			return `${time}  ${YELLOW}compact${RESET}  ${item.agentName.padEnd(20)}  ${status.padEnd(20)}  ${DIM}${info}${RESET}`
+		}
+	}
+}
+
+// ============================================================================
+// Mailbox
+// ============================================================================
+
+export function formatMailboxMessage(msg: GlobalMailboxMessage): string {
+	const status = msg.consumed ? `${DIM}[consumed]${RESET}` : `${YELLOW}[pending]${RESET}`
+	const time = formatTimestamp(msg.timestamp)
+	return `${time}  ${msg.fromAgentName} -> ${msg.toAgentName}  ${status}  ${truncate(msg.content, 60)}`
+}
+
+// ============================================================================
+// Metrics
+// ============================================================================
+
+export function formatMetrics(metrics: GetMetricsResponse): string {
+	const lines: string[] = []
+	lines.push(`${BOLD}Session Metrics${RESET}`)
+	lines.push(`  Total tokens:      ${metrics.totalTokens.toLocaleString()}`)
+	lines.push(`  Prompt tokens:     ${metrics.promptTokens.toLocaleString()}`)
+	lines.push(`  Completion tokens: ${metrics.completionTokens.toLocaleString()}`)
+	if (metrics.totalCost !== undefined) {
+		lines.push(`  Cost:              $${metrics.totalCost.toFixed(4)}`)
+	}
+	lines.push(`  LLM calls:         ${metrics.llmCalls}`)
+	lines.push(`  Tool calls:        ${metrics.toolCalls}`)
+	lines.push(`  Agent count:       ${metrics.agentCount}`)
+	lines.push(`  Duration:          ${formatDuration(metrics.durationMs)}`)
+	return lines.join('\n')
+}
+
+// ============================================================================
+// LLM Call Detail
+// ============================================================================
+
+export function formatLLMCallDetail(call: LLMCallLogEntry): string {
+	const lines: string[] = []
+
+	lines.push(`${BOLD}LLM Call: ${call.id}${RESET}`)
+	lines.push(`  Agent:    ${call.agentId}`)
+	lines.push(`  Status:   ${statusColor(call.status)}${call.status}${RESET}`)
+	lines.push(`  Created:  ${new Date(call.createdAt).toLocaleString()}`)
+	if (call.durationMs !== undefined) {
+		lines.push(`  Duration: ${formatDuration(call.durationMs)}`)
+	}
+
+	// Request
+	lines.push('')
+	lines.push(`${BOLD}Request${RESET}`)
+	lines.push(`  Model:    ${call.request.model}`)
+	lines.push(`  Messages: ${call.request.messages.length}`)
+	lines.push(`  Tools:    ${call.request.toolsCount}`)
+	if (call.request.systemPrompt) {
+		lines.push(`  System:   ${truncate(call.request.systemPrompt, 100)}`)
+	}
+
+	// Response
+	if (call.response) {
+		lines.push('')
+		lines.push(`${BOLD}Response${RESET}`)
+		lines.push(`  Finish:   ${call.response.finishReason}`)
+		if (call.response.content) {
+			lines.push(`  Content:  ${truncate(call.response.content, 200)}`)
+		}
+		if (call.response.toolCalls.length > 0) {
+			lines.push(`  Tool calls: ${call.response.toolCalls.length}`)
+			for (const tc of call.response.toolCalls) {
+				lines.push(`    ${MAGENTA}${tc.name}${RESET} ${DIM}${tc.id}${RESET}`)
+			}
+		}
+	}
+
+	// Metrics
+	if (call.metrics) {
+		lines.push('')
+		lines.push(`${BOLD}Metrics${RESET}`)
+		lines.push(`  Prompt:     ${call.metrics.promptTokens.toLocaleString()} tokens`)
+		lines.push(`  Completion: ${call.metrics.completionTokens.toLocaleString()} tokens`)
+		lines.push(`  Total:      ${call.metrics.totalTokens.toLocaleString()} tokens`)
+		if (call.metrics.cost !== undefined) {
+			lines.push(`  Cost:       $${call.metrics.cost.toFixed(4)}`)
+		}
+		lines.push(`  Latency:    ${formatDuration(call.metrics.latencyMs)}`)
+	}
+
+	// Error
+	if (call.error) {
+		lines.push('')
+		lines.push(`${RED}${BOLD}Error${RESET}`)
+		lines.push(`  ${RED}${call.error.type}: ${call.error.message}${RESET}`)
+	}
+
+	return lines.join('\n')
+}
+
+// ============================================================================
+// Event Row
+// ============================================================================
+
+export function formatEventRow(event: DomainEvent, index: number): string[] {
+	const agentId = 'agentId' in event ? String(event.agentId) : '-'
+	return [
+		String(index),
+		event.type,
+		truncate(agentId, 24),
+		formatTimestamp(event.timestamp),
+	]
+}