wuying-agentbay-sdk 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,1837 @@
+import * as $dara from '@darabonba/typescript';
+import * as OpenApiDefault from '@alicloud/openapi-core';
+import { $OpenApiUtil } from '@alicloud/openapi-core';
+
+/**
+ * FileInfo represents information about a file or directory
+ */
+interface FileInfo {
+    name: string;
+    path: string;
+    size: number;
+    isDirectory: boolean;
+    modTime: string;
+    mode: string;
+    owner?: string;
+    group?: string;
+}
+/**
+ * DirectoryEntry represents an entry in a directory listing
+ */
+interface DirectoryEntry {
+    name: string;
+    isDirectory: boolean;
+}
+/**
+ * Handles file operations in the AgentBay cloud environment.
+ */
+declare class FileSystem {
+    private session;
+    private client;
+    private baseUrl;
+    /**
+     * Initialize a FileSystem object.
+     *
+     * @param session - The Session instance that this FileSystem belongs to.
+     */
+    constructor(session: Session);
+    /**
+     * Helper method to call MCP tools and handle common response processing
+     *
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @param defaultErrorMsg - Default error message if specific error details are not available
+     * @returns A CallMcpToolResult with the response data
+     * @throws APIError if the call fails
+     */
+    private callMcpTool;
+    /**
+     * Creates a new directory at the specified path.
+     *
+     * @param path - Path to the directory to create.
+     * @returns The extracted text content from the API response
+     * @throws APIError if the operation fails.
+     */
+    createDirectory(path: string): Promise<string>;
+    /**
+     * Edits a file by replacing occurrences of oldText with newText.
+     *
+     * @param path - Path to the file to edit.
+     * @param edits - Array of edit operations, each containing oldText and newText.
+     * @param dryRun - Optional: If true, preview changes without applying them.
+     * @returns The extracted text content from the API response
+     * @throws APIError if the operation fails.
+     */
+    editFile(path: string, edits: Array<{
+        oldText: string;
+        newText: string;
+    }>, dryRun?: boolean): Promise<string>;
+    /**
+     * Gets information about a file or directory.
+     *
+     * @param path - Path to the file or directory to inspect.
+     * @returns The extracted text content from the API response
+     * @throws APIError if the operation fails.
+     */
+    getFileInfo(path: string): Promise<FileInfo>;
+    /**
+     * Lists the contents of a directory.
+     *
+     * @param path - Path to the directory to list.
+     * @returns Array of directory entries with properties like name, isDirectory
+     * @throws APIError if the operation fails.
+     */
+    listDirectory(path: string): Promise<DirectoryEntry[]>;
+    /**
+     * Moves a file or directory from source to destination.
+     *
+     * @param source - Path to the source file or directory.
+     * @param destination - Path to the destination file or directory.
+     * @returns The extracted text content from the API response
+     * @throws APIError if the operation fails.
+     */
+    moveFile(source: string, destination: string): Promise<string>;
+    /**
+     * Reads the content of a file.
+     *
+     * @param path - Path to the file to read.
+     * @param offset - Optional: Line offset to start reading from.
+     * @param length - Optional: Number of lines to read. If 0, reads the entire file.
+     * @returns The extracted text content from the API response
+     * @throws APIError if the operation fails.
+     */
+    readFile(path: string, offset?: number, length?: number): Promise<string>;
+    /**
+     * Reads the content of multiple files.
+     *
+     * @param paths - Array of file paths to read.
+     * @returns The extracted text content from the API response
+     * @throws APIError if the operation fails.
+     */
+    readMultipleFiles(paths: string[]): Promise<Record<string, string>>;
+    /**
+     * Searches for files in a directory that match a pattern.
+     *
+     * @param path - Path to the directory to search in.
+     * @param pattern - Pattern to search for. Supports glob patterns.
+     * @param excludePatterns - Optional: Array of patterns to exclude.
+     * @returns Array of search results with properties like path
+     * @throws APIError if the operation fails.
+     */
+    searchFiles(path: string, pattern: string, excludePatterns?: string[]): Promise<string[]>;
+    /**
+     * Writes content to a file.
+     *
+     * @param path - Path to the file to write.
+     * @param content - Content to write to the file.
+     * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
+     * @returns The extracted text content from the API response
+     * @throws APIError if the operation fails.
+     */
+    writeFile(path: string, content: string, mode?: string): Promise<string>;
+    /**
+     * Reads a large file in chunks to handle size limitations of the underlying API.
+     * It automatically splits the read operation into multiple requests of chunkSize bytes each.
+     *
+     * @param path - Path to the file to read.
+     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
+     * @returns The complete file content as a string
+     * @throws APIError if the operation fails.
+     */
+    readLargeFile(path: string, chunkSize?: number): Promise<string>;
+    /**
+     * Writes a large file in chunks to handle size limitations of the underlying API.
+     * It automatically splits the write operation into multiple requests of chunkSize bytes each.
+     *
+     * @param path - Path to the file to write.
+     * @param content - Content to write to the file.
+     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
+     * @returns True if the operation was successful
+     * @throws APIError if the operation fails.
+     */
+    writeLargeFile(path: string, content: string, chunkSize?: number): Promise<boolean>;
+}
+
+/**
+ * Represents the result of a command execution
+ */
+interface CommandResult {
+    output: string;
+    exitCode?: number;
+    durationMs?: number;
+}
+/**
+ * Represents the result of code execution
+ */
+interface CodeExecutionResult {
+    output: string;
+    durationMs?: number;
+    memoryKb?: number;
+}
+/**
+ * Handles command execution operations in the AgentBay cloud environment.
+ */
+declare class Command {
+    private session;
+    private client;
+    private baseUrl;
+    /**
+     * Initialize a Command object.
+     *
+     * @param session - The Session instance that this Command belongs to.
+     */
+    constructor(session: Session);
+    /**
+     * Helper method to call MCP tools and handle common response processing
+     *
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @param defaultErrorMsg - Default error message if specific error details are not available
+     * @returns A CallMcpToolResult with the response data
+     * @throws APIError if the call fails
+     */
+    private callMcpTool;
+    /**
+     * Helper method to parse JSON string or return a simple object with output
+     */
+    private parseCommandResult;
+    /**
+     * Execute a command in the cloud environment with a specified timeout.
+     *
+     * @param command - The command to execute.
+     * @param timeoutMs - The timeout for the command execution in milliseconds. Default is 1000ms.
+     * @returns A string containing the command output
+     */
+    executeCommand(command: string, timeoutMs?: number): Promise<string>;
+    /**
+     * Helper method to parse JSON string or return a simple object with output
+     */
+    private parseCodeExecutionResult;
+    /**
+     * Execute code in the specified language with a timeout.
+     *
+     * @param code - The code to execute.
+     * @param language - The programming language of the code. Must be either 'python' or 'javascript'.
+     * @param timeoutS - The timeout for the code execution in seconds. Default is 300s.
+     * @returns A string containing the code execution output
+     * @throws APIError if the code execution fails or if an unsupported language is specified.
+     */
+    runCode(code: string, language: string, timeoutS?: number): Promise<string>;
+}
+
+/**
+ * Handles Object Storage Service operations in the AgentBay cloud environment.
+ */
+declare class Oss {
+    private session;
+    private client;
+    private baseUrl;
+    /**
+     * Initialize an Oss object.
+     *
+     * @param session - The Session instance that this Oss belongs to.
+     */
+    constructor(session: Session);
+    /**
+     * Helper method to call MCP tools and handle common response processing
+     *
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @param defaultErrorMsg - Default error message if specific error details are not available
+     * @returns A CallMcpToolResult with the response data
+     * @throws APIError if the call fails
+     */
+    private callMcpTool;
+    /**
+     * Initialize OSS environment variables with the specified credentials.
+     *
+     * @param accessKeyId - The Access Key ID for OSS authentication.
+     * @param accessKeySecret - The Access Key Secret for OSS authentication.
+     * @param securityToken - The security token for OSS authentication.
+     * @param endpoint - The OSS service endpoint. If not specified, the default is used.
+     * @param region - The OSS region. If not specified, the default is used.
+     * @returns The extracted text content from the API response
+     */
+    envInit(accessKeyId: string, accessKeySecret: string, securityToken: string, endpoint?: string, region?: string): Promise<string>;
+    /**
+     * Create an OSS client with the provided credentials.
+     *
+     * @param accessKeyId - The Access Key ID for OSS authentication.
+     * @param accessKeySecret - The Access Key Secret for OSS authentication.
+     * @param endpoint - The OSS service endpoint. If not specified, the default is used.
+     * @param region - The OSS region. If not specified, the default is used.
+     * @returns The extracted text content from the API response
+     */
+    createClient(accessKeyId: string, accessKeySecret: string, endpoint?: string, region?: string): Promise<string>;
+    /**
+     * Upload a local file or directory to OSS.
+     *
+     * @param bucket - OSS bucket name.
+     * @param object - Object key in OSS.
+     * @param path - Local file or directory path to upload.
+     * @returns The extracted text content from the API response
+     */
+    upload(bucket: string, object: string, path: string): Promise<string>;
+    /**
+     * Upload a local file or directory to OSS using a pre-signed URL.
+     *
+     * @param url - Pre-signed URL for anonymous upload.
+     * @param path - Local file or directory path to upload.
+     * @returns The extracted text content from the API response
+     */
+    uploadAnonymous(url: string, path: string): Promise<string>;
+    /**
+     * Download an object from OSS to a local file or directory.
+     *
+     * @param bucket - OSS bucket name.
+     * @param object - Object key in OSS.
+     * @param path - Local file or directory path to save the downloaded content.
+     * @returns The extracted text content from the API response
+     */
+    download(bucket: string, object: string, path: string): Promise<string>;
+    /**
+     * Download an object from OSS using a pre-signed URL.
+     *
+     * @param url - Pre-signed URL for anonymous download.
+     * @param path - Local file or directory path to save the downloaded content.
+     * @returns The extracted text content from the API response
+     */
+    downloadAnonymous(url: string, path: string): Promise<string>;
+}
+
+declare class CreateMcpSessionResponseBodyData extends $dara.Model {
+    appInstanceId?: string;
+    errMsg?: string;
+    resourceId?: string;
+    resourceUrl?: string;
+    sessionId?: string;
+    success?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetContextResponseBodyData extends $dara.Model {
+    createTime?: string;
+    id?: string;
+    lastUsedTime?: string;
+    name?: string;
+    osType?: string;
+    state?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetLabelResponseBodyData extends $dara.Model {
+    labels?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetMcpResourceResponseBodyDataDesktopInfo extends $dara.Model {
+    appId?: string;
+    authCode?: string;
+    connectionProperties?: string;
+    resourceId?: string;
+    resourceType?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetMcpResourceResponseBodyData extends $dara.Model {
+    desktopInfo?: GetMcpResourceResponseBodyDataDesktopInfo;
+    resourceUrl?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListContextsResponseBodyData extends $dara.Model {
+    createTime?: string;
+    id?: string;
+    lastUsedTime?: string;
+    name?: string;
+    osType?: string;
+    state?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListSessionResponseBodyData extends $dara.Model {
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class CallMcpToolRequest extends $dara.Model {
+    args?: string;
+    authorization?: string;
+    externalUserId?: string;
+    imageId?: string;
+    name?: string;
+    server?: string;
+    sessionId?: string;
+    tool?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class CallMcpToolResponseBody extends $dara.Model {
+    code?: string;
+    data?: any;
+    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 CallMcpToolResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: CallMcpToolResponseBody;
+    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;
+    externalUserId?: string;
+    imageId?: string;
+    labels?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class CreateMcpSessionResponseBody extends $dara.Model {
+    code?: string;
+    data?: CreateMcpSessionResponseBodyData;
+    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 CreateMcpSessionResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: CreateMcpSessionResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class DeleteContextRequest 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 DeleteContextResponseBody 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 DeleteContextResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: DeleteContextResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetContextRequest extends $dara.Model {
+    allowCreate?: boolean;
+    authorization?: string;
+    name?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetContextResponseBody extends $dara.Model {
+    code?: string;
+    data?: GetContextResponseBodyData;
+    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 GetContextResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetContextResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetLabelRequest extends $dara.Model {
+    authorization?: string;
+    maxResults?: number;
+    nextToken?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetLabelResponseBody extends $dara.Model {
+    code?: string;
+    data?: GetLabelResponseBodyData;
+    httpStatusCode?: number;
+    maxResults?: number;
+    message?: string;
+    nextToken?: string;
+    requestId?: string;
+    success?: boolean;
+    totalCount?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetLabelResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetLabelResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetLinkRequest 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 GetLinkResponseBody extends $dara.Model {
+    code?: string;
+    data?: 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 GetLinkResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetLinkResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetMcpResourceRequest extends $dara.Model {
+    authorization?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetMcpResourceResponseBody extends $dara.Model {
+    code?: string;
+    data?: GetMcpResourceResponseBodyData;
+    httpStatusCode?: number;
+    message?: string;
+    requestId?: string;
+    success?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class GetMcpResourceResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: GetMcpResourceResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListContextsRequest extends $dara.Model {
+    authorization?: string;
+    maxResults?: number;
+    nextToken?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListContextsResponseBody extends $dara.Model {
+    code?: string;
+    data?: ListContextsResponseBodyData[];
+    httpStatusCode?: number;
+    maxResults?: number;
+    message?: string;
+    nextToken?: string;
+    requestId?: string;
+    success?: boolean;
+    totalCount?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListContextsResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: ListContextsResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListSessionRequest extends $dara.Model {
+    authorization?: string;
+    labels?: string;
+    maxResults?: number;
+    nextToken?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListSessionResponseBody extends $dara.Model {
+    code?: string;
+    data?: ListSessionResponseBodyData[];
+    httpStatusCode?: number;
+    maxResults?: number;
+    message?: string;
+    nextToken?: string;
+    requestId?: string;
+    success?: boolean;
+    totalCount?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ListSessionResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: ListSessionResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ModifyContextRequest extends $dara.Model {
+    authorization?: string;
+    id?: string;
+    name?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ModifyContextResponseBody 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 ModifyContextResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: ModifyContextResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class ReleaseMcpSessionRequest 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 ReleaseMcpSessionResponseBody 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 ReleaseMcpSessionResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: ReleaseMcpSessionResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class SetLabelRequest extends $dara.Model {
+    authorization?: string;
+    labels?: string;
+    sessionId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare class SetLabelResponseBody 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 SetLabelResponse extends $dara.Model {
+    headers?: {
+        [key: string]: string;
+    };
+    statusCode?: number;
+    body?: SetLabelResponseBody;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+
+declare const OpenApi: typeof OpenApiDefault.default;
+
+declare class Client extends OpenApi {
+    constructor(config: $OpenApiUtil.Config);
+    getEndpoint(productId: string, regionId: string, endpointRule: string, network: string, suffix: string, endpointMap: {
+        [key: string]: string;
+    }, endpoint: string): string;
+    /**
+     * 调用mcp工具
+     *
+     * @param request - CallMcpToolRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CallMcpToolResponse
+     */
+    callMcpToolWithOptions(request: CallMcpToolRequest, runtime: $dara.RuntimeOptions): Promise<CallMcpToolResponse>;
+    /**
+     * 调用mcp工具
+     *
+     * @param request - CallMcpToolRequest
+     * @returns CallMcpToolResponse
+     */
+    callMcpTool(request: CallMcpToolRequest): Promise<CallMcpToolResponse>;
+    /**
+     * 创建 mcp session
+     *
+     * @param request - CreateMcpSessionRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CreateMcpSessionResponse
+     */
+    createMcpSessionWithOptions(request: CreateMcpSessionRequest, runtime: $dara.RuntimeOptions): Promise<CreateMcpSessionResponse>;
+    /**
+     * 创建 mcp session
+     *
+     * @param request - CreateMcpSessionRequest
+     * @returns CreateMcpSessionResponse
+     */
+    createMcpSession(request: CreateMcpSessionRequest): Promise<CreateMcpSessionResponse>;
+    /**
+     * 删除持久化上下文
+     *
+     * @param request - DeleteContextRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteContextResponse
+     */
+    deleteContextWithOptions(request: DeleteContextRequest, runtime: $dara.RuntimeOptions): Promise<DeleteContextResponse>;
+    /**
+     * 删除持久化上下文
+     *
+     * @param request - DeleteContextRequest
+     * @returns DeleteContextResponse
+     */
+    deleteContext(request: DeleteContextRequest): Promise<DeleteContextResponse>;
+    /**
+     * 获取上下文
+     *
+     * @param request - GetContextRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetContextResponse
+     */
+    getContextWithOptions(request: GetContextRequest, runtime: $dara.RuntimeOptions): Promise<GetContextResponse>;
+    /**
+     * 获取上下文
+     *
+     * @param request - GetContextRequest
+     * @returns GetContextResponse
+     */
+    getContext(request: GetContextRequest): Promise<GetContextResponse>;
+    /**
+     * 获取标签
+     *
+     * @param request - GetLabelRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetLabelResponse
+     */
+    getLabelWithOptions(request: GetLabelRequest, runtime: $dara.RuntimeOptions): Promise<GetLabelResponse>;
+    /**
+     * 获取标签
+     *
+     * @param request - GetLabelRequest
+     * @returns GetLabelResponse
+     */
+    getLabel(request: GetLabelRequest): Promise<GetLabelResponse>;
+    /**
+     * 获取特定端口的转发链接
+     *
+     * @param request - GetLinkRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetLinkResponse
+     */
+    getLinkWithOptions(request: GetLinkRequest, runtime: $dara.RuntimeOptions): Promise<GetLinkResponse>;
+    /**
+     * 获取特定端口的转发链接
+     *
+     * @param request - GetLinkRequest
+     * @returns GetLinkResponse
+     */
+    getLink(request: GetLinkRequest): Promise<GetLinkResponse>;
+    /**
+     * 获取mcp资源信息
+     *
+     * @param request - GetMcpResourceRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetMcpResourceResponse
+     */
+    getMcpResourceWithOptions(request: GetMcpResourceRequest, runtime: $dara.RuntimeOptions): Promise<GetMcpResourceResponse>;
+    /**
+     * 获取mcp资源信息
+     *
+     * @param request - GetMcpResourceRequest
+     * @returns GetMcpResourceResponse
+     */
+    getMcpResource(request: GetMcpResourceRequest): Promise<GetMcpResourceResponse>;
+    /**
+     * 获取上下文列表
+     *
+     * @param request - ListContextsRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListContextsResponse
+     */
+    listContextsWithOptions(request: ListContextsRequest, runtime: $dara.RuntimeOptions): Promise<ListContextsResponse>;
+    /**
+     * 获取上下文列表
+     *
+     * @param request - ListContextsRequest
+     * @returns ListContextsResponse
+     */
+    listContexts(request: ListContextsRequest): Promise<ListContextsResponse>;
+    /**
+     * 根据Lable查询Session列表
+     *
+     * @param request - ListSessionRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListSessionResponse
+     */
+    listSessionWithOptions(request: ListSessionRequest, runtime: $dara.RuntimeOptions): Promise<ListSessionResponse>;
+    /**
+     * 根据Lable查询Session列表
+     *
+     * @param request - ListSessionRequest
+     * @returns ListSessionResponse
+     */
+    listSession(request: ListSessionRequest): Promise<ListSessionResponse>;
+    /**
+     * 修改上下文
+     *
+     * @param request - ModifyContextRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ModifyContextResponse
+     */
+    modifyContextWithOptions(request: ModifyContextRequest, runtime: $dara.RuntimeOptions): Promise<ModifyContextResponse>;
+    /**
+     * 修改上下文
+     *
+     * @param request - ModifyContextRequest
+     * @returns ModifyContextResponse
+     */
+    modifyContext(request: ModifyContextRequest): Promise<ModifyContextResponse>;
+    /**
+     * 释放 mcp session
+     *
+     * @param request - ReleaseMcpSessionRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ReleaseMcpSessionResponse
+     */
+    releaseMcpSessionWithOptions(request: ReleaseMcpSessionRequest, runtime: $dara.RuntimeOptions): Promise<ReleaseMcpSessionResponse>;
+    /**
+     * 释放 mcp session
+     *
+     * @param request - ReleaseMcpSessionRequest
+     * @returns ReleaseMcpSessionResponse
+     */
+    releaseMcpSession(request: ReleaseMcpSessionRequest): Promise<ReleaseMcpSessionResponse>;
+    /**
+     * 设置标签
+     *
+     * @param request - SetLabelRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns SetLabelResponse
+     */
+    setLabelWithOptions(request: SetLabelRequest, runtime: $dara.RuntimeOptions): Promise<SetLabelResponse>;
+    /**
+     * 设置标签
+     *
+     * @param request - SetLabelRequest
+     * @returns SetLabelResponse
+     */
+    setLabel(request: SetLabelRequest): Promise<SetLabelResponse>;
+}
+
+/**
+ * Represents an installed application.
+ */
+interface InstalledApp {
+    name: string;
+    start_cmd: string;
+    stop_cmd?: string;
+    work_directory?: string;
+}
+/**
+ * Represents a running process.
+ */
+interface Process {
+    pname: string;
+    pid: number;
+    cmdline?: string;
+    path?: string;
+}
+/**
+ * Handles application management operations in the AgentBay cloud environment.
+ */
+declare class Application {
+    private session;
+    /**
+     * Creates a new Application instance.
+     * @param session The session object that provides access to the AgentBay API.
+     */
+    constructor(session: {
+        getAPIKey(): string;
+        getClient(): Client;
+        getSessionId(): string;
+    });
+    /**
+     * Helper method to call MCP tools and handle common response processing
+     *
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @param defaultErrorMsg - Default error message if specific error details are not available
+     * @returns A CallMcpToolResult with the response data
+     * @throws APIError if the call fails
+     */
+    private callMcpTool;
+    /**
+     * Helper method to parse JSON string into objects
+     */
+    private parseJSON;
+    /**
+     * Retrieves a list of installed applications.
+     * @param startMenu Whether to include applications from the start menu. Defaults to true.
+     * @param desktop Whether to include applications from the desktop. Defaults to true.
+     * @param ignoreSystemApps Whether to ignore system applications. Defaults to true.
+     * @returns Array of InstalledApp objects
+     * @throws Error if the operation fails.
+     */
+    getInstalledApps(startMenu?: boolean, desktop?: boolean, ignoreSystemApps?: boolean): Promise<InstalledApp[]>;
+    /**
+     * Starts an application with the given command and optional working directory.
+     * @param startCmd The command to start the application.
+     * @param workDirectory The working directory for the application. Defaults to an empty string.
+     * @returns Array of Process objects representing the started processes
+     * @throws Error if the operation fails.
+     */
+    startApp(startCmd: string, workDirectory?: string): Promise<Process[]>;
+    /**
+     * Stops an application by process name.
+     * @param pname The name of the process to stop.
+     * @throws Error if the operation fails.
+     */
+    stopAppByPName(pname: string): Promise<void>;
+    /**
+     * Stops an application by process ID.
+     * @param pid The ID of the process to stop.
+     * @throws Error if the operation fails.
+     */
+    stopAppByPID(pid: number): Promise<void>;
+    /**
+     * Stops an application by stop command.
+     * @param stopCmd The command to stop the application.
+     * @throws Error if the operation fails.
+     */
+    stopAppByCmd(stopCmd: string): Promise<void>;
+    /**
+     * Lists all currently visible applications.
+     * @returns Array of Process objects representing the visible processes
+     * @throws Error if the operation fails.
+     */
+    listVisibleApps(): Promise<Process[]>;
+}
+
+/**
+ * Represents a window in the system.
+ */
+interface Window {
+    window_id: number;
+    title: string;
+    absolute_upper_left_x?: number;
+    absolute_upper_left_y?: number;
+    width?: number;
+    height?: number;
+    pid?: number;
+    pname?: string;
+    child_windows?: Window[];
+}
+/**
+ * Handles window management operations in the AgentBay cloud environment.
+ */
+declare class WindowManager {
+    private session;
+    /**
+     * Creates a new WindowManager instance.
+     * @param session The session object that provides access to the AgentBay API.
+     */
+    constructor(session: {
+        getAPIKey(): string;
+        getClient(): any;
+        getSessionId(): string;
+    });
+    /**
+     * Helper method to call MCP tools and handle common response processing
+     *
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @param defaultErrorMsg - Default error message if specific error details are not available
+     * @returns A CallMcpToolResult with the response data
+     * @throws APIError if the call fails
+     */
+    private callMcpTool;
+    /**
+     * Helper method to parse JSON string into Window objects
+     * @param jsonStr - JSON string to parse
+     * @returns Array of Window objects or single Window object
+     */
+    private parseWindowsFromJSON;
+    /**
+     * Lists all root windows in the system.
+     * @returns Array of Window objects
+     * @throws Error if the operation fails.
+     */
+    listRootWindows(): Promise<Window[]>;
+    /**
+     * Gets the currently active window.
+     * @returns Window object or null if no active window
+     * @throws Error if the operation fails.
+     */
+    getActiveWindow(): Promise<Window | null>;
+    /**
+     * Activates a window by ID.
+     * @param windowId The ID of the window to activate.
+     * @throws Error if the operation fails.
+     */
+    activateWindow(windowId: number): Promise<void>;
+    /**
+     * Maximizes a window by ID.
+     * @param windowId The ID of the window to maximize.
+     * @throws Error if the operation fails.
+     */
+    maximizeWindow(windowId: number): Promise<void>;
+    /**
+     * Minimizes a window by ID.
+     * @param windowId The ID of the window to minimize.
+     * @throws Error if the operation fails.
+     */
+    minimizeWindow(windowId: number): Promise<void>;
+    /**
+     * Restores a window by ID.
+     * @param windowId The ID of the window to restore.
+     * @throws Error if the operation fails.
+     */
+    restoreWindow(windowId: number): Promise<void>;
+    /**
+     * Closes a window by ID.
+     * @param windowId The ID of the window to close.
+     * @throws Error if the operation fails.
+     */
+    closeWindow(windowId: number): Promise<void>;
+    /**
+     * Sets a window to fullscreen by ID.
+     * @param windowId The ID of the window to set to fullscreen.
+     * @throws Error if the operation fails.
+     */
+    fullscreenWindow(windowId: number): Promise<void>;
+    /**
+     * Resizes a window by ID.
+     * @param windowId The ID of the window to resize.
+     * @param width The new width of the window.
+     * @param height The new height of the window.
+     * @throws Error if the operation fails.
+     */
+    resizeWindow(windowId: number, width: number, height: number): Promise<void>;
+    /**
+     * Enables or disables focus mode.
+     * @param on Whether to enable focus mode.
+     * @throws Error if the operation fails.
+     */
+    focusMode(on: boolean): Promise<void>;
+}
+
+/**
+ * Interface representing a UI element in the UI hierarchy
+ */
+interface UIElement {
+    bounds: string;
+    className: string;
+    text: string;
+    type: string;
+    resourceId: string;
+    index: number;
+    isParent: boolean;
+    children?: UIElement[];
+}
+/**
+ * KeyCode constants for mobile device input
+ */
+declare const KeyCode: {
+    HOME: number;
+    BACK: number;
+    VOLUME_UP: number;
+    VOLUME_DOWN: number;
+    POWER: number;
+    MENU: number;
+};
+/**
+ * UI handles UI operations in the AgentBay cloud environment.
+ */
+declare class UI {
+    private session;
+    /**
+     * Initialize a UI object.
+     *
+     * @param session - The Session instance that this UI belongs to.
+     */
+    constructor(session: Session);
+    /**
+     * Helper method to call MCP tools and handle common response processing
+     *
+     * @param toolName - Name of the MCP tool to call
+     * @param args - Arguments to pass to the tool
+     * @param defaultErrorMsg - Default error message if specific error details are not available
+     * @returns A CallMcpToolResult with the response data
+     * @throws APIError if the call fails
+     */
+    private callMcpTool;
+    /**
+     * Retrieves all clickable UI elements within the specified timeout.
+     *
+     * @param timeoutMs - The timeout in milliseconds. Default is 2000ms.
+     * @returns An array of UIElement objects
+     * @throws Error if the operation fails.
+     */
+    getClickableUIElements(timeoutMs?: number): Promise<UIElement[]>;
+    /**
+     * Retrieves all UI elements within the specified timeout.
+     *
+     * @param timeoutMs - The timeout in milliseconds. Default is 2000ms.
+     * @returns An array of UIElement objects
+     * @throws Error if the operation fails.
+     */
+    getAllUIElements(timeoutMs?: number): Promise<UIElement[]>;
+    /**
+     * Sends a key press event.
+     *
+     * @param key - The key code to send.
+     * @returns The extracted text content from the API response
+     * @throws Error if the operation fails.
+     */
+    sendKey(key: number): Promise<string>;
+    /**
+     * Inputs text into the active field.
+     *
+     * @param text - The text to input.
+     * @returns The extracted text content from the API response
+     * @throws Error if the operation fails.
+     */
+    inputText(text: string): Promise<string>;
+    /**
+     * Performs a swipe gesture on the screen.
+     *
+     * @param startX - The starting X coordinate.
+     * @param startY - The starting Y coordinate.
+     * @param endX - The ending X coordinate.
+     * @param endY - The ending Y coordinate.
+     * @param durationMs - The duration of the swipe in milliseconds. Default is 300ms.
+     * @returns The extracted text content from the API response
+     * @throws Error if the operation fails.
+     */
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<string>;
+    /**
+     * Performs a click at the specified coordinates.
+     *
+     * @param x - The X coordinate.
+     * @param y - The Y coordinate.
+     * @param button - The mouse button to click. Default is 'left'.
+     * @returns The extracted text content from the API response
+     * @throws Error if the operation fails.
+     */
+    click(x: number, y: number, button?: string): Promise<string>;
+    /**
+     * Takes a screenshot of the current screen.
+     *
+     * @returns The extracted text content from the API response (usually a base64-encoded image)
+     * @throws Error if the operation fails.
+     */
+    screenshot(): Promise<string>;
+}
+
+/**
+ * Contains information about a session.
+ */
+interface SessionInfo {
+    sessionId: string;
+    resourceUrl: string;
+    appId?: string;
+    authCode?: string;
+    connectionProperties?: string;
+    resourceId?: string;
+    resourceType?: string;
+}
+/**
+ * Represents a session in the AgentBay cloud environment.
+ */
+declare class Session {
+    private agentBay;
+    client: Client;
+    sessionId: string;
+    resourceUrl: string;
+    filesystem: FileSystem;
+    command: Command;
+    oss: Oss;
+    Application: Application;
+    window: WindowManager;
+    ui: UI;
+    /**
+     * Initialize a Session object.
+     *
+     * @param agentBay - The AgentBay instance that created this session.
+     * @param sessionId - The ID of this session.
+     */
+    constructor(agentBay: AgentBay, sessionId: string);
+    /**
+     * Get information about this session.
+     *
+     * @returns Session information.
+     */
+    /**
+     * Delete this session.
+     *
+     * @returns True if the session was successfully deleted.
+     */
+    delete(): Promise<boolean>;
+    /**
+     * Sets the labels for this session.
+     *
+     * @param labels - The labels to set for the session.
+     * @throws APIError if the operation fails.
+     */
+    setLabels(labels: Record<string, string>): Promise<void>;
+    /**
+     * Gets the labels for this session.
+     *
+     * @returns The labels for the session.
+     * @throws APIError if the operation fails.
+     */
+    getLabels(): Promise<Record<string, string>>;
+    /**
+     * Get the API key.
+     *
+     * @returns The API key.
+     */
+    getAPIKey(): string;
+    /**
+     * Get the client.
+     *
+     * @returns The client.
+     */
+    getClient(): Client;
+    /**
+     * Get the session ID.
+     *
+     * @returns The session ID.
+     */
+    getSessionId(): string;
+    /**
+     * Gets information about this session.
+     *
+     * @returns Information about the session.
+     * @throws APIError if the operation fails.
+     */
+    info(): Promise<SessionInfo>;
+    /**
+     * Gets the link for this session.
+     *
+     * @returns The link for the session.
+     * @throws APIError if the operation fails.
+     */
+    getLink(): Promise<string>;
+}
+
+/**
+ * Represents a persistent storage context in the AgentBay cloud environment.
+ */
+declare class Context {
+    /**
+     * The unique identifier of the context.
+     */
+    id: string;
+    /**
+     * The name of the context.
+     */
+    name: string;
+    /**
+     * The current state of the context (e.g., "available", "in-use").
+     */
+    state: string;
+    /**
+     * Date and time when the Context was created.
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the Context was last used.
+     */
+    lastUsedAt?: string;
+    /**
+     * The operating system type this context is bound to.
+     */
+    osType?: string;
+    /**
+     * Initialize a Context object.
+     *
+     * @param id - The unique identifier of the context.
+     * @param name - The name of the context.
+     * @param state - The current state of the context.
+     * @param createdAt - Date and time when the Context was created.
+     * @param lastUsedAt - Date and time when the Context was last used.
+     * @param osType - The operating system type this context is bound to.
+     */
+    constructor(id: string, name: string, state?: string, createdAt?: string, lastUsedAt?: string, osType?: string);
+}
+/**
+ * Provides methods to manage persistent contexts in the AgentBay cloud environment.
+ */
+declare class ContextService {
+    private agentBay;
+    /**
+     * Initialize the ContextService.
+     *
+     * @param agentBay - The AgentBay instance.
+     */
+    constructor(agentBay: AgentBay);
+    /**
+     * Lists all available contexts.
+     *
+     * @returns A list of Context objects.
+     */
+    list(): Promise<Context[]>;
+    /**
+     * Gets a context by name. Optionally creates it if it doesn't exist.
+     *
+     * @param name - The name of the context to get.
+     * @param create - Whether to create the context if it doesn't exist.
+     * @returns The Context object if found or created, null if not found and create is false.
+     */
+    get(name: string, create?: boolean): Promise<Context | null>;
+    /**
+     * Creates a new context with the given name.
+     *
+     * @param name - The name for the new context.
+     * @returns The created Context object.
+     */
+    create(name: string): Promise<Context>;
+    /**
+     * Updates the specified context.
+     *
+     * @param context - The Context object to update.
+     * @returns The updated Context object.
+     */
+    update(context: Context): Promise<Context>;
+    /**
+     * Deletes the specified context.
+     *
+     * @param context - The Context object to delete.
+     */
+    delete(context: Context): Promise<void>;
+}
+
+/**
+ * Main class for interacting with the AgentBay cloud runtime environment.
+ */
+declare class AgentBay {
+    private apiKey;
+    private client;
+    private regionId;
+    private endpoint;
+    private sessions;
+    /**
+     * Context service for managing persistent contexts.
+     */
+    context: ContextService;
+    /**
+     * Initialize the AgentBay client.
+     *
+     * @param options - Configuration options
+     * @param options.apiKey - API key for authentication. If not provided, will look for AGENTBAY_API_KEY environment variable.
+     */
+    constructor(options?: {
+        apiKey?: string;
+    });
+    /**
+     * Create a new session in the AgentBay cloud environment.
+     *
+     * @param options - Optional parameters for creating the session
+     * @param options.contextId - ID of the context to bind to the session
+     * @param options.labels - Custom labels for the session
+     * @returns A new Session object.
+     */
+    create(options?: {
+        contextId?: string;
+        labels?: Record<string, string>;
+        imageId?: string;
+    }): Promise<Session>;
+    /**
+     * List all available sessions.
+     *
+     * @returns A list of session objects.
+     */
+    list(): Session[];
+    /**
+     * List sessions filtered by the provided labels.
+     * It returns sessions that match all the specified labels.
+     *
+     * @param labels - The labels to filter by.
+     * @returns A list of session objects that match the labels.
+     */
+    listByLabels(labels: Record<string, string>): Promise<Session[]>;
+    /**
+     * Delete a session by ID.
+     *
+     * @param sessionId - The ID of the session to delete.
+     * @returns True if the session was successfully deleted.
+     */
+    delete(session: Session): Promise<boolean>;
+    /**
+     *
+     * @param sessionId - The ID of the session to remove.
+     */
+    removeSession(sessionId: string): void;
+    getClient(): Client;
+    getAPIKey(): string;
+}
+
+/**
+ * Base exception for all AgentBay errors.
+ */
+declare class AgentBayError extends Error {
+    constructor(message: string);
+}
+/**
+ * Raised when there is an authentication error.
+ */
+declare class AuthenticationError extends AgentBayError {
+    constructor(message: string);
+}
+/**
+ * Raised when there is an error with the API.
+ */
+declare class APIError extends AgentBayError {
+    constructor(message: string);
+}
+/**
+ * Raised when there is an error with file operations.
+ */
+declare class FileError extends AgentBayError {
+    constructor(message: string);
+}
+/**
+ * Raised when there is an error with command execution.
+ */
+declare class CommandError extends AgentBayError {
+    constructor(message: string);
+}
+
+export { APIError, AgentBay, AgentBayError, Application, AuthenticationError, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, type CodeExecutionResult, Command, CommandError, type CommandResult, Context, ContextService, CreateMcpSessionRequest, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DirectoryEntry, FileError, type FileInfo, FileSystem, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, type InstalledApp, KeyCode, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, Oss, type Process, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, UI, type UIElement };