@airtop/sdk 1.0.0-alpha2.17 → 1.0.0-alpha2.18

package/dist/index.d.cts

@@ -11,7 +11,7 @@ import * as _airtop_core_resources_shared_mjs from '@airtop/core/resources/share
 import { AutomationUpdateDescriptionParams } from '@airtop/core/resources/automations.js';
 import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
 import * as _airtop_core_resources_sessions_mjs from '@airtop/core/resources/sessions.mjs';
-import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams, WindowExtractParams, WindowActParams, WindowLlmParams, WindowFindOneParams, WindowFindManyParams, WindowWaitForPageParams, WindowNavigateParams } 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';
 
 /**
  * Shared configuration between Airtop classes.
@@ -90,7 +90,8 @@ interface CommonResponse {
  */
 declare class AirtopError extends Error {
     issues: Issue[];
-    constructor(issues: Issue[]);
+    metadata?: Record<string, unknown>;
+    constructor(issues: Issue[], metadata?: Record<string, unknown>);
 }
 
 /**
@@ -430,7 +431,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.
@@ -493,7 +494,8 @@ interface WindowActResponse extends ActActionResponseEnvelope {
 /**
  * Configuration parameters for executing an LLM call in a window.
  */
-interface WindowLlmConfig extends Omit<WindowLlmParams, "sessionId" | "prompt"> {
+interface WindowLlmConfig extends Omit<WindowLlmParams, "sessionId" | "jobId" | "prompt" | "includeWebContext" | "outputSchema"> {
+    outputSchema?: string | object;
 }
 /**
  * LLM window response.
@@ -552,6 +554,11 @@ declare enum WindowNavigateDirection {
  */
 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
@@ -787,7 +794,7 @@ 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>;
@@ -799,6 +806,7 @@ declare class AirtopWindowClient extends AirtopBase {
     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>;
 }
 
 /**
@@ -860,6 +868,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
@@ -902,6 +911,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<unknown>;
 }
 
 /**
@@ -1385,4 +1402,4 @@ declare class AirtopMocks {
     }): AirtopWindow<AirtopWindowGetInfoResponse>;
 }
 
-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 WindowActResponse, type WindowClickConfig, type WindowCreateData, type WindowError, type WindowExtractConfig, type WindowExtractResponse, 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 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 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 };

package/dist/index.d.ts

@@ -11,7 +11,7 @@ import * as _airtop_core_resources_shared_mjs from '@airtop/core/resources/share
 import { AutomationUpdateDescriptionParams } from '@airtop/core/resources/automations.js';
 import { SessionListParams, ProfileOutput, FileListParams, FileCreateFileParams, WindowIDData, EnvelopeDefaultMeta as EnvelopeDefaultMeta$1, Issue as Issue$1, WindowInfo, WindowGetParams, AIPromptResponse, ScrapeResponse } from '@airtop/core/resources/index.js';
 import * as _airtop_core_resources_sessions_mjs from '@airtop/core/resources/sessions.mjs';
-import { WindowClickParams, WindowHoverParams, WindowLoadURLParams, WindowMonitorParams, WindowScrapeParams, WindowScreenshotParams, WindowScrollParams, WindowTypeParams, WindowExtractParams, WindowActParams, WindowLlmParams, WindowFindOneParams, WindowFindManyParams, WindowWaitForPageParams, WindowNavigateParams } 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';
 
 /**
  * Shared configuration between Airtop classes.
@@ -90,7 +90,8 @@ interface CommonResponse {
  */
 declare class AirtopError extends Error {
     issues: Issue[];
-    constructor(issues: Issue[]);
+    metadata?: Record<string, unknown>;
+    constructor(issues: Issue[], metadata?: Record<string, unknown>);
 }
 
 /**
@@ -430,7 +431,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.
@@ -493,7 +494,8 @@ interface WindowActResponse extends ActActionResponseEnvelope {
 /**
  * Configuration parameters for executing an LLM call in a window.
  */
-interface WindowLlmConfig extends Omit<WindowLlmParams, "sessionId" | "prompt"> {
+interface WindowLlmConfig extends Omit<WindowLlmParams, "sessionId" | "jobId" | "prompt" | "includeWebContext" | "outputSchema"> {
+    outputSchema?: string | object;
 }
 /**
  * LLM window response.
@@ -552,6 +554,11 @@ declare enum WindowNavigateDirection {
  */
 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
@@ -787,7 +794,7 @@ 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>;
@@ -799,6 +806,7 @@ declare class AirtopWindowClient extends AirtopBase {
     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>;
 }
 
 /**
@@ -860,6 +868,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
@@ -902,6 +911,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<unknown>;
 }
 
 /**
@@ -1385,4 +1402,4 @@ declare class AirtopMocks {
     }): AirtopWindow<AirtopWindowGetInfoResponse>;
 }
 
-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 WindowActResponse, type WindowClickConfig, type WindowCreateData, type WindowError, type WindowExtractConfig, type WindowExtractResponse, 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 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 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 };

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.17",
+      version: "1.0.0-alpha2.18",
       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.30",
+        "@airtop/core": "0.1.0-alpha.33",
         "date-fns": "4.1.0",
         loglayer: "6.3.3",
         "serialize-error": "12.0.0",
@@ -268,22 +268,26 @@ var processLogMessage = (log, logLevel, ...args) => {
 
 // src/session/AirtopSessionClient.ts
 import { NotFoundError } from "@airtop/core";
+import { secondsToMilliseconds as secondsToMilliseconds4 } from "date-fns";
+
+// src/async-utils.ts
+import { secondsToMilliseconds as secondsToMilliseconds2 } from "date-fns";
 
 // src/types.ts
 var AirtopError = class extends Error {
   issues;
-  constructor(issues) {
+  metadata;
+  constructor(issues, metadata) {
     const errorMessage = issues.map((issue) => issue.message).join("\n");
-    super(errorMessage);
+    const errorMessageWithMetadata = metadata ? `${errorMessage}
+${JSON.stringify(metadata)}` : errorMessage;
+    super(errorMessageWithMetadata);
     this.issues = issues;
+    this.metadata = metadata;
   }
 };
 
-// src/window/AirtopWindowClient.ts
-import { secondsToMilliseconds as secondsToMilliseconds3 } from "date-fns";
-
 // src/async-utils.ts
-import { secondsToMilliseconds as secondsToMilliseconds2 } from "date-fns";
 var DEFAULT_TIMEOUT_SECONDS = 300;
 var DEFAULT_POLLING_INTERVAL_MS = 500;
 async function waitForRequestCompletion(client, requestId, requestOptions) {
@@ -307,12 +311,17 @@ async function withRequestCompletionPolling(client, fn, requestOptions) {
     return waitForRequestCompletion(client, response.requestId, requestOptions);
   } catch (thrownError) {
     if (thrownError.error?.errors) {
-      throw new AirtopError(thrownError.error.errors);
+      throw new AirtopError(thrownError.error.errors, {
+        requestId: thrownError.error.requestId
+      });
     }
     throw thrownError;
   }
 }
 
+// src/window/AirtopWindowClient.ts
+import { secondsToMilliseconds as secondsToMilliseconds3 } from "date-fns";
+
 // src/window/AirtopNode.ts
 var AirtopNode = class {
   /**
@@ -370,7 +379,7 @@ var AirtopNode = class {
    * @param requestOptions - The request options to use for the LLM call
    */
   async llm(prompt, config, requestOptions = {}) {
-    return this.windowClient.llm(prompt, config, requestOptions);
+    return this.windowClient.llm(prompt, { ...config, nodeHandleId: this.nodeHandleId }, requestOptions);
   }
   /**
    * Find one element in the node
@@ -579,17 +588,20 @@ var AirtopWindowClient = class extends AirtopBase {
     this.log.withMetadata({
       elementDescription
     }).info("Clicking on element");
-    return this.client.windows.click(
-      this.getWindowId(),
-      {
-        ...config,
-        elementDescription,
-        sessionId: this.sessionId
-      },
-      {
-        timeout: secondsToMilliseconds3(600),
-        ...this.resolveRequestOptions(requestOptions)
-      }
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.clickAsync(
+        this.getWindowId(),
+        {
+          ...config,
+          elementDescription,
+          sessionId: this.sessionId
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
     );
   }
   /**
@@ -611,17 +623,20 @@ var AirtopWindowClient = class extends AirtopBase {
    */
   async hover(elementDescription, config, requestOptions = {}) {
     this.log.withMetadata(config).info("Hovering over window");
-    return this.client.windows.hover(
-      this.getWindowId(),
-      {
-        elementDescription,
-        sessionId: this.sessionId,
-        ...config || {}
-      },
-      {
-        timeout: secondsToMilliseconds3(600),
-        ...this.resolveRequestOptions(requestOptions)
-      }
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.hoverAsync(
+        this.getWindowId(),
+        {
+          elementDescription,
+          sessionId: this.sessionId,
+          ...config || {}
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
     );
   }
   /**
@@ -657,17 +672,20 @@ var AirtopWindowClient = class extends AirtopBase {
    */
   async monitor(condition, config, requestOptions = {}) {
     this.log.withMetadata().info("Monitoring window");
-    return this.client.windows.monitor(
-      this.getWindowId(),
-      {
-        condition,
-        sessionId: this.sessionId,
-        ...config || {}
-      },
-      {
-        timeout: secondsToMilliseconds3(600),
-        ...this.resolveRequestOptions(requestOptions)
-      }
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.monitorAsync(
+        this.getWindowId(),
+        {
+          condition,
+          sessionId: this.sessionId,
+          ...config || {}
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
     );
   }
   /**
@@ -685,17 +703,20 @@ var AirtopWindowClient = class extends AirtopBase {
     if (config?.configuration.outputSchema) {
       newConfig.configuration.outputSchema = this.convertToJsonSchema(config.configuration.outputSchema);
     }
-    return this.client.windows.pageQuery(
-      this.getWindowId(),
-      {
-        sessionId: this.sessionId,
-        prompt,
-        ...newConfig || {}
-      },
-      {
-        timeout: secondsToMilliseconds3(600),
-        ...this.resolveRequestOptions(requestOptions)
-      }
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.pageQueryAsync(
+        this.getWindowId(),
+        {
+          sessionId: this.sessionId,
+          prompt,
+          ...newConfig || {}
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
     );
   }
   /**
@@ -713,17 +734,20 @@ var AirtopWindowClient = class extends AirtopBase {
     if (config?.configuration.outputSchema) {
       newConfig.configuration.outputSchema = this.convertToJsonSchema(config.configuration.outputSchema);
     }
-    return this.client.windows.paginatedExtraction(
-      this.getWindowId(),
-      {
-        prompt,
-        sessionId: this.sessionId,
-        ...newConfig || {}
-      },
-      {
-        timeout: secondsToMilliseconds3(600),
-        ...this.resolveRequestOptions(requestOptions)
-      }
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.paginatedExtractionAsync(
+        this.getWindowId(),
+        {
+          prompt,
+          sessionId: this.sessionId,
+          ...newConfig || {}
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
     );
   }
   /**
@@ -754,16 +778,19 @@ var AirtopWindowClient = class extends AirtopBase {
    */
   async screenshot(config, requestOptions = {}) {
     this.log.info("Screenshotting window");
-    const resp = await this.client.windows.screenshot(
-      this.getWindowId(),
-      {
-        sessionId: this.sessionId,
-        ...config || {}
-      },
-      {
-        timeout: secondsToMilliseconds3(600),
-        ...this.resolveRequestOptions(requestOptions)
-      }
+    const resp = await withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.screenshotAsync(
+        this.getWindowId(),
+        {
+          sessionId: this.sessionId,
+          ...config || {}
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
     );
     return new AirtopWindowScreenshot(resp);
   }
@@ -798,17 +825,20 @@ var AirtopWindowClient = class extends AirtopBase {
     this.log.withMetadata({
       text
     }).info("Typing text");
-    return this.client.windows.type(
-      this.getWindowId(),
-      {
-        sessionId: this.sessionId,
-        text,
-        ...config || {}
-      },
-      {
-        timeout: secondsToMilliseconds3(600),
-        ...this.resolveRequestOptions(requestOptions)
-      }
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.typeAsync(
+        this.getWindowId(),
+        {
+          sessionId: this.sessionId,
+          text,
+          ...config || {}
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
     );
   }
   async extract(prompt, config, requestOptions = {}) {
@@ -859,7 +889,10 @@ var AirtopWindowClient = class extends AirtopBase {
           prompt,
           sessionId: this.sessionId,
           jobId: this.jobId,
-          ...config || {}
+          ...config || {},
+          includeWebContext: true,
+          // Always include web context for window.llm() calls
+          outputSchema: config?.outputSchema ? this.convertToJsonSchema(config.outputSchema) : void 0
         },
         {
           timeout: secondsToMilliseconds3(600),
@@ -974,6 +1007,27 @@ var AirtopWindowClient = class extends AirtopBase {
       )
     );
   }
+  async fillForm(formData, config, requestOptions = {}) {
+    return await withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.executeAutomation(
+        this.getWindowId(),
+        {
+          sessionId: this.sessionId,
+          ...config || {},
+          automationId: config?.automationId || "auto",
+          parameters: {
+            customData: typeof formData === "string" ? formData : JSON.stringify(formData)
+            // Will be interpreted by the LLM
+          }
+        },
+        {
+          timeout: secondsToMilliseconds3(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+  }
 };
 
 // src/window/AirtopWindow.ts
@@ -1047,6 +1101,9 @@ var AirtopSessionClient = class extends AirtopBase {
   getSessionId() {
     return this.sessionId;
   }
+  async listWindows(requestOptions = {}) {
+    return this.client.sessions.listWindows(this.sessionId, this.resolveRequestOptions(requestOptions));
+  }
   /**
    * Gets the state of the session using the attached session id.
    * @param requestOptions - Request options
@@ -1165,6 +1222,51 @@ var AirtopSessionClient = class extends AirtopBase {
       this.resolveRequestOptions(requestOptions)
     );
   }
+  async llm(prompt, config, requestOptions = {}) {
+    this.log.withMetadata({ prompt }).info("Executing LLM call");
+    const currentWindows = await this.listWindows();
+    if (currentWindows.data.windows.length === 0) {
+      throw new AirtopError([
+        {
+          message: "No windows found in the session. Please create a window before calling the llm() method."
+        }
+      ]);
+    }
+    const firstWindow = currentWindows.data.windows[0];
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.llm(
+        firstWindow.windowId,
+        {
+          prompt,
+          sessionId: this.sessionId,
+          jobId: this.jobId,
+          ...config || {},
+          includeWebContext: false,
+          // Do not include web context for session.llm() calls
+          outputSchema: config?.outputSchema ? this.convertToJsonSchema(config.outputSchema) : void 0
+        },
+        {
+          timeout: secondsToMilliseconds4(600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+  }
+  /**
+   * 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
+    );
+  }
 };
 
 // src/session/AirtopSession.ts