ollama_chat 0.0.74 → 0.0.75

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cf8d81848dd2c573db23ac8182a092822bc273ba1d224307e756ab7e6741698
-  data.tar.gz: ce5219be13b5293b477a89a9d1b187ec78dd06322b0e96275d7316f006d4828b
+  metadata.gz: c1597a5d9efa0d021f589cd739c294a46825a4fcef81fef2c547e6201f24b8a5
+  data.tar.gz: ac9f19eaaa069ae0b5efc0dbc242cc77eeefda9229fcf0ccb136a6d9c5094054
 SHA512:
-  metadata.gz: a010b8f1cc2ce2eed10d873ec28b5c3c60af9f9f025af0d6db21c3103d7247cd433ea638b9ce78efb5659e5515ef8e15f7136e193c3470d5f87183f1939adc8e
-  data.tar.gz: e2e0d34db7b81234f97e10e6e20e0747640ad15ac087c36c430c6d47540489414241c965a2759f31b3cf9bd9c6477c1d363793cb67f14c2769c03156f3ab2411
+  metadata.gz: 8d3a68f7eb97563c823f8accdfe7eb749505d9925ef28af4f9f772cd7411d73fdfb5fcf31e337f4930d861a65c3e9918f9b60e2299ca835d8f6c2ba9a573f16b
+  data.tar.gz: 1231d962eba2313ea44d2fe319a7adfb3cce35dcbe10a9909fc37be3bd27dcf9672dc65083cbe8b46cb6e04c5a10c9162586d9b45936e8a8df51eace20ca8b60

data/CHANGES.md

@@ -1,5 +1,40 @@
 # Changes
 
+## 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

@@ -219,6 +219,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
@@ -408,7 +411,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
@@ -685,6 +690,20 @@ class OllamaChat::Chat
         end
       end
 
+      if runtime_info.on? && content
+        runtime_info = {
+          languages:            config.languages * ', ',
+          location:             location.on? ? location_description.inspect : 'n/a',
+          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
+      end
+
       messages << Ollama::Message.new(role: 'user', content:, images: @images.dup)
       @images.clear
       handler = OllamaChat::FollowChat.new(

data/lib/ollama_chat/information.rb

@@ -103,6 +103,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 +125,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/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,35 @@ 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}.
+    - 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 +198,7 @@ tools:
       default: true
       require_confirmation: true
       max_results: 25
-    import_url:
+    get_url:
       default: true
       require_confirmation: true
       schemes:
@@ -203,3 +228,5 @@ tools:
       default: true
     execute_ri:
       default: true
+    resolve_tag:
+      default: true

data/lib/ollama_chat/personae_management.rb

@@ -35,6 +35,9 @@ 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
@@ -160,7 +163,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 +250,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 +272,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 +282,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

data/lib/ollama_chat/tools/browse.rb

@@ -25,8 +25,9 @@ class OllamaChat::Tools::Browse
       function: Tool::Function.new(
         name:,
         description: <<~EOT,
-          Open a URL or file in the user\'s default browser application so they
-          can view the content directly
+          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.
         EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
@@ -34,8 +35,7 @@ class OllamaChat::Tools::Browse
             url: Tool::Function::Parameters::Property.new(
               type: 'string',
               description: <<~EOT,
-                The URL or file to open in the user\'s browser for them to view
-                directly
+                The URL or file to open in the the system’s web/browser app.
               EOT
             ),
           },

data/lib/ollama_chat/tools/copy_to_clipboard.rb

@@ -20,15 +20,16 @@ class OllamaChat::Tools::CopyToClipboard
       function: Tool::Function.new(
         name:,
         description: <<~EOT,
-          Copy a text to the clipboard (either the parameter text or the last
-          response of the assistant)
+          Clipboard helper – Copies supplied string (or last assistant reply if
+          omitted) into the OS clipboard, enabling quick pasting elsewhere. No
+          output.
         EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {
             text: Tool::Function::Parameters::Property.new(
               type: 'string',
-              description: 'Text to copy to the clipboard (nil = last response)'
+              description: 'Text to copy to the clipboard (nil = last assistant reply)'
             )
           },
           required: []

data/lib/ollama_chat/tools/directory_structure.rb

@@ -25,8 +25,9 @@ class OllamaChat::Tools::DirectoryStructure
       function: Tool::Function.new(
         name:,
         description: <<~EOT,
-          Retrieve the directory structure and file hierarchy for a given path,
-          for depth of max_depth (if given).
+          Tree viewer – Returns JSON describing files/folders under path up to
+          max_depth. Handy for locating resources or presenting a project
+          layout.
         EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',

data/lib/ollama_chat/tools/execute_grep.rb

@@ -19,7 +19,11 @@ class OllamaChat::Tools::ExecuteGrep
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Search for a pattern in files using grep',
+        description: <<~EOT,
+          Pattern searcher – Runs a regex against all files at path, optionally
+          case‑insensitive, returning matches (up to max_results). Useful for
+          quick codebase queries or finding config values.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {

data/lib/ollama_chat/tools/execute_ri.rb

@@ -17,7 +17,11 @@ class OllamaChat::Tools::ExecuteRI
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Look up Ruby documentation for classes, modules and methods using the `ri` command.',
+        description: <<~EOT,
+          Lookup Ruby docs using the `ri` command – Returns help text for a
+          given topic like class/module/method (Array, String#split). Good when
+          you need method signatures without leaving the chat.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {

data/lib/ollama_chat/tools/file_context.rb

@@ -26,10 +26,9 @@ class OllamaChat::Tools::FileContext
       function: Tool::Function.new(
         name:,
         description: <<~EOT,
-          Create a context that provides information about files and their
-          semantic content in order to give more accurate answers for a query.
-          You can query (maybe) multiple files by using a glob pattern
-          argument.
+          Semantic file snapshot – Gathers AST‑style info (e.g., classes,
+          methods) from all matching files (pattern) in directory. Useful for
+          LLMs to reason about code structure
         EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',

data/lib/ollama_chat/tools/gem_path_lookup.rb

@@ -23,7 +23,11 @@ class OllamaChat::Tools::GemPathLookup
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Look up the installation path of a Ruby gem',
+        description: <<~EOT,
+          Gem locator – Returns absolute filesystem location where a named gem
+          is installed (e.g., "rails"). Handy when you need file paths inside
+          gems.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {

data/lib/ollama_chat/tools/get_current_weather.rb

@@ -24,7 +24,11 @@ class OllamaChat::Tools::GetCurrentWeather
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Get the current weather for the configured location',
+        description: <<~EOT,
+          Weather fetcher – Retrieves a short report of local meteorological
+          conditions based on your preset location coordinates. No arguments
+          needed.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {},

data/lib/ollama_chat/tools/get_cve.rb

@@ -20,7 +20,10 @@ class OllamaChat::Tools::GetCVE
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Get the CVE for id as JSON',
+        description: <<~EOT,
+          CVE lookup – Returns detailed vulnerability data (JSON) for a given
+          cve_id ("CVE-2023‑1234"). Useful when assessing security risks.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {

data/lib/ollama_chat/tools/get_endoflife.rb

@@ -20,7 +20,11 @@ class OllamaChat::Tools::GetEndoflife
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Get the endoflife information for a product as JSON',
+        description: <<~EOT,
+          EOL checker – Provides lifecycle status of software (product) in
+          machine‑readable form (JSON). Handy for compliance or upgrade
+          planning.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {

data/lib/ollama_chat/tools/get_rfc.rb

@@ -20,7 +20,10 @@ class OllamaChat::Tools::GetRFC
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Get the RFC for id as text',
+        description: <<~EOT,
+         RFC fetcher – Downloads the full plain‑text of an Internet Standard
+         (e.g., "rfc-2616"). No arguments beyond rfc_id.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {

data/lib/ollama_chat/tools/get_time.rb

@@ -28,7 +28,10 @@ class OllamaChat::Tools::GetTime
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Get the current time as an ISO8601 string',
+        description: <<~EOT,
+          Timestamp provider – Returns UTC/ISO 8601 formatted datetime for now.
+          Useful in logs or timestamps.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {},

data/lib/ollama_chat/tools/{import_url.rb → get_url.rb}

@@ -3,10 +3,10 @@
 # This tool allows the chat client to retrieve content from a specified URL.
 # It integrates with the Ollama tool calling system to provide web content
 # fetching capabilities to the language model.
-class OllamaChat::Tools::ImportURL
+class OllamaChat::Tools::GetURL
   include OllamaChat::Tools::Concern
 
-  def self.register_name = 'import_url'
+  def self.register_name = 'get_url'
 
   # Creates and returns a tool definition for fetching content from URLs.
   #
@@ -21,11 +21,9 @@ class OllamaChat::Tools::ImportURL
       function: Tool::Function.new(
         name:,
         description: <<~EOT,
-          Fetch content from a URL and import it into the chat session. This
-          tool retrieves web content from the specified URL and makes it
-          available for the language model to reference and use in responses.
-          It supports various content types including HTML, Markdown, and plain
-          text, and integrates with the chat's document processing pipeline.
+         Web fetcher – Downloads any web resource (HTML, Markdown, plain text)
+         at url and makes its contents available to the model. Good for pulling
+         documentation snippets.
         EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
@@ -33,7 +31,7 @@ class OllamaChat::Tools::ImportURL
             url: Tool::Function::Parameters::Property.new(
               type: 'string',
               description: <<~EOT,
-                The URL to fetch content from. This can be any valid HTTP or
+                The URL to get content from. This can be any valid HTTP or
                 HTTPS URL pointing to a web resource that can be retrieved and
                 processed by the chat system. The tool handles the HTTP request
                 and returns the content.
@@ -57,12 +55,11 @@ class OllamaChat::Tools::ImportURL
   # @return [String] the fetched content as a JSON string
   # @raise [StandardError] if there's an issue with the HTTP request or content fetching
   def execute(tool_call, **opts)
-    chat   = opts[:chat]
     config = opts[:config]
     args   = tool_call.function.arguments
     url    = args.url.to_s
 
-    allowed_schemes = Array(config.tools.functions.import_url.schemes?).map(&:to_s)
+    allowed_schemes = Array(config.tools.functions.get_url.schemes?).map(&:to_s)
 
     uri = URI.parse(args.url.to_s)
     unless allowed_schemes.include?(uri.scheme)
@@ -70,9 +67,11 @@ class OllamaChat::Tools::ImportURL
         "(allowed: #{allowed_schemes.join(', ')})"
     end
 
-    chat.import(url).full? do |c|
-      return c.ask_and_send_or_self(:read)
-    end
+    OllamaChat::Utils::Fetcher.get(
+      url,
+      debug: OC::OLLAMA::CHAT::DEBUG,
+      reraise: true,
+    &:read)
   rescue => e
     { error: e.class, message: e.message, url: }.to_json
   end

data/lib/ollama_chat/tools/insert_into_editor.rb

@@ -15,11 +15,11 @@ class OllamaChat::Tools::InsertIntoEditor
       function: Tool::Function.new(
         name:,
         description: <<~EOT,
-          Insert the provided text into your editor (Vim). If no
-          `text` is supplied, the tool will automatically use the last
-          assistant response. This function is intended for quick code
-          snippets or edits that you want to push directly into a running
-          editor session without leaving OllamaChat.
+          Editor helper – Sends a string (or last reply if omitted) straight
+          into the User’s editor buffer, optionally in insert mode.
+          If no `text` is supplied, the tool will automatically use the last assistant
+          response. No output; Do not not call this tool function unless
+          explicitly requested by the user.
         EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',

data/lib/ollama_chat/tools/open_file_in_editor.rb

@@ -20,7 +20,11 @@ class OllamaChat::Tools::OpenFileInEditor
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Open a file in the vim editor at a specific line or range',
+        description: <<~EOT,
+          Open a file in the user's editor, jumping to start_line (and
+          optionally ending at end_line). No return value; Do not call this
+          tool function unless explicitly requested by the user.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {

data/lib/ollama_chat/tools/paste_from_clipboard.rb

@@ -17,7 +17,11 @@ class OllamaChat::Tools::PasteFromClipboard
       type: 'function',
       function: Tool::Function.new(
         name:,
-        description: 'Paste content from the system clipboard into the chat session',
+        description: <<~EOT,
+          Clipboard reader – Inserts whatever is currently in your OS clipboard
+          as a new message to the assistant, enabling quick transfer of
+          external snippets.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {},

data/lib/ollama_chat/tools/read_file.rb

@@ -24,7 +24,11 @@ class OllamaChat::Tools::ReadFile
       type: 'function',
       function: Tool::Function.new(
         name: 'read_file',
-        description: 'Reads file content safely (path validated like write_file)',
+        description: <<~EOT,
+          File reader – Returns raw text from path if it’s within allowed
+          directories. No side effects; useful for inspecting config or source
+          files.
+        EOT
         parameters: Tool::Function::Parameters.new(
           type: 'object',
           properties: {