openclacky 1.2.9 → 1.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2060d694267d0947681785d2e2ffe730d0b241a9ac2ec68e218eb037478bf27
-  data.tar.gz: 0b3e301010e16752da0bd64a9603b06010c2a23c5bd81884c7719d74f8f1bd67
+  metadata.gz: 0b32940868f1d61791afd615ff73dbaf72dc80c111f9f9435ef939ef39ae5dec
+  data.tar.gz: be8efa7ee318c3f174ddbbdf1f5b2754705eb6a5d3f263aa11cbe5539b198e8f
 SHA512:
-  metadata.gz: 386e2359d904b9a6bc81e56429cd585aaef59b7174f5dbc93e51cdd2bf97df703fd8145910759f50427632fcc90a307ed3ec6b19e48f0230d7e0c39987d3e7a8
-  data.tar.gz: 15413b83259ef7a39acac101597149cbf2144473da691d885f14d3b271076399da14c924db19201a1b99d8bf264542b56f3619b6cb6b903dfdac462e46f15a97
+  metadata.gz: abcbed799ca8feed1a41e39a72bd8e6a5e9184c8e76a67bac79f9bee07f88ebf6b639102d6cfcd6527bf80b7b3c9bda5665f131bf81a164b9a14b963cad1ea47
+  data.tar.gz: 829bc77c06483853c1d568d04a528a9611c6e7f775b38b6c6fdebe04c5a5ae6974328bb1ac9c0f8cb1afe0765a60795061157b65860eaf26e8bb7368dadb2b8e

data/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.10] - 2026-06-03
+
+### Added
+- Compressor concurrency config and Ollama context size auto-detection
+- Channel sessions auto-rebind on server restart
+- Disk space check (4 GB minimum) on Windows install
+- WSL network connectivity pre-check before installation
+- MiniMax M3 provider with vision support and pricing
+- One-click exchange rate update in settings
+- Rich TUI controller for terminal interaction
+
+### Improved
+- WebUI working directory selector UX
+- Qwen pricing table: official rates, promo discounts, clean up stale models
+
+### Fixed
+- Directory picker interaction and indentation issues
+- File upload for PDF and Excel files
+- Session soft-delete: count-based cleanup and never evict pinned sessions
+- Usage tooltip total value showing unreadable blue background
+- Workspace file list now collapses on session switch
+- Install script network errors use exit code 2 for better error handling
+
 ## [1.2.9] - 2026-06-01
 
 ### Added

data/lib/clacky/agent/llm_caller.rb

@@ -583,6 +583,9 @@ module Clacky
           "exceeds the maximum context",    # Portkey & generic gateways
           "exceeds the model's context",    # Generic
           "exceeds the model's maximum",    # Generic
+          "exceeds the available context",  # llama.cpp / llama-server
+          "available context size",         # llama.cpp / llama-server variant
+          "try increasing it",              # llama.cpp action hint (server.cpp)
           "reduce the length of the input", # Qwen action hint
           "reduce the length of the messages", # OpenAI action hint
           "reduce the length of your",      # Generic action hint

data/lib/clacky/agent/message_compressor_helper.rb

@@ -5,9 +5,10 @@ module Clacky
     # Message compression functionality for managing conversation history
     # Handles automatic compression when token limits are exceeded
     module MessageCompressorHelper
-      # Compression thresholds
-      COMPRESSION_THRESHOLD = 150_000  # Trigger compression when exceeding this (in tokens)
-      MESSAGE_COUNT_THRESHOLD = 200   # Trigger compression when exceeding this (in message count)
+      # Compression behavior knobs.
+      # Token & message-count thresholds are owned by AgentConfig — see
+      # AgentConfig::DEFAULT_COMPRESSION_THRESHOLD / DEFAULT_MESSAGE_COUNT_THRESHOLD.
+      # The constants below are tuning parameters not currently exposed as user config.
       MAX_RECENT_MESSAGES = 20  # Keep this many recent message pairs intact
       TARGET_COMPRESSED_TOKENS = 10_000  # Target size after compression
       IDLE_COMPRESSION_THRESHOLD = 20_000  # Minimum messages needed for idle compression
@@ -141,8 +142,8 @@ module Clacky
         else
           # Normal compression - check thresholds
           # Either: token count exceeds threshold OR message count exceeds threshold
-          token_threshold_exceeded = total_tokens >= COMPRESSION_THRESHOLD
-          message_count_exceeded = message_count >= MESSAGE_COUNT_THRESHOLD
+          token_threshold_exceeded = total_tokens >= @config.compression_threshold
+          message_count_exceeded = message_count >= @config.message_count_threshold
 
           # Only compress if we exceed at least one threshold
           return nil unless token_threshold_exceeded || message_count_exceeded

data/lib/clacky/agent/session_serializer.rb

@@ -25,6 +25,9 @@ module Clacky
         # Restore source; fall back to :manual for sessions saved before this field existed
         @source = (session_data[:source] || "manual").to_sym
 
+        # Restore channel info for IM platform sessions
+        @channel_info = session_data[:channel_info]
+
         # Restore cache statistics if available
         @cache_stats = session_data.dig(:stats, :cache_stats) || {
           cache_creation_input_tokens: 0,
@@ -158,6 +161,7 @@ module Clacky
             model_base_url: persisted_card_field("base_url"),
             sub_model: @config.session_model_overlay_name
           },
+          channel_info: @channel_info,
           stats: stats_data,
           messages: @history.to_a
         }

data/lib/clacky/agent.rb

@@ -46,6 +46,7 @@ module Clacky
                 :latest_latency,  # Hash of latency metrics from the most recent LLM call (see Client#send_messages_with_tools)
                 :reasoning_effort
     attr_accessor :pinned
+    attr_accessor :channel_info
 
     REASONING_EFFORTS = %w[low medium high].freeze
 
@@ -72,6 +73,7 @@ module Clacky
       @config = config.is_a?(AgentConfig) ? config : AgentConfig.new(config)
       @agent_profile = AgentProfile.load(profile)
       @source = source.to_sym  # :manual | :cron | :channel
+      @channel_info = nil  # { platform:, user_id:, user_name:, chat_id: } set by ChannelManager
       @tool_registry = ToolRegistry.new
       @hooks = HookManager.new
       @session_id = session_id
@@ -1593,6 +1595,13 @@ module Clacky
         desktop ? "Desktop: #{desktop}" : nil,
         "Working directory: #{@working_dir}"
       ].compact.join(". ")
+      if @channel_info
+        platform = @channel_info[:platform].to_s
+        user_id  = @channel_info[:user_id].to_s
+        user_name = @channel_info[:user_name].to_s
+        sender = user_name.empty? ? user_id : "@#{user_name}(#{user_id})"
+        parts = "#{parts}. Channel: #{platform}, Sender: #{sender}"
+      end
 
       content = "[Session context: #{parts}]"
 

data/lib/clacky/agent_config.rb

@@ -151,8 +151,16 @@ module Clacky
 
     PERMISSION_MODES = [:auto_approve, :confirm_safes, :confirm_all].freeze
 
+    # Conversation-history compression defaults. Both are user-configurable
+    # via `settings.compression_threshold` / `settings.message_count_threshold`
+    # in ~/.clacky/config.yml — local-model users (llama.cpp / ollama / vllm)
+    # typically lower compression_threshold to fit their server's context window.
+    DEFAULT_COMPRESSION_THRESHOLD = 150_000
+    DEFAULT_MESSAGE_COUNT_THRESHOLD = 200
+
     attr_accessor :permission_mode, :max_tokens, :verbose,
                   :enable_compression, :enable_prompt_caching,
+                  :compression_threshold, :message_count_threshold,
                   :models, :current_model_index, :current_model_id,
                   :memory_update_enabled, :skill_evolution,
                   :max_running_agents, :max_idle_agents,
@@ -165,6 +173,13 @@ module Clacky
       @enable_compression = options[:enable_compression].nil? ? true : options[:enable_compression]
       # Enable prompt caching by default for cost savings
       @enable_prompt_caching = options[:enable_prompt_caching].nil? ? true : options[:enable_prompt_caching]
+      # Token threshold that triggers proactive history compression. Local models
+      # (llama.cpp, ollama, vllm) often have small context windows (e.g. 64k);
+      # users with such setups should lower this to avoid hitting the server-side ceiling.
+      @compression_threshold = options[:compression_threshold] || DEFAULT_COMPRESSION_THRESHOLD
+      # Message-count threshold that also triggers compression, independent of token count.
+      # Guards against pathological histories with many tiny messages.
+      @message_count_threshold = options[:message_count_threshold] || DEFAULT_MESSAGE_COUNT_THRESHOLD
 
       # Models configuration
       @models = options[:models] || []
@@ -387,7 +402,9 @@ module Clacky
     # Settings keys that are persisted to config.yml.
     # These map directly to AgentConfig accessors.
     CONFIG_SETTINGS_KEYS = %w[
-      enable_compression enable_prompt_caching memory_update_enabled
+      enable_compression enable_prompt_caching
+      compression_threshold message_count_threshold
+      memory_update_enabled
       skill_evolution max_running_agents max_idle_agents
       default_working_dir
     ].freeze
@@ -402,6 +419,8 @@ module Clacky
       settings = {
         "enable_compression" => @enable_compression,
         "enable_prompt_caching" => @enable_prompt_caching,
+        "compression_threshold" => @compression_threshold,
+        "message_count_threshold" => @message_count_threshold,
         "memory_update_enabled" => @memory_update_enabled,
         "skill_evolution" => @skill_evolution,
         "max_running_agents" => @max_running_agents,

data/lib/clacky/brand_config.rb

@@ -783,6 +783,7 @@ module Clacky
 
       FileUtils.rm_f(tmp_zip)
 
+
       record_installed_skill(slug, version, skill_info["description"],
                              encrypted: encrypted,
                              description_zh: skill_info["description_zh"],

data/lib/clacky/cli.rb

@@ -53,6 +53,7 @@ module Clacky
     option :list, type: :boolean, aliases: "-l", desc: "List recent sessions"
     option :attach, type: :string, aliases: "-a", desc: "Attach to session by number or keyword"
     option :json, type: :boolean, default: false, desc: "Output NDJSON to stdout (for scripting/piping)"
+    option :ui, type: :string, default: nil, desc: "Interactive UI implementation: ui2, rich (default: ui2)"
     option :message, type: :string, aliases: "-m", desc: "Run non-interactively with this message and exit"
     option :file,  type: :array, aliases: "-f", desc: "File path(s) to attach (use with -m; supports images and documents)"
     option :image, type: :array, aliases: "-i", desc: "Image file path(s) to attach (alias for --file, kept for compatibility)"
@@ -725,27 +726,47 @@ module Clacky
         # Brand license check — must happen before UI2 starts (raw terminal mode conflict)
         check_brand_license_cli
 
-        # Detect terminal background BEFORE starting UI2 to avoid output interference
-        is_dark_bg = UI2::TerminalDetector.detect_dark_background
+        ui_name = (options[:ui] || ENV["OPENCLACKY_UI"] || "ui2").to_s
 
-        # Pass detected background mode to theme manager (singleton)
-        UI2::ThemeManager.instance.set_background_mode(is_dark_bg)
+        ui_controller = if ui_name == "rich"
+          if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("2.6.0")
+            say "Error: Rich UI requires Ruby >= 2.6. Use --ui ui2 on Ruby #{RUBY_VERSION}.", :red
+            exit 1
+          end
+          require_relative "rich_ui_controller"
+          RichUIController.new(
+            working_dir: working_dir,
+            mode: agent_config.permission_mode.to_s,
+            model: agent_config.model_name,
+            theme: options[:theme]
+          )
+        else
+          unless ui_name == "ui2"
+            say "Error: Unknown UI '#{ui_name}'. Available UIs: ui2, rich", :red
+            exit 1
+          end
+          # Detect terminal background BEFORE starting UI2 to avoid output interference
+          is_dark_bg = UI2::TerminalDetector.detect_dark_background
 
-        # Validate theme
-        theme_name = options[:theme] || "hacker"
-        available_themes = UI2::ThemeManager.available_themes.map(&:to_s)
-        unless available_themes.include?(theme_name)
-          say "Error: Unknown theme '#{theme_name}'. Available themes: #{available_themes.join(', ')}", :red
-          exit 1
-        end
+          # Pass detected background mode to theme manager (singleton)
+          UI2::ThemeManager.instance.set_background_mode(is_dark_bg)
 
-        # Create UI2 controller with configuration
-        ui_controller = UI2::UIController.new(
-          working_dir: working_dir,
-          mode: agent_config.permission_mode.to_s,
-          model: agent_config.model_name,
-          theme: theme_name
-        )
+          # Validate theme
+          theme_name = options[:theme] || "hacker"
+          available_themes = UI2::ThemeManager.available_themes.map(&:to_s)
+          unless available_themes.include?(theme_name)
+            say "Error: Unknown theme '#{theme_name}'. Available themes: #{available_themes.join(', ')}", :red
+            exit 1
+          end
+
+          # Create UI2 controller with configuration
+          UI2::UIController.new(
+            working_dir: working_dir,
+            mode: agent_config.permission_mode.to_s,
+            model: agent_config.model_name,
+            theme: theme_name
+          )
+        end
 
         # Inject UI into agent
         agent.instance_variable_set(:@ui, ui_controller)
@@ -758,6 +779,7 @@ module Clacky
 
         # Track current working thread (agent or idle compression that can be interrupted)
         current_task_thread = nil
+        shutting_down = false
 
         # Idle compression timer - triggers compression after 180s of inactivity
         idle_timer = Clacky::IdleCompressionTimer.new(
@@ -816,7 +838,9 @@ module Clacky
             end
 
             # Stop UI and exit
-            ui_controller.stop
+            shutting_down = true
+            idle_timer.shutdown
+            ui_controller.stop(clear_screen: true)
             exit(0)
           end
 
@@ -867,7 +891,9 @@ module Clacky
             ui_controller.update_todos([])
             next
           when "/exit", "/quit"
-            ui_controller.stop
+            shutting_down = true
+            idle_timer.shutdown
+            ui_controller.stop(clear_screen: true)
             exit(0)
           when "/help"
             sleep 0.1
@@ -909,7 +935,7 @@ module Clacky
             ensure
               current_task_thread = nil
               # Start idle timer after agent completes
-              idle_timer.start
+              idle_timer.start unless shutting_down
             end
           end
         end
@@ -928,7 +954,8 @@ module Clacky
         ui_controller.start_input_loop
 
         # Cleanup: kill any running threads
-        idle_timer.cancel
+        shutting_down = true
+        idle_timer.shutdown
         current_task_thread&.kill
 
         # Save final session state

data/lib/clacky/idle_compression_timer.rb

@@ -32,6 +32,7 @@ module Clacky
       @timer_thread    = nil
       @compress_thread = nil
       @mutex           = Mutex.new
+      @shutdown        = false
     end
 
     # Start (or restart) the idle timer.
@@ -39,24 +40,35 @@ module Clacky
     def start
       cancel # reset any existing timer
 
-      @timer_thread = Thread.new do
-        Thread.current.name = "idle-compression-timer"
-        sleep IDLE_DELAY
-
-        # Register @compress_thread inside the mutex BEFORE the thread starts running,
-        # so cancel() can always find and interrupt it even if it fires immediately.
-        compress_thread = nil
-        @mutex.synchronize do
-          compress_thread = Thread.new do
-            Thread.current.name = "idle-compression-work"
-            run_compression
+      @mutex.synchronize do
+        return false if @shutdown
+
+        @timer_thread = Thread.new do
+          Thread.current.name = "idle-compression-timer"
+          sleep IDLE_DELAY
+          next if shutdown?
+
+          # Register @compress_thread inside the mutex BEFORE the thread starts running,
+          # so cancel() can always find and interrupt it even if it fires immediately.
+          compress_thread = nil
+          @mutex.synchronize do
+            unless @shutdown
+              compress_thread = Thread.new do
+                Thread.current.name = "idle-compression-work"
+                run_compression
+              end
+              @compress_thread = compress_thread
+            end
           end
-          @compress_thread = compress_thread
-        end
 
-        compress_thread.join
-        @mutex.synchronize { @compress_thread = nil; @timer_thread = nil }
+          compress_thread&.join
+          @mutex.synchronize { @compress_thread = nil; @timer_thread = nil }
+        end
       end
+      true
+    rescue ThreadError => e
+      log("Idle compression timer could not start: #{e.message}", level: :debug)
+      false
     end
 
     # Cancel the timer and any in-progress compression.
@@ -81,6 +93,13 @@ module Clacky
       compress_thread_to_join&.join(5)
     end
 
+    # Permanently stop this timer. Used during application shutdown so
+    # background agent-thread ensure blocks cannot create new timer threads.
+    def shutdown
+      @mutex.synchronize { @shutdown = true }
+      cancel
+    end
+
     # True if the timer or compression is currently active.
     def active?
       @mutex.synchronize { @timer_thread&.alive? || @compress_thread&.alive? }
@@ -94,6 +113,10 @@ module Clacky
       @mutex.synchronize { @compress_thread&.alive? || false }
     end
 
+    def shutdown?
+      @mutex.synchronize { @shutdown }
+    end
+
     private def run_compression
       success = @agent.trigger_idle_compression
 

data/lib/clacky/providers.rb

@@ -170,8 +170,8 @@ module Clacky
         "name" => "Minimax",
         "base_url" => "https://api.minimaxi.com/v1",
         "api" => "openai-completions",
-        "default_model" => "MiniMax-M2.7",
-        "models" => ["MiniMax-M2.5", "MiniMax-M2.7"],
+        "default_model" => "MiniMax-M3",
+        "models" => ["MiniMax-M3", "MiniMax-M2.7", "MiniMax-M2.5"],
         # MiniMax operates two regional endpoints with identical APIs & model
         # lineup — mainland China (.com) and international (.io). Listing both
         # lets find_by_base_url identify either one as provider "minimax",
@@ -182,7 +182,12 @@ module Clacky
           { "label" => "International",  "label_key" => "settings.models.baseurl.variant.international",  "base_url" => "https://api.minimax.io/v1",   "region" => "intl" }.freeze
         ].freeze,
         # MiniMax M2.x does not support multimodal/vision input on this endpoint.
+        # M3 (released 2026-06-01) is natively multimodal and accepts image
+        # input, so it overrides the provider-level vision=false below.
         "capabilities" => { "vision" => false }.freeze,
+        "model_capabilities" => {
+          "MiniMax-M3" => { "vision" => true }.freeze
+        }.freeze,
         "website_url" => "https://www.minimaxi.com/user-center/basic-information/interface-key"
       }.freeze,