@empiricalrun/playwright-utils 0.23.0 → 0.23.1

package/bundled/test-gen/agent/master/element-annotation.js

@@ -1,195 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAnnotationKeys = exports.getElementAnnotation = void 0;
-const llm_1 = require("@empiricalrun/llm");
-const constants_1 = require("../../constants");
-const promptTemplate_0 = "{{#section \"system\"}}\nYou are an expert in describing the images and it's content. You need to provide the descriptions of annotated elements\npresent in the image.\n\nYou will be provided with an annotated screenshot where interact-able / clickable elements are annotated. The annotation\nis done by drawing a red box around the element and a small yellow box on it which contains unique element id.\n\nYou are given a Annotations which contains list of unique element id and description of the element separated by \":\".\n\nYou are also given the description of the element on which the action needs to be taken. The description includes\ninformation about how the element looks, it's position etc.\n\nYour task is to provide the annotation of the element on which the action needs to be performed based on the element\ndescription.\n\nFollow steps to fulfil your task:\n- Using the list of all element Ids provided to you, map all the element Ids on the annotated screen and describe each\nelement.\n- For describing each element Id\n-- iterate over each element Id in annotation list\n-- check if the description is already present for the element Id in the Annotation provided to you. If present skip\ndescribing it and use it as is.\n-- if the description is NA, then identify the element in the annotated screenshot and describe it using the image or\nicon enclosed in the element.\n- Respond with the mapped element Ids as \"enriched_annotations\"\n- Based on the description provided to you and the enriched annotations, first identify the element Id whose description\nmatches the task provided\n\nNote:\n- Ensure providing the description of all the elements in the list.\n- Don't update the description if its already present in the given annotations\n- Replace all the \"NA\" with description of the element. Its position, how does it look like etc.\n- There should be no \"NA\" present in any of the element description\n{{/section}}\n\n{{#section \"user\"}}\nElement description:\n{{elementDescription}}\n\nAnnotations:\n{{annotations}}\n\n{{image annotatedScreenshot}}\n{{/section}}";
-const utils_1 = require("../utils");
-const icon_descriptor_1 = require("./icon-descriptor");
-const annotationToolAction = {
-    name: "element_annotation",
-    schema: {
-        type: "function",
-        function: {
-            name: "element_annotation",
-            description: "Handles annotations for elements and enriched annotations.",
-            parameters: {
-                type: "object",
-                properties: {
-                    enriched_annotations: {
-                        type: "array",
-                        description: "List of enriched annotations for elements.",
-                        items: {
-                            type: "object",
-                            properties: {
-                                element_id: {
-                                    type: "string",
-                                    description: "Unique element ID for the element.",
-                                },
-                                description: {
-                                    type: "string",
-                                    description: "Detailed description for the element. Must not be NA",
-                                },
-                            },
-                            required: ["element_id", "description"],
-                        },
-                    },
-                    reason: {
-                        type: "string",
-                        description: "Explain why this element is selected. The reason should be clear and align with the task or purpose.",
-                    },
-                    element: {
-                        type: "string",
-                        description: "Detailed description of the DOM element's visual characteristics and position.",
-                    },
-                    element_annotation: {
-                        type: "string",
-                        description: "Return the unique element ID for the element on which the action needs to be performed.",
-                    },
-                },
-                required: [
-                    "enriched_annotations",
-                    "reason",
-                    "element",
-                    "element_annotation",
-                ],
-            },
-        },
-    },
-};
-async function getElementAnnotation({ elementDescription, annotations, annotatedScreenshot, trace, llm, options, preference, }) {
-    const annotationsSpan = trace?.span({
-        name: "get-element-annotation",
-        input: {
-            elementDescription,
-            annotations,
-            annotatedScreenshot,
-            preference,
-        },
-    });
-    const messages = (0, llm_1.compilePrompt)(promptTemplate_0, {
-        elementDescription,
-        annotations,
-        annotatedScreenshot,
-    }, options);
-    llm =
-        llm ||
-            new llm_1.LLM({
-                provider: options?.modelProvider || constants_1.DEFAULT_MODEL_PROVIDER,
-                defaultModel: options?.model || constants_1.DEFAULT_MODEL,
-            });
-    const completion = await llm.createChatCompletion({
-        messages,
-        modelParameters: {
-            ...constants_1.DEFAULT_MODEL_PARAMETERS,
-            ...options?.modelParameters,
-            tool_choice: "required",
-            temperature: 0.5,
-        },
-        trace: annotationsSpan,
-        traceName: "get-element-from-action",
-        //@ts-ignore
-        tools: [annotationToolAction.schema],
-    });
-    const toolCall = completion?.tool_calls?.[0];
-    annotationsSpan?.end({ output: toolCall });
-    if (toolCall) {
-        const args = (0, utils_1.parseJson)(toolCall.function.arguments);
-        return args.element_annotation;
-    }
-    return;
-}
-exports.getElementAnnotation = getElementAnnotation;
-async function getAnnotationKeys({ page, preference, trace, }) {
-    const annotatedElements = await page.evaluate(({ preference, options }) => {
-        // @ts-ignore
-        // eslint-disable-next-line no-undef
-        window.annotationInstance = annotateElementsWithPreference({
-            options: options,
-            preference: preference,
-        });
-        const annotations = Object.entries(
-        // @ts-ignore
-        window.annotationInstance.annotations).map(([key, value]) => {
-            // Helper function to safely get text content
-            const getTextContent = (node) => {
-                try {
-                    return node?.innerText?.trim() || null;
-                }
-                catch {
-                    return null;
-                }
-            };
-            // Helper function to safely get placeholder
-            const getPlaceholder = (node) => {
-                try {
-                    return node?.placeholder?.trim() || null;
-                }
-                catch {
-                    return null;
-                }
-            };
-            return {
-                elementID: key,
-                innerText: getTextContent(value.node),
-                innerHTML: value.node.innerHTML,
-                outerHTML: value.node.outerHTML,
-                placeholder: getPlaceholder(value.node),
-            };
-        });
-        const fullPageHTML = document.documentElement.outerHTML;
-        return { annotations, fullPageHTML };
-    }, { preference, options: {} });
-    const annotationKeys = await enrichAnnotations(annotatedElements.annotations, annotatedElements.fullPageHTML, trace);
-    const annotationBuffer = await page.screenshot({
-    // path: `screenshots/screenshot-${screenshotIndex++}.png`,
-    });
-    const annotatedPageScreenshot = annotationBuffer.toString("base64");
-    await page.evaluate(() => {
-        console.log({
-            // @ts-ignore
-            disable: window?.annotationInstance?.disable,
-        });
-        if (
-        // @ts-ignore
-        window?.annotationInstance &&
-            // @ts-ignore
-            window?.annotationInstance?.destroy) {
-            // @ts-ignore
-            window?.annotationInstance?.destroy();
-        }
-    });
-    return {
-        annotationKeys,
-        annotationBuffer,
-        annotatedPageScreenshot,
-    };
-}
-exports.getAnnotationKeys = getAnnotationKeys;
-async function enrichAnnotations(annotatedElements, pageHtml, trace) {
-    // create icon descriptor span
-    const iconDescriptionSpan = trace?.span({
-        name: "describe-icons",
-    });
-    const results = [];
-    for (const element of annotatedElements) {
-        const text = element.innerText?.trim() || element.placeholder?.trim();
-        if (text) {
-            results.push({
-                elementID: element.elementID,
-                text,
-            });
-            continue;
-        }
-        const description = await (0, icon_descriptor_1.getIconDescription)({
-            htmlString: element.outerHTML,
-            pageHtml: pageHtml,
-            trace: iconDescriptionSpan,
-        });
-        results.push({
-            elementID: element.elementID,
-            text: description || "NA",
-        });
-    }
-    return results;
-}

package/bundled/test-gen/agent/master/execute-browser-action.d.ts

@@ -1,24 +0,0 @@
-import { LLM, TraceClient } from "@empiricalrun/llm";
-import type { Page } from "@playwright/test";
-import { PlaywrightActions } from "../../actions";
-export declare function executeBrowserAction({ page, nextAction, flags, actions, llm, trace, }: {
-    page: Page;
-    nextAction: {
-        actionType: string;
-        toolCallArgs: string;
-    };
-    flags: {
-        useActionSpecificAnnotations: boolean;
-    };
-    actions: PlaywrightActions;
-    trace: TraceClient | undefined;
-    llm: LLM;
-}): Promise<{
-    generatedCodeSteps: string[];
-    output: {
-        action: string;
-        reason: string;
-        elementAnnotation?: string | undefined;
-    };
-}>;
-//# sourceMappingURL=execute-browser-action.d.ts.map

package/bundled/test-gen/agent/master/execute-browser-action.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execute-browser-action.d.ts","sourceRoot":"","sources":["../../../src/agent/master/execute-browser-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAYlD,wBAAsB,oBAAoB,CAAC,EACzC,IAAI,EACJ,UAAU,EACV,KAAK,EACL,OAAO,EACP,GAAG,EACH,KAAK,GACN,EAAE;IACD,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,4BAA4B,EAAE,OAAO,CAAC;KACvC,CAAC;IACF,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,GAAG,EAAE,GAAG,CAAC;CACV;;;gBAIW,MAAM;gBACN,MAAM;;;GAkIjB"}

package/bundled/test-gen/agent/master/execute-browser-action.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeBrowserAction = void 0;
-const reporter_1 = require("../../reporter");
-const browsing_1 = require("../browsing");
-const utils_1 = require("../utils");
-const action_tool_calls_1 = require("./action-tool-calls");
-const element_annotation_1 = require("./element-annotation");
-const with_hints_1 = require("./with-hints");
-async function executeBrowserAction({ page, nextAction, flags, actions, llm, trace, }) {
-    const args = (0, utils_1.parseJson)(nextAction.toolCallArgs);
-    let generatedCodeSteps = [];
-    let output = {
-        action: args.action,
-        reason: args.reason,
-    };
-    let shouldTriggerHintsFlow;
-    let hintsExecutionCompletion;
-    let elementAnnotation;
-    const actionType = nextAction.actionType;
-    let preference = {
-        actionType: "all",
-    };
-    if (flags.useActionSpecificAnnotations && (0, action_tool_calls_1.isValidActionType)(actionType)) {
-        switch (actionType) {
-            case action_tool_calls_1.ActionType.FILL:
-                preference = {
-                    actionType: action_tool_calls_1.ActionType.FILL,
-                };
-                break;
-            case action_tool_calls_1.ActionType.ASSERT_TEXT:
-                preference = {
-                    actionType: action_tool_calls_1.ActionType.ASSERT_TEXT,
-                    assertionText: args.assertion_text,
-                };
-                break;
-            default:
-                preference = {
-                    actionType: "all",
-                };
-        }
-    }
-    let { annotationKeys, annotatedPageScreenshot, annotationBuffer } = await (0, element_annotation_1.getAnnotationKeys)({
-        page,
-        preference,
-        trace,
-    });
-    if (annotationKeys.length > 0) {
-        // TODO: this string has newline characters that makes it harder to read
-        const annotationMapString = annotationKeys
-            ?.map((a) => `${a.elementID}: ${a.text}`)
-            .join("\n");
-        // Provides the annotations for all the element present on screen
-        // Also provides the annotation of element on which the action needs to be taken
-        elementAnnotation = await (0, element_annotation_1.getElementAnnotation)({
-            elementDescription: args.element_description,
-            annotations: annotationMapString,
-            annotatedScreenshot: annotatedPageScreenshot,
-            trace,
-            llm,
-            preference,
-        });
-        output.elementAnnotation = elementAnnotation;
-        console.log("Output: ", output);
-        const testGenReporter = new reporter_1.TestGenUpdatesReporter();
-        await testGenReporter.sendCurrentView(annotationBuffer);
-        const triggerHintsFlowSpan = trace?.span({
-            name: "trigger-hints-flow",
-            input: {
-                outputFromGetNextAction: output,
-                generatedAnnotations: annotationKeys,
-            },
-        });
-        // Provides the action whether its a click, fill etc.
-        const result = await (0, with_hints_1.triggerHintsFlow)({
-            outputFromGetNextAction: output,
-            generatedAnnotations: annotationKeys,
-            actions,
-            llm,
-            trace: triggerHintsFlowSpan,
-        });
-        shouldTriggerHintsFlow = result.shouldTriggerHintsFlow;
-        hintsExecutionCompletion = result.hintsExecutionCompletion;
-        triggerHintsFlowSpan?.end({
-            output: result,
-        });
-    }
-    if (shouldTriggerHintsFlow && hintsExecutionCompletion) {
-        const toolCalls = hintsExecutionCompletion?.tool_calls || [];
-        for (const i in toolCalls) {
-            const currentToolCall = toolCalls[i];
-            const code = await actions.executeAction(currentToolCall.function.name, {
-                ...JSON.parse(currentToolCall.function.arguments),
-                elementAnnotation,
-            }, trace);
-            if (code) {
-                generatedCodeSteps.push(code);
-            }
-        }
-        if (actions.isStuckInLoop()) {
-            throw new Error("Agent is not able to figure out next action when using hints");
-        }
-    }
-    else {
-        const browserAction = await (0, browsing_1.executeTaskUsingBrowsingAgent)({
-            trace,
-            action: output.action,
-            page,
-            llm,
-            actions,
-        });
-        if (browserAction) {
-            output.action = browserAction.action;
-            if (browserAction.code) {
-                generatedCodeSteps.push(browserAction.code);
-            }
-        }
-    }
-    return {
-        generatedCodeSteps,
-        output,
-    };
-}
-exports.executeBrowserAction = executeBrowserAction;

package/bundled/test-gen/agent/master/execute-skill-action.d.ts

@@ -1,11 +0,0 @@
-import { TraceClient } from "@empiricalrun/llm";
-import { PlaywrightActions } from "../../actions";
-export declare function executeSkillAction({ actions, nextAction, trace, }: {
-    actions: PlaywrightActions;
-    nextAction: {
-        actionType: string;
-        toolCallArgs: string;
-    };
-    trace: TraceClient | undefined;
-}): Promise<string | undefined>;
-//# sourceMappingURL=execute-skill-action.d.ts.map

package/bundled/test-gen/agent/master/execute-skill-action.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execute-skill-action.d.ts","sourceRoot":"","sources":["../../../src/agent/master/execute-skill-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOlD,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,UAAU,EACV,KAAK,GACN,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;CAChC,+BAeA"}

package/bundled/test-gen/agent/master/execute-skill-action.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeSkillAction = void 0;
-const skill_1 = require("../../actions/skill");
-const errors_1 = require("../../errors");
-const human_in_the_loop_1 = require("../../human-in-the-loop");
-const env_1 = require("../../utils/env");
-const utils_1 = require("../utils");
-async function executeSkillAction({ actions, nextAction, trace, }) {
-    const args = (0, utils_1.parseJson)(nextAction.toolCallArgs);
-    if (!(0, env_1.isRunningOnCloud)()) {
-        const { skillDetails } = (0, skill_1.extractSkillFromArgs)(args);
-        const feedback = await human_in_the_loop_1.humanLoop.getFeedback({
-            message: `Should I use this skill?\n\n${skillDetails?.usageExample}\n\nfrom: ${skillDetails?.filePath}\n\nAnswer with "yes" or "no"`,
-        });
-        if (feedback.toLowerCase().trim().includes("no")) {
-            throw new errors_1.HumanApprovalDenied("Skill usage approval not provided");
-        }
-    }
-    const code = await actions.executeAction(nextAction.actionType, args, trace);
-    if (code) {
-        return code;
-    }
-}
-exports.executeSkillAction = executeSkillAction;

package/bundled/test-gen/agent/master/icon-descriptor/index.d.ts

@@ -1,22 +0,0 @@
-import { TraceClient } from "@empiricalrun/llm";
-type IconKnowledge = {
-    description: string;
-    key: string;
-    normalized: string;
-    createdAt: Date;
-};
-export declare function loadIconsKnowledge(): Array<IconKnowledge>;
-export declare function saveIconsKnowledge(iconsData: Array<IconKnowledge>): Promise<void>;
-export declare function generateKey(htmlString: string): string;
-export declare function reverseKey(hash: string): string;
-export declare function createNodeFromHTML(htmlString: string): {
-    node: Element | null;
-    descendant: Element[];
-};
-export declare function getIconDescription({ htmlString, pageHtml, trace, }: {
-    htmlString: string;
-    trace?: TraceClient;
-    pageHtml: string;
-}): Promise<string | undefined>;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/bundled/test-gen/agent/master/icon-descriptor/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent/master/icon-descriptor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAarD,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,KAAK,CAAC,aAAa,CAAC,CAoDzD;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM;;;EAUpD;AAqKD,wBAAsB,kBAAkB,CAAC,EACvC,UAAU,EACV,QAAQ,EACR,KAAK,GACN,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkC9B"}

package/bundled/test-gen/agent/master/icon-descriptor/index.js

@@ -1,250 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIconDescription = exports.createNodeFromHTML = exports.reverseKey = exports.generateKey = exports.saveIconsKnowledge = exports.loadIconsKnowledge = void 0;
-const llm_1 = require("@empiricalrun/llm");
-const fs_1 = __importDefault(require("fs"));
-const jsdom_1 = require("jsdom");
-const path_1 = __importDefault(require("path"));
-const constants_1 = require("../../../constants");
-const normalize_svg_1 = require("./normalize-svg");
-const OLD_ICONS_KNOWLEDGE_PATH = path_1.default.join(process.cwd(), "icons.json");
-const EMPIRICAL_RUN_DIR = path_1.default.join(process.cwd(), ".empiricalrun");
-const ICONS_KNOWLEDGE_PATH = path_1.default.join(EMPIRICAL_RUN_DIR, "icons.json");
-function loadIconsKnowledge() {
-    // Check if file exists in the new location
-    if (fs_1.default.existsSync(ICONS_KNOWLEDGE_PATH)) {
-        const raw = fs_1.default.readFileSync(ICONS_KNOWLEDGE_PATH, "utf-8");
-        if (raw) {
-            try {
-                return JSON.parse(raw);
-            }
-            catch (err) {
-                console.log("error parsing iconsKnowledge json");
-                return [];
-            }
-        }
-        return [];
-    }
-    // Check if file exists in the old location and move it if it does
-    if (fs_1.default.existsSync(OLD_ICONS_KNOWLEDGE_PATH)) {
-        try {
-            const raw = fs_1.default.readFileSync(OLD_ICONS_KNOWLEDGE_PATH, "utf-8");
-            let iconData = [];
-            if (raw) {
-                try {
-                    iconData = JSON.parse(raw);
-                }
-                catch (err) {
-                    console.log("error parsing iconsKnowledge json from old location");
-                }
-            }
-            // Create the directory and move the file
-            if (!fs_1.default.existsSync(EMPIRICAL_RUN_DIR)) {
-                fs_1.default.mkdirSync(EMPIRICAL_RUN_DIR, { recursive: true });
-            }
-            // Save to new location
-            fs_1.default.writeFileSync(ICONS_KNOWLEDGE_PATH, JSON.stringify(iconData, null, 2), "utf-8");
-            // Remove the old file
-            fs_1.default.unlinkSync(OLD_ICONS_KNOWLEDGE_PATH);
-            return iconData;
-        }
-        catch (err) {
-            console.log("Error moving icons knowledge file:", err);
-            return [];
-        }
-    }
-    return [];
-}
-exports.loadIconsKnowledge = loadIconsKnowledge;
-async function saveIconsKnowledge(iconsData) {
-    // Ensure the directory exists
-    if (!fs_1.default.existsSync(EMPIRICAL_RUN_DIR)) {
-        fs_1.default.mkdirSync(EMPIRICAL_RUN_DIR, { recursive: true });
-    }
-    const content = JSON.stringify(iconsData, null, 2);
-    fs_1.default.writeFileSync(ICONS_KNOWLEDGE_PATH, content, "utf-8");
-    // If old file exists, remove it
-    if (fs_1.default.existsSync(OLD_ICONS_KNOWLEDGE_PATH)) {
-        fs_1.default.unlinkSync(OLD_ICONS_KNOWLEDGE_PATH);
-    }
-}
-exports.saveIconsKnowledge = saveIconsKnowledge;
-function generateKey(htmlString) {
-    const normalized = (0, normalize_svg_1.normalizeSVG)(htmlString);
-    // generate base64 string
-    const encoded = Buffer.from(normalized).toString("base64");
-    return `icon_${encoded}`;
-}
-exports.generateKey = generateKey;
-function reverseKey(hash) {
-    const encoded = hash.replace(/^icon_/, "");
-    return Buffer.from(encoded, "base64").toString();
-}
-exports.reverseKey = reverseKey;
-function createNodeFromHTML(htmlString) {
-    const dom = new jsdom_1.JSDOM(htmlString);
-    const document = dom.window.document;
-    const node = document.body.firstElementChild;
-    return {
-        node, // Return the first node
-        descendant: node ? Array.from(node.querySelectorAll("*")) : [], // Convert HTMLCollection to array
-    };
-}
-exports.createNodeFromHTML = createNodeFromHTML;
-function processSvgWithUseElements(svgElement, document) {
-    try {
-        const useElements = svgElement.querySelectorAll("use");
-        for (const useEl of Array.from(useElements)) {
-            const href = useEl.getAttribute("href") || useEl.getAttribute("xlink:href");
-            if (!href)
-                continue;
-            const id = href.startsWith("#") ? href.substring(1) : href;
-            const referencedElement = document.getElementById(id);
-            if (referencedElement) {
-                if (referencedElement.tagName.toLowerCase() === "symbol" ||
-                    referencedElement.tagName.toLowerCase() === "svg") {
-                    const group = document.createElement("g");
-                    Array.from(useEl.attributes).forEach((attr) => {
-                        if (attr.name !== "href" && attr.name !== "xlink:href") {
-                            group.setAttribute(attr.name, attr.value);
-                        }
-                    });
-                    if (referencedElement.hasAttribute("viewBox")) {
-                        group.setAttribute("viewBox", referencedElement.getAttribute("viewBox") || "");
-                    }
-                    group.innerHTML = referencedElement.innerHTML;
-                    useEl.parentNode?.replaceChild(group, useEl);
-                }
-            }
-        }
-    }
-    catch (error) {
-        console.error("Error processing SVG with use elements:", error);
-    }
-}
-/**
- * Extracts and returns an SVG element from a given HTML string.
- *
- * This function checks whether the provided HTML string contains an SVG element
- * either as the root node or as a child node.
- */
-function getHtmlForDescription(elementHtml, pageHtml) {
-    const dom = new jsdom_1.JSDOM(pageHtml);
-    const page = dom.window.document;
-    const { node, descendant } = createNodeFromHTML(elementHtml);
-    if (!node) {
-        return undefined;
-    }
-    if (node.tagName.toLowerCase() === "svg") {
-        processSvgWithUseElements(node, page);
-        return node.outerHTML;
-    }
-    const svgChildren = descendant?.filter((child) => child?.tagName?.toLowerCase() === "svg");
-    if (svgChildren && svgChildren.length > 0) {
-        for (const svgChild of svgChildren) {
-            processSvgWithUseElements(svgChild, page);
-        }
-        return node.outerHTML;
-    }
-    return undefined;
-}
-async function describeSVGElementWithLLM({ element, trace, }) {
-    try {
-        const svgDescriptionSpan = trace?.span({
-            name: "get-svg-description",
-            input: {
-                element,
-            },
-        });
-        const messages = [
-            {
-                role: "system",
-                content: `
-You are an expert at reading svg icons. You are given a task to provide the description of an icon based on the given HTML element string.
-If the string does not contain any svg element, return NA.
-          `,
-            },
-            {
-                role: "user",
-                content: `
-Provide the description of below element:
-${element}
-
-Follow below steps to provide the description:
-- Identify the svg element in the given HTML string
-- If the string does not contain any svg element, return NA
-- Else, read the svg element and provide a single line description for the element
-- The description should be precise and readable
-- Only provide the element description and nothing else
-`,
-            },
-        ];
-        const llm = new llm_1.LLM({
-            trace: svgDescriptionSpan,
-            provider: "anthropic",
-            defaultModel: "claude-3-5-sonnet-latest",
-            providerApiKey: constants_1.MODEL_API_KEYS["anthropic"],
-        });
-        const svgDescription = await llm.createChatCompletion({
-            messages,
-            modelParameters: {
-                temperature: 0.3,
-            },
-            responseFormat: {
-                type: "json_schema",
-                json_schema: {
-                    name: "describe-svg-element",
-                    strict: true,
-                    schema: {
-                        type: "object",
-                        properties: {
-                            description: {
-                                type: "string",
-                                description: "A clear description of what the SVG visually represents",
-                            },
-                        },
-                        additionalProperties: false,
-                        required: ["description"],
-                    },
-                },
-            },
-        });
-        svgDescriptionSpan?.end({ output: svgDescription });
-        return svgDescription?.content ?? undefined;
-    }
-    catch (err) {
-        console.error(`Error generating svg description ${err}`);
-        return undefined;
-    }
-}
-async function getIconDescription({ htmlString, pageHtml, trace, }) {
-    const elementStringForDescription = getHtmlForDescription(htmlString, pageHtml);
-    if (!elementStringForDescription) {
-        return undefined;
-    }
-    const key = generateKey(elementStringForDescription);
-    const iconsData = loadIconsKnowledge();
-    const cachedIcon = iconsData.find((icon) => icon.key === key);
-    if (cachedIcon) {
-        return cachedIcon.description;
-    }
-    const description = await describeSVGElementWithLLM({
-        element: elementStringForDescription,
-        trace,
-    });
-    if (description) {
-        const newIconEntry = {
-            description,
-            key,
-            normalized: htmlString,
-            createdAt: new Date(),
-        };
-        iconsData.push(newIconEntry);
-        await saveIconsKnowledge(iconsData);
-    }
-    return description;
-}
-exports.getIconDescription = getIconDescription;

package/bundled/test-gen/agent/master/icon-descriptor/normalize-svg.d.ts

@@ -1,2 +0,0 @@
-export declare function normalizeSVG(svgHtml: string): string;
-//# sourceMappingURL=normalize-svg.d.ts.map

package/bundled/test-gen/agent/master/icon-descriptor/normalize-svg.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize-svg.d.ts","sourceRoot":"","sources":["../../../../src/agent/master/icon-descriptor/normalize-svg.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA8BpD"}