donobu 1.0.0

package/dist/esm/tools/GoForwardOrBackTool.d.ts

@@ -0,0 +1,22 @@
+import { Tool } from './Tool';
+import { ToolCallContext } from '../models/ToolCallContext';
+import { ToolCallResult } from '../models/ToolCallResult';
+import { BaseToolGptParameters } from '../models/BaseToolGptParameters';
+export declare enum Direction {
+    FORWARD = "FORWARD",
+    BACK = "BACK"
+}
+export interface GoForwardOrBackToolCoreParameters {
+    /**
+     * The direction to navigate - either FORWARD or BACK
+     */
+    direction: Direction;
+}
+export interface GoForwardOrBackToolGptParameters extends BaseToolGptParameters, GoForwardOrBackToolCoreParameters {
+}
+export declare class GoForwardOrBackTool extends Tool<GoForwardOrBackToolCoreParameters, GoForwardOrBackToolGptParameters> {
+    static readonly NAME = "goForwardOrBack";
+    constructor();
+    call(context: ToolCallContext, parameters: GoForwardOrBackToolCoreParameters): Promise<ToolCallResult>;
+    callFromGpt(context: ToolCallContext, parameters: GoForwardOrBackToolGptParameters): Promise<ToolCallResult>;
+}

package/dist/esm/tools/GoForwardOrBackTool.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoForwardOrBackTool = exports.Direction = void 0;
+const Tool_1 = require("./Tool");
+const ToolCallResult_1 = require("../models/ToolCallResult");
+const PlaywrightUtils_1 = require("../utils/PlaywrightUtils");
+var Direction;
+(function (Direction) {
+    Direction["FORWARD"] = "FORWARD";
+    Direction["BACK"] = "BACK";
+})(Direction || (exports.Direction = Direction = {}));
+class GoForwardOrBackTool extends Tool_1.Tool {
+    static NAME = 'goForwardOrBack';
+    constructor() {
+        super(GoForwardOrBackTool.NAME, 'Navigate forward or back in the webpage history.', 'GoForwardOrBackToolCoreParameters', 'GoForwardOrBackToolGptParameters');
+    }
+    async call(context, parameters) {
+        const page = context.page;
+        switch (parameters.direction) {
+            case Direction.FORWARD: {
+                await page.goForward();
+                break;
+            }
+            case Direction.BACK: {
+                await page.goBack();
+                break;
+            }
+        }
+        await PlaywrightUtils_1.PlaywrightUtils.waitForPageStability(page);
+        return ToolCallResult_1.ToolCallResult.successful();
+    }
+    async callFromGpt(context, parameters) {
+        return this.call(context, parameters);
+    }
+}
+exports.GoForwardOrBackTool = GoForwardOrBackTool;
+//# sourceMappingURL=GoForwardOrBackTool.js.map

package/dist/esm/tools/GoForwardOrBackTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoForwardOrBackTool.js","sourceRoot":"","sources":["../../../src/tools/GoForwardOrBackTool.ts"],"names":[],"mappings":";;;AAAA,iCAA8B;AAE9B,6DAA0D;AAE1D,8DAA2D;AAE3D,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAYD,MAAa,mBAAoB,SAAQ,WAGxC;IACQ,MAAM,CAAU,IAAI,GAAG,iBAAiB,CAAC;IAEhD;QACE,KAAK,CACH,mBAAmB,CAAC,IAAI,EACxB,kDAAkD,EAClD,mCAAmC,EACnC,kCAAkC,CACnC,CAAC;IACJ,CAAC;IAEe,KAAK,CAAC,IAAI,CACxB,OAAwB,EACxB,UAA6C;QAE7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAE1B,QAAQ,UAAU,CAAC,SAAS,EAAE,CAAC;YAC7B,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;gBACvB,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;gBACvB,MAAM;YACR,CAAC;YACD,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;gBACpB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,iCAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,+BAAc,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IAEe,KAAK,CAAC,WAAW,CAC/B,OAAwB,EACxB,UAA4C;QAE5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;;AAzCH,kDA0CC"}

package/dist/esm/tools/GoToGoogleMapsStreetViewTool.d.ts

@@ -0,0 +1,37 @@
+import { Tool } from './Tool';
+import { ToolCallContext } from '../models/ToolCallContext';
+import { ToolCallResult } from '../models/ToolCallResult';
+import { BaseToolGptParameters } from '../models/BaseToolGptParameters';
+/**
+ * Parameters for the GoToGoogleMapsStreetViewTool
+ */
+export interface GoToGoogleMapsStreetViewToolCoreParameters {
+    /**
+     * The name of the business/entity to find.
+     */
+    entityName: string;
+    /**
+     * The address of the business/entity to find.
+     */
+    entityLocation: string;
+}
+export interface GoToGoogleMapsStreetViewToolGptParameters extends BaseToolGptParameters, GoToGoogleMapsStreetViewToolCoreParameters {
+}
+/**
+ * Attempts to verify that the given business/entity exists at the given location by using a Google
+ * Maps street view. If the business/entity is found, then a AggregateExtractedStreetviewDataTool
+ * tool call is queued containing the results.
+ */
+export declare class GoToGoogleMapsStreetViewTool extends Tool<GoToGoogleMapsStreetViewToolCoreParameters, GoToGoogleMapsStreetViewToolGptParameters> {
+    static readonly NAME = "goToGoogleMapsStreetView";
+    constructor();
+    call(context: ToolCallContext, parameters: GoToGoogleMapsStreetViewToolCoreParameters): Promise<ToolCallResult>;
+    callFromGpt(context: ToolCallContext, parameters: GoToGoogleMapsStreetViewToolGptParameters): Promise<ToolCallResult>;
+    private setStreetView;
+    private setStreetViewUsingQuery;
+    /**
+     * Remove UI elements that can distract the GPT when performing an analysis. This is a fragile
+     * script and will break depending on the device used and on the whims of Google.
+     */
+    private cleanupUiElements;
+}

package/dist/esm/tools/GoToGoogleMapsStreetViewTool.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoToGoogleMapsStreetViewTool = void 0;
+const Tool_1 = require("./Tool");
+const ToolCallResult_1 = require("../models/ToolCallResult");
+const AggregateExtractedStreetviewDataTool_1 = require("./AggregateExtractedStreetviewDataTool");
+const PlaywrightUtils_1 = require("../utils/PlaywrightUtils");
+const MiscUtils_1 = require("../utils/MiscUtils");
+/**
+ * Attempts to verify that the given business/entity exists at the given location by using a Google
+ * Maps street view. If the business/entity is found, then a AggregateExtractedStreetviewDataTool
+ * tool call is queued containing the results.
+ */
+class GoToGoogleMapsStreetViewTool extends Tool_1.Tool {
+    static NAME = 'goToGoogleMapsStreetView';
+    constructor() {
+        super(GoToGoogleMapsStreetViewTool.NAME, 'Go to the Google Maps street view of a given business/entity by name and location.', 'GoToGoogleMapsStreetViewToolCoreParameters', 'GoToGoogleMapsStreetViewToolGptParameters');
+    }
+    async call(context, parameters) {
+        const page = context.page;
+        const entityName = parameters.entityName.trim();
+        const entityLocation = parameters.entityLocation.trim();
+        if (!(await this.setStreetView(entityName, entityLocation, page))) {
+            context.proposedToolCalls.length = 0;
+            context.proposedToolCalls.push({
+                name: AggregateExtractedStreetviewDataTool_1.AggregateExtractedStreetviewDataTool.NAME,
+                parameters: {},
+            });
+            return {
+                isSuccessful: false,
+                forLlm: 'Unable to set the street-view mode for Google Maps!',
+                metadata: null,
+            };
+        }
+        else {
+            await PlaywrightUtils_1.PlaywrightUtils.waitForPageStability(page);
+            return ToolCallResult_1.ToolCallResult.successful();
+        }
+    }
+    callFromGpt(context, parameters) {
+        return this.call(context, parameters);
+    }
+    async setStreetView(entityName, entityLocation, page) {
+        const googleMapsCombinedQuery = `${entityName} ${entityLocation}`.trim();
+        // TODO: Try using the peg-man if these calls fail.
+        return ((await this.setStreetViewUsingQuery(googleMapsCombinedQuery, page)) ||
+            (await this.setStreetViewUsingQuery(entityLocation, page)));
+    }
+    async setStreetViewUsingQuery(googleMapsQuery, page) {
+        const encodedQuery = encodeURIComponent(googleMapsQuery);
+        const googleMapsUrl = 'https://www.google.com/maps/search/?api=1&map_action=pano&query=' +
+            encodedQuery;
+        await page.goto(googleMapsUrl);
+        await page.waitForLoadState();
+        await page.waitForTimeout(2559);
+        const streetViewButton = await page.$('button[aria-label="Street View"]');
+        if (streetViewButton) {
+            await streetViewButton.click({
+                delay: MiscUtils_1.MiscUtils.generateHumanLikeClickDurationInMs(),
+            });
+            await page.waitForLoadState();
+            await page.waitForTimeout(2559);
+            // Modify the URL to change the zoom level from 75 yards to 60 yards
+            const modifiedUrl = page.url().replace('75y', '60y');
+            await page.goto(modifiedUrl);
+            await page.waitForLoadState();
+            await page.waitForTimeout(2559);
+            await this.cleanupUiElements(page);
+            await page.waitForTimeout(2559);
+            return true;
+        }
+        else {
+            return false;
+        }
+    }
+    /**
+     * Remove UI elements that can distract the GPT when performing an analysis. This is a fragile
+     * script and will break depending on the device used and on the whims of Google.
+     */
+    async cleanupUiElements(page) {
+        await page.evaluate(() => () => {
+            const removeElement = (element) => {
+                if (element) {
+                    element.remove();
+                }
+            };
+            // This is the search box.
+            removeElement(document.querySelector('#omnibox-singlebox'));
+            // This is miscellaneous footer data.
+            removeElement(document.querySelector('.id-fineprint'));
+            // This is a display card overlay.
+            removeElement(document.querySelector('#titlecard'));
+            // This is the picture-in-picture box.
+            removeElement(Array.from(document.querySelectorAll('div[style]')).find((el) => el.style.marginBottom === '20px'));
+            // Collapse the side panel.
+            let isSidePanelCollapsed = false;
+            // Step 1: Select the button element using the aria-label and jsaction attributes
+            const buttonElement = document.querySelector('button[aria-label="Collapse side panel"][jsaction*="drawer.close"]');
+            // Check if the button element is selected
+            if (buttonElement) {
+                // Step 2: Find the img element within the button
+                const imgElement = buttonElement.querySelector('img');
+                // Check if the img element is found within the button
+                if (imgElement) {
+                    // Step 3: Click!
+                    imgElement.click();
+                    isSidePanelCollapsed = true;
+                }
+            }
+            if (!isSidePanelCollapsed) {
+                // Hack it.
+                removeElement(Array.from(document.querySelectorAll('div[style]')).find((el) => el.style.width === '480px'));
+            }
+        });
+        await page.waitForLoadState();
+    }
+}
+exports.GoToGoogleMapsStreetViewTool = GoToGoogleMapsStreetViewTool;
+//# sourceMappingURL=GoToGoogleMapsStreetViewTool.js.map

package/dist/esm/tools/GoToGoogleMapsStreetViewTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoToGoogleMapsStreetViewTool.js","sourceRoot":"","sources":["../../../src/tools/GoToGoogleMapsStreetViewTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/tools/GoToWebpageTool.d.ts

@@ -0,0 +1,20 @@
+import { Tool } from './Tool';
+import { ToolCallContext } from '../models/ToolCallContext';
+import { ToolCallResult } from '../models/ToolCallResult';
+import { BaseToolGptParameters } from '../models/BaseToolGptParameters';
+export interface GoToWebpageToolCoreParameters {
+    /**
+     * The URL to navigate to. Must use the http, https, or file protocol (example is https://google.com).
+     */
+    url: string;
+}
+export interface GoToWebpageToolGptParameters extends BaseToolGptParameters, GoToWebpageToolCoreParameters {
+}
+/** Directly navigate to the specified URL. */
+export declare class GoToWebpageTool extends Tool<GoToWebpageToolCoreParameters, GoToWebpageToolGptParameters> {
+    static readonly NAME = "goToWebpage";
+    private static readonly VALID_PROTOCOLS;
+    constructor();
+    call(context: ToolCallContext, parameters: GoToWebpageToolCoreParameters): Promise<ToolCallResult>;
+    callFromGpt(context: ToolCallContext, parameters: GoToWebpageToolGptParameters): Promise<ToolCallResult>;
+}

package/dist/esm/tools/GoToWebpageTool.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoToWebpageTool = void 0;
+const Tool_1 = require("./Tool");
+const PlaywrightUtils_1 = require("../utils/PlaywrightUtils");
+/** Directly navigate to the specified URL. */
+class GoToWebpageTool extends Tool_1.Tool {
+    static NAME = 'goToWebpage';
+    static VALID_PROTOCOLS = ['https://', 'http://', 'file://'];
+    constructor() {
+        super(GoToWebpageTool.NAME, 'Go directly to the specified URL.', 'GoToWebpageToolCoreParameters', 'GoToWebpageToolGptParameters');
+    }
+    async call(context, parameters) {
+        const page = context.page;
+        const url = parameters.url.trim();
+        if (GoToWebpageTool.VALID_PROTOCOLS.some((protocol) => url.startsWith(protocol))) {
+            await page.goto(url, {
+                waitUntil: 'domcontentloaded',
+            });
+            await PlaywrightUtils_1.PlaywrightUtils.waitForPageStability(page);
+            return {
+                isSuccessful: true,
+                forLlm: `Successfully navigated to ${url}`,
+                metadata: null,
+            };
+        }
+        else {
+            return {
+                isSuccessful: false,
+                forLlm: `Will not navigate a URL not using the following prefixes: ${GoToWebpageTool.VALID_PROTOCOLS}`,
+                metadata: null,
+            };
+        }
+    }
+    async callFromGpt(context, parameters) {
+        return this.call(context, parameters);
+    }
+}
+exports.GoToWebpageTool = GoToWebpageTool;
+//# sourceMappingURL=GoToWebpageTool.js.map

package/dist/esm/tools/GoToWebpageTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoToWebpageTool.js","sourceRoot":"","sources":["../../../src/tools/GoToWebpageTool.ts"],"names":[],"mappings":";;;AAAA,iCAA8B;AAI9B,8DAA2D;AAY3D,8CAA8C;AAC9C,MAAa,eAAgB,SAAQ,WAGpC;IACQ,MAAM,CAAU,IAAI,GAAG,aAAa,CAAC;IAEpC,MAAM,CAAU,eAAe,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAE7E;QACE,KAAK,CACH,eAAe,CAAC,IAAI,EACpB,mCAAmC,EACnC,+BAA+B,EAC/B,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAEe,KAAK,CAAC,IAAI,CACxB,OAAwB,EACxB,UAAyC;QAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAElC,IACE,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAChD,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CACzB,EACD,CAAC;YACD,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACnB,SAAS,EAAE,kBAAkB;aAC9B,CAAC,CAAC;YACH,MAAM,iCAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACjD,OAAO;gBACL,YAAY,EAAE,IAAI;gBAClB,MAAM,EAAE,6BAA6B,GAAG,EAAE;gBAC1C,QAAQ,EAAE,IAAI;aACf,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,YAAY,EAAE,KAAK;gBACnB,MAAM,EAAE,6DAA6D,eAAe,CAAC,eAAe,EAAE;gBACtG,QAAQ,EAAE,IAAI;aACf,CAAC;QACJ,CAAC;IACH,CAAC;IAEe,KAAK,CAAC,WAAW,CAC/B,OAAwB,EACxB,UAAwC;QAExC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;;AApDH,0CAqDC"}

package/dist/esm/tools/HandleBrowserDialogTool.d.ts

@@ -0,0 +1,26 @@
+import { BaseToolGptParameters } from '../models/BaseToolGptParameters';
+import { ToolCallContext } from '../models/ToolCallContext';
+import { ToolCallResult } from '../models/ToolCallResult';
+import { Tool } from './Tool';
+/**
+ * The parameters for handling browser dialogs
+ */
+export interface HandleBrowserDialogToolCoreParameters {
+    /**
+     * If this is a "confirm" dialog, a string of "true" will accept the dialog and a string of "false" will dismiss it.
+     * However, if this is a "prompt" dialog, any non-null string will accept it, and a null value will dismiss it.
+     */
+    text?: string;
+}
+export interface HandleBrowserDialogToolGptParameters extends BaseToolGptParameters, HandleBrowserDialogToolCoreParameters {
+}
+/**
+ * A no-op tool that exists just to record the decisioning around browser alert
+ * dialogs/confirmations. See DonobuFlow#onDialog for details.
+ */
+export declare class HandleBrowserDialogTool extends Tool<HandleBrowserDialogToolCoreParameters, HandleBrowserDialogToolGptParameters> {
+    static readonly NAME = "handleBrowserDialog";
+    constructor();
+    call(context: ToolCallContext, parameters: HandleBrowserDialogToolCoreParameters): Promise<ToolCallResult>;
+    callFromGpt(context: ToolCallContext, parameters: HandleBrowserDialogToolGptParameters): Promise<ToolCallResult>;
+}

package/dist/esm/tools/HandleBrowserDialogTool.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandleBrowserDialogTool = void 0;
+const Tool_1 = require("./Tool");
+/**
+ * A no-op tool that exists just to record the decisioning around browser alert
+ * dialogs/confirmations. See DonobuFlow#onDialog for details.
+ */
+class HandleBrowserDialogTool extends Tool_1.Tool {
+    static NAME = 'handleBrowserDialog';
+    constructor() {
+        super(HandleBrowserDialogTool.NAME, 'Handle a browser Window:confirm() or Window:prompt().', 'HandleBrowserDialogToolCoreParameters', 'HandleBrowserDialogToolGptParameters');
+    }
+    async call(context, parameters) {
+        return this.call(context, parameters);
+    }
+    async callFromGpt(context, parameters) {
+        return this.call(context, parameters);
+    }
+}
+exports.HandleBrowserDialogTool = HandleBrowserDialogTool;
+//# sourceMappingURL=HandleBrowserDialogTool.js.map

package/dist/esm/tools/HandleBrowserDialogTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandleBrowserDialogTool.js","sourceRoot":"","sources":["../../../src/tools/HandleBrowserDialogTool.ts"],"names":[],"mappings":";;;AAGA,iCAA8B;AAgB9B;;;GAGG;AACH,MAAa,uBAAwB,SAAQ,WAG5C;IACQ,MAAM,CAAU,IAAI,GAAG,qBAAqB,CAAC;IAEpD;QACE,KAAK,CACH,uBAAuB,CAAC,IAAI,EAC5B,uDAAuD,EACvD,uCAAuC,EACvC,sCAAsC,CACvC,CAAC;IACJ,CAAC;IAEe,KAAK,CAAC,IAAI,CACxB,OAAwB,EACxB,UAAiD;QAEjD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAEe,KAAK,CAAC,WAAW,CAC/B,OAAwB,EACxB,UAAgD;QAEhD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;;AA3BH,0DA4BC"}

package/dist/esm/tools/HoverOverElementTool.d.ts

@@ -0,0 +1,15 @@
+import { ToolCallContext } from '../models/ToolCallContext';
+import { Locator } from 'playwright';
+import { ReplayableInteraction, AnnotationBasedParameters, SelectorBasedParameters } from './ReplayableInteraction';
+export interface HoverOverElementToolCoreParameters {
+}
+export interface SelectorBasedHoverOverElementToolParameters extends SelectorBasedParameters, HoverOverElementToolCoreParameters {
+}
+export interface AnnotationBasedHoverOverElementToolParameters extends AnnotationBasedParameters, HoverOverElementToolCoreParameters {
+}
+export declare class HoverOverElementTool extends ReplayableInteraction<HoverOverElementToolCoreParameters, SelectorBasedHoverOverElementToolParameters, AnnotationBasedHoverOverElementToolParameters> {
+    static readonly NAME = "hoverOverElement";
+    static readonly HOVER_DURATION_MS = 1000;
+    constructor();
+    invoke(context: ToolCallContext, _parameters: HoverOverElementToolCoreParameters, element: Locator): Promise<string>;
+}

package/dist/esm/tools/HoverOverElementTool.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HoverOverElementTool = void 0;
+const ReplayableInteraction_1 = require("./ReplayableInteraction");
+class HoverOverElementTool extends ReplayableInteraction_1.ReplayableInteraction {
+    static NAME = 'hoverOverElement';
+    static HOVER_DURATION_MS = 1000;
+    constructor() {
+        super(HoverOverElementTool.NAME, 'Hover the mouse over a specified element on a webpage.', 'SelectorBasedHoverOverElementToolParameters', 'AnnotationBasedHoverOverElementToolParameters');
+    }
+    async invoke(context, _parameters, element) {
+        await element.hover({ timeout: 3000 });
+        await context.page.waitForTimeout(HoverOverElementTool.HOVER_DURATION_MS);
+        return 'Hovered over element.';
+    }
+}
+exports.HoverOverElementTool = HoverOverElementTool;
+//# sourceMappingURL=HoverOverElementTool.js.map

package/dist/esm/tools/HoverOverElementTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HoverOverElementTool.js","sourceRoot":"","sources":["../../../src/tools/HoverOverElementTool.ts"],"names":[],"mappings":";;;AAEA,mEAIiC;AAUjC,MAAa,oBAAqB,SAAQ,6CAIzC;IACQ,MAAM,CAAU,IAAI,GAAG,kBAAkB,CAAC;IAC1C,MAAM,CAAU,iBAAiB,GAAG,IAAI,CAAC;IAEhD;QACE,KAAK,CACH,oBAAoB,CAAC,IAAI,EACzB,wDAAwD,EACxD,6CAA6C,EAC7C,+CAA+C,CAChD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAwB,EACxB,WAA+C,EAC/C,OAAgB;QAEhB,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QAC1E,OAAO,uBAAuB,CAAC;IACjC,CAAC;;AAzBH,oDA0BC"}

package/dist/esm/tools/InputRandomizedEmailAddressTool.d.ts

@@ -0,0 +1,27 @@
+import { Locator } from 'playwright';
+import { ToolCallContext } from '../models/ToolCallContext';
+import { ReplayableInteraction, AnnotationBasedParameters, SelectorBasedParameters } from './ReplayableInteraction';
+export interface InputRandomizedEmailAddressToolCoreParameters {
+    /**
+     * The base email to create a derived email from.
+     */
+    baseEmail: string;
+    /**
+     * Attempt to submit the data after inputting the randomized email (i.e. hitting 'Enter' at the end).
+     */
+    finalizeWithSubmit: boolean;
+}
+export interface SelectorBasedInputRandomizedEmailAddressToolParameters extends SelectorBasedParameters, InputRandomizedEmailAddressToolCoreParameters {
+}
+export interface AnnotationBasedInputRandomizedEmailAddressToolParameters extends AnnotationBasedParameters, InputRandomizedEmailAddressToolCoreParameters {
+}
+export declare class InputRandomizedEmailAddressTool extends ReplayableInteraction<InputRandomizedEmailAddressToolCoreParameters, SelectorBasedInputRandomizedEmailAddressToolParameters, AnnotationBasedInputRandomizedEmailAddressToolParameters> {
+    static readonly NAME = "inputRandomizedEmailAddress";
+    private static readonly CHARACTERS;
+    private static readonly RANDOM_STRING_LENGTH;
+    constructor();
+    invoke(_context: ToolCallContext, parameters: InputRandomizedEmailAddressToolCoreParameters, element: Locator): Promise<string>;
+    private randomizeEmail;
+    private generateRandomString;
+    private clearField;
+}

package/dist/esm/tools/InputRandomizedEmailAddressTool.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputRandomizedEmailAddressTool = void 0;
+const crypto_1 = require("crypto");
+const ReplayableInteraction_1 = require("./ReplayableInteraction");
+const MiscUtils_1 = require("../utils/MiscUtils");
+class InputRandomizedEmailAddressTool extends ReplayableInteraction_1.ReplayableInteraction {
+    static NAME = 'inputRandomizedEmailAddress';
+    static CHARACTERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    static RANDOM_STRING_LENGTH = 10;
+    constructor() {
+        super(InputRandomizedEmailAddressTool.NAME, `Create a new randomized email address based on a given email and inputs it to a specific input text field.
+For example if passed "foo@gmail.com", this tool will create "foo+SOMETHING_RANDOM@gmail.com", where
+SOMETHING_RANDOM is a random string of characters safe for use in an email address, and input it in the
+specified text field.`, 'SelectorBasedInputRandomizedEmailAddressToolParameters', 'AnnotationBasedInputRandomizedEmailAddressToolParameters');
+    }
+    async invoke(_context, parameters, element) {
+        const randomizedEmail = this.randomizeEmail(parameters.baseEmail);
+        // Clear any existing text first.
+        await this.clearField(element);
+        for (const char of randomizedEmail) {
+            await element.press(char, {
+                delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
+                timeout: 3000,
+            });
+        }
+        if (parameters.finalizeWithSubmit) {
+            const char = 'Enter';
+            await element.press(char, {
+                delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
+                timeout: 3000,
+            });
+        }
+        return `Inputted email: ${randomizedEmail}`;
+    }
+    randomizeEmail(baseEmail) {
+        const atIndex = baseEmail.indexOf('@');
+        if (atIndex === -1) {
+            throw new Error(`Invalid email address: ${baseEmail}`);
+        }
+        const localPart = baseEmail.substring(0, atIndex);
+        const domainPart = baseEmail.substring(atIndex);
+        const randomString = this.generateRandomString(InputRandomizedEmailAddressTool.RANDOM_STRING_LENGTH);
+        return `${localPart}+${randomString}${domainPart}`;
+    }
+    generateRandomString(length) {
+        const result = [];
+        const charactersLength = InputRandomizedEmailAddressTool.CHARACTERS.length;
+        for (let i = 0; i < length; i++) {
+            const randomIndex = (0, crypto_1.randomBytes)(1)[0] % charactersLength;
+            result.push(InputRandomizedEmailAddressTool.CHARACTERS[randomIndex]);
+        }
+        return result.join('');
+    }
+    async clearField(element) {
+        try {
+            const value = await element.inputValue();
+            if (value !== '') {
+                await element.selectText({ timeout: 3000 });
+                const char = 'Backspace';
+                await element.press(char, {
+                    delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
+                    timeout: 3000,
+                });
+            }
+        }
+        catch (_e) {
+            // This can happen if the element is not a text element, but still accepts text inputs.
+            // Pass.
+        }
+    }
+}
+exports.InputRandomizedEmailAddressTool = InputRandomizedEmailAddressTool;
+//# sourceMappingURL=InputRandomizedEmailAddressTool.js.map

package/dist/esm/tools/InputRandomizedEmailAddressTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputRandomizedEmailAddressTool.js","sourceRoot":"","sources":["../../../src/tools/InputRandomizedEmailAddressTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/tools/InputTextTool.d.ts

@@ -0,0 +1,24 @@
+import { Locator } from 'playwright';
+import { ToolCallContext } from '../models/ToolCallContext';
+import { ReplayableInteraction, AnnotationBasedParameters, SelectorBasedParameters } from './ReplayableInteraction';
+export interface InputTextToolCoreParameters {
+    /**
+     * The text to input.
+     */
+    text: string;
+    /**
+     * Attempt to submit the data after inputting the text (i.e. hitting 'Enter' at the end).
+     * This can be useful if doing something like using a webpage's search box, etc.
+     */
+    finalizeWithSubmit: boolean;
+}
+export interface SelectorBasedInputTextToolParameters extends SelectorBasedParameters, InputTextToolCoreParameters {
+}
+export interface AnnotationBasedInputTextToolParameters extends AnnotationBasedParameters, InputTextToolCoreParameters {
+}
+export declare class InputTextTool extends ReplayableInteraction<InputTextToolCoreParameters, SelectorBasedInputTextToolParameters, AnnotationBasedInputTextToolParameters> {
+    static readonly NAME = "inputText";
+    constructor();
+    invoke(_context: ToolCallContext, parameters: InputTextToolCoreParameters, element: Locator): Promise<string>;
+    private clearField;
+}

package/dist/esm/tools/InputTextTool.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputTextTool = void 0;
+const ReplayableInteraction_1 = require("./ReplayableInteraction");
+const MiscUtils_1 = require("../utils/MiscUtils");
+class InputTextTool extends ReplayableInteraction_1.ReplayableInteraction {
+    static NAME = 'inputText';
+    constructor() {
+        super(InputTextTool.NAME, "Input text to a webpage's text input box.", 'SelectorBasedInputTextToolParameters', 'AnnotationBasedInputTextToolParameters');
+    }
+    async invoke(_context, parameters, element) {
+        // Clear any existing text first.
+        await this.clearField(element);
+        for (const char of parameters.text) {
+            await element.press(char, {
+                delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
+                timeout: 3000,
+            });
+        }
+        if (parameters.finalizeWithSubmit) {
+            const char = 'Enter';
+            await element.press(char, {
+                delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
+                timeout: 3000,
+            });
+        }
+        return 'Inputted text into the element.';
+    }
+    async clearField(element) {
+        try {
+            const value = await element.inputValue();
+            if (value !== '') {
+                await element.selectText({ timeout: 3000 });
+                const char = 'Backspace';
+                await element.press(char, {
+                    delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
+                    timeout: 3000,
+                });
+            }
+        }
+        catch (_e) {
+            // This can happen if the element is not a text element, but still accepts text inputs.
+            // Pass.
+        }
+    }
+}
+exports.InputTextTool = InputTextTool;
+//# sourceMappingURL=InputTextTool.js.map

package/dist/esm/tools/InputTextTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputTextTool.js","sourceRoot":"","sources":["../../../src/tools/InputTextTool.ts"],"names":[],"mappings":";;;AAEA,mEAIiC;AACjC,kDAA+C;AAqB/C,MAAa,aAAc,SAAQ,6CAIlC;IACQ,MAAM,CAAU,IAAI,GAAG,WAAW,CAAC;IAE1C;QACE,KAAK,CACH,aAAa,CAAC,IAAI,EAClB,2CAA2C,EAC3C,sCAAsC,EACtC,wCAAwC,CACzC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAAyB,EACzB,UAAuC,EACvC,OAAgB;QAEhB,iCAAiC;QACjC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;gBACxB,KAAK,EAAE,qBAAS,CAAC,qCAAqC,CAAC,IAAI,CAAC;gBAC5D,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAU,CAAC,kBAAkB,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,OAAO,CAAC;YACrB,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;gBACxB,KAAK,EAAE,qBAAS,CAAC,qCAAqC,CAAC,IAAI,CAAC;gBAC5D,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,OAAO,iCAAiC,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,OAAgB;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YACzC,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBACjB,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5C,MAAM,IAAI,GAAG,WAAW,CAAC;gBACzB,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;oBACxB,KAAK,EAAE,qBAAS,CAAC,qCAAqC,CAAC,IAAI,CAAC;oBAC5D,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,uFAAuF;YACvF,QAAQ;QACV,CAAC;IACH,CAAC;;AAzDH,sCA0DC"}

package/dist/esm/tools/MakeCommentTool.d.ts

@@ -0,0 +1,21 @@
+import { BaseToolGptParameters } from '../models/BaseToolGptParameters';
+import { ToolCallContext } from '../models/ToolCallContext';
+import { ToolCallResult } from '../models/ToolCallResult';
+import { Tool } from './Tool';
+export interface MakeCommentToolCoreParameters {
+}
+export interface MakeCommentToolGptParameters extends BaseToolGptParameters, MakeCommentToolCoreParameters {
+    /**
+     * The comment to make.
+     */
+    comment: string;
+}
+/**
+ * Tool for making a comment during course of the flow.
+ */
+export declare class MakeCommentTool extends Tool<MakeCommentToolCoreParameters, MakeCommentToolGptParameters> {
+    static readonly NAME = "makeComment";
+    constructor();
+    call(_context: ToolCallContext, _parameters: MakeCommentToolCoreParameters): Promise<ToolCallResult>;
+    callFromGpt(_context: ToolCallContext, parameters: MakeCommentToolGptParameters): Promise<ToolCallResult>;
+}

package/dist/esm/tools/MakeCommentTool.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MakeCommentTool = void 0;
+const Logger_1 = require("../utils/Logger");
+const Tool_1 = require("./Tool");
+/**
+ * Tool for making a comment during course of the flow.
+ */
+class MakeCommentTool extends Tool_1.Tool {
+    static NAME = 'makeComment';
+    constructor() {
+        super(MakeCommentTool.NAME, 'Make a comment regarding the current page or Donobu flow.', 'MakeCommentToolCoreParameters', 'MakeCommentToolGptParameters');
+    }
+    async call(_context, _parameters) {
+        Logger_1.Logger.appLogger.warn(`${this.name} tool is being run without a GPT even though it makes no sense to do so!`);
+        return {
+            isSuccessful: true,
+            forLlm: '',
+            metadata: null,
+        };
+    }
+    async callFromGpt(_context, parameters) {
+        return {
+            isSuccessful: true,
+            forLlm: parameters.comment,
+            metadata: null,
+        };
+    }
+}
+exports.MakeCommentTool = MakeCommentTool;
+//# sourceMappingURL=MakeCommentTool.js.map

package/dist/esm/tools/MakeCommentTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MakeCommentTool.js","sourceRoot":"","sources":["../../../src/tools/MakeCommentTool.ts"],"names":[],"mappings":";;;AAGA,4CAAyC;AACzC,iCAA8B;AAa9B;;GAEG;AACH,MAAa,eAAgB,SAAQ,WAGpC;IACQ,MAAM,CAAU,IAAI,GAAG,aAAa,CAAC;IAE5C;QACE,KAAK,CACH,eAAe,CAAC,IAAI,EACpB,2DAA2D,EAC3D,+BAA+B,EAC/B,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,QAAyB,EACzB,WAA0C;QAE1C,eAAM,CAAC,SAAS,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,IAAI,0EAA0E,CACvF,CAAC;QACF,OAAO;YACL,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IAEe,KAAK,CAAC,WAAW,CAC/B,QAAyB,EACzB,UAAwC;QAExC,OAAO;YACL,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,UAAU,CAAC,OAAO;YAC1B,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;;AAtCH,0CAuCC"}