@angri450/zvec-grep 0.2.2

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,105 @@
+import { readGlobalConfig } from "../engine/config.js";
+import { DaemonBackend } from "./backend.js";
+import { configuredListenAddress, configuredWatcherIdleTimeoutMs, 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 runtimeIdleTtlMs = configuredWatcherIdleTimeoutMs();
+    const listen = configuredListenAddress(options.listen);
+    const displayAddress = `http://${displayHost(listen.host)}:${listen.port}/mcp`;
+    const logger = createDaemonLogger(options.home, readGlobalConfig().log);
+    const instanceLock = await DaemonInstanceLock.acquire(options.home, displayAddress, mcpToolset);
+    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,
+        runtimeIdleTtlMs,
+        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();
+                logger.event("server.stopped", { pid: process.pid });
+                await logger.flush();
+                await instanceLock.release();
+            })().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,38 @@
+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 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>;

package/dist/daemon/server-controller.js

@@ -0,0 +1,327 @@
+import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
+import { link, mkdir, open, readFile, unlink } from "node:fs/promises";
+import { createServer } from "node:net";
+import { hostname } from "node:os";
+import { join } from "node:path";
+import { configuredListenAddress, daemonHome, resolveClientToken, } from "./config.js";
+import { processIsAlive } from "../engine/utils/daemon-lease.js";
+import { replaceFileAtomically } from "../engine/utils/atomic-file.js";
+import { DEFAULT_MCP_TOOLSET, MCP_TOOLSET_ENV, resolveMcpToolset, } from "../mcp/toolset.js";
+const LIFTOFF_ONLY_FLAG = "--liftoff-only";
+const SHUTDOWN_REQUEST_TIMEOUT_MS = 2_000;
+const TERMINATION_GRACE_MS = 2_000;
+export class DaemonInstanceLock {
+    path;
+    record;
+    constructor(path, record) {
+        this.path = path;
+        this.record = record;
+    }
+    static async acquire(home, serverUrl, mcpToolset = DEFAULT_MCP_TOOLSET) {
+        const path = join(daemonHome(home), "instance.lock");
+        const record = {
+            pid: process.pid,
+            hostname: hostname(),
+            instanceToken: randomUUID(),
+            startedAt: Date.now(),
+            updatedAt: Date.now(),
+            serverUrl,
+            ready: false,
+            mcpToolset,
+        };
+        await mkdir(daemonHome(home), { recursive: true, mode: 0o700 });
+        const temporaryPath = `${path}.${record.instanceToken}.tmp`;
+        try {
+            const handle = await open(temporaryPath, "wx", 0o600);
+            try {
+                await handle.writeFile(`${JSON.stringify(record)}\n`);
+            }
+            finally {
+                await handle.close();
+            }
+            for (let attempt = 0; attempt < 3; attempt++) {
+                try {
+                    // Publish a complete record without replacing another owner. Unlike
+                    // rename, link fails with EEXIST if a competing daemon published first.
+                    await link(temporaryPath, path);
+                    return new DaemonInstanceLock(path, record);
+                }
+                catch (error) {
+                    if (error.code !== "EEXIST")
+                        throw error;
+                    const existing = await readInstanceRecord(home);
+                    if (existing &&
+                        existing.hostname === hostname() &&
+                        processIsAlive(existing.pid)) {
+                        throw new Error(`zvec-grep server is already running with PID ${existing.pid}`, { cause: error });
+                    }
+                    await unlink(path).catch(() => undefined);
+                }
+            }
+            throw new Error("Could not acquire the zvec-grep server instance lock.");
+        }
+        finally {
+            await unlink(temporaryPath).catch(() => undefined);
+        }
+    }
+    async markReady() {
+        this.record.ready = true;
+        await this.write();
+        // Liveness is checked using the PID and /healthz, not updatedAt.
+        // Persist state transitions only; no disk heartbeat is needed.
+    }
+    async release() {
+        const current = await readRecordPath(this.path);
+        if (current?.instanceToken === this.record.instanceToken &&
+            current.pid === process.pid) {
+            await unlink(this.path).catch(() => undefined);
+        }
+    }
+    async write() {
+        this.record.updatedAt = Date.now();
+        const current = await readRecordPath(this.path);
+        if (current?.instanceToken !== this.record.instanceToken ||
+            current.pid !== process.pid) {
+            throw new Error("zvec-grep server no longer owns its instance lock.");
+        }
+        // Keep the old record readable until the complete replacement is ready.
+        await replaceFileAtomically(this.path, `${JSON.stringify(this.record)}\n`, {
+            mode: 0o600,
+        });
+    }
+}
+export async function readInstanceRecord(home) {
+    return readRecordPath(join(daemonHome(home), "instance.lock"));
+}
+export async function serverStatus(home) {
+    const record = await readInstanceRecord(home);
+    if (!record ||
+        record.hostname !== hostname() ||
+        !processIsAlive(record.pid)) {
+        return { running: false, ready: false };
+    }
+    try {
+        const response = await fetch(new URL("/healthz", record.serverUrl), {
+            signal: AbortSignal.timeout(1_000),
+        });
+        return {
+            running: true,
+            ready: response.ok && record.ready,
+            pid: record.pid,
+            serverUrl: record.serverUrl,
+            mcpToolset: record.mcpToolset,
+        };
+    }
+    catch {
+        return {
+            running: true,
+            ready: false,
+            pid: record.pid,
+            serverUrl: record.serverUrl,
+            mcpToolset: record.mcpToolset,
+        };
+    }
+}
+export async function startServer(options) {
+    const environmentToolset = process.env[MCP_TOOLSET_ENV];
+    const requestedToolset = resolveMcpToolset(options.mcpToolset, environmentToolset);
+    const toolsetWasExplicit = options.mcpToolset !== undefined || environmentToolset !== undefined;
+    const current = await serverStatus(options.home);
+    if (current.running) {
+        if (toolsetWasExplicit &&
+            current.mcpToolset !== undefined &&
+            current.mcpToolset !== requestedToolset) {
+            throw new Error(`zvec-grep server is already running with MCP toolset "${current.mcpToolset}". Run \`zg --server off\`, then restart it with \`zg --server on --mcp-toolset ${requestedToolset}\`.`);
+        }
+        if (current.ready)
+            return current;
+        return waitForStatus(options.home, true, options.timeoutMs ?? 10_000);
+    }
+    const listen = configuredListenAddress(options.listen);
+    try {
+        await assertListenAddressAvailable(listen.host, listen.port);
+    }
+    catch (error) {
+        const starting = await waitForRunningRecord(options.home, 500);
+        if (starting) {
+            return waitForStatus(options.home, true, options.timeoutMs ?? 10_000);
+        }
+        throw error;
+    }
+    const args = [LIFTOFF_ONLY_FLAG, options.cliPath, "--server", "run"];
+    args.push("--mcp-toolset", requestedToolset);
+    if (options.listen)
+        args.push("--listen", options.listen);
+    if (options.tokenFile)
+        args.push("--token-file", options.tokenFile);
+    if (options.home)
+        args.push("--home", options.home);
+    const child = spawn(process.execPath, args, {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+    });
+    child.unref();
+    return waitForStatus(options.home, true, options.timeoutMs ?? 10_000);
+}
+export async function stopServer(home, timeoutMs = 30_000, tokenFile) {
+    const record = await readInstanceRecord(home);
+    if (!record ||
+        record.hostname !== hostname() ||
+        !processIsAlive(record.pid)) {
+        return { running: false, ready: false };
+    }
+    if (record.pid === process.pid) {
+        throw new Error("Refusing to stop the current process as a daemon.");
+    }
+    const token = await resolveClientToken({ home, tokenFile });
+    let shutdownAccepted = false;
+    try {
+        const response = await fetch(new URL("/control/shutdown", record.serverUrl), {
+            method: "POST",
+            headers: token ? { Authorization: `Bearer ${token}` } : {},
+            signal: AbortSignal.timeout(Math.min(SHUTDOWN_REQUEST_TIMEOUT_MS, Math.max(timeoutMs, 100))),
+        });
+        if (!response.ok) {
+            throw new ShutdownResponseError(response.status);
+        }
+        shutdownAccepted = true;
+    }
+    catch (error) {
+        if (error instanceof ShutdownResponseError)
+            throw error;
+    }
+    if (shutdownAccepted &&
+        (await waitForProcessExit(record.pid, Math.max(timeoutMs, 0)))) {
+        await removeStoppedInstanceRecord(home, record);
+        return { running: false, ready: false };
+    }
+    return forceStopRecordedProcess(home, record, shutdownAccepted, timeoutMs);
+}
+class ShutdownResponseError extends Error {
+    constructor(status) {
+        super(`Server shutdown request failed with HTTP ${status}`);
+    }
+}
+async function forceStopRecordedProcess(home, record, allowMissingRecord, timeoutMs) {
+    if (!processIsAlive(record.pid)) {
+        await removeStoppedInstanceRecord(home, record);
+        return { running: false, ready: false };
+    }
+    await assertSameInstanceBeforeSignal(home, record, allowMissingRecord);
+    signalProcess(record.pid, "SIGTERM");
+    const graceMs = Math.min(TERMINATION_GRACE_MS, Math.max(timeoutMs, 100));
+    if (await waitForProcessExit(record.pid, graceMs)) {
+        await removeStoppedInstanceRecord(home, record);
+        return { running: false, ready: false };
+    }
+    await assertSameInstanceBeforeSignal(home, record, true);
+    signalProcess(record.pid, "SIGKILL");
+    if (!(await waitForProcessExit(record.pid, graceMs))) {
+        throw new Error(`Timed out waiting for zvec-grep server process ${record.pid} to stop after SIGKILL.`);
+    }
+    await removeStoppedInstanceRecord(home, record);
+    return { running: false, ready: false };
+}
+async function assertSameInstanceBeforeSignal(home, expected, allowMissing) {
+    const current = await readInstanceRecord(home);
+    if (!current && allowMissing)
+        return;
+    if (!current ||
+        current.hostname !== expected.hostname ||
+        current.pid !== expected.pid ||
+        current.instanceToken !== expected.instanceToken) {
+        throw new Error("zvec-grep server instance changed while stopping; refusing to signal the recorded process.");
+    }
+}
+function signalProcess(pid, signal) {
+    try {
+        process.kill(pid, signal);
+    }
+    catch (error) {
+        if (error.code !== "ESRCH")
+            throw error;
+    }
+}
+async function removeStoppedInstanceRecord(home, stopped) {
+    const path = join(daemonHome(home), "instance.lock");
+    const current = await readRecordPath(path);
+    if (current?.pid === stopped.pid &&
+        current.instanceToken === stopped.instanceToken) {
+        await unlink(path).catch(() => undefined);
+    }
+}
+async function assertListenAddressAvailable(host, port) {
+    const probe = createServer();
+    try {
+        await new Promise((resolve, reject) => {
+            probe.once("error", reject);
+            probe.listen({ host, port, exclusive: true }, () => {
+                probe.removeListener("error", reject);
+                probe.close((error) => (error ? reject(error) : resolve()));
+            });
+        });
+    }
+    catch (error) {
+        if (error.code === "EADDRINUSE") {
+            throw new Error(`Server address ${host}:${port} is already in use. Another or legacy zvec-grep server may still be running.`, { cause: error });
+        }
+        throw error;
+    }
+}
+async function waitForProcessExit(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!processIsAlive(pid))
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    return !processIsAlive(pid);
+}
+async function waitForStatus(home, running, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    let last = { running: false, ready: false };
+    while (Date.now() < deadline) {
+        last = await serverStatus(home);
+        if (running ? last.running && last.ready : !last.running)
+            return last;
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    throw new Error(`Timed out waiting for zvec-grep server to ${running ? "start" : "stop"}.`);
+}
+async function waitForRunningRecord(home, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if ((await serverStatus(home)).running)
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 25));
+    }
+    return false;
+}
+async function readRecordPath(path) {
+    try {
+        const value = JSON.parse(await readFile(path, "utf8"));
+        if (typeof value.pid !== "number" ||
+            typeof value.hostname !== "string" ||
+            typeof value.instanceToken !== "string" ||
+            typeof value.startedAt !== "number" ||
+            typeof value.updatedAt !== "number" ||
+            typeof value.serverUrl !== "string" ||
+            typeof value.ready !== "boolean" ||
+            (value.mcpToolset !== undefined &&
+                value.mcpToolset !== "agent" &&
+                value.mcpToolset !== "full"))
+            return undefined;
+        return {
+            ...value,
+            // Locks written before toolset profiles exposed the full six-tool MCP
+            // surface, so preserve that behavior when reporting a live legacy daemon.
+            mcpToolset: value.mcpToolset ?? "full",
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=server-controller.js.map

package/dist/daemon/server-controller.js.map

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

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

@@ -0,0 +1,62 @@
+import { watch } from "node:fs";
+import type { RootPath } from "../engine/types.js";
+import { type ChangeSetSnapshot } from "./change-set.js";
+export type WatchManagerOptions = {
+    root: string;
+    onChanges: (changes: ChangeSetSnapshot, reason: "watch" | "reconcile") => void | Promise<void>;
+    debounceMs?: number;
+    maxWaitMs?: number;
+    reconcileIntervalMs?: number;
+    maxChangedPaths?: number;
+    watchFactory?: typeof watch;
+    onPendingChange?: (pending: boolean) => void;
+    onActivity?: () => void;
+    onActiveChange?: (active: boolean) => void;
+    resumeCheckIntervalMs?: number;
+    resumeThresholdMs?: number;
+    platform?: NodeJS.Platform;
+    getRootPaths?: () => readonly RootPath[] | undefined;
+};
+export declare class WatchManager {
+    private readonly options;
+    private readonly watchers;
+    private readonly watchedDirectories;
+    private readonly directoryWatchers;
+    private readonly pendingRecords;
+    private readonly inflightFlushes;
+    private readonly recoveryStates;
+    private changes;
+    private debounceTimer?;
+    private maxWaitTimer?;
+    private reconcileTimer?;
+    private resumeTimer?;
+    private closed;
+    private active;
+    private useDirectoryWatchers;
+    private reconcileRequested;
+    private lastResumeCheckAt;
+    constructor(options: WatchManagerOptions);
+    start(): void;
+    close(): Promise<void>;
+    flushPending(): Promise<void>;
+    refreshPaths(): Promise<void>;
+    checkForResume(now?: number): void;
+    private recordPath;
+    private queueRecord;
+    private queueFullReconcile;
+    private scheduleFlush;
+    private flush;
+    private newChangeSet;
+    private startFlush;
+    private addWatcher;
+    private recoveryState;
+    private recoverWatcher;
+    private restoreDirectoryWatcher;
+    private setActive;
+    private startPrimaryWatcher;
+    private startDirectoryWatchers;
+    private watchDirectoryTree;
+    private shouldTrackPath;
+    private refreshDirectoryTree;
+    private removeDirectoryWatchers;
+}