appium-mcp 1.73.0 → 1.74.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [1.74.0](https://github.com/appium/appium-mcp/compare/v1.73.0...v1.74.0) (2026-05-16)
+
+### Features
+
+* **embeddings:** cache vector embeddings and ship warm cache ([#335](https://github.com/appium/appium-mcp/issues/335)) ([52c8fd3](https://github.com/appium/appium-mcp/commit/52c8fd326a7e67f2769a10e00c9c5516bd86e0bf))
+
 ## [1.73.0](https://github.com/appium/appium-mcp/compare/v1.72.16...v1.73.0) (2026-05-14)
 
 ### Features

package/dist/scripts/generate-embeddings-cache.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate the embeddings cache for the currently configured model.
+ *
+ * Idempotent: if a valid cache already exists for the current model and the
+ * fingerprint matches documents.json, this exits quickly. Otherwise it
+ * embeds all chunks and writes the cache.
+ *
+ * Intended for the maintainer release flow:
+ *   npm run build && npm run generate-cache
+ * to ensure the published tarball ships a warm cache for the default model.
+ */
+export {};
+//# sourceMappingURL=generate-embeddings-cache.d.ts.map

package/dist/scripts/generate-embeddings-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-embeddings-cache.d.ts","sourceRoot":"","sources":["../../src/scripts/generate-embeddings-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/scripts/generate-embeddings-cache.js

@@ -0,0 +1,24 @@
+/**
+ * Generate the embeddings cache for the currently configured model.
+ *
+ * Idempotent: if a valid cache already exists for the current model and the
+ * fingerprint matches documents.json, this exits quickly. Otherwise it
+ * embeds all chunks and writes the cache.
+ *
+ * Intended for the maintainer release flow:
+ *   npm run build && npm run generate-cache
+ * to ensure the published tarball ships a warm cache for the default model.
+ */
+import { queryVectorStore } from '../tools/documentation/simple-pdf-indexer.js';
+const start = Date.now();
+try {
+    // A single query forces the cold-start path inside queryVectorStore, which
+    // checks the cache and embeds+saves on miss. We don't care about results.
+    await queryVectorStore('warmup', 1);
+    console.log(`Embeddings cache ready (${Date.now() - start}ms)`);
+}
+catch (err) {
+    console.error('Failed to generate embeddings cache:', err);
+    process.exit(1);
+}
+//# sourceMappingURL=generate-embeddings-cache.js.map

package/dist/scripts/generate-embeddings-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-embeddings-cache.js","sourceRoot":"","sources":["../../src/scripts/generate-embeddings-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAEhF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACzB,IAAI,CAAC;IACH,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC;AAClE,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/tests/__mocks__/@appium/support.d.ts

@@ -38,6 +38,24 @@ export declare const zip: {
     readEntries: (_zipPath: string, _handler: unknown) => Promise<void>;
     toArchive: (_dstPath: string, _src?: unknown, _opts?: unknown) => Promise<void>;
 };
+/**
+ * Minimal `fs` mock that delegates to node:fs/promises so test code touching
+ * the real filesystem continues to work.
+ */
+export declare const fs: {
+    exists: (p: string) => Promise<boolean>;
+    readdir: (p: string) => Promise<string[]>;
+    stat: (p: string) => Promise<import("node:fs").Stats>;
+    readFile: (p: string, encoding?: BufferEncoding) => Promise<string | NonSharedBuffer>;
+    writeFile: (p: string, data: string | Buffer) => Promise<void>;
+    unlink: (p: string) => Promise<void>;
+    rename: (from: string, to: string) => Promise<void>;
+    mkdir: (p: string, opts?: {
+        recursive?: boolean;
+    }) => Promise<string | undefined>;
+    mkdirp: (p: string) => Promise<string | undefined>;
+    mv: (from: string, to: string) => Promise<void>;
+};
 declare const _default: {
     logger: {
         getLogger: (_name: string) => {
@@ -62,6 +80,20 @@ declare const _default: {
         readEntries: (_zipPath: string, _handler: unknown) => Promise<void>;
         toArchive: (_dstPath: string, _src?: unknown, _opts?: unknown) => Promise<void>;
     };
+    fs: {
+        exists: (p: string) => Promise<boolean>;
+        readdir: (p: string) => Promise<string[]>;
+        stat: (p: string) => Promise<import("node:fs").Stats>;
+        readFile: (p: string, encoding?: BufferEncoding) => Promise<string | NonSharedBuffer>;
+        writeFile: (p: string, data: string | Buffer) => Promise<void>;
+        unlink: (p: string) => Promise<void>;
+        rename: (from: string, to: string) => Promise<void>;
+        mkdir: (p: string, opts?: {
+            recursive?: boolean;
+        }) => Promise<string | undefined>;
+        mkdirp: (p: string) => Promise<string | undefined>;
+        mv: (from: string, to: string) => Promise<void>;
+    };
 };
 export default _default;
 //# sourceMappingURL=support.d.ts.map

package/dist/tests/__mocks__/@appium/support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../../../src/tests/__mocks__/@appium/support.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;uBACE,MAAM;0BAIH,MAAM,YAAY,GAAG,EAAE;yBAGxB,MAAM,YAAY,GAAG,EAAE;yBAGvB,MAAM,YAAY,GAAG,EAAE;0BAGtB,MAAM,YAAY,GAAG,EAAE;0BAGvB,MAAM,YAAY,GAAG,EAAE;;CAI9C,CAAC;AAEF;;;;;;GAMG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACpD,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,iBAAiB,CAAC;IAC7C,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,EAAE,iBAkB/B,CAAC;AAEF,eAAO,MAAM,SAAS;yBACC,QAAQ,MAAM;CACpC,CAAC;AAEF,eAAO,MAAM,GAAG;+BAEA,MAAM,YACR,MAAM,UACR,OAAO;CAIlB,CAAC;AAEF,eAAO,MAAM,KAAK;iCACmB,MAAM;CAC1C,CAAC;AAEF,eAAO,MAAM,GAAG;6BACiB,MAAM,YAAY,MAAM,UAAU,OAAO;4BAG1C,MAAM,YAAY,OAAO;0BAG3B,MAAM,SAAS,OAAO,UAAU,OAAO;CAGpE,CAAC;;;2BAxFmB,MAAM;8BAIH,MAAM,YAAY,GAAG,EAAE;6BAGxB,MAAM,YAAY,GAAG,EAAE;6BAGvB,MAAM,YAAY,GAAG,EAAE;8BAGtB,MAAM,YAAY,GAAG,EAAE;8BAGvB,MAAM,YAAY,GAAG,EAAE;;;;6BA6CxB,QAAQ,MAAM;;;mCAKrB,MAAM,YACR,MAAM,UACR,OAAO;;;qCAOkB,MAAM;;;iCAIV,MAAM,YAAY,MAAM,UAAU,OAAO;gCAG1C,MAAM,YAAY,OAAO;8BAG3B,MAAM,SAAS,OAAO,UAAU,OAAO;;;AAMrE,wBAME"}
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../../../src/tests/__mocks__/@appium/support.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;uBACE,MAAM;0BAIH,MAAM,YAAY,GAAG,EAAE;yBAGxB,MAAM,YAAY,GAAG,EAAE;yBAGvB,MAAM,YAAY,GAAG,EAAE;0BAGtB,MAAM,YAAY,GAAG,EAAE;0BAGvB,MAAM,YAAY,GAAG,EAAE;;CAI9C,CAAC;AAEF;;;;;;GAMG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACpD,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,iBAAiB,CAAC;IAC7C,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,EAAE,iBAkB/B,CAAC;AAEF,eAAO,MAAM,SAAS;yBACC,QAAQ,MAAM;CACpC,CAAC;AAEF,eAAO,MAAM,GAAG;+BAEA,MAAM,YACR,MAAM,UACR,OAAO;CAIlB,CAAC;AAEF,eAAO,MAAM,KAAK;iCACmB,MAAM;CAC1C,CAAC;AAEF,eAAO,MAAM,GAAG;6BACiB,MAAM,YAAY,MAAM,UAAU,OAAO;4BAG1C,MAAM,YAAY,OAAO;0BAG3B,MAAM,SAAS,OAAO,UAAU,OAAO;CAGpE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,EAAE;gBACK,MAAM;iBACX,MAAM;cACT,MAAM;kBACF,MAAM,aAAa,cAAc;mBAEhC,MAAM,QAAQ,MAAM,GAAG,MAAM;gBAEhC,MAAM;mBACH,MAAM,MAAM,MAAM;eACtB,MAAM,SAAS;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;gBAErC,MAAM;eACD,MAAM,MAAM,MAAM;CAGpC,CAAC;;;2BA9GmB,MAAM;8BAIH,MAAM,YAAY,GAAG,EAAE;6BAGxB,MAAM,YAAY,GAAG,EAAE;6BAGvB,MAAM,YAAY,GAAG,EAAE;8BAGtB,MAAM,YAAY,GAAG,EAAE;8BAGvB,MAAM,YAAY,GAAG,EAAE;;;;6BA6CxB,QAAQ,MAAM;;;mCAKrB,MAAM,YACR,MAAM,UACR,OAAO;;;qCAOkB,MAAM;;;iCAIV,MAAM,YAAY,MAAM,UAAU,OAAO;gCAG1C,MAAM,YAAY,OAAO;8BAG3B,MAAM,SAAS,OAAO,UAAU,OAAO;;;oBAUjD,MAAM;qBACX,MAAM;kBACT,MAAM;sBACF,MAAM,aAAa,cAAc;uBAEhC,MAAM,QAAQ,MAAM,GAAG,MAAM;oBAEhC,MAAM;uBACH,MAAM,MAAM,MAAM;mBACtB,MAAM,SAAS;YAAE,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE;oBAErC,MAAM;mBACD,MAAM,MAAM,MAAM;;;AAMrC,wBAOE"}

package/dist/tests/__mocks__/@appium/support.js

@@ -1,5 +1,6 @@
 // Mock @appium/support for Jest tests
 // This avoids the ESM/CommonJS mismatch with uuid dependency
+import { promises as fsPromises, existsSync } from 'node:fs';
 export const logger = {
     getLogger: (_name) => 
     // Simple logger implementation for tests
@@ -63,6 +64,24 @@ export const zip = {
         // Silent in tests by default
     },
 };
+/**
+ * Minimal `fs` mock that delegates to node:fs/promises so test code touching
+ * the real filesystem continues to work.
+ */
+export const fs = {
+    exists: async (p) => existsSync(p),
+    readdir: (p) => fsPromises.readdir(p),
+    stat: (p) => fsPromises.stat(p),
+    readFile: (p, encoding) => fsPromises.readFile(p, encoding),
+    writeFile: (p, data) => fsPromises.writeFile(p, data),
+    unlink: (p) => fsPromises.unlink(p),
+    rename: (from, to) => fsPromises.rename(from, to),
+    mkdir: (p, opts) => fsPromises.mkdir(p, opts),
+    mkdirp: (p) => fsPromises.mkdir(p, { recursive: true }),
+    mv: async (from, to) => {
+        await fsPromises.rename(from, to);
+    },
+};
 // Export other commonly used utilities from @appium/support if needed
 export default {
     logger,
@@ -70,5 +89,6 @@ export default {
     net,
     plist,
     zip,
+    fs,
 };
 //# sourceMappingURL=support.js.map

package/dist/tests/__mocks__/@appium/support.js.map

@@ -1 +1 @@
-{"version":3,"file":"support.js","sourceRoot":"","sources":["../../../../src/tests/__mocks__/@appium/support.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,6DAA6D;AAE7D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE,CAAC,KAAa,EAAE,EAAE;IAC3B,yCAAyC;IACzC,kDAAkD;IAClD,CAAC;QACC,KAAK,EAAE,CAAC,QAAgB,EAAE,GAAG,KAAY,EAAE,EAAE;YAC3C,6BAA6B;QAC/B,CAAC;QACD,IAAI,EAAE,CAAC,QAAgB,EAAE,GAAG,KAAY,EAAE,EAAE;YAC1C,6BAA6B;QAC/B,CAAC;QACD,IAAI,EAAE,CAAC,QAAgB,EAAE,GAAG,KAAY,EAAE,EAAE;YAC1C,6BAA6B;QAC/B,CAAC;QACD,KAAK,EAAE,CAAC,QAAgB,EAAE,GAAG,KAAY,EAAE,EAAE;YAC3C,6BAA6B;QAC/B,CAAC;QACD,KAAK,EAAE,CAAC,QAAgB,EAAE,GAAG,KAAY,EAAE,EAAE;YAC3C,6BAA6B;QAC/B,CAAC;KACF,CAAC;CACL,CAAC;AAmBF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACzE,MAAM,CAAC,CAAS,EAAE,CAAS;QACzB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAe;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,QAAQ;QACN,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IACD,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,GAAG,EAAE,CACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,iBAAiB;CAC1D,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,YAAY,EAAE,KAAK,EACjB,UAAkB,EAClB,QAAgB,EAChB,KAAe,EACf,EAAE;QACF,6BAA6B;IAC/B,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,cAAc,EAAE,KAAK,EAAE,UAAkB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,YAAY,EAAE,KAAK,EAAE,QAAgB,EAAE,QAAgB,EAAE,KAAe,EAAE,EAAE;QAC1E,6BAA6B;IAC/B,CAAC;IACD,WAAW,EAAE,KAAK,EAAE,QAAgB,EAAE,QAAiB,EAAE,EAAE;QACzD,6BAA6B;IAC/B,CAAC;IACD,SAAS,EAAE,KAAK,EAAE,QAAgB,EAAE,IAAc,EAAE,KAAe,EAAE,EAAE;QACrE,6BAA6B;IAC/B,CAAC;CACF,CAAC;AAEF,sEAAsE;AACtE,eAAe;IACb,MAAM;IACN,SAAS;IACT,GAAG;IACH,KAAK;IACL,GAAG;CACJ,CAAC"}
+{"version":3,"file":"support.js","sourceRoot":"","sources":["../../../../src/tests/__mocks__/@appium/support.ts"],"names":[],"mappings":"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"}

package/dist/tools/documentation/sentence-transformers-embeddings.d.ts

@@ -17,6 +17,8 @@ export declare class SentenceTransformersEmbeddings {
         modelName?: string;
         queryInstruction?: string;
     });
+    /** Name of the underlying model (used to namespace the embeddings cache file). */
+    getModelName(): string;
     /**
      * Generate embeddings for a single text (LangChain interface).
      * Applies queryInstruction prefix when set.

package/dist/tools/documentation/sentence-transformers-embeddings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sentence-transformers-embeddings.d.ts","sourceRoot":"","sources":["../../../src/tools/documentation/sentence-transformers-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO;IAO3E;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BjD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IA0C1D;;OAEG;YACW,sBAAsB;IAoBpC;;OAEG;YACW,eAAe;CAyB9B"}
+{"version":3,"file":"sentence-transformers-embeddings.d.ts","sourceRoot":"","sources":["../../../src/tools/documentation/sentence-transformers-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO;IAO3E,kFAAkF;IAClF,YAAY,IAAI,MAAM;IAItB;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BjD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IA0C1D;;OAEG;YACW,sBAAsB;IAoBpC;;OAEG;YACW,eAAe;CAyB9B"}

package/dist/tools/documentation/sentence-transformers-embeddings.js

@@ -20,6 +20,10 @@ export class SentenceTransformersEmbeddings {
         // BGE models use this to close the question/passage style gap.
         this.queryInstruction = options.queryInstruction ?? '';
     }
+    /** Name of the underlying model (used to namespace the embeddings cache file). */
+    getModelName() {
+        return this.modelName;
+    }
     /**
      * Generate embeddings for a single text (LangChain interface).
      * Applies queryInstruction prefix when set.

package/dist/tools/documentation/sentence-transformers-embeddings.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"simple-pdf-indexer.d.ts","sourceRoot":"","sources":["../../../src/tools/documentation/simple-pdf-indexer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AA6D3E;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAa,EACxB,YAAY,GAAE,MAAY,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAwC5B;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CA2CnB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAa,EACxB,YAAY,GAAE,MAAY,GACzB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAa,EACxB,YAAY,GAAE,MAAY,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsFnB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAW,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CA6BrB"}
+{"version":3,"file":"simple-pdf-indexer.d.ts","sourceRoot":"","sources":["../../../src/tools/documentation/simple-pdf-indexer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAwO3E;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAa,EACxB,YAAY,GAAE,MAAY,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAmD5B;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAwCnB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAa,EACxB,YAAY,GAAE,MAAY,GACzB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAa,EACxB,YAAY,GAAE,MAAY,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAuGnB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAW,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CA6CrB"}

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

@@ -8,9 +8,9 @@
 import { RecursiveCharacterTextSplitter } from '@langchain/textsplitters';
 import { Document } from '@langchain/core/documents';
 import { MemoryVectorStore } from '@langchain/classic/vectorstores/memory';
-import * as fs from 'node:fs';
+import { fs } from '@appium/support';
+import * as crypto from 'node:crypto';
 import * as path from 'node:path';
-import { promisify } from 'node:util';
 import { fileURLToPath } from 'node:url';
 // Initialize embeddings using sentence-transformers (no API key required)
 import { SentenceTransformersEmbeddings } from './sentence-transformers-embeddings.js';
@@ -55,6 +55,121 @@ let memoryVectorStore = null;
  * Exclude certain directories from being indexed to avoid irrelevant content and reduce noise in the vector store.
  */
 const EXCLUDED_MARKDOWN_DIRECTORIES = new Set(['appium-skills']);
+/**
+ * Embeddings cache: vectors persisted alongside documents.json so the
+ * server doesn't re-embed all chunks on every cold start.
+ *
+ * Invariants:
+ *   - One cache file per model, so multiple models can coexist on disk.
+ *   - Fingerprint embeds (modelName, chunkCount, contentHash of documents).
+ *     Any drift in the corpus or model means the cache invalidates and gets
+ *     re-embedded automatically.
+ */
+const CACHE_VERSION = 1;
+function sanitizeForFilename(name) {
+    return name.replace(/[^a-zA-Z0-9._-]/g, '-');
+}
+function getEmbeddingsCachePath(modelName) {
+    return path.join(__dirname, 'uploads', `embeddings-${sanitizeForFilename(modelName)}.json`);
+}
+function computeContentHash(documents) {
+    const hash = crypto.createHash('sha256');
+    for (const doc of documents) {
+        hash.update(doc.pageContent);
+        hash.update('\x00'); // separator avoids concat collisions across chunks
+    }
+    return hash.digest('hex');
+}
+function makeFingerprint(documents, modelName) {
+    return {
+        modelName,
+        chunkCount: documents.length,
+        contentHash: computeContentHash(documents),
+    };
+}
+function fingerprintsMatch(a, b) {
+    return (a.modelName === b.modelName &&
+        a.chunkCount === b.chunkCount &&
+        a.contentHash === b.contentHash);
+}
+/**
+ * Try to load a valid embeddings cache for the given documents + model.
+ * Returns null if no cache file exists, the file is corrupt, or its
+ * fingerprint disagrees with what we'd compute now.
+ */
+async function loadEmbeddingsCache(documents, modelName) {
+    const cachePath = getEmbeddingsCachePath(modelName);
+    if (!(await fs.exists(cachePath))) {
+        log.info(`No embeddings cache found at ${cachePath}`);
+        return null;
+    }
+    try {
+        const raw = await fs.readFile(cachePath, 'utf-8');
+        const cache = JSON.parse(raw);
+        if (cache.version !== CACHE_VERSION) {
+            log.warn(`Embeddings cache version mismatch (got ${cache.version}, want ${CACHE_VERSION}). Invalidating.`);
+            return null;
+        }
+        const expected = makeFingerprint(documents, modelName);
+        if (!fingerprintsMatch(cache.fingerprint, expected)) {
+            log.info(`Embeddings cache fingerprint mismatch — will re-embed. ` +
+                `Cached: ${JSON.stringify(cache.fingerprint)}; expected: ${JSON.stringify(expected)}`);
+            return null;
+        }
+        if (!Array.isArray(cache.embeddings) ||
+            cache.embeddings.length !== documents.length) {
+            log.warn(`Embeddings cache length (${cache.embeddings?.length}) does not match documents length (${documents.length}). Invalidating.`);
+            return null;
+        }
+        log.info(`Embeddings cache hit: ${cache.embeddings.length} vectors loaded from ${cachePath}`);
+        return cache.embeddings;
+    }
+    catch (err) {
+        log.warn(`Failed to read embeddings cache (${err instanceof Error ? err.message : String(err)}). Will re-embed.`);
+        return null;
+    }
+}
+/**
+ * Persist embedding vectors for the given documents under the given model name.
+ * Writes to a .tmp file then moves into place; the finally block sweeps the
+ * tmp file if anything between writeFile and mv throws. Uses fs.mv so the
+ * overwrite works across platforms (Windows rename-over-existing can be flaky
+ * in edge cases involving file locks).
+ */
+async function saveEmbeddingsCache(documents, vectors, modelName) {
+    if (vectors.length === 0) {
+        return;
+    }
+    if (vectors.length !== documents.length) {
+        log.warn(`Refusing to write embeddings cache: ${vectors.length} vectors vs ${documents.length} documents`);
+        return;
+    }
+    const cachePath = getEmbeddingsCachePath(modelName);
+    await fs.mkdirp(path.dirname(cachePath));
+    const cache = {
+        version: CACHE_VERSION,
+        fingerprint: makeFingerprint(documents, modelName),
+        embeddings: vectors,
+    };
+    const tmpPath = `${cachePath}.tmp`;
+    try {
+        await fs.writeFile(tmpPath, JSON.stringify(cache));
+        await fs.mv(tmpPath, cachePath, { clobber: true, mkdirp: true });
+        log.info(`Saved embeddings cache (${vectors.length} vectors) to ${cachePath}`);
+    }
+    finally {
+        if (await fs.exists(tmpPath)) {
+            try {
+                await fs.unlink(tmpPath);
+            }
+            catch (cleanupErr) {
+                log.warn(`Failed to clean up tmp cache file ${tmpPath}: ${cleanupErr instanceof Error
+                    ? cleanupErr.message
+                    : String(cleanupErr)}`);
+            }
+        }
+    }
+}
 /**
  * Initialize the vector store with Markdown content
  * @param markdownPath Path to the Markdown file
@@ -79,13 +194,19 @@ export async function initializeVectorStore(markdownPath, chunkSize = 1000, chun
         log.info('Splitting text into chunks...');
         const documents = await textSplitter.createDocuments([markdownText]);
         log.info(`Created ${documents.length} document chunks`);
-        // Store documents in memory vector store
+        // Embed once; reuse the vectors for both the in-memory store and the cache.
+        log.info('Embedding chunks...');
+        const embeddingsProvider = getEmbeddings();
+        const vectors = await embeddingsProvider.embedDocuments(documents.map((d) => d.pageContent));
         log.info('Storing documents in memory vector store...');
-        const vectorStore = await MemoryVectorStore.fromDocuments(documents, getEmbeddings());
+        const vectorStore = new MemoryVectorStore(embeddingsProvider);
+        await vectorStore.addVectors(vectors, documents);
         // Save the vector store in the global variable for later use
         memoryVectorStore = vectorStore;
         // Save documents to file for persistence
         await saveDocuments(documents, false); // Don't append for single file indexing
+        // Persist the embeddings cache so the next cold start can skip embedding.
+        await saveEmbeddingsCache(documents, vectors, embeddingsProvider.getModelName());
         log.info('Successfully stored documents in memory vector store');
         return vectorStore;
     }
@@ -101,19 +222,17 @@ export async function initializeVectorStore(markdownPath, chunkSize = 1000, chun
  */
 export async function getMarkdownFilesInDirectory(dirPath) {
     try {
-        const readdir = promisify(fs.readdir);
-        const stat = promisify(fs.stat);
         // Check if directory exists
-        if (!fs.existsSync(dirPath)) {
+        if (!(await fs.exists(dirPath))) {
             log.error(`Directory does not exist: ${dirPath}`);
             return [];
         }
         const markdownFiles = [];
         async function scanDirectory(currentPath) {
-            const files = await readdir(currentPath);
+            const files = await fs.readdir(currentPath);
             for (const file of files) {
                 const filePath = path.join(currentPath, file);
-                const stats = await stat(filePath);
+                const stats = await fs.stat(filePath);
                 if (stats.isDirectory()) {
                     if (EXCLUDED_MARKDOWN_DIRECTORIES.has(file)) {
                         continue;
@@ -172,6 +291,14 @@ export async function indexAllMarkdownFiles(dirPath, chunkSize = 1000, chunkOver
         }
         // Clear the documents file before starting
         await clearDocumentsFile();
+        // Accumulate vectors + documents across all files so we can write a single
+        // embeddings cache at the end, parallel-aligned with documents.json.
+        const embeddingsProvider = getEmbeddings();
+        const allVectors = [];
+        const allDocuments = [];
+        // Initialize the in-memory store up-front so a failure on the first file
+        // can't leave subsequent iterations with a null store.
+        memoryVectorStore = new MemoryVectorStore(embeddingsProvider);
         // Index each Markdown file
         const indexedFiles = [];
         for (let i = 0; i < markdownFiles.length; i++) {
@@ -202,18 +329,16 @@ export async function indexAllMarkdownFiles(dirPath, chunkSize = 1000, chunkOver
                         relativePath,
                     };
                 });
-                // Store documents in memory vector store
-                log.info('Storing documents in memory vector store...');
-                if (i === 0) {
-                    // For the first Markdown file, create a new vector store
-                    memoryVectorStore = await MemoryVectorStore.fromDocuments(documents, getEmbeddings());
-                }
-                else {
-                    // For subsequent Markdown files, add to the existing vector store
-                    await memoryVectorStore?.addDocuments(documents);
-                }
-                // Save documents to file (append for all Markdown files except the first one)
+                // Embed this file's chunks once; reuse the vectors for both the
+                // in-memory store and the on-disk cache.
+                log.info('Embedding chunks...');
+                const vectors = await embeddingsProvider.embedDocuments(documents.map((d) => d.pageContent));
+                // Persist documents.json first
                 await saveDocuments(documents, i > 0);
+                log.info('Storing documents in memory vector store...');
+                await memoryVectorStore.addVectors(vectors, documents);
+                allVectors.push(...vectors);
+                allDocuments.push(...documents);
                 indexedFiles.push(markdownFile);
                 log.info(`Successfully indexed Markdown: ${filename}`);
             }
@@ -222,6 +347,9 @@ export async function indexAllMarkdownFiles(dirPath, chunkSize = 1000, chunkOver
                 // Continue with next file even if one fails
             }
         }
+        // Persist the embeddings cache once, after all files are indexed.
+        // The cache is keyed by model name and ordered to match documents.json.
+        await saveEmbeddingsCache(allDocuments, allVectors, embeddingsProvider.getModelName());
         log.info(`Successfully indexed ${indexedFiles.length} out of ${markdownFiles.length} Markdown files`);
         return indexedFiles;
     }
@@ -238,22 +366,35 @@ export async function indexAllMarkdownFiles(dirPath, chunkSize = 1000, chunkOver
  */
 export async function queryVectorStore(query, topK = 25) {
     try {
-        // Check if the vector store has been initialized in memory
         if (!memoryVectorStore) {
-            // Try to load documents from file
             const documents = await loadDocuments();
-            // If documents exist, create a new vector store
-            if (documents && documents.length > 0) {
-                log.info('Creating vector store from saved documents...');
-                memoryVectorStore = await MemoryVectorStore.fromDocuments(documents, getEmbeddings());
+            if (!documents || documents.length === 0) {
+                throw new Error('Vector store has not been initialized. Please index docs first.');
+            }
+            const embeddingsProvider = getEmbeddings();
+            const modelName = embeddingsProvider.getModelName();
+            // Fast path: load pre-computed vectors and build the store via addVectors.
+            // Skips the ~30-60s document-embedding step entirely.
+            const cached = await loadEmbeddingsCache(documents, modelName);
+            if (cached) {
+                log.info('Building vector store from cached embeddings (fast path)');
+                memoryVectorStore = new MemoryVectorStore(embeddingsProvider);
+                await memoryVectorStore.addVectors(cached, documents);
             }
             else {
-                throw new Error('Vector store has not been initialized. Please index a PDF first.');
+                // Slow path: embed all documents now, then persist a cache so the
+                // next cold start is fast. Also covers model changes (different
+                // cache filename, no hit) and corpus changes (fingerprint mismatch).
+                log.info(`Embedding ${documents.length} documents for model ${modelName} (this may take a while)...`);
+                const start = Date.now();
+                const vectors = await embeddingsProvider.embedDocuments(documents.map((d) => d.pageContent));
+                log.info(`Embedding completed in ${Date.now() - start}ms`);
+                memoryVectorStore = new MemoryVectorStore(embeddingsProvider);
+                await memoryVectorStore.addVectors(vectors, documents);
+                await saveEmbeddingsCache(documents, vectors, modelName);
             }
         }
-        // Query the vector store
-        const results = await memoryVectorStore.similaritySearch(query, topK);
-        return results;
+        return await memoryVectorStore.similaritySearch(query, topK);
     }
     catch (error) {
         log.error('Error querying vector store:', error);
@@ -268,10 +409,7 @@ export async function queryVectorStore(query, topK = 25) {
 async function saveDocuments(documents, append = false) {
     try {
         // Create directory if it doesn't exist
-        const dir = path.dirname(DOCUMENTS_PATH);
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-        }
+        await fs.mkdirp(path.dirname(DOCUMENTS_PATH));
         // Serialize the new documents
         const serializedNew = documents.map((doc) => ({
             pageContent: doc.pageContent,
@@ -279,9 +417,9 @@ async function saveDocuments(documents, append = false) {
         }));
         let allSerialized = serializedNew;
         // If appending and file exists, read existing documents and combine
-        if (append && fs.existsSync(DOCUMENTS_PATH)) {
+        if (append && (await fs.exists(DOCUMENTS_PATH))) {
             try {
-                const existingContent = fs.readFileSync(DOCUMENTS_PATH, 'utf-8');
+                const existingContent = (await fs.readFile(DOCUMENTS_PATH, 'utf-8'));
                 if (existingContent) {
                     const existingSerialized = JSON.parse(existingContent);
                     allSerialized = [...existingSerialized, ...serializedNew];
@@ -293,7 +431,7 @@ async function saveDocuments(documents, append = false) {
             }
         }
         // Write to file
-        fs.writeFileSync(DOCUMENTS_PATH, JSON.stringify(allSerialized));
+        await fs.writeFile(DOCUMENTS_PATH, JSON.stringify(allSerialized));
         log.info(`${append ? 'Appended to' : 'Saved'} documents in ${DOCUMENTS_PATH} (total: ${allSerialized.length})`);
     }
     catch (error) {
@@ -306,8 +444,8 @@ async function saveDocuments(documents, append = false) {
  */
 async function clearDocumentsFile() {
     try {
-        if (fs.existsSync(DOCUMENTS_PATH)) {
-            fs.writeFileSync(DOCUMENTS_PATH, JSON.stringify([]));
+        if (await fs.exists(DOCUMENTS_PATH)) {
+            await fs.writeFile(DOCUMENTS_PATH, JSON.stringify([]));
             log.info(`Cleared documents file at ${DOCUMENTS_PATH}`);
         }
     }
@@ -322,12 +460,13 @@ async function clearDocumentsFile() {
  */
 async function loadDocuments() {
     try {
-        if (!fs.existsSync(DOCUMENTS_PATH)) {
+        if (!(await fs.exists(DOCUMENTS_PATH))) {
             log.info('No saved documents found');
             return null;
         }
         // Read from file
-        const serialized = JSON.parse(fs.readFileSync(DOCUMENTS_PATH, 'utf-8'));
+        const raw = (await fs.readFile(DOCUMENTS_PATH, 'utf-8'));
+        const serialized = JSON.parse(raw);
         // Convert to Document objects
         const documents = serialized.map((doc) => new Document({
             pageContent: doc.pageContent,
@@ -348,8 +487,7 @@ async function loadDocuments() {
  */
 async function extractTextFromMarkdown(markdownPath) {
     try {
-        const text = fs.readFileSync(markdownPath, 'utf-8');
-        return text;
+        return (await fs.readFile(markdownPath, 'utf-8'));
     }
     catch (error) {
         log.error('Error extracting text from Markdown:', error);
@@ -369,7 +507,8 @@ if (import.meta.url === `file://${process.argv[1]}`) {
         // Use provided path
         markdownPath = path.resolve(process.cwd(), args[0]);
         // Check if the provided path is a file or directory
-        if (fs.existsSync(markdownPath) && fs.statSync(markdownPath).isFile()) {
+        if ((await fs.exists(markdownPath)) &&
+            (await fs.stat(markdownPath)).isFile()) {
             indexSingleFile = true;
         }
     }