ruby_llm 1.15.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cfdd21451b6e3daac0463dfdb7655892967e5a4da6b00846f353809a9abe18a
-  data.tar.gz: e1505ddd57326601298bb8975c20049a195eb87babd62b08ac0e6340c9e653f6
+  metadata.gz: ba1ac6556eb9321cc5c4840eb10c4f2253a35991298d3a4f9cf6dd85035ba069
+  data.tar.gz: f87c2f1e7c1898c31ae732db0bae3a96f8b9c9082d8f9abd9a728b2b9d295426
 SHA512:
-  metadata.gz: 7222e575d4f1e5cf620fdc37f4c255c7ededeee945d7b77fac4129c2947d6f78f7d5641b45ed39470180e5bf2dfd48b36e0a6c16579e4e4835564c48b6907920
-  data.tar.gz: ce3fb0f0e8b3665fafe56717cf8fcb10733008821633b024013d0f6e5d0bc90ef47f25b0109aa0e80ee3df4002e2f9b6a20cd98595031aa57235588cb4677052
+  metadata.gz: f75855b2dc79679febdf4edb67130f5ee60d7445bd1a34d7f29c69f3cd363711b881ffe2b51eac8fa4f2a74b297e364e53263e12674333055c8daf702d528a3a
+  data.tar.gz: aceac99dd86c4e4db028411d1d58cd2602351f3ba0b3cb7fc2334d979459a97294f2617e10770d851b57f70aa26b49f9995dd239d1f52cff43814d1293419a75

data/README.md

@@ -5,9 +5,10 @@
   <img src="/docs/assets/images/logotype.svg" alt="RubyLLM" height="120" width="250">
 </picture>
 
-<strong>One *beautiful* Ruby API for GPT, Claude, Gemini, and more.</strong>
+<strong>A single, beautiful Ruby framework for all major AI providers. Easily build chatbots, AI agents, RAG applications, content generators, and every AI workflow you can think of.
+</strong>
 
-Battle tested at [<picture><source media="(prefers-color-scheme: dark)" srcset="https://chatwithwork.com/logotype-dark.svg"><img src="https://chatwithwork.com/logotype.svg" alt="Chat with Work" height="30" align="absmiddle"></picture>](https://chatwithwork.com) — *Your AI coworker*
+Battle tested at [<picture><source media="(prefers-color-scheme: dark)" srcset="https://chatwithwork.com/logotype-dark.svg"><img src="https://chatwithwork.com/logotype.svg" alt="Chat with Work" height="30" align="absmiddle"></picture>](https://chatwithwork.com) - *Fully private work AI*
 
 [![Gem Version](https://badge.fury.io/rb/ruby_llm.svg)](https://badge.fury.io/rb/ruby_llm)
 [![Ruby Style Guide](https://img.shields.io/badge/code_style-rubocop-brightgreen.svg)](https://github.com/rubocop/rubocop)
@@ -24,7 +25,7 @@ Battle tested at [<picture><source media="(prefers-color-scheme: dark)" srcset="
 
 Build chatbots, AI agents, RAG applications. Works with OpenAI, xAI, Anthropic, Google, AWS, local models, and any OpenAI-compatible API.
 
-## From zero to AI chat app in under two minutes
+## Build a working Ruby AI chat in two minutes
 
 https://github.com/user-attachments/assets/65422091-9338-47da-a303-92b918bd1345
 
@@ -32,7 +33,7 @@ https://github.com/user-attachments/assets/65422091-9338-47da-a303-92b918bd1345
 
 Every AI provider ships their own bloated client. Different APIs. Different response formats. Different conventions. It's exhausting.
 
-RubyLLM gives you one beautiful API for all of them. Same interface whether you're using GPT, Claude, or your local Ollama. Just three dependencies: Faraday, Zeitwerk, and Marcel. That's it.
+RubyLLM gives you one beautiful framework for all of them. Same interface whether you're using GPT, Claude, or your local Ollama. Just three dependencies: Faraday, Zeitwerk, and Marcel. That's it.
 
 ## Show me the code
 

data/lib/generators/ruby_llm/install/templates/initializer.rb.tt

@@ -2,7 +2,7 @@ RubyLLM.configure do |config|
   config.openai_api_key = ENV.fetch("OPENAI_API_KEY", Rails.application.credentials.dig(:openai_api_key))
   # config.default_model = "gpt-5-nano"
 
-  # Use the new association-based acts_as API (recommended)
+  # Use the association-based acts_as API (recommended)
   config.use_new_acts_as = true
 <% if model_model_name != 'Model' -%>
 

data/lib/generators/ruby_llm/upgrade_to_v1_7/upgrade_to_v1_7_generator.rb

@@ -6,7 +6,7 @@ require_relative '../generator_helpers'
 
 module RubyLLM
   module Generators
-    # Generator to upgrade existing RubyLLM apps to v1.7 with new Rails-like API
+    # Generator to upgrade existing RubyLLM apps to v1.7 with association-based Rails API
     class UpgradeToV17Generator < Rails::Generators::Base
       include Rails::Generators::Migration
       include RubyLLM::Generators::GeneratorHelpers
@@ -24,7 +24,7 @@ module RubyLLM
 
       argument :model_mappings, type: :array, default: [], banner: 'chat:ChatName message:MessageName ...'
 
-      desc 'Upgrades existing RubyLLM apps to v1.7 with new Rails-like API\n' \
+      desc 'Upgrades existing RubyLLM apps to v1.7 with association-based Rails API\n' \
            'Usage: bin/rails g ruby_llm:upgrade_to_v1_7 [chat:ChatName] [message:MessageName] ...'
 
       def self.next_migration_number(dirname)
@@ -78,7 +78,7 @@ module RubyLLM
         return if initializer_content.include?('config.use_new_acts_as')
 
         inject_into_file initializer_path, before: /^end/ do
-          lines = ["\n  # Enable the new Rails-like API", '  config.use_new_acts_as = true']
+          lines = ["\n  # Enable the association-based Rails API", '  config.use_new_acts_as = true']
           lines << "  config.model_registry_class = \"#{model_model_name}\"" if model_model_name != 'Model'
           lines << "\n"
           lines.join("\n")

data/lib/ruby_llm/active_record/acts_as.rb

@@ -9,34 +9,9 @@ module RubyLLM
     module ActsAs
       extend ActiveSupport::Concern
 
-      # When ActsAs is included, ensure models are loaded from database
       def self.included(base)
         super
-        # Monkey-patch Models to use database when ActsAs is active
-        RubyLLM::Models.class_eval do
-          def self.load_models
-            database_models = read_from_database
-            return database_models if database_models.any?
-
-            RubyLLM.logger.debug { 'Model registry is empty in database, falling back to JSON registry' }
-            read_from_json
-          rescue StandardError => e
-            RubyLLM.logger.debug { "Failed to load models from database: #{e.message}, falling back to JSON" }
-            read_from_json
-          end
-
-          def self.read_from_database
-            model_class = RubyLLM.config.model_registry_class
-            model_class = model_class.constantize if model_class.is_a?(String)
-            return [] unless model_class.table_exists?
-
-            model_class.all.map(&:to_llm)
-          end
-
-          def load_from_database!
-            @models = self.class.read_from_database
-          end
-        end
+        RubyLLM.config.model_registry_source ||= RubyLLM::ModelRegistry::ActiveRecordSource.new
       end
 
       class_methods do # rubocop:disable Metrics/BlockLength

data/lib/ruby_llm/active_record/acts_as_legacy.rb

@@ -222,7 +222,7 @@ module RubyLLM
       end
 
       def create_user_message(content, with: nil)
-        RubyLLM.logger.warn(
+        RubyLLM.deprecator.warn(
           '`create_user_message` is deprecated and will be removed in RubyLLM 2.0. ' \
           'Use `add_message(role: :user, content: ...)` instead.'
         )
@@ -505,13 +505,80 @@ module RubyLLM
         RubyLLM::Content.new(text_content).tap do |content_obj|
           @_tempfiles = []
 
-          attachments.each do |attachment|
-            tempfile = download_attachment(attachment)
-            content_obj.add_attachment(tempfile, filename: attachment.filename.to_s)
+          attachment_sources.each do |attachment, attachable|
+            add_attachment_to_content(content_obj, attachment, attachable)
           end
         end
       end
 
+      def attachment_sources
+        change = pending_attachment_change
+        return attachments.map { |attachment| [attachment, nil] } unless pending_attachment_change?(change)
+
+        change.attachments.zip(change.attachables)
+      end
+
+      def pending_attachment_change
+        attachment_changes['attachments'] if respond_to?(:attachment_changes)
+      end
+
+      def pending_attachment_change?(change)
+        change.respond_to?(:attachments) && change.respond_to?(:attachables)
+      end
+
+      def add_attachment_to_content(content_obj, attachment, attachable)
+        if pending_upload_attachable?(attachable)
+          add_pending_upload_attachment(content_obj, attachable)
+        else
+          tempfile = download_attachment(attachment)
+          content_obj.add_attachment(tempfile, filename: attachment.filename.to_s)
+        end
+      end
+
+      def pending_upload_attachable?(attachable)
+        return false if attachable.nil? || attachable.is_a?(String)
+        return false if instance_of_class?(attachable, 'ActiveStorage::Blob')
+
+        uploaded_file?(attachable) || active_storage_upload_hash?(attachable) ||
+          attachable.is_a?(File) || pathname?(attachable)
+      end
+
+      def uploaded_file?(attachable)
+        instance_of_class?(attachable, 'ActionDispatch::Http::UploadedFile') ||
+          instance_of_class?(attachable, 'Rack::Test::UploadedFile')
+      end
+
+      def active_storage_upload_hash?(attachable)
+        attachable.is_a?(Hash) && attachment_hash_io(attachable).present?
+      end
+
+      def pathname?(attachable)
+        defined?(Pathname) && attachable.is_a?(Pathname)
+      end
+
+      def add_pending_upload_attachment(content_obj, attachable)
+        if attachable.is_a?(Hash)
+          content_obj.add_attachment(attachment_hash_io(attachable), filename: attachment_hash_filename(attachable))
+        else
+          content_obj.add_attachment(attachable)
+        end
+      end
+
+      def attachment_hash_io(attachable)
+        attachable[:io] || attachable['io']
+      end
+
+      def attachment_hash_filename(attachable)
+        filename = attachable[:filename] || attachable['filename']
+        filename&.to_s
+      end
+
+      def instance_of_class?(object, class_name)
+        Object.const_get(class_name).then { |klass| object.is_a?(klass) }
+      rescue NameError
+        false
+      end
+
       def download_attachment(attachment)
         ext = File.extname(attachment.filename.to_s)
         basename = File.basename(attachment.filename.to_s, ext)

data/lib/ruby_llm/active_record/chat_methods.rb

@@ -65,8 +65,8 @@ module RubyLLM
           m.context_window = model_info.context_window
           m.max_output_tokens = model_info.max_output_tokens
           m.capabilities = model_info.capabilities || []
-          m.modalities = model_info.modalities || {}
-          m.pricing = model_info.pricing || {}
+          m.modalities = model_info.modalities.to_h
+          m.pricing = model_info.pricing.to_h
           m.metadata = model_info.metadata || {}
         end
 

data/lib/ruby_llm/active_record/message_methods.rb

@@ -122,13 +122,80 @@ module RubyLLM
         RubyLLM::Content.new(content_value).tap do |content_obj|
           @_tempfiles = []
 
-          attachments.each do |attachment|
-            tempfile = download_attachment(attachment)
-            content_obj.add_attachment(tempfile, filename: attachment.filename.to_s)
+          attachment_sources.each do |attachment, attachable|
+            add_attachment_to_content(content_obj, attachment, attachable)
           end
         end
       end
 
+      def attachment_sources
+        change = pending_attachment_change
+        return attachments.map { |attachment| [attachment, nil] } unless pending_attachment_change?(change)
+
+        change.attachments.zip(change.attachables)
+      end
+
+      def pending_attachment_change
+        attachment_changes['attachments'] if respond_to?(:attachment_changes)
+      end
+
+      def pending_attachment_change?(change)
+        change.respond_to?(:attachments) && change.respond_to?(:attachables)
+      end
+
+      def add_attachment_to_content(content_obj, attachment, attachable)
+        if pending_upload_attachable?(attachable)
+          add_pending_upload_attachment(content_obj, attachable)
+        else
+          tempfile = download_attachment(attachment)
+          content_obj.add_attachment(tempfile, filename: attachment.filename.to_s)
+        end
+      end
+
+      def pending_upload_attachable?(attachable)
+        return false if attachable.nil? || attachable.is_a?(String)
+        return false if instance_of_class?(attachable, 'ActiveStorage::Blob')
+
+        uploaded_file?(attachable) || active_storage_upload_hash?(attachable) ||
+          attachable.is_a?(File) || pathname?(attachable)
+      end
+
+      def uploaded_file?(attachable)
+        instance_of_class?(attachable, 'ActionDispatch::Http::UploadedFile') ||
+          instance_of_class?(attachable, 'Rack::Test::UploadedFile')
+      end
+
+      def active_storage_upload_hash?(attachable)
+        attachable.is_a?(Hash) && attachment_hash_io(attachable).present?
+      end
+
+      def pathname?(attachable)
+        defined?(Pathname) && attachable.is_a?(Pathname)
+      end
+
+      def add_pending_upload_attachment(content_obj, attachable)
+        if attachable.is_a?(Hash)
+          content_obj.add_attachment(attachment_hash_io(attachable), filename: attachment_hash_filename(attachable))
+        else
+          content_obj.add_attachment(attachable)
+        end
+      end
+
+      def attachment_hash_io(attachable)
+        attachable[:io] || attachable['io']
+      end
+
+      def attachment_hash_filename(attachable)
+        filename = attachable[:filename] || attachable['filename']
+        filename&.to_s
+      end
+
+      def instance_of_class?(object, class_name)
+        Object.const_get(class_name).then { |klass| object.is_a?(klass) }
+      rescue NameError
+        false
+      end
+
       def download_attachment(attachment)
         ext = File.extname(attachment.filename.to_s)
         basename = File.basename(attachment.filename.to_s, ext)

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
 

data/lib/ruby_llm/aliases.json

@@ -8,13 +8,10 @@
     "anthropic": "claude-3-5-haiku-latest"
   },
   "claude-3-5-sonnet": {
-    "anthropic": "claude-3-5-sonnet-20241022",
-    "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"
+    "anthropic": "claude-3-7-sonnet-20250219"
   },
   "claude-3-haiku": {
     "anthropic": "claude-3-haiku-20240307",
@@ -36,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"
@@ -66,10 +62,15 @@
     "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"
@@ -98,25 +99,12 @@
     "deepseek": "deepseek-v4-pro",
     "openrouter": "deepseek/deepseek-v4-pro"
   },
-  "gemini-1.5-flash": {
-    "gemini": "gemini-1.5-flash",
-    "vertexai": "gemini-1.5-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"
-  },
   "gemini-2.0-flash": {
     "gemini": "gemini-2.0-flash",
     "vertexai": "gemini-2.0-flash"
   },
   "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": {
@@ -125,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": {
@@ -142,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",
@@ -213,6 +180,11 @@
     "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"
@@ -229,22 +201,6 @@
     "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-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-26b-a4b-it": {
     "gemini": "gemma-4-26b-a4b-it",
     "openrouter": "google/gemma-4-26b-a4b-it"
@@ -309,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",
@@ -416,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