@llm-dev-ops/agentics-cli 1.4.26 → 1.4.29

package/dist/bundled-agents/auto-optimizer-agents/dist/integrations/llm-devops/latency-lens-adapter.js

@@ -0,0 +1,242 @@
+"use strict";
+/**
+ * LLM-Latency-Lens Adapter
+ * Thin runtime consumer for latency profiles and throughput statistics
+ *
+ * @module integrations/llm-devops/latency-lens-adapter
+ * @see https://github.com/LLM-Dev-Ops/latency-lens
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LatencyLensAdapter = void 0;
+exports.createLatencyLensAdapter = createLatencyLensAdapter;
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    timeout: 30000,
+    enableRetry: true,
+    maxRetries: 3,
+};
+// ============================================================================
+// Latency-Lens Adapter
+// ============================================================================
+/**
+ * Thin adapter for consuming latency profiles and throughput stats from LLM-Latency-Lens
+ */
+class LatencyLensAdapter {
+    config;
+    profileHandlers = new Set();
+    throughputHandlers = new Set();
+    anomalyHandlers = new Set();
+    isListening = false;
+    constructor(config) {
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Event Subscription
+    // --------------------------------------------------------------------------
+    /**
+     * Subscribe to latency profile updates
+     */
+    onLatencyProfile(handler) {
+        this.profileHandlers.add(handler);
+        return () => this.profileHandlers.delete(handler);
+    }
+    /**
+     * Subscribe to throughput statistics updates
+     */
+    onThroughputStats(handler) {
+        this.throughputHandlers.add(handler);
+        return () => this.throughputHandlers.delete(handler);
+    }
+    /**
+     * Subscribe to latency anomaly alerts
+     */
+    onLatencyAnomaly(handler) {
+        this.anomalyHandlers.add(handler);
+        return () => this.anomalyHandlers.delete(handler);
+    }
+    // --------------------------------------------------------------------------
+    // Data Consumption
+    // --------------------------------------------------------------------------
+    /**
+     * Fetch latency profiles for specified models
+     */
+    async fetchLatencyProfiles(options) {
+        const params = new URLSearchParams();
+        if (options?.modelIds)
+            params.set('model_ids', options.modelIds.join(','));
+        if (options?.providers)
+            params.set('providers', options.providers.join(','));
+        if (options?.since)
+            params.set('since', options.since);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const response = await this.makeRequest(`/api/v1/profiles?${params.toString()}`);
+        return response.profiles;
+    }
+    /**
+     * Fetch throughput statistics
+     */
+    async fetchThroughputStats(options) {
+        const params = new URLSearchParams();
+        if (options?.modelIds)
+            params.set('model_ids', options.modelIds.join(','));
+        if (options?.windowMinutes)
+            params.set('window_minutes', String(options.windowMinutes));
+        const response = await this.makeRequest(`/api/v1/throughput?${params.toString()}`);
+        return response.stats;
+    }
+    /**
+     * Fetch latency breakdown for a specific request
+     */
+    async fetchLatencyBreakdown(requestId) {
+        return this.makeRequest(`/api/v1/breakdown/${encodeURIComponent(requestId)}`);
+    }
+    /**
+     * Fetch recent latency anomalies
+     */
+    async fetchAnomalies(options) {
+        const params = new URLSearchParams();
+        if (options?.severity)
+            params.set('severity', options.severity);
+        if (options?.type)
+            params.set('type', options.type);
+        if (options?.since)
+            params.set('since', options.since);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const response = await this.makeRequest(`/api/v1/anomalies?${params.toString()}`);
+        return response.anomalies;
+    }
+    /**
+     * Get current latency summary for all models
+     */
+    async getCurrentSummary() {
+        return this.makeRequest('/api/v1/summary/current');
+    }
+    /**
+     * Compare latency between two models
+     */
+    async compareModels(modelA, modelB) {
+        return this.makeRequest(`/api/v1/compare?model_a=${encodeURIComponent(modelA)}&model_b=${encodeURIComponent(modelB)}`);
+    }
+    // --------------------------------------------------------------------------
+    // Streaming / Polling
+    // --------------------------------------------------------------------------
+    /**
+     * Start listening for real-time latency updates
+     */
+    startListening(intervalMs = 5000) {
+        if (this.isListening)
+            return;
+        this.isListening = true;
+        this.pollUpdates(intervalMs);
+    }
+    /**
+     * Stop listening for updates
+     */
+    stopListening() {
+        this.isListening = false;
+    }
+    async pollUpdates(intervalMs) {
+        let lastProfileTimestamp;
+        let lastAnomalyTimestamp;
+        while (this.isListening) {
+            try {
+                // Fetch profiles
+                const profiles = await this.fetchLatencyProfiles({
+                    since: lastProfileTimestamp,
+                    limit: 50,
+                });
+                for (const profile of profiles) {
+                    lastProfileTimestamp = profile.timestamp;
+                    for (const handler of this.profileHandlers) {
+                        await handler(profile);
+                    }
+                }
+                // Fetch throughput stats
+                const stats = await this.fetchThroughputStats({ windowMinutes: 1 });
+                for (const stat of stats) {
+                    for (const handler of this.throughputHandlers) {
+                        await handler(stat);
+                    }
+                }
+                // Fetch anomalies
+                const anomalies = await this.fetchAnomalies({
+                    since: lastAnomalyTimestamp,
+                    limit: 20,
+                });
+                for (const anomaly of anomalies) {
+                    lastAnomalyTimestamp = anomaly.detectedAt;
+                    for (const handler of this.anomalyHandlers) {
+                        await handler(anomaly);
+                    }
+                }
+            }
+            catch (error) {
+                console.error('[LatencyLensAdapter] Poll error:', error);
+            }
+            await this.sleep(intervalMs);
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Internal Helpers
+    // --------------------------------------------------------------------------
+    async makeRequest(path, attempt = 0) {
+        const url = `${this.config.apiBaseUrl}${path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${this.config.apiKey}`,
+                    'Content-Type': 'application/json',
+                    'X-Client': 'llm-auto-optimizer',
+                },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`LatencyLens API error: ${response.status} ${response.statusText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (this.config.enableRetry && attempt < this.config.maxRetries && this.isRetryable(error)) {
+                await this.sleep(this.calculateBackoff(attempt));
+                return this.makeRequest(path, attempt + 1);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    isRetryable(error) {
+        if (error instanceof Error) {
+            return error.name === 'AbortError' ||
+                error.message.includes('502') ||
+                error.message.includes('503') ||
+                error.message.includes('504');
+        }
+        return false;
+    }
+    calculateBackoff(attempt) {
+        return Math.min(1000 * Math.pow(2, attempt), 30000);
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.LatencyLensAdapter = LatencyLensAdapter;
+// ============================================================================
+// Factory Function
+// ============================================================================
+function createLatencyLensAdapter(config) {
+    return new LatencyLensAdapter(config);
+}
+//# sourceMappingURL=latency-lens-adapter.js.map

package/dist/bundled-agents/auto-optimizer-agents/dist/integrations/llm-devops/latency-lens-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-lens-adapter.js","sourceRoot":"","sources":["../../../src/integrations/llm-devops/latency-lens-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA2ZH,4DAEC;AApSD,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,cAAc,GAA+B;IACjD,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,MAAa,kBAAkB;IACrB,MAAM,CAA8B;IACpC,eAAe,GAA+B,IAAI,GAAG,EAAE,CAAC;IACxD,kBAAkB,GAA2B,IAAI,GAAG,EAAE,CAAC;IACvD,eAAe,GAA+B,IAAI,GAAG,EAAE,CAAC;IACxD,WAAW,GAAY,KAAK,CAAC;IAErC,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,cAAc;YACjB,GAAG,MAAM;SACqB,CAAC;IACnC,CAAC;IAED,6EAA6E;IAC7E,qBAAqB;IACrB,6EAA6E;IAE7E;;OAEG;IACH,gBAAgB,CAAC,OAA8B;QAC7C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAA0B;QAC1C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAA8B;QAC7C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,6EAA6E;IAC7E,mBAAmB;IACnB,6EAA6E;IAE7E;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAK1B;QACC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,IAAI,OAAO,EAAE,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAE/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CACrC,oBAAoB,MAAM,CAAC,QAAQ,EAAE,EAAE,CACxC,CAAC;QACF,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAG1B;QACC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,IAAI,OAAO,EAAE,aAAa;YAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAExF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CACrC,sBAAsB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAC1C,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,SAAiB;QAC3C,OAAO,IAAI,CAAC,WAAW,CACrB,qBAAqB,kBAAkB,CAAC,SAAS,CAAC,EAAE,CACrD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAKpB;QACC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAE/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CACrC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,EAAE,CACzC,CAAC;QACF,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QASrB,OAAO,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,MAAc;QAUhD,OAAO,IAAI,CAAC,WAAW,CACrB,2BAA2B,kBAAkB,CAAC,MAAM,CAAC,YAAY,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,sBAAsB;IACtB,6EAA6E;IAE7E;;OAEG;IACH,cAAc,CAAC,aAAqB,IAAI;QACtC,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,UAAkB;QAC1C,IAAI,oBAAwC,CAAC;QAC7C,IAAI,oBAAwC,CAAC;QAE7C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,iBAAiB;gBACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC;oBAC/C,KAAK,EAAE,oBAAoB;oBAC3B,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;gBAEH,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;oBACzC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;wBAC3C,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;gBAED,yBAAyB;gBACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;gBACpE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;wBAC9C,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;oBACtB,CAAC;gBACH,CAAC;gBAED,kBAAkB;gBAClB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC;oBAC1C,KAAK,EAAE,oBAAoB;oBAC3B,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;gBAEH,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;oBAChC,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;oBAC1C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;wBAC3C,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,mBAAmB;IACnB,6EAA6E;IAErE,KAAK,CAAC,WAAW,CAAI,IAAY,EAAE,UAAkB,CAAC;QAC5D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,EAAE,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;oBAC/C,cAAc,EAAE,kBAAkB;oBAClC,UAAU,EAAE,oBAAoB;iBACjC;gBACD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACtF,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3F,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACjD,OAAO,IAAI,CAAC,WAAW,CAAI,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAAc;QAChC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,IAAI,KAAK,YAAY;gBAC3B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB,CAAC,OAAe;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;CACF;AA3QD,gDA2QC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,SAAgB,wBAAwB,CAAC,MAAyB;IAChE,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/bundled-agents/auto-optimizer-agents/dist/integrations/llm-devops/observatory-adapter.d.ts

@@ -0,0 +1,243 @@
+/**
+ * LLM-Observatory Adapter
+ * Thin runtime consumer for telemetry traces and structured events
+ *
+ * @module integrations/llm-devops/observatory-adapter
+ * @see https://github.com/LLM-Dev-Ops/observatory
+ */
+export interface ObservatoryConfig {
+    /** API endpoint for Observatory service */
+    apiBaseUrl: string;
+    /** Authentication token */
+    apiKey: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Enable automatic retry on transient failures */
+    enableRetry?: boolean;
+    /** Maximum retry attempts */
+    maxRetries?: number;
+}
+export interface TelemetryTrace {
+    /** Unique trace identifier */
+    traceId: string;
+    /** Parent span ID (if any) */
+    parentSpanId?: string;
+    /** Span identifier */
+    spanId: string;
+    /** Operation name */
+    operationName: string;
+    /** Service name */
+    serviceName: string;
+    /** Start timestamp (ISO 8601) */
+    startTime: string;
+    /** End timestamp (ISO 8601) */
+    endTime: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Status */
+    status: 'ok' | 'error' | 'timeout';
+    /** Error message if status is error */
+    errorMessage?: string;
+    /** Trace attributes */
+    attributes: Record<string, string | number | boolean>;
+    /** Resource attributes */
+    resource: {
+        modelId?: string;
+        provider?: string;
+        version?: string;
+        environment?: string;
+    };
+    /** Span events */
+    events: SpanEvent[];
+    /** Span links */
+    links: SpanLink[];
+}
+export interface SpanEvent {
+    /** Event name */
+    name: string;
+    /** Event timestamp */
+    timestamp: string;
+    /** Event attributes */
+    attributes: Record<string, string | number | boolean>;
+}
+export interface SpanLink {
+    /** Linked trace ID */
+    traceId: string;
+    /** Linked span ID */
+    spanId: string;
+    /** Link attributes */
+    attributes: Record<string, string | number | boolean>;
+}
+export interface StructuredEvent {
+    /** Event identifier */
+    eventId: string;
+    /** Event timestamp */
+    timestamp: string;
+    /** Event type */
+    type: StructuredEventType;
+    /** Event category */
+    category: 'llm' | 'system' | 'user' | 'security' | 'performance';
+    /** Severity level */
+    severity: 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+    /** Event message */
+    message: string;
+    /** Source service */
+    source: string;
+    /** Correlation ID for linking related events */
+    correlationId?: string;
+    /** Associated trace ID */
+    traceId?: string;
+    /** Model identifier */
+    modelId?: string;
+    /** Provider name */
+    provider?: string;
+    /** Event-specific data */
+    data: Record<string, unknown>;
+    /** Tags for filtering */
+    tags: string[];
+}
+export type StructuredEventType = 'request.start' | 'request.complete' | 'request.error' | 'model.switch' | 'model.fallback' | 'cache.hit' | 'cache.miss' | 'rate_limit.warning' | 'rate_limit.exceeded' | 'token.usage' | 'cost.recorded' | 'latency.threshold' | 'error.retry' | 'error.final' | 'optimization.triggered' | 'config.changed' | 'custom';
+export interface TraceSearch {
+    /** Service name filter */
+    serviceName?: string;
+    /** Operation name filter */
+    operationName?: string;
+    /** Model ID filter */
+    modelId?: string;
+    /** Provider filter */
+    provider?: string;
+    /** Status filter */
+    status?: TelemetryTrace['status'];
+    /** Minimum duration filter (ms) */
+    minDurationMs?: number;
+    /** Maximum duration filter (ms) */
+    maxDurationMs?: number;
+    /** Start time (ISO 8601) */
+    startTime?: string;
+    /** End time (ISO 8601) */
+    endTime?: string;
+    /** Tag filters */
+    tags?: Record<string, string>;
+    /** Maximum results */
+    limit?: number;
+}
+export interface TraceSummary {
+    /** Time window */
+    window: {
+        start: string;
+        end: string;
+    };
+    /** Total traces */
+    totalTraces: number;
+    /** Traces by status */
+    byStatus: Record<string, number>;
+    /** Average duration (ms) */
+    avgDurationMs: number;
+    /** P50 duration (ms) */
+    p50DurationMs: number;
+    /** P99 duration (ms) */
+    p99DurationMs: number;
+    /** Error rate */
+    errorRate: number;
+    /** Traces by model */
+    byModel: Record<string, number>;
+    /** Traces by provider */
+    byProvider: Record<string, number>;
+}
+export type TraceHandler = (trace: TelemetryTrace) => void | Promise<void>;
+export type StructuredEventHandler = (event: StructuredEvent) => void | Promise<void>;
+/**
+ * Thin adapter for consuming telemetry traces and structured events from LLM-Observatory
+ */
+export declare class ObservatoryAdapter {
+    private config;
+    private traceHandlers;
+    private eventHandlers;
+    private isListening;
+    constructor(config: ObservatoryConfig);
+    /**
+     * Subscribe to telemetry traces
+     */
+    onTrace(handler: TraceHandler): () => void;
+    /**
+     * Subscribe to structured events
+     */
+    onEvent(handler: StructuredEventHandler): () => void;
+    /**
+     * Search for traces
+     */
+    searchTraces(query: TraceSearch): Promise<TelemetryTrace[]>;
+    /**
+     * Get a specific trace by ID
+     */
+    getTrace(traceId: string): Promise<TelemetryTrace & {
+        spans: TelemetryTrace[];
+    }>;
+    /**
+     * Fetch structured events
+     */
+    fetchEvents(options?: {
+        type?: StructuredEventType;
+        category?: StructuredEvent['category'];
+        severity?: StructuredEvent['severity'];
+        modelId?: string;
+        correlationId?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<StructuredEvent[]>;
+    /**
+     * Get trace summary statistics
+     */
+    getTraceSummary(options?: {
+        windowMinutes?: number;
+        modelId?: string;
+        provider?: string;
+    }): Promise<TraceSummary>;
+    /**
+     * Get recent slow traces
+     */
+    getSlowTraces(options?: {
+        thresholdMs?: number;
+        limit?: number;
+    }): Promise<TelemetryTrace[]>;
+    /**
+     * Get error traces
+     */
+    getErrorTraces(options?: {
+        since?: string;
+        limit?: number;
+    }): Promise<TelemetryTrace[]>;
+    /**
+     * Get service dependency map
+     */
+    getServiceMap(): Promise<{
+        services: Array<{
+            name: string;
+            type: string;
+            requestCount: number;
+            errorRate: number;
+            avgLatencyMs: number;
+        }>;
+        edges: Array<{
+            from: string;
+            to: string;
+            requestCount: number;
+            avgLatencyMs: number;
+        }>;
+    }>;
+    /**
+     * Start listening for real-time traces and events
+     */
+    startListening(intervalMs?: number): void;
+    /**
+     * Stop listening for updates
+     */
+    stopListening(): void;
+    private pollUpdates;
+    private makeRequest;
+    private isRetryable;
+    private calculateBackoff;
+    private sleep;
+}
+export declare function createObservatoryAdapter(config: ObservatoryConfig): ObservatoryAdapter;
+//# sourceMappingURL=observatory-adapter.d.ts.map

package/dist/bundled-agents/auto-optimizer-agents/dist/integrations/llm-devops/observatory-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observatory-adapter.d.ts","sourceRoot":"","sources":["../../../src/integrations/llm-devops/observatory-adapter.ts"],"names":[],"mappings":"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"}