dify_llm 1.8.1 → 1.9.0

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

@@ -5,117 +5,120 @@ require 'rails/generators/active_record'
 require_relative '../generator_helpers'
 
 module RubyLLM
-  class UpgradeToV17Generator < Rails::Generators::Base # rubocop:disable Style/Documentation
-    include Rails::Generators::Migration
-    include RubyLLM::GeneratorHelpers
-
-    namespace 'ruby_llm:upgrade_to_v1_7'
-    source_root File.expand_path('templates', __dir__)
-
-    # Override source_paths to include install templates
-    def self.source_paths
-      [
-        File.expand_path('templates', __dir__),
-        File.expand_path('../install/templates', __dir__)
-      ]
-    end
+  module Generators
+    # Generator to upgrade existing RubyLLM apps to v1.7 with new Rails-like API
+    class UpgradeToV17Generator < Rails::Generators::Base
+      include Rails::Generators::Migration
+      include RubyLLM::Generators::GeneratorHelpers
+
+      namespace 'ruby_llm:upgrade_to_v1_7'
+      source_root File.expand_path('templates', __dir__)
+
+      # Override source_paths to include install templates
+      def self.source_paths
+        [
+          File.expand_path('templates', __dir__),
+          File.expand_path('../install/templates', __dir__)
+        ]
+      end
 
-    argument :model_mappings, type: :array, default: [], banner: 'chat:ChatName message:MessageName ...'
+      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' \
-         'Usage: rails g ruby_llm:upgrade_to_v1_7 [chat:ChatName] [message:MessageName] ...'
+      desc 'Upgrades existing RubyLLM apps to v1.7 with new Rails-like API\n' \
+           'Usage: rails g ruby_llm:upgrade_to_v1_7 [chat:ChatName] [message:MessageName] ...'
 
-    def self.next_migration_number(dirname)
-      ::ActiveRecord::Generators::Base.next_migration_number(dirname)
-    end
+      def self.next_migration_number(dirname)
+        ::ActiveRecord::Generators::Base.next_migration_number(dirname)
+      end
 
-    def create_migration_file
-      @model_table_already_existed = table_exists?(table_name_for(model_model_name))
+      def create_migration_file
+        @model_table_already_existed = table_exists?(table_name_for(model_model_name))
 
-      # First check if models table exists, if not create it
-      unless @model_table_already_existed
-        migration_template 'create_models_migration.rb.tt',
-                           "db/migrate/create_#{table_name_for(model_model_name)}.rb",
-                           migration_version: migration_version,
-                           model_model_name: model_model_name
+        # First check if models table exists, if not create it
+        unless @model_table_already_existed
+          migration_template 'create_models_migration.rb.tt',
+                             "db/migrate/create_#{table_name_for(model_model_name)}.rb",
+                             migration_version: migration_version,
+                             model_model_name: model_model_name
 
-        sleep 1 # Ensure different timestamp
-      end
+          sleep 1 # Ensure different timestamp
+        end
 
-      migration_template 'migration.rb.tt',
-                         'db/migrate/migrate_to_ruby_llm_model_references.rb',
-                         migration_version: migration_version,
-                         chat_model_name: chat_model_name,
-                         message_model_name: message_model_name,
-                         tool_call_model_name: tool_call_model_name,
-                         model_model_name: model_model_name,
-                         model_table_already_existed: @model_table_already_existed
-    end
+        migration_template 'migration.rb.tt',
+                           'db/migrate/migrate_to_ruby_llm_model_references.rb',
+                           migration_version: migration_version,
+                           chat_model_name: chat_model_name,
+                           message_model_name: message_model_name,
+                           tool_call_model_name: tool_call_model_name,
+                           model_model_name: model_model_name,
+                           model_table_already_existed: @model_table_already_existed
+      end
 
-    def create_model_file
-      create_namespace_modules
+      def create_model_file
+        create_namespace_modules
 
-      template 'model_model.rb.tt', "app/models/#{model_model_name.underscore}.rb"
-    end
+        template 'model_model.rb.tt', "app/models/#{model_model_name.underscore}.rb"
+      end
 
-    def update_existing_models
-      update_model_acts_as(chat_model_name, 'acts_as_chat', acts_as_chat_declaration)
-      update_model_acts_as(message_model_name, 'acts_as_message', acts_as_message_declaration)
-      update_model_acts_as(tool_call_model_name, 'acts_as_tool_call', acts_as_tool_call_declaration)
-    end
+      def update_existing_models
+        update_model_acts_as(chat_model_name, 'acts_as_chat', acts_as_chat_declaration)
+        update_model_acts_as(message_model_name, 'acts_as_message', acts_as_message_declaration)
+        update_model_acts_as(tool_call_model_name, 'acts_as_tool_call', acts_as_tool_call_declaration)
+      end
 
-    def update_initializer
-      initializer_path = 'config/initializers/ruby_llm.rb'
+      def update_initializer
+        initializer_path = 'config/initializers/ruby_llm.rb'
 
-      unless File.exist?(initializer_path)
-        say_status :warning, 'No initializer found. Creating one...', :yellow
-        template 'initializer.rb.tt', initializer_path
-        return
-      end
+        unless File.exist?(initializer_path)
+          say_status :warning, 'No initializer found. Creating one...', :yellow
+          template 'initializer.rb.tt', initializer_path
+          return
+        end
 
-      initializer_content = File.read(initializer_path)
+        initializer_content = File.read(initializer_path)
 
-      return if initializer_content.include?('config.use_new_acts_as')
+        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 << "  config.model_registry_class = \"#{model_model_name}\"" if model_model_name != 'Model'
-        lines << "\n"
-        lines.join("\n")
+        inject_into_file initializer_path, before: /^end/ do
+          lines = ["\n  # Enable the new Rails-like 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")
+        end
       end
-    end
 
-    def show_next_steps
-      say_status :success, 'Upgrade prepared!', :green
-      say <<~INSTRUCTIONS
+      def show_next_steps
+        say_status :success, 'Upgrade prepared!', :green
+        say <<~INSTRUCTIONS
 
-        Next steps:
-        1. Review the generated migrations
-        2. Run: rails db:migrate
-        3. Update your code to use the new API: #{chat_model_name}.create! now has the same signature as RubyLLM.chat
+          Next steps:
+          1. Review the generated migrations
+          2. Run: rails db:migrate
+          3. Update your code to use the new API: #{chat_model_name}.create! now has the same signature as RubyLLM.chat
 
-        ⚠️  If you get "undefined method 'acts_as_model'" during migration:
-           Add this to config/application.rb BEFORE your Application class:
+          ⚠️  If you get "undefined method 'acts_as_model'" during migration:
+            Add this to config/application.rb BEFORE your Application class:
 
-           RubyLLM.configure do |config|
-             config.use_new_acts_as = true
-           end
+            RubyLLM.configure do |config|
+              config.use_new_acts_as = true
+            end
 
-        📚 See the full migration guide: https://rubyllm.com/upgrading-to-1-7/
+          📚 See the full migration guide: https://rubyllm.com/upgrading-to-1-7/
 
-      INSTRUCTIONS
-    end
+        INSTRUCTIONS
+      end
 
-    private
+      private
 
-    def update_model_acts_as(model_name, old_acts_as, new_acts_as)
-      model_path = "app/models/#{model_name.underscore}.rb"
-      return unless File.exist?(Rails.root.join(model_path))
+      def update_model_acts_as(model_name, old_acts_as, new_acts_as)
+        model_path = "app/models/#{model_name.underscore}.rb"
+        return unless File.exist?(Rails.root.join(model_path))
 
-      content = File.read(Rails.root.join(model_path))
-      return unless content.match?(/^\s*#{old_acts_as}/)
+        content = File.read(Rails.root.join(model_path))
+        return unless content.match?(/^\s*#{old_acts_as}/)
 
-      gsub_file model_path, /^\s*#{old_acts_as}.*$/, "  #{new_acts_as}"
+        gsub_file model_path, /^\s*#{old_acts_as}.*$/, "  #{new_acts_as}"
+      end
     end
   end
 end

data/lib/generators/ruby_llm/upgrade_to_v1_9/templates/add_v1_9_message_columns.rb.tt

@@ -0,0 +1,15 @@
+class AddRubyLlmV19Columns < ActiveRecord::Migration<%= migration_version %>
+  def change
+    unless column_exists?(:<%= message_table_name %>, :cached_tokens)
+      add_column :<%= message_table_name %>, :cached_tokens, :integer
+    end
+
+    unless column_exists?(:<%= message_table_name %>, :cache_creation_tokens)
+      add_column :<%= message_table_name %>, :cache_creation_tokens, :integer
+    end
+
+    unless column_exists?(:<%= message_table_name %>, :content_raw)
+      add_column :<%= message_table_name %>, :content_raw, :json
+    end
+  end
+end

data/lib/generators/ruby_llm/upgrade_to_v1_9/upgrade_to_v1_9_generator.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'rails/generators/active_record'
+require_relative '../generator_helpers'
+
+module RubyLLM
+  module Generators
+    # Generator to add v1.9 columns (cached tokens + raw content support) to existing apps.
+    class UpgradeToV19Generator < Rails::Generators::Base
+      include Rails::Generators::Migration
+      include RubyLLM::Generators::GeneratorHelpers
+
+      namespace 'ruby_llm:upgrade_to_v1_9'
+      source_root File.expand_path('templates', __dir__)
+
+      argument :model_mappings, type: :array, default: [], banner: 'message:MessageName'
+
+      desc 'Adds cached token columns and raw content storage fields introduced in v1.9.0'
+
+      def self.next_migration_number(dirname)
+        ::ActiveRecord::Generators::Base.next_migration_number(dirname)
+      end
+
+      def create_migration_file
+        parse_model_mappings
+
+        migration_template 'add_v1_9_message_columns.rb.tt',
+                           'db/migrate/add_ruby_llm_v1_9_columns.rb',
+                           migration_version: migration_version,
+                           message_table_name: message_table_name
+      end
+
+      def show_next_steps
+        say_status :success, 'Upgrade prepared!', :green
+        say <<~INSTRUCTIONS
+
+          Next steps:
+          1. Review the generated migration
+          2. Run: rails db:migrate
+          3. Restart your application server
+
+          📚 See the v1.9.0 release notes for details on cached token tracking and raw content support.
+
+        INSTRUCTIONS
+      end
+    end
+  end
+end

data/lib/ruby_llm/active_record/acts_as.rb

@@ -11,22 +11,22 @@ module RubyLLM
         super
         # Monkey-patch Models to use database when ActsAs is active
         RubyLLM::Models.class_eval do
-          def load_models
+          def self.load_models
             read_from_database
           rescue StandardError => e
             RubyLLM.logger.debug "Failed to load models from database: #{e.message}, falling back to JSON"
             read_from_json
           end
 
-          def load_from_database!
-            @models = read_from_database
-          end
-
-          def read_from_database
+          def self.read_from_database
             model_class = RubyLLM.config.model_registry_class
             model_class = model_class.constantize if model_class.is_a?(String)
             model_class.all.map(&:to_llm)
           end
+
+          def load_from_database!
+            @models = self.class.read_from_database
+          end
         end
       end
 
@@ -45,10 +45,12 @@ module RubyLLM
           has_many messages,
                    -> { order(created_at: :asc) },
                    class_name: self.message_class,
+                   foreign_key: ActiveSupport::Inflector.foreign_key(table_name.singularize),
                    dependent: :destroy
 
           belongs_to model,
                      class_name: self.model_class,
+                     foreign_key: ActiveSupport::Inflector.foreign_key(model.to_s.singularize),
                      optional: true
 
           delegate :add_message, to: :to_llm
@@ -78,7 +80,9 @@ module RubyLLM
           validates :provider, presence: true
           validates :name, presence: true
 
-          has_many chats, class_name: self.chat_class
+          has_many chats,
+                   class_name: self.chat_class,
+                   foreign_key: ActiveSupport::Inflector.foreign_key(table_name.singularize)
 
           define_method :chats_association do
             send(chats_association_name)
@@ -102,10 +106,12 @@ module RubyLLM
 
           belongs_to chat,
                      class_name: self.chat_class,
+                     foreign_key: ActiveSupport::Inflector.foreign_key(chat.to_s.singularize),
                      touch: touch_chat
 
           has_many tool_calls,
                    class_name: self.tool_call_class,
+                   foreign_key: ActiveSupport::Inflector.foreign_key(table_name.singularize),
                    dependent: :destroy
 
           belongs_to :parent_tool_call,
@@ -120,6 +126,7 @@ module RubyLLM
 
           belongs_to model,
                      class_name: self.model_class,
+                     foreign_key: ActiveSupport::Inflector.foreign_key(model.to_s.singularize),
                      optional: true
 
           delegate :tool_call?, :tool_result?, to: :to_llm
@@ -147,10 +154,12 @@ module RubyLLM
           self.result_class = (result_class || self.message_class).to_s
 
           belongs_to message,
-                     class_name: self.message_class
+                     class_name: self.message_class,
+                     foreign_key: ActiveSupport::Inflector.foreign_key(message.to_s.singularize)
 
           has_one result,
                   class_name: self.result_class,
+                  foreign_key: ActiveSupport::Inflector.foreign_key(table_name.singularize),
                   dependent: :nullify
 
           define_method :message_association do

data/lib/ruby_llm/active_record/chat_methods.rb

@@ -174,8 +174,16 @@ module RubyLLM
       end
 
       def create_user_message(content, with: nil)
-        message_record = messages_association.create!(role: :user, content: content)
+        content_text, attachments, content_raw = prepare_content_for_storage(content)
+
+        message_record = messages_association.build(role: :user)
+        message_record.content = content_text
+        message_record.content_raw = content_raw if message_record.respond_to?(:content_raw=)
+        message_record.save!
+
         persist_content(message_record, with) if with.present?
+        persist_content(message_record, attachments) if attachments.present?
+
         message_record
       end
 
@@ -235,28 +243,25 @@ module RubyLLM
         @message = messages_association.create!(role: :assistant, content: '')
       end
 
-      def persist_message_completion(message) # rubocop:disable Metrics/PerceivedComplexity
+      # rubocop:disable Metrics/PerceivedComplexity
+      def persist_message_completion(message)
         return unless message
 
         tool_call_id = find_tool_call_id(message.tool_call_id) if message.tool_call_id
 
         transaction do
-          content = message.content
-          attachments_to_persist = nil
-
-          if content.is_a?(RubyLLM::Content)
-            attachments_to_persist = content.attachments if content.attachments.any?
-            content = content.text
-          elsif content.is_a?(Hash) || content.is_a?(Array)
-            content = content.to_json
-          end
+          content_text, attachments_to_persist, content_raw = prepare_content_for_storage(message.content)
 
           attrs = {
             role: message.role,
-            content: content,
+            content: content_text,
             input_tokens: message.input_tokens,
             output_tokens: message.output_tokens
           }
+          attrs[:cached_tokens] = message.cached_tokens if @message.has_attribute?(:cached_tokens)
+          if @message.has_attribute?(:cache_creation_tokens)
+            attrs[:cache_creation_tokens] = message.cache_creation_tokens
+          end
 
           # Add model association dynamically
           attrs[self.class.model_association_name] = model_association
@@ -266,12 +271,15 @@ module RubyLLM
             attrs[parent_tool_call_assoc.foreign_key] = tool_call_id
           end
 
-          @message.update!(attrs)
+          @message.assign_attributes(attrs)
+          @message.content_raw = content_raw if @message.respond_to?(:content_raw=)
+          @message.save!
 
           persist_content(@message, attachments_to_persist) if attachments_to_persist
           persist_tool_calls(message.tool_calls) if message.tool_calls.present?
         end
       end
+      # rubocop:enable Metrics/PerceivedComplexity
 
       def persist_tool_calls(tool_calls)
         tool_calls.each_value do |tool_call|
@@ -331,6 +339,26 @@ module RubyLLM
         RubyLLM.logger.warn "Failed to process attachment #{source}: #{e.message}"
         nil
       end
+
+      def prepare_content_for_storage(content)
+        attachments = nil
+        content_raw = nil
+        content_text = content
+
+        case content
+        when RubyLLM::Content::Raw
+          content_raw = content.value
+          content_text = nil
+        when RubyLLM::Content
+          attachments = content.attachments if content.attachments.any?
+          content_text = content.text
+        when Hash, Array
+          content_raw = content
+          content_text = nil
+        end
+
+        [content_text, attachments, content_raw]
+      end
     end
   end
 end

data/lib/ruby_llm/active_record/message_methods.rb

@@ -11,6 +11,9 @@ module RubyLLM
       end
 
       def to_llm
+        cached = has_attribute?(:cached_tokens) ? self[:cached_tokens] : nil
+        cache_creation = has_attribute?(:cache_creation_tokens) ? self[:cache_creation_tokens] : nil
+
         RubyLLM::Message.new(
           role: role.to_sym,
           content: extract_content,
@@ -18,6 +21,8 @@ module RubyLLM
           tool_call_id: extract_tool_call_id,
           input_tokens: input_tokens,
           output_tokens: output_tokens,
+          cached_tokens: cached,
+          cache_creation_tokens: cache_creation,
           model_id: model_association&.model_id
         )
       end
@@ -42,9 +47,13 @@ module RubyLLM
       end
 
       def extract_content
-        return content unless respond_to?(:attachments) && attachments.attached?
+        return RubyLLM::Content::Raw.new(content_raw) if has_attribute?(:content_raw) && content_raw.present?
+
+        content_value = self[:content]
+
+        return content_value unless respond_to?(:attachments) && attachments.attached?
 
-        RubyLLM::Content.new(content).tap do |content_obj|
+        RubyLLM::Content.new(content_value).tap do |content_obj|
           @_tempfiles = []
 
           attachments.each do |attachment|

data/lib/ruby_llm/active_record/model_methods.rb

@@ -77,7 +77,7 @@ module RubyLLM
       delegate :supports?, :supports_vision?, :supports_functions?, :type,
                :input_price_per_million, :output_price_per_million,
                :function_calling?, :structured_output?, :batch?,
-               :reasoning?, :citations?, :streaming?,
+               :reasoning?, :citations?, :streaming?, :provider_class,
                to: :to_llm
     end
   end

data/lib/ruby_llm/aliases.json

@@ -8,6 +8,9 @@
     "openrouter": "anthropic/claude-3.5-haiku",
     "bedrock": "anthropic.claude-3-5-haiku-20241022-v1:0"
   },
+  "claude-3-5-haiku-latest": {
+    "anthropic": "claude-3-5-haiku-latest"
+  },
   "claude-3-5-sonnet": {
     "anthropic": "claude-3-5-sonnet-20241022",
     "openrouter": "anthropic/claude-3.5-sonnet",
@@ -18,6 +21,9 @@
     "openrouter": "anthropic/claude-3.7-sonnet",
     "bedrock": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"
   },
+  "claude-3-7-sonnet-latest": {
+    "anthropic": "claude-3-7-sonnet-latest"
+  },
   "claude-3-haiku": {
     "anthropic": "claude-3-haiku-20240307",
     "openrouter": "anthropic/claude-3-haiku",
@@ -31,11 +37,19 @@
   "claude-3-sonnet": {
     "bedrock": "anthropic.claude-3-sonnet-20240229-v1:0"
   },
+  "claude-haiku-4-5": {
+    "anthropic": "claude-haiku-4-5-20251001",
+    "openrouter": "anthropic/claude-haiku-4.5",
+    "bedrock": "us.anthropic.claude-haiku-4-5-20251001-v1:0"
+  },
   "claude-opus-4": {
     "anthropic": "claude-opus-4-20250514",
     "openrouter": "anthropic/claude-opus-4",
     "bedrock": "us.anthropic.claude-opus-4-1-20250805-v1:0"
   },
+  "claude-opus-4-0": {
+    "anthropic": "claude-opus-4-0"
+  },
   "claude-opus-4-1": {
     "anthropic": "claude-opus-4-1-20250805",
     "openrouter": "anthropic/claude-opus-4.1",
@@ -46,30 +60,18 @@
     "openrouter": "anthropic/claude-sonnet-4",
     "bedrock": "us.anthropic.claude-sonnet-4-20250514-v1:0"
   },
+  "claude-sonnet-4-0": {
+    "anthropic": "claude-sonnet-4-0"
+  },
+  "claude-sonnet-4-5": {
+    "anthropic": "claude-sonnet-4-5-20250929",
+    "openrouter": "anthropic/claude-sonnet-4.5",
+    "bedrock": "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+  },
   "deepseek-chat": {
     "deepseek": "deepseek-chat",
     "openrouter": "deepseek/deepseek-chat"
   },
-  "gemini-1.5-flash": {
-    "gemini": "gemini-1.5-flash",
-    "vertexai": "gemini-1.5-flash"
-  },
-  "gemini-1.5-flash-002": {
-    "gemini": "gemini-1.5-flash-002",
-    "vertexai": "gemini-1.5-flash-002"
-  },
-  "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-1.5-pro-002": {
-    "gemini": "gemini-1.5-pro-002",
-    "vertexai": "gemini-1.5-pro-002"
-  },
   "gemini-2.0-flash": {
     "gemini": "gemini-2.0-flash",
     "vertexai": "gemini-2.0-flash"
@@ -93,6 +95,10 @@
     "openrouter": "google/gemini-2.5-flash",
     "vertexai": "gemini-2.5-flash"
   },
+  "gemini-2.5-flash-image": {
+    "gemini": "gemini-2.5-flash-image",
+    "openrouter": "google/gemini-2.5-flash-image"
+  },
   "gemini-2.5-flash-image-preview": {
     "gemini": "gemini-2.5-flash-image-preview",
     "openrouter": "google/gemini-2.5-flash-image-preview"
@@ -106,6 +112,14 @@
     "gemini": "gemini-2.5-flash-lite-preview-06-17",
     "openrouter": "google/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"
+  },
+  "gemini-2.5-flash-preview-09-2025": {
+    "gemini": "gemini-2.5-flash-preview-09-2025",
+    "openrouter": "google/gemini-2.5-flash-preview-09-2025"
+  },
   "gemini-2.5-pro": {
     "gemini": "gemini-2.5-pro",
     "openrouter": "google/gemini-2.5-pro",
@@ -219,6 +233,10 @@
     "openai": "gpt-5",
     "openrouter": "openai/gpt-5"
   },
+  "gpt-5-codex": {
+    "openai": "gpt-5-codex",
+    "openrouter": "openai/gpt-5-codex"
+  },
   "gpt-5-mini": {
     "openai": "gpt-5-mini",
     "openrouter": "openai/gpt-5-mini"
@@ -227,6 +245,22 @@
     "openai": "gpt-5-nano",
     "openrouter": "openai/gpt-5-nano"
   },
+  "gpt-5-pro": {
+    "openai": "gpt-5-pro",
+    "openrouter": "openai/gpt-5-pro"
+  },
+  "gpt-oss-120b": {
+    "openai": "gpt-oss-120b",
+    "openrouter": "openai/gpt-oss-120b"
+  },
+  "gpt-oss-20b": {
+    "openai": "gpt-oss-20b",
+    "openrouter": "openai/gpt-oss-20b"
+  },
+  "imagen-4.0-generate-001": {
+    "gemini": "imagen-4.0-generate-001",
+    "vertexai": "imagen-4.0-generate-001"
+  },
   "o1": {
     "openai": "o1",
     "openrouter": "openai/o1"
@@ -247,6 +281,10 @@
     "openai": "o3",
     "openrouter": "openai/o3"
   },
+  "o3-deep-research": {
+    "openai": "o3-deep-research",
+    "openrouter": "openai/o3-deep-research"
+  },
   "o3-mini": {
     "openai": "o3-mini",
     "openrouter": "openai/o3-mini"
@@ -259,6 +297,10 @@
     "openai": "o4-mini",
     "openrouter": "openai/o4-mini"
   },
+  "o4-mini-deep-research": {
+    "openai": "o4-mini-deep-research",
+    "openrouter": "openai/o4-mini-deep-research"
+  },
   "text-embedding-004": {
     "gemini": "text-embedding-004",
     "vertexai": "text-embedding-004"