openclacky 1.2.13 → 1.2.15

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).
@@ -1528,7 +1585,7 @@ const Settings = (() => {
   // The state object per kind:
   //   { source, configured, model, base_url, api_key_masked, provider, available }
 
-  const MEDIA_KINDS = ["image", "video", "audio"];
+  const MEDIA_KINDS = ["image", "video", "audio", "ocr"];
   let _mediaState = null;
   let _mediaDefaults = null;
   const _mediaCustomDraft = {};
@@ -1538,10 +1595,16 @@ const Settings = (() => {
     if (!container) return;
     container.innerHTML = `<div class="settings-loading">${I18n.t("settings.media.loading")}</div>`;
     try {
-      const res = await fetch("/api/config/media");
-      const data = await res.json();
-      _mediaState = data.media || {};
-      _mediaDefaults = data.default_provider || {};
+      const [mediaRes, ocrRes] = await Promise.all([
+        fetch("/api/config/media"),
+        fetch("/api/config/ocr")
+      ]);
+      const mediaData = await mediaRes.json();
+      const ocrData   = await ocrRes.json();
+      _mediaState = mediaData.media || {};
+      _mediaDefaults = mediaData.default_provider || {};
+      _mediaState["ocr"] = ocrData.ocr || { source: "off", available: [] };
+      _mediaDefaults["ocr"] = ocrData.default_provider || { available: [] };
       _renderMediaRows();
     } catch (e) {
       container.innerHTML = `<div class="settings-error">${I18n.t("settings.media.error", { msg: e.message })}</div>`;
@@ -1557,6 +1620,14 @@ const Settings = (() => {
     });
   }
 
+  function _refreshKindRows(_kind) {
+    _renderMediaRows();
+  }
+
+  async function _reloadKind(_kind) {
+    await _loadMedia();
+  }
+
   function _renderMediaRow(kind) {
     const state = (_mediaState && _mediaState[kind]) || { source: "off", available: [] };
     const def   = (_mediaDefaults && _mediaDefaults[kind]) || { available: [] };
@@ -1662,7 +1733,7 @@ const Settings = (() => {
             _setMediaResult(kind, "testing", I18n.t("settings.media.action.saving"));
             try {
               await _saveMediaConfig(kind, payload);
-              await _loadMedia();
+              await _reloadKind(kind);
             } catch (e) {
               sel.disabled = false;
               _setMediaResult(kind, "fail", e.message);
@@ -1742,7 +1813,7 @@ const Settings = (() => {
           base_url: state.base_url || "",
           api_key:  ""
         };
-        _renderMediaRows();
+        _refreshKindRows(kind);
       });
 
       const testBtn = document.createElement("button");
@@ -1818,7 +1889,7 @@ const Settings = (() => {
         const fallback = (_mediaDefaults && _mediaDefaults[kind] && _mediaDefaults[kind].model) ? "auto" : "off";
         _mediaState[kind] = { ..._mediaState[kind], source: fallback };
       }
-      _renderMediaRows();
+      _refreshKindRows(kind);
     });
 
     const saveBtn = document.createElement("button");
@@ -1838,7 +1909,7 @@ const Settings = (() => {
           api_key:  d.api_key || ""
         });
         delete _mediaCustomDraft[kind];
-        await _loadMedia();
+        await _reloadKind(kind);
       } catch (e) {
         saveBtn.disabled = false;
         cancelBtn.disabled = false;
@@ -1906,7 +1977,8 @@ const Settings = (() => {
   }
 
   async function _saveMediaConfig(kind, body) {
-    const res = await fetch(`/api/config/media/${kind}`, {
+    const url = kind === "ocr" ? `/api/config/ocr` : `/api/config/media/${kind}`;
+    const res = await fetch(url, {
       method: "PATCH",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(body)
@@ -1920,10 +1992,14 @@ const Settings = (() => {
 
   async function _testMediaConfig(kind, { model, base_url, api_key }) {
     try {
-      const res = await fetch(`/api/config/media/test`, {
+      const url = kind === "ocr" ? `/api/config/ocr/test` : `/api/config/media/test`;
+      const payload = kind === "ocr"
+        ? { model, base_url, api_key }
+        : { kind, model, base_url, api_key };
+      const res = await fetch(url, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ kind, model, base_url, api_key })
+        body: JSON.stringify(payload)
       });
       const data = await res.json().catch(() => ({}));
       if (!res.ok) return { ok: false, message: data.error || `HTTP ${res.status}` };

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"
@@ -128,6 +129,7 @@ require_relative "clacky/mcp/skill_provider"
 require_relative "clacky/media/base"
 require_relative "clacky/media/openai_compat"
 require_relative "clacky/media/generator"
+require_relative "clacky/vision/resolver"
 require_relative "clacky/telemetry"
 require_relative "clacky/agent"
 
@@ -164,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.13
+  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
@@ -359,6 +359,7 @@ files:
 - lib/clacky/default_parsers/pdf_parser.rb
 - lib/clacky/default_parsers/pdf_parser_ocr.py
 - lib/clacky/default_parsers/pdf_parser_plumber.py
+- lib/clacky/default_parsers/pdf_parser_vlm.py
 - lib/clacky/default_parsers/pptx_parser.rb
 - lib/clacky/default_parsers/wps_parser.rb
 - lib/clacky/default_parsers/xlsx_parser.rb
@@ -428,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
@@ -532,6 +534,7 @@ files:
 - lib/clacky/utils/trash_directory.rb
 - lib/clacky/utils/workspace_rules.rb
 - lib/clacky/version.rb
+- lib/clacky/vision/resolver.rb
 - lib/clacky/web/app.css
 - lib/clacky/web/app.js
 - lib/clacky/web/apple-touch-icon-180.png
@@ -550,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