ollama_chat 0.0.74 → 0.0.76

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cf8d81848dd2c573db23ac8182a092822bc273ba1d224307e756ab7e6741698
-  data.tar.gz: ce5219be13b5293b477a89a9d1b187ec78dd06322b0e96275d7316f006d4828b
+  metadata.gz: c2fd2a7be9e054baac6b811b1a30fff33839905d39b4784d8aba2bbd6c5f3538
+  data.tar.gz: f1ff0f8a94cc8c55f43928a7e09153a92cfa4b8b0b890f1b52a7511c7fb18195
 SHA512:
-  metadata.gz: a010b8f1cc2ce2eed10d873ec28b5c3c60af9f9f025af0d6db21c3103d7247cd433ea638b9ce78efb5659e5515ef8e15f7136e193c3470d5f87183f1939adc8e
-  data.tar.gz: e2e0d34db7b81234f97e10e6e20e0747640ad15ac087c36c430c6d47540489414241c965a2759f31b3cf9bd9c6477c1d363793cb67f14c2769c03156f3ab2411
+  metadata.gz: fef0b8733d62c5769b4675f769a30cddec686806347b04325b7d0ec8d65c7e546e70d1829ebf423240c32683c07afd124770def3305556e395f174eb0a030c6e
+  data.tar.gz: e14e370d2391fa9d2e90b70831c389ff3edcd86b89f7cad55586125c12675bb65ab5b16eab14029f918c7478e54b7e31b1ede609110c64391b8a6376939620d4

data/.utilsrc

@@ -33,15 +33,25 @@ code_indexer do
   verbose false
 
   gems = %w[
+    all_images
     amatch
     base64
     bigdecimal
     complex_config
+    const_conf
+    context_spook
+    csv
     date
     documentrix
     excon
+    fileutils
+    gem_hadar
+    infobar
+    irb
     json
+    kramdown
     kramdown-ansi
+    kramdown-parser-gfm
     mize
     more_math
     ollama-ruby

data/CHANGES.md

@@ -1,5 +1,89 @@
 # Changes
 
+## 2026-03-09 v0.0.76
+
+- Added `client:` and `current_directory:` keys to `runtime_info_values` in
+  `chat.rb`.  
+- Implemented `#client` method returning `"progname **0.0.75**"` in
+  `information.rb`.  
+- Introduced helper `location_description?` in `location_handling.rb`.  
+- Simplified `MessageList#to_ary` to return a duplicate of the internal array,
+  removing automatic system prompt + location injection.  
+- Updated default config placeholders for `%{client}` and
+  `%{current_directory}` in `default_config.yml`.  
+- Adjusted web searching logic to use `location_description?` instead of
+  deprecated methods.  
+- Removed tests that expected location‑augmented system prompts from
+  `spec/ollama_chat/message_list_spec.rb`.  
+- Standardized JSON output formatting across tools: aligned JSON keys, added
+  spaces after commas, and added trailing commas in tool responses such as
+  `copy_to_clipboard`, `gem_path_lookup`, `generate_password`, `get_endoflife`,
+  `get_rfc`, `insert_into_editor`, `open_file_in_editor`,
+  `paste_from_clipboard`, and `search_web`.  
+- Added trailing commas to JSON objects for consistency and easier future
+  edits.  
+- Standardized error field formatting, ensuring each error block includes a
+  space after the colon and a trailing comma where appropriate.  
+- Added helper `disable_content_parsing` in `chat.rb` that sets `@parse_content
+  = false`.  
+- Refactored command handlers to call `disable_content_parsing` instead of
+  assigning directly to `@parse_content`.  
+- Updated persona setup logic so that a returned persona result triggers
+  `disable_content_parsing`; otherwise parsing is enabled with
+  `enable_command_completion`.  
+- Added explanatory comments around the new helper for clarity.  
+- Improved clean flow: captured return value of `clean` and set `@parse_content
+  = true` when a persona profile is returned.  
+- Replaced old flag `@persona_setup` with `@default_persona`; ensured it
+  defaults to `:none` in an `ensure` block after setup.  
+- Added new method `reload_default_persona` that prompts for confirmation
+  before reloading the default persona file if one exists.  
+- Modified `clean(what)` to return the result of `reload_default_persona`,
+  enabling the caller to react to a reload.  
+- Adjusted `/clear` command handling in the chat loop to use the returned value
+  from `clean` and only proceed when nothing is returned.  
+- Renamed local variable `runtime_info` to `runtime_info_values` in `chat.rb`
+  for clarity.  
+- Updated runtime info prompt interpolation to use `runtime_info_values`
+  instead of `runtime_info`.  
+- Updated `/.utilsrc` by adding gems to the `code_indexer` configuration:
+  `all_images`, `const_conf`, `context_spook`, `csv`, `fileutils`, `gem_hadar`,
+  `infobar`, `irb`, `kramdown`, and `kramdown-parser-gfm`.
+
+## 2026-03-08 v0.0.75
+
+- Added runtime reporting of tool allowed paths by introducing
+  `tool_paths_allowed` method and including it in chat output, updating config
+  prompt, and normalizing tool name handling.
+- Added new tool `OllamaChat::Tools::ResolveTag` with utility
+  `OllamaChat::Utils::TagResolver` to parse tag files; enabled in
+  `default_config.yml` and added corresponding tests.  
+- Introduced `runtime_info` switch in `OllamaChat::Switches`; added
+  `/runtime_info` command handling in `chat.rb`, runtime info block injection,
+  and display via `information.rb`; added `prompts/runtime_info` template and
+  `languages:` array; added `runtime_info.toggle`, `runtime_info.show`,
+  `runtime_info.on?`, `runtime_info.enabled` support.  
+- Updated `OllamaChat::Tools::DirectoryStructure` description to note it can
+  locate one or multiple files, referencing `max_depth`.  
+- Clarified usage of `browse`, `copy_to_clipboard`, `open_file_in_editor`,
+  `insert_into_editor` tools in documentation strings; fixed double‑negative
+  typo in `insert_into_editor.rb`.  
+- Renamed `import_url` tool to `get_url`: updated config key, tool
+  registration, class name `OllamaChat::Tools::GetURL`, spec file names, method
+  calls to `config.tools.functions.get_url.schemes?`, replaced all
+  `chat.import` with `OllamaChat::Utils::Fetcher.get`.  
+- Added path validation and error handling to `OllamaChat::Tools::RunTests`:
+  new private method `check_path(path)` prevents using `"./"` and validates
+  existence; wrapped execution in rescue block returning JSON with `error:` and
+  `message:`; updated function description accordingly.  
+- Refined and unified tool descriptions with consistent punctuation.  
+- Added explicit persona loading verification when editing: confirmation step
+  before applying edited personality configurations.  
+- Improved persona loading and prompt formatting: updated
+  `setup_persona_from_opts`, `info_persona`, `load_persona_file` to return
+  `[pathname, content]`, added newline in `play_persona_prompt`, adjusted
+  `play_persona` to handle new return value.
+
 ## 2026-03-06 v0.0.74
 
 - Added new tool `ExecuteRI` in `lib/ollama_chat/tools/execute_ri.rb` that

data/README.md

@@ -158,6 +158,7 @@ The following commands can be given inside the chat, if prefixed by a `/`:
 /markdown                                            toggle markdown output
 /stream                                              toggle stream output
 /location                                            toggle location submission
+/runtime_info                                        toggle runtime information in prompts
 /voice [change]                                      toggle voice output or change the voice
 /last [n]                                            show the last n / 1 system/assistant message
 /list [n]                                            list the last n / all conversation exchanges

data/lib/ollama_chat/chat.rb

@@ -192,6 +192,15 @@ class OllamaChat::Chat
     @links ||= Set.new
   end
 
+  # The disable_content_parsing method turns off content parsing by setting
+  # @parse_content to false.
+  #
+  # This prevents automatic parsing of user input content during chat
+  # processing.
+  def disable_content_parsing
+    @parse_content = false
+  end
+
   # Handles user input commands and processes chat interactions.
   #
   # @param content [String] The input content to process
@@ -208,7 +217,7 @@ class OllamaChat::Chat
       copy_to_clipboard
       :next
     when %r(^/paste$)
-      @parse_content = false
+      disable_content_parsing
       paste_from_clipboard
     when %r(^/markdown$)
       markdown.toggle
@@ -219,6 +228,9 @@ class OllamaChat::Chat
     when %r(^/location$)
       location.toggle
       :next
+    when %r(^/runtime_info$)
+      runtime_info.toggle
+      :next
     when %r(^/voice(?:\s+(change))?$)
       if $1 == 'change'
         change_voice
@@ -235,8 +247,12 @@ class OllamaChat::Chat
       messages.show_last(n)
       :next
     when %r(^/clear(?:\s+(messages|links|history|tags|all))?$)
-      clean($1)
-      :next
+      if result = clean($1)
+        disable_content_parsing
+        content = result
+      else
+        :next
+      end
     when %r(^/clobber$)
       clean('all')
       :next
@@ -272,7 +288,7 @@ class OllamaChat::Chat
         STDOUT.puts "Not enough messages in this conversation."
         return :redo
       end
-      @parse_content = false
+      disable_content_parsing
       content
     when %r(^/collection(?:\s+(clear|change))?$)
       case $1 || 'change'
@@ -316,30 +332,30 @@ class OllamaChat::Chat
       think_loud.toggle
       :next
     when %r(^/import\s+(.+))
-      @parse_content = false
+      disable_content_parsing
       import($1) or :next
     when %r(^/summarize\s+(?:(\d+)\s+)?(.+))
-      @parse_content = false
+      disable_content_parsing
       summarize($2, words: $1) or :next
     when %r(^/embedding$)
       embedding_paused.toggle(show: false)
       embedding.show
       :next
     when %r(^/embed\s+(.+))
-      @parse_content = false
+      disable_content_parsing
       embed($1) or :next
     when %r(^/web\s+(?:(\d+)\s+)?(.+))
-      @parse_content = false
+      disable_content_parsing
       web($1, $2)
     when %r(^/input(?:\s+(.+))?$)
       arg = $1
       arg and patterns = arg.scan(/(\S+)/).flatten
-      @parse_content = false
+      disable_content_parsing
       input(patterns) or :next
     when %r(^/context(?:\s+(.+))?$)
       arg = $1
       arg and patterns = arg.scan(/(\S+)/).flatten
-      @parse_content = false
+      disable_content_parsing
       context_spook(patterns) or :next
     when %r(^/compose$)
       compose or :next
@@ -393,7 +409,7 @@ class OllamaChat::Chat
       end
       :next
     when %r(^/persona(?:\s+(add|delete|edit|file|info|list|load|play))?$)
-      @parse_content = false
+      disable_content_parsing
       case $1
       when 'add'
         if result = add_persona
@@ -408,7 +424,9 @@ class OllamaChat::Chat
           :next
         end
       when 'edit'
-        if result = edit_persona
+        if result = edit_persona and
+            ask?(prompt: 'Load new persona profile? (y/n) ') =~ /\Ay/i
+        then
           result
         else
           :next
@@ -448,7 +466,7 @@ class OllamaChat::Chat
       STDOUT.puts "Goodbye."
       :return
     when %r(^/help me$)
-      @parse_content = false
+      disable_content_parsing
       config.prompts.help % { commands: display_chat_help_message }
     when %r(^/)
       display_chat_help
@@ -575,9 +593,11 @@ class OllamaChat::Chat
   # @param what [ String, nil ] the type of data to clear, defaults to
   #   'messages' if nil
   def clean(what)
+    persona_profile = nil
     case what
     when 'messages', nil
       messages.clear
+      persona_profile = reload_default_persona
       STDOUT.puts "Cleared messages."
     when 'links'
       links.clear
@@ -594,11 +614,13 @@ class OllamaChat::Chat
         @documents.clear
         links.clear
         clear_history
+        persona_profile = reload_default_persona
         STDOUT.puts "Cleared messages and collection #{bold{@documents.collection}}."
       else
         STDOUT.puts 'Cancelled.'
       end
     end
+    persona_profile
   end
 
   # The interact_with_user method manages the interactive loop for user input
@@ -616,7 +638,7 @@ class OllamaChat::Chat
   def interact_with_user
     loop do
       if persona_result = setup_persona_from_opts
-        @parse_content = false
+        disable_content_parsing
         content = persona_result
       else
         @parse_content = true
@@ -624,7 +646,7 @@ class OllamaChat::Chat
         input_prompt   = bold { color(172) { message_type(@images) + " user" } } + bold { "> " }
         begin
           if content = handle_tool_call_results?
-            @parse_content = false
+            disable_content_parsing
           else
             content = enable_command_completion do
               if prefill_prompt = @prefill_prompt.full?
@@ -685,6 +707,22 @@ class OllamaChat::Chat
         end
       end
 
+      if runtime_info.on? && content
+        runtime_info_values = {
+          languages:            config.languages * ', ',
+          location:             location.on? ? location_description.inspect : 'n/a',
+          client:               ,
+          current_directory:    Pathname.pwd.expand_path.to_path.inspect,
+          terminal_rows:        Tins::Terminal.rows,
+          terminal_cols:        Tins::Terminal.cols,
+          time:                 Time.now.iso8601,
+          voice:                voice.on? ? 'enabled' : 'disabled',
+          markdown:             markdown.on? ? 'enabled' : 'disabled',
+          tool_paths_allowed:   JSON(tool_paths_allowed),
+        }
+        content << config.prompts.runtime_info % runtime_info_values
+      end
+
       messages << Ollama::Message.new(role: 'user', content:, images: @images.dup)
       @images.clear
       handler = OllamaChat::FollowChat.new(

data/lib/ollama_chat/information.rb

@@ -55,6 +55,15 @@ module OllamaChat::Information
     end
   end
 
+  # The client method returns the application name and its current version as a
+  # single string
+  #
+  # @return [ String ] the progname followed by the OllamaChat version
+  #   separated by a space
+  def client
+    [ progname, OllamaChat::VERSION ] * ' '
+  end
+
   # The collection_stats method displays statistics about the current document
   # collection.
   #
@@ -103,6 +112,7 @@ module OllamaChat::Information
     think_mode.show
     think_loud.show
     location.show
+    runtime_info.show
     voice.show
     @voice.on? and @voices.show
     tools_support.show
@@ -124,6 +134,7 @@ module OllamaChat::Information
       /markdown                                            toggle markdown output
       /stream                                              toggle stream output
       /location                                            toggle location submission
+      /runtime_info                                        toggle runtime information in prompts
       /voice [change]                                      toggle voice output or change the voice
       /last [n]                                            show the last n / 1 system/assistant message
       /list [n]                                            list the last n / all conversation exchanges

data/lib/ollama_chat/location_handling.rb

@@ -24,6 +24,14 @@ module OllamaChat::LocationHandling
     config.prompts.location % location_data
   end
 
+  # The location_description? method returns the location description string if
+  # the location setting is enabled; otherwise it returns nil.
+  #
+  # @return [String, nil]
+  def location_description?
+    location_description if location.on?
+  end
+
   # Generates a hash containing current location data.
   #
   # This method collects and returns structured location information including

data/lib/ollama_chat/message_list.rb

@@ -1,14 +1,13 @@
 # A collection class for managing chat messages with support for system
 # prompts, paged output, and conversation history.
-
+#
 # This class provides functionality for storing, retrieving, and displaying
 # chat messages in a structured manner. It handles system prompts separately
 # from regular user and assistant messages, supports pagination for displaying
 # conversations, and offers methods for manipulating message history including
 # clearing, loading, saving, and dropping exchanges. The class integrates with
-# Kramdown::ANSI for formatted output and supports location information in
-# system messages.
-
+# Kramdown::ANSI for formatted output.
+#
 # @example Creating a new message list
 #   chat = OllamaChat::Chat.new
 #   messages = OllamaChat::MessageList.new(chat)
@@ -285,39 +284,12 @@ class OllamaChat::MessageList
   end
 
   # The to_ary method converts the message list into an array of
-  # Ollama::Message objects. If location support was enabled and the message
-  # list contains a system message, the system messages is decorated with the
-  # curent location, time, and unit preferences.
+  # Ollama::Message objects.
   #
   # @return [Array] An array of Ollama::Message objects representing the
   #   messages in the list.
   def to_ary
-    location = at_location.full?
-    add_system = !!location
-    result = @messages.map do |message|
-      if message.role == 'system' && location
-        add_system = false
-        content = message.content + "\n\n#{location}"
-        Ollama::Message.new(role: message.role, content:)
-      else
-        message
-      end
-    end
-    if add_system
-      prompt = @chat.config.system_prompts.assistant?
-      content = [ prompt, location ].compact * "\n\n"
-      message = Ollama::Message.new(role: 'system', content:)
-      result.unshift message
-    end
-    result
-  end
-
-  # The at_location method returns the location/time/units information as a
-  # string if location is enabled.
-  #
-  # @return [ String ] the location information
-  def at_location
-    @chat.location_description if @chat.location.on?
+    @messages.dup
   end
 
   private

data/lib/ollama_chat/oc.rb

@@ -150,6 +150,18 @@ module OC
           description 'Pirate Weather API key'
         end
 
+        CTAGS_TOOL = set do
+          description 'Tools ctags path'
+          default { `which ctags`.full?(:chomp) }
+          check   { value.blank? || File.exist?(value) }
+        end
+
+        TAGS_FILE = set do
+          description 'Tag file location'
+          default     './tags'
+          decode       { Pathname.new(_1).expand_path }
+        end
+
         module JIRA
           description 'Jira tool configuration'
 

data/lib/ollama_chat/ollama_chat_config/default_config.yml

@@ -8,11 +8,15 @@ timeouts:
   connect_timeout: null
   read_timeout: 300
   write_timeout: 300
+languages:
+  - en-US
 location:
   enabled: false
   name: Berlin
   decimal_degrees: [ 52.514127, 13.475211 ]
   units: SI (International System of Units) # or USCS (United States Customary System)
+runtime_info:
+  enabled: true
 prompts:
   embed: "This source was now embedded: %{source}"
   summarize: |
@@ -31,14 +35,37 @@ prompts:
 
     %{results}
   location: You are at %{location_name}, %{location_decimal_degrees}, preferring %{units}
+  runtime_info: |
+
+    ---
+
+    **Runtime Information**
+
+    There is usually no reason to mention this information to the user unless
+    asked about it.
+
+    - Languages the user prefers: %{languages}.
+    - Location is %{location}.
+    - Current directory is %{current_directory}.
+    - Client is %{client}.
+    - Terminal has %{terminal_rows} rows.
+    - Terminal width is %{terminal_cols} columns. **Always** aim to stay within
+      80%% of this width in your output of responses, especially when using
+      markdown tables.
+    - Current time is %{time}.
+    - Markdown output is %{markdown}. **Never** output markdown as your
+      responses if it is disabled.
+    - Voice output is %{voice}. Speak naturally and short if voice
+      output is enabled.
+    - These tools have access to these allowed paths: %{tool_paths_allowed}
   help: |
-      Wait for the user to ask questions about the usage of chat commands. Just
-      list the command names separated by spaces (no descriptions yet) and
-      offer to answer any questions about any of them. Interactively help the
-      user by answering questions about the following
-      chat commands:
+    Wait for the user to ask questions about the usage of chat commands. Just
+    list the command names separated by spaces (no descriptions yet) and
+    offer to answer any questions about any of them. Interactively help the
+    user by answering questions about the following
+    chat commands:
 
-      %{commands}
+    %{commands}
   persona: |
     # Persona
 
@@ -173,7 +200,7 @@ tools:
       default: true
       require_confirmation: true
       max_results: 25
-    import_url:
+    get_url:
       default: true
       require_confirmation: true
       schemes:
@@ -203,3 +230,5 @@ tools:
       default: true
     execute_ri:
       default: true
+    resolve_tag:
+      default: true

data/lib/ollama_chat/personae_management.rb

@@ -35,9 +35,11 @@ module OllamaChat::PersonaeManagement
     FileUtils.mkdir_p personae_backup_directory
   end
 
+  # The setup_persona_from_opts method initializes persona setup by checking
+  # for a provided persona option, determining the appropriate file path, and
+  # playing the persona file if it exists.
   def setup_persona_from_opts
-    @persona_setup and return
-    @persona_setup = true
+    @default_persona and return
     if persona = @opts[?p].full? { Pathname.new(_1) }
       if persona.extname == '.md'
         pathname = persona
@@ -45,15 +47,28 @@ module OllamaChat::PersonaeManagement
         pathname = personae_directory + (persona.to_s + '.md')
       end
       if pathname.exist?
+        @default_persona = pathname
         play_persona_file pathname
       end
     end
+  ensure
+    @default_persona ||= :none
+  end
+
+  # Reloads the default persona file if one is set and not :none, prompting the
+  # user for confirmation before playing the persona file.
+  def reload_default_persona
+    !@default_persona || @default_persona == :none and return
+    prompt = "Reload default persona #{@default_persona.basename.sub_ext('')}? (y/n) "
+    if ask?(prompt:) =~ /\Ay/i
+      play_persona_file @default_persona
+    end
   end
 
   # Returns a sorted list of available persona file names.
   #
-  # This method scans the personae directory for Markdown files and
-  # returns their basenames sorted alphabetically.
+  # This method scans the personae directory for Markdown files and returns
+  # their basenames sorted alphabetically.
   #
   # @return [Array<String>] Sorted array of persona filenames without extension
   def available_personae
@@ -160,7 +175,7 @@ module OllamaChat::PersonaeManagement
   # Shows the persona's profile using kramdown formatting with ansi parsing.
   def info_persona
     if persona = choose_persona
-      persona_profile = load_persona_file(persona)
+      _persona, persona_profile = load_persona_file(persona)
       use_pager do |output|
         output.puts kramdown_ansi_parse(<<~EOT)
           # Persona #{persona.sub_ext('')}
@@ -247,13 +262,17 @@ module OllamaChat::PersonaeManagement
     result.to_json
   end
 
-  # Reads and returns the content of a persona file.
+  # Loads a persona file from disk.
   #
-  # @param persona [String] The persona filename to read
-  # @return [String] The content of the persona file
+  # @param persona [String] The basename of the persona (without extension)
+  #
+  # @return [Array<Pathname, String>] Returns the pathname and its content as a
+  #   string
   def load_persona_file(persona)
     pathname = personae_directory + persona
-    pathname.read if pathname.exist?
+    if pathname.exist?
+      return pathname, pathname.read
+    end
   end
 
   # Generates the roleplay prompt string for a persona.
@@ -265,7 +284,7 @@ module OllamaChat::PersonaeManagement
   # @return [String] Formatted roleplay prompt
   def play_persona_prompt(persona:, persona_profile:)
     persona_name = persona.basename.sub_ext('')
-    "Roleplay as persona %{persona_name} loaded from %{persona}\n%{persona_profile}" % {
+    "Roleplay as persona %{persona_name} loaded from %{persona}\n\n%{persona_profile}" % {
       persona_name:, persona:, persona_profile:
     }
   end
@@ -275,8 +294,8 @@ module OllamaChat::PersonaeManagement
   # Uses the persona selection and loading methods to generate the
   # appropriate roleplay prompt.
   def play_persona(pathname: nil)
-    persona         = choose_persona or return
-    persona_profile = load_persona_file(persona)
+    persona                  = choose_persona or return
+    persona, persona_profile = load_persona_file(persona)
     play_persona_prompt(persona:, persona_profile:)
   end
 

data/lib/ollama_chat/switches.rb

@@ -171,6 +171,13 @@ module OllamaChat::Switches
   # @return [ OllamaChat::Switches::Switch ] the location setting object
   attr_reader :location
 
+  # Provides access to the runtime_info switch controlling the visibility of
+  # runtime information in the chat
+  #
+  # @attr_reader [ Switches::Switch ] a Switch instance that manages runtime
+  #   info visibility
+  attr_reader :runtime_info
+
   # Switch tools support on/off (off → skip all, on → honour per‑tool state)
   #
   # @return [OllamaChat::Switch] the tools_support setting object
@@ -250,6 +257,13 @@ module OllamaChat::Switches
       }
     )
 
+    @runtime_info = Switch.new(
+      value: config.runtime_info.enabled,
+      msg: {
+        true  => "Runtime Information enabled.",
+        false => "Runtime Information disabled.",
+      }
+    )
     @tools_support = Switch.new(
       value: config.tools.enabled,
       msg: {

data/lib/ollama_chat/tool_calling.rb

@@ -42,7 +42,7 @@ module OllamaChat::ToolCalling
   # @param [String] name the name of the tool
   # @return [true, false] true if the tool is enabled
   def tool_enabled?(name)
-    enabled_tools.member?(name)
+    enabled_tools.member?(name.to_s)
   end
 
   # The tools reader returns the registered tools for the chat session.
@@ -153,6 +153,18 @@ module OllamaChat::ToolCalling
     end
   end
 
+  # The tool_paths_allowed method returns a hash mapping each enabled tool name
+  # to its list of allowed paths or patterns. @return [Hash] a hash where keys
+  # are tool names and values are the allowed path lists
+  def tool_paths_allowed
+    config.tools.functions.to_h.
+      select { |name, value| tool_enabled?(name) && value[:allowed].present? }.
+      sort_by(&:first).
+      each_with_object({}) { |(name, value), hash|
+        hash[name] = value[:allowed].map { Pathname.new(_1).expand_path.to_s }
+      }
+  end
+
   private
 
   # The handle_tool_call_results? method processes and returns results from