@airtop/sdk 1.0.0-alpha2.0 → 1.0.0-alpha2.10

package/dist/index.d.cts

@@ -6,12 +6,12 @@ import { ILogLayer } from 'loglayer';
 export { ILogLayer } from 'loglayer';
 import * as _airtop_core_resources_shared_mjs from '@airtop/core/resources/shared.mjs';
 import { AutomationUpdateDescriptionParams } from '@airtop/core/resources/automations.js';
-import { SessionListParams, ProfileOutput, FileListParams, FilesResponse, FileCreateFileParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
+import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
 import * as _airtop_core_resources_shared_js from '@airtop/core/resources/shared.js';
-import { SessionConfigV1, GetFileResponse, ListAutomationsOutput, AutomationData, ExternalSessionWithConnectionInfo, EnvelopeDefaultMeta, Issue, AIPromptResponse as AIPromptResponse$1, WindowIDDataResponse, OperationOutcomeResponse } from '@airtop/core/resources/shared.js';
+import { SessionConfigV1, GetFileResponse, FilesResponse, ListAutomationsOutput, AutomationData, ExternalSessionWithConnectionInfo, EnvelopeDefaultMeta, Issue, AIPromptResponse as AIPromptResponse$1, WindowIDDataResponse, OperationOutcomeResponse } from '@airtop/core/resources/shared.js';
 export { AIResponseEnvelope, AirtopPagination, ExternalSessionAIResponseMetadata, ExternalSessionWithConnectionInfo, Issue, OperationOutcomeResponse, WindowIDDataResponse } from '@airtop/core/resources/shared.js';
 import * as _airtop_core_resources_sessions_mjs from '@airtop/core/resources/sessions.mjs';
-import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams } from '@airtop/core/resources/windows.js';
+import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams, WindowExtractParams, WindowActParams, WindowLlmParams, WindowFindOneParams, WindowFindManyParams, WindowWaitForPageParams } from '@airtop/core/resources/windows.js';
 
 /**
  * Shared configuration between Airtop classes.
@@ -36,6 +36,10 @@ interface CommonAirtopConfig {
      * Used for customizing output schema handling.
      */
     outputSchemaAdapter?: AirtopJsonSchemaAdapter;
+    /**
+     * The automation job ID to use for the request.
+     */
+    jobId?: string;
 }
 /**
  * Configuration for defining the JSON schema output.
@@ -97,6 +101,11 @@ declare class AirtopBase {
      * @internal
      **/
     protected outputJsonAdapter: AirtopJsonSchemaAdapter;
+    /**
+     * The job id for the ongoing automation
+     * @internal
+     */
+    protected jobId?: string;
     /**
      * Creates a new instance of AirtopBase
      * @param config - Configuration options for the SDK
@@ -180,6 +189,10 @@ interface AirtopConstructorConfig {
      * Used to customize how response data is structured.
      */
     outputSchemaAdapter?: AirtopJsonSchemaAdapter;
+    /**
+     * The job ID to use for the ongoing automation.
+     */
+    jobId?: string;
 }
 /**
  * Configuration options for creating a new session.
@@ -206,8 +219,6 @@ interface GetFilesConfig extends Omit<FileListParams, "sessionIds"> {
 }
 interface AirtopFileResponse extends GetFileResponse {
 }
-interface AirtopFilesListResponse extends FilesResponse {
-}
 interface AirtopAutomationUpdateDescriptionConfig extends AutomationUpdateDescriptionParams {
 }
 interface AirtopAutomationData extends AutomationData {
@@ -216,6 +227,10 @@ interface AirtopAutomationListResponse extends ListAutomationsOutput {
 }
 interface AirtopProfile extends ProfileOutput {
 }
+interface AirtopFileListParams extends FileListParams {
+}
+interface AirtopFilesResponse extends FilesResponse {
+}
 
 /**
  * The session data containing connection and state information.
@@ -420,6 +435,102 @@ interface WindowPromptResponse extends AIPromptResponse {
  */
 interface WindowScrapeResponse extends ScrapeResponse {
 }
+/**
+ * Configuration parameters for extracting content from a window.
+ */
+interface WindowExtractConfig extends Omit<WindowExtractParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for acting on content in a window.
+ */
+interface WindowActConfig extends Omit<WindowActParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for executing an LLM call in a window.
+ */
+interface WindowLlmConfig extends Omit<WindowLlmParams, "sessionId" | "prompt"> {
+}
+/**
+ * Configuration parameters for finding one element in a window.
+ */
+interface WindowFindOneConfig extends Omit<WindowFindOneParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for finding multiple elements in a window.
+ */
+interface WindowFindManyConfig extends Omit<WindowFindManyParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for waiting for a page to load in a window.
+ */
+interface WindowWaitForPageConfig extends Omit<WindowWaitForPageParams, "sessionId"> {
+}
+/**
+ * Data object representing a node returned from the Airtop API.
+ */
+interface AirtopNodeApiResponseData {
+    id: string;
+    xpath: string;
+}
+
+/**
+ * Represents a node in the DOM
+ */
+declare class AirtopNode {
+    /**
+     * The window client
+     */
+    protected windowClient: AirtopWindowClient;
+    /**
+     * The node handle id to use for all requests
+     */
+    nodeHandleId: string;
+    /**
+     * The xpath selector of the node
+     */
+    selector: string;
+    /**
+     * Constructor
+     * @param client - The window client
+     * @param nodeData - The node data to use for all requests
+     */
+    constructor(client: AirtopWindowClient, nodeData: AirtopNodeApiResponseData);
+    /**
+     * Extract content from the node
+     * @param prompt - The prompt to use for the extraction
+     * @param config - The configuration to use for the extraction
+     * @param requestOptions - The request options to use for the extraction
+     */
+    extract(prompt: string, config?: WindowExtractConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    /**
+     * Act on the node
+     * @param prompt - The prompt to use for the action
+     * @param config - The configuration to use for the action
+     * @param requestOptions - The request options to use for the action
+     */
+    act(prompt: string, config?: WindowActConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    /**
+     * Execute an LLM call on the node
+     * @param prompt - The prompt to use for the LLM call
+     * @param config - The configuration to use for the LLM call
+     * @param requestOptions - The request options to use for the LLM call
+     */
+    llm(prompt: string, config?: WindowLlmConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    /**
+     * Find one element in the node
+     * @param prompt - The prompt to use for the find one
+     * @param config - The configuration to use for the find one
+     * @param requestOptions - The request options to use for the find one
+     */
+    findOne(prompt: string, config?: WindowFindOneConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode>;
+    /**
+     * Find many elements in the node
+     * @param prompt - The prompt to use for the find many
+     * @param config - The configuration to use for the find many
+     * @param requestOptions - The request options to use for the find many
+     */
+    findMany(prompt: string, config?: WindowFindManyConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode[]>;
+}
 
 /**
  * Response object for a screenshot operation.
@@ -465,7 +576,7 @@ declare class AirtopWindowScreenshot {
     };
 }
 
-/**
+/**, waitForRequestCompletion
  * Client for making window-specific requests to the Airtop API.
  */
 declare class AirtopWindowClient extends AirtopBase {
@@ -583,6 +694,12 @@ declare class AirtopWindowClient extends AirtopBase {
      * @returns Promise resolving when the text has been typed
      */
     type(text: string, config?: WindowTypeConfig, requestOptions?: AirtopRequestOptions): Promise<_airtop_core_resources_shared_mjs.AIPromptResponse>;
+    extract(prompt: string, config?: WindowExtractConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    act(prompt: string, config?: WindowActConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    llm(prompt: string, config?: WindowLlmConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    findOne(prompt: string, config?: WindowFindOneConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode>;
+    findMany(prompt: string, config?: WindowFindManyConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode[]>;
+    waitForPage(config?: WindowWaitForPageConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
 }
 
 /**
@@ -798,20 +915,18 @@ declare class AirtopClient extends AirtopBase {
      * @param requestOptions
      */
     getFile(fileId: string, requestOptions?: AirtopRequestOptions): Promise<AirtopFileResponse>;
-    /**
-     * Lists files filtered by session IDs.
-     * @param sessionIds - Array of session IDs to retrieve files for
-     * @param config - Configuration options for the request
-     * @param requestOptions - Request options
-     * @returns Object containing pagination info and array of AirtopSession instances
-     */
-    listFiles(sessionIds: string[], config?: GetFilesConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopFilesListResponse>;
     /**
      * Removes a file by ID.
      * @param fileId - ID of the file to remove
      * @param requestOptions - Request options
      */
     removeFile(fileId: string, requestOptions?: AirtopRequestOptions): Promise<void>;
+    /**
+     * List files
+     * @param query
+     * @param requestOptions
+     */
+    listFiles(query: AirtopFileListParams, requestOptions?: AirtopRequestOptions): Promise<AirtopFilesResponse>;
     /**
      * List all automations
      * @param requestOptions - Request options
@@ -1025,4 +1140,4 @@ declare class AirtopMocks {
     }): AirtopWindow<AirtopWindowGetInfoResponse>;
 }
 
-export { type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopFileResponse, type AirtopFilesListResponse, AirtopMocks, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionWarning, type WindowClickConfig, type WindowCreateData, type WindowError, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWarning, registerAirtopPlugin };
+export { type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopFileListParams, type AirtopFileResponse, type AirtopFilesResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionWarning, type WindowActConfig, type WindowClickConfig, type WindowCreateData, type WindowError, type WindowExtractConfig, type WindowFindManyConfig, type WindowFindOneConfig, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWarning, registerAirtopPlugin };

package/dist/index.d.ts

@@ -6,12 +6,12 @@ import { ILogLayer } from 'loglayer';
 export { ILogLayer } from 'loglayer';
 import * as _airtop_core_resources_shared_mjs from '@airtop/core/resources/shared.mjs';
 import { AutomationUpdateDescriptionParams } from '@airtop/core/resources/automations.js';
-import { SessionListParams, ProfileOutput, FileListParams, FilesResponse, FileCreateFileParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
+import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
 import * as _airtop_core_resources_shared_js from '@airtop/core/resources/shared.js';
-import { SessionConfigV1, GetFileResponse, ListAutomationsOutput, AutomationData, ExternalSessionWithConnectionInfo, EnvelopeDefaultMeta, Issue, AIPromptResponse as AIPromptResponse$1, WindowIDDataResponse, OperationOutcomeResponse } from '@airtop/core/resources/shared.js';
+import { SessionConfigV1, GetFileResponse, FilesResponse, ListAutomationsOutput, AutomationData, ExternalSessionWithConnectionInfo, EnvelopeDefaultMeta, Issue, AIPromptResponse as AIPromptResponse$1, WindowIDDataResponse, OperationOutcomeResponse } from '@airtop/core/resources/shared.js';
 export { AIResponseEnvelope, AirtopPagination, ExternalSessionAIResponseMetadata, ExternalSessionWithConnectionInfo, Issue, OperationOutcomeResponse, WindowIDDataResponse } from '@airtop/core/resources/shared.js';
 import * as _airtop_core_resources_sessions_mjs from '@airtop/core/resources/sessions.mjs';
-import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams } from '@airtop/core/resources/windows.js';
+import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams, WindowExtractParams, WindowActParams, WindowLlmParams, WindowFindOneParams, WindowFindManyParams, WindowWaitForPageParams } from '@airtop/core/resources/windows.js';
 
 /**
  * Shared configuration between Airtop classes.
@@ -36,6 +36,10 @@ interface CommonAirtopConfig {
      * Used for customizing output schema handling.
      */
     outputSchemaAdapter?: AirtopJsonSchemaAdapter;
+    /**
+     * The automation job ID to use for the request.
+     */
+    jobId?: string;
 }
 /**
  * Configuration for defining the JSON schema output.
@@ -97,6 +101,11 @@ declare class AirtopBase {
      * @internal
      **/
     protected outputJsonAdapter: AirtopJsonSchemaAdapter;
+    /**
+     * The job id for the ongoing automation
+     * @internal
+     */
+    protected jobId?: string;
     /**
      * Creates a new instance of AirtopBase
      * @param config - Configuration options for the SDK
@@ -180,6 +189,10 @@ interface AirtopConstructorConfig {
      * Used to customize how response data is structured.
      */
     outputSchemaAdapter?: AirtopJsonSchemaAdapter;
+    /**
+     * The job ID to use for the ongoing automation.
+     */
+    jobId?: string;
 }
 /**
  * Configuration options for creating a new session.
@@ -206,8 +219,6 @@ interface GetFilesConfig extends Omit<FileListParams, "sessionIds"> {
 }
 interface AirtopFileResponse extends GetFileResponse {
 }
-interface AirtopFilesListResponse extends FilesResponse {
-}
 interface AirtopAutomationUpdateDescriptionConfig extends AutomationUpdateDescriptionParams {
 }
 interface AirtopAutomationData extends AutomationData {
@@ -216,6 +227,10 @@ interface AirtopAutomationListResponse extends ListAutomationsOutput {
 }
 interface AirtopProfile extends ProfileOutput {
 }
+interface AirtopFileListParams extends FileListParams {
+}
+interface AirtopFilesResponse extends FilesResponse {
+}
 
 /**
  * The session data containing connection and state information.
@@ -420,6 +435,102 @@ interface WindowPromptResponse extends AIPromptResponse {
  */
 interface WindowScrapeResponse extends ScrapeResponse {
 }
+/**
+ * Configuration parameters for extracting content from a window.
+ */
+interface WindowExtractConfig extends Omit<WindowExtractParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for acting on content in a window.
+ */
+interface WindowActConfig extends Omit<WindowActParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for executing an LLM call in a window.
+ */
+interface WindowLlmConfig extends Omit<WindowLlmParams, "sessionId" | "prompt"> {
+}
+/**
+ * Configuration parameters for finding one element in a window.
+ */
+interface WindowFindOneConfig extends Omit<WindowFindOneParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for finding multiple elements in a window.
+ */
+interface WindowFindManyConfig extends Omit<WindowFindManyParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Configuration parameters for waiting for a page to load in a window.
+ */
+interface WindowWaitForPageConfig extends Omit<WindowWaitForPageParams, "sessionId"> {
+}
+/**
+ * Data object representing a node returned from the Airtop API.
+ */
+interface AirtopNodeApiResponseData {
+    id: string;
+    xpath: string;
+}
+
+/**
+ * Represents a node in the DOM
+ */
+declare class AirtopNode {
+    /**
+     * The window client
+     */
+    protected windowClient: AirtopWindowClient;
+    /**
+     * The node handle id to use for all requests
+     */
+    nodeHandleId: string;
+    /**
+     * The xpath selector of the node
+     */
+    selector: string;
+    /**
+     * Constructor
+     * @param client - The window client
+     * @param nodeData - The node data to use for all requests
+     */
+    constructor(client: AirtopWindowClient, nodeData: AirtopNodeApiResponseData);
+    /**
+     * Extract content from the node
+     * @param prompt - The prompt to use for the extraction
+     * @param config - The configuration to use for the extraction
+     * @param requestOptions - The request options to use for the extraction
+     */
+    extract(prompt: string, config?: WindowExtractConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    /**
+     * Act on the node
+     * @param prompt - The prompt to use for the action
+     * @param config - The configuration to use for the action
+     * @param requestOptions - The request options to use for the action
+     */
+    act(prompt: string, config?: WindowActConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    /**
+     * Execute an LLM call on the node
+     * @param prompt - The prompt to use for the LLM call
+     * @param config - The configuration to use for the LLM call
+     * @param requestOptions - The request options to use for the LLM call
+     */
+    llm(prompt: string, config?: WindowLlmConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    /**
+     * Find one element in the node
+     * @param prompt - The prompt to use for the find one
+     * @param config - The configuration to use for the find one
+     * @param requestOptions - The request options to use for the find one
+     */
+    findOne(prompt: string, config?: WindowFindOneConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode>;
+    /**
+     * Find many elements in the node
+     * @param prompt - The prompt to use for the find many
+     * @param config - The configuration to use for the find many
+     * @param requestOptions - The request options to use for the find many
+     */
+    findMany(prompt: string, config?: WindowFindManyConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode[]>;
+}
 
 /**
  * Response object for a screenshot operation.
@@ -465,7 +576,7 @@ declare class AirtopWindowScreenshot {
     };
 }
 
-/**
+/**, waitForRequestCompletion
  * Client for making window-specific requests to the Airtop API.
  */
 declare class AirtopWindowClient extends AirtopBase {
@@ -583,6 +694,12 @@ declare class AirtopWindowClient extends AirtopBase {
      * @returns Promise resolving when the text has been typed
      */
     type(text: string, config?: WindowTypeConfig, requestOptions?: AirtopRequestOptions): Promise<_airtop_core_resources_shared_mjs.AIPromptResponse>;
+    extract(prompt: string, config?: WindowExtractConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    act(prompt: string, config?: WindowActConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    llm(prompt: string, config?: WindowLlmConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    findOne(prompt: string, config?: WindowFindOneConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode>;
+    findMany(prompt: string, config?: WindowFindManyConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode[]>;
+    waitForPage(config?: WindowWaitForPageConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
 }
 
 /**
@@ -798,20 +915,18 @@ declare class AirtopClient extends AirtopBase {
      * @param requestOptions
      */
     getFile(fileId: string, requestOptions?: AirtopRequestOptions): Promise<AirtopFileResponse>;
-    /**
-     * Lists files filtered by session IDs.
-     * @param sessionIds - Array of session IDs to retrieve files for
-     * @param config - Configuration options for the request
-     * @param requestOptions - Request options
-     * @returns Object containing pagination info and array of AirtopSession instances
-     */
-    listFiles(sessionIds: string[], config?: GetFilesConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopFilesListResponse>;
     /**
      * Removes a file by ID.
      * @param fileId - ID of the file to remove
      * @param requestOptions - Request options
      */
     removeFile(fileId: string, requestOptions?: AirtopRequestOptions): Promise<void>;
+    /**
+     * List files
+     * @param query
+     * @param requestOptions
+     */
+    listFiles(query: AirtopFileListParams, requestOptions?: AirtopRequestOptions): Promise<AirtopFilesResponse>;
     /**
      * List all automations
      * @param requestOptions - Request options
@@ -1025,4 +1140,4 @@ declare class AirtopMocks {
     }): AirtopWindow<AirtopWindowGetInfoResponse>;
 }
 
-export { type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopFileResponse, type AirtopFilesListResponse, AirtopMocks, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionWarning, type WindowClickConfig, type WindowCreateData, type WindowError, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWarning, registerAirtopPlugin };
+export { type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopFileListParams, type AirtopFileResponse, type AirtopFilesResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type CommonResponse, type CommonWindowResponse, type CreateFileConfig, type CreateSessionConfig, type GetFilesConfig, type GetSessionsConfig, type OutputJsonSchemaConfig, type ScreenshotData, type SessionData, type SessionError, type SessionMetadata, type SessionWarning, type WindowActConfig, type WindowClickConfig, type WindowCreateData, type WindowError, type WindowExtractConfig, type WindowFindManyConfig, type WindowFindOneConfig, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWarning, registerAirtopPlugin };