claude-code-history 0.2.2

package/dist/lib/parser.js.map

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

package/dist/lib/platform.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Platform detection and path utilities for claude-code-history library.
+ */
+/**
+ * Get the default Claude Code data directory path for the current platform.
+ * @returns Absolute path to ~/.claude/ directory
+ */
+export declare function getDefaultDataPath(): string;
+/**
+ * Get the projects directory within Claude Code data.
+ * @param dataPath - Base data directory path
+ * @returns Path to projects directory
+ */
+export declare function getProjectsPath(dataPath: string): string;
+/**
+ * Encode a project path to Claude Code's directory name format.
+ * Replaces path separators with hyphens.
+ * @example
+ * encodeProjectPath('/Users/name/project') // '-Users-name-project'
+ */
+export declare function encodeProjectPath(projectPath: string): string;
+/**
+ * Decode a Claude Code encoded directory name back to a project path.
+ * @example
+ * decodeProjectPath('-Users-name-project') // '/Users/name/project'
+ */
+export declare function decodeProjectPath(encodedPath: string): string;
+/**
+ * Check if a string is a valid UUID format.
+ * @param value - String to check
+ * @returns true if the string matches UUID format
+ */
+export declare function isUUID(value: string): boolean;
+/**
+ * Extract session ID from a session filename.
+ * @param filename - Filename like 'uuid.jsonl' or 'agent-id.jsonl'
+ * @returns Session ID or null if not a valid session file
+ */
+export declare function extractSessionId(filename: string): string | null;
+/**
+ * Check if a filename is an agent session file.
+ * @param filename - Filename to check
+ */
+export declare function isAgentSessionFile(filename: string): boolean;
+/**
+ * Extract agent ID from an agent session filename.
+ * @param filename - Filename like 'agent-abc1234.jsonl'
+ * @returns Agent ID or null
+ */
+export declare function extractAgentId(filename: string): string | null;
+//# sourceMappingURL=platform.d.ts.map

package/dist/lib/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/lib/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D"}

package/dist/lib/platform.js

@@ -0,0 +1,94 @@
+/**
+ * Platform detection and path utilities for claude-code-history library.
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Get the default Claude Code data directory path for the current platform.
+ * @returns Absolute path to ~/.claude/ directory
+ */
+export function getDefaultDataPath() {
+    return join(homedir(), '.claude');
+}
+/**
+ * Get the projects directory within Claude Code data.
+ * @param dataPath - Base data directory path
+ * @returns Path to projects directory
+ */
+export function getProjectsPath(dataPath) {
+    return join(dataPath, 'projects');
+}
+/**
+ * Encode a project path to Claude Code's directory name format.
+ * Replaces path separators with hyphens.
+ * @example
+ * encodeProjectPath('/Users/name/project') // '-Users-name-project'
+ */
+export function encodeProjectPath(projectPath) {
+    // Remove trailing slashes and encode
+    const normalized = projectPath.replace(/\/+$/, '');
+    // Replace all forward slashes with hyphens
+    return normalized.replace(/\//g, '-');
+}
+/**
+ * Decode a Claude Code encoded directory name back to a project path.
+ * @example
+ * decodeProjectPath('-Users-name-project') // '/Users/name/project'
+ */
+export function decodeProjectPath(encodedPath) {
+    // Handle the leading hyphen which represents root /
+    if (encodedPath.startsWith('-')) {
+        return encodedPath.replace(/-/g, '/');
+    }
+    // Windows paths don't start with /
+    return encodedPath.replace(/-/g, '/');
+}
+/**
+ * Check if a string is a valid UUID format.
+ * @param value - String to check
+ * @returns true if the string matches UUID format
+ */
+export function isUUID(value) {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(value);
+}
+/**
+ * Extract session ID from a session filename.
+ * @param filename - Filename like 'uuid.jsonl' or 'agent-id.jsonl'
+ * @returns Session ID or null if not a valid session file
+ */
+export function extractSessionId(filename) {
+    if (!filename.endsWith('.jsonl')) {
+        return null;
+    }
+    const baseName = filename.slice(0, -6); // Remove .jsonl
+    // Check if it's an agent session
+    if (baseName.startsWith('agent-')) {
+        return baseName; // Return full 'agent-xxx' as ID
+    }
+    // Check if it's a UUID session
+    if (isUUID(baseName)) {
+        return baseName;
+    }
+    return null;
+}
+/**
+ * Check if a filename is an agent session file.
+ * @param filename - Filename to check
+ */
+export function isAgentSessionFile(filename) {
+    return filename.startsWith('agent-') && filename.endsWith('.jsonl');
+}
+/**
+ * Extract agent ID from an agent session filename.
+ * @param filename - Filename like 'agent-abc1234.jsonl'
+ * @returns Agent ID or null
+ */
+export function extractAgentId(filename) {
+    if (!isAgentSessionFile(filename)) {
+        return null;
+    }
+    // Remove 'agent-' prefix and '.jsonl' suffix
+    return filename.slice(6, -6);
+}
+//# sourceMappingURL=platform.js.map

package/dist/lib/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/lib/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,qCAAqC;IACrC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,2CAA2C;IAC3C,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,oDAAoD;IACpD,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,mCAAmC;IACnC,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,MAAM,SAAS,GAAG,iEAAiE,CAAC;IACpF,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB;IAExD,iCAAiC;IACjC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC,CAAC,gCAAgC;IACnD,CAAC;IAED,+BAA+B;IAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,6CAA6C;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/lib/search.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Search functionality for claude-code-history library.
+ *
+ * Provides text search across all sessions with context.
+ */
+import type { LibraryConfig, SearchMatch, PaginatedResult } from './types.js';
+/**
+ * Search across all sessions for a query string.
+ *
+ * Performs case-insensitive substring search across all message content.
+ * Returns matches with surrounding context lines.
+ *
+ * @param query - Search query (case-insensitive)
+ * @param config - Optional configuration for context lines and pagination
+ * @returns Paginated list of search matches
+ *
+ * @example
+ * ```typescript
+ * // Basic search
+ * const results = await searchSessions('TypeScript');
+ *
+ * // Search with more context
+ * const results = await searchSessions('error', { context: 5 });
+ *
+ * // Search in specific workspace
+ * const results = await searchSessions('bug', { workspace: '/my/project' });
+ * ```
+ */
+export declare function searchSessions(query: string, config?: LibraryConfig): Promise<PaginatedResult<SearchMatch>>;
+/**
+ * Search within a single session.
+ *
+ * @param sessionId - Session ID or index to search
+ * @param query - Search query (case-insensitive)
+ * @param config - Optional configuration
+ * @returns Array of matches within the session
+ */
+export declare function searchInSession(sessionId: string | number, query: string, config?: LibraryConfig): Promise<SearchMatch[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/lib/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAIX,eAAe,EAChB,MAAM,YAAY,CAAC;AAkKpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAmDvC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BxB"}

package/dist/lib/search.js

@@ -0,0 +1,217 @@
+/**
+ * Search functionality for claude-code-history library.
+ *
+ * Provides text search across all sessions with context.
+ */
+import { resolveConfig, paginate, createPagination } from './config.js';
+import { listSessions, getSession } from './session.js';
+// =============================================================================
+// Text Extraction
+// =============================================================================
+/**
+ * Extract searchable text from assistant content.
+ */
+function extractAssistantText(content) {
+    const texts = [];
+    for (const block of content) {
+        switch (block.type) {
+            case 'text':
+                texts.push(block.text);
+                break;
+            case 'thinking':
+                texts.push(block.thinking);
+                break;
+            case 'tool_use':
+                // Include tool name and stringified input for searchability
+                texts.push(`Tool: ${block.name}`);
+                texts.push(JSON.stringify(block.input));
+                break;
+        }
+    }
+    return texts;
+}
+/**
+ * Extract searchable text from user content.
+ */
+function extractUserText(content) {
+    if (typeof content === 'string') {
+        return [content];
+    }
+    // Tool results
+    return content.map((result) => result.content);
+}
+/**
+ * Extract all searchable text from a message.
+ */
+function extractMessageText(message) {
+    switch (message.type) {
+        case 'user':
+            return extractUserText(message.content);
+        case 'assistant':
+            return extractAssistantText(message.content);
+        case 'summary':
+            return [message.summary];
+        case 'file-history-snapshot':
+            // Not searchable
+            return [];
+    }
+}
+// =============================================================================
+// Context Extraction
+// =============================================================================
+/**
+ * Extract context lines around a match.
+ * @param text - Full text to search in
+ * @param matchIndex - Character index of match start
+ * @param contextLines - Number of lines before/after to include
+ * @returns Array of context lines and line number of match
+ */
+function extractContext(text, matchIndex, contextLines) {
+    const lines = text.split('\n');
+    let charCount = 0;
+    let matchLineIndex = 0;
+    // Find which line contains the match
+    for (let i = 0; i < lines.length; i++) {
+        const lineLength = (lines[i]?.length ?? 0) + 1; // +1 for newline
+        if (charCount + lineLength > matchIndex) {
+            matchLineIndex = i;
+            break;
+        }
+        charCount += lineLength;
+    }
+    // Extract context lines
+    const startLine = Math.max(0, matchLineIndex - contextLines);
+    const endLine = Math.min(lines.length - 1, matchLineIndex + contextLines);
+    const context = lines.slice(startLine, endLine + 1);
+    return {
+        context,
+        lineNumber: matchLineIndex + 1, // 1-based line number
+    };
+}
+// =============================================================================
+// Search Implementation
+// =============================================================================
+/**
+ * Search for matches within a single message.
+ */
+function searchInMessage(message, query, sessionId, sessionSummary, projectPath, contextLines) {
+    const matches = [];
+    const lowerQuery = query.toLowerCase();
+    // Only search user and assistant messages
+    if (message.type !== 'user' && message.type !== 'assistant') {
+        return matches;
+    }
+    const textBlocks = extractMessageText(message);
+    for (const text of textBlocks) {
+        const lowerText = text.toLowerCase();
+        let searchIndex = 0;
+        // Find all occurrences
+        while (true) {
+            const matchIndex = lowerText.indexOf(lowerQuery, searchIndex);
+            if (matchIndex === -1)
+                break;
+            // Extract the actual matched text (preserving case)
+            const matchedText = text.slice(matchIndex, matchIndex + query.length);
+            // Extract context
+            const { context, lineNumber } = extractContext(text, matchIndex, contextLines);
+            matches.push({
+                sessionId,
+                sessionSummary,
+                projectPath,
+                messageUuid: message.uuid,
+                messageType: message.type,
+                match: matchedText,
+                context,
+                lineNumber,
+            });
+            searchIndex = matchIndex + 1;
+        }
+    }
+    return matches;
+}
+/**
+ * Search across all sessions for a query string.
+ *
+ * Performs case-insensitive substring search across all message content.
+ * Returns matches with surrounding context lines.
+ *
+ * @param query - Search query (case-insensitive)
+ * @param config - Optional configuration for context lines and pagination
+ * @returns Paginated list of search matches
+ *
+ * @example
+ * ```typescript
+ * // Basic search
+ * const results = await searchSessions('TypeScript');
+ *
+ * // Search with more context
+ * const results = await searchSessions('error', { context: 5 });
+ *
+ * // Search in specific workspace
+ * const results = await searchSessions('bug', { workspace: '/my/project' });
+ * ```
+ */
+export async function searchSessions(query, config) {
+    const resolved = resolveConfig(config);
+    if (!query || query.trim().length === 0) {
+        return {
+            data: [],
+            pagination: createPagination(0, resolved),
+        };
+    }
+    const allMatches = [];
+    // Get all sessions (without pagination to search all)
+    const sessionsResult = await listSessions({
+        dataPath: resolved.dataPath,
+        workspace: resolved.workspace,
+        limit: Number.MAX_SAFE_INTEGER,
+        offset: 0,
+    });
+    // Search each session
+    for (const sessionSummary of sessionsResult.data) {
+        try {
+            const session = await getSession(sessionSummary.id, {
+                dataPath: resolved.dataPath,
+            });
+            for (const message of session.messages) {
+                const matches = searchInMessage(message, query, session.id, session.summary, session.projectPath, resolved.context);
+                allMatches.push(...matches);
+            }
+        }
+        catch {
+            // Skip sessions that fail to parse
+            continue;
+        }
+    }
+    // Apply pagination to results
+    const paginatedMatches = paginate(allMatches, resolved);
+    return {
+        data: paginatedMatches,
+        pagination: createPagination(allMatches.length, resolved),
+    };
+}
+/**
+ * Search within a single session.
+ *
+ * @param sessionId - Session ID or index to search
+ * @param query - Search query (case-insensitive)
+ * @param config - Optional configuration
+ * @returns Array of matches within the session
+ */
+export async function searchInSession(sessionId, query, config) {
+    const resolved = resolveConfig(config);
+    if (!query || query.trim().length === 0) {
+        return [];
+    }
+    const session = await getSession(sessionId, {
+        dataPath: resolved.dataPath,
+        workspace: resolved.workspace,
+    });
+    const matches = [];
+    for (const message of session.messages) {
+        const messageMatches = searchInMessage(message, query, session.id, session.summary, session.projectPath, resolved.context);
+        matches.push(...messageMatches);
+    }
+    return matches;
+}
+//# sourceMappingURL=search.js.map

package/dist/lib/search.js.map

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

package/dist/lib/session.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Session discovery and retrieval for claude-code-history library.
+ *
+ * Provides functions to list, filter, and retrieve Claude Code sessions.
+ */
+import type { LibraryConfig, SessionSummary, Session, PaginatedResult } from './types.js';
+/**
+ * List all sessions with pagination.
+ *
+ * Sessions are sorted by most recent activity first (descending timestamp).
+ * Agent sessions are excluded from the main list (they're linked via agentIds).
+ *
+ * @param config - Optional configuration for filtering and pagination
+ * @returns Paginated list of session summaries
+ *
+ * @example
+ * ```typescript
+ * // List first 10 sessions
+ * const result = await listSessions({ limit: 10 });
+ *
+ * // List sessions for a specific workspace
+ * const result = await listSessions({ workspace: '/path/to/project' });
+ *
+ * // Paginate through results
+ * const page2 = await listSessions({ limit: 10, offset: 10 });
+ * ```
+ */
+export declare function listSessions(config?: LibraryConfig): Promise<PaginatedResult<SessionSummary>>;
+/**
+ * Get a session by index or UUID.
+ *
+ * @param identifier - Zero-based index or session UUID
+ * @param config - Optional configuration
+ * @returns Full session with all messages
+ * @throws SessionNotFoundError if session doesn't exist
+ *
+ * @example
+ * ```typescript
+ * // Get most recent session by index
+ * const session = await getSession(0);
+ *
+ * // Get session by UUID
+ * const session = await getSession('abc123-def456-...');
+ *
+ * // Get session from specific workspace
+ * const session = await getSession(0, { workspace: '/path/to/project' });
+ * ```
+ */
+export declare function getSession(identifier: number | string, config?: LibraryConfig): Promise<Session>;
+/**
+ * Get an agent session by ID.
+ *
+ * @param agentId - Agent ID (e.g., 'abc1234' or 'agent-abc1234')
+ * @param config - Optional configuration
+ * @returns Full agent session with all messages
+ * @throws SessionNotFoundError if agent session doesn't exist
+ */
+export declare function getAgentSession(agentId: string, config?: LibraryConfig): Promise<Session>;
+//# sourceMappingURL=session.d.ts.map

package/dist/lib/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAW,eAAe,EAAE,MAAM,YAAY,CAAC;AAsKnG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CA4B1C;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,OAAO,CAAC,CA+DlB;AAoDD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B/F"}