agent-session-inspector 0.0.1 → 0.1.3

package/app/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "agent-session-inspector",
+  "version": "0.1.3",
+  "description": "Inspect Claude Code, Codex, GitHub Copilot, OpenCode and Hermes agent sessions in a local web UI: timeline, tokens, cost and analytics.",
+  "keywords": [
+    "agent",
+    "ai-agent",
+    "session",
+    "claude-code",
+    "claude",
+    "copilot",
+    "copilot-chat",
+    "vscode",
+    "codex",
+    "opencode",
+    "hermes",
+    "llm",
+    "transcript",
+    "tokens",
+    "token-usage",
+    "cost",
+    "observability"
+  ],
+  "author": "Kishan Mundha (https://github.com/kishanmundha)",
+  "license": "MIT",
+  "homepage": "https://github.com/kishanmundha/agent-session-inspector#readme",
+  "bugs": {
+    "url": "https://github.com/kishanmundha/agent-session-inspector/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kishanmundha/agent-session-inspector.git"
+  },
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint",
+    "deploy:docker": "./scripts/deploy-docker.sh",
+    "package": "./scripts/package-release.sh"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.7.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "geist": "^1.7.2",
+    "js-yaml": "^4.0.9",
+    "lucide-react": "^1.29.0",
+    "next": "16.3.0",
+    "react": "19.2.8",
+    "react-day-picker": "^10.0.2",
+    "react-dom": "19.2.8",
+    "react-markdown": "^10.1.0",
+    "shadcn": "^4.16.2",
+    "tailwind-merge": "^3.6.0",
+    "tw-animate-css": "^1.4.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.20.4",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.3.0",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

package/app/server.js

@@ -0,0 +1,38 @@
+const path = require('path')
+
+const dir = path.join(__dirname)
+
+process.env.NODE_ENV = 'production'
+process.chdir(__dirname)
+
+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.3"},"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)
+
+require('next')
+const { startServer } = require('next/dist/server/lib/start-server')
+
+if (
+  Number.isNaN(keepAliveTimeout) ||
+  !Number.isFinite(keepAliveTimeout) ||
+  keepAliveTimeout < 0
+) {
+  keepAliveTimeout = undefined
+}
+
+startServer({
+  dir,
+  isDev: false,
+  config: nextConfig,
+  hostname,
+  port: currentPort,
+  allowRetry: false,
+  keepAliveTimeout,
+}).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/bin/agent-session-inspector.mjs

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+// Launcher for the packaged (standalone) build, run by npx or the installed
+// command. Lives at <package>/bin/ beside app/, which holds the server.js that
+// `next build` emits; see scripts/package-release.sh.
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import net from "node:net";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const NAME = "agent-session-inspector";
+const MIN_NODE = [22, 13];
+const PKG_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const SERVER = path.join(PKG_DIR, "app", "server.js");
+
+const HELP = `Usage: ${NAME} [options]
+
+Browse Claude Code, Codex, Copilot, OpenCode and Hermes session transcripts in a
+local web UI.
+
+Options:
+  -p, --port <port>   Port to listen on (default: 3000, 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
+  -h, --help          Show this help
+`;
+
+function fail(message) {
+  console.error(`${NAME}: ${message}`);
+  process.exit(1);
+}
+
+function parseArgs(argv) {
+  const opts = { port: null, host: "127.0.0.1", open: true };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const [flag, inline] = arg.startsWith("--") ? arg.split("=", 2) : [arg];
+    const value = () => inline ?? argv[++i] ?? fail(`${flag} needs a value`);
+    switch (flag) {
+      case "-p":
+      case "--port": {
+        const port = Number(value());
+        if (!Number.isInteger(port) || port < 1 || port > 65535) fail("invalid port");
+        opts.port = port;
+        break;
+      }
+      case "-H":
+      case "--host":
+        opts.host = value();
+        break;
+      case "--no-open":
+        opts.open = false;
+        break;
+      case "-v":
+      case "--version":
+        console.log(readVersion());
+        process.exit(0);
+        break;
+      case "-h":
+      case "--help":
+        console.log(HELP);
+        process.exit(0);
+        break;
+      default:
+        fail(`unknown option ${arg}\n\n${HELP}`);
+    }
+  }
+  return opts;
+}
+
+function readVersion() {
+  try {
+    return readFileSync(path.join(PKG_DIR, "VERSION"), "utf8").trim();
+  } catch {
+    return "dev";
+  }
+}
+
+function isFree(port, host) {
+  return new Promise((resolve) => {
+    const probe = net.createServer();
+    probe.once("error", () => resolve(false));
+    probe.listen(port, host, () => probe.close(() => resolve(true)));
+  });
+}
+
+async function pickPort(preferred, host) {
+  for (let port = preferred; port < preferred + 20; port++) {
+    if (await isFree(port, host)) return port;
+  }
+  fail(`no free port between ${preferred} and ${preferred + 19}; pass --port`);
+}
+
+async function waitUntilUp(url) {
+  for (let i = 0; i < 100; i++) {
+    try {
+      await fetch(url, { method: "HEAD" });
+      return true;
+    } catch {
+      await new Promise((r) => setTimeout(r, 100));
+    }
+  }
+  return false;
+}
+
+function openBrowser(url) {
+  const [cmd, args] =
+    process.platform === "darwin"
+      ? ["open", [url]]
+      : process.platform === "win32"
+        ? ["cmd", ["/c", "start", "", url]]
+        : ["xdg-open", [url]];
+  // No browser (ssh, container) is fine; the URL is already printed.
+  spawn(cmd, args, { stdio: "ignore", detached: true })
+    .on("error", () => {})
+    .unref();
+}
+
+const opts = parseArgs(process.argv.slice(2));
+
+// npx only warns about package.json "engines", and the app needs node:sqlite.
+const [major, minor] = process.versions.node.split(".").map(Number);
+if (major < MIN_NODE[0] || (major === MIN_NODE[0] && minor < MIN_NODE[1])) {
+  fail(`Node.js ${MIN_NODE.join(".")} or newer is required (found ${process.version}).`);
+}
+
+if (!existsSync(SERVER)) {
+  fail(`no build found at ${SERVER}\nRun scripts/package-release.sh and use dist/${NAME}/bin/${NAME}.mjs.`);
+}
+
+let port = opts.port;
+if (port === null) {
+  port = await pickPort(Number(process.env.PORT) || 3000, opts.host);
+} else if (!(await isFree(port, opts.host))) {
+  fail(`port ${port} is already in use`);
+}
+
+process.env.NODE_ENV = "production";
+process.env.NEXT_TELEMETRY_DISABLED = "1";
+process.env.PORT = String(port);
+process.env.HOSTNAME = opts.host;
+
+// node:sqlite still announces itself as experimental on Node 22; not useful here.
+const emitWarning = process.emitWarning;
+process.emitWarning = (warning, ...rest) => {
+  if (String(warning).includes("SQLite is an experimental feature")) return;
+  emitWarning.call(process, warning, ...rest);
+};
+
+// server.js is CommonJS and starts listening on load.
+createRequire(import.meta.url)(SERVER);
+
+if (opts.open) {
+  const browseHost = opts.host === "0.0.0.0" || opts.host === "::" ? "localhost" : opts.host;
+  const url = `http://${browseHost.includes(":") ? `[${browseHost}]` : browseHost}:${port}`;
+  if (await waitUntilUp(url)) openBrowser(url);
+}

package/package.json

@@ -1,8 +1,45 @@
 {
   "name": "agent-session-inspector",
-  "version": "0.0.1",
-  "description": "Inspect Claude Code, Copilot CLI and Codex sessions: timeline, tokens, cost and analytics. Placeholder release; the app is published from github.com/kishanmundha/agent-session-visualizer.",
-  "repository": "github:kishanmundha/agent-session-visualizer",
-  "author": "Kishan Mundha",
-  "license": "UNLICENSED"
+  "version": "0.1.3",
+  "description": "Inspect Claude Code, Codex, GitHub Copilot, OpenCode and Hermes agent sessions in a local web UI: timeline, tokens, cost and analytics.",
+  "keywords": [
+    "agent",
+    "ai-agent",
+    "session",
+    "claude-code",
+    "claude",
+    "copilot",
+    "copilot-chat",
+    "vscode",
+    "codex",
+    "opencode",
+    "hermes",
+    "llm",
+    "transcript",
+    "tokens",
+    "token-usage",
+    "cost",
+    "observability"
+  ],
+  "author": "Kishan Mundha (https://github.com/kishanmundha)",
+  "license": "MIT",
+  "homepage": "https://github.com/kishanmundha/agent-session-inspector#readme",
+  "bugs": {
+    "url": "https://github.com/kishanmundha/agent-session-inspector/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kishanmundha/agent-session-inspector.git"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "bin": {
+    "agent-session-inspector": "bin/agent-session-inspector.mjs"
+  },
+  "files": [
+    "app",
+    "bin",
+    "VERSION"
+  ]
 }