shared_tools 0.3.1 → 0.4.1

data/lib/shared_tools/browser_tool.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/browser_tool'
+require 'shared_tools'
+require 'shared_tools/tools/browser'       # sub-tools (VisitTool, ClickTool, etc.)
+require 'shared_tools/tools/browser_tool'  # facade (BrowserTool)

data/lib/shared_tools/calculator_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/calculator_tool'
+require 'shared_tools'
+require 'shared_tools/tools/calculator_tool'

data/lib/shared_tools/clipboard_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/clipboard_tool'
+require 'shared_tools'
+require 'shared_tools/tools/clipboard_tool'

data/lib/shared_tools/composite_analysis_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/composite_analysis_tool'
+require 'shared_tools'
+require 'shared_tools/tools/composite_analysis_tool'

data/lib/shared_tools/computer_tool.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/computer_tool'
+# Note: computer.rb already loads computer_tool.rb
+require 'shared_tools'
+require 'shared_tools/tools/computer'  # platform driver + ComputerTool facade

data/lib/shared_tools/cron_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/cron_tool'
+require 'shared_tools'
+require 'shared_tools/tools/cron_tool'

data/lib/shared_tools/current_date_time_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/current_date_time_tool'
+require 'shared_tools'
+require 'shared_tools/tools/current_date_time_tool'

data/lib/shared_tools/data_science_kit.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/data_science_kit'
+require 'shared_tools'
+require 'shared_tools/tools/data_science_kit'

data/lib/shared_tools/database.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/database'
+require 'shared_tools'
+require 'shared_tools/tools/database'

data/lib/shared_tools/database_query_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/database_query_tool'
+require 'shared_tools'
+require 'shared_tools/tools/database_query_tool'

data/lib/shared_tools/database_tool.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/database_tool'
+# Note: database.rb already loads database_tool.rb
+require 'shared_tools'
+require 'shared_tools/tools/database'  # drivers + DatabaseTool facade

data/lib/shared_tools/disk_tool.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/disk_tool'
+require 'shared_tools'
+require 'shared_tools/tools/disk'       # sub-tools (FileReadTool, DirectoryListTool, etc.)
+require 'shared_tools/tools/disk_tool'  # facade (DiskTool)

data/lib/shared_tools/dns_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/dns_tool'
+require 'shared_tools'
+require 'shared_tools/tools/dns_tool'

data/lib/shared_tools/doc_tool.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/doc_tool'
+require 'shared_tools'
+require 'shared_tools/tools/doc'       # sub-tools (PdfReaderTool, TextReaderTool)
+require 'shared_tools/tools/doc_tool'  # facade (DocTool)

data/lib/shared_tools/error_handling_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/error_handling_tool'
+require 'shared_tools'
+require 'shared_tools/tools/error_handling_tool'

data/lib/shared_tools/eval_tool.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/eval_tool'
+require 'shared_tools'
+require 'shared_tools/tools/eval'       # sub-tools (RubyEvalTool, PythonEvalTool, ShellEvalTool)
+require 'shared_tools/tools/eval_tool'  # facade (EvalTool)

data/lib/shared_tools/mcp/brave_search_client.rb

@@ -0,0 +1,37 @@
+# shared_tools/mcp/brave_search_client.rb
+#
+# Brave Search MCP Server — npx auto-download (no pre-installation required)
+#
+# Provides web search and news search via the Brave Search API.
+#
+# Prerequisites:
+#   - Node.js and npx (https://nodejs.org)
+#   - A Brave Search API key (free tier available at https://brave.com/search/api/)
+#   The @modelcontextprotocol/server-brave-search package is downloaded
+#   automatically on first use via `npx -y`.
+#
+# Configuration:
+#   export BRAVE_API_KEY=your_api_key_here
+#
+# Usage:
+#   require 'shared_tools/mcp/brave_search_client'
+#   client = RubyLLM::MCP.clients["brave-search"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require_relative "../utilities"
+
+SharedTools.verify_envars("BRAVE_API_KEY")
+
+require "ruby_llm/mcp"
+
+RubyLLM::MCP.add_client(
+  name: "brave-search",
+  transport_type: :stdio,
+  config: {
+    command: "npx",
+    args:    ["-y", "@modelcontextprotocol/server-brave-search"],
+    env:     { "BRAVE_API_KEY" => ENV.fetch("BRAVE_API_KEY", "") },
+  },
+)

data/lib/shared_tools/mcp/chart_client.rb

@@ -0,0 +1,32 @@
+# shared_tools/mcp/chart_client.rb
+#
+# AntV Chart MCP Server — npx auto-download (no pre-installation required)
+#
+# Generates charts and data visualisations (bar, line, pie, scatter, heatmap, etc.)
+# from structured data. Returns chart URLs or base64-encoded images.
+#
+# Prerequisites:
+#   - Node.js and npx (https://nodejs.org)
+#   The @antv/mcp-server-chart package is downloaded automatically on first use
+#   via `npx -y`.
+#
+# No API key required.
+#
+# Usage:
+#   require 'shared_tools/mcp/chart_client'
+#   client = RubyLLM::MCP.clients["chart"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require "ruby_llm/mcp"
+
+RubyLLM::MCP.add_client(
+  name: "chart",
+  transport_type: :stdio,
+  config: {
+    command: "npx",
+    args:    ["-y", "@antv/mcp-server-chart"],
+    env:     {},
+  },
+)

data/lib/shared_tools/mcp/github_client.rb

@@ -0,0 +1,38 @@
+# shared_tools/mcp/github_client.rb
+#
+# GitHub MCP Server Client — requires brew installation
+#
+# Provides full GitHub API access: repositories, issues, pull requests,
+# code search, commits, branches, releases, and more.
+#
+# Prerequisites:
+#   - Homebrew (https://brew.sh)
+#   - A GitHub Personal Access Token
+#   The github-mcp-server binary is installed automatically via brew if missing.
+#
+# Configuration:
+#   export GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
+#
+# Usage:
+#   require 'shared_tools/mcp/github_client'
+#   client = RubyLLM::MCP.clients["github"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require_relative "../utilities"
+
+SharedTools.verify_envars("GITHUB_PERSONAL_ACCESS_TOKEN")
+SharedTools.package_install("github-mcp-server")
+
+require "ruby_llm/mcp"
+
+RubyLLM::MCP.add_client(
+  name: "github",
+  transport_type: :stdio,
+  config: {
+    command: "github-mcp-server",
+    args:    ["stdio"],
+    env:     { "GITHUB_PERSONAL_ACCESS_TOKEN" => ENV.fetch("GITHUB_PERSONAL_ACCESS_TOKEN", "") },
+  },
+)

data/lib/shared_tools/mcp/hugging_face_client.rb

@@ -0,0 +1,43 @@
+# shared_tools/mcp/hugging_face_client.rb
+#
+# Hugging Face MCP Server Client — requires brew installation
+#
+# Provides access to the Hugging Face Hub: search and inspect models,
+# datasets, and Spaces; read model cards; run inference; browse
+# trending repositories.
+#
+# Prerequisites:
+#   - Homebrew (https://brew.sh)
+#   - A Hugging Face user access token (free)
+#     Create one at https://huggingface.co/settings/tokens
+#   The hf-mcp-server binary is installed automatically via brew if missing.
+#
+# Configuration:
+#   export HF_TOKEN=hf_your_access_token_here
+#
+# Usage:
+#   require 'shared_tools/mcp/hugging_face_client'
+#   client = RubyLLM::MCP.clients["hugging-face"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require_relative "../utilities"
+
+SharedTools.verify_envars("HF_TOKEN")
+SharedTools.package_install("hf-mcp-server")
+
+require "ruby_llm/mcp"
+
+RubyLLM::MCP.add_client(
+  name: "hugging-face",
+  transport_type: :stdio,
+  config: {
+    command: "hf-mcp-server",
+    args:    [],
+    env:     {
+      "TRANSPORT"        => "stdio",
+      "DEFAULT_HF_TOKEN" => ENV.fetch("HF_TOKEN", ""),
+    },
+  },
+)

data/lib/shared_tools/mcp/memory_client.rb

@@ -0,0 +1,33 @@
+# shared_tools/mcp/memory_client.rb
+#
+# MCP Memory Server — npx auto-download (no pre-installation required)
+#
+# Provides a persistent knowledge graph that the LLM can read and write across
+# conversations: create/update/delete entities, add relations, search memories.
+#
+# Prerequisites:
+#   - Node.js and npx (https://nodejs.org)
+#   The @modelcontextprotocol/server-memory package is downloaded automatically
+#   on first use via `npx -y`.
+#
+# Configuration (all optional):
+#   export MEMORY_FILE_PATH=/path/to/memory.jsonl   # default: memory.jsonl in cwd
+#
+# Usage:
+#   require 'shared_tools/mcp/memory_client'
+#   client = RubyLLM::MCP.clients["memory"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require "ruby_llm/mcp"
+
+RubyLLM::MCP.add_client(
+  name: "memory",
+  transport_type: :stdio,
+  config: {
+    command: "npx",
+    args:    ["-y", "@modelcontextprotocol/server-memory"],
+    env:     ENV['MEMORY_FILE_PATH'] ? { "MEMORY_FILE_PATH" => ENV['MEMORY_FILE_PATH'] } : {},
+  },
+)

data/lib/shared_tools/mcp/notion_client.rb

@@ -0,0 +1,40 @@
+# shared_tools/mcp/notion_client.rb
+#
+# Notion MCP Server Client — requires brew installation
+#
+# Provides full Notion workspace access: search pages and databases,
+# read and update content, create pages, and query databases.
+#
+# Prerequisites:
+#   - Homebrew (https://brew.sh)
+#   - A Notion internal integration token
+#     Create one at https://www.notion.so/profile/integrations
+#     then share the relevant pages/databases with the integration.
+#   The notion-mcp-server binary is installed automatically via brew if missing.
+#
+# Configuration:
+#   export NOTION_TOKEN=ntn_your_integration_token_here
+#
+# Usage:
+#   require 'shared_tools/mcp/notion_client'
+#   client = RubyLLM::MCP.clients["notion"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require_relative "../utilities"
+
+SharedTools.verify_envars("NOTION_TOKEN")
+SharedTools.package_install("notion-mcp-server")
+
+require "ruby_llm/mcp"
+
+RubyLLM::MCP.add_client(
+  name: "notion",
+  transport_type: :stdio,
+  config: {
+    command: "notion-mcp-server",
+    args:    [],
+    env:     { "NOTION_TOKEN" => ENV.fetch("NOTION_TOKEN", "") },
+  },
+)

data/lib/shared_tools/mcp/sequential_thinking_client.rb

@@ -0,0 +1,33 @@
+# shared_tools/mcp/sequential_thinking_client.rb
+#
+# MCP Sequential Thinking Server — npx auto-download (no pre-installation required)
+#
+# Provides a structured chain-of-thought reasoning tool. The LLM can break complex
+# problems into numbered steps, revise earlier steps, and branch reasoning paths
+# before committing to a conclusion.
+#
+# Prerequisites:
+#   - Node.js and npx (https://nodejs.org)
+#   The @modelcontextprotocol/server-sequential-thinking package is downloaded
+#   automatically on first use via `npx -y`.
+#
+# No API key required.
+#
+# Usage:
+#   require 'shared_tools/mcp/sequential_thinking_client'
+#   client = RubyLLM::MCP.clients["sequential-thinking"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require "ruby_llm/mcp"
+
+RubyLLM::MCP.add_client(
+  name: "sequential-thinking",
+  transport_type: :stdio,
+  config: {
+    command: "npx",
+    args:    ["-y", "@modelcontextprotocol/server-sequential-thinking"],
+    env:     {},
+  },
+)

data/lib/shared_tools/mcp/slack_client.rb

@@ -0,0 +1,54 @@
+# shared_tools/mcp/slack_client.rb
+#
+# Slack MCP Server Client — requires brew installation
+#
+# Provides Slack workspace access: read channels, messages, and threads,
+# search message history, list users, and (optionally) post messages.
+#
+# Prerequisites:
+#   - Homebrew (https://brew.sh)
+#   - A Slack token — at least one of the following must be set:
+#       SLACK_MCP_XOXP_TOKEN — user OAuth token (xoxp-...) — full access
+#       SLACK_MCP_XOXB_TOKEN — bot token (xoxb-...) — limited to invited channels, no search
+#   The slack-mcp-server binary is installed automatically via brew if missing.
+#
+# Configuration:
+#   export SLACK_MCP_XOXP_TOKEN=xoxp-your-user-token   # recommended
+#   # OR
+#   export SLACK_MCP_XOXB_TOKEN=xoxb-your-bot-token
+#
+# Optional — posting messages is disabled by default for safety:
+#   export SLACK_MCP_ADD_MESSAGE_TOOL=true              # enable for all channels
+#   export SLACK_MCP_ADD_MESSAGE_TOOL=C012AB3CD,C98765  # enable for specific channels only
+#
+# Usage:
+#   require 'shared_tools/mcp/slack_client'
+#   client = RubyLLM::MCP.clients["slack"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require_relative "../utilities"
+
+xoxp = ENV.fetch("SLACK_MCP_XOXP_TOKEN", "")
+xoxb = ENV.fetch("SLACK_MCP_XOXB_TOKEN", "")
+raise LoadError, "SLACK_MCP_XOXP_TOKEN or SLACK_MCP_XOXB_TOKEN must be set" if xoxp.empty? && xoxb.empty?
+
+SharedTools.package_install("slack-mcp-server")
+
+require "ruby_llm/mcp"
+
+slack_env = {}
+slack_env["SLACK_MCP_XOXP_TOKEN"] = xoxp unless xoxp.empty?
+slack_env["SLACK_MCP_XOXB_TOKEN"] = xoxb unless xoxb.empty?
+slack_env["SLACK_MCP_ADD_MESSAGE_TOOL"] = ENV["SLACK_MCP_ADD_MESSAGE_TOOL"] if ENV["SLACK_MCP_ADD_MESSAGE_TOOL"]
+
+RubyLLM::MCP.add_client(
+  name: "slack",
+  transport_type: :stdio,
+  config: {
+    command: "slack-mcp-server",
+    args:    [],
+    env:     slack_env,
+  },
+)

data/lib/shared_tools/mcp/streamable_http_patch.rb

@@ -0,0 +1,42 @@
+# lib/shared_tools/mcp/streamable_http_patch.rb
+#
+# Patch: normalize mixed CRLF/LF line endings in SSE event buffers.
+#
+# Some MCP servers (e.g. Tavily) use \n to terminate the SSE data line and
+# \r\n for the blank separator line, producing the sequence \n\r\n instead
+# of the uniform \n\n or \r\n\r\n that the upstream parser expects.
+# Without this patch, extract_sse_event never finds an event boundary for
+# such responses and every tools/list request times out.
+#
+# This is a server-side standards violation (RFC 8895 requires consistent
+# line endings within an event), but it is common enough in hosted MCP
+# servers to warrant a defensive client-side fix.
+#
+# The patch normalises the accumulation buffer in-place before the separator
+# check, which is safe because:
+#   - the buffer is a mutable +String (prefixed with +)
+#   - it is always written back via buffer.replace(rest) by the caller
+#   - repeated normalisation of already-normalised content is a no-op
+
+require "ruby_llm/mcp"
+
+module RubyLLM
+  module MCP
+    module Native
+      module Transports
+        class StreamableHTTP
+          private
+
+          def extract_sse_event(buffer)
+            buffer.gsub!("\r\n", "\n")
+            buffer.gsub!("\r", "\n")
+            return nil unless buffer.include?("\n\n")
+
+            raw, rest = buffer.split("\n\n", 2)
+            [parse_sse_event(raw), rest || ""]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/shared_tools/mcp/tavily_client.rb

@@ -0,0 +1,41 @@
+# shared_tools/mcp/tavily_client.rb
+#
+# Tavily MCP Server Client — Remote HTTP (no local installation required)
+#
+# Connects directly to Tavily's hosted MCP endpoint via Streamable HTTP transport.
+# No npx, no Node.js, no local binary required — only a Tavily API key.
+#
+# Provides:
+#   - AI-optimized web search
+#   - Research-grade content extraction
+#   - Real-time news and current events
+#
+# Configuration:
+#   export TAVILY_API_KEY=your_api_key_here
+#   Get a free key at: https://tavily.com
+#
+# Usage:
+#   require 'shared_tools/mcp/tavily_client'
+#   client = RubyLLM::MCP.clients["tavily"]
+#   chat = RubyLLM.chat.with_tools(*client.tools)
+#
+# Compatible with ruby_llm-mcp >= 0.7.0
+
+require_relative "../utilities"
+require_relative "streamable_http_patch"
+
+SharedTools.verify_envars("TAVILY_API_KEY")
+
+RubyLLM::MCP.add_client(
+  name:            "tavily",
+  transport_type:  :streamable,
+  request_timeout: 30_000,
+  config: {
+    url:     "https://mcp.tavily.com/mcp/",
+    version: :http1,
+    headers: {
+      "Authorization" => "Bearer #{ENV.fetch('TAVILY_API_KEY', '')}",
+      "Accept"        => "application/json, text/event-stream",
+    },
+  },
+)

data/lib/shared_tools/mcp.rb

@@ -1,24 +1,53 @@
 # lib/shared_tools/mcp.rb
 #
-# MCP (Model Context Protocol) support for SharedTools using ruby_llm-mcp gem >= 0.7.0
+# MCP (Model Context Protocol) client support for SharedTools.
+# Requires the ruby_llm-mcp gem >= 0.7.0 and RubyLLM >= 1.9.0.
 #
-# This module provides integration with various MCP servers, allowing Ruby applications
-# to connect to external services and tools through the Model Context Protocol.
+# @see https://github.com/patvice/ruby_llm-mcp
+# @see https://www.rubyllm-mcp.com
 #
-# @see https://github.com/patvice/ruby_llm-mcp RubyLLM MCP documentation
-# @see https://www.rubyllm-mcp.com Official documentation
+# Two categories of client are provided, both requiring no pre-installed binaries:
 #
-# Usage:
-#   require 'shared_tools/mcp/imcp'              # Load iMCP client
-#   require 'shared_tools/mcp/github_mcp_server' # Load GitHub client
-#   require 'shared_tools/mcp/tavily_mcp_server' # Load Tavily client
+# REMOTE HTTP (transport: :streamable)
+#   Connect to cloud-hosted MCP servers. Requires only an API key.
 #
-# Requirements:
-#   - ruby_llm-mcp >= 0.7.0
-#   - RubyLLM >= 1.9.0
+#   require 'shared_tools/mcp/tavily_client'      # Web search (TAVILY_API_KEY)
 #
-# Version 0.7.0 Changes:
-#   - Complex parameter support is now enabled by default
-#   - Requires RubyLLM 1.9+
-#   - support_complex_parameters! method is deprecated
+# NPX AUTO-DOWNLOAD (transport: :stdio via npx -y)
+#   The npm package is downloaded on first use. Requires Node.js / npx.
 #
+#   require 'shared_tools/mcp/memory_client'              # Persistent knowledge graph
+#   require 'shared_tools/mcp/sequential_thinking_client' # Chain-of-thought reasoning
+#   require 'shared_tools/mcp/chart_client'               # Chart / visualisation generation
+#   require 'shared_tools/mcp/brave_search_client'        # Web search (BRAVE_API_KEY)
+#
+# Requiring this file loads ALL available clients concurrently using threads.
+# Each client's transport connection is established in parallel, so total startup
+# time equals the slowest single client rather than the sum of all clients.
+#
+# Clients whose API keys are missing are silently skipped.
+#
+# After loading, access clients via:
+#   client = RubyLLM::MCP.clients["client-name"]
+#   chat   = RubyLLM.chat.with_tools(*client.tools)
+
+require_relative "mcp/streamable_http_patch"
+
+threads = Dir[File.join(__dir__, "mcp", "*_client.rb")].map do |path|
+  # Derive the canonical client name from the filename:
+  # "brave_search_client.rb" → "brave-search", "hugging_face_client.rb" → "hugging-face"
+  client_name = File.basename(path, "_client.rb").tr("_", "-")
+
+  Thread.new do
+    require path
+    SharedTools.record_mcp_result(client_name)
+  rescue Exception => e
+    # LoadError (missing env var / package) is a ScriptError, not a StandardError,
+    # so bare `rescue => e` does not catch it. We record the failure and warn so
+    # that missing-key clients are simply skipped when requiring mcp.rb as a whole.
+    SharedTools.record_mcp_result(client_name, error: e)
+    warn "SharedTools::MCP — skipping #{File.basename(path)}: #{e.message}"
+  end
+end
+
+threads.each(&:join)

data/lib/shared_tools/system_info_tool.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Shim: require 'shared_tools/system_info_tool'
+require 'shared_tools'
+require 'shared_tools/tools/system_info_tool'

data/lib/shared_tools/tools/browser/base_tool.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "watir"
-
 module SharedTools
   module Tools
     module Browser
@@ -9,7 +7,7 @@ module SharedTools
       #   class SeleniumTool < BaseTool
       #     # ...
       #   end
-      class BaseTool 
+      class BaseTool
         # @param logger [Logger]
         # @param driver [BaseDriver]
         def initialize(driver:, logger: Logger.new(IO::NULL))
@@ -20,15 +18,16 @@ module SharedTools
 
       protected
 
-        def wait_for_element
+        def wait_for_element(timeout: 10)
           return yield if defined?(RSpec) # Skip waiting in tests
 
-          Watir::Wait.until(timeout: 10) do
+          deadline = Time.now + timeout
+          loop do
             element = yield
-            element if element && element_visible?(element)
+            return element if element && element_visible?(element)
+            break if Time.now >= deadline
+            sleep 0.2
           end
-        rescue Watir::Wait::TimeoutError
-          log_element_timeout
           nil
         end
 
@@ -39,10 +38,7 @@ module SharedTools
         end
 
         def log_element_timeout
-          return unless @browser.respond_to?(:elements)
-
-          visible_elements = @browser.elements.select(&:visible?).map(&:text).compact.first(10)
-          @logger.error("Element not found after 10s. Sample visible elements: #{visible_elements}")
+          @logger.error("Element not found after timeout.")
         end
       end
     end

data/lib/shared_tools/tools/browser/click_tool.rb

@@ -42,10 +42,12 @@ module SharedTools
       private
 
         def default_driver
-          if defined?(Watir)
+          if defined?(Ferrum)
+            FerrumDriver.new(logger: @logger)
+          elsif defined?(Watir)
             WatirDriver.new(logger: @logger)
           else
-            raise LoadError, "Browser tools require a driver. Either install the 'watir' gem or pass a driver: parameter"
+            raise LoadError, "Browser tools require a driver. Install the 'ferrum' gem or pass a driver: parameter"
           end
         end
       end