wuying-agentbay-sdk 0.3.0 → 0.3.3

package/dist/index.d.mts

@@ -1,311 +1,53 @@
 import * as $dara from '@darabonba/typescript';
-import * as OpenApiDefault from '@alicloud/openapi-core';
-import { $OpenApiUtil } from '@alicloud/openapi-core';
+import OpenApi, { $OpenApiUtil } from '@alicloud/openapi-core';
 
 /**
- * FileInfo represents information about a file or directory
- */
-interface FileInfo {
-    name: string;
-    path: string;
-    size: number;
-    isDirectory: boolean;
-    modTime: string;
-    mode: string;
-    owner?: string;
-    group?: string;
-}
-/**
- * DirectoryEntry represents an entry in a directory listing
- */
-interface DirectoryEntry {
-    name: string;
-    isDirectory: boolean;
-}
-/**
- * Handles file operations in the AgentBay cloud environment.
- */
-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;
-    /**
-     * Creates a new directory at the specified path.
-     *
-     * @param path - Path to the directory to create.
-     * @returns The extracted text content from the API response
-     * @throws APIError if the operation fails.
-     */
-    createDirectory(path: string): Promise<string>;
-    /**
-     * Edits a file by replacing occurrences of oldText with newText.
-     *
-     * @param path - Path to the file to edit.
-     * @param edits - Array of edit operations, each containing oldText and newText.
-     * @param dryRun - Optional: If true, preview changes without applying them.
-     * @returns The extracted text content from the API response
-     * @throws APIError if the operation fails.
-     */
-    editFile(path: string, edits: Array<{
-        oldText: string;
-        newText: string;
-    }>, dryRun?: boolean): Promise<string>;
-    /**
-     * Gets information about a file or directory.
-     *
-     * @param path - Path to the file or directory to inspect.
-     * @returns The extracted text content from the API response
-     * @throws APIError if the operation fails.
-     */
-    getFileInfo(path: string): Promise<FileInfo>;
-    /**
-     * Lists the contents of a directory.
-     *
-     * @param path - Path to the directory to list.
-     * @returns Array of directory entries with properties like name, isDirectory
-     * @throws APIError if the operation fails.
-     */
-    listDirectory(path: string): Promise<DirectoryEntry[]>;
-    /**
-     * Moves a file or directory from source to destination.
-     *
-     * @param source - Path to the source file or directory.
-     * @param destination - Path to the destination file or directory.
-     * @returns The extracted text content from the API response
-     * @throws APIError if the operation fails.
-     */
-    moveFile(source: string, destination: string): Promise<string>;
-    /**
-     * Reads the content of a file.
-     *
-     * @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.
-     * @returns The extracted text content from the API response
-     * @throws APIError if the operation fails.
-     */
-    readFile(path: string, offset?: number, length?: number): Promise<string>;
-    /**
-     * Reads the content of multiple files.
-     *
-     * @param paths - Array of file paths to read.
-     * @returns The extracted text content from the API response
-     * @throws APIError if the operation fails.
-     */
-    readMultipleFiles(paths: string[]): Promise<Record<string, string>>;
-    /**
-     * Searches for files in a directory that match a pattern.
-     *
-     * @param path - Path to the directory to search in.
-     * @param pattern - Pattern to search for. Supports glob patterns.
-     * @param excludePatterns - Optional: Array of patterns to exclude.
-     * @returns Array of search results with properties like path
-     * @throws APIError if the operation fails.
-     */
-    searchFiles(path: string, pattern: string, excludePatterns?: string[]): Promise<string[]>;
-    /**
-     * Writes content to a file.
-     *
-     * @param path - Path to the file to write.
-     * @param content - Content to write to the file.
-     * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
-     * @returns The extracted text content from the API response
-     * @throws APIError if the operation fails.
-     */
-    writeFile(path: string, content: string, mode?: string): Promise<string>;
-    /**
-     * Reads a large file in chunks to handle size limitations of the underlying API.
-     * It automatically splits the read operation into multiple requests of chunkSize bytes each.
-     *
-     * @param path - Path to the file to read.
-     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
-     * @returns The complete file content as a string
-     * @throws APIError if the operation fails.
-     */
-    readLargeFile(path: string, chunkSize?: number): Promise<string>;
-    /**
-     * Writes a large file in chunks to handle size limitations of the underlying API.
-     * It automatically splits the write operation into multiple requests of chunkSize bytes each.
-     *
-     * @param path - Path to the file to write.
-     * @param content - Content to write to the file.
-     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
-     * @returns True if the operation was successful
-     * @throws APIError if the operation fails.
-     */
-    writeLargeFile(path: string, content: string, chunkSize?: number): Promise<boolean>;
-}
-
-/**
- * Represents the result of a command execution
- */
-interface CommandResult {
-    output: string;
-    exitCode?: number;
-    durationMs?: number;
-}
-/**
- * Represents the result of code execution
- */
-interface CodeExecutionResult {
-    output: string;
-    durationMs?: number;
-    memoryKb?: number;
-}
-/**
- * Handles command execution operations in the AgentBay cloud environment.
  */
-declare class Command {
-    private session;
-    private client;
-    private baseUrl;
-    /**
-     * Initialize a Command object.
-     *
-     * @param session - The Session instance that this Command 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;
-    /**
-     * Helper method to parse JSON string or return a simple object with output
-     */
-    private parseCommandResult;
-    /**
-     * Execute a command in the cloud environment with a specified timeout.
-     *
-     * @param command - The command to execute.
-     * @param timeoutMs - The timeout for the command execution in milliseconds. Default is 1000ms.
-     * @returns A string containing the command output
-     */
-    executeCommand(command: string, timeoutMs?: number): Promise<string>;
-    /**
-     * Helper method to parse JSON string or return a simple object with output
-     */
-    private parseCodeExecutionResult;
-    /**
-     * Execute code in the specified language with a timeout.
-     *
-     * @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 A string containing the code execution output
-     * @throws APIError if the code execution fails or if an unsupported language is specified.
-     */
-    runCode(code: string, language: string, timeoutS?: number): Promise<string>;
+declare class ApplyMqttTokenResponseBodyData extends $dara.Model {
+    accessKeyId?: string;
+    clientId?: string;
+    expiration?: string;
+    instanceId?: string;
+    regionId?: string;
+    securityToken?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
 }
 
-/**
- * Handles Object Storage Service operations in the AgentBay cloud environment.
- */
-declare class Oss {
-    private session;
-    private client;
-    private baseUrl;
-    /**
-     * Initialize an Oss object.
-     *
-     * @param session - The Session instance that this Oss 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;
-    /**
-     * Initialize OSS environment variables with the specified credentials.
-     *
-     * @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 The extracted text content from the API response
-     */
-    envInit(accessKeyId: string, accessKeySecret: string, securityToken: string, endpoint?: string, region?: string): Promise<string>;
-    /**
-     * Create an OSS client with the provided credentials.
-     *
-     * @param accessKeyId - The Access Key ID for OSS authentication.
-     * @param accessKeySecret - The Access Key Secret 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 The extracted text content from the API response
-     */
-    createClient(accessKeyId: string, accessKeySecret: string, endpoint?: string, region?: string): Promise<string>;
-    /**
-     * Upload a local file or directory to OSS.
-     *
-     * @param bucket - OSS bucket name.
-     * @param object - Object key in OSS.
-     * @param path - Local file or directory path to upload.
-     * @returns The extracted text content from the API response
-     */
-    upload(bucket: string, object: string, path: string): Promise<string>;
-    /**
-     * Upload a local file or directory to OSS using a pre-signed URL.
-     *
-     * @param url - Pre-signed URL for anonymous upload.
-     * @param path - Local file or directory path to upload.
-     * @returns The extracted text content from the API response
-     */
-    uploadAnonymous(url: string, path: string): Promise<string>;
-    /**
-     * Download an object from OSS to a local file or directory.
-     *
-     * @param bucket - OSS bucket name.
-     * @param object - Object key in OSS.
-     * @param path - Local file or directory path to save the downloaded content.
-     * @returns The extracted text content from the API response
-     */
-    download(bucket: string, object: string, path: string): Promise<string>;
-    /**
-     * Download an object from OSS using a pre-signed URL.
-     *
-     * @param url - Pre-signed URL for anonymous download.
-     * @param path - Local file or directory path to save the downloaded content.
-     * @returns The extracted text content from the API response
-     */
-    downloadAnonymous(url: string, path: string): Promise<string>;
+declare class CreateMcpSessionRequestPersistenceDataList extends $dara.Model {
+    contextId?: string;
+    path?: string;
+    policy?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
 }
 
 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;
     };
@@ -337,6 +79,20 @@ declare class GetContextResponseBodyData extends $dara.Model {
     });
 }
 
+declare class GetContextInfoResponseBodyData extends $dara.Model {
+    contextStatus?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class GetLabelResponseBodyData extends $dara.Model {
     labels?: string;
     static names(): {
@@ -351,12 +107,27 @@ declare class GetLabelResponseBodyData extends $dara.Model {
     });
 }
 
+declare class GetLinkResponseBodyData extends $dara.Model {
+    url?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class GetMcpResourceResponseBodyDataDesktopInfo extends $dara.Model {
     appId?: string;
     authCode?: string;
     connectionProperties?: string;
     resourceId?: string;
     resourceType?: string;
+    ticket?: string;
     static names(): {
         [key: string]: string;
     };
@@ -418,15 +189,9 @@ declare class ListSessionResponseBodyData extends $dara.Model {
     });
 }
 
-declare class CallMcpToolRequest extends $dara.Model {
-    args?: string;
-    authorization?: string;
-    externalUserId?: string;
-    imageId?: string;
-    name?: string;
-    server?: string;
-    sessionId?: string;
-    tool?: string;
+declare class ApplyMqttTokenRequest extends $dara.Model {
+    desktopId?: string;
+    sessionToken?: string;
     static names(): {
         [key: string]: string;
     };
@@ -439,9 +204,9 @@ declare class CallMcpToolRequest extends $dara.Model {
     });
 }
 
-declare class CallMcpToolResponseBody extends $dara.Model {
+declare class ApplyMqttTokenResponseBody extends $dara.Model {
     code?: string;
-    data?: any;
+    data?: ApplyMqttTokenResponseBodyData;
     httpStatusCode?: number;
     message?: string;
     requestId?: string;
@@ -458,12 +223,12 @@ declare class CallMcpToolResponseBody extends $dara.Model {
     });
 }
 
-declare class CallMcpToolResponse extends $dara.Model {
+declare class ApplyMqttTokenResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: CallMcpToolResponseBody;
+    body?: ApplyMqttTokenResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -476,13 +241,94 @@ declare class CallMcpToolResponse extends $dara.Model {
     });
 }
 
-declare class CreateMcpSessionRequest extends $dara.Model {
+declare class CallMcpToolRequest extends $dara.Model {
+    args?: string;
     authorization?: string;
-    contextId?: string;
     externalUserId?: string;
     imageId?: string;
-    labels?: string;
+    name?: string;
+    server?: string;
     sessionId?: string;
+    tool?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class CallMcpToolResponseBody extends $dara.Model {
+    code?: string;
+    data?: any;
+    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 CallMcpToolResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: CallMcpToolResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class CreateMcpSessionRequest extends $dara.Model {
+    authorization?: string;
+    contextId?: string;
+    externalUserId?: string;
+    imageId?: string;
+    labels?: string;
+    persistenceDataList?: CreateMcpSessionRequestPersistenceDataList[];
+    sessionId?: string;
+    vpcResource?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class CreateMcpSessionShrinkRequest extends $dara.Model {
+    authorization?: string;
+    contextId?: string;
+    externalUserId?: string;
+    imageId?: string;
+    labels?: string;
+    persistenceDataListShrink?: string;
+    sessionId?: string;
+    vpcResource?: boolean;
     static names(): {
         [key: string]: string;
     };
@@ -636,6 +482,61 @@ declare class GetContextResponse extends $dara.Model {
     });
 }
 
+declare class GetContextInfoRequest extends $dara.Model {
+    authorization?: string;
+    contextId?: string;
+    path?: string;
+    sessionId?: string;
+    taskType?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetContextInfoResponseBody extends $dara.Model {
+    code?: string;
+    data?: GetContextInfoResponseBodyData;
+    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 GetContextInfoResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetContextInfoResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class GetLabelRequest extends $dara.Model {
     authorization?: string;
     maxResults?: number;
@@ -695,6 +596,8 @@ declare class GetLabelResponse extends $dara.Model {
 
 declare class GetLinkRequest extends $dara.Model {
     authorization?: string;
+    port?: number;
+    protocolType?: string;
     sessionId?: string;
     static names(): {
         [key: string]: string;
@@ -710,7 +613,7 @@ declare class GetLinkRequest extends $dara.Model {
 
 declare class GetLinkResponseBody extends $dara.Model {
     code?: string;
-    data?: string;
+    data?: GetLinkResponseBodyData;
     httpStatusCode?: number;
     message?: string;
     requestId?: string;
@@ -797,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;
@@ -853,6 +835,58 @@ declare class ListContextsResponse extends $dara.Model {
     });
 }
 
+declare class ListMcpToolsRequest extends $dara.Model {
+    authorization?: string;
+    imageId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListMcpToolsResponseBody extends $dara.Model {
+    code?: string;
+    data?: string;
+    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 ListMcpToolsResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: ListMcpToolsResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class ListSessionRequest extends $dara.Model {
     authorization?: string;
     labels?: string;
@@ -1065,23 +1099,75 @@ declare class SetLabelResponse extends $dara.Model {
     });
 }
 
-declare const OpenApi: typeof OpenApiDefault.default;
-
-declare class Client extends OpenApi {
-    constructor(config: $OpenApiUtil.Config);
-    getEndpoint(productId: string, regionId: string, endpointRule: string, network: string, suffix: string, endpointMap: {
+declare class SyncContextRequest extends $dara.Model {
+    authorization?: string;
+    contextId?: string;
+    mode?: string;
+    path?: string;
+    sessionId?: string;
+    static names(): {
         [key: string]: string;
-    }, endpoint: string): string;
-    /**
-     * 调用mcp工具
-     *
-     * @param request - CallMcpToolRequest
-     * @param runtime - runtime options for this request RuntimeOptions
-     * @returns CallMcpToolResponse
-     */
-    callMcpToolWithOptions(request: CallMcpToolRequest, runtime: $dara.RuntimeOptions): Promise<CallMcpToolResponse>;
-    /**
-     * 调用mcp工具
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class SyncContextResponseBody extends $dara.Model {
+    code?: string;
+    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 SyncContextResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: SyncContextResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class Client extends OpenApi {
+    constructor(config: $OpenApiUtil.Config);
+    getEndpoint(productId: string, regionId: string, endpointRule: string, network: string, suffix: string, endpointMap: {
+        [key: string]: string;
+    }, endpoint: string): string;
+    /**
+     * 调用mcp工具
+     *
+     * @param request - CallMcpToolRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CallMcpToolResponse
+     */
+    callMcpToolWithOptions(request: CallMcpToolRequest, runtime: $dara.RuntimeOptions): Promise<CallMcpToolResponse>;
+    /**
+     * 调用mcp工具
      *
      * @param request - CallMcpToolRequest
      * @returns CallMcpToolResponse
@@ -1090,11 +1176,11 @@ declare class Client extends OpenApi {
     /**
      * 创建 mcp session
      *
-     * @param request - CreateMcpSessionRequest
+     * @param tmpReq - CreateMcpSessionRequest
      * @param runtime - runtime options for this request RuntimeOptions
      * @returns CreateMcpSessionResponse
      */
-    createMcpSessionWithOptions(request: CreateMcpSessionRequest, runtime: $dara.RuntimeOptions): Promise<CreateMcpSessionResponse>;
+    createMcpSessionWithOptions(tmpReq: CreateMcpSessionRequest, runtime: $dara.RuntimeOptions): Promise<CreateMcpSessionResponse>;
     /**
      * 创建 mcp session
      *
@@ -1132,6 +1218,21 @@ declare class Client extends OpenApi {
      * @returns GetContextResponse
      */
     getContext(request: GetContextRequest): Promise<GetContextResponse>;
+    /**
+     * 获取上下文信息
+     *
+     * @param request - GetContextInfoRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetContextInfoResponse
+     */
+    getContextInfoWithOptions(request: GetContextInfoRequest, runtime: $dara.RuntimeOptions): Promise<GetContextInfoResponse>;
+    /**
+     * 获取上下文信息
+     *
+     * @param request - GetContextInfoRequest
+     * @returns GetContextInfoResponse
+     */
+    getContextInfo(request: GetContextInfoRequest): Promise<GetContextInfoResponse>;
     /**
      * 获取标签
      *
@@ -1192,6 +1293,21 @@ declare class Client extends OpenApi {
      * @returns ListContextsResponse
      */
     listContexts(request: ListContextsRequest): Promise<ListContextsResponse>;
+    /**
+     * ListMcpTools
+     *
+     * @param request - ListMcpToolsRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListMcpToolsResponse
+     */
+    listMcpToolsWithOptions(request: ListMcpToolsRequest, runtime: $dara.RuntimeOptions): Promise<ListMcpToolsResponse>;
+    /**
+     * ListMcpTools
+     *
+     * @param request - ListMcpToolsRequest
+     * @returns ListMcpToolsResponse
+     */
+    listMcpTools(request: ListMcpToolsRequest): Promise<ListMcpToolsResponse>;
     /**
      * 根据Lable查询Session列表
      *
@@ -1252,111 +1368,1157 @@ declare class Client extends OpenApi {
      * @returns SetLabelResponse
      */
     setLabel(request: SetLabelRequest): Promise<SetLabelResponse>;
+    /**
+     * 同步上下文
+     *
+     * @param request - SyncContextRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns SyncContextResponse
+     */
+    syncContextWithOptions(request: SyncContextRequest, runtime: $dara.RuntimeOptions): Promise<SyncContextResponse>;
+    /**
+     * 同步上下文
+     *
+     * @param request - SyncContextRequest
+     * @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 {
+    region_id: string;
+    endpoint: string;
+    timeout_ms: number;
 }
 
 /**
- * Represents an installed application.
+ * Base interface for API responses
  */
-interface InstalledApp {
+interface ApiResponse {
+    /** Optional request identifier for tracking API calls */
+    requestId?: string;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+    /** Optional status code if the operation failed */
+    success?: boolean;
+}
+/**
+ * Interface for delete operation responses
+ */
+interface DeleteResult extends ApiResponse {
+    /** Whether the delete operation was successful */
+    success: boolean;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for session creation operation responses
+ * Corresponds to Python's SessionResult type
+ */
+interface SessionResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the session creation was successful */
+    success: boolean;
+    /** The created session object (only present if successful) */
+    session?: any;
+    /** Error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for operation results
+ * Corresponds to Python's OperationResult type
+ */
+interface OperationResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Optional data payload */
+    data?: any;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for process list operation responses
+ * Corresponds to Python's ProcessListResult type
+ */
+interface ProcessListResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** The list of process objects */
+    data: any[];
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for installed app list operation responses
+ * Corresponds to Python's InstalledAppListResult type
+ */
+interface InstalledAppListResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** The list of installed app objects */
+    data: any[];
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for application operation responses
+ * Corresponds to Python's AppOperationResult type
+ */
+interface AppOperationResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for command execution operation responses
+ * Corresponds to Python's CommandResult type
+ */
+interface CommandResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the command execution was successful */
+    success: boolean;
+    /** The command output */
+    output: string;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for code execution operation responses
+ * Corresponds to Python's CodeExecutionResult type
+ */
+interface CodeExecutionResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the code execution was successful */
+    success: boolean;
+    /** The execution result */
+    result: string;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for boolean operation responses
+ * Corresponds to Python's BoolResult type
+ */
+interface BoolResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Boolean data result */
+    data?: boolean;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for file info operation responses
+ * Corresponds to Python's FileInfoResult type
+ */
+interface FileInfoResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** File information object */
+    fileInfo?: Record<string, any>;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for directory list operation responses
+ * Corresponds to Python's DirectoryListResult type
+ */
+interface DirectoryListResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Directory entries */
+    entries: Record<string, any>[];
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for file content operation responses
+ * Corresponds to Python's FileContentResult type
+ */
+interface FileContentResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** File content */
+    content: string;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for multiple file content operation responses
+ * Corresponds to Python's MultipleFileContentResult type
+ */
+interface MultipleFileContentResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Multiple file contents */
+    contents: Record<string, string>;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for file search operation responses
+ * Corresponds to Python's FileSearchResult type
+ */
+interface FileSearchResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Matching file paths */
+    matches: string[];
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for OSS client creation operation responses
+ * Corresponds to Python's OSSClientResult type
+ */
+interface OSSClientResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** OSS client configuration */
+    clientConfig: Record<string, any>;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for OSS upload operation responses
+ * Corresponds to Python's OSSUploadResult type
+ */
+interface OSSUploadResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Result of the upload operation */
+    content: string;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for OSS download operation responses
+ * Corresponds to Python's OSSDownloadResult type
+ */
+interface OSSDownloadResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Result of the download operation */
+    content: string;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for UI element list operation responses
+ * Corresponds to Python's UIElementListResult type
+ */
+interface UIElementListResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** UI elements */
+    elements: Record<string, any>[];
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for window list operation responses
+ * Corresponds to Python's WindowListResult type
+ */
+interface WindowListResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** List of windows */
+    windows: any[];
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for window info operation responses
+ * Corresponds to Python's WindowInfoResult type
+ */
+interface WindowInfoResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Window object */
+    window?: any;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for context operation responses
+ * Corresponds to Python's ContextResult type
+ */
+interface ContextResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** The context ID */
+    contextId: string;
+    /** The context object (only present if successful) */
+    context?: any;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
+/**
+ * Interface for context list operation responses
+ * Corresponds to Python's ContextListResult type
+ */
+interface ContextListResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    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;
+}
+
+/**
+ * Represents a persistent storage context in the AgentBay cloud environment.
+ */
+declare class Context {
+    /**
+     * The unique identifier of the context.
+     */
+    id: string;
+    /**
+     * The name of the context.
+     */
     name: string;
-    start_cmd: string;
-    stop_cmd?: string;
-    work_directory?: string;
+    /**
+     * The current state of the context (e.g., "available", "in-use").
+     */
+    state: string;
+    /**
+     * Date and time when the Context was created.
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the Context was last used.
+     */
+    lastUsedAt?: string;
+    /**
+     * The operating system type this context is bound to.
+     */
+    osType?: string;
+    /**
+     * Initialize a Context object.
+     *
+     * @param id - The unique identifier of the context.
+     * @param name - The name of the context.
+     * @param state - The current state of the context.
+     * @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.
+     */
+    constructor(id: string, name: string, state?: string, createdAt?: string, lastUsedAt?: string, osType?: string);
 }
 /**
- * Represents a running process.
+ * Parameters for listing contexts with pagination support.
  */
-interface Process {
-    pname: string;
-    pid: number;
-    cmdline?: string;
-    path?: string;
+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;
 }
 /**
- * Handles application management operations in the AgentBay cloud environment.
+ * Provides methods to manage persistent contexts in the AgentBay cloud environment.
  */
-declare class Application {
-    private session;
+declare class ContextService {
+    private agentBay;
     /**
-     * Creates a new Application instance.
-     * @param session The session object that provides access to the AgentBay API.
+     * Initialize the ContextService.
+     *
+     * @param agentBay - The AgentBay instance.
      */
-    constructor(session: {
-        getAPIKey(): string;
-        getClient(): Client;
-        getSessionId(): string;
-    });
+    constructor(agentBay: AgentBay);
     /**
-     * Helper method to call MCP tools and handle common response processing
+     * Lists all available contexts with pagination support.
+     * Corresponds to Python's list() method
      *
-     * @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 params - Optional parameters for listing contexts.
+     * @returns ContextListResult with contexts list and pagination information
      */
-    private callMcpTool;
+    list(params?: ContextListParams): Promise<ContextListResult>;
     /**
-     * Helper method to parse JSON string into objects
+     * Gets a context by name. Optionally creates it if it doesn't exist.
+     * Corresponds to Python's get() method
+     *
+     * @param name - The name of the context to get.
+     * @param create - Whether to create the context if it doesn't exist.
+     * @returns ContextResult with context data and requestId
      */
-    private parseJSON;
+    get(name: string, create?: boolean): Promise<ContextResult>;
     /**
-     * Retrieves 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 Array of InstalledApp objects
-     * @throws Error if the operation fails.
+     * Creates a new context with the given name.
+     * Corresponds to Python's create() method
+     *
+     * @param name - The name for the new context.
+     * @returns ContextResult with created context data and requestId
+     */
+    create(name: string): Promise<ContextResult>;
+    /**
+     * Updates the specified context.
+     * Corresponds to Python's update() method
+     *
+     * @param context - The Context object to update.
+     * @returns OperationResult with updated context data and requestId
+     */
+    update(context: Context): Promise<OperationResult>;
+    /**
+     * Deletes the specified context.
+     * Corresponds to Python's delete() method
+     *
+     * @param context - The Context object to delete.
+     * @returns OperationResult with requestId
+     */
+    delete(context: Context): Promise<OperationResult>;
+}
+
+declare enum UploadStrategy {
+    UploadBeforeResourceRelease = "UploadBeforeResourceRelease"
+}
+declare enum DownloadStrategy {
+    DownloadAsync = "DownloadAsync"
+}
+interface UploadPolicy {
+    autoUpload: boolean;
+    uploadStrategy: UploadStrategy;
+    period?: number;
+}
+interface DownloadPolicy {
+    autoDownload: boolean;
+    downloadStrategy: DownloadStrategy;
+}
+interface DeletePolicy {
+    syncLocalFile: boolean;
+}
+interface WhiteList {
+    path: string;
+    excludePaths?: string[];
+}
+interface BWList {
+    whiteLists?: WhiteList[];
+}
+interface SyncPolicy {
+    uploadPolicy?: UploadPolicy;
+    downloadPolicy?: DownloadPolicy;
+    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;
+    policy?: SyncPolicy;
+    constructor(contextId: string, path: string, policy?: SyncPolicy);
+    withPolicy(policy: SyncPolicy): ContextSync;
+}
+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;
+
+/**
+ * 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;
+    start_cmd: string;
+    stop_cmd?: string;
+    work_directory?: string;
+}
+/**
+ * Represents a running process
+ */
+interface Process {
+    pname: string;
+    pid: number;
+    cmdline?: string;
+    path?: string;
+}
+/**
+ * Handles application operations in the AgentBay cloud environment.
+ */
+declare class Application {
+    private session;
+    /**
+     * 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;
+        }>;
+    });
+    /**
+     * Sanitizes error messages to remove sensitive information like API keys.
+     *
+     * @param error - The error to sanitize
+     * @returns The sanitized error
+     */
+    private sanitizeError;
+    /**
+     * Helper method to parse JSON string into objects
+     */
+    private parseJSON;
+    /**
+     * 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.
+     * @returns InstalledAppListResult with installed apps and requestId
+     * @throws Error if the operation fails.
+     */
+    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
+     *
+     * @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.
+     */
+    startApp(startCmd: string, workDirectory?: string, activity?: string): Promise<ProcessListResult>;
+    /**
+     * Stops an application by process name.
+     * Corresponds to Python's stop_app_by_pname() method
+     *
+     * @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>;
+    /**
+     * Stops an application by process ID.
+     * Corresponds to Python's stop_app_by_pid() method
+     *
+     * @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>;
+    /**
+     * Stops an application by stop command.
+     * Corresponds to Python's stop_app_by_cmd() method
+     *
+     * @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>;
+    /**
+     * Returns a list of currently visible applications.
+     * Corresponds to Python's list_visible_apps() method
+     *
+     * @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;
+    /**
+     * Initialize a Command object.
+     *
+     * @param session - The Session instance that this Command belongs to.
+     */
+    constructor(session: Session);
+    /**
+     * Sanitizes error messages to remove sensitive information like API keys.
+     *
+     * @param error - The error to sanitize
+     * @returns The sanitized error
+     */
+    private sanitizeError;
+    /**
+     * Execute a command in the session environment.
+     * Corresponds to Python's execute_command() method
+     *
+     * @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>;
+}
+
+interface ContextStatusData {
+    contextId: string;
+    path: string;
+    errorMessage: string;
+    status: string;
+    startTime: number;
+    finishTime: number;
+    taskType: string;
+}
+interface ContextStatusItem {
+    type: string;
+    data: string;
+}
+interface ContextInfoResult extends ApiResponse {
+    contextStatusData: ContextStatusData[];
+}
+interface ContextSyncResult extends ApiResponse {
+    success: boolean;
+}
+interface SessionInterface {
+    getAPIKey(): string;
+    getClient(): Client;
+    getSessionId(): string;
+}
+declare class ContextManager {
+    private session;
+    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>;
+}
+declare function newContextManager(session: SessionInterface): ContextManager;
+
+/**
+ * FileInfo represents information about a file or directory
+ */
+interface FileInfo {
+    name: string;
+    path: string;
+    size: number;
+    isDirectory: boolean;
+    modTime: string;
+    mode: string;
+    owner?: string;
+    group?: string;
+}
+/**
+ * DirectoryEntry represents an entry in a directory listing
+ */
+interface DirectoryEntry {
+    name: string;
+    isDirectory: boolean;
+}
+/**
+ * Handles file operations in the AgentBay cloud environment.
+ */
+declare class FileSystem {
+    private session;
+    /**
+     * 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;
+        }>;
+    });
+    /**
+     * Creates a new directory at the specified path.
+     * Corresponds to Python's create_directory() method
+     *
+     * @param path - Path to the directory to create.
+     * @returns BoolResult with creation result and requestId
+     */
+    createDirectory(path: string): Promise<BoolResult>;
+    /**
+     * Edits a file by replacing occurrences of oldText with newText.
+     * Corresponds to Python's edit_file() method
+     *
+     * @param path - Path to the file to edit.
+     * @param edits - Array of edit operations, each containing oldText and newText.
+     * @param dryRun - Optional: If true, preview changes without applying them.
+     * @returns BoolResult with edit result and requestId
+     */
+    editFile(path: string, edits: Array<{
+        oldText: string;
+        newText: string;
+    }>, dryRun?: boolean): Promise<BoolResult>;
+    /**
+     * Gets information about a file or directory.
+     * Corresponds to Python's get_file_info() method
+     *
+     * @param path - Path to the file or directory to inspect.
+     * @returns FileInfoResult with file info and requestId
+     */
+    getFileInfo(path: string): Promise<FileInfoResult>;
+    /**
+     * Lists the contents of a directory.
+     * Corresponds to Python's list_directory() method
+     *
+     * @param path - Path to the directory to list.
+     * @returns DirectoryListResult with directory entries and requestId
+     */
+    listDirectory(path: string): Promise<DirectoryListResult>;
+    /**
+     * Moves a file or directory from source to destination.
+     * Corresponds to Python's move_file() method
+     *
+     * @param source - Path to the source file or directory.
+     * @param destination - Path to the destination file or directory.
+     * @returns BoolResult with move result and requestId
+     */
+    moveFile(source: string, destination: string): Promise<BoolResult>;
+    /**
+     * Reads the content of a file.
+     * Corresponds to Python's read_file() method
+     *
+     * @param path - Path to the file to read.
+     * @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>;
+    /**
+     * Reads the content of multiple files.
+     * Corresponds to Python's read_multiple_files() method
+     *
+     * @param paths - Array of file paths to read.
+     * @returns MultipleFileContentResult with file contents and requestId
+     */
+    readMultipleFiles(paths: string[]): Promise<MultipleFileContentResult>;
+    /**
+     * Searches for files in a directory that match a pattern.
+     * Corresponds to Python's search_files() method
+     *
+     * @param path - Path to the directory to search in.
+     * @param pattern - Pattern to search for. Supports glob patterns.
+     * @param excludePatterns - Optional: Array of patterns to exclude.
+     * @returns FileSearchResult with search results and requestId
+     */
+    searchFiles(path: string, pattern: string, excludePatterns?: string[]): Promise<FileSearchResult>;
+    /**
+     * Writes content to a file.
+     * Corresponds to Python's write_file() method
+     *
+     * @param path - Path to the file to write.
+     * @param content - Content to write to the file.
+     * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
+     * @returns BoolResult with write result and requestId
+     */
+    writeFile(path: string, content: string, mode?: string): Promise<BoolResult>;
+    /**
+     * Reads a large file in chunks to handle size limitations of the underlying API.
+     * Corresponds to Python's read_large_file() method
+     *
+     * @param path - Path to the file to read.
+     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
+     * @returns FileContentResult with complete file content and requestId
+     */
+    readLargeFile(path: string, chunkSize?: number): Promise<FileContentResult>;
+    /**
+     * Writes a large file in chunks to handle size limitations of the underlying API.
+     * Corresponds to Python's write_large_file() method
+     *
+     * @param path - Path to the file to write.
+     * @param content - Content to write to the file.
+     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
+     * @returns BoolResult indicating success or failure with requestId
+     */
+    writeLargeFile(path: string, content: string, chunkSize?: number): Promise<BoolResult>;
+}
+
+/**
+ * Handles OSS operations in the AgentBay cloud environment.
+ */
+declare class Oss {
+    private session;
+    /**
+     * Initialize an Oss object.
+     *
+     * @param session - The Session instance that this Oss belongs to.
+     */
+    constructor(session: Session);
+    /**
+     * Sanitizes error messages to remove sensitive information like API keys.
+     *
+     * @param error - The error to sanitize
+     * @returns The sanitized error
+     */
+    private sanitizeError;
+    /**
+     * Initialize OSS environment variables with the specified credentials.
+     * Corresponds to Python's env_init() method
+     *
+     * @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 file to OSS.
+     * Corresponds to Python's upload() method
+     *
+     * @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 file to OSS using an anonymous URL.
+     * Corresponds to Python's upload_anonymous() method
+     *
+     * @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 a file from OSS.
+     * Corresponds to Python's download() method
+     *
+     * @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 a file from OSS using an anonymous URL.
+     * Corresponds to Python's download_anonymous() method
+     *
+     * @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
+ */
+interface UIElement {
+    bounds: string;
+    className: string;
+    text: string;
+    type: string;
+    resourceId: string;
+    index: number;
+    isParent: boolean;
+    children?: UIElement[];
+}
+/**
+ * Handles UI operations in the AgentBay cloud environment.
+ */
+declare class UI {
+    private session;
+    /**
+     * Initialize a UI object.
+     *
+     * @param session - The Session instance that this UI belongs to.
+     */
+    constructor(session: {
+        getAPIKey(): string;
+        getClient(): any;
+        getSessionId(): string;
+        callMcpTool(toolName: string, args: any): Promise<{
+            success: boolean;
+            data: string;
+            errorMessage: string;
+            requestId: string;
+        }>;
+    });
+    /**
+     * Sanitizes error messages to remove sensitive information like API keys.
+     *
+     * @param error - The error to sanitize
+     * @returns The sanitized error
+     */
+    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 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.
      */
-    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<InstalledApp[]>;
+    getAllUIElements(timeoutMs?: number): Promise<UIElementListResult>;
     /**
-     * Starts an application with the given command and optional working directory.
-     * @param startCmd The command to start the application.
-     * @param workDirectory The working directory for the application. Defaults to an empty string.
-     * @returns Array of Process objects representing the started processes
-     * @throws Error if the operation fails.
+     * Sends a key press event.
+     * Corresponds to Python's send_key() method
+     *
+     * @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.
      */
-    startApp(startCmd: string, workDirectory?: string): Promise<Process[]>;
+    sendKey(key: number): Promise<BoolResult>;
     /**
-     * Stops an application by process name.
-     * @param pname The name of the process to stop.
-     * @throws Error if the operation fails.
+     * 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.
      */
-    stopAppByPName(pname: string): Promise<void>;
+    inputText(text: string): Promise<BoolResult>;
     /**
-     * Stops an application by process ID.
-     * @param pid The ID of the process to stop.
-     * @throws Error if the operation fails.
+     * 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 durationMs - The duration of the swipe in milliseconds. Default is 300ms.
+     * @returns BoolResult with success status and requestId
+     * @throws APIError if the operation fails.
      */
-    stopAppByPID(pid: number): Promise<void>;
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<BoolResult>;
     /**
-     * Stops an application by stop command.
-     * @param stopCmd The command to stop the application.
-     * @throws Error if the operation fails.
+     * 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 use. Default is 'left'
+     * @returns BoolResult with success status and requestId
+     * @throws APIError if the operation fails.
      */
-    stopAppByCmd(stopCmd: string): Promise<void>;
+    click(x: number, y: number, button?: string): Promise<BoolResult>;
     /**
-     * Lists all currently visible applications.
-     * @returns Array of Process objects representing the visible processes
-     * @throws Error if the operation fails.
+     * 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.
      */
-    listVisibleApps(): Promise<Process[]>;
+    screenshot(): Promise<OperationResult>;
 }
 
-/**
- * Represents a window in the system.
- */
-interface Window {
-    window_id: number;
-    title: string;
-    absolute_upper_left_x?: number;
-    absolute_upper_left_y?: number;
-    width?: number;
-    height?: number;
-    pid?: number;
-    pname?: string;
-    child_windows?: Window[];
-}
 /**
  * Handles window management operations in the AgentBay cloud environment.
  */
@@ -1368,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
@@ -1389,202 +2546,227 @@ declare class WindowManager {
     private parseWindowsFromJSON;
     /**
      * Lists all root windows in the system.
-     * @returns Array of Window objects
-     * @throws Error if the operation fails.
+     * Corresponds to Python's list_root_windows() method
+     *
+     * @param timeoutMs - The timeout in milliseconds. Default is 3000ms.
+     * @returns WindowListResult with windows array and requestId
      */
-    listRootWindows(): Promise<Window[]>;
+    listRootWindows(timeoutMs?: number): Promise<WindowListResult>;
     /**
      * Gets the currently active window.
-     * @returns Window object or null if no active window
-     * @throws Error if the operation fails.
+     * Corresponds to Python's get_active_window() method
+     *
+     * @param timeoutMs - The timeout in milliseconds. Default is 3000ms.
+     * @returns WindowInfoResult with active window data and requestId
      */
-    getActiveWindow(): Promise<Window | null>;
+    getActiveWindow(timeoutMs?: number): Promise<WindowInfoResult>;
     /**
      * Activates a window by ID.
+     * Corresponds to Python's activate_window() method
+     *
      * @param windowId The ID of the window to activate.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    activateWindow(windowId: number): Promise<void>;
+    activateWindow(windowId: number): Promise<BoolResult>;
     /**
      * Maximizes a window by ID.
+     * Corresponds to Python's maximize_window() method
+     *
      * @param windowId The ID of the window to maximize.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    maximizeWindow(windowId: number): Promise<void>;
+    maximizeWindow(windowId: number): Promise<BoolResult>;
     /**
      * Minimizes a window by ID.
+     * Corresponds to Python's minimize_window() method
+     *
      * @param windowId The ID of the window to minimize.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    minimizeWindow(windowId: number): Promise<void>;
+    minimizeWindow(windowId: number): Promise<BoolResult>;
     /**
      * Restores a window by ID.
+     * Corresponds to Python's restore_window() method
+     *
      * @param windowId The ID of the window to restore.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    restoreWindow(windowId: number): Promise<void>;
+    restoreWindow(windowId: number): Promise<BoolResult>;
     /**
      * Closes a window by ID.
+     * Corresponds to Python's close_window() method
+     *
      * @param windowId The ID of the window to close.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    closeWindow(windowId: number): Promise<void>;
+    closeWindow(windowId: number): Promise<BoolResult>;
     /**
      * Sets a window to fullscreen by ID.
+     * Corresponds to Python's fullscreen_window() method
+     *
      * @param windowId The ID of the window to set to fullscreen.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    fullscreenWindow(windowId: number): Promise<void>;
+    fullscreenWindow(windowId: number): Promise<BoolResult>;
     /**
      * Resizes a window by ID.
+     * 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.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    resizeWindow(windowId: number, width: number, height: number): Promise<void>;
+    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult>;
     /**
      * Enables or disables focus mode.
+     * Corresponds to Python's focus_mode() method
+     *
      * @param on Whether to enable focus mode.
-     * @throws Error if the operation fails.
+     * @returns BoolResult with requestId
      */
-    focusMode(on: boolean): Promise<void>;
+    focusMode(on: boolean): Promise<BoolResult>;
 }
 
-/**
- * Interface representing a UI element in the UI hierarchy
- */
-interface UIElement {
-    bounds: string;
-    className: string;
-    text: string;
-    type: string;
-    resourceId: string;
-    index: number;
-    isParent: boolean;
-    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.
- */
-declare class UI {
+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);
     /**
-     * Initialize a UI object.
-     *
-     * @param session - The Session instance that this UI belongs to.
+     * Perform an action on the given Playwright Page object, using ActOptions to configure behavior.
+     * Returns the result of the action.
      */
-    constructor(session: Session);
+    act(page: any, options: ActOptions): Promise<ActResult>;
     /**
-     * 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
+     * Async version of act method for performing actions on the given Playwright Page object.
      */
-    private callMcpTool;
+    actAsync(page: any, options: ActOptions): Promise<ActResult>;
     /**
-     * Retrieves all clickable UI elements within the specified timeout.
-     *
-     * @param timeoutMs - The timeout in milliseconds. Default is 2000ms.
-     * @returns An array of UIElement objects
-     * @throws Error if the operation fails.
+     * Observe elements or state on the given Playwright Page object.
+     * Returns a tuple containing (success, results).
      */
-    getClickableUIElements(timeoutMs?: number): Promise<UIElement[]>;
+    observe(page: any, options: ObserveOptions): Promise<[boolean, ObserveResult[]]>;
     /**
-     * Retrieves all UI elements within the specified timeout.
-     *
-     * @param timeoutMs - The timeout in milliseconds. Default is 2000ms.
-     * @returns An array of UIElement objects
-     * @throws Error if the operation fails.
+     * Async version of observe method.
      */
-    getAllUIElements(timeoutMs?: number): Promise<UIElement[]>;
+    observeAsync(page: any, options: ObserveOptions): Promise<[boolean, ObserveResult[]]>;
     /**
-     * Sends a key press event.
-     *
-     * @param key - The key code to send.
-     * @returns The extracted text content from the API response
-     * @throws Error if the operation fails.
+     * Extract information from the given Playwright Page object.
      */
-    sendKey(key: number): Promise<string>;
+    extract<T>(page: any, options: ExtractOptions<T>): Promise<[boolean, T[]]>;
     /**
-     * Inputs text into the active field.
-     *
-     * @param text - The text to input.
-     * @returns The extracted text content from the API response
-     * @throws Error if the operation fails.
+     * 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.
      */
-    inputText(text: string): Promise<string>;
+    initialize(option: BrowserOption): boolean;
     /**
-     * Performs a swipe gesture on the screen.
-     *
-     * @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 The extracted text content from the API response
-     * @throws Error if the operation fails.
+     * Initialize the browser instance with the given options asynchronously.
+     * Returns true if successful, false otherwise.
      */
-    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<string>;
+    initializeAsync(option: BrowserOption): Promise<boolean>;
     /**
-     * Performs a click at the specified coordinates.
-     *
-     * @param x - The X coordinate.
-     * @param y - The Y coordinate.
-     * @param button - The mouse button to click. Default is 'left'.
-     * @returns The extracted text content from the API response
-     * @throws Error if the operation fails.
+     * Returns the endpoint URL if the browser is initialized, otherwise throws an exception.
+     * When initialized, always fetches the latest CDP url from session.getLink().
      */
-    click(x: number, y: number, button?: string): Promise<string>;
+    getEndpointUrl(): Promise<string>;
     /**
-     * Takes a screenshot of the current screen.
-     *
-     * @returns The extracted text content from the API response (usually a base64-encoded image)
-     * @throws Error if the operation fails.
+     * 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.
      */
-    screenshot(): Promise<string>;
+    isInitialized(): boolean;
 }
 
 /**
- * Contains information about a session.
+ * Represents an MCP tool with complete information.
  */
-interface SessionInfo {
-    sessionId: string;
-    resourceUrl: string;
-    appId?: string;
-    authCode?: string;
-    connectionProperties?: string;
-    resourceId?: string;
-    resourceType?: string;
+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.
  */
 declare class Session {
     private agentBay;
-    client: Client;
     sessionId: string;
     resourceUrl: string;
-    filesystem: FileSystem;
+    isVpc: boolean;
+    networkInterfaceIp: string;
+    httpPort: string;
+    fileSystem: FileSystem;
     command: Command;
+    code: Code;
     oss: Oss;
-    Application: Application;
+    application: Application;
     window: WindowManager;
     ui: UI;
+    agent: Agent;
+    browser: Browser;
+    context: ContextManager;
+    mcpTools: McpTool[];
     /**
      * Initialize a Session object.
      *
@@ -1593,151 +2775,259 @@ declare class Session {
      */
     constructor(agentBay: AgentBay, sessionId: string);
     /**
-     * Get information about this session.
-     *
-     * @returns Session information.
+     * Return the API key for this session.
+     */
+    getAPIKey(): string;
+    /**
+     * Return the HTTP client for this session.
+     */
+    getClient(): Client;
+    /**
+     * 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.
      *
-     * @returns True if the session was successfully deleted.
+     * @param syncContext - Whether to sync context data (trigger file uploads) before deleting the session. Defaults to false.
+     * @returns DeleteResult indicating success or failure and request ID
      */
-    delete(): Promise<boolean>;
+    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.
      *
      * @param labels - The labels to set for the session.
-     * @throws APIError if the operation fails.
+     * @returns OperationResult indicating success or failure with request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    setLabels(labels: Record<string, string>): Promise<void>;
+    setLabels(labels: Record<string, string>): Promise<OperationResult>;
     /**
      * Gets the labels for this session.
      *
-     * @returns The labels for the session.
-     * @throws APIError if the operation fails.
+     * @returns OperationResult containing the labels as data and request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    getLabels(): Promise<Record<string, string>>;
+    getLabels(): Promise<OperationResult>;
     /**
-     * Get the API key.
+     * Gets information about this session.
      *
-     * @returns The API key.
+     * @returns OperationResult containing the session information as data and request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    getAPIKey(): string;
+    info(): Promise<OperationResult>;
     /**
-     * Get the client.
+     * Get a link associated with the current session.
      *
-     * @returns The client.
+     * @param protocolType - Optional protocol type to use for the link
+     * @param port - Optional port to use for the link
+     * @returns OperationResult containing the link as data and request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    getClient(): Client;
+    getLink(protocolType?: string, port?: number): Promise<OperationResult>;
     /**
-     * Get the session ID.
+     * Asynchronously get a link associated with the current session.
      *
-     * @returns The session ID.
+     * @param protocolType - Optional protocol type to use for the link
+     * @param port - Optional port to use for the link
+     * @returns OperationResult containing the link as data and request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    getSessionId(): string;
+    getLinkAsync(protocolType?: string, port?: number): Promise<OperationResult>;
     /**
-     * Gets information about this session.
+     * List MCP tools available for this session.
      *
-     * @returns Information about the session.
-     * @throws APIError if the operation fails.
+     * @param imageId Optional image ID, defaults to session's imageId or "linux_latest"
+     * @returns McpToolsResult containing tools list and request ID
      */
-    info(): Promise<SessionInfo>;
+    listMcpTools(imageId?: string): Promise<McpToolsResult>;
     /**
-     * Gets the link for this session.
+     * Call an MCP tool and return the result in a format compatible with Agent.
      *
-     * @returns The link for the session.
-     * @throws APIError if the operation fails.
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @returns McpToolResult containing the response data
      */
-    getLink(): Promise<string>;
+    callMcpTool(toolName: string, args: any): Promise<McpToolResult>;
 }
 
 /**
- * Represents a persistent storage context in the AgentBay cloud environment.
+ * Browser context configuration for session.
  */
-declare class Context {
+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>;
     /**
-     * The unique identifier of the context.
+     * @deprecated This field is deprecated and will be removed in a future version.
+     * Please use contextSync instead for more flexible and powerful data persistence.
      */
-    id: string;
+    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>;
     /**
-     * The name of the context.
+     * 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.
      */
-    name: string;
+    contextId?: string;
+    /** Image ID to use for the session. */
+    imageId?: string;
     /**
-     * The current state of the context (e.g., "available", "in-use").
+     * List of context synchronization configurations.
+     * These configurations define how contexts should be synchronized and mounted.
      */
-    state: string;
+    contextSync: ContextSync[];
+    /** Optional configuration for browser data synchronization. */
+    browserContext?: BrowserContext;
+    /** Whether to create a VPC-based session. Defaults to false. */
+    isVpc: boolean;
+    constructor();
     /**
-     * Date and time when the Context was created.
+     * WithLabels sets the labels for the session parameters and returns the updated parameters.
      */
-    createdAt?: string;
+    withLabels(labels: Record<string, string>): CreateSessionParams$1;
     /**
-     * Date and time when the Context was last used.
+     * WithContextID sets the context ID for the session parameters and returns the updated parameters.
      */
-    lastUsedAt?: string;
+    withContextID(contextId: string): CreateSessionParams$1;
     /**
-     * The operating system type this context is bound to.
+     * WithImageId sets the image ID for the session parameters and returns the updated parameters.
      */
-    osType?: string;
+    withImageId(imageId: string): CreateSessionParams$1;
     /**
-     * Initialize a Context object.
-     *
-     * @param id - The unique identifier of the context.
-     * @param name - The name of the context.
-     * @param state - The current state of the context.
-     * @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.
+     * WithBrowserContext sets the browser context for the session parameters and returns the updated parameters.
      */
-    constructor(id: string, name: string, state?: string, createdAt?: string, lastUsedAt?: string, osType?: string);
-}
-/**
- * Provides methods to manage persistent contexts in the AgentBay cloud environment.
- */
-declare class ContextService {
-    private agentBay;
+    withBrowserContext(browserContext: BrowserContext): CreateSessionParams$1;
     /**
-     * Initialize the ContextService.
-     *
-     * @param agentBay - The AgentBay instance.
+     * WithIsVpc sets the VPC flag for the session parameters and returns the updated parameters.
      */
-    constructor(agentBay: AgentBay);
+    withIsVpc(isVpc: boolean): CreateSessionParams$1;
     /**
-     * Lists all available contexts.
-     *
-     * @returns A list of Context objects.
+     * GetLabelsJSON returns the labels as a JSON string.
+     * Returns an object with success status and result/error message to match Go version behavior.
      */
-    list(): Promise<Context[]>;
+    getLabelsJSON(): {
+        result: string;
+        error?: string;
+    };
     /**
-     * Gets a context by name. Optionally creates it if it doesn't exist.
-     *
-     * @param name - The name of the context to get.
-     * @param create - Whether to create the context if it doesn't exist.
-     * @returns The Context object if found or created, null if not found and create is false.
+     * AddContextSync adds a context sync configuration to the session parameters.
      */
-    get(name: string, create?: boolean): Promise<Context | null>;
+    addContextSync(contextId: string, path: string, policy?: SyncPolicy): CreateSessionParams$1;
     /**
-     * Creates a new context with the given name.
-     *
-     * @param name - The name for the new context.
-     * @returns The created Context object.
+     * AddContextSyncConfig adds a pre-configured context sync to the session parameters.
      */
-    create(name: string): Promise<Context>;
+    addContextSyncConfig(contextSync: ContextSync): CreateSessionParams$1;
     /**
-     * Updates the specified context.
-     *
-     * @param context - The Context object to update.
-     * @returns The updated Context object.
+     * WithContextSync sets the context sync configurations for the session parameters.
      */
-    update(context: Context): Promise<Context>;
+    withContextSync(contextSyncs: ContextSync[]): CreateSessionParams$1;
     /**
-     * Deletes the specified context.
-     *
-     * @param context - The Context object to delete.
+     * Convert to plain object for JSON serialization
+     */
+    toJSON(): CreateSessionParamsConfig;
+    /**
+     * Create from plain object
      */
-    delete(context: Context): Promise<void>;
+    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
+ */
+interface ListSessionParams {
+    /** Number of results per page (default: 10) */
+    maxResults?: number;
+    /** Token for the next page */
+    nextToken?: string;
+    /** Labels to filter by */
+    labels: Record<string, string>;
+}
+/**
+ * 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[];
+    /** Token for the next page (if available) */
+    nextToken?: string;
+    /** Number of results per page */
+    maxResults?: number;
+    /** Total number of results */
+    totalCount?: number;
 }
 
+/**
+ * Parameters for creating a session.
+ */
+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.
  */
@@ -1756,23 +3046,19 @@ 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.
      */
     constructor(options?: {
         apiKey?: string;
+        config?: Config;
     });
     /**
      * Create a new session in the AgentBay cloud environment.
      *
-     * @param options - Optional parameters for creating the session
-     * @param options.contextId - ID of the context to bind to the session
-     * @param options.labels - Custom labels for the session
-     * @returns A new Session object.
+     * @param params - Optional parameters for creating the session
+     * @returns SessionResult containing the created session and request ID
      */
-    create(options?: {
-        contextId?: string;
-        labels?: Record<string, string>;
-        imageId?: string;
-    }): Promise<Session>;
+    create(params?: CreateSessionParams): Promise<SessionResult>;
     /**
      * List all available sessions.
      *
@@ -1780,20 +3066,23 @@ declare class AgentBay {
      */
     list(): Session[];
     /**
-     * List sessions filtered by the provided labels.
+     * List sessions filtered by the provided labels with pagination support.
      * It returns sessions that match all the specified labels.
      *
-     * @param labels - The labels to filter by.
-     * @returns A list of session objects that match the labels.
+     * **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(labels: Record<string, string>): Promise<Session[]>;
+    listByLabels(params?: ListSessionParams): Promise<SessionListResult>;
     /**
-     * Delete a session by ID.
+     * Delete a session by session object.
      *
-     * @param sessionId - The ID of the session to delete.
-     * @returns True if the session was successfully deleted.
+     * @param session - The session to delete.
+     * @param syncContext - Whether to sync context data (trigger file uploads) before deleting the session. Defaults to false.
+     * @returns DeleteResult indicating success or failure and request ID
      */
-    delete(session: Session): Promise<boolean>;
+    delete(session: Session, syncContext?: boolean): Promise<DeleteResult>;
     /**
      *
      * @param sessionId - The ID of the session to remove.
@@ -1804,34 +3093,82 @@ declare class AgentBay {
 }
 
 /**
- * Base exception for all AgentBay errors.
+ * Base exception for all AgentBay SDK errors.
  */
 declare class AgentBayError extends Error {
-    constructor(message: string);
+    extra: Record<string, any>;
+    constructor(message?: string, extra?: Record<string, any>);
 }
 /**
  * Raised when there is an authentication error.
  */
 declare class AuthenticationError extends AgentBayError {
-    constructor(message: string);
+    constructor(message?: string, extra?: Record<string, any>);
 }
 /**
  * Raised when there is an error with the API.
  */
 declare class APIError extends AgentBayError {
-    constructor(message: string);
+    statusCode?: number;
+    constructor(message?: string, statusCode?: number, extra?: Record<string, any>);
 }
 /**
- * Raised when there is an error with file operations.
+ * Raised for errors related to file operations.
  */
 declare class FileError extends AgentBayError {
-    constructor(message: string);
+    constructor(message?: string, extra?: Record<string, any>);
 }
 /**
- * Raised when there is an error with command execution.
+ * Raised for errors related to command execution.
  */
 declare class CommandError extends AgentBayError {
-    constructor(message: string);
+    constructor(message?: string, extra?: Record<string, any>);
+}
+/**
+ * Raised for errors related to session operations.
+ */
+declare class SessionError extends AgentBayError {
+    constructor(message?: string, extra?: Record<string, any>);
+}
+/**
+ * Raised for errors related to OSS operations.
+ */
+declare class OssError extends AgentBayError {
+    constructor(message?: string, extra?: Record<string, any>);
 }
+/**
+ * Raised for errors related to application operations.
+ */
+declare class ApplicationError extends AgentBayError {
+    constructor(message?: string, extra?: Record<string, any>);
+}
+/**
+ * Raised for errors related to UI operations.
+ */
+declare class UIError extends AgentBayError {
+    constructor(message?: string, extra?: Record<string, any>);
+}
+/**
+ * Raised for errors related to browser operations.
+ */
+declare class BrowserError extends AgentBayError {
+    constructor(message?: string, extra?: Record<string, any>);
+}
+
+/**
+ * Utility functions for logging in a clean format
+ */
+/**
+ * Log a message without the log prefix and file location
+ * @param message The message to log
+ * @param args Optional arguments to log
+ */
+declare function log(message: string, ...args: any[]): void;
+/**
+ * Log an error message
+ * @param message The error message to log
+ * @param error Optional error object
+ */
+declare function logError(message: string, error?: any): void;
 
-export { APIError, AgentBay, AgentBayError, Application, AuthenticationError, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, type CodeExecutionResult, Command, CommandError, type CommandResult, Context, ContextService, CreateMcpSessionRequest, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DirectoryEntry, FileError, type FileInfo, FileSystem, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, type InstalledApp, KeyCode, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, Oss, type Process, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, UI, type UIElement };
+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 };