import type { ScreenInfo, DesktopWindowInfo, OpenWithApp, DesktopFileEntry, UIElement, FlatNode } from "./types.js";
export interface WindowTarget {
    hwnd?: string;
    title?: string;
    pid?: number;
}
export interface WindowRectPatch {
    x?: number;
    y?: number;
    width?: number;
    height?: number;
}

export interface FullResScreenshot {
    jpeg: Buffer;
    width: number;
    height: number;
    screen: ScreenInfo;
}
export interface UIElementTreeResult {
    
    elements: UIElement[];
    
    flatNodes: FlatNode[];
}
export interface ComputerUseBackend {
    
    readonly platform: "windows" | "macos" | "linux";
    
    readonly viaSidecar: boolean;
    
    startPersistentProcess(): void;
    listScreens(): Promise<ScreenInfo[]>;
    
    captureFullResJpeg(screenId?: string): Promise<FullResScreenshot>;
    
    setActiveScreen(screen: ScreenInfo): void;
    getScreenSize(): {
        width: number;
        height: number;
    };
    moveMouse(x: number, y: number): Promise<void>;
    click(x: number, y: number, button?: "left" | "right"): Promise<void>;
    
    clickOs(x: number, y: number, button?: "left" | "right"): Promise<void>;
    doubleClick(x: number, y: number): Promise<void>;
    mouseDown(button?: "left" | "right"): Promise<void>;
    mouseUp(button?: "left" | "right"): Promise<void>;
    scroll(direction: "up" | "down" | "left" | "right", amount: number): Promise<void>;
    type(text: string): Promise<void>;
    keyPress(keys: string[]): Promise<void>;
    keyDown(key: string): Promise<void>;
    keyUp(key: string): Promise<void>;
    drag(fromX: number, fromY: number, toX: number, toY: number, button?: "left" | "right"): Promise<void>;
    getClipboard(): Promise<string>;
    setClipboard(text: string): Promise<void>;
    listWindows(): Promise<DesktopWindowInfo[]>;
    activateWindow(target: WindowTarget): Promise<{
        ok: boolean;
        hwnd: string;
        title?: string;
    }>;
    setWindowRect(target: WindowTarget, rect: WindowRectPatch): Promise<{
        ok: boolean;
        hwnd: string;
    }>;
    minimizeWindow(target: WindowTarget): Promise<{
        ok: boolean;
    }>;
    maximizeWindow(target: WindowTarget): Promise<{
        ok: boolean;
    }>;
    restoreWindow(target: WindowTarget): Promise<{
        ok: boolean;
    }>;
    getZOrder(): Promise<DesktopWindowInfo[]>;
    getForeground(): Promise<DesktopWindowInfo | null>;
    launchApp(command: string): Promise<{
        ok: boolean;
        pid?: number;
    }>;
    openFile(filePath: string, app?: string): Promise<{
        ok: boolean;
        app?: string;
    }>;
    listOpenWith(filePath: string): Promise<OpenWithApp[]>;
    listDir(path: string, opts?: {
        includeHidden?: boolean;
    }): Promise<{
        path: string;
        entries: DesktopFileEntry[];
    }>;
    listProcesses(): Promise<Array<{
        pid: number;
        name: string;
    }>>;
    
    getUIElementsTree(pid: number): Promise<UIElement[]>;
    
    traverseNodes(pid: number): Promise<FlatNode[]>;
    findElementsByName(pid: number, text: string, role?: string): Promise<FlatNode[]>;
    findEditableByName(pid: number, text: string): Promise<FlatNode | null>;
    findElementBounds(pid: number, path: string): Promise<{
        x: number;
        y: number;
        width: number;
        height: number;
    } | null>;
    findElementByFingerprint(pid: number, fingerprint: string): Promise<FlatNode | null>;
    invalidateCache(pid?: number): void;
}