@hyperbrowser/sdk 0.85.0 → 0.87.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, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxProcessResult, SandboxRuntimeTarget } from "../types/sandbox";
+import { CreateSandboxParams, SandboxDetail, SandboxExposeParams, SandboxExposeResult, SandboxExecParams, SandboxImageListResponse, SandboxListParams, SandboxListResponse, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxProcessResult, SandboxRuntimeTarget, SandboxSnapshotListParams, SandboxSnapshotListResponse } from "../types/sandbox";
 import { BaseService } from "./base";
 export declare class SandboxHandle {
     private readonly service;
@@ -47,6 +47,9 @@ export declare class SandboxesService extends BaseService {
     create(params: CreateSandboxParams): Promise<SandboxHandle>;
     get(id: string): Promise<SandboxHandle>;
     connect(id: string): Promise<SandboxHandle>;
+    list(params?: SandboxListParams): Promise<SandboxListResponse>;
+    listImages(): Promise<SandboxImageListResponse>;
+    listSnapshots(params?: SandboxSnapshotListParams): Promise<SandboxSnapshotListResponse>;
     stop(id: string): Promise<BasicResponse>;
     getDetail(id: string): Promise<SandboxDetail>;
     attach(detail: SandboxDetail): SandboxHandle;

package/dist/services/sandboxes.js

@@ -194,6 +194,46 @@ class SandboxesService extends base_2.BaseService {
         await handle.connect();
         return handle;
     }
+    async list(params = {}) {
+        try {
+            return await this.request("/sandboxes", undefined, {
+                status: params.status,
+                page: params.page,
+                limit: params.limit,
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to list sandboxes", undefined);
+        }
+    }
+    async listImages() {
+        try {
+            return await this.request("/images");
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to list sandbox images", undefined);
+        }
+    }
+    async listSnapshots(params = {}) {
+        try {
+            return await this.request("/snapshots", 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 sandbox snapshots", undefined);
+        }
+    }
     async stop(id) {
         try {
             return await this.request(`/sandbox/${id}/stop`, {

package/dist/services/sessions.d.ts

@@ -1,4 +1,4 @@
-import { BasicResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse, SessionEventLogListParams, SessionEventLogListResponse, UpdateSessionProfileParams, SessionGetParams } from "../types/session";
+import { BasicResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse, SessionEventLogListParams, SessionEventLogListResponse, UpdateSessionProfileParams, UpdateSessionProxyParams, SessionGetParams } from "../types/session";
 import { BaseService } from "./base";
 /**
  * Service for managing session event logs
@@ -79,6 +79,7 @@ export declare class SessionsService extends BaseService {
     updateProfileParams(id: string, params: UpdateSessionProfileParams): Promise<BasicResponse>;
     /** @deprecated Pass an UpdateSessionProfileParams object instead of a boolean. */
     updateProfileParams(id: string, persistChanges: boolean): Promise<BasicResponse>;
+    updateProxyParams(id: string, params: UpdateSessionProxyParams): Promise<BasicResponse>;
     private static hasWarnedUpdateSessionProfileParamsBooleanDeprecated;
     private warnUpdateSessionProfileParamsBooleanDeprecated;
 }

package/dist/services/sessions.js

@@ -345,6 +345,20 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to update profile for session ${id}`, undefined);
         }
     }
+    async updateProxyParams(id, params) {
+        try {
+            return await this.request(`/session/${id}/update`, {
+                method: "PUT",
+                body: JSON.stringify({ type: "proxy", params }),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to update proxy for session ${id}`, undefined);
+        }
+    }
     warnUpdateSessionProfileParamsBooleanDeprecated() {
         if (SessionsService.hasWarnedUpdateSessionProfileParamsBooleanDeprecated) {
             return;

package/dist/types/index.d.ts

@@ -7,8 +7,8 @@ export { StartClaudeComputerUseTaskParams, StartClaudeComputerUseTaskResponse, C
 export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTaskResponse, CuaTaskData, CuaStepResponse, CuaApiKeys, CuaTaskMetadata, } from "./agents/cua";
 export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskStatusResponse, HyperAgentTaskResponse, HyperAgentTaskData, HyperAgentStep, HyperAgentOutput, HyperAgentActionOutput, HyperAgentApiKeys, HyperAgentTaskMetadata, HyperAgentOutputV110, HyperAgentStepV110, } from "./agents/hyper-agent";
 export { StartGeminiComputerUseTaskParams, StartGeminiComputerUseTaskResponse, GeminiComputerUseTaskStatusResponse, GeminiComputerUseTaskResponse, GeminiComputerUseTaskData, GeminiComputerUseStepResponse, GeminiComputerUseApiKeys, GeminiComputerUseTaskMetadata, } from "./agents/gemini-computer-use";
-export { BasicResponse, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, UpdateSessionProfileParams, } from "./session";
-export { SandboxStatus, SandboxRuntimeTarget, Sandbox, SandboxDetail, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxProcessStatus, SandboxExecParams, 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 { BasicResponse, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, } from "./session";
+export { SandboxStatus, SandboxRuntimeTarget, Sandbox, SandboxDetail, SandboxListParams, SandboxListResponse, SandboxImageSummary, SandboxImageListResponse, SandboxSnapshotStatus, SandboxSnapshotSummary, SandboxSnapshotListParams, SandboxSnapshotListResponse, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxProcessStatus, SandboxExecParams, 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 { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
 export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, CuaLlm, GeminiComputerUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, GeminiComputerUseTaskStatus, SessionEventLogType, SessionRegion, BrowserUseVersion, HyperAgentVersion, } from "./constants";

package/dist/types/sandbox.d.ts

@@ -49,6 +49,50 @@ export type CreateSandboxParams = (SandboxCreateCommonParams & {
     imageName: string;
     imageId?: string;
 });
+export interface SandboxListParams {
+    status?: SandboxStatus;
+    page?: number;
+    limit?: number;
+}
+export interface SandboxListResponse {
+    sandboxes: Sandbox[];
+    totalCount: number;
+    page: number;
+    perPage: number;
+}
+export interface SandboxImageSummary {
+    id: string;
+    imageName: string;
+    namespace: string;
+    uploaded: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SandboxImageListResponse {
+    images: SandboxImageSummary[];
+}
+export type SandboxSnapshotStatus = "creating" | "created" | "failed";
+export interface SandboxSnapshotSummary {
+    id: string;
+    snapshotName: string;
+    namespace: string;
+    imageNamespace: string;
+    imageName: string;
+    imageId: string;
+    status: SandboxSnapshotStatus;
+    compatibilityTag: string;
+    metadata: Record<string, unknown>;
+    uploaded: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SandboxSnapshotListParams {
+    status?: SandboxSnapshotStatus;
+    limit?: number;
+}
+export interface SandboxSnapshotListResponse {
+    snapshots: SandboxSnapshotSummary[];
+}
 export interface SandboxMemorySnapshotParams {
     snapshotName?: string;
 }

package/dist/types/session.d.ts

@@ -186,3 +186,13 @@ export interface UpdateSessionProfileParams {
     persistChanges?: boolean;
     persistNetworkCache?: boolean;
 }
+export interface UpdateSessionProxyLocationParams {
+    country?: Country;
+    state?: State;
+    city?: string;
+}
+export interface UpdateSessionProxyParams {
+    enabled: boolean;
+    staticIpId?: string;
+    location?: UpdateSessionProxyLocationParams;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperbrowser/sdk",
-  "version": "0.85.0",
+  "version": "0.87.0",
   "description": "Node SDK for Hyperbrowser API",
   "author": "",
   "main": "dist/index.js",