@hyperbrowser/sdk 0.89.6 → 0.89.8

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

package/dist/services/sessions.js

@@ -359,6 +359,20 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to update proxy for session ${id}`, undefined);
         }
     }
+    async updateScreenSize(id, params) {
+        try {
+            return await this.request(`/session/${id}/update`, {
+                method: "PUT",
+                body: JSON.stringify({ type: "screen", params }),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to update screen 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, } from "./session";
+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 { 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

@@ -202,3 +202,7 @@ export interface UpdateSessionProxyParams {
     staticIpId?: string;
     location?: UpdateSessionProxyLocationParams;
 }
+export interface UpdateSessionScreenParams {
+    width: number;
+    height: number;
+}

package/package.json

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