shared_tools 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccef2b45ebf2ea78e16ba617d73d1b9617203343bd9b5aad139f3eb72140c3ee
-  data.tar.gz: 67095ae417a67860aadd7b169233f3f40e93278b7d46d10feb4ffc0f8de27b71
+  metadata.gz: e5775624c9ae2d7f0fb1a47c515b2dbe7316faaee9de7bc62823e0d602274a0a
+  data.tar.gz: 480df1266dc12f1bd4104ef3f80a78b895ac22ebf149b9090f0bcf679bcb8a99
 SHA512:
-  metadata.gz: d01003df48f64af2e9743264f213ba46b27002a2bf4aa29384d803d9a096c7fefe05a63a2479182f851b72acba842fb9cebac5398aa9c0b5e0ebbbd9895a72eb
-  data.tar.gz: 7f6e1c51e2f174bb400cba67a999fbe422b483c0ea098b4031278c13d2766e65cb7799258e895ceebda6e9da02e8e7445f444d887667845964b59f1bd199c837
+  metadata.gz: 00a01f1113bb7e728b00aa196f998850c66246d4e5e26d7e1db16d0314bf3f2993f1632dafe964ea347690a6a03a9e9c04440ed47ef1f1870c858c1f2eda3aed
+  data.tar.gz: 613fbbae8478fa3b805d368102e31cf9c9709e16f954f87a8fea10aa8f148550147f884b68956714eb817cd6288b1f4213b3612ea887ad502e8be8d13973db74

data/CHANGELOG.md

@@ -3,6 +3,18 @@
 ## Unreleased
 
 ## Released
+### [0.3.1] 2025-12-17
+
+- added ClipboardTool for cross-platform clipboard read/write operations
+- added CronTool for cron expression parsing and scheduling
+- added CurrentDateTimeTool for date/time retrieval with timezone support
+- added DnsTool for DNS lookups and resolution
+- added SystemInfoTool for system information retrieval
+- updated gem dependencies and Zeitwerk configuration
+- improved BrowserTool, ComputerTool, and DatabaseTool implementations
+- updated GitHub Pages deployment workflow
+- fixed a problem with eager loading when used with the `aia` gem
+
 ### [0.3.0] 2025-11-08
 - changed focus of shared_tools to only support the ruby_llm and ruby_llm-mcp ecosystem
 

data/lib/shared_tools/tools/browser_tool.rb

@@ -146,12 +146,15 @@ module SharedTools
 
 
       # @param logger [Logger] optional logger
-      # @param driver [SharedTools::Tools::Browser::BaseDriver] optional, will attempt to create WatirDriver if not provided
+      # @param driver [SharedTools::Tools::Browser::BaseDriver] optional, will attempt to create WatirDriver when execute is called
       def initialize(logger: nil, driver: nil)
         @logger = logger || RubyLLM.logger
-        @driver = driver || default_driver
+        @driver = driver  # Defer default_driver to execute time to support RubyLLM tool discovery
       end
 
+      # Set driver after instantiation (useful when tool is discovered by RubyLLM)
+      attr_writer :driver
+
       def cleanup!
         @driver.close
       end
@@ -166,6 +169,9 @@ module SharedTools
       #
       # @return [String]
       def execute(action:, url: nil, selector: nil, value: nil, context_size: 2, full_html: false, text_content: nil)
+        # Lazily resolve driver at execute time
+        @driver ||= default_driver
+
         case action.to_s.downcase
         when Action::VISIT
           require_param!(:url, url)

data/lib/shared_tools/tools/clipboard_tool.rb

@@ -0,0 +1,194 @@
+# frozen_string_literal: true
+
+require 'ruby_llm/tool'
+
+module SharedTools
+  module Tools
+    # A tool for reading from and writing to the system clipboard.
+    # Supports macOS (pbcopy/pbpaste), Linux (xclip/xsel), and Windows (clip).
+    #
+    # @example
+    #   tool = SharedTools::Tools::ClipboardTool.new
+    #   tool.execute(action: 'write', content: 'Hello, World!')
+    #   result = tool.execute(action: 'read')
+    #   puts result[:content]  # "Hello, World!"
+    class ClipboardTool < RubyLLM::Tool
+      def self.name = 'clipboard'
+
+      description <<~'DESCRIPTION'
+        Read from or write to the system clipboard.
+
+        This tool provides cross-platform clipboard access:
+        - macOS: Uses pbcopy/pbpaste
+        - Linux: Uses xclip or xsel (must be installed)
+        - Windows: Uses clip/powershell
+
+        Actions:
+        - 'read': Get the current clipboard contents
+        - 'write': Set the clipboard contents
+        - 'clear': Clear the clipboard
+
+        Example usage:
+          tool = SharedTools::Tools::ClipboardTool.new
+
+          # Write to clipboard
+          tool.execute(action: 'write', content: 'Hello, World!')
+
+          # Read from clipboard
+          result = tool.execute(action: 'read')
+          puts result[:content]
+
+          # Clear clipboard
+          tool.execute(action: 'clear')
+      DESCRIPTION
+
+      params do
+        string :action, description: <<~DESC.strip
+          The clipboard action to perform:
+          - 'read': Get current clipboard contents
+          - 'write': Set clipboard contents (requires 'content' parameter)
+          - 'clear': Clear the clipboard
+        DESC
+
+        string :content, description: <<~DESC.strip, required: false
+          The text content to write to the clipboard.
+          Required when action is 'write'.
+        DESC
+      end
+
+      # @param logger [Logger] optional logger
+      def initialize(logger: nil)
+        @logger = logger || RubyLLM.logger
+      end
+
+      # Execute clipboard action
+      #
+      # @param action [String] 'read', 'write', or 'clear'
+      # @param content [String, nil] content to write (required for 'write' action)
+      # @return [Hash] result with success status and content/error
+      def execute(action:, content: nil)
+        @logger.info("ClipboardTool#execute action=#{action.inspect}")
+
+        case action.to_s.downcase
+        when 'read'
+          read_clipboard
+        when 'write'
+          write_clipboard(content)
+        when 'clear'
+          clear_clipboard
+        else
+          {
+            success: false,
+            error: "Unknown action: #{action}. Valid actions are: read, write, clear"
+          }
+        end
+      rescue => e
+        @logger.error("ClipboardTool error: #{e.message}")
+        {
+          success: false,
+          error: e.message
+        }
+      end
+
+      private
+
+      def read_clipboard
+        content = case platform
+                  when :macos
+                    `pbpaste 2>/dev/null`
+                  when :linux
+                    if command_exists?('xclip')
+                      `xclip -selection clipboard -o 2>/dev/null`
+                    elsif command_exists?('xsel')
+                      `xsel --clipboard --output 2>/dev/null`
+                    else
+                      raise "No clipboard tool found. Install xclip or xsel."
+                    end
+                  when :windows
+                    `powershell -command "Get-Clipboard" 2>nul`.chomp
+                  else
+                    raise "Unsupported platform: #{RUBY_PLATFORM}"
+                  end
+
+        {
+          success: true,
+          content: content,
+          length: content.length
+        }
+      end
+
+      def write_clipboard(content)
+        if content.nil? || content.empty?
+          return {
+            success: false,
+            error: "Content is required for write action"
+          }
+        end
+
+        case platform
+        when :macos
+          IO.popen('pbcopy', 'w') { |io| io.print content }
+        when :linux
+          if command_exists?('xclip')
+            IO.popen('xclip -selection clipboard', 'w') { |io| io.print content }
+          elsif command_exists?('xsel')
+            IO.popen('xsel --clipboard --input', 'w') { |io| io.print content }
+          else
+            raise "No clipboard tool found. Install xclip or xsel."
+          end
+        when :windows
+          IO.popen('clip', 'w') { |io| io.print content }
+        else
+          raise "Unsupported platform: #{RUBY_PLATFORM}"
+        end
+
+        {
+          success: true,
+          message: "Content written to clipboard",
+          length: content.length
+        }
+      end
+
+      def clear_clipboard
+        case platform
+        when :macos
+          IO.popen('pbcopy', 'w') { |io| io.print '' }
+        when :linux
+          if command_exists?('xclip')
+            IO.popen('xclip -selection clipboard', 'w') { |io| io.print '' }
+          elsif command_exists?('xsel')
+            IO.popen('xsel --clipboard --input', 'w') { |io| io.print '' }
+          else
+            raise "No clipboard tool found. Install xclip or xsel."
+          end
+        when :windows
+          IO.popen('clip', 'w') { |io| io.print '' }
+        else
+          raise "Unsupported platform: #{RUBY_PLATFORM}"
+        end
+
+        {
+          success: true,
+          message: "Clipboard cleared"
+        }
+      end
+
+      def platform
+        case RUBY_PLATFORM
+        when /darwin/
+          :macos
+        when /linux/
+          :linux
+        when /mswin|mingw|cygwin/
+          :windows
+        else
+          :unknown
+        end
+      end
+
+      def command_exists?(cmd)
+        system("which #{cmd} > /dev/null 2>&1")
+      end
+    end
+  end
+end

data/lib/shared_tools/tools/computer_tool.rb

@@ -139,13 +139,16 @@ module SharedTools
       end
 
 
-      # @param driver [Computer::BaseDriver] optional, will attempt to create platform-specific driver if not provided
+      # @param driver [Computer::BaseDriver] optional, will attempt to create platform-specific driver when execute is called
       # @param logger [Logger] optional logger
       def initialize(driver: nil, logger: nil)
         @logger = logger || RubyLLM.logger
-        @driver = driver || default_driver
+        @driver = driver  # Defer default_driver to execute time to support RubyLLM tool discovery
       end
 
+      # Set driver after instantiation (useful when tool is discovered by RubyLLM)
+      attr_writer :driver
+
       # @param action [String]
       # @param coordinate [Hash<{ width: Integer, height: Integer }>] the (x,y) coordinate
       # @param text [String]
@@ -162,6 +165,9 @@ module SharedTools
         scroll_direction: nil,
         scroll_amount: nil
       )
+        # Lazily resolve driver at execute time
+        @driver ||= default_driver
+
         @logger.info({
           action:,
           coordinate:,