@hyperbrowser/sdk 0.91.8 → 0.92.0

package/dist/services/sandboxes.d.ts

@@ -2,7 +2,7 @@ import { SandboxFilesApi } from "../sandbox/files";
 import { SandboxProcessHandle, SandboxProcessesApi } from "../sandbox/process";
 import { SandboxTerminalApi } from "../sandbox/terminal";
 import { BasicResponse } from "../types/session";
-import { CreateSandboxParams, SandboxDetail, SandboxExposeParams, SandboxExposeResult, SandboxExecParams, SandboxExecOptions, SandboxImageListResponse, SandboxListParams, SandboxListResponse, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxProcessResult, SandboxSnapshotListParams, SandboxSnapshotListResponse, SandboxUnexposeResult } from "../types/sandbox";
+import { CompleteSandboxImageBuildParams, CreateSandboxImageBuildParams, CreateSandboxParams, SandboxDetail, SandboxExposeParams, SandboxExposeResult, SandboxExecParams, SandboxExecOptions, SandboxImageBuild, SandboxImageBuildCreateResult, SandboxImageBuildListParams, SandboxImageBuildListResponse, SandboxImageListParams, SandboxImageListResponse, SandboxListParams, SandboxListResponse, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxNetworkPolicyPatch, SandboxNetworkUpdateResult, SandboxProcessResult, SandboxSnapshotDeleteResult, SandboxSnapshotListParams, SandboxSnapshotListResponse, SandboxSnapshotSummary, SandboxUnexposeResult } from "../types/sandbox";
 import { BaseService } from "./base";
 export declare class SandboxHandle {
     private readonly service;
@@ -23,6 +23,7 @@ export declare class SandboxHandle {
     get cpu(): number | null | undefined;
     get memoryMiB(): number | null | undefined;
     get diskMiB(): number | null | undefined;
+    get timeoutMinutes(): number | null | undefined;
     get exposedPorts(): SandboxExposeResult[];
     toJSON(): SandboxDetail;
     info(): Promise<SandboxDetail>;
@@ -33,6 +34,9 @@ export declare class SandboxHandle {
     expose(params: SandboxExposeParams): Promise<SandboxExposeResult>;
     unexpose(port: number): Promise<SandboxUnexposeResult>;
     getExposedUrl(port: number): string;
+    get network(): SandboxDetail["network"];
+    updateNetwork(policy: SandboxNetworkPolicyPatch): Promise<SandboxNetworkUpdateResult>;
+    clearNetwork(): Promise<SandboxNetworkUpdateResult>;
     exec(input: string, options?: SandboxExecOptions): Promise<SandboxProcessResult>;
     exec(input: SandboxExecParams): Promise<SandboxProcessResult>;
     getProcess(processId: string): Promise<SandboxProcessHandle>;
@@ -54,13 +58,21 @@ export declare class SandboxesService extends BaseService {
     get(id: string): Promise<SandboxHandle>;
     connect(id: string): Promise<SandboxHandle>;
     list(params?: SandboxListParams): Promise<SandboxListResponse>;
-    listImages(): Promise<SandboxImageListResponse>;
+    listImages(params?: SandboxImageListParams): Promise<SandboxImageListResponse>;
     listSnapshots(params?: SandboxSnapshotListParams): Promise<SandboxSnapshotListResponse>;
     stop(id: string): Promise<BasicResponse>;
     getDetail(id: string): Promise<SandboxDetail>;
     attach(detail: SandboxDetail): SandboxHandle;
     createMemorySnapshot(id: string, params?: SandboxMemorySnapshotParams): Promise<SandboxMemorySnapshotResult>;
     expose(id: string, params: SandboxExposeParams): Promise<SandboxExposeResult>;
+    getSnapshot(snapshot: string): Promise<SandboxSnapshotSummary>;
+    deleteSnapshot(snapshot: string): Promise<SandboxSnapshotDeleteResult>;
+    createImageBuild(params: CreateSandboxImageBuildParams): Promise<SandboxImageBuildCreateResult>;
+    getImageBuild(buildId: string): Promise<SandboxImageBuild>;
+    listImageBuilds(params?: SandboxImageBuildListParams): Promise<SandboxImageBuildListResponse>;
+    completeImageBuild(buildId: string, params: CompleteSandboxImageBuildParams): Promise<SandboxImageBuild>;
+    cancelImageBuild(buildId: string): Promise<SandboxImageBuild>;
+    updateNetwork(id: string, policy: SandboxNetworkPolicyPatch): Promise<SandboxNetworkUpdateResult>;
     unexpose(id: string, port: number): Promise<SandboxUnexposeResult>;
     private createDetail;
 }

package/dist/services/sandboxes.js

@@ -9,14 +9,6 @@ const process_1 = require("../sandbox/process");
 const terminal_1 = require("../sandbox/terminal");
 const base_2 = require("./base");
 const RUNTIME_SESSION_REFRESH_BUFFER_MS = 60000;
-const validateOptionalPositiveInteger = (value, fieldName) => {
-    if (value === undefined) {
-        return;
-    }
-    if (!Number.isInteger(value) || value < 1) {
-        throw new client_1.HyperbrowserError(`${fieldName} must be a positive integer`, undefined);
-    }
-};
 const normalizeSandbox = (sandbox) => {
     const { vcpus, memMiB, diskSizeMiB, ...rest } = sandbox;
     return {
@@ -39,10 +31,7 @@ const normalizeSandboxListResponse = (response) => ({
     sandboxes: response.sandboxes.map(normalizeSandbox),
 });
 const serializeCreateSandboxParams = (params) => {
-    if ("imageName" in params) {
-        validateOptionalPositiveInteger(params.cpu, "cpu");
-        validateOptionalPositiveInteger(params.memoryMiB, "memoryMiB");
-        validateOptionalPositiveInteger(params.diskMiB, "diskMiB");
+    if (typeof params.imageName === "string") {
         return {
             imageName: params.imageName,
             imageId: params.imageId,
@@ -54,6 +43,9 @@ const serializeCreateSandboxParams = (params) => {
             vcpus: params.cpu,
             memMiB: params.memoryMiB,
             diskSizeMiB: params.diskMiB,
+            allowInternetAccess: params.allowInternetAccess,
+            allowOut: params.allowOut,
+            denyOut: params.denyOut,
         };
     }
     const snapshotParams = params;
@@ -70,6 +62,9 @@ const serializeCreateSandboxParams = (params) => {
         exposedPorts: snapshotParams.exposedPorts,
         mounts: snapshotParams.mounts,
         timeoutMinutes: snapshotParams.timeoutMinutes,
+        allowInternetAccess: snapshotParams.allowInternetAccess,
+        allowOut: snapshotParams.allowOut,
+        denyOut: snapshotParams.denyOut,
     };
 };
 const resolveSandboxRuntimeSessionHost = (runtime, baseUrl) => {
@@ -142,6 +137,9 @@ class SandboxHandle {
     get diskMiB() {
         return this.detail.diskMiB;
     }
+    get timeoutMinutes() {
+        return this.detail.timeoutMinutes;
+    }
     get exposedPorts() {
         return (this.detail.exposedPorts ?? []).map((entry) => ({ ...entry }));
     }
@@ -188,6 +186,24 @@ class SandboxHandle {
     getExposedUrl(port) {
         return buildSandboxExposedUrl(this.runtime, port);
     }
+    get network() {
+        return this.detail.network;
+    }
+    async updateNetwork(policy) {
+        const result = await this.service.updateNetwork(this.id, policy);
+        this.detail = {
+            ...this.detail,
+            network: result.network,
+        };
+        return result;
+    }
+    async clearNetwork() {
+        return this.updateNetwork({
+            allowInternetAccess: true,
+            allowOut: [],
+            denyOut: [],
+        });
+    }
     async exec(input, options) {
         if (typeof input === "string") {
             return this.processes.exec(input, options);
@@ -265,7 +281,9 @@ class SandboxHandle {
         };
     }
     assertRuntimeAvailable() {
-        if (this.detail.status === "closed" || this.detail.status === "error") {
+        if (this.detail.status === "closed" ||
+            this.detail.status === "close-error" ||
+            this.detail.status === "error") {
             throw new client_1.HyperbrowserError(`Sandbox ${this.id} is not running`, {
                 statusCode: 409,
                 code: "sandbox_not_running",
@@ -327,9 +345,14 @@ class SandboxesService extends base_2.BaseService {
             throw new client_1.HyperbrowserError("Failed to list sandboxes", undefined);
         }
     }
-    async listImages() {
+    async listImages(params = {}) {
         try {
-            return await this.request("/images");
+            return await this.request("/images", undefined, {
+                source: params.source,
+                search: params.search,
+                page: params.page,
+                limit: params.limit,
+            });
         }
         catch (error) {
             if (error instanceof client_1.HyperbrowserError) {
@@ -343,6 +366,8 @@ class SandboxesService extends base_2.BaseService {
             return await this.request("/snapshots", undefined, {
                 status: params.status,
                 imageName: params.imageName,
+                search: params.search,
+                page: params.page,
                 limit: params.limit,
             });
         }
@@ -409,6 +434,110 @@ class SandboxesService extends base_2.BaseService {
             throw new client_1.HyperbrowserError(`Failed to expose port ${params.port} for sandbox ${id}`);
         }
     }
+    async getSnapshot(snapshot) {
+        try {
+            const response = await this.request(`/snapshots/${encodeURIComponent(snapshot)}`);
+            return response.snapshot;
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to get snapshot ${snapshot}`);
+        }
+    }
+    async deleteSnapshot(snapshot) {
+        try {
+            return await this.request(`/snapshots/${encodeURIComponent(snapshot)}`, { method: "DELETE" });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to delete snapshot ${snapshot}`);
+        }
+    }
+    async createImageBuild(params) {
+        try {
+            return await this.request("/images/builds", {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to create image build");
+        }
+    }
+    async getImageBuild(buildId) {
+        try {
+            const response = await this.request(`/images/builds/${encodeURIComponent(buildId)}`);
+            return response.build;
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to get image build ${buildId}`);
+        }
+    }
+    async listImageBuilds(params = {}) {
+        try {
+            return await this.request("/images/builds", undefined, {
+                status: params.status,
+                limit: params.limit,
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to list image builds");
+        }
+    }
+    async completeImageBuild(buildId, params) {
+        try {
+            const response = await this.request(`/images/builds/${encodeURIComponent(buildId)}/complete`, {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
+            return response.build;
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to complete image build ${buildId}`);
+        }
+    }
+    async cancelImageBuild(buildId) {
+        try {
+            const response = await this.request(`/images/builds/${encodeURIComponent(buildId)}/cancel`, { method: "POST" });
+            return response.build;
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to cancel image build ${buildId}`);
+        }
+    }
+    async updateNetwork(id, policy) {
+        try {
+            return await this.request(`/sandbox/${id}/network`, {
+                method: "PUT",
+                body: JSON.stringify(policy),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to update network policy for sandbox ${id}`);
+        }
+    }
     async unexpose(id, port) {
         try {
             return await this.request(`/sandbox/${id}/unexpose`, {

package/dist/services/volumes.d.ts

@@ -1,4 +1,4 @@
-import { CreateVolumeParams, Volume, VolumeListResponse } from "../types/volume";
+import { CreateVolumeParams, Volume, VolumeListParams, VolumeListResponse } from "../types/volume";
 import { BaseService } from "./base";
 export declare class VolumesService extends BaseService {
     /**
@@ -8,7 +8,7 @@ export declare class VolumesService extends BaseService {
     /**
      * List sandbox volumes for the current team.
      */
-    list(): Promise<VolumeListResponse>;
+    list(params?: VolumeListParams): Promise<VolumeListResponse>;
     /**
      * Get a single sandbox volume.
      */

package/dist/services/volumes.js

@@ -24,9 +24,13 @@ class VolumesService extends base_1.BaseService {
     /**
      * List sandbox volumes for the current team.
      */
-    async list() {
+    async list(params = {}) {
         try {
-            return await this.request("/volume");
+            return await this.request("/volume", undefined, {
+                search: params.search,
+                page: params.page,
+                limit: params.limit,
+            });
         }
         catch (error) {
             if (error instanceof client_1.HyperbrowserError) {

package/dist/types/constants.d.ts

@@ -25,7 +25,7 @@ export type HyperAgentLlm = "gpt-5.6-luna" | "gpt-5.5" | "gpt-5.2" | "gpt-5.1" |
 export type GeminiComputerUseLlm = "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-3-flash-preview" | "gemini-2.5-computer-use-preview-10-2025";
 export type GrokComputerUseLlm = "grok-4.5";
 export type GrokReasoningEffort = "low" | "medium" | "high";
-export type SessionRegion = "us-central" | "asia-south" | "us-dev" | "europe-west" | "us-west" | "us-east";
+export type SessionRegion = "us" | "us-central" | "asia-south" | "us-dev" | "europe-west" | "us-west" | "us-east";
 export type Country = "AD" | "AE" | "AF" | "AL" | "AM" | "AO" | "AR" | "AT" | "AU" | "AW" | "AZ" | "BA" | "BD" | "BE" | "BG" | "BH" | "BJ" | "BO" | "BR" | "BS" | "BT" | "BY" | "BZ" | "CA" | "CF" | "CH" | "CI" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "EC" | "EE" | "EG" | "ES" | "ET" | "EU" | "FI" | "FJ" | "FR" | "GB" | "GE" | "GH" | "GM" | "GR" | "HK" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IN" | "IQ" | "IR" | "IS" | "IT" | "JM" | "JO" | "JP" | "KE" | "KH" | "KR" | "KW" | "KZ" | "LB" | "LI" | "LR" | "LT" | "LU" | "LV" | "MA" | "MC" | "MD" | "ME" | "MG" | "MK" | "ML" | "MM" | "MN" | "MR" | "MT" | "MU" | "MV" | "MX" | "MY" | "MZ" | "NG" | "NL" | "NO" | "NZ" | "OM" | "PA" | "PE" | "PH" | "PK" | "PL" | "PR" | "PT" | "PY" | "QA" | "RANDOM_COUNTRY" | "RO" | "RS" | "RU" | "SA" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SN" | "SS" | "TD" | "TG" | "TH" | "TM" | "TN" | "TR" | "TT" | "TW" | "UA" | "UG" | "US" | "UY" | "UZ" | "VE" | "VG" | "VN" | "YE" | "ZA" | "ZM" | "ZW" | "ad" | "ae" | "af" | "al" | "am" | "ao" | "ar" | "at" | "au" | "aw" | "az" | "ba" | "bd" | "be" | "bg" | "bh" | "bj" | "bo" | "br" | "bs" | "bt" | "by" | "bz" | "ca" | "cf" | "ch" | "ci" | "cl" | "cm" | "cn" | "co" | "cr" | "cu" | "cy" | "cz" | "de" | "dj" | "dk" | "dm" | "ec" | "ee" | "eg" | "es" | "et" | "eu" | "fi" | "fj" | "fr" | "gb" | "ge" | "gh" | "gm" | "gr" | "hk" | "hn" | "hr" | "ht" | "hu" | "id" | "ie" | "il" | "in" | "iq" | "ir" | "is" | "it" | "jm" | "jo" | "jp" | "ke" | "kh" | "kr" | "kw" | "kz" | "lb" | "li" | "lr" | "lt" | "lu" | "lv" | "ma" | "mc" | "md" | "me" | "mg" | "mk" | "ml" | "mm" | "mn" | "mr" | "mt" | "mu" | "mv" | "mx" | "my" | "mz" | "ng" | "nl" | "no" | "nz" | "om" | "pa" | "pe" | "ph" | "pk" | "pl" | "pr" | "pt" | "py" | "qa" | "ro" | "rs" | "ru" | "sa" | "sc" | "sd" | "se" | "sg" | "si" | "sk" | "sn" | "ss" | "td" | "tg" | "th" | "tm" | "tn" | "tr" | "tt" | "tw" | "ua" | "ug" | "us" | "uy" | "uz" | "ve" | "vg" | "vn" | "ye" | "za" | "zm" | "zw";
 export type OperatingSystem = "windows" | "android" | "macos" | "linux" | "ios";
 export type Platform = "chrome" | "firefox" | "safari" | "edge";

package/dist/types/index.d.ts

@@ -9,8 +9,8 @@ export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskS
 export { StartGeminiComputerUseTaskParams, StartGeminiComputerUseTaskResponse, GeminiComputerUseTaskStatusResponse, GeminiComputerUseTaskResponse, GeminiComputerUseTaskData, GeminiComputerUseStepResponse, GeminiComputerUseApiKeys, GeminiComputerUseTaskMetadata, } from "./agents/gemini-computer-use";
 export { StartGrokComputerUseTaskParams, StartGrokComputerUseTaskResponse, GrokComputerUseTaskStatusResponse, GrokComputerUseTaskResponse, GrokComputerUseTaskData, GrokComputerUseStepResponse, GrokComputerUseApiKeys, GrokComputerUseTaskMetadata, } from "./agents/grok-computer-use";
 export { BasicResponse, BrowserMemorySize, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CaptchaEvaluationPageResult, CaptchaEvaluationParams, CaptchaEvaluationResponse, CaptchaEvaluationTarget, CaptchaEvaluationType, CaptchaSolverType, CreateSessionParams, CreateSessionSnapshotResponse, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, SessionCreditBreakdown, StartSessionFromSnapshotParams, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, UpdateSessionScreenParams, UpdateSessionSolveCaptchasParams, UpdateSessionSolveCaptchasResponse, } from "./session";
-export { SandboxStatus, SandboxRuntimeTarget, Sandbox, SandboxDetail, SandboxVolumeMountType, SandboxVolumeMount, SandboxListParams, SandboxListResponse, SandboxImageSummary, SandboxImageListResponse, SandboxSnapshotStatus, SandboxSnapshotSummary, SandboxSnapshotListParams, SandboxSnapshotListResponse, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxUnexposeResult, SandboxProcessStatus, SandboxExecParams, SandboxExecOptions, SandboxProcessSummary, SandboxProcessResult, SandboxProcessListParams, SandboxProcessListResponse, SandboxProcessWaitParams, SandboxProcessSignal, SandboxProcessStdinParams, SandboxProcessStreamEvent, SandboxFileType, SandboxFileInfo, SandboxFileWriteInfo, SandboxFileListOptions, SandboxFileReadFormat, SandboxFileReadOptions, SandboxFileWriteData, SandboxFileWriteEntry, SandboxFileTextWriteOptions, SandboxFileBytesWriteOptions, SandboxFileMakeDirOptions, SandboxFileCopyParams, SandboxFileChmodParams, SandboxFileChownParams, SandboxFileTransferResult, SandboxFileSystemEventType, SandboxFileSystemEvent, SandboxWatchDirOptions, SandboxPresignFileParams, SandboxPresignedUrl, SandboxTerminalCreateParams, SandboxTerminalOutputChunk, SandboxTerminalStatus, SandboxTerminalWaitParams, SandboxTerminalKillParams, SandboxTerminalEvent, } from "./sandbox";
-export { CreateVolumeParams, Volume, VolumeListResponse } from "./volume";
+export { SandboxStatus, SandboxRuntimeTarget, SandboxNetworkPolicy, SandboxNetworkPolicyPatch, SandboxNetworkUpdateResult, Sandbox, SandboxDetail, SandboxVolumeMountType, SandboxVolumeMount, SandboxListParams, SandboxListResponse, SandboxImageSource, SandboxImageSummary, SandboxImageListParams, SandboxImageListResponse, SandboxSnapshotStatus, SandboxSnapshotSummary, SandboxSnapshotListParams, SandboxSnapshotListResponse, SandboxSnapshotDeleteResult, SandboxImageBuildStatus, SandboxImageBuildUpload, SandboxImageBuild, CreateSandboxImageBuildParams, CompleteSandboxImageBuildParams, SandboxImageBuildCreateResult, SandboxImageBuildListParams, SandboxImageBuildListResponse, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxUnexposeResult, SandboxProcessStatus, SandboxExecParams, SandboxExecOptions, SandboxProcessSummary, SandboxProcessResult, SandboxProcessListParams, SandboxProcessListResponse, SandboxProcessWaitParams, SandboxProcessSignal, SandboxProcessStdinParams, SandboxProcessStreamEvent, SandboxFileType, SandboxFileInfo, SandboxFileWriteInfo, SandboxFileListOptions, SandboxFileReadFormat, SandboxFileReadOptions, SandboxFileWriteData, SandboxFileWriteEntry, SandboxFileTextWriteOptions, SandboxFileBytesWriteOptions, SandboxFileMakeDirOptions, SandboxFileCopyParams, SandboxFileChmodParams, SandboxFileChownParams, SandboxFileTransferResult, SandboxFileSystemEventType, SandboxFileSystemEvent, SandboxWatchDirOptions, SandboxPresignFileParams, SandboxPresignedUrl, SandboxTerminalCreateParams, SandboxTerminalOutputChunk, SandboxTerminalStatus, SandboxTerminalWaitParams, SandboxTerminalKillParams, SandboxTerminalEvent, } from "./sandbox";
+export { CreateVolumeParams, Volume, VolumeListParams, VolumeListResponse } from "./volume";
 export { CreateProfileParams, ForkProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
 export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, CuaLlm, GeminiComputerUseLlm, GrokComputerUseLlm, GrokReasoningEffort, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, GeminiComputerUseTaskStatus, GrokComputerUseTaskStatus, SessionEventLogType, SessionRegion, BrowserUseVersion, HyperAgentVersion, } from "./constants";

package/dist/types/sandbox.d.ts

@@ -3,6 +3,19 @@ import type { ReadableStream } from "node:stream/web";
 import { SessionRegion } from "./constants";
 import { SessionLaunchState, SessionStatus } from "./session";
 export type SandboxStatus = SessionStatus;
+export interface SandboxNetworkPolicy {
+    allowInternetAccess: boolean;
+    allowOut: string[];
+    denyOut: string[];
+}
+export interface SandboxNetworkPolicyPatch {
+    allowInternetAccess?: boolean;
+    allowOut?: string[];
+    denyOut?: string[];
+}
+export interface SandboxNetworkUpdateResult {
+    network: SandboxNetworkPolicy;
+}
 export interface SandboxRuntimeTarget {
     transport: "regional_proxy";
     host: string;
@@ -30,6 +43,8 @@ export interface Sandbox {
     cpu?: number | null;
     memoryMiB?: number | null;
     diskMiB?: number | null;
+    timeoutMinutes?: number | null;
+    network?: SandboxNetworkPolicy;
     runtime: SandboxRuntimeTarget;
     exposedPorts: SandboxExposeResult[];
 }
@@ -49,6 +64,9 @@ interface SandboxCreateCommonParams {
     exposedPorts?: SandboxExposeParams[];
     mounts?: Record<string, SandboxVolumeMount>;
     timeoutMinutes?: number;
+    allowInternetAccess?: boolean;
+    allowOut?: string[];
+    denyOut?: string[];
 }
 export type CreateSandboxParams = (SandboxCreateCommonParams & {
     snapshotName: string;
@@ -81,16 +99,28 @@ export interface SandboxListResponse {
     page: number;
     perPage: number;
 }
+export type SandboxImageSource = "public" | "team";
 export interface SandboxImageSummary {
     id: string;
     imageName: string;
     namespace: string;
+    source?: SandboxImageSource;
+    imageInit?: Record<string, unknown> | null;
     uploaded: boolean;
     createdAt: string;
     updatedAt: string;
 }
+export interface SandboxImageListParams {
+    source?: SandboxImageSource | SandboxImageSource[];
+    search?: string;
+    page?: number;
+    limit?: number;
+}
 export interface SandboxImageListResponse {
     images: SandboxImageSummary[];
+    totalCount?: number;
+    page?: number;
+    perPage?: number;
 }
 export type SandboxSnapshotStatus = "creating" | "created" | "failed";
 export interface SandboxSnapshotSummary {
@@ -101,6 +131,9 @@ export interface SandboxSnapshotSummary {
     imageName: string;
     imageId: string;
     status: SandboxSnapshotStatus;
+    vcpus?: number | null;
+    memMiB?: number | null;
+    diskSizeMiB?: number | null;
     compatibilityTag: string;
     metadata: Record<string, unknown>;
     uploaded: boolean;
@@ -108,12 +141,80 @@ export interface SandboxSnapshotSummary {
     updatedAt: string;
 }
 export interface SandboxSnapshotListParams {
-    status?: SandboxSnapshotStatus;
+    status?: SandboxSnapshotStatus | SandboxSnapshotStatus[];
     imageName?: string;
+    search?: string;
+    page?: number;
     limit?: number;
 }
 export interface SandboxSnapshotListResponse {
     snapshots: SandboxSnapshotSummary[];
+    totalCount?: number;
+    page?: number;
+    perPage?: number;
+}
+export interface SandboxSnapshotDeleteResult {
+    deleted: boolean;
+}
+export type SandboxImageBuildStatus = "awaiting_upload" | "upload_verified" | "dispatching" | "building" | "verifying" | "completed" | "failed" | "canceled";
+export interface SandboxImageBuildUpload {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    objectKey: string;
+    expiresInSeconds: number;
+    maxUploadBytes: number;
+}
+export interface SandboxImageBuild {
+    id: string;
+    teamId?: string | null;
+    userId?: string | null;
+    namespace?: string | null;
+    imageName: string;
+    imageId?: string | null;
+    status: SandboxImageBuildStatus;
+    inputBucket?: string | null;
+    inputKey?: string | null;
+    inputSha256?: string | null;
+    inputSizeBytes?: number | null;
+    outputBucket?: string | null;
+    outputKey?: string | null;
+    vmId?: string | null;
+    errorCode?: string | null;
+    errorMessage?: string | null;
+    metadata?: Record<string, unknown> | null;
+    completedAt?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export interface CreateSandboxImageBuildParams {
+    imageName: string;
+    inputSha256: string;
+    inputSizeBytes: number;
+    inputFormat?: "rootfs_export_tar_gz";
+    sourcePlatform?: "linux/amd64";
+    imageConfigUser?: string;
+    imageInit?: {
+        env?: Record<string, string>;
+        command?: string;
+        args?: string[];
+    };
+}
+export interface CompleteSandboxImageBuildParams {
+    inputSha256: string;
+    inputSizeBytes: number;
+    inputFormat?: "rootfs_export_tar_gz";
+}
+export interface SandboxImageBuildCreateResult {
+    build: SandboxImageBuild;
+    upload: SandboxImageBuildUpload;
+}
+export interface SandboxImageBuildListParams {
+    status?: SandboxImageBuildStatus;
+    limit?: number;
+}
+export interface SandboxImageBuildListResponse {
+    builds: SandboxImageBuild[];
 }
 export interface SandboxMemorySnapshotParams {
     snapshotName?: string;
@@ -152,7 +253,7 @@ export interface SandboxExecParams {
     timeoutMs?: number;
     timeoutSec?: number;
     runAs?: string;
-    /** @deprecated Ignored for process APIs. Commands always execute via `/bin/sh -lc` server-side. */
+    /** @deprecated Ignored for process APIs. */
     useShell?: boolean;
 }
 export type SandboxExecOptions = Omit<SandboxExecParams, "command">;

package/dist/types/session.d.ts

@@ -1,6 +1,6 @@
 import fs from "fs";
 import { Country, DownloadsStatus, ISO639_1, OperatingSystem, Platform, RecordingStatus, SessionEventLogType, SessionRegion, State } from "./constants";
-export type SessionStatus = "active" | "closed" | "error";
+export type SessionStatus = "active" | "closed" | "close-error" | "error";
 export type BrowserMemorySize = "small" | "medium" | "large";
 export interface BasicResponse {
     success: boolean;

package/dist/types/volume.d.ts

@@ -7,6 +7,14 @@ export interface Volume {
     size?: number;
     transferAmount?: number;
 }
+export interface VolumeListParams {
+    search?: string;
+    page?: number;
+    limit?: number;
+}
 export interface VolumeListResponse {
     volumes: Volume[];
+    totalCount?: number;
+    page?: number;
+    perPage?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperbrowser/sdk",
-  "version": "0.91.8",
+  "version": "0.92.0",
   "description": "Node SDK for Hyperbrowser API",
   "author": "",
   "repository": {
@@ -41,6 +41,9 @@
     "ai"
   ],
   "dependencies": {
+    "@types/node": "^22.9.1",
+    "@types/node-fetch": "^2.6.4",
+    "@types/ws": "^8.18.1",
     "form-data": "^4.0.1",
     "node-fetch": "2.7.0",
     "ws": "^8.19.0",
@@ -48,9 +51,6 @@
     "zod-to-json-schema": "^3.25.0"
   },
   "devDependencies": {
-    "@types/node": "^22.9.1",
-    "@types/node-fetch": "^2.6.4",
-    "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.15.0",
     "@typescript-eslint/parser": "^8.15.0",
     "dotenv": "^17.3.1",