shared_tools 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95941947776da1920fb3f5d5a5c0a1866d2170810e23cbcfb53e55e79ee32847
-  data.tar.gz: be6b46bce0292f7c0092146fe85b09d6572ea1c2fbd0daf8268cfb6e417d3ea3
+  metadata.gz: 34cacf7e0ae9289b41abac0941cd1123ff725d8dbac4d8ed8d793e7a01fdac88
+  data.tar.gz: cba8ee56b7c22b41847ce844c09edffb2e29a49844cd79a6eab1ccab758b25a3
 SHA512:
-  metadata.gz: 28c25227c7fa22fe93e56c48136855edb59193dbcc3ea3ca7236e1de4e9512d76f70256dd6d00f47386243fed9aa2589a9d98ba57703cd68f7c8c4139f0588e3
-  data.tar.gz: ca6d285368be559a1642e344c4909a05b44fa143ce5d76ebc21471a347912ff3553ec866b416b560b3bacc56672fb275427426d87a52f538e493b4b447cbb8b0
+  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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SharedTools
-  VERSION = "0.7.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.7.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