ollama_chat 0.0.82 → 0.0.84

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4dfcb462fdb59e2b4cf31ef8d489627982e71c88cfc9dea8c89597607311e95d
-  data.tar.gz: 1fed1ad543d810ddf0b54b5390b8a031cf3108bd67d56a9a91b5917fc2cdd219
+  metadata.gz: f2439d1523f092997e86300083d46a0db7efcc3e2e6d4253c828ae83ae417043
+  data.tar.gz: 3e946c28dc28d5b6eacd948437dbede5f7160cdad4dca205d2b9fc7f57a0f5fe
 SHA512:
-  metadata.gz: fe1384443f22e5890a784be50a632c9a4d15e8fbf72f0084acf99016aa46a741320af818a72d3797007bced8f0f47155001a12e0103be3ac35f2fb6beba8db6d
-  data.tar.gz: e79cd80f16e97778f6e61451b7aefbbfdf44a1a08cdce5029a21e050f78461fcf11e198ae04e9e0845d2ed9426057c5616333a09bc9d8eaf391be7a3b8c4d290
+  metadata.gz: 8e06a5f8362fe5760eb063eb810041449d1faeec408e40c6d806621814f148818e06e1799452c0357add7d723c512c52bc04aab768166bf8c73e8fa923ebc6d1
+  data.tar.gz: 6194047eb8d4f3ef45b62df2d307e7f498e29b08566ea2061a73813ef1753a5554e41427f212b7381bd093b50806529ac2da255f02f35d0667dc62892984424f

data/CHANGES.md

@@ -1,5 +1,44 @@
 # Changes
 
+## 2026-03-26 v0.0.84
+
+- Added `OllamaChat::Utils::ValueFormatter` with helper `format_bytes` in
+  `lib/ollama_chat/utils/value_formatter.rb`.  
+    - Added `require 'ollama_chat/utils/value_formatter'` where needed.  
+    - Updated `write_file`, `patch_file`, `paste_from_clipboard` to use
+      `format_bytes` for byte‑size messages.  
+- Implemented new tool `RetrieveDocumentSnippets` in
+  `lib/ollama_chat/tools/retrieve_document_snippets.rb` and its spec
+  `spec/ollama_chat/tools/retrieve_document_snippets_spec.rb`.  
+    - Updated `default_config.yml` to enable `retrieve_document_snippets` by
+      default.  
+- Rewrote tool payloads to include a `message` key for `browse`, `search_web`,
+  `paste_from_clipboard`, `resolve_tag`, and others.  
+- `browse` now returns `"Opened \"<url>\" in browser."` or a failure message.  
+- Refactored `confirm?` in `lib/ollama_chat/dialog.rb` to accept keyword `yes:`
+  for a confirmation regex and display a coloured emoji matching the response
+  or timeout/default.  
+    - Updated all calls to `confirm?` to use `yes: /y/i` syntax.  
+    - Updated `lib/ollama_chat/message_output.rb` to add `yes:` keyword to
+      `confirm?` calls and refine the emoji shown when a file already exists.  
+
+## 2026-03-24 v0.0.83
+
+- Added timeout support to `Dialog#confirm?`: introduced optional `timeout:`
+  and `default:` parameters, injected `IO.select` logic to respect the supplied
+  timeout and return the `default` when timed out, and updated YARD comments to
+  document the new parameters and return behavior.
+- Normalized namespaced tool calls in `OllamaChat`: updated
+  `lib/ollama_chat/follow_chat.rb` to extract the basename from `name` when it
+  contains a slash, added a warning log `@chat.log(:warn, msg)` to inform users
+  when a namespaced tool call is corrected, and adjusted the `name` variable so
+  that `@chat.tool_configured?(name)` and subsequent logic use the corrected
+  tool name.
+- Updated `OllamaChat::Dialog#choose_collection` to convert
+  `@documents.collections` to an array before concatenation, ensuring
+  consistent behavior when collections are not already arrays (e.g., NULL
+  objects).
+
 ## 2026-03-21 v0.0.82
 
 - Add a `before` block setting `OC::OLLAMA::CHAT::TOOLS::CTAGS_TOOL` to `ctags`

data/lib/ollama_chat/chat.rb

@@ -61,6 +61,7 @@ class OllamaChat::Chat
   include OllamaChat::ToolCalling
   include OllamaChat::ConfigHandling
   include OllamaChat::PersonaeManagement
+  include OllamaChat::Utils::ValueFormatter
 
   # Initializes a new OllamaChat::Chat instance with the given command-line
   # arguments.
@@ -492,7 +493,7 @@ class OllamaChat::Chat
           STDOUT.puts "Exiting chooser."
           break
         when '[ALL]'
-          if confirm?(prompt: '🔔 Are you sure? (y/n) ') =~ /y/i
+          if confirm?(prompt: '🔔 Are you sure? (y/n) ', yes: /y/i)
             @documents.clear
             STDOUT.puts "Cleared collection #{bold{@documents.collection}}."
             break
@@ -537,7 +538,7 @@ class OllamaChat::Chat
       end
     when 'edit'
       if result = edit_persona and
-          confirm?(prompt: '🔔 Load new persona profile? (y/n) ') =~ /y/i
+          confirm?(prompt: '🔔 Load new persona profile? (y/n) ', yes: /y/i)
         then
         result
       else
@@ -868,7 +869,7 @@ class OllamaChat::Chat
           STDOUT.puts "Exiting chooser."
           break
         when '[ALL]'
-          if confirm?(prompt: '🔔 Are you sure? (y/n) ') =~ /y/i
+          if confirm?(prompt: '🔔 Are you sure? (y/n) ', yes: /y/i)
             links.clear
             STDOUT.puts "Cleared all links in list."
             break
@@ -916,7 +917,7 @@ class OllamaChat::Chat
       @documents.clear
       STDOUT.puts "Cleared all tags."
     when 'all'
-      if confirm?(prompt: '🔔 Are you sure to clear messages and collection? (y/n) ') =~ /y/i
+      if confirm?(prompt: '🔔 Are you sure to clear messages and collection? (y/n) ', yes: /y/i)
         messages.clear
         @documents.clear
         links.clear
@@ -1000,27 +1001,6 @@ class OllamaChat::Chat
                         [ content, Documentrix::Utils::Tags.new(valid_tag: /\A#*([\w\]\[]+)/) ]
                       end
 
-      if embedding.on? && content
-        records = @documents.find_where(
-          content.downcase.first(config.embedding.model.context_length),
-          tags:,
-          prompt:     config.embedding.model.prompt?,
-          text_size:  config.embedding.found_texts_size?,
-          text_count: config.embedding.found_texts_count?,
-        )
-        unless records.empty?
-          content << ?\n << JSON(
-            prompt: "Consider these snippets generated from retrieval when formulating your response!",
-            ollama_chat_retrieval_snippets: records.map { |r|
-              {
-                text: r.text,
-                tags: r.tags_set.map { |t| { name: t.to_s(link: false), source: t.source }.compact }
-              }
-            },
-          )
-        end
-      end
-
       runtime_info.on? && content and
         content << ?\n << {
           ollama_chat_runtime_information: runtime_information
@@ -1056,17 +1036,6 @@ class OllamaChat::Chat
           raise
         end
       end
-      if embedding.on? && !records.empty?
-        STDOUT.puts "", records.map { |record|
-          link = if record.source =~ %r(\Ahttps?://)
-                   record.source
-                 else
-                   'file://%s' % File.expand_path(record.source)
-                 end
-          [ link, ?# + record.tags.first ]
-        }.uniq.map { |l, t| hyperlink(l, t) }.join(' ')
-        debug and jj messages.to_ary
-      end
 
       case type
       when :socket_input

data/lib/ollama_chat/config_handling.rb

@@ -58,7 +58,7 @@ module OllamaChat::ConfigHandling
     unless diff_tool = OC::DIFF_TOOL?
       exit 1
     end
-    if confirm?(prompt: '🔔 Do you want to fix the config? (y/n) ') =~ /y/i
+    if confirm?(prompt: '🔔 Do you want to fix the config? (y/n) ', yes: /y/i)
       system Shellwords.join([
         diff_tool,
         @ollama_chat_config.filename,
@@ -84,7 +84,7 @@ module OllamaChat::ConfigHandling
   #    `ollama_chat` if desired.
   def edit_config
     if result = edit_file(@ollama_chat_config.filename)
-      if confirm?(prompt: "🔔 Do you want to restart #{progname}? (y/n) ") =~ /y/i
+      if confirm?(prompt: "🔔 Do you want to restart #{progname}? (y/n) ", yes: /y/i)
         save_conversation(OC::XDG_CACHE_HOME + 'backup.json')
         save_history
         exec($0, *ARGV)
@@ -101,7 +101,7 @@ module OllamaChat::ConfigHandling
   # @example Restarting the app after confirmation
   #   config.reload_config  # => restarts if user answers "y"
   def reload_config
-    if confirm?(prompt: "🔔 Do you want to restart #{progname}? (y/n) ") =~ /y/i
+    if confirm?(prompt: "🔔 Do you want to restart #{progname}? (y/n) ", yes: /y/i)
       save_conversation(OC::XDG_CACHE_HOME + 'backup.json')
       save_history
       exec($0, *ARGV)

data/lib/ollama_chat/conversation.rb

@@ -26,9 +26,12 @@ module OllamaChat::Conversation
   # @example Save conversation with explicit filename
   #   chat.save_conversation('conversations/2023-10-15_my_session.json')
   def save_conversation(filename)
-    File.exist?(filename) &&
-      confirm?(prompt: "🔔 File #{filename.to_s.inspect} already exists, overwrite? (y/n) ") !~ /y/i and
-      return
+    if File.exist?(filename)
+      confirm?(
+        prompt: "🔔 File #{filename.to_s.inspect} already exists, overwrite? (y/n) ",
+        yes: /y/i
+      ) or return
+    end
     if messages.save_conversation(filename)
       STDOUT.puts "Saved conversation to #{filename.to_s.inspect}."
     else

data/lib/ollama_chat/dialog.rb

@@ -27,15 +27,55 @@ module OllamaChat::Dialog
   # from the user in raw mode, then returns that character. This is best used
   # for confirmation prompts.
   #
-  # @param prompt [ String ] the prompt to display to the user.
-  # @return [ String ] the character entered by the user.
-  def confirm?(prompt:)
+  # @param prompt   [String]  the prompt to display to the user
+  # @param timeout  [Integer, nil] optional timeout in seconds; if nil, the
+  #   method blocks until input, if 0 the method immediatly returns the default
+  #   value.
+  # @param default  [Object, nil]  value returned when the timeout expires
+  #   (defaults to `nil`)
+  #
+  # @return [Object] the character entered by the user, or the `default` value
+  #   if a timeout occurs
+  def confirm?(prompt:, timeout: nil, default: nil, yes: nil)
+    return default if timeout&.zero?
+    if prompt.include?('%s')
+      prompt = prompt % (timeout ? ('timeout in %us' % timeout) : 'no timeout')
+    end
     print prompt
     system 'stty raw'
-    c = STDIN.getc
+    keypress = nil
+    c = if timeout
+          keypress = !!IO.select([ STDIN ], nil, nil, timeout)
+          keypress ? STDIN.getc : nil
+        else
+          keypress = true
+          STDIN.getc
+        end
     system 'stty cooked'
-    puts
-    c
+    answer = c || default
+    case
+    when yes.nil?
+      if keypress
+        puts "⌨️ #{answer}"
+      else
+        puts "⌛️ #{answer}"
+      end
+      answer
+    when answer =~ yes
+      if keypress
+        puts "✅ #{answer}"
+      else
+        puts "☑️  #{answer}"
+      end
+      answer
+    else
+      if keypress
+        puts "🚫 #{answer}"
+      else
+        puts "⌛️ #{answer}"
+      end
+      nil
+    end
   end
 
   private
@@ -78,7 +118,7 @@ module OllamaChat::Dialog
   #
   # @param current_collection [ String, nil ] the name of the currently active collection
   def choose_collection(current_collection)
-    collections = [ current_collection ] + @documents.collections
+    collections = [ current_collection ] + @documents.collections.to_a
     collections = collections.compact.map(&:to_s).uniq.sort
     collections.unshift('[EXIT]').unshift('[NEW]')
     collection = OllamaChat::Utils::Chooser.choose(collections) || current_collection

data/lib/ollama_chat/follow_chat.rb

@@ -11,6 +11,7 @@ class OllamaChat::FollowChat
   include Ollama::Handlers::Concern
   include Term::ANSIColor
   include OllamaChat::MessageFormat
+  include OllamaChat::Utils::ValueFormatter
 
   # Initializes a new instance of OllamaChat::FollowChat.
   #
@@ -100,6 +101,12 @@ class OllamaChat::FollowChat
 
     response.message.tool_calls.each do |tool_call|
       name = tool_call.function.name
+      if name =~ %r(/)
+        new_name = File.basename(name.to_s)
+        msg = "Received namespaced tool call for #{name}, correcting to #{new_name}"
+        @chat.log(:warn, msg)
+        name = new_name
+      end
       unless @chat.tool_configured?(name)
         msg = "Error: Unconfigured tool named %s ignored => Skip.\n" % name
         @chat.tool_call_results[name] = msg
@@ -125,9 +132,10 @@ class OllamaChat::FollowChat
       if @chat.tool_function(name).require_confirmation?
         prompt = "🔔 I want to execute tool %s\n%s\nConfirm? (y/n) " % [
           bold { name },
-          italic { function  },
+          italic { function },
         ]
-        if @chat.confirm?(prompt:) =~ /y/i
+        prompt.gsub!('%', '%%')
+        if @chat.confirm?(prompt:, yes: /y/i)
           confirmed = :explicit
         else
           confirmed = :denied
@@ -147,7 +155,7 @@ class OllamaChat::FollowChat
           resolve: 'You **MUST** ask the user for instructions on how to proceed!!!',
         )
         STDOUT.printf(
-          "\n%s Execution of tool %s denied by user.\n", ?🚫, bold { name }
+          "\n%s Execution of tool %s denied by user.\n\n", ?🚫, bold { name }
         )
         @chat.log(:warn,"Execution of tool %s was denied by user!" % name)
       else
@@ -163,24 +171,46 @@ class OllamaChat::FollowChat
           @chat.log(:info, "Execution of tool %s was implicitly confirmed." % name)
         end
       end
-      begin
-        data = JSON.parse(result)
-        @chat.log(:info, JSON.pretty_generate(data))
-      rescue
-        @chat.log(:info, result)
-      end
+
       @chat.tool_call_results[name] = result
+
+      data    = nil
+      message = begin
+                   data = JSON.parse(result)
+                   @chat.log(:info, JSON.pretty_generate(data))
+                   data['message']
+                 rescue
+                   @chat.log(:info, result)
+                   nil
+                 end
+      warn =
+        begin
+          !!data.ask_and_send(:[], 'error') || data.ask_and_send(:[], 'success')
+        rescue
+          false
+        end
+
       tools_used[name] = {
-        'size'     => Tins::Unit.format(result.to_s.size, unit: ?B, prefix: 1024, format: '%.1f %U'),
-        'duration' => Tins::Duration.new(Time.now - start).to_s,
+        message:,
+        warn:     ,
+        size:     format_bytes(result.to_s.size),
+        duration: Tins::Duration.new(Time.now - start).to_s,
       }
     end
 
     if tools_used.full?
       infobar.reset
-      puts "🔧 Tool functions returned result:",
-        tools_used.to_yaml.sub(/\A---\s*\n/, '').gsub(/^/, '  '), ""
-      @chat.confirm?(prompt: '⏎  Press any key to continue. ')
+      tools_used.each do |name, info|
+        feedback_message = if info[:message]
+                             "\n%s %s\n\n" % [ info[:warn] ? '⚠️' : '💡', info[:message] ]
+                           end
+        puts <<~EOT.strip, ""
+          🔧 Tool functions #{name} returned result (#{info[:size]} in #{info[:duration]}).
+          #{feedback_message}
+        EOT
+        timeout = @chat.tool_function(name).result_display_timeout?
+        @chat.confirm?(prompt: '⏎  Press any key to continue (%s). ', timeout:)
+      end
     end
   end
 
@@ -295,7 +325,7 @@ class OllamaChat::FollowChat
   #
   # This method delegates to the messages object's show_last method, which
   # displays the most recent non-user message in the conversation history.
-  # It is typically used to provide feedback to the user about the last
+  # It is typically used to provide message to the user about the last
   # response from the assistant.
   # @return [ nil, String ] the pager command or nil if no paging was
   #   performed.

data/lib/ollama_chat/message_output.rb

@@ -3,7 +3,7 @@
 # This module encapsulates methods for piping assistant responses to command
 # standard input and writing assistant responses to files. It handles the
 # mechanics of sending output to external processes or saving content to disk
-# while providing appropriate error handling and user feedback.
+# while providing appropriate error handling and user message.
 #
 # @example Piping a response to a command
 #   chat.pipe('cat > output.txt')
@@ -83,7 +83,7 @@ module OllamaChat::MessageOutput
   def attempt_to_write_file(filename, message)
     path = Pathname.new(filename.to_s).expand_path
     if !path.exist? ||
-        confirm?(prompt: "🔔 File #{path.to_s.inspect} already exists, overwrite? (y/n) ") =~ /y/i
+        confirm?(prompt: "🔔 File #{path.to_s.inspect} already exists, overwrite? (y/n) ", yes: /y/i)
     then
       File.open(path, ?w) do |output|
         output.write(message.content)

data/lib/ollama_chat/model_handling.rb

@@ -95,7 +95,7 @@ module OllamaChat::ModelHandling
   #                     that combines the model name and formatted size
   private def model_with_size(model)
     formatted_size = Term::ANSIColor.bold {
-      Tins::Unit.format(model.size, unit: ?B, prefix: 1024, format: '%.1f %U')
+      format_bytes(model.size)
     }
     SearchUI::Wrapper.new(model.name, display: "#{model.name} #{formatted_size}")
   end

data/lib/ollama_chat/ollama_chat_config/default_config.yml

@@ -156,34 +156,43 @@ tools:
   enabled: true
   functions:
     get_current_weather:
+      result_display_timeout: 3
       url: "https://api.pirateweather.net/forecast/KeyInHeader/%{lat},%{lon}?units=%{units}"
       default: false
     get_cve:
+      result_display_timeout: 3
       url: 'https://cveawg.mitre.org/api/cve/%{cve_id}'
       default: true
     get_endoflife:
+      result_display_timeout: 3
       url: "https://endoflife.date/api/v1/products/%{product}"
       default: false
     get_time:
+      result_display_timeout: 3
       default: true
     get_location:
+      result_display_timeout: 3
       default: true
     file_context:
       default: false
       require_confirmation: false
+      result_display_timeout: 3
       allowed:
         - './spec'
     directory_structure:
       default: true
       require_confirmation: false
+      result_display_timeout: 3
       exclude:
         - corpus
         - pkg
     execute_grep:
       default: true
+      result_display_timeout: 3
       cmd: |
         grep #{'-i' if ignore_case} -m #{max_results} -r #{before.full? { "-B %u " % it }}#{after.full? { "-A %u " % it }}#{context.full? { "-C %u " % it }}#{pattern} #{path}
     browse:
+      result_display_timeout: 3
       default: true
     write_file:
       default: true
@@ -193,6 +202,7 @@ tools:
     read_file:
       default: true
       require_confirmation: false
+      result_display_timeout: 3
       allowed:
         - './tmp'
         - './lib'
@@ -200,45 +210,59 @@ tools:
     search_web:
       default: true
       require_confirmation: true
+      result_display_timeout: 3
       max_results: 25
     get_url:
       default: true
       require_confirmation: true
+      result_display_timeout: 3
       schemes:
         - http
         - https
     gem_path_lookup:
+      result_display_timeout: 3
       default: true
     open_file_in_editor:
       default: true
       require_confirmation: true
+      result_display_timeout: 0
     run_tests:
       require_confirmation: true
+      result_display_timeout: 3
       default: true
       allowed:
         - "./spec"
         - "./test"
         - "./tests"
     get_jira_issue:
+      result_display_timeout: 3
       default: false
     get_rfc:
       url: "https://www.rfc-editor.org/rfc/rfc%{rfc_id}.txt"
+      result_display_timeout: 3
       default: true
     generate_password:
       default: true
     copy_to_clipboard:
+      result_display_timeout: 3
       default: true
     paste_from_clipboard:
+      result_display_timeout: 3
       default: true
     paste_into_editor:
+      result_display_timeout: 3
       require_confirmation: true
       default: true
     execute_ri:
+      result_display_timeout: 3
       default: true
     resolve_tag:
+      result_display_timeout: 3
       default: true
     patch_file:
       default: true
       require_confirmation: true
       allowed:
         - './tmp'
+    retrieve_document_snippets:
+      default: true

data/lib/ollama_chat/personae_management.rb

@@ -173,9 +173,9 @@ module OllamaChat::PersonaeManagement
         STDOUT.puts "Deleting '#{bold{persona.sub_ext('')}}'..."
         STDOUT.puts "Backup will be saved to: #{backup_pathname}"
 
-        if confirm?(prompt: "🔔 Are you sure? (y/n) ") =~ /y/i
+        if confirm?(prompt: "🔔 Are you sure? (y/n) ", yes: /y/i)
           FileUtils.mv pathname, backup_pathname
-          STDOUT.puts "✅ Persona #{bold{persona.sub_ext('')}} deleted successfully"
+          STDOUT.puts "Persona #{bold{persona.sub_ext('')}} deleted successfully"
           {
             success: true,
             persona: persona.sub_ext(''),

data/lib/ollama_chat/server_socket.rb

@@ -117,7 +117,7 @@ module OllamaChat::ServerSocket
       running using the same directory or that a previous process left a stale
       socket file.
     EOT
-    if confirm?(prompt: '🔔 Do you want to remove the existing socket file and continue? (y/n) ') =~ /y/i
+    if confirm?(prompt: '🔔 Do you want to remove the existing socket file and continue? (y/n) ', yes: /y/i)
       FileUtils.rm_f socket_path
       retry
     else

data/lib/ollama_chat/switches.rb

@@ -51,7 +51,7 @@ module OllamaChat::Switches
   #
   # The Switch class provides a simple way to manage boolean configuration
   # options with methods to toggle, set, and query the current state. It
-  # includes messaging capabilities to provide feedback when the state changes.
+  # includes messaging capabilities to provide message when the state changes.
   #
   # @example Creating and using a switch
   #   switch = Switch.new(value: false, msg: { true => 'Enabled', false => 'Disabled' })

data/lib/ollama_chat/tools/browse.rb

@@ -26,9 +26,9 @@ class OllamaChat::Tools::Browse
       function: Tool::Function.new(
         name:,
         description: <<~EOT,
-          Launch external viewer – Opens an HTTP/HTTPS link (or local file) in
-          the system’s web/browser app. Use when you want to hand off a page
-          for human inspection; no return value is expected.
+          Launch external viewer – Opens an HTTP/HTTPS link (or local file
+          path) in the system’s web/browser app. Use when you want to hand off
+          a page for human inspection; no return value is expected.
         EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
@@ -58,10 +58,17 @@ class OllamaChat::Tools::Browse
   def execute(tool_call, **opts)
     url    = tool_call.function.arguments.url
     result = browse_url(url)
+
+    message = if result.success?
+                 "Opened #{url.to_s.inspect} in browser."
+               else
+                 "Could not open #{url.to_s.inspect} in browser."
+               end
+
     {
       success:    result.success?,
       exitstatus: result.exitstatus,
-      message:    'opening URL/file',
+      message:   ,
       url:        ,
     }.to_json
   rescue => e

data/lib/ollama_chat/tools/concern.rb

@@ -6,6 +6,7 @@
 # functionality to integrate tools into the chat system's tool registry.
 module OllamaChat::Tools::Concern
   extend Tins::Concern
+  include OllamaChat::Utils::ValueFormatter
 
   included do
     include Ollama

data/lib/ollama_chat/tools/copy_to_clipboard.rb

@@ -56,8 +56,8 @@ class OllamaChat::Tools::CopyToClipboard
                 "The provided text has been successfully copied to the system clipboard."
               end
     {
-      success: true,
-      message:,
+      success:  true,
+      message: ,
     }.to_json
   rescue => e
     {

data/lib/ollama_chat/tools/open_file_in_editor.rb

@@ -73,15 +73,16 @@ class OllamaChat::Tools::OpenFileInEditor
     end
 
     chat.vim.open_file(file_path, start_line, end_line)
-    if end_line
-      result_msg = "Opened #{file_path} and selected range #{start_line}-#{end_line}"
-    else
-      result_msg = "Opened #{file_path} at line #{start_line}"
-    end
+    message =
+      if end_line
+        "Opened #{file_path.to_s.inspect} and selected range #{start_line}-#{end_line}"
+      else
+        "Opened #{file_path.to_s.inspect} at line #{start_line}"
+      end
 
     {
       success:    true,
-      message:    result_msg,
+      message:   ,
       path:       file_path,
       start_line: start_line,
       end_line:   end_line,

data/lib/ollama_chat/tools/paste_from_clipboard.rb

@@ -43,10 +43,11 @@ class OllamaChat::Tools::PasteFromClipboard
 
     # Use the chat instance's clipboard paste functionality
     content = chat.perform_paste_from_clipboard
+    message = "Pasted #{format_bytes(content.to_s.size)} of content."
 
     {
-      success: true,
-      message: "Content pasted from clipboard",
+      success:  true,
+      message: ,
       content:
     }.to_json
   rescue => e

data/lib/ollama_chat/tools/paste_into_editor.rb

@@ -53,7 +53,7 @@ class OllamaChat::Tools::PasteIntoEditor
       end
 
     {
-      success: true,
+      success:  true,
       message: ,
     }.to_json
   rescue => e

data/lib/ollama_chat/tools/patch_file.rb

@@ -68,9 +68,11 @@ class OllamaChat::Tools::PatchFile
     path = assert_valid_path(path, config.tools.functions.patch_file.allowed?, check_file: true)
 
     result = apply_patch(path, diff_content)
-    message = result[:success] ?
-      "Successfully applied patch to #{path.to_s.inspect}." :
-      "Failed to apply patch to file #{path.to_s.inspect}."
+    message = if result[:success]
+                 "Successfully applied patch to #{path.to_s.inspect}."
+               else
+                 "Failed to apply patch to file #{path.to_s.inspect}."
+               end
     (result | {
       path:    path.to_s,
       message: ,

data/lib/ollama_chat/tools/resolve_tag.rb

@@ -67,11 +67,16 @@ class OllamaChat::Tools::ResolveTag
     results = OllamaChat::Utils::TagResolver.new(tags).
       resolve(symbol:, kind:, directory:)
 
+    message = "Found %{results_count} results of symbol \"%{symbol}\"." % {
+      results_count: results.size, symbol:
+    }
+
     {
-      symbol:,
-      kind:,
+      message: ,
+      symbol:   ,
+      kind:     ,
       directory:,
-      results:
+      results:  ,
     }.to_json
   rescue => e
     { error: e.class.to_s, message: e.message }.to_json

data/lib/ollama_chat/tools/retrieve_document_snippets.rb

@@ -0,0 +1,118 @@
+# Collect snippets relevant to the supplied query.
+#
+# This tool searches the local document collection for text that matches the
+# supplied query.  It is used by the chat backend to provide an
+# "in‑context" snippet set that the model can reference when answering user
+# questions.  The tool performs three steps:
+#
+# 1. **Validate** the request – the model must be running with embeddings
+#    enabled and the query cannot be empty.
+# 2. **Search** – it uses `chat.documents.find_where` to locate snippets that
+#    contain the query string (trimmed to the embedding model’s context length)
+#    and collect tags from the snippet text.
+# 3. **Return** – a JSON string containing a friendly prompt header and an
+#    array of `{text, tags}` objects.  Each tag includes `name` and the
+#    originating `source`.
+#
+# @note The tool is deliberately read‑only; it never mutates the chat or
+#   the underlying document store.
+class OllamaChat::Tools::RetrieveDocumentSnippets
+  include OllamaChat::Tools::Concern
+
+  # @return [String] the registered name for this tool
+  def self.register_name = 'retrieve_document_snippets'
+
+  # Function‑definition that the chat system exposes to the model.
+  # It follows the same pattern as other tools in the project.
+  #
+  # @return [Ollama::Tool] the tool definition usable by the Ollama
+  #   server
+  def tool
+    Tool.new(
+      type: 'function',
+      function: Tool::Function.new(
+        name:,
+        description: <<~EOT,
+          Return document snippets from the current collection of documents
+          that match the supplied query. The result is a JSON string containing
+          a prompt header and an array of {text, tags} objects.
+        EOT
+        parameters: Tool::Function::Parameters.new(
+          type: 'object',
+          properties: {
+            query: Tool::Function::Parameters::Property.new(
+              type: 'string',
+              description: 'The query or text to search for in the document collection.'
+            )
+          },
+          required: ['query']
+        )
+      )
+    )
+  end
+
+  # Called when the model invokes the tool.
+  #
+  # @param tool_call [OllamaChat::Tool::Call] the tool call object
+  # @param opts [Hash] additional options, usually containing the chat
+  # @return [String] JSON string with the resulting snippets, or an error
+  # @raise [OllamaChat::OllamaChatError] if embeddings are disabled or query
+  #   is empty
+  def execute(tool_call, **opts)
+    chat = opts[:chat]
+
+    chat.embedding.on? or raise OllamaChat::OllamaChatError, 'Embedding disabled'
+
+    query = tool_call.function.arguments.query.to_s
+
+    query.blank? and raise OllamaChat::OllamaChatError, 'Empty query'
+
+
+    records = find_document_records(chat, query)
+
+    message = records.map { |record|
+      link = if record.source =~ %r(\Ahttps?://)
+               record.source
+             else
+               'file://%s' % File.expand_path(record.source)
+             end
+      [ link, ?# + record.tags.first ]
+    }.uniq.map { |l, t| chat.hyperlink(l, t) }.join(' ')
+
+    {
+      prompt: 'Consider these snippets generated from retrieval when formulating your response!',
+      ollama_chat_retrieval_snippets: records.map do |record|
+        {
+          text: record.text,
+          tags: record.tags_set.map { |t| { name: t.to_s(link: false), source: t.source }.compact }
+        }
+      end,
+      message:,
+    }.to_json
+  rescue => e
+    { error: e.class.name, message: e.message }.to_json
+  end
+
+  private
+
+  # The find_document_records method searches for document records matching the
+  # given query string.
+  #
+  # @param query [String] the search query string
+  #
+  # @return [Array<Documentrix::Utils::TagResult>] an array of found document
+  #   records
+  def find_document_records(chat, query)
+    tags = Documentrix::Utils::Tags.new(valid_tag: /\A#*([\w\]\[]+)/)
+
+    chat.documents.find_where(
+      query.downcase.first(chat.config.embedding.model.context_length),
+      tags:,
+      prompt: chat.config.embedding.model.prompt?,
+      text_size: chat.config.embedding.found_texts_size?,
+      text_count: chat.config.embedding.found_texts_count?
+    )
+  end
+
+  self
+end.register

data/lib/ollama_chat/tools/search_web.rb

@@ -62,12 +62,19 @@ class OllamaChat::Tools::SearchWeb
     config = chat.config
     args   = tool_call.function.arguments
 
-    query = args.query
+    query       = args.query
     max_results = config.tools.functions.search_web?.max_results? || 10
     num_results = (args.num_results || 5).clamp(..max_results)
+    results     = chat.search_web(query, num_results)
+
+    message = "Searched the web with query %{query} "\
+      "which returned %{results_count} results." % {
+        query: query.inspect, results_count: results.size
+      }
+
     {
-      query: ,
-      url:   chat.search_web(query, num_results)
+      message:,
+      results:,
     }.to_json
   rescue => e
     {

data/lib/ollama_chat/tools/write_file.rb

@@ -84,10 +84,17 @@ class OllamaChat::Tools::WriteFile
       raise ArgumentError, 'Invalid mode %s' % args.mode.inspect
     end
 
+    bytes_written = format_bytes(bytes_written)
+    path          = target_path.to_s.inspect
+
+    message = <<~EOT % { bytes_written:, path: }
+      Wrote %{bytes_written} to file %{path}.
+    EOT
+
     {
-      success:         true,
-      path:            target_path.to_s,
-      bytes_written:   ,
+      success: true,
+      path:    ,
+      message:,
     }.to_json
   rescue => e
     {

data/lib/ollama_chat/tools.rb

@@ -62,6 +62,7 @@ require 'ollama_chat/tools/paste_into_editor'
 require 'ollama_chat/tools/patch_file'
 require 'ollama_chat/tools/read_file'
 require 'ollama_chat/tools/resolve_tag'
+require 'ollama_chat/tools/retrieve_document_snippets'
 require 'ollama_chat/tools/run_tests'
 require 'ollama_chat/tools/search_web'
 require 'ollama_chat/tools/write_file'

data/lib/ollama_chat/utils/value_formatter.rb

@@ -0,0 +1,10 @@
+# Module to format values for user consumption.
+module OllamaChat::Utils::ValueFormatter
+  # Formats a byte value into a human‑readable string with units
+  #
+  # @param bytes [Integer] the number of bytes to format
+  # @return [String] the formatted byte string
+  def format_bytes(bytes)
+    Tins::Unit.format(bytes, unit: ?B, prefix: 1024, format: '%.1f %U')
+  end
+end

data/lib/ollama_chat/utils.rb

@@ -9,11 +9,12 @@
 module OllamaChat::Utils
 end
 
+require 'ollama_chat/utils/analyze_directory'
 require 'ollama_chat/utils/cache_fetcher'
 require 'ollama_chat/utils/chooser'
 require 'ollama_chat/utils/fetcher'
 require 'ollama_chat/utils/file_argument'
-require 'ollama_chat/utils/analyze_directory'
+require 'ollama_chat/utils/path_completer'
 require 'ollama_chat/utils/path_validator'
 require 'ollama_chat/utils/tag_resolver'
-require 'ollama_chat/utils/path_completer'
+require 'ollama_chat/utils/value_formatter'

data/lib/ollama_chat/version.rb

@@ -1,6 +1,6 @@
 module OllamaChat
   # OllamaChat version
-  VERSION         = '0.0.82'
+  VERSION         = '0.0.84'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/ollama_chat.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: ollama_chat 0.0.82 ruby lib
+# stub: ollama_chat 0.0.84 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "ollama_chat".freeze
-  s.version = "0.0.82".freeze
+  s.version = "0.0.84".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -12,15 +12,15 @@ Gem::Specification.new do |s|
   s.description = "The app provides a command-line interface (CLI) to an Ollama AI model,\nallowing users to engage in text-based conversations and generate\nhuman-like responses. Users can import data from local files or web pages,\nwhich are then processed through three different modes: fully importing the\ncontent into the conversation context, summarizing the information for\nconcise reference, or storing it in an embedding vector database for later\nretrieval based on the conversation.\n".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["ollama_chat".freeze, "ollama_chat_send".freeze]
-  s.extra_rdoc_files = ["README.md".freeze, "lib/ollama_chat.rb".freeze, "lib/ollama_chat/chat.rb".freeze, "lib/ollama_chat/clipboard.rb".freeze, "lib/ollama_chat/command_concern.rb".freeze, "lib/ollama_chat/config_handling.rb".freeze, "lib/ollama_chat/conversation.rb".freeze, "lib/ollama_chat/dialog.rb".freeze, "lib/ollama_chat/document_cache.rb".freeze, "lib/ollama_chat/file_editing.rb".freeze, "lib/ollama_chat/follow_chat.rb".freeze, "lib/ollama_chat/history.rb".freeze, "lib/ollama_chat/http_handling.rb".freeze, "lib/ollama_chat/information.rb".freeze, "lib/ollama_chat/input_content.rb".freeze, "lib/ollama_chat/kramdown_ansi.rb".freeze, "lib/ollama_chat/location_handling.rb".freeze, "lib/ollama_chat/logging.rb".freeze, "lib/ollama_chat/message_editing.rb".freeze, "lib/ollama_chat/message_format.rb".freeze, "lib/ollama_chat/message_list.rb".freeze, "lib/ollama_chat/message_output.rb".freeze, "lib/ollama_chat/model_handling.rb".freeze, "lib/ollama_chat/oc.rb".freeze, "lib/ollama_chat/ollama_chat_config.rb".freeze, "lib/ollama_chat/pager.rb".freeze, "lib/ollama_chat/parsing.rb".freeze, "lib/ollama_chat/personae_management.rb".freeze, "lib/ollama_chat/redis_cache.rb".freeze, "lib/ollama_chat/server_socket.rb".freeze, "lib/ollama_chat/source_fetching.rb".freeze, "lib/ollama_chat/state_selectors.rb".freeze, "lib/ollama_chat/switches.rb".freeze, "lib/ollama_chat/think_control.rb".freeze, "lib/ollama_chat/tool_calling.rb".freeze, "lib/ollama_chat/tools.rb".freeze, "lib/ollama_chat/tools/browse.rb".freeze, "lib/ollama_chat/tools/concern.rb".freeze, "lib/ollama_chat/tools/copy_to_clipboard.rb".freeze, "lib/ollama_chat/tools/directory_structure.rb".freeze, "lib/ollama_chat/tools/execute_grep.rb".freeze, "lib/ollama_chat/tools/execute_ri.rb".freeze, "lib/ollama_chat/tools/file_context.rb".freeze, "lib/ollama_chat/tools/gem_path_lookup.rb".freeze, "lib/ollama_chat/tools/generate_password.rb".freeze, "lib/ollama_chat/tools/get_current_weather.rb".freeze, "lib/ollama_chat/tools/get_cve.rb".freeze, "lib/ollama_chat/tools/get_endoflife.rb".freeze, "lib/ollama_chat/tools/get_jira_issue.rb".freeze, "lib/ollama_chat/tools/get_location.rb".freeze, "lib/ollama_chat/tools/get_rfc.rb".freeze, "lib/ollama_chat/tools/get_time.rb".freeze, "lib/ollama_chat/tools/get_url.rb".freeze, "lib/ollama_chat/tools/open_file_in_editor.rb".freeze, "lib/ollama_chat/tools/paste_from_clipboard.rb".freeze, "lib/ollama_chat/tools/paste_into_editor.rb".freeze, "lib/ollama_chat/tools/patch_file.rb".freeze, "lib/ollama_chat/tools/read_file.rb".freeze, "lib/ollama_chat/tools/resolve_tag.rb".freeze, "lib/ollama_chat/tools/run_tests.rb".freeze, "lib/ollama_chat/tools/search_web.rb".freeze, "lib/ollama_chat/tools/write_file.rb".freeze, "lib/ollama_chat/utils.rb".freeze, "lib/ollama_chat/utils/analyze_directory.rb".freeze, "lib/ollama_chat/utils/cache_fetcher.rb".freeze, "lib/ollama_chat/utils/chooser.rb".freeze, "lib/ollama_chat/utils/fetcher.rb".freeze, "lib/ollama_chat/utils/file_argument.rb".freeze, "lib/ollama_chat/utils/path_completer.rb".freeze, "lib/ollama_chat/utils/path_validator.rb".freeze, "lib/ollama_chat/utils/tag_resolver.rb".freeze, "lib/ollama_chat/version.rb".freeze, "lib/ollama_chat/vim.rb".freeze, "lib/ollama_chat/web_searching.rb".freeze]
-  s.files = [".utilsrc".freeze, "CHANGES.md".freeze, "Gemfile".freeze, "README.md".freeze, "Rakefile".freeze, "bin/ollama_chat".freeze, "bin/ollama_chat_send".freeze, "config/searxng/settings.yml".freeze, "docker-compose.yml".freeze, "lib/ollama_chat.rb".freeze, "lib/ollama_chat/chat.rb".freeze, "lib/ollama_chat/clipboard.rb".freeze, "lib/ollama_chat/command_concern.rb".freeze, "lib/ollama_chat/config_handling.rb".freeze, "lib/ollama_chat/conversation.rb".freeze, "lib/ollama_chat/dialog.rb".freeze, "lib/ollama_chat/document_cache.rb".freeze, "lib/ollama_chat/file_editing.rb".freeze, "lib/ollama_chat/follow_chat.rb".freeze, "lib/ollama_chat/history.rb".freeze, "lib/ollama_chat/http_handling.rb".freeze, "lib/ollama_chat/information.rb".freeze, "lib/ollama_chat/input_content.rb".freeze, "lib/ollama_chat/kramdown_ansi.rb".freeze, "lib/ollama_chat/location_handling.rb".freeze, "lib/ollama_chat/logging.rb".freeze, "lib/ollama_chat/message_editing.rb".freeze, "lib/ollama_chat/message_format.rb".freeze, "lib/ollama_chat/message_list.rb".freeze, "lib/ollama_chat/message_output.rb".freeze, "lib/ollama_chat/model_handling.rb".freeze, "lib/ollama_chat/oc.rb".freeze, "lib/ollama_chat/ollama_chat_config.rb".freeze, "lib/ollama_chat/ollama_chat_config/default_config.yml".freeze, "lib/ollama_chat/pager.rb".freeze, "lib/ollama_chat/parsing.rb".freeze, "lib/ollama_chat/personae_management.rb".freeze, "lib/ollama_chat/redis_cache.rb".freeze, "lib/ollama_chat/server_socket.rb".freeze, "lib/ollama_chat/source_fetching.rb".freeze, "lib/ollama_chat/state_selectors.rb".freeze, "lib/ollama_chat/switches.rb".freeze, "lib/ollama_chat/think_control.rb".freeze, "lib/ollama_chat/tool_calling.rb".freeze, "lib/ollama_chat/tools.rb".freeze, "lib/ollama_chat/tools/browse.rb".freeze, "lib/ollama_chat/tools/concern.rb".freeze, "lib/ollama_chat/tools/copy_to_clipboard.rb".freeze, "lib/ollama_chat/tools/directory_structure.rb".freeze, "lib/ollama_chat/tools/execute_grep.rb".freeze, "lib/ollama_chat/tools/execute_ri.rb".freeze, "lib/ollama_chat/tools/file_context.rb".freeze, "lib/ollama_chat/tools/gem_path_lookup.rb".freeze, "lib/ollama_chat/tools/generate_password.rb".freeze, "lib/ollama_chat/tools/get_current_weather.rb".freeze, "lib/ollama_chat/tools/get_cve.rb".freeze, "lib/ollama_chat/tools/get_endoflife.rb".freeze, "lib/ollama_chat/tools/get_jira_issue.rb".freeze, "lib/ollama_chat/tools/get_location.rb".freeze, "lib/ollama_chat/tools/get_rfc.rb".freeze, "lib/ollama_chat/tools/get_time.rb".freeze, "lib/ollama_chat/tools/get_url.rb".freeze, "lib/ollama_chat/tools/open_file_in_editor.rb".freeze, "lib/ollama_chat/tools/paste_from_clipboard.rb".freeze, "lib/ollama_chat/tools/paste_into_editor.rb".freeze, "lib/ollama_chat/tools/patch_file.rb".freeze, "lib/ollama_chat/tools/read_file.rb".freeze, "lib/ollama_chat/tools/resolve_tag.rb".freeze, "lib/ollama_chat/tools/run_tests.rb".freeze, "lib/ollama_chat/tools/search_web.rb".freeze, "lib/ollama_chat/tools/write_file.rb".freeze, "lib/ollama_chat/utils.rb".freeze, "lib/ollama_chat/utils/analyze_directory.rb".freeze, "lib/ollama_chat/utils/cache_fetcher.rb".freeze, "lib/ollama_chat/utils/chooser.rb".freeze, "lib/ollama_chat/utils/fetcher.rb".freeze, "lib/ollama_chat/utils/file_argument.rb".freeze, "lib/ollama_chat/utils/path_completer.rb".freeze, "lib/ollama_chat/utils/path_validator.rb".freeze, "lib/ollama_chat/utils/tag_resolver.rb".freeze, "lib/ollama_chat/version.rb".freeze, "lib/ollama_chat/vim.rb".freeze, "lib/ollama_chat/web_searching.rb".freeze, "ollama_chat.gemspec".freeze, "redis/redis.conf".freeze, "spec/assets/api_show.json".freeze, "spec/assets/api_tags.json".freeze, "spec/assets/api_version.json".freeze, "spec/assets/conversation.json".freeze, "spec/assets/deep/deeper/empty.txt".freeze, "spec/assets/deep/deeper/not-empty.txt".freeze, "spec/assets/deep/empty.txt".freeze, "spec/assets/duckduckgo.html".freeze, "spec/assets/example.atom".freeze, "spec/assets/example.csv".freeze, "spec/assets/example.html".freeze, "spec/assets/example.pdf".freeze, "spec/assets/example.ps".freeze, "spec/assets/example.rb".freeze, "spec/assets/example.rss".freeze, "spec/assets/example.xml".freeze, "spec/assets/example_with_quote.html".freeze, "spec/assets/kitten.jpg".freeze, "spec/assets/pirateweather.json".freeze, "spec/assets/prompt.txt".freeze, "spec/assets/searxng.json".freeze, "spec/ollama_chat/chat_spec.rb".freeze, "spec/ollama_chat/clipboard_spec.rb".freeze, "spec/ollama_chat/follow_chat_spec.rb".freeze, "spec/ollama_chat/information_spec.rb".freeze, "spec/ollama_chat/input_content_spec.rb".freeze, "spec/ollama_chat/kramdown_ansi_spec.rb".freeze, "spec/ollama_chat/message_editing_spec.rb".freeze, "spec/ollama_chat/message_list_spec.rb".freeze, "spec/ollama_chat/message_output_spec.rb".freeze, "spec/ollama_chat/model_handling_spec.rb".freeze, "spec/ollama_chat/parsing_spec.rb".freeze, "spec/ollama_chat/redis_cache_spec.rb".freeze, "spec/ollama_chat/server_socket_spec.rb".freeze, "spec/ollama_chat/source_fetching_spec.rb".freeze, "spec/ollama_chat/state_selectors_spec.rb".freeze, "spec/ollama_chat/switches_spec.rb".freeze, "spec/ollama_chat/think_control_spec.rb".freeze, "spec/ollama_chat/tools/browse_spec.rb".freeze, "spec/ollama_chat/tools/copy_to_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/directory_structure_spec.rb".freeze, "spec/ollama_chat/tools/execute_grep_spec.rb".freeze, "spec/ollama_chat/tools/execute_ri_spec.rb".freeze, "spec/ollama_chat/tools/file_context_spec.rb".freeze, "spec/ollama_chat/tools/gem_path_lookup_spec.rb".freeze, "spec/ollama_chat/tools/generate_password_spec.rb".freeze, "spec/ollama_chat/tools/get_current_weather_spec.rb".freeze, "spec/ollama_chat/tools/get_cve_spec.rb".freeze, "spec/ollama_chat/tools/get_endoflife_spec.rb".freeze, "spec/ollama_chat/tools/get_jira_issue_spec.rb".freeze, "spec/ollama_chat/tools/get_location_spec.rb".freeze, "spec/ollama_chat/tools/get_rfc_spec.rb".freeze, "spec/ollama_chat/tools/get_time_spec.rb".freeze, "spec/ollama_chat/tools/get_url_spec.rb".freeze, "spec/ollama_chat/tools/open_file_in_editor_spec.rb".freeze, "spec/ollama_chat/tools/paste_from_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/paste_into_editor_spec.rb".freeze, "spec/ollama_chat/tools/patch_file_spec.rb".freeze, "spec/ollama_chat/tools/read_file_spec.rb".freeze, "spec/ollama_chat/tools/resolve_tag_spec.rb".freeze, "spec/ollama_chat/tools/run_tests_spec.rb".freeze, "spec/ollama_chat/tools/search_web_spec.rb".freeze, "spec/ollama_chat/tools/write_file_spec.rb".freeze, "spec/ollama_chat/utils/analyze_directory_spec.rb".freeze, "spec/ollama_chat/utils/cache_fetcher_spec.rb".freeze, "spec/ollama_chat/utils/fetcher_spec.rb".freeze, "spec/ollama_chat/utils/file_argument_spec.rb".freeze, "spec/ollama_chat/utils/path_completer_spec.rb".freeze, "spec/ollama_chat/vim_spec.rb".freeze, "spec/ollama_chat/web_searching_spec.rb".freeze, "spec/spec_helper.rb".freeze, "tmp/.keep".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/ollama_chat.rb".freeze, "lib/ollama_chat/chat.rb".freeze, "lib/ollama_chat/clipboard.rb".freeze, "lib/ollama_chat/command_concern.rb".freeze, "lib/ollama_chat/config_handling.rb".freeze, "lib/ollama_chat/conversation.rb".freeze, "lib/ollama_chat/dialog.rb".freeze, "lib/ollama_chat/document_cache.rb".freeze, "lib/ollama_chat/file_editing.rb".freeze, "lib/ollama_chat/follow_chat.rb".freeze, "lib/ollama_chat/history.rb".freeze, "lib/ollama_chat/http_handling.rb".freeze, "lib/ollama_chat/information.rb".freeze, "lib/ollama_chat/input_content.rb".freeze, "lib/ollama_chat/kramdown_ansi.rb".freeze, "lib/ollama_chat/location_handling.rb".freeze, "lib/ollama_chat/logging.rb".freeze, "lib/ollama_chat/message_editing.rb".freeze, "lib/ollama_chat/message_format.rb".freeze, "lib/ollama_chat/message_list.rb".freeze, "lib/ollama_chat/message_output.rb".freeze, "lib/ollama_chat/model_handling.rb".freeze, "lib/ollama_chat/oc.rb".freeze, "lib/ollama_chat/ollama_chat_config.rb".freeze, "lib/ollama_chat/pager.rb".freeze, "lib/ollama_chat/parsing.rb".freeze, "lib/ollama_chat/personae_management.rb".freeze, "lib/ollama_chat/redis_cache.rb".freeze, "lib/ollama_chat/server_socket.rb".freeze, "lib/ollama_chat/source_fetching.rb".freeze, "lib/ollama_chat/state_selectors.rb".freeze, "lib/ollama_chat/switches.rb".freeze, "lib/ollama_chat/think_control.rb".freeze, "lib/ollama_chat/tool_calling.rb".freeze, "lib/ollama_chat/tools.rb".freeze, "lib/ollama_chat/tools/browse.rb".freeze, "lib/ollama_chat/tools/concern.rb".freeze, "lib/ollama_chat/tools/copy_to_clipboard.rb".freeze, "lib/ollama_chat/tools/directory_structure.rb".freeze, "lib/ollama_chat/tools/execute_grep.rb".freeze, "lib/ollama_chat/tools/execute_ri.rb".freeze, "lib/ollama_chat/tools/file_context.rb".freeze, "lib/ollama_chat/tools/gem_path_lookup.rb".freeze, "lib/ollama_chat/tools/generate_password.rb".freeze, "lib/ollama_chat/tools/get_current_weather.rb".freeze, "lib/ollama_chat/tools/get_cve.rb".freeze, "lib/ollama_chat/tools/get_endoflife.rb".freeze, "lib/ollama_chat/tools/get_jira_issue.rb".freeze, "lib/ollama_chat/tools/get_location.rb".freeze, "lib/ollama_chat/tools/get_rfc.rb".freeze, "lib/ollama_chat/tools/get_time.rb".freeze, "lib/ollama_chat/tools/get_url.rb".freeze, "lib/ollama_chat/tools/open_file_in_editor.rb".freeze, "lib/ollama_chat/tools/paste_from_clipboard.rb".freeze, "lib/ollama_chat/tools/paste_into_editor.rb".freeze, "lib/ollama_chat/tools/patch_file.rb".freeze, "lib/ollama_chat/tools/read_file.rb".freeze, "lib/ollama_chat/tools/resolve_tag.rb".freeze, "lib/ollama_chat/tools/retrieve_document_snippets.rb".freeze, "lib/ollama_chat/tools/run_tests.rb".freeze, "lib/ollama_chat/tools/search_web.rb".freeze, "lib/ollama_chat/tools/write_file.rb".freeze, "lib/ollama_chat/utils.rb".freeze, "lib/ollama_chat/utils/analyze_directory.rb".freeze, "lib/ollama_chat/utils/cache_fetcher.rb".freeze, "lib/ollama_chat/utils/chooser.rb".freeze, "lib/ollama_chat/utils/fetcher.rb".freeze, "lib/ollama_chat/utils/file_argument.rb".freeze, "lib/ollama_chat/utils/path_completer.rb".freeze, "lib/ollama_chat/utils/path_validator.rb".freeze, "lib/ollama_chat/utils/tag_resolver.rb".freeze, "lib/ollama_chat/utils/value_formatter.rb".freeze, "lib/ollama_chat/version.rb".freeze, "lib/ollama_chat/vim.rb".freeze, "lib/ollama_chat/web_searching.rb".freeze]
+  s.files = [".utilsrc".freeze, "CHANGES.md".freeze, "Gemfile".freeze, "README.md".freeze, "Rakefile".freeze, "bin/ollama_chat".freeze, "bin/ollama_chat_send".freeze, "config/searxng/settings.yml".freeze, "docker-compose.yml".freeze, "lib/ollama_chat.rb".freeze, "lib/ollama_chat/chat.rb".freeze, "lib/ollama_chat/clipboard.rb".freeze, "lib/ollama_chat/command_concern.rb".freeze, "lib/ollama_chat/config_handling.rb".freeze, "lib/ollama_chat/conversation.rb".freeze, "lib/ollama_chat/dialog.rb".freeze, "lib/ollama_chat/document_cache.rb".freeze, "lib/ollama_chat/file_editing.rb".freeze, "lib/ollama_chat/follow_chat.rb".freeze, "lib/ollama_chat/history.rb".freeze, "lib/ollama_chat/http_handling.rb".freeze, "lib/ollama_chat/information.rb".freeze, "lib/ollama_chat/input_content.rb".freeze, "lib/ollama_chat/kramdown_ansi.rb".freeze, "lib/ollama_chat/location_handling.rb".freeze, "lib/ollama_chat/logging.rb".freeze, "lib/ollama_chat/message_editing.rb".freeze, "lib/ollama_chat/message_format.rb".freeze, "lib/ollama_chat/message_list.rb".freeze, "lib/ollama_chat/message_output.rb".freeze, "lib/ollama_chat/model_handling.rb".freeze, "lib/ollama_chat/oc.rb".freeze, "lib/ollama_chat/ollama_chat_config.rb".freeze, "lib/ollama_chat/ollama_chat_config/default_config.yml".freeze, "lib/ollama_chat/pager.rb".freeze, "lib/ollama_chat/parsing.rb".freeze, "lib/ollama_chat/personae_management.rb".freeze, "lib/ollama_chat/redis_cache.rb".freeze, "lib/ollama_chat/server_socket.rb".freeze, "lib/ollama_chat/source_fetching.rb".freeze, "lib/ollama_chat/state_selectors.rb".freeze, "lib/ollama_chat/switches.rb".freeze, "lib/ollama_chat/think_control.rb".freeze, "lib/ollama_chat/tool_calling.rb".freeze, "lib/ollama_chat/tools.rb".freeze, "lib/ollama_chat/tools/browse.rb".freeze, "lib/ollama_chat/tools/concern.rb".freeze, "lib/ollama_chat/tools/copy_to_clipboard.rb".freeze, "lib/ollama_chat/tools/directory_structure.rb".freeze, "lib/ollama_chat/tools/execute_grep.rb".freeze, "lib/ollama_chat/tools/execute_ri.rb".freeze, "lib/ollama_chat/tools/file_context.rb".freeze, "lib/ollama_chat/tools/gem_path_lookup.rb".freeze, "lib/ollama_chat/tools/generate_password.rb".freeze, "lib/ollama_chat/tools/get_current_weather.rb".freeze, "lib/ollama_chat/tools/get_cve.rb".freeze, "lib/ollama_chat/tools/get_endoflife.rb".freeze, "lib/ollama_chat/tools/get_jira_issue.rb".freeze, "lib/ollama_chat/tools/get_location.rb".freeze, "lib/ollama_chat/tools/get_rfc.rb".freeze, "lib/ollama_chat/tools/get_time.rb".freeze, "lib/ollama_chat/tools/get_url.rb".freeze, "lib/ollama_chat/tools/open_file_in_editor.rb".freeze, "lib/ollama_chat/tools/paste_from_clipboard.rb".freeze, "lib/ollama_chat/tools/paste_into_editor.rb".freeze, "lib/ollama_chat/tools/patch_file.rb".freeze, "lib/ollama_chat/tools/read_file.rb".freeze, "lib/ollama_chat/tools/resolve_tag.rb".freeze, "lib/ollama_chat/tools/retrieve_document_snippets.rb".freeze, "lib/ollama_chat/tools/run_tests.rb".freeze, "lib/ollama_chat/tools/search_web.rb".freeze, "lib/ollama_chat/tools/write_file.rb".freeze, "lib/ollama_chat/utils.rb".freeze, "lib/ollama_chat/utils/analyze_directory.rb".freeze, "lib/ollama_chat/utils/cache_fetcher.rb".freeze, "lib/ollama_chat/utils/chooser.rb".freeze, "lib/ollama_chat/utils/fetcher.rb".freeze, "lib/ollama_chat/utils/file_argument.rb".freeze, "lib/ollama_chat/utils/path_completer.rb".freeze, "lib/ollama_chat/utils/path_validator.rb".freeze, "lib/ollama_chat/utils/tag_resolver.rb".freeze, "lib/ollama_chat/utils/value_formatter.rb".freeze, "lib/ollama_chat/version.rb".freeze, "lib/ollama_chat/vim.rb".freeze, "lib/ollama_chat/web_searching.rb".freeze, "ollama_chat.gemspec".freeze, "redis/redis.conf".freeze, "spec/assets/api_show.json".freeze, "spec/assets/api_tags.json".freeze, "spec/assets/api_version.json".freeze, "spec/assets/conversation.json".freeze, "spec/assets/deep/deeper/empty.txt".freeze, "spec/assets/deep/deeper/not-empty.txt".freeze, "spec/assets/deep/empty.txt".freeze, "spec/assets/duckduckgo.html".freeze, "spec/assets/example.atom".freeze, "spec/assets/example.csv".freeze, "spec/assets/example.html".freeze, "spec/assets/example.pdf".freeze, "spec/assets/example.ps".freeze, "spec/assets/example.rb".freeze, "spec/assets/example.rss".freeze, "spec/assets/example.xml".freeze, "spec/assets/example_with_quote.html".freeze, "spec/assets/kitten.jpg".freeze, "spec/assets/pirateweather.json".freeze, "spec/assets/prompt.txt".freeze, "spec/assets/searxng.json".freeze, "spec/ollama_chat/chat_spec.rb".freeze, "spec/ollama_chat/clipboard_spec.rb".freeze, "spec/ollama_chat/follow_chat_spec.rb".freeze, "spec/ollama_chat/information_spec.rb".freeze, "spec/ollama_chat/input_content_spec.rb".freeze, "spec/ollama_chat/kramdown_ansi_spec.rb".freeze, "spec/ollama_chat/message_editing_spec.rb".freeze, "spec/ollama_chat/message_list_spec.rb".freeze, "spec/ollama_chat/message_output_spec.rb".freeze, "spec/ollama_chat/model_handling_spec.rb".freeze, "spec/ollama_chat/parsing_spec.rb".freeze, "spec/ollama_chat/redis_cache_spec.rb".freeze, "spec/ollama_chat/server_socket_spec.rb".freeze, "spec/ollama_chat/source_fetching_spec.rb".freeze, "spec/ollama_chat/state_selectors_spec.rb".freeze, "spec/ollama_chat/switches_spec.rb".freeze, "spec/ollama_chat/think_control_spec.rb".freeze, "spec/ollama_chat/tools/browse_spec.rb".freeze, "spec/ollama_chat/tools/copy_to_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/directory_structure_spec.rb".freeze, "spec/ollama_chat/tools/execute_grep_spec.rb".freeze, "spec/ollama_chat/tools/execute_ri_spec.rb".freeze, "spec/ollama_chat/tools/file_context_spec.rb".freeze, "spec/ollama_chat/tools/gem_path_lookup_spec.rb".freeze, "spec/ollama_chat/tools/generate_password_spec.rb".freeze, "spec/ollama_chat/tools/get_current_weather_spec.rb".freeze, "spec/ollama_chat/tools/get_cve_spec.rb".freeze, "spec/ollama_chat/tools/get_endoflife_spec.rb".freeze, "spec/ollama_chat/tools/get_jira_issue_spec.rb".freeze, "spec/ollama_chat/tools/get_location_spec.rb".freeze, "spec/ollama_chat/tools/get_rfc_spec.rb".freeze, "spec/ollama_chat/tools/get_time_spec.rb".freeze, "spec/ollama_chat/tools/get_url_spec.rb".freeze, "spec/ollama_chat/tools/open_file_in_editor_spec.rb".freeze, "spec/ollama_chat/tools/paste_from_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/paste_into_editor_spec.rb".freeze, "spec/ollama_chat/tools/patch_file_spec.rb".freeze, "spec/ollama_chat/tools/read_file_spec.rb".freeze, "spec/ollama_chat/tools/resolve_tag_spec.rb".freeze, "spec/ollama_chat/tools/retrieve_document_snippets_spec.rb".freeze, "spec/ollama_chat/tools/run_tests_spec.rb".freeze, "spec/ollama_chat/tools/search_web_spec.rb".freeze, "spec/ollama_chat/tools/write_file_spec.rb".freeze, "spec/ollama_chat/utils/analyze_directory_spec.rb".freeze, "spec/ollama_chat/utils/cache_fetcher_spec.rb".freeze, "spec/ollama_chat/utils/fetcher_spec.rb".freeze, "spec/ollama_chat/utils/file_argument_spec.rb".freeze, "spec/ollama_chat/utils/path_completer_spec.rb".freeze, "spec/ollama_chat/vim_spec.rb".freeze, "spec/ollama_chat/web_searching_spec.rb".freeze, "spec/spec_helper.rb".freeze, "tmp/.keep".freeze]
   s.homepage = "https://github.com/flori/ollama_chat".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "OllamaChat - A command-line interface (CLI) for interacting with an Ollama AI model.".freeze, "--main".freeze, "README.md".freeze]
   s.required_ruby_version = Gem::Requirement.new(">= 3.2".freeze)
   s.rubygems_version = "4.0.8".freeze
   s.summary = "A command-line interface (CLI) for interacting with an Ollama AI model.".freeze
-  s.test_files = ["spec/assets/example.rb".freeze, "spec/ollama_chat/chat_spec.rb".freeze, "spec/ollama_chat/clipboard_spec.rb".freeze, "spec/ollama_chat/follow_chat_spec.rb".freeze, "spec/ollama_chat/information_spec.rb".freeze, "spec/ollama_chat/input_content_spec.rb".freeze, "spec/ollama_chat/kramdown_ansi_spec.rb".freeze, "spec/ollama_chat/message_editing_spec.rb".freeze, "spec/ollama_chat/message_list_spec.rb".freeze, "spec/ollama_chat/message_output_spec.rb".freeze, "spec/ollama_chat/model_handling_spec.rb".freeze, "spec/ollama_chat/parsing_spec.rb".freeze, "spec/ollama_chat/redis_cache_spec.rb".freeze, "spec/ollama_chat/server_socket_spec.rb".freeze, "spec/ollama_chat/source_fetching_spec.rb".freeze, "spec/ollama_chat/state_selectors_spec.rb".freeze, "spec/ollama_chat/switches_spec.rb".freeze, "spec/ollama_chat/think_control_spec.rb".freeze, "spec/ollama_chat/tools/browse_spec.rb".freeze, "spec/ollama_chat/tools/copy_to_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/directory_structure_spec.rb".freeze, "spec/ollama_chat/tools/execute_grep_spec.rb".freeze, "spec/ollama_chat/tools/execute_ri_spec.rb".freeze, "spec/ollama_chat/tools/file_context_spec.rb".freeze, "spec/ollama_chat/tools/gem_path_lookup_spec.rb".freeze, "spec/ollama_chat/tools/generate_password_spec.rb".freeze, "spec/ollama_chat/tools/get_current_weather_spec.rb".freeze, "spec/ollama_chat/tools/get_cve_spec.rb".freeze, "spec/ollama_chat/tools/get_endoflife_spec.rb".freeze, "spec/ollama_chat/tools/get_jira_issue_spec.rb".freeze, "spec/ollama_chat/tools/get_location_spec.rb".freeze, "spec/ollama_chat/tools/get_rfc_spec.rb".freeze, "spec/ollama_chat/tools/get_time_spec.rb".freeze, "spec/ollama_chat/tools/get_url_spec.rb".freeze, "spec/ollama_chat/tools/open_file_in_editor_spec.rb".freeze, "spec/ollama_chat/tools/paste_from_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/paste_into_editor_spec.rb".freeze, "spec/ollama_chat/tools/patch_file_spec.rb".freeze, "spec/ollama_chat/tools/read_file_spec.rb".freeze, "spec/ollama_chat/tools/resolve_tag_spec.rb".freeze, "spec/ollama_chat/tools/run_tests_spec.rb".freeze, "spec/ollama_chat/tools/search_web_spec.rb".freeze, "spec/ollama_chat/tools/write_file_spec.rb".freeze, "spec/ollama_chat/utils/analyze_directory_spec.rb".freeze, "spec/ollama_chat/utils/cache_fetcher_spec.rb".freeze, "spec/ollama_chat/utils/fetcher_spec.rb".freeze, "spec/ollama_chat/utils/file_argument_spec.rb".freeze, "spec/ollama_chat/utils/path_completer_spec.rb".freeze, "spec/ollama_chat/vim_spec.rb".freeze, "spec/ollama_chat/web_searching_spec.rb".freeze, "spec/spec_helper.rb".freeze]
+  s.test_files = ["spec/assets/example.rb".freeze, "spec/ollama_chat/chat_spec.rb".freeze, "spec/ollama_chat/clipboard_spec.rb".freeze, "spec/ollama_chat/follow_chat_spec.rb".freeze, "spec/ollama_chat/information_spec.rb".freeze, "spec/ollama_chat/input_content_spec.rb".freeze, "spec/ollama_chat/kramdown_ansi_spec.rb".freeze, "spec/ollama_chat/message_editing_spec.rb".freeze, "spec/ollama_chat/message_list_spec.rb".freeze, "spec/ollama_chat/message_output_spec.rb".freeze, "spec/ollama_chat/model_handling_spec.rb".freeze, "spec/ollama_chat/parsing_spec.rb".freeze, "spec/ollama_chat/redis_cache_spec.rb".freeze, "spec/ollama_chat/server_socket_spec.rb".freeze, "spec/ollama_chat/source_fetching_spec.rb".freeze, "spec/ollama_chat/state_selectors_spec.rb".freeze, "spec/ollama_chat/switches_spec.rb".freeze, "spec/ollama_chat/think_control_spec.rb".freeze, "spec/ollama_chat/tools/browse_spec.rb".freeze, "spec/ollama_chat/tools/copy_to_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/directory_structure_spec.rb".freeze, "spec/ollama_chat/tools/execute_grep_spec.rb".freeze, "spec/ollama_chat/tools/execute_ri_spec.rb".freeze, "spec/ollama_chat/tools/file_context_spec.rb".freeze, "spec/ollama_chat/tools/gem_path_lookup_spec.rb".freeze, "spec/ollama_chat/tools/generate_password_spec.rb".freeze, "spec/ollama_chat/tools/get_current_weather_spec.rb".freeze, "spec/ollama_chat/tools/get_cve_spec.rb".freeze, "spec/ollama_chat/tools/get_endoflife_spec.rb".freeze, "spec/ollama_chat/tools/get_jira_issue_spec.rb".freeze, "spec/ollama_chat/tools/get_location_spec.rb".freeze, "spec/ollama_chat/tools/get_rfc_spec.rb".freeze, "spec/ollama_chat/tools/get_time_spec.rb".freeze, "spec/ollama_chat/tools/get_url_spec.rb".freeze, "spec/ollama_chat/tools/open_file_in_editor_spec.rb".freeze, "spec/ollama_chat/tools/paste_from_clipboard_spec.rb".freeze, "spec/ollama_chat/tools/paste_into_editor_spec.rb".freeze, "spec/ollama_chat/tools/patch_file_spec.rb".freeze, "spec/ollama_chat/tools/read_file_spec.rb".freeze, "spec/ollama_chat/tools/resolve_tag_spec.rb".freeze, "spec/ollama_chat/tools/retrieve_document_snippets_spec.rb".freeze, "spec/ollama_chat/tools/run_tests_spec.rb".freeze, "spec/ollama_chat/tools/search_web_spec.rb".freeze, "spec/ollama_chat/tools/write_file_spec.rb".freeze, "spec/ollama_chat/utils/analyze_directory_spec.rb".freeze, "spec/ollama_chat/utils/cache_fetcher_spec.rb".freeze, "spec/ollama_chat/utils/fetcher_spec.rb".freeze, "spec/ollama_chat/utils/file_argument_spec.rb".freeze, "spec/ollama_chat/utils/path_completer_spec.rb".freeze, "spec/ollama_chat/vim_spec.rb".freeze, "spec/ollama_chat/web_searching_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 
   s.specification_version = 4
 

data/spec/ollama_chat/tools/browse_spec.rb

@@ -40,7 +40,9 @@ describe OllamaChat::Tools::Browse do
     expect(json.error).to be_nil # No excception was raised
     expect(json.success).to be true
     expect(json.exitstatus).to eq 0
-    expect(json.message).to eq 'opening URL/file'
+    expect(json.message).to eq(
+      "Opened \"https://www.example.com\" in browser."
+    )
     expect(json.url).to eq 'https://www.example.com'
   end
 
@@ -66,7 +68,9 @@ describe OllamaChat::Tools::Browse do
     expect(json.error).to be_nil # No excception was raised
     expect(json.success).to be false
     expect(json.exitstatus).to eq 1
-    expect(json.message).to eq 'opening URL/file'
+    expect(json.message).to eq(
+      "Could not open \"https://nonexistent-domain-12345.com\" in browser."
+    )
   end
 
   it 'can handle execution exceptions gracefully' do
@@ -118,7 +122,9 @@ describe OllamaChat::Tools::Browse do
       json = json_object(result)
       expect(json.success).to be true
       expect(json.exitstatus).to eq 0
-      expect(json.message).to eq 'opening URL/file'
+      expect(json.message).to eq(
+        "Opened \"https://www.example.com\" in browser."
+      )
       expect(json.url).to eq 'https://www.example.com'
     end
   end

data/spec/ollama_chat/tools/open_file_in_editor_spec.rb

@@ -31,6 +31,7 @@ describe OllamaChat::Tools::OpenFileInEditor do
     json = json_object(result)
     expect(json.path).to eq asset('example.rb')
     expect(json.start_line).to eq 42
+    expect(json.message).to match(%r(spec/assets/example.rb" at line 42))
   end
 
   it 'can be executed successfully with valid path, start_line, end_line' do
@@ -52,6 +53,7 @@ describe OllamaChat::Tools::OpenFileInEditor do
     expect(json.path).to eq asset('example.rb')
     expect(json.start_line).to eq 23
     expect(json.end_line).to eq 42
+    expect(json.message).to match(%r(spec/assets/example.rb" and selected range 23-42))
   end
 
   it 'can handle invalid path gracefully' do

data/spec/ollama_chat/tools/paste_from_clipboard_spec.rb

@@ -27,7 +27,8 @@ describe OllamaChat::Tools::PasteFromClipboard do
     )
 
     # Test that perform_paste_from_clipboard is called
-    expect(chat).to receive(:perform_paste_from_clipboard)
+    expect(chat).to receive(:perform_paste_from_clipboard).
+      and_return 'Hello World'
 
     result = described_class.new.execute(tool_call, chat: chat)
 
@@ -36,7 +37,7 @@ describe OllamaChat::Tools::PasteFromClipboard do
     json = json_object(result)
     expect(json.error).to be_nil # No exception was raised
     expect(json.success).to be true
-    expect(json.message).to eq 'Content pasted from clipboard'
+    expect(json.message).to eq "Pasted 11.0 B of content."
   end
 
   it 'can handle execution errors gracefully' do

data/spec/ollama_chat/tools/resolve_tag_spec.rb

@@ -51,7 +51,7 @@ describe OllamaChat::Tools::ResolveTag do
           "linenumber" => 49}
       ]
       expect(OllamaChat::Utils::TagResolver).to receive(:new).
-        and_return(double(resolve: double(resolve: result_array)))
+        and_return(double(resolve: double(size: 2, resolve: result_array)))
 
       result = described_class.new.execute(tool_call)
 

data/spec/ollama_chat/tools/retrieve_document_snippets_spec.rb

@@ -0,0 +1,66 @@
+describe OllamaChat::Tools::RetrieveDocumentSnippets do
+  let :chat do
+    OllamaChat::Chat.new(argv: chat_default_config)
+  end
+
+  connect_to_ollama_server
+
+  it 'has the expected name' do
+    expect(described_class.new.name).to eq 'retrieve_document_snippets'
+  end
+
+  it 'provides a Tool instance' do
+    expect(described_class.new.tool).to be_a(Ollama::Tool)
+  end
+
+  it 'works with a valid query' do
+    tool_call = double(
+      'ToolCall',
+      function: double(
+        name: 'retrieve_document_snippets',
+        arguments: double(
+          query: 'Ruby array',
+          # other attributes are irrelevant for this tool
+        )
+      )
+    )
+
+    tool = described_class.new
+    expect(tool).to receive(:find_document_records).with(
+      kind_of(OllamaChat::Chat), kind_of(String)
+    ).and_return(
+      [ double('Record', text: 'quux', source: 'foo', tags: %w[ bar ], tags_set: []) ]
+    )
+
+    result = tool.execute(tool_call, chat:)
+
+    # Should return a JSON string
+    expect(result).to be_a(String)
+    json = json_object(result)
+    expect(json.prompt).to eq(
+      "Consider these snippets generated from retrieval when formulating your response!"
+    )
+    expect(json.ollama_chat_retrieval_snippets.size).to eq 1
+  end
+
+  it 'returns an error when query is empty' do
+    tool_call = double(
+      'ToolCall',
+      function: double(
+        name: 'retrieve_document_snippets',
+        arguments: double(
+          query: '',
+        )
+      )
+    )
+
+    result = described_class.new.execute(tool_call, chat:)
+    json = json_object(result)
+    expect(json.error).to eq('OllamaChat::OllamaChatError')
+    expect(json.message).to eq('Empty query')
+  end
+
+  it 'can be converted to hash' do
+    expect(described_class.new.to_hash).to be_a(Hash)
+  end
+end

data/spec/ollama_chat/tools/search_web_spec.rb

@@ -40,9 +40,11 @@ describe OllamaChat::Tools::SearchWeb do
     # Should return valid JSON
     expect(result).to be_a(String)
     json = json_object(result)
-    expect(json.query).to eq 'Ruby programming'
-    expect(json.url).to be_a(Array)
-    expect(json.url.length).to be >= 1
+    expect(json.message).to eq(
+      "Searched the web with query \"Ruby programming\" which returned 2 results."
+    )
+    expect(json.results).to be_a(Array)
+    expect(json.results.length).to be >= 1
   end
 
   it 'can be executed successfully with a query and custom num_results' do
@@ -67,9 +69,11 @@ describe OllamaChat::Tools::SearchWeb do
     # Should return valid JSON
     expect(result).to be_a(String)
     json = json_object(result)
-    expect(json.query).to eq 'Ruby programming'
-    expect(json.url).to be_a(Array)
-    expect(json.url.length).to eq 1
+    expect(json.message).to eq(
+      "Searched the web with query \"Ruby programming\" which returned 1 results."
+    )
+    expect(json.results).to be_a(Array)
+    expect(json.results.length).to eq 1
   end
 
   it 'can handle execution errors gracefully' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ollama_chat
 version: !ruby/object:Gem::Version
-  version: 0.0.82
+  version: 0.0.84
 platform: ruby
 authors:
 - Florian Frank
@@ -508,6 +508,7 @@ extra_rdoc_files:
 - lib/ollama_chat/tools/patch_file.rb
 - lib/ollama_chat/tools/read_file.rb
 - lib/ollama_chat/tools/resolve_tag.rb
+- lib/ollama_chat/tools/retrieve_document_snippets.rb
 - lib/ollama_chat/tools/run_tests.rb
 - lib/ollama_chat/tools/search_web.rb
 - lib/ollama_chat/tools/write_file.rb
@@ -520,6 +521,7 @@ extra_rdoc_files:
 - lib/ollama_chat/utils/path_completer.rb
 - lib/ollama_chat/utils/path_validator.rb
 - lib/ollama_chat/utils/tag_resolver.rb
+- lib/ollama_chat/utils/value_formatter.rb
 - lib/ollama_chat/version.rb
 - lib/ollama_chat/vim.rb
 - lib/ollama_chat/web_searching.rb
@@ -592,6 +594,7 @@ files:
 - lib/ollama_chat/tools/patch_file.rb
 - lib/ollama_chat/tools/read_file.rb
 - lib/ollama_chat/tools/resolve_tag.rb
+- lib/ollama_chat/tools/retrieve_document_snippets.rb
 - lib/ollama_chat/tools/run_tests.rb
 - lib/ollama_chat/tools/search_web.rb
 - lib/ollama_chat/tools/write_file.rb
@@ -604,6 +607,7 @@ files:
 - lib/ollama_chat/utils/path_completer.rb
 - lib/ollama_chat/utils/path_validator.rb
 - lib/ollama_chat/utils/tag_resolver.rb
+- lib/ollama_chat/utils/value_formatter.rb
 - lib/ollama_chat/version.rb
 - lib/ollama_chat/vim.rb
 - lib/ollama_chat/web_searching.rb
@@ -669,6 +673,7 @@ files:
 - spec/ollama_chat/tools/patch_file_spec.rb
 - spec/ollama_chat/tools/read_file_spec.rb
 - spec/ollama_chat/tools/resolve_tag_spec.rb
+- spec/ollama_chat/tools/retrieve_document_snippets_spec.rb
 - spec/ollama_chat/tools/run_tests_spec.rb
 - spec/ollama_chat/tools/search_web_spec.rb
 - spec/ollama_chat/tools/write_file_spec.rb
@@ -747,6 +752,7 @@ test_files:
 - spec/ollama_chat/tools/patch_file_spec.rb
 - spec/ollama_chat/tools/read_file_spec.rb
 - spec/ollama_chat/tools/resolve_tag_spec.rb
+- spec/ollama_chat/tools/retrieve_document_snippets_spec.rb
 - spec/ollama_chat/tools/run_tests_spec.rb
 - spec/ollama_chat/tools/search_web_spec.rb
 - spec/ollama_chat/tools/write_file_spec.rb