hoolix 0.0.1-beta.19

package/dist/process/manager.d.ts

@@ -0,0 +1,74 @@
+export interface StartOptions {
+    port?: number;
+    authKey?: string;
+    detach?: boolean;
+}
+export interface ServerStatus {
+    running: boolean;
+    pid?: number;
+    port?: number;
+    startedAt?: string;
+    mode?: 'http' | 'proxy';
+}
+export interface HostSpawnPlanInput {
+    slug: string;
+    port: number;
+    dataDir: string;
+    authKey: string;
+    execPath?: string;
+    platform?: NodeJS.Platform;
+    cwd?: string;
+    tsxExists?: boolean;
+}
+export interface HostSpawnPlan {
+    command: string;
+    args: string[];
+    mode: 'binary' | 'dev-tsx-bin' | 'dev-node-import';
+}
+export declare function buildHostSpawnPlan(input: HostSpawnPlanInput): HostSpawnPlan;
+export interface ProxySpawnPlan {
+    command: string;
+    args: string[];
+    mode: 'binary' | 'dev-tsx-bin' | 'dev-node-import';
+}
+export declare function buildProxySpawnPlan(input: {
+    slug: string;
+    port: number;
+    authKey: string;
+    execPath?: string;
+    platform?: NodeJS.Platform;
+    cwd?: string;
+    tsxExists?: boolean;
+}): ProxySpawnPlan;
+export declare class ServerManager {
+    /**
+     * Start a server by spawning the MCP host (binary or dev tsx path).
+     * Handles early runtime marker, health probe, and Windows process checks.
+     */
+    start(slug: string, opts?: StartOptions): Promise<{
+        port: number;
+        authKey: string;
+        pid: number;
+    }>;
+    /**
+     * Start an mcp-server in proxy mode: spawns proxy-host.ts which bridges the
+     * underlying stdio server to an authenticated HTTP endpoint.
+     */
+    startProxied(slug: string, opts?: StartOptions): Promise<{
+        port: number;
+        authKey: string;
+        pid: number;
+    }>;
+    stop(slug: string, force?: boolean): Promise<boolean>;
+    getStatus(slug: string): Promise<ServerStatus>;
+    private getMetadata;
+    private readLogTail;
+    /** Wait for HTTP /health to respond (authoritative liveness after spawn). */
+    private waitForHttpHealth;
+    private isProcessAlive;
+    /** Real TCP probe (listen briefly on loopback) to find free port. Avoids races. */
+    private isPortFree;
+    private findFreePort;
+}
+export declare const serverManager: ServerManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/process/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/process/manager.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;CACpD;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAgE3E;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;CACpD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,cAAc,CA4BjB;AAED,qBAAa,aAAa;IACxB;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAuE3G;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAmD5G,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBnD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YA2BtC,WAAW;YAKX,WAAW;IASzB,6EAA6E;YAE/D,iBAAiB;YAkBjB,cAAc;IAc5B,mFAAmF;YACrE,UAAU;YAcV,YAAY;CAW3B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/process/manager.js

@@ -0,0 +1,322 @@
+import { spawn } from 'node:child_process';
+import fs from 'fs-extra';
+import path from 'node:path';
+import net from 'node:net';
+import { getServerRuntimePath, getServerDir, getServerMetadataPath } from '../core/paths.js';
+import { logger } from '../core/logger.js';
+import treeKill from 'tree-kill';
+import psList from 'ps-list';
+const BASE_PORT = 3456;
+export function buildHostSpawnPlan(input) {
+    const currentBin = input.execPath || process.execPath;
+    const isNodeOrBun = currentBin.includes('node') || currentBin.includes('bun');
+    const root = input.cwd || process.cwd();
+    const hostScript = path.resolve(root, 'src/mcp/host.ts');
+    if (!isNodeOrBun) {
+        return {
+            command: currentBin,
+            args: [
+                '__internal-host',
+                '--slug', input.slug,
+                '--port', String(input.port),
+                '--data-dir', input.dataDir,
+                '--auth-key', input.authKey,
+            ],
+            mode: 'binary',
+        };
+    }
+    const platform = input.platform || process.platform;
+    if (platform === 'win32') {
+        return {
+            command: currentBin,
+            args: [
+                '--import', 'tsx',
+                hostScript,
+                '--slug', input.slug,
+                '--port', String(input.port),
+                '--data-dir', input.dataDir,
+                '--auth-key', input.authKey,
+            ],
+            mode: 'dev-node-import',
+        };
+    }
+    const tsxBin = path.resolve(root, 'node_modules', '.bin', 'tsx');
+    const tsxExists = input.tsxExists ?? fs.pathExistsSync(tsxBin);
+    if (tsxExists) {
+        return {
+            command: tsxBin,
+            args: [
+                hostScript,
+                '--slug', input.slug,
+                '--port', String(input.port),
+                '--data-dir', input.dataDir,
+                '--auth-key', input.authKey,
+            ],
+            mode: 'dev-tsx-bin',
+        };
+    }
+    return {
+        command: currentBin,
+        args: [
+            '--import', 'tsx',
+            hostScript,
+            '--slug', input.slug,
+            '--port', String(input.port),
+            '--data-dir', input.dataDir,
+            '--auth-key', input.authKey,
+        ],
+        mode: 'dev-node-import',
+    };
+}
+export function buildProxySpawnPlan(input) {
+    const currentBin = input.execPath || process.execPath;
+    const isNodeOrBun = currentBin.includes('node') || currentBin.includes('bun');
+    const root = input.cwd || process.cwd();
+    const proxyScript = path.resolve(root, 'src/mcp/proxy-host.ts');
+    const proxyArgs = [
+        '--slug', input.slug,
+        '--port', String(input.port),
+        '--auth-key', input.authKey,
+    ];
+    if (!isNodeOrBun) {
+        return { command: currentBin, args: ['__internal-proxy', ...proxyArgs], mode: 'binary' };
+    }
+    const platform = input.platform || process.platform;
+    if (platform === 'win32') {
+        return { command: currentBin, args: ['--import', 'tsx', proxyScript, ...proxyArgs], mode: 'dev-node-import' };
+    }
+    const tsxBin = path.resolve(root, 'node_modules', '.bin', 'tsx');
+    const tsxExists = input.tsxExists ?? fs.pathExistsSync(tsxBin);
+    if (tsxExists) {
+        return { command: tsxBin, args: [proxyScript, ...proxyArgs], mode: 'dev-tsx-bin' };
+    }
+    return { command: currentBin, args: ['--import', 'tsx', proxyScript, ...proxyArgs], mode: 'dev-node-import' };
+}
+export class ServerManager {
+    /**
+     * Start a server by spawning the MCP host (binary or dev tsx path).
+     * Handles early runtime marker, health probe, and Windows process checks.
+     */
+    async start(slug, opts = {}) {
+        const runtimePath = getServerRuntimePath(slug);
+        // Return existing if .runtime.json + ps check says it's alive
+        const existing = await this.getStatus(slug);
+        if (existing.running && existing.port && existing.pid) {
+            const meta = await this.getMetadata(slug);
+            return { port: existing.port, authKey: meta.authKey, pid: existing.pid };
+        }
+        const dataDir = path.join(getServerDir(slug), 'data');
+        const meta = await this.getMetadata(slug);
+        const port = opts.port || await this.findFreePort(BASE_PORT + Math.floor(Math.random() * 400));
+        const authKey = opts.authKey || meta.authKey;
+        const hostLogPath = path.join(getServerDir(slug), 'host.log');
+        logger.info(`Spawning MCP host for "${slug}" on port ${port}...`);
+        // Early "starting" marker so concurrent status checks see progress
+        await fs.writeJson(runtimePath, {
+            pid: -1,
+            port,
+            startedAt: new Date().toISOString(),
+            status: 'starting',
+        }, { spaces: 2 });
+        const spawnPlan = buildHostSpawnPlan({ slug, port, dataDir, authKey });
+        await fs.ensureFile(hostLogPath);
+        await fs.appendFile(hostLogPath, `\n--- ${new Date().toISOString()} start ${slug} on :${port} ---\n`);
+        const logFd = fs.openSync(hostLogPath, 'a');
+        const child = spawn(spawnPlan.command, spawnPlan.args, {
+            stdio: ['ignore', logFd, logFd],
+            detached: opts.detach ?? true,
+            env: { ...process.env, MCP_PORTAL_LOG_LEVEL: process.env.MCP_PORTAL_LOG_LEVEL || 'info' },
+        });
+        fs.closeSync(logFd);
+        child.on('exit', (code, signal) => {
+            if (code !== 0) {
+                logger.error(`MCP host for ${slug} exited (code=${code}, signal=${signal})`);
+            }
+        });
+        // Wait + HTTP /health probe (more reliable than relying solely on child writing .runtime.json).
+        const probeOk = await this.waitForHttpHealth(port, 15000);
+        if (!probeOk) {
+            try {
+                treeKill(child.pid, 'SIGKILL');
+            }
+            catch { }
+            await fs.remove(runtimePath).catch(() => { });
+            const tail = await this.readLogTail(hostLogPath);
+            throw new Error(`Failed to start "${slug}" — health check on :${port} did not succeed.\nRecent logs:\n${tail}`);
+        }
+        // Authoritative runtime file written by parent after health confirmed
+        const pid = child.pid;
+        await fs.writeJson(runtimePath, {
+            pid,
+            port,
+            startedAt: new Date().toISOString(),
+            status: 'running',
+        }, { spaces: 2 });
+        child.unref();
+        return { port, authKey, pid };
+    }
+    /**
+     * Start an mcp-server in proxy mode: spawns proxy-host.ts which bridges the
+     * underlying stdio server to an authenticated HTTP endpoint.
+     */
+    async startProxied(slug, opts = {}) {
+        const runtimePath = getServerRuntimePath(slug);
+        // Re-use if already running (any mode — caller decides whether to stop first)
+        const existing = await this.getStatus(slug);
+        if (existing.running && existing.port && existing.pid) {
+            const meta = await this.getMetadata(slug);
+            return { port: existing.port, authKey: meta.authKey, pid: existing.pid };
+        }
+        const meta = await this.getMetadata(slug);
+        const port = opts.port || await this.findFreePort(BASE_PORT + Math.floor(Math.random() * 400));
+        const authKey = opts.authKey || meta.authKey;
+        const hostLogPath = path.join(getServerDir(slug), 'host.log');
+        logger.info(`Spawning proxy host for "${slug}" on port ${port}...`);
+        await fs.writeJson(runtimePath, { pid: -1, port, startedAt: new Date().toISOString(), status: 'starting', mode: 'proxy' }, { spaces: 2 });
+        const spawnPlan = buildProxySpawnPlan({ slug, port, authKey });
+        await fs.ensureFile(hostLogPath);
+        await fs.appendFile(hostLogPath, `\n--- ${new Date().toISOString()} proxy-spawn ${slug} on :${port} ---\n`);
+        const logFd = fs.openSync(hostLogPath, 'a');
+        const child = spawn(spawnPlan.command, spawnPlan.args, {
+            stdio: ['ignore', logFd, logFd],
+            detached: opts.detach ?? true,
+            env: { ...process.env, MCP_PORTAL_LOG_LEVEL: process.env.MCP_PORTAL_LOG_LEVEL || 'info' },
+        });
+        fs.closeSync(logFd);
+        child.on('exit', (code, signal) => {
+            if (code !== 0)
+                logger.error(`Proxy host for ${slug} exited (code=${code}, signal=${signal})`);
+        });
+        const probeOk = await this.waitForHttpHealth(port, 20000);
+        if (!probeOk) {
+            try {
+                treeKill(child.pid, 'SIGKILL');
+            }
+            catch { }
+            await fs.remove(runtimePath).catch(() => { });
+            const tail = await this.readLogTail(hostLogPath);
+            throw new Error(`Failed to start proxy for "${slug}" — health check on :${port} timed out.\nRecent logs:\n${tail}`);
+        }
+        const pid = child.pid;
+        await fs.writeJson(runtimePath, { pid, port, startedAt: new Date().toISOString(), status: 'running', mode: 'proxy' }, { spaces: 2 });
+        child.unref();
+        return { port, authKey, pid };
+    }
+    async stop(slug, force = false) {
+        const runtimePath = getServerRuntimePath(slug);
+        const status = await this.getStatus(slug);
+        if (!status.running || !status.pid) {
+            await fs.remove(runtimePath).catch(() => { });
+            return false;
+        }
+        return new Promise((resolve) => {
+            treeKill(status.pid, force ? 'SIGKILL' : 'SIGTERM', async (err) => {
+                if (err) {
+                    logger.warn(`tree-kill error for ${slug}: ${err.message}`);
+                }
+                await fs.remove(runtimePath).catch(() => { });
+                resolve(true);
+            });
+        });
+    }
+    async getStatus(slug) {
+        const runtimePath = getServerRuntimePath(slug);
+        if (!(await fs.pathExists(runtimePath))) {
+            return { running: false };
+        }
+        try {
+            const data = await fs.readJson(runtimePath);
+            // Verify alive via ps-list (critical on Windows where signals are limited)
+            const alive = await this.isProcessAlive(data.pid);
+            if (!alive) {
+                await fs.remove(runtimePath).catch(() => { });
+                return { running: false };
+            }
+            return {
+                running: true,
+                pid: data.pid,
+                port: data.port,
+                startedAt: data.startedAt,
+                mode: (data.mode === 'proxy' ? 'proxy' : 'http'),
+            };
+        }
+        catch {
+            await fs.remove(runtimePath).catch(() => { });
+            return { running: false };
+        }
+    }
+    async getMetadata(slug) {
+        const metaPath = getServerMetadataPath(slug);
+        return fs.readJson(metaPath);
+    }
+    async readLogTail(logPath) {
+        try {
+            const log = await fs.readFile(logPath, 'utf8');
+            return log.slice(-2000) || '(host log was empty)';
+        }
+        catch {
+            return '(host log unavailable)';
+        }
+    }
+    /** Wait for HTTP /health to respond (authoritative liveness after spawn). */
+    async waitForHttpHealth(port, timeoutMs) {
+        const start = Date.now();
+        const url = `http://127.0.0.1:${port}/health`;
+        while (Date.now() - start < timeoutMs) {
+            try {
+                const res = await fetch(url, { signal: AbortSignal.timeout(800) });
+                if (res.ok) {
+                    logger.info(`Health check passed on :${port}`);
+                    return true;
+                }
+            }
+            catch {
+                // not ready yet; loop with backoff
+            }
+            await new Promise(r => setTimeout(r, 400));
+        }
+        return false;
+    }
+    async isProcessAlive(pid) {
+        try {
+            const list = await psList();
+            return list.some((p) => p.pid === pid);
+        }
+        catch {
+            try {
+                process.kill(pid, 0);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    /** Real TCP probe (listen briefly on loopback) to find free port. Avoids races. */
+    async isPortFree(port) {
+        return new Promise((resolve) => {
+            const server = net.createServer();
+            server.once('error', () => {
+                resolve(false);
+            });
+            server.once('listening', () => {
+                server.close(() => resolve(true));
+            });
+            // Bind loopback only (matches host bindHost='127.0.0.1')
+            server.listen(port, '127.0.0.1');
+        });
+    }
+    async findFreePort(startPort) {
+        // Probe range to avoid collisions (real listen probe, not just math).
+        for (let p = startPort; p < startPort + 200; p++) {
+            if (await this.isPortFree(p)) {
+                return p;
+            }
+        }
+        // Last resort (health probe later will fail loudly if still occupied)
+        logger.warn(`Could not find a free port in range ${startPort}-${startPort + 199}; using ${startPort}`);
+        return startPort;
+    }
+}
+export const serverManager = new ServerManager();
+//# sourceMappingURL=manager.js.map

package/dist/process/manager.js.map

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

package/dist/rag/models.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Central registry for embedding models (DRY source of truth).
+ * - 'fuse': pure keyword/fuzzy (no ML)
+ * - 'hybrid-*': BGE bi-encoder via @huggingface/transformers (lazy) + cosine + Fuse blend/RRF
+ *
+ * Adding a new model: just extend the registry + the zod enums in core/config + core/registry
+ * (they import SUPPORTED_EMBEDDING_MODELS).
+ *
+ * All hybrid models follow BGE convention: queries get instruction prefix, passages do not.
+ * Model downloads cached by HF transformers.js (~first use only).
+ */
+export type EmbeddingModel = 'fuse' | 'hybrid-bge-small' | 'hybrid-bge-base';
+export interface EmbeddingConfig {
+    /** HF model id (Xenova/ for onnx-converted that works in transformers.js) */
+    model: string;
+    dim: number;
+    queryPrefix: string;
+    passagePrefix: string;
+    normalize: boolean;
+}
+export declare const EMBEDDING_REGISTRY: Record<EmbeddingModel, EmbeddingConfig | null>;
+export declare const SUPPORTED_EMBEDDING_MODELS: EmbeddingModel[];
+export declare function getEmbeddingConfig(model: EmbeddingModel): EmbeddingConfig | null;
+export declare function isHybridModel(model: EmbeddingModel | string): boolean;
+/**
+ * Recommended defaults for hybrid search tuning.
+ */
+export declare const DEFAULT_HYBRID_ALPHA = 0.7;
+export declare const DEFAULT_RRF_K = 60;
+//# sourceMappingURL=models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/rag/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE,eAAe,GAAG,IAAI,CAgBpE,CAAC;AAEX,eAAO,MAAM,0BAA0B,EAAsC,cAAc,EAAE,CAAC;AAE9F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,GAAG,IAAI,CAEhF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,OAAO,CAErE;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,aAAa,KAAK,CAAC"}

package/dist/rag/models.js

@@ -0,0 +1,30 @@
+export const EMBEDDING_REGISTRY = {
+    fuse: null,
+    'hybrid-bge-small': {
+        model: 'Xenova/bge-small-en-v1.5',
+        dim: 384,
+        queryPrefix: 'Represent this sentence for searching relevant passages: ',
+        passagePrefix: '',
+        normalize: true,
+    },
+    'hybrid-bge-base': {
+        model: 'Xenova/bge-base-en-v1.5',
+        dim: 768,
+        queryPrefix: 'Represent this sentence for searching relevant passages: ',
+        passagePrefix: '',
+        normalize: true,
+    },
+};
+export const SUPPORTED_EMBEDDING_MODELS = Object.keys(EMBEDDING_REGISTRY);
+export function getEmbeddingConfig(model) {
+    return EMBEDDING_REGISTRY[model] ?? null;
+}
+export function isHybridModel(model) {
+    return typeof model === 'string' && model.startsWith('hybrid-');
+}
+/**
+ * Recommended defaults for hybrid search tuning.
+ */
+export const DEFAULT_HYBRID_ALPHA = 0.7; // semantic weight in weighted blend (0..1)
+export const DEFAULT_RRF_K = 60;
+//# sourceMappingURL=models.js.map

package/dist/rag/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/rag/models.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,kBAAkB,GAAmD;IAChF,IAAI,EAAE,IAAI;IACV,kBAAkB,EAAE;QAClB,KAAK,EAAE,0BAA0B;QACjC,GAAG,EAAE,GAAG;QACR,WAAW,EAAE,2DAA2D;QACxE,aAAa,EAAE,EAAE;QACjB,SAAS,EAAE,IAAI;KAChB;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,yBAAyB;QAChC,GAAG,EAAE,GAAG;QACR,WAAW,EAAE,2DAA2D;QACxE,aAAa,EAAE,EAAE;QACjB,SAAS,EAAE,IAAI;KAChB;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAqB,CAAC;AAE9F,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC,CAAC,2CAA2C;AACpF,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC"}

package/dist/rag/store.d.ts

@@ -0,0 +1,63 @@
+import type { IngestedChunk } from '../ingestion/types.js';
+import type { SearchResult, ReadPageResult, TableOfContentsItem, RAGDiagnostics, RAGSearchOptions, EmbeddingModel } from './types.js';
+/**
+ * Pure-JS cosine similarity (no deps). Used for hybrid semantic scores.
+ * Returns value in [-1, 1]; higher is better.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Reciprocal Rank Fusion (RRF) — lightweight, model-free reranker for hybrid search.
+ * Combines two ranked lists (e.g. keyword + semantic) using rank positions.
+ * Often outperforms simple score blending for relevance.
+ */
+export declare function reciprocalRankFusion(listA: Array<{
+    id: string;
+}>, listB: Array<{
+    id: string;
+}>, k?: number): Map<string, number>;
+export declare class DocumentationRAG {
+    private chunks;
+    private fuse;
+    private embeddings;
+    private embedPipeline;
+    private activeConfig;
+    private queryEmbedCache;
+    private readonly QUERY_CACHE_MAX;
+    private readonly slug;
+    private readonly dataDir;
+    private chunksFile;
+    private embeddingsFile;
+    private embeddingModel;
+    constructor(slug: string, embeddingModel?: EmbeddingModel);
+    initialize(): Promise<void>;
+    private loadEmbeddingsIfPresent;
+    /** Clear query embed cache (e.g. after big changes, or for testing) */
+    clearQueryCache(): void;
+    private buildFuseIndex;
+    private scoreKeywordMatch;
+    /**
+     * indexChunks: persist + build Fuse (and optional embeddings for hybrid).
+     * options.embeddingModel controls whether to compute/persist BGE vectors (lazy download on first hybrid use).
+     * Called from create/reindex; onProgress used for 'embed' stage reporting.
+     *
+     * Smart caching for embeddings (persistent on disk) + forceReembed opt.
+     */
+    indexChunks(chunks: IngestedChunk[], options?: {
+        embeddingModel?: EmbeddingModel;
+        onProgress?: (p: {
+            stage: string;
+            message: string;
+            current?: number;
+            total?: number;
+        }) => void;
+        forceReembed?: boolean;
+    }): Promise<number>;
+    private getEmbedder;
+    search(query: string, opts?: RAGSearchOptions): Promise<SearchResult[]>;
+    readPage(urlOrPath: string, maxChunks?: number): Promise<ReadPageResult | null>;
+    getTableOfContents(): Promise<TableOfContentsItem[]>;
+    getDiagnostics(): Promise<RAGDiagnostics>;
+    close(): Promise<void>;
+}
+export declare function createRAGForServer(slug: string, embeddingModel?: EmbeddingModel): Promise<DocumentationRAG>;
+//# sourceMappingURL=store.d.ts.map

package/dist/rag/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/rag/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAC;AAWpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAcjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5B,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5B,CAAC,GAAE,MAAsB,GACxB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrB;AAkDD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAA+C;IAInE,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAO;IAEvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAA0B;gBAEpC,IAAI,EAAE,MAAM,EAAE,cAAc,GAAE,cAAuB;IAS3D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAWnB,uBAAuB;IAUrC,uEAAuE;IACvE,eAAe,IAAI,IAAI;IAIvB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,iBAAiB;IAgDzB;;;;;;OAMG;IACG,WAAW,CACf,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,GAAE;QACP,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QAC/F,YAAY,CAAC,EAAE,OAAO,CAAC;KACnB,GACL,OAAO,CAAC,MAAM,CAAC;YA6FJ,WAAW;IAenB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsJ3E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAwB3E,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA0BpD,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;IA6BzC,KAAK;CAGZ;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,GAAE,cAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIzH"}