@a5c-ai/agent-mux-observability 0.4.0

package/dist/telemetry-simple.js

@@ -0,0 +1,87 @@
+/**
+ * Simple telemetry implementation that logs metrics.
+ */
+class SimpleTelemetryImpl {
+    emit(event) {
+        process.stderr.write(JSON.stringify(event) + '\n');
+    }
+    startRunSpan(_runId, _agent, _model) {
+        return null;
+    }
+    startToolCallSpan(_toolName, _toolCallId, _parentSpan) {
+        return null;
+    }
+    startSubagentSpan(_subagentId, _agentName, _parentSpan) {
+        return null;
+    }
+    recordRunStart(agent, model) {
+        this.emit({
+            timestamp: new Date().toISOString(),
+            event: 'run_start',
+            agent,
+            model: model || 'unknown',
+        });
+    }
+    recordRunComplete(agent, model, duration, cost) {
+        this.emit({
+            timestamp: new Date().toISOString(),
+            event: 'run_complete',
+            agent,
+            model: model || 'unknown',
+            duration,
+            cost,
+        });
+    }
+    recordRunError(agent, model, error, cost) {
+        this.emit({
+            timestamp: new Date().toISOString(),
+            event: 'run_error',
+            agent,
+            model: model || 'unknown',
+            error_type: error instanceof Error ? error.constructor.name : 'unknown',
+            error_message: error instanceof Error ? error.message : error,
+            cost,
+        });
+    }
+    recordToolCall(toolName, duration, success) {
+        this.emit({
+            timestamp: new Date().toISOString(),
+            event: 'tool_call',
+            tool: toolName,
+            duration,
+            status: success ? 'success' : 'error',
+        });
+    }
+    recordAuthEvent(agent, method, success) {
+        this.emit({
+            timestamp: new Date().toISOString(),
+            event: 'auth_event',
+            agent,
+            method,
+            status: success ? 'success' : 'failure',
+        });
+    }
+    endSpanSuccess(_span, _attributes) {
+        // No-op in simple telemetry mode
+    }
+    endSpanError(_span, _error, _attributes) {
+        // No-op in simple telemetry mode
+    }
+}
+/**
+ * Default telemetry instance.
+ */
+export const telemetry = new SimpleTelemetryImpl();
+/**
+ * Initialize telemetry (no-op for simple implementation).
+ */
+export function initializeTelemetry() {
+    // No-op for simple implementation
+}
+/**
+ * Shutdown telemetry (no-op for simple implementation).
+ */
+export async function shutdownTelemetry() {
+    // No-op for simple implementation
+}
+//# sourceMappingURL=telemetry-simple.js.map

package/dist/telemetry-simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-simple.js","sourceRoot":"","sources":["../src/telemetry-simple.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,mBAAmB;IACf,IAAI,CAAC,KAA8B;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,MAAe;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,SAAiB,EAAE,WAAmB,EAAE,WAAqB;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,WAAmB,EAAE,UAAkB,EAAE,WAAqB;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,KAAc;QAC1C,IAAI,CAAC,IAAI,CAAC;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,WAAW;YAClB,KAAK;YACL,KAAK,EAAE,KAAK,IAAI,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,KAAa,EAAE,KAAyB,EAAE,QAAgB,EAAE,IAAe;QAC3F,IAAI,CAAC,IAAI,CAAC;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,cAAc;YACrB,KAAK;YACL,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,QAAQ;YACR,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,KAAyB,EAAE,KAAqB,EAAE,IAAe;QAC7F,IAAI,CAAC,IAAI,CAAC;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,WAAW;YAClB,KAAK;YACL,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACvE,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YAC7D,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAgB;QACjE,IAAI,CAAC,IAAI,CAAC;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;SACtC,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,KAAa,EAAE,MAAc,EAAE,OAAgB;QAC7D,IAAI,CAAC,IAAI,CAAC;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,YAAY;YACnB,KAAK;YACL,MAAM;YACN,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SACxC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,KAAc,EAAE,WAAuD;QACpF,iCAAiC;IACnC,CAAC;IAED,YAAY,CACV,KAAc,EACd,MAAsB,EACtB,WAAuD;QAEvD,iCAAiC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,kCAAkC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,kCAAkC;AACpC,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,137 @@
+/**
+ * OpenTelemetry integration for agent-mux.
+ *
+ * Provides metrics, tracing, and observability for agent operations,
+ * performance monitoring, and error tracking.
+ */
+import { type Meter, type Span, type Counter, type Histogram, type Gauge } from '@opentelemetry/api';
+import { Telemetry, CostInfo } from './types.js';
+/**
+ * Telemetry configuration options.
+ */
+export interface TelemetryConfig {
+    /** Service name for telemetry */
+    serviceName?: string;
+    /** Service version */
+    serviceVersion?: string;
+    /** Enable tracing */
+    enableTracing?: boolean;
+    /** Enable metrics */
+    enableMetrics?: boolean;
+    /** OTLP endpoint for exporting data */
+    otlpEndpoint?: string;
+    /** Custom attributes to attach to all telemetry */
+    baseAttributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Agent-mux specific metrics.
+ */
+export interface AgentMuxMetrics {
+    /** Counter for total agent runs */
+    runsTotal: Counter;
+    /** Counter for agent run errors */
+    runsErrors: Counter;
+    /** Histogram for agent run duration */
+    runsDuration: Histogram;
+    /** Histogram for tool call duration */
+    toolCallsDuration: Histogram;
+    /** Counter for tool calls */
+    toolCallsTotal: Counter;
+    /** Gauge for active runs */
+    activeRuns: Gauge;
+    /** Histogram for token usage */
+    tokensUsed: Histogram;
+    /** Counter for cost tracking */
+    costTotal: Counter;
+    /** Counter for authentication events */
+    authEvents: Counter;
+}
+/**
+ * Telemetry manager for agent-mux observability.
+ */
+export declare class TelemetryManager implements Telemetry {
+    private sdk;
+    private meter;
+    private tracer;
+    private metrics;
+    private config;
+    constructor(config?: TelemetryConfig);
+    /**
+     * Initialize OpenTelemetry SDK.
+     */
+    initialize(): void;
+    /**
+     * Shutdown telemetry.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Create metrics instances.
+     */
+    private createMetrics;
+    /**
+     * Start tracing an agent run.
+     */
+    startRunSpan(runId: string, agent: string, model?: string): Span;
+    /**
+     * Start tracing a tool call.
+     */
+    startToolCallSpan(toolName: string, toolCallId: string, parentSpan?: Span): Span;
+    /**
+     * Start tracing a subagent delegation.
+     */
+    startSubagentSpan(subagentId: string, agentName: string, parentSpan?: Span): Span;
+    /**
+     * Record agent run start.
+     */
+    recordRunStart(agent: string, model?: string): void;
+    /**
+     * Record agent run completion.
+     */
+    recordRunComplete(agent: string, model: string | undefined, duration: number, cost?: {
+        totalUsd?: number;
+        inputTokens?: number;
+        outputTokens?: number;
+        thinkingTokens?: number;
+    }): void;
+    /**
+     * Record agent run error.
+     */
+    recordRunError(agent: string, model: string | undefined, error: Error | string, cost?: CostInfo): void;
+    /**
+     * Record tool call.
+     */
+    recordToolCall(toolName: string, duration: number, success: boolean): void;
+    /**
+     * Record authentication event.
+     */
+    recordAuthEvent(agent: string, method: string, success: boolean): void;
+    /**
+     * Set active runs gauge.
+     */
+    setActiveRuns(count: number): void;
+    /**
+     * End a span with success.
+     */
+    endSpanSuccess(span: Span, attributes?: Record<string, string | number | boolean>): void;
+    /**
+     * End a span with error.
+     */
+    endSpanError(span: Span, error: Error | string, attributes?: Record<string, string | number | boolean>): void;
+    /**
+     * Get the meter instance.
+     */
+    getMeter(): Meter;
+}
+/**
+ * Default telemetry manager instance.
+ */
+export declare const telemetry: TelemetryManager;
+/**
+ * Initialize telemetry if enabled.
+ */
+export declare function initializeTelemetry(): void;
+/**
+ * Shutdown telemetry.
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAML,KAAK,KAAK,EAEV,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,KAAK,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,YAAY,EAAE,SAAS,CAAC;IACxB,uCAAuC;IACvC,iBAAiB,EAAE,SAAS,CAAC;IAC7B,6BAA6B;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,4BAA4B;IAC5B,UAAU,EAAE,KAAK,CAAC;IAClB,gCAAgC;IAChC,UAAU,EAAE,SAAS,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,GAAE,eAAoB;IAgBxC;;OAEG;IACH,UAAU,IAAI,IAAI;IAoBlB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAyCrB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAYhE;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI;IAahF;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI;IAajF;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQnD;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IAiDR;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI;IA2BtG;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAY1E;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQtE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAQxF;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAY7G;;OAEG;IACH,QAAQ,IAAI,KAAK;CAGlB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,kBAKpB,CAAC;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD"}

package/dist/telemetry.js

@@ -0,0 +1,313 @@
+/**
+ * OpenTelemetry integration for agent-mux.
+ *
+ * Provides metrics, tracing, and observability for agent operations,
+ * performance monitoring, and error tracking.
+ */
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
+import { metrics, trace, context, SpanStatusCode, SpanKind, } from '@opentelemetry/api';
+/**
+ * Telemetry manager for agent-mux observability.
+ */
+export class TelemetryManager {
+    sdk = null;
+    meter;
+    tracer;
+    metrics;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            serviceName: 'agent-mux',
+            serviceVersion: process.env.npm_package_version || '0.0.0',
+            enableTracing: true,
+            enableMetrics: true,
+            otlpEndpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'http://localhost:4318',
+            baseAttributes: {},
+            ...config,
+        };
+        this.meter = metrics.getMeter('@a5c-ai/agent-mux', this.config.serviceVersion);
+        this.tracer = trace.getTracer('@a5c-ai/agent-mux', this.config.serviceVersion);
+        this.metrics = this.createMetrics();
+    }
+    /**
+     * Initialize OpenTelemetry SDK.
+     */
+    initialize() {
+        if (this.sdk) {
+            return; // Already initialized
+        }
+        this.sdk = new NodeSDK({
+            resource: resourceFromAttributes({
+                [ATTR_SERVICE_NAME]: this.config.serviceName,
+                [ATTR_SERVICE_VERSION]: this.config.serviceVersion,
+            }),
+            instrumentations: [getNodeAutoInstrumentations({
+                    // Disable some noisy instrumentations
+                    '@opentelemetry/instrumentation-dns': { enabled: false },
+                    '@opentelemetry/instrumentation-net': { enabled: false },
+                })],
+        });
+        this.sdk.start();
+    }
+    /**
+     * Shutdown telemetry.
+     */
+    async shutdown() {
+        if (this.sdk) {
+            await this.sdk.shutdown();
+            this.sdk = null;
+        }
+    }
+    /**
+     * Create metrics instances.
+     */
+    createMetrics() {
+        return {
+            runsTotal: this.meter.createCounter('agent_runs_total', {
+                description: 'Total number of agent runs',
+                unit: '1',
+            }),
+            runsErrors: this.meter.createCounter('agent_runs_errors_total', {
+                description: 'Total number of failed agent runs',
+                unit: '1',
+            }),
+            runsDuration: this.meter.createHistogram('agent_runs_duration_ms', {
+                description: 'Duration of agent runs in milliseconds',
+                unit: 'ms',
+            }),
+            toolCallsDuration: this.meter.createHistogram('tool_calls_duration_ms', {
+                description: 'Duration of tool calls in milliseconds',
+                unit: 'ms',
+            }),
+            toolCallsTotal: this.meter.createCounter('tool_calls_total', {
+                description: 'Total number of tool calls',
+                unit: '1',
+            }),
+            activeRuns: this.meter.createGauge('agent_active_runs', {
+                description: 'Number of currently active agent runs',
+                unit: '1',
+            }),
+            tokensUsed: this.meter.createHistogram('tokens_used_total', {
+                description: 'Total tokens used (input + output + thinking)',
+                unit: '1',
+            }),
+            costTotal: this.meter.createCounter('cost_usd_total', {
+                description: 'Total cost in USD',
+                unit: 'USD',
+            }),
+            authEvents: this.meter.createCounter('auth_events_total', {
+                description: 'Authentication events',
+                unit: '1',
+            }),
+        };
+    }
+    /**
+     * Start tracing an agent run.
+     */
+    startRunSpan(runId, agent, model) {
+        return this.tracer.startSpan(`agent.run.${agent}`, {
+            kind: SpanKind.SERVER,
+            attributes: {
+                'agent.run.id': runId,
+                'agent.name': agent,
+                'agent.model': model || 'unknown',
+                ...this.config.baseAttributes,
+            },
+        });
+    }
+    /**
+     * Start tracing a tool call.
+     */
+    startToolCallSpan(toolName, toolCallId, parentSpan) {
+        const spanContext = parentSpan ? trace.setSpan(context.active(), parentSpan) : context.active();
+        return context.with(spanContext, () => this.tracer.startSpan(`tool.call.${toolName}`, {
+            kind: SpanKind.CLIENT,
+            attributes: {
+                'tool.name': toolName,
+                'tool.call.id': toolCallId,
+                ...this.config.baseAttributes,
+            },
+        }));
+    }
+    /**
+     * Start tracing a subagent delegation.
+     */
+    startSubagentSpan(subagentId, agentName, parentSpan) {
+        const spanContext = parentSpan ? trace.setSpan(context.active(), parentSpan) : context.active();
+        return context.with(spanContext, () => this.tracer.startSpan(`subagent.dispatch.${agentName}`, {
+            kind: SpanKind.INTERNAL,
+            attributes: {
+                'subagent.id': subagentId,
+                'subagent.name': agentName,
+                ...this.config.baseAttributes,
+            },
+        }));
+    }
+    /**
+     * Record agent run start.
+     */
+    recordRunStart(agent, model) {
+        this.metrics.runsTotal.add(1, {
+            agent,
+            model: model || 'unknown',
+            status: 'started',
+        });
+    }
+    /**
+     * Record agent run completion.
+     */
+    recordRunComplete(agent, model, duration, cost) {
+        this.metrics.runsDuration.record(duration, {
+            agent,
+            model: model || 'unknown',
+            status: 'completed',
+        });
+        if (cost) {
+            const totalTokens = (cost.inputTokens || 0) + (cost.outputTokens || 0) + (cost.thinkingTokens || 0);
+            this.metrics.tokensUsed.record(totalTokens, {
+                agent,
+                model: model || 'unknown',
+                token_type: 'total',
+            });
+            if (cost.inputTokens) {
+                this.metrics.tokensUsed.record(cost.inputTokens, {
+                    agent,
+                    model: model || 'unknown',
+                    token_type: 'input',
+                });
+            }
+            if (cost.outputTokens) {
+                this.metrics.tokensUsed.record(cost.outputTokens, {
+                    agent,
+                    model: model || 'unknown',
+                    token_type: 'output',
+                });
+            }
+            if (cost.thinkingTokens) {
+                this.metrics.tokensUsed.record(cost.thinkingTokens, {
+                    agent,
+                    model: model || 'unknown',
+                    token_type: 'thinking',
+                });
+            }
+            if (cost.totalUsd) {
+                this.metrics.costTotal.add(cost.totalUsd, {
+                    agent,
+                    model: model || 'unknown',
+                });
+            }
+        }
+    }
+    /**
+     * Record agent run error.
+     */
+    recordRunError(agent, model, error, cost) {
+        this.metrics.runsErrors.add(1, {
+            agent,
+            model: model || 'unknown',
+            error_type: error instanceof Error ? error.constructor.name : 'unknown',
+        });
+        if (cost) {
+            const totalTokens = (cost.inputTokens || 0) + (cost.outputTokens || 0) + (cost.thinkingTokens || 0);
+            this.metrics.tokensUsed.record(totalTokens, {
+                agent,
+                model: model || 'unknown',
+                token_type: 'total',
+                status: 'error',
+            });
+            if (cost.totalUsd) {
+                this.metrics.costTotal.add(cost.totalUsd, {
+                    agent,
+                    model: model || 'unknown',
+                    status: 'error',
+                });
+            }
+        }
+    }
+    /**
+     * Record tool call.
+     */
+    recordToolCall(toolName, duration, success) {
+        this.metrics.toolCallsTotal.add(1, {
+            tool: toolName,
+            status: success ? 'success' : 'error',
+        });
+        this.metrics.toolCallsDuration.record(duration, {
+            tool: toolName,
+            status: success ? 'success' : 'error',
+        });
+    }
+    /**
+     * Record authentication event.
+     */
+    recordAuthEvent(agent, method, success) {
+        this.metrics.authEvents.add(1, {
+            agent,
+            method,
+            status: success ? 'success' : 'failure',
+        });
+    }
+    /**
+     * Set active runs gauge.
+     */
+    setActiveRuns(count) {
+        this.metrics.activeRuns.record(count);
+    }
+    /**
+     * End a span with success.
+     */
+    endSpanSuccess(span, attributes) {
+        if (attributes) {
+            span.setAttributes(attributes);
+        }
+        span.setStatus({ code: SpanStatusCode.OK });
+        span.end();
+    }
+    /**
+     * End a span with error.
+     */
+    endSpanError(span, error, attributes) {
+        span.recordException(error instanceof Error ? error : new Error(error));
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : error,
+        });
+        if (attributes) {
+            span.setAttributes(attributes);
+        }
+        span.end();
+    }
+    /**
+     * Get the meter instance.
+     */
+    getMeter() {
+        return this.meter;
+    }
+}
+/**
+ * Default telemetry manager instance.
+ */
+export const telemetry = new TelemetryManager({
+    serviceName: process.env.OTEL_SERVICE_NAME || 'agent-mux',
+    serviceVersion: process.env.npm_package_version,
+    enableTracing: process.env.OTEL_TRACES_EXPORTER !== 'none',
+    enableMetrics: process.env.OTEL_METRICS_EXPORTER !== 'none',
+});
+/**
+ * Initialize telemetry if enabled.
+ */
+export function initializeTelemetry() {
+    if (process.env.OTEL_SDK_DISABLED !== 'true') {
+        telemetry.initialize();
+    }
+}
+/**
+ * Shutdown telemetry.
+ */
+export async function shutdownTelemetry() {
+    await telemetry.shutdown();
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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