illuma-agents 1.0.18 → 1.0.19

package/dist/cjs/main.cjs

@@ -17,6 +17,7 @@ var Calculator = require('./tools/Calculator.cjs');
 var CodeExecutor = require('./tools/CodeExecutor.cjs');
 var ProgrammaticToolCalling = require('./tools/ProgrammaticToolCalling.cjs');
 var ToolSearchRegex = require('./tools/ToolSearchRegex.cjs');
+var BrowserTools = require('./tools/BrowserTools.cjs');
 var handlers = require('./tools/handlers.cjs');
 var tool = require('./tools/search/tool.cjs');
 var _enum = require('./common/enum.cjs');
@@ -95,6 +96,20 @@ exports.escapeRegexSpecialChars = ToolSearchRegex.escapeRegexSpecialChars;
 exports.hasNestedQuantifiers = ToolSearchRegex.hasNestedQuantifiers;
 exports.isDangerousPattern = ToolSearchRegex.isDangerousPattern;
 exports.sanitizeRegex = ToolSearchRegex.sanitizeRegex;
+exports.BROWSER_TOOL_NAMES = BrowserTools.BROWSER_TOOL_NAMES;
+exports.EBrowserTools = BrowserTools.EBrowserTools;
+exports.createBrowserClickTool = BrowserTools.createBrowserClickTool;
+exports.createBrowserExtractTool = BrowserTools.createBrowserExtractTool;
+exports.createBrowserGoBackTool = BrowserTools.createBrowserGoBackTool;
+exports.createBrowserHoverTool = BrowserTools.createBrowserHoverTool;
+exports.createBrowserNavigateTool = BrowserTools.createBrowserNavigateTool;
+exports.createBrowserScreenshotTool = BrowserTools.createBrowserScreenshotTool;
+exports.createBrowserScrollTool = BrowserTools.createBrowserScrollTool;
+exports.createBrowserTools = BrowserTools.createBrowserTools;
+exports.createBrowserTypeTool = BrowserTools.createBrowserTypeTool;
+exports.createBrowserWaitTool = BrowserTools.createBrowserWaitTool;
+exports.hasBrowserCapability = BrowserTools.hasBrowserCapability;
+exports.isBrowserToolCall = BrowserTools.isBrowserToolCall;
 exports.handleServerToolResult = handlers.handleServerToolResult;
 exports.handleToolCallChunks = handlers.handleToolCallChunks;
 exports.handleToolCalls = handlers.handleToolCalls;

package/dist/cjs/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"main.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/tools/BrowserTools.cjs

@@ -0,0 +1,473 @@
+'use strict';
+
+var zod = require('zod');
+var tools = require('@langchain/core/tools');
+
+/**
+ * Browser Automation Tools for Ranger Browser Extension
+ *
+ * These tools allow the LLM to interact with the browser through the
+ * ranger-browser extension. They generate structured actions that are
+ * sent to the extension via SSE streaming for execution.
+ *
+ * The extension handles:
+ * - DOM extraction with element indexing
+ * - Click, type, hover, scroll actions
+ * - Navigation and page context
+ * - Visual element highlighting
+ */
+// ============================================
+// Tool Schemas
+// ============================================
+/**
+ * Enhanced click schema that supports both index-based and coordinate-based clicking
+ */
+const BrowserClickSchema = zod.z.object({
+    index: zod.z.number().optional().describe('The index of the element to click, as shown in the page context (e.g., [0], [1], [2]). ' +
+        'Use the element index from the interactive elements list provided in the page context. ' +
+        'Either index OR coordinates must be provided.'),
+    coordinates: zod.z.object({
+        x: zod.z.number().describe('X coordinate in viewport pixels'),
+        y: zod.z.number().describe('Y coordinate in viewport pixels'),
+    }).optional().describe('Coordinates for clicking elements that lack semantic info (marked with ⚠️). ' +
+        'The coordinates are provided in the element listing as coords:(x,y). ' +
+        'Either index OR coordinates must be provided.'),
+    visualDescription: zod.z.string().optional().describe('Description of what the element looks like visually. Used when clicking by appearance ' +
+        '(e.g., "blue button in top right corner", "hamburger menu icon")'),
+    reason: zod.z.string().optional().describe('Brief explanation of why you are clicking this element (for user transparency)'),
+});
+const BrowserTypeSchema = zod.z.object({
+    index: zod.z.number().describe('The index of the input element to type into, as shown in the page context'),
+    text: zod.z.string().describe('The text to type into the input field'),
+    clear: zod.z.boolean().optional().describe('Whether to clear the existing content before typing (default: false)'),
+    pressEnter: zod.z.boolean().optional().describe('Whether to press Enter after typing (useful for search fields, default: false)'),
+});
+const BrowserNavigateSchema = zod.z.object({
+    url: zod.z.string().describe('The URL to navigate to. Can be a full URL or a relative path.'),
+    reason: zod.z.string().optional().describe('Brief explanation of why you are navigating to this URL'),
+});
+const BrowserScrollSchema = zod.z.object({
+    direction: zod.z.enum(['up', 'down', 'left', 'right']).describe('The direction to scroll'),
+    amount: zod.z.number().optional().describe('The amount to scroll in pixels (default: 500)'),
+});
+const BrowserExtractSchema = zod.z.object({
+    query: zod.z.string().optional().describe('Optional query to filter extracted content. If provided, only content related to the query will be extracted.'),
+    selector: zod.z.string().optional().describe('Optional CSS selector to extract content from a specific element'),
+});
+const BrowserHoverSchema = zod.z.object({
+    index: zod.z.number().describe('The index of the element to hover over, as shown in the page context'),
+});
+const BrowserWaitSchema = zod.z.object({
+    duration: zod.z.number().optional().describe('Duration to wait in milliseconds (default: 1000)'),
+    reason: zod.z.string().optional().describe('Why we are waiting (e.g., "for page to load", "for animation to complete")'),
+});
+const BrowserGoBackSchema = zod.z.object({
+    reason: zod.z.string().optional().describe('Brief explanation of why you are going back'),
+});
+const BrowserScreenshotSchema = zod.z.object({
+    fullPage: zod.z.boolean().optional().describe('Whether to capture the full page or just the viewport (default: viewport only)'),
+    reason: zod.z.string().optional().describe('Why you need a screenshot (e.g., "to identify visual elements", "to analyze page layout")'),
+});
+// ============================================
+// Tool Implementations
+// ============================================
+/**
+ * Browser click tool - clicks an element by index or coordinates
+ * Supports both semantic (index-based) and vision (coordinate-based) clicking
+ */
+function createBrowserClickTool() {
+    return tools.tool(async ({ index, coordinates, visualDescription, reason }) => {
+        // Validate that at least one targeting method is provided
+        if (index === undefined && !coordinates) {
+            return JSON.stringify({
+                type: 'error',
+                error: 'Either index or coordinates must be provided to click an element',
+            });
+        }
+        // Return a structured action for the extension to execute
+        // The actual execution happens in the browser extension
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'click',
+                ...(index !== undefined && { index }),
+                ...(coordinates && { coordinates }),
+                ...(visualDescription && { visualDescription }),
+                reason,
+            },
+            // Signal that this requires browser execution
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.CLICK,
+        description: `Click an interactive element on the current page.
+
+**Two ways to target elements:**
+
+1. **By index (preferred)**: Use the element's index number from the interactive elements list
+   - Format: [index] {semantic role} <tag>text</tag>
+   - Example: browser_click({ index: 5 }) to click element [5]
+
+2. **By coordinates (vision fallback)**: For elements marked with ⚠️ that lack semantic info
+   - Use the coords:(x,y) shown after the ⚠️ marker
+   - Example: browser_click({ coordinates: { x: 150, y: 200 } })
+
+**When to use coordinates:**
+- Elements marked with ⚠️ have poor semantic understanding
+- Icon-only buttons without labels
+- Custom canvas/SVG elements
+- When you identify an element visually in a screenshot
+
+Example: If element shows \`[12] {button} <div>⚠️ [left side, small, clickable] coords:(45,120)\`
+Use either: browser_click({ index: 12 }) or browser_click({ coordinates: { x: 45, y: 120 } })`,
+        schema: BrowserClickSchema,
+    });
+}
+/**
+ * Browser type tool - types text into an input field
+ */
+function createBrowserTypeTool() {
+    return tools.tool(async ({ index, text, clear, pressEnter }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'type',
+                index,
+                text,
+                clear: clear ?? false,
+                pressEnter: pressEnter ?? false,
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.TYPE,
+        description: `Type text into an input field on the current page.
+
+Use this tool when you need to:
+- Fill in a text input or textarea
+- Enter a search query
+- Fill out form fields
+
+The element index comes from the page context's interactive elements list.
+Set 'clear: true' to clear existing content before typing.
+Set 'pressEnter: true' to submit after typing (useful for search fields).
+
+Example: To type "hello world" into a search field shown as "[2]<input>Search...</input>",
+use index: 2, text: "hello world"`,
+        schema: BrowserTypeSchema,
+    });
+}
+/**
+ * Browser navigate tool - navigates to a URL
+ */
+function createBrowserNavigateTool() {
+    return tools.tool(async ({ url, reason }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'navigate',
+                url,
+                reason,
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.NAVIGATE,
+        description: `Navigate to a specific URL in the browser.
+
+Use this tool when you need to:
+- Go to a specific website
+- Navigate to a different page
+- Open a new URL
+
+Provide the full URL including the protocol (https://).
+
+Example: browser_navigate({ url: "https://www.google.com" })`,
+        schema: BrowserNavigateSchema,
+    });
+}
+/**
+ * Browser scroll tool - scrolls the page
+ */
+function createBrowserScrollTool() {
+    return tools.tool(async ({ direction, amount }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'scroll',
+                scroll: {
+                    direction,
+                    amount: amount ?? 500,
+                },
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.SCROLL,
+        description: `Scroll the current page in a specified direction.
+
+Use this tool when you need to:
+- See more content on the page
+- Scroll to find elements not currently visible
+- Navigate long pages
+
+Default scroll amount is 500 pixels. Adjust as needed.
+
+Example: browser_scroll({ direction: "down", amount: 800 })`,
+        schema: BrowserScrollSchema,
+    });
+}
+/**
+ * Browser extract tool - extracts content from the page
+ */
+function createBrowserExtractTool() {
+    return tools.tool(async ({ query, selector }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'extract',
+                query,
+                selector,
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.EXTRACT,
+        description: `Extract text content from the current page.
+
+Use this tool when you need to:
+- Get specific information from the page
+- Extract text that matches a query
+- Read content from a specific element
+
+If no query or selector is provided, extracts the main page content.
+Use a CSS selector to extract from a specific element.
+Use a query to filter for relevant content.
+
+Example: browser_extract({ query: "price" }) - extracts content related to pricing`,
+        schema: BrowserExtractSchema,
+    });
+}
+/**
+ * Browser hover tool - hovers over an element
+ */
+function createBrowserHoverTool() {
+    return tools.tool(async ({ index }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'hover',
+                index,
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.HOVER,
+        description: `Hover over an element to reveal tooltips or dropdown menus.
+
+Use this tool when you need to:
+- Reveal a dropdown menu
+- Show a tooltip
+- Trigger hover effects
+
+Example: browser_hover({ index: 3 }) - hovers over element at index 3`,
+        schema: BrowserHoverSchema,
+    });
+}
+/**
+ * Browser wait tool - waits for a specified duration
+ */
+function createBrowserWaitTool() {
+    return tools.tool(async ({ duration, reason }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'wait',
+                duration: duration ?? 1000,
+                reason,
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.WAIT,
+        description: `Wait for a specified duration before the next action.
+
+Use this tool when you need to:
+- Wait for a page to load
+- Wait for an animation to complete
+- Add delay between actions
+
+Default wait time is 1000ms (1 second).
+
+Example: browser_wait({ duration: 2000, reason: "waiting for page to load" })`,
+        schema: BrowserWaitSchema,
+    });
+}
+/**
+ * Browser go back tool - navigates back in history
+ */
+function createBrowserGoBackTool() {
+    return tools.tool(async ({ reason }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'back',
+                reason,
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.BACK,
+        description: `Navigate back to the previous page in browser history.
+
+Use this tool when you need to:
+- Return to a previous page
+- Undo a navigation
+
+Example: browser_back({ reason: "returning to search results" })`,
+        schema: BrowserGoBackSchema,
+    });
+}
+/**
+ * Browser screenshot tool - captures a screenshot
+ */
+function createBrowserScreenshotTool() {
+    return tools.tool(async ({ fullPage }) => {
+        return JSON.stringify({
+            type: 'browser_action',
+            action: {
+                type: 'screenshot',
+                fullPage: fullPage ?? false,
+            },
+            requiresBrowserExecution: true,
+        });
+    }, {
+        name: EBrowserTools.SCREENSHOT,
+        description: `Capture a screenshot of the current page.
+
+Use this tool when you need to:
+- Capture the current state of a page
+- Document visual elements
+- Verify page appearance
+
+Set fullPage: true to capture the entire page (may be large).
+Default captures only the visible viewport.
+
+Example: browser_screenshot({ fullPage: false })`,
+        schema: BrowserScreenshotSchema,
+    });
+}
+/**
+ * Create all browser automation tools
+ *
+ * IMPORTANT: These tools should ONLY be registered when:
+ * 1. The request comes from a browser extension that can execute them
+ * 2. The client has indicated browser capability (e.g., via header or parameter)
+ *
+ * DO NOT register these for normal web UI users - they cannot execute browser actions.
+ *
+ * Detection in Ranger API:
+ * - Check for `X-Ranger-Browser-Extension: true` header
+ * - Or check for `browserCapable: true` in request body
+ * - Or check user agent for extension identifier
+ *
+ * @example
+ * // In Ranger API endpoint:
+ * const hasBrowserExtension = req.headers['x-ranger-browser-extension'] === 'true';
+ * const tools = hasBrowserExtension
+ *   ? [...normalTools, ...createBrowserTools()]
+ *   : normalTools;
+ */
+function createBrowserTools(config = {}) {
+    const tools = [];
+    // Enable all by default
+    const { enableClick = true, enableType = true, enableNavigate = true, enableScroll = true, enableExtract = true, enableHover = true, enableWait = true, enableBack = true, enableScreenshot = true, } = config;
+    if (enableClick)
+        tools.push(createBrowserClickTool());
+    if (enableType)
+        tools.push(createBrowserTypeTool());
+    if (enableNavigate)
+        tools.push(createBrowserNavigateTool());
+    if (enableScroll)
+        tools.push(createBrowserScrollTool());
+    if (enableExtract)
+        tools.push(createBrowserExtractTool());
+    if (enableHover)
+        tools.push(createBrowserHoverTool());
+    if (enableWait)
+        tools.push(createBrowserWaitTool());
+    if (enableBack)
+        tools.push(createBrowserGoBackTool());
+    if (enableScreenshot)
+        tools.push(createBrowserScreenshotTool());
+    return tools;
+}
+/**
+ * Browser tool name constants
+ * Use these instead of magic strings
+ */
+const EBrowserTools = {
+    CLICK: 'browser_click',
+    TYPE: 'browser_type',
+    NAVIGATE: 'browser_navigate',
+    SCROLL: 'browser_scroll',
+    EXTRACT: 'browser_extract',
+    HOVER: 'browser_hover',
+    WAIT: 'browser_wait',
+    BACK: 'browser_back',
+    SCREENSHOT: 'browser_screenshot',
+};
+/**
+ * Get browser tool names for filtering/identification
+ */
+const BROWSER_TOOL_NAMES = [
+    EBrowserTools.CLICK,
+    EBrowserTools.TYPE,
+    EBrowserTools.NAVIGATE,
+    EBrowserTools.SCROLL,
+    EBrowserTools.EXTRACT,
+    EBrowserTools.HOVER,
+    EBrowserTools.WAIT,
+    EBrowserTools.BACK,
+    EBrowserTools.SCREENSHOT,
+];
+/**
+ * Check if a tool call is a browser action
+ */
+function isBrowserToolCall(toolName) {
+    return BROWSER_TOOL_NAMES.includes(toolName);
+}
+/**
+ * Check if request indicates browser extension capability
+ * Use this to conditionally register browser tools
+ *
+ * @example
+ * // In Express middleware or endpoint:
+ * if (hasBrowserCapability(req.headers)) {
+ *   tools.push(...createBrowserTools());
+ * }
+ */
+function hasBrowserCapability(headers) {
+    const extensionHeader = headers['x-ranger-browser-extension'];
+    const capableHeader = headers['x-ranger-browser-capable'];
+    return (extensionHeader === 'true' ||
+        capableHeader === 'true' ||
+        (Array.isArray(extensionHeader) && extensionHeader.includes('true')) ||
+        (Array.isArray(capableHeader) && capableHeader.includes('true')));
+}
+
+exports.BROWSER_TOOL_NAMES = BROWSER_TOOL_NAMES;
+exports.EBrowserTools = EBrowserTools;
+exports.createBrowserClickTool = createBrowserClickTool;
+exports.createBrowserExtractTool = createBrowserExtractTool;
+exports.createBrowserGoBackTool = createBrowserGoBackTool;
+exports.createBrowserHoverTool = createBrowserHoverTool;
+exports.createBrowserNavigateTool = createBrowserNavigateTool;
+exports.createBrowserScreenshotTool = createBrowserScreenshotTool;
+exports.createBrowserScrollTool = createBrowserScrollTool;
+exports.createBrowserTools = createBrowserTools;
+exports.createBrowserTypeTool = createBrowserTypeTool;
+exports.createBrowserWaitTool = createBrowserWaitTool;
+exports.hasBrowserCapability = hasBrowserCapability;
+exports.isBrowserToolCall = isBrowserToolCall;
+//# sourceMappingURL=BrowserTools.cjs.map

package/dist/cjs/tools/BrowserTools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserTools.cjs","sources":["../../../src/tools/BrowserTools.ts"],"sourcesContent":["/**\r\n * Browser Automation Tools for Ranger Browser Extension\r\n * \r\n * These tools allow the LLM to interact with the browser through the \r\n * ranger-browser extension. They generate structured actions that are\r\n * sent to the extension via SSE streaming for execution.\r\n * \r\n * The extension handles:\r\n * - DOM extraction with element indexing\r\n * - Click, type, hover, scroll actions\r\n * - Navigation and page context\r\n * - Visual element highlighting\r\n */\r\n\r\nimport { z } from 'zod';\r\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\r\n\r\n// ============================================\r\n// Tool Schemas\r\n// ============================================\r\n\r\n/**\r\n * Enhanced click schema that supports both index-based and coordinate-based clicking\r\n */\r\nconst BrowserClickSchema = z.object({\r\n  index: z.number().optional().describe(\r\n    'The index of the element to click, as shown in the page context (e.g., [0], [1], [2]). ' +\r\n    'Use the element index from the interactive elements list provided in the page context. ' +\r\n    'Either index OR coordinates must be provided.'\r\n  ),\r\n  coordinates: z.object({\r\n    x: z.number().describe('X coordinate in viewport pixels'),\r\n    y: z.number().describe('Y coordinate in viewport pixels'),\r\n  }).optional().describe(\r\n    'Coordinates for clicking elements that lack semantic info (marked with ⚠️). ' +\r\n    'The coordinates are provided in the element listing as coords:(x,y). ' +\r\n    'Either index OR coordinates must be provided.'\r\n  ),\r\n  visualDescription: z.string().optional().describe(\r\n    'Description of what the element looks like visually. Used when clicking by appearance ' +\r\n    '(e.g., \"blue button in top right corner\", \"hamburger menu icon\")'\r\n  ),\r\n  reason: z.string().optional().describe(\r\n    'Brief explanation of why you are clicking this element (for user transparency)'\r\n  ),\r\n});\r\n\r\nconst BrowserTypeSchema = z.object({\r\n  index: z.number().describe(\r\n    'The index of the input element to type into, as shown in the page context'\r\n  ),\r\n  text: z.string().describe(\r\n    'The text to type into the input field'\r\n  ),\r\n  clear: z.boolean().optional().describe(\r\n    'Whether to clear the existing content before typing (default: false)'\r\n  ),\r\n  pressEnter: z.boolean().optional().describe(\r\n    'Whether to press Enter after typing (useful for search fields, default: false)'\r\n  ),\r\n});\r\n\r\nconst BrowserNavigateSchema = z.object({\r\n  url: z.string().describe(\r\n    'The URL to navigate to. Can be a full URL or a relative path.'\r\n  ),\r\n  reason: z.string().optional().describe(\r\n    'Brief explanation of why you are navigating to this URL'\r\n  ),\r\n});\r\n\r\nconst BrowserScrollSchema = z.object({\r\n  direction: z.enum(['up', 'down', 'left', 'right']).describe(\r\n    'The direction to scroll'\r\n  ),\r\n  amount: z.number().optional().describe(\r\n    'The amount to scroll in pixels (default: 500)'\r\n  ),\r\n});\r\n\r\nconst BrowserExtractSchema = z.object({\r\n  query: z.string().optional().describe(\r\n    'Optional query to filter extracted content. If provided, only content related to the query will be extracted.'\r\n  ),\r\n  selector: z.string().optional().describe(\r\n    'Optional CSS selector to extract content from a specific element'\r\n  ),\r\n});\r\n\r\nconst BrowserHoverSchema = z.object({\r\n  index: z.number().describe(\r\n    'The index of the element to hover over, as shown in the page context'\r\n  ),\r\n});\r\n\r\nconst BrowserWaitSchema = z.object({\r\n  duration: z.number().optional().describe(\r\n    'Duration to wait in milliseconds (default: 1000)'\r\n  ),\r\n  reason: z.string().optional().describe(\r\n    'Why we are waiting (e.g., \"for page to load\", \"for animation to complete\")'\r\n  ),\r\n});\r\n\r\nconst BrowserGoBackSchema = z.object({\r\n  reason: z.string().optional().describe(\r\n    'Brief explanation of why you are going back'\r\n  ),\r\n});\r\n\r\nconst BrowserScreenshotSchema = z.object({\r\n  fullPage: z.boolean().optional().describe(\r\n    'Whether to capture the full page or just the viewport (default: viewport only)'\r\n  ),\r\n  reason: z.string().optional().describe(\r\n    'Why you need a screenshot (e.g., \"to identify visual elements\", \"to analyze page layout\")'\r\n  ),\r\n});\r\n\r\n// ============================================\r\n// Tool Implementations\r\n// ============================================\r\n\r\n/**\r\n * Browser click tool - clicks an element by index or coordinates\r\n * Supports both semantic (index-based) and vision (coordinate-based) clicking\r\n */\r\nexport function createBrowserClickTool(): DynamicStructuredTool<typeof BrowserClickSchema> {\r\n  return tool<typeof BrowserClickSchema>(\r\n    async ({ index, coordinates, visualDescription, reason }) => {\r\n      // Validate that at least one targeting method is provided\r\n      if (index === undefined && !coordinates) {\r\n        return JSON.stringify({\r\n          type: 'error',\r\n          error: 'Either index or coordinates must be provided to click an element',\r\n        });\r\n      }\r\n\r\n      // Return a structured action for the extension to execute\r\n      // The actual execution happens in the browser extension\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'click',\r\n          ...(index !== undefined && { index }),\r\n          ...(coordinates && { coordinates }),\r\n          ...(visualDescription && { visualDescription }),\r\n          reason,\r\n        },\r\n        // Signal that this requires browser execution\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.CLICK,\r\n      description: `Click an interactive element on the current page.\r\n\r\n**Two ways to target elements:**\r\n\r\n1. **By index (preferred)**: Use the element's index number from the interactive elements list\r\n   - Format: [index] {semantic role} <tag>text</tag>\r\n   - Example: browser_click({ index: 5 }) to click element [5]\r\n\r\n2. **By coordinates (vision fallback)**: For elements marked with ⚠️ that lack semantic info\r\n   - Use the coords:(x,y) shown after the ⚠️ marker\r\n   - Example: browser_click({ coordinates: { x: 150, y: 200 } })\r\n\r\n**When to use coordinates:**\r\n- Elements marked with ⚠️ have poor semantic understanding\r\n- Icon-only buttons without labels\r\n- Custom canvas/SVG elements\r\n- When you identify an element visually in a screenshot\r\n\r\nExample: If element shows \\`[12] {button} <div>⚠️ [left side, small, clickable] coords:(45,120)\\`\r\nUse either: browser_click({ index: 12 }) or browser_click({ coordinates: { x: 45, y: 120 } })`,\r\n      schema: BrowserClickSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser type tool - types text into an input field\r\n */\r\nexport function createBrowserTypeTool(): DynamicStructuredTool<typeof BrowserTypeSchema> {\r\n  return tool<typeof BrowserTypeSchema>(\r\n    async ({ index, text, clear, pressEnter }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'type',\r\n          index,\r\n          text,\r\n          clear: clear ?? false,\r\n          pressEnter: pressEnter ?? false,\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.TYPE,\r\n      description: `Type text into an input field on the current page.\r\n\r\nUse this tool when you need to:\r\n- Fill in a text input or textarea\r\n- Enter a search query\r\n- Fill out form fields\r\n\r\nThe element index comes from the page context's interactive elements list.\r\nSet 'clear: true' to clear existing content before typing.\r\nSet 'pressEnter: true' to submit after typing (useful for search fields).\r\n\r\nExample: To type \"hello world\" into a search field shown as \"[2]<input>Search...</input>\",\r\nuse index: 2, text: \"hello world\"`,\r\n      schema: BrowserTypeSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser navigate tool - navigates to a URL\r\n */\r\nexport function createBrowserNavigateTool(): DynamicStructuredTool<typeof BrowserNavigateSchema> {\r\n  return tool<typeof BrowserNavigateSchema>(\r\n    async ({ url, reason }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'navigate',\r\n          url,\r\n          reason,\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.NAVIGATE,\r\n      description: `Navigate to a specific URL in the browser.\r\n\r\nUse this tool when you need to:\r\n- Go to a specific website\r\n- Navigate to a different page\r\n- Open a new URL\r\n\r\nProvide the full URL including the protocol (https://).\r\n\r\nExample: browser_navigate({ url: \"https://www.google.com\" })`,\r\n      schema: BrowserNavigateSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser scroll tool - scrolls the page\r\n */\r\nexport function createBrowserScrollTool(): DynamicStructuredTool<typeof BrowserScrollSchema> {\r\n  return tool<typeof BrowserScrollSchema>(\r\n    async ({ direction, amount }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'scroll',\r\n          scroll: {\r\n            direction,\r\n            amount: amount ?? 500,\r\n          },\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.SCROLL,\r\n      description: `Scroll the current page in a specified direction.\r\n\r\nUse this tool when you need to:\r\n- See more content on the page\r\n- Scroll to find elements not currently visible\r\n- Navigate long pages\r\n\r\nDefault scroll amount is 500 pixels. Adjust as needed.\r\n\r\nExample: browser_scroll({ direction: \"down\", amount: 800 })`,\r\n      schema: BrowserScrollSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser extract tool - extracts content from the page\r\n */\r\nexport function createBrowserExtractTool(): DynamicStructuredTool<typeof BrowserExtractSchema> {\r\n  return tool<typeof BrowserExtractSchema>(\r\n    async ({ query, selector }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'extract',\r\n          query,\r\n          selector,\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.EXTRACT,\r\n      description: `Extract text content from the current page.\r\n\r\nUse this tool when you need to:\r\n- Get specific information from the page\r\n- Extract text that matches a query\r\n- Read content from a specific element\r\n\r\nIf no query or selector is provided, extracts the main page content.\r\nUse a CSS selector to extract from a specific element.\r\nUse a query to filter for relevant content.\r\n\r\nExample: browser_extract({ query: \"price\" }) - extracts content related to pricing`,\r\n      schema: BrowserExtractSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser hover tool - hovers over an element\r\n */\r\nexport function createBrowserHoverTool(): DynamicStructuredTool<typeof BrowserHoverSchema> {\r\n  return tool<typeof BrowserHoverSchema>(\r\n    async ({ index }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'hover',\r\n          index,\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.HOVER,\r\n      description: `Hover over an element to reveal tooltips or dropdown menus.\r\n\r\nUse this tool when you need to:\r\n- Reveal a dropdown menu\r\n- Show a tooltip\r\n- Trigger hover effects\r\n\r\nExample: browser_hover({ index: 3 }) - hovers over element at index 3`,\r\n      schema: BrowserHoverSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser wait tool - waits for a specified duration\r\n */\r\nexport function createBrowserWaitTool(): DynamicStructuredTool<typeof BrowserWaitSchema> {\r\n  return tool<typeof BrowserWaitSchema>(\r\n    async ({ duration, reason }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'wait',\r\n          duration: duration ?? 1000,\r\n          reason,\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.WAIT,\r\n      description: `Wait for a specified duration before the next action.\r\n\r\nUse this tool when you need to:\r\n- Wait for a page to load\r\n- Wait for an animation to complete\r\n- Add delay between actions\r\n\r\nDefault wait time is 1000ms (1 second).\r\n\r\nExample: browser_wait({ duration: 2000, reason: \"waiting for page to load\" })`,\r\n      schema: BrowserWaitSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser go back tool - navigates back in history\r\n */\r\nexport function createBrowserGoBackTool(): DynamicStructuredTool<typeof BrowserGoBackSchema> {\r\n  return tool<typeof BrowserGoBackSchema>(\r\n    async ({ reason }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'back',\r\n          reason,\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.BACK,\r\n      description: `Navigate back to the previous page in browser history.\r\n\r\nUse this tool when you need to:\r\n- Return to a previous page\r\n- Undo a navigation\r\n\r\nExample: browser_back({ reason: \"returning to search results\" })`,\r\n      schema: BrowserGoBackSchema,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Browser screenshot tool - captures a screenshot\r\n */\r\nexport function createBrowserScreenshotTool(): DynamicStructuredTool<typeof BrowserScreenshotSchema> {\r\n  return tool<typeof BrowserScreenshotSchema>(\r\n    async ({ fullPage }) => {\r\n      return JSON.stringify({\r\n        type: 'browser_action',\r\n        action: {\r\n          type: 'screenshot',\r\n          fullPage: fullPage ?? false,\r\n        },\r\n        requiresBrowserExecution: true,\r\n      });\r\n    },\r\n    {\r\n      name: EBrowserTools.SCREENSHOT,\r\n      description: `Capture a screenshot of the current page.\r\n\r\nUse this tool when you need to:\r\n- Capture the current state of a page\r\n- Document visual elements\r\n- Verify page appearance\r\n\r\nSet fullPage: true to capture the entire page (may be large).\r\nDefault captures only the visible viewport.\r\n\r\nExample: browser_screenshot({ fullPage: false })`,\r\n      schema: BrowserScreenshotSchema,\r\n    }\r\n  );\r\n}\r\n\r\n// ============================================\r\n// Tool Collection\r\n// ============================================\r\n\r\nexport type BrowserToolsConfig = {\r\n  /** Enable click tool */\r\n  enableClick?: boolean;\r\n  /** Enable type tool */\r\n  enableType?: boolean;\r\n  /** Enable navigate tool */\r\n  enableNavigate?: boolean;\r\n  /** Enable scroll tool */\r\n  enableScroll?: boolean;\r\n  /** Enable extract tool */\r\n  enableExtract?: boolean;\r\n  /** Enable hover tool */\r\n  enableHover?: boolean;\r\n  /** Enable wait tool */\r\n  enableWait?: boolean;\r\n  /** Enable back tool */\r\n  enableBack?: boolean;\r\n  /** Enable screenshot tool */\r\n  enableScreenshot?: boolean;\r\n};\r\n\r\n/**\r\n * Create all browser automation tools\r\n * \r\n * IMPORTANT: These tools should ONLY be registered when:\r\n * 1. The request comes from a browser extension that can execute them\r\n * 2. The client has indicated browser capability (e.g., via header or parameter)\r\n * \r\n * DO NOT register these for normal web UI users - they cannot execute browser actions.\r\n * \r\n * Detection in Ranger API:\r\n * - Check for `X-Ranger-Browser-Extension: true` header\r\n * - Or check for `browserCapable: true` in request body\r\n * - Or check user agent for extension identifier\r\n * \r\n * @example\r\n * // In Ranger API endpoint:\r\n * const hasBrowserExtension = req.headers['x-ranger-browser-extension'] === 'true';\r\n * const tools = hasBrowserExtension \r\n *   ? [...normalTools, ...createBrowserTools()]\r\n *   : normalTools;\r\n */\r\nexport function createBrowserTools(config: BrowserToolsConfig = {}): DynamicStructuredTool[] {\r\n  const tools: DynamicStructuredTool[] = [];\r\n  \r\n  // Enable all by default\r\n  const {\r\n    enableClick = true,\r\n    enableType = true,\r\n    enableNavigate = true,\r\n    enableScroll = true,\r\n    enableExtract = true,\r\n    enableHover = true,\r\n    enableWait = true,\r\n    enableBack = true,\r\n    enableScreenshot = true,\r\n  } = config;\r\n  \r\n  if (enableClick) tools.push(createBrowserClickTool());\r\n  if (enableType) tools.push(createBrowserTypeTool());\r\n  if (enableNavigate) tools.push(createBrowserNavigateTool());\r\n  if (enableScroll) tools.push(createBrowserScrollTool());\r\n  if (enableExtract) tools.push(createBrowserExtractTool());\r\n  if (enableHover) tools.push(createBrowserHoverTool());\r\n  if (enableWait) tools.push(createBrowserWaitTool());\r\n  if (enableBack) tools.push(createBrowserGoBackTool());\r\n  if (enableScreenshot) tools.push(createBrowserScreenshotTool());\r\n  \r\n  return tools;\r\n}\r\n\r\n/**\r\n * Browser tool name constants\r\n * Use these instead of magic strings\r\n */\r\nexport const EBrowserTools = {\r\n  CLICK: 'browser_click',\r\n  TYPE: 'browser_type',\r\n  NAVIGATE: 'browser_navigate',\r\n  SCROLL: 'browser_scroll',\r\n  EXTRACT: 'browser_extract',\r\n  HOVER: 'browser_hover',\r\n  WAIT: 'browser_wait',\r\n  BACK: 'browser_back',\r\n  SCREENSHOT: 'browser_screenshot',\r\n} as const;\r\n\r\n/**\r\n * Get browser tool names for filtering/identification\r\n */\r\nexport const BROWSER_TOOL_NAMES = [\r\n  EBrowserTools.CLICK,\r\n  EBrowserTools.TYPE,\r\n  EBrowserTools.NAVIGATE,\r\n  EBrowserTools.SCROLL,\r\n  EBrowserTools.EXTRACT,\r\n  EBrowserTools.HOVER,\r\n  EBrowserTools.WAIT,\r\n  EBrowserTools.BACK,\r\n  EBrowserTools.SCREENSHOT,\r\n] as const;\r\n\r\nexport type BrowserToolName = typeof BROWSER_TOOL_NAMES[number];\r\n\r\n/**\r\n * Check if a tool call is a browser action\r\n */\r\nexport function isBrowserToolCall(toolName: string): toolName is BrowserToolName {\r\n  return BROWSER_TOOL_NAMES.includes(toolName as BrowserToolName);\r\n}\r\n\r\n/**\r\n * Check if request indicates browser extension capability\r\n * Use this to conditionally register browser tools\r\n * \r\n * @example\r\n * // In Express middleware or endpoint:\r\n * if (hasBrowserCapability(req.headers)) {\r\n *   tools.push(...createBrowserTools());\r\n * }\r\n */\r\nexport function hasBrowserCapability(headers: Record<string, string | string[] | undefined>): boolean {\r\n  const extensionHeader = headers['x-ranger-browser-extension'];\r\n  const capableHeader = headers['x-ranger-browser-capable'];\r\n  \r\n  return (\r\n    extensionHeader === 'true' || \r\n    capableHeader === 'true' ||\r\n    (Array.isArray(extensionHeader) && extensionHeader.includes('true')) ||\r\n    (Array.isArray(capableHeader) && capableHeader.includes('true'))\r\n  );\r\n}\r\n"],"names":["z","tool"],"mappings":"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"}

package/dist/esm/main.mjs

@@ -15,6 +15,7 @@ export { Calculator } from './tools/Calculator.mjs';
 export { createCodeExecutionTool, getCodeBaseURL, imageExtRegex } from './tools/CodeExecutor.mjs';
 export { createProgrammaticToolCallingTool, executeTools, extractUsedToolNames, fetchSessionFiles, filterToolsByUsage, formatCompletedResponse, makeRequest, normalizeToPythonIdentifier, unwrapToolResponse } from './tools/ProgrammaticToolCalling.mjs';
 export { countNestedGroups, createToolSearchRegexTool, escapeRegexSpecialChars, hasNestedQuantifiers, isDangerousPattern, sanitizeRegex } from './tools/ToolSearchRegex.mjs';
+export { BROWSER_TOOL_NAMES, EBrowserTools, createBrowserClickTool, createBrowserExtractTool, createBrowserGoBackTool, createBrowserHoverTool, createBrowserNavigateTool, createBrowserScreenshotTool, createBrowserScrollTool, createBrowserTools, createBrowserTypeTool, createBrowserWaitTool, hasBrowserCapability, isBrowserToolCall } from './tools/BrowserTools.mjs';
 export { handleServerToolResult, handleToolCallChunks, handleToolCalls, toolResultTypes } from './tools/handlers.mjs';
 export { createSearchTool } from './tools/search/tool.mjs';
 export { Callback, CommonEvents, Constants, ContentTypes, EnvVar, GraphEvents, GraphNodeActions, GraphNodeKeys, MessageTypes, Providers, StepTypes, TitleMethod, ToolCallTypes } from './common/enum.mjs';

package/dist/esm/main.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"main.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}