erosolar-cli 2.1.193 → 2.1.194

package/dist/core/agentOrchestrator.d.ts

@@ -0,0 +1,49 @@
+import { AgentRuntime } from './agent.js';
+import { type CompletionAnalysis } from './taskCompletionDetector.js';
+export type OrchestratorExitReason = 'complete' | 'max-passes' | 'empty-response' | 'stalled';
+export interface OrchestratorOptions {
+    /** Maximum number of passes to attempt before giving up */
+    maxPasses?: number;
+    /** Whether to stream provider responses */
+    streaming?: boolean;
+    /** Require observable action (tool usage or action language) before stopping */
+    enforceActions?: boolean;
+    /** Maximum number of consecutive low-progress passes before forcing a reset */
+    maxStagnantPasses?: number;
+    /** Whether to inject a verification check before declaring completion */
+    verificationMode?: 'auto' | 'disabled';
+}
+export interface OrchestratorPass {
+    response: string;
+    toolsUsed: string[];
+    planOnly: boolean;
+    tookAction: boolean;
+    completion: CompletionAnalysis;
+    followUpPrompt?: string;
+}
+export interface OrchestratorResult {
+    finalResponse: string;
+    passes: OrchestratorPass[];
+    exitReason: OrchestratorExitReason;
+}
+/**
+ * Drives an AgentRuntime through multiple passes until the request is actually completed.
+ * Helps avoid early stops after plan-only replies by forcing follow-up prompts that demand action.
+ */
+export declare class AgentOrchestrator {
+    private readonly agent;
+    constructor(agent: AgentRuntime);
+    runToCompletion(request: string, options?: OrchestratorOptions): Promise<OrchestratorResult>;
+    private analyzeResponse;
+    private isPlanOnly;
+    private hasExplicitCompletion;
+    private hasCompletionContradiction;
+    private hasActionLanguage;
+    private isLoopWarning;
+    private wordCount;
+    private buildFollowUp;
+    private buildVerificationPrompt;
+    private hasContinuingSignal;
+    private isBlockedResponse;
+}
+//# sourceMappingURL=agentOrchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentOrchestrator.d.ts","sourceRoot":"","sources":["../../src/core/agentOrchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4B,MAAM,YAAY,CAAC;AACpE,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE9F,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE9F,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,UAAU,EAAE,sBAAsB,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,KAAK,EAAE,YAAY;IAIzB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8GlG,OAAO,CAAC,eAAe;IAiDvB,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,0BAA0B;IAelC,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,aAAa;IAuDrB,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/core/agentOrchestrator.js

@@ -0,0 +1,313 @@
+import { TaskCompletionDetector } from './taskCompletionDetector.js';
+/**
+ * Drives an AgentRuntime through multiple passes until the request is actually completed.
+ * Helps avoid early stops after plan-only replies by forcing follow-up prompts that demand action.
+ */
+export class AgentOrchestrator {
+    agent;
+    constructor(agent) {
+        this.agent = agent;
+    }
+    async runToCompletion(request, options) {
+        const maxPasses = options?.maxPasses ?? 8;
+        const streaming = options?.streaming ?? true;
+        const enforceActions = options?.enforceActions ?? true;
+        const maxStagnantPasses = options?.maxStagnantPasses ?? 3;
+        const verificationMode = options?.verificationMode ?? 'auto';
+        const passes = [];
+        const completionDetector = new TaskCompletionDetector();
+        let prompt = request.trim();
+        let exitReason = null;
+        let consecutiveLowProgress = 0;
+        let awaitingVerification = false;
+        for (let pass = 0; pass < maxPasses; pass++) {
+            const response = (await this.agent.send(prompt, streaming)).trim();
+            const toolExecutions = this.agent.drainToolExecutions();
+            toolExecutions.forEach(exec => completionDetector.recordToolCall(exec.name, exec.success, exec.hasOutput));
+            const toolsUsed = toolExecutions.filter(exec => exec.success).map(exec => exec.name);
+            const completion = completionDetector.analyzeCompletion(response, toolsUsed);
+            const analysis = this.analyzeResponse(response, toolsUsed, enforceActions);
+            const planOnly = analysis.planOnly;
+            const tookAction = analysis.tookAction;
+            const passRecord = { response, toolsUsed, planOnly, tookAction, completion };
+            passes.push(passRecord);
+            if (awaitingVerification) {
+                if (completionDetector.isVerificationConfirmed(response)) {
+                    exitReason = 'complete';
+                    break;
+                }
+                awaitingVerification = false;
+            }
+            if (completion.isComplete || analysis.readyToStop) {
+                exitReason = 'complete';
+                break;
+            }
+            const loopDetected = this.isLoopWarning(response);
+            if (completion.shouldVerify && completion.verificationPrompt && verificationMode === 'auto') {
+                awaitingVerification = true;
+                const followUp = this.buildVerificationPrompt(request, completion.verificationPrompt, toolsUsed);
+                passRecord.followUpPrompt = followUp;
+                prompt = followUp;
+                continue;
+            }
+            if (analysis.empty) {
+                if (pass === maxPasses - 1) {
+                    exitReason = 'empty-response';
+                    break;
+                }
+                consecutiveLowProgress++;
+                const followUp = this.buildFollowUp(request, response, toolsUsed, 'empty', consecutiveLowProgress);
+                passRecord.followUpPrompt = followUp;
+                prompt = followUp;
+                continue;
+            }
+            const lowProgress = !tookAction || analysis.planOnly || loopDetected;
+            consecutiveLowProgress = lowProgress ? consecutiveLowProgress + 1 : 0;
+            if (consecutiveLowProgress >= maxStagnantPasses) {
+                if (pass === maxPasses - 1) {
+                    exitReason = 'stalled';
+                    break;
+                }
+                const followUp = this.buildFollowUp(request, response, toolsUsed, 'stalled', consecutiveLowProgress);
+                passRecord.followUpPrompt = followUp;
+                prompt = followUp;
+                continue;
+            }
+            if (pass === maxPasses - 1) {
+                exitReason = 'max-passes';
+                break;
+            }
+            const followUp = this.buildFollowUp(request, response, toolsUsed, loopDetected ? 'stalled' : analysis.reason, consecutiveLowProgress);
+            passRecord.followUpPrompt = followUp;
+            prompt = followUp;
+        }
+        if (!exitReason) {
+            const lastPass = passes[passes.length - 1];
+            const exhaustedPasses = passes.length >= maxPasses;
+            if (exhaustedPasses && lastPass && !lastPass.tookAction) {
+                exitReason = 'stalled';
+            }
+            else if (exhaustedPasses) {
+                exitReason = 'max-passes';
+            }
+            else {
+                exitReason = 'complete';
+            }
+        }
+        return {
+            finalResponse: passes[passes.length - 1]?.response ?? '',
+            passes,
+            exitReason,
+        };
+    }
+    analyzeResponse(response, toolsUsed, enforceActions) {
+        const trimmed = response.trim();
+        const empty = trimmed.length === 0;
+        const planOnly = this.isPlanOnly(trimmed);
+        const tookAction = toolsUsed.length > 0 || this.hasActionLanguage(trimmed);
+        const hasCompletionMarker = this.hasExplicitCompletion(trimmed);
+        const completionContradiction = this.hasCompletionContradiction(trimmed);
+        const continuing = this.hasContinuingSignal(trimmed);
+        const blocked = this.isBlockedResponse(trimmed);
+        const tooLight = this.wordCount(trimmed) < 80;
+        const lacksEvidence = !tookAction && tooLight;
+        const needsMoreWork = empty ||
+            blocked ||
+            completionContradiction ||
+            continuing ||
+            planOnly ||
+            (enforceActions && (lacksEvidence || (!hasCompletionMarker && !tookAction)));
+        const readyToStop = hasCompletionMarker &&
+            !completionContradiction &&
+            !continuing &&
+            (!enforceActions || tookAction || !tooLight);
+        const reason = (() => {
+            if (blocked)
+                return 'blocked';
+            if (completionContradiction)
+                return 'contradiction';
+            if (continuing)
+                return 'continuing';
+            if (planOnly)
+                return 'plan-only';
+            if (empty)
+                return 'empty';
+            if (lacksEvidence)
+                return 'no-action';
+            return 'keep-going';
+        })();
+        return {
+            empty,
+            planOnly,
+            tookAction,
+            needsMoreWork,
+            readyToStop,
+            reason,
+        };
+    }
+    isPlanOnly(response) {
+        if (!response.trim())
+            return false;
+        const planIndicators = [
+            /\bplan\b/i,
+            /\bapproach\b/i,
+            /\bsteps?:\b/i,
+            /\bstep\s+1\b/i,
+            /\bstart by\b/i,
+            /\bfirst[, ]/i,
+            /\bthen\b/i,
+            /\bnext\b/i,
+            /\bwe\s+will\b/i,
+            /\bi['\u2019]?ll\b/i,
+            /\bi\s+will\b/i,
+            /\bhere(?:'|\u2019)s\s+the\s+plan\b/i,
+            /\bplan:\b/i,
+            /\bapproach:\b/i,
+            /\bexecution\s+plan\b/i,
+        ];
+        return planIndicators.some((pattern) => pattern.test(response));
+    }
+    hasExplicitCompletion(response) {
+        if (!response.trim())
+            return false;
+        if (response.includes('TASK_FULLY_COMPLETE'))
+            return true;
+        const completionPatterns = [
+            /\btask(s)? (is|are)?\s*complete\b/i,
+            /\ball done\b/i,
+            /\bcleanup complete\b/i,
+            /\bnothing (else\s*)?to do\b/i,
+            /\bno junk (found|remaining)\b/i,
+        ];
+        return completionPatterns.some((pattern) => pattern.test(response));
+    }
+    hasCompletionContradiction(response) {
+        const contradictions = [
+            /not\s+yet\s+(done|complete|finished|integrated|implemented)/i,
+            /\bstill\s+(need|needs|pending|left)\b/i,
+            /\bpending\b/i,
+            /\bremaining\b/i,
+            /\bnot\s+(working|functional)\b/i,
+            /\btests?\s+(are\s+)?failing\b/i,
+            /\bto\s+be\s+(done|completed|fixed|implemented)\b/i,
+            /\btodo\b/i,
+            /\bfixme\b/i,
+        ];
+        return contradictions.some((pattern) => pattern.test(response));
+    }
+    hasActionLanguage(response) {
+        const actionPatterns = [
+            /\bremoved\b/i,
+            /\bdeleted\b/i,
+            /\bcreated\b/i,
+            /\badded\b/i,
+            /\bupdated\b/i,
+            /\brefactored\b/i,
+            /\bcommitted\b/i,
+            /\bran\b.+\btests?\b/i,
+            /\bcleaned\b/i,
+            /\bexecuted\b/i,
+            /\bapplied\b/i,
+            /\bpatched\b/i,
+            /\bimplemented\b/i,
+            /\bfixed\b/i,
+            /\bverified\b/i,
+            /\bvalidated\b/i,
+            /\bdeployed\b/i,
+            /\bmerged\b/i,
+        ];
+        return actionPatterns.some((pattern) => pattern.test(response));
+    }
+    isLoopWarning(response) {
+        if (!response.trim())
+            return false;
+        const lower = response.toLowerCase();
+        return lower.includes('behavioral loop detected') || lower.includes('tool loop detected');
+    }
+    wordCount(text) {
+        if (!text.trim())
+            return 0;
+        return text.trim().split(/\s+/).length;
+    }
+    buildFollowUp(originalRequest, lastResponse, toolsUsed, reason, nudgeLevel) {
+        const toolLine = toolsUsed.length
+            ? `Tools already used: ${toolsUsed.join(', ')}. Keep using tools for the next actions.`
+            : 'No tools were used yet. Start with a quick workspace scan (list_files + glob/grep/search) and then run bash/edit/read/git tools to actually perform work.';
+        const focus = (() => {
+            switch (reason) {
+                case 'plan-only':
+                    return 'Stop repeating the plan. Execute the steps you described.';
+                case 'no-action':
+                    return 'You have not shown any concrete work yet. Take an immediate, visible action.';
+                case 'stalled':
+                    return 'You appear stuck or repeating yourself. Switch tools or choose a different approach and make a concrete change.';
+                case 'empty':
+                    return 'Your last reply was empty. Resume the task and perform actions now.';
+                case 'blocked':
+                    return 'You indicated you are blocked. Ask for the exact info you need and proceed with everything you can do now.';
+                case 'contradiction':
+                    return 'Your message mentions remaining work. Resolve the items before claiming completion.';
+                case 'continuing':
+                    return 'You are still narrating future intent. Execute a specific action and show its result.';
+                case 'keep-going':
+                default:
+                    return 'Continue executing until the request is fully completed.';
+            }
+        })();
+        const lastSnippet = lastResponse.trim()
+            ? `Your last response:\n${lastResponse.trim().slice(0, 800)}`
+            : 'No previous response was returned.';
+        const urgency = nudgeLevel > 1
+            ? 'Pick one concrete command (e.g., read a file, run tests, apply an edit) and show the output before summarizing.'
+            : 'Take the next concrete action and show the output before moving on.';
+        return `${originalRequest}
+
+${focus}
+${toolLine}
+${lastSnippet}
+
+- Use tools to inspect and modify the workspace as needed.
+- Run a quick repo scan (list_files, glob/grep/search) to gather evidence across the codebase before deciding you are done.
+- ${urgency}
+- Report concrete changes and progress after each action; include command outputs and file updates.
+- If you truly need information, ask one concise question and then keep working with what you can verify.
+- Reply with TASK_FULLY_COMPLETE only when the entire request is actually finished (no TODOs or pending work).`;
+    }
+    buildVerificationPrompt(originalRequest, verificationPrompt, toolsUsed) {
+        const toolLine = toolsUsed.length
+            ? `Recent tools: ${toolsUsed.join(', ')}.`
+            : 'No tools have been used yet; take concrete actions if anything remains.';
+        return `${verificationPrompt.trim()}
+
+Original request: ${originalRequest.trim()}
+
+${toolLine}
+- If anything is still outstanding, continue executing work instead of repeating plans.
+- Keep using tools to gather evidence and finish the task before claiming completion.`;
+    }
+    hasContinuingSignal(response) {
+        if (!response.trim())
+            return false;
+        const patterns = [
+            /\b(i'?m|i am)\s+(continuing|working|starting|beginning)\b/i,
+            /\bwill\s+(now|next)\s+(run|do|start|take|handle|work on)\b/i,
+            /\babout\s+to\s+(run|execute|start|begin)\b/i,
+            /\bnext\s+up\b/i,
+            /\bplan\s+to\s+start\b/i,
+        ];
+        return patterns.some((pattern) => pattern.test(response));
+    }
+    isBlockedResponse(response) {
+        if (!response.trim())
+            return false;
+        const patterns = [
+            /\bneed(s)?\s+(more\s+)?(info|information|details|clarification)\b/i,
+            /\bmissing\s+(api\s*key|credentials?|access|permission|token)\b/i,
+            /\b(no|not)\s+authorized\b/i,
+            /\bblocked\b/i,
+            /\bcannot\s+(proceed|continue|start|run|access)\b/i,
+        ];
+        return patterns.some((pattern) => pattern.test(response));
+    }
+}
+//# sourceMappingURL=agentOrchestrator.js.map

package/dist/core/agentOrchestrator.js.map

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

package/dist/core/alphaZeroOrchestrator.d.ts

@@ -0,0 +1,140 @@
+/**
+ * AlphaZero Orchestrator - Complete Self-Improvement System
+ *
+ * This module provides the "best" AlphaZero-style self-improvement for erosolar-cli:
+ *
+ * 1. DUAL-RESPONSE GENERATION
+ *    - Generate 2 responses with different temperatures
+ *    - Use LLM to evaluate and pick the winner
+ *    - Learn which approach works better for task types
+ *
+ * 2. SELF-CRITIQUE LOOP
+ *    - Critique responses for issues
+ *    - Iteratively improve until quality threshold met
+ *    - Learn from improvements for future responses
+ *
+ * 3. PATTERN LEARNING
+ *    - Track tool sequences that work well
+ *    - Record failure patterns to avoid
+ *    - Store successful prompts for reuse
+ *
+ * 4. SOURCE IMPROVEMENT
+ *    - Detect patterns in erosolar-cli itself
+ *    - Apply validated fixes with git safety
+ *    - Rollback on any failure
+ *
+ * Principal Investigator: Bo Shang
+ */
+import type { LLMProvider, ConversationMessage } from './types.js';
+import { type ToolCallRecord, type CritiqueIssue, type ResponseEvaluation } from './alphaZeroEngine.js';
+import { getLearningSummary } from './learningPersistence.js';
+export interface AlphaZeroConfig {
+    dualResponseEnabled: boolean;
+    temperatureConservative: number;
+    temperatureCreative: number;
+    selfCritiqueEnabled: boolean;
+    maxCritiqueIterations: number;
+    minQualityThreshold: number;
+    patternLearningEnabled: boolean;
+    autoApplyLearning: boolean;
+    sourceImprovementEnabled: boolean;
+    minValidationsForSourceFix: number;
+}
+export declare const DEFAULT_ALPHAZERO_CONFIG: AlphaZeroConfig;
+export interface AlphaZeroSession {
+    sessionId: string;
+    startTime: string;
+    taskType: string;
+    userQuery: string;
+    dualResponseUsed: boolean;
+    critiqueIterations: number;
+    finalQuality: number;
+    toolsUsed: string[];
+    success: boolean;
+    improvementsLearned: number;
+}
+export declare class AlphaZeroOrchestrator {
+    private config;
+    private provider;
+    private state;
+    constructor(config?: Partial<AlphaZeroConfig>);
+    /**
+     * Set the LLM provider for evaluations
+     */
+    setProvider(provider: LLMProvider): void;
+    /**
+     * Start tracking a new task
+     */
+    startTask(userQuery: string): string;
+    /**
+     * Record a tool call in current session
+     */
+    recordToolCall(toolName: string, success: boolean): void;
+    /**
+     * Complete the current task and learn from it
+     */
+    completeTask(response: string, toolCalls: ToolCallRecord[], success: boolean): Promise<{
+        qualityScore: number;
+        learned: string[];
+        suggestions: string[];
+    }>;
+    /**
+     * Generate two responses and pick the better one
+     */
+    generateDualResponse(messages: ConversationMessage[], userQuery: string): Promise<{
+        winningResponse: string;
+        evaluation: ResponseEvaluation | null;
+        used: boolean;
+    }>;
+    private responsesAreSimilar;
+    private evaluateResponses;
+    /**
+     * Critique and iteratively improve a response
+     */
+    selfCritiqueLoop(response: string, userQuery: string, toolCalls: ToolCallRecord[]): Promise<{
+        improvedResponse: string;
+        iterations: number;
+        issues: CritiqueIssue[];
+        qualityImprovement: number;
+    }>;
+    private critiqueResponse;
+    private improveResponse;
+    /**
+     * Get recommended tools for a task type
+     */
+    getRecommendedTools(taskType: string): string[] | null;
+    /**
+     * Get patterns to avoid for a task type
+     */
+    getPatternsToAvoid(taskType: string): string[];
+    /**
+     * Get comprehensive learning summary
+     */
+    getSummary(): {
+        sessions: number;
+        improvements: number;
+        avgQuality: number;
+        learningData: ReturnType<typeof getLearningSummary>;
+    };
+    /**
+     * Get current configuration
+     */
+    getConfig(): AlphaZeroConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<AlphaZeroConfig>): void;
+    /**
+     * Get formatted status for display
+     */
+    getStatus(): string;
+}
+/**
+ * Get the global AlphaZero orchestrator instance
+ */
+export declare function getAlphaZeroOrchestrator(): AlphaZeroOrchestrator;
+/**
+ * Initialize with a provider
+ */
+export declare function initializeAlphaZero(provider: LLMProvider): AlphaZeroOrchestrator;
+//# sourceMappingURL=alphaZeroOrchestrator.d.ts.map

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

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