@abnersajr/claude-timeline 1.0.0

package/dist/session-state.d.ts

@@ -0,0 +1,19 @@
+import type { RawJsonlRecord } from "./types";
+/**
+ * Detect whether a session is ongoing (AI still working) vs completed.
+ *
+ * Algorithm:
+ * 1. Classify each record into an activity type
+ * 2. Find the last ending event (text_output or interruption)
+ * 3. Check if any AI activities exist after that ending event
+ * 4. If AI activities exist after the last ending event → ongoing
+ * 5. If no AI activities after last ending event → completed
+ * 6. If no ending events exist → not ongoing (empty or all AI activities)
+ *
+ * Special case: interruption is always treated as an ending event,
+ * and no AI activities are expected to follow it in practice.
+ */
+export declare function detectSessionState(records: RawJsonlRecord[]): {
+    isOngoing: boolean;
+};
+//# sourceMappingURL=session-state.d.ts.map

package/dist/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../src/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAkE7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CA8BpF"}

package/dist/session-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-state.test.d.ts.map

package/dist/session-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.test.d.ts","sourceRoot":"","sources":["../src/session-state.test.ts"],"names":[],"mappings":""}

package/dist/subagent-locator.d.ts

@@ -0,0 +1,30 @@
+import type { SubagentFile } from "./types";
+/**
+ * List subagent files for a session.
+ * Scans two directory structures:
+ * - New nested: {projectsDir}/{project}/{session}/subagents/agent-{id}.jsonl
+ * - Legacy flat: {projectsDir}/{project}/agent-{id}.jsonl (filtered by sessionId)
+ *
+ * Returns NEW structure files first, then legacy flat files.
+ */
+export declare function listSubagentFiles(projectsDir: string, projectName: string, sessionId: string): SubagentFile[];
+/**
+ * Check if a session has any subagent files.
+ * Fast check — returns true if at least one subagent file exists.
+ */
+export declare function hasSubagents(projectsDir: string, projectName: string, sessionId: string): boolean;
+/**
+ * Extract agent ID from filename.
+ * e.g., "agent-abc123.jsonl" → "abc123"
+ */
+export declare function extractAgentId(filename: string): string | null;
+/**
+ * Check if agent ID belongs to a compact agent (starts with "acompact").
+ */
+export declare function isCompactAgent(agentId: string): boolean;
+/**
+ * Check if a legacy subagent file belongs to a specific session.
+ * Reads the first line to check the sessionId field.
+ */
+export declare function subagentBelongsToSession(filePath: string, sessionId: string): boolean;
+//# sourceMappingURL=subagent-locator.d.ts.map

package/dist/subagent-locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-locator.d.ts","sourceRoot":"","sources":["../src/subagent-locator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,YAAY,EAAE,CAgEhB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAkDT;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAarF"}

package/dist/subagent-locator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subagent-locator.test.d.ts.map

package/dist/subagent-locator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-locator.test.d.ts","sourceRoot":"","sources":["../src/subagent-locator.test.ts"],"names":[],"mappings":""}

package/dist/subagent-resolver.d.ts

@@ -0,0 +1,35 @@
+import type { Message, RawJsonlRecord, Subagent, SubagentFile, TokenUsage, ToolCall } from "./types";
+/**
+ * Result of parsing a subagent JSONL file.
+ */
+interface SubagentParseResult {
+    records: RawJsonlRecord[];
+    messages: Message[];
+    toolCalls: ToolCall[];
+    description: string;
+    agentType?: string;
+    model?: string;
+    totalTokens: TokenUsage;
+}
+/**
+ * Resolve subagents from discovered files.
+ * Links subagents to parent Task calls with 3-phase linking:
+ *   Phase 1: agentId matching (from Task tool result JSON)
+ *   Phase 2: description matching (fuzzy match on taskDescription)
+ *   Phase 3: positional fallback (unmatched Task calls in order)
+ *
+ * Also detects parallel execution and aggregates tokens.
+ */
+export declare function resolveSubagents(subagentFiles: SubagentFile[], parentToolCalls: ToolCall[]): Subagent[];
+/**
+ * Parse a subagent JSONL file into structured data.
+ * Returns null if file doesn't exist or is empty.
+ */
+export declare function parseSubagentFile(filePath: string): SubagentParseResult | null;
+/**
+ * Check if a subagent is a warmup agent.
+ * Warmup agents have first user message === "Warmup".
+ */
+export declare function isWarmupAgent(records: RawJsonlRecord[]): boolean;
+export { extractAgentId, isCompactAgent } from "./subagent-locator";
+//# sourceMappingURL=subagent-resolver.d.ts.map

package/dist/subagent-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-resolver.d.ts","sourceRoot":"","sources":["../src/subagent-resolver.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,OAAO,EAEP,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,QAAQ,EAGT,MAAM,SAAS,CAAA;AAQhB;;GAEG;AACH,UAAU,mBAAmB;IAC3B,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,UAAU,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,YAAY,EAAE,EAC7B,eAAe,EAAE,QAAQ,EAAE,GAC1B,QAAQ,EAAE,CA+FZ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CA2I9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAKhE;AA0KD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/subagent-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subagent-resolver.test.d.ts.map

package/dist/subagent-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-resolver.test.d.ts","sourceRoot":"","sources":["../src/subagent-resolver.test.ts"],"names":[],"mappings":""}

package/dist/tool-extraction.d.ts

@@ -0,0 +1,34 @@
+import type { ToolCall } from "./types";
+/**
+ * Extract tool calls from assistant message content.
+ * Filters tool_use blocks and identifies Task tools specially.
+ */
+export declare function extractToolCalls(content: Array<Record<string, unknown>> | string, timestamp?: string): ToolCall[];
+/**
+ * Extract tool results from user message content.
+ * Filters tool_result blocks from content array.
+ */
+export declare function extractToolResults(content: Array<Record<string, unknown>> | string): ToolResult[];
+/**
+ * Raw tool result extracted from message content.
+ */
+export interface ToolResult {
+    toolUseId: string;
+    content: unknown;
+    isError?: boolean;
+}
+/**
+ * Link tool results to tool calls by toolUseId.
+ * Sets result string and isError flag on matched calls.
+ * Returns a new array (does not mutate input).
+ */
+export declare function linkToolResults(calls: ToolCall[], results: ToolResult[]): ToolCall[];
+/**
+ * Format tool result content into a readable string.
+ * Handles:
+ * - stdout/stderr (command execution results)
+ * - questions/answers (interactive prompts)
+ * - generic JSON (everything else)
+ */
+export declare function formatToolResult(content: unknown): string;
+//# sourceMappingURL=tool-extraction.d.ts.map

package/dist/tool-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-extraction.d.ts","sourceRoot":"","sources":["../src/tool-extraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,EAChD,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,EAAE,CAiCZ;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,UAAU,EAAE,CAejG;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,CAkBpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA4BzD"}

package/dist/tool-extraction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-extraction.test.d.ts.map

package/dist/tool-extraction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-extraction.test.d.ts","sourceRoot":"","sources":["../src/tool-extraction.test.ts"],"names":[],"mappings":""}

package/dist/tool-matcher.d.ts

@@ -0,0 +1,35 @@
+import type { RawJsonlRecord, ToolCall, ToolExecution } from "./types";
+/**
+ * Collect tool calls from raw JSONL messages.
+ * Extracts tool_use blocks from assistant messages.
+ */
+export declare function collectToolCalls(rawMessages: RawJsonlRecord[]): ToolCall[];
+/**
+ * Match tool calls to their results and compute timing.
+ *
+ * Matching strategy:
+ * 1. Primary: Match by sourceToolUseID (in tool result metadata)
+ * 2. Fallback: Match by parentUuid (user message → assistant message)
+ * 3. Fallback: Match by toolResults array (positional)
+ */
+export declare function matchToolCalls(toolCalls: ToolCall[], toolResults: Map<string, {
+    result: string;
+    isError: boolean;
+    timestamp: string;
+}>): ToolExecution[];
+/**
+ * Build a map of tool results from raw JSONL records.
+ * Keys by toolUseId from toolUseResult metadata.
+ */
+export declare function buildToolResultMap(rawMessages: Array<{
+    type: string;
+    uuid?: string;
+    parentUuid?: string;
+    toolUseResult?: Record<string, unknown>;
+    timestamp?: string;
+}>): Map<string, {
+    result: string;
+    isError: boolean;
+    timestamp: string;
+}>;
+//# sourceMappingURL=tool-matcher.d.ts.map

package/dist/tool-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-matcher.d.ts","sourceRoot":"","sources":["../src/tool-matcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEtE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,QAAQ,EAAE,CAW1E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GAChF,aAAa,EAAE,CAkCjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,KAAK,CAAC;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAC,GACD,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBtE"}

package/dist/types.d.ts

@@ -0,0 +1,272 @@
+/** Message category from the 5-category cascade */
+export type MessageCategory = "user" | "assistant" | "system" | "compact" | "hardNoise";
+/** A message paired with its classified category */
+export interface ClassifiedMessage {
+    record: RawJsonlRecord;
+    category: MessageCategory;
+}
+/** Per-turn token counts */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreation5mTokens: number;
+    cacheCreation1hTokens: number;
+    /** Fallback total cache creation (optional) */
+    cacheCreationTokens?: number;
+}
+/** Raw JSONL record from session file (internal use) */
+export interface RawJsonlRecord {
+    type: string;
+    timestamp?: string;
+    uuid?: string;
+    parentUuid?: string;
+    requestId?: string;
+    isMeta?: boolean;
+    isSidechain?: boolean;
+    isCompactSummary?: boolean;
+    agentId?: string;
+    sourceToolUseID?: string;
+    message?: {
+        role: string;
+        content: Array<Record<string, unknown>> | string;
+        model?: string;
+        usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            cache_read_input_tokens?: number;
+            cache_creation_input_tokens?: number;
+            cache_creation?: {
+                ephemeral_5m_input_tokens?: number;
+                ephemeral_1h_input_tokens?: number;
+            };
+            cacheCreation5mTokens?: number;
+            cacheCreation1hTokens?: number;
+        };
+    };
+    toolUseResult?: {
+        toolUseId: string;
+        content: unknown;
+        isError?: boolean;
+    };
+    attachment?: {
+        type: string;
+        hookName?: string;
+        toolUseID?: string;
+        stdout?: string;
+        [key: string]: unknown;
+    };
+}
+/** Text content block */
+export interface TextContent {
+    type: "text";
+    text: string;
+}
+/** Tool use content block */
+export interface ToolUseContent {
+    type: "tool_use";
+    name: string;
+    input: Record<string, unknown>;
+    toolUseId: string;
+}
+/** Tool result content block */
+export interface ToolResultContent {
+    type: "tool_result";
+    toolUseId: string;
+    content: unknown;
+    isError?: boolean;
+}
+/** Union of all message content types */
+export type MessageContent = TextContent | ToolUseContent | ToolResultContent;
+/** Normalized message */
+export interface Message {
+    type: "assistant" | "user" | "system";
+    timestamp?: string;
+    content: MessageContent[];
+}
+/** Extracted tool invocation */
+export interface ToolCall {
+    toolUseId: string;
+    name: string;
+    input: Record<string, unknown>;
+    result?: string;
+    isError?: boolean;
+    timestamp?: string;
+    /** Whether this tool call is a Task (subagent spawn) */
+    isTask: boolean;
+    /** Description of the task, extracted from Task tool input */
+    taskDescription?: string;
+    /** Subagent type, extracted from Task tool input */
+    taskSubagentType?: string;
+    /** Rewritten command from a PreToolUse hook (e.g. RTK proxy) */
+    hookRewrite?: {
+        command: string;
+    };
+}
+/** Single API call record */
+export interface Turn {
+    timestamp: string;
+    tokenUsage: TokenUsage;
+    toolName?: string;
+    cwd?: string;
+    /** Model used for this specific turn (detected from assistant message). Falls back to session-level model when undefined. */
+    model?: string;
+    messages: Message[];
+    toolCalls: ToolCall[];
+    cacheWriteType: "5m" | "1h" | "none";
+    cacheReadType: "5m" | "1h" | "5m-fallback" | "unknown";
+    cacheCreationTokensThisTurn: number;
+}
+/** Session-level info from SQLite */
+export interface SessionMetadata {
+    sessionId: string;
+    projectName: string;
+    model: string;
+    commandExecuted?: string;
+    workingDirectory: string;
+    turnCount: number;
+    totalTokens: TokenUsage;
+    startTime: string;
+    endTime: string;
+    isOngoing: boolean;
+    activeDurationMs?: number;
+    costCaptureAvailable?: boolean;
+}
+/** Model pricing config */
+export interface PricingRate {
+    model: string;
+    inputPerMTok: number;
+    outputPerMTok: number;
+    cacheReadPerMTok: number;
+    cacheWritePerMTok: number;
+}
+/** Cached pricing file structure */
+export interface PricingFile {
+    fetchedAt: string;
+    models: Record<string, PricingRate>;
+}
+/** Per-turn cost breakdown */
+export interface TurnPricing {
+    inputCost: number;
+    outputCost: number;
+    cacheReadCost: number;
+    cacheWriteCost: number;
+    totalCost: number;
+}
+/** Session-level pricing */
+export interface SessionPricing {
+    estimatedTotalCost: number;
+    turnsPricing: TurnPricing[];
+    apiTotalCost: number | null;
+    apiSnapshotCount: number;
+    apiLastSnapshotAt: string | null;
+    totalCost: number;
+    costSource: "api" | "estimated";
+    modelBreakdown: Record<string, {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheCreationTokens: number;
+        cost: number;
+        turnCount: number;
+    }>;
+    pricingRate: PricingRate;
+}
+/** Matched tool call with result and timing */
+export interface ToolExecution {
+    toolCall: ToolCall;
+    result?: string;
+    isError?: boolean;
+    durationMs: number;
+    startTime: string;
+    endTime: string;
+}
+/** Discovered subagent file */
+export interface SubagentFile {
+    /** Absolute path to the JSONL file */
+    filePath: string;
+    /** Agent ID extracted from filename (e.g., "abc123" from "agent-abc123.jsonl") */
+    agentId: string;
+    /** Whether this file is from the NEW nested structure */
+    isNewStructure: boolean;
+}
+/** Subagent session */
+export interface Subagent {
+    id: string;
+    parentTaskId: string;
+    description: string;
+    startTime: string;
+    endTime: string;
+    turnCount: number;
+    status: "completed" | "failed" | "pending";
+    isParallel: boolean;
+    /** Model used by the subagent */
+    model?: string;
+    /** Agent type from meta.json (e.g. "Explore", "general-purpose") */
+    agentType?: string;
+    /** Aggregated token usage (request-id deduplicated) */
+    totalTokens?: TokenUsage;
+    /** Total calculated cost in USD */
+    totalCost?: number;
+    /** Index in the parent session's turns array (for inline placement) */
+    parentTurnIndex?: number;
+    /** Messages from the subagent session */
+    messages?: Message[];
+    /** Tool calls from the subagent session */
+    toolCalls?: ToolCall[];
+}
+/** Conversation group: user message + all AI responses until next user message */
+export interface ConversationGroup {
+    id: string;
+    userMessage?: Message;
+    aiResponses: Message[];
+    toolExecutions: ToolCall[];
+    processIds: string[];
+    startTime: string;
+    endTime: string;
+    durationMs: number;
+    tokenUsage: TokenUsage;
+    totalCost: number;
+}
+/** Final output shape */
+export interface FullTimelineSession {
+    session: SessionMetadata;
+    turns: Turn[];
+    pricing: SessionPricing;
+    contextStats?: ContextStats;
+    subagents?: Subagent[];
+    conversationGroups?: ConversationGroup[];
+}
+/** Context categories for token tracking */
+export type ContextCategory = "user-message" | "tool-output" | "thinking-text" | "system" | "compact" | "other";
+/** A compaction phase in the session (bounded by compact events) */
+export interface Phase {
+    phaseNumber: number;
+    startRecordIndex: number;
+    endRecordIndex: number;
+}
+/** A single context injection record tracking what consumed tokens */
+export interface ContextInjection {
+    recordIndex: number;
+    category: ContextCategory;
+    inputTokens: number;
+    timestamp?: string;
+    phaseNumber: number;
+}
+/** Per-turn context snapshot */
+export interface TurnContextSnapshot {
+    recordIndex: number;
+    category: ContextCategory;
+    inputTokens: number;
+    phaseNumber: number;
+    timestamp?: string;
+}
+/** Session-level context statistics */
+export interface ContextStats {
+    injections: ContextInjection[];
+    tokensByCategory: Record<ContextCategory, number>;
+    totalInputTokens: number;
+    phaseCount: number;
+    phases: Phase[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Get the path to usage.db
+ * Priority: customPath > CLAUDE_CONFIG_DIR env > ~/.claude
+ */
+export declare function getDbPath(customPath?: string): string;
+/**
+ * Get the path to the projects directory
+ * Priority: customPath > CLAUDE_CONFIG_DIR env > ~/.claude
+ */
+export declare function getProjectsDir(customPath?: string): string;
+/**
+ * Encode project name for directory lookup
+ * Replaces all '/' with '-' (e.g., '/Users/test' → '-Users-test')
+ */
+export declare function encodeProjectName(projectName: string): string;
+/**
+ * Resolve the path to a session's JSONL file
+ * Tries multiple encodings to handle DB storing project_name with or without leading '/'
+ */
+export declare function resolveSessionJsonlPath(session: {
+    projectName: string;
+    sessionId: string;
+}, projectsDir: string): string | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACnD,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAyBf"}