dsh-data-domain-knowledge 0.1.0-alpha.11 → 0.1.0-alpha.13

package/lib/types/environment/model-catalog.d.ts

@@ -0,0 +1,191 @@
+/** Models supported by the local embedding and reranking workers. Revisions are pinned in manifest.ts. */
+export declare const EMBEDDING_MODELS: readonly [{
+    readonly id: "bge-small-zh-v1.5";
+    readonly repo: "BAAI/bge-small-zh-v1.5";
+    readonly directory: "bge-small-zh-v1.5";
+    readonly label: "BGE Small 中文";
+    readonly dimension: 512;
+    readonly download: "约 96 MB";
+    readonly description: "资源占用最低，适合先跑通本地知识检索。";
+}, {
+    readonly id: "bge-base-zh-v1.5";
+    readonly repo: "BAAI/bge-base-zh-v1.5";
+    readonly directory: "bge-base-zh-v1.5";
+    readonly label: "BGE Base 中文";
+    readonly dimension: 768;
+    readonly download: "约 409 MB";
+    readonly description: "效果与资源占用较均衡。";
+}, {
+    readonly id: "bge-large-zh-v1.5";
+    readonly repo: "BAAI/bge-large-zh-v1.5";
+    readonly directory: "bge-large-zh-v1.5";
+    readonly label: "BGE Large 中文";
+    readonly dimension: 1024;
+    readonly download: "约 1.3 GB";
+    readonly description: "中文向量效果优先，需要更多内存与磁盘。";
+}, {
+    readonly id: "wemm-embedding-2b-quantized";
+    readonly repo: "ewin-reg/WeMM-Embedding-2B-Quantized";
+    readonly directory: "WeMM-Embedding-2B-Quantized";
+    readonly label: "WeMM Embedding 2B 社区量化版";
+    readonly dimension: 2048;
+    readonly download: "约 1.8 GB";
+    readonly description: "社区维护的 INT4 / FP8 量化模型，非腾讯官方发布；模型卡标注 license: other，请查看协议。";
+}, {
+    readonly id: "wemm-embedding-2b";
+    readonly repo: "tencent/WeMM-Embedding-2B";
+    readonly directory: "WeMM-Embedding-2B";
+    readonly label: "腾讯 WeMM Embedding 2B（BF16）";
+    readonly dimension: 2048;
+    readonly download: "约 5.5 GB";
+    readonly description: "多模态向量模型，支持文本和图片；下载与推理资源占用较高。";
+}];
+export declare const RERANK_MODELS: readonly [{
+    readonly id: "bge-reranker-base";
+    readonly repo: "BAAI/bge-reranker-base";
+    readonly directory: "bge-reranker-base";
+    readonly label: "BGE Reranker Base";
+    readonly download: "约 1.1 GB";
+    readonly description: "中文重排的轻量选项。";
+}, {
+    readonly id: "qwen3-reranker-0.6b";
+    readonly repo: "Qwen/Qwen3-Reranker-0.6B";
+    readonly directory: "Qwen3-Reranker-0.6B";
+    readonly label: "Qwen3 Reranker 0.6B";
+    readonly download: "约 1.2 GB";
+    readonly description: "支持 100 多种语言，适合先试用 Qwen 重排。";
+}, {
+    readonly id: "bge-reranker-large";
+    readonly repo: "BAAI/bge-reranker-large";
+    readonly directory: "bge-reranker-large";
+    readonly label: "BGE Reranker Large";
+    readonly download: "约 2.2 GB";
+    readonly description: "中文和英文重排效果优先，推理速度较慢。";
+}, {
+    readonly id: "qwen3-reranker-4b";
+    readonly repo: "Qwen/Qwen3-Reranker-4B";
+    readonly directory: "Qwen3-Reranker-4B";
+    readonly label: "Qwen3 Reranker 4B";
+    readonly download: "约 8.1 GB";
+    readonly description: "Qwen 中档重排模型；请先确认磁盘与内存充足。";
+}, {
+    readonly id: "qwen3-reranker-8b";
+    readonly repo: "Qwen/Qwen3-Reranker-8B";
+    readonly directory: "Qwen3-Reranker-8B";
+    readonly label: "Qwen3 Reranker 8B";
+    readonly download: "约 16.4 GB";
+    readonly description: "资源占用最高；下载前请确认有足够磁盘与内存。";
+}];
+export type EmbeddingModelId = (typeof EMBEDDING_MODELS)[number]['id'];
+export type RerankModelId = (typeof RERANK_MODELS)[number]['id'];
+export interface ModelSelection {
+    embedding: EmbeddingModelId;
+    rerank: RerankModelId;
+}
+export interface ModelOptionView {
+    id: string;
+    label: string;
+    dimension?: number;
+    download: string;
+    description: string;
+    modelCardUrl?: string;
+}
+export declare const DEFAULT_MODEL_SELECTION: ModelSelection;
+export declare function isModelSelection(value: unknown): value is ModelSelection;
+export declare function parseModelSelection(value: unknown, fallback?: ModelSelection): ModelSelection;
+export declare function embeddingModel(id: EmbeddingModelId): {
+    readonly id: "bge-small-zh-v1.5";
+    readonly repo: "BAAI/bge-small-zh-v1.5";
+    readonly directory: "bge-small-zh-v1.5";
+    readonly label: "BGE Small 中文";
+    readonly dimension: 512;
+    readonly download: "约 96 MB";
+    readonly description: "资源占用最低，适合先跑通本地知识检索。";
+} | {
+    readonly id: "bge-base-zh-v1.5";
+    readonly repo: "BAAI/bge-base-zh-v1.5";
+    readonly directory: "bge-base-zh-v1.5";
+    readonly label: "BGE Base 中文";
+    readonly dimension: 768;
+    readonly download: "约 409 MB";
+    readonly description: "效果与资源占用较均衡。";
+} | {
+    readonly id: "bge-large-zh-v1.5";
+    readonly repo: "BAAI/bge-large-zh-v1.5";
+    readonly directory: "bge-large-zh-v1.5";
+    readonly label: "BGE Large 中文";
+    readonly dimension: 1024;
+    readonly download: "约 1.3 GB";
+    readonly description: "中文向量效果优先，需要更多内存与磁盘。";
+} | {
+    readonly id: "wemm-embedding-2b-quantized";
+    readonly repo: "ewin-reg/WeMM-Embedding-2B-Quantized";
+    readonly directory: "WeMM-Embedding-2B-Quantized";
+    readonly label: "WeMM Embedding 2B 社区量化版";
+    readonly dimension: 2048;
+    readonly download: "约 1.8 GB";
+    readonly description: "社区维护的 INT4 / FP8 量化模型，非腾讯官方发布；模型卡标注 license: other，请查看协议。";
+} | {
+    readonly id: "wemm-embedding-2b";
+    readonly repo: "tencent/WeMM-Embedding-2B";
+    readonly directory: "WeMM-Embedding-2B";
+    readonly label: "腾讯 WeMM Embedding 2B（BF16）";
+    readonly dimension: 2048;
+    readonly download: "约 5.5 GB";
+    readonly description: "多模态向量模型，支持文本和图片；下载与推理资源占用较高。";
+};
+export declare function rerankModel(id: RerankModelId): {
+    readonly id: "bge-reranker-base";
+    readonly repo: "BAAI/bge-reranker-base";
+    readonly directory: "bge-reranker-base";
+    readonly label: "BGE Reranker Base";
+    readonly download: "约 1.1 GB";
+    readonly description: "中文重排的轻量选项。";
+} | {
+    readonly id: "qwen3-reranker-0.6b";
+    readonly repo: "Qwen/Qwen3-Reranker-0.6B";
+    readonly directory: "Qwen3-Reranker-0.6B";
+    readonly label: "Qwen3 Reranker 0.6B";
+    readonly download: "约 1.2 GB";
+    readonly description: "支持 100 多种语言，适合先试用 Qwen 重排。";
+} | {
+    readonly id: "bge-reranker-large";
+    readonly repo: "BAAI/bge-reranker-large";
+    readonly directory: "bge-reranker-large";
+    readonly label: "BGE Reranker Large";
+    readonly download: "约 2.2 GB";
+    readonly description: "中文和英文重排效果优先，推理速度较慢。";
+} | {
+    readonly id: "qwen3-reranker-4b";
+    readonly repo: "Qwen/Qwen3-Reranker-4B";
+    readonly directory: "Qwen3-Reranker-4B";
+    readonly label: "Qwen3 Reranker 4B";
+    readonly download: "约 8.1 GB";
+    readonly description: "Qwen 中档重排模型；请先确认磁盘与内存充足。";
+} | {
+    readonly id: "qwen3-reranker-8b";
+    readonly repo: "Qwen/Qwen3-Reranker-8B";
+    readonly directory: "Qwen3-Reranker-8B";
+    readonly label: "Qwen3 Reranker 8B";
+    readonly download: "约 16.4 GB";
+    readonly description: "资源占用最高；下载前请确认有足够磁盘与内存。";
+};
+export declare function modelOptionsView(): {
+    embedding: {
+        dimension?: number | undefined;
+        id: string;
+        label: string;
+        download: string;
+        description: string;
+        modelCardUrl: string;
+    }[];
+    rerank: {
+        dimension?: number | undefined;
+        id: string;
+        label: string;
+        download: string;
+        description: string;
+        modelCardUrl: string;
+    }[];
+};
+//# sourceMappingURL=model-catalog.d.ts.map

package/lib/types/environment/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../../src/environment/model-catalog.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BnB,CAAA;AAEV,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BhB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;AAChE,MAAM,WAAW,cAAc;IAAG,SAAS,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE;AACtF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AACD,eAAO,MAAM,uBAAuB,EAAE,cAGrC,CAAA;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAKxE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,iBAA0B,GAAG,cAAc,CAItG;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5C;AAED,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;EAU/B"}

package/lib/types/environment/model-catalog.js

@@ -0,0 +1,91 @@
+/** Models supported by the local embedding and reranking workers. Revisions are pinned in manifest.ts. */
+export const EMBEDDING_MODELS = [
+    {
+        id: 'bge-small-zh-v1.5', repo: 'BAAI/bge-small-zh-v1.5', directory: 'bge-small-zh-v1.5',
+        label: 'BGE Small 中文', dimension: 512, download: '约 96 MB',
+        description: '资源占用最低，适合先跑通本地知识检索。',
+    },
+    {
+        id: 'bge-base-zh-v1.5', repo: 'BAAI/bge-base-zh-v1.5', directory: 'bge-base-zh-v1.5',
+        label: 'BGE Base 中文', dimension: 768, download: '约 409 MB',
+        description: '效果与资源占用较均衡。',
+    },
+    {
+        id: 'bge-large-zh-v1.5', repo: 'BAAI/bge-large-zh-v1.5', directory: 'bge-large-zh-v1.5',
+        label: 'BGE Large 中文', dimension: 1024, download: '约 1.3 GB',
+        description: '中文向量效果优先，需要更多内存与磁盘。',
+    },
+    {
+        id: 'wemm-embedding-2b-quantized', repo: 'ewin-reg/WeMM-Embedding-2B-Quantized', directory: 'WeMM-Embedding-2B-Quantized',
+        label: 'WeMM Embedding 2B 社区量化版', dimension: 2048, download: '约 1.8 GB',
+        description: '社区维护的 INT4 / FP8 量化模型，非腾讯官方发布；模型卡标注 license: other，请查看协议。',
+    },
+    {
+        id: 'wemm-embedding-2b', repo: 'tencent/WeMM-Embedding-2B', directory: 'WeMM-Embedding-2B',
+        label: '腾讯 WeMM Embedding 2B（BF16）', dimension: 2048, download: '约 5.5 GB',
+        description: '多模态向量模型，支持文本和图片；下载与推理资源占用较高。',
+    },
+];
+export const RERANK_MODELS = [
+    {
+        id: 'bge-reranker-base', repo: 'BAAI/bge-reranker-base', directory: 'bge-reranker-base',
+        label: 'BGE Reranker Base', download: '约 1.1 GB',
+        description: '中文重排的轻量选项。',
+    },
+    {
+        id: 'qwen3-reranker-0.6b', repo: 'Qwen/Qwen3-Reranker-0.6B', directory: 'Qwen3-Reranker-0.6B',
+        label: 'Qwen3 Reranker 0.6B', download: '约 1.2 GB',
+        description: '支持 100 多种语言，适合先试用 Qwen 重排。',
+    },
+    {
+        id: 'bge-reranker-large', repo: 'BAAI/bge-reranker-large', directory: 'bge-reranker-large',
+        label: 'BGE Reranker Large', download: '约 2.2 GB',
+        description: '中文和英文重排效果优先，推理速度较慢。',
+    },
+    {
+        id: 'qwen3-reranker-4b', repo: 'Qwen/Qwen3-Reranker-4B', directory: 'Qwen3-Reranker-4B',
+        label: 'Qwen3 Reranker 4B', download: '约 8.1 GB',
+        description: 'Qwen 中档重排模型；请先确认磁盘与内存充足。',
+    },
+    {
+        id: 'qwen3-reranker-8b', repo: 'Qwen/Qwen3-Reranker-8B', directory: 'Qwen3-Reranker-8B',
+        label: 'Qwen3 Reranker 8B', download: '约 16.4 GB',
+        description: '资源占用最高；下载前请确认有足够磁盘与内存。',
+    },
+];
+export const DEFAULT_MODEL_SELECTION = {
+    embedding: 'bge-small-zh-v1.5',
+    rerank: 'bge-reranker-base',
+};
+export function isModelSelection(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const selection = value;
+    return EMBEDDING_MODELS.some(model => model.id === selection.embedding)
+        && RERANK_MODELS.some(model => model.id === selection.rerank);
+}
+export function parseModelSelection(value, fallback = DEFAULT_MODEL_SELECTION) {
+    if (value === undefined || value === null)
+        return { ...fallback };
+    if (!isModelSelection(value))
+        throw new Error('模型选择无效，请重新选择向量模型和重排模型');
+    return { embedding: value.embedding, rerank: value.rerank };
+}
+export function embeddingModel(id) {
+    return EMBEDDING_MODELS.find(model => model.id === id);
+}
+export function rerankModel(id) {
+    return RERANK_MODELS.find(model => model.id === id);
+}
+export function modelOptionsView() {
+    const present = (model) => ({
+        id: model.id, label: model.label, download: model.download, description: model.description,
+        modelCardUrl: `https://huggingface.co/${model.repo}`,
+        ...('dimension' in model ? { dimension: model.dimension } : {}),
+    });
+    return {
+        embedding: EMBEDDING_MODELS.map(present),
+        rerank: RERANK_MODELS.map(present),
+    };
+}
+//# sourceMappingURL=model-catalog.js.map

package/lib/types/environment/model-catalog.js.map

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

package/lib/types/environment/process.d.ts

@@ -0,0 +1,10 @@
+export interface ProcessOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    onLine?: (line: string) => void;
+}
+/** No shell, bounded output, and only this child PID is stopped. */
+export declare function runProcess(command: string, args: string[], options?: ProcessOptions): Promise<string>;
+//# sourceMappingURL=process.d.ts.map

package/lib/types/environment/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/environment/process.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CzG"}

package/lib/types/environment/process.js

@@ -0,0 +1,54 @@
+import { spawn } from 'node:child_process';
+/** No shell, bounded output, and only this child PID is stopped. */
+export function runProcess(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        if (options.signal?.aborted)
+            return reject(new Error('ENVIRONMENT_CANCELLED'));
+        const child = spawn(command, args, { cwd: options.cwd, env: options.env ?? process.env, stdio: ['ignore', 'pipe', 'pipe'] });
+        let output = '', tail = '', settled = false, stopError;
+        let killTimer;
+        const end = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            clearTimeout(killTimer);
+            options.signal?.removeEventListener('abort', cancel);
+            if (error)
+                reject(error);
+            else
+                resolve(output);
+        };
+        // Keep the install lock until this owned child has actually exited.
+        const stop = (error) => {
+            if (settled || stopError)
+                return;
+            stopError = error;
+            clearTimeout(timer);
+            child.kill('SIGTERM');
+            killTimer = setTimeout(() => child.kill('SIGKILL'), 1500);
+        };
+        const cancel = () => stop(new Error('ENVIRONMENT_CANCELLED'));
+        const timer = setTimeout(() => stop(new Error(`环境步骤超时：${command}`)), options.timeoutMs ?? 30_000);
+        options.signal?.addEventListener('abort', cancel, { once: true });
+        const receive = (data) => {
+            const text = data.toString();
+            output = (output + text).slice(-128_000);
+            tail = (tail + text).slice(-16_000);
+            const lines = tail.split(/[\r\n]+/);
+            tail = lines.pop() ?? '';
+            for (const line of lines)
+                if (line.trim())
+                    options.onLine?.(line.trim());
+        };
+        child.stdout.on('data', receive);
+        child.stderr.on('data', receive);
+        child.once('error', error => end(error));
+        child.once('close', code => {
+            if (tail.trim())
+                options.onLine?.(tail.trim());
+            end(stopError ?? (code === 0 ? undefined : new Error(`环境步骤失败（${code ?? '已停止'}）：${output.slice(-3000).trim() || command}`)));
+        });
+    });
+}
+//# sourceMappingURL=process.js.map

package/lib/types/environment/process.js.map

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

package/lib/types/environment/selection.d.ts

@@ -0,0 +1,9 @@
+import { type ModelSelection } from './model-catalog.js';
+export declare const MODEL_SELECTION_FILE = "environment-model-selection.json";
+export declare function readModelSelection(resourceRoot: string): ModelSelection;
+export declare function selectedEmbedding(resourceRoot: string | undefined): {
+    path?: string;
+    dimension?: number;
+};
+export declare function writeModelSelection(resourceRoot: string, selection: ModelSelection): Promise<void>;
+//# sourceMappingURL=selection.d.ts.map

package/lib/types/environment/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/environment/selection.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6D,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnH,eAAO,MAAM,oBAAoB,qCAAqC,CAAA;AAEtE,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAMvE;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAKzG;AAED,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxG"}

package/lib/types/environment/selection.js

@@ -0,0 +1,29 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DEFAULT_MODEL_SELECTION, embeddingModel, isModelSelection } from './model-catalog.js';
+export const MODEL_SELECTION_FILE = 'environment-model-selection.json';
+export function readModelSelection(resourceRoot) {
+    try {
+        const value = JSON.parse(readFileSync(join(resourceRoot, MODEL_SELECTION_FILE), 'utf8'));
+        if (isModelSelection(value))
+            return { embedding: value.embedding, rerank: value.rerank };
+    }
+    catch { /* first install or damaged selection: use the shipped defaults */ }
+    return { ...DEFAULT_MODEL_SELECTION };
+}
+export function selectedEmbedding(resourceRoot) {
+    if (!resourceRoot)
+        return {};
+    const model = embeddingModel(readModelSelection(resourceRoot).embedding);
+    const path = join(resourceRoot, 'models', model.directory);
+    return existsSync(path) ? { path, dimension: model.dimension } : {};
+}
+export async function writeModelSelection(resourceRoot, selection) {
+    await mkdir(resourceRoot, { recursive: true });
+    const destination = join(resourceRoot, MODEL_SELECTION_FILE);
+    const temporary = `${destination}.${process.pid}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(selection, null, 2)}\n`, 'utf8');
+    await rename(temporary, destination);
+}
+//# sourceMappingURL=selection.js.map

package/lib/types/environment/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/environment/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,gBAAgB,EAAuB,MAAM,oBAAoB,CAAA;AAEnH,MAAM,CAAC,MAAM,oBAAoB,GAAG,kCAAkC,CAAA;AAEtE,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QACjG,IAAI,gBAAgB,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAC1F,CAAC;IAAC,MAAM,CAAC,CAAC,kEAAkE,CAAC,CAAC;IAC9E,OAAO,EAAE,GAAG,uBAAuB,EAAE,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAgC;IAChE,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAA;IAC5B,MAAM,KAAK,GAAG,cAAc,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,CAAA;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IAC1D,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,YAAoB,EAAE,SAAyB;IACvF,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAA;IAC5D,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,MAAM,CAAA;IACrD,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7E,MAAM,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;AACtC,CAAC"}

package/lib/types/environment/service.d.ts

@@ -0,0 +1,47 @@
+import type { RuntimeKnowledgeConfig } from '../types.js';
+import { installRequiredEnvironment } from './install.js';
+import { runProcess } from './process.js';
+import type { EnvironmentReport, EnvironmentView } from './types.js';
+export interface EnvironmentOptions {
+    resourceRoot: string;
+    snapshot: () => {
+        config: RuntimeKnowledgeConfig;
+        paths: {
+            python: string;
+            embeddingModel: string;
+            rerankModel: string;
+        };
+    };
+    probe: (kind: 'embedding' | 'rerank') => Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    reload: () => void;
+    run?: typeof runProcess;
+    install?: typeof installRequiredEnvironment;
+}
+export declare function modelFilesProblem(path: string): string | undefined;
+/** Preparation and readiness are shared by all bases in one deployment. */
+export declare class KnowledgeEnvironment {
+    private readonly options;
+    private report;
+    private job?;
+    private checkPending?;
+    private work?;
+    private controller?;
+    private checkController?;
+    private disposed;
+    constructor(options: EnvironmentOptions);
+    private fingerprint;
+    view(): EnvironmentView;
+    invalidate(): void;
+    requireReady(): Promise<void>;
+    check(deep?: boolean): Promise<EnvironmentReport>;
+    private item;
+    private performCheck;
+    start(action: 'check' | 'install', requestedSelection?: unknown): EnvironmentView;
+    wait(): Promise<void>;
+    cancel(): void;
+    close(): void;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/types/environment/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/environment/service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,0BAA0B,EAAoB,MAAM,cAAc,CAAA;AAG3E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,KAAK,EAAsC,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAExG,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM;QAAE,MAAM,EAAE,sBAAsB,CAAC;QAAC,KAAK,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;IAC1H,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClF,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,0BAA0B,CAAA;CAC5C;AAmBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWlE;AAED,2EAA2E;AAC3E,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAwB;IACpC,OAAO,CAAC,YAAY,CAAC,CAA4B;IACjD,OAAO,CAAC,IAAI,CAAC,CAAe;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAQ;gBACK,OAAO,EAAE,kBAAkB;IAExD,OAAO,CAAC,WAAW;IAWnB,IAAI,IAAI,eAAe;IAKvB,UAAU,IAAI,IAAI;IAEZ,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC,KAAK,CAAC,IAAI,UAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQ9C,OAAO,CAAC,IAAI;YAIE,YAAY;IAqC1B,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,eAAe;IAiE3E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC3B,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;CACd"}