@mseep/ai-tech-app-agent 1.0.0

package/dist/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const logger_1 = __importDefault(require("./utils/logger"));
+const aiTestRunner_1 = __importDefault(require("./orchestrator/aiTestRunner"));
+dotenv_1.default.config();
+const program = new commander_1.Command();
+program
+    .name('ai-test-runner')
+    .description('AI-powered mobile test automation using MCP and LLM')
+    .version('1.0.0');
+program
+    .command('run')
+    .description('Run AI-powered test specs')
+    .argument('<spec-path>', 'Path to test spec file or directory')
+    .option('-s, --session-id <id>', 'Existing Appium session ID')
+    .option('-k, --knowledge <path>', 'Path to app knowledge file')
+    .option('-o, --output <path>', 'Output path for test report', './reports/test-report.json')
+    .action(async (specPath, options) => {
+    try {
+        logger_1.default.info('Starting AI Test Runner...');
+        logger_1.default.info(`Spec path: ${specPath}`);
+        const runner = new aiTestRunner_1.default();
+        // Load app knowledge if provided
+        if (options.knowledge) {
+            await runner.loadAppKnowledge(options.knowledge);
+        }
+        const results = [];
+        // Check if spec path is a file or directory
+        const stats = fs_1.default.statSync(specPath);
+        if (stats.isDirectory()) {
+            // Run all specs in directory
+            const files = fs_1.default.readdirSync(specPath)
+                .filter(f => f.endsWith('.yaml') || f.endsWith('.yml') || f.endsWith('.json'))
+                .map(f => path_1.default.join(specPath, f));
+            logger_1.default.info(`Found ${files.length} test spec(s) in directory`);
+            for (const file of files) {
+                const result = await runner.runTestSpec(file, options.sessionId);
+                results.push(result);
+            }
+        }
+        else {
+            // Run single spec
+            const result = await runner.runTestSpec(specPath, options.sessionId);
+            results.push(result);
+        }
+        // Generate report
+        await runner.generateReport(results, options.output);
+        // Print summary
+        console.log('\n' + '='.repeat(60));
+        console.log('TEST EXECUTION SUMMARY');
+        console.log('='.repeat(60));
+        const passed = results.filter(r => r.status === 'passed').length;
+        const failed = results.filter(r => r.status === 'failed').length;
+        const total = results.length;
+        console.log(`Total Tests: ${total}`);
+        console.log(`Passed: ${passed}`);
+        console.log(`Failed: ${failed}`);
+        console.log(`Success Rate: ${((passed / total) * 100).toFixed(2)}%`);
+        console.log('='.repeat(60) + '\n');
+        // Exit with appropriate code
+        process.exit(failed > 0 ? 1 : 0);
+    }
+    catch (error) {
+        logger_1.default.error(`Test execution failed: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('validate')
+    .description('Validate test spec file(s)')
+    .argument('<spec-path>', 'Path to test spec file or directory')
+    .action((specPath) => {
+    try {
+        const stats = fs_1.default.statSync(specPath);
+        const files = stats.isDirectory()
+            ? fs_1.default.readdirSync(specPath)
+                .filter(f => f.endsWith('.yaml') || f.endsWith('.yml') || f.endsWith('.json'))
+                .map(f => path_1.default.join(specPath, f))
+            : [specPath];
+        let valid = 0;
+        let invalid = 0;
+        files.forEach(file => {
+            try {
+                const content = fs_1.default.readFileSync(file, 'utf-8');
+                const ext = path_1.default.extname(file).toLowerCase();
+                if (ext === '.json') {
+                    JSON.parse(content);
+                }
+                else {
+                    // For YAML, we'd need to validate structure
+                    // This is a basic check
+                }
+                console.log(`✓ ${file} - Valid`);
+                valid++;
+            }
+            catch (error) {
+                console.error(`✗ ${file} - Invalid: ${error.message}`);
+                invalid++;
+            }
+        });
+        console.log(`\nValidation complete: ${valid} valid, ${invalid} invalid`);
+        process.exit(invalid > 0 ? 1 : 0);
+    }
+    catch (error) {
+        console.error(`Validation failed: ${error.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('health')
+    .description('Check health of LLM and MCP components')
+    .action(async () => {
+    try {
+        const runner = new aiTestRunner_1.default();
+        console.log('Checking LLM health...');
+        const llamaClient = new (await Promise.resolve().then(() => __importStar(require('./llm/llamaClient')))).default();
+        const llmHealthy = await llamaClient.healthCheck();
+        if (llmHealthy) {
+            console.log('✓ LLM is healthy');
+        }
+        else {
+            console.error('✗ LLM is not available');
+        }
+        // Add MCP health check here if needed
+        process.exit(llmHealthy ? 0 : 1);
+    }
+    catch (error) {
+        console.error(`Health check failed: ${error.message}`);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/llm/llamaClient.d.ts

@@ -0,0 +1,14 @@
+import { ActionPlan } from '../models/testSpec';
+export declare class LlamaClient {
+    private client;
+    private model;
+    private temperature;
+    private maxTokens;
+    constructor();
+    generateActionPlan(stepText: string, uiContext: string, appKnowledge?: string): Promise<ActionPlan>;
+    private buildPrompt;
+    private parseActionPlan;
+    healthCheck(): Promise<boolean>;
+}
+export default LlamaClient;
+//# sourceMappingURL=llamaClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llamaClient.d.ts","sourceRoot":"","sources":["../../src/llm/llamaClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;;IAmBpB,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,CAAC;IA+BtB,OAAO,CAAC,WAAW;IA6CnB,OAAO,CAAC,eAAe;IA4BjB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAkBtC;AAED,eAAe,WAAW,CAAC"}

package/dist/llm/llamaClient.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlamaClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const logger_1 = __importDefault(require("../utils/logger"));
+dotenv_1.default.config();
+class LlamaClient {
+    constructor() {
+        const baseURL = process.env.OLLAMA_BASE_URL || 'http://localhost:11434';
+        this.model = process.env.LLM_MODEL || 'llama3.2:3b';
+        this.temperature = parseFloat(process.env.LLM_TEMPERATURE || '0.1');
+        this.maxTokens = parseInt(process.env.LLM_MAX_TOKENS || '2000');
+        this.client = axios_1.default.create({
+            baseURL,
+            timeout: 60000,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        logger_1.default.info(`LlamaClient initialized with model: ${this.model}`);
+    }
+    async generateActionPlan(stepText, uiContext, appKnowledge) {
+        const prompt = this.buildPrompt(stepText, uiContext, appKnowledge);
+        try {
+            logger_1.default.debug(`Sending prompt to LLM for step: "${stepText}"`);
+            const response = await this.client.post('/api/generate', {
+                model: this.model,
+                prompt,
+                stream: false,
+                options: {
+                    temperature: this.temperature,
+                    num_predict: this.maxTokens,
+                },
+                format: 'json', // Request JSON output
+            });
+            const rawResponse = response.data.response;
+            logger_1.default.debug(`LLM raw response: ${rawResponse}`);
+            // Parse the JSON response
+            const actionPlan = this.parseActionPlan(rawResponse);
+            logger_1.default.info(`Generated ${actionPlan.actions.length} actions for step`);
+            return actionPlan;
+        }
+        catch (error) {
+            logger_1.default.error(`Error generating action plan: ${error.message}`);
+            throw new Error(`LLM generation failed: ${error.message}`);
+        }
+    }
+    buildPrompt(stepText, uiContext, appKnowledge) {
+        return `You are an expert mobile test automation agent. Your task is to generate precise Appium actions to accomplish a test step.
+
+**App Context:**
+${appKnowledge || 'A mobile application with standard Android/iOS UI patterns.'}
+
+**Current UI State:**
+${uiContext}
+
+**Test Step to Execute:**
+"${stepText}"
+
+**Instructions:**
+1. Analyze the current UI state carefully
+2. Identify the most reliable element selectors (prefer text, accessibility-id, or resource-id over XPath)
+3. Generate a sequence of actions to accomplish the test step
+4. Minimize screenshot-based coordinate selection - use it only as last resort
+5. Ensure actions are reliable across different device sizes
+
+**Output Format (JSON only, no markdown):**
+{
+  "actions": [
+    {
+      "type": "tap|type|scroll|swipe|wait|assert",
+      "selector": {
+        "strategy": "text|id|accessibility-id|xpath|class",
+        "value": "selector_value",
+        "index": 0
+      },
+      "value": "text_to_type (only for type action)",
+      "direction": "up|down|left|right (only for scroll/swipe)",
+      "assertionType": "exists|visible|text|enabled (only for assert)",
+      "expectedValue": "expected_value (only for assert)"
+    }
+  ],
+  "reasoning": "Brief explanation of the action sequence"
+}
+
+Generate the JSON action plan now:`;
+    }
+    parseActionPlan(rawResponse) {
+        try {
+            // Remove any markdown code blocks if present
+            let cleanedResponse = rawResponse
+                .replace(/```json\n?/g, '')
+                .replace(/```\n?/g, '')
+                .trim();
+            const parsed = JSON.parse(cleanedResponse);
+            // Validate the structure
+            if (!parsed.actions || !Array.isArray(parsed.actions)) {
+                throw new Error('Invalid action plan structure: missing actions array');
+            }
+            return parsed;
+        }
+        catch (error) {
+            logger_1.default.error(`Failed to parse action plan: ${error.message}`);
+            logger_1.default.error(`Raw response: ${rawResponse}`);
+            // Return a fallback empty action plan
+            return {
+                actions: [],
+                reasoning: `Parsing failed: ${error.message}`,
+            };
+        }
+    }
+    async healthCheck() {
+        try {
+            const response = await this.client.get('/api/tags');
+            const models = response.data.models || [];
+            const modelExists = models.some((m) => m.name === this.model);
+            if (!modelExists) {
+                logger_1.default.warn(`Model ${this.model} not found in Ollama. Available models: ${models.map((m) => m.name).join(', ')}`);
+                return false;
+            }
+            logger_1.default.info('LLM health check passed');
+            return true;
+        }
+        catch (error) {
+            logger_1.default.error(`LLM health check failed: ${error.message}`);
+            return false;
+        }
+    }
+}
+exports.LlamaClient = LlamaClient;
+exports.default = LlamaClient;
+//# sourceMappingURL=llamaClient.js.map

package/dist/llm/llamaClient.js.map

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

package/dist/mcp/mcpClient.d.ts

@@ -0,0 +1,132 @@
+import { Action, UIContext } from '../models/testSpec';
+export declare class MCPClient {
+    private mcpProcess;
+    private sessionId;
+    private appiumServerUrl;
+    private appiumClient;
+    private xmlParser;
+    private platform;
+    constructor(sessionId?: string);
+    /**
+     * Initialize MCP server and establish connection
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start MCP server process (if using stdio)
+     */
+    private startMCPProcess;
+    /**
+     * Verify Appium server connection
+     */
+    private verifyAppiumConnection;
+    /**
+     * Create a new Appium session with device capabilities
+     */
+    private createSession;
+    /**
+     * Detect platform from capabilities
+     */
+    private detectPlatformFromCapabilities;
+    /**
+     * Set the active Appium session ID
+     */
+    setSessionId(sessionId: string, platform?: 'android' | 'ios'): void;
+    /**
+     * Get current UI context (page source + parsed elements)
+     */
+    getUIContext(): Promise<UIContext>;
+    /**
+     * Get page source (XML hierarchy)
+     */
+    private getPageSource;
+    /**
+     * Get current activity (Android) or current view (iOS)
+     */
+    private getCurrentActivity;
+    /**
+     * Get current package (Android only)
+     */
+    private getCurrentPackage;
+    /**
+     * Detect platform from session capabilities
+     */
+    private detectPlatform;
+    /**
+     * Detect platform from page source XML
+     */
+    private detectPlatformFromPageSource;
+    /**
+     * Parse UI elements from XML page source
+     */
+    private parseUIElements;
+    /**
+     * Recursively extract elements from parsed XML
+     */
+    private extractElementsRecursive;
+    /**
+     * Filter elements based on configuration
+     */
+    private filterElements;
+    /**
+     * Execute an action
+     */
+    executeAction(action: Action): Promise<boolean>;
+    /**
+     * Tap/click on an element
+     */
+    private tap;
+    /**
+     * Type text into an element
+     */
+    private type;
+    /**
+     * Scroll the screen
+     */
+    private scroll;
+    /**
+     * Swipe gesture
+     */
+    private swipe;
+    /**
+     * Perform swipe gesture using touch actions
+     */
+    private performSwipeGesture;
+    /**
+     * Wait for duration or element
+     */
+    private wait;
+    /**
+     * Assert element state
+     */
+    private assert;
+    /**
+     * Launch an app or return to home screen
+     */
+    private launch;
+    /**
+     * Take screenshot
+     */
+    private screenshot;
+    /**
+     * Find element using selector
+     */
+    private findElement;
+    /**
+     * Get screen size
+     */
+    private getScreenSize;
+    /**
+     * Delay helper
+     */
+    private delay;
+    /**
+     * Stop the current Appium session
+     */
+    stopSession(): Promise<void>;
+    /**
+     * Cleanup and shutdown
+     */
+    cleanup(): Promise<void>;
+}
+export default MCPClient;
+//# sourceMappingURL=mcpClient.d.ts.map

package/dist/mcp/mcpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpClient.d.ts","sourceRoot":"","sources":["../../src/mcp/mcpClient.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAuB,MAAM,oBAAoB,CAAC;AAE5E,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAkC;gBAEtC,SAAS,CAAC,EAAE,MAAM;IAwB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBjC;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,sBAAsB;IAUpC;;OAEG;YACW,aAAa;IAmF3B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAKtC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI;IAMnE;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAuCxC;;OAEG;YACW,aAAa;IAU3B;;OAEG;YACW,kBAAkB;IAoBhC;;OAEG;YACW,iBAAiB;IAY/B;;OAEG;YACW,cAAc;IAmB5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAOpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwChC;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCrD;;OAEG;YACW,GAAG;IA2BjB;;OAEG;YACW,IAAI;IAiClB;;OAEG;YACW,MAAM;IAsBpB;;OAEG;YACW,KAAK;IAmDnB;;OAEG;YACW,mBAAmB;IAmBjC;;OAEG;YACW,IAAI;IAQlB;;OAEG;YACW,MAAM;IAwCpB;;OAEG;YACW,MAAM;IAoCpB;;OAEG;YACW,UAAU;IA2BxB;;OAEG;YACW,WAAW;IAqDzB;;OAEG;YACW,aAAa;IAc3B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAelC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B;AAED,eAAe,SAAS,CAAC"}