heyiam 0.1.0

package/dist/parsers/claude.js

@@ -0,0 +1,265 @@
+import { readFile } from "node:fs/promises";
+/**
+ * Parse a Claude Code .jsonl session file into structured analysis.
+ *
+ * Claude Code sessions are newline-delimited JSON with entry types:
+ *   - user: user messages (may contain tool_result content blocks)
+ *   - assistant: model responses (text, thinking, tool_use blocks)
+ *   - system: metadata (subtypes: turn_duration, api_error, compact_boundary, etc.)
+ *   - progress: hook/streaming progress events
+ *   - file-history-snapshot, agent-name, custom-title, last-prompt, queue-operation
+ *
+ * Tool calls appear as { type: "tool_use", id, name, input } content blocks
+ * inside assistant messages. Tool results appear as { type: "tool_result" }
+ * blocks inside subsequent user messages.
+ */
+function parseEntries(raw) {
+    const entries = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return entries;
+}
+function isToolUseBlock(block) {
+    return block.type === "tool_use";
+}
+function getContentBlocks(entry) {
+    const content = entry.message?.content;
+    if (!content || typeof content === "string")
+        return [];
+    return content;
+}
+function extractToolCalls(entries) {
+    const calls = [];
+    for (const entry of entries) {
+        if (entry.type !== "assistant")
+            continue;
+        for (const block of getContentBlocks(entry)) {
+            if (isToolUseBlock(block)) {
+                calls.push({
+                    id: block.id,
+                    name: block.name,
+                    input: block.input,
+                });
+            }
+        }
+    }
+    return calls;
+}
+function extractFilesTouched(toolCalls) {
+    const files = new Set();
+    for (const call of toolCalls) {
+        const input = call.input;
+        switch (call.name) {
+            case "Read":
+            case "Write":
+                if (typeof input.file_path === "string")
+                    files.add(input.file_path);
+                break;
+            case "Edit":
+                if (typeof input.file_path === "string")
+                    files.add(input.file_path);
+                break;
+            case "Glob":
+            case "Grep":
+                if (typeof input.path === "string")
+                    files.add(input.path);
+                break;
+        }
+    }
+    return [...files].sort();
+}
+function countTurns(entries) {
+    let turns = 0;
+    let lastRole = null;
+    for (const entry of entries) {
+        if (entry.type === "user" || entry.type === "assistant") {
+            const role = entry.type;
+            // A turn is a user→assistant exchange. Count each time we see
+            // an assistant message following a user message (directly or
+            // with intervening system/progress entries).
+            if (role === "assistant" && lastRole === "user") {
+                turns++;
+            }
+            lastRole = role;
+        }
+    }
+    return turns;
+}
+/** Max gap between consecutive entries before it's considered a break (5 min). */
+const IDLE_THRESHOLD_MS = 5 * 60 * 1000;
+function computeDuration(entries) {
+    const timestamps = [];
+    let startStr = null;
+    let endStr = null;
+    for (const entry of entries) {
+        if (!entry.timestamp)
+            continue;
+        if (!startStr)
+            startStr = entry.timestamp;
+        endStr = entry.timestamp;
+        timestamps.push(new Date(entry.timestamp).getTime());
+    }
+    if (timestamps.length < 2 || !startStr || !endStr) {
+        return { duration_ms: 0, wall_clock_ms: 0, start_time: startStr, end_time: endStr };
+    }
+    const wallClock = timestamps[timestamps.length - 1] - timestamps[0];
+    // Sum only active segments (gaps under threshold)
+    let activeMs = 0;
+    for (let i = 1; i < timestamps.length; i++) {
+        const gap = timestamps[i] - timestamps[i - 1];
+        if (gap < IDLE_THRESHOLD_MS) {
+            activeMs += gap;
+        }
+    }
+    return {
+        duration_ms: Math.max(activeMs, 0),
+        wall_clock_ms: Math.max(wallClock, 0),
+        start_time: startStr,
+        end_time: endStr,
+    };
+}
+export function computeLocStats(entries) {
+    const toolCalls = extractToolCalls(entries);
+    let totalAdded = 0;
+    let totalRemoved = 0;
+    const filesChanged = new Set();
+    // Track last-write line counts per file for dedup
+    const writeLineCounts = new Map();
+    for (const call of toolCalls) {
+        if (call.name === "Write") {
+            const filePath = call.input.file_path;
+            const content = call.input.content;
+            if (typeof filePath !== "string" || typeof content !== "string")
+                continue;
+            const lines = content.split("\n").length;
+            const prevLines = writeLineCounts.get(filePath) ?? 0;
+            if (writeLineCounts.has(filePath)) {
+                // Overwrite: remove previous count, add new
+                totalAdded -= prevLines;
+                totalAdded += lines;
+            }
+            else {
+                totalAdded += lines;
+            }
+            writeLineCounts.set(filePath, lines);
+            filesChanged.add(filePath);
+        }
+        else if (call.name === "Edit") {
+            const filePath = call.input.file_path;
+            const oldStr = call.input.old_string;
+            const newStr = call.input.new_string;
+            if (typeof filePath !== "string")
+                continue;
+            const oldLines = typeof oldStr === "string" ? oldStr.split("\n").length : 0;
+            const newLines = typeof newStr === "string" ? newStr.split("\n").length : 0;
+            totalAdded += newLines;
+            totalRemoved += oldLines;
+            filesChanged.add(filePath);
+        }
+    }
+    return {
+        loc_added: totalAdded,
+        loc_removed: totalRemoved,
+        loc_net: totalAdded - totalRemoved,
+        files_changed: [...filesChanged].sort(),
+    };
+}
+async function detect(path) {
+    // Claude Code session files are .jsonl in ~/.claude/projects/
+    if (!path.endsWith(".jsonl"))
+        return false;
+    try {
+        const raw = await readFile(path, "utf-8");
+        const firstLine = raw.split("\n")[0];
+        if (!firstLine)
+            return false;
+        const entry = JSON.parse(firstLine);
+        // Claude sessions have sessionId, type, and typically version fields
+        return (typeof entry.sessionId === "string" &&
+            typeof entry.type === "string" &&
+            typeof entry.version === "string");
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Map subagent_type values from Agent tool calls to display roles.
+ * Teamrc agent names like "trc-frontend-dev" get the prefix stripped.
+ * Built-in types like "Explore" or "Plan" are lowercased.
+ */
+export function mapAgentRole(subagentType) {
+    if (subagentType.startsWith("trc-")) {
+        return subagentType.slice(4); // "trc-frontend-dev" → "frontend-dev"
+    }
+    return subagentType.toLowerCase(); // "Explore" → "explore"
+}
+/**
+ * Extract agent roles from parent's Agent tool calls.
+ * Returns a map of tool_use id → agentRole for matching with child sessions.
+ */
+export function extractAgentRoles(entries) {
+    const roles = new Map();
+    for (const entry of entries) {
+        if (entry.type !== "assistant")
+            continue;
+        for (const block of getContentBlocks(entry)) {
+            if (isToolUseBlock(block) && block.name === "Agent") {
+                const subagentType = block.input.subagent_type;
+                if (typeof subagentType === "string") {
+                    roles.set(block.id, mapAgentRole(subagentType));
+                }
+            }
+        }
+    }
+    return roles;
+}
+/**
+ * Extract the agentId from a child session's first entry (fallback role detection).
+ */
+export function extractAgentIdFromEntries(entries) {
+    for (const entry of entries) {
+        if (entry.agentId)
+            return entry.agentId;
+    }
+    return undefined;
+}
+async function parse(path) {
+    const raw = await readFile(path, "utf-8");
+    const entries = parseEntries(raw);
+    const toolCalls = extractToolCalls(entries);
+    const filesTouched = extractFilesTouched(toolCalls);
+    const turns = countTurns(entries);
+    const { duration_ms, wall_clock_ms, start_time, end_time } = computeDuration(entries);
+    const loc_stats = computeLocStats(entries);
+    // Extract cwd from the first entry that has it
+    const cwd = entries.find((e) => e.cwd)?.cwd;
+    return {
+        source: "claude",
+        turns,
+        tool_calls: toolCalls,
+        files_touched: filesTouched,
+        duration_ms,
+        wall_clock_ms,
+        loc_stats,
+        raw_entries: entries,
+        start_time,
+        end_time,
+        cwd,
+    };
+}
+export const claudeParser = {
+    name: "claude",
+    detect,
+    parse,
+};
+//# sourceMappingURL=claude.js.map

package/dist/parsers/claude.js.map

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

package/dist/parsers/index.d.ts

@@ -0,0 +1,28 @@
+import type { SessionAnalysis } from "./types.js";
+export type { SessionAnalysis, SessionParser, SessionSource, ToolCall, LocStats, RawEntry } from "./types.js";
+/** Detect which parser handles a given file and parse it */
+export declare function parseSession(path: string): Promise<SessionAnalysis>;
+export interface SessionMeta {
+    path: string;
+    source: string;
+    sessionId: string;
+    /** The top-level project directory name (e.g., "-Users-ben-Dev-myapp") */
+    projectDir: string;
+    /** Whether this is a subagent session */
+    isSubagent: boolean;
+    parentSessionId?: string;
+    agentRole?: string;
+    children?: SessionMeta[];
+}
+/** Scan for all Claude Code session files under a base path.
+ *
+ * Claude Code stores sessions as:
+ *   ~/.claude/projects/{encoded-path}/{uuid}.jsonl                  ← main sessions
+ *   ~/.claude/projects/{encoded-path}/{uuid}/subagents/{id}.jsonl   ← subagent sessions
+ *
+ * Children are linked to parents by matching the directory name ({uuid}/)
+ * to the parent's session file ({uuid}.jsonl). By default, only parent
+ * sessions are returned at the top level; children are nested in the
+ * parent's `children` array.
+ */
+export declare function listSessions(basePath?: string): Promise<SessionMeta[]>;

package/dist/parsers/index.js

@@ -0,0 +1,124 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { claudeParser, mapAgentRole } from "./claude.js";
+const parsers = [claudeParser];
+/** Detect which parser handles a given file and parse it */
+export async function parseSession(path) {
+    for (const parser of parsers) {
+        if (await parser.detect(path)) {
+            return parser.parse(path);
+        }
+    }
+    throw new Error(`No parser detected for: ${path}`);
+}
+/** Scan for all Claude Code session files under a base path.
+ *
+ * Claude Code stores sessions as:
+ *   ~/.claude/projects/{encoded-path}/{uuid}.jsonl                  ← main sessions
+ *   ~/.claude/projects/{encoded-path}/{uuid}/subagents/{id}.jsonl   ← subagent sessions
+ *
+ * Children are linked to parents by matching the directory name ({uuid}/)
+ * to the parent's session file ({uuid}.jsonl). By default, only parent
+ * sessions are returned at the top level; children are nested in the
+ * parent's `children` array.
+ */
+export async function listSessions(basePath) {
+    const base = basePath ?? join(homedir(), ".claude", "projects");
+    const parents = [];
+    const childrenByParentId = new Map();
+    let projectDirs;
+    try {
+        projectDirs = await readdir(base, { withFileTypes: true });
+    }
+    catch {
+        return parents;
+    }
+    for (const projectEntry of projectDirs) {
+        if (!projectEntry.isDirectory())
+            continue;
+        const projectPath = join(base, projectEntry.name);
+        const projectDir = projectEntry.name;
+        let files;
+        try {
+            files = await readdir(projectPath, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            if (file.name.endsWith(".jsonl") && !file.isDirectory()) {
+                // Main session file
+                const fullPath = join(projectPath, file.name);
+                const sessionId = file.name.replace(/\.jsonl$/, "");
+                await tryAddSession(fullPath, sessionId, projectDir, false, parents);
+            }
+            else if (file.isDirectory()) {
+                // Directory name is the parent session UUID
+                const parentSessionId = file.name;
+                const children = await collectSubagents(join(projectPath, file.name), projectDir, parentSessionId);
+                if (children.length > 0) {
+                    const existing = childrenByParentId.get(parentSessionId) ?? [];
+                    existing.push(...children);
+                    childrenByParentId.set(parentSessionId, existing);
+                }
+            }
+        }
+    }
+    // Link children to parents
+    for (const parent of parents) {
+        const children = childrenByParentId.get(parent.sessionId);
+        if (children && children.length > 0) {
+            parent.children = children;
+        }
+    }
+    return parents;
+}
+async function collectSubagents(sessionDataDir, projectDir, parentSessionId) {
+    const subagentsDir = join(sessionDataDir, "subagents");
+    const children = [];
+    let files;
+    try {
+        files = await readdir(subagentsDir, { withFileTypes: true });
+    }
+    catch {
+        return children; // No subagents directory
+    }
+    for (const file of files) {
+        if (!file.name.endsWith(".jsonl") || file.isDirectory())
+            continue;
+        const fullPath = join(subagentsDir, file.name);
+        const sessionId = file.name.replace(/\.jsonl$/, "");
+        // Try to read .meta.json for agent type/role
+        const metaPath = join(subagentsDir, file.name.replace(/\.jsonl$/, ".meta.json"));
+        let agentRole;
+        try {
+            const metaRaw = await readFile(metaPath, "utf-8");
+            const meta = JSON.parse(metaRaw);
+            if (meta.agentType) {
+                agentRole = mapAgentRole(meta.agentType);
+            }
+        }
+        catch {
+            // No meta.json or malformed — role will be undefined
+        }
+        await tryAddSession(fullPath, sessionId, projectDir, true, children, parentSessionId, agentRole);
+    }
+    return children;
+}
+async function tryAddSession(fullPath, sessionId, projectDir, isSubagent, out, parentSessionId, agentRole) {
+    for (const parser of parsers) {
+        if (await parser.detect(fullPath)) {
+            const meta = { path: fullPath, source: parser.name, sessionId, projectDir, isSubagent };
+            if (parentSessionId) {
+                meta.parentSessionId = parentSessionId;
+            }
+            if (agentRole) {
+                meta.agentRole = agentRole;
+            }
+            out.push(meta);
+            break;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

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

package/dist/parsers/types.d.ts

@@ -0,0 +1,81 @@
+export type SessionSource = "claude" | "cursor" | "codex" | "gemini" | "antigravity";
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface LocStats {
+    loc_added: number;
+    loc_removed: number;
+    loc_net: number;
+    files_changed: string[];
+}
+export interface SessionAnalysis {
+    source: SessionSource;
+    turns: number;
+    tool_calls: ToolCall[];
+    files_touched: string[];
+    /** Active time — excludes idle gaps > 5 min */
+    duration_ms: number;
+    /** Wall-clock time — first to last timestamp */
+    wall_clock_ms: number;
+    loc_stats: LocStats;
+    raw_entries: RawEntry[];
+    start_time: string | null;
+    end_time: string | null;
+    agent_role?: string;
+    parent_session_id?: string | null;
+    /** Working directory where the session was started */
+    cwd?: string;
+}
+/** Minimal shape of a JSONL entry from Claude Code sessions */
+export interface RawEntry {
+    type: string;
+    uuid: string;
+    timestamp: string;
+    sessionId: string;
+    message?: {
+        role?: string;
+        content?: string | ContentBlock[];
+        model?: string;
+        id?: string;
+        usage?: Record<string, unknown>;
+    };
+    subtype?: string;
+    durationMs?: number;
+    parentUuid?: string | null;
+    isSidechain?: boolean;
+    cwd?: string;
+    version?: string;
+    gitBranch?: string;
+    agentId?: string;
+}
+export type ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock | ImageBlock;
+export interface TextBlock {
+    type: "text";
+    text: string;
+}
+export interface ThinkingBlock {
+    type: "thinking";
+    thinking: string;
+}
+export interface ToolUseBlock {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultBlock {
+    type: "tool_result";
+    tool_use_id: string;
+    content?: unknown;
+}
+export interface ImageBlock {
+    type: "image";
+    source: Record<string, unknown>;
+}
+export interface SessionParser {
+    name: string;
+    detect(path: string): Promise<boolean>;
+    parse(path: string): Promise<SessionAnalysis>;
+}

package/dist/parsers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/parsers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parsers/types.ts"],"names":[],"mappings":""}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import type { Server } from 'node:http';
+export declare function createApp(sessionsBasePath?: string): import("express-serve-static-core").Express;
+export declare function startServer(port?: number): Promise<Server>;