agent-recorder 0.0.1

package/README.md

@@ -0,0 +1,133 @@
+# Agent Recorder
+
+Local-first flight recorder for Claude Code. Captures a persistent, human-readable timeline of execution including subagents, skills, and MCP tool calls.
+
+## Install
+
+```bash
+npm install -g agent-recorder
+```
+
+## Quick Start
+
+```bash
+# Set up ~/.agent-recorder/ directory
+agent-recorder install
+
+# Start the background daemon
+agent-recorder start --daemon
+
+# Configure Claude Code integration
+agent-recorder configure claude
+
+# Verify everything is working
+agent-recorder doctor
+```
+
+After configuration, restart Claude Code to apply changes.
+
+## Requirements
+
+- Node.js >= 20
+- macOS or Linux
+
+## Commands
+
+### Daemon Lifecycle
+
+- `agent-recorder start [--daemon]` - Start the recording daemon
+- `agent-recorder stop` - Stop the daemon
+- `agent-recorder restart` - Restart the daemon
+- `agent-recorder status` - Check if daemon is running
+
+### Health & Diagnostics
+
+- `agent-recorder doctor` - Comprehensive health check
+- `agent-recorder diagnose mcp` - MCP proxy diagnostics
+- `agent-recorder logs` - View daemon logs
+
+### Configuration
+
+- `agent-recorder install` - Set up directories and show config
+- `agent-recorder configure claude` - Configure Claude Code MCP settings
+- `agent-recorder configure show` - Show current configuration
+
+### Session Browsing
+
+- `agent-recorder sessions list` - List all recorded sessions
+- `agent-recorder sessions show <id>` - Show session details
+- `agent-recorder sessions view <id>` - View session events
+- `agent-recorder sessions tail <id>` - Follow session events in real-time
+- `agent-recorder tui` - Interactive session explorer
+
+### Data Export
+
+- `agent-recorder export <id>` - Export session to JSON/JSONL
+
+### Testing
+
+- `agent-recorder mock-mcp` - Start a mock MCP server for testing
+
+## Environment Variables
+
+- `AR_LISTEN_PORT` - REST API port (default: 8787)
+- `AR_MCP_PROXY_PORT` - MCP proxy port (default: 8788)
+- `AR_DB_PATH` - SQLite database path
+- `AR_DOWNSTREAM_MCP_URL` - URL of the downstream MCP server to proxy
+
+## How It Works
+
+Agent Recorder acts as a transparent MCP proxy between Claude Code and your MCP servers. It records:
+
+- Tool calls (tools/list, tools/call)
+- Timing and duration
+- Success/error status
+- Metadata (redacted for privacy)
+
+It does **not** record prompts, chain-of-thought, or sensitive content.
+
+## Troubleshooting
+
+### Daemon won't start
+
+```bash
+# Check if port is already in use
+lsof -i :8787
+lsof -i :8788
+
+# Force stop and restart
+agent-recorder stop --force
+agent-recorder start --daemon
+```
+
+### Claude Code not connecting
+
+```bash
+# Check configuration
+agent-recorder configure show
+
+# Re-configure if needed
+agent-recorder configure claude
+
+# Restart Claude Code after configuration changes
+```
+
+### No events being recorded
+
+```bash
+# Run full diagnostics
+agent-recorder doctor
+
+# Check MCP proxy specifically
+agent-recorder diagnose mcp
+
+# Test with mock MCP server
+agent-recorder mock-mcp --port 9999
+# In another terminal:
+export AR_DOWNSTREAM_MCP_URL="http://127.0.0.1:9999/"
+agent-recorder restart
+```
+
+## License
+
+MIT

package/dist/bundle.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Bundle script for distribution package.
+ *
+ * Copies compiled outputs from workspace packages into vendor/ directory
+ * with proper node_modules structure for module resolution.
+ */
+export {};
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/bundle.js

@@ -0,0 +1,131 @@
+/**
+ * Bundle script for distribution package.
+ *
+ * Copies compiled outputs from workspace packages into vendor/ directory
+ * with proper node_modules structure for module resolution.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const distRoot = path.join(__dirname, "..");
+const packagesRoot = path.join(distRoot, "..");
+const packages = [
+    {
+        name: "@agent-recorder/core",
+        srcDir: "core",
+        extraFiles: ["migrations"],
+    },
+    {
+        name: "@agent-recorder/service",
+        srcDir: "service",
+    },
+    {
+        name: "@agent-recorder/cli",
+        srcDir: "cli",
+    },
+];
+/**
+ * Recursively copy a directory.
+ */
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Rewrite exports to remove ./dist/ prefix since we copy dist contents to root.
+ */
+function rewriteExports(exports) {
+    if (!exports)
+        return undefined;
+    const result = {};
+    for (const [key, value] of Object.entries(exports)) {
+        if (typeof value === "string") {
+            // Remove ./dist/ prefix
+            result[key] = value.replace(/^\.\/dist\//, "./");
+        }
+        else if (typeof value === "object" && value !== null) {
+            // Handle { types: ..., import: ... } style
+            const obj = value;
+            result[key] = Object.fromEntries(Object.entries(obj).map(([k, v]) => [k, v.replace(/^\.\/dist\//, "./")]));
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Create a minimal package.json for the vendored package.
+ */
+function createVendorPackageJson(srcPkgPath, destPkgPath) {
+    const srcPkg = JSON.parse(fs.readFileSync(srcPkgPath, "utf-8"));
+    // Create minimal package.json with only what's needed for module resolution
+    // Rewrite exports to point to root (since we copy dist/ contents to package root)
+    const vendorPkg = {
+        name: srcPkg.name,
+        version: srcPkg.version,
+        type: srcPkg.type ?? "module",
+        exports: rewriteExports(srcPkg.exports),
+        // Rewrite workspace:* dependencies to point to sibling vendor packages
+        dependencies: Object.fromEntries(Object.entries(srcPkg.dependencies ?? {})
+            .filter(([, version]) => !String(version).startsWith("workspace:"))
+            .map(([name, version]) => [name, version])),
+    };
+    fs.writeFileSync(destPkgPath, JSON.stringify(vendorPkg, null, 2) + "\n");
+}
+/**
+ * Main bundle function.
+ */
+function bundle() {
+    const vendorRoot = path.join(distRoot, "vendor", "node_modules");
+    // Clean vendor directory
+    if (fs.existsSync(vendorRoot)) {
+        fs.rmSync(vendorRoot, { recursive: true });
+    }
+    fs.mkdirSync(vendorRoot, { recursive: true });
+    console.log("Bundling packages into vendor/...");
+    for (const pkg of packages) {
+        const srcPkgDir = path.join(packagesRoot, pkg.srcDir);
+        const srcDistDir = path.join(srcPkgDir, "dist");
+        const srcPkgJson = path.join(srcPkgDir, "package.json");
+        // Destination in vendor/node_modules/@agent-recorder/{name}
+        const destPkgDir = path.join(vendorRoot, pkg.name);
+        if (!fs.existsSync(srcDistDir)) {
+            console.error(`Error: ${srcDistDir} does not exist. Run pnpm build first.`);
+            process.exit(1);
+        }
+        console.log(`  Copying ${pkg.name}...`);
+        // Copy dist/ contents to package root (so exports work correctly)
+        copyDir(srcDistDir, destPkgDir);
+        // Copy extra files if specified (e.g., migrations)
+        for (const extra of pkg.extraFiles ?? []) {
+            const srcExtra = path.join(srcPkgDir, extra);
+            if (fs.existsSync(srcExtra)) {
+                const destExtra = path.join(destPkgDir, extra);
+                if (fs.statSync(srcExtra).isDirectory()) {
+                    copyDir(srcExtra, destExtra);
+                }
+                else {
+                    fs.copyFileSync(srcExtra, destExtra);
+                }
+            }
+        }
+        // Create vendor package.json
+        createVendorPackageJson(srcPkgJson, path.join(destPkgDir, "package.json"));
+    }
+    console.log("Bundle complete!");
+}
+bundle();
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Agent Recorder - Distribution Entrypoint
+ *
+ * This is the main entry point for the distributed npm package.
+ * It sets up module resolution to use vendor/ packages and then
+ * runs the CLI.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Agent Recorder - Distribution Entrypoint
+ *
+ * This is the main entry point for the distributed npm package.
+ * It sets up module resolution to use vendor/ packages and then
+ * runs the CLI.
+ */
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { createRequire } from "node:module";
+// Get the directory of this script
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Set up NODE_PATH to include vendor/node_modules for @agent-recorder/* resolution
+const vendorPath = join(__dirname, "..", "vendor", "node_modules");
+if (process.env.NODE_PATH) {
+    process.env.NODE_PATH = `${vendorPath}:${process.env.NODE_PATH}`;
+}
+else {
+    process.env.NODE_PATH = vendorPath;
+}
+// Re-initialize module resolution with updated NODE_PATH
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const Module = createRequire(import.meta.url)("module");
+Module._initPaths?.();
+// Import and run the CLI
+// The CLI is in vendor/node_modules/@agent-recorder/cli
+const cliPath = join(vendorPath, "@agent-recorder", "cli", "index.js");
+await import(cliPath);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mCAAmC;AACnC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,mFAAmF;AACnF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AACnE,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;AACnE,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC;AACrC,CAAC;AAED,yDAAyD;AACzD,iEAAiE;AACjE,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AACxD,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;AAEtB,yBAAyB;AACzB,wDAAwD;AACxD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AACvE,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "agent-recorder",
+  "version": "0.0.1",
+  "description": "Local-first flight recorder for Claude Code",
+  "type": "module",
+  "bin": {
+    "agent-recorder": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "vendor"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "bundle": "node dist/bundle.js",
+    "prebuild:dist": "pnpm run build",
+    "build:dist": "pnpm run bundle"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.7.0",
+    "commander": "^13.0.0",
+    "fastify": "^5.0.0",
+    "ink": "^5.0.1",
+    "ink-text-input": "^6.0.0",
+    "react": "^18.3.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/agent-recorder"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "flight-recorder",
+    "agent",
+    "observability"
+  ],
+  "author": "Edyta Kucharska",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  }
+}

package/vendor/node_modules/@agent-recorder/cli/analytics/session-analytics 2.js

@@ -0,0 +1,205 @@
+/**
+ * Session analytics - pure functions for computing session metrics.
+ * These functions work on BaseEvent[] arrays fetched from the API.
+ * No side effects, no I/O - just computation.
+ */
+/**
+ * Compute session summary from events.
+ */
+export function computeSessionSummary(events, slowestCount = 10) {
+    const byStatus = {};
+    const byEventType = {};
+    const byToolName = {};
+    const byErrorCategory = {};
+    let successCount = 0;
+    let errorCount = 0;
+    let timeoutCount = 0;
+    let totalDurationMs = 0;
+    let durationCount = 0;
+    // Collect durations for slowest calls
+    const durations = [];
+    for (const event of events) {
+        // Count by status
+        byStatus[event.status] = (byStatus[event.status] ?? 0) + 1;
+        // Count by event type
+        byEventType[event.eventType] = (byEventType[event.eventType] ?? 0) + 1;
+        // Count by tool name
+        if (event.toolName) {
+            byToolName[event.toolName] = (byToolName[event.toolName] ?? 0) + 1;
+        }
+        // Count by error category
+        if (event.errorCategory) {
+            byErrorCategory[event.errorCategory] =
+                (byErrorCategory[event.errorCategory] ?? 0) + 1;
+        }
+        // Count success/error/timeout
+        if (event.status === "success") {
+            successCount++;
+        }
+        else if (event.status === "error") {
+            errorCount++;
+        }
+        else if (event.status === "timeout") {
+            timeoutCount++;
+        }
+        // Compute duration if both timestamps present
+        if (event.startedAt && event.endedAt) {
+            const duration = new Date(event.endedAt).getTime() - new Date(event.startedAt).getTime();
+            totalDurationMs += duration;
+            durationCount++;
+            durations.push({
+                sequence: event.sequence,
+                toolName: event.toolName,
+                durationMs: duration,
+            });
+        }
+    }
+    // Top tools by count
+    const topTools = Object.entries(byToolName)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 5)
+        .map(([name, count]) => ({ name, count }));
+    // Top errors by count
+    const topErrors = Object.entries(byErrorCategory)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 5)
+        .map(([category, count]) => ({
+        category: category,
+        count,
+    }));
+    // Slowest calls
+    const slowestCalls = durations
+        .sort((a, b) => b.durationMs - a.durationMs)
+        .slice(0, slowestCount);
+    return {
+        totalEvents: events.length,
+        byStatus,
+        byEventType,
+        byToolName,
+        byErrorCategory,
+        successCount,
+        errorCount,
+        timeoutCount,
+        errorRate: events.length > 0 ? (errorCount + timeoutCount) / events.length : 0,
+        avgDurationMs: durationCount > 0 ? Math.round(totalDurationMs / durationCount) : null,
+        totalDurationMs,
+        topTools,
+        topErrors,
+        slowestCalls,
+    };
+}
+/**
+ * Format summary as human-readable text.
+ */
+export function formatSummaryText(summary) {
+    const lines = [];
+    lines.push("Session Summary");
+    lines.push("=".repeat(50));
+    lines.push(`Total Events: ${summary.totalEvents}`);
+    lines.push(`Error Rate: ${(summary.errorRate * 100).toFixed(1)}% (${summary.errorCount} errors, ${summary.timeoutCount} timeouts)`);
+    lines.push(`Avg Duration: ${summary.avgDurationMs !== null ? `${summary.avgDurationMs}ms` : "N/A"}`);
+    lines.push(`Total Duration: ${summary.totalDurationMs}ms`);
+    lines.push("");
+    // By status
+    lines.push("By Status:");
+    for (const [status, count] of Object.entries(summary.byStatus)) {
+        lines.push(`  ${status}: ${count}`);
+    }
+    lines.push("");
+    // Top tools
+    if (summary.topTools.length > 0) {
+        lines.push("Top Tools:");
+        for (const { name, count } of summary.topTools) {
+            lines.push(`  ${name}: ${count}`);
+        }
+        lines.push("");
+    }
+    // Error categories
+    if (summary.topErrors.length > 0) {
+        lines.push("Error Categories:");
+        for (const { category, count } of summary.topErrors) {
+            lines.push(`  ${category}: ${count}`);
+        }
+        lines.push("");
+    }
+    // Slowest calls
+    if (summary.slowestCalls.length > 0) {
+        lines.push("Slowest Calls:");
+        for (const { sequence, toolName, durationMs } of summary.slowestCalls.slice(0, 5)) {
+            lines.push(`  [${sequence}] ${toolName ?? "-"}: ${durationMs}ms`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a concise one-line safe summary (no content).
+ */
+export function formatConciseSummary(events, summary) {
+    const parts = [];
+    // Total events with top tools
+    const toolBreakdown = summary.topTools
+        .slice(0, 3)
+        .map((t) => `${t.name}(${t.count})`)
+        .join(", ");
+    parts.push(`${summary.totalEvents} tool calls across ${toolBreakdown}${summary.topTools.length > 3 ? "..." : ""}`);
+    // Errors
+    if (summary.errorCount > 0 || summary.timeoutCount > 0) {
+        const errorDetails = summary.topErrors
+            .map((e) => `${e.category}`)
+            .join(", ");
+        parts.push(`${summary.errorCount + summary.timeoutCount} error(s): ${errorDetails || "unknown"}`);
+    }
+    // Slowest call
+    if (summary.slowestCalls.length > 0) {
+        const slowest = summary.slowestCalls[0];
+        parts.push(`Slowest: ${slowest.toolName ?? "unknown"} (${slowest.durationMs}ms)`);
+    }
+    // Total wall time
+    if (summary.totalDurationMs > 0) {
+        const wallTime = (summary.totalDurationMs / 1000).toFixed(1);
+        parts.push(`Total time: ${wallTime}s`);
+    }
+    return parts.join("\n");
+}
+/**
+ * Format stats output for CLI.
+ */
+export function formatStatsText(summary) {
+    const lines = [];
+    lines.push("Session Statistics");
+    lines.push("=".repeat(50));
+    lines.push("");
+    // Counts by tool
+    lines.push("Tool Call Counts (sorted by frequency):");
+    const sortedTools = Object.entries(summary.byToolName).sort(([, a], [, b]) => b - a);
+    for (const [name, count] of sortedTools) {
+        lines.push(`  ${name.padEnd(30)} ${count}`);
+    }
+    lines.push("");
+    // Slowest calls
+    if (summary.slowestCalls.length > 0) {
+        lines.push("Slowest Calls (top 10):");
+        for (const { sequence, toolName, durationMs } of summary.slowestCalls) {
+            lines.push(`  [${String(sequence).padStart(4)}] ${(toolName ?? "-").padEnd(30)} ${durationMs}ms`);
+        }
+        lines.push("");
+    }
+    // Error counts by tool
+    if (summary.topErrors.length > 0) {
+        lines.push("Error Categories:");
+        for (const { category, count } of summary.topErrors) {
+            lines.push(`  ${category.padEnd(30)} ${count}`);
+        }
+        lines.push("");
+    }
+    // Summary stats
+    lines.push("Summary:");
+    lines.push(`  Total Events:    ${summary.totalEvents}`);
+    lines.push(`  Success:         ${summary.successCount}`);
+    lines.push(`  Errors:          ${summary.errorCount}`);
+    lines.push(`  Timeouts:        ${summary.timeoutCount}`);
+    lines.push(`  Avg Duration:    ${summary.avgDurationMs !== null ? `${summary.avgDurationMs}ms` : "N/A"}`);
+    lines.push(`  Total Duration:  ${summary.totalDurationMs}ms`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=session-analytics.js.map

package/vendor/node_modules/@agent-recorder/cli/analytics/session-analytics.d 2.ts

@@ -0,0 +1,50 @@
+/**
+ * Session analytics - pure functions for computing session metrics.
+ * These functions work on BaseEvent[] arrays fetched from the API.
+ * No side effects, no I/O - just computation.
+ */
+import type { BaseEvent, ErrorCategory } from "@agent-recorder/core";
+/** Session summary computed from events */
+export interface SessionSummary {
+    totalEvents: number;
+    byStatus: Record<string, number>;
+    byEventType: Record<string, number>;
+    byToolName: Record<string, number>;
+    byErrorCategory: Record<string, number>;
+    successCount: number;
+    errorCount: number;
+    timeoutCount: number;
+    errorRate: number;
+    avgDurationMs: number | null;
+    totalDurationMs: number;
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+    topErrors: Array<{
+        category: ErrorCategory;
+        count: number;
+    }>;
+    slowestCalls: Array<{
+        sequence: number;
+        toolName: string | null;
+        durationMs: number;
+    }>;
+}
+/**
+ * Compute session summary from events.
+ */
+export declare function computeSessionSummary(events: BaseEvent[], slowestCount?: number): SessionSummary;
+/**
+ * Format summary as human-readable text.
+ */
+export declare function formatSummaryText(summary: SessionSummary): string;
+/**
+ * Format a concise one-line safe summary (no content).
+ */
+export declare function formatConciseSummary(events: BaseEvent[], summary: SessionSummary): string;
+/**
+ * Format stats output for CLI.
+ */
+export declare function formatStatsText(summary: SessionSummary): string;
+//# sourceMappingURL=session-analytics.d.ts.map