ruby_llm 1.1.0rc1 → 1.1.0rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f1ca42c438f99a40f6ada6ab87e23377403d9d6c8db6049d54960308b6dd42f
-  data.tar.gz: 0467734c40a0a64505b8f4de2eea4b929e2b0c615fedb3fe88d75f8cf20040de
+  metadata.gz: 76bc09be7c31380ca96740730c8d0124847936f26c8067be26d431c670d81855
+  data.tar.gz: 280026eba72f99a48ecf1660d8a0b4f6b07ceff08cdb05d94ede589aa2d597fc
 SHA512:
-  metadata.gz: ed886fb15081ce27309c0e583223e62adf171907f0f047344763e9eae5ede4dbb96657bb1b69dde9e68bc1ed56acedb93717273067236e40104dddcc09886f33
-  data.tar.gz: 7f2aa9c50cfd1a525273256ff014712944c976229f6b90fe338decaf2525bcb82f19dec187d14795ce0891a7fceadb5c048905c8afa8066b0ddbe37d54c48edd
+  metadata.gz: 4bae50d060f691e26508a24b51bf5b022a65ce2707426b2616ceeec6895e22eab1663c1b4687a6830566622a100530ecdc569b6f6ec7cdc1aaeadb0324cad69a
+  data.tar.gz: 0d824847a5ebc619339830cc48ac4d48038d52b180d7cb4f6c90812c6899fc09dd416b67f6d0f9e9cb820ff177a9afc8898e2b27f7201e14d497fd092d9b5a48

data/lib/ruby_llm/chat.rb

@@ -32,7 +32,9 @@ module RubyLLM
 
     alias say ask
 
-    def with_instructions(instructions)
+    def with_instructions(instructions, replace: false)
+      @messages = @messages.reject! { |msg| msg.role == :system } if replace
+
       add_message role: :system, content: instructions
       self
     end

data/lib/ruby_llm/providers/bedrock.rb

@@ -33,6 +33,22 @@ module RubyLLM
         end
       end
 
+      def parse_error(response) # rubocop:disable Metrics/MethodLength
+        return if response.body.empty?
+
+        body = try_parse_json(response.body)
+        case body
+        when Hash
+          body['message']
+        when Array
+          body.map do |part|
+            part['message']
+          end.join('. ')
+        else
+          body
+        end
+      end
+
       def sign_request(url, method: :post, payload: nil)
         signer = create_signer
         request = build_request(url, method:, payload:)

data/lib/ruby_llm/tool.rb

@@ -72,9 +72,6 @@ module RubyLLM
       result = execute(**args.transform_keys(&:to_sym))
       RubyLLM.logger.debug "Tool #{name} returned: #{result.inspect}"
       result
-    rescue StandardError => e
-      RubyLLM.logger.error "Tool #{name} failed with error: #{e.message}"
-      { error: e.message }
     end
 
     def execute(...)

data/lib/ruby_llm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyLLM
-  VERSION = '1.1.0rc1'
+  VERSION = '1.1.0rc2'
 end

data/lib/tasks/models_docs.rake

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+require 'ruby_llm'
+require 'fileutils'
+
+MODEL_KEYS_TO_DISPLAY = %i[
+  id
+  type
+  display_name
+  provider
+  context_window
+  max_tokens
+  family
+  input_price_per_million
+  output_price_per_million
+].freeze
+
+def to_markdown_table(models) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+  to_display_hash = ->(model) { model.to_h.slice(*MODEL_KEYS_TO_DISPLAY) }
+  model_hashes = Array(models).map { |model| to_display_hash.call(model) }
+
+  # Create abbreviated headers
+  headers = {
+    id: 'ID',
+    type: 'Type',
+    display_name: 'Name',
+    provider: 'Provider',
+    context_window: 'Context',
+    max_tokens: 'MaxTok',
+    family: 'Family',
+    input_price_per_million: 'In$/M',
+    output_price_per_million: 'Out$/M'
+  }
+
+  # Create header row with alignment markers
+  # Right-align numbers, left-align text
+  alignments = {
+    id: ':--',
+    type: ':--',
+    display_name: ':--',
+    provider: ':--',
+    context_window: '--:',
+    max_tokens: '--:',
+    family: ':--',
+    input_price_per_million: '--:',
+    output_price_per_million: '--:'
+  }
+
+  # Build the table
+  lines = []
+
+  # Header row
+  lines << "| #{MODEL_KEYS_TO_DISPLAY.map { |key| headers[key] }.join(' | ')} |"
+
+  # Alignment row
+  lines << "| #{MODEL_KEYS_TO_DISPLAY.map { |key| alignments[key] }.join(' | ')} |"
+
+  # Data rows
+  model_hashes.each do |model_hash|
+    values = MODEL_KEYS_TO_DISPLAY.map do |key|
+      if model_hash[key].is_a?(Float)
+        format('%.2f', model_hash[key])
+      else
+        model_hash[key]
+      end
+    end
+
+    lines << "| #{values.join(' | ')} |"
+  end
+
+  lines.join("\n")
+end
+
+namespace :models do # rubocop:disable Metrics/BlockLength
+  desc 'Generate available models documentation'
+  task :docs do # rubocop:disable Metrics/BlockLength
+    FileUtils.mkdir_p('docs/guides') # ensure output directory exists
+
+    output = <<~MARKDOWN
+      ---
+      layout: default
+      title: Available Models
+      parent: Guides
+      nav_order: 10
+      permalink: /guides/available-models
+      ---
+
+      # Available Models
+
+      This guide lists all models available in RubyLLM, automatically generated from the current model registry.
+
+      _Last updated: #{Time.now.utc.strftime('%Y-%m-%d')}_
+
+      ## Contributing
+
+      The model list is automatically generated from the model registry. To add or update models:
+
+      1. Edit the appropriate `capabilities.rb` file in `lib/ruby_llm/providers/<provider>/`
+      2. Run `rake models:update` to refresh the model registry
+      3. Submit a pull request with the updated `models.json`
+
+      See [Contributing Guide](/CONTRIBUTING.md) for more details.
+
+      ## Additional Model Information
+
+      The tables below show basic model information including context windows, token limits, and pricing. Models also have additional capabilities not shown in the tables:
+
+      - **Vision Support**: Whether the model can process images
+      - **Function Calling**: Whether the model supports function calling
+      - **JSON Mode**: Whether the model can be constrained to output valid JSON
+      - **Structured Output**: Whether the model supports structured output formats
+
+      For complete model information, you can check the `models.json` file in the RubyLLM source code.
+
+      For more information about working with models, see the [Working with Models](/guides/models) guide.
+
+      ## Models by Type
+
+      ### Chat Models (#{RubyLLM.models.chat_models.count})
+
+      #{to_markdown_table(RubyLLM.models.chat_models)}
+
+      ### Image Models (#{RubyLLM.models.image_models.count})
+
+      #{to_markdown_table(RubyLLM.models.image_models)}
+
+      ### Audio Models (#{RubyLLM.models.audio_models.count})
+
+      #{to_markdown_table(RubyLLM.models.audio_models)}
+
+      ### Embedding Models (#{RubyLLM.models.embedding_models.count})
+
+      #{to_markdown_table(RubyLLM.models.embedding_models)}
+
+      ### Moderation Models (#{RubyLLM.models.select { |m| m.type == 'moderation' }.count})
+
+      #{to_markdown_table(RubyLLM.models.select { |m| m.type == 'moderation' })}
+
+      ## Models by Provider
+
+      #{RubyLLM::Provider.providers.keys.map do |provider|
+        models = RubyLLM.models.by_provider(provider)
+        next if models.none?
+
+        <<~PROVIDER
+          ### #{provider.to_s.capitalize} Models (#{models.count})
+
+            #{to_markdown_table(models)}
+        PROVIDER
+      end.compact.join("\n")}
+    MARKDOWN
+
+    File.write('docs/guides/available-models.md', output)
+    puts 'Generated docs/guides/available-models.md'
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm
 version: !ruby/object:Gem::Version
-  version: 1.1.0rc1
+  version: 1.1.0rc2
 platform: ruby
 authors:
 - Carmine Paolino
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-02 00:00:00.000000000 Z
+date: 2025-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -176,6 +176,7 @@ files:
 - lib/tasks/code_validator.rb
 - lib/tasks/model_updater.rb
 - lib/tasks/models.rake
+- lib/tasks/models_docs.rake
 - lib/tasks/vcr.rake
 homepage: https://rubyllm.com
 licenses: