@declaw/sdk 1.1.6 → 1.1.7

package/dist/index.d.cts

@@ -1149,6 +1149,27 @@ declare class Sandbox {
         queued?: boolean;
         error?: string;
     }>>;
+    /**
+     * Kill a sandbox by id without first connecting. Sends a single
+     * `DELETE /sandboxes/:id?async=true` and skips the metadata fetch
+     * `Sandbox.connect(id).kill()` would otherwise pay. Useful for bulk
+     * cleanup paths that only have the id.
+     *
+     * @param sandboxId - the sandbox to kill.
+     * @param opts.wait - if true, block until the server finishes the
+     *   per-VM teardown. Default is false: server returns 202 once the
+     *   kill is queued.
+     * @param opts.requestTimeout - per-request timeout in milliseconds.
+     * @param opts.config - override the default ConnectionConfig.
+     * @returns true if the kill was accepted (default) or completed
+     *   (wait=true); false if the server reported the sandbox was
+     *   already dead.
+     */
+    static kill(sandboxId: string, opts?: {
+        wait?: boolean;
+        requestTimeout?: number;
+        config?: ConnectionConfig;
+    }): Promise<boolean>;
     /**
      * Check if this sandbox is currently running.
      *

package/dist/index.d.ts

@@ -1149,6 +1149,27 @@ declare class Sandbox {
         queued?: boolean;
         error?: string;
     }>>;
+    /**
+     * Kill a sandbox by id without first connecting. Sends a single
+     * `DELETE /sandboxes/:id?async=true` and skips the metadata fetch
+     * `Sandbox.connect(id).kill()` would otherwise pay. Useful for bulk
+     * cleanup paths that only have the id.
+     *
+     * @param sandboxId - the sandbox to kill.
+     * @param opts.wait - if true, block until the server finishes the
+     *   per-VM teardown. Default is false: server returns 202 once the
+     *   kill is queued.
+     * @param opts.requestTimeout - per-request timeout in milliseconds.
+     * @param opts.config - override the default ConnectionConfig.
+     * @returns true if the kill was accepted (default) or completed
+     *   (wait=true); false if the server reported the sandbox was
+     *   already dead.
+     */
+    static kill(sandboxId: string, opts?: {
+        wait?: boolean;
+        requestTimeout?: number;
+        config?: ConnectionConfig;
+    }): Promise<boolean>;
     /**
      * Check if this sandbox is currently running.
      *

package/dist/index.js

@@ -2056,6 +2056,33 @@ var Sandbox = class _Sandbox {
     });
     return data.results ?? {};
   }
+  /**
+   * Kill a sandbox by id without first connecting. Sends a single
+   * `DELETE /sandboxes/:id?async=true` and skips the metadata fetch
+   * `Sandbox.connect(id).kill()` would otherwise pay. Useful for bulk
+   * cleanup paths that only have the id.
+   *
+   * @param sandboxId - the sandbox to kill.
+   * @param opts.wait - if true, block until the server finishes the
+   *   per-VM teardown. Default is false: server returns 202 once the
+   *   kill is queued.
+   * @param opts.requestTimeout - per-request timeout in milliseconds.
+   * @param opts.config - override the default ConnectionConfig.
+   * @returns true if the kill was accepted (default) or completed
+   *   (wait=true); false if the server reported the sandbox was
+   *   already dead.
+   */
+  static async kill(sandboxId, opts) {
+    const config = opts?.config ?? new ConnectionConfig();
+    const client = getSharedClient(config);
+    const wait = opts?.wait === true;
+    const path = wait ? `/sandboxes/${sandboxId}` : `/sandboxes/${sandboxId}?async=true`;
+    const data = await client.delete(path, {
+      timeout: opts?.requestTimeout
+    });
+    if (!wait) return data.queued ?? true;
+    return data.killed ?? false;
+  }
   /**
    * Check if this sandbox is currently running.
    *