mcp-agent-foundry 1.0.0

package/dist/router/pattern-executor.js

@@ -0,0 +1,571 @@
+/**
+ * Pattern Executor
+ *
+ * Orchestrates multi-agent workflows using various execution patterns.
+ * Provides high-level patterns for agent collaboration including:
+ * - Sequential pipelines (A → B → C)
+ * - Parallel comparison (same task to multiple agents)
+ * - Generator-Critic loops (generate → critique → improve)
+ * - Consensus building (propose → vote → synthesize)
+ *
+ * Each pattern leverages the RouterEngine for individual agent invocations
+ * while managing the overall workflow state and data flow between agents.
+ */
+import { generateTraceId } from '../observability/logger.js';
+// ============================================================================
+// Default Templates
+// ============================================================================
+const DEFAULT_CRITIQUE_TEMPLATE = `Please critique the following and identify any issues, improvements, or concerns:
+
+{{content}}
+
+Provide specific, actionable feedback. If the work is satisfactory with no major issues, say "approved" or "looks good".`;
+const DEFAULT_IMPROVEMENT_TEMPLATE = `Based on this feedback:
+
+{{critique}}
+
+Please improve your previous response:
+
+{{original}}`;
+const DEFAULT_VOTE_TEMPLATE = `Given these proposals:
+
+{{proposals}}
+
+Which approach do you think is best and why? You may also suggest combining elements from different proposals.`;
+const DEFAULT_SYNTHESIS_TEMPLATE = `Based on the following proposals and assessments, synthesize a final recommendation:
+
+## Proposals
+{{proposals}}
+
+## Assessments
+{{votes}}
+
+Provide a comprehensive final recommendation that incorporates the best ideas.`;
+// ============================================================================
+// Satisfaction Detection
+// ============================================================================
+/**
+ * Default list of indicators that suggest the critic is satisfied.
+ */
+const SATISFACTION_INDICATORS = [
+    'looks good',
+    'looks great',
+    'well done',
+    'no major issues',
+    'no significant issues',
+    'no critical issues',
+    'satisfied',
+    'approved',
+    'no changes needed',
+    'ready for',
+    'excellent work',
+    'solid implementation',
+    'meets requirements',
+    'lgtm',
+    'ship it',
+];
+/**
+ * Default function to detect if a critique indicates approval.
+ */
+function defaultIsApproved(critique) {
+    const lower = critique.toLowerCase();
+    return SATISFACTION_INDICATORS.some((indicator) => lower.includes(indicator));
+}
+// ============================================================================
+// PatternExecutor Class
+// ============================================================================
+/**
+ * Orchestrates multi-agent workflows using various execution patterns.
+ *
+ * @example
+ * ```typescript
+ * const executor = new PatternExecutor(routerEngine, logger);
+ *
+ * // Sequential pipeline
+ * const result = await executor.executeSequential([
+ *   { role: 'coder', taskTemplate: 'Implement: {{input}}' },
+ *   { role: 'reviewer', taskTemplate: 'Review this code: {{previousOutput}}' },
+ * ], 'Create a sorting function');
+ *
+ * // Parallel comparison
+ * const comparison = await executor.executeParallel(
+ *   ['coder', 'researcher'],
+ *   'What are the best practices for error handling?'
+ * );
+ *
+ * // Critic loop
+ * const improved = await executor.executeCriticLoop(
+ *   'coder',
+ *   'critic',
+ *   'Write a REST API endpoint',
+ *   { maxIterations: 3 }
+ * );
+ * ```
+ */
+export class PatternExecutor {
+    router;
+    logger;
+    constructor(router, logger) {
+        this.router = router;
+        this.logger = logger;
+    }
+    // ==========================================================================
+    // Sequential Pipeline
+    // ==========================================================================
+    /**
+     * Execute a sequential pipeline of agents.
+     *
+     * Each agent's output becomes input to the next. Task templates can use
+     * placeholders:
+     * - `{{input}}` - The original input or previous step's output
+     * - `{{previousOutput}}` - Alias for input from previous step
+     *
+     * @param steps - Array of step definitions with roles and task templates
+     * @param initialInput - Initial input to the first step
+     * @returns Promise resolving to SequentialResult with all step outputs
+     *
+     * @example
+     * ```typescript
+     * const result = await executor.executeSequential([
+     *   { role: 'coder', taskTemplate: '{{input}}' },
+     *   { role: 'reviewer', taskTemplate: 'Review: {{previousOutput}}' },
+     *   { role: 'coder', taskTemplate: 'Fix issues: {{previousOutput}}' },
+     * ], 'Write a function to validate email addresses');
+     * ```
+     */
+    async executeSequential(steps, initialInput) {
+        const startTime = Date.now();
+        const traceId = generateTraceId();
+        this.logger.info('Starting sequential pipeline', {
+            traceId,
+            stepCount: steps.length,
+            roles: steps.map((s) => s.role),
+            inputPreview: this.truncate(initialInput, 100),
+        });
+        const results = [];
+        let currentInput = initialInput;
+        for (const [i, step] of steps.entries()) {
+            const stepNumber = i + 1;
+            this.logger.debug('Executing sequential step', {
+                traceId,
+                step: stepNumber,
+                role: step.role,
+            });
+            // Apply transform if provided
+            const transformedInput = step.transform
+                ? step.transform(currentInput)
+                : currentInput;
+            // Build task from template
+            const task = this.interpolateTemplate(step.taskTemplate, {
+                input: transformedInput,
+                previousOutput: transformedInput,
+            });
+            // Invoke the agent
+            const response = await this.router.invokeAgent({
+                role: step.role,
+                task,
+            });
+            results.push(response);
+            // Extract text content for next step
+            currentInput = this.extractText(response);
+            this.logger.debug('Sequential step completed', {
+                traceId,
+                step: stepNumber,
+                role: step.role,
+                outputPreview: this.truncate(currentInput, 100),
+            });
+        }
+        const totalDurationMs = Date.now() - startTime;
+        this.logger.info('Sequential pipeline completed', {
+            traceId,
+            stepCount: steps.length,
+            totalDurationMs,
+            outputPreview: this.truncate(currentInput, 100),
+        });
+        return {
+            pattern: 'sequential',
+            steps: results,
+            finalOutput: currentInput,
+            totalDurationMs,
+            traceId,
+        };
+    }
+    // ==========================================================================
+    // Parallel Comparison
+    // ==========================================================================
+    /**
+     * Execute the same task through multiple agents in parallel.
+     *
+     * All agents receive the same task and run concurrently. Results are
+     * collected for comparison. Errors for individual agents don't fail
+     * the entire operation.
+     *
+     * @param roles - Array of role names to invoke
+     * @param task - The task to send to all agents
+     * @returns Promise resolving to ParallelResult with all agent responses
+     *
+     * @example
+     * ```typescript
+     * const result = await executor.executeParallel(
+     *   ['coder', 'researcher', 'critic'],
+     *   'What is the best approach to implement caching?'
+     * );
+     *
+     * for (const [role, response] of result.responses) {
+     *   console.log(`${role}: ${extractText(response)}`);
+     * }
+     * ```
+     */
+    async executeParallel(roles, task) {
+        const startTime = Date.now();
+        const traceId = generateTraceId();
+        this.logger.info('Starting parallel comparison', {
+            traceId,
+            roles,
+            taskPreview: this.truncate(task, 100),
+        });
+        const responses = new Map();
+        const errors = new Map();
+        // Execute all agents in parallel
+        const promises = roles.map(async (role) => {
+            try {
+                const response = await this.router.invokeAgent({ role, task });
+                return { role, status: 'fulfilled', response };
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                return { role, status: 'rejected', error: err };
+            }
+        });
+        const results = await Promise.allSettled(promises);
+        // Process results
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                const { role, status, response, error } = result.value;
+                if (status === 'fulfilled') {
+                    responses.set(role, response);
+                }
+                else {
+                    errors.set(role, error);
+                    this.logger.error('Parallel agent failed', {
+                        traceId,
+                        role,
+                        errorMessage: error.message,
+                    });
+                }
+            }
+            else {
+                // This shouldn't happen since we catch errors in the promise
+                this.logger.error('Unexpected error in parallel execution', {
+                    traceId,
+                    reason: result.reason,
+                });
+            }
+        }
+        const totalDurationMs = Date.now() - startTime;
+        this.logger.info('Parallel comparison completed', {
+            traceId,
+            totalRoles: roles.length,
+            successfulRoles: responses.size,
+            failedRoles: errors.size,
+            totalDurationMs,
+        });
+        return {
+            pattern: 'parallel',
+            responses,
+            errors,
+            totalDurationMs,
+            traceId,
+        };
+    }
+    // ==========================================================================
+    // Generator-Critic Loop
+    // ==========================================================================
+    /**
+     * Execute a generator-critic improvement loop.
+     *
+     * The generator creates an initial response, then the critic reviews it.
+     * If the critic identifies issues, the generator improves based on feedback.
+     * This continues until the critic approves or max iterations is reached.
+     *
+     * @param generatorRole - Role for generating content
+     * @param criticRole - Role for critiquing content
+     * @param task - Initial task for the generator
+     * @param options - Optional configuration for the loop
+     * @returns Promise resolving to CriticLoopResult with iteration history
+     *
+     * @example
+     * ```typescript
+     * const result = await executor.executeCriticLoop(
+     *   'coder',
+     *   'critic',
+     *   'Write a function to parse JSON with error handling',
+     *   { maxIterations: 3 }
+     * );
+     *
+     * if (result.approved) {
+     *   console.log('Critic approved the final version');
+     * }
+     * console.log(`Completed in ${result.iterations} iterations`);
+     * ```
+     */
+    async executeCriticLoop(generatorRole, criticRole, task, options = {}) {
+        const startTime = Date.now();
+        const traceId = generateTraceId();
+        const maxIterations = options.maxIterations ?? 3;
+        const isApprovedFn = options.isApproved ?? defaultIsApproved;
+        const critiqueTemplate = options.critiqueTaskTemplate ?? DEFAULT_CRITIQUE_TEMPLATE;
+        const improvementTemplate = options.improvementTaskTemplate ?? DEFAULT_IMPROVEMENT_TEMPLATE;
+        this.logger.info('Starting critic loop', {
+            traceId,
+            generatorRole,
+            criticRole,
+            maxIterations,
+            taskPreview: this.truncate(task, 100),
+        });
+        const history = [];
+        let currentTask = task;
+        let approved = false;
+        let finalResponse;
+        for (let i = 0; i < maxIterations; i++) {
+            const iteration = i + 1;
+            this.logger.debug('Critic loop iteration starting', {
+                traceId,
+                iteration,
+                maxIterations,
+            });
+            // Generate
+            const generation = await this.router.invokeAgent({
+                role: generatorRole,
+                task: currentTask,
+            });
+            const generatedContent = this.extractText(generation);
+            finalResponse = generation;
+            // Critique
+            const critiqueTask = this.interpolateTemplate(critiqueTemplate, {
+                content: generatedContent,
+            });
+            const critique = await this.router.invokeAgent({
+                role: criticRole,
+                task: critiqueTask,
+            });
+            const critiqueContent = this.extractText(critique);
+            approved = isApprovedFn(critiqueContent);
+            history.push({
+                iteration,
+                generation,
+                critique,
+                approved,
+            });
+            this.logger.debug('Critic loop iteration completed', {
+                traceId,
+                iteration,
+                approved,
+                critiquePreview: this.truncate(critiqueContent, 100),
+            });
+            // Stop if approved
+            if (approved) {
+                this.logger.info('Critic loop: approval received', {
+                    traceId,
+                    iteration,
+                });
+                break;
+            }
+            // Prepare improvement task for next iteration
+            if (i < maxIterations - 1) {
+                currentTask = this.interpolateTemplate(improvementTemplate, {
+                    critique: critiqueContent,
+                    original: generatedContent,
+                });
+            }
+        }
+        const totalDurationMs = Date.now() - startTime;
+        this.logger.info('Critic loop completed', {
+            traceId,
+            iterations: history.length,
+            approved,
+            totalDurationMs,
+        });
+        // This should never be undefined, but TypeScript needs the check
+        if (!finalResponse) {
+            throw new Error('No generation was produced in critic loop');
+        }
+        return {
+            pattern: 'critic-loop',
+            iterations: history.length,
+            finalResponse,
+            history,
+            approved,
+            finalOutput: this.extractText(finalResponse),
+            totalDurationMs,
+            traceId,
+        };
+    }
+    // ==========================================================================
+    // Consensus Building
+    // ==========================================================================
+    /**
+     * Execute a consensus building workflow.
+     *
+     * Three phases:
+     * 1. Proposals: All roles respond to the initial question
+     * 2. Voting: Each role evaluates all proposals
+     * 3. Synthesis: A designated role synthesizes a final recommendation
+     *
+     * @param roles - Array of role names to participate
+     * @param question - The question or decision to reach consensus on
+     * @param options - Optional configuration for the workflow
+     * @returns Promise resolving to ConsensusResult with all phases
+     *
+     * @example
+     * ```typescript
+     * const result = await executor.executeConsensus(
+     *   ['coder', 'critic', 'designer'],
+     *   'What is the best architecture for a real-time chat application?',
+     *   { synthesizeRole: 'coder' }
+     * );
+     *
+     * console.log('Final recommendation:', result.finalOutput);
+     * ```
+     */
+    async executeConsensus(roles, question, options = {}) {
+        const startTime = Date.now();
+        const traceId = generateTraceId();
+        const firstRole = roles[0];
+        if (firstRole === undefined || firstRole === '') {
+            throw new Error('Cannot execute consensus with empty roles array');
+        }
+        const synthesizeRole = options.synthesizeRole ?? firstRole;
+        const voteTemplate = options.voteTaskTemplate ?? DEFAULT_VOTE_TEMPLATE;
+        const synthesisTemplate = options.synthesisTaskTemplate ?? DEFAULT_SYNTHESIS_TEMPLATE;
+        this.logger.info('Starting consensus building', {
+            traceId,
+            roles,
+            synthesizeRole,
+            questionPreview: this.truncate(question, 100),
+        });
+        // Phase 1: Collect proposals
+        this.logger.debug('Consensus phase 1: Collecting proposals', { traceId });
+        const proposalsResult = await this.executeParallel(roles, question);
+        // Phase 2: Have each agent vote/comment on others' proposals
+        this.logger.debug('Consensus phase 2: Voting on proposals', { traceId });
+        const proposalText = this.formatProposals(proposalsResult.responses);
+        const voteTask = this.interpolateTemplate(voteTemplate, {
+            proposals: proposalText,
+        });
+        const votesResult = await this.executeParallel(roles, voteTask);
+        // Phase 3: Synthesize
+        this.logger.debug('Consensus phase 3: Synthesizing final recommendation', {
+            traceId,
+        });
+        const votesText = this.formatVotes(votesResult.responses);
+        const synthesisTask = this.interpolateTemplate(synthesisTemplate, {
+            proposals: proposalText,
+            votes: votesText,
+        });
+        const synthesis = await this.router.invokeAgent({
+            role: synthesizeRole,
+            task: synthesisTask,
+        });
+        const totalDurationMs = Date.now() - startTime;
+        this.logger.info('Consensus building completed', {
+            traceId,
+            proposalCount: proposalsResult.responses.size,
+            voteCount: votesResult.responses.size,
+            totalDurationMs,
+        });
+        return {
+            pattern: 'consensus',
+            proposals: proposalsResult.responses,
+            votes: votesResult.responses,
+            synthesis,
+            finalOutput: this.extractText(synthesis),
+            totalDurationMs,
+            traceId,
+        };
+    }
+    // ==========================================================================
+    // Utility Methods
+    // ==========================================================================
+    /**
+     * Extract text content from an agent response.
+     *
+     * @param response - Agent response to extract text from
+     * @returns Concatenated text content from all text blocks
+     */
+    extractText(response) {
+        return response.content
+            .filter((block) => block.type === 'text' && typeof block.text === 'string')
+            .map((block) => block.text)
+            .join('\n');
+    }
+    /**
+     * Interpolate a template string with variable values.
+     *
+     * @param template - Template string with {{variable}} placeholders
+     * @param variables - Object mapping variable names to values
+     * @returns Interpolated string
+     */
+    interpolateTemplate(template, variables) {
+        let result = template;
+        for (const [key, value] of Object.entries(variables)) {
+            result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+        }
+        return result;
+    }
+    /**
+     * Format proposals for display in templates.
+     *
+     * @param proposals - Map of role names to responses
+     * @returns Formatted string with numbered proposals
+     */
+    formatProposals(proposals) {
+        let index = 1;
+        const parts = [];
+        for (const [role, response] of proposals) {
+            parts.push(`## Proposal ${String(index)} (${role})\n${this.extractText(response)}`);
+            index++;
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * Format votes/assessments for display in templates.
+     *
+     * @param votes - Map of role names to vote responses
+     * @returns Formatted string with role assessments
+     */
+    formatVotes(votes) {
+        const parts = [];
+        for (const [role, response] of votes) {
+            parts.push(`### ${role}'s assessment:\n${this.extractText(response)}`);
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * Truncate a string to a maximum length.
+     *
+     * @param str - String to truncate
+     * @param maxLength - Maximum length before truncation
+     * @returns Truncated string with ellipsis if needed
+     */
+    truncate(str, maxLength) {
+        if (str.length <= maxLength) {
+            return str;
+        }
+        return str.substring(0, maxLength) + '...';
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a PatternExecutor instance.
+ *
+ * @param router - RouterEngine for agent invocations
+ * @param logger - Logger for observability
+ * @returns Configured PatternExecutor instance
+ */
+export function createPatternExecutor(router, logger) {
+    return new PatternExecutor(router, logger);
+}
+//# sourceMappingURL=pattern-executor.js.map

package/dist/router/pattern-executor.js.map

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

package/dist/router/role-resolver.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Role Resolver
+ *
+ * Maps role names to their configured agent settings by merging
+ * role-specific configuration with default values.
+ */
+import type { AgentConfig, Config } from '../types.js';
+/**
+ * RoleResolver maps role names to fully resolved AgentConfig objects.
+ *
+ * It handles:
+ * - Looking up role configurations by name
+ * - Merging role-specific overrides with defaults
+ * - Providing helpful error messages for unknown roles
+ * - Hot reload support via updateConfig()
+ */
+export declare class RoleResolver {
+    private roles;
+    private defaults;
+    /**
+     * Create a new RoleResolver with the given configuration.
+     *
+     * @param config - The full AgentRouter configuration
+     */
+    constructor(config: Config);
+    /**
+     * Resolve a role name to its full agent configuration.
+     *
+     * Merges the role's specific settings with default values, where
+     * role-specific values take precedence over defaults.
+     *
+     * @param role - The role name to resolve (e.g., "coder", "critic")
+     * @returns The fully resolved AgentConfig
+     * @throws Error if the role is not found in configuration
+     */
+    resolve(role: string): AgentConfig;
+    /**
+     * Check if a role exists in the configuration.
+     *
+     * @param role - The role name to check
+     * @returns true if the role exists, false otherwise
+     */
+    hasRole(role: string): boolean;
+    /**
+     * Get a list of all configured role names.
+     *
+     * @returns Array of role names
+     */
+    listRoles(): string[];
+    /**
+     * Update the resolver with a new configuration.
+     *
+     * Used for hot reload when the config file changes.
+     *
+     * @param config - The new configuration to use
+     */
+    updateConfig(config: Config): void;
+}
+//# sourceMappingURL=role-resolver.d.ts.map

package/dist/router/role-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-resolver.d.ts","sourceRoot":"","sources":["../../src/router/role-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,EAAiB,MAAM,aAAa,CAAC;AAElF;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAgB;IAEhC;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAK1B;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAmClC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAInC"}