@tonyclaw/agent-inspector 3.0.12 → 3.0.14

package/.output/server/_tanstack-start-manifest_v-Dk2HfOoe.mjs

@@ -0,0 +1,4 @@
+const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/__root.tsx", "children": ["/", "/api/alerts", "/api/config", "/api/groups", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/runs", "/api/sessions", "/proxy/$", "/session/$sessionId", "/api/ecosystem/packages", "/api/ecosystem/tasks", "/api/knowledge/candidates", "/api/knowledge/project-context", "/api/knowledge/search", "/api/ecosystem/recipes/$recipeId/run", "/api/knowledge/sessions/$sessionId/candidates"], "preloads": ["/assets/main-BfN4culo.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-49RC4dlD.js", "/assets/ProxyViewerContainer-CbNsaoQw.js"] }, "/api/alerts": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/alerts.ts", "children": ["/api/alerts/summary"] }, "/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/import", "/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-BnMB0zab.js", "/assets/ProxyViewerContainer-CbNsaoQw.js"] }, "/api/alerts/summary": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/alerts.summary.ts" }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.paths.ts" }, "/api/ecosystem/packages": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.packages.ts", "children": ["/api/ecosystem/packages/$packageId/help", "/api/ecosystem/packages/$packageId/install", "/api/ecosystem/packages/$packageId/runner-presets", "/api/ecosystem/packages/$packageId/upgrade"] }, "/api/ecosystem/tasks": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.tasks.ts", "children": ["/api/ecosystem/tasks/$taskId"] }, "/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/body", "/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/import": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.import.ts" }, "/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/ecosystem/tasks/$taskId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.tasks.$taskId.ts" }, "/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/body": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.body.ts" }, "/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/ecosystem/packages/$packageId/help": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.packages.$packageId.help.ts" }, "/api/ecosystem/packages/$packageId/install": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.packages.$packageId.install.ts" }, "/api/ecosystem/packages/$packageId/runner-presets": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.packages.$packageId.runner-presets.ts" }, "/api/ecosystem/packages/$packageId/upgrade": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.packages.$packageId.upgrade.ts" }, "/api/ecosystem/recipes/$recipeId/run": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/ecosystem.recipes.$recipeId.run.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-BfN4culo.js" });
+export {
+  tsrStartManifest
+};

package/.output/server/index.mjs

@@ -38,121 +38,121 @@ const assets = {
   "/assets/agent-inspector-58K1_MsC.ico": {
     "type": "image/vnd.microsoft.icon",
     "etag": '"38fa-ZD8kPABHYjPIkcH82FMY6iZM7fI"',
-    "mtime": "2026-07-07T12:05:50.812Z",
+    "mtime": "2026-07-08T01:38:53.683Z",
     "size": 14586,
     "path": "../public/assets/agent-inspector-58K1_MsC.ico"
   },
-  "/assets/alibaba-TTwafVwX.svg": {
-    "type": "image/svg+xml",
-    "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-07-07T12:05:50.812Z",
-    "size": 5915,
-    "path": "../public/assets/alibaba-TTwafVwX.svg"
-  },
-  "/assets/index-C57MERBU.js": {
+  "/assets/index-BbtAIxbg.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"74-qCOkCauMn0Kq1zsDqIpnFZ0QZ/4"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 116,
-    "path": "../public/assets/index-C57MERBU.js"
+    "etag": '"1cd2c-9sotzEOJt7YobaV9zbPeMBhUgKQ"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 118060,
+    "path": "../public/assets/index-BbtAIxbg.js"
   },
-  "/assets/CompareDrawer-BxgmeTyv.js": {
+  "/assets/CompareDrawer-DDfwHQUi.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"4bc3-is5tqPQKWqhKSLXsHumbszv93wA"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "etag": '"4bc3-V5X3VhcIpOcGi/B6cXBW6SUb4h4"',
+    "mtime": "2026-07-08T01:38:53.685Z",
     "size": 19395,
-    "path": "../public/assets/CompareDrawer-BxgmeTyv.js"
+    "path": "../public/assets/CompareDrawer-DDfwHQUi.js"
   },
-  "/assets/json-viewer-DjRQ00mw.js": {
+  "/assets/index-49RC4dlD.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"1ae6-2DrfvJk7R1yiImvRe/hUgT5pWtM"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 6886,
-    "path": "../public/assets/json-viewer-DjRQ00mw.js"
-  },
-  "/assets/index-BIgsQvaF.css": {
-    "type": "text/css; charset=utf-8",
-    "etag": '"23c25-AyhoABstT65ludnAAzbIkqX0g+A"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 146469,
-    "path": "../public/assets/index-BIgsQvaF.css"
+    "etag": '"74-GlRn93aSVOHR0mfj+RCxQ60Mu3o"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 116,
+    "path": "../public/assets/index-49RC4dlD.js"
   },
-  "/assets/index-CXcH69lm.js": {
+  "/assets/json-viewer-C838cVmD.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"1cd2c-AkEPKLC2Pdi2HdDYJtsfe//U2Xc"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 118060,
-    "path": "../public/assets/index-CXcH69lm.js"
+    "etag": '"1ae6-quOA6edv0/Es47habtmdRT7jfNc"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 6886,
+    "path": "../public/assets/json-viewer-C838cVmD.js"
   },
   "/assets/minimax-BPMzvuL-.jpeg": {
     "type": "image/jpeg",
     "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-07-07T12:05:50.812Z",
+    "mtime": "2026-07-08T01:38:53.683Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/ReplayDialog-CMHVUtVB.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"3347-httGBIkl8o9TWRveRd5+mBu5ZJE"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 13127,
-    "path": "../public/assets/ReplayDialog-CMHVUtVB.js"
+  "/assets/alibaba-TTwafVwX.svg": {
+    "type": "image/svg+xml",
+    "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
+    "mtime": "2026-07-08T01:38:53.683Z",
+    "size": 5915,
+    "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/main-CkKubKth.js": {
+  "/assets/ReplayDialog-D-26DMBt.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"512fd-byS36ehXW6dq9HoTFkcvTxk1K1M"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 332541,
-    "path": "../public/assets/main-CkKubKth.js"
+    "etag": '"3347-aZE+Q0LWYe8L0W8182RYkrLiGmQ"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 13127,
+    "path": "../public/assets/ReplayDialog-D-26DMBt.js"
   },
-  "/assets/RequestAnatomy-CpqHIkD1.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"43f2-StkDnFArsCZwt+qgZegXnv+PKZs"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 17394,
-    "path": "../public/assets/RequestAnatomy-CpqHIkD1.js"
+  "/assets/index-DXKupW0r.css": {
+    "type": "text/css; charset=utf-8",
+    "etag": '"23dd5-TDREYsXzXS8z4xFgQFr1UWJvDXE"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 146901,
+    "path": "../public/assets/index-DXKupW0r.css"
   },
-  "/assets/StreamingChunkSequence-CcNvFNPp.js": {
+  "/assets/main-BfN4culo.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"e95-7Xm6a18crTzmPL0R4R6mCtx7R10"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 3733,
-    "path": "../public/assets/StreamingChunkSequence-CcNvFNPp.js"
+    "etag": '"512fd-Lx/1rDXGJqcCtEnfodu55luhvMs"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 332541,
+    "path": "../public/assets/main-BfN4culo.js"
   },
-  "/assets/_sessionId-D5z6C77f.js": {
+  "/assets/_sessionId-BnMB0zab.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"36c-vSt7tJ0oCwR+jhLkE51BDj2yxgA"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "etag": '"36c-vmwadBttRO2Tr8uyzA9ILlXMGRg"',
+    "mtime": "2026-07-08T01:38:53.685Z",
     "size": 876,
-    "path": "../public/assets/_sessionId-D5z6C77f.js"
+    "path": "../public/assets/_sessionId-BnMB0zab.js"
   },
-  "/assets/ResponseView-BvhBiQ5k.js": {
+  "/assets/RequestAnatomy-B6zNFqNX.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"47fc-q737C36wyDb/lEJV2Wh3irlNMRk"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 18428,
-    "path": "../public/assets/ResponseView-BvhBiQ5k.js"
+    "etag": '"43f2-FB7RmmcasRWbq5XlMj8Lfh/HgFQ"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 17394,
+    "path": "../public/assets/RequestAnatomy-B6zNFqNX.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "mtime": "2026-07-08T01:38:53.683Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
+  "/assets/StreamingChunkSequence-yIiscGuE.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"e95-KIXlCdHgHnZGrDZTGIAMwgHzmp0"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 3733,
+    "path": "../public/assets/StreamingChunkSequence-yIiscGuE.js"
+  },
+  "/assets/ResponseView-Ccy95rWI.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"47fc-yKb5jKw9a0d9bY9FAp9fSDXbR5U"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 18428,
+    "path": "../public/assets/ResponseView-Ccy95rWI.js"
+  },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "mtime": "2026-07-08T01:38:53.685Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/ProxyViewerContainer-CchT6T-4.js": {
+  "/assets/ProxyViewerContainer-CbNsaoQw.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"b658d-AkoAKD2VyL1sxEAIYFjHKCh9724"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 746893,
-    "path": "../public/assets/ProxyViewerContainer-CchT6T-4.js"
+    "etag": '"b78b9-I8pfWqThohzWE1l5xMxqDA+96Pw"',
+    "mtime": "2026-07-08T01:38:53.685Z",
+    "size": 751801,
+    "path": "../public/assets/ProxyViewerContainer-CbNsaoQw.js"
   }
 };
 function readAsset(id) {

package/README.md

@@ -130,15 +130,14 @@ The web UI runs at http://localhost:9527. The public proxy endpoint is also
 `http://localhost:9527/proxy`; internally Agent Inspector may run the app on a private helper port,
 but AI tools should use the public URL printed by the CLI.
 
-For v3 compatibility, the packaged CLI also keeps `http://localhost:25947` open as a legacy alias
-when it starts on the default port. Existing AI tool and MCP configs that still point at `25947`
-continue to work for now, but new configs should use `9527`.
+The legacy `http://localhost:25947` port is closed by default. If you need a temporary alias for
+older AI tool or MCP configs, start with `agent-inspector --legacy-port`.
 
 ## v3.0 Port Migration
 
-Agent Inspector v3.0 changes the default public port from `25947` to `9527`. The packaged CLI keeps
-`25947` as a legacy alias when you run the default `agent-inspector` command, so existing AI coding
-tool and MCP configs do not need to be edited immediately.
+Agent Inspector v3.0 changes the default public port from `25947` to `9527`. The packaged CLI now
+opens only `9527` by default. Existing AI coding tool and MCP configs that still point at `25947`
+should be moved to `9527`, or you can temporarily start with `agent-inspector --legacy-port`.
 
 Use these endpoints for new configs:
 
@@ -147,7 +146,7 @@ Use these endpoints for new configs:
 - OpenAI-compatible `/v1` proxy: `http://localhost:9527/proxy/v1`
 - MCP: `http://localhost:9527/api/mcp`
 
-If you intentionally want only the new port, start with `agent-inspector --no-legacy-port`.
+If you intentionally need the old compatibility port, start with `agent-inspector --legacy-port`.
 
 For Codex-style OpenAI Responses clients, configure the proxy as an OpenAI-compatible `/v1` base:
 
@@ -267,8 +266,8 @@ configure `http://localhost:9527/api/mcp` directly. If it only supports stdio, c
 `agent-inspector-mcp stdio`; that command is only a bridge to `/api/mcp`, not a second Inspector
 server.
 
-Legacy MCP configs that still use `http://localhost:25947/api/mcp` are accepted by the default v3
-CLI alias during the compatibility window.
+Legacy MCP configs that still use `http://localhost:25947/api/mcp` require starting the CLI with
+`agent-inspector --legacy-port`; new configs should use `http://localhost:9527/api/mcp`.
 
 Coding agents can use the MCP surface in three ways:
 
@@ -358,6 +357,30 @@ Built-in prompt templates help turn captured evidence into user-facing output:
 - `inspector_generate_group_report`: produce a provider/model evaluation report for a group.
 - `inspector_extract_repro_steps`: extract concise reproduction steps from a session.
 
+## TonyClaw Lab Ecosystem
+
+TonyClaw Lab turns Inspector into a local control panel for the TonyClaw npm ecosystem. The UI shows
+installed and latest package status for `@tonyclaw/agent-inspector`,
+`@tonyclaw/agent-inspector-mcp`, and `@tonyclaw/eval-harness`; it can launch install, upgrade,
+help, preset discovery, and safe smoke-test recipes without leaving Inspector.
+
+The Lab also exposes copy-ready recipes that connect Inspector evidence, MCP checks, and evaluation
+runners:
+
+```bash
+npx @tonyclaw/eval-harness check-inspector-mcp
+npx @tonyclaw/eval-harness inspector-smoke --title "TonyClaw Lab smoke" --latest-log-limit 5
+npx @tonyclaw/eval-harness runner-presets --format json
+npx @tonyclaw/eval-harness run-once --smoke --project-source <project> --work-source <work> --count 1 --parallel 1
+```
+
+Use these recipes as stable starting points for CI smoke tests, local provider checks, and
+multi-run evaluation batches. Inspector remains the evidence surface; eval-harness drives repeatable
+workloads; the MCP package bridges coding agents that prefer stdio.
+
+Recipes without placeholders can be run directly from TonyClaw Lab. Template recipes remain
+copy-ready so users can fill project and work directories explicitly before running them.
+
 ## Jenkins And GitCode
 
 Team CI, GitCode WebHook setup, Cloudflare Tunnel notes, local push fallback, and the verified PR workflow live in [Jenkins + GitCode WebHook](docs/JENKINS_GITCODE_WEBHOOK_TUNNEL.md). Keep real Jenkins notify tokens, GitCode access tokens, and tunnel URLs out of the repository.

package/package.json

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

package/src/cli.ts

@@ -24,10 +24,10 @@ import { findPidsByPort, killPid, openUrlCommand } from "./proxy/platformCommand
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// v3 defaults the public entrypoint to 9527 while keeping 25947 as a
-// compatibility alias for older AI-tool and MCP configs. The TanStack Start
-// runtime stays on a private upstream port and both public ports reverse-proxy
-// to that same runtime, so logs, sessions, and MCP state remain unified.
+// v3 defaults the public entrypoint to 9527. The legacy 25947 alias can be
+// enabled explicitly for older AI-tool and MCP configs. The TanStack Start
+// runtime stays on a private upstream port and public ports reverse-proxy to
+// that same runtime, so logs, sessions, and MCP state remain unified.
 const DEFAULT_PORT = 9527;
 const LEGACY_ALIAS_PORT = 25947;
 const DEFAULT_UPSTREAM_PORT = 9529;
@@ -231,12 +231,42 @@ function printAccessHints(port: number, host?: string): void {
   }
 }
 
+type BackgroundSupervisorOptions = {
+  port: number;
+  host: string | undefined;
+  configDir: string | undefined;
+  providersJson: string | undefined;
+  captureMode: CaptureMode;
+  enableIdentityProxy: boolean;
+  legacyAliasEnabled: boolean;
+};
+
+function buildBackgroundSupervisorArgs(options: BackgroundSupervisorOptions): string[] {
+  const args = ["--no-open", "--port", String(options.port), "--mode", options.captureMode];
+  if (options.host !== undefined) {
+    args.push("--host", options.host);
+  }
+  if (options.configDir !== undefined) {
+    args.push("--config-dir", options.configDir);
+  }
+  if (options.providersJson !== undefined) {
+    args.push("--providers", options.providersJson);
+  }
+  if (!options.enableIdentityProxy) {
+    args.push("--no-identity-proxy");
+  }
+  if (options.legacyAliasEnabled) {
+    args.push("--legacy-port");
+  }
+  return args;
+}
+
 function pickUpstreamPort(publicPort: number, legacyAliasPort: number | null): number {
-  const candidates = [
-    DEFAULT_UPSTREAM_PORT,
-    publicPort + 2 <= 65535 ? publicPort + 2 : publicPort - 2,
-    LEGACY_ALIAS_PORT + 2,
-  ];
+  const nearbyPort = publicPort + 2 <= 65535 ? publicPort + 2 : publicPort - 2;
+  const candidates =
+    publicPort === DEFAULT_PORT
+      ? [DEFAULT_UPSTREAM_PORT, nearbyPort, LEGACY_ALIAS_PORT + 2]
+      : [nearbyPort, DEFAULT_UPSTREAM_PORT, LEGACY_ALIAS_PORT + 2];
   for (const candidate of candidates) {
     if (
       Number.isInteger(candidate) &&
@@ -294,10 +324,10 @@ async function runStart(args: string[]): Promise<void> {
   let forceRestart = false;
   let configDir: string | undefined;
   let providersJson: string | undefined;
-  let captureMode = DEFAULT_CAPTURE_MODE;
+  let captureMode: CaptureMode = DEFAULT_CAPTURE_MODE;
   let captureModeWasSpecified = false;
   let enableIdentityProxy = true;
-  let legacyAliasEnabled = true;
+  let legacyAliasEnabled = false;
 
   if (envMode !== undefined && envMode !== "") {
     const parsedMode = parseCaptureMode(envMode);
@@ -413,6 +443,9 @@ async function runStart(args: string[]): Promise<void> {
       case "--no-legacy-port":
         legacyAliasEnabled = false;
         break;
+      case "--legacy-port":
+        legacyAliasEnabled = true;
+        break;
       default:
         break;
     }
@@ -482,6 +515,57 @@ async function runStart(args: string[]): Promise<void> {
     }
   }
 
+  if (background && enableIdentityProxy) {
+    const cliEntry = process.argv[1];
+    if (cliEntry === undefined || cliEntry.length === 0) {
+      console.error("Cannot resolve agent-inspector CLI entry for background supervisor.");
+      process.exitCode = 1;
+      return;
+    }
+
+    const supervisorArgs = buildBackgroundSupervisorArgs({
+      port,
+      host,
+      configDir,
+      providersJson,
+      captureMode,
+      enableIdentityProxy,
+      legacyAliasEnabled,
+    });
+    const supervisorProcess = spawn(process.execPath, [cliEntry, ...supervisorArgs], {
+      stdio: "ignore",
+      detached: true,
+      env: process.env,
+      windowsHide: true,
+    });
+    supervisorProcess.once("error", (err) => {
+      console.error(`Failed to start Agent Inspector background supervisor: ${err.message}`);
+    });
+    supervisorProcess.unref();
+
+    if (await waitForInspectorHealthy(port, 10000, host)) {
+      console.log(`agent-inspector background server is ready at ${url}`);
+      printAccessHints(port, host);
+      if (legacyAliasPort !== null) {
+        console.log(`   Legacy proxy:  http://localhost:${legacyAliasPort}/proxy`);
+        console.log(`   Legacy MCP:    http://localhost:${legacyAliasPort}/api/mcp`);
+      }
+      console.log(``);
+      console.log(`Route AI coding tools through the identity proxy for accurate PID attribution:`);
+      console.log(`   Claude Code:  ANTHROPIC_BASE_URL=http://localhost:${port}/proxy claude`);
+      console.log(`   OpenCode:     LLM_BASE_URL=http://localhost:${port}/proxy opencode`);
+      console.log(`   MiMo Code:    OPENAI_BASE_URL=http://localhost:${port}/proxy mimo`);
+      if (open && openWasSpecified) {
+        openBrowser(url);
+      }
+      return;
+    }
+
+    console.error(`agent-inspector background server did not become ready at ${url}.`);
+    process.exitCode = 1;
+    return;
+  }
+
   console.log(`Server running at ${url}`);
   console.log(`   Capture mode: ${captureMode}`);
   console.log(`   Proxy: ${url}/proxy`);