import { type ACodeBuiltInToolLike } from "../desktop/built-in-desktop-tools.js";
import { DesktopMcpConnection, type DesktopMcpToolInfo } from "../desktop/desktop-mcp-client.js";

interface DesktopMcpManagerState {
    connection: DesktopMcpConnection;
    tools: DesktopMcpToolInfo[];
    
    forwarder: (name: string, args: Record<string, unknown>) => Promise<string>;
    binaryPath: string;
    
    envSig: string;
}

interface DesktopMcpFailureState {
    reason: "binary-missing" | "start-failed";
    message: string;
    at: number;
}

export interface DesktopAgentAiInfo {
    model: string;
    baseURL?: string;
    apiKey?: string;
    
    supportsImage?: boolean;
}

export declare function resolveDesktopMcpBinary(): Promise<string | null>;

export declare function startDesktopMcpManager(): Promise<DesktopMcpManagerState | null>;

export declare function getDesktopTools(agentId: string | undefined, agentAi?: DesktopAgentAiInfo): Promise<ACodeBuiltInToolLike[]>;

export declare function getDesktopToolsIfReady(): ACodeBuiltInToolLike[];

export declare function disposeDesktopMcpManager(): Promise<void>;

export declare function getDesktopMcpStatus(): {
    started: boolean;
    binaryPath: string | null;
    toolCount: number;
    failure: DesktopMcpFailureState | null;
    
    visionSource: "panel-env" | "agent-fallback" | "none";
};
export {};