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

package/dist/index.cjs

@@ -9,7 +9,7 @@ var require_package = __commonJS({
     module.exports = {
       name: "@airtop/sdk",
       description: "Airtop SDK for TypeScript",
-      version: "1.0.0-alpha2.10",
+      version: "1.0.0-alpha2.12",
       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.27",
+        "@airtop/core": "0.1.0-alpha.28",
         "date-fns": "4.1.0",
         loglayer: "6.3.3",
         "serialize-error": "12.0.0",
@@ -107,6 +107,11 @@ var AirtopBase = class {
    * @internal
    */
   
+  /**
+   * Instance for sending agent events
+   * @internal
+   */
+  
   /**
    * Creates a new instance of AirtopBase
    * @param config - Configuration options for the SDK
@@ -117,6 +122,24 @@ var AirtopBase = class {
     this.outputJsonAdapter = config.outputSchemaAdapter;
     this.jobId = config.jobId;
   }
+  /**
+   * Sets the publisher for sending agent events. Internal use only.
+   * @internal
+   */
+  _setAgentEventPublisher(logger) {
+    this.agentEventPublisher = logger;
+  }
+  /**
+   * Sends a payload to the agent with the specified event name.
+   * @param eventName The name of the event
+   * @param payload The payload to send to the agent
+   * @internal
+   */
+  _sendAgentPayload(eventName, payload) {
+    if (this.agentEventPublisher) {
+      this.agentEventPublisher.withMetadata(payload).info(eventName);
+    }
+  }
   /**
    * Returns the API key used by the SDK
    * @returns API key string
@@ -241,13 +264,23 @@ var processLogMessage = (log, logLevel, ...args) => {
 // src/session/AirtopSessionClient.ts
 
 
+// src/types.ts
+var AirtopError = class extends Error {
+  
+  constructor(issues) {
+    const errorMessage = issues.map((issue) => issue.message).join("\n");
+    super(errorMessage);
+    this.issues = issues;
+  }
+};
+
 // src/window/AirtopWindowClient.ts
 
 
 // src/async-utils.ts
 
 var DEFAULT_TIMEOUT_SECONDS = 300;
-var DEFAULT_POLLING_INTERVAL_SECONDS = 2;
+var DEFAULT_POLLING_INTERVAL_MS = 500;
 async function waitForRequestCompletion(client, requestId, requestOptions) {
   const startTime = Date.now();
   const timeoutMs = _datefns.secondsToMilliseconds.call(void 0, _optionalChain([requestOptions, 'optionalAccess', _5 => _5.timeoutInSeconds]) || DEFAULT_TIMEOUT_SECONDS);
@@ -259,7 +292,7 @@ async function waitForRequestCompletion(client, requestId, requestOptions) {
     if (apiResponse.status === "error") {
       throw new Error(apiResponse.error);
     }
-    await new Promise((resolve) => setTimeout(resolve, _datefns.secondsToMilliseconds.call(void 0, DEFAULT_POLLING_INTERVAL_SECONDS)));
+    await new Promise((resolve) => setTimeout(resolve, DEFAULT_POLLING_INTERVAL_MS));
   }
   throw new Error("Waiting for request timed out");
 }
@@ -482,6 +515,11 @@ var AirtopWindowClient = class extends AirtopBase {
       },
       this.resolveRequestOptions(requestOptions)
     );
+    this._sendAgentPayload("LiveViewUrl", {
+      liveViewUrl: results.data.liveViewUrl,
+      windowId: this.windowId,
+      sessionId: this.sessionId
+    });
     return new AirtopWindow(this.getCommonConfig(), this.sessionId, results);
   }
   /**
@@ -783,7 +821,7 @@ var AirtopWindowClient = class extends AirtopBase {
       )
     );
   }
-  async findOne(prompt, config, requestOptions = {}) {
+  async findOnePrivate(prompt, config, requestOptions = {}) {
     this.log.withMetadata({ prompt }).info("Executing LLM call");
     const apiResponse = await withRequestCompletionPolling(
       this.client,
@@ -801,15 +839,32 @@ var AirtopWindowClient = class extends AirtopBase {
         }
       )
     );
+    if (apiResponse.errors.length > 0) {
+      throw new AirtopError(apiResponse.errors);
+    }
     try {
+      if (!apiResponse.data.modelResponse) {
+        return null;
+      }
       const nodeData = JSON.parse(apiResponse.data.modelResponse);
+      if (Object.keys(nodeData).length === 0) {
+        return null;
+      }
       return new AirtopNode(this, nodeData);
     } catch (error) {
       this.log.withMetadata({ nodeDataStr: apiResponse.data.modelResponse }).withError(error).error("Error parsing node data");
       throw error;
     }
   }
-  async findMany(prompt, config, requestOptions = {}) {
+  async findOne(prompt, config, requestOptions = {}) {
+    const configOverride = { ...config, optional: false };
+    return await this.findOnePrivate(prompt, configOverride, requestOptions);
+  }
+  async findOneOptional(prompt, config, requestOptions = {}) {
+    const configOverride = { ...config, optional: true };
+    return await this.findOnePrivate(prompt, configOverride, requestOptions);
+  }
+  async findManyPrivate(prompt, config, requestOptions = {}) {
     this.log.withMetadata({ prompt }).info("Executing LLM call");
     const apiResponse = await withRequestCompletionPolling(
       this.client,
@@ -827,15 +882,32 @@ var AirtopWindowClient = class extends AirtopBase {
         }
       )
     );
+    if (apiResponse.errors.length > 0) {
+      throw new AirtopError(apiResponse.errors);
+    }
     const nodeHandles = apiResponse.data.modelResponse.split("___DELIM___");
     return nodeHandles.map((nodeDataStr) => {
       try {
+        if (!nodeDataStr) {
+          return null;
+        }
         const nodeData = JSON.parse(nodeDataStr);
+        if (Object.keys(nodeData).length === 0) {
+          return null;
+        }
         return new AirtopNode(this, nodeData);
       } catch (error) {
         this.log.withMetadata({ nodeDataStr }).withError(error).error("Error parsing node data");
       }
-    });
+    }).filter((node) => !!node);
+  }
+  async findMany(prompt, config, requestOptions = {}) {
+    const configOverride = { ...config, optional: false };
+    return await this.findManyPrivate(prompt, configOverride, requestOptions);
+  }
+  async findManyOptional(prompt, config, requestOptions = {}) {
+    const configOverride = { ...config, optional: true };
+    return await this.findManyPrivate(prompt, configOverride, requestOptions);
   }
   async waitForPage(config, requestOptions = {}) {
     return await withRequestCompletionPolling(
@@ -853,6 +925,23 @@ var AirtopWindowClient = class extends AirtopBase {
       )
     );
   }
+  async navigate(direction, config, requestOptions = {}) {
+    return await withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.navigate(
+        this.getWindowId(),
+        {
+          direction,
+          sessionId: this.sessionId,
+          ...config || {}
+        },
+        {
+          timeout: _datefns.secondsToMilliseconds.call(void 0, 600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+  }
 };
 
 // src/window/AirtopWindow.ts
@@ -1289,6 +1378,13 @@ var AirtopClient = class extends AirtopBase {
   }
 };
 
+// src/window/AirtopWindowClient.types.ts
+var WindowNavigateDirection = /* @__PURE__ */ ((WindowNavigateDirection2) => {
+  WindowNavigateDirection2["BACK"] = "backward";
+  WindowNavigateDirection2["FORWARD"] = "forward";
+  return WindowNavigateDirection2;
+})(WindowNavigateDirection || {});
+
 // src/plugin/AirtopPlugin.types.ts
 var AirtopPluginAugmentationType = /* @__PURE__ */ ((AirtopPluginAugmentationType2) => {
   AirtopPluginAugmentationType2["AirtopClient"] = "AirtopClient";
@@ -1428,5 +1524,7 @@ var AirtopMocks = class {
 
 
 
-exports.AirtopBase = AirtopBase; exports.AirtopClient = AirtopClient; exports.AirtopMocks = AirtopMocks; exports.AirtopNode = AirtopNode; exports.AirtopPluginAugmentationType = AirtopPluginAugmentationType; exports.AirtopSession = AirtopSession; exports.AirtopSessionClient = AirtopSessionClient; exports.AirtopWindow = AirtopWindow; exports.AirtopWindowClient = AirtopWindowClient; exports.AirtopWindowScreenshot = AirtopWindowScreenshot; exports.registerAirtopPlugin = registerAirtopPlugin;
+
+
+exports.AirtopBase = AirtopBase; exports.AirtopClient = AirtopClient; exports.AirtopError = AirtopError; exports.AirtopMocks = AirtopMocks; exports.AirtopNode = AirtopNode; exports.AirtopPluginAugmentationType = AirtopPluginAugmentationType; exports.AirtopSession = AirtopSession; exports.AirtopSessionClient = AirtopSessionClient; exports.AirtopWindow = AirtopWindow; exports.AirtopWindowClient = AirtopWindowClient; exports.AirtopWindowScreenshot = AirtopWindowScreenshot; exports.WindowNavigateDirection = WindowNavigateDirection; exports.registerAirtopPlugin = registerAirtopPlugin;
 //# sourceMappingURL=index.cjs.map