@roj-ai/cli 0.0.2

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import { RpcClient } from '@roj-ai/shared/rpc';
+import type { ProtocolDef } from '@roj-ai/transport';
+import { ClientConnection } from '@roj-ai/transport/client';
+export declare function createCliClient(baseUrl: string): RpcClient;
+export type WsConnection = ClientConnection<ProtocolDef, ProtocolDef>;
+export type NotificationHandlers = Record<string, (payload: unknown) => void>;
+export declare function connectWebSocket(baseUrl: string, sessionId: string, handlers: NotificationHandlers): WsConnection;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAA;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE1D;AAED,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;AAErE,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,CAAA;AAE7E,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,GAC5B,YAAY,CAuBd"}

package/dist/client.js

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

package/dist/commands/answer.d.ts

@@ -0,0 +1,3 @@
+import type { RpcClient } from '@roj-ai/shared/rpc';
+export declare function answerCommand(client: RpcClient, sessionId: string, questionId: string, answer: string, json: boolean): Promise<void>;
+//# sourceMappingURL=answer.d.ts.map

package/dist/commands/answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../src/commands/answer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGnD,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/commands/answer.js

@@ -0,0 +1,15 @@
+import { AgentId, ChatMessageId } from '@roj-ai/shared';
+import { unwrap } from '../unwrap.js';
+export async function answerCommand(client, sessionId, questionId, answer, json) {
+    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/dist/commands/debug-format.d.ts

@@ -0,0 +1,12 @@
+import type { LLMCallLogEntry } from '@roj-ai/sdk';
+import type { DomainEvent } from '@roj-ai/sdk';
+import type { AgentTreeNode, GetAgentDetailResponse, GetMetricsResponse, GlobalMailboxMessage, TimelineItem } from '@roj-ai/shared';
+export declare function truncate(str: string, maxLen: number): string;
+export declare function formatAgentTree(nodes: AgentTreeNode[]): string;
+export declare function formatAgentDetail(detail: GetAgentDetailResponse): string;
+export declare function formatTimelineItem(item: TimelineItem): string;
+export declare function formatMailboxMessage(msg: GlobalMailboxMessage): string;
+export declare function formatMetrics(metrics: GetMetricsResponse): string;
+export declare function formatLLMCallDetail(call: LLMCallLogEntry): string;
+export declare function formatEventRow(event: DomainEvent, index: number): string[];
+//# sourceMappingURL=debug-format.d.ts.map

package/dist/commands/debug-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-format.d.ts","sourceRoot":"","sources":["../../src/commands/debug-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EACX,aAAa,EAEb,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,MAAM,gBAAgB,CAAA;AAYvB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAgCD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAO9D;AAmCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA8CxE;AAwBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAsB7D;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAItE;AAMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAcjE;AAMD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CA0DjE;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1E"}

package/dist/commands/debug-format.js

@@ -0,0 +1,262 @@
+// 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, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 1) + '\u2026';
+}
+function formatDuration(ms) {
+    if (ms === undefined)
+        return '-';
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function formatTimestamp(ts) {
+    return new Date(ts).toLocaleTimeString();
+}
+function statusColor(status) {
+    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) {
+    const lines = [];
+    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) {
+    if (cost >= 1)
+        return `$${cost.toFixed(2)}`;
+    return `$${cost.toFixed(4)}`;
+}
+function formatTreeNode(lines, node, prefix, isLast) {
+    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 = [];
+    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) {
+    const lines = [];
+    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) {
+    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) {
+    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) {
+    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) {
+    const lines = [];
+    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) {
+    const lines = [];
+    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, index) {
+    const agentId = 'agentId' in event ? String(event.agentId) : '-';
+    return [
+        String(index),
+        event.type,
+        truncate(agentId, 24),
+        formatTimestamp(event.timestamp),
+    ];
+}

package/dist/commands/debug.d.ts

@@ -0,0 +1,14 @@
+import type { SessionId } from '@roj-ai/sdk';
+import type { RpcClient } from '@roj-ai/shared/rpc';
+export declare function eventsCommand(client: RpcClient, sessionId: string, flags: Record<string, string | true>, json: boolean): Promise<void>;
+export declare function llmCallsCommand(client: RpcClient, sessionId: string, flags: Record<string, string | true>, json: boolean): Promise<void>;
+export declare function llmCallCommand(client: RpcClient, sessionId: string, callId: string, json: boolean): Promise<void>;
+export declare function presetAgentsCommand(client: RpcClient, sessionId: SessionId, json: boolean): Promise<void>;
+export declare function debugSendCommand(client: RpcClient, sessionId: string, agentId: string, content: string, flags: Record<string, string | true>, json: boolean): Promise<void>;
+export declare function spawnAgentCommand(client: RpcClient, sessionId: string, definitionName: string, parentId: string, flags: Record<string, string | true>, json: boolean): Promise<void>;
+export declare function agentsCommand(client: RpcClient, sessionId: string, json: boolean): Promise<void>;
+export declare function agentCommand(client: RpcClient, sessionId: string, agentId: string, json: boolean): Promise<void>;
+export declare function mailboxCommand(client: RpcClient, sessionId: string, json: boolean): Promise<void>;
+export declare function timelineCommand(client: RpcClient, sessionId: string, json: boolean): Promise<void>;
+export declare function metricsCommand(client: RpcClient, sessionId: string, json: boolean): Promise<void>;
+//# sourceMappingURL=debug.d.ts.map

package/dist/commands/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,SAAS,EAAE,MAAM,aAAa,CAAA;AA0B1E,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,oBAAoB,CAAA;AAmD9D,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EACpC,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EACpC,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EACpC,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EACpC,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAUf;AAMD,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/commands/debug.js

@@ -0,0 +1,187 @@
+import { AgentId, applyEventToAgentDetail, applyEventToAgentRegistry, applyEventToAgentTree, applyEventToMailbox, applyEventToMetrics, applyEventToTimeline, buildAgentTreeFromProjection, createAgentDetailProjectionState, createAgentRegistryState, createAgentTreeProjectionState, createMailboxState, createMetricsState, createTimelineState, getAgentDetail, getMailboxMessages, getTimelineItems, isDomainEvent, metricsStateToResponse, } from '@roj-ai/shared';
+import { formatTable } from '../repl/formatter.js';
+import { unwrap } from '../unwrap.js';
+import { formatAgentDetail, formatAgentTree, formatEventRow, formatLLMCallDetail, formatMailboxMessage, formatMetrics, formatTimelineItem, } from './debug-format.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function isLLMCallLogEntry(data) {
+    return typeof data === 'object' && data !== null && 'id' in data && 'status' in data && 'request' in data;
+}
+async function loadProjections(client, sessionId) {
+    const { events: rawEvents } = unwrap(await client.call('sessions.getEvents', { sessionId, limit: 10000 }));
+    const events = rawEvents.filter(isDomainEvent);
+    let registry = createAgentRegistryState();
+    let agentTree = createAgentTreeProjectionState();
+    let agentDetail = createAgentDetailProjectionState();
+    for (const event of events) {
+        const e = event;
+        registry = applyEventToAgentRegistry(registry, e);
+        agentTree = applyEventToAgentTree(agentTree, e);
+        agentDetail = applyEventToAgentDetail(agentDetail, e);
+    }
+    return { registry, agentTree, agentDetail, events };
+}
+// ============================================================================
+// Direct RPC Commands
+// ============================================================================
+export async function eventsCommand(client, sessionId, flags, json) {
+    const limit = typeof flags.limit === 'string' ? parseInt(flags.limit, 10) : undefined;
+    const type = typeof flags.type === 'string' ? flags.type : undefined;
+    const agentId = typeof flags.agent === 'string' ? flags.agent : undefined;
+    const { events: rawEvents, total } = unwrap(await client.call('sessions.getEvents', { sessionId, limit, type, agentId }));
+    const events = rawEvents.filter(isDomainEvent);
+    if (json) {
+        console.log(JSON.stringify({ events, total }, null, 2));
+        return;
+    }
+    if (events.length === 0) {
+        console.log('No events found.');
+        return;
+    }
+    console.log(formatTable(['#', 'Type', 'Agent', 'Time'], events.map((e, i) => formatEventRow(e, i))));
+    console.log(`\nTotal: ${total} events`);
+}
+export async function llmCallsCommand(client, sessionId, flags, json) {
+    const limit = typeof flags.limit === 'string' ? parseInt(flags.limit, 10) : undefined;
+    const { calls, total } = unwrap(await client.call('llm.getCalls', { sessionId, limit }));
+    if (json) {
+        console.log(JSON.stringify({ calls, total }, null, 2));
+        return;
+    }
+    if (calls.length === 0) {
+        console.log('No LLM calls found.');
+        return;
+    }
+    const typedCalls = calls.filter(isLLMCallLogEntry);
+    console.log(formatTable(['Time', 'Status', 'Model', 'Duration', 'Tokens', 'Cost', 'Agent'], typedCalls.map((c) => {
+        const time = new Date(c.createdAt).toLocaleTimeString();
+        const duration = c.durationMs !== undefined ? `${(c.durationMs / 1000).toFixed(1)}s` : '-';
+        const tokens = c.metrics ? `${c.metrics.promptTokens}/${c.metrics.completionTokens}` : '-';
+        const cost = c.metrics?.cost !== undefined ? `$${c.metrics.cost.toFixed(4)}` : '-';
+        return [time, c.status, c.request.model, duration, tokens, cost, String(c.agentId)];
+    })));
+    console.log(`\nTotal: ${total} calls`);
+}
+export async function llmCallCommand(client, sessionId, callId, json) {
+    const callData = unwrap(await client.call('llm.getCall', { sessionId, callId }));
+    if (json) {
+        console.log(JSON.stringify(callData, null, 2));
+        return;
+    }
+    if (!isLLMCallLogEntry(callData)) {
+        console.error('Invalid LLM call data.');
+        return;
+    }
+    console.log(formatLLMCallDetail(callData));
+}
+export async function presetAgentsCommand(client, sessionId, json) {
+    const result = unwrap(await client.call('presets.getAgents', { sessionId }));
+    const agents = result.agents;
+    if (json) {
+        console.log(JSON.stringify(agents, null, 2));
+        return;
+    }
+    if (agents.length === 0) {
+        console.log('No agent definitions found.');
+        return;
+    }
+    console.log(formatTable(['Name', 'Spawnable By', 'Has Input Schema'], agents.map((a) => [a.name, a.spawnableBy.join(', '), a.hasInputSchema ? 'yes' : 'no'])));
+}
+export async function debugSendCommand(client, sessionId, agentId, content, flags, json) {
+    const { messageId } = unwrap(await client.call('user-chat.sendMessage', { sessionId, agentId: AgentId(agentId), content }));
+    if (json) {
+        console.log(JSON.stringify({ messageId }));
+        return;
+    }
+    console.log(`Message sent: ${messageId}`);
+}
+export async function spawnAgentCommand(client, sessionId, definitionName, parentId, flags, json) {
+    const message = typeof flags.message === 'string' ? flags.message : undefined;
+    const { agentId } = unwrap(await client.call('agents.spawn', { sessionId, definitionName, parentId: AgentId(parentId), message }));
+    if (json) {
+        console.log(JSON.stringify({ agentId }));
+        return;
+    }
+    console.log(`Agent spawned: ${agentId}`);
+}
+// ============================================================================
+// Event-sourced Projection Commands
+// ============================================================================
+export async function agentsCommand(client, sessionId, json) {
+    const { agentTree: agentTreeState } = await loadProjections(client, sessionId);
+    const tree = buildAgentTreeFromProjection(agentTreeState);
+    if (json) {
+        console.log(JSON.stringify(tree, null, 2));
+        return;
+    }
+    if (tree.length === 0) {
+        console.log('No agents.');
+        return;
+    }
+    console.log(formatAgentTree(tree));
+}
+export async function agentCommand(client, sessionId, agentId, json) {
+    const { agentDetail: agentDetailState } = await loadProjections(client, sessionId);
+    const detail = getAgentDetail(agentDetailState, AgentId(agentId));
+    if (!detail) {
+        console.error(`Agent not found: ${agentId}`);
+        process.exit(1);
+    }
+    if (json) {
+        console.log(JSON.stringify(detail, null, 2));
+        return;
+    }
+    console.log(formatAgentDetail(detail));
+}
+export async function mailboxCommand(client, sessionId, json) {
+    const { registry, events } = await loadProjections(client, sessionId);
+    let mailboxState = createMailboxState();
+    for (const event of events) {
+        mailboxState = applyEventToMailbox(mailboxState, event, registry);
+    }
+    const messages = getMailboxMessages(mailboxState);
+    if (json) {
+        console.log(JSON.stringify(messages, null, 2));
+        return;
+    }
+    if (messages.length === 0) {
+        console.log('No mailbox messages.');
+        return;
+    }
+    for (const msg of messages) {
+        console.log(formatMailboxMessage(msg));
+    }
+}
+export async function timelineCommand(client, sessionId, json) {
+    const { registry, events } = await loadProjections(client, sessionId);
+    let timelineState = createTimelineState();
+    for (const event of events) {
+        timelineState = applyEventToTimeline(timelineState, event, registry);
+    }
+    const items = getTimelineItems(timelineState, registry);
+    if (json) {
+        console.log(JSON.stringify(items, null, 2));
+        return;
+    }
+    if (items.length === 0) {
+        console.log('No timeline items.');
+        return;
+    }
+    for (const item of items) {
+        console.log(formatTimelineItem(item));
+    }
+}
+export async function metricsCommand(client, sessionId, json) {
+    const { registry, events } = await loadProjections(client, sessionId);
+    let metricsState = createMetricsState();
+    for (const event of events) {
+        metricsState = applyEventToMetrics(metricsState, event);
+    }
+    const metrics = metricsStateToResponse(metricsState, registry.count);
+    if (json) {
+        console.log(JSON.stringify(metrics, null, 2));
+        return;
+    }
+    console.log(formatMetrics(metrics));
+}

package/dist/commands/messages.d.ts

@@ -0,0 +1,4 @@
+import type { RpcClient } from '@roj-ai/shared/rpc';
+export declare function messagesCommand(client: RpcClient, sessionId: string, json: boolean): Promise<void>;
+export declare function sendCommand(client: RpcClient, baseUrl: string, sessionId: string, content: string, wait: boolean, json: boolean): Promise<void>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/commands/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AASnD,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxG;AAED,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAqDf"}

package/dist/commands/messages.js

@@ -0,0 +1,77 @@
+import { AgentId } from '@roj-ai/shared';
+import { connectWebSocket } from '../client.js';
+import { formatChatMessage } from '../repl/formatter.js';
+import { unwrap } from '../unwrap.js';
+function isChatMessage(msg) {
+    return typeof msg === 'object' && msg !== null && 'type' in msg && 'timestamp' in msg;
+}
+export async function messagesCommand(client, sessionId, json) {
+    const { messages: rawMessages } = unwrap(await client.call('user-chat.getMessages', { sessionId }));
+    const messages = rawMessages.filter(isChatMessage);
+    if (json) {
+        console.log(JSON.stringify(messages, null, 2));
+        return;
+    }
+    if (messages.length === 0) {
+        console.log('No messages.');
+        return;
+    }
+    for (const msg of messages) {
+        console.log(formatChatMessage(msg));
+        console.log();
+    }
+}
+export async function sendCommand(client, baseUrl, sessionId, content, wait, json) {
+    const session = unwrap(await client.call('sessions.get', { sessionId }));
+    if (!session.entryAgentId) {
+        console.error('No entry agent found for session.');
+        process.exit(1);
+    }
+    const { messageId } = unwrap(await client.call('user-chat.sendMessage', { sessionId, agentId: AgentId(session.entryAgentId), content }));
+    if (!wait) {
+        if (json) {
+            console.log(JSON.stringify({ messageId }));
+        }
+        else {
+            console.log(`Message sent: ${messageId}`);
+        }
+        return;
+    }
+    // Wait for agent response via WebSocket
+    const responsePromise = new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            connection.disconnect();
+            reject(new Error('Timeout waiting for agent response'));
+        }, 120_000);
+        const connection = connectWebSocket(baseUrl, sessionId, {
+            agentMessage: (payload) => {
+                if (typeof payload !== 'object' || payload === null)
+                    return;
+                const input = payload;
+                if (typeof input.content !== 'string')
+                    return;
+                clearTimeout(timeout);
+                connection.disconnect();
+                resolve(input.content);
+            },
+            error: (payload) => {
+                if (typeof payload !== 'object' || payload === null)
+                    return;
+                const input = payload;
+                if (typeof input.message !== 'string')
+                    return;
+                clearTimeout(timeout);
+                connection.disconnect();
+                reject(new Error(input.message));
+            },
+        });
+        connection.connect().catch(reject);
+    });
+    const response = await responsePromise;
+    if (json) {
+        console.log(JSON.stringify({ messageId, response }));
+    }
+    else {
+        console.log(response);
+    }
+}

package/dist/commands/presets.d.ts

@@ -0,0 +1,3 @@
+import type { RpcClient } from '@roj-ai/shared/rpc';
+export declare function presetsCommand(client: RpcClient, json: boolean): Promise<void>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/commands/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/commands/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAInD,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpF"}