wuying-agentbay-sdk 0.9.3 → 0.10.0

package/dist/index.d.mts

@@ -1,6 +1,39 @@
 import * as $dara from '@darabonba/typescript';
 import OpenApi, { $OpenApiUtil } from '@alicloud/openapi-core';
 
+interface Config {
+    endpoint: string;
+    timeout_ms: number;
+}
+/**
+ * Load .env file into process.env if it exists
+ * This function should be called early to ensure .env variables are available
+ * @deprecated Use loadDotEnvWithFallback instead
+ */
+declare function loadDotEnv(): void;
+/**
+ * The SDK uses the following precedence order for configuration (highest to lowest):
+ * 1. Explicitly passed configuration in code.
+ * 2. Environment variables.
+ * 3. .env file.
+ * 4. Default configuration.
+ */
+/**
+ * Load configuration with improved .env file search.
+ *
+ * @param customConfig Configuration object (if provided, skips env loading)
+ * @param customEnvPath Custom path to .env file (optional)
+ * @returns Configuration object
+ */
+declare function loadConfig(customConfig?: Config, customEnvPath?: string): Config;
+
+/**
+ * Version information for the AgentBay SDK
+ * Automatically read from package.json
+ */
+declare const VERSION: string;
+declare const IS_RELEASE: boolean;
+
 /**
  */
 declare class ApplyMqttTokenResponseBodyData extends $dara.Model {
@@ -323,6 +356,57 @@ declare class CallMcpToolResponse extends $dara.Model {
     });
 }
 
+declare class ClearContextRequest extends $dara.Model {
+    authorization?: string;
+    id?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ClearContextResponseBody 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 ClearContextResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: ClearContextResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
 declare class CreateMcpSessionRequest extends $dara.Model {
     authorization?: string;
     contextId?: string;
@@ -333,6 +417,8 @@ declare class CreateMcpSessionRequest extends $dara.Model {
     persistenceDataList?: CreateMcpSessionRequestPersistenceDataList[];
     sessionId?: string;
     vpcResource?: boolean;
+    extraConfigs?: string;
+    sdkStats?: string;
     static names(): {
         [key: string]: string;
     };
@@ -355,6 +441,8 @@ declare class CreateMcpSessionShrinkRequest extends $dara.Model {
     persistenceDataListShrink?: string;
     sessionId?: string;
     vpcResource?: boolean;
+    extraConfigs?: string;
+    sdkStats?: string;
     static names(): {
         [key: string]: string;
     };
@@ -458,6 +546,7 @@ declare class DeleteContextResponse extends $dara.Model {
 declare class GetContextRequest extends $dara.Model {
     allowCreate?: boolean;
     authorization?: string;
+    contextId?: string;
     name?: string;
     static names(): {
         [key: string]: string;
@@ -677,6 +766,7 @@ declare class GetLinkRequest extends $dara.Model {
     port?: number;
     protocolType?: string;
     sessionId?: string;
+    option?: string;
     static names(): {
         [key: string]: string;
     };
@@ -1516,6 +1606,21 @@ declare class Client extends OpenApi {
      * @returns CallMcpToolResponse
      */
     callMcpTool(request: CallMcpToolRequest): Promise<CallMcpToolResponse>;
+    /**
+     * Delete Persistent Context
+     *
+     * @param request - ClearContextRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ClearContextResponse
+     */
+    clearContextWithOptions(request: ClearContextRequest, runtime: $dara.RuntimeOptions): Promise<ClearContextResponse>;
+    /**
+     * Delete Persistent Context
+     *
+     * @param request - ClearContextRequest
+     * @returns ClearContextResponse
+     */
+    clearContext(request: ClearContextRequest): Promise<ClearContextResponse>;
     /**
      * Create MCP session
      *
@@ -1825,32 +1930,6 @@ declare class Client extends OpenApi {
     getContextFileUploadUrl(request: GetContextFileUploadUrlRequest): Promise<GetContextFileUploadUrlResponse>;
 }
 
-interface Config {
-    endpoint: string;
-    timeout_ms: number;
-}
-/**
- * Load .env file into process.env if it exists
- * This function should be called early to ensure .env variables are available
- * @deprecated Use loadDotEnvWithFallback instead
- */
-declare function loadDotEnv(): void;
-/**
- * The SDK uses the following precedence order for configuration (highest to lowest):
- * 1. Explicitly passed configuration in code.
- * 2. Environment variables.
- * 3. .env file.
- * 4. Default configuration.
- */
-/**
- * Load configuration with improved .env file search.
- *
- * @param customConfig Configuration object (if provided, skips env loading)
- * @param customEnvPath Custom path to .env file (optional)
- * @returns Configuration object
- */
-declare function loadConfig(customConfig?: Config, customEnvPath?: string): Config;
-
 /**
  * Base interface for API responses
  */
@@ -1862,6 +1941,15 @@ interface ApiResponse {
     /** Optional status code if the operation failed */
     success?: boolean;
 }
+/**
+ * Generic interface for API responses that include data payload
+ * @template T The type of the data being returned
+ */
+interface ApiResponseWithData<T> extends ApiResponse {
+    /** The actual data payload returned by the API */
+    session?: T;
+    data?: T;
+}
 /**
  * Interface for delete operation responses
  */
@@ -2254,6 +2342,30 @@ interface ContextFileListResult extends ApiResponse {
     /** Optional error message if the operation failed */
     errorMessage?: string;
 }
+/**
+ * Helper function to extract request ID from API responses
+ */
+declare function extractRequestId(response: any): string | undefined;
+/**
+ * Result of context clear operations, including the real-time status.
+ * Corresponds to Python's ClearContextResult type
+ */
+interface ClearContextResult extends ApiResponse {
+    /** Request identifier for tracking API calls */
+    requestId: string;
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Current status of the clearing task. This corresponds to the
+        context's state field. Possible values:
+        - "clearing": Context data is being cleared (in progress)
+        - "available": Clearing completed successfully
+        - Other values may indicate the context state after clearing */
+    status?: string;
+    /** The unique identifier of the context being cleared */
+    contextId?: string;
+    /** Optional error message if the operation failed */
+    errorMessage?: string;
+}
 
 /**
  * Represents a persistent storage context in the AgentBay cloud environment.
@@ -2377,6 +2489,47 @@ declare class ContextService {
      * List files under a specific folder path in a context.
      */
     listFiles(contextId: string, parentFolderPath: string, pageNumber?: number, pageSize?: number): Promise<ContextFileListResult>;
+    /**
+     * Asynchronously initiate a task to clear the context's persistent data.
+     *
+     * This is a non-blocking method that returns immediately after initiating the clearing task
+     * on the backend. The context's state will transition to "clearing" while the operation
+     * is in progress.
+     *
+     * @param contextId - Unique ID of the context to clear.
+     * @returns A ClearContextResult object indicating the task has been successfully started,
+     *          with status field set to "clearing".
+     * @throws APIError - If the backend API rejects the clearing request (e.g., invalid ID).
+     */
+    clearAsync(contextId: string): Promise<ClearContextResult>;
+    /**
+     * Queries the status of the clearing task.
+     *
+     * This method calls GetContext API directly and parses the raw response to extract
+     * the state field, which indicates the current clearing status.
+     *
+     * @param contextId - ID of the context.
+     * @returns ClearContextResult object containing the current task status.
+     */
+    getClearStatus(contextId: string): Promise<ClearContextResult>;
+    /**
+     * Synchronously clear the context's persistent data and wait for the final result.
+     *
+     * This method wraps the `clearAsync` and `getClearStatus` polling logic,
+     * providing the simplest and most direct way to handle clearing tasks.
+     *
+     * The clearing process transitions through the following states:
+     * - "clearing": Data clearing is in progress
+     * - "available": Clearing completed successfully (final success state)
+     *
+     * @param contextId - Unique ID of the context to clear.
+     * @param timeout - (Optional) Timeout in seconds to wait for task completion, default is 60 seconds.
+     * @param pollInterval - (Optional) Interval in seconds between status polls, default is 2 seconds.
+     * @returns A ClearContextResult object containing the final task result.
+     *          The status field will be "available" on success, or other states if interrupted.
+     * @throws APIError - If the task fails to complete within the specified timeout.
+     */
+    clear(contextId: string, timeout?: number, pollInterval?: number): Promise<ClearContextResult>;
 }
 
 declare enum UploadStrategy {
@@ -2385,6 +2538,10 @@ declare enum UploadStrategy {
 declare enum DownloadStrategy {
     DownloadAsync = "DownloadAsync"
 }
+declare enum UploadMode {
+    File = "File",
+    Archive = "Archive"
+}
 declare enum Lifecycle {
     Lifecycle_1Day = "Lifecycle_1Day",
     Lifecycle_3Days = "Lifecycle_3Days",
@@ -2400,6 +2557,7 @@ declare enum Lifecycle {
 interface UploadPolicy {
     autoUpload: boolean;
     uploadStrategy: UploadStrategy;
+    uploadMode: UploadMode;
 }
 interface DownloadPolicy {
     autoDownload: boolean;
@@ -2774,6 +2932,12 @@ interface BrowserOption {
     proxies?: BrowserProxy[];
     /** Path to the extensions directory. Defaults to "/tmp/extensions/" */
     extensionPath?: string;
+    /** Additional command line arguments for the browser */
+    cmdArgs?: string[];
+    /** Default URL to navigate to when browser starts */
+    defaultNavigateUrl?: string;
+    /** Browser type: 'chrome' or 'chromium'. Defaults to undefined */
+    browserType?: 'chrome' | 'chromium' | undefined;
 }
 declare class BrowserOptionClass implements BrowserOption {
     persistentPath?: string;
@@ -2785,7 +2949,10 @@ declare class BrowserOptionClass implements BrowserOption {
     solveCaptchas?: boolean;
     proxies?: BrowserProxy[];
     extensionPath?: string;
-    constructor(useStealth?: boolean, userAgent?: string, viewport?: BrowserViewport, screen?: BrowserScreen, fingerprint?: BrowserFingerprint, solveCaptchas?: boolean, proxies?: BrowserProxy[]);
+    cmdArgs?: string[];
+    defaultNavigateUrl?: string;
+    browserType?: 'chrome' | 'chromium' | undefined;
+    constructor(useStealth?: boolean, userAgent?: string, viewport?: BrowserViewport, screen?: BrowserScreen, fingerprint?: BrowserFingerprint, solveCaptchas?: boolean, proxies?: BrowserProxy[], cmdArgs?: string[], defaultNavigateUrl?: string, browserType?: 'chrome' | 'chromium');
     toMap(): Record<string, any>;
     fromMap(m: Record<string, any> | null | undefined): BrowserOptionClass;
 }
@@ -2806,6 +2973,10 @@ declare class Browser {
      * Returns true if successful, false otherwise.
      */
     initializeAsync(option: BrowserOptionClass | BrowserOption): Promise<boolean>;
+    /**
+     * Destroy the browser instance.
+     */
+    destroy(): Promise<void>;
     /**
      * Returns the endpoint URL if the browser is initialized, otherwise throws an exception.
      * When initialized, always fetches the latest CDP url from session.getLink().
@@ -2889,6 +3060,83 @@ declare class Command {
     executeCommand(command: string, timeoutMs?: number): Promise<CommandResult>;
 }
 
+/**
+ * Command templates for various AgentBay operations.
+ *
+ * This module contains shell command templates used by different modules
+ * to execute operations in remote environments.
+ *
+ * Template naming convention:
+ * - Use descriptive names that clearly indicate the operation
+ * - Group templates by functionality (mobile, desktop, network, etc.)
+ * - Use consistent parameter naming across similar templates
+ *
+ * Parameter conventions:
+ * - Use snake_case for parameter names
+ * - Include descriptive parameter names (e.g., lock_switch, package_list)
+ * - Document expected parameter types and values
+ */
+/**
+ * Resolution lock template
+ * Parameters:
+ *   lock_switch (string): "1" to enable lock, "0" to disable lock
+ */
+declare const RESOLUTION_LOCK_TEMPLATE = "setprop sys.wuying.lockres {lock_switch}";
+/**
+ * Application whitelist template
+ * Parameters:
+ *   package_list (string): Newline-separated list of package names
+ */
+declare const APP_WHITELIST_TEMPLATE = "cat > /data/system/pm_whitelist.txt << 'EOF'\n{package_list}\nEOF\nchmod 644 /data/system/pm_whitelist.txt\nsetprop rw.wy.pm_whitelist.refresh 1\nsetprop persist.wy.pm_blacklist.switch 2";
+/**
+ * Application blacklist template
+ * Parameters:
+ *   package_list (string): Newline-separated list of package names
+ */
+declare const APP_BLACKLIST_TEMPLATE = "cat > /data/system/pm_blacklist.txt << 'EOF'\n{package_list}\nEOF\nchmod 644 /data/system/pm_blacklist.txt\nsetprop rw.wy.pm_blacklist.refresh 1\nsetprop persist.wy.pm_blacklist.switch 1";
+/**
+ * Hide navigation bar template
+ * Hides the system navigation bar by setting system property and restarting SystemUI
+ */
+declare const HIDE_NAVIGATION_BAR_TEMPLATE = "setprop persist.wy.hasnavibar false; killall com.android.systemui";
+/**
+ * Show navigation bar template
+ * Shows the system navigation bar by setting system property and restarting SystemUI
+ */
+declare const SHOW_NAVIGATION_BAR_TEMPLATE = "setprop persist.wy.hasnavibar true; killall com.android.systemui";
+/**
+ * Uninstall blacklist template
+ * Parameters:
+ *   package_list (string): Semicolon-separated list of package names
+ */
+declare const UNINSTALL_BLACKLIST_TEMPLATE = "setprop persist.wy.pm_lock \"{package_list}\"";
+/**
+ * Mobile command templates mapping for easy access
+ */
+declare const MOBILE_COMMAND_TEMPLATES: Record<string, string>;
+/**
+ * Get a mobile command template by name
+ *
+ * @param templateName - The name of the template to retrieve
+ * @returns The template string if found, undefined otherwise
+ */
+declare function getMobileCommandTemplate(templateName: string): string | undefined;
+/**
+ * Check if a mobile command template exists
+ *
+ * @param templateName - The name of the template to check
+ * @returns True if the template exists, false otherwise
+ */
+declare function hasMobileCommandTemplate(templateName: string): boolean;
+/**
+ * Replace placeholders in a template with actual values
+ *
+ * @param template - The template string with placeholders
+ * @param replacements - Object containing placeholder-value pairs
+ * @returns The template with placeholders replaced
+ */
+declare function replaceTemplatePlaceholders(template: string, replacements: Record<string, string>): string;
+
 /**
  * Computer module for desktop UI automation.
  * Provides mouse, keyboard, and screen operations for desktop environments.
@@ -3010,6 +3258,30 @@ declare class Computer {
      * Toggles focus mode on or off.
      */
     focusMode(on: boolean): Promise<BoolResult$2>;
+    /**
+     * Gets the list of installed applications.
+     */
+    getInstalledApps(): Promise<any>;
+    /**
+     * Starts the specified application.
+     */
+    startApp(startCmd: string, workDirectory?: string): Promise<any>;
+    /**
+     * Stops an application by process name.
+     */
+    stopAppByPName(pname: string): Promise<any>;
+    /**
+     * Stops an application by process ID.
+     */
+    stopAppByPID(pid: number): Promise<any>;
+    /**
+     * Stops an application by stop command.
+     */
+    stopAppByCmd(cmd: string): Promise<any>;
+    /**
+     * Lists all visible applications.
+     */
+    listVisibleApps(): Promise<any>;
 }
 
 interface ContextStatusData {
@@ -3275,6 +3547,106 @@ declare class FileSystem {
     }): Promise<any>;
 }
 
+/**
+ * App manager rule for mobile device configuration.
+ *
+ * Defines rules for managing app access on mobile devices through whitelist or blacklist modes.
+ */
+interface AppManagerRule {
+    /**
+     * Type of rule to apply.
+     * - "White": Whitelist mode - only allow specified apps
+     * - "Black": Blacklist mode - block specified apps
+     */
+    ruleType: "White" | "Black";
+    /**
+     * List of Android package names to apply the rule to.
+     * Example: ["com.android.settings", "com.example.app"]
+     */
+    appPackageNameList: 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, and uninstall protection.
+ */
+interface MobileExtraConfig {
+    /**
+     * Whether to lock the screen resolution.
+     * - true: Locks resolution for consistent mobile testing environments
+     * - false: Allows adaptive resolution for different device types
+     */
+    lockResolution: boolean;
+    /**
+     * Optional app manager rule for controlling app access.
+     * Defines which apps are allowed (whitelist) or blocked (blacklist).
+     */
+    appManagerRule?: AppManagerRule;
+    /**
+     * Whether to hide the system navigation bar for immersive full-screen experience.
+     * - true: Hide navigation bar
+     * - false: Show navigation bar (default)
+     */
+    hideNavigationBar?: boolean;
+    /**
+     * List of package names to protect from uninstallation.
+     * Prevents accidental or malicious removal of critical apps.
+     * Example: ["com.android.systemui", "com.android.settings"]
+     */
+    uninstallBlacklist?: string[];
+}
+/**
+ * Extra configuration settings for different session types.
+ *
+ * This container holds specialized configurations for various
+ * session environments (mobile, desktop, etc.).
+ */
+interface ExtraConfigs {
+    /**
+     * Mobile-specific configuration settings.
+     * Only applicable when creating mobile sessions.
+     */
+    mobile?: MobileExtraConfig;
+}
+/**
+ * Serializes ExtraConfigs to JSON string format.
+ * Returns empty string if extraConfigs is null or undefined.
+ *
+ * @param extraConfigs - The extra configs to serialize
+ * @returns JSON string representation
+ */
+declare function extraConfigsToJSON(extraConfigs?: ExtraConfigs | null): string;
+/**
+ * Deserializes ExtraConfigs from JSON string format.
+ * Returns null if jsonStr is empty or invalid.
+ *
+ * @param jsonStr - JSON string to deserialize
+ * @returns Parsed ExtraConfigs object or null
+ */
+declare function extraConfigsFromJSON(jsonStr: string): ExtraConfigs | null;
+/**
+ * Validates an AppManagerRule object.
+ * Throws an error if validation fails.
+ *
+ * @param rule - The rule to validate
+ */
+declare function validateAppManagerRule(rule: AppManagerRule): void;
+/**
+ * Validates a MobileExtraConfig object.
+ * Throws an error if validation fails.
+ *
+ * @param config - The config to validate
+ */
+declare function validateMobileExtraConfig(config: MobileExtraConfig): void;
+/**
+ * Validates an ExtraConfigs object.
+ * Throws an error if validation fails.
+ *
+ * @param extraConfigs - The extra configs to validate
+ */
+declare function validateExtraConfigs(extraConfigs: ExtraConfigs): void;
+
 /**
  * Mobile module for mobile UI automation.
  * Provides touch, input, and app management operations for mobile environments.
@@ -3314,10 +3686,16 @@ interface ProcessResult extends OperationResult {
 interface ScreenshotResult extends OperationResult {
     data: string;
 }
+interface AdbUrlResult extends OperationResult {
+    data?: string;
+    url?: string;
+}
 interface MobileSession {
     callMcpTool(toolName: string, args: Record<string, any>): Promise<any>;
     sessionId: string;
     getAPIKey(): string;
+    imageId?: string;
+    getLink(protocolType?: string, port?: number, options?: string): Promise<any>;
 }
 declare class Mobile {
     private session;
@@ -3362,6 +3740,68 @@ declare class Mobile {
      * Take a screenshot.
      */
     screenshot(): Promise<ScreenshotResult>;
+    /**
+     * Retrieves the ADB connection URL for the mobile environment.
+     * This method is only supported in mobile environments (mobile_latest image).
+     * It uses the provided ADB public key to establish the connection and returns
+     * the ADB connect URL.
+     *
+     * @param adbkeyPub - ADB public key for authentication
+     * @returns AdbUrlResult containing the ADB connection URL
+     */
+    getAdbUrl(adbkeyPub: string): Promise<AdbUrlResult>;
+    /**
+     * Configure mobile device settings based on MobileExtraConfig.
+     * This method applies various mobile configuration settings including
+     * resolution lock and app access management.
+     *
+     * @param config - The mobile configuration to apply
+     * @returns OperationResult indicating success or failure
+     */
+    configure(config: MobileExtraConfig): Promise<OperationResult>;
+    /**
+     * Set display resolution lock for mobile devices.
+     *
+     * @param enable - Whether to enable resolution lock
+     * @returns OperationResult indicating success or failure
+     */
+    setResolutionLock(enable: boolean): Promise<OperationResult>;
+    /**
+     * Set app whitelist configuration.
+     *
+     * @param packageNames - List of package names to whitelist
+     * @returns OperationResult indicating success or failure
+     */
+    setAppWhitelist(packageNames: string[]): Promise<OperationResult>;
+    /**
+     * Set app blacklist configuration.
+     *
+     * @param packageNames - List of package names to blacklist
+     * @returns OperationResult indicating success or failure
+     */
+    setAppBlacklist(packageNames: string[]): Promise<OperationResult>;
+    /**
+     * Set navigation bar visibility for mobile devices.
+     *
+     * @param hide - True to hide navigation bar, false to show navigation bar
+     * @returns OperationResult indicating success or failure
+     */
+    setNavigationBarVisibility(hide: boolean): Promise<OperationResult>;
+    /**
+     * Set uninstall protection blacklist for mobile devices.
+     *
+     * @param packageNames - List of Android package names to protect from uninstallation
+     * @returns OperationResult indicating success or failure
+     */
+    setUninstallBlacklist(packageNames: string[]): Promise<OperationResult>;
+    /**
+     * Execute a command template for mobile configuration.
+     *
+     * @param command - The command to execute
+     * @param description - Description of the operation
+     * @returns OperationResult indicating success or failure
+     */
+    private executeCommand;
 }
 
 /**
@@ -3767,6 +4207,7 @@ declare class Session {
     private agentBay;
     sessionId: string;
     fileTransferContextId: string | null;
+    recordContextId: string | null;
     isVpc: boolean;
     networkInterfaceIp: string;
     httpPort: string;
@@ -3873,7 +4314,7 @@ declare class Session {
      * @returns OperationResult containing the link as data and request ID
      * @throws Error if the operation fails (matching Python SessionError)
      */
-    getLink(protocolType?: string, port?: number): Promise<OperationResult>;
+    getLink(protocolType?: string, port?: number, options?: string): Promise<OperationResult>;
     /**
      * Asynchronously get a link associated with the current session.
      *
@@ -3882,7 +4323,7 @@ declare class Session {
      * @returns OperationResult containing the link as data and request ID
      * @throws Error if the operation fails (matching Python SessionError)
      */
-    getLinkAsync(protocolType?: string, port?: number): Promise<OperationResult>;
+    getLinkAsync(protocolType?: string, port?: number, options?: string): Promise<OperationResult>;
     /**
      * List MCP tools available for this session.
      *
@@ -4241,6 +4682,8 @@ interface CreateSessionParamsConfig {
     policyId?: string;
     /** Whether to enable browser recording for the session. Defaults to false. */
     enableBrowserReplay?: boolean;
+    /** Extra configuration settings for different session types (e.g., mobile) */
+    extraConfigs?: ExtraConfigs;
 }
 /**
  * CreateSessionParams provides a way to configure the parameters for creating a new session
@@ -4264,6 +4707,8 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
     policyId?: string;
     /** Whether to enable browser recording for the session. Defaults to false. */
     enableBrowserReplay: boolean;
+    /** Extra configuration settings for different session types (e.g., mobile) */
+    extraConfigs?: ExtraConfigs;
     constructor();
     /**
      * WithLabels sets the labels for the session parameters and returns the updated parameters.
@@ -4293,6 +4738,10 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
      * Alias for withEnableBrowserReplay for backward compatibility.
      */
     withEnableRecord(enableRecord: boolean): CreateSessionParams$1;
+    /**
+     * WithExtraConfigs sets the extra configurations for the session parameters and returns the updated parameters.
+     */
+    withExtraConfigs(extraConfigs: ExtraConfigs): CreateSessionParams$1;
     /**
      * GetLabelsJSON returns the labels as a JSON string.
      * Returns an object with success status and result/error message to match Go version behavior.
@@ -4301,6 +4750,14 @@ declare class CreateSessionParams$1 implements CreateSessionParamsConfig {
         result: string;
         error?: string;
     };
+    /**
+     * GetExtraConfigsJSON returns the extra configs as a JSON string.
+     * Returns an object with result and optional error message to match Go version behavior.
+     */
+    getExtraConfigsJSON(): {
+        result: string;
+        error?: string;
+    };
     /**
      * AddContextSync adds a context sync configuration to the session parameters.
      */
@@ -4351,6 +4808,10 @@ interface SessionListResult extends ApiResponse {
     /** Total number of results */
     totalCount?: number;
 }
+/**
+ * Helper function to create ListSessionParams with default values
+ */
+declare function createListSessionParams(labels?: Record<string, string>): ListSessionParams;
 
 /**
  * Parameters for creating a session.
@@ -4363,6 +4824,8 @@ interface CreateSessionParams {
     isVpc?: boolean;
     policyId?: string;
     enableBrowserReplay?: boolean;
+    extraConfigs?: ExtraConfigs;
+    framework?: string;
 }
 /**
  * Main class for interacting with the AgentBay cloud runtime environment.
@@ -4554,19 +5017,74 @@ declare class BrowserError extends AgentBayError {
 }
 
 /**
- * Utility functions for logging in a clean format
+ * Utility functions for structured logging with multiple levels, API tracking,
+ * sensitive data masking, and RequestID management.
+ */
+/**
+ * Log level type
+ */
+type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+/**
+ * Logger configuration options
+ */
+interface LoggerConfig {
+    level?: LogLevel;
+    logFile?: string;
+    maxFileSize?: string;
+    enableConsole?: boolean;
+}
+/**
+ * Mask sensitive information in data structures
+ * @param data Data to mask (dict, str, list, etc.)
+ * @param fields Additional sensitive field names
+ * @returns Masked data (deep copy)
  */
+declare function maskSensitiveData(data: any, fields?: string[]): any;
+/**
+ * Set the log level
+ * @param level The log level to set
+ */
+declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get the current log level
+ * @returns The current log level
+ */
+declare function getLogLevel(): LogLevel;
+/**
+ * Setup logger configuration
+ * @param config Logger configuration options
+ */
+declare function setupLogger(config: LoggerConfig): void;
 /**
  * Log a message without the log prefix and file location
+ * Treated as INFO level - will be filtered if log level is WARN or higher
  * @param message The message to log
  * @param args Optional arguments to log
  */
 declare function log(message: string, ...args: any[]): void;
 /**
- * Log an error message
+ * Log a debug level message
+ * @param message The message to log
+ * @param args Optional arguments to log
+ */
+declare function logDebug(message: string, ...args: any[]): void;
+/**
+ * Log an info level message
+ * @param message The message to log
+ * @param args Optional arguments to log
+ */
+declare function logInfo(message: string, ...args: any[]): void;
+/**
+ * Log a warning level message (outputs to stderr)
+ * @param message The message to log
+ * @param args Optional arguments to log
+ */
+declare function logWarn(message: string, ...args: any[]): void;
+/**
+ * Log an error message with optional error object (outputs to stderr)
  * @param message The error message to log
  * @param error Optional error object
  */
 declare function logError(message: string, error?: any): void;
 
-export { APIError, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, 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, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, 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, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, type InstalledApp$1 as InstalledApp, KeyCode, Lifecycle, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type McpSession, type McpToolResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type ObserveOptions, ObserveResult, Oss, OssError, type Process$1 as Process, type QueryResult, type RecyclePolicy, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SessionError, type SessionInterface, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, type SyncCallback, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UI, type UIElement, UIError, type UploadPolicy, UploadStrategy, type WhiteList, WhiteListValidator, loadConfig, loadDotEnv, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newRecyclePolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy, validateSyncPolicy };
+export { APIError, APP_BLACKLIST_TEMPLATE, APP_WHITELIST_TEMPLATE, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, type ApiResponse, type ApiResponseWithData, type AppManagerRule, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, ClearContextRequest, ClearContextResponse, ClearContextResponseBody, Client, Command, CommandError, 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 ExtractOptions, type ExtractPolicy, ExtractPolicyClass, type FileChangeEvent, FileChangeEventHelper, type FileChangeResult, FileChangeResultHelper, FileError, type FileInfo, FileSystem, 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 InstalledApp$1 as InstalledApp, KeyCode, Lifecycle, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type LogLevel, type LoggerConfig, MOBILE_COMMAND_TEMPLATES, type McpSession, type McpToolResult, type MobileExtraConfig, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type ObserveOptions, ObserveResult, Oss, OssError, type Process$1 as Process, type QueryResult, RESOLUTION_LOCK_TEMPLATE, type RecyclePolicy, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, SHOW_NAVIGATION_BAR_TEMPLATE, Session, SessionError, type SessionInterface, type SessionListResult, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, type SyncCallback, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UI, type UIElement, UIError, UNINSTALL_BLACKLIST_TEMPLATE, UploadMode, type UploadPolicy, UploadStrategy, VERSION, type WhiteList, WhiteListValidator, createListSessionParams, extraConfigsFromJSON, extraConfigsToJSON, extractRequestId, getLogLevel, getMobileCommandTemplate, hasMobileCommandTemplate, loadConfig, loadDotEnv, log, logDebug, logError, logInfo, logWarn, maskSensitiveData, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newRecyclePolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy, replaceTemplatePlaceholders, setLogLevel, setupLogger, validateAppManagerRule, validateExtraConfigs, validateMobileExtraConfig, validateSyncPolicy };