appium-mcp 1.82.2 → 1.84.0

package/dist/scripts/simple-query-documentation.js

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-/**
- * Simple Documentation Query Script
- *
- * This script is used to test the answerAppiumQuery function
- * by querying the indexed Markdown documentation in the in-memory vector store.
- *
- * Usage: npm run simple-query-docs "your query here"
- *
- * Example: npm run simple-query-docs "What is Appium?"
- */
-import { answerAppiumQuery } from '../tools/documentation/index.js';
-/**
- * Main function to handle the documentation query process
- */
-async function main() {
-    console.log('Using sentence-transformers embeddings (no API key required)');
-    console.log('Note: This script will return relevant documentation chunks without generating responses');
-    console.log('process.argv:', process.argv);
-    const args = process.argv.slice(2);
-    console.log('args:', args);
-    let query;
-    if (args.length > 0) {
-        query = args.join(' ');
-        console.log(`Using provided query: "${query}"`);
-    }
-    else {
-        query = 'What is Appium and how do I get started?';
-        console.log(`No query provided, using default query: "${query}"`);
-    }
-    console.log(`Querying in-memory vector store with: "${query}"`);
-    try {
-        const result = await answerAppiumQuery({
-            query,
-        });
-        console.log('\n--- ANSWER ---\n');
-        console.log(result.answer);
-        if (result.sources && result.sources.length > 0) {
-            console.log('\n--- SOURCES ---\n');
-            result.sources.forEach((source) => {
-                console.log(`- ${source}`);
-            });
-        }
-        process.exit(0);
-    }
-    catch (error) {
-        console.error('Query failed:', error);
-        process.exit(1);
-    }
-}
-void main();
-//# sourceMappingURL=simple-query-documentation.js.map

package/dist/scripts/simple-query-documentation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"simple-query-documentation.js","sourceRoot":"","sources":["../../src/scripts/simple-query-documentation.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CACT,0FAA0F,CAC3F,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3B,IAAI,KAAa,CAAC;IAElB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,0CAA0C,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,4CAA4C,KAAK,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0CAA0C,KAAK,GAAG,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACrC,KAAK;SACN,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAW,EAAE,EAAE;gBACrC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}

package/dist/tests/tools/documentation/appium-skills.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=appium-skills.test.d.ts.map

package/dist/tests/tools/documentation/appium-skills.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"appium-skills.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/tools/documentation/appium-skills.test.ts"],"names":[],"mappings":""}

package/dist/tests/tools/documentation/appium-skills.test.js

@@ -1,106 +0,0 @@
-import { describe, test, expect, jest } from '@jest/globals';
-jest.unstable_mockModule('appium-uiautomator2-driver', () => ({
-    AndroidUiautomator2Driver: class {
-    },
-}));
-jest.unstable_mockModule('appium-xcuitest-driver', () => ({
-    XCUITestDriver: class {
-    },
-}));
-jest.unstable_mockModule('webdriver', () => ({ default: {} }));
-await jest.unstable_mockModule('../../../logger', () => ({
-    default: { debug: () => { }, info: () => { }, warn: () => { }, error: () => { } },
-}));
-const { appiumSkillsTool } = await import('../../../tools/documentation/appium-skills.js');
-function getRegisteredTool() {
-    return appiumSkillsTool;
-}
-async function runTool(args) {
-    const tool = getRegisteredTool();
-    const result = await tool.execute(args, {});
-    expect(tool.name).toBe('appium_skills');
-    expect(result?.content?.[0]?.type).toBe('text');
-    return result.content[0].text;
-}
-function expectOrderedSkills(text, skills) {
-    expect(text).toContain('Recommended skill order:');
-    for (const [index, skill] of skills.entries()) {
-        expect(text).toContain(`${index + 1}. ${skill}`);
-        expect(text).toContain(`--- skills/${skill}/SKILL.md ---`);
-    }
-    expect(text).toContain('--- AGENTS.md ---');
-}
-describe('appium_skills tool contract', () => {
-    test('returns Android UiAutomator2 setup skills in expected order', async () => {
-        const text = await runTool({
-            platform: 'android',
-            driver: 'uiautomator2',
-            mode: 'setup',
-        });
-        expectOrderedSkills(text, [
-            'environment-setup-node',
-            'environment-setup-android',
-            'environment-setup-uiautomator2',
-        ]);
-        expect(text).toContain('Prompt template:');
-    });
-    test('returns iOS XCUITest real-device setup skills including real-device config', async () => {
-        const text = await runTool({
-            platform: 'ios',
-            driver: 'xcuitest',
-            mode: 'setup',
-            realDevice: true,
-        });
-        expectOrderedSkills(text, [
-            'environment-setup-node',
-            'environment-setup-xcuitest',
-            'xcuitest-real-device-config',
-        ]);
-        expect(text).toContain('Real device: yes');
-    });
-    test('returns troubleshooting flow with appium-troubleshooting skill', async () => {
-        const text = await runTool({
-            platform: 'android',
-            driver: 'uiautomator2',
-            mode: 'troubleshoot',
-        });
-        expectOrderedSkills(text, [
-            'environment-setup-node',
-            'environment-setup-android',
-            'environment-setup-uiautomator2',
-            'appium-troubleshooting',
-        ]);
-        expect(text).toContain('Prompt template:');
-    });
-    test('includes optional skills only when applicable and reports ignored ones', async () => {
-        const androidText = await runTool({
-            platform: 'android',
-            driver: 'espresso',
-            mode: 'setup',
-            includeOptional: ['ffmpeg', 'bundletool'],
-        });
-        expectOrderedSkills(androidText, [
-            'environment-setup-node',
-            'environment-setup-android',
-            'environment-setup-espresso',
-            'environment-setup-ffmpeg',
-            'environment-setup-bundletool',
-        ]);
-        const iosText = await runTool({
-            platform: 'ios',
-            driver: 'xcuitest',
-            mode: 'setup',
-            includeOptional: ['bundletool'],
-        });
-        expect(iosText).toContain('Ignored optional skills: bundletool');
-    });
-    test('rejects unsupported troubleshooting driver path', async () => {
-        const tool = getRegisteredTool();
-        await expect(tool.execute({
-            platform: 'android',
-            driver: 'espresso',
-            mode: 'troubleshoot',
-        }, {})).rejects.toThrow('Troubleshooting guidance is currently scoped');
-    });
-});
-//# sourceMappingURL=appium-skills.test.js.map

package/dist/tests/tools/documentation/appium-skills.test.js.map

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

package/dist/tests/tools/documentation/plugin.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=plugin.test.d.ts.map

package/dist/tests/tools/documentation/plugin.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/tools/documentation/plugin.test.ts"],"names":[],"mappings":""}

package/dist/tests/tools/documentation/plugin.test.js

@@ -1,34 +0,0 @@
-import { describe, expect, jest, test } from '@jest/globals';
-jest.unstable_mockModule('appium-uiautomator2-driver', () => ({
-    AndroidUiautomator2Driver: class {
-    },
-}));
-jest.unstable_mockModule('appium-xcuitest-driver', () => ({
-    XCUITestDriver: class {
-    },
-}));
-jest.unstable_mockModule('webdriver', () => ({ default: {} }));
-await jest.unstable_mockModule('../../../logger', () => ({
-    default: { debug: () => { }, info: () => { }, warn: () => { }, error: () => { } },
-}));
-const { AppiumDocumentation } = await import('../../../tools/documentation/plugin.js');
-describe('AppiumDocumentation plugin', () => {
-    test('registers documentation query and skills tools', () => {
-        const tools = [];
-        const registry = {
-            addTool(toolDef) {
-                tools.push(toolDef);
-            },
-        };
-        new AppiumDocumentation().register(registry);
-        expect(tools.map((tool) => tool.name)).toEqual([
-            'appium_documentation_query',
-            'appium_skills',
-        ]);
-        expect(tools[1].annotations).toEqual({
-            readOnlyHint: true,
-            openWorldHint: false,
-        });
-    });
-});
-//# sourceMappingURL=plugin.test.js.map

package/dist/tests/tools/documentation/plugin.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/documentation/plugin.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE7D,IAAI,CAAC,mBAAmB,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5D,yBAAyB,EAAE;KAAQ;CACpC,CAAC,CAAC,CAAC;AACJ,IAAI,CAAC,mBAAmB,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,cAAc,EAAE;KAAQ;CACzB,CAAC,CAAC,CAAC;AACJ,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAE/D,MAAM,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE;CAC9E,CAAC,CAAC,CAAC;AAEJ,MAAM,EAAE,mBAAmB,EAAE,GAC3B,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;AAOzD,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAC1D,MAAM,KAAK,GAAc,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG;YACf,OAAO,CAAC,OAAgB;gBACtB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;SACF,CAAC;QAEF,IAAI,mBAAmB,EAAE,CAAC,QAAQ,CAAC,QAAiB,CAAC,CAAC;QAEtD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7C,4BAA4B;YAC5B,eAAe;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YACnC,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/tools/documentation/simple-pdf-indexer.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=simple-pdf-indexer.test.d.ts.map

package/dist/tests/tools/documentation/simple-pdf-indexer.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"simple-pdf-indexer.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/tools/documentation/simple-pdf-indexer.test.ts"],"names":[],"mappings":""}

package/dist/tests/tools/documentation/simple-pdf-indexer.test.js

@@ -1,46 +0,0 @@
-import { afterEach, describe, expect, jest, test } from '@jest/globals';
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-await jest.unstable_mockModule('../../../logger', () => ({
-    default: { debug: () => { }, info: () => { }, warn: () => { }, error: () => { } },
-}));
-const { getMarkdownFilesInDirectory } = await import('../../../tools/documentation/simple-pdf-indexer.js');
-const tempDirs = [];
-afterEach(() => {
-    while (tempDirs.length > 0) {
-        const dir = tempDirs.pop();
-        if (dir) {
-            fs.rmSync(dir, { recursive: true, force: true });
-        }
-    }
-});
-function makeTempDir() {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'appium-mcp-markdown-'));
-    tempDirs.push(dir);
-    return dir;
-}
-describe('getMarkdownFilesInDirectory', () => {
-    test('excludes markdown files under appium-skills', async () => {
-        const root = makeTempDir();
-        const docsDir = path.join(root, 'docs');
-        const skillsDir = path.join(root, 'appium-skills');
-        const nestedSkillsDir = path.join(skillsDir, 'skills');
-        fs.mkdirSync(docsDir, { recursive: true });
-        fs.mkdirSync(nestedSkillsDir, { recursive: true });
-        fs.writeFileSync(path.join(root, 'README.md'), '# root');
-        fs.writeFileSync(path.join(docsDir, 'guide.md'), '# docs');
-        fs.writeFileSync(path.join(skillsDir, 'AGENTS.md'), '# agents');
-        fs.writeFileSync(path.join(nestedSkillsDir, 'SKILL.md'), '# skill');
-        const markdownFiles = await getMarkdownFilesInDirectory(root);
-        expect(markdownFiles).toEqual(expect.arrayContaining([
-            path.join(root, 'README.md'),
-            path.join(docsDir, 'guide.md'),
-        ]));
-        expect(markdownFiles).not.toEqual(expect.arrayContaining([
-            path.join(skillsDir, 'AGENTS.md'),
-            path.join(nestedSkillsDir, 'SKILL.md'),
-        ]));
-    });
-});
-//# sourceMappingURL=simple-pdf-indexer.test.js.map

package/dist/tests/tools/documentation/simple-pdf-indexer.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"simple-pdf-indexer.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/documentation/simple-pdf-indexer.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/documentation/answer-appium.d.ts

@@ -1,8 +0,0 @@
-/**
- * Tool to query indexed Appium documentation.
- */
-import type { FastMCP } from 'fastmcp';
-type ToolDef = Parameters<FastMCP['addTool']>[0];
-export declare const appiumDocumentationQueryTool: ToolDef;
-export {};
-//# sourceMappingURL=answer-appium.d.ts.map

package/dist/tools/documentation/answer-appium.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"answer-appium.d.ts","sourceRoot":"","sources":["../../../src/tools/documentation/answer-appium.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjD,eAAO,MAAM,4BAA4B,EAAE,OAmC1C,CAAC"}

package/dist/tools/documentation/answer-appium.js

@@ -1,38 +0,0 @@
-import { z } from 'zod';
-import { answerAppiumQuery, initializeAppiumDocumentation } from './index.js';
-import log from '../../logger.js';
-import { errorResult, textResult } from '../tool-response.js';
-export const appiumDocumentationQueryTool = {
-    name: 'appium_documentation_query',
-    description: `Query Appium documentation using RAG (Retrieval-Augmented Generation).
-      This tool searches through indexed Appium documentation to answer questions about Appium features, setup, configuration, drivers, and usage.
-      `,
-    parameters: z.object({
-        query: z
-            .string()
-            .describe('The question or query about Appium documentation'),
-    }),
-    execute: async (args, _context) => {
-        const query = args.query;
-        if (!query) {
-            return errorResult('Query parameter is required');
-        }
-        try {
-            const result = await answerAppiumQuery({ query });
-            return textResult(result.answer);
-        }
-        catch (_docError) {
-            // If documentation query fails, try to initialize and retry once
-            try {
-                log.info('Documentation not initialized, initializing now...');
-                await initializeAppiumDocumentation();
-                const result = await answerAppiumQuery({ query });
-                return textResult(result.answer);
-            }
-            catch (retryError) {
-                return errorResult(`Error querying Appium documentation: ${retryError.message}. Please ensure the documentation is indexed first.`);
-            }
-        }
-    },
-};
-//# sourceMappingURL=answer-appium.js.map

package/dist/tools/documentation/answer-appium.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"answer-appium.js","sourceRoot":"","sources":["../../../src/tools/documentation/answer-appium.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI9D,MAAM,CAAC,MAAM,4BAA4B,GAAY;IACnD,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE;;OAER;IACL,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,kDAAkD,CAAC;KAChE,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,QAAa,EAAgB,EAAE;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,6BAA6B,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,iEAAiE;YACjE,IAAI,CAAC;gBACH,GAAG,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;gBAC/D,MAAM,6BAA6B,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClD,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,OAAO,WAAW,CAChB,wCACG,UAAoB,CAAC,OACxB,qDAAqD,CACtD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documentation/appium-skills.d.ts

@@ -1,5 +0,0 @@
-import type { FastMCP } from 'fastmcp';
-type ToolDef = Parameters<FastMCP['addTool']>[0];
-export declare const appiumSkillsTool: ToolDef;
-export {};
-//# sourceMappingURL=appium-skills.d.ts.map

package/dist/tools/documentation/appium-skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"appium-skills.d.ts","sourceRoot":"","sources":["../../../src/tools/documentation/appium-skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAUvC,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAkCjD,eAAO,MAAM,gBAAgB,EAAE,OAqG9B,CAAC"}

package/dist/tools/documentation/appium-skills.js

@@ -1,168 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import path from 'node:path';
-import { z } from 'zod';
-import log from '../../logger.js';
-import { resolveAppiumResourcesPath } from '../../utils/paths.js';
-import { textResult } from '../tool-response.js';
-const ROOT = resolveAppiumResourcesPath('submodules', 'appium-skills');
-const AGENTS_PATH = path.join(ROOT, 'AGENTS.md');
-const SKILL_PATH = (name) => path.join(ROOT, 'skills', name, 'SKILL.md');
-const SETUP_SKILLS = {
-    android: {
-        uiautomator2: [
-            'environment-setup-node',
-            'environment-setup-android',
-            'environment-setup-uiautomator2',
-        ],
-        espresso: [
-            'environment-setup-node',
-            'environment-setup-android',
-            'environment-setup-espresso',
-        ],
-    },
-    ios: {
-        xcuitest: ['environment-setup-node', 'environment-setup-xcuitest'],
-    },
-};
-const TEMPLATE_HEADINGS = {
-    'setup:uiautomator2': 'UiAutomator2',
-    'setup:espresso': 'Espresso',
-    'setup:xcuitest': 'XCUITest',
-    'setup:xcuitest:real': 'XCUITest Real Device',
-    'troubleshoot:uiautomator2': 'Troubleshooting',
-    'troubleshoot:xcuitest': 'Troubleshooting',
-};
-export const appiumSkillsTool = {
-    name: 'appium_skills',
-    description: `Return ordered Appium setup or troubleshooting skills from the vendored appium/skills repository.
-      Use this before preparing a LOCAL Appium environment or diagnosing local prerequisite issues.`,
-    parameters: z.object({
-        platform: z.enum(['android', 'ios']).describe('Target local platform.'),
-        driver: z
-            .enum(['uiautomator2', 'espresso', 'xcuitest'])
-            .describe('Target Appium automation driver.'),
-        mode: z
-            .enum(['setup', 'troubleshoot'])
-            .optional()
-            .default('setup')
-            .describe('Whether to prepare an environment or troubleshoot an existing failure.'),
-        realDevice: z
-            .boolean()
-            .optional()
-            .default(false)
-            .describe('For ios + xcuitest only: true for a physical device, false for simulator setup.'),
-        includeOptional: z
-            .array(z.enum(['ffmpeg', 'bundletool']))
-            .optional()
-            .default([])
-            .describe('Optional shared skills to include when explicitly requested.'),
-    }),
-    annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-    },
-    execute: async (rawArgs) => {
-        const parsed = (rawArgs ?? {});
-        const args = {
-            platform: parsed.platform,
-            driver: parsed.driver,
-            mode: parsed.mode ?? 'setup',
-            realDevice: parsed.realDevice ?? false,
-            includeOptional: Array.isArray(parsed.includeOptional)
-                ? parsed.includeOptional
-                : [],
-        };
-        const { skillNames, ignoredOptional } = getSkillNames(args);
-        log.info(`Loading Appium skills for ${args.platform}/${args.driver} (${args.mode}) from ${ROOT}`);
-        const agentsMarkdown = await readMarkdown(AGENTS_PATH);
-        const promptTemplate = getPromptTemplate(agentsMarkdown, getTemplateHeading(args.mode, args.driver, args.realDevice));
-        const skillContents = await Promise.all(skillNames.map(async (skillName) => ({
-            name: skillName,
-            markdown: await readMarkdown(SKILL_PATH(skillName)),
-        })));
-        const lines = [
-            `Appium skills for ${args.platform}/${args.driver}`,
-            `Mode: ${args.mode}`,
-            `Real device: ${args.realDevice ? 'yes' : 'no'}`,
-            '',
-            'Recommended skill order:',
-            ...skillNames.map((skillName, index) => `${index + 1}. ${skillName}`),
-        ];
-        if (ignoredOptional.length) {
-            lines.push('', `Ignored optional skills: ${ignoredOptional.join(', ')}`);
-        }
-        lines.push('', 'Source files:', '- AGENTS.md');
-        lines.push(...skillNames.map((skillName) => `- skills/${skillName}/SKILL.md`));
-        if (promptTemplate) {
-            lines.push('', 'Prompt template:', '```text', promptTemplate, '```');
-        }
-        lines.push('', '--- AGENTS.md ---', agentsMarkdown.trim());
-        for (const skill of skillContents) {
-            lines.push('', `--- skills/${skill.name}/SKILL.md ---`, skill.markdown.trim());
-        }
-        return textResult(lines.join('\n'));
-    },
-};
-/**
- * Get the list of skill names to return based on the input arguments,
- * and determine which optional skills were ignored.
- * @param args
- * @returns
- */
-function getSkillNames(args) {
-    const { platform, driver, mode, realDevice, includeOptional } = args;
-    if (realDevice && platform !== 'ios') {
-        throw new Error('realDevice=true is only supported for ios targets');
-    }
-    if (mode === 'troubleshoot' && driver === 'espresso') {
-        throw new Error('Troubleshooting guidance is currently scoped to uiautomator2 or xcuitest, matching the upstream appium/skills repository.');
-    }
-    const baseSkills = SETUP_SKILLS[platform][driver];
-    if (!baseSkills) {
-        throw new Error(platform === 'android'
-            ? 'xcuitest is only valid for iOS local environments'
-            : 'Only xcuitest is valid for iOS local environments');
-    }
-    const skillNames = [...baseSkills];
-    if (realDevice) {
-        skillNames.push('xcuitest-real-device-config');
-    }
-    if (mode === 'troubleshoot') {
-        skillNames.push('appium-troubleshooting');
-    }
-    const ignoredOptional = [];
-    for (const optional of includeOptional) {
-        if (optional === 'ffmpeg') {
-            skillNames.push('environment-setup-ffmpeg');
-            continue;
-        }
-        if (optional === 'bundletool' && platform === 'android') {
-            skillNames.push('environment-setup-bundletool');
-            continue;
-        }
-        ignoredOptional.push(optional);
-    }
-    return { skillNames, ignoredOptional };
-}
-function getTemplateHeading(mode, driver, realDevice) {
-    return (TEMPLATE_HEADINGS[`${mode}:${driver}${realDevice && mode === 'setup' ? ':real' : ''}`] ?? null);
-}
-function getPromptTemplate(agentsMarkdown, heading) {
-    if (!heading) {
-        return null;
-    }
-    const section = agentsMarkdown.split(`### Template: ${heading}\n`)[1];
-    if (!section) {
-        return null;
-    }
-    return section.match(/```text\n([\s\S]*?)```/)?.[1]?.trim() ?? null;
-}
-async function readMarkdown(filePath) {
-    try {
-        return await readFile(filePath, 'utf8');
-    }
-    catch {
-        throw new Error(`Failed to load ${path.relative(ROOT, filePath)}. Ensure the appium-skills submodule is initialized.`);
-    }
-}
-//# sourceMappingURL=appium-skills.js.map

package/dist/tools/documentation/appium-skills.js.map

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

package/dist/tools/documentation/index.d.ts

@@ -1,29 +0,0 @@
-/**
- * Documentation tools for Appium
- *
- * This module provides tools for answering queries about Appium
- * by retrieving relevant information from indexed documentation.
- */
-/**
- * Interface for the query response
- */
-interface QueryResponse {
-    answer: string;
-    sources?: string[];
-    chunks?: string[];
-}
-/**
- * Initialize the Appium documentation index
- * @param resourcesPath Path to the resources directory containing markdown files
- */
-export declare function initializeAppiumDocumentation(resourcesPath?: string): Promise<void>;
-/**
- * Answer a query about Appium using indexed documentation
- * @param options Query options
- * @returns Response with relevant chunks for the client LLM to process
- */
-export declare function answerAppiumQuery(options: {
-    query: string;
-}): Promise<QueryResponse>;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/tools/documentation/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/documentation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,aAAa,CAAC,CA+CzB"}

package/dist/tools/documentation/index.js

@@ -1,66 +0,0 @@
-/**
- * Documentation tools for Appium
- *
- * This module provides tools for answering queries about Appium
- * by retrieving relevant information from indexed documentation.
- */
-import { queryVectorStore, indexAllMarkdownFiles, } from './simple-pdf-indexer.js';
-import log from '../../logger.js';
-import { resolveAppiumResourcesPath } from '../../utils/paths.js';
-/**
- * Initialize the Appium documentation index
- * @param resourcesPath Path to the resources directory containing markdown files
- */
-export async function initializeAppiumDocumentation(resourcesPath) {
-    try {
-        // Default to submodules directory if not specified
-        const docsPath = 
-        // Refer to the /src/resources/submodules directory where the markdown files are located.
-        resourcesPath || resolveAppiumResourcesPath('submodules');
-        log.info(`Initializing Appium documentation from: ${docsPath}`);
-        await indexAllMarkdownFiles(docsPath);
-        log.info('Appium documentation indexing completed');
-    }
-    catch (error) {
-        log.error('Error initializing Appium documentation:', error);
-        throw error;
-    }
-}
-/**
- * Answer a query about Appium using indexed documentation
- * @param options Query options
- * @returns Response with relevant chunks for the client LLM to process
- */
-export async function answerAppiumQuery(options) {
-    try {
-        const { query } = options;
-        log.info(`Querying vector store for: "${query}"`);
-        const results = await queryVectorStore(query); // Get relevant chunks
-        if (!results || results.length === 0) {
-            return {
-                answer: 'No relevant information found in the Appium documentation. Please try rephrasing your query.',
-                chunks: [],
-            };
-        }
-        // Extract the content from all retrieved documents
-        const chunks = results.map((doc) => doc.pageContent);
-        const sources = results
-            .map((doc) => doc.metadata?.relativePath ||
-            doc.metadata?.filename ||
-            doc.metadata?.source)
-            .filter((source, index, arr) => source && arr.indexOf(source) === index); // Remove duplicates
-        log.info(`Found ${results.length} relevant chunks from ${sources.length} sources`);
-        // Return the chunks for the client LLM to process
-        // The client will use its own LLM to generate the final answer
-        return {
-            answer: `Found ${results.length} relevant documentation chunks. Here are the relevant sections:\n\n${chunks.join('\n\n---\n\n')}`,
-            sources,
-            chunks,
-        };
-    }
-    catch (error) {
-        log.error('Error querying Appium documentation:', error);
-        throw error;
-    }
-}
-//# sourceMappingURL=index.js.map