shared_tools 0.2.1 → 0.3.0

metadata

@@ -1,36 +1,64 @@
 --- !ruby/object:Gem::Specification
 name: shared_tools
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
-- MadBomber Team
+- Dewayne VanHoozer
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: llm.rb
+  name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -38,13 +66,41 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: omniai
+  name: dentaku
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sequel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: openweathermap
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -55,18 +111,18 @@ dependencies:
   name: pdf-reader
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: raix
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -80,47 +136,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: ruby_llm
+  name: watir
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.3.1
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.3.1
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: ruby_llm-mcp
+  name: webdrivers
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.1
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.1
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: macos
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: debug_me
   requirement: !ruby/object:Gem::Requirement
@@ -136,38 +206,38 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
 description: |
-  SharedTools provides a collection of reusable common tools (aka callback functions)
-  for Ruby applications using various LLM-provider API gems.
+  SharedTools provides a collection of reusable common tools
+  for Ruby applications using ruby_llm gem.
 email:
-- example@example.com
+- dvanhoozer@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -176,31 +246,82 @@ files:
 - LICENSE
 - README.md
 - lib/shared_tools.rb
-- lib/shared_tools/llm_rb.rb
-- lib/shared_tools/llm_rb/run_shell_command.rb
-- lib/shared_tools/omniai.rb
-- lib/shared_tools/raix.rb
-- lib/shared_tools/raix/what_is_the_weather.rb
-- lib/shared_tools/ruby_llm.rb
-- lib/shared_tools/ruby_llm/edit_file.rb
-- lib/shared_tools/ruby_llm/incomplete/calculator_tool.rb
-- lib/shared_tools/ruby_llm/incomplete/composite_analysis_tool.rb
-- lib/shared_tools/ruby_llm/incomplete/data_science_kit.rb
-- lib/shared_tools/ruby_llm/incomplete/database_query_tool.rb
-- lib/shared_tools/ruby_llm/incomplete/devops_toolkit.rb
-- lib/shared_tools/ruby_llm/incomplete/error_handling_tool.rb
-- lib/shared_tools/ruby_llm/incomplete/secure_tool_template.rb
-- lib/shared_tools/ruby_llm/incomplete/weather_tool.rb
-- lib/shared_tools/ruby_llm/incomplete/workflow_manager_tool.rb
-- lib/shared_tools/ruby_llm/list_files.rb
-- lib/shared_tools/ruby_llm/mcp.rb
-- lib/shared_tools/ruby_llm/mcp/github_mcp_server.rb
-- lib/shared_tools/ruby_llm/mcp/imcp.rb
-- lib/shared_tools/ruby_llm/pdf_page_reader.rb
-- lib/shared_tools/ruby_llm/python_eval.rb
-- lib/shared_tools/ruby_llm/read_file.rb
-- lib/shared_tools/ruby_llm/ruby_eval.rb
-- lib/shared_tools/ruby_llm/run_shell_command.rb
+- lib/shared_tools/mcp.rb
+- lib/shared_tools/mcp/github_mcp_server.rb
+- lib/shared_tools/mcp/imcp.rb
+- lib/shared_tools/mcp/tavily_mcp_server.rb
+- lib/shared_tools/tools.rb
+- lib/shared_tools/tools/browser.rb
+- lib/shared_tools/tools/browser/base_driver.rb
+- lib/shared_tools/tools/browser/base_tool.rb
+- lib/shared_tools/tools/browser/click_tool.rb
+- lib/shared_tools/tools/browser/elements/element_grouper.rb
+- lib/shared_tools/tools/browser/elements/nearby_element_detector.rb
+- lib/shared_tools/tools/browser/formatters/action_formatter.rb
+- lib/shared_tools/tools/browser/formatters/data_entry_formatter.rb
+- lib/shared_tools/tools/browser/formatters/element_formatter.rb
+- lib/shared_tools/tools/browser/formatters/input_formatter.rb
+- lib/shared_tools/tools/browser/inspect_tool.rb
+- lib/shared_tools/tools/browser/inspect_utils.rb
+- lib/shared_tools/tools/browser/page_inspect/button_summarizer.rb
+- lib/shared_tools/tools/browser/page_inspect/form_summarizer.rb
+- lib/shared_tools/tools/browser/page_inspect/html_summarizer.rb
+- lib/shared_tools/tools/browser/page_inspect/link_summarizer.rb
+- lib/shared_tools/tools/browser/page_inspect_tool.rb
+- lib/shared_tools/tools/browser/page_screenshot_tool.rb
+- lib/shared_tools/tools/browser/selector_generator.rb
+- lib/shared_tools/tools/browser/selector_generator/base_selectors.rb
+- lib/shared_tools/tools/browser/selector_generator/contextual_selectors.rb
+- lib/shared_tools/tools/browser/selector_inspect_tool.rb
+- lib/shared_tools/tools/browser/text_field_area_set_tool.rb
+- lib/shared_tools/tools/browser/visit_tool.rb
+- lib/shared_tools/tools/browser/watir_driver.rb
+- lib/shared_tools/tools/browser_tool.rb
+- lib/shared_tools/tools/calculator_tool.rb
+- lib/shared_tools/tools/composite_analysis_tool.rb
+- lib/shared_tools/tools/computer.rb
+- lib/shared_tools/tools/computer/base_driver.rb
+- lib/shared_tools/tools/computer/mac_driver.rb
+- lib/shared_tools/tools/computer_tool.rb
+- lib/shared_tools/tools/data_science_kit.rb
+- lib/shared_tools/tools/database.rb
+- lib/shared_tools/tools/database/base_driver.rb
+- lib/shared_tools/tools/database/postgres_driver.rb
+- lib/shared_tools/tools/database/sqlite_driver.rb
+- lib/shared_tools/tools/database_query_tool.rb
+- lib/shared_tools/tools/database_tool.rb
+- lib/shared_tools/tools/devops_toolkit.rb
+- lib/shared_tools/tools/disk.rb
+- lib/shared_tools/tools/disk/base_driver.rb
+- lib/shared_tools/tools/disk/base_tool.rb
+- lib/shared_tools/tools/disk/directory_create_tool.rb
+- lib/shared_tools/tools/disk/directory_delete_tool.rb
+- lib/shared_tools/tools/disk/directory_list_tool.rb
+- lib/shared_tools/tools/disk/directory_move_tool.rb
+- lib/shared_tools/tools/disk/file_create_tool.rb
+- lib/shared_tools/tools/disk/file_delete_tool.rb
+- lib/shared_tools/tools/disk/file_move_tool.rb
+- lib/shared_tools/tools/disk/file_read_tool.rb
+- lib/shared_tools/tools/disk/file_replace_tool.rb
+- lib/shared_tools/tools/disk/file_write_tool.rb
+- lib/shared_tools/tools/disk/local_driver.rb
+- lib/shared_tools/tools/disk_tool.rb
+- lib/shared_tools/tools/doc.rb
+- lib/shared_tools/tools/doc/pdf_reader_tool.rb
+- lib/shared_tools/tools/doc_tool.rb
+- lib/shared_tools/tools/docker.rb
+- lib/shared_tools/tools/docker/base_tool.rb
+- lib/shared_tools/tools/docker/compose_run_tool.rb
+- lib/shared_tools/tools/error_handling_tool.rb
+- lib/shared_tools/tools/eval.rb
+- lib/shared_tools/tools/eval/python_eval_tool.rb
+- lib/shared_tools/tools/eval/ruby_eval_tool.rb
+- lib/shared_tools/tools/eval/shell_eval_tool.rb
+- lib/shared_tools/tools/eval_tool.rb
+- lib/shared_tools/tools/secure_tool_template.rb
+- lib/shared_tools/tools/version.rb
+- lib/shared_tools/tools/weather_tool.rb
+- lib/shared_tools/tools/workflow_manager_tool.rb
 - lib/shared_tools/version.rb
 homepage: https://github.com/madbomber/shared_tools
 licenses:
@@ -223,7 +344,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Shared utilities and AI tools for Ruby applications with configurable logging
 test_files: []

data/lib/shared_tools/llm_rb/run_shell_command.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../shared_tools'
-
-module SharedTools
-  verify_gem :llm_rb
-
-  RunShellCommand = LLM.function(:system) do |fn|
-    fn.description "Run a shell command"
-
-    fn.params do |schema|
-      schema.object(command: schema.string.required)
-    end
-
-    fn.define do |params|
-      ro, wo = IO.pipe
-      re, we = IO.pipe
-      Process.wait Process.spawn(params.command, out: wo, err: we)
-      [wo, we].each(&:close)
-      { stderr: re.read, stdout: ro.read }
-    end
-  end
-end

data/lib/shared_tools/llm_rb.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../shared_tools'
-
-SharedTools.verify_gem :llm_rb
-
-Dir.glob(File.join(__dir__, "llm_rb", "*.rb")).each do |file|
-  require file
-end

data/lib/shared_tools/omniai.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../shared_tools'
-
-SharedTools.verify_gem :omniai
-
-Dir.glob(File.join(__dir__, "omniai", "*.rb")).each do |file|
-  require file
-end

data/lib/shared_tools/raix/what_is_the_weather.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../../shared_tools"
-
-module SharedTools
-  verify_gem :raix
-
-  class WhatIsTheWeather
-    include ::Raix::ChatCompletion
-    include ::Raix::FunctionDispatch
-
-    function :check_weather,
-             "Check the weather for a location",
-             location: { type: "string", required: true } do |arguments|
-      "The weather in #{arguments[:location]} is hot and sunny"
-    end
-  end
-end

data/lib/shared_tools/raix.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../shared_tools'
-
-SharedTools.verify_gem :raix
-
-Dir.glob(File.join(__dir__, "raix", "*.rb")).each do |file|
-  require file
-end

data/lib/shared_tools/ruby_llm/edit_file.rb

@@ -1,71 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../shared_tools'
-
-module SharedTools
-  verify_gem :ruby_llm
-
-  class EditFile < ::RubyLLM::Tool
-      def self.name = 'edit_file'
-
-    description <<~DESCRIPTION
-                  Make edits to a text file.
-
-                  Replaces 'old_str' with 'new_str' in the given file.
-                  'old_str' and 'new_str' MUST be different from each other.
-
-                  If the file specified with path doesn't exist, it will be created.
-
-                  By default, only the first occurrence will be replaced. Set replace_all to true to replace all occurrences.
-                DESCRIPTION
-    param :path, desc: "The path to the file"
-    param :old_str, desc: "Text to search for - must match exactly"
-    param :new_str, desc: "Text to replace old_str with"
-    param :replace_all, desc: "Whether to replace all occurrences (true) or just the first one (false)", required: false
-
-    def execute(path:, old_str:, new_str:, replace_all: false)
-      RubyLLM.logger.info("Editing file: #{path}")
-
-      # Normalize path to absolute path
-      absolute_path = File.absolute_path(path)
-
-      if File.exist?(absolute_path)
-        RubyLLM.logger.debug("File exists, reading content")
-        content = File.read(absolute_path)
-      else
-        RubyLLM.logger.debug("File doesn't exist, creating new file")
-        content = ""
-      end
-
-      matches = content.scan(old_str).size
-      RubyLLM.logger.debug("Found #{matches} matches for the string to replace")
-
-      if matches == 0
-        RubyLLM.logger.warn("No matches found for the string to replace. File will remain unchanged.")
-        return { success: false, warning: "No matches found for the string to replace" }
-      end
-
-      if matches > 1 && !replace_all
-        RubyLLM.logger.warn("Multiple matches (#{matches}) found for the string to replace. Only the first occurrence will be replaced.")
-      end
-
-      if replace_all
-        updated_content = content.gsub(old_str, new_str)
-        replaced_count = matches
-        RubyLLM.logger.info("Replacing all #{matches} occurrences")
-      else
-        updated_content = content.sub(old_str, new_str)
-        replaced_count = 1
-        RubyLLM.logger.info("Replacing first occurrence only")
-      end
-
-      File.write(absolute_path, updated_content)
-
-      RubyLLM.logger.info("Successfully updated file: #{path}")
-      { success: true, matches: matches, replaced: replaced_count }
-    rescue => e
-      RubyLLM.logger.error("Failed to edit file '#{path}': #{e.message}")
-      { error: e.message }
-    end
-  end
-end

data/lib/shared_tools/ruby_llm/incomplete/calculator_tool.rb

@@ -1,70 +0,0 @@
-# calculator_tool.rb - Simple custom tool example
-require 'ruby_llm/tool'
-
-module Tools
-  class Calculator < RubyLLM::Tool
-    def self.name = "calculator"
-
-    description <<~DESCRIPTION
-      Perform advanced mathematical calculations with comprehensive error handling and validation.
-      This tool supports basic arithmetic operations, parentheses, and common mathematical functions.
-      It provides safe evaluation of mathematical expressions without executing arbitrary code,
-      making it suitable for use in AI-assisted calculations where security is important.
-      The tool returns formatted results with configurable precision and helpful error messages
-      when invalid expressions are provided.
-    DESCRIPTION
-
-    param :expression,
-          desc: <<~DESC,
-            Mathematical expression to evaluate using standard arithmetic operators and parentheses.
-            Supported operations include: addition (+), subtraction (-), multiplication (*), division (/),
-            and parentheses for grouping. Examples: '2 + 2', '(10 * 5) / 2', '15.5 - 3.2'.
-            Only numeric characters, operators, parentheses, decimal points, and spaces are allowed
-            for security reasons. Complex mathematical functions are not supported in this version.
-          DESC
-          type: :string,
-          required: true
-
-    param :precision,
-          desc: <<~DESC,
-            Number of decimal places to display in the result. Must be a non-negative integer.
-            Set to 0 for whole numbers only, or higher values for more precise decimal results.
-            Default is 2 decimal places, which works well for most financial and general calculations.
-            Maximum precision is limited to 10 decimal places to prevent excessive output.
-          DESC
-          type: :integer,
-          default: 2
-
-    def execute(expression:, precision: 2)
-      begin
-        # Use safe evaluation instead of raw eval
-        result = safe_eval(expression)
-        formatted_result = result.round(precision)
-
-        {
-          success: true,
-          result:  formatted_result,
-          expression: expression,
-          precision: precision
-        }
-      rescue => e
-        {
-          success: false,
-          error:   "Invalid expression: #{e.message}",
-          expression: expression,
-          suggestion: "Try expressions like '2 + 2' or '10 * 5'"
-        }
-      end
-    end
-
-    private
-
-    def safe_eval(expression)
-      # Implement safe mathematical evaluation
-      # This is a simplified example - use a proper math parser in production
-      allowed_chars = /\A[0-9+\-*\/\(\)\.\s]+\z/
-      raise "Invalid characters in expression" unless expression.match?(allowed_chars)
-      eval(expression)
-    end
-  end
-end