@rpascene/shared 0.30.8

package/dist/es/us-keyboard-layout.mjs.LICENSE.txt

@@ -0,0 +1,5 @@
+/**
+ * @license
+ * Copyright 2017 Google Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/es/utils.mjs

@@ -0,0 +1,66 @@
+import { sha256 } from "js-sha256";
+import { v4 } from "uuid";
+var _process_versions;
+const ifInBrowser = 'undefined' != typeof window;
+const ifInWorker = 'undefined' != typeof WorkerGlobalScope;
+const ifInNode = 'undefined' != typeof process && (null == (_process_versions = process.versions) ? void 0 : _process_versions.node);
+function uuid() {
+    return v4();
+}
+const hashMap = {};
+function generateHashId(rect, content = '') {
+    const combined = JSON.stringify({
+        content,
+        rect
+    });
+    let sliceLength = 5;
+    let slicedHash = '';
+    const hashHex = sha256.create().update(combined).hex();
+    const toLetters = (hex)=>hex.split('').map((char)=>{
+            const code = Number.parseInt(char, 16);
+            return String.fromCharCode(97 + code % 26);
+        }).join('');
+    const hashLetters = toLetters(hashHex);
+    while(sliceLength < hashLetters.length - 1){
+        slicedHash = hashLetters.slice(0, sliceLength);
+        if (hashMap[slicedHash] && hashMap[slicedHash] !== combined) {
+            sliceLength++;
+            continue;
+        }
+        hashMap[slicedHash] = combined;
+        break;
+    }
+    return slicedHash;
+}
+function assert(condition, message) {
+    if (!condition) throw new Error(message || 'Assertion failed');
+}
+function getGlobalScope() {
+    if ('undefined' != typeof window) return window;
+    if ('undefined' != typeof globalThis) return globalThis;
+    if ('undefined' != typeof self) return self;
+}
+let isMcp = false;
+function setIsMcp(value) {
+    isMcp = value;
+}
+function logMsg(...message) {
+    if (!isMcp) console.log(...message);
+}
+async function repeat(times, fn) {
+    for(let i = 0; i < times; i++)await fn(i);
+}
+const utils_REGEXP_LT = /</g;
+const utils_REGEXP_GT = />/g;
+const REGEXP_LT_ESCAPE = '__rpascene_lt__';
+const REGEXP_GT_ESCAPE = '__rpascene_gt__';
+const escapeScriptTag = (html)=>html.replace(utils_REGEXP_LT, REGEXP_LT_ESCAPE).replace(utils_REGEXP_GT, REGEXP_GT_ESCAPE);
+const antiEscapeScriptTag = (html)=>{
+    const REGEXP_LT = new RegExp(REGEXP_LT_ESCAPE, 'g');
+    const REGEXP_GT = new RegExp(REGEXP_GT_ESCAPE, 'g');
+    return html.replace(REGEXP_LT, '<').replace(REGEXP_GT, '>');
+};
+function replaceIllegalPathCharsAndSpace(str) {
+    return str.replace(/[:*?"<>| ]/g, '-');
+}
+export { antiEscapeScriptTag, assert, escapeScriptTag, generateHashId, getGlobalScope, ifInBrowser, ifInNode, ifInWorker, logMsg, repeat, replaceIllegalPathCharsAndSpace, setIsMcp, uuid };

package/dist/lib/baseDB.js

@@ -0,0 +1,149 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    IndexedDBManager: ()=>IndexedDBManager,
+    createCleanupFunction: ()=>createCleanupFunction,
+    withErrorHandling: ()=>withErrorHandling
+});
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class IndexedDBManager {
+    initDB() {
+        return new Promise((resolve, reject)=>{
+            const request = indexedDB.open(this.dbName, this.version);
+            request.onerror = ()=>reject(request.error);
+            request.onsuccess = ()=>resolve(request.result);
+            request.onupgradeneeded = (event)=>{
+                const db = event.target.result;
+                this.storeConfigs.forEach(({ name, keyPath })=>{
+                    if (!db.objectStoreNames.contains(name)) {
+                        const store = db.createObjectStore(name, {
+                            keyPath
+                        });
+                        store.createIndex('timestamp', 'timestamp', {
+                            unique: false
+                        });
+                    }
+                });
+            };
+        });
+    }
+    async withTransaction(storeNames, mode, operation) {
+        const db = await this.dbPromise;
+        const transaction = db.transaction(storeNames, mode);
+        const stores = Array.isArray(storeNames) ? storeNames.map((name)=>transaction.objectStore(name)) : transaction.objectStore(storeNames);
+        return operation(stores);
+    }
+    promisifyRequest(request) {
+        return new Promise((resolve, reject)=>{
+            request.onsuccess = ()=>resolve(request.result);
+            request.onerror = ()=>reject(request.error);
+        });
+    }
+    async put(storeName, data) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.put(data));
+        });
+    }
+    async get(storeName, key) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>this.promisifyRequest(store.get(key)));
+    }
+    async getAll(storeName, sortByTimestamp = true) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>{
+            const objectStore = store;
+            const results = sortByTimestamp ? await this.promisifyRequest(objectStore.index('timestamp').getAll()) : await this.promisifyRequest(objectStore.getAll());
+            return sortByTimestamp ? results.sort((a, b)=>a.timestamp - b.timestamp) : results;
+        });
+    }
+    async clear(storeName) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.clear());
+        });
+    }
+    async delete(storeName, key) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.delete(key));
+        });
+    }
+    async count(storeName) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>this.promisifyRequest(store.count()));
+    }
+    getDBPromise() {
+        return this.dbPromise;
+    }
+    constructor(dbName, version, storeConfigs){
+        _define_property(this, "dbPromise", void 0);
+        _define_property(this, "dbName", void 0);
+        _define_property(this, "version", void 0);
+        _define_property(this, "storeConfigs", void 0);
+        this.dbName = dbName;
+        this.version = version;
+        this.storeConfigs = storeConfigs;
+        this.dbPromise = this.initDB();
+    }
+}
+const withErrorHandling = async (operation, errorMessage, defaultValue, onQuotaExceeded)=>{
+    try {
+        return await operation();
+    } catch (e) {
+        console.error(errorMessage, e);
+        if (e instanceof Error && 'QuotaExceededError' === e.name && onQuotaExceeded) {
+            console.log('Storage quota exceeded, running cleanup...');
+            await onQuotaExceeded();
+        }
+        return defaultValue;
+    }
+};
+const createCleanupFunction = (dbManager, storeName, maxItems)=>async ()=>{
+        try {
+            const results = await dbManager.getAll(storeName);
+            if (results.length > maxItems) {
+                const toDelete = results.sort((a, b)=>a.timestamp - b.timestamp).slice(0, results.length - maxItems);
+                await Promise.all(toDelete.map((item)=>dbManager.delete(storeName, item.id)));
+            }
+        } catch (e) {
+            console.error(`Failed to cleanup ${storeName}:`, e);
+        }
+    };
+exports.IndexedDBManager = __webpack_exports__.IndexedDBManager;
+exports.createCleanupFunction = __webpack_exports__.createCleanupFunction;
+exports.withErrorHandling = __webpack_exports__.withErrorHandling;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "IndexedDBManager",
+    "createCleanupFunction",
+    "withErrorHandling"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/build/copy-static.js

@@ -0,0 +1,77 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createPlaygroundCopyPlugin: ()=>createPlaygroundCopyPlugin,
+    createCopyStaticPlugin: ()=>createCopyStaticPlugin
+});
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const createCopyStaticPlugin = (options)=>({
+        name: options.pluginName || 'copy-static',
+        setup (api) {
+            api.onAfterBuild(async ()=>{
+                const { srcDir, destDir, faviconPath } = options;
+                await external_node_fs_default().promises.mkdir(destDir, {
+                    recursive: true
+                });
+                await external_node_fs_default().promises.cp(srcDir, destDir, {
+                    recursive: true
+                });
+                console.log(`Copied build artifacts from ${srcDir} to ${destDir}`);
+                if (faviconPath) {
+                    const faviconDest = external_node_path_default().join(destDir, 'favicon.ico');
+                    await external_node_fs_default().promises.copyFile(faviconPath, faviconDest);
+                    console.log(`Copied favicon from ${faviconPath} to ${faviconDest}`);
+                }
+            });
+        }
+    });
+const createPlaygroundCopyPlugin = (srcDir, destDir, pluginName, faviconSrc)=>createCopyStaticPlugin({
+        srcDir,
+        destDir,
+        faviconPath: faviconSrc,
+        pluginName
+    });
+exports.createCopyStaticPlugin = __webpack_exports__.createCopyStaticPlugin;
+exports.createPlaygroundCopyPlugin = __webpack_exports__.createPlaygroundCopyPlugin;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "createCopyStaticPlugin",
+    "createPlaygroundCopyPlugin"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/common.js

@@ -0,0 +1,93 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    defaultRunDirName: ()=>defaultRunDirName,
+    ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED: ()=>ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED,
+    getRpasceneRunSubDir: ()=>getRpasceneRunSubDir,
+    getRpasceneRunDir: ()=>getRpasceneRunDir,
+    getRpasceneRunBaseDir: ()=>getRpasceneRunBaseDir
+});
+const external_node_fs_namespaceObject = require("node:fs");
+const external_node_os_namespaceObject = require("node:os");
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const basic_js_namespaceObject = require("./env/basic.js");
+const types_js_namespaceObject = require("./env/types.js");
+const external_utils_js_namespaceObject = require("./utils.js");
+const defaultRunDirName = 'rpascene_run';
+const getRpasceneRunDir = ()=>{
+    if (!external_utils_js_namespaceObject.ifInNode) return '';
+    return (0, basic_js_namespaceObject.getBasicEnvValue)(types_js_namespaceObject.RPASCENE_RUN_DIR) || defaultRunDirName;
+};
+const getRpasceneRunBaseDir = ()=>{
+    if (!external_utils_js_namespaceObject.ifInNode) return '';
+    let basePath = external_node_path_default().resolve(process.cwd(), getRpasceneRunDir());
+    if (!(0, external_node_fs_namespaceObject.existsSync)(basePath)) try {
+        (0, external_node_fs_namespaceObject.mkdirSync)(basePath, {
+            recursive: true
+        });
+    } catch (error) {
+        basePath = external_node_path_default().join((0, external_node_os_namespaceObject.tmpdir)(), defaultRunDirName);
+        (0, external_node_fs_namespaceObject.mkdirSync)(basePath, {
+            recursive: true
+        });
+    }
+    return basePath;
+};
+const getRpasceneRunSubDir = (subdir)=>{
+    if (!external_utils_js_namespaceObject.ifInNode) return '';
+    const basePath = getRpasceneRunBaseDir();
+    const logPath = external_node_path_default().join(basePath, subdir);
+    if (!(0, external_node_fs_namespaceObject.existsSync)(logPath)) (0, external_node_fs_namespaceObject.mkdirSync)(logPath, {
+        recursive: true
+    });
+    return logPath;
+};
+const ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED = 'NOT_IMPLEMENTED_AS_DESIGNED';
+exports.ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED = __webpack_exports__.ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED;
+exports.defaultRunDirName = __webpack_exports__.defaultRunDirName;
+exports.getRpasceneRunBaseDir = __webpack_exports__.getRpasceneRunBaseDir;
+exports.getRpasceneRunDir = __webpack_exports__.getRpasceneRunDir;
+exports.getRpasceneRunSubDir = __webpack_exports__.getRpasceneRunSubDir;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED",
+    "defaultRunDirName",
+    "getRpasceneRunBaseDir",
+    "getRpasceneRunDir",
+    "getRpasceneRunSubDir"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/constants/example-code.js

@@ -0,0 +1,239 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    PLAYWRIGHT_EXAMPLE_CODE: ()=>PLAYWRIGHT_EXAMPLE_CODE,
+    YAML_EXAMPLE_CODE: ()=>YAML_EXAMPLE_CODE
+});
+const PLAYWRIGHT_EXAMPLE_CODE = `
+// Reference the following code to generate Rpascene test cases
+// The following is test code for Rpascene AI, for reference
+// The following is Playwright syntax, you can use Playwright to assist in test generation
+IMPORTANT: Follow these exact type signatures for AI functions:
+
+// Type signatures for AI functions:
+aiInput(value: string, locator: string): Promise<void>
+aiTap(locator: string): Promise<void>
+aiDoubleClick(locator: string): Promise<void>
+aiScroll(scrollParam: {
+  direction: 'up' | 'down' | 'left' | 'right',
+  scrollType: 'once' | 'untilBottom' | 'untilTop' | 'untilRight' | 'untilLeft',
+  distance: number - scroll distance, px is the unit
+}): Promise<void>
+aiAssert(assertion: string): Promise<void>
+aiQuery<T>(queryObject: Record<string, string>): Promise<T> // Extracts data from page based on descriptions
+
+// examples:
+// Reference the following code to generate Rpascene test cases
+// The following is test code for Rpascene AI, for reference
+// The following is Playwright syntax, you can use Playwright to assist in test generation
+import { test as base } from '@playwright/test';
+import type { PlayWrightAiFixtureType } from '@rpascene/web/playwright';
+import { PlaywrightAiFixture } from '@rpascene/web/playwright';
+
+const test = base.extend<PlayWrightAiFixtureType>(PlaywrightAiFixture({
+  waitForNetworkIdleTimeout: 2000, // optional, the timeout for waiting for network idle between each action, default is 2000ms
+}));
+
+
+test.beforeEach(async ({ page }) => {
+  await page.goto('https://www.xxx.com/');
+  await page.setViewportSize({ width: 1920, height: 1080 });
+});
+
+test('ai shop', async ({
+  aiInput,
+  aiAssert,
+  aiQuery,
+  aiKeyboardPress,
+  aiHover,
+  aiTap,
+  agentForPage,
+  page,
+}) => {
+  // login
+  await aiAssert('The page shows the login interface');
+  await aiInput('user_name', 'in user name input');
+  await aiInput('password', 'in password input');
+  await aiKeyboardPress('Enter', 'Login Button');
+
+  // check the login success
+  await aiWaitFor('The page shows that the loading is complete');
+  await aiAssert('The current page shows the product detail page');
+
+  // check the product info
+  const dataA = await aiQuery({
+    userInfo: 'User information in the format {name: string}',
+    theFirstProductInfo: 'The first product info in the format {name: string, price: number}',
+  });
+  expect(dataA.theFirstProductInfo.name).toBe('xxx');
+  expect(dataA.theFirstProductInfo.price).toBe(100);
+
+
+  // add to cart
+  await aiTap('click add to cart button');
+  
+  await aiTap('click right top cart icon');
+  await aiAssert('The cart icon shows the number 1');
+});
+`;
+const YAML_EXAMPLE_CODE = `
+1. Format:
+
+web:
+  url: "starting_url"
+  viewportWidth: 1280
+  viewportHeight: 960
+
+tasks:
+  - name: "descriptive task name"
+    flow:
+      - aiTap: "element description"
+      - aiInput: 'text value'
+        locate: 'input field description'
+      - aiScroll:
+        direction: down/up
+        scrollType: untilBottom/untilTop/page
+      - aiAssert: "expected state"
+      - sleep: milliseconds
+
+2. Action Types:
+- aiTap: for clicks (natural language targeting)
+- aiInput: for text input with 'locate' field
+- aiScroll: with direction and scrollType
+- aiAssert: for validations
+- sleep: for delays (milliseconds)
+
+3. Best Practices:
+- Group related actions into logical tasks
+- Use natural language descriptions
+- Add deepThink: true for complex interactions
+- Keep task names concise but descriptive
+
+
+
+YAML type
+tasks:
+  - name: <name>
+    continueOnError: <boolean> # Optional, whether to continue to the next task on error, defaults to false.
+    flow:
+      # Auto Planning (.ai)
+      # ----------------
+
+      # Perform an interaction. \`ai\` is a shorthand for \`aiAction\`.
+      - ai: <prompt>
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # This usage is the same as \`ai\`.
+      - aiAction: <prompt>
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # Instant Action (.aiTap, .aiDoubleClick, .aiHover, .aiInput, .aiKeyboardPress, .aiScroll)
+      # ----------------
+
+      # Tap an element described by a prompt.
+      - aiTap: <prompt>
+        deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # Double click an element described by a prompt.
+      - aiDoubleClick: <prompt>
+        deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # Hover over an element described by a prompt.
+      - aiHover: <prompt>
+        deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # Input text into an element described by a prompt.
+      - aiInput: <final text content of the input>
+        locate: <prompt>
+        deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # Press a key (e.g., Enter, Tab, Escape) on an element described by a prompt.
+      - aiKeyboardPress: <key>
+        locate: <prompt>
+        deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # Scroll globally or on an element described by a prompt.
+      - aiScroll:
+        direction: 'up' # or 'down' | 'left' | 'right'
+        scrollType: 'once' # or 'untilTop' | 'untilBottom' | 'untilLeft' | 'untilRight'
+        distance: <number> # Optional, the scroll distance in pixels.
+        locate: <prompt> # Optional, the element to scroll on.
+        deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+
+      # Log the current screenshot with a description in the report file.
+      - logScreenshot: <title> # Optional, the title of the screenshot. If not provided, the title will be 'untitled'.
+        content: <content> # Optional, the description of the screenshot.
+
+      # Data Extraction
+      # ----------------
+
+      # Perform a query that returns a JSON object.
+      - aiQuery: <prompt> # Remember to describe the format of the result in the prompt.
+        name: <name> # The key for the query result in the JSON output.
+
+      # More APIs
+      # ----------------
+
+      # Wait for a condition to be met, with a timeout (in ms, optional, defaults to 30000).
+      - aiWaitFor: <prompt>
+        timeout: <ms>
+
+      # Perform an assertion.
+      - aiAssert: <prompt>
+        errorMessage: <error-message> # Optional, the error message to print if the assertion fails.
+
+      # Wait for a specified amount of time.
+      - sleep: <ms>
+
+      # Execute a piece of JavaScript code in the web page context.
+      - javascript: <javascript>
+        name: <name> # Optional, assign a name to the return value, which will be used as a key in the JSON output.
+
+  - name: <name>
+    flow:
+      # ...
+`;
+exports.PLAYWRIGHT_EXAMPLE_CODE = __webpack_exports__.PLAYWRIGHT_EXAMPLE_CODE;
+exports.YAML_EXAMPLE_CODE = __webpack_exports__.YAML_EXAMPLE_CODE;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "PLAYWRIGHT_EXAMPLE_CODE",
+    "YAML_EXAMPLE_CODE"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});