openclacky 1.5.11 → 1.5.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1cef597eb5d6c066192ba6c2c587e0dcd62fdf2dd9ed422161f71718acbb7f25
-  data.tar.gz: 03bcd29f23eacd7b49a37db0494f7964757391ac52e8f3ef9787c49a6b2f8efb
+  metadata.gz: ca259b2f17df9695e21c4d4c4f18ee83affec0fc41d67db829d903e1c3bb008d
+  data.tar.gz: b0bfd31378c6b452a7aef246d3d316242a91fa6366f543c45edcff8c3f44ac6c
 SHA512:
-  metadata.gz: 7543c4f518bf5a2e20778472e60909b5eda8f727015b66aad37c69b2d256b53ba3cd5126d2b385a06456a45a6531fe4fdaad7c6d7f8b247aeb2a76bf1446a9f1
-  data.tar.gz: d6ceb974a12d29096ae65bcbed3d6c6467880005101664919357572201846792faf4f89956ff5ca568519d74960674e214a39c61333e527741a9eb38083fcbf1
+  metadata.gz: cfcb5b28264aeb2acb6b121b89c395e4e9241b3a3135c2e9fb7d565365ed263c701f939448a2c01cb229359cca11402b36b081d4edff6231ce8e46e72d253498
+  data.tar.gz: 95cca310ebd8e0a23b1f1e5aed241b6e5fbc19aa206fdb16301dfd3b90f07e33424a44686c10b2d6cf4d3344c75eab2c033d7b3e4e7ef6c9a40b7879dd07a88b

data/CHANGELOG.md

@@ -4,6 +4,88 @@ 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/),
 
+## [1.5.13] - 2026-09-03
+
+### Added
+- Add Gemini 3.8 Flash model and set it as the trial default
+- Add or-stt-gemini-3-8-flash speech-to-text model; default STT and video understanding to 3.8
+- Add OpenAI Responses API as a fourth API format (#490 - @kylezhang)
+- Add access-key API and config-reload API
+- Add Claude Fable 5.1, GLM-5.3-Flash and qwen3.8-max models with pricing
+- Default the Web UI to the OS/browser language on first visit
+- Make the workspace file tree resizable
+- Expose mounted drives in the directory picker
+- Personalize the new-session page title and empty-chat greeting with the AI's name
+- Localise built-in setup session titles
+
+### Improved
+- Replace native selects with shared CustomSelect dropdowns across settings
+- Overhaul the git & time-machine panel
+- Improve the directory picker (#521)
+
+### Fixed
+- Merge OpenClacky billing across all configured API keys
+- Preserve custom provider and API format when editing a model
+- Reclaim PTY file descriptors when a session shell dies
+- Wrap ANSI-coloured CJK text without IndexError
+- Prevent history edits while a session is running (#520)
+- Preserve attachment badges after compression (#516)
+- Flag hidden agents instead of dropping them
+- Install upgrades next to the running gem's base directory
+- Skip extension auto-sync for administrators (#515)
+- Support the mention menu with Windows IME (#513)
+- Validate extension version input (#514)
+- Keep mention chips anchored and on one line while typing
+- Fall back to uncolored markdown for CJK tables
+- Stabilise billing toolbar layout (#517)
+- Light the group unread dot for backend-created sessions (#518)
+- Translate maximum reasoning effort (#522)
+- Harden WSL Windows profile detection in the directory picker
+- Wrap download errors so the CDN fallback fires
+- Surface the git tab badge eagerly
+- Show the meeting panel only in general sessions
+- Whitelist the config top-level key in the extension verifier
+
+### More
+- Extract shared ModelPicker model dropdown component
+- Refine dropdown chevrons and submenu selection
+- Adjust sidebar panel order and labels
+- Update trial model copy to Gemini 3.7 Flash
+
+## [1.5.12] - 2026-08-27
+
+### Added
+- Add VS Code-style file tree with inline file viewer
+- Add quick-access sidebar for directory picker with WSL support
+- Add Web UI @mention references for files, directories and sessions
+- Add Gemini 3.7 Flash model with STT/video support; switch OCR default to DeepSeek vision
+- Add timestamps to assistant messages
+- Merge platform usage API data with local billing records
+- Refresh git panel on session completion
+- Allow disabling local extensions
+- Expose task mappings in core events (#496 - @YeEmrick)
+
+### Improved
+- Move file-trash sweep off the session save path and speed up session creation
+- Make recharge link a visible button on model cards
+
+### Fixed
+- Fix ask_user free-text input: render without options, guard IME composition, route Enter, render as text in IM channels, keep questions concise (#497 - @afumu)
+- Fix advisor recommendations: send structured options, keep card state per session, dismiss button no longer permanently suppresses
+- Fix home favorite pointing at the Windows profile under WSL
+- Fix session list pagination and pin truncation
+- Preserve task ids in compressed history (#500 - @YeEmrick)
+- Clear stale media model override when reverting to auto
+- Normalize gemini-3.7-flash name for pricing
+- Fix sidebar scrollbar visibility and session list styling
+- Fix messages loading created_at
+- Render parallel fan-out subagent phases as flat, isolated cards
+- Preserve subagent transcripts when an interrupted fan-out is resumed
+- Fix spinner in subagent raise process
+- Truncate messages carrying the system_injected flag
+- Stop reporting awaiting_feedback for question-mark endings
+- Detach channel_ui and keep channel_info unique on /bind and /unbind
+
 ## [1.5.11] - 2026-08-23
 
 ### Added

data/lib/clacky/access_key.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "securerandom"
+
+module Clacky
+  # Access key for server-mode authentication.
+  #
+  # Two sources, in priority order:
+  #   1. ~/.clacky/access_key — a file holding the raw key, writable from
+  #      outside the process (e.g. a sandbox host pushing a key into a
+  #      pre-started container). This is what makes rotation possible:
+  #      ENV is a boot-time snapshot the running process can never change.
+  #   2. CLACKY_ACCESS_KEY env var — the original bootstrap mechanism.
+  module AccessKey
+    ENV_VAR = "CLACKY_ACCESS_KEY"
+
+    def self.resolve
+      from_file || from_env
+    end
+
+    def self.from_file
+      return nil unless File.exist?(key_file)
+
+      key = File.read(key_file).strip
+      key.empty? ? nil : key
+    rescue StandardError
+      nil
+    end
+
+    def self.from_env
+      key = ENV.fetch(ENV_VAR, "").strip
+      key.empty? ? nil : key
+    end
+
+    def self.write(key)
+      key = key.to_s.strip
+      raise ArgumentError, "access key must not be blank" if key.empty?
+
+      FileUtils.mkdir_p(File.dirname(key_file))
+      File.write(key_file, "#{key}\n")
+      FileUtils.chmod(0o600, key_file)
+      key
+    end
+
+    def self.generate
+      SecureRandom.hex(32)
+    end
+
+    def self.configured?
+      !resolve.nil?
+    end
+
+    # Resolved lazily so specs that stub Dir.home in a before-hook still work.
+    def self.key_file
+      File.join(Dir.home, ".clacky", "access_key")
+    end
+  end
+end

data/lib/clacky/agent/cost_tracker.rb

@@ -136,11 +136,13 @@ module Clacky
         # This ensures all API calls are recorded for statistics purposes.
         billing_model = model || current_model
         effective_cost = cost || 0.0  # Use 0 if pricing is unknown
+        provider = @config.provider_id_for(@config.current_model)
 
         record = Billing::BillingRecord.new(
           session_id: @session_id,
           timestamp: Time.now,
           model: billing_model,
+          provider: provider,
           prompt_tokens: usage[:prompt_tokens] || 0,
           completion_tokens: usage[:completion_tokens] || 0,
           cache_read_tokens: usage[:cache_read_input_tokens] || 0,

data/lib/clacky/agent/message_compressor_helper.rb

@@ -624,10 +624,12 @@ module Clacky
 
           case role
           when "user"
-            lines << "## User"
+            display_files = display_files_for_archive(msg)
+            lines << (msg[:task_id] ? "## User [Task #{msg[:task_id]}]" : "## User")
             lines << ""
-            lines << format_message_content(content)
+            lines << format_archived_user_content(content, display_files)
             lines << ""
+            append_display_files_line(lines, display_files)
             append_ext_events_line(lines, msg)
           when "assistant"
             # If this message is itself a compressed summary, annotate the header
@@ -676,6 +678,55 @@ module Clacky
         lines
       end
 
+      # Serialize only the lightweight UI metadata needed to reconstruct file
+      # badges after compression. File paths, previews, sizes, MIME types, and
+      # contents deliberately stay out of the chunk archive.
+      def display_files_for_archive(msg)
+        files = Array(msg[:display_files]).dup
+        Array(msg[:content]).each do |block|
+          next unless block.is_a?(Hash)
+          next unless %w[image image_url].include?((block[:type] || block["type"]).to_s)
+
+          name = block[:image_name] || block["image_name"]
+          if name.nil? || name.to_s.strip.empty?
+            path = block[:image_path] || block["image_path"]
+            name = File.basename(path.to_s).sub(/\A[0-9a-f]{16}_/, "") unless path.to_s.empty?
+          end
+          name = "image" if name.nil? || name.to_s.strip.empty?
+          files << { name: name, type: "image" }
+        end
+
+        files.filter_map do |file|
+          next unless file.is_a?(Hash)
+
+          name = file[:name] || file["name"]
+          next if name.nil? || name.to_s.strip.empty?
+
+          type = file[:type] || file["type"] || "file"
+          type = "file" if type.to_s.strip.empty?
+          { name: name.to_s, type: type.to_s }
+        end.uniq { |file| [file[:name], file[:type]] }
+      end
+
+      # Once an image has a badge in the archive, omit the generic [image_url]
+      # placeholder from the visible replay text. Text blocks remain unchanged.
+      def format_archived_user_content(content, display_files)
+        return format_message_content(content) unless content.is_a?(Array)
+        return format_message_content(content) unless display_files.any? { |file| file[:type] == "image" }
+
+        visible_blocks = content.reject do |block|
+          block.is_a?(Hash) && %w[image image_url].include?((block[:type] || block["type"]).to_s)
+        end
+        format_message_content(visible_blocks)
+      end
+
+      def append_display_files_line(lines, files)
+        return if files.empty?
+
+        lines << "_Display files: #{files.to_json}_"
+        lines << ""
+      end
+
       # Serialize persisted extension events into the chunk MD so they survive
       # compression and can be replayed in place. Mirrors the "_Tool calls:"
       # convention; parse_chunk_md_to_rounds reads it back.

data/lib/clacky/agent/session_serializer.rb

@@ -391,7 +391,11 @@ module Clacky
               preview_path: f[:preview_path] || f["preview_path"] }
           }
           all_files = image_files + disk_files
-          ui.show_user_message(raw_text, created_at: msg[:created_at], files: all_files,
+          references = Array(msg[:display_references])
+          ref_options = references.empty? ? {} : { references: references }
+          task_options = msg[:task_id] ? { task_id: msg[:task_id] } : {}
+          ui.show_user_message(raw_text, **task_options, created_at: msg[:created_at], files: all_files,
+                               **ref_options,
                                editable: round[:editable] != false,
                                skill_command: msg[:skill_command],
                                skill_command_display: msg[:skill_command_display])
@@ -490,30 +494,34 @@ module Clacky
         current_role       = nil
         current_lines      = []
         current_nested_chunk = nil  # chunk reference from a Compressed Summary heading
+        current_task_id    = nil
 
         raw.each_line do |line|
           stripped = line.chomp
           if (m = stripped.match(/\A## Assistant \[Compressed Summary — original conversation at: (.+)\]/))
             # Nested chunk reference — record it, treat as assistant section
-            sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk } if current_role
+            sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk, task_id: current_task_id } if current_role
             current_role         = "assistant"
             current_lines        = []
             current_nested_chunk = File.join(chunk_dir, m[1])
-          elsif stripped.match?(/\A## (User|Assistant)/)
-            sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk } if current_role
-            current_role         = stripped.match(/\A## (User|Assistant)/)[1].downcase
+            current_task_id      = nil
+          elsif (m = stripped.match(/\A## (User|Assistant)(?: \[Task ([1-9]\d*)\])?\z/))
+            sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk, task_id: current_task_id } if current_role
+            current_role         = m[1].downcase
             current_lines        = []
             current_nested_chunk = nil
+            current_task_id      = m[2]&.to_i
           elsif stripped.match?(/\A### Tool Result:/)
-            sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk } if current_role
+            sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk, task_id: current_task_id } if current_role
             current_role         = "tool"
             current_lines        = []
             current_nested_chunk = nil
+            current_task_id      = nil
           else
             current_lines << line
           end
         end
-        sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk } if current_role
+        sections << { role: current_role, lines: current_lines.dup, nested_chunk: current_nested_chunk, task_id: current_task_id } if current_role
 
         # Remove front-matter / header noise sections (nil role or non-user/assistant/tool)
         sections.select! { |s| %w[user assistant tool].include?(s[:role]) }
@@ -526,6 +534,7 @@ module Clacky
         sections.each do |sec|
           text = sec[:lines].join.strip
           text, sec_ext_events = extract_ext_events_from_text(text)
+          text, sec_display_files = extract_display_files_from_text(text)
 
           # Nested chunk: expand it recursively, prepend before current rounds
           if sec[:nested_chunk]
@@ -538,20 +547,23 @@ module Clacky
             next
           end
 
-          next if text.empty? && sec_ext_events.empty?
+          next if text.empty? && sec_ext_events.empty? && sec_display_files.empty?
 
           if sec[:role] == "user"
             round_index += 1
             # Synthetic timestamp: spread rounds backwards from archived_at
             synthetic_ts = base_time - (sections.size - round_index) * 1.0
+            user_msg = {
+              role: "user",
+              content: text,
+              created_at: synthetic_ts,
+              ext_events: sec_ext_events,
+              _from_chunk: true
+            }
+            user_msg[:task_id] = sec[:task_id] if sec[:task_id]
+            user_msg[:display_files] = sec_display_files unless sec_display_files.empty?
             current_round = {
-              user_msg: {
-                role: "user",
-                content: text,
-                created_at: synthetic_ts,
-                ext_events: sec_ext_events,
-                _from_chunk: true
-              },
+              user_msg: user_msg,
               events: [],
               # editable: false — this message was archived into a chunk MD and no
               # longer exists in the active in-memory @history, so it cannot be
@@ -608,6 +620,35 @@ module Clacky
       end
 
 
+      # Pull lightweight attachment badge metadata out of a chunk section.
+      # The marker is internal archive data and must not appear in replayed text.
+      # Only name + type are accepted; paths and file contents are never restored.
+      def extract_display_files_from_text(text)
+        return [text, []] unless text.include?("_Display files:")
+
+        files = []
+        kept = text.each_line.reject do |line|
+          match = line.strip.match(/\A_Display files:\s*(\[.*\])_?\z/i)
+          next false unless match
+
+          parsed = JSON.parse(match[1]) rescue []
+          Array(parsed).each do |file|
+            next unless file.is_a?(Hash)
+
+            name = file["name"] || file[:name]
+            next if name.nil? || name.to_s.strip.empty?
+
+            type = file["type"] || file[:type] || "file"
+            type = "file" if type.to_s.strip.empty?
+            files << { name: name.to_s, type: type.to_s }
+          end
+          true
+        end
+
+        [kept.join.strip, files]
+      end
+
+
       # Pull the "_Ext events: type | {json}; ..._" line out of a chunk section,
       # returning the remaining text plus the parsed events. Counterpart to
       # MessageCompressorHelper#append_ext_events_line.
@@ -733,7 +774,7 @@ module Clacky
             else
               raw_text
             end
-            ui.show_assistant_message(text, files: [])
+            ui.show_assistant_message(text, files: [], created_at: msg[:created_at])
           end
 
           # Tool calls embedded in assistant message
@@ -761,6 +802,11 @@ module Clacky
           # Emit token usage stored on this message (for history replay display)
           ui.show_token_usage(msg[:token_usage]) if msg[:token_usage]
 
+          # Interrupted fan-out anchors its captured subagent trails onto the
+          # last message, which is usually this assistant turn (its tool result
+          # never got written). Replay them here so they survive a reload.
+          replay_subagent_transcript(msg, ui)
+
         when "user"
           # Anthropic-format tool results (role: user, content: array of tool_result blocks)
           if msg[:content].is_a?(Array)
@@ -817,8 +863,12 @@ module Clacky
         events = transcript[:events] || transcript["events"] || []
         return if events.empty?
 
+        skill = transcript[:skill] || transcript["skill"]
+        supports_phase = ui.respond_to?(:phase_start) && ui.respond_to?(:phase_end)
+        pid = ui.phase_start(kind: "fanout_subagent", label: skill) if supports_phase
+
         ui.show_subagent_start(
-          skill:      transcript[:skill]      || transcript["skill"],
+          skill:      skill,
           iterations: transcript[:iterations] || transcript["iterations"],
           cost_usd:   transcript[:cost_usd]   || transcript["cost_usd"]
         )
@@ -831,7 +881,7 @@ module Clacky
           case role
           when "assistant"
             text = extract_text_from_content(content).to_s.strip
-            ui.show_assistant_message(text, files: []) unless text.empty?
+            ui.show_assistant_message(text, files: [], created_at: ev[:created_at] || ev["created_at"]) unless text.empty?
             Array(tool_calls).each do |tc|
               name = tc[:name] || tc["name"] || ""
               args_raw = tc[:arguments] || tc["arguments"] || {}
@@ -844,6 +894,7 @@ module Clacky
         end
 
         ui.show_subagent_end
+        ui.phase_end(pid) if supports_phase && pid
       end
 
       # Replace the system message in @messages with a freshly built system prompt.
@@ -928,7 +979,9 @@ module Clacky
 
           mime_type = (url || "")[/\Adata:([^;]+);/, 1] || "image/jpeg"
           ext       = mime_type.split("/").last
-          { name: "image_#{idx + 1}.#{ext}", mime_type: mime_type, data_url: url, path: path }
+          name      = block[:image_name] || block["image_name"]
+          name      = "image_#{idx + 1}.#{ext}" if name.nil? || name.to_s.strip.empty?
+          { name: name, mime_type: mime_type, data_url: url, path: path }
         end
       end
 

data/lib/clacky/agent/time_machine.rb

@@ -529,7 +529,15 @@ module Clacky
       private def looks_binary?(path)
         return false if path.nil? || !File.exist?(path)
         sample = File.binread(path, 8000)
-        sample.include?("\x00") || !sample.dup.force_encoding("UTF-8").valid_encoding?
+        return true if sample.include?("\x00")
+        sample.force_encoding("UTF-8")
+        # The 8000-byte window can cut a multibyte char in half; drop up to
+        # three dangling tail bytes before judging the encoding.
+        3.times do
+          break if sample.valid_encoding?
+          sample = sample.byteslice(0, sample.bytesize - 1)
+        end
+        !sample.valid_encoding?
       rescue StandardError
         true
       end
@@ -589,6 +597,7 @@ module Clacky
 
           tasks << {
             task_id: task_id,
+            parent_task_id: @task_parents[task_id].to_i,
             summary: summary,
             started_at: meta[:started_at],
             ended_at: meta[:ended_at],