browser-use-sdk 2.0.15 → 3.0.2

package/dist/index.cjs

@@ -0,0 +1,428 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;
+
+
+var _chunkRIRVOEIUcjs = require('./chunk-RIRVOEIU.cjs');
+
+// src/v2/client.ts
+var _zod = require('zod');
+
+// src/v2/resources/billing.ts
+var Billing = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Get authenticated account billing information including credit balance. */
+  account() {
+    return this.http.get("/billing/account");
+  }
+};
+
+// src/v2/resources/browsers.ts
+var Browsers = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Create a new browser session. */
+  create(body = {}) {
+    return this.http.post("/browsers", body);
+  }
+  /** List browser sessions with optional filtering. */
+  list(params) {
+    return this.http.get(
+      "/browsers",
+      params
+    );
+  }
+  /** Get detailed browser session information. */
+  get(sessionId) {
+    return this.http.get(`/browsers/${sessionId}`);
+  }
+  /** Update a browser session (generic PATCH). */
+  update(sessionId, body) {
+    return this.http.patch(`/browsers/${sessionId}`, body);
+  }
+  /** Stop a browser session. */
+  stop(sessionId) {
+    return this.update(sessionId, { action: "stop" });
+  }
+};
+
+// src/v2/resources/files.ts
+var Files = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Generate a presigned URL for uploading files to an agent session. */
+  sessionUrl(sessionId, body) {
+    return this.http.post(
+      `/files/sessions/${sessionId}/presigned-url`,
+      body
+    );
+  }
+  /** Generate a presigned URL for uploading files to a browser session. */
+  browserUrl(sessionId, body) {
+    return this.http.post(
+      `/files/browsers/${sessionId}/presigned-url`,
+      body
+    );
+  }
+  /** Get secure download URL for a task output file. */
+  taskOutput(taskId, fileId) {
+    return this.http.get(
+      `/files/tasks/${taskId}/output-files/${fileId}`
+    );
+  }
+};
+
+// src/v2/resources/marketplace.ts
+var Marketplace = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List all public skills in the marketplace. */
+  list(params) {
+    return this.http.get(
+      "/marketplace/skills",
+      params
+    );
+  }
+  /** Get details of a specific marketplace skill by slug. */
+  get(skillSlug) {
+    return this.http.get(`/marketplace/skills/${skillSlug}`);
+  }
+  /** Clone a public marketplace skill to your project. */
+  clone(skillId) {
+    return this.http.post(`/marketplace/skills/${skillId}/clone`);
+  }
+  /** Execute a marketplace skill. */
+  execute(skillId, body) {
+    return this.http.post(
+      `/marketplace/skills/${skillId}/execute`,
+      body
+    );
+  }
+};
+
+// src/v2/resources/profiles.ts
+var Profiles = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Create a new browser profile. */
+  create(body) {
+    return this.http.post("/profiles", body);
+  }
+  /** List profiles with pagination. */
+  list(params) {
+    return this.http.get("/profiles", params);
+  }
+  /** Get profile details. */
+  get(profileId) {
+    return this.http.get(`/profiles/${profileId}`);
+  }
+  /** Update a browser profile. */
+  update(profileId, body) {
+    return this.http.patch(`/profiles/${profileId}`, body);
+  }
+  /** Delete a browser profile. */
+  delete(profileId) {
+    return this.http.delete(`/profiles/${profileId}`);
+  }
+};
+
+// src/v2/resources/sessions.ts
+var Sessions = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Create a new session. */
+  create(body) {
+    return this.http.post("/sessions", body);
+  }
+  /** List sessions with optional filtering. */
+  list(params) {
+    return this.http.get("/sessions", params);
+  }
+  /** Get detailed session information. */
+  get(sessionId) {
+    return this.http.get(`/sessions/${sessionId}`);
+  }
+  /** Update a session (generic PATCH). */
+  update(sessionId, body) {
+    return this.http.patch(`/sessions/${sessionId}`, body);
+  }
+  /** Stop a session and all its running tasks. */
+  stop(sessionId) {
+    return this.update(sessionId, { action: "stop" });
+  }
+  /** Delete a session with all its tasks. */
+  delete(sessionId) {
+    return this.http.delete(`/sessions/${sessionId}`);
+  }
+  /** Get public share information for a session. */
+  getShare(sessionId) {
+    return this.http.get(`/sessions/${sessionId}/public-share`);
+  }
+  /** Create or return existing public share for a session. */
+  createShare(sessionId) {
+    return this.http.post(`/sessions/${sessionId}/public-share`);
+  }
+  /** Remove public share for a session. */
+  deleteShare(sessionId) {
+    return this.http.delete(`/sessions/${sessionId}/public-share`);
+  }
+};
+
+// src/v2/resources/skills.ts
+var Skills = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Create a new skill via automated generation. */
+  create(body) {
+    return this.http.post("/skills", body);
+  }
+  /** List all skills owned by the project. */
+  list(params) {
+    return this.http.get("/skills", params);
+  }
+  /** Get details of a specific skill. */
+  get(skillId) {
+    return this.http.get(`/skills/${skillId}`);
+  }
+  /** Delete a skill. */
+  delete(skillId) {
+    return this.http.delete(`/skills/${skillId}`);
+  }
+  /** Update skill metadata. */
+  update(skillId, body) {
+    return this.http.patch(`/skills/${skillId}`, body);
+  }
+  /** Cancel the current in-progress generation for a skill. */
+  cancel(skillId) {
+    return this.http.post(`/skills/${skillId}/cancel`);
+  }
+  /** Execute a skill with the provided parameters. */
+  execute(skillId, body) {
+    return this.http.post(`/skills/${skillId}/execute`, body);
+  }
+  /** Refine a skill based on feedback. */
+  refine(skillId, body) {
+    return this.http.post(`/skills/${skillId}/refine`, body);
+  }
+  /** Rollback to the previous version. */
+  rollback(skillId) {
+    return this.http.post(`/skills/${skillId}/rollback`);
+  }
+  /** List executions for a specific skill. */
+  executions(skillId, params) {
+    return this.http.get(
+      `/skills/${skillId}/executions`,
+      params
+    );
+  }
+  /** Get presigned URL for downloading skill execution output. */
+  executionOutput(skillId, executionId) {
+    return this.http.get(
+      `/skills/${skillId}/executions/${executionId}/output`
+    );
+  }
+};
+
+// src/v2/helpers.ts
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["finished", "stopped"]);
+var TaskRun = (_class = class {
+  
+  
+  
+  
+  
+  __init() {this._taskId = null}
+  __init2() {this._result = null}
+  constructor(createPromise, tasks, schema, options) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);
+    this._createPromise = createPromise;
+    this._tasks = tasks;
+    this._schema = schema;
+    this._timeout = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.timeout]), () => ( 3e5));
+    this._interval = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _2 => _2.interval]), () => ( 2e3));
+  }
+  /** Task ID (available after creation resolves). */
+  get taskId() {
+    return this._taskId;
+  }
+  /** Full task result (available after awaiting or iterating to completion). */
+  get result() {
+    return this._result;
+  }
+  /** Enable `await client.run(...)` — polls status endpoint, returns TaskResult. */
+  then(onFulfilled, onRejected) {
+    return this._waitForOutput().then(onFulfilled, onRejected);
+  }
+  /** Enable `for await (const step of client.run(...))` — polls full task, yields new steps. */
+  async *[Symbol.asyncIterator]() {
+    const taskId = await this._ensureTaskId();
+    let seen = 0;
+    const deadline = Date.now() + this._timeout;
+    while (Date.now() < deadline) {
+      const task = await this._tasks.get(taskId);
+      for (let i = seen; i < task.steps.length; i++) {
+        yield task.steps[i];
+      }
+      seen = task.steps.length;
+      if (TERMINAL_STATUSES.has(task.status)) {
+        this._result = this._buildResult(task);
+        return;
+      }
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) break;
+      await new Promise((r) => setTimeout(r, Math.min(this._interval, remaining)));
+    }
+    throw new Error(`Task ${taskId} did not complete within ${this._timeout}ms`);
+  }
+  async _ensureTaskId() {
+    if (this._taskId) return this._taskId;
+    const created = await this._createPromise;
+    this._taskId = created.id;
+    return this._taskId;
+  }
+  /** Poll lightweight status endpoint until terminal, return TaskResult. */
+  async _waitForOutput() {
+    const taskId = await this._ensureTaskId();
+    const deadline = Date.now() + this._timeout;
+    while (Date.now() < deadline) {
+      const status = await this._tasks.status(taskId);
+      if (TERMINAL_STATUSES.has(status.status)) {
+        const task = await this._tasks.get(taskId);
+        this._result = this._buildResult(task);
+        return this._result;
+      }
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) break;
+      await new Promise((r) => setTimeout(r, Math.min(this._interval, remaining)));
+    }
+    throw new Error(`Task ${taskId} did not complete within ${this._timeout}ms`);
+  }
+  _buildResult(task) {
+    const output = this._parseOutput(task.output);
+    return { ...task, output };
+  }
+  _parseOutput(output) {
+    if (output == null) return null;
+    if (!this._schema) return output;
+    return this._schema.parse(JSON.parse(output));
+  }
+}, _class);
+
+// src/v2/resources/tasks.ts
+var Tasks = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Create and start a new AI agent task. */
+  create(body) {
+    return this.http.post("/tasks", body);
+  }
+  /** List tasks with optional filtering. */
+  list(params) {
+    return this.http.get("/tasks", params);
+  }
+  /** Get detailed task information. */
+  get(taskId) {
+    return this.http.get(`/tasks/${taskId}`);
+  }
+  /** Update a task (generic PATCH). */
+  update(taskId, body) {
+    return this.http.patch(`/tasks/${taskId}`, body);
+  }
+  /** Stop a running task. */
+  stop(taskId) {
+    return this.update(taskId, { action: "stop" });
+  }
+  /** Stop a running task and its associated browser session. */
+  stopTaskAndSession(taskId) {
+    return this.update(taskId, { action: "stop_task_and_session" });
+  }
+  /** Get lightweight task status (optimized for polling). */
+  status(taskId) {
+    return this.http.get(`/tasks/${taskId}/status`);
+  }
+  /** Get secure download URL for task execution logs. */
+  logs(taskId) {
+    return this.http.get(`/tasks/${taskId}/logs`);
+  }
+  /** Poll until a task reaches a terminal status, then return the full TaskView. */
+  async wait(taskId, opts) {
+    const timeout = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _3 => _3.timeout]), () => ( 3e5));
+    const interval = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _4 => _4.interval]), () => ( 2e3));
+    const deadline = Date.now() + timeout;
+    while (Date.now() < deadline) {
+      const status = await this.status(taskId);
+      if (TERMINAL_STATUSES.has(status.status)) {
+        return this.get(taskId);
+      }
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) break;
+      await new Promise((r) => setTimeout(r, Math.min(interval, remaining)));
+    }
+    throw new Error(`Task ${taskId} did not complete within ${timeout}ms`);
+  }
+};
+
+// src/v2/client.ts
+var DEFAULT_BASE_URL = "https://api.browser-use.com/api/v2";
+var BrowserUse = class {
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  constructor(options = {}) {
+    const apiKey = _nullishCoalesce(_nullishCoalesce(options.apiKey, () => ( process.env.BROWSER_USE_API_KEY)), () => ( ""));
+    if (!apiKey) {
+      throw new Error(
+        "No API key provided. Pass apiKey or set BROWSER_USE_API_KEY."
+      );
+    }
+    this.http = new (0, _chunkRIRVOEIUcjs.HttpClient)({
+      apiKey,
+      baseUrl: _nullishCoalesce(options.baseUrl, () => ( DEFAULT_BASE_URL)),
+      maxRetries: options.maxRetries,
+      timeout: options.timeout
+    });
+    this.billing = new Billing(this.http);
+    this.tasks = new Tasks(this.http);
+    this.sessions = new Sessions(this.http);
+    this.files = new Files(this.http);
+    this.profiles = new Profiles(this.http);
+    this.browsers = new Browsers(this.http);
+    this.skills = new Skills(this.http);
+    this.marketplace = new Marketplace(this.http);
+  }
+  run(task, options) {
+    const { schema, timeout, interval, ...rest } = _nullishCoalesce(options, () => ( {}));
+    const body = { task, ...rest };
+    if (schema) {
+      body.structuredOutput = JSON.stringify(_zod.z.toJSONSchema(schema));
+    }
+    const promise = this.tasks.create(body);
+    return new TaskRun(promise, this.tasks, schema, { timeout, interval });
+  }
+};
+
+
+
+
+
+
+
+
+
+
+
+
+exports.Billing = Billing; exports.BrowserUse = BrowserUse; exports.BrowserUseError = _chunkRIRVOEIUcjs.BrowserUseError; exports.Browsers = Browsers; exports.Files = Files; exports.Marketplace = Marketplace; exports.Profiles = Profiles; exports.Sessions = Sessions; exports.Skills = Skills; exports.TaskRun = TaskRun; exports.Tasks = Tasks;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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","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"]}