@hyperbrowser/sdk 0.46.0 → 0.48.0

package/dist/client.d.ts

@@ -8,6 +8,7 @@ import { ExtractService } from "./services/extract";
 import { BrowserUseService } from "./services/agents/browser-use";
 import { CuaService } from "./services/agents/cua";
 import { ClaudeComputerUseService } from "./services/agents/claude-computer-use";
+import { HyperAgentService } from "./services/agents/hyper-agent";
 export declare class HyperbrowserError extends Error {
     statusCode?: number | undefined;
     constructor(message: string, statusCode?: number | undefined);
@@ -23,6 +24,7 @@ export declare class HyperbrowserClient {
         browserUse: BrowserUseService;
         claudeComputerUse: ClaudeComputerUseService;
         cua: CuaService;
+        hyperAgent: HyperAgentService;
     };
     constructor(config?: HyperbrowserConfig);
 }

package/dist/client.js

@@ -10,6 +10,7 @@ const extract_1 = require("./services/extract");
 const browser_use_1 = require("./services/agents/browser-use");
 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");
 class HyperbrowserError extends Error {
     constructor(message, statusCode) {
         super(`[Hyperbrowser]: ${message}`);
@@ -36,6 +37,7 @@ class HyperbrowserClient {
             browserUse: new browser_use_1.BrowserUseService(apiKey, baseUrl, timeout),
             claudeComputerUse: new claude_computer_use_1.ClaudeComputerUseService(apiKey, baseUrl, timeout),
             cua: new cua_1.CuaService(apiKey, baseUrl, timeout),
+            hyperAgent: new hyper_agent_1.HyperAgentService(apiKey, baseUrl, timeout),
         };
     }
 }

package/dist/services/agents/browser-use.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BrowserUseService = void 0;
+const zod_to_json_schema_1 = __importDefault(require("zod-to-json-schema"));
 const client_1 = require("../../client");
 const constants_1 = require("../../types/constants");
 const utils_1 = require("../../utils");
@@ -12,6 +16,11 @@ class BrowserUseService extends base_1.BaseService {
      */
     async start(params) {
         try {
+            if (params.outputModelSchema) {
+                if ((0, utils_1.isZodSchema)(params.outputModelSchema)) {
+                    params.outputModelSchema = (0, zod_to_json_schema_1.default)(params.outputModelSchema);
+                }
+            }
             return await this.request("/task/browser-use", {
                 method: "POST",
                 body: JSON.stringify(params),

package/dist/services/agents/hyper-agent.d.ts

@@ -0,0 +1,30 @@
+import { BasicResponse } from "../../types";
+import { BaseService } from "../base";
+import { HyperAgentTaskResponse, HyperAgentTaskStatusResponse, StartHyperAgentTaskParams, StartHyperAgentTaskResponse } from "../../types/agents/hyper-agent";
+export declare class HyperAgentService extends BaseService {
+    /**
+     * Start a new HyperAgent task job
+     * @param params The parameters for the task job
+     */
+    start(params: StartHyperAgentTaskParams): Promise<StartHyperAgentTaskResponse>;
+    /**
+     * Get the status of a HyperAgent task job
+     * @param id The ID of the task job to get
+     */
+    getStatus(id: string): Promise<HyperAgentTaskStatusResponse>;
+    /**
+     * Get the result of a HyperAgent task job
+     * @param id The ID of the task job to get
+     */
+    get(id: string): Promise<HyperAgentTaskResponse>;
+    /**
+     * Stop a HyperAgent task job
+     * @param id The ID of the task job to stop
+     */
+    stop(id: string): Promise<BasicResponse>;
+    /**
+     * Start a HyperAgent task job and wait for it to complete
+     * @param params The parameters for the task job
+     */
+    startAndWait(params: StartHyperAgentTaskParams): Promise<HyperAgentTaskResponse>;
+}

package/dist/services/agents/hyper-agent.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperAgentService = void 0;
+const client_1 = require("../../client");
+const constants_1 = require("../../types/constants");
+const utils_1 = require("../../utils");
+const base_1 = require("../base");
+class HyperAgentService extends base_1.BaseService {
+    /**
+     * Start a new HyperAgent task job
+     * @param params The parameters for the task job
+     */
+    async start(params) {
+        try {
+            return await this.request("/task/hyper-agent", {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to start HyperAgent task job", undefined);
+        }
+    }
+    /**
+     * Get the status of a HyperAgent task job
+     * @param id The ID of the task job to get
+     */
+    async getStatus(id) {
+        try {
+            return await this.request(`/task/hyper-agent/${id}/status`);
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to get HyperAgent task job ${id} status`, undefined);
+        }
+    }
+    /**
+     * Get the result of a HyperAgent task job
+     * @param id The ID of the task job to get
+     */
+    async get(id) {
+        try {
+            return await this.request(`/task/hyper-agent/${id}`);
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to get HyperAgent task job ${id}`, undefined);
+        }
+    }
+    /**
+     * Stop a HyperAgent task job
+     * @param id The ID of the task job to stop
+     */
+    async stop(id) {
+        try {
+            return await this.request(`/task/hyper-agent/${id}/stop`, {
+                method: "PUT",
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to stop HyperAgent task job ${id}`, undefined);
+        }
+    }
+    /**
+     * Start a HyperAgent task job and wait for it to complete
+     * @param params The parameters for the task job
+     */
+    async startAndWait(params) {
+        const job = await this.start(params);
+        const jobId = job.jobId;
+        if (!jobId) {
+            throw new client_1.HyperbrowserError("Failed to start HyperAgent task job, could not get job ID");
+        }
+        let failures = 0;
+        while (true) {
+            try {
+                const { status } = await this.getStatus(jobId);
+                if (status === "completed" || status === "failed" || status === "stopped") {
+                    return await this.get(jobId);
+                }
+                failures = 0;
+            }
+            catch (error) {
+                failures++;
+                if (failures >= constants_1.POLLING_ATTEMPTS) {
+                    throw new client_1.HyperbrowserError(`Failed to poll HyperAgent task job ${jobId} after ${constants_1.POLLING_ATTEMPTS} attempts: ${error}`);
+                }
+            }
+            await (0, utils_1.sleep)(2000);
+        }
+    }
+}
+exports.HyperAgentService = HyperAgentService;

package/dist/services/extract.js

@@ -6,13 +6,6 @@ const base_1 = require("./base");
 const utils_1 = require("../utils");
 const client_1 = require("../client");
 const constants_1 = require("../types/constants");
-const isZodSchema = (schema) => {
-    return (schema &&
-        typeof schema === "object" &&
-        "_def" in schema &&
-        "parse" in schema &&
-        typeof schema.parse === "function");
-};
 class ExtractService extends base_1.BaseService {
     /**
      * Start a new extract job
@@ -24,7 +17,7 @@ class ExtractService extends base_1.BaseService {
                 throw new client_1.HyperbrowserError("Either schema or prompt must be provided");
             }
             if (params.schema) {
-                if (isZodSchema(params.schema)) {
+                if ((0, utils_1.isZodSchema)(params.schema)) {
                     params.schema = (0, zod_to_json_schema_1.zodToJsonSchema)(params.schema);
                 }
             }

package/dist/services/sessions.d.ts

@@ -1,4 +1,4 @@
-import { BasicResponse, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording } from "../types/session";
+import { BasicResponse, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording } from "../types/session";
 import { BaseService } from "./base";
 export declare class SessionsService extends BaseService {
     /**
@@ -31,6 +31,11 @@ export declare class SessionsService extends BaseService {
      * @param id The ID of the session to get the recording URL from
      */
     getRecordingURL(id: string): Promise<GetSessionRecordingUrlResponse>;
+    /**
+     * Get the video recording URL of a session
+     * @param id The ID of the session to get the video recording URL from
+     */
+    getVideoRecordingURL(id: string): Promise<GetSessionVideoRecordingUrlResponse>;
     /**
      * Get the downloads URL of a session
      * @param id The ID of the session to get the downloads URL from

package/dist/services/sessions.js

@@ -103,6 +103,21 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to get recording url for session ${id}`, undefined);
         }
     }
+    /**
+     * Get the video recording URL of a session
+     * @param id The ID of the session to get the video recording URL from
+     */
+    async getVideoRecordingURL(id) {
+        try {
+            return await this.request(`/session/${id}/video-recording-url`);
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to get video recording url for session ${id}`, undefined);
+        }
+    }
     /**
      * Get the downloads URL of a session
      * @param id The ID of the session to get the downloads URL from

package/dist/types/agents/browser-use.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { BrowserUseLlm, BrowserUseTaskStatus } from "../constants";
 import { CreateSessionParams } from "../session";
 export interface StartBrowserUseTaskParams {
@@ -15,6 +16,9 @@ export interface StartBrowserUseTaskParams {
     maxSteps?: number;
     maxFailures?: number;
     initialActions?: Array<Record<string, Record<string, any>>>;
+    sensitiveData?: Record<string, string>;
+    messageContext?: string;
+    outputModelSchema?: z.ZodSchema | object;
     keepBrowserOpen?: boolean;
     sessionOptions?: CreateSessionParams;
 }

package/dist/types/agents/hyper-agent.d.ts

@@ -0,0 +1,46 @@
+import { HyperAgentLlm, HyperAgentTaskStatus } from "../constants";
+import { CreateSessionParams } from "../session";
+export interface StartHyperAgentTaskParams {
+    task: string;
+    llm?: HyperAgentLlm;
+    sessionId?: string;
+    maxSteps?: number;
+    keepBrowserOpen?: boolean;
+    sessionOptions?: CreateSessionParams;
+}
+export interface StartHyperAgentTaskResponse {
+    jobId: string;
+    liveUrl: string | null;
+}
+export interface HyperAgentTaskStatusResponse {
+    status: HyperAgentTaskStatus;
+}
+export interface HyperAgentActionOutput {
+    success: boolean;
+    message: string;
+    extract?: object;
+}
+export interface HyperAgentOutput {
+    thoughts: string;
+    memory: string;
+    nextGoal: string;
+    actions: {
+        [x: string]: any;
+    }[];
+}
+export interface HyperAgentStep {
+    idx: number;
+    agentOutput: HyperAgentOutput;
+    actionOutputs: HyperAgentActionOutput[];
+}
+export interface HyperAgentTaskData {
+    steps: HyperAgentStep[];
+    finalResult: string | null;
+}
+export interface HyperAgentTaskResponse {
+    jobId: string;
+    status: HyperAgentTaskStatus;
+    data?: HyperAgentTaskData | null;
+    error?: string | null;
+    liveUrl: string | null;
+}

package/dist/types/agents/hyper-agent.js

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

package/dist/types/constants.d.ts

@@ -4,6 +4,7 @@ export type ExtractJobStatus = "pending" | "running" | "completed" | "failed";
 export type CrawlJobStatus = "pending" | "running" | "completed" | "failed";
 export type BrowserUseTaskStatus = "pending" | "running" | "completed" | "failed" | "stopped";
 export type CuaTaskStatus = "pending" | "running" | "completed" | "failed" | "stopped";
+export type HyperAgentTaskStatus = "pending" | "running" | "completed" | "failed" | "stopped";
 export type ClaudeComputerUseTaskStatus = "pending" | "running" | "completed" | "failed" | "stopped";
 export type ScrapePageStatus = "completed" | "failed" | "pending" | "running";
 export type CrawlPageStatus = "completed" | "failed";
@@ -13,6 +14,7 @@ export type RecordingStatus = "not_enabled" | "pending" | "in_progress" | "compl
 export type DownloadsStatus = "not_enabled" | "pending" | "in_progress" | "completed" | "failed";
 export declare const POLLING_ATTEMPTS = 5;
 export type BrowserUseLlm = "gpt-4o" | "gpt-4o-mini" | "claude-3-7-sonnet-20250219" | "claude-3-5-sonnet-20241022" | "claude-3-5-haiku-20241022" | "gemini-2.0-flash";
+export type HyperAgentLlm = "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano";
 export type Country = "AD" | "AE" | "AF" | "AL" | "AM" | "AO" | "AR" | "AT" | "AU" | "AW" | "AZ" | "BA" | "BD" | "BE" | "BG" | "BH" | "BJ" | "BO" | "BR" | "BS" | "BT" | "BY" | "BZ" | "CA" | "CF" | "CH" | "CI" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "EC" | "EE" | "EG" | "ES" | "ET" | "EU" | "FI" | "FJ" | "FR" | "GB" | "GE" | "GH" | "GM" | "GR" | "HK" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IN" | "IQ" | "IR" | "IS" | "IT" | "JM" | "JO" | "JP" | "KE" | "KH" | "KR" | "KW" | "KZ" | "LB" | "LI" | "LR" | "LT" | "LU" | "LV" | "MA" | "MC" | "MD" | "ME" | "MG" | "MK" | "ML" | "MM" | "MN" | "MR" | "MT" | "MU" | "MV" | "MX" | "MY" | "MZ" | "NG" | "NL" | "NO" | "NZ" | "OM" | "PA" | "PE" | "PH" | "PK" | "PL" | "PR" | "PT" | "PY" | "QA" | "RANDOM_COUNTRY" | "RO" | "RS" | "RU" | "SA" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SN" | "SS" | "TD" | "TG" | "TH" | "TM" | "TN" | "TR" | "TT" | "TW" | "UA" | "UG" | "US" | "UY" | "UZ" | "VE" | "VG" | "VN" | "YE" | "ZA" | "ZM" | "ZW" | "ad" | "ae" | "af" | "al" | "am" | "ao" | "ar" | "at" | "au" | "aw" | "az" | "ba" | "bd" | "be" | "bg" | "bh" | "bj" | "bo" | "br" | "bs" | "bt" | "by" | "bz" | "ca" | "cf" | "ch" | "ci" | "cl" | "cm" | "cn" | "co" | "cr" | "cu" | "cy" | "cz" | "de" | "dj" | "dk" | "dm" | "ec" | "ee" | "eg" | "es" | "et" | "eu" | "fi" | "fj" | "fr" | "gb" | "ge" | "gh" | "gm" | "gr" | "hk" | "hn" | "hr" | "ht" | "hu" | "id" | "ie" | "il" | "in" | "iq" | "ir" | "is" | "it" | "jm" | "jo" | "jp" | "ke" | "kh" | "kr" | "kw" | "kz" | "lb" | "li" | "lr" | "lt" | "lu" | "lv" | "ma" | "mc" | "md" | "me" | "mg" | "mk" | "ml" | "mm" | "mn" | "mr" | "mt" | "mu" | "mv" | "mx" | "my" | "mz" | "ng" | "nl" | "no" | "nz" | "om" | "pa" | "pe" | "ph" | "pk" | "pl" | "pr" | "pt" | "py" | "qa" | "ro" | "rs" | "ru" | "sa" | "sc" | "sd" | "se" | "sg" | "si" | "sk" | "sn" | "ss" | "td" | "tg" | "th" | "tm" | "tn" | "tr" | "tt" | "tw" | "ua" | "ug" | "us" | "uy" | "uz" | "ve" | "vg" | "vn" | "ye" | "za" | "zm" | "zw";
 export type OperatingSystem = "windows" | "android" | "macos" | "linux" | "ios";
 export type Platform = "chrome" | "firefox" | "safari" | "edge";

package/dist/types/index.d.ts

@@ -5,7 +5,8 @@ export { StartExtractJobParams, StartExtractJobResponse, ExtractJobResponse, Ext
 export { StartBrowserUseTaskParams, StartBrowserUseTaskResponse, BrowserUseTaskStatusResponse, BrowserUseTaskResponse, BrowserUseTaskData, } from "./agents/browser-use";
 export { StartClaudeComputerUseTaskParams, StartClaudeComputerUseTaskResponse, ClaudeComputerUseTaskStatusResponse, ClaudeComputerUseTaskResponse, ClaudeComputerUseTaskData, ClaudeComputerUseStepResponse, } from "./agents/claude-computer-use";
 export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTaskResponse, CuaTaskData, CuaStepResponse, } from "./agents/cua";
-export { BasicResponse, SessionStatus, Session, SessionDetail, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, } from "./session";
+export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskStatusResponse, HyperAgentTaskResponse, HyperAgentTaskData, HyperAgentStep, HyperAgentOutput, HyperAgentActionOutput, } from "./agents/hyper-agent";
+export { BasicResponse, SessionStatus, Session, SessionDetail, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, } from "./session";
 export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
-export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, } from "./constants";
+export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, } from "./constants";

package/dist/types/session.d.ts

@@ -60,6 +60,7 @@ export interface CreateSessionParams {
     trackers?: boolean;
     annoyances?: boolean;
     enableWebRecording?: boolean;
+    enableVideoWebRecording?: boolean;
     profile?: CreateSessionProfile;
     extensionIds?: Array<string>;
     staticIpId?: string;
@@ -81,6 +82,11 @@ export interface GetSessionRecordingUrlResponse {
     recordingUrl?: string | null;
     error?: string | null;
 }
+export interface GetSessionVideoRecordingUrlResponse {
+    status: RecordingStatus;
+    recordingUrl?: string | null;
+    error?: string | null;
+}
 export interface GetSessionDownloadsUrlResponse {
     status: DownloadsStatus;
     downloadsUrl?: string | null;

package/dist/utils.d.ts

@@ -1 +1,3 @@
+import { z } from "zod";
 export declare const sleep: (ms: number) => Promise<unknown>;
+export declare const isZodSchema: (schema: z.ZodSchema | object) => schema is z.ZodType;

package/dist/utils.js

@@ -1,5 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sleep = void 0;
+exports.isZodSchema = exports.sleep = void 0;
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 exports.sleep = sleep;
+const isZodSchema = (schema) => {
+    return (schema &&
+        typeof schema === "object" &&
+        "_def" in schema &&
+        "parse" in schema &&
+        typeof schema.parse === "function");
+};
+exports.isZodSchema = isZodSchema;

package/package.json

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