openclacky 1.2.18 → 1.3.1

data/lib/clacky/web/settings.js

@@ -20,6 +20,7 @@ const Settings = (() => {
     _loadBrand();
     _loadBrowserStatus();
     _initNetworkSettings();
+    if (window.Backup) Backup.load();
     _applyAboutTabVisibility();
   }
 
@@ -1636,10 +1637,11 @@ const Settings = (() => {
     const def   = (_mediaDefaults && _mediaDefaults[kind]) || { available: [] };
     const autoAvailable = !!(def && def.model);
     const isCustomEditing = state.source === "custom" && (!state.configured || _mediaCustomDraft[kind]);
+    const isVisionPrimary = kind === "ocr" && state.source === "auto" && state.primary;
 
     const row = document.createElement("div");
     row.className = "media-row";
-    if (isCustomEditing || (state.source === "auto" && state.configured) || (state.source === "custom" && state.configured)) {
+    if (!isVisionPrimary && (isCustomEditing || (state.source === "auto" && state.configured) || (state.source === "custom" && state.configured))) {
       row.classList.add("is-expanded");
     }
     row.dataset.kind = kind;
@@ -1653,6 +1655,24 @@ const Settings = (() => {
     title.textContent = I18n.t(`settings.media.kind.${kind}`);
     head.appendChild(title);
 
+    // When the default chat model already supports vision, the OCR sidecar
+    // reuses it automatically — there's nothing to choose, so show a single
+    // read-only note instead of the off/auto/custom switcher.
+    if (isVisionPrimary) {
+      const note = document.createElement("span");
+      note.className = "media-row-status media-vision-primary-note";
+      note.textContent = I18n.t("settings.media.vision.primary");
+      head.appendChild(note);
+
+      const model = document.createElement("span");
+      model.className = "media-vision-primary-model";
+      model.textContent = state.model || "";
+      head.appendChild(model);
+
+      row.appendChild(head);
+      return row;
+    }
+
     const seg = document.createElement("div");
     seg.className = "media-row-segmented";
     ["off", "auto", "custom"].forEach(src => {

data/lib/clacky/web/skills.js

@@ -336,6 +336,15 @@ const Skills = (() => {
       ? ""
       : `<button class="btn-skill-use" data-name="${escapeHtml(skill.name)}">${I18n.t("skills.btn.use")}</button>`;
 
+    // Delete button only for custom (non-system, non-brand) skills
+    const deleteButtonHtml = isSystem
+      ? ""
+      : `<button class="btn-skill-delete" data-name="${escapeHtml(skill.name)}" title="${I18n.t("skills.btn.delete")}">
+           <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+             <polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/>
+           </svg>
+         </button>`;
+
     card.innerHTML = `
       <div class="skill-card-main">
         <div class="skill-card-info">
@@ -353,6 +362,7 @@ const Skills = (() => {
             <span class="skill-toggle-track"></span>
           </label>
           ${useButtonHtml}
+          ${deleteButtonHtml}
         </div>
       </div>
       ${errorNoticeHtml}`;
@@ -374,7 +384,7 @@ const Skills = (() => {
         const toggleTop = toggleLabel.getBoundingClientRect().top;
         const scrollerTop = scroller.getBoundingClientRect().top;
         if (toggleTop - scrollerTop < 80) {
-          toggleLabel.classList.add("skill-toggle-flip");
+          toggleLabel.setAttribute("data-tooltip-pos", "bottom");
         }
       });
     }
@@ -385,6 +395,15 @@ const Skills = (() => {
       useBtn.addEventListener("click", () => _useInstalledSkill(skill.name));
     }
 
+    // Bind delete button event
+    const deleteBtn = card.querySelector(".btn-skill-delete");
+    if (deleteBtn) {
+      deleteBtn.addEventListener("click", (e) => {
+        e.stopPropagation();
+        Skills.delete(skill.name);
+      });
+    }
+
     return card;
   }
 
@@ -579,6 +598,20 @@ const Skills = (() => {
       }
     },
 
+    /** Delete a skill by name. Prompts confirmation, then DELETE to server. */
+    async delete(name) {
+      if (!confirm(I18n.t("skills.deleteConfirm", { name }))) return;
+      try {
+        const res = await fetch(`/api/skills/${encodeURIComponent(name)}`, { method: "DELETE" });
+        const data = await res.json();
+        if (!res.ok) { alert(data.error || I18n.t("skills.deleteError")); return; }
+        Modal.toast(I18n.t("skills.deleted", { name }), "success");
+        await Skills.load();
+      } catch (e) {
+        console.error("[Skills] delete failed", e);
+      }
+    },
+
     /** Switch the Skills panel to the brand-skills tab.
      *  Called externally (e.g. from settings.js after license activation) to
      *  guide the user directly to the Brand Skills download page.

data/lib/clacky/web/tasks.js

@@ -18,81 +18,158 @@ const Tasks = (() => {
 
   // ── Private helpers ────────────────────────────────────────────────────
 
+  function _humanCron(cron) {
+    if (!cron) return cron;
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length !== 5) return cron;
+    const [min, hour, dom, month, dow] = parts;
+
+    const isAny = v => v === "*";
+    const isNum = v => /^\d+$/.test(v);
+    const pad   = n => String(n).padStart(2, "0");
+
+    const lang = (typeof I18n !== "undefined" && I18n.lang()) || "zh";
+    const isZh = lang === "zh";
+
+    const dowNames = isZh
+      ? ["周日","周一","周二","周三","周四","周五","周六"]
+      : ["Sun","Mon","Tue","Wed","Thu","Fri","Sat"];
+
+    const monthNames = isZh
+      ? ["1月","2月","3月","4月","5月","6月","7月","8月","9月","10月","11月","12月"]
+      : ["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];
+
+    const timeStr = (isNum(hour) && isNum(min))
+      ? `${pad(hour)}:${pad(min)}`
+      : null;
+
+    // Every N minutes
+    if (min.startsWith("*/") && isAny(hour) && isAny(dom) && isAny(month) && isAny(dow)) {
+      const n = min.slice(2);
+      return isZh ? `每 ${n} 分钟` : `Every ${n} min`;
+    }
+    // Every N hours
+    if (isAny(min) && hour.startsWith("*/") && isAny(dom) && isAny(month) && isAny(dow)) {
+      const n = hour.slice(2);
+      return isZh ? `每 ${n} 小时` : `Every ${n} hr`;
+    }
+    // Every minute
+    if (isAny(min) && isAny(hour) && isAny(dom) && isAny(month) && isAny(dow)) {
+      return isZh ? "每分钟" : "Every minute";
+    }
+    // Every hour at :MM
+    if (isNum(min) && isAny(hour) && isAny(dom) && isAny(month) && isAny(dow)) {
+      return isZh ? `每小时 :${pad(min)}` : `Hourly at :${pad(min)}`;
+    }
+    // Specific day-of-week
+    if (timeStr && isAny(dom) && isAny(month) && isNum(dow)) {
+      const d = dowNames[parseInt(dow, 10)] || dow;
+      return isZh ? `每${d} ${timeStr}` : `${d} ${timeStr}`;
+    }
+    // Weekdays (1-5)
+    if (timeStr && isAny(dom) && isAny(month) && dow === "1-5") {
+      return isZh ? `工作日 ${timeStr}` : `Weekdays ${timeStr}`;
+    }
+    // Weekends (0,6 or 6,0)
+    if (timeStr && isAny(dom) && isAny(month) && (dow === "0,6" || dow === "6,0")) {
+      return isZh ? `周末 ${timeStr}` : `Weekends ${timeStr}`;
+    }
+    // Every day at HH:MM
+    if (timeStr && isAny(dom) && isAny(month) && isAny(dow)) {
+      return isZh ? `每天 ${timeStr}` : `Daily ${timeStr}`;
+    }
+    // Specific day of month
+    if (timeStr && isNum(dom) && isAny(month) && isAny(dow)) {
+      return isZh ? `每月 ${dom} 日 ${timeStr}` : `Monthly day ${dom} ${timeStr}`;
+    }
+    // Specific month + day
+    if (timeStr && isNum(dom) && isNum(month) && isAny(dow)) {
+      const m = monthNames[parseInt(month, 10) - 1] || month;
+      return isZh ? `${m}${dom}日 ${timeStr}` : `${m} ${dom} ${timeStr}`;
+    }
+
+    return cron;
+  }
+
   /** Render a single task row in the main panel table. */
   function _renderTaskRow(t) {
     const row = document.createElement("div");
-    row.className = "task-table-row";
+    row.className = "task-card";
     row.dataset.name = t.name;
 
+    const isPaused = t.scheduled && t.enabled === false;
+    row.classList.toggle("task-card-paused", isPaused);
+
     const schedLabel = t.scheduled
-      ? escapeHtml(t.cron)
-      : `<span class="sched-manual">${I18n.t("tasks.manual")}</span>`;
+      ? `<span class="task-card-cron" title="${escapeHtml(t.cron)}">${escapeHtml(_humanCron(t.cron))}</span>`
+      : `<span class="task-card-cron task-card-cron-manual">${I18n.t("tasks.manual")}</span>`;
 
-    // Visual hint: dim the schedule + prepend a "Paused" badge when disabled.
-    const isPaused = t.scheduled && t.enabled === false;
-    const schedCell = isPaused
-      ? `<span class="sched-paused-badge">${I18n.t("tasks.paused")}</span>
-         <span class="sched-paused-cron">${schedLabel}</span>`
-      : schedLabel;
+    const pausedBadge = isPaused
+      ? `<span class="task-card-badge task-card-badge-paused">${I18n.t("tasks.paused")}</span>`
+      : "";
 
-          const preview = (t.content || "")
+    const preview = (t.content || "")
       .split("\n")
       .map(l => l.trim())
       .find(l => l.length > 0) || I18n.t("tasks.empty");
-    const previewText = preview.length > 80
-      ? escapeHtml(preview.slice(0, 80)) + "…"
+    const previewText = preview.length > 120
+      ? escapeHtml(preview.slice(0, 120)) + "…"
       : escapeHtml(preview);
 
-    // Build the pause/resume button only for *scheduled* tasks. Manual tasks
-    // have no cron to disable.
     const toggleBtnHtml = t.scheduled ? (isPaused
-      ? `<button class="task-btn task-btn-toggle task-btn-resume" title="${I18n.t("tasks.btn.resume")}">
-           <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">
+      ? `<button class="task-action-btn task-btn-toggle task-btn-resume">
+           <svg xmlns="http://www.w3.org/2000/svg" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
              <polygon points="6 3 20 12 6 21 6 3"/>
-           </svg><span class="btn-label"> ${I18n.t("tasks.btn.resume")}</span>
+           </svg>
+           <span>${I18n.t("tasks.btn.resume")}</span>
          </button>`
-      : `<button class="task-btn task-btn-toggle task-btn-pause" title="${I18n.t("tasks.btn.pause")}">
-           <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">
+      : `<button class="task-action-btn task-btn-toggle task-btn-pause">
+           <svg xmlns="http://www.w3.org/2000/svg" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
              <rect x="6" y="4" width="4" height="16" rx="1"/>
              <rect x="14" y="4" width="4" height="16" rx="1"/>
-           </svg><span class="btn-label"> ${I18n.t("tasks.btn.pause")}</span>
+           </svg>
+           <span>${I18n.t("tasks.btn.pause")}</span>
          </button>`
     ) : "";
 
-    row.classList.toggle("task-row-paused", isPaused);
-
     row.innerHTML = `
-      <div class="task-col task-col-name">
-        <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="task-icon task-name-icon">
-          <circle cx="12" cy="12" r="10"/>
-          <polyline points="12 6 12 12 16 14"/>
-        </svg>
-        <div class="task-name-info">
-          <span class="task-name-text">${escapeHtml(t.name)}</span>
-          <span class="task-name-sched">${schedCell}</span>
-        </div>
-      </div>
-      <div class="task-col task-col-schedule">${schedCell}</div>
-      <div class="task-col task-col-content">${previewText}</div>
-      <div class="task-col task-col-actions">
-        <button class="task-btn task-btn-run"  title="${I18n.t("tasks.btn.run")}">
-          <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">
-            <polygon points="6 3 20 12 6 21 6 3"/>
-          </svg><span class="btn-label"> ${I18n.t("tasks.btn.run")}</span>
-        </button>
-        ${toggleBtnHtml}
-        <button class="task-btn task-btn-edit" title="${I18n.t("tasks.btn.edit")}">
-          <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="M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z"/>
-            <path d="m15 5 4 4"/>
-          </svg><span class="btn-label"> ${I18n.t("tasks.btn.edit")}</span>
-        </button>
-        <button class="task-btn task-btn-del"  title="Delete">
-          <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="M18 6 6 18"/>
-            <path d="m6 6 12 12"/>
+      <div class="task-card-main">
+        <div class="task-card-icon">
+          <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
+            <circle cx="12" cy="12" r="10"/>
+            <polyline points="12 6 12 12 16 14"/>
           </svg>
-        </button>
+        </div>
+        <div class="task-card-info">
+          <div class="task-card-title-row">
+            <span class="task-card-name">${escapeHtml(t.name)}</span>
+            ${pausedBadge}
+            ${schedLabel}
+          </div>
+          <div class="task-card-preview">${previewText}</div>
+        </div>
+        <div class="task-card-actions">
+          <button class="task-run-btn task-btn-run" title="${I18n.t("tasks.btn.run")}">
+            <svg xmlns="http://www.w3.org/2000/svg" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+              <polygon points="6 3 20 12 6 21 6 3"/>
+            </svg>
+            <span>${I18n.t("tasks.btn.run")}</span>
+          </button>
+          ${toggleBtnHtml}
+          <button class="task-action-btn task-btn-edit">
+            <svg xmlns="http://www.w3.org/2000/svg" width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+              <path d="M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z"/>
+              <path d="m15 5 4 4"/>
+            </svg>
+            <span>${I18n.t("tasks.btn.edit")}</span>
+          </button>
+          <button class="task-action-btn task-btn-del">
+            <svg xmlns="http://www.w3.org/2000/svg" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+              <path d="M3 6h18"/><path d="M19 6l-1 14H6L5 6"/><path d="M8 6V4h8v2"/>
+            </svg>
+            <span>${I18n.t("tasks.btn.delete")}</span>
+          </button>
+        </div>
       </div>`;
 
     row.querySelector(".task-btn-run").addEventListener("click", e => {
@@ -178,15 +255,6 @@ const Tasks = (() => {
         return;
       }
 
-      const header = document.createElement("div");
-      header.className = "task-table-header";
-      header.innerHTML = `
-        <div class="task-col task-col-name">${I18n.t("tasks.col.name")}</div>
-        <div class="task-col task-col-schedule">${I18n.t("tasks.col.schedule")}</div>
-        <div class="task-col task-col-content">${I18n.t("tasks.col.task")}</div>
-        <div class="task-col task-col-actions"></div>`;
-      table.appendChild(header);
-
       _tasks.forEach(t => table.appendChild(_renderTaskRow(t)));
     },
 

data/lib/clacky/web/utils.js

@@ -55,3 +55,75 @@ const IME = (() => {
 
   return { track, bindEnter };
 })();
+
+const Tooltip = (() => {
+  const GAP = 8;
+  let el = null;
+  let _hideTimer = null;
+
+  function _el() {
+    if (!el) el = document.getElementById("tooltip");
+    return el;
+  }
+
+  function show(anchor) {
+    const tip = _el();
+    if (!tip) return;
+    clearTimeout(_hideTimer);
+
+    const text = anchor.getAttribute("data-tooltip");
+    if (!text) return;
+
+    const pos = anchor.getAttribute("data-tooltip-pos") || "top";
+    tip.textContent = text;
+    tip.setAttribute("data-pos", pos);
+    tip.style.display = "block";
+
+    const r = anchor.getBoundingClientRect();
+    const tw = tip.offsetWidth;
+    const th = tip.offsetHeight;
+
+    let top, left;
+    if (pos === "bottom") {
+      top  = r.bottom + GAP;
+      left = r.left + r.width / 2 - tw / 2;
+    } else if (pos === "left") {
+      top  = r.top + r.height / 2 - th / 2;
+      left = r.left - tw - GAP;
+    } else if (pos === "right") {
+      top  = r.top + r.height / 2 - th / 2;
+      left = r.right + GAP;
+    } else {
+      top  = r.top - th - GAP;
+      left = r.left + r.width / 2 - tw / 2;
+    }
+
+    left = Math.max(6, Math.min(left, window.innerWidth  - tw - 6));
+    top  = Math.max(6, Math.min(top,  window.innerHeight - th - 6));
+
+    tip.style.left = `${left}px`;
+    tip.style.top  = `${top}px`;
+    requestAnimationFrame(() => tip.classList.add("visible"));
+  }
+
+  function hide() {
+    const tip = _el();
+    if (!tip) return;
+    tip.classList.remove("visible");
+    _hideTimer = setTimeout(() => { tip.style.display = "none"; }, 120);
+  }
+
+  function init() {
+    document.addEventListener("mouseover", (e) => {
+      const anchor = e.target.closest("[data-tooltip]");
+      if (anchor) show(anchor);
+    });
+    document.addEventListener("mouseout", (e) => {
+      const anchor = e.target.closest("[data-tooltip]");
+      if (!anchor) return;
+      if (!anchor.contains(e.relatedTarget)) hide();
+    });
+  }
+
+  return { init, show, hide };
+})();

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

@@ -424,6 +424,12 @@ WS.onEvent(ev => {
   }
 });
 
+// ── Warning transformation ─────────────────────────────────────────────────
+
+function _transformRetryWarning(message) {
+  return message;
+}
+
 // ── Error rendering ────────────────────────────────────────────────────────
 
 function renderErrorEvent(ev) {

data/lib/clacky.rb

@@ -136,6 +136,7 @@ require_relative "clacky/agent"
 require_relative "clacky/server/session_registry"
 require_relative "clacky/server/web_ui_controller"
 require_relative "clacky/server/browser_manager"
+require_relative "clacky/server/backup_manager"
 require_relative "clacky/cli"
 
 # Runtime patch layer: load user/AI patches from ~/.clacky/patches/ after all

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: openclacky
 version: !ruby/object:Gem::Version
-  version: 1.2.18
+  version: 1.3.1
 platform: ruby
 authors:
 - windy
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-13 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -270,8 +269,8 @@ email:
 - yafei@dao42.com
 executables:
 - clacky
-- openclacky
 - clarky
+- openclacky
 extensions: []
 extra_rdoc_files: []
 files:
@@ -432,6 +431,7 @@ files:
 - lib/clacky/providers.rb
 - lib/clacky/proxy_config.rb
 - lib/clacky/rich_ui_controller.rb
+- lib/clacky/server/backup_manager.rb
 - lib/clacky/server/browser_manager.rb
 - lib/clacky/server/channel.rb
 - lib/clacky/server/channel/adapters/base.rb
@@ -456,7 +456,6 @@ files:
 - lib/clacky/server/channel/channel_config.rb
 - lib/clacky/server/channel/channel_manager.rb
 - lib/clacky/server/channel/channel_ui_controller.rb
-- lib/clacky/server/channel/group_message_buffer.rb
 - lib/clacky/server/channel/user_adapter_loader.rb
 - lib/clacky/server/discover.rb
 - lib/clacky/server/epipe_safe_io.rb
@@ -540,12 +539,16 @@ files:
 - lib/clacky/web/app.js
 - lib/clacky/web/apple-touch-icon-180.png
 - lib/clacky/web/auth.js
+- lib/clacky/web/backup.js
 - lib/clacky/web/billing.js
 - lib/clacky/web/brand.js
 - lib/clacky/web/channels.js
 - lib/clacky/web/creator.js
 - lib/clacky/web/datepicker.js
+- lib/clacky/web/design-sample.css
+- lib/clacky/web/design-sample.html
 - lib/clacky/web/favicon.ico
+- lib/clacky/web/favicon.svg
 - lib/clacky/web/i18n.js
 - lib/clacky/web/icon-dark.svg
 - lib/clacky/web/icon.svg
@@ -628,7 +631,6 @@ metadata:
   homepage_uri: https://github.com/clacky-ai/openclacky
   source_code_uri: https://github.com/clacky-ai/openclacky
   changelog_uri: https://github.com/clacky-ai/openclacky/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -646,8 +648,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: The most Token-efficient open-source AI Agent — BYOK, Skill-driven, IM-integrated.
 test_files: []

data/lib/clacky/server/channel/group_message_buffer.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-module Clacky
-  module Channel
-    # Stores recent group chat messages per chat_id so that when the bot is
-    # @-mentioned it can inject prior conversation context into the agent prompt.
-    # Thread-safe; bounded to MAX_MESSAGES per chat to limit memory growth.
-    class GroupMessageBuffer
-      MAX_MESSAGES = 15
-      PROMPT_LIMIT = 5
-
-      Entry = Struct.new(:user_id, :user_name, :text, keyword_init: true)
-
-      def initialize
-        @buffers = {}
-        @mutex   = Mutex.new
-      end
-
-      # @param chat_id [String]
-      # @param user_id [String]
-      # @param user_name [String, nil]
-      # @param text    [String]
-      def push(chat_id, user_id:, text:, user_name: nil)
-        return if text.nil? || text.strip.empty?
-
-        @mutex.synchronize do
-          buf = (@buffers[chat_id] ||= [])
-          buf << Entry.new(user_id: user_id, user_name: user_name, text: text.strip)
-          buf.shift if buf.size > MAX_MESSAGES
-        end
-      end
-
-      # Return the most recent `limit` entries without clearing the buffer.
-      # @param chat_id [String]
-      # @param limit [Integer, nil] max entries to return; nil = all
-      # @return [Array<Entry>]
-      def peek(chat_id, limit: nil)
-        @mutex.synchronize do
-          buf = @buffers[chat_id] || []
-          limit ? buf.last(limit) : buf.dup
-        end
-      end
-
-      # Return buffered entries for a chat and clear them atomically.
-      # Returns an empty array when there is no history.
-      # @param chat_id [String]
-      # @return [Array<Entry>]
-      def take(chat_id)
-        @mutex.synchronize { @buffers.delete(chat_id) || [] }
-      end
-    end
-  end
-end