browser-use-sdk 2.0.7 → 2.0.8

package/dist/cjs/Client.js

@@ -49,8 +49,8 @@ class BrowserUseClient {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "browser-use-sdk",
-                "X-Fern-SDK-Version": "2.0.7",
-                "User-Agent": "browser-use-sdk/2.0.7",
+                "X-Fern-SDK-Version": "2.0.8",
+                "User-Agent": "browser-use-sdk/2.0.8",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/browsers/client/requests/CreateBrowserSessionRequest.d.ts

@@ -10,4 +10,8 @@ export interface CreateBrowserSessionRequest {
     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;
+    /** Custom screen width in pixels for the browser. */
+    browserScreenWidth?: number | null;
+    /** Custom screen height in pixels for the browser. */
+    browserScreenHeight?: number | null;
 }

package/dist/cjs/api/resources/index.d.ts

@@ -11,4 +11,3 @@ export * from "./tasks/client/requests/index.js";
 export * as tasks from "./tasks/index.js";
 export * from "./workflows/client/requests/index.js";
 export * as workflows from "./workflows/index.js";
-export * from "./workflows/types/index.js";

package/dist/cjs/api/resources/index.js

@@ -50,4 +50,3 @@ __exportStar(require("./tasks/client/requests/index.js"), exports);
 exports.tasks = __importStar(require("./tasks/index.js"));
 __exportStar(require("./workflows/client/requests/index.js"), exports);
 exports.workflows = __importStar(require("./workflows/index.js"));
-__exportStar(require("./workflows/types/index.js"), exports);

package/dist/cjs/api/resources/sessions/client/requests/CreateSessionRequest.d.ts

@@ -10,4 +10,8 @@ export interface CreateSessionRequest {
     proxyCountryCode?: BrowserUse.ProxyCountryCode | null;
     /** URL to navigate to when the session starts. */
     startUrl?: string | null;
+    /** Custom screen width in pixels for the browser. */
+    browserScreenWidth?: number | null;
+    /** Custom screen height in pixels for the browser. */
+    browserScreenHeight?: number | null;
 }

package/dist/cjs/api/resources/workflows/client/Client.d.ts

@@ -83,6 +83,25 @@ export declare class Workflows {
      */
     updateWorkflow(request: BrowserUse.WorkflowUpdateRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowResponse>;
     private __updateWorkflow;
+    /**
+     * Get workflow generation state with live browser URL for polling.
+     *
+     * This endpoint returns the current state of workflow generation including
+     * the live browser URL (if available). It's designed to be polled every 2 seconds
+     * during generation to show real-time browser activity in the frontend.
+     *
+     * @param {BrowserUse.GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest} request
+     * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workflows.getWorkflowGenerationState({
+     *         workflow_id: "workflow_id"
+     *     })
+     */
+    getWorkflowGenerationState(request: BrowserUse.GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowGenerationStateView>;
+    private __getWorkflowGenerationState;
     /**
      * Get a presigned URL to upload workflow YAML directly to S3 from the browser.
      *
@@ -103,10 +122,10 @@ export declare class Workflows {
     getWorkflowYamlPresignedUrl(request: BrowserUse.WorkflowYamlPresignedUploadRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowYamlPresignedUploadResponse>;
     private __getWorkflowYamlPresignedUrl;
     /**
-     * Execute a workflow either synchronously or asynchronously.
+     * Execute a workflow asynchronously.
      *
-     * - ASYNC mode: Returns execution ID immediately and processes in background via Lambda
-     * - SYNC mode: Waits for execution to complete and returns results inline (max 5 min timeout)
+     * Returns execution ID immediately and processes in background via Inngest.
+     * Use the GET /workflows/executions/{execution_id} endpoint to check status and retrieve results.
      *
      * @param {BrowserUse.WorkflowExecuteRequest} request
      * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
@@ -114,12 +133,12 @@ export declare class Workflows {
      * @throws {@link BrowserUse.UnprocessableEntityError}
      *
      * @example
-     *     await client.workflows.executeWorkflow({
+     *     await client.workflows.runWorkflow({
      *         workflow_id: "workflow_id"
      *     })
      */
-    executeWorkflow(request: BrowserUse.WorkflowExecuteRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.ExecuteWorkflowWorkflowsWorkflowIdExecutePostResponse>;
-    private __executeWorkflow;
+    runWorkflow(request: BrowserUse.WorkflowExecuteRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowExecutionCreatedResponse>;
+    private __runWorkflow;
     /**
      * Generate a workflow from a natural language task description.
      *
@@ -217,5 +236,43 @@ export declare class Workflows {
      */
     getExecutionLogs(request: BrowserUse.GetExecutionLogsWorkflowsExecutionsExecutionIdLogsGetRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowExecutionLogResponse>;
     private __getExecutionLogs;
+    /**
+     * Get workflow execution state with steps for live UI polling.
+     *
+     * This endpoint returns the current state of a workflow execution including all steps
+     * with their details. It's designed to be polled every 2 seconds during execution
+     * to show real-time progress in the frontend.
+     *
+     * @param {BrowserUse.GetExecutionStateWorkflowsExecutionsExecutionIdStateGetRequest} request
+     * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workflows.getExecutionState({
+     *         execution_id: "execution_id"
+     *     })
+     */
+    getExecutionState(request: BrowserUse.GetExecutionStateWorkflowsExecutionsExecutionIdStateGetRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowExecutionStateView>;
+    private __getExecutionState;
+    /**
+     * Get workflow execution media (screenshots) with presigned URLs.
+     *
+     * This endpoint returns media URLs for completed executions. Screenshots
+     * are returned with presigned S3 URLs for direct access from the frontend.
+     * Should be called when execution status is 'completed', 'failed', or 'cancelled'.
+     *
+     * @param {BrowserUse.GetExecutionMediaWorkflowsExecutionsExecutionIdMediaGetRequest} request
+     * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workflows.getExecutionMedia({
+     *         execution_id: "execution_id"
+     *     })
+     */
+    getExecutionMedia(request: BrowserUse.GetExecutionMediaWorkflowsExecutionsExecutionIdMediaGetRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowExecutionMediaView>;
+    private __getExecutionMedia;
     protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
 }

package/dist/cjs/api/resources/workflows/client/Client.js

@@ -400,6 +400,77 @@ class Workflows {
             }
         });
     }
+    /**
+     * Get workflow generation state with live browser URL for polling.
+     *
+     * This endpoint returns the current state of workflow generation including
+     * the live browser URL (if available). It's designed to be polled every 2 seconds
+     * during generation to show real-time browser activity in the frontend.
+     *
+     * @param {BrowserUse.GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest} request
+     * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workflows.getWorkflowGenerationState({
+     *         workflow_id: "workflow_id"
+     *     })
+     */
+    getWorkflowGenerationState(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getWorkflowGenerationState(request, requestOptions));
+    }
+    __getWorkflowGenerationState(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { workflow_id: workflowId } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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, `workflows/${core.url.encodePathParam(workflowId)}/generation-state`),
+                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 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 /workflows/{workflow_id}/generation-state.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Get a presigned URL to upload workflow YAML directly to S3 from the browser.
      *
@@ -475,10 +546,10 @@ class Workflows {
         });
     }
     /**
-     * Execute a workflow either synchronously or asynchronously.
+     * Execute a workflow asynchronously.
      *
-     * - ASYNC mode: Returns execution ID immediately and processes in background via Lambda
-     * - SYNC mode: Waits for execution to complete and returns results inline (max 5 min timeout)
+     * Returns execution ID immediately and processes in background via Inngest.
+     * Use the GET /workflows/executions/{execution_id} endpoint to check status and retrieve results.
      *
      * @param {BrowserUse.WorkflowExecuteRequest} request
      * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
@@ -486,20 +557,20 @@ class Workflows {
      * @throws {@link BrowserUse.UnprocessableEntityError}
      *
      * @example
-     *     await client.workflows.executeWorkflow({
+     *     await client.workflows.runWorkflow({
      *         workflow_id: "workflow_id"
      *     })
      */
-    executeWorkflow(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__executeWorkflow(request, requestOptions));
+    runWorkflow(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__runWorkflow(request, requestOptions));
     }
-    __executeWorkflow(request, requestOptions) {
+    __runWorkflow(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const { workflow_id: workflowId } = request, _body = __rest(request, ["workflow_id"]);
             const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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, `workflows/${core.url.encodePathParam(workflowId)}/execute`),
+                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, `workflows/${core.url.encodePathParam(workflowId)}/run`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -538,7 +609,7 @@ class Workflows {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling POST /workflows/{workflow_id}/execute.");
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling POST /workflows/{workflow_id}/run.");
                 case "unknown":
                     throw new errors.BrowserUseError({
                         message: _response.error.errorMessage,
@@ -976,6 +1047,148 @@ class Workflows {
             }
         });
     }
+    /**
+     * Get workflow execution state with steps for live UI polling.
+     *
+     * This endpoint returns the current state of a workflow execution including all steps
+     * with their details. It's designed to be polled every 2 seconds during execution
+     * to show real-time progress in the frontend.
+     *
+     * @param {BrowserUse.GetExecutionStateWorkflowsExecutionsExecutionIdStateGetRequest} request
+     * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workflows.getExecutionState({
+     *         execution_id: "execution_id"
+     *     })
+     */
+    getExecutionState(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getExecutionState(request, requestOptions));
+    }
+    __getExecutionState(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { execution_id: executionId } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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, `workflows/executions/${core.url.encodePathParam(executionId)}/state`),
+                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 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 /workflows/executions/{execution_id}/state.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Get workflow execution media (screenshots) with presigned URLs.
+     *
+     * This endpoint returns media URLs for completed executions. Screenshots
+     * are returned with presigned S3 URLs for direct access from the frontend.
+     * Should be called when execution status is 'completed', 'failed', or 'cancelled'.
+     *
+     * @param {BrowserUse.GetExecutionMediaWorkflowsExecutionsExecutionIdMediaGetRequest} request
+     * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workflows.getExecutionMedia({
+     *         execution_id: "execution_id"
+     *     })
+     */
+    getExecutionMedia(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getExecutionMedia(request, requestOptions));
+    }
+    __getExecutionMedia(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { execution_id: executionId } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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, `workflows/executions/${core.url.encodePathParam(executionId)}/media`),
+                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 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 /workflows/executions/{execution_id}/media.");
+                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);

package/dist/cjs/api/resources/workflows/client/requests/GetExecutionMediaWorkflowsExecutionsExecutionIdMediaGetRequest.d.ts

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

package/dist/cjs/api/resources/workflows/client/requests/GetExecutionMediaWorkflowsExecutionsExecutionIdMediaGetRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/workflows/client/requests/GetExecutionStateWorkflowsExecutionsExecutionIdStateGetRequest.d.ts

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

package/dist/cjs/api/resources/workflows/client/requests/GetExecutionStateWorkflowsExecutionsExecutionIdStateGetRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/workflows/client/requests/GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest.d.ts

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

package/dist/cjs/api/resources/workflows/client/requests/GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/workflows/client/requests/WorkflowExecuteRequest.d.ts

@@ -1,4 +1,3 @@
-import type * as BrowserUse from "../../../../index.js";
 /**
  * @example
  *     {
@@ -9,8 +8,6 @@ export interface WorkflowExecuteRequest {
     workflow_id: string;
     /** Input parameters for the workflow execution */
     input?: Record<string, unknown> | null;
-    /** Execution mode (sync or async) */
-    mode?: BrowserUse.ExecutionMode;
     /** Optional metadata for this execution */
     executionMetadata?: Record<string, unknown> | null;
 }

package/dist/cjs/api/resources/workflows/client/requests/index.d.ts

@@ -1,7 +1,10 @@
 export type { CancelExecutionWorkflowsExecutionsExecutionIdCancelPatchRequest } from "./CancelExecutionWorkflowsExecutionsExecutionIdCancelPatchRequest.js";
 export type { DeleteWorkflowWorkflowsWorkflowIdDeleteRequest } from "./DeleteWorkflowWorkflowsWorkflowIdDeleteRequest.js";
 export type { GetExecutionLogsWorkflowsExecutionsExecutionIdLogsGetRequest } from "./GetExecutionLogsWorkflowsExecutionsExecutionIdLogsGetRequest.js";
+export type { GetExecutionMediaWorkflowsExecutionsExecutionIdMediaGetRequest } from "./GetExecutionMediaWorkflowsExecutionsExecutionIdMediaGetRequest.js";
+export type { GetExecutionStateWorkflowsExecutionsExecutionIdStateGetRequest } from "./GetExecutionStateWorkflowsExecutionsExecutionIdStateGetRequest.js";
 export type { GetExecutionWorkflowsExecutionsExecutionIdGetRequest } from "./GetExecutionWorkflowsExecutionsExecutionIdGetRequest.js";
+export type { GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest } from "./GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest.js";
 export type { GetWorkflowWorkflowsWorkflowIdGetRequest } from "./GetWorkflowWorkflowsWorkflowIdGetRequest.js";
 export type { ListAllExecutionsWorkflowsExecutionsGetRequest } from "./ListAllExecutionsWorkflowsExecutionsGetRequest.js";
 export type { ListWorkflowExecutionsWorkflowsWorkflowIdExecutionsGetRequest } from "./ListWorkflowExecutionsWorkflowsWorkflowIdExecutionsGetRequest.js";

package/dist/cjs/api/resources/workflows/index.d.ts

@@ -1,2 +1 @@
 export * from "./client/index.js";
-export * from "./types/index.js";

package/dist/cjs/api/resources/workflows/index.js

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/index.js"), exports);
-__exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/types/SupportedLlMs.d.ts

@@ -6,10 +6,12 @@ export declare const SupportedLlMs: {
     readonly O3: "o3";
     readonly Gemini25Flash: "gemini-2.5-flash";
     readonly Gemini25Pro: "gemini-2.5-pro";
+    readonly Gemini3ProPreview: "gemini-3-pro-preview";
     readonly GeminiFlashLatest: "gemini-flash-latest";
     readonly GeminiFlashLiteLatest: "gemini-flash-lite-latest";
     readonly ClaudeSonnet420250514: "claude-sonnet-4-20250514";
     readonly ClaudeSonnet4520250929: "claude-sonnet-4-5-20250929";
+    readonly ClaudeOpus4520251101: "claude-opus-4-5-20251101";
     readonly Gpt4O: "gpt-4o";
     readonly Gpt4OMini: "gpt-4o-mini";
     readonly Llama4Maverick17B128EInstruct: "llama-4-maverick-17b-128e-instruct";

package/dist/cjs/api/types/SupportedLlMs.js

@@ -10,10 +10,12 @@ exports.SupportedLlMs = {
     O3: "o3",
     Gemini25Flash: "gemini-2.5-flash",
     Gemini25Pro: "gemini-2.5-pro",
+    Gemini3ProPreview: "gemini-3-pro-preview",
     GeminiFlashLatest: "gemini-flash-latest",
     GeminiFlashLiteLatest: "gemini-flash-lite-latest",
     ClaudeSonnet420250514: "claude-sonnet-4-20250514",
     ClaudeSonnet4520250929: "claude-sonnet-4-5-20250929",
+    ClaudeOpus4520251101: "claude-opus-4-5-20251101",
     Gpt4O: "gpt-4o",
     Gpt4OMini: "gpt-4o-mini",
     Llama4Maverick17B128EInstruct: "llama-4-maverick-17b-128e-instruct",

package/dist/cjs/api/types/WorkflowExecutionMediaStepView.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Minimal view of a step for media endpoint (screenshots only).
+ */
+export interface WorkflowExecutionMediaStepView {
+    /** Unique identifier for the step */
+    id: string;
+    /** Description of what this step did */
+    nextGoal: string;
+    /** Presigned URL for the step screenshot */
+    screenshotUrl?: string | null;
+    /** Actions taken in this step */
+    actions?: Record<string, unknown>[];
+}

package/dist/cjs/api/types/WorkflowExecutionMediaStepView.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/WorkflowExecutionMediaView.d.ts

@@ -0,0 +1,8 @@
+import type * as BrowserUse from "../index.js";
+/**
+ * View model for workflow execution media (screenshots, recordings).
+ */
+export interface WorkflowExecutionMediaView {
+    /** List of steps with media URLs */
+    steps?: BrowserUse.WorkflowExecutionMediaStepView[];
+}

package/dist/cjs/api/types/WorkflowExecutionMediaView.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/WorkflowExecutionStateView.d.ts

@@ -0,0 +1,28 @@
+import type * as BrowserUse from "../index.js";
+/**
+ * View model for workflow execution state (used for polling during execution).
+ */
+export interface WorkflowExecutionStateView {
+    /** Unique identifier for the execution */
+    id: string;
+    /** ID of the workflow being executed */
+    workflowId: string;
+    /** Current status of the execution */
+    status: BrowserUse.WorkflowExecutionStatus;
+    /** When execution started */
+    startedAt?: string | null;
+    /** When execution finished */
+    finishedAt?: string | null;
+    /** List of execution steps with details */
+    steps?: BrowserUse.WorkflowExecutionStepView[];
+    /** LLM costs for this execution */
+    llmsCost?: string;
+    /** Initialization costs */
+    initCost?: string;
+    /** Total cost */
+    totalCost?: string;
+    /** When execution was created */
+    createdAt: string;
+    /** Live browser view URL (available during and up to 60s after execution) */
+    liveUrl?: string | null;
+}

package/dist/cjs/api/types/WorkflowExecutionStateView.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/WorkflowExecutionStepView.d.ts

@@ -0,0 +1,29 @@
+/**
+ * View model for a single workflow execution step.
+ */
+export interface WorkflowExecutionStepView {
+    /** Unique identifier for the step (execution_id-step-N) */
+    id: string;
+    /** Sequential step number (1-indexed) */
+    stepNumber: number;
+    /** Name of the step from workflow definition */
+    stepName?: string | null;
+    /** Description of what this step is doing */
+    nextGoal: string;
+    /** Whether the step has completed */
+    isDone?: boolean;
+    /** Whether the step succeeded (None if in progress) */
+    success?: boolean | null;
+    /** S3 key for the step screenshot */
+    screenshotUrl?: string | null;
+    /** Browser URL at the time of this step */
+    url?: string;
+    /** Actions taken in this step */
+    actions?: Record<string, unknown>[];
+    /** Content extracted during this step */
+    extractedContent?: string | null;
+    /** Error message if step failed */
+    error?: string | null;
+    /** ISO 8601 timestamp when step was executed */
+    createdAt: string;
+}

package/dist/cjs/api/types/WorkflowExecutionStepView.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });