@airtop/sdk 1.0.0-alpha2.23 → 1.0.0-alpha2.25

package/dist/index.d.cts

@@ -4,17 +4,18 @@ import { AirtopJsonSchemaAdapter } from '@airtop/json-schema-adapter';
 export { AirtopJsonSchemaAdapter } from '@airtop/json-schema-adapter';
 import { ILogLayer } from 'loglayer';
 export { ILogLayer } from 'loglayer';
-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 { Issue, SessionConfigV1, GetFileResponse, FilesResponse, ListAutomationsOutput, AutomationData, ServicePromptActionResponseEnvelope, ExternalSessionWithConnectionInfo, EnvelopeDefaultMeta, ExtractActionResponseEnvelope, ActActionResponseEnvelope, LlmActionResponseEnvelope, NodeHandle, WaitForPageActionResponseEnvelope, NavigateActionResponseEnvelope, FindOneActionResponseEnvelope, FindManyActionResponseEnvelope, AIPromptResponse as AIPromptResponse$1, WindowIDDataResponse, OperationOutcomeResponse, WindowsResponse } 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, WindowsResponse, WindowsWithMeta } 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, FileCreateFileParams, WindowCreateParams, 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 * as _airtop_core_resources_js from '@airtop/core/resources.js';
-import { ConnectedServicesActionResponseEnvelope } from '@airtop/core/resources.js';
-import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams, WindowExtractParams, WindowActParams, WindowLlmParams, WindowFindOneParams, WindowFindManyParams, WindowWaitForPageParams, WindowNavigateParams, WindowFillFormParams } from '@airtop/core/resources/windows.js';
+import { ServicePromptParameters, ConnectedServicesActionResponseEnvelope } from '@airtop/core/resources.js';
+import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowPageQueryParams, WindowPaginatedExtractionParams, 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';
+import { DeepOmit } from 'deep-utility-types';
 export { DeepOmit } from 'deep-utility-types';
 
 /**
@@ -58,7 +59,7 @@ interface CommonAirtopConfig {
  * Configuration for defining the JSON schema output.
  */
 interface OutputJsonSchemaConfig {
-    configuration: {
+    configuration?: {
         /**
          * JSON schema defining the structure of the output.
          */
@@ -458,16 +459,18 @@ interface WindowLoadUrlConfig extends Omit<WindowLoadURLParams, "sessionId" | "u
  */
 interface WindowMonitorConfig extends Omit<WindowMonitorParams, "sessionId" | "condition"> {
 }
+interface WindowPageQueryParamsBase extends DeepOmit<WindowPageQueryParams, "sessionId" | "prompt" | "configuration.outputSchema"> {
+}
 /**
  * Configuration parameters for performing a natural language query on page content.
  */
-interface WindowPageQueryConfig extends OutputJsonSchemaConfig {
+type WindowPageQueryConfig = WindowPageQueryParamsBase & OutputJsonSchemaConfig;
+interface WindowPaginatedExtractionParamsBase extends DeepOmit<WindowPaginatedExtractionParams, "sessionId" | "prompt" | "configuration.outputSchema"> {
 }
 /**
  * Configuration parameters for extracting paginated data from a window.
  */
-interface WindowPaginatedExtractionConfig extends OutputJsonSchemaConfig {
-}
+type WindowPaginatedExtractionConfig = WindowPaginatedExtractionParamsBase & OutputJsonSchemaConfig;
 /**
  * Configuration parameters for scraping content from a window.
  * Excludes session ID which is provided by the parent session.
@@ -893,7 +896,7 @@ declare class AirtopSessionClient extends AirtopBase {
      * Returns the browser session ID.
      */
     getSessionId(): string;
-    listWindows(requestOptions?: AirtopRequestOptions): Promise<_airtop_core_resources_shared_mjs.WindowsResponse>;
+    listWindows(requestOptions?: AirtopRequestOptions): Promise<WindowsResponse>;
     /**
      * Gets the state of the session using the attached session id.
      * @param requestOptions - Request options
@@ -938,12 +941,19 @@ declare class AirtopSessionClient extends AirtopBase {
     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
+     * Calls the service endpoint with a string prompt.
+     * @param prompt - Natural language description of the task to perform with third-party services (e.g., "read data from Google Sheets", "create a HubSpot lead", "update this document")
+     * @param service - The service id or array of service ids that will be leveraged to achieve the intent of the prompt
      * @param requestOptions - Request options
+     * @deprecated Use `service(args: ServicePromptParameters, requestOptions?: AirtopRequestOptions)` instead
      */
     service(prompt: string, service?: string, requestOptions?: AirtopRequestOptions): Promise<SessionServiceResponse>;
+    /**
+     * Calls the service endpoint with ServicePromptParameters.
+     * @param parameters - The service parameters object
+     * @param requestOptions - Request options
+     */
+    service(parameters: ServicePromptParameters, requestOptions?: AirtopRequestOptions): Promise<SessionServiceResponse>;
     /**
      * Retrieves the list of connected services available for the current session.
      * @param requestOptions - Request options
@@ -1121,6 +1131,8 @@ declare class AirtopMocks {
 
 interface AirtopAgentCreateAgentParams extends Airtop.AgentCreateAgentParams {
 }
+interface AirtopAgentGetAgentParams extends Airtop.AgentGetAgentParams {
+}
 interface AirtopAgentGetAgentsParams extends Airtop.AgentGetAgentsParams {
 }
 interface AirtopAgentUpdateAgentParams extends Airtop.AgentUpdateAgentParams {
@@ -1137,6 +1149,8 @@ interface AirtopAgentGetVersionDataParams extends Airtop.AgentGetCurrentAgentVer
 }
 interface AirtopAgentUpdateVersionDataParams extends Omit<Airtop.AgentUpdateAgentVersionDataParams, "id"> {
 }
+interface AirtopAgentPublishAgentParams extends Airtop.AgentPublishAgentParams {
+}
 interface AirtopCreateAgentResponse extends Airtop.CreateAgentResponse {
 }
 interface AirtopGetAgentResponse extends Airtop.GetAgentResponse {
@@ -1155,7 +1169,7 @@ interface AirtopAgentResponse extends Airtop.GetAgentResponse {
 }
 interface AirtopCreateNewAgentDraftResponse extends Airtop.AgentCreateDraftResponse {
 }
-interface AirtopPublishNewAgentResponse extends Airtop.AgentPublishAgentResponse {
+interface AirtopPublishNewAgentResponse extends Airtop.AgentPublishDraftResponse {
 }
 interface AirtopGetAgentVersionDataResponse extends Airtop.AgentGetVersionDataResponse {
 }
@@ -1184,7 +1198,7 @@ declare class AirtopAgentClient extends AirtopBase {
      * @param requestOptions - Request options.
      * @returns The agent data.
      */
-    getAgent(agentId: string, requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentResponse>;
+    getAgent(agentId: string, params?: AirtopAgentGetAgentParams, requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentResponse>;
     /**
      * Lists agents.
      * @param params - Optional parameters for listing agents (e.g., pagination).
@@ -1204,7 +1218,7 @@ declare class AirtopAgentClient extends AirtopBase {
      * @param agentId - The ID of the agent to publish.
      * @returns The published version data
      */
-    publishNewAgentVersion(agentId: string): Promise<AirtopPublishNewAgentResponse>;
+    publishNewAgentVersion(agentId: string, params?: AirtopAgentPublishAgentParams, requestOptions?: AirtopRequestOptions): Promise<AirtopPublishNewAgentResponse>;
     /**
      * Retrieves the data for a specific version of an agent.
      * @param agentId - The ID of the agent.
@@ -1433,4 +1447,4 @@ interface AirtopPluginRegistration {
  */
 declare function registerAirtopPlugin(plugin: AirtopPluginRegistration): void;
 
-export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, type AirtopFileListParams, type AirtopFileResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type 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 WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };
+export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentPublishAgentParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, type AirtopFileListParams, type AirtopFileResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type 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 WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };

package/dist/index.d.ts

@@ -4,17 +4,18 @@ import { AirtopJsonSchemaAdapter } from '@airtop/json-schema-adapter';
 export { AirtopJsonSchemaAdapter } from '@airtop/json-schema-adapter';
 import { ILogLayer } from 'loglayer';
 export { ILogLayer } from 'loglayer';
-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 { Issue, SessionConfigV1, GetFileResponse, FilesResponse, ListAutomationsOutput, AutomationData, ServicePromptActionResponseEnvelope, ExternalSessionWithConnectionInfo, EnvelopeDefaultMeta, ExtractActionResponseEnvelope, ActActionResponseEnvelope, LlmActionResponseEnvelope, NodeHandle, WaitForPageActionResponseEnvelope, NavigateActionResponseEnvelope, FindOneActionResponseEnvelope, FindManyActionResponseEnvelope, AIPromptResponse as AIPromptResponse$1, WindowIDDataResponse, OperationOutcomeResponse, WindowsResponse } 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, WindowsResponse, WindowsWithMeta } 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, FileCreateFileParams, WindowCreateParams, 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 * as _airtop_core_resources_js from '@airtop/core/resources.js';
-import { ConnectedServicesActionResponseEnvelope } from '@airtop/core/resources.js';
-import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams, WindowExtractParams, WindowActParams, WindowLlmParams, WindowFindOneParams, WindowFindManyParams, WindowWaitForPageParams, WindowNavigateParams, WindowFillFormParams } from '@airtop/core/resources/windows.js';
+import { ServicePromptParameters, ConnectedServicesActionResponseEnvelope } from '@airtop/core/resources.js';
+import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowPageQueryParams, WindowPaginatedExtractionParams, 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';
+import { DeepOmit } from 'deep-utility-types';
 export { DeepOmit } from 'deep-utility-types';
 
 /**
@@ -58,7 +59,7 @@ interface CommonAirtopConfig {
  * Configuration for defining the JSON schema output.
  */
 interface OutputJsonSchemaConfig {
-    configuration: {
+    configuration?: {
         /**
          * JSON schema defining the structure of the output.
          */
@@ -458,16 +459,18 @@ interface WindowLoadUrlConfig extends Omit<WindowLoadURLParams, "sessionId" | "u
  */
 interface WindowMonitorConfig extends Omit<WindowMonitorParams, "sessionId" | "condition"> {
 }
+interface WindowPageQueryParamsBase extends DeepOmit<WindowPageQueryParams, "sessionId" | "prompt" | "configuration.outputSchema"> {
+}
 /**
  * Configuration parameters for performing a natural language query on page content.
  */
-interface WindowPageQueryConfig extends OutputJsonSchemaConfig {
+type WindowPageQueryConfig = WindowPageQueryParamsBase & OutputJsonSchemaConfig;
+interface WindowPaginatedExtractionParamsBase extends DeepOmit<WindowPaginatedExtractionParams, "sessionId" | "prompt" | "configuration.outputSchema"> {
 }
 /**
  * Configuration parameters for extracting paginated data from a window.
  */
-interface WindowPaginatedExtractionConfig extends OutputJsonSchemaConfig {
-}
+type WindowPaginatedExtractionConfig = WindowPaginatedExtractionParamsBase & OutputJsonSchemaConfig;
 /**
  * Configuration parameters for scraping content from a window.
  * Excludes session ID which is provided by the parent session.
@@ -893,7 +896,7 @@ declare class AirtopSessionClient extends AirtopBase {
      * Returns the browser session ID.
      */
     getSessionId(): string;
-    listWindows(requestOptions?: AirtopRequestOptions): Promise<_airtop_core_resources_shared_mjs.WindowsResponse>;
+    listWindows(requestOptions?: AirtopRequestOptions): Promise<WindowsResponse>;
     /**
      * Gets the state of the session using the attached session id.
      * @param requestOptions - Request options
@@ -938,12 +941,19 @@ declare class AirtopSessionClient extends AirtopBase {
     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
+     * Calls the service endpoint with a string prompt.
+     * @param prompt - Natural language description of the task to perform with third-party services (e.g., "read data from Google Sheets", "create a HubSpot lead", "update this document")
+     * @param service - The service id or array of service ids that will be leveraged to achieve the intent of the prompt
      * @param requestOptions - Request options
+     * @deprecated Use `service(args: ServicePromptParameters, requestOptions?: AirtopRequestOptions)` instead
      */
     service(prompt: string, service?: string, requestOptions?: AirtopRequestOptions): Promise<SessionServiceResponse>;
+    /**
+     * Calls the service endpoint with ServicePromptParameters.
+     * @param parameters - The service parameters object
+     * @param requestOptions - Request options
+     */
+    service(parameters: ServicePromptParameters, requestOptions?: AirtopRequestOptions): Promise<SessionServiceResponse>;
     /**
      * Retrieves the list of connected services available for the current session.
      * @param requestOptions - Request options
@@ -1121,6 +1131,8 @@ declare class AirtopMocks {
 
 interface AirtopAgentCreateAgentParams extends Airtop.AgentCreateAgentParams {
 }
+interface AirtopAgentGetAgentParams extends Airtop.AgentGetAgentParams {
+}
 interface AirtopAgentGetAgentsParams extends Airtop.AgentGetAgentsParams {
 }
 interface AirtopAgentUpdateAgentParams extends Airtop.AgentUpdateAgentParams {
@@ -1137,6 +1149,8 @@ interface AirtopAgentGetVersionDataParams extends Airtop.AgentGetCurrentAgentVer
 }
 interface AirtopAgentUpdateVersionDataParams extends Omit<Airtop.AgentUpdateAgentVersionDataParams, "id"> {
 }
+interface AirtopAgentPublishAgentParams extends Airtop.AgentPublishAgentParams {
+}
 interface AirtopCreateAgentResponse extends Airtop.CreateAgentResponse {
 }
 interface AirtopGetAgentResponse extends Airtop.GetAgentResponse {
@@ -1155,7 +1169,7 @@ interface AirtopAgentResponse extends Airtop.GetAgentResponse {
 }
 interface AirtopCreateNewAgentDraftResponse extends Airtop.AgentCreateDraftResponse {
 }
-interface AirtopPublishNewAgentResponse extends Airtop.AgentPublishAgentResponse {
+interface AirtopPublishNewAgentResponse extends Airtop.AgentPublishDraftResponse {
 }
 interface AirtopGetAgentVersionDataResponse extends Airtop.AgentGetVersionDataResponse {
 }
@@ -1184,7 +1198,7 @@ declare class AirtopAgentClient extends AirtopBase {
      * @param requestOptions - Request options.
      * @returns The agent data.
      */
-    getAgent(agentId: string, requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentResponse>;
+    getAgent(agentId: string, params?: AirtopAgentGetAgentParams, requestOptions?: AirtopRequestOptions): Promise<AirtopGetAgentResponse>;
     /**
      * Lists agents.
      * @param params - Optional parameters for listing agents (e.g., pagination).
@@ -1204,7 +1218,7 @@ declare class AirtopAgentClient extends AirtopBase {
      * @param agentId - The ID of the agent to publish.
      * @returns The published version data
      */
-    publishNewAgentVersion(agentId: string): Promise<AirtopPublishNewAgentResponse>;
+    publishNewAgentVersion(agentId: string, params?: AirtopAgentPublishAgentParams, requestOptions?: AirtopRequestOptions): Promise<AirtopPublishNewAgentResponse>;
     /**
      * Retrieves the data for a specific version of an agent.
      * @param agentId - The ID of the agent.
@@ -1433,4 +1447,4 @@ interface AirtopPluginRegistration {
  */
 declare function registerAirtopPlugin(plugin: AirtopPluginRegistration): void;
 
-export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, type AirtopFileListParams, type AirtopFileResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type 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 WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };
+export { type AirtopAgentCancelInvocationParams, AirtopAgentClient, type AirtopAgentCreateAgentParams, type AirtopAgentCreateInvocationParams, type AirtopAgentDeleteAgentsParams, type AirtopAgentGetAgentParams, type AirtopAgentGetAgentsParams, type AirtopAgentGetInvocationsParams, type AirtopAgentGetVersionDataParams, type AirtopAgentPublishAgentParams, type AirtopAgentResponse, type AirtopAgentUpdateAgentParams, type AirtopAgentUpdateVersionDataParams, type AirtopAutomationData, type AirtopAutomationListResponse, type AirtopAutomationUpdateDescriptionConfig, AirtopBase, AirtopClient, type AirtopClientPlugin, type AirtopConstructorConfig, type AirtopCreateAgentInvocationResponse, type AirtopCreateAgentResponse, type AirtopCreateNewAgentDraftResponse, type AirtopDeleteAgentsResponse, AirtopError, type AirtopFileListParams, type AirtopFileResponse, type AirtopFilesResponse, type AirtopGetAgentInvocationsResponse, type AirtopGetAgentResponse, type AirtopGetAgentVersionDataResponse, type AirtopGetAgentsResponse, AirtopMocks, AirtopNode, type AirtopNodeApiResponseData, AirtopPluginAugmentationType, type AirtopPluginRegistration, type AirtopPluginType, type AirtopProfile, type AirtopPublishNewAgentResponse, type AirtopRequestOptions, AirtopSession, AirtopSessionClient, type AirtopSessionClientPlugin, type AirtopSessionPlugin, type AirtopSessionResponse, type AirtopUpdateAgentResponse, type AirtopUpdateVersionDataResponse, AirtopWindow, AirtopWindowClient, type AirtopWindowClientPlugin, type AirtopWindowCreateResponse, type AirtopWindowGetInfoResponse, type AirtopWindowPlugin, AirtopWindowScreenshot, type AirtopWindowScreenshotPlugin, type AirtopWindowScreenshotResponse, type CommonAirtopConfig, type 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 WindowCreateOptions, type WindowError, type WindowExtractConfig, type WindowExtractResponse, type WindowFillFormConfig, type WindowFindManyConfig, type WindowFindManyResponse, type WindowFindOneConfig, type WindowFindOneResponse, type WindowGetConfig, type WindowHoverConfig, type WindowInfoData, type WindowLlmConfig, type WindowLlmResponse, type WindowLoadUrlConfig, type WindowMetadata, type WindowMonitorConfig, type WindowNavigateConfig, WindowNavigateDirection, type WindowNavigateResponse, type WindowPageQueryConfig, type WindowPaginatedExtractionConfig, type WindowPromptResponse, type WindowScrapeConfig, type WindowScrapeResponse, type WindowScreenshotConfig, type WindowScrollConfig, type WindowTypeConfig, type WindowWaitForPageConfig, type WindowWaitForPageResponse, type WindowWarning, registerAirtopPlugin };

package/dist/index.js

@@ -9,7 +9,7 @@ var require_package = __commonJS({
     module.exports = {
       name: "@airtop/sdk",
       description: "Airtop SDK for TypeScript",
-      version: "1.0.0-alpha2.23",
+      version: "1.0.0-alpha2.25",
       type: "module",
       main: "./dist/index.cjs",
       module: "./dist/index.js",
@@ -47,8 +47,8 @@ var require_package = __commonJS({
         "verify-types": "tsc --noEmit && tsc --noEmit --project tsconfig.e2e.json"
       },
       dependencies: {
+        "@airtop/core": "0.1.0-alpha.41",
         "@airtop/json-schema-adapter": "workspace:*",
-        "@airtop/core": "0.1.0-alpha.39",
         "date-fns": "4.1.0",
         loglayer: "6.6.0",
         "serialize-error": "12.0.0",
@@ -1261,18 +1261,32 @@ var AirtopSessionClient = class extends AirtopBase {
     );
   }
   /**
-   * 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
-   */
-  async service(prompt, service, requestOptions = {}) {
-    this.log.withMetadata({ prompt }).info("Service");
-    return withRequestCompletionPolling(
-      this.client,
-      () => this.client.sessions.service(this.sessionId, { prompt, service }),
-      requestOptions
-    );
+   * Implementation for the overloaded service method.
+   */
+  async service(promptOrArgs, serviceOrRequestOptions, requestOptions = {}) {
+    if (typeof promptOrArgs === "string") {
+      const prompt = promptOrArgs;
+      const service = typeof serviceOrRequestOptions === "string" ? serviceOrRequestOptions : void 0;
+      const options = typeof serviceOrRequestOptions === "object" ? serviceOrRequestOptions : requestOptions;
+      this.log.withMetadata({ prompt }).info("Service");
+      const parameters = { prompt, services: service };
+      const body = { parameters };
+      return withRequestCompletionPolling(
+        this.client,
+        () => this.client.sessions.service(this.sessionId, body),
+        options
+      );
+    } else {
+      const parameters = promptOrArgs;
+      const options = serviceOrRequestOptions || {};
+      this.log.withMetadata({ parameters }).info("Service");
+      const body = { parameters };
+      return withRequestCompletionPolling(
+        this.client,
+        () => this.client.sessions.service(this.sessionId, body),
+        options
+      );
+    }
   }
   /**
    * Retrieves the list of connected services available for the current session.
@@ -1709,9 +1723,9 @@ var AirtopAgentClient = class extends AirtopBase {
    * @param requestOptions - Request options.
    * @returns The agent data.
    */
-  async getAgent(agentId, requestOptions = {}) {
+  async getAgent(agentId, params = {}, requestOptions = {}) {
     this.log.withMetadata({ agentId }).info("Retrieving agent");
-    return this.client.agents.getAgent(agentId, this.resolveRequestOptions(requestOptions));
+    return this.client.agents.getAgent(agentId, params, this.resolveRequestOptions(requestOptions));
   }
   /**
    * Lists agents.
@@ -1731,16 +1745,16 @@ var AirtopAgentClient = class extends AirtopBase {
    */
   async createNewAgentDraftVersion(agentId, requestOptions = {}) {
     this.log.withMetadata({ agentId }).info("Creating new draft version of agent");
-    return this.client.agents.createAgentDraft(agentId, this.resolveRequestOptions(requestOptions));
+    return this.client.agents.createAgentDraft(agentId, {}, this.resolveRequestOptions(requestOptions));
   }
   /**
    * Publishes a new version of an agent from the current draft.
    * @param agentId - The ID of the agent to publish.
    * @returns The published version data
    */
-  async publishNewAgentVersion(agentId) {
+  async publishNewAgentVersion(agentId, params = {}, requestOptions = {}) {
     this.log.withMetadata({ agentId }).info("Publishing new version of agent");
-    return this.client.agents.publishAgent(agentId, this.resolveRequestOptions());
+    return this.client.agents.publishAgent(agentId, params, this.resolveRequestOptions(requestOptions));
   }
   /**
    * Retrieves the data for a specific version of an agent.