feat: Default browser tool to headless mode and improve script usage guidance

- Set `headless` mode to `true` by default in `browser.tool.ts` to optimize resource usage.
- Updated `execute-script.tool.ts` with detailed instructions for appropriate usage, emphasizing alternatives for browser interaction.

Author: Winify

src/tools/browser.tool.ts

@@ -13,7 +13,7 @@ export const startBrowserToolDefinition: ToolDefinition = {
   description: 'starts a browser session (Chrome, Firefox, Edge, Safari) and sets it to the current state',
   inputSchema: {
     browser: browserSchema.describe('Browser to launch: chrome, firefox, edge, safari (default: chrome)'),
-    headless: z.boolean().optional(),
+    headless: z.boolean().optional().default(true),
     windowWidth: z.number().min(400).max(3840).optional().default(1920),
     windowHeight: z.number().min(400).max(2160).optional().default(1080),
     navigationUrl: z.string().optional().describe('URL to navigate to after starting the browser'),
@@ -51,7 +51,7 @@ export const getBrowser = () => {
 
 export const startBrowserTool: ToolCallback = async ({
   browser = 'chrome',
-  headless = false,
+  headless = true,
   windowWidth = 1920,
   windowHeight = 1080,
   navigationUrl,

src/tools/execute-script.tool.ts

@@ -8,6 +8,8 @@ export const executeScriptToolDefinition: ToolDefinition = {
   name: 'execute_script',
   description: `Executes JavaScript in browser or mobile commands via Appium.
 
+**Option B for browser interaction** — prefer get_visible_elements or click_element/set_value with a selector instead. Use execute_script only when no dedicated tool covers the action (e.g. reading computed values, triggering custom events, scrolling to a position).
+
 **Browser:** Runs JavaScript in page context. Use 'return' to get values back.
   - Example: execute_script({ script: "return document.title" })
   - Example: execute_script({ script: "return window.scrollY" })