@abnersajr/claude-timeline 1.0.0

package/dist/context-tracker.d.ts

@@ -0,0 +1,44 @@
+import type { ContextCategory, ContextStats, Phase, RawJsonlRecord, TurnContextSnapshot } from "./types.js";
+/**
+ * Classify a record's context contribution based on type and content blocks.
+ *
+ * Priority order:
+ * 1. Compact records → "compact"
+ * 2. User meta messages with tool_result blocks → "tool-output"
+ * 3. User text/image messages → "user-message"
+ * 4. Assistant messages with tool_use → "tool-output"
+ * 5. Assistant messages with thinking → "thinking-text"
+ * 6. System messages (command output) → "system"
+ * 7. Everything else → "other"
+ */
+export declare function categorizeContext(record: RawJsonlRecord): ContextCategory;
+/**
+ * Extract input tokens from a record's usage data.
+ * Returns 0 if no usage data is present.
+ */
+export declare function getInputTokens(record: RawJsonlRecord): number;
+/**
+ * Scan records for isCompactSummary events and return Phase[].
+ * Each phase represents a contiguous segment of records between compact events.
+ * Phase 1 starts at index 0. The compact record itself is included at the end
+ * of the phase it terminates. A new phase starts after each compact record.
+ */
+export declare function detectCompactions(records: RawJsonlRecord[]): Phase[];
+/**
+ * Determine which phase a record index belongs to.
+ */
+export declare function getPhaseForIndex(recordIndex: number, phases: Phase[]): number;
+/**
+ * Compute context statistics by iterating records and categorizing each one.
+ * Tracks compaction phases and accumulates tokens by category.
+ *
+ * For now, attributes full input_tokens to the primary category of each record.
+ * Precise per-category breakdown would require content size analysis.
+ */
+export declare function computeContextStats(records: RawJsonlRecord[]): ContextStats;
+/**
+ * Convert context stats into per-turn snapshots for UI consumption.
+ * Each snapshot represents a single record's context contribution.
+ */
+export declare function getTurnSnapshots(stats: ContextStats): TurnContextSnapshot[];
+//# sourceMappingURL=context-tracker.d.ts.map

package/dist/context-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tracker.d.ts","sourceRoot":"","sources":["../src/context-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,KAAK,EACL,cAAc,EACd,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAkBnB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CA4BzE;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE7D;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,CA0BpE;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAQ7E;AAID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,YAAY,CA2C3E;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,mBAAmB,EAAE,CAQ3E"}

package/dist/context-tracker.test.d.ts

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

package/dist/context-tracker.test.d.ts.map

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

package/dist/conversation-groups.d.ts

@@ -0,0 +1,11 @@
+import type { ConversationGroup, Turn } from "./types";
+/**
+ * Build conversation groups from a flat list of turns.
+ *
+ * Grouping strategy: scan turns in order. Each turn containing a user message
+ * starts a new group. All subsequent turns (AI-only) belong to that group
+ * until the next user turn. Orphaned AI-only sequences at the start are
+ * collected into their own group.
+ */
+export declare function buildConversationGroups(turns: Turn[]): ConversationGroup[];
+//# sourceMappingURL=conversation-groups.d.ts.map

package/dist/conversation-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-groups.d.ts","sourceRoot":"","sources":["../src/conversation-groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAiC,IAAI,EAAE,MAAM,SAAS,CAAA;AAErF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,iBAAiB,EAAE,CAmE1E"}

package/dist/conversation-groups.test.d.ts

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

package/dist/conversation-groups.test.d.ts.map

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

package/dist/cost-stream-capture.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Stdin JSON parser and batch capture for Claude Code cost data.
+ *
+ * Usage:
+ *   - Real-time: pipe Claude Code's stdin to this module
+ *   - Batch: cost-stream-capture.ts --batch <file>
+ */
+import { CostStreamDb } from "./cost-stream-db.js";
+export interface StdinCostData {
+    sessionId: string;
+    timestamp: string;
+    totalCostUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    model: string | null;
+    durationMs: number | null;
+    apiDurationMs: number | null;
+    linesAdded: number;
+    linesRemoved: number;
+    rawJson?: string;
+}
+/**
+ * Parse a single stdin JSON line into StdinCostData.
+ * Returns null if the line doesn't contain cost data.
+ */
+export declare function parseStdinCostJson(line: string, sessionId?: string): StdinCostData | null;
+/**
+ * Start capturing cost data from stdin in real-time.
+ * Writes to cost-stream.db as data arrives.
+ *
+ * Returns a cleanup function to stop capture.
+ */
+export declare function startStdinCapture(dbPath?: string, sessionId?: string): {
+    stop: () => void;
+    db: CostStreamDb;
+};
+/**
+ * Process a saved stdin log file in batch mode.
+ * Each line is expected to be a JSON object with cost data.
+ */
+export declare function batchCapture(filePath: string, dbPath?: string): Promise<{
+    processed: number;
+    skipped: number;
+}>;
+//# sourceMappingURL=cost-stream-capture.d.ts.map

package/dist/cost-stream-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-stream-capture.d.ts","sourceRoot":"","sources":["../src/cost-stream-capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,YAAY,EAAuB,MAAM,qBAAqB,CAAA;AAIvE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwDzF;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,IAAI,CAAC;IAAC,EAAE,EAAE,YAAY,CAAA;CAAE,CAsCxC;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyCjD"}

package/dist/cost-stream-db.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SQLite CRUD layer for cost-stream.db
+ *
+ * Stores ground-truth cost data from Claude Code's stdin stream.
+ * This is separate from usage.db (which is read-only and owned by Claude Code).
+ */
+export interface CostSnapshotRow {
+    id: number;
+    session_id: string;
+    timestamp: string;
+    total_cost_usd: number;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_creation_tokens: number;
+    model: string | null;
+    duration_ms: number | null;
+    api_duration_ms: number | null;
+    lines_added: number;
+    lines_removed: number;
+    raw_json: string | null;
+    created_at: string;
+}
+export interface SessionCostSummaryRow {
+    session_id: string;
+    total_cost_usd: number;
+    model: string | null;
+    snapshot_count: number;
+    first_snapshot_at: string | null;
+    last_snapshot_at: string | null;
+    updated_at: string;
+}
+export declare class CostStreamDb {
+    private db;
+    constructor(dbPath: string);
+    /**
+     * Insert a cost snapshot from stdin data.
+     * Returns the snapshot ID.
+     */
+    insertSnapshot(data: {
+        sessionId: string;
+        timestamp: string;
+        totalCostUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheCreationTokens: number;
+        model: string | null;
+        durationMs: number | null;
+        apiDurationMs: number | null;
+        linesAdded: number;
+        linesRemoved: number;
+        rawJson?: string;
+    }): number;
+    /**
+     * Get the latest cost summary for a session.
+     */
+    getCostSummary(sessionId: string): SessionCostSummaryRow | undefined;
+    /**
+     * Get the latest cost snapshot for a session.
+     */
+    getLatestSnapshot(sessionId: string): CostSnapshotRow | undefined;
+    /**
+     * Get all cost snapshots for a session (for time-series).
+     */
+    getSnapshots(sessionId: string, limit?: number): CostSnapshotRow[];
+    /**
+     * Check if a session has cost-stream data.
+     */
+    hasCostData(sessionId: string): boolean;
+    /**
+     * Get cost summaries for multiple sessions in one query.
+     * Returns a Map of sessionId → total_cost_usd.
+     */
+    getCostSummariesForSessions(sessionIds: string[]): Map<string, number>;
+    /**
+     * Get all session IDs with cost data.
+     */
+    getSessionIds(): string[];
+    close(): void;
+}
+/**
+ * Get the default path for cost-stream.db
+ * Priority: customPath > ~/.claude-timeline/cost-stream.db
+ */
+export declare function getCostStreamDbPath(customPath?: string): string;
+//# sourceMappingURL=cost-stream-db.d.ts.map

package/dist/cost-stream-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-stream-db.d.ts","sourceRoot":"","sources":["../src/cost-stream-db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2CH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAmB;gBAEjB,MAAM,EAAE,MAAM;IAa1B;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,eAAe,EAAE,MAAM,CAAA;QACvB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,UAAU,EAAE,MAAM,CAAA;QAClB,YAAY,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,GAAG,MAAM;IAuDV;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAMpE;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAQjE;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,eAAe,EAAE;IAQhE;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAOvC;;;OAGG;IACH,2BAA2B,CACzB,UAAU,EAAE,MAAM,EAAE,GACnB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAoBtB;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAOzB,KAAK,IAAI,IAAI;CAGd;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/cost-stream-merger.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Merge cost-stream data into the extraction pipeline.
+ *
+ * This module provides functions to enrich SessionPricing with ground-truth
+ * cost data from the cost-stream.db, preserving both estimated and API streams.
+ */
+import type { FullTimelineSession, SessionPricing } from "./types.js";
+/** Cost-stream enrichment result */
+export interface CostStreamEnrichment {
+    totalCostUsd: number;
+    snapshotCount: number;
+    firstSnapshotAt: string | null;
+    lastSnapshotAt: string | null;
+    model: string | null;
+}
+/**
+ * Get cost-stream enrichment for a session.
+ * Returns null if no cost-stream data exists.
+ */
+export declare function getCostEnrichment(costStreamDbPath: string, sessionId: string): CostStreamEnrichment | null;
+/**
+ * Build SessionPricing using both cost streams.
+ *
+ * - Estimated stream (from JSONL × pricing rates) is always preserved
+ * - API stream (from cost-stream.db) is added when available
+ * - totalCost prefers API when available, falls back to estimated
+ */
+export declare function buildSessionPricing(estimatedPricing: SessionPricing, enrichment: CostStreamEnrichment | null): SessionPricing;
+/**
+ * Enrich a FullTimelineSession with cost-stream data.
+ *
+ * This is the main merge function. It:
+ * 1. Gets cost-stream data (if available)
+ * 2. Sets both estimated and API cost streams
+ * 3. Marks the cost source
+ */
+export declare function enrichTimelineWithCostStream(timeline: FullTimelineSession, costStreamDbPath: string): FullTimelineSession;
+//# sourceMappingURL=cost-stream-merger.d.ts.map

package/dist/cost-stream-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-stream-merger.d.ts","sourceRoot":"","sources":["../src/cost-stream-merger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAA;AAInB,oCAAoC;AACpC,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,IAAI,CAgB7B;AAID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,cAAc,EAChC,UAAU,EAAE,oBAAoB,GAAG,IAAI,GACtC,cAAc,CAwBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,mBAAmB,EAC7B,gBAAgB,EAAE,MAAM,GACvB,mBAAmB,CA2BrB"}