@tonyclaw/agent-inspector 2.0.0 → 2.0.2

package/.output/server/index.mjs

@@ -35,110 +35,110 @@ const headers = ((m) => function headersRouteRule(event) {
   }
 });
 const assets = {
-  "/assets/index-CpWG2hFn.css": {
-    "type": "text/css; charset=utf-8",
-    "etag": '"17063-Htyi07AI/KjwlBt4Ff8s9XjH2HE"',
-    "mtime": "2026-06-20T02:55:38.781Z",
-    "size": 94307,
-    "path": "../public/assets/index-CpWG2hFn.css"
-  },
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-06-20T02:55:38.781Z",
+    "mtime": "2026-06-20T06:54:35.499Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/CompareDrawer-CU5ZrWcL.js": {
+  "/assets/CompareDrawer-Bp7_x-5N.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"4a1f-2+GLPzWQ3B1UYxv4W/gqYK0eSOU"',
-    "mtime": "2026-06-20T02:55:38.781Z",
+    "etag": '"4a1f-jydruemAUSMwVzObceAGMUJLrQ8"',
+    "mtime": "2026-06-20T06:54:35.500Z",
     "size": 18975,
-    "path": "../public/assets/CompareDrawer-CU5ZrWcL.js"
-  },
-  "/assets/index-DmBV8Gve.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"74-qEIMUWLZsbtdjOyCF+RCeAPprrM"',
-    "mtime": "2026-06-20T02:55:38.781Z",
-    "size": 116,
-    "path": "../public/assets/index-DmBV8Gve.js"
-  },
-  "/assets/json-viewer-CZVYLR8j.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"1e651-7jTmLGqQOxmz6Dr/v8g0WGWFYFs"',
-    "mtime": "2026-06-20T02:55:38.782Z",
-    "size": 124497,
-    "path": "../public/assets/json-viewer-CZVYLR8j.js"
+    "path": "../public/assets/CompareDrawer-Bp7_x-5N.js"
   },
   "/assets/minimax-BPMzvuL-.jpeg": {
     "type": "image/jpeg",
     "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-06-20T02:55:38.780Z",
+    "mtime": "2026-06-20T06:54:35.499Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/ReplayDialog-F58yNg5j.js": {
+  "/assets/json-viewer-6uV_YXws.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"11c0-8Zbj22ehxBS4KCLYYzCxCc1sKvk"',
-    "mtime": "2026-06-20T02:55:38.781Z",
-    "size": 4544,
-    "path": "../public/assets/ReplayDialog-F58yNg5j.js"
+    "etag": '"1e651-ErvitreVwBoWFEPdSIq0EqZIuw4"',
+    "mtime": "2026-06-20T06:54:35.501Z",
+    "size": 124497,
+    "path": "../public/assets/json-viewer-6uV_YXws.js"
   },
-  "/assets/ResponseView-DHJq6bnz.js": {
+  "/assets/index-CIL46Z2y.css": {
+    "type": "text/css; charset=utf-8",
+    "etag": '"17078-OCA3ki0c0CZu1AhDXwlliM+a+qY"',
+    "mtime": "2026-06-20T06:54:35.499Z",
+    "size": 94328,
+    "path": "../public/assets/index-CIL46Z2y.css"
+  },
+  "/assets/index-BGGOWR7A.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"6e91-uW599LXwIPf73coL604vJSPPXA0"',
-    "mtime": "2026-06-20T02:55:38.781Z",
-    "size": 28305,
-    "path": "../public/assets/ResponseView-DHJq6bnz.js"
+    "etag": '"74-JGabHf17Kno+3wF7wJwm2nHkVhg"',
+    "mtime": "2026-06-20T06:54:35.500Z",
+    "size": 116,
+    "path": "../public/assets/index-BGGOWR7A.js"
   },
-  "/assets/StreamingChunkSequence-BTgfpFUT.js": {
+  "/assets/StreamingChunkSequence-Bjs4Lqwn.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d81-XA4ODao35Eyi0DlKnKkQbJMOQb8"',
-    "mtime": "2026-06-20T02:55:38.781Z",
+    "etag": '"d81-yAIItbapwm0q/MbLRpCH915YVMc"',
+    "mtime": "2026-06-20T06:54:35.501Z",
     "size": 3457,
-    "path": "../public/assets/StreamingChunkSequence-BTgfpFUT.js"
+    "path": "../public/assets/StreamingChunkSequence-Bjs4Lqwn.js"
+  },
+  "/assets/RequestAnatomy-ehyrskxt.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"142a-KSCjJNt2RlqmIm3y55z67ygsWGU"',
+    "mtime": "2026-06-20T06:54:35.500Z",
+    "size": 5162,
+    "path": "../public/assets/RequestAnatomy-ehyrskxt.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-06-20T02:55:38.780Z",
+    "mtime": "2026-06-20T06:54:35.499Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/_sessionId-DsNRbnNm.js": {
+  "/assets/main-FSGUGtEL.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"5138c-aZy2XlKYAw/+FTrgYI1Iz4MHtww"',
+    "mtime": "2026-06-20T06:54:35.500Z",
+    "size": 332684,
+    "path": "../public/assets/main-FSGUGtEL.js"
+  },
+  "/assets/ProxyViewerContainer-USuxPy-K.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"774b9-fxnez8ICkM1Nb7unXdv1GIz+RbA"',
+    "mtime": "2026-06-20T06:54:35.500Z",
+    "size": 488633,
+    "path": "../public/assets/ProxyViewerContainer-USuxPy-K.js"
+  },
+  "/assets/_sessionId-D_SeK_qp.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-Vs3mLOLEEMGbWP4z/lTPbOn+dc8"',
-    "mtime": "2026-06-20T02:55:38.781Z",
+    "etag": '"d2-pqW14/f9UjxfuYAzRgQmGaiZhbs"',
+    "mtime": "2026-06-20T06:54:35.500Z",
     "size": 210,
-    "path": "../public/assets/_sessionId-DsNRbnNm.js"
+    "path": "../public/assets/_sessionId-D_SeK_qp.js"
   },
-  "/assets/main-DHs7FBK3.js": {
+  "/assets/ResponseView-BNGyc8e_.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"5138c-gGyEqSNc9hLficzzEorSKjc0F5g"',
-    "mtime": "2026-06-20T02:55:38.781Z",
-    "size": 332684,
-    "path": "../public/assets/main-DHs7FBK3.js"
+    "etag": '"6e91-De46gQnfLBYdkbMBsXcKinAu7mE"',
+    "mtime": "2026-06-20T06:54:35.501Z",
+    "size": 28305,
+    "path": "../public/assets/ResponseView-BNGyc8e_.js"
   },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-06-20T02:55:38.780Z",
+    "mtime": "2026-06-20T06:54:35.500Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/ProxyViewerContainer-pEBqVp1d.js": {
+  "/assets/ReplayDialog-DFHCd0yx.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"77564-L+1r+UlLMkAVNcYyFyWyJee23a8"',
-    "mtime": "2026-06-20T02:55:38.781Z",
-    "size": 488804,
-    "path": "../public/assets/ProxyViewerContainer-pEBqVp1d.js"
-  },
-  "/assets/RequestAnatomy-C9lT0qE_.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"142a-8sxBo7MxYcnRgyDlw3XsNdl0s3M"',
-    "mtime": "2026-06-20T02:55:38.781Z",
-    "size": 5162,
-    "path": "../public/assets/RequestAnatomy-C9lT0qE_.js"
+    "etag": '"11c0-ZB9rU8oZnq77GG7kiCz6W03GjPI"',
+    "mtime": "2026-06-20T06:54:35.500Z",
+    "size": 4544,
+    "path": "../public/assets/ReplayDialog-DFHCd0yx.js"
   }
 };
 function readAsset(id) {

package/README.md

@@ -22,12 +22,37 @@ npm install -g @tonyclaw/agent-inspector
 agent-inspector
 ```
 
+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
+project icon. The executable also carries standard `FileVersion` and
+`ProductVersion` metadata for the installed package version. If npm lifecycle
+scripts are disabled, Agent Inspector falls back to `node.exe` and keeps
+working normally.
+
+For Linux containers, the Windows runtime setup is a no-op. To keep images lean,
+install with optional dependencies omitted:
+
+```bash
+npm install -g --omit=optional @tonyclaw/agent-inspector
+```
+
 Optional guided setup:
 
 ```bash
 agent-inspector onboard
 ```
 
+The onboarding command installs guided setup skills for local agents:
+
+- Claude Code: `~/.claude/skills/agent-inspector-onboard/SKILL.md` plus a slash command.
+- Codex: `~/.codex/skills/agent-inspector-onboard/SKILL.md`, focused on connecting
+  `http://localhost:25947/api/mcp` through Codex `mcp_servers.agent-inspector`.
+
+During npm global install, Agent Inspector also makes a best-effort Codex skill install when
+`~/.codex` already exists. Set `AGENT_INSPECTOR_SKIP_CODEX_SKILL=1` to skip that postinstall step,
+or run `agent-inspector onboard --codex-only --force` later to refresh it.
+
 For local development from source:
 
 ```bash
@@ -45,8 +70,36 @@ The web UI runs at http://localhost:25947.
 
 ## Project Direction
 
-Agent Inspector should stay close to the proven inspector codebase while growing into an agent knowledge layer. The core product direction has three layers:
+Agent Inspector should stay close to the proven inspector codebase while growing into an agent knowledge layer. The memory flow has four layers:
+
+1. Raw Trace: capture requests, responses, streaming chunks, tools, errors, and token usage.
+2. Episode: summarize a session into goal, steps, outcome, failures, and artifacts.
+3. Memory Candidate: create reviewable, redacted knowledge candidates with evidence ids.
+4. OpenClaw Memory: write approved candidates into OpenClaw's durable recall system.
+
+Agent Inspector owns the first three layers. OpenClaw owns indexing, retrieval, consolidation, and long-term recall.
+
+## OpenClaw Memory Bridge
+
+Agent Inspector treats OpenClaw as a hidden memory backend. The preferred integration uses OpenClaw's file-backed memory layout:
+
+```bash
+OPENCLAW_WORKSPACE_DIR=C:\Users\<you>\.openclaw\workspace
+OPENCLAW_GATEWAY_URL=http://127.0.0.1:18789
+OPENCLAW_GATEWAY_TOKEN=<gateway-token>
+OPENCLAW_SESSION_KEY=main
+```
+
+When a candidate is promoted, Agent Inspector writes sanitized Markdown under:
+
+```text
+memory/agent-inspector/YYYY-MM-DD/<candidate>.md
+```
+
+OpenClaw remains responsible for indexing and recall. Run `openclaw memory index --force` when you
+need immediate reindexing, or rely on the running OpenClaw memory runtime to sync according to its
+own policy.
+
+Search stays behind the Inspector facade. Agents call Inspector MCP/API tools, and Inspector invokes OpenClaw Gateway `memory_search` when `OPENCLAW_GATEWAY_URL` is configured.
 
-1. Observe: normalize agent and model traffic into stable interaction events.
-2. Analyze: identify reusable facts, decisions, tool patterns, failures, and user preferences.
-3. Remember: publish curated memory candidates into an external memory system while keeping user control and auditability.
+For older deployments, `OPENCLAW_MEMORY_URL` / `OPENCLAW_API_URL` remain supported as a legacy HTTP backend.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/agent-inspector",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "type": "module",
   "description": "Agent observability and knowledge capture layer for AI coding tools.",
   "license": "MIT",
@@ -37,14 +37,18 @@
     "!src/**/*.stories.tsx",
     "!src/**/__fixtures__",
     "!src/routeTree.gen.ts",
+    "scripts/setup-windows-runtime.mjs",
+    "scripts/setup-codex-skill.mjs",
     "styles",
-    ".output"
+    ".output",
+    "!.output/*.exe"
   ],
   "scripts": {
     "dev": "vite dev",
     "start": "node .output/cli.js",
     "build": "vite build && bun build:cli",
     "build:cli": "npx esbuild src/cli.ts --bundle --platform=node --target=node18 --format=esm --outfile=.output/cli.js",
+    "postinstall": "node scripts/setup-windows-runtime.mjs && node scripts/setup-codex-skill.mjs",
     "prepublishOnly": "npm run build",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
@@ -81,6 +85,9 @@
     "tw-animate-css": "^1.4.0",
     "zod": "^4.3.6"
   },
+  "optionalDependencies": {
+    "rcedit": "4.0.1"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.3.14",
     "@cfworker/json-schema": "^4.1.1",

package/scripts/setup-codex-skill.mjs

@@ -0,0 +1,38 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const packageRoot = dirname(scriptDir);
+const cliEntry = join(packageRoot, ".output", "cli.js");
+const codexHome = process.env["CODEX_HOME"] ?? join(homedir(), ".codex");
+
+function shouldSkip() {
+  return (
+    process.env["AGENT_INSPECTOR_SKIP_CODEX_SKILL"] === "1" ||
+    !existsSync(cliEntry) ||
+    (!existsSync(codexHome) && process.env["AGENT_INSPECTOR_INSTALL_CODEX_SKILL"] !== "1")
+  );
+}
+
+function main() {
+  if (shouldSkip()) return;
+
+  const result = spawnSync(process.execPath, [cliEntry, "onboard", "--codex-only"], {
+    stdio: "ignore",
+    windowsHide: true,
+  });
+
+  if (result.status !== 0) {
+    console.warn("Skipping Codex onboard skill installation.");
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.warn(`Skipping Codex onboard skill installation: ${message}`);
+}

package/scripts/setup-windows-runtime.mjs

@@ -0,0 +1,74 @@
+import { copyFile, mkdir, readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const packageRoot = dirname(scriptDir);
+const outputDir = join(packageRoot, ".output");
+const serverEntry = join(outputDir, "server", "index.mjs");
+const brandedRuntime = join(outputDir, "agent-inspector.exe");
+const iconPath = join(packageRoot, "src", "assets", "agent-inspector.ico");
+
+function normalizeWindowsVersion(version) {
+  const numericParts = version
+    .split(".")
+    .map((part) => Number.parseInt(part.replace(/\D.*$/, ""), 10))
+    .filter((part) => Number.isInteger(part) && part >= 0);
+  return [...numericParts, 0, 0, 0, 0].slice(0, 4).join(".");
+}
+
+async function readPackageVersion() {
+  const packageJson = JSON.parse(await readFile(join(packageRoot, "package.json"), "utf8"));
+  return typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
+}
+
+function shouldSkip() {
+  return (
+    process.platform !== "win32" ||
+    process.env["AGENT_INSPECTOR_SKIP_WINDOWS_RUNTIME"] === "1" ||
+    !existsSync(serverEntry) ||
+    !existsSync(iconPath) ||
+    !existsSync(process.execPath)
+  );
+}
+
+async function main() {
+  if (shouldSkip()) return;
+
+  const version = await readPackageVersion();
+  const windowsVersion = normalizeWindowsVersion(version);
+  const displayName = `Agent Inspector ${version}`;
+  const rcedit = require("rcedit");
+
+  await mkdir(outputDir, { recursive: true });
+  await copyFile(process.execPath, brandedRuntime);
+  await rcedit(brandedRuntime, {
+    icon: iconPath,
+    "file-version": windowsVersion,
+    "product-version": windowsVersion,
+    "version-string": {
+      CompanyName: "TonyClaw",
+      FileDescription: displayName,
+      InternalName: displayName,
+      OriginalFilename: "agent-inspector.exe",
+      ProductName: displayName,
+      ProductVersion: version,
+      LegalCopyright: "Copyright (c) TonyClaw",
+    },
+  });
+
+  console.log("Generated Windows branded runtime: .output/agent-inspector.exe");
+}
+
+try {
+  await main();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.warn(`Skipping Windows branded runtime generation: ${message}`);
+  if (process.env["AGENT_INSPECTOR_REQUIRE_WINDOWS_RUNTIME"] === "1") {
+    process.exitCode = 1;
+  }
+}