@zvec/zvec-grep 0.1.5 → 0.1.7

package/dist/daemon/runtime-manager.d.ts

@@ -0,0 +1,46 @@
+import { type ZvecGrepInfoResult } from "../engine/service/index.js";
+import type { CreateZvecGrepOptions } from "../engine/service/types.js";
+import type { EmbeddingModelLoadRequest, EmbeddingModelPool } from "./model-pool.js";
+import { RootRuntime } from "./root-runtime.js";
+import { RootLeaseManager } from "./root-lease.js";
+export type RuntimeManagerOptions = {
+    modelPool: EmbeddingModelPool;
+    serviceOptions?: CreateZvecGrepOptions;
+    readSessionIdleTtlMs?: number;
+    runtimeIdleTtlMs?: number;
+    onRuntimeEvicted?: (canonicalRoot: string) => void | Promise<void>;
+    rootLeaseManager?: RootLeaseManager;
+    createRuntime?: (input: {
+        canonicalRoot: string;
+        modelLoadRequest?: EmbeddingModelLoadRequest;
+        modelPool: EmbeddingModelPool;
+    }) => RootRuntime | Promise<RootRuntime>;
+};
+export type RuntimeManagerSnapshot = {
+    activeRuntimes: number;
+};
+export declare class RuntimeManager {
+    private readonly options;
+    private readonly runtimes;
+    private readonly creating;
+    private readonly aliases;
+    private readonly rootLeaseManager;
+    private readonly idleTimers;
+    private closed;
+    constructor(options: RuntimeManagerOptions);
+    get instanceToken(): string;
+    activate(requestedRoot: string): Promise<RootRuntime>;
+    activateForIndex(requestedRoot: string): Promise<RootRuntime>;
+    peek(requestedRoot: string): Promise<RootRuntime | undefined>;
+    getByCanonicalRoot(canonicalRoot: string): RootRuntime | undefined;
+    getByRequestedRoot(requestedRoot: string): RootRuntime | undefined;
+    snapshot(): RuntimeManagerSnapshot;
+    evict(canonicalRoot: string): Promise<boolean>;
+    close(): Promise<void>;
+    private getOrCreate;
+    private createRuntime;
+    private touchRuntime;
+    private evictIfIdle;
+}
+export declare function inspectRoot(requestedRoot: string, serviceOptions?: CreateZvecGrepOptions, includeStatus?: boolean): Promise<ZvecGrepInfoResult>;
+export declare function resolveRequestedRoot(requestedRoot: string, writable: boolean): Promise<string>;

package/dist/daemon/runtime-manager.js

@@ -0,0 +1,246 @@
+import { access, realpath, stat } from "node:fs/promises";
+import { constants as fsConstants } from "node:fs";
+import { isAbsolute } from "node:path";
+import { createZvecGrep, } from "../engine/service/index.js";
+import { DaemonError } from "./errors.js";
+import { RootRuntime } from "./root-runtime.js";
+import { RootLeaseManager } from "./root-lease.js";
+export class RuntimeManager {
+    options;
+    runtimes = new Map();
+    creating = new Map();
+    aliases = new Map();
+    rootLeaseManager;
+    idleTimers = new Map();
+    closed = false;
+    constructor(options) {
+        this.options = options;
+        this.rootLeaseManager = options.rootLeaseManager ?? new RootLeaseManager();
+    }
+    get instanceToken() {
+        return this.rootLeaseManager.instanceToken;
+    }
+    async activate(requestedRoot) {
+        if (this.closed) {
+            throw new DaemonError("DAEMON_SHUTTING_DOWN", "The daemon is shutting down.", true);
+        }
+        const canonicalRequestedRoot = await resolveRequestedRoot(requestedRoot, false);
+        const activeRequestedRoot = this.runtimes.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
+        if (activeRequestedRoot &&
+            (activeRequestedRoot.snapshot().writerPending ||
+                activeRequestedRoot.needsReconciliation())) {
+            return activeRequestedRoot;
+        }
+        const creatingRequestedRoot = this.creating.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
+        if (creatingRequestedRoot) {
+            return creatingRequestedRoot;
+        }
+        const info = await inspectRoot(requestedRoot, this.options.serviceOptions, false);
+        if (!info.indexed || !info.workspaceIndex?.embedding) {
+            throw new DaemonError("INDEX_MISSING", `Indexed search requires a built zvec-grep index for ${info.root}. Use an available exact-search fallback when it is sufficient. Creating or rebuilding a persistent index requires explicit user authorization.`);
+        }
+        const canonicalRoot = await realpath(info.root);
+        this.aliases.set(canonicalRequestedRoot, canonicalRoot);
+        return this.getOrCreate(canonicalRoot, {
+            model: {
+                provider: info.workspaceIndex.embedding.provider,
+                name: info.workspaceIndex.embedding.model,
+            },
+        });
+    }
+    async activateForIndex(requestedRoot) {
+        if (this.closed) {
+            throw new DaemonError("DAEMON_SHUTTING_DOWN", "The daemon is shutting down.", true);
+        }
+        const canonicalRequestedRoot = await resolveRequestedRoot(requestedRoot, true);
+        const activeRequestedRoot = this.runtimes.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
+        if (activeRequestedRoot) {
+            return activeRequestedRoot;
+        }
+        const creatingRequestedRoot = this.creating.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
+        if (creatingRequestedRoot) {
+            return creatingRequestedRoot;
+        }
+        const info = await inspectRoot(canonicalRequestedRoot, this.options.serviceOptions, false);
+        const canonicalRoot = await resolveRequestedRoot(info.root, true);
+        this.aliases.set(canonicalRequestedRoot, canonicalRoot);
+        return this.getOrCreate(canonicalRoot);
+    }
+    async peek(requestedRoot) {
+        const info = await inspectRoot(requestedRoot, this.options.serviceOptions, false);
+        const canonicalRoot = await realpath(info.root);
+        return this.runtimes.get(canonicalRoot);
+    }
+    getByCanonicalRoot(canonicalRoot) {
+        return this.runtimes.get(canonicalRoot);
+    }
+    getByRequestedRoot(requestedRoot) {
+        return this.runtimes.get(this.aliases.get(requestedRoot) ?? requestedRoot);
+    }
+    snapshot() {
+        return { activeRuntimes: this.runtimes.size };
+    }
+    async evict(canonicalRoot) {
+        const creating = this.creating.get(canonicalRoot);
+        if (creating) {
+            await creating;
+        }
+        const timer = this.idleTimers.get(canonicalRoot);
+        if (timer)
+            clearTimeout(timer);
+        this.idleTimers.delete(canonicalRoot);
+        const runtime = this.runtimes.get(canonicalRoot);
+        this.runtimes.delete(canonicalRoot);
+        for (const [alias, target] of this.aliases) {
+            if (alias === canonicalRoot || target === canonicalRoot) {
+                this.aliases.delete(alias);
+            }
+        }
+        if (!runtime)
+            return false;
+        try {
+            await this.options.onRuntimeEvicted?.(canonicalRoot);
+        }
+        finally {
+            await runtime.close();
+        }
+        return true;
+    }
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await Promise.allSettled(this.creating.values());
+        const runtimes = [...this.runtimes.values()];
+        for (const timer of this.idleTimers.values())
+            clearTimeout(timer);
+        this.idleTimers.clear();
+        this.runtimes.clear();
+        this.aliases.clear();
+        await Promise.all(runtimes.map((runtime) => runtime.close()));
+        await this.rootLeaseManager.close();
+    }
+    async getOrCreate(canonicalRoot, modelLoadRequest) {
+        const existing = this.runtimes.get(canonicalRoot);
+        if (existing) {
+            if (modelLoadRequest) {
+                existing.updateModelLoadRequest(modelLoadRequest);
+            }
+            this.touchRuntime(canonicalRoot);
+            return existing;
+        }
+        let pending = this.creating.get(canonicalRoot);
+        if (!pending) {
+            pending = this.createRuntime(canonicalRoot, modelLoadRequest);
+            this.creating.set(canonicalRoot, pending);
+        }
+        try {
+            const runtime = await pending;
+            if (modelLoadRequest) {
+                runtime.updateModelLoadRequest(modelLoadRequest);
+            }
+            this.touchRuntime(canonicalRoot);
+            return runtime;
+        }
+        finally {
+            this.creating.delete(canonicalRoot);
+        }
+    }
+    async createRuntime(canonicalRoot, modelLoadRequest) {
+        let runtime;
+        if (this.options.createRuntime) {
+            runtime = await this.options.createRuntime({
+                canonicalRoot,
+                modelLoadRequest,
+                modelPool: this.options.modelPool,
+            });
+        }
+        else {
+            const rootLease = await this.rootLeaseManager.acquire(canonicalRoot);
+            runtime = new RootRuntime({
+                canonicalRoot,
+                modelPool: this.options.modelPool,
+                modelLoadRequest,
+                rootLease,
+                readSessionIdleTtlMs: this.options.readSessionIdleTtlMs,
+                onActivity: () => this.touchRuntime(canonicalRoot),
+            });
+        }
+        if (this.closed) {
+            await runtime.close();
+            throw new DaemonError("DAEMON_SHUTTING_DOWN", "The daemon is shutting down.", true);
+        }
+        this.runtimes.set(canonicalRoot, runtime);
+        this.touchRuntime(canonicalRoot);
+        return runtime;
+    }
+    touchRuntime(canonicalRoot) {
+        const idleTtlMs = this.options.runtimeIdleTtlMs ?? 30 * 60_000;
+        const existing = this.idleTimers.get(canonicalRoot);
+        if (existing)
+            clearTimeout(existing);
+        if (idleTtlMs <= 0 || this.closed) {
+            return;
+        }
+        const timer = setTimeout(() => void this.evictIfIdle(canonicalRoot), idleTtlMs);
+        timer.unref?.();
+        this.idleTimers.set(canonicalRoot, timer);
+    }
+    async evictIfIdle(canonicalRoot) {
+        this.idleTimers.delete(canonicalRoot);
+        const runtime = this.runtimes.get(canonicalRoot);
+        if (!runtime) {
+            return;
+        }
+        const snapshot = runtime.snapshot();
+        if (snapshot.activeReaders > 0 ||
+            snapshot.activeOperations > 0 ||
+            snapshot.writerPending ||
+            snapshot.watcherPending) {
+            this.touchRuntime(canonicalRoot);
+            return;
+        }
+        await this.evict(canonicalRoot);
+    }
+}
+export async function inspectRoot(requestedRoot, serviceOptions = {}, includeStatus = true) {
+    const canonicalRequestedRoot = await resolveRequestedRoot(requestedRoot, false);
+    const service = await createZvecGrep({
+        ...serviceOptions,
+        root: canonicalRequestedRoot,
+    });
+    try {
+        return await service.info({ root: canonicalRequestedRoot, includeStatus });
+    }
+    finally {
+        await service.close();
+    }
+}
+export async function resolveRequestedRoot(requestedRoot, writable) {
+    if (!isAbsolute(requestedRoot)) {
+        throw new DaemonError("ROOT_NOT_ABSOLUTE", "root must be an absolute path.");
+    }
+    let rootStat;
+    try {
+        rootStat = await stat(requestedRoot);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "EACCES" || code === "EPERM") {
+            throw new DaemonError("ROOT_PERMISSION_DENIED", "root is not readable.");
+        }
+        throw new DaemonError("ROOT_NOT_FOUND", "root does not exist.");
+    }
+    if (!rootStat.isDirectory()) {
+        throw new DaemonError("ROOT_NOT_FOUND", "root is not a directory.");
+    }
+    try {
+        await access(requestedRoot, writable ? fsConstants.R_OK | fsConstants.W_OK : fsConstants.R_OK);
+    }
+    catch {
+        throw new DaemonError("ROOT_PERMISSION_DENIED", writable ? "root is not writable." : "root is not readable.");
+    }
+    return realpath(requestedRoot);
+}
+//# sourceMappingURL=runtime-manager.js.map

package/dist/daemon/runtime-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-manager.js","sourceRoot":"","sources":["../../src/daemon/runtime-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,cAAc,GAEf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAoBnD,MAAM,OAAO,cAAc;IAWI;IAVZ,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1C,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IACnD,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,gBAAgB,CAAmB;IACnC,UAAU,GAAG,IAAI,GAAG,EAGlC,CAAC;IACI,MAAM,GAAG,KAAK,CAAC;IAEvB,YAA6B,OAA8B;QAA9B,YAAO,GAAP,OAAO,CAAuB;QACzD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC7E,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,aAAqB;QAClC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,WAAW,CACnB,sBAAsB,EACtB,8BAA8B,EAC9B,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,sBAAsB,GAAG,MAAM,oBAAoB,CACvD,aAAa,EACb,KAAK,CACN,CAAC;QACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,sBAAsB,CACnE,CAAC;QACF,IACE,mBAAmB;YACnB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,aAAa;gBAC3C,mBAAmB,CAAC,mBAAmB,EAAE,CAAC,EAC5C,CAAC;YACD,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QACD,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,sBAAsB,CACnE,CAAC;QACF,IAAI,qBAAqB,EAAE,CAAC;YAC1B,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,WAAW,CAC5B,aAAa,EACb,IAAI,CAAC,OAAO,CAAC,cAAc,EAC3B,KAAK,CACN,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC;YACrD,MAAM,IAAI,WAAW,CACnB,eAAe,EACf,uDAAuD,IAAI,CAAC,IAAI,iJAAiJ,CAClN,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,aAAa,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE;YACrC,KAAK,EAAE;gBACL,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,QAAQ;gBAChD,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK;aAC1C;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,aAAqB;QAC1C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,WAAW,CACnB,sBAAsB,EACtB,8BAA8B,EAC9B,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,sBAAsB,GAAG,MAAM,oBAAoB,CACvD,aAAa,EACb,IAAI,CACL,CAAC;QACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,sBAAsB,CACnE,CAAC;QACF,IAAI,mBAAmB,EAAE,CAAC;YACxB,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QACD,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,sBAAsB,CACnE,CAAC;QACF,IAAI,qBAAqB,EAAE,CAAC;YAC1B,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,WAAW,CAC5B,sBAAsB,EACtB,IAAI,CAAC,OAAO,CAAC,cAAc,EAC3B,KAAK,CACN,CAAC;QACF,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,aAAa,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,aAAqB;QAC9B,MAAM,IAAI,GAAG,MAAM,WAAW,CAC5B,aAAa,EACb,IAAI,CAAC,OAAO,CAAC,cAAc,EAC3B,KAAK,CACN,CAAC;QACF,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED,kBAAkB,CAAC,aAAqB;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED,kBAAkB,CAAC,aAAqB;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC;IAC7E,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,aAAqB;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC;QACjB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,IAAI,KAAK,KAAK,aAAa,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;gBACxD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,CAAC;QACvD,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,aAAqB,EACrB,gBAA4C;QAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,gBAAgB,EAAE,CAAC;gBACrB,QAAQ,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;YACpD,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;YAC9D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;YAC9B,IAAI,gBAAgB,EAAE,CAAC;gBACrB,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YACjC,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,aAAqB,EACrB,gBAA4C;QAE5C,IAAI,OAAoB,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC/B,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;gBACzC,aAAa;gBACb,gBAAgB;gBAChB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;aAClC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACrE,OAAO,GAAG,IAAI,WAAW,CAAC;gBACxB,aAAa;gBACb,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;gBACjC,gBAAgB;gBAChB,SAAS;gBACT,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,oBAAoB;gBACvD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,WAAW,CACnB,sBAAsB,EACtB,8BAA8B,EAC9B,IAAI,CACL,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,YAAY,CAAC,aAAqB;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,GAAG,MAAM,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACpD,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,SAAS,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,EAC1C,SAAS,CACV,CAAC;QACF,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,aAAqB;QAC7C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACpC,IACE,QAAQ,CAAC,aAAa,GAAG,CAAC;YAC1B,QAAQ,CAAC,gBAAgB,GAAG,CAAC;YAC7B,QAAQ,CAAC,aAAa;YACtB,QAAQ,CAAC,cAAc,EACvB,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,aAAqB,EACrB,iBAAwC,EAAE,EAC1C,aAAa,GAAG,IAAI;IAEpB,MAAM,sBAAsB,GAAG,MAAM,oBAAoB,CACvD,aAAa,EACb,KAAK,CACN,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;QACnC,GAAG,cAAc;QACjB,IAAI,EAAE,sBAAsB;KAC7B,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7E,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAAqB,EACrB,QAAiB;IAEjB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,WAAW,CACnB,mBAAmB,EACnB,gCAAgC,CACjC,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1C,MAAM,IAAI,WAAW,CAAC,wBAAwB,EAAE,uBAAuB,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,IAAI,WAAW,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,WAAW,CAAC,gBAAgB,EAAE,0BAA0B,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,CACV,aAAa,EACb,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAClE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CACnB,wBAAwB,EACxB,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,aAAa,CAAC,CAAC;AACjC,CAAC"}

package/dist/daemon/runtime.d.ts

@@ -0,0 +1,12 @@
+import type { CreateZvecGrepOptions } from "../engine/service/types.js";
+import { type McpToolset } from "../mcp/toolset.js";
+export type RunDaemonOptions = {
+    version: string;
+    listen?: string;
+    token?: string;
+    tokenFile?: string;
+    home?: string;
+    mcpToolset?: McpToolset;
+    serviceOptions?: CreateZvecGrepOptions;
+};
+export declare function runDaemonForeground(options: RunDaemonOptions): Promise<void>;

package/dist/daemon/runtime.js

@@ -0,0 +1,102 @@
+import { DaemonBackend } from "./backend.js";
+import { configuredListenAddress, resolveServerToken } from "./config.js";
+import { DaemonHttpServer } from "./http-server.js";
+import { DaemonInstanceLock } from "./server-controller.js";
+import { createDaemonLogger } from "./logger.js";
+import { MCP_TOOLSET_ENV, resolveMcpToolset, } from "../mcp/toolset.js";
+import { loadOrCreateMcpRequestStateKey, PersistentRemoteEmbeddingRequestStateReplayGuard, } from "../mcp/request-state.js";
+export async function runDaemonForeground(options) {
+    const mcpToolset = resolveMcpToolset(options.mcpToolset, process.env[MCP_TOOLSET_ENV]);
+    const listen = configuredListenAddress(options.listen);
+    const displayAddress = `http://${displayHost(listen.host)}:${listen.port}/mcp`;
+    const instanceLock = await DaemonInstanceLock.acquire(options.home, displayAddress, mcpToolset);
+    const logger = createDaemonLogger(options.home);
+    let auth;
+    try {
+        auth = await resolveServerToken({
+            token: options.token,
+            tokenFile: options.tokenFile,
+            home: options.home,
+        });
+    }
+    catch (error) {
+        await instanceLock.release();
+        throw error;
+    }
+    let requestStateKey;
+    try {
+        requestStateKey = await loadOrCreateMcpRequestStateKey(options.home);
+    }
+    catch (error) {
+        await instanceLock.release();
+        throw error;
+    }
+    const backend = new DaemonBackend({
+        version: options.version,
+        serviceOptions: options.serviceOptions,
+        logger,
+    });
+    let requestStop;
+    const httpServer = new DaemonHttpServer({
+        ...listen,
+        token: auth.token,
+        version: options.version,
+        mcpToolset,
+        backend,
+        requestStateKey,
+        requestStateReplayGuard: new PersistentRemoteEmbeddingRequestStateReplayGuard(options.home),
+        logger,
+        onShutdown: () => requestStop?.(),
+    });
+    let address;
+    try {
+        address = await httpServer.start();
+    }
+    catch (error) {
+        await backend.close();
+        await instanceLock.release();
+        throw error;
+    }
+    const stopped = new Promise((resolve) => {
+        let stopping = false;
+        const stop = () => {
+            if (stopping)
+                return;
+            stopping = true;
+            void (async () => {
+                await backend.close();
+                await httpServer.close();
+                await instanceLock.release();
+                logger.event("server.stopped", { pid: process.pid });
+                await logger.flush();
+            })().finally(resolve);
+        };
+        requestStop = stop;
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+    try {
+        await instanceLock.markReady();
+    }
+    catch (error) {
+        requestStop?.();
+        await stopped;
+        throw error;
+    }
+    logger.event("server.ready", {
+        host: listen.host,
+        port: address.port,
+        pid: process.pid,
+        mcp_toolset: mcpToolset,
+    });
+    console.log(`zvec-grep server listening on http://${displayHost(address.address)}:${address.port}/mcp`);
+    console.log(`MCP toolset: ${mcpToolset}`);
+    if (auth.tokenFile) {
+        console.log(`Bearer token file: ${auth.tokenFile}`);
+    }
+    await stopped;
+}
+function displayHost(host) {
+    return host.includes(":") ? `[${host}]` : host;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/daemon/runtime.js.map

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

package/dist/daemon/server-controller.d.ts

@@ -0,0 +1,39 @@
+import { type McpToolset } from "../mcp/toolset.js";
+export type DaemonInstanceRecord = {
+    pid: number;
+    hostname: string;
+    instanceToken: string;
+    startedAt: number;
+    updatedAt: number;
+    serverUrl: string;
+    ready: boolean;
+    mcpToolset: McpToolset;
+};
+export type DaemonControlStatus = {
+    running: boolean;
+    ready: boolean;
+    pid?: number;
+    serverUrl?: string;
+    mcpToolset?: McpToolset;
+};
+export declare class DaemonInstanceLock {
+    readonly path: string;
+    readonly record: DaemonInstanceRecord;
+    private heartbeat?;
+    private constructor();
+    static acquire(home: string | undefined, serverUrl: string, mcpToolset?: McpToolset): Promise<DaemonInstanceLock>;
+    markReady(): Promise<void>;
+    release(): Promise<void>;
+    private write;
+}
+export declare function readInstanceRecord(home?: string): Promise<DaemonInstanceRecord | undefined>;
+export declare function serverStatus(home?: string): Promise<DaemonControlStatus>;
+export declare function startServer(options: {
+    cliPath: string;
+    listen?: string;
+    tokenFile?: string;
+    home?: string;
+    timeoutMs?: number;
+    mcpToolset?: McpToolset;
+}): Promise<DaemonControlStatus>;
+export declare function stopServer(home?: string, timeoutMs?: number, tokenFile?: string): Promise<DaemonControlStatus>;