Enhance code comments (#846)

Author: andreibondarev

lib/langchain/assistant/messages/anthropic_message.rb

@@ -12,6 +12,12 @@ class AnthropicMessage < Base
 
         TOOL_ROLE = "tool_result"
 
+        # Initialize a new Anthropic message
+        #
+        # @param role [String] The role of the message
+        # @param content [String] The content of the message
+        # @param tool_calls [Array<Hash>] The tool calls made in the message
+        # @param tool_call_id [String] The ID of the tool call
         def initialize(role:, content: nil, tool_calls: [], tool_call_id: nil)
           raise ArgumentError, "Role must be one of #{ROLES.join(", ")}" unless ROLES.include?(role)
           raise ArgumentError, "Tool calls must be an array of hashes" unless tool_calls.is_a?(Array) && tool_calls.all? { |tool_call| tool_call.is_a?(Hash) }

lib/langchain/assistant/messages/google_gemini_message.rb

@@ -15,10 +15,10 @@ class GoogleGeminiMessage < Base
 
         # Initialize a new Google Gemini message
         #
-        # @param [String] The role of the message
-        # @param [String] The content of the message
-        # @param [Array<Hash>] The tool calls made in the message
-        # @param [String] The ID of the tool call
+        # @param role [String] The role of the message
+        # @param content [String] The content of the message
+        # @param tool_calls [Array<Hash>] The tool calls made in the message
+        # @param tool_call_id [String] The ID of the tool call
         def initialize(role:, content: nil, tool_calls: [], tool_call_id: nil)
           raise ArgumentError, "Role must be one of #{ROLES.join(", ")}" unless ROLES.include?(role)
           raise ArgumentError, "Tool calls must be an array of hashes" unless tool_calls.is_a?(Array) && tool_calls.all? { |tool_call| tool_call.is_a?(Hash) }

lib/langchain/assistant/messages/ollama_message.rb

@@ -16,10 +16,10 @@ class OllamaMessage < Base
 
         # Initialize a new OpenAI message
         #
-        # @param [String] The role of the message
-        # @param [String] The content of the message
-        # @param [Array<Hash>] The tool calls made in the message
-        # @param [String] The ID of the tool call
+        # @param role [String] The role of the message
+        # @param content [String] The content of the message
+        # @param tool_calls [Array<Hash>] The tool calls made in the message
+        # @param tool_call_id [String] The ID of the tool call
         def initialize(role:, content: nil, tool_calls: [], tool_call_id: nil)
           raise ArgumentError, "Role must be one of #{ROLES.join(", ")}" unless ROLES.include?(role)
           raise ArgumentError, "Tool calls must be an array of hashes" unless tool_calls.is_a?(Array) && tool_calls.all? { |tool_call| tool_call.is_a?(Hash) }