openclacky 1.3.3 → 1.3.4

data/lib/clacky/default_skills/media-gen/SKILL.md

@@ -59,7 +59,8 @@ curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/ima
   -H "Content-Type: application/json" \
   -d '{
     "prompt": "A clean, modern hero illustration for a tech startup landing page. Soft gradient background, abstract geometric shapes in blue and purple, minimal style, 4K quality.",
-    "aspect_ratio": "landscape"
+    "aspect_ratio": "landscape",
+    "output_dir": "'"$(pwd)"'"
   }'
 ```
 
@@ -73,7 +74,7 @@ curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/ima
 |----------------|----------|-------------------------------------|-------|
 | `prompt`       | yes      | string                              | Be detailed and concrete. See prompt tips below. |
 | `aspect_ratio` | no       | `landscape` / `square` / `portrait` | Defaults to `landscape`. |
-| `output_dir`   | no       | absolute path                       | Per-call override. When omitted, falls back to the user's `media_output_dir` setting (Settings → Models → Media Output Directory), then to the working directory. The image is always saved into the `assets/generated/` subdirectory of whichever path is used. |
+| `output_dir`   | yes      | absolute path                       | Always pass `$(pwd)` so files land in the current session workspace. The image is saved under `<output_dir>/assets/generated/`. |
 | `image`        | no       | file path / base64 / data URL       | A single input image to **edit**. Triggers image-edit mode (see below). |
 | `images`       | no       | array of the above                  | Multiple input images for a multi-image edit. Takes precedence over `image`. |
 
@@ -204,7 +205,8 @@ curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/vid
   -d '{
     "prompt": "A cinematic drone shot flying over a misty mountain range at sunrise, golden light, 4K.",
     "aspect_ratio": "landscape",
-    "duration_seconds": 8
+    "duration_seconds": 8,
+    "output_dir": "'"$(pwd)"'"
   }'
 ```
 
@@ -214,7 +216,7 @@ curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/vid
 | `aspect_ratio`     | no       | `landscape` / `portrait`        | Defaults to `landscape` (16:9). |
 | `duration_seconds` | no       | 4–8                             | Defaults to 8. |
 | `image`            | no       | `{ "b64_json": "...", "mime_type": "image/png" }` | Optional first frame for image-to-video. |
-| `output_dir`       | no       | absolute path                   | Per-call override; same fallback chain as `image` (user setting → cwd). MP4 saved into the `assets/generated/` subdirectory of whichever path is used. |
+| `output_dir`       | yes      | absolute path                   | Always pass `$(pwd)` so files land in the current session workspace. MP4 saved under `<output_dir>/assets/generated/`. |
 
 ### Response (success)
 
@@ -262,7 +264,8 @@ curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/aud
   -H "Content-Type: application/json" \
   -d '{
     "input": "Hello and welcome to openclacky. Today we will explore...",
-    "voice": "Kore"
+    "voice": "Kore",
+    "output_dir": "'"$(pwd)"'"
   }'
 ```
 
@@ -270,7 +273,7 @@ curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/aud
 |--------------|----------|---------------------------------|-------|
 | `input`      | yes      | string                          | The text to speak. Plain prose works best; you can prefix with style cues like "Say cheerfully:" or "In a calm tone:". |
 | `voice`      | no       | string voice name               | Defaults to `Kore`. Common Gemini voices: `Kore`, `Puck`, `Charon`, `Fenrir`, `Aoede`. |
-| `output_dir` | no       | absolute path                   | WAV saved under `<output_dir>/assets/generated/`. |
+| `output_dir` | yes      | absolute path                   | Always pass `$(pwd)` so files land in the current session workspace. WAV saved under `<output_dir>/assets/generated/`. |
 
 Generation typically takes 2–10 seconds depending on length. The request
 blocks until the WAV is ready.

data/lib/clacky/idle_compression_timer.rb

@@ -121,7 +121,9 @@ module Clacky
       success = @agent.trigger_idle_compression
 
       if success && @session_manager
-        @session_manager.save(@agent.to_session_data(status: :success))
+        existing = @session_manager.load(@agent.session_id)
+        original_updated_at = existing&.dig(:updated_at) ? Time.parse(existing[:updated_at].to_s) : nil
+        @session_manager.save(@agent.to_session_data(status: :success, updated_at: original_updated_at))
       end
 
       @on_compress&.call(success)

data/lib/clacky/locales/en.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Clacky
+  module Locales
+    EN = {
+      "llm.error.insufficient_credit"   => "Insufficient credit, please top up your account to continue",
+      "llm.error.rate_limit_400"        => "Rate limit or service issue, retrying...",
+      "llm.error.invalid_api_key"       => "Invalid API key, please check your configuration",
+      "llm.error.403.model_not_allowed" => "This model is not available on your current plan",
+      "llm.error.403.api_key_revoked"   => "API key has been revoked, please generate a new one",
+      "llm.error.403.api_key_expired"   => "API key has expired, please generate a new one",
+      "llm.error.403.quota_exceeded"    => "Quota exceeded, please upgrade your plan",
+      "llm.error.403.access_denied"     => "Access denied, please check your API key permissions",
+      "llm.error.403.default"           => "Access denied",
+      "llm.error.endpoint_not_found"    => "API endpoint not found, please check your service URL",
+      "llm.error.rate_limit_429"        => "Rate limit exceeded, please wait a moment",
+      "llm.error.server_error"          => "Service temporarily unavailable (%<status>d), retrying...",
+      "llm.error.unexpected"            => "Unexpected error (%<status>d)",
+      "llm.error.html_response"         => "Service temporarily unavailable (received HTML error page), retrying...",
+      "llm.error.bad_request"           => "Bad request: invalid parameters. Please check your model configuration",
+      "llm.error.request_timeout"       => "Request timed out after %<retries>d retries",
+      "llm.error.network_failed"        => "Network connection failed after %<retries>d retries",
+      "llm.error.service_unavailable"   => "Service unavailable after %<retries>d retries"
+    }.freeze
+  end
+end

data/lib/clacky/locales/i18n.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "en"
+require_relative "zh"
+
+module Clacky
+  module I18n
+    LOCALES = {
+      "zh" => Clacky::Locales::ZH,
+      "en" => Clacky::Locales::EN
+    }.freeze
+
+    def self.t(key, **vars)
+      table = LOCALES[locale] || LOCALES["en"]
+      msg   = table[key] || LOCALES["en"][key] || key
+      vars.empty? ? msg : format(msg, **vars)
+    end
+
+    def self.locale
+      return Thread.current[:lang] if Thread.current[:lang]
+
+      lang = ENV["LC_ALL"] || ENV["LC_MESSAGES"] || ENV["LANG"] || ""
+      lang.match?(/\Azh/i) ? "zh" : "en"
+    end
+  end
+end

data/lib/clacky/locales/zh.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Clacky
+  module Locales
+    ZH = {
+      "llm.error.insufficient_credit"   => "账户余额不足，请前往控制台充值后继续使用",
+      "llm.error.rate_limit_400"        => "请求频率过高或服务暂时不可用，正在重试...",
+      "llm.error.invalid_api_key"       => "API 密钥无效，请检查配置",
+      "llm.error.403.model_not_allowed" => "当前模型不支持免费试用，请升级套餐或切换其他模型",
+      "llm.error.403.api_key_revoked"   => "API 密钥已被撤销，请前往控制台重新生成",
+      "llm.error.403.api_key_expired"   => "API 密钥已过期，请前往控制台重新生成",
+      "llm.error.403.quota_exceeded"    => "配额已用完，请升级套餐",
+      "llm.error.403.access_denied"     => "访问被拒绝，请检查 API 密钥权限",
+      "llm.error.403.default"           => "访问被拒绝",
+      "llm.error.endpoint_not_found"    => "API 端点不存在，请检查服务地址配置",
+      "llm.error.rate_limit_429"        => "请求过于频繁，请稍候重试",
+      "llm.error.server_error"          => "服务暂时不可用（%<status>d），正在重试...",
+      "llm.error.unexpected"            => "请求失败（%<status>d）",
+      "llm.error.html_response"         => "服务暂时不可用（收到 HTML 错误页），正在重试...",
+      "llm.error.bad_request"           => "请求参数有误，请检查模型配置或重试",
+      "llm.error.request_timeout"       => "请求超时（已重试 %<retries>d 次）",
+      "llm.error.network_failed"        => "网络连接失败（已重试 %<retries>d 次）",
+      "llm.error.service_unavailable"   => "服务暂时不可用（已重试 %<retries>d 次）"
+    }.freeze
+  end
+end

data/lib/clacky/rich_ui/components/base_component.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "ruby_rich"
+
+module Clacky
+  module RichUI
+    module Components
+      # BaseComponent provides shared rendering primitives for RichUI components.
+      # Used by sidebar panels and dialogs to eliminate duplicated ANSI-color helpers.
+      module BaseComponent
+        # Render muted (dim) text commonly used for secondary info
+        def muted(text)
+          "#{RubyRich::AnsiCode.color(:black, true)}#{text}#{RubyRich::AnsiCode.reset}"
+        end
+
+        # Render colored text with a named color
+        def colored(text, color)
+          "#{RubyRich::AnsiCode.color(color, true)}#{text}#{RubyRich::AnsiCode.reset}"
+        end
+
+        # Status marker symbol for todo / activity items
+        def status_marker(status)
+          case status
+          when :done, :completed
+            colored("✓", :green)
+          when :running, :in_progress, :active
+            colored("●", :blue)
+          when :failed, :error
+            colored("!", :red)
+          else
+            muted("○")
+          end
+        end
+
+        # Truncate text to a maximum length, appending "…" when cut
+        def truncate(text, limit = 40)
+          return "" if text.nil? || text.empty?
+
+          text.length > limit ? "#{text[0...limit]}…" : text
+        end
+
+        # Theme accessor for future theme switching.
+        # Currently defaults to agent_dark; can be overridden per-component.
+        def theme
+          @theme ||= RubyRich::Theme.agent_dark
+        end
+      end
+    end
+  end
+end

data/lib/clacky/rich_ui/components/dialogs/approval_dialog.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require "ruby_rich"
+require_relative "../base_component"
+
+module Clacky
+    module RichUI
+      class ApprovalDialog
+      include Clacky::RichUI::Components::BaseComponent
+
+      RISK_LEVELS = {
+        low:      { label: "Low",      color: :green,  bar: "●○○○" },
+        medium:   { label: "Medium",   color: :yellow, bar: "●●○○" },
+        high:     { label: "High",     color: :yellow, bar: "●●●○" },
+        critical: { label: "Critical", color: :red,    bar: "●●●●" }
+      }.freeze
+
+      CATEGORY_COLORS = {
+        file: :blue, shell: :yellow, network: :cyan, paid: :magenta
+      }.freeze
+
+      CHOICES = [
+        { key: :approve,       label: "Approve",       color: :green  },
+        { key: :deny,          label: "Deny",           color: :red    },
+        { key: :always_allow,  label: "Always allow",   color: :cyan   }
+      ].freeze
+
+      attr_accessor :width, :height
+
+      def initialize(tool_name:, message:, params: {}, risk: :medium, category: :file)
+        @tool_name = tool_name
+        @message = message
+        @params = params
+        @risk = RISK_LEVELS[risk] || RISK_LEVELS[:medium]
+        @category = category
+        @category_color = CATEGORY_COLORS[category] || :blue
+        @selected_index = 0
+        @width = 72
+        @height = [params.length + 10, 12].max
+        @event_listeners = {}
+        @mutex = Mutex.new
+        @condition = ConditionVariable.new
+        @finished = false
+        @result = nil
+        @panel = RubyRich::Panel.new("", title: "Approval", border_style: @risk[:color], title_align: :center)
+        @layout = RubyRich::Layout.new(name: :approval_dialog, width: @width, height: @height)
+        @layout.update_content(@panel)
+        @layout.calculate_dimensions(@width, @height)
+        wire_keys
+      end
+
+      def finish(value)
+        @mutex.synchronize do
+          @result = value
+          @finished = true
+          @condition.signal
+        end
+        true
+      end
+
+      def wait
+        @mutex.synchronize { @condition.wait(@mutex) until @finished }
+        @result
+      end
+
+      def key(event_name, priority = 0, &block)
+        @event_listeners[event_name] ||= []
+        @event_listeners[event_name] << { priority: priority, block: block }
+        @event_listeners[event_name].sort_by! { |l| -l[:priority] }
+      end
+
+      def notify_listeners(event_data)
+        Array(@event_listeners[event_data[:name]]).each { |l| l[:block].call(event_data, nil) }
+      end
+
+      def render_to_buffer
+        @panel.content = render_content
+        @layout.calculate_dimensions(@width, @height)
+        @layout.render_to_buffer
+      end
+
+      private def wire_keys
+        key(:left,  100) { move_selection(-1); true }
+        key(:right, 100) { move_selection(1);  true }
+        key(:string, 100) do |event, _live|
+          case event[:value]
+          when "h" then move_selection(-1)
+          when "l" then move_selection(1)
+          end
+          true
+        end
+        key(:enter, 100) do
+          sel = CHOICES[@selected_index]
+          finish(sel ? sel[:key] : :deny)
+        end
+        key(:escape, 100) { finish(:deny) }
+        key(:ctrl_c, 100) { finish(:deny) }
+      end
+
+      def move_selection(delta)
+        @selected_index = (@selected_index + delta) % CHOICES.length
+      end
+
+      def render_content
+        risk = @risk
+        lines = []
+        lines << ""
+        lines << "  #{colored("Tool:",  :body)}  #{colored(@tool_name, :accent)}  #{category_badge}"
+        lines << "  #{colored("Risk:",  :body)}  #{colored(risk[:label], risk[:color])} #{colored(risk[:bar], risk[:color])}"
+        lines << "  #{colored("Info:",  :body)}  #{colored(@message, :body)}"
+
+        unless @params.empty?
+          lines << ""
+          @params.each do |key, value|
+            val = value.to_s
+            val = "#{val[0..50]}..." if val.length > 54
+            lines << "  #{muted("#{key}:")}  #{colored(val, :body)}"
+          end
+        end
+
+        lines << ""
+        lines << render_choices
+        lines << ""
+        lines.join("\n")
+      end
+
+      def render_choices
+        CHOICES.each_with_index.map do |choice, i|
+          selected = i == @selected_index
+          prefix = selected ? "#{RubyRich::AnsiCode.color(:cyan, true)}➜#{RubyRich::AnsiCode.reset}" : " "
+          label = selected ? colored(choice[:label], choice[:color]) : muted(choice[:label])
+          "#{prefix} [#{label}]"
+        end.join("  ")
+      end
+
+      def category_badge
+        label = @category.to_s.capitalize
+        colored("[#{label}]", @category_color)
+      end
+    end
+  end
+end

data/lib/clacky/rich_ui/components/dialogs/config_menu_dialog.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "ruby_rich"
+require_relative "../base_component"
+
+module Clacky
+    module RichUI
+      class ConfigMenuDialog
+      include Clacky::RichUI::Components::BaseComponent
+
+      attr_accessor :width, :height
+
+      def initialize(choices:, selected_index: 0, title: "Model Configuration", width: 86)
+        @choices = choices
+        @selected_index = selected_index
+        @width = width
+        @height = [choices.length + 7, 12].max
+        @event_listeners = {}
+        @mutex = Mutex.new
+        @condition = ConditionVariable.new
+        @finished = false
+        @result = nil
+        @panel = RubyRich::Panel.new("", title: title, border_style: :cyan, title_align: :center)
+        @layout = RubyRich::Layout.new(name: :config_dialog, width: @width, height: @height)
+        @layout.update_content(@panel)
+        @layout.calculate_dimensions(@width, @height)
+      end
+
+      def selected_choice
+        @choices[@selected_index]
+      end
+
+      def move_up
+        move(-1)
+      end
+
+      def move_down
+        move(1)
+      end
+
+      def finish(value)
+        @mutex.synchronize do
+          @result = value
+          @finished = true
+          @condition.signal
+        end
+        true
+      end
+
+      def wait
+        @mutex.synchronize { @condition.wait(@mutex) until @finished }
+        @result
+      end
+
+      def key(event_name, priority = 0, &block)
+        @event_listeners[event_name] ||= []
+        @event_listeners[event_name] << { priority: priority, block: block }
+        @event_listeners[event_name].sort_by! { |listener| -listener[:priority] }
+      end
+
+      def notify_listeners(event_data)
+        Array(@event_listeners[event_data[:name]]).each { |listener| listener[:block].call(event_data, nil) }
+      end
+
+      def render_to_buffer
+        @panel.content = render_content
+        @layout.calculate_dimensions(@width, @height)
+        @layout.render_to_buffer
+      end
+
+      def move(delta)
+        return if @choices.empty?
+
+        index = @selected_index
+        loop do
+          index = (index + delta) % @choices.length
+          break unless @choices[index][:disabled]
+          break if index == @selected_index
+        end
+        @selected_index = index
+      end
+
+      def render_content
+        lines = [""]
+        @choices.each_with_index do |choice, index|
+          lines << choice_line(choice, selected: index == @selected_index)
+        end
+        lines << ""
+        lines << "#{muted("↑↓/jk: Navigate")} • #{muted("Enter: Select")} • #{muted("Esc/q: Cancel")}"
+        lines.join("\n")
+      end
+
+      def choice_line(choice, selected:)
+        return "  #{muted(choice[:label])}" if choice[:disabled]
+
+        prefix = selected ? "#{RubyRich::AnsiCode.color(:cyan, true)}➜#{RubyRich::AnsiCode.reset} " : "  "
+        label = selected ? RubyRich::AnsiCode.color(:white, true) + choice[:label] + RubyRich::AnsiCode.reset : choice[:label]
+        "#{prefix}#{label}"
+      end
+
+      private :move,
+              :render_content,
+              :choice_line
+    end
+  end
+end

data/lib/clacky/rich_ui/components/dialogs/form_dialog.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require "ruby_rich"
+require_relative "../base_component"
+
+module Clacky
+    module RichUI
+      class FormDialog
+      include Clacky::RichUI::Components::BaseComponent
+
+      attr_accessor :width, :height
+
+      def initialize(title:, fields:, width: 92)
+        @title = title
+        @fields = fields
+        @field_index = 0
+        @editors = fields.map do |field|
+          RubyRich::LineEditor.new.tap { |editor| editor.value = field[:default].to_s }
+        end
+        @width = width
+        @height = [fields.length * 3 + 8, 16].max
+        @event_listeners = {}
+        @mutex = Mutex.new
+        @condition = ConditionVariable.new
+        @finished = false
+        @result = nil
+        @panel = RubyRich::Panel.new("", title: title, border_style: :cyan, title_align: :center)
+        @layout = RubyRich::Layout.new(name: :form_dialog, width: @width, height: @height)
+        @layout.update_content(@panel)
+        @layout.calculate_dimensions(@width, @height)
+        wire_default_keys
+      end
+
+      def finish(value)
+        @mutex.synchronize do
+          @result = value
+          @finished = true
+          @condition.signal
+        end
+        true
+      end
+
+      def wait
+        @mutex.synchronize { @condition.wait(@mutex) until @finished }
+        @result
+      end
+
+      def key(event_name, priority = 0, &block)
+        @event_listeners[event_name] ||= []
+        @event_listeners[event_name] << { priority: priority, block: block }
+        @event_listeners[event_name].sort_by! { |listener| -listener[:priority] }
+      end
+
+      def notify_listeners(event_data)
+        listeners = Array(@event_listeners[event_data[:name]])
+        listeners.each { |listener| listener[:block].call(event_data, nil) }
+      end
+
+      def render_to_buffer
+        @panel.content = render_content
+        @layout.calculate_dimensions(@width, @height)
+        @layout.render_to_buffer
+      end
+
+      def wire_default_keys
+        key(:string, 100) { |event, _live| current_editor.insert(event[:value]); true }
+        key(:paste, 100) { |event, _live| current_editor.insert(event[:value]); true }
+        key(:backspace, 100) { current_editor.backspace; true }
+        key(:delete, 100) { current_editor.delete; true }
+        key(:left, 100) { current_editor.move_left; true }
+        key(:right, 100) { current_editor.move_right; true }
+        key(:ctrl_a, 100) { current_editor.buffer_start; true }
+        key(:ctrl_e, 100) { current_editor.buffer_end; true }
+        key(:up, 100) { move_field(-1); true }
+        key(:down, 100) { move_field(1); true }
+        key(:tab, 100) { move_field(1); true }
+        key(:shift_tab, 100) { move_field(-1); true }
+        key(:enter, 100) { finish(values); true }
+      end
+
+      def current_editor
+        @editors[@field_index]
+      end
+
+      def move_field(delta)
+        @field_index = (@field_index + delta) % @fields.length
+      end
+
+      def values
+        @fields.each_with_index.to_h { |field, index| [field[:name].to_sym, @editors[index].value] }
+      end
+
+      def render_content
+        lines = [""]
+        @fields.each_with_index do |field, index|
+          focused = index == @field_index
+          marker = focused ? "#{RubyRich::AnsiCode.color(:cyan, true)}➜#{RubyRich::AnsiCode.reset}" : " "
+          label = focused ? "#{RubyRich::AnsiCode.color(:white, true)}#{field[:label]}#{RubyRich::AnsiCode.reset}" : field[:label]
+          lines << "#{marker} #{label}"
+          lines << "  #{render_field_value(field, @editors[index], focused: focused)}"
+          lines << ""
+        end
+        lines << "#{muted("Tab/↑↓: Field")} • #{muted("Enter: Save")} • #{muted("Esc: Cancel")}"
+        lines.join("\n")
+      end
+
+      def render_field_value(field, editor, focused:)
+        raw = editor.value
+        text = if field[:mask] && !raw.empty?
+                 "*" * raw.length
+               elsif raw.empty?
+                 field[:placeholder].to_s
+               else
+                 raw
+               end
+        color = raw.empty? ? :black : (focused ? :cyan : :white)
+        "#{RubyRich::AnsiCode.color(color, true)}#{text}#{RubyRich::AnsiCode.reset}"
+      end
+
+      private :wire_default_keys,
+              :current_editor,
+              :move_field,
+              :values,
+              :render_content,
+              :render_field_value
+    end
+  end
+end