@tonyclaw/agent-inspector 3.0.12 → 3.0.13

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-07T13:32:21.623Z",
     "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",
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/index-C57MERBU.js": {
+  "/assets/minimax-BPMzvuL-.jpeg": {
+    "type": "image/jpeg",
+    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
+    "mtime": "2026-07-07T13:32:21.623Z",
+    "size": 6918,
+    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
+  },
+  "/assets/json-viewer-DFpIPmLo.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": '"1ae6-eQryaLPILn5fqiMEolAa4MZPxNo"',
+    "mtime": "2026-07-07T13:32:21.623Z",
+    "size": 6886,
+    "path": "../public/assets/json-viewer-DFpIPmLo.js"
   },
-  "/assets/CompareDrawer-BxgmeTyv.js": {
+  "/assets/CompareDrawer-BRV9ztWd.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"4bc3-is5tqPQKWqhKSLXsHumbszv93wA"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "etag": '"4bc3-shyRzaaE6ahHgRB0IA707QrKsJI"',
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 19395,
-    "path": "../public/assets/CompareDrawer-BxgmeTyv.js"
+    "path": "../public/assets/CompareDrawer-BRV9ztWd.js"
   },
-  "/assets/json-viewer-DjRQ00mw.js": {
+  "/assets/index-CF3MPYb3.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"
+    "etag": '"74-F+FcKHiJpC8jrn7xWNQ0dVMtZlM"',
+    "mtime": "2026-07-07T13:32:21.623Z",
+    "size": 116,
+    "path": "../public/assets/index-CF3MPYb3.js"
   },
   "/assets/index-BIgsQvaF.css": {
     "type": "text/css; charset=utf-8",
     "etag": '"23c25-AyhoABstT65ludnAAzbIkqX0g+A"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 146469,
     "path": "../public/assets/index-BIgsQvaF.css"
   },
-  "/assets/index-CXcH69lm.js": {
+  "/assets/index-JgHKqbP1.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"1cd2c-AkEPKLC2Pdi2HdDYJtsfe//U2Xc"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "etag": '"1cd2c-0imryeYo69ow52gECBS18OO26Fo"',
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 118060,
-    "path": "../public/assets/index-CXcH69lm.js"
-  },
-  "/assets/minimax-BPMzvuL-.jpeg": {
-    "type": "image/jpeg",
-    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-07-07T12:05:50.812Z",
-    "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"
+    "path": "../public/assets/index-JgHKqbP1.js"
   },
-  "/assets/main-CkKubKth.js": {
+  "/assets/main-YvdO47OP.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"512fd-byS36ehXW6dq9HoTFkcvTxk1K1M"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "etag": '"512fd-gCPoQjeotNyQelNGqTchNTZoHkg"',
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 332541,
-    "path": "../public/assets/main-CkKubKth.js"
+    "path": "../public/assets/main-YvdO47OP.js"
   },
-  "/assets/RequestAnatomy-CpqHIkD1.js": {
+  "/assets/RequestAnatomy-ybH1l2Bp.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"43f2-StkDnFArsCZwt+qgZegXnv+PKZs"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "etag": '"43f2-pMwDNmrfJMk8cJ3DWaGnXdho66c"',
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 17394,
-    "path": "../public/assets/RequestAnatomy-CpqHIkD1.js"
+    "path": "../public/assets/RequestAnatomy-ybH1l2Bp.js"
   },
-  "/assets/StreamingChunkSequence-CcNvFNPp.js": {
+  "/assets/ReplayDialog-B4b6aD0q.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"
-  },
-  "/assets/_sessionId-D5z6C77f.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"36c-vSt7tJ0oCwR+jhLkE51BDj2yxgA"',
-    "mtime": "2026-07-07T12:05:50.813Z",
-    "size": 876,
-    "path": "../public/assets/_sessionId-D5z6C77f.js"
-  },
-  "/assets/ResponseView-BvhBiQ5k.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": '"3347-eBE7gzon2VtfM/je14kPEkGAXhI"',
+    "mtime": "2026-07-07T13:32:21.623Z",
+    "size": 13127,
+    "path": "../public/assets/ReplayDialog-B4b6aD0q.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
+  "/assets/ResponseView-DpPKgH-Y.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"47fc-Gknuf/I3Y4XU6BdbGTL5q+Ru5Lc"',
+    "mtime": "2026-07-07T13:32:21.623Z",
+    "size": 18428,
+    "path": "../public/assets/ResponseView-DpPKgH-Y.js"
+  },
+  "/assets/StreamingChunkSequence-9f_rtMzz.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"e95-ez6Uni8ODVEO4MODGxVp1hZegy0"',
+    "mtime": "2026-07-07T13:32:21.623Z",
+    "size": 3733,
+    "path": "../public/assets/StreamingChunkSequence-9f_rtMzz.js"
+  },
+  "/assets/_sessionId-gEmO-b2f.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"36c-gFZKiSoJBGbocCBmbrDp333No/U"',
+    "mtime": "2026-07-07T13:32:21.623Z",
+    "size": 876,
+    "path": "../public/assets/_sessionId-gEmO-b2f.js"
+  },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "mtime": "2026-07-07T13:32:21.623Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/ProxyViewerContainer-CchT6T-4.js": {
+  "/assets/ProxyViewerContainer-BVsv8OFb.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"b658d-AkoAKD2VyL1sxEAIYFjHKCh9724"',
-    "mtime": "2026-07-07T12:05:50.813Z",
+    "etag": '"b658d-WdVyevGJ8M3fvq9yKI0lrgCd700"',
+    "mtime": "2026-07-07T13:32:21.625Z",
     "size": 746893,
-    "path": "../public/assets/ProxyViewerContainer-CchT6T-4.js"
+    "path": "../public/assets/ProxyViewerContainer-BVsv8OFb.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:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/agent-inspector",
-  "version": "3.0.12",
+  "version": "3.0.13",
   "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`);

package/.output/public/assets/index-C57MERBU.js

@@ -1 +0,0 @@
-import{P as o}from"./ProxyViewerContainer-CchT6T-4.js";import"./main-CkKubKth.js";const r=o;export{r as component};