@sayknow-cli/coding-agent 0.3.13 → 0.3.16

package/dist/types/runtime-mcp/manager.d.ts

@@ -0,0 +1,195 @@
+import type { TSchema } from "@sayknow-cli/ai";
+import type { SourceMeta } from "../capability/types";
+import type { CustomTool } from "../extensibility/custom-tools/types";
+import type { AuthStorage } from "../session/auth-storage";
+import type { MCPToolDetails } from "./tool-bridge";
+import type { MCPToolCache } from "./tool-cache";
+import type { MCPGetPromptResult, MCPPrompt, MCPRequestOptions, MCPResource, MCPResourceReadResult, MCPResourceTemplate, MCPServerConfig, MCPServerConnection } from "./types";
+/**
+ * Stable, total ordering on MCP tools by name.
+ *
+ * Anthropic prompt caching keys on byte-identical tool definitions: any reorder
+ * of the tools array invalidates the tools cache breakpoint and forces a full
+ * prefix rebuild on the next request. MCP servers connect/reconnect at arbitrary
+ * times, so the natural "insertion order" of `#tools` is non-deterministic.
+ * Sorting after every mutation makes the array bytes independent of connection
+ * sequence.
+ */
+export declare function sortMCPToolsByName<T extends {
+    name: string;
+}>(tools: T[]): T[];
+export declare function resolveSubscriptionPostAction(notificationsEnabled: boolean, currentEpoch: number, subscriptionEpoch: number): "rollback" | "ignore" | "apply";
+/** Result of loading MCP tools */
+export interface MCPLoadResult {
+    /** Loaded tools as CustomTool instances */
+    tools: CustomTool<TSchema, MCPToolDetails>[];
+    /** Connection errors by server name */
+    errors: Map<string, string>;
+    /** Connected server names */
+    connectedServers: string[];
+    /** Extracted Exa API keys from filtered MCP servers */
+    exaApiKeys: string[];
+}
+/** Options for discovering and connecting to MCP servers */
+export interface MCPDiscoverOptions {
+    /** Whether to load project-level config (default: true) */
+    enableProjectConfig?: boolean;
+    /** Whether to filter out Exa MCP servers (default: true) */
+    filterExa?: boolean;
+    /** Whether to filter out browser MCP servers when builtin browser tool is enabled (default: false) */
+    filterBrowser?: boolean;
+    /** Only connect servers with autoload !== false (default: false) */
+    autoloadOnly?: boolean;
+    /** Called when starting to connect to servers */
+    onConnecting?: (serverNames: string[]) => void;
+}
+/**
+ * MCP Server Manager.
+ *
+ * Manages connections to MCP servers and provides tools to the agent.
+ */
+export declare class MCPManager {
+    #private;
+    private cwd;
+    private toolCache;
+    /** Process-global instance shared by internal URL protocol handlers and tools. */
+    static instance(): MCPManager | undefined;
+    /** Install or clear the process-global instance. */
+    static setInstance(value: MCPManager | undefined): void;
+    /** Reset the process-global instance. Test-only. */
+    static resetForTests(): void;
+    constructor(cwd: string, toolCache?: MCPToolCache | null);
+    /**
+     * Set a callback to receive all server notifications.
+     */
+    setOnNotification(handler: (serverName: string, method: string, params: unknown) => void): void;
+    /**
+     * Set a callback to fire when any server's tools change.
+     */
+    setOnToolsChanged(handler: (tools: CustomTool<TSchema, MCPToolDetails>[]) => void): void;
+    /**
+     * Set a callback to fire when any server's resources change.
+     */
+    setOnResourcesChanged(handler: (serverName: string, uri: string) => void): void;
+    /**
+     * Set a callback to fire when any server's prompts change.
+     */
+    setOnPromptsChanged(handler: (serverName: string) => void): void;
+    setNotificationsEnabled(enabled: boolean): void;
+    /**
+     * Set the auth storage for resolving OAuth credentials.
+     */
+    setAuthStorage(authStorage: AuthStorage): void;
+    /**
+     * Discover and connect to all MCP servers from .mcp.json files.
+     * Returns tools and any connection errors.
+     */
+    discoverAndConnect(options?: MCPDiscoverOptions): Promise<MCPLoadResult>;
+    /**
+     * Connect to specific MCP servers.
+     * Connections are made in parallel for faster startup.
+     */
+    connectServers(configs: Record<string, MCPServerConfig>, sources: Record<string, SourceMeta>, onConnecting?: (serverNames: string[]) => void): Promise<MCPLoadResult>;
+    /**
+     * Get all loaded tools.
+     */
+    getTools(): CustomTool<TSchema, MCPToolDetails>[];
+    /**
+     * Get a specific connection.
+     */
+    getConnection(name: string): MCPServerConnection | undefined;
+    /**
+     * Get current connection status for a server.
+     */
+    getConnectionStatus(name: string): "connected" | "connecting" | "disconnected";
+    /**
+     * Get the source metadata for a server.
+     */
+    getSource(name: string): SourceMeta | undefined;
+    /**
+     * Wait for a connection to complete (or fail).
+     */
+    waitForConnection(name: string): Promise<MCPServerConnection>;
+    /**
+     * Resolve auth and shell-command substitutions in config before connecting.
+     */
+    prepareConfig(config: MCPServerConfig): Promise<MCPServerConfig>;
+    /**
+     * Get all connected server names.
+     */
+    getConnectedServers(): string[];
+    /**
+     * Get all known server names (connected, connecting, or discovered).
+     */
+    getAllServerNames(): string[];
+    /**
+     * Disconnect from a specific server.
+     */
+    disconnectServer(name: string): Promise<void>;
+    /**
+     * Disconnect from all servers.
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Reconnect to a server after a connection failure.
+     * Tears down the stale connection, re-resolves auth, establishes a new
+     * connection, reloads tools, and notifies consumers.
+     * Concurrent calls for the same server share one reconnection attempt.
+     * Returns the new connection, or null if reconnection failed.
+     */
+    reconnectServer(name: string): Promise<MCPServerConnection | null>;
+    /**
+     * Refresh tools from a specific server.
+     */
+    refreshServerTools(name: string): Promise<void>;
+    /**
+     * Refresh tools from all servers.
+     */
+    refreshAllTools(): Promise<void>;
+    /**
+     * Refresh resources from a specific server.
+     */
+    refreshServerResources(name: string): Promise<void>;
+    /**
+     * Refresh prompts from a specific server.
+     */
+    refreshServerPrompts(name: string): Promise<void>;
+    /**
+     * Get resources and templates for a specific server.
+     */
+    getServerResources(name: string): {
+        resources: MCPResource[];
+        templates: MCPResourceTemplate[];
+    } | undefined;
+    /**
+     * Read a specific resource from a server.
+     */
+    readServerResource(name: string, uri: string, options?: MCPRequestOptions): Promise<MCPResourceReadResult | undefined>;
+    /**
+     * Get prompts for a specific server.
+     */
+    getServerPrompts(name: string): MCPPrompt[] | undefined;
+    /**
+     * Get a specific prompt from a server.
+     */
+    executePrompt(name: string, promptName: string, args?: Record<string, string>, options?: MCPRequestOptions): Promise<MCPGetPromptResult | undefined>;
+    /**
+     * Get all server instructions (for system prompt injection).
+     */
+    getServerInstructions(): Map<string, string>;
+    /**
+     * Get notification state for display.
+     */
+    getNotificationState(): {
+        enabled: boolean;
+        subscriptions: Map<string, ReadonlySet<string>>;
+    };
+}
+/**
+ * Create an MCP manager and discover servers.
+ * Convenience function for quick setup.
+ */
+export declare function createMCPManager(cwd: string, options?: MCPDiscoverOptions): Promise<{
+    manager: MCPManager;
+    result: MCPLoadResult;
+}>;

package/dist/types/runtime-mcp/oauth-discovery.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MCP OAuth Auto-Discovery
+ *
+ * Automatically detects OAuth requirements from MCP server responses
+ * and extracts authentication endpoints.
+ */
+export interface OAuthEndpoints {
+    authorizationUrl: string;
+    tokenUrl: string;
+    clientId?: string;
+    scopes?: string;
+}
+export interface AuthDetectionResult {
+    requiresAuth: boolean;
+    authType?: "oauth" | "apikey" | "unknown";
+    oauth?: OAuthEndpoints;
+    authServerUrl?: string;
+    message?: string;
+}
+export declare function extractMcpAuthServerUrl(error: Error): string | undefined;
+/**
+ * Detect if an error indicates authentication is required.
+ * Checks for common auth error patterns.
+ */
+export declare function detectAuthError(error: Error): boolean;
+/**
+ * Extract OAuth endpoints from error response.
+ * Looks for WWW-Authenticate header format or JSON error bodies.
+ */
+export declare function extractOAuthEndpoints(error: Error): OAuthEndpoints | null;
+/**
+ * Analyze an error to determine authentication requirements.
+ * Returns structured info about what auth is needed.
+ */
+export declare function analyzeAuthError(error: Error): AuthDetectionResult;
+/**
+ * Try to discover OAuth endpoints by querying the server's well-known endpoints.
+ * This is a fallback when error responses don't include OAuth metadata.
+ */
+export declare function discoverOAuthEndpoints(serverUrl: string, authServerUrl?: string): Promise<OAuthEndpoints | null>;

package/dist/types/runtime-mcp/oauth-flow.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Generic OAuth flow for MCP servers.
+ *
+ * Allows users to authenticate with any OAuth-compatible MCP server
+ * by providing authorization URL, token URL, and client credentials.
+ */
+import { OAuthCallbackFlow } from "@sayknow-cli/ai/utils/oauth/callback-server";
+import type { OAuthController, OAuthCredentials } from "@sayknow-cli/ai/utils/oauth/types";
+export interface MCPOAuthConfig {
+    /** Authorization endpoint URL */
+    authorizationUrl: string;
+    /** Token endpoint URL */
+    tokenUrl: string;
+    /** Client ID (optional when already embedded in authorization URL) */
+    clientId?: string;
+    /** Client secret (optional for PKCE flows) */
+    clientSecret?: string;
+    /** OAuth scopes (space-separated) */
+    scopes?: string;
+    /** Exact redirect URI to advertise to the provider */
+    redirectUri?: string;
+    /** Custom callback port (default: 3000) */
+    callbackPort?: number;
+    /** Custom callback path (default: /callback or redirectUri pathname) */
+    callbackPath?: string;
+}
+/**
+ * Generic OAuth flow for MCP servers.
+ * Supports standard OAuth 2.0 authorization code flow with PKCE.
+ */
+export declare class MCPOAuthFlow extends OAuthCallbackFlow {
+    #private;
+    private config;
+    constructor(config: MCPOAuthConfig, ctrl: OAuthController);
+    /**
+     * Client id used during the authorization request. Returns the value supplied
+     * via {@link MCPOAuthConfig.clientId} or, when the server required dynamic
+     * client registration, the id issued during registration. `undefined` until
+     * {@link generateAuthUrl} (or {@link login}) has run for a server that needs
+     * a client id.
+     */
+    get resolvedClientId(): string | undefined;
+    /**
+     * Client secret issued by dynamic client registration, if any. Always
+     * `undefined` for PKCE-only/public clients and when the caller supplies the
+     * client id via config.
+     */
+    get registeredClientSecret(): string | undefined;
+    generateAuthUrl(state: string, redirectUri: string): Promise<{
+        url: string;
+        instructions?: string;
+    }>;
+    exchangeToken(code: string, _state: string, redirectUri: string): Promise<OAuthCredentials>;
+}
+/**
+ * Refresh an MCP OAuth token using the standard refresh_token grant.
+ * Returns updated credentials; preserves the old refresh token if the server doesn't rotate it.
+ */
+export declare function refreshMCPOAuthToken(tokenUrl: string, refreshToken: string, clientId?: string, clientSecret?: string): Promise<OAuthCredentials>;

package/dist/types/runtime-mcp/render.d.ts

@@ -0,0 +1,25 @@
+/**
+ * TUI rendering for MCP tools.
+ *
+ * Provides structured display of MCP tool calls and results,
+ * showing args and output in JSON tree format similar to task tool.
+ */
+import type { Component } from "@sayknow-cli/tui";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types";
+import type { Theme } from "../modes/theme/theme";
+import type { MCPToolDetails } from "./tool-bridge";
+/**
+ * Render MCP tool call.
+ */
+export declare function renderMCPCall(args: Record<string, unknown>, theme: Theme, label: string): Component;
+/**
+ * Render MCP tool result.
+ */
+export declare function renderMCPResult(result: {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    details?: MCPToolDetails;
+    isError?: boolean;
+}, options: RenderResultOptions, theme: Theme, args?: Record<string, unknown>): Component;

package/dist/types/runtime-mcp/smithery-auth.d.ts

@@ -0,0 +1,16 @@
+type SmitheryCliAuthSession = {
+    sessionId: string;
+    authUrl: string;
+};
+type SmitheryCliPollResponse = {
+    status: "pending" | "success" | "error";
+    apiKey?: string;
+    message?: string;
+};
+export declare function getSmitheryLoginUrl(): string;
+export declare function createSmitheryCliAuthSession(): Promise<SmitheryCliAuthSession>;
+export declare function pollSmitheryCliAuthSession(sessionId: string, signal?: AbortSignal): Promise<SmitheryCliPollResponse>;
+export declare function getSmitheryApiKey(): Promise<string | undefined>;
+export declare function saveSmitheryApiKey(apiKey: string): Promise<void>;
+export declare function clearSmitheryApiKey(): Promise<boolean>;
+export {};

package/dist/types/runtime-mcp/smithery-connect.d.ts

@@ -0,0 +1,38 @@
+export declare class SmitheryConnectError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+type SmitheryNamespace = {
+    name: string;
+};
+type SmitheryConnectionStatus = {
+    state: "connected";
+} | {
+    state: "auth_required";
+    authorizationUrl?: string;
+} | {
+    state: "error";
+    message: string;
+} | {
+    state: string;
+    [key: string]: unknown;
+};
+export type SmitheryConnection = {
+    connectionId: string;
+    mcpUrl: string;
+    name: string;
+    status?: SmitheryConnectionStatus;
+    createdAt?: string;
+};
+export declare function getSmitheryApiBaseUrl(): string;
+export declare function listSmitheryNamespaces(apiKey: string): Promise<SmitheryNamespace[]>;
+export declare function createSmitheryNamespace(apiKey: string): Promise<SmitheryNamespace>;
+export declare function resolveSmitheryNamespace(apiKey: string): Promise<string>;
+export declare function listSmitheryConnectionsByUrl(apiKey: string, namespace: string, mcpUrl: string): Promise<SmitheryConnection[]>;
+export declare function createSmitheryConnection(apiKey: string, namespace: string, params: {
+    mcpUrl: string;
+    name?: string;
+}): Promise<SmitheryConnection>;
+export declare function getSmitheryConnection(apiKey: string, namespace: string, connectionId: string): Promise<SmitheryConnection>;
+export declare function deleteSmitheryConnection(apiKey: string, namespace: string, connectionId: string): Promise<void>;
+export {};

package/dist/types/runtime-mcp/smithery-registry.d.ts

@@ -0,0 +1,51 @@
+import type { MCPServerConfig } from "./types";
+type RegistryInputType = "string" | "number" | "boolean";
+export type SmitherySearchResult = {
+    id: string;
+    name: string;
+    title?: string;
+    description?: string;
+    score?: number;
+    useCount?: number;
+    display: {
+        displayName: string;
+        description: string;
+        useCount: number;
+        verified: boolean;
+        deployed: boolean;
+        transport: string;
+        connectionType: string;
+        createdAt?: string;
+        homepage?: string;
+        tools: Array<{
+            name: string;
+            description?: string;
+            params: string[];
+        }>;
+    };
+    sourceType: "remote" | "package";
+    config: MCPServerConfig;
+    warnings: string[];
+    requiredInputs: Array<{
+        key: string;
+        label: string;
+        type: RegistryInputType;
+        required: boolean;
+        defaultValue?: string;
+        description?: string;
+        enumValues?: string[];
+        sensitive: boolean;
+    }>;
+};
+export interface SmitherySearchOptions {
+    limit?: number;
+    apiKey?: string;
+    includeSemantic?: boolean;
+}
+export declare class SmitheryRegistryError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare function searchSmitheryRegistry(keyword: string, options?: SmitherySearchOptions): Promise<SmitherySearchResult[]>;
+export declare function toConfigName(candidate: string): string;
+export {};

package/dist/types/runtime-mcp/tool-bridge.d.ts

@@ -0,0 +1,86 @@
+/**
+ * MCP to CustomTool bridge.
+ *
+ * Converts MCP tool definitions to CustomTool format for the agent.
+ */
+import type { AgentToolUpdateCallback } from "@sayknow-cli/agent-core";
+import type { TSchema } from "@sayknow-cli/ai";
+import type { SourceMeta } from "../capability/types";
+import type { CustomTool, CustomToolContext, CustomToolResult, RenderResultOptions } from "../extensibility/custom-tools/types";
+import type { Theme } from "../modes/theme/theme";
+import type { MCPContent, MCPServerConnection, MCPToolDefinition } from "./types";
+/** Reconnect callback: tears down stale connection, returns new one or null. */
+export type MCPReconnect = () => Promise<MCPServerConnection | null>;
+export declare function isRetriableConnectionError(error: unknown): boolean;
+/** Details included in MCP tool results for rendering */
+export interface MCPToolDetails {
+    /** Server name */
+    serverName: string;
+    /** Original MCP tool name */
+    mcpToolName: string;
+    /** Whether the call resulted in an error */
+    isError?: boolean;
+    /** Raw content from MCP response */
+    rawContent?: MCPContent[];
+    /** Provider ID (e.g., "Anthropic model", "mcp-json") */
+    provider?: string;
+    /** Provider display name (e.g., "Anthropic Code", "MCP Config") */
+    providerName?: string;
+}
+export declare function createMCPToolName(serverName: string, toolName: string): string;
+/**
+ * Parse an MCP tool name back to server and tool components.
+ *
+ * Note: This returns the normalized tool name (with server prefix stripped).
+ * The original MCP tool name may have had the server name as a prefix.
+ */
+export declare function parseMCPToolName(name: string): {
+    serverName: string;
+    toolName: string;
+} | null;
+/**
+ * CustomTool wrapping an MCP tool with an active connection.
+ */
+export declare class MCPTool implements CustomTool<TSchema, MCPToolDetails> {
+    private connection;
+    private readonly tool;
+    private readonly reconnect?;
+    readonly name: string;
+    readonly label: string;
+    readonly description: string;
+    readonly parameters: TSchema;
+    /** Original MCP tool name (before normalization) */
+    readonly mcpToolName: string;
+    /** Server name */
+    readonly mcpServerName: string;
+    /** Create MCPTool instances for all tools from an MCP server connection */
+    static fromTools(connection: MCPServerConnection, tools: MCPToolDefinition[], reconnect?: MCPReconnect): MCPTool[];
+    constructor(connection: MCPServerConnection, tool: MCPToolDefinition, reconnect?: MCPReconnect | undefined);
+    renderCall(args: unknown, _options: RenderResultOptions, theme: Theme): import("@sayknow-cli/tui").Component;
+    renderResult(result: CustomToolResult<MCPToolDetails>, options: RenderResultOptions, theme: Theme, args?: unknown): import("@sayknow-cli/tui").Component;
+    execute(_toolCallId: string, params: unknown, _onUpdate: AgentToolUpdateCallback<MCPToolDetails> | undefined, _ctx: CustomToolContext, signal?: AbortSignal): Promise<CustomToolResult<MCPToolDetails>>;
+}
+/**
+ * CustomTool wrapping an MCP tool with deferred connection resolution.
+ */
+export declare class DeferredMCPTool implements CustomTool<TSchema, MCPToolDetails> {
+    #private;
+    private readonly serverName;
+    private readonly tool;
+    private readonly getConnection;
+    private readonly reconnect?;
+    readonly name: string;
+    readonly label: string;
+    readonly description: string;
+    readonly parameters: TSchema;
+    /** Original MCP tool name (before normalization) */
+    readonly mcpToolName: string;
+    /** Server name */
+    readonly mcpServerName: string;
+    /** Create DeferredMCPTool instances for all tools from an MCP server */
+    static fromTools(serverName: string, tools: MCPToolDefinition[], getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect): DeferredMCPTool[];
+    constructor(serverName: string, tool: MCPToolDefinition, getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect | undefined);
+    renderCall(args: unknown, _options: RenderResultOptions, theme: Theme): import("@sayknow-cli/tui").Component;
+    renderResult(result: CustomToolResult<MCPToolDetails>, options: RenderResultOptions, theme: Theme, args?: unknown): import("@sayknow-cli/tui").Component;
+    execute(_toolCallId: string, params: unknown, _onUpdate: AgentToolUpdateCallback<MCPToolDetails> | undefined, _ctx: CustomToolContext, signal?: AbortSignal): Promise<CustomToolResult<MCPToolDetails>>;
+}

package/dist/types/runtime-mcp/tool-cache.d.ts

@@ -0,0 +1,8 @@
+import type { AgentStorage } from "../session/agent-storage";
+import type { MCPServerConfig, MCPToolDefinition } from "./types";
+export declare class MCPToolCache {
+    private storage;
+    constructor(storage: AgentStorage);
+    get(serverName: string, config: MCPServerConfig): Promise<MCPToolDefinition[] | null>;
+    set(serverName: string, config: MCPServerConfig, tools: MCPToolDefinition[]): Promise<void>;
+}

package/dist/types/runtime-mcp/transports/http.d.ts

@@ -0,0 +1,36 @@
+import type { MCPHttpServerConfig, MCPRequestOptions, MCPSseServerConfig, MCPTransport } from "../../runtime-mcp/types";
+/**
+ * HTTP transport for MCP servers.
+ * Uses POST for requests, supports SSE responses.
+ */
+export declare class HttpTransport implements MCPTransport {
+    #private;
+    private config;
+    onClose?: () => void;
+    onError?: (error: Error) => void;
+    onNotification?: (method: string, params: unknown) => void;
+    onRequest?: (method: string, params: unknown) => Promise<unknown>;
+    /** Called on 401/403 to attempt token refresh. Returns updated headers or null. */
+    onAuthError?: () => Promise<Record<string, string> | null>;
+    constructor(config: MCPHttpServerConfig | MCPSseServerConfig);
+    get connected(): boolean;
+    get url(): string;
+    /**
+     * Mark transport as connected.
+     * HTTP doesn't need persistent connection, but we track state.
+     */
+    connect(): Promise<void>;
+    /**
+     * Start SSE listener for server-initiated messages.
+     * Resolves once the SSE connection is established (or fails/unsupported).
+     * Message reading continues in the background.
+     */
+    startSSEListener(): Promise<void>;
+    request<T = unknown>(method: string, params?: Record<string, unknown>, options?: MCPRequestOptions): Promise<T>;
+    notify(method: string, params?: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Create and connect an HTTP transport.
+ */
+export declare function createHttpTransport(config: MCPHttpServerConfig | MCPSseServerConfig): Promise<HttpTransport>;

package/dist/types/runtime-mcp/transports/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MCP transport exports.
+ */
+export * from "./http";
+export * from "./stdio";

package/dist/types/runtime-mcp/transports/stdio.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MCP stdio transport.
+ *
+ * Implements JSON-RPC 2.0 over subprocess stdin/stdout.
+ * Messages are newline-delimited JSON.
+ */
+import type { MCPRequestOptions, MCPStdioServerConfig, MCPTransport } from "../../runtime-mcp/types";
+export declare class StdioTransport implements MCPTransport {
+    #private;
+    private config;
+    onClose?: () => void;
+    onError?: (error: Error) => void;
+    onNotification?: (method: string, params: unknown) => void;
+    onRequest?: (method: string, params: unknown) => Promise<unknown>;
+    constructor(config: MCPStdioServerConfig);
+    get connected(): boolean;
+    get closeBeforeReconnect(): true;
+    /**
+     * Start the subprocess and begin reading.
+     */
+    connect(): Promise<void>;
+    request<T = unknown>(method: string, params?: Record<string, unknown>, options?: MCPRequestOptions): Promise<T>;
+    notify(method: string, params?: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Create and connect a stdio transport.
+ */
+export declare function createStdioTransport(config: MCPStdioServerConfig): Promise<StdioTransport>;