ollama_chat 0.0.103 → 0.0.105

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e723f48c6459c1ab6aa79f1acaf19a1bab5484f7c36e75c3491cef88deba0d92
-  data.tar.gz: 71e979fa1419bb82abd7f9d0dd44b70aa8576509a7735b3e1b2abee4f0a53f81
+  metadata.gz: cbf0c7c0df08fa3ef8a15a9c62b7e092d035924c071302a4f37e01776dec2504
+  data.tar.gz: '0996355cc3d0324936394a174aaeeee8b67b950d5306cf320fa22a70eef9ea0d'
 SHA512:
-  metadata.gz: 8c018d0417e676f8a9d598df4459443704da4f2c75559cab4e9b2f1f4034ea40807fc6672e656a8eacef29aec0454df8ec19f1259727592b68c0467b1f68a2fb
-  data.tar.gz: 8c8e31bd6bdbfaf5617a32e237bc6c7f975d4d3e9827c9c6761906b509a7108f7ec5971c463ea70779b15b1ba368c7202af3aa641b478946647c48a2d6d18481
+  metadata.gz: 879adc039769558c938911909dbfdfc9625d6b4774cd398d8b39b4ebeb7055d7f7eb1fdaa1c26caf79d7fab3330c57c95b1169927e34d6909518e5f30f1c9d74
+  data.tar.gz: 7fbe2ad8b0f887cab6d83ece7efe118fd0189e1957fdbd5a40725200729b7e4d93e9c018c1a41cc8fc933dd2cee453a3a7b9090a7e647422314175d567e5496c

data/CHANGES.md

@@ -1,5 +1,74 @@
 # Changes
 
+## 2026-08-04 v0.0.105
+
+### New Features
+
+- **Collection Management**: Introduced the
+  `OllamaChat::Database::Models::Collection` model and a corresponding `Sequel`
+  migration for persistent storage. Added interactive CLI commands under
+  `/collection` including `new`, `edit`, `delete`, and `update all`.
+- **Model Profile Copying**: Added an `options copy` subcommand to allow users
+  to interactively copy configuration profiles between models, including
+  implementation of `copy_model_options_profile`.
+- **Interactive Prompt Contexts**: Implemented `choose_prompt_context` in
+  `prompt_management.rb`, allowing the `/prompt` command to dynamically query
+  and select contexts via a new `-c ?` flag.
+
+### Enhancements
+
+- **Model Options Matching**: Improved profile matching by replacing default
+  overwrite prompts with comprehensive checks against all saved `ModelOptions`
+  profiles using `ask_and_send(:symbolize_keys_recursive)`. Added pager display
+  for available profiles via `use_pager` and the ability to switch profiles via
+  `choose_profile_for_model`.
+- **Collection Synchronization**: Enhanced `list_collections` with descriptions
+  and paging, and implemented a `Collection.sync` method to backfill database
+  records during startup.
+- **Command Refactoring**: Renamed `show_session` to `info_session` within the
+  `Commands` module for increased verbosity when no subcommand is provided.
+
+### Bug Fixes & Maintenance
+
+- **Documentation**: 
+    - Clarified that the `checksum` for the `patch_file` tool must be an 8 hex
+      digit long CRC32.
+    - Added YARD `@!attribute` documentation for `links` and `history` in the
+      `Session` model.
+- **Code Cleanup**: 
+    - Replaced `.exists?` and `.first` dataset checks with `.present?` in
+      `model_handling.rb` and `session_management.rb`.
+    - Removed deprecated CLI flags `-c`, `-C`, `-D`, `-M`, and `-E` in favor of
+      interactive management.
+    - Added an `after_destroy` hook to the `Collection` model to purge
+      corresponding `Documentrix` vector data.
+
+## 2026-07-31 v0.0.104
+
+### Changed
+
+#### Added
+
+- Enabled interactive profile creation with duplicate validation by supporting
+  the `allow_new` keyword argument in `choose_profile_for_model`.
+
+#### Changed
+
+- Standardized API naming conventions by renaming the `offer_new_session`
+  parameter to `allow_new` in `session_management.rb` and `choose_session`.
+- Updated `commands.rb` to pass `allow_new: true` to `choose_profile_for_model`
+  during `/model options` and implemented an early return on profile selection
+  cancellation.
+- Renamed the `OllamaChat::Tools::RetrieveDocumentSnippets` class to
+  `SearchKnowledge`.
+- Updated tool registration, default configuration, and descriptions for
+  `search_knowledge` to reference knowledge collections.
+
+#### Fixed
+
+- Adjusted `commands_spec.rb` test cases to reflect updated method signatures
+  and expected behavior for profile selection.
+
 ## 2026-07-30 v0.0.103
 
 ### Added

data/README.md

@@ -83,11 +83,6 @@ Usage: ollama_chat [OPTIONS]
   -n             create a new session
   -u URL         the ollama base url, OLLAMA_URL
   -m MODEL       the ollama model to chat with, OLLAMA_CHAT_MODEL, ?selector
-  -c CHAT        a saved chat conversation to load
-  -C COLLECTION  name of the collection used in this conversation
-  -D DOCUMENT    load document and add to embeddings collection (multiple)
-  -M             use (empty) MemoryCache for this chat session
-  -E             disable embeddings for this chat session
   -S             open a socket to receive input from ollama_chat_send
   -V             display the current version number and quit
   -h             this help
@@ -420,10 +415,10 @@ context, manipulate files, and retrieve external information.
 | **Web/External** | `search_web`, `get_url`, `browse`, `get_rfc`, `get_cve`, `get_endoflife`, `get_ghr`, `get_jira_issue` | Access the internet, fetch specific URLs, and look up technical standards. |
 | **System/Util** | `get_time`, `get_location`, `get_current_weather`, `generate_password`, `compute_bmi`, `roll_dice` | General utility functions for time, location, and simple calculations. |
 | **Editor/Clip** | `copy_to_clipboard`, `paste_from_clipboard`, `paste_into_editor`, `open_file_in_editor` | Bridge the gap between the chat and the system clipboard or editor. |
-| **Knowledge** | `retrieve_document_snippets`, `file_context` | Semantic search for specific snippets vs. broad retrieval of structured project context. |
+| **Knowledge** | `search_knowledge`, `file_context` | Semantic search for specific snippets vs. broad retrieval of structured project context. |
 | **Multimodal** | `generate_image` | Generate images via a local ComfyUI server. |
 
-***Note on Knowledge Tools**: Use `retrieve_document_snippets` for precise,
+***Note on Knowledge Tools**: Use `search_knowledge` for precise,
 low-token semantic discovery and `file_context` for a comprehensive view of
 modules or patterns. Be cautious with broad patterns in `file_context`, as
 importing too many files can exceed the LLM's context window.*

data/lib/ollama_chat/chat.rb

@@ -101,7 +101,7 @@ class OllamaChat::Chat
   # @raise [RuntimeError] If the Ollama API version is less than 0.9.0, indicating
   #   incompatibility with required API features
   def initialize(argv: ARGV.dup)
-    @opts               = go 'f:u:m:c:C:D:l:nMESVh', argv
+    @opts               = go 'f:u:m:l:nSVh', argv
     @opts[?h] and exit usage
     @opts[?V] and exit version
     @ollama_chat_config = OllamaChat::OllamaChatConfig.new(@opts[?f])
@@ -112,14 +112,8 @@ class OllamaChat::Chat
     setup_switches
     setup_state_selectors(config)
     connect_ollama
-    if conversation_file = @opts[?c]
-      messages.load_conversation(conversation_file)
-    else
-      messages.read_conversation_jsonl(session.messages.to_s)
-    end
-    repair_group_uuids
-    embedding_enabled.set(config.embedding.enabled && !@opts[?E])
-    @documents            = setup_documents
+    @documents = setup_documents
+    models::Collection.sync(self)
     @cache                = setup_cache
     @images               = []
     @kramdown_ansi_styles = configure_kramdown_ansi_styles
@@ -221,7 +215,6 @@ class OllamaChat::Chat
   # @return [ Symbol ] the collection name symbol
   def initial_collection
     (
-      @opts[?C] ||
       session&.current_collection.full? ||
       config.embedding.collection.full? ||
       :default
@@ -639,10 +632,6 @@ class OllamaChat::Chat
         redis_url:         config.redis.documents.url?,
         debug:
       )
-
-      document_list = @opts[?D].to_a
-      add_documents_from_argv(document_list)
-      @documents
     else
       NULL
     end

data/lib/ollama_chat/commands.rb

@@ -139,12 +139,13 @@ module OllamaChat::Commands
 
   command(
     name: :model,
-    regexp: %r(^/model(?:\s+(change|options|options from session|options to session))?((?:\s+(?:-m))*)$),
-    complete: [ 'model', %w[ change options options\ from\ session options\ to\ session ] ],
+    regexp: %r(^/model(?:\s+(change|options(?: copy)?|options from session|options to session))?((?:\s+(?:-m))*)$),
+    complete: [ 'model', %w[ change options options\ copy options\ from\ session options\ to\ session ] ],
     help: <<~EOT
       🤖 Manage AI models & profiles:
          - change: Switch active model
          - options: Edit saved profile config
+         - options copy: Copy profile from another model
          - options from session: Save live → Saved
          - options to session: Apply Saved → Live
          -m interactively choose a model
@@ -163,13 +164,17 @@ module OllamaChat::Commands
     end
     opts    = go_command('m', opts)
     model   = opts[?m] ? choose_model('', @model) : @model
-    profile = choose_profile_for_model(model) || 'default'
     case subcommand
     when 'options'
+      profile = choose_profile_for_model(model, allow_new: true) or next :next
       edit_model_options(model, profile:)
+    when 'options copy'
+      copy_model_options_profile(model)
     when 'options from session'
+      profile = choose_profile_for_model(model) || 'default'
       copy_model_options_from_session(model, profile:)
     when 'options to session'
+      profile = choose_profile_for_model(model) || 'default'
       copy_model_options_to_session(model, profile:)
     end
     :next
@@ -274,7 +279,7 @@ module OllamaChat::Commands
   ) do |subcommand, opts, name|
     case subcommand
     when nil
-      show_session
+      info_session
     when 'list'
       list_sessions
     when 'new'
@@ -455,7 +460,7 @@ module OllamaChat::Commands
 
   command(
     name: :prompt,
-    regexp: %r(^/prompt(?:\s+(edit|info|add|delete|list|duplicate|import|export|reset|-e))?(\s+(?:-[ef]|-c\s+\w+))?(?:\s+([^-].*))?$),
+    regexp: %r(^/prompt(?:\s+(edit|info|add|delete|list|duplicate|import|export|reset|-e))?(\s+(?:-[ef]|-c\s+(?:\w+|\?)))?(?:\s+([^-].*))?$),
     complete: [ 'prompt', %w[ edit info add delete list duplicate import export reset ] ],
     optional: true,
     options: '[-c CONTEXT|-e|-f]',
@@ -463,42 +468,61 @@ module OllamaChat::Commands
       📝 Manage prompt templates:
          Subcommands: edit, info, add, delete, list,
          duplicate, import, export, reset.
-         Options: -c [context], -e (edit next)
+         Options: -c [context]
+                     (? for interactive in /prompt),
+                  -e (edit next)
     EOT
   ) do |subcommand, opts, filename|
     opts = go_command('fc:', opts)
+    context = if subcommand.nil? || subcommand == '-e'
+                if opts[?c] == ??
+                  choose_prompt_context
+                else
+                  opts[?c] || 'prompt'
+                end
+              else
+                opts[?c] || choose_prompt_context
+              end
+    unless context
+       STDOUT.puts 'Cancelled.'
+       next :next
+    end
+
     case subcommand
     when 'add'
-      add_new_prompt(context: opts[?c])
+      add_new_prompt(context:)
     when 'delete'
-      choose_and_delete_prompt(context: opts[?c], force: opts[?f])
+      choose_and_delete_prompt(context:, force: opts[?f])
     when 'edit'
-      choose_and_edit_prompt(context: opts[?c])
+      choose_and_edit_prompt(context:)
     when 'list'
-      list_prompts(context: opts[?c])
+      list_prompts(context:)
     when 'duplicate'
-      duplicate_prompt(context: opts[?c])
+      duplicate_prompt(context:)
     when 'import'
-      import_prompt(filename, context: opts[?c])
+      import_prompt(filename, context:)
     when 'export'
-      export_prompt(context: opts[?c])
+      export_prompt(context:)
     when 'info'
-      info_prompt(context: opts[?c])
+      info_prompt(context:)
     when 'reset'
       if prompt = choose_prompt(
           default: true,
-          context: opts[?c],
+          context:,
           prompt: 'Which prompt needs to be restored to its origin? %s'
         )
       then
-        if reset_prompt_to_default(prompt.name, context: opts[?c])
+        if reset_prompt_to_default(prompt.name, context:)
           STDOUT.puts "Reset prompt #{bold{prompt.name}} to default."
         else
           STDOUT.puts "No default value found for prompt #{bold{prompt.name}}."
         end
       end
     when nil, '-e'
-      if prompt = choose_prompt(prompt: 'Which template shall guide the next response? %s').full?(&:to_s)
+      if prompt = choose_prompt(
+          prompt: 'Which template shall guide the next response? %s',
+          context:
+        ).full?(&:to_s)
         if subcommand
           prompt = edit_text(prompt)
           next prompt
@@ -580,13 +604,17 @@ module OllamaChat::Commands
 
   command(
     name: :collection,
-    regexp: %r(^/collection(?:\s+(change|clear|list|rename|update))?$),
-    complete: [ 'collection', %w[ change clear list rename update ] ],
+    regexp: %r(^/collection(?:\s+(change|clear|list|rename|update(?: all)?|new|edit|delete))?$),
+    complete: [ 'collection', %w[ change clear list rename update update\ all new edit delete ] ],
     optional: true,
     help: <<~EOT
       📚 Manage RAG collections:
          - change/clear/list/rename
          - update: Re-index modified docs
+         - update all: Re-index all collections
+         - new: Interactively create a new collection
+         - edit: Interactively update an existing collection
+         - delete: Permanently remove a collection
          - (no subcommand): Show stats
     EOT
   ) do |subcommand|
@@ -599,11 +627,25 @@ module OllamaChat::Commands
       list_collections
     when 'rename'
       rename_collection(collection)
+    when 'update all'
+      results = ''
+      all_collections.pluck(:name).each do |collection|
+        STDOUT.puts "📝 Updating collection #{collection.inspect}… "
+        results << update_collection(collection) << ?\n
+        STDOUT.puts "✅ Done."
+      end
+      results.full? and next results
     when 'update'
-      if results = update_collection
+      if results = update_collection(collection)
         disable_content_parsing
         next results
       end
+    when 'new'
+      create_collection
+    when 'edit'
+      edit_collection
+    when 'delete'
+      delete_collection
     when nil
       collection_stats
     end

data/lib/ollama_chat/database/migrations/007_add_collections_table.rb

@@ -0,0 +1,12 @@
+Sequel.migration do
+  change do
+    create_table :collections do
+      primary_key :id
+      String :name, null: false, unique: true
+      Text :description, null: false
+      Text :patterns # JSON-encoded array of globs
+      DateTime :created_at, default: Sequel::CURRENT_TIMESTAMP, null: false
+      DateTime :updated_at, default: Sequel::CURRENT_TIMESTAMP, null: false
+    end
+  end
+end

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

@@ -0,0 +1,81 @@
+# Represents a document collection stored in the database, allowing for
+# dynamic management of documentrix collections.
+#
+# This model stores collections with a name, description, and patterns
+# for automatic file discovery and synchronization.
+class OllamaChat::Database::Models::Collection < Sequel::Model(OllamaChat::DB)
+  include OllamaChat::Database::Duplicatable
+
+  plugin :timestamps, update_on_create: true
+  plugin :serialization, :json, :patterns
+  plugin :validation_helpers
+
+  # Validates the collection.
+  #
+  # Ensures that the `name` is present and unique.
+  def validate
+    super
+    validates_presence :name
+    validates_unique :name
+    validates_presence :description
+  end
+
+  # Sets the chat instance associated with this collection.
+  #
+  # This allows the collection to interact with the chat's document
+  # store during lifecycle events, such as cleanup upon destruction.
+  #
+  # @param chat [OllamaChat::Chat] the chat instance
+  attr_writer :chat
+
+  # Hook to clean up the corresponding Documentrix collection when
+  # the database record is destroyed.
+  #
+  # This ensures that we don't leave orphaned vector data in the
+  # Documentrix engine when the underlying collection record is removed.
+  def after_destroy
+    super
+    @chat or return
+    @chat.switch_collection(name) do
+      @chat.documents.clear
+    end
+    true
+  end
+
+  # Synchronizes the database records with the Documentrix collections.
+  #
+  # This method iterates through the configured collections in the chat's
+  # document store and ensures that every collection has a corresponding
+  # record in the database. If a collection exists in Documentrix but not
+  # in the database, a new record is created with a default description.
+  #
+  # @param chat [OllamaChat::Chat] the chat instance providing the configuration
+  def self.sync(chat)
+    chat.documents.collections.each do |name|
+      where(name: name.to_s).first and next
+      create(
+        name:        name.to_s,
+        description: "TODO: Describe collection #{name}",
+        patterns:    []
+      )
+    end
+  end
+
+  # @!attribute [v] id
+  #   @return [Integer] The primary key for the collection entry.
+  #
+  # @!attribute [v] name
+  #   @return [String] The name of the collection (matches documentrix name).
+  #
+  # @!attribute [v] description
+  #   @return [String, nil] A description of the collection.
+  #
+  # @!attribute [v] patterns
+  #   @return [Array, nil] An array of glob patterns for file discovery.
+  #
+  # @!attribute [v] created_at
+  #   @return [Time, nil] The timestamp when the collection was created.
+  #
+  # @!attribute [v] updated_at
+  #   @return [Time, nil] The timestamp of the last update to the collection.
+end

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

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

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

@@ -137,6 +137,12 @@ class OllamaChat::Database::Models::Session < Sequel::Model(OllamaChat::DB)
   # @!attribute [v] messages
   #   @return [String] The full conversation history, stored in JSONL format.
   #
+  # @!attribute [v] links
+  #   @return [String] A text field storing links associated with the session.
+  #
+  # @!attribute [v] history
+  #   @return [String] A text field storing the history for the session.
+  #
   # @!attribute [v] created_at
   #   @return [Time, nil] The timestamp when the session was created.
   #

data/lib/ollama_chat/information.rb

@@ -72,6 +72,7 @@ module OllamaChat::Information
   #
   # @param output [IO] the output stream to write the message to
   def collection_stats(output: STDOUT)
+    col          = database_collection?(collection)
     length       = (Tins::Terminal.cols - 10).clamp(0..)
     wrapped_tags = Kramdown::ANSI::Width.
       wrap(@documents.tags.to_a.join(', '), length:).
@@ -79,6 +80,7 @@ module OllamaChat::Information
     output.puts <<~EOT
       Current Collection
         Name: #{bold{collection}}
+        Patterns: #{italic{col&.patterns&.join(' ')}}
         #Embeddings: #{@documents.size}
         #Tags: #{@documents.tags.size}
         Tags:
@@ -235,11 +237,6 @@ module OllamaChat::Information
         -n             create a new session
         -u URL         the ollama base url, OLLAMA_URL
         -m MODEL       the ollama chat model, OLLAMA_CHAT_MODEL, ?selector
-        -c CHAT        a saved chat conversation to load
-        -C COLLECTION  name of the collection used in this conversation
-        -D DOCUMENT    load document and add to embeddings collection (multiple)
-        -M             use (empty) MemoryCache for this chat session
-        -E             disable embeddings for this chat session
         -S             open a socket to receive input from ollama_chat_send
         -V             display the current version number and quit
         -h             this help
@@ -297,6 +294,21 @@ module OllamaChat::Information
     config.infobar.message.to_h
   end
 
+  # Retrieves a hash of collection names and their descriptions from the
+  # database.
+  #
+  # This is used to provide context to the AI model about available RAG
+  # collections.
+  #
+  # @return [Hash{String => String}] a hash mapping collection names to their
+  #   descriptions
+  def collection_descriptions
+    cols = models::Collection.select(:name, :description).order(:name)
+    cols.each_with_object({}) do |c, hash|
+      hash[c.name] = c.description
+    end
+  end
+
   # Generates a hash containing static runtime information.
   #
   # This method collects session-level constants including the user,
@@ -307,7 +319,7 @@ module OllamaChat::Information
   def static_runtime_information_values
     {
       client:               ,
-      collections:          JSON.pretty_generate(config.embedding.collection_descriptions?),
+      collections:          JSON.pretty_generate(collection_descriptions),
       current_directory:    Pathname.pwd.expand_path.to_path,
       languages:            config.languages * ', ',
       location:             location.on?.full? { location_description } || 'n/a',

data/lib/ollama_chat/model_handling.rb

@@ -172,6 +172,37 @@ module OllamaChat::ModelHandling
     STDOUT.puts "Model options #{italic{profile}} of #{bold{model_name}} were copied to session model options."
   end
 
+  # Interactively copies model options from a source model/profile to the
+  # current model/profile. Displays a side-by-side comparison if the
+  # destination profile already exists and prompts for override confirmation.
+  #
+  # @param model [String] the destination model for the copied options
+  def copy_model_options_profile(model)
+    src_model   = choose_model('', model)
+    src_profile = choose_profile_for_model(src_model) || 'default'
+    dst_model   = model
+    dst_profile = choose_profile_for_model(dst_model, allow_new: true) || src_profile
+
+    src_opts = get_stored_model_options(src_model, profile: src_profile).full? or return
+
+    dst_opts = get_stored_model_options(dst_model, profile: dst_profile)
+    if dst_opts.present?
+      STDOUT.puts "Profile #{italic{dst_profile}} already exists for #{bold{dst_model}}."
+      STDOUT.puts "\n📥 Source (#{src_model}/#{src_profile}):"
+      STDOUT.puts JSON.pretty_generate(src_opts)
+      STDOUT.puts "\n📤 Destination (#{dst_model}/#{dst_profile}):"
+      STDOUT.puts JSON.pretty_generate(dst_opts)
+
+      unless confirm?(prompt: "⚠️ Override existing profile? (y/n) ", yes: /\Ay/i)
+        STDOUT.puts "Cancelled."
+        return
+      end
+    end
+
+    store_model_options(dst_model, src_opts, profile: dst_profile)
+    STDOUT.puts "✅ Copied options from #{italic{src_model}}/#{italic{src_profile}} to #{bold{dst_model}}/#{italic{dst_profile}}."
+  end
+
   # Presents an interactive list of stored configuration profiles for the
   # specified model and prompts the user to select one.
   #
@@ -181,14 +212,27 @@ module OllamaChat::ModelHandling
   #
   # @param model_name [String] the name of the model whose profiles are to be listed
   # @return [String, nil] the selected profile name, or `nil` if none was chosen
-  def choose_profile_for_model(model_name)
+  def choose_profile_for_model(model_name, allow_new: false)
     profiles = models::ModelOptions.where(model_name:).order(:profile).map(&:profile)
-    profiles.size < 2 and return profiles.first
-    profiles = [ '[EXIT]' ] + profiles
+
+    if allow_new
+      profiles = [ '[EXIT]', '[NEW]' ] + profiles
+    else
+      profiles.size < 2 and return profiles.first
+      profiles = [ '[EXIT]' ] + profiles
+    end
+
     case chosen = choose_entry(profiles, prompt: "Choose profile for #{bold{model_name}}: %s")
     when '[EXIT]', nil
       STDOUT.puts "Cancelled."
       return
+    when '[NEW]'
+      name = ask?(prompt: 'Enter new profile name: ') or return
+      if models::ModelOptions.where(model_name:, profile: name).present?
+        STDERR.puts "Profile #{name.inspect} already exists!"
+        return
+      end
+      name
     else
       chosen
     end
@@ -307,16 +351,32 @@ module OllamaChat::ModelHandling
         session.update(model_options: default_model_options)
       end
     elsif !keep_options && session_model_options != stored_model_options
-      STDOUT.puts <<~EOT
-          ⚠️ Session model options differ from defaults for model #@model!
-          Session model options:
-          #{JSON.pretty_generate(session_model_options)}
-          Default model options:
-          #{JSON.pretty_generate(stored_model_options)}
-      EOT
-      confirm?(
-          prompt: "❓ Overwrite session model options with defaults? (y/n) ", yes: /\Ay/i
-      ) and session.update(model_options: stored_model_options)
+      all_profiles = models::ModelOptions.where(model_name: @model).
+        order(:profile).all
+
+      matching = all_profiles.any? do |mo|
+        mo.options.ask_and_send(:symbolize_keys_recursive) == session_model_options
+      end
+
+      unless matching
+        use_pager do |output|
+          output.puts "⚠️ Session model options differ from current profile (#{italic{profile}}) and don't match any saved profile!"
+          output.puts "\n📋 Available profiles for #{bold{@model}}:"
+          all_profiles.each do |mo|
+            output.puts "\n📄 #{italic{mo.profile}}:"
+            output.puts JSON.pretty_generate(mo.options.ask_and_send(:symbolize_keys_recursive))
+          end
+        end
+
+        if confirm?(prompt: "\n❓ Switch to an existing profile? (y/n) ", yes: /\Ay/i)
+          chosen = choose_profile_for_model(@model)
+          if chosen
+            new_opts = get_stored_model_options(@model, profile: chosen)
+            session.update(model_options: new_opts)
+            STDOUT.puts "Switched to profile #{italic{chosen}}."
+          end
+        end
+      end
     end
   end
 

data/lib/ollama_chat/ollama_chat_config/default_config.yml

@@ -57,7 +57,7 @@ prompts:
       - Current directory is "%{current_directory}"
       - Client is %{client}.
       - These tools have access to these allowed paths: %{tool_paths_allowed}
-      - Search in these collections with `retrieve_document_snippets`: %{collections}
+      - Search in these collections with `search_knowledge`: %{collections}
     dynamic_runtime_info: |
       There is usually no reason to mention this information to the user unless
       asked about it.
@@ -525,7 +525,7 @@ tools:
       default: true
       allowed:
         - './tmp'
-    retrieve_document_snippets:
+    search_knowledge:
       result_display_timeout: 3
       default: true
     compute_bmi:

data/lib/ollama_chat/prompt_management.rb

@@ -21,6 +21,27 @@ module OllamaChat::PromptManagement
     end
   end
 
+  # The choose_prompt_context method presents a menu of available prompt
+  # contexts for selection. It allows the user to choose between 'prompt',
+  # 'system', and 'suggest' contexts.
+  #
+  # @return [String, nil] the selected context name, or nil if the user
+  #   cancels the selection.
+  def choose_prompt_context
+    contexts = models::Prompt.group(:context).order(:context).pluck(:context)
+    contexts.unshift('[EXIT]')
+    case chosen = choose_entry(
+      contexts,
+      prompt: '📝 Which prompt context shall we work in? %s'
+    )
+    when '[EXIT]', nil
+      STDOUT.puts "Exiting chooser."
+      return
+    else
+      chosen
+    end
+  end
+
   # The choose_prompt method presents a menu of available prompts for
   # selection. It retrieves the list of prompt names from the database, adds an
   # '[EXIT]' option, and displays them via the Chooser utility.