@agentrun/sdk 0.0.3 → 0.0.4

package/dist/sandbox/index.d.cts

@@ -0,0 +1,1598 @@
+import { C as Config } from '../config-07gMelJP.cjs';
+import { C as CodeLanguage, p as TemplateType, N as NASConfig, O as OSSMountConfig, P as PolarFsConfig, a as SandboxData, c as SandboxState, S as SandboxCreateInput, b as SandboxListInput, g as TemplateData, e as TemplateCreateInput, q as TemplateUpdateInput, h as TemplateListInput } from '../model-BV7A6Trb.cjs';
+export { E as ExecuteCodeResult, F as FileInfo, r as NASMountConfig, s as OSSMountPoint, t as PolarFsMountConfig, T as TemplateArmsConfiguration, d as TemplateContainerConfiguration, f as TemplateCredentialConfiguration, i as TemplateLogConfiguration, j as TemplateMcpOptions, k as TemplateMcpState, l as TemplateNetworkConfiguration, m as TemplateNetworkMode, n as TemplateOSSPermission, o as TemplateOssConfiguration } from '../model-BV7A6Trb.cjs';
+import { R as ResourceBase } from '../resource-CQovFUeh.cjs';
+import { S as Status } from '../model--I90nCqy.cjs';
+
+/**
+ * Sandbox Data API Base Class
+ *
+ * This module provides an HTTP client for interacting with the AgentRun Sandbox Data API.
+ * 此模块提供用于与 AgentRun Sandbox Data API 交互的 HTTP 客户端。
+ */
+
+/**
+ * Resource type enum
+ */
+declare enum ResourceType {
+    Runtime = "runtime",
+    LiteLLM = "litellm",
+    Tool = "tool",
+    Template = "template",
+    Sandbox = "sandbox"
+}
+/**
+ * Sandbox Data API Client
+ *
+ * Provides methods for making HTTP requests to sandbox data API endpoints.
+ */
+declare class SandboxDataAPI {
+    protected resourceName: string;
+    protected resourceType: ResourceType;
+    protected namespace: string;
+    protected config: Config;
+    protected accessToken?: string;
+    protected accessTokenMap: Map<string, string>;
+    constructor(params: {
+        sandboxId?: string;
+        templateName?: string;
+        config?: Config;
+        namespace?: string;
+    });
+    /**
+     * Refresh access token for the resource
+     */
+    protected refreshAccessToken(params: {
+        sandboxId?: string;
+        templateName?: string;
+        config?: Config;
+    }): Promise<void>;
+    /**
+     * Get base URL for data API
+     */
+    protected getBaseUrl(): string;
+    /**
+     * Construct full URL with path and query parameters
+     */
+    protected withPath(path: string, query?: Record<string, any>): string;
+    /**
+     * Authentication hook - gets access token for the resource
+     */
+    protected auth(params: {
+        config?: Config;
+    }): Promise<void>;
+    /**
+     * Mask token for logging
+     */
+    protected maskToken(token: string): string;
+    /**
+     * Prepare request headers
+     */
+    protected prepareHeaders(params: {
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Record<string, string>;
+    /**
+     * Make an HTTP request
+     */
+    protected makeRequest<T = any>(params: {
+        method: string;
+        url: string;
+        data?: any;
+        headers?: Record<string, string>;
+        query?: Record<string, any>;
+        config?: Config;
+    }): Promise<T>;
+    /**
+     * GET request
+     */
+    get<T = any>(params: {
+        path: string;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<T>;
+    /**
+     * POST request
+     */
+    post<T = any>(params: {
+        path: string;
+        data?: any;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T = any>(params: {
+        path: string;
+        data?: any;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T = any>(params: {
+        path: string;
+        data?: any;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T = any>(params: {
+        path: string;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<T>;
+    /**
+     * Check sandbox health
+     */
+    checkHealth: (params: {
+        sandboxId: string;
+        config?: Config;
+    }) => Promise<{
+        status: string;
+        [key: string]: any;
+    }>;
+    /**
+     * Create sandbox from template
+     * 从模板创建沙箱 / Create Sandbox from Template
+     */
+    createSandbox: (params: {
+        templateName: string;
+        sandboxIdleTimeoutSeconds?: number;
+        nasConfig?: Record<string, any>;
+        ossMountConfig?: Record<string, any>;
+        polarFsConfig?: Record<string, any>;
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Delete sandbox
+     */
+    deleteSandbox: (params: {
+        sandboxId: string;
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Stop sandbox
+     */
+    stopSandbox: (params: {
+        sandboxId: string;
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Get sandbox info
+     */
+    getSandbox: (params: {
+        sandboxId: string;
+        config?: Config;
+    }) => Promise<any>;
+}
+
+/**
+ * Code Interpreter Sandbox Data API
+ *
+ * This module provides data API methods for Code Interpreter sandboxes.
+ * 此模块提供代码解释器沙箱的数据 API 方法。
+ */
+
+/**
+ * Code Interpreter Data API
+ *
+ * Provides methods for interacting with Code Interpreter sandbox data endpoints.
+ */
+declare class CodeInterpreterDataAPI extends SandboxDataAPI {
+    constructor(params: {
+        sandboxId: string;
+        config?: Config;
+    });
+    /**
+     * List directory contents
+     */
+    listDirectory(params?: {
+        path?: string;
+        depth?: number;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Get file/directory stats
+     */
+    stat(params: {
+        path: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Create directory
+     */
+    mkdir(params: {
+        path: string;
+        parents?: boolean;
+        mode?: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Move file or directory
+     */
+    moveFile(params: {
+        source: string;
+        destination: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Remove file or directory
+     */
+    removeFile(params: {
+        path: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * List code execution contexts
+     */
+    listContexts(params?: {
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Create a new code execution context
+     */
+    createContext(params?: {
+        language?: CodeLanguage;
+        cwd?: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Get context details
+     */
+    getContext(params: {
+        contextId: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Execute code in a context
+     */
+    executeCode(params: {
+        code: string;
+        contextId?: string;
+        language?: CodeLanguage;
+        timeout?: number;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Delete a context
+     */
+    deleteContext(params: {
+        contextId: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Read file contents
+     */
+    readFile(params: {
+        path: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Write file contents
+     */
+    writeFile(params: {
+        path: string;
+        content: string;
+        mode?: string;
+        encoding?: string;
+        createDir?: boolean;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Upload file to sandbox
+     */
+    uploadFile(params: {
+        localFilePath: string;
+        targetFilePath: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Download file from sandbox
+     */
+    downloadFile(params: {
+        path: string;
+        savePath: string;
+        config?: Config;
+    }): Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+    /**
+     * Execute shell command
+     */
+    cmd(params: {
+        command: string;
+        cwd: string;
+        timeout?: number;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * List running processes
+     */
+    listProcesses(params?: {
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Get process details
+     */
+    getProcess(params: {
+        pid: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Kill a process
+     */
+    killProcess(params: {
+        pid: string;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Helper method to upload file using multipart/form-data
+     */
+    protected postFile(params: {
+        path: string;
+        localFilePath: string;
+        targetFilePath: string;
+        formData?: Record<string, any>;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<any>;
+    /**
+     * Helper method to download file
+     */
+    protected getFile(params: {
+        path: string;
+        savePath: string;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+}
+
+/**
+ * AIO (All-In-One) Sandbox Data API
+ *
+ * This module provides a combined data API that includes both Code Interpreter
+ * and Browser sandbox functionalities.
+ * 此模块提供包含代码解释器和浏览器沙箱功能的组合数据 API。
+ */
+
+/**
+ * AIO Data API
+ *
+ * Combines both Code Interpreter and Browser data API methods.
+ */
+declare class AioDataAPI extends CodeInterpreterDataAPI {
+    private browserAPI;
+    constructor(params: {
+        sandboxId: string;
+        config?: Config;
+    });
+    /**
+     * Get CDP WebSocket URL for browser automation
+     */
+    getCdpUrl(record?: boolean): string;
+    /**
+     * Get VNC WebSocket URL for live view
+     */
+    getVncUrl(record?: boolean): string;
+    /**
+     * List browser recordings
+     */
+    listRecordings: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Delete a recording
+     */
+    deleteRecording: (params: {
+        filename: string;
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Download a recording
+     */
+    downloadRecording: (params: {
+        filename: string;
+        savePath: string;
+    }) => Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+}
+
+/**
+ * Browser Sandbox Data API
+ *
+ * This module provides data API methods for Browser sandboxes.
+ * 此模块提供浏览器沙箱的数据 API 方法。
+ */
+
+/**
+ * Browser Data API
+ *
+ * Provides methods for interacting with Browser sandbox data endpoints.
+ */
+declare class BrowserDataAPI extends SandboxDataAPI {
+    protected sandboxId: string;
+    constructor(params: {
+        sandboxId: string;
+        config?: Config;
+    });
+    /**
+     * Generate the WebSocket URL for Chrome DevTools Protocol (CDP) connection
+     */
+    getCdpUrl(record?: boolean): string;
+    /**
+     * Generate the WebSocket URL for VNC (Virtual Network Computing) live view connection
+     */
+    getVncUrl(record?: boolean): string;
+    /**
+     * List all recordings
+     */
+    listRecordings: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Delete a recording
+     */
+    deleteRecording: (params: {
+        filename: string;
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Download a recording video file
+     */
+    downloadRecording: (params: {
+        filename: string;
+        savePath: string;
+    }) => Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+    /**
+     * Helper method to download video file
+     */
+    protected getVideo(params: {
+        path: string;
+        savePath: string;
+        query?: Record<string, any>;
+        headers?: Record<string, string>;
+        config?: Config;
+    }): Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+}
+
+/**
+ * Browser Sandbox
+ *
+ * High-level API for browser sandboxes with CDP/VNC connectivity
+ * and recording management.
+ */
+
+/**
+ * Browser Sandbox
+ *
+ * High-level API for interacting with browser sandboxes.
+ */
+declare class BrowserSandbox extends Sandbox {
+    static templateType: TemplateType;
+    /**
+     * Create a Browser Sandbox from template
+     * 从模板创建浏览器沙箱 / Create Browser Sandbox from Template
+     */
+    static createFromTemplate(templateName: string, options?: {
+        sandboxIdleTimeoutSeconds?: number;
+        nasConfig?: NASConfig;
+        ossMountConfig?: OSSMountConfig;
+        polarFsConfig?: PolarFsConfig;
+    }, config?: Config): Promise<BrowserSandbox>;
+    constructor(sandbox: Sandbox, config?: Config);
+    private _dataApi?;
+    /**
+     * Get data API client
+     */
+    get dataApi(): BrowserDataAPI;
+    /**
+     * Check sandbox health
+     */
+    checkHealth: (params?: {
+        config?: Config;
+    }) => Promise<{
+        status: string;
+        [key: string]: any;
+    }>;
+    /**
+     * Get CDP WebSocket URL for browser automation
+     */
+    getCdpUrl(record?: boolean): string;
+    /**
+     * Get VNC WebSocket URL for live view
+     */
+    getVncUrl(record?: boolean): string;
+    /**
+     * List all recordings
+     */
+    listRecordings: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Download a recording video file
+     */
+    downloadRecording: (params: {
+        filename: string;
+        savePath: string;
+    }) => Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+    /**
+     * Delete a recording
+     */
+    deleteRecording: (params: {
+        filename: string;
+        config?: Config;
+    }) => Promise<any>;
+}
+
+/**
+ * Code Interpreter Sandbox
+ *
+ * High-level API for code interpreter sandboxes with file, filesystem,
+ * context, and process management operations.
+ */
+
+/**
+ * File upload/download operations
+ */
+declare class FileOperations {
+    private sandbox;
+    constructor(sandbox: CodeInterpreterSandbox);
+    /**
+     * Read a file from the code interpreter
+     */
+    read: (params: {
+        path: string;
+    }) => Promise<any>;
+    /**
+     * Write a file to the code interpreter
+     */
+    write: (params: {
+        path: string;
+        content: string;
+        mode?: string;
+        encoding?: string;
+        createDir?: boolean;
+    }) => Promise<any>;
+}
+/**
+ * File system operations (list, move, remove, stat, mkdir)
+ */
+declare class FileSystemOperations {
+    private sandbox;
+    constructor(sandbox: CodeInterpreterSandbox);
+    /**
+     * List directory contents
+     */
+    list: (params?: {
+        path?: string;
+        depth?: number;
+    }) => Promise<any>;
+    /**
+     * Move a file or directory
+     */
+    move: (params: {
+        source: string;
+        destination: string;
+    }) => Promise<any>;
+    /**
+     * Remove a file or directory
+     */
+    remove: (params: {
+        path: string;
+    }) => Promise<any>;
+    /**
+     * Get file or directory statistics
+     */
+    stat: (params: {
+        path: string;
+    }) => Promise<any>;
+    /**
+     * Create a directory
+     */
+    mkdir: (params: {
+        path: string;
+        parents?: boolean;
+        mode?: string;
+    }) => Promise<any>;
+    /**
+     * Upload a file to the code interpreter
+     */
+    upload: (params: {
+        localFilePath: string;
+        targetFilePath: string;
+    }) => Promise<any>;
+    /**
+     * Download a file from the code interpreter
+     */
+    download: (params: {
+        path: string;
+        savePath: string;
+    }) => Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+}
+/**
+ * Process management operations
+ */
+declare class ProcessOperations {
+    private sandbox;
+    constructor(sandbox: CodeInterpreterSandbox);
+    /**
+     * Execute a command in the code interpreter
+     */
+    cmd: (params: {
+        command: string;
+        cwd: string;
+        timeout?: number;
+    }) => Promise<any>;
+    /**
+     * List all processes
+     */
+    list: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Get a specific process by PID
+     */
+    get: (params: {
+        pid: string;
+    }) => Promise<any>;
+    /**
+     * Kill a specific process by PID
+     */
+    kill: (params: {
+        pid: string;
+    }) => Promise<any>;
+}
+/**
+ * Context management operations
+ */
+declare class ContextOperations {
+    private sandbox;
+    private _contextId?;
+    private _language?;
+    private _cwd?;
+    constructor(sandbox: CodeInterpreterSandbox);
+    /**
+     * Get the current context ID
+     */
+    get contextId(): string | undefined;
+    /**
+     * List all contexts
+     */
+    list: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Create a new context and save its ID
+     */
+    create: (params?: {
+        language?: CodeLanguage;
+        cwd?: string;
+    }) => Promise<ContextOperations>;
+    /**
+     * Get a specific context by ID
+     */
+    get: (params?: {
+        contextId?: string;
+    }) => Promise<ContextOperations>;
+    /**
+     * Execute code in a context
+     */
+    execute: (params: {
+        code: string;
+        language?: CodeLanguage;
+        contextId?: string;
+        timeout?: number;
+    }) => Promise<any>;
+    /**
+     * Delete a context
+     */
+    delete: (params?: {
+        contextId?: string;
+    }) => Promise<any>;
+}
+/**
+ * Code Interpreter Sandbox
+ *
+ * High-level API for interacting with code interpreter sandboxes.
+ */
+declare class CodeInterpreterSandbox extends Sandbox {
+    static templateType: TemplateType;
+    /**
+     * Create a Code Interpreter Sandbox from template
+     * 从模板创建代码解释器沙箱 / Create Code Interpreter Sandbox from Template
+     */
+    static createFromTemplate(templateName: string, options?: {
+        sandboxIdleTimeoutSeconds?: number;
+        nasConfig?: NASConfig;
+        ossMountConfig?: OSSMountConfig;
+        polarFsConfig?: PolarFsConfig;
+    }, config?: Config): Promise<CodeInterpreterSandbox>;
+    constructor(sandbox: Sandbox, config?: Config);
+    private _dataApi?;
+    private _file?;
+    private _fileSystem?;
+    private _context?;
+    private _process?;
+    /**
+     * Get data API client
+     */
+    get dataApi(): CodeInterpreterDataAPI;
+    /**
+     * Access file upload/download operations
+     */
+    get file(): FileOperations;
+    /**
+     * Access file system operations
+     */
+    get fileSystem(): FileSystemOperations;
+    /**
+     * Access context management operations
+     */
+    get context(): ContextOperations;
+    /**
+     * Access process management operations
+     */
+    get process(): ProcessOperations;
+    /**
+     * Check sandbox health
+     */
+    checkHealth: (params?: {
+        config?: Config;
+    }) => Promise<{
+        status: string;
+        [key: string]: any;
+    }>;
+    /**
+     * Execute code (convenience method delegating to context.execute)
+     */
+    execute: (params: {
+        code: string;
+        language?: CodeLanguage;
+        contextId?: string;
+        timeout?: number;
+    }) => Promise<any>;
+}
+
+/**
+ * Custom Sandbox
+ *
+ * 自定义镜像沙箱 / Custom Image Sandbox
+ */
+
+/**
+ * Custom Sandbox
+ *
+ * 自定义镜像沙箱类 / Custom Image Sandbox Class
+ */
+declare class CustomSandbox extends Sandbox {
+    static templateType: TemplateType;
+    /**
+     * Create a Custom Sandbox from template
+     * 从模板创建自定义沙箱 / Create Custom Sandbox from Template
+     */
+    static createFromTemplate(templateName: string, options?: {
+        sandboxIdleTimeoutSeconds?: number;
+        nasConfig?: NASConfig;
+        ossMountConfig?: OSSMountConfig;
+        polarFsConfig?: PolarFsConfig;
+    }, config?: Config): Promise<CustomSandbox>;
+    constructor(sandbox: Sandbox, config?: Config);
+    private _dataApi?;
+    /**
+     * Get data API client
+     */
+    get dataApi(): SandboxDataAPI;
+    /**
+     * Get base URL for the sandbox
+     * 获取沙箱的基础 URL / Get base URL for the sandbox
+     *
+     * @returns 基础 URL / Base URL
+     */
+    getBaseUrl(): string;
+}
+
+/**
+ * Base Sandbox Resource
+ *
+ * 此模块定义基础 Sandbox 资源类。
+ * This module defines the base Sandbox resource class.
+ */
+
+/**
+ * Base Sandbox resource class
+ * 基础沙箱资源类 / Base Sandbox Resource Class
+ */
+declare class Sandbox extends ResourceBase implements SandboxData {
+    templateType?: TemplateType;
+    /**
+     * 沙箱 ID / Sandbox ID
+     */
+    sandboxId?: string;
+    /**
+     * 沙箱名称 / Sandbox Name
+     */
+    sandboxName?: string;
+    /**
+     * 模板 ID / Template ID
+     */
+    templateId?: string;
+    /**
+     * 模板名称 / Template Name
+     */
+    templateName?: string;
+    /**
+     * 沙箱状态 / Sandbox State
+     */
+    state?: SandboxState;
+    /**
+     * 状态原因 / State Reason
+     */
+    stateReason?: string;
+    /**
+     * 沙箱创建时间 / Sandbox Creation Time
+     */
+    createdAt?: string;
+    /**
+     * 最后更新时间 / Last Updated Time
+     */
+    lastUpdatedAt?: string;
+    /**
+     * 沙箱空闲超时时间（秒） / Sandbox Idle Timeout (seconds)
+     */
+    sandboxIdleTimeoutSeconds?: number;
+    /**
+     * 沙箱结束时间 / Sandbox End Time
+     */
+    endedAt?: string;
+    /**
+     * 元数据 / Metadata
+     */
+    metadata?: Record<string, any>;
+    /**
+     * 沙箱全局唯一资源名称 / Sandbox ARN
+     */
+    sandboxArn?: string;
+    /**
+     * 沙箱空闲 TTL（秒） / Sandbox Idle TTL (seconds)
+     */
+    sandboxIdleTTLInSeconds?: number;
+    protected _config?: Config;
+    constructor(data?: Partial<SandboxData>, config?: Config);
+    /**
+     * Create sandbox from SDK response object
+     * 从 SDK 响应对象创建沙箱 / Create Sandbox from SDK Response Object
+     */
+    static fromInnerObject(obj: any, config?: Config): Sandbox;
+    private static getClient;
+    /**
+     * Create a new Sandbox
+     * 创建新沙箱 / Create a New Sandbox
+     */
+    static create(params: {
+        input: SandboxCreateInput;
+        templateType: TemplateType.AIO;
+        config?: Config;
+    }): Promise<AioSandbox>;
+    static create(params: {
+        input: SandboxCreateInput;
+        templateType: TemplateType.BROWSER;
+        config?: Config;
+    }): Promise<BrowserSandbox>;
+    static create(params: {
+        input: SandboxCreateInput;
+        templateType: TemplateType.CODE_INTERPRETER;
+        config?: Config;
+    }): Promise<CodeInterpreterSandbox>;
+    static create(params: {
+        input: SandboxCreateInput;
+        templateType: TemplateType.CUSTOM;
+        config?: Config;
+    }): Promise<CustomSandbox>;
+    static create(params: {
+        input: SandboxCreateInput;
+        templateType?: TemplateType;
+        config?: Config;
+    }): Promise<Sandbox>;
+    /** @deprecated Use create({ input, config }) instead. */
+    static create(input: SandboxCreateInput, config?: Config): Promise<Sandbox>;
+    /**
+     * Delete a Sandbox by ID
+     */
+    static delete(params: {
+        id: string;
+        config?: Config;
+    }): Promise<Sandbox>;
+    /** @deprecated Use delete({ id, config }) instead. */
+    static delete(id: string, config?: Config): Promise<Sandbox>;
+    /**
+     * Stop a Sandbox by ID
+     */
+    static stop(params: {
+        id: string;
+        config?: Config;
+    }): Promise<Sandbox>;
+    /** @deprecated Use stop({ id, config }) instead. */
+    static stop(id: string, config?: Config): Promise<Sandbox>;
+    /**
+     * Get a Sandbox by ID
+     */
+    static get(params: {
+        id: string;
+        templateType?: TemplateType;
+        config?: Config;
+    }): Promise<Sandbox>;
+    /** @deprecated Use get({ id, templateType, config }) instead. */
+    static get(id: string, templateType?: TemplateType, config?: Config): Promise<Sandbox>;
+    /**
+     * List Sandboxes
+     */
+    static list(params?: {
+        input?: SandboxListInput;
+        config?: Config;
+    }): Promise<Sandbox[]>;
+    /** @deprecated Use list({ input, config }) instead. */
+    static list(input: SandboxListInput, config?: Config): Promise<Sandbox[]>;
+    get: (params?: {
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * Delete this sandbox
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * Stop this sandbox
+     */
+    stop: (params?: {
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * Refresh this sandbox's data
+     */
+    refresh: (params?: {
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * Wait until the sandbox is running
+     */
+    waitUntilRunning: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (sandbox: Sandbox) => void;
+    }, config?: Config) => Promise<Sandbox>;
+}
+
+/**
+ * AIO (All-In-One) Sandbox
+ *
+ * Combines both Code Interpreter and Browser sandbox functionalities
+ * into a single unified interface.
+ */
+
+/**
+ * File upload/download operations
+ */
+declare class AioFileOperations {
+    private sandbox;
+    constructor(sandbox: AioSandbox);
+    /**
+     * Read a file from the sandbox
+     */
+    read: (path: string) => Promise<any>;
+    /**
+     * Write a file to the sandbox
+     */
+    write: (params: {
+        path: string;
+        content: string;
+        mode?: string;
+        encoding?: string;
+        createDir?: boolean;
+    }) => Promise<any>;
+}
+/**
+ * File system operations (list, move, remove, stat, mkdir)
+ */
+declare class AioFileSystemOperations {
+    private sandbox;
+    constructor(sandbox: AioSandbox);
+    /**
+     * List directory contents
+     */
+    list: (params?: {
+        path?: string;
+        depth?: number;
+    }) => Promise<any>;
+    /**
+     * Move a file or directory
+     */
+    move: (params: {
+        source: string;
+        destination: string;
+    }) => Promise<any>;
+    /**
+     * Remove a file or directory
+     */
+    remove: (params: {
+        path: string;
+    }) => Promise<any>;
+    /**
+     * Get file or directory statistics
+     */
+    stat: (params: {
+        path: string;
+    }) => Promise<any>;
+    /**
+     * Create a directory
+     */
+    mkdir: (params: {
+        path: string;
+        parents?: boolean;
+        mode?: string;
+    }) => Promise<any>;
+    /**
+     * Upload a file to the sandbox
+     */
+    upload: (params: {
+        localFilePath: string;
+        targetFilePath: string;
+    }) => Promise<any>;
+    /**
+     * Download a file from the sandbox
+     */
+    download: (params: {
+        path: string;
+        savePath: string;
+    }) => Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+}
+/**
+ * Process management operations
+ */
+declare class AioProcessOperations {
+    private sandbox;
+    constructor(sandbox: AioSandbox);
+    /**
+     * Execute a command in the sandbox
+     */
+    cmd: (params: {
+        command: string;
+        cwd: string;
+        timeout?: number;
+    }) => Promise<any>;
+    /**
+     * List all processes
+     */
+    list: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Get a specific process by PID
+     */
+    get: (params: {
+        pid: string;
+    }) => Promise<any>;
+    /**
+     * Kill a specific process by PID
+     */
+    kill: (params: {
+        pid: string;
+    }) => Promise<any>;
+}
+/**
+ * Context management operations
+ */
+declare class AioContextOperations {
+    private sandbox;
+    private _contextId?;
+    private _language?;
+    private _cwd?;
+    constructor(sandbox: AioSandbox);
+    /**
+     * Get the current context ID
+     */
+    get contextId(): string | undefined;
+    /**
+     * List all contexts
+     */
+    list: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Create a new context and save its ID
+     */
+    create: (params?: {
+        language?: CodeLanguage;
+        cwd?: string;
+    }) => Promise<AioContextOperations>;
+    /**
+     * Get a specific context by ID
+     */
+    get: (params?: {
+        contextId?: string;
+    }) => Promise<AioContextOperations>;
+    /**
+     * Execute code in a context
+     */
+    execute: (params: {
+        code: string;
+        language?: CodeLanguage;
+        contextId?: string;
+        timeout?: number;
+    }) => Promise<any>;
+    /**
+     * Delete a context
+     */
+    delete: (params?: {
+        contextId?: string;
+    }) => Promise<any>;
+}
+/**
+ * AIO (All-In-One) Sandbox
+ *
+ * Combines both Code Interpreter and Browser sandbox functionalities.
+ */
+declare class AioSandbox extends Sandbox {
+    static templateType: TemplateType;
+    /**
+     * Create an AIO Sandbox from template
+     * 从模板创建 AIO 沙箱 / Create AIO Sandbox from Template
+     */
+    static createFromTemplate(templateName: string, options?: {
+        sandboxIdleTimeoutSeconds?: number;
+        nasConfig?: NASConfig;
+        ossMountConfig?: OSSMountConfig;
+        polarFsConfig?: PolarFsConfig;
+    }, config?: Config): Promise<AioSandbox>;
+    constructor(sandbox: Sandbox, config?: Config);
+    private _dataApi?;
+    private _file?;
+    private _fileSystem?;
+    private _context?;
+    private _process?;
+    /**
+     * Get data API client
+     */
+    get dataApi(): AioDataAPI;
+    /**
+     * Access file upload/download operations
+     */
+    get file(): AioFileOperations;
+    /**
+     * Access file system operations
+     */
+    get fileSystem(): AioFileSystemOperations;
+    /**
+     * Access context management operations
+     */
+    get context(): AioContextOperations;
+    /**
+     * Access process management operations
+     */
+    get process(): AioProcessOperations;
+    /**
+     * Check sandbox health
+     */
+    checkHealth: (params?: {
+        config?: Config;
+    }) => Promise<{
+        status: string;
+        [key: string]: any;
+    }>;
+    /**
+     * Get CDP WebSocket URL for browser automation
+     */
+    getCdpUrl(record?: boolean): string;
+    /**
+     * Get VNC WebSocket URL for live view
+     */
+    getVncUrl(record?: boolean): string;
+    /**
+     * List all browser recordings
+     */
+    listRecordings: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Download a recording video file
+     */
+    downloadRecording: (params: {
+        filename: string;
+        savePath: string;
+    }) => Promise<{
+        savedPath: string;
+        size: number;
+    }>;
+    /**
+     * Delete a recording
+     */
+    deleteRecording: (params: {
+        filename: string;
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Execute code (convenience method delegating to context.execute)
+     */
+    execute: (params: {
+        code: string;
+        language?: CodeLanguage;
+        contextId?: string;
+        timeout?: number;
+    }) => Promise<any>;
+}
+
+/**
+ * Template Resource
+ *
+ * 此模块定义 Template 资源类。
+ * This module defines the Template resource class.
+ */
+
+/**
+ * Template resource class
+ * 模板资源类 / Template Resource Class
+ */
+declare class Template extends ResourceBase implements TemplateData {
+    /**
+     * 模板 ARN / Template ARN
+     */
+    templateArn?: string;
+    /**
+     * 模板 ID / Template ID
+     */
+    templateId?: string;
+    /**
+     * 模板名称 / Template Name
+     */
+    templateName?: string;
+    /**
+     * 模板类型 / Template Type
+     */
+    templateType?: TemplateType;
+    /**
+     * CPU 核数 / CPU Cores
+     */
+    cpu?: number;
+    /**
+     * 内存大小（MB） / Memory Size (MB)
+     */
+    memory?: number;
+    /**
+     * 创建时间 / Creation Time
+     */
+    createdAt?: string;
+    /**
+     * 描述 / Description
+     */
+    description?: string;
+    /**
+     * 执行角色 ARN / Execution Role ARN
+     */
+    executionRoleArn?: string;
+    /**
+     * 最后更新时间 / Last Updated Time
+     */
+    lastUpdatedAt?: string;
+    /**
+     * 资源名称 / Resource Name
+     */
+    resourceName?: string;
+    /**
+     * 沙箱空闲超时时间（秒） / Sandbox Idle Timeout (seconds)
+     */
+    sandboxIdleTimeoutInSeconds?: number;
+    /**
+     * 沙箱存活时间（秒） / Sandbox TTL (seconds)
+     */
+    sandboxTtlInSeconds?: number;
+    /**
+     * 每个沙箱的最大并发会话数 / Max Concurrency Limit Per Sandbox
+     */
+    shareConcurrencyLimitPerSandbox?: number;
+    /**
+     * 状态 / Status
+     */
+    status?: Status;
+    /**
+     * 状态原因 / Status Reason
+     */
+    statusReason?: string;
+    /**
+     * 磁盘大小（GB） / Disk Size (GB)
+     */
+    diskSize?: number;
+    /**
+     * 是否允许匿名管理 / Whether to allow anonymous management
+     */
+    allowAnonymousManage?: boolean;
+    protected _config?: Config;
+    constructor(data?: any, config?: Config);
+    uniqIdCallback: () => string | undefined;
+    private static getClient;
+    /**
+     * Create a new Template
+     */
+    static create(params: {
+        input: TemplateCreateInput;
+        config?: Config;
+    }): Promise<Template>;
+    /**
+     * Delete a Template by name
+     */
+    static delete(params: {
+        name: string;
+        config?: Config;
+    }): Promise<Template>;
+    /**
+     * Update a Template by name
+     */
+    static update(params: {
+        name: string;
+        input: TemplateUpdateInput;
+        config?: Config;
+    }): Promise<Template>;
+    /**
+     * Get a Template by name
+     */
+    static get(params: {
+        name: string;
+        config?: Config;
+    }): Promise<Template>;
+    /**
+     * List Templates
+     */
+    static list(params?: {
+        input?: TemplateListInput;
+        config?: Config;
+    }): Promise<Template[]>;
+    /**
+     * List all Templates (with pagination)
+     */
+    static listAll: (params?: (Omit<TemplateListInput, "pageNumber" | "pageSize"> & {
+        config?: Config;
+    }) | undefined) => Promise<any[]>;
+    get: (params?: {
+        config?: Config;
+    }) => Promise<Template>;
+    /**
+     * Delete this template
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<Template>;
+    /**
+     * Update this template
+     */
+    update: (params: {
+        input: TemplateUpdateInput;
+        config?: Config;
+    }) => Promise<Template>;
+    /**
+     * Refresh this template's data
+     */
+    refresh: (params?: {
+        config?: Config;
+    }) => Promise<Template>;
+    private normalizeNumericFields;
+}
+
+/**
+ * Sandbox Client
+ *
+ * 此模块提供 Sandbox 的客户端 API。
+ * This module provides the client API for Sandbox.
+ */
+
+/**
+ * Sandbox Client
+ *
+ * 提供 Sandbox 和 Template 的管理功能。
+ */
+declare class SandboxClient {
+    private config?;
+    private controlApi;
+    constructor(config?: Config);
+    /**
+     * Create a Template
+     */
+    createTemplate: {
+        (params: {
+            input: TemplateCreateInput;
+            config?: Config;
+        }): Promise<Template>;
+        /** @deprecated Use createTemplate({ input, config }) instead. */
+        (input: TemplateCreateInput, config?: Config): Promise<Template>;
+    };
+    /**
+     * Delete a Template
+     */
+    deleteTemplate: {
+        (params: {
+            name: string;
+            config?: Config;
+        }): Promise<Template>;
+        /** @deprecated Use deleteTemplate({ name, config }) instead. */
+        (name: string, config?: Config): Promise<Template>;
+    };
+    /**
+     * Update a Template
+     */
+    updateTemplate: {
+        (params: {
+            name: string;
+            input: TemplateUpdateInput;
+            config?: Config;
+        }): Promise<Template>;
+        /** @deprecated Use updateTemplate({ name, input, config }) instead. */
+        (name: string, input: TemplateUpdateInput, config?: Config): Promise<Template>;
+    };
+    /**
+     * Get a Template
+     */
+    getTemplate: {
+        (params: {
+            name: string;
+            config?: Config;
+        }): Promise<Template>;
+        /** @deprecated Use getTemplate({ name, config }) instead. */
+        (name: string, config?: Config): Promise<Template>;
+    };
+    /**
+     * List Templates
+     */
+    listTemplates: {
+        (params?: {
+            input?: TemplateListInput;
+            config?: Config;
+        }): Promise<Template[]>;
+        /** @deprecated Use listTemplates({ input, config }) instead. */
+        (input: TemplateListInput, config?: Config): Promise<Template[]>;
+    };
+    /**
+     * Create a Sandbox
+     */
+    createSandbox: {
+        (params: {
+            input: SandboxCreateInput;
+            templateType: TemplateType.AIO;
+            config?: Config;
+        }): Promise<AioSandbox>;
+        (params: {
+            input: SandboxCreateInput;
+            templateType: TemplateType.BROWSER;
+            config?: Config;
+        }): Promise<BrowserSandbox>;
+        (params: {
+            input: SandboxCreateInput;
+            templateType: TemplateType.CODE_INTERPRETER;
+            config?: Config;
+        }): Promise<CodeInterpreterSandbox>;
+        (params: {
+            input: SandboxCreateInput;
+            templateType: TemplateType.CUSTOM;
+            config?: Config;
+        }): Promise<CustomSandbox>;
+        (params: {
+            input: SandboxCreateInput;
+            templateType?: TemplateType;
+            config?: Config;
+        }): Promise<Sandbox>;
+        /** @deprecated Use createSandbox({ input, config }) instead. */
+        (input: SandboxCreateInput, config?: Config): Promise<Sandbox>;
+    };
+    /**
+     * Create a Code Interpreter Sandbox
+     * 创建代码解释器沙箱 / Create Code Interpreter Sandbox
+     */
+    createCodeInterpreterSandbox: (params: {
+        templateName: string;
+        options?: {
+            sandboxIdleTimeoutSeconds?: number;
+            nasConfig?: NASConfig;
+            ossMountConfig?: OSSMountConfig;
+            polarFsConfig?: PolarFsConfig;
+        };
+        config?: Config;
+    }) => Promise<CodeInterpreterSandbox>;
+    /**
+     * Create a Browser Sandbox
+     * 创建浏览器沙箱 / Create Browser Sandbox
+     */
+    createBrowserSandbox: (params: {
+        templateName: string;
+        options?: {
+            sandboxIdleTimeoutSeconds?: number;
+            nasConfig?: NASConfig;
+            ossMountConfig?: OSSMountConfig;
+            polarFsConfig?: PolarFsConfig;
+        };
+        config?: Config;
+    }) => Promise<BrowserSandbox>;
+    /**
+     * Delete a Sandbox
+     */
+    deleteSandbox: {
+        (params: {
+            id: string;
+            config?: Config;
+        }): Promise<Sandbox>;
+        /** @deprecated Use deleteSandbox({ id, config }) instead. */
+        (id: string, config?: Config): Promise<Sandbox>;
+    };
+    /**
+     * Stop a Sandbox
+     */
+    stopSandbox: {
+        (params: {
+            id: string;
+            config?: Config;
+        }): Promise<Sandbox>;
+        /** @deprecated Use stopSandbox({ id, config }) instead. */
+        (id: string, config?: Config): Promise<Sandbox>;
+    };
+    /**
+     * Get a Sandbox
+     *
+     * @param params.id - Sandbox ID
+     * @param params.templateType - Template type to cast the result to the appropriate subclass
+     * @param params.config - Configuration
+     */
+    getSandbox: {
+        (params: {
+            id: string;
+            templateType?: TemplateType;
+            config?: Config;
+        }): Promise<Sandbox>;
+        /** @deprecated Use getSandbox({ id, templateType, config }) instead. */
+        (id: string, templateType?: TemplateType, config?: Config): Promise<Sandbox>;
+    };
+    /**
+     * List Sandboxes
+     */
+    listSandboxes: {
+        (params?: {
+            input?: SandboxListInput;
+            config?: Config;
+        }): Promise<Sandbox[]>;
+        /** @deprecated Use listSandboxes({ input, config }) instead. */
+        (input: SandboxListInput, config?: Config): Promise<Sandbox[]>;
+    };
+    private prepareTemplateCreateInput;
+    private getTemplateDefaults;
+    private validateTemplateCreateInput;
+}
+
+export { AioDataAPI, AioSandbox, BrowserDataAPI, BrowserSandbox, CodeInterpreterDataAPI, CodeInterpreterSandbox, CodeLanguage, CustomSandbox, NASConfig, OSSMountConfig, PolarFsConfig, Sandbox, SandboxClient, SandboxCreateInput, SandboxData, SandboxDataAPI, SandboxListInput, SandboxState, Template, TemplateCreateInput, TemplateData, TemplateListInput, TemplateType, TemplateUpdateInput };