@hyperbrowser/sdk 0.89.7 → 0.90.0

package/dist/services/base.js

@@ -51,9 +51,10 @@ class BaseService {
             }
             const headerKeys = Object.keys(init?.headers || {});
             const contentTypeKey = headerKeys.find((key) => key.toLowerCase() === "content-type");
+            const requestTimeout = init?.timeout ?? this.timeout;
             const response = await (0, node_fetch_1.default)(url.toString(), {
                 ...init,
-                timeout: this.timeout,
+                timeout: requestTimeout,
                 headers: {
                     "x-api-key": this.apiKey,
                     ...(contentTypeKey && init?.headers

package/dist/services/computer-action.d.ts

@@ -15,4 +15,5 @@ export declare class ComputerActionService extends BaseService {
     mouseUp(session: SessionDetail | string, button?: ComputerActionMouseButton, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
     getClipboardText(session: SessionDetail | string, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
     putSelectionText(session: SessionDetail | string, text: string, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    listWindows(session: SessionDetail | string, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
 }

package/dist/services/computer-action.js

@@ -118,5 +118,11 @@ class ComputerActionService extends base_1.BaseService {
             returnScreenshot,
         });
     }
+    async listWindows(session, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.LIST_WINDOWS,
+            returnScreenshot,
+        });
+    }
 }
 exports.ComputerActionService = ComputerActionService;

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, UpdateSessionProxyParams, UpdateSessionScreenParams, SessionGetParams } from "../types/session";
+import { BasicResponse, CaptchaEvaluationParams, CaptchaEvaluationResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse, SessionEventLogListParams, SessionEventLogListResponse, UpdateSessionProfileParams, UpdateSessionProxyParams, UpdateSessionScreenParams, UpdateSessionSolveCaptchasParams, UpdateSessionSolveCaptchasResponse, SessionGetParams } from "../types/session";
 import { BaseService } from "./base";
 /**
  * Service for managing session event logs
@@ -29,6 +29,12 @@ export declare class SessionsService extends BaseService {
      * @param id The ID of the session to stop
      */
     stop(id: string): Promise<BasicResponse>;
+    /**
+     * Manually evaluate captchas in a running session.
+     * @param id The ID of the session to evaluate
+     * @param params Optional captcha evaluation parameters
+     */
+    evaluateCaptcha(id: string, params?: CaptchaEvaluationParams): Promise<CaptchaEvaluationResponse>;
     /**
      * List all sessions with optional filtering
      * @param params Optional parameters to filter the sessions
@@ -81,6 +87,17 @@ export declare class SessionsService extends BaseService {
     updateProfileParams(id: string, persistChanges: boolean): Promise<BasicResponse>;
     updateProxyParams(id: string, params: UpdateSessionProxyParams): Promise<BasicResponse>;
     updateScreenSize(id: string, params: UpdateSessionScreenParams): Promise<BasicResponse>;
+    /**
+     * Start automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     * @param params Optional captcha solver parameters
+     */
+    startCaptchaSolving(id: string, params?: UpdateSessionSolveCaptchasParams): Promise<UpdateSessionSolveCaptchasResponse>;
+    /**
+     * Stop automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     */
+    stopCaptchaSolving(id: string): Promise<UpdateSessionSolveCaptchasResponse>;
     private static hasWarnedUpdateSessionProfileParamsBooleanDeprecated;
     private warnUpdateSessionProfileParamsBooleanDeprecated;
 }

package/dist/services/sessions.js

@@ -32,6 +32,7 @@ const path = __importStar(require("path"));
 const form_data_1 = __importDefault(require("form-data"));
 const base_1 = require("./base");
 const client_1 = require("../client");
+const CAPTCHA_EVALUATION_REQUEST_TIMEOUT_MS = 185000;
 /**
  * Service for managing session event logs
  */
@@ -113,6 +114,26 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to stop session ${id}`, undefined);
         }
     }
+    /**
+     * Manually evaluate captchas in a running session.
+     * @param id The ID of the session to evaluate
+     * @param params Optional captcha evaluation parameters
+     */
+    async evaluateCaptcha(id, params = {}) {
+        try {
+            return await this.request(`/session/${id}/captcha/evaluate`, {
+                method: "POST",
+                timeout: Math.max(this.timeout, CAPTCHA_EVALUATION_REQUEST_TIMEOUT_MS),
+                body: JSON.stringify(params),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to evaluate captcha for session ${id}`, undefined);
+        }
+    }
     /**
      * List all sessions with optional filtering
      * @param params Optional parameters to filter the sessions
@@ -373,6 +394,54 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to update screen for session ${id}`, undefined);
         }
     }
+    /**
+     * Start automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     * @param params Optional captcha solver parameters
+     */
+    async startCaptchaSolving(id, params = {}) {
+        try {
+            return await this.request(`/session/${id}/update`, {
+                method: "PUT",
+                body: JSON.stringify({
+                    type: "solveCaptchas",
+                    params: {
+                        enabled: true,
+                        ...params,
+                    },
+                }),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to start captcha solving for session ${id}`, undefined);
+        }
+    }
+    /**
+     * Stop automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     */
+    async stopCaptchaSolving(id) {
+        try {
+            return await this.request(`/session/${id}/update`, {
+                method: "PUT",
+                body: JSON.stringify({
+                    type: "solveCaptchas",
+                    params: {
+                        enabled: false,
+                    },
+                }),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to stop captcha solving for session ${id}`, undefined);
+        }
+    }
     warnUpdateSessionProfileParamsBooleanDeprecated() {
         if (SessionsService.hasWarnedUpdateSessionProfileParamsBooleanDeprecated) {
             return;

package/dist/types/computer-action.d.ts

@@ -13,7 +13,8 @@ export declare enum ComputerAction {
     SCROLL = "scroll",
     TYPE_TEXT = "type_text",
     GET_CLIPBOARD_TEXT = "get_clipboard_text",
-    PUT_SELECTION_TEXT = "put_selection_text"
+    PUT_SELECTION_TEXT = "put_selection_text",
+    LIST_WINDOWS = "list_windows"
 }
 export type ComputerActionMouseButton = "left" | "right" | "middle" | "back" | "forward" | "wheel";
 /**
@@ -118,14 +119,36 @@ export interface PutSelectionTextActionParams {
     text: string;
     returnScreenshot?: boolean;
 }
+/**
+ * Parameters for list windows action.
+ */
+export interface ListWindowsActionParams {
+    action: ComputerAction.LIST_WINDOWS;
+    returnScreenshot?: boolean;
+}
 /**
  * Union type for all computer action parameters
  */
-export type ComputerActionParams = ClickActionParams | DragActionParams | PressKeysActionParams | MoveMouseActionParams | ScreenshotActionParams | ScrollActionParams | TypeTextActionParams | HoldKeyActionParams | MouseDownActionParams | MouseUpActionParams | GetClipboardTextActionParams | PutSelectionTextActionParams;
+export type ComputerActionParams = ClickActionParams | DragActionParams | PressKeysActionParams | MoveMouseActionParams | ScreenshotActionParams | ScrollActionParams | TypeTextActionParams | HoldKeyActionParams | MouseDownActionParams | MouseUpActionParams | GetClipboardTextActionParams | PutSelectionTextActionParams | ListWindowsActionParams;
 export interface ComputerActionResponseDataClipboardText {
     clipboardText?: string;
 }
-export type ComputerActionResponseData = ComputerActionResponseDataClipboardText;
+/**
+ * A single visible top-level X11/native window entry.
+ */
+export interface ComputerActionWindow {
+    id: string;
+    name: string;
+    active: boolean;
+}
+/**
+ * Response data for the list windows action.
+ */
+export interface ComputerActionResponseDataListWindows {
+    activeWindowId: string;
+    windows: ComputerActionWindow[];
+}
+export type ComputerActionResponseData = ComputerActionResponseDataClipboardText | ComputerActionResponseDataListWindows;
 /**
  * Response from computer action API
  */

package/dist/types/computer-action.js

@@ -18,4 +18,5 @@ var ComputerAction;
     ComputerAction["TYPE_TEXT"] = "type_text";
     ComputerAction["GET_CLIPBOARD_TEXT"] = "get_clipboard_text";
     ComputerAction["PUT_SELECTION_TEXT"] = "put_selection_text";
+    ComputerAction["LIST_WINDOWS"] = "list_windows";
 })(ComputerAction || (exports.ComputerAction = ComputerAction = {}));

package/dist/types/index.d.ts

@@ -7,14 +7,14 @@ 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, SessionCreditBreakdown, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, UpdateSessionScreenParams, } from "./session";
+export { BasicResponse, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CaptchaEvaluationPageResult, CaptchaEvaluationParams, CaptchaEvaluationResponse, CaptchaEvaluationTarget, CaptchaEvaluationType, CaptchaSolverType, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, SessionCreditBreakdown, 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 { 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";
 export { TeamCreditInfo } from "./team";
-export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, ComputerActionMouseButton, ComputerActionResponseData, HoldKeyActionParams, MouseDownActionParams, MouseUpActionParams, GetClipboardTextActionParams, PutSelectionTextActionParams, ComputerActionResponseDataClipboardText, } from "./computer-action";
+export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, ComputerActionMouseButton, ComputerActionResponseData, HoldKeyActionParams, MouseDownActionParams, MouseUpActionParams, GetClipboardTextActionParams, PutSelectionTextActionParams, ComputerActionResponseDataClipboardText, ListWindowsActionParams, ComputerActionWindow, ComputerActionResponseDataListWindows, } from "./computer-action";
 export { FetchParams, FetchResponse, FetchResponseData, FetchStatus } from "./web/fetch";
 export { StartBatchFetchJobParams, GetBatchFetchJobParams, StartBatchFetchJobResponse, BatchFetchJobStatusResponse, BatchFetchJobResponse, BatchFetchJobStatus, } from "./web/batch-fetch";
 export { WebSearchParams, WebSearchResponse, WebSearchResponseData, WebSearchResultItem, WebSearchFilters, WebSearchLocation, WebSearchFiletype, WebSearchStatus, } from "./web/search";

package/dist/types/session.d.ts

@@ -21,6 +21,7 @@ export interface SessionLaunchState {
     enableVideoWebRecording?: boolean;
     enableLogCapture?: boolean;
     acceptCookies?: boolean;
+    solverType?: CaptchaSolverType;
     profile?: SessionProfile;
     staticIpId?: string;
     saveDownloads?: boolean;
@@ -85,6 +86,39 @@ export interface ImageCaptchaParam {
     imageSelector: string;
     inputSelector: string;
 }
+export type CaptchaSolverType = "visual" | (string & {});
+export type CaptchaEvaluationType = "turnstile" | "cloudflare-challenge" | "aliexpress" | "recaptcha" | "recaptcha-visual" | "amazon";
+export type CaptchaEvaluationTarget = CaptchaEvaluationType;
+export interface CaptchaEvaluationParams {
+    captcha?: CaptchaEvaluationTarget;
+    captchaType?: CaptchaEvaluationTarget;
+    text?: CaptchaEvaluationTarget;
+    iterations?: number;
+    maxIterations?: number;
+    solverType?: CaptchaSolverType;
+    imageCaptchaParams?: Array<ImageCaptchaParam>;
+    useGeminiCaptchaSolver?: boolean;
+    useUltraStealth?: boolean;
+}
+export interface CaptchaEvaluationPageResult {
+    url: string;
+    targetId: string | null;
+    iterationsRun: number;
+    solved: boolean;
+    solvedCaptchas: CaptchaEvaluationType[];
+    checkedCaptchas: CaptchaEvaluationType[];
+    captchaSolvedCounts: Record<string, number>;
+    lastSolveTime: Record<string, number>;
+}
+export interface CaptchaEvaluationResponse {
+    success: true;
+    captcha: CaptchaEvaluationType | null;
+    iterationsRequested: number;
+    iterationsRun: number;
+    solved: boolean;
+    solvedCaptchas: CaptchaEvaluationType[];
+    pages: CaptchaEvaluationPageResult[];
+}
 export interface CreateSessionParams {
     useUltraStealth?: boolean;
     useStealth?: boolean;
@@ -101,6 +135,7 @@ export interface CreateSessionParams {
     locales?: ISO639_1[];
     screen?: ScreenConfig;
     solveCaptchas?: boolean;
+    solverType?: CaptchaSolverType;
     adblock?: boolean;
     trackers?: boolean;
     annoyances?: boolean;
@@ -206,3 +241,11 @@ export interface UpdateSessionScreenParams {
     width: number;
     height: number;
 }
+export interface UpdateSessionSolveCaptchasParams {
+    solverType?: CaptchaSolverType;
+}
+export interface UpdateSessionSolveCaptchasResponse extends BasicResponse {
+    solveCaptchas?: boolean;
+    sessionId?: string;
+    telemetryReady?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperbrowser/sdk",
-  "version": "0.89.7",
+  "version": "0.90.0",
   "description": "Node SDK for Hyperbrowser API",
   "author": "",
   "repository": {
@@ -21,6 +21,7 @@
     "prepare": "yarn build",
     "test": "vitest run",
     "test:e2e": "vitest run tests/sandbox/e2e",
+    "test:integration": "vitest run tests/integration",
     "test:watch": "vitest",
     "format": "prettier --write 'src/**/*.ts'"
   },