@llm-dev-ops/agentics-cli 1.4.25 → 1.4.27

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/usage-oversight/agent.js

@@ -0,0 +1,576 @@
+/**
+ * Usage Oversight Agent Implementation
+ *
+ * Core agent logic for usage pattern analysis and governance oversight.
+ */
+import { USAGE_OVERSIGHT_AGENT_METADATA, validateUsageOversightInput, validateUsageOversightOutput, } from '../../contracts/usage-oversight.js';
+// DecisionEvent type imported for reference (used by DecisionEventEmitter)
+import { DecisionEventEmitter } from '../../infrastructure/decision-event-emitter.js';
+import { generateUUID } from '../../contracts/validation.js';
+/**
+ * Default thresholds
+ */
+const DEFAULT_THRESHOLDS = {
+    budgetWarningPercent: 80,
+    budgetCriticalPercent: 95,
+    quotaWarningPercent: 80,
+    quotaCriticalPercent: 95,
+    costAnomalyStdDev: 2,
+    usageSpikeMultiplier: 3,
+};
+/**
+ * Usage Oversight Agent
+ *
+ * Analyzes LLM usage patterns and produces governance oversight signals.
+ */
+export class UsageOversightAgent {
+    metadata;
+    decisionEventEmitter;
+    telemetry;
+    thresholds;
+    constructor(config) {
+        this.metadata = {
+            ...USAGE_OVERSIGHT_AGENT_METADATA,
+            classification: 'OVERSIGHT',
+            // Convert readonly arrays to mutable arrays
+            capabilities: [...USAGE_OVERSIGHT_AGENT_METADATA.capabilities],
+            restrictions: [...USAGE_OVERSIGHT_AGENT_METADATA.restrictions],
+            consumers: [...USAGE_OVERSIGHT_AGENT_METADATA.consumers],
+        };
+        this.decisionEventEmitter = new DecisionEventEmitter({
+            ruvectorClient: config.ruvectorClient,
+            agentId: this.metadata.agent_id,
+            agentVersion: this.metadata.agent_version,
+            dryRun: config.dryRun,
+        });
+        this.telemetry = config.telemetryEmitter;
+        this.thresholds = { ...DEFAULT_THRESHOLDS, ...config.thresholds };
+    }
+    /**
+     * Execute the Usage Oversight Agent
+     */
+    async execute(input, context) {
+        const startTime = Date.now();
+        // Emit telemetry start event
+        this.telemetry?.emitInvocationStart(this.metadata, context);
+        try {
+            // Validate input
+            const validatedInput = this.validateInput(input);
+            // Perform analysis
+            const output = await this.analyze(validatedInput);
+            // Validate output
+            const validatedOutput = this.validateOutput(output);
+            // Calculate confidence
+            const confidence = this.calculateConfidence(validatedInput, validatedOutput);
+            // Emit decision event
+            const decisionEvent = await this.decisionEventEmitter.emit({
+                decisionType: 'usage_oversight_signal',
+                input: validatedInput,
+                outputs: validatedOutput,
+                confidence,
+                constraintsApplied: {
+                    policy_scope: validatedInput.policy_context.active_policies.map((p) => p.policy_id),
+                    org_boundaries: {
+                        organization_id: validatedInput.organization_id,
+                        team_ids: validatedInput.filters?.team_ids,
+                        user_ids: validatedInput.filters?.user_ids,
+                    },
+                    time_window: validatedInput.time_range,
+                },
+                executionRef: context.execution_ref,
+                telemetry: {
+                    latency_ms: Date.now() - startTime,
+                    source_system: context.caller.service,
+                },
+            });
+            // Emit telemetry success event
+            this.telemetry?.emitInvocationSuccess(this.metadata, context, Date.now() - startTime, {
+                patterns_detected: validatedOutput.out_of_policy_patterns.length,
+                governance_health_score: validatedOutput.governance_health_score,
+            });
+            return {
+                success: true,
+                decision_event: decisionEvent,
+                output: validatedOutput,
+            };
+        }
+        catch (error) {
+            // Emit telemetry failure event
+            this.telemetry?.emitInvocationFailure(this.metadata, context, Date.now() - startTime, {
+                code: error.code || 'AGENT_ERROR',
+                message: error.message,
+                details: error.details,
+            });
+            // Still emit a decision event for audit trail
+            const errorDecisionEvent = await this.decisionEventEmitter.emit({
+                decisionType: 'usage_oversight_signal',
+                input,
+                outputs: { error: { code: error.code, message: error.message } },
+                confidence: { coverage: 0, completeness: 0, overall: 0 },
+                constraintsApplied: {
+                    policy_scope: [],
+                    org_boundaries: {
+                        organization_id: input?.organization_id || 'unknown',
+                    },
+                    time_window: {
+                        start: new Date().toISOString(),
+                        end: new Date().toISOString(),
+                    },
+                },
+                executionRef: context.execution_ref,
+                telemetry: {
+                    latency_ms: Date.now() - startTime,
+                },
+            });
+            return {
+                success: false,
+                decision_event: errorDecisionEvent,
+                output: {},
+                error: {
+                    code: error.code || 'AGENT_ERROR',
+                    message: error.message,
+                    details: error.details,
+                },
+            };
+        }
+    }
+    /**
+     * Validate input against schema
+     */
+    validateInput(input) {
+        return validateUsageOversightInput(input);
+    }
+    /**
+     * Validate output against schema
+     */
+    validateOutput(output) {
+        return validateUsageOversightOutput(output);
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        this.telemetry?.emitHealthCheck(this.metadata, true);
+        return { healthy: true };
+    }
+    /**
+     * Core analysis logic
+     */
+    async analyze(input) {
+        // Step 1: Aggregate usage data
+        const usageSummary = this.aggregateUsage(input.usage_patterns, input.time_range);
+        // Step 2: Detect out-of-policy patterns
+        const patternResult = this.detectPatterns(input.usage_patterns, input.policy_context, usageSummary);
+        // Step 3: Evaluate policy adherence
+        const policyResult = this.evaluatePolicies(input.usage_patterns, input.policy_context);
+        // Step 4: Calculate governance health score
+        const healthScore = this.calculateHealthScore(patternResult.patterns, policyResult.adherence);
+        // Step 5: Generate recommendations
+        const recommendations = this.generateRecommendations(patternResult.patterns, policyResult, healthScore);
+        return {
+            usage_summary: usageSummary,
+            out_of_policy_patterns: patternResult.patterns,
+            policy_adherence: policyResult.adherence,
+            budget_status: policyResult.budgetStatus,
+            quota_status: policyResult.quotaStatus,
+            governance_health_score: healthScore,
+            recommendations,
+        };
+    }
+    /**
+     * Aggregate usage data into summary
+     */
+    aggregateUsage(patterns, _timeRange) {
+        const state = {
+            totalRequests: 0,
+            totalTokens: 0,
+            totalCostUsd: 0,
+            latencySum: 0,
+            uniqueUsers: new Set(),
+            uniqueModels: new Set(),
+            byModel: new Map(),
+            byUser: new Map(),
+            temporalBuckets: new Map(),
+        };
+        // Single pass through patterns
+        for (const pattern of patterns) {
+            state.totalRequests++;
+            state.totalTokens += pattern.total_tokens;
+            state.totalCostUsd += pattern.cost_usd;
+            state.latencySum += pattern.latency_ms;
+            state.uniqueUsers.add(pattern.user_id);
+            state.uniqueModels.add(pattern.model);
+            // By model
+            const modelKey = `${pattern.provider}:${pattern.model}`;
+            if (!state.byModel.has(modelKey)) {
+                state.byModel.set(modelKey, {
+                    model: pattern.model,
+                    provider: pattern.provider,
+                    requests: 0,
+                    tokens: 0,
+                    costUsd: 0,
+                });
+            }
+            const modelAgg = state.byModel.get(modelKey);
+            modelAgg.requests++;
+            modelAgg.tokens += pattern.total_tokens;
+            modelAgg.costUsd += pattern.cost_usd;
+            // By user
+            if (!state.byUser.has(pattern.user_id)) {
+                state.byUser.set(pattern.user_id, {
+                    userId: pattern.user_id,
+                    requests: 0,
+                    tokens: 0,
+                    costUsd: 0,
+                });
+            }
+            const userAgg = state.byUser.get(pattern.user_id);
+            userAgg.requests++;
+            userAgg.tokens += pattern.total_tokens;
+            userAgg.costUsd += pattern.cost_usd;
+            // Temporal (daily buckets)
+            const day = pattern.timestamp.split('T')[0];
+            if (!state.temporalBuckets.has(day)) {
+                state.temporalBuckets.set(day, { period: day, requests: 0, costUsd: 0 });
+            }
+            const bucket = state.temporalBuckets.get(day);
+            bucket.requests++;
+            bucket.costUsd += pattern.cost_usd;
+        }
+        // Convert to output format
+        const byModel = Array.from(state.byModel.values())
+            .map((m) => ({
+            model: m.model,
+            provider: m.provider,
+            requests: m.requests,
+            tokens: m.tokens,
+            cost_usd: m.costUsd,
+            percentage_of_total: state.totalCostUsd > 0
+                ? (m.costUsd / state.totalCostUsd) * 100
+                : 0,
+        }))
+            .sort((a, b) => b.cost_usd - a.cost_usd);
+        const byUser = Array.from(state.byUser.values())
+            .map((u) => ({
+            user_id: u.userId,
+            requests: u.requests,
+            tokens: u.tokens,
+            cost_usd: u.costUsd,
+            percentage_of_total: state.totalCostUsd > 0
+                ? (u.costUsd / state.totalCostUsd) * 100
+                : 0,
+        }))
+            .sort((a, b) => b.cost_usd - a.cost_usd)
+            .slice(0, 10); // Top 10 users
+        const temporalDistribution = Array.from(state.temporalBuckets.values()).sort((a, b) => a.period.localeCompare(b.period));
+        return {
+            total_requests: state.totalRequests,
+            total_tokens: state.totalTokens,
+            total_cost_usd: state.totalCostUsd,
+            average_latency_ms: state.totalRequests > 0 ? state.latencySum / state.totalRequests : 0,
+            unique_users: state.uniqueUsers.size,
+            unique_models: state.uniqueModels.size,
+            by_model: byModel,
+            by_user: byUser,
+            temporal_distribution: temporalDistribution.map(t => ({
+                period: t.period,
+                requests: t.requests,
+                cost_usd: t.costUsd,
+            })),
+        };
+    }
+    /**
+     * Detect out-of-policy patterns
+     */
+    detectPatterns(_patterns, policyContext, summary) {
+        const detectedPatterns = [];
+        let coverageScore = 1.0;
+        // Check budget warnings
+        for (const budget of policyContext.budget_limits || []) {
+            const percentUsed = (budget.current_spend_usd / budget.limit_usd) * 100;
+            if (percentUsed >= this.thresholds.budgetCriticalPercent) {
+                detectedPatterns.push({
+                    pattern_id: generateUUID(),
+                    category: 'budget_warning',
+                    severity: 'alert',
+                    description: `Budget "${budget.scope}:${budget.scope_id}" at ${percentUsed.toFixed(1)}% of limit`,
+                    affected_scope: {
+                        users: [],
+                        models: [],
+                    },
+                    metrics: {
+                        observed_value: budget.current_spend_usd,
+                        threshold_value: budget.limit_usd,
+                        deviation_percentage: percentUsed - 100,
+                    },
+                    timeframe: {
+                        start: new Date().toISOString(),
+                        end: new Date().toISOString(),
+                    },
+                });
+            }
+            else if (percentUsed >= this.thresholds.budgetWarningPercent) {
+                detectedPatterns.push({
+                    pattern_id: generateUUID(),
+                    category: 'budget_warning',
+                    severity: 'warning',
+                    description: `Budget "${budget.scope}:${budget.scope_id}" at ${percentUsed.toFixed(1)}% of limit`,
+                    affected_scope: {
+                        users: [],
+                        models: [],
+                    },
+                    metrics: {
+                        observed_value: budget.current_spend_usd,
+                        threshold_value: budget.limit_usd,
+                    },
+                    timeframe: {
+                        start: new Date().toISOString(),
+                        end: new Date().toISOString(),
+                    },
+                });
+            }
+        }
+        // Check quota warnings
+        for (const quota of policyContext.quota_limits || []) {
+            const percentUsed = (quota.current_value / quota.limit_value) * 100;
+            if (percentUsed >= this.thresholds.quotaCriticalPercent) {
+                detectedPatterns.push({
+                    pattern_id: generateUUID(),
+                    category: 'quota_warning',
+                    severity: 'alert',
+                    description: `Quota "${quota.quota_type}" at ${percentUsed.toFixed(1)}% of limit`,
+                    affected_scope: {
+                        users: [],
+                        models: [],
+                    },
+                    metrics: {
+                        observed_value: quota.current_value,
+                        threshold_value: quota.limit_value,
+                        deviation_percentage: percentUsed - 100,
+                    },
+                    timeframe: {
+                        start: new Date().toISOString(),
+                        end: new Date().toISOString(),
+                    },
+                });
+            }
+            else if (percentUsed >= this.thresholds.quotaWarningPercent) {
+                detectedPatterns.push({
+                    pattern_id: generateUUID(),
+                    category: 'quota_warning',
+                    severity: 'warning',
+                    description: `Quota "${quota.quota_type}" at ${percentUsed.toFixed(1)}% of limit`,
+                    affected_scope: {
+                        users: [],
+                        models: [],
+                    },
+                    metrics: {
+                        observed_value: quota.current_value,
+                        threshold_value: quota.limit_value,
+                    },
+                    timeframe: {
+                        start: new Date().toISOString(),
+                        end: new Date().toISOString(),
+                    },
+                });
+            }
+        }
+        // Check for cost anomalies (simple std dev check)
+        if (summary.temporal_distribution.length > 2) {
+            const costs = summary.temporal_distribution.map((d) => d.cost_usd);
+            const mean = costs.reduce((a, b) => a + b, 0) / costs.length;
+            const variance = costs.reduce((a, b) => a + Math.pow(b - mean, 2), 0) / costs.length;
+            const stdDev = Math.sqrt(variance);
+            const latestCost = costs[costs.length - 1];
+            if (stdDev > 0 &&
+                Math.abs(latestCost - mean) > this.thresholds.costAnomalyStdDev * stdDev) {
+                detectedPatterns.push({
+                    pattern_id: generateUUID(),
+                    category: 'cost_anomaly',
+                    severity: latestCost > mean ? 'warning' : 'info',
+                    description: `Cost ${latestCost > mean ? 'spike' : 'drop'} detected: ${latestCost.toFixed(2)} USD (mean: ${mean.toFixed(2)})`,
+                    affected_scope: {
+                        users: summary.by_user.slice(0, 3).map((u) => u.user_id),
+                        models: summary.by_model.slice(0, 3).map((m) => m.model),
+                    },
+                    metrics: {
+                        observed_value: latestCost,
+                        threshold_value: mean + this.thresholds.costAnomalyStdDev * stdDev,
+                        deviation_percentage: ((latestCost - mean) / mean) * 100,
+                    },
+                    timeframe: {
+                        start: summary.temporal_distribution[summary.temporal_distribution.length - 1].period + 'T00:00:00Z',
+                        end: summary.temporal_distribution[summary.temporal_distribution.length - 1].period + 'T23:59:59Z',
+                    },
+                });
+            }
+        }
+        return {
+            patterns: detectedPatterns,
+            coverageScore,
+        };
+    }
+    /**
+     * Evaluate policy adherence
+     */
+    evaluatePolicies(_patterns, policyContext) {
+        const adherence = [];
+        for (const policy of policyContext.active_policies) {
+            const ruleAdherence = policy.rules.map((rule) => {
+                // Simple rule evaluation - in production this would be more sophisticated
+                return {
+                    rule_id: rule.rule_id,
+                    rule_type: rule.rule_type,
+                    status: 'compliant',
+                };
+            });
+            const compliantCount = ruleAdherence.filter((r) => r.status === 'compliant').length;
+            adherence.push({
+                policy_id: policy.policy_id,
+                policy_name: policy.policy_name,
+                status: compliantCount === ruleAdherence.length
+                    ? 'compliant'
+                    : compliantCount > ruleAdherence.length / 2
+                        ? 'warning'
+                        : 'violation',
+                adherence_percentage: (compliantCount / ruleAdherence.length) * 100,
+                rule_adherence: ruleAdherence,
+            });
+        }
+        // Budget status
+        const budgetStatus = (policyContext.budget_limits || []).map((b) => {
+            const percentUsed = (b.current_spend_usd / b.limit_usd) * 100;
+            return {
+                budget_id: b.budget_id,
+                scope: b.scope,
+                scope_id: b.scope_id,
+                limit_usd: b.limit_usd,
+                current_spend_usd: b.current_spend_usd,
+                percentage_used: percentUsed,
+                status: percentUsed >= this.thresholds.budgetCriticalPercent
+                    ? 'critical'
+                    : percentUsed >= this.thresholds.budgetWarningPercent
+                        ? 'warning'
+                        : 'healthy',
+            };
+        });
+        // Quota status
+        const quotaStatus = (policyContext.quota_limits || []).map((q) => {
+            const percentUsed = (q.current_value / q.limit_value) * 100;
+            return {
+                quota_id: q.quota_id,
+                quota_type: q.quota_type,
+                scope: q.scope,
+                scope_id: q.scope_id,
+                limit_value: q.limit_value,
+                current_value: q.current_value,
+                percentage_used: percentUsed,
+                status: percentUsed >= this.thresholds.quotaCriticalPercent
+                    ? 'critical'
+                    : percentUsed >= this.thresholds.quotaWarningPercent
+                        ? 'warning'
+                        : 'healthy',
+            };
+        });
+        return { adherence, budgetStatus, quotaStatus };
+    }
+    /**
+     * Calculate governance health score
+     */
+    calculateHealthScore(patterns, adherence) {
+        let score = 100;
+        // Deduct for patterns
+        for (const pattern of patterns) {
+            switch (pattern.severity) {
+                case 'alert':
+                    score -= 15;
+                    break;
+                case 'warning':
+                    score -= 8;
+                    break;
+                case 'advisory':
+                    score -= 3;
+                    break;
+                case 'info':
+                    score -= 1;
+                    break;
+            }
+        }
+        // Deduct for non-compliant policies
+        for (const policy of adherence) {
+            if (policy.status === 'violation') {
+                score -= 20;
+            }
+            else if (policy.status === 'warning') {
+                score -= 10;
+            }
+        }
+        return Math.max(0, Math.min(100, score));
+    }
+    /**
+     * Generate recommendations
+     */
+    generateRecommendations(_patterns, policyResult, healthScore) {
+        const recommendations = [];
+        // Critical budget recommendations
+        const criticalBudgets = policyResult.budgetStatus.filter((b) => b.status === 'critical');
+        if (criticalBudgets.length > 0) {
+            recommendations.push({
+                recommendation_id: generateUUID(),
+                priority: 'high',
+                category: 'budget',
+                description: `${criticalBudgets.length} budget(s) at critical levels`,
+                action_items: [
+                    'Review high-cost users and models',
+                    'Consider implementing rate limiting',
+                    'Evaluate cost optimization strategies',
+                ],
+            });
+        }
+        // Low health score recommendations
+        if (healthScore < 50) {
+            recommendations.push({
+                recommendation_id: generateUUID(),
+                priority: 'high',
+                category: 'governance',
+                description: 'Governance health score is critically low',
+                action_items: [
+                    'Conduct immediate policy compliance review',
+                    'Identify and address pattern violations',
+                    'Consider implementing stricter controls',
+                ],
+            });
+        }
+        else if (healthScore < 75) {
+            recommendations.push({
+                recommendation_id: generateUUID(),
+                priority: 'medium',
+                category: 'governance',
+                description: 'Governance health score needs improvement',
+                action_items: [
+                    'Review detected patterns for corrective actions',
+                    'Update policies based on current usage patterns',
+                ],
+            });
+        }
+        return recommendations;
+    }
+    /**
+     * Calculate confidence metrics for the analysis
+     */
+    calculateConfidence(input, output) {
+        // Coverage: how much of the requested scope was analyzed
+        const requestedUserCount = input.filters?.user_ids?.length || Infinity;
+        const analyzedUserCount = output.usage_summary.unique_users;
+        const userCoverage = Math.min(1, analyzedUserCount / requestedUserCount);
+        // Completeness: how complete is the output
+        const hasUsageSummary = output.usage_summary.total_requests > 0 ? 1 : 0;
+        const hasPolicyAdherence = output.policy_adherence.length > 0 ? 1 : 0;
+        const hasHealthScore = output.governance_health_score >= 0 ? 1 : 0;
+        const completeness = (hasUsageSummary + hasPolicyAdherence + hasHealthScore) / 3;
+        const coverage = (userCoverage + 1) / 2; // Average with time coverage (assumed 100%)
+        const overall = DecisionEventEmitter.calculateOverallConfidence(coverage, completeness);
+        return { coverage, completeness, overall };
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/usage-oversight/agent.js.map

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

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/usage-oversight/factory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Usage Oversight Agent Factory
+ *
+ * Factory functions for creating UsageOversightAgent instances.
+ */
+import { UsageOversightAgent, UsageOversightAgentConfig } from './agent.js';
+/**
+ * Create a Usage Oversight Agent with explicit configuration
+ */
+export declare function createUsageOversightAgent(config: UsageOversightAgentConfig): UsageOversightAgent;
+/**
+ * Create a Usage Oversight Agent from environment variables
+ *
+ * Required environment variables:
+ * - RUVECTOR_SERVICE_URL: URL of the ruvector-service
+ * - RUVECTOR_API_KEY: API key for ruvector-service
+ *
+ * Optional environment variables:
+ * - LLM_OBSERVATORY_URL: URL of LLM-Observatory for telemetry
+ * - LLM_OBSERVATORY_API_KEY: API key for Observatory
+ * - AGENT_DRY_RUN: Set to 'true' to disable persistence
+ */
+export declare function createUsageOversightAgentFromEnv(): UsageOversightAgent;
+/**
+ * Create a Usage Oversight Agent for testing
+ *
+ * Uses mock clients that don't make actual network calls.
+ */
+export declare function createUsageOversightAgentForTesting(overrides?: Partial<UsageOversightAgentConfig>): UsageOversightAgent;
+//# sourceMappingURL=factory.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/usage-oversight/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/agents/usage-oversight/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAO5E;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAErB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,IAAI,mBAAmB,CAUtE;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAC7C,mBAAmB,CAcrB"}