@guidemode/session-processing 0.1.43

package/dist/cjs/processors/base/provider-processor.d.ts

@@ -0,0 +1,45 @@
+import type { BaseMetricProcessor } from './metric-processor.js';
+import type { ParsedSession, ProcessorContext, ProcessorResult } from './types.js';
+export declare abstract class BaseProviderProcessor {
+    abstract readonly providerName: string;
+    abstract readonly description: string;
+    /**
+     * Parse the raw JSONL content into a structured session object
+     * Each provider implements this differently based on their log format
+     */
+    abstract parseSession(jsonlContent: string, provider: string): ParsedSession;
+    /**
+     * Get all metric processors for this provider
+     * Each provider should return the same set of processors for consistency
+     */
+    abstract getMetricProcessors(): BaseMetricProcessor[];
+    /**
+     * Check if this processor can handle the given content
+     * Default implementation just checks if content is valid JSON lines
+     */
+    canProcess(content: string): boolean;
+    /**
+     * Process all metrics for a session
+     * This orchestrates running all metric processors sequentially to ensure completion
+     * Returns array of ProcessorResults - caller is responsible for storage
+     */
+    processMetrics(jsonlContent: string, context: ProcessorContext): Promise<ProcessorResult[]>;
+    /**
+     * Validate JSONL content format
+     */
+    protected validateJsonlContent(content: string): void;
+    /**
+     * Extract timestamps from raw message data
+     * Helper method for providers to implement
+     */
+    protected parseTimestamp(timestampStr: string | undefined): Date | null;
+    /**
+     * Calculate session duration from start and end times
+     */
+    protected calculateDuration(startTime: Date | null, endTime: Date | null): number;
+    /**
+     * Generate a unique message ID if not provided
+     */
+    protected generateMessageId(index: number, timestamp?: Date): string;
+}
+//# sourceMappingURL=provider-processor.d.ts.map

package/dist/cjs/processors/base/provider-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/base/provider-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAElF,8BAAsB,qBAAqB;IACzC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAErC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa;IAE5E;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,IAAI,mBAAmB,EAAE;IAErD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAapC;;;;OAIG;IACG,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC;IAgC7B;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBrD;;;OAGG;IACH,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI;IAcvE;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM;IAKjF;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM;CAIrE"}

package/dist/cjs/processors/base/provider-processor.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseProviderProcessor = void 0;
+class BaseProviderProcessor {
+    /**
+     * Check if this processor can handle the given content
+     * Default implementation just checks if content is valid JSON lines
+     */
+    canProcess(content) {
+        try {
+            const lines = content.split('\n').filter(line => line.trim());
+            if (lines.length === 0)
+                return false;
+            // Try to parse first line as JSON to verify format
+            JSON.parse(lines[0]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Process all metrics for a session
+     * This orchestrates running all metric processors sequentially to ensure completion
+     * Returns array of ProcessorResults - caller is responsible for storage
+     */
+    async processMetrics(jsonlContent, context) {
+        const session = this.parseSession(jsonlContent, context.provider);
+        const processors = this.getMetricProcessors();
+        // Run all processors sequentially to ensure each completes before the next
+        const successfulResults = [];
+        for (const processor of processors) {
+            try {
+                if (!processor.canProcess(session)) {
+                    continue;
+                }
+                const result = await processor.processToResult(session);
+                if (!result || !result.metrics) {
+                    continue;
+                }
+                successfulResults.push(result);
+            }
+            catch (_error) {
+                // Silently continue on processor errors
+            }
+        }
+        if (successfulResults.length === 0) {
+            console.error(`⚠ WARNING: NO processors succeeded for session ${context.sessionId}!`);
+        }
+        return successfulResults;
+    }
+    /**
+     * Validate JSONL content format
+     */
+    validateJsonlContent(content) {
+        if (!content || content.trim().length === 0) {
+            throw new Error('Content is empty');
+        }
+        const lines = content.split('\n').filter(line => line.trim());
+        if (lines.length === 0) {
+            throw new Error('No valid lines found in content');
+        }
+        // Validate first few lines as JSON
+        const linesToCheck = Math.min(3, lines.length);
+        for (let i = 0; i < linesToCheck; i++) {
+            try {
+                JSON.parse(lines[i]);
+            }
+            catch (_error) {
+                throw new Error(`Invalid JSON on line ${i + 1}: ${lines[i]}`);
+            }
+        }
+    }
+    /**
+     * Extract timestamps from raw message data
+     * Helper method for providers to implement
+     */
+    parseTimestamp(timestampStr) {
+        if (!timestampStr)
+            return null;
+        try {
+            const date = new Date(timestampStr);
+            if (Number.isNaN(date.getTime())) {
+                return null;
+            }
+            return date;
+        }
+        catch (_error) {
+            return null;
+        }
+    }
+    /**
+     * Calculate session duration from start and end times
+     */
+    calculateDuration(startTime, endTime) {
+        if (!startTime || !endTime)
+            return 0;
+        return Math.max(0, endTime.getTime() - startTime.getTime());
+    }
+    /**
+     * Generate a unique message ID if not provided
+     */
+    generateMessageId(index, timestamp) {
+        const time = timestamp ? timestamp.getTime() : Date.now();
+        return `msg_${time}_${index}`;
+    }
+}
+exports.BaseProviderProcessor = BaseProviderProcessor;
+//# sourceMappingURL=provider-processor.js.map

package/dist/cjs/processors/base/provider-processor.js.map

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

package/dist/cjs/processors/base/types.d.ts

@@ -0,0 +1,2 @@
+export type { ParsedMessage, ParsedSession, ProcessorResult, ProcessorContext, ProcessingStatus, MetricType, SessionMetricsData, } from '@guidemode/types';
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/processors/base/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/processors/base/types.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/cjs/processors/base/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/processors/base/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/processors/base/types.ts"],"names":[],"mappings":""}

package/dist/cjs/processors/canonical/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Unified Canonical Session Processor
+ *
+ * Single processor that works for all providers using the canonical format.
+ * Consolidates 5+ provider-specific processors into one.
+ */
+import { type BaseMetricProcessor, BaseProviderProcessor } from '../base/index.js';
+import { CanonicalContextProcessor } from './metrics/context.js';
+import { CanonicalEngagementProcessor } from './metrics/engagement.js';
+import { CanonicalErrorProcessor } from './metrics/error.js';
+import { CanonicalPerformanceProcessor } from './metrics/performance.js';
+import { CanonicalQualityProcessor } from './metrics/quality.js';
+import { CanonicalUsageProcessor } from './metrics/usage.js';
+export declare class CanonicalSessionProcessor extends BaseProviderProcessor {
+    readonly providerName = "canonical";
+    readonly description = "Unified session processor for all providers using canonical format";
+    private parser;
+    private metricProcessors;
+    constructor();
+    parseSession(jsonlContent: string, _provider: string): import("../../parsers/index.js").ParsedSession;
+    getMetricProcessors(): BaseMetricProcessor[];
+}
+export { CanonicalEngagementProcessor, CanonicalUsageProcessor, CanonicalQualityProcessor, CanonicalPerformanceProcessor, CanonicalErrorProcessor, CanonicalContextProcessor, };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/processors/canonical/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/processors/canonical/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAE5D,qBAAa,yBAA0B,SAAQ,qBAAqB;IAClE,QAAQ,CAAC,YAAY,eAAc;IACnC,QAAQ,CAAC,WAAW,wEAAuE;IAE3F,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,gBAAgB,CAAuB;;IAgB/C,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKpD,mBAAmB,IAAI,mBAAmB,EAAE;CAG7C;AAGD,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,yBAAyB,GAC1B,CAAA"}

package/dist/cjs/processors/canonical/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Unified Canonical Session Processor
+ *
+ * Single processor that works for all providers using the canonical format.
+ * Consolidates 5+ provider-specific processors into one.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanonicalContextProcessor = exports.CanonicalErrorProcessor = exports.CanonicalPerformanceProcessor = exports.CanonicalQualityProcessor = exports.CanonicalUsageProcessor = exports.CanonicalEngagementProcessor = exports.CanonicalSessionProcessor = void 0;
+const index_js_1 = require("../../parsers/index.js");
+const index_js_2 = require("../base/index.js");
+const context_js_1 = require("./metrics/context.js");
+Object.defineProperty(exports, "CanonicalContextProcessor", { enumerable: true, get: function () { return context_js_1.CanonicalContextProcessor; } });
+const engagement_js_1 = require("./metrics/engagement.js");
+Object.defineProperty(exports, "CanonicalEngagementProcessor", { enumerable: true, get: function () { return engagement_js_1.CanonicalEngagementProcessor; } });
+const error_js_1 = require("./metrics/error.js");
+Object.defineProperty(exports, "CanonicalErrorProcessor", { enumerable: true, get: function () { return error_js_1.CanonicalErrorProcessor; } });
+const performance_js_1 = require("./metrics/performance.js");
+Object.defineProperty(exports, "CanonicalPerformanceProcessor", { enumerable: true, get: function () { return performance_js_1.CanonicalPerformanceProcessor; } });
+const quality_js_1 = require("./metrics/quality.js");
+Object.defineProperty(exports, "CanonicalQualityProcessor", { enumerable: true, get: function () { return quality_js_1.CanonicalQualityProcessor; } });
+const usage_js_1 = require("./metrics/usage.js");
+Object.defineProperty(exports, "CanonicalUsageProcessor", { enumerable: true, get: function () { return usage_js_1.CanonicalUsageProcessor; } });
+class CanonicalSessionProcessor extends index_js_2.BaseProviderProcessor {
+    constructor() {
+        super();
+        this.providerName = 'canonical';
+        this.description = 'Unified session processor for all providers using canonical format';
+        this.parser = new index_js_1.CanonicalParser();
+        // Initialize all unified metric processors
+        this.metricProcessors = [
+            new performance_js_1.CanonicalPerformanceProcessor(),
+            new engagement_js_1.CanonicalEngagementProcessor(),
+            new quality_js_1.CanonicalQualityProcessor(),
+            new usage_js_1.CanonicalUsageProcessor(),
+            new error_js_1.CanonicalErrorProcessor(),
+            new context_js_1.CanonicalContextProcessor(),
+        ];
+    }
+    parseSession(jsonlContent, _provider) {
+        this.validateJsonlContent(jsonlContent);
+        return this.parser.parseSession(jsonlContent);
+    }
+    getMetricProcessors() {
+        return this.metricProcessors;
+    }
+}
+exports.CanonicalSessionProcessor = CanonicalSessionProcessor;
+//# sourceMappingURL=index.js.map

package/dist/cjs/processors/canonical/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/processors/canonical/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qDAAwD;AACxD,+CAAkF;AAClF,qDAAgE;AA6C9D,0GA7CO,sCAAyB,OA6CP;AA5C3B,2DAAsE;AAuCpE,6GAvCO,4CAA4B,OAuCP;AAtC9B,iDAA4D;AA0C1D,wGA1CO,kCAAuB,OA0CP;AAzCzB,6DAAwE;AAwCtE,8GAxCO,8CAA6B,OAwCP;AAvC/B,qDAAgE;AAsC9D,0GAtCO,sCAAyB,OAsCP;AArC3B,iDAA4D;AAoC1D,wGApCO,kCAAuB,OAoCP;AAlCzB,MAAa,yBAA0B,SAAQ,gCAAqB;IAOlE;QACE,KAAK,EAAE,CAAA;QAPA,iBAAY,GAAG,WAAW,CAAA;QAC1B,gBAAW,GAAG,oEAAoE,CAAA;QAEnF,WAAM,GAAG,IAAI,0BAAe,EAAE,CAAA;QAMpC,2CAA2C;QAC3C,IAAI,CAAC,gBAAgB,GAAG;YACtB,IAAI,8CAA6B,EAAE;YACnC,IAAI,4CAA4B,EAAE;YAClC,IAAI,sCAAyB,EAAE;YAC/B,IAAI,kCAAuB,EAAE;YAC7B,IAAI,kCAAuB,EAAE;YAC7B,IAAI,sCAAyB,EAAE;SAChC,CAAA;IACH,CAAC;IAED,YAAY,CAAC,YAAoB,EAAE,SAAiB;QAClD,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAA;IAC/C,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAA;IAC9B,CAAC;CACF;AA7BD,8DA6BC"}

package/dist/cjs/processors/canonical/metrics/context.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Unified Context Metrics Processor
+ *
+ * Works for providers with token data (Claude Code, Codex).
+ * Tracks token usage, cache efficiency, and context compaction events.
+ * Returns null for providers without token data.
+ */
+import type { ContextManagementMetrics } from '@guidemode/types';
+import type { ParsedSession } from '../../../parsers/base/types.js';
+import { BaseMetricProcessor } from '../../base/metric-processor.js';
+export declare class CanonicalContextProcessor extends BaseMetricProcessor {
+    readonly name = "canonical-context";
+    readonly metricType: "context-management";
+    readonly description = "Tracks token usage, cache efficiency, and context management (unified for all providers)";
+    private readonly CONTEXT_WINDOW_SIZE;
+    /**
+     * Check if session has token data (required for context metrics)
+     */
+    canProcess(session: ParsedSession): boolean;
+    process(session: ParsedSession): Promise<ContextManagementMetrics>;
+    /**
+     * Calculate token totals from the session
+     */
+    private calculateTotals;
+    /**
+     * Detect compact events in the session
+     */
+    private detectCompactEvents;
+    /**
+     * Calculate average input tokens per message
+     */
+    private calculateAvgTokensPerMessage;
+    /**
+     * Generate improvement tips
+     */
+    private generateImprovementTips;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/cjs/processors/canonical/metrics/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../src/processors/canonical/metrics/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAEpE,qBAAa,yBAA0B,SAAQ,mBAAmB;IAChE,QAAQ,CAAC,IAAI,uBAAsB;IACnC,QAAQ,CAAC,UAAU,EAAG,oBAAoB,CAAS;IACnD,QAAQ,CAAC,WAAW,8FACwE;IAG5F,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAIrC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAgCxE;;OAEG;IACH,OAAO,CAAC,eAAe;IA6DvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAqBpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAuChC"}

package/dist/cjs/processors/canonical/metrics/context.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Unified Context Metrics Processor
+ *
+ * Works for providers with token data (Claude Code, Codex).
+ * Tracks token usage, cache efficiency, and context compaction events.
+ * Returns null for providers without token data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanonicalContextProcessor = void 0;
+const metric_processor_js_1 = require("../../base/metric-processor.js");
+class CanonicalContextProcessor extends metric_processor_js_1.BaseMetricProcessor {
+    constructor() {
+        super(...arguments);
+        this.name = 'canonical-context';
+        this.metricType = 'context-management';
+        this.description = 'Tracks token usage, cache efficiency, and context management (unified for all providers)';
+        // Claude Sonnet 4.5 context window (providers may vary)
+        this.CONTEXT_WINDOW_SIZE = 200000;
+    }
+    /**
+     * Check if session has token data (required for context metrics)
+     */
+    canProcess(session) {
+        return session.messages.some(m => m.metadata?.usage);
+    }
+    async process(session) {
+        // Calculate totals
+        const totals = this.calculateTotals(session);
+        // Detect compact events
+        const compactEvents = this.detectCompactEvents(session);
+        // Calculate average tokens per message
+        const avgTokensPerMessage = this.calculateAvgTokensPerMessage(session);
+        // Calculate context utilization
+        const contextUtilization = (totals.contextLength / this.CONTEXT_WINDOW_SIZE) * 100;
+        // Generate improvement tips
+        const improvementTips = this.generateImprovementTips(compactEvents, totals, contextUtilization);
+        return {
+            total_input_tokens: totals.totalInputTokens,
+            total_output_tokens: totals.totalOutputTokens,
+            total_cache_created: totals.totalCacheCreated,
+            total_cache_read: totals.totalCacheRead,
+            context_length: totals.contextLength,
+            context_window_size: this.CONTEXT_WINDOW_SIZE,
+            context_utilization_percent: contextUtilization,
+            compact_event_count: compactEvents.count,
+            compact_event_steps: JSON.stringify(compactEvents.steps),
+            avg_tokens_per_message: avgTokensPerMessage,
+            messages_until_first_compact: compactEvents.firstCompactStep,
+            context_improvement_tips: JSON.stringify(improvementTips),
+        };
+    }
+    /**
+     * Calculate token totals from the session
+     */
+    calculateTotals(session) {
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        let totalCacheCreated = 0;
+        let totalCacheRead = 0;
+        let contextLength = 0;
+        let mostRecentTimestamp = null;
+        let mostRecentUsage = null;
+        for (const message of session.messages) {
+            const usage = message.metadata?.usage;
+            if (usage) {
+                // Sum all tokens
+                totalInputTokens += usage.input_tokens || 0;
+                totalOutputTokens += usage.output_tokens || 0;
+                totalCacheCreated += usage.cache_creation_input_tokens || 0;
+                totalCacheRead += usage.cache_read_input_tokens || 0;
+                // Track most recent main chain message for context_length
+                const isSidechain = message.metadata?.isSidechain === true;
+                if (!isSidechain &&
+                    message.timestamp &&
+                    (!mostRecentTimestamp || message.timestamp > mostRecentTimestamp)) {
+                    mostRecentTimestamp = message.timestamp;
+                    mostRecentUsage = usage;
+                }
+            }
+        }
+        // Calculate context_length from most recent main chain message
+        if (mostRecentUsage) {
+            contextLength =
+                (mostRecentUsage.input_tokens || 0) +
+                    (mostRecentUsage.cache_read_input_tokens || 0) +
+                    (mostRecentUsage.cache_creation_input_tokens || 0);
+        }
+        return {
+            totalInputTokens,
+            totalOutputTokens,
+            totalCacheCreated,
+            totalCacheRead,
+            contextLength,
+        };
+    }
+    /**
+     * Detect compact events in the session
+     */
+    detectCompactEvents(session) {
+        const compactSteps = [];
+        session.messages.forEach((message, index) => {
+            if (message.type === 'compact') {
+                compactSteps.push(index + 1); // 1-based indexing
+            }
+        });
+        return {
+            count: compactSteps.length,
+            steps: compactSteps,
+            firstCompactStep: compactSteps.length > 0 ? compactSteps[0] : null,
+        };
+    }
+    /**
+     * Calculate average input tokens per message
+     */
+    calculateAvgTokensPerMessage(session) {
+        let totalInputTokens = 0;
+        let messageCount = 0;
+        for (const message of session.messages) {
+            const usage = message.metadata?.usage;
+            const inputTokens = usage?.input_tokens || 0;
+            if (inputTokens > 0) {
+                totalInputTokens += inputTokens;
+                messageCount++;
+            }
+        }
+        return messageCount > 0 ? Math.round(totalInputTokens / messageCount) : 0;
+    }
+    /**
+     * Generate improvement tips
+     */
+    generateImprovementTips(compactEvents, totals, contextUtilization) {
+        const tips = [];
+        // Context utilization tips
+        if (contextUtilization > 80) {
+            tips.push('High context utilization - consider compacting context or breaking into smaller sessions');
+        }
+        if (contextUtilization > 90) {
+            tips.push('Very high context utilization - approaching limit, compact soon to avoid issues');
+        }
+        // Cache efficiency tips
+        const cacheHitRate = totals.totalCacheCreated > 0 ? totals.totalCacheRead / totals.totalCacheCreated : 0;
+        if (cacheHitRate > 0.5) {
+            tips.push('Good cache efficiency - prompt caching is working well');
+        }
+        else if (cacheHitRate > 0 && cacheHitRate <= 0.5) {
+            tips.push('Moderate cache efficiency - consider more consistent context patterns');
+        }
+        // Compact event tips
+        if (compactEvents.count === 0 && contextUtilization > 60) {
+            tips.push('Consider using /compact command to manage context size proactively');
+        }
+        if (compactEvents.count > 3) {
+            tips.push('Frequent compaction - consider breaking this into multiple shorter sessions');
+        }
+        return tips;
+    }
+}
+exports.CanonicalContextProcessor = CanonicalContextProcessor;
+//# sourceMappingURL=context.js.map

package/dist/cjs/processors/canonical/metrics/context.js.map

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

package/dist/cjs/processors/canonical/metrics/engagement.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Unified Engagement Metrics Processor
+ *
+ * Works for all providers using the canonical format.
+ * Measures interruption rate and session length.
+ */
+import type { EngagementMetrics } from '@guidemode/types';
+import type { ParsedSession } from '../../../parsers/base/types.js';
+import { BaseMetricProcessor } from '../../base/metric-processor.js';
+export declare class CanonicalEngagementProcessor extends BaseMetricProcessor {
+    readonly name = "canonical-engagement";
+    readonly metricType: "engagement";
+    readonly description = "Measures interruption rate and session length (unified for all providers)";
+    process(session: ParsedSession): Promise<EngagementMetrics>;
+    /**
+     * Find interruption messages
+     * An interruption is when:
+     * 1. Message has canonical type 'interruption'
+     * 2. User sends consecutive messages (without assistant response in between)
+     * 3. User message contains interruption keywords (stop, wait, actually, no)
+     */
+    private findInterruptions;
+    /**
+     * Extract text content from message (handles both string and structured content)
+     */
+    private extractTextContent;
+    /**
+     * Generate improvement tips based on metrics
+     */
+    private generateImprovementTips;
+}
+//# sourceMappingURL=engagement.d.ts.map

package/dist/cjs/processors/canonical/metrics/engagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../../../../../src/processors/canonical/metrics/engagement.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAEpE,qBAAa,4BAA6B,SAAQ,mBAAmB;IACnE,QAAQ,CAAC,IAAI,0BAAyB;IACtC,QAAQ,CAAC,UAAU,EAAG,YAAY,CAAS;IAC3C,QAAQ,CAAC,WAAW,+EAA8E;IAE5F,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8BjE;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA+CzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAmBhC"}

package/dist/cjs/processors/canonical/metrics/engagement.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Unified Engagement Metrics Processor
+ *
+ * Works for all providers using the canonical format.
+ * Measures interruption rate and session length.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanonicalEngagementProcessor = void 0;
+const metric_processor_js_1 = require("../../base/metric-processor.js");
+class CanonicalEngagementProcessor extends metric_processor_js_1.BaseMetricProcessor {
+    constructor() {
+        super(...arguments);
+        this.name = 'canonical-engagement';
+        this.metricType = 'engagement';
+        this.description = 'Measures interruption rate and session length (unified for all providers)';
+    }
+    async process(session) {
+        const userMessages = session.messages.filter(m => m.type === 'user');
+        const assistantMessages = session.messages.filter(m => m.type === 'assistant');
+        if (userMessages.length === 0 || assistantMessages.length === 0) {
+            return {
+                interruption_rate: 0,
+                total_interruptions: 0,
+                session_length_minutes: 0,
+            };
+        }
+        // Calculate interruption rate
+        const interruptions = this.findInterruptions(session.messages);
+        const interruptionRate = Math.round((interruptions.length / assistantMessages.length) * 100);
+        // Calculate session length in minutes
+        const sessionLengthMinutes = Math.round(session.duration / (1000 * 60));
+        return {
+            interruption_rate: interruptionRate,
+            total_interruptions: interruptions.length,
+            session_length_minutes: sessionLengthMinutes,
+            metadata: {
+                total_responses: assistantMessages.length,
+                improvement_tips: this.generateImprovementTips(interruptionRate, sessionLengthMinutes),
+            },
+        };
+    }
+    /**
+     * Find interruption messages
+     * An interruption is when:
+     * 1. Message has canonical type 'interruption'
+     * 2. User sends consecutive messages (without assistant response in between)
+     * 3. User message contains interruption keywords (stop, wait, actually, no)
+     */
+    findInterruptions(messages) {
+        const interruptions = [];
+        const interruptionIds = new Set(); // Prevent duplicates
+        for (let i = 1; i < messages.length; i++) {
+            const current = messages[i];
+            const previous = messages[i - 1];
+            // Skip if already marked as interruption
+            if (interruptionIds.has(current.id)) {
+                continue;
+            }
+            // Type 1: Canonical interruption message type
+            if (current.type === 'interruption') {
+                interruptions.push(current);
+                interruptionIds.add(current.id);
+                continue;
+            }
+            // Type 2: Consecutive user messages
+            if (current.type === 'user' && previous.type === 'user') {
+                interruptions.push(current);
+                interruptionIds.add(current.id);
+                continue;
+            }
+            // Type 3: User message with interruption keywords
+            if (current.type === 'user') {
+                const content = this.extractTextContent(current).toLowerCase();
+                const hasInterruptionKeyword = content.includes('wait') ||
+                    content.includes('stop') ||
+                    content.includes('actually') ||
+                    content.startsWith('no, ') ||
+                    content.includes('cancel');
+                if (hasInterruptionKeyword) {
+                    interruptions.push(current);
+                    interruptionIds.add(current.id);
+                }
+            }
+        }
+        return interruptions;
+    }
+    /**
+     * Extract text content from message (handles both string and structured content)
+     */
+    extractTextContent(message) {
+        if (typeof message.content === 'string') {
+            return message.content;
+        }
+        // Structured content
+        if (message.content.text) {
+            return message.content.text;
+        }
+        return '';
+    }
+    /**
+     * Generate improvement tips based on metrics
+     */
+    generateImprovementTips(interruptionRate, sessionLength) {
+        const tips = [];
+        if (interruptionRate > 50) {
+            tips.push('High interruption rate - consider providing more context upfront');
+            tips.push('Note: Some interruptions are effective when steering AI back on track');
+        }
+        if (sessionLength > 60) {
+            tips.push("Long session - ensure you're making steady progress on your task");
+            tips.push('Consider whether initial requirements were comprehensive enough');
+        }
+        if (interruptionRate < 10 && sessionLength < 30) {
+            tips.push('Excellent collaboration! Efficient session with minimal course corrections');
+        }
+        return tips;
+    }
+}
+exports.CanonicalEngagementProcessor = CanonicalEngagementProcessor;
+//# sourceMappingURL=engagement.js.map

package/dist/cjs/processors/canonical/metrics/engagement.js.map

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