browser-use-sdk 3.4.3 → 3.5.0

package/dist/index.cjs

@@ -48,6 +48,13 @@ var Browsers = class {
   stop(sessionId) {
     return this.update(sessionId, { action: "stop" });
   }
+  /** List files the browser downloaded to S3 during the session. */
+  downloads(sessionId, params) {
+    return this.http.get(
+      `/browsers/${sessionId}/downloads`,
+      params
+    );
+  }
 };
 
 // src/v2/resources/files.ts

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/index.cjs","../src/v2/client.ts","../src/v2/resources/billing.ts","../src/v2/resources/browsers.ts","../src/v2/resources/files.ts","../src/v2/resources/marketplace.ts","../src/v2/resources/profiles.ts","../src/v2/resources/sessions.ts","../src/v2/resources/skills.ts","../src/v2/helpers.ts","../src/v2/resources/tasks.ts"],"names":[],"mappings":"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","file":"/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/index.cjs","sourcesContent":[null,"import { z } from \"zod\";\nimport { HttpClient } from \"../core/http.js\";\nimport { Billing } from \"./resources/billing.js\";\nimport { Browsers } from \"./resources/browsers.js\";\nimport { Files } from \"./resources/files.js\";\nimport { Marketplace } from \"./resources/marketplace.js\";\nimport { Profiles } from \"./resources/profiles.js\";\nimport { Sessions } from \"./resources/sessions.js\";\nimport { Skills } from \"./resources/skills.js\";\nimport { Tasks } from \"./resources/tasks.js\";\nimport { TaskRun } from \"./helpers.js\";\nimport type { CreateTaskBody } from \"./resources/tasks.js\";\nimport type { RunOptions } from \"./helpers.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.browser-use.com/api/v2\";\n\nexport interface BrowserUseOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport type RunTaskOptions = Partial<Omit<CreateTaskBody, \"task\">> &\n  RunOptions & { schema?: z.ZodType };\n\nexport class BrowserUse {\n  readonly billing: Billing;\n  readonly tasks: Tasks;\n  readonly sessions: Sessions;\n  readonly files: Files;\n  readonly profiles: Profiles;\n  readonly browsers: Browsers;\n  readonly skills: Skills;\n  readonly marketplace: Marketplace;\n\n  private readonly http: HttpClient;\n\n  constructor(options: BrowserUseOptions = {}) {\n    const apiKey =\n      options.apiKey ?? process.env.BROWSER_USE_API_KEY ?? \"\";\n    if (!apiKey) {\n      throw new Error(\n        \"No API key provided. Pass apiKey or set BROWSER_USE_API_KEY.\",\n      );\n    }\n    this.http = new HttpClient({\n      apiKey,\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      maxRetries: options.maxRetries,\n      timeout: options.timeout,\n    });\n\n    this.billing = new Billing(this.http);\n    this.tasks = new Tasks(this.http);\n    this.sessions = new Sessions(this.http);\n    this.files = new Files(this.http);\n    this.profiles = new Profiles(this.http);\n    this.browsers = new Browsers(this.http);\n    this.skills = new Skills(this.http);\n    this.marketplace = new Marketplace(this.http);\n  }\n\n  /**\n   * Run an AI agent task.\n   *\n   * ```ts\n   * // Simple — just get the output\n   * const output = await client.run(\"Find the top HN post\");\n   *\n   * // Structured output (Zod)\n   * const data = await client.run(\"Find product info\", { schema: ProductSchema });\n   *\n   * // Step-by-step progress\n   * for await (const step of client.run(\"Go to google.com\")) {\n   *   console.log(`[${step.number}] ${step.nextGoal}`);\n   * }\n   * ```\n   */\n  run(task: string, options?: Omit<RunTaskOptions, \"schema\">): TaskRun<string>;\n  run<T extends z.ZodType>(task: string, options: RunTaskOptions & { schema: T }): TaskRun<z.output<T>>;\n  run(task: string, options?: RunTaskOptions): TaskRun<any> {\n    const { schema, timeout, interval, ...rest } = options ?? {};\n    const body: CreateTaskBody = { task, ...rest };\n    if (schema) {\n      body.structuredOutput = JSON.stringify(z.toJSONSchema(schema));\n    }\n    const promise = this.tasks.create(body);\n    return new TaskRun(promise, this.tasks, schema, { timeout, interval });\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype AccountView = components[\"schemas\"][\"AccountView\"];\n\nexport class Billing {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Get authenticated account billing information including credit balance. */\n  account(): Promise<AccountView> {\n    return this.http.get<AccountView>(\"/billing/account\");\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\n/** All fields are optional (server applies defaults); body itself is required by the spec. */\nexport type CreateBrowserBody = Partial<components[\"schemas\"][\"CreateBrowserSessionRequest\"]>;\ntype BrowserSessionItemView = components[\"schemas\"][\"BrowserSessionItemView\"];\ntype BrowserSessionListResponse = components[\"schemas\"][\"BrowserSessionListResponse\"];\ntype BrowserSessionView = components[\"schemas\"][\"BrowserSessionView\"];\ntype UpdateBrowserSessionRequest = components[\"schemas\"][\"UpdateBrowserSessionRequest\"];\n\nexport interface BrowserListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  filterBy?: string;\n}\n\nexport class Browsers {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new browser session. */\n  create(body: CreateBrowserBody = {}): Promise<BrowserSessionItemView> {\n    if (body.proxyCountryCode) {\n      body = { ...body, proxyCountryCode: body.proxyCountryCode.toLowerCase() as any };\n    }\n    return this.http.post<BrowserSessionItemView>(\"/browsers\", body);\n  }\n\n  /** List browser sessions with optional filtering. */\n  list(params?: BrowserListParams): Promise<BrowserSessionListResponse> {\n    return this.http.get<BrowserSessionListResponse>(\n      \"/browsers\",\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get detailed browser session information. */\n  get(sessionId: string): Promise<BrowserSessionView> {\n    return this.http.get<BrowserSessionView>(`/browsers/${sessionId}`);\n  }\n\n  /** Update a browser session (generic PATCH). */\n  update(sessionId: string, body: UpdateBrowserSessionRequest): Promise<BrowserSessionView> {\n    return this.http.patch<BrowserSessionView>(`/browsers/${sessionId}`, body);\n  }\n\n  /** Stop a browser session. */\n  stop(sessionId: string): Promise<BrowserSessionView> {\n    return this.update(sessionId, { action: \"stop\" });\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype UploadFileRequest = components[\"schemas\"][\"UploadFileRequest\"];\ntype UploadFilePresignedUrlResponse = components[\"schemas\"][\"UploadFilePresignedUrlResponse\"];\ntype TaskOutputFileResponse = components[\"schemas\"][\"TaskOutputFileResponse\"];\n\nexport class Files {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Generate a presigned URL for uploading files to an agent session. */\n  sessionUrl(sessionId: string, body: UploadFileRequest): Promise<UploadFilePresignedUrlResponse> {\n    return this.http.post<UploadFilePresignedUrlResponse>(\n      `/files/sessions/${sessionId}/presigned-url`,\n      body,\n    );\n  }\n\n  /** Generate a presigned URL for uploading files to a browser session. */\n  browserUrl(sessionId: string, body: UploadFileRequest): Promise<UploadFilePresignedUrlResponse> {\n    return this.http.post<UploadFilePresignedUrlResponse>(\n      `/files/browsers/${sessionId}/presigned-url`,\n      body,\n    );\n  }\n\n  /** Get secure download URL for a task output file. */\n  taskOutput(taskId: string, fileId: string): Promise<TaskOutputFileResponse> {\n    return this.http.get<TaskOutputFileResponse>(\n      `/files/tasks/${taskId}/output-files/${fileId}`,\n    );\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype ExecuteSkillRequest = components[\"schemas\"][\"ExecuteSkillRequest\"];\ntype ExecuteSkillResponse = components[\"schemas\"][\"ExecuteSkillResponse\"];\ntype MarketplaceSkillListResponse = components[\"schemas\"][\"MarketplaceSkillListResponse\"];\ntype MarketplaceSkillResponse = components[\"schemas\"][\"MarketplaceSkillResponse\"];\ntype SkillResponse = components[\"schemas\"][\"SkillResponse\"];\n\nexport interface MarketplaceListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  query?: string;\n  category?: string;\n  fromDate?: string;\n  toDate?: string;\n}\n\nexport class Marketplace {\n  constructor(private readonly http: HttpClient) {}\n\n  /** List all public skills in the marketplace. */\n  list(params?: MarketplaceListParams): Promise<MarketplaceSkillListResponse> {\n    return this.http.get<MarketplaceSkillListResponse>(\n      \"/marketplace/skills\",\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get details of a specific marketplace skill by slug. */\n  get(skillSlug: string): Promise<MarketplaceSkillResponse> {\n    return this.http.get<MarketplaceSkillResponse>(`/marketplace/skills/${skillSlug}`);\n  }\n\n  /** Clone a public marketplace skill to your project. */\n  clone(skillId: string): Promise<SkillResponse> {\n    return this.http.post<SkillResponse>(`/marketplace/skills/${skillId}/clone`);\n  }\n\n  /** Execute a marketplace skill. */\n  execute(skillId: string, body: ExecuteSkillRequest): Promise<ExecuteSkillResponse> {\n    return this.http.post<ExecuteSkillResponse>(\n      `/marketplace/skills/${skillId}/execute`,\n      body,\n    );\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype ProfileCreateRequest = components[\"schemas\"][\"ProfileCreateRequest\"];\ntype ProfileListResponse = components[\"schemas\"][\"ProfileListResponse\"];\ntype ProfileUpdateRequest = components[\"schemas\"][\"ProfileUpdateRequest\"];\ntype ProfileView = components[\"schemas\"][\"ProfileView\"];\n\nexport interface ProfileListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  query?: string;\n}\n\nexport class Profiles {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new browser profile. */\n  create(body?: ProfileCreateRequest): Promise<ProfileView> {\n    return this.http.post<ProfileView>(\"/profiles\", body);\n  }\n\n  /** List profiles with pagination. */\n  list(params?: ProfileListParams): Promise<ProfileListResponse> {\n    return this.http.get<ProfileListResponse>(\"/profiles\", params as Record<string, unknown>);\n  }\n\n  /** Get profile details. */\n  get(profileId: string): Promise<ProfileView> {\n    return this.http.get<ProfileView>(`/profiles/${profileId}`);\n  }\n\n  /** Update a browser profile. */\n  update(profileId: string, body: ProfileUpdateRequest): Promise<ProfileView> {\n    return this.http.patch<ProfileView>(`/profiles/${profileId}`, body);\n  }\n\n  /** Delete a browser profile. */\n  delete(profileId: string): Promise<void> {\n    return this.http.delete<void>(`/profiles/${profileId}`);\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\n/** User-facing body: all fields are optional (API has defaults). */\ntype CreateSessionBody = Partial<components[\"schemas\"][\"CreateSessionRequest\"]>;\ntype SessionItemView = components[\"schemas\"][\"SessionItemView\"];\ntype SessionListResponse = components[\"schemas\"][\"SessionListResponse\"];\ntype SessionView = components[\"schemas\"][\"SessionView\"];\ntype ShareView = components[\"schemas\"][\"ShareView\"];\ntype UpdateSessionRequest = components[\"schemas\"][\"UpdateSessionRequest\"];\n\nexport interface SessionListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  filterBy?: string;\n}\n\nexport class Sessions {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new session. */\n  create(body?: CreateSessionBody): Promise<SessionItemView> {\n    if (body?.proxyCountryCode) {\n      body = { ...body, proxyCountryCode: body.proxyCountryCode.toLowerCase() as any };\n    }\n    return this.http.post<SessionItemView>(\"/sessions\", body);\n  }\n\n  /** List sessions with optional filtering. */\n  list(params?: SessionListParams): Promise<SessionListResponse> {\n    return this.http.get<SessionListResponse>(\"/sessions\", params as Record<string, unknown>);\n  }\n\n  /** Get detailed session information. */\n  get(sessionId: string): Promise<SessionView> {\n    return this.http.get<SessionView>(`/sessions/${sessionId}`);\n  }\n\n  /** Update a session (generic PATCH). */\n  update(sessionId: string, body: UpdateSessionRequest): Promise<SessionView> {\n    return this.http.patch<SessionView>(`/sessions/${sessionId}`, body);\n  }\n\n  /** Stop a session and all its running tasks. */\n  stop(sessionId: string): Promise<SessionView> {\n    return this.update(sessionId, { action: \"stop\" });\n  }\n\n  /** Delete a session with all its tasks. */\n  delete(sessionId: string): Promise<void> {\n    return this.http.delete<void>(`/sessions/${sessionId}`);\n  }\n\n  /** Get public share information for a session. */\n  getShare(sessionId: string): Promise<ShareView> {\n    return this.http.get<ShareView>(`/sessions/${sessionId}/public-share`);\n  }\n\n  /** Create or return existing public share for a session. */\n  createShare(sessionId: string): Promise<ShareView> {\n    return this.http.post<ShareView>(`/sessions/${sessionId}/public-share`);\n  }\n\n  /** Remove public share for a session. */\n  deleteShare(sessionId: string): Promise<void> {\n    return this.http.delete<void>(`/sessions/${sessionId}/public-share`);\n  }\n\n  /** Purge all session data (ZDR projects only). */\n  purge(sessionId: string): Promise<void> {\n    return this.http.post<void>(`/sessions/${sessionId}/purge`);\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype CreateSkillRequest = components[\"schemas\"][\"CreateSkillRequest\"];\ntype CreateSkillResponse = components[\"schemas\"][\"CreateSkillResponse\"];\ntype ExecuteSkillRequest = components[\"schemas\"][\"ExecuteSkillRequest\"];\ntype ExecuteSkillResponse = components[\"schemas\"][\"ExecuteSkillResponse\"];\ntype RefineSkillRequest = components[\"schemas\"][\"RefineSkillRequest\"];\ntype RefineSkillResponse = components[\"schemas\"][\"RefineSkillResponse\"];\ntype SkillExecutionListResponse = components[\"schemas\"][\"SkillExecutionListResponse\"];\ntype SkillExecutionOutputResponse = components[\"schemas\"][\"SkillExecutionOutputResponse\"];\ntype SkillListResponse = components[\"schemas\"][\"SkillListResponse\"];\ntype SkillResponse = components[\"schemas\"][\"SkillResponse\"];\ntype UpdateSkillRequest = components[\"schemas\"][\"UpdateSkillRequest\"];\n\nexport interface SkillListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  isPublic?: boolean;\n  isEnabled?: boolean;\n  category?: string;\n  query?: string;\n  fromDate?: string;\n  toDate?: string;\n}\n\nexport interface SkillExecutionListParams {\n  pageSize?: number;\n  pageNumber?: number;\n}\n\nexport class Skills {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new skill via automated generation. */\n  create(body: CreateSkillRequest): Promise<CreateSkillResponse> {\n    return this.http.post<CreateSkillResponse>(\"/skills\", body);\n  }\n\n  /** List all skills owned by the project. */\n  list(params?: SkillListParams): Promise<SkillListResponse> {\n    return this.http.get<SkillListResponse>(\"/skills\", params as Record<string, unknown>);\n  }\n\n  /** Get details of a specific skill. */\n  get(skillId: string): Promise<SkillResponse> {\n    return this.http.get<SkillResponse>(`/skills/${skillId}`);\n  }\n\n  /** Delete a skill. */\n  delete(skillId: string): Promise<void> {\n    return this.http.delete<void>(`/skills/${skillId}`);\n  }\n\n  /** Update skill metadata. */\n  update(skillId: string, body: UpdateSkillRequest): Promise<SkillResponse> {\n    return this.http.patch<SkillResponse>(`/skills/${skillId}`, body);\n  }\n\n  /** Cancel the current in-progress generation for a skill. */\n  cancel(skillId: string): Promise<SkillResponse> {\n    return this.http.post<SkillResponse>(`/skills/${skillId}/cancel`);\n  }\n\n  /** Execute a skill with the provided parameters. */\n  execute(skillId: string, body: ExecuteSkillRequest): Promise<ExecuteSkillResponse> {\n    return this.http.post<ExecuteSkillResponse>(`/skills/${skillId}/execute`, body);\n  }\n\n  /** Refine a skill based on feedback. */\n  refine(skillId: string, body: RefineSkillRequest): Promise<RefineSkillResponse> {\n    return this.http.post<RefineSkillResponse>(`/skills/${skillId}/refine`, body);\n  }\n\n  /** Rollback to the previous version. */\n  rollback(skillId: string): Promise<SkillResponse> {\n    return this.http.post<SkillResponse>(`/skills/${skillId}/rollback`);\n  }\n\n  /** List executions for a specific skill. */\n  executions(skillId: string, params?: SkillExecutionListParams): Promise<SkillExecutionListResponse> {\n    return this.http.get<SkillExecutionListResponse>(\n      `/skills/${skillId}/executions`,\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get presigned URL for downloading skill execution output. */\n  executionOutput(skillId: string, executionId: string): Promise<SkillExecutionOutputResponse> {\n    return this.http.get<SkillExecutionOutputResponse>(\n      `/skills/${skillId}/executions/${executionId}/output`,\n    );\n  }\n}\n","import type { z } from \"zod\";\nimport type { components } from \"../generated/v2/types.js\";\nimport type { Tasks } from \"./resources/tasks.js\";\n\ntype TaskCreatedResponse = components[\"schemas\"][\"TaskCreatedResponse\"];\ntype TaskStepView = components[\"schemas\"][\"TaskStepView\"];\ntype TaskView = components[\"schemas\"][\"TaskView\"];\n\nexport const TERMINAL_STATUSES = new Set([\"finished\", \"stopped\"]);\n\n/** Task result with typed output. All TaskView fields are directly accessible. */\nexport type TaskResult<T = string | null> = Omit<TaskView, \"output\"> & { output: T };\n\nexport interface RunOptions {\n  /** Maximum time to wait in milliseconds. Default: 300_000 (5 min). */\n  timeout?: number;\n  /** Polling interval in milliseconds. Default: 2_000. */\n  interval?: number;\n}\n\n/**\n * Lazy task handle returned by `client.run()`.\n *\n * - `await client.run(...)` polls the lightweight status endpoint, returns a `TaskResult`.\n * - `for await (const step of client.run(...))` polls the full task, yields new steps.\n */\nexport class TaskRun<T = string> implements PromiseLike<TaskResult<T>> {\n  private readonly _createPromise: Promise<TaskCreatedResponse>;\n  private readonly _tasks: Tasks;\n  private readonly _schema?: z.ZodType<T>;\n  private readonly _timeout: number;\n  private readonly _interval: number;\n\n  private _taskId: string | null = null;\n  private _result: TaskResult<T> | null = null;\n\n  constructor(\n    createPromise: Promise<TaskCreatedResponse>,\n    tasks: Tasks,\n    schema?: z.ZodType<T>,\n    options?: RunOptions,\n  ) {\n    this._createPromise = createPromise;\n    this._tasks = tasks;\n    this._schema = schema;\n    this._timeout = options?.timeout ?? 300_000;\n    this._interval = options?.interval ?? 2_000;\n  }\n\n  /** Task ID (available after creation resolves). */\n  get taskId(): string | null {\n    return this._taskId;\n  }\n\n  /** Full task result (available after awaiting or iterating to completion). */\n  get result(): TaskResult<T> | null {\n    return this._result;\n  }\n\n  /** Enable `await client.run(...)` — polls status endpoint, returns TaskResult. */\n  then<R1 = TaskResult<T>, R2 = never>(\n    onFulfilled?: ((value: TaskResult<T>) => R1 | PromiseLike<R1>) | null,\n    onRejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null,\n  ): Promise<R1 | R2> {\n    return this._waitForOutput().then(onFulfilled, onRejected);\n  }\n\n  /** Enable `for await (const step of client.run(...))` — polls full task, yields new steps. */\n  async *[Symbol.asyncIterator](): AsyncGenerator<TaskStepView> {\n    const taskId = await this._ensureTaskId();\n    let seen = 0;\n    const deadline = Date.now() + this._timeout;\n\n    while (Date.now() < deadline) {\n      const task = await this._tasks.get(taskId);\n\n      for (let i = seen; i < task.steps.length; i++) {\n        yield task.steps[i];\n      }\n      seen = task.steps.length;\n\n      if (TERMINAL_STATUSES.has(task.status)) {\n        this._result = this._buildResult(task);\n        return;\n      }\n\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) => setTimeout(r, Math.min(this._interval, remaining)));\n    }\n\n    throw new Error(`Task ${taskId} did not complete within ${this._timeout}ms`);\n  }\n\n  private async _ensureTaskId(): Promise<string> {\n    if (this._taskId) return this._taskId;\n    const created = await this._createPromise;\n    this._taskId = created.id;\n    return this._taskId;\n  }\n\n  /** Poll lightweight status endpoint until terminal, return TaskResult. */\n  private async _waitForOutput(): Promise<TaskResult<T>> {\n    const taskId = await this._ensureTaskId();\n    const deadline = Date.now() + this._timeout;\n\n    while (Date.now() < deadline) {\n      const status = await this._tasks.status(taskId);\n      if (TERMINAL_STATUSES.has(status.status)) {\n        const task = await this._tasks.get(taskId);\n        this._result = this._buildResult(task);\n        return this._result;\n      }\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) => setTimeout(r, Math.min(this._interval, remaining)));\n    }\n\n    throw new Error(`Task ${taskId} did not complete within ${this._timeout}ms`);\n  }\n\n  private _buildResult(task: TaskView): TaskResult<T> {\n    const output = this._parseOutput(task.output);\n    return { ...task, output };\n  }\n\n  private _parseOutput(output: string | null | undefined): T {\n    if (output == null) return null as T;\n    if (!this._schema) return output as unknown as T;\n    return this._schema.parse(JSON.parse(output));\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\nimport { TERMINAL_STATUSES } from \"../helpers.js\";\n\n/** User-facing body: only `task` is required; everything else has API defaults. */\nexport type CreateTaskBody = Pick<components[\"schemas\"][\"CreateTaskRequest\"], \"task\"> &\n  Partial<Omit<components[\"schemas\"][\"CreateTaskRequest\"], \"task\">>;\ntype TaskCreatedResponse = components[\"schemas\"][\"TaskCreatedResponse\"];\ntype TaskListResponse = components[\"schemas\"][\"TaskListResponse\"];\ntype TaskLogFileResponse = components[\"schemas\"][\"TaskLogFileResponse\"];\ntype TaskStatusView = components[\"schemas\"][\"TaskStatusView\"];\ntype TaskView = components[\"schemas\"][\"TaskView\"];\ntype UpdateTaskRequest = components[\"schemas\"][\"UpdateTaskRequest\"];\n\nexport interface TaskListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  sessionId?: string;\n  filterBy?: string;\n  after?: string;\n  before?: string;\n}\n\nexport class Tasks {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create and start a new AI agent task. */\n  create(body: CreateTaskBody): Promise<TaskCreatedResponse> {\n    return this.http.post<TaskCreatedResponse>(\"/tasks\", body);\n  }\n\n  /** List tasks with optional filtering. */\n  list(params?: TaskListParams): Promise<TaskListResponse> {\n    return this.http.get<TaskListResponse>(\"/tasks\", params as Record<string, unknown>);\n  }\n\n  /** Get detailed task information. */\n  get(taskId: string): Promise<TaskView> {\n    return this.http.get<TaskView>(`/tasks/${taskId}`);\n  }\n\n  /** Update a task (generic PATCH). */\n  update(taskId: string, body: UpdateTaskRequest): Promise<TaskView> {\n    return this.http.patch<TaskView>(`/tasks/${taskId}`, body);\n  }\n\n  /** Stop a running task. */\n  stop(taskId: string): Promise<TaskView> {\n    return this.update(taskId, { action: \"stop\" });\n  }\n\n  /** Stop a running task and its associated browser session. */\n  stopTaskAndSession(taskId: string): Promise<TaskView> {\n    return this.update(taskId, { action: \"stop_task_and_session\" });\n  }\n\n  /** Get lightweight task status (optimized for polling). */\n  status(taskId: string): Promise<TaskStatusView> {\n    return this.http.get<TaskStatusView>(`/tasks/${taskId}/status`);\n  }\n\n  /** Get secure download URL for task execution logs. */\n  logs(taskId: string): Promise<TaskLogFileResponse> {\n    return this.http.get<TaskLogFileResponse>(`/tasks/${taskId}/logs`);\n  }\n\n  /** Poll until a task reaches a terminal status, then return the full TaskView. */\n  async wait(taskId: string, opts?: { timeout?: number; interval?: number }): Promise<TaskView> {\n    const timeout = opts?.timeout ?? 300_000;\n    const interval = opts?.interval ?? 2_000;\n    const deadline = Date.now() + timeout;\n\n    while (Date.now() < deadline) {\n      const status = await this.status(taskId);\n      if (TERMINAL_STATUSES.has(status.status)) {\n        return this.get(taskId);\n      }\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) => setTimeout(r, Math.min(interval, remaining)));\n    }\n\n    throw new Error(`Task ${taskId} did not complete within ${timeout}ms`);\n  }\n}\n"]}
+{"version":3,"sources":["/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/index.cjs","../src/v2/client.ts","../src/v2/resources/billing.ts","../src/v2/resources/browsers.ts","../src/v2/resources/files.ts","../src/v2/resources/marketplace.ts","../src/v2/resources/profiles.ts","../src/v2/resources/sessions.ts","../src/v2/resources/skills.ts","../src/v2/helpers.ts","../src/v2/resources/tasks.ts"],"names":[],"mappings":"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","file":"/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/index.cjs","sourcesContent":[null,"import { z } from \"zod\";\nimport { HttpClient } from \"../core/http.js\";\nimport { Billing } from \"./resources/billing.js\";\nimport { Browsers } from \"./resources/browsers.js\";\nimport { Files } from \"./resources/files.js\";\nimport { Marketplace } from \"./resources/marketplace.js\";\nimport { Profiles } from \"./resources/profiles.js\";\nimport { Sessions } from \"./resources/sessions.js\";\nimport { Skills } from \"./resources/skills.js\";\nimport { Tasks } from \"./resources/tasks.js\";\nimport { TaskRun } from \"./helpers.js\";\nimport type { CreateTaskBody } from \"./resources/tasks.js\";\nimport type { RunOptions } from \"./helpers.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.browser-use.com/api/v2\";\n\nexport interface BrowserUseOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport type RunTaskOptions = Partial<Omit<CreateTaskBody, \"task\">> &\n  RunOptions & { schema?: z.ZodType };\n\nexport class BrowserUse {\n  readonly billing: Billing;\n  readonly tasks: Tasks;\n  readonly sessions: Sessions;\n  readonly files: Files;\n  readonly profiles: Profiles;\n  readonly browsers: Browsers;\n  readonly skills: Skills;\n  readonly marketplace: Marketplace;\n\n  private readonly http: HttpClient;\n\n  constructor(options: BrowserUseOptions = {}) {\n    const apiKey =\n      options.apiKey ?? process.env.BROWSER_USE_API_KEY ?? \"\";\n    if (!apiKey) {\n      throw new Error(\n        \"No API key provided. Pass apiKey or set BROWSER_USE_API_KEY.\",\n      );\n    }\n    this.http = new HttpClient({\n      apiKey,\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      maxRetries: options.maxRetries,\n      timeout: options.timeout,\n    });\n\n    this.billing = new Billing(this.http);\n    this.tasks = new Tasks(this.http);\n    this.sessions = new Sessions(this.http);\n    this.files = new Files(this.http);\n    this.profiles = new Profiles(this.http);\n    this.browsers = new Browsers(this.http);\n    this.skills = new Skills(this.http);\n    this.marketplace = new Marketplace(this.http);\n  }\n\n  /**\n   * Run an AI agent task.\n   *\n   * ```ts\n   * // Simple — just get the output\n   * const output = await client.run(\"Find the top HN post\");\n   *\n   * // Structured output (Zod)\n   * const data = await client.run(\"Find product info\", { schema: ProductSchema });\n   *\n   * // Step-by-step progress\n   * for await (const step of client.run(\"Go to google.com\")) {\n   *   console.log(`[${step.number}] ${step.nextGoal}`);\n   * }\n   * ```\n   */\n  run(task: string, options?: Omit<RunTaskOptions, \"schema\">): TaskRun<string>;\n  run<T extends z.ZodType>(task: string, options: RunTaskOptions & { schema: T }): TaskRun<z.output<T>>;\n  run(task: string, options?: RunTaskOptions): TaskRun<any> {\n    const { schema, timeout, interval, ...rest } = options ?? {};\n    const body: CreateTaskBody = { task, ...rest };\n    if (schema) {\n      body.structuredOutput = JSON.stringify(z.toJSONSchema(schema));\n    }\n    const promise = this.tasks.create(body);\n    return new TaskRun(promise, this.tasks, schema, { timeout, interval });\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype AccountView = components[\"schemas\"][\"AccountView\"];\n\nexport class Billing {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Get authenticated account billing information including credit balance. */\n  account(): Promise<AccountView> {\n    return this.http.get<AccountView>(\"/billing/account\");\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\n/** All fields are optional (server applies defaults); body itself is required by the spec. */\nexport type CreateBrowserBody = Partial<components[\"schemas\"][\"CreateBrowserSessionRequest\"]>;\ntype BrowserSessionItemView = components[\"schemas\"][\"BrowserSessionItemView\"];\ntype BrowserSessionListResponse = components[\"schemas\"][\"BrowserSessionListResponse\"];\ntype BrowserSessionView = components[\"schemas\"][\"BrowserSessionView\"];\ntype UpdateBrowserSessionRequest = components[\"schemas\"][\"UpdateBrowserSessionRequest\"];\ntype BrowserDownloadListResponse = components[\"schemas\"][\"BrowserDownloadListResponse\"];\n\nexport interface BrowserListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  filterBy?: string;\n}\n\nexport interface BrowserDownloadsParams {\n  limit?: number;\n  cursor?: string;\n  includeUrls?: boolean;\n}\n\nexport class Browsers {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new browser session. */\n  create(body: CreateBrowserBody = {}): Promise<BrowserSessionItemView> {\n    if (body.proxyCountryCode) {\n      body = { ...body, proxyCountryCode: body.proxyCountryCode.toLowerCase() as any };\n    }\n    return this.http.post<BrowserSessionItemView>(\"/browsers\", body);\n  }\n\n  /** List browser sessions with optional filtering. */\n  list(params?: BrowserListParams): Promise<BrowserSessionListResponse> {\n    return this.http.get<BrowserSessionListResponse>(\n      \"/browsers\",\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get detailed browser session information. */\n  get(sessionId: string): Promise<BrowserSessionView> {\n    return this.http.get<BrowserSessionView>(`/browsers/${sessionId}`);\n  }\n\n  /** Update a browser session (generic PATCH). */\n  update(sessionId: string, body: UpdateBrowserSessionRequest): Promise<BrowserSessionView> {\n    return this.http.patch<BrowserSessionView>(`/browsers/${sessionId}`, body);\n  }\n\n  /** Stop a browser session. */\n  stop(sessionId: string): Promise<BrowserSessionView> {\n    return this.update(sessionId, { action: \"stop\" });\n  }\n\n  /** List files the browser downloaded to S3 during the session. */\n  downloads(sessionId: string, params?: BrowserDownloadsParams): Promise<BrowserDownloadListResponse> {\n    return this.http.get<BrowserDownloadListResponse>(\n      `/browsers/${sessionId}/downloads`,\n      params as Record<string, unknown>,\n    );\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype UploadFileRequest = components[\"schemas\"][\"UploadFileRequest\"];\ntype UploadFilePresignedUrlResponse = components[\"schemas\"][\"UploadFilePresignedUrlResponse\"];\ntype TaskOutputFileResponse = components[\"schemas\"][\"TaskOutputFileResponse\"];\n\nexport class Files {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Generate a presigned URL for uploading files to an agent session. */\n  sessionUrl(sessionId: string, body: UploadFileRequest): Promise<UploadFilePresignedUrlResponse> {\n    return this.http.post<UploadFilePresignedUrlResponse>(\n      `/files/sessions/${sessionId}/presigned-url`,\n      body,\n    );\n  }\n\n  /** Generate a presigned URL for uploading files to a browser session. */\n  browserUrl(sessionId: string, body: UploadFileRequest): Promise<UploadFilePresignedUrlResponse> {\n    return this.http.post<UploadFilePresignedUrlResponse>(\n      `/files/browsers/${sessionId}/presigned-url`,\n      body,\n    );\n  }\n\n  /** Get secure download URL for a task output file. */\n  taskOutput(taskId: string, fileId: string): Promise<TaskOutputFileResponse> {\n    return this.http.get<TaskOutputFileResponse>(\n      `/files/tasks/${taskId}/output-files/${fileId}`,\n    );\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype ExecuteSkillRequest = components[\"schemas\"][\"ExecuteSkillRequest\"];\ntype ExecuteSkillResponse = components[\"schemas\"][\"ExecuteSkillResponse\"];\ntype MarketplaceSkillListResponse = components[\"schemas\"][\"MarketplaceSkillListResponse\"];\ntype MarketplaceSkillResponse = components[\"schemas\"][\"MarketplaceSkillResponse\"];\ntype SkillResponse = components[\"schemas\"][\"SkillResponse\"];\n\nexport interface MarketplaceListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  query?: string;\n  category?: string;\n  fromDate?: string;\n  toDate?: string;\n}\n\nexport class Marketplace {\n  constructor(private readonly http: HttpClient) {}\n\n  /** List all public skills in the marketplace. */\n  list(params?: MarketplaceListParams): Promise<MarketplaceSkillListResponse> {\n    return this.http.get<MarketplaceSkillListResponse>(\n      \"/marketplace/skills\",\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get details of a specific marketplace skill by slug. */\n  get(skillSlug: string): Promise<MarketplaceSkillResponse> {\n    return this.http.get<MarketplaceSkillResponse>(`/marketplace/skills/${skillSlug}`);\n  }\n\n  /** Clone a public marketplace skill to your project. */\n  clone(skillId: string): Promise<SkillResponse> {\n    return this.http.post<SkillResponse>(`/marketplace/skills/${skillId}/clone`);\n  }\n\n  /** Execute a marketplace skill. */\n  execute(skillId: string, body: ExecuteSkillRequest): Promise<ExecuteSkillResponse> {\n    return this.http.post<ExecuteSkillResponse>(\n      `/marketplace/skills/${skillId}/execute`,\n      body,\n    );\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype ProfileCreateRequest = components[\"schemas\"][\"ProfileCreateRequest\"];\ntype ProfileListResponse = components[\"schemas\"][\"ProfileListResponse\"];\ntype ProfileUpdateRequest = components[\"schemas\"][\"ProfileUpdateRequest\"];\ntype ProfileView = components[\"schemas\"][\"ProfileView\"];\n\nexport interface ProfileListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  query?: string;\n}\n\nexport class Profiles {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new browser profile. */\n  create(body?: ProfileCreateRequest): Promise<ProfileView> {\n    return this.http.post<ProfileView>(\"/profiles\", body);\n  }\n\n  /** List profiles with pagination. */\n  list(params?: ProfileListParams): Promise<ProfileListResponse> {\n    return this.http.get<ProfileListResponse>(\"/profiles\", params as Record<string, unknown>);\n  }\n\n  /** Get profile details. */\n  get(profileId: string): Promise<ProfileView> {\n    return this.http.get<ProfileView>(`/profiles/${profileId}`);\n  }\n\n  /** Update a browser profile. */\n  update(profileId: string, body: ProfileUpdateRequest): Promise<ProfileView> {\n    return this.http.patch<ProfileView>(`/profiles/${profileId}`, body);\n  }\n\n  /** Delete a browser profile. */\n  delete(profileId: string): Promise<void> {\n    return this.http.delete<void>(`/profiles/${profileId}`);\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\n/** User-facing body: all fields are optional (API has defaults). */\ntype CreateSessionBody = Partial<components[\"schemas\"][\"CreateSessionRequest\"]>;\ntype SessionItemView = components[\"schemas\"][\"SessionItemView\"];\ntype SessionListResponse = components[\"schemas\"][\"SessionListResponse\"];\ntype SessionView = components[\"schemas\"][\"SessionView\"];\ntype ShareView = components[\"schemas\"][\"ShareView\"];\ntype UpdateSessionRequest = components[\"schemas\"][\"UpdateSessionRequest\"];\n\nexport interface SessionListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  filterBy?: string;\n}\n\nexport class Sessions {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new session. */\n  create(body?: CreateSessionBody): Promise<SessionItemView> {\n    if (body?.proxyCountryCode) {\n      body = { ...body, proxyCountryCode: body.proxyCountryCode.toLowerCase() as any };\n    }\n    return this.http.post<SessionItemView>(\"/sessions\", body);\n  }\n\n  /** List sessions with optional filtering. */\n  list(params?: SessionListParams): Promise<SessionListResponse> {\n    return this.http.get<SessionListResponse>(\"/sessions\", params as Record<string, unknown>);\n  }\n\n  /** Get detailed session information. */\n  get(sessionId: string): Promise<SessionView> {\n    return this.http.get<SessionView>(`/sessions/${sessionId}`);\n  }\n\n  /** Update a session (generic PATCH). */\n  update(sessionId: string, body: UpdateSessionRequest): Promise<SessionView> {\n    return this.http.patch<SessionView>(`/sessions/${sessionId}`, body);\n  }\n\n  /** Stop a session and all its running tasks. */\n  stop(sessionId: string): Promise<SessionView> {\n    return this.update(sessionId, { action: \"stop\" });\n  }\n\n  /** Delete a session with all its tasks. */\n  delete(sessionId: string): Promise<void> {\n    return this.http.delete<void>(`/sessions/${sessionId}`);\n  }\n\n  /** Get public share information for a session. */\n  getShare(sessionId: string): Promise<ShareView> {\n    return this.http.get<ShareView>(`/sessions/${sessionId}/public-share`);\n  }\n\n  /** Create or return existing public share for a session. */\n  createShare(sessionId: string): Promise<ShareView> {\n    return this.http.post<ShareView>(`/sessions/${sessionId}/public-share`);\n  }\n\n  /** Remove public share for a session. */\n  deleteShare(sessionId: string): Promise<void> {\n    return this.http.delete<void>(`/sessions/${sessionId}/public-share`);\n  }\n\n  /** Purge all session data (ZDR projects only). */\n  purge(sessionId: string): Promise<void> {\n    return this.http.post<void>(`/sessions/${sessionId}/purge`);\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\n\ntype CreateSkillRequest = components[\"schemas\"][\"CreateSkillRequest\"];\ntype CreateSkillResponse = components[\"schemas\"][\"CreateSkillResponse\"];\ntype ExecuteSkillRequest = components[\"schemas\"][\"ExecuteSkillRequest\"];\ntype ExecuteSkillResponse = components[\"schemas\"][\"ExecuteSkillResponse\"];\ntype RefineSkillRequest = components[\"schemas\"][\"RefineSkillRequest\"];\ntype RefineSkillResponse = components[\"schemas\"][\"RefineSkillResponse\"];\ntype SkillExecutionListResponse = components[\"schemas\"][\"SkillExecutionListResponse\"];\ntype SkillExecutionOutputResponse = components[\"schemas\"][\"SkillExecutionOutputResponse\"];\ntype SkillListResponse = components[\"schemas\"][\"SkillListResponse\"];\ntype SkillResponse = components[\"schemas\"][\"SkillResponse\"];\ntype UpdateSkillRequest = components[\"schemas\"][\"UpdateSkillRequest\"];\n\nexport interface SkillListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  isPublic?: boolean;\n  isEnabled?: boolean;\n  category?: string;\n  query?: string;\n  fromDate?: string;\n  toDate?: string;\n}\n\nexport interface SkillExecutionListParams {\n  pageSize?: number;\n  pageNumber?: number;\n}\n\nexport class Skills {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new skill via automated generation. */\n  create(body: CreateSkillRequest): Promise<CreateSkillResponse> {\n    return this.http.post<CreateSkillResponse>(\"/skills\", body);\n  }\n\n  /** List all skills owned by the project. */\n  list(params?: SkillListParams): Promise<SkillListResponse> {\n    return this.http.get<SkillListResponse>(\"/skills\", params as Record<string, unknown>);\n  }\n\n  /** Get details of a specific skill. */\n  get(skillId: string): Promise<SkillResponse> {\n    return this.http.get<SkillResponse>(`/skills/${skillId}`);\n  }\n\n  /** Delete a skill. */\n  delete(skillId: string): Promise<void> {\n    return this.http.delete<void>(`/skills/${skillId}`);\n  }\n\n  /** Update skill metadata. */\n  update(skillId: string, body: UpdateSkillRequest): Promise<SkillResponse> {\n    return this.http.patch<SkillResponse>(`/skills/${skillId}`, body);\n  }\n\n  /** Cancel the current in-progress generation for a skill. */\n  cancel(skillId: string): Promise<SkillResponse> {\n    return this.http.post<SkillResponse>(`/skills/${skillId}/cancel`);\n  }\n\n  /** Execute a skill with the provided parameters. */\n  execute(skillId: string, body: ExecuteSkillRequest): Promise<ExecuteSkillResponse> {\n    return this.http.post<ExecuteSkillResponse>(`/skills/${skillId}/execute`, body);\n  }\n\n  /** Refine a skill based on feedback. */\n  refine(skillId: string, body: RefineSkillRequest): Promise<RefineSkillResponse> {\n    return this.http.post<RefineSkillResponse>(`/skills/${skillId}/refine`, body);\n  }\n\n  /** Rollback to the previous version. */\n  rollback(skillId: string): Promise<SkillResponse> {\n    return this.http.post<SkillResponse>(`/skills/${skillId}/rollback`);\n  }\n\n  /** List executions for a specific skill. */\n  executions(skillId: string, params?: SkillExecutionListParams): Promise<SkillExecutionListResponse> {\n    return this.http.get<SkillExecutionListResponse>(\n      `/skills/${skillId}/executions`,\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get presigned URL for downloading skill execution output. */\n  executionOutput(skillId: string, executionId: string): Promise<SkillExecutionOutputResponse> {\n    return this.http.get<SkillExecutionOutputResponse>(\n      `/skills/${skillId}/executions/${executionId}/output`,\n    );\n  }\n}\n","import type { z } from \"zod\";\nimport type { components } from \"../generated/v2/types.js\";\nimport type { Tasks } from \"./resources/tasks.js\";\n\ntype TaskCreatedResponse = components[\"schemas\"][\"TaskCreatedResponse\"];\ntype TaskStepView = components[\"schemas\"][\"TaskStepView\"];\ntype TaskView = components[\"schemas\"][\"TaskView\"];\n\nexport const TERMINAL_STATUSES = new Set([\"finished\", \"stopped\"]);\n\n/** Task result with typed output. All TaskView fields are directly accessible. */\nexport type TaskResult<T = string | null> = Omit<TaskView, \"output\"> & { output: T };\n\nexport interface RunOptions {\n  /** Maximum time to wait in milliseconds. Default: 300_000 (5 min). */\n  timeout?: number;\n  /** Polling interval in milliseconds. Default: 2_000. */\n  interval?: number;\n}\n\n/**\n * Lazy task handle returned by `client.run()`.\n *\n * - `await client.run(...)` polls the lightweight status endpoint, returns a `TaskResult`.\n * - `for await (const step of client.run(...))` polls the full task, yields new steps.\n */\nexport class TaskRun<T = string> implements PromiseLike<TaskResult<T>> {\n  private readonly _createPromise: Promise<TaskCreatedResponse>;\n  private readonly _tasks: Tasks;\n  private readonly _schema?: z.ZodType<T>;\n  private readonly _timeout: number;\n  private readonly _interval: number;\n\n  private _taskId: string | null = null;\n  private _result: TaskResult<T> | null = null;\n\n  constructor(\n    createPromise: Promise<TaskCreatedResponse>,\n    tasks: Tasks,\n    schema?: z.ZodType<T>,\n    options?: RunOptions,\n  ) {\n    this._createPromise = createPromise;\n    this._tasks = tasks;\n    this._schema = schema;\n    this._timeout = options?.timeout ?? 300_000;\n    this._interval = options?.interval ?? 2_000;\n  }\n\n  /** Task ID (available after creation resolves). */\n  get taskId(): string | null {\n    return this._taskId;\n  }\n\n  /** Full task result (available after awaiting or iterating to completion). */\n  get result(): TaskResult<T> | null {\n    return this._result;\n  }\n\n  /** Enable `await client.run(...)` — polls status endpoint, returns TaskResult. */\n  then<R1 = TaskResult<T>, R2 = never>(\n    onFulfilled?: ((value: TaskResult<T>) => R1 | PromiseLike<R1>) | null,\n    onRejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null,\n  ): Promise<R1 | R2> {\n    return this._waitForOutput().then(onFulfilled, onRejected);\n  }\n\n  /** Enable `for await (const step of client.run(...))` — polls full task, yields new steps. */\n  async *[Symbol.asyncIterator](): AsyncGenerator<TaskStepView> {\n    const taskId = await this._ensureTaskId();\n    let seen = 0;\n    const deadline = Date.now() + this._timeout;\n\n    while (Date.now() < deadline) {\n      const task = await this._tasks.get(taskId);\n\n      for (let i = seen; i < task.steps.length; i++) {\n        yield task.steps[i];\n      }\n      seen = task.steps.length;\n\n      if (TERMINAL_STATUSES.has(task.status)) {\n        this._result = this._buildResult(task);\n        return;\n      }\n\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) => setTimeout(r, Math.min(this._interval, remaining)));\n    }\n\n    throw new Error(`Task ${taskId} did not complete within ${this._timeout}ms`);\n  }\n\n  private async _ensureTaskId(): Promise<string> {\n    if (this._taskId) return this._taskId;\n    const created = await this._createPromise;\n    this._taskId = created.id;\n    return this._taskId;\n  }\n\n  /** Poll lightweight status endpoint until terminal, return TaskResult. */\n  private async _waitForOutput(): Promise<TaskResult<T>> {\n    const taskId = await this._ensureTaskId();\n    const deadline = Date.now() + this._timeout;\n\n    while (Date.now() < deadline) {\n      const status = await this._tasks.status(taskId);\n      if (TERMINAL_STATUSES.has(status.status)) {\n        const task = await this._tasks.get(taskId);\n        this._result = this._buildResult(task);\n        return this._result;\n      }\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) => setTimeout(r, Math.min(this._interval, remaining)));\n    }\n\n    throw new Error(`Task ${taskId} did not complete within ${this._timeout}ms`);\n  }\n\n  private _buildResult(task: TaskView): TaskResult<T> {\n    const output = this._parseOutput(task.output);\n    return { ...task, output };\n  }\n\n  private _parseOutput(output: string | null | undefined): T {\n    if (output == null) return null as T;\n    if (!this._schema) return output as unknown as T;\n    return this._schema.parse(JSON.parse(output));\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v2/types.js\";\nimport { TERMINAL_STATUSES } from \"../helpers.js\";\n\n/** User-facing body: only `task` is required; everything else has API defaults. */\nexport type CreateTaskBody = Pick<components[\"schemas\"][\"CreateTaskRequest\"], \"task\"> &\n  Partial<Omit<components[\"schemas\"][\"CreateTaskRequest\"], \"task\">>;\ntype TaskCreatedResponse = components[\"schemas\"][\"TaskCreatedResponse\"];\ntype TaskListResponse = components[\"schemas\"][\"TaskListResponse\"];\ntype TaskLogFileResponse = components[\"schemas\"][\"TaskLogFileResponse\"];\ntype TaskStatusView = components[\"schemas\"][\"TaskStatusView\"];\ntype TaskView = components[\"schemas\"][\"TaskView\"];\ntype UpdateTaskRequest = components[\"schemas\"][\"UpdateTaskRequest\"];\n\nexport interface TaskListParams {\n  pageSize?: number;\n  pageNumber?: number;\n  sessionId?: string;\n  filterBy?: string;\n  after?: string;\n  before?: string;\n}\n\nexport class Tasks {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create and start a new AI agent task. */\n  create(body: CreateTaskBody): Promise<TaskCreatedResponse> {\n    return this.http.post<TaskCreatedResponse>(\"/tasks\", body);\n  }\n\n  /** List tasks with optional filtering. */\n  list(params?: TaskListParams): Promise<TaskListResponse> {\n    return this.http.get<TaskListResponse>(\"/tasks\", params as Record<string, unknown>);\n  }\n\n  /** Get detailed task information. */\n  get(taskId: string): Promise<TaskView> {\n    return this.http.get<TaskView>(`/tasks/${taskId}`);\n  }\n\n  /** Update a task (generic PATCH). */\n  update(taskId: string, body: UpdateTaskRequest): Promise<TaskView> {\n    return this.http.patch<TaskView>(`/tasks/${taskId}`, body);\n  }\n\n  /** Stop a running task. */\n  stop(taskId: string): Promise<TaskView> {\n    return this.update(taskId, { action: \"stop\" });\n  }\n\n  /** Stop a running task and its associated browser session. */\n  stopTaskAndSession(taskId: string): Promise<TaskView> {\n    return this.update(taskId, { action: \"stop_task_and_session\" });\n  }\n\n  /** Get lightweight task status (optimized for polling). */\n  status(taskId: string): Promise<TaskStatusView> {\n    return this.http.get<TaskStatusView>(`/tasks/${taskId}/status`);\n  }\n\n  /** Get secure download URL for task execution logs. */\n  logs(taskId: string): Promise<TaskLogFileResponse> {\n    return this.http.get<TaskLogFileResponse>(`/tasks/${taskId}/logs`);\n  }\n\n  /** Poll until a task reaches a terminal status, then return the full TaskView. */\n  async wait(taskId: string, opts?: { timeout?: number; interval?: number }): Promise<TaskView> {\n    const timeout = opts?.timeout ?? 300_000;\n    const interval = opts?.interval ?? 2_000;\n    const deadline = Date.now() + timeout;\n\n    while (Date.now() < deadline) {\n      const status = await this.status(taskId);\n      if (TERMINAL_STATUSES.has(status.status)) {\n        return this.get(taskId);\n      }\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) => setTimeout(r, Math.min(interval, remaining)));\n    }\n\n    throw new Error(`Task ${taskId} did not complete within ${timeout}ms`);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -50,6 +50,12 @@ interface components {
              * @description The plan information
              */
             planInfo: components["schemas"]["PlanInfo"];
+            /**
+             * Is Free Tier
+             * @description Whether the account is on the free tier
+             * @default false
+             */
+            isFreeTier: boolean;
             /**
              * Project ID
              * Format: uuid
@@ -57,6 +63,55 @@ interface components {
              */
             projectId: string;
         };
+        /**
+         * BrowserDownloadFile
+         * @description A single file the browser downloaded during the session.
+         */
+        BrowserDownloadFile: {
+            /**
+             * Path
+             * @description File name (basename relative to the session downloads prefix)
+             */
+            path: string;
+            /**
+             * Size
+             * @description File size in bytes
+             */
+            size: number;
+            /**
+             * Lastmodified
+             * Format: date-time
+             * @description When the file was last modified in S3
+             */
+            lastModified: string;
+            /**
+             * Url
+             * @description Presigned download URL (15 min expiry). Only included when `includeUrls=true`.
+             */
+            url?: string | null;
+        };
+        /**
+         * BrowserDownloadListResponse
+         * @description Paginated list of browser downloads with optional presigned URLs.
+         */
+        BrowserDownloadListResponse: {
+            /**
+             * Files
+             * @description List of files downloaded by the browser
+             */
+            files: components["schemas"]["BrowserDownloadFile"][];
+            /**
+             * Nextcursor
+             * @description Cursor for the next page. Pass as the `cursor` query parameter to fetch the next page.
+             */
+            nextCursor?: string | null;
+            /**
+             * Hasmore
+             * @description Whether there are more files beyond this page.
+             * @default false
+             */
+            hasMore: boolean;
+        };
         /**
          * BrowserSessionItemView
          * @description View model for representing a browser session in list views.
@@ -565,6 +620,12 @@ interface components {
              * @description Password for proxy authentication.
              */
             password?: string | null;
+            /**
+             * Ignore Certificate Errors
+             * @description Ignore TLS certificate errors. Enable this if your proxy uses a self-signed or untrusted certificate (e.g. Burp Suite, corporate proxies).
+             * @default false
+             */
+            ignoreCertErrors: boolean;
         };
         /**
          * DownloadUrlGenerationError
@@ -1601,7 +1662,7 @@ interface components {
          * SupportedLLMs
          * @enum {string}
          */
-        SupportedLLMs: "browser-use-llm" | "browser-use-2.0" | "gpt-4.1" | "gpt-4.1-mini" | "o4-mini" | "o3" | "gemini-2.5-flash" | "gemini-2.5-pro" | "gemini-3-pro-preview" | "gemini-3-flash-preview" | "gemini-flash-latest" | "gemini-flash-lite-latest" | "claude-sonnet-4-20250514" | "claude-sonnet-4-5-20250929" | "claude-sonnet-4-6" | "claude-opus-4-5-20251101" | "llama-4-maverick-17b-128e-instruct" | "claude-3-7-sonnet-20250219";
+        SupportedLLMs: "browser-use-llm" | "browser-use-2.0" | "gpt-4.1" | "gpt-4.1-mini" | "o4-mini" | "o3" | "gemini-2.5-flash" | "gemini-2.5-pro" | "gemini-3-pro-preview" | "gemini-3-flash-preview" | "gemini-flash-latest" | "gemini-flash-lite-latest" | "claude-sonnet-4-20250514" | "claude-sonnet-4-5-20250929" | "claude-sonnet-4-6" | "claude-opus-4-5-20251101" | "claude-opus-4-7" | "llama-4-maverick-17b-128e-instruct" | "claude-3-7-sonnet-20250219";
         /**
          * TaskCreatedResponse
          * @description Response model for creating a task
@@ -2154,11 +2215,17 @@ type BrowserSessionItemView$1 = components["schemas"]["BrowserSessionItemView"];
 type BrowserSessionListResponse$1 = components["schemas"]["BrowserSessionListResponse"];
 type BrowserSessionView$1 = components["schemas"]["BrowserSessionView"];
 type UpdateBrowserSessionRequest$1 = components["schemas"]["UpdateBrowserSessionRequest"];
+type BrowserDownloadListResponse$1 = components["schemas"]["BrowserDownloadListResponse"];
 interface BrowserListParams {
     pageSize?: number;
     pageNumber?: number;
     filterBy?: string;
 }
+interface BrowserDownloadsParams {
+    limit?: number;
+    cursor?: string;
+    includeUrls?: boolean;
+}
 declare class Browsers {
     private readonly http;
     constructor(http: HttpClient);
@@ -2172,6 +2239,8 @@ declare class Browsers {
     update(sessionId: string, body: UpdateBrowserSessionRequest$1): Promise<BrowserSessionView$1>;
     /** Stop a browser session. */
     stop(sessionId: string): Promise<BrowserSessionView$1>;
+    /** List files the browser downloaded to S3 during the session. */
+    downloads(sessionId: string, params?: BrowserDownloadsParams): Promise<BrowserDownloadListResponse$1>;
 }
 
 type UploadFileRequest$1 = components["schemas"]["UploadFileRequest"];
@@ -2456,6 +2525,8 @@ declare class BrowserUse {
 
 type S = components["schemas"];
 type AccountView = S["AccountView"];
+type BrowserDownloadFile = S["BrowserDownloadFile"];
+type BrowserDownloadListResponse = S["BrowserDownloadListResponse"];
 type BrowserSessionItemView = S["BrowserSessionItemView"];
 type BrowserSessionListResponse = S["BrowserSessionListResponse"];
 type BrowserSessionView = S["BrowserSessionView"];
@@ -2514,4 +2585,4 @@ type SupportedLLMs = S["SupportedLLMs"];
 type TaskStatus = S["TaskStatus"];
 type TaskUpdateAction = S["TaskUpdateAction"];
 
-export { type AccountView, Billing, type BrowserListParams, type BrowserSessionItemView, type BrowserSessionListResponse, type BrowserSessionStatus, type BrowserSessionUpdateAction, type BrowserSessionView, BrowserUse, type BrowserUseOptions, Browsers, type CreateBrowserBody, type CreateBrowserSessionRequest, type CreateSessionRequest, type CreateSkillRequest, type CreateSkillResponse, type CreateTaskBody, type CreateTaskRequest, type CustomProxy, type ExecuteSkillRequest, type ExecuteSkillResponse, type FileView, Files, Marketplace, type MarketplaceListParams, type MarketplaceSkillListResponse, type MarketplaceSkillResponse, type ParameterSchema, type ParameterType, type PlanInfo, type ProfileCreateRequest, type ProfileListParams, type ProfileListResponse, type ProfileUpdateRequest, type ProfileView, Profiles, type ProxyCountryCode, type RefineSkillRequest, type RefineSkillResponse, type RunOptions, type RunTaskOptions, type SessionItemView, type SessionListParams, type SessionListResponse, type SessionSettings, type SessionStatus, type SessionUpdateAction, type SessionView, Sessions, type ShareView, type SkillCategory, type SkillExecutionListParams, type SkillExecutionListResponse, type SkillExecutionOutputResponse, type SkillExecutionView, type SkillListParams, type SkillListResponse, type SkillResponse, Skills, type SkillsGenerationStatus, type SupportedLLMs, type TaskCreatedResponse, type TaskItemView, type TaskListParams, type TaskListResponse, type TaskLogFileResponse, type TaskOutputFileResponse, type TaskResult, TaskRun, type TaskStatus, type TaskStatusView, type TaskStepView, type TaskUpdateAction, type TaskView, Tasks, type UpdateBrowserSessionRequest, type UpdateSessionRequest, type UpdateSkillRequest, type UpdateTaskRequest, type UploadFilePresignedUrlResponse, type UploadFileRequest, type components as V2Types };
+export { type AccountView, Billing, type BrowserDownloadFile, type BrowserDownloadListResponse, type BrowserDownloadsParams, type BrowserListParams, type BrowserSessionItemView, type BrowserSessionListResponse, type BrowserSessionStatus, type BrowserSessionUpdateAction, type BrowserSessionView, BrowserUse, type BrowserUseOptions, Browsers, type CreateBrowserBody, type CreateBrowserSessionRequest, type CreateSessionRequest, type CreateSkillRequest, type CreateSkillResponse, type CreateTaskBody, type CreateTaskRequest, type CustomProxy, type ExecuteSkillRequest, type ExecuteSkillResponse, type FileView, Files, Marketplace, type MarketplaceListParams, type MarketplaceSkillListResponse, type MarketplaceSkillResponse, type ParameterSchema, type ParameterType, type PlanInfo, type ProfileCreateRequest, type ProfileListParams, type ProfileListResponse, type ProfileUpdateRequest, type ProfileView, Profiles, type ProxyCountryCode, type RefineSkillRequest, type RefineSkillResponse, type RunOptions, type RunTaskOptions, type SessionItemView, type SessionListParams, type SessionListResponse, type SessionSettings, type SessionStatus, type SessionUpdateAction, type SessionView, Sessions, type ShareView, type SkillCategory, type SkillExecutionListParams, type SkillExecutionListResponse, type SkillExecutionOutputResponse, type SkillExecutionView, type SkillListParams, type SkillListResponse, type SkillResponse, Skills, type SkillsGenerationStatus, type SupportedLLMs, type TaskCreatedResponse, type TaskItemView, type TaskListParams, type TaskListResponse, type TaskLogFileResponse, type TaskOutputFileResponse, type TaskResult, TaskRun, type TaskStatus, type TaskStatusView, type TaskStepView, type TaskUpdateAction, type TaskView, Tasks, type UpdateBrowserSessionRequest, type UpdateSessionRequest, type UpdateSkillRequest, type UpdateTaskRequest, type UploadFilePresignedUrlResponse, type UploadFileRequest, type components as V2Types };

package/dist/index.d.ts

@@ -50,6 +50,12 @@ interface components {
              * @description The plan information
              */
             planInfo: components["schemas"]["PlanInfo"];
+            /**
+             * Is Free Tier
+             * @description Whether the account is on the free tier
+             * @default false
+             */
+            isFreeTier: boolean;
             /**
              * Project ID
              * Format: uuid
@@ -57,6 +63,55 @@ interface components {
              */
             projectId: string;
         };
+        /**
+         * BrowserDownloadFile
+         * @description A single file the browser downloaded during the session.
+         */
+        BrowserDownloadFile: {
+            /**
+             * Path
+             * @description File name (basename relative to the session downloads prefix)
+             */
+            path: string;
+            /**
+             * Size
+             * @description File size in bytes
+             */
+            size: number;
+            /**
+             * Lastmodified
+             * Format: date-time
+             * @description When the file was last modified in S3
+             */
+            lastModified: string;
+            /**
+             * Url
+             * @description Presigned download URL (15 min expiry). Only included when `includeUrls=true`.
+             */
+            url?: string | null;
+        };
+        /**
+         * BrowserDownloadListResponse
+         * @description Paginated list of browser downloads with optional presigned URLs.
+         */
+        BrowserDownloadListResponse: {
+            /**
+             * Files
+             * @description List of files downloaded by the browser
+             */
+            files: components["schemas"]["BrowserDownloadFile"][];
+            /**
+             * Nextcursor
+             * @description Cursor for the next page. Pass as the `cursor` query parameter to fetch the next page.
+             */
+            nextCursor?: string | null;
+            /**
+             * Hasmore
+             * @description Whether there are more files beyond this page.
+             * @default false
+             */
+            hasMore: boolean;
+        };
         /**
          * BrowserSessionItemView
          * @description View model for representing a browser session in list views.
@@ -565,6 +620,12 @@ interface components {
              * @description Password for proxy authentication.
              */
             password?: string | null;
+            /**
+             * Ignore Certificate Errors
+             * @description Ignore TLS certificate errors. Enable this if your proxy uses a self-signed or untrusted certificate (e.g. Burp Suite, corporate proxies).
+             * @default false
+             */
+            ignoreCertErrors: boolean;
         };
         /**
          * DownloadUrlGenerationError
@@ -1601,7 +1662,7 @@ interface components {
          * SupportedLLMs
          * @enum {string}
          */
-        SupportedLLMs: "browser-use-llm" | "browser-use-2.0" | "gpt-4.1" | "gpt-4.1-mini" | "o4-mini" | "o3" | "gemini-2.5-flash" | "gemini-2.5-pro" | "gemini-3-pro-preview" | "gemini-3-flash-preview" | "gemini-flash-latest" | "gemini-flash-lite-latest" | "claude-sonnet-4-20250514" | "claude-sonnet-4-5-20250929" | "claude-sonnet-4-6" | "claude-opus-4-5-20251101" | "llama-4-maverick-17b-128e-instruct" | "claude-3-7-sonnet-20250219";
+        SupportedLLMs: "browser-use-llm" | "browser-use-2.0" | "gpt-4.1" | "gpt-4.1-mini" | "o4-mini" | "o3" | "gemini-2.5-flash" | "gemini-2.5-pro" | "gemini-3-pro-preview" | "gemini-3-flash-preview" | "gemini-flash-latest" | "gemini-flash-lite-latest" | "claude-sonnet-4-20250514" | "claude-sonnet-4-5-20250929" | "claude-sonnet-4-6" | "claude-opus-4-5-20251101" | "claude-opus-4-7" | "llama-4-maverick-17b-128e-instruct" | "claude-3-7-sonnet-20250219";
         /**
          * TaskCreatedResponse
          * @description Response model for creating a task
@@ -2154,11 +2215,17 @@ type BrowserSessionItemView$1 = components["schemas"]["BrowserSessionItemView"];
 type BrowserSessionListResponse$1 = components["schemas"]["BrowserSessionListResponse"];
 type BrowserSessionView$1 = components["schemas"]["BrowserSessionView"];
 type UpdateBrowserSessionRequest$1 = components["schemas"]["UpdateBrowserSessionRequest"];
+type BrowserDownloadListResponse$1 = components["schemas"]["BrowserDownloadListResponse"];
 interface BrowserListParams {
     pageSize?: number;
     pageNumber?: number;
     filterBy?: string;
 }
+interface BrowserDownloadsParams {
+    limit?: number;
+    cursor?: string;
+    includeUrls?: boolean;
+}
 declare class Browsers {
     private readonly http;
     constructor(http: HttpClient);
@@ -2172,6 +2239,8 @@ declare class Browsers {
     update(sessionId: string, body: UpdateBrowserSessionRequest$1): Promise<BrowserSessionView$1>;
     /** Stop a browser session. */
     stop(sessionId: string): Promise<BrowserSessionView$1>;
+    /** List files the browser downloaded to S3 during the session. */
+    downloads(sessionId: string, params?: BrowserDownloadsParams): Promise<BrowserDownloadListResponse$1>;
 }
 
 type UploadFileRequest$1 = components["schemas"]["UploadFileRequest"];
@@ -2456,6 +2525,8 @@ declare class BrowserUse {
 
 type S = components["schemas"];
 type AccountView = S["AccountView"];
+type BrowserDownloadFile = S["BrowserDownloadFile"];
+type BrowserDownloadListResponse = S["BrowserDownloadListResponse"];
 type BrowserSessionItemView = S["BrowserSessionItemView"];
 type BrowserSessionListResponse = S["BrowserSessionListResponse"];
 type BrowserSessionView = S["BrowserSessionView"];
@@ -2514,4 +2585,4 @@ type SupportedLLMs = S["SupportedLLMs"];
 type TaskStatus = S["TaskStatus"];
 type TaskUpdateAction = S["TaskUpdateAction"];
 
-export { type AccountView, Billing, type BrowserListParams, type BrowserSessionItemView, type BrowserSessionListResponse, type BrowserSessionStatus, type BrowserSessionUpdateAction, type BrowserSessionView, BrowserUse, type BrowserUseOptions, Browsers, type CreateBrowserBody, type CreateBrowserSessionRequest, type CreateSessionRequest, type CreateSkillRequest, type CreateSkillResponse, type CreateTaskBody, type CreateTaskRequest, type CustomProxy, type ExecuteSkillRequest, type ExecuteSkillResponse, type FileView, Files, Marketplace, type MarketplaceListParams, type MarketplaceSkillListResponse, type MarketplaceSkillResponse, type ParameterSchema, type ParameterType, type PlanInfo, type ProfileCreateRequest, type ProfileListParams, type ProfileListResponse, type ProfileUpdateRequest, type ProfileView, Profiles, type ProxyCountryCode, type RefineSkillRequest, type RefineSkillResponse, type RunOptions, type RunTaskOptions, type SessionItemView, type SessionListParams, type SessionListResponse, type SessionSettings, type SessionStatus, type SessionUpdateAction, type SessionView, Sessions, type ShareView, type SkillCategory, type SkillExecutionListParams, type SkillExecutionListResponse, type SkillExecutionOutputResponse, type SkillExecutionView, type SkillListParams, type SkillListResponse, type SkillResponse, Skills, type SkillsGenerationStatus, type SupportedLLMs, type TaskCreatedResponse, type TaskItemView, type TaskListParams, type TaskListResponse, type TaskLogFileResponse, type TaskOutputFileResponse, type TaskResult, TaskRun, type TaskStatus, type TaskStatusView, type TaskStepView, type TaskUpdateAction, type TaskView, Tasks, type UpdateBrowserSessionRequest, type UpdateSessionRequest, type UpdateSkillRequest, type UpdateTaskRequest, type UploadFilePresignedUrlResponse, type UploadFileRequest, type components as V2Types };
+export { type AccountView, Billing, type BrowserDownloadFile, type BrowserDownloadListResponse, type BrowserDownloadsParams, type BrowserListParams, type BrowserSessionItemView, type BrowserSessionListResponse, type BrowserSessionStatus, type BrowserSessionUpdateAction, type BrowserSessionView, BrowserUse, type BrowserUseOptions, Browsers, type CreateBrowserBody, type CreateBrowserSessionRequest, type CreateSessionRequest, type CreateSkillRequest, type CreateSkillResponse, type CreateTaskBody, type CreateTaskRequest, type CustomProxy, type ExecuteSkillRequest, type ExecuteSkillResponse, type FileView, Files, Marketplace, type MarketplaceListParams, type MarketplaceSkillListResponse, type MarketplaceSkillResponse, type ParameterSchema, type ParameterType, type PlanInfo, type ProfileCreateRequest, type ProfileListParams, type ProfileListResponse, type ProfileUpdateRequest, type ProfileView, Profiles, type ProxyCountryCode, type RefineSkillRequest, type RefineSkillResponse, type RunOptions, type RunTaskOptions, type SessionItemView, type SessionListParams, type SessionListResponse, type SessionSettings, type SessionStatus, type SessionUpdateAction, type SessionView, Sessions, type ShareView, type SkillCategory, type SkillExecutionListParams, type SkillExecutionListResponse, type SkillExecutionOutputResponse, type SkillExecutionView, type SkillListParams, type SkillListResponse, type SkillResponse, Skills, type SkillsGenerationStatus, type SupportedLLMs, type TaskCreatedResponse, type TaskItemView, type TaskListParams, type TaskListResponse, type TaskLogFileResponse, type TaskOutputFileResponse, type TaskResult, TaskRun, type TaskStatus, type TaskStatusView, type TaskStepView, type TaskUpdateAction, type TaskView, Tasks, type UpdateBrowserSessionRequest, type UpdateSessionRequest, type UpdateSkillRequest, type UpdateTaskRequest, type UploadFilePresignedUrlResponse, type UploadFileRequest, type components as V2Types };

package/dist/index.js

@@ -48,6 +48,13 @@ var Browsers = class {
   stop(sessionId) {
     return this.update(sessionId, { action: "stop" });
   }
+  /** List files the browser downloaded to S3 during the session. */
+  downloads(sessionId, params) {
+    return this.http.get(
+      `/browsers/${sessionId}/downloads`,
+      params
+    );
+  }
 };
 
 // src/v2/resources/files.ts