openclacky 1.5.3 → 1.5.5

data/lib/clacky/agent_profile.rb

@@ -53,8 +53,11 @@ module Clacky
 
     # List all available agent profiles across user + extension layers.
     # Precedence on id collision: user override → extension unit.
+    # @param recency [Hash<String, Integer>] agent id => epoch of last use,
+    #   used to order third-party extension agents by most-recently-used
+    #   instead of their static `order` field.
     # @return [Array<Hash>] each: { id:, title:, title_zh:, description:, description_zh:, source:, order:, layer:, author:, avatar: }
-    def self.all
+    def self.all(recency: {})
       out = {}
 
       add = lambda do |id, title, title_zh, description, description_zh, source, order, layer, author, avatar|
@@ -76,6 +79,7 @@ module Clacky
       ext_result = ExtensionLoader.last_result || ExtensionLoader.load_all
       ext_result&.agents&.each do |unit|
         spec = unit.spec || {}
+        next if spec["hidden"]
         title = spec["title"].to_s
         title = unit.id if title.empty?
         avatar = spec["avatar_abs"].to_s.empty? ? nil : "/agent_avatar/#{unit.id}"
@@ -102,8 +106,26 @@ module Clacky
         )
       end
 
-      source_rank = { "user" => 0, "extension" => 1 }
-      out.values.sort_by { |a| [source_rank[a[:source]] || 9, a[:order] || 999, a[:id]] }
+      # Builtin agents always come first, then user overrides, then third-party
+      # extension agents — so the "start new session" grid keeps the official
+      # agents grouped ahead of anything the user installed from the market.
+      # Within the third-party group, agents are ordered by most-recently-used
+      # first (via `recency`), falling back to their static `order` field for
+      # agents that have never been used yet.
+      layer_rank = lambda do |a|
+        next 0 if a[:layer] == "builtin"
+        next 1 if a[:source] == "user"
+
+        2
+      end
+      out.values.sort_by do |a|
+        rank = layer_rank.call(a)
+        if rank == 2
+          [rank, -(recency[a[:id]] || 0), a[:order] || 999, a[:id]]
+        else
+          [rank, a[:order] || 999, a[:id]]
+        end
+      end
     end
 
     private_class_method def self.read_profile_yml(path)

data/lib/clacky/brand_config.rb

@@ -383,16 +383,16 @@ module Clacky
 
     # Returns true when a public distribution refresh is due.
     #
-    # Refresh is needed only when the install has a package_name configured
-    # but is not yet activated — activated licenses already get fresh
-    # distribution data via #heartbeat! (once per 24h).
+    # Refresh is needed for unactivated branded installs and for private
+    # platform sources that have not supplied their deployment brand yet.
+    # Activated licenses already get fresh distribution data via #heartbeat!.
     #
     # Rate limit: once every HEARTBEAT_INTERVAL (24h), measured from the last
     # SUCCESSFUL refresh. A failed refresh does not advance the clock so we'll
     # keep trying on subsequent startups / status polls.
     def distribution_refresh_due?
-      return false unless branded?
       return false if activated?
+      return false unless branded? || private_platform_source?
       return true  if @distribution_last_refreshed_at.nil?
 
       elapsed = Time.now.utc - @distribution_last_refreshed_at
@@ -400,7 +400,8 @@ module Clacky
     end
 
     # Refresh public brand assets (logo, theme, homepage_url, support_*) for
-    # installs that have `package_name` configured but no activated license yet.
+    # unactivated installs. Package installs use an exact package lookup;
+    # private platform sources without a local brand use the source default.
     #
     # Motivation: `install.sh --brand-name=X --command=X` only writes
     # product_name + package_name to brand.yml. The rest of the distribution
@@ -409,32 +410,47 @@ module Clacky
     # anonymous public lookup endpoint.
     #
     # Behaviour:
-    #   * No-op (returns { success: false, message: "..." }) when not branded,
-    #     already activated, or package_name is blank.
+    #   * No-op when already activated, or when neither a package_name nor a
+    #     private platform source is available.
     #   * On success: apply_distribution + save + stamp
     #     @distribution_last_refreshed_at.
+    #   * When a block is provided, discard the response unless it still
+    #     confirms that the platform source is current.
     #   * On failure: log and return without touching the timestamp (so we
     #     retry on next trigger).
     #
     # Returns { success: Boolean, message: String }.
     def refresh_distribution!
-      unless branded?
+      source_brand_lookup = private_platform_source? &&
+                            (@package_name.nil? || @package_name.strip.empty?)
+      unless branded? || source_brand_lookup
         return { success: false, message: "Not branded" }
       end
       if activated?
         return { success: false, message: "License activated — use heartbeat! instead" }
       end
-      if @package_name.nil? || @package_name.strip.empty?
+      if !source_brand_lookup && (@package_name.nil? || @package_name.strip.empty?)
         return { success: false, message: "package_name not configured" }
       end
 
-      encoded_pkg = URI.encode_www_form_component(@package_name.strip)
-      path        = "/api/v1/distributions/lookup?package_name=#{encoded_pkg}"
+      if source_brand_lookup
+        path = "/api/v1/distributions/lookup"
+      else
+        encoded_pkg = URI.encode_www_form_component(@package_name.strip)
+        path = "/api/v1/distributions/lookup?package_name=#{encoded_pkg}"
+      end
 
-      Clacky::Logger.info("[Brand] refresh_distribution! fetching — package_name=#{@package_name}")
+      Clacky::Logger.info(
+        "[Brand] refresh_distribution! fetching — package_name=#{@package_name || "source-default"}"
+      )
       response = platform_client.get(path)
 
       if response[:success] && response[:data].is_a?(Hash) && response[:data]["distribution"].is_a?(Hash)
+        if block_given? && !yield
+          Clacky::Logger.info("[Brand] refresh_distribution! discarded — platform source changed")
+          return { success: false, message: "Platform source changed during refresh" }
+        end
+
         apply_distribution(response[:data]["distribution"])
         @distribution_last_refreshed_at = Time.now.utc
         save
@@ -1762,6 +1778,10 @@ module Clacky
       @homepage_url    = dist["homepage_url"]     if dist.key?("homepage_url")
     end
 
+    private def private_platform_source?
+      !ENV["CLACKY_LICENSE_SERVER"].to_s.strip.empty?
+    end
+
     # Download a remote URL to a local file path.
     #
     # Deprecated: this method now delegates to

data/lib/clacky/default_extensions/ext-studio/agents/ext-developer/system_prompt.md

@@ -143,3 +143,18 @@ main product, and apply every rule below whenever you propose or write code:
   Ruby and carry supply-chain risk.
 - After editing `view.js`, `handler.rb`, or a `SKILL.md`, tell the user to reload the
   WebUI page — hot reload is per-request, no restart needed.
+- After you finish editing extension files, call this once at the very end to trigger
+  a reload button in the UI (if it doesn't appear, the user can manually refresh the browser):
+  ```
+  curl -s --noproxy '*' -X POST "http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/ui/show_ext_refresh" \
+    -H "Content-Type: application/json" \
+    -d "{\"session_id\": \"${CLACKY_SESSION_ID}\"}"
+  ```
+  (`--noproxy '*'` prevents shell proxy env vars from silently intercepting this loopback call.)
+- If the extension contributes a `session.aside` panel, also call this right after the above
+  to open the panel automatically:
+  ```
+  curl -s --noproxy '*' -X POST "http://${CLACKY_SERVER_HOST}:${CLACKY_SERVER_PORT}/api/ui/open_aside" \
+    -H "Content-Type: application/json" \
+    -d "{\"session_id\": \"${CLACKY_SESSION_ID}\"}"
+  ```

data/lib/clacky/default_extensions/ext-studio/api/handler.rb

@@ -201,11 +201,7 @@ class ExtStudioExt < Clacky::ApiExtension
       error!("extension not found: #{ext_id}", status: 404) unless container
 
       readme_path = File.join(container[:dir], "README.md")
-      if readme.strip.empty?
-        File.delete(readme_path) if File.exist?(readme_path)
-      else
-        File.write(readme_path, readme, encoding: "utf-8")
-      end
+      File.write(readme_path, readme, encoding: "utf-8")
     end
 
     json(ok: true, ext_id: ext_id, saved_to: published ? "platform" : "local")

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

@@ -19,8 +19,8 @@ contributes:
     - id: ext-developer
       title: Extension Developer
       title_zh: 扩展开发
-      description: AI expert that helps you build, debug, and publish extensions
-      description_zh: 帮你开发、调试、发布扩展的 AI 专家
+      description: AI expert that helps you build custom AI agent workflows
+      description_zh: 帮你开发自定义 AI Agent 工作流的专家
       order: 5
       prompt: agents/ext-developer/system_prompt.md
       avatar: agents/ext-developer/avatar.png

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

@@ -146,7 +146,7 @@
       "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",
-      "extlist.newExt.seed": "I want to build a new OpenClacky extension. Help me get started: ask me what the extension should do, then scaffold it and build it out step by step.",
+      "extlist.newExt.seed": "I want to build a new extension. Help me get started: ask me what the extension should do, then scaffold it and build it out step by step.",
       "unit.panel": "panel",
       "unit.panels": "panels",
       "unit.agent": "agent",
@@ -331,7 +331,7 @@
       "extlist.newExt.label": "新建扩展",
       "extlist.newExt.hint": "打开一个 AI 会话，帮你生成并开发它。",
       "extlist.newExt.btn": "新建扩展",
-      "extlist.newExt.seed": "我想开发一个新的 OpenClacky 扩展。请引导我开始：先问清楚这个扩展要做什么，然后帮我搭好骨架并一步步开发出来。",
+      "extlist.newExt.seed": "我想开发一个新的扩展。请引导我开始：先问清楚这个扩展要做什么，然后帮我搭好骨架并一步步开发出来。",
       "unit.panel": "个面板",
       "unit.panels": "个面板",
       "unit.agent": "个 Agent",
@@ -1539,7 +1539,7 @@
         let data = {};
         try { data = await res.json(); } catch (_e) {}
         if (!res.ok) throw new Error(data?.error || `Error ${res.status}`);
-        await reload(); rebuild();
+        location.reload();
       } catch (e) {
         alert(t("err.generic", { msg: e.message }));
         btn.disabled = false;
@@ -1567,28 +1567,29 @@
       return box;
     }
 
-    function rebuild() {
+    function rebuild(headerActions) {
       if (!container) return;
       container.innerHTML = "";
 
-      const newBox = el("div", { class: "studio-skill-promo" });
-      newBox.appendChild(el("p", { class: "studio-skill-promo-text", text: t("extlist.newExt.label") }));
-      newBox.appendChild(el("p", { class: "studio-skill-hint", text: t("extlist.newExt.hint") }));
-      const newBar = el("div", { class: "studio-actions" });
-      newBar.appendChild(el("button", { class: "studio-btn studio-btn-primary", text: t("extlist.newExt.btn"), onclick: () => createExtension(t("extlist.newExt.seed")) }));
-      newBox.appendChild(newBar);
-      container.appendChild(newBox);
+      if (headerActions) {
+        headerActions.innerHTML = "";
+        headerActions.appendChild(el("button", {
+          class: "studio-btn studio-btn-primary",
+          text: t("extlist.newExt.btn"),
+          onclick: () => createExtension(t("extlist.newExt.seed")),
+        }));
+      }
 
       container.appendChild(section("extlist.section.cloud", "extlist.section.cloudHint", cloud, cloudCard, "extlist.cloud.empty"));
       container.appendChild(section("extlist.section.local", "extlist.section.localHint", store.extensions, localCard, "extlist.local.empty"));
     }
 
     return {
-      async attach(root) {
+      async attach(root, headerActions) {
         container = el("div", { class: "studio-panel" });
         root.appendChild(container);
         container.innerHTML = _skeletonHtml();
-        try { await reload(); rebuild(); }
+        try { await reload(); rebuild(headerActions); }
         catch (e) { container.innerHTML = ""; container.appendChild(el("p", { class: "studio-empty", text: t("err.generic", { msg: e.message }) })); }
       },
     };
@@ -1723,24 +1724,27 @@
       return box;
     }
 
-    function rebuild() {
+    function rebuild(headerActions) {
       if (!container) return;
       container.innerHTML = "";
 
-      if (locked) {
-        const promo = el("div", { class: "studio-skill-promo" });
-        promo.appendChild(el("p", { class: "studio-skill-promo-text", text: t("skills.promo.text") }));
-        promo.appendChild(el("p", { class: "studio-empty", text: t("skills.locked") }));
-        container.appendChild(promo);
+      if (headerActions) {
+        headerActions.innerHTML = "";
+        const newBtn = el("button", {
+          class: "studio-btn studio-btn-primary",
+          text: t("skills.newSkill.btn"),
+          onclick: () => createSkill(null),
+        });
+        newBtn.disabled = locked;
+        newBtn.title = locked ? t("skills.locked") : "";
+        headerActions.appendChild(newBtn);
       }
 
-      const newBox = el("div", { class: "studio-skill-promo" });
-      newBox.appendChild(el("p", { class: "studio-skill-promo-text", text: t("skills.newSkill.btn") }));
-      newBox.appendChild(el("p", { class: "studio-skill-hint", text: t("skills.newSkill.label") }));
-      const newBar = el("div", { class: "studio-actions" });
-      newBar.appendChild(el("button", { class: "studio-btn studio-btn-primary", text: t("skills.newSkill.btn"), onclick: () => createSkill(null) }));
-      newBox.appendChild(newBar);
-      container.appendChild(newBox);
+      if (locked) {
+        const lockHint = el("p", { class: "studio-empty", text: t("skills.locked") });
+        lockHint.style.marginBottom = "12px";
+        container.appendChild(lockHint);
+      }
 
       const cloudEmptyKey = locked ? "skills.cloud.locked" : "skills.cloud.empty";
       container.appendChild(section("skills.section.cloud", "skills.section.cloudHint", cloud, cloudCard, cloudEmptyKey));
@@ -1748,11 +1752,11 @@
     }
 
     return {
-      async attach(root) {
+      async attach(root, headerActions) {
         container = el("div", { class: "studio-panel" });
         root.appendChild(container);
         container.innerHTML = _skeletonHtml();
-        try { await reload(); rebuild(); }
+        try { await reload(); rebuild(headerActions); }
         catch (e) { container.innerHTML = ""; container.appendChild(el("p", { class: "studio-empty", text: t("err.generic", { msg: e.message }) })); }
       },
     };
@@ -1768,6 +1772,8 @@
 
     const header = el("div", { class: "studio-page-head" });
     header.appendChild(el("h2", { class: "studio-page-title", text: t("ws.title") }));
+    const headerActions = el("div", { class: "studio-page-head-actions" });
+    header.appendChild(headerActions);
     page.appendChild(header);
 
     const tabsBar = el("div", { class: "studio-tabs" });
@@ -1785,8 +1791,9 @@
       active = id;
       Array.from(tabsBar.children).forEach((b) => b.classList.toggle("studio-tab-active", b.dataset.tab === id));
       body.innerHTML = "";
+      headerActions.innerHTML = "";
       const tab = tabs.find((t2) => t2.id === id);
-      if (tab) tab.build(body);
+      if (tab) tab.build(body, headerActions);
     }
 
     tabs.forEach((tab) => {
@@ -1799,12 +1806,12 @@
     select("extensions");
   }
 
-  function buildExtensionsTab(root) {
-    createExtensionsPanel().attach(root);
+  function buildExtensionsTab(root, headerActions) {
+    createExtensionsPanel().attach(root, headerActions);
   }
 
-  function buildSkillsTab(root) {
-    createSkillsPanel().attach(root);
+  function buildSkillsTab(root, headerActions) {
+    createSkillsPanel().attach(root, headerActions);
   }
 
   function navRow(labelKey, onClick) {
@@ -1904,8 +1911,10 @@
     .studio-published-row { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 8px 0; font-size: 12px; border-bottom: 1px solid var(--color-border-primary); }
     .studio-published-name { display: flex; align-items: center; gap: 6px; color: var(--color-text-primary); }
     .studio-page { width: 100%; }
-    .studio-page-head { margin-bottom: 20px; }
+    .studio-page-head { display: flex; align-items: center; justify-content: space-between; margin-bottom: 20px; }
+    .studio-page-head-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }
     .studio-page-title { margin: 0; font-size: 22px; font-weight: 600; color: var(--color-text-primary); }
+    .studio-btn-sm { padding: 5px 12px; font-size: 12px; }
     .studio-tabs { display: flex; gap: 4px; border-bottom: 1px solid var(--color-border-primary); margin-bottom: 24px; }
     .studio-tab { padding: 8px 16px; border: none; background: transparent; color: var(--color-text-tertiary); cursor: pointer; font-size: 14px; font-weight: 500; border-bottom: 2px solid transparent; margin-bottom: -1px; }
     .studio-tab:hover { color: var(--color-text-primary); }

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

@@ -24,7 +24,7 @@ Seven `contributes:` types (use one, several, or all):
 - `panels`   — WebUI panels (a `view.js`, no build step, no React, no iframe)
 - `api`      — one backend file `api/handler.rb`, mounted at `/api/ext/<id>/`
 - `skills`   — a `SKILL.md` under `skills/<id>/` (prompt-only capability)
-- `agents`   — a `system_prompt.md`; can reference `panels: [id]` and `skills: [id]`
+- `agents`   — a `system_prompt.md`; can reference `panels: [id]` and `skills: [id]`; `hidden: true` hides from the new-session picker
 - `channels` — an IM adapter
 - `patches`  — monkey-patch a real class (advanced, supply-chain risk)
 - `hooks`    — lifecycle hooks like `before_tool_use` (advanced)
@@ -92,10 +92,12 @@ exactly three capabilities:
 
 ```js
 Clacky.ext.ui.mount(slot, spec, opts)     // inject UI into a named slot
-Clacky.ext.subscribe(event, handler)      // observe host store events (read-only)
+Clacky.ext.subscribe(event, handler)      // observe store events + live session events (read-only)
 Clacky.ext.api.register(name, fn)         // expose a named data source; api.resolve(name)
 ```
 
+**`subscribe(event, handler)`** - two event families: (1) host **store** events (`skills:changed`, `tasks:changed`, `profile:changed`, …) and (2) **live session events** mirrored from the WebSocket stream — conversation (`session:assistant-message`, `session:tool-call`, `session:tool-result`), status/errors (`session:error`, `session:warning`, `session:update`), lifecycle (`session:renamed`, `session:deleted`, …). Payload is `{ sessionId, ...wsFields }`. Full list in the "Core Events" section of the extend-webui docs. Handlers are read-only.
+
 **`ui.mount(slot, spec, opts)`** — `spec` is either `(container, ctx, runtime) => …` or
 `{ create?, render }`. The render function:
 - gets a host-owned `container` DOM element — append into it, **or** return a Node / HTML
@@ -204,6 +206,10 @@ Response helpers: `json` / `text(str)` / `send_data(bytes, content_type:, filena
 - Drive sessions from the backend: `create_session(prompt:, profile:, …)`,
   `submit_task(session_id, prompt)`, `dispatch_to_session(session_id, prompt)` (runs a
   side task on a fork and returns its reply without touching the conversation).
+- `create_session(hidden: true)` creates a session the openclacky session list hides
+  and the 200-session cleanup skips - use it for dedicated extension sessions you
+  manage yourself. Still reachable by `session_id` via `submit_task` /
+  `dispatch_to_session` / `registry.with_session`; forking resets `hidden` to false.
 - Public (no-auth) endpoints: call `public_endpoint("/path")` in the class **and** set
   `public: true` at ext.yml top level — both are required.
 
@@ -294,7 +300,7 @@ contributes:
 classes; swap the body for the real UI, POST to your own route:
 
 ```js
-Clacky.ext.ui.mount("session.aside", function (ctx) {
+Clacky.ext.ui.mount("session.aside", function (container, ctx) {
   var el = document.createElement("div");
   el.style.padding = "16px";
   var input = document.createElement("input");

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

@@ -1,6 +1,9 @@
 id: git
 name: Git
+display_name: Git
+display_name_zh: Git
 description: Changes panel — a friendly view of what the AI changed in the working tree
+description_zh: 变更面板 — 直观查看 AI 在工作区的每一处修改
 version: "0.1.0"
 author: OpenClacky
 homepage: https://www.openclacky.com

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

@@ -1,6 +1,9 @@
 id: meeting
 name: Meeting
+display_name: Meeting
+display_name_zh: 会议
 description: Real-time meeting transcription and AI assistant
+description_zh: 实时会议转录与 AI 助手
 version: "0.1.0"
 author: OpenClacky
 homepage: https://www.openclacky.com

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

@@ -1,6 +1,9 @@
 id: time_machine
 name: Time Machine
+display_name: Time Machine
+display_name_zh: 时间机器
 description: Vertical timeline of session tasks with per-task diff and one-click restore
+description_zh: 会话任务时间轴，支持按任务查看差异并一键还原
 version: "0.1.0"
 author: OpenClacky
 homepage: https://www.openclacky.com
@@ -9,3 +12,4 @@ contributes:
   panels:
     - id: time_machine
       view: panels/time_machine/view.js
+      attach: ["*"]

data/lib/clacky/default_parsers/xlsx_parser.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""xlsx_parser.py — extract an XLSX/XLS workbook to Markdown tables.
+
+Usage:   python3 xlsx_parser.py <file_path>
+Output:  stdout — Markdown tables (UTF-8), one section per non-empty sheet
+         stderr — error messages
+         exit 0 success / 1 failure / 2 dependency missing
+
+Uses openpyxl in read_only mode: a streaming reader that keeps memory
+constant regardless of sheet size, so multi-megabyte worksheets parse in
+seconds instead of exhausting RAM/CPU like a full DOM parse would.
+"""
+# VERSION: 2
+import sys
+
+
+def build_table(rows):
+    width = max(len(r) for r in rows)
+    lines = []
+    for i, r in enumerate(rows):
+        padded = r + [""] * (width - len(r))
+        lines.append("| " + " | ".join(padded) + " |")
+        if i == 0:
+            lines.append("|" + " --- |" * width)
+    return "\n".join(lines)
+
+
+def main():
+    if len(sys.argv) < 2:
+        sys.stderr.write("Usage: xlsx_parser.py <file_path>\n")
+        sys.exit(1)
+    path = sys.argv[1]
+
+    try:
+        from openpyxl import load_workbook
+    except ImportError as e:
+        sys.stderr.write(f"openpyxl not installed: {e}\n")
+        sys.stderr.write("Install with: pip3 install --user openpyxl\n")
+        sys.exit(2)
+
+    try:
+        wb = load_workbook(path, read_only=True, data_only=True)
+    except Exception as e:
+        sys.stderr.write(f"Failed to open workbook: {e}\n")
+        sys.exit(1)
+
+    sections = []
+    for ws in wb.worksheets:
+        rows = []
+        for row in ws.iter_rows(values_only=True):
+            cells = ["" if v is None else str(v) for v in row]
+            if any(c != "" for c in cells):
+                rows.append(cells)
+        if rows:
+            sections.append(f"### {ws.title}\n\n{build_table(rows)}")
+    wb.close()
+
+    if not sections:
+        sys.stderr.write("Spreadsheet appears to be empty\n")
+        sys.exit(1)
+
+    sys.stdout.write("\n\n".join(sections))
+
+
+if __name__ == "__main__":
+    main()

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

@@ -17,20 +17,25 @@ When user wants to create a new Rails project:
 ## Process Steps
 
 ### 0. Ask Project Type and Requirement
-Before doing anything, use `request_user_feedback` to ask the user two things:
-
-```
-project_type: "demo" or "production"
-requirement: one-sentence description of what they want to build
+Before doing anything, call `request_user_feedback` with a structured prompt. Use the following as a guide:
+
+zh:
+```json
+{
+  "question": "请选择项目类型，并用一句话描述你想做什么：",
+  "context": "开始新项目前需要知道项目类型和需求，请先完成填写。",
+  "options": ["⚡ Demo — 无数据库，AI 自由发挥，快速原型", "🏗️ Production — 真实应用，可部署，完整 Rails 配置"]
+}
 ```
 
-Card content:
-- Title: "🚀 New Project"
-- Two options for project type:
-  - **⚡ Demo** — no database, AI builds freely, quick prototype
-  - **🏗️ Production** — real app, ready to deploy, full Rails setup
-- One text input: "Describe your project in one sentence"
-- Confirm button: "Let's go!"
+en:
+```json
+{
+  "question": "Choose a project type and describe what you want to build in one sentence:",
+  "context": "Tell us what kind of project to create so we can get started.",
+  "options": ["⚡ Demo — no database, AI builds freely, quick prototype", "🏗️ Production — real app, ready to deploy, full Rails setup"]
+}
+```
 
 **Based on user's choice:**
 - If **Demo**: do NOT follow the Rails setup steps below. Instead, freely build a simple HTML/CSS/JS (or React) prototype directly in the working directory based on their requirement. Use your creativity.

data/lib/clacky/extension/api_extension.rb

@@ -263,7 +263,7 @@ module Clacky
     # submitted immediately (the session starts running); display_message
     # controls the user-facing bubble shown in place of the raw prompt.
     def create_session(name: nil, prompt: nil, working_dir: nil, profile: "general",
-                       source: :manual, display_message: nil)
+                       source: :manual, display_message: nil, hidden: false)
       error!("server not ready", status: 503) unless @http_server
 
       session_id = @http_server.send(
@@ -271,11 +271,14 @@ module Clacky
         name: name,
         working_dir: working_dir,
         profile: profile,
-        source: source
+        source: source,
+        hidden: hidden
       )
 
       submit_task(session_id, prompt, display_message: display_message) if prompt && !prompt.strip.empty?
 
+      @http_server.send(:broadcast_session_update, session_id)
+
       session_id
     end
 

data/lib/clacky/extension/loader.rb

@@ -422,6 +422,7 @@ module Clacky
                    "description"    => spec["description"].to_s,
                    "description_zh" => spec["description_zh"].to_s,
                    "order"          => spec["order"],
+                   "hidden"         => !!spec["hidden"],
                    "author"         => container[:author],
                    "homepage"       => container[:homepage],
                    "license"        => container[:license],