agentic-qe 1.8.3 → 1.9.0

package/dist/telemetry/index.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * OpenTelemetry Module for Agentic QE Fleet
+ *
+ * Main entry point for telemetry functionality.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPAN_NAMES = exports.HISTOGRAM_BOUNDARIES = exports.METRIC_NAMES = exports.defaultTelemetryConfig = exports.setSpanAttributes = exports.recordSpanEvent = exports.withSpan = exports.isTelemetryInitialized = exports.getMeter = exports.getTracer = exports.shutdownTelemetry = exports.initTelemetry = void 0;
+exports.quickStartTelemetry = quickStartTelemetry;
+// Bootstrap exports
+var bootstrap_1 = require("./bootstrap");
+Object.defineProperty(exports, "initTelemetry", { enumerable: true, get: function () { return bootstrap_1.initTelemetry; } });
+Object.defineProperty(exports, "shutdownTelemetry", { enumerable: true, get: function () { return bootstrap_1.shutdownTelemetry; } });
+Object.defineProperty(exports, "getTracer", { enumerable: true, get: function () { return bootstrap_1.getTracer; } });
+Object.defineProperty(exports, "getMeter", { enumerable: true, get: function () { return bootstrap_1.getMeter; } });
+Object.defineProperty(exports, "isTelemetryInitialized", { enumerable: true, get: function () { return bootstrap_1.isTelemetryInitialized; } });
+Object.defineProperty(exports, "withSpan", { enumerable: true, get: function () { return bootstrap_1.withSpan; } });
+Object.defineProperty(exports, "recordSpanEvent", { enumerable: true, get: function () { return bootstrap_1.recordSpanEvent; } });
+Object.defineProperty(exports, "setSpanAttributes", { enumerable: true, get: function () { return bootstrap_1.setSpanAttributes; } });
+Object.defineProperty(exports, "defaultTelemetryConfig", { enumerable: true, get: function () { return bootstrap_1.defaultTelemetryConfig; } });
+// Type exports
+var types_1 = require("./types");
+Object.defineProperty(exports, "METRIC_NAMES", { enumerable: true, get: function () { return types_1.METRIC_NAMES; } });
+Object.defineProperty(exports, "HISTOGRAM_BOUNDARIES", { enumerable: true, get: function () { return types_1.HISTOGRAM_BOUNDARIES; } });
+Object.defineProperty(exports, "SPAN_NAMES", { enumerable: true, get: function () { return types_1.SPAN_NAMES; } });
+// Metrics exports
+__exportStar(require("./metrics"), exports);
+/**
+ * Quick start function for initializing telemetry with defaults
+ *
+ * @param serviceName - Optional service name override
+ * @returns Initialization result
+ */
+async function quickStartTelemetry(serviceName) {
+    const { initTelemetry } = await Promise.resolve().then(() => __importStar(require('./bootstrap')));
+    const { initializeAllMetrics } = await Promise.resolve().then(() => __importStar(require('./metrics')));
+    const result = await initTelemetry({
+        serviceName: serviceName || 'agentic-qe-fleet',
+        enableConsoleExport: process.env.NODE_ENV === 'development',
+        enableAutoInstrumentation: true,
+    });
+    if (result.success) {
+        // Initialize all metrics
+        initializeAllMetrics();
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCH,kDAgBC;AArDD,oBAAoB;AACpB,yCAUqB;AATnB,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AACjB,sGAAA,SAAS,OAAA;AACT,qGAAA,QAAQ,OAAA;AACR,mHAAA,sBAAsB,OAAA;AACtB,qGAAA,QAAQ,OAAA;AACR,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,mHAAA,sBAAsB,OAAA;AAGxB,eAAe;AACf,iCAYiB;AAHf,qGAAA,YAAY,OAAA;AACZ,6GAAA,oBAAoB,OAAA;AACpB,mGAAA,UAAU,OAAA;AAGZ,kBAAkB;AAClB,4CAA0B;AAE1B;;;;;GAKG;AACI,KAAK,UAAU,mBAAmB,CAAC,WAAoB;IAC5D,MAAM,EAAE,aAAa,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;IACtD,MAAM,EAAE,oBAAoB,EAAE,GAAG,wDAAa,WAAW,GAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QACjC,WAAW,EAAE,WAAW,IAAI,kBAAkB;QAC9C,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QAC3D,yBAAyB,EAAE,IAAI;KAChC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,yBAAyB;QACzB,oBAAoB,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/telemetry/instrumentation/agent.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Agent Instrumentation - OpenTelemetry spans for agent lifecycle
+ *
+ * Provides comprehensive tracing for all 18 QE agents with semantic attributes
+ * following OpenTelemetry conventions. Automatically instruments agent lifecycle
+ * events: spawn, execute, complete, error.
+ *
+ * @module telemetry/instrumentation/agent
+ */
+import { Span, Context } from '@opentelemetry/api';
+import { AgentId, AgentStatus, QETask, AgentCapability } from '../../types';
+/**
+ * Agent span configuration
+ */
+export interface AgentSpanConfig {
+    /** Agent identifier */
+    agentId: AgentId;
+    /** Agent capabilities */
+    capabilities?: AgentCapability[];
+    /** Fleet identifier */
+    fleetId?: string;
+    /** Fleet topology */
+    topology?: string;
+    /** Parent span context */
+    parentContext?: Context;
+}
+/**
+ * Task execution span configuration
+ */
+export interface TaskSpanConfig {
+    /** Task to execute */
+    task: QETask;
+    /** Agent executing the task */
+    agentId: AgentId;
+    /** Parent span context */
+    parentContext?: Context;
+}
+/**
+ * Agent lifecycle span manager
+ *
+ * Manages OpenTelemetry spans for agent operations with automatic
+ * context propagation and semantic attribute attachment.
+ */
+export declare class AgentSpanManager {
+    private readonly tracer;
+    private activeSpans;
+    private spanCleanupTimeouts?;
+    /**
+     * Start agent spawn span
+     *
+     * Records agent creation with full metadata including capabilities,
+     * fleet topology, and resource allocation.
+     *
+     * @param config - Agent span configuration
+     * @returns Active span
+     */
+    startSpawnSpan(config: AgentSpanConfig): Span;
+    /**
+     * Complete agent spawn span
+     *
+     * @param agentId - Agent identifier
+     * @param success - Whether spawn was successful
+     * @param error - Error if spawn failed
+     */
+    completeSpawnSpan(agentId: AgentId, success: boolean, error?: Error): void;
+    /**
+     * Start agent execution span
+     *
+     * Records agent task execution with semantic attributes for task type,
+     * priority, and execution strategy.
+     *
+     * @param config - Task span configuration
+     * @returns Active span with context
+     */
+    startExecutionSpan(config: TaskSpanConfig): {
+        span: Span;
+        context: Context;
+    };
+    /**
+     * Complete agent execution span
+     *
+     * @param agentId - Agent identifier
+     * @param taskId - Task identifier
+     * @param success - Whether execution was successful
+     * @param result - Task execution result
+     * @param error - Error if execution failed
+     */
+    completeExecutionSpan(agentId: AgentId, taskId: string, success: boolean, result?: any, error?: Error): void;
+    /**
+     * Record agent status change
+     *
+     * @param agentId - Agent identifier
+     * @param oldStatus - Previous status
+     * @param newStatus - New status
+     */
+    recordStatusChange(agentId: AgentId, oldStatus: AgentStatus, newStatus: AgentStatus): void;
+    /**
+     * Record agent error
+     *
+     * @param agentId - Agent identifier
+     * @param error - Error that occurred
+     * @param context - Additional context
+     */
+    recordError(agentId: AgentId, error: Error, context?: Record<string, any>): void;
+    /**
+     * Start specialized agent operation span
+     *
+     * For agent-specific operations like test generation, coverage analysis, etc.
+     *
+     * @param operationName - Operation name (e.g., 'generate_tests', 'analyze_coverage')
+     * @param agentId - Agent identifier
+     * @param attributes - Additional attributes
+     * @returns Active span
+     */
+    startOperationSpan(operationName: string, agentId: AgentId, attributes?: Record<string, any>): Span;
+    /**
+     * Complete specialized operation span
+     *
+     * @param operationName - Operation name
+     * @param agentId - Agent identifier
+     * @param success - Whether operation was successful
+     * @param error - Error if operation failed
+     */
+    completeOperationSpan(operationName: string, agentId: AgentId, success: boolean, error?: Error): void;
+    /**
+     * Cleanup all active spans (for graceful shutdown)
+     */
+    cleanup(): void;
+    /**
+     * Build agent semantic attributes
+     */
+    private buildAgentAttributes;
+    /**
+     * Build task semantic attributes
+     */
+    private buildTaskAttributes;
+}
+/**
+ * Global agent span manager instance
+ */
+export declare const agentSpanManager: AgentSpanManager;
+/**
+ * Decorator for automatically instrumenting agent methods
+ *
+ * @param operationName - Operation name for the span
+ */
+export declare function InstrumentAgent(operationName: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Execute function within agent span context
+ *
+ * @param operationName - Operation name
+ * @param agentId - Agent identifier
+ * @param fn - Function to execute
+ * @param attributes - Additional span attributes
+ * @returns Function result
+ */
+export declare function withAgentSpan<T>(operationName: string, agentId: AgentId, fn: () => Promise<T>, attributes?: Record<string, any>): Promise<T>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/telemetry/instrumentation/agent.d.ts.map

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

package/dist/telemetry/instrumentation/agent.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * Agent Instrumentation - OpenTelemetry spans for agent lifecycle
+ *
+ * Provides comprehensive tracing for all 18 QE agents with semantic attributes
+ * following OpenTelemetry conventions. Automatically instruments agent lifecycle
+ * events: spawn, execute, complete, error.
+ *
+ * @module telemetry/instrumentation/agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentSpanManager = exports.AgentSpanManager = void 0;
+exports.InstrumentAgent = InstrumentAgent;
+exports.withAgentSpan = withAgentSpan;
+const api_1 = require("@opentelemetry/api");
+const bootstrap_1 = require("../bootstrap");
+const types_1 = require("../types");
+/**
+ * Agent lifecycle span manager
+ *
+ * Manages OpenTelemetry spans for agent operations with automatic
+ * context propagation and semantic attribute attachment.
+ */
+class AgentSpanManager {
+    constructor() {
+        this.tracer = (0, bootstrap_1.getTracer)();
+        this.activeSpans = new Map();
+    }
+    /**
+     * Start agent spawn span
+     *
+     * Records agent creation with full metadata including capabilities,
+     * fleet topology, and resource allocation.
+     *
+     * @param config - Agent span configuration
+     * @returns Active span
+     */
+    startSpawnSpan(config) {
+        const { agentId, capabilities, fleetId, topology, parentContext } = config;
+        const spanContext = parentContext || api_1.context.active();
+        const span = this.tracer.startSpan(types_1.SPAN_NAMES.FLEET_SPAWN_AGENT, {
+            attributes: this.buildAgentAttributes(agentId, fleetId, topology),
+        }, spanContext);
+        // Add capability attributes
+        if (capabilities && capabilities.length > 0) {
+            span.setAttribute('agent.capabilities.count', capabilities.length);
+            span.setAttribute('agent.capabilities.names', capabilities.map(c => c.name).join(','));
+        }
+        // Store span for lifecycle tracking
+        this.activeSpans.set(`spawn:${agentId.id}`, span);
+        span.addEvent('agent.spawn.started', {
+            'agent.id': agentId.id,
+            'agent.type': agentId.type,
+        });
+        return span;
+    }
+    /**
+     * Complete agent spawn span
+     *
+     * @param agentId - Agent identifier
+     * @param success - Whether spawn was successful
+     * @param error - Error if spawn failed
+     */
+    completeSpawnSpan(agentId, success, error) {
+        const spanKey = `spawn:${agentId.id}`;
+        const span = this.activeSpans.get(spanKey);
+        if (!span) {
+            console.warn(`[AgentSpanManager] No spawn span found for agent ${agentId.id}`);
+            return;
+        }
+        if (success) {
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+            span.addEvent('agent.spawn.completed', {
+                'agent.id': agentId.id,
+            });
+        }
+        else {
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: error?.message || 'Agent spawn failed',
+            });
+            if (error) {
+                span.recordException(error);
+            }
+            span.addEvent('agent.spawn.failed', {
+                'agent.id': agentId.id,
+                'error.message': error?.message || 'Unknown error',
+            });
+        }
+        span.end();
+        this.activeSpans.delete(spanKey);
+    }
+    /**
+     * Start agent execution span
+     *
+     * Records agent task execution with semantic attributes for task type,
+     * priority, and execution strategy.
+     *
+     * @param config - Task span configuration
+     * @returns Active span with context
+     */
+    startExecutionSpan(config) {
+        const { task, agentId, parentContext } = config;
+        const spanContext = parentContext || api_1.context.active();
+        const span = this.tracer.startSpan(types_1.SPAN_NAMES.AGENT_EXECUTE_TASK, {
+            attributes: {
+                ...this.buildAgentAttributes(agentId),
+                ...this.buildTaskAttributes(task),
+            },
+        }, spanContext);
+        // Store span for lifecycle tracking
+        const spanKey = `execute:${agentId.id}:${task.id}`;
+        this.activeSpans.set(spanKey, span);
+        // Auto-cleanup orphaned span after 5 minutes
+        const cleanupTimeout = setTimeout(() => {
+            if (this.activeSpans.has(spanKey)) {
+                console.warn(`[AgentSpanManager] Auto-cleaning orphaned span: ${spanKey}`);
+                this.completeExecutionSpan(agentId, task.id, false, undefined, new Error('Span timeout - auto-cleanup after 5 minutes'));
+            }
+        }, 300000); // 5 minutes
+        // Store cleanup timeout for cancellation
+        if (!this.spanCleanupTimeouts) {
+            this.spanCleanupTimeouts = new Map();
+        }
+        this.spanCleanupTimeouts.set(spanKey, cleanupTimeout);
+        span.addEvent('agent.task.started', {
+            'task.id': task.id,
+            'task.type': task.type,
+            'agent.id': agentId.id,
+        });
+        // Create context with active span
+        const spanContext2 = api_1.trace.setSpan(api_1.context.active(), span);
+        return { span, context: spanContext2 };
+    }
+    /**
+     * Complete agent execution span
+     *
+     * @param agentId - Agent identifier
+     * @param taskId - Task identifier
+     * @param success - Whether execution was successful
+     * @param result - Task execution result
+     * @param error - Error if execution failed
+     */
+    completeExecutionSpan(agentId, taskId, success, result, error) {
+        const spanKey = `execute:${agentId.id}:${taskId}`;
+        const span = this.activeSpans.get(spanKey);
+        if (!span) {
+            console.warn(`[AgentSpanManager] No execution span found for task ${taskId}`);
+            return;
+        }
+        // Cancel auto-cleanup timeout
+        if (this.spanCleanupTimeouts?.has(spanKey)) {
+            clearTimeout(this.spanCleanupTimeouts.get(spanKey));
+            this.spanCleanupTimeouts.delete(spanKey);
+        }
+        // Add result metrics if available
+        if (result) {
+            if (typeof result.executionTime === 'number') {
+                span.setAttribute('task.execution_time_ms', result.executionTime);
+            }
+            if (typeof result.tokensUsed === 'number') {
+                span.setAttribute('task.tokens_used', result.tokensUsed);
+            }
+            if (typeof result.cost === 'number') {
+                span.setAttribute('task.cost_usd', result.cost);
+            }
+        }
+        if (success) {
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+            span.addEvent('agent.task.completed', {
+                'task.id': taskId,
+                'agent.id': agentId.id,
+            });
+        }
+        else {
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: error?.message || 'Task execution failed',
+            });
+            if (error) {
+                span.recordException(error);
+            }
+            span.addEvent('agent.task.failed', {
+                'task.id': taskId,
+                'agent.id': agentId.id,
+                'error.message': error?.message || 'Unknown error',
+            });
+        }
+        span.end();
+        this.activeSpans.delete(spanKey);
+    }
+    /**
+     * Record agent status change
+     *
+     * @param agentId - Agent identifier
+     * @param oldStatus - Previous status
+     * @param newStatus - New status
+     */
+    recordStatusChange(agentId, oldStatus, newStatus) {
+        const span = api_1.trace.getActiveSpan();
+        if (span) {
+            span.addEvent('agent.status.changed', {
+                'agent.id': agentId.id,
+                'agent.status.old': oldStatus,
+                'agent.status.new': newStatus,
+            });
+        }
+    }
+    /**
+     * Record agent error
+     *
+     * @param agentId - Agent identifier
+     * @param error - Error that occurred
+     * @param context - Additional context
+     */
+    recordError(agentId, error, context) {
+        const span = api_1.trace.getActiveSpan();
+        if (span) {
+            span.recordException(error);
+            span.addEvent('agent.error', {
+                'agent.id': agentId.id,
+                'error.message': error.message,
+                'error.stack': error.stack,
+                ...context,
+            });
+        }
+    }
+    /**
+     * Start specialized agent operation span
+     *
+     * For agent-specific operations like test generation, coverage analysis, etc.
+     *
+     * @param operationName - Operation name (e.g., 'generate_tests', 'analyze_coverage')
+     * @param agentId - Agent identifier
+     * @param attributes - Additional attributes
+     * @returns Active span
+     */
+    startOperationSpan(operationName, agentId, attributes) {
+        const spanName = `aqe.agent.${operationName}`;
+        const span = this.tracer.startSpan(spanName, {
+            attributes: {
+                ...this.buildAgentAttributes(agentId),
+                ...attributes,
+            },
+        });
+        this.activeSpans.set(`operation:${agentId.id}:${operationName}`, span);
+        return span;
+    }
+    /**
+     * Complete specialized operation span
+     *
+     * @param operationName - Operation name
+     * @param agentId - Agent identifier
+     * @param success - Whether operation was successful
+     * @param error - Error if operation failed
+     */
+    completeOperationSpan(operationName, agentId, success, error) {
+        const spanKey = `operation:${agentId.id}:${operationName}`;
+        const span = this.activeSpans.get(spanKey);
+        if (!span) {
+            return;
+        }
+        if (success) {
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+        }
+        else {
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: error?.message || 'Operation failed',
+            });
+            if (error) {
+                span.recordException(error);
+            }
+        }
+        span.end();
+        this.activeSpans.delete(spanKey);
+    }
+    /**
+     * Cleanup all active spans (for graceful shutdown)
+     */
+    cleanup() {
+        for (const [key, span] of this.activeSpans.entries()) {
+            console.warn(`[AgentSpanManager] Force-ending orphaned span: ${key}`);
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: 'Span ended during cleanup',
+            });
+            span.end();
+        }
+        this.activeSpans.clear();
+    }
+    /**
+     * Build agent semantic attributes
+     */
+    buildAgentAttributes(agentId, fleetId, topology) {
+        const attrs = {
+            'agent.id': agentId.id,
+            'agent.type': agentId.type,
+            'agent.name': agentId.id,
+        };
+        if (fleetId) {
+            attrs['fleet.id'] = fleetId;
+        }
+        if (topology) {
+            attrs['fleet.topology'] = topology;
+        }
+        return attrs;
+    }
+    /**
+     * Build task semantic attributes
+     */
+    buildTaskAttributes(task) {
+        return {
+            'task.id': task.id,
+            'task.type': task.type,
+            'task.status': task.status,
+            'task.priority': task.priority,
+            'task.parent_id': task.parentId || '',
+        };
+    }
+}
+exports.AgentSpanManager = AgentSpanManager;
+/**
+ * Global agent span manager instance
+ */
+exports.agentSpanManager = new AgentSpanManager();
+/**
+ * Decorator for automatically instrumenting agent methods
+ *
+ * @param operationName - Operation name for the span
+ */
+function InstrumentAgent(operationName) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const agentId = this.agentId;
+            const span = exports.agentSpanManager.startOperationSpan(operationName, agentId);
+            try {
+                const result = await originalMethod.apply(this, args);
+                exports.agentSpanManager.completeOperationSpan(operationName, agentId, true);
+                return result;
+            }
+            catch (error) {
+                exports.agentSpanManager.completeOperationSpan(operationName, agentId, false, error);
+                throw error;
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Execute function within agent span context
+ *
+ * @param operationName - Operation name
+ * @param agentId - Agent identifier
+ * @param fn - Function to execute
+ * @param attributes - Additional span attributes
+ * @returns Function result
+ */
+async function withAgentSpan(operationName, agentId, fn, attributes) {
+    const span = exports.agentSpanManager.startOperationSpan(operationName, agentId, attributes);
+    try {
+        const result = await fn();
+        exports.agentSpanManager.completeOperationSpan(operationName, agentId, true);
+        return result;
+    }
+    catch (error) {
+        exports.agentSpanManager.completeOperationSpan(operationName, agentId, false, error);
+        throw error;
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/telemetry/instrumentation/agent.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * Telemetry Instrumentation - Agent and Task Tracing
+ *
+ * Comprehensive OpenTelemetry instrumentation for all 18 QE agents
+ * with automatic span management, context propagation, and semantic attributes.
+ *
+ * @module telemetry/instrumentation
+ */
+export { AgentSpanManager, agentSpanManager, AgentSpanConfig, TaskSpanConfig, InstrumentAgent, withAgentSpan, } from './agent';
+export { TaskSpanManager, taskSpanManager, TaskSpanConfig as TaskExecutionSpanConfig, TaskResult, withTaskSpan, } from './task';
+export { MemorySpanManager, memorySpanManager, MemoryStoreConfig, MemoryRetrieveConfig, MemorySearchConfig, MemoryDeleteConfig, MemoryStoreResult, MemoryRetrieveResult, MemorySearchResult, MemoryDeleteResult, withMemoryStore, withMemoryRetrieve, withMemorySearch, withMemoryDelete, } from './memory';
+/**
+ * Initialize all instrumentation managers
+ *
+ * Call this during application startup to ensure proper cleanup on shutdown.
+ */
+export declare function initializeInstrumentation(): void;
+/**
+ * Cleanup all active instrumentation spans
+ *
+ * Ensures all spans are properly ended during graceful shutdown.
+ */
+export declare function cleanupInstrumentation(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/instrumentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,IAAI,uBAAuB,EACzC,UAAU,EACV,YAAY,GACb,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAQ7C"}