@tonyclaw/agent-inspector 2.0.33 → 2.0.35

package/.output/server/{_tanstack-start-manifest_v-dEujKJ3-.mjs → _tanstack-start-manifest_v-BNlafGbl.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-B797Hnge.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-C6AiRPsJ.js", "/assets/ProxyViewerContainer--Pes01q2.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-Bc26Rfxs.js", "/assets/ProxyViewerContainer--Pes01q2.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-B797Hnge.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-eD8hEOHT.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-AiQY20d7.js", "/assets/ProxyViewerContainer-BVlcRirf.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-DkhHqlzB.js", "/assets/ProxyViewerContainer-BVlcRirf.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-eD8hEOHT.js" });
 export {
   tsrStartManifest
 };

package/.output/server/index.mjs

@@ -35,103 +35,103 @@ const headers = ((m) => function headersRouteRule(event) {
   }
 });
 const assets = {
-  "/assets/index-C6AiRPsJ.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"74-a6DN9m2CAFwv76/yc/R0OhyV/6c"',
-    "mtime": "2026-07-01T02:54:30.449Z",
-    "size": 116,
-    "path": "../public/assets/index-C6AiRPsJ.js"
-  },
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-07-01T02:54:30.449Z",
+    "mtime": "2026-07-01T04:41:43.991Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
+  "/assets/CompareDrawer-Cin0_f71.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"49fe-SMhlBvC9BPW+osRHPbYsYl/bBwg"',
+    "mtime": "2026-07-01T04:41:43.993Z",
+    "size": 18942,
+    "path": "../public/assets/CompareDrawer-Cin0_f71.js"
+  },
+  "/assets/index-AiQY20d7.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"74-rfFHE/No9yqZRRcPoLF42xPy938"',
+    "mtime": "2026-07-01T04:41:43.992Z",
+    "size": 116,
+    "path": "../public/assets/index-AiQY20d7.js"
+  },
   "/assets/minimax-BPMzvuL-.jpeg": {
     "type": "image/jpeg",
     "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-07-01T02:54:30.449Z",
+    "mtime": "2026-07-01T04:41:43.992Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/index-C_8PFAm2.css": {
+  "/assets/main-eD8hEOHT.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"51726-UvOePLuurqvt/vZXR1E13qM+9Tw"',
+    "mtime": "2026-07-01T04:41:43.992Z",
+    "size": 333606,
+    "path": "../public/assets/main-eD8hEOHT.js"
+  },
+  "/assets/index-BfGJEb-2.css": {
     "type": "text/css; charset=utf-8",
-    "etag": '"1ac9e-HNLu+/ctAdlujlPfCr3RCZb1vrw"',
-    "mtime": "2026-07-01T02:54:30.449Z",
-    "size": 109726,
-    "path": "../public/assets/index-C_8PFAm2.css"
+    "etag": '"1acc9-JrjZs7fIRGuBr66cqP9miLHcLKk"',
+    "mtime": "2026-07-01T04:41:43.992Z",
+    "size": 109769,
+    "path": "../public/assets/index-BfGJEb-2.css"
   },
-  "/assets/ReplayDialog-iuzfh85b.js": {
+  "/assets/ReplayDialog-C6nOMhjx.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"318c-XcEmd05uEcAHlG9titFXbo+gCrY"',
-    "mtime": "2026-07-01T02:54:30.450Z",
+    "etag": '"318c-RCD6AdXOMKbFy3+xkjBhcj2usiU"',
+    "mtime": "2026-07-01T04:41:43.993Z",
     "size": 12684,
-    "path": "../public/assets/ReplayDialog-iuzfh85b.js"
-  },
-  "/assets/CompareDrawer-ClTJxdoU.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"49fe-p99Ki2esmkY4icjU0xIHKhhNuIk"',
-    "mtime": "2026-07-01T02:54:30.450Z",
-    "size": 18942,
-    "path": "../public/assets/CompareDrawer-ClTJxdoU.js"
+    "path": "../public/assets/ReplayDialog-C6nOMhjx.js"
   },
-  "/assets/RequestAnatomy-FZnnP9Gx.js": {
+  "/assets/RequestAnatomy-DenWbdqV.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"4485-pgwLUhuIJkkKYqkanchZKSnuAT0"',
-    "mtime": "2026-07-01T02:54:30.450Z",
+    "etag": '"4485-IHvZwvctovAf9yd6eKLRdmz7p8U"',
+    "mtime": "2026-07-01T04:41:43.993Z",
     "size": 17541,
-    "path": "../public/assets/RequestAnatomy-FZnnP9Gx.js"
+    "path": "../public/assets/RequestAnatomy-DenWbdqV.js"
   },
-  "/assets/main-B797Hnge.js": {
+  "/assets/ResponseView-BsalZiZ5.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"51726-NY9MyReO0iwQh08rCm1upy3DdpM"',
-    "mtime": "2026-07-01T02:54:30.449Z",
-    "size": 333606,
-    "path": "../public/assets/main-B797Hnge.js"
-  },
-  "/assets/ResponseView-MZ6ZWvbL.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"30d0-nvVFmB+Fh0jpFdfRsVGSbhaM0AQ"',
-    "mtime": "2026-07-01T02:54:30.450Z",
+    "etag": '"30d0-E5hbwCjhHnCoy+Fe7tsz+y/Avvw"',
+    "mtime": "2026-07-01T04:41:43.993Z",
     "size": 12496,
-    "path": "../public/assets/ResponseView-MZ6ZWvbL.js"
+    "path": "../public/assets/ResponseView-BsalZiZ5.js"
   },
-  "/assets/StreamingChunkSequence-B8mZMdzs.js": {
+  "/assets/StreamingChunkSequence-Cla2X13P.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d57-VG77bGn8l1PydHDayZdXVGDb5U8"',
-    "mtime": "2026-07-01T02:54:30.450Z",
+    "etag": '"d57-f5xxcgGcUU3SGwuaaf3usFI7n70"',
+    "mtime": "2026-07-01T04:41:43.993Z",
     "size": 3415,
-    "path": "../public/assets/StreamingChunkSequence-B8mZMdzs.js"
+    "path": "../public/assets/StreamingChunkSequence-Cla2X13P.js"
   },
-  "/assets/_sessionId-Bc26Rfxs.js": {
+  "/assets/_sessionId-DkhHqlzB.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-DJ+ArTTuJAjf6O/vpm4IpJ4fTdU"',
-    "mtime": "2026-07-01T02:54:30.449Z",
+    "etag": '"d2-FVtNmnT1a1xh4oOUYbKZyU2dqr0"',
+    "mtime": "2026-07-01T04:41:43.992Z",
     "size": 210,
-    "path": "../public/assets/_sessionId-Bc26Rfxs.js"
-  },
-  "/assets/qwen-CONDcHqt.png": {
-    "type": "image/png",
-    "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-07-01T02:54:30.449Z",
-    "size": 357059,
-    "path": "../public/assets/qwen-CONDcHqt.png"
+    "path": "../public/assets/_sessionId-DkhHqlzB.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-07-01T02:54:30.449Z",
+    "mtime": "2026-07-01T04:41:43.992Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/ProxyViewerContainer--Pes01q2.js": {
+  "/assets/qwen-CONDcHqt.png": {
+    "type": "image/png",
+    "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
+    "mtime": "2026-07-01T04:41:43.992Z",
+    "size": 357059,
+    "path": "../public/assets/qwen-CONDcHqt.png"
+  },
+  "/assets/ProxyViewerContainer-BVlcRirf.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"b565e-t/KBWxv0P/4ezDh3bFUBZTEtCzI"',
-    "mtime": "2026-07-01T02:54:30.450Z",
-    "size": 743006,
-    "path": "../public/assets/ProxyViewerContainer--Pes01q2.js"
+    "etag": '"b580f-9fZACETDim2/zxYIGCgAOnb4iZk"',
+    "mtime": "2026-07-01T04:41:43.993Z",
+    "size": 743439,
+    "path": "../public/assets/ProxyViewerContainer-BVlcRirf.js"
   }
 };
 function readAsset(id) {
@@ -159,7 +159,7 @@ const EncodingMap = {
   br: ".br",
   zstd: ".zst"
 };
-const _6PJ5fH = defineHandler((event) => {
+const _bTSMt_ = defineHandler((event) => {
   if (event.req.method && !METHODS.has(event.req.method)) {
     return;
   }
@@ -231,15 +231,15 @@ const findRouteRules = /* @__PURE__ */ (() => {
     return r;
   };
 })();
-const _lazy_L6WeRa = defineLazyEventHandler(() => import("./_chunks/ssr-renderer.mjs"));
+const _lazy_OSYDIZ = defineLazyEventHandler(() => import("./_chunks/ssr-renderer.mjs"));
 const findRoute = /* @__PURE__ */ (() => {
-  const data = { route: "/**", handler: _lazy_L6WeRa };
+  const data = { route: "/**", handler: _lazy_OSYDIZ };
   return ((_m, p) => {
     return { data, params: { "_": p.slice(1) } };
   });
 })();
 const globalMiddleware = [
-  toEventHandler(_6PJ5fH)
+  toEventHandler(_bTSMt_)
 ].filter(Boolean);
 const errorHandler$1 = (error, event) => {
   const res = defaultHandler(error, event);

package/README.md

@@ -23,6 +23,18 @@ npm install -g @tonyclaw/agent-inspector
 agent-inspector
 ```
 
+Optional MCP-first companion package:
+
+```bash
+npm install -g @tonyclaw/agent-inspector-mcp
+agent-inspector-mcp doctor
+```
+
+`@tonyclaw/agent-inspector` runs the local UI, proxy, REST API, storage, and built-in
+`/api/mcp` endpoint. `@tonyclaw/agent-inspector-mcp` is the enhancement package for
+stdio-first MCP clients and setup automation; it bridges to the local Inspector endpoint without
+moving your captured evidence out of the machine.
+
 On Windows, the npm install step creates a local `agent-inspector.exe` runtime
 from the user's installed Node.js runtime. The long-running server process
 therefore appears in Task Manager as **Agent Inspector <version>** with the
@@ -151,6 +163,22 @@ Agent Inspector exposes MCP at:
 http://localhost:25947/api/mcp
 ```
 
+Coding agents can connect to this MCP surface directly over Streamable HTTP, or through the
+companion stdio bridge:
+
+```bash
+agent-inspector-mcp stdio
+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.
+
+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
+server.
+
 Coding agents can use the MCP surface in three ways:
 
 - Tools: perform actions such as listing logs, reading bounded log details, testing providers,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/agent-inspector",
-  "version": "2.0.33",
+  "version": "2.0.35",
   "type": "module",
   "description": "Agent observability and knowledge capture layer for AI coding tools.",
   "license": "MIT",
@@ -10,6 +10,9 @@
     "url": "git+https://gitcode.com/TonyClaw/agent-inspector.git"
   },
   "homepage": "https://gitcode.com/TonyClaw/agent-inspector#readme",
+  "workspaces": [
+    "packages/*"
+  ],
   "bugs": {
     "url": "https://gitcode.com/TonyClaw/agent-inspector/issues"
   },
@@ -47,8 +50,9 @@
   "scripts": {
     "dev": "vite dev",
     "start": "node .output/cli.js",
-    "build": "vite build && bun build:cli",
+    "build": "vite build && bun build:cli && bun build:mcp",
     "build:cli": "npx esbuild src/cli.ts --bundle --platform=node --target=node18 --format=esm --outfile=.output/cli.js",
+    "build:mcp": "npx esbuild packages/agent-inspector-mcp/src/cli.ts --bundle --platform=node --target=node20 --format=esm --outfile=packages/agent-inspector-mcp/dist/cli.js",
     "postinstall": "node scripts/setup-windows-runtime.mjs && node scripts/setup-agent-skills.mjs",
     "prepublishOnly": "npm run build",
     "typecheck": "tsc --noEmit",

package/src/cli/templates/codex-skill-onboard.ts

@@ -45,6 +45,13 @@ http://localhost:${port}/api/mcp
 This skill is installed at \`~/.codex/skills/agent-inspector-onboard/SKILL.md\`.
 Codex user-level configuration lives in \`~/.codex/config.toml\`. Codex supports streamable HTTP MCP servers with \`mcp_servers.<id>.url\`, so no extra stdio bridge package is needed.
 
+Use exactly one MCP transport for the same Inspector instance:
+
+- Streamable HTTP MCP: configure \`url = "http://localhost:${port}/api/mcp"\`.
+- Stdio-only MCP clients: configure \`agent-inspector-mcp stdio --url http://localhost:${port}/api/mcp\`.
+
+Do not configure both transports in the same MCP client, or the client may show duplicate Inspector tools.
+
 Keep this setup local and explicit. Agent Inspector MCP tools can read captured requests and provider configuration, so only wire it into trusted local Codex environments.
 
 Agent Inspector starts in **Simple mode** by default. Keep Simple mode for everyday capture: requests, responses, tools, timing, and token usage stay available without retaining heavier raw headers, raw response, or detailed SSE chunk artifacts. Use **Full mode** only when the user is debugging provider headers, raw response payloads, or SSE stream details.
@@ -106,7 +113,7 @@ If the health check fails, show only the relevant error and ask whether to diagn
 
 Add an \`agent-inspector\` MCP server to \`~/.codex/config.toml\`. Preserve the user's existing config and merge the table instead of replacing the file.
 
-Recommended user-level config:
+Recommended user-level config for Codex builds that support Streamable HTTP MCP:
 
 \`\`\`toml
 [mcp_servers.agent-inspector]
@@ -115,6 +122,16 @@ startup_timeout_sec = 30
 tool_timeout_sec = 60
 \`\`\`
 
+Fallback config for a stdio-only MCP client:
+
+\`\`\`toml
+[mcp_servers.agent-inspector]
+command = "agent-inspector-mcp"
+args = ["stdio", "--url", "http://localhost:${port}/api/mcp"]
+\`\`\`
+
+The stdio command is only a bridge to the same HTTP MCP endpoint. It does not start a second Inspector server.
+
 If the user's Codex environment is managed by an admin allowlist, they may also need a matching identity rule in the managed requirements layer:
 
 \`\`\`toml
@@ -126,6 +143,7 @@ When editing:
 
 - Ask before changing \`~/.codex/config.toml\`.
 - Keep existing \`mcp_servers.*\`, \`projects.*\`, profiles, sandbox, approval, and model settings intact.
+- Remove any duplicate Inspector MCP entry that points to the same \`/api/mcp\` endpoint or runs the same \`agent-inspector-mcp stdio\` bridge under another name.
 - Do not write provider API keys into Codex config.
 - Do not expose Agent Inspector MCP beyond localhost.
 

package/src/components/providers/SettingsDialog.tsx

@@ -335,6 +335,16 @@ function OnboardingSettingsTab(): JSX.Element {
           <Check className="size-3.5 text-emerald-500" />
           <span>Captured sessions can produce reviewable memory candidates.</span>
         </div>
+        <div className="flex items-start gap-2">
+          <Check className="mt-0.5 size-3.5 text-emerald-500" />
+          <span>
+            Streamable HTTP clients should use the MCP URL directly. Stdio-only clients should use
+            <code className="mx-1 rounded bg-muted px-1 py-0.5 font-mono text-[11px] text-foreground">
+              agent-inspector-mcp stdio
+            </code>
+            instead. Configure only one entry for the same Inspector.
+          </span>
+        </div>
         <div className="flex items-start gap-2">
           <Check className="mt-0.5 size-3.5 text-emerald-500" />
           <span>

package/src/lib/groupContract.ts

@@ -143,8 +143,6 @@ export const InspectorGroupsListResponseSchema = z.object({
   groups: z.array(InspectorGroupSchema),
 });
 
-export type InspectorGroupStatus = z.infer<typeof InspectorGroupStatusSchema>;
-export type InspectorGroupKind = z.infer<typeof InspectorGroupKindSchema>;
 export type InspectorGroupEvidence = z.infer<typeof InspectorGroupEvidenceSchema>;
 export type InspectorGroupMember = z.infer<typeof InspectorGroupMemberSchema>;
 export type InspectorGroup = z.infer<typeof InspectorGroupSchema>;

package/src/lib/runContract.ts

@@ -146,10 +146,7 @@ export const RecentFailuresResponseSchema = z.object({
   limit: z.number().int().positive(),
 });
 
-export type InspectorRunStatus = z.infer<typeof InspectorRunStatusSchema>;
 export type InspectorRunEvidence = z.infer<typeof InspectorRunEvidenceSchema>;
-export type RunTimelineEventKind = z.infer<typeof RunTimelineEventKindSchema>;
-export type RunTimelineEventSeverity = z.infer<typeof RunTimelineEventSeveritySchema>;
 export type RunTimelineEvent = z.infer<typeof RunTimelineEventSchema>;
 export type FailureCategory = z.infer<typeof FailureCategorySchema>;
 export type FailureClassification = z.infer<typeof FailureClassificationSchema>;