npm - claude-session-viewer - Versions diffs - 0.3.2 → 0.3.4 - Mend

claude-session-viewer 0.3.2 → 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/dist/client/assets/index-DvK33tag.css +1 -0
package/dist/client/assets/{index-cY4kqyQm.js → index-KEbXAXOS.js} +15 -15
package/dist/client/index.html +2 -2
package/dist/server/claude/config.js +36 -0
package/dist/server/claude/projects/repository.js +40 -0
package/dist/server/claude/projects/service.js +41 -0
package/dist/server/claude/sessions/agentMapping.js +100 -0
package/dist/server/claude/sessions/agents.js +100 -0
package/dist/server/claude/sessions/filters.js +23 -0
package/dist/server/claude/sessions/repository.js +33 -0
package/dist/server/claude/sessions/service.js +86 -0
package/dist/server/claude/sessions/title.js +52 -0
package/dist/server/constants.js +11 -0
package/dist/server/index.js +6 -782
package/dist/server/routes/sessions.js +95 -0
package/dist/server/routes/statistics.js +328 -0
package/dist/server/shared/constants.js +11 -0
package/dist/server/types.js +1 -0
package/dist/server/utils/jsonl.js +12 -0
package/dist/server/utils/text.js +34 -0
package/dist/server/utils/tokenStats.js +66 -0
package/package.json +1 -1
package/dist/client/assets/index-i0yZUese.css +0 -1

package/dist/client/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Claude Session Viewer</title>
-    <script type="module" crossorigin src="/assets/index-cY4kqyQm.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-i0yZUese.css">
+    <script type="module" crossorigin src="/assets/index-KEbXAXOS.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DvK33tag.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/server/claude/config.js ADDED Viewed

@@ -0,0 +1,36 @@
+/**
+ * Claude API configuration
+ * Model pricing and related settings
+ */
+// Claude API Pricing (as of January 2025)
+// Prices per 1M tokens
+export const PRICING = {
+    'claude-sonnet-4-5-20250929': {
+        input: 3.0,
+        output: 15.0,
+        cacheCreation: 3.75,
+        cacheRead: 0.30
+    },
+    'claude-sonnet-4-20250514': {
+        input: 3.0,
+        output: 15.0,
+        cacheCreation: 3.75,
+        cacheRead: 0.30
+    },
+    'claude-opus-4-20250514': {
+        input: 15.0,
+        output: 75.0,
+        cacheCreation: 18.75,
+        cacheRead: 1.50
+    },
+    'claude-haiku-4-20250515': {
+        input: 0.80,
+        output: 4.0,
+        cacheCreation: 1.0,
+        cacheRead: 0.08
+    }
+};
+// Default pricing model
+export const DEFAULT_PRICING_MODEL = 'claude-sonnet-4-5-20250929';
+// Weekday names for statistics
+export const WEEKDAY_NAMES = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];

package/dist/server/claude/projects/repository.js ADDED Viewed

@@ -0,0 +1,40 @@
+import { readdir, stat } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+/**
+ * Project file system operations
+ * Handles reading project directories from ~/.claude/projects
+ */
+/**
+ * List all project directories
+ */
+export async function listProjects(projectsDir) {
+    const entries = await readdir(projectsDir);
+    const projects = [];
+    for (const entry of entries) {
+        const entryPath = join(projectsDir, entry);
+        const entryStat = await stat(entryPath);
+        if (entryStat.isDirectory()) {
+            projects.push(entry);
+        }
+    }
+    return projects;
+}
+/**
+ * Get project path from project name
+ */
+export function getProjectPath(projectsDir, projectName) {
+    return join(projectsDir, projectName);
+}
+/**
+ * Remove user's home directory prefix from project directory name
+ * e.g., "-Users-hanyeol-Projects-foo" → "Projects-foo"
+ */
+export function getProjectDisplayName(projectDirName) {
+    const userHomePath = homedir().split('/').filter(Boolean).join('-');
+    const prefix = `-${userHomePath}-`;
+    if (projectDirName.startsWith(prefix)) {
+        return projectDirName.slice(prefix.length);
+    }
+    return projectDirName;
+}

package/dist/server/claude/projects/service.js ADDED Viewed

@@ -0,0 +1,41 @@
+import { stat } from 'fs/promises';
+import { join } from 'path';
+import { listProjects, getProjectDisplayName } from './repository.js';
+import { getProjectSessions, sortSessionsByTimestamp } from '../sessions/service.js';
+/**
+ * Project service
+ * Orchestrates project and session loading
+ */
+/**
+ * Sort project groups by last activity (most recent first)
+ */
+export function sortProjectsByActivity(projects) {
+    return projects.sort((a, b) => new Date(b.lastActivity).getTime() - new Date(a.lastActivity).getTime());
+}
+/**
+ * Load all projects with their sessions
+ */
+export async function getAllProjectsWithSessions(projectsDir) {
+    const projects = await listProjects(projectsDir);
+    const projectGroups = [];
+    for (const project of projects) {
+        const projectPath = join(projectsDir, project);
+        const projectStat = await stat(projectPath);
+        if (projectStat.isDirectory()) {
+            const sessions = await getProjectSessions(projectPath);
+            if (sessions.length > 0) {
+                sortSessionsByTimestamp(sessions);
+                const displayName = getProjectDisplayName(project);
+                projectGroups.push({
+                    name: project,
+                    displayName,
+                    sessionCount: sessions.length,
+                    lastActivity: sessions[0].timestamp,
+                    sessions
+                });
+            }
+        }
+    }
+    sortProjectsByActivity(projectGroups);
+    return projectGroups;
+}

package/dist/server/claude/sessions/agentMapping.js ADDED Viewed

@@ -0,0 +1,100 @@
+/**
+ * Agent session mapping logic
+ * Handles the relationship between parent sessions and agent (Task) sessions
+ */
+/**
+ * Collect agent session IDs and their descriptions from Task tool uses
+ */
+export function collectAgentDescriptions(messages) {
+    const agentDescriptions = new Map();
+    const toolUseDescriptions = new Map();
+    const toolResultAgentIds = new Map();
+    // First pass: collect Task tool uses and their descriptions
+    for (const msg of messages) {
+        if (msg.type === 'assistant' && msg.message?.content && Array.isArray(msg.message.content)) {
+            for (const item of msg.message.content) {
+                if (item.type === 'tool_use' && item.name === 'Task' && item.input?.description) {
+                    toolUseDescriptions.set(item.id, item.input.description);
+                }
+            }
+        }
+        // Collect agent IDs from tool results
+        const agentId = msg.agentId || msg.toolUseResult?.agentId;
+        if (agentId && msg.message?.content && Array.isArray(msg.message.content)) {
+            for (const item of msg.message.content) {
+                if (item.type === 'tool_result' && item.tool_use_id) {
+                    toolResultAgentIds.set(item.tool_use_id, agentId);
+                }
+            }
+        }
+    }
+    // Second pass: map tool uses to agent IDs
+    for (const [toolUseId, description] of toolUseDescriptions.entries()) {
+        const agentId = toolResultAgentIds.get(toolUseId);
+        if (agentId) {
+            agentDescriptions.set(`agent-${agentId}`, description);
+        }
+    }
+    return agentDescriptions;
+}
+/**
+ * Attach agent sessions to a parent session
+ */
+export function attachAgentSessionsToParent(session, agentDescriptions, agentSessionsMap) {
+    if (agentDescriptions.size === 0)
+        return;
+    session.agentSessions = [];
+    for (const [agentSessionId, description] of agentDescriptions) {
+        const agentSession = agentSessionsMap.get(agentSessionId);
+        if (agentSession) {
+            agentSession.title = description;
+            session.agentSessions.push(agentSession);
+        }
+    }
+    // Sort by timestamp (chronological order)
+    session.agentSessions.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+}
+/**
+ * Find agent title from parent session messages
+ */
+export function findAgentTitleFromParentMessages(messages, agentId) {
+    const agentDescriptions = collectAgentDescriptions(messages);
+    return agentDescriptions.get(`agent-${agentId}`) || null;
+}
+/**
+ * Inject agentId into Task tool_use content for display
+ */
+export function injectAgentIdsIntoMessages(messages) {
+    const toolUseToAgentId = new Map();
+    // Build mapping from tool_use_id to agentId
+    for (const msg of messages) {
+        const agentId = msg.agentId || msg.toolUseResult?.agentId;
+        const content = msg.message?.content;
+        if (!agentId || !Array.isArray(content))
+            continue;
+        for (const item of content) {
+            if (item.type === 'tool_result' && item.tool_use_id) {
+                toolUseToAgentId.set(item.tool_use_id, agentId);
+            }
+        }
+    }
+    // Inject agentId into tool_use items
+    return messages.map((msg) => {
+        const content = msg.message?.content;
+        if (!Array.isArray(content))
+            return msg;
+        const updatedContent = content.map((item) => {
+            if (item.type !== 'tool_use' || item.name !== 'Task' || !item.id)
+                return item;
+            const agentId = toolUseToAgentId.get(item.id);
+            return agentId ? { ...item, agentId } : item;
+        });
+        return {
+            ...msg,
+            message: {
+                ...msg.message,
+                content: updatedContent
+            }
+        };
+    });
+}

package/dist/server/claude/sessions/agents.js ADDED Viewed

@@ -0,0 +1,100 @@
+/**
+ * Agent session mapping logic
+ * Handles the relationship between parent sessions and agent (Task) sessions
+ */
+/**
+ * Collect agent session IDs and their descriptions from Task tool uses
+ */
+export function collectAgentDescriptions(messages) {
+    const agentDescriptions = new Map();
+    const toolUseDescriptions = new Map();
+    const toolResultAgentIds = new Map();
+    // First pass: collect Task tool uses and their descriptions
+    for (const msg of messages) {
+        if (msg.type === 'assistant' && msg.message?.content && Array.isArray(msg.message.content)) {
+            for (const item of msg.message.content) {
+                if (item.type === 'tool_use' && item.name === 'Task' && item.input?.description) {
+                    toolUseDescriptions.set(item.id, item.input.description);
+                }
+            }
+        }
+        // Collect agent IDs from tool results
+        const agentId = msg.agentId || msg.toolUseResult?.agentId;
+        if (agentId && msg.message?.content && Array.isArray(msg.message.content)) {
+            for (const item of msg.message.content) {
+                if (item.type === 'tool_result' && item.tool_use_id) {
+                    toolResultAgentIds.set(item.tool_use_id, agentId);
+                }
+            }
+        }
+    }
+    // Second pass: map tool uses to agent IDs
+    for (const [toolUseId, description] of toolUseDescriptions.entries()) {
+        const agentId = toolResultAgentIds.get(toolUseId);
+        if (agentId) {
+            agentDescriptions.set(`agent-${agentId}`, description);
+        }
+    }
+    return agentDescriptions;
+}
+/**
+ * Attach agent sessions to a parent session
+ */
+export function attachAgentSessionsToParent(session, agentDescriptions, agentSessionsMap) {
+    if (agentDescriptions.size === 0)
+        return;
+    session.agentSessions = [];
+    for (const [agentSessionId, description] of agentDescriptions) {
+        const agentSession = agentSessionsMap.get(agentSessionId);
+        if (agentSession) {
+            agentSession.title = description;
+            session.agentSessions.push(agentSession);
+        }
+    }
+    // Sort by timestamp (chronological order)
+    session.agentSessions.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+}
+/**
+ * Find agent title from parent session messages
+ */
+export function findAgentTitleFromParentMessages(messages, agentId) {
+    const agentDescriptions = collectAgentDescriptions(messages);
+    return agentDescriptions.get(`agent-${agentId}`) || null;
+}
+/**
+ * Inject agentId into Task tool_use content for display
+ */
+export function injectAgentIdsIntoMessages(messages) {
+    const toolUseToAgentId = new Map();
+    // Build mapping from tool_use_id to agentId
+    for (const msg of messages) {
+        const agentId = msg.agentId || msg.toolUseResult?.agentId;
+        const content = msg.message?.content;
+        if (!agentId || !Array.isArray(content))
+            continue;
+        for (const item of content) {
+            if (item.type === 'tool_result' && item.tool_use_id) {
+                toolUseToAgentId.set(item.tool_use_id, agentId);
+            }
+        }
+    }
+    // Inject agentId into tool_use items
+    return messages.map((msg) => {
+        const content = msg.message?.content;
+        if (!Array.isArray(content))
+            return msg;
+        const updatedContent = content.map((item) => {
+            if (item.type !== 'tool_use' || item.name !== 'Task' || !item.id)
+                return item;
+            const agentId = toolUseToAgentId.get(item.id);
+            return agentId ? { ...item, agentId } : item;
+        });
+        return {
+            ...msg,
+            message: {
+                ...msg.message,
+                content: updatedContent
+            }
+        };
+    });
+}

package/dist/server/claude/sessions/filters.js ADDED Viewed

@@ -0,0 +1,23 @@
+/**
+ * Session filtering rules
+ * Business logic for determining which sessions to include/exclude
+ */
+/**
+ * Check if a session should be skipped
+ * Rule: Sessions with only 1 assistant message are skipped
+ */
+export function shouldSkipSession(messages) {
+    return messages.length === 1 && messages[0].type === 'assistant';
+}
+/**
+ * Check if a session ID represents an agent session
+ */
+export function isAgentSession(sessionId) {
+    return sessionId.startsWith('agent-');
+}
+/**
+ * Check if a file is empty
+ */
+export function isEmptyFile(fileSize) {
+    return fileSize === 0;
+}

package/dist/server/claude/sessions/repository.js ADDED Viewed

@@ -0,0 +1,33 @@
+import { readdir, stat } from 'fs/promises';
+import { join } from 'path';
+import { parseJsonl } from '../../utils/jsonl.js';
+/**
+ * Read a session file and return parsed messages with metadata
+ */
+export async function readSessionFile(filePath) {
+    const messages = await parseJsonl(filePath);
+    const fileStat = await stat(filePath);
+    return {
+        messages,
+        timestamp: fileStat.mtime.toISOString()
+    };
+}
+/**
+ * List all session files in a project directory
+ */
+export async function listSessionFiles(projectPath) {
+    const files = await readdir(projectPath);
+    const sessionFiles = [];
+    for (const file of files) {
+        if (file.endsWith('.jsonl')) {
+            const filePath = join(projectPath, file);
+            const fileStat = await stat(filePath);
+            sessionFiles.push({
+                filename: file,
+                size: fileStat.size,
+                path: filePath
+            });
+        }
+    }
+    return sessionFiles;
+}

package/dist/server/claude/sessions/service.js ADDED Viewed

@@ -0,0 +1,86 @@
+import { join } from 'path';
+import { listSessionFiles, readSessionFile } from './repository.js';
+import { shouldSkipSession, isAgentSession, isEmptyFile } from './filters.js';
+import { extractSessionTitle } from './title.js';
+import { collectAgentDescriptions, attachAgentSessionsToParent } from './agents.js';
+import { getProjectDisplayName } from '../projects/repository.js';
+/**
+ * Session service
+ * Orchestrates session loading, filtering, and organization
+ */
+/**
+ * Sort sessions by timestamp (most recent first)
+ */
+export function sortSessionsByTimestamp(sessions) {
+    return sessions.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+}
+/**
+ * Load all sessions from a project directory
+ */
+export async function getProjectSessions(projectPath) {
+    const sessionFiles = await listSessionFiles(projectPath);
+    const allSessions = [];
+    const agentSessionsMap = new Map();
+    const projectName = getProjectDisplayName(projectPath.split('/').pop() || 'unknown');
+    // First pass: load all sessions
+    for (const { filename, size, path } of sessionFiles) {
+        if (isEmptyFile(size))
+            continue;
+        const sessionId = filename.replace('.jsonl', '');
+        try {
+            const { messages, timestamp } = await readSessionFile(path);
+            if (shouldSkipSession(messages))
+                continue;
+            const session = {
+                id: sessionId,
+                project: projectName,
+                timestamp,
+                messages,
+                messageCount: messages.length,
+                title: extractSessionTitle(messages),
+                isAgent: isAgentSession(sessionId)
+            };
+            if (session.isAgent) {
+                agentSessionsMap.set(sessionId, session);
+            }
+            else {
+                allSessions.push(session);
+            }
+        }
+        catch (error) {
+            console.error(`Error parsing ${filename}:`, error);
+        }
+    }
+    // Second pass: attach agent sessions to parents
+    for (const session of allSessions) {
+        const agentDescriptions = collectAgentDescriptions(session.messages);
+        attachAgentSessionsToParent(session, agentDescriptions, agentSessionsMap);
+    }
+    return allSessions;
+}
+/**
+ * Load agent sessions from files
+ */
+export async function loadAgentSessionsFromFiles(projectPath, projectName, agentDescriptions) {
+    const agentSessions = [];
+    for (const [agentSessionId, description] of agentDescriptions) {
+        const agentFile = join(projectPath, `${agentSessionId}.jsonl`);
+        try {
+            const { messages, timestamp } = await readSessionFile(agentFile);
+            agentSessions.push({
+                id: agentSessionId,
+                project: projectName,
+                timestamp,
+                messages,
+                messageCount: messages.length,
+                title: description,
+                isAgent: true
+            });
+        }
+        catch {
+            // Skip if file not found
+        }
+    }
+    agentSessions.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    return agentSessions;
+}

package/dist/server/claude/sessions/title.js ADDED Viewed

@@ -0,0 +1,52 @@
+import { cleanText } from '../../utils/text.js';
+import { MAX_TITLE_LENGTH } from '../../constants.js';
+/**
+ * Session title extraction rules
+ * Business logic for extracting meaningful titles from session messages
+ */
+/**
+ * Extract first text content from message content (array or string)
+ */
+function extractFirstText(content) {
+    if (Array.isArray(content)) {
+        for (const item of content) {
+            if (item.type === 'text' && item.text) {
+                const cleaned = cleanText(item.text);
+                if (cleaned)
+                    return cleaned;
+            }
+        }
+        return null;
+    }
+    if (typeof content === 'string') {
+        const cleaned = cleanText(content);
+        return cleaned || null;
+    }
+    return null;
+}
+/**
+ * Extract session title from messages
+ * Priority 1: queue-operation / enqueue message
+ * Priority 2: first user message
+ */
+export function extractSessionTitle(messages) {
+    // Priority 1: queue-operation / enqueue message
+    for (const msg of messages) {
+        if (msg.type === 'queue-operation' && msg.operation === 'enqueue' && msg.content) {
+            const firstText = extractFirstText(msg.content);
+            if (firstText) {
+                return firstText.substring(0, MAX_TITLE_LENGTH).trim();
+            }
+        }
+    }
+    // Priority 2: first user message
+    for (const msg of messages) {
+        if (msg.type === 'user' && msg.message?.content) {
+            const firstText = extractFirstText(msg.message.content);
+            if (firstText) {
+                return firstText.substring(0, MAX_TITLE_LENGTH).trim();
+            }
+        }
+    }
+    return 'Untitled Session';
+}

package/dist/server/constants.js ADDED Viewed

@@ -0,0 +1,11 @@
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Project-specific constants
+ */
+// Directory paths
+export const CLAUDE_DIR = join(homedir(), '.claude');
+// Server configuration
+export const DEFAULT_PORT = 9090;
+// Session configuration
+export const MAX_TITLE_LENGTH = 100;