@hyperbrowser/sdk 0.53.0 → 0.54.0

package/dist/client.d.ts

@@ -10,6 +10,7 @@ import { CuaService } from "./services/agents/cua";
 import { ClaudeComputerUseService } from "./services/agents/claude-computer-use";
 import { HyperAgentService } from "./services/agents/hyper-agent";
 import { TeamService } from "./services/team";
+import { ComputerActionService } from "./services/computer-action";
 export declare class HyperbrowserError extends Error {
     statusCode?: number | undefined;
     constructor(message: string, statusCode?: number | undefined);
@@ -28,5 +29,6 @@ export declare class HyperbrowserClient {
         hyperAgent: HyperAgentService;
     };
     readonly team: TeamService;
+    readonly computerAction: ComputerActionService;
     constructor(config?: HyperbrowserConfig);
 }

package/dist/client.js

@@ -12,6 +12,7 @@ const cua_1 = require("./services/agents/cua");
 const claude_computer_use_1 = require("./services/agents/claude-computer-use");
 const hyper_agent_1 = require("./services/agents/hyper-agent");
 const team_1 = require("./services/team");
+const computer_action_1 = require("./services/computer-action");
 class HyperbrowserError extends Error {
     constructor(message, statusCode) {
         super(`[Hyperbrowser]: ${message}`);
@@ -35,6 +36,7 @@ class HyperbrowserClient {
         this.profiles = new profiles_1.ProfilesService(apiKey, baseUrl, timeout);
         this.extensions = new extensions_1.ExtensionService(apiKey, baseUrl, timeout);
         this.team = new team_1.TeamService(apiKey, baseUrl, timeout);
+        this.computerAction = new computer_action_1.ComputerActionService(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/services/base.d.ts

@@ -4,5 +4,5 @@ export declare class BaseService {
     protected readonly baseUrl: string;
     protected readonly timeout: number;
     constructor(apiKey: string, baseUrl: string, timeout?: number);
-    protected request<T>(path: string, init?: RequestInit, params?: Record<string, string | number | undefined>): Promise<T>;
+    protected request<T>(path: string, init?: RequestInit, params?: Record<string, string | number | undefined>, fullUrl?: boolean): Promise<T>;
 }

package/dist/services/base.js

@@ -12,9 +12,9 @@ class BaseService {
         this.baseUrl = baseUrl;
         this.timeout = timeout;
     }
-    async request(path, init, params) {
+    async request(path, init, params, fullUrl = false) {
         try {
-            const url = new URL(`${this.baseUrl}/api${path}`);
+            const url = new URL(fullUrl ? path : `${this.baseUrl}/api${path}`);
             if (params) {
                 Object.entries(params).forEach(([key, value]) => {
                     if (value !== undefined) {

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

@@ -0,0 +1,13 @@
+import { SessionDetail } from "../types";
+import { ComputerActionResponse, Coordinate } from "../types/computer-action";
+import { BaseService } from "./base";
+export declare class ComputerActionService extends BaseService {
+    private executeRequest;
+    click(session: SessionDetail | string, x: number, y: number, button?: "left" | "right" | "middle" | "back" | "forward" | "wheel", numClicks?: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    typeText(session: SessionDetail | string, text: string, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    screenshot(session: SessionDetail | string): Promise<ComputerActionResponse>;
+    pressKeys(session: SessionDetail | string, keys: string[], returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    drag(session: SessionDetail | string, path: Coordinate[], returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    moveMouse(session: SessionDetail | string, x: number, y: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    scroll(session: SessionDetail | string, x: number, y: number, scrollX: number, scrollY: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+}

package/dist/services/computer-action.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComputerActionService = void 0;
+const computer_action_1 = require("../types/computer-action");
+const base_1 = require("./base");
+const client_1 = require("../client");
+class ComputerActionService extends base_1.BaseService {
+    async executeRequest(session, params) {
+        try {
+            let sessionDetail;
+            if (typeof session === "string") {
+                sessionDetail = await this.request(`/session/${session}`);
+            }
+            else {
+                sessionDetail = session;
+            }
+            if (!sessionDetail.computerActionEndpoint) {
+                throw new client_1.HyperbrowserError("Computer action endpoint not available for this session", undefined);
+            }
+            return await this.request(sessionDetail.computerActionEndpoint, {
+                method: "POST",
+                body: JSON.stringify(params),
+            }, undefined, true);
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to execute computer action", undefined);
+        }
+    }
+    async click(session, x, y, button = "left", numClicks = 1, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.CLICK,
+            x,
+            y,
+            button,
+            numClicks,
+            returnScreenshot,
+        });
+    }
+    async typeText(session, text, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.TYPE_TEXT,
+            text,
+            returnScreenshot,
+        });
+    }
+    async screenshot(session) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.SCREENSHOT,
+        });
+    }
+    async pressKeys(session, keys, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.PRESS_KEYS,
+            keys,
+            returnScreenshot,
+        });
+    }
+    async drag(session, path, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.DRAG,
+            path,
+            returnScreenshot,
+        });
+    }
+    async moveMouse(session, x, y, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.MOVE_MOUSE,
+            x,
+            y,
+            returnScreenshot,
+        });
+    }
+    async scroll(session, x, y, scrollX, scrollY, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.SCROLL,
+            x,
+            y,
+            scrollX,
+            scrollY,
+            returnScreenshot,
+        });
+    }
+}
+exports.ComputerActionService = ComputerActionService;

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

@@ -0,0 +1,93 @@
+/**
+ * Computer action types enumeration
+ */
+export declare enum ComputerAction {
+    CLICK = "click",
+    DRAG = "drag",
+    PRESS_KEYS = "press_keys",
+    MOVE_MOUSE = "move_mouse",
+    SCREENSHOT = "screenshot",
+    SCROLL = "scroll",
+    TYPE_TEXT = "type_text"
+}
+/**
+ * Coordinate model for drag actions
+ */
+export interface Coordinate {
+    x: number;
+    y: number;
+}
+/**
+ * Parameters for click action
+ */
+export interface ClickActionParams {
+    action: ComputerAction.CLICK;
+    x: number;
+    y: number;
+    button?: "left" | "right" | "middle" | "back" | "forward" | "wheel";
+    numClicks?: number;
+    returnScreenshot?: boolean;
+}
+/**
+ * Parameters for drag action
+ */
+export interface DragActionParams {
+    action: ComputerAction.DRAG;
+    path: Coordinate[];
+    returnScreenshot?: boolean;
+}
+/**
+ * Parameters for press keys action
+ */
+export interface PressKeysActionParams {
+    action: ComputerAction.PRESS_KEYS;
+    keys: string[];
+    returnScreenshot?: boolean;
+}
+/**
+ * Parameters for move mouse action
+ */
+export interface MoveMouseActionParams {
+    action: ComputerAction.MOVE_MOUSE;
+    x: number;
+    y: number;
+    returnScreenshot?: boolean;
+}
+/**
+ * Parameters for screenshot action
+ */
+export interface ScreenshotActionParams {
+    action: ComputerAction.SCREENSHOT;
+}
+/**
+ * Parameters for scroll action
+ */
+export interface ScrollActionParams {
+    action: ComputerAction.SCROLL;
+    x: number;
+    y: number;
+    scrollX: number;
+    scrollY: number;
+    returnScreenshot?: boolean;
+}
+/**
+ * Parameters for type text action
+ */
+export interface TypeTextActionParams {
+    action: ComputerAction.TYPE_TEXT;
+    text: string;
+    returnScreenshot?: boolean;
+}
+/**
+ * Union type for all computer action parameters
+ */
+export type ComputerActionParams = ClickActionParams | DragActionParams | PressKeysActionParams | MoveMouseActionParams | ScreenshotActionParams | ScrollActionParams | TypeTextActionParams;
+/**
+ * Response from computer action API
+ */
+export interface ComputerActionResponse {
+    success: boolean;
+    screenshot?: string;
+    error?: string;
+    message?: string;
+}

package/dist/types/computer-action.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComputerAction = void 0;
+/**
+ * Computer action types enumeration
+ */
+var ComputerAction;
+(function (ComputerAction) {
+    ComputerAction["CLICK"] = "click";
+    ComputerAction["DRAG"] = "drag";
+    ComputerAction["PRESS_KEYS"] = "press_keys";
+    ComputerAction["MOVE_MOUSE"] = "move_mouse";
+    ComputerAction["SCREENSHOT"] = "screenshot";
+    ComputerAction["SCROLL"] = "scroll";
+    ComputerAction["TYPE_TEXT"] = "type_text";
+})(ComputerAction || (exports.ComputerAction = ComputerAction = {}));

package/dist/types/index.d.ts

@@ -11,3 +11,4 @@ export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileLis
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
 export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, } from "./constants";
 export { TeamCreditInfo } from "./team";
+export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, } from "./computer-action";

package/dist/types/index.js

@@ -1,2 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComputerAction = void 0;
+var computer_action_1 = require("./computer-action");
+Object.defineProperty(exports, "ComputerAction", { enumerable: true, get: function () { return computer_action_1.ComputerAction; } });

package/dist/types/session.d.ts

@@ -16,6 +16,7 @@ export interface Session {
 }
 export interface SessionDetail extends Session {
     wsEndpoint: string;
+    computerActionEndpoint?: string;
     liveUrl?: string;
     token: string;
 }

package/package.json

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