@tonyclaw/agent-inspector 2.0.40 → 2.0.42

package/.output/server/{_tanstack-start-manifest_v-D4vSn_wD.mjs → _tanstack-start-manifest_v-DSikvwru.mjs}

@@ -1,4 +1,4 @@
-const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/groups", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/runs", "/api/sessions", "/proxy/$", "/session/$sessionId", "/api/knowledge/candidates", "/api/knowledge/project-context", "/api/knowledge/search", "/api/knowledge/sessions/$sessionId/candidates"], "preloads": ["/assets/main-CKYe6UUv.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-CZP-XfpB.js", "/assets/ProxyViewerContainer-BGqeiYKD.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/groups": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.ts", "children": ["/api/groups/$groupId"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/runs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/runs.ts", "children": ["/api/runs/$runId"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/proxy/$.ts" }, "/session/$sessionId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/session/$sessionId.tsx", "assets": [], "preloads": ["/assets/_sessionId-EHPexdPl.js", "/assets/ProxyViewerContainer-BGqeiYKD.js"] }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.paths.ts" }, "/api/groups/$groupId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.$groupId.ts", "children": ["/api/groups/$groupId/evidence", "/api/groups/$groupId/sessions"] }, "/api/knowledge/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.ts", "children": ["/api/knowledge/candidates/$candidateId"] }, "/api/knowledge/project-context": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.project-context.ts" }, "/api/knowledge/search": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.search.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/model-metadata", "/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.scan.ts" }, "/api/runs/$runId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/runs.$runId.ts", "children": ["/api/runs/$runId/evidence"] }, "/api/groups/$groupId/evidence": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.$groupId.evidence.ts" }, "/api/groups/$groupId/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.$groupId.sessions.ts" }, "/api/knowledge/candidates/$candidateId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.ts", "children": ["/api/knowledge/candidates/$candidateId/promote"] }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/model-metadata": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.model-metadata.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/runs/$runId/evidence": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/runs.$runId.evidence.ts" }, "/api/knowledge/candidates/$candidateId/promote": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.promote.ts" }, "/api/knowledge/sessions/$sessionId/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.sessions.$sessionId.candidates.ts" }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-CKYe6UUv.js" });
+const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/groups", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/runs", "/api/sessions", "/proxy/$", "/session/$sessionId", "/api/knowledge/candidates", "/api/knowledge/project-context", "/api/knowledge/search", "/api/knowledge/sessions/$sessionId/candidates"], "preloads": ["/assets/main-DOy_Q96H.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-D1MkoT4l.js", "/assets/ProxyViewerContainer-CE9pAX4c.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/groups": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.ts", "children": ["/api/groups/$groupId"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/runs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/runs.ts", "children": ["/api/runs/$runId"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/proxy/$.ts" }, "/session/$sessionId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/session/$sessionId.tsx", "assets": [], "preloads": ["/assets/_sessionId-CbWEG5ej.js", "/assets/ProxyViewerContainer-CE9pAX4c.js"] }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.paths.ts" }, "/api/groups/$groupId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.$groupId.ts", "children": ["/api/groups/$groupId/evidence", "/api/groups/$groupId/sessions"] }, "/api/knowledge/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.ts", "children": ["/api/knowledge/candidates/$candidateId"] }, "/api/knowledge/project-context": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.project-context.ts" }, "/api/knowledge/search": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.search.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/model-metadata", "/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.scan.ts" }, "/api/runs/$runId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/runs.$runId.ts", "children": ["/api/runs/$runId/evidence"] }, "/api/groups/$groupId/evidence": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.$groupId.evidence.ts" }, "/api/groups/$groupId/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/groups.$groupId.sessions.ts" }, "/api/knowledge/candidates/$candidateId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.ts", "children": ["/api/knowledge/candidates/$candidateId/promote"] }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/model-metadata": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.model-metadata.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/runs/$runId/evidence": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/runs.$runId.evidence.ts" }, "/api/knowledge/candidates/$candidateId/promote": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.promote.ts" }, "/api/knowledge/sessions/$sessionId/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.sessions.$sessionId.candidates.ts" }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-DOy_Q96H.js" });
 export {
   tsrStartManifest
 };

package/.output/server/index.mjs

@@ -38,100 +38,100 @@ const assets = {
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-07-02T01:15:23.247Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/CompareDrawer-p0uYxW7_.js": {
+  "/assets/index-D1MkoT4l.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"49fe-PDyw+vlyo9dEC/B0BR4p7sgHWGc"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 18942,
-    "path": "../public/assets/CompareDrawer-p0uYxW7_.js"
-  },
-  "/assets/index-CZP-XfpB.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"74-T8zsQO7lllBR44srKw3fW8/4eS4"',
-    "mtime": "2026-07-02T01:15:23.247Z",
+    "etag": '"74-5tWPGheuXYTT+KVstHwHWELFTpU"',
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 116,
-    "path": "../public/assets/index-CZP-XfpB.js"
+    "path": "../public/assets/index-D1MkoT4l.js"
   },
-  "/assets/RequestAnatomy-c8ru0pS-.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"4485-7HJ86QTNO6hp1l7c8bsI7vDnIao"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 17541,
-    "path": "../public/assets/RequestAnatomy-c8ru0pS-.js"
+  "/assets/minimax-BPMzvuL-.jpeg": {
+    "type": "image/jpeg",
+    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
+    "mtime": "2026-07-03T01:44:09.155Z",
+    "size": 6918,
+    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
   "/assets/index-BfGJEb-2.css": {
     "type": "text/css; charset=utf-8",
     "etag": '"1acc9-JrjZs7fIRGuBr66cqP9miLHcLKk"',
-    "mtime": "2026-07-02T01:15:23.247Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 109769,
     "path": "../public/assets/index-BfGJEb-2.css"
   },
-  "/assets/ReplayDialog-TTTVCMe9.js": {
+  "/assets/CompareDrawer-Cfqxlo-U.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"318c-7uKjiGCOGPnw5aJSXfioga1NTsM"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 12684,
-    "path": "../public/assets/ReplayDialog-TTTVCMe9.js"
+    "etag": '"49e8-4/OM/oQ2JC3boP6H31ljkTMqaic"',
+    "mtime": "2026-07-03T01:44:09.157Z",
+    "size": 18920,
+    "path": "../public/assets/CompareDrawer-Cfqxlo-U.js"
   },
-  "/assets/main-CKYe6UUv.js": {
+  "/assets/main-DOy_Q96H.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"517d9-2aRLKvQ58GrmKFTsuV0pk+1qC6Y"',
-    "mtime": "2026-07-02T01:15:23.247Z",
+    "etag": '"517d9-GvqATjRQp0lZCEyGodPErXeDUXg"',
+    "mtime": "2026-07-03T01:44:09.157Z",
     "size": 333785,
-    "path": "../public/assets/main-CKYe6UUv.js"
+    "path": "../public/assets/main-DOy_Q96H.js"
+  },
+  "/assets/ReplayDialog-daRidZo_.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"318c-LNphXs3XdCOanUWleZMjvNJbyo4"',
+    "mtime": "2026-07-03T01:44:09.155Z",
+    "size": 12684,
+    "path": "../public/assets/ReplayDialog-daRidZo_.js"
+  },
+  "/assets/StreamingChunkSequence-nK-0LpbM.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"d5c-pin0T6zoaVTMLQgDVheLwJQdCbc"',
+    "mtime": "2026-07-03T01:44:09.157Z",
+    "size": 3420,
+    "path": "../public/assets/StreamingChunkSequence-nK-0LpbM.js"
+  },
+  "/assets/RequestAnatomy-CJ7EPQGQ.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"4485-sqyRSWpcGItAjW8EQpuyuH2NJkM"',
+    "mtime": "2026-07-03T01:44:09.157Z",
+    "size": 17541,
+    "path": "../public/assets/RequestAnatomy-CJ7EPQGQ.js"
   },
-  "/assets/StreamingChunkSequence-UlAMVF9j.js": {
+  "/assets/ResponseView-xBmr54hB.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d57-66GSO+9YzBli1luuyHBvRTVMfcc"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 3415,
-    "path": "../public/assets/StreamingChunkSequence-UlAMVF9j.js"
+    "etag": '"30d1-XQa3i7Dl3IpHmJVZY7j7wGeKTWA"',
+    "mtime": "2026-07-03T01:44:09.157Z",
+    "size": 12497,
+    "path": "../public/assets/ResponseView-xBmr54hB.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-07-02T01:15:23.247Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/minimax-BPMzvuL-.jpeg": {
-    "type": "image/jpeg",
-    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 6918,
-    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
-  },
-  "/assets/ResponseView-D59jTMy4.js": {
+  "/assets/_sessionId-CbWEG5ej.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"30d0-PRaxUUFPWC7Oei05DaQSd/wZ9Bw"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 12496,
-    "path": "../public/assets/ResponseView-D59jTMy4.js"
+    "etag": '"d2-znIEA1ArIEaTdapPt/+hhunhTEA"',
+    "mtime": "2026-07-03T01:44:09.155Z",
+    "size": 210,
+    "path": "../public/assets/_sessionId-CbWEG5ej.js"
   },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-07-02T01:15:23.247Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/_sessionId-EHPexdPl.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-ePZpCpCw8kcmKbtHPj19t6iJuaA"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 210,
-    "path": "../public/assets/_sessionId-EHPexdPl.js"
-  },
-  "/assets/ProxyViewerContainer-BGqeiYKD.js": {
+  "/assets/ProxyViewerContainer-CE9pAX4c.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"b6168-t944j+wio4ZprelsCA8iT/6ifVU"',
-    "mtime": "2026-07-02T01:15:23.247Z",
-    "size": 745832,
-    "path": "../public/assets/ProxyViewerContainer-BGqeiYKD.js"
+    "etag": '"b6dd2-a7szrizd/RNOpvOe2NWIYoJTdEQ"',
+    "mtime": "2026-07-03T01:44:09.157Z",
+    "size": 749010,
+    "path": "../public/assets/ProxyViewerContainer-CE9pAX4c.js"
   }
 };
 function readAsset(id) {

package/README.md

@@ -181,6 +181,9 @@ agent-inspector-mcp config codex
 The companion package is useful for MCP clients that expect a local command. Direct HTTP remains the
 shortest path for clients that support Streamable HTTP.
 
+The MCP HTTP surface is also documented as OpenAPI YAML in
+[`docs/mcp-openapi.yaml`](docs/mcp-openapi.yaml).
+
 Use only one transport for the same Inspector instance. If the MCP client supports Streamable HTTP,
 configure `http://localhost:25947/api/mcp` directly. If it only supports stdio, configure
 `agent-inspector-mcp stdio`; that command is only a bridge to `/api/mcp`, not a second Inspector
@@ -190,20 +193,24 @@ Coding agents can use the MCP surface in three ways:
 
 - Tools: perform actions such as listing logs, reading bounded log details, testing providers,
   creating evaluation runs/groups, attaching sessions, and exporting evidence packs.
-- Resources: read stable evidence URIs without invoking a tool call.
+- Resources: read stable evidence URIs, MCP self-description, session timelines, and evidence file
+  paths without invoking a tool call.
 - Prompts: start common analysis/reporting tasks from reusable templates.
 
 The evaluation-oriented run flow is:
 
-1. Call `inspector_create_run` before a task starts to declare a stable `runId` and optional
-   `sessionId`.
-2. Call `inspector_update_run` as the task moves through `running`, `failed`, `completed`, or
+1. Call `inspector_create_run` before a task starts to declare a stable `runId`, optional
+   `sessionId`, and optional `groupId`.
+2. Optionally call `inspector_set_current_context` so the active run/session/model/provider is
+   discoverable through `inspector://context/current`.
+3. Call `inspector_update_run` as the task moves through `running`, `failed`, `completed`, or
    `cancelled`; metadata keys are merged so CI can add build numbers, branch names, or case ids.
-3. Let the coding agent run through the proxy as usual.
-4. If something fails, call `inspector_get_recent_failures` or read
+4. Let the coding agent run through the proxy as usual.
+5. If something fails, call `inspector_get_recent_failures` or read
    `inspector://failures/recent`, then use `inspector_search_logs` to locate suspicious log ids.
-5. Call `inspector_get_run` to inspect the declared run.
-6. Call `inspector_export_evidence` to write JSON, Markdown, and HTML artifacts under:
+6. Use `inspector_get_session_timeline` for a quick chronological view before opening large logs.
+7. Call `inspector_get_run` to inspect the declared run.
+8. Call `inspector_export_evidence` to write JSON, Markdown, and HTML artifacts under:
 
 ```text
 <dataDir>/evidence/<runId>/evidence.json
@@ -211,17 +218,24 @@ The evaluation-oriented run flow is:
 <dataDir>/evidence/<runId>/evidence.html
 ```
 
+Use `inspector_get_evidence_files` to return those paths and `inspector_export_evidence_bundle` to
+create `evidence.zip`.
+
 For benchmark or CI systems that spawn multiple coding-agent processes, use a group as the
 outer evaluation artifact:
 
 1. Call `inspector_create_group` once for the evaluation batch.
-2. Start each OpenCode/Codex process through the proxy with its own model/provider.
-3. As each process discovers or reports its session id, call `inspector_add_group_session` with
+2. Call `inspector_set_current_context` with the group/project/task.
+3. For each OpenCode/Codex worker, call `inspector_create_run` with the group's `groupId`.
+4. Start each OpenCode/Codex process through the proxy with its own model/provider.
+5. As each process discovers or reports its session id, call `inspector_update_run` with the real
+   `sessionId`; runs that have a `groupId` are auto-attached to the group.
+6. Optionally call `inspector_add_group_session` to override or enrich the group member with
    `groupId`, `sessionId`, and optional `runId`, `provider`, `model`, `agent`, `label`, and
    metadata.
-4. Call `inspector_update_group` to mark the whole batch `running`, `failed`, `completed`, or
+7. Call `inspector_update_group` to mark the whole batch `running`, `failed`, `completed`, or
    `cancelled`.
-5. Call `inspector_export_group_evidence` to write an aggregate provider/model matrix under:
+8. Call `inspector_export_group_evidence` to write an aggregate provider/model matrix under:
 
 ```text
 <dataDir>/evidence/groups/<groupId>/evidence.json
@@ -229,21 +243,31 @@ outer evaluation artifact:
 <dataDir>/evidence/groups/<groupId>/evidence.html
 ```
 
+Use `inspector_get_group_evidence_files` to return those paths and
+`inspector_export_group_evidence_bundle` to create `group-evidence.zip`.
+
 Useful MCP resource URIs:
 
 | Resource | Purpose |
 | --- | --- |
+| `inspector://mcp/health` | Read MCP version, transport, mode, and catalog counts. |
+| `inspector://mcp/capabilities` | Read tools split into read vs write/action, resources, prompts, and write mode. |
+| `inspector://mcp/config` | Read Streamable HTTP, stdio bridge, OpenCode, and network config snippets. |
+| `inspector://context/current` | Read the active eval/coding context. |
 | `inspector://sessions` | List known session ids. |
 | `inspector://sessions/{sessionId}` | Read a compact session summary with Inspector links, counts, models, providers, token totals, and recent logs. |
+| `inspector://sessions/{sessionId}/timeline` | Read a chronological request timeline for a session. |
 | `inspector://logs/{id}` | Read bounded log details for one captured request. Large bodies are capped for agent safety. |
 | `inspector://runs` | List declared evaluation runs. |
 | `inspector://failures/recent` | Read recent failed/cancelled runs and non-success evidence classifications. |
 | `inspector://runs/{runId}` | Read one declared run and its evidence paths. |
 | `inspector://evidence/{runId}` | Read the exported Markdown evidence pack for a run. |
+| `inspector://evidence/{runId}/files` | Read local paths and byte status for run evidence files. |
 | `inspector://groups` | List declared evaluation groups. |
 | `inspector://groups/{groupId}` | Read one group, including attached session/run members and evidence paths. |
 | `inspector://groups/{groupId}/sessions` | Read only the attached group member list. |
 | `inspector://groups/{groupId}/evidence` | Read the exported Markdown evidence pack for a group. |
+| `inspector://groups/{groupId}/evidence/files` | Read local paths and byte status for group evidence files. |
 
 Built-in prompt templates help turn captured evidence into user-facing output:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/agent-inspector",
-  "version": "2.0.40",
+  "version": "2.0.42",
   "type": "module",
   "description": "Agent observability and knowledge capture layer for AI coding tools.",
   "license": "MIT",

package/src/components/ProxyViewer.tsx

@@ -13,6 +13,7 @@ import {
 
 import type { CapturedLog } from "../contracts";
 import { exportLogsAsZip, type ExportMode } from "../lib/export-logs";
+import { copyTextToClipboard } from "../lib/clipboard";
 import type { CaptureMode, TimeDisplayFormat } from "../lib/runtimeConfig";
 import { formatTimestampRange } from "../lib/timeDisplay";
 import { cn, formatContextWindowTokens, formatTokens } from "../lib/utils";
@@ -276,7 +277,8 @@ function CopyableCommand({ command }: { command: string }): JSX.Element {
   const [copied, setCopied] = useState(false);
 
   const handleCopy = useCallback(() => {
-    void window.navigator.clipboard.writeText(command).then(() => {
+    void copyTextToClipboard(command).then((success) => {
+      if (!success) return;
       setCopied(true);
       setTimeout(() => setCopied(false), 2000);
     });
@@ -557,7 +559,8 @@ function SessionContextBar({
   const userAgent = useMemo(() => getFirstUserAgent(logs), [logs]);
 
   const handleCopyLink = useCallback(() => {
-    void window.navigator.clipboard.writeText(window.location.href).then(() => {
+    void copyTextToClipboard(window.location.href).then((success) => {
+      if (!success) return;
       setCopied(true);
       setTimeout(() => setCopied(false), 2000);
     });

package/src/components/providers/ProviderCard.tsx

@@ -24,6 +24,7 @@ import {
   ChevronRight,
 } from "lucide-react";
 import type { ProviderConfig } from "../../proxy/providers";
+import { copyTextToClipboard } from "../../lib/clipboard";
 import { maskApiKey } from "../../lib/mask";
 import {
   findProviderModelMetadata,
@@ -422,9 +423,11 @@ export function ProviderCard({
   const [showModelResults, setShowModelResults] = useState(false);
 
   function handleCopy() {
-    navigator.clipboard.writeText(provider.apiKey).catch(() => {});
-    setCopied(true);
-    setTimeout(() => setCopied(false), 2000);
+    void copyTextToClipboard(provider.apiKey).then((success) => {
+      if (!success) return;
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    });
   }
 
   // Get docs URL: use provider.apiDocsUrl if configured, otherwise check KNOWN_PROVIDER_DOCS

package/src/components/providers/ProviderForm.tsx

@@ -4,6 +4,7 @@ import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from ".
 import { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from "../ui/tooltip";
 import { Eye, EyeOff, Copy, Check, ChevronDown } from "lucide-react";
 import type { ProviderConfig, ProviderModelMetadata } from "../../lib/providerContract";
+import { copyTextToClipboard } from "../../lib/clipboard";
 import { maskApiKey } from "../../lib/mask";
 import { formatContextWindowInput, parseContextWindowTokensInput } from "../../lib/utils";
 
@@ -316,9 +317,11 @@ export function ProviderForm({ provider, onSubmit, onCancel }: ProviderFormProps
     provider?.modelMetadata?.some((metadata) => metadata.contextWindow !== undefined) ?? false;
 
   function handleCopy() {
-    navigator.clipboard.writeText(apiKey).catch(() => {});
-    setCopied(true);
-    setTimeout(() => setCopied(false), 2000);
+    void copyTextToClipboard(apiKey).then((success) => {
+      if (!success) return;
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    });
   }
 
   useEffect(() => {

package/src/components/providers/ProvidersPanel.tsx

@@ -8,6 +8,7 @@ import { ConfirmDialog } from "../ui/confirm-dialog";
 import { ProviderCard } from "./ProviderCard";
 import { ProviderForm } from "./ProviderForm";
 import { parseJsonResponse, readApiError } from "../../lib/apiClient";
+import { copyTextToClipboard } from "../../lib/clipboard";
 import {
   ProviderConfigSchema,
   type ProviderConfig,
@@ -614,12 +615,16 @@ export function ProvidersPanel({
                 <button
                   type="button"
                   onClick={() => {
-                    void window.navigator.clipboard.writeText(configPath).then(() => {
+                    void copyTextToClipboard(configPath).then((success) => {
+                      if (!success) return;
                       setConfigPathCopied(true);
                       setTimeout(() => setConfigPathCopied(false), 2000);
                     });
                   }}
                   className="shrink-0 ml-auto text-muted-foreground hover:text-foreground transition-colors"
+                  aria-label={
+                    configPathCopied ? "Copied config file path" : "Copy config file path"
+                  }
                 >
                   {configPathCopied ? (
                     <Check className="size-3 text-green-500" />

package/src/components/providers/SettingsDialog.tsx

@@ -7,6 +7,7 @@ import { Button } from "../ui/button";
 import { ProvidersPanel } from "./ProvidersPanel";
 import { useProviders } from "../../lib/useProviders";
 import { useStripConfig } from "../../lib/useStripConfig";
+import { copyTextToClipboard } from "../../lib/clipboard";
 import {
   MAX_PROVIDER_TEST_TIMEOUT_SECONDS,
   MAX_SLOW_RESPONSE_THRESHOLD_SECONDS,
@@ -75,6 +76,7 @@ export function SettingsDialog(): JSX.Element {
             <TabsTrigger value="providers">Providers</TabsTrigger>
             <TabsTrigger value="proxy">Proxy</TabsTrigger>
             <TabsTrigger value="storage">Storage</TabsTrigger>
+            <TabsTrigger value="mcp">MCP</TabsTrigger>
             <TabsTrigger value="onboarding">Onboarding</TabsTrigger>
           </TabsList>
 
@@ -100,6 +102,9 @@ export function SettingsDialog(): JSX.Element {
             <TabsContent value="storage">
               <StorageSettingsTab />
             </TabsContent>
+            <TabsContent value="mcp">
+              <McpSettingsTab />
+            </TabsContent>
             <TabsContent value="onboarding">
               <OnboardingSettingsTab />
             </TabsContent>
@@ -171,7 +176,8 @@ function StorageSettingsTab(): JSX.Element {
   }, [refresh]);
 
   const handleCopy = useCallback((id: string, value: string) => {
-    void window.navigator.clipboard.writeText(value).then(() => {
+    void copyTextToClipboard(value).then((success) => {
+      if (!success) return;
       setCopiedId(id);
       setTimeout(() => setCopiedId(null), 1600);
     });
@@ -314,7 +320,8 @@ function OnboardingSettingsTab(): JSX.Element {
   );
 
   const handleCopy = useCallback((id: string, value: string) => {
-    void window.navigator.clipboard.writeText(value).then(() => {
+    void copyTextToClipboard(value).then((success) => {
+      if (!success) return;
       setCopiedId(id);
       setTimeout(() => setCopiedId(null), 1600);
     });
@@ -387,6 +394,139 @@ function OnboardingSettingsTab(): JSX.Element {
   );
 }
 
+function McpSettingsTab(): JSX.Element {
+  const [copiedId, setCopiedId] = useState<string | null>(null);
+  const origin = useMemo(() => {
+    if (typeof window === "undefined") return "http://localhost:25947";
+    return window.location.origin;
+  }, []);
+  const endpoint = `${origin}/api/mcp`;
+  const values = useMemo(
+    () => [
+      { id: "mcp-url", label: "Streamable HTTP MCP URL", value: endpoint },
+      {
+        id: "stdio",
+        label: "Stdio bridge command",
+        value: `agent-inspector-mcp stdio --url ${endpoint}`,
+      },
+      {
+        id: "doctor",
+        label: "Bridge doctor",
+        value: `agent-inspector-mcp doctor --url ${endpoint}`,
+      },
+      {
+        id: "readonly",
+        label: "Readonly mode",
+        value: "AGENT_INSPECTOR_MCP_READONLY=1 agent-inspector",
+      },
+      {
+        id: "capabilities",
+        label: "Capabilities resource",
+        value: "inspector://mcp/capabilities",
+      },
+      {
+        id: "context",
+        label: "Current context resource",
+        value: "inspector://context/current",
+      },
+      {
+        id: "streamable-json",
+        label: "Streamable HTTP JSON",
+        value: JSON.stringify(
+          {
+            mcpServers: {
+              "agent-inspector": {
+                type: "streamableHttp",
+                url: endpoint,
+              },
+            },
+          },
+          null,
+          2,
+        ),
+      },
+      {
+        id: "stdio-json",
+        label: "Stdio MCP JSON",
+        value: JSON.stringify(
+          {
+            mcpServers: {
+              "agent-inspector": {
+                command: "agent-inspector-mcp",
+                args: ["stdio", "--url", endpoint],
+              },
+            },
+          },
+          null,
+          2,
+        ),
+      },
+      {
+        id: "opencode-local",
+        label: "OpenCode local MCP",
+        value: JSON.stringify(
+          {
+            mcp: {
+              "agent-inspector": {
+                type: "local",
+                command: ["agent-inspector-mcp", "stdio", "--url", endpoint],
+                enabled: true,
+              },
+            },
+          },
+          null,
+          2,
+        ),
+      },
+      {
+        id: "codex-toml",
+        label: "Codex TOML",
+        value: `[mcp_servers.agent-inspector]\ncommand = "agent-inspector-mcp"\nargs = ["stdio", "--url", "${endpoint}"]`,
+      },
+    ],
+    [endpoint],
+  );
+
+  const handleCopy = useCallback((id: string, value: string) => {
+    void copyTextToClipboard(value).then((success) => {
+      if (!success) return;
+      setCopiedId(id);
+      setTimeout(() => setCopiedId(null), 1600);
+    });
+  }, []);
+
+  return (
+    <div className="min-w-0 space-y-4">
+      <div className="flex items-center gap-2">
+        <Terminal className="size-4 text-muted-foreground" />
+        <h3 className="text-sm font-semibold">MCP access</h3>
+      </div>
+      <div className="grid gap-2 rounded-md border border-border bg-background px-3 py-2 text-xs text-muted-foreground">
+        <div>
+          Use Streamable HTTP when the client supports URL-based MCP. Use the stdio bridge only for
+          stdio-only clients. Configure one entry for the same Inspector instance.
+        </div>
+        <div>
+          If the MCP client runs in another container or host, replace localhost with a reachable
+          host/IP and verify the network path.
+        </div>
+      </div>
+      <div className="grid gap-2">
+        {values.map((item) => (
+          <CopyableSetupValue
+            key={item.id}
+            id={item.id}
+            label={item.label}
+            value={item.value}
+            copiedId={copiedId}
+            onCopy={handleCopy}
+          />
+        ))}
+      </div>
+    </div>
+  );
+}
+
 function ProxySettingsTab(): JSX.Element {
   const {
     strip,

package/src/components/proxy-viewer/CompareDrawer.tsx

@@ -13,6 +13,7 @@ import {
   X,
 } from "lucide-react";
 import { cn, formatTokens } from "../../lib/utils";
+import { copyTextToClipboard } from "../../lib/clipboard";
 import type { CapturedLog } from "../../contracts";
 import {
   type DiffOp,
@@ -656,7 +657,8 @@ export function CompareDrawer({ left, right, onClose }: CompareDrawerProps): JSX
   const [copiedPath, setCopiedPath] = useState<string | null>(null);
   const copyResetTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
   const onCopyPath = (path: string) => {
-    void window.navigator.clipboard.writeText(path).then(() => {
+    void copyTextToClipboard(path).then((success) => {
+      if (!success) return;
       setCopiedPath(path);
       if (copyResetTimer.current !== null) clearTimeout(copyResetTimer.current);
       copyResetTimer.current = setTimeout(() => setCopiedPath(null), 1500);