openclacky 1.5.10 → 1.5.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '038138bc72f3f740ed3ccee6da3f6464f80fd0cf1d0466788879a4472ac127b1'
-  data.tar.gz: dfb75e0b2e832e923c34a1f5e61b4a005bd29435f3724763128b0fadc0b6ec1b
+  metadata.gz: 858730306a6e6647d79a5ebb35160c52fba7ed26c62ec97043373e7f052332e2
+  data.tar.gz: b412bc405daae81f1b6d71dd4dd2dffc197a00ac97540ecfd4916f7daf58843d
 SHA512:
-  metadata.gz: c72531566a2b744a279e54907f750ff67e518963c9d42216dde3cb05048e4c86688dbb2ebfe908b31b7f7df8d2332df0ab0b11e0977ab5c486ca5c83b565eafc
-  data.tar.gz: 584975067a26ebfc123e9f9a7f168ef45aab93f783e91da576510f416554c0ba4598e88064db7f71c0f6a30dfda949a4f36cc35d69aa35973489be800422a6b2
+  metadata.gz: 685d67556e68efd81a8bc446edd473a57939f0404b754e4432c7d29e073d2c47adc0c939fc5da3ea32144f3c6026aa17d73ff4766420399515089a3a8a4bc98d
+  data.tar.gz: dc85168d4b103185d20087635cfc5972c4e3e23b8dee95cb2ba28017d276dda425d8d92d23159dad463bd6cdcc29b8e02404d50dd4a79e5e6345193e8b4167c8

data/CHANGELOG.md

@@ -4,6 +4,66 @@ 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.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
+- Creator Studio: separate Marketplace and Brand sections for published extensions
+- Advisor extension for next-job suggestions
+- ask_user tool with multi-question support (replaces feedback_user)
+- Sidebar states for awaiting-feedback and just-finished sessions
+- Auto-purge file-trash entries older than 8 days
+- DeepSeek V4 flash vision exp model preset
+- IM channel toggle to mute tool-call narration and previews
+
+### Improved
+- Unified internal thread management with graceful shutdown
+
+### Fixed
+- Skill decrypt retry now picks up a renewed license key
+- DeepSeek weekends billed entirely at off-peak rates
+- Skill and extension zip downloads fall back to a secondary CDN host
+- Session status dot aligned with name and channel badge
+- Project session tag top margin
+- Unified modal close button and ext-studio modal semantics
+- Unified checkbox accent and distinct verified badge
+- Edit-model modal overflow on small screens
+- Subagent UI fixes
+- Star History charts migrated to star-history.dera.page (#491 - @CrustyMozarella)
+
 ## [1.5.10] - 2026-08-19
 
 ### Added

data/README.md

@@ -209,11 +209,11 @@ $ openclacky
 
 ## Star History
 
-<a href="https://www.star-history.com/?repos=clacky-ai%2Fopenclacky&type=date&legend=top-left">
+<a href="https://star-history.dera.page/#clacky-ai/openclacky&type=date&legend=top-left">
  <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&legend=top-left" />
  </picture>
 </a>
 

data/README_CN.md

@@ -204,11 +204,11 @@ $ openclacky
 
 ## Star 历史
 
-<a href="https://www.star-history.com/?repos=clacky-ai%2Fopenclacky&type=date&legend=top-left">
+<a href="https://star-history.dera.page/#clacky-ai/openclacky&type=date&legend=top-left">
  <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&legend=top-left" />
  </picture>
 </a>
 

data/README_JA.md

@@ -209,11 +209,11 @@ $ openclacky
 
 ## Star History
 
-<a href="https://www.star-history.com/?repos=clacky-ai%2Fopenclacky&type=date&legend=top-left">
+<a href="https://star-history.dera.page/#clacky-ai/openclacky&type=date&legend=top-left">
  <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=clacky-ai/openclacky&type=date&legend=top-left" />
  </picture>
 </a>
 

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/llm_caller.rb

@@ -95,6 +95,7 @@ module Clacky
 
         begin
           begin
+          Clacky::Shutdown.checkpoint!
           # Use active_messages (Time Machine) when undone, otherwise send full history.
           # to_api strips internal fields and handles orphaned tool_calls.
           messages_to_send = if respond_to?(:active_messages)
@@ -167,6 +168,7 @@ module Clacky
           end
 
         rescue Faraday::TimeoutError => e
+          Clacky::Shutdown.checkpoint!
           # Faraday::TimeoutError on our non-streaming POST almost always means
           # the *response* took longer than the 300s read-timeout to come back —
           # i.e. the model is trying to produce a huge output in one shot
@@ -198,7 +200,7 @@ module Clacky
               metadata: { attempt: retries, total: max_retries }
             )
             retrying_progress_opened = true
-            sleep retry_delay
+            Clacky::Shutdown.sleep(retry_delay)
             retry
           else
             # All retries exhausted for a timeout. Try the secondary gateway URL if available.
@@ -219,6 +221,7 @@ module Clacky
           end
 
         rescue Faraday::ConnectionFailed, Faraday::SSLError, Errno::ECONNREFUSED, Errno::ETIMEDOUT, Errno::EPIPE => e
+          Clacky::Shutdown.checkpoint!
           retries += 1
 
           # Errno::EPIPE means the underlying TCP socket is dead (server closed the
@@ -245,7 +248,7 @@ module Clacky
               metadata: { attempt: retries, total: max_retries }
             )
             retrying_progress_opened = true
-            sleep retry_delay
+            Clacky::Shutdown.sleep(retry_delay)
             retry
           else
             # All retries on the primary endpoint exhausted for a network-level
@@ -269,6 +272,7 @@ module Clacky
           end
 
         rescue RetryableError => e
+          Clacky::Shutdown.checkpoint!
           retries += 1
 
           # Probing failure: primary still down — renew cooling-off and retry with fallback.
@@ -298,7 +302,7 @@ module Clacky
             metadata: { attempt: retries, total: current_max }
           )
           retrying_progress_opened = true
-          sleep retry_delay
+          Clacky::Shutdown.sleep(retry_delay)
           retry
         else
           # All retries on the current endpoint exhausted.

data/lib/clacky/agent/message_compressor_helper.rb

@@ -624,7 +624,7 @@ module Clacky
 
           case role
           when "user"
-            lines << "## User"
+            lines << (msg[:task_id] ? "## User [Task #{msg[:task_id]}]" : "## User")
             lines << ""
             lines << format_message_content(content)
             lines << ""

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]) }
@@ -544,14 +552,16 @@ module Clacky
             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]
             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
@@ -733,7 +743,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
@@ -742,16 +752,17 @@ module Clacky
             args_raw = tc[:arguments] || tc.dig(:function, :arguments) || {}
             args     = args_raw.is_a?(String) ? (JSON.parse(args_raw) rescue args_raw) : args_raw
 
-            # Special handling: request_user_feedback question is shown as an
-            # assistant message (matching real-time behavior), not as a tool call.
-            # Reconstruct the full formatted message including options (mirrors RequestUserFeedback#execute).
-            if name == "request_user_feedback"
-              question = args.is_a?(Hash) ? (args[:question] || args["question"]).to_s : ""
-              context  = args.is_a?(Hash) ? (args[:context]  || args["context"]).to_s  : ""
-              options  = args.is_a?(Hash) ? (args[:options]  || args["options"])        : nil
-              options  = Array(options) if options && !options.is_a?(Array)
+            # Special handling: the ask_user question is shown as an assistant
+            # message (matching real-time behavior), not as a tool call.
+            if Clacky::Tools::AskUser.feedback_tool?(name)
+              questions = Clacky::Tools::AskUser.normalize_questions(args)
+              context   = Clacky::Tools::AskUser.fetch_key(args, :context).to_s
+              first     = questions.first
 
-              ui.show_feedback_request(question, context, options || []) unless question.empty?
+              unless first.nil?
+                ui.show_feedback_request(first[:question], context, first[:options],
+                                         questions: questions)
+              end
             else
               ui.show_tool_call(name, args)
             end
@@ -760,6 +771,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)
@@ -796,19 +812,32 @@ module Clacky
         end
       end
 
-      # Replay a subagent transcript stored on a tool result message. Emits a
+      # Replay subagent transcripts stored on a tool result message. Emits a
       # bracketed sequence of UI events the frontend can render as a collapsible
       # sub-process block: subagent_start → (assistant_message / tool_call /
-      # tool_result)* → subagent_end. No-op when the message carries no transcript.
+      # tool_result)* → subagent_end. A fan-out batch renders one block per job,
+      # in the caller's original job order.
+      #
+      # Sessions saved before fan-out support stored a bare Hash here.
       def replay_subagent_transcript(msg, ui)
-        transcript = msg[:subagent_transcript]
-        return unless transcript.is_a?(Hash)
+        stored = msg[:subagent_transcript]
+        Array(stored.is_a?(Hash) ? [stored] : stored).each do |transcript|
+          next unless transcript.is_a?(Hash)
 
+          replay_one_subagent_transcript(transcript, ui)
+        end
+      end
+
+      def replay_one_subagent_transcript(transcript, ui)
         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"]
         )
@@ -821,7 +850,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"] || {}
@@ -834,6 +863,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.

data/lib/clacky/agent/skill_manager.rb

@@ -651,8 +651,7 @@ module Clacky
         # observe() attaches each trail to its own tool result message.
         # Kept out of the LLM payload via INTERNAL_FIELDS.
         if tool_call_id
-          @pending_subagent_transcripts[tool_call_id] =
-            extract_subagent_transcript(subagent, skill.identifier)
+          record_subagent_transcript(tool_call_id, subagent, skill.identifier)
         end
 
         # Mutate the subagent_instructions message in-place to become the result summary

data/lib/clacky/agent/time_machine.rb

@@ -589,6 +589,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],

data/lib/clacky/agent/tool_executor.rb

@@ -13,7 +13,7 @@ module Clacky
         case @config.permission_mode
         when :auto_approve, :confirm_all
           # Both modes auto-execute all file/shell tools without confirmation.
-          # The difference is only in request_user_feedback handling:
+          # The difference is only in ask_user handling:
           #   auto_approve → no human present, inject auto_reply
           #   confirm_all  → human present, truly wait for user input
           true

data/lib/clacky/agent/tool_registry.rb

@@ -55,10 +55,12 @@ module Clacky
       # todo_manager aliases
       "todo" => "todo_manager",
       "task_manager" => "todo_manager",
-      # request_user_feedback aliases
-      "ask_user" => "request_user_feedback",
-      "user_feedback" => "request_user_feedback",
-      "ask" => "request_user_feedback",
+      # ask_user aliases
+      "request_user_feedback" => "ask_user",
+      "user_feedback" => "ask_user",
+      "ask" => "ask_user",
+      "ask_question" => "ask_user",
+      "clarify" => "ask_user",
       # trash_manager aliases
       "trash" => "trash_manager",
       "delete" => "trash_manager",