@pentoshi/clai 4.8.4 → 4.9.0

package/dist/mcp/transport-stdio.js

@@ -0,0 +1,268 @@
+import { spawn } from "node:child_process";
+import { supportsProcessGroups, terminateProcessTree, } from "../os/process-tree.js";
+import { encodeLine, LineDecoder, parseMessage } from "./jsonrpc.js";
+import { isAbortError, McpTransportError, withTimeout, } from "./transport.js";
+import { isJsonRpcResponse } from "./jsonrpc.js";
+const DEFAULT_REQUEST_TIMEOUT_MS = 60_000;
+const DEFAULT_CLOSE_GRACE_MS = 2_000;
+const MAX_STDERR_BYTES = 64 * 1024;
+export class StdioTransport {
+    config;
+    options;
+    kind = "stdio";
+    child;
+    decoder = new LineDecoder();
+    pending = new Map();
+    nextId = 1;
+    closed = false;
+    exited = false;
+    stderrTail = "";
+    processGroupId;
+    protocolVersion;
+    startPromise;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.options = options;
+    }
+    sessionId() {
+        return undefined;
+    }
+    setProtocolVersion(version) {
+        this.protocolVersion = version;
+    }
+    start() {
+        if (this.startPromise)
+            return this.startPromise;
+        this.startPromise = this.spawnChild();
+        return this.startPromise;
+    }
+    buildEnv() {
+        const base = this.options.baseEnv ?? process.env;
+        const merged = {};
+        for (const [key, value] of Object.entries(base)) {
+            if (typeof value === "string")
+                merged[key] = value;
+        }
+        for (const [key, value] of Object.entries(this.config.env)) {
+            merged[key] = value;
+        }
+        return merged;
+    }
+    spawnChild() {
+        return new Promise((resolve, reject) => {
+            let child;
+            try {
+                child = spawn(this.config.command, [...this.config.args], {
+                    shell: false,
+                    stdio: ["pipe", "pipe", "pipe"],
+                    env: this.buildEnv(),
+                    detached: supportsProcessGroups(),
+                    windowsHide: true,
+                    ...(this.config.cwd !== undefined ? { cwd: this.config.cwd } : {}),
+                });
+            }
+            catch (error) {
+                reject(new McpTransportError("spawn", `Failed to spawn MCP server "${this.config.command}": ${error.message}`));
+                return;
+            }
+            this.child = child;
+            this.processGroupId = supportsProcessGroups() ? child.pid : undefined;
+            let settled = false;
+            const onSpawn = () => {
+                if (settled)
+                    return;
+                settled = true;
+                child.off("error", onError);
+                resolve();
+            };
+            const onError = (error) => {
+                if (settled) {
+                    this.failAll(new McpTransportError("network", error.message));
+                    return;
+                }
+                settled = true;
+                child.off("spawn", onSpawn);
+                reject(new McpTransportError("spawn", `MCP server "${this.config.command}" failed to start: ${error.message}`));
+            };
+            child.once("spawn", onSpawn);
+            child.once("error", onError);
+            child.stdout.setEncoding("utf8");
+            child.stdout.on("data", (chunk) => this.onStdout(chunk));
+            child.stderr.setEncoding("utf8");
+            child.stderr.on("data", (chunk) => this.onStderr(chunk));
+            child.stdin.on("error", () => undefined);
+            child.on("exit", () => {
+                this.exited = true;
+                this.failAll(new McpTransportError("closed", this.stderrTail.trim().length > 0
+                    ? `MCP server exited: ${this.stderrTail.trim().slice(-400)}`
+                    : "MCP server process exited."));
+            });
+        });
+    }
+    onStdout(chunk) {
+        let lines;
+        try {
+            lines = this.decoder.push(chunk);
+        }
+        catch (error) {
+            const failure = error instanceof McpTransportError
+                ? error
+                : new McpTransportError("protocol", `MCP stdio framing error: ${error.message}`);
+            this.failAll(failure);
+            void this.close();
+            return;
+        }
+        for (const line of lines) {
+            const message = parseMessage(line);
+            if (!message || !isJsonRpcResponse(message))
+                continue;
+            const numericId = typeof message.id === "number" ? message.id : Number(message.id);
+            if (!Number.isFinite(numericId))
+                continue;
+            const entry = this.pending.get(numericId);
+            if (!entry)
+                continue;
+            this.pending.delete(numericId);
+            entry.dispose();
+            entry.resolve(message);
+        }
+    }
+    onStderr(chunk) {
+        this.stderrTail = (this.stderrTail + chunk).slice(-MAX_STDERR_BYTES);
+    }
+    failAll(error) {
+        for (const [, entry] of this.pending) {
+            entry.dispose();
+            entry.reject(error);
+        }
+        this.pending.clear();
+    }
+    async request(message, options = {}) {
+        await this.start();
+        if (this.closed || this.exited || !this.child) {
+            throw new McpTransportError("closed", "MCP stdio transport is not connected.");
+        }
+        const id = this.nextId++;
+        const framed = { ...message, id };
+        const timeoutMs = options.timeoutMs ?? this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        const { signal, dispose } = withTimeout(options.signal, timeoutMs);
+        return await new Promise((resolve, reject) => {
+            const onAbort = () => {
+                const entry = this.pending.get(id);
+                if (entry) {
+                    this.pending.delete(id);
+                    entry.dispose();
+                }
+                const reason = signal.reason;
+                if (reason instanceof McpTransportError)
+                    reject(reason);
+                else
+                    reject(new McpTransportError("cancelled", "MCP request cancelled."));
+            };
+            const disposeEntry = () => {
+                dispose();
+                signal.removeEventListener("abort", onAbort);
+            };
+            if (signal.aborted) {
+                disposeEntry();
+                onAbort();
+                return;
+            }
+            signal.addEventListener("abort", onAbort, { once: true });
+            this.pending.set(id, { resolve, reject, dispose: disposeEntry });
+            try {
+                this.child.stdin.write(encodeLine(framed));
+            }
+            catch (error) {
+                this.pending.delete(id);
+                disposeEntry();
+                reject(new McpTransportError("network", `Failed to write MCP request: ${error.message}`));
+            }
+        });
+    }
+    async notify(message) {
+        await this.start();
+        if (this.closed || this.exited || !this.child) {
+            throw new McpTransportError("closed", "MCP stdio transport is not connected.");
+        }
+        this.child.stdin.write(encodeLine(message));
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const child = this.child;
+        this.failAll(new McpTransportError("closed", "MCP stdio transport closed."));
+        if (!child || this.exited) {
+            this.disposeChild();
+            return;
+        }
+        try {
+            child.stdin.end();
+        }
+        catch {
+            void 0;
+        }
+        const graceMs = this.options.closeGraceMs ?? DEFAULT_CLOSE_GRACE_MS;
+        const exitedGracefully = await this.waitForExit(child, graceMs, "SIGTERM");
+        if (!exitedGracefully) {
+            this.forceKill(child);
+            await this.waitForExit(child, graceMs, undefined);
+        }
+        this.disposeChild();
+    }
+    waitForExit(child, graceMs, signal) {
+        if (this.exited || child.exitCode !== null || child.signalCode !== null) {
+            return Promise.resolve(true);
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                child.off("exit", onExit);
+                resolve(false);
+            }, graceMs);
+            if (typeof timer.unref === "function")
+                timer.unref();
+            const onExit = () => {
+                clearTimeout(timer);
+                resolve(true);
+            };
+            child.once("exit", onExit);
+            if (signal && child.pid) {
+                terminateProcessTree(child.pid, {
+                    signal,
+                    ...(this.processGroupId !== undefined ? { processGroupId: this.processGroupId } : {}),
+                });
+            }
+        });
+    }
+    forceKill(child) {
+        if (!child.pid)
+            return;
+        terminateProcessTree(child.pid, {
+            signal: "SIGKILL",
+            ...(this.processGroupId !== undefined ? { processGroupId: this.processGroupId } : {}),
+        });
+    }
+    disposeChild() {
+        const child = this.child;
+        if (!child)
+            return;
+        try {
+            child.stdin.destroy();
+            child.stdout.destroy();
+            child.stderr.destroy();
+        }
+        catch {
+            void 0;
+        }
+        child.removeAllListeners();
+        this.child = undefined;
+    }
+    diagnostics() {
+        return this.stderrTail.trim();
+    }
+}
+export function isTransportAbort(error) {
+    return isAbortError(error);
+}
+//# sourceMappingURL=transport-stdio.js.map

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

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

package/dist/mcp/transport.d.ts

@@ -0,0 +1,20 @@
+import type { JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, McpRequestOptions } from "./types.js";
+export type McpTransportFailureKind = "spawn" | "timeout" | "cancelled" | "closed" | "protocol" | "network" | "too-large";
+export declare class McpTransportError extends Error {
+    readonly kind: McpTransportFailureKind;
+    constructor(kind: McpTransportFailureKind, message: string);
+}
+export interface McpTransport {
+    readonly kind: "stdio" | "http" | "sse";
+    start(options?: McpRequestOptions): Promise<void>;
+    request(message: JsonRpcRequest, options?: McpRequestOptions): Promise<JsonRpcResponse>;
+    notify(message: JsonRpcNotification, options?: McpRequestOptions): Promise<void>;
+    close(): Promise<void>;
+    sessionId(): string | undefined;
+    setProtocolVersion(version: string): void;
+}
+export declare function isAbortError(error: unknown): boolean;
+export declare function withTimeout(parent: AbortSignal | undefined, timeoutMs: number | undefined): {
+    signal: AbortSignal;
+    dispose: () => void;
+};

package/dist/mcp/transport.js

@@ -0,0 +1,44 @@
+export class McpTransportError extends Error {
+    kind;
+    constructor(kind, message) {
+        super(message);
+        this.name = "McpTransportError";
+        this.kind = kind;
+    }
+}
+export function isAbortError(error) {
+    if (error instanceof McpTransportError)
+        return error.kind === "cancelled";
+    if (typeof error !== "object" || error === null)
+        return false;
+    const name = error.name;
+    return name === "AbortError";
+}
+export function withTimeout(parent, timeoutMs) {
+    const controller = new AbortController();
+    const dispose = () => {
+        if (timer)
+            clearTimeout(timer);
+        if (parent)
+            parent.removeEventListener("abort", onParentAbort);
+    };
+    const onParentAbort = () => {
+        controller.abort(parent?.reason);
+    };
+    let timer;
+    if (parent) {
+        if (parent.aborted)
+            controller.abort(parent.reason);
+        else
+            parent.addEventListener("abort", onParentAbort, { once: true });
+    }
+    if (timeoutMs !== undefined && timeoutMs > 0) {
+        timer = setTimeout(() => {
+            controller.abort(new McpTransportError("timeout", `Request timed out after ${timeoutMs}ms.`));
+        }, timeoutMs);
+        if (typeof timer.unref === "function")
+            timer.unref();
+    }
+    return { signal: controller.signal, dispose };
+}
+//# sourceMappingURL=transport.js.map

package/dist/mcp/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/mcp/transport.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAA0B;IACvC,YAAY,IAA6B,EAAE,OAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAeD,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,iBAAiB;QAAE,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,IAAI,KAAK,YAAY,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,MAA+B,EAC/B,SAA6B;IAE7B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM;YAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACjE,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,IAAI,KAAgD,CAAC;IACrD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,OAAO;YAAE,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;;YAC/C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAC7C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,UAAU,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,SAAS,EAAE,2BAA2B,SAAS,KAAK,CAAC,CAAC,CAAC;QAChG,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,179 @@
+import type { ChatImage, JsonSchemaObject, RiskLevel } from "../types.js";
+export declare const MCP_PROTOCOL_VERSION: "2025-06-18";
+export declare const MCP_SUPPORTED_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
+export declare const MCP_CLIENT_NAME: "clai";
+export type McpTransportKind = "stdio" | "http" | "sse";
+export interface McpStdioConfig {
+    readonly transport: "stdio";
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly cwd?: string | undefined;
+}
+export interface McpHttpConfig {
+    readonly transport: "http" | "sse";
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+}
+export type McpServerConfig = McpStdioConfig | McpHttpConfig;
+export type McpToolSelection = "all" | readonly string[];
+export type McpConfigSourceKind = "clai-env" | "clai-project" | "mcp-project" | "github-project" | "vscode-project" | "clai-user" | "copilot-user" | "claude-user" | "vscode-user";
+export declare const MCP_SOURCE_PRECEDENCE: readonly McpConfigSourceKind[];
+export declare const MCP_SOURCE_LABELS: Readonly<Record<McpConfigSourceKind, string>>;
+export interface McpConfigSource {
+    readonly kind: McpConfigSourceKind;
+    readonly path: string;
+    readonly rank: number;
+    readonly depth?: number | undefined;
+}
+export interface McpInputDefinition {
+    readonly id: string;
+    readonly type?: string | undefined;
+    readonly description?: string | undefined;
+    readonly default?: string | undefined;
+    readonly password?: boolean | undefined;
+}
+export interface McpServerDefinition {
+    readonly name: string;
+    readonly config: McpServerConfig;
+    readonly disabled: boolean;
+    readonly toolSelection: McpToolSelection;
+    readonly source: McpConfigSource;
+    readonly signature: string;
+    readonly secretValues: readonly string[];
+}
+export interface McpShadowedServer {
+    readonly name: string;
+    readonly source: McpConfigSource;
+    readonly shadowedBy: McpConfigSource;
+}
+export interface McpInvalidServer {
+    readonly name: string;
+    readonly source: McpConfigSource;
+    readonly errors: readonly string[];
+}
+export interface McpDiscoveryResult {
+    readonly servers: readonly McpServerDefinition[];
+    readonly shadowed: readonly McpShadowedServer[];
+    readonly invalid: readonly McpInvalidServer[];
+    readonly sources: readonly McpConfigSource[];
+    readonly warnings: readonly string[];
+}
+export interface McpDiscoveryOptions {
+    readonly workspaceFolder?: string | undefined;
+    readonly homeDir?: string | undefined;
+    readonly env?: Readonly<Record<string, string | undefined>> | undefined;
+    readonly platform?: NodeJS.Platform | undefined;
+}
+export type JsonRpcId = number | string;
+export interface JsonRpcRequest {
+    readonly jsonrpc: "2.0";
+    readonly id: JsonRpcId;
+    readonly method: string;
+    readonly params?: unknown;
+}
+export interface JsonRpcNotification {
+    readonly jsonrpc: "2.0";
+    readonly method: string;
+    readonly params?: unknown;
+}
+export interface JsonRpcErrorPayload {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+}
+export interface JsonRpcSuccess {
+    readonly jsonrpc: "2.0";
+    readonly id: JsonRpcId;
+    readonly result: unknown;
+}
+export interface JsonRpcFailure {
+    readonly jsonrpc: "2.0";
+    readonly id: JsonRpcId | null;
+    readonly error: JsonRpcErrorPayload;
+}
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcFailure;
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+export interface McpServerInfo {
+    readonly name: string;
+    readonly version: string;
+}
+export interface McpInitializeResult {
+    readonly protocolVersion: string;
+    readonly capabilities: Readonly<Record<string, unknown>>;
+    readonly serverInfo?: McpServerInfo | undefined;
+    readonly instructions?: string | undefined;
+}
+export interface McpToolAnnotations {
+    readonly title?: string | undefined;
+    readonly readOnlyHint?: boolean | undefined;
+    readonly destructiveHint?: boolean | undefined;
+    readonly idempotentHint?: boolean | undefined;
+    readonly openWorldHint?: boolean | undefined;
+}
+export interface McpToolDescriptor {
+    readonly name: string;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly inputSchema?: Readonly<Record<string, unknown>> | undefined;
+    readonly annotations?: McpToolAnnotations | undefined;
+}
+export interface McpToolMetadata {
+    readonly canonicalName: string;
+    readonly wireName: string;
+    readonly serverName: string;
+    readonly toolName: string;
+    readonly title?: string | undefined;
+    readonly description: string;
+    readonly inputSchema: JsonSchemaObject;
+    readonly risk: RiskLevel;
+    readonly readOnly: boolean;
+    readonly destructive: boolean;
+    readonly idempotent: boolean;
+    readonly openWorld: boolean;
+    readonly annotations: McpToolAnnotations;
+}
+export interface McpNormalizedImage {
+    readonly mediaType: string;
+    readonly dataBase64: string;
+}
+export interface McpNormalizedResource {
+    readonly uri: string;
+    readonly mimeType?: string | undefined;
+    readonly text?: string | undefined;
+    readonly blobBase64?: string | undefined;
+}
+export interface McpNormalizedResult {
+    readonly ok: boolean;
+    readonly isError: boolean;
+    readonly text: string;
+    readonly images: readonly McpNormalizedImage[];
+    readonly resources: readonly McpNormalizedResource[];
+    readonly chatImages: readonly ChatImage[];
+    readonly raw: unknown;
+}
+export type McpServerStatusKind = "ready" | "degraded" | "disabled" | "error" | "connecting";
+export interface McpServerStatus {
+    readonly name: string;
+    readonly status: McpServerStatusKind;
+    readonly transport: McpTransportKind;
+    readonly source: McpConfigSource;
+    readonly toolCount: number;
+    readonly signature: string;
+    readonly detail?: string | undefined;
+    readonly serverInfo?: McpServerInfo | undefined;
+    readonly protocolVersion?: string | undefined;
+}
+export interface McpSnapshot {
+    readonly createdAt: number;
+    readonly statuses: readonly McpServerStatus[];
+    readonly tools: readonly McpToolMetadata[];
+    readonly toolsByCanonicalName: ReadonlyMap<string, McpToolMetadata>;
+    readonly toolsByWireName: ReadonlyMap<string, McpToolMetadata>;
+    readonly shadowed: readonly McpShadowedServer[];
+    readonly invalid: readonly McpInvalidServer[];
+}
+export interface McpRequestOptions {
+    readonly signal?: AbortSignal | undefined;
+    readonly timeoutMs?: number | undefined;
+}

package/dist/mcp/types.js

@@ -0,0 +1,30 @@
+export const MCP_PROTOCOL_VERSION = "2025-06-18";
+export const MCP_SUPPORTED_PROTOCOL_VERSIONS = [
+    "2025-06-18",
+    "2025-03-26",
+    "2024-11-05",
+];
+export const MCP_CLIENT_NAME = "clai";
+export const MCP_SOURCE_PRECEDENCE = [
+    "clai-env",
+    "clai-project",
+    "mcp-project",
+    "github-project",
+    "vscode-project",
+    "clai-user",
+    "copilot-user",
+    "claude-user",
+    "vscode-user",
+];
+export const MCP_SOURCE_LABELS = {
+    "clai-env": "CLAI_MCP_CONFIG",
+    "clai-project": ".clai/mcp.json (project)",
+    "mcp-project": ".mcp.json (project)",
+    "github-project": ".github/mcp.json (repo)",
+    "vscode-project": ".vscode/mcp.json (VS Code compatibility)",
+    "clai-user": "clai user MCP config",
+    "copilot-user": "~/.copilot/mcp-config.json (user)",
+    "claude-user": "Claude user config",
+    "vscode-user": "VS Code user config (compatibility)",
+};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAqB,CAAC;AAE1D,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,YAAY;IACZ,YAAY;IACZ,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG,MAAe,CAAC;AAiC/C,MAAM,CAAC,MAAM,qBAAqB,GAAmC;IACnE,UAAU;IACV,cAAc;IACd,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,WAAW;IACX,cAAc;IACd,aAAa;IACb,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAkD;IAC9E,UAAU,EAAE,iBAAiB;IAC7B,cAAc,EAAE,0BAA0B;IAC1C,aAAa,EAAE,qBAAqB;IACpC,gBAAgB,EAAE,yBAAyB;IAC3C,gBAAgB,EAAE,0CAA0C;IAC5D,WAAW,EAAE,sBAAsB;IACnC,cAAc,EAAE,mCAAmC;IACnD,aAAa,EAAE,oBAAoB;IACnC,aAAa,EAAE,qCAAqC;CAC5C,CAAC"}

package/dist/mcp/validation.d.ts

@@ -0,0 +1,16 @@
+import { type McpSubstitutionContext } from "./substitution.js";
+import type { McpServerConfig, McpToolSelection } from "./types.js";
+export interface ValidatedServer {
+    readonly config: McpServerConfig;
+    readonly disabled: boolean;
+    readonly toolSelection: McpToolSelection;
+    readonly secretValues: readonly string[];
+}
+export type ServerValidation = {
+    readonly ok: true;
+    readonly server: ValidatedServer;
+} | {
+    readonly ok: false;
+    readonly errors: readonly string[];
+};
+export declare function validateServerEntry(name: string, rawEntry: unknown, context: McpSubstitutionContext): ServerValidation;