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

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

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservatoryAdapter = void 0;
+exports.createObservatoryAdapter = createObservatoryAdapter;
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    timeout: 30000,
+    enableRetry: true,
+    maxRetries: 3,
+};
+// ============================================================================
+// Observatory Adapter
+// ============================================================================
+/**
+ * Thin adapter for consuming telemetry traces and structured events from LLM-Observatory
+ */
+class ObservatoryAdapter {
+    config;
+    traceHandlers = new Set();
+    eventHandlers = new Set();
+    isListening = false;
+    constructor(config) {
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Event Subscription
+    // --------------------------------------------------------------------------
+    /**
+     * Subscribe to telemetry traces
+     */
+    onTrace(handler) {
+        this.traceHandlers.add(handler);
+        return () => this.traceHandlers.delete(handler);
+    }
+    /**
+     * Subscribe to structured events
+     */
+    onEvent(handler) {
+        this.eventHandlers.add(handler);
+        return () => this.eventHandlers.delete(handler);
+    }
+    // --------------------------------------------------------------------------
+    // Data Consumption
+    // --------------------------------------------------------------------------
+    /**
+     * Search for traces
+     */
+    async searchTraces(query) {
+        const params = new URLSearchParams();
+        if (query.serviceName)
+            params.set('service_name', query.serviceName);
+        if (query.operationName)
+            params.set('operation_name', query.operationName);
+        if (query.modelId)
+            params.set('model_id', query.modelId);
+        if (query.provider)
+            params.set('provider', query.provider);
+        if (query.status)
+            params.set('status', query.status);
+        if (query.minDurationMs)
+            params.set('min_duration_ms', String(query.minDurationMs));
+        if (query.maxDurationMs)
+            params.set('max_duration_ms', String(query.maxDurationMs));
+        if (query.startTime)
+            params.set('start_time', query.startTime);
+        if (query.endTime)
+            params.set('end_time', query.endTime);
+        if (query.limit)
+            params.set('limit', String(query.limit));
+        if (query.tags) {
+            Object.entries(query.tags).forEach(([k, v]) => params.set(`tag.${k}`, v));
+        }
+        const response = await this.makeRequest(`/api/v1/traces?${params.toString()}`);
+        return response.traces;
+    }
+    /**
+     * Get a specific trace by ID
+     */
+    async getTrace(traceId) {
+        return this.makeRequest(`/api/v1/traces/${encodeURIComponent(traceId)}`);
+    }
+    /**
+     * Fetch structured events
+     */
+    async fetchEvents(options) {
+        const params = new URLSearchParams();
+        if (options?.type)
+            params.set('type', options.type);
+        if (options?.category)
+            params.set('category', options.category);
+        if (options?.severity)
+            params.set('severity', options.severity);
+        if (options?.modelId)
+            params.set('model_id', options.modelId);
+        if (options?.correlationId)
+            params.set('correlation_id', options.correlationId);
+        if (options?.since)
+            params.set('since', options.since);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const response = await this.makeRequest(`/api/v1/events?${params.toString()}`);
+        return response.events;
+    }
+    /**
+     * Get trace summary statistics
+     */
+    async getTraceSummary(options) {
+        const params = new URLSearchParams();
+        if (options?.windowMinutes)
+            params.set('window_minutes', String(options.windowMinutes));
+        if (options?.modelId)
+            params.set('model_id', options.modelId);
+        if (options?.provider)
+            params.set('provider', options.provider);
+        return this.makeRequest(`/api/v1/traces/summary?${params.toString()}`);
+    }
+    /**
+     * Get recent slow traces
+     */
+    async getSlowTraces(options) {
+        const params = new URLSearchParams();
+        if (options?.thresholdMs)
+            params.set('threshold_ms', String(options.thresholdMs));
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const response = await this.makeRequest(`/api/v1/traces/slow?${params.toString()}`);
+        return response.traces;
+    }
+    /**
+     * Get error traces
+     */
+    async getErrorTraces(options) {
+        const params = new URLSearchParams();
+        if (options?.since)
+            params.set('since', options.since);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const response = await this.makeRequest(`/api/v1/traces/errors?${params.toString()}`);
+        return response.traces;
+    }
+    /**
+     * Get service dependency map
+     */
+    async getServiceMap() {
+        return this.makeRequest('/api/v1/services/map');
+    }
+    // --------------------------------------------------------------------------
+    // Streaming / Polling
+    // --------------------------------------------------------------------------
+    /**
+     * Start listening for real-time traces and events
+     */
+    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 lastTraceTime;
+        let lastEventTime;
+        while (this.isListening) {
+            try {
+                // Fetch recent traces
+                const traces = await this.searchTraces({
+                    startTime: lastTraceTime,
+                    limit: 50,
+                });
+                for (const trace of traces) {
+                    lastTraceTime = trace.endTime;
+                    for (const handler of this.traceHandlers) {
+                        await handler(trace);
+                    }
+                }
+                // Fetch recent events
+                const events = await this.fetchEvents({
+                    since: lastEventTime,
+                    limit: 100,
+                });
+                for (const event of events) {
+                    lastEventTime = event.timestamp;
+                    for (const handler of this.eventHandlers) {
+                        await handler(event);
+                    }
+                }
+            }
+            catch (error) {
+                console.error('[ObservatoryAdapter] 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(`Observatory 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.ObservatoryAdapter = ObservatoryAdapter;
+// ============================================================================
+// Factory Function
+// ============================================================================
+function createObservatoryAdapter(config) {
+    return new ObservatoryAdapter(config);
+}
+//# sourceMappingURL=observatory-adapter.js.map

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

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

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

@@ -0,0 +1,218 @@
+/**
+ * Router External L2 Module Adapter
+ * Thin runtime consumer for external routing layer signals and decisions
+ *
+ * @module integrations/llm-devops/router-l2-adapter
+ *
+ * Note: This adapter interfaces with an external L2 routing module that provides
+ * advanced routing decisions, load balancing signals, and traffic management.
+ */
+export interface RouterL2Config {
+    /** API endpoint for Router L2 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 RoutingDecision {
+    /** Decision identifier */
+    decisionId: string;
+    /** Decision timestamp */
+    timestamp: string;
+    /** Request identifier */
+    requestId: string;
+    /** Selected model */
+    selectedModel: string;
+    /** Selected provider */
+    selectedProvider: string;
+    /** Decision reason */
+    reason: RoutingReason;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Alternative models considered */
+    alternatives: Array<{
+        modelId: string;
+        provider: string;
+        score: number;
+        reason: string;
+    }>;
+    /** Routing metadata */
+    metadata: {
+        latencyEstimateMs: number;
+        costEstimate: number;
+        qualityScore: number;
+        availabilityScore: number;
+    };
+}
+export type RoutingReason = 'lowest_latency' | 'lowest_cost' | 'highest_quality' | 'load_balanced' | 'geo_optimized' | 'fallback' | 'user_preference' | 'policy_enforced' | 'capacity_based' | 'experiment' | 'default';
+export interface LoadBalancerSignal {
+    /** Signal identifier */
+    signalId: string;
+    /** Signal timestamp */
+    timestamp: string;
+    /** Signal type */
+    type: LoadBalancerSignalType;
+    /** Affected models */
+    affectedModels: string[];
+    /** Signal severity */
+    severity: 'info' | 'warning' | 'critical';
+    /** Current load distribution */
+    loadDistribution: Record<string, number>;
+    /** Recommended action */
+    recommendation?: {
+        action: 'increase_weight' | 'decrease_weight' | 'disable' | 'enable' | 'redirect';
+        targetModel: string;
+        reason: string;
+    };
+}
+export type LoadBalancerSignalType = 'capacity_warning' | 'capacity_critical' | 'rebalance_suggested' | 'model_slow' | 'model_recovered' | 'traffic_spike' | 'traffic_normalized';
+export interface TrafficStats {
+    /** Stats identifier */
+    statsId: string;
+    /** Time window */
+    window: {
+        start: string;
+        end: string;
+    };
+    /** Total requests */
+    totalRequests: number;
+    /** Requests per second */
+    requestsPerSecond: number;
+    /** Distribution by model */
+    byModel: Record<string, {
+        requests: number;
+        percentage: number;
+        avgLatencyMs: number;
+        errorRate: number;
+    }>;
+    /** Distribution by provider */
+    byProvider: Record<string, {
+        requests: number;
+        percentage: number;
+    }>;
+    /** Geographic distribution */
+    byRegion?: Record<string, number>;
+}
+export interface RouterHealth {
+    /** Overall health status */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /** Last health check */
+    lastCheck: string;
+    /** Component health */
+    components: {
+        loadBalancer: 'up' | 'down' | 'degraded';
+        decisionEngine: 'up' | 'down' | 'degraded';
+        modelRegistry: 'up' | 'down' | 'degraded';
+        metricsCollector: 'up' | 'down' | 'degraded';
+    };
+    /** Active connections */
+    activeConnections: number;
+    /** Queue depth */
+    queueDepth: number;
+    /** Error rate */
+    errorRate: number;
+}
+export interface ModelWeight {
+    /** Model identifier */
+    modelId: string;
+    /** Provider name */
+    provider: string;
+    /** Current weight (0-1) */
+    weight: number;
+    /** Effective weight after adjustments */
+    effectiveWeight: number;
+    /** Weight adjustments */
+    adjustments: Array<{
+        reason: string;
+        delta: number;
+        appliedAt: string;
+    }>;
+}
+export type RoutingDecisionHandler = (decision: RoutingDecision) => void | Promise<void>;
+export type LoadBalancerSignalHandler = (signal: LoadBalancerSignal) => void | Promise<void>;
+/**
+ * Thin adapter for consuming routing decisions and load balancer signals from external Router L2 module
+ */
+export declare class RouterL2Adapter {
+    private config;
+    private decisionHandlers;
+    private signalHandlers;
+    private isListening;
+    constructor(config: RouterL2Config);
+    /**
+     * Subscribe to routing decisions
+     */
+    onRoutingDecision(handler: RoutingDecisionHandler): () => void;
+    /**
+     * Subscribe to load balancer signals
+     */
+    onLoadBalancerSignal(handler: LoadBalancerSignalHandler): () => void;
+    /**
+     * Fetch recent routing decisions
+     */
+    fetchRoutingDecisions(options?: {
+        modelId?: string;
+        reason?: RoutingReason;
+        since?: string;
+        limit?: number;
+    }): Promise<RoutingDecision[]>;
+    /**
+     * Fetch load balancer signals
+     */
+    fetchLoadBalancerSignals(options?: {
+        type?: LoadBalancerSignalType;
+        severity?: LoadBalancerSignal['severity'];
+        since?: string;
+        limit?: number;
+    }): Promise<LoadBalancerSignal[]>;
+    /**
+     * Get current traffic statistics
+     */
+    getTrafficStats(options?: {
+        windowMinutes?: number;
+    }): Promise<TrafficStats>;
+    /**
+     * Get router health status
+     */
+    getRouterHealth(): Promise<RouterHealth>;
+    /**
+     * Get current model weights
+     */
+    getModelWeights(): Promise<ModelWeight[]>;
+    /**
+     * Get routing decision for a specific request ID
+     */
+    getDecision(requestId: string): Promise<RoutingDecision>;
+    /**
+     * Get routing statistics summary
+     */
+    getRoutingSummary(options?: {
+        windowMinutes?: number;
+    }): Promise<{
+        totalDecisions: number;
+        byReason: Record<RoutingReason, number>;
+        byModel: Record<string, number>;
+        avgConfidence: number;
+        fallbackRate: number;
+    }>;
+    /**
+     * Start listening for real-time routing events
+     */
+    startListening(intervalMs?: number): void;
+    /**
+     * Stop listening for events
+     */
+    stopListening(): void;
+    private pollEvents;
+    private makeRequest;
+    private isRetryable;
+    private calculateBackoff;
+    private sleep;
+}
+export declare function createRouterL2Adapter(config: RouterL2Config): RouterL2Adapter;
+//# sourceMappingURL=router-l2-adapter.d.ts.map

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

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