openclacky 1.2.14 → 1.2.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82874a3ac7c623672bd09b5fa1be1c5dd70b1f223119a1b58b86f85417e46f1c
-  data.tar.gz: ba5f1cc02f50a0bee31e24a6ad009c265881eef8b8b9efa6f17b5bec29124414
+  metadata.gz: 84e7378b08b627bad34d327d1bd82cc7efbfe980a690d64e678242917be8125d
+  data.tar.gz: 87e4c1b8e99f2195c98c85124816503fd11436b3bdb38465bb7289fab1204fa3
 SHA512:
-  metadata.gz: 5535350a83909fffe2471ab0f6505d54f9bc2436826636eacb1c8d6bbbd84e554087b31b9503d6671449789160072eb743711556f302dc42b820637b7edab83d
-  data.tar.gz: bcdec5ed7e56cfc27ee2370ae46582239fa425254e013a7577f162b28c6e2d88b821768f2e367fe2b33dd6773804740692f1f29cba0ca2d73f40d38f6b8e2243
+  metadata.gz: 36cb343f4a81222b3a2861dcd80529f0d3216a341e19ea7ebfd1ea6dbebded9c0d31a212a645cffb7268e9faf844be9f257d739677a17d0387bf033970dc7675
+  data.tar.gz: 16d08fc33223c56024a27072de5a0f435ac969c1ac55fffa39738e0e8d9bfe77f1ebbe4c4cafb8793c2dac1367744daeb417b97db9a854ba7e04ffd4d2b17042

data/CHANGELOG.md

@@ -5,6 +5,18 @@ 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/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.15] - 2026-06-10
+
+### Added
+- Proxy configuration support
+- Optional sound notification on task completion in Web UI
+
+### Fixed
+- Prevent scheduler thread from dying on tick exception
+
+### More
+- Tool diff CSS refinement
+
 ## [1.2.14] - 2026-06-08
 
 ### Added

data/lib/clacky/agent_config.rb

@@ -164,7 +164,8 @@ module Clacky
                   :models, :current_model_index, :current_model_id,
                   :memory_update_enabled, :skill_evolution,
                   :max_running_agents, :max_idle_agents,
-                  :default_working_dir
+                  :default_working_dir,
+                  :proxy_url
 
     def initialize(options = {})
       @permission_mode = validate_permission_mode(options[:permission_mode])
@@ -217,6 +218,11 @@ module Clacky
 
       @default_working_dir = options[:default_working_dir] || ENV["CLACKY_WORKSPACE_DIR"]
 
+      # HTTP proxy policy. The user's shell ENV (HTTP_PROXY etc.) is always
+      # ignored — set proxy_url here to route Clacky's outbound HTTP through
+      # a proxy. Leave nil to go direct.
+      @proxy_url = options[:proxy_url]
+
       # Per-session virtual model overlay.
       # When set, #current_model returns a *merged* hash (the resolved @models
       # entry merged with this overlay) without mutating the shared @models
@@ -390,6 +396,7 @@ module Clacky
       FileUtils.mkdir_p(config_dir)
       File.write(config_file, to_yaml)
       FileUtils.chmod(0o600, config_file)
+      Clacky::ProxyConfig.reset_cache! if defined?(Clacky::ProxyConfig)
     end
 
     # Convert to YAML format (top-level array)
@@ -407,6 +414,7 @@ module Clacky
       memory_update_enabled
       skill_evolution max_running_agents max_idle_agents
       default_working_dir
+      proxy_url
     ].freeze
 
     # Serialize the current agent configuration to YAML.
@@ -425,7 +433,8 @@ module Clacky
         "skill_evolution" => @skill_evolution,
         "max_running_agents" => @max_running_agents,
         "max_idle_agents" => @max_idle_agents,
-        "default_working_dir" => @default_working_dir
+        "default_working_dir" => @default_working_dir,
+        "proxy_url" => @proxy_url
       }
       YAML.dump("settings" => settings, "models" => persistable_models)
     end

data/lib/clacky/client.rb

@@ -516,61 +516,64 @@ module Clacky
     end
 
     def bedrock_connection
-      @bedrock_connection ||= Faraday.new(url: @base_url) do |conn|
-        conn.headers["Content-Type"]  = "application/json"
-        conn.headers["Authorization"] = "Bearer #{@api_key}"
-        conn.options.timeout      = @read_timeout || 300
-        conn.options.open_timeout = 10
-        conn.ssl.verify           = false
-        conn.adapter Faraday.default_adapter
+      current_epoch = Clacky::ProxyConfig.epoch
+      if @bedrock_connection.nil? ||
+         (!@bedrock_connection_epoch.nil? && @bedrock_connection_epoch != current_epoch)
+        @bedrock_connection = Faraday.new(url: @base_url) do |conn|
+          conn.headers["Content-Type"]  = "application/json"
+          conn.headers["Authorization"] = "Bearer #{@api_key}"
+          conn.options.timeout      = @read_timeout || 300
+          conn.options.open_timeout = 10
+          conn.ssl.verify           = false
+          conn.adapter Faraday.default_adapter
+        end
+        @bedrock_connection_epoch = current_epoch
       end
+      @bedrock_connection
     end
 
     def openai_connection
-      @openai_connection ||= Faraday.new(url: @base_url) do |conn|
-        conn.headers["Content-Type"]  = "application/json"
-        conn.headers["Authorization"] = "Bearer #{@api_key}"
-        conn.options.timeout      = @read_timeout || 300
-        conn.options.open_timeout = 10
-        conn.ssl.verify           = false
-        conn.adapter Faraday.default_adapter
+      current_epoch = Clacky::ProxyConfig.epoch
+      if @openai_connection.nil? ||
+         (!@openai_connection_epoch.nil? && @openai_connection_epoch != current_epoch)
+        @openai_connection = Faraday.new(url: @base_url) do |conn|
+          conn.headers["Content-Type"]  = "application/json"
+          conn.headers["Authorization"] = "Bearer #{@api_key}"
+          conn.options.timeout      = @read_timeout || 300
+          conn.options.open_timeout = 10
+          conn.ssl.verify           = false
+          conn.adapter Faraday.default_adapter
+        end
+        @openai_connection_epoch = current_epoch
       end
+      @openai_connection
     end
 
     def anthropic_connection
-      @anthropic_connection ||= Faraday.new(url: @base_url) do |conn|
-        conn.headers["Content-Type"]   = "application/json"
-        conn.headers["x-api-key"]      = @api_key
-        conn.headers["anthropic-version"] = "2023-06-01"
-        conn.headers["anthropic-dangerous-direct-browser-access"] = "true"
-        # OpenRouter's /v1/messages endpoint authenticates with a Bearer
-        # token (the OpenRouter API key), not Anthropic's x-api-key. We send
-        # both so the same connection code works for direct Anthropic and
-        # for OpenRouter-proxied Claude — each endpoint ignores the header
-        # it doesn't recognise.
-        if @provider_id == "openrouter"
-          conn.headers["Authorization"] = "Bearer #{@api_key}"
-        end
-        # Moonshot's Kimi Code (Coding Plan) endpoint enforces a User-Agent
-        # prefix whitelist limited to first-party coding agents (Kimi CLI,
-        # Claude Code, Roo Code, Kilo Code, ...). Requests with the default
-        # Faraday UA are rejected with HTTP 403 access_terminated_error,
-        # despite a valid API key. We send a Claude Code-shaped UA here
-        # because openclacky talks to this endpoint over the same Anthropic
-        # /v1/messages protocol that Claude Code uses, so the UA matches the
-        # wire-level behaviour. Hardcoding rather than exposing as a config
-        # field is intentional: the only UAs known to pass the gate are the
-        # whitelisted-client formats, and the project's preset registry is
-        # the single source of truth for provider-specific quirks (mirroring
-        # how the openrouter Bearer-fallback above is hardcoded).
-        if @provider_id == "kimi-coding"
-          conn.headers["User-Agent"] = "claude-cli/1.0.51 (external, cli)"
+      current_epoch = Clacky::ProxyConfig.epoch
+      if @anthropic_connection.nil? ||
+         (!@anthropic_connection_epoch.nil? && @anthropic_connection_epoch != current_epoch)
+        @anthropic_connection = Faraday.new(url: @base_url) do |conn|
+          conn.headers["Content-Type"]   = "application/json"
+          conn.headers["x-api-key"]      = @api_key
+          conn.headers["anthropic-version"] = "2023-06-01"
+          conn.headers["anthropic-dangerous-direct-browser-access"] = "true"
+          if @provider_id == "openrouter"
+            conn.headers["Authorization"] = "Bearer #{@api_key}"
+          end
+          # Moonshot's Kimi Code (Coding Plan) endpoint enforces a User-Agent
+          # prefix whitelist limited to first-party coding agents.
+          if @provider_id == "kimi-coding"
+            conn.headers["User-Agent"] = "claude-cli/1.0.51 (external, cli)"
+          end
+          conn.options.timeout      = @read_timeout || 300
+          conn.options.open_timeout = 10
+          conn.ssl.verify           = false
+          conn.adapter Faraday.default_adapter
         end
-        conn.options.timeout      = @read_timeout || 300
-        conn.options.open_timeout = 10
-        conn.ssl.verify           = false
-        conn.adapter Faraday.default_adapter
+        @anthropic_connection_epoch = current_epoch
       end
+      @anthropic_connection
     end
 
     # Correct relative path for the Anthropic /v1/messages endpoint, accounting

data/lib/clacky/proxy_config.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Clacky
+  # Centralized HTTP proxy policy for the current process.
+  #
+  # Single source of truth: AgentConfig#proxy_url. We never honour the user's
+  # shell ENV (HTTP_PROXY etc.) — it's stripped on every install! so a stale
+  # proxy in the launching shell can't poison Clacky.
+  #
+  # epoch increments on every actual change so that long-lived consumers
+  # (e.g. Faraday connections cached on Client instances) can detect when
+  # their cached state is stale and rebuild.
+  module ProxyConfig
+    PROXY_ENV_KEYS = %w[
+      http_proxy HTTP_PROXY
+      https_proxy HTTPS_PROXY
+      all_proxy ALL_PROXY
+    ].freeze
+
+    @installed_signature = nil
+    @epoch = 0
+
+    class << self
+      attr_reader :epoch
+
+      def install!
+        url = load_proxy_url
+        sig = url
+        return if sig == @installed_signature
+
+        strip_env_proxy
+        assign_env_proxy(url) if url && !url.empty?
+        ensure_faraday_reads_env
+
+        @installed_signature = sig
+        @epoch += 1
+      end
+
+      def reset_cache!
+        @installed_signature = nil
+        install!
+      end
+
+      private def assign_env_proxy(url)
+        %w[http_proxy HTTP_PROXY https_proxy HTTPS_PROXY].each { |k| ENV[k] = url }
+      end
+
+      private def strip_env_proxy
+        PROXY_ENV_KEYS.each { |k| ENV.delete(k) }
+      end
+
+      private def ensure_faraday_reads_env
+        return unless defined?(Faraday)
+        Faraday.ignore_env_proxy = false if Faraday.respond_to?(:ignore_env_proxy=)
+      end
+
+      private def load_proxy_url
+        cfg = Clacky::AgentConfig.load
+        cfg.respond_to?(:proxy_url) ? cfg.proxy_url.to_s.strip : ""
+      rescue StandardError
+        ""
+      end
+    end
+  end
+end

data/lib/clacky/server/http_server.rb

@@ -3917,7 +3917,8 @@ module Clacky
           ok: true,
           enable_compression: @agent_config.enable_compression,
           enable_prompt_caching: @agent_config.enable_prompt_caching,
-          memory_update_enabled: @agent_config.memory_update_enabled
+          memory_update_enabled: @agent_config.memory_update_enabled,
+          proxy_url: @agent_config.proxy_url.to_s
         })
       end
 
@@ -3935,6 +3936,22 @@ module Clacky
         if body.key?("memory_update_enabled")
           @agent_config.memory_update_enabled = !!body["memory_update_enabled"]
         end
+        if body.key?("proxy_url")
+          raw = body["proxy_url"].to_s.strip
+          if raw.empty?
+            @agent_config.proxy_url = nil
+          else
+            begin
+              uri = URI.parse(raw)
+              unless uri.is_a?(URI::HTTP) && uri.host && !uri.host.empty?
+                return json_response(res, 422, { error: "proxy_url must be a valid http(s) URL" })
+              end
+            rescue URI::InvalidURIError
+              return json_response(res, 422, { error: "proxy_url is not a valid URL" })
+            end
+            @agent_config.proxy_url = raw
+          end
+        end
 
         @agent_config.save
         json_response(res, 200, { ok: true })
@@ -4953,6 +4970,11 @@ module Clacky
           task.call
           @registry.update(session_id, status: :idle, error: nil)
           broadcast_session_update(session_id)
+          # Transient global signal for the optional task-complete sound. Sent to
+          # all clients (broadcast_all) so a browser viewing another session — or
+          # with the tab/window in the background — can still chime. Not part of
+          # session history: a chime is a live cue, never replayed on refresh.
+          broadcast_all(type: "task_finished", session_id: session_id)
           @session_manager.save(agent.to_session_data(status: :success))
           # Start idle compression timer now that the agent is idle
           idle_timer&.start

data/lib/clacky/server/scheduler.rb

@@ -192,17 +192,20 @@ module Clacky
 
       private def run_loop
         loop do
-          break unless @running
-
-          tick(Time.now)
-
-          # Sleep until the start of the next minute
-          now     = Time.now
-          sleep_s = 60 - now.sec
-          sleep(sleep_s)
+          begin
+            break unless @running
+
+            tick(Time.now)
+
+            # Sleep until the start of the next minute
+            now     = Time.now
+            sleep_s = 60 - now.sec
+            sleep(sleep_s)
+          rescue => e
+            Clacky::Logger.error("scheduler_tick_error", error: e)
+            sleep(5) # back off before retrying next tick
+          end
         end
-      rescue => e
-        Clacky::Logger.error("scheduler_fatal_error", error: e)
       end
 
       # Check all enabled schedules against the given time and fire matching ones.

data/lib/clacky/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Clacky
-  VERSION = "1.2.14"
+  VERSION = "1.2.15"
 end

data/lib/clacky/web/app.css

@@ -325,6 +325,13 @@ body {
 .theme-toggle-btn:active {
   background: var(--color-bg-hover);
 }
+/* Sound-notification toggle shares .theme-toggle-btn; highlight when ON. */
+#notify-toggle-header.notify-on {
+  color: var(--color-accent-primary, var(--color-text-primary));
+}
+#notify-toggle-header.notify-on:hover {
+  color: var(--color-accent-primary, var(--color-text-primary));
+}
 
 /* ── Content Row (Sidebar + Main) ───────────────────────────────────────── */
 #app > aside,
@@ -2282,19 +2289,31 @@ body {
 
 /* ── Diff block (rendered inline within edit/write tool-item) ─────────────── */
 .tool-item-diff {
-  margin: 0.25rem 0 0.25rem 1.25rem;
-  padding: 0.375rem 0.5rem;
+  margin: 0.375rem 0 0.375rem 1.25rem;
+  padding: 0.5rem 0.625rem;
   background: var(--color-bg-secondary);
   border: 1px solid var(--color-border-secondary);
-  border-radius: 4px;
+  border-radius: 6px;
   font-size: 0.6875rem;
   font-family: monospace;
-  line-height: 1.5;
+  line-height: 1.55;
   max-height: 20rem;
-  overflow: auto;
+  overflow-x: hidden;
+  overflow-y: auto;
+  scrollbar-width: thin;
+  scrollbar-color: var(--color-border-secondary) transparent;
 }
+.tool-item-diff::-webkit-scrollbar { width: 6px; height: 6px; }
+.tool-item-diff::-webkit-scrollbar-track { background: transparent; }
+.tool-item-diff::-webkit-scrollbar-thumb {
+  background: var(--color-border-secondary);
+  border-radius: 3px;
+}
+.tool-item-diff::-webkit-scrollbar-thumb:hover { background: var(--color-text-tertiary); }
 .diff-line {
-  white-space: pre;
+  white-space: pre-wrap;
+  word-break: break-all;
+  overflow-wrap: anywhere;
   padding: 0 0.25rem;
   border-radius: 2px;
 }
@@ -3559,6 +3578,37 @@ body {
 }
 .btn-settings-action:hover { background: var(--color-bg-hover); border-color: var(--color-accent-primary); }
 .btn-settings-action:disabled { opacity: 0.5; cursor: not-allowed; }
+
+.settings-network {
+  display: flex;
+  flex-direction: column;
+  gap: 0.875rem;
+  padding: 0.875rem 1rem;
+  background: var(--color-bg-secondary);
+  border: 1px solid var(--color-border-primary);
+  border-radius: 10px;
+}
+.settings-network-desc {
+  font-size: 0.8125rem;
+  color: var(--color-text-secondary);
+  line-height: 1.5;
+  margin: 0;
+}
+.settings-network-url {
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+}
+.settings-network-url-label {
+  font-size: 0.75rem;
+  color: var(--color-text-secondary);
+}
+.settings-network-url-row {
+  display: flex;
+  gap: 0.5rem;
+  align-items: center;
+}
+.settings-network-url-row .field-input { flex: 1; }
 .settings-loading, .settings-empty, .settings-error {
   color: var(--color-text-secondary);
   font-size: 0.8125rem;

data/lib/clacky/web/i18n.js

@@ -598,6 +598,14 @@ const I18n = (() => {
       "settings.browser.btn":              "🌐 Configure Browser",
       "settings.browser.btn.reconfigure":  "🌐 Reconfigure Browser",
       "settings.browser.btn.starting":     "Starting…",
+      "settings.network.title":            "Network",
+      "settings.network.desc":             "Clacky always ignores HTTP_PROXY / HTTPS_PROXY from your shell. Set an explicit proxy URL below to route Clacky's outbound traffic through a proxy.",
+      "settings.network.proxyUrl":         "Proxy URL",
+      "settings.network.save":             "Save",
+      "settings.network.saved":            "Saved",
+      "settings.network.clear":            "Clear",
+      "settings.network.cleared":          "Cleared — direct connection",
+      "settings.network.invalidUrl":       "Invalid URL — use http://host:port or http://user:pass@host:port",
       "settings.brand.title":              "Brand & License",
       "settings.brand.label.brand":        "Brand",
       "settings.brand.label.status":       "Status",
@@ -698,6 +706,8 @@ const I18n = (() => {
       "brand.banner.freePromptBoth":      "Welcome to {{name}} — {{free}} free skill{{freePlural}} ready to use, plus {{paid}} premium skill{{paidPlural}} unlockable with a serial number.",
 
       "header.owner.tooltip":     "Creator — click to open Creator Hub",
+      "notify.tooltip.on":        "Sound on task complete: ON (click to mute)",
+      "notify.tooltip.off":       "Sound on task complete: OFF (click to enable)",
 
       // ── Session info bar / Model switcher benchmark ──
       "sib.bench.btn":        "Benchmark",
@@ -1339,6 +1349,14 @@ const I18n = (() => {
       "settings.browser.btn":              "🌐 配置浏览器",
       "settings.browser.btn.reconfigure":  "🌐 重新配置浏览器",
       "settings.browser.btn.starting":     "启动中…",
+      "settings.network.title":            "网络",
+      "settings.network.desc":             "Clacky 始终忽略系统的 HTTP_PROXY / HTTPS_PROXY。如需让 Clacky 走代理，请在下方填入显式代理地址。",
+      "settings.network.proxyUrl":         "代理地址",
+      "settings.network.save":             "保存",
+      "settings.network.saved":            "已保存",
+      "settings.network.clear":            "清除",
+      "settings.network.cleared":          "已清除 — 直连",
+      "settings.network.invalidUrl":       "地址格式不正确，请使用 http://host:port 或 http://user:pass@host:port",
       "settings.brand.title":              "品牌 & 授权",
       "settings.brand.label.brand":        "品牌",
       "settings.brand.label.status":       "状态",
@@ -1439,6 +1457,8 @@ const I18n = (() => {
       "brand.banner.freePromptBoth":      "欢迎使用 {{name}} — 已自动安装 {{free}} 个免费技能，还有 {{paid}} 个增值技能可输入序列号解锁。",
 
       "header.owner.tooltip":     "创作者 — 点击进入创作者中心",
+      "notify.tooltip.on":        "任务完成提示音：已开启（点击关闭）",
+      "notify.tooltip.off":       "任务完成提示音：已关闭（点击开启）",
 
       // ── 会话信息栏 / 模型切换器 测速 ──
       "sib.bench.btn":        "测速",

data/lib/clacky/web/index.html

@@ -44,6 +44,7 @@
       </div>
     </div>
     <div id="header-right">
+      <button id="notify-toggle-header" class="theme-toggle-btn" data-i18n-title="notify.tooltip.off" title="Sound on task complete"></button>
       <button id="theme-toggle-header" class="theme-toggle-btn" title="Toggle theme">
         <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon-sm">
           <path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"/>
@@ -869,6 +870,25 @@
             </div>
           </section>
 
+          <!-- Network / Proxy section -->
+          <section class="settings-section" id="network-section">
+            <div class="settings-section-title">
+              <span data-i18n="settings.network.title">Network</span>
+            </div>
+            <div class="settings-network">
+              <p class="settings-network-desc" data-i18n="settings.network.desc">Clacky always ignores HTTP_PROXY / HTTPS_PROXY from your shell. To route Clacky's outbound traffic through a proxy, set an explicit URL below.</p>
+              <div class="settings-network-url">
+                <label class="settings-network-url-label" for="settings-proxy-url" data-i18n="settings.network.proxyUrl">Proxy URL</label>
+                <div class="settings-network-url-row">
+                  <input type="text" id="settings-proxy-url" class="field-input" placeholder="http://user:pass@host:port" autocomplete="off" spellcheck="false">
+                  <button type="button" id="btn-save-proxy-url" class="btn-settings-action" data-i18n="settings.network.save">Save</button>
+                  <button type="button" id="btn-clear-proxy-url" class="btn-settings-action" data-i18n="settings.network.clear">Clear</button>
+                </div>
+                <div id="settings-proxy-url-status" class="model-test-result"></div>
+              </div>
+            </div>
+          </section>
+
           <!-- Brand & License section -->
           <section class="settings-section" id="brand-license-section">
             <div class="settings-section-title">
@@ -1300,6 +1320,7 @@
 <script src="/i18n.js"></script>
 <script src="/auth.js"></script>
 <script src="/theme.js"></script>
+<script src="/notify.js"></script>
 <script src="/ws.js"></script>
 <script src="/ws-dispatcher.js"></script>
 <script src="/sessions.js"></script>

data/lib/clacky/web/notify.js

@@ -0,0 +1,154 @@
+// notify.js — Task-complete sound notification module
+//
+// Plays a short sound when an agent task finishes, driven by the global
+// `task_finished` event the server broadcasts (broadcast_all) the moment a
+// task completes. We listen to this dedicated signal — rather than `complete`
+// (only delivered to subscribers of that session) — so a background session
+// finishing still reaches every browser. Whether a task *finished* is decided
+// on the backend; this module only decides whether the user is looking.
+//
+// The chime only fires when the user is NOT actively looking at the
+// finished session. "Not looking" means ANY of:
+//   1. The finished session is not the currently open one
+//      (sid !== Sessions.activeId)
+//   2. The browser window has lost focus      (!document.hasFocus())
+//   3. The tab is hidden / minimised / behind another tab (document.hidden)
+//
+// If the user is focused on the very session that just finished, we stay
+// silent — they can already see the result.
+//
+// The feature is gated behind a header toggle (🔔/🔕) next to the theme
+// switcher. Default OFF; the choice is persisted to localStorage.
+//
+// No history replay: a chime is a live cue, never re-fired on page refresh.
+// The audio file is served as a static asset (/notify.mp3) by WEBrick.
+//
+// Depends on: Sessions (sessions.js) for activeId, I18n (i18n.js) for the
+//             tooltip text. Both are optional — guarded with typeof checks.
+// ─────────────────────────────────────────────────────────────────────────
+const Notify = (() => {
+  const STORAGE_KEY = "clacky-notify-sound";
+  const AUDIO_SRC   = "/notify.mp3";
+
+  let _audio = null;
+
+  // ── State ────────────────────────────────────────────────────────────
+  // Default OFF: only enabled when localStorage explicitly says "on".
+  function enabled() {
+    return localStorage.getItem(STORAGE_KEY) === "on";
+  }
+
+  function setEnabled(on) {
+    localStorage.setItem(STORAGE_KEY, on ? "on" : "off");
+    _updateToggleIcon();
+    // On enabling, "prime" the audio element within this user gesture so the
+    // browser's autoplay policy lets later programmatic play() calls through.
+    if (on) _prime();
+  }
+
+  function toggle() {
+    setEnabled(!enabled());
+  }
+
+  // ── Audio ────────────────────────────────────────────────────────────
+  function _ensureAudio() {
+    if (!_audio) {
+      _audio = new Audio(AUDIO_SRC);
+      _audio.preload = "auto";
+    }
+    return _audio;
+  }
+
+  // Play+pause+reset muted once, triggered by the toggle click (a user
+  // gesture), to satisfy autoplay policies for subsequent unmuted plays.
+  function _prime() {
+    const a = _ensureAudio();
+    const prevMuted = a.muted;
+    a.muted = true;
+    const p = a.play();
+    if (p && typeof p.then === "function") {
+      p.then(() => {
+        a.pause();
+        a.currentTime = 0;
+        a.muted = prevMuted;
+      }).catch(() => { a.muted = prevMuted; });
+    } else {
+      a.muted = prevMuted;
+    }
+  }
+
+  function _play() {
+    const a = _ensureAudio();
+    try {
+      a.currentTime = 0;
+      const p = a.play();
+      // Swallow autoplay-policy rejections silently — better to miss a
+      // chime than to throw an unhandled promise rejection.
+      if (p && typeof p.catch === "function") p.catch(() => {});
+    } catch (_e) { /* ignore */ }
+  }
+
+  // ── Trigger decision ───────────────────────────────────────────────────
+  // Returns true when the user is NOT actively viewing the given session.
+  function _userIsAway(sid) {
+    // 1. Finished session is not the one currently open.
+    const activeId = (typeof Sessions !== "undefined") ? Sessions.activeId : null;
+    if (sid && sid !== activeId) return true;
+    // 2. Browser window is not focused (e.g. another app / window on top).
+    if (typeof document.hasFocus === "function" && !document.hasFocus()) return true;
+    // 3. Tab is hidden (switched to another tab, or window minimised).
+    if (document.hidden) return true;
+    return false;
+  }
+
+  // Called from ws-dispatcher on the `task_finished` event — a transient global
+  // signal the server broadcasts to every client the moment an agent task
+  // completes. We only decide whether the user is looking at that session;
+  // the "did a task just finish" judgement lives on the backend.
+  function onTaskFinished(sid) {
+    if (!enabled()) return;
+    if (!_userIsAway(sid)) return;
+    _play();
+  }
+
+  // ── Toggle button UI ───────────────────────────────────────────────────
+  function _updateToggleIcon() {
+    const btn = document.getElementById("notify-toggle-header");
+    if (!btn) return;
+    const on = enabled();
+    // Bell when ON, bell-off (muted) when OFF.
+    btn.innerHTML = on
+      ? `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon-sm">
+          <path d="M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9"/>
+          <path d="M10.3 21a1.94 1.94 0 0 0 3.4 0"/>
+        </svg>`
+      : `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon-sm">
+          <path d="M8.7 3A6 6 0 0 1 18 8c0 1.5.2 2.8.5 3.9"/>
+          <path d="M17 17H3s3-2 3-9a4.67 4.67 0 0 1 .3-1.7"/>
+          <path d="M10.3 21a1.94 1.94 0 0 0 3.4 0"/>
+          <line x1="2" y1="2" x2="22" y2="22"/>
+        </svg>`;
+    btn.classList.toggle("notify-on", on);
+    if (typeof I18n !== "undefined") {
+      const tip = I18n.t(on ? "notify.tooltip.on" : "notify.tooltip.off");
+      btn.title = tip;
+      btn.setAttribute("aria-label", tip);
+    }
+  }
+
+  // ── Init ─────────────────────────────────────────────────────────────
+  function init() {
+    _updateToggleIcon();
+    const btn = document.getElementById("notify-toggle-header");
+    if (btn) btn.addEventListener("click", toggle);
+  }
+
+  return { init, toggle, enabled, setEnabled, onTaskFinished };
+})();
+
+// Initialize on load (button binding + initial icon state).
+if (document.readyState === "loading") {
+  document.addEventListener("DOMContentLoaded", () => Notify.init());
+} else {
+  Notify.init();
+}

data/lib/clacky/web/settings.js

@@ -19,6 +19,7 @@ const Settings = (() => {
     _loadMedia();
     _loadBrand();
     _loadBrowserStatus();
+    _initNetworkSettings();
     _applyAboutTabVisibility();
   }
 
@@ -1200,6 +1201,62 @@ const Settings = (() => {
     }
   }
 
+  // ── Network / Proxy ───────────────────────────────────────────────────────────
+
+  async function _initNetworkSettings() {
+    const urlInput = document.getElementById("settings-proxy-url");
+    const saveBtn  = document.getElementById("btn-save-proxy-url");
+    const clearBtn = document.getElementById("btn-clear-proxy-url");
+    const status   = document.getElementById("settings-proxy-url-status");
+    if (!urlInput || !saveBtn) return;
+
+    try {
+      const res  = await fetch("/api/config/settings");
+      const data = await res.json();
+      if (data.ok) {
+        urlInput.value = data.proxy_url || "";
+      }
+    } catch (_) { /* non-critical */ }
+
+    async function _patchProxyUrl(value, successKey) {
+      status.textContent = "";
+      status.className   = "model-test-result";
+      try {
+        const res  = await fetch("/api/config/settings", {
+          method:  "PATCH",
+          headers: { "Content-Type": "application/json" },
+          body:    JSON.stringify({ proxy_url: value })
+        });
+        const data = await res.json();
+        if (data.ok) {
+          status.textContent = I18n.t(successKey);
+          status.className   = "model-test-result success";
+        } else {
+          status.textContent = data.error || I18n.t("settings.network.invalidUrl");
+          status.className   = "model-test-result error";
+        }
+      } catch (e) {
+        status.textContent = e.message || I18n.t("settings.network.invalidUrl");
+        status.className   = "model-test-result error";
+      }
+    }
+
+    if (!saveBtn.dataset.bound) {
+      saveBtn.dataset.bound = "1";
+      saveBtn.addEventListener("click", () => {
+        _patchProxyUrl(urlInput.value.trim(), "settings.network.saved");
+      });
+    }
+
+    if (clearBtn && !clearBtn.dataset.bound) {
+      clearBtn.dataset.bound = "1";
+      clearBtn.addEventListener("click", () => {
+        urlInput.value = "";
+        _patchProxyUrl("", "settings.network.cleared");
+      });
+    }
+  }
+
   // ── Brand & License ───────────────────────────────────────────────────────────
 
   // Whether the server was started with --brand-test (relaxed key validation).

data/lib/clacky/web/ws-dispatcher.js

@@ -265,6 +265,14 @@ WS.onEvent(ev => {
       break;
     }
 
+    // Transient global signal emitted the moment any agent task finishes
+    // (broadcast to every client, not just session subscribers). Used only
+    // to play the optional completion chime; the toggle gates it and the
+    // module decides whether the user is looking at that session.
+    case "task_finished":
+      if (typeof Notify !== "undefined") Notify.onTaskFinished(ev.session_id);
+      break;
+
     case "session_renamed": {
       Sessions.patch(ev.session_id, { name: ev.name });
       Sessions.renderList();

data/lib/clacky.rb

@@ -92,6 +92,7 @@ require_relative "clacky/ui2/progress_indicator"
 
 # Utils
 require_relative "clacky/utils/logger"
+require_relative "clacky/proxy_config"
 require_relative "clacky/platform_http_client"
 require_relative "clacky/utils/encoding"
 require_relative "clacky/utils/environment_detector"
@@ -165,3 +166,5 @@ module Clacky
   class BrowserNotReachableError < AgentError; end  # Chrome/Edge not running or remote debugging disabled
   # BrowserManager singleton: Clacky::BrowserManager.instance
 end
+
+Clacky::ProxyConfig.install!

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openclacky
 version: !ruby/object:Gem::Version
-  version: 1.2.14
+  version: 1.2.15
 platform: ruby
 authors:
 - windy
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
+date: 2026-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -429,6 +429,7 @@ files:
 - lib/clacky/plain_ui_controller.rb
 - lib/clacky/platform_http_client.rb
 - lib/clacky/providers.rb
+- lib/clacky/proxy_config.rb
 - lib/clacky/rich_ui_controller.rb
 - lib/clacky/server/browser_manager.rb
 - lib/clacky/server/channel.rb
@@ -552,6 +553,8 @@ files:
 - lib/clacky/web/marked.min.js
 - lib/clacky/web/mcp.js
 - lib/clacky/web/model-tester.js
+- lib/clacky/web/notify.js
+- lib/clacky/web/notify.mp3
 - lib/clacky/web/onboard.js
 - lib/clacky/web/profile.js
 - lib/clacky/web/sessions.js