browser-use-sdk 3.2.0 → 3.3.1

package/dist/chunk-RIRVOEIU.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/greg/Documents/browser-use/core/sdk/browser-use-node/dist/chunk-RIRVOEIU.cjs","../src/core/errors.ts","../src/core/http.ts"],"names":[],"mappings":"AAAA;ACAO,IAAM,gBAAA,EAAN,MAAA,QAA8B,MAAM;AAAA,EAChC;AAAA,EACA;AAAA,EAET,WAAA,CAAY,UAAA,EAAoB,OAAA,EAAiB,MAAA,EAAkB;AACjE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,KAAA,EAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,WAAA,EAAa,UAAA;AAClB,IAAA,IAAA,CAAK,OAAA,EAAS,MAAA;AAAA,EAChB;AACF,CAAA;ADCA;AACA;AEHO,IAAM,WAAA,EAAN,MAAiB;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,WAAA,CAAY,OAAA,EAA4B;AACtC,IAAA,IAAA,CAAK,OAAA,EAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,QAAA,EAAU,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AACjD,IAAA,IAAA,CAAK,WAAA,mBAAa,OAAA,CAAQ,UAAA,UAAc,GAAA;AACxC,IAAA,IAAA,CAAK,QAAA,mBAAU,OAAA,CAAQ,OAAA,UAAW,KAAA;AAAA,EACpC;AAAA,EAEA,MAAM,OAAA,CACJ,MAAA,EACA,IAAA,EACA,OAAA,EAKY;AACZ,IAAA,MAAM,IAAA,EAAM,IAAI,GAAA,CAAI,CAAA,EAAA;AACA,IAAA;AACD,MAAA;AACD,QAAA;AACR,UAAA;AACN,QAAA;AACF,MAAA;AACF,IAAA;AAEwC,IAAA;AACtC,MAAA;AACF,IAAA;AACa,IAAA;AACH,MAAA;AACV,IAAA;AAEmB,IAAA;AACA,MAAA;AACD,QAAA;AACJ,QAAA;AACZ,MAAA;AAEmB,MAAA;AACD,MAAA;AAKH,MAAA;AAEX,MAAA;AACe,QAAA;AACf,UAAA;AACA,UAAA;AACe,UAAA;AACf,UAAA;AACD,QAAA;AAEY,QAAA;AAEI,QAAA;AACF,UAAA;AACJ,YAAA;AACT,UAAA;AACc,UAAA;AAChB,QAAA;AAEM,QAAA;AAIW,QAAA;AACf,UAAA;AACF,QAAA;AAEI,QAAA;AACA,QAAA;AACU,UAAA;AACN,QAAA;AAER,QAAA;AAEE,QAAA;AAEmB,UAAA;AAMP,QAAA;AACJ,QAAA;AACI,MAAA;AACD,QAAA;AACP,QAAA;AACR,MAAA;AACF,IAAA;AAEgB,IAAA;AAClB,EAAA;AAEkE,EAAA;AACzC,IAAA;AACzB,EAAA;AAEsC,EAAA;AACb,IAAA;AACzB,EAAA;AAEuC,EAAA;AACd,IAAA;AACzB,EAAA;AAEqE,EAAA;AAC5C,IAAA;AACzB,EAAA;AACF;AFjCyB;AACA;AACA;AACA;AACA","file":"/Users/greg/Documents/browser-use/core/sdk/browser-use-node/dist/chunk-RIRVOEIU.cjs","sourcesContent":[null,"export class BrowserUseError extends Error {\n  readonly statusCode: number;\n  readonly detail: unknown;\n\n  constructor(statusCode: number, message: string, detail?: unknown) {\n    super(message);\n    this.name = \"BrowserUseError\";\n    this.statusCode = statusCode;\n    this.detail = detail;\n  }\n}\n","import { BrowserUseError } from \"./errors.js\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly maxRetries: number;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.maxRetries = options.maxRetries ?? 3;\n    this.timeout = options.timeout ?? 30_000;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      query?: Record<string, unknown>;\n      signal?: AbortSignal;\n    },\n  ): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (options?.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const headers: Record<string, string> = {\n      \"X-Browser-Use-API-Key\": this.apiKey,\n    };\n    if (options?.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(1000 * 2 ** (attempt - 1), 10_000);\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n\n      const controller = new AbortController();\n      const timeoutId = options?.signal\n        ? undefined\n        : setTimeout(() => controller.abort(), this.timeout);\n\n      // Combine user signal with internal timeout when both are present\n      const signal = options?.signal ?? controller.signal;\n\n      try {\n        const response = await fetch(url.toString(), {\n          method,\n          headers,\n          body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,\n          signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          if (response.status === 204) {\n            return undefined as T;\n          }\n          return (await response.json()) as T;\n        }\n\n        const shouldRetry =\n          response.status === 429 &&\n          attempt < this.maxRetries;\n\n        if (shouldRetry) {\n          continue;\n        }\n\n        let errorBody: unknown;\n        try {\n          errorBody = await response.json();\n        } catch {\n          /* ignore parse errors */\n        }\n        const message =\n          typeof errorBody === \"object\" && errorBody !== null\n            ? String(\n                \"message\" in errorBody\n                  ? (errorBody as Record<string, unknown>).message\n                  : \"detail\" in errorBody\n                    ? (errorBody as Record<string, unknown>).detail\n                    : `HTTP ${response.status}`,\n              )\n            : `HTTP ${response.status}`;\n        throw new BrowserUseError(response.status, message, errorBody);\n      } catch (error) {\n        clearTimeout(timeoutId);\n        throw error;\n      }\n    }\n\n    throw new Error(\"Unreachable: retry loop exhausted\");\n  }\n\n  get<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"POST\", path, { body, query });\n  }\n\n  patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"PATCH\", path, { body, query });\n  }\n\n  delete<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"DELETE\", path, { query });\n  }\n}\n"]}
+{"version":3,"sources":["/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/chunk-RIRVOEIU.cjs","../src/core/errors.ts","../src/core/http.ts"],"names":[],"mappings":"AAAA;ACAO,IAAM,gBAAA,EAAN,MAAA,QAA8B,MAAM;AAAA,EAChC;AAAA,EACA;AAAA,EAET,WAAA,CAAY,UAAA,EAAoB,OAAA,EAAiB,MAAA,EAAkB;AACjE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,KAAA,EAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,WAAA,EAAa,UAAA;AAClB,IAAA,IAAA,CAAK,OAAA,EAAS,MAAA;AAAA,EAChB;AACF,CAAA;ADCA;AACA;AEHO,IAAM,WAAA,EAAN,MAAiB;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,WAAA,CAAY,OAAA,EAA4B;AACtC,IAAA,IAAA,CAAK,OAAA,EAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,QAAA,EAAU,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AACjD,IAAA,IAAA,CAAK,WAAA,mBAAa,OAAA,CAAQ,UAAA,UAAc,GAAA;AACxC,IAAA,IAAA,CAAK,QAAA,mBAAU,OAAA,CAAQ,OAAA,UAAW,KAAA;AAAA,EACpC;AAAA,EAEA,MAAM,OAAA,CACJ,MAAA,EACA,IAAA,EACA,OAAA,EAKY;AACZ,IAAA,MAAM,IAAA,EAAM,IAAI,GAAA,CAAI,CAAA,EAAA;AACA,IAAA;AACD,MAAA;AACD,QAAA;AACR,UAAA;AACN,QAAA;AACF,MAAA;AACF,IAAA;AAEwC,IAAA;AACtC,MAAA;AACF,IAAA;AACa,IAAA;AACH,MAAA;AACV,IAAA;AAEmB,IAAA;AACA,MAAA;AACD,QAAA;AACJ,QAAA;AACZ,MAAA;AAEmB,MAAA;AACD,MAAA;AAKH,MAAA;AAEX,MAAA;AACe,QAAA;AACf,UAAA;AACA,UAAA;AACe,UAAA;AACf,UAAA;AACD,QAAA;AAEY,QAAA;AAEI,QAAA;AACF,UAAA;AACJ,YAAA;AACT,UAAA;AACc,UAAA;AAChB,QAAA;AAEM,QAAA;AAIW,QAAA;AACf,UAAA;AACF,QAAA;AAEI,QAAA;AACA,QAAA;AACU,UAAA;AACN,QAAA;AAER,QAAA;AAEE,QAAA;AAEmB,UAAA;AAMP,QAAA;AACJ,QAAA;AACI,MAAA;AACD,QAAA;AACP,QAAA;AACR,MAAA;AACF,IAAA;AAEgB,IAAA;AAClB,EAAA;AAEkE,EAAA;AACzC,IAAA;AACzB,EAAA;AAEsC,EAAA;AACb,IAAA;AACzB,EAAA;AAEuC,EAAA;AACd,IAAA;AACzB,EAAA;AAEqE,EAAA;AAC5C,IAAA;AACzB,EAAA;AACF;AFjCyB;AACA;AACA;AACA;AACA","file":"/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/chunk-RIRVOEIU.cjs","sourcesContent":[null,"export class BrowserUseError extends Error {\n  readonly statusCode: number;\n  readonly detail: unknown;\n\n  constructor(statusCode: number, message: string, detail?: unknown) {\n    super(message);\n    this.name = \"BrowserUseError\";\n    this.statusCode = statusCode;\n    this.detail = detail;\n  }\n}\n","import { BrowserUseError } from \"./errors.js\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly maxRetries: number;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.maxRetries = options.maxRetries ?? 3;\n    this.timeout = options.timeout ?? 30_000;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      query?: Record<string, unknown>;\n      signal?: AbortSignal;\n    },\n  ): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (options?.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const headers: Record<string, string> = {\n      \"X-Browser-Use-API-Key\": this.apiKey,\n    };\n    if (options?.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(1000 * 2 ** (attempt - 1), 10_000);\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n\n      const controller = new AbortController();\n      const timeoutId = options?.signal\n        ? undefined\n        : setTimeout(() => controller.abort(), this.timeout);\n\n      // Combine user signal with internal timeout when both are present\n      const signal = options?.signal ?? controller.signal;\n\n      try {\n        const response = await fetch(url.toString(), {\n          method,\n          headers,\n          body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,\n          signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          if (response.status === 204) {\n            return undefined as T;\n          }\n          return (await response.json()) as T;\n        }\n\n        const shouldRetry =\n          response.status === 429 &&\n          attempt < this.maxRetries;\n\n        if (shouldRetry) {\n          continue;\n        }\n\n        let errorBody: unknown;\n        try {\n          errorBody = await response.json();\n        } catch {\n          /* ignore parse errors */\n        }\n        const message =\n          typeof errorBody === \"object\" && errorBody !== null\n            ? String(\n                \"message\" in errorBody\n                  ? (errorBody as Record<string, unknown>).message\n                  : \"detail\" in errorBody\n                    ? (errorBody as Record<string, unknown>).detail\n                    : `HTTP ${response.status}`,\n              )\n            : `HTTP ${response.status}`;\n        throw new BrowserUseError(response.status, message, errorBody);\n      } catch (error) {\n        clearTimeout(timeoutId);\n        throw error;\n      }\n    }\n\n    throw new Error(\"Unreachable: retry loop exhausted\");\n  }\n\n  get<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"POST\", path, { body, query });\n  }\n\n  patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"PATCH\", path, { body, query });\n  }\n\n  delete<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"DELETE\", path, { query });\n  }\n}\n"]}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/greg/Documents/browser-use/core/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/greg/Documents/browser-use/core/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    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}\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    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\"];\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    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    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

@@ -123,6 +123,11 @@ interface components {
              * @description ID of the agent session that created this browser (None for standalone BaaS sessions)
              */
             agentSessionId?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
         };
         /**
          * BrowserSessionListResponse
@@ -235,6 +240,11 @@ interface components {
              * @description ID of the agent session that created this browser (None for standalone BaaS sessions)
              */
             agentSessionId?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
         };
         /**
          * CannotDeleteSkillWhileGeneratingError
@@ -281,9 +291,10 @@ interface components {
             profileId?: string | null;
             /**
              * Proxy Country Code
-             * @description Country code for proxy location.
+             * @description Country code for proxy location. Defaults to US. Set to null to disable proxy.
+             * @default us
              */
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /**
              * Timeout
              * @description The timeout for the session in minutes. All users can use up to 240 minutes (4 hours). Pay As You Go users are charged $0.06/hour, subscribers get 50% off.
@@ -308,9 +319,15 @@ interface components {
             allowResizing: boolean;
             /**
              * Custom Proxy
-             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers.
+             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available on the Custom Enterprise plan.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSessionRequest
@@ -324,9 +341,10 @@ interface components {
             profileId?: string | null;
             /**
              * Proxy Country Code
-             * @description Country code for proxy location.
+             * @description Country code for proxy location. Defaults to US. Set to null to disable proxy.
+             * @default us
              */
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /**
              * Start URL
              * @description URL to navigate to when the session starts.
@@ -356,9 +374,15 @@ interface components {
             keepAlive: boolean;
             /**
              * Custom Proxy
-             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers.
+             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available on the Custom Enterprise plan.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSkillRequest
@@ -865,6 +889,11 @@ interface components {
              * @description Optional name for the profile
              */
             name?: string | null;
+            /**
+             * User ID
+             * @description Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
+             */
+            userId?: string | null;
         };
         /**
          * ProfileListResponse
@@ -913,12 +942,18 @@ interface components {
              * @description Optional name for the profile
              */
             name?: string | null;
+            /**
+             * User ID
+             * @description Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
+             */
+            userId?: string | null;
         };
         /**
          * ProfileView
          * @description View model for representing a profile. A profile lets you preserve the login state between sessions.
          *
          *     We recommend that you create a separate profile for each user of your app.
+         *     You can assign a user_id to each profile to easily identify which user the profile belongs to.
          */
         ProfileView: {
             /**
@@ -927,6 +962,11 @@ interface components {
              * @description Unique identifier for the profile
              */
             id: string;
+            /**
+             * User ID
+             * @description Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
+             */
+            userId?: string | null;
             /**
              * Name
              * @description Optional name for the profile
@@ -1025,6 +1065,11 @@ interface components {
              * @description URL where the browser can be viewed live in real-time
              */
             liveUrl?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
             /**
              * Started At
              * Format: date-time
@@ -1109,9 +1154,10 @@ interface components {
             profileId?: string | null;
             /**
              * Proxy Country Code
-             * @description Proxy country code for geo-targeted browsing. If set, proxy is enabled with that country. If session_settings is provided but proxy_country_code is not set, proxy is disabled.
+             * @description Proxy country code for geo-targeted browsing. Defaults to US. Set to null to disable proxy.
+             * @default us
              */
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /**
              * Browser Screen Width
              * @description Custom screen width in pixels for the browser.
@@ -1122,6 +1168,12 @@ interface components {
              * @description Custom screen height in pixels for the browser.
              */
             browserScreenHeight?: number | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * SessionStatus
@@ -1185,6 +1237,11 @@ interface components {
              * @description URL where the browser can be viewed live in real-time
              */
             liveUrl?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
             /**
              * Started At
              * Format: date-time
@@ -1813,6 +1870,11 @@ interface components {
              * @description List of stringified json actions performed by the agent in this step
              */
             actions: string[];
+            /**
+             * Duration
+             * @description Duration of the step in seconds. Calculated as the time elapsed from the previous step completion (or task start for the first step) to this step completion.
+             */
+            duration?: number | null;
         };
         /**
          * TaskUpdateAction
@@ -2158,6 +2220,7 @@ type ProfileView$1 = components["schemas"]["ProfileView"];
 interface ProfileListParams {
     pageSize?: number;
     pageNumber?: number;
+    query?: string;
 }
 declare class Profiles {
     private readonly http;

package/dist/index.d.ts

@@ -123,6 +123,11 @@ interface components {
              * @description ID of the agent session that created this browser (None for standalone BaaS sessions)
              */
             agentSessionId?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
         };
         /**
          * BrowserSessionListResponse
@@ -235,6 +240,11 @@ interface components {
              * @description ID of the agent session that created this browser (None for standalone BaaS sessions)
              */
             agentSessionId?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
         };
         /**
          * CannotDeleteSkillWhileGeneratingError
@@ -281,9 +291,10 @@ interface components {
             profileId?: string | null;
             /**
              * Proxy Country Code
-             * @description Country code for proxy location.
+             * @description Country code for proxy location. Defaults to US. Set to null to disable proxy.
+             * @default us
              */
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /**
              * Timeout
              * @description The timeout for the session in minutes. All users can use up to 240 minutes (4 hours). Pay As You Go users are charged $0.06/hour, subscribers get 50% off.
@@ -308,9 +319,15 @@ interface components {
             allowResizing: boolean;
             /**
              * Custom Proxy
-             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers.
+             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available on the Custom Enterprise plan.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSessionRequest
@@ -324,9 +341,10 @@ interface components {
             profileId?: string | null;
             /**
              * Proxy Country Code
-             * @description Country code for proxy location.
+             * @description Country code for proxy location. Defaults to US. Set to null to disable proxy.
+             * @default us
              */
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /**
              * Start URL
              * @description URL to navigate to when the session starts.
@@ -356,9 +374,15 @@ interface components {
             keepAlive: boolean;
             /**
              * Custom Proxy
-             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers.
+             * @description Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available on the Custom Enterprise plan.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSkillRequest
@@ -865,6 +889,11 @@ interface components {
              * @description Optional name for the profile
              */
             name?: string | null;
+            /**
+             * User ID
+             * @description Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
+             */
+            userId?: string | null;
         };
         /**
          * ProfileListResponse
@@ -913,12 +942,18 @@ interface components {
              * @description Optional name for the profile
              */
             name?: string | null;
+            /**
+             * User ID
+             * @description Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
+             */
+            userId?: string | null;
         };
         /**
          * ProfileView
          * @description View model for representing a profile. A profile lets you preserve the login state between sessions.
          *
          *     We recommend that you create a separate profile for each user of your app.
+         *     You can assign a user_id to each profile to easily identify which user the profile belongs to.
          */
         ProfileView: {
             /**
@@ -927,6 +962,11 @@ interface components {
              * @description Unique identifier for the profile
              */
             id: string;
+            /**
+             * User ID
+             * @description Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
+             */
+            userId?: string | null;
             /**
              * Name
              * @description Optional name for the profile
@@ -1025,6 +1065,11 @@ interface components {
              * @description URL where the browser can be viewed live in real-time
              */
             liveUrl?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
             /**
              * Started At
              * Format: date-time
@@ -1109,9 +1154,10 @@ interface components {
             profileId?: string | null;
             /**
              * Proxy Country Code
-             * @description Proxy country code for geo-targeted browsing. If set, proxy is enabled with that country. If session_settings is provided but proxy_country_code is not set, proxy is disabled.
+             * @description Proxy country code for geo-targeted browsing. Defaults to US. Set to null to disable proxy.
+             * @default us
              */
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /**
              * Browser Screen Width
              * @description Custom screen width in pixels for the browser.
@@ -1122,6 +1168,12 @@ interface components {
              * @description Custom screen height in pixels for the browser.
              */
             browserScreenHeight?: number | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * SessionStatus
@@ -1185,6 +1237,11 @@ interface components {
              * @description URL where the browser can be viewed live in real-time
              */
             liveUrl?: string | null;
+            /**
+             * Recording URL
+             * @description Presigned URL to download the session recording (available after session ends, if recording was enabled)
+             */
+            recordingUrl?: string | null;
             /**
              * Started At
              * Format: date-time
@@ -1813,6 +1870,11 @@ interface components {
              * @description List of stringified json actions performed by the agent in this step
              */
             actions: string[];
+            /**
+             * Duration
+             * @description Duration of the step in seconds. Calculated as the time elapsed from the previous step completion (or task start for the first step) to this step completion.
+             */
+            duration?: number | null;
         };
         /**
          * TaskUpdateAction
@@ -2158,6 +2220,7 @@ type ProfileView$1 = components["schemas"]["ProfileView"];
 interface ProfileListParams {
     pageSize?: number;
     pageNumber?: number;
+    query?: string;
 }
 declare class Profiles {
     private readonly http;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../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"],"sourcesContent":["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    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}\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    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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../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"],"sourcesContent":["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    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    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"],"mappings":";;;;;;AAAA,SAAS,SAAS;;;ACKX,IAAM,UAAN,MAAc;AAAA,EACnB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,UAAgC;AAC9B,WAAO,KAAK,KAAK,IAAiB,kBAAkB;AAAA,EACtD;AACF;;;ACIO,IAAM,WAAN,MAAe;AAAA,EACpB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,OAAO,OAA0B,CAAC,GAAoC;AACpE,WAAO,KAAK,KAAK,KAA6B,aAAa,IAAI;AAAA,EACjE;AAAA;AAAA,EAGA,KAAK,QAAiE;AACpE,WAAO,KAAK,KAAK;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,WAAgD;AAClD,WAAO,KAAK,KAAK,IAAwB,aAAa,SAAS,EAAE;AAAA,EACnE;AAAA;AAAA,EAGA,OAAO,WAAmB,MAAgE;AACxF,WAAO,KAAK,KAAK,MAA0B,aAAa,SAAS,IAAI,IAAI;AAAA,EAC3E;AAAA;AAAA,EAGA,KAAK,WAAgD;AACnD,WAAO,KAAK,OAAO,WAAW,EAAE,QAAQ,OAAO,CAAC;AAAA,EAClD;AACF;;;ACvCO,IAAM,QAAN,MAAY;AAAA,EACjB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,WAAW,WAAmB,MAAkE;AAC9F,WAAO,KAAK,KAAK;AAAA,MACf,mBAAmB,SAAS;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,WAAW,WAAmB,MAAkE;AAC9F,WAAO,KAAK,KAAK;AAAA,MACf,mBAAmB,SAAS;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,WAAW,QAAgB,QAAiD;AAC1E,WAAO,KAAK,KAAK;AAAA,MACf,gBAAgB,MAAM,iBAAiB,MAAM;AAAA,IAC/C;AAAA,EACF;AACF;;;ACdO,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,KAAK,QAAuE;AAC1E,WAAO,KAAK,KAAK;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,WAAsD;AACxD,WAAO,KAAK,KAAK,IAA8B,uBAAuB,SAAS,EAAE;AAAA,EACnF;AAAA;AAAA,EAGA,MAAM,SAAyC;AAC7C,WAAO,KAAK,KAAK,KAAoB,uBAAuB,OAAO,QAAQ;AAAA,EAC7E;AAAA;AAAA,EAGA,QAAQ,SAAiB,MAA0D;AACjF,WAAO,KAAK,KAAK;AAAA,MACf,uBAAuB,OAAO;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AACF;;;AChCO,IAAM,WAAN,MAAe;AAAA,EACpB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,OAAO,MAAmD;AACxD,WAAO,KAAK,KAAK,KAAkB,aAAa,IAAI;AAAA,EACtD;AAAA;AAAA,EAGA,KAAK,QAA0D;AAC7D,WAAO,KAAK,KAAK,IAAyB,aAAa,MAAiC;AAAA,EAC1F;AAAA;AAAA,EAGA,IAAI,WAAyC;AAC3C,WAAO,KAAK,KAAK,IAAiB,aAAa,SAAS,EAAE;AAAA,EAC5D;AAAA;AAAA,EAGA,OAAO,WAAmB,MAAkD;AAC1E,WAAO,KAAK,KAAK,MAAmB,aAAa,SAAS,IAAI,IAAI;AAAA,EACpE;AAAA;AAAA,EAGA,OAAO,WAAkC;AACvC,WAAO,KAAK,KAAK,OAAa,aAAa,SAAS,EAAE;AAAA,EACxD;AACF;;;ACxBO,IAAM,WAAN,MAAe;AAAA,EACpB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,OAAO,MAAoD;AACzD,WAAO,KAAK,KAAK,KAAsB,aAAa,IAAI;AAAA,EAC1D;AAAA;AAAA,EAGA,KAAK,QAA0D;AAC7D,WAAO,KAAK,KAAK,IAAyB,aAAa,MAAiC;AAAA,EAC1F;AAAA;AAAA,EAGA,IAAI,WAAyC;AAC3C,WAAO,KAAK,KAAK,IAAiB,aAAa,SAAS,EAAE;AAAA,EAC5D;AAAA;AAAA,EAGA,OAAO,WAAmB,MAAkD;AAC1E,WAAO,KAAK,KAAK,MAAmB,aAAa,SAAS,IAAI,IAAI;AAAA,EACpE;AAAA;AAAA,EAGA,KAAK,WAAyC;AAC5C,WAAO,KAAK,OAAO,WAAW,EAAE,QAAQ,OAAO,CAAC;AAAA,EAClD;AAAA;AAAA,EAGA,OAAO,WAAkC;AACvC,WAAO,KAAK,KAAK,OAAa,aAAa,SAAS,EAAE;AAAA,EACxD;AAAA;AAAA,EAGA,SAAS,WAAuC;AAC9C,WAAO,KAAK,KAAK,IAAe,aAAa,SAAS,eAAe;AAAA,EACvE;AAAA;AAAA,EAGA,YAAY,WAAuC;AACjD,WAAO,KAAK,KAAK,KAAgB,aAAa,SAAS,eAAe;AAAA,EACxE;AAAA;AAAA,EAGA,YAAY,WAAkC;AAC5C,WAAO,KAAK,KAAK,OAAa,aAAa,SAAS,eAAe;AAAA,EACrE;AAAA;AAAA,EAGA,MAAM,WAAkC;AACtC,WAAO,KAAK,KAAK,KAAW,aAAa,SAAS,QAAQ;AAAA,EAC5D;AACF;;;ACtCO,IAAM,SAAN,MAAa;AAAA,EAClB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,OAAO,MAAwD;AAC7D,WAAO,KAAK,KAAK,KAA0B,WAAW,IAAI;AAAA,EAC5D;AAAA;AAAA,EAGA,KAAK,QAAsD;AACzD,WAAO,KAAK,KAAK,IAAuB,WAAW,MAAiC;AAAA,EACtF;AAAA;AAAA,EAGA,IAAI,SAAyC;AAC3C,WAAO,KAAK,KAAK,IAAmB,WAAW,OAAO,EAAE;AAAA,EAC1D;AAAA;AAAA,EAGA,OAAO,SAAgC;AACrC,WAAO,KAAK,KAAK,OAAa,WAAW,OAAO,EAAE;AAAA,EACpD;AAAA;AAAA,EAGA,OAAO,SAAiB,MAAkD;AACxE,WAAO,KAAK,KAAK,MAAqB,WAAW,OAAO,IAAI,IAAI;AAAA,EAClE;AAAA;AAAA,EAGA,OAAO,SAAyC;AAC9C,WAAO,KAAK,KAAK,KAAoB,WAAW,OAAO,SAAS;AAAA,EAClE;AAAA;AAAA,EAGA,QAAQ,SAAiB,MAA0D;AACjF,WAAO,KAAK,KAAK,KAA2B,WAAW,OAAO,YAAY,IAAI;AAAA,EAChF;AAAA;AAAA,EAGA,OAAO,SAAiB,MAAwD;AAC9E,WAAO,KAAK,KAAK,KAA0B,WAAW,OAAO,WAAW,IAAI;AAAA,EAC9E;AAAA;AAAA,EAGA,SAAS,SAAyC;AAChD,WAAO,KAAK,KAAK,KAAoB,WAAW,OAAO,WAAW;AAAA,EACpE;AAAA;AAAA,EAGA,WAAW,SAAiB,QAAwE;AAClG,WAAO,KAAK,KAAK;AAAA,MACf,WAAW,OAAO;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,gBAAgB,SAAiB,aAA4D;AAC3F,WAAO,KAAK,KAAK;AAAA,MACf,WAAW,OAAO,eAAe,WAAW;AAAA,IAC9C;AAAA,EACF;AACF;;;ACrFO,IAAM,oBAAoB,oBAAI,IAAI,CAAC,YAAY,SAAS,CAAC;AAkBzD,IAAM,UAAN,MAAgE;AAAA,EACpD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,UAAyB;AAAA,EACzB,UAAgC;AAAA,EAExC,YACE,eACA,OACA,QACA,SACA;AACA,SAAK,iBAAiB;AACtB,SAAK,SAAS;AACd,SAAK,UAAU;AACf,SAAK,WAAW,SAAS,WAAW;AACpC,SAAK,YAAY,SAAS,YAAY;AAAA,EACxC;AAAA;AAAA,EAGA,IAAI,SAAwB;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,SAA+B;AACjC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,KACE,aACA,YACkB;AAClB,WAAO,KAAK,eAAe,EAAE,KAAK,aAAa,UAAU;AAAA,EAC3D;AAAA;AAAA,EAGA,QAAQ,OAAO,aAAa,IAAkC;AAC5D,UAAM,SAAS,MAAM,KAAK,cAAc;AACxC,QAAI,OAAO;AACX,UAAM,WAAW,KAAK,IAAI,IAAI,KAAK;AAEnC,WAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,YAAM,OAAO,MAAM,KAAK,OAAO,IAAI,MAAM;AAEzC,eAAS,IAAI,MAAM,IAAI,KAAK,MAAM,QAAQ,KAAK;AAC7C,cAAM,KAAK,MAAM,CAAC;AAAA,MACpB;AACA,aAAO,KAAK,MAAM;AAElB,UAAI,kBAAkB,IAAI,KAAK,MAAM,GAAG;AACtC,aAAK,UAAU,KAAK,aAAa,IAAI;AACrC;AAAA,MACF;AAEA,YAAM,YAAY,WAAW,KAAK,IAAI;AACtC,UAAI,aAAa,EAAG;AACpB,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,KAAK,IAAI,KAAK,WAAW,SAAS,CAAC,CAAC;AAAA,IAC7E;AAEA,UAAM,IAAI,MAAM,QAAQ,MAAM,4BAA4B,KAAK,QAAQ,IAAI;AAAA,EAC7E;AAAA,EAEA,MAAc,gBAAiC;AAC7C,QAAI,KAAK,QAAS,QAAO,KAAK;AAC9B,UAAM,UAAU,MAAM,KAAK;AAC3B,SAAK,UAAU,QAAQ;AACvB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAc,iBAAyC;AACrD,UAAM,SAAS,MAAM,KAAK,cAAc;AACxC,UAAM,WAAW,KAAK,IAAI,IAAI,KAAK;AAEnC,WAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,YAAM,SAAS,MAAM,KAAK,OAAO,OAAO,MAAM;AAC9C,UAAI,kBAAkB,IAAI,OAAO,MAAM,GAAG;AACxC,cAAM,OAAO,MAAM,KAAK,OAAO,IAAI,MAAM;AACzC,aAAK,UAAU,KAAK,aAAa,IAAI;AACrC,eAAO,KAAK;AAAA,MACd;AACA,YAAM,YAAY,WAAW,KAAK,IAAI;AACtC,UAAI,aAAa,EAAG;AACpB,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,KAAK,IAAI,KAAK,WAAW,SAAS,CAAC,CAAC;AAAA,IAC7E;AAEA,UAAM,IAAI,MAAM,QAAQ,MAAM,4BAA4B,KAAK,QAAQ,IAAI;AAAA,EAC7E;AAAA,EAEQ,aAAa,MAA+B;AAClD,UAAM,SAAS,KAAK,aAAa,KAAK,MAAM;AAC5C,WAAO,EAAE,GAAG,MAAM,OAAO;AAAA,EAC3B;AAAA,EAEQ,aAAa,QAAsC;AACzD,QAAI,UAAU,KAAM,QAAO;AAC3B,QAAI,CAAC,KAAK,QAAS,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,KAAK,MAAM,MAAM,CAAC;AAAA,EAC9C;AACF;;;AC5GO,IAAM,QAAN,MAAY;AAAA,EACjB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGhD,OAAO,MAAoD;AACzD,WAAO,KAAK,KAAK,KAA0B,UAAU,IAAI;AAAA,EAC3D;AAAA;AAAA,EAGA,KAAK,QAAoD;AACvD,WAAO,KAAK,KAAK,IAAsB,UAAU,MAAiC;AAAA,EACpF;AAAA;AAAA,EAGA,IAAI,QAAmC;AACrC,WAAO,KAAK,KAAK,IAAc,UAAU,MAAM,EAAE;AAAA,EACnD;AAAA;AAAA,EAGA,OAAO,QAAgB,MAA4C;AACjE,WAAO,KAAK,KAAK,MAAgB,UAAU,MAAM,IAAI,IAAI;AAAA,EAC3D;AAAA;AAAA,EAGA,KAAK,QAAmC;AACtC,WAAO,KAAK,OAAO,QAAQ,EAAE,QAAQ,OAAO,CAAC;AAAA,EAC/C;AAAA;AAAA,EAGA,mBAAmB,QAAmC;AACpD,WAAO,KAAK,OAAO,QAAQ,EAAE,QAAQ,wBAAwB,CAAC;AAAA,EAChE;AAAA;AAAA,EAGA,OAAO,QAAyC;AAC9C,WAAO,KAAK,KAAK,IAAoB,UAAU,MAAM,SAAS;AAAA,EAChE;AAAA;AAAA,EAGA,KAAK,QAA8C;AACjD,WAAO,KAAK,KAAK,IAAyB,UAAU,MAAM,OAAO;AAAA,EACnE;AAAA;AAAA,EAGA,MAAM,KAAK,QAAgB,MAAmE;AAC5F,UAAM,UAAU,MAAM,WAAW;AACjC,UAAM,WAAW,MAAM,YAAY;AACnC,UAAM,WAAW,KAAK,IAAI,IAAI;AAE9B,WAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,YAAM,SAAS,MAAM,KAAK,OAAO,MAAM;AACvC,UAAI,kBAAkB,IAAI,OAAO,MAAM,GAAG;AACxC,eAAO,KAAK,IAAI,MAAM;AAAA,MACxB;AACA,YAAM,YAAY,WAAW,KAAK,IAAI;AACtC,UAAI,aAAa,EAAG;AACpB,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,KAAK,IAAI,UAAU,SAAS,CAAC,CAAC;AAAA,IACvE;AAEA,UAAM,IAAI,MAAM,QAAQ,MAAM,4BAA4B,OAAO,IAAI;AAAA,EACvE;AACF;;;ATtEA,IAAM,mBAAmB;AAYlB,IAAM,aAAN,MAAiB;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEQ;AAAA,EAEjB,YAAY,UAA6B,CAAC,GAAG;AAC3C,UAAM,SACJ,QAAQ,UAAU,QAAQ,IAAI,uBAAuB;AACvD,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,SAAK,OAAO,IAAI,WAAW;AAAA,MACzB;AAAA,MACA,SAAS,QAAQ,WAAW;AAAA,MAC5B,YAAY,QAAQ;AAAA,MACpB,SAAS,QAAQ;AAAA,IACnB,CAAC;AAED,SAAK,UAAU,IAAI,QAAQ,KAAK,IAAI;AACpC,SAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;AAChC,SAAK,WAAW,IAAI,SAAS,KAAK,IAAI;AACtC,SAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;AAChC,SAAK,WAAW,IAAI,SAAS,KAAK,IAAI;AACtC,SAAK,WAAW,IAAI,SAAS,KAAK,IAAI;AACtC,SAAK,SAAS,IAAI,OAAO,KAAK,IAAI;AAClC,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAAA,EAC9C;AAAA,EAoBA,IAAI,MAAc,SAAwC;AACxD,UAAM,EAAE,QAAQ,SAAS,UAAU,GAAG,KAAK,IAAI,WAAW,CAAC;AAC3D,UAAM,OAAuB,EAAE,MAAM,GAAG,KAAK;AAC7C,QAAI,QAAQ;AACV,WAAK,mBAAmB,KAAK,UAAU,EAAE,aAAa,MAAM,CAAC;AAAA,IAC/D;AACA,UAAM,UAAU,KAAK,MAAM,OAAO,IAAI;AACtC,WAAO,IAAI,QAAQ,SAAS,KAAK,OAAO,QAAQ,EAAE,SAAS,SAAS,CAAC;AAAA,EACvE;AACF;","names":[]}

package/dist/v3.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/greg/Documents/browser-use/core/sdk/browser-use-node/dist/v3.cjs","../src/v3/client.ts","../src/v3/resources/sessions.ts","../src/v3/resources/workspaces.ts","../src/v3/helpers.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACLA,0BAAkB;ADOlB;AACA;AEyBO,IAAM,SAAA,EAAN,MAAe;AAAA,EACpB,WAAA,CAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,KAAA,EAAA,IAAA;AAAA,EAAmB;AAAA;AAAA,EAGhD,MAAA,CAAO,IAAA,EAAoD;AACzD,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAAsB,WAAA,EAAa,IAAI,CAAA;AAAA,EAC1D;AAAA;AAAA,EAGA,IAAA,CAAK,MAAA,EAA0D;AAC7D,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAyB,WAAA,EAAa,MAAiC,CAAA;AAAA,EAC1F;AAAA;AAAA,EAGA,GAAA,CAAI,SAAA,EAA6C;AAC/C,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAqB,CAAA,UAAA,EAAa,SAAS,CAAA,CAAA;AAC9D,EAAA;AAAA;AAG6E,EAAA;AACd,IAAA;AAC/D,EAAA;AAAA;AAGyC,EAAA;AACI,IAAA;AAC7C,EAAA;AAAA;AAGqF,EAAA;AACnB,IAAA;AAClE,EAAA;AAAA;AAGiF,EAAA;AAC9D,IAAA;AACO,MAAA;AACtB,MAAA;AACF,IAAA;AACF,EAAA;AAAA;AAG0F,EAAA;AACvE,IAAA;AACO,MAAA;AACtB,MAAA;AACF,IAAA;AACF,EAAA;AACF;AF7BgD;AACA;AG7BxB;AACyB,EAAA;AAAlB,IAAA;AAAmB,EAAA;AAAA;AAGmB,EAAA;AAC2B,IAAA;AAC9F,EAAA;AAAA;AAG8D,EAAA;AACJ,IAAA;AAC1D,EAAA;AAAA;AAGiD,EAAA;AACI,IAAA;AACrD,EAAA;AAAA;AAGkF,EAAA;AAC3B,IAAA;AACvD,EAAA;AAAA;AAG2C,EAAA;AACI,IAAA;AAC/C,EAAA;AAAA;AAGqF,EAAA;AAClE,IAAA;AACW,MAAA;AAC1B,MAAA;AACF,IAAA;AACF,EAAA;AAAA;AAGoH,EAAA;AACjG,IAAA;AACW,MAAA;AAC1B,MAAA;AACA,MAAA;AACF,IAAA;AACF,EAAA;AAAA;AAG6D,EAAA;AACd,IAAA;AAC/C,EAAA;AAAA;AAG4C,EAAA;AACG,IAAA;AAC/C,EAAA;AACF;AHwBgD;AACA;AIjGd;AAgB2C;AAC1D,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACmB,iBAAA;AACO,kBAAA;AAMzC,EAAA;AAEsB,IAAA;AACL,IAAA;AACF,IAAA;AACqB,IAAA;AACE,IAAA;AACxC,EAAA;AAAA;AAG+B,EAAA;AACjB,IAAA;AACd,EAAA;AAAA;AAGsC,EAAA;AACxB,IAAA;AACd,EAAA;AAAA;AAQoB,EAAA;AACgB,IAAA;AACpC,EAAA;AAEkD,EAAA;AACf,IAAA;AACN,IAAA;AACD,IAAA;AACd,IAAA;AACd,EAAA;AAAA;AAG0D,EAAA;AAC3B,IAAA;AACM,IAAA;AAEL,IAAA;AACa,MAAA;AACD,MAAA;AACV,QAAA;AACW,QAAA;AACL,QAAA;AACtB,QAAA;AACd,MAAA;AACsC,MAAA;AAClB,MAAA;AACV,MAAA;AACoB,QAAA;AAC9B,MAAA;AACF,IAAA;AAEU,IAAA;AACY,MAAA;AACtB,IAAA;AACF,EAAA;AAEyC,EAAA;AACZ,IAAA;AACD,IAAA;AACe,IAAA;AACZ,IAAA;AAC/B,EAAA;AACF;AJiEgD;AACA;AC9JvB;AAYD;AACb,EAAA;AACA,EAAA;AAEQ,EAAA;AAE4B,EAAA;AAEf,IAAA;AACf,IAAA;AACD,MAAA;AACR,QAAA;AACF,MAAA;AACF,IAAA;AAC2B,IAAA;AACzB,MAAA;AAC4B,MAAA;AACR,MAAA;AACH,MAAA;AAClB,IAAA;AAEqC,IAAA;AACI,IAAA;AAC5C,EAAA;AAiBgE,EAAA;AACnB,IAAA;AACd,IAAA;AACjB,IAAA;AAC+B,MAAA;AAC3C,IAAA;AACyC,IAAA;AACL,IAAA;AACtC,EAAA;AACF;ADiIgD;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/greg/Documents/browser-use/core/sdk/browser-use-node/dist/v3.cjs","sourcesContent":[null,"import { z } from \"zod\";\nimport { HttpClient } from \"../core/http.js\";\nimport { Sessions } from \"./resources/sessions.js\";\nimport { Workspaces } from \"./resources/workspaces.js\";\nimport { SessionRun } from \"./helpers.js\";\nimport type { components } from \"../generated/v3/types.js\";\nimport type { RunOptions } from \"./helpers.js\";\n\ntype RunTaskRequest = components[\"schemas\"][\"RunTaskRequest\"];\n\nconst DEFAULT_BASE_URL = \"https://api.browser-use.com/api/v3\";\n\nexport interface BrowserUseOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport type RunSessionOptions = Partial<Omit<RunTaskRequest, \"task\">> &\n  RunOptions & { schema?: z.ZodType };\n\nexport class BrowserUse {\n  readonly sessions: Sessions;\n  readonly workspaces: Workspaces;\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.sessions = new Sessions(this.http);\n    this.workspaces = new Workspaces(this.http);\n  }\n\n  /**\n   * Create a session and run a task. `await` the result for a typed SessionResult.\n   *\n   * ```ts\n   * // Simple — just get the output\n   * const result = await client.run(\"Find the top HN post\");\n   * console.log(result.output);\n   *\n   * // Structured output (Zod)\n   * const result = await client.run(\"Find product info\", { schema: ProductSchema });\n   * console.log(result.output.name); // fully typed\n   * ```\n   */\n  run(task: string, options?: Omit<RunSessionOptions, \"schema\">): SessionRun<string>;\n  run<T extends z.ZodType>(task: string, options: RunSessionOptions & { schema: T }): SessionRun<z.output<T>>;\n  run(task: string, options?: RunSessionOptions): SessionRun<any> {\n    const { schema, timeout, interval, ...rest } = options ?? {};\n    const body = { task, ...rest } as RunTaskRequest;\n    if (schema) {\n      body.outputSchema = z.toJSONSchema(schema) as Record<string, unknown>;\n    }\n    const promise = this.sessions.create(body);\n    return new SessionRun(promise, this.sessions, schema, { timeout, interval });\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v3/types.js\";\n\ntype RunTaskRequest = components[\"schemas\"][\"RunTaskRequest\"];\n/** All fields optional — omit `task` to create an idle session. */\nexport type CreateSessionBody = Partial<RunTaskRequest>;\ntype SessionResponse = components[\"schemas\"][\"SessionResponse\"];\ntype SessionListResponse = components[\"schemas\"][\"SessionListResponse\"];\ntype FileListResponse = components[\"schemas\"][\"FileListResponse\"];\ntype StopSessionRequest = components[\"schemas\"][\"StopSessionRequest\"];\ntype FileUploadRequest = components[\"schemas\"][\"FileUploadRequest\"];\ntype FileUploadResponse = components[\"schemas\"][\"FileUploadResponse\"];\ntype MessageListResponse = components[\"schemas\"][\"MessageListResponse\"];\n\nexport interface SessionListParams {\n  page?: number;\n  page_size?: number;\n}\n\nexport interface SessionFilesParams {\n  prefix?: string;\n  limit?: number;\n  cursor?: string | null;\n  includeUrls?: boolean;\n  shallow?: boolean;\n}\n\nexport interface SessionMessagesParams {\n  after?: string | null;\n  before?: string | null;\n  limit?: number;\n}\n\nexport class Sessions {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a session and optionally dispatch a task. */\n  create(body?: CreateSessionBody): Promise<SessionResponse> {\n    return this.http.post<SessionResponse>(\"/sessions\", body);\n  }\n\n  /** List sessions for the authenticated project. */\n  list(params?: SessionListParams): Promise<SessionListResponse> {\n    return this.http.get<SessionListResponse>(\"/sessions\", params as Record<string, unknown>);\n  }\n\n  /** Get session details. */\n  get(sessionId: string): Promise<SessionResponse> {\n    return this.http.get<SessionResponse>(`/sessions/${sessionId}`);\n  }\n\n  /** Stop a session or the running task. */\n  stop(sessionId: string, body?: StopSessionRequest): Promise<SessionResponse> {\n    return this.http.post<SessionResponse>(`/sessions/${sessionId}/stop`, body);\n  }\n\n  /** Soft-delete a session. */\n  delete(sessionId: string): Promise<void> {\n    return this.http.delete<void>(`/sessions/${sessionId}`);\n  }\n\n  /** Get presigned upload URLs for session files. */\n  uploadFiles(sessionId: string, body: FileUploadRequest): Promise<FileUploadResponse> {\n    return this.http.post<FileUploadResponse>(`/sessions/${sessionId}/files/upload`, body);\n  }\n\n  /** List files in a session's workspace. */\n  files(sessionId: string, params?: SessionFilesParams): Promise<FileListResponse> {\n    return this.http.get<FileListResponse>(\n      `/sessions/${sessionId}/files`,\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** List messages for a session with cursor-based pagination. */\n  messages(sessionId: string, params?: SessionMessagesParams): Promise<MessageListResponse> {\n    return this.http.get<MessageListResponse>(\n      `/sessions/${sessionId}/messages`,\n      params as Record<string, unknown>,\n    );\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v3/types.js\";\n\ntype WorkspaceView = components[\"schemas\"][\"WorkspaceView\"];\ntype WorkspaceListResponse = components[\"schemas\"][\"WorkspaceListResponse\"];\ntype WorkspaceCreateRequest = components[\"schemas\"][\"WorkspaceCreateRequest\"];\ntype WorkspaceUpdateRequest = components[\"schemas\"][\"WorkspaceUpdateRequest\"];\ntype FileListResponse = components[\"schemas\"][\"FileListResponse\"];\ntype FileUploadRequest = components[\"schemas\"][\"FileUploadRequest\"];\ntype FileUploadResponse = components[\"schemas\"][\"FileUploadResponse\"];\n\nexport interface WorkspaceListParams {\n  pageSize?: number;\n  pageNumber?: number;\n}\n\nexport interface WorkspaceFilesParams {\n  prefix?: string;\n  limit?: number;\n  cursor?: string | null;\n  includeUrls?: boolean;\n  shallow?: boolean;\n}\n\nexport class Workspaces {\n  constructor(private readonly http: HttpClient) {}\n\n  /** List workspaces for the authenticated project. */\n  list(params?: WorkspaceListParams): Promise<WorkspaceListResponse> {\n    return this.http.get<WorkspaceListResponse>(\"/workspaces\", params as Record<string, unknown>);\n  }\n\n  /** Create a new workspace. */\n  create(body?: WorkspaceCreateRequest): Promise<WorkspaceView> {\n    return this.http.post<WorkspaceView>(\"/workspaces\", body);\n  }\n\n  /** Get workspace details. */\n  get(workspaceId: string): Promise<WorkspaceView> {\n    return this.http.get<WorkspaceView>(`/workspaces/${workspaceId}`);\n  }\n\n  /** Update a workspace. */\n  update(workspaceId: string, body: WorkspaceUpdateRequest): Promise<WorkspaceView> {\n    return this.http.patch<WorkspaceView>(`/workspaces/${workspaceId}`, body);\n  }\n\n  /** Delete a workspace and its data. */\n  delete(workspaceId: string): Promise<void> {\n    return this.http.delete<void>(`/workspaces/${workspaceId}`);\n  }\n\n  /** List files in a workspace. */\n  files(workspaceId: string, params?: WorkspaceFilesParams): Promise<FileListResponse> {\n    return this.http.get<FileListResponse>(\n      `/workspaces/${workspaceId}/files`,\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get presigned upload URLs for workspace files. */\n  uploadFiles(workspaceId: string, body: FileUploadRequest, query?: { prefix?: string }): Promise<FileUploadResponse> {\n    return this.http.post<FileUploadResponse>(\n      `/workspaces/${workspaceId}/files/upload`,\n      body,\n      query as Record<string, unknown>,\n    );\n  }\n\n  /** Delete a file from a workspace. */\n  deleteFile(workspaceId: string, path: string): Promise<void> {\n    return this.http.delete<void>(`/workspaces/${workspaceId}/files`, { path });\n  }\n\n  /** Get storage usage for a workspace. */\n  size(workspaceId: string): Promise<unknown> {\n    return this.http.get<unknown>(`/workspaces/${workspaceId}/size`);\n  }\n}\n","import type { z } from \"zod\";\nimport type { components } from \"../generated/v3/types.js\";\nimport type { Sessions } from \"./resources/sessions.js\";\n\ntype SessionResponse = components[\"schemas\"][\"SessionResponse\"];\n\nconst TERMINAL_STATUSES = new Set([\"idle\", \"stopped\", \"timed_out\", \"error\"]);\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/** Session result with typed output. All SessionResponse fields are directly accessible. */\nexport type SessionResult<T = string | null> = Omit<SessionResponse, \"output\"> & { output: T };\n\n/**\n * Dual-purpose session handle: `await` it for a typed SessionResult,\n * or access `.result` for the full SessionResult after resolution.\n */\nexport class SessionRun<T = string> implements PromiseLike<SessionResult<T>> {\n  private readonly _createPromise: Promise<SessionResponse>;\n  private readonly _sessions: Sessions;\n  private readonly _schema?: z.ZodType<T>;\n  private readonly _timeout: number;\n  private readonly _interval: number;\n  private _sessionId: string | null = null;\n  private _result: SessionResult<T> | null = null;\n\n  constructor(\n    createPromise: Promise<SessionResponse>,\n    sessions: Sessions,\n    schema?: z.ZodType<T>,\n    options?: RunOptions,\n  ) {\n    this._createPromise = createPromise;\n    this._sessions = sessions;\n    this._schema = schema;\n    this._timeout = options?.timeout ?? 300_000;\n    this._interval = options?.interval ?? 2_000;\n  }\n\n  /** The session ID, available after task creation resolves. */\n  get sessionId(): string | null {\n    return this._sessionId;\n  }\n\n  /** The full SessionResult, available after polling completes. */\n  get result(): SessionResult<T> | null {\n    return this._result;\n  }\n\n  /** Enable `await client.run(...)` — polls until terminal, returns SessionResult. */\n  then<R1 = SessionResult<T>, R2 = never>(\n    onFulfilled?:\n      | ((value: SessionResult<T>) => R1 | PromiseLike<R1>)\n      | null,\n    onRejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null,\n  ): Promise<R1 | R2> {\n    return this._waitForOutput().then(onFulfilled, onRejected);\n  }\n\n  private async _ensureSessionId(): Promise<string> {\n    if (this._sessionId) return this._sessionId;\n    const created = await this._createPromise;\n    this._sessionId = created.id;\n    return this._sessionId;\n  }\n\n  /** Poll session until terminal, return SessionResult. */\n  private async _waitForOutput(): Promise<SessionResult<T>> {\n    const sessionId = await this._ensureSessionId();\n    const deadline = Date.now() + this._timeout;\n\n    while (Date.now() < deadline) {\n      const session = await this._sessions.get(sessionId);\n      if (TERMINAL_STATUSES.has(session.status)) {\n        const { output, ...rest } = session;\n        const parsed = this._parseOutput(output);\n        this._result = { ...rest, output: parsed } as SessionResult<T>;\n        return this._result;\n      }\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) =>\n        setTimeout(r, Math.min(this._interval, remaining)),\n      );\n    }\n\n    throw new Error(\n      `Session ${sessionId} did not complete within ${this._timeout}ms`,\n    );\n  }\n\n  private _parseOutput(output: unknown): T {\n    if (output == null) return null as T;\n    if (!this._schema) return output as unknown as T;\n    const raw = typeof output === \"string\" ? JSON.parse(output) : output;\n    return this._schema.parse(raw);\n  }\n}\n"]}
+{"version":3,"sources":["/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/v3.cjs","../src/v3/client.ts","../src/v3/resources/sessions.ts","../src/v3/resources/workspaces.ts","../src/v3/helpers.ts"],"names":[],"mappings":"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","file":"/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/v3.cjs","sourcesContent":[null,"import { z } from \"zod\";\nimport { HttpClient } from \"../core/http.js\";\nimport { Sessions } from \"./resources/sessions.js\";\nimport { Workspaces } from \"./resources/workspaces.js\";\nimport { SessionRun } from \"./helpers.js\";\nimport type { components } from \"../generated/v3/types.js\";\nimport type { RunOptions } from \"./helpers.js\";\n\ntype RunTaskRequest = components[\"schemas\"][\"RunTaskRequest\"];\n\nconst DEFAULT_BASE_URL = \"https://api.browser-use.com/api/v3\";\n\nexport interface BrowserUseOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport type RunSessionOptions = Partial<Omit<RunTaskRequest, \"task\">> &\n  RunOptions & { schema?: z.ZodType };\n\nexport class BrowserUse {\n  readonly sessions: Sessions;\n  readonly workspaces: Workspaces;\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.sessions = new Sessions(this.http);\n    this.workspaces = new Workspaces(this.http);\n  }\n\n  /**\n   * Create a session and run a task. `await` the result for a typed SessionResult.\n   *\n   * ```ts\n   * // Simple — just get the output\n   * const result = await client.run(\"Find the top HN post\");\n   * console.log(result.output);\n   *\n   * // Structured output (Zod)\n   * const result = await client.run(\"Find product info\", { schema: ProductSchema });\n   * console.log(result.output.name); // fully typed\n   * ```\n   */\n  run(task: string, options?: Omit<RunSessionOptions, \"schema\">): SessionRun<string>;\n  run<T extends z.ZodType>(task: string, options: RunSessionOptions & { schema: T }): SessionRun<z.output<T>>;\n  run(task: string, options?: RunSessionOptions): SessionRun<any> {\n    const { schema, timeout, interval, ...rest } = options ?? {};\n    const body = { task, ...rest } as RunTaskRequest;\n    if (schema) {\n      body.outputSchema = z.toJSONSchema(schema) as Record<string, unknown>;\n    }\n    const promise = this.sessions.create(body);\n    return new SessionRun(promise, this.sessions, schema, { timeout, interval });\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v3/types.js\";\n\ntype RunTaskRequest = components[\"schemas\"][\"RunTaskRequest\"];\n/** All fields optional — omit `task` to create an idle session. */\nexport type CreateSessionBody = Partial<RunTaskRequest>;\ntype SessionResponse = components[\"schemas\"][\"SessionResponse\"];\ntype SessionListResponse = components[\"schemas\"][\"SessionListResponse\"];\ntype FileListResponse = components[\"schemas\"][\"FileListResponse\"];\ntype StopSessionRequest = components[\"schemas\"][\"StopSessionRequest\"];\ntype FileUploadRequest = components[\"schemas\"][\"FileUploadRequest\"];\ntype FileUploadResponse = components[\"schemas\"][\"FileUploadResponse\"];\ntype MessageListResponse = components[\"schemas\"][\"MessageListResponse\"];\n\nexport interface SessionListParams {\n  page?: number;\n  page_size?: number;\n}\n\nexport interface SessionFilesParams {\n  prefix?: string;\n  limit?: number;\n  cursor?: string | null;\n  includeUrls?: boolean;\n  shallow?: boolean;\n}\n\nexport interface SessionMessagesParams {\n  after?: string | null;\n  before?: string | null;\n  limit?: number;\n}\n\nexport class Sessions {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a session and optionally dispatch a task. */\n  create(body?: CreateSessionBody): Promise<SessionResponse> {\n    return this.http.post<SessionResponse>(\"/sessions\", body);\n  }\n\n  /** List sessions for the authenticated project. */\n  list(params?: SessionListParams): Promise<SessionListResponse> {\n    return this.http.get<SessionListResponse>(\"/sessions\", params as Record<string, unknown>);\n  }\n\n  /** Get session details. */\n  get(sessionId: string): Promise<SessionResponse> {\n    return this.http.get<SessionResponse>(`/sessions/${sessionId}`);\n  }\n\n  /** Stop a session or the running task. */\n  stop(sessionId: string, body?: StopSessionRequest): Promise<SessionResponse> {\n    return this.http.post<SessionResponse>(`/sessions/${sessionId}/stop`, body);\n  }\n\n  /** Soft-delete a session. */\n  delete(sessionId: string): Promise<void> {\n    return this.http.delete<void>(`/sessions/${sessionId}`);\n  }\n\n  /** Get presigned upload URLs for session files. */\n  uploadFiles(sessionId: string, body: FileUploadRequest): Promise<FileUploadResponse> {\n    return this.http.post<FileUploadResponse>(`/sessions/${sessionId}/files/upload`, body);\n  }\n\n  /** List files in a session's workspace. */\n  files(sessionId: string, params?: SessionFilesParams): Promise<FileListResponse> {\n    return this.http.get<FileListResponse>(\n      `/sessions/${sessionId}/files`,\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** List messages for a session with cursor-based pagination. */\n  messages(sessionId: string, params?: SessionMessagesParams): Promise<MessageListResponse> {\n    return this.http.get<MessageListResponse>(\n      `/sessions/${sessionId}/messages`,\n      params as Record<string, unknown>,\n    );\n  }\n}\n","import type { HttpClient } from \"../../core/http.js\";\nimport type { components } from \"../../generated/v3/types.js\";\n\ntype WorkspaceView = components[\"schemas\"][\"WorkspaceView\"];\ntype WorkspaceListResponse = components[\"schemas\"][\"WorkspaceListResponse\"];\ntype WorkspaceCreateRequest = components[\"schemas\"][\"WorkspaceCreateRequest\"];\ntype WorkspaceUpdateRequest = components[\"schemas\"][\"WorkspaceUpdateRequest\"];\ntype FileListResponse = components[\"schemas\"][\"FileListResponse\"];\ntype FileUploadRequest = components[\"schemas\"][\"FileUploadRequest\"];\ntype FileUploadResponse = components[\"schemas\"][\"FileUploadResponse\"];\n\nexport interface WorkspaceListParams {\n  pageSize?: number;\n  pageNumber?: number;\n}\n\nexport interface WorkspaceFilesParams {\n  prefix?: string;\n  limit?: number;\n  cursor?: string | null;\n  includeUrls?: boolean;\n  shallow?: boolean;\n}\n\nexport class Workspaces {\n  constructor(private readonly http: HttpClient) {}\n\n  /** List workspaces for the authenticated project. */\n  list(params?: WorkspaceListParams): Promise<WorkspaceListResponse> {\n    return this.http.get<WorkspaceListResponse>(\"/workspaces\", params as Record<string, unknown>);\n  }\n\n  /** Create a new workspace. */\n  create(body?: WorkspaceCreateRequest): Promise<WorkspaceView> {\n    return this.http.post<WorkspaceView>(\"/workspaces\", body);\n  }\n\n  /** Get workspace details. */\n  get(workspaceId: string): Promise<WorkspaceView> {\n    return this.http.get<WorkspaceView>(`/workspaces/${workspaceId}`);\n  }\n\n  /** Update a workspace. */\n  update(workspaceId: string, body: WorkspaceUpdateRequest): Promise<WorkspaceView> {\n    return this.http.patch<WorkspaceView>(`/workspaces/${workspaceId}`, body);\n  }\n\n  /** Delete a workspace and its data. */\n  delete(workspaceId: string): Promise<void> {\n    return this.http.delete<void>(`/workspaces/${workspaceId}`);\n  }\n\n  /** List files in a workspace. */\n  files(workspaceId: string, params?: WorkspaceFilesParams): Promise<FileListResponse> {\n    return this.http.get<FileListResponse>(\n      `/workspaces/${workspaceId}/files`,\n      params as Record<string, unknown>,\n    );\n  }\n\n  /** Get presigned upload URLs for workspace files. */\n  uploadFiles(workspaceId: string, body: FileUploadRequest, query?: { prefix?: string }): Promise<FileUploadResponse> {\n    return this.http.post<FileUploadResponse>(\n      `/workspaces/${workspaceId}/files/upload`,\n      body,\n      query as Record<string, unknown>,\n    );\n  }\n\n  /** Delete a file from a workspace. */\n  deleteFile(workspaceId: string, path: string): Promise<void> {\n    return this.http.delete<void>(`/workspaces/${workspaceId}/files`, { path });\n  }\n\n  /** Get storage usage for a workspace. */\n  size(workspaceId: string): Promise<unknown> {\n    return this.http.get<unknown>(`/workspaces/${workspaceId}/size`);\n  }\n}\n","import type { z } from \"zod\";\nimport type { components } from \"../generated/v3/types.js\";\nimport type { Sessions } from \"./resources/sessions.js\";\n\ntype SessionResponse = components[\"schemas\"][\"SessionResponse\"];\n\nconst TERMINAL_STATUSES = new Set([\"idle\", \"stopped\", \"timed_out\", \"error\"]);\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/** Session result with typed output. All SessionResponse fields are directly accessible. */\nexport type SessionResult<T = string | null> = Omit<SessionResponse, \"output\"> & { output: T };\n\n/**\n * Dual-purpose session handle: `await` it for a typed SessionResult,\n * or access `.result` for the full SessionResult after resolution.\n */\nexport class SessionRun<T = string> implements PromiseLike<SessionResult<T>> {\n  private readonly _createPromise: Promise<SessionResponse>;\n  private readonly _sessions: Sessions;\n  private readonly _schema?: z.ZodType<T>;\n  private readonly _timeout: number;\n  private readonly _interval: number;\n  private _sessionId: string | null = null;\n  private _result: SessionResult<T> | null = null;\n\n  constructor(\n    createPromise: Promise<SessionResponse>,\n    sessions: Sessions,\n    schema?: z.ZodType<T>,\n    options?: RunOptions,\n  ) {\n    this._createPromise = createPromise;\n    this._sessions = sessions;\n    this._schema = schema;\n    this._timeout = options?.timeout ?? 300_000;\n    this._interval = options?.interval ?? 2_000;\n  }\n\n  /** The session ID, available after task creation resolves. */\n  get sessionId(): string | null {\n    return this._sessionId;\n  }\n\n  /** The full SessionResult, available after polling completes. */\n  get result(): SessionResult<T> | null {\n    return this._result;\n  }\n\n  /** Enable `await client.run(...)` — polls until terminal, returns SessionResult. */\n  then<R1 = SessionResult<T>, R2 = never>(\n    onFulfilled?:\n      | ((value: SessionResult<T>) => R1 | PromiseLike<R1>)\n      | null,\n    onRejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null,\n  ): Promise<R1 | R2> {\n    return this._waitForOutput().then(onFulfilled, onRejected);\n  }\n\n  private async _ensureSessionId(): Promise<string> {\n    if (this._sessionId) return this._sessionId;\n    const created = await this._createPromise;\n    this._sessionId = created.id;\n    return this._sessionId;\n  }\n\n  /** Poll session until terminal, return SessionResult. */\n  private async _waitForOutput(): Promise<SessionResult<T>> {\n    const sessionId = await this._ensureSessionId();\n    const deadline = Date.now() + this._timeout;\n\n    while (Date.now() < deadline) {\n      const session = await this._sessions.get(sessionId);\n      if (TERMINAL_STATUSES.has(session.status)) {\n        const { output, ...rest } = session;\n        const parsed = this._parseOutput(output);\n        this._result = { ...rest, output: parsed } as SessionResult<T>;\n        return this._result;\n      }\n      const remaining = deadline - Date.now();\n      if (remaining <= 0) break;\n      await new Promise((r) =>\n        setTimeout(r, Math.min(this._interval, remaining)),\n      );\n    }\n\n    throw new Error(\n      `Session ${sessionId} did not complete within ${this._timeout}ms`,\n    );\n  }\n\n  private _parseOutput(output: unknown): T {\n    if (output == null) return null as T;\n    if (!this._schema) return output as unknown as T;\n    const raw = typeof output === \"string\" ? JSON.parse(output) : output;\n    return this._schema.parse(raw);\n  }\n}\n"]}

package/dist/v3.d.cts

@@ -132,8 +132,18 @@ interface components {
             role: string;
             /** Data */
             data: string;
-            /** Hidden */
-            hidden: boolean;
+            /**
+             * Type
+             * @description Coarse category: user_message, assistant_message, browser_action, file_operation, code_execution, integration, planning, completion, browser_action_result, browser_action_error, etc.
+             * @default
+             */
+            type: string;
+            /**
+             * Summary
+             * @description One-liner human-readable description of the message (e.g. "Navigating to google.com", "Clicking element #5").
+             * @default
+             */
+            summary: string;
             /**
              * Createdat
              * Format: date-time
@@ -172,11 +182,22 @@ interface components {
             profileId?: string | null;
             /** Workspaceid */
             workspaceId?: string | null;
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            /** @default us */
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /** Outputschema */
             outputSchema?: {
                 [key: string]: unknown;
             } | null;
+            /**
+             * Enablescheduledtasks
+             * @default false
+             */
+            enableScheduledTasks: boolean;
+            /**
+             * Enablerecording
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /** SessionListResponse */
         SessionListResponse: {
@@ -206,8 +227,19 @@ interface components {
             outputSchema?: {
                 [key: string]: unknown;
             } | null;
+            /**
+             * Stepcount
+             * @default 0
+             */
+            stepCount: number;
+            /** Laststepsummary */
+            lastStepSummary?: string | null;
+            /** Istasksuccessful */
+            isTaskSuccessful?: boolean | null;
             /** Liveurl */
             liveUrl?: string | null;
+            /** Recordingurl */
+            recordingUrl?: string | null;
             /** Profileid */
             profileId?: string | null;
             /** Workspaceid */
@@ -240,6 +272,11 @@ interface components {
              * @default 0
              */
             proxyCostUsd: string;
+            /**
+             * Browsercostusd
+             * @default 0
+             */
+            browserCostUsd: string;
             /**
              * Totalcostusd
              * @default 0

package/dist/v3.d.ts

@@ -132,8 +132,18 @@ interface components {
             role: string;
             /** Data */
             data: string;
-            /** Hidden */
-            hidden: boolean;
+            /**
+             * Type
+             * @description Coarse category: user_message, assistant_message, browser_action, file_operation, code_execution, integration, planning, completion, browser_action_result, browser_action_error, etc.
+             * @default
+             */
+            type: string;
+            /**
+             * Summary
+             * @description One-liner human-readable description of the message (e.g. "Navigating to google.com", "Clicking element #5").
+             * @default
+             */
+            summary: string;
             /**
              * Createdat
              * Format: date-time
@@ -172,11 +182,22 @@ interface components {
             profileId?: string | null;
             /** Workspaceid */
             workspaceId?: string | null;
-            proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
+            /** @default us */
+            proxyCountryCode: components["schemas"]["ProxyCountryCode"] | null;
             /** Outputschema */
             outputSchema?: {
                 [key: string]: unknown;
             } | null;
+            /**
+             * Enablescheduledtasks
+             * @default false
+             */
+            enableScheduledTasks: boolean;
+            /**
+             * Enablerecording
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /** SessionListResponse */
         SessionListResponse: {
@@ -206,8 +227,19 @@ interface components {
             outputSchema?: {
                 [key: string]: unknown;
             } | null;
+            /**
+             * Stepcount
+             * @default 0
+             */
+            stepCount: number;
+            /** Laststepsummary */
+            lastStepSummary?: string | null;
+            /** Istasksuccessful */
+            isTaskSuccessful?: boolean | null;
             /** Liveurl */
             liveUrl?: string | null;
+            /** Recordingurl */
+            recordingUrl?: string | null;
             /** Profileid */
             profileId?: string | null;
             /** Workspaceid */
@@ -240,6 +272,11 @@ interface components {
              * @default 0
              */
             proxyCostUsd: string;
+            /**
+             * Browsercostusd
+             * @default 0
+             */
+            browserCostUsd: string;
             /**
              * Totalcostusd
              * @default 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-use-sdk",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "description": "Official TypeScript SDK for the Browser Use API",
   "author": "Browser Use",
   "license": "MIT",