shared_tools 0.6.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28d0b117ea90e414478dd4e16006c38ca33fd1bcd4a7778ac5a1aed87f168dbd
-  data.tar.gz: bba1e30acb8b8e329edf85460d87ded7838ce4a687560dca7542d0c6a4ad7a49
+  metadata.gz: 34cacf7e0ae9289b41abac0941cd1123ff725d8dbac4d8ed8d793e7a01fdac88
+  data.tar.gz: cba8ee56b7c22b41847ce844c09edffb2e29a49844cd79a6eab1ccab758b25a3
 SHA512:
-  metadata.gz: 02c7930f52bc3498f9f4e7d2648fb10a020a908688e3e551f3ab44857593a4730f2eb531e8abd4924d24c777a286266076a17624c83d42266b0aa19f8e123c61
-  data.tar.gz: 1341ca665381c7969fc30c4ff650531c0d1cc088a63523c25e3f9991ab2d2b5e24837ef9caed8efbe79959d8d9ea9f666abc4997b469f3de2fb113d4af6e9aba
+  metadata.gz: 94dde27edb4d0b7e4d6df7537012df4bdb9d5f06a1e7e3839610d08b85ea3524056dd4eb6b3bc7cddf49791c9af9f7159fde9ed567c9a135d9fcb3653f633352
+  data.tar.gz: 3cb75f11a57a07a41695f46ad02e70d70af52506fe0778ae11bae53388fb12ffed06ceb524d9060e0b483d89b7c1f690d8949389b2d7d6732ada3917c1015b80

data/CHANGELOG.md

@@ -8,6 +8,8 @@
 - **Breaking:** Requiring a client file no longer has side effects. It does not check environment variables, does not run `brew`/`apt`/`dnf`, and does not connect; environment variables are read when the server process starts. Use `Klass.available?` / `missing_envars` / `verify!` (raises `LoadError` like before) and `Klass.install_packages!`. `require 'shared_tools/mcp'` loads every definition, records availability for `SharedTools.mcp_status`, and `SharedTools::MCP.available` lists the usable classes.
 - **Breaking:** MCP server names are now symbol-friendly: `brave-search` → `brave_search`, `hugging-face` → `hugging_face`, `sequential-thinking` → `sequential_thinking` (others unchanged). These are the names in `SharedTools.mcp_status` and `chat.mcp[...]`.
 - Removed `lib/shared_tools/mcp/streamable_http_patch.rb`; it patched a `ruby_llm-mcp` internal. ruby_llm 2.1's spec-compliant SSE parser already handles mixed CRLF/LF line endings.
+- Added `description` to `SharedTools::MCP::ClientSupport` (class macro plus instance reader; subclasses inherit it) and gave every MCP client one. robot_lab's `mcp_discovery: true` scores servers by name plus description, so it can now pick e.g. `SharedTools::MCP::GitHub` for "open a pull request" and `Playwright` for "take a screenshot of the page".
+- Added `csv` as a runtime dependency. It is a bundled (not default) gem since Ruby 3.4, so `CsvReadTool`/`CsvWriteTool` -- and `SharedTools.tools` / `load_all_tools`, which eager-load them -- raised `LoadError: cannot load such file -- csv` in any bundle that did not list it.
 - Added `test/shared_tools/tool_classes_test.rb`: every shipped `RubyLLM::Tool` subclass must define its own `#execute`, expose an object `parameters_schema` whose properties `#execute` accepts, and no 1.x `params do` / `param :` may remain in `lib/`. It also calls `current_date_time`, `system_info` and `dns` (used by aia's demo 18) through `Tool#call` and checks the data they return. Added `test/shared_tools/mcp/clients_test.rb` (class-level only; no servers are started).
 - Updated the MCP examples, `lib/shared_tools/mcp/README.md`, `README.md` and `docs/` for the new MCP classes.
 

data/lib/shared_tools/mcp/brave_search_client.rb

@@ -30,6 +30,8 @@ module SharedTools
     class BraveSearch < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Brave web search: current web pages, news, and local results"
+
       requires_envars "BRAVE_API_KEY"
 
       command "npx", "-y", "@modelcontextprotocol/server-brave-search"

data/lib/shared_tools/mcp/chart_client.rb

@@ -29,6 +29,8 @@ module SharedTools
     class Chart < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Generate charts and data visualisations (bar, line, pie, maps, diagrams)"
+
       command "npx", "-y", "@antv/mcp-server-chart"
     end
   end

data/lib/shared_tools/mcp/client_support.rb

@@ -50,10 +50,29 @@ module SharedTools
     end
 
     module ClientSupport
+      # Instance-side reader, so a server instance answers #description the
+      # way robot_lab's RobotLab::MCP::Server does.
+      module InstanceMethods
+        def description
+          self.class.description.to_s
+        end
+      end
+
       def self.extended(klass)
+        klass.include(InstanceMethods)
         SharedTools::MCP.register(klass)
       end
 
+      # Declares (or, with no argument, returns) a short description of what
+      # the server offers. robot_lab's mcp_discovery scores servers by name
+      # plus description, so a description lets it pick this server for
+      # relevant messages. Subclasses inherit their parent's description.
+      def description(text = nil)
+        return @description || (superclass.description if superclass.respond_to?(:description)) if text.nil?
+
+        @description = text.to_s
+      end
+
       # Declares (or, with no arguments, returns) the environment variables
       # the server needs. All of them must be set for #available? to be true.
       def requires_envars(*names)

data/lib/shared_tools/mcp/github_client.rb

@@ -30,6 +30,8 @@ module SharedTools
     class GitHub < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "GitHub repositories, issues, pull requests, code search, commits, branches, and releases"
+
       self.default_name = "github"
 
       requires_envars   "GITHUB_PERSONAL_ACCESS_TOKEN"

data/lib/shared_tools/mcp/hugging_face_client.rb

@@ -32,6 +32,8 @@ module SharedTools
     class HuggingFace < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Hugging Face Hub: search models, datasets, Spaces, and papers"
+
       requires_envars   "HF_TOKEN"
       requires_packages "hf-mcp-server"
 

data/lib/shared_tools/mcp/memory_client.rb

@@ -30,6 +30,8 @@ module SharedTools
     class Memory < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Persistent knowledge graph memory: remember and recall facts, entities, and relations across conversations"
+
       command "npx", "-y", "@modelcontextprotocol/server-memory"
       # An unset MEMORY_FILE_PATH resolves to "", which the server treats as unset.
       env "MEMORY_FILE_PATH" => env_from("MEMORY_FILE_PATH")

data/lib/shared_tools/mcp/notion_client.rb

@@ -32,6 +32,8 @@ module SharedTools
     class Notion < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Notion workspace pages, databases, and search"
+
       requires_envars   "NOTION_TOKEN"
       requires_packages "notion-mcp-server"
 

data/lib/shared_tools/mcp/playwright_client.rb

@@ -32,6 +32,8 @@ module SharedTools
     class Playwright < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Browser automation: navigate web pages, click, type, fill forms, take screenshots"
+
       command "npx", "-y", "@playwright/mcp"
     end
   end

data/lib/shared_tools/mcp/sequential_thinking_client.rb

@@ -30,6 +30,8 @@ module SharedTools
     class SequentialThinking < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Step-by-step chain-of-thought reasoning for complex, multi-stage problems"
+
       command "npx", "-y", "@modelcontextprotocol/server-sequential-thinking"
     end
   end

data/lib/shared_tools/mcp/slack_client.rb

@@ -39,6 +39,8 @@ module SharedTools
     class Slack < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Slack channels, messages, threads, users, and search"
+
       TOKEN_ENVARS = %w[SLACK_MCP_XOXP_TOKEN SLACK_MCP_XOXB_TOKEN].freeze
 
       requires_packages "slack-mcp-server"

data/lib/shared_tools/mcp/tavily_client.rb

@@ -31,6 +31,8 @@ module SharedTools
     class Tavily < ::RubyLLM::MCP
       extend ClientSupport
 
+      description "Tavily web search and page extraction for research and current events"
+
       requires_envars "TAVILY_API_KEY"
 
       url "https://mcp.tavily.com/mcp/"

data/lib/shared_tools/tools/apply_patch_tool.rb

@@ -22,7 +22,7 @@ module SharedTools
     class ApplyPatchTool < ::RubyLLM::Tool
       GIT_ENV = { "GIT_PAGER" => "cat", "GIT_TERMINAL_PROMPT" => "0" }.freeze
 
-      def self.name = 'apply_patch'
+      def self.tool_name = 'apply_patch'
 
       description "Apply a unified diff to files under root (as produced by `git diff` / `diff -u`). " \
                   "Validates the patch first and reports the affected files; nothing is written if it " \

data/lib/shared_tools/tools/bash_tool.rb

@@ -24,7 +24,7 @@ module SharedTools
     class BashTool < ::RubyLLM::Tool
       DEFAULT_TIMEOUT = 30
 
-      def self.name = 'bash'
+      def self.tool_name = 'bash'
 
       description "Run a single ALLOWLISTED executable with arguments. " \
                   "No shell is involved: no pipes, redirects, globs, or variable expansion. " \

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

@@ -11,7 +11,7 @@ module SharedTools
       #   tool.execute(selector: "some text")
       #   tool.execute(selector: "//div[@role='button']")
       class ClickTool < ::RubyLLM::Tool
-        def self.name = 'browser_click'
+        def self.tool_name = 'browser_click'
 
         description "A browser automation tool for clicking any clickable element."
 

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

@@ -11,7 +11,7 @@ module SharedTools
     module Browser
       # A browser automation tool for finding UI elements by their text content.
       class InspectTool < ::RubyLLM::Tool
-        def self.name = 'browser_inspect'
+        def self.tool_name = 'browser_inspect'
 
         include InspectUtils
 

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

@@ -11,7 +11,7 @@ module SharedTools
     module Browser
       # A browser automation tool for viewing the full HTML of the page.
       class PageInspectTool < ::RubyLLM::Tool
-        def self.name = 'browser_page_inspect'
+        def self.tool_name = 'browser_page_inspect'
 
         include InspectUtils
 

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

@@ -7,7 +7,7 @@ module SharedTools
       # Saves the screenshot to a file and returns the path — avoids injecting
       # large base64 blobs into the conversation context.
       class PageScreenshotTool < ::RubyLLM::Tool
-        def self.name = 'browser_page_screenshot'
+        def self.tool_name = 'browser_page_screenshot'
 
         description "Take a screenshot of the current browser page and save it to a file."
 

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

@@ -11,7 +11,7 @@ module SharedTools
     module Browser
       # A browser automation tool for inspecting elements using CSS selectors.
       class SelectorInspectTool < ::RubyLLM::Tool
-        def self.name = 'browser_selector_inspect'
+        def self.tool_name = 'browser_selector_inspect'
 
         include InspectUtils
 

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

@@ -8,7 +8,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Browser::TextFieldSetTool.new(browser:)
       #   tool.execute(selector: "...", text: "...")
       class TextFieldAreaSetTool < ::RubyLLM::Tool
-        def self.name = 'browser_text_field_set'
+        def self.tool_name = 'browser_text_field_set'
 
         description "A browser automation tool for clicking a specific link."
 

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

@@ -8,7 +8,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Browser::VisitTool.new(driver:)
       #   tool.execute(to: "https://news.ycombinator.com")
       class VisitTool < ::RubyLLM::Tool
-        def self.name = 'browser_visit'
+        def self.tool_name = 'browser_visit'
 
         description "A browser automation tool for navigating to a specific URL."
 

data/lib/shared_tools/tools/browser_tool.rb

@@ -6,7 +6,7 @@ module SharedTools
   module Tools
     # A tool for controller a browser.
     class BrowserTool < ::RubyLLM::Tool
-      def self.name = 'browser_tool' 
+      def self.tool_name = 'browser'
       module Action
         VISIT = "visit"
         PAGE_INSPECT = "page_inspect"

data/lib/shared_tools/tools/bundle_tool.rb

@@ -21,7 +21,7 @@ module SharedTools
       NAME_RE = /\A[A-Za-z0-9_.-]+\z/
       DEFAULT_TIMEOUT = 180
 
-      def self.name = 'bundle'
+      def self.tool_name = 'bundle'
 
       description "Run Bundler in a project. Actions: install, update, outdated, check, lock, add. " \
                   "For 'add' provide a gem name; for 'update' a gem name is optional (omit to update " \

data/lib/shared_tools/tools/calculator_tool.rb

@@ -11,7 +11,7 @@ end
 module SharedTools
   module Tools
     class CalculatorTool < RubyLLM::Tool
-      def self.name = 'calculator'
+      def self.tool_name = 'calculator'
 
       def available?
         DENTAKU_AVAILABLE

data/lib/shared_tools/tools/clipboard_tool.rb

@@ -13,7 +13,7 @@ module SharedTools
     #   tool.execute(action: 'read')
     #   tool.execute(action: 'clear')
     class ClipboardTool < ::RubyLLM::Tool
-      def self.name = 'clipboard_tool'
+      def self.tool_name = 'clipboard'
 
       description <<~DESC
         Read from, write to, and clear the system clipboard.

data/lib/shared_tools/tools/composite_analysis_tool.rb

@@ -5,7 +5,7 @@ require 'json'
 module SharedTools
   module Tools
     class CompositeAnalysisTool < RubyLLM::Tool
-      def self.name = "composite_analysis"
+      def self.tool_name = "composite_analysis"
 
       description <<~'DESCRIPTION'
         Perform comprehensive multi-stage data analysis by orchestrating multiple specialized analysis steps

data/lib/shared_tools/tools/computer_tool.rb

@@ -11,7 +11,7 @@ module SharedTools
     #   computer.execute(action: 'mouse_position')
     #   computer.execute(action: 'type', text: 'Hello')
     class ComputerTool < ::RubyLLM::Tool
-      def self.name = 'computer_tool' 
+      def self.tool_name = 'computer'
       description "A tool for interacting with a computer."
 
       module Action

data/lib/shared_tools/tools/cron_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
     #   tool.execute(action: 'next_times', expression: '0 * * * *', count: 5)
     #   tool.execute(action: 'generate',   description: 'every day at 9am')
     class CronTool < ::RubyLLM::Tool
-      def self.name = 'cron_tool'
+      def self.tool_name = 'cron'
 
       description <<~DESC
         Parse, validate, explain, and generate cron expressions (standard 5-field format).

data/lib/shared_tools/tools/csv_read_tool.rb

@@ -16,7 +16,7 @@ module SharedTools
       MAX_BYTES = 10 * 1024 * 1024
       DEFAULT_LIMIT = 100
 
-      def self.name = 'csv_read'
+      def self.tool_name = 'csv_read'
 
       description "Read a CSV file and return its rows. By default the first row is treated as a " \
                   "header. Use limit to cap the number of data rows returned."

data/lib/shared_tools/tools/csv_write_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
     #   tool = SharedTools::Tools::CsvWriteTool.new
     #   tool.execute(path: "./out.csv", headers: ["name", "age"], rows: [["Alice", 30]])
     class CsvWriteTool < ::RubyLLM::Tool
-      def self.name = 'csv_write'
+      def self.tool_name = 'csv_write'
 
       description "Write rows to a CSV file. Provide rows as an array of arrays (each inner array " \
                   "is a row of cell values, written as strings), with an optional headers array " \

data/lib/shared_tools/tools/current_date_time_tool.rb

@@ -12,7 +12,7 @@ module SharedTools
     #   tool.execute                    # full output
     #   tool.execute(format: 'date')    # date fields only
     class CurrentDateTimeTool < ::RubyLLM::Tool
-      def self.name = 'current_date_time_tool'
+      def self.tool_name = 'current_date_time'
 
       description <<~DESC
         Returns the current date, time, timezone, and calendar metadata from the system clock.
@@ -41,7 +41,7 @@ module SharedTools
         @logger.info("CurrentDateTimeTool#execute format=#{format}")
 
         now = Time.now
-        utc = now.utc
+        utc = now.getutc # getutc returns a copy; Time#utc would convert now in place
 
         date_info = {
           year:            now.year,

data/lib/shared_tools/tools/data_science_kit.rb

@@ -5,7 +5,7 @@ require 'json'
 module SharedTools
   module Tools
     class DataScienceKit < RubyLLM::Tool
-      def self.name = "data_science_kit"
+      def self.tool_name = "data_science_kit"
 
       description <<~'DESCRIPTION'
         Comprehensive data science and analytics toolkit for performing statistical analysis,

data/lib/shared_tools/tools/database_query_tool.rb

@@ -11,7 +11,7 @@ end
 module SharedTools
   module Tools
     class DatabaseQueryTool < RubyLLM::Tool
-      def self.name = 'database_query'
+      def self.tool_name = 'database_query'
 
       def available?
         SEQUEL_AVAILABLE

data/lib/shared_tools/tools/database_tool.rb

@@ -10,7 +10,7 @@ module SharedTools
     #   tool = SharedTools::Tools::DatabaseTool.new(driver:)
     #   tool.execute(statements: ["SELECT * FROM people"])
     class DatabaseTool < ::RubyLLM::Tool
-      def self.name = 'database_tool' 
+      def self.tool_name = 'database'
       description <<~TEXT
         Executes SQL commands (INSERT / UPDATE / SELECT / etc) on a database.
 

data/lib/shared_tools/tools/diff_tool.rb

@@ -12,7 +12,7 @@ module SharedTools
     #   tool = SharedTools::Tools::DiffTool.new
     #   tool.execute(old: "a\nb\n", new: "a\nc\n")
     class DiffTool < ::RubyLLM::Tool
-      def self.name = 'diff'
+      def self.tool_name = 'diff'
 
       description "Compare two blocks of text and return a readable line-by-line diff " \
                   "(removed lines prefixed -, added lines prefixed +). In-process."

data/lib/shared_tools/tools/disk/directory_create_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Disk::DirectoryCreateTool.new(root: "./project")
       #   tool.execute(path: "./foo/bar")
       class DirectoryCreateTool < ::RubyLLM::Tool
-        def self.name = 'disk_directory_create'
+        def self.tool_name = 'disk_directory_create'
 
         description "Creates a directory."
 

data/lib/shared_tools/tools/disk/directory_delete_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Disk::DirectoryDeleteTool.new(root: "./project")
       #   tool.execute(path: "./foo/bar")
       class DirectoryDeleteTool < ::RubyLLM::Tool
-        def self.name = 'disk_directory_delete'
+        def self.tool_name = 'disk_directory_delete'
 
         description "Deletes a directory."
 

data/lib/shared_tools/tools/disk/directory_list_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Disk::SummaryTool.new(root: "./project")
       #   tool.execute
       class DirectoryListTool < ::RubyLLM::Tool
-        def self.name = 'disk_directory_list'
+        def self.tool_name = 'disk_directory_list'
 
         description "Summarizes the contents (files and directories) of a directory."
 

data/lib/shared_tools/tools/disk/directory_move_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Disk::DirectoryMoveTool.new(root: "./project")
       #   tool.execute(path: "./foo", destination: "./bar")
       class DirectoryMoveTool < ::RubyLLM::Tool
-        def self.name = 'disk_directory_move'
+        def self.tool_name = 'disk_directory_move'
 
         description "Moves a directory from one location to another."
 

data/lib/shared_tools/tools/disk/file_create_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Disk::FileCreateTool.new(root: "./project")
       #   tool.execute(path: "./README.md")
       class FileCreateTool < ::RubyLLM::Tool
-        def self.name = 'disk_file_create'
+        def self.tool_name = 'disk_file_create'
 
         description "Creates a file."
 

data/lib/shared_tools/tools/disk/file_delete_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Disk::FileDeleteTool.new(root: "./project")
       #   tool.execute(path: "./README.md")
       class FileDeleteTool < ::RubyLLM::Tool
-        def self.name = 'disk_file_delete'
+        def self.tool_name = 'disk_file_delete'
 
         description "Deletes a file."
 

data/lib/shared_tools/tools/disk/file_move_tool.rb

@@ -12,7 +12,7 @@ module SharedTools
       #     destination: "./README.md",
       #   )
       class FileMoveTool < ::RubyLLM::Tool
-        def self.name = 'disk_file_move'
+        def self.tool_name = 'disk_file_move'
 
         description "Moves a file."
 

data/lib/shared_tools/tools/disk/file_read_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Disk::FileReadTool.new
       #   tool.execute(path: "./README.md") # => "..."
       class FileReadTool < ::RubyLLM::Tool
-        def self.name = 'disk_file_read'
+        def self.tool_name = 'disk_file_read'
 
         description "Reads the contents of a file."
 

data/lib/shared_tools/tools/disk/file_replace_tool.rb

@@ -13,7 +13,7 @@ module SharedTools
       #     path: "README.md"
       #   )
       class FileReplaceTool < ::RubyLLM::Tool
-        def self.name = 'disk_file_replace'
+        def self.tool_name = 'disk_file_replace'
 
         description "Replaces a specific string in a file (old_text => new_text)."
 

data/lib/shared_tools/tools/disk/file_write_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #    tool = SharedTools::Tools::Disk::FileWriteTool.new(root: "./project")
       #    tool.execute(path: "./README.md", text: "Hello World")
       class FileWriteTool < ::RubyLLM::Tool
-        def self.name = 'disk_file_write'
+        def self.tool_name = 'disk_file_write'
 
         description "Writes the contents of a file."
 

data/lib/shared_tools/tools/disk_tool.rb

@@ -13,7 +13,7 @@ module SharedTools
     #   disk.execute(action: SharedTools::Tools::DiskTool::Action::FILE_READ, path: "./demo.rb")
     #   disk.execute(action: SharedTools::Tools::DiskTool::Action::FILE_DELETE, path: "./demo.rb")
     class DiskTool < ::RubyLLM::Tool
-      def self.name = 'disk_tool' 
+      def self.tool_name = 'disk'
       description <<~TEXT
         A tool for interacting with a system. It is able to list, create, delete, move and modify directories and files.
       TEXT

data/lib/shared_tools/tools/dns_tool.rb

@@ -20,7 +20,7 @@ module SharedTools
     #   tool.execute(action: 'whois',       host: 'github.com')
     #   tool.execute(action: 'whois',       host: '8.8.8.8')
     class DnsTool < ::RubyLLM::Tool
-      def self.name = 'dns_tool'
+      def self.tool_name = 'dns'
 
       description <<~DESC
         Perform DNS lookups, reverse lookups, record queries, external IP detection,

data/lib/shared_tools/tools/doc/docx_reader_tool.rb

@@ -16,7 +16,7 @@ module SharedTools
       #   tool.execute(doc_path: "./report.docx")
       #   tool.execute(doc_path: "./report.docx", paragraph_range: "1-10")
       class DocxReaderTool < ::RubyLLM::Tool
-        def self.name = 'doc_docx_read'
+        def self.tool_name = 'doc_docx_read'
 
         description "Read the text content of a Microsoft Word (.docx) document."
 

data/lib/shared_tools/tools/doc/pdf_reader_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Doc::PdfReaderTool.new
       #   tool.execute(doc_path: "./document.pdf", page_numbers: "1, 5, 10")
       class PdfReaderTool < ::RubyLLM::Tool
-        def self.name = 'doc_pdf_read'
+        def self.tool_name = 'doc_pdf_read'
 
         description "Read the text of any set of pages from a PDF document."
 

data/lib/shared_tools/tools/doc/spreadsheet_reader_tool.rb

@@ -21,7 +21,7 @@ module SharedTools
       # @example Read a row range from a worksheet
       #   tool.execute(doc_path: "./report.xlsx", sheet: "Summary", row_range: "2-50")
       class SpreadsheetReaderTool < ::RubyLLM::Tool
-        def self.name = 'doc_spreadsheet_read'
+        def self.tool_name = 'doc_spreadsheet_read'
 
         description "Read tabular data from spreadsheet files (CSV, XLSX, ODS, and other formats)."
 

data/lib/shared_tools/tools/doc/text_reader_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Doc::TextReaderTool.new
       #   tool.execute(doc_path: "./guide.txt")
       class TextReaderTool < ::RubyLLM::Tool
-        def self.name = 'doc_text_read'
+        def self.tool_name = 'doc_text_read'
 
         description "Read the full contents of a plain text file."
 

data/lib/shared_tools/tools/doc_tool.rb

@@ -6,7 +6,7 @@ module SharedTools
   module Tools
     # A tool for reading and processing documents
     class DocTool < ::RubyLLM::Tool
-      def self.name = 'doc_tool'
+      def self.tool_name = 'doc'
 
       module Action
         PDF_READ         = "pdf_read"

data/lib/shared_tools/tools/docker/compose_run_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Docker::ComposeRunTool.new
       #   tool.execute(service: "app", command: "rspec", args: ["spec/main_spec.rb"])
       class ComposeRunTool < ::RubyLLM::Tool
-        def self.name = 'docker_compose_run'
+        def self.tool_name = 'docker_compose_run'
 
         description "Runs a command via Docker with arguments on the project (e.g. `rspec spec/main_spec.rb`)."
 

data/lib/shared_tools/tools/download_file_tool.rb

@@ -20,7 +20,7 @@ module SharedTools
     class DownloadFileTool < ::RubyLLM::Tool
       include HttpHelpers
 
-      def self.name = 'download_file'
+      def self.tool_name = 'download_file'
 
       description "Download an http/https URL to a file within root. SSRF-protected and " \
                   "size-capped. Use for fetching an asset or release to disk (web_fetch returns text " \

data/lib/shared_tools/tools/error_handling_tool.rb

@@ -22,7 +22,7 @@ module SharedTools
     class ResourceNotFoundError < StandardError; end
 
     class ErrorHandlingTool < RubyLLM::Tool
-      def self.name = 'error_handling_tool'
+      def self.tool_name = 'error_handling'
 
       description <<~'DESCRIPTION'
         Reference tool demonstrating comprehensive error handling patterns and resilience strategies

data/lib/shared_tools/tools/eval/python_eval_tool.rb

@@ -8,7 +8,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Eval::PythonEvalTool.new
       #   tool.execute(code: "print('Hello'); result = 2 + 2")
       class PythonEvalTool < ::RubyLLM::Tool
-        def self.name = 'eval_python'
+        def self.tool_name = 'eval_python'
 
         description <<~DESCRIPTION
                       Execute Python source code safely and return the result.

data/lib/shared_tools/tools/eval/ruby_eval_tool.rb

@@ -9,7 +9,7 @@ module SharedTools
       #   tool = SharedTools::Tools::Eval::RubyEvalTool.new
       #   tool.execute(code: "puts 'Hello'; 2 + 2")
       class RubyEvalTool < ::RubyLLM::Tool
-        def self.name = 'eval_ruby'
+        def self.tool_name = 'eval_ruby'
 
         description <<~DESCRIPTION
                       Execute Ruby source code safely and return the result.

data/lib/shared_tools/tools/eval/shell_eval_tool.rb

@@ -13,7 +13,7 @@ module SharedTools
         STDOUT_MAX = 5000
         STDERR_MAX = 2000
 
-        def self.name = 'eval_shell'
+        def self.tool_name = 'eval_shell'
 
         description "Execute a shell command safely and return the result."
 

data/lib/shared_tools/tools/eval_tool.rb

@@ -6,7 +6,7 @@ module SharedTools
   module Tools
     # A tool for evaluating code in different programming languages
     class EvalTool < ::RubyLLM::Tool
-      def self.name = 'eval_tool'
+      def self.tool_name = 'eval'
 
       module Action
         RUBY = "ruby"

data/lib/shared_tools/tools/gem_tool.rb

@@ -26,7 +26,7 @@ module SharedTools
       NAME_RE = /\A[A-Za-z0-9_.-]+\z/
       HOST = "https://rubygems.org"
 
-      def self.name = 'gem'
+      def self.tool_name = 'gem'
 
       description "Look up RubyGems.org metadata for a gem (read-only). Actions: info (summary), " \
                   "version (latest version), dependencies (runtime deps), search (find gems by " \

data/lib/shared_tools/tools/git/add_tool.rb

@@ -15,7 +15,7 @@ module SharedTools
       class AddTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_add'
+        def self.tool_name = 'git_add'
 
         description "Stage changes in the repository. Pass specific paths, or set all to stage " \
                     "every change (git add -A)."

data/lib/shared_tools/tools/git/blame_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
       class BlameTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_blame'
+        def self.tool_name = 'git_blame'
 
         description "Show git blame for a file in the repository: which commit, author, and date " \
                     "last touched each line. Optionally limit to a line range. Read-only."

data/lib/shared_tools/tools/git/branch_tool.rb

@@ -15,7 +15,7 @@ module SharedTools
       class BranchTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_branch'
+        def self.tool_name = 'git_branch'
 
         description "List the branches of the repository, with the current branch marked (*) and " \
                     "each branch's tip commit. Set all true to include remote-tracking branches. Read-only."

data/lib/shared_tools/tools/git/checkout_tool.rb

@@ -17,7 +17,7 @@ module SharedTools
       class CheckoutTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_checkout'
+        def self.tool_name = 'git_checkout'
 
         description "Switch to a branch/commit in the repository, or create a new branch with " \
                     "create: true. Note this can change the working tree."

data/lib/shared_tools/tools/git/commit_tool.rb

@@ -16,7 +16,7 @@ module SharedTools
       class CommitTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_commit'
+        def self.tool_name = 'git_commit'
 
         description "Commit staged changes in the repository with a message. Set all to also " \
                     "stage modified/deleted tracked files first (git commit -a). Does not push."

data/lib/shared_tools/tools/git/diff_tool.rb

@@ -16,7 +16,7 @@ module SharedTools
       class DiffTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_diff'
+        def self.tool_name = 'git_diff'
 
         description "Show a unified git diff for the repository. By default shows unstaged " \
                     "changes; set staged to show what's staged. Optionally scope to a path or diff " \

data/lib/shared_tools/tools/git/grep_tool.rb

@@ -16,7 +16,7 @@ module SharedTools
       class GrepTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_grep'
+        def self.tool_name = 'git_grep'
 
         description "Search the tracked files of the repository for a pattern using git grep, " \
                     "returning file:line: matches. Optionally restrict to a path, ignore case, or treat " \

data/lib/shared_tools/tools/git/log_tool.rb

@@ -17,7 +17,7 @@ module SharedTools
         MAX_COUNT     = 200
         FORMAT        = "%h %ad %an: %s"
 
-        def self.name = 'git_log'
+        def self.tool_name = 'git_log'
 
         description "Show recent git commit history for the repository (hash, date, author, " \
                     "subject). Optionally limit the count or scope to a path. Read-only."

data/lib/shared_tools/tools/git/show_tool.rb

@@ -15,7 +15,7 @@ module SharedTools
       class ShowTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_show'
+        def self.tool_name = 'git_show'
 
         description "Show a git object in the repository. With no path, shows the commit at ref " \
                     "(message and diff). With a path, shows that file's contents as of ref. Defaults " \

data/lib/shared_tools/tools/git/status_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
       class StatusTool < ::RubyLLM::Tool
         include Helpers
 
-        def self.name = 'git_status'
+        def self.tool_name = 'git_status'
 
         description "Show the git working-tree status of the repository: current branch and " \
                     "staged, unstaged, and untracked changes. Read-only."

data/lib/shared_tools/tools/git_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
     #   git.execute(action: SharedTools::Tools::GitTool::Action::LOG, count: 5)
     #   git.execute(action: SharedTools::Tools::GitTool::Action::COMMIT, message: "Fix the thing")
     class GitTool < ::RubyLLM::Tool
-      def self.name = 'git_tool'
+      def self.tool_name = 'git'
 
       description <<~TEXT
         A tool for interacting with a git repository. Read-only actions (status, diff, log, show,

data/lib/shared_tools/tools/glob_tool.rb

@@ -17,7 +17,7 @@ module SharedTools
     class GlobTool < ::RubyLLM::Tool
       MAX_RESULTS = 1_000
 
-      def self.name = 'glob'
+      def self.tool_name = 'glob'
 
       description "Find files matching a glob pattern within a directory (e.g. '**/*.rb', " \
                   "'app/models/*.rb'). Returns matching paths, sorted, relative to base."

data/lib/shared_tools/tools/http_request_tool.rb

@@ -21,7 +21,7 @@ module SharedTools
       MUTATING_METHODS = %w[POST PUT PATCH DELETE].freeze
       SHOWN_HEADERS = %w[content-type content-length location etag last-modified].freeze
 
-      def self.name = 'http_request'
+      def self.tool_name = 'http_request'
 
       description "Make an HTTP request to an http/https URL and return the status, headers, and " \
                   "body. GET and HEAD are available by default; POST/PUT/PATCH/DELETE require user " \

data/lib/shared_tools/tools/json_query_tool.rb

@@ -19,7 +19,7 @@ module SharedTools
     class JsonQueryTool < ::RubyLLM::Tool
       MAX_BYTES = 5 * 1024 * 1024
 
-      def self.name = 'json_query'
+      def self.tool_name = 'json_query'
 
       description "Query JSON with a path expression, or pretty-print it. Provide either a file " \
                   "path or an inline json string. Path syntax: keys separated by dots, [n] for " \

data/lib/shared_tools/tools/lint_tool.rb

@@ -20,7 +20,7 @@ module SharedTools
       LINTERS = %w[rubocop standard].freeze
       DEFAULT_TIMEOUT = 120
 
-      def self.name = 'lint'
+      def self.tool_name = 'lint'
 
       description "Lint a project with RuboCop or Standard. Auto-detects (Standard if .standard.yml " \
                   "is present, else RuboCop) or set linter explicitly. Optionally scope to a path and " \

data/lib/shared_tools/tools/multi_edit_tool.rb

@@ -23,7 +23,7 @@ module SharedTools
 
       MAX_BYTES = 10 * 1024 * 1024
 
-      def self.name = 'multi_edit'
+      def self.tool_name = 'multi_edit'
 
       description "Apply multiple find/replace edits to a single file atomically. Provide edits as " \
                   "an array of objects with old_string, new_string, and optional replace_all. Edits " \

data/lib/shared_tools/tools/notification_tool.rb

@@ -18,7 +18,7 @@ module SharedTools
     # @example Text-to-speech
     #   tool.execute(action: 'speak', message: 'Task finished')
     class NotificationTool < ::RubyLLM::Tool
-      def self.name = 'notification_tool'
+      def self.tool_name = 'notification'
 
       description <<~DESC.strip
         Send desktop notifications, modal alerts, or text-to-speech messages.

data/lib/shared_tools/tools/parse_ruby_tool.rb

@@ -20,7 +20,7 @@ module SharedTools
       KINDS = %w[class module method constant].freeze
       MAX_BYTES = 5 * 1024 * 1024
 
-      def self.name = 'parse_ruby'
+      def self.tool_name = 'parse_ruby'
 
       description "Outline a Ruby file's structure (classes, modules, methods, constants with line " \
                   "numbers), or locate definitions. Give a query to find definitions whose name " \

data/lib/shared_tools/tools/process_kill_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
     #   tool = SharedTools::Tools::ProcessKillTool.new
     #   tool.execute(id: "proc_1")
     class ProcessKillTool < ::RubyLLM::Tool
-      def self.name = 'process_kill'
+      def self.tool_name = 'process_kill'
 
       description "Stop a background process (started with process_start) and return any final " \
                   "output. Terminates the whole process group, escalating to SIGKILL if needed."

data/lib/shared_tools/tools/process_list_tool.rb

@@ -13,7 +13,7 @@ module SharedTools
     #   tool = SharedTools::Tools::ProcessListTool.new
     #   tool.execute
     class ProcessListTool < ::RubyLLM::Tool
-      def self.name = 'process_list'
+      def self.tool_name = 'process_list'
 
       description "List background processes (started with process_start): id, status, pid, age, and " \
                   "command. Read-only."

data/lib/shared_tools/tools/process_output_tool.rb

@@ -14,7 +14,7 @@ module SharedTools
     #   tool = SharedTools::Tools::ProcessOutputTool.new
     #   tool.execute(id: "proc_1")
     class ProcessOutputTool < ::RubyLLM::Tool
-      def self.name = 'process_output'
+      def self.tool_name = 'process_output'
 
       description "Read new stdout/stderr from a background process (started with process_start) " \
                   "since the last read, along with its status and exit code if it has finished. Poll " \

data/lib/shared_tools/tools/python_tests_tool.rb

@@ -22,7 +22,7 @@ module SharedTools
       FRAMEWORKS = %w[pytest unittest].freeze
       DEFAULT_TIMEOUT = 180
 
-      def self.name = 'python_tests'
+      def self.tool_name = 'python_tests'
 
       description "Run a Python project's test suite from root and report results. Uses pytest by " \
                   "default, or unittest (python -m unittest discover) when framework is unittest. " \

data/lib/shared_tools/tools/replace_in_files_tool.rb

@@ -21,7 +21,7 @@ module SharedTools
       REGEX_TIMEOUT = 2
       IGNORED_DIRS = %w[.git .hg .svn node_modules .bundle tmp].freeze
 
-      def self.name = 'replace_in_files'
+      def self.tool_name = 'replace_in_files'
 
       description "Replace occurrences of a pattern with a replacement across files in root " \
                   "matching a glob (default '**/*'). Literal by default; set regex true to use a " \

data/lib/shared_tools/tools/run_tests_tool.rb

@@ -21,7 +21,7 @@ module SharedTools
       FRAMEWORKS = %w[rspec minitest].freeze
       DEFAULT_TIMEOUT = 180
 
-      def self.name = 'run_tests'
+      def self.tool_name = 'run_tests'
 
       description "Run a Ruby project's test suite from root and report results. Auto-detects RSpec " \
                   "(spec/ or .rspec) or Minitest (test/ via rake), or set framework explicitly. " \

data/lib/shared_tools/tools/search_codebase_tool.rb

@@ -29,7 +29,7 @@ module SharedTools
       REGEX_TIMEOUT = 2
       IGNORED_DIRS = %w[.git .hg .svn node_modules .bundle tmp].freeze
 
-      def self.name = 'search_codebase'
+      def self.tool_name = 'search_codebase'
 
       description "Search file contents for a regular expression under a directory. Returns " \
                   "'path:line: text' for each match, or context blocks when context/before/after " \

data/lib/shared_tools/tools/secure_tool_template.rb

@@ -6,7 +6,7 @@ require 'securerandom'
 module SharedTools
   module Tools
     class SecureToolTemplate < RubyLLM::Tool
-      def self.name = 'secure_tool_template'
+      def self.tool_name = 'secure_tool_template'
 
       description <<~'DESCRIPTION'
         Reference template demonstrating comprehensive security best practices for safe tool development.

data/lib/shared_tools/tools/system_info_tool.rb

@@ -11,7 +11,7 @@ module SharedTools
     #   tool.execute                     # all categories
     #   tool.execute(category: 'cpu')    # CPU only
     class SystemInfoTool < ::RubyLLM::Tool
-      def self.name = 'system_info_tool'
+      def self.tool_name = 'system_info'
 
       description <<~DESC
         Retrieve system information from the local machine.

data/lib/shared_tools/tools/todo_write_tool.rb

@@ -21,7 +21,7 @@ module SharedTools
       STATUSES = %w[pending in_progress completed].freeze
       MARKS = { "pending" => "[ ]", "in_progress" => "[~]", "completed" => "[x]" }.freeze
 
-      def self.name = 'todo_write'
+      def self.tool_name = 'todo_write'
 
       description "Maintain a task list for multi-step work. Pass the full list of todos; each call " \
                   "replaces the previous list. Each todo has a content string and a status of " \

data/lib/shared_tools/tools/toml_query_tool.rb

@@ -19,7 +19,7 @@ module SharedTools
     class TomlQueryTool < ::RubyLLM::Tool
       MAX_BYTES = 5 * 1024 * 1024
 
-      def self.name = 'toml_query'
+      def self.tool_name = 'toml_query'
 
       description "Query TOML with a path expression, or pretty-print it. Provide either a file " \
                   "path or an inline toml string. Path syntax: keys separated by dots, [n] for " \

data/lib/shared_tools/tools/tree_tool.rb

@@ -18,7 +18,7 @@ module SharedTools
       MAX_ENTRIES = 500
       IGNORED_DIRS = %w[.git .hg .svn node_modules .bundle tmp].freeze
 
-      def self.name = 'tree'
+      def self.tool_name = 'tree'
 
       description "Show a directory tree, to a limited depth. Directories are marked with a " \
                   "trailing slash. Skips ignored directories (node_modules, .git, ...) and hidden " \

data/lib/shared_tools/tools/weather_tool.rb

@@ -11,7 +11,7 @@ end
 module SharedTools
   module Tools
     class WeatherTool < RubyLLM::Tool
-      def self.name = 'weather_tool'
+      def self.tool_name = 'weather'
 
       def available?
         OPENWEATHERMAP_AVAILABLE

data/lib/shared_tools/tools/web_fetch_tool.rb

@@ -16,7 +16,7 @@ module SharedTools
     class WebFetchTool < ::RubyLLM::Tool
       include HttpHelpers
 
-      def self.name = 'web_fetch'
+      def self.tool_name = 'web_fetch'
 
       description "Fetch a web page or text/JSON resource over http/https and return its readable " \
                   "content (HTML is converted to text). Follows redirects safely. Cannot reach " \

data/lib/shared_tools/tools/workflow_manager_tool.rb

@@ -7,7 +7,7 @@ require 'fileutils'
 module SharedTools
   module Tools
     class WorkflowManagerTool < RubyLLM::Tool
-      def self.name = 'workflow_manager'
+      def self.tool_name = 'workflow_manager'
 
       description <<~'DESCRIPTION'
         Manage complex multi-step workflows with persistent state tracking across tool invocations.

data/lib/shared_tools/tools/yaml_query_tool.rb

@@ -21,7 +21,7 @@ module SharedTools
       MAX_BYTES = 5 * 1024 * 1024
       PERMITTED = [Date, Time, Symbol].freeze
 
-      def self.name = 'yaml_query'
+      def self.tool_name = 'yaml_query'
 
       description "Query YAML with a path expression, or pretty-print it. Provide either a file " \
                   "path or an inline yaml string. Loaded safely (no object deserialization). Path " \

data/lib/shared_tools/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SharedTools
-  VERSION = "0.6.0"
+  VERSION = "0.7.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shared_tools
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.1
 platform: ruby
 authors:
   - Dewayne VanHoozer
@@ -65,6 +65,22 @@ dependencies:
           - ">="
           - !ruby/object:Gem::Version
             version: "0"
+  - !ruby/object:Gem::Dependency
+    name: csv
+    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: bigdecimal
     requirement: !ruby/object:Gem::Requirement
@@ -97,6 +113,22 @@ dependencies:
           - ">="
           - !ruby/object:Gem::Version
             version: "0"
+  - !ruby/object:Gem::Dependency
+    name: tsort
+    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: sequel
     requirement: !ruby/object:Gem::Requirement