shared_tools 0.3.0 → 0.4.1

data/lib/shared_tools.rb

@@ -4,17 +4,31 @@ require 'ruby_llm'
 require 'io/console'
 
 require "zeitwerk"
-loader = Zeitwerk::Loader.for_gem
-# Ignore aggregate loader files that don't define constants
-loader.ignore("#{__dir__}/shared_tools/ruby_llm.rb")
-loader.ignore("#{__dir__}/shared_tools/tools/browser.rb")
-loader.ignore("#{__dir__}/shared_tools/tools/computer.rb")
-loader.ignore("#{__dir__}/shared_tools/tools/database.rb")
-loader.ignore("#{__dir__}/shared_tools/tools/disk.rb")
-loader.ignore("#{__dir__}/shared_tools/tools/doc.rb")
-loader.ignore("#{__dir__}/shared_tools/tools/docker.rb")
-loader.ignore("#{__dir__}/shared_tools/tools/eval.rb")
-loader.setup
+
+# Set up Zeitwerk loader outside module, then pass reference in
+SharedToolsLoader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/ruby_llm.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/mcp.rb")       # Documentation/loader file only
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/mcp")          # Entire mcp directory (naming issues)
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/browser.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/computer.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/database.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/disk.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/doc.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/docker.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/eval.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/notification.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/version.rb")  # Defines VERSION constant, not Version class
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/incomplete")  # Empty/incomplete tools directory
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/tools/enabler.rb") # Experimental; defines Tools::Enabler not SharedTools::Tools::Enabler
+
+# Ignore per-tool shim files (require-path shortcuts: require 'shared_tools/<tool_name>')
+Dir.glob("#{__dir__}/shared_tools/*_tool.rb").each { |f| SharedToolsLoader.ignore(f) }
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/data_science_kit.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/database.rb")
+SharedToolsLoader.ignore("#{__dir__}/shared_tools/utilities.rb")  # Reopens SharedTools, not SharedTools::Utilities
+
+SharedToolsLoader.setup
 
 module SharedTools
   @auto_execute   ||= true # Auto-execute by default, no human-in-the-loop
@@ -37,5 +51,22 @@ module SharedTools
       print "\nIs it okay to proceed? (y/N"
       STDIN.getch == "y"
     end
+
+    # Force-load all tool classes into ObjectSpace.
+    # Called by AIA's GemActivator.trigger_tool_loading when shared_tools is
+    # passed to --require. Without this, Zeitwerk lazy-loads classes on first
+    # reference, so no RubyLLM::Tool subclasses appear in ObjectSpace at scan time.
+    def load_all_tools
+      SharedToolsLoader.eager_load
+    end
+
+    # Return all loaded RubyLLM::Tool subclasses provided by this gem.
+    # Also triggers eager loading so the list is complete.
+    def tools
+      load_all_tools
+      ObjectSpace.each_object(Class).select { |k| k < ::RubyLLM::Tool }.to_a
+    end
   end
 end
+
+require_relative "shared_tools/utilities"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shared_tools
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -122,7 +122,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: docx
+  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: roo
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -136,7 +150,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: watir
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -150,7 +164,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: webdrivers
+  name: ferrum
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -219,6 +233,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-mock
+  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: rake
   requirement: !ruby/object:Gem::Requirement
@@ -246,10 +274,34 @@ files:
 - LICENSE
 - README.md
 - lib/shared_tools.rb
+- lib/shared_tools/browser_tool.rb
+- lib/shared_tools/calculator_tool.rb
+- lib/shared_tools/clipboard_tool.rb
+- lib/shared_tools/composite_analysis_tool.rb
+- lib/shared_tools/computer_tool.rb
+- lib/shared_tools/cron_tool.rb
+- lib/shared_tools/current_date_time_tool.rb
+- lib/shared_tools/data_science_kit.rb
+- lib/shared_tools/database.rb
+- lib/shared_tools/database_query_tool.rb
+- lib/shared_tools/database_tool.rb
+- lib/shared_tools/disk_tool.rb
+- lib/shared_tools/dns_tool.rb
+- lib/shared_tools/doc_tool.rb
+- lib/shared_tools/error_handling_tool.rb
+- lib/shared_tools/eval_tool.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/mcp/brave_search_client.rb
+- lib/shared_tools/mcp/chart_client.rb
+- lib/shared_tools/mcp/github_client.rb
+- lib/shared_tools/mcp/hugging_face_client.rb
+- lib/shared_tools/mcp/memory_client.rb
+- lib/shared_tools/mcp/notion_client.rb
+- lib/shared_tools/mcp/sequential_thinking_client.rb
+- lib/shared_tools/mcp/slack_client.rb
+- lib/shared_tools/mcp/streamable_http_patch.rb
+- lib/shared_tools/mcp/tavily_client.rb
+- lib/shared_tools/system_info_tool.rb
 - lib/shared_tools/tools.rb
 - lib/shared_tools/tools/browser.rb
 - lib/shared_tools/tools/browser/base_driver.rb
@@ -257,6 +309,7 @@ files:
 - 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/ferrum_driver.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
@@ -278,11 +331,14 @@ files:
 - 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/clipboard_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/cron_tool.rb
+- lib/shared_tools/tools/current_date_time_tool.rb
 - lib/shared_tools/tools/data_science_kit.rb
 - lib/shared_tools/tools/database.rb
 - lib/shared_tools/tools/database/base_driver.rb
@@ -290,7 +346,6 @@ files:
 - 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
@@ -306,23 +361,38 @@ files:
 - 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/dns_tool.rb
 - lib/shared_tools/tools/doc.rb
+- lib/shared_tools/tools/doc/docx_reader_tool.rb
 - lib/shared_tools/tools/doc/pdf_reader_tool.rb
+- lib/shared_tools/tools/doc/spreadsheet_reader_tool.rb
+- lib/shared_tools/tools/doc/text_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/enabler.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/notification.rb
+- lib/shared_tools/tools/notification/base_driver.rb
+- lib/shared_tools/tools/notification/linux_driver.rb
+- lib/shared_tools/tools/notification/mac_driver.rb
+- lib/shared_tools/tools/notification/null_driver.rb
+- lib/shared_tools/tools/notification_tool.rb
 - lib/shared_tools/tools/secure_tool_template.rb
+- lib/shared_tools/tools/system_info_tool.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/utilities.rb
 - lib/shared_tools/version.rb
+- lib/shared_tools/weather_tool.rb
+- lib/shared_tools/workflow_manager_tool.rb
 homepage: https://github.com/madbomber/shared_tools
 licenses:
 - MIT
@@ -344,7 +414,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.9
 specification_version: 4
 summary: Shared utilities and AI tools for Ruby applications with configurable logging
 test_files: []

data/lib/shared_tools/mcp/github_mcp_server.rb

@@ -1,58 +0,0 @@
-# shared_tools/mcp/github_mcp_server.rb
-#
-# GitHub MCP Server Client Configuration for ruby_llm-mcp >= 0.7.0
-#
-# Provides access to GitHub operations including:
-#   - Repository management
-#   - Issue and PR operations
-#   - Code search
-#   - Branch operations
-#   - And more GitHub API functionality
-#
-# Installation:
-#   brew install github-mcp-server
-#
-# Configuration:
-#   Set environment variable: GITHUB_PERSONAL_ACCESS_TOKEN
-#   export GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
-#
-# Compatible with ruby_llm-mcp v0.7.0+
-
-require "ruby_llm/mcp"
-
-RubyLLM::MCP.add_client(
-  name: "github-mcp-server",
-  transport_type: :stdio,
-  config: {
-    command: "/opt/homebrew/bin/github-mcp-server",
-    args: %w[stdio],
-    env: { "GITHUB_PERSONAL_ACCESS_TOKEN" => ENV.fetch("GITHUB_PERSONAL_ACCESS_TOKEN") },
-  },
-)
-
-
-__END__
-
-
-A GitHub MCP server that handles various tools and resources.
-
-Usage:
-  server [command]
-
-Available Commands:
-  completion  Generate the autocompletion script for the specified shell
-  help        Help about any command
-  stdio       Start stdio server
-
-Flags:
-      --dynamic-toolsets         Enable dynamic toolsets
-      --enable-command-logging   When enabled, the server will log all command requests and responses to the log file
-      --export-translations      Save translations to a JSON file
-      --gh-host string           Specify the GitHub hostname (for GitHub Enterprise etc.)
-  -h, --help                     help for server
-      --log-file string          Path to log file
-      --read-only                Restrict the server to read-only operations
-      --toolsets strings         An optional comma separated list of groups of tools to allow, defaults to enabling all (default [all])
-  -v, --version                  version for server
-
-Use "server [command] --help" for more information about a command.

data/lib/shared_tools/mcp/imcp.rb

@@ -1,28 +0,0 @@
-# shared_tools/mcp/imcp.rb
-#
-# iMCP Client Configuration for ruby_llm-mcp >= 0.7.0
-#
-# iMCP is a macOS application that provides MCP access to:
-#   - Notes
-#   - Calendar
-#   - Contacts
-#   - Reminders
-#   - And other macOS native applications
-#
-# Installation:
-#   brew install --cask loopwork/tap/iMCP
-#
-# Documentation:
-#   https://github.com/loopwork/iMCP
-#
-# Compatible with ruby_llm-mcp v0.7.0+
-
-require 'ruby_llm/mcp'
-
-RubyLLM::MCP.add_client(
-  name: "imcp-server",
-  transport_type: :stdio,
-  config: {
-    command: "/Applications/iMCP.app/Contents/MacOS/imcp-server 2> /dev/null"
-  }
-)

data/lib/shared_tools/mcp/tavily_mcp_server.rb

@@ -1,44 +0,0 @@
-# shared_tools/mcp/tavily_mcp_server.rb
-#
-# Tavily MCP Server Client Configuration for ruby_llm-mcp >= 0.7.0
-#
-# Provides AI-powered web search and research capabilities:
-#   - Web search with AI-optimized results
-#   - Research-grade content extraction
-#   - Real-time information gathering
-#   - News and current events search
-#
-# Installation:
-#   Requires Node.js and npx (comes with Node.js)
-#   The mcp-remote package will be installed automatically via npx
-#
-# Configuration:
-#   Set environment variable: TAVILY_API_KEY
-#   export TAVILY_API_KEY=your_api_key_here
-#   Get your API key at: https://tavily.com
-#
-# Compatible with ruby_llm-mcp v0.7.0+
-
-require "ruby_llm/mcp"
-
-RubyLLM::MCP.add_client(
-  name: "tavily",
-  transport_type: :stdio,
-  config: {
-    command: "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=#{ENV.fetch('TAVILY_API_KEY')}",
-    env: {}
-  }
-)
-
-
-__END__
-
-
-# {
-#   "mcpServers": {
-#     "tavily-remote-mcp": {
-#       "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=$TAVILY_API_KEY",
-#       "env": {}
-#     }
-#   }
-# }