browser-use-sdk 0.1.0

package/resources/sessions/sessions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.mts","sourceRoot":"","sources":["../../src/resources/sessions/sessions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,KAAK,cAAc;OACnB,EAAE,WAAW,EAAE,yBAAyB,EAAE,SAAS,EAAE;OACrD,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;IAEvF;;OAEG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC;IAI1B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIvG;;OAEG;IACH,IAAI,CACF,KAAK,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;CAGnC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAE1B,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAEhC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;CACH"}

package/resources/sessions/sessions.d.ts

@@ -0,0 +1,97 @@
+import { APIResource } from "../../core/resource.js";
+import * as TasksAPI from "../tasks.js";
+import * as PublicShareAPI from "./public-share.js";
+import { PublicShare, PublicShareDeleteResponse, ShareView } from "./public-share.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Sessions extends APIResource {
+    publicShare: PublicShareAPI.PublicShare;
+    /**
+     * Get Session
+     */
+    retrieve(sessionID: string, query?: SessionRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<SessionView>;
+    /**
+     * Update Session
+     */
+    update(sessionID: string, body: SessionUpdateParams, options?: RequestOptions): APIPromise<SessionView>;
+    /**
+     * List Sessions
+     */
+    list(query?: SessionListParams | null | undefined, options?: RequestOptions): APIPromise<SessionListResponse>;
+}
+/**
+ * Enumeration of possible (browser) session states
+ *
+ * Attributes: ACTIVE: Session is currently active and running (aka browser is
+ * running) STOPPED: Session has been stopped and is no longer active (aka browser
+ * is stopped)
+ */
+export type SessionStatus = 'active' | 'stopped';
+/**
+ * View model for representing a (browser) session with its associated tasks.
+ *
+ * Attributes: id: Unique identifier for the session. status: Current status of the
+ * session (active/stopped). live_url: URL where the browser can be viewed live in
+ * real-time. record_url: URL to access the recorded session playback. started_at:
+ * Timestamp when the session was created and started. finished_at: Timestamp when
+ * the session was stopped (None if still active). tasks: List of tasks associated
+ * with this session (optional). public_share_url: URL to access the public share
+ * of the session (optional).
+ */
+export interface SessionView {
+    id: string;
+    startedAt: string;
+    /**
+     * Enumeration of possible (browser) session states
+     *
+     * Attributes: ACTIVE: Session is currently active and running (aka browser is
+     * running) STOPPED: Session has been stopped and is no longer active (aka browser
+     * is stopped)
+     */
+    status: SessionStatus;
+    finishedAt?: string | null;
+    liveUrl?: string | null;
+    publicShareUrl?: string | null;
+    recordUrl?: string | null;
+    tasks?: Array<TasksAPI.TaskView> | null;
+}
+/**
+ * Response model for paginated session list requests
+ *
+ * Attributes: items: List of session views for the current page
+ */
+export interface SessionListResponse {
+    items: Array<SessionView>;
+    pageNumber: number;
+    pageSize: number;
+    totalItems: number;
+}
+export interface SessionRetrieveParams {
+    includeTasks?: boolean;
+}
+export interface SessionUpdateParams {
+    /**
+     * Available actions that can be performed on a session
+     *
+     * Attributes: STOP: Stop the session and all its associated tasks
+     */
+    action: 'stop';
+}
+export interface SessionListParams {
+    /**
+     * Enumeration of possible (browser) session states
+     *
+     * Attributes: ACTIVE: Session is currently active and running (aka browser is
+     * running) STOPPED: Session has been stopped and is no longer active (aka browser
+     * is stopped)
+     */
+    filterBy?: SessionStatus | null;
+    includeTasks?: boolean;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare namespace Sessions {
+    export { type SessionStatus as SessionStatus, type SessionView as SessionView, type SessionListResponse as SessionListResponse, type SessionRetrieveParams as SessionRetrieveParams, type SessionUpdateParams as SessionUpdateParams, type SessionListParams as SessionListParams, };
+    export { PublicShare as PublicShare, type ShareView as ShareView, type PublicShareDeleteResponse as PublicShareDeleteResponse, };
+}
+//# sourceMappingURL=sessions.d.ts.map

package/resources/sessions/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/resources/sessions/sessions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,KAAK,cAAc;OACnB,EAAE,WAAW,EAAE,yBAAyB,EAAE,SAAS,EAAE;OACrD,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;IAEvF;;OAEG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC;IAI1B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIvG;;OAEG;IACH,IAAI,CACF,KAAK,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;CAGnC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAE1B,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAEhC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;CACH"}

package/resources/sessions/sessions.js

@@ -0,0 +1,36 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sessions = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const PublicShareAPI = tslib_1.__importStar(require("./public-share.js"));
+const public_share_1 = require("./public-share.js");
+const path_1 = require("../../internal/utils/path.js");
+class Sessions extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.publicShare = new PublicShareAPI.PublicShare(this._client);
+    }
+    /**
+     * Get Session
+     */
+    retrieve(sessionID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/sessions/${sessionID}`, { query, ...options });
+    }
+    /**
+     * Update Session
+     */
+    update(sessionID, body, options) {
+        return this._client.patch((0, path_1.path) `/sessions/${sessionID}`, { body, ...options });
+    }
+    /**
+     * List Sessions
+     */
+    list(query = {}, options) {
+        return this._client.get('/sessions', { query, ...options });
+    }
+}
+exports.Sessions = Sessions;
+Sessions.PublicShare = public_share_1.PublicShare;
+//# sourceMappingURL=sessions.js.map

package/resources/sessions/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions/sessions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,0EAAiD;AACjD,oDAAmF;AAGnF,uDAAiD;AAEjD,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6BzF,CAAC;IA3BC;;OAEG;IACH,QAAQ,CACN,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AA9BD,4BA8BC;AA4FD,QAAQ,CAAC,WAAW,GAAG,0BAAW,CAAC"}

package/resources/sessions/sessions.mjs

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as PublicShareAPI from "./public-share.mjs";
+import { PublicShare } from "./public-share.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Sessions extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.publicShare = new PublicShareAPI.PublicShare(this._client);
+    }
+    /**
+     * Get Session
+     */
+    retrieve(sessionID, query = {}, options) {
+        return this._client.get(path `/sessions/${sessionID}`, { query, ...options });
+    }
+    /**
+     * Update Session
+     */
+    update(sessionID, body, options) {
+        return this._client.patch(path `/sessions/${sessionID}`, { body, ...options });
+    }
+    /**
+     * List Sessions
+     */
+    list(query = {}, options) {
+        return this._client.get('/sessions', { query, ...options });
+    }
+}
+Sessions.PublicShare = PublicShare;
+//# sourceMappingURL=sessions.mjs.map

package/resources/sessions/sessions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.mjs","sourceRoot":"","sources":["../../src/resources/sessions/sessions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,cAAc;OACnB,EAAE,WAAW,EAAwC;OAGrD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6BzF,CAAC;IA3BC;;OAEG;IACH,QAAQ,CACN,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,aAAa,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AA4FD,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC"}

package/resources/sessions.d.mts

@@ -0,0 +1,2 @@
+export * from "./sessions/index.mjs";
+//# sourceMappingURL=sessions.d.mts.map

package/resources/sessions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.mts","sourceRoot":"","sources":["../src/resources/sessions.ts"],"names":[],"mappings":""}

package/resources/sessions.d.ts

@@ -0,0 +1,2 @@
+export * from "./sessions/index.js";
+//# sourceMappingURL=sessions.d.ts.map

package/resources/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/resources/sessions.ts"],"names":[],"mappings":""}

package/resources/sessions.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./sessions/index.js"), exports);
+//# sourceMappingURL=sessions.js.map

package/resources/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../src/resources/sessions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/sessions.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./sessions/index.mjs";
+//# sourceMappingURL=sessions.mjs.map

package/resources/sessions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.mjs","sourceRoot":"","sources":["../src/resources/sessions.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/tasks.d.mts

@@ -0,0 +1,246 @@
+import { APIResource } from "../core/resource.mjs";
+import * as TasksAPI from "./tasks.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Tasks extends APIResource {
+    /**
+     * Create Task
+     */
+    create(body: TaskCreateParams, options?: RequestOptions): APIPromise<TaskView>;
+    /**
+     * Get Task
+     */
+    retrieve(taskID: string, query?: TaskRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<TaskRetrieveResponse>;
+    /**
+     * Update Task
+     */
+    update(taskID: string, body: TaskUpdateParams, options?: RequestOptions): APIPromise<TaskView>;
+    /**
+     * List Tasks
+     */
+    list(query?: TaskListParams | null | undefined, options?: RequestOptions): APIPromise<TaskListResponse>;
+    /**
+     * Get Task Logs
+     */
+    retrieveLogs(taskID: string, options?: RequestOptions): APIPromise<TaskRetrieveLogsResponse>;
+    /**
+     * Get Task Output File
+     */
+    retrieveOutputFile(fileName: string, params: TaskRetrieveOutputFileParams, options?: RequestOptions): APIPromise<TaskRetrieveOutputFileResponse>;
+}
+export type LlmModel = 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'o4-mini' | 'o3' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash-preview-04-17' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'claude-3-7-sonnet-20250219' | 'claude-sonnet-4-20250514' | 'llama-4-maverick-17b-128e-instruct';
+/**
+ * Enumeration of possible task execution states
+ *
+ * Attributes: STARTED: Task has been initiated and is currently running PAUSED:
+ * Task execution has been temporarily paused STOPPED: Task execution has been
+ * stopped (not completed) FINISHED: Task has completed successfully
+ */
+export type TaskStatus = 'started' | 'paused' | 'stopped' | 'finished';
+/**
+ * View model for representing a task with its execution details
+ *
+ * Attributes: id: Unique identifier for the task session_id: ID of the session
+ * this task belongs to session_live_url: Live URL of the session llm: The LLM
+ * model used for this task task: The task prompt/instruction given to the agent
+ * status: Current status of the task execution started_at: Naive UTC timestamp
+ * when the task was started finished_at: Naive UTC timestamp when the task
+ * completed (None if still running) metadata: Additional metadata associated with
+ * the task (optionally set by the user) is_scheduled: Whether this task was
+ * created as a scheduled task steps: List of execution steps (optionally included
+ * per user request) done_output: Final output/result of the task
+ * user_uploaded_files: List of files uploaded by user for this task (optionally
+ * included per user request) output_files: List of files generated as output by
+ * this task (optionally included per user request) browser_use_version: Version of
+ * browser-use used for this task
+ */
+export interface TaskView {
+    id: string;
+    doneOutput: string;
+    isScheduled: boolean;
+    llm: LlmModel;
+    sessionId: string;
+    startedAt: string;
+    /**
+     * Enumeration of possible task execution states
+     *
+     * Attributes: STARTED: Task has been initiated and is currently running PAUSED:
+     * Task execution has been temporarily paused STOPPED: Task execution has been
+     * stopped (not completed) FINISHED: Task has completed successfully
+     */
+    status: TaskStatus;
+    task: string;
+    browserUseVersion?: string | null;
+    finishedAt?: string | null;
+    metadata?: {
+        [key: string]: unknown;
+    };
+    outputFiles?: Array<string> | null;
+    sessionLiveUrl?: string | null;
+    steps?: Array<TaskView.Step> | null;
+    userUploadedFiles?: Array<string> | null;
+}
+export declare namespace TaskView {
+    /**
+     * View model for representing a single step in a task's execution
+     *
+     * Attributes: number: Sequential step number within the task memory: Agent's
+     * memory/context at this step evaluation_previous_goal: Agent's evaluation of the
+     * previous goal completion next_goal: The goal for the next step url: Current URL
+     * the browser is on for this step screenshot_url: URL to the screenshot taken at
+     * this step actions: List of stringified json actions performed by the agent in
+     * this step
+     */
+    interface Step {
+        actions: Array<string>;
+        evaluationPreviousGoal: string;
+        memory: string;
+        nextGoal: string;
+        number: number;
+        url: string;
+        screenshotUrl?: string | null;
+    }
+}
+/**
+ * View model for representing a task with its execution details
+ *
+ * Attributes: id: Unique identifier for the task session_id: ID of the session
+ * this task belongs to session_live_url: Live URL of the session llm: The LLM
+ * model used for this task task: The task prompt/instruction given to the agent
+ * status: Current status of the task execution started_at: Naive UTC timestamp
+ * when the task was started finished_at: Naive UTC timestamp when the task
+ * completed (None if still running) metadata: Additional metadata associated with
+ * the task (optionally set by the user) is_scheduled: Whether this task was
+ * created as a scheduled task steps: List of execution steps (optionally included
+ * per user request) done_output: Final output/result of the task
+ * user_uploaded_files: List of files uploaded by user for this task (optionally
+ * included per user request) output_files: List of files generated as output by
+ * this task (optionally included per user request) browser_use_version: Version of
+ * browser-use used for this task
+ */
+export type TaskRetrieveResponse = TaskView | TaskRetrieveResponse.TaskStatusView;
+export declare namespace TaskRetrieveResponse {
+    /**
+     * Minimal view for returning just the task status
+     *
+     * Attributes: status: Current status of the task
+     */
+    interface TaskStatusView {
+        /**
+         * Enumeration of possible task execution states
+         *
+         * Attributes: STARTED: Task has been initiated and is currently running PAUSED:
+         * Task execution has been temporarily paused STOPPED: Task execution has been
+         * stopped (not completed) FINISHED: Task has completed successfully
+         */
+        status: TasksAPI.TaskStatus;
+    }
+}
+/**
+ * Response model for paginated task list requests
+ *
+ * Attributes: items: List of task views for the current page
+ */
+export interface TaskListResponse {
+    items: Array<TaskView>;
+    pageNumber: number;
+    pageSize: number;
+    totalItems: number;
+}
+/**
+ * Response model for log file requests
+ *
+ * Attributes: download_url: URL to download the log file
+ */
+export interface TaskRetrieveLogsResponse {
+    downloadUrl: string;
+}
+/**
+ * Response model for output file requests
+ *
+ * Attributes: download_url: URL to download the output file
+ */
+export interface TaskRetrieveOutputFileResponse {
+    downloadUrl: string;
+}
+export interface TaskCreateParams {
+    task: string;
+    /**
+     * Configuration settings for the AI agent
+     *
+     * Attributes: llm: The LLM model to use for the agent (default: O3 - best
+     * performance for now) profile_id: ID of the agent profile to use for the task
+     * (None for default)
+     */
+    agentSettings?: TaskCreateParams.AgentSettings;
+    /**
+     * Configuration settings for the browser session
+     *
+     * Attributes: session_id: ID of existing session to continue (None for new
+     * session) profile_id: ID of browser profile to use (None for default)
+     * save_browser_data: Whether to save browser state/data for the user to download
+     * later
+     */
+    browserSettings?: TaskCreateParams.BrowserSettings;
+    includedFileNames?: Array<string> | null;
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    secrets?: {
+        [key: string]: string;
+    } | null;
+    structuredOutputJson?: string | null;
+}
+export declare namespace TaskCreateParams {
+    /**
+     * Configuration settings for the AI agent
+     *
+     * Attributes: llm: The LLM model to use for the agent (default: O3 - best
+     * performance for now) profile_id: ID of the agent profile to use for the task
+     * (None for default)
+     */
+    interface AgentSettings {
+        llm?: TasksAPI.LlmModel;
+        profileId?: string | null;
+    }
+    /**
+     * Configuration settings for the browser session
+     *
+     * Attributes: session_id: ID of existing session to continue (None for new
+     * session) profile_id: ID of browser profile to use (None for default)
+     * save_browser_data: Whether to save browser state/data for the user to download
+     * later
+     */
+    interface BrowserSettings {
+        profileId?: string | null;
+        saveBrowserData?: boolean;
+        sessionId?: string | null;
+    }
+}
+export interface TaskRetrieveParams {
+    statusOnly?: boolean;
+}
+export interface TaskUpdateParams {
+    /**
+     * Available actions that can be performed on a task
+     *
+     * Attributes: STOP: Stop the current task execution PAUSE: Pause the current task
+     * execution RESUME: Resume a paused task execution STOP_TASK_AND_SESSION: Stop
+     * both the task and its parent session
+     */
+    action: 'stop' | 'pause' | 'resume' | 'stop_task_and_session';
+}
+export interface TaskListParams {
+    includeOutputFiles?: boolean;
+    includeSteps?: boolean;
+    includeUserUploadedFiles?: boolean;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export interface TaskRetrieveOutputFileParams {
+    task_id: string;
+}
+export declare namespace Tasks {
+    export { type LlmModel as LlmModel, type TaskStatus as TaskStatus, type TaskView as TaskView, type TaskRetrieveResponse as TaskRetrieveResponse, type TaskListResponse as TaskListResponse, type TaskRetrieveLogsResponse as TaskRetrieveLogsResponse, type TaskRetrieveOutputFileResponse as TaskRetrieveOutputFileResponse, type TaskCreateParams as TaskCreateParams, type TaskRetrieveParams as TaskRetrieveParams, type TaskUpdateParams as TaskUpdateParams, type TaskListParams as TaskListParams, type TaskRetrieveOutputFileParams as TaskRetrieveOutputFileParams, };
+}
+//# sourceMappingURL=tasks.d.mts.map

package/resources/tasks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.mts","sourceRoot":"","sources":["../src/resources/tasks.ts"],"names":[],"mappings":"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"}