@alisio/plugin-semantic 0.0.0-stage → 0.1.1

package/dist/engine/models.d.ts

@@ -0,0 +1,45 @@
+/** One file of a pinned model snapshot; `sha256` is checked before the file is ever used (D3). */
+export interface ModelFile {
+    path: string;
+    bytes: number;
+    sha256: string;
+}
+export interface ModelSpec {
+    /** Value of `options.model`. */
+    key: string;
+    label: string;
+    /** Hugging Face repository holding the ONNX export. */
+    repo: string;
+    /** Upstream model the export was converted from (shown in docs and notices). */
+    baseModel: string;
+    license: string;
+    /** Pinned commit of `repo`. */
+    revision: string;
+    dtype: "q8";
+    /** Declared size; the downloaded `config.json` (`hidden_size`) must agree. */
+    dimensions: number;
+    /** Model window in tokens, special tokens included. */
+    maxTokens: number;
+    prefixes: {
+        query: string;
+        document: string;
+    };
+    files: ModelFile[];
+}
+/**
+ * Curated table (§6.3, Q2: no free-form repository ids). Revisions and digests were read from the
+ * real downloads and the Hugging Face LFS metadata on 2026-11-10. The `Xenova/*` repositories are
+ * the ONNX conversions of the upstream models that transformers.js itself loads for `dtype: "q8"`.
+ */
+export declare const MODELS: Record<string, ModelSpec>;
+export declare const DEFAULT_MODEL = "e5-small";
+/** The model chosen by `options.model`; anything outside the table is `unknown_model`. */
+export declare function resolveModel(option: unknown): ModelSpec;
+/** `<repo>@<revision>#<dtype>` (D6): any change makes the core reject old collections. */
+export declare const modelId: (spec: ModelSpec) => string;
+export declare const totalBytes: (spec: ModelSpec) => number;
+/** Directory name of a model snapshot inside the cache. */
+export declare const modelDirName: (spec: ModelSpec) => string;
+/** Consumers never add prefixes (D7): the provider maps the kind to the family's prefix. */
+export declare function applyPrefix(spec: ModelSpec, kind: "query" | "document", text: string): string;
+//# sourceMappingURL=models.d.ts.map

package/dist/engine/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/engine/models.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,CAAC;IACZ,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAKD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAuG5C,CAAC;AAEF,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAMvD;AAED,0FAA0F;AAC1F,eAAO,MAAM,OAAO,SAAU,SAAS,WAAkD,CAAC;AAE1F,eAAO,MAAM,UAAU,SAAU,SAAS,WAAoD,CAAC;AAE/F,2DAA2D;AAC3D,eAAO,MAAM,YAAY,SAAU,SAAS,WAAgD,CAAC;AAE7F,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7F"}

package/dist/engine/models.js

@@ -0,0 +1,132 @@
+import { SemanticPluginError } from "../errors.js";
+const E5 = { query: "query: ", document: "passage: " };
+const ONNX = "onnx/model_quantized.onnx";
+/**
+ * Curated table (§6.3, Q2: no free-form repository ids). Revisions and digests were read from the
+ * real downloads and the Hugging Face LFS metadata on 2026-11-10. The `Xenova/*` repositories are
+ * the ONNX conversions of the upstream models that transformers.js itself loads for `dtype: "q8"`.
+ */
+export const MODELS = {
+    "e5-small": {
+        key: "e5-small",
+        label: "multilingual-e5-small (q8)",
+        repo: "Xenova/multilingual-e5-small",
+        baseModel: "intfloat/multilingual-e5-small",
+        license: "MIT",
+        revision: "761b726dd34fb83930e26aab4e9ac3899aa1fa78",
+        dtype: "q8",
+        dimensions: 384,
+        maxTokens: 512,
+        prefixes: E5,
+        files: [
+            {
+                path: "config.json",
+                bytes: 658,
+                sha256: "cb99455288675345e1a4f411438d5d0adbba5fbd3a67ea4fb03c015433b996c1",
+            },
+            {
+                path: "tokenizer_config.json",
+                bytes: 443,
+                sha256: "a1d6bc8734a6f635dc158508bef000f8e2e5a759c7d92f984b2c86e5ff53425b",
+            },
+            {
+                path: "tokenizer.json",
+                bytes: 17_082_730,
+                sha256: "0b44a9d7b51c3c62626640cda0e2c2f70fdacdc25bbbd68038369d14ebdf4c39",
+            },
+            {
+                path: ONNX,
+                bytes: 118_308_185,
+                sha256: "f80102d3f2a1229f387d3c81909990d8945513e347b0eab049f7de3c6f98c193",
+            },
+        ],
+    },
+    "e5-base": {
+        key: "e5-base",
+        label: "multilingual-e5-base (q8)",
+        repo: "Xenova/multilingual-e5-base",
+        baseModel: "intfloat/multilingual-e5-base",
+        license: "MIT",
+        revision: "1ec9243030a27d1a115d5c340572074c125b58b2",
+        dtype: "q8",
+        dimensions: 768,
+        maxTokens: 512,
+        prefixes: E5,
+        files: [
+            {
+                path: "config.json",
+                bytes: 686,
+                sha256: "4c27930e59106027abab56f7531c1fa6b14bbf31e8229ec36d68affa4e869bcd",
+            },
+            {
+                path: "tokenizer_config.json",
+                bytes: 418,
+                sha256: "efb5c0d09722e5fe59a462cd2a9976ee216d55b037597d997cd3fe833216da15",
+            },
+            {
+                path: "tokenizer.json",
+                bytes: 17_082_660,
+                sha256: "62c24cdc13d4c9952d63718d6c9fa4c287974249e16b7ade6d5a85e7bbb75626",
+            },
+            {
+                path: ONNX,
+                bytes: 278_647_662,
+                sha256: "df7a9a29309e3ad491e1783adf8baee710262cc06079c7cbab63c630277fac94",
+            },
+        ],
+    },
+    minilm: {
+        key: "minilm",
+        label: "paraphrase-multilingual-MiniLM-L12-v2 (q8)",
+        repo: "Xenova/paraphrase-multilingual-MiniLM-L12-v2",
+        baseModel: "sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2",
+        license: "Apache-2.0",
+        revision: "2c4055b12046f11709e9df2c122e59ffbdc2f900",
+        dtype: "q8",
+        dimensions: 384,
+        maxTokens: 128,
+        prefixes: { query: "", document: "" },
+        files: [
+            {
+                path: "config.json",
+                bytes: 673,
+                sha256: "05b570bff786faa5c4604152aa16f19f77ed6dfc31e47dd0f3dd987078693ac7",
+            },
+            {
+                path: "tokenizer_config.json",
+                bytes: 496,
+                sha256: "3f5961b9ac86288cccdb97f32fb848d6187c78e1603958c53f3ea1f296b7d8a2",
+            },
+            {
+                path: "tokenizer.json",
+                bytes: 17_082_913,
+                sha256: "b60b6b43406a48bf3638526314f3d232d97058bc93472ff2de930d43686fa441",
+            },
+            {
+                path: ONNX,
+                bytes: 118_308_126,
+                sha256: "66fc00f5f29afcaff34092e1bdd20008ca3918265a82fb9695a551e510cc4ebc",
+            },
+        ],
+    },
+};
+export const DEFAULT_MODEL = "e5-small";
+/** The model chosen by `options.model`; anything outside the table is `unknown_model`. */
+export function resolveModel(option) {
+    if (option === undefined || option === null)
+        return MODELS[DEFAULT_MODEL];
+    const spec = typeof option === "string" && Object.hasOwn(MODELS, option) ? MODELS[option] : undefined;
+    if (!spec)
+        throw new SemanticPluginError("unknown_model");
+    return spec;
+}
+/** `<repo>@<revision>#<dtype>` (D6): any change makes the core reject old collections. */
+export const modelId = (spec) => `${spec.repo}@${spec.revision}#${spec.dtype}`;
+export const totalBytes = (spec) => spec.files.reduce((sum, f) => sum + f.bytes, 0);
+/** Directory name of a model snapshot inside the cache. */
+export const modelDirName = (spec) => `${spec.key}-${spec.revision.slice(0, 12)}`;
+/** Consumers never add prefixes (D7): the provider maps the kind to the family's prefix. */
+export function applyPrefix(spec, kind, text) {
+    return `${spec.prefixes[kind]}${text}`;
+}
+//# sourceMappingURL=models.js.map

package/dist/engine/models.js.map

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

package/dist/engine/runtime.d.ts

@@ -0,0 +1,46 @@
+import { type Fetcher, type ProgressTracker } from "./download.js";
+export declare const ORT_VERSION = "1.30.0";
+export interface RuntimePackage {
+    name: string;
+    version: string;
+    url: string;
+    /** Size of the tarball. */
+    bytes: number;
+    /** `dist.integrity` from the npm registry (sha512, base64). */
+    integrity: string;
+    /** Archive path -> path under the package directory, or null to skip. */
+    select(path: string, platform: string, arch: string): string | null;
+}
+/** The pinned packages (read from the npm registry on 2026-11-10). */
+export declare const RUNTIME_PACKAGES: RuntimePackage[];
+/** Platforms with a CPU binary in the pinned tarball. */
+export declare const RUNTIME_PLATFORMS: string[];
+export interface RuntimeTarget {
+    platform: string;
+    arch: string;
+}
+export declare const currentTarget: () => RuntimeTarget;
+export declare const runtimeSupported: (target?: RuntimeTarget) => boolean;
+/** Directory of the extracted runtime for one platform. */
+export declare const runtimePath: (cacheRoot: string, target?: RuntimeTarget) => string;
+export declare const runtimeBytes: (packages?: RuntimePackage[]) => number;
+/** Cheap check: the marker matches the pinned packages and every extracted file has its size. */
+export declare function isRuntimeReady(cacheRoot: string, target?: RuntimeTarget, packages?: RuntimePackage[]): Promise<boolean>;
+export interface InstallOptions {
+    fetcher?: Fetcher;
+    signal: AbortSignal;
+    tracker: ProgressTracker;
+    target?: RuntimeTarget;
+    packages?: RuntimePackage[];
+}
+/**
+ * Downloads, verifies and extracts the runtime atomically (temp directory, then rename). A
+ * cancelled or failed install removes its partial tarball and temp directory; a tarball left by a
+ * crash is resumed with `Range` and verified as a whole.
+ */
+export declare function installRuntime(cacheRoot: string, options: InstallOptions): Promise<{
+    installed: boolean;
+}>;
+/** Loads the cached runtime (CommonJS) from its own directory, never from the plugin's deps. */
+export declare function loadRuntime<T = unknown>(dir: string): T;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/engine/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/engine/runtime.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhG,eAAO,MAAM,WAAW,WAAW,CAAC;AAGpC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACrE;AAMD,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAiC5C,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,UAM7B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AACD,eAAO,MAAM,aAAa,QAAO,aAG/B,CAAC;AACH,eAAO,MAAM,gBAAgB,YAAY,aAAa,YACW,CAAC;AAElE,2DAA2D;AAC3D,eAAO,MAAM,WAAW,cAAe,MAAM,WAAU,aAAa,WACa,CAAC;AAElF,eAAO,MAAM,YAAY,cAAc,cAAc,EAAE,WACR,CAAC;AAWhD,iGAAiG;AACjG,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,aAA+B,EACvC,QAAQ,GAAE,cAAc,EAAqB,GAC5C,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAoEjC;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAGvD"}

package/dist/engine/runtime.js

@@ -0,0 +1,172 @@
+// ONNX Runtime fetched on first use (owner O9): the pinned onnxruntime-node npm tarball is
+// downloaded once, verified against the registry's sha512 integrity, and only the current
+// platform's CPU binaries plus the JS loader are extracted into the cache. No npm, no install
+// scripts, never the CUDA/TensorRT providers.
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, rmdir, stat, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { SemanticPluginError } from "../errors.js";
+import { failDownload, fetchVerified } from "./download.js";
+import { extractTarGz } from "./tar.js";
+export const ORT_VERSION = "1.30.0";
+const NAPI = "napi-v6";
+const strip = (path) => path.startsWith("package/") ? path.slice("package/".length) : null;
+const GPU = /cuda|tensorrt/i;
+/** The pinned packages (read from the npm registry on 2026-11-10). */
+export const RUNTIME_PACKAGES = [
+    {
+        name: "onnxruntime-node",
+        version: ORT_VERSION,
+        url: `https://registry.npmjs.org/onnxruntime-node/-/onnxruntime-node-${ORT_VERSION}.tgz`,
+        bytes: 113_507_888,
+        integrity: "sha512-twhs1C2C/BFkz1yc5OY0KIU2GUq6DURO7hD4bx5Q2Qy3nAMJwRXW8xU3NVczE29VA9lolLOYepoD8fjTGOfIqw==",
+        select(path, platform, arch) {
+            const rel = strip(path);
+            if (!rel)
+                return null;
+            if (rel === "package.json")
+                return rel;
+            if (/^dist\/[^/]+\.js$/.test(rel))
+                return rel;
+            const bin = `bin/${NAPI}/${platform}/${arch}/`;
+            if (rel.startsWith(bin) && !rel.slice(bin.length).includes("/") && !GPU.test(rel))
+                return rel;
+            return null;
+        },
+    },
+    {
+        name: "onnxruntime-common",
+        version: ORT_VERSION,
+        url: `https://registry.npmjs.org/onnxruntime-common/-/onnxruntime-common-${ORT_VERSION}.tgz`,
+        bytes: 66_795,
+        integrity: "sha512-7fdVWjAID1dVhH/G8qK3APARunV4VkBFoCQAP7qp4Wkab0mrorvmc+sqiT+mKXOzDqdjN5j+/Z9nb4gzNPWcyA==",
+        select(path) {
+            const rel = strip(path);
+            if (!rel)
+                return null;
+            if (rel === "package.json")
+                return rel;
+            if (/^dist\/cjs\/.+\.js$/.test(rel) || rel === "dist/cjs/package.json")
+                return rel;
+            return null;
+        },
+    },
+];
+/** Platforms with a CPU binary in the pinned tarball. */
+export const RUNTIME_PLATFORMS = [
+    "linux/x64",
+    "linux/arm64",
+    "darwin/arm64",
+    "win32/x64",
+    "win32/arm64",
+];
+export const currentTarget = () => ({
+    platform: process.platform,
+    arch: process.arch,
+});
+export const runtimeSupported = (target = currentTarget()) => RUNTIME_PLATFORMS.includes(`${target.platform}/${target.arch}`);
+/** Directory of the extracted runtime for one platform. */
+export const runtimePath = (cacheRoot, target = currentTarget()) => join(cacheRoot, `onnxruntime-${ORT_VERSION}-${target.platform}-${target.arch}`);
+export const runtimeBytes = (packages = RUNTIME_PACKAGES) => packages.reduce((sum, p) => sum + p.bytes, 0);
+const MARKER = ".verified.json";
+/** Cheap check: the marker matches the pinned packages and every extracted file has its size. */
+export async function isRuntimeReady(cacheRoot, target = currentTarget(), packages = RUNTIME_PACKAGES) {
+    const dir = runtimePath(cacheRoot, target);
+    let marker;
+    try {
+        marker = JSON.parse(await readFile(join(dir, MARKER), "utf8"));
+    }
+    catch {
+        return false;
+    }
+    if (marker.version !== ORT_VERSION ||
+        marker.platform !== target.platform ||
+        marker.arch !== target.arch)
+        return false;
+    if (JSON.stringify(marker.integrity) !== JSON.stringify(packages.map((p) => p.integrity)))
+        return false;
+    const files = Object.entries(marker.files ?? {});
+    if (!files.some(([path]) => path.endsWith("onnxruntime_binding.node")))
+        return false;
+    for (const [path, info] of files) {
+        const s = await stat(join(dir, path)).catch(() => undefined);
+        if (!s?.isFile() || s.size !== info.bytes)
+            return false;
+    }
+    return true;
+}
+/**
+ * Downloads, verifies and extracts the runtime atomically (temp directory, then rename). A
+ * cancelled or failed install removes its partial tarball and temp directory; a tarball left by a
+ * crash is resumed with `Range` and verified as a whole.
+ */
+export async function installRuntime(cacheRoot, options) {
+    const target = options.target ?? currentTarget();
+    const packages = options.packages ?? RUNTIME_PACKAGES;
+    const { signal, tracker } = options;
+    const fetcher = options.fetcher ?? globalThis.fetch;
+    if (!runtimeSupported(target))
+        throw new SemanticPluginError("engine_unavailable");
+    if (await isRuntimeReady(cacheRoot, target, packages))
+        return { installed: false };
+    const partialDir = join(cacheRoot, ".partial", "runtime");
+    const temp = join(cacheRoot, ".partial", `runtime-${randomUUID()}`);
+    await mkdir(partialDir, { recursive: true, mode: 0o700 });
+    const files = {};
+    try {
+        for (const pkg of packages) {
+            signal.throwIfAborted();
+            const archive = join(partialDir, `${pkg.name}-${pkg.version}.tgz`);
+            tracker.begin(`${pkg.name}-${pkg.version}.tgz`, pkg.bytes);
+            const [algorithm, value] = pkg.integrity.split("-", 2);
+            if (algorithm !== "sha512" || !value)
+                throw new SemanticPluginError("model_corrupt");
+            try {
+                await fetchVerified(fetcher, pkg.url, archive, pkg.bytes, { algorithm: "sha512", value, encoding: "base64" }, signal, (n) => tracker.update(n));
+            }
+            catch (error) {
+                await failDownload(archive, error, signal);
+            }
+            const base = join("node_modules", pkg.name);
+            const extracted = await extractTarGz(archive, join(temp, base), (path) => pkg.select(path, target.platform, target.arch), { signal });
+            for (const [path, info] of Object.entries(extracted))
+                files[`${base}/${path}`] = info;
+            await rm(archive, { force: true });
+            tracker.end();
+        }
+        if (!Object.keys(files).some((path) => path.endsWith("onnxruntime_binding.node")))
+            throw new SemanticPluginError("engine_unavailable");
+        const marker = {
+            version: ORT_VERSION,
+            platform: target.platform,
+            arch: target.arch,
+            integrity: packages.map((p) => p.integrity),
+            files,
+        };
+        await writeFile(join(temp, MARKER), JSON.stringify(marker), { mode: 0o600 });
+        const final = runtimePath(cacheRoot, target);
+        await rm(final, { recursive: true, force: true });
+        await mkdir(dirname(final), { recursive: true, mode: 0o700 });
+        await rename(temp, final);
+        return { installed: true };
+    }
+    catch (error) {
+        await rm(temp, { recursive: true, force: true });
+        if (signal.aborted) {
+            await rm(partialDir, { recursive: true, force: true });
+            throw new SemanticPluginError("cancelled");
+        }
+        throw error instanceof SemanticPluginError ? error : new SemanticPluginError("download_failed");
+    }
+    finally {
+        await rm(partialDir, { recursive: true, force: true }).catch(() => { });
+        await rmdir(join(cacheRoot, ".partial")).catch(() => { });
+    }
+}
+/** Loads the cached runtime (CommonJS) from its own directory, never from the plugin's deps. */
+export function loadRuntime(dir) {
+    const require = createRequire(join(dir, "loader.cjs"));
+    return require("onnxruntime-node");
+}
+//# sourceMappingURL=runtime.js.map

package/dist/engine/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/engine/runtime.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,0FAA0F;AAC1F,8FAA8F;AAC9F,8CAA8C;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAgB,YAAY,EAAE,aAAa,EAAwB,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,IAAI,GAAG,SAAS,CAAC;AAcvB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAC7B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,MAAM,GAAG,GAAG,gBAAgB,CAAC;AAE7B,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,WAAW;QACpB,GAAG,EAAE,kEAAkE,WAAW,MAAM;QACxF,KAAK,EAAE,WAAW;QAClB,SAAS,EACP,iGAAiG;QACnG,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI;YACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,IAAI,GAAG,KAAK,cAAc;gBAAE,OAAO,GAAG,CAAC;YACvC,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC;YAC9C,MAAM,GAAG,GAAG,OAAO,IAAI,IAAI,QAAQ,IAAI,IAAI,GAAG,CAAC;YAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC;YAC9F,OAAO,IAAI,CAAC;QACd,CAAC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,WAAW;QACpB,GAAG,EAAE,sEAAsE,WAAW,MAAM;QAC5F,KAAK,EAAE,MAAM;QACb,SAAS,EACP,iGAAiG;QACnG,MAAM,CAAC,IAAI;YACT,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,IAAI,GAAG,KAAK,cAAc;gBAAE,OAAO,GAAG,CAAC;YACvC,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,uBAAuB;gBAAE,OAAO,GAAG,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;KACF;CACF,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW;IACX,aAAa;IACb,cAAc;IACd,WAAW;IACX,aAAa;CACd,CAAC;AAMF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAkB,EAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;CACnB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,GAAkB,aAAa,EAAE,EAAE,EAAE,CAC1E,iBAAiB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAElE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAE,MAAM,GAAkB,aAAa,EAAE,EAAE,EAAE,CACxF,IAAI,CAAC,SAAS,EAAE,eAAe,WAAW,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAElF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,GAAqB,gBAAgB,EAAE,EAAE,CAC5E,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAEhD,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAShC,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,MAAM,GAAkB,aAAa,EAAE,EACvC,QAAQ,GAAqB,gBAAgB;IAE7C,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAW,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IACE,MAAM,CAAC,OAAO,KAAK,WAAW;QAC9B,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QACnC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAE3B,OAAO,KAAK,CAAC;IACf,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACf,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAUD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,OAAuB;IAEvB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACtD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAK,UAAU,CAAC,KAA4B,CAAC;IAC5E,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;IACnF,IAAI,MAAM,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACnF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,UAAU,EAAE,EAAE,CAAC,CAAC;IACpE,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC;YACnE,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3D,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAqB,CAAC;YAC3E,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,mBAAmB,CAAC,eAAe,CAAC,CAAC;YACrF,IAAI,CAAC;gBACH,MAAM,aAAa,CACjB,OAAO,EACP,GAAG,CAAC,GAAG,EACP,OAAO,EACP,GAAG,CAAC,KAAK,EACT,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAClD,MAAM,EACN,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CACzB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,MAAM,YAAY,CAClC,OAAO,EACP,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAChB,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EACxD,EAAE,MAAM,EAAE,CACX,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;gBAAE,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACtF,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;YAC/E,MAAM,IAAI,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;QACtD,MAAM,MAAM,GAAW;YACrB,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3C,KAAK;SACN,CAAC;QACF,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,KAAK,YAAY,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAClG,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvE,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAc,GAAW;IAClD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC,kBAAkB,CAAM,CAAC;AAC1C,CAAC"}

package/dist/engine/setup.d.ts

@@ -0,0 +1,82 @@
+import type { SemanticActivationResult, SemanticApi } from "@alisio/sdk";
+import { type SemanticPluginErrorCode } from "../errors.js";
+import { type Locale } from "../messages.js";
+import { type DownloadProgress, type Fetcher } from "./download.js";
+import type { E5Embedder } from "./embedder.js";
+import { type ModelSpec } from "./models.js";
+import { type RuntimePackage, type RuntimeTarget } from "./runtime.js";
+export declare const EMBEDDING_ID = "semantic.e5";
+export declare const STORE_ID = "semantic.lance";
+export type ActivationOutcome = SemanticActivationResult["status"] | "no_semantic_api" | "activate_unsupported";
+export interface SetupResult {
+    downloaded: boolean;
+    activation: ActivationOutcome;
+    active?: {
+        embedding?: string;
+        store?: string;
+    };
+    message?: string;
+}
+export interface SetupJob {
+    id: string;
+    kind: "setup";
+    state: "running" | "done" | "failed" | "cancelled";
+    progress: number;
+    detail?: DownloadProgress;
+    result?: SetupResult;
+    error?: SemanticPluginErrorCode;
+}
+export interface SetupPlan {
+    key: string;
+    label: string;
+    /** Bytes still to download this first time (runtime + model). 0 once prepared. */
+    bytes: number;
+    prepared: boolean;
+    destination: string;
+    runtime: {
+        bytes: number;
+        ready: boolean;
+        supported: boolean;
+    };
+    model: {
+        bytes: number;
+        ready: boolean;
+    };
+}
+export interface SetupOptions {
+    spec: ModelSpec;
+    cacheRoot: string;
+    embedder: E5Embedder;
+    semantic: SemanticApi | undefined;
+    fetcher?: Fetcher;
+    /** Test seams for the runtime download (defaults: pinned packages, this process's platform). */
+    runtimePackages?: RuntimePackage[];
+    target?: RuntimeTarget;
+}
+/**
+ * The one setup flow shared by `/semantic:setup` and the app's "Prepare" step (§6.1): show the
+ * model, its size and destination; download and verify it as a job with progress; then ask the host
+ * to activate this plugin's providers. Never runs on install or on a first query.
+ */
+export declare class SetupManager {
+    private readonly options;
+    private readonly jobs;
+    private current;
+    constructor(options: SetupOptions);
+    plan(): Promise<SetupPlan>;
+    running(): boolean;
+    get(id: string): SetupJob | undefined;
+    cancel(id: string): boolean;
+    currentId(): string | undefined;
+    cancelRunning(): boolean;
+    /** Starts the setup job, or returns the one already running. */
+    start(): SetupJob;
+    run(): Promise<SetupJob>;
+    /** Full text of `/semantic:setup`: notice (first time only), progress milestones, outcome. */
+    commandText(locale: Locale): Promise<string>;
+    /** Cancels a running download (plugin dispose). */
+    dispose(): void;
+    private execute;
+    private activate;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/engine/setup.d.ts.map

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