@tonyclaw/agent-inspector 2.0.1 → 2.0.2

package/.output/server/index.mjs

@@ -38,107 +38,107 @@ const assets = {
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-06-20T04:11:08.016Z",
+    "mtime": "2026-06-20T06:54:35.499Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/index-BU0PpLby.js": {
+  "/assets/CompareDrawer-Bp7_x-5N.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"74-VQLwqrYKW1w1vyDegF1mvh4xcEg"',
-    "mtime": "2026-06-20T04:11:08.016Z",
-    "size": 116,
-    "path": "../public/assets/index-BU0PpLby.js"
-  },
-  "/assets/CompareDrawer-sVLGhCO3.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"4a1f-I4v3MS54eYnnzDhhqEIEsaLQr9E"',
-    "mtime": "2026-06-20T04:11:08.016Z",
+    "etag": '"4a1f-jydruemAUSMwVzObceAGMUJLrQ8"',
+    "mtime": "2026-06-20T06:54:35.500Z",
     "size": 18975,
-    "path": "../public/assets/CompareDrawer-sVLGhCO3.js"
-  },
-  "/assets/index-CpWG2hFn.css": {
-    "type": "text/css; charset=utf-8",
-    "etag": '"17063-Htyi07AI/KjwlBt4Ff8s9XjH2HE"',
-    "mtime": "2026-06-20T04:11:08.016Z",
-    "size": 94307,
-    "path": "../public/assets/index-CpWG2hFn.css"
-  },
-  "/assets/json-viewer-CKNMihlh.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"1e651-bsyUi317U2guBJsuPZODPYIDT3I"',
-    "mtime": "2026-06-20T04:11:08.018Z",
-    "size": 124497,
-    "path": "../public/assets/json-viewer-CKNMihlh.js"
+    "path": "../public/assets/CompareDrawer-Bp7_x-5N.js"
   },
   "/assets/minimax-BPMzvuL-.jpeg": {
     "type": "image/jpeg",
     "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-06-20T04:11:08.016Z",
+    "mtime": "2026-06-20T06:54:35.499Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/main-yWf8dv9w.js": {
+  "/assets/json-viewer-6uV_YXws.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"5138c-ajuPEmTU5gk81OjbjPWHjuTkUeM"',
-    "mtime": "2026-06-20T04:11:08.016Z",
-    "size": 332684,
-    "path": "../public/assets/main-yWf8dv9w.js"
+    "etag": '"1e651-ErvitreVwBoWFEPdSIq0EqZIuw4"',
+    "mtime": "2026-06-20T06:54:35.501Z",
+    "size": 124497,
+    "path": "../public/assets/json-viewer-6uV_YXws.js"
   },
-  "/assets/ReplayDialog-DxbFUqNW.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": '"11c0-HRfvYJdzqa0jHhOxOHXszP4gZZY"',
-    "mtime": "2026-06-20T04:11:08.016Z",
-    "size": 4544,
-    "path": "../public/assets/ReplayDialog-DxbFUqNW.js"
+    "etag": '"74-JGabHf17Kno+3wF7wJwm2nHkVhg"',
+    "mtime": "2026-06-20T06:54:35.500Z",
+    "size": 116,
+    "path": "../public/assets/index-BGGOWR7A.js"
   },
-  "/assets/RequestAnatomy-CSmGQa_g.js": {
+  "/assets/StreamingChunkSequence-Bjs4Lqwn.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"142a-/7Ujr1VdEsMRLbp8oA7QUq4987M"',
-    "mtime": "2026-06-20T04:11:08.018Z",
-    "size": 5162,
-    "path": "../public/assets/RequestAnatomy-CSmGQa_g.js"
+    "etag": '"d81-yAIItbapwm0q/MbLRpCH915YVMc"',
+    "mtime": "2026-06-20T06:54:35.501Z",
+    "size": 3457,
+    "path": "../public/assets/StreamingChunkSequence-Bjs4Lqwn.js"
   },
-  "/assets/ResponseView-B5f89c8Z.js": {
+  "/assets/RequestAnatomy-ehyrskxt.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"6e91-8GOJTIuom7L8X7ehEPf9HfaFuGs"',
-    "mtime": "2026-06-20T04:11:08.018Z",
-    "size": 28305,
-    "path": "../public/assets/ResponseView-B5f89c8Z.js"
+    "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-20T04:11:08.016Z",
+    "mtime": "2026-06-20T06:54:35.499Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/StreamingChunkSequence-BzqpY0TN.js": {
+  "/assets/main-FSGUGtEL.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d81-5rce/n28nmO176CRcqCDrcHI9uw"',
-    "mtime": "2026-06-20T04:11:08.018Z",
-    "size": 3457,
-    "path": "../public/assets/StreamingChunkSequence-BzqpY0TN.js"
+    "etag": '"5138c-aZy2XlKYAw/+FTrgYI1Iz4MHtww"',
+    "mtime": "2026-06-20T06:54:35.500Z",
+    "size": 332684,
+    "path": "../public/assets/main-FSGUGtEL.js"
   },
-  "/assets/_sessionId-BF7ftHV3.js": {
+  "/assets/ProxyViewerContainer-USuxPy-K.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-qBNzxlXPxxp+2NZarjxCyy5PG+Q"',
-    "mtime": "2026-06-20T04:11:08.016Z",
+    "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-pqW14/f9UjxfuYAzRgQmGaiZhbs"',
+    "mtime": "2026-06-20T06:54:35.500Z",
     "size": 210,
-    "path": "../public/assets/_sessionId-BF7ftHV3.js"
+    "path": "../public/assets/_sessionId-D_SeK_qp.js"
+  },
+  "/assets/ResponseView-BNGyc8e_.js": {
+    "type": "text/javascript; charset=utf-8",
+    "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-20T04:11:08.016Z",
+    "mtime": "2026-06-20T06:54:35.500Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/ProxyViewerContainer-p9QvzZ6U.js": {
+  "/assets/ReplayDialog-DFHCd0yx.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"77564-16W0V8xckeXv7EkaIbc7W0w1HT8"',
-    "mtime": "2026-06-20T04:11:08.016Z",
-    "size": 488804,
-    "path": "../public/assets/ProxyViewerContainer-p9QvzZ6U.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

@@ -24,9 +24,11 @@ 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** with the project icon.
-If npm lifecycle scripts are disabled, Agent Inspector falls back to `node.exe`
-and keeps working normally.
+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:
@@ -41,6 +43,16 @@ Optional guided setup:
 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
@@ -58,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.1",
+  "version": "2.0.2",
   "type": "module",
   "description": "Agent observability and knowledge capture layer for AI coding tools.",
   "license": "MIT",
@@ -38,6 +38,7 @@
     "!src/**/__fixtures__",
     "!src/routeTree.gen.ts",
     "scripts/setup-windows-runtime.mjs",
+    "scripts/setup-codex-skill.mjs",
     "styles",
     ".output",
     "!.output/*.exe"
@@ -47,7 +48,7 @@
     "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",
+    "postinstall": "node scripts/setup-windows-runtime.mjs && node scripts/setup-codex-skill.mjs",
     "prepublishOnly": "npm run build",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",

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

@@ -40,6 +40,7 @@ async function main() {
 
   const version = await readPackageVersion();
   const windowsVersion = normalizeWindowsVersion(version);
+  const displayName = `Agent Inspector ${version}`;
   const rcedit = require("rcedit");
 
   await mkdir(outputDir, { recursive: true });
@@ -50,10 +51,10 @@ async function main() {
     "product-version": windowsVersion,
     "version-string": {
       CompanyName: "TonyClaw",
-      FileDescription: "Agent Inspector",
-      InternalName: "Agent Inspector",
+      FileDescription: displayName,
+      InternalName: displayName,
       OriginalFilename: "agent-inspector.exe",
-      ProductName: "Agent Inspector",
+      ProductName: displayName,
       ProductVersion: version,
       LegalCopyright: "Copyright (c) TonyClaw",
     },