claudecode-omc 4.3.4

package/dist/analytics/tokscale-adapter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * TokScale Adapter Module
+ *
+ * Provides a centralized adapter for @tokscale/core with graceful fallback
+ * when the native module is unavailable. This enables optional high-performance
+ * token counting and pricing lookup while maintaining compatibility in all environments.
+ */
+import { ModelPricing } from './types.js';
+/**
+ * Interface for the tokscale adapter - wraps tokscale's native API
+ */
+export interface TokscaleAdapter {
+    /** Whether tokscale native module is available */
+    isAvailable: boolean;
+    /** Get unified report from tokscale - wraps parseLocalSources + finalizeReport */
+    getReport?: () => Promise<TokscaleReport>;
+    /** Look up pricing for a model from tokscale's database */
+    lookupPricing?: (modelName: string) => Promise<ModelPricing | null>;
+    /** Version of the tokscale native module */
+    version?: string;
+}
+/**
+ * Unified report from tokscale
+ */
+export interface TokscaleReport {
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheCreationTokens: number;
+    totalCacheReadTokens: number;
+    totalCost: number;
+    totalEntries: number;
+    byModel: Record<string, {
+        tokens: number;
+        cost: number;
+    }>;
+}
+/**
+ * Lazily loads and caches the tokscale adapter
+ *
+ * @returns Promise resolving to the adapter (either native or fallback)
+ */
+export declare function getTokscaleAdapter(): Promise<TokscaleAdapter>;
+/**
+ * Gets fallback pricing from the static PRICING table
+ *
+ * @param modelName - Model name to look up
+ * @returns ModelPricing with fallback to Sonnet if unknown
+ */
+export declare function getFallbackPricing(modelName: string): ModelPricing;
+/**
+ * Looks up pricing for a model, preferring tokscale's database with fallback
+ *
+ * This function provides the best available pricing:
+ * 1. If tokscale is available, uses its up-to-date pricing database
+ * 2. Falls back to static PRICING table if tokscale unavailable or model not found
+ *
+ * @param modelName - Model name to look up pricing for
+ * @returns Promise resolving to ModelPricing
+ */
+export declare function lookupPricingWithFallback(modelName: string): Promise<ModelPricing>;
+/**
+ * Checks if tokscale native module is currently available
+ *
+ * @returns Promise resolving to boolean indicating availability
+ */
+export declare function isTokscaleAvailable(): Promise<boolean>;
+/**
+ * Resets the adapter cache (useful for testing)
+ */
+export declare function resetAdapterCache(): void;
+//# sourceMappingURL=tokscale-adapter.d.ts.map

package/dist/analytics/tokscale-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokscale-adapter.d.ts","sourceRoot":"","sources":["../../src/analytics/tokscale-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAW,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;IAErB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAE1C,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEpE,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAeD;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CA0InE;AAsBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAGlE;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxF;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC"}

package/dist/analytics/tokscale-adapter.js

@@ -0,0 +1,223 @@
+/**
+ * TokScale Adapter Module
+ *
+ * Provides a centralized adapter for @tokscale/core with graceful fallback
+ * when the native module is unavailable. This enables optional high-performance
+ * token counting and pricing lookup while maintaining compatibility in all environments.
+ */
+import { PRICING } from './types.js';
+/**
+ * Fallback adapter when tokscale is not available
+ */
+const FALLBACK_ADAPTER = {
+    isAvailable: false
+};
+/** Cached adapter instance */
+let cachedAdapter = null;
+/** Whether we've already attempted to load tokscale */
+let loadAttempted = false;
+/**
+ * Lazily loads and caches the tokscale adapter
+ *
+ * @returns Promise resolving to the adapter (either native or fallback)
+ */
+export async function getTokscaleAdapter() {
+    // Return cached adapter if available
+    if (cachedAdapter !== null) {
+        return cachedAdapter;
+    }
+    // Return fallback if we already tried and failed
+    if (loadAttempted) {
+        return FALLBACK_ADAPTER;
+    }
+    loadAttempted = true;
+    try {
+        // Suppress tokscale internal warnings during import/initialization
+        // These warnings come from tokscale's model provider parsing and spam the CLI output
+        const originalWarn = console.warn;
+        console.warn = (...args) => {
+            const msg = args[0];
+            if (typeof msg === 'string' && msg.startsWith('[tokscale]')) {
+                return; // Suppress tokscale internal warnings
+            }
+            originalWarn.apply(console, args);
+        };
+        let tokscale;
+        try {
+            // Dynamic import of @tokscale/core
+            tokscale = await import('@tokscale/core');
+            // Verify native module is functional via health check
+            // Note: healthCheck returns a string "tokscale-core is healthy!" when working
+            if (typeof tokscale.healthCheck === 'function') {
+                const health = tokscale.healthCheck();
+                // String response means healthy, non-string or falsy means unhealthy
+                if (!health || (typeof health === 'object' && !health.nativeAvailable)) {
+                    console.warn('[tokscale-adapter] Native module not available, using fallback');
+                    cachedAdapter = FALLBACK_ADAPTER;
+                    return cachedAdapter;
+                }
+            }
+        }
+        finally {
+            // Always restore original console.warn
+            console.warn = originalWarn;
+        }
+        // Helper to convert tokscale's entries array to our byModel format
+        const convertEntriesToByModel = (entries) => {
+            const result = {};
+            if (!entries || !Array.isArray(entries)) {
+                return result;
+            }
+            for (const entry of entries) {
+                const modelName = entry.model ?? 'unknown';
+                result[modelName] = {
+                    tokens: (entry.input ?? 0) + (entry.output ?? 0),
+                    cost: entry.cost ?? 0
+                };
+            }
+            return result;
+        };
+        // Build adapter with wrapped functions matching tokscale's actual API
+        cachedAdapter = {
+            isAvailable: true,
+            version: (typeof tokscale.version === 'function' ? tokscale.version() : tokscale.version) ?? 'unknown',
+            getReport: async () => {
+                try {
+                    // Use getModelReport which is the high-level API that works
+                    const report = await tokscale.getModelReport({ sources: ['claude'] });
+                    // Convert tokscale ModelReport to our TokscaleReport
+                    // Field mapping: totalInput -> totalInputTokens, totalOutput -> totalOutputTokens, etc.
+                    return {
+                        totalInputTokens: report.totalInput ?? 0,
+                        totalOutputTokens: report.totalOutput ?? 0,
+                        totalCacheCreationTokens: report.totalCacheWrite ?? 0,
+                        totalCacheReadTokens: report.totalCacheRead ?? 0,
+                        totalCost: report.totalCost ?? 0,
+                        totalEntries: report.totalMessages ?? 0,
+                        byModel: convertEntriesToByModel(report.entries ?? [])
+                    };
+                }
+                catch (error) {
+                    console.warn('[tokscale-adapter] getReport failed:', error instanceof Error ? error.message : String(error));
+                    throw error;
+                }
+            },
+            lookupPricing: async (modelName) => {
+                try {
+                    const result = await tokscale.lookupPricing(modelName);
+                    if (result && result.pricing) {
+                        const pricing = result.pricing;
+                        // Convert per-token costs to per-million costs
+                        const inputPerMillion = (pricing.inputCostPerToken ?? 0) * 1_000_000;
+                        const outputPerMillion = (pricing.outputCostPerToken ?? 0) * 1_000_000;
+                        // Calculate cache multipliers from absolute costs
+                        // cacheWriteMarkup: ratio of cache creation cost to input cost
+                        // cacheReadDiscount: 1 - (cache read cost / input cost)
+                        const cacheWriteMarkup = pricing.inputCostPerToken > 0
+                            ? (pricing.cacheCreationInputTokenCost ?? pricing.inputCostPerToken * 1.25) / pricing.inputCostPerToken - 1
+                            : 0.25;
+                        const cacheReadDiscount = pricing.inputCostPerToken > 0
+                            ? 1 - (pricing.cacheReadInputTokenCost ?? pricing.inputCostPerToken * 0.1) / pricing.inputCostPerToken
+                            : 0.9;
+                        return {
+                            inputPerMillion,
+                            outputPerMillion,
+                            cacheWriteMarkup,
+                            cacheReadDiscount
+                        };
+                    }
+                    return null;
+                }
+                catch (error) {
+                    console.warn('[tokscale-adapter] lookupPricing failed for', modelName, ':', error instanceof Error ? error.message : String(error));
+                    return null;
+                }
+            }
+        };
+        return cachedAdapter;
+    }
+    catch (error) {
+        // Expected when @tokscale/core is not installed
+        const message = error instanceof Error ? error.message : String(error);
+        // Only log if it's not a simple "module not found" error
+        if (!message.includes('Cannot find module') && !message.includes('MODULE_NOT_FOUND')) {
+            console.warn(`[tokscale-adapter] Failed to load: ${message}`);
+        }
+        cachedAdapter = FALLBACK_ADAPTER;
+        return cachedAdapter;
+    }
+}
+/**
+ * Normalizes a model name to match our pricing keys
+ *
+ * @param modelName - Raw model name from transcript
+ * @returns Normalized model key
+ */
+function normalizeModelName(modelName) {
+    const lower = modelName.toLowerCase();
+    if (lower.includes('haiku'))
+        return 'claude-haiku-4';
+    if (lower.includes('sonnet'))
+        return 'claude-sonnet-4.6';
+    if (lower.includes('opus'))
+        return 'claude-opus-4.6';
+    // Check exact matches
+    if (PRICING[modelName])
+        return modelName;
+    // Default
+    return 'claude-sonnet-4.6';
+}
+/**
+ * Gets fallback pricing from the static PRICING table
+ *
+ * @param modelName - Model name to look up
+ * @returns ModelPricing with fallback to Sonnet if unknown
+ */
+export function getFallbackPricing(modelName) {
+    const normalized = normalizeModelName(modelName);
+    return PRICING[normalized] ?? PRICING['claude-sonnet-4.6'];
+}
+/**
+ * Looks up pricing for a model, preferring tokscale's database with fallback
+ *
+ * This function provides the best available pricing:
+ * 1. If tokscale is available, uses its up-to-date pricing database
+ * 2. Falls back to static PRICING table if tokscale unavailable or model not found
+ *
+ * @param modelName - Model name to look up pricing for
+ * @returns Promise resolving to ModelPricing
+ */
+export async function lookupPricingWithFallback(modelName) {
+    const adapter = await getTokscaleAdapter();
+    // Try tokscale lookup first if available
+    if (adapter.isAvailable && adapter.lookupPricing) {
+        try {
+            const pricing = await adapter.lookupPricing(modelName);
+            if (pricing !== null) {
+                return pricing;
+            }
+        }
+        catch {
+            // Silently fall through to fallback
+        }
+    }
+    // Use static fallback pricing
+    return getFallbackPricing(modelName);
+}
+/**
+ * Checks if tokscale native module is currently available
+ *
+ * @returns Promise resolving to boolean indicating availability
+ */
+export async function isTokscaleAvailable() {
+    const adapter = await getTokscaleAdapter();
+    return adapter.isAvailable;
+}
+/**
+ * Resets the adapter cache (useful for testing)
+ */
+export function resetAdapterCache() {
+    cachedAdapter = null;
+    loadAttempted = false;
+}
+//# sourceMappingURL=tokscale-adapter.js.map

package/dist/analytics/tokscale-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokscale-adapter.js","sourceRoot":"","sources":["../../src/analytics/tokscale-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,OAAO,EAAE,MAAM,YAAY,CAAC;AAgCnD;;GAEG;AACH,MAAM,gBAAgB,GAAoB;IACxC,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,8BAA8B;AAC9B,IAAI,aAAa,GAA2B,IAAI,CAAC;AAEjD,uDAAuD;AACvD,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,qCAAqC;IACrC,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,iDAAiD;IACjD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,aAAa,GAAG,IAAI,CAAC;IAErB,IAAI,CAAC;QACH,mEAAmE;QACnE,qFAAqF;QACrF,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;QAClC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC5D,OAAO,CAAC,sCAAsC;YAChD,CAAC;YACD,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,IAAI,QAAa,CAAC;QAClB,IAAI,CAAC;YACH,mCAAmC;YACnC,QAAQ,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAQ,CAAC;YAEjD,sDAAsD;YACtD,8EAA8E;YAC9E,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACtC,qEAAqE;gBACrE,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;oBACvE,OAAO,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;oBAC/E,aAAa,GAAG,gBAAgB,CAAC;oBACjC,OAAO,aAAa,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,uCAAuC;YACvC,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;QAC9B,CAAC;QAED,mEAAmE;QACnE,MAAM,uBAAuB,GAAG,CAAC,OAAc,EAAoD,EAAE;YACnG,MAAM,MAAM,GAAqD,EAAE,CAAC;YACpE,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;gBAC3C,MAAM,CAAC,SAAS,CAAC,GAAG;oBAClB,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;oBAChD,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;iBACtB,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,sEAAsE;QACtE,aAAa,GAAG;YACd,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,CAAC,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS;YAEtG,SAAS,EAAE,KAAK,IAAI,EAAE;gBACpB,IAAI,CAAC;oBACH,4DAA4D;oBAC5D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBAEtE,qDAAqD;oBACrD,wFAAwF;oBACxF,OAAO;wBACL,gBAAgB,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;wBACxC,iBAAiB,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC;wBAC1C,wBAAwB,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;wBACrD,oBAAoB,EAAE,MAAM,CAAC,cAAc,IAAI,CAAC;wBAChD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC;wBAChC,YAAY,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC;wBACvC,OAAO,EAAE,uBAAuB,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;qBACvD,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC7G,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YAED,aAAa,EAAE,KAAK,EAAE,SAAiB,EAAE,EAAE;gBACzC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;oBACvD,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;wBAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;wBAC/B,+CAA+C;wBAC/C,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;wBACrE,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;wBAEvE,kDAAkD;wBAClD,+DAA+D;wBAC/D,wDAAwD;wBACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,GAAG,CAAC;4BACpD,CAAC,CAAC,CAAC,OAAO,CAAC,2BAA2B,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,iBAAiB,GAAG,CAAC;4BAC3G,CAAC,CAAC,IAAI,CAAC;wBACT,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,CAAC;4BACrD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,uBAAuB,IAAI,OAAO,CAAC,iBAAiB,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,iBAAiB;4BACtG,CAAC,CAAC,GAAG,CAAC;wBAER,OAAO;4BACL,eAAe;4BACf,gBAAgB;4BAChB,gBAAgB;4BAChB,iBAAiB;yBAClB,CAAC;oBACJ,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBACpI,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;SACiB,CAAC;QAErB,OAAO,aAAc,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gDAAgD;QAChD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,yDAAyD;QACzD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrF,OAAO,CAAC,IAAI,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,aAAa,GAAG,gBAAgB,CAAC;QACjC,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAEtC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACrD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACzD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAErD,sBAAsB;IACtB,IAAI,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,UAAU;IACV,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,UAAU,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,SAAiB;IAC/D,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAE3C,yCAAyC;IACzC,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACvD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,OAAO,OAAO,CAAC,WAAW,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,IAAI,CAAC;IACrB,aAAa,GAAG,KAAK,CAAC;AACxB,CAAC"}

package/dist/analytics/transcript-parser.d.ts

@@ -0,0 +1,42 @@
+import type { TranscriptEntry } from './types.js';
+/**
+ * Options for transcript parsing.
+ */
+export interface ParseTranscriptOptions {
+    /**
+     * AbortSignal to cancel parsing mid-stream.
+     */
+    signal?: AbortSignal;
+    /**
+     * Callback for parse errors (allows custom logging).
+     */
+    onParseError?: (line: string, error: Error) => void;
+}
+/**
+ * Streaming JSONL parser for transcript files.
+ * Parses line-by-line without loading the entire file into memory.
+ *
+ * @param filePath - Path to the transcript JSONL file
+ * @param options - Parsing options including AbortSignal
+ * @yields TranscriptEntry objects
+ *
+ * @example
+ * ```typescript
+ * const controller = new AbortController();
+ * for await (const entry of parseTranscript('transcript.jsonl', { signal: controller.signal })) {
+ *   console.log(entry);
+ * }
+ * ```
+ */
+export declare function parseTranscript(filePath: string, options?: ParseTranscriptOptions): AsyncGenerator<TranscriptEntry>;
+/**
+ * Load all entries from a transcript file into memory.
+ * Use this for smaller files or when you need all entries at once.
+ * For large files, prefer the streaming `parseTranscript()` generator.
+ *
+ * @param filePath - Path to the transcript JSONL file
+ * @param options - Parsing options
+ * @returns Array of all transcript entries
+ */
+export declare function loadTranscript(filePath: string, options?: ParseTranscriptOptions): Promise<TranscriptEntry[]>;
+//# sourceMappingURL=transcript-parser.d.ts.map

package/dist/analytics/transcript-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-parser.d.ts","sourceRoot":"","sources":["../../src/analytics/transcript-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAuB,eAAe,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,cAAc,CAAC,eAAe,CAAC,CA2DjC;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,EAAE,CAAC,CAQ5B"}

package/dist/analytics/transcript-parser.js

@@ -0,0 +1,90 @@
+import * as fs from 'fs';
+import * as readline from 'readline';
+/**
+ * Streaming JSONL parser for transcript files.
+ * Parses line-by-line without loading the entire file into memory.
+ *
+ * @param filePath - Path to the transcript JSONL file
+ * @param options - Parsing options including AbortSignal
+ * @yields TranscriptEntry objects
+ *
+ * @example
+ * ```typescript
+ * const controller = new AbortController();
+ * for await (const entry of parseTranscript('transcript.jsonl', { signal: controller.signal })) {
+ *   console.log(entry);
+ * }
+ * ```
+ */
+export async function* parseTranscript(filePath, options = {}) {
+    const { signal, onParseError } = options;
+    // Check if file exists
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Transcript file not found: ${filePath}`);
+    }
+    const fileStream = fs.createReadStream(filePath, { encoding: 'utf8' });
+    const rl = readline.createInterface({
+        input: fileStream,
+        crlfDelay: Infinity // Treat \r\n as single line break
+    });
+    // Handle abort signal
+    const abortHandler = () => {
+        rl.close();
+        fileStream.destroy();
+    };
+    if (signal) {
+        signal.addEventListener('abort', abortHandler);
+    }
+    try {
+        for await (const line of rl) {
+            // Check abort before processing each line
+            if (signal?.aborted) {
+                break;
+            }
+            // Skip empty lines
+            if (!line.trim()) {
+                continue;
+            }
+            try {
+                const entry = JSON.parse(line);
+                yield entry;
+            }
+            catch (error) {
+                // Handle malformed JSON gracefully
+                const parseError = error instanceof Error ? error : new Error(String(error));
+                if (onParseError) {
+                    onParseError(line, parseError);
+                }
+                else {
+                    // Default: log warning and skip line
+                    console.warn(`[transcript-parser] Skipping malformed line: ${parseError.message}`);
+                }
+            }
+        }
+    }
+    finally {
+        // Clean up
+        if (signal) {
+            signal.removeEventListener('abort', abortHandler);
+        }
+        rl.close();
+        fileStream.destroy();
+    }
+}
+/**
+ * Load all entries from a transcript file into memory.
+ * Use this for smaller files or when you need all entries at once.
+ * For large files, prefer the streaming `parseTranscript()` generator.
+ *
+ * @param filePath - Path to the transcript JSONL file
+ * @param options - Parsing options
+ * @returns Array of all transcript entries
+ */
+export async function loadTranscript(filePath, options = {}) {
+    const entries = [];
+    for await (const entry of parseTranscript(filePath, options)) {
+        entries.push(entry);
+    }
+    return entries;
+}
+//# sourceMappingURL=transcript-parser.js.map

package/dist/analytics/transcript-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-parser.js","sourceRoot":"","sources":["../../src/analytics/transcript-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAkBrC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,eAAe,CACpC,QAAgB,EAChB,UAAkC,EAAE;IAEpC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEzC,uBAAuB;IACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,QAAQ,CAAC,kCAAkC;KACvD,CAAC,CAAC;IAEH,sBAAsB;IACtB,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,UAAU,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;YAC5B,0CAA0C;YAC1C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM;YACR,CAAC;YAED,mBAAmB;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;gBAClD,MAAM,KAAK,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,mCAAmC;gBACnC,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAE7E,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACN,qCAAqC;oBACrC,OAAO,CAAC,IAAI,CAAC,gDAAgD,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,WAAW;QACX,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACpD,CAAC;QACD,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,UAAU,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,UAAkC,EAAE;IAEpC,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/analytics/transcript-scanner.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Metadata for a discovered transcript file
+ */
+export interface TranscriptFile {
+    projectPath: string;
+    projectDir: string;
+    sessionId: string;
+    filePath: string;
+    fileSize: number;
+    modifiedTime: Date;
+}
+/**
+ * Result of scanning for transcripts
+ */
+export interface ScanResult {
+    transcripts: TranscriptFile[];
+    totalSize: number;
+    projectCount: number;
+}
+/**
+ * Options for scanning transcripts
+ */
+export interface ScanOptions {
+    projectFilter?: string;
+    minDate?: Date;
+}
+/**
+ * Decode project directory name back to original path.
+ *
+ * The encoding scheme used by Claude Code is lossy - it converts all path
+ * separators (/ or \) to dashes (-), but legitimate dashes in directory names
+ * also become dashes, making them indistinguishable.
+ *
+ * Encoding patterns:
+ *   - Unix: "/home/user/project" → "-home-user-project"
+ *   - Windows: "C:\Users\user\project" → "C--Users-user-project"
+ *
+ * Strategy:
+ * 1. Detect if it's a Windows or Unix encoded path
+ * 2. Try simple decode (all dashes -> slashes) and check if path exists
+ * 3. If not, try to reconstruct by checking filesystem for partial matches
+ * 4. Fall back to simple decode if nothing else works
+ *
+ * @internal Exported for testing
+ */
+export declare function decodeProjectPath(dirName: string): string;
+/**
+ * Scan for all transcript files in ~/.claude/projects/
+ */
+export declare function scanTranscripts(options?: ScanOptions): Promise<ScanResult>;
+//# sourceMappingURL=transcript-scanner.d.ts.map

package/dist/analytics/transcript-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-scanner.d.ts","sourceRoot":"","sources":["../../src/analytics/transcript-scanner.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAazD;AA4LD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8EpF"}