browser-use-sdk 2.0.4 → 2.0.5

package/dist/esm/api/types/SessionStatus.mjs

@@ -1,5 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
 /**
- * This file was auto-generated by Fern from our API Definition.
+ * Enumeration of possible (browser) session states
+ *
+ * Attributes:
+ *     ACTIVE: Session is currently active and running (browser is running)
+ *     STOPPED: Session has been stopped and is no longer active (browser is stopped)
  */
 export const SessionStatus = {
     Active: "active",

package/dist/esm/api/types/SessionStoppedError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Error response when trying to use a stopped session
  */

package/dist/esm/api/types/SessionStoppedError.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/SessionTimeoutLimitExceededError.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Error response when free user tries to create session longer than allowed
+ */
+export interface SessionTimeoutLimitExceededError {
+    detail?: string;
+}

package/dist/esm/api/types/SessionTimeoutLimitExceededError.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SessionUpdateAction.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Available actions that can be performed on a session
  *

package/dist/esm/api/types/SessionUpdateAction.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/SessionView.d.mts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.mjs";
+import type * as BrowserUse from "../index.mjs";
 /**
  * View model for representing a (browser) session with its associated tasks.
  */
@@ -11,13 +8,13 @@ export interface SessionView {
     /** Current status of the session (active/stopped) */
     status: BrowserUse.SessionStatus;
     /** URL where the browser can be viewed live in real-time */
-    liveUrl?: string;
+    liveUrl?: string | null;
     /** Timestamp when the session was created and started */
     startedAt: string;
     /** Timestamp when the session was stopped (None if still active) */
-    finishedAt?: string;
+    finishedAt?: string | null;
     /** List of tasks associated with this session */
     tasks: BrowserUse.TaskItemView[];
     /** Optional URL to access the public share of the session */
-    publicShareUrl?: string;
+    publicShareUrl?: string | null;
 }

package/dist/esm/api/types/SessionView.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/ShareNotFoundError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Error response when a public share is not found
  */

package/dist/esm/api/types/ShareNotFoundError.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/ShareView.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * View model for representing a public share of a session.
  */
@@ -12,5 +9,5 @@ export interface ShareView {
     /** Number of times the public share has been viewed */
     viewCount: number;
     /** Timestamp of the last time the public share was viewed (None if never viewed) */
-    lastViewedAt?: string;
+    lastViewedAt?: string | null;
 }

package/dist/esm/api/types/ShareView.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/SupportedLlMs.d.mts

@@ -1,17 +1,18 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-export type SupportedLlMs = "gpt-4.1" | "gpt-4.1-mini" | "o4-mini" | "o3" | "gemini-2.5-flash" | "gemini-2.5-pro" | "claude-sonnet-4-20250514" | "gpt-4o" | "gpt-4o-mini" | "llama-4-maverick-17b-128e-instruct" | "claude-3-7-sonnet-20250219";
 export declare const SupportedLlMs: {
+    readonly BrowserUseLlm: "browser-use-llm";
     readonly Gpt41: "gpt-4.1";
     readonly Gpt41Mini: "gpt-4.1-mini";
     readonly O4Mini: "o4-mini";
     readonly O3: "o3";
     readonly Gemini25Flash: "gemini-2.5-flash";
     readonly Gemini25Pro: "gemini-2.5-pro";
+    readonly GeminiFlashLatest: "gemini-flash-latest";
+    readonly GeminiFlashLiteLatest: "gemini-flash-lite-latest";
     readonly ClaudeSonnet420250514: "claude-sonnet-4-20250514";
+    readonly ClaudeSonnet4520250929: "claude-sonnet-4-5-20250929";
     readonly Gpt4O: "gpt-4o";
     readonly Gpt4OMini: "gpt-4o-mini";
     readonly Llama4Maverick17B128EInstruct: "llama-4-maverick-17b-128e-instruct";
     readonly Claude37Sonnet20250219: "claude-3-7-sonnet-20250219";
 };
+export type SupportedLlMs = (typeof SupportedLlMs)[keyof typeof SupportedLlMs];

package/dist/esm/api/types/SupportedLlMs.mjs

@@ -1,14 +1,16 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export const SupportedLlMs = {
+    BrowserUseLlm: "browser-use-llm",
     Gpt41: "gpt-4.1",
     Gpt41Mini: "gpt-4.1-mini",
     O4Mini: "o4-mini",
     O3: "o3",
     Gemini25Flash: "gemini-2.5-flash",
     Gemini25Pro: "gemini-2.5-pro",
+    GeminiFlashLatest: "gemini-flash-latest",
+    GeminiFlashLiteLatest: "gemini-flash-lite-latest",
     ClaudeSonnet420250514: "claude-sonnet-4-20250514",
+    ClaudeSonnet4520250929: "claude-sonnet-4-5-20250929",
     Gpt4O: "gpt-4o",
     Gpt4OMini: "gpt-4o-mini",
     Llama4Maverick17B128EInstruct: "llama-4-maverick-17b-128e-instruct",

package/dist/esm/api/types/TaskCreatedResponse.d.mts

@@ -1,10 +1,9 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Response model for creating a task
  */
 export interface TaskCreatedResponse {
     /** Unique identifier for the created task */
     id: string;
+    /** Session ID where the task was created */
+    sessionId: string;
 }

package/dist/esm/api/types/TaskCreatedResponse.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TaskItemView.d.mts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.mjs";
+import type * as BrowserUse from "../index.mjs";
 /**
  * View model for representing a task with its execution details
  */
@@ -15,16 +12,18 @@ export interface TaskItemView {
     /** The task prompt/instruction given to the agent */
     task: string;
     status: BrowserUse.TaskStatus;
-    /** Naive UTC timestamp when the task was started */
-    startedAt: string;
+    /** Naive UTC timestamp when the task was created */
+    createdAt: string;
+    /** Naive UTC timestamp when the task was started (None if task has not started yet) */
+    startedAt?: string | null;
     /** Naive UTC timestamp when the task completed (None if still running) */
-    finishedAt?: string;
+    finishedAt?: string | null;
     /** Optional additional metadata associated with the task set by the user */
     metadata?: Record<string, unknown>;
     /** Final output/result of the task */
-    output?: string;
+    output?: string | null;
     /** Version of browser-use used for this task (older tasks may not have this set) */
-    browserUseVersion?: string;
+    browserUseVersion?: string | null;
     /** Whether the task was successful (self-reported by the agent) */
-    isSuccess?: boolean;
+    isSuccess?: boolean | null;
 }

package/dist/esm/api/types/TaskItemView.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TaskListResponse.d.mts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.mjs";
+import type * as BrowserUse from "../index.mjs";
 /**
  * Response model for paginated task list requests.
  */

package/dist/esm/api/types/TaskListResponse.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TaskLogFileResponse.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Response model for log file requests
  */

package/dist/esm/api/types/TaskLogFileResponse.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TaskNotFoundError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Error response when a task is not found
  */

package/dist/esm/api/types/TaskNotFoundError.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TaskOutputFileResponse.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Response model for output file requests.
  */

package/dist/esm/api/types/TaskOutputFileResponse.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TaskStatus.d.mts

@@ -1,19 +1,16 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Enumeration of possible task execution states
  *
  * Attributes:
+ *         CREATED: Task has been created but not yet started.
  *     STARTED: Task has been started and is currently running.
- *     PAUSED: Task execution has been temporarily paused (can be resumed)
  *     FINISHED: Task has finished and the agent has completed the task.
  *     STOPPED: Task execution has been manually stopped (cannot be resumed).
  */
-export type TaskStatus = "started" | "paused" | "finished" | "stopped";
 export declare const TaskStatus: {
+    readonly Created: "created";
     readonly Started: "started";
-    readonly Paused: "paused";
     readonly Finished: "finished";
     readonly Stopped: "stopped";
 };
+export type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];

package/dist/esm/api/types/TaskStatus.mjs

@@ -1,9 +1,16 @@
+// This file was auto-generated by Fern from our API Definition.
 /**
- * This file was auto-generated by Fern from our API Definition.
+ * Enumeration of possible task execution states
+ *
+ * Attributes:
+ *         CREATED: Task has been created but not yet started.
+ *     STARTED: Task has been started and is currently running.
+ *     FINISHED: Task has finished and the agent has completed the task.
+ *     STOPPED: Task execution has been manually stopped (cannot be resumed).
  */
 export const TaskStatus = {
+    Created: "created",
     Started: "started",
-    Paused: "paused",
     Finished: "finished",
     Stopped: "stopped",
 };

package/dist/esm/api/types/TaskStepView.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * View model for representing a single step in a task's execution
  */
@@ -16,7 +13,7 @@ export interface TaskStepView {
     /** Current URL the browser is on for this step */
     url: string;
     /** Optional URL to the screenshot taken at this step */
-    screenshotUrl?: string;
+    screenshotUrl?: string | null;
     /** List of stringified json actions performed by the agent in this step */
     actions: string[];
 }

package/dist/esm/api/types/TaskStepView.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TaskUpdateAction.d.mts

@@ -1,19 +1,12 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Available actions that can be performed on a task
  *
  * Attributes:
  *     STOP: Stop the current task execution
- *     PAUSE: Pause the current task execution
- *     RESUME: Resume a paused task execution
  *     STOP_TASK_AND_SESSION: Stop both the task and its parent session
  */
-export type TaskUpdateAction = "stop" | "pause" | "resume" | "stop_task_and_session";
 export declare const TaskUpdateAction: {
     readonly Stop: "stop";
-    readonly Pause: "pause";
-    readonly Resume: "resume";
     readonly StopTaskAndSession: "stop_task_and_session";
 };
+export type TaskUpdateAction = (typeof TaskUpdateAction)[keyof typeof TaskUpdateAction];

package/dist/esm/api/types/TaskUpdateAction.mjs

@@ -1,9 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
 /**
- * This file was auto-generated by Fern from our API Definition.
+ * Available actions that can be performed on a task
+ *
+ * Attributes:
+ *     STOP: Stop the current task execution
+ *     STOP_TASK_AND_SESSION: Stop both the task and its parent session
  */
 export const TaskUpdateAction = {
     Stop: "stop",
-    Pause: "pause",
-    Resume: "resume",
     StopTaskAndSession: "stop_task_and_session",
 };

package/dist/esm/api/types/TaskView.d.mts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.mjs";
+import type * as BrowserUse from "../index.mjs";
 /**
  * View model for representing a task with its execution details
  */
@@ -15,18 +12,20 @@ export interface TaskView {
     task: string;
     /** Current status of the task execution */
     status: BrowserUse.TaskStatus;
-    /** Naive UTC timestamp when the task was started */
-    startedAt: string;
+    /** Naive UTC timestamp when the task was created */
+    createdAt: string;
+    /** Naive UTC timestamp when the task was started (None if task has not started yet) */
+    startedAt?: string | null;
     /** Naive UTC timestamp when the task completed (None if still running) */
-    finishedAt?: string;
+    finishedAt?: string | null;
     /** Optional additional metadata associated with the task set by the user */
     metadata?: Record<string, unknown>;
     steps: BrowserUse.TaskStepView[];
     /** Final output/result of the task */
-    output?: string;
+    output?: string | null;
     outputFiles: BrowserUse.FileView[];
     /** Version of browser-use used for this task (older tasks may not have this set) */
-    browserUseVersion?: string;
+    browserUseVersion?: string | null;
     /** Whether the task was successful (self-reported by the agent) */
-    isSuccess?: boolean;
+    isSuccess?: boolean | null;
 }

package/dist/esm/api/types/TaskView.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/TooManyConcurrentActiveSessionsError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Error response when user has too many concurrent active sessions
  */

package/dist/esm/api/types/TooManyConcurrentActiveSessionsError.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/UnsupportedContentTypeError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Error response for unsupported content types
  */

package/dist/esm/api/types/UnsupportedContentTypeError.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/UploadFilePresignedUrlResponse.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Response model for a presigned upload URL.
  */

package/dist/esm/api/types/UploadFilePresignedUrlResponse.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/{resources/files/client/requests → types}/UploadFileRequest.d.mts

@@ -1,13 +1,5 @@
 /**
- * This file was auto-generated by Fern from our API Definition.
- */
-/**
- * @example
- *     {
- *         fileName: "fileName",
- *         contentType: "image/jpg",
- *         sizeBytes: 1
- *     }
+ * Request model for uploading a file to the user's files bucket.
  */
 export interface UploadFileRequest {
     /** The name of the file to upload */
@@ -17,10 +9,7 @@ export interface UploadFileRequest {
     sizeBytes: number;
 }
 export declare namespace UploadFileRequest {
-    /**
-     * The content type of the file to upload
-     */
-    type ContentType = "image/jpg" | "image/jpeg" | "image/png" | "image/gif" | "image/webp" | "image/svg+xml" | "application/pdf" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "text/plain" | "text/csv" | "text/markdown";
+    /** The content type of the file to upload */
     const ContentType: {
         readonly ImageJpg: "image/jpg";
         readonly ImageJpeg: "image/jpeg";
@@ -37,4 +26,5 @@ export declare namespace UploadFileRequest {
         readonly TextCsv: "text/csv";
         readonly TextMarkdown: "text/markdown";
     };
+    type ContentType = (typeof ContentType)[keyof typeof ContentType];
 }

package/dist/esm/api/{resources/files/client/requests → types}/UploadFileRequest.mjs

@@ -1,8 +1,7 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export var UploadFileRequest;
 (function (UploadFileRequest) {
+    /** The content type of the file to upload */
     UploadFileRequest.ContentType = {
         ImageJpg: "image/jpg",
         ImageJpeg: "image/jpeg",

package/dist/esm/api/types/ValidationError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 export interface ValidationError {
     loc: ValidationError.Loc.Item[];
     msg: string;

package/dist/esm/api/types/ValidationError.mjs

@@ -1,4 +1,2 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export {};

package/dist/esm/api/types/WorkflowExecutionCreatedResponse.d.mts

@@ -0,0 +1,12 @@
+import type * as BrowserUse from "../index.mjs";
+/**
+ * Response model for creating a workflow execution (async mode).
+ */
+export interface WorkflowExecutionCreatedResponse {
+    /** Unique identifier for the execution */
+    id: string;
+    /** ID of the workflow being executed */
+    workflowId: string;
+    /** Current status of the execution */
+    status: BrowserUse.WorkflowExecutionStatus;
+}

package/dist/esm/api/types/WorkflowExecutionCreatedResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/WorkflowExecutionItemView.d.mts

@@ -0,0 +1,28 @@
+import type * as BrowserUse from "../index.mjs";
+/**
+ * Minimal view model for listing workflow executions.
+ */
+export interface WorkflowExecutionItemView {
+    /** Unique identifier for the execution */
+    id: string;
+    /** ID of the workflow being executed */
+    workflowId: string;
+    /** Current status of the execution */
+    status: BrowserUse.WorkflowExecutionStatus;
+    /** Naive UTC timestamp when execution started */
+    startedAt?: string | null;
+    /** Naive UTC timestamp when execution finished */
+    finishedAt?: string | null;
+    /** Time taken for execution in seconds */
+    timeTaken?: number | null;
+    /** Total cost for this execution */
+    totalCost?: string;
+    /** Input parameters for the workflow execution */
+    input?: Record<string, unknown> | null;
+    /** Output results from the workflow execution */
+    output?: Record<string, unknown> | null;
+    /** Error information if execution failed */
+    errors?: Record<string, unknown> | null;
+    /** Naive UTC timestamp when execution was created */
+    createdAt: string;
+}

package/dist/esm/api/types/WorkflowExecutionItemView.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/WorkflowExecutionListResponse.d.mts

@@ -0,0 +1,14 @@
+import type * as BrowserUse from "../index.mjs";
+/**
+ * Response model for paginated execution list requests.
+ */
+export interface WorkflowExecutionListResponse {
+    /** List of executions for the current page */
+    items: BrowserUse.WorkflowExecutionItemView[];
+    /** Total number of items in the list */
+    totalItems: number;
+    /** Page number */
+    pageNumber: number;
+    /** Number of items per page */
+    pageSize: number;
+}

package/dist/esm/api/types/WorkflowExecutionListResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/WorkflowExecutionLogResponse.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Response model for execution log file requests.
+ */
+export interface WorkflowExecutionLogResponse {
+    /** Presigned URL to download the execution log file */
+    downloadUrl: string;
+}

package/dist/esm/api/types/WorkflowExecutionLogResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};