rl-rock 1.2.4 → 1.2.6

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { ChildProcess } from 'child_process';
 
 /**
  * ROCK status codes enumeration
@@ -483,7 +482,7 @@ type OssSetupResponse = z.infer<typeof OssSetupResponseSchema>;
 /**
  * Run mode type
  */
-type RunModeType$1 = 'normal' | 'nohup';
+type RunModeType = 'normal' | 'nohup';
 /**
  * Run mode enum
  */
@@ -491,18 +490,6 @@ declare const RunMode: {
     NORMAL: "normal";
     NOHUP: "nohup";
 };
-/**
- * Constants class (deprecated, use envs module instead)
- * @deprecated Use envs module instead
- */
-declare class Constants {
-    static readonly BASE_URL_PRODUCT = "";
-    static readonly BASE_URL_ALIYUN = "";
-    static readonly BASE_URL_INNER = "";
-    static readonly BASE_URL_PRE = "";
-    static readonly BASE_URL_LOCAL = "";
-    static readonly REQUEST_TIMEOUT_SECONDS = 180;
-}
 /**
  * PID prefix and suffix for nohup output parsing
  */
@@ -555,6 +542,10 @@ declare function raiseForCode(code: Codes | null | undefined, message: string):
  */
 declare function fromRockException(e: RockException): SandboxResponse;
 
+/**
+ * HTTP utilities using axios
+ */
+
 /**
  * HTTP response with headers
  */
@@ -604,6 +595,10 @@ declare class HttpUtils {
      */
     static guessContentType(filename: string): string;
 }
+/**
+ * Extract nohup PID from output
+ */
+declare function extractNohupPid(output: string): number | null;
 
 /**
  * Retry utilities
@@ -630,9 +625,6 @@ declare function sleep(ms: number): Promise<void>;
  */
 declare function withRetry<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: RetryOptions): T;
 
-/**
- * Deprecated decorator utilities
- */
 /**
  * Mark a function as deprecated
  */
@@ -644,17 +636,17 @@ declare function deprecatedClass(reason?: string): <T extends new (...args: any[
 
 /**
  * System utilities
+ *
+ * Note: This SDK requires Node.js environment (v20.8.0+).
+ * It cannot run in browsers due to dependencies on Node.js modules.
  */
 /**
  * Check if running in Node.js environment
  */
 declare function isNode(): boolean;
-/**
- * Check if running in browser environment
- */
-declare function isBrowser(): boolean;
 /**
  * Get environment variable
+ * Directly accesses process.env since this SDK requires Node.js
  */
 declare function getEnv(key: string, defaultValue?: string): string | undefined;
 /**
@@ -663,6 +655,7 @@ declare function getEnv(key: string, defaultValue?: string): string | undefined;
 declare function getRequiredEnv(key: string): string;
 /**
  * Check if environment variable is set
+ * Directly checks process.env since this SDK requires Node.js
  */
 declare function isEnvSet(key: string): boolean;
 
@@ -798,8 +791,18 @@ declare class RockEnv {
     private readonly envId;
     private sandboxId;
     private isClosed;
-    private client;
-    constructor(config: RockEnvConfig);
+    private constructor();
+    /**
+     * Create and initialize a RockEnv instance
+     *
+     * @param config - Environment configuration
+     * @returns Initialized RockEnv instance
+     */
+    static create(config: RockEnvConfig): Promise<RockEnv>;
+    /**
+     * Get the sandbox ID
+     */
+    getSandboxId(): string | null;
     /**
      * Initialize environment instance
      */
@@ -845,9 +848,9 @@ declare class RockEnv {
  *
  * @param envId - Environment ID
  * @param options - Environment options
- * @returns RockEnv instance
+ * @returns Promise resolving to RockEnv instance
  */
-declare function make(envId: string, options?: Record<string, unknown>): RockEnv;
+declare function make(envId: string, options?: Record<string, unknown>): Promise<RockEnv>;
 
 /**
  * Sandbox configuration
@@ -1051,16 +1054,13 @@ declare class LinuxFileSystem extends FileSystem {
         success: boolean;
         message: string;
     }>;
-    uploadDir(sourceDir: string, targetDir: string, _extractTimeout?: number): Promise<Observation>;
+    uploadDir(sourceDir: string, targetDir: string, extractTimeout?: number): Promise<Observation>;
 }
 
 /**
- * Sandbox types
- */
-/**
- * Run mode type
+ * Network - Network management for sandbox
  */
-type RunModeType = 'normal' | 'nohup';
+
 /**
  * Speedup type enum
  */
@@ -1069,11 +1069,6 @@ declare enum SpeedupType {
     PIP = "pip",
     GITHUB = "github"
 }
-
-/**
- * Network - Network management for sandbox
- */
-
 /**
  * Network management for sandbox
  */
@@ -1089,9 +1084,25 @@ declare class Network {
      * @returns Observation with execution result
      */
     speedup(speedupType: SpeedupType, speedupValue: string, timeout?: number): Promise<Observation>;
-    private buildAptSpeedupCommand;
-    private buildPipSpeedupCommand;
-    private buildGithubSpeedupCommand;
+    /**
+     * Generate speedup script content based on type
+     */
+    private generateSpeedupScript;
+    /**
+     * Build APT speedup script
+     * Uses script file approach for safety
+     */
+    private buildAptSpeedupScript;
+    /**
+     * Build PIP speedup script
+     * Uses script file approach for safety
+     */
+    private buildPipSpeedupScript;
+    /**
+     * Build GitHub speedup script
+     * Uses script file approach for safety
+     */
+    private buildGithubSpeedupScript;
 }
 
 /**
@@ -1162,6 +1173,16 @@ declare abstract class AbstractSandbox {
     abstract writeFile(request: WriteFileRequest): Promise<WriteFileResponse>;
     abstract upload(request: UploadRequest): Promise<UploadResponse>;
     abstract closeSession(request: CloseSessionRequest): Promise<CloseSessionResponse>;
+    abstract arun(cmd: string, options?: {
+        session?: string;
+        mode?: RunModeType;
+        timeout?: number;
+        waitTimeout?: number;
+        waitInterval?: number;
+        responseLimitedBytesInNohup?: number;
+        ignoreOutput?: boolean;
+        outputFile?: string;
+    }): Promise<Observation>;
     abstract close(): Promise<void>;
 }
 /**
@@ -1250,10 +1271,6 @@ declare function arunWithRetry(sandbox: Sandbox, cmd: string, session: string, m
     maxAttempts?: number;
     errorMsg?: string;
 }): Promise<Observation>;
-/**
- * Extract nohup PID from output
- */
-declare function extractNohupPid(output: string): number | null;
 
 /**
  * Model client for LLM interaction
@@ -1264,6 +1281,15 @@ declare function extractNohupPid(output: string): number | null;
 interface ModelClientConfig {
     logFileName?: string;
 }
+/**
+ * Options for polling operations (popRequest, waitForFirstRequest)
+ */
+interface PollOptions {
+    /** Maximum time to wait in seconds. Defaults to DEFAULT_POLL_TIMEOUT */
+    timeout?: number;
+    /** AbortSignal for cancellation support */
+    signal?: AbortSignal;
+}
 /**
  * Model client for LLM interaction
  */
@@ -1280,71 +1306,1054 @@ declare class ModelClient {
     pushResponse(index: number, lastResponse: string): Promise<void>;
     /**
      * Pop request from log file
+     *
+     * @param index - The index of the request to pop
+     * @param options - Optional configuration for timeout and cancellation
+     * @returns The request JSON string or SESSION_END_MARKER
+     * @throws Error if timeout expires or operation is aborted
      */
-    popRequest(index: number): Promise<string>;
+    popRequest(index: number, options?: PollOptions): Promise<string>;
     /**
      * Wait for first request
+     *
+     * @param options - Optional configuration for timeout and cancellation
+     * @throws Error if timeout expires or operation is aborted
      */
-    waitForFirstRequest(): Promise<void>;
+    waitForFirstRequest(options?: PollOptions): Promise<void>;
     private parseRequestLine;
     private parseResponseLine;
     private readLastRequestLine;
     private readLastResponseLine;
     private appendResponse;
     private constructResponse;
-    private sleep;
 }
 
 /**
- * Model service for managing local LLM service
+ * Base configuration for runtime environments.
+ */
+declare const RuntimeEnvConfigSchema: z.ZodObject<{
+    /** Runtime type discriminator. */
+    type: z.ZodString;
+    /** Runtime version. Use 'default' for the default version of each runtime. */
+    version: z.ZodDefault<z.ZodString>;
+    /** Environment variables for the runtime session. */
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Timeout in seconds for installation commands. */
+    installTimeout: z.ZodDefault<z.ZodNumber>;
+    /** Custom install command to run after init. */
+    customInstallCmd: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** Directory to create symlinks of executables. If null, no symlinks are created. */
+    extraSymlinkDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** List of executable names to symlink. Empty list means no symlinks. */
+    extraSymlinkExecutables: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    env: Record<string, string>;
+    version: string;
+    installTimeout: number;
+    customInstallCmd: string | null;
+    extraSymlinkDir: string | null;
+    extraSymlinkExecutables: string[];
+}, {
+    type: string;
+    env?: Record<string, string> | undefined;
+    version?: string | undefined;
+    installTimeout?: number | undefined;
+    customInstallCmd?: string | null | undefined;
+    extraSymlinkDir?: string | null | undefined;
+    extraSymlinkExecutables?: string[] | undefined;
+}>;
+type RuntimeEnvConfig = z.infer<typeof RuntimeEnvConfigSchema>;
+
+/** Unique identifier for a RuntimeEnv instance */
+type RuntimeEnvId = string;
+/** Create a new unique RuntimeEnvId */
+declare function createRuntimeEnvId(): RuntimeEnvId;
+/**
+ * Interface for Sandbox with methods needed by RuntimeEnv
+ */
+interface SandboxLike {
+    sandboxId: string;
+    runtimeEnvs: Record<RuntimeEnvId, RuntimeEnv>;
+    createSession(request: {
+        session: string;
+        envEnable: boolean;
+        env?: Record<string, string>;
+    }): Promise<unknown>;
+    arun(cmd: string, options?: {
+        session?: string;
+        mode?: 'normal' | 'nohup' | 'NOHUP';
+        waitTimeout?: number;
+        waitInterval?: number;
+    }): Promise<Observation>;
+    startNohupProcess?(cmd: string, tmpFile: string, session: string): Promise<{
+        pid: number | null;
+        errorResponse: Observation | null;
+    }>;
+    waitForProcessCompletion?(pid: number, session: string, waitTimeout: number, waitInterval: number): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    handleNohupOutput?(tmpFile: string, session: string, success: boolean, message: string, ignoreOutput: boolean, responseLimitedBytes: number | null): Promise<Observation>;
+}
+/**
+ * Runtime environment (e.g., Python/Node).
+ *
+ * Each RuntimeEnv is identified by (type, version) tuple and is managed by Sandbox.runtimeEnvs.
+ * workdir is auto-generated as: /tmp/rock-runtime-envs/{type}/{version}/{runtimeEnvId}
+ * session is auto-generated as: runtime-env-{type}-{version}-{runtimeEnvId}
+ *
+ * @example
+ * ```typescript
+ * const env = await RuntimeEnv.create(sandbox, config);
+ * await env.run("python --version");
+ * ```
+ */
+declare abstract class RuntimeEnv {
+    /** Registry for subclasses */
+    protected static registry: Record<string, typeof RuntimeEnv>;
+    /** Runtime type discriminator - must be defined by subclass */
+    abstract readonly runtimeEnvType: string;
+    /** Sandbox instance */
+    protected _sandbox: SandboxLike;
+    /** Configuration */
+    protected _config: RuntimeEnvConfig;
+    /** Version */
+    protected _version: string;
+    /** Environment variables */
+    protected _env: Record<string, string>;
+    /** Install timeout in seconds */
+    protected _installTimeout: number;
+    /** Custom install command */
+    protected _customInstallCmd: string | null;
+    /** Extra symlink directory */
+    protected _extraSymlinkDir: string | null;
+    /** Extra symlink executables */
+    protected _extraSymlinkExecutables: string[];
+    /** Unique ID for this runtime env instance */
+    protected _runtimeEnvId: RuntimeEnvId;
+    /** Working directory */
+    protected _workdir: string;
+    /** Session name */
+    protected _session: string;
+    /** Whether the runtime has been initialized */
+    protected _initialized: boolean;
+    /** Whether the session is ready */
+    protected _sessionReady: boolean;
+    constructor(sandbox: SandboxLike, config: RuntimeEnvConfig);
+    /** Whether the runtime has been initialized */
+    get initialized(): boolean;
+    /** Unique ID for this runtime env instance */
+    get runtimeEnvId(): RuntimeEnvId;
+    /** Working directory for this runtime env instance */
+    get workdir(): string;
+    /** Binary directory for this runtime env instance */
+    get binDir(): string;
+    /**
+     * Initialize the runtime environment.
+     * This method performs installation and validation.
+     * It is idempotent: calling multiple times only initializes once.
+     */
+    init(): Promise<void>;
+    /**
+     * Run a command under this runtime
+     */
+    run(cmd: string, options?: {
+        mode?: 'normal' | 'nohup';
+        waitTimeout?: number;
+        errorMsg?: string;
+    }): Promise<Observation>;
+    /**
+     * Wrap command with PATH export.
+     * Always wrap with bash -c to ensure it only affects current cmd.
+     * Default prepend=true to give current runtime_env highest priority.
+     */
+    wrappedCmd(cmd: string, prepend?: boolean): string;
+    /**
+     * Ensure runtime env session exists. Safe to call multiple times.
+     */
+    protected _ensureSession(): Promise<void>;
+    /**
+     * Create workdir for runtime environment.
+     */
+    protected _ensureWorkdir(): Promise<void>;
+    /**
+     * Get installation command for this runtime environment.
+     */
+    protected abstract _getInstallCmd(): string;
+    /**
+     * Install the runtime environment.
+     */
+    protected _installRuntime(): Promise<void>;
+    /**
+     * Additional initialization after runtime installation.
+     * Override in subclasses.
+     */
+    protected _postInit(): Promise<void>;
+    /**
+     * Execute custom install command after _postInit.
+     */
+    protected _doCustomInstall(): Promise<void>;
+    /**
+     * Create symlinks in target directory for executables.
+     */
+    protected _createSysPathLinks(): Promise<void>;
+}
+
+/**
+ * Python runtime environment configuration and implementation
  */
 
 /**
- * Model service configuration
+ * Python runtime environment configuration schema
+ */
+declare const PythonRuntimeEnvConfigSchema: z.ZodObject<{
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    installTimeout: z.ZodDefault<z.ZodNumber>;
+    customInstallCmd: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    extraSymlinkDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+} & {
+    type: z.ZodDefault<z.ZodLiteral<"python">>;
+    version: z.ZodDefault<z.ZodEnum<["3.11", "3.12", "default"]>>;
+    pip: z.ZodDefault<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodString]>>>;
+    pipIndexUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    extraSymlinkExecutables: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "python";
+    env: Record<string, string>;
+    pip: string | string[] | null;
+    version: "default" | "3.11" | "3.12";
+    installTimeout: number;
+    customInstallCmd: string | null;
+    extraSymlinkDir: string | null;
+    extraSymlinkExecutables: string[];
+    pipIndexUrl: string | null;
+}, {
+    type?: "python" | undefined;
+    env?: Record<string, string> | undefined;
+    pip?: string | string[] | null | undefined;
+    version?: "default" | "3.11" | "3.12" | undefined;
+    installTimeout?: number | undefined;
+    customInstallCmd?: string | null | undefined;
+    extraSymlinkDir?: string | null | undefined;
+    extraSymlinkExecutables?: string[] | undefined;
+    pipIndexUrl?: string | null | undefined;
+}>;
+/**
+ * Python runtime environment configuration type
+ */
+type PythonRuntimeEnvConfig = z.infer<typeof PythonRuntimeEnvConfigSchema>;
+/**
+ * Get default pip index URL from environment variable.
  */
-interface ModelServiceConfig {
-    modelServiceType?: string;
-    configFile?: string;
-    host?: string;
-    port?: number;
-    proxyBaseUrl?: string;
-    retryableStatusCodes?: string;
-    requestTimeout?: number;
+declare function getDefaultPipIndexUrl(): string;
+/**
+ * Python runtime environment
+ *
+ * Provides Python runtime with pip package management.
+ * Supports Python 3.11 and 3.12 versions.
+ *
+ * @example
+ * ```typescript
+ * const config: PythonRuntimeEnvConfig = {
+ *   version: 'default',
+ *   pip: ['langchain', 'langchain-openai'],
+ *   pipIndexUrl: 'https://mirrors.aliyun.com/pypi/simple/',
+ * };
+ * const env = new PythonRuntimeEnv(sandbox, config);
+ * await env.init();
+ * await env.run('python --version');
+ * ```
+ */
+declare class PythonRuntimeEnv extends RuntimeEnv {
+    readonly runtimeEnvType = "python";
+    private _pip;
+    private _pipIndexUrl;
+    constructor(sandbox: SandboxLike & {
+        runtimeEnvs: Record<RuntimeEnvId, RuntimeEnv>;
+    }, config: PythonRuntimeEnvConfig);
+    protected _getInstallCmd(): string;
+    protected _postInit(): Promise<void>;
+    private _validatePython;
+    private _configurePip;
+    private _installPip;
 }
+
+/**
+ * Node.js runtime environment configuration and implementation
+ */
+
+/** Default Node.js version */
+declare const NODE_DEFAULT_VERSION = "22.18.0";
 /**
- * Model service for managing local LLM service
+ * Configuration for Node.js runtime environment.
+ */
+declare const NodeRuntimeEnvConfigSchema: z.ZodObject<{
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    installTimeout: z.ZodDefault<z.ZodNumber>;
+    customInstallCmd: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    extraSymlinkDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+} & {
+    type: z.ZodDefault<z.ZodLiteral<"node">>;
+    version: z.ZodDefault<z.ZodEnum<["22.18.0", "default"]>>;
+    npmRegistry: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    extraSymlinkExecutables: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "node";
+    env: Record<string, string>;
+    version: "default" | "22.18.0";
+    installTimeout: number;
+    customInstallCmd: string | null;
+    extraSymlinkDir: string | null;
+    extraSymlinkExecutables: string[];
+    npmRegistry: string | null;
+}, {
+    type?: "node" | undefined;
+    env?: Record<string, string> | undefined;
+    version?: "default" | "22.18.0" | undefined;
+    installTimeout?: number | undefined;
+    customInstallCmd?: string | null | undefined;
+    extraSymlinkDir?: string | null | undefined;
+    extraSymlinkExecutables?: string[] | undefined;
+    npmRegistry?: string | null | undefined;
+}>;
+/**
+ * Node runtime environment configuration type
+ */
+type NodeRuntimeEnvConfig = z.infer<typeof NodeRuntimeEnvConfigSchema>;
+/**
+ * Node runtime environment
+ *
+ * Provides Node.js runtime with npm package management.
+ * Supports Node.js 22.18.0.
+ *
+ * @example
+ * ```typescript
+ * const config: NodeRuntimeEnvConfig = {
+ *   version: 'default',
+ *   npmRegistry: 'https://registry.npmmirror.com',
+ * };
+ * const env = new NodeRuntimeEnv(sandbox, config);
+ * await env.init();
+ * await env.run('node --version');
+ * ```
+ */
+declare class NodeRuntimeEnv extends RuntimeEnv {
+    readonly runtimeEnvType = "node";
+    private _npmRegistry;
+    constructor(sandbox: SandboxLike & {
+        runtimeEnvs: Record<RuntimeEnvId, RuntimeEnv>;
+    }, config: NodeRuntimeEnvConfig);
+    protected _getInstallCmd(): string;
+    protected _postInit(): Promise<void>;
+    private _validateNode;
+    private _configureNpmRegistry;
+}
+
+/**
+ * ModelService - manages model service installation and lifecycle in sandbox
+ *
+ * This module provides functionality to install, start, stop, and manage
+ * the model service within a sandboxed environment.
+ */
+
+/**
+ * ModelService configuration schema
+ */
+declare const ModelServiceConfigSchema: z.ZodObject<{
+    /** Whether to enable model service */
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    /** Type of model service to start */
+    type: z.ZodDefault<z.ZodString>;
+    /** Command to install model service package */
+    installCmd: z.ZodDefault<z.ZodString>;
+    /** Timeout for model service installation in seconds */
+    installTimeout: z.ZodDefault<z.ZodNumber>;
+    /** Runtime environment configuration for the model service */
+    runtimeEnvConfig: z.ZodDefault<z.ZodObject<{
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        installTimeout: z.ZodDefault<z.ZodNumber>;
+        customInstallCmd: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        extraSymlinkDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    } & {
+        type: z.ZodDefault<z.ZodLiteral<"python">>;
+        version: z.ZodDefault<z.ZodEnum<["3.11", "3.12", "default"]>>;
+        pip: z.ZodDefault<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodString]>>>;
+        pipIndexUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        extraSymlinkExecutables: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "python";
+        env: Record<string, string>;
+        pip: string | string[] | null;
+        version: "default" | "3.11" | "3.12";
+        installTimeout: number;
+        customInstallCmd: string | null;
+        extraSymlinkDir: string | null;
+        extraSymlinkExecutables: string[];
+        pipIndexUrl: string | null;
+    }, {
+        type?: "python" | undefined;
+        env?: Record<string, string> | undefined;
+        pip?: string | string[] | null | undefined;
+        version?: "default" | "3.11" | "3.12" | undefined;
+        installTimeout?: number | undefined;
+        customInstallCmd?: string | null | undefined;
+        extraSymlinkDir?: string | null | undefined;
+        extraSymlinkExecutables?: string[] | undefined;
+        pipIndexUrl?: string | null | undefined;
+    }>>;
+    /** Command to start model service with type placeholder */
+    startCmd: z.ZodDefault<z.ZodString>;
+    /** Command to stop model service */
+    stopCmd: z.ZodDefault<z.ZodString>;
+    /** Command to create Rock config file */
+    configIniCmd: z.ZodDefault<z.ZodString>;
+    /** Command to watch agent with pid placeholder */
+    watchAgentCmd: z.ZodDefault<z.ZodString>;
+    /** Command to anti-call LLM with index and response_payload placeholders */
+    antiCallLlmCmd: z.ZodDefault<z.ZodString>;
+    /** Command to anti-call LLM with only index placeholder */
+    antiCallLlmCmdNoResponse: z.ZodDefault<z.ZodString>;
+    /** Path for logging directory */
+    loggingPath: z.ZodDefault<z.ZodString>;
+    /** Name of the log file */
+    loggingFileName: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    installTimeout: number;
+    enabled: boolean;
+    installCmd: string;
+    runtimeEnvConfig: {
+        type: "python";
+        env: Record<string, string>;
+        pip: string | string[] | null;
+        version: "default" | "3.11" | "3.12";
+        installTimeout: number;
+        customInstallCmd: string | null;
+        extraSymlinkDir: string | null;
+        extraSymlinkExecutables: string[];
+        pipIndexUrl: string | null;
+    };
+    startCmd: string;
+    stopCmd: string;
+    configIniCmd: string;
+    watchAgentCmd: string;
+    antiCallLlmCmd: string;
+    antiCallLlmCmdNoResponse: string;
+    loggingPath: string;
+    loggingFileName: string;
+}, {
+    type?: string | undefined;
+    installTimeout?: number | undefined;
+    enabled?: boolean | undefined;
+    installCmd?: string | undefined;
+    runtimeEnvConfig?: {
+        type?: "python" | undefined;
+        env?: Record<string, string> | undefined;
+        pip?: string | string[] | null | undefined;
+        version?: "default" | "3.11" | "3.12" | undefined;
+        installTimeout?: number | undefined;
+        customInstallCmd?: string | null | undefined;
+        extraSymlinkDir?: string | null | undefined;
+        extraSymlinkExecutables?: string[] | undefined;
+        pipIndexUrl?: string | null | undefined;
+    } | undefined;
+    startCmd?: string | undefined;
+    stopCmd?: string | undefined;
+    configIniCmd?: string | undefined;
+    watchAgentCmd?: string | undefined;
+    antiCallLlmCmd?: string | undefined;
+    antiCallLlmCmdNoResponse?: string | undefined;
+    loggingPath?: string | undefined;
+    loggingFileName?: string | undefined;
+}>;
+/**
+ * ModelService configuration type
+ */
+type ModelServiceConfig = z.infer<typeof ModelServiceConfigSchema>;
+/**
+ * ModelService - manages model service installation and lifecycle in sandbox
+ *
+ * This class handles model service installation, startup, and agent management
+ * within a sandboxed environment.
+ *
+ * Note:
+ * Caller is responsible for ensuring proper sequencing of install/start/stop operations.
  */
 declare class ModelService {
-    private process;
+    private _sandbox;
+    private _config;
+    private _runtimeEnv;
+    private _isInstalled;
+    private _isStarted;
+    constructor(sandbox: SandboxLike & {
+        runtimeEnvs: Record<RuntimeEnvId, RuntimeEnvLike>;
+    }, config: ModelServiceConfig);
+    /** Whether the model service has been installed */
+    get isInstalled(): boolean;
+    /** Whether the model service has been started */
+    get isStarted(): boolean;
     /**
-     * Start sandbox service
+     * Install model service in the sandbox.
+     *
+     * Performs the following installation steps:
+     * 1. Create and initialize Python runtime environment (via RuntimeEnv).
+     * 2. Install model service package.
      */
-    startSandboxService(config?: ModelServiceConfig): ChildProcess;
+    install(): Promise<void>;
+    private _createRockConfig;
+    private _installModelService;
     /**
-     * Start and wait for service to be available
+     * Start the model service in the sandbox.
+     *
+     * Starts the service with configured logging settings.
      */
-    start(config?: ModelServiceConfig & {
-        timeoutSeconds?: number;
-    }): Promise<string>;
+    start(): Promise<void>;
     /**
-     * Start watching agent
+     * Stop the model service.
      */
-    startWatchAgent(agentPid: number, host?: string, port?: number): Promise<void>;
+    stop(): Promise<void>;
     /**
-     * Stop service
+     * Watch agent process with the specified PID.
      */
-    stop(pid: string): Promise<void>;
+    watchAgent(pid: string): Promise<void>;
     /**
-     * Wait for service to be available
+     * Execute anti-call LLM command.
      */
-    private waitServiceAvailable;
-    private sleep;
+    antiCallLlm(index: number, responsePayload?: string, callTimeout?: number): Promise<string>;
+}
+/**
+ * Minimal RuntimeEnv interface for type checking
+ */
+interface RuntimeEnvLike {
+    init(): Promise<void>;
+    run(cmd: string, mode?: string, waitTimeout?: number, errorMsg?: string): Promise<{
+        output: string;
+        exitCode?: number;
+    }>;
+    workdir: string;
+    wrappedCmd(cmd: string): string;
+}
+
+/**
+ * Agent configuration schemas
+ */
+
+/**
+ * Base agent configuration schema
+ */
+declare const AgentConfigSchema: z.ZodObject<{
+    agentType: z.ZodString;
+    version: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    agentType: string;
+}, {
+    agentType: string;
+    version?: string | undefined;
+}>;
+type AgentConfig = z.infer<typeof AgentConfigSchema>;
+/**
+ * Configuration for a command execution with timeout control
+ */
+declare const AgentBashCommandSchema: z.ZodObject<{
+    command: z.ZodString;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeoutSeconds: number;
+}, {
+    command: string;
+    timeoutSeconds?: number | undefined;
+}>;
+type AgentBashCommand = z.infer<typeof AgentBashCommandSchema>;
+/**
+ * Default agent configuration schema
+ */
+declare const DefaultAgentConfigSchema: z.ZodObject<{
+    agentType: z.ZodString;
+    version: z.ZodDefault<z.ZodString>;
+    agentSession: z.ZodDefault<z.ZodString>;
+    preInitBashCmdList: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        timeoutSeconds: number;
+    }, {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }>, "many">>;
+    postInitBashCmdList: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        timeoutSeconds: number;
+    }, {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }>, "many">>;
+    sessionEnvs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    modelServiceConfig: z.ZodDefault<z.ZodNullable<z.ZodType<{
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    }, z.ZodTypeDef, {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    agentType: string;
+    agentSession: string;
+    preInitBashCmdList: {
+        command: string;
+        timeoutSeconds: number;
+    }[];
+    postInitBashCmdList: {
+        command: string;
+        timeoutSeconds: number;
+    }[];
+    sessionEnvs: Record<string, string>;
+    modelServiceConfig: {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    } | null;
+}, {
+    agentType: string;
+    version?: string | undefined;
+    agentSession?: string | undefined;
+    preInitBashCmdList?: {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }[] | undefined;
+    postInitBashCmdList?: {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }[] | undefined;
+    sessionEnvs?: Record<string, string> | undefined;
+    modelServiceConfig?: {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    } | null | undefined;
+}>;
+type DefaultAgentConfig = z.infer<typeof DefaultAgentConfigSchema>;
+/**
+ * RockAgent configuration schema with validation
+ */
+declare const RockAgentConfigSchema: z.ZodEffects<z.ZodObject<{
+    agentType: z.ZodDefault<z.ZodString>;
+    agentName: z.ZodDefault<z.ZodString>;
+    version: z.ZodDefault<z.ZodString>;
+    agentInstalledDir: z.ZodDefault<z.ZodString>;
+    instanceId: z.ZodDefault<z.ZodString>;
+    projectPath: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    useDeployWorkingDirAsFallback: z.ZodDefault<z.ZodBoolean>;
+    agentSession: z.ZodDefault<z.ZodString>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    preInitCmds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        timeoutSeconds: number;
+    }, {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }>, "many">>;
+    postInitCmds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        timeoutSeconds: number;
+    }, {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }>, "many">>;
+    agentInstallTimeout: z.ZodDefault<z.ZodNumber>;
+    agentRunTimeout: z.ZodDefault<z.ZodNumber>;
+    agentRunCheckInterval: z.ZodDefault<z.ZodNumber>;
+    workingDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    runCmd: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    skipWrapRunCmd: z.ZodDefault<z.ZodBoolean>;
+    runtimeEnvConfig: z.ZodDefault<z.ZodNullable<z.ZodAny>>;
+    modelServiceConfig: z.ZodDefault<z.ZodNullable<z.ZodType<{
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    }, z.ZodTypeDef, {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    env: Record<string, string>;
+    version: string;
+    agentType: string;
+    agentSession: string;
+    modelServiceConfig: {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    } | null;
+    agentName: string;
+    agentInstalledDir: string;
+    instanceId: string;
+    projectPath: string | null;
+    useDeployWorkingDirAsFallback: boolean;
+    preInitCmds: {
+        command: string;
+        timeoutSeconds: number;
+    }[];
+    postInitCmds: {
+        command: string;
+        timeoutSeconds: number;
+    }[];
+    agentInstallTimeout: number;
+    agentRunTimeout: number;
+    agentRunCheckInterval: number;
+    workingDir: string | null;
+    runCmd: string | null;
+    skipWrapRunCmd: boolean;
+    runtimeEnvConfig?: any;
+}, {
+    env?: Record<string, string> | undefined;
+    version?: string | undefined;
+    runtimeEnvConfig?: any;
+    agentType?: string | undefined;
+    agentSession?: string | undefined;
+    modelServiceConfig?: {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    } | null | undefined;
+    agentName?: string | undefined;
+    agentInstalledDir?: string | undefined;
+    instanceId?: string | undefined;
+    projectPath?: string | null | undefined;
+    useDeployWorkingDirAsFallback?: boolean | undefined;
+    preInitCmds?: {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }[] | undefined;
+    postInitCmds?: {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }[] | undefined;
+    agentInstallTimeout?: number | undefined;
+    agentRunTimeout?: number | undefined;
+    agentRunCheckInterval?: number | undefined;
+    workingDir?: string | null | undefined;
+    runCmd?: string | null | undefined;
+    skipWrapRunCmd?: boolean | undefined;
+}>, {
+    env: Record<string, string>;
+    version: string;
+    agentType: string;
+    agentSession: string;
+    modelServiceConfig: {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    } | null;
+    agentName: string;
+    agentInstalledDir: string;
+    instanceId: string;
+    projectPath: string | null;
+    useDeployWorkingDirAsFallback: boolean;
+    preInitCmds: {
+        command: string;
+        timeoutSeconds: number;
+    }[];
+    postInitCmds: {
+        command: string;
+        timeoutSeconds: number;
+    }[];
+    agentInstallTimeout: number;
+    agentRunTimeout: number;
+    agentRunCheckInterval: number;
+    workingDir: string | null;
+    runCmd: string | null;
+    skipWrapRunCmd: boolean;
+    runtimeEnvConfig?: any;
+}, {
+    env?: Record<string, string> | undefined;
+    version?: string | undefined;
+    runtimeEnvConfig?: any;
+    agentType?: string | undefined;
+    agentSession?: string | undefined;
+    modelServiceConfig?: {
+        type: string;
+        installTimeout: number;
+        enabled: boolean;
+        installCmd: string;
+        runtimeEnvConfig: {
+            type: "python";
+            env: Record<string, string>;
+            pip: string | string[] | null;
+            version: "default" | "3.11" | "3.12";
+            installTimeout: number;
+            customInstallCmd: string | null;
+            extraSymlinkDir: string | null;
+            extraSymlinkExecutables: string[];
+            pipIndexUrl: string | null;
+        };
+        startCmd: string;
+        stopCmd: string;
+        configIniCmd: string;
+        watchAgentCmd: string;
+        antiCallLlmCmd: string;
+        antiCallLlmCmdNoResponse: string;
+        loggingPath: string;
+        loggingFileName: string;
+    } | null | undefined;
+    agentName?: string | undefined;
+    agentInstalledDir?: string | undefined;
+    instanceId?: string | undefined;
+    projectPath?: string | null | undefined;
+    useDeployWorkingDirAsFallback?: boolean | undefined;
+    preInitCmds?: {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }[] | undefined;
+    postInitCmds?: {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }[] | undefined;
+    agentInstallTimeout?: number | undefined;
+    agentRunTimeout?: number | undefined;
+    agentRunCheckInterval?: number | undefined;
+    workingDir?: string | null | undefined;
+    runCmd?: string | null | undefined;
+    skipWrapRunCmd?: boolean | undefined;
+}>;
+type RockAgentConfig = z.infer<typeof RockAgentConfigSchema>;
+
+/**
+ * Agent base classes
+ */
+
+/**
+ * Abstract Agent base class
+ */
+declare abstract class Agent {
+    protected _sandbox: SandboxLike;
+    protected _modelService: ModelService | null;
+    constructor(sandbox: SandboxLike);
+    get sandbox(): SandboxLike;
+    get modelService(): ModelService | null;
+    abstract install(config: RockAgentConfig): Promise<void>;
+    abstract run(prompt: string): Promise<Observation>;
+}
+/**
+ * DefaultAgent with common initialization and execution logic
+ */
+declare class DefaultAgent extends Agent {
+    protected _config: RockAgentConfig | null;
+    protected _agentSession: string | null;
+    get config(): RockAgentConfig | null;
+    get agentSession(): string | null;
+    get modelService(): ModelService | null;
+    install(config: RockAgentConfig): Promise<void>;
+    run(prompt: string): Promise<Observation>;
+    protected _setupSession(): Promise<void>;
+    protected _executeInitCommands(cmdList: Array<{
+        command: string;
+        timeoutSeconds: number;
+    }>, stepName: string): Promise<void>;
+    protected _createAgentRunCmd(prompt: string): Promise<string>;
+    protected _agentRun(cmd: string): Promise<Observation>;
 }
 
 /**
  * ROCK TypeScript SDK
  * Main entry point
  */
-declare const VERSION = "1.2.1";
+declare const VERSION: string;
 
-export { BadRequestRockError, type BaseConfig, type BashAction, BashActionSchema, type ChmodRequest, ChmodRequestSchema, type ChmodResponse, ChmodResponseSchema, type ChownRequest, ChownRequestSchema, type ChownResponse, ChownResponseSchema, type CloseResponse, CloseResponseSchema, type CloseSessionRequest, CloseSessionRequestSchema, type CloseSessionResponse, CloseSessionResponseSchema, Codes, type Command, type CommandResponse, CommandResponseSchema, CommandRockError, CommandSchema, Constants, type CreateBashSessionRequest, CreateBashSessionRequestSchema, type CreateSessionResponse, CreateSessionResponseSchema, Deploy, EnvHubClient, type EnvHubClientConfig, EnvHubClientConfigSchema, EnvHubError, type ExecuteBashSessionResponse, ExecuteBashSessionResponseSchema, HttpUtils, InternalServerRockError, InvalidParameterRockException, type IsAliveResponse, IsAliveResponseSchema, LinuxFileSystem, LinuxRemoteUser, ModelClient, type ModelClientConfig, ModelService, type ModelServiceConfig, Network, type Observation, ObservationSchema, type OssSetupResponse, OssSetupResponseSchema, PID_PREFIX, PID_SUFFIX, Process, type ReadFileRequest, ReadFileRequestSchema, type ReadFileResponse, ReadFileResponseSchema, ReasonPhrases, type ResetResult, RockEnv, type RockEnvConfig, type RockEnvInfo, RockEnvInfoSchema, RockException, RunMode, type RunModeType$1 as RunModeType, Sandbox, type SandboxConfig, SandboxConfigSchema, SandboxGroup, type SandboxGroupConfig, SandboxGroupConfigSchema, type SandboxResponse, SandboxResponseSchema, type RunModeType as SandboxRunModeType, type SandboxStatusResponse, SandboxStatusResponseSchema, SpeedupType, type StepResult, type UploadRequest, UploadRequestSchema, type UploadResponse, UploadResponseSchema, VERSION, type WriteFileRequest, WriteFileRequestSchema, type WriteFileResponse, WriteFileResponseSchema, arunWithRetry, createRockEnvInfo, createSandboxConfig, createSandboxGroupConfig, deprecated, deprecatedClass, extractNohupPid as extractNohupPidFromSandbox, fromRockException, getEnv, getReasonPhrase, getRequiredEnv, isBrowser, isClientError, isCommandError, isEnvSet, isError, isNode, isServerError, isSuccess, make, raiseForCode, retryAsync, sleep, withRetry, withTimeLogging };
+export { Agent, type AgentBashCommand, AgentBashCommandSchema, type AgentConfig, AgentConfigSchema, BadRequestRockError, type BaseConfig, type BashAction, BashActionSchema, type ChmodRequest, ChmodRequestSchema, type ChmodResponse, ChmodResponseSchema, type ChownRequest, ChownRequestSchema, type ChownResponse, ChownResponseSchema, type CloseResponse, CloseResponseSchema, type CloseSessionRequest, CloseSessionRequestSchema, type CloseSessionResponse, CloseSessionResponseSchema, Codes, type Command, type CommandResponse, CommandResponseSchema, CommandRockError, CommandSchema, type CreateBashSessionRequest, CreateBashSessionRequestSchema, type CreateSessionResponse, CreateSessionResponseSchema, DefaultAgent, type DefaultAgentConfig, DefaultAgentConfigSchema, Deploy, EnvHubClient, type EnvHubClientConfig, EnvHubClientConfigSchema, EnvHubError, type ExecuteBashSessionResponse, ExecuteBashSessionResponseSchema, HttpUtils, InternalServerRockError, InvalidParameterRockException, type IsAliveResponse, IsAliveResponseSchema, LinuxFileSystem, LinuxRemoteUser, ModelClient, type ModelClientConfig, ModelService, type ModelServiceConfig, ModelServiceConfigSchema, NODE_DEFAULT_VERSION, Network, NodeRuntimeEnv, type NodeRuntimeEnvConfig, NodeRuntimeEnvConfigSchema, type Observation, ObservationSchema, type OssSetupResponse, OssSetupResponseSchema, PID_PREFIX, PID_SUFFIX, type PollOptions, Process, PythonRuntimeEnv, type PythonRuntimeEnvConfig, PythonRuntimeEnvConfigSchema, type ReadFileRequest, ReadFileRequestSchema, type ReadFileResponse, ReadFileResponseSchema, ReasonPhrases, type ResetResult, type RockAgentConfig, RockAgentConfigSchema, RockEnv, type RockEnvConfig, type RockEnvInfo, RockEnvInfoSchema, RockException, RunMode, type RunModeType, RuntimeEnv, type RuntimeEnvConfig, RuntimeEnvConfigSchema, type RuntimeEnvId, Sandbox, type SandboxConfig, SandboxConfigSchema, SandboxGroup, type SandboxGroupConfig, SandboxGroupConfigSchema, type SandboxLike, type SandboxResponse, SandboxResponseSchema, type RunModeType as SandboxRunModeType, type SandboxStatusResponse, SandboxStatusResponseSchema, SpeedupType, type StepResult, type UploadRequest, UploadRequestSchema, type UploadResponse, UploadResponseSchema, VERSION, type WriteFileRequest, WriteFileRequestSchema, type WriteFileResponse, WriteFileResponseSchema, arunWithRetry, createRockEnvInfo, createRuntimeEnvId, createSandboxConfig, createSandboxGroupConfig, deprecated, deprecatedClass, extractNohupPid as extractNohupPidFromSandbox, fromRockException, getDefaultPipIndexUrl, getEnv, getReasonPhrase, getRequiredEnv, isClientError, isCommandError, isEnvSet, isError, isNode, isServerError, isSuccess, make, raiseForCode, retryAsync, sleep, withRetry, withTimeLogging };