@vercel/agent-eval 0.0.9 → 0.0.12

package/dist/lib/o11y/parsers/claude-code.js

@@ -0,0 +1,343 @@
+/**
+ * Parser for Claude Code transcript format.
+ * Claude Code stores transcripts as JSONL at ~/.claude/projects/{path}/{session}.jsonl
+ *
+ * Format reference (based on Claude Code CLI output):
+ * - Messages have type: "user" | "assistant"
+ * - Tool use appears in assistant messages with tool_use blocks
+ * - Tool results appear as separate messages with type: "tool_result"
+ */
+/**
+ * Map Claude Code tool names to canonical names.
+ */
+function normalizeToolName(name) {
+    const toolMap = {
+        // File operations
+        Read: 'file_read',
+        read_file: 'file_read',
+        ReadFile: 'file_read',
+        Write: 'file_write',
+        write_file: 'file_write',
+        WriteFile: 'file_write',
+        write_to_file: 'file_write',
+        Edit: 'file_edit',
+        edit_file: 'file_edit',
+        EditFile: 'file_edit',
+        str_replace_editor: 'file_edit',
+        StrReplace: 'file_edit',
+        // Shell
+        Bash: 'shell',
+        bash: 'shell',
+        Shell: 'shell',
+        shell: 'shell',
+        execute_command: 'shell',
+        run_command: 'shell',
+        // Web
+        WebFetch: 'web_fetch',
+        web_fetch: 'web_fetch',
+        fetch_url: 'web_fetch',
+        mcp__fetch__fetch: 'web_fetch',
+        WebSearch: 'web_search',
+        web_search: 'web_search',
+        // Search/navigation
+        Glob: 'glob',
+        glob: 'glob',
+        list_files: 'glob',
+        Grep: 'grep',
+        grep: 'grep',
+        search_files: 'grep',
+        LS: 'list_dir',
+        list_dir: 'list_dir',
+        ListDir: 'list_dir',
+        // Agent/subagent tools
+        Task: 'agent_task',
+        task: 'agent_task',
+    };
+    return toolMap[name] || 'unknown';
+}
+/**
+ * Extract file path from tool arguments.
+ */
+function extractFilePath(args) {
+    return (args.path || args.file_path || args.filename || args.file);
+}
+/**
+ * Extract URL from tool arguments.
+ */
+function extractUrl(args) {
+    return (args.url || args.uri || args.href);
+}
+/**
+ * Extract command from tool arguments.
+ */
+function extractCommand(args) {
+    if (typeof args.command === 'string')
+        return args.command;
+    if (Array.isArray(args.command))
+        return args.command.join(' ');
+    if (typeof args.cmd === 'string')
+        return args.cmd;
+    return undefined;
+}
+/**
+ * Parse a single JSONL line from Claude Code transcript.
+ */
+function parseClaudeCodeLine(line) {
+    const events = [];
+    try {
+        const data = JSON.parse(line);
+        // Handle different Claude Code message formats
+        if (data.type === 'user' || data.role === 'user') {
+            // Check if this is a tool_result message (user message containing tool results)
+            const contentArray = getContentArray(data);
+            const toolResults = contentArray?.filter((block) => block.type === 'tool_result');
+            if (toolResults && toolResults.length > 0) {
+                // Extract tool results from user message
+                for (const result of toolResults) {
+                    const r = result;
+                    events.push({
+                        timestamp: data.timestamp,
+                        type: 'tool_result',
+                        tool: {
+                            name: 'unknown',
+                            originalName: (r.tool_use_id || 'unknown'),
+                            result: r.content,
+                            success: !r.is_error && !r.error,
+                        },
+                        raw: r,
+                    });
+                }
+            }
+            else {
+                // Regular user message
+                events.push({
+                    timestamp: data.timestamp,
+                    type: 'message',
+                    role: 'user',
+                    content: extractContent(data),
+                    raw: data,
+                });
+            }
+        }
+        else if (data.type === 'assistant' || data.role === 'assistant') {
+            // Assistant message - may contain text and/or tool_use blocks
+            const content = extractContent(data);
+            if (content) {
+                events.push({
+                    timestamp: data.timestamp,
+                    type: 'message',
+                    role: 'assistant',
+                    content,
+                    raw: data,
+                });
+            }
+            // Extract tool_use blocks
+            const toolUses = extractToolUses(data);
+            for (const toolUse of toolUses) {
+                events.push({
+                    timestamp: data.timestamp,
+                    type: 'tool_call',
+                    tool: {
+                        name: normalizeToolName(toolUse.name),
+                        originalName: toolUse.name,
+                        args: toolUse.input || toolUse.args || {},
+                    },
+                    raw: toolUse,
+                });
+            }
+            // Extract thinking blocks
+            const thinking = extractThinking(data);
+            if (thinking) {
+                events.push({
+                    timestamp: data.timestamp,
+                    type: 'thinking',
+                    content: thinking,
+                    raw: data,
+                });
+            }
+        }
+        else if (data.type === 'tool_result' || data.type === 'tool_response') {
+            events.push({
+                timestamp: data.timestamp,
+                type: 'tool_result',
+                tool: {
+                    name: 'unknown',
+                    originalName: data.tool_use_id || 'unknown',
+                    result: data.content || data.output || data.result,
+                    success: !data.is_error && !data.error,
+                },
+                raw: data,
+            });
+        }
+        else if (data.type === 'system' || data.role === 'system') {
+            events.push({
+                timestamp: data.timestamp,
+                type: 'message',
+                role: 'system',
+                content: extractContent(data),
+                raw: data,
+            });
+        }
+        else if (data.type === 'error' || data.error) {
+            events.push({
+                timestamp: data.timestamp,
+                type: 'error',
+                content: data.error?.message || data.message || JSON.stringify(data.error),
+                raw: data,
+            });
+        }
+    }
+    catch {
+        // Skip unparseable lines
+    }
+    return events;
+}
+/**
+ * Get the content array from data, handling nested message format.
+ * Claude Code wraps messages: { type: "assistant", message: { content: [...] } }
+ */
+function getContentArray(data) {
+    // Direct content array
+    if (Array.isArray(data.content)) {
+        return data.content;
+    }
+    // Nested message format (real Claude Code format)
+    const message = data.message;
+    if (message && Array.isArray(message.content)) {
+        return message.content;
+    }
+    return undefined;
+}
+/**
+ * Get string content from data, handling nested message format.
+ */
+function getStringContent(data) {
+    if (typeof data.content === 'string') {
+        return data.content;
+    }
+    const message = data.message;
+    if (message && typeof message.content === 'string') {
+        return message.content;
+    }
+    return undefined;
+}
+/**
+ * Extract text content from various message formats.
+ */
+function extractContent(data) {
+    // Check for direct string content
+    const stringContent = getStringContent(data);
+    if (stringContent) {
+        return stringContent;
+    }
+    // Check for content blocks array
+    const contentArray = getContentArray(data);
+    if (contentArray) {
+        const textBlocks = contentArray.filter((block) => block.type === 'text');
+        if (textBlocks.length > 0) {
+            return textBlocks.map((b) => b.text).join('\n');
+        }
+    }
+    if (typeof data.text === 'string') {
+        return data.text;
+    }
+    // Note: don't check data.message as string since message is an object in Claude Code format
+    return undefined;
+}
+/**
+ * Extract tool_use blocks from assistant messages.
+ */
+function extractToolUses(data) {
+    const toolUses = [];
+    // Check content array (handles both direct and nested message format)
+    const contentArray = getContentArray(data);
+    if (contentArray) {
+        for (const block of contentArray) {
+            const b = block;
+            if (b.type === 'tool_use') {
+                toolUses.push({
+                    name: b.name,
+                    input: b.input,
+                });
+            }
+        }
+    }
+    // Also check for tool_calls array format (OpenAI-style)
+    const toolCalls = data.tool_calls || data.message?.tool_calls;
+    if (Array.isArray(toolCalls)) {
+        for (const call of toolCalls) {
+            const c = call;
+            const func = c.function;
+            toolUses.push({
+                name: (func?.name || c.name),
+                args: func?.arguments
+                    ? JSON.parse(func.arguments)
+                    : (c.arguments || c.input),
+            });
+        }
+    }
+    return toolUses;
+}
+/**
+ * Extract thinking/reasoning content.
+ */
+function extractThinking(data) {
+    const contentArray = getContentArray(data);
+    if (contentArray) {
+        const thinkingBlocks = contentArray.filter((block) => block.type === 'thinking');
+        if (thinkingBlocks.length > 0) {
+            return thinkingBlocks.map((b) => {
+                const block = b;
+                return block.thinking || block.text;
+            }).join('\n');
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse Claude Code JSONL transcript into events.
+ */
+export function parseClaudeCodeTranscript(raw) {
+    const events = [];
+    const errors = [];
+    const lines = raw.split('\n').filter((line) => line.trim());
+    for (const line of lines) {
+        try {
+            const lineEvents = parseClaudeCodeLine(line);
+            events.push(...lineEvents);
+        }
+        catch (e) {
+            errors.push(`Failed to parse line: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    // Post-process to link tool_results to their tool_calls
+    // and extract additional metadata
+    for (const event of events) {
+        if (event.type === 'tool_call' && event.tool) {
+            const args = event.tool.args || {};
+            // Extract file paths for file operations
+            if (['file_read', 'file_write', 'file_edit'].includes(event.tool.name)) {
+                const path = extractFilePath(args);
+                if (path) {
+                    event.tool.args = { ...args, _extractedPath: path };
+                }
+            }
+            // Extract URLs for web fetches
+            if (event.tool.name === 'web_fetch') {
+                const url = extractUrl(args);
+                if (url) {
+                    event.tool.args = { ...args, _extractedUrl: url };
+                }
+            }
+            // Extract commands for shell operations
+            if (event.tool.name === 'shell') {
+                const command = extractCommand(args);
+                if (command) {
+                    event.tool.args = { ...args, _extractedCommand: command };
+                }
+            }
+        }
+    }
+    return { events, errors };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/lib/o11y/parsers/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../../src/lib/o11y/parsers/claude-code.ts"],"names":[],"mappings":"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"}

package/dist/lib/o11y/parsers/codex.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parser for OpenAI Codex CLI transcript format.
+ * Codex outputs JSONL to stdout when run with --json flag.
+ *
+ * Format reference (based on Codex CLI output):
+ * - Events have a "type" field indicating the event type
+ * - Messages, function calls, and results are separate events
+ */
+import type { TranscriptEvent } from '../types.js';
+/**
+ * Parse Codex JSONL transcript into events.
+ */
+export declare function parseCodexTranscript(raw: string): {
+    events: TranscriptEvent[];
+    errors: string[];
+};
+//# sourceMappingURL=codex.d.ts.map

package/dist/lib/o11y/parsers/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/lib/o11y/parsers/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AAoQ7D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IACjD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA+CA"}

package/dist/lib/o11y/parsers/codex.js

@@ -0,0 +1,296 @@
+/**
+ * Parser for OpenAI Codex CLI transcript format.
+ * Codex outputs JSONL to stdout when run with --json flag.
+ *
+ * Format reference (based on Codex CLI output):
+ * - Events have a "type" field indicating the event type
+ * - Messages, function calls, and results are separate events
+ */
+/**
+ * Map Codex tool names to canonical names.
+ */
+function normalizeToolName(name) {
+    const toolMap = {
+        // File operations
+        read_file: 'file_read',
+        write_file: 'file_write',
+        edit_file: 'file_edit',
+        patch_file: 'file_edit',
+        create_file: 'file_write',
+        delete_file: 'file_write',
+        // Shell
+        shell: 'shell',
+        bash: 'shell',
+        execute: 'shell',
+        run: 'shell',
+        exec: 'shell',
+        terminal: 'shell',
+        // Web
+        fetch: 'web_fetch',
+        http_request: 'web_fetch',
+        curl: 'web_fetch',
+        web_search: 'web_search',
+        search: 'web_search',
+        // Search/navigation
+        glob: 'glob',
+        find_files: 'glob',
+        list_files: 'glob',
+        grep: 'grep',
+        search_files: 'grep',
+        ripgrep: 'grep',
+        ls: 'list_dir',
+        list_directory: 'list_dir',
+        dir: 'list_dir',
+    };
+    return toolMap[name.toLowerCase()] || 'unknown';
+}
+/**
+ * Extract file path from tool arguments.
+ */
+function extractFilePath(args) {
+    return (args.path || args.file || args.filename || args.file_path);
+}
+/**
+ * Extract URL from tool arguments.
+ */
+function extractUrl(args) {
+    return (args.url || args.uri || args.endpoint);
+}
+/**
+ * Extract command from tool arguments.
+ */
+function extractCommand(args) {
+    if (typeof args.command === 'string')
+        return args.command;
+    if (Array.isArray(args.command))
+        return args.command.join(' ');
+    if (typeof args.cmd === 'string')
+        return args.cmd;
+    if (Array.isArray(args.args) && typeof args.program === 'string') {
+        return `${args.program} ${args.args.join(' ')}`;
+    }
+    return undefined;
+}
+/**
+ * Parse a single JSONL line from Codex transcript.
+ */
+function parseCodexLine(line) {
+    const events = [];
+    try {
+        const data = JSON.parse(line);
+        // Codex uses various event type formats
+        const eventType = data.type || data.event || data.kind;
+        switch (eventType) {
+            case 'message':
+            case 'chat':
+            case 'response': {
+                const role = data.role || (data.from === 'assistant' ? 'assistant' : 'user');
+                events.push({
+                    timestamp: data.timestamp || data.ts,
+                    type: 'message',
+                    role: role,
+                    content: data.content || data.text || data.message,
+                    raw: data,
+                });
+                break;
+            }
+            case 'function_call':
+            case 'tool_call':
+            case 'tool_use':
+            case 'action': {
+                const name = data.function?.name || data.name || data.tool || data.action;
+                const args = data.function?.arguments
+                    ? typeof data.function.arguments === 'string'
+                        ? JSON.parse(data.function.arguments)
+                        : data.function.arguments
+                    : data.arguments || data.input || data.params || {};
+                events.push({
+                    timestamp: data.timestamp || data.ts,
+                    type: 'tool_call',
+                    tool: {
+                        name: normalizeToolName(name),
+                        originalName: name,
+                        args,
+                    },
+                    raw: data,
+                });
+                break;
+            }
+            case 'function_result':
+            case 'tool_result':
+            case 'tool_response':
+            case 'action_result': {
+                events.push({
+                    timestamp: data.timestamp || data.ts,
+                    type: 'tool_result',
+                    tool: {
+                        name: 'unknown',
+                        originalName: data.tool || data.function || 'unknown',
+                        result: data.result || data.output || data.content,
+                        success: data.success !== false && !data.error,
+                    },
+                    raw: data,
+                });
+                break;
+            }
+            case 'thinking':
+            case 'reasoning':
+            case 'thought': {
+                events.push({
+                    timestamp: data.timestamp || data.ts,
+                    type: 'thinking',
+                    content: data.content || data.text || data.thought,
+                    raw: data,
+                });
+                break;
+            }
+            case 'error': {
+                events.push({
+                    timestamp: data.timestamp || data.ts,
+                    type: 'error',
+                    content: data.error?.message || data.message || data.content,
+                    raw: data,
+                });
+                break;
+            }
+            // Codex Responses API events
+            case 'thread.started':
+            case 'thread.completed':
+            case 'turn.started':
+            case 'turn.completed':
+            case 'turn.failed': {
+                // These are control flow events, capture as metadata
+                events.push({
+                    timestamp: data.timestamp || data.ts,
+                    type: eventType === 'turn.failed' ? 'error' : 'message',
+                    role: 'system',
+                    content: eventType === 'turn.failed'
+                        ? (data.error?.message || `Turn failed`)
+                        : eventType,
+                    raw: data,
+                });
+                break;
+            }
+            case 'response.created':
+            case 'response.completed':
+            case 'response.cancelled':
+            case 'response.failed': {
+                // Response lifecycle events
+                if (eventType === 'response.failed') {
+                    events.push({
+                        timestamp: data.timestamp || data.ts,
+                        type: 'error',
+                        content: data.error?.message || 'Response failed',
+                        raw: data,
+                    });
+                }
+                break;
+            }
+            case 'output_text.delta':
+            case 'output_text.done': {
+                // Text streaming events
+                if (data.text || data.delta) {
+                    events.push({
+                        timestamp: data.timestamp || data.ts,
+                        type: 'message',
+                        role: 'assistant',
+                        content: data.text || data.delta,
+                        raw: data,
+                    });
+                }
+                break;
+            }
+            default: {
+                // Try to infer from structure
+                if (data.role === 'assistant' || data.role === 'user') {
+                    events.push({
+                        timestamp: data.timestamp || data.ts,
+                        type: 'message',
+                        role: data.role,
+                        content: data.content || data.text,
+                        raw: data,
+                    });
+                }
+                else if (data.function || data.tool) {
+                    // Looks like a tool call or result
+                    if (data.result !== undefined || data.output !== undefined) {
+                        events.push({
+                            timestamp: data.timestamp || data.ts,
+                            type: 'tool_result',
+                            tool: {
+                                name: 'unknown',
+                                originalName: data.function || data.tool || 'unknown',
+                                result: data.result || data.output,
+                                success: !data.error,
+                            },
+                            raw: data,
+                        });
+                    }
+                    else {
+                        const name = data.function?.name || data.function || data.tool;
+                        events.push({
+                            timestamp: data.timestamp || data.ts,
+                            type: 'tool_call',
+                            tool: {
+                                name: normalizeToolName(name),
+                                originalName: name,
+                                args: data.arguments || data.input || {},
+                            },
+                            raw: data,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Skip unparseable lines
+    }
+    return events;
+}
+/**
+ * Parse Codex JSONL transcript into events.
+ */
+export function parseCodexTranscript(raw) {
+    const events = [];
+    const errors = [];
+    const lines = raw.split('\n').filter((line) => line.trim());
+    for (const line of lines) {
+        try {
+            const lineEvents = parseCodexLine(line);
+            events.push(...lineEvents);
+        }
+        catch (e) {
+            errors.push(`Failed to parse line: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    // Post-process to extract additional metadata
+    for (const event of events) {
+        if (event.type === 'tool_call' && event.tool) {
+            const args = event.tool.args || {};
+            // Extract file paths for file operations
+            if (['file_read', 'file_write', 'file_edit'].includes(event.tool.name)) {
+                const path = extractFilePath(args);
+                if (path) {
+                    event.tool.args = { ...args, _extractedPath: path };
+                }
+            }
+            // Extract URLs for web fetches
+            if (event.tool.name === 'web_fetch') {
+                const url = extractUrl(args);
+                if (url) {
+                    event.tool.args = { ...args, _extractedUrl: url };
+                }
+            }
+            // Extract commands for shell operations
+            if (event.tool.name === 'shell') {
+                const command = extractCommand(args);
+                if (command) {
+                    event.tool.args = { ...args, _extractedCommand: command };
+                }
+            }
+        }
+    }
+    return { events, errors };
+}
+//# sourceMappingURL=codex.js.map