browser-use-sdk 2.0.6 → 2.0.7

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.6",
-                "User-Agent": "browser-use-sdk/2.0.6",
+                "X-Fern-SDK-Version": "2.0.7",
+                "User-Agent": "browser-use-sdk/2.0.7",
                 "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/sessions/client/Client.d.ts

@@ -54,6 +54,22 @@ export declare class Sessions {
      */
     getSession(request: BrowserUse.GetSessionSessionsSessionIdGetRequest, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<BrowserUse.SessionView>;
     private __getSession;
+    /**
+     * Delete a session with all its tasks.
+     *
+     * @param {BrowserUse.DeleteSessionSessionsSessionIdDeleteRequest} request
+     * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.deleteSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    deleteSession(request: BrowserUse.DeleteSessionSessionsSessionIdDeleteRequest, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<void>;
+    private __deleteSession;
     /**
      * Stop a session and all its running tasks.
      *

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

@@ -273,6 +273,73 @@ class Sessions {
             }
         });
     }
+    /**
+     * Delete a session with all its tasks.
+     *
+     * @param {BrowserUse.DeleteSessionSessionsSessionIdDeleteRequest} request
+     * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.deleteSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    deleteSession(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteSession(request, requestOptions));
+    }
+    __deleteSession(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 = (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, `sessions/${core.url.encodePathParam(sessionId)}`),
+                method: "DELETE",
+                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: undefined, 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 DELETE /sessions/{session_id}.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Stop a session and all its running tasks.
      *

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

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

package/dist/cjs/api/resources/sessions/client/requests/DeleteSessionSessionsSessionIdDeleteRequest.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/sessions/client/requests/index.d.ts

@@ -1,6 +1,7 @@
 export type { CreateSessionPublicShareSessionsSessionIdPublicSharePostRequest } from "./CreateSessionPublicShareSessionsSessionIdPublicSharePostRequest.js";
 export type { CreateSessionRequest } from "./CreateSessionRequest.js";
 export type { DeleteSessionPublicShareSessionsSessionIdPublicShareDeleteRequest } from "./DeleteSessionPublicShareSessionsSessionIdPublicShareDeleteRequest.js";
+export type { DeleteSessionSessionsSessionIdDeleteRequest } from "./DeleteSessionSessionsSessionIdDeleteRequest.js";
 export type { GetSessionPublicShareSessionsSessionIdPublicShareGetRequest } from "./GetSessionPublicShareSessionsSessionIdPublicShareGetRequest.js";
 export type { GetSessionSessionsSessionIdGetRequest } from "./GetSessionSessionsSessionIdGetRequest.js";
 export type { ListSessionsSessionsGetRequest } from "./ListSessionsSessionsGetRequest.js";

package/dist/cjs/api/resources/tasks/client/requests/CreateTaskRequest.d.ts

@@ -36,6 +36,12 @@ export interface CreateTaskRequest {
     vision?: CreateTaskRequest.Vision;
     /** Optional extension to the agent system prompt. */
     systemPromptExtension?: string;
+    /** Enable judge mode to evaluate task completion against ground truth. */
+    judge?: boolean;
+    /** Expected answer for judge evaluation. */
+    judgeGroundTruth?: string | null;
+    /** The LLM model to use for judging. If not provided, uses the default judge LLM. */
+    judgeLlm?: BrowserUse.SupportedLlMs | null;
 }
 export declare namespace CreateTaskRequest {
     /**

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

@@ -26,4 +26,8 @@ export interface TaskItemView {
     browserUseVersion?: string | null;
     /** Whether the task was successful (self-reported by the agent) */
     isSuccess?: boolean | null;
+    /** Stringified JSON object containing the full report from the judge */
+    judgement?: string | null;
+    /** Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) */
+    judgeVerdict?: boolean | null;
 }

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

@@ -26,6 +26,10 @@ export interface TaskView {
     outputFiles: BrowserUse.FileView[];
     /** Version of browser-use used for this task (older tasks may not have this set) */
     browserUseVersion?: string | null;
-    /** Whether the task was successful (self-reported by the agent) */
+    /** Whether the task was successful based on the agent's self-reported output (less reliable than the judge) */
     isSuccess?: boolean | null;
+    /** Stringified JSON object containing the full report from the judge */
+    judgement?: string | null;
+    /** Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) */
+    judgeVerdict?: boolean | null;
 }

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.6";
+export declare const SDK_VERSION = "2.0.7";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "2.0.6";
+exports.SDK_VERSION = "2.0.7";

package/dist/cjs/wrapper/lib/parse.js

@@ -91,6 +91,8 @@ function wrapCreateTaskResponse(client, response, schema) {
                 switch (res.status) {
                     case "finished":
                     case "stopped":
+                        break poll;
+                    case "created":
                     case "started":
                         yield __await(new Promise((resolve) => setTimeout(resolve, intervalMs)));
                         break;
@@ -167,13 +169,14 @@ function wrapCreateTaskResponse(client, response, schema) {
                     _c = _f.value;
                     _d = false;
                     const msg = _c;
-                    switch (msg.data.status) {
-                        case "finished":
-                        case "stopped":
-                        case "started":
-                            break;
-                        // default:
-                        // throw new ExhaustiveSwitchCheck(msg.data.status as never);
+                    // Return on terminal statuses
+                    if (msg.data.status === "finished" || msg.data.status === "stopped") {
+                        if (schema != null) {
+                            return parseStructuredTaskOutput(msg.data, schema);
+                        }
+                        else {
+                            return msg.data;
+                        }
                     }
                 }
             }

package/dist/esm/Client.mjs

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

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

@@ -54,6 +54,22 @@ export declare class Sessions {
      */
     getSession(request: BrowserUse.GetSessionSessionsSessionIdGetRequest, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<BrowserUse.SessionView>;
     private __getSession;
+    /**
+     * Delete a session with all its tasks.
+     *
+     * @param {BrowserUse.DeleteSessionSessionsSessionIdDeleteRequest} request
+     * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.deleteSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    deleteSession(request: BrowserUse.DeleteSessionSessionsSessionIdDeleteRequest, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<void>;
+    private __deleteSession;
     /**
      * Stop a session and all its running tasks.
      *

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

@@ -237,6 +237,73 @@ export class Sessions {
             }
         });
     }
+    /**
+     * Delete a session with all its tasks.
+     *
+     * @param {BrowserUse.DeleteSessionSessionsSessionIdDeleteRequest} request
+     * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.deleteSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    deleteSession(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteSession(request, requestOptions));
+    }
+    __deleteSession(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, `sessions/${core.url.encodePathParam(sessionId)}`),
+                method: "DELETE",
+                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: undefined, 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 DELETE /sessions/{session_id}.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Stop a session and all its running tasks.
      *

package/dist/esm/api/resources/sessions/client/requests/DeleteSessionSessionsSessionIdDeleteRequest.d.mts

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

package/dist/esm/api/resources/sessions/client/requests/DeleteSessionSessionsSessionIdDeleteRequest.mjs

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

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

@@ -1,6 +1,7 @@
 export type { CreateSessionPublicShareSessionsSessionIdPublicSharePostRequest } from "./CreateSessionPublicShareSessionsSessionIdPublicSharePostRequest.mjs";
 export type { CreateSessionRequest } from "./CreateSessionRequest.mjs";
 export type { DeleteSessionPublicShareSessionsSessionIdPublicShareDeleteRequest } from "./DeleteSessionPublicShareSessionsSessionIdPublicShareDeleteRequest.mjs";
+export type { DeleteSessionSessionsSessionIdDeleteRequest } from "./DeleteSessionSessionsSessionIdDeleteRequest.mjs";
 export type { GetSessionPublicShareSessionsSessionIdPublicShareGetRequest } from "./GetSessionPublicShareSessionsSessionIdPublicShareGetRequest.mjs";
 export type { GetSessionSessionsSessionIdGetRequest } from "./GetSessionSessionsSessionIdGetRequest.mjs";
 export type { ListSessionsSessionsGetRequest } from "./ListSessionsSessionsGetRequest.mjs";

package/dist/esm/api/resources/tasks/client/requests/CreateTaskRequest.d.mts

@@ -36,6 +36,12 @@ export interface CreateTaskRequest {
     vision?: CreateTaskRequest.Vision;
     /** Optional extension to the agent system prompt. */
     systemPromptExtension?: string;
+    /** Enable judge mode to evaluate task completion against ground truth. */
+    judge?: boolean;
+    /** Expected answer for judge evaluation. */
+    judgeGroundTruth?: string | null;
+    /** The LLM model to use for judging. If not provided, uses the default judge LLM. */
+    judgeLlm?: BrowserUse.SupportedLlMs | null;
 }
 export declare namespace CreateTaskRequest {
     /**

package/dist/esm/api/types/TaskItemView.d.mts

@@ -26,4 +26,8 @@ export interface TaskItemView {
     browserUseVersion?: string | null;
     /** Whether the task was successful (self-reported by the agent) */
     isSuccess?: boolean | null;
+    /** Stringified JSON object containing the full report from the judge */
+    judgement?: string | null;
+    /** Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) */
+    judgeVerdict?: boolean | null;
 }

package/dist/esm/api/types/TaskView.d.mts

@@ -26,6 +26,10 @@ export interface TaskView {
     outputFiles: BrowserUse.FileView[];
     /** Version of browser-use used for this task (older tasks may not have this set) */
     browserUseVersion?: string | null;
-    /** Whether the task was successful (self-reported by the agent) */
+    /** Whether the task was successful based on the agent's self-reported output (less reliable than the judge) */
     isSuccess?: boolean | null;
+    /** Stringified JSON object containing the full report from the judge */
+    judgement?: string | null;
+    /** Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) */
+    judgeVerdict?: boolean | null;
 }

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.6";
+export declare const SDK_VERSION = "2.0.7";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.6";
+export const SDK_VERSION = "2.0.7";

package/dist/esm/wrapper/lib/parse.mjs

@@ -82,6 +82,8 @@ export function wrapCreateTaskResponse(client, response, schema) {
                 switch (res.status) {
                     case "finished":
                     case "stopped":
+                        break poll;
+                    case "created":
                     case "started":
                         yield __await(new Promise((resolve) => setTimeout(resolve, intervalMs)));
                         break;
@@ -158,13 +160,14 @@ export function wrapCreateTaskResponse(client, response, schema) {
                     _c = _f.value;
                     _d = false;
                     const msg = _c;
-                    switch (msg.data.status) {
-                        case "finished":
-                        case "stopped":
-                        case "started":
-                            break;
-                        // default:
-                        // throw new ExhaustiveSwitchCheck(msg.data.status as never);
+                    // Return on terminal statuses
+                    if (msg.data.status === "finished" || msg.data.status === "stopped") {
+                        if (schema != null) {
+                            return parseStructuredTaskOutput(msg.data, schema);
+                        }
+                        else {
+                            return msg.data;
+                        }
                     }
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "browser-use-sdk",
-    "version": "2.0.6",
+    "version": "2.0.7",
     "private": false,
     "repository": "github:browser-use/browser-use-node",
     "type": "commonjs",

package/reference.md

@@ -570,6 +570,71 @@ await client.sessions.getSession({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">deleteSession</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Delete a session with all its tasks.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sessions.deleteSession({
+    session_id: "session_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `BrowserUse.DeleteSessionSessionsSessionIdDeleteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Sessions.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>