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

package/README.md

@@ -1 +1,21 @@
 # Airtop Typescript SDK
+
+## Installation
+
+```bash
+npm install @airtop/sdk
+```
+
+## Usage
+
+```typescript
+
+import { AirtopClient } from '@airtop/sdk';
+
+const client = new AirtopClient({
+  apiKey: 'airtop-api-key'
+});
+```
+
+- See [constructor options](https://docs-v2.airtop.ai/sdk/typescript/@airtop/sdk/interfaces/AirtopConstructorConfig/)
+- See [API documentation](https://docs-v2.airtop.ai/sdk/typescript/@airtop/sdk/classes/AirtopClient/)

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var __getOwnPropNames = Object.getOwnPropertyNames;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } function _optionalChainDelete(ops) { const result = _optionalChain(ops); return result == null ? true : result; }var __getOwnPropNames = Object.getOwnPropertyNames;
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
@@ -9,7 +9,7 @@ var require_package = __commonJS({
     module.exports = {
       name: "@airtop/sdk",
       description: "Airtop SDK for TypeScript",
-      version: "1.0.0-alpha2.0",
+      version: "1.0.0-alpha2.10",
       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.17",
+        "@airtop/core": "0.1.0-alpha.27",
         "date-fns": "4.1.0",
         loglayer: "6.3.3",
         "serialize-error": "12.0.0",
@@ -102,6 +102,11 @@ var AirtopBase = class {
    * @internal
    **/
   
+  /**
+   * The job id for the ongoing automation
+   * @internal
+   */
+  
   /**
    * Creates a new instance of AirtopBase
    * @param config - Configuration options for the SDK
@@ -110,6 +115,7 @@ var AirtopBase = class {
     this.log = config.log.withPrefix("[Airtop]");
     this.client = config.client;
     this.outputJsonAdapter = config.outputSchemaAdapter;
+    this.jobId = config.jobId;
   }
   /**
    * Returns the API key used by the SDK
@@ -163,7 +169,8 @@ var AirtopBase = class {
   getCommonConfig() {
     return {
       client: this.client,
-      log: this.log
+      log: this.log,
+      jobId: this.jobId
     };
   }
   /**
@@ -237,6 +244,117 @@ var processLogMessage = (log, logLevel, ...args) => {
 // src/window/AirtopWindowClient.ts
 
 
+// src/async-utils.ts
+
+var DEFAULT_TIMEOUT_SECONDS = 300;
+var DEFAULT_POLLING_INTERVAL_SECONDS = 2;
+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);
+  while (Date.now() - startTime < timeoutMs) {
+    const apiResponse = await client.requests.getRequestStatus(requestId, requestOptions);
+    if (apiResponse.status === "completed") {
+      return apiResponse.response;
+    }
+    if (apiResponse.status === "error") {
+      throw new Error(apiResponse.error);
+    }
+    await new Promise((resolve) => setTimeout(resolve, _datefns.secondsToMilliseconds.call(void 0, DEFAULT_POLLING_INTERVAL_SECONDS)));
+  }
+  throw new Error("Waiting for request timed out");
+}
+async function withRequestCompletionPolling(client, fn, requestOptions) {
+  const response = await fn();
+  return waitForRequestCompletion(client, response.requestId, requestOptions);
+}
+
+// src/window/AirtopNode.ts
+var AirtopNode = class {
+  /**
+   * The window client
+   */
+  
+  /**
+   * The node handle id to use for all requests
+   */
+  
+  /**
+   * The xpath selector of the node
+   */
+  
+  /**
+   * Constructor
+   * @param client - The window client
+   * @param nodeData - The node data to use for all requests
+   */
+  constructor(client, nodeData) {
+    this.windowClient = client;
+    this.nodeHandleId = nodeData.id;
+    this.selector = nodeData.xpath;
+  }
+  /**
+   * Extract content from the node
+   * @param prompt - The prompt to use for the extraction
+   * @param config - The configuration to use for the extraction
+   * @param requestOptions - The request options to use for the extraction
+   */
+  async extract(prompt, config, requestOptions = {}) {
+    const augmentedConfig = {
+      ...config,
+      nodeHandleId: this.nodeHandleId
+    };
+    return this.windowClient.extract(prompt, augmentedConfig, requestOptions);
+  }
+  /**
+   * Act on the node
+   * @param prompt - The prompt to use for the action
+   * @param config - The configuration to use for the action
+   * @param requestOptions - The request options to use for the action
+   */
+  async act(prompt, config, requestOptions = {}) {
+    const augmentedConfig = {
+      ...config,
+      nodeHandleId: this.nodeHandleId
+    };
+    return this.windowClient.act(prompt, augmentedConfig, requestOptions);
+  }
+  /**
+   * Execute an LLM call on the node
+   * @param prompt - The prompt to use for the LLM call
+   * @param config - The configuration to use for the LLM call
+   * @param requestOptions - The request options to use for the LLM call
+   */
+  async llm(prompt, config, requestOptions = {}) {
+    return this.windowClient.llm(prompt, config, 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 findOne(prompt, config, requestOptions = {}) {
+    const augmentedConfig = {
+      ...config,
+      nodeHandleId: this.nodeHandleId
+    };
+    return this.windowClient.findOne(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 findMany(prompt, config, requestOptions = {}) {
+    const augmentedConfig = {
+      ...config,
+      nodeHandleId: this.nodeHandleId
+    };
+    return this.windowClient.findMany(prompt, augmentedConfig, requestOptions);
+  }
+};
+
 // src/window/AirtopWindowScreenshot.ts
 function extractMimeAndBase64(dataUrl) {
   const match = dataUrl.match(/^data:(image\/\w+);base64,(.+)$/);
@@ -480,7 +598,7 @@ var AirtopWindowClient = class extends AirtopBase {
       prompt
     }).info("Performing a page query");
     const newConfig = config;
-    if (_optionalChain([config, 'optionalAccess', _5 => _5.configuration, 'access', _6 => _6.outputSchema])) {
+    if (_optionalChain([config, 'optionalAccess', _6 => _6.configuration, 'access', _7 => _7.outputSchema])) {
       newConfig.configuration.outputSchema = this.convertToJsonSchema(config.configuration.outputSchema);
     }
     return this.client.windows.pageQuery(
@@ -508,7 +626,7 @@ var AirtopWindowClient = class extends AirtopBase {
       prompt
     }).info("Performing a paginated extraction");
     const newConfig = config;
-    if (_optionalChain([config, 'optionalAccess', _7 => _7.configuration, 'access', _8 => _8.outputSchema])) {
+    if (_optionalChain([config, 'optionalAccess', _8 => _8.configuration, 'access', _9 => _9.outputSchema])) {
       newConfig.configuration.outputSchema = this.convertToJsonSchema(config.configuration.outputSchema);
     }
     return this.client.windows.paginatedExtraction(
@@ -609,6 +727,132 @@ var AirtopWindowClient = class extends AirtopBase {
       }
     );
   }
+  async extract(prompt, config, requestOptions = {}) {
+    this.log.withMetadata({ prompt }).info("Extracting content");
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.extract(
+        this.getWindowId(),
+        {
+          prompt,
+          sessionId: this.sessionId,
+          jobId: this.jobId,
+          ...config || {}
+        },
+        {
+          timeout: _datefns.secondsToMilliseconds.call(void 0, 600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+  }
+  async act(prompt, config, requestOptions = {}) {
+    this.log.withMetadata({ prompt }).info("Acting on content");
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.act(
+        this.getWindowId(),
+        {
+          prompt,
+          sessionId: this.sessionId,
+          jobId: this.jobId,
+          ...config || {}
+        },
+        {
+          timeout: _datefns.secondsToMilliseconds.call(void 0, 600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+  }
+  async llm(prompt, config, requestOptions = {}) {
+    this.log.withMetadata({ prompt }).info("Executing LLM call");
+    return withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.llm(
+        this.getWindowId(),
+        {
+          prompt,
+          sessionId: this.sessionId,
+          ...config || {}
+        },
+        {
+          timeout: _datefns.secondsToMilliseconds.call(void 0, 600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+  }
+  async findOne(prompt, config, requestOptions = {}) {
+    this.log.withMetadata({ prompt }).info("Executing LLM call");
+    const apiResponse = await withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.findOne(
+        this.getWindowId(),
+        {
+          prompt,
+          sessionId: this.sessionId,
+          jobId: this.jobId,
+          ...config || {}
+        },
+        {
+          timeout: _datefns.secondsToMilliseconds.call(void 0, 600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+    try {
+      const nodeData = JSON.parse(apiResponse.data.modelResponse);
+      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 = {}) {
+    this.log.withMetadata({ prompt }).info("Executing LLM call");
+    const apiResponse = await withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.findMany(
+        this.getWindowId(),
+        {
+          prompt,
+          sessionId: this.sessionId,
+          jobId: this.jobId,
+          ...config || {}
+        },
+        {
+          timeout: _datefns.secondsToMilliseconds.call(void 0, 600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+    const nodeHandles = apiResponse.data.modelResponse.split("___DELIM___");
+    return nodeHandles.map((nodeDataStr) => {
+      try {
+        const nodeData = JSON.parse(nodeDataStr);
+        return new AirtopNode(this, nodeData);
+      } catch (error) {
+        this.log.withMetadata({ nodeDataStr }).withError(error).error("Error parsing node data");
+      }
+    });
+  }
+  async waitForPage(config, requestOptions = {}) {
+    return await withRequestCompletionPolling(
+      this.client,
+      () => this.client.windows.waitForPage(
+        this.getWindowId(),
+        {
+          sessionId: this.sessionId,
+          ...config || {}
+        },
+        {
+          timeout: _datefns.secondsToMilliseconds.call(void 0, 600),
+          ...this.resolveRequestOptions(requestOptions)
+        }
+      )
+    );
+  }
 };
 
 // src/window/AirtopWindow.ts
@@ -782,7 +1026,7 @@ var AirtopSessionClient = class extends AirtopBase {
       {
         ...config,
         fileName,
-        sessionId: this.sessionId
+        sessionIds: [this.sessionId]
       },
       this.resolveRequestOptions(requestOptions)
     );
@@ -845,19 +1089,19 @@ var AirtopClient = class extends AirtopBase {
    */
   constructor(config) {
     super({
-      logLevel: _optionalChain([config, 'optionalAccess', _9 => _9.logLevel]),
+      logLevel: _optionalChain([config, 'optionalAccess', _10 => _10.logLevel]),
       client: new (0, _core.Airtop)({
         maxRetries: 0,
         timeout: _minutesToMilliseconds.minutesToMilliseconds.call(void 0, 1),
         apiKey: config.apiKey,
-        baseURL: _optionalChain([config, 'optionalAccess', _10 => _10.airtopUrl]),
-        logLevel: _optionalChain([config, 'optionalAccess', _11 => _11.logLevel]) || "off",
+        baseURL: _optionalChain([config, 'optionalAccess', _11 => _11.airtopUrl]),
+        logLevel: _optionalChain([config, 'optionalAccess', _12 => _12.logLevel]) || "off",
         defaultHeaders: {
           "x-airtop-sdk-source": "typescript",
           "x-airtop-sdk-version": version
         }
       }),
-      log: _optionalChain([config, 'optionalAccess', _12 => _12.logger]) || new (0, _loglayer.LogLayer)({
+      log: _optionalChain([config, 'optionalAccess', _13 => _13.logger]) || new (0, _loglayer.LogLayer)({
         errorSerializer: _serializeerror.serializeError,
         transport: new (0, _loglayer.ConsoleTransport)({
           logger: console,
@@ -868,7 +1112,8 @@ var AirtopClient = class extends AirtopBase {
         contextFieldName: "context",
         metadataFieldName: "metadata"
       }),
-      outputSchemaAdapter: config.outputSchemaAdapter
+      outputSchemaAdapter: config.outputSchemaAdapter,
+      jobId: config.jobId
     });
     this.log.withPrefix("[Airtop SDK]");
     this.client.logLevel = config.logLevel;
@@ -894,8 +1139,8 @@ var AirtopClient = class extends AirtopBase {
    * @returns A new AirtopSession instance
    */
   async createSession(config, options = {}) {
-    const skipWaitSessionReady = _nullishCoalesce(config.skipWaitSessionReady, () => ( false));
-    delete config.skipWaitSessionReady;
+    const skipWaitSessionReady = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _14 => _14.skipWaitSessionReady]), () => ( false));
+     _optionalChainDelete([config, 'optionalAccess', _15 => delete _15.skipWaitSessionReady]);
     const sessionResponse = await this.client.sessions.create(
       {
         configuration: config
@@ -1003,23 +1248,6 @@ var AirtopClient = class extends AirtopBase {
   async getFile(fileId, requestOptions = {}) {
     return this.client.files.get(fileId, this.resolveRequestOptions(requestOptions));
   }
-  /**
-   * Lists files filtered by session IDs.
-   * @param sessionIds - Array of session IDs to retrieve files for
-   * @param config - Configuration options for the request
-   * @param requestOptions - Request options
-   * @returns Object containing pagination info and array of AirtopSession instances
-   */
-  async listFiles(sessionIds, config, requestOptions = {}) {
-    return this.client.files.list(
-      {
-        sessionIds,
-        limit: config.limit,
-        offset: config.offset
-      },
-      this.resolveRequestOptions(requestOptions)
-    );
-  }
   /**
    * Removes a file by ID.
    * @param fileId - ID of the file to remove
@@ -1028,6 +1256,14 @@ var AirtopClient = class extends AirtopBase {
   async removeFile(fileId, requestOptions = {}) {
     return this.client.files.delete(fileId, this.resolveRequestOptions(requestOptions));
   }
+  /**
+   * List files
+   * @param query
+   * @param requestOptions
+   */
+  async listFiles(query, requestOptions = {}) {
+    return this.client.files.list(query, this.resolveRequestOptions(requestOptions));
+  }
   /**
    * List all automations
    * @param requestOptions - Request options
@@ -1191,5 +1427,6 @@ var AirtopMocks = class {
 
 
 
-exports.AirtopBase = AirtopBase; exports.AirtopClient = AirtopClient; exports.AirtopMocks = AirtopMocks; 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.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;
 //# sourceMappingURL=index.cjs.map