@fastgpt-sdk/sandbox-adapter 0.0.37 → 0.0.38-beta.1

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,10 +41,11 @@ 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>;
+    private waitForCodeServerHealthz;
     private getHttpgateTarget;
     private getGatewayUniqueID;
     private getHttpgateDomain;

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

@@ -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"
@@ -45876,10 +45881,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 +45897,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) {
@@ -45924,6 +45931,9 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
   async getEndpoint(selector) {
     const port = typeof selector === "number" ? selector : SEALOS_DEVBOX_CODE_SERVER_PORT;
     const target = await this.getHttpgateTarget(port);
+    if (selector === "code-server") {
+      await this.waitForCodeServerHealthz(target);
+    }
     const url = new URL(target.origin);
     return {
       host: url.host,
@@ -45945,6 +45955,30 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       ...target.password ? { password: target.password } : {}
     };
   }
+  async waitForCodeServerHealthz(target) {
+    const healthUrl = joinUrlPath(joinUrlPath(target.origin, target.basePath), "/healthz");
+    const timeoutMs = 60000;
+    const intervalMs = 500;
+    const requestTimeoutMs = 3000;
+    const deadline = Date.now() + timeoutMs;
+    let lastResult = "not checked";
+    while (Date.now() < deadline) {
+      try {
+        const res = await fetch(healthUrl, {
+          method: "GET",
+          signal: AbortSignal.timeout(requestTimeoutMs)
+        });
+        if (res.status >= 200 && res.status < 400) {
+          return;
+        }
+        lastResult = `status ${res.status}`;
+      } catch (error) {
+        lastResult = error instanceof Error ? error.message : String(error);
+      }
+      await this.sleep(intervalMs);
+    }
+    throw new ConnectionError(`Devbox code-server health check ${healthUrl} did not become ready within ${timeoutMs}ms. Last result: ${lastResult}`, this.config.baseUrl);
+  }
   async getHttpgateTarget(port) {
     const res = await this.api.info(this._id);
     if (res.code !== 200 || !res.data) {
@@ -48469,9 +48503,13 @@ 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 && (!this._sandbox || sandboxId !== this._id)) {
+        await this.connect(sandboxId);
+        this._status = { state: "Deleting" };
+      }
       await this.sandbox.kill();
       this.sandbox = undefined;
       this._status = { state: "UnExist" };
@@ -48840,7 +48878,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

@@ -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"
@@ -45860,10 +45865,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 +45881,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) {
@@ -45908,6 +45915,9 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
   async getEndpoint(selector) {
     const port = typeof selector === "number" ? selector : SEALOS_DEVBOX_CODE_SERVER_PORT;
     const target = await this.getHttpgateTarget(port);
+    if (selector === "code-server") {
+      await this.waitForCodeServerHealthz(target);
+    }
     const url = new URL(target.origin);
     return {
       host: url.host,
@@ -45929,6 +45939,30 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       ...target.password ? { password: target.password } : {}
     };
   }
+  async waitForCodeServerHealthz(target) {
+    const healthUrl = joinUrlPath(joinUrlPath(target.origin, target.basePath), "/healthz");
+    const timeoutMs = 60000;
+    const intervalMs = 500;
+    const requestTimeoutMs = 3000;
+    const deadline = Date.now() + timeoutMs;
+    let lastResult = "not checked";
+    while (Date.now() < deadline) {
+      try {
+        const res = await fetch(healthUrl, {
+          method: "GET",
+          signal: AbortSignal.timeout(requestTimeoutMs)
+        });
+        if (res.status >= 200 && res.status < 400) {
+          return;
+        }
+        lastResult = `status ${res.status}`;
+      } catch (error) {
+        lastResult = error instanceof Error ? error.message : String(error);
+      }
+      await this.sleep(intervalMs);
+    }
+    throw new ConnectionError(`Devbox code-server health check ${healthUrl} did not become ready within ${timeoutMs}ms. Last result: ${lastResult}`, this.config.baseUrl);
+  }
   async getHttpgateTarget(port) {
     const res = await this.api.info(this._id);
     if (res.code !== 200 || !res.data) {
@@ -48453,9 +48487,13 @@ 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 && (!this._sandbox || sandboxId !== this._id)) {
+        await this.connect(sandboxId);
+        this._status = { state: "Deleting" };
+      }
       await this.sandbox.kill();
       this.sandbox = undefined;
       this._status = { state: "UnExist" };
@@ -48824,7 +48862,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.37",
+  "version": "0.0.38-beta.1",
   "description": "Unified abstraction layer for cloud sandbox providers with adapter pattern and feature polyfilling",
   "type": "module",
   "main": "./dist/index.cjs",