feat(sandbox): add NAS, OSS, and PolarFS configuration support

Add new configuration interfaces for NAS, OSS, and PolarFS mounting capabilities across sandbox implementations. Update createFromTemplate methods and API calls to accept these new configuration options. Enhance model definitions with comprehensive type interfaces for cloud storage integrations.

New types added:
- NASConfig/NASMountConfig for Network Attached Storage
- OSSMountConfig/OSSMountPoint for Object Storage Service
- PolarFsConfig/PolarFsMountConfig for Polar File System

The changes enable advanced storage mounting scenarios for sandbox environments.

Change-Id: Ib07c8562f9056a15cbe95718a7194addc2ac002b
Signed-off-by: OhYee <[email protected]>

Author: OhYee

package.json

@@ -55,7 +55,7 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^3.0.0",
-    "@alicloud/agentrun20250910": "^4.0.3",
+    "@alicloud/agentrun20250910": "^5.0.0",
     "@alicloud/devs20230714": "^2.4.1",
     "@alicloud/openapi-client": "^0.4.12",
     "@alicloud/tea-util": "^1.4.9",

src/sandbox/aio-sandbox.ts

@@ -10,7 +10,13 @@ import { logger } from "../utils/log";
 import { ServerError } from "../utils/exception";
 
 import { AioDataAPI } from "./api/aio-data";
-import { CodeLanguage, TemplateType } from "./model";
+import {
+  CodeLanguage,
+  NASConfig,
+  OSSMountConfig,
+  PolarFsConfig,
+  TemplateType,
+} from "./model";
 import { Sandbox } from "./sandbox";
 
 /**
@@ -288,18 +294,25 @@ export class AioSandbox extends Sandbox {
 
   /**
    * Create an AIO Sandbox from template
+   * 从模板创建 AIO 沙箱 / Create AIO Sandbox from Template
    */
   static async createFromTemplate(
     templateName: string,
     options?: {
       sandboxIdleTimeoutSeconds?: number;
+      nasConfig?: NASConfig;
+      ossMountConfig?: OSSMountConfig;
+      polarFsConfig?: PolarFsConfig;
     },
     config?: Config,
   ): Promise<AioSandbox> {
     const sandbox = await Sandbox.create(
       {
         templateName,
         sandboxIdleTimeoutSeconds: options?.sandboxIdleTimeoutSeconds,
+        nasConfig: options?.nasConfig,
+        ossMountConfig: options?.ossMountConfig,
+        polarFsConfig: options?.polarFsConfig,
       },
       config,
     );

src/sandbox/api/sandbox-data.ts

@@ -401,23 +401,41 @@ export class SandboxDataAPI {
 
   /**
    * Create sandbox from template
+   * 从模板创建沙箱 / Create Sandbox from Template
    */
   createSandbox = async (params: {
     templateName: string;
     sandboxIdleTimeoutSeconds?: number;
+    nasConfig?: Record<string, any>;
+    ossMountConfig?: Record<string, any>;
+    polarFsConfig?: Record<string, any>;
     config?: Config;
   }): Promise<any> => {
     await this.refreshAccessToken({
       templateName: params.templateName,
       config: params.config,
     });
 
+    // Build request data / 构建请求数据
+    const data: Record<string, any> = {
+      templateName: params.templateName,
+      sandboxIdleTimeoutSeconds: params.sandboxIdleTimeoutSeconds || 600,
+    };
+
+    // Add optional parameters / 添加可选参数
+    if (params.nasConfig !== undefined) {
+      data.nasConfig = params.nasConfig;
+    }
+    if (params.ossMountConfig !== undefined) {
+      data.ossMountConfig = params.ossMountConfig;
+    }
+    if (params.polarFsConfig !== undefined) {
+      data.polarFsConfig = params.polarFsConfig;
+    }
+
     return this.post({
       path: "/",
-      data: {
-        templateName: params.templateName,
-        sandboxIdleTimeoutSeconds: params.sandboxIdleTimeoutSeconds || 600,
-      },
+      data,
     });
   };
 

src/sandbox/browser-sandbox.ts

@@ -9,7 +9,12 @@ import { Config } from "../utils/config";
 import { logger } from "../utils/log";
 
 import { BrowserDataAPI } from "./api/browser-data";
-import { TemplateType } from "./model";
+import {
+  NASConfig,
+  OSSMountConfig,
+  PolarFsConfig,
+  TemplateType,
+} from "./model";
 import { Sandbox } from "./sandbox";
 
 /**
@@ -22,18 +27,25 @@ export class BrowserSandbox extends Sandbox {
 
   /**
    * Create a Browser Sandbox from template
+   * 从模板创建浏览器沙箱 / Create Browser Sandbox from Template
    */
   static async createFromTemplate(
     templateName: string,
     options?: {
       sandboxIdleTimeoutSeconds?: number;
+      nasConfig?: NASConfig;
+      ossMountConfig?: OSSMountConfig;
+      polarFsConfig?: PolarFsConfig;
     },
     config?: Config,
   ): Promise<BrowserSandbox> {
     const sandbox = await Sandbox.create(
       {
         templateName,
         sandboxIdleTimeoutSeconds: options?.sandboxIdleTimeoutSeconds,
+        nasConfig: options?.nasConfig,
+        ossMountConfig: options?.ossMountConfig,
+        polarFsConfig: options?.polarFsConfig,
       },
       config,
     );

src/sandbox/client.ts

@@ -10,6 +10,9 @@ import { Config } from "../utils/config";
 import { BrowserSandbox } from "./browser-sandbox";
 import { CodeInterpreterSandbox } from "./code-interpreter-sandbox";
 import {
+  NASConfig,
+  OSSMountConfig,
+  PolarFsConfig,
   SandboxCreateInput,
   SandboxListInput,
   TemplateCreateInput,
@@ -116,10 +119,16 @@ export class SandboxClient {
 
   /**
    * Create a Code Interpreter Sandbox
+   * 创建代码解释器沙箱 / Create Code Interpreter Sandbox
    */
   createCodeInterpreterSandbox = async (params: {
     templateName: string;
-    options?: { sandboxIdleTimeoutSeconds?: number };
+    options?: {
+      sandboxIdleTimeoutSeconds?: number;
+      nasConfig?: NASConfig;
+      ossMountConfig?: OSSMountConfig;
+      polarFsConfig?: PolarFsConfig;
+    };
     config?: Config;
   }): Promise<CodeInterpreterSandbox> => {
     const { templateName, options, config } = params;
@@ -132,10 +141,16 @@ export class SandboxClient {
 
   /**
    * Create a Browser Sandbox
+   * 创建浏览器沙箱 / Create Browser Sandbox
    */
   createBrowserSandbox = async (params: {
     templateName: string;
-    options?: { sandboxIdleTimeoutSeconds?: number };
+    options?: {
+      sandboxIdleTimeoutSeconds?: number;
+      nasConfig?: NASConfig;
+      ossMountConfig?: OSSMountConfig;
+      polarFsConfig?: PolarFsConfig;
+    };
     config?: Config;
   }): Promise<BrowserSandbox> => {
     const { templateName, options, config } = params;

src/sandbox/code-interpreter-sandbox.ts

@@ -10,7 +10,13 @@ import { logger } from "../utils/log";
 import { ServerError } from "../utils/exception";
 
 import { CodeInterpreterDataAPI } from "./api/code-interpreter-data";
-import { CodeLanguage, TemplateType } from "./model";
+import {
+  CodeLanguage,
+  NASConfig,
+  OSSMountConfig,
+  PolarFsConfig,
+  TemplateType,
+} from "./model";
 import { Sandbox } from "./sandbox";
 
 /**
@@ -288,18 +294,25 @@ export class CodeInterpreterSandbox extends Sandbox {
 
   /**
    * Create a Code Interpreter Sandbox from template
+   * 从模板创建代码解释器沙箱 / Create Code Interpreter Sandbox from Template
    */
   static async createFromTemplate(
     templateName: string,
     options?: {
       sandboxIdleTimeoutSeconds?: number;
+      nasConfig?: NASConfig;
+      ossMountConfig?: OSSMountConfig;
+      polarFsConfig?: PolarFsConfig;
     },
     config?: Config,
   ): Promise<CodeInterpreterSandbox> {
     const sandbox = await Sandbox.create(
       {
         templateName,
         sandboxIdleTimeoutSeconds: options?.sandboxIdleTimeoutSeconds,
+        nasConfig: options?.nasConfig,
+        ossMountConfig: options?.ossMountConfig,
+        polarFsConfig: options?.polarFsConfig,
       },
       config,
     );

src/sandbox/index.ts

@@ -41,4 +41,11 @@ export type {
   SandboxData,
   ExecuteCodeResult,
   FileInfo,
+  // New types / 新增类型
+  NASConfig,
+  NASMountConfig,
+  OSSMountConfig,
+  OSSMountPoint,
+  PolarFsConfig,
+  PolarFsMountConfig,
 } from "./model";