export interface ToolError {
    ok: false;
    error: string;
    hint?: string;
    details?: Record<string, unknown>;
}
export interface ScreenshotResult {
    ok: true;
    base64_png: string;
    width: number;
    height: number;
    saved_path?: string;
    platform: string;
    backend: string;
}
export interface WindowInfo {
    id?: string;
    title: string;
    pid?: number;
    app?: string;
    x?: number;
    y?: number;
    width?: number;
    height?: number;
    focused?: boolean;
}
export interface ProcessInfo {
    pid: number;
    name: string;
    ppid?: number;
    user?: string;
    cpu?: number;
    mem_kb?: number;
    cmdline?: string;
}
export interface ScreenshotArgs {
    save_path?: string;
    display?: number;
}
export declare function takeScreenshot(args?: ScreenshotArgs): Promise<ScreenshotResult | ToolError>;
export interface WindowScreenshotArgs {
    title_pattern: string;
    save_path?: string;
    focus_first?: boolean;
}
export declare function screenshotWindow(args: WindowScreenshotArgs): Promise<ScreenshotResult | ToolError>;
export interface ListWindowsArgs {
    title_pattern?: string;
    include_hidden?: boolean;
}
export declare function listWindows(args?: ListWindowsArgs): Promise<{
    ok: true;
    windows: WindowInfo[];
    platform: string;
} | ToolError>;
export interface FocusWindowArgs {
    title_pattern: string;
}
export declare function focusWindow(args: FocusWindowArgs): Promise<{
    ok: true;
    title: string;
    platform: string;
} | ToolError>;
export interface SendKeysArgs {
    keys: string;
    chord?: boolean;
    focus_window?: string;
}
export declare function sendKeys(args: SendKeysArgs): Promise<{
    ok: true;
    platform: string;
} | ToolError>;
export interface MouseClickArgs {
    x: number;
    y: number;
    button?: 'left' | 'middle' | 'right';
    count?: number;
}
export declare function mouseClick(args: MouseClickArgs): Promise<{
    ok: true;
    platform: string;
} | ToolError>;
export interface MouseMoveArgs {
    x: number;
    y: number;
}
export declare function mouseMove(args: MouseMoveArgs): Promise<{
    ok: true;
    platform: string;
} | ToolError>;
export interface ListProcessesArgs {
    name_pattern?: string;
}
export declare function listProcesses(args?: ListProcessesArgs): Promise<{
    ok: true;
    processes: ProcessInfo[];
    platform: string;
} | ToolError>;
export interface KillProcessArgs {
    pid?: number;
    name_pattern?: string;
    force?: boolean;
}
export declare function killProcess(args: KillProcessArgs): Promise<{
    ok: true;
    killed: number[];
    platform: string;
} | ToolError>;
export interface LaunchProcessArgs {
    command: string;
    args?: string[];
    cwd?: string;
    env?: Record<string, string>;
    detach?: boolean;
}
export declare function launchProcess(args: LaunchProcessArgs): Promise<{
    ok: true;
    pid: number | null;
    platform: string;
} | ToolError>;
export interface WaitForFileArgs {
    path: string;
    timeout_seconds?: number;
    poll_ms?: number;
    newer_than_ms?: number;
    content_pattern?: string;
}
export declare function waitForFile(args: WaitForFileArgs): Promise<{
    ok: true;
    appeared_at: string;
    size: number;
    content?: string;
} | ToolError>;
export interface ReadFileTailArgs {
    path: string;
    bytes?: number;
}
export declare function readFileTail(args: ReadFileTailArgs): Promise<{
    ok: true;
    content: string;
    size: number;
    mtime: string;
} | ToolError>;
export declare function clipboardRead(): Promise<{
    ok: true;
    text: string;
    platform: string;
} | ToolError>;
export interface ClipboardWriteArgs {
    text: string;
}
export declare function clipboardWrite(args: ClipboardWriteArgs): Promise<{
    ok: true;
    platform: string;
} | ToolError>;
export declare function osInfo(): Promise<{
    ok: true;
    info: Record<string, unknown>;
}>;
export interface ShellExecArgs {
    command: string;
    args?: string[];
    cwd?: string;
    timeout_seconds?: number;
    stdin?: string;
}
export declare function shellExec(args: ShellExecArgs): Promise<{
    ok: true;
    code: number;
    stdout: string;
    stderr: string;
} | ToolError>;