@hyperbrowser/sdk 0.89.1 → 0.89.2

package/README.md

@@ -255,6 +255,27 @@ const sandbox = await client.sandboxes.create({
 console.log(sandbox.exposedPorts[0].browserUrl);
 ```
 
+Manage volumes and mount them into a sandbox:
+
+```typescript
+const volume = await client.volumes.create({ name: "project-cache" });
+const volumes = await client.volumes.list();
+const sameVolume = await client.volumes.get(volume.id);
+
+const sandbox = await client.sandboxes.create({
+  imageName: "node",
+  mounts: {
+    "/workspace/cache": {
+      id: sameVolume.id,
+      type: "rw",
+      shared: true,
+    },
+  },
+});
+
+await sandbox.stop();
+```
+
 List sandboxes with time-range and search filters:
 
 ```typescript

package/dist/client.d.ts

@@ -14,6 +14,7 @@ import { ComputerActionService } from "./services/computer-action";
 import { GeminiComputerUseService } from "./services/agents/gemini-computer-use";
 import { WebService } from "./services/web";
 import { SandboxesService } from "./services/sandboxes";
+import { VolumesService } from "./services/volumes";
 export type HyperbrowserService = "control" | "runtime";
 export interface HyperbrowserErrorOptions {
     statusCode?: number;
@@ -52,5 +53,6 @@ export declare class HyperbrowserClient {
     readonly team: TeamService;
     readonly computerAction: ComputerActionService;
     readonly sandboxes: SandboxesService;
+    readonly volumes: VolumesService;
     constructor(config?: HyperbrowserConfig);
 }

package/dist/client.js

@@ -16,6 +16,7 @@ const computer_action_1 = require("./services/computer-action");
 const gemini_computer_use_1 = require("./services/agents/gemini-computer-use");
 const web_1 = require("./services/web");
 const sandboxes_1 = require("./services/sandboxes");
+const volumes_1 = require("./services/volumes");
 class HyperbrowserError extends Error {
     constructor(message, options = {}) {
         super(`[Hyperbrowser]: ${message}`);
@@ -50,6 +51,7 @@ class HyperbrowserClient {
         this.team = new team_1.TeamService(apiKey, baseUrl, timeout);
         this.computerAction = new computer_action_1.ComputerActionService(apiKey, baseUrl, timeout);
         this.sandboxes = new sandboxes_1.SandboxesService(apiKey, baseUrl, timeout, runtimeProxyOverride);
+        this.volumes = new volumes_1.VolumesService(apiKey, baseUrl, timeout);
         this.agents = {
             browserUse: new browser_use_1.BrowserUseService(apiKey, baseUrl, timeout),
             claudeComputerUse: new claude_computer_use_1.ClaudeComputerUseService(apiKey, baseUrl, timeout),

package/dist/sandbox/process.js

@@ -55,9 +55,7 @@ const quoteShellToken = (token) => {
     if (token.length === 0) {
         return "''";
     }
-    return SHELL_SAFE_TOKEN_PATTERN.test(token)
-        ? token
-        : `'${token.replace(/'/g, `'\"'\"'`)}'`;
+    return SHELL_SAFE_TOKEN_PATTERN.test(token) ? token : `'${token.replace(/'/g, `'"'"'`)}'`;
 };
 const buildShellCommand = (command, args) => {
     if (!args || args.length === 0) {

package/dist/services/sandboxes.js

@@ -48,6 +48,7 @@ const serializeCreateSandboxParams = (params) => {
             region: params.region,
             enableRecording: params.enableRecording,
             exposedPorts: params.exposedPorts,
+            mounts: params.mounts,
             timeoutMinutes: params.timeoutMinutes,
             vcpus: params.cpu,
             memMiB: params.memoryMiB,
@@ -66,6 +67,7 @@ const serializeCreateSandboxParams = (params) => {
         region: snapshotParams.region,
         enableRecording: snapshotParams.enableRecording,
         exposedPorts: snapshotParams.exposedPorts,
+        mounts: snapshotParams.mounts,
         timeoutMinutes: snapshotParams.timeoutMinutes,
     };
 };

package/dist/services/volumes.d.ts

@@ -0,0 +1,16 @@
+import { CreateVolumeParams, Volume, VolumeListResponse } from "../types/volume";
+import { BaseService } from "./base";
+export declare class VolumesService extends BaseService {
+    /**
+     * Create a new sandbox volume.
+     */
+    create(params: CreateVolumeParams): Promise<Volume>;
+    /**
+     * List sandbox volumes for the current team.
+     */
+    list(): Promise<VolumeListResponse>;
+    /**
+     * Get a single sandbox volume.
+     */
+    get(id: string): Promise<Volume>;
+}

package/dist/services/volumes.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumesService = void 0;
+const client_1 = require("../client");
+const base_1 = require("./base");
+class VolumesService extends base_1.BaseService {
+    /**
+     * Create a new sandbox volume.
+     */
+    async create(params) {
+        try {
+            return await this.request("/volume", {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to create volume", undefined);
+        }
+    }
+    /**
+     * List sandbox volumes for the current team.
+     */
+    async list() {
+        try {
+            return await this.request("/volume");
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to list volumes", undefined);
+        }
+    }
+    /**
+     * Get a single sandbox volume.
+     */
+    async get(id) {
+        try {
+            return await this.request(`/volume/${id}`);
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to get volume ${id}`, undefined);
+        }
+    }
+}
+exports.VolumesService = VolumesService;

package/dist/types/index.d.ts

@@ -8,7 +8,8 @@ export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTas
 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, SessionCreditBreakdown, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, } from "./session";
-export { SandboxStatus, SandboxRuntimeTarget, Sandbox, SandboxDetail, 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 { 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 { 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

@@ -37,10 +37,17 @@ export interface SandboxDetail extends Sandbox {
     token: string | null;
     tokenExpiresAt: string | null;
 }
+export type SandboxVolumeMountType = "rw" | "ro";
+export interface SandboxVolumeMount {
+    id: string;
+    type?: SandboxVolumeMountType;
+    shared?: boolean;
+}
 interface SandboxCreateCommonParams {
     region?: SessionRegion;
     enableRecording?: boolean;
     exposedPorts?: SandboxExposeParams[];
+    mounts?: Record<string, SandboxVolumeMount>;
     timeoutMinutes?: number;
 }
 export type CreateSandboxParams = (SandboxCreateCommonParams & {

package/dist/types/volume.d.ts

@@ -0,0 +1,12 @@
+export interface CreateVolumeParams {
+    name: string;
+}
+export interface Volume {
+    id: string;
+    name: string;
+    size?: number;
+    transferAmount?: number;
+}
+export interface VolumeListResponse {
+    volumes: Volume[];
+}

package/dist/types/volume.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperbrowser/sdk",
-  "version": "0.89.1",
+  "version": "0.89.2",
   "description": "Node SDK for Hyperbrowser API",
   "author": "",
   "repository": {