browser-use-sdk 0.1.1 → 0.2.0

package/resources/sessions/public-share.d.ts

@@ -3,17 +3,71 @@ import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class PublicShare extends APIResource {
     /**
-     * Create Session Public Share
+     * Create a public share for a session.
+     *
+     * Generates a public sharing link that allows anyone with the URL to view the
+     * session and its tasks. If a public share already exists for the session, it will
+     * return the existing share instead of creating a new one.
+     *
+     * Public shares are useful for:
+     *
+     * - Sharing results with clients or team members
+     * - Demonstrating AI agent capabilities
+     * - Collaborative review of automated tasks
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session to share
+     *
+     * Returns:
+     *
+     * - Public share information including the share URL and usage statistics
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
     create(sessionID: string, options?: RequestOptions): APIPromise<ShareView>;
     /**
-     * Get Session Public Share
+     * Get information about the public share for a session.
+     *
+     * Retrieves details about the public sharing link for a session, including the
+     * share token, public URL, view count, and last viewed timestamp. This is useful
+     * for monitoring how your shared sessions are being accessed.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session
+     *
+     * Returns:
+     *
+     * - Public share information including the share URL and usage statistics
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist or doesn't have a public share
      */
     retrieve(sessionID: string, options?: RequestOptions): APIPromise<ShareView>;
     /**
-     * Delete Session Public Share
+     * Remove the public share for a session.
+     *
+     * Deletes the public sharing link for a session, making it no longer accessible to
+     * anyone with the previous share URL. This is useful for removing access to
+     * sensitive sessions or when you no longer want to share the results.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session
+     *
+     * Returns:
+     *
+     * - 204 No Content on successful deletion (idempotent)
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
-    delete(sessionID: string, options?: RequestOptions): APIPromise<unknown>;
+    delete(sessionID: string, options?: RequestOptions): APIPromise<void>;
 }
 /**
  * View model for representing a public share of a session.
@@ -29,8 +83,7 @@ export interface ShareView {
     viewCount: number;
     lastViewedAt?: string | null;
 }
-export type PublicShareDeleteResponse = unknown;
 export declare namespace PublicShare {
-    export { type ShareView as ShareView, type PublicShareDeleteResponse as PublicShareDeleteResponse };
+    export { type ShareView as ShareView };
 }
 //# sourceMappingURL=public-share.d.ts.map

package/resources/sessions/public-share.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-share.d.ts","sourceRoot":"","sources":["../../src/resources/sessions/public-share.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC;IAI1E;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC;IAI5E;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;CAGzE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,MAAM,CAAC;IAEjB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC;AAEhD,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EAAE,KAAK,SAAS,IAAI,SAAS,EAAE,KAAK,yBAAyB,IAAI,yBAAyB,EAAE,CAAC;CACrG"}
+{"version":3,"file":"public-share.d.ts","sourceRoot":"","sources":["../../src/resources/sessions/public-share.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC;IAI1E;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC;IAI5E;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAMtE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,MAAM,CAAC;IAEjB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EAAE,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;CACxC"}

package/resources/sessions/public-share.js

@@ -3,25 +3,83 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PublicShare = void 0;
 const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
 const path_1 = require("../../internal/utils/path.js");
 class PublicShare extends resource_1.APIResource {
     /**
-     * Create Session Public Share
+     * Create a public share for a session.
+     *
+     * Generates a public sharing link that allows anyone with the URL to view the
+     * session and its tasks. If a public share already exists for the session, it will
+     * return the existing share instead of creating a new one.
+     *
+     * Public shares are useful for:
+     *
+     * - Sharing results with clients or team members
+     * - Demonstrating AI agent capabilities
+     * - Collaborative review of automated tasks
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session to share
+     *
+     * Returns:
+     *
+     * - Public share information including the share URL and usage statistics
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
     create(sessionID, options) {
         return this._client.post((0, path_1.path) `/sessions/${sessionID}/public-share`, options);
     }
     /**
-     * Get Session Public Share
+     * Get information about the public share for a session.
+     *
+     * Retrieves details about the public sharing link for a session, including the
+     * share token, public URL, view count, and last viewed timestamp. This is useful
+     * for monitoring how your shared sessions are being accessed.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session
+     *
+     * Returns:
+     *
+     * - Public share information including the share URL and usage statistics
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist or doesn't have a public share
      */
     retrieve(sessionID, options) {
         return this._client.get((0, path_1.path) `/sessions/${sessionID}/public-share`, options);
     }
     /**
-     * Delete Session Public Share
+     * Remove the public share for a session.
+     *
+     * Deletes the public sharing link for a session, making it no longer accessible to
+     * anyone with the previous share URL. This is useful for removing access to
+     * sensitive sessions or when you no longer want to share the results.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session
+     *
+     * Returns:
+     *
+     * - 204 No Content on successful deletion (idempotent)
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
     delete(sessionID, options) {
-        return this._client.delete((0, path_1.path) `/sessions/${sessionID}/public-share`, options);
+        return this._client.delete((0, path_1.path) `/sessions/${sessionID}/public-share`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
     }
 }
 exports.PublicShare = PublicShare;

package/resources/sessions/public-share.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-share.js","sourceRoot":"","sources":["../../src/resources/sessions/public-share.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AAEjD,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;CACF;AArBD,kCAqBC"}
+{"version":3,"file":"public-share.js","sourceRoot":"","sources":["../../src/resources/sessions/public-share.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,eAAe,EAAE;YACpE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA9ED,kCA8EC"}

package/resources/sessions/public-share.mjs

@@ -1,24 +1,82 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
 import { path } from "../../internal/utils/path.mjs";
 export class PublicShare extends APIResource {
     /**
-     * Create Session Public Share
+     * Create a public share for a session.
+     *
+     * Generates a public sharing link that allows anyone with the URL to view the
+     * session and its tasks. If a public share already exists for the session, it will
+     * return the existing share instead of creating a new one.
+     *
+     * Public shares are useful for:
+     *
+     * - Sharing results with clients or team members
+     * - Demonstrating AI agent capabilities
+     * - Collaborative review of automated tasks
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session to share
+     *
+     * Returns:
+     *
+     * - Public share information including the share URL and usage statistics
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
     create(sessionID, options) {
         return this._client.post(path `/sessions/${sessionID}/public-share`, options);
     }
     /**
-     * Get Session Public Share
+     * Get information about the public share for a session.
+     *
+     * Retrieves details about the public sharing link for a session, including the
+     * share token, public URL, view count, and last viewed timestamp. This is useful
+     * for monitoring how your shared sessions are being accessed.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session
+     *
+     * Returns:
+     *
+     * - Public share information including the share URL and usage statistics
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist or doesn't have a public share
      */
     retrieve(sessionID, options) {
         return this._client.get(path `/sessions/${sessionID}/public-share`, options);
     }
     /**
-     * Delete Session Public Share
+     * Remove the public share for a session.
+     *
+     * Deletes the public sharing link for a session, making it no longer accessible to
+     * anyone with the previous share URL. This is useful for removing access to
+     * sensitive sessions or when you no longer want to share the results.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session
+     *
+     * Returns:
+     *
+     * - 204 No Content on successful deletion (idempotent)
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
     delete(sessionID, options) {
-        return this._client.delete(path `/sessions/${sessionID}/public-share`, options);
+        return this._client.delete(path `/sessions/${sessionID}/public-share`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
     }
 }
 //# sourceMappingURL=public-share.mjs.map

package/resources/sessions/public-share.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"public-share.mjs","sourceRoot":"","sources":["../../src/resources/sessions/public-share.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;CACF"}
+{"version":3,"file":"public-share.mjs","sourceRoot":"","sources":["../../src/resources/sessions/public-share.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,SAAS,eAAe,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,SAAS,eAAe,EAAE;YACpE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/sessions/sessions.d.mts

@@ -1,30 +1,101 @@
 import { APIResource } from "../../core/resource.mjs";
+import * as SessionsAPI from "./sessions.mjs";
 import * as TasksAPI from "../tasks.mjs";
 import * as PublicShareAPI from "./public-share.mjs";
-import { PublicShare, PublicShareDeleteResponse, ShareView } from "./public-share.mjs";
+import { PublicShare, ShareView } from "./public-share.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Sessions extends APIResource {
     publicShare: PublicShareAPI.PublicShare;
     /**
-     * Get Session
+     * Get detailed information about a specific AI agent session.
+     *
+     * Retrieves comprehensive information about a session, including its current
+     * status, live browser URL (if active), recording URL (if completed), and optional
+     * task details. This endpoint is useful for monitoring active sessions or
+     * reviewing completed ones.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session
+     * - params: Optional parameters to control what data is included
+     *
+     * Returns:
+     *
+     * - Complete session information including status, URLs, and optional task details
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
     retrieve(sessionID: string, query?: SessionRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<SessionView>;
     /**
-     * Update Session
+     * Update a session's status or perform actions on it.
+     *
+     * Currently supports stopping a session, which will:
+     *
+     * 1. Stop any running tasks in the session
+     * 2. End the browser session
+     * 3. Generate a recording URL if available
+     * 4. Update the session status to 'stopped'
+     *
+     * This is useful for manually stopping long-running sessions or when you want to
+     * end a session before all tasks are complete.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session to update
+     * - request: The action to perform on the session
+     *
+     * Returns:
+     *
+     * - The updated session information including the new status and recording URL
+     *
+     * Raises:
+     *
+     * - 404: If the user agent session doesn't exist
      */
     update(sessionID: string, body: SessionUpdateParams, options?: RequestOptions): APIPromise<SessionView>;
     /**
-     * List Sessions
+     * Get a paginated list of all AI agent sessions for the authenticated user.
+     *
+     * AI agent sessions represent active or completed browsing sessions where your AI
+     * agents perform tasks. Each session can contain multiple tasks and maintains
+     * browser state throughout the session lifecycle.
+     *
+     * You can filter sessions by status and optionally include task details for each
+     * session.
+     *
+     * Returns:
+     *
+     * - A paginated list of agent sessions
+     * - Total count of sessions
+     * - Page information for navigation
+     * - Optional task details for each session (if requested)
      */
     list(query?: SessionListParams | null | undefined, options?: RequestOptions): APIPromise<SessionListResponse>;
+    /**
+     * Delete a session and all its associated data.
+     *
+     * Permanently removes a session and all its tasks, browser data, and public
+     * shares. This action cannot be undone. Use this endpoint to clean up old sessions
+     * and free up storage space.
+     *
+     * Args:
+     *
+     * - session_id: The unique identifier of the agent session to delete
+     *
+     * Returns:
+     *
+     * - 204 No Content on successful deletion (idempotent)
+     */
+    delete(sessionID: string, options?: RequestOptions): APIPromise<void>;
 }
 /**
  * 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)
+ * Attributes: ACTIVE: Session is currently active and running (browser is running)
+ * STOPPED: Session has been stopped and is no longer active (browser is stopped)
  */
 export type SessionStatus = 'active' | 'stopped';
 /**
@@ -32,11 +103,11 @@ export type SessionStatus = 'active' | 'stopped';
  *
  * 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).
+ * real-time. started_at: Timestamp when the session was created and started.
+ * finished_at: Timestamp when the session was stopped (None if still active).
+ * tasks: Optional list of tasks associated with this session. record_url: URL to
+ * access the recorded session playback. public_share_url: Optional URL to access
+ * the public share of the session.
  */
 export interface SessionView {
     id: string;
@@ -44,16 +115,15 @@ export interface SessionView {
     /**
      * 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)
+     * Attributes: ACTIVE: Session is currently active and running (browser is running)
+     * STOPPED: Session has been stopped and is no longer active (browser is stopped)
      */
     status: SessionStatus;
     finishedAt?: string | null;
     liveUrl?: string | null;
     publicShareUrl?: string | null;
     recordUrl?: string | null;
-    tasks?: Array<TasksAPI.TaskView> | null;
+    tasks?: Array<TasksAPI.TaskItemView> | null;
 }
 /**
  * Response model for paginated session list requests
@@ -61,11 +131,36 @@ export interface SessionView {
  * Attributes: items: List of session views for the current page
  */
 export interface SessionListResponse {
-    items: Array<SessionView>;
+    items: Array<SessionListResponse.Item>;
     pageNumber: number;
     pageSize: number;
     totalItems: number;
 }
+export declare namespace SessionListResponse {
+    /**
+     * 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. started_at: Timestamp when the session was created and started.
+     * finished_at: Timestamp when the session was stopped (None if still active).
+     * tasks: Optional list of tasks associated with this session.
+     */
+    interface Item {
+        id: string;
+        startedAt: string;
+        /**
+         * Enumeration of possible (browser) session states
+         *
+         * Attributes: ACTIVE: Session is currently active and running (browser is running)
+         * STOPPED: Session has been stopped and is no longer active (browser is stopped)
+         */
+        status: SessionsAPI.SessionStatus;
+        finishedAt?: string | null;
+        liveUrl?: string | null;
+        tasks?: Array<TasksAPI.TaskItemView> | null;
+    }
+}
 export interface SessionRetrieveParams {
     includeTasks?: boolean;
 }
@@ -73,7 +168,8 @@ export interface SessionUpdateParams {
     /**
      * Available actions that can be performed on a session
      *
-     * Attributes: STOP: Stop the session and all its associated tasks
+     * Attributes: STOP: Stop the session and all its associated tasks (cannot be
+     * undone)
      */
     action: 'stop';
 }
@@ -81,9 +177,8 @@ 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)
+     * Attributes: ACTIVE: Session is currently active and running (browser is running)
+     * STOPPED: Session has been stopped and is no longer active (browser is stopped)
      */
     filterBy?: SessionStatus | null;
     includeTasks?: boolean;
@@ -92,6 +187,6 @@ export interface SessionListParams {
 }
 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, };
+    export { PublicShare as PublicShare, type ShareView as ShareView };
 }
 //# sourceMappingURL=sessions.d.mts.map

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

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