@airtop/sdk 0.1.37-beta1 → 0.1.37

package/serialization/resources/sessions/types/SessionsEventsResponse.d.ts

@@ -4,20 +4,14 @@
 import * as serializers from "../../../index";
 import * as Airtop from "../../../../api/index";
 import * as core from "../../../../core";
-import { SessionsEventsResponseSessionEvent } from "./SessionsEventsResponseSessionEvent";
-import { SessionsEventsResponseFileEvent } from "./SessionsEventsResponseFileEvent";
 import { SessionsEventsResponseStatus } from "./SessionsEventsResponseStatus";
 import { SessionsEventsResponseError } from "./SessionsEventsResponseError";
 import { SessionsEventsResponseWindowEvent } from "./SessionsEventsResponseWindowEvent";
+import { SessionsEventsResponseSessionEvent } from "./SessionsEventsResponseSessionEvent";
+import { SessionsEventsResponseFileEvent } from "./SessionsEventsResponseFileEvent";
 export declare const SessionsEventsResponse: core.serialization.Schema<serializers.SessionsEventsResponse.Raw, Airtop.SessionsEventsResponse>;
 export declare namespace SessionsEventsResponse {
-    type Raw = SessionsEventsResponse.SessionEvent | SessionsEventsResponse.FileEvent | SessionsEventsResponse.Status | SessionsEventsResponse.Error | SessionsEventsResponse.WindowEvent;
-    interface SessionEvent extends SessionsEventsResponseSessionEvent.Raw {
-        event: "sessionEvent";
-    }
-    interface FileEvent extends SessionsEventsResponseFileEvent.Raw {
-        event: "fileEvent";
-    }
+    type Raw = SessionsEventsResponse.Status | SessionsEventsResponse.Error | SessionsEventsResponse.WindowEvent | SessionsEventsResponse.SessionEvent | SessionsEventsResponse.FileEvent;
     interface Status extends SessionsEventsResponseStatus.Raw {
         event: "status";
     }
@@ -27,4 +21,10 @@ export declare namespace SessionsEventsResponse {
     interface WindowEvent extends SessionsEventsResponseWindowEvent.Raw {
         event: "windowEvent";
     }
+    interface SessionEvent extends SessionsEventsResponseSessionEvent.Raw {
+        event: "sessionEvent";
+    }
+    interface FileEvent extends SessionsEventsResponseFileEvent.Raw {
+        event: "fileEvent";
+    }
 }

package/serialization/resources/sessions/types/SessionsEventsResponse.js

@@ -38,18 +38,18 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionsEventsResponse = void 0;
 const core = __importStar(require("../../../../core"));
-const SessionsEventsResponseSessionEvent_1 = require("./SessionsEventsResponseSessionEvent");
-const SessionsEventsResponseFileEvent_1 = require("./SessionsEventsResponseFileEvent");
 const SessionsEventsResponseStatus_1 = require("./SessionsEventsResponseStatus");
 const SessionsEventsResponseError_1 = require("./SessionsEventsResponseError");
 const SessionsEventsResponseWindowEvent_1 = require("./SessionsEventsResponseWindowEvent");
+const SessionsEventsResponseSessionEvent_1 = require("./SessionsEventsResponseSessionEvent");
+const SessionsEventsResponseFileEvent_1 = require("./SessionsEventsResponseFileEvent");
 exports.SessionsEventsResponse = core.serialization
     .union("event", {
-    sessionEvent: SessionsEventsResponseSessionEvent_1.SessionsEventsResponseSessionEvent,
-    fileEvent: SessionsEventsResponseFileEvent_1.SessionsEventsResponseFileEvent,
     status: SessionsEventsResponseStatus_1.SessionsEventsResponseStatus,
     error: SessionsEventsResponseError_1.SessionsEventsResponseError,
     windowEvent: SessionsEventsResponseWindowEvent_1.SessionsEventsResponseWindowEvent,
+    sessionEvent: SessionsEventsResponseSessionEvent_1.SessionsEventsResponseSessionEvent,
+    fileEvent: SessionsEventsResponseFileEvent_1.SessionsEventsResponseFileEvent,
 })
     .transform({
     transform: (value) => value,

package/serialization/resources/sessions/types/index.d.ts

@@ -1,7 +1,7 @@
 export * from "./SessionsListRequestStatus";
-export * from "./SessionsEventsResponseSessionEvent";
-export * from "./SessionsEventsResponseFileEvent";
 export * from "./SessionsEventsResponseStatus";
 export * from "./SessionsEventsResponseError";
 export * from "./SessionsEventsResponseWindowEvent";
+export * from "./SessionsEventsResponseSessionEvent";
+export * from "./SessionsEventsResponseFileEvent";
 export * from "./SessionsEventsResponse";

package/serialization/resources/sessions/types/index.js

@@ -15,9 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./SessionsListRequestStatus"), exports);
-__exportStar(require("./SessionsEventsResponseSessionEvent"), exports);
-__exportStar(require("./SessionsEventsResponseFileEvent"), exports);
 __exportStar(require("./SessionsEventsResponseStatus"), exports);
 __exportStar(require("./SessionsEventsResponseError"), exports);
 __exportStar(require("./SessionsEventsResponseWindowEvent"), exports);
+__exportStar(require("./SessionsEventsResponseSessionEvent"), exports);
+__exportStar(require("./SessionsEventsResponseFileEvent"), exports);
 __exportStar(require("./SessionsEventsResponse"), exports);

package/serialization/resources/windows/client/requests/index.d.ts

@@ -1,16 +1,7 @@
-export { AsyncClickRequest } from "./AsyncClickRequest";
 export { AsyncCreateAutomationRequest } from "./AsyncCreateAutomationRequest";
 export { AsyncCreateFormFillerRequest } from "./AsyncCreateFormFillerRequest";
 export { AsyncExecuteAutomationRequest } from "./AsyncExecuteAutomationRequest";
 export { AsyncFillFormRequest } from "./AsyncFillFormRequest";
-export { AsyncHoverRequest } from "./AsyncHoverRequest";
-export { AsyncMonitorRequest } from "./AsyncMonitorRequest";
-export { AsyncPageQueryRequest } from "./AsyncPageQueryRequest";
-export { AsyncPaginatedExtractionRequest } from "./AsyncPaginatedExtractionRequest";
-export { AsyncPromptContentRequest } from "./AsyncPromptContentRequest";
-export { AsyncScreenshotRequest } from "./AsyncScreenshotRequest";
-export { AsyncSummarizeContentRequest } from "./AsyncSummarizeContentRequest";
-export { AsyncTypeRequest } from "./AsyncTypeRequest";
 export { CreateWindowInputV1Body } from "./CreateWindowInputV1Body";
 export { WindowLoadUrlV1Body } from "./WindowLoadUrlV1Body";
 export { SessionClickHandlerRequestBody } from "./SessionClickHandlerRequestBody";
@@ -18,7 +9,6 @@ export { CreateFormFillerRequest } from "./CreateFormFillerRequest";
 export { FillFormRequest } from "./FillFormRequest";
 export { SessionHoverHandlerRequestBody } from "./SessionHoverHandlerRequestBody";
 export { SessionMonitorHandlerRequestBody } from "./SessionMonitorHandlerRequestBody";
-export { OperatorPromptV1Body } from "./OperatorPromptV1Body";
 export { SessionPaginatedExtractionHandlerRequestBody } from "./SessionPaginatedExtractionHandlerRequestBody";
 export { ScrapeContentRequest } from "./ScrapeContentRequest";
 export { SessionScreenshotHandlerRequestBody } from "./SessionScreenshotHandlerRequestBody";

package/serialization/resources/windows/client/requests/index.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionTypeHandlerRequestBody = exports.SessionSummaryHandlerRequestBody = exports.SessionScrollHandlerRequestBody = exports.SessionScreenshotHandlerRequestBody = exports.ScrapeContentRequest = exports.SessionPaginatedExtractionHandlerRequestBody = exports.OperatorPromptV1Body = exports.SessionMonitorHandlerRequestBody = exports.SessionHoverHandlerRequestBody = exports.FillFormRequest = exports.CreateFormFillerRequest = exports.SessionClickHandlerRequestBody = exports.WindowLoadUrlV1Body = exports.CreateWindowInputV1Body = exports.AsyncTypeRequest = exports.AsyncSummarizeContentRequest = exports.AsyncScreenshotRequest = exports.AsyncPromptContentRequest = exports.AsyncPaginatedExtractionRequest = exports.AsyncPageQueryRequest = exports.AsyncMonitorRequest = exports.AsyncHoverRequest = exports.AsyncFillFormRequest = exports.AsyncExecuteAutomationRequest = exports.AsyncCreateFormFillerRequest = exports.AsyncCreateAutomationRequest = exports.AsyncClickRequest = void 0;
-var AsyncClickRequest_1 = require("./AsyncClickRequest");
-Object.defineProperty(exports, "AsyncClickRequest", { enumerable: true, get: function () { return AsyncClickRequest_1.AsyncClickRequest; } });
+exports.SessionTypeHandlerRequestBody = exports.SessionSummaryHandlerRequestBody = exports.SessionScrollHandlerRequestBody = exports.SessionScreenshotHandlerRequestBody = exports.ScrapeContentRequest = exports.SessionPaginatedExtractionHandlerRequestBody = exports.SessionMonitorHandlerRequestBody = exports.SessionHoverHandlerRequestBody = exports.FillFormRequest = exports.CreateFormFillerRequest = exports.SessionClickHandlerRequestBody = exports.WindowLoadUrlV1Body = exports.CreateWindowInputV1Body = exports.AsyncFillFormRequest = exports.AsyncExecuteAutomationRequest = exports.AsyncCreateFormFillerRequest = exports.AsyncCreateAutomationRequest = void 0;
 var AsyncCreateAutomationRequest_1 = require("./AsyncCreateAutomationRequest");
 Object.defineProperty(exports, "AsyncCreateAutomationRequest", { enumerable: true, get: function () { return AsyncCreateAutomationRequest_1.AsyncCreateAutomationRequest; } });
 var AsyncCreateFormFillerRequest_1 = require("./AsyncCreateFormFillerRequest");
@@ -11,22 +9,6 @@ var AsyncExecuteAutomationRequest_1 = require("./AsyncExecuteAutomationRequest")
 Object.defineProperty(exports, "AsyncExecuteAutomationRequest", { enumerable: true, get: function () { return AsyncExecuteAutomationRequest_1.AsyncExecuteAutomationRequest; } });
 var AsyncFillFormRequest_1 = require("./AsyncFillFormRequest");
 Object.defineProperty(exports, "AsyncFillFormRequest", { enumerable: true, get: function () { return AsyncFillFormRequest_1.AsyncFillFormRequest; } });
-var AsyncHoverRequest_1 = require("./AsyncHoverRequest");
-Object.defineProperty(exports, "AsyncHoverRequest", { enumerable: true, get: function () { return AsyncHoverRequest_1.AsyncHoverRequest; } });
-var AsyncMonitorRequest_1 = require("./AsyncMonitorRequest");
-Object.defineProperty(exports, "AsyncMonitorRequest", { enumerable: true, get: function () { return AsyncMonitorRequest_1.AsyncMonitorRequest; } });
-var AsyncPageQueryRequest_1 = require("./AsyncPageQueryRequest");
-Object.defineProperty(exports, "AsyncPageQueryRequest", { enumerable: true, get: function () { return AsyncPageQueryRequest_1.AsyncPageQueryRequest; } });
-var AsyncPaginatedExtractionRequest_1 = require("./AsyncPaginatedExtractionRequest");
-Object.defineProperty(exports, "AsyncPaginatedExtractionRequest", { enumerable: true, get: function () { return AsyncPaginatedExtractionRequest_1.AsyncPaginatedExtractionRequest; } });
-var AsyncPromptContentRequest_1 = require("./AsyncPromptContentRequest");
-Object.defineProperty(exports, "AsyncPromptContentRequest", { enumerable: true, get: function () { return AsyncPromptContentRequest_1.AsyncPromptContentRequest; } });
-var AsyncScreenshotRequest_1 = require("./AsyncScreenshotRequest");
-Object.defineProperty(exports, "AsyncScreenshotRequest", { enumerable: true, get: function () { return AsyncScreenshotRequest_1.AsyncScreenshotRequest; } });
-var AsyncSummarizeContentRequest_1 = require("./AsyncSummarizeContentRequest");
-Object.defineProperty(exports, "AsyncSummarizeContentRequest", { enumerable: true, get: function () { return AsyncSummarizeContentRequest_1.AsyncSummarizeContentRequest; } });
-var AsyncTypeRequest_1 = require("./AsyncTypeRequest");
-Object.defineProperty(exports, "AsyncTypeRequest", { enumerable: true, get: function () { return AsyncTypeRequest_1.AsyncTypeRequest; } });
 var CreateWindowInputV1Body_1 = require("./CreateWindowInputV1Body");
 Object.defineProperty(exports, "CreateWindowInputV1Body", { enumerable: true, get: function () { return CreateWindowInputV1Body_1.CreateWindowInputV1Body; } });
 var WindowLoadUrlV1Body_1 = require("./WindowLoadUrlV1Body");
@@ -41,8 +23,6 @@ var SessionHoverHandlerRequestBody_1 = require("./SessionHoverHandlerRequestBody
 Object.defineProperty(exports, "SessionHoverHandlerRequestBody", { enumerable: true, get: function () { return SessionHoverHandlerRequestBody_1.SessionHoverHandlerRequestBody; } });
 var SessionMonitorHandlerRequestBody_1 = require("./SessionMonitorHandlerRequestBody");
 Object.defineProperty(exports, "SessionMonitorHandlerRequestBody", { enumerable: true, get: function () { return SessionMonitorHandlerRequestBody_1.SessionMonitorHandlerRequestBody; } });
-var OperatorPromptV1Body_1 = require("./OperatorPromptV1Body");
-Object.defineProperty(exports, "OperatorPromptV1Body", { enumerable: true, get: function () { return OperatorPromptV1Body_1.OperatorPromptV1Body; } });
 var SessionPaginatedExtractionHandlerRequestBody_1 = require("./SessionPaginatedExtractionHandlerRequestBody");
 Object.defineProperty(exports, "SessionPaginatedExtractionHandlerRequestBody", { enumerable: true, get: function () { return SessionPaginatedExtractionHandlerRequestBody_1.SessionPaginatedExtractionHandlerRequestBody; } });
 var ScrapeContentRequest_1 = require("./ScrapeContentRequest");

package/serialization/types/index.d.ts

@@ -1,7 +1,6 @@
 export * from "./AiPromptResponse";
 export * from "./AiResponseEnvelope";
 export * from "./AsyncConfig";
-export * from "./AsyncOperatorPromptResponseEnvelope";
 export * from "./AsyncSessionAiResponseEnvelope";
 export * from "./AutomationOutput";
 export * from "./BrowserWaitNavigationConfigWaitUntil";

package/serialization/types/index.js

@@ -17,7 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AiPromptResponse"), exports);
 __exportStar(require("./AiResponseEnvelope"), exports);
 __exportStar(require("./AsyncConfig"), exports);
-__exportStar(require("./AsyncOperatorPromptResponseEnvelope"), exports);
 __exportStar(require("./AsyncSessionAiResponseEnvelope"), exports);
 __exportStar(require("./AutomationOutput"), exports);
 __exportStar(require("./BrowserWaitNavigationConfigWaitUntil"), exports);

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.37-beta1";
+export declare const SDK_VERSION = "0.1.37";

package/version.js

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

package/wrapper/AirtopSessions.d.ts

@@ -31,34 +31,33 @@ export declare class AirtopSessions extends SessionsClass {
     /**
      * Waits for a file to be downloaded in a session and reach 'available' status.
      * Defaults to looking back 5 seconds in the event stream for the file to be available.
-     * Use `includePriorEvents` and `lookbackSeconds` to control this behavior.
+     * Use `lookbackSeconds` to control this behavior.
      *
-     * @param {Object} params - The parameters for the function
-     * @param {string} params.sessionId - The ID of the session to monitor
-     * @param {boolean} [params.includePriorEvents=true] - Whether to include prior events in the wait. Default `true`.
-     * @param {number} [params.lookbackSeconds=5] - The number of seconds to look back for prior events. Default `5`.
+     * @param {string} sessionId - The ID of the session to monitor
+     * @param {Object} configuration - The optional configuration parameters for the function
+     * @param {number} [configuration.lookbackSeconds=5] - The number of seconds to look back for prior events. Default `5`. 0 means no lookback.
      * @param {Sessions.RequestOptions} [requestOptions] - Optional request configuration including timeout
      * @returns {Promise<{ id: string, downloadUrl: string } | null>} Object containing file's id and downloadUrl, or null if timed out
      */
     waitForDownload(sessionId: string, configuration?: {
-        includePriorEvents?: boolean;
         lookbackSeconds?: number;
     }, requestOptions?: SessionsNamespace.RequestOptions): Promise<{
         id: string;
         downloadUrl: string;
     } | null>;
     /**
-     * Waits for a file download to start in a session
+     * Waits for a file download to start in a session.
+     * Defaults to looking back 5 seconds in the event stream for the file to be available.
+     * Use `lookbackSeconds` to control this behavior.
      *
-     * @param {Object} params - The parameters for the function
-     * @param {string} params.sessionId - The ID of the session to monitor
-     * @param {boolean} [params.includePriorEvents=false] - Whether to include prior events in the wait
+     * @param {string} sessionId - The ID of the session to monitor
+     * @param {Object} configuration - The optional configuration parameters for the function
+     * @param {number} [configuration.lookbackSeconds=5] - The number of seconds to look back for prior events. Default `5`. 0 means no lookback.
      * @param {Sessions.RequestOptions} [requestOptions] - Optional request configuration including timeout
      * @returns {Promise<{ id: string, downloadUrl: string } | null>} Object containing file's id and downloadUrl, or null if timed out
      */
-    waitForDownloadStart({ sessionId, includePriorEvents }: {
-        sessionId: string;
-        includePriorEvents?: boolean;
+    waitForDownloadStart(sessionId: string, configuration?: {
+        lookbackSeconds?: number;
     }, requestOptions?: SessionsNamespace.RequestOptions): Promise<{
         id: string;
         downloadUrl: string;
@@ -66,18 +65,18 @@ export declare class AirtopSessions extends SessionsClass {
     /**
      * Downloads the next file from a session as soon as it starts to become available
      *
-     * @param {Object} params - The parameters for the function
-     * @param {string} params.sessionId - The ID of the session to download from
-     * @param {string} params.destinationPath - The local path where the file should be saved
-     * @param {function} [params.onProgress] - Optional callback to track download progress
-     * @param {boolean} [params.includePriorEvents=false] - Whether to include prior events in the wait
+     * @param {string} sessionId - The ID of the session to download from
+     * @param {string} destinationPath - The local path where the file should be saved
+     * @param {Object} configuration - The optional configuration parameters for the function
+     * @param {function} [configuration.onProgress] - Optional callback to track download progress
+     * @param {number} [configuration.lookbackSeconds=5] - Optional number of seconds to look back for prior events. Default `5`. 0 means no lookback.
+     * @param {number} [configuration.timeoutSeconds=120] - Optional timeout in seconds. Default `120`.
      * @param {Sessions.RequestOptions} [requestOptions] - Optional request configuration including timeout
      * @throws Error if no file is available to download within the timeout period
      */
-    downloadNextFile({ sessionId, destinationPath, onProgress, includePriorEvents, }: {
-        sessionId: string;
-        destinationPath: string;
+    downloadNextFile(sessionId: string, destinationPath: string, configuration?: {
         onProgress?: (downloadedBytes: number, totalBytes: number) => void;
-        includePriorEvents?: boolean;
+        lookbackSeconds?: number;
+        timeoutSeconds?: number;
     }, requestOptions?: SessionsNamespace.RequestOptions): Promise<void>;
 }

package/wrapper/AirtopSessions.js

@@ -154,28 +154,31 @@ class AirtopSessions extends Client_1.Sessions {
     /**
      * Waits for a file to be downloaded in a session and reach 'available' status.
      * Defaults to looking back 5 seconds in the event stream for the file to be available.
-     * Use `includePriorEvents` and `lookbackSeconds` to control this behavior.
+     * Use `lookbackSeconds` to control this behavior.
      *
-     * @param {Object} params - The parameters for the function
-     * @param {string} params.sessionId - The ID of the session to monitor
-     * @param {boolean} [params.includePriorEvents=true] - Whether to include prior events in the wait. Default `true`.
-     * @param {number} [params.lookbackSeconds=5] - The number of seconds to look back for prior events. Default `5`.
+     * @param {string} sessionId - The ID of the session to monitor
+     * @param {Object} configuration - The optional configuration parameters for the function
+     * @param {number} [configuration.lookbackSeconds=5] - The number of seconds to look back for prior events. Default `5`. 0 means no lookback.
      * @param {Sessions.RequestOptions} [requestOptions] - Optional request configuration including timeout
      * @returns {Promise<{ id: string, downloadUrl: string } | null>} Object containing file's id and downloadUrl, or null if timed out
      */
     waitForDownload(sessionId, configuration, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { includePriorEvents = true, lookbackSeconds = 5 } = configuration || {};
+            const { lookbackSeconds = 5 } = configuration || {};
+            this.log(`waiting for file to be available on session: ${sessionId}`);
             const startTime = new Date();
             const timeoutSeconds = (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) || 120;
             // Create a promise that resolves to null after the timeout
             const timeoutPromise = new Promise((resolve) => {
-                setTimeout(() => resolve(null), timeoutSeconds * 1000);
+                setTimeout(() => {
+                    this.log(`waiting for file timed out after ${timeoutSeconds} seconds`);
+                    resolve(null);
+                }, timeoutSeconds * 1000);
             });
             // Create a promise for the event processing
             const processEventsPromise = (() => __awaiter(this, void 0, void 0, function* () {
                 var _a, e_2, _b, _c;
-                const sessionEvents = yield this.events(sessionId, { all: includePriorEvents }, Object.assign({ timeoutInSeconds: timeoutSeconds }, (requestOptions || {})));
+                const sessionEvents = yield this.events(sessionId, { all: lookbackSeconds >= 0 }, Object.assign({ timeoutInSeconds: timeoutSeconds }, (requestOptions || {})));
                 try {
                     for (var _d = true, sessionEvents_2 = __asyncValues(sessionEvents), sessionEvents_2_1; sessionEvents_2_1 = yield sessionEvents_2.next(), _a = sessionEvents_2_1.done, !_a; _d = true) {
                         _c = sessionEvents_2_1.value;
@@ -213,16 +216,20 @@ class AirtopSessions extends Client_1.Sessions {
         });
     }
     /**
-     * Waits for a file download to start in a session
+     * Waits for a file download to start in a session.
+     * Defaults to looking back 5 seconds in the event stream for the file to be available.
+     * Use `lookbackSeconds` to control this behavior.
      *
-     * @param {Object} params - The parameters for the function
-     * @param {string} params.sessionId - The ID of the session to monitor
-     * @param {boolean} [params.includePriorEvents=false] - Whether to include prior events in the wait
+     * @param {string} sessionId - The ID of the session to monitor
+     * @param {Object} configuration - The optional configuration parameters for the function
+     * @param {number} [configuration.lookbackSeconds=5] - The number of seconds to look back for prior events. Default `5`. 0 means no lookback.
      * @param {Sessions.RequestOptions} [requestOptions] - Optional request configuration including timeout
      * @returns {Promise<{ id: string, downloadUrl: string } | null>} Object containing file's id and downloadUrl, or null if timed out
      */
-    waitForDownloadStart(_a, requestOptions_1) {
-        return __awaiter(this, arguments, void 0, function* ({ sessionId, includePriorEvents = false }, requestOptions) {
+    waitForDownloadStart(sessionId, configuration, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { lookbackSeconds = 5 } = configuration || {};
+            const startTime = new Date();
             const timeoutSeconds = (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) || 60;
             // Create a promise that resolves to null after the timeout
             const timeoutPromise = new Promise((resolve) => {
@@ -231,7 +238,7 @@ class AirtopSessions extends Client_1.Sessions {
             // Create a promise for the event processing
             const processEventsPromise = (() => __awaiter(this, void 0, void 0, function* () {
                 var _a, e_3, _b, _c;
-                const sessionEvents = yield this.events(sessionId, { all: includePriorEvents }, Object.assign({ timeoutInSeconds: timeoutSeconds }, (requestOptions || {})));
+                const sessionEvents = yield this.events(sessionId, { all: lookbackSeconds >= 0 }, Object.assign({ timeoutInSeconds: timeoutSeconds }, (requestOptions || {})));
                 try {
                     for (var _d = true, sessionEvents_3 = __asyncValues(sessionEvents), sessionEvents_3_1; sessionEvents_3_1 = yield sessionEvents_3.next(), _a = sessionEvents_3_1.done, !_a; _d = true) {
                         _c = sessionEvents_3_1.value;
@@ -241,6 +248,12 @@ class AirtopSessions extends Client_1.Sessions {
                         if (e.event === 'file_status') {
                             this.log(`file_status message received:\n${JSON.stringify(event, null, 2)}`);
                             if (e.status === 'uploading') {
+                                const eventTime = Date.parse(e.eventTime);
+                                const thresholdTime = startTime.getTime() - lookbackSeconds * 1000;
+                                if (eventTime < thresholdTime) {
+                                    this.log(`skipping file uploading event for ${e.fileId} because its timestamp is earlier than lookbackSeconds`);
+                                    continue;
+                                }
                                 return {
                                     id: e.fileId,
                                     downloadUrl: e.downloadUrl,
@@ -265,18 +278,20 @@ class AirtopSessions extends Client_1.Sessions {
     /**
      * Downloads the next file from a session as soon as it starts to become available
      *
-     * @param {Object} params - The parameters for the function
-     * @param {string} params.sessionId - The ID of the session to download from
-     * @param {string} params.destinationPath - The local path where the file should be saved
-     * @param {function} [params.onProgress] - Optional callback to track download progress
-     * @param {boolean} [params.includePriorEvents=false] - Whether to include prior events in the wait
+     * @param {string} sessionId - The ID of the session to download from
+     * @param {string} destinationPath - The local path where the file should be saved
+     * @param {Object} configuration - The optional configuration parameters for the function
+     * @param {function} [configuration.onProgress] - Optional callback to track download progress
+     * @param {number} [configuration.lookbackSeconds=5] - Optional number of seconds to look back for prior events. Default `5`. 0 means no lookback.
+     * @param {number} [configuration.timeoutSeconds=120] - Optional timeout in seconds. Default `120`.
      * @param {Sessions.RequestOptions} [requestOptions] - Optional request configuration including timeout
      * @throws Error if no file is available to download within the timeout period
      */
-    downloadNextFile(_a, requestOptions_1) {
-        return __awaiter(this, arguments, void 0, function* ({ sessionId, destinationPath, onProgress, includePriorEvents = false, }, requestOptions) {
-            var _b;
-            const nextFile = yield this.waitForDownload(sessionId, { includePriorEvents }, requestOptions);
+    downloadNextFile(sessionId, destinationPath, configuration, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { onProgress = undefined, lookbackSeconds = 5, timeoutSeconds = 120 } = configuration || {};
+            const nextFile = yield this.waitForDownload(sessionId, { lookbackSeconds }, Object.assign({ timeoutInSeconds: timeoutSeconds }, (requestOptions || {})));
             if (!nextFile) {
                 throw new Error('No file to download within timeout');
             }
@@ -284,7 +299,7 @@ class AirtopSessions extends Client_1.Sessions {
             if (!downloadResponse.ok) {
                 throw new Error(`Failed to download file: ${downloadResponse.statusText}`);
             }
-            const totalBytes = Number.parseInt((_b = downloadResponse.headers.get('content-length')) !== null && _b !== void 0 ? _b : '0', 10);
+            const totalBytes = Number.parseInt((_a = downloadResponse.headers.get('content-length')) !== null && _a !== void 0 ? _a : '0', 10);
             let downloadedBytes = 0;
             fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
             const fileStream = fs.createWriteStream(destinationPath);

package/api/resources/windows/client/requests/AsyncClickRequest.d.ts

@@ -1,29 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Airtop from "../../../../index";
-/**
- * @example
- *     {
- *         elementDescription: "The login button"
- *     }
- */
-export interface AsyncClickRequest {
-    /** Async configuration options. */
-    async?: Airtop.AsyncConfig;
-    clientRequestId?: string;
-    /** Request configuration */
-    configuration?: Airtop.ClickConfig;
-    /** A credit threshold that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended). */
-    costThresholdCredits?: number;
-    /** A natural language description of the element to click. */
-    elementDescription: string;
-    /**
-     * A time threshold in seconds that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended).
-     *
-     * This setting does not extend the maximum session duration provided at the time of session creation.
-     */
-    timeThresholdSeconds?: number;
-    /** If true, Airtop AI will wait for the navigation to complete after clicking the element. */
-    waitForNavigation?: boolean;
-}

package/api/resources/windows/client/requests/AsyncClickRequest.js

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

package/api/resources/windows/client/requests/AsyncHoverRequest.d.ts

@@ -1,27 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Airtop from "../../../../index";
-/**
- * @example
- *     {
- *         elementDescription: "The search box input in the top right corner"
- *     }
- */
-export interface AsyncHoverRequest {
-    /** Async configuration options. */
-    async?: Airtop.AsyncConfig;
-    clientRequestId?: string;
-    /** Request configuration */
-    configuration?: Airtop.MicroInteractionConfigWithExperimental;
-    /** A credit threshold that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended). */
-    costThresholdCredits?: number;
-    /** A natural language description of where to hover (e.g. 'the search box', 'username field'). The interaction will be aborted if the target element cannot be found. */
-    elementDescription: string;
-    /**
-     * A time threshold in seconds that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended).
-     *
-     * This setting does not extend the maximum session duration provided at the time of session creation.
-     */
-    timeThresholdSeconds?: number;
-}

package/api/resources/windows/client/requests/AsyncHoverRequest.js

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

package/api/resources/windows/client/requests/AsyncMonitorRequest.d.ts

@@ -1,27 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Airtop from "../../../../index";
-/**
- * @example
- *     {
- *         condition: "Determine if the user appears to be signed in to the website"
- *     }
- */
-export interface AsyncMonitorRequest {
-    /** Async configuration options. */
-    async?: Airtop.AsyncConfig;
-    clientRequestId?: string;
-    /** A natural language description of the condition to monitor for in the browser window. */
-    condition: string;
-    /** Monitor configuration. If not specified, defaults to an interval monitor with a 5 second interval. */
-    configuration?: Airtop.MonitorConfig;
-    /** A credit threshold that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended). */
-    costThresholdCredits?: number;
-    /**
-     * A time threshold in seconds that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended).
-     *
-     * This setting does not extend the maximum session duration provided at the time of session creation.
-     */
-    timeThresholdSeconds?: number;
-}

package/api/resources/windows/client/requests/AsyncMonitorRequest.js

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

package/api/resources/windows/client/requests/AsyncPageQueryRequest.d.ts

@@ -1,29 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Airtop from "../../../../index";
-/**
- * @example
- *     {
- *         prompt: "What is the main idea of this page?"
- *     }
- */
-export interface AsyncPageQueryRequest {
-    /** Async configuration options. */
-    async?: Airtop.AsyncConfig;
-    clientRequestId?: string;
-    /** Request configuration */
-    configuration?: Airtop.PageQueryConfig;
-    /** A credit threshold that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended). */
-    costThresholdCredits?: number;
-    /** Make a best effort attempt to load more content items than are originally displayed on the page, e.g. by following pagination links, clicking controls to load more content, utilizing infinite scrolling, etc. This can be quite a bit more costly, but may be necessary for sites that require additional interaction to show the needed results. You can provide constraints in your prompt (e.g. on the total number of pages or results to consider). */
-    followPaginationLinks?: boolean;
-    /** The prompt to submit about the content in the browser window. */
-    prompt: string;
-    /**
-     * A time threshold in seconds that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended).
-     *
-     * This setting does not extend the maximum session duration provided at the time of session creation.
-     */
-    timeThresholdSeconds?: number;
-}

package/api/resources/windows/client/requests/AsyncPageQueryRequest.js

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

package/api/resources/windows/client/requests/AsyncPaginatedExtractionRequest.d.ts

@@ -1,27 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Airtop from "../../../../index";
-/**
- * @example
- *     {
- *         prompt: "This site contains a list of results about <provide details about the list>. Navigate through 3 pages of results and return the title and <provide details about the data you want to extract> about each result in this list."
- *     }
- */
-export interface AsyncPaginatedExtractionRequest {
-    /** Async configuration options. */
-    async?: Airtop.AsyncConfig;
-    clientRequestId?: string;
-    /** Request configuration */
-    configuration?: Airtop.PaginatedExtractionConfig;
-    /** A credit threshold that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended). */
-    costThresholdCredits?: number;
-    /** A prompt providing the Airtop AI model with additional direction or constraints about the page and the details you want to extract from the page. */
-    prompt: string;
-    /**
-     * A time threshold in seconds that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended).
-     *
-     * This setting does not extend the maximum session duration provided at the time of session creation.
-     */
-    timeThresholdSeconds?: number;
-}

package/api/resources/windows/client/requests/AsyncPaginatedExtractionRequest.js

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

package/api/resources/windows/client/requests/AsyncPromptContentRequest.d.ts

@@ -1,29 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Airtop from "../../../../index";
-/**
- * @example
- *     {
- *         prompt: "What is the main idea of this page?"
- *     }
- */
-export interface AsyncPromptContentRequest {
-    /** Async configuration options. */
-    async?: Airtop.AsyncConfig;
-    clientRequestId?: string;
-    /** Request configuration */
-    configuration?: Airtop.PageQueryConfig;
-    /** A credit threshold that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended). */
-    costThresholdCredits?: number;
-    /** Make a best effort attempt to load more content items than are originally displayed on the page, e.g. by following pagination links, clicking controls to load more content, utilizing infinite scrolling, etc. This can be quite a bit more costly, but may be necessary for sites that require additional interaction to show the needed results. You can provide constraints in your prompt (e.g. on the total number of pages or results to consider). */
-    followPaginationLinks?: boolean;
-    /** The prompt to submit about the content in the browser window. */
-    prompt: string;
-    /**
-     * A time threshold in seconds that, once exceeded, will cause the operation to be cancelled. Note that this is *not* a hard limit, but a threshold that is checked periodically during the course of fulfilling the request. A default threshold is used if not specified, but you can use this option to increase or decrease as needed. Set to 0 to disable this feature entirely (not recommended).
-     *
-     * This setting does not extend the maximum session duration provided at the time of session creation.
-     */
-    timeThresholdSeconds?: number;
-}

package/api/resources/windows/client/requests/AsyncPromptContentRequest.js

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