mcp-agent-foundry 1.0.0

package/dist/mcp/tools/review-code.d.ts

@@ -0,0 +1,25 @@
+/**
+ * review_code MCP Tool
+ *
+ * Convenience tool for getting code review feedback.
+ * This is a shorthand for invoking the 'reviewer' role with code-specific formatting.
+ */
+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 review_code 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);
+ * registerReviewCodeTool(server, router, logger);
+ * ```
+ */
+export declare function registerReviewCodeTool(server: McpServer, router: RouterEngine, logger: Logger): void;
+//# sourceMappingURL=review-code.d.ts.map

package/dist/mcp/tools/review-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-code.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/review-code.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;AA4G3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,CAkFN"}

package/dist/mcp/tools/review-code.js

@@ -0,0 +1,170 @@
+/**
+ * review_code MCP Tool
+ *
+ * Convenience tool for getting code review feedback.
+ * This is a shorthand for invoking the 'reviewer' role with code-specific formatting.
+ */
+import { z } from "zod";
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Tool description for review_code
+ */
+const TOOL_DESCRIPTION = "Get code review feedback on code snippets or files. " +
+    "Analyzes code for quality, security, performance, and best practices.";
+// ============================================================================
+// Input Schema
+// ============================================================================
+/**
+ * Zod schema shape for review_code input validation.
+ * Uses raw shape format as expected by MCP SDK's registerTool.
+ */
+const reviewCodeInputSchemaShape = {
+    code: z.string().min(1).describe("The code to review"),
+    language: z
+        .string()
+        .optional()
+        .describe("Programming language (optional, will be auto-detected if not provided)"),
+    context: z
+        .string()
+        .optional()
+        .describe("Additional context about the code (optional) - e.g., purpose, constraints, or areas of concern"),
+};
+// ============================================================================
+// Response Formatter
+// ============================================================================
+/**
+ * Formats an AgentResponse for MCP text output
+ *
+ * @param response - The response from the agent invocation
+ * @returns Formatted string with header, metadata, and content
+ */
+function formatCodeReviewResponse(response) {
+    const header = `## Code Review Feedback\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;
+}
+// ============================================================================
+// Task Builder
+// ============================================================================
+/**
+ * Builds the task string for the reviewer agent.
+ *
+ * @param input - The validated input parameters
+ * @returns Formatted task string with code block and context
+ */
+function buildReviewTask(input) {
+    const parts = [];
+    // Add review instruction
+    parts.push("Please review the following code for quality, security, performance, and best practices.");
+    // Add context if provided
+    if (input.context !== undefined && input.context !== "") {
+        parts.push(`\n**Context:** ${input.context}`);
+    }
+    // Add language hint if provided
+    const languageHint = input.language ?? "";
+    // Add code block
+    parts.push(`\n\`\`\`${languageHint}\n${input.code}\n\`\`\``);
+    // Add review guidance
+    parts.push("\nProvide feedback on:");
+    parts.push("- Code quality and readability");
+    parts.push("- Potential bugs or edge cases");
+    parts.push("- Security concerns");
+    parts.push("- Performance considerations");
+    parts.push("- Best practices and improvements");
+    return parts.join("\n");
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+/**
+ * Registers the review_code 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);
+ * registerReviewCodeTool(server, router, logger);
+ * ```
+ */
+export function registerReviewCodeTool(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 = reviewCodeInputSchemaShape;
+    server.registerTool("review_code", {
+        title: "Review Code",
+        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 { code, language, context } = args;
+        logger.info("review_code called", {
+            codeLength: code.length,
+            language: language ?? "auto-detect",
+            hasContext: context !== undefined,
+        });
+        try {
+            const startTime = Date.now();
+            // Build the task string for the reviewer agent
+            const taskString = buildReviewTask({ code, language, context });
+            // Invoke the reviewer agent
+            const response = await router.invokeAgent({
+                role: "reviewer",
+                task: taskString,
+            });
+            const durationMs = Date.now() - startTime;
+            logger.info("review_code completed", {
+                provider: response.provider,
+                model: response.model,
+                durationMs,
+                traceId: response.metadata.traceId,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatCodeReviewResponse(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("review_code failed", {
+                    error,
+                    errorMessage,
+                });
+            }
+            else {
+                logger.error("review_code failed", {
+                    errorMessage,
+                });
+            }
+            // Return error as text content for MCP compatibility
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Error Getting Code Review\n\n${errorMessage}`,
+                    },
+                ],
+            };
+        }
+    });
+    logger.debug("Registered review_code tool");
+}
+//# sourceMappingURL=review-code.js.map

package/dist/mcp/tools/review-code.js.map

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

package/dist/mcp/tools/tasks/claim-next-task.d.ts

@@ -0,0 +1,22 @@
+/**
+ * claim_next_task MCP Tool
+ *
+ * Generates instructions for workers to claim available tasks.
+ * Workers use these instructions to find, claim, and execute pending tasks.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../../observability/logger.js";
+/**
+ * Registers the claim_next_task tool with the MCP server.
+ *
+ * @param server - MCP server instance
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '3.0.0' });
+ * registerClaimNextTaskTool(server, logger);
+ * ```
+ */
+export declare function registerClaimNextTaskTool(server: McpServer, logger: Logger): void;
+//# sourceMappingURL=claim-next-task.d.ts.map

package/dist/mcp/tools/tasks/claim-next-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-next-task.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/claim-next-task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AA2I/D;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,GACb,IAAI,CAgFN"}

package/dist/mcp/tools/tasks/claim-next-task.js

@@ -0,0 +1,203 @@
+/**
+ * claim_next_task MCP Tool
+ *
+ * Generates instructions for workers to claim available tasks.
+ * Workers use these instructions to find, claim, and execute pending tasks.
+ */
+import { z } from "zod";
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Available agent roles (same as invoke-agent)
+ */
+const AGENT_ROLES = ["coder", "critic", "designer", "researcher", "reviewer"];
+/**
+ * Task selection priority strategies
+ */
+const PRIORITY_STRATEGIES = ["highest", "lowest", "fifo"];
+/**
+ * Tool description for claim_next_task
+ */
+const TOOL_DESCRIPTION = "Generate instructions for a worker to claim and execute the next available task. " +
+    "Returns markdown instructions that guide the worker through the claim protocol.";
+// ============================================================================
+// Input Schema
+// ============================================================================
+/**
+ * Zod schema shape for claim_next_task input validation.
+ * Uses raw shape format as expected by MCP SDK's registerTool.
+ */
+const claimNextTaskInputSchemaShape = {
+    workerName: z
+        .string()
+        .min(1)
+        .describe("Worker identifier for ownership tracking"),
+    roles: z
+        .array(z.enum(AGENT_ROLES))
+        .optional()
+        .describe("Only claim tasks for these roles. If not specified, claims tasks for any role."),
+    priority: z
+        .enum(PRIORITY_STRATEGIES)
+        .default("fifo")
+        .describe("Task selection strategy: 'highest' (highest priority first), 'lowest' (lowest priority first), 'fifo' (first in, first out)"),
+    excludeTaskIds: z
+        .array(z.string())
+        .optional()
+        .describe("Task IDs to skip (e.g., previously failed tasks)"),
+};
+// ============================================================================
+// Instruction Generator
+// ============================================================================
+/**
+ * Generates markdown instructions for the worker claim protocol.
+ *
+ * @param input - The validated input parameters
+ * @returns Formatted markdown instructions
+ */
+function generateClaimInstructions(input) {
+    const { workerName, roles, priority, excludeTaskIds } = input;
+    const rolesDisplay = roles?.length ? roles.join(", ") : "any";
+    const roleFilter = roles?.length
+        ? `metadata.role IN [${roles.map((r) => `"${r}"`).join(", ")}]`
+        : "any role";
+    const excludeClause = excludeTaskIds?.length
+        ? `   - id NOT IN [${excludeTaskIds.join(", ")}]`
+        : "";
+    return `## Claim Next Task
+
+### Search Criteria
+- Worker: ${workerName}
+- Roles: ${rolesDisplay}
+- Priority: ${priority}
+
+### Instructions
+
+1. First, get current tasks:
+\`TaskList()\`
+
+2. Find a task matching:
+   - status = "pending"
+   - owner = null (unclaimed)
+   - blockedBy is empty OR all blockers completed
+   - ${roleFilter}
+${excludeClause}
+
+3. If found, claim it:
+\`TaskUpdate({ taskId: <found_id>, status: "in_progress", owner: "${workerName}" })\`
+
+4. Then execute:
+\`execute_task({ taskId: <found_id> })\`
+
+5. On completion, loop back to step 1.
+
+6. If no tasks match, worker can exit:
+\`Teammate({ operation: "requestShutdown" })\`
+
+### Notes
+- If a claim fails (another worker claimed first), add the taskId to excludeTaskIds and retry
+- Priority "${priority}" means: ${getPriorityDescription(priority)}
+- The execute_task tool automatically marks tasks complete on success
+- If execution fails, the task is released for retry
+`;
+}
+/**
+ * Get human-readable description for a priority strategy.
+ */
+function getPriorityDescription(priority) {
+    switch (priority) {
+        case "highest":
+            return "select the task with the highest priority value first";
+        case "lowest":
+            return "select the task with the lowest priority value first";
+        case "fifo":
+            return "select the oldest pending task first (first in, first out)";
+    }
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+/**
+ * Registers the claim_next_task tool with the MCP server.
+ *
+ * @param server - MCP server instance
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '3.0.0' });
+ * registerClaimNextTaskTool(server, logger);
+ * ```
+ */
+export function registerClaimNextTaskTool(server, 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 = claimNextTaskInputSchemaShape;
+    server.registerTool("claim_next_task", {
+        title: "Claim Next Task",
+        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 input = args;
+        // Apply default for priority if not provided
+        const normalizedInput = {
+            ...input,
+            priority: input.priority ?? "fifo",
+        };
+        logger.info("claim_next_task called", {
+            workerName: normalizedInput.workerName,
+            roles: normalizedInput.roles,
+            priority: normalizedInput.priority,
+            excludeCount: normalizedInput.excludeTaskIds?.length ?? 0,
+        });
+        try {
+            const instructions = generateClaimInstructions(normalizedInput);
+            logger.debug("claim_next_task instructions generated", {
+                workerName: normalizedInput.workerName,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: instructions,
+                    },
+                ],
+            };
+        }
+        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("claim_next_task failed", {
+                    workerName: normalizedInput.workerName,
+                    error,
+                    errorMessage,
+                });
+            }
+            else {
+                logger.error("claim_next_task failed", {
+                    workerName: normalizedInput.workerName,
+                    errorMessage,
+                });
+            }
+            // Return error as text content for MCP compatibility
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Error Generating Claim Instructions\n\n${errorMessage}`,
+                    },
+                ],
+            };
+        }
+    });
+    logger.debug("Registered claim_next_task tool", {
+        roles: AGENT_ROLES,
+        priorities: PRIORITY_STRATEGIES,
+    });
+}
+//# sourceMappingURL=claim-next-task.js.map

package/dist/mcp/tools/tasks/claim-next-task.js.map

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

package/dist/mcp/tools/tasks/create-routed-task.d.ts

@@ -0,0 +1,17 @@
+/**
+ * create_routed_task MCP Tool
+ *
+ * Generates TaskCreate instruction strings for tasks pre-configured for AgentRouter.
+ * This tool outputs the TaskCreate syntax that can be executed to create tasks
+ * that will be routed to specific agent roles.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../../observability/logger.js";
+/**
+ * Registers the create_routed_task tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param logger - Logger instance for structured logging
+ */
+export declare function registerCreateRoutedTaskTool(server: McpServer, logger: Logger): void;
+//# sourceMappingURL=create-routed-task.d.ts.map

package/dist/mcp/tools/tasks/create-routed-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-routed-task.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/create-routed-task.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAsI/D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAqEpF"}

package/dist/mcp/tools/tasks/create-routed-task.js

@@ -0,0 +1,178 @@
+/**
+ * create_routed_task MCP Tool
+ *
+ * Generates TaskCreate instruction strings for tasks pre-configured for AgentRouter.
+ * This tool outputs the TaskCreate syntax that can be executed to create tasks
+ * that will be routed to specific agent roles.
+ */
+import { z } from "zod";
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Available agent roles for task routing
+ */
+const AGENT_ROLES = ["coder", "critic", "designer", "researcher", "reviewer"];
+/**
+ * Tool description for create_routed_task
+ */
+const TOOL_DESCRIPTION = "Generate a TaskCreate instruction string for a task pre-configured for AgentRouter. " +
+    "The output contains the TaskCreate syntax to execute, which will create a task " +
+    "routed to a specific agent role (coder, critic, designer, researcher, reviewer).";
+// ============================================================================
+// Input Schema
+// ============================================================================
+/**
+ * Zod schema shape for create_routed_task input validation.
+ * Uses raw shape format as expected by MCP SDK's registerTool.
+ */
+const createRoutedTaskInputSchemaShape = {
+    subject: z
+        .string()
+        .min(1)
+        .describe("Short task title in imperative form (e.g., 'Implement user authentication')"),
+    description: z
+        .string()
+        .optional()
+        .describe("Detailed description of the task requirements and context"),
+    role: z
+        .enum(AGENT_ROLES)
+        .describe("AgentRouter role for execution: coder (implementation), critic (plan review), " +
+        "designer (UI/UX), researcher (fact-finding), reviewer (code review)"),
+    blockedBy: z
+        .array(z.string())
+        .optional()
+        .describe("Array of task IDs that this task depends on (must complete first)"),
+    priority: z
+        .number()
+        .optional()
+        .describe("Priority level where 1 is highest priority"),
+};
+// ============================================================================
+// Response Formatter
+// ============================================================================
+/**
+ * Formats the TaskCreate instruction response
+ *
+ * @param input - The validated input parameters
+ * @returns Formatted string with TaskCreate instruction
+ */
+function formatTaskCreateResponse(input) {
+    const { subject, description, role, blockedBy, priority } = input;
+    // Build the metadata object
+    const metadataEntries = [
+        "    agentRouter: true",
+        `    role: "${role}"`,
+    ];
+    if (priority !== undefined) {
+        metadataEntries.push(`    priority: ${String(priority)}`);
+    }
+    // Build the TaskCreate parameters
+    const taskCreateLines = [
+        `  subject: "${escapeString(subject)}"`,
+    ];
+    if (description !== undefined) {
+        taskCreateLines.push(`  description: "${escapeString(description)}"`);
+    }
+    taskCreateLines.push(`  activeForm: "Awaiting ${role} agent..."`);
+    taskCreateLines.push(`  metadata: {\n${metadataEntries.join(",\n")}\n  }`);
+    if (blockedBy !== undefined && blockedBy.length > 0) {
+        const blockedByStr = blockedBy.map((id) => `"${escapeString(id)}"`).join(", ");
+        taskCreateLines.push(`  blockedBy: [${blockedByStr}]`);
+    }
+    const taskCreateBody = taskCreateLines.join(",\n");
+    return `## Create Routed Task
+
+Execute this to create the task:
+
+\`\`\`
+TaskCreate({
+${taskCreateBody}
+})
+\`\`\`
+
+After creation, execute with:
+\`execute_task({ taskId: <new_id>, role: "${role}" })\``;
+}
+/**
+ * Escapes special characters in strings for safe inclusion in generated code
+ */
+function escapeString(str) {
+    return str
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+/**
+ * Registers the create_routed_task tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param logger - Logger instance for structured logging
+ */
+export function registerCreateRoutedTaskTool(server, 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 = createRoutedTaskInputSchemaShape;
+    server.registerTool("create_routed_task", {
+        title: "Create Routed Task",
+        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 input = args;
+        logger.info("create_routed_task called", {
+            subject: input.subject,
+            role: input.role,
+            hasDescription: input.description !== undefined,
+            hasBlockedBy: input.blockedBy !== undefined && input.blockedBy.length > 0,
+            priority: input.priority,
+        });
+        try {
+            const responseText = formatTaskCreateResponse(input);
+            logger.info("create_routed_task completed", {
+                role: input.role,
+                subject: input.subject,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (error instanceof Error) {
+                logger.error("create_routed_task failed", {
+                    error,
+                    errorMessage,
+                });
+            }
+            else {
+                logger.error("create_routed_task failed", {
+                    errorMessage,
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Error Creating Routed Task\n\n${errorMessage}`,
+                    },
+                ],
+            };
+        }
+    });
+    logger.debug("Registered create_routed_task tool", { roles: AGENT_ROLES });
+}
+//# sourceMappingURL=create-routed-task.js.map

package/dist/mcp/tools/tasks/create-routed-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-routed-task.js","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/create-routed-task.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAEvF;;GAEG;AACH,MAAM,gBAAgB,GACpB,sFAAsF;IACtF,iFAAiF;IACjF,kFAAkF,CAAC;AAErF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,gCAAgC,GAAG;IACvC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;IACxE,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,QAAQ,CACP,gFAAgF;QAC9E,qEAAqE,CACxE;IACH,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;IAChF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAaF,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;GAKG;AACH,SAAS,wBAAwB,CAAC,KAA4B;IAC5D,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAElE,4BAA4B;IAC5B,MAAM,eAAe,GAAG;QACtB,uBAAuB;QACvB,cAAc,IAAI,GAAG;KACtB,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,eAAe,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,kCAAkC;IAClC,MAAM,eAAe,GAAG;QACtB,eAAe,YAAY,CAAC,OAAO,CAAC,GAAG;KACxC,CAAC;IAEF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,eAAe,CAAC,IAAI,CAAC,mBAAmB,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,eAAe,CAAC,IAAI,CAAC,2BAA2B,IAAI,YAAY,CAAC,CAAC;IAClE,eAAe,CAAC,IAAI,CAAC,kBAAkB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3E,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,eAAe,CAAC,IAAI,CAAC,iBAAiB,YAAY,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnD,OAAO;;;;;;EAMP,cAAc;;;;;4CAK4B,IAAI,QAAQ,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG;SACP,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,MAAc;IAC5E,qEAAqE;IACrE,6DAA6D;IAC7D,gGAAgG;IAChG,MAAM,WAAW,GAAQ,gCAAgC,CAAC;IAE1D,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,gBAAgB;QAC7B,WAAW;KACZ;IACD,+FAA+F;IAC/F,KAAK,EAAE,IAAa,EAAE,EAAE;QACtB,0DAA0D;QAC1D,MAAM,KAAK,GAAG,IAA6B,CAAC;QAE5C,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;YACvC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,cAAc,EAAE,KAAK,CAAC,WAAW,KAAK,SAAS;YAC/C,YAAY,EAAE,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YACzE,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;YAErD,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,YAAY;qBACnB;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,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;oBACxC,KAAK;oBACL,YAAY;iBACb,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;oBACxC,YAAY;iBACb,CAAC,CAAC;YACL,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,oCAAoC,YAAY,EAAE;qBACzD;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAC7E,CAAC"}