@defai.digital/cli 13.4.1 → 13.4.3

package/dist/commands/trace.js

@@ -1,61 +1,47 @@
-import { LIMIT_DEFAULT, getErrorMessage } from '@defai.digital/contracts';
+import { LIMIT_DEFAULT } from '@defai.digital/contracts';
 import { getTraceStore } from '../bootstrap.js';
+import { success, successJson, failure, failureFromError, formatList, } from '../utils/formatters.js';
 /**
  * Handles the 'trace' command - views trace information
  */
 export async function traceCommand(args, options) {
     const traceId = args[0] ?? options.traceId;
-    // If no trace ID, list recent traces
-    if (traceId === undefined) {
-        return listTraces(options);
-    }
-    // Get specific trace
-    return getTrace(traceId, options);
+    return traceId === undefined
+        ? listTraces(options)
+        : getTrace(traceId, options);
 }
 /**
  * Lists recent traces
  */
 async function listTraces(options) {
     try {
-        // Get traces (in real implementation, from trace store)
-        const traces = await getRecentTraces(options.limit ?? LIMIT_DEFAULT);
+        const store = getTraceStore();
+        const summaries = await store.listTraces(options.limit ?? LIMIT_DEFAULT);
+        const traces = summaries.map(s => ({
+            traceId: s.traceId,
+            startTime: s.startTime,
+            endTime: s.endTime,
+            status: s.status,
+            eventCount: s.eventCount,
+            durationMs: s.durationMs,
+        }));
         if (traces.length === 0) {
-            return {
-                success: true,
-                message: 'No traces found.',
-                data: [],
-                exitCode: 0,
-            };
+            return success('No traces found.', []);
         }
         if (options.format === 'json') {
-            return {
-                success: true,
-                message: undefined,
-                data: traces,
-                exitCode: 0,
-            };
+            return successJson(traces);
         }
-        // Format as text table
-        const header = 'Trace ID                             | Start Time          | Status  | Events | Duration';
-        const separator = '-'.repeat(header.length);
-        const rows = traces.map((trace) => {
-            const duration = trace.durationMs !== undefined ? `${String(trace.durationMs)}ms` : 'N/A';
-            return `${trace.traceId} | ${trace.startTime.slice(0, 19)} | ${trace.status.padEnd(7)} | ${String(trace.eventCount).padEnd(6)} | ${duration}`;
-        });
-        return {
-            success: true,
-            message: [header, separator, ...rows].join('\n'),
-            data: traces,
-            exitCode: 0,
-        };
+        const table = formatList(traces, [
+            { header: 'Trace ID', width: 36, getValue: t => t.traceId },
+            { header: 'Start Time', width: 19, getValue: t => t.startTime.slice(0, 19) },
+            { header: 'Status', width: 7, getValue: t => t.status },
+            { header: 'Events', width: 6, getValue: t => String(t.eventCount) },
+            { header: 'Duration', width: 10, getValue: t => t.durationMs !== undefined ? `${t.durationMs}ms` : 'N/A' },
+        ]);
+        return success(table, traces);
     }
     catch (error) {
-        return {
-            success: false,
-            message: `Failed to list traces: ${getErrorMessage(error)}`,
-            data: undefined,
-            exitCode: 1,
-        };
+        return failureFromError('list traces', error);
     }
 }
 /**
@@ -63,76 +49,40 @@ async function listTraces(options) {
  */
 async function getTrace(traceId, options) {
     try {
-        const events = await getTraceEvents(traceId);
+        const store = getTraceStore();
+        const events = await store.getTrace(traceId);
         if (events.length === 0) {
-            return {
-                success: false,
-                message: `Trace not found: ${traceId}`,
-                data: undefined,
-                exitCode: 1,
-            };
+            return failure(`Trace not found: ${traceId}`);
         }
+        const data = { traceId, events };
         if (options.format === 'json') {
-            return {
-                success: true,
-                message: undefined,
-                data: { traceId, events },
-                exitCode: 0,
-            };
+            return successJson(data);
         }
         // Format as timeline
         const lines = [
             `Trace: ${traceId}`,
-            `Events: ${String(events.length)}`,
+            `Events: ${events.length}`,
             '',
             'Timeline:',
+            ...events.map(e => formatEventLine(e, options.verbose)),
         ];
-        for (const event of events) {
-            const seq = event.sequence !== undefined ? `[${String(event.sequence)}]` : '[-]';
-            const status = event.status !== undefined ? ` (${event.status})` : '';
-            const duration = event.durationMs !== undefined ? ` - ${String(event.durationMs)}ms` : '';
-            lines.push(`  ${seq} ${event.type}${status}${duration}`);
-            if (options.verbose && event.payload !== undefined) {
-                lines.push(`      Payload: ${JSON.stringify(event.payload)}`);
-            }
-        }
-        return {
-            success: true,
-            message: lines.join('\n'),
-            data: { traceId, events },
-            exitCode: 0,
-        };
+        return success(lines.join('\n'), data);
     }
     catch (error) {
-        return {
-            success: false,
-            message: `Failed to get trace: ${getErrorMessage(error)}`,
-            data: undefined,
-            exitCode: 1,
-        };
+        return failureFromError('get trace', error);
     }
 }
 /**
- * Gets recent traces from the trace store
- */
-async function getRecentTraces(limit) {
-    const store = getTraceStore();
-    const summaries = await store.listTraces(limit);
-    // Map TraceSummary from trace-domain to our local TraceSummary type
-    return summaries.map((summary) => ({
-        traceId: summary.traceId,
-        startTime: summary.startTime,
-        endTime: summary.endTime,
-        status: summary.status,
-        eventCount: summary.eventCount,
-        durationMs: summary.durationMs,
-    }));
-}
-/**
- * Gets events for a specific trace from the trace store
+ * Formats a single trace event as a timeline line
  */
-async function getTraceEvents(traceId) {
-    const store = getTraceStore();
-    return store.getTrace(traceId);
+function formatEventLine(event, verbose) {
+    const seq = event.sequence !== undefined ? `[${event.sequence}]` : '[-]';
+    const status = event.status !== undefined ? ` (${event.status})` : '';
+    const duration = event.durationMs !== undefined ? ` - ${event.durationMs}ms` : '';
+    let line = `  ${seq} ${event.type}${status}${duration}`;
+    if (verbose && event.payload !== undefined) {
+        line += `\n      Payload: ${JSON.stringify(event.payload)}`;
+    }
+    return line;
 }
 //# sourceMappingURL=trace.js.map

package/dist/commands/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"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"}

package/dist/utils/formatters.d.ts

@@ -23,4 +23,33 @@ export declare function truncate(str: string, maxLength: number): string;
  * Pads a string to a fixed width (for aligned output)
  */
 export declare function padEnd(str: string, width: number): string;
+import type { CommandResult } from '../types.js';
+/**
+ * Creates a success CommandResult
+ */
+export declare function success(message: string, data?: unknown): CommandResult;
+/**
+ * Creates a success CommandResult with JSON data (for --format json)
+ */
+export declare function successJson(data: unknown): CommandResult;
+/**
+ * Creates a failure CommandResult
+ */
+export declare function failure(message: string, exitCode?: number): CommandResult;
+/**
+ * Creates a failure CommandResult from an error
+ */
+export declare function failureFromError(action: string, error: unknown): CommandResult;
+/**
+ * Creates a usage error CommandResult
+ */
+export declare function usageError(usage: string): CommandResult;
+/**
+ * Formats a list with header and separator for CLI display
+ */
+export declare function formatList<T>(items: T[], columns: {
+    header: string;
+    width: number;
+    getValue: (item: T) => string;
+}[]): string;
 //# sourceMappingURL=formatters.d.ts.map

package/dist/utils/formatters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAMD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAEtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAExD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,aAAa,CAEpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAG9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAEvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;CAAE,EAAE,GAC1E,MAAM,CAOR"}

package/dist/utils/formatters.js

@@ -66,4 +66,44 @@ export function truncate(str, maxLength) {
 export function padEnd(str, width) {
     return str.padEnd(width);
 }
+/**
+ * Creates a success CommandResult
+ */
+export function success(message, data) {
+    return { success: true, message, data, exitCode: 0 };
+}
+/**
+ * Creates a success CommandResult with JSON data (for --format json)
+ */
+export function successJson(data) {
+    return { success: true, message: undefined, data, exitCode: 0 };
+}
+/**
+ * Creates a failure CommandResult
+ */
+export function failure(message, exitCode = 1) {
+    return { success: false, message, data: undefined, exitCode };
+}
+/**
+ * Creates a failure CommandResult from an error
+ */
+export function failureFromError(action, error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return failure(`Failed to ${action}: ${msg}`);
+}
+/**
+ * Creates a usage error CommandResult
+ */
+export function usageError(usage) {
+    return failure(`Usage: ${usage}`);
+}
+/**
+ * Formats a list with header and separator for CLI display
+ */
+export function formatList(items, columns) {
+    const header = columns.map(c => c.header.padEnd(c.width)).join(' | ');
+    const separator = '-'.repeat(header.length);
+    const rows = items.map(item => columns.map(c => truncate(c.getValue(item), c.width).padEnd(c.width)).join(' | '));
+    return [header, separator, ...rows].join('\n');
+}
 //# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAElC,8BAA8B;AAC9B,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,8BAA8B;AAC9B,MAAM,aAAa,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEzD,4BAA4B;AAC5B,MAAM,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAErD,2BAA2B;AAC3B,MAAM,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,aAAa;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IACzC,IAAI,EAAE,GAAG,aAAa;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,GAAG,aAAa,CAAC,CAAC;IACjE,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAE7C,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,OAAO,CAAC;IACpC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,OAAO,CAAC;IACtC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,OAAO,CAAC;IAC1C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,SAAiB;IACrD,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,KAAa;IAC/C,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"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"}

package/dist/web/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/web/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA8KjE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAiG/F"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/web/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA8KjE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CA2G/F"}

package/dist/web/api.js

@@ -8,7 +8,7 @@ import * as os from 'node:os';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { DATA_DIR_NAME, AGENTS_FILENAME } from '@defai.digital/contracts';
+import { DATA_DIR_NAME, AGENTS_FILENAME, getErrorMessage } from '@defai.digital/contracts';
 // Get the directory of this module (for finding bundled examples)
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -163,8 +163,12 @@ export function createAPIHandler() {
                     searchFilters.agentId = aId;
                 if (pType)
                     searchFilters.type = pType;
-                if (pLimit)
-                    searchFilters.limit = parseInt(pLimit, 10);
+                if (pLimit) {
+                    const limit = parseInt(pLimit, 10);
+                    if (!isNaN(limit) && limit > 0 && limit <= 200) {
+                        searchFilters.limit = limit;
+                    }
+                }
                 response = await handleTraceSearch(searchFilters);
             }
             else {
@@ -200,14 +204,19 @@ export function createAPIHandler() {
                         return;
                 }
             }
-            res.writeHead(200, { 'Content-Type': 'application/json' });
+            let statusCode = 200;
+            if (!response.success) {
+                const errorMsg = response.error ?? '';
+                statusCode = errorMsg.toLowerCase().includes('not found') ? 404 : 400;
+            }
+            res.writeHead(statusCode, { 'Content-Type': 'application/json' });
             res.end(JSON.stringify(response));
         }
         catch (error) {
             res.writeHead(500, { 'Content-Type': 'application/json' });
             res.end(JSON.stringify({
                 success: false,
-                error: error instanceof Error ? error.message : 'Internal server error',
+                error: getErrorMessage(error, 'Internal server error'),
             }));
         }
     };
@@ -321,7 +330,7 @@ async function handleAgentDetail(agentId) {
                 // Stats
                 stats: {
                     executionCount,
-                    successRate: executionCount > 0 ? successCount / executionCount : 1.0,
+                    successRate: executionCount > 0 ? successCount / executionCount : 0,
                     avgDurationMs: executionCount > 0 ? Math.round(totalDurationMs / executionCount) : 0,
                 },
             },
@@ -330,7 +339,7 @@ async function handleAgentDetail(agentId) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to fetch agent details',
+            error: getErrorMessage(error, 'Failed to fetch agent details'),
         };
     }
 }
@@ -531,7 +540,7 @@ async function handleTraceDetail(traceId) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to fetch trace',
+            error: getErrorMessage(error, 'Failed to fetch trace'),
         };
     }
 }
@@ -580,7 +589,7 @@ async function handleWorkflowDetail(workflowId) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to fetch workflow',
+            error: getErrorMessage(error, 'Failed to fetch workflow'),
         };
     }
 }
@@ -651,7 +660,7 @@ async function handleProviderHistory(providerId) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to fetch provider history',
+            error: getErrorMessage(error, 'Failed to fetch provider history'),
         };
     }
 }
@@ -723,7 +732,7 @@ async function handleAgentHistory(agentId) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to fetch agent history',
+            error: getErrorMessage(error, 'Failed to fetch agent history'),
         };
     }
 }
@@ -780,7 +789,7 @@ async function handleTraceSearch(filters) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to search traces',
+            error: getErrorMessage(error, 'Failed to search traces'),
         };
     }
 }
@@ -854,7 +863,7 @@ async function handleTraceTree(traceId) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to get trace tree',
+            error: getErrorMessage(error, 'Failed to get trace tree'),
         };
     }
 }
@@ -963,7 +972,7 @@ async function handleWorkflowEvents(workflowId) {
     catch (error) {
         return {
             success: false,
-            error: error instanceof Error ? error.message : 'Failed to fetch workflow events',
+            error: getErrorMessage(error, 'Failed to fetch workflow events'),
         };
     }
 }
@@ -1057,45 +1066,69 @@ async function getTraceData() {
     try {
         const traceStore = getTraceStore();
         const traces = await traceStore.listTraces(200); // Increased for histogram
-        // Fetch first event of each trace to get command info
+        // Fetch first event of each trace to get command info (only if name not stored)
         const tracesWithNames = await Promise.all(traces.map(async (trace) => {
-            let name = `Trace ${trace.traceId.slice(0, 8)}`;
+            // Use stored name if available, otherwise fall back to default
+            let name = trace.name ?? `Trace ${trace.traceId.slice(0, 8)}`;
             let command;
             let providers;
-            try {
-                const events = await traceStore.getTrace(trace.traceId);
-                const firstEvent = events[0];
-                if (firstEvent) {
-                    const payload = firstEvent.payload;
-                    const context = firstEvent.context;
-                    // Extract command from payload
-                    if (payload?.command) {
-                        command = String(payload.command);
-                        name = command;
-                    }
-                    // Extract providers from payload (for discussions) or context (for single calls)
-                    if (payload?.providers && Array.isArray(payload.providers)) {
-                        providers = payload.providers;
-                    }
-                    else if (context?.providerId) {
-                        providers = [String(context.providerId)];
-                    }
-                    // Add additional context for different command types
-                    if (payload?.agentId) {
-                        name = `ax agent run ${payload.agentId}`;
-                    }
-                    else if (payload?.topic) {
-                        const topic = String(payload.topic).slice(0, 40);
-                        name = `ax discuss "${topic}${String(payload.topic).length > 40 ? '...' : ''}"`;
-                    }
-                    else if (payload?.prompt) {
-                        const prompt = String(payload.prompt).slice(0, 40);
-                        name = `${command ?? 'ax call'} "${prompt}${String(payload.prompt).length > 40 ? '...' : ''}"`;
+            // Only fetch events if we need to derive providers or name isn't stored
+            if (!trace.name || !providers) {
+                try {
+                    const events = await traceStore.getTrace(trace.traceId);
+                    const firstEvent = events[0];
+                    if (firstEvent) {
+                        const payload = firstEvent.payload;
+                        const context = firstEvent.context;
+                        // Extract command from payload
+                        if (payload?.command) {
+                            command = String(payload.command);
+                        }
+                        // Extract providers from payload (for discussions) or context (for single calls)
+                        if (payload?.providers && Array.isArray(payload.providers)) {
+                            providers = payload.providers;
+                        }
+                        else if (context?.providerId) {
+                            providers = [String(context.providerId)];
+                        }
+                        // Derive name from events only if not stored
+                        if (!trace.name) {
+                            if (payload?.agentId) {
+                                name = `ax agent run ${payload.agentId}`;
+                            }
+                            else if (context?.agentId) {
+                                name = `ax agent run ${context.agentId}`;
+                            }
+                            else if (payload?.topic) {
+                                const topic = String(payload.topic).slice(0, 40);
+                                name = `ax discuss "${topic}${String(payload.topic).length > 40 ? '...' : ''}"`;
+                            }
+                            else if (payload?.prompt) {
+                                const prompt = String(payload.prompt).slice(0, 40);
+                                name = `${command ?? 'ax call'} "${prompt}${String(payload.prompt).length > 40 ? '...' : ''}"`;
+                            }
+                            else if (command) {
+                                name = command;
+                            }
+                            else if (payload?.tool) {
+                                // MCP tool invocation (parallel_run, review_analyze, etc.)
+                                const tool = String(payload.tool).replace(/_/g, ' ');
+                                name = `ax ${tool}`;
+                            }
+                            else if (payload?.workflowId) {
+                                // Workflow execution
+                                const workflowName = payload.workflowName ? String(payload.workflowName) : String(payload.workflowId);
+                                name = `workflow ${workflowName}`;
+                            }
+                            else if (context?.workflowId) {
+                                name = `workflow ${context.workflowId}`;
+                            }
+                        }
                     }
                 }
-            }
-            catch {
-                // Ignore errors fetching events
+                catch {
+                    // Ignore errors fetching events
+                }
             }
             return {
                 traceId: trace.traceId,