ruby_llm-agents 3.0.0 → 3.2.0

data/lib/ruby_llm/agents/audio/transcriber.rb

@@ -166,7 +166,7 @@ module RubyLLM
 
         def default_transcription_model
           RubyLLM::Agents.configuration.default_transcription_model
-        rescue StandardError
+        rescue
           "whisper-1"
         end
       end
@@ -334,22 +334,22 @@ module RubyLLM
       def agent_cache_key
         # Generate content hash based on input type
         content_hash = case @audio
-                       when String
-                         if @audio.start_with?("http://", "https://")
-                           Digest::SHA256.hexdigest(@audio)
-                         elsif File.exist?(@audio)
-                           Digest::SHA256.file(@audio).hexdigest
-                         else
-                           Digest::SHA256.hexdigest(@audio)
-                         end
-                       when File, IO
-                         @audio.rewind if @audio.respond_to?(:rewind)
-                         Digest::SHA256.hexdigest(@audio.read).tap do
-                           @audio.rewind if @audio.respond_to?(:rewind)
-                         end
-                       else
-                         Digest::SHA256.hexdigest(@audio.to_s)
-                       end
+        when String
+          if @audio.start_with?("http://", "https://")
+            Digest::SHA256.hexdigest(@audio)
+          elsif File.exist?(@audio)
+            Digest::SHA256.file(@audio).hexdigest
+          else
+            Digest::SHA256.hexdigest(@audio)
+          end
+        when File, IO
+          @audio.rewind if @audio.respond_to?(:rewind)
+          Digest::SHA256.hexdigest(@audio.read).tap do
+            @audio.rewind if @audio.respond_to?(:rewind)
+          end
+        else
+          Digest::SHA256.hexdigest(@audio.to_s)
+        end
 
         components = [
           "ruby_llm_agents",
@@ -389,15 +389,15 @@ module RubyLLM
         case audio
         when String
           if audio.start_with?("http://", "https://")
-            { source: audio, type: :url }
+            {source: audio, type: :url}
           elsif looks_like_file_path?(audio)
-            { source: audio, type: :file_path }
+            {source: audio, type: :file_path}
           else
             # Assume it's binary data
-            { source: audio, type: :binary, format: format }
+            {source: audio, type: :binary, format: format}
           end
         when File, IO
-          { source: audio, type: :file_object }
+          {source: audio, type: :file_object}
         else
           raise ArgumentError, "audio must be a file path, URL, File object, or binary data"
         end
@@ -451,7 +451,7 @@ module RubyLLM
 
           begin
             return execute_transcription(audio_input, model)
-          rescue StandardError => e
+          rescue => e
             last_error = e
             retries += 1
 
@@ -498,7 +498,7 @@ module RubyLLM
       # @param model [String] Model to use
       # @return [Hash] Options for transcription
       def build_transcribe_options(model)
-        options = { model: model }
+        options = {model: model}
 
         # Add language if specified
         lang = resolved_language
@@ -618,15 +618,15 @@ module RubyLLM
         # Estimate based on model and duration
         model = raw_result[:model].to_s
         price_per_minute = case model
-                           when /whisper-1/
-                             0.006
-                           when /gpt-4o-transcribe/
-                             0.01
-                           when /gpt-4o-mini-transcribe/
-                             0.005
-                           else
-                             0.006 # Default to whisper pricing
-                           end
+        when /whisper-1/
+          0.006
+        when /gpt-4o-transcribe/
+          0.01
+        when /gpt-4o-mini-transcribe/
+          0.005
+        else
+          0.006 # Default to whisper pricing
+        end
 
         duration_minutes * price_per_minute
       end
@@ -657,7 +657,7 @@ module RubyLLM
       # Calculates exponential backoff delay
       def calculate_backoff(attempt)
         config = self.class.reliability_config
-        base = config&.backoff == :constant ? 1.0 : 0.4
+        base = (config&.backoff == :constant) ? 1.0 : 0.4
         max_delay = 10.0
 
         delay = base * (2**(attempt - 1))

data/lib/ruby_llm/agents/base_agent.rb

@@ -133,7 +133,7 @@ module RubyLLM
         # @return [void]
         def param(name, required: false, default: nil, type: nil)
           @params ||= {}
-          @params[name] = { required: required, default: default, type: type }
+          @params[name] = {required: required, default: default, type: type}
           define_method(name) do
             @options[name] || @options[name.to_s] || self.class.params.dig(name, :default)
           end
@@ -217,7 +217,7 @@ module RubyLLM
 
           # Fall back to global configuration default
           RubyLLM::Agents.configuration.default_thinking
-        rescue StandardError
+        rescue
           nil
         end
 
@@ -227,13 +227,13 @@ module RubyLLM
 
         def default_streaming
           RubyLLM::Agents.configuration.default_streaming
-        rescue StandardError
+        rescue
           false
         end
 
         def default_temperature
           RubyLLM::Agents.configuration.default_temperature
-        rescue StandardError
+        rescue
           0.7
         end
       end
@@ -380,7 +380,8 @@ module RubyLLM
         base_data.merge(
           model: model,
           system_prompt: system_prompt,
-          user_prompt: user_prompt
+          user_prompt: user_prompt,
+          assistant_prompt: assistant_prompt
         )
       end
 
@@ -454,7 +455,7 @@ module RubyLLM
         if tenant_value.is_a?(Hash)
           tenant_value
         elsif tenant_value.respond_to?(:llm_tenant_id)
-          { id: tenant_value.llm_tenant_id, object: tenant_value }
+          {id: tenant_value.llm_tenant_id, object: tenant_value}
         else
           raise ArgumentError, "tenant must be a Hash or respond to :llm_tenant_id"
         end
@@ -464,7 +465,7 @@ module RubyLLM
       #
       # @return [Array<Class>] Tool classes to use
       def resolved_tools
-        if self.class.instance_methods(false).include?(:tools)
+        if self.class.method_defined?(:tools, false)
           tools
         else
           self.class.tools
@@ -492,7 +493,7 @@ module RubyLLM
         prefill = assistant_prompt
         return nil if prefill.nil? || (prefill.is_a?(String) && prefill.empty?)
 
-        { role: :assistant, content: prefill }
+        {role: :assistant, content: prefill}
       end
 
       # Returns whether streaming is enabled
@@ -543,7 +544,7 @@ module RubyLLM
 
           if config[:type] && has_value && !value.nil? && !value.is_a?(config[:type])
             raise ArgumentError,
-                  "#{self.class} expected #{config[:type]} for :#{name}, got #{value.class}"
+              "#{self.class} expected #{config[:type]} for :#{name}, got #{value.class}"
           end
         end
       end
@@ -593,8 +594,8 @@ module RubyLLM
       def build_client(context = nil)
         effective_model = context&.model || model
         client = RubyLLM.chat
-                        .with_model(effective_model)
-                        .with_temperature(temperature)
+          .with_model(effective_model)
+          .with_temperature(temperature)
 
         client = client.with_instructions(system_prompt) if system_prompt
         client = client.with_schema(schema) if schema
@@ -734,7 +735,7 @@ module RubyLLM
         return nil unless defined?(RubyLLM::Models)
 
         RubyLLM::Models.find(model_id)
-      rescue StandardError
+      rescue
         nil
       end
 
@@ -788,7 +789,7 @@ module RubyLLM
       # @return [Hash] Hash with thinking data or empty hash
       def safe_extract_thinking_data(response)
         result_thinking_data(response)
-      rescue StandardError
+      rescue
         {}
       end
 
@@ -893,7 +894,7 @@ module RubyLLM
           content = result.to_s
         end
 
-        { content: content, status: status, error_message: error_message }
+        {content: content, status: status, error_message: error_message}
       end
 
       # Truncates tool result if it exceeds the configured max length
@@ -916,7 +917,7 @@ module RubyLLM
       # @return [Integer] Max length
       def tool_result_max_length
         RubyLLM::Agents.configuration.tool_result_max_length || 10_000
-      rescue StandardError
+      rescue
         10_000
       end
 

data/lib/ruby_llm/agents/core/base/callbacks.rb

@@ -49,7 +49,7 @@ module RubyLLM
       #   before_call { |context| context.params[:sanitized] = true }
       #
       def before_call(method_name = nil, &block)
-        @callbacks ||= { before: [], after: [] }
+        @callbacks ||= {before: [], after: []}
         @callbacks[:before] << (block || method_name)
       end
 
@@ -71,7 +71,7 @@ module RubyLLM
       #   after_call { |context, response| notify_completion(response) }
       #
       def after_call(method_name = nil, &block)
-        @callbacks ||= { before: [], after: [] }
+        @callbacks ||= {before: [], after: []}
         @callbacks[:after] << (block || method_name)
       end
 
@@ -112,7 +112,7 @@ module RubyLLM
       #
       # @return [Hash] Hash with :before and :after arrays
       def callbacks
-        @callbacks ||= { before: [], after: [] }
+        @callbacks ||= {before: [], after: []}
       end
     end
 

data/lib/ruby_llm/agents/core/configuration.rb

@@ -390,79 +390,84 @@ module RubyLLM
         end
       end
 
+      # Attributes with custom setters (validation) — only readers here
+      attr_reader :default_embedding_dimensions, :default_embedding_batch_size
+
       # Attributes without validation (simple accessors)
       attr_accessor :default_model,
-                    :async_logging,
-                    :async_max_concurrency,
-                    :retention_period,
-                    :dashboard_parent_controller,
-                    :basic_auth_username,
-                    :basic_auth_password,
-                    :default_fallback_models,
-                    :default_total_timeout,
-                    :default_streaming,
-                    :default_tools,
-                    :default_thinking,
-                    :on_alert,
-                    :persist_prompts,
-                    :persist_responses,
-                    :multi_tenancy_enabled,
-                    :persist_messages_summary,
-                    :default_retryable_patterns,
-                    :default_embedding_model,
-                    :default_embedding_dimensions,
-                    :default_embedding_batch_size,
-                    :track_embeddings,
-                    :default_transcription_model,
-                    :track_transcriptions,
-                    :default_tts_provider,
-                    :default_tts_model,
-                    :default_tts_voice,
-                    :track_speech,
-                    :track_executions,
-                    :track_audio,
-                    :track_cache_hits,
-                    :default_image_model,
-                    :default_image_size,
-                    :default_image_quality,
-                    :default_image_style,
-                    :max_image_prompt_length,
-                    :track_image_generation,
-                    :image_model_aliases,
-                    :litellm_pricing_url,
-                    :litellm_pricing_cache_ttl,
-                    :default_image_cost,
-                    :image_model_pricing,
-                    :default_variator_model,
-                    :default_editor_model,
-                    :default_transformer_model,
-                    :default_upscaler_model,
-                    :default_variation_strength,
-                    :default_transform_strength,
-                    :default_analyzer_model,
-                    :default_analysis_type,
-                    :default_analyzer_max_tags,
-                    :default_background_remover_model,
-                    :default_background_output_format,
-                    :root_directory,
-                    :root_namespace,
-                    :tool_result_max_length,
-                    :redaction
+        :async_logging,
+        :async_max_concurrency,
+        :retention_period,
+        :dashboard_parent_controller,
+        :basic_auth_username,
+        :basic_auth_password,
+        :default_fallback_models,
+        :default_total_timeout,
+        :default_streaming,
+        :default_tools,
+        :default_thinking,
+        :on_alert,
+        :persist_prompts,
+        :persist_responses,
+        :multi_tenancy_enabled,
+        :persist_messages_summary,
+        :default_retryable_patterns,
+        :default_embedding_model,
+        :track_embeddings,
+        :default_transcription_model,
+        :track_transcriptions,
+        :default_tts_provider,
+        :default_tts_model,
+        :default_tts_voice,
+        :track_speech,
+        :elevenlabs_api_key,
+        :elevenlabs_api_base,
+        :tts_model_pricing,
+        :default_tts_cost,
+        :track_executions,
+        :track_audio,
+        :track_cache_hits,
+        :default_image_model,
+        :default_image_size,
+        :default_image_quality,
+        :default_image_style,
+        :max_image_prompt_length,
+        :track_image_generation,
+        :image_model_aliases,
+        :litellm_pricing_url,
+        :litellm_pricing_cache_ttl,
+        :default_image_cost,
+        :image_model_pricing,
+        :default_variator_model,
+        :default_editor_model,
+        :default_transformer_model,
+        :default_upscaler_model,
+        :default_variation_strength,
+        :default_transform_strength,
+        :default_analyzer_model,
+        :default_analysis_type,
+        :default_analyzer_max_tags,
+        :default_background_remover_model,
+        :default_background_output_format,
+        :root_directory,
+        :root_namespace,
+        :tool_result_max_length,
+        :redaction
 
       # Attributes with validation (readers only, custom setters below)
       attr_reader :default_temperature,
-                  :default_timeout,
-                  :anomaly_cost_threshold,
-                  :anomaly_duration_threshold,
-                  :per_page,
-                  :recent_executions_limit,
-                  :job_retry_attempts,
-                  :messages_summary_max_length,
-                  :dashboard_auth,
-                  :tenant_resolver,
-                  :tenant_config_resolver,
-                  :default_retries,
-                  :budgets
+        :default_timeout,
+        :anomaly_cost_threshold,
+        :anomaly_duration_threshold,
+        :per_page,
+        :recent_executions_limit,
+        :job_retry_attempts,
+        :messages_summary_max_length,
+        :dashboard_auth,
+        :tenant_resolver,
+        :tenant_config_resolver,
+        :default_retries,
+        :budgets
 
       attr_writer :cache_store
 
@@ -597,7 +602,7 @@ module RubyLLM
       # @param value [Integer, nil] Dimensions (must be nil or > 0)
       # @raise [ArgumentError] If value is not nil or positive
       def default_embedding_dimensions=(value)
-        unless value.nil? || (value.is_a?(Numeric) && value > 0)
+        if !value.nil? && !(value.is_a?(Numeric) && value > 0)
           raise ArgumentError, "default_embedding_dimensions must be nil or greater than 0"
         end
 
@@ -627,13 +632,13 @@ module RubyLLM
         @job_retry_attempts = 3
 
         # Reliability defaults (all disabled by default for backward compatibility)
-        @default_retries = { max: 0, backoff: :exponential, base: 0.4, max_delay: 3.0, on: [] }
+        @default_retries = {max: 0, backoff: :exponential, base: 0.4, max_delay: 3.0, on: []}
         @default_fallback_models = []
         @default_total_timeout = nil
         @default_retryable_patterns = {
           rate_limiting: ["rate limit", "rate_limit", "too many requests", "429", "quota"],
           server_errors: ["500", "502", "503", "504", "service unavailable",
-                         "internal server error", "bad gateway", "gateway timeout"],
+            "internal server error", "bad gateway", "gateway timeout"],
           capacity: ["overloaded", "capacity"]
         }
 
@@ -650,7 +655,7 @@ module RubyLLM
 
         # Multi-tenancy defaults (disabled for backward compatibility)
         @multi_tenancy_enabled = false
-        @tenant_resolver = -> { nil }
+        @tenant_resolver = -> {}
         @tenant_config_resolver = nil
 
         # Messages summary defaults
@@ -673,6 +678,14 @@ module RubyLLM
         @default_tts_voice = "nova"
         @track_speech = true
 
+        # ElevenLabs defaults
+        @elevenlabs_api_key = nil
+        @elevenlabs_api_base = "https://api.elevenlabs.io"
+
+        # TTS pricing defaults
+        @tts_model_pricing = {}
+        @default_tts_cost = 0.015
+
         # Execution/conversation agent tracking
         @track_executions = true
         @track_audio = true
@@ -783,7 +796,7 @@ module RubyLLM
         return false unless async_available?
 
         defined?(::Async::Task) && ::Async::Task.current?
-      rescue StandardError
+      rescue
         false
       end
 

data/lib/ruby_llm/agents/core/errors.rb

@@ -29,7 +29,7 @@ module RubyLLM
 
       def initialize(message = nil, model: nil)
         @model = model
-        super(message || "Circuit breaker is open#{model ? " for #{model}" : ""}")
+        super(message || "Circuit breaker is open#{" for #{model}" if model}")
       end
     end
 
@@ -78,7 +78,7 @@ module RubyLLM
       def initialize(message = nil, tenant_id: nil, budget_type: nil)
         @tenant_id = tenant_id
         @budget_type = budget_type
-        super(message || "Budget exceeded#{tenant_id ? " for tenant #{tenant_id}" : ""}")
+        super(message || "Budget exceeded#{" for tenant #{tenant_id}" if tenant_id}")
       end
     end
 
@@ -88,5 +88,30 @@ module RubyLLM
 
     # Raised for configuration issues
     class ConfigurationError < Error; end
+
+    # ============================================================
+    # Speech/Audio Errors
+    # ============================================================
+
+    # Raised when a TTS provider is not supported
+    class UnsupportedProviderError < Error
+      attr_reader :provider
+
+      def initialize(message = nil, provider: nil)
+        @provider = provider
+        super(message || "Provider :#{provider} is not supported for this operation")
+      end
+    end
+
+    # Raised when the TTS API returns an error response
+    class SpeechApiError < Error
+      attr_reader :status, :response_body
+
+      def initialize(message = nil, status: nil, response_body: nil)
+        @status = status
+        @response_body = response_body
+        super(message || "Speech API error (status: #{status})")
+      end
+    end
   end
 end