openclacky 1.5.18 → 1.5.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b46c172f8f8a61908656ba6537751f506ae575c4f6d1f50436d87de72355e30
-  data.tar.gz: 58460eb829fcc0cc8326f170b7faa69b2bb60c6ceeca974c2cc98b14406e8dc4
+  metadata.gz: a87f3bff7a9f13d77ae6ae11ccc67a67a6429d596d922309e3f3847469b240f4
+  data.tar.gz: 6f7043a63e27dfb922bac4e586ec19c6d0659efb75ba9ef7e1b522b1a16b9410
 SHA512:
-  metadata.gz: 422feaf84c1f8739a547595a907a0b49ee948cc175c2d87b30ba910fb916cdf4b7dd7a491e589b1852179a3fe6e191090eb2d3467cbd7e92a31c5c0f2869a0b7
-  data.tar.gz: 5a94a088d54c4cec2250ecacad63f8397eb744a8f84e593ee9da0b1b45fdb9e741933ec865131357a6f78e1b091e8fe1ce6dd21b35765a95ce0c77cc5fd5bdd5
+  metadata.gz: 23cc0c1d6902579a09f2cb3c9b9f692c61dcb485daca62ff226ea6fa1c165afa141fbee8ee51de24e97ec4d7060bc872988c6f8b785575180f821a52e68acc26
+  data.tar.gz: d198a4ed2d6887094fe8f90fc1d13a429cd06008f47859acb7b334804d5d8dfc727f31dba6486ae02d11613bfd0dbe2f0004c83090a8e7f457d31891b4e29fae

data/CHANGELOG.md

@@ -4,6 +4,93 @@ 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.20] - 2026-10-15
+
+### Added
+- Add a data management page with session archiving and a recycle bin
+- Add a tab context menu and reopen tabs after a reload
+- Preview audio and video files in the workspace (#634)
+- Preview pending image attachments before sending (#629)
+- Zoom and pan in the viewer's image preview
+- Move the todo list into a session bar popover (#619)
+- Add opt-in per-task feedback countdowns (#633 - @no7dw)
+- Name a session automatically from its first message
+- Show the active session title in the top header
+- Show the QQ bind QR inline with expiry refresh and a sticky success state (#621)
+- Add the oc-grok-4.7, abs-claude-haiku-5-5 and or-gemini-4-argon aliases
+
+### Improved
+- Lead model picker rows with their provider
+- Retune the model series discounts and say where they come from
+- Point the openclacky lite tier at claude-haiku-5-5
+- Soften the segmented control hover
+- Tidy the top-up label and the model row spacing
+- Put the model remark under the API key and align it left
+
+### Fixed
+- Pair replayed tool results with their own calls so a refreshed session no longer strands them in the wrong tool item (#640)
+- Keep the assistant timestamp when a session is archived and replayed from chunk history (#639 - @BoyYangzai)
+- Stop dropping attachment messages while a task is being processed (#628)
+- Handle a missing workspace path in the directory picker (#623)
+- Restore the settings tab after switching sessions (#626)
+- Send model picker actions to the right settings tab (#624)
+- Stop session action buttons from squeezing the session title (#625)
+- Improve the mobile billing chart usability (#627)
+- Stop truncating the navigator preview too early (#632)
+- Refresh the Files tree after restoring a task from the timeline (#638)
+- Checkpoint the latest task after a session reload (#637)
+- Localize screenshot upload errors and retry after binding a device (#636)
+- Persist run errors in the session history
+- Stop pinning an auto-routed task to a dead lane when a failure carries no tier
+- Reword network failures and link them to the key console
+- Align the sidebar toggle buttons and unify their icons at 16px (#622)
+- Fade the collapsed aside opener icon
+
+### More
+- Retire gemini-3.7-flash and drop the oc-minimax-m2.7 alias from the model picker
+- Remove the OrcaRouter and Requesty provider presets
+
+## [1.5.19] - 2026-10-10
+
+### Added
+- Add the built-in QQ official-bot channel (#615 - @chengoak)
+- Drag a session onto a project to move it (#610)
+- Add bookmarks to the chat navigator and tighten its layout (#617)
+- Scroll an overflowing session title on hover so it can be read in full (#618)
+- Add session lifecycle hooks (#607)
+- Rework the billing charts with a year heatmap and a 365-day range
+- Add an "Add Model" button to the model picker
+- Show an API Key hint in the model dialog and restyle the key link
+- Add oc-glm-5.3 and oc-kimi-k3 aliases with pricing and capability caps
+- Add abs-claude-sonnet-5-5 and abs-gpt-6.1-sol with corrected pricing
+- Add Xiaomi MiMo V2.6 models (#614)
+- Add the oc-minimax-m2.7 alias with its launch discount
+- Show a GLM/Kimi series promotion with a badge in the model picker
+- Forward Seedance reference images over the OpenAI-compatible video gateway (#616 - @codevoyager1984)
+- Document the input image limits and the content_filter retry in the media skill (#593 - @codevoyager1984)
+
+### Improved
+- Make the model picker visually distinct from the variant switcher
+- Explain model price discounts with a tooltip
+- Soften the chat navigator tick color
+- Hide the skills tab strip when only one tab is available
+- Tune the billing chart axis labels
+- Clarify ambient audio generation in the media skill (#606 - @YeEmrick)
+
+### Fixed
+- Stop the workspace file tree from flickering on reload
+- Deliver web-originated replies to IM after a finished progress card (#603, #605 - @chengoak)
+- Fall back to gem update when the OSS CDN fails (#583, #608 - @theluckystrike)
+- Keep the chat position when toggling preview fullscreen (#613)
+- Stop opening an empty variant panel for custom models
+- Use a white background for the context bar popovers
+- Point a rate limit error at switching models
+- Skip reasoning fields for non-Anthropic Converse models
+
+### More
+- Rename the billing panel title to Usage
+- Use 服务商 instead of 供应商 in model settings
+
 ## [1.5.18] - 2026-10-02
 
 ### Fixed

data/README.md

@@ -205,7 +205,7 @@ $ openclacky
 
 Set your **API Key**, **Model**, and **Base URL** (any OpenAI-compatible provider).
 
-Supported out of the box: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter · OrcaRouter · Requesty** — or any custom endpoint.
+Supported out of the box: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter** — or any custom endpoint.
 
 ## Coding use case
 

data/README_CN.md

@@ -189,7 +189,7 @@ $ openclacky
 
 设置你的 **API Key**、**模型**和 **Base URL**（任意 OpenAI 兼容提供商）。
 
-开箱即支持：**Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter · OrcaRouter · Requesty**，或任意自定义端点。
+开箱即支持：**Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter**，或任意自定义端点。
 
 ## 代码开发场景
 

data/README_JA.md

@@ -194,7 +194,7 @@ $ openclacky
 
 **API Key**、**Model**、**Base URL**（任意の OpenAI 互換プロバイダー）を設定します。
 
-標準でサポート: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter · OrcaRouter · Requesty** — または任意のカスタムエンドポイント。
+標準でサポート: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter** — または任意のカスタムエンドポイント。
 
 ## コーディングのユースケース
 

data/docs/session-observation-hooks.md

@@ -0,0 +1,86 @@
+# Agent task lifecycle hooks
+
+## Task lifecycle: on_start / on_complete
+
+> Availability: the additional context and abnormal completion paths require
+> the runtime change on branch `session-lifecycle-hooks`. They are not
+> available in 1.5.16. Upgrade the runtime before relying on these fields.
+
+Use the existing events without extra configuration. `on_start` runs after task
+and history initialization, before execution, and retains `deny` / `handled`.
+`on_complete` observes the outcome of each Agent turn, including normal completion,
+waiting, handled starts, denial, exceptions and interruption. Its return value is
+ignored, including `deny` and `handled`; all completion callbacks can run.
+
+Ruby callbacks receive `(input, agent, context)` or `(result, agent, context)`.
+The first two positions are unchanged; ordinary two-argument Ruby blocks ignore
+the extra argument. Existing completion callbacks must check `result[:status] ==
+:success` before doing success-only work. A handled result has `context[:handled]`
+set to true; skip follow-up work already performed by the handler.
+
+These are Agent-turn events for server, CLI and channel execution, not server
+persistence notifications. Queued input emits start only when consumed; steering
+inside an active turn does not create an extra start or completion. Automatic goal
+continuations have their own turn events. Normal completion fires before goal
+continuation, and exceptions still propagate after notification. A superseded
+turn's exception cleanup cannot settle its successor.
+
+Context contains `session_id`, `run_id` (process-local task ID, not durable),
+`source` (execution source, not authenticated identity), `input_created_at` (the
+optional timestamp passed to `run`), `observed_at` (UTC ISO8601), and `status`.
+Start status is `running`. No input text is added to context; input and result
+arguments can contain sensitive data.
+
+| Completion context status | Meaning |
+|---------------------------|---------|
+| `completed` | Result explicitly has `status: :success`, without a feedback request. This does not certify App generation or validation. |
+| `awaiting_user` | Successful result requests `awaiting_user_feedback`. |
+| `failed` | Exception or non-success result. Structured exceptions can supply `error_code`. |
+| `cancelled` | Interruption or denial. `reason` may be `user`, `replacement`, `hook_denied` or `tool_denied`. |
+
+Cancelled completion notifications carry `result[:status] == :cancelled`, even
+when the original denial return value remains unchanged for queue compatibility.
+An execution start alone does not establish recovery from a previous failure.
+
+```yaml
+id: session-observer
+name: Session Observer
+version: "0.1.0"
+contributes:
+  hooks:
+    - event: on_start
+      file: hooks/start.rb
+    - event: on_complete
+      file: hooks/complete.rb
+```
+
+```ruby
+# hooks/start.rb
+Clacky::ExtensionHookRegistry.add do |_input, _agent, context|
+  next unless context
+  Clacky::Logger.debug("[session-observer] started", session_id: context[:session_id],
+                       run_id: context[:run_id])
+  nil
+end
+```
+
+```ruby
+# hooks/complete.rb
+Clacky::ExtensionHookRegistry.add do |_result, _agent, context|
+  next unless context
+  Clacky::Logger.debug("[session-observer] settled", session_id: context[:session_id],
+                       status: context[:status], run_id: context[:run_id])
+  nil
+end
+```
+
+Use separate files for separate registrations: each Ruby file is required only
+once. Programmatic registration uses `agent.add_hook(:on_complete) { |result,
+agent, context| ... }`. Shell hooks keep their JSON payload shape; neither the
+Agent nor context is serialized, while abnormal completion results are now reported.
+
+Callbacks execute synchronously; keep them short and dispatch network work
+asynchronously. `StandardError` is logged without stopping later callbacks.
+The host does not persist, retry, replay or acknowledge hook delivery. Consumers
+must tolerate missing events and cannot infer inactivity solely from missing data.
+`agent.emit_event(persist: true)` is a separate frontend-history feature.

data/lib/clacky/agent/chunk_index.rb

@@ -41,6 +41,7 @@ module Clacky
         nested = []
         section_count = 0
         user_start = nil
+        user_task_id = nil
         archived_at = nil
         front_matter = false
         directory = File.dirname(path)
@@ -61,6 +62,7 @@ module Clacky
               section_count += 1
               nested << header[:nested_chunk] if header[:nested_chunk]
               user_start = header[:role] == "user" ? start : nil
+              user_task_id = header[:role] == "user" ? header[:task_id] : nil
             elsif user_start && !text.strip.empty?
               # Match replay's empty/metadata-only user handling without
               # retaining the rest of the user message or any assistant text.
@@ -69,8 +71,9 @@ module Clacky
               next if visible.empty? && events.empty? && files.empty?
 
               rounds.last[:length] = user_start - rounds.last[:start] if rounds.any?
-              rounds << { start: user_start }
+              rounds << { start: user_start, task_id: user_task_id }
               user_start = nil
+              user_task_id = nil
             end
           end
           rounds.last[:length] = position - rounds.last[:start] if rounds.any?

data/lib/clacky/agent/history_navigation.rb

@@ -12,7 +12,12 @@ module Clacky
         manifest = sources.map do |source|
           entry = { key: source[:key], version: source[:version], count: navigation_source_count(source),
                     volatile: !!source[:rounds] || source[:continuation].to_a.any? }
-          entry[:identities] = source[:rounds].map { |round| round[:user_msg].values_at(:created_at, :task_id) } if source[:rounds]
+          if source[:rounds]
+            entry[:identities] = source[:rounds].map { |round| round[:user_msg].values_at(:created_at, :task_id) }
+          else
+            task_ids = source[:index][:rounds].map { |round| round[:task_id] }
+            entry[:task_ids] = task_ids if task_ids.any?
+          end
           entry
         end
         { sources: manifest, total: manifest.sum { |source| source[:count] } }

data/lib/clacky/agent/hook_manager.rb

@@ -26,20 +26,27 @@ module Clacky
 
     # @return [Hash] `{action: :allow}`, `{action: :deny, reason:}`, or
     #   `{action: :handled, result:}` when a hook fulfilled the event itself.
-    # on_start receives (user_input, agent) after task/history initialization.
+    # on_start receives (user_input, agent, context) after task/history initialization.
     # Its handled result is returned unchanged from Agent#run; the extension
     # supplies the run-result status and any queue/feedback flags it needs.
     # on_start is not fired for steering input inside an already running turn.
-    # Extra trailing arg: the agent that owns this hook chain, so ext hooks can
+    # The agent follows the event payload, so ext hooks can
     # call `agent.emit_event(...)`. Blocks are procs — those declaring fewer
-    # params (`|call|`, `|call, result|`) silently ignore it.
+    # params (`|call|`, `|call, result|`) silently ignore extra arguments.
+    # Start/complete append context after the agent. Completion is observation-only.
     def trigger(event, *args)
       validate_event!(event)
+      # Keep payload hashes positional: Ruby 2.6 otherwise promotes their keys
+      # into keyword arguments, breaking existing tool hooks.
+      context = args.pop if [:on_start, :on_complete].include?(event) && args.length == 2
       result = { action: :allow }
 
       @hooks[event].each do |hook|
         begin
-          hook_result = hook.call(*args, @agent)
+          callback_args = [*args, @agent]
+          callback_args << context.dup if context
+          hook_result = hook.call(*callback_args)
+          next if event == :on_complete
           next unless hook_result.is_a?(Hash)
           # First deny wins and stops the chain: a weaker later verdict must
           # never clobber a stronger earlier one, and the first deny's reason

data/lib/clacky/agent/llm_caller.rb

@@ -56,8 +56,15 @@ module Clacky
         retries = 0
         # Per-call tier attribution for auto routing: each retryable failure is
         # charged to the tier the gateway actually routed that call to (echoed
-        # in X-Clacky-Routed-Tier). Failures without a tier (network layer,
-        # timeouts — the gateway never answered) are not attributed to either.
+        # in X-Clacky-Routed-Tier). A tier-less failure is charged to the floor
+        # when the call went out as "auto": the gateway only stamps the tier
+        # header after it has routed the call, so a missing tier means the
+        # failure happened before routing (HTML error page, truncated body,
+        # rejection at the auth layer) — and the gateway defaults to the floor
+        # lane in exactly that case. Leaving it uncharged would keep
+        # agent_upstream_fails at 0 and pin the task to a dead floor lane until
+        # its retry budget ran out. Non-auto calls and unknown tier values are
+        # attributed to neither lane.
         floor_fails = 0
         upgrade_fails = 0
 
@@ -247,7 +254,7 @@ module Clacky
           else
             # Don't show_error here — let the outer rescue block handle it to avoid duplicates.
             # Progress cleanup is the caller's responsibility (via its own ensure block).
-            raise AgentError.new("#{I18n.t("llm.error.network_failed", retries: max_retries)}", raw_message: e.message)
+            raise AgentError.new("#{I18n.t("llm.error.network_failed", retries: max_retries)}", raw_message: e.message, action_url: @client.account_url)
           end
 
         rescue RetryableError => e
@@ -257,6 +264,12 @@ module Clacky
           case e.routed_tier
           when "floor"   then floor_fails += 1
           when "upgrade" then upgrade_fails += 1
+          when nil       then floor_fails += 1 if api_call_model == "auto"
+          else
+            if defined?(Clacky::Logger)
+              Clacky::Logger.warn("llm_caller.unknown_routed_tier",
+                tier: e.routed_tier, model: api_call_model)
+            end
           end
 
           # Probing failure: primary still down — renew cooling-off and retry with fallback.

data/lib/clacky/agent/message_compressor_helper.rb

@@ -641,6 +641,7 @@ module Clacky
               lines << "## Assistant"
             end
             lines << ""
+            append_created_at_line(lines, msg)
             # Include tool calls summary if present
             # Format: "_Tool calls: name | {args_json}_" so replay can restore args for WebUI display.
             if msg[:tool_calls]&.any?
@@ -733,6 +734,13 @@ module Clacky
         lines << ""
       end
 
+      def append_created_at_line(lines, msg)
+        return unless msg[:created_at].is_a?(Numeric)
+
+        lines << "_Created at: #{msg[:created_at]}_"
+        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

@@ -17,6 +17,7 @@ module Clacky
         @session_id = session_data[:session_id]
         @name = session_data[:name] || ""
         @pinned = session_data[:pinned] || false
+        @archived_at = session_data[:archived_at]
         @history = MessageHistory.new(session_data[:messages] || [])
         @input_queue = (session_data[:pending_inputs] || []).map do |entry|
           entry.reject { |key, _| key == :steer_target }.merge(delivery: "queue")
@@ -75,6 +76,9 @@ module Clacky
         @task_parents = raw_parents.each_with_object({}) { |(k, v), h| h[k.to_s.to_i] = v.to_i }
         @current_task_id = (session_data.dig(:time_machine, :current_task_id) || 0).to_i
         @active_task_id = (session_data.dig(:time_machine, :active_task_id) || 0).to_i
+        # Not persisted: assume the latest task's AFTER may be stale so the next
+        # task start re-checkpoints it instead of skipping it.
+        @latest_after_dirty = true
 
         raw_meta = session_data.dig(:time_machine, :task_meta) || {}
         @task_meta = raw_meta.each_with_object({}) do |(k, v), h|
@@ -99,7 +103,20 @@ module Clacky
         last_error = session_data.dig(:stats, :last_error)
 
         if last_status == "error" && last_error
-          @pending_error_rollback = true
+          real_users = @history.real_user_messages
+          task_tagged_history = real_users.any? { |message| !message[:task_id].nil? }
+          failed_turn_persisted = real_users.any? do |message|
+            message[:task_id].to_s == @current_task_id.to_s
+          end
+
+          # Modern sessions identify each user turn by task_id. Only schedule
+          # the legacy deferred rollback when the failed task's user message
+          # actually survived in history. Attachment setup can now roll its
+          # staged turn back before the error snapshot is saved; blindly
+          # removing the last user message after restore would then delete the
+          # preceding successful turn. Sessions without task ids keep the old
+          # fallback for backward compatibility.
+          @pending_error_rollback = true if !task_tagged_history || failed_turn_persisted
         end
 
         saved_reasoning = session_data.dig(:config, :reasoning_effort)
@@ -244,6 +261,9 @@ module Clacky
           session_id: @session_id,
           name: @name,
           pinned: @pinned,
+          # Kept next to the other scalars so SessionManager's header-only
+          # reader can pick it up without parsing the message payload.
+          archived_at: @archived_at,
           created_at: @created_at,
           updated_at: stamp,
           working_dir: @working_dir,
@@ -543,12 +563,15 @@ module Clacky
               #   Old: "_Tool calls: name1, name2_"  (backward compat)
               remaining_lines = []
               pending_tool_entries = []  # [{name:, args:}]
+              created_at = nil
 
               text.each_line do |line|
                 stripped = line.strip
                 if (m = stripped.match(/\A_Tool calls?:\s*(.+?)_?\z/i))
                   raw = m[1]
                   pending_tool_entries.concat(parse_tool_calls_line(raw))
+                elsif (m = stripped.match(/\A_Created at: (\d+(?:\.\d+)?)_\z/))
+                  created_at = m[1].to_f
                 else
                   remaining_lines << line
                 end
@@ -557,7 +580,7 @@ module Clacky
               # Flush any plain text
               plain_text = remaining_lines.join.strip
               unless plain_text.empty?
-                current_round[:events] << { role: "assistant", content: plain_text, interim: !pending_tool_entries.empty? }
+                current_round[:events] << { role: "assistant", content: plain_text, interim: !pending_tool_entries.empty?, created_at: created_at }
               end
 
               # Emit one synthetic tool_calls message per detected tool