openclacky 1.5.8 → 1.5.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efbdc6d887e5beea867023b733d023f236b0e0a0a813201cce3767deebe43fd2
-  data.tar.gz: 1abf4430324ddd28b1d1d6a6b82390eaa8c76dc026f31cc1c10ff7fdac6c7207
+  metadata.gz: 565adf42059330fb821c57cb3b1200035fb866a1f2190ca87e093bc34de9edc0
+  data.tar.gz: 89db4dd987f39d4b77acd52121aa31bef54858f81d614557ac7b9984a1066ba0
 SHA512:
-  metadata.gz: 6df9bcdd91aa229039baad046a06d471ae11367e78a594f655abffd808c3f9b14507f9fca32d99c4f3fbd13a3ab2743451826238bc8e55e9ddc0161546276bae
-  data.tar.gz: 53b8fd83915c5ee898237dc113099a7ea0e339961dac83b11d4b16285a1f2fb3b4581d1876f70c2a78608556b22760da3ba8fff7146af0b66c701d12e963005b
+  metadata.gz: e3bbb8988d833e3c6e6ce4cd13da64111e2ee15b400c2eb34b78bca9f51ae80525336baf923ba18cdbf85b5320d542f8050567792e7d5a437b28e2d09d29729d
+  data.tar.gz: ae508f3bdb44a35b8edd0c89ebcc53a64d3f7340214ded6c8dd47d0c757c66f5f99700f466c86278e8ee0a38ab838b8509c80ba8af2f253653f967b91f52a814

data/CHANGELOG.md

@@ -4,6 +4,44 @@ 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

data/README.md

@@ -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

@@ -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

@@ -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/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/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

@@ -1372,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"); }
@@ -1525,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 })); }
@@ -1599,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", {
@@ -1766,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;

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**.

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/message_format/anthropic.rb

@@ -181,10 +181,27 @@ module Clacky
           { id: tc["id"], type: "function", name: tc["name"], arguments: args }
         end
 
+        # Map Anthropic stop_reason → OpenAI-style finish_reason so downstream
+        # (llm_caller empty-response detector, agent loop, CostTracker) stays
+        # provider-agnostic. Each cluster shares the same semantic class:
+        #   stop     — natural end of turn (end_turn / pause_turn / stop_sequence)
+        #   length   — token or context-window limit hit (max_tokens /
+        #              model_context_window_exceeded; mapping the latter to
+        #              "length" also prevents a futile retry in llm_caller's
+        #              empty-response detector, which exempts "length")
+        #   content_filter — model declined (refusal)
+        #   other    — context compaction (compaction)
+        # Note: `compaction` is a real stop_reason but only emitted under the
+        # `compact-2026-01-12` beta header (server-side context compaction),
+        # so it is not yet in the stable SDK's StopReason literal list.
+        # See: https://platform.claude.com/docs/en/build-with-claude/compaction
+        # Unmapped values fall through unchanged.
         finish_reason = case data["stop_reason"]
-                        when "end_turn"   then "stop"
+                        when "end_turn", "pause_turn", "stop_sequence" then "stop"
                         when "tool_use"   then "tool_calls"
-                        when "max_tokens" then "length"
+                        when "max_tokens", "model_context_window_exceeded" then "length"
+                        when "refusal"    then "content_filter"
+                        when "compaction" then "other"
                         else data["stop_reason"]
                         end
 

data/lib/clacky/message_format/bedrock.rb

@@ -118,11 +118,16 @@ module Clacky
           { id: tc["toolUseId"], type: "function", name: tc["name"], arguments: args }
         end
 
-        # Map Bedrock stopReason → canonical finish_reason
+        # Map Bedrock stopReason → canonical finish_reason (same clusters as
+        # the Anthropic direct adapter — see lib/clacky/message_format/anthropic.rb).
         finish_reason = case data["stopReason"]
-                        when "end_turn"   then "stop"
+                        when "end_turn", "pause_turn", "stop_sequence" then "stop"
                         when "tool_use"   then "tool_calls"
-                        when "max_tokens" then "length"
+                        when "max_tokens", "model_context_window_exceeded" then "length"
+                        when "refusal"    then "content_filter"
+                        # `compaction` is a beta stop_reason (compact-2026-01-12);
+                        # see anthropic.rb for the full note.
+                        when "compaction" then "other"
                         else data["stopReason"]
                         end
 

data/lib/clacky/providers.rb

@@ -253,32 +253,34 @@ module Clacky
         "website_url" => "https://platform.deepseek.com/api_keys"
       }.freeze,
 
-      "minimax" => {
-        "name" => "Minimax",
-        "base_url" => "https://api.minimaxi.com/v1",
+      "glm" => {
+        "name" => "GLM (Z.ai / Zhipu)",
+        "base_url" => "https://open.bigmodel.cn/api/paas/v4",
         "api" => "openai-completions",
-        "default_model" => "MiniMax-M3",
-        "models" => ["MiniMax-M3", "MiniMax-M2.7", "MiniMax-M2.5"],
-        # MiniMax operates two regional endpoints with identical APIs & model
-        # lineup — mainland China (.com) and international (.io). Listing both
-        # lets find_by_base_url identify either one as provider "minimax",
-        # so capability checks (vision=false) fire correctly regardless of
-        # which endpoint the user configured.
+        "default_model" => "glm-5.2",
+        "models" => ["glm-5.2", "glm-5.1", "glm-5", "glm-5-turbo", "glm-5v-turbo", "glm-4.7"],
+        # Zhipu / Z.ai expose four functionally-equivalent endpoints:
+        # two regional sites (mainland open.bigmodel.cn + international api.z.ai)
+        # each with a general-billing and a Coding-Plan subpath. They share the
+        # same model lineup & identical capability profile, so a single preset
+        # with endpoint_variants is the right shape — one source of truth for
+        # vision/model_capabilities, four URLs recognised by find_by_base_url.
+        # Without this, users pointing at api.z.ai or the /coding/ path fell
+        # through to the conservative "assume vision=true" default and got
+        # hallucinated image descriptions on text-only GLM models (C-5563).
         "endpoint_variants" => [
-          { "label" => "Mainland China", "label_key" => "settings.models.baseurl.variant.mainland_cn",   "base_url" => "https://api.minimaxi.com/v1", "region" => "cn"   }.freeze,
-          { "label" => "International",  "label_key" => "settings.models.baseurl.variant.international", "base_url" => "https://api.minimax.io/v1",   "region" => "intl" }.freeze
+          { "label" => "Mainland · Pay-as-you-go",      "label_key" => "settings.models.baseurl.variant.mainland_cn_payg",    "base_url" => "https://open.bigmodel.cn/api/paas/v4",        "region" => "cn"   }.freeze,
+          { "label" => "Mainland · Coding Plan",        "label_key" => "settings.models.baseurl.variant.mainland_cn_coding",  "base_url" => "https://open.bigmodel.cn/api/coding/paas/v4", "region" => "cn"   }.freeze,
+          { "label" => "International · Pay-as-you-go", "label_key" => "settings.models.baseurl.variant.international_payg",  "base_url" => "https://api.z.ai/api/paas/v4",                "region" => "intl" }.freeze,
+          { "label" => "International · Coding Plan",   "label_key" => "settings.models.baseurl.variant.international_coding","base_url" => "https://api.z.ai/api/coding/paas/v4",         "region" => "intl" }.freeze
         ].freeze,
-        # MiniMax M2.5/M2.7 are text-only on this endpoint. M3 (released 2026-06-01)
-        # is natively multimodal — it accepts image input via OpenAI-style
-        # image_url content parts — so it overrides the provider-level
-        # vision=false below. M3 exposes a 1,000,000-token context window
-        # (M2.7: 204,800; M2.5: 40,960).
+        # GLM models are text-only except glm-5v-turbo which is vision-capable ("v" = visual).
         "capabilities" => { "vision" => false }.freeze,
         "model_capabilities" => {
-          "MiniMax-M3" => { "vision" => true }.freeze
+          "glm-5v-turbo" => { "vision" => true }.freeze
         }.freeze,
-        "default_ocr_model" => "MiniMax-M3",
-        "website_url" => "https://platform.minimax.io/"
+        "default_ocr_model" => "glm-5v-turbo",
+        "website_url" => "https://open.bigmodel.cn/console/overview"
       }.freeze,
 
       "kimi" => {
@@ -346,6 +348,34 @@ module Clacky
         "website_url" => "https://www.kimi.com/code"
       }.freeze,
 
+      "minimax" => {
+        "name" => "Minimax",
+        "base_url" => "https://api.minimaxi.com/v1",
+        "api" => "openai-completions",
+        "default_model" => "MiniMax-M3",
+        "models" => ["MiniMax-M3", "MiniMax-M2.7", "MiniMax-M2.5"],
+        # MiniMax operates two regional endpoints with identical APIs & model
+        # lineup — mainland China (.com) and international (.io). Listing both
+        # lets find_by_base_url identify either one as provider "minimax",
+        # so capability checks (vision=false) fire correctly regardless of
+        # which endpoint the user configured.
+        "endpoint_variants" => [
+          { "label" => "Mainland China", "label_key" => "settings.models.baseurl.variant.mainland_cn",   "base_url" => "https://api.minimaxi.com/v1", "region" => "cn"   }.freeze,
+          { "label" => "International",  "label_key" => "settings.models.baseurl.variant.international", "base_url" => "https://api.minimax.io/v1",   "region" => "intl" }.freeze
+        ].freeze,
+        # MiniMax M2.5/M2.7 are text-only on this endpoint. M3 (released 2026-06-01)
+        # is natively multimodal — it accepts image input via OpenAI-style
+        # image_url content parts — so it overrides the provider-level
+        # vision=false below. M3 exposes a 1,000,000-token context window
+        # (M2.7: 204,800; M2.5: 40,960).
+        "capabilities" => { "vision" => false }.freeze,
+        "model_capabilities" => {
+          "MiniMax-M3" => { "vision" => true }.freeze
+        }.freeze,
+        "default_ocr_model" => "MiniMax-M3",
+        "website_url" => "https://platform.minimax.io/"
+      }.freeze,
+
       "anthropic" => {
         "name" => "Anthropic (Claude)",
         "base_url" => "https://api.anthropic.com",
@@ -356,6 +386,70 @@ module Clacky
         "website_url" => "https://console.anthropic.com/settings/keys"
       }.freeze,
 
+      "openai" => {
+        "name" => "OpenAI (GPT)",
+        "base_url" => "https://api.openai.com/v1",
+        "api" => "openai-completions",
+        "default_model" => "gpt-5.5",
+        "models" => [
+          "gpt-5.5",
+          "gpt-5.4",
+          "gpt-5.4-mini",
+          "gpt-5.4-nano",
+          "o4-mini",
+          "o3"
+        ],
+        # GPT-5.x and o-series models are multimodal (text + image input).
+        "capabilities" => { "vision" => true }.freeze,
+        # Per-primary lite pairing: subagents use mini/nano for cheap/fast work.
+        # o4-mini and o3 are reasoning models without a lite-tier sibling here.
+        "lite_models" => {
+          "gpt-5.5" => "gpt-5.4-mini",
+          "gpt-5.4" => "gpt-5.4-mini"
+        },
+        # OpenAI's image generation model — same /v1/images/generations
+        # endpoint, so the OpenAICompat image provider handles it.
+        "image_models" => [
+          "gpt-image-2"
+        ],
+        "default_image_model" => "gpt-image-2",
+        "default_ocr_model" => "gpt-5.4-mini",
+        "website_url" => "https://platform.openai.com/api-keys"
+      }.freeze,
+
+      "qwen" => {
+        "name" => "Qwen (Alibaba)",
+        "base_url" => "https://dashscope.aliyuncs.com/compatible-mode/v1",
+        "api" => "openai-completions",
+        "default_model" => "qwen3.7-max",
+        "models" => [
+          "qwen3.7-max",
+          "qwen3.6-plus",
+          "qwen3.6-max",
+          "qwen3.6-27b",
+          "qwen3.6-flash",
+          "qwen-plus-latest",
+        ],
+        "endpoint_variants" => [
+          { "label" => "Mainland China",  "label_key" => "settings.models.baseurl.variant.mainland_cn",   "base_url" => "https://dashscope.aliyuncs.com/compatible-mode/v1",     "region" => "cn"   }.freeze,
+          { "label" => "Singapore",       "label_key" => "settings.models.baseurl.variant.international", "base_url" => "https://dashscope-intl.aliyuncs.com/compatible-mode/v1", "region" => "intl" }.freeze,
+          { "label" => "US (Virginia)",   "label_key" => "settings.models.baseurl.variant.us",            "base_url" => "https://dashscope-us.aliyuncs.com/compatible-mode/v1",   "region" => "us"   }.freeze
+        ].freeze,
+        "capabilities" => { "vision" => true }.freeze,
+        "model_capabilities" => {
+          "qwen3.7-max" => { "vision" => false }.freeze
+        }.freeze,
+        "default_ocr_model" => "qwen3.6-flash",
+        "lite_models" => {
+          "qwen3.7-max"      => "qwen3.6-flash",
+          "qwen3.6-plus"     => "qwen3.6-flash",
+          "qwen3.6-max"      => "qwen3.6-flash",
+          "qwen3.6-27b"      => "qwen3.6-flash",
+          "qwen-plus-latest" => "qwen3.6-flash"
+        },
+        "website_url" => "https://bailian.console.aliyun.com/?apiKey=1"
+      }.freeze,
+
       "mimo" => {
         "name" => "MiMo (Xiaomi)",
         "base_url" => "https://api.xiaomimimo.com/v1",
@@ -388,36 +482,6 @@ module Clacky
         "website_url" => "https://platform.xiaomimimo.com/"
       }.freeze,
 
-      "glm" => {
-        "name" => "GLM (Z.ai / Zhipu)",
-        "base_url" => "https://open.bigmodel.cn/api/paas/v4",
-        "api" => "openai-completions",
-        "default_model" => "glm-5.2",
-        "models" => ["glm-5.2", "glm-5.1", "glm-5", "glm-5-turbo", "glm-5v-turbo", "glm-4.7"],
-        # Zhipu / Z.ai expose four functionally-equivalent endpoints:
-        # two regional sites (mainland open.bigmodel.cn + international api.z.ai)
-        # each with a general-billing and a Coding-Plan subpath. They share the
-        # same model lineup & identical capability profile, so a single preset
-        # with endpoint_variants is the right shape — one source of truth for
-        # vision/model_capabilities, four URLs recognised by find_by_base_url.
-        # Without this, users pointing at api.z.ai or the /coding/ path fell
-        # through to the conservative "assume vision=true" default and got
-        # hallucinated image descriptions on text-only GLM models (C-5563).
-        "endpoint_variants" => [
-          { "label" => "Mainland · Pay-as-you-go",      "label_key" => "settings.models.baseurl.variant.mainland_cn_payg",    "base_url" => "https://open.bigmodel.cn/api/paas/v4",        "region" => "cn"   }.freeze,
-          { "label" => "Mainland · Coding Plan",        "label_key" => "settings.models.baseurl.variant.mainland_cn_coding",  "base_url" => "https://open.bigmodel.cn/api/coding/paas/v4", "region" => "cn"   }.freeze,
-          { "label" => "International · Pay-as-you-go", "label_key" => "settings.models.baseurl.variant.international_payg",  "base_url" => "https://api.z.ai/api/paas/v4",                "region" => "intl" }.freeze,
-          { "label" => "International · Coding Plan",   "label_key" => "settings.models.baseurl.variant.international_coding","base_url" => "https://api.z.ai/api/coding/paas/v4",         "region" => "intl" }.freeze
-        ].freeze,
-        # GLM models are text-only except glm-5v-turbo which is vision-capable ("v" = visual).
-        "capabilities" => { "vision" => false }.freeze,
-        "model_capabilities" => {
-          "glm-5v-turbo" => { "vision" => true }.freeze
-        }.freeze,
-        "default_ocr_model" => "glm-5v-turbo",
-        "website_url" => "https://open.bigmodel.cn/usercenter/apikeys"
-      }.freeze,
-
       # Volcengine Ark (Doubao) — ByteDance's model platform, OpenAI-compatible.
       # Exposes three functionally-equivalent endpoints (Pay-as-you-go / Coding
       # Plan / Agent Plan) that share the same model lineup and capability
@@ -540,68 +604,57 @@ module Clacky
         "website_url" => "https://ollama.com/settings/keys"
       }.freeze,
 
-      "openai" => {
-        "name" => "OpenAI (GPT)",
-        "base_url" => "https://api.openai.com/v1",
+      "orcarouter" => {
+        "name" => "OrcaRouter",
+        "base_url" => "https://api.orcarouter.ai/v1",
         "api" => "openai-completions",
-        "default_model" => "gpt-5.5",
+        "default_model" => "openai/gpt-5.5",
+        # Curated default lineup. OrcaRouter exposes 190+ models from OpenAI,
+        # Anthropic, Google, DeepSeek, Qwen, MiniMax, Zhipu and others behind a
+        # single OpenAI-compatible endpoint. Shipping a small list of the
+        # mainstream Claude + GPT entries gives users a working dropdown out
+        # of the box; users can still type any other OrcaRouter model id
+        # manually (e.g. "orcarouter/auto" for request-level auto-routing).
         "models" => [
-          "gpt-5.5",
-          "gpt-5.4",
-          "gpt-5.4-mini",
-          "gpt-5.4-nano",
-          "o4-mini",
-          "o3"
+          "anthropic/claude-sonnet-5",
+          "anthropic/claude-opus-4.8",
+          "anthropic/claude-haiku-4.5",
+          "openai/gpt-5.5",
+          "openai/gpt-5.4",
+          "openai/gpt-5.4-mini",
+          "google/gemini-3.5-flash",
+          "deepseek/deepseek-v4-flash",
+          "z-ai/glm-5.2",
+          "orcarouter/auto"
         ],
-        # GPT-5.x and o-series models are multimodal (text + image input).
-        "capabilities" => { "vision" => true }.freeze,
-        # Per-primary lite pairing: subagents use mini/nano for cheap/fast work.
-        # o4-mini and o3 are reasoning models without a lite-tier sibling here.
+        # Per-primary lite pairing — Claude family pairs with Haiku, GPT
+        # family pairs with the mini variant. Mirrors the openrouter preset
+        # so subagents on OrcaRouter get a sensible cheap/fast sidekick.
         "lite_models" => {
-          "gpt-5.5" => "gpt-5.4-mini",
-          "gpt-5.4" => "gpt-5.4-mini"
+          "anthropic/claude-sonnet-5" => "anthropic/claude-haiku-4.5",
+          "anthropic/claude-opus-4.8" => "anthropic/claude-haiku-4.5",
+          "openai/gpt-5.5"            => "openai/gpt-5.4-mini",
+          "openai/gpt-5.4"            => "openai/gpt-5.4-mini"
         },
-        # OpenAI's image generation model — same /v1/images/generations
-        # endpoint, so the OpenAICompat image provider handles it.
-        "image_models" => [
-          "gpt-image-2"
-        ],
-        "default_image_model" => "gpt-image-2",
-        "default_ocr_model" => "gpt-5.4-mini",
-        "website_url" => "https://platform.openai.com/api-keys"
-      }.freeze,
-
-      "qwen" => {
-        "name" => "Qwen (Alibaba)",
-        "base_url" => "https://dashscope.aliyuncs.com/compatible-mode/v1",
-        "api" => "openai-completions",
-        "default_model" => "qwen3.7-max",
-        "models" => [
-          "qwen3.7-max",
-          "qwen3.6-plus",
-          "qwen3.6-max",
-          "qwen3.6-27b",
-          "qwen3.6-flash",
-          "qwen-plus-latest",
-        ],
-        "endpoint_variants" => [
-          { "label" => "Mainland China",  "label_key" => "settings.models.baseurl.variant.mainland_cn",   "base_url" => "https://dashscope.aliyuncs.com/compatible-mode/v1",     "region" => "cn"   }.freeze,
-          { "label" => "Singapore",       "label_key" => "settings.models.baseurl.variant.international", "base_url" => "https://dashscope-intl.aliyuncs.com/compatible-mode/v1", "region" => "intl" }.freeze,
-          { "label" => "US (Virginia)",   "label_key" => "settings.models.baseurl.variant.us",            "base_url" => "https://dashscope-us.aliyuncs.com/compatible-mode/v1",   "region" => "us"   }.freeze
-        ].freeze,
+        # Per-model API type overrides. OrcaRouter proxies Claude through a
+        # native Anthropic /v1/messages endpoint (https://api.orcarouter.ai/v1/messages)
+        # in addition to its OpenAI-compatible /chat/completions endpoint.
+        # Routing "anthropic/*" via the native endpoint preserves cache_control
+        # fidelity, matching what Claude Code CLI does internally (same rationale
+        # as the openrouter preset). Non-Claude models keep the OpenAI shim.
+        "model_api_overrides" => {
+          /\Aanthropic\// => "anthropic-messages"
+        }.freeze,
+        # Most models on OrcaRouter are vision-capable; DeepSeek / GLM-5.2 and
+        # the "orcarouter/auto" router are text-only.
         "capabilities" => { "vision" => true }.freeze,
         "model_capabilities" => {
-          "qwen3.7-max" => { "vision" => false }.freeze
+          "deepseek/deepseek-v4-flash" => { "vision" => false }.freeze,
+          "z-ai/glm-5.2"               => { "vision" => false }.freeze,
+          "orcarouter/auto"            => { "vision" => false }.freeze
         }.freeze,
-        "default_ocr_model" => "qwen3.6-flash",
-        "lite_models" => {
-          "qwen3.7-max"      => "qwen3.6-flash",
-          "qwen3.6-plus"     => "qwen3.6-flash",
-          "qwen3.6-max"      => "qwen3.6-flash",
-          "qwen3.6-27b"      => "qwen3.6-flash",
-          "qwen-plus-latest" => "qwen3.6-flash"
-        },
-        "website_url" => "https://bailian.console.aliyun.com/?apiKey=1"
+        "default_ocr_model" => "google/gemini-3.5-flash",
+        "website_url" => "https://www.orcarouter.ai"
       }.freeze
 
     }.freeze

data/lib/clacky/server/channel/adapters/feishu/ws_client.rb

@@ -71,6 +71,12 @@ module Clacky
               ssl_context = OpenSSL::SSL::SSLContext.new
               ssl_context.set_params(verify_mode: OpenSSL::SSL::VERIFY_PEER)
               ssl = OpenSSL::SSL::SSLSocket.new(tcp, ssl_context)
+              # Feishu/Lark WebSocket endpoints are served behind CDN edges that
+              # require SNI to select the correct certificate/backend. Some
+              # Ruby/OpenSSL combinations do not infer the hostname for manually
+              # created SSLSocket instances, which can make the peer abort the TLS
+              # handshake with `tlsv1 alert internal error`.
+              ssl.hostname = uri.host if ssl.respond_to?(:hostname=)
               ssl.sync_close = true
               ssl.connect
               ssl