ollama_chat 0.0.94 → 0.0.96

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45c44a082f13dac46e85a681f8dcbda705075155d43f39b8a1b1ba37cf75db18
-  data.tar.gz: 7d45a03f43c1b916874e0d594ca5855bfb45c0883ee41c6e9dad355f73917fc6
+  metadata.gz: 54aa30ed02a44f43f0f197247d4e7f5377007802025ddc55632f60965e6d0548
+  data.tar.gz: aa6e058dd8135e265fbfbc848620ece0730182ff6c11e4b0e9c87a8b68e97590
 SHA512:
-  metadata.gz: c7c48d1cfc04418d6d2d036be1807768bfc971415f87453671738d187ff7d24a392d06bbbba6845c2e65ad3cc4a6bf41396e83e8920f61d6eb1a34fee1c9b630
-  data.tar.gz: 2e4501051294b49ba0805970ee87934e8b817aeadcdf9326f06460c8a9d1e8cfecc050bff83c02c10f3519ff7207a303383febe91d487eda82cf82e1f6778e41
+  metadata.gz: 96d53286b971b4863f688a8613e9ca3fe3e0ee65b9c5f18b042ea3a910ea8ef8cdb4b2e2b26750c08aae6bcbbdd43371e8f0fd9598f24c494256f58f42ddd8ef
+  data.tar.gz: 1d5aa2eadaa9723f6a20f1019f6965249e9d526d38bd6de5d5e86ed1b76ac82e86bf0e59915330f35a2a48f0ce99c6a4109a50c94d38e30965f4d658be768ce3

data/CHANGES.md

@@ -1,5 +1,109 @@
 # Changes
 
+## 2026-07-03 v0.0.96
+
+### New Features
+
+- Added reroll capability to the `roll_dice` tool, including a new `reroll`
+  configuration option in `default_config.yml` and implementation of a reroll
+  loop using `chat.confirm?`.
+- Enhanced the `roll_dice` tool output to include `min` and `max` bounds in the
+  JSON response and result range in the summary message.
+- Improved character importing by implementing `import_persona_from_json` in
+  `PersonaeManagement`, removing temporary file dependencies.
+- Added the ability to offer new sessions during session selection via
+  `offer_new_session: true` in `SessionManagement`.
+
+### Improvements
+
+- **Tool Messaging**: Added or enhanced human-readable summary `message` fields
+  for several tools to improve user experience:
+    - `GetTime`: Now includes time-of-day greetings and formatted weekdays.
+    - `GetCurrentWeather`: Now incorporates temperature, conditions, and daily
+      forecasts.
+    - `ReadFile` & `WriteFile`: Integrated `OllamaChat::TokenEstimator` for
+      formatted byte and token counts.
+    - `GeneratePassword`: Added summaries covering various alphabet types and
+      errors.
+    - `RetrieveDocumentSnippets`: Added counts and collection details.
+    - `ExecuteGrep`: Added logic to distinguish between found matches and blank
+      results.
+    - `RunTests`: Added emoji-based result summaries and removed reliance on
+      the global `$?` variable.
+    - `ComputeBMI`: Enhanced summary messages and simplified calculation logic.
+- **Character Personalization**: 
+    - Updated `convert_json_character_to_markdown` to replace `{{char}}`
+      placeholders with actual names.
+    - Enhanced `personalize_character_profile` using case-insensitive regexes
+      for `{{user}} and {{char}}`.
+    - Refactored `PNGMetadataExtractor.decode_character` to return a tuple of
+      the decoded string and parsed JSON data.
+- **Token Estimation**: 
+    - Relocated `TokenEstimator` to a primary domain module and introduced an
+      `Estimate` struct for formatted bytes and tokens.
+    - Implemented `OllamaChat::TokenEstimator::Crude` as the estimation engine.
+
+### Refactoring & Maintenance
+
+- Updated Ruby syntax across the project to use shorthand hash syntax (e.g., in
+  `.where`, object initialization, and method calls).
+- Improved compatibility by replacing the `it` parameter with `_1` in the
+  `tools` method within `ToolCalling`.
+- Bumped `context_spook` dependency from **1.5** to **1.6**.
+
+## 2026-06-29 v0.0.95
+
+### New Features & Enhancements
+
+- **PNG Metadata Extraction**:
+    - Implemented `OllamaChat::Utils::PNGMetadataExtractor` to support
+      extraction of characters, prompts, and workflows from `tEXt` chunks.
+    - Added support for Automatic1111 Stable Diffusion WebUI parameters via
+      `parse_a1111_parameters`.
+    - Consolidated metadata extraction logic into a new `parse_png` method
+      within `OllamaChat::Parsing`.
+    - Introduced `OllamaChat::Utils::UTF8Converter` to ensure safe UTF-8
+      encoding across the system.
+- **Tool Improvements**:
+    - Enhanced the `roll_dice` tool by adding a human-readable `message` field
+      to its JSON output and increasing the `result_display_timeout` in
+      `default_config.yml`.
+- **Command Interface**:
+    - Overhauled help texts for numerous commands (including `/model`,
+      `/system`, `/tools`, `/session`, `/prompt`, and `/persona`) using
+      squiggly heredocs for better formatting and clarity.
+    - Added comprehensive YARD documentation to the `OllamaChat::Commands`
+      module.
+
+### Bug Fixes & Refactoring
+
+- **Stability & Logic**:
+    - Updated `OllamaChat::InputContent#all_file_set` to filter out directories
+      using `.select(&:file?)` and return a `Set`.
+    - Improved session name validation in
+      `lib/ollama_chat/session_management.rb` by replacing `.nil?` with
+      `.blank?`.
+    - Added `io.rewind` within an `ensure` block in the PNG extraction logic to
+      prevent read errors.
+- **Cleanup**:
+    - Removed the unused `json` dependency from `compute_bmi`.
+    - Removed the `PATCH_TOOL` definition and its corresponding documentation
+      in `README.md`.
+    - Pruned redundant convenience methods `extract_prompt` and
+      `extract_workflow` from `OllamaChat::Utils::PNGMetadataExtractor`.
+
+### Documentation & CI
+
+- **README Updates**:
+    - Expanded the available tools table to include `delete_file`, `move_file`,
+      `eval_ruby`, `get_ghr`, and `get_jira_issue`.
+    - Refined descriptions for the **Knowledge** category, specifically
+      distinguishing between `retrieve_document_snippets` and `file_context`.
+- **CI/CD**:
+    - Optimized dependency installation in `.all_images.yml` by replacing
+      `getconf _NPROCESSORS_ONLN` with `nproc` for better parallel job
+      compatibility.
+
 ## 2026-06-22 v0.0.94
 
 ### Added
@@ -110,7 +214,7 @@
 
 - **Model Option Profiles**: Added support for model option profiles, including
   a new `profile` column in the database with a composite unique index on
-  `[:model_name, :profile]`. 
+  `[:model_name, :profile]`.
     - Enhanced `OllamaChat::ModelHandling` methods (`get_stored_model_options`,
       `store_model_options`) to support a `profile` parameter.
     - Implemented `choose_profile_for_model` for interactive profile selection.
@@ -126,20 +230,20 @@
 
 ### Enhancements & Refactoring
 
-- **Command Standardization**: 
+- **Command Standardization**:
     - Standardized the use of the `-e` flag for editing across multiple
       commands: `/input`, `/regenerate`, `/pipe`, `/output`, `/copy`, and
       `/paste`.
     - Replaced "Flags:" with "Options:" in help text for several chat commands.
     - Added a specific editor hook using `edit_text` for the `/input` command
       to allow editing imported content.
-- **Code Architecture**: 
+- **Code Architecture**:
     - Extracted all chat command definitions into a new separate module
       `OllamaChat::Commands` located in `lib/ollama_chat/commands.rb`.
     - Updated `OllamaChat::Chat` and the main library entry point to utilize
       this new module instead of inline definitions or
       `OllamaChat::CommandConcern`.
-- **Message Output**: 
+- **Message Output**:
     - Enhanced `OllamaChat::MessageOutput#pipe` and `#output` to accept an
       `edit` parameter.
     - Refactored `OllamaChat::MessageOutput#attempt_to_write_file` to receive
@@ -282,42 +386,42 @@
 ## 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`.  
+  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:  
+  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.  
+    `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`.  
+    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`.  
+  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`.  
+  `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`.  
+  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`.  
+  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`:  
+  `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:  
+    `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.  
+    `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`.
 
@@ -348,24 +452,24 @@
 ## 2026-03-26 v0.0.84
 
 - Added `OllamaChat::Utils::ValueFormatter` with helper `format_bytes` in
-  `lib/ollama_chat/utils/value_formatter.rb`.  
-    - Added `require 'ollama_chat/utils/value_formatter'` where needed.  
+  `lib/ollama_chat/utils/value_formatter.rb`.
+    - Added `require 'ollama_chat/utils/value_formatter'` where needed.
     - Updated `write_file`, `patch_file`, `paste_from_clipboard` to use
-      `format_bytes` for byte‑size messages.  
+      `format_bytes` for byte‑size messages.
 - Implemented new tool `RetrieveDocumentSnippets` in
   `lib/ollama_chat/tools/retrieve_document_snippets.rb` and its spec
-  `spec/ollama_chat/tools/retrieve_document_snippets_spec.rb`.  
+  `spec/ollama_chat/tools/retrieve_document_snippets_spec.rb`.
     - Updated `default_config.yml` to enable `retrieve_document_snippets` by
-      default.  
+      default.
 - Rewrote tool payloads to include a `message` key for `browse`, `search_web`,
-  `paste_from_clipboard`, `resolve_tag`, and others.  
-- `browse` now returns `"Opened \"<url>\" in browser."` or a failure message.  
+  `paste_from_clipboard`, `resolve_tag`, and others.
+- `browse` now returns `"Opened \"<url>\" in browser."` or a failure message.
 - Refactored `confirm?` in `lib/ollama_chat/dialog.rb` to accept keyword `yes:`
   for a confirmation regex and display a coloured emoji matching the response
-  or timeout/default.  
-    - Updated all calls to `confirm?` to use `yes: /\Ay/i` syntax.  
+  or timeout/default.
+    - 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.  
+      `confirm?` calls and refine the emoji shown when a file already exists.
 
 ## 2026-03-24 v0.0.83
 
@@ -387,13 +491,13 @@
 ## 2026-03-21 v0.0.82
 
 - Add a `before` block setting `OC::OLLAMA::CHAT::TOOLS::CTAGS_TOOL` to `ctags`
-  in the `resolve_tag` spec.  
+  in the `resolve_tag` spec.
 - Updated `OllamaChat::Tools::PasteIntoEditor` description to use `text`
   instead of `string` and clarified that no file or line is required when
-  pasting into the editor.  
+  pasting into the editor.
 - Added bell and question mark emojis to various `confirm?` and `ask?` prompts
-  across multiple modules for clearer UX.  
-- Updated prompt string to `⏎  Press …` for better display.  
+  across multiple modules for clearer UX.
+- Updated prompt string to `⏎  Press …` for better display.
 - Enhanced `OllamaChat::Tools::ResolveTag` and `OllamaChat::Utils::TagResolver`
   with a new `kinds` method, updated `kind` parameter description, refactored
   `kind_of`, and fixed tag‑parsing regex to capture all columns.

data/README.md

@@ -42,7 +42,6 @@ The following environment variables can be used to configure behavior:
 - `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
@@ -253,14 +252,19 @@ 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. |
+| **Filesystem** | `read_file`, `write_file`, `patch_file`, `delete_file`, `move_file`, `directory_structure`, `execute_grep` | Read, write, and search files within allowed directories. |
+| **Ruby/Dev** | `resolve_tag`, `execute_ri`, `gem_path_lookup`, `run_tests`, `eval_ruby` | Introspect Ruby code, check documentation, and run test suites. |
+| **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` | Search through project-specific documentation collections. |
+| **Knowledge** | `retrieve_document_snippets`, `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,
+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.*
+
 ## Download
 
 The homepage of this app is located at

data/Rakefile

@@ -56,7 +56,7 @@ GemHadar do
   dependency             'bigdecimal',            '~> 3.1'
   dependency             'csv',                   '~> 3.0'
   dependency             'const_conf',            '~> 0.3'
-  dependency             'context_spook',         '~> 1.5'
+  dependency             'context_spook',         '~> 1.6'
   dependency             'infobar',               '>= 0.13.1'
   dependency             'rubyzip',               '~> 3.0'
   dependency             'sequel',                '~> 5.0'

data/lib/ollama_chat/chat.rb

@@ -33,6 +33,7 @@ require 'context_spook'
 class OllamaChat::Chat
   include Tins::GO
   include Term::ANSIColor
+  include OllamaChat::TokenEstimator
   include OllamaChat::HTTPHandling
   include OllamaChat::Commands
   include OllamaChat::Logging
@@ -69,6 +70,7 @@ class OllamaChat::Chat
   include OllamaChat::PromptManagement
   include OllamaChat::Utils::Chooser
   include OllamaChat::Utils::ValueFormatter
+  include OllamaChat::Utils::UTF8Converter
 
   # Initializes a new OllamaChat::Chat instance with the given command-line
   # arguments.