openclacky 0.8.7 → 0.8.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38f9805e951dec0f87bda1b64033e0ea7f0c5c6d1c4fd2427f57dfc13aec0835
-  data.tar.gz: f6f0d08206ead392ffbbc073bb92c5b8e5b4c9f4ecf37172153c4bf46f4963e0
+  metadata.gz: 94fe2f9fd0477231e7411c762aacfecc9eb15b87f027366d7598c73e738499c0
+  data.tar.gz: 41e84ac897d4d120dec9c7d88f69b35f82779adc2963a13dd099fd686d926ec3
 SHA512:
-  metadata.gz: d7400735f1f2cbf9fa6b74e56aaa9264e881ab0618885e87b9757458b3b87bde01c5319db6d6f6833573792229c8aa635d5c09bab43cdde15e8cddfe2ce3e418
-  data.tar.gz: ef4dede49038208ff386f5b536ba4c64158e5b72f5599694f14ecf83bd3259b51be6af52bef10fbdea88fbc23f2b2b11c9316e1bdbb1f350c355a0fedeb23bd1
+  metadata.gz: 1f28d84aab760ca2c53cc0c558ec82fb3b0bebc8b2fe5279021f3d0cc5c896ebe5dda7fc8f060f7d77609bb6b6aedffa064ef1897185db01a9b6f4e022364646
+  data.tar.gz: 64b71cd3c7793201f16600b100088cd739671c9c414252dadc6a593600f15271fc79a953877e59bc2014af929888384e3640ee78e7c1227c8b72e81f919ca72c

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.8] - 2026-03-13
+
+### Added
+- **i18n system with zh/en runtime switching**: WebUI now supports Chinese and English; all UI text is served through an `I18n` module and switches instantly without a page reload
+- **Onboard language selection step**: first-time setup now opens with a language picker (中文 / English) before any configuration, so the entire onboard experience is conducted in the user's chosen language
+- **Onboard "what's your name" step**: onboard flow now asks for the user's preferred name early on and addresses them by name throughout the rest of the setup
+- **Chinese SOUL.md default**: when a user onboards in Chinese and skips the soul-setup conversation, a Chinese-language SOUL.md is written automatically so the assistant responds in Chinese by default
+
+### Fixed
+- **Onboard WS race condition**: fixed a bug where the first auto-triggered `/onboard` command was silently lost — the WebSocket `session_list` event arrived before the session view was active and redirected the UI to the welcome screen, hiding the agent's response
+
 ## [0.8.7] - 2026-03-13
 
 ### Added

data/lib/clacky/default_skills/onboard/SKILL.md

@@ -14,22 +14,72 @@ All structured input is gathered through `request_user_feedback` cards — no fr
 
 ## Steps
 
+### 0. Detect language
+
+The user's language was set during the onboarding intro screen. The skill is invoked with
+a `lang:` argument in the slash command, e.g. `/onboard lang:zh` or `/onboard lang:en`.
+
+Check the invocation message for `lang:zh` or `lang:en`:
+- If `lang:zh` is present → conduct the **entire** onboard in **Chinese**, write SOUL.md & USER.md in Chinese.
+- Otherwise (or if missing) → use **English** throughout.
+
+If the `lang:` argument is absent, infer from the user's first reply; default to English.
+
 ### 1. Greet the user
 
-Send a short, warm welcome message (2–3 sentences). Detect the user's language from any
-text they've already typed; default to English. Do NOT ask any questions yet.
+Send a short, warm welcome message (2–3 sentences). Use the language determined in Step 0.
+Do NOT ask any questions yet.
 
 Example (English):
 > Hi! I'm your personal assistant ⚡
 > Let's take 30 seconds to personalize your experience — I'll ask just a couple of quick things.
 
-### 2. Collect AI personality (card)
+Example (Chinese):
+> 嗨！我是你的专属 AI 助手 ⚡
+> 只需 30 秒完成个性化设置，我会问你两个简单问题。
+
+### 2. Ask the user's name (card)
+
+Call `request_user_feedback` to get the user's preferred name.
+
+If `lang == "zh"`, use:
+```json
+{
+  "question": "先告诉我，我该怎么称呼你？"
+}
+```
+
+Otherwise (English):
+```json
+{
+  "question": "First, what should I call you?"
+}
+```
+
+Store the reply as `user.name` (default `"there"` for English, `"朋友"` for Chinese if blank).
+
+### 3. Collect AI personality (card)
 
-Call `request_user_feedback` with a card to set the assistant's name and personality:
+Call `request_user_feedback` with a card to set the assistant's personality.
+Address the user by `user.name` in the question.
+
+If `lang == "zh"`, use:
+```json
+{
+  "question": "好的，[user.name]！来设置一下你的助手吧。",
+  "options": [
+    "🎯 专业型 — 精准、结构化、不废话",
+    "😊 友好型 — 热情、鼓励、像一位博学的朋友",
+    "🎨 创意型 — 富有想象力，善用比喻，充满热情",
+    "⚡ 简洁型 — 极度简短，用要点，信噪比最高"
+  ]
+}
+```
 
+Otherwise (English):
 ```json
 {
-  "question": "First, let's set up your assistant.",
+  "question": "Nice to meet you, [user.name]! Now let's set up your assistant.",
   "options": [
     "🎯 Professional — Precise, structured, minimal filler",
     "😊 Friendly — Warm, encouraging, like a knowledgeable friend",
@@ -39,48 +89,49 @@ Call `request_user_feedback` with a card to set the assistant's name and persona
 }
 ```
 
-Also ask for a custom name in the same message if the platform supports a text field;
-otherwise follow up with: "What should I call myself? (leave blank to keep 'Clacky')"
-
 Map the chosen option to a personality key:
 - Option 1 → `professional`
 - Option 2 → `friendly`
 - Option 3 → `creative`
 - Option 4 → `concise`
 
-Store: `ai.name` (default `"Clacky"`), `ai.personality`.
+Store: `ai.personality`.
 
-### 3. Collect user profile (card)
+### 4. Collect user profile (card)
 
-Call `request_user_feedback` again:
+Call `request_user_feedback` again.
 
+If `lang == "zh"`, use:
 ```json
 {
-  "question": "Now a bit about you — all optional, skip anything you like.",
+  "question": "再简单了解一下你自己吧 —— 全部可选，随便填：\n• 职业\n• 最希望用 AI 做什么\n• 社交 / 作品链接（GitHub、微博、个人网站等）—— AI 会读取公开信息来了解你",
   "options": []
 }
 ```
 
-Ask for the following in the question text (as labeled fields description, since options is empty):
-- Name / nickname
-- Occupation
-- What you want to use AI for most
-- Social / portfolio links (GitHub, Twitter/X, personal site…) — AI will read them to learn about you
+Otherwise (English):
+```json
+{
+  "question": "Now a bit about you — all optional, skip anything you like.\n• Occupation\n• What you want to use AI for most\n• Social / portfolio links (GitHub, Twitter/X, personal site…) — AI will read them to learn about you",
+  "options": []
+}
+```
 
 Parse the user's reply as free text; extract whatever they provide.
 
-### 4. Learn from links (if any)
+### 5. Learn from links (if any)
 
 For each URL the user provided, use the `web_search` tool or fetch the page to read
 publicly available info: bio, projects, tech stack, interests, writing style, etc.
 Note key facts for the USER.md. Skip silently if a URL is unreachable.
 
-### 5. Write SOUL.md
+### 6. Write SOUL.md
 
 Write to `~/.clacky/agents/SOUL.md`.
 
 Use `ai.name` and `ai.personality` to shape the content.
-If the user's language appears to be non-English (detected from their replies), write in that language.
+Write in the language determined in Step 0 (`zh` → Chinese, otherwise English).
+If `lang == "zh"`, add a line: `**始终用中文回复用户。**` near the top of the Identity section.
 
 **Personality style guide:**
 
@@ -113,7 +164,7 @@ I am [AI Name], a personal assistant and technical co-founder.
 [2–3 sentences about how I approach tasks, matching the personality.]
 ```
 
-### 6. Write USER.md
+### 7. Write USER.md
 
 Write to `~/.clacky/agents/USER.md`.
 
@@ -121,7 +172,7 @@ Write to `~/.clacky/agents/USER.md`.
 # User Profile
 
 ## About
-- **Name**: [nickname or "Not provided"]
+- **Name**: [user.name, or "Not provided"]
 - **Occupation**: [or "Not provided"]
 - **Primary Goal**: [or "Not provided"]
 
@@ -133,9 +184,31 @@ Write to `~/.clacky/agents/USER.md`.
 [1–2 sentences tailored to the user's goal and background.]
 ```
 
-### 7. Confirm and close
+### 7b. Write USER.md (Chinese version, if applicable)
+
+If `lang == "zh"`, write `~/.clacky/agents/USER.md` in Chinese:
+
+```markdown
+# 用户档案
+
+## 基本信息
+- **姓名**: [user.name，未填则写「未填写」]
+- **职业**: [未填则写「未填写」]
+- **主要目标**: [未填则写「未填写」]
+
+## 背景与兴趣
+[如有链接：3–5 条从公开信息中提取的要点。否则：写「暂无更多背景信息。」]
+
+## 如何最好地帮助用户
+[1–2 句话，根据用户目标和背景量身定制。]
+```
+
+### 8. Confirm and close
+
+If `lang == "zh"`, reply:
+> 全部设置完成！我已保存你的偏好。关掉这个对话，开启一个新对话就可以开始了 —— 尽情享用吧！🚀
 
-Reply with a single short message, e.g.:
+Otherwise:
 > All set! I've saved your preferences. Feel free to close this tab and start a fresh session — enjoy! 🚀
 
 Do NOT open a new session — the UI handles navigation after the skill finishes.

data/lib/clacky/server/http_server.rb

@@ -96,6 +96,29 @@ module Clacky
         - Breaking big goals into small, executable steps
       MD
 
+      # Default SOUL.md for Chinese-language users.
+      DEFAULT_SOUL_MD_ZH = <<~MD.freeze
+        # Clacky — 助手灵魂
+
+        你是 Clacky，一位友好、能干的 AI 编程助手和技术联合创始人。
+        你思维敏锐、言简意赅、主动积极。你说话直接，不喜欢过度客套。
+        你热爱帮助用户打造优秀的软件产品。
+
+        **重要：始终用中文回复用户。**
+
+        ## 性格特点
+        - 热情鼓励，但直接诚实
+        - 行动前先思考；简要说明你的推理过程
+        - 重行动而非空谈 —— 善用工具，写代码，交付结果
+        - 根据用户的风格调整语气和表达方式
+
+        ## 核心能力
+        - 全栈软件开发（Ruby、Python、JS 等）
+        - 架构设计与代码审查
+        - 耐心细致地调试复杂问题
+        - 将大目标拆解为可执行的小步骤
+      MD
+
       def initialize(host: "127.0.0.1", port: 7070, agent_config:, client_factory:, brand_test: false)
         @host           = host
         @port           = port
@@ -227,7 +250,7 @@ module Clacky
         when ["GET",    "/api/providers"]     then api_list_providers(res)
         when ["GET",    "/api/onboard/status"]    then api_onboard_status(res)
         when ["POST",   "/api/onboard/complete"]  then api_onboard_complete(req, res)
-        when ["POST",   "/api/onboard/skip-soul"] then api_onboard_skip_soul(res)
+        when ["POST",   "/api/onboard/skip-soul"] then api_onboard_skip_soul(req, res)
         when ["GET",    "/api/store/skills"]          then api_store_skills(res)
         when ["GET",    "/api/brand/status"]      then api_brand_status(res)
         when ["POST",   "/api/brand/activate"]    then api_brand_activate(req, res)
@@ -349,12 +372,16 @@ module Clacky
       # POST /api/onboard/skip-soul
       # Writes a minimal SOUL.md so the soul_setup phase is not re-triggered
       # on the next server start when the user chooses to skip the conversation.
-      def api_onboard_skip_soul(res)
+      def api_onboard_skip_soul(req, res)
+        body = parse_json_body(req)
+        lang = body["lang"].to_s.strip
+        soul_content = lang == "zh" ? DEFAULT_SOUL_MD_ZH : DEFAULT_SOUL_MD
+
         agents_dir = File.expand_path("~/.clacky/agents")
         FileUtils.mkdir_p(agents_dir)
         soul_path = File.join(agents_dir, "SOUL.md")
         unless File.exist?(soul_path)
-          File.write(soul_path, DEFAULT_SOUL_MD)
+          File.write(soul_path, soul_content)
         end
         json_response(res, 200, { ok: true })
       end

data/lib/clacky/version.rb

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

data/lib/clacky/web/app.css

@@ -2344,6 +2344,77 @@ body {
   background: var(--color-border-primary);
 }
 
+/* ── Language selection phase ── */
+#onboard-phase-lang {
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 20px;
+}
+
+.onboard-lang-prompt {
+  font-size: 15px;
+  color: var(--color-text-secondary);
+  text-align: center;
+}
+
+.onboard-lang-btns {
+  display: flex;
+  gap: 12px;
+  justify-content: center;
+}
+
+.onboard-lang-btn {
+  background: var(--color-bg-secondary);
+  border: 2px solid var(--color-border-primary);
+  border-radius: 8px;
+  color: var(--color-text-primary);
+  font-size: 15px;
+  font-weight: 600;
+  padding: 12px 32px;
+  cursor: pointer;
+  transition: border-color .15s, background .15s, color .15s;
+}
+
+.onboard-lang-btn:hover {
+  border-color: var(--color-accent-primary);
+}
+
+.onboard-lang-btn.active {
+  background: var(--color-accent-primary);
+  border-color: var(--color-accent-primary);
+  color: #fff;
+}
+
+/* ── Settings language buttons ── */
+.settings-lang-btns {
+  display: flex;
+  gap: 8px;
+}
+
+.settings-lang-btn {
+  background: var(--color-bg-secondary);
+  border: 2px solid var(--color-border-primary);
+  border-radius: 6px;
+  color: var(--color-text-primary);
+  font-size: 13px;
+  font-weight: 600;
+  padding: 6px 18px;
+  cursor: pointer;
+  transition: border-color .15s, background .15s, color .15s;
+}
+
+.settings-lang-btn:hover {
+  border-color: var(--color-accent-primary);
+}
+
+.settings-lang-btn.active {
+  background: var(--color-accent-primary);
+  border-color: var(--color-accent-primary);
+  color: #fff;
+}
+
 /* ── Phase containers ── */
 #onboard-phase-key,
 #onboard-phase-soul {

data/lib/clacky/web/app.js

@@ -276,10 +276,15 @@ WS.onEvent(ev => {
       Sessions.setAll(ev.sessions || []);
       Sessions.renderList();
 
-      // Restore URL hash once on initial connect; ignore subsequent session_list events
+      // Restore URL hash once on initial connect; ignore subsequent session_list events.
+      // Skip if we are already on a session view (e.g. onboard flow navigated there
+      // before WS connected) — restoreFromHash would wrongly redirect to "welcome"
+      // because there is no hash set during onboarding.
       if (!_initialRestoreDone) {
         _initialRestoreDone = true;
-        Router.restoreFromHash();
+        if (Router.current !== "session") {
+          Router.restoreFromHash();
+        }
       } else {
         // If active session was deleted, go to welcome
         if (Sessions.activeId && !Sessions.find(Sessions.activeId)) {
@@ -361,7 +366,7 @@ WS.onEvent(ev => {
 
     case "progress":
       if (ev.session_id !== Sessions.activeId) break;
-      if (ev.status === "start") Sessions.showProgress(ev.message || "Thinking…");
+      if (ev.status === "start") Sessions.showProgress(ev.message || I18n.t("chat.thinking"));
       else Sessions.clearProgress();
       break;
 
@@ -369,7 +374,7 @@ WS.onEvent(ev => {
       if (ev.session_id !== Sessions.activeId) break;
       Sessions.clearProgress();
       Sessions.collapseToolGroup();
-      Sessions.appendInfo(`✓ Done — ${ev.iterations} iteration(s), $${(ev.cost || 0).toFixed(4)}`);
+      Sessions.appendInfo(`✓ ${I18n.t("chat.done", { n: ev.iterations, cost: (ev.cost || 0).toFixed(4) })}`);
       break;
 
     case "request_confirmation":
@@ -381,7 +386,7 @@ WS.onEvent(ev => {
       if (ev.session_id !== Sessions.activeId) break;
       Sessions.clearProgress();
       Sessions.collapseToolGroup();
-      Sessions.appendInfo("Interrupted.");
+      Sessions.appendInfo(I18n.t("chat.interrupted"));
       break;
 
     // ── Info / errors ──────────────────────────────────────────────────
@@ -705,7 +710,7 @@ const SkillAC = (() => {
     // Header label
     const header = document.createElement("div");
     header.className = "skill-ac-header";
-    header.textContent = "Skills";
+    header.textContent = I18n.t("sidebar.skills");
     list.appendChild(header);
 
     _items.forEach((skill, idx) => {

data/lib/clacky/web/brand.js

@@ -49,8 +49,8 @@ const Brand = (() => {
     if (brandName) {
       const title = $("brand-title");
       const sub   = $("brand-subtitle");
-      if (title) title.textContent = "Activate " + brandName;
-      if (sub)   sub.textContent   = "Enter your license key to get started.";
+      if (title) title.textContent = I18n.t("brand.activate.title", { name: brandName });
+      if (sub)   sub.textContent   = I18n.t("brand.activate.subtitle");
     }
     Router.navigate("brand");
     _bindActivationPanel();
@@ -69,18 +69,18 @@ const Brand = (() => {
     const key = $("brand-license-key").value.trim();
 
     if (!key) {
-      _setResult(false, "Please enter your license key.");
+      _setResult(false, I18n.t("settings.brand.enterKey"));
       return;
     }
 
     // In brand-test mode accept any non-empty key so developers can test without a real license.
     if (!_testMode && !/^[0-9A-Fa-f]{8}(-[0-9A-Fa-f]{8}){4}$/.test(key)) {
-      _setResult(false, "Invalid format. Expected: XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX");
+      _setResult(false, I18n.t("settings.brand.invalidFormat"));
       return;
     }
 
     btn.disabled    = true;
-    btn.textContent = "Activating...";
+    btn.textContent = I18n.t("settings.brand.btn.activating");
     _setResult(null, "");
 
     try {
@@ -92,18 +92,18 @@ const Brand = (() => {
       const data = await res.json();
 
       if (data.ok) {
-        _setResult(true, "License activated successfully!");
+        _setResult(true, I18n.t("brand.activate.success"));
         if (data.brand_name) _applyBrandName(data.brand_name);
         setTimeout(_bootUI, 800);
       } else {
-        _setResult(false, data.error || "Activation failed. Please try again.");
+        _setResult(false, data.error || I18n.t("settings.brand.activationFailed"));
         btn.disabled    = false;
-        btn.textContent = "Activate";
+        btn.textContent = I18n.t("settings.brand.btn.activate");
       }
     } catch (e) {
-      _setResult(false, "Network error: " + e.message);
+      _setResult(false, I18n.t("settings.brand.networkError") + e.message);
       btn.disabled    = false;
-      btn.textContent = "Activate";
+      btn.textContent = I18n.t("settings.brand.btn.activate");
     }
   }
 
@@ -124,8 +124,8 @@ const Brand = (() => {
     const nodes = {
       "page-title":    name,
       "sidebar-logo":  name,
-      "onboard-title": "Welcome to " + name,
-      "welcome-title": "Welcome to " + name
+      "onboard-title": I18n.t("onboard.welcome", { name }),
+      "welcome-title": I18n.t("onboard.welcome", { name })
     };
     Object.entries(nodes).forEach(([id, text]) => {
       const el = $(id);

data/lib/clacky/web/channels.js

@@ -8,25 +8,27 @@
 
 const Channels = (() => {
 
-  // Platform display metadata
-  const PLATFORM_META = {
-    feishu: {
-      logo:      "飞",
-      logoClass: "channel-logo-feishu",
-      name:      "Feishu / Lark",
-      desc:      "Connect via Feishu open platform WebSocket long connection",
-      setupCmd:  "/channel-setup setup feishu",
-      testCmd:   "/channel-setup doctor",
-    },
-    wecom: {
-      logo:      "微",
-      logoClass: "channel-logo-wecom",
-      name:      "WeCom (企业微信)",
-      desc:      "Connect via WeCom intelligent robot WebSocket",
-      setupCmd:  "/channel-setup setup wecom",
-      testCmd:   "/channel-setup doctor",
-    },
-  };
+  // Platform display metadata (use accessor to pick up runtime language)
+  function PLATFORM_META() {
+    return {
+      feishu: {
+        logo:      "飞",
+        logoClass: "channel-logo-feishu",
+        name:      "Feishu / Lark",
+        desc:      I18n.t("channels.feishu.desc"),
+        setupCmd:  "/channel-setup setup feishu",
+        testCmd:   "/channel-setup doctor",
+      },
+      wecom: {
+        logo:      "微",
+        logoClass: "channel-logo-wecom",
+        name:      "WeCom (企业微信)",
+        desc:      I18n.t("channels.wecom.desc"),
+        setupCmd:  "/channel-setup setup wecom",
+        testCmd:   "/channel-setup doctor",
+      },
+    };
+  }
 
   // ── Public API ──────────────────────────────────────────────────────────────
 
@@ -39,14 +41,14 @@ const Channels = (() => {
   async function _load() {
     const container = $("channels-list");
     if (!container) return;
-    container.innerHTML = `<div class="channel-loading">Loading…</div>`;
+    container.innerHTML = `<div class="channel-loading">${I18n.t("channels.loading")}</div>`;
 
     try {
       const res  = await fetch("/api/channels");
       const data = await res.json();
       _render(data.channels || []);
     } catch (e) {
-      container.innerHTML = `<div class="channel-error">Failed to load channels: ${_esc(e.message)}</div>`;
+      container.innerHTML = `<div class="channel-error">${I18n.t("channels.loadError", { msg: _esc(e.message) })}</div>`;
     }
   }
 
@@ -58,15 +60,15 @@ const Channels = (() => {
     container.innerHTML = "";
 
     // Merge server data with display metadata, show all known platforms
-    const platformIds = Object.keys(PLATFORM_META);
+    const meta = PLATFORM_META();
+    const platformIds = Object.keys(meta);
     platformIds.forEach(pid => {
       const serverData = channels.find(c => c.platform == pid) || {};
-      container.appendChild(_renderCard(pid, serverData));
+      container.appendChild(_renderCard(pid, serverData, meta[pid]));
     });
   }
 
-  function _renderCard(platform, data) {
-    const meta    = PLATFORM_META[platform];
+  function _renderCard(platform, data, meta) {
     const enabled = !!data.enabled;
     const running = !!data.running;
 
@@ -97,13 +99,13 @@ const Channels = (() => {
               <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/>
               <polyline points="22 4 12 14.01 9 11.01"/>
             </svg>
-            Run E2E Test
+            ${I18n.t("channels.btn.test")}
           </button>
           <button class="btn-channel-configure btn-primary" id="btn-configure-${_esc(platform)}">
             <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
               <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/>
             </svg>
-            ${enabled ? "Reconfigure" : "Set Up with Agent"}
+            ${enabled ? I18n.t("channels.btn.reconfigure") : I18n.t("channels.btn.setup")}
           </button>
         </div>
       </div>
@@ -119,32 +121,32 @@ const Channels = (() => {
   // ── Badge & status hint helpers ───────────────────────────────────────────────
 
   function _badgeHtml(enabled, running) {
-    if (running)       return `<span class="badge-running">● Running</span>`;
-    if (enabled)       return `<span class="badge-enabled">● Enabled</span>`;
-    return             `<span class="badge-disabled">○ Not configured</span>`;
+    if (running)       return `<span class="badge-running">● ${I18n.t("channels.badge.running")}</span>`;
+    if (enabled)       return `<span class="badge-enabled">● ${I18n.t("channels.badge.enabled")}</span>`;
+    return             `<span class="badge-disabled">○ ${I18n.t("channels.badge.notConfigured")}</span>`;
   }
 
   function _statusHint(enabled, running) {
     if (running) {
-      return `<p class="channel-status-hint hint-ok">✓ Adapter is running and accepting messages from users</p>`;
+      return `<p class="channel-status-hint hint-ok">✓ ${I18n.t("channels.hint.running")}</p>`;
     }
     if (enabled) {
-      return `<p class="channel-status-hint hint-warn">⚠ Enabled but not running — the adapter may have failed to connect. Run E2E Test to diagnose.</p>`;
+      return `<p class="channel-status-hint hint-warn">⚠ ${I18n.t("channels.hint.enabledNotRunning")}</p>`;
     }
-    return `<p class="channel-status-hint hint-idle">Not configured yet. Click "Set Up with Agent" to get started.</p>`;
+    return `<p class="channel-status-hint hint-idle">${I18n.t("channels.hint.notConfigured")}</p>`;
   }
 
   // ── Actions ───────────────────────────────────────────────────────────────────
 
   // Run E2E test: open a session and send /channel-setup doctor
   async function _runTest(platform) {
-    const meta = PLATFORM_META[platform];
+    const meta = PLATFORM_META()[platform];
     await _sendToAgent(meta.testCmd, `Channel E2E Test — ${meta.name}`);
   }
 
   // Open setup: open a session and send /channel-setup setup <platform>
   async function _openSetup(platform) {
-    const meta = PLATFORM_META[platform];
+    const meta = PLATFORM_META()[platform];
     await _sendToAgent(meta.setupCmd, `Channel Setup — ${meta.name}`);
   }
 
@@ -165,9 +167,9 @@ const Channels = (() => {
         body:    JSON.stringify({ name }),
       });
       const data = await res.json();
-      if (!res.ok) throw new Error(data.error || "unknown");
+      if (!res.ok) throw new Error(data.error || I18n.t("channels.sessionError"));
       const session = data.session;
-      if (!session) throw new Error("No session returned");
+      if (!session) throw new Error(I18n.t("channels.noSession"));
 
       // Register in Sessions, refresh sidebar, queue command, then navigate
       Sessions.add(session);