/**
 * 灵枢 MCP stdio 桥：管理大脑（md_cg）Python 子进程的生命周期，
 * 通过逐行 JSON-RPC 完成握手、工具发现与调用。
 *
 * 与官方 @deepseek-ai/dsh-mcp-client 不同，本桥零运行时依赖（不引入
 * @modelcontextprotocol/sdk），直接实现灵枢 server 使用的 2024-11-05 协议
 * 子集——与灵枢库 D-005「核心零外部依赖」的工程哲学一致。
 */
/** 灵枢 MCP server 暴露的原始工具（tools/list 结果项）。 */
export interface McpTool {
    name: string;
    description: string;
    inputSchema?: Record<string, unknown>;
}
/** 一次 tools/call 的标准化结果。 */
export interface McpCallResult {
    content: Array<{
        type: string;
        text?: string;
        [key: string]: unknown;
    }>;
    isError: boolean;
}
/** 启动灵枢子进程的配置。 */
export interface BridgeOptions {
    /** Python 可执行文件（或 md_cg-mcp console script），默认 python。 */
    python: string;
    /** 传给 python 的参数，默认 ['-m', 'md_cg.mcp_server']。 */
    args: string[];
    /** 追加到子进程的环境变量（MDCG_* / MDCG_MCP_SURFACE / 密钥等）。 */
    env: Record<string, string>;
    /** 子进程工作目录。 */
    cwd?: string;
    /** 单次工具调用超时（毫秒），默认 60s。 */
    timeoutMs: number;
    /** 断线重连的最大间隔（毫秒），默认 30s。 */
    maxRetryDelayMs: number;
}
export declare class LingshuBridge {
    private readonly options;
    private proc;
    private rl;
    private nextId;
    private pending;
    private started;
    private disposed;
    private retryDelayMs;
    private retries;
    private retryTimer;
    private bootQueue;
    private readyState;
    /** issue #7：当前子进程启动时间（计算 uptime，区分秒退与长存后外部关闭） */
    private procStartedAt;
    /** issue #7：运行期反复退出的滑动窗口（时间戳列表）——防无限重启刷屏 */
    private unexpectedExits;
    /** #224：最近一次子进程退出码——退出码 3 是 md_cg 的「令牌校验失败」专用码，
     *  三处启动失败提示据此改口，不再一律把人引向「python 与依赖」。 */
    private lastExitCode;
    constructor(options: BridgeOptions);
    /**
     * 启动灵枢进程并完成握手（initialize → notifications/initialized）。
     * 进程崩溃后自动指数退避重启，并重新握手。
     */
    start(): void;
    /** 拉取灵枢的全部工具清单（每次实时请求，不缓存）。 */
    listTools(): Promise<McpTool[]>;
    /** 调用灵枢的一个工具，返回标准化 MCP 结果。 */
    callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<McpCallResult>;
    /** 关闭进程并释放资源（写 stdin EOF 优雅退出，超时兜底 kill）。 */
    dispose(): void;
    /** 进程是否存活。 */
    get alive(): boolean;
    /** 桥是否已握手就绪（工具注册用；防止轮询访问 private readyState）。 */
    isReady(): boolean;
    /** 是否已达放弃终态（连续启动失败超上限，不再自动重启）。 */
    get gaveUp(): boolean;
    /** 等待握手完成（用于 apply 阶段同步就绪）。 */
    waitReady(): Promise<boolean>;
    /**
     * V23 修复（缺陷 :284）：清理上一个仍存活的子进程。
     * 握手超时/启动失败重试时直接 spawn 新进程并覆盖 this.proc（:182），
     * 旧进程若仍存活（卡死但不退出的服务端）既不 kill 也不关 stdin——
     * 引用被覆盖后永远无人清理 = 僵尸进程泄漏（最多 MAX_RETRIES 个并存，
     * dispose 也只收尾最后一个）。换代前统一回收：stdin EOF 优雅退出 + kill 兜底。
     * 幂等：已退出（exitCode/signalCode 非 null）的进程跳过。
     */
    private killStaleProc;
    private spawnAndHandshake;
    private handshake;
    private scheduleRetry;
    private writeRaw;
    private request;
    private settle;
    private rejectAll;
    private flushBootQueue;
}