openclaw-openagent 1.0.12 → 1.0.14

package/src/plugin-ui/modules/agent-book/panel/agent-data.js

@@ -1,643 +0,0 @@
-// ── Agent 数据（OASN API 适配）──
-//
-// OASN Discovery 端点：
-//   GET  /api/agent-card-categories            分类树
-//   POST /api/agent-cards/search/by-query      自然语言搜索
-//   POST /api/agent-cards/search/by-category   分类浏览
-//   POST /api/agent-cards/search/by-tags       标签筛选
-//
-// 旧 TIM 端点（/api/agents、/api/agents/search）已废弃。
-
-const SEARCH_API = CL.AUTH_API + '/api/agent-cards/search/by-query';
-const SEARCH_BY_CATEGORY_API = CL.AUTH_API + '/api/agent-cards/search/by-category';
-const CATEGORIES_API = CL.AUTH_API + '/api/agent-card-categories';
-
-// ── Mock 数据（仅显式调试时使用）──
-// 格式对齐 OASN AgentCardResponse。生产路径不在 API 失败或空结果时自动回退。
-
-const _MOCK_AGENTS_BY_CATEGORY = {
-  'Travel': [
-    { agent_id: 'mock_travel_planner', agent_type: 'service', name: 'Travel Planner',
-      description: '智能旅行规划助手，根据你的预算和偏好生成个性化行程',
-      MOM: null,
-      tags: [{ tag_id: 't1', name: 'travel' }, { tag_id: 't2', name: 'planning' }],
-      category: ['Travel'], avatar_url: null, visibility: 'public' },
-    { agent_id: 'mock_hotel_finder', agent_type: 'service', name: 'Hotel Finder',
-      description: '全球酒店比价搜索，帮你找到最优住宿方案',
-      MOM: null,
-      tags: [{ tag_id: 't1', name: 'travel' }, { tag_id: 't3', name: 'hotel' }],
-      category: ['Travel'], avatar_url: null, visibility: 'public' },
-    { agent_id: 'mock_flight_deals', agent_type: 'service', name: 'Flight Deals',
-      description: '机票价格追踪与低价提醒，覆盖 200+ 航空公司',
-      MOM: null,
-      tags: [{ tag_id: 't1', name: 'travel' }, { tag_id: 't4', name: 'flight' }],
-      category: ['Travel'], avatar_url: null, visibility: 'public' },
-  ],
-  'Demo': [
-    { agent_id: 'mock_echo_bot', agent_type: 'service', name: 'Echo Bot',
-      description: '回声演示 Agent，原样返回你的输入内容',
-      MOM: null,
-      tags: [{ tag_id: 't5', name: 'demo' }, { tag_id: 't6', name: 'echo' }],
-      category: ['Demo'], avatar_url: null, visibility: 'public' },
-    { agent_id: 'mock_weather', agent_type: 'service', name: 'Weather Now',
-      description: '实时天气查询，支持全球 10 万+ 城市',
-      MOM: null,
-      tags: [{ tag_id: 't5', name: 'demo' }, { tag_id: 't7', name: 'weather' }],
-      category: ['Demo'], avatar_url: null, visibility: 'public' },
-  ],
-  'Tool': [
-    { agent_id: 'mock_translator', agent_type: 'service', name: 'Universal Translator',
-      description: '多语言实时翻译，支持 50+ 语言互译',
-      MOM: null,
-      tags: [{ tag_id: 't8', name: 'tool' }, { tag_id: 't9', name: 'translation' }],
-      category: ['Tool'], avatar_url: null, visibility: 'public' },
-    { agent_id: 'mock_code_reviewer', agent_type: 'service', name: 'Code Reviewer',
-      description: '自动代码审查，检测常见 bug 和安全漏洞',
-      MOM: null,
-      tags: [{ tag_id: 't8', name: 'tool' }, { tag_id: 't10', name: 'code' }],
-      category: ['Tool'], avatar_url: null, visibility: 'public' },
-    { agent_id: 'mock_image_gen', agent_type: 'service', name: 'Image Generator',
-      description: 'AI 图片生成，用文字描述创造精美图像',
-      MOM: null,
-      tags: [{ tag_id: 't8', name: 'tool' }, { tag_id: 't11', name: 'image' }],
-      category: ['Tool'], avatar_url: null, visibility: 'public' },
-    { agent_id: 'mock_summarizer', agent_type: 'service', name: 'Text Summarizer',
-      description: '长文摘要提取，一键获取文章核心要点',
-      MOM: null,
-      tags: [{ tag_id: 't8', name: 'tool' }, { tag_id: 't12', name: 'text' }],
-      category: ['Tool'], avatar_url: null, visibility: 'public' },
-  ],
-};
-
-/** 所有 mock agents 的扁平列表（供搜索用） */
-const _MOCK_AGENTS_ALL = Object.values(_MOCK_AGENTS_BY_CATEGORY).reduce(
-  function(acc, arr) { return acc.concat(arr); }, []
-);
-
-function _setAgentBookError(message) {
-  CL.agentBookLastError = message || '';
-}
-
-function _clearAgentBookError() {
-  CL.agentBookLastError = '';
-}
-
-async function _readApiError(res) {
-  try {
-    const data = await res.json();
-    return data.detail || data.error || ('API ' + res.status);
-  } catch {
-    return 'API ' + res.status;
-  }
-}
-
-/**
- * 实时语义搜索 Agent（OASN: POST /api/agent-cards/search/by-query）
- * @param {string} query - 搜索词（用户输入文本去掉 @ 符号）
- * @param {AbortSignal} [signal] - 可选的 AbortController 信号
- * @returns {Promise<Array>} agent 列表
- */
-async function searchAgents(query, signal) {
-  const q = (query || '').trim();
-  if (!q) {
-    return fetchAgents();
-  }
-  const cacheKey = q.toLowerCase();
-  const now = Date.now();
-  CL._agentSearchCache = CL._agentSearchCache || {};
-  CL._agentSearchInflight = CL._agentSearchInflight || {};
-  CL._agentSearchLogSeen = CL._agentSearchLogSeen || {};
-
-  const cached = CL._agentSearchCache[cacheKey];
-  if (cached && now - cached.ts < CL.CACHE_TTL) {
-    return cached.results;
-  }
-  if (!signal && CL._agentSearchInflight[cacheKey]) {
-    return CL._agentSearchInflight[cacheKey];
-  }
-
-  const runSearch = async function() {
-  try {
-    const res = await fetch(SEARCH_API, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ query: q, agentTypes: ['service'], pageSize: 10 }),
-      signal,
-    });
-    if (!res.ok) {
-      _setAgentBookError(await _readApiError(res));
-      return _isMockEnabled() ? _mockSearch(q).map(function(agent) {
-        return mapAgent(agent, { matchType: 'query', query: q });
-      }) : [];
-    }
-    const data = await res.json();
-    // OASN SearchResponse: 真实 API 用 agentCards，mock 用 agent_cards
-    let list = data.agentCards || data.agent_cards || [];
-    if (!list.length && _isMockEnabled()) {
-      list = _mockSearch(q);
-    }
-    const mapped = list.map(function(agent) {
-      return mapAgent(agent, { matchType: 'query', query: q });
-    });
-    _clearAgentBookError();
-    CL._agentSearchCache[cacheKey] = { ts: Date.now(), results: mapped };
-    const logKey = cacheKey + '|' + mapped.map(a => a.id || a.name || '').join(',');
-    if (!CL._agentSearchLogSeen[logKey]) {
-      CL._agentSearchLogSeen[logKey] = true;
-      console.log('[cl-diag][agent-search] q=' + q +
-        ' raw=' + list.length +
-        ' mapped=' + mapped.length +
-        ' ids=' + mapped.map(a => a.id || 'null').join('|') +
-        ' names=' + mapped.map(a => a.name || 'null').join('|'));
-    }
-    return mapped;
-  } catch (err) {
-    if (err.name === 'AbortError') return []; // 正常取消
-    console.warn('[openagent] searchAgents error:', err);
-    _setAgentBookError(err.message || 'Agent Book API error');
-    return [];
-  }
-  };
-
-  if (!signal) {
-    CL._agentSearchInflight[cacheKey] = runSearch().finally(function() {
-      delete CL._agentSearchInflight[cacheKey];
-    });
-    return CL._agentSearchInflight[cacheKey];
-  }
-  return runSearch();
-}
-
-/**
- * 获取默认 Agent 列表（默认展示用）。
- * OASN 没有"列出全部"接口，从缓存的 sections 中提取，或加载分类后取首批。
- */
-async function fetchAgents() {
-  const now = Date.now();
-  if (CL.agentCache.length > 0 && now - CL.lastFetchTime < CL.CACHE_TTL) {
-    return CL.agentCache;
-  }
-
-  // 优先从 sections 缓存提取
-  if (CL.agentSectionsCache && CL.agentSectionsCache.length > 0) {
-    const all = [];
-    CL.agentSectionsCache.forEach(function(s) {
-      if (s.children && s.children.length > 0) {
-        s.children.forEach(function(c) { all.push.apply(all, c.agents || []); });
-      } else {
-        all.push.apply(all, s.agents || []);
-      }
-    });
-    CL.agentCache = all;
-    return all;
-  }
-
-  // 无缓存：先加载 sections 再提取
-  const sections = await fetchAgentSections();
-  const all = [];
-  sections.forEach(function(s) {
-    if (s.children && s.children.length > 0) {
-      s.children.forEach(function(c) { all.push.apply(all, c.agents || []); });
-    } else {
-      all.push.apply(all, s.agents || []);
-    }
-  });
-  CL.agentCache = all;
-  return all;
-}
-
-/**
- * 获取服务端分类后的 Agent 列表。
- * OASN: GET /api/agent-card-categories → 分类树
- *       POST /api/agent-cards/search/by-category → 每个分类的 agent 列表
- */
-async function fetchAgentSections() {
-  const now = Date.now();
-  if (CL.agentSectionsCache && now - CL.lastFetchTime < CL.CACHE_TTL) {
-    return CL.agentSectionsCache;
-  }
-  if (CL._agentSectionsInflight) {
-    return CL._agentSectionsInflight;
-  }
-
-  CL._agentSectionsInflight = (async function() {
-  try {
-    // Step 1: 获取分类树
-    let categories;
-    try {
-      const catRes = await fetch(CATEGORIES_API + '?agent_type=service');
-      if (!catRes.ok) throw new Error(await _readApiError(catRes));
-      const catData = await catRes.json();
-      // OASN CategoryTreeResponse: { categories: CategoryNodeResponse[], updated_at }
-      categories = catData.categories || [];
-      _clearAgentBookError();
-    } catch (err) {
-      console.warn('[openagent] fetchAgentSections categories error:', err);
-      _setAgentBookError(err.message || 'Agent Book API error');
-      categories = [];
-    }
-    if ((!Array.isArray(categories) || categories.length === 0) && _isMockEnabled()) {
-      categories = _MOCK_CATEGORIES;
-    }
-    if (!Array.isArray(categories) || categories.length === 0) {
-      CL.agentCache = [];
-      CL.agentSectionsCache = [];
-      CL.lastFetchTime = now;
-      return [];
-    }
-
-    // Step 2 & 3: 加载各叶子分类的 agent 列表。
-    // openPanel 和 textarea input 可能在同一轮 @ mention 中同时触发默认列表加载；
-    // inflight 复用避免重复请求，统一限并发避免按父分类串行拖慢首屏。
-    // 结构：{ title, children: [{title, agents}] } 或 { title, agents } (顶层即叶子)
-    const sections = [];
-    const allAgents = [];
-    const CONCURRENCY = 6;
-    const groups = categories.map(function(group) {
-      return {
-        group: group,
-        leaves: (group.children && group.children.length > 0)
-          ? group.children
-          : [group],
-        childSections: [],
-      };
-    });
-    const jobs = [];
-
-    groups.forEach(function(groupState) {
-      groupState.leaves.forEach(function(cat) {
-        jobs.push({ groupState: groupState, cat: cat });
-      });
-    });
-
-    let results = await fetchCategoryAgentsBatch(jobs);
-    if (!results) {
-      results = [];
-      for (let i = 0; i < jobs.length; i += CONCURRENCY) {
-        const batch = jobs.slice(i, i + CONCURRENCY);
-        const batchResults = await Promise.all(batch.map(function(job) {
-          return fetchCategoryAgents(_categoryId(job.cat), job.cat.name);
-        }));
-        results.push.apply(results, batchResults);
-      }
-    }
-
-    jobs.forEach(function(job, idx) {
-      const cat = job.cat;
-      const mapped = results[idx];
-      if (mapped.length > 0) {
-        allAgents.push.apply(allAgents, mapped);
-        job.groupState.childSections.push({
-          title: cat.name || cat.categoryId || cat.category_id || '',
-          agents: mapped,
-        });
-      }
-    });
-
-    groups.forEach(function(groupState) {
-      const group = groupState.group;
-      const childSections = groupState.childSections;
-      if (childSections.length === 0) return;
-
-      if (group.children && group.children.length > 0) {
-        // 有子分类 → 层级结构（父标题 + 子 sections）
-        sections.push({
-          title: group.name || group.categoryId || group.category_id || '',
-          children: childSections,
-        });
-      } else {
-        // 顶层即叶子 → 平铺（无父标题）
-        sections.push({
-          title: childSections[0].title,
-          children: [],
-          agents: childSections[0].agents,
-        });
-      }
-    });
-
-    CL.agentCache = allAgents;
-    CL.agentSectionsCache = sections;
-    CL.lastFetchTime = now;
-    _clearAgentBookError();
-    console.log('[cl-diag][agent-sections]', {
-      rawCount: allAgents.length,
-      sectionCount: sections.length,
-      sections: sections.map(function(s) {
-        if (s.children && s.children.length > 0) {
-          return s.title + '[' + s.children.map(function(c) { return c.title + ':' + c.agents.length; }).join(',') + ']';
-        }
-        return s.title + ':' + (s.agents ? s.agents.length : 0);
-      }),
-    });
-    return sections;
-  } catch (err) {
-    console.warn('[openagent] fetchAgentSections error:', err);
-    _setAgentBookError(err.message || 'Agent Book API error');
-    return CL.agentSectionsCache || (_isMockEnabled() ? _MOCK_CATEGORIES.map(function(c) {
-      return { title: c.name, children: [], agents: (_getMockAgentsForCategory(c.name) || []).map(mapAgent) };
-    }) : []);
-  }
-  })();
-
-  return CL._agentSectionsInflight.finally(function() {
-    CL._agentSectionsInflight = null;
-  });
-}
-
-/**
- * 按分类 ID 加载 agent 列表。
- * POST /api/agent-cards/search/by-category { category: [category_id], agentTypes: ['service'] }
- * @param {string} categoryId - 分类 ID（如 "cat_demo_chat"）
- * @param {string} displayName - 分类显示名（用于 mock fallback 匹配）
- */
-async function fetchCategoryAgents(categoryId, displayName) {
-  try {
-    const res = await fetch(SEARCH_BY_CATEGORY_API, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        category: [categoryId],
-        agentTypes: ['service'],
-        pageSize: 50,
-      }),
-    });
-    if (!res.ok) {
-      if (!_isMockEnabled()) return [];
-      const mock = _getMockAgentsForCategory(displayName) || _getMockAgentsForCategory(categoryId);
-      return mock.map(mapAgent);
-    }
-    const data = await res.json();
-    // OASN 真实 API 用 camelCase（agentCards），mock 用 snake_case（agent_cards）
-    let list = data.agentCards || data.agent_cards || [];
-    if (!list.length && _isMockEnabled()) {
-      list = _getMockAgentsForCategory(displayName) || _getMockAgentsForCategory(categoryId) || [];
-    }
-    return list.map(mapAgent);
-  } catch (err) {
-    console.warn('[openagent] fetchCategoryAgents(' + categoryId + ') error:', err);
-    if (!_isMockEnabled()) return [];
-    const mock = _getMockAgentsForCategory(displayName) || _getMockAgentsForCategory(categoryId);
-    return mock.map(mapAgent);
-  }
-}
-
-function _categoryId(cat) {
-  return cat && (cat.categoryId || cat.category_id || cat.id || '');
-}
-
-function _agentCategoryIds(agent) {
-  const categories = Array.isArray(agent && agent.category)
-    ? agent.category
-    : (agent && agent.category ? [agent.category] : []);
-  return categories.map(function(value) { return String(value || '').trim(); }).filter(Boolean);
-}
-
-function _uniqueJobCategoryIds(jobs) {
-  const seen = Object.create(null);
-  const ids = [];
-  jobs.forEach(function(job) {
-    const id = _categoryId(job.cat);
-    if (!id || seen[id]) return;
-    seen[id] = true;
-    ids.push(id);
-  });
-  return ids;
-}
-
-async function fetchCategoryAgentsBatch(jobs) {
-  const categoryIds = _uniqueJobCategoryIds(jobs);
-  if (categoryIds.length === 0) return [];
-
-  try {
-    const res = await fetch(SEARCH_BY_CATEGORY_API, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        category: categoryIds,
-        agentTypes: ['service'],
-        pageSize: categoryIds.length * 50,
-      }),
-    });
-    if (!res.ok) return null;
-
-    const data = await res.json();
-    let list = data.agentCards || data.agent_cards || [];
-    if (!list.length && _isMockEnabled()) {
-      return jobs.map(function(job) {
-        const cat = job.cat;
-        const mock = _getMockAgentsForCategory(cat.name) || _getMockAgentsForCategory(_categoryId(cat));
-        return mock.map(mapAgent);
-      });
-    }
-
-    return jobs.map(function(job) {
-      const id = _categoryId(job.cat);
-      const seen = Object.create(null);
-      return list.filter(function(agent) {
-        const agentId = agent && (agent.agentId || agent.agent_id || agent.id || '');
-        if (agentId && seen[agentId]) return false;
-        if (_agentCategoryIds(agent).indexOf(id) < 0) return false;
-        if (agentId) seen[agentId] = true;
-        return true;
-      }).map(mapAgent);
-    });
-  } catch (err) {
-    console.warn('[openagent] fetchCategoryAgentsBatch error:', err);
-    return null;
-  }
-}
-
-/**
- * Mock 分类树（OASN CategoryTreeResponse.categories 格式）
- * API 不可用时 fallback 到这份数据，确保 UI 始终有内容可渲染。
- */
-const _MOCK_CATEGORIES = Object.keys(_MOCK_AGENTS_BY_CATEGORY).map(function(key) {
-  return {
-    category_id: 'mock_cat_' + key.toLowerCase(),
-    name: key,
-    children: [],
-  };
-});
-
-/**
- * Mock 搜索：在 _MOCK_AGENTS_ALL 中做大小写不敏感的子串匹配
- * （name / description / tag name / category）
- */
-function _mockSearch(q) {
-  const needle = (q || '').toLowerCase();
-  if (!needle) return _MOCK_AGENTS_ALL.slice();
-  return _MOCK_AGENTS_ALL.filter(function(a) {
-    if ((a.name || '').toLowerCase().indexOf(needle) >= 0) return true;
-    if ((a.description || '').toLowerCase().indexOf(needle) >= 0) return true;
-    if ((a.category || []).some(function(c) { return c.toLowerCase().indexOf(needle) >= 0; })) return true;
-    if (Array.isArray(a.tags) && a.tags.some(function(t) {
-      return (t && t.name || '').toLowerCase().indexOf(needle) >= 0;
-    })) return true;
-    return false;
-  });
-}
-
-function _isMockEnabled() {
-  if (typeof CL !== 'undefined' && CL.AGENT_BOOK_MOCK === true) return true;
-  try {
-    return window.localStorage && window.localStorage.getItem('openagent.agentBookMock') === '1';
-  } catch {
-    return false;
-  }
-}
-
-/** 从 mock 数据中按分类名或 ID 提取 agents */
-// 叶子分类名 → 父分类 mock key 的映射
-const _CATEGORY_ALIAS = {
-  'Chat': 'Demo', 'Tool': 'Demo',
-  'Trip Planner': 'Travel', 'Booking': 'Travel',
-  'Code': 'Tool', 'Code Review': 'Tool',
-};
-
-function _getMockAgentsForCategory(nameOrId) {
-  // 精确匹配
-  if (_MOCK_AGENTS_BY_CATEGORY[nameOrId]) {
-    return _MOCK_AGENTS_BY_CATEGORY[nameOrId];
-  }
-  // alias 匹配（叶子 → 父分类）
-  const alias = _CATEGORY_ALIAS[nameOrId];
-  if (alias && _MOCK_AGENTS_BY_CATEGORY[alias]) {
-    return _MOCK_AGENTS_BY_CATEGORY[alias];
-  }
-  // 大小写不敏感匹配
-  const key = Object.keys(_MOCK_AGENTS_BY_CATEGORY).find(function(k) {
-    return k.toLowerCase() === nameOrId.toLowerCase();
-  });
-  return key ? _MOCK_AGENTS_BY_CATEGORY[key] : [];
-}
-
-/** 统一的 agent 数据映射（OASN AgentCardResponse 格式） */
-function _uniqCompact(list) {
-  const seen = Object.create(null);
-  const out = [];
-  (list || []).forEach(item => {
-    const value = String(item || '').trim();
-    if (!value) return;
-    const key = value.toLowerCase();
-    if (seen[key]) return;
-    seen[key] = true;
-    out.push(value);
-  });
-  return out;
-}
-
-function _normalizeSkills(skills) {
-  if (!Array.isArray(skills)) return [];
-  return skills.map(s => ({
-    id: s && (s.id || s.skill_id || s.skillId) || '',
-    name: s && s.name || '',
-    description: s && s.description || '',
-    tags: Array.isArray(s && s.tags) ? s.tags.filter(Boolean) : []
-  }));
-}
-
-/**
- * OASN AgentCardResponse → 前端 agent 对象
- *
- * AgentCardResponse 字段:
- *   agent_id, agent_type, name, description, MOM,
- *   tags: [{tag_id, name}], category: string[], avatar_url, visibility
- */
-function mapAgent(a, meta) {
-  meta = meta || {};
-  const agentId = a.agent_id || a.agentId || a.id || a.tag ||
-    a.user_id || a.userId || a.identifier || a.tim_user_id || a.timUserId || '';
-  const avatarFull = a.avatar_url || a.avatarUrl || a.avatar || null;
-
-  // OASN tags: [{tag_id, name}] → 提取 name 列表
-  const tagNames = Array.isArray(a.tags)
-    ? a.tags.map(function(t) { return (typeof t === 'string') ? t : (t && t.name) || ''; }).filter(Boolean)
-    : [];
-
-  const skills = _normalizeSkills(a.skills);
-  const skillTags = skills.reduce((acc, s) => acc.concat(s.tags || [], s.name || ''), []);
-
-  // OASN category: string[] → 取第一个作为主分类
-  const categoryArray = Array.isArray(a.category) ? a.category : (a.category ? [a.category] : []);
-  const primaryCategory = categoryArray[0] || '';
-
-  const tags = _uniqCompact([]
-    .concat(tagNames)
-    .concat(skillTags)
-    .concat(categoryArray)
-    .concat(a.group || '', a.scene || '', a.type || a.agent_type || a.agentType || ''));
-
-  if (!agentId) {
-    console.warn('[cl-diag][agent-map] missing identifier', {
-      name: a.name,
-      keys: Object.keys(a || {}),
-      raw: a,
-    });
-  }
-  const mapped = {
-    id: agentId,
-    agent_id: agentId,
-    name: a.name || 'Unknown',
-    tag: agentId,
-    bio: a.description || a.MOM || '',
-    skills: skills,
-    specialties: skills.map(s => s.name).filter(Boolean).join(', ') || '',
-    category: primaryCategory,
-    type: a.agent_type || a.type || a.agentType || '',
-    tags: tags,
-    avatar: avatarFull,
-    claws: a.stars || 0,
-    credit: a.credit_per_1k || 0.3,
-    calls: a.total_calls || 0,
-    owner: a.provider ? (typeof a.provider === 'string' ? a.provider : a.provider.name) : '',
-    provider: a.provider || null,
-    version: a.version || '',
-    score: typeof a.score === 'number' ? a.score : null,
-    matchType: meta.matchType || a.match_type || '',
-    searchQuery: meta.query || '',
-    visibility: a.visibility || 'public',
-  };
-  if (CL && typeof CL.storeAgentIdentity === 'function') {
-    CL.storeAgentIdentity(mapped);
-  }
-  return mapped;
-}
-
-// ── 工具函数 ──
-
-function formatNumber(n) {
-  if (n == null) return '0';
-  if (n >= 1000) return (n / 1000).toFixed(1) + 'K';
-  return String(n);
-}
-
-function avatarUrl(agent) {
-  if (agent.avatar) {
-    // Avatar paths from API are relative to auth upstream (e.g. /avatars/oc1.png).
-    // Route through Gateway proxy: /plugins/openagent/avatars/oc1.png
-    if (agent.avatar.startsWith('/')) return CL.AUTH_API + agent.avatar;
-    if (agent.avatar.startsWith('http')) return agent.avatar;
-    return CL.AUTH_API + '/' + agent.avatar;
-  }
-  return './icon.png';
-}
-
-const ESC_MAP = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' };
-function escHtml(s) {
-  if (!s) return '';
-  return String(s).replace(/[&<>"']/g, c => ESC_MAP[c]);
-}
-
-// DOM 构建工具（全局共用）
-function _el(tag, cls, styles) {
-  const e = document.createElement(tag);
-  if (cls) e.className = cls;
-  if (styles) Object.assign(e.style, styles);
-  return e;
-}
-
-function _text(tag, cls, text, styles) {
-  const e = _el(tag, cls, styles);
-  e.textContent = text;
-  return e;
-}