mcp-codex-subagent 2.0.8 → 2.0.10

package/dist/tools/definitions.js

@@ -1,195 +1,269 @@
 import { TOOLS } from '../types.js';
-export const toolDefinitions = [
-    {
-        name: TOOLS.CODEX,
-        description: `Execute Codex CLI agent. Model pinned to gpt-5.3-codex. Returns immediately with task_id — agent runs in background. Use reasoningEffort as the primary tuning knob.
-
-**Roles:**
-- coder: Implementation. Min 1000-char prompt + min 1 .md context file. Include: OBJECTIVE, FILES, CRITERIA, CONSTRAINTS, PATTERNS.
-- planner: Architecture/planning. Min 300-char prompt. Include: PROBLEM, CONSTRAINTS, SCOPE, OUTPUT.
-- tester: QA/testing. Min 300-char prompt + min 1 context file. Include: WHAT BUILT, FILES, CRITERIA, TESTS, EDGE CASES.
-- researcher: Investigation. Min 200-char prompt. Include: TOPIC, QUESTIONS, HANDOFF TARGET.
-
-**Workflow:** researcher -> planner -> coder -> tester.
-**Status:** Read resource \`task:///all\` or \`task:///{id}\`.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                prompt: {
-                    type: 'string',
-                    description: 'The coding task, question, or analysis request',
-                },
-                role: {
-                    type: 'string',
-                    enum: ['coder', 'planner', 'tester', 'researcher'],
-                    description: 'Agent role — applies a structured system prompt template. coder: implementation tasks, planner: architecture/planning, tester: QA/testing, researcher: investigation/research',
-                },
-                specialization: {
-                    type: 'string',
-                    description: 'Specialization overlay for the role. Coder: typescript, python, rust, go, java, kotlin, ruby, csharp, swift, react, vue, nextjs, tauri, triggerdev, supabase, supastarter. Planner: feature, bugfix, refactor, architecture, migration. Researcher: security, performance, library. Tester: playwright, rest, graphql, suite',
-                },
-                context_files: {
-                    type: 'array',
-                    description: 'Context files. Required for coder (min 1 .md) and tester (min 1). Max 20 files, 200KB each, 500KB total.',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            path: {
-                                type: 'string',
-                                description: 'Absolute file path to read',
-                            },
-                            description: {
-                                type: 'string',
-                                description: 'What this file is and why it matters',
-                            },
-                            start_line: {
-                                type: 'integer',
-                                description: 'Start line (1-indexed, optional)',
-                            },
-                            end_line: {
-                                type: 'integer',
-                                description: 'End line (1-indexed, optional)',
+import { buildSpawnSubagentDescription, buildCodeReviewDescription, buildAgentGroupDescription, } from './description-builder.js';
+/**
+ * Build tool definitions dynamically.
+ * Called after template init so discoverAvailableTemplates() can scan disk.
+ */
+export function getToolDefinitions() {
+    return [
+        {
+            name: TOOLS.SPAWN_SUBAGENT,
+            description: buildSpawnSubagentDescription(),
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    prompt: {
+                        type: 'string',
+                        description: 'The coding task, question, or analysis request',
+                    },
+                    role: {
+                        type: 'string',
+                        enum: ['coder', 'planner', 'tester', 'researcher'],
+                        description: 'Agent role — applies a structured system prompt template. coder: implementation tasks, planner: architecture/planning, tester: QA/testing, researcher: investigation/research',
+                    },
+                    specialization: {
+                        type: 'string',
+                        description: 'Specialization overlay for the role. Coder: typescript, python, rust, go, java, kotlin, ruby, csharp, swift, react, vue, nextjs, tauri, triggerdev, supabase, supastarter. Planner: feature, bugfix, refactor, architecture, migration. Researcher: security, performance, library. Tester: playwright, rest, graphql, suite',
+                    },
+                    context_files: {
+                        type: 'array',
+                        description: 'Context files. Required for coder (min 1 .md) and tester (min 1). Max 20 files, 200KB each, 500KB total.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                path: {
+                                    type: 'string',
+                                    description: 'Absolute file path to read',
+                                },
+                                description: {
+                                    type: 'string',
+                                    description: 'What this file is and why it matters',
+                                },
+                                start_line: {
+                                    type: 'integer',
+                                    description: 'Start line (1-indexed, optional)',
+                                },
+                                end_line: {
+                                    type: 'integer',
+                                    description: 'End line (1-indexed, optional)',
+                                },
                             },
+                            required: ['path'],
                         },
-                        required: ['path'],
+                    },
+                    sessionId: {
+                        type: 'string',
+                        description: 'Optional session ID for conversational context. Note: when resuming a session, sandbox/workingDirectory parameters are not applied (CLI limitation)',
+                    },
+                    resetSession: {
+                        type: 'boolean',
+                        description: 'Reset the session history before processing this request',
+                    },
+                    reasoningEffort: {
+                        type: 'string',
+                        enum: ['low', 'medium', 'high', 'xhigh'],
+                        description: 'Control reasoning depth (low < medium < high < xhigh). This is the primary tuning knob. Defaults to xhigh.',
+                    },
+                    sandbox: {
+                        type: 'string',
+                        enum: ['read-only', 'workspace-write', 'danger-full-access'],
+                        description: 'Sandbox policy for shell command execution. Defaults to danger-full-access.',
+                    },
+                    workingDirectory: {
+                        type: 'string',
+                        description: 'Working directory for the agent to use as its root (passed via -C flag)',
+                    },
+                    callbackUri: {
+                        type: 'string',
+                        description: 'Static MCP callback URI to pass to Codex via environment (if provided)',
                     },
                 },
-                sessionId: {
-                    type: 'string',
-                    description: 'Optional session ID for conversational context. Note: when resuming a session, sandbox/workingDirectory parameters are not applied (CLI limitation)',
-                },
-                resetSession: {
-                    type: 'boolean',
-                    description: 'Reset the session history before processing this request',
-                },
-                reasoningEffort: {
-                    type: 'string',
-                    enum: ['low', 'medium', 'high', 'xhigh'],
-                    description: 'Control reasoning depth (low < medium < high < xhigh). This is the primary tuning knob. Defaults to xhigh.',
-                },
-                sandbox: {
-                    type: 'string',
-                    enum: ['read-only', 'workspace-write', 'danger-full-access'],
-                    description: 'Sandbox policy for shell command execution. Defaults to danger-full-access.',
-                },
-                workingDirectory: {
-                    type: 'string',
-                    description: 'Working directory for the agent to use as its root (passed via -C flag)',
-                },
-                callbackUri: {
-                    type: 'string',
-                    description: 'Static MCP callback URI to pass to Codex via environment (if provided)',
+                required: ['prompt'],
+            },
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    threadId: { type: 'string' },
                 },
             },
-            required: ['prompt'],
-        },
-        outputSchema: {
-            type: 'object',
-            properties: {
-                threadId: { type: 'string' },
+            annotations: {
+                title: 'Spawn Codex Agent',
+                readOnlyHint: false,
+                destructiveHint: true,
+                idempotentHint: false,
+                openWorldHint: true,
             },
         },
-        annotations: {
-            title: 'Execute Codex CLI',
-            readOnlyHint: false,
-            destructiveHint: true,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: TOOLS.REVIEW,
-        description: 'Run a code review against the current repository using Codex CLI',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                prompt: {
-                    type: 'string',
-                    description: 'Custom review instructions or focus areas (cannot be used with uncommitted=true; use base/commit review instead)',
-                },
-                uncommitted: {
-                    type: 'boolean',
-                    description: 'Review staged, unstaged, and untracked changes (working tree) - cannot be combined with custom prompt',
-                },
-                base: {
-                    type: 'string',
-                    description: 'Review changes against a specific base branch (e.g., "main", "develop")',
-                },
-                commit: {
-                    type: 'string',
-                    description: 'Review the changes introduced by a specific commit SHA',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Optional title to display in the review summary',
-                },
-                workingDirectory: {
-                    type: 'string',
-                    description: 'Working directory to run the review in (passed via -C as a global Codex option)',
+        {
+            name: TOOLS.CODE_REVIEW,
+            description: buildCodeReviewDescription(),
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    prompt: {
+                        type: 'string',
+                        description: 'Custom review instructions or focus areas (cannot be used with uncommitted=true; use base/commit review instead)',
+                    },
+                    uncommitted: {
+                        type: 'boolean',
+                        description: 'Review staged, unstaged, and untracked changes (working tree) - cannot be combined with custom prompt',
+                    },
+                    base: {
+                        type: 'string',
+                        description: 'Review changes against a specific base branch (e.g., "main", "develop")',
+                    },
+                    commit: {
+                        type: 'string',
+                        description: 'Review the changes introduced by a specific commit SHA',
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Optional title to display in the review summary',
+                    },
+                    workingDirectory: {
+                        type: 'string',
+                        description: 'Working directory to run the review in (passed via -C as a global Codex option)',
+                    },
                 },
+                required: [],
+            },
+            annotations: {
+                title: 'Code Review',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
             },
-            required: [],
-        },
-        annotations: {
-            title: 'Code Review',
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
         },
-    },
-    {
-        name: TOOLS.PING,
-        description: 'Test MCP server connection',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                message: {
-                    type: 'string',
-                    description: 'Message to echo back',
+        {
+            name: TOOLS.SPAWN_AGENT_GROUP,
+            description: buildAgentGroupDescription(),
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    agents: {
+                        type: 'array',
+                        description: 'Array of agent specifications. Each agent runs in the shared worktree.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                alias: {
+                                    type: 'string',
+                                    description: 'Unique name for this agent within the group (letters, numbers, hyphens, underscores)',
+                                },
+                                prompt: {
+                                    type: 'string',
+                                    description: 'The task for this agent to perform',
+                                },
+                                role: {
+                                    type: 'string',
+                                    enum: ['coder', 'planner', 'tester', 'researcher'],
+                                    description: 'Agent role — applies a structured system prompt template',
+                                },
+                                specialization: {
+                                    type: 'string',
+                                    description: 'Specialization overlay for the role (e.g., typescript, react, playwright)',
+                                },
+                                context_files: {
+                                    type: 'array',
+                                    description: 'Context files for this agent. Max 20 files, 200KB each, 500KB total.',
+                                    items: {
+                                        type: 'object',
+                                        properties: {
+                                            path: {
+                                                type: 'string',
+                                                description: 'Absolute file path',
+                                            },
+                                            description: {
+                                                type: 'string',
+                                                description: 'What this file is',
+                                            },
+                                            start_line: { type: 'integer' },
+                                            end_line: { type: 'integer' },
+                                        },
+                                        required: ['path'],
+                                    },
+                                },
+                                reasoningEffort: {
+                                    type: 'string',
+                                    enum: ['low', 'medium', 'high', 'xhigh'],
+                                    description: 'Reasoning depth for this agent. Defaults to xhigh.',
+                                },
+                                sandbox: {
+                                    type: 'string',
+                                    enum: ['read-only', 'workspace-write', 'danger-full-access'],
+                                    description: 'Sandbox policy. Defaults to danger-full-access.',
+                                },
+                                depends_on: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Aliases of agents that must complete before this one starts',
+                                },
+                                maxAttempts: {
+                                    type: 'integer',
+                                    description: 'Max retry attempts (1-5). Default 2 (1 original + 1 retry).',
+                                },
+                            },
+                            required: ['alias', 'prompt'],
+                        },
+                    },
+                    commonContext: {
+                        type: 'string',
+                        description: 'Shared context prepended to every agent prompt (separated by ---)',
+                    },
+                    commonContextFiles: {
+                        type: 'array',
+                        description: "Shared context files merged into every agent's context_files",
+                        items: {
+                            type: 'object',
+                            properties: {
+                                path: { type: 'string', description: 'Absolute file path' },
+                                description: {
+                                    type: 'string',
+                                    description: 'What this file is',
+                                },
+                                start_line: { type: 'integer' },
+                                end_line: { type: 'integer' },
+                            },
+                            required: ['path'],
+                        },
+                    },
+                    dependsOn: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Group IDs that must complete before this group starts',
+                    },
+                    append: {
+                        type: 'boolean',
+                        description: 'If true, reuse an existing worktree instead of creating a new one',
+                    },
+                    appendToGroupTaskId: {
+                        type: 'string',
+                        description: 'Group ID whose worktree to reuse (required if append=true)',
+                    },
+                    groupName: {
+                        type: 'string',
+                        description: 'Optional human-readable name for this group',
+                    },
+                    workingDirectory: {
+                        type: 'string',
+                        description: 'Base working directory (default: server cwd)',
+                    },
+                    callbackUri: {
+                        type: 'string',
+                        description: 'Static MCP callback URI passed to each Codex agent',
+                    },
                 },
+                required: ['agents'],
+            },
+            annotations: {
+                title: 'Spawn Agent Group',
+                readOnlyHint: false,
+                destructiveHint: true,
+                idempotentHint: false,
+                openWorldHint: true,
             },
-            required: [],
-        },
-        annotations: {
-            title: 'Ping Server',
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: TOOLS.HELP,
-        description: 'Get Codex CLI help information',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-            required: [],
-        },
-        annotations: {
-            title: 'Get Help',
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: TOOLS.LIST_SESSIONS,
-        description: 'List all active conversation sessions with metadata',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-            required: [],
-        },
-        annotations: {
-            title: 'List Sessions',
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
         },
-    },
-];
+    ];
+}
 //# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

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

package/dist/tools/description-builder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Dynamic description builder for MCP tool definitions.
+ * Scans ~/.mcp-codex-subagent/templates/ to build rich descriptions
+ * that automatically reflect available roles and specializations.
+ */
+/**
+ * Build the description for the spawn_subagent tool.
+ */
+export declare function buildSpawnSubagentDescription(): string;
+/**
+ * Build the description for the spawn_agent_group tool.
+ */
+export declare function buildAgentGroupDescription(): string;
+/**
+ * Build the description for the code_review tool.
+ */
+export declare function buildCodeReviewDescription(): string;
+//# sourceMappingURL=description-builder.d.ts.map

package/dist/tools/description-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-builder.d.ts","sourceRoot":"","sources":["../../src/tools/description-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAwCtD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAiCnD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAUnD"}

package/dist/tools/description-builder.js

@@ -0,0 +1,88 @@
+/**
+ * Dynamic description builder for MCP tool definitions.
+ * Scans ~/.mcp-codex-subagent/templates/ to build rich descriptions
+ * that automatically reflect available roles and specializations.
+ */
+import { discoverAvailableTemplates } from '../templates/index.js';
+/**
+ * Build the description for the spawn_subagent tool.
+ */
+export function buildSpawnSubagentDescription() {
+    const { roles, specializations } = discoverAvailableTemplates();
+    const roleDescriptions = {
+        coder: 'coder: Implementation. Min 1000-char prompt + min 1 .md context file. Include: OBJECTIVE, FILES, CRITERIA, CONSTRAINTS, PATTERNS.',
+        planner: 'planner: Architecture/planning. Min 300-char prompt. Include: PROBLEM, CONSTRAINTS, SCOPE, OUTPUT.',
+        tester: 'tester: QA/testing. Min 300-char prompt + min 1 context file. Include: WHAT BUILT, FILES, CRITERIA, TESTS, EDGE CASES.',
+        researcher: 'researcher: Investigation. Min 200-char prompt. Include: TOPIC, QUESTIONS, HANDOFF TARGET.',
+    };
+    const roleSections = roles
+        .filter((r) => roleDescriptions[r])
+        .map((r) => `- ${roleDescriptions[r]}`)
+        .join('\n');
+    // Build specializations section dynamically
+    const specLines = [];
+    for (const role of roles) {
+        const specs = specializations[role];
+        if (specs && specs.length > 0) {
+            specLines.push(`  ${role}: ${specs.join(', ')}`);
+        }
+    }
+    const specSection = specLines.length > 0
+        ? `\n\n**Specializations:** (from ~/.mcp-codex-subagent/templates/overlays/)\n${specLines.join('\n')}`
+        : '';
+    return `Execute Codex CLI agent. Model pinned to gpt-5.3-codex. Returns immediately with task_id — agent runs in background. Use reasoningEffort as the primary tuning knob.
+
+**Roles:**
+${roleSections}${specSection}
+
+**Workflow:** researcher -> planner -> coder -> tester.
+**Status:** Read resource \`task:///all\` or \`task:///{id}\`.`;
+}
+/**
+ * Build the description for the spawn_agent_group tool.
+ */
+export function buildAgentGroupDescription() {
+    const { specializations } = discoverAvailableTemplates();
+    const specLines = [];
+    for (const [role, specs] of Object.entries(specializations)) {
+        if (specs && specs.length > 0) {
+            specLines.push(`  ${role}: ${specs.join(', ')}`);
+        }
+    }
+    const specSection = specLines.length > 0
+        ? `\n\n**Specializations:** (from ~/.mcp-codex-subagent/templates/overlays/)\n${specLines.join('\n')}`
+        : '';
+    return `Spawn a group of Codex agents that work in a shared Git worktree. Synchronous — blocks until all agents complete, timeout (30 min), or failure. Streams progress via MCP notifications.
+
+**Key features:**
+- Agents share a single Git worktree and branch (\`sub-agent/{group_id}\`)
+- DAG-based scheduling: agents can depend on other agents via \`depends_on\`
+- Global concurrency limit (default 20 parallel agents)
+- Automatic retry on failure (default 2 attempts per agent)
+- Commits all changes on success; no auto-merge
+
+**Roles:**
+- coder: Implementation (min 1000-char prompt + min 1 .md context file)
+- planner: Architecture/planning (min 300-char prompt)
+- tester: QA/testing (min 300-char prompt + min 1 context file)
+- researcher: Investigation (min 200-char prompt)${specSection}
+
+**Group dependencies:** Use \`dependsOn\` to chain groups sequentially.
+**Append mode:** Use \`append: true\` + \`appendToGroupTaskId\` to add agents to an existing worktree.
+**Status:** Read resource \`group:///{group_id}\` for detailed state.`;
+}
+/**
+ * Build the description for the code_review tool.
+ */
+export function buildCodeReviewDescription() {
+    return `Run a code review against the current repository using Codex CLI. Read-only — never modifies files.
+
+**Use this to:**
+- Review uncommitted changes: \`{ "uncommitted": true }\`
+- Review against a branch: \`{ "base": "main" }\`
+- Review a specific commit: \`{ "commit": "abc123" }\`
+- Custom focus: \`{ "base": "main", "prompt": "Focus on security" }\`
+
+**Note:** \`prompt\` cannot be combined with \`uncommitted=true\`.`;
+}
+//# sourceMappingURL=description-builder.js.map

package/dist/tools/description-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-builder.js","sourceRoot":"","sources":["../../src/tools/description-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,0BAA0B,EAAE,CAAC;IAEhE,MAAM,gBAAgB,GAA2B;QAC/C,KAAK,EACH,mIAAmI;QACrI,OAAO,EACL,oGAAoG;QACtG,MAAM,EACJ,wHAAwH;QAC1H,UAAU,EACR,4FAA4F;KAC/F,CAAC;IAEF,MAAM,YAAY,GAAG,KAAK;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,4CAA4C;IAC5C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GACf,SAAS,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,8EAA8E,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACtG,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;;;EAGP,YAAY,GAAG,WAAW;;;+DAGmC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,EAAE,eAAe,EAAE,GAAG,0BAA0B,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5D,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GACf,SAAS,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,8EAA8E,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACtG,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;;;;;;;;;;;;;mDAa0C,WAAW;;;;sEAIQ,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;;;;;;;;mEAQ0D,CAAC;AACpE,CAAC"}