@tonyclaw/agent-inspector 2.0.41 → 2.0.42

package/.output/server/{_tanstack-start-manifest_v-CJ4__weU.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-CI3HFEcV.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-B_LPYuM0.js", "/assets/ProxyViewerContainer-DsU6QETm.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-BHqywvM3.js", "/assets/ProxyViewerContainer-DsU6QETm.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-CI3HFEcV.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

@@ -35,103 +35,103 @@ const headers = ((m) => function headersRouteRule(event) {
   }
 });
 const assets = {
-  "/assets/CompareDrawer-DCg6S2cl.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"49e8-k5Sysa3YIYWHG3hgZOKGI6S/VSQ"',
-    "mtime": "2026-07-02T06:48:19.896Z",
-    "size": 18920,
-    "path": "../public/assets/CompareDrawer-DCg6S2cl.js"
-  },
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
+  "/assets/index-D1MkoT4l.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"74-5tWPGheuXYTT+KVstHwHWELFTpU"',
+    "mtime": "2026-07-03T01:44:09.155Z",
+    "size": 116,
+    "path": "../public/assets/index-D1MkoT4l.js"
+  },
   "/assets/minimax-BPMzvuL-.jpeg": {
     "type": "image/jpeg",
     "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/RequestAnatomy-BhqvLQp9.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"4485-e5cA5GSbVksNziulI0+GKBLNU8I"',
-    "mtime": "2026-07-02T06:48:19.896Z",
-    "size": 17541,
-    "path": "../public/assets/RequestAnatomy-BhqvLQp9.js"
-  },
-  "/assets/ReplayDialog-ClVgjSDE.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"318c-LpwaR4Dkb9DojATSYhkNfnmy2zI"',
-    "mtime": "2026-07-02T06:48:19.896Z",
-    "size": 12684,
-    "path": "../public/assets/ReplayDialog-ClVgjSDE.js"
-  },
-  "/assets/index-B_LPYuM0.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"74-nFohMzCw3y6hRBAH/I/1aAKk9qA"',
-    "mtime": "2026-07-02T06:48:19.896Z",
-    "size": 116,
-    "path": "../public/assets/index-B_LPYuM0.js"
-  },
   "/assets/index-BfGJEb-2.css": {
     "type": "text/css; charset=utf-8",
     "etag": '"1acc9-JrjZs7fIRGuBr66cqP9miLHcLKk"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 109769,
     "path": "../public/assets/index-BfGJEb-2.css"
   },
-  "/assets/StreamingChunkSequence-CaORmoKX.js": {
+  "/assets/CompareDrawer-Cfqxlo-U.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d5c-CFWA5sGEVjRZL7Tc8f3pZV/+3pw"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "etag": '"49e8-4/OM/oQ2JC3boP6H31ljkTMqaic"',
+    "mtime": "2026-07-03T01:44:09.157Z",
+    "size": 18920,
+    "path": "../public/assets/CompareDrawer-Cfqxlo-U.js"
+  },
+  "/assets/main-DOy_Q96H.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"517d9-GvqATjRQp0lZCEyGodPErXeDUXg"',
+    "mtime": "2026-07-03T01:44:09.157Z",
+    "size": 333785,
+    "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-CaORmoKX.js"
+    "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/ResponseView-BZAJoK6B.js": {
+  "/assets/ResponseView-xBmr54hB.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"30d1-1lX2qKD6ndedO8OL4mCAFqTi2c4"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "etag": '"30d1-XQa3i7Dl3IpHmJVZY7j7wGeKTWA"',
+    "mtime": "2026-07-03T01:44:09.157Z",
     "size": 12497,
-    "path": "../public/assets/ResponseView-BZAJoK6B.js"
+    "path": "../public/assets/ResponseView-xBmr54hB.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/_sessionId-BHqywvM3.js": {
+  "/assets/_sessionId-CbWEG5ej.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-aRnjHQXX3+PkuHFc37DXAEd2jHY"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "etag": '"d2-znIEA1ArIEaTdapPt/+hhunhTEA"',
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 210,
-    "path": "../public/assets/_sessionId-BHqywvM3.js"
-  },
-  "/assets/main-CI3HFEcV.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"517d9-uRZNMUg8U43tHnhzFFtGrUV430s"',
-    "mtime": "2026-07-02T06:48:19.896Z",
-    "size": 333785,
-    "path": "../public/assets/main-CI3HFEcV.js"
+    "path": "../public/assets/_sessionId-CbWEG5ej.js"
   },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-07-02T06:48:19.896Z",
+    "mtime": "2026-07-03T01:44:09.155Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/ProxyViewerContainer-DsU6QETm.js": {
+  "/assets/ProxyViewerContainer-CE9pAX4c.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"b645c-NZxv8v6zEqGaTkLxqNhFQyxqtsc"',
-    "mtime": "2026-07-02T06:48:19.896Z",
-    "size": 746588,
-    "path": "../public/assets/ProxyViewerContainer-DsU6QETm.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.41",
+  "version": "2.0.42",
   "type": "module",
   "description": "Agent observability and knowledge capture layer for AI coding tools.",
   "license": "MIT",

package/src/components/providers/SettingsDialog.tsx

@@ -76,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>
 
@@ -101,6 +102,9 @@ export function SettingsDialog(): JSX.Element {
             <TabsContent value="storage">
               <StorageSettingsTab />
             </TabsContent>
+            <TabsContent value="mcp">
+              <McpSettingsTab />
+            </TabsContent>
             <TabsContent value="onboarding">
               <OnboardingSettingsTab />
             </TabsContent>
@@ -390,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/lib/runContract.ts

@@ -76,6 +76,7 @@ export const EvidenceReportSchema = JenkinsReportSchema;
 export const InspectorRunSchema = z.object({
   id: z.string(),
   sessionId: z.string(),
+  groupId: z.string().nullable().default(null),
   title: z.string(),
   task: z.string().nullable(),
   project: z.string().nullable(),
@@ -92,6 +93,7 @@ export const CreateInspectorRunInputSchema = z
   .object({
     runId: z.string().min(1).optional(),
     sessionId: z.string().min(1).optional(),
+    groupId: z.string().min(1).nullable().optional(),
     title: z.string().min(1).optional(),
     task: z.string().nullable().optional(),
     project: z.string().nullable().optional(),
@@ -104,6 +106,7 @@ export const CreateInspectorRunInputSchema = z
 
 export const UpdateInspectorRunInputSchema = z.object({
   sessionId: z.string().min(1).optional(),
+  groupId: z.string().min(1).nullable().optional(),
   title: z.string().min(1).optional(),
   task: z.string().nullable().optional(),
   project: z.string().nullable().optional(),

package/src/mcp/currentContext.ts

@@ -0,0 +1,65 @@
+import type { JsonValue } from "../contracts";
+
+export type InspectorCurrentContext = {
+  groupId: string | null;
+  runId: string | null;
+  sessionId: string | null;
+  model: string | null;
+  provider: string | null;
+  agent: string | null;
+  project: string | null;
+  task: string | null;
+  metadata: Record<string, JsonValue>;
+  updatedAt: string;
+};
+
+export type InspectorCurrentContextPatch = Partial<
+  Omit<InspectorCurrentContext, "metadata" | "updatedAt">
+> & {
+  metadata?: Record<string, JsonValue>;
+};
+
+function envString(name: string): string | null {
+  const value = process.env[name];
+  if (value === undefined) return null;
+  const trimmed = value.trim();
+  return trimmed.length === 0 ? null : trimmed;
+}
+
+function initialContext(): InspectorCurrentContext {
+  return {
+    groupId: envString("INSPECTOR_GROUP_ID"),
+    runId: envString("INSPECTOR_RUN_ID"),
+    sessionId: envString("INSPECTOR_SESSION_ID"),
+    model: envString("INSPECTOR_MODEL"),
+    provider: envString("INSPECTOR_PROVIDER"),
+    agent: envString("INSPECTOR_AGENT"),
+    project: envString("INSPECTOR_PROJECT"),
+    task: envString("INSPECTOR_TASK"),
+    metadata: {},
+    updatedAt: new Date().toISOString(),
+  };
+}
+
+let currentContext = initialContext();
+
+export function getCurrentContext(): InspectorCurrentContext {
+  return currentContext;
+}
+
+export function setCurrentContext(patch: InspectorCurrentContextPatch): InspectorCurrentContext {
+  currentContext = {
+    ...currentContext,
+    ...patch,
+    metadata:
+      patch.metadata === undefined
+        ? currentContext.metadata
+        : { ...currentContext.metadata, ...patch.metadata },
+    updatedAt: new Date().toISOString(),
+  };
+  return currentContext;
+}
+
+export function _resetCurrentContextForTests(): void {
+  currentContext = initialContext();
+}

package/src/mcp/mode.ts

@@ -0,0 +1,56 @@
+export type McpWriteMode = "enabled" | "readonly";
+
+function parseFlag(value: string | undefined): boolean | null {
+  if (value === undefined) return null;
+  switch (value.trim().toLowerCase()) {
+    case "1":
+    case "true":
+    case "yes":
+    case "on":
+      return true;
+    case "0":
+    case "false":
+    case "no":
+    case "off":
+      return false;
+    default:
+      return null;
+  }
+}
+
+export function isMcpWriteEnabled(): boolean {
+  const readonlyFlag = parseFlag(process.env["AGENT_INSPECTOR_MCP_READONLY"]);
+  if (readonlyFlag === true) return false;
+
+  const writesFlag = parseFlag(process.env["AGENT_INSPECTOR_MCP_WRITES"]);
+  if (writesFlag === false) return false;
+
+  return true;
+}
+
+export function getMcpWriteMode(): McpWriteMode {
+  return isMcpWriteEnabled() ? "enabled" : "readonly";
+}
+
+export function getMcpModeInfo(): {
+  writeMode: McpWriteMode;
+  writesEnabled: boolean;
+  env: {
+    AGENT_INSPECTOR_MCP_READONLY: string | null;
+    AGENT_INSPECTOR_MCP_WRITES: string | null;
+  };
+  note: string;
+} {
+  const writesEnabled = isMcpWriteEnabled();
+  return {
+    writeMode: writesEnabled ? "enabled" : "readonly",
+    writesEnabled,
+    env: {
+      AGENT_INSPECTOR_MCP_READONLY: process.env["AGENT_INSPECTOR_MCP_READONLY"] ?? null,
+      AGENT_INSPECTOR_MCP_WRITES: process.env["AGENT_INSPECTOR_MCP_WRITES"] ?? null,
+    },
+    note: writesEnabled
+      ? "MCP write/action tools are enabled. Set AGENT_INSPECTOR_MCP_READONLY=1 to expose the same catalog while blocking mutations."
+      : "MCP is in readonly mode. Read tools/resources still work, while write/action tools return an isError result.",
+  };
+}