@angri450/zvec-grep 0.2.2

package/dist/engine/utils/lock.js

@@ -0,0 +1,254 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { hostname } from "node:os";
+import { dirname, join } from "node:path";
+import { detail, EngineError, errorDetails } from "../errors.js";
+const LOCK_INFO_FILE = "lock.json";
+const DEFAULT_STALE_LOCK_MS = 6 * 60 * 60 * 1000;
+function acquireExclusiveDirectoryLock(lockPath, options) {
+    mkdirSync(dirname(lockPath), { recursive: true });
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            mkdirSync(lockPath);
+            const info = currentLockInfo(options.operation);
+            writeFileSync(lockInfoPath(lockPath), `${JSON.stringify(info, null, 2)}\n`, "utf8");
+            return {
+                path: lockPath,
+                info,
+                release: () => releaseFileLock(lockPath, info),
+            };
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "EEXIST") {
+                throw error;
+            }
+            if (cleanupStaleLock(lockPath, options.staleMs ?? DEFAULT_STALE_LOCK_MS)) {
+                continue;
+            }
+            throw lockBusyError(lockPath, options.operation);
+        }
+    }
+    throw lockBusyError(lockPath, options.operation);
+}
+function assertExclusiveDirectoryUnlocked(lockPath, operation) {
+    if (!existsSync(lockPath)) {
+        return;
+    }
+    if (cleanupStaleLock(lockPath, DEFAULT_STALE_LOCK_MS)) {
+        return;
+    }
+    throw lockBusyError(lockPath, operation);
+}
+export function acquireReadWriteLock(lockPath, mode, options) {
+    return mode === "read"
+        ? acquireReadLock(lockPath, options)
+        : acquireWriteLock(lockPath, options);
+}
+export function assertNoWriteLock(lockPath, operation) {
+    assertExclusiveDirectoryUnlocked(writeLockPath(lockPath), operation);
+}
+function currentLockInfo(operation) {
+    return {
+        token: randomUUID(),
+        pid: process.pid,
+        hostname: hostname(),
+        startedAt: Date.now(),
+        operation,
+    };
+}
+function acquireReadLock(lockPath, options) {
+    mkdirSync(dirname(lockPath), { recursive: true });
+    const staleMs = options.staleMs ?? DEFAULT_STALE_LOCK_MS;
+    const writePath = writeLockPath(lockPath);
+    for (let attempt = 0; attempt < 2; attempt++) {
+        if (existsSync(writePath)) {
+            if (cleanupStaleLock(writePath, staleMs)) {
+                continue;
+            }
+            throw lockBusyError(writePath, options.operation);
+        }
+        const info = currentLockInfo(options.operation);
+        const readerPath = join(readersLockPath(lockPath), `${info.pid}-${info.token}`);
+        try {
+            mkdirSync(readerPath, { recursive: true });
+            writeFileSync(lockInfoPath(readerPath), `${JSON.stringify(info, null, 2)}\n`, "utf8");
+            if (existsSync(writePath)) {
+                releaseFileLock(readerPath, info);
+                if (cleanupStaleLock(writePath, staleMs)) {
+                    continue;
+                }
+                throw lockBusyError(writePath, options.operation);
+            }
+            return {
+                path: readerPath,
+                info,
+                release: () => releaseFileLock(readerPath, info),
+            };
+        }
+        catch (error) {
+            releaseFileLock(readerPath, info);
+            if (!isNodeError(error) || error.code !== "EEXIST") {
+                throw error;
+            }
+        }
+    }
+    throw lockBusyError(writePath, options.operation);
+}
+function acquireWriteLock(lockPath, options) {
+    const staleMs = options.staleMs ?? DEFAULT_STALE_LOCK_MS;
+    const writePath = writeLockPath(lockPath);
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const lock = acquireExclusiveDirectoryLock(writePath, options);
+        if (!hasActiveReaders(lockPath, staleMs)) {
+            return lock;
+        }
+        lock.release();
+        throw readLockBusyError(lockPath, options.operation);
+    }
+    throw readLockBusyError(lockPath, options.operation);
+}
+function releaseFileLock(lockPath, owner) {
+    const current = readLockInfo(lockPath);
+    if (current?.token !== owner.token) {
+        return;
+    }
+    rmSync(lockPath, { recursive: true, force: true });
+}
+function cleanupStaleLock(lockPath, staleMs) {
+    if (!existsSync(lockPath)) {
+        return false;
+    }
+    const info = readLockInfo(lockPath);
+    if (!isStaleLock(lockPath, info, staleMs)) {
+        return false;
+    }
+    rmSync(lockPath, { recursive: true, force: true });
+    return true;
+}
+function hasActiveReaders(lockPath, staleMs) {
+    const readersPath = readersLockPath(lockPath);
+    if (!existsSync(readersPath)) {
+        return false;
+    }
+    let entries;
+    try {
+        entries = readdirSync(readersPath);
+    }
+    catch {
+        return false;
+    }
+    let active = false;
+    for (const entry of entries) {
+        const readerPath = join(readersPath, entry);
+        if (cleanupStaleLock(readerPath, staleMs)) {
+            continue;
+        }
+        active = true;
+    }
+    return active;
+}
+function isStaleLock(lockPath, info, staleMs) {
+    const now = Date.now();
+    const startedAt = info?.startedAt ?? lockDirectoryMtime(lockPath);
+    const expired = now - startedAt > staleMs;
+    if (!info) {
+        return expired;
+    }
+    if (info.hostname === hostname() && !processIsAlive(info.pid)) {
+        return true;
+    }
+    return expired;
+}
+function processIsAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return isNodeError(error) && error.code === "EPERM";
+    }
+}
+function readLockInfo(lockPath) {
+    try {
+        const parsed = JSON.parse(readFileSync(lockInfoPath(lockPath), "utf8"));
+        if (typeof parsed.token === "string" &&
+            typeof parsed.pid === "number" &&
+            typeof parsed.hostname === "string" &&
+            typeof parsed.startedAt === "number" &&
+            typeof parsed.operation === "string") {
+            return parsed;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function lockDirectoryMtime(lockPath) {
+    try {
+        return statSync(lockPath).mtimeMs;
+    }
+    catch {
+        return Date.now();
+    }
+}
+function lockBusyError(lockPath, requestedOperation) {
+    const owner = readLockInfo(lockPath);
+    return new EngineError("Index unavailable", {
+        code: "ZVEC_GREP.ENGINE.LOCK.BUSY",
+        context: errorDetails([
+            detail("lock", lockPath),
+            detail("operation", requestedOperation),
+            detail("ownerOperation", owner?.operation),
+            detail("ownerPid", owner?.pid),
+            detail("ownerHost", owner?.hostname),
+        ]),
+    });
+}
+function readLockBusyError(lockPath, requestedOperation) {
+    const owner = firstActiveReaderInfo(lockPath);
+    return new EngineError("Index unavailable", {
+        code: "ZVEC_GREP.ENGINE.LOCK.BUSY",
+        context: errorDetails([
+            detail("lock", readersLockPath(lockPath)),
+            detail("operation", requestedOperation),
+            detail("ownerOperation", owner?.operation),
+            detail("ownerPid", owner?.pid),
+            detail("ownerHost", owner?.hostname),
+        ]),
+    });
+}
+function firstActiveReaderInfo(lockPath) {
+    const readersPath = readersLockPath(lockPath);
+    if (!existsSync(readersPath)) {
+        return null;
+    }
+    try {
+        for (const entry of readdirSync(readersPath)) {
+            const info = readLockInfo(join(readersPath, entry));
+            if (info) {
+                return info;
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function lockInfoPath(lockPath) {
+    return join(lockPath, LOCK_INFO_FILE);
+}
+function writeLockPath(lockPath) {
+    return `${lockPath}.write`;
+}
+function readersLockPath(lockPath) {
+    return `${lockPath}.readers`;
+}
+function isNodeError(error) {
+    return typeof error === "object" && error !== null && "code" in error;
+}
+//# sourceMappingURL=lock.js.map

package/dist/engine/utils/lock.js.map

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

package/dist/engine/utils/path.d.ts

@@ -0,0 +1,4 @@
+export declare function defaultHome(): string;
+export declare function normalizePath(path: string): string;
+export declare function toDisplayPath(path: string): string;
+export declare function isPathInside(parent: string, child: string): boolean;

package/dist/engine/utils/path.js

@@ -0,0 +1,18 @@
+import { homedir } from "node:os";
+import { resolve, sep } from "node:path";
+export function defaultHome() {
+    return process.env.ZVEC_GREP_HOME ?? resolve(homedir(), ".zvec-grep");
+}
+export function normalizePath(path) {
+    return resolve(path);
+}
+export function toDisplayPath(path) {
+    return path.split(sep).join("/");
+}
+export function isPathInside(parent, child) {
+    const normalizedParent = normalizePath(parent);
+    const normalizedChild = normalizePath(child);
+    return (normalizedChild === normalizedParent ||
+        normalizedChild.startsWith(`${normalizedParent}${sep}`));
+}
+//# sourceMappingURL=path.js.map

package/dist/engine/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/engine/utils/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAa;IACxD,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAE7C,OAAO,CACL,eAAe,KAAK,gBAAgB;QACpC,eAAe,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,GAAG,EAAE,CAAC,CACxD,CAAC;AACJ,CAAC"}

package/dist/engine/utils/timing.d.ts

@@ -0,0 +1,19 @@
+import type { TimingEntry } from "../types.js";
+export declare class TimingCollector {
+    private readonly entriesByName;
+    time<T>(name: string, task: () => Promise<T>): Promise<T>;
+    timeSync<T>(name: string, task: () => T): T;
+    add(name: string, durationMs: number, count?: number): void;
+    addEntries(entries: readonly TimingEntry[] | undefined, prefix?: string): void;
+    entries(): TimingEntry[];
+}
+export declare class ConcurrentTiming {
+    private readonly collector;
+    private readonly name;
+    private active;
+    private startedAt;
+    constructor(collector: TimingCollector, name: string);
+    time<T>(task: () => Promise<T>): Promise<T>;
+    private start;
+    private stop;
+}

package/dist/engine/utils/timing.js

@@ -0,0 +1,87 @@
+import { performance } from "node:perf_hooks";
+export class TimingCollector {
+    entriesByName = new Map();
+    async time(name, task) {
+        const start = performance.now();
+        try {
+            return await task();
+        }
+        finally {
+            this.add(name, performance.now() - start);
+        }
+    }
+    timeSync(name, task) {
+        const start = performance.now();
+        try {
+            return task();
+        }
+        finally {
+            this.add(name, performance.now() - start);
+        }
+    }
+    add(name, durationMs, count = 1) {
+        const normalizedName = name.trim();
+        if (!normalizedName || !Number.isFinite(durationMs)) {
+            return;
+        }
+        const existing = this.entriesByName.get(normalizedName);
+        if (existing) {
+            existing.durationMs += Math.max(0, durationMs);
+            existing.count += Math.max(1, count);
+            return;
+        }
+        this.entriesByName.set(normalizedName, {
+            name: normalizedName,
+            durationMs: Math.max(0, durationMs),
+            count: Math.max(1, count),
+        });
+    }
+    addEntries(entries, prefix = "") {
+        for (const entry of entries ?? []) {
+            this.add(`${prefix}${entry.name}`, entry.durationMs, entry.count ?? 1);
+        }
+    }
+    entries() {
+        return [...this.entriesByName.values()].map((entry) => ({
+            name: entry.name,
+            durationMs: Math.round(entry.durationMs),
+            ...(entry.count > 1 ? { count: entry.count } : {}),
+        }));
+    }
+}
+export class ConcurrentTiming {
+    collector;
+    name;
+    active = 0;
+    startedAt = 0;
+    constructor(collector, name) {
+        this.collector = collector;
+        this.name = name;
+    }
+    async time(task) {
+        this.start();
+        try {
+            return await task();
+        }
+        finally {
+            this.stop();
+        }
+    }
+    start() {
+        if (this.active === 0) {
+            this.startedAt = performance.now();
+        }
+        this.active++;
+    }
+    stop() {
+        if (this.active <= 0) {
+            return;
+        }
+        this.active--;
+        if (this.active === 0) {
+            this.collector.add(this.name, performance.now() - this.startedAt);
+            this.startedAt = 0;
+        }
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/engine/utils/timing.js.map

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

package/dist/index-progress.d.ts

@@ -0,0 +1,10 @@
+import type { IndexProgress } from "./engine/types.js";
+export type IndexProgressUpdate = {
+    phase: IndexProgress["phase"];
+    line: string;
+    progress: IndexProgress;
+};
+export declare function formatIndexProgressLine(progress: IndexProgress): string | undefined;
+export declare function formatModelDownloadProgress(progress: IndexProgress): string | undefined;
+export declare function indexProgressMessage(progress: IndexProgress): string | undefined;
+export declare function indexProgressFromMessage(message: string | undefined): IndexProgressUpdate | undefined;

package/dist/index-progress.js

@@ -0,0 +1,159 @@
+const MCP_INDEX_PROGRESS_PREFIX = "zvec-grep:index-progress:";
+export function formatIndexProgressLine(progress) {
+    if (progress.phase === "scanning") {
+        return progress.detail;
+    }
+    if (progress.phase === "indexing") {
+        const modelDownload = formatModelDownloadProgress(progress);
+        if (modelDownload) {
+            return modelDownload;
+        }
+        const indexed = progress.filesIndexed ?? 0;
+        const total = progress.filesTotal ?? 0;
+        const detail = progress.detail ? ` ${truncate(progress.detail, 100)}` : "";
+        const failed = formatFailedProgress(progress);
+        const embedding = formatEmbeddingProgress(progress);
+        return total > 0
+            ? `Indexing files: ${indexed}/${total}${detail}${failed}${embedding}`
+            : `Indexing files...${detail}${failed}${embedding}`;
+    }
+    return progress.detail ?? "Indexing complete";
+}
+export function formatModelDownloadProgress(progress) {
+    const embedding = progress.embedding;
+    if (!embedding?.model) {
+        return undefined;
+    }
+    if (embedding.stage === "preparing") {
+        return `Preparing ${embedding.model}`;
+    }
+    if (embedding.stage === "warning") {
+        return `zvec-grep warning: ${singleLineText(embedding.message ?? "Embedding model warning")}`;
+    }
+    if (embedding.stage === "ready") {
+        return `Model ready: ${embedding.model}`;
+    }
+    if (embedding.stage !== "downloading") {
+        return undefined;
+    }
+    const parts = [`Downloading ${embedding.model}`];
+    const downloadedBytes = embedding.downloadedBytes;
+    const totalBytes = embedding.totalBytes;
+    if (typeof downloadedBytes === "number" &&
+        typeof totalBytes === "number" &&
+        totalBytes > 0) {
+        const percent = Math.min(100, Math.max(0, Math.round((downloadedBytes / totalBytes) * 100)));
+        parts.push(`${percent}%`);
+        parts.push(`${formatByteCount(downloadedBytes)}/${formatByteCount(totalBytes)}`);
+    }
+    else if (typeof downloadedBytes === "number") {
+        parts.push(formatByteCount(downloadedBytes));
+    }
+    return parts.join(" · ");
+}
+export function indexProgressMessage(progress) {
+    const line = formatIndexProgressLine(progress);
+    return line
+        ? `${MCP_INDEX_PROGRESS_PREFIX}${JSON.stringify({ line, progress })}`
+        : undefined;
+}
+export function indexProgressFromMessage(message) {
+    if (!message?.startsWith(MCP_INDEX_PROGRESS_PREFIX))
+        return undefined;
+    const payload = message.slice(MCP_INDEX_PROGRESS_PREFIX.length);
+    if (payload.startsWith("{")) {
+        try {
+            const decoded = JSON.parse(payload);
+            if (typeof decoded.line === "string" &&
+                isIndexProgress(decoded.progress)) {
+                return {
+                    phase: decoded.progress.phase,
+                    line: decoded.line,
+                    progress: decoded.progress,
+                };
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // Backward-compatible decoding for progress emitted by an older daemon.
+    const separator = payload.indexOf(":");
+    if (separator < 0)
+        return undefined;
+    const phase = payload.slice(0, separator);
+    if (phase !== "scanning" && phase !== "indexing" && phase !== "done") {
+        return undefined;
+    }
+    const line = payload.slice(separator + 1);
+    return { phase, line, progress: { phase, detail: line } };
+}
+function isIndexProgress(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const progress = value;
+    return (progress.phase === "scanning" ||
+        progress.phase === "indexing" ||
+        progress.phase === "done");
+}
+function formatFailedProgress(progress) {
+    const failed = progress.filesFailed ?? 0;
+    return failed > 0 ? ` [failed=${failed}]` : "";
+}
+function formatEmbeddingProgress(progress) {
+    const embedding = progress.embedding;
+    if (!embedding) {
+        return "";
+    }
+    const parts = [];
+    if (typeof embedding.concurrency === "number") {
+        parts.push(`concurrency=${embedding.concurrency}`);
+    }
+    if (typeof embedding.retryableFailures === "number" &&
+        embedding.retryableFailures > 0) {
+        parts.push(`retries=${embedding.retryableFailures}`);
+    }
+    return parts.length > 0 ? ` [embed ${parts.join(" ")}]` : "";
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, maxLength - 1))}...`;
+}
+function formatByteCount(value) {
+    const bytes = Math.max(0, value);
+    const units = ["B", "KiB", "MiB", "GiB"];
+    let amount = bytes;
+    let unitIndex = 0;
+    while (amount >= 1024 && unitIndex < units.length - 1) {
+        amount /= 1024;
+        unitIndex++;
+    }
+    const digits = unitIndex === 0 || amount >= 10 ? 0 : 1;
+    return `${amount.toFixed(digits)} ${units[unitIndex]}`;
+}
+function singleLineText(value) {
+    let result = "";
+    for (let index = 0; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        if (code === 0x1b && value.charCodeAt(index + 1) === 0x5b) {
+            index += 2;
+            while (index < value.length) {
+                const ansiCode = value.charCodeAt(index);
+                if (ansiCode >= 0x40 && ansiCode <= 0x7e) {
+                    break;
+                }
+                index++;
+            }
+            continue;
+        }
+        if (code < 0x20 || (code >= 0x7f && code <= 0x9f)) {
+            result += " ";
+            continue;
+        }
+        result += value[index];
+    }
+    return result.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=index-progress.js.map

package/dist/index-progress.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createZvecGrep } from "./engine/service/index.js";
+export type { CreateZvecGrepOptions, ZvecGrep, ZvecGrepContent, ZvecGrepContextWorkspaceIndex, ZvecGrepContextContainer, ZvecGrepContextCoverage, ZvecGrepContextDiagnostics, ZvecGrepContextFile, ZvecGrepContextGroupResult, ZvecGrepContextItem, ZvecGrepContextItemKind, ZvecGrepContextOptions, ZvecGrepContextResult, ZvecGrepContextRoute, ZvecGrepContextSource, ZvecGrepStructureEnrichmentDiagnostics, ZvecGrepIndexDiagnostics, ZvecGrepInfoOptions, ZvecGrepInfoResult, ZvecGrepIndexOptions, ZvecGrepRgDiagnostics, ZvecGrepSearchOptions, } from "./engine/service/index.js";
+export { createEmbeddingModel, EmbeddingPurpose, } from "./engine/models/index.js";
+export { isImageContent, isTextContent } from "./engine/types.js";
+export type { CodeEntityMetadata, CodeEntityModifier, CodeSymbolType, WorkspaceIndexEmbeddingSchema, WorkspaceIndexPolicy, WorkspaceIndexStatus, WorkspaceIndexInfo, Content, ContentKind, EntityMetadata, FileScanDiagnostics, FileFormat, FileIndexStatus, FileInfo, FileKind, ImageContent, ImageFormat, IndexOptions, IndexProgress, IndexProgressPhase, IndexResult, MarkdownEntityMetadata, RootPath, SkippedFile, SkippedFileReason, SearchFinalTrace, SearchHitTrace, SearchRecallTrace, SearchStageTrace, TextContent, TimingEntry, } from "./engine/types.js";
+export type { CreateEmbeddingModelOptions, EmbeddingModel, EmbeddingModelProgress, EmbeddingModelInfo, EmbeddingOptions, EmbeddingResult, } from "./engine/models/index.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createZvecGrep } from "./engine/service/index.js";
+export { createEmbeddingModel, EmbeddingPurpose, } from "./engine/models/index.js";
+export { isImageContent, isTextContent } from "./engine/types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAyB3D,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp/http-transport.d.ts

@@ -0,0 +1,27 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ZvecGrepDaemonBackend, ZvecGrepMcpServerOptions } from "./tools.js";
+export type McpHttpEndpointOptions = {
+    legacySessionIdleTtlMs?: number;
+    maxLegacySessions?: number;
+    modernOnly?: boolean;
+};
+export declare class McpHttpEndpoint {
+    private readonly backend;
+    private readonly version;
+    private readonly sessions;
+    private readonly initializing;
+    private readonly serverOptions;
+    private readonly modern;
+    private readonly modernNodeHandler;
+    private readonly legacySessionIdleTtlMs;
+    private readonly maxLegacySessions;
+    private readonly modernOnly;
+    constructor(backend: ZvecGrepDaemonBackend, version: string, serverOptions?: Readonly<ZvecGrepMcpServerOptions>, endpointOptions?: Readonly<McpHttpEndpointOptions>);
+    handlePost(request: IncomingMessage, response: ServerResponse, body: unknown): Promise<void>;
+    handleSessionRequest(request: IncomingMessage, response: ServerResponse): Promise<void>;
+    close(): Promise<void>;
+    private handleLegacyPost;
+    private expireIdleSessions;
+    private withActiveSession;
+    private forget;
+}