@appium/mcp-documentation 1.0.0

package/dist/index.js

@@ -0,0 +1,69 @@
+/**
+ * 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 './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;
+    }
+}
+export { appiumDocumentationQueryTool } from './answer-appium.js';
+export { appiumSkillsTool } from './appium-skills.js';
+export { AppiumDocumentation } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAWxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,aAAsB;IAEtB,IAAI,CAAC;QACH,mDAAmD;QACnD,MAAM,QAAQ;QACZ,yFAAyF;QACzF,aAAa,IAAI,0BAA0B,CAAC,YAAY,CAAC,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,2CAA2C,QAAQ,EAAE,CAAC,CAAC;QAChE,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAEvC;IACC,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,+BAA+B,KAAK,GAAG,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB;QAErE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,MAAM,EACJ,8FAA8F;gBAChG,MAAM,EAAE,EAAE;aACX,CAAC;QACJ,CAAC;QAED,mDAAmD;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,OAAO;aACpB,GAAG,CACF,CAAC,GAAQ,EAAE,EAAE,CACX,GAAG,CAAC,QAAQ,EAAE,YAAY;YAC1B,GAAG,CAAC,QAAQ,EAAE,QAAQ;YACtB,GAAG,CAAC,QAAQ,EAAE,MAAM,CACvB;aACA,MAAM,CACL,CAAC,MAAW,EAAE,KAAa,EAAE,GAAU,EAAE,EAAE,CACzC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,CAC1C,CAAC,CAAC,oBAAoB;QAEzB,GAAG,CAAC,IAAI,CACN,SAAS,OAAO,CAAC,MAAM,yBAAyB,OAAO,CAAC,MAAM,UAAU,CACzE,CAAC;QAEF,kDAAkD;QAClD,+DAA+D;QAC/D,OAAO;YACL,MAAM,EAAE,SACN,OAAO,CAAC,MACV,sEAAsE,MAAM,CAAC,IAAI,CAC/E,aAAa,CACd,EAAE;YACH,OAAO;YACP,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,4 @@
+declare const log: import("@appium/types").AppiumLogger;
+export default log;
+export { log };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,GAAG,sCAA+C,CAAC;AAEzD,eAAe,GAAG,CAAC;AACnB,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/logger.js

@@ -0,0 +1,5 @@
+import { logger } from '@appium/support';
+const log = logger.getLogger('appium-mcp-documentation');
+export default log;
+export { log };
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;AAEzD,eAAe,GAAG,CAAC;AACnB,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/markdown-header-splitter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Header-aware Markdown splitter (hybrid approach).
+ *
+ * The TS `@langchain/textsplitters` package only ships `MarkdownTextSplitter`,
+ * which is `RecursiveCharacterTextSplitter` with Markdown-priority separators —
+ * it is *greedy* and merges across topical boundaries when chunks are small.
+ *
+ * For Appium's header-dense docs (2098 h2 + 2263 h3 across 178 files; 92% of
+ * h2/h3 sections fit under 1000 chars), splitting on headers first preserves
+ * topical boundaries. We then:
+ *   - Coalesce short adjacent sections so embeddings aren't computed on tiny
+ *     (~50-token) chunks where vector quality degrades.
+ *   - Recursively split sections that exceed `chunkSize` (e.g. long capability
+ *     reference tables, big code dumps).
+ *   - Prepend a header breadcrumb (`# Page > ## Section > ### Subsection`) to
+ *     every chunk so the embedding sees topical context even when the body
+ *     is recursive-split into mid-paragraph fragments.
+ *
+ * Files with no headers (or only an h1) fall through to a single recursive
+ * split of the whole body - no different from plain RCT for those.
+ */
+import { Document } from '@langchain/core/documents';
+export interface MarkdownHeaderSplitterOptions {
+    chunkSize: number;
+    chunkOverlap: number;
+}
+/**
+ * Split a single Markdown document into chunks using header-aware hybrid logic.
+ * See module docstring for the algorithm summary.
+ */
+export declare function splitMarkdownByHeaders(markdown: string, options: MarkdownHeaderSplitterOptions): Promise<Document[]>;
+//# sourceMappingURL=markdown-header-splitter.d.ts.map

package/dist/markdown-header-splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-header-splitter.d.ts","sourceRoot":"","sources":["../src/markdown-header-splitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAyErB"}

package/dist/markdown-header-splitter.js

@@ -0,0 +1,180 @@
+/**
+ * Header-aware Markdown splitter (hybrid approach).
+ *
+ * The TS `@langchain/textsplitters` package only ships `MarkdownTextSplitter`,
+ * which is `RecursiveCharacterTextSplitter` with Markdown-priority separators —
+ * it is *greedy* and merges across topical boundaries when chunks are small.
+ *
+ * For Appium's header-dense docs (2098 h2 + 2263 h3 across 178 files; 92% of
+ * h2/h3 sections fit under 1000 chars), splitting on headers first preserves
+ * topical boundaries. We then:
+ *   - Coalesce short adjacent sections so embeddings aren't computed on tiny
+ *     (~50-token) chunks where vector quality degrades.
+ *   - Recursively split sections that exceed `chunkSize` (e.g. long capability
+ *     reference tables, big code dumps).
+ *   - Prepend a header breadcrumb (`# Page > ## Section > ### Subsection`) to
+ *     every chunk so the embedding sees topical context even when the body
+ *     is recursive-split into mid-paragraph fragments.
+ *
+ * Files with no headers (or only an h1) fall through to a single recursive
+ * split of the whole body - no different from plain RCT for those.
+ */
+import { Document } from '@langchain/core/documents';
+import { RecursiveCharacterTextSplitter } from '@langchain/textsplitters';
+const HEADER_RE = /^(#{1,6})\s+(.+?)\s*$/;
+const FENCE_RE = /^\s{0,3}(```|~~~)/;
+/**
+ * Split a single Markdown document into chunks using header-aware hybrid logic.
+ * See module docstring for the algorithm summary.
+ */
+export async function splitMarkdownByHeaders(markdown, options) {
+    const { chunkSize, chunkOverlap } = options;
+    const sections = parseSections(markdown);
+    // Fallback splitter for sections that exceed chunkSize on their own.
+    // Reserve some room for the breadcrumb so the final chunk text still fits.
+    const recursive = new RecursiveCharacterTextSplitter({
+        chunkSize,
+        chunkOverlap,
+        keepSeparator: true,
+    });
+    const chunks = [];
+    // `buffer` holds rendered section texts (each with its own breadcrumb) that
+    // we plan to coalesce. We flush when adding the next section would overflow.
+    const buffer = [];
+    let bufferSize = 0;
+    const flushBuffer = () => {
+        if (buffer.length === 0) {
+            return;
+        }
+        const text = buffer.map(renderSection).join('\n\n');
+        chunks.push(new Document({
+            pageContent: text,
+            metadata: {
+                headerPath: breadcrumbFor(buffer[0].headerStack),
+                sectionCount: buffer.length,
+            },
+        }));
+        buffer.length = 0;
+        bufferSize = 0;
+    };
+    for (const section of sections) {
+        const rendered = renderSection(section);
+        if (rendered.length > chunkSize) {
+            // Section is too big to live in any single chunk: flush whatever we had
+            // buffered, then recursive-split this section's body, prepending the
+            // breadcrumb to each sub-chunk so context isn't lost.
+            flushBuffer();
+            const bc = breadcrumbFor(section.headerStack);
+            const subTexts = await recursive.splitText(section.body || '');
+            for (const sub of subTexts) {
+                const text = bc ? `${bc}\n\n${sub}` : sub;
+                chunks.push(new Document({
+                    pageContent: text,
+                    metadata: {
+                        headerPath: bc,
+                        sectionCount: 1,
+                        recursiveSplit: true,
+                    },
+                }));
+            }
+            continue;
+        }
+        // Would adding this section overflow the current buffer? If so, flush.
+        // The +2 accounts for the "\n\n" join between buffered sections.
+        if (bufferSize > 0 && bufferSize + rendered.length + 2 > chunkSize) {
+            flushBuffer();
+        }
+        buffer.push(section);
+        bufferSize += rendered.length + (bufferSize > 0 ? 2 : 0);
+    }
+    flushBuffer();
+    return chunks;
+}
+/**
+ * Parse Markdown into a flat list of sections delimited by ATX headers.
+ *
+ * - Respects fenced code blocks: `#` inside ``` ... ``` is not treated as a header.
+ * - Files without any headers produce a single section with empty headerStack.
+ * - The text before the first header (if any) is attached as a section with
+ *   the file's eventual root headerStack (still empty until we see an h1).
+ */
+function parseSections(markdown) {
+    const lines = markdown.split('\n');
+    const sections = [];
+    let inFence = false;
+    let currentBody = [];
+    // headerStack carries the live ancestor chain — when we see h(n), we pop
+    // everything at level >= n then push the new header.
+    const headerStack = [];
+    const flush = () => {
+        if (currentBody.length === 0 && headerStack.length === 0) {
+            return;
+        }
+        sections.push({
+            headerStack: [...headerStack],
+            body: currentBody.join('\n').trim(),
+        });
+        currentBody = [];
+    };
+    for (const line of lines) {
+        if (FENCE_RE.test(line)) {
+            inFence = !inFence;
+            currentBody.push(line);
+            continue;
+        }
+        if (inFence) {
+            currentBody.push(line);
+            continue;
+        }
+        const m = line.match(HEADER_RE);
+        if (m) {
+            // Flush whatever section we were in before opening a new one.
+            flush();
+            const level = m[1].length;
+            // Pop deeper-or-equal headers off the stack — siblings replace, deeper
+            // descendants are closed.
+            while (headerStack.length > 0) {
+                const top = headerStack[headerStack.length - 1];
+                const topLevel = top.match(/^(#{1,6})/)[1].length;
+                if (topLevel >= level) {
+                    headerStack.pop();
+                }
+                else {
+                    break;
+                }
+            }
+            headerStack.push(`${m[1]} ${m[2]}`);
+            continue;
+        }
+        currentBody.push(line);
+    }
+    flush();
+    return sections.filter((s) => s.headerStack.length > 0 || s.body.length > 0);
+}
+/**
+ * Build a single-line breadcrumb prefix for a chunk, e.g.
+ *   "# XCUITest Driver Capabilities > ## Standard W3C > ### platformVersion"
+ * Falls back to empty string if the section has no ancestors.
+ */
+function breadcrumbFor(headerStack) {
+    if (headerStack.length === 0) {
+        return '';
+    }
+    return headerStack.join(' > ');
+}
+/**
+ * Render a section as the text that will go into a chunk: breadcrumb on top,
+ * blank line, then body. Used both when emitting a single section as one chunk
+ * and when buffering for coalescence.
+ */
+function renderSection(section) {
+    const bc = breadcrumbFor(section.headerStack);
+    if (!bc) {
+        return section.body;
+    }
+    if (!section.body) {
+        return bc;
+    }
+    return `${bc}\n\n${section.body}`;
+}
+//# sourceMappingURL=markdown-header-splitter.js.map

package/dist/markdown-header-splitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-header-splitter.js","sourceRoot":"","sources":["../src/markdown-header-splitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAY1E,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAC1C,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,OAAsC;IAEtC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEzC,qEAAqE;IACrE,2EAA2E;IAC3E,MAAM,SAAS,GAAG,IAAI,8BAA8B,CAAC;QACnD,SAAS;QACT,YAAY;QACZ,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CACT,IAAI,QAAQ,CAAC;YACX,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE;gBACR,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;gBAChD,YAAY,EAAE,MAAM,CAAC,MAAM;aAC5B;SACF,CAAC,CACH,CAAC;QACF,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,QAAQ,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAChC,wEAAwE;YACxE,qEAAqE;YACrE,sDAAsD;YACtD,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC/D,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC1C,MAAM,CAAC,IAAI,CACT,IAAI,QAAQ,CAAC;oBACX,WAAW,EAAE,IAAI;oBACjB,QAAQ,EAAE;wBACR,UAAU,EAAE,EAAE;wBACd,YAAY,EAAE,CAAC;wBACf,cAAc,EAAE,IAAI;qBACrB;iBACF,CAAC,CACH,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QAED,uEAAuE;QACvE,iEAAiE;QACjE,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,SAAS,EAAE,CAAC;YACnE,WAAW,EAAE,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,UAAU,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,WAAW,EAAE,CAAC;IAEd,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,WAAW,GAAa,EAAE,CAAC;IAC/B,yEAAyE;IACzE,qDAAqD;IACrD,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC;YAC7B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;SACpC,CAAC,CAAC;QACH,WAAW,GAAG,EAAE,CAAC;IACnB,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,GAAG,CAAC,OAAO,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC;YACN,8DAA8D;YAC9D,KAAK,EAAE,CAAC;YACR,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1B,uEAAuE;YACvE,0BAA0B;YAC1B,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAChD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBACnD,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;oBACtB,WAAW,CAAC,GAAG,EAAE,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,MAAM;gBACR,CAAC;YACH,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,WAAqB;IAC1C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAgB;IACrC,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,EAAE,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveAppiumResourcesPath(...segments: string[]): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAOA,wBAAgB,0BAA0B,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExE"}

package/dist/paths.js

@@ -0,0 +1,22 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export function resolveAppiumResourcesPath(...segments) {
+    return path.join(findResourceRoot(), ...segments);
+}
+function findResourceRoot() {
+    if (process.env.APPIUM_MCP_RESOURCES_PATH) {
+        return process.env.APPIUM_MCP_RESOURCES_PATH;
+    }
+    const candidates = [
+        path.resolve(process.cwd(), 'src/resources'),
+        path.resolve(process.cwd(), 'dist/resources'),
+        path.resolve(__dirname, 'resources'),
+        path.resolve(__dirname, '../resources'),
+    ];
+    const existing = candidates.find((candidate) => fs.existsSync(candidate));
+    return existing ?? candidates[0];
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,UAAU,0BAA0B,CAAC,GAAG,QAAkB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAC/C,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC;KACxC,CAAC;IAEF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1E,OAAO,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,19 @@
+import { appiumDocumentationQueryTool } from './tools.js';
+type ToolDef = typeof appiumDocumentationQueryTool;
+type McpRegistry = {
+    addTool(toolDef: ToolDef): void;
+};
+/**
+ * Appium documentation plugin.
+ *
+ * This class is intentionally structural: it exposes the same shape expected by
+ * appium-mcp without importing appium-mcp types and creating a circular package
+ * dependency.
+ */
+export declare class AppiumDocumentation {
+    readonly name = "appium-documentation";
+    readonly version: string;
+    register(registry: McpRegistry): void;
+}
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAoB,MAAM,YAAY,CAAC;AAG5E,KAAK,OAAO,GAAG,OAAO,4BAA4B,CAAC;AAEnD,KAAK,WAAW,GAAG;IACjB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,OAAO,SAAe;IAE/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;CAItC"}

package/dist/plugin.js

@@ -0,0 +1,18 @@
+import { appiumDocumentationQueryTool, appiumSkillsTool } from './tools.js';
+import pkg from '../package.json' with { type: 'json' };
+/**
+ * Appium documentation plugin.
+ *
+ * This class is intentionally structural: it exposes the same shape expected by
+ * appium-mcp without importing appium-mcp types and creating a circular package
+ * dependency.
+ */
+export class AppiumDocumentation {
+    name = 'appium-documentation';
+    version = pkg.version;
+    register(registry) {
+        registry.addTool(appiumDocumentationQueryTool);
+        registry.addTool(appiumSkillsTool);
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAQxD;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,sBAAsB,CAAC;IAC9B,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAE/B,QAAQ,CAAC,QAAqB;QAC5B,QAAQ,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC/C,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/reasoning-rag.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Reasoning-Enhanced RAG System
+ *
+ * This module enhances the existing RAG system by adding reasoning capabilities
+ * using Xenova transformers during the document retrieval process.
+ * It can perform summarization, question-answering, and analysis on retrieved chunks.
+ */
+import type { Document } from '@langchain/core/documents';
+/**
+ * Reasoning task types supported by the system
+ */
+export type ReasoningTask = 'summarization' | 'question-answering' | 'analysis' | 'classification';
+/**
+ * Enhanced RAG response with reasoning
+ */
+export interface EnhancedRAGResponse {
+    query: string;
+    retrievedChunks: Document[];
+    reasoningResults: ReasoningResult[];
+    summary: string;
+    answer: string;
+    sources: string[];
+}
+/**
+ * Configuration for reasoning models
+ */
+interface ReasoningConfig {
+    task: ReasoningTask;
+    modelName: string;
+    maxLength?: number;
+    minLength?: number;
+}
+/**
+ * Result from reasoning process
+ */
+interface ReasoningResult {
+    originalChunk: string;
+    reasoningOutput: string;
+    confidence?: number;
+    metadata: Record<string, any>;
+}
+/**
+ * Reasoning-enhanced RAG processor
+ */
+export declare class ReasoningRAG {
+    private transformers;
+    private models;
+    private isInitialized;
+    constructor();
+    /**
+     * Enhanced RAG query with reasoning capabilities
+     */
+    queryWithReasoning(query: string, options?: {
+        topK?: number;
+        reasoningTasks?: ReasoningTask[];
+        customConfigs?: ReasoningConfig[];
+    }): Promise<EnhancedRAGResponse>;
+    /**
+     * Get available reasoning models and their capabilities
+     */
+    getAvailableModels(): Record<ReasoningTask, string[]>;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Initialize the transformers library dynamically
+     */
+    private initializeTransformers;
+    /**
+     * Get or create a model pipeline for a specific task
+     */
+    private getModel;
+    /**
+     * Perform reasoning on a text chunk
+     */
+    private performReasoning;
+    /**
+     * Process multiple chunks with reasoning in parallel
+     */
+    private processChunksWithReasoning;
+    /**
+     * Generate a comprehensive summary from reasoning results
+     */
+    private generateComprehensiveSummary;
+}
+export declare const reasoningRAG: ReasoningRAG;
+export {};
+//# sourceMappingURL=reasoning-rag.d.ts.map

package/dist/reasoning-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-rag.d.ts","sourceRoot":"","sources":["../src/reasoning-rag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,oBAAoB,GACpB,UAAU,GACV,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,aAAa,CAAkB;;IAMvC;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;QACjC,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;KAC9B,GACL,OAAO,CAAC,mBAAmB,CAAC;IAiH/B;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAmBrD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;YACW,sBAAsB;IAsBpC;;OAEG;YACW,QAAQ;IA4BtB;;OAEG;YACW,gBAAgB;IAqF9B;;OAEG;YACW,0BAA0B;IAgCxC;;OAEG;YACW,4BAA4B;CAkC3C;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}