browser-use-sdk 2.0.4 → 2.0.5

package/dist/cjs/api/types/SessionItemView.d.ts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.js";
+import type * as BrowserUse from "../index.js";
 /**
  * View model for representing a (browser) session.
  */
@@ -11,9 +8,9 @@ export interface SessionItemView {
     /** 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;
 }

package/dist/cjs/api/types/SessionItemView.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionListResponse.d.ts

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

package/dist/cjs/api/types/SessionListResponse.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionNotFoundError.d.ts

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

package/dist/cjs/api/types/SessionNotFoundError.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionStatus.d.ts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 /**
  * Enumeration of possible (browser) session states
  *
@@ -8,8 +5,8 @@
  *     ACTIVE: Session is currently active and running (browser is running)
  *     STOPPED: Session has been stopped and is no longer active (browser is stopped)
  */
-export type SessionStatus = "active" | "stopped";
 export declare const SessionStatus: {
     readonly Active: "active";
     readonly Stopped: "stopped";
 };
+export type SessionStatus = (typeof SessionStatus)[keyof typeof SessionStatus];

package/dist/cjs/api/types/SessionStatus.js

@@ -1,9 +1,14 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionStatus = void 0;
+/**
+ * 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)
+ */
 exports.SessionStatus = {
     Active: "active",
     Stopped: "stopped",

package/dist/cjs/api/types/SessionStoppedError.d.ts

@@ -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/cjs/api/types/SessionStoppedError.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionTimeoutLimitExceededError.d.ts

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

package/dist/cjs/api/types/SessionTimeoutLimitExceededError.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionUpdateAction.d.ts

@@ -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/cjs/api/types/SessionUpdateAction.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionView.d.ts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.js";
+import type * as BrowserUse from "../index.js";
 /**
  * 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/cjs/api/types/SessionView.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ShareNotFoundError.d.ts

@@ -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/cjs/api/types/ShareNotFoundError.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ShareView.d.ts

@@ -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/cjs/api/types/ShareView.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SupportedLlMs.d.ts

@@ -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/cjs/api/types/SupportedLlMs.js

@@ -1,17 +1,19 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SupportedLlMs = void 0;
 exports.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/cjs/api/types/TaskCreatedResponse.d.ts

@@ -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/cjs/api/types/TaskCreatedResponse.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TaskItemView.d.ts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.js";
+import type * as BrowserUse from "../index.js";
 /**
  * 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/cjs/api/types/TaskItemView.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TaskListResponse.d.ts

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

package/dist/cjs/api/types/TaskListResponse.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TaskLogFileResponse.d.ts

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

package/dist/cjs/api/types/TaskLogFileResponse.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TaskNotFoundError.d.ts

@@ -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/cjs/api/types/TaskNotFoundError.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TaskOutputFileResponse.d.ts

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

package/dist/cjs/api/types/TaskOutputFileResponse.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TaskStatus.d.ts

@@ -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/cjs/api/types/TaskStatus.js

@@ -1,12 +1,19 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskStatus = void 0;
+/**
+ * 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).
+ */
 exports.TaskStatus = {
+    Created: "created",
     Started: "started",
-    Paused: "paused",
     Finished: "finished",
     Stopped: "stopped",
 };

package/dist/cjs/api/types/TaskStepView.d.ts

@@ -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/cjs/api/types/TaskStepView.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TaskUpdateAction.d.ts

@@ -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/cjs/api/types/TaskUpdateAction.js

@@ -1,12 +1,15 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskUpdateAction = void 0;
+/**
+ * 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
+ */
 exports.TaskUpdateAction = {
     Stop: "stop",
-    Pause: "pause",
-    Resume: "resume",
     StopTaskAndSession: "stop_task_and_session",
 };

package/dist/cjs/api/types/TaskView.d.ts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as BrowserUse from "../index.js";
+import type * as BrowserUse from "../index.js";
 /**
  * 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/cjs/api/types/TaskView.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/TooManyConcurrentActiveSessionsError.d.ts

@@ -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/cjs/api/types/TooManyConcurrentActiveSessionsError.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/UnsupportedContentTypeError.d.ts

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

package/dist/cjs/api/types/UnsupportedContentTypeError.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/UploadFilePresignedUrlResponse.d.ts

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

package/dist/cjs/api/types/UploadFilePresignedUrlResponse.js

@@ -1,5 +1,3 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/{resources/files/client/requests → types}/UploadFileRequest.d.ts

@@ -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];
 }