@angri450/zvec-grep 0.2.2

package/dist/mcp/stdio-bridge.js

@@ -0,0 +1,190 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,153 @@
+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;