@airtop/sdk 1.0.0-alpha2.2 → 1.0.0-alpha2.20

package/dist/index.d.cts

@@ -4,14 +4,17 @@ import { AirtopJsonSchemaAdapter } from '@airtop/json-schema-adapter';
 export { AirtopJsonSchemaAdapter } from '@airtop/json-schema-adapter';
 import { ILogLayer } from 'loglayer';
 export { ILogLayer } from 'loglayer';
+import * as _airtop_core_resources_shared_js from '@airtop/core/resources/shared.js';
+import { Issue, SessionConfigV1, GetFileResponse, FilesResponse, ListAutomationsOutput, AutomationData, ServicePromptActionResponseEnvelope, ExternalSessionWithConnectionInfo, EnvelopeDefaultMeta, ExtractActionResponseEnvelope, ActActionResponseEnvelope, LlmActionResponseEnvelope, NodeHandle, WaitForPageActionResponseEnvelope, NavigateActionResponseEnvelope, FindOneActionResponseEnvelope, FindManyActionResponseEnvelope, AIPromptResponse as AIPromptResponse$1, WindowIDDataResponse, OperationOutcomeResponse } from '@airtop/core/resources/shared.js';
+export { AIResponseEnvelope, ActActionResponseData, AgentInvocationData, AgentVersionData, AirtopPagination, AsyncConfig, AsyncSessionAIResponseEnvelope, BrowserWaitNavigationConfig, ClickConfig, ClientProvidedResponseMetadata, CreateFileData, EnvelopeDefaultMeta, ExternalSessionAIResponseMetadata, ExternalSessionAIResponseMetadataUsage, ExternalSessionConfig, ExternalSessionWithConnectionInfo, ExtractActionResponseData, FindManyActionResponseData, FindOneActionResponseData, GetFileData, IntervalMonitorConfig, Issue, LlmActionResponseData, MicroInteractionConfig, MonitorConfig, NavigateActionResponseData, OperationOutcome, OperationOutcomeResponse, PageQueryConfig, PageQueryExperimentalConfig, PaginatedExtractionConfig, ScrapeResponseContent, ScrapeResponseEnvelope, ScrapeResponseOutput, ScreenshotConfig, ScreenshotMetadata, ScreenshotRequestConfig, ScreenshotScrollPosition, ScreenshotViewportDimensions, ScrollByConfig, ScrollToEdgeConfig, ServicePromptActionResponseData, SummaryExperimentalConfig, VisualAnalysisConfig, WaitForPageActionResponseData, WindowIDData, WindowIDDataResponse, WindowInfo, WindowResponse } from '@airtop/core/resources/shared.js';
 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 * 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';
-export { AIResponseEnvelope, AirtopPagination, ExternalSessionAIResponseMetadata, ExternalSessionWithConnectionInfo, Issue, OperationOutcomeResponse, WindowIDDataResponse } from '@airtop/core/resources/shared.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';
+export { AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.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, WindowNavigateParams, WindowFillFormParams } from '@airtop/core/resources/windows.js';
+export { WindowActParams, WindowClickParams, WindowExtractParams, WindowFillFormParams, WindowFindManyParams, WindowFindOneParams, WindowGetParams, WindowHoverParams, WindowLlmParams, WindowLoadURLParams, WindowMonitorParams, WindowNavigateParams, WindowPageQueryParams, WindowPaginatedExtractionParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams, WindowWaitForPageParams } from '@airtop/core/resources/windows.js';
+export { DeepOmit } from 'deep-utility-types';
 
 /**
  * Shared configuration between Airtop classes.
@@ -36,6 +39,19 @@ interface CommonAirtopConfig {
      * Used for customizing output schema handling.
      */
     outputSchemaAdapter?: AirtopJsonSchemaAdapter;
+    /**
+     * The automation job ID to use for the request.
+     */
+    jobId?: string;
+    /**
+     * Logger instance for publishing agent events.
+     * Used to send event data to external systems during automation execution.
+     */
+    agentEventPublisher?: ILogLayer;
+    /**
+     * The default timeout in seconds for API requests.
+     */
+    defaultTimeoutInSeconds?: number;
 }
 /**
  * Configuration for defining the JSON schema output.
@@ -75,6 +91,15 @@ interface CommonResponse {
     warnings?: unknown;
     errors?: unknown;
 }
+/**
+ * Custom error class that implements the Issue interface.
+ * Extends the native Error class to provide a more structured error handling mechanism.
+ */
+declare class AirtopError extends Error {
+    issues: Issue[];
+    metadata?: Record<string, unknown>;
+    constructor(issues: Issue[], metadata?: Record<string, unknown>);
+}
 
 /**
  * Base class for Airtop SDK implementation
@@ -97,11 +122,38 @@ declare class AirtopBase {
      * @internal
      **/
     protected outputJsonAdapter: AirtopJsonSchemaAdapter;
+    /**
+     * The job id for the ongoing automation
+     * @internal
+     */
+    protected jobId?: string;
+    /**
+     * Instance for sending agent events
+     * @internal
+     */
+    protected agentEventPublisher?: ILogLayer;
+    /**
+     * The default timeout in seconds for API requests.
+     * @internal
+     */
+    protected defaultTimeoutInSeconds: number;
     /**
      * Creates a new instance of AirtopBase
      * @param config - Configuration options for the SDK
      */
     constructor(config: CommonAirtopConfig);
+    /**
+     * Sets the publisher for sending agent events. Internal use only.
+     * @internal
+     */
+    _setAgentEventPublisher(logger: ILogLayer): void;
+    /**
+     * Sends a payload to the agent with the specified event name.
+     * @param eventName The name of the event
+     * @param payload The payload to send to the agent
+     * @internal
+     */
+    protected _sendAgentPayload(eventName: string, payload: any): void;
     /**
      * Returns the API key used by the SDK
      * @returns API key string
@@ -180,6 +232,20 @@ interface AirtopConstructorConfig {
      * Used to customize how response data is structured.
      */
     outputSchemaAdapter?: AirtopJsonSchemaAdapter;
+    /**
+     * The job ID to use for the ongoing automation.
+     */
+    jobId?: string;
+    /**
+     * Logger instance for publishing agent events.
+     * Used to send event data to external systems during automation execution.
+     */
+    agentEventPublisher?: ILogLayer;
+    /**
+     * The default timeout in seconds for API requests.
+     * Defaults to 5 minutes if not specified.
+     */
+    defaultTimeoutInSeconds?: number;
 }
 /**
  * Configuration options for creating a new session.
@@ -206,8 +272,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 +280,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.
@@ -273,6 +341,11 @@ interface AirtopSessionResponse {
  */
 interface CreateFileConfig extends Omit<FileCreateFileParams, "sessionId" | "fileName"> {
 }
+/**
+ * Response from a session service call.
+ */
+interface SessionServiceResponse extends ServicePromptActionResponseEnvelope {
+}
 
 /**
  * Common data found in a window API call response.
@@ -380,7 +453,7 @@ interface WindowLoadUrlConfig extends Omit<WindowLoadURLParams, "sessionId" | "u
  * Configuration parameters for monitoring window events.
  * Excludes session ID which is provided by the parent session.
  */
-interface WindowMonitorConfig extends Omit<WindowMonitorParams, "sessionId"> {
+interface WindowMonitorConfig extends Omit<WindowMonitorParams, "sessionId" | "condition"> {
 }
 /**
  * Configuration parameters for performing a natural language query on page content.
@@ -420,6 +493,167 @@ interface WindowPromptResponse extends AIPromptResponse {
  */
 interface WindowScrapeResponse extends ScrapeResponse {
 }
+/**
+ * Configuration parameters for extracting content from a window.
+ */
+interface WindowExtractConfig extends Omit<WindowExtractParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Extract window response.
+ */
+interface WindowExtractResponse extends ExtractActionResponseEnvelope {
+}
+/**
+ * Configuration parameters for acting on content in a window.
+ */
+interface WindowActConfig extends Omit<WindowActParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Act window response.
+ */
+interface WindowActResponse extends ActActionResponseEnvelope {
+}
+/**
+ * Configuration parameters for executing an LLM call in a window.
+ */
+interface WindowLlmConfig extends Omit<WindowLlmParams, "sessionId" | "jobId" | "prompt" | "includeWebContext" | "outputSchema"> {
+    outputSchema?: string | object;
+}
+/**
+ * LLM window response.
+ */
+interface WindowLlmResponse extends LlmActionResponseEnvelope {
+}
+/**
+ * Configuration parameters for finding one element in a window.
+ */
+interface WindowFindOneConfig extends Omit<WindowFindOneParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Find one window response.
+ */
+interface WindowFindOneResponse extends FindOneActionResponseEnvelope {
+}
+/**
+ * Configuration parameters for finding multiple elements in a window.
+ */
+interface WindowFindManyConfig extends Omit<WindowFindManyParams, "sessionId" | "prompt" | "jobId"> {
+}
+/**
+ * Find many window response.
+ */
+interface WindowFindManyResponse extends FindManyActionResponseEnvelope {
+}
+/**
+ * Configuration parameters for waiting for a page to load in a window.
+ */
+interface WindowWaitForPageConfig extends Omit<WindowWaitForPageParams, "sessionId"> {
+}
+/**
+ * Wait for page window response.
+ */
+interface WindowWaitForPageResponse extends WaitForPageActionResponseEnvelope {
+}
+/**
+ * Configuration parameters for navigating browser history in a window.
+ */
+interface WindowNavigateConfig extends Omit<WindowNavigateParams, "sessionId"> {
+}
+/**
+ * Navigate window response.
+ */
+interface WindowNavigateResponse extends NavigateActionResponseEnvelope {
+}
+/**
+ * The direction to navigate in browser history.
+ */
+declare enum WindowNavigateDirection {
+    BACK = "backward",
+    FORWARD = "forward"
+}
+/**
+ * Data object representing a node returned from the Airtop API.
+ */
+interface AirtopNodeApiResponseData extends NodeHandle {
+}
+/**
+ * Configuration parameters for filling a form in a window.
+ */
+interface WindowFillFormConfig extends Omit<WindowFillFormParams, "sessionId" | "parameters"> {
+}
+
+/**
+ * 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<WindowExtractResponse>;
+    /**
+     * 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<WindowActResponse>;
+    /**
+     * 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<WindowLlmResponse>;
+    /**
+     * 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 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
+     */
+    findOneOptional(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[]>;
+    /**
+     * 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
+     */
+    findManyOptional(prompt: string, config?: WindowFindManyConfig, requestOptions?: AirtopRequestOptions): Promise<AirtopNode[]>;
+}
 
 /**
  * Response object for a screenshot operation.
@@ -465,7 +699,7 @@ declare class AirtopWindowScreenshot {
     };
 }
 
-/**
+/**, waitForRequestCompletion
  * Client for making window-specific requests to the Airtop API.
  */
 declare class AirtopWindowClient extends AirtopBase {
@@ -582,7 +816,19 @@ declare class AirtopWindowClient extends AirtopBase {
      * @param requestOptions - Request options
      * @returns Promise resolving when the text has been typed
      */
-    type(text: string, config?: WindowTypeConfig, requestOptions?: AirtopRequestOptions): Promise<_airtop_core_resources_shared_mjs.AIPromptResponse>;
+    type(text: string, config?: WindowTypeConfig, requestOptions?: AirtopRequestOptions): Promise<WindowPromptResponse>;
+    extract(prompt: string, config?: WindowExtractConfig, requestOptions?: AirtopRequestOptions): Promise<WindowExtractResponse>;
+    act(prompt: string, config?: WindowActConfig, requestOptions?: AirtopRequestOptions): Promise<WindowActResponse>;
+    llm(prompt: string, config?: WindowLlmConfig, requestOptions?: AirtopRequestOptions): Promise<WindowLlmResponse>;
+    private findOnePrivate;
+    findOne(prompt: string, config?: Omit<WindowFindOneConfig, "optional">, requestOptions?: AirtopRequestOptions): Promise<AirtopNode>;
+    findOneOptional(prompt: string, config?: Omit<WindowFindOneConfig, "optional">, requestOptions?: AirtopRequestOptions): Promise<AirtopNode | null>;
+    private findManyPrivate;
+    findMany(prompt: string, config?: Omit<WindowFindManyConfig, "optional">, requestOptions?: AirtopRequestOptions): Promise<AirtopNode[]>;
+    findManyOptional(prompt: string, config?: Omit<WindowFindManyConfig, "optional">, requestOptions?: AirtopRequestOptions): Promise<AirtopNode[]>;
+    waitForPage(config?: WindowWaitForPageConfig, requestOptions?: AirtopRequestOptions): Promise<WindowWaitForPageResponse>;
+    navigate(direction: WindowNavigateDirection, config?: WindowNavigateConfig, requestOptions?: AirtopRequestOptions): Promise<WindowNavigateResponse>;
+    fillForm(formData: string | object, config?: WindowFillFormConfig, requestOptions?: AirtopRequestOptions): Promise<AIPromptResponse>;
 }
 
 /**
@@ -644,6 +890,7 @@ declare class AirtopSessionClient extends AirtopBase {
      * Returns the browser session ID.
      */
     getSessionId(): string;
+    listWindows(requestOptions?: AirtopRequestOptions): Promise<_airtop_core_resources_shared_mjs.WindowsResponse>;
     /**
      * Gets the state of the session using the attached session id.
      * @param requestOptions - Request options
@@ -686,6 +933,14 @@ declare class AirtopSessionClient extends AirtopBase {
      * @param requestOptions - Request options
      */
     createFile(fileName: string, config?: CreateFileConfig, requestOptions?: AirtopRequestOptions): _airtop_core.APIPromise<_airtop_core_resources_shared_mjs.CreateFileResponse>;
+    llm(prompt: string, config?: WindowLlmConfig, requestOptions?: AirtopRequestOptions): Promise<WindowLlmResponse>;
+    /**
+     * Calls the service endpoint.
+     * @param prompt - The prompt to send to the service, describing the actions to take
+     * @param service - The service to call, if not provided, the service will be inferred from the prompt
+     * @param requestOptions - Request options
+     */
+    service(prompt: string, service?: string, requestOptions?: AirtopRequestOptions): Promise<SessionServiceResponse>;
 }
 
 /**
@@ -798,20 +1053,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
@@ -831,6 +1084,178 @@ declare class AirtopClient extends AirtopBase {
     removeAutomation(automationID: string, requestOptions?: AirtopRequestOptions): _airtop_core.APIPromise<unknown>;
 }
 
+/**
+ * Provides utility methods for creating mock instances of Airtop classes.
+ * @hideconstructor
+ */
+declare class AirtopMocks {
+    /**
+     * Creates an AirtopBase instance (the class used as the base for other Airtop classes) with a mock client and logger.
+     */
+    static getAirtopBaseMock(config?: Partial<CommonAirtopConfig>): AirtopBase;
+    /**
+     * Creates an Airtop instance with a mock client and data.
+     */
+    static getAirtopClientMock(config?: Partial<AirtopConstructorConfig>): AirtopClient;
+    /**
+     * Creates an AirtopSession instance with a mock client and data.
+     */
+    static getAirtopSessionMock(responseData?: Partial<AirtopSessionResponse>): AirtopSession;
+    /**
+     * Creates an AirtopWindow instance with a mock client and data.
+     */
+    static getAirtopWindowMock({ sessionId, windowData, }?: {
+        sessionId?: string;
+        windowData?: AirtopWindowGetInfoResponse;
+    }): AirtopWindow<AirtopWindowGetInfoResponse>;
+}
+
+interface AirtopAgentCreateAgentParams extends Airtop.AgentCreateAgentParams {
+}
+interface AirtopAgentGetAgentsParams extends Airtop.AgentGetAgentsParams {
+}
+interface AirtopAgentUpdateAgentParams extends Airtop.AgentUpdateAgentParams {
+}
+interface AirtopAgentDeleteAgentsParams extends Airtop.AgentDeleteAgentsParams {
+}
+interface AirtopAgentDuplicateAgentParams extends Airtop.AgentDuplicateAgentParams {
+}
+interface AirtopAgentCreateVersionParams extends Airtop.AgentCreateVersionParams {
+}
+interface AirtopAgentGetVersionsParams extends Airtop.AgentGetVersionsParams {
+}
+interface AirtopAgentCreateInvocationParams extends Airtop.AgentCreateInvocationParams {
+}
+interface AirtopAgentGetInvocationsParams extends Airtop.AgentGetInvocationsParams {
+}
+interface AirtopAgentCancelInvocationParams extends Airtop.AgentCancelInvocationParams {
+}
+interface AirtopCreateAgentResponse extends Airtop.CreateAgentResponse {
+}
+interface AirtopGetAgentResponse extends Airtop.GetAgentResponse {
+}
+interface AirtopGetAgentsResponse extends Airtop.GetAgentsResponse {
+}
+interface AirtopUpdateAgentResponse extends Airtop.UpdateAgentResponse {
+}
+interface AirtopDeleteAgentsResponse extends Airtop.DeleteResponse {
+}
+interface AirtopDuplicateAgentResponse extends Airtop.DuplicateAgentResponse {
+}
+interface AirtopCreateAgentVersionResponse extends Airtop.CreateAgentVersionResponse {
+}
+interface AirtopGetAgentVersionsResponse extends Airtop.GetAgentVersionsResponse {
+}
+interface AirtopCreateAgentInvocationResponse extends Airtop.CreateAgentInvocationResponse {
+}
+interface AirtopGetAgentInvocationsResponse extends Airtop.GetAgentInvocationsResponse {
+}
+interface AirtopAgentResponse extends Airtop.GetAgentResponse {
+}
+
+/**
+ * Client for making Agent-specific requests to the Airtop API.
+ */
+declare class AirtopAgentClient extends AirtopBase {
+    /**
+     * Creates a new instance of the Airtop SDK.
+     * @param config - Configuration options for the Airtop SDK
+     */
+    constructor(config: AirtopConstructorConfig);
+    /**
+     * Creates a new agent.
+     * @param params - Parameters for creating the agent. Corresponds to `AirtopAgentCreateAgentParams`.
+     * @param requestOptions - Request options.
+     * @returns The created agent data, `AirtopCreateAgentResponse`.
+     */
+    createAgent(params: AirtopAgentCreateAgentParams, requestOptions?: AirtopRequestOptions): Promise<AirtopCreateAgentResponse>;
+    /**
+     * Retrieves a specific agent by its ID.
+     * @param agentId - The ID of the agent to retrieve.
+     * @param requestOptions - Request options.
+     * @returns The agent data, `AirtopGetAgentResponse`.
+     */
+    getAgent(agentId: string, // Renamed to avoid conflict with class member
+    requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentResponse>;
+    /**
+     * Lists agents.
+     * @param params - Optional parameters for listing agents (e.g., pagination). Corresponds to `AirtopAgentGetAgentsParams`.
+     * @param requestOptions - Request options.
+     * @returns A list of agents, `AirtopGetAgentsResponse`.
+     */
+    listAgents(params?: AirtopAgentGetAgentsParams, requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentsResponse>;
+    /**
+     * Updates an existing agent.
+     * @param agentId - The ID of the agent to update.
+     * @param params - The new data for the agent. Corresponds to `AirtopAgentUpdateAgentParams`.
+     * @param requestOptions - Request options.
+     * @returns The updated agent data, `AirtopUpdateAgentResponse`.
+     */
+    updateAgent(agentId: string, // Renamed to avoid conflict with class member
+    params: AirtopAgentUpdateAgentParams, requestOptions?: AirtopRequestOptions): Promise<AirtopUpdateAgentResponse>;
+    /**
+     * Deletes one or more agents.
+     * @param params - Parameters for deleting agents. Corresponds to `AirtopAgentDeleteAgentsParams`.
+     * @param requestOptions - Request options.
+     * @returns A response confirming the deletion, `AirtopDeleteAgentsResponse`.
+     */
+    deleteAgents(params: AirtopAgentDeleteAgentsParams, requestOptions?: AirtopRequestOptions): Promise<AirtopDeleteAgentsResponse>;
+    /**
+     * Duplicates an agent.
+     * @param agentId - The ID of the agent to duplicate.
+     * @param params - Parameters for duplicating the agent (e.g., new name). Corresponds to `AirtopAgentDuplicateAgentParams`.
+     * @param requestOptions - Request options.
+     * @returns The duplicated agent data, `AirtopDuplicateAgentResponse`.
+     */
+    duplicateAgent(agentId: string, // Renamed to avoid conflict with class member
+    params: AirtopAgentDuplicateAgentParams, requestOptions?: AirtopRequestOptions): Promise<AirtopDuplicateAgentResponse>;
+    /**
+     * Creates a new version for an agent.
+     * @param agentId - The ID of the agent for which to create a version.
+     * @param params - Parameters for creating the agent version. Corresponds to `AirtopAgentCreateVersionParams`.
+     * @param requestOptions - Request options.
+     * @returns The created agent version data, `AirtopCreateAgentVersionResponse`.
+     */
+    createAgentVersion(agentId: string, // Renamed
+    params: AirtopAgentCreateVersionParams, requestOptions?: AirtopRequestOptions): Promise<AirtopCreateAgentVersionResponse>;
+    /**
+     * Lists versions of an agent.
+     * @param agentId - The ID of the agent whose versions to list.
+     * @param params - Optional parameters for listing agent versions. Corresponds to `AirtopAgentGetVersionsParams`.
+     * @param requestOptions - Request options.
+     * @returns A list of agent versions, `AirtopGetAgentVersionsResponse`.
+     */
+    listAgentVersions(agentId: string, // Renamed
+    params?: AirtopAgentGetVersionsParams, requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentVersionsResponse>;
+    /**
+     * Creates an invocation for an agent.
+     * @param agentId - The ID of the agent for which to create an invocation.
+     * @param params - Parameters for creating the agent invocation. Corresponds to `AirtopAgentCreateInvocationParams`.
+     * @param requestOptions - Request options.
+     * @returns The created agent invocation data, `AirtopCreateAgentInvocationResponse`.
+     */
+    createAgentInvocation(agentId: string, // Renamed
+    params: AirtopAgentCreateInvocationParams, requestOptions?: AirtopRequestOptions): Promise<AirtopCreateAgentInvocationResponse>;
+    /**
+     * Lists invocations of an agent.
+     * @param agentIds - The ID of the agent whose invocations to list.
+     * @param params - Optional parameters for listing agent invocations. Corresponds to `AirtopAgentGetInvocationsParams`.
+     * @param requestOptions - Request options.
+     * @returns A list of agent invocations, `AirtopGetAgentInvocationsResponse`.
+     */
+    listAgentInvocations(agentIds: string, // Renamed
+    params?: AirtopAgentGetInvocationsParams, requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentInvocationsResponse>;
+    /**
+     * Cancels a specific invocation of an agent.
+     * @param agentId - The ID of the agent.
+     * @param invocationId - The ID of the invocation to cancel.
+     * @param paramsBody - Optional body parameters for cancelling the invocation. Corresponds to `AirtopAgentCancelInvocationParams`.
+     * @param requestOptions - Request options.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    cancelAgentInvocation(agentId: string, invocationId: string, paramsBody?: AirtopAgentCancelInvocationParams, requestOptions?: AirtopRequestOptions): Promise<void>;
+}
+
 /**
  * Enumeration of available plugin augmentation types.
  * Determines which part of the SDK a plugin can extend.
@@ -999,30 +1424,4 @@ interface AirtopPluginRegistration {
  */
 declare function registerAirtopPlugin(plugin: AirtopPluginRegistration): void;
 
-/**
- * Provides utility methods for creating mock instances of Airtop classes.
- * @hideconstructor
- */
-declare class AirtopMocks {
-    /**
-     * Creates an AirtopBase instance (the class used as the base for other Airtop classes) with a mock client and logger.
-     */
-    static getAirtopBaseMock(config?: Partial<CommonAirtopConfig>): AirtopBase;
-    /**
-     * Creates an Airtop instance with a mock client and data.
-     */
-    static getAirtopClientMock(config?: Partial<AirtopConstructorConfig>): AirtopClient;
-    /**
-     * Creates an AirtopSession instance with a mock client and data.
-     */
-    static getAirtopSessionMock(responseData?: Partial<AirtopSessionResponse>): AirtopSession;
-    /**
-     * Creates an AirtopWindow instance with a mock client and data.
-     */
-    static getAirtopWindowMock({ sessionId, windowData, }?: {
-        sessionId?: string;
-        windowData?: AirtopWindowGetInfoResponse;
-    }): 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 AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentCreateVersionParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentDuplicateAgentParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionsParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateAgentVersionResponse, type AirtopDeleteAgentsResponse, type AirtopDuplicateAgentResponse, AirtopError, type AirtopFileListParams, type AirtopFileResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionsResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, 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 SessionServiceResponse, type SessionWarning, type WindowActConfig, type WindowActResponse, type WindowClickConfig, type WindowCreateData, 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 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 };