@declaw/sdk 1.1.3 → 1.1.5

package/dist/index.d.cts

@@ -993,7 +993,7 @@ interface SandboxOpts {
     volumes?: VolumeAttachment[];
     /** API key override. */
     apiKey?: string;
-    /** Domain override (supports "host:port" format, e.g. "104.198.24.180:8080"). */
+    /** Domain override (supports "host:port" format, e.g. "myhost.example.com:8080"). */
     domain?: string;
     /** Full API URL override. If set, domain/port/scheme are ignored. */
     apiUrl?: string;
@@ -1186,6 +1186,22 @@ declare class Sandbox {
      * @returns Array of Snapshot metadata objects.
      */
     listSnapshots(requestTimeout?: number): Promise<Snapshot[]>;
+    /**
+     * Delete a single snapshot of this sandbox by ID.
+     *
+     * The snapshot's PG row and S3 blobs (mem / vmstate / overlay) are
+     * removed. Idempotent: deleting an already-deleted snapshot resolves to
+     * true without throwing.
+     *
+     * The pause snapshot of a currently-paused sandbox is protected — the
+     * server returns 409 because deletion would break Resume. Resume or
+     * kill the sandbox first.
+     *
+     * @param snapshotId - The snapshot to delete.
+     * @param requestTimeout - Optional per-request timeout in milliseconds.
+     * @returns True on success.
+     */
+    deleteSnapshot(snapshotId: string, requestTimeout?: number): Promise<boolean>;
     /**
      * Restore a sandbox from a snapshot. The restored instance may run on a
      * different worker node than the original sandbox.
@@ -1372,8 +1388,24 @@ declare class TemplateBase {
     private _envs;
     private _aptPackages;
     private _startCmd?;
+    /**
+     * When set, the server uses this Dockerfile verbatim and ignores the
+     * structured fields. Use for multi-stage builds, ARG, ONBUILD, etc.
+     */
+    private _dockerfile?;
     /** Set the base image for the template. */
     fromBaseImage(image?: string): this;
+    /**
+     * Use a raw Dockerfile string instead of the structured helpers.
+     *
+     * When set, all other ``aptInstall`` / ``runCmd`` / ``setEnvs`` /
+     * ``copy`` / ``setStartCmd`` / ``fromBaseImage`` calls on this spec
+     * are ignored — the Dockerfile is sent to the build worker verbatim.
+     *
+     * @param content Full Dockerfile contents. Must contain a ``FROM``
+     *   instruction. Capped server-side at 64 KiB.
+     */
+    fromDockerfile(content: string): this;
     /** Add a run command (as array of command + args). */
     runCmd(cmds: string[]): this;
     /** Add a file copy operation. */

package/dist/index.d.ts

@@ -993,7 +993,7 @@ interface SandboxOpts {
     volumes?: VolumeAttachment[];
     /** API key override. */
     apiKey?: string;
-    /** Domain override (supports "host:port" format, e.g. "104.198.24.180:8080"). */
+    /** Domain override (supports "host:port" format, e.g. "myhost.example.com:8080"). */
     domain?: string;
     /** Full API URL override. If set, domain/port/scheme are ignored. */
     apiUrl?: string;
@@ -1186,6 +1186,22 @@ declare class Sandbox {
      * @returns Array of Snapshot metadata objects.
      */
     listSnapshots(requestTimeout?: number): Promise<Snapshot[]>;
+    /**
+     * Delete a single snapshot of this sandbox by ID.
+     *
+     * The snapshot's PG row and S3 blobs (mem / vmstate / overlay) are
+     * removed. Idempotent: deleting an already-deleted snapshot resolves to
+     * true without throwing.
+     *
+     * The pause snapshot of a currently-paused sandbox is protected — the
+     * server returns 409 because deletion would break Resume. Resume or
+     * kill the sandbox first.
+     *
+     * @param snapshotId - The snapshot to delete.
+     * @param requestTimeout - Optional per-request timeout in milliseconds.
+     * @returns True on success.
+     */
+    deleteSnapshot(snapshotId: string, requestTimeout?: number): Promise<boolean>;
     /**
      * Restore a sandbox from a snapshot. The restored instance may run on a
      * different worker node than the original sandbox.
@@ -1372,8 +1388,24 @@ declare class TemplateBase {
     private _envs;
     private _aptPackages;
     private _startCmd?;
+    /**
+     * When set, the server uses this Dockerfile verbatim and ignores the
+     * structured fields. Use for multi-stage builds, ARG, ONBUILD, etc.
+     */
+    private _dockerfile?;
     /** Set the base image for the template. */
     fromBaseImage(image?: string): this;
+    /**
+     * Use a raw Dockerfile string instead of the structured helpers.
+     *
+     * When set, all other ``aptInstall`` / ``runCmd`` / ``setEnvs`` /
+     * ``copy`` / ``setStartCmd`` / ``fromBaseImage`` calls on this spec
+     * are ignored — the Dockerfile is sent to the build worker verbatim.
+     *
+     * @param content Full Dockerfile contents. Must contain a ``FROM``
+     *   instruction. Capped server-side at 64 KiB.
+     */
+    fromDockerfile(content: string): this;
     /** Add a run command (as array of command + args). */
     runCmd(cmds: string[]): this;
     /** Add a file copy operation. */

package/dist/index.js

@@ -127,12 +127,20 @@ function getDispatcher() {
       if (process.env.DECLAW_SDK_DISABLE_DISPATCHER) {
         return void 0;
       }
+      const origEmit = process.emitWarning;
+      process.emitWarning = ((warning, ...rest) => {
+        if (rest[0] === "UNDICI-H2") return;
+        return origEmit.call(process, warning, ...rest);
+      });
       const undici = await import("undici");
+      const connOverride = parseInt(process.env.DECLAW_SDK_CONNECTIONS || "", 10);
+      const connections = Number.isFinite(connOverride) && connOverride > 0 ? connOverride : 64;
       return new undici.Agent({
-        connections: 128,
+        connections,
         keepAliveTimeout: 3e4,
         keepAliveMaxTimeout: 6e4,
         pipelining: 1,
+        allowH2: true,
         connect: { keepAlive: true, keepAliveInitialDelay: 5e3 }
       });
     } catch {
@@ -2147,6 +2155,27 @@ var Sandbox = class _Sandbox {
     const raw = data.snapshots ?? [];
     return raw.map((s) => parseSnapshot(s));
   }
+  /**
+   * Delete a single snapshot of this sandbox by ID.
+   *
+   * The snapshot's PG row and S3 blobs (mem / vmstate / overlay) are
+   * removed. Idempotent: deleting an already-deleted snapshot resolves to
+   * true without throwing.
+   *
+   * The pause snapshot of a currently-paused sandbox is protected — the
+   * server returns 409 because deletion would break Resume. Resume or
+   * kill the sandbox first.
+   *
+   * @param snapshotId - The snapshot to delete.
+   * @param requestTimeout - Optional per-request timeout in milliseconds.
+   * @returns True on success.
+   */
+  async deleteSnapshot(snapshotId, requestTimeout) {
+    await this._client.delete(`/sandboxes/${this._sandboxId}/snapshots/${snapshotId}`, {
+      timeout: requestTimeout
+    });
+    return true;
+  }
   /**
    * Restore a sandbox from a snapshot. The restored instance may run on a
    * different worker node than the original sandbox.
@@ -2331,11 +2360,30 @@ var TemplateBase = class {
   _envs = {};
   _aptPackages = [];
   _startCmd;
+  /**
+   * When set, the server uses this Dockerfile verbatim and ignores the
+   * structured fields. Use for multi-stage builds, ARG, ONBUILD, etc.
+   */
+  _dockerfile;
   /** Set the base image for the template. */
   fromBaseImage(image) {
     this._baseImage = image ?? "ubuntu:22.04";
     return this;
   }
+  /**
+   * Use a raw Dockerfile string instead of the structured helpers.
+   *
+   * When set, all other ``aptInstall`` / ``runCmd`` / ``setEnvs`` /
+   * ``copy`` / ``setStartCmd`` / ``fromBaseImage`` calls on this spec
+   * are ignored — the Dockerfile is sent to the build worker verbatim.
+   *
+   * @param content Full Dockerfile contents. Must contain a ``FROM``
+   *   instruction. Capped server-side at 64 KiB.
+   */
+  fromDockerfile(content) {
+    this._dockerfile = content;
+    return this;
+  }
   /** Add a run command (as array of command + args). */
   runCmd(cmds) {
     this._runCmds.push(cmds);
@@ -2363,11 +2411,14 @@ var TemplateBase = class {
   }
   /** Serialize the template to a JSON-friendly object. */
   toJSON() {
+    if (this._dockerfile !== void 0) {
+      return { dockerfile: this._dockerfile };
+    }
     const result = {
       base_image: this._baseImage
     };
     if (this._runCmds.length > 0) {
-      result.run_cmds = this._runCmds;
+      result.run_cmds = this._runCmds.map((c) => c.join(" "));
     }
     if (this._copies.length > 0) {
       result.copies = this._copies;