wuying-agentbay-sdk 0.8.0 → 0.9.1

package/dist/index.d.mts

@@ -47,6 +47,7 @@ declare class CreateMcpSessionResponseBodyData extends $dara.Model {
     resourceUrl?: string;
     sessionId?: string;
     success?: boolean;
+    token?: string;
     vpcResource?: boolean;
     static names(): {
         [key: string]: string;
@@ -107,6 +108,28 @@ declare class GetLabelResponseBodyData extends $dara.Model {
     });
 }
 
+declare class GetSessionResponseBodyData extends $dara.Model {
+    appInstanceId?: string;
+    resourceId?: string;
+    sessionId?: string;
+    success?: boolean;
+    httpPort?: string;
+    networkInterfaceIp?: string;
+    token?: string;
+    vpcResource?: boolean;
+    resourceUrl?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class GetLinkResponseBodyData extends $dara.Model {
     url?: string;
     static names(): {
@@ -177,6 +200,7 @@ declare class ListContextsResponseBodyData extends $dara.Model {
 
 declare class ListSessionResponseBodyData extends $dara.Model {
     sessionId?: string;
+    sessionStatus?: string;
     static names(): {
         [key: string]: string;
     };
@@ -596,6 +620,58 @@ declare class GetLabelResponse extends $dara.Model {
     });
 }
 
+declare class GetSessionRequest extends $dara.Model {
+    authorization?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetSessionResponseBody extends $dara.Model {
+    code?: string;
+    data?: GetSessionResponseBodyData;
+    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;
+    });
+}
+
+declare class GetSessionResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetSessionResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class GetLinkRequest extends $dara.Model {
     authorization?: string;
     port?: number;
@@ -1515,6 +1591,21 @@ declare class Client extends OpenApi {
      * @returns GetLabelResponse
      */
     getLabel(request: GetLabelRequest): Promise<GetLabelResponse>;
+    /**
+     * Get session information
+     *
+     * @param request - GetSessionRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetSessionResponse
+     */
+    getSessionWithOptions(request: GetSessionRequest, runtime: $dara.RuntimeOptions): Promise<GetSessionResponse>;
+    /**
+     * Get session information
+     *
+     * @param request - GetSessionRequest
+     * @returns GetSessionResponse
+     */
+    getSession(request: GetSessionRequest): Promise<GetSessionResponse>;
     /**
      * Get forwarding link for specific port
      *
@@ -1735,13 +1826,13 @@ declare class Client extends OpenApi {
 }
 
 interface Config {
-    region_id: string;
     endpoint: string;
     timeout_ms: number;
 }
 /**
  * Load .env file into process.env if it exists
  * This function should be called early to ensure .env variables are available
+ * @deprecated Use loadDotEnvWithFallback instead
  */
 declare function loadDotEnv(): void;
 /**
@@ -1751,7 +1842,14 @@ declare function loadDotEnv(): void;
  * 3. .env file.
  * 4. Default configuration.
  */
-declare function loadConfig(customConfig?: Config): Config;
+/**
+ * Load configuration with improved .env file search.
+ *
+ * @param customConfig Configuration object (if provided, skips env loading)
+ * @param customEnvPath Custom path to .env file (optional)
+ * @returns Configuration object
+ */
+declare function loadConfig(customConfig?: Config, customEnvPath?: string): Config;
 
 /**
  * Base interface for API responses
@@ -1773,6 +1871,46 @@ interface DeleteResult extends ApiResponse {
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+/**
+ * Interface for GetSession data
+ */
+interface GetSessionData {
+    /** Application instance ID */
+    appInstanceId: string;
+    /** Resource ID */
+    resourceId: string;
+    /** Session ID */
+    sessionId: string;
+    /** Success status */
+    success: boolean;
+    /** HTTP port for VPC sessions */
+    httpPort: string;
+    /** Network interface IP for VPC sessions */
+    networkInterfaceIp: string;
+    /** Token for VPC sessions */
+    token: string;
+    /** Whether this session uses VPC resources */
+    vpcResource: boolean;
+    /** Resource URL for accessing the session */
+    resourceUrl: string;
+}
+/**
+ * Interface for GetSession operation responses
+ */
+interface GetSessionResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** HTTP status code */
+    httpStatusCode: number;
+    /** Response code */
+    code: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Session data */
+    data?: GetSessionData;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
 /**
  * Interface for session creation operation responses
  * Corresponds to Python's SessionResult type
@@ -1873,7 +2011,7 @@ interface CodeExecutionResult extends ApiResponse {
  * Interface for boolean operation responses
  * Corresponds to Python's BoolResult type
  */
-interface BoolResult extends ApiResponse {
+interface BoolResult$2 extends ApiResponse {
     /** Request identifier for tracking API calls */
     requestId: string;
     /** Whether the operation was successful */
@@ -2130,7 +2268,7 @@ declare class Context {
      */
     name: string;
     /**
-     * The current state of the context (e.g., "available", "in-use").
+     * @deprecated This field is no longer used and will be removed in a future version.
      */
     state: string;
     /**
@@ -2142,7 +2280,7 @@ declare class Context {
      */
     lastUsedAt?: string;
     /**
-     * The operating system type this context is bound to.
+     * @deprecated This field is no longer used and will be removed in a future version.
      */
     osType?: string;
     /**
@@ -2150,10 +2288,10 @@ declare class Context {
      *
      * @param id - The unique identifier of the context.
      * @param name - The name of the context.
-     * @param state - The current state of the context.
+     * @param state - **Deprecated.** This parameter is no longer used.
      * @param createdAt - Date and time when the Context was created.
      * @param lastUsedAt - Date and time when the Context was last used.
-     * @param osType - The operating system type this context is bound to.
+     * @param osType - **Deprecated.** This parameter is no longer used.
      */
     constructor(id: string, name: string, state?: string, createdAt?: string, lastUsedAt?: string, osType?: string);
 }
@@ -2247,10 +2385,21 @@ declare enum UploadStrategy {
 declare enum DownloadStrategy {
     DownloadAsync = "DownloadAsync"
 }
+declare enum Lifecycle {
+    Lifecycle_1Day = "Lifecycle_1Day",
+    Lifecycle_3Days = "Lifecycle_3Days",
+    Lifecycle_5Days = "Lifecycle_5Days",
+    Lifecycle_10Days = "Lifecycle_10Days",
+    Lifecycle_15Days = "Lifecycle_15Days",
+    Lifecycle_30Days = "Lifecycle_30Days",
+    Lifecycle_90Days = "Lifecycle_90Days",
+    Lifecycle_180Days = "Lifecycle_180Days",
+    Lifecycle_360Days = "Lifecycle_360Days",
+    Lifecycle_Forever = "Lifecycle_Forever"
+}
 interface UploadPolicy {
     autoUpload: boolean;
     uploadStrategy: UploadStrategy;
-    period?: number;
 }
 interface DownloadPolicy {
     autoDownload: boolean;
@@ -2264,6 +2413,10 @@ interface ExtractPolicy {
     deleteSrcFile: boolean;
     extractToCurrentFolder: boolean;
 }
+interface RecyclePolicy {
+    lifecycle: Lifecycle;
+    paths: string[];
+}
 declare class ExtractPolicyClass implements ExtractPolicy {
     extract: boolean;
     deleteSrcFile: boolean;
@@ -2282,6 +2435,10 @@ interface WhiteList {
     path: string;
     excludePaths?: string[];
 }
+declare class WhiteListValidator {
+    private static containsWildcard;
+    static validate(whitelist: WhiteList): void;
+}
 interface BWList {
     whiteLists?: WhiteList[];
 }
@@ -2290,6 +2447,7 @@ interface SyncPolicy {
     downloadPolicy?: DownloadPolicy;
     deletePolicy?: DeletePolicy;
     extractPolicy?: ExtractPolicy;
+    recyclePolicy?: RecyclePolicy;
     bwList?: BWList;
 }
 declare class SyncPolicyImpl implements SyncPolicy {
@@ -2297,6 +2455,7 @@ declare class SyncPolicyImpl implements SyncPolicy {
     downloadPolicy?: DownloadPolicy;
     deletePolicy?: DeletePolicy;
     extractPolicy?: ExtractPolicy;
+    recyclePolicy?: RecyclePolicy;
     bwList?: BWList;
     constructor(policy?: Partial<SyncPolicy>);
     private ensureDefaults;
@@ -2313,7 +2472,9 @@ declare function newUploadPolicy(): UploadPolicy;
 declare function newDownloadPolicy(): DownloadPolicy;
 declare function newDeletePolicy(): DeletePolicy;
 declare function newExtractPolicy(): ExtractPolicy;
+declare function newRecyclePolicy(): RecyclePolicy;
 declare function newSyncPolicy(): SyncPolicy;
+declare function validateSyncPolicy(policy?: SyncPolicy): void;
 declare function newSyncPolicyWithDefaults(policy?: Partial<SyncPolicy>): SyncPolicy;
 declare function newContextSync(contextId: string, path: string, policy?: SyncPolicy): ContextSync;
 
@@ -2389,7 +2550,7 @@ declare class Agent {
 /**
  * Represents an installed application
  */
-interface InstalledApp {
+interface InstalledApp$1 {
     name: string;
     start_cmd: string;
     stop_cmd?: string;
@@ -2398,7 +2559,7 @@ interface InstalledApp {
 /**
  * Represents a running process
  */
-interface Process {
+interface Process$1 {
     pname: string;
     pid: number;
     cmdline?: string;
@@ -2406,6 +2567,10 @@ interface Process {
 }
 /**
  * Handles application operations in the AgentBay cloud environment.
+ *
+ * @deprecated This module is deprecated. Use Computer or Mobile modules instead.
+ * - For desktop applications, use session.computer
+ * - For mobile applications, use session.mobile
  */
 declare class Application {
     private session;
@@ -2437,34 +2602,34 @@ declare class Application {
      */
     private parseJSON;
     /**
-     * Retrieves a list of installed applications.
-     * Corresponds to Python's get_installed_apps() method
+     * Get a list of installed applications.
      *
-     * @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.
+     * @param startMenu - Whether to include start menu applications.
+     * @param desktop - Whether to include desktop applications.
+     * @param ignoreSystemApps - Whether to ignore system applications.
+     * @returns A promise that resolves to the list of installed applications.
+     *
+     * @deprecated Use session.computer.getInstalledApps() for desktop or session.mobile.getInstalledApps() for mobile instead.
      */
     getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<InstalledAppListResult>;
     /**
-     * Starts an application with the given command and optional working directory.
-     * Corresponds to Python's start_app() method
+     * Start an application.
      *
      * @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.
+     * @param workDirectory - The working directory for the application.
+     * @param activity - The activity to start (for mobile applications).
+     * @returns A promise that resolves to the result of starting the application.
+     *
+     * @deprecated Use session.computer.startApp() for desktop or session.mobile.startApp() for mobile instead.
      */
     startApp(startCmd: string, workDirectory?: string, activity?: string): Promise<ProcessListResult>;
     /**
-     * Stops an application by process name.
-     * Corresponds to Python's stop_app_by_pname() method
+     * Stop an application by process name.
      *
-     * @param pname - The process name to stop.
-     * @returns AppOperationResult with operation result and requestId
-     * @throws Error if the operation fails.
+     * @param pname - The process name of the application to stop.
+     * @returns A promise that resolves to the result of stopping the application.
+     *
+     * @deprecated Use session.computer.stopAppByPName() for desktop or session.mobile.stopAppByPName() for mobile instead.
      */
     stopAppByPName(pname: string): Promise<AppOperationResult>;
     /**
@@ -2477,14 +2642,14 @@ declare class Application {
      */
     stopAppByPID(pid: number): Promise<AppOperationResult>;
     /**
-     * Stops an application by stop command.
-     * Corresponds to Python's stop_app_by_cmd() method
+     * Stop an application by command.
      *
-     * @param stopCmd - The stop command to execute.
-     * @returns AppOperationResult with operation result and requestId
-     * @throws Error if the operation fails.
+     * @param cmd - The command to stop the application.
+     * @returns A promise that resolves to the result of stopping the application.
+     *
+     * @deprecated Use session.computer.stopAppByCmd() for desktop or session.mobile.stopAppByCmd() for mobile instead.
      */
-    stopAppByCmd(stopCmd: string): Promise<AppOperationResult>;
+    stopAppByCmd(cmd: string): Promise<AppOperationResult>;
     /**
      * Returns a list of currently visible applications.
      * Corresponds to Python's list_visible_apps() method
@@ -2493,6 +2658,171 @@ declare class Application {
      * @throws Error if the operation fails.
      */
     listVisibleApps(): Promise<ProcessListResult>;
+    /**
+     * Get a list of running processes.
+     *
+     * @returns A promise that resolves to the list of running processes.
+     *
+     * @deprecated Use session.computer.getRunningProcesses() for desktop or session.mobile.getRunningProcesses() for mobile instead.
+     */
+    getRunningProcesses(): Promise<ProcessListResult>;
+    /**
+     * Get a list of visible applications.
+     *
+     * @returns A promise that resolves to the list of visible applications.
+     *
+     * @deprecated Use session.computer.getVisibleApps() for desktop instead. This API is not available for mobile.
+     */
+    getVisibleApps(): Promise<InstalledAppListResult>;
+}
+
+interface ActOptions {
+    action: string;
+    timeoutMS?: number;
+    iframes?: boolean;
+    domSettleTimeoutMS?: number;
+    variables?: Record<string, string>;
+    use_vision?: boolean;
+}
+interface ObserveOptions {
+    instruction: string;
+    iframes?: boolean;
+    domSettleTimeoutMS?: number;
+    use_vision?: boolean;
+}
+interface ExtractOptions<T = any> {
+    instruction: string;
+    schema: new (...args: any[]) => T;
+    use_text_extract?: boolean;
+    selector?: string;
+    iframe?: boolean;
+    domSettleTimeoutMS?: number;
+    use_vision?: boolean;
+}
+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);
+    /** ------------------ ACT ------------------ **/
+    act(options: ActOptions, page: any): Promise<ActResult>;
+    actAsync(options: ActOptions, page: any): Promise<ActResult>;
+    /** ------------------ OBSERVE ------------------ **/
+    observe(options: ObserveOptions, page: any): Promise<[boolean, ObserveResult[]]>;
+    observeAsync(options: ObserveOptions, page: any): Promise<[boolean, ObserveResult[]]>;
+    /** ------------------ EXTRACT ------------------ **/
+    extract<T>(options: ExtractOptions<T>, page: any): Promise<[boolean, T | null]>;
+    extractAsync<T>(options: ExtractOptions<T>, page: any): Promise<[boolean, T | null]>;
+    private _getPageAndContextIndexAsync;
+    private _callMcpTool;
+    private _delay;
+}
+
+interface BrowserViewport {
+    width: number;
+    height: number;
+}
+interface BrowserScreen {
+    width: number;
+    height: number;
+}
+interface BrowserFingerprint {
+    devices?: Array<'desktop' | 'mobile'>;
+    operatingSystems?: Array<'windows' | 'macos' | 'linux' | 'android' | 'ios'>;
+    locales?: string[];
+}
+interface BrowserProxy {
+    type: 'custom' | 'wuying';
+    server?: string;
+    username?: string;
+    password?: string;
+    strategy?: 'restricted' | 'polling';
+    pollsize?: number;
+    toMap(): Record<string, any>;
+}
+declare class BrowserProxyClass implements BrowserProxy {
+    type: 'custom' | 'wuying';
+    server?: string;
+    username?: string;
+    password?: string;
+    strategy?: 'restricted' | 'polling';
+    pollsize?: number;
+    constructor(proxyType: 'custom' | 'wuying', server?: string, username?: string, password?: string, strategy?: 'restricted' | 'polling', pollsize?: number);
+    toMap(): Record<string, any>;
+    static fromMap(m: Record<string, any> | null | undefined): BrowserProxyClass | null;
+}
+interface BrowserOption {
+    persistentPath?: string;
+    useStealth?: boolean;
+    userAgent?: string;
+    viewport?: BrowserViewport;
+    screen?: BrowserScreen;
+    fingerprint?: BrowserFingerprint;
+    solveCaptchas?: boolean;
+    proxies?: BrowserProxy[];
+    /** Path to the extensions directory. Defaults to "/tmp/extensions/" */
+    extensionPath?: string;
+}
+declare class BrowserOptionClass implements BrowserOption {
+    persistentPath?: string;
+    useStealth?: boolean;
+    userAgent?: string;
+    viewport?: BrowserViewport;
+    screen?: BrowserScreen;
+    fingerprint?: BrowserFingerprint;
+    solveCaptchas?: boolean;
+    proxies?: BrowserProxy[];
+    extensionPath?: string;
+    constructor(useStealth?: boolean, userAgent?: string, viewport?: BrowserViewport, screen?: BrowserScreen, fingerprint?: BrowserFingerprint, solveCaptchas?: boolean, proxies?: BrowserProxy[]);
+    toMap(): Record<string, any>;
+    fromMap(m: Record<string, any> | null | undefined): BrowserOptionClass;
+}
+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: BrowserOptionClass | BrowserOption): boolean;
+    /**
+     * Initialize the browser instance with the given options asynchronously.
+     * Returns true if successful, false otherwise.
+     */
+    initializeAsync(option: BrowserOptionClass | 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(): BrowserOptionClass | null;
+    /**
+     * Returns true if the browser was initialized, false otherwise.
+     */
+    isInitialized(): boolean;
+    /**
+     * Stop the browser instance, internal use only.
+     */
+    private _stopBrowser;
 }
 
 /**
@@ -2521,7 +2851,8 @@ declare class Code {
      *
      * @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.
+     * @param timeoutS - The timeout for the code execution in seconds. Default is 60s.
+     *                   Note: Due to gateway limitations, each request cannot exceed 60 seconds.
      * @returns CodeExecutionResult with code execution output and requestId
      * @throws Error if an unsupported language is specified.
      */
@@ -2558,8 +2889,131 @@ declare class Command {
     executeCommand(command: string, timeoutMs?: number): Promise<CommandResult>;
 }
 
-interface ContextStatusData {
-    contextId: string;
+/**
+ * Computer module for desktop UI automation.
+ * Provides mouse, keyboard, and screen operations for desktop environments.
+ */
+
+declare enum MouseButton {
+    LEFT = "left",
+    RIGHT = "right",
+    MIDDLE = "middle",
+    DOUBLE_LEFT = "double_left"
+}
+declare enum ScrollDirection {
+    UP = "up",
+    DOWN = "down",
+    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;
+    getAPIKey(): string;
+    getSessionId(): string;
+}
+declare class Computer {
+    private session;
+    constructor(session: ComputerSession);
+    /**
+     * Click mouse at specified coordinates.
+     */
+    clickMouse(x: number, y: number, button?: MouseButton | string): Promise<BoolResult$1>;
+    /**
+     * Move mouse to specified coordinates.
+     */
+    moveMouse(x: number, y: number): Promise<BoolResult$1>;
+    /**
+     * Drag mouse from one position to another.
+     */
+    dragMouse(fromX: number, fromY: number, toX: number, toY: number, button?: MouseButton | string): Promise<BoolResult$1>;
+    /**
+     * Scroll at specified coordinates.
+     */
+    scroll(x: number, y: number, direction?: ScrollDirection | string, amount?: number): Promise<BoolResult$1>;
+    /**
+     * Input text.
+     */
+    inputText(text: string): Promise<BoolResult$1>;
+    /**
+     * Press keys.
+     */
+    pressKeys(keys: string[], hold?: boolean): Promise<BoolResult$1>;
+    /**
+     * Release keys.
+     */
+    releaseKeys(keys: string[]): Promise<BoolResult$1>;
+    /**
+     * Get cursor position.
+     */
+    getCursorPosition(): Promise<CursorPosition>;
+    /**
+     * Get screen size.
+     */
+    getScreenSize(): Promise<ScreenSize>;
+    /**
+     * Take a screenshot.
+     */
+    screenshot(): Promise<ScreenshotResult$1>;
+    /**
+     * Lists all root windows.
+     */
+    listRootWindows(timeoutMs?: number): Promise<WindowListResult>;
+    /**
+     * Gets the currently active window.
+     */
+    getActiveWindow(timeoutMs?: number): Promise<WindowInfoResult>;
+    /**
+     * Activates the specified window.
+     */
+    activateWindow(windowId: number): Promise<BoolResult$2>;
+    /**
+     * Closes the specified window.
+     */
+    closeWindow(windowId: number): Promise<BoolResult$2>;
+    /**
+     * Maximizes the specified window.
+     */
+    maximizeWindow(windowId: number): Promise<BoolResult$2>;
+    /**
+     * Minimizes the specified window.
+     */
+    minimizeWindow(windowId: number): Promise<BoolResult$2>;
+    /**
+     * Restores the specified window.
+     */
+    restoreWindow(windowId: number): Promise<BoolResult$2>;
+    /**
+     * Resizes the specified window.
+     */
+    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult$2>;
+    /**
+     * Makes the specified window fullscreen.
+     */
+    fullscreenWindow(windowId: number): Promise<BoolResult$2>;
+    /**
+     * Toggles focus mode on or off.
+     */
+    focusMode(on: boolean): Promise<BoolResult$2>;
+}
+
+interface ContextStatusData {
+    contextId: string;
     path: string;
     errorMessage: string;
     status: string;
@@ -2572,11 +3026,15 @@ interface ContextStatusItem {
     data: string;
 }
 interface ContextInfoResult extends ApiResponse {
+    success?: boolean;
     contextStatusData: ContextStatusData[];
+    errorMessage?: string;
 }
 interface ContextSyncResult extends ApiResponse {
     success: boolean;
+    errorMessage?: string;
 }
+type SyncCallback = (success: boolean) => void;
 interface SessionInterface {
     getAPIKey(): string;
     getClient(): Client;
@@ -2587,8 +3045,19 @@ declare class ContextManager {
     constructor(session: SessionInterface);
     info(): Promise<ContextInfoResult>;
     infoWithParams(contextId?: string, path?: string, taskType?: string): Promise<ContextInfoResult>;
-    sync(): Promise<ContextSyncResult>;
-    syncWithParams(contextId?: string, path?: string, mode?: string): Promise<ContextSyncResult>;
+    sync(contextId?: string, path?: string, mode?: string, callback?: SyncCallback, maxRetries?: number, retryInterval?: number): Promise<ContextSyncResult>;
+    /**
+     * Polls the info interface to check if sync is completed and calls callback.
+     */
+    private pollForCompletion;
+    /**
+     * Async version of polling for sync completion.
+     */
+    private pollForCompletionAsync;
+    /**
+     * Sleep utility function for TypeScript
+     */
+    private sleep;
 }
 declare function newContextManager(session: SessionInterface): ContextManager;
 
@@ -2649,21 +3118,19 @@ interface DirectoryEntry {
  */
 declare class FileSystem {
     private session;
+    private _fileTransfer;
     /**
      * Initialize a FileSystem object.
      *
      * @param session - The Session instance that this FileSystem belongs to.
      */
-    constructor(session: {
-        getAPIKey(): string;
-        getSessionId(): string;
-        callMcpTool(toolName: string, args: any): Promise<{
-            success: boolean;
-            data: string;
-            errorMessage: string;
-            requestId: string;
-        }>;
-    });
+    constructor(session: Session);
+    /**
+     * Ensure FileTransfer is initialized with the current session.
+     *
+     * @returns The FileTransfer instance
+     */
+    private _ensureFileTransfer;
     /**
      * Creates a new directory at the specified path.
      * Corresponds to Python's create_directory() method
@@ -2671,7 +3138,7 @@ declare class FileSystem {
      * @param path - Path to the directory to create.
      * @returns BoolResult with creation result and requestId
      */
-    createDirectory(path: string): Promise<BoolResult>;
+    createDirectory(path: string): Promise<BoolResult$2>;
     /**
      * Edits a file by replacing occurrences of oldText with newText.
      * Corresponds to Python's edit_file() method
@@ -2684,7 +3151,7 @@ declare class FileSystem {
     editFile(path: string, edits: Array<{
         oldText: string;
         newText: string;
-    }>, dryRun?: boolean): Promise<BoolResult>;
+    }>, dryRun?: boolean): Promise<BoolResult$2>;
     /**
      * Gets information about a file or directory.
      * Corresponds to Python's get_file_info() method
@@ -2709,7 +3176,7 @@ declare class FileSystem {
      * @param destination - Path to the destination file or directory.
      * @returns BoolResult with move result and requestId
      */
-    moveFile(source: string, destination: string): Promise<BoolResult>;
+    moveFile(source: string, destination: string): Promise<BoolResult$2>;
     /**
      * Internal method to read a file chunk. Used for chunked file operations.
      *
@@ -2761,7 +3228,7 @@ declare class FileSystem {
      * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
      * @returns BoolResult indicating success or failure with requestId
      */
-    writeFile(path: string, content: string, mode?: string): Promise<BoolResult>;
+    writeFile(path: string, content: string, mode?: string): Promise<BoolResult$2>;
     /**
      * Get file change information for the specified directory path
      */
@@ -2774,6 +3241,127 @@ declare class FileSystem {
      * Watch a directory for file changes and call the callback function when changes occur
      */
     watchDirectory(path: string, callback: (events: FileChangeEvent[]) => void, interval?: number, signal?: AbortSignal): Promise<void>;
+    /**
+     * Upload a file from local to remote path using pre-signed URLs.
+     * This is a synchronous wrapper around the FileTransfer.upload method.
+     *
+     * @param localPath - Local file path to upload
+     * @param remotePath - Remote file path to upload to
+     * @param options - Optional parameters
+     * @returns UploadResult with upload result and requestId
+     */
+    uploadFile(localPath: string, remotePath: string, options?: {
+        contentType?: string;
+        wait?: boolean;
+        waitTimeout?: number;
+        pollInterval?: number;
+        progressCb?: (bytesTransferred: number) => void;
+    }): Promise<any>;
+    /**
+     * Download a file from remote path to local path using pre-signed URLs.
+     * This is a synchronous wrapper around the FileTransfer.download method.
+     *
+     * @param remotePath - Remote file path to download from
+     * @param localPath - Local file path to download to
+     * @param options - Optional parameters
+     * @returns DownloadResult with download result and requestId
+     */
+    downloadFile(remotePath: string, localPath: string, options?: {
+        overwrite?: boolean;
+        wait?: boolean;
+        waitTimeout?: number;
+        pollInterval?: number;
+        progressCb?: (bytesReceived: number) => void;
+    }): Promise<any>;
+}
+
+/**
+ * Mobile module for mobile UI automation.
+ * Provides touch, input, and app management operations for mobile environments.
+ */
+
+interface BoolResult extends OperationResult {
+    data?: boolean;
+}
+interface UIElement$1 {
+    text: string;
+    className: string;
+    bounds: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+}
+interface UIElementsResult extends OperationResult {
+    elements: UIElement$1[];
+}
+interface InstalledApp {
+    name: string;
+    startCmd: string;
+    workDirectory: string;
+}
+interface InstalledAppsResult extends OperationResult {
+    apps: InstalledApp[];
+}
+interface Process {
+    pid: number;
+    pname: string;
+}
+interface ProcessResult extends OperationResult {
+    processes: Process[];
+}
+interface ScreenshotResult extends OperationResult {
+    data: string;
+}
+interface MobileSession {
+    callMcpTool(toolName: string, args: Record<string, any>): Promise<any>;
+    sessionId: string;
+    getAPIKey(): string;
+}
+declare class Mobile {
+    private session;
+    constructor(session: MobileSession);
+    /**
+     * Tap at specified coordinates.
+     */
+    tap(x: number, y: number): Promise<BoolResult>;
+    /**
+     * Swipe from one position to another.
+     */
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<BoolResult>;
+    /**
+     * Input text.
+     */
+    inputText(text: string): Promise<BoolResult>;
+    /**
+     * Send Android key code.
+     */
+    sendKey(key: number): Promise<BoolResult>;
+    /**
+     * Get clickable UI elements.
+     */
+    getClickableUIElements(timeoutMs?: number): Promise<UIElementsResult>;
+    /**
+     * Get all UI elements.
+     */
+    getAllUIElements(timeoutMs?: number): Promise<UIElementsResult>;
+    /**
+     * Get installed apps.
+     */
+    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<InstalledAppsResult>;
+    /**
+     * Start an app.
+     */
+    startApp(startCmd: string, workDirectory?: string, activity?: string): Promise<ProcessResult>;
+    /**
+     * Stop app by package name.
+     */
+    stopAppByPName(pname: string): Promise<BoolResult>;
+    /**
+     * Take a screenshot.
+     */
+    screenshot(): Promise<ScreenshotResult>;
 }
 
 /**
@@ -2877,6 +3465,10 @@ interface UIElement {
 }
 /**
  * Handles UI operations in the AgentBay cloud environment.
+ *
+ * @deprecated This module is deprecated. Use Computer or Mobile modules instead.
+ * - For desktop UI operations, use session.computer
+ * - For mobile UI operations, use session.mobile
  */
 declare class UI {
     private session;
@@ -2908,8 +3500,10 @@ declare class UI {
      * 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.
+     * @returns UIElementListResult with clickable elements and requestId
+     * @throws Error if the operation fails.
+     *
+     * @deprecated Use session.computer.getClickableUIElements() for desktop or session.mobile.getClickableUIElements() for mobile instead.
      */
     getClickableUIElements(timeoutMs?: number): Promise<UIElementListResult>;
     /**
@@ -2917,8 +3511,10 @@ declare class UI {
      * 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.
+     * @returns UIElementListResult with all elements and requestId
+     * @throws Error if the operation fails.
+     *
+     * @deprecated Use session.computer.getAllUIElements() for desktop or session.mobile.getAllUIElements() for mobile instead.
      */
     getAllUIElements(timeoutMs?: number): Promise<UIElementListResult>;
     /**
@@ -2933,18 +3529,22 @@ declare class UI {
      *   - 26 : POWER
      *   - 82 : MENU
      * @returns BoolResult with success status and requestId
-     * @throws APIError if the operation fails.
+     * @throws Error if the operation fails.
+     *
+     * @deprecated Use session.computer.pressKeys() for desktop or session.mobile.sendKey() for mobile instead.
      */
-    sendKey(key: number): Promise<BoolResult>;
+    sendKey(key: number): Promise<BoolResult$2>;
     /**
      * Inputs text into the currently focused UI element.
      * Corresponds to Python's input_text() method
      *
      * @param text - The text to input
      * @returns BoolResult with success status and requestId
-     * @throws APIError if the operation fails.
+     * @throws Error if the operation fails.
+     *
+     * @deprecated Use session.computer.inputText() for desktop or session.mobile.inputText() for mobile instead.
      */
-    inputText(text: string): Promise<BoolResult>;
+    inputText(text: string): Promise<BoolResult$2>;
     /**
      * Performs a swipe gesture on the screen.
      * Corresponds to Python's swipe() method
@@ -2955,9 +3555,11 @@ declare class UI {
      * @param endY - The ending Y coordinate
      * @param durationMs - The duration of the swipe in milliseconds. Default is 300ms.
      * @returns BoolResult with success status and requestId
-     * @throws APIError if the operation fails.
+     * @throws Error if the operation fails.
+     *
+     * @deprecated Use session.computer.dragMouse() for desktop or session.mobile.swipe() for mobile instead.
      */
-    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<BoolResult>;
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<BoolResult$2>;
     /**
      * Clicks on the screen at the specified coordinates.
      * Corresponds to Python's click() method
@@ -2966,21 +3568,29 @@ declare class UI {
      * @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.
+     * @throws Error if the operation fails.
+     *
+     * @deprecated Use session.computer.clickMouse() for desktop or session.mobile.tap() for mobile instead.
      */
-    click(x: number, y: number, button?: string): Promise<BoolResult>;
+    click(x: number, y: number, button?: string): Promise<BoolResult$2>;
     /**
      * Takes a screenshot of the current screen.
      * Corresponds to Python's screenshot() method
      *
      * @returns OperationResult with success status and requestId
-     * @throws APIError if the operation fails.
+     * @throws Error if the operation fails.
+     *
+     * @deprecated Use session.computer.screenshot() for desktop or session.mobile.screenshot() for mobile instead.
      */
     screenshot(): Promise<OperationResult>;
 }
 
 /**
  * Handles window management operations in the AgentBay cloud environment.
+ *
+ * @deprecated This module is deprecated. Use Computer module instead.
+ * - For desktop window operations, use session.computer
+ * - Window operations are not available for mobile
  */
 declare class WindowManager {
     private session;
@@ -3010,40 +3620,60 @@ declare class WindowManager {
      *
      * @param timeoutMs - The timeout in milliseconds. Default is 3000ms.
      * @returns WindowListResult with windows array and requestId
+     *
+     * @deprecated Use session.computer.listRootWindows() instead.
      */
     listRootWindows(timeoutMs?: number): Promise<WindowListResult>;
     /**
-     * Gets the currently active window.
-     * Corresponds to Python's get_active_window() method
+     * Lists all windows in the system.
+     * Corresponds to Python's list_all_windows() method
      *
      * @param timeoutMs - The timeout in milliseconds. Default is 3000ms.
-     * @returns WindowInfoResult with active window data and requestId
+     * @returns WindowListResult with windows array and requestId
+     *
+     * @deprecated Use session.computer.listAllWindows() instead.
      */
-    getActiveWindow(timeoutMs?: number): Promise<WindowInfoResult>;
+    listAllWindows(timeoutMs?: number): Promise<WindowListResult>;
     /**
-     * Activates a window by ID.
+     * Gets information about a specific window.
+     * Corresponds to Python's get_window_info() method
+     *
+     * @param windowId - The ID of the window to get information for.
+     * @returns WindowInfoResult with window information and requestId
+     *
+     * @deprecated Use session.computer.getWindowInfo() instead.
+     */
+    getWindowInfo(windowId: number): Promise<WindowInfoResult>;
+    /**
+     * Activates a window by bringing it to the foreground.
      * Corresponds to Python's activate_window() method
      *
-     * @param windowId The ID of the window to activate.
-     * @returns BoolResult with requestId
+     * @param windowId - The ID of the window to activate.
+     * @returns BoolResult with success status and requestId
+     *
+     * @deprecated Use session.computer.activateWindow() instead.
      */
-    activateWindow(windowId: number): Promise<BoolResult>;
+    activateWindow(windowId: number): Promise<BoolResult$2>;
     /**
-     * Maximizes a window by ID.
+     * Maximizes a window.
      * Corresponds to Python's maximize_window() method
      *
-     * @param windowId The ID of the window to maximize.
-     * @returns BoolResult with requestId
+     * @param windowId - The ID of the window to maximize.
+     * @returns BoolResult with success status and requestId
+     *
+     * @deprecated Use session.computer.maximizeWindow() instead.
      */
-    maximizeWindow(windowId: number): Promise<BoolResult>;
+    maximizeWindow(windowId: number): Promise<BoolResult$2>;
     /**
-     * Minimizes a window by ID.
+     * Minimizes a window.
      * Corresponds to Python's minimize_window() method
      *
-     * @param windowId The ID of the window to minimize.
-     * @returns BoolResult with requestId
+     * @param windowId - The ID of the window to minimize.
+     * @returns BoolResult with success status and requestId
+     *
+     * @deprecated Use session.computer.minimizeWindow() instead.
      */
-    minimizeWindow(windowId: number): Promise<BoolResult>;
+    minimizeWindow(windowId: number): Promise<BoolResult$2>;
     /**
      * Restores a window by ID.
      * Corresponds to Python's restore_window() method
@@ -3051,15 +3681,17 @@ declare class WindowManager {
      * @param windowId The ID of the window to restore.
      * @returns BoolResult with requestId
      */
-    restoreWindow(windowId: number): Promise<BoolResult>;
+    restoreWindow(windowId: number): Promise<BoolResult$2>;
     /**
-     * Closes a window by ID.
+     * Closes a window.
      * Corresponds to Python's close_window() method
      *
-     * @param windowId The ID of the window to close.
-     * @returns BoolResult with requestId
+     * @param windowId - The ID of the window to close.
+     * @returns BoolResult with success status and requestId
+     *
+     * @deprecated Use session.computer.closeWindow() instead.
      */
-    closeWindow(windowId: number): Promise<BoolResult>;
+    closeWindow(windowId: number): Promise<BoolResult$2>;
     /**
      * Sets a window to fullscreen by ID.
      * Corresponds to Python's fullscreen_window() method
@@ -3067,17 +3699,31 @@ declare class WindowManager {
      * @param windowId The ID of the window to set to fullscreen.
      * @returns BoolResult with requestId
      */
-    fullscreenWindow(windowId: number): Promise<BoolResult>;
+    fullscreenWindow(windowId: number): Promise<BoolResult$2>;
     /**
-     * Resizes a window by ID.
+     * Resizes a window to the specified dimensions.
      * Corresponds to Python's resize_window() method
      *
-     * @param windowId The ID of the window to resize.
-     * @param width The new width of the window.
-     * @param height The new height of the window.
-     * @returns BoolResult with requestId
+     * @param windowId - The ID of the window to resize.
+     * @param width - The new width of the window.
+     * @param height - The new height of the window.
+     * @returns BoolResult with success status and requestId
+     *
+     * @deprecated Use session.computer.resizeWindow() instead.
+     */
+    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult$2>;
+    /**
+     * Moves a window to the specified position.
+     * Corresponds to Python's move_window() method
+     *
+     * @param windowId - The ID of the window to move.
+     * @param x - The new x coordinate of the window.
+     * @param y - The new y coordinate of the window.
+     * @returns BoolResult with success status and requestId
+     *
+     * @deprecated Use session.computer.moveWindow() instead.
      */
-    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult>;
+    moveWindow(windowId: number, x: number, y: number): Promise<BoolResult$2>;
     /**
      * Enables or disables focus mode.
      * Corresponds to Python's focus_mode() method
@@ -3085,170 +3731,17 @@ declare class WindowManager {
      * @param on Whether to enable focus mode.
      * @returns BoolResult with requestId
      */
-    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;
-    use_text_extract: boolean;
-    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(options: ActOptions, page: any): Promise<ActResult>;
-    /**
-     * Async version of act method for performing actions on the given Playwright Page object.
-     */
-    actAsync(options: ActOptions, page: any): Promise<ActResult>;
-    /**
-     * Observe elements or state on the given Playwright Page object.
-     * Returns a tuple containing (success, results).
-     */
-    observe(options: ObserveOptions, page: any): Promise<[boolean, ObserveResult[]]>;
-    /**
-     * Async version of observe method.
-     */
-    observeAsync(options: ObserveOptions, page: any): Promise<[boolean, ObserveResult[]]>;
-    /**
-     * Extract information from the given Playwright Page object.
-     */
-    extract<T>(options: ExtractOptions<T>, page: any): Promise<[boolean, T[]]>;
-    /**
-     * Async version of extract method.
-     */
-    extractAsync<T>(options: ExtractOptions<T>, page: any): Promise<[boolean, T[]]>;
-    private _getPageAndContextIndex;
-    private _getPageAndContextIndexAsync;
-    private _callMcpTool;
-}
-
-interface BrowserViewport {
-    width: number;
-    height: number;
-}
-interface BrowserScreen {
-    width: number;
-    height: number;
-}
-interface BrowserFingerprint {
-    devices?: Array<'desktop' | 'mobile'>;
-    operatingSystems?: Array<'windows' | 'macos' | 'linux' | 'android' | 'ios'>;
-    locales?: string[];
-}
-interface BrowserProxy {
-    type: 'custom' | 'wuying';
-    server?: string;
-    username?: string;
-    password?: string;
-    strategy?: 'restricted' | 'polling';
-    pollsize?: number;
-    toMap(): Record<string, any>;
-}
-declare class BrowserProxyClass implements BrowserProxy {
-    type: 'custom' | 'wuying';
-    server?: string;
-    username?: string;
-    password?: string;
-    strategy?: 'restricted' | 'polling';
-    pollsize?: number;
-    constructor(proxyType: 'custom' | 'wuying', server?: string, username?: string, password?: string, strategy?: 'restricted' | 'polling', pollsize?: number);
-    toMap(): Record<string, any>;
-    static fromMap(m: Record<string, any> | null | undefined): BrowserProxyClass | null;
-}
-interface BrowserOption {
-    persistentPath?: string;
-    useStealth?: boolean;
-    userAgent?: string;
-    viewport?: BrowserViewport;
-    screen?: BrowserScreen;
-    fingerprint?: BrowserFingerprint;
-    solveCaptchas?: boolean;
-    proxies?: BrowserProxy[];
-    /** Path to the extensions directory. Defaults to "/tmp/extensions/" */
-    extensionPath?: string;
-}
-declare class BrowserOptionClass implements BrowserOption {
-    persistentPath?: string;
-    useStealth?: boolean;
-    userAgent?: string;
-    viewport?: BrowserViewport;
-    screen?: BrowserScreen;
-    fingerprint?: BrowserFingerprint;
-    solveCaptchas?: boolean;
-    proxies?: BrowserProxy[];
-    extensionPath?: string;
-    constructor(useStealth?: boolean, userAgent?: string, viewport?: BrowserViewport, screen?: BrowserScreen, fingerprint?: BrowserFingerprint, solveCaptchas?: boolean, proxies?: BrowserProxy[]);
-    toMap(): Record<string, any>;
-    fromMap(m: Record<string, any> | null | undefined): BrowserOptionClass;
-}
-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: BrowserOptionClass | BrowserOption): boolean;
-    /**
-     * Initialize the browser instance with the given options asynchronously.
-     * Returns true if successful, false otherwise.
-     */
-    initializeAsync(option: BrowserOptionClass | 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(): BrowserOptionClass | null;
-    /**
-     * Returns true if the browser was initialized, false otherwise.
-     */
-    isInitialized(): boolean;
+    focusMode(on: boolean): Promise<BoolResult$2>;
     /**
-     * Stop the browser instance, internal use only.
+     * Gets the currently active window.
+     * Corresponds to Python's get_active_window() method
+     *
+     * @param timeoutMs - The timeout in milliseconds. Default is 3000ms.
+     * @returns WindowInfoResult with active window information and requestId
+     *
+     * @deprecated Use session.computer.getActiveWindow() instead.
      */
-    private _stopBrowser;
+    getActiveWindow(timeoutMs?: number): Promise<WindowInfoResult>;
 }
 
 /**
@@ -3273,9 +3766,13 @@ interface McpToolsResult extends OperationResult {
 declare class Session {
     private agentBay;
     sessionId: string;
+    fileTransferContextId: string | null;
     isVpc: boolean;
     networkInterfaceIp: string;
     httpPort: string;
+    token: string;
+    resourceUrl: string;
+    enableBrowserReplay: boolean;
     fileSystem: FileSystem;
     command: Command;
     code: Code;
@@ -3283,6 +3780,8 @@ declare class Session {
     application: Application;
     window: WindowManager;
     ui: UI;
+    computer: Computer;
+    mobile: Mobile;
     agent: Agent;
     browser: Browser;
     context: ContextManager;
@@ -3294,6 +3793,10 @@ declare class Session {
      * @param sessionId - The ID of this session.
      */
     constructor(agentBay: AgentBay, sessionId: string);
+    /**
+     * Return the AgentBay instance that created this session.
+     */
+    getAgentBay(): AgentBay;
     /**
      * Return the API key for this session.
      */
@@ -3318,6 +3821,10 @@ declare class Session {
      * Return the HTTP port for VPC sessions.
      */
     getHttpPort(): string;
+    /**
+     * Return the token for VPC sessions.
+     */
+    getToken(): string;
     /**
      * Find the server that provides the given tool.
      */
@@ -3362,7 +3869,7 @@ declare class Session {
      * Get a link associated with the current session.
      *
      * @param protocolType - Optional protocol type to use for the link
-     * @param port - Optional port to use for the link
+     * @param port - Optional port to use for the link (must be in range [30100, 30199])
      * @returns OperationResult containing the link as data and request ID
      * @throws Error if the operation fails (matching Python SessionError)
      */
@@ -3371,7 +3878,7 @@ declare class Session {
      * Asynchronously get a link associated with the current session.
      *
      * @param protocolType - Optional protocol type to use for the link
-     * @param port - Optional port to use for the link
+     * @param port - Optional port to use for the link (must be in range [30100, 30199])
      * @returns OperationResult containing the link as data and request ID
      * @throws Error if the operation fails (matching Python SessionError)
      */
@@ -3730,8 +4237,10 @@ interface CreateSessionParamsConfig {
     browserContext?: BrowserContext;
     /** Whether to create a VPC-based session. Defaults to false. */
     isVpc?: boolean;
-    /** MCP policy id to apply when creating the session. */
-    mcpPolicyId?: string;
+    /** Policy id to apply when creating the session. */
+    policyId?: string;
+    /** Whether to enable browser recording for the session. Defaults to false. */
+    enableBrowserReplay?: boolean;
 }
 /**
  * CreateSessionParams provides a way to configure the parameters for creating a new session
@@ -3751,8 +4260,10 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
     browserContext?: BrowserContext;
     /** Whether to create a VPC-based session. Defaults to false. */
     isVpc: boolean;
-    /** MCP policy id to apply when creating the session. */
-    mcpPolicyId?: string;
+    /** Policy id to apply when creating the session. */
+    policyId?: string;
+    /** Whether to enable browser recording for the session. Defaults to false. */
+    enableBrowserReplay: boolean;
     constructor();
     /**
      * WithLabels sets the labels for the session parameters and returns the updated parameters.
@@ -3771,9 +4282,17 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
      */
     withIsVpc(isVpc: boolean): CreateSessionParams$1;
     /**
-     * WithMcpPolicyId sets the MCP policy id for the session parameters and returns the updated parameters.
+     * WithPolicyId sets the policy id for the session parameters and returns the updated parameters.
+     */
+    withPolicyId(policyId: string): CreateSessionParams$1;
+    /**
+     * WithenableBrowserReplay sets the browser recording flag for the session parameters and returns the updated parameters.
+     */
+    withEnableBrowserReplay(enableBrowserReplay: boolean): CreateSessionParams$1;
+    /**
+     * Alias for withEnableBrowserReplay for backward compatibility.
      */
-    withMcpPolicyId(mcpPolicyId: string): CreateSessionParams$1;
+    withEnableRecord(enableRecord: 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.
@@ -3821,11 +4340,10 @@ interface ListSessionParams {
 }
 /**
  * Result type for session listing with pagination information
- * Maintain consistency with the existing TypeScript SDK return structure and use the data field
  */
 interface SessionListResult extends ApiResponse {
-    /** Array of sessions */
-    data: Session[];
+    /** Array of session IDs */
+    sessionIds: string[];
     /** Token for the next page (if available) */
     nextToken?: string;
     /** Number of results per page */
@@ -3843,7 +4361,8 @@ interface CreateSessionParams {
     contextSync?: ContextSync[];
     browserContext?: BrowserContext;
     isVpc?: boolean;
-    mcpPolicyId?: string;
+    policyId?: string;
+    enableBrowserReplay?: boolean;
 }
 /**
  * Main class for interacting with the AgentBay cloud runtime environment.
@@ -3851,9 +4370,9 @@ interface CreateSessionParams {
 declare class AgentBay {
     private apiKey;
     private client;
-    private regionId;
     private endpoint;
     private sessions;
+    private fileTransferContext;
     /**
      * Context service for managing persistent contexts.
      */
@@ -3864,11 +4383,20 @@ declare class AgentBay {
      * @param options - Configuration options
      * @param options.apiKey - API key for authentication. If not provided, will look for AGENTBAY_API_KEY environment variable.
      * @param options.config - Custom configuration object. If not provided, will use environment-based configuration.
+     * @param options.envFile - Custom path to .env file. If not provided, will search upward from current directory.
      */
     constructor(options?: {
         apiKey?: string;
         config?: Config;
+        envFile?: string;
     });
+    /**
+     * Update browser replay context with AppInstanceId from response data.
+     *
+     * @param responseData - Response data containing AppInstanceId
+     * @param recordContextId - The record context ID to update
+     */
+    private _updateBrowserReplayContext;
     /**
      * Create a new session in the AgentBay cloud environment.
      *
@@ -3876,22 +4404,49 @@ declare class AgentBay {
      * @returns SessionResult containing the created session and request ID
      */
     create(params?: CreateSessionParams): Promise<SessionResult>;
-    /**
-     * List all available sessions.
-     *
-     * @returns A list of session objects.
-     */
-    list(): Session[];
     /**
      * List sessions filtered by the provided labels with pagination support.
      * It returns sessions that match all the specified labels.
      *
+     * @deprecated This method is deprecated and will be removed in a future version. Use list() instead.
+     *
      * **Breaking Change**: This method currently only accepts ListSessionParams parameters，
      *
      * @param params - Parameters including labels and pagination options (required)
      * @returns API response with sessions list and pagination info
      */
     listByLabels(params?: ListSessionParams): Promise<SessionListResult>;
+    /**
+     * Returns paginated list of session IDs filtered by labels.
+     *
+     * @param labels - Optional labels to filter sessions (defaults to empty object)
+     * @param page - Optional page number for pagination (starting from 1, defaults to 1)
+     * @param limit - Optional maximum number of items per page (defaults to 10)
+     * @returns SessionListResult - Paginated list of session IDs that match the labels
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: "your_api_key" });
+     *
+     * // List all sessions
+     * const result = await agentBay.list();
+     *
+     * // List sessions with specific labels
+     * const result = await agentBay.list({ project: "demo" });
+     *
+     * // List sessions with pagination
+     * const result = await agentBay.list({ "my-label": "my-value" }, 2, 10);
+     *
+     * if (result.success) {
+     *   for (const sessionId of result.sessionIds) {
+     *     console.log(`Session ID: ${sessionId}`);
+     *   }
+     *   console.log(`Total count: ${result.totalCount}`);
+     *   console.log(`Request ID: ${result.requestId}`);
+     * }
+     * ```
+     */
+    list(labels?: Record<string, string>, page?: number, limit?: number): Promise<SessionListResult>;
     /**
      * Delete a session by session object.
      *
@@ -3905,6 +4460,32 @@ declare class AgentBay {
      * @param sessionId - The ID of the session to remove.
      */
     removeSession(sessionId: string): void;
+    /**
+     * Get session information by session ID.
+     *
+     * @param sessionId - The ID of the session to retrieve.
+     * @returns GetSessionResult containing session information
+     */
+    getSession(sessionId: string): Promise<GetSessionResult>;
+    /**
+     * Get a session by its ID.
+     *
+     * This method retrieves a session by calling the GetSession API
+     * and returns a SessionResult containing the Session object and request ID.
+     *
+     * @param sessionId - The ID of the session to retrieve
+     * @returns Promise resolving to SessionResult with the Session instance, request ID, and success status
+     *
+     * @example
+     * ```typescript
+     * const result = await agentBay.get("my-session-id");
+     * if (result.success) {
+     *   console.log(result.session.sessionId);
+     *   console.log(result.requestId);
+     * }
+     * ```
+     */
+    get(sessionId: string): Promise<SessionResult>;
     getClient(): Client;
     getAPIKey(): string;
 }
@@ -3988,4 +4569,4 @@ declare function log(message: string, ...args: any[]): void;
  */
 declare function logError(message: string, error?: any): void;
 
-export { APIError, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, type Config, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, 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, loadConfig, loadDotEnv, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy };
+export { APIError, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, type Config, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, GetSessionRequest, GetSessionResponse, GetSessionResponseBody, GetSessionResponseBodyData, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, type InstalledApp$1 as InstalledApp, KeyCode, Lifecycle, 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$1 as Process, type QueryResult, type RecyclePolicy, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SessionError, type SessionInterface, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, type SyncCallback, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UI, type UIElement, UIError, type UploadPolicy, UploadStrategy, type WhiteList, WhiteListValidator, loadConfig, loadDotEnv, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newRecyclePolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy, validateSyncPolicy };