@mseep/ai-tech-app-agent 1.0.0

package/README.MD

@@ -0,0 +1,450 @@
+# AI-Powered Mobile Test Automation with MCP
+
+A cutting-edge test automation solution that uses **Model Context Protocol (MCP)**, **LLM (Llama 3.2:3b)**, and **Appium** to execute mobile tests from natural language specifications.
+
+## 🎯 Key Features
+
+- **Natural Language Test Specs**: Write tests in YAML/JSON using plain English
+- **No Traditional Locators**: AI determines the best element selectors automatically
+- **Cross-Platform**: Works on both Android and iOS
+- **Non-Interactive**: Fully automated execution in CI/CD pipelines
+- **Reliability-First**: Semantic UI analysis prioritized over screenshot-based recognition
+- **Free & Open Source**: Uses Llama 3.2:3b running locally via Ollama
+
+## 🏗️ Architecture
+
+```
+Jenkins Pipeline
+      ↓
+AI Test Runner (Orchestrator)
+      ↓
+   ┌──┴──┐
+   ↓     ↓
+ LLM   MCP Server
+(Llama) (Appium)
+   ↓     ↓
+   └──┬──┘
+      ↓
+   Appium Client
+      ↓
+  LambdaTest
+   (Devices)
+```
+
+## 📋 Prerequisites
+
+### macOS (Development)
+- macOS 12.0 or later (M4 chip recommended)
+- Homebrew installed
+- Xcode Command Line Tools
+- Node.js 18+ and npm
+- VS Code (recommended)
+
+### Required Tools
+- Ollama (for running Llama locally)
+- Appium 2.x
+- Git
+
+## 🚀 Quick Start
+
+### Step 1: Clone and Setup
+
+```bash
+# Create project directory
+mkdir ai-tech-app-agent
+cd ai-tech-app-agent
+
+# Initialize project (or use the artifacts provided)
+npm init -y
+
+# Install dependencies
+npm install
+```
+
+### Step 2: Install Ollama and Llama
+
+```bash
+# Install Ollama
+brew install ollama
+
+# Start Ollama server (keep this running)
+ollama serve
+
+# In another terminal, pull Llama model
+ollama pull llama3.2:3b
+
+# Verify installation
+ollama list
+```
+
+### Step 3: Install Appium
+
+```bash
+# Install Appium globally
+npm install -g appium@next
+
+# Install required drivers
+appium driver install uiautomator2  # For Android
+appium driver install xcuitest       # For iOS
+
+# Verify installation
+appium --version
+```
+
+### Step 4: Configure Environment
+
+Create `.env` file in project root:
+
+```bash
+# LambdaTest Configuration
+LAMBDATEST_USERNAME=your_username
+LAMBDATEST_ACCESS_KEY=your_access_key
+LAMBDATEST_GRID_URL=https://mobile-hub.lambdatest.com/wd/hub
+
+# Ollama/LLM Configuration
+OLLAMA_BASE_URL=http://localhost:11434
+LLM_MODEL=llama3.2:3b
+LLM_TEMPERATURE=0.1
+LLM_MAX_TOKENS=2000
+
+# MCP Configuration
+MCP_SERVER_PORT=3000
+APPIUM_SERVER_URL=http://localhost:4723
+
+# Test Configuration
+DEFAULT_TIMEOUT=30000
+SCREENSHOT_ON_FAILURE=true
+RETRY_FAILED_STEPS=true
+MAX_RETRY_ATTEMPTS=2
+
+# Logging
+LOG_LEVEL=info
+LOG_DIR=./logs
+```
+
+### Step 5: Build the Project
+
+```bash
+# Compile TypeScript
+npm run build
+
+# Verify build
+ls -la dist/
+```
+
+## 📝 Writing Test Specs
+
+Create test specifications in `tests/nlp-specs/` directory:
+
+### Example: Login Flow (`login-flow.yaml`)
+
+```yaml
+name: Technician App Login Flow
+description: Test the complete login flow with OTP verification
+platform: both
+
+setup:
+  - step: Launch the app
+    timeout: 10000
+
+steps:
+  - step: Login with mobile number "112233445"
+    expectedOutcome: OTP screen should appear
+    timeout: 5000
+
+  - step: Enter OTP "1111"
+    expectedOutcome: Home screen should load
+    timeout: 5000
+
+  - step: Enable location access
+    expectedOutcome: Location permission granted
+    timeout: 5000
+
+teardown:
+  - step: Close the app
+```
+
+### Example: Job Search Flow (`job-search-flow.yaml`)
+
+```yaml
+name: Job Search and Selection Flow
+platform: both
+
+setup:
+  - step: Launch the app
+  - step: Login with mobile number "112233445"
+  - step: Enter OTP "1111"
+
+steps:
+  - step: Navigate to jobs tab
+    timeout: 5000
+
+  - step: Search for jobs near current location
+    timeout: 8000
+
+  - step: Select the first available job
+    timeout: 5000
+
+  - step: Verify job details are displayed
+    timeout: 3000
+
+teardown:
+  - step: Return to home screen
+```
+
+## 🎮 Running Tests
+
+### Local Execution
+
+```bash
+# Run all test specs in directory
+npm run test
+
+# Run single test spec
+npm run test:single
+
+# Or use the CLI directly
+node dist/index.js run tests/nlp-specs/login-flow.yaml
+
+# Run with app knowledge file
+node dist/index.js run tests/nlp-specs/ \
+  --knowledge knowledge/app-knowledge.txt \
+  --output reports/test-report.json
+```
+
+### Validate Test Specs
+
+```bash
+# Validate all specs
+npm run validate
+
+# Or specific directory
+node dist/index.js validate tests/nlp-specs/
+```
+
+### Health Check
+
+```bash
+# Check LLM and MCP status
+npm run health
+```
+
+## 🔧 Integration with Existing Framework
+
+To integrate with your existing Appium framework:
+
+### 1. Reuse Device Capabilities
+
+```typescript
+// In your AI test runner, import existing caps
+import { deviceCapsHelper } from '../../../dmg.qa.test.technician-app-3/helpers/deviceCapsHelper';
+
+// Use your existing LambdaTest configuration
+const caps = deviceCapsHelper.getCapabilities('android', 'Pixel 7');
+```
+
+### 2. Leverage Page Object Knowledge
+
+Create an app knowledge file from your existing POMs:
+
+```bash
+# Extract element info from your POMs
+node scripts/extract-pom-knowledge.js \
+  --input ../dmg.qa.test.technician-app-3/pages \
+  --output knowledge/app-knowledge.txt
+```
+
+### 3. Hybrid Approach
+
+Keep your existing framework as fallback:
+
+```typescript
+// If AI fails, fall back to traditional POM
+try {
+  await aiRunner.executeStep(step);
+} catch (error) {
+  logger.warn('AI execution failed, using traditional POM');
+  await traditionalPomExecution(step);
+}
+```
+
+## 📊 CI/CD Integration (Jenkins)
+
+### Prerequisites
+
+1. Create Kubernetes secrets for LambdaTest:
+
+```bash
+kubectl create secret generic lambdatest-creds \
+  --from-literal=username=YOUR_USERNAME \
+  --from-literal=accessKey=YOUR_ACCESS_KEY
+```
+
+2. Deploy Ollama service in your cluster (optional):
+
+```yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: ollama-service
+spec:
+  ports:
+  - port: 11434
+  selector:
+    app: ollama
+```
+
+### Jenkins Pipeline
+
+Use the provided `Jenkinsfile` which includes:
+- Automatic pod provisioning with Node.js and Ollama
+- Repository cloning
+- Model downloading
+- Test execution
+- Report generation
+
+### Trigger Build
+
+```bash
+# Via Jenkins UI or CLI
+curl -X POST http://jenkins-url/job/ai-test-automation/build
+
+# Or via webhook
+git push origin main  # If configured with GitHub webhook
+```
+
+## 📈 Understanding Test Results
+
+Test reports are generated in JSON format:
+
+```json
+{
+  "timestamp": "2025-01-15T10:30:00Z",
+  "summary": {
+    "total": 5,
+    "passed": 4,
+    "failed": 1,
+    "skipped": 0
+  },
+  "results": [
+    {
+      "specName": "Login Flow",
+      "status": "passed",
+      "duration": 45000,
+      "steps": [...]
+    }
+  ]
+}
+```
+
+## 🐛 Troubleshooting
+
+### LLM Not Responding
+
+```bash
+# Check if Ollama is running
+ps aux | grep ollama
+
+# Restart Ollama
+pkill ollama
+ollama serve
+
+# Verify model
+ollama list
+ollama run llama3.2:3b "Hello"
+```
+
+### MCP Connection Issues
+
+```bash
+# Check Appium is running
+appium --version
+
+# Start Appium manually
+appium --allow-cors --log-level info
+
+# Check MCP-Appium installation
+npm list mcp-appium
+```
+
+### Test Execution Failures
+
+```bash
+# Enable debug logging
+export LOG_LEVEL=debug
+
+# Check logs
+tail -f logs/combined.log
+
+# Verify device connectivity (LambdaTest)
+curl -u "$LAMBDATEST_USERNAME:$LAMBDATEST_ACCESS_KEY" \
+  https://mobile-api.lambdatest.com/mobile-automation/api/v1/devices
+```
+
+### Actions Not Executing
+
+1. **Check UI Context**: Ensure page source is being captured correctly
+2. **Verify Selectors**: LLM-generated selectors might need tuning
+3. **Add App Knowledge**: Provide more context about your app's UI patterns
+4. **Increase Timeout**: Some actions might need more time
+5. **Check Element Visibility**: Elements might not be immediately available
+
+## 📚 Advanced Topics
+
+### Custom Action Types
+
+Extend the action executor to support custom actions:
+
+```typescript
+// In mcpClient.ts
+async executeCustomAction(action: CustomAction): Promise<boolean> {
+  // Your custom logic
+}
+```
+
+### Fine-tuning Prompts
+
+Modify prompt templates in `llamaClient.ts` for better accuracy:
+
+```typescript
+private buildPrompt(stepText: string, uiContext: string): string {
+  return `Enhanced prompt with more specific instructions...`;
+}
+```
+
+### Screenshot-Based Recognition
+
+For complex scenarios, enable screenshot analysis:
+
+```typescript
+const uiContext = await mcpClient.getUIContext({
+  includeScreenshot: true,
+  screenshotAnalysis: 'vision-model'
+});
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Areas for improvement:
+
+1. Better XML parsing for UI elements
+2. Enhanced error recovery mechanisms
+3. Support for more complex gestures
+4. Integration with other LLM providers
+5. Performance optimizations
+
+## 📄 License
+
+MIT License - feel free to use and modify
+
+## 🙋 Support
+
+For issues and questions:
+1. Check the troubleshooting section
+2. Review logs in `logs/` directory
+3. Open an issue on GitHub
+4. Contact the team
+
+---
+
+**Note**: This solution prioritizes reliability and maintainability over execution speed. Tests may run slightly slower than traditional scripts initially but provide significantly better maintainability and reduced flakiness.

package/dist/config/app.config.d.ts

@@ -0,0 +1,65 @@
+export interface AppConfig {
+    env: string;
+    name: string;
+    version: string;
+    paths: {
+        root: string;
+        logs: string;
+        reports: string;
+        screenshots: string;
+        testSpecs: string;
+        knowledge: string;
+    };
+    execution: {
+        defaultTimeout: number;
+        maxRetryAttempts: number;
+        retryFailedSteps: boolean;
+        screenshotOnFailure: boolean;
+        continueOnFailure: boolean;
+        parallelExecution: boolean;
+        maxParallelTests: number;
+    };
+    interaction: {
+        implicitWait: number;
+        explicitWait: number;
+        actionDelay: number;
+        tapDuration: number;
+        swipeSpeed: number;
+        scrollPercentage: number;
+    };
+    reporting: {
+        format: 'json' | 'html' | 'allure';
+        includeScreenshots: boolean;
+        includeStepDetails: boolean;
+        includeTimestamps: boolean;
+        verboseLogging: boolean;
+    };
+    lambdatest: {
+        username: string;
+        accessKey: string;
+        gridUrl: string;
+        tunnel: boolean;
+        tunnelName?: string;
+        buildName: string;
+        projectName: string;
+        tags: string[];
+        network: boolean;
+        video: boolean;
+        console: boolean;
+        visual: boolean;
+    };
+    devices: {
+        android: {
+            defaultVersion: string;
+            defaultDevice: string;
+        };
+        ios: {
+            defaultVersion: string;
+            defaultDevice: string;
+        };
+    };
+}
+declare const appConfig: AppConfig;
+export declare function validateAppConfig(): void;
+export default appConfig;
+//# sourceMappingURL=app.config.d.ts.map

package/dist/config/app.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.config.d.ts","sourceRoot":"","sources":["../../src/config/app.config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAGhB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,SAAS,EAAE;QACT,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,mBAAmB,EAAE,OAAO,CAAC;QAC7B,iBAAiB,EAAE,OAAO,CAAC;QAC3B,iBAAiB,EAAE,OAAO,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAGF,WAAW,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAGF,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,kBAAkB,EAAE,OAAO,CAAC;QAC5B,kBAAkB,EAAE,OAAO,CAAC;QAC5B,iBAAiB,EAAE,OAAO,CAAC;QAC3B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IAGF,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IAGF,OAAO,EAAE;QACP,OAAO,EAAE;YACP,cAAc,EAAE,MAAM,CAAC;YACvB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,GAAG,EAAE;YACH,cAAc,EAAE,MAAM,CAAC;YACvB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,CAAC;CACH;AAED,QAAA,MAAM,SAAS,EAAE,SAkEhB,CAAC;AAGF,wBAAgB,iBAAiB,IAAI,IAAI,CAwBxC;AAED,eAAe,SAAS,CAAC"}

package/dist/config/app.config.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAppConfig = validateAppConfig;
+const dotenv_1 = __importDefault(require("dotenv"));
+const path_1 = __importDefault(require("path"));
+dotenv_1.default.config();
+const appConfig = {
+    env: process.env.NODE_ENV || 'development',
+    name: process.env.APP_NAME || 'ai-tech-app-agent',
+    version: process.env.APP_VERSION || '1.0.0',
+    paths: {
+        root: process.cwd(),
+        logs: path_1.default.resolve(process.cwd(), process.env.LOG_DIR || './logs'),
+        reports: path_1.default.resolve(process.cwd(), process.env.REPORT_DIR || './reports'),
+        screenshots: path_1.default.resolve(process.cwd(), process.env.SCREENSHOT_DIR || './reports/screenshots'),
+        testSpecs: path_1.default.resolve(process.cwd(), process.env.TEST_SPEC_DIR || './tests/nlp-specs'),
+        knowledge: path_1.default.resolve(process.cwd(), process.env.KNOWLEDGE_DIR || './knowledge'),
+    },
+    execution: {
+        defaultTimeout: parseInt(process.env.DEFAULT_TIMEOUT || '30000'),
+        maxRetryAttempts: parseInt(process.env.MAX_RETRY_ATTEMPTS || '2'),
+        retryFailedSteps: process.env.RETRY_FAILED_STEPS === 'true',
+        screenshotOnFailure: process.env.SCREENSHOT_ON_FAILURE !== 'false',
+        continueOnFailure: process.env.CONTINUE_ON_FAILURE === 'true',
+        parallelExecution: process.env.PARALLEL_EXECUTION === 'true',
+        maxParallelTests: parseInt(process.env.MAX_PARALLEL_TESTS || '3'),
+    },
+    interaction: {
+        implicitWait: parseInt(process.env.IMPLICIT_WAIT || '5000'),
+        explicitWait: parseInt(process.env.EXPLICIT_WAIT || '10000'),
+        actionDelay: parseInt(process.env.ACTION_DELAY || '500'),
+        tapDuration: parseInt(process.env.TAP_DURATION || '100'),
+        swipeSpeed: parseInt(process.env.SWIPE_SPEED || '1000'),
+        scrollPercentage: parseFloat(process.env.SCROLL_PERCENTAGE || '0.75'),
+    },
+    reporting: {
+        format: process.env.REPORT_FORMAT || 'json',
+        includeScreenshots: process.env.INCLUDE_SCREENSHOTS !== 'false',
+        includeStepDetails: process.env.INCLUDE_STEP_DETAILS !== 'false',
+        includeTimestamps: process.env.INCLUDE_TIMESTAMPS !== 'false',
+        verboseLogging: process.env.VERBOSE_LOGGING === 'true',
+    },
+    lambdatest: {
+        username: process.env.LAMBDATEST_USERNAME || '',
+        accessKey: process.env.LAMBDATEST_ACCESS_KEY || '',
+        gridUrl: process.env.LAMBDATEST_GRID_URL || 'https://mobile-hub.lambdatest.com/wd/hub',
+        tunnel: process.env.LAMBDATEST_TUNNEL === 'true',
+        tunnelName: process.env.LAMBDATEST_TUNNEL_NAME,
+        buildName: process.env.LAMBDATEST_BUILD_NAME || `AI-Test-Build`,
+        projectName: process.env.LAMBDATEST_PROJECT_NAME || 'AI Mobile Test Automation',
+        tags: (process.env.LAMBDATEST_TAGS || 'ai,mcp,automation').split(','),
+        network: process.env.LAMBDATEST_NETWORK !== 'false',
+        video: process.env.LAMBDATEST_VIDEO !== 'false',
+        console: process.env.LAMBDATEST_CONSOLE !== 'false',
+        visual: process.env.LAMBDATEST_VISUAL !== 'false',
+    },
+    devices: {
+        android: {
+            defaultVersion: process.env.ANDROID_DEFAULT_VERSION || '13',
+            defaultDevice: process.env.ANDROID_DEFAULT_DEVICE || 'Pixel 7',
+        },
+        ios: {
+            defaultVersion: process.env.IOS_DEFAULT_VERSION || '16',
+            defaultDevice: process.env.IOS_DEFAULT_DEVICE || 'iPhone 14',
+        },
+    },
+};
+// Validation
+function validateAppConfig() {
+    const errors = [];
+    // Check required LambdaTest credentials
+    if (!appConfig.lambdatest.username) {
+        errors.push('LAMBDATEST_USERNAME is required');
+    }
+    if (!appConfig.lambdatest.accessKey) {
+        errors.push('LAMBDATEST_ACCESS_KEY is required');
+    }
+    // Validate timeout values
+    if (appConfig.execution.defaultTimeout < 1000) {
+        errors.push('DEFAULT_TIMEOUT must be at least 1000ms');
+    }
+    // Validate retry attempts
+    if (appConfig.execution.maxRetryAttempts < 0 || appConfig.execution.maxRetryAttempts > 5) {
+        errors.push('MAX_RETRY_ATTEMPTS must be between 0 and 5');
+    }
+    if (errors.length > 0) {
+        throw new Error(`App configuration validation failed:\n${errors.join('\n')}`);
+    }
+}
+exports.default = appConfig;
+//# sourceMappingURL=app.config.js.map

package/dist/config/app.config.js.map

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

package/dist/config/llm.config.d.ts

@@ -0,0 +1,63 @@
+export interface LLMConfig {
+    provider: 'ollama' | 'openai' | 'anthropic' | 'custom';
+    connection: {
+        baseUrl: string;
+        timeout: number;
+        retryAttempts: number;
+        retryDelay: number;
+    };
+    model: {
+        name: string;
+        temperature: number;
+        maxTokens: number;
+        topP: number;
+        topK: number;
+        frequencyPenalty: number;
+        presencePenalty: number;
+    };
+    prompt: {
+        systemMessage: string;
+        includeAppContext: boolean;
+        includeUIContext: boolean;
+        maxUIElements: number;
+        maxContextTokens: number;
+        includeReasoningInResponse: boolean;
+        strictJsonMode: boolean;
+    };
+    performance: {
+        cachingEnabled: boolean;
+        cacheTTL: number;
+        batchRequests: boolean;
+        maxBatchSize: number;
+        streamResponse: boolean;
+    };
+    fallback: {
+        enabled: boolean;
+        fallbackModel?: string;
+        maxFallbackAttempts: number;
+    };
+}
+declare const llmConfig: LLMConfig;
+export declare const PromptTemplates: {
+    actionPlanning: string;
+    contextAnalysis: string;
+    errorRecovery: string;
+    assertionGeneration: string;
+};
+export declare function getPromptTemplate(type: keyof typeof PromptTemplates): string;
+export declare function validateLLMConfig(): void;
+export declare function getProviderConfig(provider: string): {
+    endpoint: string;
+    healthEndpoint: string;
+    format: string;
+} | {
+    endpoint: string;
+    healthEndpoint: string;
+    format: string;
+} | {
+    endpoint: string;
+    healthEndpoint: string;
+    format: string;
+};
+export default llmConfig;
+//# sourceMappingURL=llm.config.d.ts.map

package/dist/config/llm.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.config.d.ts","sourceRoot":"","sources":["../../src/config/llm.config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAGvD,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAGF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IAGF,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,0BAA0B,EAAE,OAAO,CAAC;QACpC,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IAGF,WAAW,EAAE;QACX,cAAc,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IAGF,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,QAAA,MAAM,SAAS,EAAE,SA4ChB,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;CAsD3B,CAAC;AAGF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,OAAO,eAAe,GAAG,MAAM,CAE5E;AAGD,wBAAgB,iBAAiB,IAAI,IAAI,CA+BxC;AAGD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;EAoBjD;AAED,eAAe,SAAS,CAAC"}