browser-use-sdk 0.3.0 → 0.4.0

package/resources/tasks.d.ts

@@ -250,18 +250,18 @@ export type LlmModel = 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | '
  * View model for representing a task with its execution details
  *
  * Attributes: id: Unique identifier for the task session_id: ID of the session
- * this task belongs to session_live_url: Optional live URL of the session llm: The
- * LLM model used for this task task: The task prompt/instruction given to the
- * agent status: Current status of the task execution started_at: Naive UTC
- * timestamp when the task was started finished_at: Naive UTC timestamp when the
- * task completed (None if still running) metadata: Optional additional metadata
- * associated with the task set by the user is_scheduled: Whether this task was
- * created as a scheduled task steps: Optional list of execution steps done_output:
- * Final output/result of the task user_uploaded_files: Optional list of files
- * uploaded by user for this task output_files: Optional list of files generated as
- * output by this task browser_use_version: Version of browser-use used for this
- * task (older tasks may not have this set) is_success: Whether the task was
- * successful (self-reported by the agent)
+ * this task belongs to llm: The LLM model used for this task task: The task
+ * prompt/instruction given to the agent status: Current status of the task
+ * execution started_at: Naive UTC timestamp when the task was started finished_at:
+ * Naive UTC timestamp when the task completed (None if still running) metadata:
+ * Optional additional metadata associated with the task set by the user
+ * is_scheduled: Whether this task was created as a scheduled task steps: Optional
+ * list of execution steps done_output: Final output/result of the task
+ * user_uploaded_files: Optional list of files uploaded by user for this task
+ * output_files: Optional list of files generated as output by this task
+ * browser_use_version: Version of browser-use used for this task (older tasks may
+ * not have this set) is_success: Whether the task was successful (self-reported by
+ * the agent)
  */
 export interface TaskItemView {
     id: string;
@@ -285,10 +285,6 @@ export interface TaskItemView {
     metadata?: {
         [key: string]: unknown;
     };
-    outputFiles?: Array<FileView> | null;
-    sessionLiveUrl?: string | null;
-    steps?: Array<TaskStepView> | null;
-    userUploadedFiles?: Array<FileView> | null;
 }
 /**
  * Enumeration of possible task execution states
@@ -321,11 +317,11 @@ export interface TaskStepView {
  * View model for representing a task with its execution details
  *
  * Attributes: id: Unique identifier for the task session_id: ID of the session
- * this task belongs to session_live_url: Optional live URL of the session llm: The
- * LLM model used for this task task: The task prompt/instruction given to the
- * agent status: Current status of the task execution started_at: Naive UTC
- * timestamp when the task was started finished_at: Naive UTC timestamp when the
- * task completed (None if still running) metadata: Optional additional metadata
+ * this task belongs to session: The session this task belongs to llm: The LLM
+ * model used for this task task: The task prompt/instruction given to the agent
+ * status: Current status of the task execution started_at: Naive UTC timestamp
+ * when the task was started finished_at: Naive UTC timestamp when the task
+ * completed (None if still running) metadata: Optional additional metadata
  * associated with the task set by the user is_scheduled: Whether this task was
  * created as a scheduled task steps: List of execution steps done_output: Final
  * output/result of the task user_uploaded_files: List of files uploaded by user
@@ -339,6 +335,15 @@ export interface TaskView {
     isScheduled: boolean;
     llm: LlmModel;
     outputFiles: Array<FileView>;
+    /**
+     * View model for representing a session that a task belongs to
+     *
+     * Attributes: id: Unique identifier for the session status: Current status of the
+     * session live_url: URL where the browser can be viewed live in real-time.
+     * started_at: Timestamp when the session was created and started. finished_at:
+     * Timestamp when the session was stopped (None if still active).
+     */
+    session: TaskView.Session;
     sessionId: string;
     startedAt: string;
     /**
@@ -359,7 +364,29 @@ export interface TaskView {
     metadata?: {
         [key: string]: unknown;
     };
-    sessionLiveUrl?: string | null;
+}
+export declare namespace TaskView {
+    /**
+     * View model for representing a session that a task belongs to
+     *
+     * Attributes: id: Unique identifier for the session status: Current status of the
+     * session live_url: URL where the browser can be viewed live in real-time.
+     * started_at: Timestamp when the session was created and started. finished_at:
+     * Timestamp when the session was stopped (None if still active).
+     */
+    interface Session {
+        id: string;
+        startedAt: string;
+        /**
+         * 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)
+         */
+        status: 'active' | 'stopped';
+        finishedAt?: string | null;
+        liveUrl?: string | null;
+    }
 }
 /**
  * Response model for creating a task
@@ -393,18 +420,24 @@ export interface TaskGetLogsResponse {
 /**
  * Response model for output file requests
  *
- * Attributes: download_url: URL to download the output file
+ * Attributes: id: Unique identifier for the output file file_name: Name of the
+ * output file download_url: URL to download the output file
  */
 export interface TaskGetOutputFileResponse {
+    id: string;
     downloadUrl: string;
+    fileName: string;
 }
 /**
  * Response model for user uploaded file requests
  *
- * Attributes: download_url: URL to download the user uploaded file
+ * Attributes: id: Unique identifier for the user uploaded file file_name: Name of
+ * the user uploaded file download_url: URL to download the user uploaded file
  */
 export interface TaskGetUserUploadedFileResponse {
+    id: string;
     downloadUrl: string;
+    fileName: string;
 }
 export interface TaskCreateParams {
     task: string;
@@ -475,9 +508,6 @@ export interface TaskListParams {
      * UNSUCCESSFUL: All unsuccessful tasks
      */
     filterBy?: 'started' | 'paused' | 'stopped' | 'finished' | 'successful' | 'unsuccessful' | null;
-    includeOutputFiles?: boolean;
-    includeSteps?: boolean;
-    includeUserUploadedFiles?: boolean;
     pageNumber?: number;
     pageSize?: number;
     sessionId?: string | null;

package/resources/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/resources/tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/resources/tasks.ts"],"names":[],"mappings":"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"}

package/src/client.ts

@@ -55,7 +55,6 @@ import {
 import {
   SessionListParams,
   SessionListResponse,
-  SessionRetrieveParams,
   SessionStatus,
   SessionUpdateParams,
   SessionView,
@@ -765,11 +764,13 @@ export class BrowserUse {
   browserProfiles: API.BrowserProfiles = new API.BrowserProfiles(this);
   agentProfiles: API.AgentProfiles = new API.AgentProfiles(this);
 }
+
 BrowserUse.Users = Users;
 BrowserUse.Tasks = Tasks;
 BrowserUse.Sessions = Sessions;
 BrowserUse.BrowserProfiles = BrowserProfiles;
 BrowserUse.AgentProfiles = AgentProfiles;
+
 export declare namespace BrowserUse {
   export type RequestOptions = Opts.RequestOptions;
 
@@ -800,7 +801,6 @@ export declare namespace BrowserUse {
     type SessionStatus as SessionStatus,
     type SessionView as SessionView,
     type SessionListResponse as SessionListResponse,
-    type SessionRetrieveParams as SessionRetrieveParams,
     type SessionUpdateParams as SessionUpdateParams,
     type SessionListParams as SessionListParams,
   };

package/src/internal/detect-platform.ts

@@ -67,7 +67,7 @@ const getPlatformProperties = (): PlatformProperties => {
       'X-Stainless-Arch': normalizeArch(Deno.build.arch),
       'X-Stainless-Runtime': 'deno',
       'X-Stainless-Runtime-Version':
-        typeof Deno.version === 'string' ? Deno.version : Deno.version?.deno ?? 'unknown',
+        typeof Deno.version === 'string' ? Deno.version : (Deno.version?.deno ?? 'unknown'),
     };
   }
   if (typeof EdgeRuntime !== 'undefined') {

package/src/lib/bin/auth.ts

@@ -0,0 +1,63 @@
+import * as dotenv from '@dotenvx/dotenvx';
+
+import { BrowserUse } from '../../';
+
+const API_KEY_ENV_VAR_KEY = 'BROWSER_USE_API_KEY';
+
+/**
+ * Creates a new BrowserUse client with the API key from the environment variable.
+ */
+export function createBrowserUseClient() {
+  let apiKey: string | null = null;
+
+  if (process.env[API_KEY_ENV_VAR_KEY]) {
+    apiKey = process.env[API_KEY_ENV_VAR_KEY];
+  }
+
+  if (apiKey == null) {
+    const env = dotenv.config({ path: '.env' });
+
+    const envApiKey = env.parsed?.[API_KEY_ENV_VAR_KEY];
+
+    if (envApiKey) {
+      apiKey = envApiKey;
+    }
+  }
+
+  if (apiKey == null) {
+    console.error(`Missing ${API_KEY_ENV_VAR_KEY} environment variable!`);
+    process.exit(1);
+  }
+
+  return new BrowserUse({ apiKey });
+}
+
+const SECRET_ENV_VAR_KEY = 'SECRET_KEY';
+
+/**
+ * Loads the Browser Use webhook secret from the environment variable.
+ */
+export function getBrowserUseWebhookSecret() {
+  let secret: string | null = null;
+
+  if (process.env[SECRET_ENV_VAR_KEY]) {
+    secret = process.env[SECRET_ENV_VAR_KEY];
+  }
+
+  if (secret == null) {
+    const env = dotenv.config({ path: '.env' });
+
+    const envSecret = env.parsed?.[SECRET_ENV_VAR_KEY];
+
+    if (envSecret) {
+      secret = envSecret;
+    }
+  }
+
+  if (secret == null) {
+    console.error(`Missing ${SECRET_ENV_VAR_KEY} environment variable!`);
+    process.exit(1);
+  }
+
+  return secret;
+}

package/src/lib/bin/cli.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env -S npm run tsn -T
+
+import { program } from 'commander';
+import { listen } from './commands/listen';
+
+program
+  .name('browser-use')
+  .description('CLI to some JavaScript string utilities')
+  .version('0.8.0')
+  .addCommand(listen)
+  .parse(process.argv);

package/src/lib/bin/commands/listen.ts

@@ -0,0 +1,158 @@
+import { Command } from 'commander';
+
+import { BrowserUse } from '../../../';
+import { createWebhookSignature, Webhook } from '../../webhooks';
+import { createBrowserUseClient, getBrowserUseWebhookSecret } from '../auth';
+
+// NOTE: We perform task list refresh to get all running tasks and then
+const tickRef: {
+  timeout: NodeJS.Timeout | null;
+  abort: AbortController | null;
+} = { timeout: null, abort: null };
+
+export const listen = new Command('listen')
+  .description(`Open a local webhook to receive Cloud API updates from the CLI on your local machine.`)
+  .option('-d, --dev <endpoint>', 'The endpoint to forward updates to.')
+  .action(async (options) => {
+    // Auth
+
+    const client = createBrowserUseClient();
+    const secret = getBrowserUseWebhookSecret();
+
+    // Proxy
+
+    const { dev: localTargetEndpoint } = options;
+
+    if (typeof localTargetEndpoint !== 'string') {
+      // NOTE: This should never happen because the command is validated by commander.
+      throw new Error(
+        'Something unexpected happened. Please report this issue. https://github.com/browser-use/browser-use-node/issues',
+      );
+    }
+
+    const localTargetURL = new URL(localTargetEndpoint);
+
+    //
+
+    const queue: { current: Webhook[] } = { current: [] };
+    const runs: Map<string, BrowserUse.TaskStatus> = new Map();
+
+    tickRef.timeout = setInterval(async () => {
+      // NOTE: On next tick, we abort the current abort controller.
+      if (tickRef.abort != null) {
+        tickRef.abort.abort();
+      }
+
+      const controller = new AbortController();
+
+      tickRef.abort = controller;
+
+      console.log(`[polling] ${new Date().toISOString()} `.padEnd(100, '='));
+
+      const tasks: BrowserUse.Tasks.TaskItemView[] = await client.tasks
+        .list(
+          { pageSize: 10 },
+          {
+            signal: tickRef.abort.signal,
+          },
+        )
+        .then((res) => res.items)
+        .catch((_) => []);
+
+      for (const task of tasks) {
+        const currentTaskStatus = runs.get(task.id);
+
+        const timestamp = task.finishedAt ? task.finishedAt : task.startedAt;
+
+        if (currentTaskStatus == null) {
+          // NOTE: The task is new and the CLI hasn't yet captured it in the current run.
+          queue.current.push({
+            type: 'agent.task.status_update',
+            timestamp,
+            payload: {
+              session_id: task.sessionId,
+              task_id: task.id,
+              status: task.status,
+              metadata: task.metadata,
+            },
+          });
+
+          runs.set(task.id, task.status);
+
+          continue;
+        } else {
+          // NOTE: CLI has registered the task in the registry and we need to compare.
+          if (task.status !== currentTaskStatus) {
+            queue.current.push({
+              type: 'agent.task.status_update',
+              timestamp,
+              payload: {
+                session_id: task.sessionId,
+                task_id: task.id,
+                status: task.status,
+                metadata: task.metadata,
+              },
+            });
+
+            runs.set(task.id, task.status);
+
+            continue;
+          }
+        }
+      }
+
+      if (queue.current.length === 0) {
+        return;
+      }
+
+      const promises = queue.current.map(async (update) => {
+        const body = JSON.stringify(update);
+
+        const signature = createWebhookSignature({
+          payload: update.payload,
+          timestamp: update.timestamp,
+          secret,
+        });
+
+        try {
+          const res = await fetch(localTargetURL, {
+            method: 'POST',
+            body,
+            headers: {
+              'Content-Type': 'application/json',
+              // https://docs.browser-use.com/cloud/webhooks#implementing-webhook-verification
+              'X-Browser-Use-Timestamp': update.timestamp,
+              'X-Browser-Use-Signature': signature,
+            },
+
+            signal: controller.signal,
+          });
+
+          console.log(`[update] ${update.timestamp} ${update.type} ${res.status}`);
+
+          return { delivery: 'fulfilled', update, status: res.status };
+        } catch (err) {
+          console.log(`[update] ${update.timestamp} ${update.type} failed`);
+
+          return { delivery: 'rejected', update, error: err };
+        }
+      });
+
+      const delivery = await Promise.all(promises);
+
+      // NOTE: We preserve the rejected updates so we can retry them.
+      queue.current = delivery.filter((d) => d.delivery === 'rejected').map((d) => d.update);
+    }, 1_000);
+
+    console.log(`Listening in dev mode at: ${localTargetEndpoint}`);
+  });
+
+process.on('SIGINT', () => {
+  if (tickRef.abort != null) {
+    tickRef.abort.abort();
+  }
+
+  if (tickRef.timeout) {
+    clearInterval(tickRef.timeout);
+  }
+});

package/src/lib/stream.ts

@@ -23,7 +23,7 @@ export function reducer(state: BrowserState, action: BrowserAction): [BrowserSta
       // INIT
 
       if (state == null) {
-        const liveUrl = action.status.sessionLiveUrl ?? null;
+        const liveUrl = action.status.session.liveUrl ?? null;
         const doneOutput = action.status.doneOutput ?? null;
 
         const state: BrowserState = {
@@ -39,7 +39,7 @@ export function reducer(state: BrowserState, action: BrowserAction): [BrowserSta
 
       // UPDATE
 
-      const liveUrl = action.status.sessionLiveUrl ?? state.liveUrl;
+      const liveUrl = action.status.session.liveUrl ?? state.liveUrl;
       const doneOutput = action.status.doneOutput ?? state.doneOutput;
 
       const steps: TaskStepView[] = [...state.steps];
@@ -68,7 +68,10 @@ export function reducer(state: BrowserState, action: BrowserAction): [BrowserSta
         const update: ReducerEvent = {
           ...action.status,
           steps: newState.steps,
-          sessionLiveUrl: newState.liveUrl,
+          session: {
+            ...action.status.session,
+            liveUrl: newState.liveUrl,
+          },
           doneOutput: newState.doneOutput,
         };
 

package/src/lib/webhooks.ts

@@ -0,0 +1,118 @@
+import { createHmac } from 'crypto';
+import { z } from 'zod';
+import stringify from 'fast-json-stable-stringify';
+
+// https://docs.browser-use.com/cloud/webhooks
+
+//
+
+export const zWebhookTimestamp = z.iso.datetime({ offset: true, local: true });
+
+// test
+
+export const zWebhookTestPayload = z.object({
+  test: z.literal('ok'),
+});
+
+export type WebhookTestPayload = z.infer<typeof zWebhookTestPayload>;
+
+export const zWebhookTest = z.object({
+  type: z.literal('test'),
+  timestamp: z.iso.datetime({ offset: true }),
+  payload: zWebhookTestPayload,
+});
+
+// agent.task.status_update
+
+export const zWebhookAgentTaskStatusUpdatePayloadMetadata = z.record(z.string(), z.unknown()).optional();
+
+export const zWebhookAgentTaskStatusUpdatePayloadStatus = z.literal([
+  'initializing',
+  'started',
+  'paused',
+  'stopped',
+  'finished',
+]);
+
+export const zWebhookAgentTaskStatusUpdatePayload = z.object({
+  session_id: z.string(),
+  task_id: z.string(),
+  status: zWebhookAgentTaskStatusUpdatePayloadStatus,
+  metadata: zWebhookAgentTaskStatusUpdatePayloadMetadata,
+});
+
+export type WebhookAgentTaskStatusUpdatePayload = z.infer<typeof zWebhookAgentTaskStatusUpdatePayload>;
+
+export const zWebhookAgentTaskStatusUpdate = z.object({
+  type: z.literal('agent.task.status_update'),
+  timestamp: zWebhookTimestamp,
+  payload: zWebhookAgentTaskStatusUpdatePayload,
+});
+
+//
+
+export const zWebhookSchema = z.discriminatedUnion('type', [
+  //
+  zWebhookTest,
+  zWebhookAgentTaskStatusUpdate,
+]);
+
+export type Webhook = z.infer<typeof zWebhookSchema>;
+
+// Signature
+
+/**
+ * Utility function that validates the received Webhook event/
+ */
+export async function verifyWebhookEventSignature(
+  evt: {
+    evt: string;
+    signature: string;
+    timestamp: string;
+  },
+  cfg: { secret: string },
+): Promise<{ ok: true; event: Webhook } | { ok: false }> {
+  try {
+    const event = await zWebhookSchema.safeParseAsync(JSON.parse(evt.evt));
+
+    if (event.success === false) {
+      return { ok: false };
+    }
+
+    const signature = createWebhookSignature({
+      payload: event.data.payload,
+      timestamp: evt.timestamp,
+      secret: cfg.secret,
+    });
+
+    // Compare signatures using timing-safe comparison
+    if (evt.signature !== signature) {
+      return { ok: false };
+    }
+
+    return { ok: true, event: event.data };
+  } catch (err) {
+    console.error(err);
+    return { ok: false };
+  }
+}
+
+/**
+ * Creates a webhook signature for the given payload, timestamp, and secret.
+ */
+export function createWebhookSignature({
+  payload,
+  timestamp,
+  secret,
+}: {
+  payload: unknown;
+  timestamp: string;
+  secret: string;
+}): string {
+  const dump = stringify(payload);
+  const message = `${timestamp}.${dump}`;
+
+  const hmac = createHmac('sha256', secret);
+  hmac.update(message);
+  return hmac.digest('hex');
+}

package/src/resources/index.ts

@@ -22,7 +22,6 @@ export {
   type SessionStatus,
   type SessionView,
   type SessionListResponse,
-  type SessionRetrieveParams,
   type SessionUpdateParams,
   type SessionListParams,
 } from './sessions/sessions';

package/src/resources/sessions/index.ts

@@ -6,7 +6,6 @@ export {
   type SessionStatus,
   type SessionView,
   type SessionListResponse,
-  type SessionRetrieveParams,
   type SessionUpdateParams,
   type SessionListParams,
 } from './sessions';

package/src/resources/sessions/sessions.ts

@@ -34,12 +34,8 @@ export class Sessions extends APIResource {
    *
    * - 404: If the user agent session doesn't exist
    */
-  retrieve(
-    sessionID: string,
-    query: SessionRetrieveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<SessionView> {
-    return this._client.get(path`/sessions/${sessionID}`, { query, ...options });
+  retrieve(sessionID: string, options?: RequestOptions): APIPromise<SessionView> {
+    return this._client.get(path`/sessions/${sessionID}`, options);
   }
 
   /**
@@ -185,7 +181,6 @@ export namespace SessionListResponse {
    * session (active/stopped). live_url: URL where the browser can be viewed live in
    * real-time. started_at: Timestamp when the session was created and started.
    * finished_at: Timestamp when the session was stopped (None if still active).
-   * tasks: Optional list of tasks associated with this session.
    */
   export interface Item {
     id: string;
@@ -203,15 +198,9 @@ export namespace SessionListResponse {
     finishedAt?: string | null;
 
     liveUrl?: string | null;
-
-    tasks?: Array<TasksAPI.TaskItemView> | null;
   }
 }
 
-export interface SessionRetrieveParams {
-  includeTasks?: boolean;
-}
-
 export interface SessionUpdateParams {
   /**
    * Available actions that can be performed on a session
@@ -231,8 +220,6 @@ export interface SessionListParams {
    */
   filterBy?: SessionStatus | null;
 
-  includeTasks?: boolean;
-
   pageNumber?: number;
 
   pageSize?: number;
@@ -245,7 +232,6 @@ export declare namespace Sessions {
     type SessionStatus as SessionStatus,
     type SessionView as SessionView,
     type SessionListResponse as SessionListResponse,
-    type SessionRetrieveParams as SessionRetrieveParams,
     type SessionUpdateParams as SessionUpdateParams,
     type SessionListParams as SessionListParams,
   };