@substrate-ai/core 0.19.54

package/dist/telemetry/recommender.js

@@ -0,0 +1,532 @@
+/**
+ * Recommender — analyzes telemetry context and generates actionable recommendations.
+ *
+ * Implements 9 rules across three categories:
+ *   - Consumer rules: biggest_consumers, large_file_reads, expensive_bash, repeated_tool_calls
+ *   - Context/trend rules: context_growth_spike, growing_categories
+ *   - Efficiency rules: cache_efficiency, per_model_comparison, cache_delta_regression
+ *
+ * Architecture constraints:
+ *   - Pure analysis service — no DB access; caller assembles RecommenderContext
+ *   - Constructor injection: accepts ILogger (defaults to console)
+ *   - No Math.random() or Date.now() — all timestamps injected via context.generatedAt
+ *   - ID generation: sha256(ruleId:storyKey:actionTarget:index) via node:crypto
+ *
+ * Migrated to @substrate-ai/core in story 41-6b.
+ */
+import { createHash } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Recommender
+// ---------------------------------------------------------------------------
+export class Recommender {
+    _logger;
+    constructor(logger) {
+        this._logger = logger ?? console;
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Run all rules against the given context and return sorted recommendations.
+     * Output is sorted: critical → warning → info, then by potentialSavingsTokens descending.
+     * No Date.now() or Math.random() is called — generatedAt comes from context.
+     */
+    analyze(context) {
+        const allRecs = [
+            ...this._runBiggestConsumers(context),
+            ...this._runExpensiveBash(context),
+            ...this._runLargeFileReads(context),
+            ...this._runRepeatedToolCalls(context),
+            ...this._runContextGrowthSpikes(context),
+            ...this._runGrowingCategories(context),
+            ...this._runCacheEfficiency(context),
+            ...this._runModelComparison(context),
+            ...this._runCacheDeltaRegression(context),
+        ];
+        // Sort: critical first, then warning, then info; within tier by potentialSavingsTokens desc
+        const severityOrder = {
+            critical: 0,
+            warning: 1,
+            info: 2,
+        };
+        return allRecs.sort((a, b) => {
+            const sA = severityOrder[a.severity];
+            const sB = severityOrder[b.severity];
+            if (sA !== sB)
+                return sA - sB;
+            const savA = a.potentialSavingsTokens ?? 0;
+            const savB = b.potentialSavingsTokens ?? 0;
+            return savB - savA;
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Generate a 16-char hex ID from the sha256 of `ruleId:storyKey:actionTarget:index`.
+     */
+    _makeId(ruleId, storyKey, actionTarget, index) {
+        return createHash('sha256')
+            .update(`${ruleId}:${storyKey}:${actionTarget}:${index}`)
+            .digest('hex')
+            .slice(0, 16);
+    }
+    /**
+     * Map a token percentage to a severity level.
+     * >25% → critical, >10% → warning, ≤10% → info.
+     */
+    _assignSeverity(tokenPercent) {
+        if (tokenPercent > 25)
+            return 'critical';
+        if (tokenPercent > 10)
+            return 'warning';
+        return 'info';
+    }
+    /**
+     * Compute total tokens across all spans. Guards against empty arrays.
+     */
+    _totalSpanTokens(spans) {
+        return spans.reduce((sum, s) => sum + s.inputTokens + s.outputTokens, 0);
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: biggest_consumers
+    // ---------------------------------------------------------------------------
+    /**
+     * Minimum absolute token count for a consumer to be flagged.
+     * Below this, the consumer is too small to be actionable regardless of percentage.
+     */
+    static MIN_SIGNIFICANT_TOKENS = 10_000;
+    /**
+     * Identify top 3 token consumers (by inputTokens + outputTokens) where pct >5%
+     * AND absolute tokens exceed MIN_SIGNIFICANT_TOKENS.
+     *
+     * Filters out model-only consumers (empty toolName, format "model|") since those
+     * just indicate which model ran — not an actionable optimization target.
+     *
+     * Severity factors both percentage share and absolute magnitude:
+     *   - percentage-based tier via _assignSeverity()
+     *   - capped at 'warning' when absolute tokens < 50,000
+     *   - capped at 'info' when absolute tokens < 20,000
+     */
+    _runBiggestConsumers(ctx) {
+        const { consumers, storyKey, sprintId, generatedAt } = ctx;
+        if (consumers.length === 0)
+            return [];
+        const grandTotal = consumers.reduce((sum, c) => sum + c.totalTokens, 0);
+        if (grandTotal === 0)
+            return [];
+        const sorted = [...consumers].sort((a, b) => b.totalTokens - a.totalTokens);
+        const top3 = sorted.slice(0, 3).filter((c) => {
+            // Must exceed both percentage and absolute thresholds
+            if (c.percentage <= 5)
+                return false;
+            if (c.totalTokens < Recommender.MIN_SIGNIFICANT_TOKENS)
+                return false;
+            // Filter out model-only consumers (format: "operationName|" with empty toolName)
+            // These just identify which model ran, not an actionable operation
+            if (c.consumerKey.endsWith('|') && !c.consumerKey.includes('|', 0))
+                return false;
+            const parts = c.consumerKey.split('|');
+            if (parts.length === 2 && parts[1] === '')
+                return false;
+            return true;
+        });
+        return top3.map((consumer, index) => {
+            const pct = consumer.percentage;
+            let severity = this._assignSeverity(pct);
+            // Cap severity based on absolute token magnitude
+            if (consumer.totalTokens < 20_000 && severity !== 'info')
+                severity = 'info';
+            else if (consumer.totalTokens < 50_000 && severity === 'critical')
+                severity = 'warning';
+            const actionTarget = consumer.consumerKey;
+            const id = this._makeId('biggest_consumers', storyKey, actionTarget, index);
+            return {
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'biggest_consumers',
+                severity,
+                title: `High token consumer: ${consumer.consumerKey}`,
+                description: `"${consumer.consumerKey}" consumed ${consumer.totalTokens.toLocaleString()} tokens (${pct.toFixed(1)}% of total). Consider reducing the frequency or size of this operation.`,
+                potentialSavingsTokens: Math.round(consumer.totalTokens * 0.3),
+                actionTarget,
+                generatedAt,
+            };
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: large_file_reads
+    // ---------------------------------------------------------------------------
+    /**
+     * Flag file-read spans with inputTokens > 3000.
+     * Suggest using line ranges to reduce token count.
+     */
+    _runLargeFileReads(ctx) {
+        const { allSpans, storyKey, sprintId, generatedAt } = ctx;
+        if (allSpans.length === 0)
+            return [];
+        const grandTotal = this._totalSpanTokens(allSpans);
+        const largReads = allSpans.filter((s) => s.operationName === 'file_read' && s.inputTokens > 3000);
+        return largReads.map((span, index) => {
+            const pct = grandTotal > 0 ? ((span.inputTokens + span.outputTokens) / grandTotal) * 100 : 0;
+            const severity = this._assignSeverity(pct);
+            const actionTarget = span.attributes?.['file.path'] ?? span.name;
+            const id = this._makeId('large_file_reads', storyKey, actionTarget, index);
+            return {
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'large_file_reads',
+                severity,
+                title: `Large file read: ${actionTarget}`,
+                description: `File read of "${actionTarget}" consumed ${span.inputTokens.toLocaleString()} input tokens. Consider specifying line ranges (e.g., offset/limit) to reduce context size.`,
+                potentialSavingsTokens: Math.round(span.inputTokens * 0.5),
+                actionTarget,
+                generatedAt,
+            };
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: expensive_bash
+    // ---------------------------------------------------------------------------
+    /**
+     * Flag bash/execute_command spans with outputTokens > 3000.
+     * Suggest filtering or truncating command output.
+     */
+    _runExpensiveBash(ctx) {
+        const { allSpans, storyKey, sprintId, generatedAt } = ctx;
+        if (allSpans.length === 0)
+            return [];
+        const grandTotal = this._totalSpanTokens(allSpans);
+        const expensiveBash = allSpans.filter((s) => (s.attributes?.['tool.name'] === 'bash' ||
+            s.attributes?.['tool.name'] === 'execute_command' ||
+            s.name === 'bash' ||
+            s.name === 'execute_command' ||
+            (s.operationName !== undefined &&
+                (s.operationName === 'bash' || s.operationName === 'execute_command'))) &&
+            s.outputTokens > 3000);
+        return expensiveBash.map((span, index) => {
+            const pct = grandTotal > 0 ? ((span.inputTokens + span.outputTokens) / grandTotal) * 100 : 0;
+            const severity = this._assignSeverity(pct);
+            const actionTarget = span.attributes?.['bash.command']
+                ?? span.name
+                ?? 'bash';
+            const id = this._makeId('expensive_bash', storyKey, actionTarget, index);
+            return {
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'expensive_bash',
+                severity,
+                title: `Expensive bash output: ${actionTarget}`,
+                description: `Bash command "${actionTarget}" produced ${span.outputTokens.toLocaleString()} output tokens. Consider filtering output (e.g., piping to head/grep) to reduce token consumption.`,
+                potentialSavingsTokens: Math.round(span.outputTokens * 0.5),
+                actionTarget,
+                generatedAt,
+            };
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: repeated_tool_calls
+    // ---------------------------------------------------------------------------
+    /**
+     * Detect tool calls with the same actionTarget appearing more than once.
+     * Suggests caching the result to avoid redundant token consumption.
+     */
+    _runRepeatedToolCalls(ctx) {
+        const { turns, storyKey, sprintId, generatedAt, allSpans } = ctx;
+        // Collect all child spans from turns plus allSpans as fallback
+        const allChildSpans = [];
+        for (const turn of turns) {
+            for (const child of turn.childSpans) {
+                const entry = {
+                    name: child.name,
+                };
+                if (child.toolName !== undefined)
+                    entry.toolName = child.toolName;
+                allChildSpans.push(entry);
+            }
+        }
+        // Also include allSpans if turns childSpans are empty
+        if (allChildSpans.length === 0 && allSpans.length > 0) {
+            for (const span of allSpans) {
+                const spanToolName = span.attributes?.['tool.name'];
+                const spanFilePath = span.attributes?.['file.path'];
+                const entry = {
+                    name: span.name,
+                };
+                if (spanToolName !== undefined)
+                    entry.toolName = spanToolName;
+                if (spanFilePath !== undefined)
+                    entry.actionTarget = spanFilePath;
+                allChildSpans.push(entry);
+            }
+        }
+        // Group by toolName:actionTarget
+        const groups = new Map();
+        for (const span of allChildSpans) {
+            const key = `${span.toolName ?? ''}:${span.actionTarget ?? span.name}`;
+            groups.set(key, (groups.get(key) ?? 0) + 1);
+        }
+        const recommendations = [];
+        let index = 0;
+        for (const [key, count] of groups) {
+            if (count > 1) {
+                const id = this._makeId('repeated_tool_calls', storyKey, key, index);
+                recommendations.push({
+                    id,
+                    storyKey,
+                    sprintId,
+                    ruleId: 'repeated_tool_calls',
+                    severity: 'warning',
+                    title: `Repeated tool call: ${key}`,
+                    description: `"${key}" was invoked ${count} times. Consider caching the result after the first call to avoid redundant token consumption.`,
+                    actionTarget: key,
+                    generatedAt,
+                });
+                index++;
+            }
+        }
+        return recommendations;
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: context_growth_spike
+    // ---------------------------------------------------------------------------
+    /**
+     * Flag turns where isContextSpike is true.
+     * Severity is always at least 'warning'.
+     */
+    _runContextGrowthSpikes(ctx) {
+        const { turns, storyKey, sprintId, generatedAt, allSpans } = ctx;
+        if (turns.length === 0)
+            return [];
+        const grandTotal = this._totalSpanTokens(allSpans);
+        const spiketurns = turns.filter((t) => t.isContextSpike);
+        return spiketurns.map((turn, index) => {
+            const pct = grandTotal > 0 ? ((turn.inputTokens + turn.outputTokens) / grandTotal) * 100 : 0;
+            // context_growth_spike is always at least 'warning'
+            const baseSeverity = this._assignSeverity(pct);
+            const severity = baseSeverity === 'info' ? 'warning' : baseSeverity;
+            // Sort child spans by token consumption, take top 3
+            const topContributors = [...turn.childSpans]
+                .sort((a, b) => b.inputTokens + b.outputTokens - (a.inputTokens + a.outputTokens))
+                .slice(0, 3)
+                .map((c) => c.name);
+            const actionTarget = `turn:${turn.turnNumber}`;
+            const id = this._makeId('context_growth_spike', storyKey, actionTarget, index);
+            return {
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'context_growth_spike',
+                severity,
+                title: `Context spike at turn ${turn.turnNumber}`,
+                description: `Turn ${turn.turnNumber} had a context spike with ${turn.inputTokens.toLocaleString()} input tokens. Top contributors: ${topContributors.length > 0 ? topContributors.join(', ') : 'none identified'}. Consider compressing or evicting context before this turn.`,
+                potentialSavingsTokens: Math.round(turn.contextDelta * 0.3),
+                actionTarget,
+                generatedAt,
+            };
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: growing_categories
+    // ---------------------------------------------------------------------------
+    /**
+     * Categories whose growth is inherent to normal agentic work and not actionable.
+     * tool_outputs grows as the agent reads files, runs commands, etc. — expected behavior.
+     * conversation_history grows naturally as conversations progress.
+     */
+    static EXPECTED_GROWTH_CATEGORIES = new Set([
+        'tool_outputs',
+        'conversation_history',
+    ]);
+    /**
+     * Flag semantic categories with trend === 'growing'.
+     * Severity is 'info' by default; 'warning' if percentage > 25%.
+     * Skips categories whose growth is inherent to normal agentic work.
+     */
+    _runGrowingCategories(ctx) {
+        const { categories, storyKey, sprintId, generatedAt } = ctx;
+        if (categories.length === 0)
+            return [];
+        const growing = categories.filter((c) => c.trend === 'growing' && !Recommender.EXPECTED_GROWTH_CATEGORIES.has(c.category));
+        return growing.map((cat, index) => {
+            // growing_categories: floor is 'info'; only 'warning' if pct > 25
+            const severity = cat.percentage > 25 ? 'warning' : 'info';
+            const actionTarget = cat.category;
+            const id = this._makeId('growing_categories', storyKey, actionTarget, index);
+            return {
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'growing_categories',
+                severity,
+                title: `Growing category: ${cat.category}`,
+                description: `The "${cat.category}" category is growing across turns, currently at ${cat.percentage.toFixed(1)}% of total tokens (${cat.totalTokens.toLocaleString()} tokens). This trend suggests increasing context pressure from this source.`,
+                potentialSavingsTokens: Math.round(cat.totalTokens * 0.2),
+                actionTarget,
+                generatedAt,
+            };
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: cache_efficiency
+    // ---------------------------------------------------------------------------
+    /**
+     * If cache hit rate < 30%, flag the worst-performing operations and compute
+     * potential savings as totalCacheMissTokens * 0.5.
+     */
+    _runCacheEfficiency(ctx) {
+        const { efficiencyScore, allSpans, storyKey, sprintId, generatedAt } = ctx;
+        // Guard against NaN cache hit rate — treat as 0
+        const cacheHitRate = isNaN(efficiencyScore.avgCacheHitRate)
+            ? 0
+            : efficiencyScore.avgCacheHitRate;
+        if (cacheHitRate >= 0.3)
+            return [];
+        if (allSpans.length === 0)
+            return [];
+        // Compute total cache-miss tokens across all spans
+        const totalCacheMissTokens = allSpans.reduce((sum, s) => {
+            const missTokens = s.inputTokens - s.cacheReadTokens;
+            return sum + Math.max(0, missTokens);
+        }, 0);
+        if (totalCacheMissTokens === 0)
+            return [];
+        const potentialSavingsTokens = Math.round(totalCacheMissTokens * 0.5);
+        // Find top 3 worst spans by individual cache hit rate
+        const spansWithRate = allSpans
+            .filter((s) => s.inputTokens > 0)
+            .map((s) => ({
+            span: s,
+            hitRate: s.cacheReadTokens / s.inputTokens,
+        }))
+            .sort((a, b) => a.hitRate - b.hitRate)
+            .slice(0, 3);
+        const worstOps = spansWithRate.map((e) => e.span.name).join(', ');
+        const actionTarget = worstOps || 'unknown';
+        const id = this._makeId('cache_efficiency', storyKey, actionTarget, 0);
+        this._logger.debug({ storyKey, cacheHitRate, potentialSavingsTokens }, 'cache_efficiency recommendation generated');
+        return [
+            {
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'cache_efficiency',
+                severity: 'warning',
+                title: 'Low cache hit rate',
+                description: `Overall cache hit rate is ${(cacheHitRate * 100).toFixed(1)}% (below 30% threshold). Worst performing operations: ${worstOps || 'none identified'}. Potential savings if hit rate reached 50%: ${potentialSavingsTokens.toLocaleString()} tokens.`,
+                potentialSavingsTokens,
+                actionTarget,
+                generatedAt,
+            },
+        ];
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: per_model_comparison
+    // ---------------------------------------------------------------------------
+    /**
+     * Models known to be intentionally routed for lightweight tasks.
+     * These should not be flagged as "underperforming" — the orchestrator chose them
+     * deliberately for cost/speed reasons, not as a performance optimization target.
+     */
+    static INTENTIONAL_LIGHTWEIGHT_MODELS = new Set([
+        'claude-haiku-4-5-20251001',
+        'claude-haiku-4-5',
+    ]);
+    /**
+     * If more than one model is present, flag the underperforming model.
+     * Severity is 'info' by default; 'warning' if cache efficiency gap > 20pp.
+     * Skips flagging models that are intentionally routed for lightweight tasks.
+     */
+    _runModelComparison(ctx) {
+        const { efficiencyScore, storyKey, sprintId, generatedAt } = ctx;
+        const models = efficiencyScore.perModelBreakdown;
+        if (models.length <= 1)
+            return [];
+        // Find best and worst by cache hit rate
+        const sorted = [...models].sort((a, b) => b.cacheHitRate - a.cacheHitRate);
+        const best = sorted[0];
+        const worst = sorted[sorted.length - 1];
+        // Don't flag lightweight models that are intentionally routed
+        if (Recommender.INTENTIONAL_LIGHTWEIGHT_MODELS.has(worst.model))
+            return [];
+        // Don't compare a model to itself
+        if (best.model === worst.model)
+            return [];
+        const gapPP = (best.cacheHitRate - worst.cacheHitRate) * 100;
+        const severity = gapPP > 20 ? 'warning' : 'info';
+        const actionTarget = worst.model;
+        const id = this._makeId('per_model_comparison', storyKey, actionTarget, 0);
+        return [
+            {
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'per_model_comparison',
+                severity,
+                title: `Underperforming model: ${worst.model}`,
+                description: `Model "${worst.model}" has a cache hit rate of ${(worst.cacheHitRate * 100).toFixed(1)}% vs. "${best.model}" at ${(best.cacheHitRate * 100).toFixed(1)}% (gap: ${gapPP.toFixed(1)} percentage points). Consider routing tasks to the higher-performing model.`,
+                actionTarget,
+                generatedAt,
+            },
+        ];
+    }
+    // ---------------------------------------------------------------------------
+    // Rule: cache_delta_regression
+    // ---------------------------------------------------------------------------
+    /**
+     * Detect significant cache hit rate drops between consecutive dispatches.
+     * >30pp drop → warning; >50pp drop → critical.
+     * Requires dispatchScores with at least 2 entries; otherwise returns [].
+     */
+    _runCacheDeltaRegression(ctx) {
+        const { dispatchScores, storyKey, sprintId, generatedAt } = ctx;
+        if (dispatchScores === undefined || dispatchScores.length < 2)
+            return [];
+        // Sort chronologically — dispatch timestamps are set sequentially in pipeline
+        const sorted = [...dispatchScores].sort((a, b) => a.timestamp - b.timestamp);
+        const recs = [];
+        for (let i = 0; i < sorted.length - 1; i++) {
+            const prev = sorted[i];
+            const curr = sorted[i + 1];
+            const deltaPP = (prev.avgCacheHitRate - curr.avgCacheHitRate) * 100;
+            if (deltaPP <= 30)
+                continue;
+            const severity = deltaPP > 50 ? 'critical' : 'warning';
+            const prevId = prev.dispatchId ?? `dispatch-${i}`;
+            const currId = curr.dispatchId ?? `dispatch-${i + 1}`;
+            const pairKey = `${prevId}→${currId}`;
+            const id = this._makeId('cache_delta_regression', storyKey, pairKey, i);
+            recs.push({
+                id,
+                storyKey,
+                sprintId,
+                ruleId: 'cache_delta_regression',
+                severity,
+                title: `Cache regression between dispatches: ${pairKey}`,
+                description: `Cache hit rate dropped ${deltaPP.toFixed(1)} percentage points between dispatch "${prevId}" (${(prev.avgCacheHitRate * 100).toFixed(1)}%) and "${currId}" (${(curr.avgCacheHitRate * 100).toFixed(1)}%). This likely indicates a prompt prefix change broke cache alignment. Investigate whether the system prompt or context prefix was restructured between these dispatches.`,
+                actionTarget: pairKey,
+                generatedAt,
+            });
+        }
+        return recs;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal rule helpers (type narrowing)
+    // ---------------------------------------------------------------------------
+    _isToolNameMatch(span) {
+        const toolName = span.attributes?.['tool.name'];
+        return (toolName === 'bash' ||
+            toolName === 'execute_command' ||
+            span.name === 'bash' ||
+            span.name === 'execute_command' ||
+            span.operationName === 'bash' ||
+            span.operationName === 'execute_command');
+    }
+}
+// Re-expose _isToolNameMatch inline to keep _runExpensiveBash self-contained
+// (the method above is still accessible as a private helper if needed)
+void ((_) => _); // prevent unused-import lint
+//# sourceMappingURL=recommender.js.map

package/dist/telemetry/recommender.js.map

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

package/dist/telemetry/source-detector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * source-detector — detects the OTLP source from a raw payload.
+ *
+ * Inspects the `service.name` and `telemetry.sdk.name` resource attributes
+ * from either `resourceSpans` or `resourceLogs` envelope formats and maps
+ * the values to a known source identifier.
+ */
+export type { OtlpSource } from './types.js';
+import type { OtlpSource } from './types.js';
+/**
+ * Detect the OTLP source from a raw payload.
+ *
+ * Inspects `service.name` and `telemetry.sdk.name` from resource attributes
+ * in both `resourceSpans` and `resourceLogs` envelope formats.
+ *
+ * Returns 'unknown' when no match is found or input is malformed.
+ */
+export declare function detectSource(body: unknown): OtlpSource;
+//# sourceMappingURL=source-detector.d.ts.map

package/dist/telemetry/source-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-detector.d.ts","sourceRoot":"","sources":["../../src/telemetry/source-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAoF5C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAQtD"}

package/dist/telemetry/source-detector.js

@@ -0,0 +1,73 @@
+/**
+ * source-detector — detects the OTLP source from a raw payload.
+ *
+ * Inspects the `service.name` and `telemetry.sdk.name` resource attributes
+ * from either `resourceSpans` or `resourceLogs` envelope formats and maps
+ * the values to a known source identifier.
+ */
+// ---------------------------------------------------------------------------
+// Detection table
+// ---------------------------------------------------------------------------
+const SOURCE_DETECTION_TABLE = [
+    { pattern: /claude[\s-]?code/i, source: 'claude-code' },
+    { pattern: /claude/i, source: 'claude-code' },
+    { pattern: /codex/i, source: 'codex' },
+    { pattern: /openai/i, source: 'codex' },
+    { pattern: /ollama|llama|local/i, source: 'local-llm' },
+];
+/**
+ * Extract string values for service.name and telemetry.sdk.name from
+ * raw OTLP resource attributes, supporting both resourceSpans and resourceLogs.
+ */
+function extractAttributes(body) {
+    if (!body || typeof body !== 'object')
+        return [];
+    const values = [];
+    const keysOfInterest = ['service.name', 'telemetry.sdk.name'];
+    const extractFromResources = (resources) => {
+        if (!Array.isArray(resources))
+            return;
+        for (const entry of resources) {
+            if (!entry?.resource?.attributes)
+                continue;
+            for (const attr of entry.resource.attributes) {
+                if (!attr?.key || !keysOfInterest.includes(attr.key))
+                    continue;
+                const v = attr.value;
+                if (!v)
+                    continue;
+                const str = v.stringValue ??
+                    (v.intValue !== undefined ? String(v.intValue) : undefined) ??
+                    (v.doubleValue !== undefined ? String(v.doubleValue) : undefined);
+                if (str !== undefined)
+                    values.push(str);
+            }
+        }
+    };
+    const payload = body;
+    extractFromResources(payload.resourceSpans);
+    extractFromResources(payload.resourceLogs);
+    return values;
+}
+// ---------------------------------------------------------------------------
+// detectSource
+// ---------------------------------------------------------------------------
+/**
+ * Detect the OTLP source from a raw payload.
+ *
+ * Inspects `service.name` and `telemetry.sdk.name` from resource attributes
+ * in both `resourceSpans` and `resourceLogs` envelope formats.
+ *
+ * Returns 'unknown' when no match is found or input is malformed.
+ */
+export function detectSource(body) {
+    const values = extractAttributes(body);
+    for (const value of values) {
+        for (const { pattern, source } of SOURCE_DETECTION_TABLE) {
+            if (pattern.test(value))
+                return source;
+        }
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=source-detector.js.map

package/dist/telemetry/source-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-detector.js","sourceRoot":"","sources":["../../src/telemetry/source-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,sBAAsB,GAAmD;IAC7E,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAAE;IACvD,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE;IAC7C,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACtC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;IACvC,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,EAAE;CACxD,CAAA;AAiCD;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAAa;IACtC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IAEhD,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,MAAM,cAAc,GAAG,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAA;IAE7D,MAAM,oBAAoB,GAAG,CAAC,SAA0C,EAAQ,EAAE;QAChF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,OAAM;QACrC,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU;gBAAE,SAAQ;YAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAC7C,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;oBAAE,SAAQ;gBAC9D,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAA;gBACpB,IAAI,CAAC,CAAC;oBAAE,SAAQ;gBAChB,MAAM,GAAG,GACP,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC3D,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;gBACnE,IAAI,GAAG,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,IAAkD,CAAA;IAClE,oBAAoB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IAC3C,oBAAoB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAE1C,OAAO,MAAM,CAAA;AACf,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,sBAAsB,EAAE,CAAC;YACzD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,MAAM,CAAA;QACxC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}