Merge pull request #2 from Serverless-Devs/feat-dynamic-mount

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

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";