Releases: alloevil/AgentXRay
Releases · alloevil/AgentXRay
Release list
v1.10.0 - Session Insights Dashboard
New Features
Session Insights Dashboard
- Session-level Insights: Select a session, click "Insights" tab to see per-session analytics — tool statistics with avg duration, error list, retry chains, token breakdown, and color-coded tool call sequence with legend
- Global Insights: Without a session selected, shows aggregate analytics across all sessions for the current platform — error rate, tool stats, error clustering by pattern, daily trend chart
- Error Clustering: Groups similar errors across sessions by normalized first-line pattern
- Retry Detection: Identifies consecutive tool errors (≥2) followed by success, with click-to-jump to the error message
- Tool Call Sequence: Color-coded per tool, full names, error outline, and legend
Supported Platforms
OpenClaw, Codex, Claude Code, Hermes — all four platforms supported
API
GET /api/insights?platform=openclaw&agent=xxx— Aggregate analytics with 60s cache
Fixes
- Hermes insights: fix missing
is_errorcolumn, usetool_nameand content-based error detection - Claude Code insights: parse
tool_use/tool_resultblocks fromassistant/userrecords - Codex insights: parse
function_call/function_call_outputfromresponse_itemrecords
v1.9.0
Changes
- Reasoning display: Hermes assistant messages now show a collapsible reasoning block
- Session status: Hermes sessions correctly show active/archived status
- Source icons: Distinct icons for channel sources (cli, telegram, discord, feishu, whatsapp, etc.)
- Source badge: More visible source badge with color highlighting
1.8.0
Features
- Hermes agent framework support — Added Hermes (Nous Research) as a fourth platform, reading sessions from
~/.hermes/state.db(SQLite) via better-sqlite3 - Session list, detail view, FTS5 full-text search, and SSE polling for real-time updates
- Hermes sessions show source (cli/telegram/weixin/etc.) badge and model info
- New
HERMES_DIRenvironment variable and settings UI input for custom directory
v1.7.0 - Spawn Tree Visualization
What's New
- Spawn Tree 可视化:新增 Spawn Tree 视图,直观展示子代理的派生关系和执行链路
- 后端 model 字段提取,列表卡片和详情头部显示模型名称
AgentXRay v1.6.0
What's New
Error & Retry 可视化 🔄
Summary 面板:
- Tools 区域新增
🔄 Retried: N tools · M extra attempts - 点击可跳转到第一个 retry 位置(自动展开折叠 + 高亮)
Turn Group:
- 折叠头部新增
🔄 N retrychip - 展开后每个 toolResult 前显示 retry 状态注释:
❌ Attempt 1/3 failed — agent will retry✅ Attempt 3/3 — recovered after 2 errors❌ All N attempts failed
Session 首条消息预览修复
- 修复 OpenClaw envelope stripping,正确过滤系统 metadata
- 侧边栏 session 卡片显示真实用户消息内容
时间分解
- Summary 顶部显示
🔧 Tool exec: Xs (N%) · 🤖 Model: Xs (N%)
工具调用耗时
- 每个 Tool Result 右上角显示本次执行耗时(≥200ms)
- Turn Group 头部显示该批次总耗时
AgentXRay v1.5.0
What's New
Tool Call Timing ⏱
每次工具调用都显示执行耗时:
- 每个 Tool Result 右上角显示该次工具调用的实际耗时(toolCall → toolResult 时间差)
- ≥ 200ms 就显示,>10s 橙色,>60s 红色
- 精确配对(通过 toolCallId),不受消息间隔干扰
Summary 面板新增工具总耗时:
- Tools 区域新增
⏱ Tool time: Xs (N calls) - 一眼看出 30 次工具调用一共花了多少时间
- 支持三种平台:OpenClaw / Codex / Claude Code
AgentXRay v1.4.0
What's New
Real-time Tail via SSE ⚡
用 fs.watch + Server-Sent Events 替代 5 秒轮询,实现真正的实时体验:
- 🟢 Live 指示器 — 侧边栏实时显示连接状态
- 毫秒级延迟 — 文件变化后 80ms 内推送新消息到界面
- 增量推送 — 只发新增内容,不重传历史
- 零轮询 — 活跃 session 期间完全不发轮询请求
- 支持三种平台:OpenClaw / Codex / Claude Code
- 断开自动重连(浏览器 EventSource 内置)
AgentXRay v1.3.0
What's New
Performance: Session 元数据 mtime 缓存 ⚡
- 三种平台(OpenClaw / Codex / Claude Code)的 session 列表刷新全部加入 mtime 缓存
- 文件未变更时直接返回缓存结果,跳过 JSONL 读取与 parse
- 大量 session 时刷新速度大幅提升,CPU/IO 显著降低
- 缓存纯内存,无需持久化,重启后自动重建
Previous (v1.2.0)
- 导出功能:Markdown / JSON / 复制到剪贴板
Previous (v1.1.0)
- Timeline 色块点击跳转修复
AgentXRay v1.2.0
What's New
New Feature: Export Session 📥
在 session 详情页顶部新增「📥 Export」下拉按钮,支持三种格式:
- 📝 Markdown (.md) — 完整对话,含 User/Assistant/Tool 层级标题与时间戳,工具输出超 2000 字符自动截断
- 📦 JSON (.json) — 原始 session 数据结构,适合程序处理
- 📋 Copy to clipboard — Markdown 格式,复制后按钮短暂显示 ✅ 确认反馈
文件名格式:agentxray-{sessionId}.md/.json
Bug Fixes (from v1.1.0)
- Timeline 色块点击跳转:目标消息在分页隐藏区域时自动展开所有消息并定位
AgentXRay v1.1.0
What's New
Bug Fixes
- Timeline 色块点击跳转修复: 点击 timeline 色块时,如果目标消息在分页隐藏区域(未渲染到 DOM),现在会自动展开所有消息并跳转到目标位置
- 同时修复了「最慢步骤链接」和「Spawn 结果跳转按钮」的相同问题
Improvements
- 新增
scrollToMessage()通用跳转函数,统一了所有消息定位逻辑