browser-use-sdk 3.1.0 → 3.3.0

package/dist/index.d.cts

@@ -118,6 +118,16 @@ interface components {
              * @default 0
              */
             browserCost: string;
+            /**
+             * Agent Session ID
+             * @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
@@ -225,6 +235,16 @@ interface components {
              * @default 0
              */
             browserCost: string;
+            /**
+             * Agent Session ID
+             * @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
@@ -301,6 +321,12 @@ interface components {
              * @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.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSessionRequest
@@ -349,6 +375,12 @@ interface components {
              * @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.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSkillRequest
@@ -1015,6 +1047,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
@@ -1112,6 +1149,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
@@ -1175,6 +1218,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

package/dist/index.d.ts

@@ -118,6 +118,16 @@ interface components {
              * @default 0
              */
             browserCost: string;
+            /**
+             * Agent Session ID
+             * @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
@@ -225,6 +235,16 @@ interface components {
              * @default 0
              */
             browserCost: string;
+            /**
+             * Agent Session ID
+             * @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
@@ -301,6 +321,12 @@ interface components {
              * @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.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSessionRequest
@@ -349,6 +375,12 @@ interface components {
              * @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.
              */
             customProxy?: components["schemas"]["CustomProxy"] | null;
+            /**
+             * Enable Recording
+             * @description If True, enables session recording. Defaults to False.
+             * @default false
+             */
+            enableRecording: boolean;
         };
         /**
          * CreateSkillRequest
@@ -1015,6 +1047,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
@@ -1112,6 +1149,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
@@ -1175,6 +1218,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

package/dist/v3.cjs

@@ -42,6 +42,63 @@ var Sessions = class {
       params
     );
   }
+  /** List messages for a session with cursor-based pagination. */
+  messages(sessionId, params) {
+    return this.http.get(
+      `/sessions/${sessionId}/messages`,
+      params
+    );
+  }
+};
+
+// src/v3/resources/workspaces.ts
+var Workspaces = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List workspaces for the authenticated project. */
+  list(params) {
+    return this.http.get("/workspaces", params);
+  }
+  /** Create a new workspace. */
+  create(body) {
+    return this.http.post("/workspaces", body);
+  }
+  /** Get workspace details. */
+  get(workspaceId) {
+    return this.http.get(`/workspaces/${workspaceId}`);
+  }
+  /** Update a workspace. */
+  update(workspaceId, body) {
+    return this.http.patch(`/workspaces/${workspaceId}`, body);
+  }
+  /** Delete a workspace and its data. */
+  delete(workspaceId) {
+    return this.http.delete(`/workspaces/${workspaceId}`);
+  }
+  /** List files in a workspace. */
+  files(workspaceId, params) {
+    return this.http.get(
+      `/workspaces/${workspaceId}/files`,
+      params
+    );
+  }
+  /** Get presigned upload URLs for workspace files. */
+  uploadFiles(workspaceId, body, query) {
+    return this.http.post(
+      `/workspaces/${workspaceId}/files/upload`,
+      body,
+      query
+    );
+  }
+  /** Delete a file from a workspace. */
+  deleteFile(workspaceId, path) {
+    return this.http.delete(`/workspaces/${workspaceId}/files`, { path });
+  }
+  /** Get storage usage for a workspace. */
+  size(workspaceId) {
+    return this.http.get(`/workspaces/${workspaceId}/size`);
+  }
 };
 
 // src/v3/helpers.ts
@@ -114,6 +171,7 @@ var DEFAULT_BASE_URL = "https://api.browser-use.com/api/v3";
 var BrowserUse = class {
   
   
+  
   constructor(options = {}) {
     const apiKey = _nullishCoalesce(_nullishCoalesce(options.apiKey, () => ( process.env.BROWSER_USE_API_KEY)), () => ( ""));
     if (!apiKey) {
@@ -128,6 +186,7 @@ var BrowserUse = class {
       timeout: options.timeout
     });
     this.sessions = new Sessions(this.http);
+    this.workspaces = new Workspaces(this.http);
   }
   run(task, options) {
     const { schema, timeout, interval, ...rest } = _nullishCoalesce(options, () => ( {}));
@@ -144,5 +203,6 @@ var BrowserUse = class {
 
 
 
-exports.BrowserUse = BrowserUse; exports.BrowserUseError = _chunkRIRVOEIUcjs.BrowserUseError; exports.SessionRun = SessionRun; exports.Sessions = Sessions;
+
+exports.BrowserUse = BrowserUse; exports.BrowserUseError = _chunkRIRVOEIUcjs.BrowserUseError; exports.SessionRun = SessionRun; exports.Sessions = Sessions; exports.Workspaces = Workspaces;
 //# sourceMappingURL=v3.cjs.map

package/dist/v3.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/larsencundric/Documents/browser-use/sdk/browser-use-node/dist/v3.cjs","../src/v3/client.ts","../src/v3/resources/sessions.ts","../src/v3/helpers.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACLA,0BAAkB;ADOlB;AACA;AEiBO,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;AACF;AFpBgD;AACA;AGxCd;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;AHQgD;AACA;ACtGvB;AAYD;AACb,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;AACxC,EAAA;AAiBgE,EAAA;AACnB,IAAA;AACd,IAAA;AACjB,IAAA;AAC+B,MAAA;AAC3C,IAAA;AACyC,IAAA;AACL,IAAA;AACtC,EAAA;AACF;ADyEgD;AACA;AACA;AACA;AACA;AACA","file":"/Users/larsencundric/Documents/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 { 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\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  }\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\"];\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}\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","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/larsencundric/Documents/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/larsencundric/Documents/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

@@ -38,6 +38,11 @@ interface components {
         FileListResponse: {
             /** Files */
             files: components["schemas"]["FileInfo"][];
+            /**
+             * Folders
+             * @description Immediate sub-folder names at this prefix level
+             */
+            folders?: string[];
             /** Nextcursor */
             nextCursor?: string | null;
             /**
@@ -62,6 +67,11 @@ interface components {
              * @default application/octet-stream
              */
             contentType: string;
+            /**
+             * Size
+             * @description File size in bytes (required for workspace uploads)
+             */
+            size?: number | null;
         };
         /**
          * FileUploadRequest
@@ -99,6 +109,35 @@ interface components {
             /** Detail */
             detail?: components["schemas"]["ValidationError"][];
         };
+        /** MessageListResponse */
+        MessageListResponse: {
+            /** Messages */
+            messages: components["schemas"]["MessageResponse"][];
+            /** Hasmore */
+            hasMore: boolean;
+        };
+        /** MessageResponse */
+        MessageResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Sessionid
+             * Format: uuid
+             */
+            sessionId: string;
+            /** Role */
+            role: string;
+            /** Data */
+            data: string;
+            /**
+             * Createdat
+             * Format: date-time
+             */
+            createdAt: string;
+        };
         /**
          * ProxyCountryCode
          * @enum {string}
@@ -129,6 +168,8 @@ interface components {
             maxCostUsd?: number | string | null;
             /** Profileid */
             profileId?: string | null;
+            /** Workspaceid */
+            workspaceId?: string | null;
             proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
             /** Outputschema */
             outputSchema?: {
@@ -159,10 +200,16 @@ interface components {
             title?: string | null;
             /** Output */
             output?: unknown | null;
+            /** Outputschema */
+            outputSchema?: {
+                [key: string]: unknown;
+            } | null;
             /** Liveurl */
             liveUrl?: string | null;
             /** Profileid */
             profileId?: string | null;
+            /** Workspaceid */
+            workspaceId?: string | null;
             proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
             /** Maxcostusd */
             maxCostUsd?: string | null;
@@ -226,6 +273,83 @@ interface components {
             /** Error Type */
             type: string;
         };
+        /**
+         * WorkspaceCreateRequest
+         * @description Request model for creating a new workspace.
+         */
+        WorkspaceCreateRequest: {
+            /**
+             * Name
+             * @description Optional name for the workspace
+             */
+            name?: string | null;
+        };
+        /**
+         * WorkspaceListResponse
+         * @description Response model for paginated workspace list requests.
+         */
+        WorkspaceListResponse: {
+            /**
+             * Items
+             * @description List of workspace views for the current page
+             */
+            items: components["schemas"]["WorkspaceView"][];
+            /**
+             * Total Items
+             * @description Total number of items in the list
+             */
+            totalItems: number;
+            /**
+             * Page Number
+             * @description Page number
+             */
+            pageNumber: number;
+            /**
+             * Page Size
+             * @description Number of items per page
+             */
+            pageSize: number;
+        };
+        /**
+         * WorkspaceUpdateRequest
+         * @description Request model for updating a workspace.
+         */
+        WorkspaceUpdateRequest: {
+            /**
+             * Name
+             * @description Optional name for the workspace
+             */
+            name?: string | null;
+        };
+        /**
+         * WorkspaceView
+         * @description View model for a workspace — persistent shared storage across sessions.
+         */
+        WorkspaceView: {
+            /**
+             * ID
+             * Format: uuid
+             * @description Unique identifier for the workspace
+             */
+            id: string;
+            /**
+             * Name
+             * @description Optional name for the workspace
+             */
+            name?: string | null;
+            /**
+             * Created At
+             * Format: date-time
+             * @description Timestamp when the workspace was created
+             */
+            createdAt: string;
+            /**
+             * Updated At
+             * Format: date-time
+             * @description Timestamp when the workspace was last updated
+             */
+            updatedAt: string;
+        };
     };
     responses: never;
     parameters: never;
@@ -239,10 +363,11 @@ type RunTaskRequest$2 = components["schemas"]["RunTaskRequest"];
 type CreateSessionBody = Partial<RunTaskRequest$2>;
 type SessionResponse$2 = components["schemas"]["SessionResponse"];
 type SessionListResponse$1 = components["schemas"]["SessionListResponse"];
-type FileListResponse$1 = components["schemas"]["FileListResponse"];
+type FileListResponse$2 = components["schemas"]["FileListResponse"];
 type StopSessionRequest$1 = components["schemas"]["StopSessionRequest"];
-type FileUploadRequest$1 = components["schemas"]["FileUploadRequest"];
-type FileUploadResponse$1 = components["schemas"]["FileUploadResponse"];
+type FileUploadRequest$2 = components["schemas"]["FileUploadRequest"];
+type FileUploadResponse$2 = components["schemas"]["FileUploadResponse"];
+type MessageListResponse$1 = components["schemas"]["MessageListResponse"];
 interface SessionListParams {
     page?: number;
     page_size?: number;
@@ -252,6 +377,12 @@ interface SessionFilesParams {
     limit?: number;
     cursor?: string | null;
     includeUrls?: boolean;
+    shallow?: boolean;
+}
+interface SessionMessagesParams {
+    after?: string | null;
+    before?: string | null;
+    limit?: number;
 }
 declare class Sessions {
     private readonly http;
@@ -267,9 +398,54 @@ declare class Sessions {
     /** Soft-delete a session. */
     delete(sessionId: string): Promise<void>;
     /** Get presigned upload URLs for session files. */
-    uploadFiles(sessionId: string, body: FileUploadRequest$1): Promise<FileUploadResponse$1>;
+    uploadFiles(sessionId: string, body: FileUploadRequest$2): Promise<FileUploadResponse$2>;
     /** List files in a session's workspace. */
-    files(sessionId: string, params?: SessionFilesParams): Promise<FileListResponse$1>;
+    files(sessionId: string, params?: SessionFilesParams): Promise<FileListResponse$2>;
+    /** List messages for a session with cursor-based pagination. */
+    messages(sessionId: string, params?: SessionMessagesParams): Promise<MessageListResponse$1>;
+}
+
+type WorkspaceView$1 = components["schemas"]["WorkspaceView"];
+type WorkspaceListResponse$1 = components["schemas"]["WorkspaceListResponse"];
+type WorkspaceCreateRequest$1 = components["schemas"]["WorkspaceCreateRequest"];
+type WorkspaceUpdateRequest$1 = components["schemas"]["WorkspaceUpdateRequest"];
+type FileListResponse$1 = components["schemas"]["FileListResponse"];
+type FileUploadRequest$1 = components["schemas"]["FileUploadRequest"];
+type FileUploadResponse$1 = components["schemas"]["FileUploadResponse"];
+interface WorkspaceListParams {
+    pageSize?: number;
+    pageNumber?: number;
+}
+interface WorkspaceFilesParams {
+    prefix?: string;
+    limit?: number;
+    cursor?: string | null;
+    includeUrls?: boolean;
+    shallow?: boolean;
+}
+declare class Workspaces {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List workspaces for the authenticated project. */
+    list(params?: WorkspaceListParams): Promise<WorkspaceListResponse$1>;
+    /** Create a new workspace. */
+    create(body?: WorkspaceCreateRequest$1): Promise<WorkspaceView$1>;
+    /** Get workspace details. */
+    get(workspaceId: string): Promise<WorkspaceView$1>;
+    /** Update a workspace. */
+    update(workspaceId: string, body: WorkspaceUpdateRequest$1): Promise<WorkspaceView$1>;
+    /** Delete a workspace and its data. */
+    delete(workspaceId: string): Promise<void>;
+    /** List files in a workspace. */
+    files(workspaceId: string, params?: WorkspaceFilesParams): Promise<FileListResponse$1>;
+    /** Get presigned upload URLs for workspace files. */
+    uploadFiles(workspaceId: string, body: FileUploadRequest$1, query?: {
+        prefix?: string;
+    }): Promise<FileUploadResponse$1>;
+    /** Delete a file from a workspace. */
+    deleteFile(workspaceId: string, path: string): Promise<void>;
+    /** Get storage usage for a workspace. */
+    size(workspaceId: string): Promise<unknown>;
 }
 
 type SessionResponse$1 = components["schemas"]["SessionResponse"];
@@ -320,6 +496,7 @@ type RunSessionOptions = Partial<Omit<RunTaskRequest$1, "task">> & RunOptions &
 };
 declare class BrowserUse {
     readonly sessions: Sessions;
+    readonly workspaces: Workspaces;
     private readonly http;
     constructor(options?: BrowserUseOptions);
     /**
@@ -348,13 +525,19 @@ type FileListResponse = S["FileListResponse"];
 type FileInfo = S["FileInfo"];
 type FileUploadResponse = S["FileUploadResponse"];
 type FileUploadResponseItem = S["FileUploadResponseItem"];
+type MessageListResponse = S["MessageListResponse"];
+type MessageResponse = S["MessageResponse"];
+type WorkspaceView = S["WorkspaceView"];
+type WorkspaceListResponse = S["WorkspaceListResponse"];
 type RunTaskRequest = S["RunTaskRequest"];
 type StopSessionRequest = S["StopSessionRequest"];
 type FileUploadRequest = S["FileUploadRequest"];
 type FileUploadItem = S["FileUploadItem"];
+type WorkspaceCreateRequest = S["WorkspaceCreateRequest"];
+type WorkspaceUpdateRequest = S["WorkspaceUpdateRequest"];
 type BuAgentSessionStatus = S["BuAgentSessionStatus"];
 type BuModel = S["BuModel"];
 type ProxyCountryCode = S["ProxyCountryCode"];
 type StopStrategy = S["StopStrategy"];
 
-export { BrowserUse, type BrowserUseOptions, type BuAgentSessionStatus, type BuModel, type CreateSessionBody, type FileInfo, type FileListResponse, type FileUploadItem, type FileUploadRequest, type FileUploadResponse, type FileUploadResponseItem, type ProxyCountryCode, type RunOptions, type RunSessionOptions, type RunTaskRequest, type SessionFilesParams, type SessionListParams, type SessionListResponse, type SessionResponse, type SessionResult, SessionRun, Sessions, type StopSessionRequest, type StopStrategy, type components as V3Types };
+export { BrowserUse, type BrowserUseOptions, type BuAgentSessionStatus, type BuModel, type CreateSessionBody, type FileInfo, type FileListResponse, type FileUploadItem, type FileUploadRequest, type FileUploadResponse, type FileUploadResponseItem, type MessageListResponse, type MessageResponse, type ProxyCountryCode, type RunOptions, type RunSessionOptions, type RunTaskRequest, type SessionFilesParams, type SessionListParams, type SessionListResponse, type SessionMessagesParams, type SessionResponse, type SessionResult, SessionRun, Sessions, type StopSessionRequest, type StopStrategy, type components as V3Types, type WorkspaceCreateRequest, type WorkspaceFilesParams, type WorkspaceListParams, type WorkspaceListResponse, type WorkspaceUpdateRequest, type WorkspaceView, Workspaces };

package/dist/v3.d.ts

@@ -38,6 +38,11 @@ interface components {
         FileListResponse: {
             /** Files */
             files: components["schemas"]["FileInfo"][];
+            /**
+             * Folders
+             * @description Immediate sub-folder names at this prefix level
+             */
+            folders?: string[];
             /** Nextcursor */
             nextCursor?: string | null;
             /**
@@ -62,6 +67,11 @@ interface components {
              * @default application/octet-stream
              */
             contentType: string;
+            /**
+             * Size
+             * @description File size in bytes (required for workspace uploads)
+             */
+            size?: number | null;
         };
         /**
          * FileUploadRequest
@@ -99,6 +109,35 @@ interface components {
             /** Detail */
             detail?: components["schemas"]["ValidationError"][];
         };
+        /** MessageListResponse */
+        MessageListResponse: {
+            /** Messages */
+            messages: components["schemas"]["MessageResponse"][];
+            /** Hasmore */
+            hasMore: boolean;
+        };
+        /** MessageResponse */
+        MessageResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Sessionid
+             * Format: uuid
+             */
+            sessionId: string;
+            /** Role */
+            role: string;
+            /** Data */
+            data: string;
+            /**
+             * Createdat
+             * Format: date-time
+             */
+            createdAt: string;
+        };
         /**
          * ProxyCountryCode
          * @enum {string}
@@ -129,6 +168,8 @@ interface components {
             maxCostUsd?: number | string | null;
             /** Profileid */
             profileId?: string | null;
+            /** Workspaceid */
+            workspaceId?: string | null;
             proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
             /** Outputschema */
             outputSchema?: {
@@ -159,10 +200,16 @@ interface components {
             title?: string | null;
             /** Output */
             output?: unknown | null;
+            /** Outputschema */
+            outputSchema?: {
+                [key: string]: unknown;
+            } | null;
             /** Liveurl */
             liveUrl?: string | null;
             /** Profileid */
             profileId?: string | null;
+            /** Workspaceid */
+            workspaceId?: string | null;
             proxyCountryCode?: components["schemas"]["ProxyCountryCode"] | null;
             /** Maxcostusd */
             maxCostUsd?: string | null;
@@ -226,6 +273,83 @@ interface components {
             /** Error Type */
             type: string;
         };
+        /**
+         * WorkspaceCreateRequest
+         * @description Request model for creating a new workspace.
+         */
+        WorkspaceCreateRequest: {
+            /**
+             * Name
+             * @description Optional name for the workspace
+             */
+            name?: string | null;
+        };
+        /**
+         * WorkspaceListResponse
+         * @description Response model for paginated workspace list requests.
+         */
+        WorkspaceListResponse: {
+            /**
+             * Items
+             * @description List of workspace views for the current page
+             */
+            items: components["schemas"]["WorkspaceView"][];
+            /**
+             * Total Items
+             * @description Total number of items in the list
+             */
+            totalItems: number;
+            /**
+             * Page Number
+             * @description Page number
+             */
+            pageNumber: number;
+            /**
+             * Page Size
+             * @description Number of items per page
+             */
+            pageSize: number;
+        };
+        /**
+         * WorkspaceUpdateRequest
+         * @description Request model for updating a workspace.
+         */
+        WorkspaceUpdateRequest: {
+            /**
+             * Name
+             * @description Optional name for the workspace
+             */
+            name?: string | null;
+        };
+        /**
+         * WorkspaceView
+         * @description View model for a workspace — persistent shared storage across sessions.
+         */
+        WorkspaceView: {
+            /**
+             * ID
+             * Format: uuid
+             * @description Unique identifier for the workspace
+             */
+            id: string;
+            /**
+             * Name
+             * @description Optional name for the workspace
+             */
+            name?: string | null;
+            /**
+             * Created At
+             * Format: date-time
+             * @description Timestamp when the workspace was created
+             */
+            createdAt: string;
+            /**
+             * Updated At
+             * Format: date-time
+             * @description Timestamp when the workspace was last updated
+             */
+            updatedAt: string;
+        };
     };
     responses: never;
     parameters: never;
@@ -239,10 +363,11 @@ type RunTaskRequest$2 = components["schemas"]["RunTaskRequest"];
 type CreateSessionBody = Partial<RunTaskRequest$2>;
 type SessionResponse$2 = components["schemas"]["SessionResponse"];
 type SessionListResponse$1 = components["schemas"]["SessionListResponse"];
-type FileListResponse$1 = components["schemas"]["FileListResponse"];
+type FileListResponse$2 = components["schemas"]["FileListResponse"];
 type StopSessionRequest$1 = components["schemas"]["StopSessionRequest"];
-type FileUploadRequest$1 = components["schemas"]["FileUploadRequest"];
-type FileUploadResponse$1 = components["schemas"]["FileUploadResponse"];
+type FileUploadRequest$2 = components["schemas"]["FileUploadRequest"];
+type FileUploadResponse$2 = components["schemas"]["FileUploadResponse"];
+type MessageListResponse$1 = components["schemas"]["MessageListResponse"];
 interface SessionListParams {
     page?: number;
     page_size?: number;
@@ -252,6 +377,12 @@ interface SessionFilesParams {
     limit?: number;
     cursor?: string | null;
     includeUrls?: boolean;
+    shallow?: boolean;
+}
+interface SessionMessagesParams {
+    after?: string | null;
+    before?: string | null;
+    limit?: number;
 }
 declare class Sessions {
     private readonly http;
@@ -267,9 +398,54 @@ declare class Sessions {
     /** Soft-delete a session. */
     delete(sessionId: string): Promise<void>;
     /** Get presigned upload URLs for session files. */
-    uploadFiles(sessionId: string, body: FileUploadRequest$1): Promise<FileUploadResponse$1>;
+    uploadFiles(sessionId: string, body: FileUploadRequest$2): Promise<FileUploadResponse$2>;
     /** List files in a session's workspace. */
-    files(sessionId: string, params?: SessionFilesParams): Promise<FileListResponse$1>;
+    files(sessionId: string, params?: SessionFilesParams): Promise<FileListResponse$2>;
+    /** List messages for a session with cursor-based pagination. */
+    messages(sessionId: string, params?: SessionMessagesParams): Promise<MessageListResponse$1>;
+}
+
+type WorkspaceView$1 = components["schemas"]["WorkspaceView"];
+type WorkspaceListResponse$1 = components["schemas"]["WorkspaceListResponse"];
+type WorkspaceCreateRequest$1 = components["schemas"]["WorkspaceCreateRequest"];
+type WorkspaceUpdateRequest$1 = components["schemas"]["WorkspaceUpdateRequest"];
+type FileListResponse$1 = components["schemas"]["FileListResponse"];
+type FileUploadRequest$1 = components["schemas"]["FileUploadRequest"];
+type FileUploadResponse$1 = components["schemas"]["FileUploadResponse"];
+interface WorkspaceListParams {
+    pageSize?: number;
+    pageNumber?: number;
+}
+interface WorkspaceFilesParams {
+    prefix?: string;
+    limit?: number;
+    cursor?: string | null;
+    includeUrls?: boolean;
+    shallow?: boolean;
+}
+declare class Workspaces {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List workspaces for the authenticated project. */
+    list(params?: WorkspaceListParams): Promise<WorkspaceListResponse$1>;
+    /** Create a new workspace. */
+    create(body?: WorkspaceCreateRequest$1): Promise<WorkspaceView$1>;
+    /** Get workspace details. */
+    get(workspaceId: string): Promise<WorkspaceView$1>;
+    /** Update a workspace. */
+    update(workspaceId: string, body: WorkspaceUpdateRequest$1): Promise<WorkspaceView$1>;
+    /** Delete a workspace and its data. */
+    delete(workspaceId: string): Promise<void>;
+    /** List files in a workspace. */
+    files(workspaceId: string, params?: WorkspaceFilesParams): Promise<FileListResponse$1>;
+    /** Get presigned upload URLs for workspace files. */
+    uploadFiles(workspaceId: string, body: FileUploadRequest$1, query?: {
+        prefix?: string;
+    }): Promise<FileUploadResponse$1>;
+    /** Delete a file from a workspace. */
+    deleteFile(workspaceId: string, path: string): Promise<void>;
+    /** Get storage usage for a workspace. */
+    size(workspaceId: string): Promise<unknown>;
 }
 
 type SessionResponse$1 = components["schemas"]["SessionResponse"];
@@ -320,6 +496,7 @@ type RunSessionOptions = Partial<Omit<RunTaskRequest$1, "task">> & RunOptions &
 };
 declare class BrowserUse {
     readonly sessions: Sessions;
+    readonly workspaces: Workspaces;
     private readonly http;
     constructor(options?: BrowserUseOptions);
     /**
@@ -348,13 +525,19 @@ type FileListResponse = S["FileListResponse"];
 type FileInfo = S["FileInfo"];
 type FileUploadResponse = S["FileUploadResponse"];
 type FileUploadResponseItem = S["FileUploadResponseItem"];
+type MessageListResponse = S["MessageListResponse"];
+type MessageResponse = S["MessageResponse"];
+type WorkspaceView = S["WorkspaceView"];
+type WorkspaceListResponse = S["WorkspaceListResponse"];
 type RunTaskRequest = S["RunTaskRequest"];
 type StopSessionRequest = S["StopSessionRequest"];
 type FileUploadRequest = S["FileUploadRequest"];
 type FileUploadItem = S["FileUploadItem"];
+type WorkspaceCreateRequest = S["WorkspaceCreateRequest"];
+type WorkspaceUpdateRequest = S["WorkspaceUpdateRequest"];
 type BuAgentSessionStatus = S["BuAgentSessionStatus"];
 type BuModel = S["BuModel"];
 type ProxyCountryCode = S["ProxyCountryCode"];
 type StopStrategy = S["StopStrategy"];
 
-export { BrowserUse, type BrowserUseOptions, type BuAgentSessionStatus, type BuModel, type CreateSessionBody, type FileInfo, type FileListResponse, type FileUploadItem, type FileUploadRequest, type FileUploadResponse, type FileUploadResponseItem, type ProxyCountryCode, type RunOptions, type RunSessionOptions, type RunTaskRequest, type SessionFilesParams, type SessionListParams, type SessionListResponse, type SessionResponse, type SessionResult, SessionRun, Sessions, type StopSessionRequest, type StopStrategy, type components as V3Types };
+export { BrowserUse, type BrowserUseOptions, type BuAgentSessionStatus, type BuModel, type CreateSessionBody, type FileInfo, type FileListResponse, type FileUploadItem, type FileUploadRequest, type FileUploadResponse, type FileUploadResponseItem, type MessageListResponse, type MessageResponse, type ProxyCountryCode, type RunOptions, type RunSessionOptions, type RunTaskRequest, type SessionFilesParams, type SessionListParams, type SessionListResponse, type SessionMessagesParams, type SessionResponse, type SessionResult, SessionRun, Sessions, type StopSessionRequest, type StopStrategy, type components as V3Types, type WorkspaceCreateRequest, type WorkspaceFilesParams, type WorkspaceListParams, type WorkspaceListResponse, type WorkspaceUpdateRequest, type WorkspaceView, Workspaces };

package/dist/v3.js

@@ -42,6 +42,63 @@ var Sessions = class {
       params
     );
   }
+  /** List messages for a session with cursor-based pagination. */
+  messages(sessionId, params) {
+    return this.http.get(
+      `/sessions/${sessionId}/messages`,
+      params
+    );
+  }
+};
+
+// src/v3/resources/workspaces.ts
+var Workspaces = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List workspaces for the authenticated project. */
+  list(params) {
+    return this.http.get("/workspaces", params);
+  }
+  /** Create a new workspace. */
+  create(body) {
+    return this.http.post("/workspaces", body);
+  }
+  /** Get workspace details. */
+  get(workspaceId) {
+    return this.http.get(`/workspaces/${workspaceId}`);
+  }
+  /** Update a workspace. */
+  update(workspaceId, body) {
+    return this.http.patch(`/workspaces/${workspaceId}`, body);
+  }
+  /** Delete a workspace and its data. */
+  delete(workspaceId) {
+    return this.http.delete(`/workspaces/${workspaceId}`);
+  }
+  /** List files in a workspace. */
+  files(workspaceId, params) {
+    return this.http.get(
+      `/workspaces/${workspaceId}/files`,
+      params
+    );
+  }
+  /** Get presigned upload URLs for workspace files. */
+  uploadFiles(workspaceId, body, query) {
+    return this.http.post(
+      `/workspaces/${workspaceId}/files/upload`,
+      body,
+      query
+    );
+  }
+  /** Delete a file from a workspace. */
+  deleteFile(workspaceId, path) {
+    return this.http.delete(`/workspaces/${workspaceId}/files`, { path });
+  }
+  /** Get storage usage for a workspace. */
+  size(workspaceId) {
+    return this.http.get(`/workspaces/${workspaceId}/size`);
+  }
 };
 
 // src/v3/helpers.ts
@@ -113,6 +170,7 @@ var SessionRun = class {
 var DEFAULT_BASE_URL = "https://api.browser-use.com/api/v3";
 var BrowserUse = class {
   sessions;
+  workspaces;
   http;
   constructor(options = {}) {
     const apiKey = options.apiKey ?? process.env.BROWSER_USE_API_KEY ?? "";
@@ -128,6 +186,7 @@ var BrowserUse = class {
       timeout: options.timeout
     });
     this.sessions = new Sessions(this.http);
+    this.workspaces = new Workspaces(this.http);
   }
   run(task, options) {
     const { schema, timeout, interval, ...rest } = options ?? {};
@@ -143,6 +202,7 @@ export {
   BrowserUse,
   BrowserUseError,
   SessionRun,
-  Sessions
+  Sessions,
+  Workspaces
 };
 //# sourceMappingURL=v3.js.map

package/dist/v3.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/v3/client.ts","../src/v3/resources/sessions.ts","../src/v3/helpers.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { HttpClient } from \"../core/http.js\";\nimport { Sessions } from \"./resources/sessions.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\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  }\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\"];\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}\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","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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/v3/client.ts","../src/v3/resources/sessions.ts","../src/v3/resources/workspaces.ts","../src/v3/helpers.ts"],"sourcesContent":["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"],"mappings":"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","names":[]}

package/package.json

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