test-wuying-agentbay-sdk 0.13.0-beta.20251212133706 → 0.13.0-beta.20251212160413

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import * as $dara from '@darabonba/typescript';
 import OpenApi, { $OpenApiUtil } from '@alicloud/openapi-core';
+import { ZodTypeAny, z } from 'zod';
 
 interface Config {
     endpoint: string;
@@ -3400,32 +3401,28 @@ declare class Agent {
 
 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;
@@ -3438,15 +3435,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;
@@ -6588,12 +6591,14 @@ interface CreateSessionParamsConfig {
     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. */
@@ -6613,39 +6618,45 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
     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.
@@ -6659,15 +6670,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
      */
@@ -6675,12 +6686,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
@@ -6714,7 +6725,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[];
@@ -6730,7 +6741,7 @@ interface CreateSessionParams {
  */
 declare class AgentBay {
     private apiKey;
-    private client;
+    client: Client;
     private endpoint;
     private fileTransferContext;
     private config;
@@ -6819,7 +6830,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.
      *
@@ -7280,4 +7291,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 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 };
+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, 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

@@ -1,5 +1,6 @@
 import * as $dara from '@darabonba/typescript';
 import OpenApi, { $OpenApiUtil } from '@alicloud/openapi-core';
+import { ZodTypeAny, z } from 'zod';
 
 interface Config {
     endpoint: string;
@@ -3400,32 +3401,28 @@ declare class Agent {
 
 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;
@@ -3438,15 +3435,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;
@@ -6588,12 +6591,14 @@ interface CreateSessionParamsConfig {
     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. */
@@ -6613,39 +6618,45 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
     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.
@@ -6659,15 +6670,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
      */
@@ -6675,12 +6686,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
@@ -6714,7 +6725,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[];
@@ -6730,7 +6741,7 @@ interface CreateSessionParams {
  */
 declare class AgentBay {
     private apiKey;
-    private client;
+    client: Client;
     private endpoint;
     private fileTransferContext;
     private config;
@@ -6819,7 +6830,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.
      *
@@ -7280,4 +7291,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 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 };
+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, 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 };