@midscene/web 0.25.1 → 0.25.2-beta-20250806064106.0

package/dist/es/agent.js

@@ -585,7 +585,7 @@ import yaml3 from "js-yaml";
 import semver from "semver";
 
 // package.json
-var version = "0.25.1";
+var version = "0.25.2-beta-20250806064106.0";
 
 // src/common/task-cache.ts
 var DEFAULT_CACHE_MAX_FILENAME_LENGTH = 200;
@@ -1068,7 +1068,7 @@ var PageTaskExecutor = class {
             };
             this.insight.onceDumpUpdatedFn = dumpCollector;
             const shotTime = Date.now();
-            const pageContext = await this.insight.contextRetrieverFn("locate");
+            const pageContext = param?.pageContext || await this.insight.contextRetrieverFn("locate");
             task.pageContext = pageContext;
             const recordItem = {
               type: "screenshot",
@@ -2184,6 +2184,10 @@ var PageAgent = class {
      */
     this.dryMode = false;
     this.destroyed = false;
+    /**
+     * Flag to indicate if page context is frozen
+     */
+    this.isPageContextFrozen = false;
     this.page = page;
     this.opts = Object.assign(
       {
@@ -2228,6 +2232,9 @@ var PageAgent = class {
       ignoreMarker: !!vlLocateMode()
     });
   }
+  async _snapshotContext() {
+    return await this.getUIContext("locate");
+  }
   async setAIActionContext(prompt) {
     this.opts.aiActionContext = prompt;
   }
@@ -2296,7 +2303,8 @@ ${errorTask?.errorStack}`, {
   }
   buildDetailedLocateParam(locatePrompt, opt) {
     assert7(locatePrompt, "missing locate prompt");
-    if (typeof opt === "object") {
+    const pageContext = this.isPageContextFrozen ? this.frozenPageContext : void 0;
+    if (typeof opt === "object" && opt !== null) {
       const prompt = locatePrompt;
       const deepThink = opt.deepThink ?? false;
       const cacheable = opt.cacheable ?? true;
@@ -2305,11 +2313,13 @@ ${errorTask?.errorStack}`, {
         prompt,
         deepThink,
         cacheable,
-        xpath
+        xpath,
+        pageContext
       };
     }
     return {
-      prompt: locatePrompt
+      prompt: locatePrompt,
+      pageContext
     };
   }
   async aiTap(locatePrompt, opt) {
@@ -2688,6 +2698,23 @@ ${errors}`);
       executions: newExecutions
     };
   }
+  /**
+   * Freezes the current page context to be reused in subsequent AI operations
+   * This avoids recalculating page context for each operation
+   */
+  async freezePageContext() {
+    const context = await this._snapshotContext();
+    context._isFrozen = true;
+    this.frozenPageContext = context;
+    this.isPageContextFrozen = true;
+  }
+  /**
+   * Unfreezes the page context, allowing AI operations to calculate context dynamically
+   */
+  async unfreezePageContext() {
+    this.frozenPageContext = void 0;
+    this.isPageContextFrozen = false;
+  }
 };
 export {
   PageAgent