agent-session-inspector 0.1.8 → 0.1.10

package/app/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+allowBuilds:
+  esbuild: false
+  unrs-resolver: true

package/app/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/app/scripts/build-cli.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+// Bundles src/cli into the single file the launcher loads for report commands
+// (usage, stats, sessions). Output defaults to cli/cli.mjs beside bin/, which
+// is where bin/agent-session-inspector.mjs looks in a checkout and in the
+// packaged build alike.
+import { build } from "esbuild";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const outfile = path.resolve(process.argv[2] ?? path.join(ROOT, "cli", "cli.mjs"));
+
+await build({
+  entryPoints: [path.join(ROOT, "src", "cli", "index.ts")],
+  outfile,
+  bundle: true,
+  platform: "node",
+  format: "esm",
+  target: "node22",
+  alias: { "@": path.join(ROOT, "src") },
+  // Bundled CommonJS dependencies call require() for Node built-ins.
+  banner: {
+    js: 'import { createRequire as __createRequire } from "node:module";\nconst require = __createRequire(import.meta.url);',
+  },
+  logLevel: "warning",
+});

package/app/scripts/demo-data.mjs

@@ -0,0 +1,337 @@
+#!/usr/bin/env node
+// Writes a fake $HOME with synthetic Claude Code, Codex, Copilot and Gemini CLI transcripts, so the
+// UI can be demoed (and README screenshots retaken) without exposing real
+// sessions. Usage:
+//   node scripts/demo-data.mjs /tmp/asi-demo
+//   HOME=/tmp/asi-demo pnpm dev
+import fs from "fs";
+import path from "path";
+
+const root = path.resolve(process.argv[2] ?? ".demo-home");
+fs.rmSync(root, { recursive: true, force: true });
+
+const writeJsonl = (file, rows) => {
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, rows.map((r) => JSON.stringify(r)).join("\n") + "\n");
+};
+
+const clock = (start) => {
+  let t = new Date(start).getTime();
+  return (seconds = 3) => new Date((t += seconds * 1000)).toISOString();
+};
+
+// ---------------------------------------------------------------- Claude Code
+
+function claudeSession({ id, cwd, branch, title, start, model, turns }) {
+  const at = clock(start);
+  const base = { sessionId: id, cwd, gitBranch: branch, version: "2.1.4", entrypoint: "cli" };
+  const rows = [{ type: "ai-title", aiTitle: title, sessionId: id }];
+  let n = 0;
+  let parent = null;
+  const uid = () => `${id.slice(0, 8)}-${String(n++).padStart(4, "0")}`;
+  const add = (rec) => {
+    const uuid = uid();
+    rows.push({ ...base, ...rec, uuid, parentUuid: parent });
+    parent = uuid;
+  };
+  let cache = 18_000;
+  const usage = (out) => {
+    const u = {
+      input_tokens: 40 + Math.floor(Math.random() * 400),
+      cache_creation_input_tokens: 600 + Math.floor(Math.random() * 2500),
+      cache_read_input_tokens: cache,
+      output_tokens: out,
+    };
+    cache += u.cache_creation_input_tokens;
+    return u;
+  };
+
+  let msg = 0;
+  for (const turn of turns) {
+    const turnStart = Date.now();
+    add({ type: "user", timestamp: at(20), message: { role: "user", content: turn.prompt } });
+    for (const step of turn.steps) {
+      const mid = `msg_${id.slice(0, 6)}${msg++}`;
+      if (step.thinking) {
+        add({
+          type: "assistant",
+          timestamp: at(4),
+          message: { id: mid, role: "assistant", model, content: [{ type: "thinking", thinking: step.thinking }], usage: usage(180) },
+        });
+      }
+      if (step.tool) {
+        const toolId = `toolu_${id.slice(0, 6)}${msg}`;
+        add({
+          type: "assistant",
+          timestamp: at(3),
+          message: {
+            id: mid,
+            role: "assistant",
+            model,
+            content: [{ type: "tool_use", id: toolId, name: step.tool, input: step.input }],
+            usage: usage(90 + Math.floor(Math.random() * 400)),
+          },
+        });
+        add({
+          type: "user",
+          timestamp: at(step.seconds ?? 2),
+          message: {
+            role: "user",
+            content: [{ type: "tool_result", tool_use_id: toolId, content: step.result, is_error: step.error === true }],
+          },
+        });
+      }
+      if (step.text) {
+        add({
+          type: "assistant",
+          timestamp: at(5),
+          message: { id: mid, role: "assistant", model, content: [{ type: "text", text: step.text }], usage: usage(350) },
+        });
+      }
+    }
+    add({ type: "system", subtype: "turn_duration", timestamp: at(1), durationMs: 40_000 + (Date.now() - turnStart) });
+  }
+  return rows;
+}
+
+const claudeProjects = path.join(root, ".claude", "projects");
+
+const checkoutCwd = "/Users/demo/code/acme-shop";
+writeJsonl(
+  path.join(claudeProjects, "-Users-demo-code-acme-shop", "7f3c2a10-5b1e-4c8d-9a42-1d6e8b0f3c21.jsonl"),
+  claudeSession({
+    id: "7f3c2a10-5b1e-4c8d-9a42-1d6e8b0f3c21",
+    cwd: checkoutCwd,
+    branch: "fix/cart-total-rounding",
+    title: "Fix cart total rounding bug",
+    start: "2026-09-24T09:12:00Z",
+    model: "claude-opus-5-5",
+    turns: [
+      {
+        prompt:
+          "Customers are reporting the cart total is sometimes off by a cent. Can you find out why and fix it? Tests are in src/cart/__tests__.",
+        steps: [
+          { thinking: "Off-by-a-cent usually means floating point arithmetic on prices. Let me find where the total is computed." },
+          { tool: "Grep", input: { pattern: "total", path: "src/cart" }, result: "src/cart/total.ts:12:export function cartTotal(items: CartItem[]) {\nsrc/cart/total.ts:18:  return total;\nsrc/cart/summary.tsx:31:  const total = cartTotal(items);" },
+          { tool: "Read", input: { file_path: `${checkoutCwd}/src/cart/total.ts` }, result: "export function cartTotal(items: CartItem[]) {\n  let total = 0;\n  for (const item of items) {\n    total += item.price * item.quantity * (1 - item.discount);\n  }\n  return Math.round(total * 100) / 100;\n}" },
+          { text: "The total sums floating-point prices and rounds once at the end, so values like `0.1 + 0.2` drift before rounding. I'll switch to integer cents and round per line item." },
+          { tool: "Edit", input: { file_path: `${checkoutCwd}/src/cart/total.ts`, old_string: "total += item.price * item.quantity * (1 - item.discount);", new_string: "total += Math.round(toCents(item.price) * item.quantity * (1 - item.discount));" }, result: "The file src/cart/total.ts has been updated." },
+          { tool: "Edit", input: { file_path: `${checkoutCwd}/src/cart/__tests__/total.test.ts`, old_string: "});", new_string: "  it('does not drift on fractional prices', () => {\n    expect(cartTotal([{ price: 0.1, quantity: 3, discount: 0 }])).toBe(0.3);\n  });\n});" }, result: "The file src/cart/__tests__/total.test.ts has been updated." },
+          { tool: "Bash", input: { command: "pnpm test src/cart", description: "Run cart tests" }, seconds: 14, result: " PASS  src/cart/__tests__/total.test.ts\n  cartTotal\n    ✓ sums line items (3 ms)\n    ✓ applies discounts (1 ms)\n    ✓ does not drift on fractional prices (1 ms)\n\nTest Suites: 1 passed, 1 total\nTests:       3 passed, 3 total" },
+          { text: "Fixed. `cartTotal` now works in integer cents and rounds each line item, so totals no longer drift by a cent. I added a regression test for fractional prices; all 3 cart tests pass." },
+        ],
+      },
+      {
+        prompt: "Nice. Does the same bug exist in the order summary on the checkout page?",
+        steps: [
+          { tool: "Read", input: { file_path: `${checkoutCwd}/src/checkout/summary.tsx` }, result: "import { cartTotal } from '../cart/total';\n\nexport function OrderSummary({ items, shipping }) {\n  const subtotal = cartTotal(items);\n  const total = subtotal + shipping;\n  return <Money value={total} />;\n}" },
+          { tool: "Bash", input: { command: "pnpm test src/checkout", description: "Run checkout tests" }, seconds: 9, result: [{ type: "text", text: "Tests:       7 passed, 7 total" }] },
+          { text: "The checkout summary calls `cartTotal`, so it picks up the fix automatically. Shipping is already stored in cents, so there's nothing else to change there." },
+        ],
+      },
+    ],
+  }),
+);
+
+const apiCwd = "/Users/demo/code/weather-api";
+writeJsonl(
+  path.join(claudeProjects, "-Users-demo-code-weather-api", "c1d9e4b2-8a7f-4e21-b3c5-6f0a2d9e7b14.jsonl"),
+  claudeSession({
+    id: "c1d9e4b2-8a7f-4e21-b3c5-6f0a2d9e7b14",
+    cwd: apiCwd,
+    branch: "main",
+    title: "Add rate limiting to forecast endpoint",
+    start: "2026-09-23T15:40:00Z",
+    model: "claude-sonnet-5",
+    turns: [
+      {
+        prompt: "Add a simple per-IP rate limit (60 requests/minute) to GET /forecast.",
+        steps: [
+          { tool: "Glob", input: { pattern: "src/routes/**/*.ts" }, result: "src/routes/forecast.ts\nsrc/routes/health.ts" },
+          // A result of typed parts: the image is counted on the timeline, not shown.
+          { tool: "Read", input: { file_path: `${apiCwd}/docs/rate-limit.png` }, result: [{ type: "text", text: "Diagram of the token bucket: 60 requests refill every minute." }, { type: "image", source: { type: "base64", media_type: "image/png", data: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==" } }] },
+          { tool: "Read", input: { file_path: `${apiCwd}/src/routes/forecast.ts` }, result: "router.get('/forecast', async (req, res) => {\n  const data = await getForecast(req.query.city);\n  res.json(data);\n});" },
+          { tool: "Write", input: { file_path: `${apiCwd}/src/middleware/rate-limit.ts`, content: "export function rateLimit(limit: number, windowMs: number) { /* ... */ }" }, result: "File created successfully." },
+          { tool: "Edit", input: { file_path: `${apiCwd}/src/routes/forecast.ts`, old_string: "router.get('/forecast',", new_string: "router.get('/forecast', rateLimit(60, 60_000)," }, result: "The file src/routes/forecast.ts has been updated." },
+          { tool: "Bash", input: { command: "pnpm test", description: "Run test suite" }, seconds: 11, error: true, result: "FAIL src/routes/__tests__/forecast.test.ts\n  ✕ returns 429 after limit (12 ms)\n    Expected: 429\n    Received: 200" },
+          { thinking: "The limiter keys on req.ip, which is undefined behind the test client. Fall back to the socket address." },
+          { tool: "Edit", input: { file_path: `${apiCwd}/src/middleware/rate-limit.ts`, old_string: "const key = req.ip;", new_string: "const key = req.ip ?? req.socket.remoteAddress ?? 'unknown';" }, result: "The file src/middleware/rate-limit.ts has been updated." },
+          { tool: "Bash", input: { command: "pnpm test", description: "Run test suite" }, seconds: 10, result: "Tests:       18 passed, 18 total" },
+          { text: "Added a `rateLimit` middleware (fixed window, keyed by client IP) and applied it to `GET /forecast` at 60 requests/minute. Clients over the limit get a 429 with a `Retry-After` header. All 18 tests pass." },
+        ],
+      },
+    ],
+  }),
+);
+
+writeJsonl(
+  path.join(claudeProjects, "-Users-demo-code-acme-shop", "a8e2f7c3-1d4b-4f9e-8c6a-3b5d7e9f1a02.jsonl"),
+  claudeSession({
+    id: "a8e2f7c3-1d4b-4f9e-8c6a-3b5d7e9f1a02",
+    cwd: checkoutCwd,
+    branch: "main",
+    title: "Explain the checkout flow",
+    start: "2026-09-22T11:05:00Z",
+    model: "claude-haiku-4-5-20251001",
+    turns: [
+      {
+        prompt: "Give me a quick tour of how checkout works in this repo.",
+        steps: [
+          { tool: "Glob", input: { pattern: "src/checkout/**" }, result: "src/checkout/page.tsx\nsrc/checkout/summary.tsx\nsrc/checkout/payment.ts\nsrc/checkout/confirm.ts" },
+          { tool: "Read", input: { file_path: `${checkoutCwd}/src/checkout/page.tsx` }, result: "export default function CheckoutPage() { /* address → payment → confirm */ }" },
+          { text: "Checkout is a three-step flow in `src/checkout/page.tsx`: address, payment, confirm. `payment.ts` creates a payment intent, `confirm.ts` finalizes the order, and `summary.tsx` shows the running total using `cartTotal`." },
+        ],
+      },
+    ],
+  }),
+);
+
+// ---------------------------------------------------------------------- Codex
+
+const codexId = "0199a3f2-7c41-7d20-9e8b-5a4c3b2d1e0f";
+{
+  const at = clock("2026-09-24T17:30:00Z");
+  const cwd = "/Users/demo/code/cli-tools";
+  writeJsonl(path.join(root, ".codex", "session_index.jsonl"), [
+    { id: codexId, thread_name: "Add --json flag to status command" },
+  ]);
+  const tokens = (input, cached, output) => ({
+    type: "event_msg",
+    timestamp: at(1),
+    payload: {
+      type: "token_count",
+      info: {
+        total_token_usage: { input_tokens: input, cached_input_tokens: cached, output_tokens: output, total_tokens: input + output },
+        last_token_usage: { total_tokens: 9_000 },
+        model_context_window: 272_000,
+      },
+    },
+  });
+  writeJsonl(path.join(root, ".codex", "sessions", "2026", "09", "24", `rollout-2026-09-24T17-30-00-${codexId}.jsonl`), [
+    {
+      type: "session_meta",
+      timestamp: at(0),
+      payload: { id: codexId, cwd, originator: "codex_cli_rs", cli_version: "0.61.0", git: { branch: "feat/status-json", repository_url: "git@github.com:demo/cli-tools.git" } },
+    },
+    { type: "turn_context", timestamp: at(1), payload: { model: "gpt-5-codex", effort: "medium", cwd } },
+    { type: "event_msg", timestamp: at(1), payload: { type: "task_started", turn_id: "t1", model_context_window: 272_000 } },
+    { type: "event_msg", timestamp: at(2), payload: { type: "user_message", message: "Add a --json flag to `status` that prints machine-readable output." } },
+    { type: "event_msg", timestamp: at(4), payload: { type: "agent_reasoning", text: "Find the status command definition and its output formatter." } },
+    { type: "response_item", timestamp: at(1), payload: { type: "function_call", name: "shell", call_id: "c1", arguments: JSON.stringify({ command: ["rg", "-n", "fn status", "src"] }) } },
+    { type: "response_item", timestamp: at(2), payload: { type: "function_call_output", call_id: "c1", output: "src/commands/status.rs:14:pub fn status(args: StatusArgs) -> Result<()> {" } },
+    tokens(21_400, 12_800, 1_150),
+    { type: "event_msg", timestamp: at(8), payload: { type: "patch_apply_end", call_id: "p1", success: true, stdout: "Success. Updated the following files:\nM src/commands/status.rs\nM src/cli.rs", stderr: "", changes: { [`${cwd}/src/commands/status.rs`]: { type: "update" }, [`${cwd}/src/cli.rs`]: { type: "update" } } } },
+    { type: "response_item", timestamp: at(1), payload: { type: "function_call", name: "shell", call_id: "c2", arguments: JSON.stringify({ command: ["cargo", "test", "status"] }) } },
+    { type: "response_item", timestamp: at(18), payload: { type: "function_call_output", call_id: "c2", output: "running 4 tests\ntest status::plain_output ... ok\ntest status::json_output ... ok\n\ntest result: ok. 4 passed; 0 failed" } },
+    tokens(48_900, 36_100, 2_870),
+    { type: "event_msg", timestamp: at(4), payload: { type: "agent_message", message: "`status --json` now serializes the status struct with serde and prints it to stdout. Plain output is unchanged. Added a test for the JSON shape; all 4 status tests pass." } },
+    { type: "event_msg", timestamp: at(1), payload: { type: "task_complete", turn_id: "t1", duration_ms: 44_000 } },
+  ]);
+}
+
+// -------------------------------------------------------------------- Copilot
+
+{
+  const id = "5e2b9c14-3f8a-4d61-a7e0-9c3d2b1f6a85";
+  const dir = path.join(root, ".copilot", "session-state", id);
+  const cwd = "/Users/demo/code/docs-site";
+  const start = "2026-09-24T12:05:00Z";
+  const at = clock(start);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(
+    path.join(dir, "workspace.yaml"),
+    [
+      `id: ${id}`,
+      `name: Fix broken links in docs sidebar`,
+      `cwd: ${cwd}`,
+      `repository: demo/docs-site`,
+      `branch: fix/sidebar-links`,
+      `created_at: ${start}`,
+      `updated_at: 2026-09-24T12:07:10Z`,
+      `host_type: cli`,
+      `client_name: copilot-cli`,
+      `user_named: true`,
+    ].join("\n") + "\n",
+  );
+
+  let n = 0;
+  const ev = (type, data, seconds) => ({ type, data, id: `cp-${n++}`, timestamp: at(seconds), parentId: null });
+  const tool = (name, args, result, seconds = 2) => {
+    const toolCallId = `call_${n}`;
+    return [
+      ev("tool.execution_start", { toolName: name, toolCallId, arguments: args }, 3),
+      ev("tool.execution_complete", { toolName: name, toolCallId, success: true, result: { content: result } }, seconds),
+    ];
+  };
+  writeJsonl(path.join(dir, "events.jsonl"), [
+    ev("session.start", { sessionId: id, selectedModel: "gpt-5.1", copilotVersion: "0.0.412", context: { cwd, branch: "fix/sidebar-links", repository: "demo/docs-site" } }, 0),
+    ev("user.message", { content: "Some links in the docs sidebar 404 after the folder rename. Find and fix them." }, 5),
+    ev("assistant.message", { content: "I'll check the sidebar config against the files that actually exist.", outputTokens: 120, inputTokens: 9_800 }, 4),
+    ...tool("bash", { command: "node scripts/check-links.js sidebar.json" }, "3 broken links:\n  /guides/setup -> guides/setup.md (missing)\n  /guides/deploy -> guides/deploy.md (missing)\n  /api/auth -> api/auth.md (missing)", 6),
+    ...tool("glob", { pattern: "docs/**/*.md" }, "docs/getting-started/setup.md\ndocs/getting-started/deploy.md\ndocs/reference/auth.md\ndocs/index.md"),
+    ...tool("edit", { path: `${cwd}/sidebar.json`, old_str: '"guides/setup"', new_str: '"getting-started/setup"' }, "File updated."),
+    ...tool("bash", { command: "node scripts/check-links.js sidebar.json" }, "All links OK (24 checked).", 5),
+    ev("assistant.message", { content: "Updated three sidebar entries to the new `getting-started/` and `reference/` paths. The link checker now reports all 24 links OK.", outputTokens: 210, inputTokens: 14_600 }, 4),
+    ev("session.shutdown", {
+      totalApiDurationMs: 21_400,
+      totalPremiumRequests: 2,
+      modelMetrics: { "gpt-5.1": { usage: { inputTokens: 38_900, outputTokens: 1_640, cacheReadTokens: 27_300 } } },
+    }, 2),
+  ]);
+
+  fs.mkdirSync(path.join(root, ".copilot", "logs"), { recursive: true });
+  fs.writeFileSync(
+    path.join(root, ".copilot", "logs", "process-1758715500000-4821.log"),
+    `${start} [INFO] Starting Copilot CLI 0.0.412\n${start} [INFO] Session ${id} created in ${cwd}\n2026-09-24T12:07:10Z [INFO] Session ${id} shut down\n`,
+  );
+}
+
+// ----------------------------------------------------------------- Gemini CLI
+
+{
+  const id = "7c1e4a92-5b3d-4f08-9a6e-2d8f0b3c5e71";
+  const cwd = "/Users/demo/code/weather-api";
+  const start = "2026-09-25T09:10:00Z";
+  const at = clock(start);
+  const project = path.join(root, ".gemini", "tmp", "weather-api");
+  const model = "gemini-3.7-flash";
+  fs.mkdirSync(project, { recursive: true });
+  fs.writeFileSync(path.join(project, ".project_root"), cwd);
+
+  const tool = (callId, name, args, output) => ({
+    id: callId,
+    name,
+    args,
+    status: "success",
+    timestamp: at(2),
+    result: [{ functionResponse: { id: callId, name, response: { output } } }],
+  });
+  const reply = (messageId, fields) => ({ id: messageId, timestamp: at(4), type: "gemini", content: "", model, ...fields });
+  const prompt = { id: "m1", timestamp: at(3), type: "user", content: [{ text: "Forecast responses are cached for an hour. Make the TTL configurable." }] };
+  const grep = reply("m2", {
+    thoughts: [{ subject: "Locating the cache", description: "The forecast handler should own the TTL; search for it first.", timestamp: at(1) }],
+    tokens: { input: 11_200, output: 140, cached: 0, thoughts: 220, tool: 0, total: 11_560 },
+  });
+  writeJsonl(path.join(project, "chats", `session-2026-09-25T09-10-${id.slice(0, 8)}.jsonl`), [
+    { sessionId: id, projectHash: "3f9a1c", startTime: start, lastUpdated: start },
+    prompt,
+    grep,
+    // The CLI writes a message again as its tool calls come in; the last copy wins.
+    { ...grep, toolCalls: [tool("g1", "search_file_content", { pattern: "CACHE_TTL" }, "src/forecast/cache.ts:4:const CACHE_TTL = 3600;")] },
+    reply("m3", {
+      toolCalls: [
+        tool("g2", "replace", { file_path: `${cwd}/src/forecast/cache.ts`, old_string: "const CACHE_TTL = 3600;", new_string: "const CACHE_TTL = Number(process.env.FORECAST_TTL ?? 3600);" }, "Successfully modified file."),
+        tool("g3", "run_shell_command", { command: "npm test -- forecast" }, "Tests: 12 passed, 12 total"),
+      ],
+      tokens: { input: 12_900, output: 310, cached: 10_400, thoughts: 90, tool: 0, total: 13_300 },
+    }),
+    reply("m4", {
+      content: "The TTL now reads `FORECAST_TTL` (seconds) and falls back to one hour. All 12 forecast tests pass.",
+      tokens: { input: 13_600, output: 95, cached: 12_100, thoughts: 0, tool: 0, total: 13_695 },
+    }),
+    { $set: { lastUpdated: at(0), summary: "Make forecast cache TTL configurable" } },
+  ]);
+}
+
+console.log(`Demo home written to ${root}`);
+console.log(`Run: HOME=${root} pnpm dev`);

package/app/scripts/deploy-docker.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+NAME=agent-session-inspector
+
+docker build -t "$NAME" .
+
+if docker container inspect "$NAME" >/dev/null 2>&1; then
+	docker rm -f "$NAME"
+fi
+
+# Mount only the transcript paths the app reads, read-only. Deliberately narrow:
+# ~/.codex/auth.json, ~/.copilot/config.json, ~/.hermes/auth.json and
+# ~/.gemini/oauth_creds.json hold credentials and stay out. So does Cursor's
+# state.vscdb, which keeps its sign-in next to the chats: Cursor sessions are
+# read from the transcripts under ~/.cursor/projects instead.
+PATHS=(
+	".copilot/session-state"
+	".copilot/logs"
+	".copilot/session-store.db"
+	".copilot/session-store.db-shm"
+	".copilot/session-store.db-wal"
+	".claude/projects"
+	".codex/sessions"
+	".codex/session_index.jsonl"
+	".local/share/opencode/opencode.db"
+	".local/share/opencode/opencode.db-shm"
+	".local/share/opencode/opencode.db-wal"
+	".hermes/state.db"
+	".hermes/state.db-shm"
+	".hermes/state.db-wal"
+	".gemini/tmp"
+	".cursor/projects"
+)
+
+# Desktop apps keep their data somewhere else on each OS; inside the Linux
+# container the app looks under ~/.config.
+case "$(uname -s)" in
+Darwin) APP_DATA="Library/Application Support" ;;
+*) APP_DATA=".config" ;;
+esac
+APP_PATHS=(
+	"Code/User/workspaceStorage"
+	"Code/User/globalStorage/emptyWindowChatSessions"
+	"Code - Insiders/User/workspaceStorage"
+	"Code - Insiders/User/globalStorage/emptyWindowChatSessions"
+	"Claude/local-agent-mode-sessions"
+)
+
+mounts=()
+for rel in "${PATHS[@]}"; do
+	if [ -e "$HOME/$rel" ]; then
+		mounts+=(-v "$HOME/$rel:/root/$rel:ro")
+	fi
+done
+for rel in "${APP_PATHS[@]}"; do
+	if [ -e "$HOME/$APP_DATA/$rel" ]; then
+		mounts+=(-v "$HOME/$APP_DATA/$rel:/root/.config/$rel:ro")
+	fi
+done
+
+if [ ${#mounts[@]} -eq 0 ]; then
+	echo "No agent session directories found under $HOME." >&2
+	exit 1
+fi
+
+# The app shows where each session is stored; tell it what the mounts are
+# called out here, so the paths it shows are ones that exist on this machine.
+docker run -d --name "$NAME" --restart unless-stopped --user root -e HOME=/root \
+	-e ASI_HOST_HOME="$HOME" -e ASI_HOST_APP_DATA="$HOME/$APP_DATA" \
+	"${mounts[@]}" "$NAME"

package/app/scripts/package-release.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# Build the standalone server and stage it in dist/agent-session-inspector, the
+# folder `npm publish` uploads, then pack that into
+# dist/agent-session-inspector.tar.gz, the archive install.sh downloads. The
+# build has no native modules, so one package runs on any OS with Node.
+set -euo pipefail
+
+NAME=agent-session-inspector
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+VERSION="${1:-$(node -p "require('$ROOT/package.json').version")}"
+VERSION="${VERSION#v}"
+OUT="$ROOT/dist"
+STAGE="$OUT/$NAME"
+# The server sits a level down: npm leaves a package's top-level node_modules
+# out of the upload.
+APP="$STAGE/app"
+MODULES="$APP/node_modules"
+
+cd "$ROOT"
+# Clear the old output first, or the build traces it into the new one.
+rm -rf "$OUT"
+pnpm run build
+
+mkdir -p "$APP"
+
+# next build leaves .next/static out of the standalone folder.
+cp -R .next/standalone/. "$APP/"
+mkdir -p "$APP/.next"
+cp -R .next/static "$APP/.next/static"
+
+mkdir -p "$STAGE/bin"
+cp "bin/$NAME.mjs" "$STAGE/bin/$NAME.mjs"
+chmod +x "$STAGE/bin/$NAME.mjs"
+# The report commands (usage, stats, sessions) run from their own bundle.
+node scripts/build-cli.mjs "$STAGE/cli/cli.mjs"
+echo "$VERSION" > "$STAGE/VERSION"
+cp README.md LICENSE "$STAGE/"
+
+# The tracer drags in sharp (unused: images are unoptimized) with its
+# per-platform binaries and dependencies.
+for dep in "$MODULES"/.pnpm/sharp@*/node_modules/*; do
+	if [ -L "$dep" ]; then
+		target="$(cd "$dep" 2>/dev/null && pwd -P)" || continue
+		rm -rf "${target%/node_modules/*}"
+	fi
+done
+rm -rf "$MODULES"/.pnpm/@img+* "$MODULES"/.pnpm/sharp@*
+
+# npm never uploads symlinks, and pnpm's node_modules is built from them, so
+# hoist every traced package into one flat node_modules.
+find "$APP" -type l -delete
+for dir in "$MODULES"/.pnpm/*/node_modules/* "$MODULES"/.pnpm/*/node_modules/@*/*; do
+	[ -d "$dir" ] || continue
+	name="${dir##*/node_modules/}"
+	case "$name" in @*/*) ;; @*) continue ;; esac
+	if [ -e "$MODULES/$name" ]; then
+		echo "error: two versions of $name in the build; a flat node_modules can hold one" >&2
+		exit 1
+	fi
+	mkdir -p "$(dirname "$MODULES/$name")"
+	mv "$dir" "$MODULES/$name"
+done
+rm -rf "$MODULES/.pnpm"
+
+if find "$STAGE" -name '*.node' | grep -q .; then
+	echo "error: native module in build; the package would not be portable:" >&2
+	find "$STAGE" -name '*.node' >&2
+	exit 1
+fi
+
+# The manifest npm publishes: the built app has no dependencies left to install.
+node -e '
+	const pkg = require(process.argv[1]);
+	const [name, version] = process.argv.slice(2);
+	const { description, keywords, author, license, homepage, bugs, repository, engines } = pkg;
+	console.log(JSON.stringify({
+		name, version, description, keywords, author, license, homepage, bugs, repository, engines,
+		bin: { [name]: `bin/${name}.mjs` },
+		files: ["app", "bin", "cli", "VERSION"],
+	}, null, 2));
+' "$ROOT/package.json" "$NAME" "$VERSION" > "$STAGE/package.json"
+
+tar -czf "$OUT/$NAME.tar.gz" -C "$OUT" "$NAME"
+cp install.sh "$OUT/install.sh"
+
+echo "Packed $NAME $VERSION -> dist/$NAME.tar.gz ($(du -h "$OUT/$NAME.tar.gz" | cut -f1))"

package/app/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{"APP_VERSION":"0.1.8"},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/agent-session-inspector/agent-session-inspector","enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","outputFileTracingExcludes":{"/**":["./.git/**","./.claude/**","./src/**"]},"repoRoot":"/home/runner/work/agent-session-inspector/agent-session-inspector","turbopack":{"root":"/home/runner/work/agent-session-inspector/agent-session-inspector"},"distDirRoot":".next"}
+const nextConfig = {"env":{"APP_VERSION":"0.1.10"},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/agent-session-inspector/agent-session-inspector","enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","outputFileTracingExcludes":{"/**":["./.git/**","./.claude/**","./src/**"]},"repoRoot":"/home/runner/work/agent-session-inspector/agent-session-inspector","turbopack":{"root":"/home/runner/work/agent-session-inspector/agent-session-inspector"},"distDirRoot":".next"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/app/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/bin/agent-session-inspector.mjs

@@ -33,7 +33,7 @@ Commands:
   Run a command with --help for its options.
 
 Options:
-  -p, --port <port>   Port to listen on (default: 3000, or the next free one)
+  -p, --port <port>   Port to listen on (default: 4747, or the next free one)
   -H, --host <host>   Interface to bind (default: 127.0.0.1)
       --no-open       Don't open the browser
   -v, --version       Print the version
@@ -165,7 +165,7 @@ if (!existsSync(SERVER)) {
 
 let port = opts.port;
 if (port === null) {
-  port = await pickPort(Number(process.env.PORT) || 3000, opts.host);
+  port = await pickPort(Number(process.env.PORT) || 4747, opts.host);
 } else if (!(await isFree(port, opts.host))) {
   fail(`port ${port} is already in use`);
 }