openclacky 1.3.2 → 1.3.4

data/lib/clacky/default_skills/extend-openclacky/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: extend-openclacky
-description: Customize, fix, override or extend openclacky itself — e.g. change a built-in tool's behavior, intercept/audit/block tool calls with shell scripts, or plug in a new IM channel (Slack, in-house IM, etc.). Trigger on phrases like "patch clacky", "patch openclacky", "change WebSearch behavior", "block dangerous commands", "audit tool use", "add Slack channel", "改 openclacky 内置", "改 clacky 内置", "monkey patch openclacky", "拦截工具调用". Do NOT trigger for ordinary feature work in the user's own project that doesn't touch openclacky.
+description: Customize, fix, override or extend openclacky itself — change a built-in tool's behavior, intercept/audit/block tool calls, plug in a new IM channel (Slack, in-house IM…), or add UI to the Web UI (panel, button, settings tab). Trigger on "patch openclacky", "block dangerous commands", "audit tool use", "add Slack channel", "extend the web ui", "改 openclacky 内置", "拦截工具调用", "扩展 web 界面". Do NOT trigger for ordinary feature work in the user's own project that doesn't touch openclacky.
 ---
 
 # Extending Openclacky
 
-Openclacky ships three official extension mechanisms that survive `gem update` and never require editing the gem source.
+Openclacky ships four official extension mechanisms that survive `gem update` and never require editing the gem source.
 **Never tell the user to `bundle show openclacky` and edit the gem — always use one of these.**
 
 ## Pick the right mechanism
@@ -15,6 +15,7 @@ Openclacky ships three official extension mechanisms that survive `gem update` a
 | Change behavior of an **existing method** in openclacky (e.g. `WebSearch#execute` timeout, fix a bug in a built-in tool) | **Patch** | `clacky patch_new <id> "Const#method" -d "<desc>"` | `clacky patch_verify` |
 | **Audit / block / observe** tool calls (block `rm -rf /`, log every shell command) — no Ruby needed | **Shell Hook** | `clacky hook_new <id> -e <event>` | `clacky hook_verify` |
 | Plug openclacky into a **new IM platform** (Slack, in-house IM, custom webhook…) | **Channel Adapter** | `clacky channel_new <platform_id>` | `clacky channel_verify` |
+| Add UI to the **Web UI** (custom panel, header button, settings tab, visualize data) | **Web UI Extension** | drop a `.js` file in `~/.clacky/webui_ext/` | reload page; `Clacky.ext.slots()` in console; `?pure=true` to escape |
 
 ## Authoritative documentation
 
@@ -23,14 +24,15 @@ Each mechanism has a full reference doc — read the relevant one with `web_fetc
 - Patches → https://www.openclacky.com/docs/extend-patches
 - Shell Hooks → https://www.openclacky.com/docs/extend-shell-hooks
 - Channel Adapters → https://www.openclacky.com/docs/extend-channel-adapter
+- Web UI Extensions → https://www.openclacky.com/docs/extend-webui
 
 ## Execution playbook
 
 1. **Identify** which mechanism fits (use the table above; ask if genuinely ambiguous).
 2. **Read the doc** for that mechanism with `web_fetch`. Don't guess fields, hook events, or required methods — the doc is the contract.
-3. **Run the scaffold** CLI command. It generates the file(s) in `~/.clacky/...` with correct meta.
+3. **Run the scaffold** CLI command. It generates the file(s) in `~/.clacky/...` with correct meta. *(Web UI Extensions have no scaffold — just create a `.js` file under `~/.clacky/webui_ext/`; the doc shows the `Clacky.ext` contract.)*
 4. **Edit** the generated file to implement the user's intent. Keep generated meta fields (`target`, `event`, `platform_id`, the `Clacky::ChannelRegistry.register(...)` line, etc.) intact unless the doc says otherwise.
-5. **Verify** with the matching `*_verify` command. Surface any `[FAIL]` lines to the user verbatim.
+5. **Verify** with the matching `*_verify` command. Surface any `[FAIL]` lines to the user verbatim. *(Web UI Extensions have no verify command — reload the page and confirm the slot rendered; if anything breaks, `?pure=true` disables all extensions instantly.)*
 
 ## When NOT to use this skill
 

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

@@ -1,6 +1,6 @@
 ---
 name: media-gen
-description: 'Generate images, videos, or audio (text-to-speech) in the current task. Use whenever the user asks to create/generate/produce a picture / image / illustration / cover / poster / icon / artwork, a video / clip / animation, or speech / voiceover / narration / TTS — e.g. 生成图片, 画一张, 做封面, 配图, generate image, make a picture, draw, design a cover, 生成视频, 做个视频, text-to-video, 朗读, 配音, 旁白, 文字转语音, generate speech, voiceover. Also use when a document (slides, poster, README hero) needs an inline image.'
+description: 'Generate or edit images, videos, or audio (text-to-speech) in the current task. Use whenever the user asks to create/generate/produce or edit/modify a picture / image / illustration / cover / poster / icon / artwork, a video / clip / animation, or speech / voiceover / narration / TTS — e.g. generate image, draw, design a cover, edit this image, change the background, text-to-video, generate speech; 画一张, 配图, 编辑图片, 改图, 换背景, 做个视频, 配音, 文字转语音. Also use when a document (slides, poster, README hero) needs an inline image.'
 disable-model-invocation: false
 user-invocable: true
 always-show: true
@@ -8,7 +8,7 @@ always-show: true
 
 # media-gen
 
-Generate images on demand by calling the local Clacky HTTP server, which dispatches to whichever image-generation model the user configured (`type=image` in their model settings).
+Generate **and edit** images on demand by calling the local Clacky HTTP server, which dispatches to whichever image-generation model the user configured (`type=image` in their model settings). Editing (image-in → image-out) works with any image model that accepts image input — most current ones do.
 
 ## Endpoint
 
@@ -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,32 @@ 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                       | Defaults to the current working directory. The image is saved under `<output_dir>/assets/generated/`. |
+| `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`. |
+
+### Editing an existing image
+
+To edit instead of generate from scratch, pass the existing image as `image`
+(a local file path is easiest — the skill reads and encodes it for you) plus a
+`prompt` describing the change. The configured image model receives the
+image alongside the prompt and returns an edited result.
+
+```bash
+curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/image \
+  -H "Content-Type: application/json" \
+  -d '{
+    "prompt": "change the background to a starry night sky, keep the cat unchanged",
+    "image": "/abs/path/to/input.png"
+  }'
+```
+
+- The result is a **new** edited image saved under `assets/generated/` — the
+  original file is never modified in place.
+- For combining several inputs (e.g. "put the product from image 1 onto the
+  background from image 2"), pass them as `images: ["/path/a.png", "/path/b.png"]`
+  and describe the composition in the prompt.
+- Same speed/concurrency rules apply: editing is as slow as generation, one at a time.
 
 ### Response shape (success)
 
@@ -81,7 +107,7 @@ curl -s -X POST http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/media/ima
 {
   "success": true,
   "image": "/abs/path/to/working_dir/assets/generated/img_20260525_011820_a1b2c3d4.png",
-  "model": "or-gemini-3-pro-image",
+  "model": "<the configured image model>",
   "provider": "openclacky",
   "prompt": "A clean, modern hero illustration ...",
   "aspect_ratio": "landscape",
@@ -145,7 +171,6 @@ When the user gives a vague request like "给我配张图", ask one clarifying q
 
 ## When NOT to use this skill
 
-- The user asks to **edit** an existing image (this skill is text-to-image only today)
 - The user wants a **diagram / chart** with specific data — use a charting library (matplotlib, mermaid, etc.) instead; image gen is for illustrations, not data viz
 - The user asks for **screenshots** of real software — use the browser tool
 
@@ -180,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)"'"
   }'
 ```
 
@@ -190,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                   | MP4 saved under `<output_dir>/assets/generated/`. |
+| `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)
 
@@ -238,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)"'"
   }'
 ```
 
@@ -246,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/media/openai_compat.rb

@@ -2,6 +2,7 @@
 
 require "faraday"
 require "json"
+require "base64"
 require_relative "base"
 
 module Clacky
@@ -28,7 +29,7 @@ module Clacky
       VIDEO_ASPECTS = %w[landscape portrait].freeze
       DEFAULT_VIDEO_DURATION = 8
 
-      def generate_image(prompt:, aspect_ratio: DEFAULT_ASPECT, output_dir: nil, n: 1, **_kwargs)
+      def generate_image(prompt:, aspect_ratio: DEFAULT_ASPECT, output_dir: nil, n: 1, image: nil, images: nil, **_kwargs)
         provider_id = Clacky::Providers.find_by_base_url(@base_url) || "custom"
         aspect      = ASPECT_TO_SIZE.key?(aspect_ratio) ? aspect_ratio : DEFAULT_ASPECT
         size        = ASPECT_TO_SIZE[aspect]
@@ -52,6 +53,18 @@ module Clacky
           )
         end
 
+        begin
+          input_images = normalize_input_images(image, images)
+        rescue ArgumentError => e
+          return error_response(
+            error: e.message,
+            error_type: "invalid_argument",
+            provider: provider_id,
+            prompt: prompt,
+            aspect_ratio: aspect
+          )
+        end
+
         payload = { model: @model, n: n }
         if gemini_family?(@model)
           # Gemini image models (routed via openclacky / openrouter gateway)
@@ -64,6 +77,11 @@ module Clacky
           payload[:size]   = size
         end
 
+        # With input image(s) this becomes an edit: the gateway forwards them
+        # to the model alongside the prompt. Sent as `images` (array) so
+        # multi-image edits work; the gateway also accepts a single `image`.
+        payload[:images] = input_images unless input_images.empty?
+
         begin
           response = connection.post("images/generations") do |req|
             req.headers["Content-Type"]  = "application/json"
@@ -306,6 +324,51 @@ module Clacky
         model_name.to_s.match?(/gemini|imagen/i)
       end
 
+      # Normalise the optional image/edit inputs into an array of data URLs
+      # ("data:<mime>;base64,<payload>") the gateway understands. Each input
+      # may be a local file path, a data URL, or a bare base64 string.
+      # `images` (array or single) takes precedence over `image`.
+      # Raises ArgumentError on a missing file or undecodable input.
+      private def normalize_input_images(image, images)
+        raw = images.nil? ? image : images
+        return [] if raw.nil?
+
+        list = raw.is_a?(Array) ? raw : [raw]
+        list.filter_map do |item|
+          s = item.to_s.strip
+          next if s.empty?
+          to_data_url(s)
+        end
+      end
+
+      private def to_data_url(input)
+        return input if input.start_with?("data:")
+
+        # A filesystem path → read and encode.
+        if File.file?(input)
+          bytes = File.binread(input)
+          mime  = mime_for_path(input)
+          return "data:#{mime};base64,#{Base64.strict_encode64(bytes)}"
+        end
+
+        # Otherwise treat as a bare base64 payload; validate it decodes.
+        begin
+          Base64.strict_decode64(input)
+        rescue ArgumentError
+          raise ArgumentError, "input image is neither an existing file path nor valid base64"
+        end
+        "data:image/png;base64,#{input}"
+      end
+
+      private def mime_for_path(path)
+        case File.extname(path).downcase
+        when ".jpg", ".jpeg" then "image/jpeg"
+        when ".webp"         then "image/webp"
+        when ".gif"          then "image/gif"
+        else                      "image/png"
+        end
+      end
+
       # base_url is taken verbatim from PRESETS (each provider already
       # includes the API version segment when needed). We only ensure a
       # trailing slash so Faraday's relative-path join behaves.

data/lib/clacky/message_history.rb

@@ -85,6 +85,15 @@ module Clacky
       self
     end
 
+    # Truncate history starting from the user message with the given created_at timestamp.
+    # Removes that message and everything after it. Returns self.
+    def truncate_from_created_at(created_at)
+      idx = @messages.index { |m| m[:role] == "user" && m[:created_at].to_s == created_at.to_s }
+      return self unless idx
+
+      truncate_from(idx)
+    end
+
     # Roll back the history to just before the given message object.
     # Removes the message and anything appended after it.
     # Used to undo a failed speculative append (e.g. compression message that errored).

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