@agentrun/sdk 0.0.1-test.21dd786 → 0.0.1-test.5b55888

package/dist/index.d.cts

@@ -0,0 +1,4846 @@
+import * as openai_core_streaming from 'openai/core/streaming';
+import * as openai_resources from 'openai/resources';
+import { ChatCompletionMessageParam } from 'openai/resources';
+import * as $AgentRun from '@alicloud/agentrun20250910';
+import * as $Devs from '@alicloud/devs20230714';
+
+/**
+ * Configuration Management Module
+ *
+ * 此模块提供 AgentRun SDK 的全局配置管理功能。
+ * This module provides global configuration management for AgentRun SDK.
+ */
+/**
+ * Configuration options for AgentRun SDK
+ */
+interface ConfigOptions {
+    /**
+     * Access Key ID for authentication.
+     * Read from AGENTRUN_ACCESS_KEY_ID or ALIBABA_CLOUD_ACCESS_KEY_ID if not provided.
+     */
+    accessKeyId?: string;
+    /**
+     * Access Key Secret for authentication.
+     * Read from AGENTRUN_ACCESS_KEY_SECRET or ALIBABA_CLOUD_ACCESS_KEY_SECRET if not provided.
+     */
+    accessKeySecret?: string;
+    /**
+     * Security token for STS authentication.
+     * Read from AGENTRUN_SECURITY_TOKEN or ALIBABA_CLOUD_SECURITY_TOKEN if not provided.
+     */
+    securityToken?: string;
+    /**
+     * Account ID.
+     * Read from AGENTRUN_ACCOUNT_ID or FC_ACCOUNT_ID if not provided.
+     */
+    accountId?: string;
+    /**
+     * Custom token for data API calls.
+     */
+    token?: string;
+    /**
+     * Region ID. Defaults to cn-hangzhou.
+     * Read from AGENTRUN_REGION or FC_REGION if not provided.
+     */
+    regionId?: string;
+    /**
+     * Request timeout in milliseconds. Defaults to 600000 (10 minutes).
+     */
+    timeout?: number;
+    /**
+     * Read timeout in milliseconds. Defaults to 100000000.
+     */
+    readTimeout?: number;
+    /**
+     * Custom control API endpoint.
+     * Read from AGENTRUN_CONTROL_ENDPOINT if not provided.
+     */
+    controlEndpoint?: string;
+    /**
+     * Custom data API endpoint.
+     * Read from AGENTRUN_DATA_ENDPOINT if not provided.
+     */
+    dataEndpoint?: string;
+    /**
+     * Custom DevS API endpoint.
+     * Read from DEVS_ENDPOINT if not provided.
+     */
+    devsEndpoint?: string;
+    /**
+     * Custom request headers.
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * AgentRun SDK Global Configuration Class
+ *
+ * 用于管理账号凭证和客户端配置。
+ * Used for managing account credentials and client configuration.
+ *
+ * @example
+ * ```typescript
+ * // Create config from parameters
+ * const config = new Config({
+ *   accountId: 'your-account-id',
+ *   accessKeyId: 'your-key-id',
+ *   accessKeySecret: 'your-secret',
+ * });
+ *
+ * // Or read from environment variables
+ * const config = new Config();
+ * ```
+ */
+declare class Config {
+    private _accessKeyId;
+    private _accessKeySecret;
+    private _securityToken;
+    private _accountId;
+    private _token?;
+    private _regionId;
+    private _timeout;
+    private _readTimeout;
+    private _controlEndpoint;
+    private _dataEndpoint;
+    private _devsEndpoint;
+    private _headers;
+    constructor(options?: ConfigOptions);
+    /**
+     * Create a new Config by merging multiple configs.
+     * Later configs take precedence.
+     */
+    static withConfigs(...configs: (Config | undefined)[]): Config;
+    /**
+     * Update this config with values from other configs.
+     * Non-undefined values from later configs take precedence.
+     */
+    update(...configs: (Config | undefined)[]): Config;
+    get accessKeyId(): string;
+    get accessKeySecret(): string;
+    get securityToken(): string;
+    get accountId(): string;
+    get token(): string | undefined;
+    get regionId(): string;
+    get timeout(): number;
+    get readTimeout(): number;
+    get controlEndpoint(): string;
+    get dataEndpoint(): string;
+    get devsEndpoint(): string;
+    get headers(): Record<string, string>;
+}
+
+/**
+ * Exception classes for AgentRun SDK
+ *
+ * 此模块定义 AgentRun SDK 的异常类。
+ * This module defines exception classes for AgentRun SDK.
+ */
+/**
+ * Base error class for AgentRun SDK
+ */
+declare class AgentRunError extends Error {
+    constructor(message: string);
+}
+/**
+ * HTTP error with status code and request ID
+ */
+declare class HTTPError extends AgentRunError {
+    readonly statusCode: number;
+    readonly requestId?: string;
+    readonly errorCode?: string;
+    constructor(statusCode: number, message: string, options?: {
+        requestId?: string;
+        errorCode?: string;
+    });
+    /**
+     * Convert HTTP error to resource-specific error based on status code
+     */
+    toResourceError(resourceType: string, resourceId?: string): HTTPError;
+}
+/**
+ * Client-side error (4xx status codes)
+ */
+declare class ClientError extends HTTPError {
+    constructor(statusCode: number, message: string, options?: {
+        requestId?: string;
+        errorCode?: string;
+    });
+}
+/**
+ * Server-side error (5xx status codes)
+ */
+declare class ServerError extends HTTPError {
+    constructor(statusCode: number, message: string, options?: {
+        requestId?: string;
+        errorCode?: string;
+    });
+}
+/**
+ * Resource not found error
+ */
+declare class ResourceNotExistError extends ClientError {
+    readonly resourceType: string;
+    readonly resourceId?: string;
+    constructor(resourceType: string, resourceId?: string, options?: {
+        requestId?: string;
+    });
+}
+/**
+ * Resource already exists error
+ */
+declare class ResourceAlreadyExistError extends ClientError {
+    readonly resourceType: string;
+    readonly resourceId?: string;
+    constructor(resourceType: string, resourceId?: string, options?: {
+        requestId?: string;
+    });
+}
+
+/**
+ * Common data models for AgentRun SDK
+ *
+ * 此模块定义通用的数据模型。
+ * This module defines common data models.
+ */
+/**
+ * Resource status enum
+ */
+type Status = 'CREATING' | 'CREATE_FAILED' | 'READY' | 'UPDATING' | 'UPDATE_FAILED' | 'DELETING' | 'DELETE_FAILED';
+declare const Status: {
+    CREATING: Status;
+    CREATE_FAILED: Status;
+    READY: Status;
+    UPDATING: Status;
+    UPDATE_FAILED: Status;
+    DELETING: Status;
+    DELETE_FAILED: Status;
+};
+/**
+ * Network mode enum
+ */
+type NetworkMode = 'PUBLIC' | 'PRIVATE' | 'PUBLIC_AND_PRIVATE';
+declare const NetworkMode: {
+    PUBLIC: NetworkMode;
+    PRIVATE: NetworkMode;
+    PUBLIC_AND_PRIVATE: NetworkMode;
+};
+/**
+ * Pageable input for list operations
+ */
+interface PageableInput {
+    pageNumber?: number;
+    pageSize?: number;
+}
+/**
+ * Network configuration
+ */
+interface NetworkConfig {
+    networkMode?: NetworkMode;
+    vpcId?: string;
+    vSwitchIds?: string[];
+    securityGroupId?: string;
+}
+
+/**
+ * Invoke arguments for OpenAI-compatible API
+ */
+interface InvokeArgs {
+    /** Chat messages */
+    messages: ChatCompletionMessageParam[];
+    /** Whether to stream the response */
+    stream?: boolean;
+    /** Optional config override */
+    config?: Config;
+}
+
+/**
+ * Agent Runtime Data Models
+ *
+ * 此模块定义 Agent Runtime 相关的所有数据模型、枚举和输入输出对象。
+ * This module defines all data models, enums, and input/output objects related to Agent Runtime.
+ */
+
+/**
+ * Agent Runtime artifact type
+ */
+type AgentRuntimeArtifact = "Code" | "Container";
+declare const AgentRuntimeArtifact: {
+    CODE: AgentRuntimeArtifact;
+    CONTAINER: AgentRuntimeArtifact;
+};
+/**
+ * Agent Runtime language
+ */
+type AgentRuntimeLanguage = "python3.10" | "python3.12" | "nodejs18" | "nodejs20" | "java8" | "java11";
+declare const AgentRuntimeLanguage: {
+    PYTHON310: AgentRuntimeLanguage;
+    PYTHON312: AgentRuntimeLanguage;
+    NODEJS18: AgentRuntimeLanguage;
+    NODEJS20: AgentRuntimeLanguage;
+    JAVA8: AgentRuntimeLanguage;
+    JAVA11: AgentRuntimeLanguage;
+};
+/**
+ * Agent Runtime protocol type
+ */
+type AgentRuntimeProtocolType = "HTTP" | "MCP";
+declare const AgentRuntimeProtocolType: {
+    HTTP: AgentRuntimeProtocolType;
+    MCP: AgentRuntimeProtocolType;
+};
+/**
+ * Agent Runtime code configuration
+ */
+interface AgentRuntimeCode {
+    /** CRC-64 checksum of the code package */
+    checksum?: string;
+    /** Command to run in the runtime (e.g., ["python"]) */
+    command?: string[];
+    /** Programming language runtime */
+    language?: AgentRuntimeLanguage;
+    /** OSS bucket name */
+    ossBucketName?: string;
+    /** OSS object name */
+    ossObjectName?: string;
+    /** Base64 encoded ZIP file */
+    zipFile?: string;
+}
+/**
+ * Agent Runtime container configuration
+ */
+interface AgentRuntimeContainer {
+    /** Command to run in the runtime */
+    command?: string[];
+    /** Container image address */
+    image?: string;
+}
+/**
+ * Agent Runtime health check configuration
+ */
+interface AgentRuntimeHealthCheckConfig {
+    /** Failure threshold before marking unhealthy */
+    failureThreshold?: number;
+    /** HTTP GET URL for health check */
+    httpGetUrl?: string;
+    /** Initial delay before first health check (seconds) */
+    initialDelaySeconds?: number;
+    /** Health check interval (seconds) */
+    periodSeconds?: number;
+    /** Success threshold before marking healthy */
+    successThreshold?: number;
+    /** Health check timeout (seconds) */
+    timeoutSeconds?: number;
+}
+/**
+ * Agent Runtime log configuration
+ */
+interface AgentRuntimeLogConfig {
+    /** SLS project name */
+    project: string;
+    /** SLS logstore name */
+    logstore: string;
+}
+/**
+ * Agent Runtime protocol configuration
+ */
+interface AgentRuntimeProtocolConfig {
+    /** Protocol type */
+    type?: AgentRuntimeProtocolType;
+}
+/**
+ * Endpoint routing weight configuration
+ */
+interface AgentRuntimeEndpointRoutingWeight {
+    /** Version identifier */
+    version?: string;
+    /** Weight value */
+    weight?: number;
+}
+/**
+ * Endpoint routing configuration
+ */
+interface AgentRuntimeEndpointRoutingConfig {
+    /** Version weights list */
+    versionWeights?: AgentRuntimeEndpointRoutingWeight[];
+}
+/**
+ * Agent Runtime create input
+ */
+interface AgentRuntimeCreateInput {
+    /** Agent Runtime name */
+    agentRuntimeName?: string;
+    /** Artifact type (Code or Container) */
+    artifactType?: AgentRuntimeArtifact;
+    /** Code configuration */
+    codeConfiguration?: AgentRuntimeCode;
+    /** Container configuration */
+    containerConfiguration?: AgentRuntimeContainer;
+    /** CPU cores */
+    cpu?: number;
+    /** Credential name */
+    credentialName?: string;
+    /** Description */
+    description?: string;
+    /** Environment variables */
+    environmentVariables?: Record<string, string>;
+    /** Execution role ARN */
+    executionRoleArn?: string;
+    /** Health check configuration */
+    healthCheckConfiguration?: AgentRuntimeHealthCheckConfig;
+    /** Log configuration */
+    logConfiguration?: AgentRuntimeLogConfig;
+    /** Memory in MB */
+    memory?: number;
+    /** Network configuration */
+    networkConfiguration?: NetworkConfig;
+    /** Port number */
+    port?: number;
+    /** Protocol configuration */
+    protocolConfiguration?: AgentRuntimeProtocolConfig;
+    /** Session concurrency limit per instance */
+    sessionConcurrencyLimitPerInstance?: number;
+    /** Session idle timeout in seconds */
+    sessionIdleTimeoutSeconds?: number;
+    /** Tags */
+    tags?: string[];
+}
+/**
+ * Agent Runtime update input
+ */
+interface AgentRuntimeUpdateInput {
+    /** Agent Runtime name */
+    agentRuntimeName?: string;
+    /** Artifact type (Code or Container) */
+    artifactType?: AgentRuntimeArtifact;
+    /** Code configuration */
+    codeConfiguration?: AgentRuntimeCode;
+    /** Container configuration */
+    containerConfiguration?: AgentRuntimeContainer;
+    /** CPU cores */
+    cpu?: number;
+    /** Credential name */
+    credentialName?: string;
+    /** Description */
+    description?: string;
+    /** Environment variables */
+    environmentVariables?: Record<string, string>;
+    /** Execution role ARN */
+    executionRoleArn?: string;
+    /** Health check configuration */
+    healthCheckConfiguration?: AgentRuntimeHealthCheckConfig;
+    /** Log configuration */
+    logConfiguration?: AgentRuntimeLogConfig;
+    /** Memory in MB */
+    memory?: number;
+    /** Network configuration */
+    networkConfiguration?: NetworkConfig;
+    /** Port number */
+    port?: number;
+    /** Protocol configuration */
+    protocolConfiguration?: AgentRuntimeProtocolConfig;
+    /** Session concurrency limit per instance */
+    sessionConcurrencyLimitPerInstance?: number;
+    /** Session idle timeout in seconds */
+    sessionIdleTimeoutSeconds?: number;
+    /** Tags */
+    tags?: string[];
+}
+/**
+ * Agent Runtime list input
+ */
+interface AgentRuntimeListInput extends PageableInput {
+    /** Filter by name */
+    agentRuntimeName?: string;
+    /** Filter by tags (comma separated) */
+    tags?: string;
+    /** Search mode */
+    searchMode?: string;
+}
+/**
+ * Agent Runtime endpoint create input
+ */
+interface AgentRuntimeEndpointCreateInput {
+    /** Endpoint name */
+    agentRuntimeEndpointName?: string;
+    /** Description */
+    description?: string;
+    /** Routing configuration */
+    routingConfiguration?: AgentRuntimeEndpointRoutingConfig;
+    /** Tags */
+    tags?: string[];
+    /** Target version */
+    targetVersion?: string;
+}
+/**
+ * Agent Runtime endpoint update input
+ */
+interface AgentRuntimeEndpointUpdateInput {
+    /** Endpoint name */
+    agentRuntimeEndpointName?: string;
+    /** Description */
+    description?: string;
+    /** Routing configuration */
+    routingConfiguration?: AgentRuntimeEndpointRoutingConfig;
+    /** Tags */
+    tags?: string[];
+    /** Target version */
+    targetVersion?: string;
+}
+/**
+ * Agent Runtime endpoint list input
+ */
+interface AgentRuntimeEndpointListInput extends PageableInput {
+    /** Filter by endpoint name */
+    endpointName?: string;
+    /** Search mode */
+    searchMode?: string;
+}
+/**
+ * Agent Runtime version
+ */
+interface AgentRuntimeVersion {
+    /** Agent Runtime ARN */
+    agentRuntimeArn?: string;
+    /** Agent Runtime ID */
+    agentRuntimeId?: string;
+    /** Agent Runtime name */
+    agentRuntimeName?: string;
+    /** Version number */
+    agentRuntimeVersion?: string;
+    /** Version description */
+    description?: string;
+    /** Last update timestamp */
+    lastUpdatedAt?: string;
+}
+/**
+ * Agent Runtime version list input
+ */
+interface AgentRuntimeVersionListInput extends PageableInput {
+}
+/**
+ * Agent Runtime data (internal representation from API)
+ */
+interface AgentRuntimeData {
+    agentRuntimeArn?: string;
+    agentRuntimeId?: string;
+    agentRuntimeName?: string;
+    agentRuntimeVersion?: string;
+    artifactType?: string;
+    codeConfiguration?: AgentRuntimeCode;
+    containerConfiguration?: AgentRuntimeContainer;
+    cpu?: number;
+    createdAt?: string;
+    credentialName?: string;
+    description?: string;
+    environmentVariables?: Record<string, string>;
+    executionRoleArn?: string;
+    healthCheckConfiguration?: AgentRuntimeHealthCheckConfig;
+    lastUpdatedAt?: string;
+    logConfiguration?: AgentRuntimeLogConfig;
+    memory?: number;
+    networkConfiguration?: NetworkConfig;
+    port?: number;
+    protocolConfiguration?: AgentRuntimeProtocolConfig;
+    resourceName?: string;
+    sessionConcurrencyLimitPerInstance?: number;
+    sessionIdleTimeoutSeconds?: number;
+    status?: Status;
+    statusReason?: string;
+    tags?: string[];
+}
+/**
+ * Agent Runtime endpoint data (internal representation from API)
+ */
+interface AgentRuntimeEndpointData {
+    agentRuntimeEndpointArn?: string;
+    agentRuntimeEndpointId?: string;
+    agentRuntimeEndpointName?: string;
+    agentRuntimeId?: string;
+    description?: string;
+    endpointPublicUrl?: string;
+    resourceName?: string;
+    routingConfiguration?: AgentRuntimeEndpointRoutingConfig;
+    status?: Status;
+    statusReason?: string;
+    tags?: string[];
+    targetVersion?: string;
+}
+
+/**
+ * Agent Runtime Endpoint resource class
+ */
+declare class AgentRuntimeEndpoint implements AgentRuntimeEndpointData {
+    agentRuntimeEndpointArn?: string;
+    agentRuntimeEndpointId?: string;
+    agentRuntimeEndpointName?: string;
+    agentRuntimeId?: string;
+    description?: string;
+    endpointPublicUrl?: string;
+    resourceName?: string;
+    routingConfiguration?: AgentRuntimeEndpointRoutingConfig;
+    status?: Status;
+    statusReason?: string;
+    tags?: string[];
+    targetVersion?: string;
+    private _config?;
+    private _dataApi?;
+    private _agentRuntimeName?;
+    constructor(data?: Partial<AgentRuntimeEndpointData>, config?: Config);
+    /**
+     * Create endpoint from SDK response object
+     */
+    static fromInnerObject(obj: $AgentRun.AgentRuntimeEndpoint, config?: Config): AgentRuntimeEndpoint;
+    private static getClient;
+    /**
+     * Create an endpoint by Agent Runtime ID
+     */
+    static create(params: {
+        agentRuntimeId: string;
+        input: AgentRuntimeEndpointCreateInput;
+        config?: Config;
+    }): Promise<AgentRuntimeEndpoint>;
+    /**
+     * Delete an endpoint by ID
+     */
+    static delete(params: {
+        agentRuntimeId: string;
+        endpointId: string;
+        config?: Config;
+    }): Promise<AgentRuntimeEndpoint>;
+    /**
+     * Update an endpoint by ID
+     */
+    static update(params: {
+        agentRuntimeId: string;
+        endpointId: string;
+        input: AgentRuntimeEndpointUpdateInput;
+        config?: Config;
+    }): Promise<AgentRuntimeEndpoint>;
+    /**
+     * Get an endpoint by ID
+     */
+    static get(params: {
+        agentRuntimeId: string;
+        endpointId: string;
+        config?: Config;
+    }): Promise<AgentRuntimeEndpoint>;
+    /**
+     * List endpoints by Agent Runtime ID
+     */
+    static listById(params: {
+        agentRuntimeId: string;
+        input?: AgentRuntimeEndpointListInput;
+        config?: Config;
+    }): Promise<AgentRuntimeEndpoint[]>;
+    /**
+     * Delete this endpoint
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Update this endpoint
+     */
+    update: (params: {
+        input: AgentRuntimeEndpointUpdateInput;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Refresh this endpoint's data
+     */
+    refresh: (params?: {
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Wait until the endpoint is ready
+     */
+    waitUntilReady: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (endpoint: AgentRuntimeEndpoint) => void;
+    }, config?: Config) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Invoke agent runtime using OpenAI-compatible API through this endpoint
+     *
+     * This method provides an OpenAI-compatible interface to invoke the agent runtime
+     * through this specific endpoint.
+     *
+     * @param args - Invocation arguments
+     * @returns OpenAI chat completion response
+     *
+     * @example
+     * ```typescript
+     * const endpoint = await AgentRuntimeEndpoint.get({
+     *   agentRuntimeId: "runtime-id",
+     *   endpointId: "endpoint-id"
+     * });
+     * const response = await endpoint.invokeOpenai({
+     *   messages: [{ role: "user", content: "Hello" }],
+     *   stream: false
+     * });
+     * ```
+     */
+    invokeOpenai: (args: InvokeArgs) => Promise<(openai_core_streaming.Stream<openai_resources.ChatCompletionChunk> & {
+        _request_id?: string | null;
+    }) | (openai_resources.ChatCompletion & {
+        _request_id?: string | null;
+    })>;
+}
+
+/**
+ * Agent Runtime resource class
+ */
+declare class AgentRuntime implements AgentRuntimeData {
+    agentRuntimeArn?: string;
+    agentRuntimeId?: string;
+    agentRuntimeName?: string;
+    agentRuntimeVersion?: string;
+    artifactType?: string;
+    codeConfiguration?: AgentRuntimeCode;
+    containerConfiguration?: AgentRuntimeContainer;
+    cpu?: number;
+    createdAt?: string;
+    credentialName?: string;
+    description?: string;
+    environmentVariables?: Record<string, string>;
+    executionRoleArn?: string;
+    healthCheckConfiguration?: AgentRuntimeHealthCheckConfig;
+    lastUpdatedAt?: string;
+    logConfiguration?: AgentRuntimeLogConfig;
+    memory?: number;
+    networkConfiguration?: NetworkConfig;
+    port?: number;
+    protocolConfiguration?: AgentRuntimeProtocolConfig;
+    resourceName?: string;
+    sessionConcurrencyLimitPerInstance?: number;
+    sessionIdleTimeoutSeconds?: number;
+    status?: Status;
+    statusReason?: string;
+    tags?: string[];
+    private _config?;
+    private _dataApiCache;
+    constructor(data?: Partial<AgentRuntimeData>, config?: Config);
+    /**
+     * Create runtime from SDK response object
+     */
+    static fromInnerObject(obj: $AgentRun.AgentRuntime, config?: Config): AgentRuntime;
+    private static getClient;
+    /**
+     * Create a new Agent Runtime
+     */
+    static create(params: {
+        input: AgentRuntimeCreateInput;
+        config?: Config;
+    }): Promise<AgentRuntime>;
+    /**
+     * Delete an Agent Runtime by ID
+     */
+    static delete(params: {
+        id: string;
+        config?: Config;
+    }): Promise<AgentRuntime>;
+    /**
+     * Update an Agent Runtime by ID
+     */
+    static update(params: {
+        id: string;
+        input: AgentRuntimeUpdateInput;
+        config?: Config;
+    }): Promise<AgentRuntime>;
+    /**
+     * Get an Agent Runtime by ID
+     */
+    static get(params: {
+        id: string;
+        config?: Config;
+    }): Promise<AgentRuntime>;
+    /**
+     * List Agent Runtimes
+     */
+    static list(input?: AgentRuntimeListInput, config?: Config): Promise<AgentRuntime[]>;
+    /**
+     * List all Agent Runtimes (with pagination)
+     */
+    static listAll(options?: {
+        agentRuntimeName?: string;
+        tags?: string;
+        searchMode?: string;
+    }, config?: Config): Promise<AgentRuntime[]>;
+    /**
+     * List Agent Runtime versions by ID
+     */
+    static listVersionsById(params: {
+        agentRuntimeId: string;
+        input?: AgentRuntimeVersionListInput;
+        config?: Config;
+    }): Promise<AgentRuntimeVersion[]>;
+    /**
+     * Delete this runtime
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<AgentRuntime>;
+    /**
+     * Update this runtime
+     */
+    update: (params: {
+        input: AgentRuntimeUpdateInput;
+        config?: Config;
+    }) => Promise<AgentRuntime>;
+    /**
+     * Refresh this runtime's data
+     */
+    refresh: (params?: {
+        config?: Config;
+    }) => Promise<AgentRuntime>;
+    /**
+     * Create an endpoint for this runtime
+     */
+    createEndpoint: (params: {
+        input: AgentRuntimeEndpointCreateInput;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Delete an endpoint from this runtime
+     */
+    deleteEndpoint: (params: {
+        endpointId: string;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Update an endpoint of this runtime
+     */
+    updateEndpoint: (params: {
+        endpointId: string;
+        input: AgentRuntimeEndpointUpdateInput;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Get an endpoint of this runtime
+     */
+    getEndpoint: (params: {
+        endpointId: string;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * List endpoints of this runtime
+     */
+    listEndpoints: (params?: {
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint[]>;
+    /**
+     * List versions of this runtime
+     */
+    listVersions: (params?: {
+        config?: Config;
+    }) => Promise<AgentRuntimeVersion[]>;
+    /**
+     * Wait until the runtime is ready
+     */
+    waitUntilReady: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (runtime: AgentRuntime) => void;
+    }, config?: Config) => Promise<AgentRuntime>;
+    /**
+     * Wait until agent runtime reaches READY or any FAILED state
+     * Similar to waitUntilReady but does not throw on FAILED states
+     * Compatible with Python SDK's wait_until_ready_or_failed method
+     */
+    waitUntilReadyOrFailed: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (runtime: AgentRuntime) => void;
+    }, config?: Config) => Promise<AgentRuntime>;
+    /**
+     * Invoke agent runtime using OpenAI-compatible API
+     *
+     * This method provides an OpenAI-compatible interface to invoke the agent runtime.
+     * It creates a Data API client and forwards the invocation request.
+     *
+     * @param args - Invocation arguments
+     * @returns OpenAI chat completion response
+     *
+     * @example
+     * ```typescript
+     * const runtime = await AgentRuntime.get({ id: "runtime-id" });
+     * const response = await runtime.invokeOpenai({
+     *   agentRuntimeEndpointName: "Default",
+     *   messages: [{ role: "user", content: "Hello" }],
+     *   stream: false
+     * });
+     * ```
+     */
+    invokeOpenai: (args: InvokeArgs & {
+        agentRuntimeEndpointName?: string;
+    }) => Promise<(openai_core_streaming.Stream<openai_resources.ChatCompletionChunk> & {
+        _request_id?: string | null;
+    }) | (openai_resources.ChatCompletion & {
+        _request_id?: string | null;
+    })>;
+}
+
+/**
+ * Agent Runtime Client
+ *
+ * 提供 Agent Runtime 的创建、删除、更新、查询和端点管理功能。
+ * Provides create, delete, update, query and endpoint management functions for Agent Runtime.
+ */
+declare class AgentRuntimeClient {
+    private config?;
+    private controlApi;
+    constructor(config?: Config);
+    /**
+     * Create an Agent Runtime
+     */
+    create: (params: {
+        input: AgentRuntimeCreateInput;
+        config?: Config;
+    }) => Promise<AgentRuntime>;
+    /**
+     * Delete an Agent Runtime
+     */
+    delete: (params: {
+        id: string;
+        config?: Config;
+    }) => Promise<AgentRuntime>;
+    /**
+     * Update an Agent Runtime
+     */
+    update: (params: {
+        id: string;
+        input: AgentRuntimeUpdateInput;
+        config?: Config;
+    }) => Promise<AgentRuntime>;
+    /**
+     * Get an Agent Runtime
+     */
+    get: (params: {
+        id: string;
+        config?: Config;
+    }) => Promise<AgentRuntime>;
+    /**
+     * List Agent Runtimes
+     */
+    list: (params?: {
+        input?: AgentRuntimeListInput;
+        config?: Config;
+    }) => Promise<AgentRuntime[]>;
+    /**
+     * List all Agent Runtimes (with pagination)
+     */
+    listAll: (params?: {
+        options?: {
+            agentRuntimeName?: string;
+            tags?: string;
+            searchMode?: string;
+        };
+        config?: Config;
+    }) => Promise<AgentRuntime[]>;
+    /**
+     * Create an endpoint for an Agent Runtime
+     */
+    createEndpoint: (params: {
+        agentRuntimeId: string;
+        input: AgentRuntimeEndpointCreateInput;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Delete an endpoint
+     */
+    deleteEndpoint: (params: {
+        agentRuntimeId: string;
+        endpointId: string;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Update an endpoint
+     */
+    updateEndpoint: (params: {
+        agentRuntimeId: string;
+        endpointId: string;
+        input: AgentRuntimeEndpointUpdateInput;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * Get an endpoint
+     */
+    getEndpoint: (params: {
+        agentRuntimeId: string;
+        endpointId: string;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint>;
+    /**
+     * List endpoints for an Agent Runtime
+     */
+    listEndpoints: (params: {
+        agentRuntimeId: string;
+        input?: AgentRuntimeEndpointListInput;
+        config?: Config;
+    }) => Promise<AgentRuntimeEndpoint[]>;
+    /**
+     * List versions for an Agent Runtime
+     */
+    listVersions: (params: {
+        agentRuntimeId: string;
+        input?: AgentRuntimeVersionListInput;
+        config?: Config;
+    }) => Promise<AgentRuntimeVersion[]>;
+    /**
+     * Invoke agent runtime using OpenAI-compatible API
+     *
+     * This method provides an OpenAI-compatible interface to invoke the agent runtime.
+     *
+     * @param params - Parameters including agent runtime name, endpoint name, and invocation args
+     * @returns OpenAI chat completion response
+     *
+     * @example
+     * ```typescript
+     * const client = new AgentRuntimeClient();
+     * const response = await client.invokeOpenai({
+     *   agentRuntimeName: "my-runtime",
+     *   agentRuntimeEndpointName: "Default",
+     *   messages: [{ role: "user", content: "Hello" }],
+     *   stream: false
+     * });
+     * ```
+     */
+    invokeOpenai: (params: {
+        agentRuntimeName: string;
+        agentRuntimeEndpointName?: string;
+    } & InvokeArgs) => Promise<(openai_core_streaming.Stream<openai_resources.ChatCompletionChunk> & {
+        _request_id?: string | null;
+    }) | (openai_resources.ChatCompletion & {
+        _request_id?: string | null;
+    })>;
+}
+
+/**
+ * Control API Base Module
+ *
+ * 此模块定义控制链路 API 的基类。
+ * This module defines the base class for control API.
+ */
+
+type Client = InstanceType<typeof $AgentRun.default>;
+/**
+ * Base class for Control API clients
+ *
+ * 提供控制链路和 DevS API 客户端的获取功能。
+ * Provides functionality to get control API and DevS API clients.
+ */
+declare class ControlAPI {
+    protected config?: Config;
+    constructor(config?: Config);
+    /**
+     * Get the underlying AgentRun client instance
+     */
+    getClient(config?: Config): Client;
+}
+
+/**
+ * This file is auto generated by the code generation script.
+ * Do not modify this file manually.
+ * Use the `bun run codegen` command to regenerate.
+ *
+ * 当前文件为自动生成的控制 API 客户端代码。请勿手动修改此文件。
+ * 使用 `bun run codegen` 命令重新生成。
+ */
+
+/**
+ * Agent Runtime Control API
+ */
+declare class AgentRuntimeControlAPI extends ControlAPI {
+    constructor(config?: Config);
+    /**
+     * Create Agent Runtime
+     *
+     * @param params - Method parameters
+     * @param params.input - Agent Runtime configuration
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Created Runtime object
+     */
+    createAgentRuntime: (params: {
+        input: $AgentRun.CreateAgentRuntimeInput;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntime>;
+    /**
+     * Delete Agent Runtime
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Deleted Runtime object
+     */
+    deleteAgentRuntime: (params: {
+        agentId: string;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntime>;
+    /**
+     * Update Agent Runtime
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.input - Agent Runtime configuration
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Updated Runtime object
+     */
+    updateAgentRuntime: (params: {
+        agentId: string;
+        input: $AgentRun.UpdateAgentRuntimeInput;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntime>;
+    /**
+     * Get Agent Runtime
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.request - Get request options
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Runtime object
+     */
+    getAgentRuntime: (params: {
+        agentId: string;
+        request?: $AgentRun.GetAgentRuntimeRequest;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntime>;
+    /**
+     * List Agent Runtimes
+     *
+     * @param params - Method parameters
+     * @param params.input - List options
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns List of Runtime objects
+     */
+    listAgentRuntimes: (params: {
+        input: $AgentRun.ListAgentRuntimesRequest;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.ListAgentRuntimesOutput>;
+    /**
+     * Create Agent Runtime Endpoint
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.input - Endpoint configuration
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Created Endpoint object
+     */
+    createAgentRuntimeEndpoint: (params: {
+        agentId: string;
+        input: $AgentRun.CreateAgentRuntimeEndpointInput;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntimeEndpoint>;
+    /**
+     * Delete Agent Runtime Endpoint
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.endpointId - Endpoint ID
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Deleted Endpoint object
+     */
+    deleteAgentRuntimeEndpoint: (params: {
+        agentId: string;
+        endpointId: string;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntimeEndpoint>;
+    /**
+     * Update Agent Runtime Endpoint
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.endpointId - Endpoint ID
+     * @param params.input - Endpoint configuration
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Updated Endpoint object
+     */
+    updateAgentRuntimeEndpoint: (params: {
+        agentId: string;
+        endpointId: string;
+        input: $AgentRun.UpdateAgentRuntimeEndpointInput;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntimeEndpoint>;
+    /**
+     * Get Agent Runtime Endpoint
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.endpointId - Endpoint ID
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Endpoint object
+     */
+    getAgentRuntimeEndpoint: (params: {
+        agentId: string;
+        endpointId: string;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.AgentRuntimeEndpoint>;
+    /**
+     * List Agent Runtime Endpoints
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.input - List options
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns List of Endpoint objects
+     */
+    listAgentRuntimeEndpoints: (params: {
+        agentId: string;
+        input: $AgentRun.ListAgentRuntimeEndpointsRequest;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.ListAgentRuntimeEndpointsOutput>;
+    /**
+     * List Agent Runtime Versions
+     *
+     * @param params - Method parameters
+     * @param params.agentId - Agent Runtime ID
+     * @param params.input - List options
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns List of Version objects
+     */
+    listAgentRuntimeVersions: (params: {
+        agentId: string;
+        input: $AgentRun.ListAgentRuntimeVersionsRequest;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.ListAgentRuntimeVersionsOutput>;
+}
+
+/**
+资源基类模板 / Resource Base Template
+
+此模板用于生成资源对象的基类代码。
+This template is used to generate base class code for resource objects.
+*/
+
+declare abstract class ResourceBase {
+    status?: Status;
+    protected _config?: Config;
+    abstract get(params?: {
+        config?: Config;
+    }): Promise<any>;
+    abstract delete(params?: {
+        config?: Config;
+    }): Promise<any>;
+    static list(_params: {
+        input?: PageableInput;
+        config?: Config;
+    }): Promise<ThisType<ResourceBase>[]>;
+    static listAll(params: {
+        uniqIdCallback: (item: any) => string;
+        input?: Record<string, any>;
+        config?: Config;
+    }): Promise<any[]>;
+    waitUntil: (params: {
+        checkFinishedCallback: (resource: ResourceBase) => Promise<boolean>;
+        intervalSeconds?: number;
+        timeoutSeconds?: number;
+    }) => Promise<ResourceBase>;
+    waitUntilReadyOrFailed: (params: {
+        callback: (resource: ResourceBase) => Promise<void>;
+        intervalSeconds?: number;
+        timeoutSeconds?: number;
+    }) => Promise<ResourceBase>;
+    delete_and_wait_until_finished: (params: {
+        callback: (resource: ResourceBase) => Promise<void>;
+        intervalSeconds?: number;
+        timeoutSeconds?: number;
+    }) => Promise<ResourceBase | undefined>;
+    refresh: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * 更新实例自身的属性 / Update instance properties
+     *
+     * @param source - 源对象 / Source object
+     */
+    updateSelf(source: any): void;
+    /**
+     * 列出所有资源（带去重）/ List all resources (with deduplication)
+     *
+     * @param uniqIdCallback - 唯一ID回调函数 / Unique ID callback function
+     * @param config - 配置 / Configuration
+     * @param kwargs - 其他查询参数 / Other query parameters
+     * @returns 资源列表 / Resource list
+     */
+    protected static listAllResources(uniqIdCallback: (item: any) => string, config?: Config, kwargs?: Record<string, any>): Promise<any[]>;
+    setConfig: (config: Config) => this;
+}
+
+/** 凭证认证类型 / Credential Authentication Types */
+type CredentialAuthType = 'jwt' | 'api_key' | 'basic' | 'aksk' | 'custom_header';
+/** 凭证来源类型 / Credential Source Types */
+type CredentialSourceType = 'external_llm' | 'external_tool' | 'internal';
+/**
+ * Credential basic authentication configuration
+ */
+interface CredentialBasicAuth {
+    /** Username */
+    username?: string;
+    /** Password */
+    password?: string;
+}
+/**
+ * Related resource for credential
+ */
+interface RelatedResource {
+    /** 资源 IDj*/
+    resourceId?: string;
+    /** 资源名称j*/
+    resourceName?: string;
+    /** 资源类型j*/
+    resourceType?: string;
+}
+interface CredentialConfigInterface {
+    /** 凭证认证类型 */
+    credentialAuthType?: CredentialAuthType;
+    /** 凭证来源类型 */
+    credentialSourceType?: CredentialSourceType;
+    /** 凭证公共配置 */
+    credentialPublicConfig?: Record<string, any>;
+    /** 凭证密钥 */
+    credentialSecret?: string;
+}
+/**
+ * 凭证配置 / Credential configuration
+ */
+declare class CredentialConfig implements CredentialConfigInterface {
+    constructor(data?: CredentialConfigInterface);
+    /** 配置访问 AgentRun 的 api key 凭证 */
+    static inboundApiKey(params: {
+        apiKey: string;
+        headerKey?: string;
+    }): CredentialConfig;
+    /** 配置访问 AgentRun 的静态 JWKS 凭证 */
+    static inboundStaticJwt(params: {
+        jwks: string;
+    }): CredentialConfig;
+    /** 配置访问 AgentRun 的远程 JWT 凭证 */
+    static inboundRemoteJwt(uri: string, timeout?: number, ttl?: number, publicConfig?: Record<string, any>): CredentialConfig;
+    /** 配置访问 AgentRun 的 Basic 凭证 */
+    static inboundBasic(params: {
+        users: CredentialBasicAuth[];
+    }): CredentialConfig;
+    /** 配置访问第三方工具的 api key 凭证 */
+    static outboundLLMApiKey(params: {
+        apiKey: string;
+        provider: string;
+    }): CredentialConfig;
+    /** 配置访问第三方工具的 ak/sk 凭证 */
+    static outboundLLMAKSK(provider: string, accessKeyId: string, accessKeySecret: string, accountId: string): CredentialConfig;
+    /** 配置访问第三方工具的自定义凭证 */
+    static outboundToolAKSKCustom(params: {
+        authConfig: Record<string, string>;
+    }): CredentialConfig;
+    /** 配置访问第三方工具的自定义 Header 凭证 */
+    static outboundToolCustomHeader(params: {
+        headers: Record<string, string>;
+    }): CredentialConfig;
+}
+/** 凭证公共配置 */
+interface CredentialMutableProps {
+    /** 描述 */
+    description?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+}
+interface CredentialImmutableProps {
+    credentialName?: string;
+}
+interface CredentialSystemProps {
+    credentialId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    relatedResources?: RelatedResource[];
+}
+interface CredentialCreateInput extends CredentialMutableProps, CredentialImmutableProps {
+    credentialConfig?: CredentialConfig;
+}
+/**
+ * Credential update input
+ */
+interface CredentialUpdateInput extends CredentialMutableProps {
+    credentialConfig?: CredentialConfig;
+}
+/**
+ * Credential list input
+ */
+interface CredentialListInput extends PageableInput {
+    credentialAuthType?: CredentialAuthType;
+    credentialName?: string;
+    credentialSourceType?: CredentialSourceType;
+    provider?: string;
+}
+declare class CredentialListOutput {
+    createdAt?: string;
+    credentialAuthType?: CredentialAuthType;
+    credentialId?: string;
+    credentialName?: string;
+    credentialSourceType?: CredentialSourceType;
+    enabled?: boolean;
+    relatedResourceCount?: number;
+    updatedAt?: string;
+    constructor(data?: any);
+    toCredential: (params?: {
+        config?: Config;
+    }) => Promise<Credential>;
+}
+/**
+ * Credential resource class
+ */
+interface CredentialInterface extends CredentialMutableProps, CredentialImmutableProps, CredentialSystemProps, CredentialConfigInterface {
+}
+
+/**
+ * Credential Resource
+ *
+ * 此模块定义 Credential 资源类。
+ * This module defines the Credential resource class.
+ */
+
+declare class Credential extends ResourceBase implements CredentialInterface {
+    credentialName?: string;
+    /** 描述 */
+    description?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+    credentialId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    relatedResources?: RelatedResource[];
+    /** 凭证认证类型 */
+    credentialAuthType?: CredentialAuthType;
+    /** 凭证来源类型 */
+    credentialSourceType?: CredentialSourceType;
+    /** 凭证公共配置 */
+    credentialPublicConfig?: Record<string, any>;
+    /** 凭证密钥 */
+    credentialSecret?: string;
+    protected _config?: Config;
+    constructor(data?: CredentialInterface, config?: Config);
+    private static getClient;
+    /**
+     * Create a new Credential
+     */
+    static create: (paramsOrInput: any) => Promise<Credential>;
+    /**
+     * Delete a Credential by name
+     */
+    static delete: (paramsOrName: any) => Promise<Credential>;
+    /**
+     * Update a Credential by name
+     */
+    static update: (paramsOrName: any) => Promise<Credential>;
+    /**
+     * Get a Credential by name
+     */
+    static get: (paramsOrName: any) => Promise<Credential>;
+    /**
+     * List all Credentials (with pagination)
+     */
+    static list: (paramsOrUndefined?: any) => Promise<CredentialListOutput[]>;
+    static listAll: (params?: {
+        input?: CredentialListInput;
+        config?: Config;
+    }) => Promise<CredentialListOutput[]>;
+    /**
+     * Delete this credential
+     */
+    delete: (params?: any) => Promise<this>;
+    /**
+     * Update this credential
+     */
+    update: (params: any) => Promise<this>;
+    /**
+     * Refresh this credential's data
+     */
+    get: (params?: any) => Promise<Credential>;
+}
+
+/**
+ * Credential Client
+ *
+ * 此模块提供 Credential 的客户端 API。
+ * This module provides the client API for Credential.
+ */
+
+/**
+ * Credential Client
+ *
+ * 提供 Credential 的创建、删除、更新、查询功能。
+ * Provides create, delete, update, query functions for Credential.
+ */
+declare class CredentialClient {
+    private config?;
+    private controlApi;
+    constructor(config?: Config);
+    /**
+     * Create a Credential
+     */
+    create: (params: {
+        input: CredentialCreateInput;
+        config?: Config;
+    }) => Promise<Credential>;
+    /**
+     * Delete a Credential
+     */
+    delete: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<Credential>;
+    /**
+     * Update a Credential
+     */
+    update: (params: {
+        name: string;
+        input: CredentialUpdateInput;
+        config?: Config;
+    }) => Promise<Credential>;
+    /**
+     * Get a Credential
+     */
+    get: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<Credential>;
+    /**
+     * List Credentials
+     */
+    list: (params: {
+        input?: CredentialListInput;
+        config?: Config;
+    }) => Promise<CredentialListOutput[]>;
+}
+
+/**
+ * This file is auto generated by the code generation script.
+ * Do not modify this file manually.
+ * Use the `bun run codegen` command to regenerate.
+ *
+ * 当前文件为自动生成的控制 API 客户端代码。请勿手动修改此文件。
+ * 使用 `bun run codegen` 命令重新生成。
+ */
+
+/**
+ * Credential Control API
+ */
+declare class CredentialControlAPI extends ControlAPI {
+    constructor(config?: Config);
+    /**
+     * Create credential
+     *
+     * @param params - Method parameters
+     * @param params.input - Credential configuration
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Created credential object
+     */
+    createCredential: (params: {
+        input: $AgentRun.CreateCredentialInput;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.Credential>;
+    /**
+     * Delete credential
+     *
+     * @param params - Method parameters
+     * @param params.credentialName - Credential name
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Deleted credential object
+     */
+    deleteCredential: (params: {
+        credentialName: string;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.Credential>;
+    /**
+     * Update credential
+     *
+     * @param params - Method parameters
+     * @param params.credentialName - Credential name
+     * @param params.input - Credential configuration
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Updated credential object
+     */
+    updateCredential: (params: {
+        credentialName: string;
+        input: $AgentRun.UpdateCredentialInput;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.Credential>;
+    /**
+     * Get credential
+     *
+     * @param params - Method parameters
+     * @param params.credentialName - Credential name
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns Credential object
+     */
+    getCredential: (params: {
+        credentialName: string;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.Credential>;
+    /**
+     * List credentials
+     *
+     * @param params - Method parameters
+     * @param params.input - List options
+     * @param params.headers - Custom request headers
+     * @param params.config - Optional config override
+     * @returns List of credential objects
+     */
+    listCredentials: (params: {
+        input: $AgentRun.ListCredentialsRequest;
+        headers?: Record<string, string>;
+        config?: Config;
+    }) => Promise<$AgentRun.ListCredentialsOutput>;
+}
+
+/**
+ * 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
+     */
+    createSandbox: (params: {
+        templateName: string;
+        sandboxIdleTimeoutSeconds?: number;
+        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>;
+}
+
+/**
+ * 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;
+    /**
+     * Get Playwright sync wrapper
+     *
+     * Note: Implementation pending - requires playwright integration
+     */
+    syncPlaywright(params?: {
+        browserType?: string;
+        record?: boolean;
+        config?: Config;
+    }): any;
+    /**
+     * Get Playwright async wrapper
+     *
+     * Note: Implementation pending - requires playwright integration
+     */
+    asyncPlaywright(params?: {
+        browserType?: string;
+        record?: boolean;
+        config?: Config;
+    }): any;
+    /**
+     * 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;
+    }>;
+}
+
+/**
+ * Sandbox Data Models
+ *
+ * 此模块定义 Sandbox 相关的所有数据模型。
+ * This module defines all data models related to Sandbox.
+ */
+
+/**
+ * Template type enum
+ */
+declare enum TemplateType {
+    CODE_INTERPRETER = "CodeInterpreter",
+    BROWSER = "Browser",
+    AIO = "AllInOne"
+}
+/**
+ * Sandbox state enum
+ */
+declare enum SandboxState {
+    CREATING = "Creating",
+    RUNNING = "Running",
+    READY = "READY",// API返回的就绪状态，等同于Running
+    STOPPED = "Stopped",
+    FAILED = "Failed",
+    DELETING = "Deleting"
+}
+/**
+ * Template network mode enum
+ */
+declare enum TemplateNetworkMode {
+    PUBLIC = "PUBLIC",
+    PRIVATE = "PRIVATE",
+    PUBLIC_AND_PRIVATE = "PUBLIC_AND_PRIVATE"
+}
+/**
+ * OSS permission enum
+ */
+declare enum TemplateOSSPermission {
+    READ_WRITE = "READ_WRITE",
+    READ_ONLY = "READ_ONLY"
+}
+/**
+ * Code language enum
+ */
+declare enum CodeLanguage {
+    PYTHON = "python"
+}
+/**
+ * Template network configuration
+ */
+interface TemplateNetworkConfiguration {
+    networkMode?: TemplateNetworkMode;
+    securityGroupId?: string;
+    vpcId?: string;
+    vswitchIds?: string[];
+}
+/**
+ * Template OSS configuration
+ */
+interface TemplateOssConfiguration {
+    bucketName: string;
+    mountPoint: string;
+    permission?: TemplateOSSPermission;
+    prefix: string;
+    region: string;
+}
+/**
+ * Template log configuration
+ */
+interface TemplateLogConfiguration {
+    project?: string;
+    logstore?: string;
+}
+/**
+ * Template credential configuration
+ */
+interface TemplateCredentialConfiguration {
+    credentialName?: string;
+}
+/**
+ * Template ARMS configuration
+ */
+interface TemplateArmsConfiguration {
+    armsLicenseKey?: string;
+    enableArms: boolean;
+}
+/**
+ * Template container configuration
+ */
+interface TemplateContainerConfiguration {
+    image?: string;
+    command?: string[];
+}
+/**
+ * Template MCP options
+ */
+interface TemplateMcpOptions {
+    enabledTools?: string[];
+    transport?: string;
+}
+/**
+ * Template MCP state
+ */
+interface TemplateMcpState {
+    accessEndpoint?: string;
+    status?: string;
+    statusReason?: string;
+}
+/**
+ * Template create input
+ */
+interface TemplateCreateInput {
+    templateName?: string;
+    templateType: TemplateType;
+    cpu?: number;
+    memory?: number;
+    executionRoleArn?: string;
+    sandboxIdleTimeoutInSeconds?: number;
+    sandboxTtlInSeconds?: number;
+    shareConcurrencyLimitPerSandbox?: number;
+    templateConfiguration?: Record<string, unknown>;
+    description?: string;
+    environmentVariables?: Record<string, string>;
+    networkConfiguration?: TemplateNetworkConfiguration;
+    ossConfiguration?: TemplateOssConfiguration[];
+    logConfiguration?: TemplateLogConfiguration;
+    credentialConfiguration?: TemplateCredentialConfiguration;
+    armsConfiguration?: TemplateArmsConfiguration;
+    containerConfiguration?: TemplateContainerConfiguration;
+    diskSize?: number;
+}
+/**
+ * Template update input
+ */
+interface TemplateUpdateInput {
+    cpu?: number;
+    memory?: number;
+    executionRoleArn?: string;
+    sandboxIdleTimeoutInSeconds?: number;
+    sandboxTtlInSeconds?: number;
+    shareConcurrencyLimitPerSandbox?: number;
+    description?: string;
+    environmentVariables?: Record<string, string>;
+    networkConfiguration?: TemplateNetworkConfiguration;
+    ossConfiguration?: TemplateOssConfiguration[];
+    logConfiguration?: TemplateLogConfiguration;
+    credentialConfiguration?: TemplateCredentialConfiguration;
+    armsConfiguration?: TemplateArmsConfiguration;
+    containerConfiguration?: TemplateContainerConfiguration;
+    diskSize?: number;
+}
+/**
+ * Template list input
+ */
+interface TemplateListInput extends PageableInput {
+    templateType?: TemplateType;
+}
+/**
+ * Sandbox create input
+ */
+interface SandboxCreateInput {
+    templateName: string;
+    sandboxIdleTimeoutSeconds?: number;
+}
+/**
+ * Sandbox list input
+ */
+interface SandboxListInput {
+    maxResults?: number;
+    nextToken?: string;
+    status?: string;
+    templateName?: string;
+    templateType?: TemplateType;
+}
+/**
+ * Template data
+ */
+interface TemplateData {
+    templateArn?: string;
+    templateId?: string;
+    templateName?: string;
+    templateType?: TemplateType;
+    cpu?: number;
+    memory?: number;
+    createdAt?: string;
+    description?: string;
+    executionRoleArn?: string;
+    lastUpdatedAt?: string;
+    resourceName?: string;
+    sandboxIdleTimeoutInSeconds?: number;
+    sandboxTtlInSeconds?: number;
+    shareConcurrencyLimitPerSandbox?: number;
+    status?: Status;
+    statusReason?: string;
+    diskSize?: number;
+}
+/**
+ * Sandbox data
+ */
+interface SandboxData {
+    sandboxId?: string;
+    sandboxName?: string;
+    templateId?: string;
+    templateName?: string;
+    state?: SandboxState;
+    stateReason?: string;
+    createdAt?: string;
+    lastUpdatedAt?: string;
+    sandboxIdleTimeoutSeconds?: number;
+}
+/**
+ * Code execution result
+ */
+interface ExecuteCodeResult {
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+    error?: string;
+}
+/**
+ * File info
+ */
+interface FileInfo {
+    name: string;
+    path: string;
+    size?: number;
+    isDirectory?: boolean;
+    modifiedAt?: string;
+}
+
+/**
+ * Base Sandbox Resource
+ *
+ * 此模块定义基础 Sandbox 资源类。
+ * This module defines the base Sandbox resource class.
+ */
+
+/**
+ * Base Sandbox resource class
+ */
+declare class Sandbox implements SandboxData {
+    sandboxId?: string;
+    sandboxName?: string;
+    templateId?: string;
+    templateName?: string;
+    state?: SandboxState;
+    stateReason?: string;
+    createdAt?: string;
+    lastUpdatedAt?: string;
+    sandboxIdleTimeoutSeconds?: number;
+    protected _config?: Config;
+    constructor(data?: Partial<SandboxData>, config?: Config);
+    /**
+     * Create sandbox from SDK response object
+     */
+    static fromInnerObject(obj: any, config?: Config): Sandbox;
+    protected static getClient(config?: Config): $AgentRun.default;
+    /**
+     * Create a new Sandbox
+     */
+    static create(input: SandboxCreateInput, config?: Config): Promise<Sandbox>;
+    /**
+     * Delete a Sandbox by ID
+     */
+    static delete(params: {
+        id: string;
+        config?: Config;
+    }): Promise<Sandbox>;
+    /**
+     * Stop a Sandbox by ID
+     */
+    static stop(params: {
+        id: string;
+        config?: Config;
+    }): Promise<Sandbox>;
+    /**
+     * Get a Sandbox by ID
+     */
+    static get(params: {
+        id: string;
+        config?: Config;
+    }): Promise<Sandbox>;
+    /**
+     * List Sandboxes
+     */
+    static list(input?: SandboxListInput, config?: Config): Promise<Sandbox[]>;
+    /**
+     * Handle API errors
+     */
+    protected static handleError(error: unknown): never;
+    /**
+     * 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>;
+}
+
+/**
+ * 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
+     */
+    static createFromTemplate(templateName: string, options?: {
+        sandboxIdleTimeoutSeconds?: number;
+    }, 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;
+    }>;
+    /**
+     * Wait for browser sandbox to be ready (polls health check)
+     */
+    waitUntilReady: (params?: {
+        maxRetries?: number;
+        retryIntervalMs?: number;
+    }) => Promise<void>;
+    /**
+     * Get CDP WebSocket URL for browser automation
+     */
+    getCdpUrl(record?: boolean): string;
+    /**
+     * Get VNC WebSocket URL for live view
+     */
+    getVncUrl(record?: boolean): string;
+    /**
+     * Get Playwright sync wrapper
+     *
+     * Note: Implementation pending - requires playwright integration
+     */
+    syncPlaywright(params?: {
+        browserType?: string;
+        record?: boolean;
+        config?: Config;
+    }): any;
+    /**
+     * Get Playwright async wrapper
+     *
+     * Note: Implementation pending - requires playwright integration
+     */
+    asyncPlaywright(params?: {
+        browserType?: string;
+        record?: boolean;
+        config?: Config;
+    }): any;
+    /**
+     * 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 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;
+    }>;
+}
+
+/**
+ * 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
+     */
+    static createFromTemplate(templateName: string, options?: {
+        sandboxIdleTimeoutSeconds?: number;
+    }, 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;
+    }>;
+    /**
+     * Wait for sandbox to be ready (polls health check)
+     */
+    waitUntilReady: (params?: {
+        maxRetries?: number;
+        retryIntervalMs?: number;
+    }) => Promise<void>;
+    /**
+     * 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
+ */
+declare class Template implements TemplateData {
+    templateArn?: string;
+    templateId?: string;
+    templateName?: string;
+    templateType?: TemplateType;
+    cpu?: number;
+    memory?: number;
+    createdAt?: string;
+    description?: string;
+    executionRoleArn?: string;
+    lastUpdatedAt?: string;
+    resourceName?: string;
+    sandboxIdleTimeoutInSeconds?: number;
+    sandboxTtlInSeconds?: number;
+    shareConcurrencyLimitPerSandbox?: number;
+    status?: Status;
+    statusReason?: string;
+    diskSize?: number;
+    private _config?;
+    constructor(data?: Partial<TemplateData>, config?: Config);
+    /**
+     * Create template from SDK response object
+     */
+    static fromInnerObject(obj: $AgentRun.Template, config?: Config): Template;
+    private static getClient;
+    /**
+     * Create a new Template
+     */
+    static create(params: {
+        input: TemplateCreateInput;
+        config?: Config;
+    }): Promise<Template>;
+    /**
+     * Get defaults based on template type
+     */
+    private static getDefaults;
+    /**
+     * Validate template configuration
+     */
+    private static validate;
+    /**
+     * 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(input?: TemplateListInput, config?: Config): Promise<Template[]>;
+    /**
+     * List all Templates (with pagination)
+     */
+    static listAll(options?: {
+        templateType?: TemplateType;
+    }, config?: Config): Promise<Template[]>;
+    /**
+     * Handle API errors
+     */
+    private static handleError;
+    /**
+     * 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>;
+    /**
+     * Wait until the template is ready
+     */
+    waitUntilReady: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (template: Template) => void;
+    }, config?: Config) => Promise<Template>;
+}
+
+/**
+ * Sandbox Client
+ *
+ * 此模块提供 Sandbox 的客户端 API。
+ * This module provides the client API for Sandbox.
+ */
+
+/**
+ * Sandbox Client
+ *
+ * 提供 Sandbox 和 Template 的管理功能。
+ */
+declare class SandboxClient {
+    private config?;
+    constructor(config?: Config);
+    /**
+     * Create a Template
+     */
+    createTemplate: (params: {
+        input: TemplateCreateInput;
+        config?: Config;
+    }) => Promise<Template>;
+    /**
+     * Delete a Template
+     */
+    deleteTemplate: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<Template>;
+    /**
+     * Update a Template
+     */
+    updateTemplate: (params: {
+        name: string;
+        input: TemplateUpdateInput;
+        config?: Config;
+    }) => Promise<Template>;
+    /**
+     * Get a Template
+     */
+    getTemplate: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<Template>;
+    /**
+     * List Templates
+     */
+    listTemplates: (params?: {
+        input?: TemplateListInput;
+        config?: Config;
+    }) => Promise<Template[]>;
+    /**
+     * List all Templates
+     */
+    listAllTemplates: (params?: {
+        options?: {
+            templateType?: TemplateType;
+        };
+        config?: Config;
+    }) => Promise<Template[]>;
+    /**
+     * Create a Sandbox
+     */
+    createSandbox: (params: {
+        input: SandboxCreateInput;
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * Create a Code Interpreter Sandbox
+     */
+    createCodeInterpreterSandbox: (params: {
+        templateName: string;
+        options?: {
+            sandboxIdleTimeoutSeconds?: number;
+        };
+        config?: Config;
+    }) => Promise<CodeInterpreterSandbox>;
+    /**
+     * Create a Browser Sandbox
+     */
+    createBrowserSandbox: (params: {
+        templateName: string;
+        options?: {
+            sandboxIdleTimeoutSeconds?: number;
+        };
+        config?: Config;
+    }) => Promise<BrowserSandbox>;
+    /**
+     * Delete a Sandbox
+     */
+    deleteSandbox: (params: {
+        id: string;
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * Stop a Sandbox
+     */
+    stopSandbox: (params: {
+        id: string;
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * Get a Sandbox
+     */
+    getSandbox: (params: {
+        id: string;
+        config?: Config;
+    }) => Promise<Sandbox>;
+    /**
+     * List Sandboxes
+     */
+    listSandboxes: (params?: {
+        input?: SandboxListInput;
+        config?: Config;
+    }) => Promise<Sandbox[]>;
+}
+
+/**
+ * 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;
+    }>;
+}
+
+/**
+ * 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
+     */
+    static createFromTemplate(templateName: string, options?: {
+        sandboxIdleTimeoutSeconds?: number;
+    }, 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;
+    }>;
+    /**
+     * Wait for sandbox to be ready (polls health check)
+     */
+    waitUntilReady: (params?: {
+        maxRetries?: number;
+        retryIntervalMs?: number;
+    }) => Promise<void>;
+    /**
+     * 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>;
+}
+
+/**
+ * Model Service Data Models
+ *
+ * 此模块定义 Model Service 相关的所有数据模型。
+ * This module defines all data models related to Model Service.
+ */
+
+/**
+ * Backend type enum
+ */
+type BackendType = 'proxy' | 'service';
+declare const BackendType: {
+    PROXY: BackendType;
+    SERVICE: BackendType;
+};
+/**
+ * Model type enum
+ */
+type ModelType = 'llm' | 'text-embedding' | 'speech2text' | 'tts' | 'rerank' | 'moderation';
+declare const ModelType: {
+    LLM: ModelType;
+    TEXT_EMBEDDING: ModelType;
+    SPEECH2TEXT: ModelType;
+    TTS: ModelType;
+    RERANK: ModelType;
+    MODERATION: ModelType;
+};
+/**
+ * Provider enum
+ */
+type Provider = 'openai' | 'anthropic' | 'baichuan' | 'deepseek' | 'gemini' | 'hunyuan' | 'minimax' | 'moonshot' | 'spark' | 'stepfun' | 'tongyi' | 'vertex_ai' | 'wenxin' | 'yi' | 'zhipuai' | 'custom';
+declare const Provider: {
+    OPENAI: Provider;
+    ANTHROPIC: Provider;
+    BAICHUAN: Provider;
+    DEEPSEEK: Provider;
+    GEMINI: Provider;
+    HUNYUAN: Provider;
+    MINIMAX: Provider;
+    MOONSHOT: Provider;
+    SPARK: Provider;
+    STEPFUN: Provider;
+    TONGYI: Provider;
+    VERTEX_AI: Provider;
+    WENXIN: Provider;
+    YI: Provider;
+    ZHIPUAI: Provider;
+    CUSTOM: Provider;
+};
+type ProxyMode = 'single' | 'multi';
+declare const ProxyMode: {
+    SINGLE: ProxyMode;
+    MULTI: ProxyMode;
+};
+/**
+ * Provider settings
+ */
+interface ProviderSettings {
+    apiKey?: string;
+    baseUrl?: string;
+    modelNames?: string[];
+}
+/**
+ * Model features
+ */
+interface ModelFeatures {
+    agentThought?: boolean;
+    multiToolCall?: boolean;
+    streamToolCall?: boolean;
+    toolCall?: boolean;
+    vision?: boolean;
+}
+/**
+ * Model properties
+ */
+interface ModelProperties {
+    contextSize?: number;
+}
+/**
+ * Model parameter rule
+ */
+interface ModelParameterRule {
+    default?: unknown;
+    max?: number;
+    min?: number;
+    name?: string;
+    required?: boolean;
+    type?: string;
+}
+/**
+ * Model info config
+ */
+interface ModelInfoConfig {
+    modelName?: string;
+    modelFeatures?: ModelFeatures;
+    modelProperties?: ModelProperties;
+    modelParameterRules?: ModelParameterRule[];
+}
+/**
+ * Proxy config endpoint
+ */
+interface ProxyConfigEndpoint {
+    baseUrl?: string;
+    modelNames?: string[];
+    modelServiceName?: string;
+    weight?: number;
+}
+/**
+ * Proxy config fallback
+ */
+interface ProxyConfigFallback {
+    modelName?: string;
+    modelServiceName?: string;
+}
+interface ProxyConfigTokenRateLimiter {
+    tps?: number;
+    tpm?: number;
+    tph?: number;
+    tpd?: number;
+}
+interface ProxyConfigAIGuardrailConfig {
+    checkRequest?: boolean;
+    checkResponse?: boolean;
+}
+/**
+ * Proxy config policies
+ */
+interface ProxyConfigPolicies {
+    cache?: boolean;
+    concurrencyLimit?: number;
+    fallbacks?: ProxyConfigFallback[];
+    numRetries?: number;
+    requestTimeout?: number;
+    aiGuardrailConfig?: ProxyConfigAIGuardrailConfig;
+    tokenRateLimiter?: ProxyConfigTokenRateLimiter;
+}
+/**
+ * Proxy config
+ */
+interface ProxyConfig {
+    endpoints?: ProxyConfigEndpoint[];
+    policies?: ProxyConfigPolicies;
+}
+interface CommonModelMutableProps {
+    credentialName?: string;
+    description?: string;
+    networkConfiguration?: NetworkConfig;
+    tags?: string[];
+}
+interface CommonModelImmutableProps {
+    modelType?: ModelType;
+}
+interface CommonModelSystemProps {
+    createdAt?: string;
+    lastUpdatedAt?: string;
+    status?: Status;
+}
+interface ModelServiceMutableProps extends CommonModelMutableProps {
+    providerSettings?: ProviderSettings;
+}
+interface ModelServiceImmutableProps extends CommonModelImmutableProps {
+    modelInfoConfigs?: ModelInfoConfig[];
+    modelServiceName?: string;
+    provider?: string;
+}
+interface ModelServiceSystemProps extends CommonModelSystemProps {
+    modelServiceId?: string;
+}
+interface ModelProxyMutableProps extends CommonModelMutableProps {
+    cpu?: number;
+    litellmVersion?: string;
+    memory?: number;
+    modelProxyName?: string;
+    proxyModel?: ProxyMode;
+    serviceRegionId?: string;
+    proxyConfig?: ProxyConfig;
+    executionRoleArn?: string;
+}
+interface ModelProxyImmutableProps extends CommonModelImmutableProps {
+}
+interface ModelProxySystemProps extends CommonModelSystemProps {
+    endpoint?: string;
+    functionName?: string;
+    modelProxyId?: string;
+}
+interface ModelServiceCreateInput extends ModelServiceImmutableProps, ModelServiceMutableProps {
+}
+interface ModelServiceUpdateInput extends ModelServiceMutableProps {
+}
+interface ModelServiceListInput extends PageableInput {
+    modelServiceName?: string;
+    modelType?: ModelType;
+    provider?: string;
+}
+/**
+ * Model proxy create input
+ */
+interface ModelProxyCreateInput extends ModelServiceImmutableProps, ModelProxyMutableProps {
+}
+/**
+ * Model proxy update input
+ */
+interface ModelProxyUpdateInput extends ModelServiceMutableProps {
+    proxyModel?: string;
+    executionRoleArn?: string;
+}
+/**
+ * Model proxy list input
+ */
+interface ModelProxyListInput extends PageableInput {
+    modelProxyName?: string;
+    proxyMode?: string;
+    status?: Status;
+}
+
+/**
+ * Model Proxy 高层 API / Model Proxy High-Level API
+ *
+ * 此模块定义模型代理资源的高级API。
+ * This module defines the high-level API for model proxy resources.
+ */
+
+/**
+ * 模型代理 / Model Proxy
+ */
+declare class ModelProxy extends ResourceBase implements ModelProxyImmutableProps, ModelProxyMutableProps, ModelProxySystemProps {
+    modelType?: ModelProxyImmutableProps['modelType'];
+    credentialName?: string;
+    description?: string;
+    networkConfiguration?: ModelProxyMutableProps['networkConfiguration'];
+    tags?: string[];
+    cpu?: number;
+    litellmVersion?: string;
+    memory?: number;
+    modelProxyName?: string;
+    proxyModel?: ProxyMode;
+    serviceRegionId?: string;
+    proxyConfig?: ModelProxyMutableProps['proxyConfig'];
+    executionRoleArn?: string;
+    endpoint?: string;
+    functionName?: string;
+    modelProxyId?: string;
+    createdAt?: string;
+    lastUpdatedAt?: string;
+    status?: ModelProxySystemProps['status'];
+    /**
+     * 获取客户端 / Get client
+     *
+     * @returns ModelClient 实例
+     */
+    private static getClient;
+    /**
+     * 创建模型代理 / Create model proxy
+     *
+     * @param params - 参数 / Parameters
+     * @returns 创建的模型代理对象 / Created model proxy object
+     */
+    static create(params: {
+        input: ModelProxyCreateInput;
+        config?: Config;
+    }): Promise<ModelProxy>;
+    /**
+     * 根据名称删除模型代理 / Delete model proxy by name
+     *
+     * @param params - 参数 / Parameters
+     * @returns 删除的模型代理对象 / Deleted model proxy object
+     */
+    static delete(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ModelProxy>;
+    /**
+     * 根据名称更新模型代理 / Update model proxy by name
+     *
+     * @param params - 参数 / Parameters
+     * @returns 更新后的模型代理对象 / Updated model proxy object
+     */
+    static update(params: {
+        name: string;
+        input: ModelProxyUpdateInput;
+        config?: Config;
+    }): Promise<ModelProxy>;
+    /**
+     * 根据名称获取模型代理 / Get model proxy by name
+     *
+     * @param params - 参数 / Parameters
+     * @returns 模型代理对象 / Model proxy object
+     */
+    static get(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ModelProxy>;
+    /**
+     * 列出模型代理（分页）/ List model proxies (paginated)
+     *
+     * @param pageInput - 分页参数 / Pagination parameters
+     * @param config - 配置 / Configuration
+     * @param kwargs - 其他查询参数 / Other query parameters
+     * @returns 模型代理列表 / Model proxy list
+     */
+    protected static listPage(pageInput: PageableInput, config?: Config, kwargs?: Partial<ModelProxyListInput>): Promise<ModelProxy[]>;
+    /**
+     * 列出所有模型代理 / List all model proxies
+     *
+     * @param options - 查询选项 / Query options
+     * @param config - 配置 / Configuration
+     * @returns 模型代理列表 / Model proxy list
+     */
+    static listAll(options?: {
+        proxyMode?: string;
+        status?: Status;
+        config?: Config;
+    }): Promise<ModelProxy[]>;
+    /**
+     * 更新模型代理 / Update model proxy
+     *
+     * @param input - 模型代理更新输入参数 / Model proxy update input parameters
+     * @param config - 配置 / Configuration
+     * @returns 更新后的模型代理对象 / Updated model proxy object
+     */
+    update: (params: {
+        input: ModelProxyUpdateInput;
+        config?: Config;
+    }) => Promise<ModelProxy>;
+    /**
+     * 删除模型代理 / Delete model proxy
+     *
+     * @param params - 参数 / Parameters
+     * @returns 删除的模型代理对象 / Deleted model proxy object
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<ModelProxy>;
+    /**
+     * 刷新模型代理信息 / Refresh model proxy information
+     *
+     * @param params - 参数 / Parameters
+     * @returns 刷新后的模型代理对象 / Refreshed model proxy object
+     */
+    get: (params?: {
+        config?: Config;
+    }) => Promise<ModelProxy>;
+    /**
+     * 获取模型信息 / Get model information
+     *
+     * @param params - 参数 / Parameters
+     * @param params.config - 配置 / Configuration
+     * @returns 模型基本信息 / Model base information
+     */
+    modelInfo: (params?: {
+        config?: Config;
+    }) => Promise<{
+        apiKey: string;
+        baseUrl: string;
+        model?: string;
+        headers?: Record<string, string>;
+    }>;
+    /**
+     * 调用模型完成 / Call model completion
+     *
+     * @param params - 参数 / Parameters
+     * @returns 完成结果 / Completion result
+     */
+    completions: (params: {
+        messages: any[];
+        model?: string;
+        stream?: boolean;
+        config?: Config;
+        [key: string]: any;
+    }) => Promise<any>;
+    /**
+     * 获取响应 / Get responses
+     *
+     * @param params - 参数 / Parameters
+     * @returns 响应结果 / Response result
+     */
+    responses: (params: {
+        messages: any[];
+        model?: string;
+        stream?: boolean;
+        config?: Config;
+        [key: string]: any;
+    }) => Promise<any>;
+    /**
+     * 等待模型代理就绪 / Wait until model proxy is ready
+     *
+     * @param options - 选项 / Options
+     * @param config - 配置 / Configuration
+     * @returns 模型代理对象 / Model proxy object
+     */
+    waitUntilReady: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (proxy: ModelProxy) => void;
+    }, config?: Config) => Promise<ModelProxy>;
+}
+
+/**
+ * Model Service 高层 API / Model Service High-Level API
+ *
+ * 此模块定义模型服务资源的高级API。
+ * This module defines the high-level API for model service resources.
+ */
+
+/**
+ * 模型服务 / Model Service
+ */
+declare class ModelService extends ResourceBase implements ModelServiceImmutableProps, ModelServiceMutableProps, ModelServiceSystemProps {
+    modelInfoConfigs?: ModelServiceImmutableProps['modelInfoConfigs'];
+    modelServiceName?: string;
+    provider?: string;
+    credentialName?: string;
+    description?: string;
+    networkConfiguration?: ModelServiceMutableProps['networkConfiguration'];
+    tags?: string[];
+    providerSettings?: ModelServiceMutableProps['providerSettings'];
+    modelServiceId?: string;
+    createdAt?: string;
+    lastUpdatedAt?: string;
+    status?: ModelServiceSystemProps['status'];
+    modelType?: ModelServiceImmutableProps['modelType'];
+    /**
+     * 获取客户端 / Get client
+     *
+     * @returns ModelClient 实例
+     */
+    private static getClient;
+    /**
+     * 创建模型服务 / Create model service
+     *
+     * @param params - 参数 / Parameters
+     * @returns 创建的模型服务对象 / Created model service object
+     */
+    static create(params: {
+        input: ModelServiceCreateInput;
+        config?: Config;
+    }): Promise<ModelService>;
+    /**
+     * 根据名称删除模型服务 / Delete model service by name
+     *
+     * @param params - 参数 / Parameters
+     * @returns 删除的模型服务对象 / Deleted model service object
+     */
+    static delete(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ModelService>;
+    /**
+     * 根据名称更新模型服务 / Update model service by name
+     *
+     * @param params - 参数 / Parameters
+     * @returns 更新后的模型服务对象 / Updated model service object
+     */
+    static update(params: {
+        name: string;
+        input: ModelServiceUpdateInput;
+        config?: Config;
+    }): Promise<ModelService>;
+    /**
+     * 根据名称获取模型服务 / Get model service by name
+     *
+     * @param params - 参数 / Parameters
+     * @returns 模型服务对象 / Model service object
+     */
+    static get(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ModelService>;
+    /**
+     * 列出模型服务（分页）/ List model services (paginated)
+     *
+     * @param pageInput - 分页参数 / Pagination parameters
+     * @param config - 配置 / Configuration
+     * @param kwargs - 其他查询参数 / Other query parameters
+     * @returns 模型服务列表 / Model service list
+     */
+    protected static listPage(pageInput: PageableInput, config?: Config, kwargs?: Partial<ModelServiceListInput>): Promise<ModelService[]>;
+    /**
+     * 列出所有模型服务 / List all model services
+     *
+     * @param options - 查询选项 / Query options
+     * @param config - 配置 / Configuration
+     * @returns 模型服务列表 / Model service list
+     */
+    static listAll(options?: {
+        modelType?: ModelType;
+        provider?: string;
+        config?: Config;
+    }): Promise<ModelService[]>;
+    /**
+     * 更新模型服务 / Update model service
+     *
+     * @param params - 参数 / Parameters
+     * @returns 更新后的模型服务对象 / Updated model service object
+     */
+    update: (params: {
+        input: ModelServiceUpdateInput;
+        config?: Config;
+    }) => Promise<ModelService>;
+    /**
+     * 删除模型服务 / Delete model service
+     *
+     * @param config - 配置 / Configuration
+     * @returns 删除的模型服务对象 / Deleted model service object
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<ModelService>;
+    /**
+     * 刷新模型服务信息 / Refresh model service information
+     *
+     * @param config - 配置 / Configuration
+     * @returns 刷新后的模型服务对象 / Refreshed model service object
+     */
+    get: (params?: {
+        config?: Config;
+    }) => Promise<ModelService>;
+    /**
+     * 获取模型信息 / Get model information
+     *
+     * @param params - 参数 / Parameters
+     * @param params.config - 配置 / Configuration
+     * @returns 模型基本信息 / Model base information
+     */
+    modelInfo: (params?: {
+        config?: Config;
+    }) => Promise<{
+        apiKey: string;
+        baseUrl: string;
+        model?: string;
+        headers?: Record<string, string>;
+        provider?: string;
+    }>;
+    /**
+     * 调用模型完成 / Call model completion
+     *
+     * @param messages - 消息列表 / Message list
+     * @param model - 模型名称（可选）/ Model name (optional)
+     * @param stream - 是否流式输出 / Whether to stream output
+     * @param kwargs - 其他参数 / Other parameters
+     * @returns 完成结果 / Completion result
+     */
+    completions: (params: {
+        messages: any[];
+        model?: string;
+        stream?: boolean;
+        config?: Config;
+        [key: string]: any;
+    }) => Promise<any>;
+    /**
+     * 获取响应 / Get responses
+     *
+     * @param input - 输入 / Input
+     * @param model - 模型名称（可选）/ Model name (optional)
+     * @param stream - 是否流式输出 / Whether to stream output
+     * @param kwargs - 其他参数 / Other parameters
+     * @returns 响应结果 / Response result
+     */
+    responses: (params: {
+        input: string | any;
+        model?: string;
+        stream?: boolean;
+        config?: Config;
+        [key: string]: any;
+    }) => Promise<any>;
+    /**
+     * 等待模型服务就绪 / Wait until model service is ready
+     *
+     * @param options - 选项 / Options
+     * @param config - 配置 / Configuration
+     * @returns 模型服务对象 / Model service object
+     */
+    waitUntilReady: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (service: ModelService) => void;
+    }, config?: Config) => Promise<ModelService>;
+}
+
+/**
+ * Model Service 客户端 / Model Service Client
+ *
+ * 此模块提供模型服务和模型代理的客户端API。
+ * This module provides the client API for model services and model proxies.
+ */
+
+/**
+ * Model Service 客户端 / Model Service Client
+ *
+ * 提供模型服务和模型代理的创建、删除、更新和查询功能。
+ * Provides create, delete, update and query functions for model services and model proxies.
+ */
+declare class ModelClient {
+    private controlApi;
+    private config?;
+    /**
+     * 初始化客户端 / Initialize client
+     *
+     * @param config - 配置对象,可选 / Configuration object, optional
+     */
+    constructor(config?: Config);
+    /**
+     * 创建模型服务
+     * Create model service
+     *
+     * @param params - 参数 / Parameters
+     * @returns 创建的对象 / Created object
+     */
+    create: (params: {
+        input: ModelServiceCreateInput | ModelProxyCreateInput;
+        config?: Config;
+    }) => Promise<ModelService | ModelProxy>;
+    /**
+     * 删除模型服务
+     * Delete model service
+     *
+     * @param params - 参数 / Parameters
+     * @returns 删除的对象 / Deleted object
+     *
+     * @throws ResourceNotExistError - 模型服务不存在 / Model service does not exist
+     */
+    delete: (params: {
+        name: string;
+        backendType?: BackendType;
+        config?: Config;
+    }) => Promise<ModelService | ModelProxy>;
+    /**
+     * 更新模型服务
+     * Update model service
+     *
+     * @param params - 参数 / Parameters
+     * @returns 更新后的模型服务对象 / Updated model service object
+     *
+     * @throws ResourceNotExistError - 模型服务不存在 / Model service does not exist
+     */
+    update: (params: {
+        name: string;
+        input: ModelServiceUpdateInput | ModelProxyUpdateInput;
+        config?: Config;
+    }) => Promise<ModelService | ModelProxy>;
+    /**
+     * 获取模型服务
+     * Get model service
+     *
+     * @param params - 参数 / Parameters
+     * @returns 模型服务对象 / Model service object
+     *
+     * @throws ResourceNotExistError - 模型服务不存在 / Model service does not exist
+     */
+    get: (params: {
+        name: string;
+        backendType?: BackendType;
+        config?: Config;
+    }) => Promise<ModelService | ModelProxy>;
+    /**
+     * 列出模型服务
+     * List model services
+     *
+     * @param params - 参数 / Parameters
+     * @returns 模型服务列表 / Model service list
+     */
+    list: (params: {
+        input: ModelServiceListInput | ModelProxyListInput;
+        config?: Config;
+    }) => Promise<ModelService[] | ModelProxy[]>;
+}
+
+/**
+ * ToolSet Models
+ *
+ * ToolSet 相关的数据模型。
+ * Data models for ToolSet.
+ */
+
+/**
+ * ToolSet schema type
+ */
+declare enum ToolSetSchemaType {
+    OPENAPI = "OpenAPI",
+    MCP = "MCP"
+}
+/**
+ * ToolSet schema
+ */
+interface ToolSetSchema {
+    /**
+     * Schema type (OpenAPI, MCP)
+     */
+    type?: ToolSetSchemaType;
+    /**
+     * Schema detail (URL or inline definition)
+     */
+    detail?: string;
+}
+/**
+ * ToolSet authorization configuration
+ */
+interface ToolSetAuthorization {
+    /**
+     * Authorization type
+     */
+    type?: string;
+    /**
+     * API Key header name
+     */
+    apiKeyHeaderName?: string;
+    /**
+     * API Key value
+     */
+    apiKeyValue?: string;
+}
+/**
+ * ToolSet specification
+ */
+interface ToolSetSpec {
+    /**
+     * Schema configuration
+     */
+    schema?: ToolSetSchema;
+    /**
+     * Authorization configuration
+     */
+    authConfig?: ToolSetAuthorization;
+}
+/**
+ * MCP Tool meta
+ */
+interface MCPToolMeta {
+    /**
+     * Tool name
+     */
+    name?: string;
+    /**
+     * Tool description
+     */
+    description?: string;
+}
+/**
+ * ToolSet status outputs
+ */
+interface ToolSetStatusOutputs {
+    /**
+     * MCP server configuration
+     */
+    mcpServerConfig?: {
+        url?: string;
+        transport?: string;
+    };
+    /**
+     * Tools list
+     */
+    tools?: MCPToolMeta[];
+    /**
+     * URLs
+     */
+    urls?: {
+        cdpUrl?: string;
+        liveViewUrl?: string;
+        streamUrl?: string;
+    };
+}
+/**
+ * ToolSet status
+ */
+interface ToolSetStatus {
+    /**
+     * Current status
+     */
+    status?: Status;
+    /**
+     * Status reason
+     */
+    statusReason?: string;
+    /**
+     * Outputs
+     */
+    outputs?: ToolSetStatusOutputs;
+}
+/**
+ * ToolSet data interface
+ */
+interface ToolSetData {
+    name?: string;
+    uid?: string;
+    kind?: string;
+    description?: string;
+    createdTime?: string;
+    generation?: number;
+    labels?: Record<string, string>;
+    spec?: ToolSetSpec;
+    status?: ToolSetStatus;
+}
+/**
+ * ToolSet create input
+ */
+interface ToolSetCreateInput {
+    /**
+     * ToolSet name (required)
+     */
+    name: string;
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Labels
+     */
+    labels?: Record<string, string>;
+    /**
+     * Spec configuration
+     */
+    spec?: ToolSetSpec;
+}
+/**
+ * ToolSet update input
+ */
+interface ToolSetUpdateInput {
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Labels
+     */
+    labels?: Record<string, string>;
+    /**
+     * Spec configuration
+     */
+    spec?: ToolSetSpec;
+}
+/**
+ * ToolSet list input
+ */
+interface ToolSetListInput {
+    /**
+     * Prefix filter
+     */
+    prefix?: string;
+    /**
+     * Page size
+     */
+    pageSize?: number;
+    /**
+     * Next token for pagination
+     */
+    nextToken?: string;
+    /**
+     * Labels filter
+     */
+    labels?: Record<string, string>;
+}
+
+/**
+ * ToolSet Resource Class
+ *
+ * ToolSet 资源类，用于管理 ToolSet 资源。
+ * Resource class for managing ToolSet resources.
+ */
+
+/**
+ * ToolSet resource class
+ */
+declare class ToolSet implements ToolSetData {
+    name?: string;
+    uid?: string;
+    kind?: string;
+    description?: string;
+    createdTime?: string;
+    generation?: number;
+    labels?: Record<string, string>;
+    spec?: ToolSetSpec;
+    status?: ToolSetStatus;
+    private _config?;
+    constructor(data?: Partial<ToolSetData>, config?: Config);
+    /**
+     * Get ToolSet name (alias for name)
+     */
+    get toolSetName(): string | undefined;
+    /**
+     * Get ToolSet ID (alias for uid)
+     */
+    get toolSetId(): string | undefined;
+    /**
+     * Check if the toolset is ready
+     */
+    get isReady(): boolean;
+    /**
+     * Create toolset from SDK response object
+     */
+    static fromInnerObject(obj: $Devs.Toolset, config?: Config): ToolSet;
+    /**
+     * Get DevS client
+     */
+    private static getClient;
+    /**
+     * Create a new ToolSet
+     */
+    static create(params: {
+        input: ToolSetCreateInput;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * Delete a ToolSet by Name
+     */
+    static delete(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * Get a ToolSet by Name
+     */
+    static get(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * List ToolSets
+     */
+    static list(input?: ToolSetListInput, config?: Config): Promise<ToolSet[]>;
+    /**
+     * List all ToolSets with pagination
+     */
+    static listAll(options?: {
+        prefix?: string;
+        labels?: Record<string, string>;
+    }, config?: Config): Promise<ToolSet[]>;
+    /**
+     * Update a ToolSet by Name
+     */
+    static update(params: {
+        name: string;
+        input: ToolSetUpdateInput;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * Handle API errors
+     */
+    private static handleError;
+    /**
+     * Delete this toolset
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Update this toolset
+     */
+    update: (params: {
+        input: ToolSetUpdateInput;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Refresh this toolset's data
+     */
+    refresh: (params?: {
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Wait until the toolset is ready
+     */
+    waitUntilReady: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (toolset: ToolSet) => void;
+    }, config?: Config) => Promise<ToolSet>;
+    /**
+     * Get toolset type
+     * 获取工具集类型
+     */
+    type(): string | undefined;
+    /**
+     * List tools (async)
+     * 异步获取工具列表，返回统一的 ToolInfo 列表
+     */
+    listToolsAsync: (params?: {
+        config?: Config;
+    }) => Promise<any[]>;
+    /**
+     * List tools (sync wrapper)
+     * 同步获取工具列表，返回统一的 ToolInfo 列表
+     */
+    listTools: (config?: Config) => Promise<any[]>;
+    /**
+     * Call tool (async)
+     * 异步调用工具，统一使用 ApiSet 实现
+     */
+    callToolAsync: (name: string, args?: Record<string, unknown>, config?: Config) => Promise<any>;
+    /**
+     * Call tool (sync wrapper)
+     * 同步调用工具，统一使用 ApiSet 实现
+     */
+    callTool: (name: string, args?: Record<string, unknown>, config?: Config) => Promise<any>;
+    /**
+     * Convert ToolSet to unified ApiSet object
+     * 将 ToolSet 转换为统一的 ApiSet 对象
+     */
+    toApiSet: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Get OpenAPI authentication defaults
+     * 获取 OpenAPI 认证默认值
+     */
+    private _getOpenAPIAuthDefaults;
+    /**
+     * Get OpenAPI base URL
+     * 获取 OpenAPI 基础 URL
+     */
+    private _getOpenAPIBaseUrl;
+}
+
+/**
+ * ToolSet Client
+ *
+ * ToolSet 客户端，提供 ToolSet 的管理功能。
+ * Client for managing ToolSet resources.
+ */
+
+/**
+ * ToolSet Client
+ *
+ * 提供 ToolSet 的管理功能。
+ */
+declare class ToolSetClient {
+    private config?;
+    constructor(config?: Config);
+    /**
+     * Create a ToolSet
+     */
+    createToolSet: (params: {
+        input: ToolSetCreateInput;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Delete a ToolSet by name
+     */
+    deleteToolSet: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Get a ToolSet by name
+     */
+    getToolSet: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Update a ToolSet by name
+     */
+    updateToolSet: (params: {
+        name: string;
+        input: ToolSetUpdateInput;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * List ToolSets
+     */
+    listToolSets: (params?: {
+        input?: ToolSetListInput;
+        config?: Config;
+    }) => Promise<ToolSet[]>;
+    /**
+     * List all ToolSets with pagination
+     */
+    listAllToolSets: (params?: {
+        options?: {
+            prefix?: string;
+            labels?: Record<string, string>;
+        };
+        config?: Config;
+    }) => Promise<ToolSet[]>;
+}
+
+/**
+ * Server Data Models
+ *
+ * 此模块定义 Server 相关的所有数据模型。
+ * This module defines all data models related to Server.
+ */
+/**
+ * Message role enum
+ */
+declare enum MessageRole {
+    SYSTEM = "system",
+    USER = "user",
+    ASSISTANT = "assistant",
+    TOOL = "tool"
+}
+/**
+ * Event type enum for AgentEvent (Protocol agnostic)
+ *
+ * 定义核心事件类型，框架会自动转换为对应协议格式（OpenAI、AG-UI 等）。
+ */
+declare enum EventType {
+    TEXT = "TEXT",// 文本内容块
+    TOOL_CALL = "TOOL_CALL",// 完整工具调用（含 id, name, args）
+    TOOL_CALL_CHUNK = "TOOL_CALL_CHUNK",// 工具调用参数片段（流式场景）
+    TOOL_RESULT = "TOOL_RESULT",// 工具执行结果
+    TOOL_RESULT_CHUNK = "TOOL_RESULT_CHUNK",// 工具执行结果片段（流式输出场景）
+    ERROR = "ERROR",// 错误事件
+    STATE = "STATE",// 状态更新（快照或增量）
+    HITL = "HITL",// Human-in-the-Loop，请求人类介入
+    CUSTOM = "CUSTOM",// 自定义事件
+    RAW = "RAW"
+}
+/**
+ * Tool call definition
+ */
+interface ToolCall$1 {
+    id: string;
+    type?: string;
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * Tool definition
+ */
+interface Tool {
+    type: string;
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+/**
+ * Message in a conversation
+ */
+interface Message {
+    id?: string;
+    role: MessageRole;
+    content?: string | Array<Record<string, unknown>>;
+    name?: string;
+    toolCalls?: ToolCall$1[];
+    toolCallId?: string;
+}
+/**
+ * Agent request
+ */
+interface AgentRequest {
+    /** Protocol name */
+    protocol?: string;
+    /** Messages in the conversation */
+    messages: Message[];
+    /** Whether to stream the response */
+    stream?: boolean;
+    /** Model to use */
+    model?: string;
+    /** Available tools */
+    tools?: Tool[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Raw HTTP request (for accessing headers, etc.) */
+    rawRequest?: unknown;
+}
+/**
+ * Merge options for addition field
+ */
+interface MergeOptions {
+    noNewField?: boolean;
+    concatList?: boolean;
+    ignoreEmptyList?: boolean;
+}
+/**
+ * Agent event (for streaming)
+ *
+ * 标准化的事件结构，协议无关设计。
+ * 框架层会自动将 AgentEvent 转换为对应协议的格式（OpenAI、AG-UI 等）。
+ */
+interface AgentEvent {
+    /** Event type */
+    event: EventType;
+    /** Event data */
+    data?: Record<string, unknown>;
+    /** Additional fields for protocol extension */
+    addition?: Record<string, unknown>;
+    /** Merge options for addition */
+    additionMergeOptions?: MergeOptions;
+}
+/**
+ * Agent result (alias for AgentEvent)
+ */
+type AgentResult = AgentEvent;
+/**
+ * Protocol configuration base
+ */
+interface ProtocolConfig {
+    prefix?: string;
+    enable?: boolean;
+}
+/**
+ * OpenAI protocol configuration
+ */
+interface OpenAIProtocolConfig extends ProtocolConfig {
+    modelName?: string;
+}
+/**
+ * AG-UI protocol configuration
+ */
+interface AGUIProtocolConfig extends ProtocolConfig {
+}
+/**
+ * Server configuration
+ */
+interface ServerConfig {
+    /** OpenAI protocol config */
+    openai?: OpenAIProtocolConfig;
+    /** AG-UI protocol config */
+    agui?: AGUIProtocolConfig;
+    /** CORS origins */
+    corsOrigins?: string[];
+    /** Port to listen on */
+    port?: number;
+    /** Host to listen on */
+    host?: string;
+}
+
+/**
+ * AgentRun HTTP Server
+ *
+ * 基于 Node.js 的 HTTP 服务器实现。
+ * HTTP server implementation based on Node.js.
+ */
+
+/**
+ * Agent invoke handler type
+ */
+type InvokeAgentHandler = (request: AgentRequest) => Promise<string | AgentResult | AsyncIterable<string | AgentResult>> | string | AgentResult | AsyncIterable<string | AgentResult>;
+/**
+ * AgentRun HTTP Server
+ *
+ * 提供 HTTP 服务器功能，支持 OpenAI 和 AG-UI 协议。
+ */
+declare class AgentRunServer {
+    private invokeAgent;
+    private config;
+    private server?;
+    private aguiHandler;
+    constructor(options: {
+        invokeAgent: InvokeAgentHandler;
+        config?: ServerConfig;
+    });
+    /**
+     * Start the HTTP server
+     */
+    start(options?: {
+        host?: string;
+        port?: number;
+    }): void;
+    /**
+     * Stop the HTTP server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle CORS headers
+     */
+    private handleCors;
+    /**
+     * Handle HTTP request
+     */
+    private handleRequest;
+    /**
+     * Handle AG-UI endpoint
+     */
+    private handleAGUI;
+    /**
+     * Handle OpenAI chat completions endpoint
+     */
+    private handleChatCompletions;
+    /**
+     * Parse request body
+     */
+    private parseBody;
+    /**
+     * Check if value is async iterable
+     */
+    private isAsyncIterable;
+    /**
+     * Convert result to async iterable
+     */
+    private toAsyncIterable;
+}
+
+/**
+ * Adapter Interface Definition
+ *
+ * 定义统一的适配器接口，所有框架适配器都实现这些接口。
+ * Defines unified adapter interfaces that all framework adapters implement.
+ */
+/**
+ * 标准消息格式 (OpenAI 兼容)
+ * Canonical message format (OpenAI compatible)
+ */
+interface CanonicalMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null;
+    name?: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+}
+/**
+ * 工具调用
+ * Tool call
+ */
+interface ToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * 标准工具定义
+ * Canonical tool definition
+ */
+interface CanonicalTool {
+    name: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    func?: (...args: unknown[]) => unknown | Promise<unknown>;
+}
+/**
+ * 通用模型配置
+ * Common model configuration
+ */
+interface CommonModelConfig {
+    /** 模型端点 URL */
+    endpoint?: string;
+    /** API Key */
+    apiKey?: string;
+    /** 模型名称 */
+    modelName?: string;
+    /** 温度参数 */
+    temperature?: number;
+    /** 最大 tokens */
+    maxTokens?: number;
+    /** 超时时间 (毫秒) */
+    timeout?: number;
+}
+/**
+ * 消息适配器接口
+ * Message adapter interface
+ *
+ * 用于在不同框架消息格式之间进行转换。
+ * Used to convert between different framework message formats.
+ */
+interface MessageAdapter<TFrameworkMessage = unknown> {
+    /**
+     * 将框架消息转换为标准格式
+     * Convert framework messages to canonical format
+     */
+    toCanonical(messages: TFrameworkMessage[]): CanonicalMessage[];
+    /**
+     * 将标准消息转换为框架格式
+     * Convert canonical messages to framework format
+     */
+    fromCanonical(messages: CanonicalMessage[]): TFrameworkMessage[];
+}
+/**
+ * 工具适配器接口
+ * Tool adapter interface
+ *
+ * 用于将标准工具定义转换为框架特定格式。
+ * Used to convert canonical tool definitions to framework-specific format.
+ */
+interface ToolAdapter<TFrameworkTool = unknown> {
+    /**
+     * 将标准工具转换为框架格式
+     * Convert canonical tools to framework format
+     */
+    fromCanonical(tools: CanonicalTool[]): TFrameworkTool[];
+    /**
+     * 将框架工具转换为标准格式 (可选)
+     * Convert framework tools to canonical format (optional)
+     */
+    toCanonical?(tools: TFrameworkTool[]): CanonicalTool[];
+}
+/**
+ * 模型适配器接口
+ * Model adapter interface
+ *
+ * 用于包装框架模型，使其能够与 AgentRun 协同工作。
+ * Used to wrap framework models to work with AgentRun.
+ */
+interface ModelAdapter<TFrameworkModel = unknown> {
+    /**
+     * 使用 AgentRun 模型配置创建框架模型
+     * Create framework model with AgentRun model configuration
+     */
+    createModel(config: CommonModelConfig): TFrameworkModel;
+}
+/**
+ * 框架集成适配器
+ * Framework integration adapter
+ *
+ * 组合消息、工具和模型适配器的完整框架集成。
+ * Complete framework integration combining message, tool, and model adapters.
+ */
+interface FrameworkAdapter<TMessage = unknown, TTool = unknown, TModel = unknown> {
+    name: string;
+    message: MessageAdapter<TMessage>;
+    tool: ToolAdapter<TTool>;
+    model: ModelAdapter<TModel>;
+}
+/**
+ * 将 JSON Schema 类型转换为 TypeScript 类型
+ * Convert JSON Schema type to TypeScript type
+ */
+declare function schemaToType(schema: Record<string, unknown>): string;
+
+/**
+ * Mastra Types
+ *
+ * Mastra 框架相关的类型定义。
+ * Type definitions for Mastra framework.
+ */
+/**
+ * Mastra 消息格式
+ * Mastra message format
+ */
+interface MastraMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null;
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: MastraToolCall[];
+}
+/**
+ * Mastra 工具调用
+ * Mastra tool call
+ */
+interface MastraToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * Mastra 工具定义
+ * Mastra tool definition
+ */
+interface MastraTool {
+    name: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+    execute?: (...args: unknown[]) => Promise<unknown>;
+}
+/**
+ * Mastra 模型配置
+ * Mastra model configuration
+ */
+interface MastraModelConfig {
+    provider: string;
+    modelId: string;
+    apiKey?: string;
+    baseUrl?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+/**
+ * Mastra Agent 配置
+ * Mastra agent configuration
+ */
+interface MastraAgentConfig {
+    name: string;
+    instructions?: string;
+    model: MastraModelConfig;
+    tools?: MastraTool[];
+}
+
+/**
+ * Mastra Adapter
+ *
+ * Mastra 框架的集成适配器。
+ * Integration adapter for Mastra framework.
+ */
+
+/**
+ * Mastra 消息适配器
+ * Mastra message adapter
+ */
+declare class MastraMessageAdapter implements MessageAdapter<MastraMessage> {
+    /**
+     * 将 Mastra 消息转换为标准格式
+     */
+    toCanonical(messages: MastraMessage[]): CanonicalMessage[];
+    /**
+     * 将标准消息转换为 Mastra 格式
+     */
+    fromCanonical(messages: CanonicalMessage[]): MastraMessage[];
+}
+/**
+ * Mastra 工具适配器
+ * Mastra tool adapter
+ */
+declare class MastraToolAdapter implements ToolAdapter<MastraTool> {
+    /**
+     * 将标准工具转换为 Mastra 格式
+     */
+    fromCanonical(tools: CanonicalTool[]): MastraTool[];
+    /**
+     * 将 Mastra 工具转换为标准格式
+     */
+    toCanonical(tools: MastraTool[]): CanonicalTool[];
+}
+/**
+ * Mastra 模型适配器
+ * Mastra model adapter
+ */
+declare class MastraModelAdapter implements ModelAdapter<MastraModelConfig> {
+    /**
+     * 使用 AgentRun 配置创建 Mastra 模型配置
+     */
+    createModel(config: CommonModelConfig): MastraModelConfig;
+    /**
+     * 检测模型提供商
+     */
+    private detectProvider;
+}
+/**
+ * Mastra 完整框架适配器
+ * Mastra complete framework adapter
+ */
+declare class MastraAdapter implements FrameworkAdapter<MastraMessage, MastraTool, MastraModelConfig> {
+    readonly name = "mastra";
+    readonly message: MastraMessageAdapter;
+    readonly tool: MastraToolAdapter;
+    readonly model: MastraModelAdapter;
+}
+/**
+ * 创建 Mastra 适配器实例
+ * Create Mastra adapter instance
+ */
+declare function createMastraAdapter(): MastraAdapter;
+/**
+ * 将 AgentRun 工具包装为 Mastra 工具
+ * Wrap AgentRun tools as Mastra tools
+ */
+declare function wrapTools(tools: CanonicalTool[]): MastraTool[];
+/**
+ * 将 AgentRun 模型配置转换为 Mastra 模型配置
+ * Convert AgentRun model config to Mastra model config
+ */
+declare function wrapModel(config: CommonModelConfig): MastraModelConfig;
+/**
+ * Agent 包装器配置参数
+ * Agent wrapper configuration parameters
+ */
+interface WrapAgentParams {
+    /** Agent 名称 */
+    name: string;
+    /** Agent 指令/系统提示词 */
+    instructions?: string;
+    /** 模型配置 */
+    modelConfig: CommonModelConfig;
+    /** 工具列表 */
+    tools?: CanonicalTool[];
+}
+/**
+ * 将 AgentRun 组件包装为完整的 Mastra Agent 配置
+ * Wrap AgentRun components as complete Mastra agent configuration
+ *
+ * @param params - Agent 包装器配置参数
+ * @returns Mastra Agent 配置对象
+ *
+ * @example
+ * ```typescript
+ * const agentConfig = wrapAgent({
+ *   name: "MyAssistant",
+ *   instructions: "You are a helpful assistant",
+ *   modelConfig: {
+ *     endpoint: "https://api.openai.com/v1",
+ *     apiKey: "sk-...",
+ *     modelName: "gpt-4"
+ *   },
+ *   tools: [calculatorTool, weatherTool]
+ * });
+ * ```
+ */
+declare function wrapAgent(params: WrapAgentParams): MastraAgentConfig;
+
+/**
+ * AgentRun SDK for Node.js
+ *
+ * AgentRun SDK 是阿里云 AgentRun 服务的 Node.js 客户端库。
+ * Provides simple and easy-to-use APIs for managing AI Agent runtime environments,
+ * model services, sandbox environments, etc.
+ *
+ * @packageDocumentation
+ */
+declare const VERSION = "0.0.1";
+
+export { type AgentRequest, type AgentResult, AgentRunError, AgentRunServer, AgentRuntime, AgentRuntimeArtifact, AgentRuntimeClient, type AgentRuntimeCode, type AgentRuntimeContainer, AgentRuntimeControlAPI, type AgentRuntimeCreateInput, AgentRuntimeEndpoint, type AgentRuntimeEndpointCreateInput, type AgentRuntimeEndpointListInput, type AgentRuntimeEndpointRoutingConfig, type AgentRuntimeEndpointRoutingWeight, type AgentRuntimeEndpointUpdateInput, type AgentRuntimeHealthCheckConfig, AgentRuntimeLanguage, type AgentRuntimeListInput, type AgentRuntimeLogConfig, type AgentRuntimeProtocolConfig, AgentRuntimeProtocolType, type AgentRuntimeUpdateInput, type AgentRuntimeVersion, AioDataAPI, AioSandbox, BackendType, BrowserDataAPI, BrowserSandbox, type CanonicalMessage, type CanonicalTool, ClientError, CodeInterpreterDataAPI, CodeInterpreterSandbox, CodeLanguage, type CommonModelConfig, Config, type ConfigOptions, Credential, type CredentialBasicAuth, CredentialClient, CredentialConfig, CredentialControlAPI, type CredentialCreateInput, type CredentialListInput, type CredentialUpdateInput, EventType, type ExecuteCodeResult, type FileInfo, type FrameworkAdapter, HTTPError, type MCPToolMeta, MastraAdapter, type MastraAgentConfig, type MastraMessage, MastraMessageAdapter, MastraModelAdapter, type MastraModelConfig, type MastraTool, MastraToolAdapter, type MastraToolCall, type Message, type MessageAdapter, MessageRole, type ModelAdapter, ModelClient, ControlAPI as ModelControlAPI, type ModelFeatures, type ModelInfoConfig, type ModelParameterRule, type ModelProperties, ModelProxy, type ModelProxyCreateInput, type ModelProxyListInput, type ModelProxyUpdateInput, ModelService, type ModelServiceCreateInput, type ModelServiceListInput, type ModelServiceUpdateInput, ModelType, Provider, type ProviderSettings, type ProxyConfig, type ProxyConfigEndpoint, type ProxyConfigFallback, type ProxyConfigPolicies, type RelatedResource, ResourceAlreadyExistError, ResourceNotExistError, Sandbox, SandboxClient, type SandboxCreateInput, type SandboxData, SandboxDataAPI, type SandboxListInput, SandboxState, type ServerConfig, ServerError, Status, Template, type TemplateArmsConfiguration, type TemplateContainerConfiguration, type TemplateCreateInput, type TemplateCredentialConfiguration, type TemplateData, type TemplateListInput, type TemplateLogConfiguration, type TemplateMcpOptions, type TemplateMcpState, type TemplateNetworkConfiguration, TemplateNetworkMode, TemplateOSSPermission, type TemplateOssConfiguration, TemplateType, type TemplateUpdateInput, type ToolAdapter, type ToolCall, ToolSet, type ToolSetAuthorization, ToolSetClient, type ToolSetCreateInput, type ToolSetData, type ToolSetListInput, type ToolSetSchema, ToolSetSchemaType, type ToolSetSpec, type ToolSetStatus, type ToolSetStatusOutputs, type ToolSetUpdateInput, VERSION, type WrapAgentParams, createMastraAdapter, schemaToType, wrapAgent, wrapModel, wrapTools };