wuying-agentbay-sdk 0.4.2 → 0.5.1

package/dist/index.d.mts

@@ -41,10 +41,13 @@ declare class CreateMcpSessionRequestPersistenceDataList extends $dara.Model {
 declare class CreateMcpSessionResponseBodyData extends $dara.Model {
     appInstanceId?: string;
     errMsg?: string;
+    httpPort?: string;
+    networkInterfaceIp?: string;
     resourceId?: string;
     resourceUrl?: string;
     sessionId?: string;
     success?: boolean;
+    vpcResource?: boolean;
     static names(): {
         [key: string]: string;
     };
@@ -304,6 +307,7 @@ declare class CreateMcpSessionRequest extends $dara.Model {
     labels?: string;
     persistenceDataList?: CreateMcpSessionRequestPersistenceDataList[];
     sessionId?: string;
+    vpcResource?: boolean;
     static names(): {
         [key: string]: string;
     };
@@ -324,6 +328,7 @@ declare class CreateMcpSessionShrinkRequest extends $dara.Model {
     labels?: string;
     persistenceDataListShrink?: string;
     sessionId?: string;
+    vpcResource?: boolean;
     static names(): {
         [key: string]: string;
     };
@@ -695,6 +700,85 @@ declare class GetMcpResourceResponse extends $dara.Model {
     });
 }
 
+declare class InitBrowserRequest extends $dara.Model {
+    authorization?: string;
+    persistentPath?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+    static fromMap(m: {
+        [key: string]: any;
+    }): InitBrowserRequest;
+}
+
+declare class InitBrowserResponseBodyData extends $dara.Model {
+    port?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+    static fromMap(m: {
+        [key: string]: any;
+    }): InitBrowserResponseBodyData;
+}
+
+declare class InitBrowserResponseBody extends $dara.Model {
+    code?: string;
+    data?: InitBrowserResponseBodyData;
+    httpStatusCode?: number;
+    message?: string;
+    requestId?: string;
+    success?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+    static fromMap(m: {
+        [key: string]: any;
+    }): InitBrowserResponseBody;
+}
+
+declare class InitBrowserResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: InitBrowserResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+    static fromMap(m: {
+        [key: string]: any;
+    }): InitBrowserResponse;
+}
+
 declare class ListContextsRequest extends $dara.Model {
     authorization?: string;
     maxResults?: number;
@@ -1299,6 +1383,28 @@ declare class Client extends OpenApi {
      * @returns SyncContextResponse
      */
     syncContext(request: SyncContextRequest): Promise<SyncContextResponse>;
+    /**
+     * 初始化浏览器
+     *
+     * @param tmpReq - InitBrowserRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns InitBrowserResponse
+     */
+    initBrowserWithOptions(request: InitBrowserRequest, runtime: $dara.RuntimeOptions): Promise<InitBrowserResponse>;
+    /**
+     * 初始化浏览器
+     *
+     * @param request - InitBrowserRequest
+     * @returns InitBrowserResponse
+     */
+    initBrowser(request: InitBrowserRequest): Promise<InitBrowserResponse>;
+    /**
+     * 初始化浏览器（同步版本）
+     *
+     * @param request - InitBrowserRequest
+     * @returns InitBrowserResponse
+     */
+    initBrowserSync(request: InitBrowserRequest): InitBrowserResponse;
 }
 
 interface Config {
@@ -1618,6 +1724,12 @@ interface ContextListResult extends ApiResponse {
     success: boolean;
     /** List of contexts */
     contexts: any[];
+    /** Token for the next page of results */
+    nextToken?: string;
+    /** Maximum number of results per page */
+    maxResults?: number;
+    /** Total number of contexts available */
+    totalCount?: number;
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
@@ -1662,6 +1774,20 @@ declare class Context {
      */
     constructor(id: string, name: string, state?: string, createdAt?: string, lastUsedAt?: string, osType?: string);
 }
+/**
+ * Parameters for listing contexts with pagination support.
+ */
+interface ContextListParams {
+    /**
+     * Maximum number of results per page.
+     * Defaults to 10 if not specified.
+     */
+    maxResults?: number;
+    /**
+     * Token for the next page of results.
+     */
+    nextToken?: string;
+}
 /**
  * Provides methods to manage persistent contexts in the AgentBay cloud environment.
  */
@@ -1674,12 +1800,13 @@ declare class ContextService {
      */
     constructor(agentBay: AgentBay);
     /**
-     * Lists all available contexts.
+     * Lists all available contexts with pagination support.
      * Corresponds to Python's list() method
      *
-     * @returns ContextListResult with contexts list and requestId
+     * @param params - Optional parameters for listing contexts.
+     * @returns ContextListResult with contexts list and pagination information
      */
-    list(): Promise<ContextListResult>;
+    list(params?: ContextListParams): Promise<ContextListResult>;
     /**
      * Gets a context by name. Optionally creates it if it doesn't exist.
      * Corresponds to Python's get() method
@@ -1746,6 +1873,15 @@ interface SyncPolicy {
     deletePolicy?: DeletePolicy;
     bwList?: BWList;
 }
+declare class SyncPolicyImpl implements SyncPolicy {
+    uploadPolicy?: UploadPolicy;
+    downloadPolicy?: DownloadPolicy;
+    deletePolicy?: DeletePolicy;
+    bwList?: BWList;
+    constructor(policy?: Partial<SyncPolicy>);
+    private ensureDefaults;
+    toJSON(): SyncPolicy;
+}
 declare class ContextSync {
     contextId: string;
     path: string;
@@ -1757,10 +1893,80 @@ declare function newUploadPolicy(): UploadPolicy;
 declare function newDownloadPolicy(): DownloadPolicy;
 declare function newDeletePolicy(): DeletePolicy;
 declare function newSyncPolicy(): SyncPolicy;
+declare function newSyncPolicyWithDefaults(policy?: Partial<SyncPolicy>): SyncPolicy;
 declare function newContextSync(contextId: string, path: string, policy?: SyncPolicy): ContextSync;
 
 /**
- * Represents an installed application.
+ * Result of task execution.
+ */
+interface ExecutionResult extends ApiResponse {
+    success: boolean;
+    errorMessage: string;
+    taskId: string;
+    taskStatus: string;
+}
+/**
+ * Result of query operations.
+ */
+interface QueryResult extends ApiResponse {
+    success: boolean;
+    output: string;
+    errorMessage: string;
+}
+/**
+ * Result of an MCP tool call.
+ */
+interface McpToolResult {
+    success: boolean;
+    data: string;
+    errorMessage: string;
+    requestId: string;
+}
+/**
+ * Interface defining the methods needed by Agent from Session.
+ */
+interface McpSession {
+    getAPIKey(): string;
+    getSessionId(): string;
+    callMcpTool(toolName: string, args: any): Promise<McpToolResult>;
+}
+/**
+ * An Agent to manipulate applications to complete specific tasks.
+ */
+declare class Agent {
+    private session;
+    /**
+     * Initialize an Agent object.
+     *
+     * @param session - The Session instance that this Agent belongs to.
+     */
+    constructor(session: McpSession);
+    /**
+     * Execute a specific task described in human language.
+     *
+     * @param task - Task description in human language.
+     * @param maxTryTimes - Maximum number of retry attempts.
+     * @returns ExecutionResult containing success status, task output, and error message if any.
+     */
+    executeTask(task: string, maxTryTimes: number): Promise<ExecutionResult>;
+    /**
+     * Get the status of the task with the given task ID.
+     *
+     * @param taskId - Task ID
+     * @returns QueryResult containing the task status
+     */
+    getTaskStatus(taskId: string): Promise<QueryResult>;
+    /**
+     * Terminate a task with a specified task ID.
+     *
+     * @param taskId - The ID of the running task.
+     * @returns ExecutionResult containing success status, task output, and error message if any.
+     */
+    terminateTask(taskId: string): Promise<ExecutionResult>;
+}
+
+/**
+ * Represents an installed application
  */
 interface InstalledApp {
     name: string;
@@ -1769,7 +1975,7 @@ interface InstalledApp {
     work_directory?: string;
 }
 /**
- * Represents a running process.
+ * Represents a running process
  */
 interface Process {
     pname: string;
@@ -1778,29 +1984,33 @@ interface Process {
     path?: string;
 }
 /**
- * Handles application management operations in the AgentBay cloud environment.
+ * Handles application operations in the AgentBay cloud environment.
  */
 declare class Application {
     private session;
     /**
-     * Creates a new Application instance.
-     * @param session The session object that provides access to the AgentBay API.
+     * Initialize an Application object.
+     *
+     * @param session - The Session instance that this Application belongs to.
      */
     constructor(session: {
         getAPIKey(): string;
         getClient(): Client;
         getSessionId(): string;
+        callMcpTool(toolName: string, args: any): Promise<{
+            success: boolean;
+            data: string;
+            errorMessage: string;
+            requestId: string;
+        }>;
     });
     /**
-     * Helper method to call MCP tools and handle common response processing
+     * Sanitizes error messages to remove sensitive information like API keys.
      *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
+     * @param error - The error to sanitize
+     * @returns The sanitized error
      */
-    private callMcpTool;
+    private sanitizeError;
     /**
      * Helper method to parse JSON string into objects
      */
@@ -1809,9 +2019,9 @@ declare class Application {
      * Retrieves a list of installed applications.
      * Corresponds to Python's get_installed_apps() method
      *
-     * @param startMenu Whether to include applications from the start menu. Defaults to true.
-     * @param desktop Whether to include applications from the desktop. Defaults to true.
-     * @param ignoreSystemApps Whether to ignore system applications. Defaults to true.
+     * @param startMenu - Whether to include applications from the start menu. Defaults to true.
+     * @param desktop - Whether to include applications from the desktop. Defaults to true.
+     * @param ignoreSystemApps - Whether to ignore system applications. Defaults to true.
      * @returns InstalledAppListResult with installed apps and requestId
      * @throws Error if the operation fails.
      */
@@ -1820,9 +2030,9 @@ declare class Application {
      * Starts an application with the given command and optional working directory.
      * Corresponds to Python's start_app() method
      *
-     * @param startCmd The command to start the application.
-     * @param workDirectory The working directory for the application. Defaults to an empty string.
-     * @param activity Activity name to launch (e.g. ".SettingsActivity" or "com.package/.Activity"). Defaults to an empty string.
+     * @param startCmd - The command to start the application.
+     * @param workDirectory - The working directory for the application. Defaults to an empty string.
+     * @param activity - Activity name to launch (e.g. ".SettingsActivity" or "com.package/.Activity"). Defaults to an empty string.
      * @returns ProcessListResult with started processes and requestId
      * @throws Error if the operation fails.
      */
@@ -1831,8 +2041,8 @@ declare class Application {
      * Stops an application by process name.
      * Corresponds to Python's stop_app_by_pname() method
      *
-     * @param pname The name of the process to stop.
-     * @returns AppOperationResult with requestId
+     * @param pname - The process name to stop.
+     * @returns AppOperationResult with operation result and requestId
      * @throws Error if the operation fails.
      */
     stopAppByPName(pname: string): Promise<AppOperationResult>;
@@ -1840,8 +2050,8 @@ declare class Application {
      * Stops an application by process ID.
      * Corresponds to Python's stop_app_by_pid() method
      *
-     * @param pid The ID of the process to stop.
-     * @returns AppOperationResult with requestId
+     * @param pid - The process ID to stop.
+     * @returns AppOperationResult with operation result and requestId
      * @throws Error if the operation fails.
      */
     stopAppByPID(pid: number): Promise<AppOperationResult>;
@@ -1849,28 +2059,59 @@ declare class Application {
      * Stops an application by stop command.
      * Corresponds to Python's stop_app_by_cmd() method
      *
-     * @param stopCmd The command to stop the application.
-     * @returns AppOperationResult with requestId
+     * @param stopCmd - The stop command to execute.
+     * @returns AppOperationResult with operation result and requestId
      * @throws Error if the operation fails.
      */
     stopAppByCmd(stopCmd: string): Promise<AppOperationResult>;
     /**
-     * Lists all currently visible applications.
+     * Returns a list of currently visible applications.
      * Corresponds to Python's list_visible_apps() method
      *
-     * @returns ProcessListResult with visible processes and requestId
+     * @returns ProcessListResult with visible apps and requestId
      * @throws Error if the operation fails.
      */
     listVisibleApps(): Promise<ProcessListResult>;
 }
 
+/**
+ * Handles code execution operations in the AgentBay cloud environment.
+ */
+declare class Code {
+    private session;
+    /**
+     * Initialize a Code object.
+     *
+     * @param session - The Session instance that this Code belongs to.
+     */
+    constructor(session: {
+        getAPIKey(): string;
+        getSessionId(): string;
+        callMcpTool(toolName: string, args: any): Promise<{
+            success: boolean;
+            data: string;
+            errorMessage: string;
+            requestId: string;
+        }>;
+    });
+    /**
+     * Execute code in the specified language with a timeout.
+     * Corresponds to Python's run_code() method
+     *
+     * @param code - The code to execute.
+     * @param language - The programming language of the code. Must be either 'python' or 'javascript'.
+     * @param timeoutS - The timeout for the code execution in seconds. Default is 300s.
+     * @returns CodeExecutionResult with code execution output and requestId
+     * @throws Error if an unsupported language is specified.
+     */
+    runCode(code: string, language: string, timeoutS?: number): Promise<CodeExecutionResult>;
+}
+
 /**
  * Handles command execution operations in the AgentBay cloud environment.
  */
 declare class Command {
     private session;
-    private client;
-    private baseUrl;
     /**
      * Initialize a Command object.
      *
@@ -1878,35 +2119,22 @@ declare class Command {
      */
     constructor(session: Session);
     /**
-     * Helper method to call MCP tools and handle common response processing
+     * Sanitizes error messages to remove sensitive information like API keys.
      *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
+     * @param error - The error to sanitize
+     * @returns The sanitized error
      */
-    private callMcpTool;
+    private sanitizeError;
     /**
-     * Execute a command in the cloud environment with a specified timeout.
+     * Execute a command in the session environment.
      * Corresponds to Python's execute_command() method
      *
-     * @param command - The command to execute.
-     * @param timeoutMs - The timeout for the command execution in milliseconds. Default is 1000ms.
+     * @param command - The command to execute
+     * @param timeoutMs - The timeout in milliseconds. Default is 1000ms.
      * @returns CommandResult with command output and requestId
+     * @throws APIError if the operation fails.
      */
     executeCommand(command: string, timeoutMs?: number): Promise<CommandResult>;
-    /**
-     * Execute code in the specified language with a timeout.
-     * Corresponds to Python's run_code() method
-     *
-     * @param code - The code to execute.
-     * @param language - The programming language of the code. Must be either 'python' or 'javascript'.
-     * @param timeoutS - The timeout for the code execution in seconds. Default is 300s.
-     * @returns CodeExecutionResult with code execution output and requestId
-     * @throws Error if an unsupported language is specified.
-     */
-    runCode(code: string, language: string, timeoutS?: number): Promise<CodeExecutionResult>;
 }
 
 interface ContextStatusData {
@@ -1968,24 +2196,21 @@ interface DirectoryEntry {
  */
 declare class FileSystem {
     private session;
-    private client;
-    private baseUrl;
     /**
      * Initialize a FileSystem object.
      *
      * @param session - The Session instance that this FileSystem belongs to.
      */
-    constructor(session: Session);
-    /**
-     * Helper method to call MCP tools and handle common response processing
-     *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
-     */
-    private callMcpTool;
+    constructor(session: {
+        getAPIKey(): string;
+        getSessionId(): string;
+        callMcpTool(toolName: string, args: any): Promise<{
+            success: boolean;
+            data: string;
+            errorMessage: string;
+            requestId: string;
+        }>;
+    });
     /**
      * Creates a new directory at the specified path.
      * Corresponds to Python's create_directory() method
@@ -2037,8 +2262,8 @@ declare class FileSystem {
      * Corresponds to Python's read_file() method
      *
      * @param path - Path to the file to read.
-     * @param offset - Optional: Line offset to start reading from.
-     * @param length - Optional: Number of lines to read. If 0, reads the entire file.
+     * @param offset - Optional: Byte offset to start reading from (0-based).
+     * @param length - Optional: Number of bytes to read. If 0, reads the entire file from offset.
      * @returns FileContentResult with file content and requestId
      */
     readFile(path: string, offset?: number, length?: number): Promise<FileContentResult>;
@@ -2092,12 +2317,10 @@ declare class FileSystem {
 }
 
 /**
- * Handles Object Storage Service operations in the AgentBay cloud environment.
+ * Handles OSS operations in the AgentBay cloud environment.
  */
 declare class Oss {
     private session;
-    private client;
-    private baseUrl;
     /**
      * Initialize an Oss object.
      *
@@ -2105,67 +2328,80 @@ declare class Oss {
      */
     constructor(session: Session);
     /**
-     * Helper method to call MCP tools and handle common response processing
+     * Sanitizes error messages to remove sensitive information like API keys.
      *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
+     * @param error - The error to sanitize
+     * @returns The sanitized error
      */
-    private callMcpTool;
+    private sanitizeError;
     /**
      * Initialize OSS environment variables with the specified credentials.
      * Corresponds to Python's env_init() method
      *
-     * @param accessKeyId - The Access Key ID for OSS authentication.
-     * @param accessKeySecret - The Access Key Secret for OSS authentication.
-     * @param securityToken - The security token for OSS authentication.
-     * @param endpoint - The OSS service endpoint. If not specified, the default is used.
-     * @param region - The OSS region. If not specified, the default is used.
-     * @returns OSSClientResult with initialization result and requestId
+     * @param accessKeyId - The access key ID
+     * @param accessKeySecret - The access key secret
+     * @param securityToken - The security token (optional)
+     * @param endpoint - The OSS endpoint (optional)
+     * @param region - The OSS region (optional)
+     * @returns OSSClientResult with client configuration and requestId
+     * @throws APIError if the operation fails.
      */
     envInit(accessKeyId: string, accessKeySecret: string, securityToken?: string, endpoint?: string, region?: string): Promise<OSSClientResult>;
     /**
-     * Upload a local file or directory to OSS.
+     * Upload a file to OSS.
      * Corresponds to Python's upload() method
      *
-     * @param bucket - OSS bucket name.
-     * @param object - ObjectS.
-     * @param path - Local file or directory path to upload.
+     * @param bucket - The OSS bucket name
+     * @param object - The OSS object key
+     * @param path - The local file path to upload
      * @returns OSSUploadResult with upload result and requestId
+     * @throws APIError if the operation fails.
      */
     upload(bucket: string, object: string, path: string): Promise<OSSUploadResult>;
     /**
-     * Upload a local file or directory to OSS using a pre-signed URL.
+     * Upload a file to OSS using an anonymous URL.
      * Corresponds to Python's upload_anonymous() method
      *
-     * @param url - Pre-signed URL for anonymous upload.
-     * @param path - Local file or directory path to upload.
+     * @param url - The anonymous upload URL
+     * @param path - The local file path to upload
      * @returns OSSUploadResult with upload result and requestId
+     * @throws APIError if the operation fails.
      */
     uploadAnonymous(url: string, path: string): Promise<OSSUploadResult>;
     /**
-     * Download an object from OSS to a local file or directory.
+     * Download a file from OSS.
      * Corresponds to Python's download() method
      *
-     * @param bucket - OSS bucket name.
-     * @param object - Object key in OSS.
-     * @param path - Local file or directory path to save the downloaded content.
+     * @param bucket - The OSS bucket name
+     * @param object - The OSS object key
+     * @param path - The local file path to save the downloaded file
      * @returns OSSDownloadResult with download result and requestId
+     * @throws APIError if the operation fails.
      */
     download(bucket: string, object: string, path: string): Promise<OSSDownloadResult>;
     /**
-     * Download an object from OSS using a pre-signed URL.
+     * Download a file from OSS using an anonymous URL.
      * Corresponds to Python's download_anonymous() method
      *
-     * @param url - Pre-signed URL for anonymous download.
-     * @param path - Local file or directory path to save the downloaded content.
+     * @param url - The anonymous download URL
+     * @param path - The local file path to save the downloaded file
      * @returns OSSDownloadResult with download result and requestId
+     * @throws APIError if the operation fails.
      */
     downloadAnonymous(url: string, path: string): Promise<OSSDownloadResult>;
 }
 
+/**
+ * Key codes for UI operations
+ */
+declare enum KeyCode {
+    HOME = 3,
+    BACK = 4,
+    VOLUME_UP = 24,
+    VOLUME_DOWN = 25,
+    POWER = 26,
+    MENU = 82
+}
 /**
  * Interface representing a UI element in the UI hierarchy
  */
@@ -2180,18 +2416,7 @@ interface UIElement {
     children?: UIElement[];
 }
 /**
- * KeyCode constants for mobile device input
- */
-declare const KeyCode: {
-    HOME: number;
-    BACK: number;
-    VOLUME_UP: number;
-    VOLUME_DOWN: number;
-    POWER: number;
-    MENU: number;
-};
-/**
- * UI handles UI operations in the AgentBay cloud environment.
+ * Handles UI operations in the AgentBay cloud environment.
  */
 declare class UI {
     private session;
@@ -2200,76 +2425,96 @@ declare class UI {
      *
      * @param session - The Session instance that this UI belongs to.
      */
-    constructor(session: Session);
+    constructor(session: {
+        getAPIKey(): string;
+        getClient(): any;
+        getSessionId(): string;
+        callMcpTool(toolName: string, args: any): Promise<{
+            success: boolean;
+            data: string;
+            errorMessage: string;
+            requestId: string;
+        }>;
+    });
     /**
-     * Helper method to call MCP tools and handle common response processing
+     * Sanitizes error messages to remove sensitive information like API keys.
      *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
+     * @param error - The error to sanitize
+     * @returns The sanitized error
      */
-    private callMcpTool;
+    private sanitizeError;
     /**
      * Retrieves all clickable UI elements within the specified timeout.
      * Corresponds to Python's get_clickable_ui_elements() method
      *
      * @param timeoutMs - The timeout in milliseconds. Default is 2000ms.
      * @returns UIElementListResult with clickable UI elements and requestId
+     * @throws APIError if the operation fails.
      */
     getClickableUIElements(timeoutMs?: number): Promise<UIElementListResult>;
     /**
-     * Retrieves all UI elements within the specified timeout.
+     * Retrieves all UI elements regardless of their clickable status.
      * Corresponds to Python's get_all_ui_elements() method
      *
      * @param timeoutMs - The timeout in milliseconds. Default is 2000ms.
      * @returns UIElementListResult with all UI elements and requestId
+     * @throws APIError if the operation fails.
      */
     getAllUIElements(timeoutMs?: number): Promise<UIElementListResult>;
     /**
      * Sends a key press event.
      * Corresponds to Python's send_key() method
      *
-     * @param key - The key code to send.
-     * @returns BoolResult with key press result and requestId
+     * @param key - The key code to send. Supported key codes are:
+     *   - 3 : HOME
+     *   - 4 : BACK
+     *   - 24 : VOLUME UP
+     *   - 25 : VOLUME DOWN
+     *   - 26 : POWER
+     *   - 82 : MENU
+     * @returns BoolResult with success status and requestId
+     * @throws APIError if the operation fails.
      */
     sendKey(key: number): Promise<BoolResult>;
     /**
-     * Inputs text into the active field.
+     * Inputs text into the currently focused UI element.
      * Corresponds to Python's input_text() method
      *
-     * @param text - The text to input.
-     * @returns BoolResult with input result and requestId
+     * @param text - The text to input
+     * @returns BoolResult with success status and requestId
+     * @throws APIError if the operation fails.
      */
     inputText(text: string): Promise<BoolResult>;
     /**
      * Performs a swipe gesture on the screen.
      * Corresponds to Python's swipe() method
      *
-     * @param startX - The starting X coordinate.
-     * @param startY - The starting Y coordinate.
-     * @param endX - The ending X coordinate.
-     * @param endY - The ending Y coordinate.
+     * @param startX - The starting X coordinate
+     * @param startY - The starting Y coordinate
+     * @param endX - The ending X coordinate
+     * @param endY - The ending Y coordinate
      * @param durationMs - The duration of the swipe in milliseconds. Default is 300ms.
-     * @returns BoolResult with swipe result and requestId
+     * @returns BoolResult with success status and requestId
+     * @throws APIError if the operation fails.
      */
     swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<BoolResult>;
     /**
-     * Performs a click at the specified coordinates.
+     * Clicks on the screen at the specified coordinates.
      * Corresponds to Python's click() method
      *
-     * @param x - The X coordinate.
-     * @param y - The Y coordinate.
-     * @param button - The mouse button to click. Default is 'left'.
-     * @returns BoolResult with click result and requestId
+     * @param x - The X coordinate
+     * @param y - The Y coordinate
+     * @param button - The mouse button to use. Default is 'left'
+     * @returns BoolResult with success status and requestId
+     * @throws APIError if the operation fails.
      */
     click(x: number, y: number, button?: string): Promise<BoolResult>;
     /**
      * Takes a screenshot of the current screen.
      * Corresponds to Python's screenshot() method
      *
-     * @returns OperationResult with screenshot data and requestId
+     * @returns OperationResult with success status and requestId
+     * @throws APIError if the operation fails.
      */
     screenshot(): Promise<OperationResult>;
 }
@@ -2285,19 +2530,14 @@ declare class WindowManager {
      */
     constructor(session: {
         getAPIKey(): string;
-        getClient(): any;
         getSessionId(): string;
+        callMcpTool(toolName: string, args: any): Promise<{
+            success: boolean;
+            data: string;
+            errorMessage: string;
+            requestId: string;
+        }>;
     });
-    /**
-     * Helper method to call MCP tools and handle common response processing
-     *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
-     */
-    private callMcpTool;
     /**
      * Helper method to parse JSON string into Window objects
      * @param jsonStr - JSON string to parse
@@ -2388,6 +2628,124 @@ declare class WindowManager {
     focusMode(on: boolean): Promise<BoolResult>;
 }
 
+interface ActOptions {
+    action: string;
+    timeoutMS?: number;
+    iframes?: boolean;
+    domSettleTimeoutMS?: number;
+}
+interface ObserveOptions {
+    instruction: string;
+    returnActions?: number;
+    iframes?: boolean;
+    domSettleTimeoutMS?: number;
+}
+interface ExtractOptions<T = any> {
+    instruction: string;
+    schema: new (...args: any[]) => T;
+    selector?: string;
+    iframe?: boolean;
+    domSettleTimeoutsMS?: number;
+}
+declare class ActResult {
+    success: boolean;
+    message: string;
+    action: string;
+    constructor(success: boolean, message: string, action: string);
+}
+declare class ObserveResult {
+    selector: string;
+    description: string;
+    method: string;
+    args: Record<string, any>;
+    constructor(selector: string, description: string, method: string, args: Record<string, any>);
+}
+declare class BrowserAgent {
+    private session;
+    private browser;
+    constructor(session: Session, browser: Browser);
+    /**
+     * Perform an action on the given Playwright Page object, using ActOptions to configure behavior.
+     * Returns the result of the action.
+     */
+    act(page: any, options: ActOptions): Promise<ActResult>;
+    /**
+     * Async version of act method for performing actions on the given Playwright Page object.
+     */
+    actAsync(page: any, options: ActOptions): Promise<ActResult>;
+    /**
+     * Observe elements or state on the given Playwright Page object.
+     * Returns a tuple containing (success, results).
+     */
+    observe(page: any, options: ObserveOptions): Promise<[boolean, ObserveResult[]]>;
+    /**
+     * Async version of observe method.
+     */
+    observeAsync(page: any, options: ObserveOptions): Promise<[boolean, ObserveResult[]]>;
+    /**
+     * Extract information from the given Playwright Page object.
+     */
+    extract<T>(page: any, options: ExtractOptions<T>): Promise<[boolean, T[]]>;
+    /**
+     * Async version of extract method.
+     */
+    extractAsync<T>(page: any, options: ExtractOptions<T>): Promise<[boolean, T[]]>;
+    private _getPageAndContextIndex;
+    private _getPageAndContextIndexAsync;
+    private _callMcpTool;
+}
+
+interface BrowserOption {
+    persistentPath?: string;
+}
+declare class Browser {
+    private session;
+    private _endpointUrl;
+    private _initialized;
+    private _option;
+    agent: BrowserAgent;
+    constructor(session: Session);
+    /**
+     * Initialize the browser instance with the given options.
+     * Returns true if successful, false otherwise.
+     */
+    initialize(option: BrowserOption): boolean;
+    /**
+     * Initialize the browser instance with the given options asynchronously.
+     * Returns true if successful, false otherwise.
+     */
+    initializeAsync(option: BrowserOption): Promise<boolean>;
+    /**
+     * Returns the endpoint URL if the browser is initialized, otherwise throws an exception.
+     * When initialized, always fetches the latest CDP url from session.getLink().
+     */
+    getEndpointUrl(): Promise<string>;
+    /**
+     * Returns the current BrowserOption used to initialize the browser, or null if not set.
+     */
+    getOption(): BrowserOption | null;
+    /**
+     * Returns true if the browser was initialized, false otherwise.
+     */
+    isInitialized(): boolean;
+}
+
+/**
+ * Represents an MCP tool with complete information.
+ */
+interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, any>;
+    server: string;
+    tool: string;
+}
+/**
+ * Result containing MCP tools list and request ID.
+ */
+interface McpToolsResult extends OperationResult {
+    tools: McpTool[];
+}
 /**
  * Represents a session in the AgentBay cloud environment.
  */
@@ -2395,13 +2753,20 @@ declare class Session {
     private agentBay;
     sessionId: string;
     resourceUrl: string;
+    isVpc: boolean;
+    networkInterfaceIp: string;
+    httpPort: string;
     fileSystem: FileSystem;
     command: Command;
+    code: Code;
     oss: Oss;
     application: Application;
     window: WindowManager;
     ui: UI;
+    agent: Agent;
+    browser: Browser;
     context: ContextManager;
+    mcpTools: McpTool[];
     /**
      * Initialize a Session object.
      *
@@ -2421,6 +2786,22 @@ declare class Session {
      * Return the session_id for this session.
      */
     getSessionId(): string;
+    /**
+     * Return whether this session uses VPC resources.
+     */
+    isVpcEnabled(): boolean;
+    /**
+     * Return the network interface IP for VPC sessions.
+     */
+    getNetworkInterfaceIp(): string;
+    /**
+     * Return the HTTP port for VPC sessions.
+     */
+    getHttpPort(): string;
+    /**
+     * Find the server that provides the given tool.
+     */
+    findServerForTool(toolName: string): string;
     /**
      * Delete this session.
      *
@@ -2428,6 +2809,13 @@ declare class Session {
      * @returns DeleteResult indicating success or failure and request ID
      */
     delete(syncContext?: boolean): Promise<DeleteResult>;
+    /**
+     * Validates labels parameter for label operations.
+     *
+     * @param labels - The labels to validate
+     * @returns null if validation passes, or OperationResult with error if validation fails
+     */
+    private validateLabels;
     /**
      * Sets the labels for this session.
      *
@@ -2468,7 +2856,140 @@ declare class Session {
      * @throws Error if the operation fails (matching Python SessionError)
      */
     getLinkAsync(protocolType?: string, port?: number): Promise<OperationResult>;
+    /**
+     * List MCP tools available for this session.
+     *
+     * @param imageId Optional image ID, defaults to session's imageId or "linux_latest"
+     * @returns McpToolsResult containing tools list and request ID
+     */
+    listMcpTools(imageId?: string): Promise<McpToolsResult>;
+    /**
+     * Call an MCP tool and return the result in a format compatible with Agent.
+     *
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @returns McpToolResult containing the response data
+     */
+    callMcpTool(toolName: string, args: any): Promise<McpToolResult>;
+}
+
+/**
+ * Browser context configuration for session.
+ */
+interface BrowserContext {
+    /** ID of the browser context to bind to the session */
+    contextId: string;
+    /** Whether to automatically upload browser data when the session ends */
+    autoUpload: boolean;
+}
+/**
+ * Configuration interface for CreateSessionParams
+ */
+interface CreateSessionParamsConfig {
+    labels: Record<string, string>;
+    /**
+     * @deprecated This field is deprecated and will be removed in a future version.
+     * Please use contextSync instead for more flexible and powerful data persistence.
+     */
+    contextId?: string;
+    imageId?: string;
+    contextSync: ContextSync[];
+    /** Optional configuration for browser data synchronization */
+    browserContext?: BrowserContext;
+    /** Whether to create a VPC-based session. Defaults to false. */
+    isVpc?: boolean;
+}
+/**
+ * CreateSessionParams provides a way to configure the parameters for creating a new session
+ * in the AgentBay cloud environment.
+ */
+declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
+    /** Custom labels for the Session. These can be used for organizing and filtering sessions. */
+    labels: Record<string, string>;
+    /**
+     * ID of the context to bind to the session.
+     * The context can include various types of persistence like file system (volume) and cookies.
+     *
+     * @deprecated This field is deprecated and will be removed in a future version.
+     * Please use contextSync instead for more flexible and powerful data persistence.
+     *
+     * Important Limitations:
+     * 1. One session at a time: A context can only be used by one session at a time.
+     *    If you try to create a session with a context ID that is already in use by another active session,
+     *    the session creation will fail.
+     *
+     * 2. OS binding: A context is bound to the operating system of the first session that uses it.
+     *    When a context is first used with a session, it becomes bound to that session's OS.
+     *    Any attempt to use the context with a session running on a different OS will fail.
+     *    For example, if a context is first used with a Linux session, it cannot later be used
+     *    with a Windows or Android session.
+     */
+    contextId?: string;
+    /** Image ID to use for the session. */
+    imageId?: string;
+    /**
+     * List of context synchronization configurations.
+     * These configurations define how contexts should be synchronized and mounted.
+     */
+    contextSync: ContextSync[];
+    /** Optional configuration for browser data synchronization. */
+    browserContext?: BrowserContext;
+    /** Whether to create a VPC-based session. Defaults to false. */
+    isVpc: boolean;
+    constructor();
+    /**
+     * WithLabels sets the labels for the session parameters and returns the updated parameters.
+     */
+    withLabels(labels: Record<string, string>): CreateSessionParams$1;
+    /**
+     * WithContextID sets the context ID for the session parameters and returns the updated parameters.
+     */
+    withContextID(contextId: string): CreateSessionParams$1;
+    /**
+     * WithImageId sets the image ID for the session parameters and returns the updated parameters.
+     */
+    withImageId(imageId: string): CreateSessionParams$1;
+    /**
+     * WithBrowserContext sets the browser context for the session parameters and returns the updated parameters.
+     */
+    withBrowserContext(browserContext: BrowserContext): CreateSessionParams$1;
+    /**
+     * WithIsVpc sets the VPC flag for the session parameters and returns the updated parameters.
+     */
+    withIsVpc(isVpc: boolean): CreateSessionParams$1;
+    /**
+     * GetLabelsJSON returns the labels as a JSON string.
+     * Returns an object with success status and result/error message to match Go version behavior.
+     */
+    getLabelsJSON(): {
+        result: string;
+        error?: string;
+    };
+    /**
+     * AddContextSync adds a context sync configuration to the session parameters.
+     */
+    addContextSync(contextId: string, path: string, policy?: SyncPolicy): CreateSessionParams$1;
+    /**
+     * AddContextSyncConfig adds a pre-configured context sync to the session parameters.
+     */
+    addContextSyncConfig(contextSync: ContextSync): CreateSessionParams$1;
+    /**
+     * WithContextSync sets the context sync configurations for the session parameters.
+     */
+    withContextSync(contextSyncs: ContextSync[]): CreateSessionParams$1;
+    /**
+     * Convert to plain object for JSON serialization
+     */
+    toJSON(): CreateSessionParamsConfig;
+    /**
+     * Create from plain object
+     */
+    static fromJSON(config: CreateSessionParamsConfig): CreateSessionParams$1;
 }
+/**
+ * NewCreateSessionParams creates a new CreateSessionParams with default values.
+ */
+declare function newCreateSessionParams(): CreateSessionParams$1;
 
 /**
  * Parameters for listing sessions with pagination support
@@ -2499,11 +3020,13 @@ interface SessionListResult extends ApiResponse {
 /**
  * Parameters for creating a session.
  */
-interface CreateSessionParams$1 {
+interface CreateSessionParams {
     contextId?: string;
     labels?: Record<string, string>;
     imageId?: string;
     contextSync?: ContextSync[];
+    browserContext?: BrowserContext;
+    isVpc?: boolean;
 }
 /**
  * Main class for interacting with the AgentBay cloud runtime environment.
@@ -2535,7 +3058,7 @@ declare class AgentBay {
      * @param params - Optional parameters for creating the session
      * @returns SessionResult containing the created session and request ID
      */
-    create(params?: CreateSessionParams$1): Promise<SessionResult>;
+    create(params?: CreateSessionParams): Promise<SessionResult>;
     /**
      * List all available sessions.
      *
@@ -2625,99 +3148,12 @@ declare class ApplicationError extends AgentBayError {
 declare class UIError extends AgentBayError {
     constructor(message?: string, extra?: Record<string, any>);
 }
-
 /**
- * Configuration interface for CreateSessionParams
+ * Raised for errors related to browser operations.
  */
-interface CreateSessionParamsConfig {
-    labels: Record<string, string>;
-    /**
-     * @deprecated This field is deprecated and will be removed in a future version.
-     * Please use contextSync instead for more flexible and powerful data persistence.
-     */
-    contextId?: string;
-    imageId?: string;
-    contextSync: ContextSync[];
-}
-/**
- * CreateSessionParams provides a way to configure the parameters for creating a new session
- * in the AgentBay cloud environment.
- */
-declare class CreateSessionParams implements CreateSessionParamsConfig {
-    /** Custom labels for the Session. These can be used for organizing and filtering sessions. */
-    labels: Record<string, string>;
-    /**
-     * ID of the context to bind to the session.
-     * The context can include various types of persistence like file system (volume) and cookies.
-     *
-     * @deprecated This field is deprecated and will be removed in a future version.
-     * Please use contextSync instead for more flexible and powerful data persistence.
-     *
-     * Important Limitations:
-     * 1. One session at a time: A context can only be used by one session at a time.
-     *    If you try to create a session with a context ID that is already in use by another active session,
-     *    the session creation will fail.
-     *
-     * 2. OS binding: A context is bound to the operating system of the first session that uses it.
-     *    When a context is first used with a session, it becomes bound to that session's OS.
-     *    Any attempt to use the context with a session running on a different OS will fail.
-     *    For example, if a context is first used with a Linux session, it cannot later be used
-     *    with a Windows or Android session.
-     */
-    contextId?: string;
-    /** Image ID to use for the session. */
-    imageId?: string;
-    /**
-     * List of context synchronization configurations.
-     * These configurations define how contexts should be synchronized and mounted.
-     */
-    contextSync: ContextSync[];
-    constructor();
-    /**
-     * WithLabels sets the labels for the session parameters and returns the updated parameters.
-     */
-    withLabels(labels: Record<string, string>): CreateSessionParams;
-    /**
-     * WithContextID sets the context ID for the session parameters and returns the updated parameters.
-     */
-    withContextID(contextId: string): CreateSessionParams;
-    /**
-     * WithImageId sets the image ID for the session parameters and returns the updated parameters.
-     */
-    withImageId(imageId: string): CreateSessionParams;
-    /**
-     * GetLabelsJSON returns the labels as a JSON string.
-     * Returns an object with success status and result/error message to match Go version behavior.
-     */
-    getLabelsJSON(): {
-        result: string;
-        error?: string;
-    };
-    /**
-     * AddContextSync adds a context sync configuration to the session parameters.
-     */
-    addContextSync(contextId: string, path: string, policy?: SyncPolicy): CreateSessionParams;
-    /**
-     * AddContextSyncConfig adds a pre-configured context sync to the session parameters.
-     */
-    addContextSyncConfig(contextSync: ContextSync): CreateSessionParams;
-    /**
-     * WithContextSync sets the context sync configurations for the session parameters.
-     */
-    withContextSync(contextSyncs: ContextSync[]): CreateSessionParams;
-    /**
-     * Convert to plain object for JSON serialization
-     */
-    toJSON(): CreateSessionParamsConfig;
-    /**
-     * Create from plain object
-     */
-    static fromJSON(config: CreateSessionParamsConfig): CreateSessionParams;
+declare class BrowserError extends AgentBayError {
+    constructor(message?: string, extra?: Record<string, any>);
 }
-/**
- * NewCreateSessionParams creates a new CreateSessionParams with default values.
- */
-declare function newCreateSessionParams(): CreateSessionParams;
 
 /**
  * Utility functions for logging in a clean format
@@ -2735,4 +3171,4 @@ declare function log(message: string, ...args: any[]): void;
  */
 declare function logError(message: string, error?: any): void;
 
-export { APIError, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams$1 as CreateSessionParams, type CreateSessionParamsConfig, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, FileError, type FileInfo, FileSystem, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, type InstalledApp, KeyCode, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, Oss, OssError, type Process, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SessionError, type SessionInterface, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, UI, type UIElement, UIError, type UploadPolicy, UploadStrategy, type WhiteList, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newSyncPolicy, newUploadPolicy };
+export { APIError, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, Browser, BrowserAgent, type BrowserContext, BrowserError, type BrowserOption, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, type ExtractOptions, FileError, type FileInfo, FileSystem, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, type InstalledApp, KeyCode, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type McpSession, type McpToolResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type ObserveOptions, ObserveResult, Oss, OssError, type Process, type QueryResult, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SessionError, type SessionInterface, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UI, type UIElement, UIError, type UploadPolicy, UploadStrategy, type WhiteList, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy };