test-wuying-agentbay-sdk 0.13.0-beta.20251210135226 → 0.13.0-beta.20251210170519

package/dist/index.d.mts

@@ -3128,18 +3128,31 @@ declare function newContextSync(contextId: string, path: string, policy?: SyncPo
  * Result of task execution.
  */
 interface ExecutionResult extends ApiResponse {
-    success: boolean;
-    errorMessage: string;
     taskId: string;
     taskStatus: string;
+    taskResult: string;
 }
 /**
  * Result of query operations.
  */
 interface QueryResult extends ApiResponse {
+    taskStatus: string;
+    taskAction: string;
+    taskProduct: string;
+}
+/**
+ * Result of agent initialization.
+ */
+interface InitializationResult extends ApiResponse {
     success: boolean;
-    output: string;
-    errorMessage: string;
+}
+/**
+ * Options for Agent initialization.
+
+ */
+interface AgentOptions {
+    use_vision: boolean;
+    output_schema: '';
 }
 /**
  * Result of an MCP tool call.
@@ -3159,12 +3172,12 @@ interface McpSession {
     callMcpTool(toolName: string, args: any): Promise<McpToolResult>;
 }
 /**
- * An Agent to manipulate applications to complete specific tasks.
+ * An Agent to perform tasks on the computer.
  */
-declare class Agent {
+declare class ComputerUseAgent {
     private session;
     /**
-     * Initialize an Agent object.
+     * Initialize an Computer Agent object.
      *
      * @param session - The Session instance that this Agent belongs to.
      */
@@ -3174,16 +3187,17 @@ declare class Agent {
      *
      * @param task - Task description in human language.
      * @param maxTryTimes - Maximum number of retry attempts.
-     * @returns ExecutionResult containing success status, task output, and error message if any.
+     * @returns ExecutionResult containing success status, task output, and error
+     *     message if any.
      *
      * @example
      * ```typescript
      * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
      * const result = await agentBay.create({ imageId: 'windows_latest' });
      * if (result.success) {
-     *   const taskResult = await result.session.agent.executeTask('Open notepad', 10);
-     *   console.log(`Task status: ${taskResult.taskStatus}`);
-     *   await result.session.delete();
+     *   const taskResult = await result.session.agent.computer.executeTask('Open
+     * notepad', 10); console.log(`Task status: ${taskResult.taskStatus}`); await
+     * result.session.delete();
      * }
      * ```
      */
@@ -3199,27 +3213,125 @@ declare class Agent {
      * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
      * const result = await agentBay.create({ imageId: 'windows_latest' });
      * if (result.success) {
-     *   const taskResult = await result.session.agent.executeTask('Open calculator', 10);
-     *   const statusResult = await result.session.agent.getTaskStatus(taskResult.taskId);
-     *   console.log(`Status: ${JSON.parse(statusResult.output).status}`);
+     *   const taskResult = await result.session.agent.computer.executeTask('Open
+     * calculator', 10); const statusResult = await
+     * result.session.agent.computer.getTaskStatus(taskResult.taskId);
+     * console.log(`Status:
+     * ${JSON.parse(statusResult.output).status}`); await result.session.delete();
+     * }
+     * ```
+     */
+    getTaskStatus(taskId: string): Promise<QueryResult>;
+    /**
+     * Terminate a task with a specified task ID.
+     *
+     * @param taskId - The ID of the running task.
+     * @returns ExecutionResult containing success status, task output, and
+     *     error message if any.
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'windows_latest' });
+     * if (result.success) {
+     *   const taskResult = await
+     * result.session.agent.computer.executeTask('Open notepad', 5); const
+     * terminateResult = await
+     * result.session.agent.computer.terminateTask(taskResult.taskId);
+     *   console.log(`Terminated: ${terminateResult.taskStatus}`);
      *   await result.session.delete();
      * }
      * ```
      */
+    terminateTask(taskId: string): Promise<ExecutionResult>;
+}
+declare class BrowserUseAgent {
+    private session;
+    /**
+     * Initialize an Browser Agent object.
+     * @description Browser Use Agent is in BETA ⚠️ .
+     *
+     * @param session - The Session instance that this Agent belongs to.
+     */
+    constructor(session: McpSession);
+    /**
+     * Initialize the browser agent with specific options.
+     * @param options - agent initialization options
+     * @returns  InitializationResult containing success status, task output,
+     *     and error message if any.
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'linux_latest' });
+     * if (result.success) {
+     *   options:AgentOptions = new AgentOptions(use_vision=False,
+     * output_schema=""); const initResult = await
+     * result.session.agent.browser.initialize(options); console.log(`Initialize
+     * success: ${initResult.success}`); await result.session.delete();
+     * }
+     * ```
+     */
+    initialize(options: AgentOptions): Promise<InitializationResult>;
+    /**
+     * Execute a specific task described in human language.
+     *
+     * @param task - Task description in human language.
+     * @param maxTryTimes - Maximum number of retry attempts.
+     * @returns ExecutionResult containing success status, task output, and
+     *     error message if any.
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'linux_latest' });
+     * if (result.success) {
+     *   const taskResult = await
+     * result.session.agent.browser.executeTask('Navigate to baidu and query the
+     * weather of Shanghai', 10); console.log(`Task status:
+     * ${taskResult.taskStatus}`); await result.session.delete();
+     * }
+     * ```
+     */
+    executeTask(task: string, maxTryTimes: number): Promise<ExecutionResult>;
+    /**
+     * Get the status of the task with the given task ID.
+     *
+     * @param taskId - Task ID
+     * @returns QueryResult containing the task status
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'windows_latest' });
+     * if (result.success) {
+     *   const taskResult = await
+     * result.session.agent.browser.executeTask(Navigate to baidu and query the
+     * weather of Shanghai, 10); const statusResult = await
+     * result.session.agent.browser.getTaskStatus(taskResult.taskId);
+     * console.log(`Status:
+     * ${JSON.parse(statusResult.output).status}`); await
+     * result.session.delete();
+     * }
+     * ```
+     */
     getTaskStatus(taskId: string): Promise<QueryResult>;
     /**
      * Terminate a task with a specified task ID.
      *
      * @param taskId - The ID of the running task.
-     * @returns ExecutionResult containing success status, task output, and error message if any.
+     * @returns ExecutionResult containing success status, task output, and
+     *     error message if any.
      *
      * @example
      * ```typescript
      * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
      * const result = await agentBay.create({ imageId: 'windows_latest' });
      * if (result.success) {
-     *   const taskResult = await result.session.agent.executeTask('Open notepad', 5);
-     *   const terminateResult = await result.session.agent.terminateTask(taskResult.taskId);
+     *   const taskResult = await
+     * result.session.agent.browser.executeTask(Navigate to baidu and query the
+     * weather of Shanghai, 10); const terminateResult = await
+     * result.session.agent.browser.terminateTask(taskResult.taskId);
      *   console.log(`Terminated: ${terminateResult.taskStatus}`);
      *   await result.session.delete();
      * }
@@ -3227,6 +3339,28 @@ declare class Agent {
      */
     terminateTask(taskId: string): Promise<ExecutionResult>;
 }
+/**
+ * An Agent to manipulate applications to complete specific tasks.
+ * According to the use scenary, The agent can a browser use agent which is
+ * specialized for browser automation tasks, The agent also can be  a computer
+ * use agent which is specialized for multiple applications automation tasks.
+ */
+declare class Agent {
+    /**
+     * An instance of Computer Use Agent.
+     */
+    computer: ComputerUseAgent;
+    /**
+     * An instance of Browser Use Agent.
+     */
+    browser: BrowserUseAgent;
+    /**
+     * Initialize an Agent object.
+     *
+     * @param session - The Session instance that this Agent belongs to.
+     */
+    constructor(session: McpSession);
+}
 
 interface ActOptions {
     action: string;
@@ -7110,4 +7244,4 @@ declare function logWarn(message: string, ...args: any[]): void;
  */
 declare function logError(message: string, error?: any): void;
 
-export { APIError, APP_BLACKLIST_TEMPLATE, APP_WHITELIST_TEMPLATE, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, type ApiResponse, type ApiResponseWithData, type AppManagerRule, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, type Brand, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, BrowserFingerprintContext, BrowserFingerprintGenerator, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, ClearContextRequest, ClearContextResponse, ClearContextResponseBody, Client, Code, Command, Computer, type Config, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DeleteResult, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtraConfigs, type ExtraProperties, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, type Fingerprint, FingerprintFormat, GetAdbLinkRequest, GetAdbLinkResponse, GetAdbLinkResponseBody, GetAdbLinkResponseBodyData, GetCdpLinkRequest, GetCdpLinkResponse, GetCdpLinkResponseBody, GetCdpLinkResponseBodyData, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, GetSessionRequest, GetSessionResponse, GetSessionResponseBody, GetSessionResponseBodyData, HIDE_NAVIGATION_BAR_TEMPLATE, IS_RELEASE, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, Lifecycle, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type LogLevel, type LoggerConfig, MOBILE_COMMAND_TEMPLATES, type MappingPolicy, type McpSession, type McpToolResult, Mobile, type MobileExtraConfig, type MobileSimulateConfig, MobileSimulateMode, MobileSimulateService, type MobileSimulateUploadResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type NavigatorFingerprint, type ObserveOptions, ObserveResult, Oss, OssError, PauseSessionAsyncRequest, PauseSessionAsyncResponse, PauseSessionAsyncResponseBody, type QueryResult, RESOLUTION_LOCK_TEMPLATE, type RecyclePolicy, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, ResumeSessionAsyncRequest, ResumeSessionAsyncResponse, ResumeSessionAsyncResponseBody, SHOW_NAVIGATION_BAR_TEMPLATE, type ScreenFingerprint, Session, SessionError, type SessionInterface, type SessionListResult, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, type SyncCallback, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UNINSTALL_BLACKLIST_TEMPLATE, UploadMode, type UploadPolicy, UploadStrategy, type UserAgentData, VERSION, type VideoCard, type WhiteList, WhiteListValidator, createListSessionParams, extraConfigsFromJSON, extraConfigsToJSON, extractRequestId, getLogLevel, getMobileCommandTemplate, hasMobileCommandTemplate, log, logDebug, logError, logInfo, logWarn, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newMappingPolicy, newRecyclePolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy, replaceTemplatePlaceholders, setLogLevel, setupLogger, validateAppManagerRule, validateExtraConfigs, validateMobileExtraConfig, validateMobileSimulateConfig };
+export { APIError, APP_BLACKLIST_TEMPLATE, APP_WHITELIST_TEMPLATE, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, type AgentOptions, type ApiResponse, type ApiResponseWithData, type AppManagerRule, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, type Brand, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, BrowserFingerprintContext, BrowserFingerprintGenerator, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, BrowserUseAgent, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, ClearContextRequest, ClearContextResponse, ClearContextResponseBody, Client, Code, Command, Computer, ComputerUseAgent, type Config, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DeleteResult, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtraConfigs, type ExtraProperties, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, type Fingerprint, FingerprintFormat, GetAdbLinkRequest, GetAdbLinkResponse, GetAdbLinkResponseBody, GetAdbLinkResponseBodyData, GetCdpLinkRequest, GetCdpLinkResponse, GetCdpLinkResponseBody, GetCdpLinkResponseBodyData, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, GetSessionRequest, GetSessionResponse, GetSessionResponseBody, GetSessionResponseBodyData, HIDE_NAVIGATION_BAR_TEMPLATE, IS_RELEASE, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, type InitializationResult, Lifecycle, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type LogLevel, type LoggerConfig, MOBILE_COMMAND_TEMPLATES, type MappingPolicy, type McpSession, type McpToolResult, Mobile, type MobileExtraConfig, type MobileSimulateConfig, MobileSimulateMode, MobileSimulateService, type MobileSimulateUploadResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type NavigatorFingerprint, type ObserveOptions, ObserveResult, Oss, OssError, PauseSessionAsyncRequest, PauseSessionAsyncResponse, PauseSessionAsyncResponseBody, type QueryResult, RESOLUTION_LOCK_TEMPLATE, type RecyclePolicy, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, ResumeSessionAsyncRequest, ResumeSessionAsyncResponse, ResumeSessionAsyncResponseBody, SHOW_NAVIGATION_BAR_TEMPLATE, type ScreenFingerprint, Session, SessionError, type SessionInterface, type SessionListResult, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, type SyncCallback, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UNINSTALL_BLACKLIST_TEMPLATE, UploadMode, type UploadPolicy, UploadStrategy, type UserAgentData, VERSION, type VideoCard, type WhiteList, WhiteListValidator, createListSessionParams, extraConfigsFromJSON, extraConfigsToJSON, extractRequestId, getLogLevel, getMobileCommandTemplate, hasMobileCommandTemplate, log, logDebug, logError, logInfo, logWarn, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newMappingPolicy, newRecyclePolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy, replaceTemplatePlaceholders, setLogLevel, setupLogger, validateAppManagerRule, validateExtraConfigs, validateMobileExtraConfig, validateMobileSimulateConfig };

package/dist/index.d.ts

@@ -3128,18 +3128,31 @@ declare function newContextSync(contextId: string, path: string, policy?: SyncPo
  * Result of task execution.
  */
 interface ExecutionResult extends ApiResponse {
-    success: boolean;
-    errorMessage: string;
     taskId: string;
     taskStatus: string;
+    taskResult: string;
 }
 /**
  * Result of query operations.
  */
 interface QueryResult extends ApiResponse {
+    taskStatus: string;
+    taskAction: string;
+    taskProduct: string;
+}
+/**
+ * Result of agent initialization.
+ */
+interface InitializationResult extends ApiResponse {
     success: boolean;
-    output: string;
-    errorMessage: string;
+}
+/**
+ * Options for Agent initialization.
+
+ */
+interface AgentOptions {
+    use_vision: boolean;
+    output_schema: '';
 }
 /**
  * Result of an MCP tool call.
@@ -3159,12 +3172,12 @@ interface McpSession {
     callMcpTool(toolName: string, args: any): Promise<McpToolResult>;
 }
 /**
- * An Agent to manipulate applications to complete specific tasks.
+ * An Agent to perform tasks on the computer.
  */
-declare class Agent {
+declare class ComputerUseAgent {
     private session;
     /**
-     * Initialize an Agent object.
+     * Initialize an Computer Agent object.
      *
      * @param session - The Session instance that this Agent belongs to.
      */
@@ -3174,16 +3187,17 @@ declare class Agent {
      *
      * @param task - Task description in human language.
      * @param maxTryTimes - Maximum number of retry attempts.
-     * @returns ExecutionResult containing success status, task output, and error message if any.
+     * @returns ExecutionResult containing success status, task output, and error
+     *     message if any.
      *
      * @example
      * ```typescript
      * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
      * const result = await agentBay.create({ imageId: 'windows_latest' });
      * if (result.success) {
-     *   const taskResult = await result.session.agent.executeTask('Open notepad', 10);
-     *   console.log(`Task status: ${taskResult.taskStatus}`);
-     *   await result.session.delete();
+     *   const taskResult = await result.session.agent.computer.executeTask('Open
+     * notepad', 10); console.log(`Task status: ${taskResult.taskStatus}`); await
+     * result.session.delete();
      * }
      * ```
      */
@@ -3199,27 +3213,125 @@ declare class Agent {
      * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
      * const result = await agentBay.create({ imageId: 'windows_latest' });
      * if (result.success) {
-     *   const taskResult = await result.session.agent.executeTask('Open calculator', 10);
-     *   const statusResult = await result.session.agent.getTaskStatus(taskResult.taskId);
-     *   console.log(`Status: ${JSON.parse(statusResult.output).status}`);
+     *   const taskResult = await result.session.agent.computer.executeTask('Open
+     * calculator', 10); const statusResult = await
+     * result.session.agent.computer.getTaskStatus(taskResult.taskId);
+     * console.log(`Status:
+     * ${JSON.parse(statusResult.output).status}`); await result.session.delete();
+     * }
+     * ```
+     */
+    getTaskStatus(taskId: string): Promise<QueryResult>;
+    /**
+     * Terminate a task with a specified task ID.
+     *
+     * @param taskId - The ID of the running task.
+     * @returns ExecutionResult containing success status, task output, and
+     *     error message if any.
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'windows_latest' });
+     * if (result.success) {
+     *   const taskResult = await
+     * result.session.agent.computer.executeTask('Open notepad', 5); const
+     * terminateResult = await
+     * result.session.agent.computer.terminateTask(taskResult.taskId);
+     *   console.log(`Terminated: ${terminateResult.taskStatus}`);
      *   await result.session.delete();
      * }
      * ```
      */
+    terminateTask(taskId: string): Promise<ExecutionResult>;
+}
+declare class BrowserUseAgent {
+    private session;
+    /**
+     * Initialize an Browser Agent object.
+     * @description Browser Use Agent is in BETA ⚠️ .
+     *
+     * @param session - The Session instance that this Agent belongs to.
+     */
+    constructor(session: McpSession);
+    /**
+     * Initialize the browser agent with specific options.
+     * @param options - agent initialization options
+     * @returns  InitializationResult containing success status, task output,
+     *     and error message if any.
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'linux_latest' });
+     * if (result.success) {
+     *   options:AgentOptions = new AgentOptions(use_vision=False,
+     * output_schema=""); const initResult = await
+     * result.session.agent.browser.initialize(options); console.log(`Initialize
+     * success: ${initResult.success}`); await result.session.delete();
+     * }
+     * ```
+     */
+    initialize(options: AgentOptions): Promise<InitializationResult>;
+    /**
+     * Execute a specific task described in human language.
+     *
+     * @param task - Task description in human language.
+     * @param maxTryTimes - Maximum number of retry attempts.
+     * @returns ExecutionResult containing success status, task output, and
+     *     error message if any.
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'linux_latest' });
+     * if (result.success) {
+     *   const taskResult = await
+     * result.session.agent.browser.executeTask('Navigate to baidu and query the
+     * weather of Shanghai', 10); console.log(`Task status:
+     * ${taskResult.taskStatus}`); await result.session.delete();
+     * }
+     * ```
+     */
+    executeTask(task: string, maxTryTimes: number): Promise<ExecutionResult>;
+    /**
+     * Get the status of the task with the given task ID.
+     *
+     * @param taskId - Task ID
+     * @returns QueryResult containing the task status
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create({ imageId: 'windows_latest' });
+     * if (result.success) {
+     *   const taskResult = await
+     * result.session.agent.browser.executeTask(Navigate to baidu and query the
+     * weather of Shanghai, 10); const statusResult = await
+     * result.session.agent.browser.getTaskStatus(taskResult.taskId);
+     * console.log(`Status:
+     * ${JSON.parse(statusResult.output).status}`); await
+     * result.session.delete();
+     * }
+     * ```
+     */
     getTaskStatus(taskId: string): Promise<QueryResult>;
     /**
      * Terminate a task with a specified task ID.
      *
      * @param taskId - The ID of the running task.
-     * @returns ExecutionResult containing success status, task output, and error message if any.
+     * @returns ExecutionResult containing success status, task output, and
+     *     error message if any.
      *
      * @example
      * ```typescript
      * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
      * const result = await agentBay.create({ imageId: 'windows_latest' });
      * if (result.success) {
-     *   const taskResult = await result.session.agent.executeTask('Open notepad', 5);
-     *   const terminateResult = await result.session.agent.terminateTask(taskResult.taskId);
+     *   const taskResult = await
+     * result.session.agent.browser.executeTask(Navigate to baidu and query the
+     * weather of Shanghai, 10); const terminateResult = await
+     * result.session.agent.browser.terminateTask(taskResult.taskId);
      *   console.log(`Terminated: ${terminateResult.taskStatus}`);
      *   await result.session.delete();
      * }
@@ -3227,6 +3339,28 @@ declare class Agent {
      */
     terminateTask(taskId: string): Promise<ExecutionResult>;
 }
+/**
+ * An Agent to manipulate applications to complete specific tasks.
+ * According to the use scenary, The agent can a browser use agent which is
+ * specialized for browser automation tasks, The agent also can be  a computer
+ * use agent which is specialized for multiple applications automation tasks.
+ */
+declare class Agent {
+    /**
+     * An instance of Computer Use Agent.
+     */
+    computer: ComputerUseAgent;
+    /**
+     * An instance of Browser Use Agent.
+     */
+    browser: BrowserUseAgent;
+    /**
+     * Initialize an Agent object.
+     *
+     * @param session - The Session instance that this Agent belongs to.
+     */
+    constructor(session: McpSession);
+}
 
 interface ActOptions {
     action: string;
@@ -7110,4 +7244,4 @@ declare function logWarn(message: string, ...args: any[]): void;
  */
 declare function logError(message: string, error?: any): void;
 
-export { APIError, APP_BLACKLIST_TEMPLATE, APP_WHITELIST_TEMPLATE, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, type ApiResponse, type ApiResponseWithData, type AppManagerRule, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, type Brand, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, BrowserFingerprintContext, BrowserFingerprintGenerator, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, ClearContextRequest, ClearContextResponse, ClearContextResponseBody, Client, Code, Command, Computer, type Config, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DeleteResult, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtraConfigs, type ExtraProperties, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, type Fingerprint, FingerprintFormat, GetAdbLinkRequest, GetAdbLinkResponse, GetAdbLinkResponseBody, GetAdbLinkResponseBodyData, GetCdpLinkRequest, GetCdpLinkResponse, GetCdpLinkResponseBody, GetCdpLinkResponseBodyData, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, GetSessionRequest, GetSessionResponse, GetSessionResponseBody, GetSessionResponseBodyData, HIDE_NAVIGATION_BAR_TEMPLATE, IS_RELEASE, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, Lifecycle, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type LogLevel, type LoggerConfig, MOBILE_COMMAND_TEMPLATES, type MappingPolicy, type McpSession, type McpToolResult, Mobile, type MobileExtraConfig, type MobileSimulateConfig, MobileSimulateMode, MobileSimulateService, type MobileSimulateUploadResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type NavigatorFingerprint, type ObserveOptions, ObserveResult, Oss, OssError, PauseSessionAsyncRequest, PauseSessionAsyncResponse, PauseSessionAsyncResponseBody, type QueryResult, RESOLUTION_LOCK_TEMPLATE, type RecyclePolicy, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, ResumeSessionAsyncRequest, ResumeSessionAsyncResponse, ResumeSessionAsyncResponseBody, SHOW_NAVIGATION_BAR_TEMPLATE, type ScreenFingerprint, Session, SessionError, type SessionInterface, type SessionListResult, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, type SyncCallback, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UNINSTALL_BLACKLIST_TEMPLATE, UploadMode, type UploadPolicy, UploadStrategy, type UserAgentData, VERSION, type VideoCard, type WhiteList, WhiteListValidator, createListSessionParams, extraConfigsFromJSON, extraConfigsToJSON, extractRequestId, getLogLevel, getMobileCommandTemplate, hasMobileCommandTemplate, log, logDebug, logError, logInfo, logWarn, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newMappingPolicy, newRecyclePolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy, replaceTemplatePlaceholders, setLogLevel, setupLogger, validateAppManagerRule, validateExtraConfigs, validateMobileExtraConfig, validateMobileSimulateConfig };
+export { APIError, APP_BLACKLIST_TEMPLATE, APP_WHITELIST_TEMPLATE, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, type AgentOptions, type ApiResponse, type ApiResponseWithData, type AppManagerRule, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, type Brand, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, BrowserFingerprintContext, BrowserFingerprintGenerator, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, BrowserUseAgent, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, ClearContextRequest, ClearContextResponse, ClearContextResponseBody, Client, Code, Command, Computer, ComputerUseAgent, type Config, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DeleteResult, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtraConfigs, type ExtraProperties, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, type Fingerprint, FingerprintFormat, GetAdbLinkRequest, GetAdbLinkResponse, GetAdbLinkResponseBody, GetAdbLinkResponseBodyData, GetCdpLinkRequest, GetCdpLinkResponse, GetCdpLinkResponseBody, GetCdpLinkResponseBodyData, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, GetSessionRequest, GetSessionResponse, GetSessionResponseBody, GetSessionResponseBodyData, HIDE_NAVIGATION_BAR_TEMPLATE, IS_RELEASE, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, type InitializationResult, Lifecycle, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type LogLevel, type LoggerConfig, MOBILE_COMMAND_TEMPLATES, type MappingPolicy, type McpSession, type McpToolResult, Mobile, type MobileExtraConfig, type MobileSimulateConfig, MobileSimulateMode, MobileSimulateService, type MobileSimulateUploadResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type NavigatorFingerprint, type ObserveOptions, ObserveResult, Oss, OssError, PauseSessionAsyncRequest, PauseSessionAsyncResponse, PauseSessionAsyncResponseBody, type QueryResult, RESOLUTION_LOCK_TEMPLATE, type RecyclePolicy, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, ResumeSessionAsyncRequest, ResumeSessionAsyncResponse, ResumeSessionAsyncResponseBody, SHOW_NAVIGATION_BAR_TEMPLATE, type ScreenFingerprint, Session, SessionError, type SessionInterface, type SessionListResult, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, type SyncCallback, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UNINSTALL_BLACKLIST_TEMPLATE, UploadMode, type UploadPolicy, UploadStrategy, type UserAgentData, VERSION, type VideoCard, type WhiteList, WhiteListValidator, createListSessionParams, extraConfigsFromJSON, extraConfigsToJSON, extractRequestId, getLogLevel, getMobileCommandTemplate, hasMobileCommandTemplate, log, logDebug, logError, logInfo, logWarn, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newMappingPolicy, newRecyclePolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy, replaceTemplatePlaceholders, setLogLevel, setupLogger, validateAppManagerRule, validateExtraConfigs, validateMobileExtraConfig, validateMobileSimulateConfig };