openclacky 1.5.7 → 1.5.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c045233115364b3165e5ca43d7b45b898250996f952c2db8baacb4435404cc0
-  data.tar.gz: 3617f770edb88eaf6361bb0e6398f2ab6519f950ce234c89d0e9bce4fed4d486
+  metadata.gz: 565adf42059330fb821c57cb3b1200035fb866a1f2190ca87e093bc34de9edc0
+  data.tar.gz: 89db4dd987f39d4b77acd52121aa31bef54858f81d614557ac7b9984a1066ba0
 SHA512:
-  metadata.gz: 6e5943dfb3599650349c8e09359e3fc1467e7fa6126f78ccf4840d2d9eaa02e5c06b088dc02bbeb789d53e8ae5fc128656a6e193dd385951a627f2349222262d
-  data.tar.gz: 8565520e6fef3cf12bc8580c537b04499a0f3b6068b2ff88d495dbec51f2feb70ef2e45713d0c1d1a06af0b1e4fffbdf4e3d4a2f414649943515b83d7a7f2946
+  metadata.gz: e3bbb8988d833e3c6e6ce4cd13da64111e2ee15b400c2eb34b78bca9f51ae80525336baf923ba18cdbf85b5320d542f8050567792e7d5a437b28e2d09d29729d
+  data.tar.gz: ae508f3bdb44a35b8edd0c89ebcc53a64d3f7340214ded6c8dd47d0c757c66f5f99700f466c86278e8ee0a38ab838b8509c80ba8af2f253653f967b91f52a814

data/CHANGELOG.md

@@ -4,6 +4,77 @@ 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/),
 
+## [1.5.9] - 2026-08-14
+
+### Added
+- OrcaRouter as a named provider preset (#480 - @Marc-oss-hub)
+- DeepSeek peak/off-peak billing support
+- Unicode homoglyph-tolerant string matching in edit mode
+- Load-more pagination in extension marketplace
+- Remove-from-project action in session menu
+- Move-to-project submenu in session actions menu
+- Changelog link in version badge and upgrade popover
+- ext-studio scaffolding generates a runnable test/handler_test.rb and promotes "write tests" to its own step
+- Lucide SVG icons for cron and extension group icons
+
+### Improved
+- Skill "use" button themed with accent color
+- Reordered provider presets list
+- Replaced native confirm() with a Modal component and refreshed aside icons
+- Billing sidebar icon switched to circle-dollar-sign
+- Settings data tab renamed to backup management
+- Refined project session group indentation and hover styling
+
+### Fixed
+- Scroll to top when entering a session group sub-view
+- Zhipu AI website_url now points to the console overview page
+- WSL path translation and CRLF line-ending preservation (#454 - @shipinliang)
+- Project sessions re-render on language switch
+- Corrected arrow direction for move-in/move-out project icons
+- Attachment drafts isolated per session (#478)
+- Pinned sessions prioritized in project session lists
+- Projects.all() returns a sorted list
+- Builtin extension skills classified as system and hidden third-party ext skills from the panel
+- Feishu WebSocket TLS SNI (#479 - @ayers-ltd)
+- stop_reason mapping expanded from 3 to 8 cases (#469 - @shipinliang)
+
+### More
+- Shortened ext-developer title
+- cmdbar hover and session group indent tweaks
+
+## [1.5.8] - 2026-08-12
+
+### Added
+- Inline SVG icons (edit, clear sessions, delete) in project action menu (#474)
+- New project button in project selector popover
+- Verified badge for officially reviewed extensions in marketplace
+
+### Improved
+- Skip full session/file scan when count is under cap (#470 - @shipinliang)
+- Token estimation uses count() instead of scan().length (#471 - @shipinliang)
+- Faster server startup
+- Brand user extension UI (non-admin publish button grayed out, unverified banner hidden)
+- Sidebar my-data section icons refreshed
+- Section chevron icon size increased from 11px to 13px
+- Project sidebar hover effects, folder default hints, project icon sizing
+- Billing UI cleanup and global theme color adjustment
+- Section header font and project group spacing tweaks
+- Project menu labels updated
+- Billing disclaimer about provider billing
+
+### Fixed
+- Extension pack max zip size increased from 50 MB to 80 MB
+- New session button in project area now correctly preselects the project
+- Chat navigation popup no longer overlaps sidebar collapse button
+- Sub-model config preserved when switching modes (auto/off/custom)
+- minimax-m2.7 vision detection fixed
+- Project icon no longer reverts to default after page refresh
+- Load constant warning fixed
+
+### More
+- README cost table formatting normalized
+- Ambiguous cost phrasing clarified across READMEs (#475 - @chengoak)
+
 ## [1.5.7] - 2026-08-10
 
 ### Added

data/README.md

@@ -14,7 +14,7 @@
 
 **The most Token-efficient open-source AI Agent.**
 
-OpenClacky matches Claude Code on capability at comparable cost, and saves significantly against other open-source agents (~50% vs OpenClaw, ~3× cheaper than Hermes). 100% open source (MIT), BYOK with any OpenAI-compatible model, built on two years of Agentic R&D and harness engineering.
+OpenClacky matches Claude Code on capability at comparable cost, and saves significantly against other open-source agents (~50% vs OpenClaw, costs only ~1/3 of Hermes). 100% open source (MIT), BYOK with any OpenAI-compatible model, built on two years of Agentic R&D and harness engineering.
 
 > Website: https://www.openclacky.com/ · Backed by **MiraclePlus · ZhenFund · Sequoia China · Hillhouse Capital**
 
@@ -24,7 +24,7 @@ Same task, how much do you pay? Under comparable agent workloads, OpenClacky sav
 
 | Agent | Relative cost | Notes |
 |---|---|---|
-| **OpenClacky** | **~0.8** | 16 tools · ~100% cache hit · subagent routing |
+| **OpenClacky** | **~0.8×** | 16 tools · ~100% cache hit · subagent routing |
 | Claude Code | 1.0× (baseline) | World-class harness, closed-source subscription |
 | OpenClaw | ~1.5× | Comparable harness agent |
 | Hermes | ~3× | 52 built-in tools — schema bloat ~3–4× |
@@ -194,7 +194,7 @@ $ openclacky
 
 Set your **API Key**, **Model**, and **Base URL** (any OpenAI-compatible provider).
 
-Supported out of the box: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter** — or any custom endpoint.
+Supported out of the box: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter · OrcaRouter** — or any custom endpoint.
 
 ## Coding use case
 

data/README_CN.md

@@ -10,7 +10,7 @@
 
 **最省 Token 的开源 AI Agent。**
 
-OpenClacky 在任务能力上对齐 Claude Code，成本相当，同时相比其他开源 Agent 有显著优势（约节省 50% vs OpenClaw，约便宜 3× vs Hermes）。100% 开源（MIT），支持 BYOK 接入任意 OpenAI 兼容模型，背后是两年 Agentic 研发与 Harness 工程积累。
+OpenClacky 在任务能力上对齐 Claude Code，成本相当，同时相比其他开源 Agent 有显著优势（约节省 50% vs OpenClaw，成本约为 Hermes 的 1/3）。100% 开源（MIT），支持 BYOK 接入任意 OpenAI 兼容模型，背后是两年 Agentic 研发与 Harness 工程积累。
 
 > 官网：https://www.openclacky.com/ · 投资方：**奇绩创坛 · 真格基金 · 红杉中国 · 高瓴资本**
 
@@ -189,7 +189,7 @@ $ openclacky
 
 设置你的 **API Key**、**模型**和 **Base URL**（任意 OpenAI 兼容提供商）。
 
-开箱即支持：**Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter**，或任意自定义端点。
+开箱即支持：**Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter · OrcaRouter**，或任意自定义端点。
 
 ## 代码开发场景
 

data/README_JA.md

@@ -24,7 +24,7 @@ OpenClacky は Claude Code と同等の性能を同等のコストで実現し
 
 | エージェント | 相対コスト | 備考 |
 |---|---|---|
-| **OpenClacky** | **約 0.8** | 16 ツール · キャッシュヒット率約 100% · サブエージェントルーティング |
+| **OpenClacky** | **約 0.8×** | 16 ツール · キャッシュヒット率約 100% · サブエージェントルーティング |
 | Claude Code | 1.0×（基準） | 世界クラスのハーネス、クローズドソースのサブスクリプション |
 | OpenClaw | 約 1.5× | 同等のハーネスエージェント |
 | Hermes | 約 3× | 52 個の組み込みツール — スキーマの肥大化が約 3〜4 倍 |
@@ -194,7 +194,7 @@ $ openclacky
 
 **API Key**、**Model**、**Base URL**（任意の OpenAI 互換プロバイダー）を設定します。
 
-標準でサポート: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter** — または任意のカスタムエンドポイント。
+標準でサポート: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter · OrcaRouter** — または任意のカスタムエンドポイント。
 
 ## コーディングのユースケース
 

data/lib/clacky/agent.rb

@@ -3,7 +3,6 @@
 require "securerandom"
 require "json"
 require "cgi"
-require "tty-prompt"
 require "set"
 require_relative "null_ui_controller"
 require_relative "utils/arguments_parser"
@@ -1392,7 +1391,7 @@ module Clacky
       # plain text, inflating token counts by 20-40x.  The tool result carries a
       # plain-text description for the LLM; the actual image is delivered here.
       vision_supported = @config.current_model_supports?(:vision)
-      ocr_entry = vision_supported ? nil : @config.find_model_by_type("ocr")
+      ocr_entry = vision_supported ? nil : @config.effective_ocr_entry
 
       tool_results.each do |tr|
         inject = tr[:image_inject]
@@ -1959,7 +1958,7 @@ module Clacky
       # OCR sidecar — only consulted when the primary doesn't see images.
       # When the sidecar entry has "primary"=>true, the primary itself can see,
       # so vision_supported was already true and we never enter the OCR branch.
-      ocr_entry = vision_supported ? nil : @config.find_model_by_type("ocr")
+      ocr_entry = vision_supported ? nil : @config.effective_ocr_entry
 
       vision_images = []  # Array of { url:, name:, size_bytes:, path: }
       downgraded    = []

data/lib/clacky/agent_config.rb

@@ -633,16 +633,10 @@ module Clacky
       }.compact
     end
 
-    # Find model by type (default or lite or media kind or ocr sidecar)
-    # Returns the model hash or nil if not found.
-    # For media kinds (image/video/audio): explicit user-configured (custom)
-    # entries win; otherwise an auto-derived virtual entry is returned
-    # based on the default model's provider — mirroring how lite is
-    # virtually derived via #lite_model_config_for_current.
-    # For "ocr": same custom→auto→nil pattern. Auto path first checks
-    # whether the default model itself supports vision (zero-overhead path,
-    # no sidecar needed); if not, derives from the provider's
-    # default_ocr_model.
+    # Raw accessor - returns the stored model entry without mode-aware filtering.
+    # For media/ocr: does NOT check mode field, only legacy disabled flag.
+    # Mode-aware callers should use #effective_media_entry / #effective_ocr_entry.
+    # HTTP server uses this to read raw entries for saved_custom / api_key masking.
     def find_model_by_type(type)
       kind = type.to_s
       if Clacky::Providers::MEDIA_KINDS.include?(kind)
@@ -701,6 +695,38 @@ module Clacky
       @models.reject! { |m| m["auto_injected"] && Clacky::Providers::MEDIA_KINDS.include?(m["type"].to_s) }
     end
 
+    private def sidecar_off?(entry)
+      entry && (entry["disabled"] || entry["mode"] == "off")
+    end
+
+    private def sidecar_custom?(entry)
+      entry &&
+        entry["base_url"].to_s.strip != "" &&
+        entry["api_key"].to_s.strip != "" &&
+        entry["mode"] != "auto"
+    end
+
+    def effective_media_entry(kind)
+      kind = kind.to_s
+      raw_entry = @models.find { |m| m["type"] == kind }
+      return nil if sidecar_off?(raw_entry)
+
+      is_custom = sidecar_custom?(raw_entry)
+      override_model = raw_entry && !is_custom ? raw_entry["model"] : nil
+
+      is_custom ? raw_entry : derive_media_model(kind, model_override: override_model)
+    end
+
+    def effective_ocr_entry
+      raw_entry = @models.find { |m| m["type"] == "ocr" }
+      return nil if sidecar_off?(raw_entry)
+
+      is_custom = sidecar_custom?(raw_entry)
+      override_model = raw_entry && !is_custom ? raw_entry["model"] : nil
+
+      is_custom ? raw_entry : derive_ocr_model(model_override: override_model)
+    end
+
     # Derive an OCR sidecar model entry from the default model's provider.
     # Resolution order:
     #   1. If the default model itself supports vision → return the default
@@ -763,7 +789,7 @@ module Clacky
       kind = kind.to_s
       raw_entry = @models.find { |m| m["type"] == kind }
 
-      if raw_entry && raw_entry["disabled"]
+      if sidecar_off?(raw_entry)
         default = find_model_by_type("default")
         default_provider = default && Clacky::Providers.resolve_provider(
           base_url: default["base_url"], api_key: default["api_key"]
@@ -782,9 +808,7 @@ module Clacky
         }
       end
 
-      is_custom = raw_entry &&
-                  raw_entry["base_url"].to_s.strip != "" &&
-                  raw_entry["api_key"].to_s.strip != ""
+      is_custom = sidecar_custom?(raw_entry)
       override_model = raw_entry && !is_custom ? raw_entry["model"] : nil
 
       entry = if is_custom
@@ -842,7 +866,7 @@ module Clacky
       )
       available = default_provider ? Clacky::Providers.ocr_models(default_provider) : []
 
-      if raw_entry && raw_entry["disabled"]
+      if sidecar_off?(raw_entry)
         # A disabled OCR sidecar only means "no separate vision model"; it must
         # not override the fact that the chat model may handle images itself.
         anchor = current_model || default
@@ -872,9 +896,7 @@ module Clacky
         }
       end
 
-      is_custom = raw_entry &&
-                  raw_entry["base_url"].to_s.strip != "" &&
-                  raw_entry["api_key"].to_s.strip != ""
+      is_custom = sidecar_custom?(raw_entry)
       override_model = raw_entry && !is_custom ? raw_entry["model"] : nil
 
       entry = if is_custom

data/lib/clacky/brand_config.rb

@@ -777,21 +777,26 @@ module Clacky
     end
 
     # Search the public extension marketplace. Anonymous — no license required.
-    # Uses GET /api/v1/extensions. Returns { success:, extensions: [], error: }.
-    def search_extensions!(query: nil, sort: nil)
+    # Uses GET /api/v1/extensions. Returns { success:, extensions: [], meta:, error: }.
+    # `meta` carries the platform's pagination info ({ current_page, total_pages,
+    # total_count, per_page }) when available.
+    def search_extensions!(query: nil, sort: nil, page: nil, per_page: nil)
       params = {}
-      params["q"]    = query if query && !query.to_s.strip.empty?
-      params["sort"] = sort  if sort && !sort.to_s.strip.empty?
+      params["q"]        = query    if query && !query.to_s.strip.empty?
+      params["sort"]     = sort     if sort && !sort.to_s.strip.empty?
+      params["page"]     = page     if page && page.to_i > 1
+      params["per_page"] = per_page if per_page && per_page.to_i > 0
       qs   = params.empty? ? "" : "?#{URI.encode_www_form(params)}"
       response = platform_client.get("/api/v1/extensions#{qs}")
 
       if response[:success]
-        { success: true, extensions: response[:data]["extensions"] || [] }
+        data = response[:data] || {}
+        { success: true, extensions: data["extensions"] || [], meta: data["meta"] }
       else
-        { success: false, error: response[:error] || "Search failed", extensions: [] }
+        { success: false, error: response[:error] || "Search failed", extensions: [], meta: nil }
       end
     rescue StandardError => e
-      { success: false, error: "Network error: #{e.message}", extensions: [] }
+      { success: false, error: "Network error: #{e.message}", extensions: [], meta: nil }
     end
 
     # Fetch a single public marketplace extension's detail (contributes +

data/lib/clacky/cli.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "thor"
-require "tty-prompt"
 require "fileutils"
 require_relative "ui2"
 require_relative "json_ui_controller"

data/lib/clacky/default_extensions/ext-studio/ext.yml

@@ -17,7 +17,7 @@ contributes:
       order: 210
   agents:
     - id: ext-developer
-      title: Extension Developer
+      title: Ext Developer
       title_zh: 扩展开发
       description: AI expert that helps you build custom AI agent workflows
       description_zh: 帮你开发自定义 AI Agent 工作流的专家

data/lib/clacky/default_extensions/ext-studio/panels/studio/view.js

@@ -148,6 +148,7 @@
       "extlist.unpublish.confirm": "Unpublish {{id}} from the marketplace?",
       "extlist.publishing": "Publishing…",
       "extlist.needLicense": "Publishing requires an activated user license.",
+      "extlist.brandLocked": "Publishing to the marketplace requires a creator license.",
       "extlist.newExt.label": "Create a new extension",
       "extlist.newExt.hint": "Opens an AI session that scaffolds and builds it for you.",
       "extlist.newExt.btn": "Create New Extension",
@@ -338,6 +339,7 @@
       "extlist.unpublish.confirm": "确定要从市场下架 {{id}} 吗？",
       "extlist.publishing": "发布中…",
       "extlist.needLicense": "发布需要已激活的用户授权。",
+      "extlist.brandLocked": "发布到市场需要创作者权限。",
       "extlist.newExt.label": "创建新扩展",
       "extlist.newExt.hint": "打开一个 AI 会话，帮你生成并开发它。",
       "extlist.newExt.btn": "创建新扩展",
@@ -1370,7 +1372,7 @@
           const unpubBtn = el("button", { class: "studio-btn studio-btn-danger studio-btn-sm", text: t("btn.unpublish") });
           unpubBtn.style.marginLeft = "auto";
           unpubBtn.addEventListener("click", async () => {
-            if (!window.confirm(t("published.confirm", { id: e.id }))) return;
+            if (!await Clacky.Modal.confirm(t("published.confirm", { id: e.id }))) return;
             unpubBtn.disabled = true;
             try { await postJson("/unpublish", { ext_id: e.id }); loadPublished(); }
             catch (err) { unpubBtn.disabled = false; feedback(t("err.generic", { msg: err.message }), "error"); }
@@ -1406,11 +1408,16 @@
       ));
 
       const bar = el("div", { class: "studio-actions" });
-      bar.appendChild(el("button", { class: "studio-btn studio-btn-primary studio-publish-btn", text: t("btn.publish"), onclick: doPublish }));
+      const brandNonAdmin = typeof Brand !== "undefined" && Brand.branded && !Brand.userLicensed;
+      const pubBtn = el("button", { class: "studio-btn studio-btn-primary studio-publish-btn", text: t("btn.publish"), onclick: doPublish });
+      pubBtn.disabled = brandNonAdmin;
+      if (brandNonAdmin) pubBtn.setAttribute("data-tooltip", t("extlist.brandLocked"));
+      bar.appendChild(pubBtn);
       if (typeof Brand !== "undefined" && Brand.userLicensed) {
         bar.appendChild(el("button", { class: "studio-btn studio-publish-brand-btn", text: t("btn.publishBrand"), onclick: doPublishBrand }));
       }
-      bar.appendChild(el("button", { class: "studio-btn studio-btn-ghost studio-pack-btn", text: t("btn.pack"), onclick: doPack }));
+      const packBtn = el("button", { class: "studio-btn studio-btn-ghost studio-pack-btn", text: t("btn.pack"), onclick: doPack });
+      bar.appendChild(packBtn);
       container.appendChild(bar);
 
       container.appendChild(el("div", { class: "studio-feedback" }));
@@ -1518,7 +1525,7 @@
       actions.appendChild(el("button", { class: "studio-btn studio-btn-primary", text: t("extlist.btn.iterate"), onclick: () => createExtension(t("extlist.iterate.seed", { id: ext.id })) }));
       const un = el("button", { class: "studio-btn studio-btn-ghost", text: t("extlist.btn.unpublish") });
       un.addEventListener("click", async () => {
-        if (!window.confirm(t("extlist.unpublish.confirm", { id: ext.id }))) return;
+        if (!await Clacky.Modal.confirm(t("extlist.unpublish.confirm", { id: ext.id }))) return;
         un.disabled = true;
         try { await postJson("/unpublish", { ext_id: ext.id }); await reload(); rebuild(); }
         catch (e) { un.disabled = false; alert(t("err.generic", { msg: e.message })); }
@@ -1548,9 +1555,11 @@
       card.appendChild(meta);
 
       const actions = el("div", { class: "studio-actions" });
+      const brandNonAdmin = typeof Brand !== "undefined" && Brand.branded && !Brand.userLicensed;
       const pub = el("button", { class: "studio-btn studio-btn-primary", text: published ? t("extlist.btn.update") : t("extlist.btn.publish") });
-      pub.disabled = !!ext.error_count;
-      pub.title = ext.error_count ? t("extlist.verify.errors", { n: ext.error_count }) : "";
+      pub.disabled = !!ext.error_count || brandNonAdmin;
+      const pubTip = ext.error_count ? t("extlist.verify.errors", { n: ext.error_count }) : (brandNonAdmin ? t("extlist.brandLocked") : "");
+      if (pubTip) pub.setAttribute("data-tooltip", pubTip);
       pub.addEventListener("click", () => doPublish(ext, cloudEntry ? cloudEntry.version : null));
       actions.appendChild(pub);
 
@@ -1558,7 +1567,7 @@
         const brandEntry = brandCloud.find((c) => c.id === ext.id);
         const brandPub = el("button", { class: "studio-btn", text: t("extlist.btn.publishBrand") });
         brandPub.disabled = !!ext.error_count;
-        brandPub.title = ext.error_count ? t("extlist.verify.errors", { n: ext.error_count }) : "";
+        if (ext.error_count) brandPub.setAttribute("data-tooltip", t("extlist.verify.errors", { n: ext.error_count }));
         brandPub.addEventListener("click", () => doPublish(ext, brandEntry ? brandEntry.version : null, "self"));
         actions.appendChild(brandPub);
       }
@@ -1590,7 +1599,7 @@
     }
 
     async function doDelete(ext, btn) {
-      if (!confirm(t("extlist.delete.confirm", { id: ext.id }))) return;
+      if (!await Clacky.Modal.confirm(t("extlist.delete.confirm", { id: ext.id }))) return;
       btn.disabled = true;
       try {
         const res = await fetch("/api/ext/ext-studio/local", {
@@ -1635,11 +1644,15 @@
 
       if (headerActions) {
         headerActions.innerHTML = "";
-        headerActions.appendChild(el("button", {
+        const brandNonAdmin = typeof Brand !== "undefined" && Brand.branded && !Brand.userLicensed;
+        const newBtn = el("button", {
           class: "studio-btn studio-btn-primary",
           text: t("extlist.newExt.btn"),
           onclick: () => createExtension(t("extlist.newExt.seed")),
-        }));
+        });
+        newBtn.disabled = brandNonAdmin;
+        if (brandNonAdmin) newBtn.setAttribute("data-tooltip", t("extlist.brandLocked"));
+        headerActions.appendChild(newBtn);
       }
 
       container.appendChild(section("extlist.section.cloud", "extlist.section.cloudHint", cloud, cloudCard, "extlist.cloud.empty"));
@@ -1711,7 +1724,7 @@
       if (skill.local_present && skill.has_local_changes) {
         const btn = el("button", { class: "studio-btn studio-btn-primary", text: t("skills.btn.update") });
         btn.disabled = locked;
-        btn.title = locked ? t("skills.locked") : "";
+        if (locked) btn.setAttribute("data-tooltip", t("skills.locked"));
         btn.addEventListener("click", () => doPublish(skill.name, btn, true));
         actions.appendChild(btn);
       } else if (skill.local_present) {
@@ -1738,7 +1751,7 @@
       const actions = el("div", { class: "studio-actions" });
       const btn = el("button", { class: "studio-btn studio-btn-primary", text: t("skills.btn.publish") });
       btn.disabled = locked;
-      btn.title = locked ? t("skills.locked") : "";
+      if (locked) btn.setAttribute("data-tooltip", t("skills.locked"));
       btn.addEventListener("click", () => doPublish(skill.name, btn, false));
       actions.appendChild(btn);
       card.appendChild(actions);
@@ -1753,7 +1766,7 @@
       try {
         let result = await publish(name, isUpdate);
         if (!result.ok && result.already_exists && !isUpdate) {
-          if (window.confirm(`"${name}" already exists on the platform. Overwrite?`)) {
+          if (await Clacky.Modal.confirm(`"${name}" already exists on the platform. Overwrite?`)) {
             result = await publish(name, true);
           } else {
             btn.disabled = false;
@@ -1798,7 +1811,7 @@
           onclick: () => createSkill(null),
         });
         newBtn.disabled = locked;
-        newBtn.title = locked ? t("skills.locked") : "";
+        if (locked) newBtn.setAttribute("data-tooltip", t("skills.locked"));
         headerActions.appendChild(newBtn);
       }
 

data/lib/clacky/default_extensions/ext-studio/skills/ext-develop/SKILL.md

@@ -280,14 +280,15 @@ This creates `~/.clacky/ext/local/<id>/` with a working hello panel + handler:
 - `ext.yml` — the manifest
 - `panels/hello/view.js` — a panel that pings the backend
 - `api/handler.rb` — a `Clacky::ApiExtension` subclass mounted at `/api/ext/<id>/`
+- `test/handler_test.rb` — a runnable minitest example (`ruby test/handler_test.rb`)
 
 Use `--full` only when the user needs the kitchen-sink reference exercising all seven
 contributes types — it's a lot to read, so prefer the plain scaffold otherwise.
 
 ### 3 — Read what was generated
 
-Always read the generated `ext.yml`, `view.js`, and `handler.rb` before editing. This
-is your starting point; you'll reshape it to match the idea.
+Always read the generated `ext.yml`, `view.js`, `handler.rb`, and `test/handler_test.rb`
+before editing. This is your starting point; you'll reshape it to match the idea.
 
 ### 4 — Reshape to the idea
 
@@ -366,7 +367,22 @@ Rules while reshaping:
   reference `panels: [id]` and `skills: [id]`. Add those blocks to `ext.yml` only if the
   idea needs them.
 
-### 5 — Confirm it loads
+### 5 — Write tests
+
+Test the backend before you call it done. Rewrite the scaffolded `test/handler_test.rb`
+to exercise your real routes (parse the JSON response, assert its fields), then run it
+green:
+
+```
+ruby test/handler_test.rb
+```
+
+- If `test/` is missing from the scaffold, create `test/handler_test.rb` yourself
+  (`mkdir -p test` then write it) — do NOT skip tests just because the file is absent.
+- A handler that only returns a static string may keep the scaffold's hello test;
+  anything that fetches, transforms, caches, or computes MUST have a real test.
+
+### 6 — Confirm it loads
 
 Run `clacky ext verify` and confirm the new units resolve with no errors, then have the
 user reload the WebUI page. If verify reports problems, go to **Debug & verify**.
@@ -423,8 +439,9 @@ smallest change, re-run verify, repeat until clean — fix ONE issue at a time.
 - **`schema.unknown_contributes`** → a top-level key under `contributes:` is misspelled.
   **Do:** fix the spelling to one of `panels api skills agents channels patches hooks`.
 - **`schema.unknown_key`** → an unknown **top-level** key in `ext.yml`. **Do:** fix the
-  spelling. Allowed top-level keys: `id name title description version origin author
-  homepage license public license_required keywords contributes`.
+  spelling. Allowed top-level keys: `id name name_zh display_name display_name_zh title
+  description description_zh emoji version origin author homepage license public
+  license_required keywords contributes`.
 - **`schema.unknown_field`** → a unit has a field not allowed for its type. **Do:** delete
   or rename that field. Allowed fields per type (this is the authoritative list — do not
   invent others):

data/lib/clacky/default_extensions/general/ext.yml

@@ -15,4 +15,4 @@ contributes:
       order: 1
       prompt: agents/general/system_prompt.md
       avatar: agents/general/avatar.png
-      panels: [meeting/meeting]
+      panels: []

data/lib/clacky/extension/api_loader.rb

@@ -65,17 +65,10 @@ module Clacky
         existing = reload ? Clacky::ApiExtension.registry[ext_id] : nil
         existing&.reset_routes!
 
-        if reload
-          old_verbose = $VERBOSE
-          $VERBOSE = nil
-          begin
-            load(handler_path)
-          ensure
-            $VERBOSE = old_verbose
-          end
-        else
-          require(handler_path)
-        end
+        # Wrapped load: each handler gets a fresh anonymous module, so two exts
+        # defining the same top-level class/constant names cannot clobber each
+        # other (and the `inherited` hook fires even on repeat loads).
+        load(handler_path, true)
 
         new_subclasses = Clacky::ApiExtension.pending_subclasses[before..] || []
         klass = new_subclasses.last || existing

data/lib/clacky/extension/packager.rb

@@ -16,7 +16,7 @@ module Clacky
   # optional URL fetch in `install`.
   module ExtensionPackager
     MANIFEST     = "ext.yml"
-    MAX_ZIP_SIZE = 50 * 1024 * 1024
+    MAX_ZIP_SIZE = 80 * 1024 * 1024
 
     # Network timeouts for the download step. `read_timeout` is an *idle*
     # timeout (resets on every chunk received), so a stalled connection with

data/lib/clacky/extension/scaffold/templates/hello/test/handler_test.rb.erb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Run from the container root:
+#   ruby test/handler_test.rb
+require "minitest/autorun"
+require "clacky"
+require "json"
+
+load File.expand_path("../api/handler.rb", __dir__)
+
+class <%= const_prefix %>ExtTest < Minitest::Test
+  def test_root_route_returns_json
+    route = <%= const_prefix %>Ext.routes.find { |r| r.method == :get && r.pattern == "/" }
+    refute_nil route, "expected a GET / route"
+
+    handler = <%= const_prefix %>Ext.new(req: nil, res: nil, route: route, params: {}, http_server: nil)
+    halt = assert_raises(Clacky::ApiExtension::Halt) { handler.invoke }
+
+    assert_equal 200, halt.status
+    assert_equal "hello from <%= slug %>", JSON.parse(halt.payload)["message"]
+  end
+end

data/lib/clacky/extension/verifier.rb

@@ -16,7 +16,7 @@ module Clacky
   module ExtensionVerifier
     Issue = Struct.new(:ext, :unit, :level, :code, :message, :file, :hint, keyword_init: true)
 
-    KNOWN_TOP_KEYS    = %w[id name title description version origin author homepage license public license_required keywords contributes].freeze
+    KNOWN_TOP_KEYS    = %w[id name name_zh display_name display_name_zh title description description_zh emoji version origin author homepage license public license_required keywords contributes].freeze
     KNOWN_CONTRIBUTES = %w[panels api skills agents channels patches hooks].freeze
 
     PANEL_KEYS   = %w[id title title_zh description description_zh view order attach entry_points].freeze

data/lib/clacky/media/generator.rb

@@ -49,17 +49,17 @@ module Clacky
 
       # @return [Hash, nil] the type=image model entry, or nil if not configured
       def image_model_entry
-        @agent_config.find_model_by_type("image")
+        @agent_config.effective_media_entry("image")
       end
 
       # @return [Hash, nil] the type=video model entry, or nil if not configured
       def video_model_entry
-        @agent_config.find_model_by_type("video")
+        @agent_config.effective_media_entry("video")
       end
 
       # @return [Hash, nil] the type=audio model entry, or nil if not configured
       def audio_model_entry
-        @agent_config.find_model_by_type("audio")
+        @agent_config.effective_media_entry("audio")
       end
 
       def generate_image(prompt:, aspect_ratio: "landscape", output_dir: nil, **kwargs)