mcp-agent-foundry 1.0.0

package/dist/config/worktree-defaults.js

@@ -0,0 +1,78 @@
+/**
+ * Default Worktree Configuration
+ *
+ * Defines which roles need worktrees and default worktree settings.
+ */
+/**
+ * Roles that need isolated worktrees by default
+ */
+export const ROLES_NEEDING_WORKTREE = new Set([
+    'coder',
+    'implementer',
+    'developer',
+    'engineer',
+]);
+/**
+ * Check if a role needs a worktree
+ */
+export function roleNeedsWorktree(role, configOverride) {
+    // Config override takes precedence
+    if (configOverride !== undefined) {
+        return configOverride;
+    }
+    // Check default roles
+    return ROLES_NEEDING_WORKTREE.has(role.toLowerCase());
+}
+/**
+ * Default worktree configuration
+ */
+export const DEFAULT_WORKTREE_CONFIG = {
+    enabled: true,
+    baseDir: '.agent-foundry/worktrees',
+    limits: {
+        maxWorktrees: 10,
+        maxDiskBytes: 10 * 1024 * 1024 * 1024, // 10 GB
+    },
+    pool: {
+        enabled: false,
+        size: 3,
+    },
+    git: {
+        defaultBaseBranch: 'main',
+        branchPattern: 'task/{taskId}',
+        autoMerge: true,
+        conflictStrategy: 'merge',
+    },
+    cleanup: {
+        staleThresholdMs: 24 * 60 * 60 * 1000, // 24 hours
+        autoCleanup: true,
+    },
+};
+/**
+ * Merge user config with defaults
+ */
+export function mergeWorktreeConfig(userConfig) {
+    if (!userConfig)
+        return DEFAULT_WORKTREE_CONFIG;
+    return {
+        enabled: userConfig.enabled ?? DEFAULT_WORKTREE_CONFIG.enabled,
+        baseDir: userConfig.baseDir ?? DEFAULT_WORKTREE_CONFIG.baseDir,
+        limits: {
+            ...DEFAULT_WORKTREE_CONFIG.limits,
+            ...userConfig.limits,
+        },
+        pool: {
+            ...DEFAULT_WORKTREE_CONFIG.pool,
+            ...userConfig.pool,
+        },
+        git: {
+            ...DEFAULT_WORKTREE_CONFIG.git,
+            ...userConfig.git,
+        },
+        cleanup: {
+            ...DEFAULT_WORKTREE_CONFIG.cleanup,
+            ...userConfig.cleanup,
+        },
+    };
+}
+//# sourceMappingURL=worktree-defaults.js.map

package/dist/config/worktree-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-defaults.js","sourceRoot":"","sources":["../../src/config/worktree-defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAgB,IAAI,GAAG,CAAC;IACzD,OAAO;IACP,aAAa;IACb,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,cAAwB;IACtE,mCAAmC;IACnC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,sBAAsB;IACtB,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,0BAA0B;IACnC,MAAM,EAAE;QACN,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;KAChD;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC;KACR;IACD,GAAG,EAAE;QACH,iBAAiB,EAAE,MAAM;QACzB,aAAa,EAAE,eAAe;QAC9B,SAAS,EAAE,IAAI;QACf,gBAAgB,EAAE,OAAO;KAC1B;IACD,OAAO,EAAE;QACP,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;QAClD,WAAW,EAAE,IAAI;KAClB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAoC;IACtE,IAAI,CAAC,UAAU;QAAE,OAAO,uBAAuB,CAAC;IAEhD,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,uBAAuB,CAAC,OAAO;QAC9D,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,uBAAuB,CAAC,OAAO;QAC9D,MAAM,EAAE;YACN,GAAG,uBAAuB,CAAC,MAAM;YACjC,GAAG,UAAU,CAAC,MAAM;SACrB;QACD,IAAI,EAAE;YACJ,GAAG,uBAAuB,CAAC,IAAI;YAC/B,GAAG,UAAU,CAAC,IAAI;SACnB;QACD,GAAG,EAAE;YACH,GAAG,uBAAuB,CAAC,GAAG;YAC9B,GAAG,UAAU,CAAC,GAAG;SAClB;QACD,OAAO,EAAE;YACP,GAAG,uBAAuB,CAAC,OAAO;YAClC,GAAG,UAAU,CAAC,OAAO;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AgentRouter - MCP server for multi-agent orchestration
+ * Entry point
+ */
+export declare const VERSION = "3.0.2";
+export { initializeWithRecovery, shutdown } from "./startup.js";
+export type { StartupConfig, StartupResult } from "./startup.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * AgentRouter - MCP server for multi-agent orchestration
+ * Entry point
+ */
+import { createServer, startServer, shutdownServer } from "./server.js";
+export const VERSION = "3.0.2";
+// Re-export startup utilities for programmatic use
+export { initializeWithRecovery, shutdown } from "./startup.js";
+/**
+ * Main entry point - creates and starts the MCP server
+ */
+async function main() {
+    const server = await createServer();
+    await startServer(server);
+}
+// Graceful shutdown handling
+function setupShutdownHandlers() {
+    const handleShutdown = async (signal) => {
+        console.error(`\nReceived ${signal}, shutting down gracefully...`);
+        try {
+            await shutdownServer();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error("Error during shutdown:", message);
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", () => {
+        void handleShutdown("SIGINT");
+    });
+    process.on("SIGTERM", () => {
+        void handleShutdown("SIGTERM");
+    });
+}
+// Setup handlers before starting
+setupShutdownHandlers();
+// Start the server
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("Failed to start AgentRouter:", message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,mDAAmD;AACnD,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGhE;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IACpC,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,6BAA6B;AAC7B,SAAS,qBAAqB;IAC5B,MAAM,cAAc,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;QAC7D,OAAO,CAAC,KAAK,CAAC,cAAc,MAAM,+BAA+B,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,cAAc,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,cAAc,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,KAAK,cAAc,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iCAAiC;AACjC,qBAAqB,EAAE,CAAC;AAExB,mBAAmB;AACnB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/tools/compare-agents.d.ts

@@ -0,0 +1,25 @@
+/**
+ * compare_agents MCP Tool
+ *
+ * Runs the same task through multiple agents and compares their responses.
+ * Useful for getting different perspectives or finding the best approach.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../observability/logger.js";
+import type { RouterEngine } from "../../router/engine.js";
+/**
+ * Registers the compare_agents tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param router - RouterEngine for agent invocation
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '0.1.0' });
+ * const router = new RouterEngine(config, providers, logger);
+ * registerCompareAgentsTool(server, router, logger);
+ * ```
+ */
+export declare function registerCompareAgentsTool(server: McpServer, router: RouterEngine, logger: Logger): void;
+//# sourceMappingURL=compare-agents.d.ts.map

package/dist/mcp/tools/compare-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-agents.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/compare-agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAsG3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,CAkGN"}

package/dist/mcp/tools/compare-agents.js

@@ -0,0 +1,177 @@
+/**
+ * compare_agents MCP Tool
+ *
+ * Runs the same task through multiple agents and compares their responses.
+ * Useful for getting different perspectives or finding the best approach.
+ */
+import { z } from "zod";
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Tool description for compare_agents
+ */
+const TOOL_DESCRIPTION = "Run the same task through multiple agents and compare their responses. Useful for getting different perspectives from specialized agents (coder, critic, designer, researcher, reviewer).";
+// ============================================================================
+// Input Schema
+// ============================================================================
+/**
+ * Zod schema shape for compare_agents input validation.
+ * Uses raw shape format as expected by MCP SDK's registerTool.
+ */
+const compareAgentsInputSchemaShape = {
+    roles: z
+        .array(z.string())
+        .min(2)
+        .describe("List of agent roles to compare (minimum 2 required)"),
+    task: z.string().min(1).describe("The task to send to all agents"),
+};
+// ============================================================================
+// Response Formatter
+// ============================================================================
+/**
+ * Formats a single agent response for the comparison output
+ *
+ * @param response - The response from the agent invocation
+ * @returns Formatted string with header, metadata, and content
+ */
+function formatSingleAgentResponse(response) {
+    const header = `### ${response.role.toUpperCase()} Agent\n`;
+    const meta = `*Provider: ${response.provider} | Model: ${response.model} | Duration: ${String(response.metadata.durationMs)}ms*\n\n`;
+    const content = response.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text ?? "")
+        .join("\n");
+    return header + meta + content;
+}
+/**
+ * Formats the comparison results for MCP text output
+ *
+ * @param results - Map of role names to their responses
+ * @param failedRoles - Array of roles that failed to respond
+ * @param totalDurationMs - Total time taken for the comparison
+ * @returns Formatted string with all agent responses side by side
+ */
+function formatComparisonResponse(results, failedRoles, totalDurationMs) {
+    const sections = [];
+    // Header
+    sections.push("## Agent Comparison Results\n");
+    sections.push(`*Compared ${String(results.size)} agents | Total duration: ${String(totalDurationMs)}ms*\n`);
+    // Separator
+    sections.push("---\n");
+    // Individual agent responses
+    for (const [_role, response] of results) {
+        sections.push(formatSingleAgentResponse(response));
+        sections.push("\n---\n");
+    }
+    // Failed roles (if any)
+    if (failedRoles.length > 0) {
+        sections.push("### Failed Agents\n");
+        sections.push(`The following agents failed to respond: ${failedRoles.join(", ")}\n`);
+    }
+    return sections.join("\n");
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+/**
+ * Registers the compare_agents tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param router - RouterEngine for agent invocation
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '0.1.0' });
+ * const router = new RouterEngine(config, providers, logger);
+ * registerCompareAgentsTool(server, router, logger);
+ * ```
+ */
+export function registerCompareAgentsTool(server, router, logger) {
+    // Use type assertion to work around Zod version compatibility issues
+    // between zod 3.25+ and the MCP SDK's ZodRawShapeCompat type
+    /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    const inputSchema = compareAgentsInputSchemaShape;
+    server.registerTool("compare_agents", {
+        title: "Compare Agents",
+        description: TOOL_DESCRIPTION,
+        inputSchema,
+    }, 
+    /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    async (args) => {
+        // Type-safe access with explicit casting after validation
+        const { roles, task } = args;
+        logger.info("compare_agents called", {
+            roles,
+            roleCount: roles.length,
+            taskLength: task.length,
+        });
+        // Validate that all roles exist
+        const invalidRoles = roles.filter((role) => !router.hasRole(role));
+        if (invalidRoles.length > 0) {
+            const errorMessage = `Unknown roles: ${invalidRoles.join(", ")}. Available roles: ${router.listRoles().join(", ")}`;
+            logger.warn("compare_agents called with invalid roles", {
+                invalidRoles,
+                availableRoles: router.listRoles(),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Error Comparing Agents\n\n${errorMessage}`,
+                    },
+                ],
+            };
+        }
+        try {
+            const startTime = Date.now();
+            const results = await router.compareAgents(roles, task);
+            const durationMs = Date.now() - startTime;
+            // Determine which roles failed
+            const failedRoles = roles.filter((role) => !results.has(role));
+            logger.info("compare_agents completed", {
+                roles,
+                successfulRoles: Array.from(results.keys()),
+                failedRoles,
+                durationMs,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatComparisonResponse(results, failedRoles, durationMs),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Only pass error to logger if it's an Error instance
+            if (error instanceof Error) {
+                logger.error("compare_agents failed", {
+                    roles,
+                    error,
+                    errorMessage,
+                });
+            }
+            else {
+                logger.error("compare_agents failed", {
+                    roles,
+                    errorMessage,
+                });
+            }
+            // Return error as text content for MCP compatibility
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Error Comparing Agents\n\n${errorMessage}`,
+                    },
+                ],
+            };
+        }
+    });
+    logger.debug("Registered compare_agents tool");
+}
+//# sourceMappingURL=compare-agents.js.map

package/dist/mcp/tools/compare-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-agents.js","sourceRoot":"","sources":["../../../src/mcp/tools/compare-agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,MAAM,gBAAgB,GACpB,2LAA2L,CAAC;AAE9L,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,6BAA6B,GAAG;IACpC,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,qDAAqD,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACnE,CAAC;AAUF,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;GAKG;AACH,SAAS,yBAAyB,CAAC,QAAuB;IACxD,MAAM,MAAM,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IAC5D,MAAM,IAAI,GAAG,cAAc,QAAQ,CAAC,QAAQ,aAAa,QAAQ,CAAC,KAAK,gBAAgB,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;IAErI,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO;SAC7B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SACxC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;SAChC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,wBAAwB,CAC/B,OAAmC,EACnC,WAAqB,EACrB,eAAuB;IAEvB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,SAAS;IACT,QAAQ,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,CACX,aAAa,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,eAAe,CAAC,OAAO,CAC7F,CAAC;IAEF,YAAY;IACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvB,6BAA6B;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,wBAAwB;IACxB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,2CAA2C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,MAAoB,EACpB,MAAc;IAEd,qEAAqE;IACrE,6DAA6D;IAC7D,gGAAgG;IAChG,MAAM,WAAW,GAAQ,6BAA6B,CAAC;IAEvD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,gBAAgB;QAC7B,WAAW;KACZ;IACD,+FAA+F;IAC/F,KAAK,EAAE,IAAa,EAAE,EAAE;QACtB,0DAA0D;QAC1D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAA0B,CAAC;QAEnD,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACnC,KAAK;YACL,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,UAAU,EAAE,IAAI,CAAC,MAAM;SACxB,CAAC,CAAC;QAEH,gCAAgC;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,kBAAkB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAEpH,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;gBACtD,YAAY;gBACZ,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE;aACnC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gCAAgC,YAAY,EAAE;qBACrD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAE1C,+BAA+B;YAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAE/D,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBACtC,KAAK;gBACL,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC3C,WAAW;gBACX,UAAU;aACX,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,wBAAwB,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC;qBACjE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE5E,sDAAsD;YACtD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;oBACpC,KAAK;oBACL,KAAK;oBACL,YAAY;iBACb,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;oBACpC,KAAK;oBACL,YAAY;iBACb,CAAC,CAAC;YACL,CAAC;YAED,qDAAqD;YACrD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gCAAgC,YAAY,EAAE;qBACrD;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACjD,CAAC"}

package/dist/mcp/tools/critique-plan.d.ts

@@ -0,0 +1,26 @@
+/**
+ * critique_plan MCP Tool
+ *
+ * Convenience tool for getting critical review of a plan, PRD, or technical
+ * design from a skeptical architect. This is a shorthand for invoking the
+ * critic agent with a structured task.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../observability/logger.js";
+import type { RouterEngine } from "../../router/engine.js";
+/**
+ * Registers the critique_plan tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param router - RouterEngine for agent invocation
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '0.1.0' });
+ * const router = new RouterEngine(config, providers, logger);
+ * registerCritiquePlanTool(server, router, logger);
+ * ```
+ */
+export declare function registerCritiquePlanTool(server: McpServer, router: RouterEngine, logger: Logger): void;
+//# sourceMappingURL=critique-plan.d.ts.map

package/dist/mcp/tools/critique-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critique-plan.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/critique-plan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA+F3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,CAkFN"}

package/dist/mcp/tools/critique-plan.js

@@ -0,0 +1,162 @@
+/**
+ * critique_plan MCP Tool
+ *
+ * Convenience tool for getting critical review of a plan, PRD, or technical
+ * design from a skeptical architect. This is a shorthand for invoking the
+ * critic agent with a structured task.
+ */
+import { z } from "zod";
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Tool description for critique_plan
+ */
+const TOOL_DESCRIPTION = "Get critical review of a plan, PRD, or technical design from a skeptical architect. " +
+    "The critic will challenge assumptions, identify risks, and suggest improvements.";
+// ============================================================================
+// Input Schema
+// ============================================================================
+/**
+ * Zod schema shape for critique_plan input validation.
+ * Uses raw shape format as expected by MCP SDK's registerTool.
+ */
+const critiquePlanInputSchemaShape = {
+    plan: z
+        .string()
+        .min(1)
+        .describe("The plan, PRD, or technical design document to critique"),
+    focus: z
+        .string()
+        .optional()
+        .describe("Optional focus areas for the critique (e.g., 'security', 'scalability', 'cost', 'maintainability')"),
+};
+// ============================================================================
+// Response Formatter
+// ============================================================================
+/**
+ * Formats an AgentResponse for MCP text output
+ *
+ * @param response - The response from the agent invocation
+ * @returns Formatted string with header, metadata, and critique content
+ */
+function formatCritiqueResponse(response) {
+    const header = `## Plan Critique (CRITIC Agent)\n`;
+    const meta = `*Provider: ${response.provider} | Model: ${response.model} | Duration: ${String(response.metadata.durationMs)}ms*\n\n`;
+    const content = response.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text ?? "")
+        .join("\n");
+    return header + meta + content;
+}
+/**
+ * Builds the task string for the critic agent
+ *
+ * @param plan - The plan document to critique
+ * @param focus - Optional focus areas
+ * @returns Formatted task string
+ */
+function buildCritiqueTask(plan, focus) {
+    let task = `Please provide a critical review of the following plan or technical design.\n\n`;
+    if (focus !== undefined && focus !== "") {
+        task += `Focus particularly on: ${focus}\n\n`;
+    }
+    task += `Analyze for:\n`;
+    task += `- Hidden assumptions and unstated dependencies\n`;
+    task += `- Potential risks and failure modes\n`;
+    task += `- Scalability and performance concerns\n`;
+    task += `- Security vulnerabilities\n`;
+    task += `- Missing requirements or edge cases\n`;
+    task += `- Alternative approaches worth considering\n\n`;
+    task += `<plan>\n${plan}\n</plan>`;
+    return task;
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+/**
+ * Registers the critique_plan tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param router - RouterEngine for agent invocation
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '0.1.0' });
+ * const router = new RouterEngine(config, providers, logger);
+ * registerCritiquePlanTool(server, router, logger);
+ * ```
+ */
+export function registerCritiquePlanTool(server, router, logger) {
+    // Use type assertion to work around Zod version compatibility issues
+    // between zod 3.25+ and the MCP SDK's ZodRawShapeCompat type
+    /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    const inputSchema = critiquePlanInputSchemaShape;
+    server.registerTool("critique_plan", {
+        title: "Critique Plan",
+        description: TOOL_DESCRIPTION,
+        inputSchema,
+    }, 
+    /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    async (args) => {
+        // Type-safe access with explicit casting after validation
+        const { plan, focus } = args;
+        logger.info("critique_plan called", {
+            planLength: plan.length,
+            hasFocus: focus !== undefined,
+            focus: focus,
+        });
+        try {
+            const startTime = Date.now();
+            // Build the task string with optional focus areas
+            const task = buildCritiqueTask(plan, focus);
+            // Invoke the critic agent
+            const response = await router.invokeAgent({
+                role: "critic",
+                task,
+            });
+            const durationMs = Date.now() - startTime;
+            logger.info("critique_plan completed", {
+                provider: response.provider,
+                model: response.model,
+                durationMs,
+                traceId: response.metadata.traceId,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatCritiqueResponse(response),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Only pass error to logger if it's an Error instance
+            if (error instanceof Error) {
+                logger.error("critique_plan failed", {
+                    error,
+                    errorMessage,
+                });
+            }
+            else {
+                logger.error("critique_plan failed", {
+                    errorMessage,
+                });
+            }
+            // Return error as text content for MCP compatibility
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Error Critiquing Plan\n\n${errorMessage}`,
+                    },
+                ],
+            };
+        }
+    });
+    logger.debug("Registered critique_plan tool");
+}
+//# sourceMappingURL=critique-plan.js.map

package/dist/mcp/tools/critique-plan.js.map

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

package/dist/mcp/tools/design-feedback.d.ts

@@ -0,0 +1,26 @@
+/**
+ * design_feedback MCP Tool
+ *
+ * Convenience tool for getting UI/UX design feedback on components,
+ * layouts, or user flows. This is a shorthand for invoking the
+ * designer role with a structured design review task.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../observability/logger.js";
+import type { RouterEngine } from "../../router/engine.js";
+/**
+ * Registers the design_feedback tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param router - RouterEngine for agent invocation
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '0.1.0' });
+ * const router = new RouterEngine(config, providers, logger);
+ * registerDesignFeedbackTool(server, router, logger);
+ * ```
+ */
+export declare function registerDesignFeedbackTool(server: McpServer, router: RouterEngine, logger: Logger): void;
+//# sourceMappingURL=design-feedback.d.ts.map

package/dist/mcp/tools/design-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-feedback.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/design-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA6I3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,CA+FN"}