@fastgpt-sdk/sandbox-adapter 0.0.32 → 0.0.33

package/dist/adapters/BaseSandboxAdapter.d.ts

@@ -14,6 +14,19 @@ export declare abstract class BaseSandboxAdapter implements ISandbox {
     protected _status: SandboxStatus;
     protected polyfillService?: CommandPolyfillService;
     constructor();
+    /**
+     * The root path of the sandbox filesystem.
+     * Subclasses should override this to return the provider-specific root path.
+     */
+    get rootPath(): string;
+    /**
+     * Normalize a path relative to rootPath.
+     * - '.' or './' → rootPath
+     * - './foo' → rootPath/foo
+     * - 'foo' → rootPath/foo
+     * - '/absolute' → '/absolute' (pass through)
+     */
+    protected normalizePath(path?: string): string;
     get status(): SandboxStatus;
     abstract ensureRunning(): Promise<void>;
     abstract create(): Promise<void>;

package/dist/adapters/E2BAdapter/index.d.ts

@@ -9,6 +9,7 @@ import type { E2BConfig } from './type';
 export declare class E2BAdapter extends BaseSandboxAdapter {
     private config;
     readonly provider: "e2b";
+    get rootPath(): string;
     private sandbox;
     private _id;
     constructor(config: E2BConfig);

package/dist/adapters/OpenSandboxAdapter/index.d.ts

@@ -58,6 +58,7 @@ export declare class OpenSandboxAdapter extends BaseSandboxAdapter {
     private _connection;
     private _id?;
     constructor(connectionConfig: OpenSandboxConnectionConfig, createConfig: OpenSandboxConfigType);
+    get rootPath(): string;
     get id(): SandboxId | undefined;
     private set sandbox(value);
     private get sandbox();

package/dist/adapters/SealosDevboxAdapter/index.d.ts

@@ -13,6 +13,7 @@ export interface SealosDevboxConfig {
 export declare class SealosDevboxAdapter extends BaseSandboxAdapter {
     private config;
     readonly provider: "sealosdevbox";
+    get rootPath(): string;
     private api;
     private _id;
     constructor(config: SealosDevboxConfig);

package/dist/index.cjs

@@ -47506,6 +47506,19 @@ class BaseSandboxAdapter {
   _status = { state: "Creating" };
   polyfillService;
   constructor() {}
+  get rootPath() {
+    return "/";
+  }
+  normalizePath(path = "") {
+    if (path === "." || path === "./")
+      return this.rootPath;
+    const root = this.rootPath.replace(/\/+$/, "");
+    if (path.startsWith("./"))
+      return `${root}/${path.slice(2)}`;
+    if (!path.startsWith("/"))
+      return `${root}/${path}`;
+    return path;
+  }
   get status() {
     return this._status;
   }
@@ -47557,7 +47570,7 @@ class BaseSandboxAdapter {
   async readFiles(paths, options) {
     const polyfillService = this.requirePolyfillService("readFiles", "File read not supported by this provider");
     const results = [];
-    for (const path of paths) {
+    for (const path of paths.map((p) => this.normalizePath(p))) {
       try {
         let content;
         if (options?.range) {
@@ -47585,7 +47598,7 @@ class BaseSandboxAdapter {
   async writeFiles(entries) {
     const polyfillService = this.requirePolyfillService("writeFiles", "File write not supported by this provider");
     const results = [];
-    for (const entry of entries) {
+    for (const entry of entries.map((e) => ({ ...e, path: this.normalizePath(e.path) }))) {
       try {
         let bytesWritten;
         if (typeof entry.data === "string") {
@@ -47629,7 +47642,7 @@ class BaseSandboxAdapter {
   }
   async deleteFiles(paths) {
     const polyfillService = this.requirePolyfillService("deleteFiles", "File delete not supported by this provider");
-    const polyfillResults = await polyfillService.deleteFiles(paths);
+    const polyfillResults = await polyfillService.deleteFiles(paths.map((p) => this.normalizePath(p)));
     return polyfillResults.map((r) => ({
       path: r.path,
       success: r.success,
@@ -47638,7 +47651,10 @@ class BaseSandboxAdapter {
   }
   async moveFiles(entries) {
     const polyfillService = this.requirePolyfillService("moveFiles", "File move not supported by this provider");
-    await polyfillService.moveFiles(entries.map((e) => ({ source: e.source, destination: e.destination })));
+    await polyfillService.moveFiles(entries.map((e) => ({
+      source: this.normalizePath(e.source),
+      destination: this.normalizePath(e.destination)
+    })));
   }
   async replaceContent(entries) {
     const polyfillService = this.requirePolyfillService("replaceContent", "Content replace not supported by this provider");
@@ -47646,15 +47662,15 @@ class BaseSandboxAdapter {
   }
   async createDirectories(paths, options) {
     const polyfillService = this.requirePolyfillService("createDirectories", "Directory creation not supported by this provider");
-    await polyfillService.createDirectories(paths, options);
+    await polyfillService.createDirectories(paths.map((p) => this.normalizePath(p)), options);
   }
   async deleteDirectories(paths, options) {
     const polyfillService = this.requirePolyfillService("deleteDirectories", "Directory deletion not supported by this provider");
-    await polyfillService.deleteDirectories(paths, options);
+    await polyfillService.deleteDirectories(paths.map((p) => this.normalizePath(p)), options);
   }
   async listDirectory(path) {
     const polyfillService = this.requirePolyfillService("listDirectory", "Directory listing not supported by this provider");
-    return polyfillService.listDirectory(path);
+    return polyfillService.listDirectory(this.normalizePath(path));
   }
   async* readFileStream(path) {
     this.requirePolyfillService("readFileStream", "File stream read not supported by this provider");
@@ -47706,7 +47722,7 @@ class BaseSandboxAdapter {
   }
   async getFileInfo(paths) {
     const polyfillService = this.requirePolyfillService("getFileInfo", "File info not supported by this provider");
-    return polyfillService.getFileInfo(paths);
+    return polyfillService.getFileInfo(paths.map((p) => this.normalizePath(p)));
   }
   async setPermissions(entries) {
     const polyfillService = this.requirePolyfillService("setPermissions", "Permission setting not supported by this provider");
@@ -47714,7 +47730,7 @@ class BaseSandboxAdapter {
   }
   async search(pattern, path) {
     const polyfillService = this.requirePolyfillService("search", "File search not supported by this provider");
-    return polyfillService.search(pattern, path);
+    return polyfillService.search(pattern, path !== undefined ? this.normalizePath(path) : path);
   }
   async ping() {
     const polyfillService = this.requirePolyfillService("ping", "Health check not supported by this provider");
@@ -47837,6 +47853,9 @@ class DevboxApi {
 class SealosDevboxAdapter extends BaseSandboxAdapter {
   config;
   provider = "sealosdevbox";
+  get rootPath() {
+    return "/home/devbox/workspace";
+  }
   api;
   _id;
   constructor(config) {
@@ -47956,7 +47975,7 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
     }
   }
   async execute(command, options) {
-    const cmd = this.buildCommand(command, options?.workingDirectory);
+    const cmd = this.buildCommand(command, this.normalizePath(options?.workingDirectory));
     try {
       const res = await this.api.exec(this._id, {
         command: cmd,
@@ -48004,6 +48023,10 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
     this._connection = this.createConnectionConfig();
     this.polyfillService = new CommandPolyfillService(this);
   }
+  get rootPath() {
+    const mountPath = this.createConfig.volumes?.[0]?.mountPath;
+    return mountPath ? mountPath.replace(/\/+$/, "") : "/home/sandbox";
+  }
   get id() {
     return this._id;
   }
@@ -48331,7 +48354,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
   async execute(command, options) {
     try {
       const execution = await this.sandbox.commands.run(command, {
-        workingDirectory: options?.workingDirectory,
+        workingDirectory: this.normalizePath(options?.workingDirectory),
         background: options?.background
       });
       const stdout = execution.logs.stdout.map((msg) => msg.text).join(`
@@ -48368,7 +48391,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
         } : {}
       };
       const execution = await this.sandbox.commands.run(command, {
-        workingDirectory: options?.workingDirectory,
+        workingDirectory: this.normalizePath(options?.workingDirectory),
         background: options?.background
       }, sdkHandlers);
       if (handlers.onComplete) {
@@ -48390,7 +48413,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
   async executeBackground(command, options) {
     try {
       const execution = await this.sandbox.commands.run(command, {
-        workingDirectory: options?.workingDirectory,
+        workingDirectory: this.normalizePath(options?.workingDirectory),
         background: true
       });
       if (!execution.id) {
@@ -48438,6 +48461,9 @@ var import_code_interpreter = __toESM(require_dist4());
 class E2BAdapter extends BaseSandboxAdapter {
   config;
   provider = "e2b";
+  get rootPath() {
+    return "/home/user";
+  }
   sandbox = null;
   _id;
   constructor(config) {
@@ -48567,7 +48593,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     try {
       const sandbox = await this.ensureSandbox();
       const result = await sandbox.commands.run(command, {
-        cwd: options?.workingDirectory,
+        cwd: this.normalizePath(options?.workingDirectory),
         timeoutMs: options?.timeoutMs
       });
       return {
@@ -48590,7 +48616,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     const sandbox = await this.ensureSandbox();
     try {
       const results = [];
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         try {
           const content = await sandbox.files.read(path);
           results.push({
@@ -48627,7 +48653,7 @@ class E2BAdapter extends BaseSandboxAdapter {
           data = "";
         }
         return {
-          path: f.path,
+          path: this.normalizePath(f.path),
           data
         };
       });
@@ -48666,7 +48692,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     const sandbox = await this.ensureSandbox();
     try {
       const results = [];
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         try {
           await sandbox.files.remove(path);
           results.push({
@@ -48691,7 +48717,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     const sandbox = await this.ensureSandbox();
     try {
       for (const { source, destination } of moves) {
-        await sandbox.files.rename(source, destination);
+        await sandbox.files.rename(this.normalizePath(source), this.normalizePath(destination));
       }
     } catch (error) {
       throw new CommandExecutionError("Failed to move files", "moveFiles", error instanceof Error ? error : undefined);
@@ -48700,7 +48726,7 @@ class E2BAdapter extends BaseSandboxAdapter {
   async createDirectories(paths) {
     const sandbox = await this.ensureSandbox();
     try {
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         await sandbox.files.makeDir(path);
       }
     } catch (error) {
@@ -48710,7 +48736,7 @@ class E2BAdapter extends BaseSandboxAdapter {
   async deleteDirectories(paths) {
     const sandbox = await this.ensureSandbox();
     try {
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         await sandbox.files.remove(path);
       }
     } catch (error) {
@@ -48720,7 +48746,7 @@ class E2BAdapter extends BaseSandboxAdapter {
   async listDirectory(path) {
     const sandbox = await this.ensureSandbox();
     try {
-      const entries = await sandbox.files.list(path);
+      const entries = await sandbox.files.list(this.normalizePath(path));
       return entries.map((entry) => {
         const isDirectory = entry.type === import_code_interpreter.FileType.DIR;
         return {

package/dist/index.js

@@ -47490,6 +47490,19 @@ class BaseSandboxAdapter {
   _status = { state: "Creating" };
   polyfillService;
   constructor() {}
+  get rootPath() {
+    return "/";
+  }
+  normalizePath(path = "") {
+    if (path === "." || path === "./")
+      return this.rootPath;
+    const root = this.rootPath.replace(/\/+$/, "");
+    if (path.startsWith("./"))
+      return `${root}/${path.slice(2)}`;
+    if (!path.startsWith("/"))
+      return `${root}/${path}`;
+    return path;
+  }
   get status() {
     return this._status;
   }
@@ -47541,7 +47554,7 @@ class BaseSandboxAdapter {
   async readFiles(paths, options) {
     const polyfillService = this.requirePolyfillService("readFiles", "File read not supported by this provider");
     const results = [];
-    for (const path of paths) {
+    for (const path of paths.map((p) => this.normalizePath(p))) {
       try {
         let content;
         if (options?.range) {
@@ -47569,7 +47582,7 @@ class BaseSandboxAdapter {
   async writeFiles(entries) {
     const polyfillService = this.requirePolyfillService("writeFiles", "File write not supported by this provider");
     const results = [];
-    for (const entry of entries) {
+    for (const entry of entries.map((e) => ({ ...e, path: this.normalizePath(e.path) }))) {
       try {
         let bytesWritten;
         if (typeof entry.data === "string") {
@@ -47613,7 +47626,7 @@ class BaseSandboxAdapter {
   }
   async deleteFiles(paths) {
     const polyfillService = this.requirePolyfillService("deleteFiles", "File delete not supported by this provider");
-    const polyfillResults = await polyfillService.deleteFiles(paths);
+    const polyfillResults = await polyfillService.deleteFiles(paths.map((p) => this.normalizePath(p)));
     return polyfillResults.map((r) => ({
       path: r.path,
       success: r.success,
@@ -47622,7 +47635,10 @@ class BaseSandboxAdapter {
   }
   async moveFiles(entries) {
     const polyfillService = this.requirePolyfillService("moveFiles", "File move not supported by this provider");
-    await polyfillService.moveFiles(entries.map((e) => ({ source: e.source, destination: e.destination })));
+    await polyfillService.moveFiles(entries.map((e) => ({
+      source: this.normalizePath(e.source),
+      destination: this.normalizePath(e.destination)
+    })));
   }
   async replaceContent(entries) {
     const polyfillService = this.requirePolyfillService("replaceContent", "Content replace not supported by this provider");
@@ -47630,15 +47646,15 @@ class BaseSandboxAdapter {
   }
   async createDirectories(paths, options) {
     const polyfillService = this.requirePolyfillService("createDirectories", "Directory creation not supported by this provider");
-    await polyfillService.createDirectories(paths, options);
+    await polyfillService.createDirectories(paths.map((p) => this.normalizePath(p)), options);
   }
   async deleteDirectories(paths, options) {
     const polyfillService = this.requirePolyfillService("deleteDirectories", "Directory deletion not supported by this provider");
-    await polyfillService.deleteDirectories(paths, options);
+    await polyfillService.deleteDirectories(paths.map((p) => this.normalizePath(p)), options);
   }
   async listDirectory(path) {
     const polyfillService = this.requirePolyfillService("listDirectory", "Directory listing not supported by this provider");
-    return polyfillService.listDirectory(path);
+    return polyfillService.listDirectory(this.normalizePath(path));
   }
   async* readFileStream(path) {
     this.requirePolyfillService("readFileStream", "File stream read not supported by this provider");
@@ -47690,7 +47706,7 @@ class BaseSandboxAdapter {
   }
   async getFileInfo(paths) {
     const polyfillService = this.requirePolyfillService("getFileInfo", "File info not supported by this provider");
-    return polyfillService.getFileInfo(paths);
+    return polyfillService.getFileInfo(paths.map((p) => this.normalizePath(p)));
   }
   async setPermissions(entries) {
     const polyfillService = this.requirePolyfillService("setPermissions", "Permission setting not supported by this provider");
@@ -47698,7 +47714,7 @@ class BaseSandboxAdapter {
   }
   async search(pattern, path) {
     const polyfillService = this.requirePolyfillService("search", "File search not supported by this provider");
-    return polyfillService.search(pattern, path);
+    return polyfillService.search(pattern, path !== undefined ? this.normalizePath(path) : path);
   }
   async ping() {
     const polyfillService = this.requirePolyfillService("ping", "Health check not supported by this provider");
@@ -47821,6 +47837,9 @@ class DevboxApi {
 class SealosDevboxAdapter extends BaseSandboxAdapter {
   config;
   provider = "sealosdevbox";
+  get rootPath() {
+    return "/home/devbox/workspace";
+  }
   api;
   _id;
   constructor(config) {
@@ -47940,7 +47959,7 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
     }
   }
   async execute(command, options) {
-    const cmd = this.buildCommand(command, options?.workingDirectory);
+    const cmd = this.buildCommand(command, this.normalizePath(options?.workingDirectory));
     try {
       const res = await this.api.exec(this._id, {
         command: cmd,
@@ -47988,6 +48007,10 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
     this._connection = this.createConnectionConfig();
     this.polyfillService = new CommandPolyfillService(this);
   }
+  get rootPath() {
+    const mountPath = this.createConfig.volumes?.[0]?.mountPath;
+    return mountPath ? mountPath.replace(/\/+$/, "") : "/home/sandbox";
+  }
   get id() {
     return this._id;
   }
@@ -48315,7 +48338,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
   async execute(command, options) {
     try {
       const execution = await this.sandbox.commands.run(command, {
-        workingDirectory: options?.workingDirectory,
+        workingDirectory: this.normalizePath(options?.workingDirectory),
         background: options?.background
       });
       const stdout = execution.logs.stdout.map((msg) => msg.text).join(`
@@ -48352,7 +48375,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
         } : {}
       };
       const execution = await this.sandbox.commands.run(command, {
-        workingDirectory: options?.workingDirectory,
+        workingDirectory: this.normalizePath(options?.workingDirectory),
         background: options?.background
       }, sdkHandlers);
       if (handlers.onComplete) {
@@ -48374,7 +48397,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
   async executeBackground(command, options) {
     try {
       const execution = await this.sandbox.commands.run(command, {
-        workingDirectory: options?.workingDirectory,
+        workingDirectory: this.normalizePath(options?.workingDirectory),
         background: true
       });
       if (!execution.id) {
@@ -48422,6 +48445,9 @@ var import_code_interpreter = __toESM(require_dist4(), 1);
 class E2BAdapter extends BaseSandboxAdapter {
   config;
   provider = "e2b";
+  get rootPath() {
+    return "/home/user";
+  }
   sandbox = null;
   _id;
   constructor(config) {
@@ -48551,7 +48577,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     try {
       const sandbox = await this.ensureSandbox();
       const result = await sandbox.commands.run(command, {
-        cwd: options?.workingDirectory,
+        cwd: this.normalizePath(options?.workingDirectory),
         timeoutMs: options?.timeoutMs
       });
       return {
@@ -48574,7 +48600,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     const sandbox = await this.ensureSandbox();
     try {
       const results = [];
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         try {
           const content = await sandbox.files.read(path);
           results.push({
@@ -48611,7 +48637,7 @@ class E2BAdapter extends BaseSandboxAdapter {
           data = "";
         }
         return {
-          path: f.path,
+          path: this.normalizePath(f.path),
           data
         };
       });
@@ -48650,7 +48676,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     const sandbox = await this.ensureSandbox();
     try {
       const results = [];
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         try {
           await sandbox.files.remove(path);
           results.push({
@@ -48675,7 +48701,7 @@ class E2BAdapter extends BaseSandboxAdapter {
     const sandbox = await this.ensureSandbox();
     try {
       for (const { source, destination } of moves) {
-        await sandbox.files.rename(source, destination);
+        await sandbox.files.rename(this.normalizePath(source), this.normalizePath(destination));
       }
     } catch (error) {
       throw new CommandExecutionError("Failed to move files", "moveFiles", error instanceof Error ? error : undefined);
@@ -48684,7 +48710,7 @@ class E2BAdapter extends BaseSandboxAdapter {
   async createDirectories(paths) {
     const sandbox = await this.ensureSandbox();
     try {
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         await sandbox.files.makeDir(path);
       }
     } catch (error) {
@@ -48694,7 +48720,7 @@ class E2BAdapter extends BaseSandboxAdapter {
   async deleteDirectories(paths) {
     const sandbox = await this.ensureSandbox();
     try {
-      for (const path of paths) {
+      for (const path of paths.map((p) => this.normalizePath(p))) {
         await sandbox.files.remove(path);
       }
     } catch (error) {
@@ -48704,7 +48730,7 @@ class E2BAdapter extends BaseSandboxAdapter {
   async listDirectory(path) {
     const sandbox = await this.ensureSandbox();
     try {
-      const entries = await sandbox.files.list(path);
+      const entries = await sandbox.files.list(this.normalizePath(path));
       return entries.map((entry) => {
         const isDirectory = entry.type === import_code_interpreter.FileType.DIR;
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastgpt-sdk/sandbox-adapter",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "Unified abstraction layer for cloud sandbox providers with adapter pattern and feature polyfilling",
   "type": "module",
   "main": "./dist/index.cjs",