wiggum-cli 0.3.2 → 0.4.0

package/dist/ai/agents/planning-orchestrator.js

@@ -0,0 +1,133 @@
+/**
+ * Planning Orchestrator Agent (Phase 1)
+ * Creates an analysis plan that guides the parallel workers
+ */
+import { z } from 'zod';
+import { isReasoningModel } from '../providers.js';
+import { logger } from '../../utils/logger.js';
+import { getTracedAI } from '../../utils/tracing.js';
+/**
+ * Schema for the analysis plan output
+ */
+const analysisPlanSchema = z.object({
+    areasToExplore: z.array(z.string()).describe('Key directories and files to explore'),
+    technologiesToResearch: z.array(z.string()).describe('Technologies to research in depth'),
+    questionsToAnswer: z.array(z.string()).describe('Specific questions that need answers'),
+    estimatedComplexity: z.enum(['low', 'medium', 'high']).describe('Estimated project complexity'),
+});
+/**
+ * System prompt for the Planning Orchestrator
+ */
+const PLANNING_ORCHESTRATOR_SYSTEM_PROMPT = `You are a senior software architect analyzing a codebase to create an analysis plan.
+
+Based on the scan result, create a focused analysis plan that identifies:
+1. Key areas to explore (directories, config files, entry points)
+2. Technologies that need in-depth research (frameworks, libraries, tools)
+3. Specific questions that need answers for implementation guidance
+
+## Guidelines
+- Focus on areas that would benefit from deeper exploration
+- Identify technologies where best practices would be valuable
+- Ask questions that would help an AI developer implement features correctly
+- Keep lists focused (3-7 items each)
+- Consider the project type when prioritizing areas
+
+## Example Output
+{
+  "areasToExplore": ["src/", "config/", "lib/auth/"],
+  "technologiesToResearch": ["Next.js 14", "Prisma", "NextAuth"],
+  "questionsToAnswer": ["What is the authentication strategy?", "How is state managed?", "What testing patterns are used?"],
+  "estimatedComplexity": "medium"
+}`;
+/**
+ * Run the Planning Orchestrator to create an analysis plan
+ */
+export async function runPlanningOrchestrator(model, modelId, scanResult, verbose = false) {
+    // Build technology summary from scan result
+    const technologies = [];
+    const stack = scanResult.stack;
+    if (stack.framework)
+        technologies.push(stack.framework.name);
+    if (stack.database)
+        technologies.push(stack.database.name);
+    if (stack.orm)
+        technologies.push(stack.orm.name);
+    if (stack.testing?.unit)
+        technologies.push(stack.testing.unit.name);
+    if (stack.testing?.e2e)
+        technologies.push(stack.testing.e2e.name);
+    if (stack.stateManagement)
+        technologies.push(stack.stateManagement.name);
+    if (stack.auth)
+        technologies.push(stack.auth.name);
+    if (stack.styling)
+        technologies.push(stack.styling.name);
+    if (stack.mcp?.isProject)
+        technologies.push('MCP Server');
+    const prompt = `Analyze this scan result and create an analysis plan:
+
+Project: ${scanResult.projectRoot}
+Framework: ${stack.framework?.name || 'Unknown'}
+Database: ${stack.database?.name || 'None detected'}
+Testing: ${stack.testing?.unit?.name || 'None detected'}
+Package Manager: ${stack.packageManager?.name || 'npm'}
+Detected Technologies: ${technologies.join(', ') || 'None'}
+${stack.mcp?.isProject ? 'This is an MCP Server project.' : ''}
+
+Create a focused analysis plan that will help understand this codebase.`;
+    try {
+        const { generateObject } = getTracedAI();
+        const { object: plan } = await generateObject({
+            model,
+            schema: analysisPlanSchema,
+            system: PLANNING_ORCHESTRATOR_SYSTEM_PROMPT,
+            prompt,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: {
+                    agent: 'planning-orchestrator',
+                    projectRoot: scanResult.projectRoot,
+                    framework: stack.framework?.name || 'unknown',
+                },
+            },
+        });
+        if (verbose) {
+            logger.info(`Planning Orchestrator: ${plan.areasToExplore.length} areas, ${plan.technologiesToResearch.length} techs, ${plan.questionsToAnswer.length} questions`);
+        }
+        return plan;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Planning Orchestrator error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Return a sensible default plan
+        return getDefaultPlan(scanResult);
+    }
+}
+/**
+ * Get a default analysis plan when the orchestrator fails
+ */
+function getDefaultPlan(scanResult) {
+    const stack = scanResult.stack;
+    const technologies = [];
+    if (stack.framework)
+        technologies.push(stack.framework.name);
+    if (stack.database)
+        technologies.push(stack.database.name);
+    if (stack.orm)
+        technologies.push(stack.orm.name);
+    if (stack.testing?.unit)
+        technologies.push(stack.testing.unit.name);
+    return {
+        areasToExplore: ['src/', 'package.json'],
+        technologiesToResearch: technologies.length > 0 ? technologies : ['TypeScript'],
+        questionsToAnswer: [
+            'What is the project structure?',
+            'What are the main entry points?',
+            'How are tests organized?',
+        ],
+        estimatedComplexity: 'medium',
+    };
+}
+//# sourceMappingURL=planning-orchestrator.js.map

package/dist/ai/agents/planning-orchestrator.js.map

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

package/dist/ai/agents/stack-researcher.d.ts

@@ -2,6 +2,9 @@
  * Stack Researcher Agent
  * Researches best practices and tools for the detected stack
  * Gracefully degrades when optional services are unavailable
+ *
+ * @deprecated Use runTechResearcher/runTechResearchPool from tech-researcher.ts instead.
+ * This agent is kept for backward compatibility.
  */
 import { type LanguageModel } from 'ai';
 import type { StackResearch, StackResearcherInput } from './types.js';

package/dist/ai/agents/stack-researcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack-researcher.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/stack-researcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAa,MAAM,IAAI,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AAmKzF;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiD/B"}
+{"version":3,"file":"stack-researcher.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/stack-researcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAa,MAAM,IAAI,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AAmKzF;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiD/B"}

package/dist/ai/agents/stack-researcher.js

@@ -2,6 +2,9 @@
  * Stack Researcher Agent
  * Researches best practices and tools for the detected stack
  * Gracefully degrades when optional services are unavailable
+ *
+ * @deprecated Use runTechResearcher/runTechResearchPool from tech-researcher.ts instead.
+ * This agent is kept for backward compatibility.
  */
 import { stepCountIs } from 'ai';
 import { createTavilySearchTool } from '../tools/tavily.js';

package/dist/ai/agents/stack-researcher.js.map

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

package/dist/ai/agents/stack-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stack Utilities
+ * Shared helper functions for working with DetectedStack
+ */
+import type { DetectedStack } from '../../scanner/types.js';
+/**
+ * Detect project type from the stack
+ * Returns a human-readable project type string
+ */
+export declare function detectProjectType(stack: DetectedStack | undefined): string;
+//# sourceMappingURL=stack-utils.d.ts.map

package/dist/ai/agents/stack-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-utils.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/stack-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAsB1E"}

package/dist/ai/agents/stack-utils.js

@@ -0,0 +1,27 @@
+/**
+ * Stack Utilities
+ * Shared helper functions for working with DetectedStack
+ */
+/**
+ * Detect project type from the stack
+ * Returns a human-readable project type string
+ */
+export function detectProjectType(stack) {
+    if (!stack) {
+        return 'Unknown';
+    }
+    if (stack.mcp?.isProject) {
+        return 'MCP Server';
+    }
+    if (stack.framework?.name?.includes('Next')) {
+        return 'Next.js App';
+    }
+    if (stack.framework?.name?.includes('React')) {
+        return 'React SPA';
+    }
+    if (stack.framework?.name) {
+        return `${stack.framework.name} Project`;
+    }
+    return 'Unknown';
+}
+//# sourceMappingURL=stack-utils.js.map

package/dist/ai/agents/stack-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-utils.js","sourceRoot":"","sources":["../../../src/ai/agents/stack-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;QAC1B,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC;IAC3C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/ai/agents/synthesis-agent.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Synthesis Agent (Phase 3)
+ * Merges results from parallel workers and generates implementation guidelines
+ */
+import { type LanguageModel } from 'ai';
+import type { SynthesisInput, MultiAgentAnalysis } from './types.js';
+/**
+ * Run the Synthesis Agent to merge results and generate guidelines
+ */
+export declare function runSynthesisAgent(model: LanguageModel, modelId: string, input: SynthesisInput, verbose?: boolean): Promise<MultiAgentAnalysis>;
+//# sourceMappingURL=synthesis-agent.d.ts.map

package/dist/ai/agents/synthesis-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis-agent.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/synthesis-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAInB,MAAM,YAAY,CAAC;AA4CpB;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA8D7B"}

package/dist/ai/agents/synthesis-agent.js

@@ -0,0 +1,202 @@
+/**
+ * Synthesis Agent (Phase 3)
+ * Merges results from parallel workers and generates implementation guidelines
+ */
+import { z } from 'zod';
+import { convertToLegacyMcpRecommendations } from './mcp-detector.js';
+import { isReasoningModel } from '../providers.js';
+import { logger } from '../../utils/logger.js';
+import { getTracedAI } from '../../utils/tracing.js';
+/**
+ * Schema for synthesis output (implementation guidelines)
+ */
+const synthesisOutputSchema = z.object({
+    implementationGuidelines: z.array(z.string()).describe('Short, actionable implementation guidelines'),
+    possibleMissedTechnologies: z.array(z.string()).optional().describe('Technologies that may have been missed'),
+});
+/**
+ * System prompt for the Synthesis Agent
+ */
+const SYNTHESIS_AGENT_SYSTEM_PROMPT = `You are a Synthesis Agent that merges analysis results into actionable implementation guidelines.
+
+## Your Mission
+Based on the enriched context and technology research, generate:
+1. Short, actionable implementation guidelines (5-10 words each)
+2. List any technologies that may have been missed
+
+## Guidelines Style
+- Start with action verbs: "Run", "Use", "Follow", "Avoid"
+- Be specific to the detected stack
+- Include testing commands
+- Mention key patterns from the research
+- Max 7 guidelines, prioritize the most important
+
+## Example Output
+{
+  "implementationGuidelines": [
+    "Run npm test after changes",
+    "Use App Router for new pages",
+    "Follow existing component patterns in src/components",
+    "Use Zod for API validation",
+    "Run npx playwright test for E2E"
+  ],
+  "possibleMissedTechnologies": ["Redis caching"]
+}`;
+/**
+ * Run the Synthesis Agent to merge results and generate guidelines
+ */
+export async function runSynthesisAgent(model, modelId, input, verbose = false) {
+    // Build context summary for the LLM
+    const techSummary = input.techResearch
+        .map(r => `### ${r.technology}\nBest practices: ${r.bestPractices.slice(0, 3).join(', ')}\nAnti-patterns: ${r.antiPatterns.slice(0, 2).join(', ')}`)
+        .join('\n\n');
+    const prompt = `Synthesize these analysis results into implementation guidelines.
+
+## Project Context
+- Type: ${input.enrichedContext.projectType}
+- Entry Points: ${input.enrichedContext.entryPoints.join(', ')}
+- Key Directories: ${Object.entries(input.enrichedContext.keyDirectories).map(([k, v]) => `${k} (${v})`).join(', ')}
+
+## Commands Available
+${Object.entries(input.enrichedContext.commands).map(([k, v]) => `- ${k}: ${v}`).join('\n')}
+
+## Technology Research
+${techSummary || 'No specific technology research available.'}
+
+## MCP Servers
+- E2E Testing: ${input.mcpServers.e2eTesting}
+- Database: ${input.mcpServers.database || 'None detected'}
+- Additional: ${input.mcpServers.additional.join(', ') || 'None'}
+
+## Analysis Plan Questions & Answers
+${Object.entries(input.enrichedContext.answeredQuestions).map(([q, a]) => `Q: ${q}\nA: ${a}`).join('\n\n') || 'No questions answered.'}
+
+Generate concise, actionable implementation guidelines based on this analysis.`;
+    try {
+        const { generateObject } = getTracedAI();
+        const { object: synthesis } = await generateObject({
+            model,
+            schema: synthesisOutputSchema,
+            system: SYNTHESIS_AGENT_SYSTEM_PROMPT,
+            prompt,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: {
+                    agent: 'synthesis-agent',
+                    projectType: input.enrichedContext.projectType,
+                    techCount: input.techResearch.length,
+                },
+            },
+        });
+        if (verbose) {
+            logger.info(`Synthesis Agent: Generated ${synthesis.implementationGuidelines.length} guidelines`);
+        }
+        // Convert to MultiAgentAnalysis format for backward compatibility
+        return buildMultiAgentAnalysis(input, synthesis.implementationGuidelines, synthesis.possibleMissedTechnologies);
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Synthesis Agent error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Return with default guidelines
+        return buildMultiAgentAnalysis(input, getDefaultGuidelines(input), []);
+    }
+}
+/**
+ * Build MultiAgentAnalysis from synthesis input and generated guidelines
+ */
+function buildMultiAgentAnalysis(input, implementationGuidelines, possibleMissedTechnologies) {
+    // Convert EnrichedContext to CodebaseAnalysis format
+    const codebaseAnalysis = {
+        projectContext: {
+            entryPoints: input.enrichedContext.entryPoints,
+            keyDirectories: input.enrichedContext.keyDirectories,
+            namingConventions: input.enrichedContext.namingConventions,
+            projectType: input.enrichedContext.projectType,
+        },
+        commands: {
+            test: input.enrichedContext.commands.test,
+            lint: input.enrichedContext.commands.lint,
+            typecheck: input.enrichedContext.commands.typecheck,
+            build: input.enrichedContext.commands.build,
+            dev: input.enrichedContext.commands.dev,
+            format: input.enrichedContext.commands.format,
+        },
+        implementationGuidelines,
+        possibleMissedTechnologies,
+    };
+    // Merge tech research into StackResearch format
+    const stackResearch = mergeTechResearch(input.techResearch);
+    // Convert MCP servers to legacy format
+    const mcpServers = convertToLegacyMcpRecommendations(input.mcpServers);
+    return {
+        codebaseAnalysis,
+        stackResearch,
+        mcpServers,
+    };
+}
+/**
+ * Merge multiple TechResearchResult into a single StackResearch
+ */
+function mergeTechResearch(techResearch) {
+    if (techResearch.length === 0) {
+        return {
+            bestPractices: ['Follow project conventions'],
+            antiPatterns: ['Avoid skipping tests'],
+            testingTools: ['npm test'],
+            debuggingTools: ['console.log'],
+            documentationHints: ['Check official docs'],
+            researchMode: 'knowledge-only',
+        };
+    }
+    // Merge all research results
+    const bestPractices = [];
+    const antiPatterns = [];
+    const testingTips = [];
+    const documentationHints = [];
+    let researchMode = 'knowledge-only';
+    for (const research of techResearch) {
+        bestPractices.push(...research.bestPractices);
+        antiPatterns.push(...research.antiPatterns);
+        testingTips.push(...research.testingTips);
+        documentationHints.push(...research.documentationHints);
+        // Use the most complete research mode
+        if (research.researchMode === 'full')
+            researchMode = 'full';
+        else if (research.researchMode === 'web-only' && researchMode !== 'full')
+            researchMode = 'web-only';
+        else if (research.researchMode === 'docs-only' && researchMode === 'knowledge-only')
+            researchMode = 'docs-only';
+    }
+    // Deduplicate and limit
+    return {
+        bestPractices: [...new Set(bestPractices)].slice(0, 10),
+        antiPatterns: [...new Set(antiPatterns)].slice(0, 10),
+        testingTools: [...new Set(testingTips)].slice(0, 5),
+        debuggingTools: [], // Not collected in new format
+        documentationHints: [...new Set(documentationHints)].slice(0, 5),
+        researchMode,
+    };
+}
+/**
+ * Get default implementation guidelines when synthesis fails
+ */
+function getDefaultGuidelines(input) {
+    const guidelines = [];
+    // Add test command if available
+    if (input.enrichedContext.commands.test) {
+        guidelines.push(`Run ${input.enrichedContext.commands.test} after changes`);
+    }
+    // Add build command if available
+    if (input.enrichedContext.commands.build) {
+        guidelines.push(`Run ${input.enrichedContext.commands.build} before committing`);
+    }
+    // Add E2E testing
+    guidelines.push(`Run npx playwright test for E2E testing`);
+    // Add generic guidelines
+    guidelines.push('Follow existing code patterns');
+    guidelines.push('Use TypeScript strict mode');
+    return guidelines.slice(0, 7);
+}
+//# sourceMappingURL=synthesis-agent.js.map

package/dist/ai/agents/synthesis-agent.js.map

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

package/dist/ai/agents/tech-researcher.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tech Researcher Worker (Phase 2)
+ * Researches best practices for a specific technology
+ * Multiple instances run in parallel via runTechResearchPool
+ */
+import { type LanguageModel } from 'ai';
+import type { TechResearcherInput, TechResearchResult, AgentOptions } from './types.js';
+/**
+ * Run a single Tech Researcher worker for one technology
+ */
+export declare function runTechResearcher(model: LanguageModel, modelId: string, input: TechResearcherInput, options: AgentOptions, verbose?: boolean): Promise<TechResearchResult>;
+/**
+ * Run multiple Tech Researchers in parallel for a list of technologies
+ */
+export declare function runTechResearchPool(model: LanguageModel, modelId: string, technologies: string[], options: AgentOptions, verbose?: boolean): Promise<TechResearchResult[]>;
+//# sourceMappingURL=tech-researcher.d.ts.map

package/dist/ai/agents/tech-researcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-researcher.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/tech-researcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAa,MAAM,IAAI,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAqB,YAAY,EAAE,MAAM,YAAY,CAAC;AA6E3G;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAwD7B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiC/B"}