ollama_chat 0.0.122 → 0.0.123

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d77fd2cddf7c921b77712a90d4d1d31b3daf0f80dc4170f71eb209e7ce46390b
-  data.tar.gz: af9f30997ca31d67d7ba1914a971b5abb165d1913b2723c0727f07929b4512e4
+  metadata.gz: f2d0c5676e03433f245a21795872a9d7bd64357306ec691de3012195b5403bef
+  data.tar.gz: 933dca2b53647c523b9849d958cc1625106c97500caf2814bc731458a0e683f4
 SHA512:
-  metadata.gz: ba243ffe79c5062b0feb5fc2d6389efff95216961567dbe9275f020cbdf811d1f04f238e95972d007e611109c3bcc795057c8a2c4afeeaf7d1b739301b91c0f5
-  data.tar.gz: badb4e4ccca4ee006cdb48fd66b107367c81d7bf3ee3717482e4c61f3bc4d6fcda80d4cc54edefb9a0b5af5a6dbcf32173eeb3e0f48f545d32f5c3508d472ba1
+  metadata.gz: 4589b5f1cf689bb35bdf26c288e59f40b87ef926eaf7f91e187c3fa729958c9d042f784eb3bf9a4b6e64966c201312713c2e20607291c6aabc10d306cf4cf272
+  data.tar.gz: 19102c3d01a2ebb4bb14b8ea617b09a7e168d0175225024a490dc85e23b41ce3c7eba249d82cc671f5530da0090e945f8f6358d17ca7f6b7587a413002e27dc2

data/CHANGES.md

@@ -1,5 +1,99 @@
 # Changes
 
+## 2026-09-25 v0.0.123
+
+### Added
+
+*   README section 5 documenting `/conversation compact`: token-aware
+    keep-recent budget, safe & retryable behavior, visible before/after
+    metrics, and iterative re-compaction.
+*   Three-step context escalation ladder in the README: `/conversation
+    compact` first, then `/conversation report` + `/clear` + `/input path`
+    as the preferred second step, and `/conversation clean` as the emergency
+    exit.
+*   `execute_shell` tool to the Filesystem row in the README, noted as running
+    shell commands as a last resort.
+*   `execute_jira_twg` tool to the Web/External row in the README for running
+    Jira CLI queries via `twg`.
+*   `lookup_group` tool to the Knowledge row in the README for retrieving prior
+    conversation groups by UUID.
+*   Speech Services (ASR) section documenting `OLLAMA_CHAT_ASR_URL`,
+    `OLLAMA_CHAT_ASR_CONVERT_COMMAND`, and `OLLAMA_CHAT_ASR_MODEL`.
+*   Audio Playback section documenting `OLLAMA_CHAT_AUDIO_PLAYER_CONFIG`.
+*   Invidious (YouTube Proxy) section documenting `OLLAMA_CHAT_INVIDIOUS_URL`,
+    `OLLAMA_CHAT_INVIDIOUS_COMPANION_KEY`, and
+    `OLLAMA_CHAT_INVIDIOUS_CAPTION_LANGUAGES`.
+*   `markdown:` keyword argument (default `true`) to
+    `kramdown_markdown_remove`; when `false`, skips the `kramdown_ansi_parse`
+    step while still removing emoji, ANSI, and box-drawing characters.
+*   Explanatory comment block to `eval_template` in
+    `lib/ollama_chat/tools/execute_grep.rb` clarifying that the `cmd` config
+    value is a Ruby string template whose `#{...}` interpolations are resolved
+    against the method's local parameters via `eval`.
+*   `cleaned` string prefix in `save_conversation` so the `STDOUT`/`STDERR`
+    confirmation messages read "Saved cleaned conversation to…" when `clean:
+    true` is passed.
+*   "Cancelled." message when the user skips saving in conversation report and
+    summarize flows.
+
+### Changed
+
+*   Renamed `report_session` to `generate_conversation_report` to clarify it
+    only builds the report text.
+*   Reworked `report_conversation` to always display in the pager first, then
+    optionally save to a file; removed the `save:` keyword argument.
+*   Reworked `summarize_conversation` in `session_management.rb` to always
+    render via `use_pager` first, then optionally save via `ask_for_filename?`
+    and `should_overwrite?`.
+*   Removed the `save:` keyword argument from `summarize_conversation` and the
+    `-f` flag from the `/conversation` command dispatch in `commands.rb`.
+*   Tightened the `/conversation` regex from `(?:[sf]|c)` to `[sc]` and updated
+    the `options:` help text to drop `-f save`.
+*   Changed "Nothing to summarize!" and "Nothing to report!" output from
+    `STDERR` to `STDOUT`.
+*   `kramdown_markdown_remove` now strips `\p{Extended_Pictographic}` emoji
+    before any further processing, preventing TTS engines from vocalizing them.
+*   `kramdown_markdown_remove` in `lib/ollama_chat/kramdown_ansi.rb` now strips
+    Unicode box-drawing characters (`U+2500`..`U+257F`) that kramdown renders
+    as table borders, preventing TTS engines from stammering on them.
+*   Collapses resulting multi-space runs and strips leading/trailing whitespace
+    in `kramdown_markdown_remove`.
+*   Moved the `kramdown_markdown_remove` call from `flush_buffer` into
+    `enqueue_tts` in `lib/ollama_chat/tts.rb` so all enqueue paths are covered,
+    passing `markdown: @chat.markdown.on?`.
+*   `multipart_form_data` in `lib/ollama_chat/asr.rb` now returns a hash
+    containing only `headers:`, `expects:`, and `body:`, which are the actual
+    Excon request options, instead of merging `rest` (`model:`, `language:`)
+    into the returned options hash.
+*   Updated YARD documentation to reflect the new parameter and emoji stripping
+    behavior.
+*   Updated `spec/ollama_chat/asr_spec.rb` expectations from
+    `hash_including(model: ...)` / `hash_including(language: ...)` to
+    `hash_including(body: kind_of(String))` to match the new option shape.
+*   Updated `commands_spec.rb` to remove the obsolete `/conversation summarize
+    -f` and `/conversation report -f` specs and drop `save:` from expectations.
+*   Updated `session_management_spec.rb` for the new show-then-save flow,
+    `STDOUT` stream, and `Cancelled.` expectation.
+*   Updated the corresponding expectation in `conversation_spec.rb` to match
+    the new message text.
+*   Renamed former section 5 "Session Reports" to section 6 "Conversation
+    Reports" to match the actual command name.
+*   Updated Conversation Archiving section from `/session summarize` to
+    `/conversation summarize`, removed obsolete `-f` flag reference, and
+    described the show-then-save flow.
+
+### Fixed
+*   Fixed `TTS_URL` to `OLLAMA_CHAT_TTS_URL` to match the actual env var name
+    in `oc.rb`.
+*   Wrapped `@prefix` with `Regexp.quote()` in `RedisCache#unpre` to ensure the
+    prefix is always matched as a literal string.
+*   Fixed typos in height validation error message.
+
+### Removed
+*   `context_spook` from development dependencies in `Rakefile` and
+    `ollama_chat.gemspec`.
+*   The `-f` flag from the `/report` command in `commands.rb`.
+
 ## 2026-09-25 v0.0.122
 
 ## Features

data/README.md

@@ -62,7 +62,7 @@ The following environment variables can be used to configure behavior:
 - `OLLAMA_URL` - Base URL for Ollama server (default: `http://localhost:11434`)
 - `OLLAMA_HOST` - Base hostname for Ollama server (default: `localhost:11434`)
 - `OLLAMA_SEARXNG_URL` - SearxNG search endpoint URL
-- `TTS_URL` - Base URL for the [audio.cpp](https://github.com/0xshug0/audio.cpp) TTS server (default: `http://localhost:8880`)
+- `OLLAMA_CHAT_TTS_URL` - Base URL for the [audio.cpp](https://github.com/0xshug0/audio.cpp) TTS server (default: `http://localhost:8880`)
 
 #### Chat Settings
 - `OLLAMA_CHAT_MODEL` - Default model to use (e.g., `llama3.1`)
@@ -75,6 +75,19 @@ The following environment variables can be used to configure behavior:
 - `OLLAMA_CHAT_LOG_DATABASE` - Database log file path (default: `$XDG_STATE_HOME/database.log`)
 - `OLLAMA_CHAT_LOG_TAIL_LINES` - Max lines to retain in log files (default: `10000`)
 
+#### Speech Services (ASR)
+- `OLLAMA_CHAT_ASR_URL` - Base URL for the ASR (Speech-to-Text) service (default: `http://localhost:8880`)
+- `OLLAMA_CHAT_ASR_CONVERT_COMMAND` - Shell command template to convert video to 16 kHz mono PCM WAV; use `%{input}` / `%{output}` as placeholders (default: `ffmpeg -y -i %{input} -vn -acodec pcm_s16le -ar 16000 -ac 1 %{output}`)
+- `OLLAMA_CHAT_ASR_MODEL` - ASR model identifier (default: `qwen3-asr-1.7b`)
+
+#### Audio Playback
+- `OLLAMA_CHAT_AUDIO_PLAYER_CONFIG` - JSON object with `command`, `frequency`, `bits`, `pause` keys controlling the ffplay-based TTS audio player
+
+#### Invidious (YouTube Proxy)
+- `OLLAMA_CHAT_INVIDIOUS_URL` - Base URL for an Invidious instance
+- `OLLAMA_CHAT_INVIDIOUS_COMPANION_KEY` - Bearer token for the Invidious companion player API (required when `URL` is set)
+- `OLLAMA_CHAT_INVIDIOUS_CAPTION_LANGUAGES` - JSON array of language-code regexes for caption selection priority (default: `["\\Aen\\z","\\Aen-","\\Ade\\z","\\Ade-"]`)
+
 #### 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
@@ -243,14 +256,57 @@ switch. The profile system allows you to manage "Live" vs "Saved" settings:
     "bake" those live settings into a permanent profile using `options from
     session`.
 
-#### 4. Conversation Archiving (`/session summarize`)
+#### 4. Conversation Archiving (`/conversation summarize`)
 
 Turn your long-form brainstorming sessions into structured documents. The
-`/session summarize` command can distill an entire conversation into a concise
-summary.
+`/conversation summarize` command distills an entire conversation into a
+concise summary, displayed in the pager first, then optionally saved.
 *   **Quick View**: Use `-s` for a one-sentence executive summary.
-*   **Archiving**: Use `-f <filename>` to dump the full summary directly into a
-    Markdown file, creating an automatic journal of your project's evolution.
+*   **Archiving**: After the summary is displayed, you are prompted for a
+    filename to save it as a Markdown file, creating an automatic journal
+    of your project's evolution.
+
+#### 5. Context Compaction (`/conversation compact`)
+
+Long sessions inevitably fill up the model's context window. The
+`/conversation compact` command summarizes older messages into a single
+compact summary while preserving recent exchanges, freeing up space for
+continued work.
+
+*   **Token-aware**: The keep-recent budget is derived from the active
+    model's context length, so it adapts automatically.
+*   **Safe & retryable**: If the LLM summarization fails, the message list
+    is left untouched and you can simply retry.
+*   **Visible metrics**: After compaction, a report shows summarized
+    message count, summary size, and context usage before/after.
+*   **Iterative**: Repeated compactions merge into the existing summary
+    rather than stacking multiple summary messages.
+
+Run it whenever context usage climbs into the red zone (visible in the
+runtime info gauge) — the model stays sharp and the conversation keeps
+flowing.
+
+If compaction alone isn't enough, a practical escalation ladder:
+
+1. **`/conversation compact`** — summarize old messages, keep recent tail.
+   Try this first; it's the least destructive.
+2. **`/conversation report`** → **`/clear`** → **`/input path
+    standup.md`** — generate a standup-style report, save it, clear
+    the messages, then feed the report back as context. Do this
+    before `clean`, because `clean` strips the tool output and
+    thinking that make a good report.
+3. **`/conversation clean`** — strips tool results, images, and
+    thinking content from all messages. More radical, but the
+    conversation structure and text remain intact. The emergency
+    exit: if context is so stuffed that even a report can't fit,
+    `clean` carves out enough room for anything to work again.
+
+#### 6. Conversation Reports (`/conversation report`)
+
+Generate a structured report from your conversation using configurable
+prompt templates. The report is displayed in the pager first, then
+optionally saved to a file. Particularly useful for daily standup summaries
+— run it at the end of the day and save the output for your team sync.
 
 ### Using a Persona
 
@@ -467,12 +523,12 @@ context, manipulate files, and retrieve external information.
 
 | Category | Tools | Description |
 | :--- | :--- | :--- |
-| **Filesystem** | `read_file`, `write_file`, `patch_file`, `delete_file`, `move_file`, `directory_structure`, `execute_grep` | Read, write, and search files within allowed directories. |
+| **Filesystem** | `read_file`, `write_file`, `patch_file`, `delete_file`, `move_file`, `directory_structure`, `execute_grep`, `execute_shell` | Read, write, and search files within allowed directories; run shell commands as a last resort. |
 | **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. |
+| **Web/External** | `search_web`, `get_url`, `browse`, `get_rfc`, `get_cve`, `get_endoflife`, `get_ghr`, `get_jira_issue`, `execute_jira_twg` | Access the internet, fetch specific URLs, and look up technical standards; run Jira CLI queries via `twg`. |
 | **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** | `search_knowledge`, `file_context` | Semantic search for specific snippets vs. broad retrieval of structured project context. |
+| **Knowledge** | `search_knowledge`, `file_context`, `lookup_group` | Semantic search for specific snippets, broad retrieval of structured project context, or retrieving prior message groups by UUID. |
 | **Multimodal** | `generate_image` | Generate images via a local ComfyUI server. |
 
 ***Note on Knowledge Tools**: Use `search_knowledge` for precise,

data/Rakefile

@@ -68,7 +68,6 @@ GemHadar do
   development_dependency 'webmock'
   development_dependency 'debug'
   development_dependency 'simplecov'
-  development_dependency 'context_spook'
   development_dependency 'utils'
 
   licenses << 'MIT'

data/lib/ollama_chat/asr.rb

@@ -99,10 +99,10 @@ module OllamaChat
         body << Excon::CR_NL
         body << "--#{boundary}--" << Excon::CR_NL
 
-        rest.symbolize_keys_recursive.compact | {
+        {
           headers: { 'Content-Type' => %{multipart/form-data; boundary="#{boundary}"} },
           expects: 200,
-          body:,
+          body:    ,
         }
       end
     end

data/lib/ollama_chat/commands.rb

@@ -374,15 +374,15 @@ module OllamaChat::Commands
 
   command(
     name: :conversation,
-    regexp: %r(^/conversation\s+(clean|compact|save|load|summarize|report)((?:\s+-(?:[sf]|c))*)(?:\s+([^-].*\.jsonl?))?$),
+    regexp: %r(^/conversation\s+(clean|compact|save|load|summarize|report)((?:\s+-[sc])*)(?:\s+([^-].*\.jsonl?))?$),
     complete: [ 'conversation', %w[ save load clean compact summarize report ] ],
-    options: '[-s|-f|-c] [FILENAME]',
+    options: '[-s|-c] [FILENAME]',
     help: <<~EOT
       💾 Manage conversation content:
          - save/load: Export/import as .json or .jsonl
          - clean: Remove tool content, images, thinking
          - compact: Summarize old messages, keep recent
-         - summarize: Per-message narrative (-s sentence, -f save)
+         - summarize: Per-message narrative (-s sentence)
          - report: Generate a session report document
     EOT
   ) do |subcommand,opts,path|
@@ -420,11 +420,10 @@ module OllamaChat::Commands
         STDOUT.puts 'Cancelled.'
       end
     when 'summarize'
-      opts = go_command('sf', opts)
-      summarize_conversation(save: opts[?f], sentence: opts[?s])
+      opts = go_command('s', opts)
+      summarize_conversation(sentence: opts[?s])
     when 'report'
-      opts = go_command('f', opts)
-      report_conversation(save: opts[?f])
+      report_conversation
     end
     :next
   end

data/lib/ollama_chat/conversation.rb

@@ -26,12 +26,13 @@ module OllamaChat::Conversation
   # @example Save conversation with explicit filename
   #   chat.save_conversation('conversations/2023-10-15_my_session.json')
   def save_conversation(filename, clean: false)
+    cleaned = 'cleaned ' if clean
     filename = Pathname.new(filename)
     should_overwrite?(filename) or return
     if messages.save_conversation(filename, messages: clean ? messages.clean_messages : messages.messages)
-      STDOUT.puts "Saved conversation to #{filename.to_s.inspect}."
+      STDOUT.puts "Saved #{cleaned}conversation to #{filename.to_s.inspect}."
     else
-      STDERR.puts "Saving conversation to #{filename.to_s.inspect} failed."
+      STDERR.puts "Saving #{cleaned}conversation to #{filename.to_s.inspect} failed."
     end
   end
 

data/lib/ollama_chat/kramdown_ansi.rb

@@ -49,18 +49,29 @@ module OllamaChat::KramdownANSI
     retry
   end
 
-  # The kramdown_markdown_remove method strips all markdown formatting from
-  # content by first rendering it to ANSI and then removing the escape
-  # sequences, yielding plain text suitable for speech synthesis.
+  # The kramdown_markdown_remove method strips markdown formatting, emoji,
+  # ANSI escape sequences, and box-drawing characters from content, yielding
+  # plain text suitable for TTS playback.
   #
-  # @param content [ String, nil ] the markdown content to strip.
-  #   If nil, returns an empty string.
+  # @param content [ String, nil ] the content to strip.
+  #   If nil or empty, returns an empty string.
+  # @param markdown [ Boolean] if true (default), runs the full kramdown
+  #   ANSI parse before stripping; if false, only removes emoji, ANSI,
+  #   and box-drawing characters without markdown rendering.
   #
-  # @return [ String ] the content with all markdown and ANSI
-  #   formatting removed, suitable for TTS playback
-  def kramdown_markdown_remove(content)
-    content = kramdown_ansi_parse(content)
-    content.empty? and return ''
-    OllamaChat::Utils::StripANSI.strip_ansi(content)
+  # @return [ String ] the content with all markdown, ANSI, emoji, and
+  #   box-drawing formatting removed, suitable for TTS playback
+  def kramdown_markdown_remove(content, markdown: true)
+    content.full? or return ''
+    content = content.gsub(/\p{Extended_Pictographic}/, '').full? or return ''
+    if markdown
+      content = kramdown_ansi_parse(content).full? or return ''
+    end
+    content = OllamaChat::Utils::StripANSI.strip_ansi(content)
+    # Remove box-drawing characters (U+2500..U+257F) that kramdown uses
+    # for table borders/separators — TTS engines stammer on these.
+    content.gsub(/[\u2500-\u257F]/, ' ')
+           .gsub(/\s{2,}/, ' ')
+           .strip
   end
 end

data/lib/ollama_chat/redis_cache.rb

@@ -151,6 +151,6 @@ class OllamaChat::RedisCache
   # @param key [String] The prefixed key
   # @return [String] The key without prefix
   def unpre(key)
-    key.sub(/\A#@prefix/, '')
+    key.sub(/\A#{Regexp.quote(@prefix)}/, '')
   end
 end

data/lib/ollama_chat/session_management.rb

@@ -384,34 +384,27 @@ module OllamaChat::SessionManagement
     contents * "\n\n"
   end
 
-  # Summarizes the conversation and displays or saves the result.
+  # Summarizes the conversation and displays / saves the result.
   #
   # @param sentence [Boolean] summarize each message in one sentence (default: false)
-  # @param save [Boolean] save to file instead of pager (default: false)
-  def summarize_conversation(sentence: false, save: false)
-    if save
-      filename = ask_for_filename?(action: 'for summarization') or return
-      should_overwrite?(filename) or return
-      summary = summarize_session(sentence:) do |content|
-        infobar.puts kramdown_ansi_parse(content)
+  def summarize_conversation(sentence: false)
+    summary = summarize_session(sentence:) do |content|
+      infobar.puts kramdown_ansi_parse(content) << ?\n
+    end
+    if summary.full?
+      use_pager do |output|
+        output.puts kramdown_ansi_parse(summary)
       end
-      if summary.full?
+      if filename = ask_for_filename?(action: 'for summarization') and
+          should_overwrite?(filename)
+      then
         filename.write(summary)
         STDOUT.puts "File successfully written."
       else
-        STDERR.puts "Nothing to summarize!"
+        STDOUT.puts "Cancelled."
       end
     else
-      summary = summarize_session(sentence:) do |content|
-        infobar.puts kramdown_ansi_parse(content) << ?\n
-      end
-      if summary.full?
-        use_pager do |output|
-          output.puts kramdown_ansi_parse(summary)
-        end
-      else
-        STDERR.puts "Nothing to summarize!"
-      end
+      STDOUT.puts "Nothing to summarize!"
     end
   end
 
@@ -425,7 +418,7 @@ module OllamaChat::SessionManagement
   #
   # @param name [String, nil] specific template name (skips chooser)
   # @return [String, nil] the report or nil if empty
-  def report_session(name: nil)
+  def generate_conversation_report(name: nil)
     content = messages.compacted_messages.inject('') do |c, message|
       message.content.present? or next c
       sender = sender_name_displayed(message)
@@ -446,7 +439,7 @@ module OllamaChat::SessionManagement
     system = prompt(:report, context: 'system').to_s
 
     Infobar.busy(
-      label: 'Generating session report…',
+      label: 'Generating conversation report…',
       frames: :braille7,
       output: STDOUT,
     ) do
@@ -454,30 +447,26 @@ module OllamaChat::SessionManagement
     end
   end
 
-  # Generates a report and displays or saves the result.
+  # Generates a report and displays / saves the result.
   #
   # @param name [String, nil] specific report template name (skips chooser)
-  # @param save [Boolean] save to file instead of pager (default: false)
-  def report_conversation(name: nil, save: false)
-    if save
-      filename = ask_for_filename?(action: 'for report') or return
-      should_overwrite?(filename) or return
-      result = report_session(name:)
-      if result.full?
+  def report_conversation(name: nil)
+    result = generate_conversation_report(name:)
+    if result.full?
+      use_pager do |output|
+        output.puts kramdown_ansi_parse(result)
+      end
+      if filename = ask_for_filename?(action: 'for report') and
+          should_overwrite?(filename)
+      then
         filename.write(result)
         STDOUT.puts "File successfully written."
       else
-        STDERR.puts "Nothing to report!"
+        STDOUT.puts "Cancelled."
       end
     else
-      result = report_session(name:)
-      if result.full?
-        use_pager do |output|
-          output.puts kramdown_ansi_parse(result)
-        end
-      else
-        STDERR.puts "Nothing to report!"
-      end
+      STDOUT.puts "Nothing to report!"
+      return
     end
   end
 

data/lib/ollama_chat/tools/compute_bmi.rb

@@ -82,8 +82,8 @@ class OllamaChat::Tools::ComputeBMI
       units = 'SI'
     end
 
-    raise OllamaChat::ToolFunctionArgumentError, 'Height must be greater than zero and in kg/lbs' if height <= 0
-    raise OllamaChat::ToolFunctionArgumentError, 'Weight must be less than 3m and in meter/feet' if height > 3
+    raise OllamaChat::ToolFunctionArgumentError, 'Height must be greater than zero and in meter/feet' if height <= 0
+    raise OllamaChat::ToolFunctionArgumentError, 'Height must be less than 3m and in meter/feet' if height > 3
 
     bmi      = ( weight / height**2 ).round(2)
     category = calculate_category(bmi)

data/lib/ollama_chat/tools/execute_grep.rb

@@ -125,6 +125,10 @@ class OllamaChat::Tools::ExecuteGrep
   # Evaluates a template string using the provided configuration and
   # parameters.
   #
+  # The `cmd` config value is a Ruby string template — its `#{...}`
+  # interpolations are resolved against the local parameters via `eval`,
+  # so all arguments below serve as the interpolation context.
+  #
   # @param config [Object] the configuration object containing tool settings
   # @param pattern [String] the regex pattern to search for
   # @param path [String] the file or directory path to search in

data/lib/ollama_chat/tts.rb

@@ -132,7 +132,6 @@ class OllamaChat::TTS
       size = match[0].size
 
       chunk = @buffer.slice!(0, size).full?(:strip) or next
-      chunk = kramdown_markdown_remove(chunk) if @chat.markdown.on?
       enqueue_tts(chunk)
     end
   end
@@ -147,6 +146,7 @@ class OllamaChat::TTS
   #
   # @return [Thread] the spawned TTS fetch thread
   def enqueue_tts(block)
+    block = kramdown_markdown_remove(block, markdown: @chat.markdown.on?)
     thread_id = @id_mutex.synchronize { @next_id += 1 }
     @chat.log(:info, "TTS: Enqueueing block for synthesis", data: { thread_id:, block: })
     @id_mutex.synchronize { @enqueued_count += 1 }

data/lib/ollama_chat/version.rb

@@ -1,6 +1,6 @@
 module OllamaChat
   # OllamaChat version
-  VERSION         = '0.0.122'
+  VERSION         = '0.0.123'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/ollama_chat.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: ollama_chat 0.0.122 ruby lib
+# stub: ollama_chat 0.0.123 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "ollama_chat".freeze
-  s.version = "0.0.122".freeze
+  s.version = "0.0.123".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -31,7 +31,6 @@ Gem::Specification.new do |s|
   s.add_development_dependency(%q<webmock>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<simplecov>.freeze, [">= 0".freeze])
-  s.add_development_dependency(%q<context_spook>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<utils>.freeze, [">= 0".freeze])
   s.add_runtime_dependency(%q<excon>.freeze, ["~> 1.0".freeze])
   s.add_runtime_dependency(%q<ollama-ruby>.freeze, ["~> 1.23".freeze])

data/spec/ollama_chat/asr_spec.rb

@@ -23,7 +23,7 @@ describe OllamaChat::ASR do
         .with(
           :post,
           'http://localhost:8880/v1/audio/transcriptions',
-          hash_including(model: 'qwen3-asr-1.7b')
+          hash_including(body: kind_of(String))
         ).and_yield(double(body: '{"text": "Hello Florian"}'))
 
       result = described_class.transcribe(audio_io, chat:)
@@ -35,7 +35,7 @@ describe OllamaChat::ASR do
         .with(
           :post,
           'http://localhost:8880/v1/audio/transcriptions',
-          hash_including(language: 'de')
+          hash_including(body: kind_of(String))
         ).and_yield(double(body: '{"text": "Hallo"}'))
 
       described_class.transcribe(audio_io, chat:, language: 'de')

data/spec/ollama_chat/commands_spec.rb

@@ -675,33 +675,20 @@ describe OllamaChat::Commands, protect_env: true do
 
     it 'returns :next when input is "/conversation summarize"' do
       expect(chat).to receive(:summarize_conversation)
-        .with(save: false, sentence: false)
+        .with(sentence: false)
       expect(chat.handle_input("/conversation summarize")).to eq :next
     end
 
     it 'returns :next when input is "/conversation summarize -s"' do
       expect(chat).to receive(:summarize_conversation)
-        .with(save: false, sentence: 1)
+        .with(sentence: 1)
       expect(chat.handle_input("/conversation summarize -s")).to eq :next
     end
 
-    it 'returns :next when input is "/conversation summarize -f"' do
-      expect(chat).to receive(:summarize_conversation)
-        .with(save: 1, sentence: false)
-      expect(chat.handle_input("/conversation summarize -f")).to eq :next
-    end
-
     it 'returns :next when input is "/conversation report"' do
       expect(chat).to receive(:report_conversation)
-        .with(save: false)
       expect(chat.handle_input("/conversation report")).to eq :next
     end
-
-    it 'returns :next when input is "/conversation report -f"' do
-      expect(chat).to receive(:report_conversation).
-        with(save: 1)
-      expect(chat.handle_input("/conversation report -f")).to eq :next
-    end
   end
 
   describe 'tools' do

data/spec/ollama_chat/conversation_spec.rb

@@ -20,7 +20,7 @@ describe OllamaChat::Conversation do
         .with(Pathname.new('./new_chat.jsonl'), messages: chat.messages.clean_messages)
         .and_return(true)
       expect(STDOUT).to receive(:puts)
-        .with('Saved conversation to "./new_chat.jsonl".')
+        .with('Saved cleaned conversation to "./new_chat.jsonl".')
       chat.save_conversation('./new_chat.jsonl', clean: true)
     end
 

data/spec/ollama_chat/kramdown_ansi_spec.rb

@@ -40,4 +40,64 @@ describe OllamaChat::KramdownANSI do
       expect(chat.kramdown_ansi_parse(nil)).to eq ''
     end
   end
+
+  describe '#kramdown_markdown_remove' do
+    it 'returns empty string for nil' do
+      expect(chat.kramdown_markdown_remove(nil)).to eq ''
+    end
+
+    it 'returns empty string for empty string' do
+      expect(chat.kramdown_markdown_remove('')).to eq ''
+    end
+
+    it 'removes table separator rows' do
+      input = "Name | Age\n------|-----\nFoo | 42"
+      result = chat.kramdown_markdown_remove(input)
+      expect(result).not_to include('-')
+    end
+
+    it 'replaces box-drawing characters from rendered tables' do
+      input = "| Name | Age |\n|------|-----|\n| Foo  | 42   |"
+      result = chat.kramdown_markdown_remove(input)
+      expect(result).not_to include("│")
+      expect(result).not_to include("╭")
+      expect(result).to include('Name')
+      expect(result).to include('Foo')
+    end
+
+    it 'preserves ASCII pipes in non-table lines (code, formulas)' do
+      input = 'look at this shell command `ls | grep foo`'
+      result = chat.kramdown_markdown_remove(input)
+      expect(result).to include('|')
+    end
+
+    it 'collapses multiple spaces in table rows' do
+      input = '|  Name  |  Age  |'
+      result = chat.kramdown_markdown_remove(input)
+      expect(result).not_to match(/ {2,}/)
+    end
+
+    it 'strips bold and other markdown formatting' do
+      input = '**hello** world'
+      result = chat.kramdown_markdown_remove(input)
+      expect(result).to eq 'hello world'
+    end
+
+    it 'removes emoji before processing' do
+      input = 'what is this? 🍓'
+      result = chat.kramdown_markdown_remove(input)
+      expect(result).to eq 'what is this?'
+    end
+
+    it 'returns empty string when only emoji are present' do
+      expect(chat.kramdown_markdown_remove('🍓✨')).to eq ''
+    end
+
+    it 'skips kramdown parse when markdown: false' do
+      input = '**bold** text'
+      expect(chat).not_to receive(:kramdown_ansi_parse)
+      result = chat.kramdown_markdown_remove(input, markdown: false)
+      expect(result).to include('**bold**')
+    end
+  end
 end

data/spec/ollama_chat/session_management_spec.rb

@@ -278,6 +278,7 @@ describe OllamaChat::SessionManagement do
 
     it 'returns nil if the user provides an empty string (cancel)' do
       expect(chat).to receive(:ask?).and_return('')
+      expect(STDOUT).to receive(:puts).with('Cancelled.')
       expect(chat.determine_valid_new_name_for_session('to create')).to be_nil
     end
   end
@@ -321,27 +322,30 @@ describe OllamaChat::SessionManagement do
   end
 
   describe '#summarize_conversation' do
-    it 'displays summary in pager when not saving' do
+    it 'displays summary in pager and offers save' do
       chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
       expect(chat).to receive(:summarize_session).and_return('# Summary content')
       expect(chat).to receive(:use_pager)
+      expect(chat).to receive(:ask_for_filename?).and_return(nil)
+      expect(STDOUT).to receive(:puts).with('Cancelled.')
       chat.summarize_conversation
     end
 
     it 'reports nothing when no messages' do
       expect(chat).to receive(:summarize_session).and_return(nil)
-      expect(STDERR).to receive(:puts).with('Nothing to summarize!')
+      expect(STDOUT).to receive(:puts).with('Nothing to summarize!')
       chat.summarize_conversation
     end
 
-    it 'saves summary to file when save: true' do
+    it 'saves summary to file when user provides a filename' do
       chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
       tmpfile = Pathname.new(File.join(Dir.tmpdir, "summ_#{$$}_test.md"))
+      expect(chat).to receive(:summarize_session).and_return('# Summary content')
+      expect(chat).to receive(:use_pager)
       expect(chat).to receive(:ask_for_filename?).and_return(tmpfile)
       expect(chat).to receive(:should_overwrite?).and_return(true)
-      expect(chat).to receive(:summarize_session).and_return('# Summary content')
       expect(STDOUT).to receive(:puts).with('File successfully written.')
-      chat.summarize_conversation(save: true)
+      chat.summarize_conversation
       expect(tmpfile.exist?).to be_truthy
       expect(tmpfile.read).to include('Summary content')
     ensure
@@ -349,20 +353,20 @@ describe OllamaChat::SessionManagement do
     end
   end
 
-  describe '#report_session' do
+  describe '#generate_conversation_report' do
     it 'generates a report from compacted messages' do
       chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello world')
       expect(chat).to receive(:sender_name_displayed).and_return('User')
       expect(chat).to receive(:choose_prompt).and_return(double(to_s: '%{content}'))
       expect(chat).to receive(:generate).and_return('Generated report')
 
-      result = chat.report_session
+      result = chat.generate_conversation_report
       expect(result).to eq('Generated report')
     end
 
     it 'returns nil when no messages have content' do
       expect(chat.messages).to receive(:compacted_messages).and_return([])
-      expect(chat.report_session).to be_nil
+      expect(chat.generate_conversation_report).to be_nil
     end
 
     it 'uses named prompt when name is provided' do
@@ -373,21 +377,23 @@ describe OllamaChat::SessionManagement do
       expect(chat).to receive(:prompt).with(:report, context: 'system')
         .and_return(double(to_s: '%{content}'))
       expect(chat).to receive(:generate).and_return('Brief')
-      expect(chat.report_session(name: 'coding_brief')).to eq('Brief')
+      expect(chat.generate_conversation_report(name: 'coding_brief')).to eq('Brief')
     end
   end
 
   describe '#report_conversation' do
     it 'displays report in pager when not saving' do
       chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
-      expect(chat).to receive(:report_session).and_return('# Report content')
+      expect(chat).to receive(:generate_conversation_report).and_return('# Report content')
       expect(chat).to receive(:use_pager)
+      expect(chat).to receive(:ask_for_filename?).and_return(nil)
+      expect(STDOUT).to receive(:puts).with('Cancelled.')
       chat.report_conversation
     end
 
     it 'reports nothing when no content' do
-      expect(chat).to receive(:report_session).and_return(nil)
-      expect(STDERR).to receive(:puts).with('Nothing to report!')
+      expect(chat).to receive(:generate_conversation_report).and_return(nil)
+      expect(STDOUT).to receive(:puts).with('Nothing to report!')
       chat.report_conversation
     end
 
@@ -396,9 +402,10 @@ describe OllamaChat::SessionManagement do
       tmpfile = Pathname.new(File.join(Dir.tmpdir, "report_#{$$}_test.md"))
       expect(chat).to receive(:ask_for_filename?).and_return(tmpfile)
       expect(chat).to receive(:should_overwrite?).and_return(true)
-      expect(chat).to receive(:report_session).and_return('# Report content')
+      expect(chat).to receive(:generate_conversation_report).and_return('# Report content')
+      expect(STDOUT).to receive(:puts).with(/Report content/)
       expect(STDOUT).to receive(:puts).with('File successfully written.')
-      chat.report_conversation(save: true)
+      chat.report_conversation
       expect(tmpfile.exist?).to be_truthy
       expect(tmpfile.read).to include('Report content')
     ensure

data/spec/ollama_chat/tts_spec.rb

@@ -123,7 +123,7 @@ describe OllamaChat::TTS do
 
       tts.expose(:process_pending_blocks)
 
-      expect(enqueued).to eq ["first paragraph\n", "second paragraph\n"]
+      expect(enqueued).to eq ["first paragraph", "second paragraph"]
       expect(tts.instance_variable_get(:@buffer)).to eq 'incomplete'
     end
 
@@ -134,7 +134,7 @@ describe OllamaChat::TTS do
 
       tts.expose(:process_pending_blocks)
 
-      expect(enqueued).to eq ["real text\n", "more\n"]
+      expect(enqueued).to eq ["real text", "more"]
       expect(tts.instance_variable_get(:@buffer)).to eq ''
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ollama_chat
 version: !ruby/object:Gem::Version
-  version: 0.0.122
+  version: 0.0.123
 platform: ruby
 authors:
 - Florian Frank
@@ -107,20 +107,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: context_spook
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: utils
   requirement: !ruby/object:Gem::Requirement