@hyperbrowser/sdk 0.69.0 → 0.71.0

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { BrowserUseLlm, BrowserUseTaskStatus } from "../constants";
+import { BrowserUseLlm, BrowserUseTaskStatus, BrowserUseVersion } from "../constants";
 import { CreateSessionParams } from "../session";
 export interface BrowserUseApiKeys {
     openai?: string;
@@ -8,6 +8,7 @@ export interface BrowserUseApiKeys {
 }
 export interface StartBrowserUseTaskParams {
     task: string;
+    version?: BrowserUseVersion;
     llm?: BrowserUseLlm;
     sessionId?: string;
     validateOutput?: boolean;
@@ -76,13 +77,56 @@ export interface BrowserUseAgentHistory {
     state: BrowserUseBrowserStateHistory;
     metadata?: BrowserUseStepMetadata | null;
 }
+export interface BrowserUseAgentOutputV0710 {
+    thinking?: string | null;
+    evaluation_previous_goal?: string | null;
+    memory?: string | null;
+    next_goal?: string | null;
+    action: Array<Record<string, unknown>>;
+}
+export interface BrowserUseActionResultV0710 {
+    is_done?: boolean | null;
+    success?: boolean | null;
+    error?: string | null;
+    metadata?: Record<string, unknown> | null;
+    attachments?: string[] | null;
+    long_term_memory?: string | null;
+    extracted_content?: string | null;
+    include_extracted_content_only_once?: boolean | null;
+    include_in_memory?: boolean | null;
+}
+export interface BrowserUseBrowserStateHistoryV0710 {
+    url: string;
+    title: string;
+    tabs: Array<Record<string, unknown>>;
+    interacted_element: Array<Record<string, unknown> | null>;
+}
+export interface BrowserUseStepMetadataV0710 {
+    step_start_time: number;
+    step_end_time: number;
+    step_number: number;
+}
+export interface BrowserUseAgentHistoryV0710 {
+    model_output: BrowserUseAgentOutputV0710 | null;
+    result: BrowserUseActionResultV0710[];
+    state: BrowserUseBrowserStateHistoryV0710;
+    metadata?: BrowserUseStepMetadataV0710 | null;
+}
+export type BrowserUseAgentHistoryLatest = Record<string, unknown>;
+export type BrowserUseStep = BrowserUseAgentHistory | BrowserUseAgentHistoryV0710 | BrowserUseAgentHistoryLatest;
 export interface BrowserUseTaskData {
-    steps: BrowserUseAgentHistory[];
+    steps: BrowserUseStep[];
     finalResult: string | null;
 }
+export interface BrowserUseTaskMetadata {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    numTaskStepsCompleted?: number | null;
+}
 export interface BrowserUseTaskResponse {
     jobId: string;
     status: BrowserUseTaskStatus;
+    metadata?: BrowserUseTaskMetadata | null;
     data?: BrowserUseTaskData | null;
     error?: string | null;
     liveUrl: string | null;

package/dist/types/agents/claude-computer-use.d.ts

@@ -34,9 +34,15 @@ export interface ClaudeComputerUseTaskData {
     steps: ClaudeComputerUseStepResponse[];
     finalResult: string | null;
 }
+export interface ClaudeComputerUseTaskMetadata {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    numTaskStepsCompleted?: number | null;
+}
 export interface ClaudeComputerUseTaskResponse {
     jobId: string;
     status: ClaudeComputerUseTaskStatus;
+    metadata?: ClaudeComputerUseTaskMetadata | null;
     data?: ClaudeComputerUseTaskData | null;
     error?: string | null;
     liveUrl: string | null;

package/dist/types/agents/cua.d.ts

@@ -46,9 +46,15 @@ export interface CuaTaskData {
     steps: CuaStepResponse[];
     finalResult: string | null;
 }
+export interface CuaTaskMetadata {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    numTaskStepsCompleted?: number | null;
+}
 export interface CuaTaskResponse {
     jobId: string;
     status: CuaTaskStatus;
+    metadata?: CuaTaskMetadata | null;
     data?: CuaTaskData | null;
     error?: string | null;
     liveUrl: string | null;

package/dist/types/agents/gemini-computer-use.d.ts

@@ -30,9 +30,15 @@ export interface GeminiComputerUseTaskData {
     steps: GeminiComputerUseStepResponse[];
     finalResult: string | null;
 }
+export interface GeminiComputerUseTaskMetadata {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    numTaskStepsCompleted?: number | null;
+}
 export interface GeminiComputerUseTaskResponse {
     jobId: string;
     status: GeminiComputerUseTaskStatus;
+    metadata?: GeminiComputerUseTaskMetadata | null;
     data?: GeminiComputerUseTaskData | null;
     error?: string | null;
     liveUrl: string | null;

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

@@ -44,9 +44,13 @@ export interface HyperAgentTaskData {
     steps: HyperAgentStep[];
     finalResult: string | null;
 }
+export interface HyperAgentTaskMetadata {
+    numTaskStepsCompleted?: number | null;
+}
 export interface HyperAgentTaskResponse {
     jobId: string;
     status: HyperAgentTaskStatus;
+    metadata?: HyperAgentTaskMetadata | null;
     data?: HyperAgentTaskData | null;
     error?: string | null;
     liveUrl: string | null;

package/dist/types/constants.d.ts

@@ -15,6 +15,7 @@ export type ScrapeScreenshotFormat = "jpeg" | "png" | "webp";
 export type RecordingStatus = "not_enabled" | "pending" | "in_progress" | "completed" | "failed";
 export type DownloadsStatus = "not_enabled" | "pending" | "in_progress" | "completed" | "failed";
 export declare const POLLING_ATTEMPTS = 5;
+export type BrowserUseVersion = "0.1.40" | "0.7.10" | "latest";
 export type BrowserUseLlm = "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-5" | "gpt-5-mini" | "claude-sonnet-4-5" | "claude-sonnet-4-20250514" | "claude-3-7-sonnet-20250219" | "claude-3-5-sonnet-20241022" | "claude-3-5-haiku-20241022" | "gemini-2.0-flash" | "gemini-2.5-flash";
 export type ClaudeComputerUseLlm = "claude-haiku-4-5-20251001" | "claude-sonnet-4-5" | "claude-sonnet-4-20250514" | "claude-3-7-sonnet-20250219";
 export type HyperAgentLlm = "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano";

package/dist/types/extract.d.ts

@@ -16,9 +16,15 @@ export interface StartExtractJobResponse {
 export interface ExtractJobStatusResponse {
     status: ExtractJobStatus;
 }
+export interface ExtractJobMetadata {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    numPagesScraped?: number | null;
+}
 export interface ExtractJobResponse {
     jobId: string;
     status: ExtractJobStatus;
+    metadata?: ExtractJobMetadata | null;
     data?: object;
     error?: string;
 }

package/dist/types/index.d.ts

@@ -1,15 +1,15 @@
 export { HyperbrowserConfig } from "./config";
 export { StartCrawlJobParams, StartCrawlJobResponse, CrawledPage, CrawlJobResponse, GetCrawlJobParams, CrawlJobStatusResponse, } from "./crawl";
-export { StartScrapeJobParams, StartScrapeJobResponse, ScrapeJobData, ScrapeJobResponse, ScrapeOptions, ScrapeJobStatusResponse, BatchScrapeJobStatusResponse, } from "./scrape";
-export { StartExtractJobParams, StartExtractJobResponse, ExtractJobResponse, ExtractJobStatusResponse, } from "./extract";
-export { StartBrowserUseTaskParams, StartBrowserUseTaskResponse, BrowserUseTaskStatusResponse, BrowserUseTaskResponse, BrowserUseTaskData, BrowserUseApiKeys, } from "./agents/browser-use";
-export { StartClaudeComputerUseTaskParams, StartClaudeComputerUseTaskResponse, ClaudeComputerUseTaskStatusResponse, ClaudeComputerUseTaskResponse, ClaudeComputerUseTaskData, ClaudeComputerUseStepResponse, ClaudeComputerUseApiKeys, } from "./agents/claude-computer-use";
-export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTaskResponse, CuaTaskData, CuaStepResponse, CuaApiKeys, } from "./agents/cua";
-export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskStatusResponse, HyperAgentTaskResponse, HyperAgentTaskData, HyperAgentStep, HyperAgentOutput, HyperAgentActionOutput, HyperAgentApiKeys, } from "./agents/hyper-agent";
-export { StartGeminiComputerUseTaskParams, StartGeminiComputerUseTaskResponse, GeminiComputerUseTaskStatusResponse, GeminiComputerUseTaskResponse, GeminiComputerUseTaskData, GeminiComputerUseStepResponse, GeminiComputerUseApiKeys, } from "./agents/gemini-computer-use";
+export { StartScrapeJobParams, StartScrapeJobResponse, ScrapeJobData, ScrapeJobResponse, ScrapeOptions, ScrapeJobStatusResponse, BatchScrapeJobStatusResponse, 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";
+export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTaskResponse, CuaTaskData, CuaStepResponse, CuaApiKeys, CuaTaskMetadata, } from "./agents/cua";
+export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskStatusResponse, HyperAgentTaskResponse, HyperAgentTaskData, HyperAgentStep, HyperAgentOutput, HyperAgentActionOutput, HyperAgentApiKeys, HyperAgentTaskMetadata, } from "./agents/hyper-agent";
+export { StartGeminiComputerUseTaskParams, StartGeminiComputerUseTaskResponse, GeminiComputerUseTaskStatusResponse, GeminiComputerUseTaskResponse, GeminiComputerUseTaskData, GeminiComputerUseStepResponse, GeminiComputerUseApiKeys, GeminiComputerUseTaskMetadata, } from "./agents/gemini-computer-use";
 export { BasicResponse, SessionStatus, Session, SessionDetail, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, } from "./session";
 export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
-export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, GeminiComputerUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, GeminiComputerUseTaskStatus, SessionEventLogType, SessionRegion, } from "./constants";
+export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, GeminiComputerUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, GeminiComputerUseTaskStatus, SessionEventLogType, SessionRegion, BrowserUseVersion, } from "./constants";
 export { TeamCreditInfo } from "./team";
 export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, ComputerActionMouseButton, ComputerActionResponseData, HoldKeyActionParams, MouseDownActionParams, MouseUpActionParams, GetClipboardTextActionParams, ComputerActionResponseDataClipboardText, } from "./computer-action";

package/dist/types/scrape.d.ts

@@ -4,6 +4,10 @@ export interface ScreenshotOptions {
     fullPage?: boolean;
     format?: ScrapeScreenshotFormat;
 }
+export interface StorageStateOptions {
+    localStorage?: Record<string, string>;
+    sessionStorage?: Record<string, string>;
+}
 export interface ScrapeOptions {
     formats?: ScrapeFormat[];
     includeTags?: string[];
@@ -13,6 +17,7 @@ export interface ScrapeOptions {
     timeout?: number;
     waitUntil?: ScrapeWaitUntil;
     screenshotOptions?: ScreenshotOptions;
+    storageState?: StorageStateOptions;
 }
 export interface StartScrapeJobParams {
     url: string;

package/dist/types/session.d.ts

@@ -40,6 +40,7 @@ export interface Session {
     updatedAt: string;
     sessionUrl: string;
     launchState?: SessionLaunchState | null;
+    creditsUsed: number | null;
 }
 export interface SessionDetail extends Session {
     wsEndpoint: string;

package/package.json

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