browser-use-sdk 2.0.4 → 2.0.5

package/dist/esm/api/resources/browsers/client/Client.mjs

@@ -0,0 +1,337 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as BrowserUse from "../../../index.mjs";
+export class Browsers {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Get paginated list of browser sessions with optional status filtering.
+     *
+     * @param {BrowserUse.ListBrowserSessionsBrowsersGetRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.browsers.listBrowserSessions()
+     */
+    listBrowserSessions(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listBrowserSessions(request, requestOptions));
+    }
+    __listBrowserSessions() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { pageSize, pageNumber, filterBy } = request;
+            const _queryParams = {};
+            if (pageSize != null) {
+                _queryParams.pageSize = pageSize.toString();
+            }
+            if (pageNumber != null) {
+                _queryParams.pageNumber = pageNumber.toString();
+            }
+            if (filterBy !== undefined) {
+                _queryParams.filterBy = filterBy;
+            }
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrowserUseEnvironment.Production, "browsers"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BrowserUseError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.BrowserUseError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /browsers.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Create a new browser session.
+     *
+     * **Pricing:** Browser sessions are charged at $0.05 per hour.
+     * The full hourly rate is charged upfront when the session starts.
+     * When you stop the session, any unused time is automatically refunded proportionally.
+     *
+     * Billing is rounded to the nearest minute (minimum 1 minute).
+     * For example, if you stop a session after 30 minutes, you'll be refunded $0.025.
+     *
+     * **Session Limits:**
+     * - Free users (without active subscription): Maximum 15 minutes per session
+     * - Paid subscribers: Up to 4 hours per session
+     *
+     * @param {BrowserUse.CreateBrowserSessionRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.ForbiddenError}
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
+     *
+     * @example
+     *     await client.browsers.createBrowserSession()
+     */
+    createBrowserSession(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createBrowserSession(request, requestOptions));
+    }
+    __createBrowserSession() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrowserUseEnvironment.Production, "browsers"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new BrowserUse.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new BrowserUse.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BrowserUseError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.BrowserUseError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling POST /browsers.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Get detailed browser session information including status and URLs.
+     *
+     * @param {BrowserUse.GetBrowserSessionBrowsersSessionIdGetRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.browsers.getBrowserSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    getBrowserSession(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getBrowserSession(request, requestOptions));
+    }
+    __getBrowserSession(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { session_id: sessionId } = request;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrowserUseEnvironment.Production, `browsers/${core.url.encodePathParam(sessionId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BrowserUseError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.BrowserUseError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /browsers/{session_id}.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Stop a browser session.
+     *
+     * **Refund:** When you stop a session, unused time is automatically refunded.
+     * If the session ran for less than 1 hour, you'll receive a proportional refund.
+     * Billing is ceil to the nearest minute (minimum 1 minute).
+     *
+     * @param {BrowserUse.UpdateBrowserSessionRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.browsers.updateBrowserSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    updateBrowserSession(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateBrowserSession(request, requestOptions));
+    }
+    __updateBrowserSession(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { session_id: sessionId } = request, _body = __rest(request, ["session_id"]);
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrowserUseEnvironment.Production, `browsers/${core.url.encodePathParam(sessionId)}`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: Object.assign(Object.assign({}, _body), { action: "stop" }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BrowserUseError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.BrowserUseError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling PATCH /browsers/{session_id}.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getCustomAuthorizationHeaders() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const apiKeyValue = yield core.Supplier.get(this._options.apiKey);
+            return { "X-Browser-Use-API-Key": apiKeyValue };
+        });
+    }
+}

package/dist/esm/api/resources/browsers/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/browsers/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/browsers/client/requests/CreateBrowserSessionRequest.d.mts

@@ -0,0 +1,13 @@
+import type * as BrowserUse from "../../../../index.mjs";
+/**
+ * @example
+ *     {}
+ */
+export interface CreateBrowserSessionRequest {
+    /** The ID of the profile to use for the session */
+    profileId?: string | null;
+    /** Country code for proxy location. */
+    proxyCountryCode?: BrowserUse.ProxyCountryCode | null;
+    /** The timeout for the session in minutes. Free users are limited to 15 minutes, paid users can use up to 240 minutes (4 hours). */
+    timeout?: number;
+}

package/dist/esm/api/resources/browsers/client/requests/CreateBrowserSessionRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/browsers/client/requests/GetBrowserSessionBrowsersSessionIdGetRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         session_id: "session_id"
+ *     }
+ */
+export interface GetBrowserSessionBrowsersSessionIdGetRequest {
+    session_id: string;
+}

package/dist/esm/api/resources/browsers/client/requests/GetBrowserSessionBrowsersSessionIdGetRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/browsers/client/requests/ListBrowserSessionsBrowsersGetRequest.d.mts

@@ -0,0 +1,10 @@
+import type * as BrowserUse from "../../../../index.mjs";
+/**
+ * @example
+ *     {}
+ */
+export interface ListBrowserSessionsBrowsersGetRequest {
+    pageSize?: number;
+    pageNumber?: number;
+    filterBy?: BrowserUse.BrowserSessionStatus | null;
+}

package/dist/esm/api/resources/browsers/client/requests/ListBrowserSessionsBrowsersGetRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/browsers/client/requests/UpdateBrowserSessionRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         session_id: "session_id"
+ *     }
+ */
+export interface UpdateBrowserSessionRequest {
+    session_id: string;
+}

package/dist/esm/api/resources/browsers/client/requests/UpdateBrowserSessionRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/browsers/client/requests/index.d.mts

@@ -0,0 +1,4 @@
+export type { CreateBrowserSessionRequest } from "./CreateBrowserSessionRequest.mjs";
+export type { GetBrowserSessionBrowsersSessionIdGetRequest } from "./GetBrowserSessionBrowsersSessionIdGetRequest.mjs";
+export type { ListBrowserSessionsBrowsersGetRequest } from "./ListBrowserSessionsBrowsersGetRequest.mjs";
+export type { UpdateBrowserSessionRequest } from "./UpdateBrowserSessionRequest.mjs";

package/dist/esm/api/resources/browsers/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/browsers/index.d.mts

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

package/dist/esm/api/resources/browsers/index.mjs

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

package/dist/esm/api/resources/files/client/Client.d.mts

@@ -1,39 +1,19 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as environments from "../../../../environments.mjs";
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
 import * as core from "../../../../core/index.mjs";
 import * as BrowserUse from "../../../index.mjs";
 export declare namespace Files {
-    interface Options {
-        environment?: core.Supplier<environments.BrowserUseEnvironment | string>;
-        /** Specify a custom URL to connect the client to. */
-        baseUrl?: core.Supplier<string>;
-        apiKey: core.Supplier<string>;
-        /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    interface Options extends BaseClientOptions {
     }
-    interface RequestOptions {
-        /** The maximum time to wait for a response in seconds. */
-        timeoutInSeconds?: number;
-        /** The number of times to retry the request. Defaults to 2. */
-        maxRetries?: number;
-        /** A hook to abort the request. */
-        abortSignal?: AbortSignal;
-        /** Additional query string parameters to include in the request. */
-        queryParams?: Record<string, unknown>;
-        /** Additional headers to include in the request. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    interface RequestOptions extends BaseRequestOptions {
     }
 }
 export declare class Files {
     protected readonly _options: Files.Options;
     constructor(_options: Files.Options);
     /**
-     * Generate a secure presigned URL for uploading files that AI agents can use during tasks.
+     * Generate a secure presigned URL for uploading files to an agent session.
      *
-     * @param {string} sessionId
-     * @param {BrowserUse.UploadFileRequest} request
+     * @param {BrowserUse.AgentSessionUploadFilePresignedUrlFilesSessionsSessionIdPresignedUrlPostRequest} request
      * @param {Files.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.BadRequestError}
@@ -42,19 +22,44 @@ export declare class Files {
      * @throws {@link BrowserUse.InternalServerError}
      *
      * @example
-     *     await client.files.userUploadFilePresignedUrl("session_id", {
-     *         fileName: "fileName",
-     *         contentType: "image/jpg",
-     *         sizeBytes: 1
+     *     await client.files.agentSessionUploadFilePresignedUrl({
+     *         session_id: "session_id",
+     *         body: {
+     *             fileName: "fileName",
+     *             contentType: "image/jpg",
+     *             sizeBytes: 1
+     *         }
      *     })
      */
-    userUploadFilePresignedUrl(sessionId: string, request: BrowserUse.UploadFileRequest, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<BrowserUse.UploadFilePresignedUrlResponse>;
-    private __userUploadFilePresignedUrl;
+    agentSessionUploadFilePresignedUrl(request: BrowserUse.AgentSessionUploadFilePresignedUrlFilesSessionsSessionIdPresignedUrlPostRequest, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<BrowserUse.UploadFilePresignedUrlResponse>;
+    private __agentSessionUploadFilePresignedUrl;
+    /**
+     * Generate a secure presigned URL for uploading files to a browser session.
+     *
+     * @param {BrowserUse.BrowserSessionUploadFilePresignedUrlFilesBrowsersSessionIdPresignedUrlPostRequest} request
+     * @param {Files.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.BadRequestError}
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.InternalServerError}
+     *
+     * @example
+     *     await client.files.browserSessionUploadFilePresignedUrl({
+     *         session_id: "session_id",
+     *         body: {
+     *             fileName: "fileName",
+     *             contentType: "image/jpg",
+     *             sizeBytes: 1
+     *         }
+     *     })
+     */
+    browserSessionUploadFilePresignedUrl(request: BrowserUse.BrowserSessionUploadFilePresignedUrlFilesBrowsersSessionIdPresignedUrlPostRequest, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<BrowserUse.UploadFilePresignedUrlResponse>;
+    private __browserSessionUploadFilePresignedUrl;
     /**
      * Get secure download URL for an output file generated by the AI agent.
      *
-     * @param {string} taskId
-     * @param {string} fileId
+     * @param {BrowserUse.GetTaskOutputFilePresignedUrlFilesTasksTaskIdOutputFilesFileIdGetRequest} request
      * @param {Files.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.NotFoundError}
@@ -62,11 +67,12 @@ export declare class Files {
      * @throws {@link BrowserUse.InternalServerError}
      *
      * @example
-     *     await client.files.getTaskOutputFilePresignedUrl("task_id", "file_id")
+     *     await client.files.getTaskOutputFilePresignedUrl({
+     *         task_id: "task_id",
+     *         file_id: "file_id"
+     *     })
      */
-    getTaskOutputFilePresignedUrl(taskId: string, fileId: string, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<BrowserUse.TaskOutputFileResponse>;
+    getTaskOutputFilePresignedUrl(request: BrowserUse.GetTaskOutputFilePresignedUrlFilesTasksTaskIdOutputFilesFileIdGetRequest, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<BrowserUse.TaskOutputFileResponse>;
     private __getTaskOutputFilePresignedUrl;
-    protected _getCustomAuthorizationHeaders(): Promise<{
-        "X-Browser-Use-API-Key": string;
-    }>;
+    protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
 }