test-wuying-agentbay-sdk 0.13.0-beta.20251218180112 → 0.13.0-beta.20251219140420

package/dist/index.d.mts

@@ -125,6 +125,31 @@ interface OperationResult extends ApiResponse {
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+/**
+ * Interface for process list operation responses
+ * Corresponds to Python's ProcessListResult type
+ */
+interface Process$1 {
+    pname: string;
+    pid: number;
+    cmdline?: string;
+}
+interface ProcessListResult extends OperationResult {
+    data: Process$1[];
+}
+/**
+ * Interface for installed app list operation responses
+ * Corresponds to Python's InstalledAppListResult type
+ */
+interface InstalledApp$1 {
+    name: string;
+    startCmd: string;
+    stopCmd?: string;
+    workDirectory?: string;
+}
+interface InstalledAppListResult extends OperationResult {
+    data: InstalledApp$1[];
+}
 /**
  * Interface for command execution operation responses
  * Corresponds to Python's CommandResult type
@@ -201,7 +226,7 @@ interface CodeExecutionResult extends ApiResponse {
  * Interface for boolean operation responses
  * Corresponds to Python's BoolResult type
  */
-interface BoolResult$2 extends ApiResponse {
+interface BoolResult$1 extends ApiResponse {
     /** Request identifier for tracking API calls */
     requestId: string;
     /** Whether the operation was successful */
@@ -323,6 +348,12 @@ interface OSSDownloadResult extends ApiResponse {
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+interface WindowInfo {
+    windowId: number;
+    title: string;
+    pid: number;
+    pname: string;
+}
 /**
  * Interface for window list operation responses
  * Corresponds to Python's WindowListResult type
@@ -333,10 +364,21 @@ interface WindowListResult extends ApiResponse {
     /** Whether the operation was successful */
     success: boolean;
     /** List of windows */
-    windows: any[];
+    windows: WindowInfo[];
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+interface Window {
+    windowId: number;
+    title: string;
+    absoluteUpperLeftX?: number;
+    absoluteUpperLeftY?: number;
+    width?: number;
+    height?: number;
+    pid?: number;
+    pname?: string;
+    childWindows?: Window[];
+}
 /**
  * Interface for window info operation responses
  * Corresponds to Python's WindowInfoResult type
@@ -347,7 +389,7 @@ interface WindowInfoResult extends ApiResponse {
     /** Whether the operation was successful */
     success: boolean;
     /** Window object */
-    window?: any;
+    window?: Window[];
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
@@ -492,6 +534,32 @@ interface SessionResumeResult extends ApiResponse {
     /** Current status of the session. Possible values: "RUNNING", "PAUSED", "RESUMING" */
     status?: string;
 }
+/**
+ * Represents the screen dimensions and DPI scaling information.
+ *
+ * @interface ScreenSize
+ * @extends OperationResult
+ */
+interface ScreenSize extends OperationResult {
+    /** Screen width in pixels */
+    width: number;
+    /** Screen height in pixels */
+    height: number;
+    /** DPI scaling factor (e.g., 1.0 for 100%, 1.5 for 150%, 2.0 for 200%) */
+    dpiScalingFactor: number;
+}
+/**
+ * Represents the current cursor position on screen.
+ *
+ * @interface CursorPosition
+ * @extends OperationResult
+ */
+interface CursorPosition extends OperationResult {
+    /** X coordinate in pixels (0 is left edge of screen) */
+    x: number;
+    /** Y coordinate in pixels (0 is top edge of screen) */
+    y: number;
+}
 
 /**
  */
@@ -4208,6 +4276,9 @@ declare function replaceTemplatePlaceholders(template: string, replacements: Rec
  * Provides mouse, keyboard, and screen operations for desktop environments.
  */
 
+interface ScreenshotResult$1 extends OperationResult {
+    data: string;
+}
 declare enum MouseButton {
     LEFT = "left",
     RIGHT = "right",
@@ -4220,21 +4291,6 @@ declare enum ScrollDirection {
     LEFT = "left",
     RIGHT = "right"
 }
-interface BoolResult$1 extends OperationResult {
-    data?: boolean;
-}
-interface CursorPosition extends OperationResult {
-    x: number;
-    y: number;
-}
-interface ScreenSize extends OperationResult {
-    width: number;
-    height: number;
-    dpiScalingFactor: number;
-}
-interface ScreenshotResult$1 extends OperationResult {
-    data: string;
-}
 interface ComputerSession {
     callMcpTool(toolName: string, args: Record<string, any>): Promise<any>;
     sessionId: string;
@@ -4263,7 +4319,7 @@ declare class Computer {
      * }
      * ```
      */
-    clickMouse(x: number, y: number, button?: MouseButton | string): Promise<BoolResult$1>;
+    clickMouse(x: number, y: number, button?: MouseButton | string): Promise<OperationResult>;
     /**
      * Move mouse to specified coordinates.
      *
@@ -4283,7 +4339,7 @@ declare class Computer {
      * }
      * ```
      */
-    moveMouse(x: number, y: number): Promise<BoolResult$1>;
+    moveMouse(x: number, y: number): Promise<OperationResult>;
     /**
      * Drag mouse from one position to another.
      *
@@ -4305,7 +4361,7 @@ declare class Computer {
      * }
      * ```
      */
-    dragMouse(fromX: number, fromY: number, toX: number, toY: number, button?: MouseButton | string): Promise<BoolResult$1>;
+    dragMouse(fromX: number, fromY: number, toX: number, toY: number, button?: MouseButton | string): Promise<OperationResult>;
     /**
      * Scroll at specified coordinates.
      *
@@ -4325,7 +4381,7 @@ declare class Computer {
      * }
      * ```
      */
-    scroll(x: number, y: number, direction?: ScrollDirection | string, amount?: number): Promise<BoolResult$1>;
+    scroll(x: number, y: number, direction?: ScrollDirection | string, amount?: number): Promise<OperationResult>;
     /**
      * Input text at the current cursor position.
      *
@@ -4342,7 +4398,7 @@ declare class Computer {
      * }
      * ```
      */
-    inputText(text: string): Promise<BoolResult$1>;
+    inputText(text: string): Promise<OperationResult>;
     /**
      * Press one or more keys.
      *
@@ -4361,7 +4417,7 @@ declare class Computer {
      * }
      * ```
      */
-    pressKeys(keys: string[], hold?: boolean): Promise<BoolResult$1>;
+    pressKeys(keys: string[], hold?: boolean): Promise<OperationResult>;
     /**
      * Release previously pressed keys.
      *
@@ -4379,7 +4435,7 @@ declare class Computer {
      * }
      * ```
      */
-    releaseKeys(keys: string[]): Promise<BoolResult$1>;
+    releaseKeys(keys: string[]): Promise<OperationResult>;
     /**
      * Get cursor position.
      *
@@ -4466,7 +4522,7 @@ declare class Computer {
      * }
      * ```
      */
-    getActiveWindow(timeoutMs?: number): Promise<WindowInfoResult>;
+    getActiveWindow(): Promise<WindowInfoResult>;
     /**
      * Activates the specified window.
      *
@@ -4484,7 +4540,7 @@ declare class Computer {
      * }
      * ```
      */
-    activateWindow(windowId: number): Promise<BoolResult$2>;
+    activateWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Closes the specified window.
      *
@@ -4503,7 +4559,7 @@ declare class Computer {
      * }
      * ```
      */
-    closeWindow(windowId: number): Promise<BoolResult$2>;
+    closeWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Maximizes the specified window.
      *
@@ -4522,7 +4578,7 @@ declare class Computer {
      * }
      * ```
      */
-    maximizeWindow(windowId: number): Promise<BoolResult$2>;
+    maximizeWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Minimizes the specified window.
      *
@@ -4541,7 +4597,7 @@ declare class Computer {
      * }
      * ```
      */
-    minimizeWindow(windowId: number): Promise<BoolResult$2>;
+    minimizeWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Restores the specified window.
      *
@@ -4561,7 +4617,7 @@ declare class Computer {
      * }
      * ```
      */
-    restoreWindow(windowId: number): Promise<BoolResult$2>;
+    restoreWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Resizes the specified window.
      *
@@ -4582,7 +4638,7 @@ declare class Computer {
      * }
      * ```
      */
-    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult$2>;
+    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult$1>;
     /**
      * Makes the specified window fullscreen.
      *
@@ -4601,7 +4657,7 @@ declare class Computer {
      * }
      * ```
      */
-    fullscreenWindow(windowId: number): Promise<BoolResult$2>;
+    fullscreenWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Toggles focus mode on or off.
      *
@@ -4619,7 +4675,7 @@ declare class Computer {
      * }
      * ```
      */
-    focusMode(on: boolean): Promise<BoolResult$2>;
+    focusMode(on: boolean): Promise<BoolResult$1>;
     /**
      * Gets the list of installed applications.
      *
@@ -4639,7 +4695,7 @@ declare class Computer {
      * }
      * ```
      */
-    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<any>;
+    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<InstalledAppListResult>;
     /**
      * Starts the specified application.
      *
@@ -4659,7 +4715,7 @@ declare class Computer {
      * }
      * ```
      */
-    startApp(startCmd: string, workDirectory?: string, activity?: string): Promise<any>;
+    startApp(startCmd: string, workDirectory?: string, activity?: string): Promise<ProcessListResult>;
     /**
      * Stops an application by process name.
      *
@@ -4677,7 +4733,7 @@ declare class Computer {
      * }
      * ```
      */
-    stopAppByPName(pname: string): Promise<any>;
+    stopAppByPName(pname: string): Promise<BoolResult$1>;
     /**
      * Stops an application by process ID.
      *
@@ -4696,7 +4752,7 @@ declare class Computer {
      * }
      * ```
      */
-    stopAppByPID(pid: number): Promise<any>;
+    stopAppByPID(pid: number): Promise<BoolResult$1>;
     /**
      * Stops an application by stop command.
      *
@@ -4714,7 +4770,7 @@ declare class Computer {
      * }
      * ```
      */
-    stopAppByCmd(cmd: string): Promise<any>;
+    stopAppByCmd(cmd: string): Promise<BoolResult$1>;
     /**
      * Lists all visible applications.
      *
@@ -4731,7 +4787,7 @@ declare class Computer {
      * }
      * ```
      */
-    listVisibleApps(): Promise<any>;
+    listVisibleApps(): Promise<ProcessListResult>;
 }
 
 interface ContextStatusData {
@@ -4965,7 +5021,28 @@ declare class FileSystem {
      * }
      * ```
      */
-    createDirectory(path: string): Promise<BoolResult$2>;
+    createDirectory(path: string): Promise<BoolResult$1>;
+    /**
+     * Deletes a file at the specified path.
+     * Corresponds to Python's delete_file() method
+     *
+     * @param path - Path to the file to delete.
+     * @returns BoolResult with deletion result and requestId
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create();
+     * if (result.success) {
+     *   const session = result.session;
+     *   await session.fileSystem.writeFile('/tmp/to_delete.txt', 'hello');
+     *   const deleteResult = await session.fileSystem.deleteFile('/tmp/to_delete.txt');
+     *   console.log('File deleted:', deleteResult.success);
+     *   await session.delete();
+     * }
+     * ```
+     */
+    deleteFile(path: string): Promise<BoolResult$1>;
     /**
      * Edits a file by replacing occurrences of oldText with newText.
      * Corresponds to Python's edit_file() method
@@ -4991,7 +5068,7 @@ declare class FileSystem {
     editFile(path: string, edits: Array<{
         oldText: string;
         newText: string;
-    }>, dryRun?: boolean): Promise<BoolResult$2>;
+    }>, dryRun?: boolean): Promise<BoolResult$1>;
     /**
      * Gets information about a file or directory.
      * Corresponds to Python's get_file_info() method
@@ -5072,7 +5149,7 @@ declare class FileSystem {
      * }
      * ```
      */
-    moveFile(source: string, destination: string): Promise<BoolResult$2>;
+    moveFile(source: string, destination: string): Promise<BoolResult$1>;
     /**
      * Internal method to read a file chunk. Used for chunked file operations.
      *
@@ -5242,7 +5319,7 @@ declare class FileSystem {
      *
      * @see {@link readFile}, {@link listDirectory}
      */
-    writeFile(path: string, content: string, mode?: string): Promise<BoolResult$2>;
+    writeFile(path: string, content: string, mode?: string): Promise<BoolResult$1>;
     /**
      * Get file change information for the specified directory path
      *