erosolar-cli 1.7.371 → 1.7.373

package/dist/contracts/agent-schemas.json

@@ -308,6 +308,11 @@
       "description": "Show all available commands and keyboard shortcuts",
       "category": "other"
     },
+    {
+      "command": "/features",
+      "description": "Toggle optional features (AlphaZero dual, metrics, MCP, etc.)",
+      "category": "configuration"
+    },
     {
       "command": "/model",
       "description": "Choose what model to use",

package/dist/core/alphaZeroEngine.d.ts

@@ -0,0 +1,269 @@
+/**
+ * AlphaZero-Style Dual Agent Engine
+ *
+ * Implements self-play concepts for code generation:
+ * 1. Dual Response Generation - Generate 2 responses, pick the best
+ * 2. Self-Critique Loop - Critique and improve responses
+ * 3. Solution Quality Scoring - Multi-dimensional evaluation
+ * 4. Tool Pattern Learning - Learn optimal tool sequences
+ *
+ * Principal Investigator: Bo Shang
+ */
+import type { ProviderUsage } from './types.js';
+export interface DualResponse {
+    responseA: GeneratedResponse;
+    responseB: GeneratedResponse;
+    winner: 'A' | 'B' | 'tie';
+    evaluation: ResponseEvaluation;
+    combinedResponse?: string;
+}
+export interface GeneratedResponse {
+    content: string;
+    toolCalls: ToolCallRecord[];
+    duration: number;
+    tokenUsage?: ProviderUsage;
+    temperature: number;
+    confidence: number;
+}
+export interface ToolCallRecord {
+    name: string;
+    arguments: Record<string, unknown>;
+    result?: string;
+    success: boolean;
+    duration: number;
+}
+export interface ResponseEvaluation {
+    qualityScoreA: number;
+    qualityScoreB: number;
+    dimensions: EvaluationDimensions;
+    reasoning: string;
+    confidence: number;
+}
+export interface EvaluationDimensions {
+    correctness: {
+        a: number;
+        b: number;
+    };
+    completeness: {
+        a: number;
+        b: number;
+    };
+    efficiency: {
+        a: number;
+        b: number;
+    };
+    codeQuality: {
+        a: number;
+        b: number;
+    };
+    toolUsage: {
+        a: number;
+        b: number;
+    };
+}
+export interface SelfCritiqueResult {
+    originalResponse: string;
+    critique: string;
+    issues: CritiqueIssue[];
+    improvedResponse?: string;
+    improvementScore: number;
+}
+export interface CritiqueIssue {
+    category: 'correctness' | 'completeness' | 'efficiency' | 'style' | 'security';
+    severity: 'critical' | 'major' | 'minor';
+    description: string;
+    suggestion?: string;
+    location?: string;
+}
+export interface ToolPattern {
+    taskType: string;
+    toolSequence: string[];
+    successRate: number;
+    avgDuration: number;
+    occurrences: number;
+}
+export interface LearningState {
+    toolPatterns: Map<string, ToolPattern[]>;
+    successfulPromptPatterns: string[];
+    failurePatterns: string[];
+    qualityThresholds: Record<string, number>;
+}
+/**
+ * Configuration for dual response generation
+ */
+export interface DualResponseConfig {
+    enabled: boolean;
+    temperatureA: number;
+    temperatureB: number;
+    evaluationModel?: string;
+    minQualityDifference: number;
+    timeoutMs: number;
+}
+export declare const DEFAULT_DUAL_CONFIG: DualResponseConfig;
+/**
+ * Generates evaluation prompt for comparing two responses
+ */
+export declare function buildEvaluationPrompt(userQuery: string, responseA: string, responseB: string): string;
+/**
+ * Parse evaluation response from LLM
+ */
+export declare function parseEvaluationResponse(response: string): ResponseEvaluation | null;
+/**
+ * Generates self-critique prompt
+ */
+export declare function buildCritiquePrompt(userQuery: string, response: string, toolCalls: ToolCallRecord[]): string;
+/**
+ * Parse critique response
+ */
+export declare function parseCritiqueResponse(response: string): CritiqueIssue[];
+/**
+ * Build improvement prompt based on critique
+ */
+export declare function buildImprovementPrompt(userQuery: string, originalResponse: string, issues: CritiqueIssue[]): string;
+/**
+ * Tool pattern tracker for learning optimal sequences
+ */
+export declare class ToolPatternTracker {
+    private patterns;
+    private currentSequence;
+    private currentTaskType;
+    private sequenceStartTime;
+    /**
+     * Start tracking a new task
+     */
+    startTask(taskType: string): void;
+    /**
+     * Record a tool use
+     */
+    recordToolUse(toolName: string, success: boolean): void;
+    /**
+     * Complete the current task and record the pattern
+     */
+    completeTask(success: boolean): void;
+    /**
+     * Get recommended tool sequence for a task type
+     */
+    getRecommendedSequence(taskType: string): string[] | null;
+    /**
+     * Get all learned patterns
+     */
+    getAllPatterns(): Map<string, ToolPattern[]>;
+    /**
+     * Export patterns for persistence
+     */
+    exportPatterns(): Record<string, ToolPattern[]>;
+    /**
+     * Import patterns from persistence
+     */
+    importPatterns(data: Record<string, ToolPattern[]>): void;
+}
+export interface QualityScore {
+    overall: number;
+    correctness: number;
+    completeness: number;
+    efficiency: number;
+    maintainability: number;
+    security: number;
+    breakdown: string;
+}
+/**
+ * Quick heuristic-based quality scoring (no LLM needed)
+ */
+export declare function quickQualityScore(response: string, toolCalls: ToolCallRecord[]): QualityScore;
+/**
+ * Classify task type from user query for pattern matching
+ */
+export declare function classifyTaskType(query: string): string;
+export interface AlphaZeroConfig {
+    dualResponseEnabled: boolean;
+    selfCritiqueEnabled: boolean;
+    patternLearningEnabled: boolean;
+    minQualityThreshold: number;
+    maxCritiqueIterations: number;
+}
+export interface AlphaZeroSessionStats {
+    dualResponsesGenerated: number;
+    critiqueIterations: number;
+    improvementsApplied: number;
+    patternsLearned: number;
+}
+export declare const DEFAULT_ALPHA_CONFIG: AlphaZeroConfig;
+/**
+ * Main AlphaZero Engine coordinating all components
+ */
+export declare class AlphaZeroEngine {
+    private config;
+    private patternTracker;
+    private sessionStats;
+    constructor(config?: Partial<AlphaZeroConfig>);
+    /**
+     * Start tracking a task
+     */
+    startTask(userQuery: string): void;
+    /**
+     * Record a tool call
+     */
+    recordToolCall(toolName: string, success: boolean): void;
+    /**
+     * Complete current task
+     */
+    completeTask(success: boolean): void;
+    /**
+     * Get recommended tools for current task type
+     */
+    getRecommendedTools(taskType: string): string[] | null;
+    /**
+     * Score a response
+     */
+    scoreResponse(response: string, toolCalls: ToolCallRecord[]): QualityScore;
+    /**
+     * Check if response needs improvement
+     */
+    needsImprovement(score: QualityScore): boolean;
+    /**
+     * Get session statistics
+     */
+    getStats(): AlphaZeroSessionStats;
+    /**
+     * Export learned patterns
+     */
+    exportLearning(): {
+        patterns: Record<string, ToolPattern[]>;
+        stats: AlphaZeroSessionStats;
+    };
+    /**
+     * Import learned patterns
+     */
+    importLearning(data: {
+        patterns: Record<string, ToolPattern[]>;
+    }): void;
+    /**
+     * Increment dual response counter
+     */
+    recordDualResponse(): void;
+    /**
+     * Increment critique counter
+     */
+    recordCritique(): void;
+    /**
+     * Increment improvement counter
+     */
+    recordImprovement(): void;
+    /**
+     * Get configuration
+     */
+    getConfig(): AlphaZeroConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<AlphaZeroConfig>): void;
+}
+/**
+ * Get the global AlphaZero engine instance
+ */
+export declare function getAlphaZeroEngine(): AlphaZeroEngine;
+/**
+ * Reset the engine (for testing)
+ */
+export declare function resetAlphaZeroEngine(): void;
+//# sourceMappingURL=alphaZeroEngine.d.ts.map

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

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