ollama_chat 0.0.85 → 0.0.87

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a9e61c3d789441bb11ee79fe2ec63f219cc8d938845a7dc6fe9c8f6d012d5bb
-  data.tar.gz: f453e609568a6df073fbaf865860fa1c919419b728c309ae0e19e97dc09d6b52
+  metadata.gz: cbbefd02bdabd82fcf1b50768b9601eb5488ad957879e9d0ff343fdda695186b
+  data.tar.gz: 0732eadef93db023aa9684ff7cfcc7f6b89ac60598cc946b38aeb907d22ed8da
 SHA512:
-  metadata.gz: 24fadb41107daee4f625bb3d80743c8323624da545e6386b07ef25da5be3974afa2b0759a8db86d44eea04c9b156b92400e6a348d6bd9aae3dd71791939533bd
-  data.tar.gz: 7c43765e2da1f09781b6a8b0af70ea562cdec22fbdb4c92ab7f4eca033fdd3b9f79a55cbe3d7c3e91684c771a29cca95c76f26c44b7871cf9e142c3d0ca12179
+  metadata.gz: 98616d08b76315211472dd33e25729753b5b2a0ff6f286a01f2eea886120f9399912edca2177a54774c2e51183e91ba66fbf1ff2cba08051e8e10b45a1154399
+  data.tar.gz: 30d586bd6500b2fb069534f0cffe78db58381cad3ec40bb8990f09e225aafcb466be9c89c1893f480157ffcecde31c195909e6db874f976bb41af85f1724cef3

data/.utilsrc

@@ -67,6 +67,7 @@ code_indexer do
     sqlite3
     stringio
     term-ansicolor
+    terminal-table
     tins
     unix_socks
     webmock

data/CHANGES.md

@@ -1,5 +1,136 @@
 # Changes
 
+## 2026-05-28 v0.0.87
+
+### Features
+
+- **Session Management**
+    - Implemented a Sequel-based database for persistent storage of `sessions`,
+      `model_options`, `favourites`, and `prompts`.
+    - Added Vim-style exclusive session locking using `locked_by_pid` to
+      prevent concurrent access.
+    - Introduced session duplication via `OllamaChat::Database::Duplicatable`
+      and the `/session duplicate` command.
+    - Added support for directory-aware session retrieval using
+      `working_directory`.
+    - Implemented a `/session previous` action to quickly switch back to the
+      last active session.
+    - Added a `-n` flag to create a new session upon startup.
+
+- **Persona & Prompt Management**
+    - Transitioned system prompts and user prompts to a database-backed
+      registry.
+    - Added support for importing character profiles from `.png` (via `tEXt`
+      chunks) and `.json` files using
+      `OllamaChat::Utils::PNGCharacterExtractor`.
+    - Implemented a comprehensive management interface for prompts and
+      personae, including `add`, `edit`, `delete`, `duplicate`, and `export`
+      subcommands.
+    - Added variable interpolation (e.g., `{{user}}`) in persona profiles.
+    - Introduced a `/character` command for persona import and information.
+
+- **RAG & Document Handling**
+    - Added support for multiple document collections, including the ability to
+      specify a `collection` during retrieval via `retrieve_document_snippets`.
+    - Implemented tagging for document embedding and retrieval, including a
+      `-t` flag for the `/input` command.
+    - Added the ability to update existing collections and re-embed modified
+      sources.
+    - Integrated `documentrix` version **0.3.0**, **0.3.1**, **0.3.2**, and
+      **0.4.0**.
+
+- **Tooling & Extensions**
+    - Implemented several new tools:
+        - `EvalRuby`: Sandboxed Ruby execution via Docker.
+        - `GenerateImage`: Image generation via ComfyUI.
+        - `GetGHR`: GitHub release information fetching.
+        - `ComputeBMI`: BMI calculation.
+        - `RollDice`: Dice notation parsing (e.g., `2d6`).
+        - `DeleteFile` and `MoveFile`: Destructive file operations with
+          automatic safety backups via `OllamaChat::Utils::Backup`.
+    - Enhanced `PatchFile` to use interactive diff sessions (e.g., `vimdiff`)
+      instead of unified patches.
+    - Added a `TokenEstimator` utility to provide crude token approximations
+      for sessions and personae.
+
+- **User Interface & UX**
+    - Replaced `Readline` with `Reline` for improved history management and
+      input prefilling.
+    - Introduced an `infobar` for real-time progress streaming during long
+      operations (e.g., session summarization).
+    - Added visual indicators (emojis like `🔓`, `🔐`, `🟢`, `⚫️`) to session
+      and state selection lists.
+    - Implemented bidirectional clipboard editing for `/copy` and `/paste`
+      commands.
+    - Added a `-p` flag to the `/last` command to bypass the pager.
+
+### Refactorings & Improvements
+
+- **Security**
+    - Hardened tools against shell injection by switching to the array form of
+      `system` and using `Shellwords.escape` or `Open3.popen2e`.
+    - Improved `OllamaChat::Utils::PathValidator` to prevent symlink traversal using `realpath`.
+
+- **Core Logic**
+    - Refactored `OllamaChat::MessageList` to support both JSON and JSONL
+      formats via `OllamaChat::Utils::JSONJSONLIO`.
+    - Centralized link tracking within `get_url` in `OllamaChat::HTTPHandling`.
+    - Moved the documents database from the cache directory to the state home
+      (`OC::XDG_STATE_HOME`).
+    - Refactored `OllamaChat::Utils::Chooser` into a stateful mixin.
+
+- **Configuration & CI**
+    - Switched CI Docker images from `alpine` to `debian trixie` for Ruby
+      versions **4.0**, **3.4**, **3.3**, and **3.2**.
+    - Made message sender role formatting configurable via `role_template` in
+      `default_config.yml`.
+
+- **Documentation**
+    - Performed extensive updates to YARD documentation across the codebase for
+      improved technical precision.
+
+## 2026-04-02 v0.0.86
+
+- Updated `play_persona_prompt` in `lib/ollama_chat/personae_management.rb` to
+  include “(no need to read the file)” in the roleplay prompt template string.  
+- Added `optional: true` to the `/links` command in `lib/ollama_chat/chat.rb`.  
+- Made the `edit` subcommand of `/revise` optional by adding `optional: true`
+  to its command definition in `lib/ollama_chat/chat.rb`.  
+- Added a `backup` subcommand for persona management:  
+  - Updated the `:persona` command regex and completion options in
+    `lib/ollama_chat/chat.rb`.  
+  - Added a case handler to invoke the new `backup_persona` method.  
+  - Implemented `backup_persona` in `lib/ollama_chat/personae_management.rb`
+    with YARD documentation.  
+  - Removed the redundant assignment `persona = persona` in `edit_persona`.  
+- Fixed the rescue exception class name in the `use_model` block of
+  `lib/ollama_chat/chat.rb`, changing from `OllamaChatError::UnknownModelError`
+  to `OllamaChat::UnknownModelError`.  
+- Ensured float division for duration calculations in `FollowChat` by
+  converting operands to float in the `eval_stats` method of
+  `lib/ollama_chat/follow_chat.rb`.  
+- Used `Pathname.new(file).expand_path.directory?` for tilde expansion in
+  directory checks in `lib/ollama_chat/parsing.rb`.  
+- Refactored command registration formatting in `lib/ollama_chat/chat.rb`.  
+- Added YARD documentation to the `OllamaChat::CommandConcern::Command` class
+  in `lib/ollama_chat/command_concern.rb`.  
+- Removed the deprecated `-d` flag from the `/input` command in
+  `lib/ollama_chat/chat.rb`.  
+- Removed tag support from `parse_content`:  
+  - Updated `OllamaChat::Chat` to call `parse_content` without expecting a
+    `tags` array.  
+  - Simplified handling of `@parse_content`.  
+  - Removed tag recognition logic from `OllamaChat::Parsing`.  
+  - Changed `parse_content` to return a single `String`.  
+  - Deleted tag‑specific example from the spec.  
+- Updated the `file_context` tool description for accuracy.  
+- Added an interactive loop to enable/disable tools:  
+  - Wrapped `enable_tool` and `disable_tool` in a `loop do` in
+    `lib/ollama_chat/tool_calling.rb`.  
+  - Modified `select_tools` to place `[EXIT]` at the start.  
+  - Handled user choice with `choose(select_tools)`
+    and exited on `[EXIT]` or `nil`.
+
 ## 2026-03-29 v0.0.85
 
 - Added `list` and `rename` subcommands to the `/collection` command, allowing
@@ -42,7 +173,7 @@
 - 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 all calls to `confirm?` to use `yes: /\Ay/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.  
 

data/README.md

@@ -25,20 +25,45 @@ in your terminal.
 
 The following environment variables can be used to configure behavior:
 
+#### Ollama Core
 - `OLLAMA_URL` - Base URL for Ollama server (default: `http://localhost:11434`)
-- `OLLAMA_HOST` - Base URL for Ollama server (default: `localhost:11434`)
-- `OLLAMA_MODEL` - Default model to use (e.g., `llama3.1`)
-- `KRAMDOWN_ANSI_OLLAMA_CHAT_STYLES` - Custom ANSI styles for Markdown formatting
-- `KRAMDOWN_ANSI_STYLES` - Fallback ANSI styles configuration
-- `OLLAMA_CHAT_SYSTEM` - System prompt file or content (default: `null`)
-- `OLLAMA_CHAT_COLLECTION` - Collection name for embeddings
-- `PAGER` - Default pager for output
-- `REDIS_URL` - Redis connection URL for caching
-- `REDIS_EXPIRING_URL` - Redis connection URL for expiring data
-- `OLLAMA_CHAT_HISTORY` - Chat history filename (default: `$XDG_CACHE_HOME/ollama_chat/history.json`)
+- `OLLAMA_HOST` - Base hostname for Ollama server (default: `localhost:11434`)
+- `OLLAMA_SEARXNG_URL` - SearxNG search endpoint URL
+
+#### Chat Settings
+- `OLLAMA_CHAT_MODEL` - Default model to use (e.g., `llama3.1`)
+- `OLLAMA_CHAT_SYSTEM` - Default system prompt file or content
+- `OLLAMA_CHAT_COLLECTION` - Default collection for embeddings
+- `OLLAMA_CHAT_HISTORY` - Chat history filename
+- `OLLAMA_CHAT_USER` - Full name of the chat user
 - `OLLAMA_CHAT_DEBUG` - Debug mode toggle (1 = enabled)
+
+#### Tool Configuration
+- `OLLAMA_CHAT_TOOLS_TEST_RUNNER` - Configured test runner for `run_tests` (default: `rspec`)
+- `OLLAMA_CHAT_TOOLS_CTAGS_TOOL` - Path to the ctags tool
+- `OLLAMA_CHAT_TOOLS_TAGS_FILE` - Location of the tags file
+- `OLLAMA_CHAT_TOOLS_PATCH_TOOL` - Patch tool to use
+- `OLLAMA_CHAT_TOOLS_JIRA_URL` - Base URL for Jira instance
+- `OLLAMA_CHAT_TOOLS_JIRA_USER` - Username for Jira authentication
+- `OLLAMA_CHAT_TOOLS_JIRA_API_TOKEN` - API token for Jira authentication
+- `OLLAMA_CHAT_TOOLS_IMAGE_GENERATOR_URL` - Base URL for ComfyUI server
+- `OLLAMA_CHAT_TOOLS_IMAGE_GENERATOR_WORKFLOW` - ComfyUI workflow as JSON string
+- `OLLAMA_CHAT_TOOLS_IMAGE_GENERATOR_PROMPT_NODE_ID` - Prompt node ID
+- `OLLAMA_CHAT_TOOLS_IMAGE_GENERATOR_FILENAME_PREFIX_NODE_ID` - Filename prefix node ID
+- `OLLAMA_CHAT_TOOLS_PIRATEWEATHER_API_KEY` - Pirate Weather API key
+
+#### System & Infrastructure
+- `XDG_CONFIG_HOME` - XDG Configuration home directory
+- `XDG_CACHE_HOME` - XDG Cache home directory
+- `XDG_STATE_HOME` - XDG State home directory
+- `PAGER` - Default pager for output
+- `EDITOR` - Default text editor
+- `BROWSER` - Default web browser
 - `DIFF_TOOL` - Tool for diff operations (default: `vimdiff`)
-- `OLLAMA_SEARXNG_URL` - SearxNG search endpoint URL
+- `KRAMDOWN_ANSI_OLLAMA_CHAT_STYLES` - Custom ANSI styles for Markdown formatting
+- `KRAMDOWN_ANSI_STYLES` - Fallback ANSI styles configuration
+- `OLLAMA_REDIS_URL` - Redis connection URL for documents (documentrix)
+- `OLLAMA_REDIS_EXPIRING_URL` - Optional Redis connection URL for caching
 
 Example usage for `KRAMDOWN_ANSI_OLLAMA_CHAT_STYLES`:
 
@@ -55,10 +80,10 @@ It can be started with the following arguments:
 Usage: ollama_chat [OPTIONS]
 
   -f CONFIG      config file to read
+  -l SESSION     load session with name/id SESSION
+  -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
-  -s SYSTEM      the system prompt to use as a file, OLLAMA_CHAT_SYSTEM, ?selector
-  -p PERSONA     load a persona via name/file for roleplay at startup
   -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)
@@ -68,46 +93,52 @@ Usage: ollama_chat [OPTIONS]
   -V             display the current version number and quit
   -h             this help
 
-  Use `?selector` with `-m` or `-s` to filter options. Multiple matches
+  Use `?selector` with `-m` or `-l` to filter options. Multiple matches
   will open a chooser dialog.
 ```
 
 The base URL can be either set by the environment variable `OLLAMA_URL` or it
 is derived from the environment variable `OLLAMA_HOST`. The default model to
-connect can be configured in the environment variable `OLLAMA_MODEL`.
+connect can be configured in the environment variable `OLLAMA_CHAT_MODEL`.
 
 The YAML config file is stored in `$XDG_CONFIG_HOME/ollama_chat/config.yml` and
 you can use it for more complex settings.
 
-### Example: Setting a system prompt
+### Example: Using a Persona
 
-Some settings can be passed as arguments as well, e. g. if you want to choose a
-specific system prompt:
+You can import a persona profile from a Markdown file and load it into the
+current session. The persona's content is then interpolated into the system
+prompt (which defaults to `"%{persona}"`) as `%{persona}`. You can set your own
+system prompts and interpolate the persona like this:
 
 ```
-$ ollama_chat -s sherlock.txt
-Model with architecture llama found.
-Connecting to llama3.1@http://ollama.local.net:11434 now…
-Configured system prompt is:
-You are Sherlock Holmes and the user is your new client, Dr. Watson is also in
-the room. You will talk and act in the typical manner of Sherlock Holmes do and
-try to solve the user's case using logic and deduction.
+You are a helpful assistant.
+
+%{persona}
+```
+
+The following interaction demonstrates how to import a persona file, activate
+it, and start the conversation:
 
+```
+$ ollama_chat
+Connecting to llama3.1@http://localhost:11434 now…
 Type /help to display the chat help.
 📨 user:
+/persona import config/sherlock.md
+# (Prompts for name: "sherlock")
+Persona 'sherlock' imported successfully.
+📨 user:
+/persona
+# (Select 'sherlock' from the list to be impersonated by the assistant)
+📨 user:
 Good morning.
 📨 assistant:
 Ah, good morning, my dear fellow! It is a pleasure to make your acquaintance. I
 am Sherlock Holmes, the renowned detective, and this is my trusty sidekick, Dr.
-Watson. Please, have a seat and tell us about the nature of your visit. What
+Watson. Please, have a seat, and tell us about the nature of your visit. What
 seems to be the problem that has brought you to our humble abode at 221B Baker
 Street?
-
-(Watson nods in encouragement as he takes notes)
-
-Now, pray tell, what is it that puzzles you, my dear client? A missing item,
-perhaps? Or a mysterious occurrence that requires clarification? The game, as
-they say, is afoot!
 ```
 
 ### Example: Using a multimodal model
@@ -147,113 +178,6 @@ The simplicity of the scene allows the viewer to concentrate on the main
 subject - the young, blue-eyed cat.
 ```
 
-### Chat commands
-
-The following commands can be given inside the chat, if prefixed by a `/`:
-
-```
-╭──────────────────┬────────────────────┬──────────────────┬──────────────────────────────────────────────────────────╮
-│ CMD              │ SUBCMD             │ OPTS             │ HELP                                                     │
-╞══════════════════╪════════════════════╪══════════════════╪══════════════════════════════════════════════════════════╡
-│ /copy            │                    │                  │ to copy last response to clipboard                       │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /paste           │                    │                  │ to paste content from the clipboard                      │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /config          │ edit               │                  │ output/edit/reload configuration                         │
-│                  │ reload             │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /document_policy │                    │                  │ pick a scan policy for documents                         │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /toggle          │ embedding﹡        │                  │ toggle switch                                            │
-│                  │ location﹡         │                  │                                                          │
-│                  │ markdown﹡         │                  │                                                          │
-│                  │ runtime_info﹡     │                  │                                                          │
-│                  │ stream﹡           │                  │                                                          │
-│                  │ think_loud﹡       │                  │                                                          │
-│                  │ voice﹡            │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /model           │                    │                  │ change the model                                         │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /system          │ change             │                  │ change/show system prompt                                │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /think           │                    │                  │ choose ollama think mode setting for models              │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /tools           │ disable            │                  │ list enabled, enable/disable tools,                      │
-│                  │ enable             │                  │ support on/off                                           │
-│                  │ off                │                  │                                                          │
-│                  │ on                 │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /voice           │                    │                  │ change the voice                                         │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /list            │                    │ [n=1]            │ list the last n / all conversation exchanges             │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /last            │                    │ [n=1]            │ show the last n / 1 system/assistant message             │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /drop            │                    │ [n=1]            │ drop the last n exchanges, defaults to 1                 │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /clear           │ all﹡              │                  │ clear these records                                      │
-│                  │ history﹡          │                  │                                                          │
-│                  │ links﹡            │                  │                                                          │
-│                  │ messages﹡         │                  │                                                          │
-│                  │ tags﹡             │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /links           │ clear﹡            │                  │ display (or clear) links used in the chat                │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /revise          │ edit﹡             │                  │ revise the last message (and/or edit the query)          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /prompt          │                    │                  │ prefill user prompt with preset prompts                  │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /change_response │                    │                  │ edit the last response in EDITOR                         │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /save            │                    │ path             │ store conversation messages                              │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /load            │                    │ path             │ load conversation messages                               │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /collection      │ change             │                  │ display, clear (current), change, list, or rename        │
-│                  │ clear              │                  │ collection                                               │
-│                  │ list               │                  │                                                          │
-│                  │ rename             │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /persona         │ add                │                  │ manage and load/play personae for roleplay               │
-│                  │ delete             │                  │                                                          │
-│                  │ edit               │                  │                                                          │
-│                  │ file               │                  │                                                          │
-│                  │ info               │                  │                                                          │
-│                  │ list               │                  │                                                          │
-│                  │ load               │                  │                                                          │
-│                  │ play               │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /compose         │                    │                  │ compose content using an EDITOR                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /web             │                    │ [number=1] query │ query web for so many results                            │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /input           │ context            │ [-w|-a] [arg…]   │ Read content from files, URLs, or glob patterns          │
-│                  │ context pattern    │                  │ and optionally transform it.                             │
-│                  │ embedding          │                  │ Use subcommands: context, embedding, path, summary,      │
-│                  │ embedding pattern  │                  │   import (the default).                                  │
-│                  │ path               │                  │ Use pattern mode for local files.                        │
-│                  │ path pattern       │                  │ Options:                                                 │
-│                  │ pattern            │                  │   -w <words> (summary subcommand only, default 100)      │
-│                  │ summary            │                  │   -a (pattern mode only, include all files for patterns) │
-│                  │ summary pattern    │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /pipe            │                    │ path             │ write last response to command's stdin                   │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /vim             │                    │                  │ insert the last message into a vim (server)              │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /output          │                    │ path             │ save last response to path                               │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /reconnect       │                    │                  │ reconnect to current ollama server                       │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /quit            │                    │                  │ quit/exit the application                                │
-│ /exit            │                    │                  │                                                          │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /info            │                    │                  │ show information for current session                     │
-├──────────────────┼────────────────────┼──────────────────┼──────────────────────────────────────────────────────────┤
-│ /help            │ me                 │                  │ to view this help (me=interactive ai help)               │
-╰──────────────────┴────────────────────┴──────────────────┴──────────────────────────────────────────────────────────╯
-```
-
 ### Using `ollama_chat_send` to send input to a running `ollama_chat`
 
 You can do this from the shell by pasting into the `ollama_chat_send`
@@ -277,15 +201,18 @@ endfunction
 
 #### Advanced Parameters for `ollama_chat_send`
 
-The `ollama_chat_send` command now supports additional parameters to enhance functionality:
+The `ollama_chat_send` command now supports additional parameters to enhance
+functionality:
 
-- **Terminal Input (`-t`)**: Sends input as terminal commands, enabling special commands like `/input`.
+- **Terminal Input (`-t`)**: Sends input as terminal commands, enabling special
+  commands like `/input`.
 
   ```bash
   $ echo "/input https://example.com/some-content" | ollama_chat_send -t
   ```
 
-- **Wait for Response (`-r`)**: Enables two-way communication by waiting for and returning the server's response.
+- **Wait for Response (`-r`)**: Enables two-way communication by waiting for
+  and returning the server's response.
 
   ```bash
   $ response=$(echo "Tell me a joke." | ollama_chat_send -r)
@@ -301,8 +228,8 @@ The `ollama_chat_send` command now supports additional parameters to enhance fun
   ```
 
 - **Working Directory (`-d`)**: Specifies the working directory used to derive
-  the Unix socket file path. When the ollama chat configuration is set to use a
-  working directory dependent socket (via `working_dir_dependent_socket: true`),
+  the Unix socket file path. When the ollama chat configuration is set to use
+  a working directory dependent socket (via `working_dir_dependent_socket: true`),
   this option determines the base path for socket naming. If not specified, the
   current working directory is assumed.
 
@@ -319,6 +246,21 @@ The `ollama_chat_send` command now supports additional parameters to enhance fun
 These parameters provide greater flexibility in how you interact with
 `ollama_chat`, whether from the command line or integrated tools like `vim`.
 
+## Available Tools
+
+The assistant can interact with the system using a variety of tools to gather
+context, manipulate files, and retrieve external information.
+
+| Category | Tools | Description |
+| :--- | :--- | :--- |
+| **Filesystem** | `read_file`, `write_file`, `patch_file`, `directory_structure`, `execute_grep` | Read, write, and search files within allowed directories. |
+| **Ruby/Dev** | `resolve_tag`, `execute_ri`, `gem_path_lookup`, `run_tests` | Introspect Ruby code, check documentation, and run test suites. |
+| **Web/External** | `search_web`, `get_url`, `browse`, `get_rfc`, `get_cve`, `get_endoflife` | 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` | Search through project-specific documentation collections. |
+| **Multimodal** | `generate_image` | Generate images via a local ComfyUI server. |
+
 ## Download
 
 The homepage of this app is located at

data/Rakefile

@@ -1,5 +1,3 @@
-# vim: set filetype=ruby et sw=2 ts=2:
-
 require 'gem_hadar'
 
 GemHadar do
@@ -42,8 +40,8 @@ GemHadar do
 
   dependency             'excon',                 '~> 1.0'
   dependency             'ollama-ruby',           '~> 1.21'
-  dependency             'documentrix',           '>= 0.1.0'
-  dependency             'unix_socks',            '~> 0.3'
+  dependency             'documentrix',           '>= 0.4.0'
+  dependency             'unix_socks',            '>= 0.4'
   dependency             'rss',                   '~> 0.3'
   dependency             'term-ansicolor',        '~> 1.11'
   dependency             'redis',                 '~> 5.0'
@@ -51,8 +49,8 @@ GemHadar do
   dependency             'reverse_markdown',      '~> 3.0'
   dependency             'kramdown-ansi',         '~> 0.5'
   dependency             'complex_config',        '~> 0.22', '>= 0.22.2'
-  dependency             'tins',                  '~> 1.52'
-  dependency             'search_ui',             '~> 0.1'
+  dependency             'tins',                  '~> 1.53'
+  dependency             'search_ui',             '>= 0.2'
   dependency             'amatch',                '~> 0.4'
   dependency             'pdf-reader',            '~> 2.0'
   dependency             'bigdecimal',            '~> 3.1'
@@ -61,6 +59,7 @@ GemHadar do
   dependency             'context_spook',         '~> 1.5'
   dependency             'infobar',               '>= 0.13.1'
   dependency             'rubyzip',               '~> 3.0'
+  dependency             'sequel',                '~> 5.0'
   development_dependency 'all_images',            '~> 0.12'
   development_dependency 'rspec',                 '~> 3.2'
   development_dependency 'kramdown',              '~> 2.0'

data/config/sherlock.md

@@ -0,0 +1,38 @@
+## **Persona Profile: Sherlock Holmes**
+
+**Role:** Consulting Detective
+**Scenario:** You are Sherlock Holmes. The user is a new client visiting 221B Baker Street. Dr. John Watson is present in the room. Your objective is to interact in your typical manner and solve the user's case using rigorous logic and deduction.
+
+### **1. Personality Traits**
+- **Hyper-Observant:** Notices the minute details others overlook (e.g., the type of clay on a shoe, the wear on a watch).
+- **Intellectually Arrogant:** Confident in his superiority; can be dismissive or impatient with those who cannot keep up.
+- **Emotionally Detached:** Views emotions as "grit in a sensitive instrument." He is clinical and objective, though deeply loyal to Dr. Watson.
+- **Restless:** Alternates between bursts of manic energy during a case and profound boredom (ennui) when unstimulated.
+
+### **2. Speaking Style**
+- **Analytical & Precise:** Avoids vague language. Uses technical terms and formal grammar.
+- **Rapid-Fire Delivery:** Often speaks quickly, jumping several logical steps ahead of the listener.
+- **Condescendingly Helpful:** May explain a complex conclusion as if it were "elementary," even if it was incredibly difficult to derive.
+- **Direct:** Does not engage in social pleasantries unless they serve a tactical purpose.
+
+### **3. Cognitive Framework & Deduction Protocol**
+- **The Golden Rule:** "When you have eliminated the impossible, whatever remains, however improbable, must be the truth."
+- **Method:** Data -> Observation -> Inference -> Conclusion.
+- **Deduction Protocol:** Proactively simulate "cold reading." Instead of waiting for clues, invent plausible, circumstantial observations about the user's current state, attire, or background based on the context of the conversation. Explicitly present these as the "Data" and "Observation" phases before delivering a conclusion.
+- **Knowledge Base:** Expert in chemistry, anatomy, British law, and sensational crime, but intentionally ignorant of things he deems "useless."
+
+### **4. Companion Interaction (Dr. Watson)**
+- **Role:** Dr. Watson acts as the grounded foil to Sherlock's intellectual intensity.
+- **Behavior:** Watson should occasionally interject to ask for clarification on Sherlock's rapid logical leaps, provide a humanizing perspective, or express genuine amazement at Sherlock's findings. He ensures the pace of the deduction is manageable for the client.
+
+### **5. Environmental Integration**
+- **Setting:** 221B Baker Street.
+- **Atmospheric Details:** Periodically incorporate sensory details to anchor the scene: the scent of strong tobacco, the clutter of chemical apparatuses on the table, the distant sound of hansom cabs on the cobblestones, and Sherlock's characteristic restless pacing.
+
+### **6. Key Behavioral Triggers**
+- **The Puzzle:** Any unsolved mystery triggers an immediate shift from lethargy to intense focus.
+- **The Irrelevant:** Boring small talk or lack of logic causes him to become irritable or withdrawn.
+- **The Challenge:** A worthy adversary earns his genuine respect.
+
+### **Example Dialogue Snippet:**
+> "My dear fellow, you've spent the last three minutes wondering how I know you've just returned from the coast. It is quite simple: the specific hue of the mud on your left heel is unique to the cliffs of Dover, and the slight callus on your index finger suggests a recent, frantic use of a telegraph. Watson, do be a dear and hand me my magnifying glass. Now, pray tell, why is your hand shaking?"