ollama_chat 0.0.95 → 0.0.96

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5ae8b473c0dfaba1476f7890f8d1e04244db7f19c9dd9d563a845d9a5798a5f
-  data.tar.gz: 6e0f053ce8c5f9bbe97d5e04d3819fbee2ef9857f6b4c9d6bc4d76fe7e12dffa
+  metadata.gz: 54aa30ed02a44f43f0f197247d4e7f5377007802025ddc55632f60965e6d0548
+  data.tar.gz: aa6e058dd8135e265fbfbc848620ece0730182ff6c11e4b0e9c87a8b68e97590
 SHA512:
-  metadata.gz: 9e514fe65a9e3ccddef894cfe92fdff0e17a1c9ca639994ab54edcd573b219cca6c50774640cd966e8adc4d3232071abacc193c8dd795f9ed6be6460109b62df
-  data.tar.gz: 681c439ba46ee38cce5201696e40dda4dc6f6d2291c505e420c7fa2d63899ffd0e82068e94c6f8509f170e6843480924c969730c328a3c6a92b00702115de994
+  metadata.gz: 96d53286b971b4863f688a8613e9ca3fe3e0ee65b9c5f18b042ea3a910ea8ef8cdb4b2e2b26750c08aae6bcbbdd43371e8f0fd9598f24c494256f58f42ddd8ef
+  data.tar.gz: 1d5aa2eadaa9723f6a20f1019f6965249e9d526d38bd6de5d5e86ed1b76ac82e86bf0e59915330f35a2a48f0ce99c6a4109a50c94d38e30965f4d658be768ce3

data/CHANGES.md

@@ -1,5 +1,56 @@
 # Changes
 
+## 2026-07-03 v0.0.96
+
+### New Features
+
+- Added reroll capability to the `roll_dice` tool, including a new `reroll`
+  configuration option in `default_config.yml` and implementation of a reroll
+  loop using `chat.confirm?`.
+- Enhanced the `roll_dice` tool output to include `min` and `max` bounds in the
+  JSON response and result range in the summary message.
+- Improved character importing by implementing `import_persona_from_json` in
+  `PersonaeManagement`, removing temporary file dependencies.
+- Added the ability to offer new sessions during session selection via
+  `offer_new_session: true` in `SessionManagement`.
+
+### Improvements
+
+- **Tool Messaging**: Added or enhanced human-readable summary `message` fields
+  for several tools to improve user experience:
+    - `GetTime`: Now includes time-of-day greetings and formatted weekdays.
+    - `GetCurrentWeather`: Now incorporates temperature, conditions, and daily
+      forecasts.
+    - `ReadFile` & `WriteFile`: Integrated `OllamaChat::TokenEstimator` for
+      formatted byte and token counts.
+    - `GeneratePassword`: Added summaries covering various alphabet types and
+      errors.
+    - `RetrieveDocumentSnippets`: Added counts and collection details.
+    - `ExecuteGrep`: Added logic to distinguish between found matches and blank
+      results.
+    - `RunTests`: Added emoji-based result summaries and removed reliance on
+      the global `$?` variable.
+    - `ComputeBMI`: Enhanced summary messages and simplified calculation logic.
+- **Character Personalization**: 
+    - Updated `convert_json_character_to_markdown` to replace `{{char}}`
+      placeholders with actual names.
+    - Enhanced `personalize_character_profile` using case-insensitive regexes
+      for `{{user}} and {{char}}`.
+    - Refactored `PNGMetadataExtractor.decode_character` to return a tuple of
+      the decoded string and parsed JSON data.
+- **Token Estimation**: 
+    - Relocated `TokenEstimator` to a primary domain module and introduced an
+      `Estimate` struct for formatted bytes and tokens.
+    - Implemented `OllamaChat::TokenEstimator::Crude` as the estimation engine.
+
+### Refactoring & Maintenance
+
+- Updated Ruby syntax across the project to use shorthand hash syntax (e.g., in
+  `.where`, object initialization, and method calls).
+- Improved compatibility by replacing the `it` parameter with `_1` in the
+  `tools` method within `ToolCalling`.
+- Bumped `context_spook` dependency from **1.5** to **1.6**.
+
 ## 2026-06-29 v0.0.95
 
 ### New Features & Enhancements

data/Rakefile

@@ -56,7 +56,7 @@ GemHadar do
   dependency             'bigdecimal',            '~> 3.1'
   dependency             'csv',                   '~> 3.0'
   dependency             'const_conf',            '~> 0.3'
-  dependency             'context_spook',         '~> 1.5'
+  dependency             'context_spook',         '~> 1.6'
   dependency             'infobar',               '>= 0.13.1'
   dependency             'rubyzip',               '~> 3.0'
   dependency             'sequel',                '~> 5.0'

data/lib/ollama_chat/chat.rb

@@ -33,6 +33,7 @@ require 'context_spook'
 class OllamaChat::Chat
   include Tins::GO
   include Term::ANSIColor
+  include OllamaChat::TokenEstimator
   include OllamaChat::HTTPHandling
   include OllamaChat::Commands
   include OllamaChat::Logging

data/lib/ollama_chat/commands.rb

@@ -724,12 +724,7 @@ module OllamaChat::Commands
       disable_content_parsing
       data
     when 'import'
-      markdown = convert_json_character_to_markdown(data)
-      Tempfile.create('character.md') do |tmp|
-        tmp.puts markdown
-        tmp.flush
-        import_persona(Pathname.new(tmp.path))
-      end
+      import_persona_from_json(data)
       :next
     end
   end

data/lib/ollama_chat/database/models/prompt.rb

@@ -52,9 +52,7 @@ class OllamaChat::Database::Models::Prompt < Sequel::Model(OllamaChat::DB)
   # database when the underlying prompt is removed.
   def after_destroy
     super
-    OllamaChat::Database::Models::Favourite.
-      where(context: context, name: name).
-      destroy
+    OllamaChat::Database::Models::Favourite.where(context:, name:).destroy
   end
 
   # Seeds the prompt table from the provided chat configuration.

data/lib/ollama_chat/follow_chat.rb

@@ -165,7 +165,7 @@ class OllamaChat::FollowChat
         STDOUT.printf(
           "\n%s Execution of tool %s confirmed.\n\n", symbol, bold { name }
         )
-        result = OllamaChat::Tools.registered[name].execute(tool_call, chat: chat)
+        result = OllamaChat::Tools.registered[name].execute(tool_call, chat:)
         if confirmed == :explicit
           chat.log(:info, "Execution of tool %s was explicitly confirmed." % name)
         else
@@ -191,14 +191,13 @@ class OllamaChat::FollowChat
           false
         end
 
-      size_bytes = result.to_s.size
-      tokens     = OllamaChat::Utils::TokenEstimator.estimate(size_bytes)
+      es = OllamaChat::TokenEstimator.estimate(result.to_s)
 
       tools_used[name] = {
         message:,
         warn:     ,
-        size:     format_bytes(size_bytes),
-        tokens:   format_tokens(tokens),
+        size:     es.bytes_formatted,
+        tokens:   es.tokens_formatted,
         duration: Tins::Duration.new(Time.now - start).to_s,
       }
     end

data/lib/ollama_chat/message_list.rb

@@ -380,9 +380,7 @@ class OllamaChat::MessageList
   def show_system_prompt
     current_system = system.to_s
     size_bytes     = current_system.size
-    size           = format_bytes(size_bytes)
-    tokens         = OllamaChat::Utils::TokenEstimator.estimate(size_bytes)
-    tokens_size    = format_tokens(tokens)
+    es             = OllamaChat::TokenEstimator.estimate(size_bytes)
     system_prompt  = @chat.kramdown_ansi_parse(current_system).
        gsub(/\n+\z/, '').full?
     if system_prompt.blank?
@@ -398,7 +396,7 @@ class OllamaChat::MessageList
       #{system_prompt}
 
       System prompt name:   #{bold{system_name}}
-      System prompt length: 👾#{size} 🧩#{tokens_size}
+      System prompt length: 👾#{es.bytes_formatted} 🧩#{es.tokens_formatted}
       EOT
     end
     self

data/lib/ollama_chat/ollama_chat_config/default_config.yml

@@ -402,6 +402,7 @@ tools:
       timeout_duration: 66
     roll_dice:
       default: true
+      reroll: false
       result_display_timeout: 10
     get_ghr:
       default: true

data/lib/ollama_chat/parsing.rb

@@ -76,9 +76,10 @@ module OllamaChat::Parsing
     results = []
 
     if data = metadata.delete('chara') and
-        char = OllamaChat::Utils::PNGMetadataExtractor.decode_character(data)
+        (char, char_data = OllamaChat::Utils::PNGMetadataExtractor.decode_character(data))
       then
-      results << "Character Profile:\n\n#{personalize_character_profile(char)}"
+      name = char_data.dig('data', 'name').full? || Pathname.new(source_io.path).basename.sub_ext('')
+      results << "Character Profile:\n\n#{personalize_character_profile(char, name:)}"
     end
 
     if data = metadata.delete('parameters') and
@@ -222,13 +223,16 @@ module OllamaChat::Parsing
     )
   end
 
-  # Personalizes a character profile by replacing the {{user}} placeholder.
+  # Personalizes a character profile by replacing placeholders with actual names.
   #
   # @param char [String] The raw character JSON string.
+  # @param name [String] The name of the character to replace {{char}} with.
   # @return [String] The personalized character profile.
-  def personalize_character_profile(char)
-    name = user_name || 'the user'
-    char.gsub('{{user}}', name)
+  def personalize_character_profile(char, name:)
+    my_user_name = user_name || 'the user'
+    char = char.gsub(/{{user}}/i, my_user_name)
+    name.present? and char = char.gsub(/{{char}}/i, name)
+    char
   end
 
   # Regular expression to scan content for url/file references

data/lib/ollama_chat/personae_management.rb

@@ -351,14 +351,11 @@ module OllamaChat::PersonaeManagement
         [ pathname, pathname.size ]
       end.compact.sort_by(&:last).reverse_each do |pathname, size_bytes|
         persona_name = pathname.basename.sub_ext('').to_s
-        size_bytes   = pathname.size
-        size         = format_bytes(size_bytes)
-        tokens       = OllamaChat::Utils::TokenEstimator.estimate(size_bytes)
-        tokens_size  = format_tokens(tokens)
+        es           = OllamaChat::TokenEstimator.estimate(size_bytes)
         is_default   = default_persona_name == persona_name
         display_name = prefix_favourite(is_default ? bold { persona_name } : persona_name, favs[persona_name])
 
-        table << [ display_name, size, tokens_size, ]
+        table << [ display_name, es.bytes_formatted, es.tokens_formatted, ]
       end
 
       table.align_column 1, :right
@@ -554,24 +551,41 @@ module OllamaChat::PersonaeManagement
     persona_name
   end
 
+  # Imports a character persona from JSON data, prompts for a name,
+  # and saves the resulting Markdown profile to disk.
+  #
+  # @param json_data [String] The raw character data in JSON format.
+  # @return [String, nil] The name of the created persona if successful,
+  #   or nil if the process was cancelled or failed.
+  def import_persona_from_json(json_data)
+    persona_name = determine_valid_new_name_for_persona('to import from JSON/PNG') or return
+    markdown = convert_json_character_to_markdown(json_data, persona_name)
+    persona_pathname = persona_name_to_pathname(persona_name)
+    persona_pathname.write(markdown)
+    persona_name
+  end
+
   # Transforms raw character data (JSON or YAML) into a high-fidelity,
   # structured Markdown persona profile using the persona architect prompt and
   # the current persona template.
   #
   # This method leverages the LLM to interpret raw attributes and expand them
   # into evocative prose, ensuring the final output conforms to the system's
-  # standard persona structure. It also normalizes placeholder syntax to ensure
-  # compatibility with the internal persona system.
+  # standard persona structure. It also normalizes placeholders: {{user}} is
+  # converted to %{user} for runtime personalization, and {{char}} is replaced
+  # with the actual character name provided.
   #
   # @param character [String] the raw character data in JSON format
+  # @param persona_name [String] the name of the character to replace {{char}} with
   # @return [String] the resulting structured Markdown persona profile
-  def convert_json_character_to_markdown(character)
-    generate(
+  def convert_json_character_to_markdown(character, persona_name)
+    response = generate(
       prompt:  prompt(:persona_architect).to_s % {
         character:,
         persona_template: prompt(:persona).to_s
       }
-    ).response.gsub('{{user}}', '%{user}')
+    ).response
+    response.gsub(/{{user}}/i, '%{user}').gsub(/{{char}}/i, persona_name)
   end
 
   # Interactively exports a persona profile to a specified file.

data/lib/ollama_chat/session_management.rb

@@ -104,15 +104,12 @@ module OllamaChat::SessionManagement
                       else
                         name
                       end
-        size_bytes  = s.messages.to_s.size
-        size        = format_bytes(size_bytes)
-        tokens      = OllamaChat::Utils::TokenEstimator.estimate(size_bytes)
-        tokens_size = format_tokens(tokens)
+        es = OllamaChat::TokenEstimator.estimate(s.messages.to_s)
         table << [
           s.id.to_s,
           name,
-          size,
-          tokens_size,
+          es.bytes_formatted,
+          es.tokens_formatted,
           s.messages.to_s.count(?\n),
           s.age(now:),
         ]
@@ -130,12 +127,10 @@ module OllamaChat::SessionManagement
   #
   # @param output [IO] the output stream to write the information to (default: STDOUT)
   def show_session(output: STDOUT)
-    size_bytes = session.messages.to_s.size
-    messages_size  = format_bytes(size_bytes)
-    tokens         = OllamaChat::Utils::TokenEstimator.estimate(size_bytes)
-    tokens_size    = format_tokens(tokens)
+    size_bytes     = session.messages.to_s.size
+    es             = OllamaChat::TokenEstimator.estimate(size_bytes)
     messages_count = session.messages.to_s.count(?\n)
-    output.puts "#{bold{session.name}} (#{italic{session.id}}), #{messages_size}/#{tokens_size}, #{messages_count} messages"
+    output.puts "#{bold{session.name}} (#{italic{session.id}}), #{es.bytes_formatted}/#{es.tokens_formatted}, #{messages_count} messages"
   end
 
   # Interactively prompts the user for a unique session name.
@@ -227,7 +222,7 @@ module OllamaChat::SessionManagement
   # @return [OllamaChat::Database::Models::Session] the initialized session
   def setup_session
     @session = if session_name = @opts[?l]
-                 choose_session(session_name)
+                 choose_session(session_name,  offer_new_session: true)
                elsif @opts[?n]
                  new_session
                else
@@ -258,7 +253,8 @@ module OllamaChat::SessionManagement
       will be deleted, pick a new session to switch to.
     EOT
     confirm?(prompt: "\n⏎  Press any key to continue (%s). ", timeout: 3)
-    if chosen_session = choose_session(??, except_id: current_session_id)
+    if chosen_session = choose_session(??, except_id: current_session_id, offer_new_session: true)
+      chosen_session.save
       confirm?(
         prompt: "🔔 Delete session #{current_session_name.inspect} (#{current_session_id})? (y/n) ",
         yes: /\Ay/i
@@ -476,22 +472,20 @@ module OllamaChat::SessionManagement
     elsif selector
       now = Time.now
       sessions = session_query.order(Sequel.desc(:updated_at)).map { |session|
-        duration    = session.age(now:)
-        size_bytes  = session.messages.to_s.size
-        tokens      = OllamaChat::Utils::TokenEstimator.estimate(size_bytes)
-        tokens_size = format_tokens(tokens)
-        count       = session.messages.to_s.count(?\n)
-        locked      = if pid = session.locked?
-                        if pid == $$
-                          " 🔓#{pid} "
-                        else
-                          " 🔐#{pid} "
-                        end
-                      else
-                        ' '
-                      end
+        duration = session.age(now:)
+        es       = OllamaChat::TokenEstimator.estimate(session.messages.to_s)
+        count    = session.messages.to_s.count(?\n)
+        locked   = if pid = session.locked?
+                     if pid == $$
+                       " 🔓#{pid} "
+                     else
+                       " 🔐#{pid} "
+                     end
+                   else
+                     ' '
+                   end
         display     = <<~EOT.strip
-          #{session.name} 🆔#{session.id}#{locked}📨#{count} 🧩#{tokens_size} ⏳#{duration}
+          #{session.name} 🆔#{session.id}#{locked}📨#{count} 🧩#{es.tokens_formatted} ⏳#{duration}
         EOT
         SearchUI::Wrapper.new(
           session.name,

data/lib/ollama_chat/source_fetching.rb

@@ -246,7 +246,7 @@ module OllamaChat::SourceFetching
       source_io.rewind
       embed_source(source_io, source, tags:) or return
     end
-    prompt(:embed).to_s % { collection: collection }
+    prompt(:embed).to_s % { collection: }
   end
 
   private

data/lib/ollama_chat/token_estimator/crude.rb

@@ -0,0 +1,25 @@
+# Provides a "best-effort" estimation of token counts based on the
+# character count or byte size of the input content.
+class OllamaChat::TokenEstimator::Crude
+  # Initializes a new crude estimator with the provided source.
+  #
+  # @param arg [String, Integer] The content to estimate (string or raw byte count).
+  # @raise [ArgumentError] if the input is not a string or an integer.
+  def initialize(arg)
+    if text = arg.ask_and_send(:to_str)
+      @bytes = text.size
+    elsif bytes = arg.ask_and_send(:to_int)
+      @bytes = bytes
+    else
+      raise ArgumentError, "#{arg.inspect} cannot be used to estimate"
+    end
+  end
+
+  # Performs the estimation calculation and returns an Estimate object.
+  #
+  # @return [OllamaChat::TokenEstimator::Estimate]
+  def perform
+    tokens = (@bytes.to_f / 3.5).ceil
+    OllamaChat::TokenEstimator::Estimate.new(bytes: @bytes, tokens:)
+  end
+end

data/lib/ollama_chat/token_estimator.rb

@@ -0,0 +1,36 @@
+# Provides tools for estimating token counts across different models and contexts.
+module OllamaChat::TokenEstimator
+end
+
+# Requires the core estimation implementations.
+require 'ollama_chat/token_estimator/crude'
+
+# A data structure that holds the results of a token estimation,
+# providing convenient formatting methods for both byte size and token count.
+module OllamaChat::TokenEstimator
+  # Represents the result of a calculation including raw values
+  # and their human-readable formatted strings.
+  class Estimate < Struct.new(:bytes, :tokens)
+    include OllamaChat::Utils::ValueFormatter
+
+    # Returns the byte count in a formatted string (e.g., "1.2 KB").
+    # @return [String] The formatted byte size.
+    def tokens_formatted
+      format_tokens(tokens)
+    end
+
+    # Returns the byte count as a formatted string.
+    # @return [String] The formatted byte size.
+    def bytes_formatted
+      format_bytes(bytes)
+    end
+  end
+
+  # Estimates token count for a given piece of content.
+  #
+  # @param text [String, Integer] The content to estimate (string or raw byte count).
+  # @return [OllamaChat::TokenEstimator::Estimate] An object containing the results.
+  def self.estimate(text)
+    OllamaChat::TokenEstimator::Crude.new(text).perform
+  end
+end

data/lib/ollama_chat/tool_calling.rb

@@ -55,7 +55,7 @@ module OllamaChat::ToolCalling
   # @return [ Hash ] a hash containing the registered tools
   def tools
     tools_support.off? and return []
-    enabled_tools.filter_map { OllamaChat::Tools.registered[it]&.to_hash }
+    enabled_tools.filter_map { OllamaChat::Tools.registered[_1]&.to_hash }
   end
 
   # The default_enabled_tools method returns an array of tool names that are

data/lib/ollama_chat/tools/compute_bmi.rb

@@ -85,13 +85,15 @@ class OllamaChat::Tools::ComputeBMI
     raise OllamaChat::ToolFunctionArgumentError, 'Height must be greater than zero and in kg/lbs' if height <= 0
     raise OllamaChat::ToolFunctionArgumentError, 'Weight must be less than 3m and in meter/feet' if height > 3
 
-    bmi      = ( weight / (height**2) ).round(2)
+    bmi      = ( weight / height**2 ).round(2)
     category = calculate_category(bmi)
+    message  = "This BMI is #{bmi}, which falls into the #{category} category."
 
     {
-      bmi:        bmi,
-      category:   category,
-      units:      ,
+      bmi:,
+      category:,
+      units:,
+      message:,
     }.to_json
   rescue => e
     { error: e.class, message: e.message }.to_json

data/lib/ollama_chat/tools/execute_grep.rb

@@ -88,7 +88,17 @@ class OllamaChat::Tools::ExecuteGrep
     context     = normalize_number(args.context)
     cmd         = eval_template(config, pattern, path, max_results, ignore_case, before, after, context)
     result      = OllamaChat::Utils::Fetcher.execute(cmd, &:read)
-    { cmd:, result: }.to_json
+    message =
+      if result.blank?
+        "No matches found for #{args.pattern.inspect} in #{path.inspect}."
+      else
+        "Found some matches for #{args.pattern.inspect} in #{path.inspect}."
+      end
+    {
+      cmd:,
+      result:,
+      message:,
+    }.to_json
   rescue => e
     { error: e.class, message: e.message }.to_json
   end

data/lib/ollama_chat/tools/generate_password.rb

@@ -137,13 +137,16 @@ class OllamaChat::Tools::GeneratePassword
               Tins::Token.new(length:, alphabet:)
             end
 
+    message = "Successfully generated a #{token.length}-character secure password using the #{alphabet_type} alphabet."
+
     result = {
       password:      token,
       length:        token.length,
       bits:          token.bits,
-      alphabet_type: alphabet_type,
+      alphabet_type: ,
       uppercase:     ,
       extended:      ,
+      message:        ,
       generated_at:  Time.now.iso8601
     }
     if alphabet_type == 'default'

data/lib/ollama_chat/tools/get_current_weather.rb

@@ -53,8 +53,19 @@ class OllamaChat::Tools::GetCurrentWeather
     chat   = opts[:chat]
     config = chat.config
     units  = config.location.units =~ /SI/ ? 'si' : 'us'
+
     data   = { current_time: Time.now, units: } |
       JSON(get_weather_data(chat, config, units)).deep_symbolize_keys
+
+    temp      = data.dig(:currently, :temperature)
+    curr_sum  = data.dig(:currently, :summary)
+    daily_sum = data.dig(:daily, :summary)
+    unit_sym  = units == 'si' ? '°C' : '°F'
+
+    message = "Currently #{temp}#{unit_sym} and #{curr_sum}. Today's forecast: #{daily_sum}"
+
+    data[:message] = message
+
     data.to_json
   rescue => e
     {

data/lib/ollama_chat/tools/get_time.rb

@@ -54,8 +54,19 @@ class OllamaChat::Tools::GetTime
   #   execute(tool_call, config:)
   #   # => {"time":"2026-02-09T14:32:00+01:00","weekday":"Monday"}
   def execute(_tool_call, **_opts)
-    now = Time.now
-    { time: now.iso8601, weekday: now.strftime('%A') }.to_json
+    now  = Time.now
+    hour = now.hour
+
+    greeting = case hour
+               when 5..11  then 'Good morning'
+               when 12..17 then 'Good afternoon'
+               when 18..23 then 'Good evening'
+               else             'Good night'
+               end
+
+    message = "#{greeting}! It is currently #{now.strftime('%H:%M')} on #{now.strftime('%A')}."
+
+    { time: now.iso8601, weekday: now.strftime('%A'), message: }.to_json
   end
 
   self

data/lib/ollama_chat/tools/open_file_in_editor.rb

@@ -82,10 +82,10 @@ class OllamaChat::Tools::OpenFileInEditor
 
     {
       success:    true,
-      message:   ,
+      message:    ,
       path:       file_path,
-      start_line: start_line,
-      end_line:   end_line,
+      start_line: ,
+      end_line:   ,
     }.to_json
   rescue => e
     {

data/lib/ollama_chat/tools/read_file.rb

@@ -73,12 +73,15 @@ class OllamaChat::Tools::ReadFile
 
     path    = assert_valid_path(args.path, config.tools.functions.read_file.allowed?, check: :file)
     content = extract_range(path.read, start_line, end_line)
+    es      = OllamaChat::TokenEstimator.estimate(content)
+    message = "Read #{es.bytes_formatted} (#{es.tokens_formatted}) from #{path.to_s.inspect}."
 
     {
       path:,
       content:,
       start_line:,
       end_line:,
+      message:,
     }.to_json
   rescue => e
     {

data/lib/ollama_chat/tools/retrieve_document_snippets.rb

@@ -123,15 +123,22 @@ class OllamaChat::Tools::RetrieveDocumentSnippets
       records = rerank_records(chat, query, records)
     end
 
-    message = records.map { |record|
-      link = if record.source =~ %r(\Ahttps?://)
-               record.source
-             else
-               'file://%s' % File.expand_path(record.source)
-             end
-      link && record.tags.any? or next
-      [ link, ?# + record.tags.first ]
-    }.flat_map { |l, t| chat.hyperlink(l, t) }.join(' ')
+    collection_name = chat.documents.collection
+    message =
+      if records.any?
+        "Retrieved #{records.size} relevant snippets from collection #{collection_name.inspect} for query #{query.inspect}. See snippets below:\n\n" +
+          records.map { |record|
+            link = if record.source =~ %r(\Ahttps?://)
+                     record.source
+                   else
+                     'file://%s' % File.expand_path(record.source)
+                   end
+            link && record.tags.any? or next
+            [ link, ?# + record.tags.first ]
+          }.flat_map { |l, t| chat.hyperlink(l, t) }.join(' ')
+      else
+        "No relevant snippets found for query #{query.inspect} in collection #{collection_name.inspect}."
+      end
 
     {
       prompt: 'Consider these snippets generated from retrieval when formulating your response!',
@@ -208,7 +215,7 @@ class OllamaChat::Tools::RetrieveDocumentSnippets
       prompt:         chat.config.embedding.model.prompt?,
       text_size:      ,
       text_count:     ,
-      min_similarity: min_similarity
+      min_similarity:
     )
   end