@harness-mix/cli 0.1.5 → 0.1.6

package/src/native-ui/renderer-extension/src/renderer-harness-mentions.ts

@@ -1,15 +1,145 @@
 import { collaborationIcon } from './collaboration-icon.js';
-export interface CollaborationAgent { id: string; name: string; available: boolean; lead: boolean }
-export interface CollaborationSession { id: string; title: string; harnessId: string; cwd: string; running: boolean | null }
-export interface CollaborationMentionCatalog { agents: CollaborationAgent[]; sessions: CollaborationSession[]; canDelegate?: boolean }
-type MentionEntry = ({ kind: 'agent' } & CollaborationAgent) | ({ kind: 'session' } & CollaborationSession);
 
-const entryKey = (entry: MentionEntry): string => entry.kind === 'agent' ? `agent:${entry.id}` : `session:${entry.id}`;
+export interface CollaborationAgent {
+  id: string;
+  name: string;
+  available: boolean;
+  lead: boolean;
+  description?: string;
+}
 
-// Encode an entry as the @agent literal the Host expects in the submitted text.
-const entryLiteral = (entry: MentionEntry): string => entry.kind === 'agent'
-  ? `@${entry.id} `
-  : `@[${entry.title.replace(/[\[\]()\r\n]/g, '')}](harness-mix://session/${entry.id}) `;
+export interface CollaborationSession {
+  id: string;
+  title: string;
+  harnessId: string;
+  cwd: string;
+  running: boolean | null;
+}
+
+export interface NativeCodexOption {
+  id: string;
+  title: string;
+  description: string;
+  category: string;
+  icon?: string;
+  action?: string;
+}
+
+export interface CollaborationMentionCatalog {
+  agents: CollaborationAgent[];
+  sessions: CollaborationSession[];
+  codexOptions?: NativeCodexOption[];
+  canDelegate?: boolean;
+}
+
+type MentionEntry =
+  | ({ kind: 'agent' } & CollaborationAgent)
+  | ({ kind: 'session' } & CollaborationSession)
+  | ({ kind: 'codex' } & NativeCodexOption);
+
+const entryKey = (entry: MentionEntry): string => {
+  if (entry.kind === 'agent') return `agent:${entry.id}`;
+  if (entry.kind === 'session') return `session:${entry.id}`;
+  return `codex:${entry.id}`;
+};
+
+// Encode an entry as the #agent literal the Host expects in the submitted text.
+const entryLiteral = (entry: MentionEntry): string => {
+  if (entry.kind === 'agent') return `#${entry.id} `;
+  if (entry.kind === 'session') return `#[${entry.title.replace(/[\[\]()\r\n]/g, '')}](harness-mix://session/${entry.id}) `;
+  return '';
+};
+
+const AGENT_DESCRIPTIONS: Record<string, string> = {
+  codex: '官方 Codex CLI 原生协同',
+  'codex-cli': '官方 Codex CLI 原生协同',
+  pi: '轻量快速原生编码 Harness',
+  omp: 'Oh My Pi 增强版交互 Harness',
+  dsh: 'DeepSeek Harness 原生深度推理与工具调用',
+  'deepseek-harness': 'DeepSeek Harness 原生深度推理与工具调用',
+  claude: 'Anthropic Claude Code 原生协同',
+  'claude-code': 'Anthropic Claude Code 原生协同',
+  antigravity: 'Google Antigravity 2.0 原生 Harness',
+  opencode: '开源自主编码智能体',
+  grok: 'xAI Grok 原生协同与深度推理',
+  openclaw: 'OpenClaw 个人 AI 自主智能体',
+  hermes: 'Nous Research Hermes 自我迭代智能体',
+  qoder: 'Qoder 编程助手',
+  codebuddy: 'CodeBuddy 原生智能体',
+  zcode: 'ZCode 自动化工程代理',
+  trae: 'Trae 原生协同',
+  'kiro-cli': 'Kiro CLI 智能编程',
+  'cursor-cli': 'Cursor CLI 原生协同',
+};
+
+const AGENT_COLORS: Record<string, string> = {
+  codex: '#3b82f6',
+  'codex-cli': '#3b82f6',
+  'codex-harness': '#3b82f6',
+  grok: '#8b5cf6',
+  opencode: '#a855f7',
+  'claude-code': '#ea580c',
+  claude: '#ea580c',
+  antigravity: '#0284c7',
+  pi: '#d97706',
+  omp: '#d97706',
+  dsh: '#2563eb',
+  'deepseek-harness': '#2563eb',
+  'kiro-cli': '#db2777',
+  openclaw: '#dc2626',
+  hermes: '#059669',
+  qoder: '#7c3aed',
+  codebuddy: '#0891b2',
+  zcode: '#4f46e5',
+  trae: '#0284c7',
+  'cursor-cli': '#475569',
+};
+
+function getAgentColor(agentId: string): string {
+  const normalized = agentId.toLowerCase();
+  for (const [key, color] of Object.entries(AGENT_COLORS)) {
+    if (normalized.includes(key)) return color;
+  }
+  return '#6366f1';
+}
+
+const DEFAULT_CODEX_OPTIONS: NativeCodexOption[] = [
+  { id: 'files', title: '文件和文件夹', description: '从本地工作区添加文件或文件夹上下文', category: '添加', icon: '📎', action: 'files' },
+  { id: 'snapshot', title: '附加智能快照', description: '截取当前屏幕或窗口附加至上下文', category: '添加', icon: '📸', action: 'snapshot' },
+  { id: 'work', title: '在项目中使用 Work', description: '为新聊天选择项目', category: '添加', icon: '📁', action: 'work' },
+  { id: 'goal', title: '目标', description: '设置要持续追求的目标', category: '添加', icon: '🎯', action: 'goal' },
+  { id: 'plan', title: '计划模式', description: '开启计划模式', category: '添加', icon: '💡', action: 'plan' },
+  { id: 'sketch', title: '绘图', description: '绘制草图', category: '添加', icon: '✏️', action: 'sketch' },
+  { id: 'canva', title: 'Canva', description: 'Create, review, edit designs', category: '插件', icon: '🎨', action: 'plugin-canva' },
+  { id: 'github', title: 'GitHub', description: 'Triage PRs, issues, CI, and publish flows', category: '插件', icon: '🐙', action: 'plugin-github' },
+  { id: 'product-design', title: 'Product Design', description: 'Explore and prototype ideas', category: '插件', icon: '📐', action: 'plugin-product-design' },
+];
+
+function getCodexNativeOptions(): NativeCodexOption[] {
+  const overlay = document.querySelector('[data-composer-overlay-floating-ui="true"]');
+  if (!overlay) return DEFAULT_CODEX_OPTIONS;
+  const buttons = [...overlay.querySelectorAll<HTMLElement>('button, [role="option"]')];
+  if (!buttons.length) return DEFAULT_CODEX_OPTIONS;
+  const scanned: NativeCodexOption[] = [];
+  for (let i = 0; i < buttons.length; i++) {
+    const btn = buttons[i];
+    if (!btn) continue;
+    const text = (btn.innerText || btn.textContent || '').trim();
+    if (!text) continue;
+    const parts = text.split('\n').map(s => s.trim()).filter(Boolean);
+    const title = parts[0] || `选项 ${i + 1}`;
+    const description = parts.slice(1).join(' ') || '';
+    scanned.push({
+      id: `native-${i}`,
+      title,
+      description,
+      category: i < 6 ? '添加' : '插件',
+      icon: title.includes('文件') ? '📎' : title.includes('快照') ? '📸' : title.includes('计划') ? '💡' : title.includes('绘图') ? '✏️' : '🧩',
+      action: `native-click-${i}`,
+    });
+  }
+  return scanned.length ? scanned : DEFAULT_CODEX_OPTIONS;
+}
 
 /** Adds native-Harness suggestions while preserving the original composer editor. */
 export function installHarnessMentions(load: (editor: Element, query: string) => Promise<CollaborationMentionCatalog>) {
@@ -20,30 +150,84 @@ export function installHarnessMentions(load: (editor: Element, query: string) =>
   menu.style.cssText = 'position:fixed;z-index:2147483647;box-sizing:border-box;max-height:320px;overflow:auto;width:340px;max-width:calc(100vw - 16px);padding:6px;border:1px solid #8884;border-radius:12px;background:Canvas;color:CanvasText;box-shadow:0 8px 30px #0002;font:13px system-ui';
   menu.hidden = true;
   document.body.append(menu);
-  // The native @ surface and our Harness picker otherwise open at the same time.
-  // Scope suppression to this composer and this active mention only.
+
+  // Enable inline text-box layout so selected mentions appear inside the text box on the same line as the cursor.
+  // We NEVER suppress Codex native @ floating UI since Harness Mix is triggered by #.
   const style = document.createElement('style');
-  style.textContent = '[data-harness-mix-mention-active] [data-composer-overlay-floating-ui="true"]{display:none!important}';
+  style.textContent = `
+    [data-harness-mix-has-mentions="true"] {
+      display: flex !important;
+      flex-wrap: wrap !important;
+      align-items: baseline !important;
+      gap: 8px !important;
+    }
+    [data-harness-mix-has-mentions="true"] > [data-harness-mix-selected-mentions] {
+      display: inline-flex !important;
+      align-items: center !important;
+      gap: 8px !important;
+      flex-wrap: wrap !important;
+      vertical-align: baseline !important;
+      line-height: 1.5 !important;
+    }
+    [data-harness-mix-has-mentions="true"] > textarea,
+    [data-harness-mix-has-mentions="true"] > [contenteditable="true"],
+    [data-harness-mix-has-mentions="true"] > .ProseMirror {
+      display: inline-block !important;
+      width: auto !important;
+      min-width: 60px !important;
+      flex: 1 1 auto !important;
+      margin: 0 !important;
+      padding: 0 !important;
+      vertical-align: baseline !important;
+    }
+    [data-harness-mix-mention-badge]:hover {
+      background: rgba(128, 128, 128, 0.14) !important;
+    }
+  `;
   document.head.append(style);
+
   let activeComposer: Element | null = null;
   let generation = 0, disposed = false, selected = 0;
   let editor: HTMLTextAreaElement | HTMLElement | null = null;
   let range: Range | null = null, start = 0, end = 0;
   let entries: MentionEntry[] = [];
-  let matches: MentionEntry[] = [], activeKind: 'agent' | 'session' = 'agent', canDelegate = true;
+  let matches: MentionEntry[] = [];
+  let activeKind: 'agent' | 'codex' | 'session' = 'agent';
+  let canDelegate = true;
   const catalogs = new Map<HTMLElement, CollaborationMentionCatalog>();
   const badges = new Map<HTMLElement, HTMLElement>();
 
-  // Per-editor mention state, decoupled from editor text so the literal
-  // @agent handles never leak into the visible composer.
-  const selections = new Map<HTMLElement, Map<string, MentionEntry>>();
+  // Per-session mention state keyed by conversation target, so mentions persist
+  // when switching between conversations and returning.
+  const sessionSelections = new Map<string, Map<string, MentionEntry>>();
+
+  const conversationKeyFor = (target: HTMLElement): string => {
+    const composer = target.closest('[data-codex-composer-root]');
+    if (!composer) return (target as unknown as { __harnessMixEditorKey?: string }).__harnessMixEditorKey || 'default';
+    const portal = composer.querySelector('[data-above-composer-portal]');
+    const portalId = portal?.getAttribute('data-above-composer-conversation-id');
+    if (portalId) return `conversation:${portalId}`;
+    const convEl = composer.closest('[data-conversation-id]') || composer.querySelector('[data-conversation-id]');
+    const convId = convEl?.getAttribute('data-conversation-id');
+    if (convId) return `conversation:${convId}`;
+    const draftId = composer.getAttribute('data-composer-draft-id');
+    if (draftId) return `draft:${draftId}`;
+    const all = composer.querySelectorAll('textarea, [contenteditable="true"]');
+    if (all.length > 1) {
+      const index = Array.from(all).indexOf(target);
+      return `editor:${index >= 0 ? index : 'default'}`;
+    }
+    return 'default';
+  };
+
   const selectionsFor = (target: HTMLElement): Map<string, MentionEntry> => {
-    let perEditor = selections.get(target);
-    if (!perEditor) {
-      perEditor = new Map();
-      selections.set(target, perEditor);
+    const key = conversationKeyFor(target);
+    let perSession = sessionSelections.get(key);
+    if (!perSession) {
+      perSession = new Map();
+      sessionSelections.set(key, perSession);
     }
-    return perEditor;
+    return perSession;
   };
 
   const replaceSelectionWith = (target: HTMLElement, replacement: string): boolean => {
@@ -73,111 +257,241 @@ export function installHarnessMentions(load: (editor: Element, query: string) =>
   };
 
   const syncBadges = (target: HTMLElement) => {
-    for (const [old, strip] of badges) if (!old.isConnected) { strip.remove(); badges.delete(old); catalogs.delete(old); }
-    const perEditor = selections.get(target);
+    for (const [old, strip] of badges) {
+      if (!old.isConnected) {
+        strip.remove();
+        badges.delete(old);
+        catalogs.delete(old);
+      }
+    }
+    const perEditor = selectionsFor(target);
     const hasAny = !!perEditor && perEditor.size > 0;
     let strip = badges.get(target);
+
+    // Toggle container flex layout so mentions strip and editor input share the exact same line inside the text box like Image 2.
+    const container = target.parentElement;
+    if (hasAny) {
+      container?.setAttribute('data-harness-mix-has-mentions', 'true');
+    } else {
+      container?.removeAttribute('data-harness-mix-has-mentions');
+    }
+
     if (!strip && !hasAny) return;
     if (!strip) {
-      strip = document.createElement('div'); strip.dataset.harnessMixSelectedMentions = 'true';
+      strip = document.createElement('div');
+      strip.dataset.harnessMixSelectedMentions = 'true';
       strip.setAttribute('aria-label', '已提及的协作者');
-      strip.style.cssText = 'display:flex;gap:6px;flex-wrap:wrap;padding:6px 0';
-      target.after(strip); badges.set(target, strip);
+      // Place INLINE before target inside the input flow like Image 2, not as a block row below.
+      strip.style.cssText = 'display:inline-flex;align-items:center;gap:8px;flex-wrap:wrap;padding:0;margin:0 4px 0 0;vertical-align:baseline;line-height:normal;';
+      target.before(strip);
+      badges.set(target, strip);
+    }
+
+    const newKeys = perEditor ? [...perEditor.values()].map(e => e.kind === 'agent' ? `agent:${e.id}` : e.kind === 'session' ? `session:${e.id}` : `codex:${e.id}`).join(',') : '';
+    const currentKeys = [...strip.querySelectorAll<HTMLElement>('[data-harness-mix-mention-badge]')].map(b => b.dataset.harnessMixMentionBadge).join(',');
+    if (strip.isConnected && currentKeys === newKeys && strip.style.display === (hasAny ? 'inline-flex' : 'none')) {
+      return;
     }
-    strip.replaceChildren(); strip.style.display = hasAny ? 'flex' : 'none';
+
+    strip.replaceChildren();
+    strip.style.display = hasAny ? 'inline-flex' : 'none';
     if (!perEditor) return;
+
     for (const entry of perEditor.values()) {
-      const badge = document.createElement('span');
-      badge.dataset.harnessMixMentionBadge = entry.kind === 'agent' ? `agent:${entry.id}` : `session:${entry.id}`;
-      badge.style.cssText = 'display:inline-flex;align-items:center;gap:6px;padding:4px 8px;border:1px solid #8883;border-radius:8px;font:12px inherit;background:#8881';
-      const iconWrap = document.createElement('span');
-      iconWrap.style.cssText = 'display:inline-flex;align-items:center;gap:6px';
-      iconWrap.append(
-        collaborationIcon(entry.kind === 'agent' ? entry.id : entry.harnessId, entry.kind === 'agent' ? entry.name : entry.title, 16),
-        document.createTextNode(entry.kind === 'agent' ? entry.name : entry.title),
-      );
-      const remove = document.createElement('button');
-      remove.type = 'button';
-      remove.dataset.harnessMixMentionRemove = entry.kind === 'agent' ? `agent:${entry.id}` : `session:${entry.id}`;
-      const removeLabel = entry.kind === 'agent' ? `移除 ${entry.name}` : `移除会话 ${entry.title}`;
-      remove.setAttribute('aria-label', removeLabel);
-      remove.title = removeLabel;
-      remove.textContent = '×';
-      remove.style.cssText = 'border:0;background:transparent;color:inherit;cursor:pointer;padding:0 0 0 2px;margin:0;font:600 14px/1 inherit;opacity:.55;line-height:1;display:inline-flex;align-items:center;justify-content:center;width:14px;height:14px;border-radius:50%';
-      remove.addEventListener('mouseenter', () => { remove.style.opacity = '1'; remove.style.background = '#8883'; });
-      remove.addEventListener('mouseleave', () => { remove.style.opacity = '.55'; remove.style.background = 'transparent'; });
-      remove.addEventListener('mousedown', event => { event.preventDefault(); event.stopPropagation(); });
-      remove.addEventListener('click', event => {
+      const badge = document.createElement('button');
+      badge.type = 'button';
+      badge.dataset.harnessMixMentionBadge = entry.kind === 'agent'
+        ? `agent:${entry.id}`
+        : entry.kind === 'session'
+          ? `session:${entry.id}`
+          : `codex:${entry.id}`;
+
+      const removeLabel = entry.kind === 'agent'
+        ? `移除协作 Agent ${entry.name}`
+        : entry.kind === 'session'
+          ? `移除历史会话 ${entry.title}`
+          : `移除 Codex 选项 ${entry.title}`;
+      badge.setAttribute('aria-label', removeLabel);
+      badge.title = `${removeLabel}（点击移除）`;
+
+      const agentColor = entry.kind === 'agent'
+        ? getAgentColor(entry.id)
+        : entry.kind === 'codex'
+          ? '#0ea5e9'
+          : '#8b5cf6';
+
+      badge.style.cssText = `display:inline-flex;align-items:center;gap:4px;padding:1px 5px;border:0;border-radius:4px;background:transparent;color:${agentColor};font:500 15px/1.4 system-ui,-apple-system,BlinkMacSystemFont,sans-serif;user-select:none;cursor:pointer;transition:background 0.15s,opacity 0.15s;`;
+      badge.addEventListener('mouseenter', () => { badge.style.background = 'rgba(128,128,128,0.12)'; });
+      badge.addEventListener('mouseleave', () => { badge.style.background = 'transparent'; });
+      badge.addEventListener('click', event => {
         event.preventDefault();
         event.stopPropagation();
-        const live = selections.get(target);
-        if (!live) return;
+        const live = selectionsFor(target);
         live.delete(entryKey(entry));
         syncBadges(target);
+        target.focus();
       });
-      badge.append(iconWrap, remove);
-      badge.title = entry.kind === 'agent' ? `@${entry.id}${entry.available ? '' : ' · 未就绪'}` : `历史会话 · ${entry.cwd}`;
+
+      const iconWrap = document.createElement('span');
+      iconWrap.style.cssText = 'display:inline-flex;align-items:center;gap:4px;';
+      if (entry.kind === 'agent' || entry.kind === 'session') {
+        iconWrap.append(
+          collaborationIcon(entry.kind === 'agent' ? entry.id : entry.harnessId, entry.kind === 'agent' ? entry.name : entry.title, 16),
+          document.createTextNode(entry.kind === 'agent' ? entry.name : entry.title),
+        );
+      } else {
+        const iconSpan = document.createElement('span');
+        iconSpan.textContent = entry.icon || '📌';
+        iconSpan.style.cssText = 'font-size:14px;line-height:1;';
+        iconWrap.append(iconSpan, document.createTextNode(entry.title));
+      }
+
+      badge.append(iconWrap);
       strip.append(badge);
     }
   };
-  const close = () => { generation++; menu.hidden = true; activeComposer?.removeAttribute('data-harness-mix-mention-active'); activeComposer = null; };
+
+  const close = () => {
+    generation++;
+    menu.hidden = true;
+    activeComposer?.removeAttribute('data-harness-mix-mention-active');
+    activeComposer?.removeAttribute('data-harness-mix-show-native');
+    activeComposer = null;
+  };
+
   const choose = (entry: MentionEntry) => {
-    if (!editor || (entry.kind === 'agent' ? !entry.available || !canDelegate : entry.running === true)) return;
+    if (!editor) return;
+    if (entry.kind === 'agent' && (!entry.available || !canDelegate)) return;
+    if (entry.kind === 'session' && entry.running === true) return;
     const target = editor;
     close();
     target.focus();
-    // Drop the @query trigger text the user typed to open the picker so the
-    // editor stays free of literal @agent handles. The chip below carries
-    // the same intent and is the only visible signal.
     replaceSelectionWith(target, '');
-    // Toggle the entry in the per-editor selections; a second click removes it.
+
+    if (entry.kind === 'codex') {
+      const nativeOverlay = document.querySelector('[data-composer-overlay-floating-ui="true"]');
+      if (nativeOverlay) {
+        const buttons = [...nativeOverlay.querySelectorAll<HTMLElement>('button, [role="option"]')];
+        const match = buttons.find(b => (b.innerText || b.textContent || '').includes(entry.title));
+        if (match) {
+          match.click();
+          return;
+        }
+      }
+      if (entry.action === 'files') {
+        const fileInput = document.querySelector<HTMLInputElement>('input[type="file"]');
+        fileInput?.click();
+      }
+      return;
+    }
+
     const perEditor = selectionsFor(target);
     const key = entryKey(entry);
     if (perEditor.has(key)) perEditor.delete(key);
     else perEditor.set(key, entry);
     syncBadges(target);
   };
+
   const render = () => {
     menu.replaceChildren();
-    const tabs = document.createElement('div'); tabs.setAttribute('role', 'tablist');
+    const tabs = document.createElement('div');
+    tabs.setAttribute('role', 'tablist');
     tabs.style.cssText = 'display:flex;gap:4px;padding:2px 2px 6px;border-bottom:1px solid #8882;margin-bottom:4px';
-    for (const kind of ['agent', 'session'] as const) {
-      const tab = document.createElement('button'); tab.type = 'button'; tab.setAttribute('role', 'tab');
-      tab.setAttribute('aria-selected', String(activeKind === kind));
-      tab.textContent = `${kind === 'agent' ? 'Agents' : '会话'}  ${matches.filter(entry => entry.kind === kind).length}`;
-      tab.style.cssText = `border:0;border-radius:6px;padding:6px 10px;color:inherit;font:inherit;cursor:pointer;background:${activeKind === kind ? '#8882' : 'transparent'}`;
+
+    const tabDefinitions: Array<{ kind: 'agent' | 'session'; label: string }> = [
+      { kind: 'agent', label: 'Agents' },
+      { kind: 'session', label: '会话' },
+    ];
+
+    for (const tabInfo of tabDefinitions) {
+      const tab = document.createElement('button');
+      tab.type = 'button';
+      tab.setAttribute('role', 'tab');
+      tab.setAttribute('aria-selected', String(activeKind === tabInfo.kind));
+      const count = matches.filter(entry => entry.kind === tabInfo.kind).length;
+      tab.textContent = `${tabInfo.label}  ${count}`;
+      tab.style.cssText = `border:0;border-radius:6px;padding:6px 10px;color:inherit;font:inherit;cursor:pointer;background:${activeKind === tabInfo.kind ? '#8882' : 'transparent'};transition:background .15s;`;
       tab.addEventListener('mousedown', event => event.preventDefault());
-      tab.addEventListener('click', () => { activeKind = kind; selected = 0; render(); }); tabs.append(tab);
+      tab.addEventListener('click', () => {
+        activeKind = tabInfo.kind;
+        selected = 0;
+        render();
+      });
+      tabs.append(tab);
     }
     menu.append(tabs);
+
     entries = matches.filter(entry => entry.kind === activeKind);
     if (!entries.length || (activeKind === 'agent' && !canDelegate)) {
       const notice = document.createElement('div');
       notice.textContent = !canDelegate && activeKind === 'agent'
         ? '当前主 Agent 未接入协作工具。请切换到 Codex（协作）、Claude Code、Pi 或 Oh My Pi 后分派任务。'
-        : activeKind === 'agent' ? '没有匹配的 Agent' : '没有匹配的历史会话';
-      notice.style.cssText = 'padding:10px 8px;font-size:12px;line-height:1.6;opacity:.65'; menu.append(notice);
+        : activeKind === 'agent'
+          ? '没有匹配的 Agent'
+          : '没有匹配的历史会话';
+      notice.style.cssText = 'padding:10px 8px;font-size:12px;line-height:1.6;opacity:.65';
+      menu.append(notice);
     }
-    const list = document.createElement('div'); list.setAttribute('role', 'listbox'); list.setAttribute('aria-label', activeKind === 'agent' ? '协作 Agents' : '历史会话'); menu.append(list);
+
+    const list = document.createElement('div');
+    list.setAttribute('role', 'listbox');
+    list.setAttribute('aria-label', activeKind === 'agent' ? '协作 Agents' : '历史会话');
+    menu.append(list);
+
     entries.forEach((entry, index) => {
       const row = document.createElement('button');
-      row.type = 'button'; row.setAttribute('role', 'option');
+      row.type = 'button';
+      row.setAttribute('role', 'option');
       row.setAttribute('aria-selected', String(index === selected));
-      const available = entry.kind === 'agent' ? entry.available && canDelegate : entry.running !== true;
+      const available = entry.kind === 'agent'
+        ? entry.available && canDelegate
+        : entry.kind === 'session'
+          ? entry.running !== true
+          : true;
       row.disabled = !available;
       row.id = `harness-mention-option-${index}`;
       row.style.cssText = `display:flex;align-items:center;gap:8px;width:100%;text-align:left;border:0;border-radius:7px;padding:7px 8px;color:inherit;font:inherit;cursor:pointer;background:${index === selected ? '#8882' : 'transparent'};opacity:${available ? 1 : .45}`;
-      const copy = document.createElement('span'); copy.style.cssText = 'display:flex;flex-direction:column;gap:3px;flex:1;min-width:0';
-      const name = document.createElement('span'); name.textContent = entry.kind === 'agent' ? entry.name : entry.title; name.style.cssText = 'overflow:hidden;text-overflow:ellipsis;white-space:nowrap';
-      const detail = document.createElement('span'); detail.textContent = entry.kind === 'agent' ? `@${entry.id}` : entry.cwd; detail.style.cssText = 'font-size:11px;opacity:.55;overflow:hidden;text-overflow:ellipsis;white-space:nowrap';
+
+      const copy = document.createElement('span');
+      copy.style.cssText = 'display:flex;flex-direction:column;gap:3px;flex:1;min-width:0';
+      const name = document.createElement('span');
+      name.textContent = entry.kind === 'agent' ? entry.name : entry.title;
+      name.style.cssText = 'overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-weight:500;';
+
+      const detail = document.createElement('span');
+      detail.textContent = entry.kind === 'agent'
+        ? (AGENT_DESCRIPTIONS[entry.id] || entry.description || `#${entry.id}`)
+        : entry.kind === 'session'
+          ? entry.cwd
+          : (entry.description || entry.category);
+      detail.style.cssText = 'font-size:11px;opacity:.55;overflow:hidden;text-overflow:ellipsis;white-space:nowrap';
       copy.append(name, detail);
-      const status = document.createElement('span'); status.textContent = entry.kind === 'agent' ? (entry.available ? '可协作' : '未就绪') : (entry.running ? '运行中' : '引用'); status.style.cssText = 'font-size:11px;opacity:.6';
-      row.append(collaborationIcon(entry.kind === 'agent' ? entry.id : entry.harnessId, name.textContent || ''), copy, status);
+
+      const status = document.createElement('span');
+      status.textContent = entry.kind === 'agent'
+        ? (entry.available ? '可协作' : '未就绪')
+        : entry.kind === 'session'
+          ? (entry.running ? '运行中' : '引用')
+          : (entry.category || '原生');
+      status.style.cssText = 'font-size:11px;opacity:.6';
+
+      let iconEl: HTMLElement;
+      if (entry.kind === 'agent' || entry.kind === 'session') {
+        iconEl = collaborationIcon(entry.kind === 'agent' ? entry.id : entry.harnessId, name.textContent || '', 18);
+      } else {
+        const iconSpan = document.createElement('span');
+        iconSpan.textContent = entry.icon || '📎';
+        iconSpan.style.cssText = 'font-size:16px;line-height:1;width:18px;text-align:center;';
+        iconEl = iconSpan;
+      }
+
+      row.append(iconEl, copy, status);
       row.addEventListener('mousedown', event => event.preventDefault());
       row.addEventListener('click', () => choose(entry));
       list.append(row);
     });
   };
+
   const input = async (event: Event) => {
     const target = event.target;
     if (!(target instanceof HTMLElement) || !target.closest('[data-codex-composer-root]')) return;
@@ -185,42 +499,66 @@ export function installHarnessMentions(load: (editor: Element, query: string) =>
     if (!(editable instanceof HTMLElement)) return;
     editor = editable;
     syncBadges(editable);
+
     let prefix = '';
     range = null;
     if (editable instanceof HTMLTextAreaElement) {
       if (editable.selectionStart !== editable.selectionEnd) { close(); return; }
-      end = editable.selectionStart; prefix = editable.value.slice(0, end);
+      end = editable.selectionStart;
+      prefix = editable.value.slice(0, end);
     } else {
       const selection = window.getSelection();
       if (!selection?.rangeCount || !selection.isCollapsed) { close(); return; }
       const caret = selection.getRangeAt(0);
       if (!editable.contains(caret.startContainer) || caret.startContainer.nodeType !== Node.TEXT_NODE) { close(); return; }
-      const before = caret.cloneRange(); before.selectNodeContents(editable); before.setEnd(caret.startContainer, caret.startOffset);
-      prefix = before.toString(); end = prefix.length;
+      const before = caret.cloneRange();
+      before.selectNodeContents(editable);
+      before.setEnd(caret.startContainer, caret.startOffset);
+      prefix = before.toString();
+      end = prefix.length;
       range = caret.cloneRange();
     }
-    const match = /(?:^|[\s，。；：])@([\p{L}\p{N}_-]*)$/u.exec(prefix);
+
+    const match = /(?:^|[\s，。；：])#([\p{L}\p{N}_-]*)$/u.exec(prefix);
     if (!match) { close(); return; }
     const length = match[1]!.length + 1;
     start = end - length;
     const current = ++generation;
+
     try {
       const catalog = await load(editable, match[1]!.toLowerCase());
       if (disposed || current !== generation) return;
-      catalogs.set(editable, catalog); syncBadges(editable);
+      catalogs.set(editable, catalog);
+      syncBadges(editable);
+
       const query = match[1]!.toLowerCase();
       canDelegate = catalog.canDelegate !== false;
-      matches = [
-        ...catalog.agents.filter(a => a.id.toLowerCase().includes(query) || a.name.toLowerCase().includes(query)).map(a => ({ kind: 'agent' as const, ...a })),
-        ...catalog.sessions.filter(session => `${session.title} ${session.cwd}`.toLowerCase().includes(query)).map(session => ({ kind: 'session' as const, ...session })),
-      ];
-      activeKind = query && !matches.some(entry => entry.kind === 'agent') && matches.some(entry => entry.kind === 'session') ? 'session' : 'agent';
+
+      const matchingAgents: MentionEntry[] = catalog.agents
+        .filter(a => a.id.toLowerCase().includes(query) || a.name.toLowerCase().includes(query))
+        .map(a => ({ kind: 'agent' as const, title: a.name, ...a }));
+
+      const matchingSessions: MentionEntry[] = catalog.sessions
+        .filter(s => `${s.title} ${s.cwd}`.toLowerCase().includes(query))
+        .map(s => ({ kind: 'session' as const, ...s }));
+
+      matches = [...matchingAgents, ...matchingSessions];
+
+      if (query && !matchingAgents.length && matchingSessions.length) {
+        activeKind = 'session';
+      } else {
+        activeKind = 'agent';
+      }
+
       entries = matches.filter(entry => entry.kind === activeKind);
-      selected = Math.max(0, entries.findIndex(entry => entry.kind === 'agent' ? entry.available && canDelegate : entry.running !== true));
-      render(); menu.hidden = !catalog.agents.length && !catalog.sessions.length && catalog.canDelegate === undefined;
+      selected = Math.max(0, entries.findIndex(entry => entry.kind === 'agent' ? entry.available && canDelegate : entry.kind === 'session' ? entry.running !== true : true));
+
+      render();
+      menu.hidden = !matches.length && catalog.canDelegate === undefined;
       activeComposer?.removeAttribute('data-harness-mix-mention-active');
       activeComposer = !menu.hidden ? editable.closest('[data-codex-composer-root]') : null;
       activeComposer?.setAttribute('data-harness-mix-mention-active', 'true');
+
       menu.scrollTop = 0;
       const rect = editable.getBoundingClientRect();
       menu.style.left = `${Math.max(8, Math.min(rect.left, window.innerWidth - 348))}px`;
@@ -230,35 +568,75 @@ export function installHarnessMentions(load: (editor: Element, query: string) =>
       menu.style.top = above >= 160 ? 'auto' : `${rect.bottom + 8}px`;
     } catch { close(); }
   };
+
   const keydown = (event: KeyboardEvent) => {
+    const target = event.target;
+    if (target instanceof HTMLElement && target.closest('[data-codex-composer-root]')) {
+      const editable = target.closest('textarea,[contenteditable="true"]') as HTMLElement | null;
+      if (editable && event.key === 'Backspace') {
+        let isAtStart = false;
+        if (editable instanceof HTMLTextAreaElement) {
+          isAtStart = editable.selectionStart === 0 && editable.selectionEnd === 0;
+        } else {
+          const sel = window.getSelection();
+          if (sel && sel.isCollapsed && sel.rangeCount > 0) {
+            const r = sel.getRangeAt(0);
+            isAtStart = r.startOffset === 0 && (r.startContainer === editable || r.startContainer.textContent === '' || editable.firstChild === r.startContainer);
+          }
+        }
+        if (isAtStart) {
+          const perSession = selectionsFor(editable);
+          if (perSession && perSession.size > 0) {
+            const keys = [...perSession.keys()];
+            const lastKey = keys[keys.length - 1];
+            if (lastKey) perSession.delete(lastKey);
+            syncBadges(editable);
+            event.preventDefault();
+            return;
+          }
+        }
+      }
+    }
+
     if (menu.hidden || event.isComposing) return;
-    // Let the native editor dismiss its own mention state as well.
     if (event.key === 'Escape') { close(); return; }
     if (!['ArrowDown', 'ArrowUp', 'ArrowLeft', 'ArrowRight', 'Enter', 'Tab', 'Escape'].includes(event.key)) return;
     event.preventDefault(); event.stopImmediatePropagation();
-    if (event.key === 'Escape') close();
-    else if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') { activeKind = activeKind === 'agent' ? 'session' : 'agent'; selected = 0; render(); }
-    else if (event.key === 'Enter' || event.key === 'Tab') { const entry = entries[selected]; if (entry) choose(entry); }
-    else {
-      for (let i = 0; i < entries.length; i++) { selected = (selected + (event.key === 'ArrowDown' ? 1 : -1) + entries.length) % entries.length; const entry = entries[selected]; if (entry && (entry.kind === 'agent' ? entry.available && canDelegate : entry.running !== true)) break; }
-      render(); menu.querySelector('[role="option"][aria-selected="true"]')?.scrollIntoView({ block: 'nearest' });
+
+    if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') {
+      const kinds: Array<'agent' | 'session'> = ['agent', 'session'];
+      const curIdx = kinds.indexOf(activeKind as 'agent' | 'session');
+      const nextIdx = (curIdx + (event.key === 'ArrowRight' ? 1 : -1) + kinds.length) % kinds.length;
+      const next = kinds[nextIdx];
+      if (next) activeKind = next;
+      selected = 0;
+      render();
+    } else if (event.key === 'Enter' || event.key === 'Tab') {
+      const entry = entries[selected];
+      if (entry) choose(entry);
+    } else {
+      for (let i = 0; i < entries.length; i++) {
+        selected = (selected + (event.key === 'ArrowDown' ? 1 : -1) + entries.length) % entries.length;
+        const entry = entries[selected];
+        if (entry && (entry.kind === 'agent' ? entry.available && canDelegate : entry.kind === 'session' ? entry.running !== true : true)) break;
+      }
+      render();
+      menu.querySelector('[role="option"][aria-selected="true"]')?.scrollIntoView({ block: 'nearest' });
     }
   };
-  const outside = (event: Event) => { if (event.target instanceof Node && !menu.contains(event.target)) close(); };
-
-  // The Host detects mentions by parsing `@agent` literals out of the submitted
-  // text. The composer no longer carries those literals while the user is
-  // typing, so before the native form submit reads the editor we re-attach
-  // the mentions at the start of the value. The editor then clears itself
-  // after Codex Desktop finishes dispatching the turn, hiding the literal
-  // text again.
+
+  const outside = (event: Event) => {
+    if (event.target instanceof Node && !menu.contains(event.target)) close();
+  };
+
   const findEditorIn = (root: Element | null): HTMLElement | null => {
     if (!root) return null;
     if (root.matches('textarea,[contenteditable="true"]')) return root as HTMLElement;
     return root.querySelector<HTMLElement>('textarea,[contenteditable="true"]');
   };
+
   const injectMentionsInto = (target: HTMLElement): boolean => {
-    const perEditor = selections.get(target);
+    const perEditor = selectionsFor(target);
     if (!perEditor || perEditor.size === 0) return false;
     const text = [...perEditor.values()].map(entryLiteral).join('');
     if (!text) return false;
@@ -267,18 +645,21 @@ export function installHarnessMentions(load: (editor: Element, query: string) =>
       target.value = `${text}${target.value}`;
       target.dispatchEvent(new Event('input', { bubbles: true }));
       target.dispatchEvent(new Event('change', { bubbles: true }));
-      return true;
+    } else {
+      const selection = window.getSelection();
+      const fresh = document.createRange();
+      fresh.selectNodeContents(target);
+      fresh.collapse(true);
+      selection?.removeAllRanges();
+      selection?.addRange(fresh);
+      document.dispatchEvent(new Event('selectionchange'));
+      document.execCommand('insertText', false, text);
     }
-    const selection = window.getSelection();
-    const fresh = document.createRange();
-    fresh.selectNodeContents(target);
-    fresh.collapse(true);
-    selection?.removeAllRanges();
-    selection?.addRange(fresh);
-    document.dispatchEvent(new Event('selectionchange'));
-    document.execCommand('insertText', false, text);
+    perEditor.clear();
+    syncBadges(target);
     return true;
   };
+
   const onSubmitCapture = (event: Event) => {
     const composerRoot = (event.target instanceof Element ? event.target : null)?.closest?.('[data-codex-composer-root]');
     const candidate = composerRoot ?? (event.target instanceof Element ? event.target : null);
@@ -288,19 +669,71 @@ export function installHarnessMentions(load: (editor: Element, query: string) =>
     injectMentionsInto(editorEl);
   };
 
+  const onFocusIn = (event: FocusEvent) => {
+    const target = event.target;
+    if (target instanceof HTMLElement && target.closest('[data-codex-composer-root]')) {
+      const editable = target.closest('textarea,[contenteditable="true"]') as HTMLElement | null;
+      if (editable) syncBadges(editable);
+    }
+  };
+
+  const observer = new MutationObserver((mutations) => {
+    let shouldSync = false;
+    for (const m of mutations) {
+      if (m.target instanceof Element) {
+        if (m.target.closest('[data-harness-mix-selected-mentions]') || m.target.closest('[data-harness-mix-mentions]')) {
+          continue;
+        }
+      }
+      shouldSync = true;
+      break;
+    }
+    if (!shouldSync) return;
+    const composers = document.querySelectorAll('[data-codex-composer-root]');
+    for (const composer of composers) {
+      const el = findEditorIn(composer);
+      if (el) syncBadges(el);
+    }
+  });
+
+  try {
+    observer.observe(document.body, {
+      childList: true,
+      subtree: true,
+      attributes: true,
+      attributeFilter: ['data-above-composer-conversation-id', 'data-conversation-id', 'data-composer-draft-id'],
+    });
+  } catch {}
+
   document.addEventListener('input', input, true);
   document.addEventListener('keydown', keydown, true);
   document.addEventListener('mousedown', outside);
   document.addEventListener('submit', onSubmitCapture, true);
+  document.addEventListener('focusin', onFocusIn, true);
   window.addEventListener('blur', close);
-  return { dispose() {
-    disposed = true; close(); menu.remove(); style.remove();
-    for (const strip of badges.values()) strip.remove(); badges.clear(); catalogs.clear();
-    for (const [target, perEditor] of selections) if (!target.isConnected) selections.delete(target);
-    document.removeEventListener('input', input, true);
-    document.removeEventListener('keydown', keydown, true);
-    document.removeEventListener('mousedown', outside);
-    document.removeEventListener('submit', onSubmitCapture, true);
-    window.removeEventListener('blur', close);
-  } };
-}
+
+  return {
+    sync(target: HTMLElement) {
+      syncBadges(target);
+    },
+    dispose() {
+      disposed = true;
+      close();
+      menu.remove();
+      style.remove();
+      observer.disconnect();
+      for (const el of document.querySelectorAll('[data-harness-mix-has-mentions]')) {
+        el.removeAttribute('data-harness-mix-has-mentions');
+      }
+      for (const strip of badges.values()) strip.remove();
+      badges.clear();
+      catalogs.clear();
+      document.removeEventListener('input', input, true);
+      document.removeEventListener('keydown', keydown, true);
+      document.removeEventListener('mousedown', outside);
+      document.removeEventListener('submit', onSubmitCapture, true);
+      document.removeEventListener('focusin', onFocusIn, true);
+      window.removeEventListener('blur', close);
+    },
+  };
+}