@tyroneross/build-loop 0.30.3

package/dist/src/traces/storage.js

@@ -0,0 +1,399 @@
+"use strict";
+// SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Trace Storage Module
+ *
+ * Handles reading/writing traces to filesystem with indexing.
+ * Supports lazy loading of full trace data.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTraceId = generateTraceId;
+exports.generateCollectionId = generateCollectionId;
+exports.storeTrace = storeTrace;
+exports.loadTraceSummary = loadTraceSummary;
+exports.loadFullTrace = loadFullTrace;
+exports.loadAllTraces = loadAllTraces;
+exports.loadTracesBySource = loadTracesBySource;
+exports.loadTracesByCategory = loadTracesByCategory;
+exports.loadTracesBySeverity = loadTracesBySeverity;
+exports.loadTracesForIncident = loadTracesForIncident;
+exports.loadTraceIndex = loadTraceIndex;
+exports.createCollection = createCollection;
+exports.loadCollection = loadCollection;
+exports.correlateTraceToIncident = correlateTraceToIncident;
+exports.getTraceStats = getTraceStats;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../config");
+// ============================================================================
+// TRACE STORAGE
+// ============================================================================
+/**
+ * Generate a unique trace ID
+ */
+function generateTraceId() {
+    const now = new Date();
+    const dateStr = now.toISOString().slice(0, 10).replace(/-/g, '');
+    const timeStr = now.toISOString().slice(11, 19).replace(/:/g, '');
+    const random = Math.random().toString(36).substring(2, 6);
+    return `TRC_${dateStr}_${timeStr}_${random}`;
+}
+/**
+ * Generate a collection ID
+ */
+function generateCollectionId() {
+    const now = new Date();
+    const dateStr = now.toISOString().slice(0, 10).replace(/-/g, '');
+    const timeStr = now.toISOString().slice(11, 19).replace(/:/g, '');
+    const random = Math.random().toString(36).substring(2, 4);
+    return `COL_${dateStr}_${timeStr}_${random}`;
+}
+/**
+ * Store a trace with indexing
+ */
+async function storeTrace(trace, rawData, config) {
+    const paths = (0, config_1.getTracePaths)(config);
+    // Ensure directories exist
+    await promises_1.default.mkdir(paths.traces, { recursive: true });
+    await promises_1.default.mkdir(path_1.default.join(paths.raw, trace.source), { recursive: true });
+    // Store raw data if provided
+    if (rawData) {
+        const rawPath = path_1.default.join(paths.raw, trace.source, `${trace.trace_id}.json`);
+        await promises_1.default.writeFile(rawPath, JSON.stringify(rawData, null, 2), 'utf-8');
+        trace.full_data_path = rawPath;
+        trace.has_full_data = true;
+    }
+    // Update index
+    await updateTraceIndex(trace, config);
+    return { trace_id: trace.trace_id, file_path: trace.full_data_path || '' };
+}
+/**
+ * Load trace summary by ID
+ */
+async function loadTraceSummary(trace_id, config) {
+    const index = await loadTraceIndex(config);
+    const entry = index.traces[trace_id];
+    if (!entry)
+        return null;
+    return reconstructTraceFromIndex(entry);
+}
+/**
+ * Load full trace data (lazy loading)
+ */
+async function loadFullTrace(trace_id, config) {
+    const trace = await loadTraceSummary(trace_id, config);
+    if (!trace?.full_data_path)
+        return null;
+    try {
+        const content = await promises_1.default.readFile(trace.full_data_path, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Load all traces (summaries only)
+ */
+async function loadAllTraces(config) {
+    const index = await loadTraceIndex(config);
+    return Object.values(index.traces).map(reconstructTraceFromIndex);
+}
+/**
+ * Load traces by source
+ */
+async function loadTracesBySource(source, config) {
+    const index = await loadTraceIndex(config);
+    const traceIds = index.by_source[source] || [];
+    return traceIds
+        .map((id) => index.traces[id])
+        .filter(Boolean)
+        .map(reconstructTraceFromIndex);
+}
+/**
+ * Load traces by category
+ */
+async function loadTracesByCategory(category, config) {
+    const index = await loadTraceIndex(config);
+    const traceIds = index.by_category[category] || [];
+    return traceIds
+        .map((id) => index.traces[id])
+        .filter(Boolean)
+        .map(reconstructTraceFromIndex);
+}
+/**
+ * Load traces by severity
+ */
+async function loadTracesBySeverity(severity, config) {
+    const index = await loadTraceIndex(config);
+    const traceIds = index.by_severity[severity] || [];
+    return traceIds
+        .map((id) => index.traces[id])
+        .filter(Boolean)
+        .map(reconstructTraceFromIndex);
+}
+/**
+ * Load traces correlated to an incident
+ */
+async function loadTracesForIncident(incident_id, config) {
+    const index = await loadTraceIndex(config);
+    const traceIds = index.by_incident[incident_id] || [];
+    return traceIds
+        .map((id) => index.traces[id])
+        .filter(Boolean)
+        .map(reconstructTraceFromIndex);
+}
+// ============================================================================
+// INDEX MANAGEMENT
+// ============================================================================
+/**
+ * Load or initialize trace index
+ */
+async function loadTraceIndex(config) {
+    const paths = (0, config_1.getTracePaths)(config);
+    try {
+        const content = await promises_1.default.readFile(paths.index, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return createEmptyIndex();
+        }
+        throw error;
+    }
+}
+/**
+ * Create empty index
+ */
+function createEmptyIndex() {
+    return {
+        version: '1.0.0',
+        last_updated: Date.now(),
+        total_traces: 0,
+        traces: {},
+        by_source: {},
+        by_category: {},
+        by_severity: {},
+        by_date: {},
+        by_incident: {},
+    };
+}
+/**
+ * Update trace index with new trace
+ */
+async function updateTraceIndex(trace, config) {
+    const paths = (0, config_1.getTracePaths)(config);
+    const index = await loadTraceIndex(config);
+    // Create index entry
+    const entry = {
+        trace_id: trace.trace_id,
+        source: trace.source,
+        timestamp: trace.timestamp,
+        severity: trace.severity,
+        category: trace.category,
+        operation: trace.operation,
+        summary_preview: trace.summary.description.substring(0, 100),
+        has_error: trace.severity === 'error' || trace.severity === 'fatal',
+        incident_ids: trace.incident_ids || [],
+    };
+    // Add to main index
+    index.traces[trace.trace_id] = entry;
+    index.total_traces++;
+    index.last_updated = Date.now();
+    // Update by_source index
+    if (!index.by_source[trace.source]) {
+        index.by_source[trace.source] = [];
+    }
+    index.by_source[trace.source].push(trace.trace_id);
+    // Update by_category index
+    if (!index.by_category[trace.category]) {
+        index.by_category[trace.category] = [];
+    }
+    index.by_category[trace.category].push(trace.trace_id);
+    // Update by_severity index
+    if (!index.by_severity[trace.severity]) {
+        index.by_severity[trace.severity] = [];
+    }
+    index.by_severity[trace.severity].push(trace.trace_id);
+    // Update by_date index
+    const dateKey = new Date(trace.timestamp).toISOString().slice(0, 10);
+    if (!index.by_date[dateKey]) {
+        index.by_date[dateKey] = [];
+    }
+    index.by_date[dateKey].push(trace.trace_id);
+    // Update by_incident index
+    for (const incidentId of trace.incident_ids || []) {
+        if (!index.by_incident[incidentId]) {
+            index.by_incident[incidentId] = [];
+        }
+        index.by_incident[incidentId].push(trace.trace_id);
+    }
+    // Save index
+    await promises_1.default.mkdir(path_1.default.dirname(paths.index), { recursive: true });
+    await promises_1.default.writeFile(paths.index, JSON.stringify(index, null, 2), 'utf-8');
+}
+/**
+ * Reconstruct trace from index entry
+ */
+function reconstructTraceFromIndex(entry) {
+    return {
+        trace_id: entry.trace_id,
+        source: entry.source,
+        timestamp: entry.timestamp,
+        severity: entry.severity,
+        category: entry.category,
+        operation: entry.operation,
+        summary: {
+            description: entry.summary_preview,
+            highlights: [],
+        },
+        incident_ids: entry.incident_ids,
+        has_full_data: true,
+        tokens_estimated: 50,
+    };
+}
+// ============================================================================
+// COLLECTION MANAGEMENT
+// ============================================================================
+/**
+ * Create a trace collection
+ */
+async function createCollection(name, traceIds, incident_id, config) {
+    const paths = (0, config_1.getTracePaths)(config);
+    // Load traces to generate summary
+    const traces = await Promise.all(traceIds.map((id) => loadTraceSummary(id, config)));
+    const validTraces = traces.filter(Boolean);
+    // Generate summary
+    const summary = generateCollectionSummary(validTraces);
+    const collection = {
+        collection_id: generateCollectionId(),
+        name,
+        traces: traceIds,
+        created_at: Date.now(),
+        incident_id,
+        summary,
+    };
+    // Save collection
+    await promises_1.default.mkdir(paths.collections, { recursive: true });
+    const filepath = path_1.default.join(paths.collections, `${collection.collection_id}.json`);
+    await promises_1.default.writeFile(filepath, JSON.stringify(collection, null, 2), 'utf-8');
+    return collection;
+}
+/**
+ * Load a collection by ID
+ */
+async function loadCollection(collection_id, config) {
+    const paths = (0, config_1.getTracePaths)(config);
+    const filepath = path_1.default.join(paths.collections, `${collection_id}.json`);
+    try {
+        const content = await promises_1.default.readFile(filepath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Generate collection summary from traces
+ */
+function generateCollectionSummary(traces) {
+    const bySeverity = {
+        debug: 0,
+        info: 0,
+        warning: 0,
+        error: 0,
+        fatal: 0,
+    };
+    const byCategory = {};
+    let totalErrors = 0;
+    let slowestOperation;
+    let slowestDuration = 0;
+    const timestamps = traces.map((t) => t.timestamp);
+    const timeRange = {
+        start: Math.min(...timestamps),
+        end: Math.max(...timestamps),
+    };
+    for (const trace of traces) {
+        // Count by severity
+        bySeverity[trace.severity]++;
+        // Count by category
+        byCategory[trace.category] = (byCategory[trace.category] || 0) + 1;
+        // Count errors
+        if (trace.severity === 'error' || trace.severity === 'fatal') {
+            totalErrors++;
+        }
+        // Track slowest operation
+        const duration = trace.duration_ms || 0;
+        if (duration > slowestDuration) {
+            slowestDuration = duration;
+            slowestOperation = trace.operation;
+        }
+    }
+    return {
+        total_traces: traces.length,
+        by_severity: bySeverity,
+        by_category: byCategory,
+        time_range: timeRange,
+        total_errors: totalErrors,
+        slowest_operation: slowestOperation,
+    };
+}
+// ============================================================================
+// CORRELATION
+// ============================================================================
+/**
+ * Correlate a trace to an incident
+ */
+async function correlateTraceToIncident(trace_id, incident_id, config) {
+    const index = await loadTraceIndex(config);
+    // Update trace entry
+    const entry = index.traces[trace_id];
+    if (entry) {
+        if (!entry.incident_ids.includes(incident_id)) {
+            entry.incident_ids.push(incident_id);
+        }
+    }
+    // Update by_incident index
+    if (!index.by_incident[incident_id]) {
+        index.by_incident[incident_id] = [];
+    }
+    if (!index.by_incident[incident_id].includes(trace_id)) {
+        index.by_incident[incident_id].push(trace_id);
+    }
+    // Save index
+    const paths = (0, config_1.getTracePaths)(config);
+    await promises_1.default.writeFile(paths.index, JSON.stringify(index, null, 2), 'utf-8');
+}
+/**
+ * Get trace statistics
+ */
+async function getTraceStats(config) {
+    const index = await loadTraceIndex(config);
+    const bySeverity = {};
+    const bySource = {};
+    for (const [source, ids] of Object.entries(index.by_source)) {
+        bySource[source] = ids.length;
+    }
+    for (const [severity, ids] of Object.entries(index.by_severity)) {
+        bySeverity[severity] = ids.length;
+    }
+    const timestamps = Object.values(index.traces).map((t) => t.timestamp);
+    return {
+        total_traces: index.total_traces,
+        by_source: bySource,
+        by_severity: bySeverity,
+        oldest_trace: timestamps.length > 0 ? Math.min(...timestamps) : 0,
+        newest_trace: timestamps.length > 0 ? Math.max(...timestamps) : 0,
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/traces/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/traces/storage.ts"],"names":[],"mappings":";AAAA,mGAAmG;AACnG,sCAAsC;AACtC;;;;;GAKG;;;;;AAwBH,0CAOC;AAKD,oDAOC;AAKD,gCAuBC;AAKD,4CAUC;AAKD,sCAiBC;AAKD,sCAIC;AAKD,gDAWC;AAKD,oDAWC;AAKD,oDAWC;AAKD,sDAWC;AASD,wCAYC;AAiHD,4CAgCC;AAKD,wCAgBC;AA8DD,4DA0BC;AAKD,sCA6BC;AAxeD,2DAA6B;AAC7B,gDAAwB;AAYxB,sCAA0C;AAE1C,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1D,OAAO,OAAO,OAAO,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1D,OAAO,OAAO,OAAO,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,UAAU,CAC9B,KAAmB,EACnB,OAAiB,EACjB,MAAqB;IAErB,MAAM,KAAK,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAC;IAEpC,2BAA2B;IAC3B,MAAM,kBAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,kBAAE,CAAC,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExE,6BAA6B;IAC7B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,OAAO,CAAC,CAAC;QAC7E,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACvE,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;QAC/B,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,eAAe;IACf,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEtC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;AAC7E,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,MAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,MAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEvD,IAAI,CAAC,KAAK,EAAE,cAAc;QAAE,OAAO,IAAI,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,aAAa,CAAC,MAAqB;IACvD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,MAAmB,EACnB,MAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAE/C,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC7B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CACxC,QAAuB,EACvB,MAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC7B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CACxC,QAAuB,EACvB,MAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC7B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,MAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAEtD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC7B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACpC,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACI,KAAK,UAAU,cAAc,CAAC,MAAqB;IACxD,MAAM,KAAK,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,gBAAgB,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACvB,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;QACxB,YAAY,EAAE,CAAC;QACf,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,EAAmC;QAC9C,WAAW,EAAE,EAAqC;QAClD,WAAW,EAAE,EAAqC;QAClD,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAC7B,KAAmB,EACnB,MAAqB;IAErB,MAAM,KAAK,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3C,qBAAqB;IACrB,MAAM,KAAK,GAAoB;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;QAC5D,SAAS,EAAE,KAAK,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO;QACnE,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;KACvC,CAAC;IAEF,oBAAoB;IACpB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IACrC,KAAK,CAAC,YAAY,EAAE,CAAC;IACrB,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEhC,yBAAyB;IACzB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IACD,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEnD,2BAA2B;IAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEvD,2BAA2B;IAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEvD,uBAAuB;IACvB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE5C,2BAA2B;IAC3B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,aAAa;IACb,MAAM,kBAAE,CAAC,KAAK,CAAC,cAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,kBAAE,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,KAAsB;IACvD,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE;YACP,WAAW,EAAE,KAAK,CAAC,eAAe;YAClC,UAAU,EAAE,EAAE;SACf;QACD,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,EAAE;KACrB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;GAEG;AACI,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,QAAkB,EAClB,WAAoB,EACpB,MAAqB;IAErB,MAAM,KAAK,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAC;IAEpC,kCAAkC;IAClC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CACnD,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAmB,CAAC;IAE7D,mBAAmB;IACnB,MAAM,OAAO,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAoB;QAClC,aAAa,EAAE,oBAAoB,EAAE;QACrC,IAAI;QACJ,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,WAAW;QACX,OAAO;KACR,CAAC;IAEF,kBAAkB;IAClB,MAAM,kBAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,aAAa,OAAO,CAAC,CAAC;IAClF,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAE3E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAClC,aAAqB,EACrB,MAAqB;IAErB,MAAM,KAAK,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,aAAa,OAAO,CAAC,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,MAAsB;IACvD,MAAM,UAAU,GAAkC;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,gBAAoC,CAAC;IACzC,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG;QAChB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAC9B,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;KAC7B,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,oBAAoB;QACpB,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAE7B,oBAAoB;QACpB,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAEnE,eAAe;QACf,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC7D,WAAW,EAAE,CAAC;QAChB,CAAC;QAED,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;QACxC,IAAI,QAAQ,GAAG,eAAe,EAAE,CAAC;YAC/B,eAAe,GAAG,QAAQ,CAAC;YAC3B,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,WAAW;QACzB,iBAAiB,EAAE,gBAAgB;KACpC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACI,KAAK,UAAU,wBAAwB,CAC5C,QAAgB,EAChB,WAAmB,EACnB,MAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3C,qBAAqB;IACrB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,aAAa;IACb,MAAM,KAAK,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAC;IACpC,MAAM,kBAAE,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,aAAa,CAAC,MAAqB;IAOvD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3C,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAChE,UAAU,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEvE,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,YAAY,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/src/traces/summarizer.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Trace Summarizer
+ *
+ * Token-budget-aware summarization of traces for LLM context injection.
+ * Prioritizes errors and performance issues within token limits.
+ */
+import type { UnifiedTrace, TraceSummary, SummarizationConfig } from './types';
+/**
+ * TraceSummarizer - Main class for trace summarization
+ */
+export declare class TraceSummarizer {
+    private config;
+    constructor(config?: Partial<SummarizationConfig>);
+    /**
+     * Generate context-efficient summary for LLM injection
+     *
+     * Structure:
+     * 1. Errors (highest priority)
+     * 2. Performance issues
+     * 3. Timeline of operations
+     */
+    summarizeForContext(traces: UnifiedTrace[]): string;
+    /**
+     * Build error summary section
+     */
+    private buildErrorSummary;
+    /**
+     * Build performance summary section
+     */
+    private buildPerformanceSummary;
+    /**
+     * Build timeline summary section
+     */
+    private buildTimelineSummary;
+    /**
+     * Sort traces by relevance for summarization
+     */
+    private sortByRelevance;
+    /**
+     * Estimate tokens for text
+     */
+    estimateTokens(text: string): number;
+}
+/**
+ * Create a compact trace summary for single trace
+ */
+export declare function createTraceSummary(operation: string, description: string, options?: {
+    error?: {
+        type: string;
+        message: string;
+        stack_preview?: string;
+    };
+    performance?: {
+        duration_ms: number;
+        is_slow: boolean;
+        bottleneck?: string;
+    };
+    highlights?: Array<{
+        label: string;
+        value: string;
+    }>;
+}): TraceSummary;
+/**
+ * Summarize multiple traces into a single paragraph
+ */
+export declare function summarizeTracesCompact(traces: UnifiedTrace[]): string;
+/**
+ * Filter traces by time window
+ */
+export declare function filterByTimeWindow(traces: UnifiedTrace[], windowMinutes: number): UnifiedTrace[];
+/**
+ * Group traces by category
+ */
+export declare function groupByCategory(traces: UnifiedTrace[]): Record<string, UnifiedTrace[]>;
+/**
+ * Get top errors from traces
+ */
+export declare function getTopErrors(traces: UnifiedTrace[], limit?: number): UnifiedTrace[];
+/**
+ * Get slowest operations from traces
+ */
+export declare function getSlowestOperations(traces: UnifiedTrace[], limit?: number): UnifiedTrace[];
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/src/traces/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../../src/traces/summarizer.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,mBAAmB,EAGpB,MAAM,SAAS,CAAC;AAgBjB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAIrD;;;;;;;OAOG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM;IA4CnD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAIrC;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,WAAW,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD,GACA,YAAY,CAOd;AAUD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CA+BrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EAAE,EACtB,aAAa,EAAE,MAAM,GACpB,YAAY,EAAE,CAGhB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EAAE,GACrB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAWhC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EAAE,EACtB,KAAK,GAAE,MAAU,GAChB,YAAY,EAAE,CAKhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EAAE,EACtB,KAAK,GAAE,MAAU,GAChB,YAAY,EAAE,CAKhB"}