@hyperbrowser/sdk 1.5.0 → 1.5.2

package/dist/customer-key.d.ts

@@ -62,6 +62,18 @@ export declare const createCustomerKey: (key: CustomerKeyInput, options?: Custom
 export declare const secretEnvelopeDigest: (envelope: string) => string;
 /** @internal Checks that `key` looks like a CustomerKey before anything is sent. */
 export declare const assertCustomerKey: (key: unknown, what?: string) => CustomerKey;
+/**
+ * @internal Checks that `keys` is a CustomerKey or a list of them before
+ * anything is sent. An empty list passes only with `allowEmpty`: an up-front
+ * check must not reject a call that never needs a key (an empty vault, or a
+ * rewrap with nothing to rewrap); `customerKeyFor` still rejects it when a
+ * key is actually needed.
+ */
+export declare const assertCustomerKeys: (keys: unknown, what?: string, { allowEmpty }?: {
+    allowEmpty?: boolean;
+}) => readonly CustomerKey[];
+/** @internal Wraps `innerEnvelope` and checks that `wrap()` returned a non-empty string. */
+export declare const wrapEnvelope: (customerKey: CustomerKey, innerEnvelope: string, encryptionContext: string) => Promise<string>;
 /**
  * @internal Unwrap a wrapped version with the key among `keys` that wrapped
  * it, and check the result is the inner envelope the version holds.

package/dist/customer-key.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.customerKeyFor = exports.unwrapVersion = exports.assertCustomerKey = exports.secretEnvelopeDigest = exports.createCustomerKey = exports.assertCustomerKeyId = void 0;
+exports.customerKeyFor = exports.unwrapVersion = exports.wrapEnvelope = exports.assertCustomerKeys = exports.assertCustomerKey = exports.secretEnvelopeDigest = exports.createCustomerKey = exports.assertCustomerKeyId = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const error_1 = require("./error");
 const ENC = "A256GCM";
@@ -362,6 +362,38 @@ const assertCustomerKey = (key, what = "customerKey") => {
     return candidate;
 };
 exports.assertCustomerKey = assertCustomerKey;
+/**
+ * @internal Checks that `keys` is a CustomerKey or a list of them before
+ * anything is sent. An empty list passes only with `allowEmpty`: an up-front
+ * check must not reject a call that never needs a key (an empty vault, or a
+ * rewrap with nothing to rewrap); `customerKeyFor` still rejects it when a
+ * key is actually needed.
+ */
+const assertCustomerKeys = (keys, what = "customerKey", { allowEmpty = false } = {}) => {
+    if (!Array.isArray(keys)) {
+        return [(0, exports.assertCustomerKey)(keys, what)];
+    }
+    if (keys.length === 0 && !allowEmpty) {
+        throw new error_1.HyperbrowserError(`Pass at least one customer key as ${what}`, {
+            code: "invalid_request",
+            retryable: false,
+        });
+    }
+    return keys.map((key, index) => (0, exports.assertCustomerKey)(key, `${what}[${index}]`));
+};
+exports.assertCustomerKeys = assertCustomerKeys;
+/** @internal Wraps `innerEnvelope` and checks that `wrap()` returned a non-empty string. */
+const wrapEnvelope = async (customerKey, innerEnvelope, encryptionContext) => {
+    const envelope = await customerKey.wrap(innerEnvelope, encryptionContext);
+    if (typeof envelope !== "string" || !envelope) {
+        throw new error_1.HyperbrowserError("The customer key's wrap() must return the envelope as a string", {
+            code: "invalid_request",
+            retryable: false,
+        });
+    }
+    return envelope;
+};
+exports.wrapEnvelope = wrapEnvelope;
 /**
  * @internal Unwrap a wrapped version with the key among `keys` that wrapped
  * it, and check the result is the inner envelope the version holds.
@@ -377,14 +409,7 @@ const unwrapVersion = async (wrapped, keys, label) => {
 exports.unwrapVersion = unwrapVersion;
 /** @internal The key among `keys` that wrapped an envelope with this `kid`. */
 const customerKeyFor = (keys, kid, label) => {
-    const list = (Array.isArray(keys) ? keys : [keys]);
-    if (list.length === 0) {
-        throw new error_1.HyperbrowserError("Pass at least one customer key", {
-            code: "invalid_request",
-            retryable: false,
-        });
-    }
-    list.forEach((key, index) => (0, exports.assertCustomerKey)(key, `customerKey[${index}]`));
+    const list = (0, exports.assertCustomerKeys)(keys);
     const key = list.find((candidate) => candidate.kid === kid);
     if (!key) {
         throw new error_1.HyperbrowserError(`${label} was wrapped with customer key ${JSON.stringify(kid)}, which none of the keys given has`, { code: "customer_key_mismatch", retryable: false });

package/dist/services/base.js

@@ -13,7 +13,14 @@ const getRequestId = (response) => {
 /** The API's machine codes, such as SECRET_NOT_FOUND. */
 const SERVER_ERROR_CODE_PATTERN = /^[A-Z][A-Z0-9]*(_[A-Z0-9]+)+$/;
 /** Codes whose retryable status default (such as 503) would be wrong. */
-const NON_RETRYABLE_ERROR_CODES = new Set(["SECRETS_NOT_CONFIGURED"]);
+const NON_RETRYABLE_ERROR_CODES = new Set([
+    "SECRETS_ADMIN_REQUIRED",
+    "SECRETS_NOT_CONFIGURED",
+    "SECRET_KEY_UNAVAILABLE",
+    "SECRET_DECRYPT_FAILED",
+    "SECRET_ENVELOPE_INVALID",
+    "SECRET_VALUE_INVALID",
+]);
 /** The sandbox and secret an error is about, when the API names them. */
 const errorMessageContext = (errorData) => {
     let context = "";

package/dist/services/sandboxes.d.ts

@@ -25,6 +25,7 @@ export declare class SandboxHandle {
     get diskMiB(): number | null | undefined;
     get timeoutMinutes(): number | null | undefined;
     get exposedPorts(): SandboxExposeResult[];
+    get startupSecrets(): SandboxDetail["startupSecrets"];
     toJSON(): SandboxDetail;
     info(): Promise<SandboxDetail>;
     refresh(): Promise<SandboxHandle>;
@@ -48,7 +49,6 @@ export declare class SandboxHandle {
         forceRefresh?: boolean;
     }): Promise<SandboxRuntimeSession>;
     private ensureRuntimeSession;
-    private applyRuntimeSession;
     private clearRuntimeSession;
     private assertRuntimeAvailable;
     private static toRuntimeSession;

package/dist/services/sandboxes.js

@@ -256,6 +256,9 @@ class SandboxHandle {
     get exposedPorts() {
         return (this.detail.exposedPorts ?? []).map((entry) => ({ ...entry }));
     }
+    get startupSecrets() {
+        return this.detail.startupSecrets?.map((entry) => ({ ...entry }));
+    }
     toJSON() {
         return { ...this.detail };
     }
@@ -379,17 +382,6 @@ class SandboxHandle {
         }
         return { ...this.runtimeSession };
     }
-    applyRuntimeSession(session) {
-        this.runtimeSession = { ...session };
-        this.detail = {
-            ...this.detail,
-            status: session.status,
-            region: session.region,
-            runtime: session.runtime,
-            token: session.token,
-            tokenExpiresAt: session.tokenExpiresAt,
-        };
-    }
     clearRuntimeSession(status = this.detail.status) {
         this.runtimeSession = null;
         this.detail = {

package/dist/services/secrets.js

@@ -222,6 +222,7 @@ class SecretsService extends base_1.BaseService {
     async unwrap(secret, customerKey, options = {}) {
         const version = options?.version ?? "latest";
         assertVersion(version, true);
+        (0, customer_key_1.assertCustomerKeys)(customerKey);
         try {
             const resolved = await this.resolve(secret);
             const wrapped = await this.fetchWrapped(resolved.id, version);
@@ -240,6 +241,7 @@ class SecretsService extends base_1.BaseService {
      */
     async rewrap(secret, params) {
         const { from, to, versions } = params ?? {};
+        (0, customer_key_1.assertCustomerKeys)(from, "from", { allowEmpty: true });
         (0, customer_key_1.assertCustomerKey)(to, "to");
         if (versions !== undefined) {
             if (!Array.isArray(versions))
@@ -258,7 +260,7 @@ class SecretsService extends base_1.BaseService {
                 const wrapped = await this.fetchWrapped(detail.id, version);
                 const label = `Version ${version} of secret ${detail.name}`;
                 const inner = await (0, customer_key_1.unwrapVersion)(wrapped, from, label);
-                const envelope = await to.wrap(inner, detail.encryptionContext);
+                const envelope = await (0, customer_key_1.wrapEnvelope)(to, inner, detail.encryptionContext);
                 rewrapped.push(await this.putWrapping(detail.id, version, { envelope, innerDigest: wrapped.innerDigest }));
             }
             return rewrapped;
@@ -335,7 +337,7 @@ class SecretsService extends base_1.BaseService {
         const body = customerKey === undefined
             ? { envelope: inner }
             : {
-                envelope: await customerKey.wrap(inner, secret.encryptionContext),
+                envelope: await (0, customer_key_1.wrapEnvelope)(customerKey, inner, secret.encryptionContext),
                 innerDigest: (0, customer_key_1.secretEnvelopeDigest)(inner),
                 innerKid: sealer.kid,
             };

package/dist/services/sessions.js

@@ -244,12 +244,53 @@ class SessionsService extends base_1.BaseService {
      */
     async uploadFile(id, fileOptions) {
         const { fileInput, fileName } = fileOptions;
+        // Our own file stream, destroyed when the upload settles. A stream the
+        // caller passes in stays theirs and is never destroyed here.
+        let ownedStream;
+        let sourceStream;
+        let streamError;
+        let rejectStreamError;
+        const streamFailure = new Promise((_, reject) => {
+            rejectStreamError = reject;
+        });
+        streamFailure.catch(() => { });
+        // Aborts the in-flight request when the body fails, so the socket is not
+        // held open until the request timeout.
+        const controller = new AbortController();
+        let readLabel = "";
+        // form-data re-emits a source stream's "error" on the FormData, and
+        // node-fetch pipes the body without an error listener, so an unlistened
+        // FormData error is thrown as an uncaught exception. Every FormData body
+        // therefore gets a listener, whatever the input type.
+        const onStreamError = (error) => {
+            if (!streamError) {
+                streamError = new client_1.HyperbrowserError(`Failed to read file ${readLabel}: ${error.message}`, undefined);
+            }
+            controller.abort();
+            rejectStreamError?.(streamError);
+        };
+        const buildBody = (file, filename) => {
+            const formData = new form_data_1.default();
+            formData.on("error", onStreamError);
+            if (!Buffer.isBuffer(file)) {
+                sourceStream = file;
+                file.on("error", onStreamError);
+            }
+            formData.append("file", file, { filename });
+            return {
+                method: "POST",
+                body: formData,
+                headers: formData.getHeaders(),
+                signal: controller.signal,
+            };
+        };
         try {
             let fetchOptions;
             if (typeof fileInput === "string") {
                 let stats;
                 try {
                     stats = await fs_1.promises.stat(fileInput);
+                    await fs_1.promises.access(fileInput, fs_1.constants.R_OK);
                 }
                 catch (error) {
                     if (error.code === "ENOENT") {
@@ -263,61 +304,47 @@ class SessionsService extends base_1.BaseService {
                 if (!stats.isFile()) {
                     throw new client_1.HyperbrowserError(`Path is not a file: ${fileInput}`, undefined);
                 }
-                const formData = new form_data_1.default();
-                const fileStream = (0, fs_1.createReadStream)(fileInput);
-                const fileBaseName = fileName || path.basename(fileInput);
-                fileStream.on("error", (error) => {
-                    throw new client_1.HyperbrowserError(`Failed to read file ${fileInput}: ${error.message}`, undefined);
-                });
-                formData.append("file", fileStream, {
-                    filename: fileBaseName,
-                });
-                fetchOptions = {
-                    method: "POST",
-                    body: formData,
-                    headers: formData.getHeaders(),
-                };
+                readLabel = `at ${fileInput}`;
+                ownedStream = (0, fs_1.createReadStream)(fileInput);
+                fetchOptions = buildBody(ownedStream, fileName || path.basename(fileInput));
             }
             else if (this.isReadableStream(fileInput)) {
-                const formData = new form_data_1.default();
                 let tmpFileName = fileName || `file-${Date.now()}`;
                 if (fileInput.path && typeof fileInput.path === "string" && !fileName) {
                     tmpFileName = path.basename(fileInput.path);
                 }
-                formData.append("file", fileInput, {
-                    filename: tmpFileName,
-                });
-                fetchOptions = {
-                    method: "POST",
-                    body: formData,
-                    headers: formData.getHeaders(),
-                };
+                readLabel = `stream ${tmpFileName}`;
+                fetchOptions = buildBody(fileInput, tmpFileName);
             }
             else if (Buffer.isBuffer(fileInput)) {
                 if (!fileName) {
                     throw new client_1.HyperbrowserError("fileName is required when uploading Buffer data", undefined);
                 }
-                const formData = new form_data_1.default();
-                formData.append("file", fileInput, {
-                    filename: fileName,
-                });
-                fetchOptions = {
-                    method: "POST",
-                    body: formData,
-                    headers: formData.getHeaders(),
-                };
+                readLabel = `buffer ${fileName}`;
+                fetchOptions = buildBody(fileInput, fileName);
             }
             else {
                 throw new client_1.HyperbrowserError("Unsupported file input type. Please provide a file path string, ReadStream, or Buffer.", undefined);
             }
-            return await this.request(`/session/${id}/uploads`, fetchOptions);
+            const requestPromise = this.request(`/session/${id}/uploads`, fetchOptions);
+            requestPromise.catch(() => { });
+            return await Promise.race([requestPromise, streamFailure]);
         }
         catch (error) {
+            if (streamError) {
+                throw streamError;
+            }
             if (error instanceof client_1.HyperbrowserError) {
                 throw error;
             }
             throw new client_1.HyperbrowserError(`Failed to upload file for session ${id}: ${error}`, undefined);
         }
+        finally {
+            if (sourceStream && sourceStream !== ownedStream) {
+                sourceStream.removeListener("error", onStreamError);
+            }
+            ownedStream?.destroy();
+        }
     }
     /**
      * Helper method to check if input is a readable stream

package/dist/services/vaults.js

@@ -76,6 +76,7 @@ class VaultsService extends base_1.BaseService {
      * `SECRET_VAULT_CHANGED`: unwrap the vault again.
      */
     async unwrap(vault, customerKey) {
+        (0, customer_key_1.assertCustomerKeys)(customerKey, "customerKey", { allowEmpty: true });
         const wrapped = await this.getWrapped(vault);
         const unwrapped = {};
         for (const [env, entry] of Object.entries(wrapped.entries ?? {})) {

package/dist/tools/index.js

@@ -65,10 +65,10 @@ WebsiteCrawlTool.openaiToolDefinition = openai_1.CRAWL_TOOL_OPENAI;
 WebsiteCrawlTool.anthropicToolDefinition = anthropic_1.CRAWL_TOOL_ANTHROPIC;
 class WebsiteExtractTool {
     static async runnable(hb, params) {
-        if (params.schema && typeof params.schema === "string") {
-            params.schema = JSON.parse(params.schema);
-        }
-        const resp = await hb.extract.startAndWait(params);
+        const requestParams = params.schema && typeof params.schema === "string"
+            ? { ...params, schema: JSON.parse(params.schema) }
+            : { ...params };
+        const resp = await hb.extract.startAndWait(requestParams);
         return resp.data ? JSON.stringify(resp.data) : "";
     }
 }

package/dist/types/constants.d.ts

@@ -45,10 +45,10 @@ export type ClaudeComputerUseReasoningEffort = "low" | "medium" | "high" | "xhig
 export type CuaLlm = "computer-use-preview" | "gpt-6-astra" | "gpt-6.1-sol" | "gpt-6.1-terra" | "gpt-6-sol" | "gpt-6-luna" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.5" | "gpt-5.4" | "gpt-5.4-mini";
 export type CuaReasoningEffort = "none" | "low" | "medium" | "high" | "xhigh" | "max";
 export type HyperAgentVersion = "0.8.0" | "1.1.0";
-export type HyperAgentLlm = "gpt-6-luna" | "gpt-5.6-luna" | "gpt-5.5" | "gpt-5.2" | "gpt-5.1" | "gpt-5" | "gpt-5-mini" | "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "claude-sonnet-5" | "claude-sonnet-4-6" | "claude-haiku-5-5"
+export type HyperAgentLlm = "gpt-6.1-terra" | "gpt-6-luna" | "gpt-5.6-luna" | "gpt-5.5" | "gpt-5.2" | "gpt-5.1" | "gpt-5" | "gpt-5-mini" | "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "claude-sonnet-5" | "claude-sonnet-4-6" | "claude-haiku-5-5"
 /** @deprecated Retires November 30, 2026; use "claude-sonnet-5". */
  | "claude-sonnet-4-5" | "gemini-2.5-flash" | "gemini-3.8-flash" | "gemini-3.7-flash" | "gemini-3-flash-preview";
-export type GeminiComputerUseLlm = "gemini-4-argon" | "gemini-3.8-flash" | "gemini-3.7-flash" | "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 GeminiComputerUseLlm = "gemini-4-carbon" | "gemini-4-argon" | "gemini-3.8-flash" | "gemini-3.7-flash" | "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 GeminiComputerUseReasoningEffort = "minimal" | "low" | "medium" | "high";
 export type GrokComputerUseLlm = "grok-4.7" | "grok-4.6" | "grok-4.5";
 export type GrokReasoningEffort = "low" | "medium" | "high";

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 export { HyperbrowserConfig } from "./config";
 export * from "./webmcp";
 export { StartCrawlJobParams, StartCrawlJobResponse, CrawledPage, CrawlJobResponse, GetCrawlJobParams, CrawlJobStatusResponse, } from "./crawl";
-export { StartScrapeJobParams, StartScrapeJobResponse, ScrapeJobData, ScrapeJobResponse, ScrapeOptions, ScrapeJobStatusResponse, BatchScrapeJobStatusResponse, StorageStateOptions, } from "./scrape";
+export { StartScrapeJobParams, StartScrapeJobResponse, ScrapeJobData, ScrapeJobResponse, ScrapeOptions, ScrapeJobStatusResponse, StartBatchScrapeJobParams, StartBatchScrapeJobResponse, BatchScrapeJobStatusResponse, BatchScrapeJobResponse, GetBatchScrapeJobParams, ScrapedPage, ScreenshotOptions, StorageStateOptions, } from "./scrape";
 export { StartExtractJobParams, StartExtractJobResponse, ExtractJobResponse, ExtractJobStatusResponse, ExtractJobMetadata, } from "./extract";
 export { StartBrowserUseTaskParams, StartBrowserUseTaskResponse, BrowserUseTaskStatusResponse, BrowserUseTaskResponse, BrowserUseTaskData, BrowserUseApiKeys, BrowserUseTaskMetadata, BrowserUseStep, BrowserUseAgentBrain, BrowserUseAgentOutput, BrowserUseActionResult, BrowserUseStepMetadata, BrowserUseTabInfo, BrowserUseBrowserStateHistory, BrowserUseAgentHistory, BrowserUseAgentOutputV0710, BrowserUseActionResultV0710, BrowserUseBrowserStateHistoryV0710, BrowserUseStepMetadataV0710, BrowserUseAgentHistoryV0710, BrowserUseAgentHistoryLatest, } from "./agents/browser-use";
 export { StartClaudeComputerUseTaskParams, StartClaudeComputerUseTaskResponse, ClaudeComputerUseTaskStatusResponse, ClaudeComputerUseTaskResponse, ClaudeComputerUseTaskData, ClaudeComputerUseStepResponse, ClaudeComputerUseApiKeys, ClaudeComputerUseTaskMetadata, } from "./agents/claude-computer-use";
@@ -11,7 +11,7 @@ export { StartGeminiComputerUseTaskParams, StartGeminiComputerUseTaskResponse, G
 export { StartGrokComputerUseTaskParams, StartGrokComputerUseTaskResponse, GrokComputerUseTaskStatusResponse, GrokComputerUseTaskResponse, GrokComputerUseTaskData, GrokComputerUseStepResponse, GrokComputerUseApiKeys, GrokComputerUseTaskMetadata, } from "./agents/grok-computer-use";
 export { StartMetaComputerUseTaskParams, StartMetaComputerUseTaskResponse, MetaComputerUseTaskStatusResponse, MetaComputerUseTaskResponse, MetaComputerUseTaskData, MetaComputerUseStepResponse, MetaComputerUseStepError, MetaComputerUseStepIncompleteDetails, MetaComputerUseStepReasoning, MetaComputerUseApiKeys, MetaComputerUseTaskMetadata, } from "./agents/meta-computer-use";
 export { StartJevComputerUseTaskParams, StartJevComputerUseTaskResponse, JevComputerUseTaskStatusResponse, JevComputerUseTaskResponse, JevComputerUseTaskData, JevComputerUseStepResponse, JevComputerUseApiKeys, JevComputerUseTaskMetadata, } from "./agents/jev-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, SessionWebBotAuth, SessionCreditBreakdown, StartSessionFromSnapshotParams, WebBotAuthParams, ProxyRoute, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, UpdateSessionScreenParams, UpdateSessionSolveCaptchasParams, UpdateSessionSolveCaptchasResponse, } from "./session";
+export { BasicResponse, BrowserMemorySize, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionProfile, CaptchaEvaluationPageResult, CaptchaEvaluationParams, CaptchaEvaluationResponse, CaptchaEvaluationTarget, CaptchaEvaluationType, CaptchaSolverType, CreateSessionParams, CreateSessionSnapshotResponse, SessionRecording, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, SessionWebBotAuth, SessionCreditBreakdown, StartSessionFromSnapshotParams, WebBotAuthParams, ProxyRoute, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, UpdateSessionScreenParams, UpdateSessionSolveCaptchasParams, UpdateSessionSolveCaptchasResponse, } from "./session";
 export { SandboxStatus, SandboxRuntimeTarget, SandboxNetworkPolicy, SandboxNetworkPolicyPatch, SandboxNetworkUpdateResult, Sandbox, SandboxDetail, SandboxVolumeMountType, SandboxVolumeMount, SandboxSecretReference, SandboxStoredSecretReference, SandboxSecrets, SandboxVaultSource, SandboxResolvedSecret, SandboxStoredSecretBinding, SandboxOnePasswordBinding, SandboxSecretSource, SandboxOnePassword, SandboxOnePasswordField, SandboxListParams, SandboxListResponse, SandboxImageSource, SandboxImageSummary, SandboxImageListParams, SandboxImageListResponse, SandboxSnapshotStatus, SandboxSnapshotSummary, SandboxSnapshotListParams, SandboxSnapshotListResponse, SandboxSnapshotDeleteResult, SandboxImageDeleteResult, SandboxImageInit, SandboxImageBuildStatus, SandboxImageBuildInputFormat, SandboxImageBuildSourcePlatform, SandboxImageBuildUpload, SandboxImageBuild, SandboxBuildContextBundle, SandboxBuildContextMode, SandboxBuildContextManifest, SandboxDockerImageConfig, SandboxDockerImageLayer, SandboxDockerImageManifest, CreateSandboxImageBuildParams, ReuseSandboxDockerImageParams, CompleteSandboxImageBuildParams, SandboxImageBuildCreateResult, SandboxDockerImageReuseResult, SandboxImageBuildResolutionOutcome, SandboxImageBuildResolution, SandboxImageBuildWaitOptions, BuildSandboxImageFromDockerImageOptions, BuildSandboxImageFromDockerfileOptions, GetOrBuildSandboxImageOptions, SandboxImageBuildListParams, SandboxImageBuildListResponse, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxUnexposeResult, SandboxProcessStatus, SandboxExecParams, SandboxExecOptions, SandboxProcessSummary, SandboxProcessResult, SandboxProcessListParams, SandboxProcessListResponse, SandboxProcessWaitParams, SandboxProcessSignal, SandboxProcessStdinParams, SandboxProcessOutputEvent, SandboxProcessExitEvent, 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, VolumeDeleteResult, } from "./volume";
 export { SecretValue, SecretType, SecretProtection, SecretBrowserMetadata, SecretMetadata, UpdateSecretMetadata, SecretsPublicKey, SecretsPublicKeyJwk, Secret, SecretVersion, SecretDetail, CreateSecretParams, UpdateSecretParams, SecretListParams, SecretListResponse, SecretDeleteResult, SecretVersionDeleteResult, WrappedSecretVersion, UnwrappedSecretReference, UnwrapSecretOptions, AddSecretVersionOptions, ReplaceSecretVersionWrappingParams, RewrapSecretParams, } from "./secret";
@@ -26,6 +26,7 @@ export { TeamCreditInfo } from "./team";
 export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, CursorPositionActionParams, ScrollAtCursorActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, ComputerActionMouseButton, ComputerActionResponseData, HoldKeyActionParams, MouseDownActionParams, MouseUpActionParams, GetClipboardTextActionParams, PutSelectionTextActionParams, ComputerActionResponseDataClipboardText, ListWindowsActionParams, ComputerActionWindow, ComputerActionResponseDataListWindows, ComputerActionResponseDataCursorPosition, } from "./computer-action";
 export { FetchParams, FetchResponse, FetchResponseData, FetchStatus } from "./web/fetch";
 export { StartBatchFetchJobParams, GetBatchFetchJobParams, StartBatchFetchJobResponse, BatchFetchJobStatusResponse, BatchFetchJobResponse, BatchFetchJobStatus, } from "./web/batch-fetch";
+export { WebCrawlJobStatus, WebCrawlOptions, StartWebCrawlJobParams, GetWebCrawlJobParams, StartWebCrawlJobResponse, WebCrawlJobStatusResponse, WebCrawlJobResponse, } from "./web/crawl";
 export { WebSearchParams, WebSearchResponse, WebSearchResponseData, WebSearchResultItem, WebSearchFilters, WebSearchLocation, WebSearchFiletype, WebSearchStatus, } from "./web/search";
 export { FetchStealthMode, FetchSanitizeMode, FetchWaitUntil, FetchScreenshotFormat, PageStatus, FetchOutputScreenshotOptions, FetchStorageStateOptions, FetchBrowserLocationOptions, PageData, FetchOutputMarkdown, FetchOutputHtml, FetchOutputLinks, FetchOutputScreenshot, FetchOutputJsonOptions, FetchOutputJson, FetchOutputBranding, FetchOutputFormat, FetchOutputOptions, FetchBrowserOptions, FetchNavigationOptions, FetchCacheOptions, } from "./web/common";
 export { BrandingProfile, BrandingColors, BrandingFont, BrandingFontRole, BrandingTypography, BrandingFontFamilies, BrandingFontStacks, BrandingFontSizes, BrandingSpacing, BrandingComponents, BrandingButtonStyle, BrandingInputStyle, BrandingBorderRadiusCorners, BrandingImages, BrandingPersonality, BrandingPersonalityTone, BrandingPersonalityEnergy, BrandingDesignSystem, BrandingDesignFramework, BrandingConfidence, BrandingColorScheme, } from "./web/branding";

package/dist/types/session.d.ts

@@ -9,6 +9,7 @@ export interface BasicResponse {
 export interface SessionProfile {
     id: string;
     persistChanges?: boolean;
+    persistNetworkCache?: boolean;
 }
 /** How a session signs its requests with Web Bot Auth. */
 export interface SessionWebBotAuth {
@@ -48,6 +49,8 @@ export interface SessionLaunchState {
     enableAlwaysOpenPdfExternally?: boolean;
     appendTimestampToDownloads?: boolean;
     disablePostQuantumKeyAgreement?: boolean;
+    /** @deprecated Discontinued: WebGL fingerprinting was removed from the browser, and the server ignores this option. Kept so existing code still type-checks. */
+    enableWebglFingerprinting?: boolean;
 }
 export interface SessionCreditBreakdown {
     creditsUsed: number | null;
@@ -66,6 +69,8 @@ export interface Session {
     launchState?: SessionLaunchState | null;
     creditsUsed: number | null;
     creditBreakdown: SessionCreditBreakdown;
+    duration?: number;
+    proxyDataConsumed?: string;
 }
 export interface SessionDetail extends Session {
     wsEndpoint: string;
@@ -215,6 +220,7 @@ export interface CreateSessionParams {
     saveDownloads?: boolean;
     imageCaptchaParams?: Array<ImageCaptchaParam>;
     timeoutMinutes?: number;
+    /** @deprecated Discontinued: WebGL fingerprinting was removed from the browser, and the server ignores this option. Kept so existing code still type-checks. */
     enableWebglFingerprinting?: boolean;
     enableWindowManager?: boolean;
     enableWindowManagerTaskbar?: boolean;

package/package.json

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