@sayknow-cli/coding-agent 0.3.12 → 0.3.13

package/dist/types/runtime/process-lifecycle.d.ts

@@ -1,108 +0,0 @@
-/**
- * Shared runtime lifecycle foundation.
- *
- * Two minimal, deliberately small primitives that subsystem runtimes
- * (DAP/LSP/MCP stdio, eval workers, etc.) adopt so spawned children and
- * non-process resources cannot outlive their owner:
- *
- *   F1(a) `spawnOwnedProcess` — wraps `ptree.spawn` with explicit
- *         process-group ownership, escalating (SIGTERM -> grace -> SIGKILL)
- *         tree termination, bounded `awaitExit`, abort-listener cleanup on
- *         settle, idempotent `dispose`, and a single postmortem hook that
- *         reaps every still-live owned process group on fatal/normal shutdown.
- *
- *   F1(b) `registerResourceOwner` — a generic, idempotent postmortem adapter
- *         for non-process resources (Bun Workers, VM contexts, timers,
- *         sockets) built on the existing `postmortem.register` facility.
- *
- * Ownership is keyed to the *process group*, not the root process. A root that
- * exits after backgrounding descendants (`sh -c "worker & exit 0"`) keeps the
- * owner registered until the group is actually gone, so the descendant tree is
- * still reaped by `dispose()`/postmortem.
- *
- * This module intentionally owns only these primitives. It does not migrate
- * existing call sites; subsystem PRs adopt it incrementally.
- *
- * Note: `ptree.spawn` always pipes stdout/stderr. Adopters that expect output
- * (DAP/LSP/MCP protocol servers) must consume `owner.child.stdout`; F1 does not
- * drain it, so a chatty child whose stdout is never read can still block on a
- * full pipe. That draining is the adopter's responsibility.
- */
-import { ptree } from "@sayknow-cli/utils";
-/** Options for {@link spawnOwnedProcess}. */
-export interface SpawnOwnedOptions {
-    cwd?: string;
-    env?: Record<string, string | undefined>;
-    /** stdin mode passed through to the child. Defaults to `"ignore"`. */
-    stdin?: "pipe" | "ignore";
-    /** When aborted, the owned process tree is disposed (escalating kill). */
-    signal?: AbortSignal;
-    /** Grace period (ms) between SIGTERM and SIGKILL on dispose. Default 2000. */
-    gracefulMs?: number;
-    /**
-     * Spawn the child as its own process-group leader so the whole descendant
-     * tree can be signalled on dispose. Defaults to `true` on POSIX. Has no
-     * effect on Windows, where teardown falls back to single-process kill.
-     */
-    processGroup?: boolean;
-    /** Label used in diagnostics. */
-    name?: string;
-}
-/** Result of a bounded {@link OwnedProcess.awaitExit}. */
-export interface AwaitExitResult {
-    /** `true` when the process has exited; `false` when the timeout fired first. */
-    exited: boolean;
-    /** Exit code if known, else `null`. */
-    code: number | null;
-}
-/** A spawned child process owned by the runtime with guaranteed teardown. */
-export interface OwnedProcess {
-    readonly child: ptree.ChildProcess;
-    readonly pid: number | undefined;
-    /** Resolves/rejects when the root child exits (mirrors ptree's `exited`). */
-    readonly exited: Promise<number>;
-    /** `true` once `dispose()` has started. */
-    readonly disposed: boolean;
-    /**
-     * Wait for the root child to exit, optionally bounded by `timeoutMs`. With no
-     * timeout it resolves only when the child exits. Never rejects.
-     */
-    awaitExit(opts?: {
-        timeoutMs?: number;
-    }): Promise<AwaitExitResult>;
-    /**
-     * Idempotently terminate the owned process *group*: SIGTERM the group, wait
-     * `gracefulMs`, then SIGKILL, polling group liveness throughout. Removes the
-     * abort listener and deregisters from the live-owner set only after teardown
-     * has completed. Repeated/concurrent calls return the same in-flight promise.
-     */
-    dispose(): Promise<void>;
-}
-/**
- * Spawn a child process owned by the runtime. The returned {@link OwnedProcess}
- * is registered for postmortem cleanup and tears down its whole process group
- * on dispose/abort.
- */
-export declare function spawnOwnedProcess(cmd: string[], opts?: SpawnOwnedOptions): OwnedProcess;
-/** Number of currently live owned processes. Exposed for leak assertions/tests. */
-export declare function liveOwnedProcessCount(): number;
-/** Dispose every live owned process. For owner-scoped teardown and tests. */
-export declare function disposeAllOwnedProcesses(): Promise<void>;
-type ResourceDisposer = () => void | Promise<void>;
-/**
- * Register a non-process resource for postmortem/fatal-exit cleanup.
- *
- * Idempotent by `name`: re-registering the same name replaces the prior
- * disposer (last wins). Returns an unregister function that removes the owner
- * only while it is still the active registration for that name.
- */
-export declare function registerResourceOwner(name: string, disposer: ResourceDisposer): () => void;
-/** Number of registered resource owners. Exposed for leak assertions/tests. */
-export declare function resourceOwnerCount(): number;
-/**
- * Run and clear every registered resource disposer. Attempts all disposers even
- * if some throw, then surfaces the failures as an `AggregateError` so callers
- * can distinguish "all closed" from "a resource may still be alive".
- */
-export declare function disposeAllResourceOwners(): Promise<void>;
-export {};

package/dist/types/runtime-api-key.d.ts

@@ -1,7 +0,0 @@
-export interface RuntimeApiKeyTarget {
-    setRuntimeApiKey(provider: string, apiKey: string): void;
-}
-export interface RuntimeApiKeyModel {
-    provider: string;
-}
-export declare function applyCliRuntimeApiKeyOverride(target: RuntimeApiKeyTarget, apiKey: string | undefined, model: RuntimeApiKeyModel | undefined): void;

package/dist/types/runtime-credential-selector.d.ts

@@ -1,7 +0,0 @@
-import type { AuthCredentialSelector } from "@sayknow-cli/ai";
-export interface CliCredentialSelector {
-    provider?: string;
-    selector: AuthCredentialSelector;
-    raw: string;
-}
-export declare function parseCliCredentialSelector(raw: string): CliCredentialSelector;

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

@@ -1,74 +0,0 @@
-import type { MCPGetPromptResult, MCPPrompt, MCPRequestOptions, MCPResource, MCPResourceReadResult, MCPResourceTemplate, MCPServerCapabilities, MCPServerConfig, MCPServerConnection, MCPToolCallResult, MCPToolDefinition } from "./types";
-/**
- * Connect to an MCP server.
- * Has a 30 second timeout to prevent blocking startup.
- */
-export declare function connectToServer(name: string, config: MCPServerConfig, options?: {
-    signal?: AbortSignal;
-    onNotification?: (method: string, params: unknown) => void;
-    onRequest?: (method: string, params: unknown) => Promise<unknown>;
-}): Promise<MCPServerConnection>;
-/**
- * List tools from a connected server.
- */
-export declare function listTools(connection: MCPServerConnection, options?: {
-    signal?: AbortSignal;
-}): Promise<MCPToolDefinition[]>;
-/**
- * Call a tool on a connected server.
- */
-export declare function callTool(connection: MCPServerConnection, toolName: string, args?: Record<string, unknown>, options?: MCPRequestOptions): Promise<MCPToolCallResult>;
-/**
- * Disconnect from a server.
- */
-export declare function disconnectServer(connection: MCPServerConnection): Promise<void>;
-/**
- * Check if a server supports tools.
- */
-export declare function serverSupportsTools(capabilities: MCPServerCapabilities): boolean;
-/**
- * List resources from a connected server.
- */
-export declare function listResources(connection: MCPServerConnection, options?: {
-    signal?: AbortSignal;
-}): Promise<MCPResource[]>;
-/**
- * List resource templates from a connected server.
- */
-export declare function listResourceTemplates(connection: MCPServerConnection, options?: {
-    signal?: AbortSignal;
-}): Promise<MCPResourceTemplate[]>;
-/**
- * Read a resource from a connected server.
- */
-export declare function readResource(connection: MCPServerConnection, uri: string, options?: MCPRequestOptions): Promise<MCPResourceReadResult>;
-/**
- * Subscribe to resource update notifications.
- */
-export declare function subscribeToResources(connection: MCPServerConnection, uris: string[], options?: MCPRequestOptions): Promise<void>;
-/**
- * Unsubscribe from resource update notifications.
- */
-export declare function unsubscribeFromResources(connection: MCPServerConnection, uris: string[], options?: MCPRequestOptions): Promise<void>;
-/**
- * Check if a server supports resource subscriptions.
- */
-export declare function serverSupportsResourceSubscriptions(capabilities: MCPServerCapabilities): boolean;
-/**
- * Check if a server supports resources.
- */
-export declare function serverSupportsResources(capabilities: MCPServerCapabilities): boolean;
-/**
- * List prompts from a connected server.
- */
-export declare function listPrompts(connection: MCPServerConnection, options?: {
-    signal?: AbortSignal;
-}): Promise<MCPPrompt[]>;
-/**
- * Get a specific prompt from a connected server.
- */
-export declare function getPrompt(connection: MCPServerConnection, name: string, args?: Record<string, string>, options?: MCPRequestOptions): Promise<MCPGetPromptResult>;
-/**
- * Check if a server supports prompts.
- */
-export declare function serverSupportsPrompts(capabilities: MCPServerCapabilities): boolean;

package/dist/types/runtime-mcp/config-writer.d.ts

@@ -1,89 +0,0 @@
-import { type MCPConfigFile, type MCPServerConfig } from "./types";
-/**
- * Read an MCP config file.
- * Returns empty config if file doesn't exist.
- */
-export declare function readMCPConfigFile(filePath: string): Promise<MCPConfigFile>;
-/**
- * Write an MCP config file atomically.
- * Creates parent directories if they don't exist.
- */
-export declare function writeMCPConfigFile(filePath: string, config: MCPConfigFile): Promise<void>;
-/**
- * Validate server name.
- * @returns Error message if invalid, undefined if valid
- */
-export declare function validateServerName(name: string): string | undefined;
-/**
- * Add an MCP server to a config file.
- * Validates the config before writing.
- *
- * @throws Error if server name already exists or validation fails
- */
-export declare function addMCPServer(filePath: string, name: string, config: MCPServerConfig): Promise<void>;
-/**
- * Update an existing MCP server in a config file.
- * If the server doesn't exist, this will add it.
- *
- * @throws Error if validation fails
- */
-export declare function updateMCPServer(filePath: string, name: string, config: MCPServerConfig): Promise<void>;
-/**
- * Result of an {@link upsertMCPServer} call.
- * - `added`: server did not exist and was written.
- * - `updated`: server existed and was overwritten because `force` was set.
- * - `skipped`: server existed and `force` was not set, so nothing was written.
- */
-export type UpsertMCPServerResult = {
-    status: "added";
-} | {
-    status: "updated";
-} | {
-    status: "skipped";
-    reason: "exists";
-};
-/**
- * Add an MCP server, or overwrite an existing one only when `force` is set.
- *
- * Collision-aware wrapper over {@link addMCPServer} / {@link updateMCPServer} used by
- * `skc migrate`. Never connects to the server. Reuses the underlying writers so the
- * rest of the config file (including `disabledServers`) is preserved on update.
- *
- * @throws Error if the server name or config is invalid (validated before any write).
- */
-export declare function upsertMCPServer(filePath: string, name: string, config: MCPServerConfig, options?: {
-    force?: boolean;
-}): Promise<UpsertMCPServerResult>;
-/**
- * Remove an MCP server from a config file.
- *
- * @throws Error if server doesn't exist
- */
-export declare function removeMCPServer(filePath: string, name: string): Promise<void>;
-/**
- * Get a specific server config from a file.
- * Returns undefined if server doesn't exist.
- */
-export declare function getMCPServer(filePath: string, name: string): Promise<MCPServerConfig | undefined>;
-/**
- * List all server names in a config file.
- */
-export declare function listMCPServers(filePath: string): Promise<string[]>;
-/**
- * Set a server's autoload flag for explicit runtime MCP consumers.
- *
- * Autoload defaults to true for consumers that honor it, so turning it on
- * removes the key to keep the config file free of redundant fields; turning it
- * off writes `autoload: false`.
- *
- * @throws Error if the server doesn't exist
- */
-export declare function setServerAutoload(filePath: string, name: string, autoload: boolean): Promise<void>;
-/**
- * Read the disabled servers list from a config file.
- */
-export declare function readDisabledServers(filePath: string): Promise<string[]>;
-/**
- * Add or remove a server name from the disabled servers list.
- */
-export declare function setServerDisabled(filePath: string, name: string, disabled: boolean): Promise<void>;

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

@@ -1,77 +0,0 @@
-/**
- * MCP configuration loader.
- *
- * Uses the capability system to load MCP servers from multiple sources.
- */
-import type { SourceMeta } from "../capability/types";
-import type { MCPServerConfig } from "./types";
-/** Options for loading MCP configs */
-export interface LoadMCPConfigsOptions {
-    /** 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 include servers eligible for startup connection, i.e. autoload !== false (default: false) */
-    autoloadOnly?: boolean;
-}
-/** Result of loading MCP configs */
-export interface LoadMCPConfigsResult {
-    /** Loaded server configs */
-    configs: Record<string, MCPServerConfig>;
-    /** Extracted Exa API keys (if any were filtered) */
-    exaApiKeys: string[];
-    /** Source metadata for each server */
-    sources: Record<string, SourceMeta>;
-}
-/**
- * Load all MCP server configs from standard locations.
- * Uses the capability system for multi-source discovery.
- *
- * @param cwd Working directory (project root)
- * @param options Load options
- */
-export declare function loadAllMCPConfigs(cwd: string, options?: LoadMCPConfigsOptions): Promise<LoadMCPConfigsResult>;
-/**
- * Check if a server config is an Exa MCP server.
- */
-export declare function isExaMCPServer(name: string, config: MCPServerConfig): boolean;
-/**
- * Extract Exa API key from an MCP server config.
- */
-export declare function extractExaApiKey(config: MCPServerConfig): string | undefined;
-/** Result of filtering Exa MCP servers */
-export interface ExaFilterResult {
-    /** Configs with Exa servers removed */
-    configs: Record<string, MCPServerConfig>;
-    /** Extracted Exa API keys (if any) */
-    exaApiKeys: string[];
-    /** Source metadata for remaining servers */
-    sources: Record<string, SourceMeta>;
-}
-/**
- * Filter out Exa MCP servers and extract their API keys.
- * Since we have native Exa integration, we don't need the MCP server.
- */
-export declare function filterExaMCPServers(configs: Record<string, MCPServerConfig>, sources: Record<string, SourceMeta>): ExaFilterResult;
-/**
- * Validate server config has required fields.
- */
-export declare function validateServerConfig(name: string, config: MCPServerConfig): string[];
-/**
- * Check if a server config is a browser automation MCP server.
- */
-export declare function isBrowserMCPServer(name: string, config: MCPServerConfig): boolean;
-/** Result of filtering browser MCP servers */
-export interface BrowserFilterResult {
-    /** Configs with browser servers removed */
-    configs: Record<string, MCPServerConfig>;
-    /** Source metadata for remaining servers */
-    sources: Record<string, SourceMeta>;
-}
-/**
- * Filter out browser automation MCP servers.
- * Since we have a native browser tool, we don't need these MCP servers.
- */
-export declare function filterBrowserMCPServers(configs: Record<string, MCPServerConfig>, sources: Record<string, SourceMeta>): BrowserFilterResult;

package/dist/types/runtime-mcp/discoverable-tool-metadata.d.ts

@@ -1,7 +0,0 @@
-/**
- * Back-compat re-export layer.
- * All types and functions have moved to src/tool-discovery/tool-index.ts.
- * This file exists solely so existing imports continue to compile without changes.
- */
-export type { DiscoverableMCPSearchDocument, DiscoverableMCPSearchIndex, DiscoverableMCPSearchResult, DiscoverableMCPTool, DiscoverableMCPToolServerSummary, DiscoverableMCPToolSummary, } from "../tool-discovery/tool-index";
-export { buildDiscoverableMCPSearchIndex, collectDiscoverableMCPTools, formatDiscoverableMCPToolServerSummary, getDiscoverableMCPTool, isMCPBridgeTool, isMCPToolName, searchDiscoverableMCPTools, selectDiscoverableMCPToolNamesByServer, summarizeDiscoverableMCPTools, } from "../tool-discovery/tool-index";

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

@@ -1,18 +0,0 @@
-/**
- * MCP (Model Context Protocol) support.
- *
- * Provides per-project .mcp.json configuration for connecting to
- * MCP servers via stdio or HTTP transports.
- */
-export * from "./client";
-export * from "./config";
-export * from "./config-writer";
-export { callMCP, parseSSE } from "./json-rpc";
-export * from "./loader";
-export * from "./manager";
-export * from "./oauth-discovery";
-export * from "./tool-bridge";
-export * from "./tool-cache";
-export * from "./transports/http";
-export * from "./transports/stdio";
-export * from "./types";

package/dist/types/runtime-mcp/json-rpc.d.ts

@@ -1,22 +0,0 @@
-/** Parse SSE response format (lines starting with "data: ") */
-export declare function parseSSE(text: string): unknown;
-/** JSON-RPC 2.0 response structure */
-export interface JsonRpcResponse<T = unknown> {
-    jsonrpc: "2.0";
-    id: string | number;
-    result?: T;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-/**
- * Call an MCP server with JSON-RPC 2.0 over HTTPS.
- *
- * @param url - Full MCP server URL (including any query parameters)
- * @param method - JSON-RPC method name (e.g., "tools/list", "tools/call")
- * @param params - Method parameters
- * @returns Parsed JSON-RPC response
- */
-export declare function callMCP<T = unknown>(url: string, method: string, params?: Record<string, unknown>): Promise<JsonRpcResponse<T>>;

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

@@ -1,45 +0,0 @@
-import type { LoadedCustomTool } from "../extensibility/custom-tools/types";
-import { AgentStorage } from "../session/agent-storage";
-import type { AuthStorage } from "../session/auth-storage";
-import { MCPManager } from "./manager";
-/** Result from loading MCP tools */
-export interface MCPToolsLoadResult {
-    /** MCP manager (for lifecycle management) */
-    manager: MCPManager;
-    /** Loaded tools as LoadedCustomTool format */
-    tools: LoadedCustomTool[];
-    /** Errors keyed by server name */
-    errors: Array<{
-        path: string;
-        error: string;
-    }>;
-    /** Connected server names */
-    connectedServers: string[];
-    /** Extracted Exa API keys from filtered MCP servers */
-    exaApiKeys: string[];
-}
-/** Options for loading MCP tools */
-export interface MCPToolsLoadOptions {
-    /** Called when starting to connect to servers */
-    onConnecting?: (serverNames: string[]) => void;
-    /** 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;
-    /** SQLite storage for MCP tool cache (null disables cache) */
-    cacheStorage?: AgentStorage | null;
-    /** Auth storage used to resolve OAuth credentials before initial MCP connect */
-    authStorage?: AuthStorage;
-}
-/**
- * Discover and load MCP tools from .mcp.json files.
- *
- * @param cwd Working directory (project root)
- * @param options Load options including progress callbacks
- * @returns MCP tools in LoadedCustomTool format for integration
- */
-export declare function discoverAndLoadMCPTools(cwd: string, options?: MCPToolsLoadOptions): Promise<MCPToolsLoadResult>;

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

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