@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/ai-provider.mjs

@@ -1,4 +1,13 @@
 // src/behaviors/ai-core.ts
+var USAGE_KEYS = ["input", "output", "cacheRead", "cacheWrite", "reasoning", "total"];
+function addUsage(sum2, u) {
+  const out = { ...sum2 };
+  for (const k of USAGE_KEYS) {
+    const v = u[k];
+    if (typeof v === "number" && Number.isFinite(v)) out[k] = (out[k] ?? 0) + v;
+  }
+  return out;
+}
 var svg = (body) => `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
 var ICON_TERMINAL = svg('<path d="m4 17 6-6-6-6"/><path d="M12 19h8"/>');
 var ICON_FILE = svg(
@@ -258,6 +267,13 @@ function contentToText(content) {
   return content.filter((p) => p.type === "text").map((p) => p.text).join("");
 }
 
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/ai-provider.ts
 function isObj2(v) {
   return typeof v === "object" && v !== null;
@@ -439,15 +455,6 @@ async function readHttpError(res, provider) {
   const { type, message } = extractHttpError(raw, status);
   return new AiProviderError({ provider, status, type, message, raw });
 }
-var USAGE_KEYS = ["input", "output", "cacheRead", "cacheWrite", "reasoning", "total"];
-function addUsage(sum2, u) {
-  if (!u) return sum2;
-  for (const k of USAGE_KEYS) {
-    const v = u[k];
-    if (typeof v === "number" && Number.isFinite(v)) sum2[k] = (sum2[k] ?? 0) + v;
-  }
-  return sum2;
-}
 function isAuditEntry(v) {
   return isObj2(v) && typeof v.id === "string" && typeof v.ts === "number" && typeof v.provider === "string" && typeof v.model === "string" && typeof v.baseURL === "string" && typeof v.stream === "boolean" && (v.status === "ok" || v.status === "error") && typeof v.durationMs === "number";
 }
@@ -492,7 +499,7 @@ function createAiAuditor(opts) {
     },
     summary() {
       const sum2 = {};
-      for (const e of entries) addUsage(sum2, e.usage);
+      for (const e of entries) addUsage(sum2, e.usage ?? {});
       return sum2;
     },
     totals() {
@@ -502,7 +509,7 @@ function createAiAuditor(opts) {
       let ttftSum = 0;
       let ttftN = 0;
       for (const e of entries) {
-        addUsage(usage, e.usage);
+        addUsage(usage, e.usage ?? {});
         if (typeof e.cost === "number") cost += e.cost;
         if (e.status === "error") errors++;
         if (typeof e.ttftMs === "number") {
@@ -523,7 +530,7 @@ function createAiAuditor(opts) {
       const out = {};
       for (const e of entries) {
         const key = `${e.provider}/${e.model}`;
-        addUsage(out[key] ??= {}, e.usage);
+        addUsage(out[key] ??= {}, e.usage ?? {});
       }
       return out;
     }
@@ -778,23 +785,18 @@ function joinSignals(a, b) {
     return c.signal;
   }
   const fwd = () => {
+    a.removeEventListener("abort", fwd);
+    b.removeEventListener("abort", fwd);
     if (!c.signal.aborted) c.abort();
   };
   a.addEventListener("abort", fwd, { once: true });
   b.addEventListener("abort", fwd, { once: true });
   return c.signal;
 }
-function dispatchUsageEvent(usage) {
+function dispatchAiEvent(name, detail) {
   if (typeof document === "undefined") return;
   try {
-    document.dispatchEvent(new CustomEvent("icen:ai-usage", { detail: usage, bubbles: true }));
-  } catch {
-  }
-}
-function dispatchDoneEvent(detail) {
-  if (typeof document === "undefined") return;
-  try {
-    document.dispatchEvent(new CustomEvent("icen:ai-done", { detail, bubbles: true }));
+    emitIcen(document, name, detail);
   } catch {
   }
 }
@@ -866,7 +868,31 @@ function createAiClient(options) {
     return { entry, cost };
   }
   const publishUsage = (usage) => {
-    if (Object.keys(usage).length > 0) dispatchUsageEvent(usage);
+    if (Object.keys(usage).length > 0) dispatchAiEvent("icen:ai-usage", usage);
+  };
+  const finalize = (req, streaming, status, usage, error, t0, ttftMs) => {
+    const durationMs = Date.now() - t0;
+    const { cost } = audit(
+      req,
+      streaming,
+      status === "ok" ? "ok" : "error",
+      usage,
+      durationMs,
+      status === "cancelled" ? "\u8BF7\u6C42\u5DF2\u53D6\u6D88" : error,
+      ttftMs
+    );
+    dispatchAiEvent("icen:ai-done", {
+      status,
+      provider: def.id,
+      model: req.model ?? defaultModel,
+      stream: streaming,
+      usage,
+      cost,
+      error: status === "cancelled" ? void 0 : error,
+      durationMs,
+      ttftMs
+    });
+    return cost;
   };
   async function chat(req) {
     const t0 = Date.now();
@@ -908,23 +934,14 @@ function createAiClient(options) {
       }
       const usage = normalizeUsage(usageRaw);
       publishUsage(usage);
-      const { cost } = audit(req, false, "ok", usage, Date.now() - t0);
-      dispatchDoneEvent({
-        status: "ok",
-        provider: def.id,
-        model: req.model ?? defaultModel,
-        stream: false,
-        usage,
-        cost,
-        durationMs: Date.now() - t0
-      });
+      const cost = finalize(req, false, "ok", usage, void 0, t0);
       const result = { text: outText, usage, cost, finishReason, raw: j };
       if (outParts && outParts.length > 0) result.parts = outParts;
       return result;
     } catch (err) {
       const e = normalizeThrown(err);
       audit(req, false, "error", {}, Date.now() - t0, e.message);
-      dispatchDoneEvent({
+      dispatchAiEvent("icen:ai-done", {
         status: e.type === "cancelled" ? "cancelled" : "error",
         provider: def.id,
         model: req.model ?? defaultModel,
@@ -990,26 +1007,15 @@ function createAiClient(options) {
       } finally {
         const usage = normalizeUsage(usageRaw);
         publishUsage(usage);
-        const { cost } = audit(
+        const cost = finalize(
           req,
           true,
-          errorType === "cancelled" ? "error" : status,
+          errorType === "cancelled" ? "cancelled" : status,
           usage,
-          Date.now() - t0,
-          errorType === "cancelled" ? "\u8BF7\u6C42\u5DF2\u53D6\u6D88" : error,
+          error,
+          t0,
           ttftMs
         );
-        dispatchDoneEvent({
-          status: errorType === "cancelled" ? "cancelled" : status,
-          provider: def.id,
-          model: req.model ?? defaultModel,
-          stream: true,
-          usage,
-          cost,
-          error: errorType === "cancelled" ? void 0 : error,
-          durationMs: Date.now() - t0,
-          ttftMs
-        });
         finished = true;
         notify();
         ac.abort();

package/dist/behaviors/ai-threads.d.mts

@@ -0,0 +1,38 @@
+interface AiThreadItem {
+    /** 稳定标识（事件 detail 的 key） */
+    key: string;
+    /** 会话标题 */
+    label: string;
+    /** 分组名（如「今天」/「昨天」/「更早」）；groups 模式下生效 */
+    group?: string;
+    /** 内联 SVG 字符串（lucide 风格 24×24 stroke）；渲染时经 svgIcon() 消毒 */
+    icon?: string;
+    /** 已归档：.is-archived 降透明并沉底（分组模式收进「已归档」组） */
+    archived?: boolean;
+}
+interface AiThreadsModel {
+    items: AiThreadItem[];
+    /** 当前激活会话 key（路由同步） */
+    activeKey?: string;
+    /** 分组模式：true 时按 group 字段分组（组头可折叠）；缺省/false 平铺 */
+    groups?: boolean;
+}
+/**
+ * 快照渲染会话列表：平铺或分组（model.groups）、activeKey 高亮、archived 沉底
+ * （分组模式收进「已归档」组，组头可折叠）。返回挂载容器 el（SSR 原样返回）。
+ */
+declare function renderAiThreads(el: HTMLElement, model: AiThreadsModel): HTMLElement;
+/**
+ * 外部路由同步激活态：el 范围内 data-key === key 的 .ai-thread 挂 .is-active
+ * （+aria-current），其余摘除；key 为空串/null/undefined 时清空全部激活。
+ * 对静态手写 DOM 与 renderAiThreads 产物一视同仁。返回 el。
+ */
+declare function setAiThreadsActive(el: HTMLElement, key: string | null | undefined): HTMLElement;
+/**
+ * 会话列表委托初始化：选择 / 动作挂载点 / 组头折叠。
+ * 幂等（scope 挂 __icenAiThreadsInit）；返回销毁函数（解绑监听 + 复位标记，可重新 init）。
+ * SSR 下为 no-op。
+ */
+declare function initAiThreads(root?: ParentNode): () => void;
+
+export { type AiThreadItem, type AiThreadsModel, initAiThreads, renderAiThreads, setAiThreadsActive };

package/dist/behaviors/ai-threads.mjs

@@ -0,0 +1,319 @@
+// src/behaviors/ai-core.ts
+var svg = (body) => `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
+var ICON_TERMINAL = svg('<path d="m4 17 6-6-6-6"/><path d="M12 19h8"/>');
+var ICON_FILE = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>'
+);
+var ICON_FILE_PEN = svg(
+  '<path d="M12.5 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8l5 5v3.5"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M19 6.5 16.5 4"/><path d="M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z"/>'
+);
+var ICON_FILE_PLUS = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M9 15h6"/><path d="M12 12v6"/>'
+);
+var ICON_TRASH = svg(
+  '<path d="M3 6h18"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"/><path d="M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/><path d="M10 11v6"/><path d="M14 11v6"/>'
+);
+var ICON_SEARCH = svg('<circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/>');
+var ICON_FOLDER_SEARCH = svg(
+  '<path d="M11 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v4"/><circle cx="17" cy="17" r="3"/><path d="m21 21-1.9-1.9"/>'
+);
+var ICON_SCAN_SEARCH = svg(
+  '<path d="M3 7V5a2 2 0 0 1 2-2h2"/><path d="M17 3h2a2 2 0 0 1 2 2v2"/><path d="M21 17v2a2 2 0 0 1-2 2h-2"/><path d="M7 21H5a2 2 0 0 1-2-2v-2"/><circle cx="12" cy="12" r="3"/><path d="m16 16-1.9-1.9"/>'
+);
+var ICON_GLOBE = svg(
+  '<circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/>'
+);
+var ICON_DOWNLOAD = svg(
+  '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/><path d="M12 15V3"/>'
+);
+var ICON_BLOCKS = svg(
+  '<rect width="7" height="7" x="4" y="4" rx="1"/><rect width="7" height="7" x="13" y="4" rx="1"/><rect width="7" height="7" x="4" y="13" rx="1"/><rect width="7" height="7" x="13" y="13" rx="1"/>'
+);
+var ICON_ZAP = svg(
+  '<path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z"/>'
+);
+var ICON_LIST = svg(
+  '<path d="M3 12h.01"/><path d="M3 18h.01"/><path d="M3 6h.01"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M8 6h13"/>'
+);
+var ICON_LIST_CHECKS = svg(
+  '<path d="m3 17 2 2 4-4"/><path d="m3 7 2 2 4-4"/><path d="M13 6h8"/><path d="M13 12h8"/><path d="M13 18h8"/>'
+);
+var ICON_BOT = svg(
+  '<path d="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/>'
+);
+var ICON_CHART = svg(
+  '<path d="M3 3v18h18"/><path d="M7 15l4-6 3 4 5-8"/>'
+);
+var ICON_FILE_TEXT = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M10 9H8"/><path d="M16 13H8"/><path d="M16 17H8"/>'
+);
+function isObj(v) {
+  return typeof v === "object" && v !== null;
+}
+function pickStr(input, keys) {
+  if (!isObj(input)) return void 0;
+  for (const k of keys) {
+    const v = input[k];
+    if (typeof v === "string" && v) return v;
+  }
+  return void 0;
+}
+function pickNum(src, keys) {
+  if (!isObj(src)) return void 0;
+  for (const k of keys) {
+    const v = src[k];
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+  }
+  return void 0;
+}
+function firstLine(s, max = 80) {
+  const line = s.split("\n", 1)[0]?.trim() ?? "";
+  return line.length > max ? `${line.slice(0, max)}\u2026` : line;
+}
+function filePathOf(input) {
+  return pickStr(input, ["file_path", "path", "file", "filename"]);
+}
+var summarizePath = (input) => filePathOf(input);
+function summarizeRead(input) {
+  const p = filePathOf(input);
+  if (!p) return void 0;
+  const offset = pickNum(input, ["offset", "start_line"]);
+  if (offset == null) return p;
+  const limit = pickNum(input, ["limit", "end_line"]);
+  return limit != null ? `${p}:${offset}-${offset + limit}` : `${p}:${offset}`;
+}
+function summarizeShell(input) {
+  const cmd = typeof input === "string" ? input : pickStr(input, ["command", "cmd", "script"]);
+  return cmd ? firstLine(cmd) : void 0;
+}
+function summarizeGrep(input) {
+  const pattern = pickStr(input, ["pattern", "regex", "query"]);
+  const p = filePathOf(input);
+  if (pattern) return p ? `${firstLine(pattern, 40)} \xB7 ${p}` : firstLine(pattern);
+  return p;
+}
+var sum = (fn) => {
+  return (input) => fn(input) ?? "";
+};
+var BUILTIN_KINDS = {
+  shell: { label: "\u547D\u4EE4", icon: ICON_TERMINAL, tint: "accent", summarize: sum(summarizeShell) },
+  read: { label: "\u8BFB\u53D6", icon: ICON_FILE, tint: "info", summarize: sum(summarizeRead) },
+  edit: { label: "\u7F16\u8F91", icon: ICON_FILE_PEN, tint: "warning", summarize: sum(summarizePath) },
+  write: { label: "\u5199\u5165", icon: ICON_FILE_PLUS, tint: "warning", summarize: sum(summarizePath) },
+  rm: { label: "\u5220\u9664", icon: ICON_TRASH, tint: "error", summarize: sum(summarizePath) },
+  grep: { label: "\u641C\u7D22", icon: ICON_SEARCH, tint: "info", summarize: sum(summarizeGrep) },
+  glob: { label: "\u5339\u914D", icon: ICON_FOLDER_SEARCH, tint: "info", summarize: sum((i) => pickStr(i, ["pattern", "glob", "path"])) },
+  browser: { label: "\u6D4F\u89C8", icon: ICON_GLOBE, tint: "accent", summarize: sum((i) => pickStr(i, ["url", "uri", "target"])) },
+  search: { label: "\u68C0\u7D22", icon: ICON_SCAN_SEARCH, tint: "accent", summarize: sum((i) => pickStr(i, ["query", "q", "pattern"])) },
+  fetch: { label: "\u8BF7\u6C42", icon: ICON_DOWNLOAD, tint: "info", summarize: sum((i) => pickStr(i, ["url", "uri", "endpoint"])) },
+  mcp: { label: "MCP", icon: ICON_BLOCKS, tint: "muted", summarize: sum((i) => pickStr(i, ["tool", "method", "name"])) },
+  skill: { label: "\u6280\u80FD", icon: ICON_ZAP, tint: "accent", summarize: sum((i) => pickStr(i, ["skill", "name", "command"])) },
+  todo: {
+    label: "\u5F85\u529E",
+    icon: ICON_LIST,
+    tint: "info",
+    summarize: sum((input) => {
+      const items = input && typeof input === "object" && Array.isArray(input.items) ? input.items : Array.isArray(input) ? input : [];
+      const done = items.filter((it) => it?.status === "done").length;
+      return items.length > 0 ? `${done}/${items.length} \u5B8C\u6210` : "";
+    })
+  },
+  plan: { label: "\u8BA1\u5212", icon: ICON_LIST_CHECKS, tint: "info" },
+  subagent: { label: "\u5B50\u4EE3\u7406", icon: ICON_BOT, tint: "accent", summarize: sum((i) => pickStr(i, ["task", "description", "prompt", "message", "subagent_type"])) },
+  note: { label: "\u7B14\u8BB0", icon: ICON_FILE_TEXT, tint: "muted" },
+  chart: { label: "\u56FE\u8868", icon: ICON_CHART, tint: "info", summarize: sum((i) => pickStr(i, ["title", "name"])) }
+};
+var kindRegistry = new Map(Object.entries(BUILTIN_KINDS));
+function h(tag, className, text) {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text != null) node.textContent = text;
+  return node;
+}
+function svgIcon(svg2) {
+  if (typeof document === "undefined" || typeof DOMParser === "undefined") return null;
+  let parsed;
+  try {
+    parsed = new DOMParser().parseFromString(svg2, "image/svg+xml");
+  } catch {
+    return null;
+  }
+  const root = parsed.documentElement;
+  if (!root || root.tagName.toLowerCase() !== "svg" || parsed.querySelector("parsererror")) {
+    return null;
+  }
+  const sanitize = (el) => {
+    for (const attr of Array.from(el.attributes)) {
+      const name = attr.name.toLowerCase();
+      if (name.startsWith("on")) el.removeAttribute(attr.name);
+      if ((name === "href" || name === "xlink:href") && attr.value.trim().toLowerCase().startsWith("javascript:")) {
+        el.removeAttribute(attr.name);
+      }
+    }
+    for (const child of Array.from(el.children)) {
+      const tag = child.tagName.toLowerCase();
+      if (tag === "script" || tag === "foreignobject") {
+        child.remove();
+        continue;
+      }
+      sanitize(child);
+    }
+  };
+  sanitize(root);
+  return document.importNode(root, true);
+}
+
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
+// src/behaviors/ai-threads.ts
+var ARCHIVED_GROUP = "\u5DF2\u5F52\u6863";
+function dispatch(node, name, detail) {
+  emitIcen(node, name, detail);
+}
+function buildThread(item, activeKey) {
+  const row = h("div", "ai-thread");
+  if (item.key) row.dataset.key = item.key;
+  if (item.archived) row.classList.add("is-archived");
+  if (activeKey != null && item.key === activeKey) {
+    row.classList.add("is-active");
+    row.setAttribute("aria-current", "true");
+  }
+  row.setAttribute("role", "button");
+  row.tabIndex = 0;
+  if (item.icon) {
+    const iconWrap = h("span", "ai-thread-icon");
+    const svg2 = svgIcon(item.icon);
+    if (svg2) iconWrap.appendChild(svg2);
+    row.appendChild(iconWrap);
+  }
+  row.appendChild(h("span", "ai-thread-label", item.label));
+  const action = h("button", "ai-thread-action", "\xB7\xB7\xB7");
+  action.type = "button";
+  action.setAttribute("aria-label", "\u4F1A\u8BDD\u64CD\u4F5C");
+  action.setAttribute("data-thread-action", "rename");
+  row.appendChild(action);
+  return row;
+}
+function renderAiThreads(el, model) {
+  if (typeof document === "undefined") return el;
+  el.textContent = "";
+  const root = h("div", "ai-threads");
+  const items = Array.isArray(model.items) ? model.items : [];
+  const active = items.filter((it) => !it.archived);
+  const archived = items.filter((it) => it.archived);
+  if (model.groups) {
+    const ungrouped = active.filter((it) => !(it.group ?? "").trim());
+    for (const it of ungrouped) root.appendChild(buildThread(it, model.activeKey));
+    const groups = /* @__PURE__ */ new Map();
+    for (const it of active) {
+      const label = (it.group ?? "").trim();
+      if (!label) continue;
+      const list = groups.get(label) ?? [];
+      list.push(it);
+      groups.set(label, list);
+    }
+    for (const [label, list] of groups) {
+      const group = h("div", "ai-threads-group");
+      group.dataset.group = label;
+      const head = h("button", "ai-threads-group-head", label);
+      head.type = "button";
+      head.setAttribute("aria-expanded", "true");
+      group.appendChild(head);
+      const listEl = h("div", "ai-threads-group-list");
+      for (const it of list) listEl.appendChild(buildThread(it, model.activeKey));
+      group.appendChild(listEl);
+      root.appendChild(group);
+    }
+    if (archived.length > 0) {
+      const group = h("div", "ai-threads-group");
+      group.dataset.group = ARCHIVED_GROUP;
+      const head = h("button", "ai-threads-group-head", ARCHIVED_GROUP);
+      head.type = "button";
+      head.setAttribute("aria-expanded", "true");
+      group.appendChild(head);
+      const listEl = h("div", "ai-threads-group-list");
+      for (const it of archived) listEl.appendChild(buildThread(it, model.activeKey));
+      group.appendChild(listEl);
+      root.appendChild(group);
+    }
+  } else {
+    for (const it of active) root.appendChild(buildThread(it, model.activeKey));
+    for (const it of archived) root.appendChild(buildThread(it, model.activeKey));
+  }
+  el.appendChild(root);
+  return el;
+}
+function setAiThreadsActive(el, key) {
+  const threads = Array.from(el.querySelectorAll(".ai-thread"));
+  if (el instanceof HTMLElement && el.classList.contains("ai-thread")) threads.unshift(el);
+  for (const t of threads) {
+    const hit = key != null && key !== "" && t.dataset.key === key;
+    t.classList.toggle("is-active", hit);
+    if (hit) t.setAttribute("aria-current", "true");
+    else t.removeAttribute("aria-current");
+  }
+  return el;
+}
+function initAiThreads(root) {
+  if (typeof document === "undefined") return () => void 0;
+  const scope = root ?? document;
+  const marked = scope;
+  if (marked.__icenAiThreadsInit) return () => void 0;
+  marked.__icenAiThreadsInit = true;
+  const target = scope;
+  const selectThread = (thread) => {
+    const key = thread.dataset.key ?? "";
+    dispatch(thread, "icen:ai-thread-select", { key });
+  };
+  const toggleGroup = (head) => {
+    const group = head.closest(".ai-threads-group");
+    if (!group) return;
+    const open = head.getAttribute("aria-expanded") !== "true";
+    head.setAttribute("aria-expanded", String(open));
+    group.classList.toggle("is-collapsed", !open);
+  };
+  const onClick = (e) => {
+    const t = e.target instanceof Element ? e.target : null;
+    if (!t) return;
+    const action = t.closest(".ai-thread-action");
+    if (action) {
+      const thread2 = action.closest(".ai-thread");
+      if (!thread2) return;
+      dispatch(thread2, "icen:ai-thread-action", { action: "rename", key: thread2.dataset.key ?? "" });
+      return;
+    }
+    const head = t.closest(".ai-threads-group-head");
+    if (head) {
+      toggleGroup(head);
+      return;
+    }
+    const thread = t.closest(".ai-thread");
+    if (thread) selectThread(thread);
+  };
+  const onKeydown = (e) => {
+    const ke = e;
+    if (ke.key !== "Enter" && ke.key !== " ") return;
+    const t = ke.target instanceof Element ? ke.target : null;
+    const thread = t?.closest(".ai-thread");
+    if (!thread || thread.getAttribute("role") !== "button") return;
+    ke.preventDefault();
+    selectThread(thread);
+  };
+  target.addEventListener("click", onClick);
+  target.addEventListener("keydown", onKeydown);
+  return () => {
+    target.removeEventListener("click", onClick);
+    target.removeEventListener("keydown", onKeydown);
+    marked.__icenAiThreadsInit = false;
+  };
+}
+export {
+  initAiThreads,
+  renderAiThreads,
+  setAiThreadsActive
+};

package/dist/behaviors/ai-tool.d.mts

@@ -8,11 +8,19 @@ interface AiSubagentHandle {
     el: HTMLElement;
     update(patch: Partial<AiToolCallModel>): void;
 }
+/** 渲染工具调用卡（整卡挂进传入 el），返回 { el, update }——有生命周期的 render* 返句柄：update(patch) 增量重渲。 */
 declare function renderAiToolCall(el: HTMLElement, model: AiToolCallModel): AiToolCallHandle;
+/** 渲染子智能体卡（activities 递归复用 renderAiToolCall / 自身），返回 { el, update }——有生命周期的 render* 返句柄。 */
 declare function renderAiSubagent(el: HTMLElement, model: AiToolCallModel): AiSubagentHandle;
-/** 初始化 root 下所有工具调用卡（root 自身是 .ai-tool 也算）。重复调用幂等。 */
-declare function initAiTool(root?: ParentNode): void;
-/** 初始化 root 下所有子智能体卡（含嵌套；root 自身是 .ai-subagent 也算）。重复调用幂等。 */
-declare function initAiSubagent(root?: ParentNode): void;
+/**
+ * 初始化 root 下所有工具调用卡（root 自身是 .ai-tool 也算）。重复调用幂等；
+ * 返回销毁函数（复刻 initAiChat 约定：解绑全部卡片监听并复位幂等标记）。
+ */
+declare function initAiTool(root?: ParentNode): () => void;
+/**
+ * 初始化 root 下所有子智能体卡（含嵌套；root 自身是 .ai-subagent 也算）。重复调用幂等；
+ * 返回销毁函数（复刻 initAiChat 约定：解绑全部卡片监听并复位幂等标记）。
+ */
+declare function initAiSubagent(root?: ParentNode): () => void;
 
 export { type AiSubagentHandle, type AiToolCallHandle, initAiSubagent, initAiTool, renderAiSubagent, renderAiToolCall };