import type { SourceMeta } from "./types";
/**
 * Canonical MCP server configuration.
 */
export interface MCPServer {
    /** Server name (unique key) */
    name: string;
    /** Whether this server is enabled (default: true) */
    enabled?: boolean;
    /** Whether explicit runtime MCP consumers should connect automatically (default: true) */
    autoload?: boolean;
    /** Connection timeout in milliseconds */
    /** MCP connection pool identity mode; defaults to one lease per session. */
    sharing?: "per-session" | "shared";
    timeout?: number;
    /**
     * Protocol preference for remote (http/sse) servers: `auto` (default) negotiates
     * MCP 2026-07-28 (stateless) first with a bounded observable legacy fallback,
     * `2026-07-28` is strict modern-only, `legacy` forces the compatibility handshake.
     */
    protocol?: "auto" | "2026-07-28" | "legacy";
    /** Command to run (for stdio transport) */
    command?: string;
    /** Command arguments */
    args?: string[];
    /** Environment variables */
    env?: Record<string, string>;
    /** Whether explicit stdio runtime consumers should avoid inheriting host environment */
    noInheritEnv?: boolean;
    /** Working directory for stdio transport */
    cwd?: string;
    /** URL (for HTTP/SSE transport) */
    url?: string;
    /** HTTP headers (for HTTP transport) */
    headers?: Record<string, string>;
    /** Authentication configuration */
    auth?: {
        type: "oauth" | "apikey";
        credentialId?: string;
        tokenUrl?: string;
        clientId?: string;
        clientSecret?: string;
    };
    /** OAuth configuration (clientId, clientSecret, redirectUri, callbackPort, callbackPath) for servers requiring explicit client credentials */
    oauth?: {
        clientId?: string;
        clientSecret?: string;
        redirectUri?: string;
        callbackPort?: number;
        callbackPath?: string;
    };
    /** Transport type */
    transport?: "stdio" | "sse" | "http";
    /** Source metadata (added by loader) */
    _source: SourceMeta;
}
export declare const mcpCapability: import("./types").Capability<MCPServer>;