@jacques-ai/core 0.0.7-alpha.1

package/dist/session/parser.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Session Parser
+ *
+ * Parses Claude Code JSONL session files.
+ * Entry types:
+ *   - assistant: Main Claude response
+ *   - progress: Sub-agent activity
+ *   - queue-operation: User input queued
+ *   - system: System events (turn duration)
+ *   - summary: Auto-generated session summary
+ *   - file-history-snapshot: File state tracking (skipped)
+ */
+export interface RawAssistantEntry {
+    type: "assistant";
+    uuid: string;
+    parentUuid?: string;
+    timestamp: string;
+    sessionId: string;
+    model?: string;
+    message: {
+        id: string;
+        type: "message";
+        role: "assistant";
+        content: ContentBlock[];
+        model?: string;
+        stop_reason?: string;
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+        };
+    };
+    costUSD?: number;
+    durationMs?: number;
+}
+export interface ContentBlock {
+    type: "text" | "tool_use" | "tool_result" | "thinking";
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+    content?: string | ContentBlock[];
+    thinking?: string;
+    signature?: string;
+}
+export interface RawProgressEntry {
+    type: "progress";
+    uuid: string;
+    parentUuid?: string;
+    timestamp: string;
+    sessionId: string;
+    event?: string;
+    content?: Record<string, unknown>;
+    toolUseID?: string;
+    parentToolUseID?: string;
+    data?: {
+        type?: string;
+        hookEvent?: string;
+        hookName?: string;
+        command?: string;
+        message?: {
+            type: "user" | "assistant";
+            message: {
+                role: string;
+                content: unknown[];
+            };
+            uuid: string;
+            timestamp: string;
+        };
+        prompt?: string;
+        agentId?: string;
+        output?: string;
+        fullOutput?: string;
+        elapsedTimeSeconds?: number;
+        totalLines?: number;
+        status?: string;
+        serverName?: string;
+        toolName?: string;
+        query?: string;
+        resultCount?: number;
+    };
+}
+/**
+ * Task tool call info for linking to agent_progress entries
+ */
+export interface TaskToolInfo {
+    toolUseId: string;
+    subagentType: string;
+    description?: string;
+    prompt?: string;
+}
+export interface RawQueueOperationEntry {
+    type: "queue-operation";
+    uuid: string;
+    timestamp: string;
+    sessionId: string;
+    operation?: string;
+    message?: {
+        role: "user";
+        content: string | ContentBlock[];
+    };
+}
+export interface RawUserEntry {
+    type: "user";
+    uuid: string;
+    parentUuid?: string;
+    timestamp: string;
+    sessionId: string;
+    message: {
+        role: "user";
+        content: string | ContentBlock[];
+    };
+}
+export interface RawSystemEntry {
+    type: "system";
+    uuid: string;
+    timestamp: string;
+    sessionId: string;
+    subtype?: string;
+    event?: string;
+    durationMs?: number;
+    data?: {
+        turnDurationMs?: number;
+        totalCostUSD?: number;
+        [key: string]: unknown;
+    };
+}
+export interface RawSummaryEntry {
+    type: "summary";
+    uuid: string;
+    timestamp: string;
+    sessionId: string;
+    summary?: string;
+    model?: string;
+    version?: string;
+}
+export interface RawFileHistoryEntry {
+    type: "file-history-snapshot";
+    uuid: string;
+    timestamp: string;
+    [key: string]: unknown;
+}
+export type RawEntry = RawAssistantEntry | RawProgressEntry | RawQueueOperationEntry | RawUserEntry | RawSystemEntry | RawSummaryEntry | RawFileHistoryEntry | {
+    type: string;
+    [key: string]: unknown;
+};
+export type ParsedEntryType = "user_message" | "assistant_message" | "tool_call" | "tool_result" | "hook_progress" | "agent_progress" | "bash_progress" | "mcp_progress" | "web_search" | "turn_duration" | "system_event" | "summary" | "skip";
+export interface ParsedEntry {
+    type: ParsedEntryType;
+    uuid: string;
+    parentUuid: string | null;
+    timestamp: string;
+    sessionId: string;
+    slug?: string;
+    content: ParsedContent;
+}
+export interface ParsedContent {
+    text?: string;
+    thinking?: string;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    toolUseId?: string;
+    toolResultId?: string;
+    toolResultContent?: string;
+    toolUseResult?: Record<string, unknown>;
+    eventType?: string;
+    eventData?: Record<string, unknown>;
+    summary?: string;
+    hookEvent?: string;
+    hookName?: string;
+    hookCommand?: string;
+    agentPrompt?: string;
+    agentId?: string;
+    agentMessageType?: "user" | "assistant";
+    agentMessageContent?: unknown[];
+    agentType?: string;
+    agentDescription?: string;
+    bashOutput?: string;
+    bashFullOutput?: string;
+    bashElapsedSeconds?: number;
+    bashTotalLines?: number;
+    mcpStatus?: string;
+    mcpServerName?: string;
+    mcpToolName?: string;
+    searchType?: "query" | "results";
+    searchQuery?: string;
+    searchResultCount?: number;
+    searchUrls?: Array<{
+        title: string;
+        url: string;
+    }>;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheCreation?: number;
+        cacheRead?: number;
+    };
+    costUSD?: number;
+    durationMs?: number;
+    model?: string;
+}
+/**
+ * Context for parsing - tracks Task tool calls for linking to agent_progress
+ */
+export interface ParseContext {
+    /** Map of tool_use ID to Task tool info */
+    taskCalls: Map<string, TaskToolInfo>;
+    /** Map of WebSearch tool_use ID to search URLs from results */
+    webSearchResults: Map<string, Array<{
+        title: string;
+        url: string;
+    }>>;
+}
+/**
+ * Parse a JSONL file and return categorized entries.
+ */
+export declare function parseJSONL(filePath: string): Promise<ParsedEntry[]>;
+/**
+ * Parse JSONL content string and return categorized entries.
+ */
+export declare function parseJSONLContent(content: string): ParsedEntry[];
+/**
+ * Categorize a raw entry into a normalized ParsedEntry.
+ * @param entry Raw entry from JSONL
+ * @param context Optional parse context with Task calls and WebSearch results
+ */
+export declare function categorizeEntry(entry: RawEntry, context?: ParseContext): ParsedEntry;
+/**
+ * Get statistics from parsed entries.
+ *
+ * Token stats have two perspectives:
+ * - Cumulative totals (totalInputTokens, etc.): Sum across all turns - useful for billing/cost
+ * - Last turn tokens (lastInputTokens, etc.): From the final turn - represents actual context window size
+ *
+ * Note: Claude Code JSONL files do NOT accurately record output_tokens (always shows 1-4).
+ * We estimate output tokens from actual text content length using ~4 chars/token.
+ */
+export declare function getEntryStatistics(entries: ParsedEntry[]): {
+    totalEntries: number;
+    userMessages: number;
+    assistantMessages: number;
+    toolCalls: number;
+    hookEvents: number;
+    agentCalls: number;
+    bashProgress: number;
+    mcpCalls: number;
+    webSearches: number;
+    systemEvents: number;
+    summaries: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalOutputTokensEstimated: number;
+    totalCacheCreation: number;
+    totalCacheRead: number;
+    lastInputTokens: number;
+    lastOutputTokens: number;
+    lastCacheCreation: number;
+    lastCacheRead: number;
+    totalCostUSD: number;
+    totalDurationMs: number;
+    turnCount: number;
+};
+//# sourceMappingURL=parser.d.ts.map

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

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