@ebowwa/claudecodehistory 1.1.1

package/README.md

@@ -0,0 +1,266 @@
+# @ebowwa/claudecodehistory
+
+A TypeScript library for accessing and analyzing Claude Code conversation history with smart filtering and pagination.
+
+## Features
+
+This library provides a `ClaudeCodeHistoryService` class that offers:
+
+- **Conversation History Access** - Read Claude Code's `.jsonl` history files from `~/.claude/projects/`
+- **Smart Filtering** - Filter by date range, project, session, and message types
+- **Pagination Support** - Efficiently handle large datasets with limit/offset
+- **Timezone Intelligence** - Automatic timezone detection with manual override support
+- **Content Search** - Search conversation content across all projects
+- **TypeScript Types** - Full TypeScript support with exported types
+
+## Installation
+
+```bash
+npm install @ebowwa/claudecodehistory
+```
+
+## Quick Start
+
+```typescript
+import { ClaudeCodeHistoryService } from '@ebowwa/claudecodehistory';
+
+const service = new ClaudeCodeHistoryService();
+
+// List all projects
+const projects = await service.listProjects();
+console.log(projects);
+// [
+//   {
+//     projectPath: '/Users/username/code/my-project',
+//     sessionCount: 15,
+//     messageCount: 342,
+//     lastActivityTime: '2025-01-15T10:30:00.000Z'
+//   }
+// ]
+
+// Get conversation history with pagination
+const history = await service.getConversationHistory({
+  limit: 20,
+  offset: 0,
+  messageTypes: ['user'], // Only user messages (default)
+  timezone: 'Asia/Tokyo'
+});
+console.log(history.entries);
+console.log(history.pagination);
+// {
+//   total_count: 150,
+//   limit: 20,
+//   offset: 0,
+//   has_more: true
+// }
+
+// Search conversations
+const results = await service.searchConversations('API integration', {
+  limit: 30,
+  projectPath: '/Users/username/code/my-project',
+  startDate: '2025-01-01',
+  endDate: '2025-01-31'
+});
+```
+
+## API
+
+### `ClaudeCodeHistoryService`
+
+Main service class for accessing Claude Code history.
+
+#### Constructor
+
+```typescript
+const service = new ClaudeCodeHistoryService();
+```
+
+Automatically uses `~/.claude` as the data directory.
+
+#### Methods
+
+##### `getConversationHistory(options)`
+
+Get paginated conversation history.
+
+```typescript
+const result = await service.getConversationHistory({
+  sessionId?: string,        // Filter by specific session
+  startDate?: string,        // Start date (e.g., "2025-01-01")
+  endDate?: string,          // End date (e.g., "2025-01-31")
+  limit?: number,            // Max entries (default: 20)
+  offset?: number,           // Skip entries (default: 0)
+  messageTypes?: Array<'user' | 'assistant' | 'system' | 'result'>,
+  timezone?: string          // Timezone (e.g., "Asia/Tokyo", "UTC")
+});
+```
+
+Returns: `PaginatedConversationResponse`
+
+##### `searchConversations(query, options)`
+
+Search conversation content.
+
+```typescript
+const results = await service.searchConversations('search query', {
+  limit?: number,
+  projectPath?: string,
+  startDate?: string,
+  endDate?: string,
+  timezone?: string
+});
+```
+
+Returns: `ConversationEntry[]`
+
+##### `listProjects()`
+
+List all projects with conversation history.
+
+```typescript
+const projects = await service.listProjects();
+```
+
+Returns: `ProjectInfo[]`
+
+##### `listSessions(options)`
+
+List conversation sessions.
+
+```typescript
+const sessions = await service.listSessions({
+  projectPath?: string,
+  startDate?: string,
+  endDate?: string,
+  timezone?: string
+});
+```
+
+Returns: `SessionInfo[]`
+
+## Types
+
+```typescript
+interface ConversationEntry {
+  sessionId: string;
+  timestamp: string;
+  type: 'user' | 'assistant' | 'system' | 'result';
+  content: string;
+  projectPath: string;
+  uuid: string;
+  formattedTime?: string;
+  timeAgo?: string;
+  localDate?: string;
+  metadata?: {
+    usage?: any;
+    totalCostUsd?: number;
+    numTurns?: number;
+    durationMs?: number;
+    isError?: boolean;
+    errorType?: string;
+    model?: string;
+    requestId?: string;
+  };
+}
+
+interface PaginatedConversationResponse {
+  entries: ConversationEntry[];
+  pagination: {
+    total_count: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+  };
+}
+
+interface ProjectInfo {
+  projectPath: string;
+  sessionCount: number;
+  messageCount: number;
+  lastActivityTime: string;
+}
+
+interface SessionInfo {
+  sessionId: string;
+  projectPath: string;
+  startTime: string;
+  endTime: string;
+  messageCount: number;
+  userMessageCount: number;
+  assistantMessageCount: number;
+}
+```
+
+## Smart Features
+
+### Message Type Filtering
+
+Default behavior only returns user messages to reduce data volume:
+
+```typescript
+// Only user messages (default)
+await service.getConversationHistory();
+
+// User and assistant messages
+await service.getConversationHistory({
+  messageTypes: ['user', 'assistant']
+});
+
+// All message types
+await service.getConversationHistory({
+  messageTypes: ['user', 'assistant', 'system', 'result']
+});
+```
+
+### Timezone Support
+
+Automatic timezone detection with manual override:
+
+```typescript
+// Auto-detect system timezone
+await service.getConversationHistory();
+
+// Explicit timezone
+await service.getConversationHistory({
+  timezone: 'Asia/Tokyo'
+});
+```
+
+### Date Filtering
+
+Smart date normalization with timezone awareness:
+
+```typescript
+await service.getConversationHistory({
+  startDate: '2025-01-01',  // Automatically normalized to proper timezone bounds
+  endDate: '2025-01-31',
+  timezone: 'America/New_York'
+});
+```
+
+## Example MCP Server
+
+This repository includes an example MCP server in the `example/` directory that demonstrates how to use this library to build an MCP server.
+
+See [example/README.md](./example/README.md) for details.
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/ebowwa/claude-code-history-mcp.git
+cd claude-code-history-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+```
+
+## License
+
+MIT

package/dist/history-service.d.ts

@@ -0,0 +1,107 @@
+export interface ClaudeCodeMessage {
+    parentUuid: string | null;
+    isSidechain: boolean;
+    userType: string;
+    cwd: string;
+    sessionId: string;
+    version: string;
+    type: 'user' | 'assistant' | 'system' | 'result';
+    message?: {
+        role: string;
+        content: string | any[];
+        model?: string;
+        usage?: any;
+    };
+    uuid: string;
+    timestamp: string;
+    requestId?: string;
+}
+export interface ConversationEntry {
+    sessionId: string;
+    timestamp: string;
+    type: 'user' | 'assistant' | 'system' | 'result';
+    content: string;
+    projectPath: string;
+    uuid: string;
+    formattedTime?: string;
+    timeAgo?: string;
+    localDate?: string;
+    metadata?: {
+        usage?: any;
+        totalCostUsd?: number;
+        numTurns?: number;
+        durationMs?: number;
+        isError?: boolean;
+        errorType?: string;
+        model?: string;
+        requestId?: string;
+    };
+}
+export interface PaginatedConversationResponse {
+    entries: ConversationEntry[];
+    pagination: {
+        total_count: number;
+        limit: number;
+        offset: number;
+        has_more: boolean;
+    };
+}
+export interface HistoryQueryOptions {
+    sessionId?: string;
+    startDate?: string;
+    endDate?: string;
+    limit?: number;
+    offset?: number;
+    timezone?: string;
+    messageTypes?: ('user' | 'assistant' | 'system' | 'result')[];
+}
+export interface SessionListOptions {
+    projectPath?: string;
+    startDate?: string;
+    endDate?: string;
+    timezone?: string;
+}
+export interface ProjectInfo {
+    projectPath: string;
+    sessionCount: number;
+    messageCount: number;
+    lastActivityTime: string;
+}
+export interface SessionInfo {
+    sessionId: string;
+    projectPath: string;
+    startTime: string;
+    endTime: string;
+    messageCount: number;
+    userMessageCount: number;
+    assistantMessageCount: number;
+}
+export interface SearchOptions {
+    limit?: number;
+    projectPath?: string;
+    startDate?: string;
+    endDate?: string;
+    timezone?: string;
+}
+export declare class ClaudeCodeHistoryService {
+    private claudeDir;
+    constructor(claudeDir?: string);
+    /**
+     * Normalize date string to ISO format for proper comparison with timezone support
+     */
+    private normalizeDate;
+    getConversationHistory(options?: HistoryQueryOptions): Promise<PaginatedConversationResponse>;
+    searchConversations(searchQuery: string, options?: SearchOptions): Promise<ConversationEntry[]>;
+    listProjects(): Promise<ProjectInfo[]>;
+    listSessions(options?: SessionListOptions): Promise<SessionInfo[]>;
+    private loadClaudeHistoryEntries;
+    private parseJsonlFile;
+    private convertClaudeMessageToEntry;
+    private getTimeAgo;
+    private decodeProjectPath;
+    /**
+     * Determines whether to skip reading a file based on its modification time
+     */
+    private shouldSkipFile;
+}
+//# sourceMappingURL=history-service.d.ts.map

package/dist/history-service.d.ts.map

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

package/dist/history-service.js

@@ -0,0 +1,398 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { createReadStream } from 'fs';
+import { createInterface } from 'readline';
+export class ClaudeCodeHistoryService {
+    claudeDir;
+    constructor(claudeDir) {
+        this.claudeDir = claudeDir || path.join(os.homedir(), '.claude');
+    }
+    /**
+     * Normalize date string to ISO format for proper comparison with timezone support
+     */
+    normalizeDate(dateString, isEndDate = false, timezone) {
+        if (dateString.includes('T')) {
+            return dateString;
+        }
+        const tz = timezone || Intl.DateTimeFormat().resolvedOptions().timeZone;
+        try {
+            if (tz === 'UTC') {
+                const timeStr = isEndDate ? '23:59:59.999' : '00:00:00.000';
+                return `${dateString}T${timeStr}Z`;
+            }
+            // Correct approach: Create date in target timezone and convert to UTC
+            const [year, month, day] = dateString.split('-').map(Number);
+            const hour = isEndDate ? 23 : 0;
+            const minute = isEndDate ? 59 : 0;
+            const second = isEndDate ? 59 : 0;
+            const millisecond = isEndDate ? 999 : 0;
+            // Create a reference date to calculate offset
+            const referenceDate = new Date(year, month - 1, day, 12, 0, 0); // Use noon for stable offset
+            // Calculate timezone offset for this specific date (handles DST)
+            const offsetMs = referenceDate.getTimezoneOffset() * 60000;
+            // Create the target time in the specified timezone
+            const localTime = new Date(year, month - 1, day, hour, minute, second, millisecond);
+            // Get what this local time would be in the target timezone
+            const targetTzTime = new Date(localTime.toLocaleString('en-CA', { timeZone: tz }));
+            const utcTime = new Date(localTime.toLocaleString('en-CA', { timeZone: 'UTC' }));
+            // Calculate the difference between target timezone and UTC
+            const tzOffsetMs = targetTzTime.getTime() - utcTime.getTime();
+            // Adjust local time to get UTC equivalent
+            const utcResult = new Date(localTime.getTime() + offsetMs - tzOffsetMs);
+            const result = utcResult.toISOString();
+            console.log(`normalizeDate: ${dateString} (${isEndDate ? 'end' : 'start'}) in ${tz} -> ${result}`);
+            return result;
+        }
+        catch (error) {
+            console.warn(`Failed to process timezone ${tz}, falling back to simple conversion:`, error);
+            const fallback = `${dateString}T${isEndDate ? '23:59:59.999' : '00:00:00.000'}Z`;
+            console.log(`normalizeDate fallback: ${dateString} -> ${fallback}`);
+            return fallback;
+        }
+    }
+    async getConversationHistory(options = {}) {
+        const { sessionId, startDate, endDate, limit = 20, offset = 0, timezone, messageTypes } = options;
+        // Normalize date strings for proper comparison
+        const normalizedStartDate = startDate ? this.normalizeDate(startDate, false, timezone) : undefined;
+        const normalizedEndDate = endDate ? this.normalizeDate(endDate, true, timezone) : undefined;
+        // Determine which message types to include (default to user only to reduce data volume)
+        const allowedTypes = messageTypes && messageTypes.length > 0 ? messageTypes : ['user'];
+        // Load history from Claude Code's .jsonl files with pre-filtering
+        let allEntries = await this.loadClaudeHistoryEntries({
+            startDate: normalizedStartDate,
+            endDate: normalizedEndDate
+        });
+        // Filter by session ID if specified
+        if (sessionId) {
+            allEntries = allEntries.filter(entry => entry.sessionId === sessionId);
+        }
+        // Filter by message types (defaults to user only)
+        allEntries = allEntries.filter(entry => allowedTypes.includes(entry.type));
+        // Filter by date range if specified (additional in-memory filtering for precision)
+        if (normalizedStartDate) {
+            allEntries = allEntries.filter(entry => entry.timestamp >= normalizedStartDate);
+        }
+        if (normalizedEndDate) {
+            allEntries = allEntries.filter(entry => entry.timestamp <= normalizedEndDate);
+        }
+        // Sort by timestamp (newest first)
+        allEntries.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        // Calculate pagination
+        const totalCount = allEntries.length;
+        const paginatedEntries = allEntries.slice(offset, offset + limit);
+        const hasMore = offset + limit < totalCount;
+        return {
+            entries: paginatedEntries,
+            pagination: {
+                total_count: totalCount,
+                limit,
+                offset,
+                has_more: hasMore
+            }
+        };
+    }
+    async searchConversations(searchQuery, options = {}) {
+        const { limit = 30, projectPath, startDate, endDate, timezone } = options;
+        // Normalize date strings for proper comparison
+        const normalizedStartDate = startDate ? this.normalizeDate(startDate, false, timezone) : undefined;
+        const normalizedEndDate = endDate ? this.normalizeDate(endDate, true, timezone) : undefined;
+        const allEntries = await this.loadClaudeHistoryEntries({
+            startDate: normalizedStartDate,
+            endDate: normalizedEndDate
+        });
+        const queryLower = searchQuery.toLowerCase();
+        let matchedEntries = allEntries.filter(entry => entry.content.toLowerCase().includes(queryLower));
+        // Filter by project path if specified
+        if (projectPath) {
+            matchedEntries = matchedEntries.filter(entry => entry.projectPath === projectPath);
+        }
+        // Filter by date range if specified (additional in-memory filtering for precision)
+        if (normalizedStartDate) {
+            matchedEntries = matchedEntries.filter(entry => entry.timestamp >= normalizedStartDate);
+        }
+        if (normalizedEndDate) {
+            matchedEntries = matchedEntries.filter(entry => entry.timestamp <= normalizedEndDate);
+        }
+        matchedEntries.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        return matchedEntries.slice(0, limit);
+    }
+    async listProjects() {
+        const projects = new Map();
+        try {
+            const projectsDir = path.join(this.claudeDir, 'projects');
+            const projectDirs = await fs.readdir(projectsDir);
+            for (const projectDir of projectDirs) {
+                const projectPath = path.join(projectsDir, projectDir);
+                const stats = await fs.stat(projectPath);
+                if (stats.isDirectory()) {
+                    const files = await fs.readdir(projectPath);
+                    const decodedPath = this.decodeProjectPath(projectDir);
+                    if (!projects.has(decodedPath)) {
+                        projects.set(decodedPath, {
+                            sessionIds: new Set(),
+                            messageCount: 0,
+                            lastActivityTime: '1970-01-01T00:00:00.000Z'
+                        });
+                    }
+                    const projectInfo = projects.get(decodedPath);
+                    if (!projectInfo)
+                        continue;
+                    for (const file of files) {
+                        if (file.endsWith('.jsonl')) {
+                            const sessionId = file.replace('.jsonl', '');
+                            projectInfo.sessionIds.add(sessionId);
+                            const filePath = path.join(projectPath, file);
+                            const fileStats = await fs.stat(filePath);
+                            if (fileStats.mtime.toISOString() > projectInfo.lastActivityTime) {
+                                projectInfo.lastActivityTime = fileStats.mtime.toISOString();
+                            }
+                            // Count messages in this session
+                            const entries = await this.parseJsonlFile(filePath, projectDir);
+                            projectInfo.messageCount += entries.length;
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error listing projects:', error);
+        }
+        return Array.from(projects.entries()).map(([projectPath, info]) => ({
+            projectPath,
+            sessionCount: info.sessionIds.size,
+            messageCount: info.messageCount,
+            lastActivityTime: info.lastActivityTime
+        }));
+    }
+    async listSessions(options = {}) {
+        const { projectPath, startDate, endDate, timezone } = options;
+        // Normalize date strings for proper comparison
+        const normalizedStartDate = startDate ? this.normalizeDate(startDate, false, timezone) : undefined;
+        const normalizedEndDate = endDate ? this.normalizeDate(endDate, true, timezone) : undefined;
+        const sessions = [];
+        try {
+            const projectsDir = path.join(this.claudeDir, 'projects');
+            const projectDirs = await fs.readdir(projectsDir);
+            for (const projectDir of projectDirs) {
+                const decodedPath = this.decodeProjectPath(projectDir);
+                // Filter by project path if specified
+                if (projectPath && decodedPath !== projectPath) {
+                    continue;
+                }
+                const projectDirPath = path.join(projectsDir, projectDir);
+                const stats = await fs.stat(projectDirPath);
+                if (stats.isDirectory()) {
+                    const files = await fs.readdir(projectDirPath);
+                    for (const file of files) {
+                        if (file.endsWith('.jsonl')) {
+                            const sessionId = file.replace('.jsonl', '');
+                            const filePath = path.join(projectDirPath, file);
+                            const entries = await this.parseJsonlFile(filePath, projectDir);
+                            if (entries.length === 0)
+                                continue;
+                            const sessionStart = entries[entries.length - 1].timestamp;
+                            const sessionEnd = entries[0].timestamp;
+                            // Filter by date range if specified
+                            if (normalizedStartDate && sessionEnd < normalizedStartDate)
+                                continue;
+                            if (normalizedEndDate && sessionStart > normalizedEndDate)
+                                continue;
+                            const userMessageCount = entries.filter(e => e.type === 'user').length;
+                            const assistantMessageCount = entries.filter(e => e.type === 'assistant').length;
+                            sessions.push({
+                                sessionId,
+                                projectPath: decodedPath,
+                                startTime: sessionStart,
+                                endTime: sessionEnd,
+                                messageCount: entries.length,
+                                userMessageCount,
+                                assistantMessageCount
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error listing sessions:', error);
+        }
+        // Sort by start time (newest first)
+        sessions.sort((a, b) => new Date(b.startTime).getTime() - new Date(a.startTime).getTime());
+        return sessions;
+    }
+    async loadClaudeHistoryEntries(options = {}) {
+        const entries = [];
+        const { startDate, endDate } = options;
+        try {
+            const projectsDir = path.join(this.claudeDir, 'projects');
+            const projectDirs = await fs.readdir(projectsDir);
+            for (const projectDir of projectDirs) {
+                const projectPath = path.join(projectsDir, projectDir);
+                const stats = await fs.stat(projectPath);
+                if (stats.isDirectory()) {
+                    const files = await fs.readdir(projectPath);
+                    for (const file of files) {
+                        if (file.endsWith('.jsonl')) {
+                            const filePath = path.join(projectPath, file);
+                            // Pre-filter files based on modification time
+                            if (await this.shouldSkipFile(filePath, startDate, endDate)) {
+                                continue;
+                            }
+                            const sessionEntries = await this.parseJsonlFile(filePath, projectDir, startDate, endDate);
+                            entries.push(...sessionEntries);
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error loading Claude history:', error);
+        }
+        return entries;
+    }
+    async parseJsonlFile(filePath, projectDir, startDate, endDate) {
+        const entries = [];
+        try {
+            const fileStream = createReadStream(filePath);
+            const rl = createInterface({
+                input: fileStream,
+                crlfDelay: Infinity
+            });
+            for await (const line of rl) {
+                if (line.trim()) {
+                    try {
+                        const claudeMessage = JSON.parse(line);
+                        // Apply date filtering at message level for efficiency
+                        if (startDate && claudeMessage.timestamp < startDate) {
+                            continue;
+                        }
+                        if (endDate && claudeMessage.timestamp > endDate) {
+                            continue;
+                        }
+                        const entry = this.convertClaudeMessageToEntry(claudeMessage, projectDir);
+                        if (entry) {
+                            entries.push(entry);
+                        }
+                    }
+                    catch (parseError) {
+                        console.error('Error parsing line:', parseError);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error reading file:', filePath, error);
+        }
+        return entries;
+    }
+    convertClaudeMessageToEntry(claudeMessage, projectDir) {
+        try {
+            let content = '';
+            if (claudeMessage.message?.content) {
+                if (typeof claudeMessage.message.content === 'string') {
+                    content = claudeMessage.message.content;
+                }
+                else if (Array.isArray(claudeMessage.message.content)) {
+                    // Handle array content (e.g., from assistant messages)
+                    content = claudeMessage.message.content
+                        .map(item => {
+                        if (typeof item === 'string')
+                            return item;
+                        if (item?.type === 'text' && item?.text)
+                            return item.text;
+                        return JSON.stringify(item);
+                    })
+                        .join(' ');
+                }
+            }
+            // Decode project path from directory name
+            const projectPath = this.decodeProjectPath(projectDir);
+            // Add enhanced time information
+            const timestamp = claudeMessage.timestamp;
+            const messageDate = new Date(timestamp);
+            return {
+                sessionId: claudeMessage.sessionId,
+                timestamp,
+                type: claudeMessage.type,
+                content,
+                projectPath,
+                uuid: claudeMessage.uuid,
+                formattedTime: messageDate.toLocaleString('en-US', {
+                    timeZone: 'Asia/Tokyo',
+                    year: 'numeric',
+                    month: '2-digit',
+                    day: '2-digit',
+                    hour: '2-digit',
+                    minute: '2-digit',
+                    second: '2-digit',
+                    hour12: false
+                }),
+                timeAgo: this.getTimeAgo(messageDate),
+                localDate: messageDate.toLocaleDateString('sv-SE', { timeZone: 'Asia/Tokyo' }),
+                metadata: {
+                    usage: claudeMessage.message?.usage,
+                    model: claudeMessage.message?.model,
+                    requestId: claudeMessage.requestId
+                }
+            };
+        }
+        catch (error) {
+            console.error('Error converting Claude message:', error);
+            return null;
+        }
+    }
+    getTimeAgo(date) {
+        const now = new Date();
+        const diffMs = now.getTime() - date.getTime();
+        const diffMins = Math.floor(diffMs / (1000 * 60));
+        const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+        const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+        if (diffMins < 1)
+            return 'just now';
+        if (diffMins < 60)
+            return `${diffMins}m ago`;
+        if (diffHours < 24)
+            return `${diffHours}h ago`;
+        if (diffDays < 7)
+            return `${diffDays}d ago`;
+        if (diffDays < 30)
+            return `${Math.floor(diffDays / 7)}w ago`;
+        if (diffDays < 365)
+            return `${Math.floor(diffDays / 30)}mo ago`;
+        return `${Math.floor(diffDays / 365)}y ago`;
+    }
+    decodeProjectPath(projectDir) {
+        return projectDir.replace(/-/g, '/').replace(/^\//, '');
+    }
+    /**
+     * Determines whether to skip reading a file based on its modification time
+     */
+    async shouldSkipFile(filePath, startDate, endDate) {
+        if (!startDate && !endDate) {
+            return false; // Don't skip if no date filters are specified
+        }
+        try {
+            const fileStats = await fs.stat(filePath);
+            const fileModTime = fileStats.mtime.toISOString();
+            const fileCreateTime = fileStats.birthtime.toISOString();
+            // Get the earliest and latest possible times for file content
+            const oldestPossibleTime = fileCreateTime < fileModTime ? fileCreateTime : fileModTime;
+            const newestPossibleTime = fileModTime;
+            // If endDate is specified: skip if file's oldest time is after endDate
+            if (endDate && oldestPossibleTime > endDate) {
+                return true; // Skip
+            }
+            // If startDate is specified: skip if file's newest time is before startDate
+            if (startDate && newestPossibleTime < startDate) {
+                return true; // Skip
+            }
+            return false; // File might contain data in range, so read it
+        }
+        catch (error) {
+            console.warn(`Failed to get file stats for ${filePath}:`, error);
+            return false; // Safe fallback: read the file if stat fails
+        }
+    }
+}
+//# sourceMappingURL=history-service.js.map

package/dist/history-service.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ClaudeCodeHistoryService } from './history-service.js';
+export type { ClaudeCodeMessage, ConversationEntry, PaginatedConversationResponse, HistoryQueryOptions, SessionListOptions, ProjectInfo, SessionInfo, SearchOptions, } from './history-service.js';
+//# 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":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,6BAA6B,EAC7B,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { ClaudeCodeHistoryService } from './history-service.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ebowwa/claudecodehistory",
+  "version": "1.1.1",
+  "description": "TypeScript library for accessing and analyzing Claude Code conversation history",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.4",
+    "typescript": "^5.8.3"
+  },
+  "keywords": [
+    "claude-code",
+    "history",
+    "conversation",
+    "ai",
+    "typescript",
+    "library",
+    "analytics"
+  ],
+  "author": "ebowwa",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ebowwa/claude-code-history-mcp.git"
+  },
+  "homepage": "https://github.com/ebowwa/claude-code-history-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/ebowwa/claude-code-history-mcp/issues"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}