wuying-agentbay-sdk 0.12.0 → 0.13.1

package/dist/index.d.mts

@@ -1,9 +1,11 @@
 import * as $dara from '@darabonba/typescript';
 import OpenApi, { $OpenApiUtil } from '@alicloud/openapi-core';
+import { ZodTypeAny, z } from 'zod';
 
 interface Config {
     endpoint: string;
     timeout_ms: number;
+    region_id?: string;
 }
 
 /**
@@ -123,6 +125,31 @@ interface OperationResult extends ApiResponse {
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+/**
+ * Interface for process list operation responses
+ * Corresponds to Python's ProcessListResult type
+ */
+interface Process$1 {
+    pname: string;
+    pid: number;
+    cmdline?: string;
+}
+interface ProcessListResult extends OperationResult {
+    data: Process$1[];
+}
+/**
+ * Interface for installed app list operation responses
+ * Corresponds to Python's InstalledAppListResult type
+ */
+interface InstalledApp$1 {
+    name: string;
+    startCmd: string;
+    stopCmd?: string;
+    workDirectory?: string;
+}
+interface InstalledAppListResult extends OperationResult {
+    data: InstalledApp$1[];
+}
 /**
  * Interface for command execution operation responses
  * Corresponds to Python's CommandResult type
@@ -132,30 +159,74 @@ interface CommandResult extends ApiResponse {
     requestId: string;
     /** Whether the command execution was successful */
     success: boolean;
-    /** The command output */
+    /** The command output (for backward compatibility, equals stdout + stderr) */
     output: string;
     /** Optional error message if the operation failed */
     errorMessage?: string;
+    /** The exit code of the command execution. Default is 0. */
+    exitCode?: number;
+    /** Standard output from the command execution */
+    stdout?: string;
+    /** Standard error from the command execution */
+    stderr?: string;
+    /** Trace ID for error tracking. Only present when exit_code != 0. Used for quick problem localization. */
+    traceId?: string;
+}
+/**
+ * Interface for single result item in enhanced code execution
+ */
+interface CodeExecutionResultItem {
+    text?: string;
+    html?: string;
+    markdown?: string;
+    png?: string;
+    jpeg?: string;
+    svg?: string;
+    latex?: string;
+    json?: any;
+    chart?: any;
+    isMainResult?: boolean;
+}
+/**
+ * Interface for code execution logs
+ */
+interface CodeExecutionLogs {
+    stdout: string[];
+    stderr: string[];
+}
+/**
+ * Interface for code execution error details
+ */
+interface CodeExecutionError {
+    name: string;
+    value: string;
+    traceback: string;
 }
 /**
  * Interface for code execution operation responses
- * Corresponds to Python's CodeExecutionResult type
+ * Corresponds to Python's EnhancedCodeExecutionResult type
  */
 interface CodeExecutionResult extends ApiResponse {
     /** Request identifier for tracking API calls */
     requestId: string;
     /** Whether the code execution was successful */
     success: boolean;
-    /** The execution result */
+    /** The execution result (backward compatible text) */
     result: string;
     /** Optional error message if the operation failed */
     errorMessage?: string;
+    /** Enhanced fields */
+    logs?: CodeExecutionLogs;
+    results?: CodeExecutionResultItem[];
+    error?: CodeExecutionError;
+    executionTime?: number;
+    executionCount?: number;
 }
 /**
  * Interface for boolean operation responses
  * Corresponds to Python's BoolResult type
  */
-interface BoolResult$2 extends ApiResponse {
+interface BoolResult$1 extends ApiResponse {
     /** Request identifier for tracking API calls */
     requestId: string;
     /** Whether the operation was successful */
@@ -277,6 +348,12 @@ interface OSSDownloadResult extends ApiResponse {
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+interface WindowInfo {
+    windowId: number;
+    title: string;
+    pid: number;
+    pname: string;
+}
 /**
  * Interface for window list operation responses
  * Corresponds to Python's WindowListResult type
@@ -287,10 +364,21 @@ interface WindowListResult extends ApiResponse {
     /** Whether the operation was successful */
     success: boolean;
     /** List of windows */
-    windows: any[];
+    windows: WindowInfo[];
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+interface Window {
+    windowId: number;
+    title: string;
+    absoluteUpperLeftX?: number;
+    absoluteUpperLeftY?: number;
+    width?: number;
+    height?: number;
+    pid?: number;
+    pname?: string;
+    childWindows?: Window[];
+}
 /**
  * Interface for window info operation responses
  * Corresponds to Python's WindowInfoResult type
@@ -301,7 +389,7 @@ interface WindowInfoResult extends ApiResponse {
     /** Whether the operation was successful */
     success: boolean;
     /** Window object */
-    window?: any;
+    window?: Window[];
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
@@ -446,6 +534,32 @@ interface SessionResumeResult extends ApiResponse {
     /** Current status of the session. Possible values: "RUNNING", "PAUSED", "RESUMING" */
     status?: string;
 }
+/**
+ * Represents the screen dimensions and DPI scaling information.
+ *
+ * @interface ScreenSize
+ * @extends OperationResult
+ */
+interface ScreenSize extends OperationResult {
+    /** Screen width in pixels */
+    width: number;
+    /** Screen height in pixels */
+    height: number;
+    /** DPI scaling factor (e.g., 1.0 for 100%, 1.5 for 150%, 2.0 for 200%) */
+    dpiScalingFactor: number;
+}
+/**
+ * Represents the current cursor position on screen.
+ *
+ * @interface CursorPosition
+ * @extends OperationResult
+ */
+interface CursorPosition extends OperationResult {
+    /** X coordinate in pixels (0 is left edge of screen) */
+    x: number;
+    /** Y coordinate in pixels (0 is top edge of screen) */
+    y: number;
+}
 
 /**
  */
@@ -840,6 +954,7 @@ declare class ClearContextResponse extends $dara.Model {
 declare class CreateMcpSessionRequest extends $dara.Model {
     authorization?: string;
     contextId?: string;
+    enableRecord?: boolean;
     externalUserId?: string;
     imageId?: string;
     labels?: string;
@@ -849,6 +964,7 @@ declare class CreateMcpSessionRequest extends $dara.Model {
     vpcResource?: boolean;
     extraConfigs?: string;
     sdkStats?: string;
+    loginRegionId?: string;
     static names(): {
         [key: string]: string;
     };
@@ -873,6 +989,7 @@ declare class CreateMcpSessionShrinkRequest extends $dara.Model {
     vpcResource?: boolean;
     extraConfigs?: string;
     sdkStats?: string;
+    loginRegionId?: string;
     static names(): {
         [key: string]: string;
     };
@@ -978,6 +1095,7 @@ declare class GetContextRequest extends $dara.Model {
     authorization?: string;
     contextId?: string;
     name?: string;
+    loginRegionId?: string;
     static names(): {
         [key: string]: string;
     };
@@ -1027,6 +1145,74 @@ declare class GetContextResponse extends $dara.Model {
     });
 }
 
+declare class GetAndLoadInternalContextRequest extends $dara.Model {
+    authorization?: string;
+    contextTypes?: string[];
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetAndLoadInternalContextResponseBodyData extends $dara.Model {
+    contextId?: string;
+    contextPath?: string;
+    contextType?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+declare class GetAndLoadInternalContextResponseBody extends $dara.Model {
+    code?: string;
+    data?: GetAndLoadInternalContextResponseBodyData[];
+    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 GetAndLoadInternalContextResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetAndLoadInternalContextResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class GetContextInfoRequest extends $dara.Model {
     authorization?: string;
     contextId?: string;
@@ -1515,6 +1701,8 @@ declare class ListContextsRequest extends $dara.Model {
     authorization?: string;
     maxResults?: number;
     nextToken?: string;
+    sessionId?: string;
+    type?: string;
     static names(): {
         [key: string]: string;
     };
@@ -2261,6 +2449,57 @@ declare class ResumeSessionAsyncResponse extends $dara.Model {
     }): ResumeSessionAsyncResponse;
 }
 
+declare class DeleteSessionAsyncRequest 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 DeleteSessionAsyncResponseBody extends $dara.Model {
+    code?: string;
+    httpStatusCode?: number;
+    message?: string;
+    requestId?: string;
+    success?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class DeleteSessionAsyncResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: DeleteSessionAsyncResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class Client extends OpenApi {
     constructor(config: $OpenApiUtil.Config);
     getEndpoint(productId: string, regionId: string, endpointRule: string, network: string, suffix: string, endpointMap: {
@@ -2311,6 +2550,21 @@ declare class Client extends OpenApi {
      * @returns CreateMcpSessionResponse
      */
     createMcpSession(request: CreateMcpSessionRequest): Promise<CreateMcpSessionResponse>;
+    /**
+     * Delete session
+     *
+     * @param request - DeleteSessionAsyncRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteSessionAsyncResponse
+     */
+    deleteSessionAsyncWithOptions(request: DeleteSessionAsyncRequest, runtime: $dara.RuntimeOptions): Promise<DeleteSessionAsyncResponse>;
+    /**
+     * Delete session
+     *
+     * @param request - DeleteSessionAsyncRequest
+     * @returns DeleteSessionAsyncResponse
+     */
+    deleteSessionAsync(request: DeleteSessionAsyncRequest): Promise<DeleteSessionAsyncResponse>;
     /**
      * Delete persistent context
      *
@@ -2446,6 +2700,21 @@ declare class Client extends OpenApi {
      * @returns GetMcpResourceResponse
      */
     getMcpResource(request: GetMcpResourceRequest): Promise<GetMcpResourceResponse>;
+    /**
+     * Get internal context request
+     *
+     * @param request - GetAndLoadInternalContextRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetAndLoadInternalContextResponse
+     */
+    getAndLoadInternalContextWithOptions(request: GetAndLoadInternalContextRequest, runtime: $dara.RuntimeOptions): Promise<GetAndLoadInternalContextResponse>;
+    /**
+     * Get internal context request
+     *
+     * @param request - GetAndLoadInternalContextRequest
+     * @returns GetAndLoadInternalContextResponse
+     */
+    getAndLoadInternalContext(request: GetAndLoadInternalContextRequest): Promise<GetAndLoadInternalContextResponse>;
     /**
      * Get context list
      *
@@ -2708,6 +2977,10 @@ interface ContextListParams {
      * Token for the next page of results.
      */
     nextToken?: string;
+    /**
+     * Optional session id to filter contexts by session
+     */
+    sessionId?: string;
 }
 /**
  * Provides methods to manage persistent contexts in the AgentBay cloud environment.
@@ -3063,6 +3336,29 @@ declare class ContextSync {
     contextId: string;
     path: string;
     policy?: SyncPolicy;
+    /**
+     * Defines a full context sync configuration with optional policy overrides.
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create();
+     * if (result.success) {
+     *   const policy = new SyncPolicyImpl({
+     *     uploadPolicy: newUploadPolicy(),
+     *     downloadPolicy: newDownloadPolicy(),
+     *     recyclePolicy: newRecyclePolicy(),
+     *   });
+     *   const syncResult = await result.session.context.sync(
+     *     'project-data',
+     *     '/mnt/shared',
+     *     'upload'
+     *   );
+     *   console.log('Context sync:', syncResult.success);
+     *   await result.session.delete();
+     * }
+     * ```
+     */
     constructor(contextId: string, path: string, policy?: SyncPolicy);
     withPolicy(policy: SyncPolicy): ContextSync;
 }
@@ -3080,18 +3376,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.
@@ -3111,12 +3420,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.
      */
@@ -3126,14 +3435,18 @@ 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);
+     *   const taskResult = await result.session.agent.computer.executeTask(
+     *     'Open notepad',
+     *     10
+     *   );
      *   console.log(`Task status: ${taskResult.taskStatus}`);
      *   await result.session.delete();
      * }
@@ -3151,10 +3464,11 @@ 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}`);
-     *   await result.session.delete();
+     *   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();
      * }
      * ```
      */
@@ -3163,15 +3477,122 @@ declare class Agent {
      * 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.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: 'linux_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: ${statusResult.taskStatus}`);
+     *   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: 'linux_latest' });
+     * if (result.success) {
+     *   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();
      * }
@@ -3179,35 +3600,53 @@ 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;
-    timeoutMS?: number;
-    iframes?: boolean;
-    domSettleTimeoutMS?: number;
+    timeout?: number;
     variables?: Record<string, string>;
     use_vision?: boolean;
 }
 interface ObserveOptions {
     instruction: string;
-    iframes?: boolean;
-    domSettleTimeoutMS?: number;
     use_vision?: boolean;
+    selector?: string;
+    timeout?: number;
 }
-interface ExtractOptions<T = any> {
+interface ExtractOptions<TSchema extends ZodTypeAny = ZodTypeAny> {
     instruction: string;
-    schema: new (...args: any[]) => T;
+    schema: TSchema;
     use_text_extract?: boolean;
     selector?: string;
-    iframe?: boolean;
-    domSettleTimeoutMS?: number;
     use_vision?: boolean;
+    timeout?: number;
 }
 declare class ActResult {
     success: boolean;
     message: string;
-    action?: string;
-    constructor(success: boolean, message: string, action?: string);
+    constructor(success: boolean, message: string);
 }
 declare class ObserveResult {
     selector: string;
@@ -3220,15 +3659,21 @@ declare class BrowserAgent {
     private session;
     private browser;
     constructor(session: Session, browser: Browser);
+    /** ------------------ NAVIGATE ------------------ **/
+    navigate(url: string): Promise<string>;
+    /** ------------------ SCREENSHOT ------------------ **/
+    screenshot(page?: any, full_page?: boolean, quality?: number, clip?: Record<string, number>, timeout?: number): Promise<string>;
+    /** ------------------ CLOSE ------------------ **/
+    close(): Promise<boolean>;
     /** ------------------ ACT ------------------ **/
-    act(options: ActOptions, page: any): Promise<ActResult>;
-    actAsync(options: ActOptions, page: any): Promise<ActResult>;
+    act(options: ActOptions, page?: any): Promise<ActResult>;
+    actAsync(options: ActOptions, page?: any): Promise<ActResult>;
     /** ------------------ OBSERVE ------------------ **/
-    observe(options: ObserveOptions, page: any): Promise<[boolean, ObserveResult[]]>;
-    observeAsync(options: ObserveOptions, page: any): Promise<[boolean, ObserveResult[]]>;
+    observe(options: ObserveOptions, page?: any): Promise<[boolean, ObserveResult[]]>;
+    observeAsync(options: ObserveOptions, page?: any): Promise<[boolean, ObserveResult[]]>;
     /** ------------------ EXTRACT ------------------ **/
-    extract<T>(options: ExtractOptions<T>, page: any): Promise<[boolean, T | null]>;
-    extractAsync<T>(options: ExtractOptions<T>, page: any): Promise<[boolean, T | null]>;
+    extract<TSchema extends ZodTypeAny>(options: ExtractOptions<TSchema>, page?: any): Promise<[boolean, z.infer<TSchema> | null]>;
+    extractAsync<TSchema extends ZodTypeAny>(options: ExtractOptions<TSchema>, page?: any): Promise<[boolean, z.infer<TSchema> | null]>;
     private _getPageAndContextIndexAsync;
     private _callMcpTool;
     private _delay;
@@ -3639,6 +4084,11 @@ declare class Code {
             requestId: string;
         }>;
     });
+    /**
+     * Parses the backend JSON response into a structured CodeExecutionResult
+     * @param data Raw JSON string from backend
+     */
+    private parseBackendResponse;
     /**
      * Execute code in the specified language with a timeout.
      * Corresponds to Python's run_code() method
@@ -3657,6 +4107,9 @@ declare class Code {
      * if (result.success) {
      *   const codeResult = await result.session.code.runCode('print("Hello")', "python");
      *   console.log(codeResult.result);
+     *   if (codeResult.results) {
+     *      // Access rich output like images or charts
+     *   }
      *   await result.session.delete();
      * }
      * ```
@@ -3683,14 +4136,28 @@ declare class Command {
      */
     private sanitizeError;
     /**
-     * Executes a shell command in the session environment.
+     * Execute a shell command with optional working directory and environment variables.
      *
-     * @param command - The shell command to execute.
-     * @param timeoutMs - Timeout in milliseconds. Defaults to 1000ms.
+     * Executes a shell command in the session environment with configurable timeout,
+     * working directory, and environment variables. The command runs with session
+     * user permissions in a Linux shell environment.
+     *
+     * @param command - The shell command to execute
+     * @param timeoutMs - Timeout in milliseconds (default: 1000ms/1s). Maximum allowed
+     *                    timeout is 50000ms (50s). If a larger value is provided,
+     *                    it will be automatically limited to 50000ms
+     * @param cwd - The working directory for command execution. If not specified,
+     *              the command runs in the default session directory
+     * @param envs - Environment variables as a dictionary of key-value pairs.
+     *              These variables are set for the command execution only
      *
      * @returns Promise resolving to CommandResult containing:
-     *          - success: Whether the command executed successfully
-     *          - output: Combined stdout and stderr output
+     *          - success: Whether the command executed successfully (exitCode === 0)
+     *          - output: Command output for backward compatibility (stdout + stderr)
+     *          - exitCode: The exit code of the command execution (0 for success)
+     *          - stdout: Standard output from the command execution
+     *          - stderr: Standard error from the command execution
+     *          - traceId: Trace ID for error tracking (only present when exitCode !== 0)
      *          - requestId: Unique identifier for this API request
      *          - errorMessage: Error description if execution failed
      *
@@ -3699,22 +4166,31 @@ declare class Command {
      * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
      * const result = await agentBay.create();
      * if (result.success) {
-     *   const cmdResult = await result.session.command.executeCommand('echo "Hello"', 3000);
+     *   const cmdResult = await result.session.command.executeCommand('echo "Hello"', 5000);
      *   console.log('Command output:', cmdResult.output);
+     *   console.log('Exit code:', cmdResult.exitCode);
+     *   console.log('Stdout:', cmdResult.stdout);
      *   await result.session.delete();
      * }
      * ```
      *
-     * @remarks
-     * **Behavior:**
-     * - Executes in a Linux shell environment
-     * - Combines stdout and stderr in the output
-     * - Default timeout is 1000ms (1 second)
-     * - Command runs with session user permissions
-     *
-     * @see {@link FileSystem.readFile}, {@link FileSystem.writeFile}
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create();
+     * if (result.success) {
+     *   const cmdResult = await result.session.command.executeCommand(
+     *     'pwd',
+     *     5000,
+     *     '/tmp',
+     *     { TEST_VAR: 'test_value' }
+     *   );
+     *   console.log('Working directory:', cmdResult.stdout);
+     *   await result.session.delete();
+     * }
+     * ```
      */
-    executeCommand(command: string, timeoutMs?: number): Promise<CommandResult>;
+    executeCommand(command: string, timeoutMs?: number, cwd?: string, envs?: Record<string, string>): Promise<CommandResult>;
 }
 
 /**
@@ -3800,6 +4276,9 @@ declare function replaceTemplatePlaceholders(template: string, replacements: Rec
  * Provides mouse, keyboard, and screen operations for desktop environments.
  */
 
+interface ScreenshotResult$1 extends OperationResult {
+    data: string;
+}
 declare enum MouseButton {
     LEFT = "left",
     RIGHT = "right",
@@ -3812,21 +4291,6 @@ declare enum ScrollDirection {
     LEFT = "left",
     RIGHT = "right"
 }
-interface BoolResult$1 extends OperationResult {
-    data?: boolean;
-}
-interface CursorPosition extends OperationResult {
-    x: number;
-    y: number;
-}
-interface ScreenSize extends OperationResult {
-    width: number;
-    height: number;
-    dpiScalingFactor: number;
-}
-interface ScreenshotResult$1 extends OperationResult {
-    data: string;
-}
 interface ComputerSession {
     callMcpTool(toolName: string, args: Record<string, any>): Promise<any>;
     sessionId: string;
@@ -3855,7 +4319,7 @@ declare class Computer {
      * }
      * ```
      */
-    clickMouse(x: number, y: number, button?: MouseButton | string): Promise<BoolResult$1>;
+    clickMouse(x: number, y: number, button?: MouseButton | string): Promise<OperationResult>;
     /**
      * Move mouse to specified coordinates.
      *
@@ -3875,7 +4339,7 @@ declare class Computer {
      * }
      * ```
      */
-    moveMouse(x: number, y: number): Promise<BoolResult$1>;
+    moveMouse(x: number, y: number): Promise<OperationResult>;
     /**
      * Drag mouse from one position to another.
      *
@@ -3897,7 +4361,7 @@ declare class Computer {
      * }
      * ```
      */
-    dragMouse(fromX: number, fromY: number, toX: number, toY: number, button?: MouseButton | string): Promise<BoolResult$1>;
+    dragMouse(fromX: number, fromY: number, toX: number, toY: number, button?: MouseButton | string): Promise<OperationResult>;
     /**
      * Scroll at specified coordinates.
      *
@@ -3917,7 +4381,7 @@ declare class Computer {
      * }
      * ```
      */
-    scroll(x: number, y: number, direction?: ScrollDirection | string, amount?: number): Promise<BoolResult$1>;
+    scroll(x: number, y: number, direction?: ScrollDirection | string, amount?: number): Promise<OperationResult>;
     /**
      * Input text at the current cursor position.
      *
@@ -3934,7 +4398,7 @@ declare class Computer {
      * }
      * ```
      */
-    inputText(text: string): Promise<BoolResult$1>;
+    inputText(text: string): Promise<OperationResult>;
     /**
      * Press one or more keys.
      *
@@ -3953,7 +4417,7 @@ declare class Computer {
      * }
      * ```
      */
-    pressKeys(keys: string[], hold?: boolean): Promise<BoolResult$1>;
+    pressKeys(keys: string[], hold?: boolean): Promise<OperationResult>;
     /**
      * Release previously pressed keys.
      *
@@ -3971,7 +4435,7 @@ declare class Computer {
      * }
      * ```
      */
-    releaseKeys(keys: string[]): Promise<BoolResult$1>;
+    releaseKeys(keys: string[]): Promise<OperationResult>;
     /**
      * Get cursor position.
      *
@@ -4058,7 +4522,7 @@ declare class Computer {
      * }
      * ```
      */
-    getActiveWindow(timeoutMs?: number): Promise<WindowInfoResult>;
+    getActiveWindow(): Promise<WindowInfoResult>;
     /**
      * Activates the specified window.
      *
@@ -4076,7 +4540,7 @@ declare class Computer {
      * }
      * ```
      */
-    activateWindow(windowId: number): Promise<BoolResult$2>;
+    activateWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Closes the specified window.
      *
@@ -4095,7 +4559,7 @@ declare class Computer {
      * }
      * ```
      */
-    closeWindow(windowId: number): Promise<BoolResult$2>;
+    closeWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Maximizes the specified window.
      *
@@ -4114,7 +4578,7 @@ declare class Computer {
      * }
      * ```
      */
-    maximizeWindow(windowId: number): Promise<BoolResult$2>;
+    maximizeWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Minimizes the specified window.
      *
@@ -4133,7 +4597,7 @@ declare class Computer {
      * }
      * ```
      */
-    minimizeWindow(windowId: number): Promise<BoolResult$2>;
+    minimizeWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Restores the specified window.
      *
@@ -4153,7 +4617,7 @@ declare class Computer {
      * }
      * ```
      */
-    restoreWindow(windowId: number): Promise<BoolResult$2>;
+    restoreWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Resizes the specified window.
      *
@@ -4174,7 +4638,7 @@ declare class Computer {
      * }
      * ```
      */
-    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult$2>;
+    resizeWindow(windowId: number, width: number, height: number): Promise<BoolResult$1>;
     /**
      * Makes the specified window fullscreen.
      *
@@ -4193,7 +4657,7 @@ declare class Computer {
      * }
      * ```
      */
-    fullscreenWindow(windowId: number): Promise<BoolResult$2>;
+    fullscreenWindow(windowId: number): Promise<BoolResult$1>;
     /**
      * Toggles focus mode on or off.
      *
@@ -4211,7 +4675,7 @@ declare class Computer {
      * }
      * ```
      */
-    focusMode(on: boolean): Promise<BoolResult$2>;
+    focusMode(on: boolean): Promise<BoolResult$1>;
     /**
      * Gets the list of installed applications.
      *
@@ -4231,7 +4695,7 @@ declare class Computer {
      * }
      * ```
      */
-    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<any>;
+    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<InstalledAppListResult>;
     /**
      * Starts the specified application.
      *
@@ -4251,7 +4715,7 @@ declare class Computer {
      * }
      * ```
      */
-    startApp(startCmd: string, workDirectory?: string, activity?: string): Promise<any>;
+    startApp(startCmd: string, workDirectory?: string, activity?: string): Promise<ProcessListResult>;
     /**
      * Stops an application by process name.
      *
@@ -4269,7 +4733,7 @@ declare class Computer {
      * }
      * ```
      */
-    stopAppByPName(pname: string): Promise<any>;
+    stopAppByPName(pname: string): Promise<BoolResult$1>;
     /**
      * Stops an application by process ID.
      *
@@ -4288,7 +4752,7 @@ declare class Computer {
      * }
      * ```
      */
-    stopAppByPID(pid: number): Promise<any>;
+    stopAppByPID(pid: number): Promise<BoolResult$1>;
     /**
      * Stops an application by stop command.
      *
@@ -4306,7 +4770,7 @@ declare class Computer {
      * }
      * ```
      */
-    stopAppByCmd(cmd: string): Promise<any>;
+    stopAppByCmd(cmd: string): Promise<BoolResult$1>;
     /**
      * Lists all visible applications.
      *
@@ -4323,7 +4787,7 @@ declare class Computer {
      * }
      * ```
      */
-    listVisibleApps(): Promise<any>;
+    listVisibleApps(): Promise<ProcessListResult>;
 }
 
 interface ContextStatusData {
@@ -4521,6 +4985,24 @@ declare class FileSystem {
      * @returns The FileTransfer instance
      */
     private _ensureFileTransfer;
+    /**
+     * Get the context path for file transfer operations.
+     *
+     * This method ensures the context ID is loaded and returns the associated
+     * context path that was retrieved from GetAndLoadInternalContext API.
+     *
+     * @returns The context path if available, null otherwise.
+     *
+     * @example
+     * ```typescript
+     * const session = (await agentBay.create(params)).session;
+     * const contextPath = await session.fileSystem.getFileTransferContextPath();
+     * if (contextPath) {
+     *   console.log(`Context path: ${contextPath}`);
+     * }
+     * ```
+     */
+    getFileTransferContextPath(): Promise<string | null>;
     /**
      * Creates a new directory at the specified path.
      * Corresponds to Python's create_directory() method
@@ -4539,7 +5021,28 @@ declare class FileSystem {
      * }
      * ```
      */
-    createDirectory(path: string): Promise<BoolResult$2>;
+    createDirectory(path: string): Promise<BoolResult$1>;
+    /**
+     * Deletes a file at the specified path.
+     * Corresponds to Python's delete_file() method
+     *
+     * @param path - Path to the file to delete.
+     * @returns BoolResult with deletion result and requestId
+     *
+     * @example
+     * ```typescript
+     * const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+     * const result = await agentBay.create();
+     * if (result.success) {
+     *   const session = result.session;
+     *   await session.fileSystem.writeFile('/tmp/to_delete.txt', 'hello');
+     *   const deleteResult = await session.fileSystem.deleteFile('/tmp/to_delete.txt');
+     *   console.log('File deleted:', deleteResult.success);
+     *   await session.delete();
+     * }
+     * ```
+     */
+    deleteFile(path: string): Promise<BoolResult$1>;
     /**
      * Edits a file by replacing occurrences of oldText with newText.
      * Corresponds to Python's edit_file() method
@@ -4565,7 +5068,7 @@ declare class FileSystem {
     editFile(path: string, edits: Array<{
         oldText: string;
         newText: string;
-    }>, dryRun?: boolean): Promise<BoolResult$2>;
+    }>, dryRun?: boolean): Promise<BoolResult$1>;
     /**
      * Gets information about a file or directory.
      * Corresponds to Python's get_file_info() method
@@ -4646,7 +5149,7 @@ declare class FileSystem {
      * }
      * ```
      */
-    moveFile(source: string, destination: string): Promise<BoolResult$2>;
+    moveFile(source: string, destination: string): Promise<BoolResult$1>;
     /**
      * Internal method to read a file chunk. Used for chunked file operations.
      *
@@ -4816,7 +5319,7 @@ declare class FileSystem {
      *
      * @see {@link readFile}, {@link listDirectory}
      */
-    writeFile(path: string, content: string, mode?: string): Promise<BoolResult$2>;
+    writeFile(path: string, content: string, mode?: string): Promise<BoolResult$1>;
     /**
      * Get file change information for the specified directory path
      *
@@ -4941,63 +5444,28 @@ interface AppManagerRule {
 }
 /**
  * Mobile simulate mode enum.
- *
- * Defines the mode for mobile device simulation.
  */
 declare enum MobileSimulateMode {
-    /**
-     * Only simulate device properties (build.prop).
-     */
     PropertiesOnly = "PropertiesOnly",
-    /**
-     * Only simulate sensors information.
-     */
     SensorsOnly = "SensorsOnly",
-    /**
-     * Only simulate installed packages.
-     */
     PackagesOnly = "PackagesOnly",
-    /**
-     * Only simulate system services.
-     */
     ServicesOnly = "ServicesOnly",
-    /**
-     * Simulate all aspects (properties, sensors, packages, and services).
-     */
     All = "All"
 }
 /**
- * Mobile simulate configuration for session creation.
- *
- * These settings allow simulation of different mobile devices by applying
- * device-specific properties and configurations.
+ * Mobile simulate configuration.
  */
 interface MobileSimulateConfig {
-    /**
-     * Whether to enable mobile device simulation.
-     */
     simulate: boolean;
-    /**
-     * Path to the mobile device information file.
-     */
     simulatePath?: string;
-    /**
-     * Simulation mode - controls what aspects of the device are simulated.
-     * Defaults to PropertiesOnly if not specified.
-     */
-    simulateMode?: MobileSimulateMode;
-    /**
-     * Context ID containing the mobile device information to simulate.
-     * This should be obtained from MobileSimulateService.uploadMobileInfo().
-     */
+    simulateMode: MobileSimulateMode;
     simulatedContextId?: string;
 }
 /**
  * Mobile-specific configuration settings for session creation.
  *
  * These settings allow control over mobile device behavior including
- * resolution locking, app access management, navigation bar visibility, uninstall protection,
- * and device simulation.
+ * resolution locking, app access management, navigation bar visibility, and uninstall protection.
  */
 interface MobileExtraConfig {
     /**
@@ -5024,8 +5492,8 @@ interface MobileExtraConfig {
      */
     uninstallBlacklist?: string[];
     /**
-     * Optional mobile device simulation configuration.
-     * Allows simulation of different mobile devices by applying device-specific properties.
+     * Configuration for mobile device simulation.
+     * Used to simulate specific device properties, sensors, etc.
      */
     simulateConfig?: MobileSimulateConfig;
 }
@@ -5505,8 +5973,6 @@ interface McpToolsResult extends OperationResult {
 declare class Session {
     private agentBay;
     sessionId: string;
-    fileTransferContextId: string | null;
-    recordContextId: string | null;
     isVpc: boolean;
     networkInterfaceIp: string;
     httpPort: string;
@@ -6370,16 +6836,18 @@ interface CreateSessionParamsConfig {
     isVpc?: boolean;
     /** Policy id to apply when creating the session. */
     policyId?: string;
-    /** Whether to enable browser recording for the session. Defaults to false. */
+    /** Whether to enable browser recording for the session. Defaults to true. */
     enableBrowserReplay?: boolean;
     /** Extra configuration settings for different session types (e.g., mobile) */
     extraConfigs?: ExtraConfigs;
+    /** Framework name for SDK statistics tracking */
+    framework?: string;
 }
 /**
  * CreateSessionParams provides a way to configure the parameters for creating a new session
  * in the AgentBay cloud environment.
  */
-declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
+declare class CreateSessionParams implements CreateSessionParamsConfig {
     /** Custom labels for the Session. These can be used for organizing and filtering sessions. */
     labels: Record<string, string>;
     /** Image ID to use for the session. */
@@ -6395,43 +6863,49 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
     isVpc: boolean;
     /** Policy id to apply when creating the session. */
     policyId?: string;
-    /** Whether to enable browser recording for the session. Defaults to false. */
-    enableBrowserReplay: boolean;
+    /** Whether to enable browser recording for the session. Defaults to true. */
+    enableBrowserReplay?: boolean;
     /** Extra configuration settings for different session types (e.g., mobile) */
     extraConfigs?: ExtraConfigs;
+    /** Framework name for SDK statistics tracking */
+    framework?: string;
     constructor();
     /**
      * WithLabels sets the labels for the session parameters and returns the updated parameters.
      */
-    withLabels(labels: Record<string, string>): CreateSessionParams$1;
+    withLabels(labels: Record<string, string>): CreateSessionParams;
     /**
      * WithImageId sets the image ID for the session parameters and returns the updated parameters.
      */
-    withImageId(imageId: string): CreateSessionParams$1;
+    withImageId(imageId: string): CreateSessionParams;
     /**
      * WithBrowserContext sets the browser context for the session parameters and returns the updated parameters.
      */
-    withBrowserContext(browserContext: BrowserContext): CreateSessionParams$1;
+    withBrowserContext(browserContext: BrowserContext): CreateSessionParams;
     /**
      * WithIsVpc sets the VPC flag for the session parameters and returns the updated parameters.
      */
-    withIsVpc(isVpc: boolean): CreateSessionParams$1;
+    withIsVpc(isVpc: boolean): CreateSessionParams;
     /**
      * WithPolicyId sets the policy id for the session parameters and returns the updated parameters.
      */
-    withPolicyId(policyId: string): CreateSessionParams$1;
+    withPolicyId(policyId: string): CreateSessionParams;
     /**
      * WithenableBrowserReplay sets the browser recording flag for the session parameters and returns the updated parameters.
      */
-    withEnableBrowserReplay(enableBrowserReplay: boolean): CreateSessionParams$1;
+    withEnableBrowserReplay(enableBrowserReplay: boolean): CreateSessionParams;
     /**
      * Alias for withEnableBrowserReplay for backward compatibility.
      */
-    withEnableRecord(enableRecord: boolean): CreateSessionParams$1;
+    withEnableRecord(enableRecord: boolean): CreateSessionParams;
     /**
      * WithExtraConfigs sets the extra configurations for the session parameters and returns the updated parameters.
      */
-    withExtraConfigs(extraConfigs: ExtraConfigs): CreateSessionParams$1;
+    withExtraConfigs(extraConfigs: ExtraConfigs): CreateSessionParams;
+    /**
+     * WithFramework sets the framework name for the session parameters and returns the updated parameters.
+     */
+    withFramework(framework: 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.
@@ -6445,15 +6919,15 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
     /**
      * AddContextSync adds a context sync configuration to the session parameters.
      */
-    addContextSync(contextId: string, path: string, policy?: SyncPolicy): CreateSessionParams$1;
+    addContextSync(contextId: string, path: string, policy?: SyncPolicy): CreateSessionParams;
     /**
      * AddContextSyncConfig adds a pre-configured context sync to the session parameters.
      */
-    addContextSyncConfig(contextSync: ContextSync): CreateSessionParams$1;
+    addContextSyncConfig(contextSync: ContextSync): CreateSessionParams;
     /**
      * WithContextSync sets the context sync configurations for the session parameters.
      */
-    withContextSync(contextSyncs: ContextSync[]): CreateSessionParams$1;
+    withContextSync(contextSyncs: ContextSync[]): CreateSessionParams;
     /**
      * Convert to plain object for JSON serialization
      */
@@ -6461,12 +6935,12 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
     /**
      * Create from plain object
      */
-    static fromJSON(config: CreateSessionParamsConfig): CreateSessionParams$1;
+    static fromJSON(config: CreateSessionParamsConfig): CreateSessionParams;
 }
 /**
  * NewCreateSessionParams creates a new CreateSessionParams with default values.
  */
-declare function newCreateSessionParams(): CreateSessionParams$1;
+declare function newCreateSessionParams(): CreateSessionParams;
 
 /**
  * Parameters for listing sessions with pagination support
@@ -6500,7 +6974,7 @@ declare function createListSessionParams(labels?: Record<string, string>): ListS
 /**
  * Parameters for creating a session.
  */
-interface CreateSessionParams {
+interface CreateSeesionWithParams {
     labels?: Record<string, string>;
     imageId?: string;
     contextSync?: ContextSync[];
@@ -6516,9 +6990,9 @@ interface CreateSessionParams {
  */
 declare class AgentBay {
     private apiKey;
-    private client;
+    client: Client;
     private endpoint;
-    private fileTransferContext;
+    private config;
     /**
      * Context service for managing persistent contexts.
      */
@@ -6536,6 +7010,11 @@ declare class AgentBay {
         config?: Config;
         envFile?: string;
     });
+    /**
+     * Get the region ID.
+     * @returns The region ID or undefined if not set.
+     */
+    getRegionId(): string | undefined;
     /**
      * Wait for mobile simulate command to complete.
      *
@@ -6544,13 +7023,6 @@ declare class AgentBay {
      * @param mobileSimMode - The mode of the mobile simulate. If not provided, will use the default mode.
      */
     private _waitForMobileSimulate;
-    /**
-     * Update browser replay context with AppInstanceId from response data.
-     *
-     * @param responseData - Response data containing AppInstanceId
-     * @param recordContextId - The record context ID to update
-     */
-    private _updateBrowserReplayContext;
     /**
      * Create a new session in the AgentBay cloud environment.
      *
@@ -6599,7 +7071,7 @@ declare class AgentBay {
      *
      * @see {@link get}, {@link list}, {@link Session.delete}
      */
-    create(params?: CreateSessionParams): Promise<SessionResult>;
+    create(params: CreateSessionParams | CreateSeesionWithParams): Promise<SessionResult>;
     /**
      * Returns paginated list of session IDs filtered by labels.
      *
@@ -6750,6 +7222,12 @@ declare class AgentBay {
      * @see {@link pauseAsync}, {@link Session.resumeAsync}
      */
     resumeAsync(session: Session, timeout?: number, pollInterval?: number): Promise<SessionResumeResult>;
+    /**
+     * Creates a deep copy of CreateSessionParams to avoid modifying the original object.
+     * @param params - The original params object to copy
+     * @returns A deep copy of the params object
+     */
+    private deepCopyParams;
 }
 
 /**
@@ -7060,4 +7538,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, CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, type DeleteResult, DeleteSessionAsyncRequest, DeleteSessionAsyncResponse, DeleteSessionAsyncResponseBody, 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, GetAndLoadInternalContextRequest, GetAndLoadInternalContextResponse, GetAndLoadInternalContextResponseBody, GetAndLoadInternalContextResponseBodyData, 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 };