@substrate-ai/core 0.19.54

package/dist/telemetry/batch-buffer.js

@@ -0,0 +1,83 @@
+/**
+ * BatchBuffer — generic buffering utility with size-triggered and timer-triggered flush.
+ *
+ * Emits a 'flush' event with the accumulated items whenever either:
+ *   - The buffer reaches `batchSize` items, or
+ *   - The `flushIntervalMs` timer fires
+ *
+ * Callers subscribe to the 'flush' event via `.on('flush', handler)`.
+ * Call `start()` to begin the interval timer and `stop()` to drain and clean up.
+ * Call `flush()` to force-flush immediately without stopping the interval timer.
+ *
+ * Design invariants:
+ *   - Never throws; errors from flush handlers are the caller's responsibility
+ *   - Items pushed after stop() are still emitted in the final drain flush
+ *   - EventEmitter pattern — no internal queue management beyond the items array
+ */
+import { EventEmitter } from 'node:events';
+// ---------------------------------------------------------------------------
+// BatchBuffer
+// ---------------------------------------------------------------------------
+export class BatchBuffer extends EventEmitter {
+    _items = [];
+    _timer = null;
+    _batchSize;
+    _flushIntervalMs;
+    constructor(options = {}) {
+        super();
+        this._batchSize = options.batchSize ?? 100;
+        this._flushIntervalMs = options.flushIntervalMs ?? 5000;
+    }
+    /**
+     * Add an item to the buffer.
+     * Triggers a flush immediately when the buffer reaches `batchSize`.
+     */
+    push(item) {
+        this._items.push(item);
+        if (this._items.length >= this._batchSize) {
+            this._flush();
+        }
+    }
+    /**
+     * Start the interval timer that flushes items on a schedule.
+     * Safe to call multiple times — subsequent calls are ignored.
+     */
+    start() {
+        if (this._timer !== null)
+            return;
+        this._timer = setInterval(() => this._flush(), this._flushIntervalMs);
+        // Allow the Node.js event loop to exit even if this timer is active.
+        if (typeof this._timer.unref === 'function') {
+            this._timer.unref();
+        }
+    }
+    /**
+     * Trigger an immediate flush of buffered items without stopping the interval timer.
+     * Use this to force-flush between pipeline phases while keeping the timer active.
+     * No-op when the buffer is empty.
+     */
+    flush() {
+        this._flush();
+    }
+    /**
+     * Stop the interval timer and flush any remaining items.
+     * Safe to call multiple times — subsequent calls are ignored.
+     */
+    stop() {
+        if (this._timer !== null) {
+            clearInterval(this._timer);
+            this._timer = null;
+        }
+        this._flush();
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    _flush() {
+        if (this._items.length === 0)
+            return;
+        const items = this._items.splice(0);
+        this.emit('flush', items);
+    }
+}
+//# sourceMappingURL=batch-buffer.js.map

package/dist/telemetry/batch-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-buffer.js","sourceRoot":"","sources":["../../src/telemetry/batch-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAa1C,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,OAAO,WAAe,SAAQ,YAAY;IACtC,MAAM,GAAQ,EAAE,CAAA;IAChB,MAAM,GAA0C,IAAI,CAAA;IAC3C,UAAU,CAAQ;IAClB,gBAAgB,CAAQ;IAEzC,YAAY,UAA8B,EAAE;QAC1C,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAA;QAC1C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAA;IACzD,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAA;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,OAAM;QAChC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACrE,qEAAqE;QACrE,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,EAAE,CAAA;IACf,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QACpB,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAA;IACf,CAAC;IAED,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAEtE,MAAM;QACZ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;CACF"}

package/dist/telemetry/categorizer.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Categorizer — classifies telemetry spans into semantic categories and
+ * computes per-category token statistics with trend detection.
+ *
+ * Classification proceeds through three tiers:
+ *   1. Exact match against a lookup table of known operation names
+ *   2. Prefix/regex pattern match
+ *   3. Fuzzy case-insensitive substring match
+ *   4. Fallback to 'other' (overridden to 'tool_outputs' when toolName present)
+ *
+ * Architecture constraints:
+ *   - Constructor injection: accepts ILogger via constructor (defaults to console)
+ *   - Module-scope lookup tables to avoid recreation on every classify() call
+ *   - Zero external dependencies beyond types from this module
+ *
+ * Migrated to @substrate-ai/core in story 41-6b.
+ */
+import type { ILogger } from '../dispatch/types.js';
+import type { NormalizedSpan, TurnAnalysis, SemanticCategory, CategoryStats, Trend } from './types.js';
+import type { ICategorizer } from './telemetry-pipeline.js';
+export declare class Categorizer implements ICategorizer {
+    private readonly _logger;
+    constructor(logger?: ILogger);
+    /**
+     * Classify an operation into a SemanticCategory using tiered logic.
+     *
+     * @param operationName - Span operation name (e.g. 'read_file', 'bash')
+     * @param toolName      - Optional tool name; non-empty value overrides fallback to tool_outputs
+     * @param taskType      - Optional task type (e.g. 'dev-story', 'code-review'); acts as Tier 0 (highest priority)
+     */
+    classify(operationName: string, toolName?: string, taskType?: string): SemanticCategory;
+    /**
+     * Detect whether a category's token consumption is growing, stable, or shrinking
+     * by comparing first-half vs second-half turn attribution.
+     *
+     * @param categorySpans - Spans already classified into this category
+     * @param turns         - Full turn sequence for the story
+     */
+    computeTrend(categorySpans: NormalizedSpan[], turns: TurnAnalysis[]): Trend;
+    /**
+     * Compute per-category token statistics from TurnAnalysis data (not raw spans).
+     *
+     * All six SemanticCategory values are always present in the result (zero-token
+     * categories are included with totalTokens: 0). Results are sorted by
+     * totalTokens descending.
+     *
+     * Trend is computed by comparing first-half vs second-half turn token attribution
+     * for each category, using the same 1.2×/0.8× thresholds as computeTrend().
+     *
+     * @param turns - TurnAnalysis[] for the story
+     */
+    computeCategoryStatsFromTurns(turns: TurnAnalysis[]): CategoryStats[];
+    /**
+     * Compute per-category token statistics for a complete set of spans.
+     *
+     * All six SemanticCategory values are always present in the result (zero-token
+     * categories are included with totalTokens: 0).  Results are sorted by
+     * totalTokens descending.
+     *
+     * @param spans - All NormalizedSpans for the story
+     * @param turns - TurnAnalysis sequence (may be empty)
+     */
+    computeCategoryStats(spans: NormalizedSpan[], turns: TurnAnalysis[]): CategoryStats[];
+}
+//# sourceMappingURL=categorizer.d.ts.map

package/dist/telemetry/categorizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorizer.d.ts","sourceRoot":"","sources":["../../src/telemetry/categorizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,KAAK,EACN,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAiE3D,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,CAAC,EAAE,OAAO;IAQ5B;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB;IA8DvF;;;;;;OAMG;IACH,YAAY,CAAC,aAAa,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,KAAK;IA6C3E;;;;;;;;;;;OAWG;IACH,6BAA6B,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE;IA4ErE;;;;;;;;;OASG;IACH,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE;CAgCtF"}

package/dist/telemetry/categorizer.js

@@ -0,0 +1,338 @@
+/**
+ * Categorizer — classifies telemetry spans into semantic categories and
+ * computes per-category token statistics with trend detection.
+ *
+ * Classification proceeds through three tiers:
+ *   1. Exact match against a lookup table of known operation names
+ *   2. Prefix/regex pattern match
+ *   3. Fuzzy case-insensitive substring match
+ *   4. Fallback to 'other' (overridden to 'tool_outputs' when toolName present)
+ *
+ * Architecture constraints:
+ *   - Constructor injection: accepts ILogger via constructor (defaults to console)
+ *   - Module-scope lookup tables to avoid recreation on every classify() call
+ *   - Zero external dependencies beyond types from this module
+ *
+ * Migrated to @substrate-ai/core in story 41-6b.
+ */
+// ---------------------------------------------------------------------------
+// Module-scope lookup tables (constructed once, shared across all instances)
+// ---------------------------------------------------------------------------
+/**
+ * Tier 0: task-type to semantic category mapping.
+ *
+ * When a TurnAnalysis has a known taskType, the category is determined
+ * directly from this map without consulting lower tiers.
+ */
+const TASK_TYPE_CATEGORY_MAP = new Map([
+    ['create-story', 'system_prompts'],
+    ['dev-story', 'tool_outputs'],
+    ['code-review', 'conversation_history'],
+    ['test-plan', 'system_prompts'],
+    ['minor-fixes', 'tool_outputs'],
+]);
+const EXACT_CATEGORY_MAP = new Map([
+    ['read_file', 'file_reads'],
+    ['write_file', 'tool_outputs'],
+    ['bash', 'tool_outputs'],
+    ['tool_use', 'tool_outputs'],
+    ['tool_result', 'tool_outputs'],
+    ['system_prompt', 'system_prompts'],
+    ['human_turn', 'user_prompts'],
+    ['user_message', 'user_prompts'],
+    ['assistant_turn', 'conversation_history'],
+    ['assistant_message', 'conversation_history'],
+    ['search_files', 'file_reads'],
+    ['list_files', 'file_reads'],
+    ['run_command', 'tool_outputs'],
+    ['memory_read', 'system_prompts'],
+    ['web_fetch', 'tool_outputs'],
+    // Claude Code OTLP log event names
+    ['api_request', 'conversation_history'],
+    ['tool_decision', 'tool_outputs'],
+]);
+const PREFIX_PATTERNS = [
+    { pattern: /^(bash|exec|run|spawn)/i, category: 'tool_outputs' },
+    { pattern: /^(read|open|cat|head|tail).*file/i, category: 'file_reads' },
+    { pattern: /^(list|glob|find).*file/i, category: 'file_reads' },
+    { pattern: /^tool/i, category: 'tool_outputs' },
+    { pattern: /^system/i, category: 'system_prompts' },
+    { pattern: /^(human|user)/i, category: 'user_prompts' },
+    { pattern: /^(assistant|ai|model)/i, category: 'conversation_history' },
+];
+/** All six semantic categories in a stable order for zero-fill initialisation. */
+const ALL_CATEGORIES = [
+    'tool_outputs',
+    'file_reads',
+    'system_prompts',
+    'conversation_history',
+    'user_prompts',
+    'other',
+];
+// ---------------------------------------------------------------------------
+// Categorizer
+// ---------------------------------------------------------------------------
+export class Categorizer {
+    _logger;
+    constructor(logger) {
+        this._logger = logger ?? console;
+    }
+    // ---------------------------------------------------------------------------
+    // classify
+    // ---------------------------------------------------------------------------
+    /**
+     * Classify an operation into a SemanticCategory using tiered logic.
+     *
+     * @param operationName - Span operation name (e.g. 'read_file', 'bash')
+     * @param toolName      - Optional tool name; non-empty value overrides fallback to tool_outputs
+     * @param taskType      - Optional task type (e.g. 'dev-story', 'code-review'); acts as Tier 0 (highest priority)
+     */
+    classify(operationName, toolName, taskType) {
+        // Tier 0: taskType takes highest priority when defined and mapped
+        if (taskType !== undefined && taskType.length > 0) {
+            const taskCategory = TASK_TYPE_CATEGORY_MAP.get(taskType);
+            if (taskCategory !== undefined)
+                return taskCategory;
+        }
+        // Tier 1: exact match
+        const exact = EXACT_CATEGORY_MAP.get(operationName);
+        if (exact !== undefined)
+            return exact;
+        // Tier 2: prefix/regex pattern match
+        for (const { pattern, category } of PREFIX_PATTERNS) {
+            if (pattern.test(operationName))
+                return category;
+        }
+        // Tier 3: fuzzy case-insensitive substring match
+        const lower = operationName.toLowerCase();
+        // file_reads: contains 'file' AND ('read' or 'open')
+        if (lower.includes('file') && (lower.includes('read') || lower.includes('open'))) {
+            return 'file_reads';
+        }
+        // system_prompts: contains 'system' or 'prompt'
+        if (lower.includes('system') || lower.includes('prompt')) {
+            return 'system_prompts';
+        }
+        // tool_outputs: contains 'bash' or 'exec' or 'tool'
+        if (lower.includes('bash') || lower.includes('exec') || lower.includes('tool')) {
+            return 'tool_outputs';
+        }
+        // conversation_history: contains 'conversation' or 'history' or 'chat'
+        if (lower.includes('conversation') || lower.includes('history') || lower.includes('chat')) {
+            return 'conversation_history';
+        }
+        // user_prompts: contains 'user' or 'human'
+        if (lower.includes('user') || lower.includes('human')) {
+            return 'user_prompts';
+        }
+        // Tier 4: fallback — toolName presence overrides to tool_outputs
+        if (toolName !== undefined && toolName.length > 0) {
+            return 'tool_outputs';
+        }
+        // Tier 5: log-derived turns without explicit operation names default to
+        // conversation_history (they represent LLM turns, not unknown operations)
+        if (lower === 'log_turn') {
+            return 'conversation_history';
+        }
+        return 'other';
+    }
+    // ---------------------------------------------------------------------------
+    // computeTrend
+    // ---------------------------------------------------------------------------
+    /**
+     * Detect whether a category's token consumption is growing, stable, or shrinking
+     * by comparing first-half vs second-half turn attribution.
+     *
+     * @param categorySpans - Spans already classified into this category
+     * @param turns         - Full turn sequence for the story
+     */
+    computeTrend(categorySpans, turns) {
+        if (turns.length < 2)
+            return 'stable';
+        // Build spanId → turn-index map from direct spanId and childSpans
+        const spanTurnMap = new Map();
+        for (let i = 0; i < turns.length; i++) {
+            const turn = turns[i];
+            if (turn === undefined)
+                continue;
+            spanTurnMap.set(turn.spanId, i);
+            for (const child of turn.childSpans) {
+                spanTurnMap.set(child.spanId, i);
+            }
+        }
+        const half = Math.floor(turns.length / 2);
+        let firstHalfTokens = 0;
+        let secondHalfTokens = 0;
+        for (const span of categorySpans) {
+            const turnIdx = spanTurnMap.has(span.spanId)
+                ? spanTurnMap.get(span.spanId)
+                : attributeSpanToTurnIndex(span.startTime, turns);
+            const tokens = span.inputTokens + span.outputTokens;
+            if (turnIdx < half) {
+                firstHalfTokens += tokens;
+            }
+            else {
+                secondHalfTokens += tokens;
+            }
+        }
+        if (firstHalfTokens === 0 && secondHalfTokens === 0)
+            return 'stable';
+        // If first half is zero but second is non-zero, it is growing
+        if (firstHalfTokens === 0)
+            return 'growing';
+        if (secondHalfTokens > 1.2 * firstHalfTokens)
+            return 'growing';
+        if (secondHalfTokens < 0.8 * firstHalfTokens)
+            return 'shrinking';
+        return 'stable';
+    }
+    // ---------------------------------------------------------------------------
+    // computeCategoryStatsFromTurns
+    // ---------------------------------------------------------------------------
+    /**
+     * Compute per-category token statistics from TurnAnalysis data (not raw spans).
+     *
+     * All six SemanticCategory values are always present in the result (zero-token
+     * categories are included with totalTokens: 0). Results are sorted by
+     * totalTokens descending.
+     *
+     * Trend is computed by comparing first-half vs second-half turn token attribution
+     * for each category, using the same 1.2×/0.8× thresholds as computeTrend().
+     *
+     * @param turns - TurnAnalysis[] for the story
+     */
+    computeCategoryStatsFromTurns(turns) {
+        if (turns.length === 0) {
+            return ALL_CATEGORIES.map((category) => ({
+                category,
+                totalTokens: 0,
+                percentage: 0,
+                eventCount: 0,
+                avgTokensPerEvent: 0,
+                trend: 'stable',
+            }));
+        }
+        const grandTotal = turns.reduce((sum, t) => sum + t.inputTokens + t.outputTokens, 0);
+        const buckets = new Map();
+        for (const cat of ALL_CATEGORIES) {
+            buckets.set(cat, { total: 0, count: 0, first: 0, second: 0 });
+        }
+        const half = Math.floor(turns.length / 2);
+        for (let i = 0; i < turns.length; i++) {
+            const turn = turns[i];
+            if (turn === undefined)
+                continue;
+            const cat = this.classify(turn.name, turn.toolName, turn.taskType);
+            const bucket = buckets.get(cat);
+            const tokens = turn.inputTokens + turn.outputTokens;
+            bucket.total += tokens;
+            bucket.count += 1;
+            if (i < half) {
+                bucket.first += tokens;
+            }
+            else {
+                bucket.second += tokens;
+            }
+        }
+        const results = ALL_CATEGORIES.map((category) => {
+            const bucket = buckets.get(category);
+            const totalTokens = bucket.total;
+            const eventCount = bucket.count;
+            const percentage = grandTotal > 0 ? Math.round((totalTokens / grandTotal) * 100 * 1000) / 1000 : 0;
+            const avgTokensPerEvent = eventCount > 0 ? totalTokens / eventCount : 0;
+            // Compute trend from first vs second half turn token counts for this category
+            let trend = 'stable';
+            if (turns.length >= 2) {
+                const { first, second } = bucket;
+                if (first === 0 && second === 0) {
+                    trend = 'stable';
+                }
+                else if (first === 0) {
+                    trend = 'growing';
+                }
+                else if (second > 1.2 * first) {
+                    trend = 'growing';
+                }
+                else if (second < 0.8 * first) {
+                    trend = 'shrinking';
+                }
+            }
+            return { category, totalTokens, percentage, eventCount, avgTokensPerEvent, trend };
+        });
+        this._logger.debug({ categories: results.length, grandTotal }, 'Computed category stats from turns');
+        return results.sort((a, b) => b.totalTokens - a.totalTokens);
+    }
+    // ---------------------------------------------------------------------------
+    // computeCategoryStats
+    // ---------------------------------------------------------------------------
+    /**
+     * Compute per-category token statistics for a complete set of spans.
+     *
+     * All six SemanticCategory values are always present in the result (zero-token
+     * categories are included with totalTokens: 0).  Results are sorted by
+     * totalTokens descending.
+     *
+     * @param spans - All NormalizedSpans for the story
+     * @param turns - TurnAnalysis sequence (may be empty)
+     */
+    computeCategoryStats(spans, turns) {
+        const grandTotal = spans.reduce((sum, s) => sum + s.inputTokens + s.outputTokens, 0);
+        // Bucket spans by category
+        const buckets = new Map();
+        for (const cat of ALL_CATEGORIES)
+            buckets.set(cat, []);
+        for (const span of spans) {
+            const toolName = extractToolNameFromSpan(span);
+            const cat = this.classify(span.operationName ?? span.name, toolName);
+            buckets.get(cat).push(span);
+        }
+        const results = ALL_CATEGORIES.map((category) => {
+            const catSpans = buckets.get(category);
+            const totalTokens = catSpans.reduce((sum, s) => sum + s.inputTokens + s.outputTokens, 0);
+            const eventCount = catSpans.length;
+            const percentage = grandTotal > 0 ? Math.round((totalTokens / grandTotal) * 100 * 1000) / 1000 : 0;
+            const avgTokensPerEvent = eventCount > 0 ? totalTokens / eventCount : 0;
+            const trend = this.computeTrend(catSpans, turns);
+            return { category, totalTokens, percentage, eventCount, avgTokensPerEvent, trend };
+        });
+        this._logger.debug({ categories: results.length, grandTotal }, 'Computed category stats');
+        return results.sort((a, b) => b.totalTokens - a.totalTokens);
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Binary search: find the index of the last turn whose timestamp ≤ spanStartTime.
+ * Returns 0 if no turn precedes the span.
+ */
+function attributeSpanToTurnIndex(spanStartTime, turns) {
+    let lo = 0;
+    let hi = turns.length - 1;
+    let result = 0;
+    while (lo <= hi) {
+        const mid = (lo + hi) >> 1;
+        if ((turns[mid]?.timestamp ?? 0) <= spanStartTime) {
+            result = mid;
+            lo = mid + 1;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    return result;
+}
+/**
+ * Extract a tool name from a span's attributes, checking known attribute keys
+ * in priority order.
+ */
+function extractToolNameFromSpan(span) {
+    if (!span.attributes)
+        return undefined;
+    const attrs = span.attributes;
+    const name = attrs['tool.name'] ||
+        attrs['llm.tool.name'] ||
+        attrs['claude.tool_name'];
+    return name || undefined;
+}
+//# sourceMappingURL=categorizer.js.map

package/dist/telemetry/categorizer.js.map

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

package/dist/telemetry/consumer-analyzer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ConsumerAnalyzer — groups telemetry spans by consumer key and ranks by token
+ * consumption, producing ConsumerStats for each unique operation+tool combination.
+ *
+ * A "consumer key" is `operationName|toolName`, stable across runs and safe to
+ * store as a VARCHAR(300) primary-key component in Dolt.
+ *
+ * Architecture constraints:
+ *   - Constructor injection: accepts Categorizer and ILogger (logger defaults to console)
+ *   - Delegates classification to the injected Categorizer
+ *   - Zero external dependencies beyond types and Categorizer from this module
+ *
+ * Migrated to @substrate-ai/core in story 41-6b.
+ */
+import type { ILogger } from '../dispatch/types.js';
+import type { NormalizedSpan, ConsumerStats, TurnAnalysis } from './types.js';
+import type { IConsumerAnalyzer } from './telemetry-pipeline.js';
+import type { Categorizer } from './categorizer.js';
+export declare class ConsumerAnalyzer implements IConsumerAnalyzer {
+    private readonly _categorizer;
+    private readonly _logger;
+    constructor(categorizer: Categorizer, logger?: ILogger);
+    /**
+     * Group spans by consumer key, rank by totalTokens descending, and return
+     * ConsumerStats for each non-zero-token group.
+     *
+     * @param spans - All NormalizedSpans for the story
+     */
+    analyze(spans: NormalizedSpan[]): ConsumerStats[];
+    /**
+     * Group turns by consumer key (model|toolName), rank by totalTokens descending,
+     * and return ConsumerStats for each non-zero-token group.
+     *
+     * @param turns - All TurnAnalysis records for the story
+     */
+    analyzeFromTurns(turns: TurnAnalysis[]): ConsumerStats[];
+    /**
+     * Build a stable, collision-resistant consumer key from a span.
+     * Format: `operationName|toolName` (tool part is empty string if absent).
+     */
+    private _buildConsumerKey;
+    /**
+     * Build a stable consumer key from a turn.
+     * Format: `model|toolName` (tool part is empty string if absent).
+     */
+    private _buildConsumerKeyFromTurn;
+    /**
+     * Extract a tool name from span attributes, checking three known attribute keys
+     * in priority order.
+     */
+    private _extractToolName;
+}
+//# sourceMappingURL=consumer-analyzer.d.ts.map

package/dist/telemetry/consumer-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-analyzer.d.ts","sourceRoot":"","sources":["../../src/telemetry/consumer-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAMnD,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO;IAStD;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE;IAuEjD;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE;IAqExD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CASzB"}