@gracker/smartperfetto 1.0.13

package/dist/agent/tools/sqlValidator.d.ts

@@ -0,0 +1,149 @@
+/**
+ * SQL Safety Validator
+ *
+ * Validates SQL queries before execution to ensure safety.
+ * This is the security gatekeeper for agent-generated SQL.
+ *
+ * Validation layers:
+ * 1. Syntax check - basic SQL structure
+ * 2. Statement type - only SELECT allowed
+ * 3. Table whitelist - only approved tables
+ * 4. Pattern blocklist - no dangerous patterns
+ * 5. Complexity limits - prevent runaway queries
+ *
+ * Design principles:
+ * - Fail closed (reject on uncertainty)
+ * - Defense in depth (multiple validation layers)
+ * - Clear error messages for debugging
+ * - Performance-aware (avoid regex catastrophe)
+ */
+import type { SQLConstraints } from './sqlGenerator';
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether the query passed validation */
+    valid: boolean;
+    /** Error message if validation failed */
+    reason?: string;
+    /** All validation errors (may be multiple) */
+    errors: ValidationError[];
+    /** Warnings (non-blocking issues) */
+    warnings: ValidationWarning[];
+    /** Extracted metadata from query */
+    metadata?: QueryMetadata;
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    code: ValidationErrorCode;
+    message: string;
+    /** Position in SQL string if applicable */
+    position?: number;
+}
+/**
+ * Validation warning (non-blocking)
+ */
+export interface ValidationWarning {
+    code: ValidationWarningCode;
+    message: string;
+}
+/**
+ * Error codes for validation failures
+ */
+export declare enum ValidationErrorCode {
+    EMPTY_QUERY = "EMPTY_QUERY",
+    NOT_SELECT = "NOT_SELECT",
+    MULTIPLE_STATEMENTS = "MULTIPLE_STATEMENTS",
+    FORBIDDEN_PATTERN = "FORBIDDEN_PATTERN",
+    UNKNOWN_TABLE = "UNKNOWN_TABLE",
+    SYNTAX_ERROR = "SYNTAX_ERROR",
+    COMPLEXITY_EXCEEDED = "COMPLEXITY_EXCEEDED",
+    INJECTION_ATTEMPT = "INJECTION_ATTEMPT"
+}
+/**
+ * Warning codes for non-blocking issues
+ */
+export declare enum ValidationWarningCode {
+    MISSING_LIMIT = "MISSING_LIMIT",
+    LARGE_LIMIT = "LARGE_LIMIT",
+    MULTIPLE_JOINS = "MULTIPLE_JOINS",
+    FULL_TABLE_SCAN = "FULL_TABLE_SCAN",
+    CARTESIAN_PRODUCT = "CARTESIAN_PRODUCT"
+}
+/**
+ * Extracted query metadata
+ */
+export interface QueryMetadata {
+    /** Tables referenced in query */
+    tables: string[];
+    /** Number of JOIN operations */
+    joinCount: number;
+    /** Whether query has LIMIT clause */
+    hasLimit: boolean;
+    /** LIMIT value if present */
+    limitValue?: number;
+    /** Whether query has WHERE clause */
+    hasWhere: boolean;
+    /** Estimated complexity score */
+    complexityScore: number;
+}
+/**
+ * SQL safety validator for agent-generated queries.
+ */
+export declare class SQLValidator {
+    private defaultConstraints;
+    constructor(constraints?: Partial<SQLConstraints>);
+    /**
+     * Validate an SQL query against constraints.
+     *
+     * @param sql - The SQL query to validate
+     * @param constraints - Override constraints (optional)
+     * @returns Validation result with errors/warnings
+     */
+    validate(sql: string, constraints?: Partial<SQLConstraints>): ValidationResult;
+    /**
+     * Layer 1: Basic validation.
+     */
+    private validateBasic;
+    /**
+     * Layer 2: Statement type validation.
+     */
+    private validateStatementType;
+    /**
+     * Layer 3: Forbidden pattern validation.
+     */
+    private validateForbiddenPatterns;
+    /**
+     * Layer 4: Table whitelist validation.
+     */
+    private validateTables;
+    /**
+     * Layer 5: Complexity validation.
+     */
+    private validateComplexity;
+    /**
+     * Extract metadata from SQL query.
+     */
+    private extractMetadata;
+    /**
+     * Extract table names from SQL query.
+     * This is a simplified parser - not 100% accurate but good enough for validation.
+     */
+    private extractTableNames;
+    /**
+     * Strip SQL comments from query.
+     */
+    private stripComments;
+    /**
+     * Add SQL query with automatic LIMIT if missing.
+     */
+    ensureLimit(sql: string, maxRows: number): string;
+}
+/**
+ * Create an SQL validator instance.
+ */
+export declare function createSQLValidator(constraints?: Partial<SQLConstraints>): SQLValidator;
+export default SQLValidator;
+//# sourceMappingURL=sqlValidator.d.ts.map

package/dist/agent/tools/sqlValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlValidator.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/sqlValidator.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;CACxC;AAED;;GAEG;AACH,oBAAY,qBAAqB;IAC/B,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,kBAAkB,CAAiB;gBAE/B,WAAW,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAUjD;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,gBAAgB;IAgE9E;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAUlD;AA8DD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,YAAY,CAEtF;AAED,eAAe,YAAY,CAAC"}

package/dist/agent/tools/sqlValidator.js

@@ -0,0 +1,376 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLValidator = exports.ValidationWarningCode = exports.ValidationErrorCode = void 0;
+exports.createSQLValidator = createSQLValidator;
+/**
+ * Error codes for validation failures
+ */
+var ValidationErrorCode;
+(function (ValidationErrorCode) {
+    ValidationErrorCode["EMPTY_QUERY"] = "EMPTY_QUERY";
+    ValidationErrorCode["NOT_SELECT"] = "NOT_SELECT";
+    ValidationErrorCode["MULTIPLE_STATEMENTS"] = "MULTIPLE_STATEMENTS";
+    ValidationErrorCode["FORBIDDEN_PATTERN"] = "FORBIDDEN_PATTERN";
+    ValidationErrorCode["UNKNOWN_TABLE"] = "UNKNOWN_TABLE";
+    ValidationErrorCode["SYNTAX_ERROR"] = "SYNTAX_ERROR";
+    ValidationErrorCode["COMPLEXITY_EXCEEDED"] = "COMPLEXITY_EXCEEDED";
+    ValidationErrorCode["INJECTION_ATTEMPT"] = "INJECTION_ATTEMPT";
+})(ValidationErrorCode || (exports.ValidationErrorCode = ValidationErrorCode = {}));
+/**
+ * Warning codes for non-blocking issues
+ */
+var ValidationWarningCode;
+(function (ValidationWarningCode) {
+    ValidationWarningCode["MISSING_LIMIT"] = "MISSING_LIMIT";
+    ValidationWarningCode["LARGE_LIMIT"] = "LARGE_LIMIT";
+    ValidationWarningCode["MULTIPLE_JOINS"] = "MULTIPLE_JOINS";
+    ValidationWarningCode["FULL_TABLE_SCAN"] = "FULL_TABLE_SCAN";
+    ValidationWarningCode["CARTESIAN_PRODUCT"] = "CARTESIAN_PRODUCT";
+})(ValidationWarningCode || (exports.ValidationWarningCode = ValidationWarningCode = {}));
+// =============================================================================
+// SQL Validator
+// =============================================================================
+/**
+ * SQL safety validator for agent-generated queries.
+ */
+class SQLValidator {
+    constructor(constraints) {
+        this.defaultConstraints = {
+            maxRows: constraints?.maxRows ?? 1000,
+            allowedTables: constraints?.allowedTables ?? [],
+            forbiddenPatterns: constraints?.forbiddenPatterns ?? getDefaultForbiddenPatterns(),
+            timeout: constraints?.timeout ?? 30000,
+            maxComplexity: constraints?.maxComplexity ?? 10,
+        };
+    }
+    /**
+     * Validate an SQL query against constraints.
+     *
+     * @param sql - The SQL query to validate
+     * @param constraints - Override constraints (optional)
+     * @returns Validation result with errors/warnings
+     */
+    validate(sql, constraints) {
+        const effectiveConstraints = {
+            ...this.defaultConstraints,
+            ...constraints,
+        };
+        const errors = [];
+        const warnings = [];
+        // Layer 1: Basic checks
+        const basicResult = this.validateBasic(sql);
+        errors.push(...basicResult.errors);
+        if (errors.length > 0) {
+            return { valid: false, errors, warnings };
+        }
+        // Layer 2: Statement type
+        const typeResult = this.validateStatementType(sql);
+        errors.push(...typeResult.errors);
+        if (errors.length > 0) {
+            return { valid: false, errors, warnings };
+        }
+        // Layer 3: Forbidden patterns
+        const patternResult = this.validateForbiddenPatterns(sql, effectiveConstraints.forbiddenPatterns);
+        errors.push(...patternResult.errors);
+        // Layer 4: Table whitelist (if specified)
+        if (effectiveConstraints.allowedTables.length > 0) {
+            const tableResult = this.validateTables(sql, effectiveConstraints.allowedTables);
+            errors.push(...tableResult.errors);
+            warnings.push(...tableResult.warnings);
+        }
+        // Layer 5: Complexity and performance
+        const metadata = this.extractMetadata(sql);
+        const complexityResult = this.validateComplexity(metadata, effectiveConstraints);
+        errors.push(...complexityResult.errors);
+        warnings.push(...complexityResult.warnings);
+        // Check LIMIT
+        if (!metadata.hasLimit) {
+            warnings.push({
+                code: ValidationWarningCode.MISSING_LIMIT,
+                message: `Query has no LIMIT clause. Consider adding LIMIT ${effectiveConstraints.maxRows}`,
+            });
+        }
+        else if (metadata.limitValue && metadata.limitValue > effectiveConstraints.maxRows) {
+            warnings.push({
+                code: ValidationWarningCode.LARGE_LIMIT,
+                message: `LIMIT ${metadata.limitValue} exceeds recommended max ${effectiveConstraints.maxRows}`,
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            metadata,
+            reason: errors.length > 0 ? errors[0].message : undefined,
+        };
+    }
+    /**
+     * Layer 1: Basic validation.
+     */
+    validateBasic(sql) {
+        const errors = [];
+        if (!sql || sql.trim().length === 0) {
+            errors.push({
+                code: ValidationErrorCode.EMPTY_QUERY,
+                message: 'SQL query is empty',
+            });
+            return { errors };
+        }
+        // Check for multiple statements (semicolon-separated)
+        const trimmed = sql.trim();
+        const statements = trimmed.split(';').filter(s => s.trim().length > 0);
+        if (statements.length > 1) {
+            errors.push({
+                code: ValidationErrorCode.MULTIPLE_STATEMENTS,
+                message: 'Multiple SQL statements are not allowed',
+            });
+        }
+        return { errors };
+    }
+    /**
+     * Layer 2: Statement type validation.
+     */
+    validateStatementType(sql) {
+        const errors = [];
+        const normalized = sql.trim().toUpperCase();
+        // Must start with SELECT (allowing leading whitespace and comments stripped)
+        const withoutComments = this.stripComments(normalized);
+        if (!withoutComments.startsWith('SELECT')) {
+            errors.push({
+                code: ValidationErrorCode.NOT_SELECT,
+                message: 'Only SELECT queries are allowed',
+            });
+        }
+        // Check for write operations anywhere in query
+        const writeKeywords = ['INSERT', 'UPDATE', 'DELETE', 'DROP', 'CREATE', 'ALTER', 'TRUNCATE'];
+        for (const keyword of writeKeywords) {
+            const regex = new RegExp(`\\b${keyword}\\b`, 'i');
+            if (regex.test(normalized)) {
+                errors.push({
+                    code: ValidationErrorCode.NOT_SELECT,
+                    message: `Write operation "${keyword}" is not allowed`,
+                });
+            }
+        }
+        return { errors };
+    }
+    /**
+     * Layer 3: Forbidden pattern validation.
+     */
+    validateForbiddenPatterns(sql, patterns) {
+        const errors = [];
+        for (const pattern of patterns) {
+            if (pattern.test(sql)) {
+                // Determine if this is an injection attempt
+                const isInjection = pattern.toString().includes('--') ||
+                    pattern.toString().includes('/*');
+                errors.push({
+                    code: isInjection
+                        ? ValidationErrorCode.INJECTION_ATTEMPT
+                        : ValidationErrorCode.FORBIDDEN_PATTERN,
+                    message: `Forbidden pattern detected: ${pattern.source}`,
+                });
+            }
+        }
+        return { errors };
+    }
+    /**
+     * Layer 4: Table whitelist validation.
+     */
+    validateTables(sql, allowedTables) {
+        const errors = [];
+        const warnings = [];
+        const referencedTables = this.extractTableNames(sql);
+        const allowedSet = new Set(allowedTables.map(t => t.toLowerCase()));
+        for (const table of referencedTables) {
+            if (!allowedSet.has(table.toLowerCase())) {
+                errors.push({
+                    code: ValidationErrorCode.UNKNOWN_TABLE,
+                    message: `Table "${table}" is not in the allowed list`,
+                });
+            }
+        }
+        return { errors, warnings };
+    }
+    /**
+     * Layer 5: Complexity validation.
+     */
+    validateComplexity(metadata, constraints) {
+        const errors = [];
+        const warnings = [];
+        // Check complexity score
+        if (constraints.maxComplexity && metadata.complexityScore > constraints.maxComplexity) {
+            errors.push({
+                code: ValidationErrorCode.COMPLEXITY_EXCEEDED,
+                message: `Query complexity ${metadata.complexityScore} exceeds limit ${constraints.maxComplexity}`,
+            });
+        }
+        // Warnings for potentially slow queries
+        if (metadata.joinCount >= 3) {
+            warnings.push({
+                code: ValidationWarningCode.MULTIPLE_JOINS,
+                message: `Query has ${metadata.joinCount} JOINs, may be slow`,
+            });
+        }
+        if (!metadata.hasWhere && metadata.tables.length === 1) {
+            warnings.push({
+                code: ValidationWarningCode.FULL_TABLE_SCAN,
+                message: 'Query has no WHERE clause, will scan entire table',
+            });
+        }
+        // Detect potential cartesian products
+        if (metadata.tables.length > 1 && metadata.joinCount === 0 && !metadata.hasWhere) {
+            warnings.push({
+                code: ValidationWarningCode.CARTESIAN_PRODUCT,
+                message: 'Query may produce cartesian product (multiple tables without JOIN or WHERE)',
+            });
+        }
+        return { errors, warnings };
+    }
+    /**
+     * Extract metadata from SQL query.
+     */
+    extractMetadata(sql) {
+        const upper = sql.toUpperCase();
+        // Extract table names
+        const tables = this.extractTableNames(sql);
+        // Count JOINs
+        const joinMatches = upper.match(/\bJOIN\b/g) || [];
+        const joinCount = joinMatches.length;
+        // Check for LIMIT
+        const limitMatch = upper.match(/\bLIMIT\s+(\d+)/i);
+        const hasLimit = limitMatch !== null;
+        const limitValue = hasLimit ? parseInt(limitMatch[1], 10) : undefined;
+        // Check for WHERE
+        const hasWhere = /\bWHERE\b/i.test(upper);
+        // Calculate complexity score
+        let complexityScore = 1;
+        complexityScore += joinCount * 2;
+        complexityScore += (upper.match(/\bSUBQUERY\b|\bSELECT\b/g) || []).length - 1; // Subqueries
+        complexityScore += (upper.match(/\bUNION\b/g) || []).length * 2;
+        complexityScore += (upper.match(/\bGROUP BY\b/g) || []).length;
+        complexityScore += (upper.match(/\bORDER BY\b/g) || []).length;
+        return {
+            tables,
+            joinCount,
+            hasLimit,
+            limitValue,
+            hasWhere,
+            complexityScore,
+        };
+    }
+    /**
+     * Extract table names from SQL query.
+     * This is a simplified parser - not 100% accurate but good enough for validation.
+     */
+    extractTableNames(sql) {
+        const tables = new Set();
+        // Match FROM clause
+        const fromMatch = sql.match(/\bFROM\s+([a-zA-Z_][a-zA-Z0-9_]*)/gi);
+        if (fromMatch) {
+            for (const match of fromMatch) {
+                const tableName = match.replace(/^FROM\s+/i, '').trim();
+                if (tableName && !isKeyword(tableName)) {
+                    tables.add(tableName);
+                }
+            }
+        }
+        // Match JOIN clauses
+        const joinMatch = sql.match(/\bJOIN\s+([a-zA-Z_][a-zA-Z0-9_]*)/gi);
+        if (joinMatch) {
+            for (const match of joinMatch) {
+                const tableName = match.replace(/^JOIN\s+/i, '').trim();
+                if (tableName && !isKeyword(tableName)) {
+                    tables.add(tableName);
+                }
+            }
+        }
+        return Array.from(tables);
+    }
+    /**
+     * Strip SQL comments from query.
+     */
+    stripComments(sql) {
+        // Remove single-line comments
+        let result = sql.replace(/--.*$/gm, '');
+        // Remove multi-line comments
+        result = result.replace(/\/\*[\s\S]*?\*\//g, '');
+        return result.trim();
+    }
+    /**
+     * Add SQL query with automatic LIMIT if missing.
+     */
+    ensureLimit(sql, maxRows) {
+        const upper = sql.trim().toUpperCase();
+        if (/\bLIMIT\b/i.test(upper)) {
+            return sql;
+        }
+        // Remove trailing semicolon if present
+        const trimmed = sql.trim().replace(/;$/, '');
+        return `${trimmed} LIMIT ${maxRows}`;
+    }
+}
+exports.SQLValidator = SQLValidator;
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Get default forbidden patterns.
+ */
+function getDefaultForbiddenPatterns() {
+    return [
+        // DDL statements
+        /\bDROP\b/i,
+        /\bCREATE\b/i,
+        /\bALTER\b/i,
+        /\bTRUNCATE\b/i,
+        // DML statements
+        /\bINSERT\b/i,
+        /\bUPDATE\b/i,
+        /\bDELETE\b/i,
+        /\bMERGE\b/i,
+        // DCL statements
+        /\bGRANT\b/i,
+        /\bREVOKE\b/i,
+        // System commands
+        /\bEXEC\b/i,
+        /\bEXECUTE\b/i,
+        /\bATTACH\b/i,
+        /\bDETACH\b/i,
+        // Potential injection patterns
+        /--/, // Single-line comment start
+        /\/\*/, // Block comment start
+        /;\s*SELECT/i, // Stacked query attempt
+        /'\s*OR\s*'/i, // Classic OR injection
+        /"\s*OR\s*"/i, // Double quote OR injection
+        /UNION\s+ALL\s+SELECT/i, // Union-based injection (suspicious)
+    ];
+}
+/**
+ * Check if a word is a SQL keyword.
+ */
+function isKeyword(word) {
+    const keywords = new Set([
+        'SELECT', 'FROM', 'WHERE', 'AND', 'OR', 'NOT', 'IN', 'IS', 'NULL',
+        'JOIN', 'LEFT', 'RIGHT', 'INNER', 'OUTER', 'CROSS', 'ON', 'AS',
+        'GROUP', 'BY', 'ORDER', 'ASC', 'DESC', 'LIMIT', 'OFFSET',
+        'HAVING', 'DISTINCT', 'ALL', 'UNION', 'EXCEPT', 'INTERSECT',
+        'CASE', 'WHEN', 'THEN', 'ELSE', 'END', 'LIKE', 'BETWEEN',
+        'EXISTS', 'TRUE', 'FALSE',
+    ]);
+    return keywords.has(word.toUpperCase());
+}
+// =============================================================================
+// Factory
+// =============================================================================
+/**
+ * Create an SQL validator instance.
+ */
+function createSQLValidator(constraints) {
+    return new SQLValidator(constraints);
+}
+exports.default = SQLValidator;
+//# sourceMappingURL=sqlValidator.js.map

package/dist/agent/tools/sqlValidator.js.map

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

package/dist/agent/traceRecorder.d.ts

@@ -0,0 +1,42 @@
+import { OrchestratorTrace } from './types';
+export interface RecordedTrace {
+    id: string;
+    timestamp: string;
+    query: string;
+    traceId: string;
+    orchestratorTrace: OrchestratorTrace;
+    metadata: {
+        totalDurationMs: number;
+        totalLLMCalls: number;
+        totalToolCalls: number;
+        totalFindings: number;
+        expertCount: number;
+        confidence: number;
+    };
+}
+export interface TraceRecorderConfig {
+    outputDir: string;
+    enabled: boolean;
+    maxTraces?: number;
+}
+export declare class AgentTraceRecorder {
+    private config;
+    private traces;
+    constructor(config?: Partial<TraceRecorderConfig>);
+    private ensureOutputDir;
+    record(query: string, traceId: string, orchestratorTrace: OrchestratorTrace, confidence: number): RecordedTrace;
+    private saveTrace;
+    getTrace(id: string): RecordedTrace | undefined;
+    getRecentTraces(limit?: number): RecordedTrace[];
+    getStatistics(): {
+        totalTraces: number;
+        avgDurationMs: number;
+        avgConfidence: number;
+        avgToolCalls: number;
+        avgLLMCalls: number;
+    };
+    loadTracesFromDisk(): void;
+}
+export declare function getAgentTraceRecorder(config?: Partial<TraceRecorderConfig>): AgentTraceRecorder;
+export declare function resetAgentTraceRecorder(): void;
+//# sourceMappingURL=traceRecorder.d.ts.map

package/dist/agent/traceRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceRecorder.d.ts","sourceRoot":"","sources":["../../src/agent/traceRecorder.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAsC,MAAM,SAAS,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAYjD,OAAO,CAAC,eAAe;IAMvB,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,iBAAiB,EACpC,UAAU,EAAE,MAAM,GACjB,aAAa;IAsChB,OAAO,CAAC,SAAS;IAMjB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI/C,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,aAAa,EAAE;IAIpD,aAAa,IAAI;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB;IA+BD,kBAAkB,IAAI,IAAI;CAgB3B;AAID,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,kBAAkB,CAM/F;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}