wuying-agentbay-sdk 0.3.0 → 0.4.2

package/dist/index.d.ts

@@ -1,302 +1,41 @@
 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 {
@@ -337,6 +76,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 +104,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,6 +186,58 @@ declare class ListSessionResponseBodyData extends $dara.Model {
     });
 }
 
+declare class ApplyMqttTokenRequest extends $dara.Model {
+    desktopId?: string;
+    sessionToken?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ApplyMqttTokenResponseBody extends $dara.Model {
+    code?: string;
+    data?: ApplyMqttTokenResponseBodyData;
+    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 ApplyMqttTokenResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: ApplyMqttTokenResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class CallMcpToolRequest extends $dara.Model {
     args?: string;
     authorization?: string;
@@ -482,6 +302,27 @@ declare class CreateMcpSessionRequest extends $dara.Model {
     externalUserId?: string;
     imageId?: string;
     labels?: string;
+    persistenceDataList?: CreateMcpSessionRequestPersistenceDataList[];
+    sessionId?: string;
+    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;
     static names(): {
         [key: string]: string;
@@ -636,6 +477,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 +591,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 +608,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;
@@ -727,12 +625,120 @@ declare class GetLinkResponseBody extends $dara.Model {
     });
 }
 
-declare class GetLinkResponse extends $dara.Model {
+declare class GetLinkResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetLinkResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetMcpResourceRequest extends $dara.Model {
+    authorization?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetMcpResourceResponseBody extends $dara.Model {
+    code?: string;
+    data?: GetMcpResourceResponseBodyData;
+    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 GetMcpResourceResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetMcpResourceResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListContextsRequest extends $dara.Model {
+    authorization?: string;
+    maxResults?: number;
+    nextToken?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListContextsResponseBody extends $dara.Model {
+    code?: string;
+    data?: ListContextsResponseBodyData[];
+    httpStatusCode?: number;
+    maxResults?: number;
+    message?: string;
+    nextToken?: string;
+    requestId?: string;
+    success?: boolean;
+    totalCount?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListContextsResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: GetLinkResponseBody;
+    body?: ListContextsResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -745,9 +751,9 @@ declare class GetLinkResponse extends $dara.Model {
     });
 }
 
-declare class GetMcpResourceRequest extends $dara.Model {
+declare class ListMcpToolsRequest extends $dara.Model {
     authorization?: string;
-    sessionId?: string;
+    imageId?: string;
     static names(): {
         [key: string]: string;
     };
@@ -760,9 +766,9 @@ declare class GetMcpResourceRequest extends $dara.Model {
     });
 }
 
-declare class GetMcpResourceResponseBody extends $dara.Model {
+declare class ListMcpToolsResponseBody extends $dara.Model {
     code?: string;
-    data?: GetMcpResourceResponseBodyData;
+    data?: string;
     httpStatusCode?: number;
     message?: string;
     requestId?: string;
@@ -779,12 +785,12 @@ declare class GetMcpResourceResponseBody extends $dara.Model {
     });
 }
 
-declare class GetMcpResourceResponse extends $dara.Model {
+declare class ListMcpToolsResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: GetMcpResourceResponseBody;
+    body?: ListMcpToolsResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -797,8 +803,9 @@ declare class GetMcpResourceResponse extends $dara.Model {
     });
 }
 
-declare class ListContextsRequest extends $dara.Model {
+declare class ListSessionRequest extends $dara.Model {
     authorization?: string;
+    labels?: string;
     maxResults?: number;
     nextToken?: string;
     static names(): {
@@ -813,9 +820,9 @@ declare class ListContextsRequest extends $dara.Model {
     });
 }
 
-declare class ListContextsResponseBody extends $dara.Model {
+declare class ListSessionResponseBody extends $dara.Model {
     code?: string;
-    data?: ListContextsResponseBodyData[];
+    data?: ListSessionResponseBodyData[];
     httpStatusCode?: number;
     maxResults?: number;
     message?: string;
@@ -835,12 +842,12 @@ declare class ListContextsResponseBody extends $dara.Model {
     });
 }
 
-declare class ListContextsResponse extends $dara.Model {
+declare class ListSessionResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: ListContextsResponseBody;
+    body?: ListSessionResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -853,11 +860,10 @@ declare class ListContextsResponse extends $dara.Model {
     });
 }
 
-declare class ListSessionRequest extends $dara.Model {
+declare class ModifyContextRequest extends $dara.Model {
     authorization?: string;
-    labels?: string;
-    maxResults?: number;
-    nextToken?: string;
+    id?: string;
+    name?: string;
     static names(): {
         [key: string]: string;
     };
@@ -870,16 +876,12 @@ declare class ListSessionRequest extends $dara.Model {
     });
 }
 
-declare class ListSessionResponseBody extends $dara.Model {
+declare class ModifyContextResponseBody extends $dara.Model {
     code?: string;
-    data?: ListSessionResponseBodyData[];
     httpStatusCode?: number;
-    maxResults?: number;
     message?: string;
-    nextToken?: string;
     requestId?: string;
     success?: boolean;
-    totalCount?: number;
     static names(): {
         [key: string]: string;
     };
@@ -892,12 +894,12 @@ declare class ListSessionResponseBody extends $dara.Model {
     });
 }
 
-declare class ListSessionResponse extends $dara.Model {
+declare class ModifyContextResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: ListSessionResponseBody;
+    body?: ModifyContextResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -910,10 +912,9 @@ declare class ListSessionResponse extends $dara.Model {
     });
 }
 
-declare class ModifyContextRequest extends $dara.Model {
+declare class ReleaseMcpSessionRequest extends $dara.Model {
     authorization?: string;
-    id?: string;
-    name?: string;
+    sessionId?: string;
     static names(): {
         [key: string]: string;
     };
@@ -926,7 +927,7 @@ declare class ModifyContextRequest extends $dara.Model {
     });
 }
 
-declare class ModifyContextResponseBody extends $dara.Model {
+declare class ReleaseMcpSessionResponseBody extends $dara.Model {
     code?: string;
     httpStatusCode?: number;
     message?: string;
@@ -944,12 +945,12 @@ declare class ModifyContextResponseBody extends $dara.Model {
     });
 }
 
-declare class ModifyContextResponse extends $dara.Model {
+declare class ReleaseMcpSessionResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: ModifyContextResponseBody;
+    body?: ReleaseMcpSessionResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -962,8 +963,9 @@ declare class ModifyContextResponse extends $dara.Model {
     });
 }
 
-declare class ReleaseMcpSessionRequest extends $dara.Model {
+declare class SetLabelRequest extends $dara.Model {
     authorization?: string;
+    labels?: string;
     sessionId?: string;
     static names(): {
         [key: string]: string;
@@ -977,7 +979,7 @@ declare class ReleaseMcpSessionRequest extends $dara.Model {
     });
 }
 
-declare class ReleaseMcpSessionResponseBody extends $dara.Model {
+declare class SetLabelResponseBody extends $dara.Model {
     code?: string;
     httpStatusCode?: number;
     message?: string;
@@ -995,12 +997,12 @@ declare class ReleaseMcpSessionResponseBody extends $dara.Model {
     });
 }
 
-declare class ReleaseMcpSessionResponse extends $dara.Model {
+declare class SetLabelResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: ReleaseMcpSessionResponseBody;
+    body?: SetLabelResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -1013,9 +1015,11 @@ declare class ReleaseMcpSessionResponse extends $dara.Model {
     });
 }
 
-declare class SetLabelRequest extends $dara.Model {
+declare class SyncContextRequest extends $dara.Model {
     authorization?: string;
-    labels?: string;
+    contextId?: string;
+    mode?: string;
+    path?: string;
     sessionId?: string;
     static names(): {
         [key: string]: string;
@@ -1029,7 +1033,7 @@ declare class SetLabelRequest extends $dara.Model {
     });
 }
 
-declare class SetLabelResponseBody extends $dara.Model {
+declare class SyncContextResponseBody extends $dara.Model {
     code?: string;
     httpStatusCode?: number;
     message?: string;
@@ -1047,12 +1051,12 @@ declare class SetLabelResponseBody extends $dara.Model {
     });
 }
 
-declare class SetLabelResponse extends $dara.Model {
+declare class SyncContextResponse extends $dara.Model {
     headers?: {
         [key: string]: string;
     };
     statusCode?: number;
-    body?: SetLabelResponseBody;
+    body?: SyncContextResponseBody;
     static names(): {
         [key: string]: string;
     };
@@ -1065,8 +1069,6 @@ 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: {
@@ -1090,11 +1092,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 +1134,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 +1209,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列表
      *
@@ -1214,45 +1246,518 @@ declare class Client extends OpenApi {
      * @param runtime - runtime options for this request RuntimeOptions
      * @returns ModifyContextResponse
      */
-    modifyContextWithOptions(request: ModifyContextRequest, runtime: $dara.RuntimeOptions): Promise<ModifyContextResponse>;
+    modifyContextWithOptions(request: ModifyContextRequest, runtime: $dara.RuntimeOptions): Promise<ModifyContextResponse>;
+    /**
+     * 修改上下文
+     *
+     * @param request - ModifyContextRequest
+     * @returns ModifyContextResponse
+     */
+    modifyContext(request: ModifyContextRequest): Promise<ModifyContextResponse>;
+    /**
+     * 释放 mcp session
+     *
+     * @param request - ReleaseMcpSessionRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ReleaseMcpSessionResponse
+     */
+    releaseMcpSessionWithOptions(request: ReleaseMcpSessionRequest, runtime: $dara.RuntimeOptions): Promise<ReleaseMcpSessionResponse>;
+    /**
+     * 释放 mcp session
+     *
+     * @param request - ReleaseMcpSessionRequest
+     * @returns ReleaseMcpSessionResponse
+     */
+    releaseMcpSession(request: ReleaseMcpSessionRequest): Promise<ReleaseMcpSessionResponse>;
+    /**
+     * 设置标签
+     *
+     * @param request - SetLabelRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns SetLabelResponse
+     */
+    setLabelWithOptions(request: SetLabelRequest, runtime: $dara.RuntimeOptions): Promise<SetLabelResponse>;
+    /**
+     * 设置标签
+     *
+     * @param request - SetLabelRequest
+     * @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>;
+}
+
+interface Config {
+    region_id: string;
+    endpoint: string;
+    timeout_ms: number;
+}
+
+/**
+ * Base interface for API responses
+ */
+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[];
+    /** 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;
+    /**
+     * 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);
+}
+/**
+ * Provides methods to manage persistent contexts in the AgentBay cloud environment.
+ */
+declare class ContextService {
+    private agentBay;
+    /**
+     * Initialize the ContextService.
+     *
+     * @param agentBay - The AgentBay instance.
+     */
+    constructor(agentBay: AgentBay);
     /**
-     * 修改上下文
+     * Lists all available contexts.
+     * Corresponds to Python's list() method
      *
-     * @param request - ModifyContextRequest
-     * @returns ModifyContextResponse
+     * @returns ContextListResult with contexts list and requestId
      */
-    modifyContext(request: ModifyContextRequest): Promise<ModifyContextResponse>;
+    list(): Promise<ContextListResult>;
     /**
-     * 释放 mcp session
+     * Gets a context by name. Optionally creates it if it doesn't exist.
+     * Corresponds to Python's get() method
      *
-     * @param request - ReleaseMcpSessionRequest
-     * @param runtime - runtime options for this request RuntimeOptions
-     * @returns ReleaseMcpSessionResponse
+     * @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
      */
-    releaseMcpSessionWithOptions(request: ReleaseMcpSessionRequest, runtime: $dara.RuntimeOptions): Promise<ReleaseMcpSessionResponse>;
+    get(name: string, create?: boolean): Promise<ContextResult>;
     /**
-     * 释放 mcp session
+     * Creates a new context with the given name.
+     * Corresponds to Python's create() method
      *
-     * @param request - ReleaseMcpSessionRequest
-     * @returns ReleaseMcpSessionResponse
+     * @param name - The name for the new context.
+     * @returns ContextResult with created context data and requestId
      */
-    releaseMcpSession(request: ReleaseMcpSessionRequest): Promise<ReleaseMcpSessionResponse>;
+    create(name: string): Promise<ContextResult>;
     /**
-     * 设置标签
+     * Updates the specified context.
+     * Corresponds to Python's update() method
      *
-     * @param request - SetLabelRequest
-     * @param runtime - runtime options for this request RuntimeOptions
-     * @returns SetLabelResponse
+     * @param context - The Context object to update.
+     * @returns OperationResult with updated context data and requestId
      */
-    setLabelWithOptions(request: SetLabelRequest, runtime: $dara.RuntimeOptions): Promise<SetLabelResponse>;
+    update(context: Context): Promise<OperationResult>;
     /**
-     * 设置标签
+     * Deletes the specified context.
+     * Corresponds to Python's delete() method
      *
-     * @param request - SetLabelRequest
-     * @returns SetLabelResponse
+     * @param context - The Context object to delete.
+     * @returns OperationResult with requestId
      */
-    setLabel(request: SetLabelRequest): Promise<SetLabelResponse>;
+    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 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 newContextSync(contextId: string, path: string, policy?: SyncPolicy): ContextSync;
 
 /**
  * Represents an installed application.
@@ -1302,75 +1807,175 @@ declare class Application {
     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 Array of InstalledApp objects
+     * @returns InstalledAppListResult with installed apps and requestId
      * @throws Error if the operation fails.
      */
-    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<InstalledApp[]>;
+    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.
-     * @returns Array of Process objects representing the started processes
+     * @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): Promise<Process[]>;
+    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 name of the process to stop.
+     * @returns AppOperationResult with requestId
      * @throws Error if the operation fails.
      */
-    stopAppByPName(pname: string): Promise<void>;
+    stopAppByPName(pname: string): Promise<AppOperationResult>;
     /**
      * Stops an application by process ID.
+     * Corresponds to Python's stop_app_by_pid() method
+     *
      * @param pid The ID of the process to stop.
+     * @returns AppOperationResult with requestId
      * @throws Error if the operation fails.
      */
-    stopAppByPID(pid: number): Promise<void>;
+    stopAppByPID(pid: number): Promise<AppOperationResult>;
     /**
      * Stops an application by stop command.
+     * Corresponds to Python's stop_app_by_cmd() method
+     *
      * @param stopCmd The command to stop the application.
+     * @returns AppOperationResult with requestId
      * @throws Error if the operation fails.
      */
-    stopAppByCmd(stopCmd: string): Promise<void>;
+    stopAppByCmd(stopCmd: string): Promise<AppOperationResult>;
     /**
      * Lists all currently visible applications.
-     * @returns Array of Process objects representing the visible processes
+     * Corresponds to Python's list_visible_apps() method
+     *
+     * @returns ProcessListResult with visible processes and requestId
      * @throws Error if the operation fails.
      */
-    listVisibleApps(): Promise<Process[]>;
+    listVisibleApps(): Promise<ProcessListResult>;
+}
+
+/**
+ * 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;
+    /**
+     * Execute a command in the cloud environment with a specified timeout.
+     * Corresponds to Python's execute_command() method
+     *
+     * @param command - The command to execute.
+     * @param timeoutMs - The timeout for the command execution in milliseconds. Default is 1000ms.
+     * @returns CommandResult with command output and requestId
+     */
+    executeCommand(command: string, timeoutMs?: number): Promise<CommandResult>;
+    /**
+     * Execute code in the specified language with a timeout.
+     * Corresponds to Python's run_code() method
+     *
+     * @param code - The code to execute.
+     * @param language - The programming language of the code. Must be either 'python' or 'javascript'.
+     * @param timeoutS - The timeout for the code execution in seconds. Default is 300s.
+     * @returns CodeExecutionResult with code execution output and requestId
+     * @throws Error if an unsupported language is specified.
+     */
+    runCode(code: string, language: string, timeoutS?: number): Promise<CodeExecutionResult>;
+}
+
+interface ContextStatusData {
+    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;
 
 /**
- * Represents a window in the system.
+ * 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 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[];
+interface DirectoryEntry {
+    name: string;
+    isDirectory: boolean;
 }
 /**
- * Handles window management operations in the AgentBay cloud environment.
+ * Handles file operations in the AgentBay cloud environment.
  */
-declare class WindowManager {
+declare class FileSystem {
     private session;
+    private client;
+    private baseUrl;
     /**
-     * Creates a new WindowManager instance.
-     * @param session The session object that provides access to the AgentBay API.
+     * Initialize a FileSystem object.
+     *
+     * @param session - The Session instance that this FileSystem belongs to.
      */
-    constructor(session: {
-        getAPIKey(): string;
-        getClient(): any;
-        getSessionId(): string;
-    });
+    constructor(session: Session);
     /**
      * Helper method to call MCP tools and handle common response processing
      *
@@ -1382,73 +1987,183 @@ declare class WindowManager {
      */
     private callMcpTool;
     /**
-     * Helper method to parse JSON string into Window objects
-     * @param jsonStr - JSON string to parse
-     * @returns Array of Window objects or single Window object
+     * 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
      */
-    private parseWindowsFromJSON;
+    createDirectory(path: string): Promise<BoolResult>;
     /**
-     * Lists all root windows in the system.
-     * @returns Array of Window objects
-     * @throws Error if the operation fails.
+     * 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
      */
-    listRootWindows(): Promise<Window[]>;
+    editFile(path: string, edits: Array<{
+        oldText: string;
+        newText: string;
+    }>, dryRun?: boolean): Promise<BoolResult>;
     /**
-     * Gets the currently active window.
-     * @returns Window object or null if no active window
-     * @throws Error if the operation fails.
+     * 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
      */
-    getActiveWindow(): Promise<Window | null>;
+    getFileInfo(path: string): Promise<FileInfoResult>;
     /**
-     * Activates a window by ID.
-     * @param windowId The ID of the window to activate.
-     * @throws Error if the operation fails.
+     * 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
      */
-    activateWindow(windowId: number): Promise<void>;
+    listDirectory(path: string): Promise<DirectoryListResult>;
     /**
-     * Maximizes a window by ID.
-     * @param windowId The ID of the window to maximize.
-     * @throws Error if the operation fails.
+     * 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
      */
-    maximizeWindow(windowId: number): Promise<void>;
+    moveFile(source: string, destination: string): Promise<BoolResult>;
     /**
-     * Minimizes a window by ID.
-     * @param windowId The ID of the window to minimize.
-     * @throws Error if the operation fails.
+     * Reads the content of a file.
+     * Corresponds to Python's read_file() method
+     *
+     * @param path - Path to the file to read.
+     * @param offset - Optional: Line offset to start reading from.
+     * @param length - Optional: Number of lines to read. If 0, reads the entire file.
+     * @returns FileContentResult with file content and requestId
      */
-    minimizeWindow(windowId: number): Promise<void>;
+    readFile(path: string, offset?: number, length?: number): Promise<FileContentResult>;
     /**
-     * Restores a window by ID.
-     * @param windowId The ID of the window to restore.
-     * @throws Error if the operation fails.
+     * 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
      */
-    restoreWindow(windowId: number): Promise<void>;
+    readMultipleFiles(paths: string[]): Promise<MultipleFileContentResult>;
     /**
-     * Closes a window by ID.
-     * @param windowId The ID of the window to close.
-     * @throws Error if the operation fails.
+     * 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
      */
-    closeWindow(windowId: number): Promise<void>;
+    searchFiles(path: string, pattern: string, excludePatterns?: string[]): Promise<FileSearchResult>;
     /**
-     * Sets a window to fullscreen by ID.
-     * @param windowId The ID of the window to set to fullscreen.
-     * @throws Error if the operation fails.
+     * 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 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.
+     * Corresponds to Python's env_init() method
+     *
+     * @param accessKeyId - The Access Key ID for OSS authentication.
+     * @param accessKeySecret - The Access Key Secret for OSS authentication.
+     * @param securityToken - The security token for OSS authentication.
+     * @param endpoint - The OSS service endpoint. If not specified, the default is used.
+     * @param region - The OSS region. If not specified, the default is used.
+     * @returns OSSClientResult with initialization result and requestId
+     */
+    envInit(accessKeyId: string, accessKeySecret: string, securityToken?: string, endpoint?: string, region?: string): Promise<OSSClientResult>;
+    /**
+     * Upload a local file or directory to OSS.
+     * Corresponds to Python's upload() method
+     *
+     * @param bucket - OSS bucket name.
+     * @param object - ObjectS.
+     * @param path - Local file or directory path to upload.
+     * @returns OSSUploadResult with upload result and requestId
+     */
+    upload(bucket: string, object: string, path: string): Promise<OSSUploadResult>;
+    /**
+     * Upload a local file or directory to OSS using a pre-signed URL.
+     * Corresponds to Python's upload_anonymous() method
+     *
+     * @param url - Pre-signed URL for anonymous upload.
+     * @param path - Local file or directory path to upload.
+     * @returns OSSUploadResult with upload result and requestId
      */
-    fullscreenWindow(windowId: number): Promise<void>;
+    uploadAnonymous(url: string, path: string): Promise<OSSUploadResult>;
     /**
-     * Resizes a window by ID.
-     * @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.
+     * Download an object from OSS to a local file or directory.
+     * Corresponds to Python's download() method
+     *
+     * @param bucket - OSS bucket name.
+     * @param object - Object key in OSS.
+     * @param path - Local file or directory path to save the downloaded content.
+     * @returns OSSDownloadResult with download result and requestId
      */
-    resizeWindow(windowId: number, width: number, height: number): Promise<void>;
+    download(bucket: string, object: string, path: string): Promise<OSSDownloadResult>;
     /**
-     * Enables or disables focus mode.
-     * @param on Whether to enable focus mode.
-     * @throws Error if the operation fails.
+     * Download an object from OSS using a pre-signed URL.
+     * Corresponds to Python's download_anonymous() method
+     *
+     * @param url - Pre-signed URL for anonymous download.
+     * @param path - Local file or directory path to save the downloaded content.
+     * @returns OSSDownloadResult with download result and requestId
      */
-    focusMode(on: boolean): Promise<void>;
+    downloadAnonymous(url: string, path: string): Promise<OSSDownloadResult>;
 }
 
 /**
@@ -1498,246 +2213,298 @@ declare class UI {
     private callMcpTool;
     /**
      * 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 An array of UIElement objects
-     * @throws Error if the operation fails.
+     * @returns UIElementListResult with clickable UI elements and requestId
      */
-    getClickableUIElements(timeoutMs?: number): Promise<UIElement[]>;
+    getClickableUIElements(timeoutMs?: number): Promise<UIElementListResult>;
     /**
      * Retrieves all UI elements within the specified timeout.
+     * Corresponds to Python's get_all_ui_elements() method
      *
      * @param timeoutMs - The timeout in milliseconds. Default is 2000ms.
-     * @returns An array of UIElement objects
-     * @throws Error if the operation fails.
+     * @returns UIElementListResult with all UI elements and requestId
      */
-    getAllUIElements(timeoutMs?: number): Promise<UIElement[]>;
+    getAllUIElements(timeoutMs?: number): Promise<UIElementListResult>;
     /**
      * Sends a key press event.
+     * Corresponds to Python's send_key() method
      *
      * @param key - The key code to send.
-     * @returns The extracted text content from the API response
-     * @throws Error if the operation fails.
+     * @returns BoolResult with key press result and requestId
      */
-    sendKey(key: number): Promise<string>;
+    sendKey(key: number): Promise<BoolResult>;
     /**
      * Inputs text into the active field.
+     * Corresponds to Python's input_text() method
      *
      * @param text - The text to input.
-     * @returns The extracted text content from the API response
-     * @throws Error if the operation fails.
+     * @returns BoolResult with input result and requestId
      */
-    inputText(text: string): Promise<string>;
+    inputText(text: string): Promise<BoolResult>;
     /**
      * Performs a swipe gesture on the screen.
+     * Corresponds to Python's swipe() method
      *
      * @param startX - The starting X coordinate.
      * @param startY - The starting Y coordinate.
      * @param endX - The ending X coordinate.
      * @param endY - The ending Y coordinate.
      * @param 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.
+     * @returns BoolResult with swipe result and requestId
      */
-    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<string>;
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<BoolResult>;
     /**
      * Performs a click at the specified coordinates.
+     * Corresponds to Python's click() method
      *
      * @param x - The X coordinate.
      * @param y - The Y coordinate.
      * @param button - The mouse button to click. Default is 'left'.
-     * @returns The extracted text content from the API response
-     * @throws Error if the operation fails.
+     * @returns BoolResult with click result and requestId
      */
-    click(x: number, y: number, button?: string): Promise<string>;
+    click(x: number, y: number, button?: string): Promise<BoolResult>;
     /**
      * Takes a screenshot of the current screen.
+     * Corresponds to Python's screenshot() method
      *
-     * @returns The extracted text content from the API response (usually a base64-encoded image)
-     * @throws Error if the operation fails.
+     * @returns OperationResult with screenshot data and requestId
      */
-    screenshot(): Promise<string>;
+    screenshot(): Promise<OperationResult>;
 }
 
 /**
- * Contains information about a session.
- */
-interface SessionInfo {
-    sessionId: string;
-    resourceUrl: string;
-    appId?: string;
-    authCode?: string;
-    connectionProperties?: string;
-    resourceId?: string;
-    resourceType?: string;
-}
-/**
- * Represents a session in the AgentBay cloud environment.
+ * Handles window management operations in the AgentBay cloud environment.
  */
-declare class Session {
-    private agentBay;
-    client: Client;
-    sessionId: string;
-    resourceUrl: string;
-    filesystem: FileSystem;
-    command: Command;
-    oss: Oss;
-    Application: Application;
-    window: WindowManager;
-    ui: UI;
+declare class WindowManager {
+    private session;
     /**
-     * Initialize a Session object.
-     *
-     * @param agentBay - The AgentBay instance that created this session.
-     * @param sessionId - The ID of this session.
+     * Creates a new WindowManager instance.
+     * @param session The session object that provides access to the AgentBay API.
      */
-    constructor(agentBay: AgentBay, sessionId: string);
+    constructor(session: {
+        getAPIKey(): string;
+        getClient(): any;
+        getSessionId(): string;
+    });
     /**
-     * Get information about this session.
+     * Helper method to call MCP tools and handle common response processing
      *
-     * @returns Session information.
+     * @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;
     /**
-     * Delete this session.
-     *
-     * @returns True if the session was successfully deleted.
+     * Helper method to parse JSON string into Window objects
+     * @param jsonStr - JSON string to parse
+     * @returns Array of Window objects or single Window object
      */
-    delete(): Promise<boolean>;
+    private parseWindowsFromJSON;
     /**
-     * Sets the labels for this session.
+     * Lists all root windows in the system.
+     * Corresponds to Python's list_root_windows() method
      *
-     * @param labels - The labels to set for the session.
-     * @throws APIError if the operation fails.
+     * @param timeoutMs - The timeout in milliseconds. Default is 3000ms.
+     * @returns WindowListResult with windows array and requestId
      */
-    setLabels(labels: Record<string, string>): Promise<void>;
+    listRootWindows(timeoutMs?: number): Promise<WindowListResult>;
     /**
-     * Gets the labels for this session.
+     * Gets the currently active window.
+     * Corresponds to Python's get_active_window() method
      *
-     * @returns The labels for the session.
-     * @throws APIError if the operation fails.
+     * @param timeoutMs - The timeout in milliseconds. Default is 3000ms.
+     * @returns WindowInfoResult with active window data and requestId
      */
-    getLabels(): Promise<Record<string, string>>;
+    getActiveWindow(timeoutMs?: number): Promise<WindowInfoResult>;
     /**
-     * Get the API key.
+     * Activates a window by ID.
+     * Corresponds to Python's activate_window() method
      *
-     * @returns The API key.
+     * @param windowId The ID of the window to activate.
+     * @returns BoolResult with requestId
      */
-    getAPIKey(): string;
+    activateWindow(windowId: number): Promise<BoolResult>;
     /**
-     * Get the client.
+     * Maximizes a window by ID.
+     * Corresponds to Python's maximize_window() method
      *
-     * @returns The client.
+     * @param windowId The ID of the window to maximize.
+     * @returns BoolResult with requestId
      */
-    getClient(): Client;
+    maximizeWindow(windowId: number): Promise<BoolResult>;
     /**
-     * Get the session ID.
+     * Minimizes a window by ID.
+     * Corresponds to Python's minimize_window() method
      *
-     * @returns The session ID.
+     * @param windowId The ID of the window to minimize.
+     * @returns BoolResult with requestId
      */
-    getSessionId(): string;
+    minimizeWindow(windowId: number): Promise<BoolResult>;
     /**
-     * Gets information about this session.
+     * Restores a window by ID.
+     * Corresponds to Python's restore_window() method
      *
-     * @returns Information about the session.
-     * @throws APIError if the operation fails.
+     * @param windowId The ID of the window to restore.
+     * @returns BoolResult with requestId
      */
-    info(): Promise<SessionInfo>;
+    restoreWindow(windowId: number): Promise<BoolResult>;
     /**
-     * Gets the link for this session.
+     * Closes a window by ID.
+     * Corresponds to Python's close_window() method
      *
-     * @returns The link for the session.
-     * @throws APIError if the operation fails.
+     * @param windowId The ID of the window to close.
+     * @returns BoolResult with requestId
      */
-    getLink(): Promise<string>;
-}
-
-/**
- * Represents a persistent storage context in the AgentBay cloud environment.
- */
-declare class Context {
+    closeWindow(windowId: number): Promise<BoolResult>;
     /**
-     * The unique identifier of the context.
+     * 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.
+     * @returns BoolResult with requestId
      */
-    id: string;
+    fullscreenWindow(windowId: number): Promise<BoolResult>;
     /**
-     * The name of the context.
+     * 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.
+     * @returns BoolResult with requestId
      */
-    name: string;
+    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult>;
     /**
-     * The current state of the context (e.g., "available", "in-use").
+     * Enables or disables focus mode.
+     * Corresponds to Python's focus_mode() method
+     *
+     * @param on Whether to enable focus mode.
+     * @returns BoolResult with requestId
      */
-    state: string;
+    focusMode(on: boolean): Promise<BoolResult>;
+}
+
+/**
+ * Represents a session in the AgentBay cloud environment.
+ */
+declare class Session {
+    private agentBay;
+    sessionId: string;
+    resourceUrl: string;
+    fileSystem: FileSystem;
+    command: Command;
+    oss: Oss;
+    application: Application;
+    window: WindowManager;
+    ui: UI;
+    context: ContextManager;
     /**
-     * Date and time when the Context was created.
+     * Initialize a Session object.
+     *
+     * @param agentBay - The AgentBay instance that created this session.
+     * @param sessionId - The ID of this session.
      */
-    createdAt?: string;
+    constructor(agentBay: AgentBay, sessionId: string);
     /**
-     * Date and time when the Context was last used.
+     * Return the API key for this session.
      */
-    lastUsedAt?: string;
+    getAPIKey(): string;
     /**
-     * The operating system type this context is bound to.
+     * Return the HTTP client for this session.
      */
-    osType?: string;
+    getClient(): Client;
     /**
-     * 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.
+     * Return the session_id for this session.
      */
-    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;
+    getSessionId(): string;
     /**
-     * Initialize the ContextService.
+     * Delete this session.
      *
-     * @param agentBay - The AgentBay instance.
+     * @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
      */
-    constructor(agentBay: AgentBay);
+    delete(syncContext?: boolean): Promise<DeleteResult>;
     /**
-     * Lists all available contexts.
+     * Sets the labels for this session.
      *
-     * @returns A list of Context objects.
+     * @param labels - The labels to set for the session.
+     * @returns OperationResult indicating success or failure with request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    list(): Promise<Context[]>;
+    setLabels(labels: Record<string, string>): Promise<OperationResult>;
     /**
-     * Gets a context by name. Optionally creates it if it doesn't exist.
+     * Gets the labels for this session.
      *
-     * @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.
+     * @returns OperationResult containing the labels as data and request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    get(name: string, create?: boolean): Promise<Context | null>;
+    getLabels(): Promise<OperationResult>;
     /**
-     * Creates a new context with the given name.
+     * Gets information about this session.
      *
-     * @param name - The name for the new context.
-     * @returns The created Context object.
+     * @returns OperationResult containing the session information as data and request ID
+     * @throws Error if the operation fails (matching Python SessionError)
      */
-    create(name: string): Promise<Context>;
+    info(): Promise<OperationResult>;
     /**
-     * Updates the specified context.
+     * Get a link associated with the current session.
      *
-     * @param context - The Context object to update.
-     * @returns The updated Context object.
+     * @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)
      */
-    update(context: Context): Promise<Context>;
+    getLink(protocolType?: string, port?: number): Promise<OperationResult>;
     /**
-     * Deletes the specified context.
+     * Asynchronously get a link associated with the current session.
      *
-     * @param context - The Context object to delete.
+     * @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)
      */
-    delete(context: Context): Promise<void>;
+    getLinkAsync(protocolType?: string, port?: number): Promise<OperationResult>;
+}
+
+/**
+ * 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$1 {
+    contextId?: string;
+    labels?: Record<string, string>;
+    imageId?: string;
+    contextSync?: ContextSync[];
+}
 /**
  * Main class for interacting with the AgentBay cloud runtime environment.
  */
@@ -1756,23 +2523,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$1): Promise<SessionResult>;
     /**
      * List all available sessions.
      *
@@ -1780,20 +2543,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 +2570,169 @@ 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>);
+}
+
+/**
+ * Configuration interface for CreateSessionParams
+ */
+interface CreateSessionParamsConfig {
+    labels: Record<string, string>;
+    /**
+     * @deprecated This field is deprecated and will be removed in a future version.
+     * Please use contextSync instead for more flexible and powerful data persistence.
+     */
+    contextId?: string;
+    imageId?: string;
+    contextSync: ContextSync[];
+}
+/**
+ * CreateSessionParams provides a way to configure the parameters for creating a new session
+ * in the AgentBay cloud environment.
+ */
+declare class CreateSessionParams implements CreateSessionParamsConfig {
+    /** Custom labels for the Session. These can be used for organizing and filtering sessions. */
+    labels: Record<string, string>;
+    /**
+     * ID of the context to bind to the session.
+     * The context can include various types of persistence like file system (volume) and cookies.
+     *
+     * @deprecated This field is deprecated and will be removed in a future version.
+     * Please use contextSync instead for more flexible and powerful data persistence.
+     *
+     * Important Limitations:
+     * 1. One session at a time: A context can only be used by one session at a time.
+     *    If you try to create a session with a context ID that is already in use by another active session,
+     *    the session creation will fail.
+     *
+     * 2. OS binding: A context is bound to the operating system of the first session that uses it.
+     *    When a context is first used with a session, it becomes bound to that session's OS.
+     *    Any attempt to use the context with a session running on a different OS will fail.
+     *    For example, if a context is first used with a Linux session, it cannot later be used
+     *    with a Windows or Android session.
+     */
+    contextId?: string;
+    /** Image ID to use for the session. */
+    imageId?: string;
+    /**
+     * List of context synchronization configurations.
+     * These configurations define how contexts should be synchronized and mounted.
+     */
+    contextSync: ContextSync[];
+    constructor();
+    /**
+     * WithLabels sets the labels for the session parameters and returns the updated parameters.
+     */
+    withLabels(labels: Record<string, string>): CreateSessionParams;
+    /**
+     * WithContextID sets the context ID for the session parameters and returns the updated parameters.
+     */
+    withContextID(contextId: string): CreateSessionParams;
+    /**
+     * WithImageId sets the image ID for the session parameters and returns the updated parameters.
+     */
+    withImageId(imageId: string): CreateSessionParams;
+    /**
+     * GetLabelsJSON returns the labels as a JSON string.
+     * Returns an object with success status and result/error message to match Go version behavior.
+     */
+    getLabelsJSON(): {
+        result: string;
+        error?: string;
+    };
+    /**
+     * AddContextSync adds a context sync configuration to the session parameters.
+     */
+    addContextSync(contextId: string, path: string, policy?: SyncPolicy): CreateSessionParams;
+    /**
+     * AddContextSyncConfig adds a pre-configured context sync to the session parameters.
+     */
+    addContextSyncConfig(contextSync: ContextSync): CreateSessionParams;
+    /**
+     * WithContextSync sets the context sync configurations for the session parameters.
+     */
+    withContextSync(contextSyncs: ContextSync[]): CreateSessionParams;
+    /**
+     * Convert to plain object for JSON serialization
+     */
+    toJSON(): CreateSessionParamsConfig;
+    /**
+     * Create from plain object
+     */
+    static fromJSON(config: CreateSessionParamsConfig): CreateSessionParams;
 }
+/**
+ * NewCreateSessionParams creates a new CreateSessionParams with default values.
+ */
+declare function newCreateSessionParams(): CreateSessionParams;
+
+/**
+ * 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, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams$1 as CreateSessionParams, type CreateSessionParamsConfig, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, FileError, type FileInfo, FileSystem, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, type InstalledApp, KeyCode, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, Oss, OssError, type Process, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SessionError, type SessionInterface, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, UI, type UIElement, UIError, type UploadPolicy, UploadStrategy, type WhiteList, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newSyncPolicy, newUploadPolicy };