@zvec/zvec-grep 0.2.2 → 0.3.0-rc.2

package/dist/mcp/stdio-bridge.js

@@ -1,190 +0,0 @@
-import { Client, StreamableHTTPClientTransport, } from "@modelcontextprotocol/client";
-import { ResultSchema } from "@modelcontextprotocol/core";
-import { ProtocolErrorCode, SdkErrorCode, Server, } from "@modelcontextprotocol/server";
-import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
-import { REMOTE_EMBEDDING_ELICITATION_UNSUPPORTED_MESSAGE } from "../authorization/prompt.js";
-import { resolveClientToken } from "../daemon/config.js";
-import { serverStatus, startServer, } from "../daemon/server-controller.js";
-import { LONG_RUNNING_MCP_TIMEOUT_MS } from "./progress-heartbeat.js";
-export async function runStdioBootstrapBridge(options) {
-    const status = await startServer({
-        cliPath: options.cliPath,
-        home: options.home,
-        tokenFile: options.tokenFile,
-        listen: options.listen,
-        mcpToolset: options.mcpToolset,
-    });
-    if (!status.serverUrl) {
-        throw new Error("zvec-grep server became ready without an MCP URL");
-    }
-    const downstreamHolder = {};
-    let closed = false;
-    let resolveClosed;
-    const closedPromise = new Promise((resolve) => {
-        resolveClosed = resolve;
-    });
-    const finish = () => {
-        if (closed)
-            return;
-        closed = true;
-        resolveClosed();
-    };
-    const upstream = new Client({ name: "zvec-grep-stdio-bridge", version: options.version }, {
-        capabilities: {
-            elicitation: { form: {}, url: {} },
-            roots: { listChanged: true },
-            sampling: {},
-        },
-        versionNegotiation: { mode: { pin: "2026-07-28" } },
-    });
-    const forwardUpstreamRequest = async (request, context) => {
-        if (!downstreamHolder.server) {
-            throw new Error("stdio MCP client is not connected");
-        }
-        return forwardRequest(downstreamHolder.server, request, context.mcpReq.signal, context.mcpReq._meta);
-    };
-    upstream.fallbackRequestHandler = forwardUpstreamRequest;
-    registerStdioBridgeElicitationForwarding(upstream, () => downstreamHolder.server);
-    upstream.fallbackNotificationHandler = async (notification) => {
-        await downstreamHolder.server?.notification(notification);
-    };
-    upstream.onerror = (error) => console.error(error.message);
-    upstream.onclose = finish;
-    const token = await resolveClientToken({
-        home: options.home,
-        tokenFile: options.tokenFile,
-    });
-    const upstreamTransport = new StreamableHTTPClientTransport(new URL(status.serverUrl), {
-        requestInit: {
-            headers: token ? { Authorization: `Bearer ${token}` } : {},
-        },
-    });
-    await upstream.connect(upstreamTransport);
-    const downstream = new Server(upstream.getServerVersion() ?? {
-        name: "zvec-grep",
-        version: options.version,
-    }, {
-        capabilities: upstream.getServerCapabilities() ?? {},
-        instructions: upstream.getInstructions(),
-    });
-    downstream.fallbackRequestHandler = async (request, context) => forwardRequest(upstream, request, context.mcpReq.signal, context.mcpReq._meta, context.mcpReq.notify);
-    downstream.fallbackNotificationHandler = async (notification) => {
-        await upstream.notification(notification);
-    };
-    downstreamHolder.server = downstream;
-    downstream.onerror = (error) => console.error(error.message);
-    downstream.onclose = finish;
-    const downstreamTransport = new StdioServerTransport();
-    const shouldStop = createStdioBridgeStopCheck(status);
-    let monitorRunning = false;
-    let daemonFailure;
-    const monitor = setInterval(() => {
-        if (closed || monitorRunning)
-            return;
-        monitorRunning = true;
-        void serverStatus(options.home)
-            .then(async (current) => {
-            if (!shouldStop(current)) {
-                return;
-            }
-            daemonFailure = new Error("zvec-grep daemon stopped while the stdio bridge was connected");
-            finish();
-            await downstream.close().catch(() => undefined);
-        })
-            .finally(() => {
-            monitorRunning = false;
-        });
-    }, 2_000);
-    monitor.unref?.();
-    try {
-        await downstream.connect(downstreamTransport);
-        await closedPromise;
-    }
-    finally {
-        clearInterval(monitor);
-        await Promise.allSettled([upstream.close(), downstream.close()]);
-    }
-    if (daemonFailure)
-        throw daemonFailure;
-}
-export function createStdioBridgeStopCheck(connected) {
-    let consecutiveMissing = 0;
-    return (current) => {
-        // An unreadable lock is ambiguous. Allow two polls to recover, while
-        // still stopping immediately when a different live daemon is observed.
-        if (!current.running)
-            return ++consecutiveMissing >= 3;
-        consecutiveMissing = 0;
-        return shouldStopStdioBridge(connected, current);
-    };
-}
-export function shouldStopStdioBridge(connected, current) {
-    return (!current.running ||
-        current.pid !== connected.pid ||
-        current.serverUrl !== connected.serverUrl);
-}
-export function registerStdioBridgeElicitationForwarding(upstream, downstreamServer) {
-    // MCP SDK helpers resolve elicitation through the method-specific handler
-    // instead of the generic fallback. Register this path explicitly so a
-    // request from the shared daemon reaches the actual stdio host.
-    upstream.setRequestHandler("elicitation/create", async (request, context) => {
-        const downstream = downstreamServer();
-        if (!downstream) {
-            throw new Error("stdio MCP client is not connected");
-        }
-        try {
-            return await downstream.request({
-                method: "elicitation/create",
-                params: context.mcpReq._meta
-                    ? { ...request.params, _meta: context.mcpReq._meta }
-                    : request.params,
-            }, {
-                signal: context.mcpReq.signal,
-                timeout: LONG_RUNNING_MCP_TIMEOUT_MS,
-                resetTimeoutOnProgress: true,
-            });
-        }
-        catch (error) {
-            if (!isUnsupportedDownstreamElicitation(error))
-                throw error;
-            throw new Error(REMOTE_EMBEDDING_ELICITATION_UNSUPPORTED_MESSAGE, {
-                cause: error,
-            });
-        }
-    });
-}
-function isUnsupportedDownstreamElicitation(error) {
-    if (!(error instanceof Error))
-        return false;
-    const code = "code" in error ? error.code : undefined;
-    const message = error.message.toLowerCase();
-    return (code === ProtocolErrorCode.MethodNotFound ||
-        (code === SdkErrorCode.CapabilityNotSupported &&
-            message.includes("elicitation")) ||
-        message.includes("no handler is registered for 'elicitation/create'") ||
-        message.includes("method not found: no request handler configured"));
-}
-async function forwardRequest(peer, request, signal, meta, notify) {
-    const progressToken = meta?.progressToken;
-    const forwardedRequest = meta
-        ? {
-            ...request,
-            params: {
-                ...(request.params ?? {}),
-                _meta: meta,
-            },
-        }
-        : request;
-    return peer.request(forwardedRequest, ResultSchema, {
-        signal,
-        timeout: LONG_RUNNING_MCP_TIMEOUT_MS,
-        resetTimeoutOnProgress: true,
-        onprogress: progressToken === undefined || !notify
-            ? undefined
-            : (progress) => notify({
-                method: "notifications/progress",
-                params: { ...progress, progressToken },
-            }),
-    });
-}
-//# sourceMappingURL=stdio-bridge.js.map

package/dist/mcp/stdio-bridge.js.map

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

package/dist/mcp/tools.d.ts

@@ -1,153 +0,0 @@
-import { McpServer, type RequestStateCodec } from "@modelcontextprotocol/server";
-import type { FileScanDiagnostics, IndexProgress, ZvecGrepContextResult } from "../index.js";
-import { type NormalizedSearchInput } from "./input-normalization.js";
-import { type ZvecGrepIndexRequest, type ZvecGrepIndexDropInput, type ZvecGrepIndexStatusInput, type ZvecGrepRgInput, type ZvecGrepSearchIndexing } from "./schemas.js";
-import type { RemoteEmbeddingAuthorizationPlan, RemoteEmbeddingAuthorizationScope, RemoteEmbeddingOperationPermit } from "../authorization/types.js";
-import { type McpToolset } from "./toolset.js";
-import { type RemoteEmbeddingRequestStateReplayGuard, type RemoteEmbeddingRequestState } from "./request-state.js";
-export type IndexJobState = "queued" | "running" | "succeeded" | "failed" | "cancelled";
-export type ZvecGrepIndexError = {
-    code: string;
-    message: string;
-    context?: string;
-    cause?: string;
-};
-export type ZvecGrepIndexResult = {
-    root: string;
-    jobId: string;
-    state: IndexJobState;
-    reused: boolean;
-    action?: "index" | "drop";
-    dropped?: boolean;
-    error?: ZvecGrepIndexError;
-    scanDiagnostics?: FileScanDiagnostics;
-};
-export type ZvecGrepIndexDropResult = {
-    root: string;
-    removed: boolean;
-};
-export type ZvecGrepSearchResult = {
-    root: string;
-    freshness: "fresh" | "possibly_stale";
-    indexing?: ZvecGrepSearchIndexing;
-    result: ZvecGrepContextResult;
-};
-export type ZvecGrepIndexStatusResult = {
-    root: string;
-    indexed: boolean;
-    indexPolicy: "enabled" | "disabled" | "undecided";
-    source: "index" | "unindexed";
-    persistent: {
-        home: string;
-        index_path: string;
-        workspace_index?: {
-            id: string;
-            name: string;
-            path: string;
-            root_paths: Array<{
-                absolute_path: string;
-                recursive: boolean;
-                include?: string[];
-                exclude?: string[];
-                globs?: string[];
-                insensitive_globs?: string[];
-                file_types?: string[];
-                excluded_file_types?: string[];
-                hidden?: boolean;
-                no_ignore?: boolean;
-                ignore_files?: string[];
-                max_depth?: number;
-                max_file_size_bytes?: number;
-                follow?: boolean;
-            }>;
-            embedding?: {
-                provider: string;
-                model: string;
-                dimension: number;
-                metric: string;
-            } | null;
-            index_version?: number | null;
-            created_time: number;
-            updated_time: number;
-        };
-        files?: {
-            stored: number;
-            scanned?: number;
-            indexed: number;
-            pending: number;
-            failed: number;
-            added: number;
-            modified: number;
-            deleted: number;
-            unchanged: number;
-            entities: number;
-            truncated_fragments: number;
-        };
-        suggestion?: string;
-    };
-    runtime?: {
-        watcherActive: boolean;
-        dirtyRevision: number;
-        indexedRevision: number;
-        activeJobId?: string;
-        jobState?: IndexJobState;
-        progress?: {
-            phase: "scanning" | "indexing" | "done";
-            files_total?: number;
-            files_indexed?: number;
-            files_failed?: number;
-            detail?: string;
-        };
-        completion?: {
-            completed: number;
-            total: number;
-        };
-        error?: ZvecGrepIndexError;
-    };
-};
-export type ZvecGrepServerStatusResult = {
-    version: string;
-    uptimeMs: number;
-    shuttingDown: boolean;
-    activeRuntimes: number;
-    queuedJobs: number;
-    runningJobs: number;
-    models: {
-        loaded: number;
-        activeLeases: number;
-    };
-};
-export type ZvecGrepRgResult = {
-    root: string;
-    result: ZvecGrepContextResult;
-};
-export interface ZvecGrepDaemonBackend {
-    index(input: ZvecGrepIndexRequest, options?: {
-        authorization?: RemoteEmbeddingOperationPermit;
-        onProgress?: (progress: IndexProgress) => void;
-    }): Promise<ZvecGrepIndexResult>;
-    dropIndex(input: ZvecGrepIndexDropInput): Promise<ZvecGrepIndexDropResult>;
-    search(input: NormalizedSearchInput, options?: {
-        authorization?: RemoteEmbeddingOperationPermit;
-    }): Promise<ZvecGrepSearchResult>;
-    planIndexAuthorization?(input: ZvecGrepIndexRequest): Promise<RemoteEmbeddingAuthorizationPlan | undefined>;
-    planSearchAuthorization?(input: NormalizedSearchInput): Promise<RemoteEmbeddingAuthorizationPlan | undefined>;
-    existingRemoteEmbeddingPermit?(plan: RemoteEmbeddingAuthorizationPlan): Promise<RemoteEmbeddingOperationPermit | undefined>;
-    grantRemoteEmbedding?(plan: RemoteEmbeddingAuthorizationPlan, scope: RemoteEmbeddingAuthorizationScope): Promise<RemoteEmbeddingOperationPermit>;
-    indexStatus(input: ZvecGrepIndexStatusInput): Promise<ZvecGrepIndexStatusResult>;
-    rg(input: ZvecGrepRgInput): Promise<ZvecGrepRgResult>;
-    serverStatus(): Promise<ZvecGrepServerStatusResult>;
-}
-export declare const ZVEC_GREP_AGENT_MCP_INSTRUCTIONS: string;
-export declare const ZVEC_GREP_FULL_MCP_INSTRUCTIONS: string;
-export declare const ZVEC_GREP_MCP_INSTRUCTIONS: string;
-export type ZvecGrepMcpServerOptions = {
-    acceptEmbeddingEnvironmentMeta?: boolean;
-    /** Internal CLI transport only; public MCP search remains compact text. */
-    includeSearchStructuredContent?: boolean;
-    requestStateCodec?: RequestStateCodec<RemoteEmbeddingRequestState>;
-    requestStateReplayGuard?: RemoteEmbeddingRequestStateReplayGuard;
-    toolset?: McpToolset;
-};
-export declare function createZvecGrepMcpServer(backend: ZvecGrepDaemonBackend, version: string, options?: ZvecGrepMcpServerOptions): McpServer;
-export declare function registerZvecGrepTools(server: McpServer, backend: ZvecGrepDaemonBackend, options?: ZvecGrepMcpServerOptions): void;