@airtop/sdk 1.0.0-alpha2.12 → 1.0.0-alpha2.14

package/dist/index.d.cts

@@ -560,6 +560,13 @@ declare class AirtopNode {
      * @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
@@ -567,6 +574,13 @@ declare class AirtopNode {
      * @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[]>;
 }
 
 /**
@@ -1156,6 +1170,152 @@ interface AirtopPluginRegistration {
  */
 declare function registerAirtopPlugin(plugin: AirtopPluginRegistration): void;
 
+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>;
+}
+
 /**
  * Provides utility methods for creating mock instances of Airtop classes.
  * @hideconstructor
@@ -1182,4 +1342,4 @@ declare class AirtopMocks {
     }): AirtopWindow<AirtopWindowGetInfoResponse>;
 }
 
-export { type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, AirtopError, 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 WindowNavigateConfig, WindowNavigateDirection, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, 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 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 WindowNavigateConfig, WindowNavigateDirection, 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

@@ -560,6 +560,13 @@ declare class AirtopNode {
      * @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
@@ -567,6 +574,13 @@ declare class AirtopNode {
      * @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[]>;
 }
 
 /**
@@ -1156,6 +1170,152 @@ interface AirtopPluginRegistration {
  */
 declare function registerAirtopPlugin(plugin: AirtopPluginRegistration): void;
 
+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>;
+}
+
 /**
  * Provides utility methods for creating mock instances of Airtop classes.
  * @hideconstructor
@@ -1182,4 +1342,4 @@ declare class AirtopMocks {
     }): AirtopWindow<AirtopWindowGetInfoResponse>;
 }
 
-export { type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, AirtopError, 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 WindowNavigateConfig, WindowNavigateDirection, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, 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 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 WindowNavigateConfig, WindowNavigateDirection, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, 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.12",
+      version: "1.0.0-alpha2.14",
       type: "module",
       main: "./dist/index.cjs",
       module: "./dist/index.js",
@@ -47,7 +47,7 @@ var require_package = __commonJS({
       },
       dependencies: {
         "@airtop/json-schema-adapter": "workspace:*",
-        "@airtop/core": "0.1.0-alpha.28",
+        "@airtop/core": "0.1.0-alpha.29",
         "date-fns": "4.1.0",
         loglayer: "6.3.3",
         "serialize-error": "12.0.0",
@@ -373,6 +373,19 @@ var AirtopNode = class {
     };
     return this.windowClient.findOne(prompt, augmentedConfig, requestOptions);
   }
+  /**
+   * 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
+   */
+  async findOneOptional(prompt, config, requestOptions = {}) {
+    const augmentedConfig = {
+      ...config,
+      nodeHandleId: this.nodeHandleId
+    };
+    return this.windowClient.findOneOptional(prompt, augmentedConfig, requestOptions);
+  }
   /**
    * Find many elements in the node
    * @param prompt - The prompt to use for the find many
@@ -386,6 +399,19 @@ var AirtopNode = class {
     };
     return this.windowClient.findMany(prompt, augmentedConfig, requestOptions);
   }
+  /**
+   * 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
+   */
+  async findManyOptional(prompt, config, requestOptions = {}) {
+    const augmentedConfig = {
+      ...config,
+      nodeHandleId: this.nodeHandleId
+    };
+    return this.windowClient.findManyOptional(prompt, augmentedConfig, requestOptions);
+  }
 };
 
 // src/window/AirtopWindowScreenshot.ts
@@ -1422,8 +1448,191 @@ function registerAirtopPlugin(plugin) {
   }
 }
 
-// src/AirtopMocks.ts
+// src/agent/AirtopAgentClient.ts
+import { version as version2 } from "node:process";
 import { Airtop as AirtopCore2 } from "@airtop/core";
+import { minutesToMilliseconds as minutesToMilliseconds2 } from "date-fns";
+import { ConsoleTransport as ConsoleTransport2 } from "loglayer";
+import { LogLayer as LogLayer2 } from "loglayer";
+import { serializeError as serializeError2 } from "serialize-error";
+var AirtopAgentClient = class extends AirtopBase {
+  /**
+   * Creates a new instance of the Airtop SDK.
+   * @param config - Configuration options for the Airtop SDK
+   */
+  constructor(config) {
+    super({
+      logLevel: config?.logLevel,
+      client: new AirtopCore2({
+        maxRetries: 0,
+        timeout: minutesToMilliseconds2(1),
+        apiKey: config.apiKey,
+        baseURL: config?.airtopUrl,
+        logLevel: config?.logLevel || "off",
+        defaultHeaders: {
+          "x-airtop-sdk-source": "typescript",
+          "x-airtop-sdk-version": version2
+        }
+      }),
+      log: config?.logger || new LogLayer2({
+        errorSerializer: serializeError2,
+        transport: new ConsoleTransport2({
+          logger: console,
+          messageField: "message",
+          enabled: config.logLevel !== "off",
+          level: config.logLevel === "off" ? "error" : config.logLevel || "error"
+        }),
+        contextFieldName: "context",
+        metadataFieldName: "metadata"
+      }),
+      outputSchemaAdapter: config.outputSchemaAdapter,
+      jobId: config.jobId
+    });
+    this.log.withPrefix("[Airtop SDK]");
+    this.client.logLevel = config.logLevel;
+    this.client.logger = {
+      debug: (message, ...rest) => {
+        processLogMessage(this.log, "debug", message, rest);
+      },
+      error: (message, ...rest) => {
+        processLogMessage(this.log, "error", message, rest);
+      },
+      info: (message, ...rest) => {
+        processLogMessage(this.log, "info", message, rest);
+      },
+      warn: (message, ...rest) => {
+        processLogMessage(this.log, "warn", message, rest);
+      }
+    };
+  }
+  /**
+   * Creates a new agent.
+   * @param params - Parameters for creating the agent. Corresponds to `AirtopAgentCreateAgentParams`.
+   * @param requestOptions - Request options.
+   * @returns The created agent data, `AirtopCreateAgentResponse`.
+   */
+  async createAgent(params, requestOptions = {}) {
+    this.log.info("Creating agent");
+    return this.client.agents.createAgent(params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async getAgent(agentId, requestOptions = {}) {
+    this.log.withMetadata({ agentId }).info("Retrieving agent");
+    return this.client.agents.getAgent(agentId, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async listAgents(params, requestOptions = {}) {
+    this.log.info("Listing agents");
+    return this.client.agents.getAgents(params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async updateAgent(agentId, params, requestOptions = {}) {
+    this.log.withMetadata({ agentId }).info("Updating agent");
+    return this.client.agents.updateAgent(agentId, params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async deleteAgents(params, requestOptions = {}) {
+    this.log.info("Deleting agent(s)");
+    return this.client.agents.deleteAgents(params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async duplicateAgent(agentId, params, requestOptions = {}) {
+    this.log.withMetadata({ agentId }).info("Duplicating agent");
+    return this.client.agents.duplicateAgent(agentId, params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async createAgentVersion(agentId, params, requestOptions = {}) {
+    this.log.withMetadata({ agentId }).info("Creating agent version");
+    return this.client.agents.createVersion(agentId, params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async listAgentVersions(agentId, params, requestOptions = {}) {
+    this.log.withMetadata({ agentId }).info("Listing agent versions");
+    return this.client.agents.getVersions(agentId, params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async createAgentInvocation(agentId, params, requestOptions = {}) {
+    this.log.withMetadata({ agentId }).info("Creating agent invocation");
+    return this.client.agents.createInvocation(agentId, params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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`.
+   */
+  async listAgentInvocations(agentIds, params, requestOptions = {}) {
+    this.log.withMetadata({ agentId: agentIds }).info("Listing agent invocations");
+    return this.client.agents.getInvocations(agentIds, params, this.resolveRequestOptions(requestOptions));
+  }
+  /**
+   * 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.
+   */
+  async cancelAgentInvocation(agentId, invocationId, paramsBody, requestOptions = {}) {
+    this.log.withMetadata({ agentId, invocationId }).info("Cancelling agent invocation");
+    const resolvedOptions = this.resolveRequestOptions(requestOptions);
+    const finalOptions = { ...resolvedOptions };
+    const params = { id: agentId, ...paramsBody };
+    if (paramsBody) {
+      finalOptions.body = paramsBody;
+    }
+    await this.client.agents.cancelInvocation(invocationId, params, finalOptions);
+  }
+};
+
+// src/AirtopMocks.ts
+import { Airtop as AirtopCore3 } from "@airtop/core";
 import { MockLogLayer } from "loglayer";
 import { v4 as uuidv4 } from "uuid";
 function createNoOpClient(client) {
@@ -1446,7 +1655,7 @@ function createNoOpClient(client) {
   });
 }
 function generateCommonAirtopConfigMock() {
-  const client = new AirtopCore2({
+  const client = new AirtopCore3({
     apiKey: "test-api-key"
   });
   return {
@@ -1513,6 +1722,7 @@ var AirtopMocks = class {
   }
 };
 export {
+  AirtopAgentClient,
   AirtopBase,
   AirtopClient,
   AirtopError,