@devflow-tools/memory-engine 0.16.11 → 0.16.12

package/dist/embedding-model-store.d.ts

@@ -0,0 +1,67 @@
+export declare const EMBEDDING_MODEL_ID = "Xenova/all-MiniLM-L6-v2";
+export declare const EMBEDDING_MODEL_REVISION = "751bff37182d3f1213fa05d7196b954e230abad9";
+export interface EmbeddingModelFileManifest {
+    path: string;
+    size: number;
+    sha256: string;
+}
+export declare const EMBEDDING_MODEL_FILES: readonly EmbeddingModelFileManifest[];
+export type EmbeddingModelFileState = "ready" | "missing" | "corrupt";
+export type EmbeddingModelState = "ready" | "missing" | "corrupt";
+export interface EmbeddingModelFileStatus extends EmbeddingModelFileManifest {
+    absolutePath: string;
+    state: EmbeddingModelFileState;
+    actualSize?: number;
+    actualSha256?: string;
+}
+export interface EmbeddingModelStatus {
+    ready: boolean;
+    state: EmbeddingModelState;
+    modelId: string;
+    revision: string;
+    cacheRoot: string;
+    modelPath: string;
+    files: EmbeddingModelFileStatus[];
+    missingFiles: string[];
+    corruptFiles: string[];
+}
+export type EmbeddingModelPrepareSource = "existing" | "legacy_cache" | "download";
+export interface EmbeddingModelPrepareResult extends EmbeddingModelStatus {
+    source: EmbeddingModelPrepareSource;
+    attemptedEndpoints: string[];
+    migratedFrom?: string;
+}
+export interface EmbeddingModelStoreOptions {
+    env?: NodeJS.ProcessEnv;
+    homeDir?: string;
+    cacheRoot?: string;
+    cwd?: string;
+    endpoints?: string[];
+    legacyCacheRoots?: string[];
+    allowDownload?: boolean;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}
+export declare class EmbeddingModelUnavailableError extends Error {
+    readonly details: {
+        cacheRoot: string;
+        attemptedEndpoints: string[];
+        retryAt?: number;
+        causes?: string[];
+    };
+    readonly category = "embedding_model_unavailable";
+    readonly retryWithoutAttempt = true;
+    constructor(message: string, details: {
+        cacheRoot: string;
+        attemptedEndpoints: string[];
+        retryAt?: number;
+        causes?: string[];
+    });
+    get retryAfterMs(): number | undefined;
+}
+export declare function getEmbeddingModelCacheRoot(options?: Pick<EmbeddingModelStoreOptions, "cacheRoot" | "env" | "homeDir">): string;
+export declare function getEmbeddingModelPath(options?: Pick<EmbeddingModelStoreOptions, "cacheRoot" | "env" | "homeDir">): string;
+export declare function resolveEmbeddingModelEndpoints(options?: Pick<EmbeddingModelStoreOptions, "endpoints" | "env">): string[];
+export declare function inspectEmbeddingModel(options?: Pick<EmbeddingModelStoreOptions, "cacheRoot" | "env" | "homeDir">): Promise<EmbeddingModelStatus>;
+export declare function prepareEmbeddingModel(options?: EmbeddingModelStoreOptions): Promise<EmbeddingModelPrepareResult>;
+//# sourceMappingURL=embedding-model-store.d.ts.map

package/dist/embedding-model-store.d.ts.map

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

package/dist/embedding-model-store.js

@@ -0,0 +1,350 @@
+import { createHash, randomUUID } from "node:crypto";
+import { chmod, copyFile, mkdir, open, rename, rm, stat, } from "node:fs/promises";
+import { createReadStream } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const EMBEDDING_MODEL_ID = "Xenova/all-MiniLM-L6-v2";
+export const EMBEDDING_MODEL_REVISION = "751bff37182d3f1213fa05d7196b954e230abad9";
+const DEFAULT_ENDPOINTS = [
+    "https://huggingface.co",
+    "https://hf-mirror.com",
+];
+const DEFAULT_DOWNLOAD_TIMEOUT_MS = 60_000;
+const ENDPOINT_PROBE_TIMEOUT_MS = 8_000;
+const ongoingPreparations = new Map();
+export const EMBEDDING_MODEL_FILES = [
+    {
+        path: "config.json",
+        size: 650,
+        sha256: "7135149f7cffa1a573466c6e4d8423ed73b62fd2332c575bf738a0d033f70df7",
+    },
+    {
+        path: "tokenizer.json",
+        size: 711_661,
+        sha256: "da0e79933b9ed51798a3ae27893d3c5fa4a201126cef75586296df9b4d2c62a0",
+    },
+    {
+        path: "tokenizer_config.json",
+        size: 366,
+        sha256: "9261e7d79b44c8195c1cada2b453e55b00aeb81e907a6664974b4d7776172ab3",
+    },
+    {
+        path: "onnx/model_quantized.onnx",
+        size: 22_972_370,
+        sha256: "afdb6f1a0e45b715d0bb9b11772f032c399babd23bfc31fed1c170afc848bdb1",
+    },
+];
+export class EmbeddingModelUnavailableError extends Error {
+    details;
+    category = "embedding_model_unavailable";
+    retryWithoutAttempt = true;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "EmbeddingModelUnavailableError";
+    }
+    get retryAfterMs() {
+        return this.details.retryAt === undefined
+            ? undefined
+            : Math.max(0, this.details.retryAt - Date.now());
+    }
+}
+export function getEmbeddingModelCacheRoot(options = {}) {
+    const env = options.env ?? process.env;
+    return resolve(options.cacheRoot
+        ?? env.DEVFLOW_EMBEDDING_MODEL_DIR
+        ?? join(options.homeDir ?? homedir(), ".devflow", "models", "transformers-cache"));
+}
+export function getEmbeddingModelPath(options = {}) {
+    return join(getEmbeddingModelCacheRoot(options), ...EMBEDDING_MODEL_ID.split("/"), EMBEDDING_MODEL_REVISION);
+}
+export function resolveEmbeddingModelEndpoints(options = {}) {
+    const env = options.env ?? process.env;
+    const configured = [
+        ...(options.endpoints ?? []),
+        ...splitEndpoints(env.DEVFLOW_HF_ENDPOINTS),
+        env.DEVFLOW_HF_ENDPOINT,
+        env.HF_ENDPOINT,
+    ];
+    const endpoints = [...configured, ...DEFAULT_ENDPOINTS];
+    return [...new Set(endpoints
+            .filter((value) => typeof value === "string" && value.trim().length > 0)
+            .map(normalizeEndpoint))];
+}
+export async function inspectEmbeddingModel(options = {}) {
+    const cacheRoot = getEmbeddingModelCacheRoot(options);
+    const modelPath = getEmbeddingModelPath(options);
+    const files = [];
+    for (const manifest of EMBEDDING_MODEL_FILES) {
+        files.push(await inspectModelFile(modelPath, manifest));
+    }
+    const missingFiles = files.filter(file => file.state === "missing").map(file => file.path);
+    const corruptFiles = files.filter(file => file.state === "corrupt").map(file => file.path);
+    const state = corruptFiles.length > 0
+        ? "corrupt"
+        : missingFiles.length > 0
+            ? "missing"
+            : "ready";
+    return {
+        ready: state === "ready",
+        state,
+        modelId: EMBEDDING_MODEL_ID,
+        revision: EMBEDDING_MODEL_REVISION,
+        cacheRoot,
+        modelPath,
+        files,
+        missingFiles,
+        corruptFiles,
+    };
+}
+export function prepareEmbeddingModel(options = {}) {
+    const cacheRoot = getEmbeddingModelCacheRoot(options);
+    const existing = ongoingPreparations.get(cacheRoot);
+    if (existing)
+        return existing;
+    const preparation = prepareEmbeddingModelOnce({ ...options, cacheRoot })
+        .finally(() => {
+        if (ongoingPreparations.get(cacheRoot) === preparation) {
+            ongoingPreparations.delete(cacheRoot);
+        }
+    });
+    ongoingPreparations.set(cacheRoot, preparation);
+    return preparation;
+}
+async function prepareEmbeddingModelOnce(options) {
+    const existing = await inspectEmbeddingModel(options);
+    if (existing.ready) {
+        return { ...existing, source: "existing", attemptedEndpoints: [] };
+    }
+    const legacyModelPaths = resolveLegacyModelPaths(options, existing.cacheRoot);
+    for (const legacyModelPath of legacyModelPaths) {
+        if (legacyModelPath === existing.modelPath)
+            continue;
+        if (!await modelDirectoryIsValid(legacyModelPath))
+            continue;
+        await copyVerifiedModel(legacyModelPath, existing.modelPath);
+        const migrated = await inspectEmbeddingModel(options);
+        if (migrated.ready) {
+            return {
+                ...migrated,
+                source: "legacy_cache",
+                attemptedEndpoints: [],
+                migratedFrom: legacyModelPath,
+            };
+        }
+    }
+    if (options.allowDownload === false) {
+        throw unavailableError(existing, [], ["No verified local embedding model was found"]);
+    }
+    const endpoints = resolveEmbeddingModelEndpoints(options);
+    const attemptedEndpoints = [];
+    const causes = [];
+    for (const endpoint of endpoints) {
+        attemptedEndpoints.push(endpoint);
+        try {
+            await downloadModelFromEndpoint(endpoint, existing.modelPath, options);
+            const downloaded = await inspectEmbeddingModel(options);
+            if (downloaded.ready) {
+                return { ...downloaded, source: "download", attemptedEndpoints };
+            }
+            causes.push(`${endpoint}: downloaded model failed integrity validation`);
+        }
+        catch (error) {
+            causes.push(`${endpoint}: ${formatError(error)}`);
+        }
+    }
+    throw unavailableError(await inspectEmbeddingModel(options), attemptedEndpoints, causes);
+}
+async function inspectModelFile(modelPath, manifest) {
+    const absolutePath = join(modelPath, manifest.path);
+    return inspectFileAtPath(absolutePath, manifest);
+}
+async function inspectFileAtPath(absolutePath, manifest) {
+    let fileStat;
+    try {
+        fileStat = await stat(absolutePath);
+    }
+    catch (error) {
+        if (isNodeError(error, "ENOENT")) {
+            return { ...manifest, absolutePath, state: "missing" };
+        }
+        throw error;
+    }
+    if (!fileStat.isFile() || fileStat.size !== manifest.size) {
+        return {
+            ...manifest,
+            absolutePath,
+            state: "corrupt",
+            actualSize: fileStat.size,
+        };
+    }
+    const actualSha256 = await hashFile(absolutePath);
+    return {
+        ...manifest,
+        absolutePath,
+        state: actualSha256 === manifest.sha256 ? "ready" : "corrupt",
+        actualSize: fileStat.size,
+        actualSha256,
+    };
+}
+async function modelDirectoryIsValid(modelPath) {
+    for (const manifest of EMBEDDING_MODEL_FILES) {
+        const status = await inspectModelFile(modelPath, manifest);
+        if (status.state !== "ready")
+            return false;
+    }
+    return true;
+}
+async function hashFile(path) {
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(path))
+        hash.update(chunk);
+    return hash.digest("hex");
+}
+async function copyVerifiedModel(source, target) {
+    for (const manifest of EMBEDDING_MODEL_FILES) {
+        await atomicCopy(join(source, manifest.path), join(target, manifest.path), manifest);
+    }
+}
+async function atomicCopy(source, target, manifest) {
+    await mkdir(dirname(target), { recursive: true, mode: 0o700 });
+    const temporary = `${target}.part-${process.pid}-${randomUUID()}`;
+    try {
+        await copyFile(source, temporary);
+        await chmod(temporary, 0o600);
+        const status = await inspectFileAtPath(temporary, manifest);
+        if (status.state !== "ready")
+            throw new Error(`Legacy cache file failed validation: ${manifest.path}`);
+        await rename(temporary, target);
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => undefined);
+    }
+}
+async function downloadModelFromEndpoint(endpoint, targetModelPath, options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const timeoutMs = positiveTimeout(options.timeoutMs, options.env ?? process.env);
+    await probeEndpoint(endpoint, fetchImpl, Math.min(timeoutMs, ENDPOINT_PROBE_TIMEOUT_MS));
+    for (const manifest of EMBEDDING_MODEL_FILES) {
+        const current = await inspectModelFile(targetModelPath, manifest);
+        if (current.state === "ready")
+            continue;
+        const url = modelFileUrl(endpoint, manifest.path);
+        const data = await downloadBufferWithTimeout(fetchImpl, url, timeoutMs);
+        if (data.byteLength !== manifest.size) {
+            throw new Error(`Size mismatch for ${manifest.path}: expected ${manifest.size}, received ${data.byteLength}`);
+        }
+        const sha256 = createHash("sha256").update(data).digest("hex");
+        if (sha256 !== manifest.sha256) {
+            throw new Error(`SHA-256 mismatch for ${manifest.path}`);
+        }
+        await atomicWrite(join(targetModelPath, manifest.path), data);
+    }
+}
+async function downloadBufferWithTimeout(fetchImpl, url, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    timer.unref?.();
+    try {
+        const response = await fetchImpl(url, { redirect: "follow", signal: controller.signal });
+        if (!response.ok)
+            throw new Error(`HTTP ${response.status} for ${url}`);
+        return Buffer.from(await response.arrayBuffer());
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function probeEndpoint(endpoint, fetchImpl, timeoutMs) {
+    const response = await fetchWithTimeout(fetchImpl, modelFileUrl(endpoint, "config.json"), timeoutMs);
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status} while probing ${endpoint}`);
+    await response.body?.cancel().catch(() => undefined);
+}
+async function fetchWithTimeout(fetchImpl, url, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    timer.unref?.();
+    try {
+        return await fetchImpl(url, { redirect: "follow", signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function atomicWrite(target, data) {
+    await mkdir(dirname(target), { recursive: true, mode: 0o700 });
+    const temporary = `${target}.part-${process.pid}-${randomUUID()}`;
+    try {
+        const handle = await open(temporary, "wx", 0o600);
+        try {
+            await handle.writeFile(data);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await rename(temporary, target);
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => undefined);
+    }
+}
+function resolveLegacyModelPaths(options, cacheRoot) {
+    const env = options.env ?? process.env;
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    const projectRoots = [cwd, env.DEVFLOW_PROJECT_ROOT, env.CLAUDE_PROJECT_DIR]
+        .filter((value) => typeof value === "string" && value.trim().length > 0)
+        .map(value => resolve(value));
+    const cacheRoots = [
+        ...(options.legacyCacheRoots ?? []),
+        ...splitLegacyRoots(env.DEVFLOW_EMBEDDING_LEGACY_CACHE_DIRS),
+        ...projectRoots.map(root => join(root, "node_modules", "@xenova", "transformers", ".cache")),
+        resolve(moduleDir, "../../../node_modules/@xenova/transformers/.cache"),
+        resolve(moduleDir, "../../../@xenova/transformers/.cache"),
+        cacheRoot,
+    ];
+    const paths = cacheRoots.flatMap(root => {
+        const modelRoot = join(resolve(root), ...EMBEDDING_MODEL_ID.split("/"));
+        return [join(modelRoot, EMBEDDING_MODEL_REVISION), modelRoot];
+    });
+    return [...new Set(paths)];
+}
+function modelFileUrl(endpoint, path) {
+    return `${normalizeEndpoint(endpoint)}/${EMBEDDING_MODEL_ID}/resolve/${EMBEDDING_MODEL_REVISION}/${path}`;
+}
+function unavailableError(status, attemptedEndpoints, causes) {
+    return new EmbeddingModelUnavailableError([
+        `Verified embedding model is unavailable in ${status.cacheRoot}`,
+        causes.length > 0 ? causes.join(" | ") : null,
+    ].filter(Boolean).join(": "), { cacheRoot: status.cacheRoot, attemptedEndpoints, causes });
+}
+function normalizeEndpoint(endpoint) {
+    return endpoint.trim().replace(/\/+$/, "");
+}
+function splitEndpoints(value) {
+    return value?.split(/[;,\n]/).map(endpoint => endpoint.trim()).filter(Boolean) ?? [];
+}
+function splitLegacyRoots(value) {
+    return value?.split(/[\n,;]/).map(path => path.trim()).filter(Boolean) ?? [];
+}
+function positiveTimeout(value, env) {
+    const configured = value ?? Number(env.DEVFLOW_EMBEDDING_DOWNLOAD_TIMEOUT_MS);
+    return Number.isSafeInteger(configured) && configured > 0
+        ? configured
+        : DEFAULT_DOWNLOAD_TIMEOUT_MS;
+}
+function formatError(error) {
+    if (error instanceof AggregateError) {
+        return [error.message, ...error.errors.map(formatError)].filter(Boolean).join(": ");
+    }
+    if (!(error instanceof Error))
+        return String(error);
+    return error.cause ? `${error.message}: ${formatError(error.cause)}` : error.message;
+}
+function isNodeError(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+//# sourceMappingURL=embedding-model-store.js.map

package/dist/embedding-model-store.js.map

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

package/dist/embedding-provider.d.ts

@@ -1,5 +1,11 @@
 export type EmbeddingStatus = "idle" | "warming" | "ready" | "failed";
 export declare const EMBEDDING_DIMENSIONS = 384;
+export declare class EmbeddingWarmupTimeoutError extends Error {
+    readonly category = "embedding_warmup_timeout";
+    readonly retryWithoutAttempt = true;
+    readonly retryAfterMs = 30000;
+    constructor(timeoutMs: number);
+}
 export declare function assertEmbeddingBatch(embeddings: Float32Array[], expectedCount: number, dimensions?: number): void;
 type EmbeddingPipeline = (texts: string[]) => Promise<Array<{
     data: Float32Array;
@@ -8,6 +14,7 @@ export declare class EmbeddingProvider {
     private readonly pipelineLoader;
     private status;
     private lastError;
+    private lastFailure;
     private initializationPromise;
     private pipeline;
     private errorLogPath;
@@ -15,6 +22,7 @@ export declare class EmbeddingProvider {
     isReady(): boolean;
     getStatus(): EmbeddingStatus;
     getLastError(): string | null;
+    getLastFailure(): Error | null;
     initialize(): Promise<void>;
     warmup(options?: {
         timeoutMs?: number;

package/dist/embedding-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AACtE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,YAAY,EAAE,EAC1B,aAAa,EAAE,MAAM,EACrB,UAAU,SAAuB,GAChC,IAAI,CAiBN;AAED,KAAK,iBAAiB,GAAG,CACvB,KAAK,EAAE,MAAM,EAAE,KACZ,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAAC;AA0E5C,qBAAa,iBAAiB;IAa1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAZjC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,YAAY,CAKlB;gBAGiB,cAAc,GAAE,MAAM,OAAO,CAAC,iBAAiB,CAC5C;IAGtB,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,eAAe;IAI5B,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,MAAM,CAAC,OAAO,GAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BnB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAY1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1D,OAAO,CAAC,SAAS;YAKH,aAAa;YAOb,UAAU;CAazB"}
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AACtE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,QAAQ,8BAA8B;IAC/C,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,YAAY,SAAU;gBAEnB,SAAS,EAAE,MAAM;CAI9B;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,YAAY,EAAE,EAC1B,aAAa,EAAE,MAAM,EACrB,UAAU,SAAuB,GAChC,IAAI,CAiBN;AAED,KAAK,iBAAiB,GAAG,CACvB,KAAK,EAAE,MAAM,EAAE,KACZ,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAAC;AAqH5C,qBAAa,iBAAiB;IAc1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAbjC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,YAAY,CAKlB;gBAGiB,cAAc,GAAE,MAAM,OAAO,CAAC,iBAAiB,CAC5C;IAGtB,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,eAAe;IAI5B,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,cAAc,IAAI,KAAK,GAAG,IAAI;IAI9B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,MAAM,CAAC,OAAO,GAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BnB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAY1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAa1D,OAAO,CAAC,SAAS;YAMH,aAAa;YASb,UAAU;CAazB"}

package/dist/embedding-provider.js

@@ -1,7 +1,17 @@
 import { appendFile, chmod, mkdir } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
+import { EMBEDDING_MODEL_ID, EMBEDDING_MODEL_REVISION, EmbeddingModelUnavailableError, prepareEmbeddingModel, } from "./embedding-model-store.js";
 export const EMBEDDING_DIMENSIONS = 384;
+export class EmbeddingWarmupTimeoutError extends Error {
+    category = "embedding_warmup_timeout";
+    retryWithoutAttempt = true;
+    retryAfterMs = 30_000;
+    constructor(timeoutMs) {
+        super(`Embedding model warmup timed out after ${timeoutMs}ms`);
+        this.name = "EmbeddingWarmupTimeoutError";
+    }
+}
 export function assertEmbeddingBatch(embeddings, expectedCount, dimensions = EMBEDDING_DIMENSIONS) {
     if (embeddings.length !== expectedCount) {
         throw new Error(`Observation vector count mismatch: ${expectedCount} observations, ${embeddings.length} vectors`);
@@ -30,20 +40,28 @@ function splitBatchTensor(result, expectedCount) {
 }
 let sharedPipeline = null;
 let sharedPipelinePromise = null;
+let sharedModelPreparePromise = null;
+let sharedCircuit = null;
+const DEFAULT_CIRCUIT_OPEN_MS = 5 * 60_000;
 function loadSharedPipeline() {
     if (sharedPipeline)
         return Promise.resolve(sharedPipeline);
     if (sharedPipelinePromise)
         return sharedPipelinePromise;
+    if (sharedCircuit && sharedCircuit.retryAt > Date.now()) {
+        return Promise.reject(withCircuitRetry(sharedCircuit.error, sharedCircuit.retryAt));
+    }
+    sharedCircuit = null;
     sharedPipelinePromise = (async () => {
+        sharedModelPreparePromise ??= prepareEmbeddingModel();
+        const prepared = await sharedModelPreparePromise;
         const { pipeline: transformersPipeline, env: transformersEnv, } = await import("@xenova/transformers");
-        const remoteHost = process.env.DEVFLOW_HF_ENDPOINT ?? process.env.HF_ENDPOINT;
-        if (remoteHost) {
-            transformersEnv.remoteHost = remoteHost.endsWith("/")
-                ? remoteHost
-                : `${remoteHost}/`;
-        }
-        const raw = await transformersPipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+        transformersEnv.cacheDir = prepared.cacheRoot;
+        const raw = await transformersPipeline("feature-extraction", EMBEDDING_MODEL_ID, {
+            revision: EMBEDDING_MODEL_REVISION,
+            cache_dir: prepared.cacheRoot,
+            local_files_only: true,
+        });
         const loaded = async (texts) => {
             const result = await raw(texts, { pooling: "mean", normalize: true });
             return Array.isArray(result)
@@ -51,25 +69,56 @@ function loadSharedPipeline() {
                 : splitBatchTensor(result, texts.length);
         };
         sharedPipeline = loaded;
+        sharedCircuit = null;
         return loaded;
     })().catch((error) => {
         sharedPipelinePromise = null;
-        throw error;
+        sharedModelPreparePromise = null;
+        const normalized = normalizeError(error);
+        if (normalized instanceof EmbeddingModelUnavailableError) {
+            const retryAt = Date.now() + circuitOpenMs();
+            sharedCircuit = { error: normalized, retryAt };
+            throw withCircuitRetry(normalized, retryAt);
+        }
+        sharedCircuit = null;
+        throw normalized;
     });
     return sharedPipelinePromise;
 }
 function errorMessage(error) {
+    if (error instanceof AggregateError) {
+        return [error.message, ...error.errors.map(errorMessage)].filter(Boolean).join(": ");
+    }
     if (!(error instanceof Error))
         return String(error);
-    const cause = error.cause instanceof Error ? error.cause.message : null;
+    const cause = error.cause ? errorMessage(error.cause) : null;
     return cause && cause !== error.message
         ? `${error.message}: ${cause}`
         : error.message;
 }
+function normalizeError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function withCircuitRetry(error, retryAt) {
+    if (error instanceof EmbeddingModelUnavailableError) {
+        return new EmbeddingModelUnavailableError(error.message, {
+            ...error.details,
+            retryAt,
+        });
+    }
+    return error;
+}
+function circuitOpenMs() {
+    const configured = Number(process.env.DEVFLOW_EMBEDDING_CIRCUIT_OPEN_MS);
+    return Number.isSafeInteger(configured) && configured > 0
+        ? configured
+        : DEFAULT_CIRCUIT_OPEN_MS;
+}
 export class EmbeddingProvider {
     pipelineLoader;
     status = "idle";
     lastError = null;
+    lastFailure = null;
     initializationPromise = null;
     pipeline = null;
     errorLogPath = join(homedir(), ".devflow", "errors", "embedder.log");
@@ -85,6 +134,9 @@ export class EmbeddingProvider {
     getLastError() {
         return this.lastError;
     }
+    getLastFailure() {
+        return this.lastFailure;
+    }
     initialize() {
         if (this.pipeline) {
             this.markReady();
@@ -118,7 +170,7 @@ export class EmbeddingProvider {
             await Promise.race([
                 this.initialize(),
                 new Promise((_, reject) => {
-                    timeout = setTimeout(() => reject(new Error(`Embedding model warmup timed out after ${timeoutMs}ms`)), timeoutMs);
+                    timeout = setTimeout(() => reject(new EmbeddingWarmupTimeoutError(timeoutMs)), timeoutMs);
                 }),
             ]);
             return this.status === "ready";
@@ -148,6 +200,8 @@ export class EmbeddingProvider {
         }
     }
     async embedBatch(texts) {
+        if (texts.length === 0)
+            return [];
         await this.initialize();
         try {
             const results = await this.pipeline(texts);
@@ -162,11 +216,14 @@ export class EmbeddingProvider {
     markReady() {
         this.status = "ready";
         this.lastError = null;
+        this.lastFailure = null;
     }
     async recordFailure(error) {
-        const message = errorMessage(error);
+        const failure = normalizeError(error);
+        const message = errorMessage(failure);
         this.status = "failed";
         this.lastError = message;
+        this.lastFailure = failure;
         await this.logFailure(message);
     }
     async logFailure(message) {