@zvec/zvec-grep 0.1.5 → 0.1.7

package/dist/engine/models/backends/model2vec.d.ts

@@ -0,0 +1,40 @@
+import type { Content } from "../../types.js";
+import { BaseEmbeddingModel, type CreateEmbeddingModelOptions, type EmbeddingModelInfo, type EmbeddingResult, type NormalizedEmbeddingOptions } from "../embeddings.js";
+import type { Model2VecEmbeddingCatalogEntry } from "../catalog.js";
+import { type StaticEmbeddingTable, type TokenizerLike } from "./model2vec-runtime.js";
+type Model2VecDependencies = {
+    loadTokenizer(repo: string, options: {
+        cache_dir: string;
+        revision: string;
+        local_files_only?: boolean;
+    }): Promise<TokenizerLike>;
+    loadSafetensors(path: string, tensorName: string, dimension: number): Promise<StaticEmbeddingTable>;
+    download(url: string, destination: string, onProgress?: (progress: {
+        downloadedBytes: number;
+        totalBytes?: number;
+    }) => void): Promise<void>;
+};
+export declare class Model2VecEmbeddingModel extends BaseEmbeddingModel {
+    private readonly entry;
+    readonly info: EmbeddingModelInfo;
+    private readonly modelCacheDir;
+    private readonly dependencies;
+    private tokenizer;
+    private staticTable;
+    private workerPool;
+    private loadPromise;
+    private readonly useWorkerPool;
+    private disposed;
+    constructor(entry: Model2VecEmbeddingCatalogEntry, options: CreateEmbeddingModelOptions, dependencies?: Partial<Model2VecDependencies>);
+    protected doEmbed(contents: readonly Content[], options: NormalizedEmbeddingOptions): Promise<EmbeddingResult>;
+    private embedBatch;
+    dispose(): Promise<void>;
+    private ensureLoaded;
+    private loadModel;
+    private resolveModelPath;
+    private resolveTokenizerSource;
+    private resolveCachedFile;
+    private embedTexts;
+    private ensureNotDisposed;
+}
+export {};

package/dist/engine/models/backends/model2vec.js

@@ -0,0 +1,311 @@
+import { createWriteStream, existsSync, statSync } from "node:fs";
+import { mkdir, open, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { EngineError } from "../../errors.js";
+import { defaultHome } from "../../utils/path.js";
+import { BaseEmbeddingModel, } from "../embeddings.js";
+import { createModelDownloadProgressReporter, } from "../download-progress.js";
+import { loadModel2VecTokenizer } from "./model2vec-tokenizer.js";
+import { Model2VecWorkerPool } from "./model2vec-worker-pool.js";
+import { embedModel2VecTexts, sharedStaticEmbeddingTable, } from "./model2vec-runtime.js";
+const DEFAULT_MODEL_CACHE_DIR = join(defaultHome(), "models");
+const defaultDependencies = {
+    async loadTokenizer(source) {
+        return await loadModel2VecTokenizer(source);
+    },
+    async loadSafetensors(path, tensorName, dimension) {
+        return await readStaticEmbeddingTable(path, tensorName, dimension);
+    },
+    async download(url, destination, onProgress) {
+        const response = await fetch(url, { redirect: "follow" });
+        if (!response.ok || !response.body) {
+            throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        }
+        const contentLength = response.headers.get("content-length");
+        const parsedTotalBytes = contentLength
+            ? Number.parseInt(contentLength, 10)
+            : undefined;
+        const totalBytes = parsedTotalBytes !== undefined &&
+            Number.isFinite(parsedTotalBytes) &&
+            parsedTotalBytes >= 0
+            ? parsedTotalBytes
+            : undefined;
+        let downloadedBytes = 0;
+        const progressStream = new Transform({
+            transform(chunk, _encoding, callback) {
+                downloadedBytes += Buffer.byteLength(chunk);
+                onProgress?.({ downloadedBytes, totalBytes });
+                callback(null, chunk);
+            },
+        });
+        await pipeline(Readable.fromWeb(response.body), progressStream, createWriteStream(destination));
+    },
+};
+export class Model2VecEmbeddingModel extends BaseEmbeddingModel {
+    entry;
+    info;
+    modelCacheDir;
+    dependencies;
+    tokenizer = null;
+    staticTable = null;
+    workerPool = null;
+    loadPromise = null;
+    useWorkerPool;
+    disposed = false;
+    constructor(entry, options, dependencies = {}) {
+        super();
+        this.entry = entry;
+        this.info = {
+            reference: entry.reference,
+            provider: entry.provider,
+            name: entry.model,
+            dimension: entry.dimension,
+            metric: entry.metric,
+            defaultConcurrency: entry.defaultConcurrency,
+            inputKinds: ["text"],
+            limits: {
+                maxBatchSize: entry.maxBatchSize,
+                maxInputTokens: entry.maxInputTokens,
+            },
+        };
+        this.modelCacheDir =
+            options.modelCacheDir ??
+                process.env.ZVEC_GREP_MODEL_CACHE ??
+                DEFAULT_MODEL_CACHE_DIR;
+        this.dependencies = { ...defaultDependencies, ...dependencies };
+        this.useWorkerPool = Object.keys(dependencies).length === 0;
+    }
+    async doEmbed(contents, options) {
+        return await this.embedBatch(contents, options);
+    }
+    async embedBatch(contents, options) {
+        this.ensureNotDisposed();
+        await this.ensureLoaded(options.onProgress);
+        try {
+            const texts = contents.map((content) => formatText(content.text, options.purpose, this.entry));
+            if (this.workerPool) {
+                return await this.workerPool.run(texts, options.signal);
+            }
+            return await this.embedTexts(texts);
+        }
+        catch (cause) {
+            throw new EngineError("Model2Vec embedding failed", {
+                code: "ZVEC_GREP.ENGINE.MODELS.MODEL2VEC_EMBED_FAILED",
+                context: `model=${this.entry.reference} repo=${this.entry.repo}`,
+                cause,
+            });
+        }
+    }
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        await this.workerPool?.dispose();
+        this.workerPool = null;
+        this.staticTable = null;
+        this.tokenizer = null;
+        this.loadPromise = null;
+    }
+    async ensureLoaded(onProgress) {
+        if (this.workerPool || (this.tokenizer && this.staticTable)) {
+            return;
+        }
+        if (this.loadPromise) {
+            return await this.loadPromise;
+        }
+        this.loadPromise = this.loadModel(onProgress);
+        try {
+            await this.loadPromise;
+        }
+        finally {
+            this.loadPromise = null;
+        }
+    }
+    async loadModel(onProgress) {
+        const downloadProgress = createModelDownloadProgressReporter(this.entry.reference, onProgress, [basename(this.entry.modelFile), basename(this.entry.tokenizerFile)]);
+        downloadProgress.start();
+        const [modelPath, tokenizerSource] = await Promise.all([
+            this.resolveModelPath(downloadProgress),
+            this.resolveTokenizerSource(downloadProgress),
+        ]);
+        const staticTable = await this.dependencies.loadSafetensors(modelPath, this.entry.embeddingTensor, this.info.dimension);
+        this.ensureNotDisposed();
+        if (this.useWorkerPool) {
+            const sharedTable = sharedStaticEmbeddingTable(staticTable);
+            const workerPool = new Model2VecWorkerPool({
+                tokenizerSource,
+                maxInputTokens: this.entry.maxInputTokens,
+                normalize: this.entry.normalize,
+                tableBuffer: sharedTable.data.buffer,
+                dimension: sharedTable.dimension,
+                dtype: sharedTable.dtype,
+                rows: sharedTable.rows,
+            });
+            try {
+                await workerPool.start();
+                this.ensureNotDisposed();
+                this.workerPool = workerPool;
+            }
+            catch (error) {
+                await workerPool.dispose();
+                throw error;
+            }
+        }
+        else {
+            this.tokenizer = await this.dependencies.loadTokenizer(tokenizerSource, {
+                cache_dir: this.modelCacheDir,
+                revision: this.entry.revision,
+                ...(tokenizerSource !== this.entry.repo
+                    ? { local_files_only: true }
+                    : {}),
+            });
+            this.ensureNotDisposed();
+            this.staticTable = staticTable;
+        }
+        downloadProgress.finish();
+    }
+    async resolveModelPath(downloadProgress) {
+        const modelPath = join(this.modelCacheDir, "model2vec", this.entry.repo.replaceAll("/", "--"), this.entry.revision, basename(this.entry.modelFile));
+        return await this.resolveCachedFile(this.entry.modelFile, modelPath, downloadProgress);
+    }
+    async resolveTokenizerSource(downloadProgress) {
+        const tokenizerDirectory = join(this.modelCacheDir, "model2vec", this.entry.repo.replaceAll("/", "--"), this.entry.revision, "tokenizer");
+        await this.resolveCachedFile(this.entry.tokenizerFile, join(tokenizerDirectory, "tokenizer.json"), downloadProgress);
+        const configPath = join(tokenizerDirectory, "tokenizer_config.json");
+        if (!isUsableModelFile(configPath)) {
+            await writeFile(configPath, `${JSON.stringify({ tokenizer_class: "PreTrainedTokenizer" })}\n`);
+        }
+        return tokenizerDirectory;
+    }
+    async resolveCachedFile(remoteFile, localPath, downloadProgress) {
+        if (isUsableModelFile(localPath)) {
+            downloadProgress.skip(basename(remoteFile));
+            return localPath;
+        }
+        await mkdir(dirname(localPath), { recursive: true });
+        const partialPath = `${localPath}.part-${process.pid}-${Date.now()}`;
+        const url = `https://huggingface.co/${this.entry.repo}/resolve/${this.entry.revision}/${remoteFile}`;
+        try {
+            await this.dependencies.download(url, partialPath, (progress) => {
+                downloadProgress.report({
+                    artifact: basename(remoteFile),
+                    ...progress,
+                });
+            });
+            if (!isUsableModelFile(partialPath)) {
+                throw new Error("Downloaded model file is empty");
+            }
+            await rename(partialPath, localPath);
+            return localPath;
+        }
+        catch (cause) {
+            await rm(partialPath, { force: true });
+            throw new EngineError("Unable to download Model2Vec model artifact", {
+                code: "ZVEC_GREP.ENGINE.MODELS.MODEL2VEC_DOWNLOAD_FAILED",
+                context: `model=${this.entry.reference} url=${url}`,
+                cause,
+            });
+        }
+    }
+    async embedTexts(texts) {
+        const tokenizer = this.tokenizer;
+        const staticTable = this.staticTable;
+        if (!tokenizer || !staticTable) {
+            throw new Error("Model2Vec model is not loaded");
+        }
+        return await embedModel2VecTexts(texts, tokenizer, staticTable, this.entry.maxInputTokens, this.entry.normalize);
+    }
+    ensureNotDisposed() {
+        if (this.disposed) {
+            throw new EngineError("Model2Vec embedding model is disposed", {
+                code: "ZVEC_GREP.ENGINE.MODELS.MODEL2VEC_DISPOSED",
+                context: `model=${this.entry.reference}`,
+            });
+        }
+    }
+}
+function isUsableModelFile(path) {
+    return existsSync(path) && statSync(path).size > 0;
+}
+function formatText(text, purpose, entry) {
+    const prefix = purpose === "query"
+        ? "queryPrefix" in entry && typeof entry.queryPrefix === "string"
+            ? entry.queryPrefix
+            : undefined
+        : "documentPrefix" in entry && typeof entry.documentPrefix === "string"
+            ? entry.documentPrefix
+            : undefined;
+    return prefix ? `${prefix}${text}` : text;
+}
+async function readStaticEmbeddingTable(path, tensorName, expectedDimension) {
+    const file = await open(path, "r");
+    try {
+        const stats = await file.stat();
+        if (stats.size < 9) {
+            throw new Error("Safetensors file is too small");
+        }
+        const prefix = Buffer.alloc(8);
+        await readExactly(file, prefix, 0);
+        const headerLength = Number(prefix.readBigUInt64LE(0));
+        const dataStart = 8 + headerLength;
+        if (!Number.isSafeInteger(headerLength) || dataStart > stats.size) {
+            throw new Error("Safetensors header length is invalid");
+        }
+        const headerBytes = Buffer.alloc(headerLength);
+        await readExactly(file, headerBytes, 8);
+        let header;
+        try {
+            header = JSON.parse(headerBytes.toString("utf8"));
+        }
+        catch (cause) {
+            throw new Error("Safetensors header is invalid JSON", { cause });
+        }
+        const tensor = header[tensorName];
+        if (!tensor ||
+            tensor.shape?.length !== 2 ||
+            tensor.shape[1] !== expectedDimension ||
+            tensor.data_offsets?.length !== 2 ||
+            (tensor.dtype !== "F16" && tensor.dtype !== "F32")) {
+            throw new Error(`Safetensors tensor '${tensorName}' is missing or incompatible`);
+        }
+        const [relativeStart, relativeEnd] = tensor.data_offsets;
+        const rows = tensor.shape[0];
+        const valueCount = rows * expectedDimension;
+        const bytesPerValue = tensor.dtype === "F16" ? 2 : 4;
+        const tensorByteLength = valueCount * bytesPerValue;
+        if (!Number.isSafeInteger(valueCount) ||
+            !Number.isSafeInteger(tensorByteLength) ||
+            relativeStart < 0 ||
+            relativeEnd - relativeStart !== tensorByteLength ||
+            dataStart + relativeEnd > stats.size) {
+            throw new Error(`Safetensors tensor '${tensorName}' has invalid offsets`);
+        }
+        const sharedBuffer = new SharedArrayBuffer(tensorByteLength);
+        await readExactly(file, Buffer.from(sharedBuffer), dataStart + relativeStart);
+        return {
+            data: tensor.dtype === "F16"
+                ? new Uint16Array(sharedBuffer)
+                : new Float32Array(sharedBuffer),
+            dimension: expectedDimension,
+            dtype: tensor.dtype,
+            rows,
+        };
+    }
+    finally {
+        await file.close();
+    }
+}
+async function readExactly(file, buffer, position) {
+    let offset = 0;
+    while (offset < buffer.byteLength) {
+        const { bytesRead } = await file.read(buffer, offset, buffer.byteLength - offset, position + offset);
+        if (bytesRead === 0) {
+            throw new Error("Safetensors file ended unexpectedly");
+        }
+        offset += bytesRead;
+    }
+}
+//# sourceMappingURL=model2vec.js.map

package/dist/engine/models/backends/model2vec.js.map

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

package/dist/engine/models/backends/qwen.d.ts

@@ -0,0 +1,44 @@
+import type { Content } from "../../types.js";
+import { BaseEmbeddingModel, type CreateEmbeddingModelOptions, type EmbeddingModelInfo, type EmbeddingResult, type NormalizedEmbeddingOptions } from "../embeddings.js";
+import type { QwenMultimodalEmbeddingCatalogEntry, QwenTextEmbeddingCatalogEntry } from "../catalog.js";
+type QwenDependencies = {
+    fetch: typeof globalThis.fetch;
+};
+type QwenTextEmbeddingSpec = {
+    displayName: string;
+    errorCodePrefix: string;
+};
+type QwenTextEmbeddingV4CatalogEntry = Extract<QwenTextEmbeddingCatalogEntry, {
+    model: "text-embedding-v4";
+}>;
+type Qwen37TextEmbeddingCatalogEntry = Extract<QwenTextEmbeddingCatalogEntry, {
+    model: "qwen3.7-text-embedding";
+}>;
+declare abstract class QwenTextEmbeddingModel extends BaseEmbeddingModel {
+    readonly info: EmbeddingModelInfo;
+    private readonly entry;
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly displayName;
+    private readonly errorCodePrefix;
+    private readonly dependencies;
+    constructor(entry: QwenTextEmbeddingCatalogEntry, spec: QwenTextEmbeddingSpec, options: CreateEmbeddingModelOptions, dependencies: Partial<QwenDependencies>);
+    protected doEmbed(contents: readonly Content[], options: NormalizedEmbeddingOptions): Promise<EmbeddingResult>;
+    private errorCode;
+}
+export declare class QwenTextEmbeddingV4Model extends QwenTextEmbeddingModel {
+    constructor(entry: QwenTextEmbeddingV4CatalogEntry, options: CreateEmbeddingModelOptions, dependencies?: Partial<QwenDependencies>);
+}
+export declare class Qwen37TextEmbeddingModel extends QwenTextEmbeddingModel {
+    constructor(entry: Qwen37TextEmbeddingCatalogEntry, options: CreateEmbeddingModelOptions, dependencies?: Partial<QwenDependencies>);
+}
+export declare class Qwen3VlEmbeddingModel extends BaseEmbeddingModel {
+    readonly info: EmbeddingModelInfo;
+    private readonly entry;
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly dependencies;
+    constructor(entry: QwenMultimodalEmbeddingCatalogEntry, options: CreateEmbeddingModelOptions, dependencies?: Partial<QwenDependencies>);
+    protected doEmbed(contents: readonly Content[], options: NormalizedEmbeddingOptions): Promise<EmbeddingResult>;
+}
+export {};