agentic-qe 1.8.3 → 1.9.0

package/dist/persistence/schema.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * @fileoverview Database schema types and migration logic for AQE persistence layer
+ * @module persistence/schema
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURRENT_SCHEMA_VERSION = exports.DEFAULT_PERSISTENCE_CONFIG = void 0;
+exports.initializeSchema = initializeSchema;
+exports.createDatabase = createDatabase;
+exports.closeDatabase = closeDatabase;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+/**
+ * Default persistence configuration
+ */
+exports.DEFAULT_PERSISTENCE_CONFIG = {
+    dbPath: './data/aqe-telemetry.db',
+    enableWAL: true,
+    busyTimeout: 5000,
+    maxRetries: 3,
+};
+// ============================================================================
+// Schema Migration
+// ============================================================================
+/**
+ * SQL statements for creating database schema
+ */
+const SCHEMA_SQL = `
+-- Events table for telemetry
+CREATE TABLE IF NOT EXISTS events (
+  id TEXT PRIMARY KEY,
+  timestamp TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  correlation_id TEXT,
+  session_id TEXT NOT NULL
+);
+
+-- Indexes for events table
+CREATE INDEX IF NOT EXISTS idx_events_agent_id ON events(agent_id);
+CREATE INDEX IF NOT EXISTS idx_events_event_type ON events(event_type);
+CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_events_session_id ON events(session_id);
+CREATE INDEX IF NOT EXISTS idx_events_correlation_id ON events(correlation_id);
+CREATE INDEX IF NOT EXISTS idx_events_agent_time ON events(agent_id, timestamp);
+
+-- Reasoning chains table
+CREATE TABLE IF NOT EXISTS reasoning_chains (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  completed_at TEXT,
+  status TEXT NOT NULL DEFAULT 'in_progress',
+  context TEXT NOT NULL DEFAULT '{}'
+);
+
+-- Indexes for reasoning chains
+CREATE INDEX IF NOT EXISTS idx_chains_session_id ON reasoning_chains(session_id);
+CREATE INDEX IF NOT EXISTS idx_chains_agent_id ON reasoning_chains(agent_id);
+CREATE INDEX IF NOT EXISTS idx_chains_status ON reasoning_chains(status);
+CREATE INDEX IF NOT EXISTS idx_chains_created_at ON reasoning_chains(created_at);
+
+-- Reasoning steps table
+CREATE TABLE IF NOT EXISTS reasoning_steps (
+  id TEXT PRIMARY KEY,
+  chain_id TEXT NOT NULL,
+  step_order INTEGER NOT NULL,
+  thought_type TEXT NOT NULL,
+  content TEXT NOT NULL,
+  confidence REAL NOT NULL,
+  token_count INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  metadata TEXT NOT NULL DEFAULT '{}',
+  FOREIGN KEY (chain_id) REFERENCES reasoning_chains(id) ON DELETE CASCADE
+);
+
+-- Indexes for reasoning steps
+CREATE INDEX IF NOT EXISTS idx_steps_chain_id ON reasoning_steps(chain_id);
+CREATE INDEX IF NOT EXISTS idx_steps_thought_type ON reasoning_steps(thought_type);
+CREATE INDEX IF NOT EXISTS idx_steps_chain_order ON reasoning_steps(chain_id, step_order);
+
+-- Quality metrics table
+CREATE TABLE IF NOT EXISTS quality_metrics (
+  id TEXT PRIMARY KEY,
+  timestamp TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  metric_name TEXT NOT NULL,
+  metric_value REAL NOT NULL,
+  dimensions TEXT NOT NULL DEFAULT '{}'
+);
+
+-- Indexes for quality metrics
+CREATE INDEX IF NOT EXISTS idx_metrics_agent_id ON quality_metrics(agent_id);
+CREATE INDEX IF NOT EXISTS idx_metrics_name ON quality_metrics(metric_name);
+CREATE INDEX IF NOT EXISTS idx_metrics_timestamp ON quality_metrics(timestamp);
+CREATE INDEX IF NOT EXISTS idx_metrics_agent_name ON quality_metrics(agent_id, metric_name);
+CREATE INDEX IF NOT EXISTS idx_metrics_name_time ON quality_metrics(metric_name, timestamp);
+
+-- Aggregated metrics table
+CREATE TABLE IF NOT EXISTS aggregated_metrics (
+  id TEXT PRIMARY KEY,
+  period_start TEXT NOT NULL,
+  period_end TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  metric_name TEXT NOT NULL,
+  count INTEGER NOT NULL,
+  sum REAL NOT NULL,
+  min REAL NOT NULL,
+  max REAL NOT NULL,
+  avg REAL NOT NULL
+);
+
+-- Indexes for aggregated metrics
+CREATE INDEX IF NOT EXISTS idx_agg_agent_id ON aggregated_metrics(agent_id);
+CREATE INDEX IF NOT EXISTS idx_agg_name ON aggregated_metrics(metric_name);
+CREATE INDEX IF NOT EXISTS idx_agg_period ON aggregated_metrics(period_start, period_end);
+CREATE INDEX IF NOT EXISTS idx_agg_agent_name_period ON aggregated_metrics(agent_id, metric_name, period_start);
+
+-- Schema version tracking
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at TEXT NOT NULL
+);
+`;
+/**
+ * Current schema version
+ */
+exports.CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Initialize database schema
+ * @param db - Database instance
+ */
+function initializeSchema(db) {
+    // Enable foreign keys
+    db.pragma('foreign_keys = ON');
+    // Run schema creation
+    db.exec(SCHEMA_SQL);
+    // Check and update schema version
+    const versionRow = db.prepare('SELECT version FROM schema_version ORDER BY version DESC LIMIT 1').get();
+    if (!versionRow) {
+        db.prepare('INSERT INTO schema_version (version, applied_at) VALUES (?, ?)').run(exports.CURRENT_SCHEMA_VERSION, new Date().toISOString());
+    }
+}
+/**
+ * Create database connection with configuration
+ * @param config - Persistence configuration
+ * @returns Configured database instance
+ */
+function createDatabase(config = {}) {
+    const fullConfig = { ...exports.DEFAULT_PERSISTENCE_CONFIG, ...config };
+    // Ensure directory exists
+    const path = require('path');
+    const fs = require('fs');
+    const dir = path.dirname(fullConfig.dbPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const db = new better_sqlite3_1.default(fullConfig.dbPath);
+    // Configure database
+    if (fullConfig.enableWAL) {
+        db.pragma('journal_mode = WAL');
+    }
+    if (fullConfig.busyTimeout) {
+        db.pragma(`busy_timeout = ${fullConfig.busyTimeout}`);
+    }
+    // Initialize schema
+    initializeSchema(db);
+    return db;
+}
+/**
+ * Close database connection safely
+ * @param db - Database instance to close
+ */
+function closeDatabase(db) {
+    try {
+        db.close();
+    }
+    catch (error) {
+        // Database may already be closed
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/persistence/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/persistence/schema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AA2UH,4CAiBC;AAOD,wCAyBC;AAMD,sCAMC;AAtYD,oEAAsC;AA2MtC;;GAEG;AACU,QAAA,0BAA0B,GAAsB;IAC3D,MAAM,EAAE,yBAAyB;IACjC,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGlB,CAAC;AAEF;;GAEG;AACU,QAAA,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,EAAqB;IACpD,sBAAsB;IACtB,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,sBAAsB;IACtB,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEpB,kCAAkC;IAClC,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B,kEAAkE,CACnE,CAAC,GAAG,EAAqC,CAAC;IAE3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,EAAE,CAAC,OAAO,CACR,gEAAgE,CACjE,CAAC,GAAG,CAAC,8BAAsB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,SAAqC,EAAE;IACpE,MAAM,UAAU,GAAG,EAAE,GAAG,kCAA0B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEhE,0BAA0B;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,wBAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE3C,qBAAqB;IACrB,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QACzB,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,EAAE,CAAC,MAAM,CAAC,kBAAkB,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,oBAAoB;IACpB,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAErB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,EAAqB;IACjD,IAAI,CAAC;QACH,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iCAAiC;IACnC,CAAC;AACH,CAAC"}

package/dist/telemetry/bootstrap.d.ts

@@ -0,0 +1,67 @@
+/**
+ * OpenTelemetry Bootstrap Module for Agentic QE Fleet
+ *
+ * Initializes OpenTelemetry SDK with auto-instrumentations, exporters,
+ * and resource configuration for comprehensive observability.
+ */
+import { Tracer, Meter } from '@opentelemetry/api';
+import { TelemetryConfig, TelemetryInitResult, TelemetryShutdownResult } from './types';
+declare const DEFAULT_CONFIG: TelemetryConfig;
+/**
+ * Initialize OpenTelemetry SDK with configuration
+ *
+ * @param config - Telemetry configuration options
+ * @returns Initialization result with status and metadata
+ */
+export declare function initTelemetry(config?: Partial<TelemetryConfig>): Promise<TelemetryInitResult>;
+/**
+ * Gracefully shutdown OpenTelemetry SDK
+ *
+ * @returns Shutdown result with status
+ */
+export declare function shutdownTelemetry(): Promise<TelemetryShutdownResult>;
+/**
+ * Get a tracer instance for creating spans
+ *
+ * @param name - Tracer name (defaults to service name)
+ * @param version - Tracer version (defaults to service version)
+ * @returns Tracer instance
+ */
+export declare function getTracer(name?: string, version?: string): Tracer;
+/**
+ * Get a meter instance for creating metrics
+ *
+ * @param name - Meter name (defaults to service name)
+ * @param version - Meter version (defaults to service version)
+ * @returns Meter instance
+ */
+export declare function getMeter(name?: string, version?: string): Meter;
+/**
+ * Check if telemetry is initialized
+ *
+ * @returns Whether telemetry has been initialized
+ */
+export declare function isTelemetryInitialized(): boolean;
+/**
+ * Create a child span within the current context
+ *
+ * @param name - Span name
+ * @param fn - Function to execute within the span
+ * @returns Result of the function
+ */
+export declare function withSpan<T>(name: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Record an event on the current span
+ *
+ * @param name - Event name
+ * @param attributes - Event attributes
+ */
+export declare function recordSpanEvent(name: string, attributes?: Record<string, string | number | boolean>): void;
+/**
+ * Set attributes on the current span
+ *
+ * @param attributes - Attributes to set
+ */
+export declare function setSpanAttributes(attributes: Record<string, string | number | boolean>): void;
+export { DEFAULT_CONFIG as defaultTelemetryConfig };
+//# sourceMappingURL=bootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/telemetry/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,EAAyD,MAAM,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE1G,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAMjB,QAAA,MAAM,cAAc,EAAE,eAYrB,CAAC;AAMF;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GACpC,OAAO,CAAC,mBAAmB,CAAC,CA4I9B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CA2B1E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,GAAE,MAAmC,EACzC,OAAO,GAAE,MAAsC,GAC9C,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,IAAI,GAAE,MAAmC,EACzC,OAAO,GAAE,MAAsC,GAC9C,KAAK,CAEP;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AA8BD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI,CAKN;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACpD,IAAI,CAKN;AAGD,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/telemetry/bootstrap.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * OpenTelemetry Bootstrap Module for Agentic QE Fleet
+ *
+ * Initializes OpenTelemetry SDK with auto-instrumentations, exporters,
+ * and resource configuration for comprehensive observability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTelemetryConfig = void 0;
+exports.initTelemetry = initTelemetry;
+exports.shutdownTelemetry = shutdownTelemetry;
+exports.getTracer = getTracer;
+exports.getMeter = getMeter;
+exports.isTelemetryInitialized = isTelemetryInitialized;
+exports.withSpan = withSpan;
+exports.recordSpanEvent = recordSpanEvent;
+exports.setSpanAttributes = setSpanAttributes;
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const exporter_trace_otlp_grpc_1 = require("@opentelemetry/exporter-trace-otlp-grpc");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const exporter_metrics_otlp_grpc_1 = require("@opentelemetry/exporter-metrics-otlp-grpc");
+const exporter_metrics_otlp_http_1 = require("@opentelemetry/exporter-metrics-otlp-http");
+const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const api_1 = require("@opentelemetry/api");
+// Package version - read from package.json at runtime
+const PACKAGE_VERSION = process.env.npm_package_version || '1.8.3';
+// Default configuration
+const DEFAULT_CONFIG = {
+    serviceName: 'agentic-qe-fleet',
+    serviceVersion: PACKAGE_VERSION,
+    environment: process.env.NODE_ENV || 'development',
+    otlpEndpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'http://localhost:4317',
+    metricsEndpoint: process.env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT,
+    logsEndpoint: process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT,
+    useGrpc: process.env.OTEL_EXPORTER_OTLP_PROTOCOL !== 'http/protobuf',
+    enableConsoleExport: process.env.OTEL_CONSOLE_EXPORT === 'true',
+    enableAutoInstrumentation: true,
+    traceSampleRate: parseFloat(process.env.OTEL_TRACES_SAMPLER_ARG || '1.0'),
+    metricExportInterval: parseInt(process.env.OTEL_METRIC_EXPORT_INTERVAL || '60000', 10),
+};
+exports.defaultTelemetryConfig = DEFAULT_CONFIG;
+// Singleton SDK instance
+let sdk = null;
+let isInitialized = false;
+/**
+ * Initialize OpenTelemetry SDK with configuration
+ *
+ * @param config - Telemetry configuration options
+ * @returns Initialization result with status and metadata
+ */
+async function initTelemetry(config = {}) {
+    if (isInitialized && sdk) {
+        return {
+            success: true,
+            serviceName: DEFAULT_CONFIG.serviceName,
+            environment: DEFAULT_CONFIG.environment,
+            exporters: ['already-initialized'],
+        };
+    }
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    const activeExporters = [];
+    try {
+        // Set up diagnostic logging for debugging
+        if (process.env.OTEL_LOG_LEVEL === 'debug') {
+            api_1.diag.setLogger(new api_1.DiagConsoleLogger(), api_1.DiagLogLevel.DEBUG);
+        }
+        // Create resource with service identification
+        const resource = new resources_1.Resource({
+            [semantic_conventions_1.SEMRESATTRS_SERVICE_NAME]: mergedConfig.serviceName,
+            [semantic_conventions_1.SEMRESATTRS_SERVICE_VERSION]: mergedConfig.serviceVersion,
+            [semantic_conventions_1.SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: mergedConfig.environment,
+            'service.namespace': 'agentic-qe',
+            'service.instance.id': process.env.HOSTNAME || `instance-${process.pid}`,
+            ...mergedConfig.resourceAttributes,
+        });
+        // Configure trace exporter
+        let traceExporter;
+        const traceEndpoint = mergedConfig.otlpEndpoint;
+        if (mergedConfig.enableConsoleExport) {
+            traceExporter = new sdk_trace_base_1.ConsoleSpanExporter();
+            activeExporters.push('console-trace');
+        }
+        else if (traceEndpoint) {
+            if (mergedConfig.useGrpc) {
+                traceExporter = new exporter_trace_otlp_grpc_1.OTLPTraceExporter({
+                    url: traceEndpoint,
+                });
+                activeExporters.push('otlp-grpc-trace');
+            }
+            else {
+                traceExporter = new exporter_trace_otlp_http_1.OTLPTraceExporter({
+                    url: `${traceEndpoint}/v1/traces`,
+                });
+                activeExporters.push('otlp-http-trace');
+            }
+        }
+        // Configure metric exporter
+        let metricReader;
+        const metricsEndpoint = mergedConfig.metricsEndpoint || mergedConfig.otlpEndpoint;
+        if (mergedConfig.enableConsoleExport) {
+            metricReader = new sdk_metrics_1.PeriodicExportingMetricReader({
+                exporter: new sdk_metrics_1.ConsoleMetricExporter(),
+                exportIntervalMillis: mergedConfig.metricExportInterval,
+            });
+            activeExporters.push('console-metrics');
+        }
+        else if (metricsEndpoint) {
+            let metricExporter;
+            if (mergedConfig.useGrpc) {
+                metricExporter = new exporter_metrics_otlp_grpc_1.OTLPMetricExporter({
+                    url: metricsEndpoint,
+                });
+                activeExporters.push('otlp-grpc-metrics');
+            }
+            else {
+                metricExporter = new exporter_metrics_otlp_http_1.OTLPMetricExporter({
+                    url: `${metricsEndpoint}/v1/metrics`,
+                });
+                activeExporters.push('otlp-http-metrics');
+            }
+            metricReader = new sdk_metrics_1.PeriodicExportingMetricReader({
+                exporter: metricExporter,
+                exportIntervalMillis: mergedConfig.metricExportInterval,
+            });
+        }
+        // Build SDK configuration
+        const sdkConfig = {
+            resource,
+        };
+        // Add trace exporter if configured
+        if (traceExporter) {
+            // Type assertion needed due to version mismatch between sdk-node and sdk-trace-base
+            sdkConfig.spanProcessors = [new sdk_trace_base_1.BatchSpanProcessor(traceExporter)];
+        }
+        // Add metric reader if configured
+        if (metricReader) {
+            // Type assertion needed due to version mismatch between sdk-node and sdk-metrics
+            sdkConfig.metricReader = metricReader;
+        }
+        // Add auto-instrumentations if enabled
+        if (mergedConfig.enableAutoInstrumentation) {
+            sdkConfig.instrumentations = [
+                (0, auto_instrumentations_node_1.getNodeAutoInstrumentations)({
+                    // Disable some noisy instrumentations
+                    '@opentelemetry/instrumentation-fs': {
+                        enabled: false,
+                    },
+                    '@opentelemetry/instrumentation-net': {
+                        enabled: false,
+                    },
+                    '@opentelemetry/instrumentation-dns': {
+                        enabled: false,
+                    },
+                }),
+            ];
+            activeExporters.push('auto-instrumentation');
+        }
+        // Initialize SDK
+        sdk = new sdk_node_1.NodeSDK(sdkConfig);
+        await sdk.start();
+        isInitialized = true;
+        // Register shutdown handlers
+        registerShutdownHandlers();
+        return {
+            success: true,
+            serviceName: mergedConfig.serviceName,
+            environment: mergedConfig.environment,
+            exporters: activeExporters,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: errorMessage,
+            serviceName: mergedConfig.serviceName,
+            environment: mergedConfig.environment,
+            exporters: [],
+        };
+    }
+}
+/**
+ * Gracefully shutdown OpenTelemetry SDK
+ *
+ * @returns Shutdown result with status
+ */
+async function shutdownTelemetry() {
+    const startTime = Date.now();
+    if (!sdk || !isInitialized) {
+        return {
+            success: true,
+            shutdownDuration: 0,
+        };
+    }
+    try {
+        await sdk.shutdown();
+        sdk = null;
+        isInitialized = false;
+        return {
+            success: true,
+            shutdownDuration: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: errorMessage,
+            shutdownDuration: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * Get a tracer instance for creating spans
+ *
+ * @param name - Tracer name (defaults to service name)
+ * @param version - Tracer version (defaults to service version)
+ * @returns Tracer instance
+ */
+function getTracer(name = DEFAULT_CONFIG.serviceName, version = DEFAULT_CONFIG.serviceVersion) {
+    return api_1.trace.getTracer(name, version);
+}
+/**
+ * Get a meter instance for creating metrics
+ *
+ * @param name - Meter name (defaults to service name)
+ * @param version - Meter version (defaults to service version)
+ * @returns Meter instance
+ */
+function getMeter(name = DEFAULT_CONFIG.serviceName, version = DEFAULT_CONFIG.serviceVersion) {
+    return api_1.metrics.getMeter(name, version);
+}
+/**
+ * Check if telemetry is initialized
+ *
+ * @returns Whether telemetry has been initialized
+ */
+function isTelemetryInitialized() {
+    return isInitialized;
+}
+/**
+ * Register process shutdown handlers for graceful shutdown
+ */
+function registerShutdownHandlers() {
+    const shutdownHandler = async () => {
+        await shutdownTelemetry();
+        process.exit(0);
+    };
+    // Handle various shutdown signals
+    process.on('SIGTERM', shutdownHandler);
+    process.on('SIGINT', shutdownHandler);
+    // Handle uncaught exceptions - flush telemetry before exit
+    process.on('uncaughtException', async (error) => {
+        console.error('Uncaught Exception:', error);
+        await shutdownTelemetry();
+        process.exit(1);
+    });
+    // Handle unhandled rejections
+    process.on('unhandledRejection', async (reason) => {
+        console.error('Unhandled Rejection:', reason);
+        await shutdownTelemetry();
+        process.exit(1);
+    });
+}
+/**
+ * Create a child span within the current context
+ *
+ * @param name - Span name
+ * @param fn - Function to execute within the span
+ * @returns Result of the function
+ */
+async function withSpan(name, fn) {
+    const tracer = getTracer();
+    return tracer.startActiveSpan(name, async (span) => {
+        try {
+            const result = await fn();
+            span.setStatus({ code: 1 }); // OK
+            return result;
+        }
+        catch (error) {
+            span.setStatus({
+                code: 2, // ERROR
+                message: error instanceof Error ? error.message : String(error),
+            });
+            span.recordException(error);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+/**
+ * Record an event on the current span
+ *
+ * @param name - Event name
+ * @param attributes - Event attributes
+ */
+function recordSpanEvent(name, attributes) {
+    const currentSpan = api_1.trace.getActiveSpan();
+    if (currentSpan) {
+        currentSpan.addEvent(name, attributes);
+    }
+}
+/**
+ * Set attributes on the current span
+ *
+ * @param attributes - Attributes to set
+ */
+function setSpanAttributes(attributes) {
+    const currentSpan = api_1.trace.getActiveSpan();
+    if (currentSpan) {
+        currentSpan.setAttributes(attributes);
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/telemetry/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/telemetry/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAoDH,sCA8IC;AAOD,8CA2BC;AASD,8BAKC;AASD,4BAKC;AAOD,wDAEC;AAqCD,4BAqBC;AAQD,0CAQC;AAOD,8CAOC;AA/VD,sDAAkD;AAClD,0FAAwF;AACxF,wDAAoD;AACpD,8EAI6C;AAC7C,sFAAqG;AACrG,sFAAqG;AACrG,0FAAyG;AACzG,0FAAyG;AACzG,4DAAkG;AAClG,kEAAwF;AACxF,4CAA0G;AAQ1G,sDAAsD;AACtD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAEnE,wBAAwB;AACxB,MAAM,cAAc,GAAoB;IACtC,WAAW,EAAE,kBAAkB;IAC/B,cAAc,EAAE,eAAe;IAC/B,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;IAClD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,uBAAuB;IAChF,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,mCAAmC;IAChE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC;IAC1D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,eAAe;IACpE,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM;IAC/D,yBAAyB,EAAE,IAAI;IAC/B,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,KAAK,CAAC;IACzE,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,OAAO,EAAE,EAAE,CAAC;CACvF,CAAC;AA4TyB,gDAAsB;AA1TjD,yBAAyB;AACzB,IAAI,GAAG,GAAmB,IAAI,CAAC;AAC/B,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;;;GAKG;AACI,KAAK,UAAU,aAAa,CACjC,SAAmC,EAAE;IAErC,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,SAAS,EAAE,CAAC,qBAAqB,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAoB,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACvE,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,CAAC;QACH,0CAA0C;QAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC;YAC3C,UAAI,CAAC,SAAS,CAAC,IAAI,uBAAiB,EAAE,EAAE,kBAAY,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QAED,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAAC;YAC5B,CAAC,+CAAwB,CAAC,EAAE,YAAY,CAAC,WAAW;YACpD,CAAC,kDAA2B,CAAC,EAAE,YAAY,CAAC,cAAc;YAC1D,CAAC,yDAAkC,CAAC,EAAE,YAAY,CAAC,WAAW;YAC9D,mBAAmB,EAAE,YAAY;YACjC,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,YAAY,OAAO,CAAC,GAAG,EAAE;YACxE,GAAG,YAAY,CAAC,kBAAkB;SACnC,CAAC,CAAC;QAEH,2BAA2B;QAC3B,IAAI,aAAa,CAAC;QAClB,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC;QAEhD,IAAI,YAAY,CAAC,mBAAmB,EAAE,CAAC;YACrC,aAAa,GAAG,IAAI,oCAAmB,EAAE,CAAC;YAC1C,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,aAAa,EAAE,CAAC;YACzB,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBACzB,aAAa,GAAG,IAAI,4CAAqB,CAAC;oBACxC,GAAG,EAAE,aAAa;iBACnB,CAAC,CAAC;gBACH,eAAe,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,IAAI,4CAAqB,CAAC;oBACxC,GAAG,EAAE,GAAG,aAAa,YAAY;iBAClC,CAAC,CAAC;gBACH,eAAe,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,YAAY,CAAC;QACjB,MAAM,eAAe,GAAG,YAAY,CAAC,eAAe,IAAI,YAAY,CAAC,YAAY,CAAC;QAElF,IAAI,YAAY,CAAC,mBAAmB,EAAE,CAAC;YACrC,YAAY,GAAG,IAAI,2CAA6B,CAAC;gBAC/C,QAAQ,EAAE,IAAI,mCAAqB,EAAE;gBACrC,oBAAoB,EAAE,YAAY,CAAC,oBAAoB;aACxD,CAAC,CAAC;YACH,eAAe,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,eAAe,EAAE,CAAC;YAC3B,IAAI,cAAc,CAAC;YACnB,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBACzB,cAAc,GAAG,IAAI,+CAAsB,CAAC;oBAC1C,GAAG,EAAE,eAAe;iBACrB,CAAC,CAAC;gBACH,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,cAAc,GAAG,IAAI,+CAAsB,CAAC;oBAC1C,GAAG,EAAE,GAAG,eAAe,aAAa;iBACrC,CAAC,CAAC;gBACH,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC5C,CAAC;YAED,YAAY,GAAG,IAAI,2CAA6B,CAAC;gBAC/C,QAAQ,EAAE,cAAc;gBACxB,oBAAoB,EAAE,YAAY,CAAC,oBAAoB;aACxD,CAAC,CAAC;QACL,CAAC;QAED,0BAA0B;QAC1B,MAAM,SAAS,GAA6C;YAC1D,QAAQ;SACT,CAAC;QAEF,mCAAmC;QACnC,IAAI,aAAa,EAAE,CAAC;YAClB,oFAAoF;YACpF,SAAS,CAAC,cAAc,GAAG,CAAC,IAAI,mCAAkB,CAAC,aAAa,CAAQ,CAAC,CAAC;QAC5E,CAAC;QAED,kCAAkC;QAClC,IAAI,YAAY,EAAE,CAAC;YACjB,iFAAiF;YACjF,SAAS,CAAC,YAAY,GAAG,YAAmB,CAAC;QAC/C,CAAC;QAED,uCAAuC;QACvC,IAAI,YAAY,CAAC,yBAAyB,EAAE,CAAC;YAC3C,SAAS,CAAC,gBAAgB,GAAG;gBAC3B,IAAA,wDAA2B,EAAC;oBAC1B,sCAAsC;oBACtC,mCAAmC,EAAE;wBACnC,OAAO,EAAE,KAAK;qBACf;oBACD,oCAAoC,EAAE;wBACpC,OAAO,EAAE,KAAK;qBACf;oBACD,oCAAoC,EAAE;wBACpC,OAAO,EAAE,KAAK;qBACf;iBACF,CAAC;aACH,CAAC;YACF,eAAe,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC/C,CAAC;QAED,iBAAiB;QACjB,GAAG,GAAG,IAAI,kBAAO,CAAC,SAAS,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,aAAa,GAAG,IAAI,CAAC;QAErB,6BAA6B;QAC7B,wBAAwB,EAAE,CAAC;QAE3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,SAAS,EAAE,eAAe;SAC3B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,iBAAiB;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,gBAAgB,EAAE,CAAC;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,GAAG,GAAG,IAAI,CAAC;QACX,aAAa,GAAG,KAAK,CAAC;QAEtB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACzC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,YAAY;YACnB,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACzC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CACvB,OAAe,cAAc,CAAC,WAAW,EACzC,UAAkB,cAAc,CAAC,cAAc;IAE/C,OAAO,WAAK,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,QAAQ,CACtB,OAAe,cAAc,CAAC,WAAW,EACzC,UAAkB,cAAc,CAAC,cAAc;IAE/C,OAAO,aAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB;IACpC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB;IAC/B,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;QACjC,MAAM,iBAAiB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAEtC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9C,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,iBAAiB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAChD,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,iBAAiB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,EAAoB;IAEpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK;YAClC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,CAAC,EAAE,QAAQ;gBACjB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,IAAY,EACZ,UAAsD;IAEtD,MAAM,WAAW,GAAG,WAAK,CAAC,aAAa,EAAE,CAAC;IAC1C,IAAI,WAAW,EAAE,CAAC;QAChB,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,UAAqD;IAErD,MAAM,WAAW,GAAG,WAAK,CAAC,aAAa,EAAE,CAAC;IAC1C,IAAI,WAAW,EAAE,CAAC;QAChB,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * OpenTelemetry Module for Agentic QE Fleet
+ *
+ * Main entry point for telemetry functionality.
+ */
+export { initTelemetry, shutdownTelemetry, getTracer, getMeter, isTelemetryInitialized, withSpan, recordSpanEvent, setSpanAttributes, defaultTelemetryConfig, } from './bootstrap';
+export { TelemetryConfig, TelemetryInitResult, TelemetryShutdownResult, AgentAttributes, TaskAttributes, QEAttributes, ModelAttributes, MetricRecordOptions, METRIC_NAMES, HISTOGRAM_BOUNDARIES, SPAN_NAMES, } from './types';
+export * from './metrics';
+/**
+ * Quick start function for initializing telemetry with defaults
+ *
+ * @param serviceName - Optional service name override
+ * @returns Initialization result
+ */
+export declare function quickStartTelemetry(serviceName?: string): Promise<import("./types").TelemetryInitResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,sBAAsB,EACtB,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,cAAc,WAAW,CAAC;AAE1B;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,kDAgB7D"}