llm_chain 0.5.3 → 0.5.5

data/lib/llm_chain/tools/tool_manager.rb

@@ -1,6 +1,12 @@
+# frozen_string_literal: true
+
+require_relative '../interfaces/tool_manager'
+
 module LLMChain
   module Tools
-    class ToolManager
+    # ToolManager manages registration, selection, and execution of tools in LLMChain.
+    # Implements the LLMChain::Interfaces::ToolManager interface.
+    class ToolManager < Interfaces::ToolManager
       attr_reader :tools
 
       def initialize(tools: [])
@@ -8,43 +14,49 @@ module LLMChain
         tools.each { |tool| register_tool(tool) }
       end
 
-      # Регистрирует новый инструмент
+      # Register a new tool instance.
+      # @param tool [LLMChain::Tools::Base]
+      # @return [void]
       def register_tool(tool)
-        unless tool.is_a?(BaseTool)
-          raise ArgumentError, "Tool must inherit from BaseTool"
+        unless tool.is_a?(Base)
+          raise ArgumentError, "Tool must inherit from LLMChain::Tools::Base"
         end
         @tools[tool.name] = tool
       end
 
-      # Удаляет инструмент
+      # Unregister a tool by name.
+      # @param name [String]
+      # @return [void]
       def unregister_tool(name)
         @tools.delete(name.to_s)
       end
 
-      # Получает инструмент по имени
+      # Fetch a tool by its name.
+      # @param name [String]
+      # @return [LLMChain::Tools::Base, nil]
       def get_tool(name)
         @tools[name.to_s]
       end
 
-      # Возвращает список всех инструментов
+      # List all registered tools.
+      # @return [Array<LLMChain::Tools::Base>]
       def list_tools
         @tools.values
       end
 
-      # Получает схемы всех инструментов для LLM
-      def get_tools_schema
-        @tools.values.map(&:to_schema)
-      end
-
-      # Находит подходящие инструменты для промпта
+      # Find tools whose #match? returns true for the prompt.
+      # @param prompt [String]
+      # @return [Array<LLMChain::Tools::Base>]
       def find_matching_tools(prompt)
         @tools.values.select { |tool| tool.match?(prompt) }
       end
 
-      # Выполняет все подходящие инструменты
+      # Execute every matching tool and collect results.
+      # @param prompt [String]
+      # @param context [Hash]
+      # @return [Hash] mapping tool name → result hash
       def execute_tools(prompt, context: {})
         matching_tools = find_matching_tools(prompt)
-        
         results = {}
         matching_tools.each do |tool|
           begin
@@ -62,102 +74,45 @@ module LLMChain
             }
           end
         end
-
         results
       end
 
-      # Выполняет конкретный инструмент по имени
-      def execute_tool(name, prompt, context: {})
-        tool = get_tool(name)
-        raise ArgumentError, "Tool '#{name}' not found" unless tool
-
-        begin
-          result = tool.call(prompt, context: context)
-          {
-            success: true,
-            result: result,
-            formatted: tool.format_result(result)
-          }
-        rescue => e
-          {
-            success: false,
-            error: e.message,
-            formatted: "Error in #{name}: #{e.message}"
-          }
-        end
-      end
-
-      # Создает стандартный набор инструментов
-      def self.create_default_toolset
-        tools = [
-          Calculator.new,
-          WebSearch.new,
-          CodeInterpreter.new
-        ]
-        
-        new(tools: tools)
-      end
-
-      # Создает набор инструментов из конфигурации
-      def self.from_config(config)
-        tools = []
-        
-        config.each do |tool_config|
-          tool_class = tool_config[:class] || tool_config['class']
-          tool_options = tool_config[:options] || tool_config['options'] || {}
-          
-          case tool_class.to_s.downcase
-          when 'calculator'
-            tools << Calculator.new
-          when 'web_search', 'websearch'
-            tools << WebSearch.new(**tool_options)
-          when 'code_interpreter', 'codeinterpreter'
-            tools << CodeInterpreter.new(**tool_options)
-          else
-            raise ArgumentError, "Unknown tool class: #{tool_class}"
-          end
-        end
-        
-        new(tools: tools)
-      end
-
-      # Форматирует результаты выполнения для включения в промпт
+      # Format tool execution results for inclusion into an LLM prompt.
+      # @param results [Hash]
+      # @return [String]
       def format_tool_results(results)
         return "" if results.empty?
-
         formatted_results = results.map do |tool_name, result|
           "#{tool_name}: #{result[:formatted]}"
         end
-
         "Tool Results:\n#{formatted_results.join("\n\n")}"
       end
 
-      # Получает краткое описание доступных инструментов
+      # Human-readable list of available tools.
+      # @return [String]
       def tools_description
         descriptions = @tools.values.map do |tool|
           "- #{tool.name}: #{tool.description}"
         end
-
         "Available tools:\n#{descriptions.join("\n")}"
       end
 
-      # Проверяет, содержит ли промпт запрос на использование инструментов
+      # Determine if prompt likely needs tool usage.
+      # @param prompt [String]
+      # @return [Boolean]
       def needs_tools?(prompt)
-        # Проверяем явные запросы на использование инструментов
         return true if prompt.match?(/\b(use tool|call tool|execute|calculate|search|run code)\b/i)
-        
-        # Проверяем, есть ли подходящие инструменты
         find_matching_tools(prompt).any?
       end
 
-      # Автоматически решает, какие инструменты использовать
+      # Auto-select and execute best tools for prompt.
+      # @param prompt [String]
+      # @param context [Hash]
+      # @return [Hash]
       def auto_execute(prompt, context: {})
         return {} unless needs_tools?(prompt)
-        
-        # Ограничиваем количество одновременно выполняемых инструментов
         matching_tools = find_matching_tools(prompt)
         selected_tools = select_best_tools(matching_tools, prompt)
-        
         results = {}
         selected_tools.each do |tool|
           begin
@@ -175,15 +130,19 @@ module LLMChain
             }
           end
         end
-
         results
       end
 
+      # Build JSON schemas for all registered tools.
+      # @return [Array<Hash>]
+      def get_tools_schema
+        @tools.values.map(&:to_schema)
+      end
+
       private
 
-      # Выбирает лучшие инструменты для выполнения (ограничение по количеству)
+      # Simple heuristic to rank matching tools.
       def select_best_tools(tools, prompt, limit: 3)
-        # Простая логика приоритизации
         prioritized = tools.sort_by do |tool|
           case tool.name
           when 'calculator'
@@ -196,7 +155,6 @@ module LLMChain
             1
           end
         end
-
         prioritized.first(limit)
       end
     end

data/lib/llm_chain/tools/tool_manager_factory.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module LLMChain
+  module Tools
+    # Factory for creating ToolManager instances with default or custom toolsets.
+    module ToolManagerFactory
+      # Create a ToolManager with the default set of tools.
+      # @return [ToolManager]
+      def self.create_default_toolset
+        tools = [
+          Calculator.new,
+          WebSearch.new,
+          CodeInterpreter.new,
+          DateTime.new
+        ]
+        ToolManager.new(tools: tools)
+      end
+
+      # Create a ToolManager from a config array.
+      # @param config [Array<Hash>] tool config hashes
+      # @return [ToolManager]
+      def self.from_config(config)
+        tools = []
+        config.each do |tool_config|
+          tool_class = tool_config[:class] || tool_config['class']
+          tool_options = tool_config[:options] || tool_config['options'] || {}
+          case tool_class.to_s.downcase
+          when 'calculator'
+            tools << Calculator.new
+          when 'web_search', 'websearch'
+            tools << WebSearch.new(**tool_options)
+          when 'code_interpreter', 'codeinterpreter'
+            tools << CodeInterpreter.new(**tool_options)
+          when 'date_time', 'datetime'
+            tools << DateTime.new
+          else
+            raise ArgumentError, "Unknown tool class: #{tool_class}"
+          end
+        end
+        ToolManager.new(tools: tools)
+      end
+    end
+  end
+end