codehere 0.1.1

package/dist/application/agents/validation-agent.js

@@ -0,0 +1,317 @@
+/**
+ * Application Agent: Validation Agent (Test Validator)
+ * Specialized agent for updating/generating tests, executing test suite, analyzing results
+ *
+ * Based on enterprise architecture: Separate Validation Agent
+ * Role: Validates execution results, runs tests, provides feedback
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { existsSync, readFileSync } from 'fs';
+import { agentValidationHelper } from '../../infrastructure/validation/agent-validation-helper.js';
+import { findCodebaseRoot } from '../../domain/services/codebase-detector.js';
+const execAsync = promisify(exec);
+export class ValidationAgent {
+    aiService;
+    verificationService;
+    cwd = process.cwd();
+    constructor(aiService, verificationService, cwd) {
+        this.aiService = aiService;
+        this.verificationService = verificationService;
+        if (cwd) {
+            this.cwd = cwd;
+        }
+    }
+    /**
+     * Validate execution results
+     * Runs tests, checks compilation, analyzes quality
+     */
+    async validate(request) {
+        const { plan, executionResults, filesModified = [] } = request;
+        // Start validation context
+        const codebaseInfo = findCodebaseRoot(this.cwd);
+        const validationContext = agentValidationHelper.startAgentOperation('validation-agent', 'validate', {
+            query: plan.goal,
+            codebaseId: codebaseInfo?.codebaseId,
+        });
+        try {
+            // Track validation checks
+            const validationChecks = [];
+            const errors = [];
+            const warnings = [];
+            // 1. Check compilation for modified files
+            const compilationResult = await this.checkCompilation(filesModified);
+            // Record compilation check
+            validationChecks.push({
+                check: 'Compilation',
+                passed: compilationResult.success,
+                message: compilationResult.success
+                    ? 'All files compile successfully'
+                    : `${compilationResult.errors.length} compilation error(s)`,
+                critical: true,
+            });
+            if (!compilationResult.success && compilationResult.errors.length > 0) {
+                errors.push(...compilationResult.errors);
+            }
+            // Trace compilation check
+            agentValidationHelper.trace({
+                operationType: 'code_analysis',
+                operationName: 'compile_check',
+                input: { files: filesModified },
+                output: compilationResult,
+                error: compilationResult.success ? undefined : new Error('Compilation failed'),
+                metadata: {
+                    filesChecked: filesModified.length,
+                    errors: compilationResult.errors.length,
+                },
+            });
+            // 2. Run test suite
+            const testResult = await this.runTests();
+            // Record test check
+            const testsPassed = testResult.testsPassed;
+            if (testResult.testResults) {
+                validationChecks.push({
+                    check: 'Tests',
+                    passed: testsPassed,
+                    message: testsPassed
+                        ? `All ${testResult.testResults.total} tests passed`
+                        : `${testResult.testResults.failed} of ${testResult.testResults.total} tests failed`,
+                    critical: true,
+                });
+                if (testResult.testResults.failures) {
+                    testResult.testResults.failures.forEach(failure => {
+                        errors.push(`Test failure: ${failure.test} - ${failure.error}`);
+                    });
+                }
+            }
+            else {
+                validationChecks.push({
+                    check: 'Tests',
+                    passed: true,
+                    message: 'No tests to run',
+                });
+            }
+            // Trace test execution
+            agentValidationHelper.trace({
+                operationType: 'code_analysis',
+                operationName: 'test_execution',
+                input: {},
+                output: testResult,
+                metadata: {
+                    testsTotal: testResult.testResults?.total,
+                    testsPassed: testResult.testResults?.passed,
+                    testsFailed: testResult.testResults?.failed,
+                },
+            });
+            // 3. Analyze code quality
+            const qualityAnalysis = await this.analyzeQuality(plan, executionResults);
+            // Calculate quality score for validation check
+            const qualityScore = this.calculateQualityScore(compilationResult, testResult, qualityAnalysis);
+            // Record quality check
+            validationChecks.push({
+                check: 'Code Quality',
+                passed: qualityScore >= 70, // Threshold
+                message: `Quality score: ${qualityScore}/100`,
+                critical: false,
+            });
+            if (qualityAnalysis.errorRate > 0.3) {
+                warnings.push(`High error rate: ${(qualityAnalysis.errorRate * 100).toFixed(1)}%`);
+            }
+            // 4. Generate recommendations
+            const recommendations = await this.generateRecommendations(compilationResult, testResult, qualityAnalysis);
+            const success = compilationResult.success && testResult.testsPassed;
+            // Complete validation
+            const validationResult = await agentValidationHelper.completeAgentOperation(validationContext, {
+                success,
+                testsPassed: testResult.testsPassed,
+                compilationSuccess: compilationResult.success,
+                testResults: testResult.testResults,
+                compilationErrors: compilationResult.errors,
+                recommendations,
+                qualityScore,
+            }, {
+                outcome: success ? 'success' : 'failure',
+                validationChecks,
+                errors: errors.length > 0 ? errors : undefined,
+                warnings: warnings.length > 0 ? warnings : undefined,
+                metrics: {
+                    filesAnalyzed: filesModified.length,
+                },
+                additionalContext: {
+                    query: plan.goal,
+                    codebaseId: codebaseInfo?.codebaseId,
+                    qualityScore,
+                    testResults: testResult.testResults,
+                },
+            }).catch(error => {
+                // Non-blocking
+                console.warn('[ValidationAgent] Validation recording failed (non-critical):', error);
+                return null;
+            });
+            return {
+                success,
+                testsPassed: testResult.testsPassed,
+                compilationSuccess: compilationResult.success,
+                testResults: testResult.testResults,
+                compilationErrors: compilationResult.errors,
+                recommendations,
+                qualityScore,
+                ...(validationResult ? {
+                    validationSummary: validationResult.summary,
+                    feedbackId: validationResult.feedbackId || undefined,
+                    runId: validationResult.runId || undefined,
+                } : {}),
+            };
+        }
+        catch (error) {
+            // Record failure
+            await agentValidationHelper.completeAgentOperation(validationContext, null, {
+                outcome: 'failure',
+                errors: [error instanceof Error ? error.message : String(error)],
+                additionalContext: {
+                    query: plan.goal,
+                    codebaseId: codebaseInfo?.codebaseId,
+                },
+            }).catch(() => {
+                // Non-blocking
+            });
+            throw error;
+        }
+    }
+    /**
+     * Check compilation for modified files
+     */
+    async checkCompilation(filesModified) {
+        if (!this.verificationService || filesModified.length === 0) {
+            return { success: true, errors: [] };
+        }
+        const errors = [];
+        for (const filepath of filesModified) {
+            try {
+                // Use verification service verify method (includes compilation check)
+                const result = await this.verificationService.verify(filepath);
+                if (!result.compiled || !result.success) {
+                    errors.push(...(result.errors || []));
+                }
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error.message : String(error));
+            }
+        }
+        return {
+            success: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Run test suite
+     */
+    async runTests() {
+        try {
+            // Detect test framework
+            const packageJsonPath = 'package.json';
+            if (!existsSync(packageJsonPath)) {
+                return { testsPassed: true }; // No tests to run
+            }
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            const testScript = packageJson.scripts?.test;
+            if (!testScript) {
+                return { testsPassed: true }; // No test script
+            }
+            // Run tests (with timeout)
+            const { stdout, stderr } = await Promise.race([
+                execAsync(testScript, { timeout: 60000 }),
+                new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error('Test timeout')), 60000);
+                }),
+            ]);
+            // Parse test results (simplified - would need framework-specific parsing)
+            const passed = (stdout.match(/✓|passed|PASS/g) || []).length;
+            const failed = (stdout.match(/✗|failed|FAIL/g) || []).length;
+            const total = passed + failed;
+            return {
+                testsPassed: failed === 0,
+                testResults: {
+                    passed,
+                    failed,
+                    total,
+                    failures: [], // Would parse from output
+                },
+            };
+        }
+        catch (error) {
+            // Test execution failed
+            return {
+                testsPassed: false,
+                testResults: {
+                    passed: 0,
+                    failed: 0,
+                    total: 0,
+                    failures: [
+                        {
+                            test: 'Test suite execution',
+                            error: error instanceof Error ? error.message : String(error),
+                        },
+                    ],
+                },
+            };
+        }
+    }
+    /**
+     * Analyze code quality
+     */
+    async analyzeQuality(plan, executionResults) {
+        const successful = executionResults.filter(r => r.success).length;
+        const total = executionResults.length;
+        const successRate = total > 0 ? successful / total : 1.0;
+        const durations = executionResults.map(r => r.duration);
+        const averageDuration = durations.length > 0
+            ? durations.reduce((a, b) => a + b, 0) / durations.length
+            : 0;
+        const errors = executionResults.filter(r => !r.success).length;
+        const errorRate = total > 0 ? errors / total : 0;
+        return {
+            successRate,
+            averageDuration,
+            errorRate,
+        };
+    }
+    /**
+     * Generate recommendations based on validation results
+     */
+    async generateRecommendations(compilationResult, testResult, qualityAnalysis) {
+        const recommendations = [];
+        if (!compilationResult.success) {
+            recommendations.push(`Fix compilation errors: ${compilationResult.errors.slice(0, 3).join(', ')}`);
+        }
+        if (!testResult.testsPassed) {
+            recommendations.push('Review and fix failing tests');
+        }
+        if (qualityAnalysis.errorRate > 0.3) {
+            recommendations.push('High error rate detected - review execution strategy');
+        }
+        if (qualityAnalysis.averageDuration > 10000) {
+            recommendations.push('Execution duration is high - consider optimization');
+        }
+        if (recommendations.length === 0) {
+            recommendations.push('All validations passed - code quality is good');
+        }
+        return recommendations;
+    }
+    /**
+     * Calculate overall quality score
+     */
+    calculateQualityScore(compilationResult, testResult, qualityAnalysis) {
+        let score = 100;
+        if (!compilationResult.success) {
+            score -= 30;
+        }
+        if (!testResult.testsPassed) {
+            score -= 30;
+        }
+        score -= qualityAnalysis.errorRate * 20;
+        score = Math.max(0, Math.min(100, score));
+        return Math.round(score);
+    }
+}
+//# sourceMappingURL=validation-agent.js.map

package/dist/application/agents/validation-agent.js.map

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

package/dist/application/architectures/plan-and-act.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Application: Plan-and-Act Architecture
+ * Separates strategic planning from tactical execution
+ *
+ * Based on research: Plan-and-Act: Improving Planning of Agents for Long-Horizon Tasks
+ * - Planner: High-accuracy reasoning (reserved for high-leverage tasks)
+ * - Executor: High-throughput, cost-efficient (for token-intensive execution)
+ * - Impact: 75% cost reduction, better accuracy for critical decisions
+ *
+ * Research findings:
+ * - GPT-5 highest accuracy config is 4x slower than GPT-4.1
+ * - Latency proportional to cost (reasoning tokens are expensive)
+ * - Strategic allocation maximizes throughput while controlling cost
+ */
+export interface Plan {
+    goal: string;
+    steps: PlanStep[];
+    context: Record<string, any>;
+    estimatedComplexity: 'low' | 'medium' | 'high';
+}
+export interface PlanStep {
+    id: string;
+    description: string;
+    action: string;
+    parameters: Record<string, any>;
+    dependencies?: string[];
+    estimatedCost: number;
+    requiresHighAccuracy: boolean;
+}
+export interface ExecutionResult {
+    stepId: string;
+    success: boolean;
+    output: any;
+    error?: string;
+    cost: number;
+    latency: number;
+}
+/**
+ * Planner Module
+ * Uses high-accuracy reasoning models for strategic planning
+ * Reserved for high-leverage tasks: strategizing, planning, ambiguity resolution
+ */
+export declare class PlannerModule {
+    private plannerAIService;
+    private context;
+    constructor(plannerAIService: any, // High-accuracy model (GPT-5, DeepSeek R1)
+    context?: any);
+    /**
+     * Generate strategic plan from goal
+     */
+    plan(goal: string, constraints?: Record<string, any>): Promise<Plan>;
+    /**
+     * Refine plan based on execution feedback
+     */
+    refinePlan(originalPlan: Plan, executionResults: ExecutionResult[]): Promise<Plan>;
+    private buildPlanningPrompt;
+    private buildRefinementPrompt;
+    private parsePlan;
+    private assessComplexity;
+}
+/**
+ * Executor Module
+ * Uses high-throughput, cost-efficient models for execution
+ * Handles token-intensive, low-leverage tasks
+ */
+export declare class ExecutorModule {
+    private executorAIService;
+    private toolExecutor;
+    constructor(executorAIService: any, // High-throughput model (GPT-4, optimized models)
+    toolExecutor: any);
+    /**
+     * Execute a single plan step
+     */
+    executeStep(step: PlanStep, context: Record<string, any>): Promise<ExecutionResult>;
+    /**
+     * Execute multiple steps in parallel (where possible)
+     */
+    executeSteps(steps: PlanStep[], context: Record<string, any>): Promise<ExecutionResult[]>;
+}
+/**
+ * Plan-and-Act Orchestrator
+ * Coordinates Planner and Executor modules
+ */
+export declare class PlanAndActOrchestrator {
+    private planner;
+    private executor;
+    private maxRefinements;
+    constructor(planner: PlannerModule, executor: ExecutorModule, maxRefinements?: number);
+    /**
+     * Execute goal using Plan-and-Act architecture
+     */
+    execute(goal: string, constraints?: Record<string, any>): Promise<any>;
+}
+//# sourceMappingURL=plan-and-act.d.ts.map

package/dist/application/architectures/plan-and-act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-and-act.d.ts","sourceRoot":"","sources":["../../../src/application/architectures/plan-and-act.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,OAAO;gBADP,gBAAgB,EAAE,GAAG,EAAE,2CAA2C;IAClE,OAAO,GAAE,GAAQ;IAG3B;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1E;;OAEG;IACG,UAAU,CACd,YAAY,EAAE,IAAI,EAClB,gBAAgB,EAAE,eAAe,EAAE,GAClC,OAAO,CAAC,IAAI,CAAC;IAehB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,gBAAgB;CAezB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,YAAY;gBADZ,iBAAiB,EAAE,GAAG,EAAE,kDAAkD;IAC1E,YAAY,EAAE,GAAG;IAG3B;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAoCzF;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC;CA4C9B;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,cAAc;gBAFd,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,EACxB,cAAc,GAAE,MAAU;IAGpC;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAyC7E"}

package/dist/application/architectures/plan-and-act.js

@@ -0,0 +1,242 @@
+/**
+ * Application: Plan-and-Act Architecture
+ * Separates strategic planning from tactical execution
+ *
+ * Based on research: Plan-and-Act: Improving Planning of Agents for Long-Horizon Tasks
+ * - Planner: High-accuracy reasoning (reserved for high-leverage tasks)
+ * - Executor: High-throughput, cost-efficient (for token-intensive execution)
+ * - Impact: 75% cost reduction, better accuracy for critical decisions
+ *
+ * Research findings:
+ * - GPT-5 highest accuracy config is 4x slower than GPT-4.1
+ * - Latency proportional to cost (reasoning tokens are expensive)
+ * - Strategic allocation maximizes throughput while controlling cost
+ */
+/**
+ * Planner Module
+ * Uses high-accuracy reasoning models for strategic planning
+ * Reserved for high-leverage tasks: strategizing, planning, ambiguity resolution
+ */
+export class PlannerModule {
+    plannerAIService;
+    context;
+    constructor(plannerAIService, // High-accuracy model (GPT-5, DeepSeek R1)
+    context = {}) {
+        this.plannerAIService = plannerAIService;
+        this.context = context;
+    }
+    /**
+     * Generate strategic plan from goal
+     */
+    async plan(goal, constraints) {
+        // Use high-accuracy model for planning
+        const planPrompt = this.buildPlanningPrompt(goal, constraints);
+        const response = await this.plannerAIService.chat(planPrompt, [], []);
+        const plan = this.parsePlan(response);
+        // Assess complexity and allocate resources
+        plan.estimatedComplexity = this.assessComplexity(plan);
+        return plan;
+    }
+    /**
+     * Refine plan based on execution feedback
+     */
+    async refinePlan(originalPlan, executionResults) {
+        // Analyze failures and update plan
+        const failures = executionResults.filter(r => !r.success);
+        if (failures.length === 0) {
+            return originalPlan; // Plan is working
+        }
+        // Use planner to adapt strategy
+        const refinementPrompt = this.buildRefinementPrompt(originalPlan, failures);
+        const refinedResponse = await this.plannerAIService.chat(refinementPrompt, [], []);
+        return this.parsePlan(refinedResponse);
+    }
+    buildPlanningPrompt(goal, constraints) {
+        return `You are a strategic planner. Create a detailed plan to achieve this goal:
+    
+Goal: ${goal}
+
+${constraints ? `Constraints: ${JSON.stringify(constraints)}` : ''}
+
+Provide a structured plan with:
+1. High-level strategy
+2. Sequential steps with dependencies
+3. Resource requirements
+4. Risk assessment
+
+Format as JSON with steps array.`;
+    }
+    buildRefinementPrompt(plan, failures) {
+        return `The following plan encountered failures. Refine the strategy:
+    
+Original Plan: ${JSON.stringify(plan)}
+Failures: ${JSON.stringify(failures)}
+
+Provide an improved plan that addresses these failures.`;
+    }
+    parsePlan(response) {
+        // Parse JSON plan from LLM response
+        try {
+            const parsed = JSON.parse(response);
+            return {
+                goal: parsed.goal || '',
+                steps: parsed.steps || [],
+                context: parsed.context || {},
+                estimatedComplexity: 'medium',
+            };
+        }
+        catch {
+            // Fallback: create simple plan
+            return {
+                goal: '',
+                steps: [],
+                context: {},
+                estimatedComplexity: 'medium',
+            };
+        }
+    }
+    assessComplexity(plan) {
+        const stepCount = plan.steps.length;
+        const dependencyCount = plan.steps.reduce((sum, step) => sum + (step.dependencies?.length || 0), 0);
+        if (stepCount > 10 || dependencyCount > 5) {
+            return 'high';
+        }
+        if (stepCount > 5 || dependencyCount > 2) {
+            return 'medium';
+        }
+        return 'low';
+    }
+}
+/**
+ * Executor Module
+ * Uses high-throughput, cost-efficient models for execution
+ * Handles token-intensive, low-leverage tasks
+ */
+export class ExecutorModule {
+    executorAIService;
+    toolExecutor;
+    constructor(executorAIService, // High-throughput model (GPT-4, optimized models)
+    toolExecutor) {
+        this.executorAIService = executorAIService;
+        this.toolExecutor = toolExecutor;
+    }
+    /**
+     * Execute a single plan step
+     */
+    async executeStep(step, context) {
+        const startTime = Date.now();
+        try {
+            // For high-accuracy steps, delegate back to planner
+            if (step.requiresHighAccuracy) {
+                // This shouldn't happen - executor only gets low-leverage steps
+                throw new Error('High-accuracy steps should use Planner, not Executor');
+            }
+            // Execute action using tools
+            const output = await this.toolExecutor.execute(step.action, step.parameters, context);
+            const latency = Date.now() - startTime;
+            return {
+                stepId: step.id,
+                success: true,
+                output,
+                cost: step.estimatedCost,
+                latency,
+            };
+        }
+        catch (error) {
+            const latency = Date.now() - startTime;
+            return {
+                stepId: step.id,
+                success: false,
+                output: null,
+                error: error instanceof Error ? error.message : String(error),
+                cost: step.estimatedCost,
+                latency,
+            };
+        }
+    }
+    /**
+     * Execute multiple steps in parallel (where possible)
+     */
+    async executeSteps(steps, context) {
+        // Identify parallelizable steps (no dependencies)
+        const independentSteps = steps.filter(step => !step.dependencies || step.dependencies.length === 0);
+        // Execute independent steps in parallel
+        const parallelResults = await Promise.all(independentSteps.map(step => this.executeStep(step, context)));
+        // Execute dependent steps sequentially
+        const dependentSteps = steps.filter(step => step.dependencies && step.dependencies.length > 0);
+        const sequentialResults = [];
+        for (const step of dependentSteps) {
+            // Wait for dependencies
+            const dependencyResults = sequentialResults.filter(r => step.dependencies.includes(r.stepId));
+            // Check if all dependencies succeeded
+            const allDependenciesSucceeded = dependencyResults.every(r => r.success);
+            if (!allDependenciesSucceeded) {
+                sequentialResults.push({
+                    stepId: step.id,
+                    success: false,
+                    output: null,
+                    error: 'Dependency failed',
+                    cost: step.estimatedCost,
+                    latency: 0,
+                });
+                continue;
+            }
+            // Execute step
+            const result = await this.executeStep(step, context);
+            sequentialResults.push(result);
+        }
+        return [...parallelResults, ...sequentialResults];
+    }
+}
+/**
+ * Plan-and-Act Orchestrator
+ * Coordinates Planner and Executor modules
+ */
+export class PlanAndActOrchestrator {
+    planner;
+    executor;
+    maxRefinements;
+    constructor(planner, executor, maxRefinements = 3) {
+        this.planner = planner;
+        this.executor = executor;
+        this.maxRefinements = maxRefinements;
+    }
+    /**
+     * Execute goal using Plan-and-Act architecture
+     */
+    async execute(goal, constraints) {
+        // 1. Plan: Use high-accuracy model for strategy
+        let plan = await this.planner.plan(goal, constraints);
+        // 2. Separate steps by leverage
+        const highLeverageSteps = plan.steps.filter(s => s.requiresHighAccuracy);
+        const lowLeverageSteps = plan.steps.filter(s => !s.requiresHighAccuracy);
+        // 3. Execute high-leverage steps with planner (if any)
+        // Note: In practice, high-leverage steps might need planner assistance
+        // For now, we assume all steps can be executed by executor
+        // 4. Execute low-leverage steps with executor (parallelized)
+        let executionResults = [];
+        let refinementCount = 0;
+        while (refinementCount < this.maxRefinements) {
+            // Execute all steps
+            const results = await this.executor.executeSteps(plan.steps, plan.context);
+            executionResults = results;
+            // Check if all succeeded
+            const allSucceeded = results.every(r => r.success);
+            if (allSucceeded) {
+                break;
+            }
+            // Refine plan based on failures
+            plan = await this.planner.refinePlan(plan, results);
+            refinementCount++;
+        }
+        // 5. Return final results
+        return {
+            plan,
+            results: executionResults,
+            success: executionResults.every(r => r.success),
+            totalCost: executionResults.reduce((sum, r) => sum + r.cost, 0),
+            totalLatency: executionResults.reduce((sum, r) => sum + r.latency, 0),
+        };
+    }
+}
+//# sourceMappingURL=plan-and-act.js.map