agentic-qe 1.8.4 → 1.9.0

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"}

package/dist/telemetry/instrumentation/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withMemoryDelete = exports.withMemorySearch = exports.withMemoryRetrieve = exports.withMemoryStore = exports.memorySpanManager = exports.MemorySpanManager = exports.withTaskSpan = exports.taskSpanManager = exports.TaskSpanManager = exports.withAgentSpan = exports.InstrumentAgent = exports.agentSpanManager = exports.AgentSpanManager = void 0;
+exports.initializeInstrumentation = initializeInstrumentation;
+exports.cleanupInstrumentation = cleanupInstrumentation;
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "AgentSpanManager", { enumerable: true, get: function () { return agent_1.AgentSpanManager; } });
+Object.defineProperty(exports, "agentSpanManager", { enumerable: true, get: function () { return agent_1.agentSpanManager; } });
+Object.defineProperty(exports, "InstrumentAgent", { enumerable: true, get: function () { return agent_1.InstrumentAgent; } });
+Object.defineProperty(exports, "withAgentSpan", { enumerable: true, get: function () { return agent_1.withAgentSpan; } });
+var task_1 = require("./task");
+Object.defineProperty(exports, "TaskSpanManager", { enumerable: true, get: function () { return task_1.TaskSpanManager; } });
+Object.defineProperty(exports, "taskSpanManager", { enumerable: true, get: function () { return task_1.taskSpanManager; } });
+Object.defineProperty(exports, "withTaskSpan", { enumerable: true, get: function () { return task_1.withTaskSpan; } });
+var memory_1 = require("./memory");
+Object.defineProperty(exports, "MemorySpanManager", { enumerable: true, get: function () { return memory_1.MemorySpanManager; } });
+Object.defineProperty(exports, "memorySpanManager", { enumerable: true, get: function () { return memory_1.memorySpanManager; } });
+Object.defineProperty(exports, "withMemoryStore", { enumerable: true, get: function () { return memory_1.withMemoryStore; } });
+Object.defineProperty(exports, "withMemoryRetrieve", { enumerable: true, get: function () { return memory_1.withMemoryRetrieve; } });
+Object.defineProperty(exports, "withMemorySearch", { enumerable: true, get: function () { return memory_1.withMemorySearch; } });
+Object.defineProperty(exports, "withMemoryDelete", { enumerable: true, get: function () { return memory_1.withMemoryDelete; } });
+/**
+ * Initialize all instrumentation managers
+ *
+ * Call this during application startup to ensure proper cleanup on shutdown.
+ */
+function initializeInstrumentation() {
+    // Register cleanup handlers
+    process.on('SIGTERM', cleanupInstrumentation);
+    process.on('SIGINT', cleanupInstrumentation);
+    process.on('beforeExit', cleanupInstrumentation);
+}
+/**
+ * Cleanup all active instrumentation spans
+ *
+ * Ensures all spans are properly ended during graceful shutdown.
+ */
+function cleanupInstrumentation() {
+    const { agentSpanManager } = require('./agent');
+    const { taskSpanManager } = require('./task');
+    const { memorySpanManager } = require('./memory');
+    agentSpanManager.cleanup();
+    taskSpanManager.cleanup();
+    memorySpanManager.cleanup();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/instrumentation/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAyCH,8DAKC;AAOD,wDAQC;AA3DD,iCAOiB;AANf,yGAAA,gBAAgB,OAAA;AAChB,yGAAA,gBAAgB,OAAA;AAGhB,wGAAA,eAAe,OAAA;AACf,sGAAA,aAAa,OAAA;AAGf,+BAMgB;AALd,uGAAA,eAAe,OAAA;AACf,uGAAA,eAAe,OAAA;AAGf,oGAAA,YAAY,OAAA;AAGd,mCAekB;AAdhB,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AASjB,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAChB,0GAAA,gBAAgB,OAAA;AAGlB;;;;GAIG;AACH,SAAgB,yBAAyB;IACvC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB;IACpC,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAElD,gBAAgB,CAAC,OAAO,EAAE,CAAC;IAC3B,eAAe,CAAC,OAAO,EAAE,CAAC;IAC1B,iBAAiB,CAAC,OAAO,EAAE,CAAC;AAC9B,CAAC"}