@orchagent/cli 0.3.87 → 0.3.88

package/dist/commands/index.js

@@ -40,6 +40,9 @@ const diff_1 = require("./diff");
 const health_1 = require("./health");
 const dev_1 = require("./dev");
 const estimate_1 = require("./estimate");
+const replay_1 = require("./replay");
+const trace_1 = require("./trace");
+const metrics_1 = require("./metrics");
 function registerCommands(program) {
     (0, login_1.registerLoginCommand)(program);
     (0, logout_1.registerLogoutCommand)(program);
@@ -80,4 +83,7 @@ function registerCommands(program) {
     (0, health_1.registerHealthCommand)(program);
     (0, dev_1.registerDevCommand)(program);
     (0, estimate_1.registerEstimateCommand)(program);
+    (0, replay_1.registerReplayCommand)(program);
+    (0, trace_1.registerTraceCommand)(program);
+    (0, metrics_1.registerMetricsCommand)(program);
 }

package/dist/commands/metrics.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMetricsCommand = registerMetricsCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const errors_1 = require("../lib/errors");
+const output_1 = require("../lib/output");
+// ============================================
+// HELPERS
+// ============================================
+async function resolveWorkspaceId(config, slug) {
+    const configFile = await (0, config_1.loadConfig)();
+    const targetSlug = slug ?? configFile.workspace;
+    if (!targetSlug) {
+        throw new errors_1.CliError('No workspace specified. Use --workspace <slug> or run `orch workspace use <slug>` first.');
+    }
+    const response = await (0, api_1.request)(config, 'GET', '/workspaces');
+    const workspace = response.workspaces.find((w) => w.slug === targetSlug);
+    if (!workspace) {
+        throw new errors_1.CliError(`Workspace '${targetSlug}' not found.`);
+    }
+    return workspace.id;
+}
+function formatDuration(ms) {
+    if (ms === 0)
+        return '-';
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function rateColor(rate) {
+    if (rate >= 95)
+        return chalk_1.default.green(`${rate}%`);
+    if (rate >= 80)
+        return chalk_1.default.yellow(`${rate}%`);
+    return chalk_1.default.red(`${rate}%`);
+}
+function padRight(str, len) {
+    return str.length >= len ? str.slice(0, len) : str + ' '.repeat(len - str.length);
+}
+function padLeft(str, len) {
+    return str.length >= len ? str.slice(0, len) : ' '.repeat(len - str.length) + str;
+}
+// ============================================
+// COMMAND
+// ============================================
+function registerMetricsCommand(program) {
+    program
+        .command('metrics')
+        .description('Show agent performance metrics for a workspace')
+        .option('--workspace <slug>', 'Workspace slug (default: active workspace)')
+        .option('--days <n>', 'Number of days to analyze', '30')
+        .option('--agent <name>', 'Filter to a specific agent')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const days = parseInt(options.days || '30', 10);
+        if (isNaN(days) || days < 1 || days > 365) {
+            process.stderr.write(chalk_1.default.red('Error: --days must be between 1 and 365\n'));
+            process.exit(1);
+        }
+        const params = new URLSearchParams({ days: String(days) });
+        if (options.agent)
+            params.set('agent_name', options.agent);
+        let data;
+        try {
+            data = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/metrics/dashboard?${params}`, { headers: { 'X-Workspace-Id': workspaceId } });
+        }
+        catch (err) {
+            if (err instanceof api_1.ApiError && err.status === 403) {
+                process.stderr.write(chalk_1.default.red('Error: Not a member of this workspace\n'));
+                process.exit(1);
+            }
+            throw err;
+        }
+        if (options.json) {
+            (0, output_1.printJson)(data);
+            return;
+        }
+        const { overview, agents } = data;
+        // Header
+        process.stdout.write('\n');
+        process.stdout.write(chalk_1.default.bold('Agent Metrics') + chalk_1.default.gray(` (last ${days}d)\n`));
+        process.stdout.write('='.repeat(50) + '\n\n');
+        // Overview stats
+        if (overview.total_runs === 0) {
+            process.stdout.write(chalk_1.default.yellow('No runs in this period.\n\n'));
+            return;
+        }
+        process.stdout.write(`  Total Runs:   ${chalk_1.default.bold(String(overview.total_runs))}\n`);
+        process.stdout.write(`  Success Rate: ${rateColor(overview.success_rate)}\n`);
+        process.stdout.write(`  Error Rate:   ${overview.error_rate}% ${chalk_1.default.gray(`(${overview.failed} failed, ${overview.timeout} timeout)`)}\n`);
+        process.stdout.write(`  p50 Latency:  ${chalk_1.default.cyan(formatDuration(overview.p50_latency_ms))}\n`);
+        process.stdout.write(`  p95 Latency:  ${chalk_1.default.yellow(formatDuration(overview.p95_latency_ms))}\n`);
+        process.stdout.write(`  Avg Latency:  ${formatDuration(overview.avg_latency_ms)}\n`);
+        process.stdout.write(`  Runs/Day:     ${overview.runs_per_day}\n`);
+        // Per-agent table
+        if (agents.length > 0) {
+            process.stdout.write(`\n${chalk_1.default.bold('Per Agent')}\n`);
+            process.stdout.write('-'.repeat(90) + '\n');
+            // Header
+            process.stdout.write(padRight('Agent', 25) +
+                padLeft('Runs', 8) +
+                padLeft('Success', 10) +
+                padLeft('p50', 10) +
+                padLeft('p95', 10) +
+                padLeft('Errors', 8) +
+                '  Top Error\n');
+            process.stdout.write('-'.repeat(90) + '\n');
+            for (const agent of agents) {
+                const nameStr = agent.agent_name.length > 22
+                    ? agent.agent_name.slice(0, 22) + '..'
+                    : agent.agent_name;
+                const errorStr = agent.top_error
+                    ? agent.top_error.slice(0, 20)
+                    : '-';
+                process.stdout.write(padRight(nameStr, 25) +
+                    padLeft(String(agent.total_runs), 8) +
+                    padLeft(agent.success_rate >= 95 ? chalk_1.default.green(`${agent.success_rate}%`) :
+                        agent.success_rate >= 80 ? chalk_1.default.yellow(`${agent.success_rate}%`) :
+                            chalk_1.default.red(`${agent.success_rate}%`), 
+                    // chalk adds escape chars — pad the raw value, then colorize
+                    10) +
+                    padLeft(formatDuration(agent.p50_latency_ms), 10) +
+                    padLeft(formatDuration(agent.p95_latency_ms), 10) +
+                    padLeft(String(agent.failed + agent.timeout), 8) +
+                    '  ' + chalk_1.default.gray(errorStr) + '\n');
+            }
+        }
+        process.stdout.write('\n');
+    });
+}

package/dist/commands/replay.js

@@ -0,0 +1,198 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerReplayCommand = registerReplayCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const errors_1 = require("../lib/errors");
+const output_1 = require("../lib/output");
+// ============================================
+// HELPERS
+// ============================================
+async function resolveWorkspaceId(config, slug) {
+    const configFile = await (0, config_1.loadConfig)();
+    const targetSlug = slug ?? configFile.workspace;
+    if (!targetSlug) {
+        throw new errors_1.CliError('No workspace specified. Use --workspace <slug> or run `orch workspace use <slug>` first.');
+    }
+    const response = await (0, api_1.request)(config, 'GET', '/workspaces');
+    const workspace = response.workspaces.find((w) => w.slug === targetSlug);
+    if (!workspace) {
+        throw new errors_1.CliError(`Workspace '${targetSlug}' not found.`);
+    }
+    return workspace.id;
+}
+function isUuid(value) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
+}
+function isShortUuid(value) {
+    return /^[0-9a-f]{7,}$/i.test(value) && !value.includes('/');
+}
+async function resolveShortRunId(config, workspaceId, shortId) {
+    const result = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/runs?limit=200&run_id_prefix=${encodeURIComponent(shortId)}`);
+    if (result.runs.length === 0) {
+        throw new errors_1.CliError(`No run found matching '${shortId}'.`);
+    }
+    if (result.runs.length > 1) {
+        throw new errors_1.CliError(`Ambiguous run ID '${shortId}' — matches ${result.runs.length} runs. Use more characters to narrow it down.`);
+    }
+    return result.runs[0].id;
+}
+function statusColor(status) {
+    if (!status)
+        return '-';
+    switch (status) {
+        case 'completed':
+            return chalk_1.default.green(status);
+        case 'failed':
+            return chalk_1.default.red(status);
+        case 'running':
+        case 'queued':
+        case 'claimed':
+            return chalk_1.default.yellow(status);
+        case 'timeout':
+            return chalk_1.default.red(status);
+        default:
+            return status;
+    }
+}
+function formatDuration(ms) {
+    if (ms == null)
+        return '-';
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${(ms / 60000).toFixed(1)}m`;
+}
+const POLL_INTERVAL_MS = 2000;
+const MAX_POLL_MS = 600000; // 10 minutes
+// ============================================
+// COMMAND REGISTRATION
+// ============================================
+function registerReplayCommand(program) {
+    program
+        .command('replay <run-id>')
+        .description('Replay a previous run. Re-executes with the same input and config from the original snapshot.')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--reason <text>', 'Reason for replay (stored in audit log)')
+        .option('--override-policy <id>', 'Override provider policy ID for this replay')
+        .option('--no-wait', 'Queue the replay and return immediately without waiting for results')
+        .option('--json', 'Output as JSON')
+        .action(async (runId, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        // Resolve short run IDs
+        let resolvedRunId = runId;
+        if (isUuid(runId)) {
+            resolvedRunId = runId;
+        }
+        else if (isShortUuid(runId)) {
+            resolvedRunId = await resolveShortRunId(config, workspaceId, runId);
+        }
+        else {
+            throw new errors_1.CliError(`Invalid run ID '${runId}'. Provide a full UUID or a short hex prefix (7+ characters).`);
+        }
+        // Submit replay request
+        const body = {};
+        if (options.reason)
+            body.reason = options.reason;
+        if (options.overridePolicy)
+            body.override_provider_policy_id = options.overridePolicy;
+        const replay = await (0, api_1.request)(config, 'POST', `/workspaces/${workspaceId}/runs/${resolvedRunId}/replay`, {
+            body: JSON.stringify(body),
+            headers: { 'Content-Type': 'application/json' },
+        });
+        if (options.json && options.wait === false) {
+            (0, output_1.printJson)(replay);
+            return;
+        }
+        if (options.wait === false) {
+            process.stdout.write(chalk_1.default.green('Replay queued.\n') +
+                `  Run ID:     ${replay.run_id}\n` +
+                `  Job ID:     ${replay.job_id}\n` +
+                `  Replaying:  ${replay.replay_of_run_id}\n` +
+                chalk_1.default.gray('\nCheck status: orch logs ' + replay.run_id.slice(0, 8) + '\n'));
+            return;
+        }
+        // Poll for completion
+        if (!options.json) {
+            process.stderr.write(chalk_1.default.gray(`Replaying run ${resolvedRunId.slice(0, 8)}... `));
+        }
+        const startTime = Date.now();
+        let lastStatus = 'queued';
+        let pollResult = null;
+        while (Date.now() - startTime < MAX_POLL_MS) {
+            await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+            try {
+                pollResult = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/runs/${replay.run_id}`);
+            }
+            catch {
+                // Run may not exist yet if job worker hasn't picked it up
+                continue;
+            }
+            lastStatus = pollResult.status;
+            if (!options.json) {
+                const elapsed = ((Date.now() - startTime) / 1000).toFixed(0);
+                process.stderr.write(`\r${chalk_1.default.gray(`Replaying run ${resolvedRunId.slice(0, 8)}... ${statusColor(lastStatus)} (${elapsed}s)`)}`);
+            }
+            if (['completed', 'failed', 'timeout', 'dead_letter', 'cancelled'].includes(lastStatus)) {
+                break;
+            }
+        }
+        if (!options.json) {
+            process.stderr.write('\n');
+        }
+        // Fetch final logs
+        const logs = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/runs/${replay.run_id}/logs`);
+        if (options.json) {
+            (0, output_1.printJson)({
+                replay: {
+                    run_id: replay.run_id,
+                    replay_of_run_id: replay.replay_of_run_id,
+                    job_id: replay.job_id,
+                },
+                result: logs,
+            });
+            return;
+        }
+        // Render results
+        renderReplayResult(replay, logs);
+    });
+}
+// ============================================
+// RENDER REPLAY RESULT
+// ============================================
+function renderReplayResult(replay, logs) {
+    process.stdout.write(chalk_1.default.bold(`\nReplay ${replay.run_id}\n`) +
+        `  Original:  ${replay.replay_of_run_id.slice(0, 8)}\n` +
+        `  Agent:     ${logs.agent_name ?? '-'}@${logs.agent_version ?? '-'}\n` +
+        `  Status:    ${statusColor(logs.run_status)}\n` +
+        `  Duration:  ${formatDuration(logs.execution_time_ms)}\n`);
+    if (logs.exit_code != null) {
+        const exitLabel = logs.exit_code === 0 ? chalk_1.default.green(String(logs.exit_code)) : chalk_1.default.red(String(logs.exit_code));
+        process.stdout.write(`  Exit code: ${exitLabel}\n`);
+    }
+    if (logs.output_data != null && Object.keys(logs.output_data).length > 0) {
+        process.stdout.write('\n' + chalk_1.default.bold.green('--- output ---') + '\n' +
+            JSON.stringify(logs.output_data, null, 2) + '\n');
+    }
+    if (logs.error_message) {
+        process.stdout.write('\n' + chalk_1.default.red.bold('Error:\n') + chalk_1.default.red(logs.error_message) + '\n');
+    }
+    if (logs.stdout) {
+        process.stdout.write('\n' + chalk_1.default.bold.cyan('--- stdout ---') + '\n' + logs.stdout + '\n');
+    }
+    if (logs.stderr) {
+        process.stdout.write('\n' + chalk_1.default.bold.yellow('--- stderr ---') + '\n' + logs.stderr + '\n');
+    }
+    process.stdout.write('\n');
+    // Footer hint
+    process.stdout.write(chalk_1.default.gray(`View trace: orch trace ${replay.run_id.slice(0, 8)}\n`));
+}

package/dist/commands/trace.js

@@ -0,0 +1,311 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTraceCommand = registerTraceCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const errors_1 = require("../lib/errors");
+const output_1 = require("../lib/output");
+// ============================================
+// HELPERS
+// ============================================
+async function resolveWorkspaceId(config, slug) {
+    const configFile = await (0, config_1.loadConfig)();
+    const targetSlug = slug ?? configFile.workspace;
+    if (!targetSlug) {
+        throw new errors_1.CliError('No workspace specified. Use --workspace <slug> or run `orch workspace use <slug>` first.');
+    }
+    const response = await (0, api_1.request)(config, 'GET', '/workspaces');
+    const workspace = response.workspaces.find((w) => w.slug === targetSlug);
+    if (!workspace) {
+        throw new errors_1.CliError(`Workspace '${targetSlug}' not found.`);
+    }
+    return workspace.id;
+}
+function isUuid(value) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
+}
+function isShortUuid(value) {
+    return /^[0-9a-f]{7,}$/i.test(value) && !value.includes('/');
+}
+async function resolveShortRunId(config, workspaceId, shortId) {
+    const result = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/runs?limit=200&run_id_prefix=${encodeURIComponent(shortId)}`);
+    if (result.runs.length === 0) {
+        throw new errors_1.CliError(`No run found matching '${shortId}'.`);
+    }
+    if (result.runs.length > 1) {
+        throw new errors_1.CliError(`Ambiguous run ID '${shortId}' — matches ${result.runs.length} runs. Use more characters to narrow it down.`);
+    }
+    return result.runs[0].id;
+}
+function statusColor(status) {
+    if (!status)
+        return '-';
+    switch (status) {
+        case 'completed':
+            return chalk_1.default.green(status);
+        case 'failed':
+            return chalk_1.default.red(status);
+        case 'running':
+            return chalk_1.default.yellow(status);
+        case 'timeout':
+            return chalk_1.default.red(status);
+        default:
+            return status;
+    }
+}
+function formatDuration(ms) {
+    if (ms == null)
+        return '-';
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${(ms / 60000).toFixed(1)}m`;
+}
+function formatCost(usd) {
+    if (usd == null || usd === 0)
+        return '-';
+    if (usd < 0.01)
+        return `$${usd.toFixed(6)}`;
+    return `$${usd.toFixed(4)}`;
+}
+function formatTokens(input, output) {
+    const parts = [];
+    if (input)
+        parts.push(`${input.toLocaleString()} in`);
+    if (output)
+        parts.push(`${output.toLocaleString()} out`);
+    return parts.length > 0 ? parts.join(', ') : '-';
+}
+// ============================================
+// COMMAND REGISTRATION
+// ============================================
+function registerTraceCommand(program) {
+    program
+        .command('trace <run-id>')
+        .description('View the execution trace for a run. Shows LLM calls, tool calls, decisions, and errors in timeline order.')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--json', 'Output as JSON')
+        .action(async (runId, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        // Resolve short run IDs
+        let resolvedRunId = runId;
+        if (isUuid(runId)) {
+            resolvedRunId = runId;
+        }
+        else if (isShortUuid(runId)) {
+            resolvedRunId = await resolveShortRunId(config, workspaceId, runId);
+        }
+        else {
+            throw new errors_1.CliError(`Invalid run ID '${runId}'. Provide a full UUID or a short hex prefix (7+ characters).`);
+        }
+        // Fetch run detail for context
+        const run = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/runs/${resolvedRunId}`);
+        // Fetch trace header
+        let trace;
+        try {
+            const traceResp = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/runs/${resolvedRunId}/trace`);
+            trace = traceResp.trace;
+        }
+        catch {
+            throw new errors_1.CliError(`No trace available for run ${resolvedRunId.slice(0, 8)}. Traces are captured for cloud runs only.`);
+        }
+        // Fetch all trace events (paginate if needed)
+        const allEvents = [];
+        let offset = 0;
+        const pageSize = 500;
+        while (true) {
+            const eventsResp = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/traces/${trace.id}/events?limit=${pageSize}&offset=${offset}`);
+            allEvents.push(...eventsResp.events);
+            if (eventsResp.next_cursor === null || allEvents.length >= eventsResp.total) {
+                break;
+            }
+            offset = parseInt(eventsResp.next_cursor, 10);
+        }
+        if (options.json) {
+            (0, output_1.printJson)({ run, trace, events: allEvents });
+            return;
+        }
+        renderTrace(run, trace, allEvents);
+    });
+}
+// ============================================
+// TRACE RENDERING
+// ============================================
+function renderTrace(run, trace, events) {
+    // Header
+    process.stdout.write(chalk_1.default.bold(`\nTrace for run ${run.id}\n`) +
+        `  Agent:    ${run.agent_name ?? '-'}@${run.agent_version ?? '-'}\n` +
+        `  Status:   ${statusColor(run.status)}\n` +
+        `  Duration: ${formatDuration(run.duration_ms)}\n` +
+        `  Source:   ${run.trigger_source ?? '-'}\n`);
+    // Aggregate stats
+    const stats = computeStats(events);
+    if (stats.totalLlmCalls > 0 || stats.totalToolCalls > 0) {
+        process.stdout.write('\n' + chalk_1.default.bold('  Summary\n'));
+        if (stats.totalLlmCalls > 0) {
+            process.stdout.write(`    LLM calls:   ${stats.totalLlmCalls}` +
+                `  (${formatTokens(stats.totalTokenInput, stats.totalTokenOutput)})` +
+                `  cost: ${formatCost(stats.totalCostUsd)}\n`);
+        }
+        if (stats.totalToolCalls > 0) {
+            process.stdout.write(`    Tool calls:  ${stats.totalToolCalls}\n`);
+        }
+        if (stats.providers.length > 0) {
+            process.stdout.write(`    Providers:   ${stats.providers.join(', ')}\n`);
+        }
+        if (stats.totalErrors > 0) {
+            process.stdout.write(`    Errors:      ${chalk_1.default.red(String(stats.totalErrors))}\n`);
+        }
+    }
+    if (events.length === 0) {
+        process.stdout.write(chalk_1.default.gray('\n  No trace events recorded.\n\n'));
+        return;
+    }
+    // Timeline
+    process.stdout.write('\n' + chalk_1.default.bold('  Timeline\n'));
+    for (const event of events) {
+        renderEvent(event);
+    }
+    process.stdout.write('\n');
+    // Footer hint
+    process.stdout.write(chalk_1.default.gray(`View logs: orch logs ${run.id.slice(0, 8)}\n`));
+    process.stdout.write(chalk_1.default.gray(`Replay:   orch replay ${run.id.slice(0, 8)}\n`));
+}
+function computeStats(events) {
+    const stats = {
+        totalLlmCalls: 0,
+        totalToolCalls: 0,
+        totalErrors: 0,
+        totalTokenInput: 0,
+        totalTokenOutput: 0,
+        totalCostUsd: 0,
+        providers: [],
+    };
+    const providerSet = new Set();
+    for (const e of events) {
+        if (e.event_type === 'llm_call_succeeded') {
+            stats.totalLlmCalls++;
+            stats.totalTokenInput += e.token_input ?? 0;
+            stats.totalTokenOutput += e.token_output ?? 0;
+            stats.totalCostUsd += e.cost_usd ?? 0;
+            if (e.provider)
+                providerSet.add(e.provider);
+        }
+        else if (e.event_type === 'llm_call_failed') {
+            stats.totalLlmCalls++;
+            stats.totalErrors++;
+            if (e.provider)
+                providerSet.add(e.provider);
+        }
+        else if (e.event_type === 'tool_call_succeeded') {
+            stats.totalToolCalls++;
+        }
+        else if (e.event_type === 'tool_call_failed') {
+            stats.totalToolCalls++;
+            stats.totalErrors++;
+        }
+        else if (e.event_type === 'error') {
+            stats.totalErrors++;
+        }
+        else if (e.event_type === 'policy_violation') {
+            stats.totalErrors++;
+        }
+    }
+    stats.providers = Array.from(providerSet);
+    return stats;
+}
+function renderEvent(event) {
+    const seq = chalk_1.default.gray(`  #${String(event.sequence_no).padStart(2, ' ')} `);
+    switch (event.event_type) {
+        case 'llm_call_started': {
+            const provider = event.provider ?? '?';
+            const model = event.model ?? '?';
+            process.stdout.write(seq + chalk_1.default.blue('LLM ') + chalk_1.default.gray(`${provider}/${model} started\n`));
+            break;
+        }
+        case 'llm_call_succeeded': {
+            const provider = event.provider ?? '?';
+            const model = event.model ?? '?';
+            const tokens = formatTokens(event.token_input, event.token_output);
+            const cost = formatCost(event.cost_usd);
+            const dur = formatDuration(event.duration_ms);
+            process.stdout.write(seq + chalk_1.default.green('LLM ') +
+                `${provider}/${model}` +
+                chalk_1.default.gray(` | ${tokens} | ${cost} | ${dur}`) + '\n');
+            break;
+        }
+        case 'llm_call_failed': {
+            const provider = event.provider ?? '?';
+            const model = event.model ?? '?';
+            const errMsg = event.error_message || event.error_type || 'unknown error';
+            const dur = formatDuration(event.duration_ms);
+            process.stdout.write(seq + chalk_1.default.red('LLM ') +
+                `${provider}/${model} ` +
+                chalk_1.default.red(errMsg) +
+                chalk_1.default.gray(` | ${dur}`) + '\n');
+            break;
+        }
+        case 'tool_call_started': {
+            const toolName = event.payload?.tool_name || '?';
+            process.stdout.write(seq + chalk_1.default.cyan('TOOL ') + chalk_1.default.gray(`${toolName} started\n`));
+            break;
+        }
+        case 'tool_call_succeeded': {
+            const toolName = event.payload?.tool_name || '?';
+            const dur = formatDuration(event.duration_ms);
+            process.stdout.write(seq + chalk_1.default.green('TOOL ') + `${toolName}` +
+                chalk_1.default.gray(` | ${dur}`) + '\n');
+            break;
+        }
+        case 'tool_call_failed': {
+            const toolName = event.payload?.tool_name || '?';
+            const errMsg = event.error_message || event.error_type || 'unknown error';
+            const dur = formatDuration(event.duration_ms);
+            process.stdout.write(seq + chalk_1.default.red('TOOL ') + `${toolName} ` +
+                chalk_1.default.red(errMsg) +
+                chalk_1.default.gray(` | ${dur}`) + '\n');
+            break;
+        }
+        case 'decision': {
+            const desc = event.payload?.description || 'decision';
+            process.stdout.write(seq + chalk_1.default.magenta('DECIDE ') + chalk_1.default.gray(desc) + '\n');
+            break;
+        }
+        case 'fallback_transition': {
+            const from = event.payload?.from_provider || '?';
+            const to = event.payload?.to_provider || '?';
+            const reason = event.payload?.reason || '';
+            process.stdout.write(seq + chalk_1.default.yellow('FALLBACK ') +
+                `${from} -> ${to}` +
+                (reason ? chalk_1.default.gray(` (${reason})`) : '') + '\n');
+            break;
+        }
+        case 'policy_violation': {
+            const vType = event.payload?.violation_type || 'violation';
+            const detail = event.payload?.detail || '';
+            process.stdout.write(seq + chalk_1.default.red('POLICY ') + chalk_1.default.red(vType) +
+                (detail ? chalk_1.default.gray(` — ${detail}`) : '') + '\n');
+            break;
+        }
+        case 'error': {
+            const errType = event.error_type || 'error';
+            const errMsg = event.error_message || '';
+            process.stdout.write(seq + chalk_1.default.red('ERROR ') + chalk_1.default.red(errType) +
+                (errMsg ? chalk_1.default.gray(` — ${errMsg}`) : '') + '\n');
+            break;
+        }
+        default: {
+            // Unknown event type — show raw
+            process.stdout.write(seq + chalk_1.default.gray(event.event_type) + '\n');
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.3.87",
+  "version": "0.3.88",
   "description": "Command-line interface for orchagent — deploy and run AI agents for your team",
   "license": "MIT",
   "author": "orchagent <hello@orchagent.io>",