@mcp-browser-kit/server 1.0.3 → 1.0.6

package/dist/main.js

@@ -9495,8 +9495,7 @@ server.tool(
   "getReadableElements",
   [
     combinationDescription,
-    "# Description",
-    "- This tool returns a list of [tag,accessible-text] pairs of elements",
+    "- Use this tool to get a list of [tag,accessible-text] pairs",
     "- Usually being called after `getTabs` to read or identify element to interact with."
   ].join("\n"),
   {
@@ -9515,20 +9514,19 @@ server.tool(
   }
 );
 server.tool(
-  "clickReadableElementAtIndex",
+  "fillTextToIndex",
   [
     combinationDescription,
-    "# Description",
-    "- This tool clicks on an element with a given index.",
-    "- Usually being called after `getReadableElements` to interact with the element.",
-    "- Can be called after `setValueToReadableElementAtIndex` to perform a submit action."
+    "- Use this tool to set value to the ReadableElement at the specified index.",
+    "- For tasks requiring user input (text, numbers, passwords, etc.), such as fill form before submit, fill text before search, fill username & password before login"
   ].join("\n"),
   {
     tabId: z.string().describe("Tab ID to evaluate the code in"),
-    index: z.number().describe("Index of the element to click")
+    index: z.number().describe("Index of the element to set value"),
+    value: z.string().describe("Value to set")
   },
-  async ({ tabId, index }) => {
-    await rpcClient.defer("clickReadableElementAtIndex", tabId, index);
+  async ({ tabId, index, value }) => {
+    await rpcClient.defer("fillTextToIndex", tabId, index, value);
     return {
       content: [
         {
@@ -9540,20 +9538,20 @@ server.tool(
   }
 );
 server.tool(
-  "setValueToReadableElementAtIndex",
+  "clickOnIndex",
   [
     combinationDescription,
-    "# Description",
-    "This tool sets the value of an element with a given index.",
-    "- Usually being called after `getReadableElements` to interact with the element."
+    "- Use this tool to click on ReadableElement at the specified index.",
+    "- For tasks that involve clicking, like buttons, links, etc.",
+    "- Usually being called after `getReadableElements` to interact with the element.",
+    "- If the task potentially requires filling inputs, use `fillTextToIndex` first."
   ].join("\n"),
   {
     tabId: z.string().describe("Tab ID to evaluate the code in"),
-    index: z.number().describe("Index of the element to set value"),
-    value: z.string().describe("Value to set")
+    index: z.number().describe("Index of the element to click")
   },
-  async ({ tabId, index, value }) => {
-    await rpcClient.defer("setValueToReadableElementAtIndex", tabId, index, value);
+  async ({ tabId, index }) => {
+    await rpcClient.defer("clickOnIndex", tabId, index);
     return {
       content: [
         {
@@ -9569,16 +9567,21 @@ server.tool(
   [
     combinationDescription,
     "# Description",
-    "This tool evaluates JavaScript code in the context of a given tab.",
-    "- Usually being called after `getReadableElements` to interact with the element.",
-    "- Use this tool as the last resort to interact with the element."
+    "- Use this tool only if action cannot be performed via series of clicks and types.",
+    "- Use this tool to evaluate a JavaScript function body in the context of the page.",
+    "- Usually being called after `getReadableElements` to interact with the element."
   ].join("\n"),
   {
     tabId: z.string().describe("Tab ID to evaluate the code in"),
-    fnCode: z.string().describe("JavaScript function to be invoked")
+    fnBodyCode: z.string().describe("A JavaScript function body to evaluate")
   },
-  async ({ tabId, index, fnCode }) => {
-    const result = await rpcClient.defer("invokeJsFn", tabId, index, fnCode);
+  async ({ tabId, index, fnBodyCode }) => {
+    const result = await rpcClient.defer(
+      "invokeJsFn",
+      tabId,
+      index,
+      fnBodyCode
+    );
     return {
       content: [
         {