@airtop/sdk 1.0.0-alpha2.45 → 1.0.0-alpha2.47

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowCreateParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse, FileContentData } from '@airtop/core/resources/index.js';
+import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowCreateParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowFileInputParams, AIPromptResponse, WindowGetParams, ScrapeResponse, FileContentData } from '@airtop/core/resources/index.js';
 import * as index_js from '@airtop/core/resources/index.js';
 export { index_js as AirtopCore };
 export { AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
@@ -647,6 +647,30 @@ interface ExtendedServicePromptParameters extends Omit<ServicePromptParameters,
  */
 interface SessionServiceResponse extends ServicePromptActionResponseEnvelope {
 }
+interface UploadFileConfig {
+    /**
+     * Name of the file, must be unique within the session the file is used with
+     */
+    fileName?: string;
+    /**
+     * Type of the file
+     */
+    fileType?: "browser_download" | "screenshot" | "recording" | "customer_upload" | "web_archive";
+    /**
+     * IDs of the associated sessions
+     */
+    sessionIds?: Array<string> | null;
+    /**
+     * wait for upload to complete
+     */
+    waitForUpload?: boolean;
+    /**
+     * push file to session
+     */
+    pushToSession?: boolean;
+}
+interface WaitForUploadResult extends WaitForDownloadResult {
+}
 
 /**
  * Common data found in a window API call response.
@@ -721,6 +745,25 @@ interface AirtopWindowGetInfoResponse extends AirtopWindowCreateResponse {
      */
     data: WindowInfoData;
 }
+/**
+ * Configuration options for the file input operation.
+ */
+interface WindowFileInputConfig extends Omit<WindowFileInputParams, "sessionId"> {
+}
+/**
+ * Response from a file input operation.
+ */
+interface WindowFileInputResponse extends AIPromptResponse {
+}
+/**
+ * Configuration options for the upload file and select input operation.
+ */
+interface UploadFileAndSelectInputConfig {
+    /**
+     * The path to the file to upload.
+     */
+    filePath: string;
+}
 
 /**
  * Configuration parameters for typing text in a window.
@@ -1158,6 +1201,23 @@ declare class AirtopWindowClient extends AirtopBase {
      * @returns Promise resolving to the computer use operation result
      */
     computerUse(prompt: string, config?: WindowComputerUseConfig, requestOptions?: AirtopRequestOptions): Promise<WindowComputerUseResponse>;
+    /**
+     * fileInput fills out a file input field in the window, using a file from the session
+     * @param fileId - The ID of the file to use
+     * @param config - Configuration options for the file input
+     * @param requestOptions - Request options
+     * @returns Promise resolving to the file input operation result
+     */
+    fileInput(fileId: string, config?: WindowFileInputConfig, requestOptions?: AirtopRequestOptions): Promise<AIPromptResponse>;
+    /**
+     * uploadFileAndSelectInput uploads a file to the session, gets it ready to upload,
+     * and selects the file in the indicated input field
+     * @param filePath - The path to the file to upload
+     * @param config - Configuration options for the upload file and select input operation
+     * @param requestOptions - Request options
+     * @returns Promise resolving to the upload file and select input operation result
+     */
+    uploadFileAndSelectInput({ filePath }: UploadFileAndSelectInputConfig, config?: WindowFileInputConfig, requestOptions?: AirtopRequestOptions): Promise<AIPromptResponse>;
 }
 
 /**
@@ -1312,6 +1372,27 @@ declare class AirtopSessionClient extends AirtopBase {
      * @returns Object containing file's id and downloadUrl, or null if timed out
      */
     waitForDownload(configuration?: WaitForDownloadConfig, requestOptions?: AirtopRequestOptions): Promise<WaitForDownloadResult | null>;
+    /**
+     * Uploads a file to the session and waits for it to be available.
+     * @param filePath - The path to the file to upload
+     * @param options - Additional configuration options for uploading the file,
+     * @param options.fileName - The name of the file to upload, defaults to the basename of the file path
+     * @param options.fileType - The type of the file to upload, defaults to "customer_upload"
+     * @param options.sessionIds - The IDs of the sessions to upload the file to, defaults to the current session id
+     * @param options.waitForUpload - Whether to wait for the upload to complete, defaults to true
+     * @param options.pushToSession - Whether to push the file to the session, defaults to true, waits for the upload to complete regardless of waitForUpload setting
+     * @param requestOptions - Request options
+     * @returns the uploaded file result
+     */
+    uploadFile(filePath: string, options?: UploadFileConfig, requestOptions?: AirtopRequestOptions): Promise<WaitForUploadResult>;
+    /**
+     * Waits for a file to be uploaded, pushed to a session, then reach 'available' status. Throws an error if the file upload fails or times out.
+     * @param fileId - The ID of the file to wait for
+     * @param waitType - The type of wait to perform, "uploaded": just the file being uploaded to Airtop, "pushed": the file being pushed to a session
+     * @param timeoutSeconds - The timeout in seconds, defaults to 300
+     * @returns void
+     */
+    waitForUpload(fileId: string, waitType?: "uploaded" | "pushed", timeoutSeconds?: number): Promise<void>;
 }
 
 /**
@@ -1793,4 +1874,4 @@ interface AirtopPluginRegistration {
  */
 declare function registerAirtopPlugin(plugin: AirtopPluginRegistration): void;
 
-export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentPublishAgentParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, AirtopFile, AirtopFileClient, type AirtopFileCreateResponse, type AirtopFileGetResponse, type AirtopFileListParams, type AirtopFileListResponse, type AirtopFileListWithInstancesResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonFileResponse, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type ExtendedServicePromptParameters, type FileCreateData, type FileData, type FileError, type FileListData, type FileMetadata, type FileStatusEvent, type FileWarning, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionServiceResponse, type SessionWarning, type WaitForDownloadConfig, type WaitForDownloadResult, type WindowActConfig, type WindowActResponse, type WindowClickConfig, type WindowComputerUseConfig, type WindowComputerUseResponse, type WindowCreateData, type WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmFileContentData, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };
+export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentPublishAgentParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, AirtopFile, AirtopFileClient, type AirtopFileCreateResponse, type AirtopFileGetResponse, type AirtopFileListParams, type AirtopFileListResponse, type AirtopFileListWithInstancesResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonFileResponse, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type ExtendedServicePromptParameters, type FileCreateData, type FileData, type FileError, type FileListData, type FileMetadata, type FileStatusEvent, type FileWarning, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionServiceResponse, type SessionWarning, type UploadFileAndSelectInputConfig, type UploadFileConfig, type WaitForDownloadConfig, type WaitForDownloadResult, type WaitForUploadResult, type WindowActConfig, type WindowActResponse, type WindowClickConfig, type WindowComputerUseConfig, type WindowComputerUseResponse, type WindowCreateData, type WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFileInputConfig, type WindowFileInputResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmFileContentData, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowCreateParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse, FileContentData } from '@airtop/core/resources/index.js';
+import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowCreateParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowFileInputParams, AIPromptResponse, WindowGetParams, ScrapeResponse, FileContentData } from '@airtop/core/resources/index.js';
 import * as index_js from '@airtop/core/resources/index.js';
 export { index_js as AirtopCore };
 export { AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
@@ -647,6 +647,30 @@ interface ExtendedServicePromptParameters extends Omit<ServicePromptParameters,
  */
 interface SessionServiceResponse extends ServicePromptActionResponseEnvelope {
 }
+interface UploadFileConfig {
+    /**
+     * Name of the file, must be unique within the session the file is used with
+     */
+    fileName?: string;
+    /**
+     * Type of the file
+     */
+    fileType?: "browser_download" | "screenshot" | "recording" | "customer_upload" | "web_archive";
+    /**
+     * IDs of the associated sessions
+     */
+    sessionIds?: Array<string> | null;
+    /**
+     * wait for upload to complete
+     */
+    waitForUpload?: boolean;
+    /**
+     * push file to session
+     */
+    pushToSession?: boolean;
+}
+interface WaitForUploadResult extends WaitForDownloadResult {
+}
 
 /**
  * Common data found in a window API call response.
@@ -721,6 +745,25 @@ interface AirtopWindowGetInfoResponse extends AirtopWindowCreateResponse {
      */
     data: WindowInfoData;
 }
+/**
+ * Configuration options for the file input operation.
+ */
+interface WindowFileInputConfig extends Omit<WindowFileInputParams, "sessionId"> {
+}
+/**
+ * Response from a file input operation.
+ */
+interface WindowFileInputResponse extends AIPromptResponse {
+}
+/**
+ * Configuration options for the upload file and select input operation.
+ */
+interface UploadFileAndSelectInputConfig {
+    /**
+     * The path to the file to upload.
+     */
+    filePath: string;
+}
 
 /**
  * Configuration parameters for typing text in a window.
@@ -1158,6 +1201,23 @@ declare class AirtopWindowClient extends AirtopBase {
      * @returns Promise resolving to the computer use operation result
      */
     computerUse(prompt: string, config?: WindowComputerUseConfig, requestOptions?: AirtopRequestOptions): Promise<WindowComputerUseResponse>;
+    /**
+     * fileInput fills out a file input field in the window, using a file from the session
+     * @param fileId - The ID of the file to use
+     * @param config - Configuration options for the file input
+     * @param requestOptions - Request options
+     * @returns Promise resolving to the file input operation result
+     */
+    fileInput(fileId: string, config?: WindowFileInputConfig, requestOptions?: AirtopRequestOptions): Promise<AIPromptResponse>;
+    /**
+     * uploadFileAndSelectInput uploads a file to the session, gets it ready to upload,
+     * and selects the file in the indicated input field
+     * @param filePath - The path to the file to upload
+     * @param config - Configuration options for the upload file and select input operation
+     * @param requestOptions - Request options
+     * @returns Promise resolving to the upload file and select input operation result
+     */
+    uploadFileAndSelectInput({ filePath }: UploadFileAndSelectInputConfig, config?: WindowFileInputConfig, requestOptions?: AirtopRequestOptions): Promise<AIPromptResponse>;
 }
 
 /**
@@ -1312,6 +1372,27 @@ declare class AirtopSessionClient extends AirtopBase {
      * @returns Object containing file's id and downloadUrl, or null if timed out
      */
     waitForDownload(configuration?: WaitForDownloadConfig, requestOptions?: AirtopRequestOptions): Promise<WaitForDownloadResult | null>;
+    /**
+     * Uploads a file to the session and waits for it to be available.
+     * @param filePath - The path to the file to upload
+     * @param options - Additional configuration options for uploading the file,
+     * @param options.fileName - The name of the file to upload, defaults to the basename of the file path
+     * @param options.fileType - The type of the file to upload, defaults to "customer_upload"
+     * @param options.sessionIds - The IDs of the sessions to upload the file to, defaults to the current session id
+     * @param options.waitForUpload - Whether to wait for the upload to complete, defaults to true
+     * @param options.pushToSession - Whether to push the file to the session, defaults to true, waits for the upload to complete regardless of waitForUpload setting
+     * @param requestOptions - Request options
+     * @returns the uploaded file result
+     */
+    uploadFile(filePath: string, options?: UploadFileConfig, requestOptions?: AirtopRequestOptions): Promise<WaitForUploadResult>;
+    /**
+     * Waits for a file to be uploaded, pushed to a session, then reach 'available' status. Throws an error if the file upload fails or times out.
+     * @param fileId - The ID of the file to wait for
+     * @param waitType - The type of wait to perform, "uploaded": just the file being uploaded to Airtop, "pushed": the file being pushed to a session
+     * @param timeoutSeconds - The timeout in seconds, defaults to 300
+     * @returns void
+     */
+    waitForUpload(fileId: string, waitType?: "uploaded" | "pushed", timeoutSeconds?: number): Promise<void>;
 }
 
 /**
@@ -1793,4 +1874,4 @@ interface AirtopPluginRegistration {
  */
 declare function registerAirtopPlugin(plugin: AirtopPluginRegistration): void;
 
-export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentPublishAgentParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, AirtopFile, AirtopFileClient, type AirtopFileCreateResponse, type AirtopFileGetResponse, type AirtopFileListParams, type AirtopFileListResponse, type AirtopFileListWithInstancesResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonFileResponse, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type ExtendedServicePromptParameters, type FileCreateData, type FileData, type FileError, type FileListData, type FileMetadata, type FileStatusEvent, type FileWarning, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionServiceResponse, type SessionWarning, type WaitForDownloadConfig, type WaitForDownloadResult, type WindowActConfig, type WindowActResponse, type WindowClickConfig, type WindowComputerUseConfig, type WindowComputerUseResponse, type WindowCreateData, type WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmFileContentData, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };
+export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentPublishAgentParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, AirtopFile, AirtopFileClient, type AirtopFileCreateResponse, type AirtopFileGetResponse, type AirtopFileListParams, type AirtopFileListResponse, type AirtopFileListWithInstancesResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonFileResponse, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type ExtendedServicePromptParameters, type FileCreateData, type FileData, type FileError, type FileListData, type FileMetadata, type FileStatusEvent, type FileWarning, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionServiceResponse, type SessionWarning, type UploadFileAndSelectInputConfig, type UploadFileConfig, type WaitForDownloadConfig, type WaitForDownloadResult, type WaitForUploadResult, type WindowActConfig, type WindowActResponse, type WindowClickConfig, type WindowComputerUseConfig, type WindowComputerUseResponse, type WindowCreateData, type WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFileInputConfig, type WindowFileInputResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmFileContentData, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };

package/dist/index.js

@@ -9,7 +9,7 @@ var require_package = __commonJS({
     module.exports = {
       name: "@airtop/sdk",
       description: "Airtop SDK for TypeScript",
-      version: "1.0.0-alpha2.45",
+      version: "1.0.0-alpha2.47",
       type: "module",
       main: "./dist/index.cjs",
       module: "./dist/index.js",
@@ -51,7 +51,7 @@ var require_package = __commonJS({
         "@airtop/core": "0.1.0-alpha.53",
         "@airtop/json-schema-adapter": "workspace:*",
         "date-fns": "4.1.0",
-        loglayer: "8.4.1",
+        loglayer: "9.3.0",
         "serialize-error": "12.0.0",
         uuid: "11.1.0"
       },
@@ -370,6 +370,8 @@ var processLogMessage = (log, logLevel, ...args) => {
 };
 
 // src/session/AirtopSessionClient.ts
+import fs from "fs";
+import path from "path";
 import { NotFoundError } from "@airtop/core";
 
 // src/async-utils.ts
@@ -1174,6 +1176,41 @@ var AirtopWindowClient = class extends AirtopBase {
       requestOptions
     );
   }
+  /**
+   * fileInput fills out a file input field in the window, using a file from the session
+   * @param fileId - The ID of the file to use
+   * @param config - Configuration options for the file input
+   * @param requestOptions - Request options
+   * @returns Promise resolving to the file input operation result
+   */
+  async fileInput(fileId, config, requestOptions = {}) {
+    return await withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.fileInputAsync(
+        this.getWindowId(),
+        { sessionId: this.sessionId, ...config || {}, fileId },
+        { ...this.resolveRequestOptions(requestOptions) }
+      ),
+      requestOptions
+    );
+  }
+  /**
+   * uploadFileAndSelectInput uploads a file to the session, gets it ready to upload,
+   * and selects the file in the indicated input field
+   * @param filePath - The path to the file to upload
+   * @param config - Configuration options for the upload file and select input operation
+   * @param requestOptions - Request options
+   * @returns Promise resolving to the upload file and select input operation result
+   */
+  async uploadFileAndSelectInput({ filePath }, config, requestOptions = {}) {
+    const sessionClient = new AirtopSessionClient(this.getCommonConfig(), this.sessionId);
+    const file = await sessionClient.uploadFile(filePath, { pushToSession: true }, requestOptions);
+    return await this.fileInput(
+      file.id,
+      { ...config, fileId: file.id },
+      { ...this.resolveRequestOptions(requestOptions) }
+    );
+  }
 };
 
 // src/window/AirtopWindow.ts
@@ -1532,6 +1569,102 @@ ${JSON.stringify(event, null, 2)}`);
     })();
     return Promise.race([timeoutPromise, processEventsPromise]);
   }
+  /**
+   * Uploads a file to the session and waits for it to be available.
+   * @param filePath - The path to the file to upload
+   * @param options - Additional configuration options for uploading the file,
+   * @param options.fileName - The name of the file to upload, defaults to the basename of the file path
+   * @param options.fileType - The type of the file to upload, defaults to "customer_upload"
+   * @param options.sessionIds - The IDs of the sessions to upload the file to, defaults to the current session id
+   * @param options.waitForUpload - Whether to wait for the upload to complete, defaults to true
+   * @param options.pushToSession - Whether to push the file to the session, defaults to true, waits for the upload to complete regardless of waitForUpload setting
+   * @param requestOptions - Request options
+   * @returns the uploaded file result
+   */
+  async uploadFile(filePath, options = {}, requestOptions = {}) {
+    this.log.info(`uploading file ${filePath}`);
+    const fileName = options?.fileName ?? path.basename(filePath);
+    const fileType = options?.fileType ?? "customer_upload";
+    const sessionIds = options?.sessionIds ?? [this.sessionId];
+    const waitForUpload = options?.waitForUpload ?? true;
+    const pushToSession = options?.pushToSession ?? true;
+    const file = await this.client.files.createFile(
+      {
+        sessionIds,
+        fileName,
+        fileType
+      },
+      this.resolveRequestOptions(requestOptions)
+    );
+    const fileContent = fs.readFileSync(filePath);
+    if (waitForUpload || pushToSession) {
+      const uploadWaitPromise = this.waitForUpload(file.data.id, "uploaded");
+      fetch(file.data.uploadUrl, {
+        method: "PUT",
+        body: fileContent,
+        headers: {
+          "Content-Type": "application/octet-stream"
+        }
+      });
+      await uploadWaitPromise;
+    }
+    if (pushToSession) {
+      const pushWaitPromise = this.waitForUpload(file.data.id, "pushed");
+      this.client.files.push(file.data.id, {
+        sessionIds
+      });
+      await pushWaitPromise;
+    }
+    const fileDataResponse = await this.client.files.get(file.data.id);
+    const fileData = fileDataResponse.data;
+    return {
+      id: file.data.id,
+      downloadUrl: fileData.downloadUrl,
+      fileName: file.data.fileName,
+      fileType: file.data.fileType
+    };
+  }
+  /**
+   * Waits for a file to be uploaded, pushed to a session, then reach 'available' status. Throws an error if the file upload fails or times out.
+   * @param fileId - The ID of the file to wait for
+   * @param waitType - The type of wait to perform, "uploaded": just the file being uploaded to Airtop, "pushed": the file being pushed to a session
+   * @param timeoutSeconds - The timeout in seconds, defaults to 300
+   * @returns void
+   */
+  async waitForUpload(fileId, waitType = "uploaded", timeoutSeconds = 300) {
+    const waitEvent = waitType === "pushed" ? "file_upload_status" : "file_status";
+    const timeoutPromise = new Promise((_, reject) => {
+      setTimeout(() => {
+        reject(new Error(`waiting for file upload timed out after ${timeoutSeconds} seconds`));
+      }, timeoutSeconds * 1e3);
+    });
+    const processEventsPromise = (async () => {
+      const newEvents = await this.client.sessions.getEvents(
+        this.sessionId,
+        { all: false, reverse: false },
+        { timeout: timeoutSeconds * 1e3 }
+      );
+      for await (const event of newEvents) {
+        const e = event;
+        this.log.info(`waitForUpload processing event:
+${JSON.stringify(event, null, 2)}`);
+        if (e.event === waitEvent) {
+          if (e.fileId === fileId) {
+            if (e.status === "available") {
+              this.log.info(`uploaded file is now available on session: ${fileId}`);
+              return;
+            }
+            if (e.status === "upload_failed") {
+              this.log.info(`upload failed: ${this.sessionId} ${fileId}`);
+              throw new Error(`upload failed: ${e.eventData.error}`);
+            }
+          }
+        }
+      }
+      return null;
+    })();
+    return Promise.race([timeoutPromise, processEventsPromise]);
+  }
 };
 
 // src/session/AirtopSession.ts