add read content to locate element utility

src/Infrastructure/BotSharp.Abstraction/Browsing/Models/ElementLocatingArgs.cs

@@ -36,4 +36,6 @@ public class ElementLocatingArgs
     /// </summary>
     public bool Highlight { get; set; }
     public string HighlightColor { get; set; } = "red";
+    [JsonPropertyName("is_read_content")]
+    public bool IsReadContent { get;set; }
 }

src/Plugins/BotSharp.Plugin.WebDriver/UtilFunctions/UtilWebLocateElementFn.cs

@@ -32,7 +32,11 @@ public class UtilWebLocateElementFn : IFunctionCallback
         };
         var result = await browser.LocateElement(msg, locatorArgs);
 
-        message.Content = $"Locating element {(result.IsSuccess ? "success" : "failed")}";
+        message.Content = $"Locating element {(result.IsSuccess ? "success" : "failed")}. ";
+        if (locatorArgs.IsReadContent && result.IsSuccess && !string.IsNullOrWhiteSpace(result.Body))
+        {
+            message.Content += $"Content is: \n{result.Body}";
+        }
 
         var path = webDriverService.GetScreenshotFilePath(message.MessageId);
 

src/Plugins/BotSharp.Plugin.WebDriver/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-web-locate_element.json

@@ -7,6 +7,10 @@
       "selector": {
         "type": "string",
         "description": "element selector in XPath, use syntax of Playwright in .NET"
+      },
+      "is_read_content": {
+        "type": "boolean",
+        "description": "read the content"
       }
     },
     "required": [ "selector" ]