@fastgpt-sdk/sandbox-adapter 0.0.38 → 0.0.40-beta.0

package/dist/adapters/BaseSandboxAdapter.d.ts

@@ -32,7 +32,7 @@ export declare abstract class BaseSandboxAdapter implements ISandbox {
     abstract create(): Promise<void>;
     abstract start(): Promise<void>;
     abstract stop(): Promise<void>;
-    abstract delete(): Promise<void>;
+    abstract delete(sandboxId?: SandboxId): Promise<void>;
     abstract getInfo(): Promise<SandboxInfo | null>;
     waitUntilReady(timeoutMs?: number): Promise<void>;
     waitUntilDeleted(timeoutMs?: number): Promise<void>;

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

@@ -24,7 +24,7 @@ export declare class E2BAdapter extends BaseSandboxAdapter {
     create(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
-    delete(): Promise<void>;
+    delete(sandboxId?: SandboxId): Promise<void>;
     getInfo(): Promise<SandboxInfo | null>;
     execute(command: string, options?: ExecuteOptions): Promise<ExecuteResult>;
     readFiles(paths: string[]): Promise<FileReadResult[]>;

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

@@ -80,7 +80,7 @@ export declare class OpenSandboxAdapter extends BaseSandboxAdapter {
     private resume;
     start(): Promise<void>;
     stop(): Promise<void>;
-    delete(): Promise<void>;
+    delete(sandboxId?: SandboxId): Promise<void>;
     /**
      * Release client-side resources owned by this Sandbox instance.
      * Does NOT stop or delete the container - the sandbox keeps running.

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

@@ -16,6 +16,8 @@ export declare class DevboxApi {
     info(name: string): Promise<DevboxApiResponse<DevboxInfoData>>;
     /** POST /api/v1/devbox/{name}/pause */
     pause(name: string): Promise<DevboxApiResponse<DevboxMutationData>>;
+    /** POST /api/v1/devbox/{name}/stop */
+    stop(name: string): Promise<DevboxApiResponse<DevboxMutationData>>;
     /** POST /api/v1/devbox/{name}/resume */
     resume(name: string): Promise<DevboxApiResponse<DevboxMutationData>>;
     /** DELETE /api/v1/devbox/{name} */

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

@@ -41,7 +41,7 @@ export declare class SealosDevboxAdapter extends BaseSandboxAdapter {
     create(): Promise<void>;
     stop(): Promise<void>;
     start(): Promise<void>;
-    delete(): Promise<void>;
+    delete(sandboxId?: SandboxId): Promise<void>;
     execute(command: string, options?: ExecuteOptions): Promise<ExecuteResult>;
     getEndpoint(selector: SandboxEndpointSelector): Promise<Endpoint>;
     getProxyTarget(service?: SandboxProxyService): Promise<SandboxProxyTarget>;

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

@@ -46,9 +46,10 @@ export interface ExecResponseData {
     stderr: string;
     executedAt: string;
 }
-/** Response data from create/pause/resume/delete endpoints. */
+/** Response data from create/pause/stop/resume/delete endpoints. */
 export interface DevboxMutationData {
     name: string;
+    namespace?: string;
     state?: string;
     status?: string;
 }

package/dist/index.cjs

@@ -17393,7 +17393,7 @@ var require_fetch = __commonJS((exports2, module2) => {
       request.cache = "no-store";
     }
     const newConnection = forceNewConnection ? "yes" : "no";
-    if (request.mode === "websocket") {} else {}
+    if (request.mode === "websocket") {}
     let requestBody = null;
     if (request.body == null && fetchParams.processRequestEndOfBody) {
       queueMicrotask(() => fetchParams.processRequestEndOfBody());
@@ -45667,6 +45667,11 @@ class DevboxApi {
       method: "POST"
     });
   }
+  async stop(name) {
+    return this.request(this.url(`/api/v1/devbox/${name}/stop`), {
+      method: "POST"
+    });
+  }
   async resume(name) {
     return this.request(this.url(`/api/v1/devbox/${name}/resume`), {
       method: "POST"
@@ -45783,8 +45788,12 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       case "Pending" /* Pending */:
         return "Creating";
       case "Paused" /* Paused */:
+      case "Stopped" /* Stopped */:
+      case "Shutdown" /* Shutdown */:
         return "Stopped";
       case "Pausing" /* Pausing */:
+      case "Stopping" /* Stopping */:
+      case "Shutting" /* Shutting */:
         return "Stopping";
       default:
         return "Error";
@@ -45818,7 +45827,11 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       if (!res.data)
         return Promise.reject(res.message);
       const data = res.data;
-      this._status = { state: this.StatusAdapt(data), message: res.message };
+      this._status = {
+        state: this.StatusAdapt(data),
+        reason: data.state.phase,
+        message: res.message
+      };
       return {
         id: data.name,
         image: parseImageSpec(data.image),
@@ -45850,12 +45863,17 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
             await this.waitUntilDeleted();
             await this.create();
             return;
+          case "Error":
+            throw new ConnectionError(`Sandbox ${sandbox.id} is in error state: ${sandbox.status.reason ?? sandbox.status.message ?? "unknown"}`, this.config.baseUrl);
           default:
-            throw new ConnectionError(`Failed to ensure sandbox running`);
+            throw new ConnectionError(`Sandbox state ${status} not supported`, this.config.baseUrl);
         }
       }
       await this.create();
     } catch (error) {
+      if (error instanceof ConnectionError) {
+        throw error;
+      }
       throw new ConnectionError(`Failed to ensure sandbox running`, this.config.baseUrl, error);
     }
   }
@@ -45876,10 +45894,10 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
   async stop() {
     try {
       this._status = { state: "Stopping" };
-      await this.api.pause(this._id);
+      await this.api.stop(this._id);
       this._status = { state: "Stopped" };
     } catch (error) {
-      throw new CommandExecutionError("Failed to pause sandbox", "pause", error instanceof Error ? error : undefined);
+      throw new CommandExecutionError("Failed to stop sandbox", "stop", error instanceof Error ? error : undefined);
     }
   }
   async start() {
@@ -45892,10 +45910,12 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError("Failed to resume sandbox", "resume", error instanceof Error ? error : undefined);
     }
   }
-  async delete() {
+  async delete(sandboxId) {
     try {
+      const targetId = sandboxId ?? this._id;
       this._status = { state: "Deleting" };
-      await this.api.delete(this._id);
+      await this.api.delete(targetId);
+      this._id = targetId;
       await this.waitUntilDeleted();
       this._status = { state: "UnExist" };
     } catch (error) {
@@ -48496,9 +48516,24 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError("Failed to stop sandbox", "stop", error instanceof Error ? error : undefined);
     }
   }
-  async delete() {
+  async delete(sandboxId) {
     try {
       this._status = { state: "Deleting" };
+      if (sandboxId) {
+        const manager = SandboxManager.create({ connectionConfig: this._connection });
+        try {
+          await manager.killSandbox(sandboxId);
+        } finally {
+          await manager.close().catch(() => {
+            return;
+          });
+        }
+        if (sandboxId === this._id) {
+          this.sandbox = undefined;
+        }
+        this._status = { state: "UnExist" };
+        return;
+      }
       await this.sandbox.kill();
       this.sandbox = undefined;
       this._status = { state: "UnExist" };
@@ -48867,7 +48902,11 @@ class E2BAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError("Failed to pause E2B sandbox", "stop", error instanceof Error ? error : undefined);
     }
   }
-  async delete() {
+  async delete(sandboxId) {
+    if (sandboxId) {
+      this._id = sandboxId;
+      this.sandbox = null;
+    }
     const sandbox = await this.ensureSandbox();
     try {
       this._status = { state: "Deleting" };

package/dist/index.js

@@ -17395,7 +17395,7 @@ var require_fetch = __commonJS((exports, module) => {
       request.cache = "no-store";
     }
     const newConnection = forceNewConnection ? "yes" : "no";
-    if (request.mode === "websocket") {} else {}
+    if (request.mode === "websocket") {}
     let requestBody = null;
     if (request.body == null && fetchParams.processRequestEndOfBody) {
       queueMicrotask(() => fetchParams.processRequestEndOfBody());
@@ -45651,6 +45651,11 @@ class DevboxApi {
       method: "POST"
     });
   }
+  async stop(name) {
+    return this.request(this.url(`/api/v1/devbox/${name}/stop`), {
+      method: "POST"
+    });
+  }
   async resume(name) {
     return this.request(this.url(`/api/v1/devbox/${name}/resume`), {
       method: "POST"
@@ -45767,8 +45772,12 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       case "Pending" /* Pending */:
         return "Creating";
       case "Paused" /* Paused */:
+      case "Stopped" /* Stopped */:
+      case "Shutdown" /* Shutdown */:
         return "Stopped";
       case "Pausing" /* Pausing */:
+      case "Stopping" /* Stopping */:
+      case "Shutting" /* Shutting */:
         return "Stopping";
       default:
         return "Error";
@@ -45802,7 +45811,11 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       if (!res.data)
         return Promise.reject(res.message);
       const data = res.data;
-      this._status = { state: this.StatusAdapt(data), message: res.message };
+      this._status = {
+        state: this.StatusAdapt(data),
+        reason: data.state.phase,
+        message: res.message
+      };
       return {
         id: data.name,
         image: parseImageSpec(data.image),
@@ -45834,12 +45847,17 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
             await this.waitUntilDeleted();
             await this.create();
             return;
+          case "Error":
+            throw new ConnectionError(`Sandbox ${sandbox.id} is in error state: ${sandbox.status.reason ?? sandbox.status.message ?? "unknown"}`, this.config.baseUrl);
           default:
-            throw new ConnectionError(`Failed to ensure sandbox running`);
+            throw new ConnectionError(`Sandbox state ${status} not supported`, this.config.baseUrl);
         }
       }
       await this.create();
     } catch (error) {
+      if (error instanceof ConnectionError) {
+        throw error;
+      }
       throw new ConnectionError(`Failed to ensure sandbox running`, this.config.baseUrl, error);
     }
   }
@@ -45860,10 +45878,10 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
   async stop() {
     try {
       this._status = { state: "Stopping" };
-      await this.api.pause(this._id);
+      await this.api.stop(this._id);
       this._status = { state: "Stopped" };
     } catch (error) {
-      throw new CommandExecutionError("Failed to pause sandbox", "pause", error instanceof Error ? error : undefined);
+      throw new CommandExecutionError("Failed to stop sandbox", "stop", error instanceof Error ? error : undefined);
     }
   }
   async start() {
@@ -45876,10 +45894,12 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError("Failed to resume sandbox", "resume", error instanceof Error ? error : undefined);
     }
   }
-  async delete() {
+  async delete(sandboxId) {
     try {
+      const targetId = sandboxId ?? this._id;
       this._status = { state: "Deleting" };
-      await this.api.delete(this._id);
+      await this.api.delete(targetId);
+      this._id = targetId;
       await this.waitUntilDeleted();
       this._status = { state: "UnExist" };
     } catch (error) {
@@ -48480,9 +48500,24 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError("Failed to stop sandbox", "stop", error instanceof Error ? error : undefined);
     }
   }
-  async delete() {
+  async delete(sandboxId) {
     try {
       this._status = { state: "Deleting" };
+      if (sandboxId) {
+        const manager = SandboxManager.create({ connectionConfig: this._connection });
+        try {
+          await manager.killSandbox(sandboxId);
+        } finally {
+          await manager.close().catch(() => {
+            return;
+          });
+        }
+        if (sandboxId === this._id) {
+          this.sandbox = undefined;
+        }
+        this._status = { state: "UnExist" };
+        return;
+      }
       await this.sandbox.kill();
       this.sandbox = undefined;
       this._status = { state: "UnExist" };
@@ -48851,7 +48886,11 @@ class E2BAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError("Failed to pause E2B sandbox", "stop", error instanceof Error ? error : undefined);
     }
   }
-  async delete() {
+  async delete(sandboxId) {
+    if (sandboxId) {
+      this._id = sandboxId;
+      this.sandbox = null;
+    }
     const sandbox = await this.ensureSandbox();
     try {
       this._status = { state: "Deleting" };

package/dist/interfaces/ISandboxLifecycle.d.ts

@@ -27,8 +27,12 @@ export interface ISandboxLifecycle {
     stop(): Promise<void>;
     /**
      * Delete the sandbox permanently.
+     *
+     * When `sandboxId` is provided, implementations should delete that provider
+     * sandbox directly without requiring callers to first bind the adapter via
+     * `connect()`.
      */
-    delete(): Promise<void>;
+    delete(sandboxId?: SandboxId): Promise<void>;
     /**
      * Get detailed information about the sandbox.
      */

package/package.json

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