ruby_llm 1.14.1 → 1.16.0

data/lib/ruby_llm/active_record/tool_call_methods.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'active_support/concern'
+require 'ruby_llm/active_record/payload_helpers'
+
 module RubyLLM
   module ActiveRecord
     # Methods mixed into tool call models.

data/lib/ruby_llm/agent.rb

@@ -125,6 +125,7 @@ module RubyLLM
         record
       end
 
+      # Mutates persisted instructions on the configured chat record.
       def sync_instructions!(chat_or_id, **kwargs)
         raise ArgumentError, 'chat_model must be configured to use sync_instructions!' unless resolved_chat_model
 
@@ -359,7 +360,8 @@ module RubyLLM
 
     def_delegators :chat, :model, :messages, :tools, :params, :headers, :schema, :ask, :say, :with_tool, :with_tools,
                    :with_model, :with_temperature, :with_thinking, :with_context, :with_params, :with_headers,
-                   :with_schema, :on_new_message, :on_end_message, :on_tool_call, :on_tool_result, :each, :complete,
-                   :add_message, :reset_messages!
+                   :with_schema, :on_new_message, :on_end_message, :on_tool_call, :on_tool_result, :before_message,
+                   :after_message, :before_tool_call, :after_tool_result, :each, :complete, :add_message,
+                   :reset_messages!, :cost
   end
 end

data/lib/ruby_llm/aliases.json

@@ -8,17 +8,10 @@
     "anthropic": "claude-3-5-haiku-latest"
   },
   "claude-3-5-sonnet": {
-    "anthropic": "claude-3-5-sonnet-20241022",
-    "openrouter": "anthropic/claude-3.5-sonnet",
-    "bedrock": "anthropic.claude-3-5-sonnet-20241022-v2:0"
+    "anthropic": "claude-3-5-sonnet-20241022"
   },
   "claude-3-7-sonnet": {
-    "anthropic": "claude-3-7-sonnet-20250219",
-    "openrouter": "anthropic/claude-3.7-sonnet",
-    "bedrock": "anthropic.claude-3-7-sonnet-20250219-v1:0"
-  },
-  "claude-3-7-sonnet-latest": {
-    "anthropic": "claude-3-7-sonnet-latest"
+    "anthropic": "claude-3-7-sonnet-20250219"
   },
   "claude-3-haiku": {
     "anthropic": "claude-3-haiku-20240307",
@@ -40,8 +33,7 @@
   },
   "claude-opus-4": {
     "anthropic": "claude-opus-4-20250514",
-    "openrouter": "anthropic/claude-opus-4",
-    "bedrock": "anthropic.claude-opus-4-1-20250805-v1:0"
+    "openrouter": "anthropic/claude-opus-4"
   },
   "claude-opus-4-0": {
     "anthropic": "claude-opus-4-0"
@@ -64,10 +56,21 @@
     "bedrock": "anthropic.claude-opus-4-6-v1",
     "azure": "claude-opus-4-6"
   },
+  "claude-opus-4-7": {
+    "anthropic": "claude-opus-4-7",
+    "openrouter": "anthropic/claude-opus-4.7",
+    "bedrock": "anthropic.claude-opus-4-7",
+    "azure": "claude-opus-4-7"
+  },
+  "claude-opus-4-8": {
+    "anthropic": "claude-opus-4-8",
+    "openrouter": "anthropic/claude-opus-4.8",
+    "bedrock": "anthropic.claude-opus-4-8"
+  },
   "claude-sonnet-4": {
     "anthropic": "claude-sonnet-4-20250514",
     "openrouter": "anthropic/claude-sonnet-4",
-    "bedrock": "anthropic.claude-sonnet-4-20250514-v1:0"
+    "bedrock": "us.anthropic.claude-sonnet-4-20250514-v1:0"
   },
   "claude-sonnet-4-0": {
     "anthropic": "claude-sonnet-4-0"
@@ -88,17 +91,13 @@
     "deepseek": "deepseek-chat",
     "openrouter": "deepseek/deepseek-chat"
   },
-  "gemini-1.5-flash": {
-    "gemini": "gemini-1.5-flash",
-    "vertexai": "gemini-1.5-flash"
+  "deepseek-v4-flash": {
+    "deepseek": "deepseek-v4-flash",
+    "openrouter": "deepseek/deepseek-v4-flash"
   },
-  "gemini-1.5-flash-8b": {
-    "gemini": "gemini-1.5-flash-8b",
-    "vertexai": "gemini-1.5-flash-8b"
-  },
-  "gemini-1.5-pro": {
-    "gemini": "gemini-1.5-pro",
-    "vertexai": "gemini-1.5-pro"
+  "deepseek-v4-pro": {
+    "deepseek": "deepseek-v4-pro",
+    "openrouter": "deepseek/deepseek-v4-pro"
   },
   "gemini-2.0-flash": {
     "gemini": "gemini-2.0-flash",
@@ -106,7 +105,6 @@
   },
   "gemini-2.0-flash-001": {
     "gemini": "gemini-2.0-flash-001",
-    "openrouter": "google/gemini-2.0-flash-001",
     "vertexai": "gemini-2.0-flash-001"
   },
   "gemini-2.0-flash-lite": {
@@ -115,7 +113,6 @@
   },
   "gemini-2.0-flash-lite-001": {
     "gemini": "gemini-2.0-flash-lite-001",
-    "openrouter": "google/gemini-2.0-flash-lite-001",
     "vertexai": "gemini-2.0-flash-lite-001"
   },
   "gemini-2.5-flash": {
@@ -132,62 +129,42 @@
     "openrouter": "google/gemini-2.5-flash-lite",
     "vertexai": "gemini-2.5-flash-lite"
   },
-  "gemini-2.5-flash-lite-preview-06-17": {
-    "gemini": "gemini-2.5-flash-lite-preview-06-17",
-    "vertexai": "gemini-2.5-flash-lite-preview-06-17"
-  },
-  "gemini-2.5-flash-lite-preview-09-2025": {
-    "gemini": "gemini-2.5-flash-lite-preview-09-2025",
-    "openrouter": "google/gemini-2.5-flash-lite-preview-09-2025",
-    "vertexai": "gemini-2.5-flash-lite-preview-09-2025"
-  },
-  "gemini-2.5-flash-preview-04-17": {
-    "gemini": "gemini-2.5-flash-preview-04-17",
-    "vertexai": "gemini-2.5-flash-preview-04-17"
-  },
-  "gemini-2.5-flash-preview-05-20": {
-    "gemini": "gemini-2.5-flash-preview-05-20",
-    "vertexai": "gemini-2.5-flash-preview-05-20"
-  },
-  "gemini-2.5-flash-preview-09-2025": {
-    "gemini": "gemini-2.5-flash-preview-09-2025",
-    "openrouter": "google/gemini-2.5-flash-preview-09-2025",
-    "vertexai": "gemini-2.5-flash-preview-09-2025"
-  },
   "gemini-2.5-pro": {
     "gemini": "gemini-2.5-pro",
     "openrouter": "google/gemini-2.5-pro",
     "vertexai": "gemini-2.5-pro"
   },
-  "gemini-2.5-pro-preview-05-06": {
-    "gemini": "gemini-2.5-pro-preview-05-06",
-    "openrouter": "google/gemini-2.5-pro-preview-05-06",
-    "vertexai": "gemini-2.5-pro-preview-05-06"
-  },
-  "gemini-2.5-pro-preview-06-05": {
-    "gemini": "gemini-2.5-pro-preview-06-05",
-    "openrouter": "google/gemini-2.5-pro-preview-06-05",
-    "vertexai": "gemini-2.5-pro-preview-06-05"
-  },
   "gemini-3-flash-preview": {
     "gemini": "gemini-3-flash-preview",
     "openrouter": "google/gemini-3-flash-preview",
     "vertexai": "gemini-3-flash-preview"
   },
+  "gemini-3-pro-image": {
+    "gemini": "gemini-3-pro-image",
+    "vertexai": "gemini-3-pro-image"
+  },
   "gemini-3-pro-image-preview": {
     "gemini": "gemini-3-pro-image-preview",
     "openrouter": "google/gemini-3-pro-image-preview"
   },
   "gemini-3-pro-preview": {
     "gemini": "gemini-3-pro-preview",
-    "openrouter": "google/gemini-3-pro-preview",
     "vertexai": "gemini-3-pro-preview"
   },
+  "gemini-3.1-flash-image": {
+    "gemini": "gemini-3.1-flash-image",
+    "vertexai": "gemini-3.1-flash-image"
+  },
   "gemini-3.1-flash-image-preview": {
     "gemini": "gemini-3.1-flash-image-preview",
     "openrouter": "google/gemini-3.1-flash-image-preview",
     "vertexai": "gemini-3.1-flash-image-preview"
   },
+  "gemini-3.1-flash-lite": {
+    "gemini": "gemini-3.1-flash-lite",
+    "openrouter": "google/gemini-3.1-flash-lite",
+    "vertexai": "gemini-3.1-flash-lite"
+  },
   "gemini-3.1-flash-lite-preview": {
     "gemini": "gemini-3.1-flash-lite-preview",
     "openrouter": "google/gemini-3.1-flash-lite-preview",
@@ -203,10 +180,19 @@
     "openrouter": "google/gemini-3.1-pro-preview-customtools",
     "vertexai": "gemini-3.1-pro-preview-customtools"
   },
+  "gemini-3.5-flash": {
+    "gemini": "gemini-3.5-flash",
+    "openrouter": "google/gemini-3.5-flash",
+    "vertexai": "gemini-3.5-flash"
+  },
   "gemini-embedding-001": {
     "gemini": "gemini-embedding-001",
     "vertexai": "gemini-embedding-001"
   },
+  "gemini-embedding-2": {
+    "gemini": "gemini-embedding-2",
+    "vertexai": "gemini-embedding-2"
+  },
   "gemini-flash": {
     "gemini": "gemini-flash-latest",
     "vertexai": "gemini-flash-latest"
@@ -215,21 +201,13 @@
     "gemini": "gemini-flash-lite-latest",
     "vertexai": "gemini-flash-lite-latest"
   },
-  "gemma-3-12b-it": {
-    "gemini": "gemma-3-12b-it",
-    "openrouter": "google/gemma-3-12b-it"
-  },
-  "gemma-3-27b-it": {
-    "gemini": "gemma-3-27b-it",
-    "openrouter": "google/gemma-3-27b-it"
+  "gemma-4-26b-a4b-it": {
+    "gemini": "gemma-4-26b-a4b-it",
+    "openrouter": "google/gemma-4-26b-a4b-it"
   },
-  "gemma-3-4b-it": {
-    "gemini": "gemma-3-4b-it",
-    "openrouter": "google/gemma-3-4b-it"
-  },
-  "gemma-3n-e4b-it": {
-    "gemini": "gemma-3n-e4b-it",
-    "openrouter": "google/gemma-3n-e4b-it"
+  "gemma-4-31b-it": {
+    "gemini": "gemma-4-31b-it",
+    "openrouter": "google/gemma-4-31b-it"
   },
   "gpt-3.5-turbo": {
     "openai": "gpt-3.5-turbo",
@@ -287,10 +265,6 @@
     "openrouter": "openai/gpt-4o-2024-11-20",
     "azure": "gpt-4o-2024-11-20"
   },
-  "gpt-4o-audio-preview": {
-    "openai": "gpt-4o-audio-preview",
-    "openrouter": "openai/gpt-4o-audio-preview"
-  },
   "gpt-4o-mini": {
     "openai": "gpt-4o-mini",
     "openrouter": "openai/gpt-4o-mini",
@@ -378,6 +352,14 @@
     "openai": "gpt-5.4-pro",
     "openrouter": "openai/gpt-5.4-pro"
   },
+  "gpt-5.5": {
+    "openai": "gpt-5.5",
+    "openrouter": "openai/gpt-5.5"
+  },
+  "gpt-5.5-pro": {
+    "openai": "gpt-5.5-pro",
+    "openrouter": "openai/gpt-5.5-pro"
+  },
   "gpt-audio": {
     "openai": "gpt-audio",
     "openrouter": "openai/gpt-audio"
@@ -386,6 +368,57 @@
     "openai": "gpt-audio-mini",
     "openrouter": "openai/gpt-audio-mini"
   },
+  "grok-3": {
+    "xai": "grok-4.3"
+  },
+  "grok-3-latest": {
+    "xai": "grok-4.3"
+  },
+  "grok-3-mini": {
+    "xai": "grok-4.3"
+  },
+  "grok-3-mini-latest": {
+    "xai": "grok-4.3"
+  },
+  "grok-4": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-1-fast": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-1-fast-non-reasoning": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-1-fast-non-reasoning-latest": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-1-fast-reasoning": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-1-fast-reasoning-latest": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-fast": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-fast-non-reasoning": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-fast-non-reasoning-latest": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-fast-reasoning": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-fast-reasoning-latest": {
+    "xai": "grok-4.3"
+  },
+  "grok-4-latest": {
+    "xai": "grok-4.3"
+  },
+  "grok-latest": {
+    "xai": "grok-4.3"
+  },
   "lyria-3-clip-preview": {
     "gemini": "lyria-3-clip-preview",
     "openrouter": "google/lyria-3-clip-preview"

data/lib/ruby_llm/aliases.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'json'
+
 module RubyLLM
   # Manages model aliases for provider-specific versions
   class Aliases
@@ -30,6 +32,7 @@ module RubyLLM
         end
       end
 
+      # Replaces the cached alias map from aliases.json.
       def reload!
         @aliases = load_aliases
       end

data/lib/ruby_llm/attachment.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'base64'
 require 'pathname'
 require 'uri'
 
@@ -8,6 +9,16 @@ module RubyLLM
   class Attachment
     attr_reader :source, :filename, :mime_type
 
+    DOCUMENT_EXTENSIONS = %w[
+      doc docx dot key numbers odp ods odt pages pot pps ppt pptx rtf xls xlsx
+    ].freeze
+    ACTIVE_STORAGE_CLASS_NAMES = %w[
+      ActiveStorage::Blob
+      ActiveStorage::Attachment
+      ActiveStorage::Attached::One
+      ActiveStorage::Attached::Many
+    ].freeze
+
     def initialize(source, filename: nil)
       @source = source
       @source = source_type_cast
@@ -29,11 +40,7 @@ module RubyLLM
     end
 
     def active_storage?
-      return false unless defined?(ActiveStorage)
-
-      @source.is_a?(ActiveStorage::Blob) ||
-        @source.is_a?(ActiveStorage::Attached::One) ||
-        @source.is_a?(ActiveStorage::Attached::Many)
+      ACTIVE_STORAGE_CLASS_NAMES.any? { |class_name| source_is_a?(class_name) }
     end
 
     def content
@@ -82,6 +89,7 @@ module RubyLLM
       return :audio if audio?
       return :pdf if pdf?
       return :text if text?
+      return :document if document?
 
       :unknown
     end
@@ -113,6 +121,17 @@ module RubyLLM
       RubyLLM::MimeType.pdf? mime_type
     end
 
+    def document?
+      return false if pdf? || text?
+
+      RubyLLM::MimeType.document?(mime_type) || DOCUMENT_EXTENSIONS.include?(extension)
+    end
+
+    def extension
+      extension = File.extname(filename.to_s).delete_prefix('.').downcase
+      extension.empty? ? nil : extension
+    end
+
     def text?
       RubyLLM::MimeType.text? mime_type
     end
@@ -146,18 +165,7 @@ module RubyLLM
     end
 
     def load_content_from_active_storage
-      return unless defined?(ActiveStorage)
-
-      @content = case @source
-                 when ActiveStorage::Blob
-                   @source.download
-                 when ActiveStorage::Attached::One
-                   @source.blob&.download
-                 when ActiveStorage::Attached::Many
-                   # For multiple attachments, just take the first one
-                   # This maintains the single-attachment interface
-                   @source.blobs.first&.download
-                 end
+      @content = active_storage_blob&.download
     end
 
     def source_type_cast
@@ -192,32 +200,25 @@ module RubyLLM
       end
     end
 
-    def extract_filename_from_active_storage # rubocop:disable Metrics/PerceivedComplexity
-      return 'attachment' unless defined?(ActiveStorage)
-
-      case @source
-      when ActiveStorage::Blob
-        @source.filename.to_s
-      when ActiveStorage::Attached::One
-        @source.blob&.filename&.to_s || 'attachment'
-      when ActiveStorage::Attached::Many
-        @source.blobs.first&.filename&.to_s || 'attachment'
-      else
-        'attachment'
-      end
+    def extract_filename_from_active_storage
+      active_storage_blob&.filename&.to_s || 'attachment'
     end
 
     def active_storage_content_type
-      return unless defined?(ActiveStorage)
-
-      case @source
-      when ActiveStorage::Blob
-        @source.content_type
-      when ActiveStorage::Attached::One
-        @source.blob&.content_type
-      when ActiveStorage::Attached::Many
-        @source.blobs.first&.content_type
-      end
+      active_storage_blob&.content_type
+    end
+
+    def active_storage_blob
+      return @source if source_is_a?('ActiveStorage::Blob')
+      return @source.blob if source_is_a?('ActiveStorage::Attachment')
+      return @source.blob if source_is_a?('ActiveStorage::Attached::One')
+
+      @source.blobs.first if source_is_a?('ActiveStorage::Attached::Many')
+    end
+
+    def source_is_a?(class_name)
+      klass = RubyLLM::Utils.safe_constantize(class_name)
+      klass ? @source.is_a?(klass) : false
     end
   end
 end