erosolar-cli 1.7.439 → 1.7.441

package/dist/core/metricsTracker.js

@@ -0,0 +1,273 @@
+/**
+ * Performance Metrics Tracker
+ *
+ * Tracks session performance metrics for analytics and improvement suggestions.
+ * Integrated with AlphaZero engine for learning-based improvements.
+ */
+import { getAlphaZeroEngine, quickQualityScore, classifyTaskType, } from './alphaZeroEngine.js';
+/**
+ * Creates default performance metrics.
+ */
+export function createDefaultMetrics(sessionId) {
+    return {
+        sessionId,
+        totalMessages: 0,
+        totalToolCalls: 0,
+        totalTokensUsed: 0,
+        totalTimeMs: 0,
+        successfulToolCalls: 0,
+        failedToolCalls: 0,
+        codeBlocksGenerated: 0,
+        avgResponseTimeMs: 0,
+        avgCodeQuality: 0,
+        avgAlgorithmEfficiency: 0,
+        avgErrorHandling: 0,
+    };
+}
+/**
+ * Tracks performance metrics for an agent session.
+ */
+export class MetricsTracker {
+    metrics;
+    responseTimes = [];
+    codeQualityScores = [];
+    efficiencyScores = [];
+    errorHandlingScores = [];
+    traces = [];
+    constructor(sessionId) {
+        this.metrics = createDefaultMetrics(sessionId);
+    }
+    /**
+     * Record a message exchange.
+     */
+    recordMessage(elapsedMs, usage) {
+        this.metrics.totalMessages += 1;
+        this.metrics.totalTimeMs += elapsedMs;
+        this.responseTimes.push(elapsedMs);
+        if (usage) {
+            const tokens = usage.totalTokens ?? (usage.inputTokens ?? 0) + (usage.outputTokens ?? 0);
+            this.metrics.totalTokensUsed += tokens;
+        }
+        this.updateAverages();
+    }
+    /**
+     * Record a tool call.
+     */
+    recordToolCall(success) {
+        this.metrics.totalToolCalls += 1;
+        if (success) {
+            this.metrics.successfulToolCalls += 1;
+        }
+        else {
+            this.metrics.failedToolCalls += 1;
+        }
+    }
+    /**
+     * Record code generation.
+     */
+    recordCodeGeneration(codeBlockCount) {
+        this.metrics.codeBlocksGenerated += codeBlockCount;
+    }
+    /**
+     * Record code quality evaluation.
+     */
+    recordCodeQuality(quality) {
+        this.codeQualityScores.push(quality.codeQualityScore);
+        this.efficiencyScores.push(quality.algorithmEfficiency);
+        this.errorHandlingScores.push(quality.errorHandlingScore);
+        this.updateAverages();
+    }
+    /**
+     * Add an execution trace.
+     */
+    addTrace(trace) {
+        this.traces.push(trace);
+        // Keep only the last 100 traces
+        if (this.traces.length > 100) {
+            this.traces.shift();
+        }
+    }
+    /**
+     * Update running averages.
+     */
+    updateAverages() {
+        if (this.responseTimes.length > 0) {
+            this.metrics.avgResponseTimeMs =
+                this.responseTimes.reduce((a, b) => a + b, 0) / this.responseTimes.length;
+        }
+        if (this.codeQualityScores.length > 0) {
+            this.metrics.avgCodeQuality =
+                this.codeQualityScores.reduce((a, b) => a + b, 0) / this.codeQualityScores.length;
+        }
+        if (this.efficiencyScores.length > 0) {
+            this.metrics.avgAlgorithmEfficiency =
+                this.efficiencyScores.reduce((a, b) => a + b, 0) / this.efficiencyScores.length;
+        }
+        if (this.errorHandlingScores.length > 0) {
+            this.metrics.avgErrorHandling =
+                this.errorHandlingScores.reduce((a, b) => a + b, 0) / this.errorHandlingScores.length;
+        }
+    }
+    /**
+     * Get current metrics.
+     */
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    /**
+     * Get execution traces.
+     */
+    getTraces() {
+        return [...this.traces];
+    }
+    /**
+     * Get human-readable performance summary.
+     */
+    getPerformanceSummary() {
+        const m = this.metrics;
+        const lines = [
+            `Agent Performance Summary: ${m.sessionId}`,
+            '='.repeat(50),
+            `Messages: ${m.totalMessages}`,
+            `Total Time: ${(m.totalTimeMs / 1000).toFixed(2)}s`,
+            `Avg Response: ${m.avgResponseTimeMs.toFixed(0)}ms`,
+            `Code Blocks: ${m.codeBlocksGenerated}`,
+            `Tokens Used: ${m.totalTokensUsed.toLocaleString()}`,
+            '',
+            'Tool Usage:',
+            `  Total Calls: ${m.totalToolCalls}`,
+            `  Success Rate: ${m.totalToolCalls > 0 ? ((m.successfulToolCalls / m.totalToolCalls) * 100).toFixed(1) : 0}%`,
+            '',
+            'Code Quality Metrics:',
+            `  Quality Score: ${(m.avgCodeQuality * 100).toFixed(1)}/100`,
+            `  Algorithm Efficiency: ${(m.avgAlgorithmEfficiency * 100).toFixed(1)}/100`,
+            `  Error Handling: ${(m.avgErrorHandling * 100).toFixed(1)}/100`,
+        ];
+        return lines.join('\n');
+    }
+    /**
+     * Get improvement suggestions based on metrics.
+     */
+    getImprovementSuggestions() {
+        const suggestions = [];
+        const m = this.metrics;
+        if (m.avgResponseTimeMs > 5000) {
+            suggestions.push({
+                category: 'performance',
+                severity: 'high',
+                message: 'Response time is high - consider optimizing prompts or using a faster model',
+                suggestedAction: 'Review prompt complexity and consider caching common operations',
+            });
+        }
+        if (m.avgCodeQuality < 0.5 && m.codeBlocksGenerated > 0) {
+            suggestions.push({
+                category: 'quality',
+                severity: 'medium',
+                message: 'Code quality is below average - enhance system prompt with coding best practices',
+                suggestedAction: 'Add explicit code style guidelines to the system prompt',
+            });
+        }
+        if (m.avgAlgorithmEfficiency < 0.5 && m.codeBlocksGenerated > 0) {
+            suggestions.push({
+                category: 'efficiency',
+                severity: 'medium',
+                message: 'Algorithm efficiency is low - add guidance for efficient data structures',
+                suggestedAction: 'Include examples of optimal algorithm patterns in prompts',
+            });
+        }
+        if (m.avgErrorHandling < 0.3 && m.codeBlocksGenerated > 0) {
+            suggestions.push({
+                category: 'error-handling',
+                severity: 'high',
+                message: 'Error handling is weak - instruct agent to include try/catch blocks',
+                suggestedAction: 'Require explicit error handling in generated code',
+            });
+        }
+        if (m.totalToolCalls > 0 && m.failedToolCalls / m.totalToolCalls > 0.2) {
+            suggestions.push({
+                category: 'performance',
+                severity: 'medium',
+                message: `Tool failure rate is ${((m.failedToolCalls / m.totalToolCalls) * 100).toFixed(1)}%`,
+                suggestedAction: 'Review failed tool calls and improve error recovery',
+            });
+        }
+        return suggestions;
+    }
+    /**
+     * Reset all metrics.
+     */
+    reset() {
+        this.metrics = createDefaultMetrics(this.metrics.sessionId);
+        this.responseTimes = [];
+        this.codeQualityScores = [];
+        this.efficiencyScores = [];
+        this.errorHandlingScores = [];
+        this.traces = [];
+    }
+    // =========================================================================
+    // ALPHA ZERO INTEGRATION
+    // =========================================================================
+    /**
+     * Start tracking a new task with AlphaZero
+     */
+    startAlphaZeroTask(userQuery) {
+        const engine = getAlphaZeroEngine();
+        engine.startTask(userQuery);
+    }
+    /**
+     * Record tool call with AlphaZero pattern learning
+     */
+    recordToolCallWithLearning(toolName, success, durationMs) {
+        this.recordToolCall(success);
+        const engine = getAlphaZeroEngine();
+        engine.recordToolCall(toolName, success);
+    }
+    /**
+     * Complete task and record pattern
+     */
+    completeAlphaZeroTask(success) {
+        const engine = getAlphaZeroEngine();
+        engine.completeTask(success);
+    }
+    /**
+     * Get quick quality score for a response
+     */
+    getResponseQualityScore(response, toolCalls) {
+        return quickQualityScore(response, toolCalls);
+    }
+    /**
+     * Get recommended tools for a task type
+     */
+    getRecommendedTools(userQuery) {
+        const taskType = classifyTaskType(userQuery);
+        const engine = getAlphaZeroEngine();
+        return engine.getRecommendedTools(taskType);
+    }
+    /**
+     * Get AlphaZero statistics
+     */
+    getAlphaZeroStats() {
+        const engine = getAlphaZeroEngine();
+        return engine.getStats();
+    }
+    /**
+     * Get combined performance summary with AlphaZero stats
+     */
+    getEnhancedPerformanceSummary() {
+        const baseSummary = this.getPerformanceSummary();
+        const alphaStats = this.getAlphaZeroStats();
+        const engine = getAlphaZeroEngine();
+        const patterns = engine.exportLearning().patterns;
+        const patternCount = Object.values(patterns).reduce((sum, p) => sum + p.length, 0);
+        const alphaSection = [
+            '',
+            'AlphaZero Learning:',
+            `  Dual Responses: ${alphaStats.dualResponsesGenerated}`,
+            `  Self-Critiques: ${alphaStats.critiqueIterations}`,
+            `  Improvements Applied: ${alphaStats.improvementsApplied}`,
+            `  Patterns Learned: ${patternCount}`,
+        ].join('\n');
+        return baseSummary + alphaSection;
+    }
+}
+//# sourceMappingURL=metricsTracker.js.map

package/dist/core/metricsTracker.js.map

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

package/dist/core/modelDiscovery.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Model discovery system for auto-detecting new models from providers.
+ *
+ * This module queries provider APIs to discover available models and caches
+ * them for use alongside the static model schema. It never modifies the
+ * static schema - discoveries are stored separately and merged at runtime.
+ */
+import type { ProviderId } from './types.js';
+import type { ModelConfig } from './agentSchemaLoader.js';
+/**
+ * Model discovery result for a single provider
+ */
+export interface ProviderDiscoveryResult {
+    provider: ProviderId;
+    success: boolean;
+    models: ModelConfig[];
+    error?: string;
+}
+/**
+ * Complete discovery result
+ */
+export interface DiscoveryResult {
+    success: boolean;
+    timestamp: string;
+    results: ProviderDiscoveryResult[];
+    totalModelsDiscovered: number;
+    errors: string[];
+}
+/**
+ * Get cached discovered models
+ */
+export declare function getCachedDiscoveredModels(): ModelConfig[];
+/**
+ * Discover models from all configured providers
+ *
+ * PERF: Uses Promise.allSettled for parallel discovery - all providers queried
+ * simultaneously. No single slow/failed provider blocks the others.
+ */
+export declare function discoverAllModels(): Promise<DiscoveryResult>;
+/**
+ * Clear the discovered models cache
+ */
+export declare function clearDiscoveredModelsCache(): void;
+/**
+ * Provider configuration info
+ */
+export interface ProviderInfo {
+    id: ProviderId;
+    name: string;
+    envVar: string;
+    configured: boolean;
+    latestModel: string;
+    models?: string[];
+}
+/**
+ * Sort models by priority (best first)
+ */
+export declare function sortModelsByPriority(provider: ProviderId, models: string[]): string[];
+/**
+ * Get the best/latest model for a provider
+ */
+export declare function getBestModel(provider: ProviderId, models: string[]): string;
+/**
+ * Check if a provider is configured (has API key or is accessible)
+ */
+export declare function isProviderConfigured(providerId: ProviderId): boolean;
+/**
+ * Get all providers with their configuration status
+ */
+export declare function getProvidersStatus(): ProviderInfo[];
+/**
+ * Get list of configured providers (with valid API keys)
+ */
+export declare function getConfiguredProviders(): ProviderInfo[];
+/**
+ * Get list of unconfigured providers
+ */
+export declare function getUnconfiguredProviders(): ProviderInfo[];
+/**
+ * Get the first available provider (for auto-selection)
+ */
+export declare function getFirstAvailableProvider(): ProviderInfo | null;
+/**
+ * Get latest model for a provider from cache or defaults
+ */
+export declare function getLatestModelForProvider(providerId: ProviderId): string;
+/**
+ * Quick provider availability check result
+ */
+export interface QuickProviderStatus {
+    provider: ProviderId;
+    available: boolean;
+    latestModel: string;
+    error?: string;
+}
+/**
+ * Quickly check if providers are available by querying their APIs
+ * Returns actual latest models from each provider
+ */
+export declare function quickCheckProviders(): Promise<QuickProviderStatus[]>;
+//# sourceMappingURL=modelDiscovery.d.ts.map

package/dist/core/modelDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelDiscovery.d.ts","sourceRoot":"","sources":["../../src/core/modelDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAuB1D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,EAAE,CAqBzD;AAgUD;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,eAAe,CAAC,CA2GlE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAQjD;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAmGD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMrF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CA0BpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAuBnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,EAAE,CAEvD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,GAAG,IAAI,CAe/D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAaxE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkFD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA4E1E"}