diff --git a/client/electron/src/components/MailView.tsx b/client/electron/src/components/MailView.tsx
index 6f9ec6e..52da78c 100644
--- a/client/electron/src/components/MailView.tsx
+++ b/client/electron/src/components/MailView.tsx
@@ -1,128 +1,155 @@
-import { useEffect, useState } from 'react';
-import Markdown from 'react-markdown';
-import remarkGfm from 'remark-gfm';
-import { useMailStore } from '../stores/mailStore';
-import { useSessionStore } from '../stores/sessionStore';
-import { useContactStore } from '../stores/contactStore';
-import { useAuthStore } from '../stores/authStore';
+import { useEffect, useState } from "react";
+import Markdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import { useMailStore } from "../stores/mailStore";
+import { useSessionStore } from "../stores/sessionStore";
+import { useContactStore } from "../stores/contactStore";
+import { useAuthStore } from "../stores/authStore";
 import {
-  sessionReplyTarget,
-  mailReplyTarget,
-  mailCounterpart,
-  replyAllCC,
-  participantAddress
-} from '../lib/replyTarget';
-import * as api from '../api/client';
-import type { Mail } from '../types';
-import { MailIcon, ShieldIcon, PersonIcon, BotIcon, CheckIcon, CloseIcon, ForwardIcon, TreeIcon, TagIcon, GaugeIcon } from './icons';
-import AddressInput from './AddressInput';
-import { AttachmentList, AttachmentPicker, type PendingAttachment } from './Attachments';
-import ThreadView from './ThreadView';
-import PermissionChip, { permissionModeHint } from './PermissionChip';
-import BackButton from './BackButton';
+	sessionReplyTarget,
+	mailReplyTarget,
+	mailCounterpart,
+	replyAllCC,
+	participantAddress,
+} from "../lib/replyTarget";
+import * as api from "../api/client";
+import type { Mail } from "../types";
+import {
+	MailIcon,
+	ShieldIcon,
+	PersonIcon,
+	BotIcon,
+	CheckIcon,
+	CloseIcon,
+	ForwardIcon,
+	TreeIcon,
+	TagIcon,
+	GaugeIcon,
+} from "./icons";
+import AddressInput from "./AddressInput";
+import {
+	AttachmentList,
+	AttachmentPicker,
+	type PendingAttachment,
+} from "./Attachments";
+import ThreadView from "./ThreadView";
+import PermissionChip, { permissionModeHint } from "./PermissionChip";
+import BackButton from "./BackButton";
 
 export default function MailView() {
-  const currentMail = useMailStore(s => s.currentMail);
-  const markRead = useMailStore(s => s.markRead);
-  const currentSession = useSessionStore(s => s.currentSession);
-  const currentSessionMails = useSessionStore(s => s.currentSessionMails);
-  // 当前登录用户名：判定「哪封是我发的」的唯一基准。
-  // 曾经写死成 'human'（单用户时代的遗留），多用户下登录名可能是 jianf，
-  // 判据恒为假 —— 于是回复自己发的信时对端取成了自己。
-  const me = useAuthStore(s => s.user?.username || '');
-  // 转发面板作用于哪封邮件；null = 未打开
-  const [forwarding, setForwarding] = useState<Mail | null>(null);
-  // 正在看哪封邮件的对话树；null = 看正常的邮件视图
-  const [threadOf, setThreadOf] = useState<string | null>(null);
+	const currentMail = useMailStore((s) => s.currentMail);
+	const markRead = useMailStore((s) => s.markRead);
+	const currentSession = useSessionStore((s) => s.currentSession);
+	const currentSessionMails = useSessionStore((s) => s.currentSessionMails);
+	// 当前登录用户名：判定「哪封是我发的」的唯一基准。
+	// 曾经写死成 'human'（单用户时代的遗留），多用户下登录名可能是 jianf，
+	// 判据恒为假 —— 于是回复自己发的信时对端取成了自己。
+	const me = useAuthStore((s) => s.user?.username || "");
+	// 转发面板作用于哪封邮件；null = 未打开
+	const [forwarding, setForwarding] = useState<Mail | null>(null);
+	// 正在看哪封邮件的对话树；null = 看正常的邮件视图
+	const [threadOf, setThreadOf] = useState<string | null>(null);
 
-  // 切换邮件时关掉树视图：树是针对某封邮件的，留着会显示上一封的线索
-  const currentMailID = currentMail?.mail_id;
-  useEffect(() => {
-    setThreadOf(null);
-  }, [currentMailID]);
+	// 切换邮件时关掉树视图：树是针对某封邮件的，留着会显示上一封的线索
+	const currentMailID = currentMail?.mail_id;
+	useEffect(() => {
+		setThreadOf(null);
+	}, [currentMailID]);
 
-  if (currentSession && currentSessionMails.length > 0) {
-    const last = currentSessionMails[currentSessionMails.length - 1];
-    // 会话视图的对端是**会话的属性**，不能由「最后一封是谁发的」决定：
-    // 人在这里打字就是「给这次任务的对方追加一句」，而最后一封很可能是自己刚发的，
-    // 那时取对端会取成自己 —— 信就发给了自己（生产已发生）。
-    const sessionTarget = sessionReplyTarget(currentSessionMails, currentSession, me);
-    return (
-      <div className="flex-1 min-w-0 flex flex-col bg-gray-50">
-        <div className="px-4 md:px-6 py-3 border-b border-gray-200 bg-white">
-          <div className="flex items-center gap-2 flex-wrap">
-            <BackButton label="会话" />
-            <span className="text-sm font-semibold text-gray-900 font-mono">
-              {currentSession.session_alias
-                ? `.${currentSession.session_alias}`
-                : '(未命名会话)'}
-            </span>
-            <StatusBadge status={currentSession.status} />
-            <span className="text-xs text-gray-400">
-              {currentSessionMails.length} 封
-            </span>
-            <div className="flex-1" />
-            <PermissionEditor />
-            <BudgetEditor />
-          </div>
-          <p className="text-xs text-gray-500 mt-0.5">{currentSession.subject}</p>
-        </div>
-        <RenameProposalBar />
-        <div className="flex-1 overflow-y-auto px-4 md:px-6 py-4 space-y-3">
-          {currentSessionMails.map(m => (
-            <ThreadCard key={m.mail_id} mail={m} onForward={() => setForwarding(m)} />
-          ))}
-        </div>
-        {/* 会话视图原先只有回复，转发入口只存在于单封邮件视图 ——
+	if (currentSession && currentSessionMails.length > 0) {
+		const last = currentSessionMails[currentSessionMails.length - 1];
+		// 会话视图的对端是**会话的属性**，不能由「最后一封是谁发的」决定：
+		// 人在这里打字就是「给这次任务的对方追加一句」，而最后一封很可能是自己刚发的，
+		// 那时取对端会取成自己 —— 信就发给了自己（生产已发生）。
+		const sessionTarget = sessionReplyTarget(
+			currentSessionMails,
+			currentSession,
+			me,
+		);
+		return (
+			<div className="flex-1 min-w-0 flex flex-col bg-gray-50">
+				<div className="px-4 md:px-6 py-3 border-b border-gray-200 bg-white">
+					<div className="flex items-center gap-2 flex-wrap">
+						<BackButton label="会话" />
+						<span className="text-sm font-semibold text-gray-900 font-mono">
+							{currentSession.session_alias
+								? `.${currentSession.session_alias}`
+								: "(未命名会话)"}
+						</span>
+						<StatusBadge status={currentSession.status} />
+						<span className="text-xs text-gray-400">
+							{currentSessionMails.length} 封
+						</span>
+						<div className="flex-1" />
+						<PermissionEditor />
+						<BudgetEditor />
+					</div>
+					<p className="text-xs text-gray-500 mt-0.5">
+						{currentSession.subject}
+					</p>
+				</div>
+				<RenameProposalBar />
+				<div className="flex-1 overflow-y-auto px-4 md:px-6 py-4 space-y-3">
+					{currentSessionMails.map((m) => (
+						<ThreadCard
+							key={m.mail_id}
+							mail={m}
+							onForward={() => setForwarding(m)}
+						/>
+					))}
+				</div>
+				{/* 会话视图原先只有回复，转发入口只存在于单封邮件视图 ——
             而人多数时间待在会话视图里，等于转发功能在 UI 上找不到 */}
-        {forwarding ? (
-          <ForwardBar mail={forwarding} onClose={() => setForwarding(null)} />
-        ) : (
-          <ReplyBar replyTo={last} overrideTarget={sessionTarget} />
-        )}
-      </div>
-    );
-  }
+				{forwarding ? (
+					<ForwardBar mail={forwarding} onClose={() => setForwarding(null)} />
+				) : (
+					<ReplyBar replyTo={last} overrideTarget={sessionTarget} />
+				)}
+			</div>
+		);
+	}
 
-  if (!currentMail) {
-    return (
-      <div className="flex-1 min-w-0 flex items-center justify-center bg-gray-50 text-gray-400">
-        <div className="text-center">
-          <MailIcon className="w-10 h-10 mx-auto text-gray-300" />
-          <p className="text-sm mt-3 text-gray-500">选择一封邮件查看，或点击左侧「新建」写邮件</p>
-        </div>
-      </div>
-    );
-  }
+	if (!currentMail) {
+		return (
+			<div className="flex-1 min-w-0 flex items-center justify-center bg-gray-50 text-gray-400">
+				<div className="text-center">
+					<MailIcon className="w-10 h-10 mx-auto text-gray-300" />
+					<p className="text-sm mt-3 text-gray-500">
+						选择一封邮件查看，或点击左侧「新建」写邮件
+					</p>
+				</div>
+			</div>
+		);
+	}
 
-  if (threadOf) {
-    return <ThreadView mailID={threadOf} onClose={() => setThreadOf(null)} />;
-  }
+	if (threadOf) {
+		return <ThreadView mailID={threadOf} onClose={() => setThreadOf(null)} />;
+	}
 
-  return (
-    <div className="flex-1 min-w-0 flex flex-col bg-white">
-      <Header
-        mail={currentMail}
-        onRead={() => markRead(currentMail.mail_id)}
-        onForward={() => setForwarding(currentMail)}
-        onThread={() => setThreadOf(currentMail.mail_id)}
-      />
-      <div className="flex-1 overflow-y-auto px-4 md:px-6 py-4">
-        <div className="markdown text-sm">
-          <Markdown remarkPlugins={[remarkGfm]}>{currentMail.body}</Markdown>
-        </div>
-        <AttachmentList items={currentMail.attachments ?? []} />
-        {currentMail.mail_type === 'permission_request' && (
-          <PermissionPanel mail={currentMail} />
-        )}
-      </div>
-      {forwarding ? (
-        <ForwardBar mail={forwarding} onClose={() => setForwarding(null)} />
-      ) : (
-        <ReplyBar replyTo={currentMail} />
-      )}
-    </div>
-  );
+	return (
+		<div className="flex-1 min-w-0 flex flex-col bg-white">
+			<Header
+				mail={currentMail}
+				onRead={() => markRead(currentMail.mail_id)}
+				onForward={() => setForwarding(currentMail)}
+				onThread={() => setThreadOf(currentMail.mail_id)}
+			/>
+			<div className="flex-1 overflow-y-auto px-4 md:px-6 py-4">
+				<div className="markdown text-sm">
+					<Markdown remarkPlugins={[remarkGfm]}>{currentMail.body}</Markdown>
+				</div>
+				<AttachmentList items={currentMail.attachments ?? []} />
+				{currentMail.mail_type === "permission_request" && (
+					<PermissionPanel mail={currentMail} />
+				)}
+			</div>
+			{forwarding ? (
+				<ForwardBar mail={forwarding} onClose={() => setForwarding(null)} />
+			) : (
+				<ReplyBar replyTo={currentMail} />
+			)}
+		</div>
+	);
 }
 
 /**
@@ -133,62 +160,65 @@ export default function MailView() {
  * 三档：plan（只读）/ workspace（目录内，越界问人）/ full（全权）。
  */
 function PermissionEditor() {
-  const session = useSessionStore(s => s.currentSession);
-  const setPermissionMode = useSessionStore(s => s.setPermissionMode);
-  const [editing, setEditing] = useState(false);
-  const [busy, setBusy] = useState(false);
+	const session = useSessionStore((s) => s.currentSession);
+	const setPermissionMode = useSessionStore((s) => s.setPermissionMode);
+	const [editing, setEditing] = useState(false);
+	const [busy, setBusy] = useState(false);
 
-  if (!session) return null;
+	if (!session) return null;
 
-  const mode = session.permission_mode || 'workspace';
-  const enforcement = session.permission_enforcement || 'advisory';
+	const mode = session.permission_mode || "workspace";
+	const enforcement = session.permission_enforcement || "advisory";
 
-  if (!editing) {
-    return (
-      <button
-        onClick={() => setEditing(true)}
-        title={permissionModeHint(mode, enforcement)}
-        className="inline-flex items-center"
-      >
-        <PermissionChip mode={mode} enforcement={enforcement} />
-      </button>
-    );
-  }
+	if (!editing) {
+		return (
+			<button
+				onClick={() => setEditing(true)}
+				title={permissionModeHint(mode, enforcement)}
+				className="inline-flex items-center"
+			>
+				<PermissionChip mode={mode} enforcement={enforcement} />
+			</button>
+		);
+	}
 
-  const modes = [
-    { value: 'plan', label: '只读', desc: '不许写/改/执行' },
-    { value: 'workspace', label: '目录内', desc: '越界问人' },
-    { value: 'full', label: '全权', desc: '自动放行' },
-  ];
+	const modes = [
+		{ value: "plan", label: "只读", desc: "不许写/改/执行" },
+		{ value: "workspace", label: "目录内", desc: "越界问人" },
+		{ value: "full", label: "全权", desc: "自动放行" },
+	];
 
-  return (
-    <div className="flex items-center gap-1">
-      {modes.map(o => (
-        <button
-          key={o.value}
-          type="button"
-          disabled={busy}
-          onClick={async () => {
-            setBusy(true);
-            await setPermissionMode(o.value);
-            setBusy(false);
-            setEditing(false);
-          }}
-          title={o.desc}
-          className={`px-1.5 py-0.5 rounded text-[10px] font-medium border transition-colors disabled:opacity-40 ${
-            mode === o.value
-              ? 'border-blue-500 bg-blue-50 text-blue-700'
-              : 'border-gray-200 text-gray-500 hover:bg-gray-50'
-          }`}
-        >
-          {o.label}
-        </button>
-      ))}
-      <button onClick={() => setEditing(false)} className="text-[10px] text-gray-400 hover:text-gray-700 ml-0.5">
-        ×
-      </button>
-    </div>
-  );
+	return (
+		<div className="flex items-center gap-1">
+			{modes.map((o) => (
+				<button
+					key={o.value}
+					type="button"
+					disabled={busy}
+					onClick={async () => {
+						setBusy(true);
+						await setPermissionMode(o.value);
+						setBusy(false);
+						setEditing(false);
+					}}
+					title={o.desc}
+					className={`px-1.5 py-0.5 rounded text-[10px] font-medium border transition-colors disabled:opacity-40 ${
+						mode === o.value
+							? "border-blue-500 bg-blue-50 text-blue-700"
+							: "border-gray-200 text-gray-500 hover:bg-gray-50"
+					}`}
+				>
+					{o.label}
+				</button>
+			))}
+			<button
+				onClick={() => setEditing(false)}
+				className="text-[10px] text-gray-400 hover:text-gray-700 ml-0.5"
+			>
+				×
+			</button>
+		</div>
+	);
 }
 
 /**
@@ -199,85 +229,87 @@ function PermissionEditor() {
  * 而不是「这件事值得多少个来回」。
  */
 function BudgetEditor() {
-  const budget = useSessionStore(s => s.budget);
-  const setBudget = useSessionStore(s => s.setBudget);
-  const [editing, setEditing] = useState(false);
-  const [draft, setDraft] = useState('');
-  const [busy, setBusy] = useState(false);
+	const budget = useSessionStore((s) => s.budget);
+	const setBudget = useSessionStore((s) => s.setBudget);
+	const [editing, setEditing] = useState(false);
+	const [draft, setDraft] = useState("");
+	const [busy, setBusy] = useState(false);
 
-  if (!budget) return null;
+	if (!budget) return null;
 
-  const exhausted = !budget.unlimited && budget.remaining === 0;
+	const exhausted = !budget.unlimited && budget.remaining === 0;
 
-  const open = () => {
-    setDraft(budget.unlimited ? '' : String(budget.max_rounds));
-    setEditing(true);
-  };
+	const open = () => {
+		setDraft(budget.unlimited ? "" : String(budget.max_rounds));
+		setEditing(true);
+	};
 
-  const commit = async (patch: { max_rounds?: number; reset?: boolean }) => {
-    setBusy(true);
-    await setBudget(patch);
-    setBusy(false);
-    setEditing(false);
-  };
+	const commit = async (patch: { max_rounds?: number; reset?: boolean }) => {
+		setBusy(true);
+		await setBudget(patch);
+		setBusy(false);
+		setEditing(false);
+	};
 
-  if (!editing) {
-    return (
-      <button
-        onClick={open}
-        title="本任务的往返预算：Agent 主动发信的次数上限（自动转发的总结与权限询问不占用）"
-        className={`inline-flex items-center gap-1 text-[11px] px-2 py-0.5 rounded border transition-colors ${
-          exhausted
-            ? 'border-red-200 bg-red-50 text-red-700'
-            : 'border-gray-200 text-gray-500 hover:border-blue-300 hover:text-blue-600'
-        }`}
-      >
-        <GaugeIcon className="w-3 h-3" />
-        {budget.unlimited
-          ? '预算不限'
-          : `${budget.used_rounds}/${budget.max_rounds} 来回${exhausted ? ' · 已用尽' : ''}`}
-      </button>
-    );
-  }
+	if (!editing) {
+		return (
+			<button
+				onClick={open}
+				title="本任务的往返预算：Agent 主动发信的次数上限（自动转发的总结与权限询问不占用）"
+				className={`inline-flex items-center gap-1 text-[11px] px-2 py-0.5 rounded border transition-colors ${
+					exhausted
+						? "border-red-200 bg-red-50 text-red-700"
+						: "border-gray-200 text-gray-500 hover:border-blue-300 hover:text-blue-600"
+				}`}
+			>
+				<GaugeIcon className="w-3 h-3" />
+				{budget.unlimited
+					? "预算不限"
+					: `${budget.used_rounds}/${budget.max_rounds} 来回${exhausted ? " · 已用尽" : ""}`}
+			</button>
+		);
+	}
 
-  const invalid = draft.trim() !== '' && !/^\d+$/.test(draft.trim());
+	const invalid = draft.trim() !== "" && !/^\d+$/.test(draft.trim());
 
-  return (
-    <div className="flex items-center gap-1.5">
-      <span className="text-[11px] text-gray-500">往返预算</span>
-      <input
-        value={draft}
-        onChange={e => setDraft(e.target.value)}
-        inputMode="numeric"
-        placeholder="不限"
-        autoFocus
-        className={`w-16 text-xs border rounded px-1.5 py-1 focus:outline-none focus:ring-2 focus:ring-blue-100 ${
-          invalid ? 'border-red-300' : 'border-gray-300'
-        }`}
-      />
-      <button
-        disabled={busy || invalid}
-        onClick={() => commit({ max_rounds: draft.trim() === '' ? 0 : Number(draft.trim()) })}
-        className="text-[11px] px-2 py-1 rounded bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40"
-      >
-        保存
-      </button>
-      <button
-        disabled={busy || budget.used_rounds === 0}
-        onClick={() => commit({ reset: true })}
-        title="已用次数归零，上限不变"
-        className="text-[11px] text-gray-500 hover:text-gray-900 disabled:opacity-30"
-      >
-        重置
-      </button>
-      <button
-        onClick={() => setEditing(false)}
-        className="text-[11px] text-gray-400 hover:text-gray-700"
-      >
-        取消
-      </button>
-    </div>
-  );
+	return (
+		<div className="flex items-center gap-1.5">
+			<span className="text-[11px] text-gray-500">往返预算</span>
+			<input
+				value={draft}
+				onChange={(e) => setDraft(e.target.value)}
+				inputMode="numeric"
+				placeholder="不限"
+				autoFocus
+				className={`w-16 text-xs border rounded px-1.5 py-1 focus:outline-none focus:ring-2 focus:ring-blue-100 ${
+					invalid ? "border-red-300" : "border-gray-300"
+				}`}
+			/>
+			<button
+				disabled={busy || invalid}
+				onClick={() =>
+					commit({ max_rounds: draft.trim() === "" ? 0 : Number(draft.trim()) })
+				}
+				className="text-[11px] px-2 py-1 rounded bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40"
+			>
+				保存
+			</button>
+			<button
+				disabled={busy || budget.used_rounds === 0}
+				onClick={() => commit({ reset: true })}
+				title="已用次数归零，上限不变"
+				className="text-[11px] text-gray-500 hover:text-gray-900 disabled:opacity-30"
+			>
+				重置
+			</button>
+			<button
+				onClick={() => setEditing(false)}
+				className="text-[11px] text-gray-400 hover:text-gray-700"
+			>
+				取消
+			</button>
+		</div>
+	);
 }
 
 /**
@@ -288,53 +320,58 @@ function BudgetEditor() {
  * 提议 + 人确认，既让 Agent 表达意图，又保证寻址稳定性由人掌握。
  */
 function RenameProposalBar() {
-  const proposal = useSessionStore(s => s.renameProposal);
-  const current = useSessionStore(s => s.currentSession);
-  const accept = useSessionStore(s => s.acceptRename);
-  const dismiss = useSessionStore(s => s.dismissRename);
-  const [busy, setBusy] = useState(false);
+	const proposal = useSessionStore((s) => s.renameProposal);
+	const current = useSessionStore((s) => s.currentSession);
+	const accept = useSessionStore((s) => s.acceptRename);
+	const dismiss = useSessionStore((s) => s.dismissRename);
+	const [busy, setBusy] = useState(false);
 
-  if (!proposal) return null;
+	if (!proposal) return null;
 
-  const from = current?.session_alias ? `.${current.session_alias}` : '(未命名)';
+	const from = current?.session_alias
+		? `.${current.session_alias}`
+		: "(未命名)";
 
-  return (
-    <div className="px-4 md:px-6 py-2.5 bg-blue-50 border-b border-blue-100">
-      <div className="flex items-start gap-2">
-        <TagIcon className="w-3.5 h-3.5 text-blue-500 mt-0.5 shrink-0" />
-        <div className="flex-1 min-w-0">
-          <p className="text-xs text-blue-900">
-            Agent 建议把会话别名从 <span className="font-mono">{from}</span> 改为{' '}
-            <span className="font-mono font-semibold">.{proposal.alias}</span>
-          </p>
-          {proposal.reason && (
-            <p className="text-[11px] text-blue-700 mt-0.5">{proposal.reason}</p>
-          )}
-          <p className="text-[10px] text-blue-500 mt-0.5">
-            改名后需用 name@path.{proposal.alias} 寻址；旧别名立即失效。
-            接受后此别名不再被 Agent 平台的自动命名覆盖
-          </p>
-        </div>
-        <button
-          disabled={busy}
-          onClick={async () => {
-            setBusy(true);
-            await accept();
-            setBusy(false);
-          }}
-          className="px-2.5 py-1 rounded bg-blue-600 text-white text-xs hover:bg-blue-600 disabled:opacity-50 shrink-0"
-        >
-          {busy ? '改名中' : '接受'}
-        </button>
-        <button
-          onClick={dismiss}
-          className="px-2.5 py-1 rounded border border-blue-200 text-blue-700 text-xs hover:bg-blue-100 shrink-0"
-        >
-          忽略
-        </button>
-      </div>
-    </div>
-  );
+	return (
+		<div className="px-4 md:px-6 py-2.5 bg-blue-50 border-b border-blue-100">
+			<div className="flex items-start gap-2">
+				<TagIcon className="w-3.5 h-3.5 text-blue-500 mt-0.5 shrink-0" />
+				<div className="flex-1 min-w-0">
+					<p className="text-xs text-blue-900">
+						Agent 建议把会话别名从 <span className="font-mono">{from}</span>{" "}
+						改为{" "}
+						<span className="font-mono font-semibold">.{proposal.alias}</span>
+					</p>
+					{proposal.reason && (
+						<p className="text-[11px] text-blue-700 mt-0.5">
+							{proposal.reason}
+						</p>
+					)}
+					<p className="text-[10px] text-blue-500 mt-0.5">
+						改名后需用 name@path.{proposal.alias} 寻址；旧别名立即失效。
+						接受后此别名不再被 Agent 平台的自动命名覆盖
+					</p>
+				</div>
+				<button
+					disabled={busy}
+					onClick={async () => {
+						setBusy(true);
+						await accept();
+						setBusy(false);
+					}}
+					className="px-2.5 py-1 rounded bg-blue-600 text-white text-xs hover:bg-blue-600 disabled:opacity-50 shrink-0"
+				>
+					{busy ? "改名中" : "接受"}
+				</button>
+				<button
+					onClick={dismiss}
+					className="px-2.5 py-1 rounded border border-blue-200 text-blue-700 text-xs hover:bg-blue-100 shrink-0"
+				>
+					忽略
+				</button>
+			</div>
+		</div>
+	);
 }
 
 /**
@@ -342,248 +379,287 @@ function RenameProposalBar() {
  * 收件人用与写信页一致的三段式补全，正文引用由服务端生成（保证格式统一）。
  */
 function ForwardBar({ mail, onClose }: { mail: Mail; onClose: () => void }) {
-  const [to, setTo] = useState('');
-  const [cc, setCc] = useState('');
-  const [ccOpen, setCcOpen] = useState(false);
-  const [comment, setComment] = useState('');
-  const [busy, setBusy] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const fetchInbox = useMailStore(s => s.fetchInbox);
-  const fetchSent = useMailStore(s => s.fetchSent);
-  const fetchSessions = useSessionStore(s => s.fetchSessions);
-  const fetchContacts = useContactStore(s => s.fetchContacts);
+	const [to, setTo] = useState("");
+	const [cc, setCc] = useState("");
+	const [ccOpen, setCcOpen] = useState(false);
+	const [comment, setComment] = useState("");
+	const [busy, setBusy] = useState(false);
+	const [error, setError] = useState<string | null>(null);
+	const fetchInbox = useMailStore((s) => s.fetchInbox);
+	const fetchSent = useMailStore((s) => s.fetchSent);
+	const fetchSessions = useSessionStore((s) => s.fetchSessions);
+	const fetchContacts = useContactStore((s) => s.fetchContacts);
 
-  const submit = async () => {
-    if (!to.trim() || busy) return;
-    setBusy(true);
-    setError(null);
-    try {
-      await api.forwardMail(mail.mail_id, {
-        to: to.trim(),
-        cc: cc.trim(),
-        comment: comment.trim()
-      });
-      await Promise.all([fetchInbox('all'), fetchSent(), fetchSessions(), fetchContacts()]);
-      onClose();
-    } catch (err) {
-      setError(err instanceof Error ? err.message : String(err));
-    } finally {
-      setBusy(false);
-    }
-  };
+	const submit = async () => {
+		if (!to.trim() || busy) return;
+		setBusy(true);
+		setError(null);
+		try {
+			await api.forwardMail(mail.mail_id, {
+				to: to.trim(),
+				cc: cc.trim(),
+				comment: comment.trim(),
+			});
+			await Promise.all([
+				fetchInbox("all"),
+				fetchSent(),
+				fetchSessions(),
+				fetchContacts(),
+			]);
+			onClose();
+		} catch (err) {
+			setError(err instanceof Error ? err.message : String(err));
+		} finally {
+			setBusy(false);
+		}
+	};
 
-  return (
-    <div className="shrink-0 max-h-[min(65vh,calc(var(--app-height)-3rem))] overflow-y-auto overscroll-contain border-t border-gray-200 bg-white px-4 md:px-6 py-3 space-y-2">
-      <div className="flex items-center gap-2">
-        <ForwardIcon className="w-3.5 h-3.5 text-gray-500" />
-        <span className="text-[11px] font-medium text-gray-600">
-          转发「{mail.subject}」
-        </span>
-        <div className="flex-1" />
-        <button
-          onClick={() => setCcOpen(o => !o)}
-          className={`tap text-[10px] ${ccOpen ? 'text-blue-600' : 'text-gray-500 hover:text-blue-600'}`}
-        >
-          {ccOpen ? '收起抄送' : '抄送'}
-        </button>
-      </div>
+	return (
+		<div className="shrink-0 max-h-[min(65vh,calc(var(--app-height)-3rem))] overflow-y-auto overscroll-contain border-t border-gray-200 bg-white px-4 md:px-6 py-3 space-y-2">
+			<div className="flex items-center gap-2">
+				<ForwardIcon className="w-3.5 h-3.5 text-gray-500" />
+				<span className="text-[11px] font-medium text-gray-600">
+					转发「{mail.subject}」
+				</span>
+				<div className="flex-1" />
+				<button
+					onClick={() => setCcOpen((o) => !o)}
+					className={`tap text-[10px] ${ccOpen ? "text-blue-600" : "text-gray-500 hover:text-blue-600"}`}
+				>
+					{ccOpen ? "收起抄送" : "抄送"}
+				</button>
+			</div>
 
-      <AddressInput value={to} onChange={setTo} placeholder="新收件人：pi@root.new" />
+			<AddressInput
+				value={to}
+				onChange={setTo}
+				placeholder="新收件人：pi@root.new"
+			/>
 
-      {ccOpen && (
-        <AddressInput
-          value={cc}
-          onChange={setCc}
-          allowMultiple
-          placeholder="抄送：逗号分隔，可多个"
-        />
-      )}
+			{ccOpen && (
+				<AddressInput
+					value={cc}
+					onChange={setCc}
+					allowMultiple
+					placeholder="抄送：逗号分隔，可多个"
+				/>
+			)}
 
-      <textarea
-        value={comment}
-        onChange={e => setComment(e.target.value)}
-        placeholder="转发说明（可选，置于引用原文之前；原文将以引用块附在下方）"
-        className="w-full h-16 text-sm border border-gray-300 rounded-md p-2.5 resize-none focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
-      />
+			<textarea
+				value={comment}
+				onChange={(e) => setComment(e.target.value)}
+				placeholder="转发说明（可选，置于引用原文之前；原文将以引用块附在下方）"
+				className="w-full h-16 text-sm border border-gray-300 rounded-md p-2.5 resize-none focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
+			/>
 
-      <div className="flex items-center gap-2 flex-wrap">
-        {error && <span className="text-xs text-red-600 min-w-0 break-words">{error}</span>}
-        <div className="flex-1" />
-        <button onClick={onClose} className="tap px-3 py-1.5 text-xs text-gray-500 hover:text-gray-800">
-          取消
-        </button>
-        <button
-          onClick={submit}
-          disabled={busy || !to.trim()}
-          className="tap px-4 py-1.5 text-xs font-medium rounded-md bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40 disabled:cursor-not-allowed"
-        >
-          {busy ? '转发中' : '转发'}
-        </button>
-      </div>
-    </div>
-  );
+			<div className="flex items-center gap-2 flex-wrap">
+				{error && (
+					<span className="text-xs text-red-600 min-w-0 break-words">
+						{error}
+					</span>
+				)}
+				<div className="flex-1" />
+				<button
+					onClick={onClose}
+					className="tap px-3 py-1.5 text-xs text-gray-500 hover:text-gray-800"
+				>
+					取消
+				</button>
+				<button
+					onClick={submit}
+					disabled={busy || !to.trim()}
+					className="tap px-4 py-1.5 text-xs font-medium rounded-md bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40 disabled:cursor-not-allowed"
+				>
+					{busy ? "转发中" : "转发"}
+				</button>
+			</div>
+		</div>
+	);
 }
 
 function Header({
-  mail,
-  onRead,
-  onForward,
-  onThread
+	mail,
+	onRead,
+	onForward,
+	onThread,
 }: {
-  mail: Mail;
-  onRead: () => void;
-  onForward: () => void;
-  onThread: () => void;
+	mail: Mail;
+	onRead: () => void;
+	onForward: () => void;
+	onThread: () => void;
 }) {
-  const time = new Date(mail.created_at).toLocaleString('zh-CN');
+	const time = new Date(mail.created_at).toLocaleString("zh-CN");
 
-  // 发件/收件行显示**各方在这条会话里的完整地址**，人与 Agent 带的段数不同：
-  //
-  //   Agent → `pi@/home/program/agentmail.<会话别名>`  三段才唯一确定
-  //   人    → `jianf`                                   人没有目录也不需要会话位
-  //
-  // 此前这里有两处错：别名被拼给了**发件人**（`jianf.<别名>` —— 既指错归属，
-  // 又因为人没有工作目录而拼出 path 位为空的非法地址），以及收件人**没有**
-  // 别名（`pi@/home/program/agentmail` 指向默认会话，不是人指定的那条）。
-  //
-  // workspace 取 `session_workspace` 而不是 from/to_workspace：后者对 Agent
-  // 存的是 Agent 名而非路径（历史遗留），拿它拼会得到 `dsh@dsh`。
-  const ws = mail.session_workspace || '';
-  const from = participantAddress(
-    mail.from_name,
-    mail.from_human,
-    mail.from_human ? '' : ws,
-    mail.session_alias
-  );
-  const to = participantAddress(
-    mail.to_name,
-    mail.to_human,
-    mail.to_human ? '' : ws,
-    mail.session_alias
-  );
+	// 发件/收件行显示**各方在这条会话里的完整地址**，人与 Agent 带的段数不同：
+	//
+	//   Agent → `pi@/home/program/agentmail.<会话别名>`  三段才唯一确定
+	//   人    → `jianf`                                   人没有目录也不需要会话位
+	//
+	// 此前这里有两处错：别名被拼给了**发件人**（`jianf.<别名>` —— 既指错归属，
+	// 又因为人没有工作目录而拼出 path 位为空的非法地址），以及收件人**没有**
+	// 别名（`pi@/home/program/agentmail` 指向默认会话，不是人指定的那条）。
+	//
+	// workspace 取 `session_workspace` 而不是 from/to_workspace：后者对 Agent
+	// 存的是 Agent 名而非路径（历史遗留），拿它拼会得到 `dsh@dsh`。
+	const ws = mail.session_workspace || "";
+	const from = participantAddress(
+		mail.from_name,
+		mail.from_human,
+		mail.from_human ? "" : ws,
+		mail.session_alias,
+	);
+	const to = participantAddress(
+		mail.to_name,
+		mail.to_human,
+		mail.to_human ? "" : ws,
+		mail.session_alias,
+	);
 
-  return (
-    <div className="px-4 md:px-6 py-3 md:py-4 border-b border-gray-200">
-      <div className="flex items-center gap-2 mb-1.5 flex-wrap">
-        <BackButton />
-        <h2 className="text-sm font-semibold text-gray-900 min-w-0 break-words">{mail.subject}</h2>
-        {mail.status === 'unread' && (
-          <span className="px-1.5 py-0.5 rounded bg-blue-100 text-blue-700 text-[10px] font-medium">
-            未读
-          </span>
-        )}
-        {mail.mail_type === 'permission_request' && (
-          <span className="inline-flex items-center gap-1 px-1.5 py-0.5 rounded bg-orange-100 text-orange-700 text-[10px] font-medium">
-            <ShieldIcon className="w-3 h-3" />
-            权限请求
-          </span>
-        )}
-        <div className="flex-1" />
-        {mail.status === 'unread' && (
-          <button onClick={onRead} className="tap text-xs text-blue-500 hover:underline">
-            标记已读
-          </button>
-        )}
-        <button
-          onClick={onThread}
-          className="tap inline-flex items-center gap-1 text-xs text-gray-500 hover:text-gray-900"
-          title="沿回复与转发关系展开整条线索"
-        >
-          <TreeIcon className="w-3.5 h-3.5" />
-          对话树
-        </button>
-        <button
-          onClick={onForward}
-          className="tap inline-flex items-center gap-1 text-xs text-gray-500 hover:text-gray-900"
-        >
-          <ForwardIcon className="w-3.5 h-3.5" />
-          转发
-        </button>
-      </div>
+	return (
+		<div className="px-4 md:px-6 py-3 md:py-4 border-b border-gray-200">
+			<div className="flex items-center gap-2 mb-1.5 flex-wrap">
+				<BackButton />
+				<h2 className="text-sm font-semibold text-gray-900 min-w-0 break-words">
+					{mail.subject}
+				</h2>
+				{mail.status === "unread" && (
+					<span className="px-1.5 py-0.5 rounded bg-blue-100 text-blue-700 text-[10px] font-medium">
+						未读
+					</span>
+				)}
+				{mail.mail_type === "permission_request" && (
+					<span className="inline-flex items-center gap-1 px-1.5 py-0.5 rounded bg-orange-100 text-orange-700 text-[10px] font-medium">
+						<ShieldIcon className="w-3 h-3" />
+						权限请求
+					</span>
+				)}
+				<div className="flex-1" />
+				{mail.status === "unread" && (
+					<button
+						onClick={onRead}
+						className="tap text-xs text-blue-500 hover:underline"
+					>
+						标记已读
+					</button>
+				)}
+				<button
+					onClick={onThread}
+					className="tap inline-flex items-center gap-1 text-xs text-gray-500 hover:text-gray-900"
+					title="沿回复与转发关系展开整条线索"
+				>
+					<TreeIcon className="w-3.5 h-3.5" />
+					对话树
+				</button>
+				<button
+					onClick={onForward}
+					className="tap inline-flex items-center gap-1 text-xs text-gray-500 hover:text-gray-900"
+				>
+					<ForwardIcon className="w-3.5 h-3.5" />
+					转发
+				</button>
+			</div>
 
-      <dl className="text-xs text-gray-500 space-y-0.5">
-        <Row label="发件">{from}</Row>
-        <Row label="收件">{to}</Row>
-        {mail.cc_list?.length > 0 && (
-          <Row label="抄送">
-            {mail.cc_list.map(a => a.raw || `${a.name}@${a.path || ''}`).join('、')}
-          </Row>
-        )}
-        <Row label="时间">{time}</Row>
-      </dl>
-    </div>
-  );
+			<dl className="text-xs text-gray-500 space-y-0.5">
+				<Row label="发件">{from}</Row>
+				<Row label="收件">{to}</Row>
+				{mail.cc_list?.length > 0 && (
+					<Row label="抄送">
+						{mail.cc_list
+							.map((a) => a.raw || `${a.name}@${a.path || ""}`)
+							.join("、")}
+					</Row>
+				)}
+				<Row label="时间">{time}</Row>
+			</dl>
+		</div>
+	);
 }
 
-function Row({ label, children }: { label: string; children: React.ReactNode }) {
-  return (
-    <div className="flex gap-2">
-      <dt className="w-8 shrink-0 text-gray-400">{label}</dt>
-      {/* min-w-0 + break-all：会话别名可达 128 字节，不给收缩权会把整行撑出容器 */}
-      <dd className="min-w-0 font-mono text-gray-600 break-all">{children}</dd>
-    </div>
-  );
+function Row({
+	label,
+	children,
+}: {
+	label: string;
+	children: React.ReactNode;
+}) {
+	return (
+		<div className="flex gap-2">
+			<dt className="w-8 shrink-0 text-gray-400">{label}</dt>
+			{/* min-w-0 + break-all：会话别名可达 128 字节，不给收缩权会把整行撑出容器 */}
+			<dd className="min-w-0 font-mono text-gray-600 break-all">{children}</dd>
+		</div>
+	);
 }
 
-function ThreadCard({ mail, onForward }: { mail: Mail; onForward?: () => void }) {
-  // 「这封是我发的吗」而不是「发件人叫 human 吗」：多用户下登录名可能是
-  // jianf，写死 'human' 会让自己发的信显示成机器人图标。
-  const me = useAuthStore(s => s.user?.username || '');
-  const isMine = !!me && mail.from_name === me;
-  const isPermission = mail.mail_type === 'permission_request';
-  const time = new Date(mail.created_at).toLocaleString('zh-CN');
+function ThreadCard({
+	mail,
+	onForward,
+}: {
+	mail: Mail;
+	onForward?: () => void;
+}) {
+	// 「这封是我发的吗」而不是「发件人叫 human 吗」：多用户下登录名可能是
+	// jianf，写死 'human' 会让自己发的信显示成机器人图标。
+	const me = useAuthStore((s) => s.user?.username || "");
+	const isMine = !!me && mail.from_name === me;
+	const isPermission = mail.mail_type === "permission_request";
+	const time = new Date(mail.created_at).toLocaleString("zh-CN");
 
-  return (
-    <div
-      className={`rounded-lg border p-4 ${
-        isPermission
-          ? 'border-orange-200 bg-orange-50'
-          : isMine
-          ? 'border-blue-200 bg-blue-50/60'
-          : 'border-gray-200 bg-white'
-      }`}
-    >
-      <div className="flex items-center gap-1.5 mb-2 text-xs">
-        {isMine ? (
-          <PersonIcon className="w-3.5 h-3.5 text-blue-600" />
-        ) : (
-          <BotIcon className="w-3.5 h-3.5 text-slate-600" />
-        )}
-        {/* 显示真实发件人名而不是 'human'：会话里可能有多个人类参与方，
+	return (
+		<div
+			className={`rounded-lg border p-4 ${
+				isPermission
+					? "border-orange-200 bg-orange-50"
+					: isMine
+						? "border-blue-200 bg-blue-50/60"
+						: "border-gray-200 bg-white"
+			}`}
+		>
+			<div className="flex items-center gap-1.5 mb-2 text-xs">
+				{isMine ? (
+					<PersonIcon className="w-3.5 h-3.5 text-blue-600" />
+				) : (
+					<BotIcon className="w-3.5 h-3.5 text-slate-600" />
+				)}
+				{/* 显示真实发件人名而不是 'human'：会话里可能有多个人类参与方，
             都渲染成 human 就分不清谁说的话 */}
-        <span className="font-semibold text-gray-800 font-mono">{mail.from_name}</span>
-        {isPermission && (
-          <span className="px-1 py-0.5 rounded bg-orange-200 text-orange-800 text-[9px] font-medium">
-            权限请求
-          </span>
-        )}
-        {mail.cc_list?.length > 0 && (
-          <span
-            className="text-[10px] text-gray-400"
-            title={mail.cc_list.map(c => c.raw || `${c.name}@${c.path || ''}`).join(', ')}
-          >
-            抄送 {mail.cc_list.length}
-          </span>
-        )}
-        <div className="flex-1" />
-        <span className="text-[10px] text-gray-400">{time}</span>
-        {onForward && (
-          <button
-            onClick={onForward}
-            title="转发这封"
-            className="text-gray-400 hover:text-blue-600"
-          >
-            <ForwardIcon className="w-3 h-3" />
-          </button>
-        )}
-      </div>
-      <div className="markdown text-sm">
-        <Markdown remarkPlugins={[remarkGfm]}>{mail.body}</Markdown>
-      </div>
-      <AttachmentList items={mail.attachments ?? []} />
-      {isPermission && <PermissionPanel mail={mail} />}
-    </div>
-  );
+				<span className="font-semibold text-gray-800 font-mono">
+					{mail.from_name}
+				</span>
+				{isPermission && (
+					<span className="px-1 py-0.5 rounded bg-orange-200 text-orange-800 text-[9px] font-medium">
+						权限请求
+					</span>
+				)}
+				{mail.cc_list?.length > 0 && (
+					<span
+						className="text-[10px] text-gray-400"
+						title={mail.cc_list
+							.map((c) => c.raw || `${c.name}@${c.path || ""}`)
+							.join(", ")}
+					>
+						抄送 {mail.cc_list.length}
+					</span>
+				)}
+				<div className="flex-1" />
+				<span className="text-[10px] text-gray-400">{time}</span>
+				{onForward && (
+					<button
+						onClick={onForward}
+						title="转发这封"
+						className="text-gray-400 hover:text-blue-600"
+					>
+						<ForwardIcon className="w-3 h-3" />
+					</button>
+				)}
+			</div>
+			<div className="markdown text-sm">
+				<Markdown remarkPlugins={[remarkGfm]}>{mail.body}</Markdown>
+			</div>
+			<AttachmentList items={mail.attachments ?? []} />
+			{isPermission && <PermissionPanel mail={mail} />}
+		</div>
+	);
 }
 
 /**
@@ -601,346 +677,387 @@ function ThreadCard({ mail, onForward }: { mail: Mail; onForward?: () => void })
  * 那些铺垫与这个组件本身的行为无关。
  */
 export function PermissionPanel({ mail }: { mail: Mail }) {
-  const isQuestion = mail.permission_kind === 'question';
-  const [note, setNote] = useState('');
-  const [busy, setBusy] = useState(false);
-  const [decided, setDecided] = useState(mail.permission_result || '');
-  // 问题模式下已勾选的选项（多选时是多个）。
-  const [picked, setPicked] = useState<string[]>([]);
-  const fetchInbox = useMailStore(s => s.fetchInbox);
-  const selectSession = useSessionStore(s => s.selectSession);
+	const isQuestion = mail.permission_kind === "question";
+	const [note, setNote] = useState("");
+	const [busy, setBusy] = useState(false);
+	const [decided, setDecided] = useState(mail.permission_result || "");
+	// 问题模式下已勾选的选项（多选时是多个）。
+	const [picked, setPicked] = useState<string[]>([]);
+	const fetchInbox = useMailStore((s) => s.fetchInbox);
+	const selectSession = useSessionStore((s) => s.selectSession);
 
-  const submit = async (decision: string, noteText: string) => {
-    setBusy(true);
-    try {
-      await api.decidePermission(mail.mail_id, decision, noteText || undefined);
-      setDecided(decision || '（自由文本回答）');
-      await fetchInbox('all');
-      if (mail.session_id) selectSession(mail.session_id);
-    } catch (err) {
-      console.error(err);
-    } finally {
-      setBusy(false);
-    }
-  };
+	const submit = async (decision: string, noteText: string) => {
+		setBusy(true);
+		try {
+			await api.decidePermission(mail.mail_id, decision, noteText || undefined);
+			setDecided(decision || "（自由文本回答）");
+			await fetchInbox("all");
+			if (mail.session_id) selectSession(mail.session_id);
+		} catch (err) {
+			console.error(err);
+		} finally {
+			setBusy(false);
+		}
+	};
 
-  if (decided) {
-    return (
-      <div className="mt-3 pt-2.5 border-t border-orange-200 text-xs text-gray-600">
-        已处理：
-        <strong className="text-gray-800 whitespace-pre-wrap">{decided}</strong>
-      </div>
-    );
-  }
+	if (decided) {
+		return (
+			<div className="mt-3 pt-2.5 border-t border-orange-200 text-xs text-gray-600">
+				已处理：
+				<strong className="text-gray-800 whitespace-pre-wrap">{decided}</strong>
+			</div>
+		);
+	}
 
-  // ─── 主动提问：勾选 + 自由文本 ───
-  if (isQuestion) {
-    const options = mail.permission_options ?? [];
-    const multi = mail.permission_multi_select === true;
-    const toggle = (opt: string) => {
-      setPicked(prev => {
-        if (multi) return prev.includes(opt) ? prev.filter(p => p !== opt) : [...prev, opt];
-        // 单选：再点同一项则取消，否则替换
-        return prev.includes(opt) ? [] : [opt];
-      });
-    };
-    // 回答必须非空：空提交会让模型拿到一个什么都没说的结果继续跑。
-    const blank = picked.length === 0 && note.trim().length === 0;
+	// ─── 主动提问：勾选 + 自由文本 ───
+	if (isQuestion) {
+		const options = mail.permission_options ?? [];
+		const multi = mail.permission_multi_select === true;
+		const toggle = (opt: string) => {
+			setPicked((prev) => {
+				if (multi)
+					return prev.includes(opt)
+						? prev.filter((p) => p !== opt)
+						: [...prev, opt];
+				// 单选：再点同一项则取消，否则替换
+				return prev.includes(opt) ? [] : [opt];
+			});
+		};
+		// 回答必须非空：空提交会让模型拿到一个什么都没说的结果继续跑。
+		const blank = picked.length === 0 && note.trim().length === 0;
 
-    return (
-      <div className="mt-3 pt-3 border-t border-orange-200">
-        <div className="text-[11px] text-gray-500 mb-2">
-          {options.length === 0
-            ? '这题没有预设选项，请直接填写回答：'
-            : multi ? '可多选，也可补充说明：' : '请选择一项，也可补充说明：'}
-        </div>
+		return (
+			<div className="mt-3 pt-3 border-t border-orange-200">
+				<div className="text-[11px] text-gray-500 mb-2">
+					{options.length === 0
+						? "这题没有预设选项，请直接填写回答："
+						: multi
+							? "可多选，也可补充说明："
+							: "请选择一项，也可补充说明："}
+				</div>
 
-        {options.length > 0 && (
-          <div className="flex flex-wrap gap-2">
-            {options.map(opt => {
-              const on = picked.includes(opt);
-              return (
-                <button
-                  key={opt}
-                  onClick={() => toggle(opt)}
-                  disabled={busy}
-                  aria-pressed={on}
-                  className={`inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium rounded-md border transition-colors disabled:opacity-40 ${
-                    on
-                      ? 'bg-blue-700 text-white border-blue-700 hover:bg-blue-800'
-                      : 'bg-white text-gray-700 border-gray-300 hover:bg-gray-50'
-                  }`}
-                >
-                  {on && <CheckIcon className="w-3.5 h-3.5" />}
-                  {opt}
-                </button>
-              );
-            })}
-          </div>
-        )}
+				{options.length > 0 && (
+					<div className="flex flex-wrap gap-2">
+						{options.map((opt) => {
+							const on = picked.includes(opt);
+							return (
+								<button
+									key={opt}
+									onClick={() => toggle(opt)}
+									disabled={busy}
+									aria-pressed={on}
+									className={`inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium rounded-md border transition-colors disabled:opacity-40 ${
+										on
+											? "bg-blue-700 text-white border-blue-700 hover:bg-blue-800"
+											: "bg-white text-gray-700 border-gray-300 hover:bg-gray-50"
+									}`}
+								>
+									{on && <CheckIcon className="w-3.5 h-3.5" />}
+									{opt}
+								</button>
+							);
+						})}
+					</div>
+				)}
 
-        <textarea
-          value={note}
-          onChange={e => setNote(e.target.value)}
-          rows={options.length === 0 ? 3 : 2}
-          placeholder={options.length === 0 ? '你的回答（必填）' : '补充说明（可选）'}
-          className="mt-2 w-full text-xs border border-gray-300 rounded-md px-2.5 py-1.5 resize-y focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
-        />
+				<textarea
+					value={note}
+					onChange={(e) => setNote(e.target.value)}
+					rows={options.length === 0 ? 3 : 2}
+					placeholder={
+						options.length === 0 ? "你的回答（必填）" : "补充说明（可选）"
+					}
+					className="mt-2 w-full text-xs border border-gray-300 rounded-md px-2.5 py-1.5 resize-y focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
+				/>
 
-        <div className="mt-2 flex items-center gap-2">
-          <button
-            onClick={() => submit(picked.join('\n'), note.trim())}
-            disabled={busy || blank}
-            className="inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium rounded-md bg-blue-700 text-white hover:bg-blue-800 disabled:opacity-40"
-          >
-            提交回答
-          </button>
-          {blank && (
-            <span className="text-[11px] text-gray-400">请先选择或填写回答</span>
-          )}
-        </div>
-      </div>
-    );
-  }
+				<div className="mt-2 flex items-center gap-2">
+					<button
+						onClick={() => submit(picked.join("\n"), note.trim())}
+						disabled={busy || blank}
+						className="inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium rounded-md bg-blue-700 text-white hover:bg-blue-800 disabled:opacity-40"
+					>
+						提交回答
+					</button>
+					{blank && (
+						<span className="text-[11px] text-gray-400">
+							请先选择或填写回答
+						</span>
+					)}
+				</div>
+			</div>
+		);
+	}
 
-  // ─── 审批型：批准 / 拒绝 ───
-  const options = mail.permission_options?.length ? mail.permission_options : ['同意', '拒绝'];
-  const isApprove = (s: string) => /同意|允许|批准|approve|yes/i.test(s);
+	// ─── 审批型：批准 / 拒绝 ───
+	const options = mail.permission_options?.length
+		? mail.permission_options
+		: ["同意", "拒绝"];
+	const isApprove = (s: string) => /同意|允许|批准|approve|yes/i.test(s);
 
-  return (
-    <div className="mt-3 pt-3 border-t border-orange-200">
-      <div className="flex flex-wrap gap-2">
-        {options.map(opt => (
-          <button
-            key={opt}
-            onClick={() => submit(opt, note)}
-            disabled={busy}
-            className={`inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium rounded-md transition-colors disabled:opacity-40 ${
-              isApprove(opt)
-                ? 'bg-green-700 text-white hover:bg-green-800'
-                : 'bg-red-50 text-red-700 border border-red-200 hover:bg-red-100'
-            }`}
-          >
-            {isApprove(opt) ? (
-              <CheckIcon className="w-3.5 h-3.5" />
-            ) : (
-              <CloseIcon className="w-3.5 h-3.5" />
-            )}
-            {opt}
-          </button>
-        ))}
-      </div>
-      <input
-        value={note}
-        onChange={e => setNote(e.target.value)}
-        placeholder="备注（可选）"
-        className="mt-2 w-full text-xs border border-gray-300 rounded-md px-2.5 py-1.5 focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
-      />
-    </div>
-  );
+	return (
+		<div className="mt-3 pt-3 border-t border-orange-200">
+			<div className="flex flex-wrap gap-2">
+				{options.map((opt) => (
+					<button
+						key={opt}
+						onClick={() => submit(opt, note)}
+						disabled={busy}
+						className={`inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium rounded-md transition-colors disabled:opacity-40 ${
+							isApprove(opt)
+								? "bg-green-700 text-white hover:bg-green-800"
+								: "bg-red-50 text-red-700 border border-red-200 hover:bg-red-100"
+						}`}
+					>
+						{isApprove(opt) ? (
+							<CheckIcon className="w-3.5 h-3.5" />
+						) : (
+							<CloseIcon className="w-3.5 h-3.5" />
+						)}
+						{opt}
+					</button>
+				))}
+			</div>
+			<input
+				value={note}
+				onChange={(e) => setNote(e.target.value)}
+				placeholder="备注（可选）"
+				className="mt-2 w-full text-xs border border-gray-300 rounded-md px-2.5 py-1.5 focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
+			/>
+		</div>
+	);
 }
 
 function ReplyBar({
-  replyTo,
-  /**
-   * 会话视图传进来的目标地址，覆盖「按锚点邮件推断」。
-   *
-   * 会话视图的语义是「跟这个 Agent 的一次任务」，对端是会话的属性；
-   * 单封邮件视图没有这层语境，才回落到按那封邮件推断。
-   */
-  overrideTarget
+	replyTo,
+	/**
+	 * 会话视图传进来的目标地址，覆盖「按锚点邮件推断」。
+	 *
+	 * 会话视图的语义是「跟这个 Agent 的一次任务」，对端是会话的属性；
+	 * 单封邮件视图没有这层语境，才回落到按那封邮件推断。
+	 */
+	overrideTarget,
 }: {
-  replyTo?: Mail;
-  overrideTarget?: string;
+	replyTo?: Mail;
+	overrideTarget?: string;
 }) {
-  const [body, setBody] = useState('');
-  const [cc, setCc] = useState('');
-  // 抄送默认收起：多数回复不需要它，常驻一行输入框只会挤掉正文空间。
-  // 原邮件带抄送时自动展开并预填 —— 「回复全部」是人在这种场景下的默认预期
-  const [ccOpen, setCcOpen] = useState(false);
-  const [budgetEditing, setBudgetEditing] = useState(false);
-  const [budgetBusy, setBudgetBusy] = useState(false);
-  const [maxRoundsDraft, setMaxRoundsDraft] = useState('');
-  const [attachments, setAttachments] = useState<PendingAttachment[]>([]);
-  const [busy, setBusy] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const fetchInbox = useMailStore(s => s.fetchInbox);
-  const fetchSent = useMailStore(s => s.fetchSent);
-  const fetchSessions = useSessionStore(s => s.fetchSessions);
-  const fetchContacts = useContactStore(s => s.fetchContacts);
-  const selectSession = useSessionStore(s => s.selectSession);
-  const budget = useSessionStore(s => s.budget);
-  const setBudget = useSessionStore(s => s.setBudget);
-  const me = useAuthStore(s => s.user?.username || '');
+	const [body, setBody] = useState("");
+	const [cc, setCc] = useState("");
+	// 抄送默认收起：多数回复不需要它，常驻一行输入框只会挤掉正文空间。
+	// 原邮件带抄送时自动展开并预填 —— 「回复全部」是人在这种场景下的默认预期
+	const [ccOpen, setCcOpen] = useState(false);
+	const [budgetEditing, setBudgetEditing] = useState(false);
+	const [budgetBusy, setBudgetBusy] = useState(false);
+	const [maxRoundsDraft, setMaxRoundsDraft] = useState("");
+	const [attachments, setAttachments] = useState<PendingAttachment[]>([]);
+	const [busy, setBusy] = useState(false);
+	const [error, setError] = useState<string | null>(null);
+	const fetchInbox = useMailStore((s) => s.fetchInbox);
+	const fetchSent = useMailStore((s) => s.fetchSent);
+	const fetchSessions = useSessionStore((s) => s.fetchSessions);
+	const fetchContacts = useContactStore((s) => s.fetchContacts);
+	const selectSession = useSessionStore((s) => s.selectSession);
+	const budget = useSessionStore((s) => s.budget);
+	const setBudget = useSessionStore((s) => s.setBudget);
+	const me = useAuthStore((s) => s.user?.username || "");
 
-  if (!replyTo) return null;
+	if (!replyTo) return null;
 
-  // 判据是「当前登录用户名」而不是字面量 'human'：后者是单用户时代的遗留，
-  // 多用户下登录名可能是 jianf，判据恒为假 → 对端取成自己 → 信发给自己。
-  const peer = mailCounterpart(replyTo, me);
-  const target = overrideTarget || mailReplyTarget(replyTo, me);
+	// 判据是「当前登录用户名」而不是字面量 'human'：后者是单用户时代的遗留，
+	// 多用户下登录名可能是 jianf，判据恒为假 → 对端取成自己 → 信发给自己。
+	const peer = mailCounterpart(replyTo, me);
+	const target = overrideTarget || mailReplyTarget(replyTo, me);
 
-  const send = async () => {
-    if (!body.trim()) return;
-    setBusy(true);
-    setError(null);
-    try {
-      await api.sendMail(target, `Re: ${replyTo.subject}`, body, {
-        reply_to: replyTo.mail_id,
-        cc: cc.trim(),
-        attachment_ids: attachments.map(a => a.id)
-      });
-      setBody('');
-      setCc('');
-      setCcOpen(false);
-      setAttachments([]);
-      await Promise.all([fetchInbox('all'), fetchSent(), fetchSessions(), fetchContacts()]);
-      if (replyTo.session_id) selectSession(replyTo.session_id);
-    } catch (err) {
-      // 必须显示出来：预算耗尽、地址不存在、速率限制都会走到这里，
-      // 原先只 console.error，用户点了发送什么反应都没有
-      setError(err instanceof Error ? err.message : String(err));
-    } finally {
-      setBusy(false);
-    }
-  };
+	const send = async () => {
+		if (!body.trim()) return;
+		setBusy(true);
+		setError(null);
+		try {
+			await api.sendMail(target, `Re: ${replyTo.subject}`, body, {
+				reply_to: replyTo.mail_id,
+				cc: cc.trim(),
+				attachment_ids: attachments.map((a) => a.id),
+			});
+			setBody("");
+			setCc("");
+			setCcOpen(false);
+			setAttachments([]);
+			await Promise.all([
+				fetchInbox("all"),
+				fetchSent(),
+				fetchSessions(),
+				fetchContacts(),
+			]);
+			if (replyTo.session_id) selectSession(replyTo.session_id);
+		} catch (err) {
+			// 必须显示出来：预算耗尽、地址不存在、速率限制都会走到这里，
+			// 原先只 console.error，用户点了发送什么反应都没有
+			setError(err instanceof Error ? err.message : String(err));
+		} finally {
+			setBusy(false);
+		}
+	};
 
-  /**
-   * 「回复全部」：把原邮件的其他参与方填进抄送。
-   *
-   * cc_list 是结构化的 Address（后端解析过三维寻址）。传当前会话别名进去，
-   * 让 `.new` 被换成真实别名 —— 原样回填 `.new` 会让这封回复给抄送方
-   * **另开一条新会话**，于是同一件事裂成两条线索。
-   */
-  const replyAll = () => {
-    // 去重与「去掉自己」都在 replyAllCC 里：原先用 !a.startsWith('human')
-    // 去自己，同一个遗留判据 —— 去不掉 jianf，点「回复全部」会把自己抄送进去。
-    setCc(replyAllCC(replyTo, me, peer.name).join(', '));
-    setCcOpen(true);
-  };
+	/**
+	 * 「回复全部」：把原邮件的其他参与方填进抄送。
+	 *
+	 * cc_list 是结构化的 Address（后端解析过三维寻址）。传当前会话别名进去，
+	 * 让 `.new` 被换成真实别名 —— 原样回填 `.new` 会让这封回复给抄送方
+	 * **另开一条新会话**，于是同一件事裂成两条线索。
+	 */
+	const replyAll = () => {
+		// 去重与「去掉自己」都在 replyAllCC 里：原先用 !a.startsWith('human')
+		// 去自己，同一个遗留判据 —— 去不掉 jianf，点「回复全部」会把自己抄送进去。
+		setCc(replyAllCC(replyTo, me, peer.name).join(", "));
+		setCcOpen(true);
+	};
 
-  return (
-    <div className="shrink-0 max-h-[min(65vh,calc(var(--app-height)-3rem))] overflow-y-auto overscroll-contain border-t border-gray-200 bg-white px-4 md:px-6 py-3">
-      <div className="flex items-center gap-2 mb-1 flex-wrap">
-        <p className="text-[10px] text-gray-400 font-mono min-w-0 truncate">回复 {target}</p>
-        <div className="flex-1" />
-        {(replyTo.cc_list?.length ?? 0) > 0 && (
-          <button
-            onClick={replyAll}
-            className="tap text-[10px] text-gray-500 hover:text-blue-600"
-          >
-            回复全部
-          </button>
-        )}
-        <button
-          onClick={() => setCcOpen(o => !o)}
-          className={`tap text-[10px] ${ccOpen ? 'text-blue-600' : 'text-gray-500 hover:text-blue-600'}`}
-        >
-          {ccOpen ? '收起抄送' : '抄送'}
-        </button>
-      </div>
-      {ccOpen && (
-        <div className="mb-2">
-          <AddressInput
-            value={cc}
-            onChange={setCc}
-            allowMultiple
-            placeholder="抄送：逗号分隔，可多个（如 pi@root, ops@root）"
-          />
-        </div>
-      )}
-      <textarea
-        value={body}
-        onChange={e => setBody(e.target.value)}
-        placeholder="回复内容（Markdown）"
-        className="w-full h-20 text-sm font-mono border border-gray-300 rounded-md p-3 resize-none focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
-      />
-      <div className="mt-2">
-        <AttachmentPicker items={attachments} onChange={setAttachments} disabled={busy} />
-      </div>
-      <div className="flex items-center gap-2 mt-2 flex-wrap">
-        {error && <span className="text-xs text-red-600 min-w-0 break-words">{error}</span>}
-        <div className="flex-1" />
-        {budget && !budgetEditing && (
-          <button
-            onClick={() => {
-              setMaxRoundsDraft(budget.unlimited ? '' : String(budget.max_rounds));
-              setBudgetEditing(true);
-            }}
-            title="本任务往返预算：Agent 主动发信上限（自动转发与权限询问不占）"
-            className={`tap inline-flex items-center gap-1 text-[10px] px-2 py-1 rounded border ${
-              budget.unlimited
-                ? 'border-gray-200 text-gray-500 hover:border-blue-300'
-                : budget.remaining === 0
-                  ? 'border-red-200 text-red-600'
-                  : 'border-gray-200 text-gray-500 hover:border-blue-300'
-            }`}
-          >
-            <GaugeIcon className="w-3 h-3" />
-            {budget.unlimited
-              ? '预算不限'
-              : `${budget.used_rounds}/${budget.max_rounds} 来回${budget.remaining === 0 ? ' · 已用尽' : ''}`}
-          </button>
-        )}
-        {budget && budgetEditing && (
-          <span className="inline-flex items-center gap-1">
-            <span className="text-[10px] text-gray-500">预算</span>
-            <input
-              value={maxRoundsDraft}
-              onChange={e => setMaxRoundsDraft(e.target.value)}
-              inputMode="numeric"
-              placeholder="不限"
-              autoFocus
-              className="w-14 text-xs border border-gray-300 rounded px-1.5 py-0.5 focus:outline-none focus:ring-2 focus:ring-blue-100"
-            />
-            <button
-              disabled={budgetBusy || (maxRoundsDraft.trim() !== '' && !/^\d+$/.test(maxRoundsDraft.trim()))}
-              onClick={async () => {
-                setBudgetBusy(true);
-                await setBudget({ max_rounds: maxRoundsDraft.trim() === '' ? 0 : Number(maxRoundsDraft.trim()) });
-                setBudgetBusy(false);
-                setBudgetEditing(false);
-              }}
-              className="tap px-2 py-0.5 text-[10px] rounded bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40"
-            >
-              保存
-            </button>
-            <button
-              onClick={() => setBudgetEditing(false)}
-              className="tap text-[10px] text-gray-400 hover:text-gray-700"
-            >
-              ×
-            </button>
-          </span>
-        )}
-        <button
-          onClick={() => {
-            setBody('');
-            setError(null);
-          }}
-          className="tap px-3 py-1.5 text-xs text-gray-500 hover:text-gray-800"
-        >
-          清空
-        </button>
-        <button
-          onClick={send}
-          disabled={busy || !body.trim()}
-          className="tap px-4 py-1.5 text-xs font-medium rounded-md bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40 disabled:cursor-not-allowed"
-        >
-          {busy ? '发送中' : '发送'}
-        </button>
-      </div>
-    </div>
-  );
+	return (
+		<div className="shrink-0 max-h-[min(65vh,calc(var(--app-height)-3rem))] overflow-y-auto overscroll-contain border-t border-gray-200 bg-white px-4 md:px-6 py-3">
+			<div className="flex items-center gap-2 mb-1 flex-wrap">
+				<p className="text-[10px] text-gray-400 font-mono min-w-0 truncate">
+					回复 {target}
+				</p>
+				<div className="flex-1" />
+				{(replyTo.cc_list?.length ?? 0) > 0 && (
+					<button
+						onClick={replyAll}
+						className="tap text-[10px] text-gray-500 hover:text-blue-600"
+					>
+						回复全部
+					</button>
+				)}
+				<button
+					onClick={() => setCcOpen((o) => !o)}
+					className={`tap text-[10px] ${ccOpen ? "text-blue-600" : "text-gray-500 hover:text-blue-600"}`}
+				>
+					{ccOpen ? "收起抄送" : "抄送"}
+				</button>
+			</div>
+			{ccOpen && (
+				<div className="mb-2">
+					<AddressInput
+						value={cc}
+						onChange={setCc}
+						allowMultiple
+						placeholder="抄送：逗号分隔，可多个（如 pi@root, ops@root）"
+					/>
+				</div>
+			)}
+			<textarea
+				value={body}
+				onChange={(e) => setBody(e.target.value)}
+				placeholder="回复内容（Markdown）"
+				className="w-full h-20 text-sm font-mono border border-gray-300 rounded-md p-3 resize-none focus:outline-none focus:ring-2 focus:ring-blue-100 focus:border-blue-400"
+			/>
+			<div className="mt-2">
+				<AttachmentPicker
+					items={attachments}
+					onChange={setAttachments}
+					disabled={busy}
+				/>
+			</div>
+			<div className="flex items-center gap-2 mt-2 flex-wrap">
+				{error && (
+					<span className="text-xs text-red-600 min-w-0 break-words">
+						{error}
+					</span>
+				)}
+				<div className="flex-1" />
+				{budget && !budgetEditing && (
+					<button
+						onClick={() => {
+							setMaxRoundsDraft(
+								budget.unlimited ? "" : String(budget.max_rounds),
+							);
+							setBudgetEditing(true);
+						}}
+						title="本任务往返预算：Agent 主动发信上限（自动转发与权限询问不占）"
+						className={`tap inline-flex items-center gap-1 text-[10px] px-2 py-1 rounded border ${
+							budget.unlimited
+								? "border-gray-200 text-gray-500 hover:border-blue-300"
+								: budget.remaining === 0
+									? "border-red-200 text-red-600"
+									: "border-gray-200 text-gray-500 hover:border-blue-300"
+						}`}
+					>
+						<GaugeIcon className="w-3 h-3" />
+						{budget.unlimited
+							? "预算不限"
+							: `${budget.used_rounds}/${budget.max_rounds} 来回${budget.remaining === 0 ? " · 已用尽" : ""}`}
+					</button>
+				)}
+				{budget && budgetEditing && (
+					<span className="inline-flex items-center gap-1">
+						<span className="text-[10px] text-gray-500">预算</span>
+						<input
+							value={maxRoundsDraft}
+							onChange={(e) => setMaxRoundsDraft(e.target.value)}
+							inputMode="numeric"
+							placeholder="不限"
+							autoFocus
+							className="w-14 text-xs border border-gray-300 rounded px-1.5 py-0.5 focus:outline-none focus:ring-2 focus:ring-blue-100"
+						/>
+						<button
+							disabled={
+								budgetBusy ||
+								(maxRoundsDraft.trim() !== "" &&
+									!/^\d+$/.test(maxRoundsDraft.trim()))
+							}
+							onClick={async () => {
+								setBudgetBusy(true);
+								await setBudget({
+									max_rounds:
+										maxRoundsDraft.trim() === ""
+											? 0
+											: Number(maxRoundsDraft.trim()),
+								});
+								setBudgetBusy(false);
+								setBudgetEditing(false);
+							}}
+							className="tap px-2 py-0.5 text-[10px] rounded bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40"
+						>
+							保存
+						</button>
+						<button
+							onClick={() => setBudgetEditing(false)}
+							className="tap text-[10px] text-gray-400 hover:text-gray-700"
+						>
+							×
+						</button>
+					</span>
+				)}
+				<button
+					onClick={() => {
+						setBody("");
+						setError(null);
+					}}
+					className="tap px-3 py-1.5 text-xs text-gray-500 hover:text-gray-800"
+				>
+					清空
+				</button>
+				<button
+					onClick={send}
+					disabled={busy || !body.trim()}
+					className="tap px-4 py-1.5 text-xs font-medium rounded-md bg-blue-600 text-white hover:bg-blue-700 disabled:opacity-40 disabled:cursor-not-allowed"
+				>
+					{busy ? "发送中" : "发送"}
+				</button>
+			</div>
+		</div>
+	);
 }
 
 function StatusBadge({ status }: { status: string }) {
-  const map: Record<string, { label: string; cls: string }> = {
-    active: { label: '进行中', cls: 'bg-yellow-100 text-yellow-700' },
-    waiting: { label: '等待中', cls: 'bg-blue-100 text-blue-700' },
-    completed: { label: '已完成', cls: 'bg-green-100 text-green-700' },
-    archived: { label: '已归档', cls: 'bg-gray-200 text-gray-600' }
-  };
-  const b = map[status] || map.active;
-  return <span className={`text-[10px] px-1.5 py-0.5 rounded-full ${b.cls}`}>{b.label}</span>;
+	const map: Record<string, { label: string; cls: string }> = {
+		active: { label: "进行中", cls: "bg-yellow-100 text-yellow-700" },
+		waiting: { label: "等待中", cls: "bg-blue-100 text-blue-700" },
+		completed: { label: "已完成", cls: "bg-green-100 text-green-700" },
+		archived: { label: "已归档", cls: "bg-gray-200 text-gray-600" },
+	};
+	const b = map[status] || map.active;
+	return (
+		<span className={`text-[10px] px-1.5 py-0.5 rounded-full ${b.cls}`}>
+			{b.label}
+		</span>
+	);
 }
diff --git a/client/electron/src/types/index.ts b/client/electron/src/types/index.ts
index e7692a1..2826cb5 100644
--- a/client/electron/src/types/index.ts
+++ b/client/electron/src/types/index.ts
@@ -1,139 +1,139 @@
 export interface User {
-  user_id: string;
-  username: string;
-  display_name: string;
-  role: 'admin' | 'user';
-  status: 'active' | 'disabled';
-  allowed_agents: string[];
-  allowed_paths: string[];
-  last_login?: string;
-  created_at?: string;
+	user_id: string;
+	username: string;
+	display_name: string;
+	role: "admin" | "user";
+	status: "active" | "disabled";
+	allowed_agents: string[];
+	allowed_paths: string[];
+	last_login?: string;
+	created_at?: string;
 }
 
 export interface Workspace {
-  name: string;
-  path: string;
+	name: string;
+	path: string;
 }
 
 export interface Agent {
-  agent_id?: string;
-  agent_name: string;
-  workspaces: Workspace[];
-  platform: string;
-  status: string;
-  /** 派给该 Agent 的新任务默认多少个来回（0 = 不限） */
-  default_rounds?: number;
+	agent_id?: string;
+	agent_name: string;
+	workspaces: Workspace[];
+	platform: string;
+	status: string;
+	/** 派给该 Agent 的新任务默认多少个来回（0 = 不限） */
+	default_rounds?: number;
 }
 
 export interface Address {
-  name: string;
-  path: string;
-  session: string;
-  raw: string;
+	name: string;
+	path: string;
+	session: string;
+	raw: string;
 }
 
 export interface Session {
-  session_id: string;
-  session_alias: string | null;
-  from_agent: string;
-  subject: string;
-  status: string;
-  created_at: string;
-  updated_at: string;
-  mail_count?: number;
-  /**
-   * 别名是谁定的：
-   *   platform = Agent 平台自动同步来的，后续同步可以覆盖
-   *   manual   = 人显式指定（手工改名或接受了 Agent 的提议），平台同步不得覆盖
-   */
-  alias_source?: 'platform' | 'manual';
-  /** 用户驳回过的改名提议 */
-  rename_dismissed?: string;
-  /**
-   * 本任务的往返预算（0 = 本会话不限，仅受 Agent 全局配额约束）。
-   *
-   * 配额的语义是「这件事值得多少个来回」—— 那是任务的属性而非 Agent 的属性，
-   * 所以在写信时给、在对话页里随时调，而不是去管理员页面改某个 Agent 的全局配额。
-   */
-  max_rounds?: number;
-  used_rounds?: number;
-  /** 权限档位：plan / workspace / full */
-  permission_mode?: string;
-  /** 档位实际强制力：native / advisory */
-  permission_enforcement?: string;
+	session_id: string;
+	session_alias: string | null;
+	from_agent: string;
+	subject: string;
+	status: string;
+	created_at: string;
+	updated_at: string;
+	mail_count?: number;
+	/**
+	 * 别名是谁定的：
+	 *   platform = Agent 平台自动同步来的，后续同步可以覆盖
+	 *   manual   = 人显式指定（手工改名或接受了 Agent 的提议），平台同步不得覆盖
+	 */
+	alias_source?: "platform" | "manual";
+	/** 用户驳回过的改名提议 */
+	rename_dismissed?: string;
+	/**
+	 * 本任务的往返预算（0 = 本会话不限，仅受 Agent 全局配额约束）。
+	 *
+	 * 配额的语义是「这件事值得多少个来回」—— 那是任务的属性而非 Agent 的属性，
+	 * 所以在写信时给、在对话页里随时调，而不是去管理员页面改某个 Agent 的全局配额。
+	 */
+	max_rounds?: number;
+	used_rounds?: number;
+	/** 权限档位：plan / workspace / full */
+	permission_mode?: string;
+	/** 档位实际强制力：native / advisory */
+	permission_enforcement?: string;
 }
 
 /** 会话往返预算快照 */
 export interface SessionBudget {
-  session_id: string;
-  max_rounds: number;
-  used_rounds: number;
-  /** 不限时为 -1 */
-  remaining: number;
-  unlimited: boolean;
+	session_id: string;
+	max_rounds: number;
+	used_rounds: number;
+	/** 不限时为 -1 */
+	remaining: number;
+	unlimited: boolean;
 }
 
 /** 附件元数据。内容存盘，按 sha256 内容寻址；同内容重复上传不占额外空间。 */
 export interface Attachment {
-  attachment_id: string;
-  /** 为 null 表示已上传但尚未随邮件发出 */
-  mail_id: string | null;
-  uploader: string;
-  filename: string;
-  content_type: string;
-  size_bytes: number;
-  sha256: string;
-  created_at: string;
+	attachment_id: string;
+	/** 为 null 表示已上传但尚未随邮件发出 */
+	mail_id: string | null;
+	uploader: string;
+	filename: string;
+	content_type: string;
+	size_bytes: number;
+	sha256: string;
+	created_at: string;
 }
 
 export interface Mail {
-  mail_id: string;
-  session_id: string;
-  parent_mail_id: string | null;
-  from_name: string;
-  from_workspace: string;
-  to_name: string;
-  to_workspace: string;
-  cc_list: Address[];
-  subject: string;
-  body: string;
-  mail_type: 'normal' | 'permission_request';
-  permission_options: string[] | null;
-  permission_result: string | null;
-  /**
-   * 待办类型：`permission`（危险操作审批）/ `question`（模型主动提问）。
-   *
-   * 两者共用 permission_request 这个 mail_type，但**该渲染什么完全不同**：
-   * 前者是「批准 / 拒绝」，后者是「回答问题」（勾选 + 自由文本）。
-   * 混用一套 UI 会让人把「回答问题」当成「批准执行」。
-   */
-  permission_kind?: string;
-  /** 仅 question 使用：是否允许多选（对应 DSH 的 multi_select）。 */
-  permission_multi_select?: boolean;
-  status: 'unread' | 'read' | 'archived';
-  created_at: string;
-  hop_limit?: number;
-  session_alias?: string;
-  /**
-   * **这条会话**的工作目录（sessions.workspace）。
-   *
-   * 不能用 from_workspace / to_workspace 代替：
-   *   - 人 → Agent：to_workspace 是真路径，from_workspace 为空（人没有工作目录）
-   *   - Agent → 人：to_workspace 为空，而 **from_workspace 存的是 Agent 名**
-   *     而不是路径（历史遗留）
-   *
-   * 于是「Agent 发来的这封信，那个 Agent 在哪个目录干活」只能从会话上取。
-   * 界面上曾显示成 `dsh@dsh`，就是拿 from_workspace 当路径拼的。
-   */
-  session_workspace?: string;
-  body_preview?: string;
-  attachments?: Attachment[];
-  /** 发件方是人类用户而不是 Agent（服务端 EXISTS users 判的） */
-  from_human: boolean;
-  /** 收件方是人类用户而不是 Agent */
-  to_human: boolean;
-  permission_mode?: string;
-  permission_enforcement?: string;
+	mail_id: string;
+	session_id: string;
+	parent_mail_id: string | null;
+	from_name: string;
+	from_workspace: string;
+	to_name: string;
+	to_workspace: string;
+	cc_list: Address[];
+	subject: string;
+	body: string;
+	mail_type: "normal" | "permission_request";
+	permission_options: string[] | null;
+	permission_result: string | null;
+	/**
+	 * 待办类型：`permission`（危险操作审批）/ `question`（模型主动提问）。
+	 *
+	 * 两者共用 permission_request 这个 mail_type，但**该渲染什么完全不同**：
+	 * 前者是「批准 / 拒绝」，后者是「回答问题」（勾选 + 自由文本）。
+	 * 混用一套 UI 会让人把「回答问题」当成「批准执行」。
+	 */
+	permission_kind?: string;
+	/** 仅 question 使用：是否允许多选（对应 DSH 的 multi_select）。 */
+	permission_multi_select?: boolean;
+	status: "unread" | "read" | "archived";
+	created_at: string;
+	hop_limit?: number;
+	session_alias?: string;
+	/**
+	 * **这条会话**的工作目录（sessions.workspace）。
+	 *
+	 * 不能用 from_workspace / to_workspace 代替：
+	 *   - 人 → Agent：to_workspace 是真路径，from_workspace 为空（人没有工作目录）
+	 *   - Agent → 人：to_workspace 为空，而 **from_workspace 存的是 Agent 名**
+	 *     而不是路径（历史遗留）
+	 *
+	 * 于是「Agent 发来的这封信，那个 Agent 在哪个目录干活」只能从会话上取。
+	 * 界面上曾显示成 `dsh@dsh`，就是拿 from_workspace 当路径拼的。
+	 */
+	session_workspace?: string;
+	body_preview?: string;
+	attachments?: Attachment[];
+	/** 发件方是人类用户而不是 Agent（服务端 EXISTS users 判的） */
+	from_human: boolean;
+	/** 收件方是人类用户而不是 Agent */
+	to_human: boolean;
+	permission_mode?: string;
+	permission_enforcement?: string;
 }
 
 /**
@@ -145,30 +145,30 @@ export interface Mail {
  * depth 是**相对锚点**的层级：0 = 锚点，负数 = 祖先，正数 = 子孙。
  * 分块加载时根可能还没取到，所以不用「距根深度」。
  */
-export interface ThreadNode extends Omit<Mail, 'body'> {
-  /** 距**线索根**的层级：0 = 根，1 = 它的直接回复 */
-  depth: number;
-  attachment_count: number;
-  /** 父邮件不在当前已加载集合里（无权查看，或还没滑到） */
-  detached?: boolean;
-  /** 父邮件确实存在但无权查看（区别于「尚未加载」） */
-  parent_hidden?: boolean;
-  body?: string;
+export interface ThreadNode extends Omit<Mail, "body"> {
+	/** 距**线索根**的层级：0 = 根，1 = 它的直接回复 */
+	depth: number;
+	attachment_count: number;
+	/** 父邮件不在当前已加载集合里（无权查看，或还没滑到） */
+	detached?: boolean;
+	/** 父邮件确实存在但无权查看（区别于「尚未加载」） */
+	parent_hidden?: boolean;
+	body?: string;
 }
 
 export interface ThreadPage {
-  anchor_mail_id: string;
-  /** 线索根的 mail_id：整棵树从它展开 */
-  root_mail_id: string;
-  /** 锚点距根的层数，用于高亮定位 */
-  anchor_depth: number;
-  nodes: ThreadNode[];
-  total: number;
-  /** 因权限被过滤掉的节点数 */
-  hidden: number;
-  has_more: boolean;
-  /** 下一页 offset，原样回传即可 */
-  next_offset: number;
+	anchor_mail_id: string;
+	/** 线索根的 mail_id：整棵树从它展开 */
+	root_mail_id: string;
+	/** 锚点距根的层数，用于高亮定位 */
+	anchor_depth: number;
+	nodes: ThreadNode[];
+	total: number;
+	/** 因权限被过滤掉的节点数 */
+	hidden: number;
+	has_more: boolean;
+	/** 下一页 offset，原样回传即可 */
+	next_offset: number;
 }
 
 /**
@@ -179,69 +179,69 @@ export interface ThreadPage {
  * 提议 + 人点头，既让 Agent 表达意图，又保证寻址稳定性由人掌握。
  */
 export interface RenameProposal {
-  /** 已由服务端规范化，可直接提交给 PUT /sessions/:id/alias */
-  alias: string;
-  reason?: string;
+	/** 已由服务端规范化，可直接提交给 PUT /sessions/:id/alias */
+	alias: string;
+	reason?: string;
 }
 
 export interface Contact {
-  session_id: string;
-  agent_name: string;
-  path: string;
-  session_alias: string;
-  address: string;
-  status: string;
-  mail_count: number;
-  unread_count: number;
-  last_activity: string;
-  /** 会话主题（多由 Agent 平台的模型生成的摘要） */
-  subject: string;
-  /** 本任务的往返预算（0 = 不限） */
-  max_rounds: number;
-  used_rounds: number;
-  permission_mode?: string;
-  permission_enforcement?: string;
-  /** 最后一封邮件的发件人与正文摘要（服务端已按字符截断） */
-  last_from: string;
-  last_preview: string;
+	session_id: string;
+	agent_name: string;
+	path: string;
+	session_alias: string;
+	address: string;
+	status: string;
+	mail_count: number;
+	unread_count: number;
+	last_activity: string;
+	/** 会话主题（多由 Agent 平台的模型生成的摘要） */
+	subject: string;
+	/** 本任务的往返预算（0 = 不限） */
+	max_rounds: number;
+	used_rounds: number;
+	permission_mode?: string;
+	permission_enforcement?: string;
+	/** 最后一封邮件的发件人与正文摘要（服务端已按字符截断） */
+	last_from: string;
+	last_preview: string;
 }
 
 export interface PermissionRequest {
-  request_id: string;
-  mail_id: string;
-  session_id: string;
-  agent_name: string;
-  question: string;
-  options: string[];
-  context: string;
-  result: string | null;
-  decided_at: string | null;
-  created_at: string;
+	request_id: string;
+	mail_id: string;
+	session_id: string;
+	agent_name: string;
+	question: string;
+	options: string[];
+	context: string;
+	result: string | null;
+	decided_at: string | null;
+	created_at: string;
 }
 
 export interface SessionDetail {
-  session: Session;
-  mails: Mail[];
+	session: Session;
+	mails: Mail[];
 }
 
 export interface HumanSession {
-  session_id: string;
-  session_alias: string | null;
-  from_agent: string;
-  subject: string;
-  status: string;
-  created_at: string;
-  updated_at: string;
-  mail_count: number;
-  unread_count: number;
-  /** 本任务的往返预算（0 = 不限） */
-  max_rounds?: number;
-  used_rounds?: number;
-  permission_mode?: string;
-  permission_enforcement?: string;
+	session_id: string;
+	session_alias: string | null;
+	from_agent: string;
+	subject: string;
+	status: string;
+	created_at: string;
+	updated_at: string;
+	mail_count: number;
+	unread_count: number;
+	/** 本任务的往返预算（0 = 不限） */
+	max_rounds?: number;
+	used_rounds?: number;
+	permission_mode?: string;
+	permission_enforcement?: string;
 }
 
-export type SuggestKind = 'name' | 'path' | 'session';
+export type SuggestKind = "name" | "path" | "session";
 
 /**
  * 会话候选项的来源。
@@ -249,38 +249,38 @@ export type SuggestKind = 'name' | 'path' | 'session';
  *   platform 平台侧会话镜像（人直接在 opencode/DSH 界面上开的）
  *   new      新建会话的哨兵项
  */
-export type SessionCandidateSource = 'mail' | 'platform' | 'new';
+export type SessionCandidateSource = "mail" | "platform" | "new";
 
 export interface SessionCandidate {
-  /** 填进 session 位的值 */
-  alias: string;
-  /** 给人看，用来分辨两条别名相似的会话在谈什么 */
-  title?: string;
-  source: SessionCandidateSource;
-  /** 仅 mail 来源有意义 */
-  unread?: number;
+	/** 填进 session 位的值 */
+	alias: string;
+	/** 给人看，用来分辨两条别名相似的会话在谈什么 */
+	title?: string;
+	source: SessionCandidateSource;
+	/** 仅 mail 来源有意义 */
+	unread?: number;
 }
 
 export interface SuggestResult {
-  kind: SuggestKind;
-  suggestions: string[];
-  /**
-   * 带标题与来源的完整候选，与 suggestions 同序。
-   * 仅 kind === 'session' 时返回；suggestions 保留纯字符串形式是为了
-   * 不打破已部署的前端与第三方客户端。
-   */
-  candidates?: SessionCandidate[];
+	kind: SuggestKind;
+	suggestions: string[];
+	/**
+	 * 带标题与来源的完整候选，与 suggestions 同序。
+	 * 仅 kind === 'session' 时返回；suggestions 保留纯字符串形式是为了
+	 * 不打破已部署的前端与第三方客户端。
+	 */
+	candidates?: SessionCandidate[];
 }
 
 /** 系统初始化状态 */
 export interface SetupStatus {
-  needs_setup: boolean;
+	needs_setup: boolean;
 }
 
 /** 管理员可授权范围候选 */
 export interface AdminScopes {
-  agents: string[];
-  paths: string[];
+	agents: string[];
+	paths: string[];
 }
 
 /**
@@ -291,58 +291,58 @@ export interface AdminScopes {
  * 对 Agent 来说就是一封普通邮件，它不知道也不需要知道信来自日历。
  */
 export interface CalendarEvent {
-  event_id: string;
-  title: string;
-  description: string;
-  /**
-   * 提醒邮件的正文。留空时后端按 title/time/description 生成默认模板。
-   * 支持 {title} {time} {description} 三个变量，触发时替换。
-   */
-  reminder_text: string;
-  /**
-   * 收件 Agent 名 / 完整地址 —— **单收件人时代的字段**。
-   * 保留作兼容与兜底：recipients 为空时才用它们。
-   * 新代码一律用 effectiveRecipients()。
-   */
-  agent_name: string;
-  to_address: string;
-  /**
-   * 收件人列表，每项是完整三维地址串。
-   *
-   * 存原始串而不是结构化地址：session 位的 new/别名三态该在**触发那一刻**
-   * 解析。存结构化的话「.new」这种一次性语义在建事件时就被固化，
-   * 而重复事件每次触发都该重新决定落到哪条会话。
-   */
-  recipients: string[];
-  /**
-   * 多收件人的投递方式。
-   *   separate = 各发一封、落各自会话、互相看不到
-   *   together = 首个为主收件人，其余进抄送、共享同一条线索
-   *
-   * 两种都要而不是二选一：「三个 Agent 各自独立汇报」与「pi 主办、dsh 知情」
-   * 是完全不同的任务形态。用错 together 会让本该独立判断的 Agent 互相
-   * 看到回复而趋同，那种污染事后无法分离。
-   */
-  delivery_mode: DeliveryMode;
-  /** ISO 8601 */
-  event_time: string;
-  /** 提前多少分钟提醒；0 = 到点才提醒 */
-  remind_before: number;
-  recurrence: Recurrence;
-  /** 重复终止时间；越过它事件自动置为 cancelled */
-  recurrence_end?: string;
-  status: 'active' | 'paused' | 'cancelled';
-  /** 上次触发的墙上时钟 */
-  last_fired_at?: string;
-  /**
-   * 已触发的那个 occurrence（值 = 当时的 event_time）。
-   * 去重靠它与 event_time 相等判断，不是拿 last_fired_at 比大小 ——
-   * 后端 DueEvents 有 60 秒 lookahead，后者在窗口内恒为真会导致每 tick 重发。
-   */
-  fired_for?: string;
-  created_at: string;
-  updated_at: string;
-  created_by: string;
+	event_id: string;
+	title: string;
+	description: string;
+	/**
+	 * 提醒邮件的正文。留空时后端按 title/time/description 生成默认模板。
+	 * 支持 {title} {time} {description} 三个变量，触发时替换。
+	 */
+	reminder_text: string;
+	/**
+	 * 收件 Agent 名 / 完整地址 —— **单收件人时代的字段**。
+	 * 保留作兼容与兜底：recipients 为空时才用它们。
+	 * 新代码一律用 effectiveRecipients()。
+	 */
+	agent_name: string;
+	to_address: string;
+	/**
+	 * 收件人列表，每项是完整三维地址串。
+	 *
+	 * 存原始串而不是结构化地址：session 位的 new/别名三态该在**触发那一刻**
+	 * 解析。存结构化的话「.new」这种一次性语义在建事件时就被固化，
+	 * 而重复事件每次触发都该重新决定落到哪条会话。
+	 */
+	recipients: string[];
+	/**
+	 * 多收件人的投递方式。
+	 *   separate = 各发一封、落各自会话、互相看不到
+	 *   together = 首个为主收件人，其余进抄送、共享同一条线索
+	 *
+	 * 两种都要而不是二选一：「三个 Agent 各自独立汇报」与「pi 主办、dsh 知情」
+	 * 是完全不同的任务形态。用错 together 会让本该独立判断的 Agent 互相
+	 * 看到回复而趋同，那种污染事后无法分离。
+	 */
+	delivery_mode: DeliveryMode;
+	/** ISO 8601 */
+	event_time: string;
+	/** 提前多少分钟提醒；0 = 到点才提醒 */
+	remind_before: number;
+	recurrence: Recurrence;
+	/** 重复终止时间；越过它事件自动置为 cancelled */
+	recurrence_end?: string;
+	status: "active" | "paused" | "cancelled";
+	/** 上次触发的墙上时钟 */
+	last_fired_at?: string;
+	/**
+	 * 已触发的那个 occurrence（值 = 当时的 event_time）。
+	 * 去重靠它与 event_time 相等判断，不是拿 last_fired_at 比大小 ——
+	 * 后端 DueEvents 有 60 秒 lookahead，后者在窗口内恒为真会导致每 tick 重发。
+	 */
+	fired_for?: string;
+	created_at: string;
+	updated_at: string;
+	created_by: string;
 }
 
 /**
@@ -353,38 +353,38 @@ export interface CalendarEvent {
  * 也没有 lunar_weekly（农历没有「周」这个单位）。
  */
 export type Recurrence =
-  | 'none'
-  | 'daily'
-  | 'weekly'
-  | 'monthly'
-  | 'yearly'
-  | 'lunar_monthly'
-  | 'lunar_yearly';
+	| "none"
+	| "daily"
+	| "weekly"
+	| "monthly"
+	| "yearly"
+	| "lunar_monthly"
+	| "lunar_yearly";
 
-export type DeliveryMode = 'separate' | 'together';
+export type DeliveryMode = "separate" | "together";
 
 /** 事件附件（随提醒邮件一起发出） */
 export interface CalendarAttachment {
-  attachment_id: string;
-  event_id: string;
-  filename: string;
-  sha256: string;
-  size_bytes: number;
-  created_at: string;
+	attachment_id: string;
+	event_id: string;
+	filename: string;
+	sha256: string;
+	size_bytes: number;
+	created_at: string;
 }
 
 /** 新建/编辑事件的请求体。event_time 必填，其余可省。 */
 export interface CalendarEventInput {
-  title: string;
-  description?: string;
-  reminder_text?: string;
-  agent_name?: string;
-  to_address?: string;
-  recipients?: string[];
-  delivery_mode?: DeliveryMode;
-  event_time: string;
-  remind_before?: number;
-  recurrence?: Recurrence;
-  recurrence_end?: string | null;
-  status?: 'active' | 'paused' | 'cancelled';
+	title: string;
+	description?: string;
+	reminder_text?: string;
+	agent_name?: string;
+	to_address?: string;
+	recipients?: string[];
+	delivery_mode?: DeliveryMode;
+	event_time: string;
+	remind_before?: number;
+	recurrence?: Recurrence;
+	recurrence_end?: string | null;
+	status?: "active" | "paused" | "cancelled";
 }
diff --git a/client/electron/test/components/PermissionPanel.test.tsx b/client/electron/test/components/PermissionPanel.test.tsx
index 41a5cda..1a835b8 100644
--- a/client/electron/test/components/PermissionPanel.test.tsx
+++ b/client/electron/test/components/PermissionPanel.test.tsx
@@ -1,13 +1,13 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest';
-import { act, render, screen, waitFor } from '@testing-library/react';
-import userEvent from '@testing-library/user-event';
-import React from 'react';
+import { describe, expect, it, vi, beforeEach } from "vitest";
+import { act, render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import React from "react";
 
-import { PermissionPanel } from '../../src/components/MailView';
-import * as api from '../../src/api/client';
-import { useMailStore } from '../../src/stores/mailStore';
-import { useSessionStore } from '../../src/stores/sessionStore';
-import type { Mail } from '../../src/types';
+import { PermissionPanel } from "../../src/components/MailView";
+import * as api from "../../src/api/client";
+import { useMailStore } from "../../src/stores/mailStore";
+import { useSessionStore } from "../../src/stores/sessionStore";
+import type { Mail } from "../../src/types";
 
 /**
  * 权限决策面板。
@@ -19,187 +19,214 @@ import type { Mail } from '../../src/types';
  */
 
 function permMail(over: Partial<Mail> = {}): Mail {
-  return {
-    mail_id: 'm-1',
-    session_id: 's-1',
-    parent_mail_id: null,
-    from_name: 'dsh',
-    from_workspace: '/home/program/agentmail',
-    to_name: 'admin',
-    to_workspace: '',
-    cc_list: [],
-    subject: '请求批准：删除 build/',
-    body: '将执行 rm -rf build/',
-    mail_type: 'permission_request',
-    permission_options: undefined,
-    permission_result: '',
-    status: 'unread',
-    created_at: '2026-09-03T00:00:00Z',
-    hop_limit: 5,
-    ...over
-  } as Mail;
+	return {
+		mail_id: "m-1",
+		session_id: "s-1",
+		parent_mail_id: null,
+		from_name: "dsh",
+		from_workspace: "/home/program/agentmail",
+		to_name: "admin",
+		to_workspace: "",
+		cc_list: [],
+		subject: "请求批准：删除 build/",
+		body: "将执行 rm -rf build/",
+		mail_type: "permission_request",
+		permission_options: undefined,
+		permission_result: "",
+		status: "unread",
+		created_at: "2026-09-03T00:00:00Z",
+		hop_limit: 5,
+		...over,
+	} as Mail;
 }
 
-describe('PermissionPanel 决策', () => {
-  beforeEach(() => {
-    vi.restoreAllMocks();
-    // fetchInbox / selectSession 会打网络，替换成空实现
-    useMailStore.setState({ fetchInbox: vi.fn(async () => {}) } as any);
-    useSessionStore.setState({ selectSession: vi.fn(async () => {}) } as any);
-  });
+describe("PermissionPanel 决策", () => {
+	beforeEach(() => {
+		vi.restoreAllMocks();
+		// fetchInbox / selectSession 会打网络，替换成空实现
+		useMailStore.setState({ fetchInbox: vi.fn(async () => {}) } as any);
+		useSessionStore.setState({ selectSession: vi.fn(async () => {}) } as any);
+	});
 
-  it('没有 permission_options 时给默认的同意/拒绝两个选项', () => {
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
+	it("没有 permission_options 时给默认的同意/拒绝两个选项", () => {
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
 
-    expect(screen.getByRole('button', { name: /同意/ })).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: /拒绝/ })).toBeInTheDocument();
-  });
+		expect(screen.getByRole("button", { name: /同意/ })).toBeInTheDocument();
+		expect(screen.getByRole("button", { name: /拒绝/ })).toBeInTheDocument();
+	});
 
-  it('有 permission_options 时用它，且顺序保持', () => {
-    render(
-      React.createElement(PermissionPanel, {
-        mail: permMail({ permission_options: ['只这一次', '总是允许', '拒绝'] })
-      })
-    );
+	it("有 permission_options 时用它，且顺序保持", () => {
+		render(
+			React.createElement(PermissionPanel, {
+				mail: permMail({
+					permission_options: ["只这一次", "总是允许", "拒绝"],
+				}),
+			}),
+		);
 
-    const btns = screen.getAllByRole('button').map(b => b.textContent?.trim());
-    // 顺序是 Agent 给的语义顺序，重排会让「拒绝」跑到人的手指默认位置上
-    expect(btns).toEqual(['只这一次', '总是允许', '拒绝']);
-  });
+		const btns = screen
+			.getAllByRole("button")
+			.map((b) => b.textContent?.trim());
+		// 顺序是 Agent 给的语义顺序，重排会让「拒绝」跑到人的手指默认位置上
+		expect(btns).toEqual(["只这一次", "总是允许", "拒绝"]);
+	});
 
-  it('点选项时把【选项原文】发给服务端', async () => {
-    const spy = vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    render(
-      React.createElement(PermissionPanel, {
-        mail: permMail({ permission_options: ['只这一次', '拒绝'] })
-      })
-    );
+	it("点选项时把【选项原文】发给服务端", async () => {
+		const spy = vi
+			.spyOn(api, "decidePermission")
+			.mockResolvedValue({ status: "decided" } as any);
+		render(
+			React.createElement(PermissionPanel, {
+				mail: permMail({ permission_options: ["只这一次", "拒绝"] }),
+			}),
+		);
 
-    await userEvent.click(screen.getByRole('button', { name: /只这一次/ }));
+		await userEvent.click(screen.getByRole("button", { name: /只这一次/ }));
 
-    // 关键：不能归一化成 allow/deny —— 「只这一次」与「总是允许」的区别
-    // 只有 Agent 侧的权限机制懂，服务端与前端都不该替它翻译
-    await waitFor(() =>
-      expect(spy).toHaveBeenCalledWith('m-1', '只这一次', undefined)
-    );
-  });
+		// 关键：不能归一化成 allow/deny —— 「只这一次」与「总是允许」的区别
+		// 只有 Agent 侧的权限机制懂，服务端与前端都不该替它翻译
+		await waitFor(() =>
+			expect(spy).toHaveBeenCalledWith("m-1", "只这一次", undefined),
+		);
+	});
 
-  it('填了备注时一起发出去', async () => {
-    const spy = vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
+	it("填了备注时一起发出去", async () => {
+		const spy = vi
+			.spyOn(api, "decidePermission")
+			.mockResolvedValue({ status: "decided" } as any);
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
 
-    await userEvent.type(screen.getByPlaceholderText('备注（可选）'), '只删 build，别动 dist');
-    await userEvent.click(screen.getByRole('button', { name: /同意/ }));
+		await userEvent.type(
+			screen.getByPlaceholderText("备注（可选）"),
+			"只删 build，别动 dist",
+		);
+		await userEvent.click(screen.getByRole("button", { name: /同意/ }));
 
-    await waitFor(() =>
-      expect(spy).toHaveBeenCalledWith('m-1', '同意', '只删 build，别动 dist')
-    );
-  });
+		await waitFor(() =>
+			expect(spy).toHaveBeenCalledWith("m-1", "同意", "只删 build，别动 dist"),
+		);
+	});
 
-  it('备注为空时传 undefined 而不是空字符串', async () => {
-    const spy = vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
+	it("备注为空时传 undefined 而不是空字符串", async () => {
+		const spy = vi
+			.spyOn(api, "decidePermission")
+			.mockResolvedValue({ status: "decided" } as any);
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
 
-    await userEvent.click(screen.getByRole('button', { name: /同意/ }));
+		await userEvent.click(screen.getByRole("button", { name: /同意/ }));
 
-    // 空串会在决策邮件里留一行空的「备注：」
-    await waitFor(() => expect(spy).toHaveBeenCalledWith('m-1', '同意', undefined));
-  });
+		// 空串会在决策邮件里留一行空的「备注：」
+		await waitFor(() =>
+			expect(spy).toHaveBeenCalledWith("m-1", "同意", undefined),
+		);
+	});
 
-  it('决策后变成「已处理」，不再显示按钮', async () => {
-    vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
+	it("决策后变成「已处理」，不再显示按钮", async () => {
+		vi.spyOn(api, "decidePermission").mockResolvedValue({
+			status: "decided",
+		} as any);
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
 
-    await userEvent.click(screen.getByRole('button', { name: /同意/ }));
+		await userEvent.click(screen.getByRole("button", { name: /同意/ }));
 
-    await waitFor(() => expect(screen.getByText('已处理：')).toBeInTheDocument());
-    // 还能点第二次的话人会以为第一次没生效，而服务端那边早已决策
-    expect(screen.queryByRole('button')).toBeNull();
-  });
+		await waitFor(() =>
+			expect(screen.getByText("已处理：")).toBeInTheDocument(),
+		);
+		// 还能点第二次的话人会以为第一次没生效，而服务端那边早已决策
+		expect(screen.queryByRole("button")).toBeNull();
+	});
 
-  it('已经有 permission_result 的邮件直接显示结论', () => {
-    render(
-      React.createElement(PermissionPanel, {
-        mail: permMail({ permission_result: '拒绝' })
-      })
-    );
+	it("已经有 permission_result 的邮件直接显示结论", () => {
+		render(
+			React.createElement(PermissionPanel, {
+				mail: permMail({ permission_result: "拒绝" }),
+			}),
+		);
 
-    expect(screen.getByText('拒绝')).toBeInTheDocument();
-    expect(screen.queryByRole('button')).toBeNull();
-  });
+		expect(screen.getByText("拒绝")).toBeInTheDocument();
+		expect(screen.queryByRole("button")).toBeNull();
+	});
 
-  it('提交中禁用所有按钮，避免重复决策', async () => {
-    let release: (v: any) => void = () => {};
-    vi.spyOn(api, 'decidePermission').mockReturnValue(
-      new Promise(res => {
-        release = res;
-      }) as any
-    );
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
+	it("提交中禁用所有按钮，避免重复决策", async () => {
+		let release: (v: any) => void = () => {};
+		vi.spyOn(api, "decidePermission").mockReturnValue(
+			new Promise((res) => {
+				release = res;
+			}) as any,
+		);
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
 
-    await userEvent.click(screen.getByRole('button', { name: /同意/ }));
+		await userEvent.click(screen.getByRole("button", { name: /同意/ }));
 
-    // 一次危险操作被批准两次，Agent 那边可能真的执行两遍
-    await waitFor(() => {
-      for (const b of screen.getAllByRole('button')) {
-        expect(b).toBeDisabled();
-      }
-    });
+		// 一次危险操作被批准两次，Agent 那边可能真的执行两遍
+		await waitFor(() => {
+			for (const b of screen.getAllByRole("button")) {
+				expect(b).toBeDisabled();
+			}
+		});
 
-    // 收尾：让悬挂的 Promise 落定并等状态更新走完，
-    // 否则组件在测试结束后才 setState，React 会报 act 警告
-    await act(async () => {
-      release({ status: 'decided' });
-    });
-    await waitFor(() => expect(screen.getByText('已处理：')).toBeInTheDocument());
-  });
+		// 收尾：让悬挂的 Promise 落定并等状态更新走完，
+		// 否则组件在测试结束后才 setState，React 会报 act 警告
+		await act(async () => {
+			release({ status: "decided" });
+		});
+		await waitFor(() =>
+			expect(screen.getByText("已处理：")).toBeInTheDocument(),
+		);
+	});
 
-  it('提交失败时恢复可点，不假装已决策', async () => {
-    vi.spyOn(api, 'decidePermission').mockRejectedValue(new Error('500'));
-    vi.spyOn(console, 'error').mockImplementation(() => {});
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
+	it("提交失败时恢复可点，不假装已决策", async () => {
+		vi.spyOn(api, "decidePermission").mockRejectedValue(new Error("500"));
+		vi.spyOn(console, "error").mockImplementation(() => {});
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
 
-    await userEvent.click(screen.getByRole('button', { name: /同意/ }));
+		await userEvent.click(screen.getByRole("button", { name: /同意/ }));
 
-    // 失败后显示「已处理」是最糟的结果：人以为批过了，Agent 还在等
-    await waitFor(() => expect(screen.getByRole('button', { name: /同意/ })).toBeEnabled());
-    expect(screen.queryByText('已处理：')).toBeNull();
-  });
+		// 失败后显示「已处理」是最糟的结果：人以为批过了，Agent 还在等
+		await waitFor(() =>
+			expect(screen.getByRole("button", { name: /同意/ })).toBeEnabled(),
+		);
+		expect(screen.queryByText("已处理：")).toBeNull();
+	});
 
-  it('决策成功后刷新收件箱并选中该会话', async () => {
-    vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    const fetchInbox = vi.fn(async () => {});
-    const selectSession = vi.fn(async () => {});
-    useMailStore.setState({ fetchInbox } as any);
-    useSessionStore.setState({ selectSession } as any);
+	it("决策成功后刷新收件箱并选中该会话", async () => {
+		vi.spyOn(api, "decidePermission").mockResolvedValue({
+			status: "decided",
+		} as any);
+		const fetchInbox = vi.fn(async () => {});
+		const selectSession = vi.fn(async () => {});
+		useMailStore.setState({ fetchInbox } as any);
+		useSessionStore.setState({ selectSession } as any);
 
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
-    await userEvent.click(screen.getByRole('button', { name: /同意/ }));
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
+		await userEvent.click(screen.getByRole("button", { name: /同意/ }));
 
-    // 不刷新的话列表里那封还是「未读的权限请求」，人会以为没生效
-    await waitFor(() => {
-      expect(fetchInbox).toHaveBeenCalledWith('all');
-      expect(selectSession).toHaveBeenCalledWith('s-1');
-    });
-  });
+		// 不刷新的话列表里那封还是「未读的权限请求」，人会以为没生效
+		await waitFor(() => {
+			expect(fetchInbox).toHaveBeenCalledWith("all");
+			expect(selectSession).toHaveBeenCalledWith("s-1");
+		});
+	});
 
-  it('同意类选项用绿色，其余用红色', () => {
-    render(
-      React.createElement(PermissionPanel, {
-        mail: permMail({ permission_options: ['允许', 'approve', '拒绝', '算了'] })
-      })
-    );
+	it("同意类选项用绿色，其余用红色", () => {
+		render(
+			React.createElement(PermissionPanel, {
+				mail: permMail({
+					permission_options: ["允许", "approve", "拒绝", "算了"],
+				}),
+			}),
+		);
 
-    const cls = (name: string) =>
-      screen.getByRole('button', { name: new RegExp(name) }).className;
+		const cls = (name: string) =>
+			screen.getByRole("button", { name: new RegExp(name) }).className;
 
-    // 颜色是唯一的视觉提示：点错一次就放行了一个危险操作
-    expect(cls('允许')).toContain('bg-green-700');
-    expect(cls('approve')).toContain('bg-green-700');
-    expect(cls('拒绝')).toContain('text-red-700');
-    // 不在同意词表里的一律按「否」处理 —— 宁可让人多看一眼
-    expect(cls('算了')).toContain('text-red-700');
-  });
+		// 颜色是唯一的视觉提示：点错一次就放行了一个危险操作
+		expect(cls("允许")).toContain("bg-green-700");
+		expect(cls("approve")).toContain("bg-green-700");
+		expect(cls("拒绝")).toContain("text-red-700");
+		// 不在同意词表里的一律按「否」处理 —— 宁可让人多看一眼
+		expect(cls("算了")).toContain("text-red-700");
+	});
 });
 
 /**
@@ -210,117 +237,142 @@ describe('PermissionPanel 决策', () => {
  *   - 不能把问题渲染成同意/拒绝（那会让人点出一个毫无意义的答案）
  *   - 空回答不能提交（模型会拿到一个什么都没说的结果继续跑）
  */
-describe('PermissionPanel 回答问题', () => {
-  beforeEach(() => {
-    vi.restoreAllMocks();
-    useMailStore.setState({ fetchInbox: vi.fn(async () => {}) } as any);
-    useSessionStore.setState({ selectSession: vi.fn(async () => {}) } as any);
-  });
+describe("PermissionPanel 回答问题", () => {
+	beforeEach(() => {
+		vi.restoreAllMocks();
+		useMailStore.setState({ fetchInbox: vi.fn(async () => {}) } as any);
+		useSessionStore.setState({ selectSession: vi.fn(async () => {}) } as any);
+	});
 
-  const questionMail = (over: Partial<Mail> = {}): Mail =>
-    permMail({ permission_kind: 'question', ...over });
+	const questionMail = (over: Partial<Mail> = {}): Mail =>
+		permMail({ permission_kind: "question", ...over });
 
-  it('问题不带选项时：不渲染同意/拒绝，只给自由文本', () => {
-    render(React.createElement(PermissionPanel, { mail: questionMail({ permission_options: [] }) }));
+	it("问题不带选项时：不渲染同意/拒绝，只给自由文本", () => {
+		render(
+			React.createElement(PermissionPanel, {
+				mail: questionMail({ permission_options: [] }),
+			}),
+		);
 
-    expect(screen.queryByRole('button', { name: /同意/ })).toBeNull();
-    expect(screen.queryByRole('button', { name: /拒绝/ })).toBeNull();
-    expect(screen.getByPlaceholderText('你的回答（必填）')).toBeInTheDocument();
-  });
+		expect(screen.queryByRole("button", { name: /同意/ })).toBeNull();
+		expect(screen.queryByRole("button", { name: /拒绝/ })).toBeNull();
+		expect(screen.getByPlaceholderText("你的回答（必填）")).toBeInTheDocument();
+	});
 
-  it('问题带选项时：渲染选项按钮（而不是同意/拒绝）', () => {
-    render(
-      React.createElement(PermissionPanel, {
-        mail: questionMail({ permission_options: ['方案 A', '方案 B'] })
-      })
-    );
+	it("问题带选项时：渲染选项按钮（而不是同意/拒绝）", () => {
+		render(
+			React.createElement(PermissionPanel, {
+				mail: questionMail({ permission_options: ["方案 A", "方案 B"] }),
+			}),
+		);
 
-    expect(screen.getByRole('button', { name: /方案 A/ })).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: /方案 B/ })).toBeInTheDocument();
-    expect(screen.queryByRole('button', { name: /^同意$/ })).toBeNull();
-  });
+		expect(screen.getByRole("button", { name: /方案 A/ })).toBeInTheDocument();
+		expect(screen.getByRole("button", { name: /方案 B/ })).toBeInTheDocument();
+		expect(screen.queryByRole("button", { name: /^同意$/ })).toBeNull();
+	});
 
-  it('单选：再点已选项会取消，不会同时选中两个', async () => {
-    render(
-      React.createElement(PermissionPanel, {
-        mail: questionMail({ permission_options: ['A', 'B'] })
-      })
-    );
-    const a = screen.getByRole('button', { name: /^A$/ });
-    const b = screen.getByRole('button', { name: /^B$/ });
+	it("单选：再点已选项会取消，不会同时选中两个", async () => {
+		render(
+			React.createElement(PermissionPanel, {
+				mail: questionMail({ permission_options: ["A", "B"] }),
+			}),
+		);
+		const a = screen.getByRole("button", { name: /^A$/ });
+		const b = screen.getByRole("button", { name: /^B$/ });
 
-    await userEvent.click(a);
-    expect(a).toHaveAttribute('aria-pressed', 'true');
-    await userEvent.click(b);
-    expect(b).toHaveAttribute('aria-pressed', 'true');
-    expect(a).toHaveAttribute('aria-pressed', 'false');
-  });
+		await userEvent.click(a);
+		expect(a).toHaveAttribute("aria-pressed", "true");
+		await userEvent.click(b);
+		expect(b).toHaveAttribute("aria-pressed", "true");
+		expect(a).toHaveAttribute("aria-pressed", "false");
+	});
 
-  it('多选：可同时选中多项，提交时用换行拼接', async () => {
-    const spy = vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    render(
-      React.createElement(PermissionPanel, {
-        mail: questionMail({ permission_options: ['A', 'B'], permission_multi_select: true })
-      })
-    );
+	it("多选：可同时选中多项，提交时用换行拼接", async () => {
+		const spy = vi
+			.spyOn(api, "decidePermission")
+			.mockResolvedValue({ status: "decided" } as any);
+		render(
+			React.createElement(PermissionPanel, {
+				mail: questionMail({
+					permission_options: ["A", "B"],
+					permission_multi_select: true,
+				}),
+			}),
+		);
 
-    await userEvent.click(screen.getByRole('button', { name: /^A$/ }));
-    await userEvent.click(screen.getByRole('button', { name: /^B$/ }));
-    await userEvent.click(screen.getByRole('button', { name: /提交回答/ }));
+		await userEvent.click(screen.getByRole("button", { name: /^A$/ }));
+		await userEvent.click(screen.getByRole("button", { name: /^B$/ }));
+		await userEvent.click(screen.getByRole("button", { name: /提交回答/ }));
 
-    // 服务端按换行拆分多选答案，不能拼接成 "AB" 或数组字符串
-    await waitFor(() => expect(spy).toHaveBeenCalledWith('m-1', 'A\nB', undefined));
-  });
+		// 服务端按换行拆分多选答案，不能拼接成 "AB" 或数组字符串
+		await waitFor(() =>
+			expect(spy).toHaveBeenCalledWith("m-1", "A\nB", undefined),
+		);
+	});
 
-  it('空回答禁止提交（模型不能拿到一个什么都没说的结果）', async () => {
-    const spy = vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    render(React.createElement(PermissionPanel, { mail: questionMail({ permission_options: [] }) }));
+	it("空回答禁止提交（模型不能拿到一个什么都没说的结果）", async () => {
+		const spy = vi
+			.spyOn(api, "decidePermission")
+			.mockResolvedValue({ status: "decided" } as any);
+		render(
+			React.createElement(PermissionPanel, {
+				mail: questionMail({ permission_options: [] }),
+			}),
+		);
 
-    const submit = screen.getByRole('button', { name: /提交回答/ });
-    expect(submit).toBeDisabled();
-    expect(screen.getByText('请先选择或填写回答')).toBeInTheDocument();
+		const submit = screen.getByRole("button", { name: /提交回答/ });
+		expect(submit).toBeDisabled();
+		expect(screen.getByText("请先选择或填写回答")).toBeInTheDocument();
 
-    await userEvent.type(screen.getByPlaceholderText('你的回答（必填）'), '配置在 /etc/foo.conf');
-    expect(submit).toBeEnabled();
-    await userEvent.click(submit);
-    await waitFor(() =>
-      expect(spy).toHaveBeenCalledWith('m-1', '', '配置在 /etc/foo.conf')
-    );
-  });
+		await userEvent.type(
+			screen.getByPlaceholderText("你的回答（必填）"),
+			"配置在 /etc/foo.conf",
+		);
+		expect(submit).toBeEnabled();
+		await userEvent.click(submit);
+		await waitFor(() =>
+			expect(spy).toHaveBeenCalledWith("m-1", "", "配置在 /etc/foo.conf"),
+		);
+	});
 
-  it('选了选项又写了备注：两者都发出去', async () => {
-    const spy = vi.spyOn(api, 'decidePermission').mockResolvedValue({ status: 'decided' } as any);
-    render(
-      React.createElement(PermissionPanel, {
-        mail: questionMail({ permission_options: ['方案 A'] })
-      })
-    );
+	it("选了选项又写了备注：两者都发出去", async () => {
+		const spy = vi
+			.spyOn(api, "decidePermission")
+			.mockResolvedValue({ status: "decided" } as any);
+		render(
+			React.createElement(PermissionPanel, {
+				mail: questionMail({ permission_options: ["方案 A"] }),
+			}),
+		);
 
-    await userEvent.click(screen.getByRole('button', { name: /方案 A/ }));
-    await userEvent.type(screen.getByPlaceholderText('补充说明（可选）'), '但要先备份');
-    await userEvent.click(screen.getByRole('button', { name: /提交回答/ }));
+		await userEvent.click(screen.getByRole("button", { name: /方案 A/ }));
+		await userEvent.type(
+			screen.getByPlaceholderText("补充说明（可选）"),
+			"但要先备份",
+		);
+		await userEvent.click(screen.getByRole("button", { name: /提交回答/ }));
 
-    await waitFor(() =>
-      expect(spy).toHaveBeenCalledWith('m-1', '方案 A', '但要先备份')
-    );
-  });
+		await waitFor(() =>
+			expect(spy).toHaveBeenCalledWith("m-1", "方案 A", "但要先备份"),
+		);
+	});
 
-  it('问题已回答过：显示结论，不再显示任何输入控件', () => {
-    render(
-      React.createElement(PermissionPanel, {
-        mail: questionMail({ permission_result: '方案 A' })
-      })
-    );
+	it("问题已回答过：显示结论，不再显示任何输入控件", () => {
+		render(
+			React.createElement(PermissionPanel, {
+				mail: questionMail({ permission_result: "方案 A" }),
+			}),
+		);
 
-    expect(screen.getByText(/已处理/)).toBeInTheDocument();
-    expect(screen.queryByRole('button')).toBeNull();
-  });
+		expect(screen.getByText(/已处理/)).toBeInTheDocument();
+		expect(screen.queryByRole("button")).toBeNull();
+	});
 
-  it('审批型（无 permission_kind）仍然走同意/拒绝路径', () => {
-    render(React.createElement(PermissionPanel, { mail: permMail() }));
+	it("审批型（无 permission_kind）仍然走同意/拒绝路径", () => {
+		render(React.createElement(PermissionPanel, { mail: permMail() }));
 
-    // 回归防护：question 分支不能把普通审批也带走
-    expect(screen.getByRole('button', { name: /同意/ })).toBeInTheDocument();
-    expect(screen.queryByRole('button', { name: /提交回答/ })).toBeNull();
-  });
+		// 回归防护：question 分支不能把普通审批也带走
+		expect(screen.getByRole("button", { name: /同意/ })).toBeInTheDocument();
+		expect(screen.queryByRole("button", { name: /提交回答/ })).toBeNull();
+	});
 });
diff --git a/deploy/install.sh b/deploy/install.sh
index d27d19d..2360ee6 100755
--- a/deploy/install.sh
+++ b/deploy/install.sh
@@ -60,6 +60,40 @@ else
   echo "    未找到 pi SDK（$PI_SDK），跳过 pi 插件测试"
 fi
 
+# pi 邮件工具扩展：给**交互式**会话装上 send_mail / read_inbox。
+#
+# 守护进程（pi-mail-bridge.service）用 noExtensions:true 起会话，它的邮件工具
+# 只给模型在邮件会话里用；人在 TUI 里敲的 pi 拿不到。结果是平台的建设者自己
+# 收不到邮件，只能绕到 curl + 密钥直连 Gateway。这个扩展补上那一侧 ——
+# TUI 与邮箱是同一条 AgentMail 身份（agent pi）的两个入口。
+#
+# 为什么不会重复注册：noExtensions:true 只加载 CLI `-e` 传的扩展，
+# settings.json 的 extensions 数组会被排除（见 SDK resource-loader.js），
+# 因此守护进程的 worker 里零扩展、本扩展只作用于交互式会话。
+if [[ -d "$PI_SDK" ]]; then
+  PI_HOME="${SUDO_USER:+$(getent passwd "$SUDO_USER" | cut -d: -f6)}"
+  PI_HOME="${PI_HOME:-$HOME}"
+  PI_SETTINGS="$PI_HOME/.pi/agent/settings.json"
+  EXT_PATH="$REPO/plugins/pi-mail-bridge/extension/index.ts"
+  if [[ -d "$PI_HOME/.pi/agent" || -f "$PI_SETTINGS" ]]; then
+    install -d "$(dirname "$PI_SETTINGS")"
+    node -e '
+      const fs = require("fs");
+      const [path, target] = process.argv.slice(1);
+      let cfg = {};
+      try { cfg = JSON.parse(fs.readFileSync(path, "utf8")); } catch { /* 新建 */ }
+      const list = Array.isArray(cfg.extensions) ? cfg.extensions : [];
+      if (list.includes(target)) { console.log("    已注册，幂等跳过"); process.exit(0); }
+      list.push(target);
+      cfg.extensions = list;
+      fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + "\n");
+      console.log("    已注册 " + target);
+    ' "$PI_SETTINGS" "$EXT_PATH"
+  else
+    echo "    未找到 $PI_HOME/.pi/agent，跳过（手动在 settings.json 加 extensions: [\"$EXT_PATH\"]）"
+  fi
+fi
+
 echo "==> 前端产物嵌入 Gateway"
 # 只清构建产物，不能 rm -rf 整个目录：
 # placeholder.html 在版本库里（让 go:embed 在新克隆里能编译），
diff --git a/plugins/dsh-mail-bridge/lib/mail-session-id.d.ts b/plugins/dsh-mail-bridge/lib/mail-session-id.d.ts
index e3597fa..3597da9 100644
--- a/plugins/dsh-mail-bridge/lib/mail-session-id.d.ts
+++ b/plugins/dsh-mail-bridge/lib/mail-session-id.d.ts
@@ -1,3 +1,9 @@
 export declare function dshSessionIdForMail(mailSessionID: any): string;
-export declare function matchesMailSession(dshSessionId: any, mailSessionID: any): boolean;
-export declare function pickMailSession(dshSessionIds: any[] | undefined, mailSessionID: any): string | undefined;
+export declare function matchesMailSession(
+	dshSessionId: any,
+	mailSessionID: any,
+): boolean;
+export declare function pickMailSession(
+	dshSessionIds: any[] | undefined,
+	mailSessionID: any,
+): string | undefined;
diff --git a/plugins/dsh-mail-bridge/lib/mail-session-id.js b/plugins/dsh-mail-bridge/lib/mail-session-id.js
index fe9778a..7a1432f 100644
--- a/plugins/dsh-mail-bridge/lib/mail-session-id.js
+++ b/plugins/dsh-mail-bridge/lib/mail-session-id.js
@@ -24,7 +24,7 @@
 
 /** 首次尝试使用的 DSH 会话 id。 */
 export function dshSessionIdForMail(mailSessionID) {
-  return `mail-${String(mailSessionID ?? '')}`;
+	return `mail-${String(mailSessionID ?? "")}`;
 }
 
 /**
@@ -35,12 +35,12 @@ export function dshSessionIdForMail(mailSessionID) {
  * @returns {boolean}
  */
 export function matchesMailSession(dshSessionId, mailSessionID) {
-  const id = String(dshSessionId ?? '');
-  const base = dshSessionIdForMail(mailSessionID);
-  if (id === base) return true;
-  // 模型降级重试：mail-<id>-r1 / -r2 / …
-  const suffix = id.startsWith(`${base}-r`) ? id.slice(base.length + 2) : '';
-  return suffix.length > 0 && /^\d+$/.test(suffix);
+	const id = String(dshSessionId ?? "");
+	const base = dshSessionIdForMail(mailSessionID);
+	if (id === base) return true;
+	// 模型降级重试：mail-<id>-r1 / -r2 / …
+	const suffix = id.startsWith(`${base}-r`) ? id.slice(base.length + 2) : "";
+	return suffix.length > 0 && /^\d+$/.test(suffix);
 }
 
 /**
@@ -54,19 +54,19 @@ export function matchesMailSession(dshSessionId, mailSessionID) {
  * @returns {string|undefined}
  */
 export function pickMailSession(dshSessionIds, mailSessionID) {
-  const base = dshSessionIdForMail(mailSessionID);
-  const list = Array.isArray(dshSessionIds) ? dshSessionIds.map(String) : [];
-  if (list.includes(base)) return base;
+	const base = dshSessionIdForMail(mailSessionID);
+	const list = Array.isArray(dshSessionIds) ? dshSessionIds.map(String) : [];
+	if (list.includes(base)) return base;
 
-  let best;
-  let bestIndex = Infinity;
-  for (const id of list) {
-    if (!matchesMailSession(id, mailSessionID)) continue;
-    const idx = Number(id.slice(base.length + 2));
-    if (idx < bestIndex) {
-      bestIndex = idx;
-      best = id;
-    }
-  }
-  return best;
+	let best;
+	let bestIndex = Infinity;
+	for (const id of list) {
+		if (!matchesMailSession(id, mailSessionID)) continue;
+		const idx = Number(id.slice(base.length + 2));
+		if (idx < bestIndex) {
+			bestIndex = idx;
+			best = id;
+		}
+	}
+	return best;
 }
diff --git a/plugins/dsh-mail-bridge/lib/sse-client.d.ts b/plugins/dsh-mail-bridge/lib/sse-client.d.ts
index c597c64..025f3b8 100644
--- a/plugins/dsh-mail-bridge/lib/sse-client.d.ts
+++ b/plugins/dsh-mail-bridge/lib/sse-client.d.ts
@@ -1,17 +1,17 @@
 export interface SseClientOptions {
-    authHeaders: () => Record<string, string>;
-    baseURL: string;
-    path: string;
-    onEvent: (evt: string, data: any) => void;
-    log?: (msg: string) => void;
+	authHeaders: () => Record<string, string>;
+	baseURL: string;
+	path: string;
+	onEvent: (evt: string, data: any) => void;
+	log?: (msg: string) => void;
 }
 export declare function createSSEClient(options: SseClientOptions): {
-    stop: () => void;
-    reset: () => void;
+	stop: () => void;
+	reset: () => void;
 };
 export declare function createFrameParser(): {
-    push: (chunk: string) => Array<{ event: string; data: string; id: string }>;
-    reset: () => void;
-    lastEventId: () => string;
-    setLastEventId: (id: string) => void;
+	push: (chunk: string) => Array<{ event: string; data: string; id: string }>;
+	reset: () => void;
+	lastEventId: () => string;
+	setLastEventId: (id: string) => void;
 };
diff --git a/plugins/dsh-mail-bridge/lib/user-question.d.ts b/plugins/dsh-mail-bridge/lib/user-question.d.ts
index bbbbbc4..a2264c5 100644
--- a/plugins/dsh-mail-bridge/lib/user-question.d.ts
+++ b/plugins/dsh-mail-bridge/lib/user-question.d.ts
@@ -2,12 +2,20 @@ export declare function hasOptions(question: any): boolean;
 export declare function optionLabels(question: any): string[];
 export declare function questionTitle(question: any): string;
 export declare function flattenQuestions(questions: any[]): {
-    question: string;
-    options: string[];
-    context: string;
-    multiSelect: boolean;
+	question: string;
+	options: string[];
+	context: string;
+	multiSelect: boolean;
 };
-export declare function answersFromDecision(questions: any[], decision: string, note?: string): {
-    answers: Array<{ id: string; selected: string[]; custom?: string }>;
+export declare function answersFromDecision(
+	questions: any[],
+	decision: string,
+	note?: string,
+): {
+	answers: Array<{ id: string; selected: string[]; custom?: string }>;
 };
-export declare function isBlankAnswer(questions: any[], decision: string, note?: string): boolean;
+export declare function isBlankAnswer(
+	questions: any[],
+	decision: string,
+	note?: string,
+): boolean;
diff --git a/plugins/dsh-mail-bridge/src/index.ts b/plugins/dsh-mail-bridge/src/index.ts
index 31a0532..3dad0d9 100644
--- a/plugins/dsh-mail-bridge/src/index.ts
+++ b/plugins/dsh-mail-bridge/src/index.ts
@@ -11,147 +11,180 @@
  *   - DSH:      tool 用 defineTool() + 参数 spec 格式
  */
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
-import { readFile, writeFile, mkdir, stat } from 'node:fs/promises';
-import { randomBytes } from 'node:crypto';
-import { homedir } from 'node:os';
-import { join, dirname } from 'node:path';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { readFile, writeFile, mkdir, stat } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
 import {
-  explicitSends,
-  noteExplicitSend,
-  shouldSkipAutoRelay,
-} from '../lib/relay-dedup.js';
-import { adoptedSessionID, adoptMissingMessage } from '../lib/adopt.js';
+	explicitSends,
+	noteExplicitSend,
+	shouldSkipAutoRelay,
+} from "../lib/relay-dedup.js";
+import { adoptedSessionID, adoptMissingMessage } from "../lib/adopt.js";
 import {
-  autoRelayDecision,
-  replyInstruction,
-  inboundHeadline,
-} from '../lib/relay-policy.js';
-import { clampRelayKey, isPermanentFailure } from '../lib/relay-key.js';
-import { BoundedMap, BoundedSet, MAX_TRACKED_MAILS, MAX_TRACKED_SESSIONS } from '../lib/bounded.js';
+	autoRelayDecision,
+	replyInstruction,
+	inboundHeadline,
+} from "../lib/relay-policy.js";
+import { clampRelayKey, isPermanentFailure } from "../lib/relay-key.js";
 import {
-  userMessage,
-  replySubject,
-  lastAssistantText,
-  modelTitle,
-} from '../lib/message.js';
-import { snapshotDshSessions, slugFromTitle } from '../lib/session-snapshot.js';
+	BoundedMap,
+	BoundedSet,
+	MAX_TRACKED_MAILS,
+	MAX_TRACKED_SESSIONS,
+} from "../lib/bounded.js";
 import {
-  snapshotDshModels,
-  modelAttemptOrder,
-  renderFailureReport,
-} from '../lib/model-scope.js';
-import { resolveWorkspaceCwd, ensureCwd, mailSessionFallback } from '../lib/workspace.js';
-import { selectCatchup } from '../lib/catchup.js';
+	userMessage,
+	replySubject,
+	lastAssistantText,
+	modelTitle,
+} from "../lib/message.js";
+import { snapshotDshSessions, slugFromTitle } from "../lib/session-snapshot.js";
 import {
-  renderInbox,
-  idsToMarkRead,
-  formatSize,
-  DEFAULT_INBOX_STATUS,
-  DEFAULT_INBOX_LIMIT,
-} from '../lib/inbox-format.js';
+	snapshotDshModels,
+	modelAttemptOrder,
+	renderFailureReport,
+} from "../lib/model-scope.js";
 import {
-  renderNameSuggestions,
-  renderPathSuggestions,
-  renderSessionSuggestions,
-  renderParticipants,
-  renderContacts,
-  renderThread,
-} from '../lib/discovery.js';
-import { appendRenameProposal, renameProposalNote } from '../lib/rename-proposal.js';
-import { createSSEClient } from '../lib/sse-client.js';
-import { pickMailSession } from '../lib/mail-session-id.js';
+	resolveWorkspaceCwd,
+	ensureCwd,
+	mailSessionFallback,
+} from "../lib/workspace.js";
+import { selectCatchup } from "../lib/catchup.js";
+import {
+	renderInbox,
+	idsToMarkRead,
+	formatSize,
+	DEFAULT_INBOX_STATUS,
+	DEFAULT_INBOX_LIMIT,
+} from "../lib/inbox-format.js";
+import {
+	renderNameSuggestions,
+	renderPathSuggestions,
+	renderSessionSuggestions,
+	renderParticipants,
+	renderContacts,
+	renderThread,
+} from "../lib/discovery.js";
+import {
+	appendRenameProposal,
+	renameProposalNote,
+} from "../lib/rename-proposal.js";
+import { createSSEClient } from "../lib/sse-client.js";
+import { pickMailSession } from "../lib/mail-session-id.js";
 // 只用 isApproval：DSH 没有 always 语义，免批授权表在这里用不上（见决策处的注释）。
-import { isApproval } from '../lib/permission-grants.js';
+import { isApproval } from "../lib/permission-grants.js";
 import {
-  flattenQuestions,
-  answersFromDecision,
-  isBlankAnswer,
-} from '../lib/user-question.js';
+	flattenQuestions,
+	answersFromDecision,
+	isBlankAnswer,
+} from "../lib/user-question.js";
 
 // ─── 凭证管理 ───
 
-const CONFIG_DIR = process.env.AGENTMAIL_CONFIG_DIR || join(homedir(), '.agentmail');
-const KEY_FILE = join(CONFIG_DIR, 'agent.key');
+const CONFIG_DIR =
+	process.env.AGENTMAIL_CONFIG_DIR || join(homedir(), ".agentmail");
+const KEY_FILE = join(CONFIG_DIR, "agent.key");
 
 function readLocalKey(): string | null {
-  try {
-    if (!existsSync(KEY_FILE)) return null;
-    const raw = JSON.parse(readFileSync(KEY_FILE, 'utf8'));
-    return typeof raw.key === 'string' ? raw.key : null;
-  } catch { return null; }
+	try {
+		if (!existsSync(KEY_FILE)) return null;
+		const raw = JSON.parse(readFileSync(KEY_FILE, "utf8"));
+		return typeof raw.key === "string" ? raw.key : null;
+	} catch {
+		return null;
+	}
 }
 
 function saveLocalKey(key: string) {
-  try {
-    mkdirSync(dirname(KEY_FILE), { recursive: true });
-    writeFileSync(KEY_FILE, JSON.stringify({ key }, null, 2), 'utf8');
-  } catch { /* 忽略 */ }
+	try {
+		mkdirSync(dirname(KEY_FILE), { recursive: true });
+		writeFileSync(KEY_FILE, JSON.stringify({ key }, null, 2), "utf8");
+	} catch {
+		/* 忽略 */
+	}
 }
 
 function generateLocalKey(): string {
-  const key = 'ak_' + randomBytes(24).toString('hex');
-  saveLocalKey(key);
-  return key;
+	const key = "ak_" + randomBytes(24).toString("hex");
+	saveLocalKey(key);
+	return key;
 }
 
 // ─── Gateway HTTP 客户端 ───
 
 class GatewayClient {
-  baseURL: string;
-  agentName: string;
-  agentKey: string;
-  agentSecret: string;
+	baseURL: string;
+	agentName: string;
+	agentKey: string;
+	agentSecret: string;
 
-  constructor(gatewayURL: string, agentName: string, agentKey: string, agentSecret: string) {
-    this.baseURL = gatewayURL.replace(/\/+$/, '');
-    this.agentName = agentName;
-    this.agentKey = agentKey;
-    this.agentSecret = agentSecret;
-  }
+	constructor(
+		gatewayURL: string,
+		agentName: string,
+		agentKey: string,
+		agentSecret: string,
+	) {
+		this.baseURL = gatewayURL.replace(/\/+$/, "");
+		this.agentName = agentName;
+		this.agentKey = agentKey;
+		this.agentSecret = agentSecret;
+	}
 
-  /** 与 opencode-mail-bridge 的 authHeaders() 相同逻辑 */
-  authHeaders(): Record<string, string> {
-    if (this.agentKey) {
-      return { Authorization: `Bearer ${this.agentKey}`, 'X-Agent-Name': this.agentName };
-    }
-    return { 'X-Agent-Name': this.agentName, 'X-Agent-Secret': this.agentSecret };
-  }
+	/** 与 opencode-mail-bridge 的 authHeaders() 相同逻辑 */
+	authHeaders(): Record<string, string> {
+		if (this.agentKey) {
+			return {
+				Authorization: `Bearer ${this.agentKey}`,
+				"X-Agent-Name": this.agentName,
+			};
+		}
+		return {
+			"X-Agent-Name": this.agentName,
+			"X-Agent-Secret": this.agentSecret,
+		};
+	}
 
-  async post(path: string, body: Record<string, unknown>): Promise<any> {
-    const res = await fetch(`${this.baseURL}/api/v1${path}`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json', ...this.authHeaders() },
-      body: JSON.stringify(body),
-    });
-    const data = await res.json() as any;
-    if (!res.ok) {
-      // 状态码与响应体挂在 error 上：调用方要区分「暂时失败」与「永远不会成功」。
-      // 权限询问碰到 409（任务链上没有人类）必须当场拒绝，
-      // 而 502 应该重试 —— 只看 message 字符串分不出这两种。
-      const err: any = new Error(data?.error || `POST ${path} failed: ${res.status}`);
-      err.status = res.status;
-      err.body = data;
-      throw err;
-    }
-    return data;
-  }
+	async post(path: string, body: Record<string, unknown>): Promise<any> {
+		const res = await fetch(`${this.baseURL}/api/v1${path}`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json", ...this.authHeaders() },
+			body: JSON.stringify(body),
+		});
+		const data = (await res.json()) as any;
+		if (!res.ok) {
+			// 状态码与响应体挂在 error 上：调用方要区分「暂时失败」与「永远不会成功」。
+			// 权限询问碰到 409（任务链上没有人类）必须当场拒绝，
+			// 而 502 应该重试 —— 只看 message 字符串分不出这两种。
+			const err: any = new Error(
+				data?.error || `POST ${path} failed: ${res.status}`,
+			);
+			err.status = res.status;
+			err.body = data;
+			throw err;
+		}
+		return data;
+	}
 
-  async get(path: string): Promise<any> {
-    const res = await fetch(`${this.baseURL}/api/v1${path}`, { headers: this.authHeaders() });
-    const data = await res.json() as any;
-    if (!res.ok) throw new Error(data?.error || `GET ${path} failed: ${res.status}`);
-    return data;
-  }
+	async get(path: string): Promise<any> {
+		const res = await fetch(`${this.baseURL}/api/v1${path}`, {
+			headers: this.authHeaders(),
+		});
+		const data = (await res.json()) as any;
+		if (!res.ok)
+			throw new Error(data?.error || `GET ${path} failed: ${res.status}`);
+		return data;
+	}
 
-  async register(): Promise<void> {
-    await this.post('/agent/register', {
-      name: this.agentName,
-      secret: this.agentSecret || '',
-      workspaces: [],
-      platform: 'dsh',
-    });
-  }
+	async register(): Promise<void> {
+		await this.post("/agent/register", {
+			name: this.agentName,
+			secret: this.agentSecret || "",
+			workspaces: [],
+			platform: "dsh",
+		});
+	}
 }
 
 // ─── 会话映射（与 opencode-mail-bridge 相同结构）───
@@ -161,16 +194,25 @@ class GatewayClient {
 // 上限淘汰（兜底）。没有它们，插件跟着 dsh 跑几周之后表里会躺着几十万条再也
 // 不会被查到的条目，而 GC 收不掉（还被强引用着）。
 
-const sessionMap = new BoundedMap<string, { dshSessionId: string; directory: string }>(MAX_TRACKED_SESSIONS);
+const sessionMap = new BoundedMap<
+	string,
+	{ dshSessionId: string; directory: string }
+>(MAX_TRACKED_SESSIONS);
 const reverseMap = new BoundedMap<string, string>(MAX_TRACKED_SESSIONS);
 const mailDrivenSessions = new BoundedSet<string>(MAX_TRACKED_SESSIONS);
 // 回信上下文。fromHuman / inReplyTo 是服务端给的两个信号：
 // 前者决定要不要自动转发（Agent 间不转，见 lib/relay-policy.js），
 // 后者决定提示词说「新任务」还是「你上封信的回复到了」。
-const mailContexts = new BoundedMap<string, {
-  replyTo: string; subject: string; mailID: string;
-  fromHuman: boolean; inReplyTo: string;
-}>(MAX_TRACKED_SESSIONS);
+const mailContexts = new BoundedMap<
+	string,
+	{
+		replyTo: string;
+		subject: string;
+		mailID: string;
+		fromHuman: boolean;
+		inReplyTo: string;
+	}
+>(MAX_TRACKED_SESSIONS);
 const relayedSummaries = new BoundedMap<string, string>(MAX_TRACKED_SESSIONS);
 
 // 管理员在配置页划定的可用模型范围（按优先级）。随心跳响应更新。
@@ -189,17 +231,17 @@ const syncedTitles = new BoundedMap<string, string>(MAX_TRACKED_SESSIONS);
  * 不该被归档打断。这里只解除邮件绑定。
  */
 function forgetSession(mailSessionID: string): void {
-  if (!mailSessionID) return;
-  // peek 而不是 get：这是清理路径，不该把即将删掉的条目刷成「最近活跃」。
-  const bound = sessionMap.peek(mailSessionID);
-  mailContexts.delete(mailSessionID);
-  sessionMap.delete(mailSessionID);
-  const dshSessionId = bound?.dshSessionId;
-  if (!dshSessionId) return;
-  reverseMap.delete(dshSessionId);
-  mailDrivenSessions.delete(dshSessionId);
-  relayedSummaries.delete(dshSessionId);
-  syncedTitles.delete(dshSessionId);
+	if (!mailSessionID) return;
+	// peek 而不是 get：这是清理路径，不该把即将删掉的条目刷成「最近活跃」。
+	const bound = sessionMap.peek(mailSessionID);
+	mailContexts.delete(mailSessionID);
+	sessionMap.delete(mailSessionID);
+	const dshSessionId = bound?.dshSessionId;
+	if (!dshSessionId) return;
+	reverseMap.delete(dshSessionId);
+	mailDrivenSessions.delete(dshSessionId);
+	relayedSummaries.delete(dshSessionId);
+	syncedTitles.delete(dshSessionId);
 }
 
 // 权限询问：DSH 的 approval/request 是 waterfall 钩子，插件把它转成邮件问人，
@@ -211,8 +253,8 @@ function forgetSession(mailSessionID: string): void {
 // 一条会让 DSH 侧那个 `await` 永远不返回 —— 那次工具调用直接挂死。它有确定的
 // 清理路径（决策到达 / 询问被 abort / 拆插件时 fail closed），不需要靠猜。
 interface PendingApproval {
-  resolve: (outcome: string) => void;
-  sessionId: string;
+	resolve: (outcome: string) => void;
+	sessionId: string;
 }
 const pendingApprovals = new Map<string, PendingApproval>();
 
@@ -224,10 +266,12 @@ const pendingApprovals = new Map<string, PendingApproval>();
 // 同样**不设上界**：静默淘汰一条会让 `ask_user_question` 永远挂死。
 // 清理路径确定：决策到达 / 询问被 abort / 拆插件时 fail closed。
 interface PendingQuestion {
-  resolve: (answers: { answers: Array<{ id: string; selected: string[]; custom?: string }> }) => void;
-  reject: (err: Error) => void;
-  questions: any[];
-  sessionId: string;
+	resolve: (answers: {
+		answers: Array<{ id: string; selected: string[]; custom?: string }>;
+	}) => void;
+	reject: (err: Error) => void;
+	questions: any[];
+	sessionId: string;
 }
 const pendingQuestions = new Map<string, PendingQuestion>();
 
@@ -250,8 +294,8 @@ const pendingQuestions = new Map<string, PendingQuestion>();
 // post-execute（源码里 `{kind:"post-result"}` → finalizeScheduledExecution
 // → postExecute），而 `{kind:'block', feedback}` 能换掉模型看到的内容。
 interface DeniedReason {
-  text: string;
-  at: number;
+	text: string;
+	at: number;
 }
 const deniedReasons = new Map<string, DeniedReason>();
 
@@ -259,37 +303,39 @@ const deniedReasons = new Map<string, DeniedReason>();
 const DENIED_REASON_TTL_MS = 10 * 60 * 1000;
 
 function denialKey(agentId: string, callId: unknown): string {
-  return `${agentId}:${String(callId ?? 'nocall')}`;
+	return `${agentId}:${String(callId ?? "nocall")}`;
 }
 
 function noteDenial(agentId: string, callId: unknown, text: string): void {
-  const now = Date.now();
-  for (const [k, v] of deniedReasons) {
-    if (now - v.at > DENIED_REASON_TTL_MS) deniedReasons.delete(k);
-  }
-  deniedReasons.set(denialKey(agentId, callId), { text, at: now });
+	const now = Date.now();
+	for (const [k, v] of deniedReasons) {
+		if (now - v.at > DENIED_REASON_TTL_MS) deniedReasons.delete(k);
+	}
+	deniedReasons.set(denialKey(agentId, callId), { text, at: now });
 }
 
 function takeDenial(agentId: string, callId: unknown): string | undefined {
-  const key = denialKey(agentId, callId);
-  const hit = deniedReasons.get(key);
-  if (!hit) return undefined;
-  deniedReasons.delete(key); // 一次性：同一次调用只能被换一次
-  if (Date.now() - hit.at > DENIED_REASON_TTL_MS) return undefined;
-  return hit.text;
+	const key = denialKey(agentId, callId);
+	const hit = deniedReasons.get(key);
+	if (!hit) return undefined;
+	deniedReasons.delete(key); // 一次性：同一次调用只能被换一次
+	if (Date.now() - hit.at > DENIED_REASON_TTL_MS) return undefined;
+	return hit.text;
 }
 
 // ─── 运行时导入 DSH 内部函数 ───
 
 let _defineTool: any;
 function defineTool(opts: any): any {
-  if (!_defineTool) {
-    try {
-      const dshToolsPath = require.resolve('@deepseek-ai/dsh-tools');
-      _defineTool = require(dshToolsPath).defineTool;
-    } catch { return opts; }
-  }
-  return _defineTool(opts);
+	if (!_defineTool) {
+		try {
+			const dshToolsPath = require.resolve("@deepseek-ai/dsh-tools");
+			_defineTool = require(dshToolsPath).defineTool;
+		} catch {
+			return opts;
+		}
+	}
+	return _defineTool(opts);
 }
 
 // ─── Cordis 插件入口 ───
@@ -300,1685 +346,2062 @@ function defineTool(opts: any): any {
 // sessionQuery 不列在这里而用 ctx.get('sessionQuery') 取：inject 是硬依赖，
 // 列进去的服务没挂载时整个插件不会启动 —— 而会话上报只是补全体验，
 // 不应该能把邮件投递整体拘死。
-export const inject = ['agents', 'tools'];
-export const name = 'dsh-mail-bridge';
+export const inject = ["agents", "tools"];
+export const name = "dsh-mail-bridge";
 
 interface PluginConfig {
-  gateway: { url: string; agentName: string; agentKey: string; agentSecret: string };
-  reply: { provider?: string; model?: string };
+	gateway: {
+		url: string;
+		agentName: string;
+		agentKey: string;
+		agentSecret: string;
+	};
+	reply: { provider?: string; model?: string };
 }
 
 export function apply(ctx: any, config: PluginConfig): void {
-  const GW = config.gateway.url || 'http://127.0.0.1:8180';
-  const AGENT_NAME = config.gateway.agentName || 'dsh';
-  let AGENT_KEY = config.gateway.agentKey || '';
-  const AGENT_SECRET = config.gateway.agentSecret || '';
-  const REPLY_PROVIDER = config.reply.provider || '';
-  const REPLY_MODEL = config.reply.model || 'AUTO';
-
-  if (!AGENT_KEY && !AGENT_SECRET) {
-    AGENT_KEY = readLocalKey() || generateLocalKey();
-  }
-
-  const client = new GatewayClient(GW, AGENT_NAME, AGENT_KEY, AGENT_SECRET);
-
-  // 注册 Agent
-  (async () => {
-    try {
-      await client.register();
-      ctx.logger.info(`[dsh-mail-bridge] 已接入 ${GW}，身份 ${AGENT_NAME}`);
-    } catch (e: any) {
-      ctx.logger.error(`[dsh-mail-bridge] 注册失败: ${e?.message || e}`);
-    }
-  })();
-
-  // ─── 心跳 + 平台会话上报 ───
-  //
-  // 心跳两个职责：
-  //   1. 保活 —— Gateway 靠 last_seen 判在线，不发心跳就会被当成离线（之前真的没发）
-  //   2. 上报平台侧会话快照 —— 写信时想续谈某条会话，得先知道那个工作区下
-  //      有哪些会话可续；Gateway 只看得见邮件驱动的那部分。
-  //
-  // 上报而不是让 Gateway 反向拉取：当前架构是单向的（Agent 持密钥主动连
-  // Gateway，Gateway 从不外呼），反向拉取需要它保存各平台的地址与凭证。
-
-  /**
-   * 收集本机 DSH 的会话快照。
-   *
-   * 优先用 ctx.sessionQuery（包含已落盘的历史会话），它不可用时退到
-   * ctx.agents.list()（只有当前活着的）。base bundle 里 session-query-sqlite 的
-   * openAt 是 'never'，但 listSessions/readTitle 这些精确读不依赖 SQLite
-   * —— 只有全文搜索会报 SESSION_QUERY_SEARCH_DISABLED。
-   *
-   * 返回 undefined 表示「本次拿不到列表」，调用方应当省略字段而不是传空数组：
-   * 空数组的语义是「平台侧确实一条会话都没有」，会把服务端的镜像抹掉。
-   */
-  async function collectSessions(): Promise<any[] | undefined> {
-    const q = ctx.get('sessionQuery');
-    if (q?.listSessions) {
-      try {
-        const records = await q.listSessions();
-        const ids = records
-          .map((r: any) => r?.header?.id)
-          .filter((id: any): id is string => typeof id === 'string');
-        // 标题在日志里，需要单独 fold。批量读而不是逐个读：
-        // readTitleSnapshots 共用一次 corpus 观测，而逐个 readTitle 会重复加载日志。
-        const titles = new Map<string, string>();
-        if (q.readTitleSnapshots && ids.length > 0) {
-          const results = await q.readTitleSnapshots(ids);
-          results.forEach((res: any, i: number) => {
-            // 单个会话读失败不该拘到其他会话（接口本身就是逐条隔离的）
-            if (res?.status === 'rejected') return;
-            const title = res?.value?.title?.title ?? res?.title?.title;
-            if (typeof title === 'string' && title) titles.set(ids[i], title);
-          });
-        }
-        return records.map((r: any) => ({
-          id: r?.header?.id,
-          cwd: r?.header?.cwd ?? '',
-          title: titles.get(r?.header?.id) ?? '',
-          updatedAt: r?.header?.createdAt,
-          // subagent 子会话要被过滤掉，判据在 header 上
-          origin: r?.header?.origin,
-          delegationDepth: r?.header?.delegationDepth,
-        }));
-      } catch (e: any) {
-        ctx.logger.warn(`[dsh-mail-bridge] sessionQuery 不可用，退到活会话列表: ${e?.message || e}`);
-      }
-    }
-
-    // 退路：只报当前活着的 agent。比什么都不报强 ——
-    // 它们恰好是正在进行的任务，也是最可能被续谈的那批。
-    try {
-      const live = ctx.agents?.list?.() ?? [];
-      return live.map((a: any) => ({
-        id: String(a?.id ?? ''),
-        cwd: a?.session?.header?.cwd ?? '',
-        title: modelTitle(a?.session?.events ?? []),
-        updatedAt: a?.session?.header?.createdAt,
-        origin: a?.session?.header?.origin,
-        delegationDepth: a?.session?.header?.delegationDepth,
-      }));
-    } catch {
-      return undefined;
-    }
-  }
-
-  // 已经投过的 mail_id。心跳与 SSE 建连之间有个窗口：那期间到的邮件
-  // 既在 pending_mails 里、也会被 SSE 推一次 —— 不去重就会投两遍。
-  //
-  // 有界：插件跟着 dsh 长期活着，这里会攒下每一封处理过的邮件 id 而永远没有
-  // 出口。淘汰是安全的 —— 它防的两种重复都发生在秒到分钟级。
-  const deliveredMails = new BoundedSet<string>(MAX_TRACKED_MAILS);
-  let caughtUp = false;
-
-  /**
-   * 补投离线期间积压的未读邮件。
-   *
-   * SSE 只推连上之后的事件，插件重启前发来的邮件不会再推一次。
-   * 不补的话那封邮件永远躺在收件箱里，而发件人以为 Agent 收到了。
-   */
-  async function catchUp(pending: unknown): Promise<void> {
-    if (!pending) return;
-    try {
-      const box = await client.get('/mail/inbox?status=unread&limit=20');
-      const tasks = selectCatchup(box?.mails ?? box, deliveredMails);
-      if (tasks.length === 0) return;
-      console.error(`[dsh-mail-bridge] 补投 ${tasks.length} 封离线期间的邮件（共 ${pending} 封未读）`);
-      // 串行：每封都要起一轮模型，并发放出去等于对上游打 N 个并发请求
-      for (const ev of tasks) {
-        // 逐封再查一次：拉收件箱和逐封投递之间 SSE 可能已经投过其中某封
-        if (deliveredMails.has(ev.mail_id)) continue;
-        deliveredMails.add(ev.mail_id);
-        try {
-          await deliverMail(ev, 'mail');
-        } catch (e: any) {
-          console.error(`[dsh-mail-bridge] 补投 ${ev.mail_id} 失败: ${e?.message || e}`);
-        }
-      }
-    } catch (e: any) {
-      console.error(`[dsh-mail-bridge] 补投失败: ${e?.message || e}`);
-    }
-  }
-
-  async function beat(): Promise<void> {
-    const body: Record<string, unknown> = {};
-    // DSH 有真沙箱（read-only / workspace-write / danger-full-access），
-    // 档位在这里是被强制执行的，不是 advisory。
-    body.mode_enforcement = 'native';
-    const [entries, models] = await Promise.all([collectSessions(), collectModels()]);
-    if (entries) {
-      body.platform_sessions = snapshotDshSessions(entries, (id) => mailDrivenSessions.has(id));
-    }
-    if (models) body.models = models;
-    try {
-      const res = await client.post('/agent/heartbeat', body);
-      // 生效的模型范围随心跳响应回传：管理员在配置页改了范围后，
-      // 插件最多一个周期（30 秒）就能看到新值，不需要重启。
-      if (Array.isArray(res?.allowed_models)) allowedModels = res.allowed_models;
-      // 只在首个成功的心跳后补投一次：之后的积压都由 SSE 覆盖，
-      // 每轮心跳都补的话会把「模型正在处理中、尚未标已读」的邮件重复投递。
-      if (!caughtUp) {
-        caughtUp = true;
-        await catchUp(res?.pending_mails);
-      }
-    } catch {
-      // 心跳失败不报错：网络抖动很常见，下一轮会补上。
-      // 真的持续连不上时 Gateway 会把它判成离线，那才是可见的信号。
-    }
-  }
-
-  ctx.effect(() => {
-    void beat();
-    const timer = setInterval(() => { void beat(); }, 30_000);
-    return () => clearInterval(timer);
-  }, 'dsh-mail-bridge.heartbeat');
-
-  // ─── 获取默认模型 ───
-
-  /**
-   * 这一轮按什么顺序尝试模型。
-   *
-   * 优先级：管理员划定的范围 > 环境变量指定 > 平台自己的默认选择。
-   * 范围是运行时可改的策略，环境变量是部署时的兜底，因此前者优先。
-   */
-  function attemptOrder(): ({ provider: string; model: string } | undefined)[] {
-    const envDefault = REPLY_PROVIDER && REPLY_MODEL
-      ? { provider: REPLY_PROVIDER, model: REPLY_MODEL }
-      : ctx.get('agentDefaultModel')?.currentSelection?.();
-    return modelAttemptOrder(allowedModels, envDefault);
-  }
-
-  /** 收集本机 DSH 看得见的模型目录，供配置页勾选。 */
-  async function collectModels(): Promise<any[] | undefined> {
-    const llm = ctx.get('llm');
-    if (!llm?.listProviders || !llm?.listModels) return undefined;
-    try {
-      const flat: any[] = [];
-      for (const p of llm.listProviders()) {
-        const id = p?.provider ?? p?.id;
-        if (typeof id !== 'string' || !id) continue;
-        try {
-          const models = await llm.listModels(id);
-          for (const m of models) flat.push(m);
-        } catch {
-          // 单个 provider 拉不到不该拖掉其他 provider ——
-          // 上游故障通常只影响一家
-        }
-      }
-      return snapshotDshModels(flat);
-    } catch {
-      // 拉不到就省略该字段，而不是上报空数组把配置页清成空白
-      return undefined;
-    }
-  }
-
-  /**
-   * 等这个会话的首轮真正跑起来，或者失败。
-   *
-   * **`ctx.agents.create()` 不会因为模型无效而失败** —— 它只是记下 agentOptions。
-   * 真正的失败发生在之后的 turn 里，异步抛出：
-   *
-   *     request/context {provider: "nonexistent", model: "x"}
-   *     turn/end {reason: {kind: "error", error: {code: "NO_ADAPTER", ...}}}
-   *
-   * 因此降级尝试不能只包一个 try/catch —— 那样第二个模型永远不会被试到。
-   * 这里用 `session/event` 观察 turn 的走向。
-   *
-   * **`assistant/chunk` 本身不是成功信号**：它的 `finish` 子类型也带错误 ——
-   *
-   *     {chunk: {type: 'finish', reason: {kind: 'error', failure: {code: 'NO_ADAPTER'}}}}
-   *
-   * 见过一次「无效 provider 却判成功」正是因为把任意 chunk 当成了走通。
-   * 判据要落在 chunk 的类型上：`finish` 看 reason，其余（`block-start`、
-   * `text-delta`、`tool-call-delta`…）才意味着模型真的在产出。
-   *
-   * 超时按「成功」处理：模型可能只是很慢（首 token 前要装载上下文），
-   * 把慢当成失败会在换模型的同时把已经在跑的那一轮丢掉。
-   *
-   * @param agent 刚建好的 agent
-   * @param timeoutMs 判定窗口
-   */
-  function awaitFirstTurn(agent: any, timeoutMs = 60_000): Promise<{ ok: true } | { ok: false; error: string }> {
-    return new Promise((resolve) => {
-      let done = false;
-      const finish = (r: { ok: true } | { ok: false; error: string }) => {
-        if (done) return;
-        done = true;
-        clearTimeout(timer);
-        dispose?.();
-        resolve(r);
-      };
-      const timer = setTimeout(() => finish({ ok: true }), timeoutMs);
-      /** 把 DSH 的错误对象拼成一行可读文本。 */
-      const describe = (err: any): string =>
-        [err?.code, err?.message].filter(Boolean).join(': ') || '未知错误';
-
-      const dispose = ctx.on('session/event', (session: any, event: any) => {
-        if (session !== agent.session) return;
-
-        if (event?.type === 'assistant/chunk') {
-          const chunk = event.data?.chunk;
-          if (chunk?.type === 'finish') {
-            if (chunk.reason?.kind === 'error') {
-              return finish({ ok: false, error: describe(chunk.reason.failure) });
-            }
-            return; // finish 收尾，等 turn/end
-          }
-          // assistant/chunk 模型在产出内容 → 模型确实活着，算 OK
-          return finish({ ok: true });
-        }
-
-        if (event?.type === 'turn/end') {
-          const reason = event.data?.reason;
-          if (reason?.kind === 'error') {
-            return finish({ ok: false, error: describe(reason.error) });
-          }
-          return finish({ ok: true });
-        }
-      });
-    });
-  }
-
-  /**
-   * 等待当前轮次结束后再投递下一封。
-   *
-   * 原来 catchUp 用 awaitFirstTurn（首 token 即放行），同一会话的多封邮件在
-   * 补投时全部撞进同一个 turn → 「message undefined is already pending」。
-   * 这个函数等 turn/end，且对同一会话串行化，杜绝并发 followup。
-   */
-  async function waitForTurnEnd(agent: any, timeoutMs = 120_000): Promise<void> {
-    await new Promise<void>((resolve) => {
-      let done = false;
-      const finish = () => { if (!done) { done = true; clearTimeout(timer); dispose?.(); resolve(); } };
-      const timer = setTimeout(finish, timeoutMs);
-      const dispose = ctx.on('session/event', (session: any, event: any) => {
-        if (session !== agent.session) return;
-        if (event?.type === 'turn/end') finish();
-      });
-    });
-  }
-
-  /** 按会话锁串行化 followup，同一会话同一时刻只跑一轮。 */
-  const sessionLocks = new Map<string, Promise<void>>();
-  async function locked<T>(dshSessionId: string, fn: () => Promise<T>): Promise<T> {
-    const prev = sessionLocks.get(dshSessionId) ?? Promise.resolve();
-    let release!: () => void;
-    const next = new Promise<void>((r) => { release = r; });
-    sessionLocks.set(dshSessionId, next);
-    try {
-      await prev;
-      return await fn();
-    } finally {
-      release();
-      if (sessionLocks.get(dshSessionId) === next) sessionLocks.delete(dshSessionId);
-    }
-  }
-
-  // ─── 建会话（磁盘上已有则 resume）───
-
-  /**
-   * 问持久化层：磁盘上是否已经有这条会话？
-   *
-   * `sessionMap` 是纯内存的，插件重启后为空，于是同一封邮件的续谈会走
-   * 「新开会话」那条路，用回同一个 `mail-<session_id>` —— 而那个 id 上一次
-   * 已经落过盘。只能问持久化层，因为这是重启后唯一还存在的事实来源。
-   *
-   * 读不到就当作不存在：`readSession` 在会话不存在、日志不可读、replay 校验
-   * 不过时都会抛。三种情形里只有第一种适合 create，但后两种 resume 也一样
-   * 救不回来 —— 那就让 create 去报它自己的错。
-   */
-  async function persistedCwd(sessionId: string): Promise<string | undefined> {
-    const q: any = (ctx as any).get?.('sessionQuery');
-    if (!q?.readSession) return undefined;
-    try {
-      const snap = await q.readSession(sessionId);
-      return snap?.header?.cwd ?? '';
-    } catch {
-      return undefined;
-    }
-  }
-
-  /**
-   * 启一个 agent：磁盘上没有这个 id 就 create，有就 resume。
-   *
-   * # 为何必须先探测，不能靠 try/catch
-   *
-   * id 冲突不是 `create` 报的：持久化是在**轮次进行中** flush 的，所以
-   * `create` 会正常返回，错误到 `turn/end` 才以 `reason.kind === 'error'`
-   * 冲出来（实测：`UNKNOWN: session "..." already has a persisted log on disk`）。
-   * 把修法写成 catch 里改 resume 完全不会生效 —— 这与「模型失败不是同步抛出的」
-   * 是同一类陷阱，只是上了一层。
-   *
-   * # 为何 resume 而不是换一个新 id
-   *
-   * 换 id 等于把之前的往来上下文丢掉，模型会重新问一遍已经问过的问题。
-   * resume 把磁盘上那条会话装回来接着谈，这同时修掉了一个已知取舍：
-   * 插件重启后续谈的邮件不再另开一条平台会话。
-   *
-   * resume 不接受 `meta`：cwd 取自持久化的 header。这正是想要的 —— 上一次在哪个
-   * 目录，就继续在那儿；传一个不同的 cwd 只会得到
-   * `is already persisted at a different cwd` 而不是“改目录”。
-   */
-  async function startAgent(
-    sessionId: string, cwd: string, route: any,
-  ): Promise<{ handle: any; resumed: boolean }> {
-    // route 为 undefined 表示不指定模型，交给平台自己选
-    const agentOptions = route ? { provider: route.provider, model: route.model } : {};
-
-    // 注册 standard preset 的工具（bash、fs、fs-search 等）。
-    // dsh-a2a 用同一套 API（ctx.get('agentPresets') + presets.mount）并稳定运行。
-    //
-    // create 与 resume 都必须挂：resume 从磁盘恢复的是**会话历史**，
-    // 不是工具注册 —— 工具是 setup 回调里 mount 的，resume 不传 setup
-    // 就等于回到 setup:undefined 时代（邮件会话没有任何文件工具）。
-    const setupPreset = async (agentCtx: any) => {
-      console.error(`[dsh-mail-bridge] setup 回调触发，agentCtx keys=${JSON.stringify(Object.keys(agentCtx || {}))}`);
-      try {
-        const presets = ctx.get('agentPresets');
-        console.error(`[dsh-mail-bridge] agentPresets: ${presets ? '存在' : '不存在'}`);
-        if (presets) {
-          const preset = await presets.resolve('standard');
-          console.error(`[dsh-mail-bridge] standard preset: id=${preset?.id} keys=${JSON.stringify(Object.keys(preset || {}))}`);
-          if (preset?.id) {
-            await presets.mount(agentCtx, preset.id);
-            console.error(`[dsh-mail-bridge] presets.mount 成功`);
-          } else {
-            console.error(`[dsh-mail-bridge] standard preset 无 id，跳过 mount`);
-          }
-        }
-      } catch (e: any) {
-        console.error(`[dsh-mail-bridge] presets.mount 失败（工具注册降级）: ${e?.message || e}\n${e?.stack?.slice(0,300)}`);
-      }
-    };
-
-    const onDisk = await persistedCwd(sessionId);
-    if (onDisk !== undefined) {
-      // 用 console.error 而不是 ctx.logger.info：后者不进 journalctl（实测），
-      // 而这条是排查「邮件投不进去」时唯一能看到的线索。
-      console.error(`[dsh-mail-bridge] 会话 ${sessionId} 已在磁盘上（cwd=${onDisk || '未记录'}），改为 resume 续谈`);
-      const handle = await ctx.agents.resume({
-        resumeSessionId: sessionId as any,
-        agentOptions,
-        setup: setupPreset,
-      });
-      return { handle, resumed: true };
-    }
-
-    const handle = await ctx.agents.create({
-      sessionId,
-      meta: { cwd },
-      agentOptions,
-      setup: setupPreset,
-    });
-    return { handle, resumed: false };
-  }
-
-  // ─── 权限档位 ───
-  //
-  // DSH 的权限由两个独立旋钮控制：
-  //   sandbox/mode  → 控制文件系统和命令执行的边界
-  //   approval/policy → 控制是否需要人类审批
-  //
-  // 三档映射（见 lib/permission-mode.js dshSandboxMode / dshApprovalPolicy）：
-  //   plan     → read-only + ask（只读，遇到权限询问转邮件）
-  //   workspace → workspace-write + ask（目录内可写，越界转邮件）
-  //   full     → danger-full-access + never（完全放开，不问人）
-  //
-  // 直接往 session 上 append 事件（与 permissionPresets.set 同一底层）。
-  // 不走 permissionPresets 服务：它要求 preset 名在配置表里，
-  // 而我们的三档映射需要完全自主控制。
-  function applyPermissionMode(session: any, mode: string): void {
-    if (!session?.append) return;
-    const m = (mode || 'workspace').trim();
-    // sandbox mode
-    const sandboxMap: Record<string, string> = {
-      plan: 'read-only',
-      workspace: 'workspace-write',
-      full: 'danger-full-access',
-    };
-    const sandbox = sandboxMap[m] ?? 'workspace-write';
-    session.append('sandbox/mode', { mode: sandbox });
-    // approval policy
-    const approvalMap: Record<string, string> = {
-      plan: 'ask',
-      workspace: 'ask',
-      full: 'never',
-    };
-    const approval = approvalMap[m] ?? 'ask';
-    session.append('approval/policy', { policy: approval });
-  }
-
-  /**
-   * 由邮件会话 id 找一个**活着的** DSH 会话，找到就补回内存映射。
-   *
-   * # 为什么不能只查 sessionMap
-   *
-   * 那是一张纯内存表，插件重启后为空。而 `session_update`（人在 WebUI 改
-   * 权限档位）只关心**正在跑**的那条会话 —— 重启后它恰好还没收到新邮件时，
-   * 映射缺失会让这条更新被静默忽略：人在界面上把 full 改回 workspace，
-   * 运行时依旧按 full 执行。人以为自己收紧了权限。
-   *
-   * 邮件新建的会话 id 是确定性的（`mail-<邮件会话 id>`，重试时带 `-r<i>`，
-   * 见 lib/mail-session-id.js），所以重启后也能定位，并且顺手把映射补回去 ——
-   * 否则这条会话后续的自动转发（reverseMap）也会一起失效。
-   *
-   * 接管会话（adopted）是例外：那条 DSH 会话 id 由平台生成，从邮件会话 id
-   * 推不出来，重启后确实无法定位热更新 —— 已知取舍；下次投递时会按邮件里
-   * 带的 permission_mode 重新 apply，档位不会丢。
-   */
-  function findLiveDshSession(mailSessionID: string): { id: string; agent: any } | undefined {
-    const bound = sessionMap.peek(mailSessionID);
-    if (bound) {
-      const live = ctx.agents.get(bound.dshSessionId);
-      if (live) return { id: bound.dshSessionId, agent: live };
-    }
-
-    let live: any[] = [];
-    try {
-      live = ctx.agents?.list?.() ?? [];
-    } catch {
-      return undefined;
-    }
-    const id = pickMailSession(live.map((a: any) => String(a?.id ?? '')), mailSessionID);
-    if (!id) return undefined;
-
-    const agent = live.find((a: any) => String(a?.id ?? '') === id);
-    if (!agent) return undefined;
-
-    if (!bound) {
-      const cwd = String(agent?.session?.header?.cwd ?? '');
-      sessionMap.set(mailSessionID, { dshSessionId: id, directory: cwd });
-      reverseMap.set(id, mailSessionID);
-      mailDrivenSessions.add(id);
-      console.error(`[dsh-mail-bridge] 由确定性 id 恢复会话映射 ${mailSessionID} -> ${id}`);
-    }
-    return { id, agent };
-  }
-
-  // ─── 投递邮件到 DSH 会话 ───
-
-  /**
-   * 投进「被接管的平台会话」时给模型的提示词。
-   *
-   * 与新建会话那份的差别：不自我介绍身份、不解释邮件系统 —— 这条会话里人已经
-   * 在谈别的事了，一段「你是 dsh，你收到一封邮件」的开场白会让模型以为上下文
-   * 被重置。只说「有封邮件进来了」。
-   */
-  function adoptPrompt(data: any, kind: string): string {
-    if (kind === 'permission') {
-      return `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || '用户'}）。请据此继续后续工作。`;
-    }
-    const fromHuman = data.from_human === true;
-    return [
-      inboundHeadline({ inReplyTo: data.in_reply_to, fromHuman, reused: true }),
-      ``,
-      `发件人：${data.from_name || 'unknown'}`,
-      `主题：${data.subject || '(无主题)'}`,
-      `邮件 ID：${data.mail_id || 'unknown'}`,
-      ...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
-      ...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
-      ``,
-      `请先调用 read_inbox 读取完整正文，然后处理其中的请求。`,
-      ...replyInstruction({ fromHuman, replyAddress: data.reply_address }),
-    ].join('\n');
-  }
-
-  /**
-   * 记下「这条邮件会话 ↔ 这条平台会话」的绑定与回信上下文。
-   *
-   * mailDrivenSessions 必须加：接管之后这条会话**开始**参与邮件往来，轮次结束
-   * 要把总结转回发件人。不加的话邮件投进去了却永远没有回音。
-   */
-  function bindAdopted(mailSessionID: string, dshSessionId: string, cwd: string, data: any): void {
-    if (!mailSessionID) return;
-    sessionMap.set(mailSessionID, { dshSessionId, directory: cwd });
-    reverseMap.set(dshSessionId, mailSessionID);
-    mailDrivenSessions.add(dshSessionId);
-    mailContexts.set(mailSessionID, {
-      replyTo: data.from_name || '',
-      subject: data.subject || '',
-      mailID: data.mail_id || '',
-      fromHuman: data.from_human === true,
-      inReplyTo: data.in_reply_to || '',
-    });
-  }
-
-  async function deliverMail(data: any, kind: string): Promise<{ sessionID: string; reused: boolean }> {
-    const mailSessionID = data.session_id;
-    const existing = mailSessionID ? sessionMap.get(mailSessionID) : undefined;
-
-    // 服务端说这条邮件会话**接管了平台上已经存在的那条会话**（人在 DSH 界面上
-    // 开的那种）—— 投进它而不是新建。
-    //
-    // TUI 与邮箱是同一个 Agent 的两个入口，不是两套隔离的世界。补全早就把平台
-    // 会话列为候选（session-snapshot 上报的那批），这一跳补上投递侧。
-    //
-    // DSH 上不需要新代码路径：`startAgent` 本来就「磁盘上有就 resume」，
-    // 接管只是把会话 id 从 `mail-<uuid>` 换成平台自己那个。第一次投递走
-    // resume 分支装回上下文，之后与普通续谈完全一样（sessionMap 命中 → followup）。
-    const adoptedID = adoptedSessionID(data);
-    if (!existing && adoptedID) {
-      const onDisk = await persistedCwd(adoptedID);
-      if (onDisk === undefined) {
-        // 平台侧那条会话已不在磁盘上。
-        //
-        // 不能落到「新开会话」那条路 —— 那会用 `mail-<uuid>` 另开一条，
-        // 人在 DSH 界面上看不到这封邮件带来的对话，而那正是接管的目的（N-8）。
-        //
-        // 用 console.error 而不是仅靠抛异常：调用方那层的 catch 走
-        // `ctx.logger.error`，而 DSH 的 logger **不进 journalctl**。邮件因此会
-        // 静默消失：发件人以为送到了，而日志里一个字都没有（实测过）。
-        console.error(`[dsh-mail-bridge] 接管失败：会话 ${adoptedID} 不在本机磁盘上`
-          + `（mail ${data.mail_id}，发件人 ${data.from_name || '?'}）。`
-          + `若这个 id 属于另一个平台，说明 Gateway 把别人的 platform_session_id `
-          + `推给了本插件。`);
-        throw new Error(adoptMissingMessage(adoptedID, '磁盘上已无这条会话的日志'));
-      }
-      return locked(adoptedID, async () => {
-        const promptText = adoptPrompt(data, kind);
-        const live = ctx.agents.get(adoptedID);
-        if (live) {
-          // 界面上正开着这条会话 —— 直接 followup，不要再 resume 一次：
-          // 同一条会话两个 handle 会各自往日志里写，replay 校验过不去。
-          live.followup(userMessage(promptText));
-          await waitForTurnEnd(live);
-          bindAdopted(mailSessionID, adoptedID, onDisk, data);
-          return { sessionID: adoptedID, reused: true };
-        }
-        const { handle } = await startAgent(adoptedID, onDisk, attemptOrder()[0]);
-        applyPermissionMode(handle.agent?.session, data.permission_mode);
-        bindAdopted(mailSessionID, adoptedID, onDisk, data);
-        handle.agent.followup(userMessage(promptText));
-        await waitForTurnEnd(handle.agent);
-        return { sessionID: adoptedID, reused: true };
-      });
-    }
-
-    if (existing) {
-      const live = ctx.agents.get(existing.dshSessionId);
-      if (live) {
-        return locked(existing.dshSessionId, async () => {
-          // 回信上下文必须刷成**这一封**。
-          //
-          // 续谈分支原来不刷：mailContexts 只在 bindAdopted 与新开会话时写一次，
-          // 于是同一条会话的第二封邮件跑完后，自动转发用的还是**第一封**的
-          // subject / mailID —— 回信主题与 parent_mail_id 都指向上一封。
-          // 实测撞出过：回「全流程回归」那封的信，主题写的是上一封
-          // 「platformID 归属验证」，parent 也挂在那封上。
-          //
-          // 与 pi 桥的语义对齐：那边每封邮件都重建 mailContext（worker 一封一进程），
-          // 注释写的就是「一个会话里可能来过多封信，只留最近那封」。
-          if (kind === 'mail' && mailSessionID) {
-            mailContexts.set(mailSessionID, {
-              replyTo: data.from_name || '',
-              subject: data.subject || '',
-              mailID: data.mail_id || '',
-              fromHuman: data.from_human === true,
-              inReplyTo: data.in_reply_to || '',
-            });
-          }
-          const promptText = kind === 'permission'
-            ? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || '用户'}）。请据此继续后续工作。`
-            : [
-                inboundHeadline({
-                  inReplyTo: data.in_reply_to,
-                  fromHuman: data.from_human === true,
-                  reused: true,
-                }),
-                ``,
-                `发件人：${data.from_name || 'unknown'}`,
-                `主题：${data.subject || '(无主题)'}`,
-                `邮件 ID：${data.mail_id || 'unknown'}`,
-                ...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
-                ...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
-                ``,
-                `请先调用 read_inbox 读取完整正文，然后处理其中的请求。`,
-                ...replyInstruction({
-                  fromHuman: data.from_human === true,
-                  replyAddress: data.reply_address,
-                }),
-              ].join('\n');
-          live.followup(userMessage(promptText));
-          // 等 turn/end 而不是立即返回：这封邮件的轮次未结束时投递下一封，
-          // 会让 DSH 报 "message already pending"。串行化靠 locked() 保证
-          // 同一时刻只有一个 followup 在跑，两个锁互斥 —— 即使 turn/end
-          // 未出现（比如模型完全没响应），120s 超时兜底不会把后续邮件永久卡住。
-          await waitForTurnEnd(live);
-          return { sessionID: existing.dshSessionId, reused: true };
-        });
-      }
-    }
-
-    // 新开会话
-    const sessionId = `mail-${mailSessionID || Date.now()}`;
-    // cwd 取寻址里的 path 位（to_workspace）。
-    //
-    // 之前这里硬拼 `~/.dsh/mail-sessions/mail-<uuid>` —— 每封邮件一个全新的空目录。
-    // DSH 按 cwd 给会话分组，于是所有邮件会话既不属于任何项目、彼此也不同组，
-    // 界面上全落进「未分组」。path 位本来就是「希望它在哪儿干活」。
-    const { cwd, grouped } = resolveWorkspaceCwd(
-      data.to_workspace, mailSessionFallback(sessionId));
-    ensureCwd(cwd, grouped);
-    if (!grouped && data.to_workspace) {
-      ctx.logger.warn(
-        `[dsh-mail-bridge] 工作目录 ${data.to_workspace} 不可用，回退到 ${cwd}`);
-    }
-
-    const promptText = kind === 'permission'
-      ? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || '用户'}）。请据此继续。`
-      : [
-          inboundHeadline({
-            inReplyTo: data.in_reply_to,
-            fromHuman: data.from_human === true,
-            catchup: data.catchup,
-            reused: false,
-          }),
-          ``,
-          `发件人：${data.from_name || 'unknown'}`,
-          `主题：${data.subject || '(无主题)'}`,
-          `邮件 ID：${data.mail_id || 'unknown'}`,
-          ...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
-          `身份：你是 ${AGENT_NAME}`,
-          ...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
-          ``,
-          `请先调用 read_inbox 读取完整正文（附带附件清单，如有附件可用 download_attachment 取回），然后处理其中的请求。`,
-          ``,
-          ...replyInstruction({
-            fromHuman: data.from_human === true,
-            replyAddress: data.reply_address,
-          }),
-        ].join('\n');
-
-    // 按管理员划定的范围逐个尝试建 agent，全部失败才回一封说明原因的邮件。
-    //
-    // 必须发那封信：agent 一次都没建起来时会话里没有任何 assistant 消息，
-    // 自动转发因此什么也不会发 —— 发件人只会看到邮件发出去后再无音讯。
-    //
-    // DSH 与 opencode 的差异：这里失败在**建 agent** 时就暴露（模型路由是
-    // agentOptions 的一部分），而 opencode 是在 promptAsync 时。
-    const attempts = attemptOrder();
-    const failures: { provider?: string; model?: string; error: string }[] = [];
-
-    for (let i = 0; i < attempts.length; i++) {
-      const route = attempts[i];
-      const label = route ? `${route.provider}/${route.model}` : '(平台默认)';
-      // 每次尝试用不同的会话 id：失败那次的日志里已经有 turn/end error，
-      // 复用同一个 id 会让重试接在一条已经出错的会话后面。
-      const attemptSessionId = i === 0 ? sessionId : `${sessionId}-r${i}`;
-      let handle: any;
-
-      try {
-        const started = await startAgent(attemptSessionId, cwd, route);
-        handle = started.handle;
-        // 设定权限档位：sandbox/mode 决定文件与命令边界，
-        // approval/policy 决定越界时是否转邮件问人。
-        applyPermissionMode(handle.agent?.session, data.permission_mode);
-      } catch (e: any) {
-        // create/resume 本身很少失败（create 不校验模型），
-        // 但 cwd 不符、日志 replay 不过之类仍会抛
-        failures.push({ ...(route ?? {}), error: e?.message || String(e) });
-        console.error(`[dsh-mail-bridge] 建会话失败 ${label}: ${e?.message || e}`);
-        continue;
-      }
-
-      // 先建映射再 followup：turn 可能在 followup 返回前就产出事件，
-      // 而 agent/status 的处理要靠这些映射找到回信地址。
-      if (mailSessionID) {
-        sessionMap.set(mailSessionID, { dshSessionId: attemptSessionId, directory: cwd });
-        reverseMap.set(attemptSessionId, mailSessionID);
-        mailDrivenSessions.add(attemptSessionId);
-        mailContexts.set(mailSessionID, {
-          replyTo: data.from_name || '',
-          subject: data.subject || '',
-          mailID: data.mail_id || '',
-          fromHuman: data.from_human === true,
-          inReplyTo: data.in_reply_to || '',
-        });
-      }
-
-      // 把会话挂进工作区注册表 —— 这是让 DSH GUI 把它从「未分组」挪进对应项目
-      // 的唯一路径。不挂的后果：会话永远落在 Ungrouped，人类在侧栏看不到它
-      // 与项目的从属关系，也无法用 DSH 的工作区级操作（批量归档、重命名等）。
-      //
-      // **cwd 必须取自会话 header，不能用上面那个 `cwd` 变量。**
-      //
-      // 上一版就错在这里：那个变量是 `resolveWorkspaceCwd` 的结果，可能是**兜底值**
-      // （`~/.dsh/mail-sessions/mail-<uuid>`）；而 resume 路径下会话的真实 cwd 取自
-      // 持久化的 header，两者不一致时 `attachSession` 的校验直接拒绝：
-      //
-      //   cannot attach session 'mail-f3d824ce…' to workspace
-      //   '/root/.dsh/mail-sessions/mail-f3d824ce…': its cwd resolves to '/home/program/llmsproxy'
-      //
-      // 更糟的是 `wr.create()` 已经先执行了 —— 于是每封邮件都往注册表里
-      // 塞一条永远为空的垃圾 workspace。先读 header 再注册就不会有这个问题。
-      //
-      // 失败不可怕：会话本身已经能用了，只是 GUI 分组不对。
-      if (handle) {
-        try {
-          // 真实 cwd：create 路径下就是上面传的 meta.cwd，
-          // resume 路径下是持久化 header 里那个。两种情形都从 session 读。
-          const actualCwd = String(handle.agent?.session?.header?.cwd ?? '');
-          const wr: any = (ctx as any).get?.('workspaceRegistry');
-          if (actualCwd && wr?.create) {
-            const ws = await wr.create(actualCwd, actualCwd.split('/').pop() || actualCwd);
-            if (ws?.attachSession) {
-              await ws.attachSession(attemptSessionId as any);
-            }
-          }
-        } catch (e: any) {
-          // 工作区注册失败不影响会话功能：只有 GUI 分组会受影响。
-          // 日志用 console.error 才进 journalctl（ctx.logger 不进）。
-          console.error(`[dsh-mail-bridge] 工作区注册失败（不影响功能）: ${e?.message || e}`);
-        }
-      }
-
-      const watching = awaitFirstTurn(handle.agent);
-      handle.agent.followup(userMessage(promptText));
-      const outcome = await watching;
-
-      if (outcome.ok) {
-        if (failures.length > 0) {
-          console.error(`[dsh-mail-bridge] ${label} 成功（前 ${failures.length} 个失败）`);
-        }
-        return { sessionID: attemptSessionId, reused: false };
-      }
-
-      failures.push({ ...(route ?? {}), error: outcome.error });
-      console.error(`[dsh-mail-bridge] 模型 ${label} 失败: ${outcome.error}`);
-      // 拆掉这一路的 agent 与映射，否则它会占着会话 id，
-      // 而 agent/status 还会为这个死会话触发一次自动转发
-      reverseMap.delete(attemptSessionId);
-      mailDrivenSessions.delete(attemptSessionId);
-      try {
-        await handle.dispose();
-      } catch {
-        // dispose 失败不影响换下一个模型
-      }
-    }
-    if (mailSessionID) sessionMap.delete(mailSessionID);
-
-    // 全部失败：把原因作为邮件回给发件人。走免配额通道 ——
-    // 这是插件的故障报告，不是模型的自主发信。
-    if (kind === 'mail' && data.from_name) {
-      try {
-        await client.post('/mail/send', {
-          to: data.from_name,
-          subject: `处理失败: ${data.subject || '(无主题)'}`,
-          body: renderFailureReport(failures, data.subject),
-          reply_to: data.mail_id || '',
-          relay: 'summary',
-          relay_key: clampRelayKey(`model-failure:${data.mail_id || sessionId}`),
-        });
-        ctx.logger.info(`[dsh-mail-bridge] 已回报模型调用失败给 ${data.from_name}`);
-      } catch (e: any) {
-        ctx.logger.error(`[dsh-mail-bridge] 失败回报也发不出去: ${e?.message || e}`);
-      }
-    }
-    throw new Error(
-      `划定范围内的 ${failures.length} 个模型全部失败：` +
-      failures.map(f => f.error).join(' | '));
-  }
-
-  // ─── SSE 监听 ───
-  //
-  // 共用客户端（lib/sse-client.js）：跨 TCP 分片保帧状态 + Last-Event-ID 断点续传。
-  // 之前手写的解析把 evt/data 当 read() 的局部变量，一帧被切在两个 chunk 就整帧
-  // 静默丢弃（new_mail / permission_decision / session_update 都可能丢）；也不带
-  // Last-Event-ID，断线期间的事件回放不出来。
-
-  let sseClient: { stop: () => void } | null = null;
-
-  function startSSE(onEvent: (type: string, data: any) => void) {
-    sseClient?.stop?.();
-    sseClient = createSSEClient({
-      authHeaders: () => client.authHeaders(),
-      baseURL: GW.replace(/\/+$/, ''),
-      path: '/api/v1/events/stream',
-      onEvent,
-      log: (msg: string) => console.error(`[dsh-mail-bridge] ${msg}`),
-    });
-    return sseClient;
-  }
-
-  // ─── 注册模型工具 ───
-
-  ctx.effect(() => {
-    // send_mail
-    ctx.tools.register(defineTool({
-      name: 'send_mail',
-      description: '发送邮件。三维地址 name@path.session：省略 session 投递到默认会话，.new 强制新建，.具体别名 必须已存在。回复来信请传 reply_to。',
-      parameters: {
-        to: { type: 'string', required: true, description: '收件人三维地址' },
-        subject: { type: 'string', required: true, description: '邮件主题' },
-        body: { type: 'string', required: true, description: '邮件正文（Markdown）' },
-        cc: { type: 'string', description: '抄送，逗号分隔多个三维地址' },
-        reply_to: { type: 'string', description: '回复某封邮件时传其 mail_id' },
-        session_alias: { type: 'string', description: '给新会话命名' },
-        attachment_ids: { type: 'array', items: { type: 'string' }, description: '附件 ID 列表' },
-        propose_alias: {
-          type: 'string',
-          description: '建议把当前会话改名成这个别名（例如摸清问题后从「排查登录问题」改成 fix-session-cookie-leak）。这只是建议：别名是人的寻址入口，实际改名由用户在界面上确认。不可含 . / @ 空白，不可为 new',
-        },
-        propose_reason: { type: 'string', description: '改名理由，一句话，展示给用户看' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any, toolCtx: any): Promise<string> {
-        // 改名提议以 HTML 注释形式附在正文末尾，由网关解析后剥离。
-        // 拼接收在 lib/rename-proposal.js（三平台共用）：标记格式是服务端正则的
-        // 镜像，各写一遍的话少个空格就静默失效 —— 邮件照常发出，提议凭空消失。
-        const { body, proposed } = appendRenameProposal(
-          args.body, args.propose_alias, args.propose_reason);
-        const result = await client.post('/mail/send', {
-          to: args.to, subject: args.subject, body,
-          cc: args.cc || '', reply_to: args.reply_to || '',
-          session_alias: args.session_alias || '',
-          attachment_ids: args.attachment_ids || [],
-          from_session_id: toolCtx?.sessionID || '',
-        });
-        noteExplicitSend(toolCtx?.sessionID, args.to, args.reply_to);
-        const budget = typeof result.budget_remaining === 'number'
-          ? ` 本任务剩余 ${result.budget_remaining}/${result.budget_max} 个来回。` : '';
-        // 别名取服务端回的 rename_proposed（它跑过 normalizeAlias），
-        // 回显本地值会让模型记住一个不存在的名字，之后拿它寻址就 404
-        const note = renameProposalNote(result.rename_proposed, args.propose_alias, proposed);
-        return `邮件已发送（ID: ${result.mail_id}）${budget}` + (note ? `\n${note}` : '');
-      },
-    }));
-
-    // read_inbox
-    ctx.tools.register(defineTool({
-      name: 'read_inbox',
-      description: '查阅收件箱中的邮件。收到新邮件通知后应立即调用此工具。每封含 mail_id、发件人、主题、正文与附件清单（带 attachment_id）。',
-      parameters: {
-        status: { type: 'string', description: '过滤条件 unread|all，默认 unread' },
-        limit: { type: 'number', description: '返回数量，默认 5' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        const status = args.status || DEFAULT_INBOX_STATUS;
-        const { mails } = await client.get(
-          `/mail/inbox?status=${status}&limit=${args.limit || DEFAULT_INBOX_LIMIT}`
-        );
-
-        // 渲染与已读策略放 lib/inbox-format.js：它们与平台 SDK 无关，
-        // 各平台插件必须一致（见该文件里每条规则对应的错误行为）。
-        //
-        // 传 AGENT_NAME 才能判定「我是收件人还是抄送方」并给出可投递地址。
-        const listed = renderInbox(mails, 200, AGENT_NAME);
-
-        // 读过就标掉，否则每次拉收件箱都重复捞同一批，
-        // 处理过的和新来的混在一起，模型分不清哪封该回。
-        const ids = idsToMarkRead(args.status, mails);
-        if (ids.length) {
-          // 标记失败不该让 read_inbox 失败：正文已经取到了，
-          // 代价只是下次重复看到，比丢掉这次读取轻。
-          client.post('/mail/read', { mail_ids: ids }).catch((e: any) =>
-            ctx.logger.error(`[dsh-mail-bridge] 标记已读失败: ${e?.message || e}`));
-        }
-        return listed;
-      },
-    }));
-
-    // upload_attachment
-    ctx.tools.register(defineTool({
-      name: 'upload_attachment',
-      description:
-        '上传本地文件作为邮件附件，返回 attachment_id。' +
-        '拿到 id 后必须在 send_mail 的 attachment_ids 里带上，附件才会随邮件发出。' +
-        '未随邮件发出的附件 24 小时后自动清理。',
-      parameters: {
-        file_path: { type: 'string', required: true, description: '要上传的本地文件绝对路径' },
-        filename: { type: 'string', description: '自定义展示文件名，默认取路径的最后一段' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        // 先 stat 再读：目录和不存在的路径都要给出能行动的错误。
-        // 直接 readFile 的话，目录抛的 EISDIR 只会让模型重试同一个路径。
-        let st;
-        try {
-          st = await stat(args.file_path);
-        } catch {
-          return `文件不存在或不可读: ${args.file_path}`;
-        }
-        if (!st.isFile()) return `不是普通文件: ${args.file_path}`;
-
-        const data = await readFile(args.file_path);
-        const filename = args.filename || args.file_path.split('/').pop() || 'file';
-        // **必须发真正的 multipart。**
-        //
-        // 早先这里发的是 `Content-Type: application/octet-stream` 加一个
-        // `X-Filename` 头，而服务端走 `ParseMultipartForm` + `FormFile("file")` ——
-        // 于是 **这个工具从来没成功过一次**，每次都回「解析 multipart 失败」。
-        // 模型甚至把它当成了文件存在性探针（存在→报 multipart 错、
-        // 不存在→ENOENT），那是对症状的准确利用，但不是它应该做的事。
-        //
-        // 不设 Content-Type：交给 FormData 自己带 boundary，手写的一定对不上。
-        const form = new FormData();
-        form.append('file', new Blob([data]), filename);
-        const res = await fetch(`${client.baseURL}/api/v1/attachments`, {
-          method: 'POST',
-          headers: client.authHeaders(),
-          body: form,
-        });
-        const json = await res.json() as any;
-        if (!res.ok) throw new Error(json?.error || `HTTP ${res.status}`);
-        const a = json.attachment;
-        return `已上传 ${a.filename}（${formatSize(a.size_bytes)}）。attachment_id: ${a.attachment_id}\n` +
-          `在 send_mail 的 attachment_ids 里带上这个 id 才会随邮件发出。`;
-      },
-    }));
-
-    // download_attachment
-    ctx.tools.register(defineTool({
-      name: 'download_attachment',
-      description: '下载邮件附件到本地文件。attachment_id 从 read_inbox 的附件清单里取。',
-      parameters: {
-        attachment_id: { type: 'string', required: true, description: '附件 ID' },
-        save_path: { type: 'string', required: true, description: '保存到的本地绝对路径' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        const res = await fetch(`${client.baseURL}/api/v1/attachments/${args.attachment_id}`, {
-          headers: client.authHeaders(),
-        });
-        if (!res.ok) throw new Error(`下载失败: HTTP ${res.status}`);
-        const buf = Buffer.from(await res.arrayBuffer());
-        // 父目录不存在时先建：模型经常写 ./downloads/x.pdf 这类还不存在的路径，
-        // 不建的话 writeFile 抛 ENOENT，而那个错误看起来像「附件不存在」。
-        await mkdir(dirname(args.save_path), { recursive: true });
-        await writeFile(args.save_path, buf);
-        return `已保存到 ${args.save_path}（${formatSize(buf.length)}）`;
-      },
-    }));
-
-    // ─── 寻址发现工具（读 Agent 侧只读端点）───
-    //
-    // 在这一组之前，send_mail 的 to 是个只能靠记忆拼写的自由文本字段，
-    // 而拼错不报错：生产上本插件猜了 `opencode@/home`，投递成功，
-    // 但那不是 opencode 的工作目录，静默变成了新会话的 workspace。
-
-    ctx.tools.register(defineTool({
-      name: 'suggest_address',
-      description:
-        '查询可用的收件人地址，用于精准发信。不带参数给候选收件人名；带 name 给它可用的工作目录；' +
-        'name+path 都带则给该目录下可续谈的会话与现成地址。**发信前应先用它确认地址**，' +
-        '不要凭记忆拼写 —— 拼错不会报错，只会投到别的会话。',
-      parameters: {
-        name: { type: 'string', description: '收件人名；留空则列出所有候选收件人' },
-        path: { type: 'string', description: '工作目录；与 name 同时给出才列会话' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        const name = String(args.name || '').trim();
-        const path = String(args.path || '').trim();
-        const qs = new URLSearchParams();
-        if (name) qs.set('name', name);
-        if (path) qs.set('path', path);
-        const data = await client.get(`/agent/contacts/suggest?${qs.toString()}`);
-        // 按服务端回的 kind 分派而不是按本地参数：省略与传空串在服务端
-        // 是同一个意思，但「哪一段该渲染成什么」只有服务端知道。
-        switch (data?.kind) {
-          case 'name': return renderNameSuggestions(data.suggestions);
-          case 'path': return renderPathSuggestions(data.suggestions, name);
-          default: return renderSessionSuggestions(data, name, path);
-        }
-      },
-    }));
-
-    ctx.tools.register(defineTool({
-      name: 'list_contacts',
-      description:
-        '列出自己参与过的全部会话及各自的可投递地址、未读数、剩余往返预算。' +
-        '用于回答「我还有什么没处理」与「上次跟某人聊的那条线索地址是什么」。',
-      parameters: {
-        limit: { type: 'number', description: '最多列出多少条，默认 20' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        const data = await client.get('/agent/contacts');
-        return renderContacts(data, args.limit || 20);
-      },
-    }));
-
-    ctx.tools.register(defineTool({
-      name: 'session_participants',
-      description:
-        '列出某条会话的全部参与方（发件人/收件人/抄送方）及各自的可投递地址，' +
-        '并标出谁还没回应。**要回给抄收方或向第三方转达时先用它拿地址**。',
-      parameters: {
-        session_id: { type: 'string', required: true, description: '会话 ID' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        const data = await client.get(`/agent/sessions/${args.session_id}/participants`);
-        return renderParticipants(data);
-      },
-    }));
-
-    ctx.tools.register(defineTool({
-      name: 'read_thread',
-      description:
-        '查看一封邮件所在线索的完整往来（谁回了谁、谁还没回）。多方抄送协作时' +
-        '用它确认别人已经说了什么，避免重复提问或重复汇报。',
-      parameters: {
-        mail_id: { type: 'string', required: true, description: '线索中任一封邮件的 ID' },
-        offset: { type: 'number', description: '分页偏移，续取时传上次返回的 next_offset' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        const qs = args.offset ? `?offset=${args.offset}` : '';
-        const data = await client.get(`/agent/mail/${args.mail_id}/thread${qs}`);
-        return renderThread(data, AGENT_NAME);
-      },
-    }));
-
-    ctx.tools.register(defineTool({
-      name: 'read_mail',
-      description:
-        '读一封邮件的完整内容，含收件人、抄送清单、附件与每个参与方的可投递地址。' +
-        '收件箱只给摘要；要回给抄收方就得先看清这封信发给了谁。',
-      parameters: {
-        mail_id: { type: 'string', required: true, description: '邮件 ID' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        const data = await client.get(`/agent/mail/${args.mail_id}`);
-        const m = data?.mail || {};
-        const lines = [
-          `发件人: ${m.from_name || '?'}`,
-          `收件人: ${m.to_name || '?'}${m.to_workspace ? '@' + m.to_workspace : ''}`,
-          `主题: ${m.subject || '(无主题)'}`,
-          `会话: #${data.session_alias || '未命名'}（session_id: ${m.session_id || '?'}）`,
-        ];
-        if (Array.isArray(m.cc_list) && m.cc_list.length) {
-          lines.push(`抄送: ${m.cc_list.map((c: any) => c?.raw || c?.name).join('、')}`);
-        }
-        if (Array.isArray(m.attachments) && m.attachments.length) {
-          lines.push(`附件: ${m.attachments
-            .map((a: any) => `${a.filename}（${formatSize(a.size_bytes)}, id=${a.attachment_id}）`)
-            .join('、')}`);
-        }
-        lines.push('', m.body || '(空正文)', '');
-        if (Array.isArray(data.participants) && data.participants.length) {
-          lines.push('可投递地址: ' + data.participants
-            .filter((p: any) => p.address && p.name !== AGENT_NAME)
-            .map((p: any) => `${p.address}（${p.role}）`)
-            .join('、'));
-        }
-        if (data.reply_address) {
-          lines.push(`回信给发件人用 ${data.reply_address}，或传 reply_to=${m.mail_id}。`);
-        }
-        return lines.join('\n');
-      },
-    }));
-
-    // forward_mail —— 转发给新收件人。
-    //
-    // 之前 DSH 侧缺这个工具（opencode 侧一直有），于是本平台上「把这封信
-    // 转给某人」只能退化成 send_mail 重抄一遍正文 —— 丢掉附件、丢掉
-    // parent_mail_id，对话树上也看不出这条新线索从何而来。
-    ctx.tools.register(defineTool({
-      name: 'forward_mail',
-      description:
-        '转发一封邮件给新的收件人（自动引用原文与附件）。与回复不同：回复落回原会话，' +
-        '转发按目标地址另行定位会话（它是一条新线索）。只能转发自己参与过的邮件。',
-      parameters: {
-        mail_id: { type: 'string', required: true, description: '要转发的邮件 ID' },
-        to: { type: 'string', required: true, description: '新收件人的三维地址（先用 suggest_address 确认）' },
-        comment: { type: 'string', description: '转发说明，置于引用原文之前' },
-        cc: { type: 'string', description: '抄送，逗号分隔多个三维地址' },
-        subject: { type: 'string', description: '自定义主题；留空则自动加 Fwd: 前缀' },
-        session_alias: { type: 'string', description: '仅当目标地址以 .new 结尾时生效：给新会话命名' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any, toolCtx: any): Promise<string> {
-        const result = await client.post(`/mail/${args.mail_id}/forward`, {
-          to: args.to,
-          comment: args.comment || '',
-          cc: args.cc || '',
-          subject: args.subject || '',
-          session_alias: args.session_alias || '',
-        });
-        // 转发也是一次「模型亲手发信」，要计入 explicitSends，
-        // 否则本轮结束时自动转发会再把同一段话发一遍。
-        noteExplicitSend(toolCtx?.sessionID, args.to, '');
-        return `已转发。新 Mail ID: ${result.mail_id}，Session: ${result.session_id}`;
-      },
-    }));
-
-    // connect_to_server —— 连接自愈。
-    //
-    // 之前只有 opencode 侧有这个工具。后果是：Gateway 换了地址、或密钥需要
-    // 重新登记时，opencode 里的模型能自己修好，而 DSH 里的模型只能干等
-    // systemd 环境变量被人改 —— 同一类能力在不同平台上时有时无，
-    // 等于让人记住哪个平台能自己修。
-    //
-    // 失败时**把需要登记的密钥全文打出来**：密钥未登记是最常见的失败，
-    // 不给值的话要多走一轮「密钥无效 → 去哪拿 → 让管理员登记」。
-    ctx.tools.register(defineTool({
-      name: 'connect_to_server',
-      description:
-        '连接到 AgentMail Gateway：登记本机密钥并完成注册。首次安装或换了 Gateway 地址时调用。' +
-        '密钥若未在后台登记过，此处会返回需要登记的密钥全文。',
-      parameters: {
-        gateway_url: { type: 'string', description: 'Gateway 地址，如 https://mail.example.com；省略则用当前配置' },
-        key_token: { type: 'string', description: '管理员签发的 Agent 密钥；省略则用本地密钥（不存在时自动生成）' },
-      },
-      output: {
-        schema: { type: 'string' },
-        render: (_args: any, value: string) => [{ type: 'text', text: value }],
-      },
-      async execute(args: any): Promise<string> {
-        let key = client.agentKey;
-        if (args.key_token) {
-          key = String(args.key_token).trim();
-          // 管理员给的密钥落盘，重启后仍然可用
-          saveLocalKey(key);
-        } else if (!key) {
-          key = generateLocalKey();
-        }
-
-        const url = String(args.gateway_url || client.baseURL).replace(/\/+$/, '');
-
-        const res = await fetch(`${url}/api/v1/agent/register`, {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
-          body: JSON.stringify({ name: AGENT_NAME, workspaces: [], platform: 'dsh' }),
-        });
-        const data = await res.json().catch(() => ({})) as any;
-
-        if (!res.ok) {
-          return [
-            `连接失败（HTTP ${res.status}）：${data?.error || '未知错误'}`,
-            ``,
-            `若提示密钥无效，请让管理员在 AgentMail 后台「Agent 密钥」中登记：`,
-            key,
-            ``,
-            `密钥文件：${KEY_FILE}`,
-          ].join('\n');
-        }
-
-        // 成功后把新坐标写回客户端，当场生效（不用等重启）
-        client.baseURL = url;
-        client.agentKey = key;
-        return `已连接 ${url}，注册为 ${data?.agent_name || AGENT_NAME}。`;
-      },
-    }));
-
-    return () => {
-      for (const n of [
-        'send_mail', 'read_inbox', 'read_mail', 'forward_mail',
-        'upload_attachment', 'download_attachment',
-        'suggest_address', 'list_contacts', 'session_participants', 'read_thread',
-        'connect_to_server',
-      ]) {
-        try {
-          ctx.tools.unregister(n);
-        } catch {
-          // 拆插件时重复注销（已经卸载 / 未注册过）不影响 teardown，忽略即可
-        }
-      }
-    };
-  }, 'dsh-mail-bridge.tools');
-
-  // ─── turn 完成后自动转发回复 ───
-  //
-  // 与 opencode-mail-bridge 的 session.idle 同一职责：模型把话说完了，
-  // 插件把它最后那段话搬到邮件里 —— 不该让模型自己记得调 send_mail。
-  ctx.on('agent/status', async (payload: any) => {
-    if (payload?.status !== 'idle') return;
-    const agent = payload.agent;
-    if (!agent?.id) return;
-    const mailSessionID = reverseMap.get(String(agent.id));
-    if (!mailSessionID) return;
-    const mctx = mailContexts.get(mailSessionID);
-
-    // **只给人类来信自动转发**（见 lib/relay-policy.js）。
-    //
-    // 对方是 Agent 时它那边的插件也会自动回一封，于是两个模型都以为「我只要
-    // 把话说完就行」，实际在持续互相唤醒 —— 生产实测 pi 与 dsh 客套 6 轮直到
-    // 撞上连续 relay 跳数上限。日志走 console.error：ctx.logger 不进 journalctl，
-    // 而「本轮为何没有回信」必须能查到。
-    const policy = autoRelayDecision({
-      fromHuman: mctx?.fromHuman === true,
-      replyTo: mctx?.replyTo,
-    });
-    if (!policy.relay) {
-      console.error(`[dsh-mail-bridge] 本轮不自动转发：${policy.reason}`);
-      return;
-    }
-    // policy.relay 为真已经蕴含 mctx?.replyTo 非空（autoRelayDecision 的第一道判定），
-    // 但 TS 推不出那层关系 —— 显式窄一下，而不是给后面每处加非空断言。
-    if (!mctx) return;
-
-    // 取最后一条 assistant 消息的文本
-    const events = agent.session?.events ?? [];
-    const lastText = lastAssistantText(events);
-    if (!lastText) {
-      // 模型 idle 但没有任何 assistant 文本：空回复/被中断在文本前。
-      // 此前静默返回 —— 发件人等不到任何回复（缺的是 B-6 的「模型全部失败」
-      // 同款兜底，只是这次没有失败可报却也没有产出）。给发件人一封失败通知。
-      // 只给人类来信发：Agent 之间不自动转发（与上面同一判据）。
-      try {
-        await client.post('/mail/send', {
-          to: mctx.replyTo,
-          subject: `处理失败: ${mctx.subject || '(无主题)'}`,
-          body: [
-            `这封邮件（主题：${mctx.subject || '(无主题)'}）的处理轮次已结束，但没有产出任何回复文本。`,
-            '',
-            '可能原因：模型空响应、输出被中断、或工具调用异常耗尽轮次。',
-            '请检查后重试。',
-          ].join('\n'),
-          reply_to: mctx.mailID || '',
-          relay: 'summary',
-          relay_key: clampRelayKey(`empty-reply:${mailSessionID}`),
-        });
-        console.error(`[dsh-mail-bridge] 已发空回复失败通知给 ${mctx.replyTo}`);
-      } catch (e: any) {
-        console.error(`[dsh-mail-bridge] 空回复失败通知也发不出去: ${e?.message || e}`);
-      }
-      return;
-    }
-
-    // 本轮模型已亲手回过这条线索 → 不再自动转发（与 opencode 侧同一取舍）
-    if (shouldSkipAutoRelay(explicitSends.get(String(agent.id)), mctx.replyTo, mctx.mailID)) {
-      explicitSends.delete(String(agent.id));
-      return;
-    }
-    // 同一条消息只转一次
-    if (relayedSummaries.get(String(agent.id)) === lastText) return;
-
-    try {
-      await client.post('/mail/send', {
-        to: mctx.replyTo,
-        subject: replySubject(mctx.subject),
-        body: lastText,
-        reply_to: mctx.mailID || '',
-        // relay + relay_key：走免配额通道（harness 的搬运不该收费）
-        relay: 'summary',
-        relay_key: clampRelayKey(`${agent.id}:${events.length}`),
-      });
-      relayedSummaries.set(String(agent.id), lastText);
-      explicitSends.delete(String(agent.id));
-      ctx.logger.info(`[dsh-mail-bridge] 总结已回信 ${mctx.replyTo}（不计配额）`);
-    } catch (e: any) {
-      ctx.logger.error(`[dsh-mail-bridge] 转发回复失败: ${e?.message || e}`);
-    }
-
-    // 会话命名回写：DSH 首轮结束后由模型生成摘要标题，把它同步回 AgentMail。
-    // 与 opencode 侧同一决定：不另造一套命名，平台叫什么这边就叫什么。
-    //
-    // DSH 没有 opencode 那样的 slug，别名由标题派生（slugFromTitle 会去掉
-    // `.` `@` `/` 这些寻址分隔符 —— 留在别名里会让它自己被解析器切开）。
-    // 别名与标题一起发：服务端撞名时自动追 -2/-3 后缀，并尊重人工改过的别名。
-    const title = modelTitle(events);
-    if (title && syncedTitles.get(String(agent.id)) !== title) {
-      syncedTitles.set(String(agent.id), title);
-      const alias = slugFromTitle(title);
-      try {
-        await client.post(`/sessions/${mailSessionID}/sync`,
-          alias ? { title, alias } : { title });
-        ctx.logger.info(
-          `[dsh-mail-bridge] 会话命名已同步: title=${title}${alias ? ` alias=${alias}` : ''}`);
-      } catch (e: any) {
-        ctx.logger.error(`[dsh-mail-bridge] 命名同步失败: ${e?.message || e}`);
-      }
-    }
-  });
-
-  // ─── 平台原生权限询问 → 转成邮件问人 ───
-  //
-  // 这是 harness 的职责，不该让模型自己调一个 request_permission 工具：
-  // 模型可能忘了调，也可能在不需要时乱调，而真正被 DSH 拦下的那次询问反而没人看见。
-  //
-  // 与 opencode 的差异：opencode 的 permission.ask 是同步钩子，卡在里面会把整个
-  // 请求挂住，所以那边只能“转出去就返回 ask”；而 DSH 的 approval/request 是
-  // **异步 waterfall**，返回 Promise<ApprovalOutcome> 就是它要的，因此可以真的等人。
-  ctx.on('approval/request', async (req: any, next: () => Promise<string>) => {
-    const agentId = String(req?.agent?.id ?? '');
-    if (!mailDrivenSessions.has(agentId)) return next(); // 非邮件驱动的会话不接管
-    const mailSessionID = reverseMap.get(agentId);
-    if (!mailSessionID) return next();
-
-    // DSH 不给询问发 id，用 (会话, 工具, callId) 做幂等键。
-    // clampRelayKey 收尾：callId 的长度由上游模型决定，pi 侧实测过带思考签名的
-    // 13601 字节 id，超服务端 160 字节列宽直接 400。
-    const relayKey = clampRelayKey(`${agentId}:${req.toolName}:${req.callId ?? 'nocall'}`);
-    const mctx = mailContexts.get(mailSessionID);
-
-    try {
-      // **不传 `to`**：决策人由服务端定（会话 owner → 线索里最近的人类 →
-      // 无人可问则 409）。插件若把来信人当决策人，Agent 之间转派任务时
-      // （A 把活分给 B）权限邮件会发给 Agent 自己 —— Agent 不可能在界面上点
-      // 「同意」，于是下面那个 await 永不 resolve，会话无声挂死。
-      await client.post('/permission/request', {
-        question: `请求执行 ${req.toolName}`,
-        options: ['同意', '拒绝'],
-        context: [
-          `工具：${req.toolName}`,
-          req.callId ? `调用 ID：${req.callId}` : '',
-          req.reason ? `理由：${req.reason}` : '',
-          // 决策人未必是这条会话的参与者（Agent 转派出来的会话，人从没见过它），
-          // 只给工具名无从判断，得说明这活是谁派的、为的什么事（B-8.4）。
-          mctx?.subject ? `触发任务：${mctx.subject}` : '',
-          mctx?.replyTo ? `任务来自：${mctx.replyTo}` : '',
-        ].filter(Boolean).join('\n'),
-        session_id: mailSessionID,
-        relay_key: relayKey,
-      });
-    } catch (e: any) {
-      // 409 = 服务端已判定这条任务链上没有人类，永远不会有人来点头。
-      //
-      // 不能 `return next()`：下一个 answerer 是本地 UI，而邮件驱动的会话
-      // 根本没有 UI，waterfall 跑到尾以后依旧无人应答 —— 这正是生产事故
-      // 的形状：pi 把任务派给自己的另一条会话，那条要跑 bash，会话永久挂死。
-      //
-      // 直接 denied 并把服务端的建议原文写进日志：模型从工具报错里看到
-      // 拒绝后会自己换方式，而挂死时它连重试的机会都没有。
-      if (e?.status === 409) {
-        const hint = [e?.body?.error, e?.body?.detail, e?.body?.suggestion]
-          .filter(Boolean).join(' ');
-        console.error(`[dsh-mail-bridge] 权限询问无人可投，当场拒绝 ${relayKey}：${hint}`);
-        // 把真正的原因存起来，post-execute 会用它换掉 dsh-tools 写死的
-        // 「the user rejected tool X」—— 没有任何用户拒绝过它。
-        noteDenial(agentId, req.callId, [
-          e?.body?.error || `权限询问无法送达：这条任务链上没有人类用户`,
-          e?.body?.detail || '',
-          e?.body?.suggestion || '',
-        ].filter(Boolean).join('\n'));
-        // 用 'rejected' 而不是 'denied'：DSH 的 ApprovalOutcome 只认
-        // allowed-once / rejected / cancelled / unavailable，写错了它不报错
-        // 而是归一化成 'unavailable'。
-        return 'rejected';
-      }
-
-      // 其余 4xx（400 / 401 / 403 / 404 / 422…）同样永远不会因重试成功，
-      // 不能 `return next()` —— 下一个 answerer 是本地 UI，而邮件驱动的会话
-      // 没有 UI，waterfall 跑到尾仍旧无人应答。
-      // pi 侧实测：relay_key 过长报 400 被当暂时失败让位，
-      // 那条 bash 在无人批准的情况下执行了 —— fail closed 才安全。
-      if (isPermanentFailure(e)) {
-        const hint = [e?.body?.error, e?.body?.detail, e?.body?.suggestion]
-          .filter(Boolean).join(' ');
-        console.error(
-          `[dsh-mail-bridge] 权限询问遇到永久失败（HTTP ${e?.status}），当场拒绝 ${relayKey}：${hint || e?.message || ''}`,
-        );
-        noteDenial(agentId, req.callId, [
-          `无法把 ${req.toolName} 的授权请求送达给人类（HTTP ${e?.status}）：${e?.body?.error || e?.message || '请求被服务端拒绝'}`,
-          e?.body?.detail || '',
-          e?.body?.suggestion || '这是一个不会因重试而改变的失败。请改用不需要授权的方式完成，或在回信里说明需要人工执行哪一步。',
-        ].filter(Boolean).join('\n'));
-        return 'rejected';
-      }
-
-      // 暂时失败（5xx / 408 / 429 / 网络抖动）交给下一个 answerer（本地 UI）。
-      console.error(`[dsh-mail-bridge] 权限询问转发暂时失败: ${e?.message || e}`);
-      return next();
-    }
-
-    console.error(`[dsh-mail-bridge] 权限询问已转邮件 ${relayKey}`);
-
-    // 等人类决策；DSH 撤销询问（signal abort）时结算为 cancelled。
-    return new Promise<string>((resolve) => {
-      pendingApprovals.set(relayKey, { resolve, sessionId: agentId });
-      req.signal?.addEventListener('abort', () => {
-        if (pendingApprovals.delete(relayKey)) resolve('cancelled');
-      }, { once: true });
-    });
-  });
-
-  // ─── 模型主动提问（ask_user_question）→ 转成邮件问人 ───
-  //
-  // 这是**第二个**人机交互 seam，与上面的 approval/request 完全独立：
-  //   - approval/request：危险工具被 DSH 拦下，人批准/拒绝**执行**
-  //   - ask_user_question：模型自己需要确认/选择/补充信息，人**回答问题**
-  //
-  // 原来只桥接了前者。邮件驱动的会话没有本地 UI，而 ask() 的 provider 是
-  // DSH host 注册的本地 UI 实现 —— 在那里等人点选，人永远看不到，
-  // promise 永不 resolve，那一轮工具调用**永久挂死**。
-  //
-  // 为什么拦 `tools/execute` 而不抢注全局 provider：
-  // `ctx.userQuestions.registerProvider` 只允许一个活动 provider（第二个抛
-  // DUPLICATE_PROVIDER），而 DSH host 已经注册了本地 UI 那个；抢注会让平台
-  // 自己的界面失效。around-dispatch 只对**邮件驱动**的会话接管，其余原样交给
-  // 下一个 wrapper / 平台 UI。
-  ctx.on('tools/execute', async (exec: any, next: () => Promise<any>) => {
-    if (exec?.name !== 'ask_user_question') return next();
-    const agentId = String(exec?.agent?.id ?? '');
-    if (!agentId || !mailDrivenSessions.has(agentId)) return next();
-    const mailSessionID = reverseMap.get(agentId);
-    if (!mailSessionID) return next();
-
-    const rawQuestions: any[] = Array.isArray(exec?.arguments?.questions)
-      ? exec.arguments.questions
-      : [];
-    const relayKey = clampRelayKey(`${agentId}:ask:${exec?.callId ?? 'nocall'}`);
-
-    let flat: { question: string; options: string[]; context: string; multiSelect: boolean };
-    try {
-      flat = flattenQuestions(rawQuestions);
-    } catch (e: any) {
-      // 问题本身不合法（空列表）→ 当场把错误交回模型，不要挂死
-      throw new Error(`ask_user_question 参数不合法：${e?.message || e}`);
-    }
-
-    const mctx = mailContexts.get(mailSessionID);
-    try {
-      await client.post('/permission/request', {
-        question: flat.question,
-        options: flat.options,
-        context: [
-          flat.context,
-          mctx?.subject ? `触发任务：${mctx.subject}` : '',
-          mctx?.replyTo ? `任务来自：${mctx.replyTo}` : '',
-        ].filter(Boolean).join('\n'),
-        session_id: mailSessionID,
-        relay_key: relayKey,
-        kind: 'question',
-        multi_select: flat.multiSelect,
-      });
-    } catch (e: any) {
-      // 与 approval 同一条纪律：不会因重试成功的失败必须**当场报错**，
-      // 不能 `return next()` —— 下一个 answerer 是本地 UI，而邮件驱动的会话
-      // 根本没有 UI，waterfall 跑到尾依旧无人应答 = 挂死。
-      const hint = [e?.body?.error, e?.body?.detail, e?.body?.suggestion]
-        .filter(Boolean).join(' ');
-      console.error(`[dsh-mail-bridge] 主动提问转发失败（HTTP ${e?.status ?? '?'}）：${hint || e?.message || e}`);
-      throw new Error(
-        `无法把问题送达给人类（HTTP ${e?.status ?? '?'}）${hint ? `：${hint}` : ''}。`
-        + `请改用不需要人工确认的方式继续，或在最终回复里说明需要人回答什么。`);
-    }
-
-    console.error(`[dsh-mail-bridge] 主动提问已转邮件 ${relayKey}（kind=question）`);
-
-    // 等人类回答；DSH 撤销（signal abort）时以错误结算，不装作答过了。
-    const answers = await new Promise<any>((resolve, reject) => {
-      pendingQuestions.set(relayKey, {
-        resolve, reject, questions: rawQuestions, sessionId: agentId,
-      });
-      exec.signal?.addEventListener('abort', () => {
-        if (pendingQuestions.delete(relayKey)) {
-          reject(new Error('ask_user_question 被取消（人类尚未回答）'));
-        }
-      }, { once: true });
-    });
-
-    // around-wrapper 返回的 canonical value 就是工具的输出（见 dsh-tools
-    // normalizeDispatchResult：非错误结果取 .value 交给 output.schema 校验）。
-    return { isError: false, value: answers } as any;
-  });
-
-  // 把插件主动拒绝的真正原因递给模型。
-  //
-  // DSH 将 approval/request 的 'rejected' 翻译成写死的
-  // `the user rejected tool "X"`（dsh-tools/lib/index.js）—— 而当插件因为
-  // 「没人可问」或「转发遇 4xx」主动拒绝时，**没有任何用户拒绝过它**。
-  // 模型看到一句不存在的拒绝，只会以为人不同意，不会去换一条路；
-  // 服务端给的 suggestion（换不需要权限的方式 / 在回信里请上游转达）则只进了日志。
-  //
-  // 门禁拒绝的调用也会进 post-execute（pre-execute 的 deny 走
-  // `{kind:"post-result"}` → finalizeScheduledExecution → postExecute），
-  // 而 `{kind:'block', feedback}` 能换掉模型看到的内容 —— 这是 DSH 上
-  // 唯一能把真实原因送到模型眼前的口子。
-  //
-  // pi（`{block:true, reason}`）与 opencode（`output.reason`）的 reason 直达模型，
-  // 不需要这道绕行。
-  ctx.on('tools/post-execute', async (exec: any, result: any, next: () => Promise<any>) => {
-    const agentId = String(exec?.agent?.id ?? '');
-    if (!agentId || !mailDrivenSessions.has(agentId)) return next();
-    // 只管失败的结果：成功的调用不可能是被我们拒绝的那一次。
-    if (!result?.isError) return next();
-
-    const reason = takeDenial(agentId, exec?.callId);
-    if (!reason) return next();
-
-    console.error(`[dsh-mail-bridge] 已把拒绝原因递给模型（${exec?.name}）`);
-    return {
-      kind: 'block',
-      feedback: [{
-        type: 'text',
-        text: `无法执行 ${exec?.name}：${reason}`,
-      }],
-    };
-  });
-
-  /** 人类决策回来：先看是不是在等的那个问题/approval，否则当普通通知投给会话。 */
-  function handlePermissionDecision(data: any): void {
-    const relayKey = String(data?.relay_key ?? '');
-
-    // 主动提问的回答与权限审批的结构不同（answers[] vs ApprovalOutcome），
-    // 必须分开结算。用 relay_key 查而不是信 data.kind：键本身已经唯一。
-    const pendingQ = relayKey ? pendingQuestions.get(relayKey) : undefined;
-    if (pendingQ) {
-      pendingQuestions.delete(relayKey);
-      const decision = String(data?.decision ?? '');
-      const note = data?.note;
-      if (isBlankAnswer(pendingQ.questions, decision, note)) {
-        // 空回答不能当作「答了」：模型会拿到一个什么都没说的结果继续跑。
-        pendingQ.reject(new Error('人类提交了空回答；请重新提问或改用不需要回答的方式继续。'));
-        console.error(`[dsh-mail-bridge] 主动提问 ${relayKey} 收到空回答，已拒绝`);
-        return;
-      }
-      try {
-        pendingQ.resolve(answersFromDecision(pendingQ.questions, decision, note));
-        console.error(`[dsh-mail-bridge] 主动提问 ${relayKey} 已回答`);
-      } catch (e: any) {
-        pendingQ.reject(new Error(`回答解析失败：${e?.message || e}`));
-      }
-      return;
-    }
-
-    const pending = relayKey ? pendingApprovals.get(relayKey) : undefined;
-    if (pending) {
-      pendingApprovals.delete(relayKey);
-      // AgentMail 的选项文本 → DSH 的 ApprovalOutcome。
-      // 只有“同意”才放行，其余（包括认不出的选项）一律 fail closed。
-      //
-      // **DSH 不提供「一直同意」**：它的 ApprovalOutcome 只有
-      // allowed-once / rejected / cancelled / unavailable，没有 always 语义
-      // （见 @deepseek-ai/dsh-user-approval 的类型定义）。桥自己记免批的话，
-      // DSH 侧仍会每次调 approval/request，而桥直接答 allowed-once ——
-      // 那等于用插件内存覆盖平台的审批策略，且这份策略没人能审计。
-      // 因此这里的选项只有两个（见上面的 options），isApproval 就够用。
-      const decision = String(data?.decision ?? '');
-      const outcome = isApproval(decision) ? 'allowed-once' : 'rejected';
-      pending.resolve(outcome);
-      ctx.logger.info(`[dsh-mail-bridge] 权限决策 ${relayKey} -> ${outcome}`);
-      return;
-    }
-    // 没在等（插件重启后丢了 pendingApprovals，或历史数据）→ 当一封通知投进会话。
-    deliverMail(data, 'permission')
-      .catch((e: any) => ctx.logger.error(`[dsh-mail-bridge] 权限决策投递失败: ${e?.message || e}`));
-  }
-
-  // ─── 启动 SSE（与 opencode-mail-bridge 相同的事件处理）───
-
-  ctx.effect(() => {
-    startSSE((type, data) => {
-      switch (type) {
-        case 'new_mail':
-          if (data?.mail_id) deliveredMails.add(data.mail_id);
-          deliverMail(data, 'mail')
-            .then(({ sessionID, reused }) => {
-              console.error(`[dsh-mail-bridge] ${type} -> ${reused ? '续谈' : '新会话'} ${sessionID}`);
-            })
-            .catch((e: any) => {
-              // console.error 而不是 ctx.logger：DSH 的 logger 不进 journalctl，
-              // 而投递失败是「发件人等不到回信」的唯一线索。
-              console.error(`[dsh-mail-bridge] ${type} 处理失败（mail ${data?.mail_id || '?'}）: ${e?.message || e}`);
-            });
-          break;
-        case 'permission_decision':
-          handlePermissionDecision(data);
-          break;
-        case 'session_update': {
-          // 人类在 WebUI 切换权限档位后，DSH 运行时必须立刻更新 sandbox/mode +
-          // approval/policy，否则模型仍按旧档位执行。
-          const sid = String(data?.session_id || '');
-          const pm = String(data?.permission_mode || '');
-          if (!sid || !pm) break;
-          const found = findLiveDshSession(sid);
-          if (!found) {
-            // 会话不在运行（插件重启后尚未收到新邮件、或从未投过）。
-            // 无需处理：下次投递时 deliverMail 会按邮件里带的 permission_mode
-            // 重新 applyPermissionMode，档位不会丢。
-            break;
-          }
-          applyPermissionMode(found.agent?.session, pm);
-          console.error(`[dsh-mail-bridge] session_update ${sid} -> 权限档位 ${pm}（会话 ${found.id}）`);
-          break;
-        }
-        case 'session_archived':
-          // 会话归档 = 那条会话再也不会收信，映射可以确定性地清掉（不必等上限淘汰）。
-          forgetSession(String(data?.session_id || ''));
-          break;
-      }
-    });
-    return () => {
-      sseClient?.stop?.();
-      sseClient = null;
-      // 拆插件时没人再能回答待决询问，一律 fail closed，
-      // 否则 DSH 侧那些 await 永远不会返回。
-      for (const [key, pending] of pendingApprovals) {
-        pending.resolve('unavailable');
-        pendingApprovals.delete(key);
-      }
-      // 主动提问没有「unavailable」这种返回值，只能以错误结算。
-      for (const [key, pending] of pendingQuestions) {
-        pending.reject(new Error('邮件桥已卸载，无法再接收回答'));
-        pendingQuestions.delete(key);
-      }
-    };
-  }, 'dsh-mail-bridge.sse');
+	const GW = config.gateway.url || "http://127.0.0.1:8180";
+	const AGENT_NAME = config.gateway.agentName || "dsh";
+	let AGENT_KEY = config.gateway.agentKey || "";
+	const AGENT_SECRET = config.gateway.agentSecret || "";
+	const REPLY_PROVIDER = config.reply.provider || "";
+	const REPLY_MODEL = config.reply.model || "AUTO";
+
+	if (!AGENT_KEY && !AGENT_SECRET) {
+		AGENT_KEY = readLocalKey() || generateLocalKey();
+	}
+
+	const client = new GatewayClient(GW, AGENT_NAME, AGENT_KEY, AGENT_SECRET);
+
+	// 注册 Agent
+	(async () => {
+		try {
+			await client.register();
+			ctx.logger.info(`[dsh-mail-bridge] 已接入 ${GW}，身份 ${AGENT_NAME}`);
+		} catch (e: any) {
+			ctx.logger.error(`[dsh-mail-bridge] 注册失败: ${e?.message || e}`);
+		}
+	})();
+
+	// ─── 心跳 + 平台会话上报 ───
+	//
+	// 心跳两个职责：
+	//   1. 保活 —— Gateway 靠 last_seen 判在线，不发心跳就会被当成离线（之前真的没发）
+	//   2. 上报平台侧会话快照 —— 写信时想续谈某条会话，得先知道那个工作区下
+	//      有哪些会话可续；Gateway 只看得见邮件驱动的那部分。
+	//
+	// 上报而不是让 Gateway 反向拉取：当前架构是单向的（Agent 持密钥主动连
+	// Gateway，Gateway 从不外呼），反向拉取需要它保存各平台的地址与凭证。
+
+	/**
+	 * 收集本机 DSH 的会话快照。
+	 *
+	 * 优先用 ctx.sessionQuery（包含已落盘的历史会话），它不可用时退到
+	 * ctx.agents.list()（只有当前活着的）。base bundle 里 session-query-sqlite 的
+	 * openAt 是 'never'，但 listSessions/readTitle 这些精确读不依赖 SQLite
+	 * —— 只有全文搜索会报 SESSION_QUERY_SEARCH_DISABLED。
+	 *
+	 * 返回 undefined 表示「本次拿不到列表」，调用方应当省略字段而不是传空数组：
+	 * 空数组的语义是「平台侧确实一条会话都没有」，会把服务端的镜像抹掉。
+	 */
+	async function collectSessions(): Promise<any[] | undefined> {
+		const q = ctx.get("sessionQuery");
+		if (q?.listSessions) {
+			try {
+				const records = await q.listSessions();
+				const ids = records
+					.map((r: any) => r?.header?.id)
+					.filter((id: any): id is string => typeof id === "string");
+				// 标题在日志里，需要单独 fold。批量读而不是逐个读：
+				// readTitleSnapshots 共用一次 corpus 观测，而逐个 readTitle 会重复加载日志。
+				const titles = new Map<string, string>();
+				if (q.readTitleSnapshots && ids.length > 0) {
+					const results = await q.readTitleSnapshots(ids);
+					results.forEach((res: any, i: number) => {
+						// 单个会话读失败不该拘到其他会话（接口本身就是逐条隔离的）
+						if (res?.status === "rejected") return;
+						const title = res?.value?.title?.title ?? res?.title?.title;
+						if (typeof title === "string" && title) titles.set(ids[i], title);
+					});
+				}
+				return records.map((r: any) => ({
+					id: r?.header?.id,
+					cwd: r?.header?.cwd ?? "",
+					title: titles.get(r?.header?.id) ?? "",
+					updatedAt: r?.header?.createdAt,
+					// subagent 子会话要被过滤掉，判据在 header 上
+					origin: r?.header?.origin,
+					delegationDepth: r?.header?.delegationDepth,
+				}));
+			} catch (e: any) {
+				ctx.logger.warn(
+					`[dsh-mail-bridge] sessionQuery 不可用，退到活会话列表: ${e?.message || e}`,
+				);
+			}
+		}
+
+		// 退路：只报当前活着的 agent。比什么都不报强 ——
+		// 它们恰好是正在进行的任务，也是最可能被续谈的那批。
+		try {
+			const live = ctx.agents?.list?.() ?? [];
+			return live.map((a: any) => ({
+				id: String(a?.id ?? ""),
+				cwd: a?.session?.header?.cwd ?? "",
+				title: modelTitle(a?.session?.events ?? []),
+				updatedAt: a?.session?.header?.createdAt,
+				origin: a?.session?.header?.origin,
+				delegationDepth: a?.session?.header?.delegationDepth,
+			}));
+		} catch {
+			return undefined;
+		}
+	}
+
+	// 已经投过的 mail_id。心跳与 SSE 建连之间有个窗口：那期间到的邮件
+	// 既在 pending_mails 里、也会被 SSE 推一次 —— 不去重就会投两遍。
+	//
+	// 有界：插件跟着 dsh 长期活着，这里会攒下每一封处理过的邮件 id 而永远没有
+	// 出口。淘汰是安全的 —— 它防的两种重复都发生在秒到分钟级。
+	const deliveredMails = new BoundedSet<string>(MAX_TRACKED_MAILS);
+	let caughtUp = false;
+
+	/**
+	 * 补投离线期间积压的未读邮件。
+	 *
+	 * SSE 只推连上之后的事件，插件重启前发来的邮件不会再推一次。
+	 * 不补的话那封邮件永远躺在收件箱里，而发件人以为 Agent 收到了。
+	 */
+	async function catchUp(pending: unknown): Promise<void> {
+		if (!pending) return;
+		try {
+			const box = await client.get("/mail/inbox?status=unread&limit=20");
+			const tasks = selectCatchup(box?.mails ?? box, deliveredMails);
+			if (tasks.length === 0) return;
+			console.error(
+				`[dsh-mail-bridge] 补投 ${tasks.length} 封离线期间的邮件（共 ${pending} 封未读）`,
+			);
+			// 串行：每封都要起一轮模型，并发放出去等于对上游打 N 个并发请求
+			for (const ev of tasks) {
+				// 逐封再查一次：拉收件箱和逐封投递之间 SSE 可能已经投过其中某封
+				if (deliveredMails.has(ev.mail_id)) continue;
+				deliveredMails.add(ev.mail_id);
+				try {
+					await deliverMail(ev, "mail");
+				} catch (e: any) {
+					console.error(
+						`[dsh-mail-bridge] 补投 ${ev.mail_id} 失败: ${e?.message || e}`,
+					);
+				}
+			}
+		} catch (e: any) {
+			console.error(`[dsh-mail-bridge] 补投失败: ${e?.message || e}`);
+		}
+	}
+
+	async function beat(): Promise<void> {
+		const body: Record<string, unknown> = {};
+		// DSH 有真沙箱（read-only / workspace-write / danger-full-access），
+		// 档位在这里是被强制执行的，不是 advisory。
+		body.mode_enforcement = "native";
+		const [entries, models] = await Promise.all([
+			collectSessions(),
+			collectModels(),
+		]);
+		if (entries) {
+			body.platform_sessions = snapshotDshSessions(entries, (id) =>
+				mailDrivenSessions.has(id),
+			);
+		}
+		if (models) body.models = models;
+		try {
+			const res = await client.post("/agent/heartbeat", body);
+			// 生效的模型范围随心跳响应回传：管理员在配置页改了范围后，
+			// 插件最多一个周期（30 秒）就能看到新值，不需要重启。
+			if (Array.isArray(res?.allowed_models))
+				allowedModels = res.allowed_models;
+			// 只在首个成功的心跳后补投一次：之后的积压都由 SSE 覆盖，
+			// 每轮心跳都补的话会把「模型正在处理中、尚未标已读」的邮件重复投递。
+			if (!caughtUp) {
+				caughtUp = true;
+				await catchUp(res?.pending_mails);
+			}
+		} catch {
+			// 心跳失败不报错：网络抖动很常见，下一轮会补上。
+			// 真的持续连不上时 Gateway 会把它判成离线，那才是可见的信号。
+		}
+	}
+
+	ctx.effect(() => {
+		void beat();
+		const timer = setInterval(() => {
+			void beat();
+		}, 30_000);
+		return () => clearInterval(timer);
+	}, "dsh-mail-bridge.heartbeat");
+
+	// ─── 获取默认模型 ───
+
+	/**
+	 * 这一轮按什么顺序尝试模型。
+	 *
+	 * 优先级：管理员划定的范围 > 环境变量指定 > 平台自己的默认选择。
+	 * 范围是运行时可改的策略，环境变量是部署时的兜底，因此前者优先。
+	 */
+	function attemptOrder(): ({ provider: string; model: string } | undefined)[] {
+		const envDefault =
+			REPLY_PROVIDER && REPLY_MODEL
+				? { provider: REPLY_PROVIDER, model: REPLY_MODEL }
+				: ctx.get("agentDefaultModel")?.currentSelection?.();
+		return modelAttemptOrder(allowedModels, envDefault);
+	}
+
+	/** 收集本机 DSH 看得见的模型目录，供配置页勾选。 */
+	async function collectModels(): Promise<any[] | undefined> {
+		const llm = ctx.get("llm");
+		if (!llm?.listProviders || !llm?.listModels) return undefined;
+		try {
+			const flat: any[] = [];
+			for (const p of llm.listProviders()) {
+				const id = p?.provider ?? p?.id;
+				if (typeof id !== "string" || !id) continue;
+				try {
+					const models = await llm.listModels(id);
+					for (const m of models) flat.push(m);
+				} catch {
+					// 单个 provider 拉不到不该拖掉其他 provider ——
+					// 上游故障通常只影响一家
+				}
+			}
+			return snapshotDshModels(flat);
+		} catch {
+			// 拉不到就省略该字段，而不是上报空数组把配置页清成空白
+			return undefined;
+		}
+	}
+
+	/**
+	 * 等这个会话的首轮真正跑起来，或者失败。
+	 *
+	 * **`ctx.agents.create()` 不会因为模型无效而失败** —— 它只是记下 agentOptions。
+	 * 真正的失败发生在之后的 turn 里，异步抛出：
+	 *
+	 *     request/context {provider: "nonexistent", model: "x"}
+	 *     turn/end {reason: {kind: "error", error: {code: "NO_ADAPTER", ...}}}
+	 *
+	 * 因此降级尝试不能只包一个 try/catch —— 那样第二个模型永远不会被试到。
+	 * 这里用 `session/event` 观察 turn 的走向。
+	 *
+	 * **`assistant/chunk` 本身不是成功信号**：它的 `finish` 子类型也带错误 ——
+	 *
+	 *     {chunk: {type: 'finish', reason: {kind: 'error', failure: {code: 'NO_ADAPTER'}}}}
+	 *
+	 * 见过一次「无效 provider 却判成功」正是因为把任意 chunk 当成了走通。
+	 * 判据要落在 chunk 的类型上：`finish` 看 reason，其余（`block-start`、
+	 * `text-delta`、`tool-call-delta`…）才意味着模型真的在产出。
+	 *
+	 * 超时按「成功」处理：模型可能只是很慢（首 token 前要装载上下文），
+	 * 把慢当成失败会在换模型的同时把已经在跑的那一轮丢掉。
+	 *
+	 * @param agent 刚建好的 agent
+	 * @param timeoutMs 判定窗口
+	 */
+	function awaitFirstTurn(
+		agent: any,
+		timeoutMs = 60_000,
+	): Promise<{ ok: true } | { ok: false; error: string }> {
+		return new Promise((resolve) => {
+			let done = false;
+			const finish = (r: { ok: true } | { ok: false; error: string }) => {
+				if (done) return;
+				done = true;
+				clearTimeout(timer);
+				dispose?.();
+				resolve(r);
+			};
+			const timer = setTimeout(() => finish({ ok: true }), timeoutMs);
+			/** 把 DSH 的错误对象拼成一行可读文本。 */
+			const describe = (err: any): string =>
+				[err?.code, err?.message].filter(Boolean).join(": ") || "未知错误";
+
+			const dispose = ctx.on("session/event", (session: any, event: any) => {
+				if (session !== agent.session) return;
+
+				if (event?.type === "assistant/chunk") {
+					const chunk = event.data?.chunk;
+					if (chunk?.type === "finish") {
+						if (chunk.reason?.kind === "error") {
+							return finish({
+								ok: false,
+								error: describe(chunk.reason.failure),
+							});
+						}
+						return; // finish 收尾，等 turn/end
+					}
+					// assistant/chunk 模型在产出内容 → 模型确实活着，算 OK
+					return finish({ ok: true });
+				}
+
+				if (event?.type === "turn/end") {
+					const reason = event.data?.reason;
+					if (reason?.kind === "error") {
+						return finish({ ok: false, error: describe(reason.error) });
+					}
+					return finish({ ok: true });
+				}
+			});
+		});
+	}
+
+	/**
+	 * 等待当前轮次结束后再投递下一封。
+	 *
+	 * 原来 catchUp 用 awaitFirstTurn（首 token 即放行），同一会话的多封邮件在
+	 * 补投时全部撞进同一个 turn → 「message undefined is already pending」。
+	 * 这个函数等 turn/end，且对同一会话串行化，杜绝并发 followup。
+	 */
+	async function waitForTurnEnd(
+		agent: any,
+		timeoutMs = 120_000,
+	): Promise<void> {
+		await new Promise<void>((resolve) => {
+			let done = false;
+			const finish = () => {
+				if (!done) {
+					done = true;
+					clearTimeout(timer);
+					dispose?.();
+					resolve();
+				}
+			};
+			const timer = setTimeout(finish, timeoutMs);
+			const dispose = ctx.on("session/event", (session: any, event: any) => {
+				if (session !== agent.session) return;
+				if (event?.type === "turn/end") finish();
+			});
+		});
+	}
+
+	/** 按会话锁串行化 followup，同一会话同一时刻只跑一轮。 */
+	const sessionLocks = new Map<string, Promise<void>>();
+	async function locked<T>(
+		dshSessionId: string,
+		fn: () => Promise<T>,
+	): Promise<T> {
+		const prev = sessionLocks.get(dshSessionId) ?? Promise.resolve();
+		let release!: () => void;
+		const next = new Promise<void>((r) => {
+			release = r;
+		});
+		sessionLocks.set(dshSessionId, next);
+		try {
+			await prev;
+			return await fn();
+		} finally {
+			release();
+			if (sessionLocks.get(dshSessionId) === next)
+				sessionLocks.delete(dshSessionId);
+		}
+	}
+
+	// ─── 建会话（磁盘上已有则 resume）───
+
+	/**
+	 * 问持久化层：磁盘上是否已经有这条会话？
+	 *
+	 * `sessionMap` 是纯内存的，插件重启后为空，于是同一封邮件的续谈会走
+	 * 「新开会话」那条路，用回同一个 `mail-<session_id>` —— 而那个 id 上一次
+	 * 已经落过盘。只能问持久化层，因为这是重启后唯一还存在的事实来源。
+	 *
+	 * 读不到就当作不存在：`readSession` 在会话不存在、日志不可读、replay 校验
+	 * 不过时都会抛。三种情形里只有第一种适合 create，但后两种 resume 也一样
+	 * 救不回来 —— 那就让 create 去报它自己的错。
+	 */
+	async function persistedCwd(sessionId: string): Promise<string | undefined> {
+		const q: any = (ctx as any).get?.("sessionQuery");
+		if (!q?.readSession) return undefined;
+		try {
+			const snap = await q.readSession(sessionId);
+			return snap?.header?.cwd ?? "";
+		} catch {
+			return undefined;
+		}
+	}
+
+	/**
+	 * 启一个 agent：磁盘上没有这个 id 就 create，有就 resume。
+	 *
+	 * # 为何必须先探测，不能靠 try/catch
+	 *
+	 * id 冲突不是 `create` 报的：持久化是在**轮次进行中** flush 的，所以
+	 * `create` 会正常返回，错误到 `turn/end` 才以 `reason.kind === 'error'`
+	 * 冲出来（实测：`UNKNOWN: session "..." already has a persisted log on disk`）。
+	 * 把修法写成 catch 里改 resume 完全不会生效 —— 这与「模型失败不是同步抛出的」
+	 * 是同一类陷阱，只是上了一层。
+	 *
+	 * # 为何 resume 而不是换一个新 id
+	 *
+	 * 换 id 等于把之前的往来上下文丢掉，模型会重新问一遍已经问过的问题。
+	 * resume 把磁盘上那条会话装回来接着谈，这同时修掉了一个已知取舍：
+	 * 插件重启后续谈的邮件不再另开一条平台会话。
+	 *
+	 * resume 不接受 `meta`：cwd 取自持久化的 header。这正是想要的 —— 上一次在哪个
+	 * 目录，就继续在那儿；传一个不同的 cwd 只会得到
+	 * `is already persisted at a different cwd` 而不是“改目录”。
+	 */
+	async function startAgent(
+		sessionId: string,
+		cwd: string,
+		route: any,
+	): Promise<{ handle: any; resumed: boolean }> {
+		// route 为 undefined 表示不指定模型，交给平台自己选
+		const agentOptions = route
+			? { provider: route.provider, model: route.model }
+			: {};
+
+		// 注册 standard preset 的工具（bash、fs、fs-search 等）。
+		// dsh-a2a 用同一套 API（ctx.get('agentPresets') + presets.mount）并稳定运行。
+		//
+		// create 与 resume 都必须挂：resume 从磁盘恢复的是**会话历史**，
+		// 不是工具注册 —— 工具是 setup 回调里 mount 的，resume 不传 setup
+		// 就等于回到 setup:undefined 时代（邮件会话没有任何文件工具）。
+		const setupPreset = async (agentCtx: any) => {
+			console.error(
+				`[dsh-mail-bridge] setup 回调触发，agentCtx keys=${JSON.stringify(Object.keys(agentCtx || {}))}`,
+			);
+			try {
+				const presets = ctx.get("agentPresets");
+				console.error(
+					`[dsh-mail-bridge] agentPresets: ${presets ? "存在" : "不存在"}`,
+				);
+				if (presets) {
+					const preset = await presets.resolve("standard");
+					console.error(
+						`[dsh-mail-bridge] standard preset: id=${preset?.id} keys=${JSON.stringify(Object.keys(preset || {}))}`,
+					);
+					if (preset?.id) {
+						await presets.mount(agentCtx, preset.id);
+						console.error(`[dsh-mail-bridge] presets.mount 成功`);
+					} else {
+						console.error(
+							`[dsh-mail-bridge] standard preset 无 id，跳过 mount`,
+						);
+					}
+				}
+			} catch (e: any) {
+				console.error(
+					`[dsh-mail-bridge] presets.mount 失败（工具注册降级）: ${e?.message || e}\n${e?.stack?.slice(0, 300)}`,
+				);
+			}
+		};
+
+		const onDisk = await persistedCwd(sessionId);
+		if (onDisk !== undefined) {
+			// 用 console.error 而不是 ctx.logger.info：后者不进 journalctl（实测），
+			// 而这条是排查「邮件投不进去」时唯一能看到的线索。
+			console.error(
+				`[dsh-mail-bridge] 会话 ${sessionId} 已在磁盘上（cwd=${onDisk || "未记录"}），改为 resume 续谈`,
+			);
+			const handle = await ctx.agents.resume({
+				resumeSessionId: sessionId as any,
+				agentOptions,
+				setup: setupPreset,
+			});
+			return { handle, resumed: true };
+		}
+
+		const handle = await ctx.agents.create({
+			sessionId,
+			meta: { cwd },
+			agentOptions,
+			setup: setupPreset,
+		});
+		return { handle, resumed: false };
+	}
+
+	// ─── 权限档位 ───
+	//
+	// DSH 的权限由两个独立旋钮控制：
+	//   sandbox/mode  → 控制文件系统和命令执行的边界
+	//   approval/policy → 控制是否需要人类审批
+	//
+	// 三档映射（见 lib/permission-mode.js dshSandboxMode / dshApprovalPolicy）：
+	//   plan     → read-only + ask（只读，遇到权限询问转邮件）
+	//   workspace → workspace-write + ask（目录内可写，越界转邮件）
+	//   full     → danger-full-access + never（完全放开，不问人）
+	//
+	// 直接往 session 上 append 事件（与 permissionPresets.set 同一底层）。
+	// 不走 permissionPresets 服务：它要求 preset 名在配置表里，
+	// 而我们的三档映射需要完全自主控制。
+	function applyPermissionMode(session: any, mode: string): void {
+		if (!session?.append) return;
+		const m = (mode || "workspace").trim();
+		// sandbox mode
+		const sandboxMap: Record<string, string> = {
+			plan: "read-only",
+			workspace: "workspace-write",
+			full: "danger-full-access",
+		};
+		const sandbox = sandboxMap[m] ?? "workspace-write";
+		session.append("sandbox/mode", { mode: sandbox });
+		// approval policy
+		const approvalMap: Record<string, string> = {
+			plan: "ask",
+			workspace: "ask",
+			full: "never",
+		};
+		const approval = approvalMap[m] ?? "ask";
+		session.append("approval/policy", { policy: approval });
+	}
+
+	/**
+	 * 由邮件会话 id 找一个**活着的** DSH 会话，找到就补回内存映射。
+	 *
+	 * # 为什么不能只查 sessionMap
+	 *
+	 * 那是一张纯内存表，插件重启后为空。而 `session_update`（人在 WebUI 改
+	 * 权限档位）只关心**正在跑**的那条会话 —— 重启后它恰好还没收到新邮件时，
+	 * 映射缺失会让这条更新被静默忽略：人在界面上把 full 改回 workspace，
+	 * 运行时依旧按 full 执行。人以为自己收紧了权限。
+	 *
+	 * 邮件新建的会话 id 是确定性的（`mail-<邮件会话 id>`，重试时带 `-r<i>`，
+	 * 见 lib/mail-session-id.js），所以重启后也能定位，并且顺手把映射补回去 ——
+	 * 否则这条会话后续的自动转发（reverseMap）也会一起失效。
+	 *
+	 * 接管会话（adopted）是例外：那条 DSH 会话 id 由平台生成，从邮件会话 id
+	 * 推不出来，重启后确实无法定位热更新 —— 已知取舍；下次投递时会按邮件里
+	 * 带的 permission_mode 重新 apply，档位不会丢。
+	 */
+	function findLiveDshSession(
+		mailSessionID: string,
+	): { id: string; agent: any } | undefined {
+		const bound = sessionMap.peek(mailSessionID);
+		if (bound) {
+			const live = ctx.agents.get(bound.dshSessionId);
+			if (live) return { id: bound.dshSessionId, agent: live };
+		}
+
+		let live: any[] = [];
+		try {
+			live = ctx.agents?.list?.() ?? [];
+		} catch {
+			return undefined;
+		}
+		const id = pickMailSession(
+			live.map((a: any) => String(a?.id ?? "")),
+			mailSessionID,
+		);
+		if (!id) return undefined;
+
+		const agent = live.find((a: any) => String(a?.id ?? "") === id);
+		if (!agent) return undefined;
+
+		if (!bound) {
+			const cwd = String(agent?.session?.header?.cwd ?? "");
+			sessionMap.set(mailSessionID, { dshSessionId: id, directory: cwd });
+			reverseMap.set(id, mailSessionID);
+			mailDrivenSessions.add(id);
+			console.error(
+				`[dsh-mail-bridge] 由确定性 id 恢复会话映射 ${mailSessionID} -> ${id}`,
+			);
+		}
+		return { id, agent };
+	}
+
+	// ─── 投递邮件到 DSH 会话 ───
+
+	/**
+	 * 投进「被接管的平台会话」时给模型的提示词。
+	 *
+	 * 与新建会话那份的差别：不自我介绍身份、不解释邮件系统 —— 这条会话里人已经
+	 * 在谈别的事了，一段「你是 dsh，你收到一封邮件」的开场白会让模型以为上下文
+	 * 被重置。只说「有封邮件进来了」。
+	 */
+	function adoptPrompt(data: any, kind: string): string {
+		if (kind === "permission") {
+			return `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || "用户"}）。请据此继续后续工作。`;
+		}
+		const fromHuman = data.from_human === true;
+		return [
+			inboundHeadline({ inReplyTo: data.in_reply_to, fromHuman, reused: true }),
+			``,
+			`发件人：${data.from_name || "unknown"}`,
+			`主题：${data.subject || "(无主题)"}`,
+			`邮件 ID：${data.mail_id || "unknown"}`,
+			...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
+			...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
+			``,
+			`请先调用 read_inbox 读取完整正文，然后处理其中的请求。`,
+			...replyInstruction({ fromHuman, replyAddress: data.reply_address }),
+		].join("\n");
+	}
+
+	/**
+	 * 记下「这条邮件会话 ↔ 这条平台会话」的绑定与回信上下文。
+	 *
+	 * mailDrivenSessions 必须加：接管之后这条会话**开始**参与邮件往来，轮次结束
+	 * 要把总结转回发件人。不加的话邮件投进去了却永远没有回音。
+	 */
+	function bindAdopted(
+		mailSessionID: string,
+		dshSessionId: string,
+		cwd: string,
+		data: any,
+	): void {
+		if (!mailSessionID) return;
+		sessionMap.set(mailSessionID, { dshSessionId, directory: cwd });
+		reverseMap.set(dshSessionId, mailSessionID);
+		mailDrivenSessions.add(dshSessionId);
+		mailContexts.set(mailSessionID, {
+			replyTo: data.from_name || "",
+			subject: data.subject || "",
+			mailID: data.mail_id || "",
+			fromHuman: data.from_human === true,
+			inReplyTo: data.in_reply_to || "",
+		});
+	}
+
+	async function deliverMail(
+		data: any,
+		kind: string,
+	): Promise<{ sessionID: string; reused: boolean }> {
+		const mailSessionID = data.session_id;
+		const existing = mailSessionID ? sessionMap.get(mailSessionID) : undefined;
+
+		// 服务端说这条邮件会话**接管了平台上已经存在的那条会话**（人在 DSH 界面上
+		// 开的那种）—— 投进它而不是新建。
+		//
+		// TUI 与邮箱是同一个 Agent 的两个入口，不是两套隔离的世界。补全早就把平台
+		// 会话列为候选（session-snapshot 上报的那批），这一跳补上投递侧。
+		//
+		// DSH 上不需要新代码路径：`startAgent` 本来就「磁盘上有就 resume」，
+		// 接管只是把会话 id 从 `mail-<uuid>` 换成平台自己那个。第一次投递走
+		// resume 分支装回上下文，之后与普通续谈完全一样（sessionMap 命中 → followup）。
+		const adoptedID = adoptedSessionID(data);
+		if (!existing && adoptedID) {
+			const onDisk = await persistedCwd(adoptedID);
+			if (onDisk === undefined) {
+				// 平台侧那条会话已不在磁盘上。
+				//
+				// 不能落到「新开会话」那条路 —— 那会用 `mail-<uuid>` 另开一条，
+				// 人在 DSH 界面上看不到这封邮件带来的对话，而那正是接管的目的（N-8）。
+				//
+				// 用 console.error 而不是仅靠抛异常：调用方那层的 catch 走
+				// `ctx.logger.error`，而 DSH 的 logger **不进 journalctl**。邮件因此会
+				// 静默消失：发件人以为送到了，而日志里一个字都没有（实测过）。
+				console.error(
+					`[dsh-mail-bridge] 接管失败：会话 ${adoptedID} 不在本机磁盘上` +
+						`（mail ${data.mail_id}，发件人 ${data.from_name || "?"}）。` +
+						`若这个 id 属于另一个平台，说明 Gateway 把别人的 platform_session_id ` +
+						`推给了本插件。`,
+				);
+				throw new Error(
+					adoptMissingMessage(adoptedID, "磁盘上已无这条会话的日志"),
+				);
+			}
+			return locked(adoptedID, async () => {
+				const promptText = adoptPrompt(data, kind);
+				const live = ctx.agents.get(adoptedID);
+				if (live) {
+					// 界面上正开着这条会话 —— 直接 followup，不要再 resume 一次：
+					// 同一条会话两个 handle 会各自往日志里写，replay 校验过不去。
+					live.followup(userMessage(promptText));
+					await waitForTurnEnd(live);
+					bindAdopted(mailSessionID, adoptedID, onDisk, data);
+					return { sessionID: adoptedID, reused: true };
+				}
+				const { handle } = await startAgent(
+					adoptedID,
+					onDisk,
+					attemptOrder()[0],
+				);
+				applyPermissionMode(handle.agent?.session, data.permission_mode);
+				bindAdopted(mailSessionID, adoptedID, onDisk, data);
+				handle.agent.followup(userMessage(promptText));
+				await waitForTurnEnd(handle.agent);
+				return { sessionID: adoptedID, reused: true };
+			});
+		}
+
+		if (existing) {
+			const live = ctx.agents.get(existing.dshSessionId);
+			if (live) {
+				return locked(existing.dshSessionId, async () => {
+					// 回信上下文必须刷成**这一封**。
+					//
+					// 续谈分支原来不刷：mailContexts 只在 bindAdopted 与新开会话时写一次，
+					// 于是同一条会话的第二封邮件跑完后，自动转发用的还是**第一封**的
+					// subject / mailID —— 回信主题与 parent_mail_id 都指向上一封。
+					// 实测撞出过：回「全流程回归」那封的信，主题写的是上一封
+					// 「platformID 归属验证」，parent 也挂在那封上。
+					//
+					// 与 pi 桥的语义对齐：那边每封邮件都重建 mailContext（worker 一封一进程），
+					// 注释写的就是「一个会话里可能来过多封信，只留最近那封」。
+					if (kind === "mail" && mailSessionID) {
+						mailContexts.set(mailSessionID, {
+							replyTo: data.from_name || "",
+							subject: data.subject || "",
+							mailID: data.mail_id || "",
+							fromHuman: data.from_human === true,
+							inReplyTo: data.in_reply_to || "",
+						});
+					}
+					const promptText =
+						kind === "permission"
+							? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || "用户"}）。请据此继续后续工作。`
+							: [
+									inboundHeadline({
+										inReplyTo: data.in_reply_to,
+										fromHuman: data.from_human === true,
+										reused: true,
+									}),
+									``,
+									`发件人：${data.from_name || "unknown"}`,
+									`主题：${data.subject || "(无主题)"}`,
+									`邮件 ID：${data.mail_id || "unknown"}`,
+									...(data.in_reply_to
+										? [`回的是你那封：${data.in_reply_to}`]
+										: []),
+									...(data.reply_address
+										? [`回信地址：${data.reply_address}`]
+										: []),
+									``,
+									`请先调用 read_inbox 读取完整正文，然后处理其中的请求。`,
+									...replyInstruction({
+										fromHuman: data.from_human === true,
+										replyAddress: data.reply_address,
+									}),
+								].join("\n");
+					live.followup(userMessage(promptText));
+					// 等 turn/end 而不是立即返回：这封邮件的轮次未结束时投递下一封，
+					// 会让 DSH 报 "message already pending"。串行化靠 locked() 保证
+					// 同一时刻只有一个 followup 在跑，两个锁互斥 —— 即使 turn/end
+					// 未出现（比如模型完全没响应），120s 超时兜底不会把后续邮件永久卡住。
+					await waitForTurnEnd(live);
+					return { sessionID: existing.dshSessionId, reused: true };
+				});
+			}
+		}
+
+		// 新开会话
+		const sessionId = `mail-${mailSessionID || Date.now()}`;
+		// cwd 取寻址里的 path 位（to_workspace）。
+		//
+		// 之前这里硬拼 `~/.dsh/mail-sessions/mail-<uuid>` —— 每封邮件一个全新的空目录。
+		// DSH 按 cwd 给会话分组，于是所有邮件会话既不属于任何项目、彼此也不同组，
+		// 界面上全落进「未分组」。path 位本来就是「希望它在哪儿干活」。
+		const { cwd, grouped } = resolveWorkspaceCwd(
+			data.to_workspace,
+			mailSessionFallback(sessionId),
+		);
+		ensureCwd(cwd, grouped);
+		if (!grouped && data.to_workspace) {
+			ctx.logger.warn(
+				`[dsh-mail-bridge] 工作目录 ${data.to_workspace} 不可用，回退到 ${cwd}`,
+			);
+		}
+
+		const promptText =
+			kind === "permission"
+				? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || "用户"}）。请据此继续。`
+				: [
+						inboundHeadline({
+							inReplyTo: data.in_reply_to,
+							fromHuman: data.from_human === true,
+							catchup: data.catchup,
+							reused: false,
+						}),
+						``,
+						`发件人：${data.from_name || "unknown"}`,
+						`主题：${data.subject || "(无主题)"}`,
+						`邮件 ID：${data.mail_id || "unknown"}`,
+						...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
+						`身份：你是 ${AGENT_NAME}`,
+						...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
+						``,
+						`请先调用 read_inbox 读取完整正文（附带附件清单，如有附件可用 download_attachment 取回），然后处理其中的请求。`,
+						``,
+						...replyInstruction({
+							fromHuman: data.from_human === true,
+							replyAddress: data.reply_address,
+						}),
+					].join("\n");
+
+		// 按管理员划定的范围逐个尝试建 agent，全部失败才回一封说明原因的邮件。
+		//
+		// 必须发那封信：agent 一次都没建起来时会话里没有任何 assistant 消息，
+		// 自动转发因此什么也不会发 —— 发件人只会看到邮件发出去后再无音讯。
+		//
+		// DSH 与 opencode 的差异：这里失败在**建 agent** 时就暴露（模型路由是
+		// agentOptions 的一部分），而 opencode 是在 promptAsync 时。
+		const attempts = attemptOrder();
+		const failures: { provider?: string; model?: string; error: string }[] = [];
+
+		for (let i = 0; i < attempts.length; i++) {
+			const route = attempts[i];
+			const label = route ? `${route.provider}/${route.model}` : "(平台默认)";
+			// 每次尝试用不同的会话 id：失败那次的日志里已经有 turn/end error，
+			// 复用同一个 id 会让重试接在一条已经出错的会话后面。
+			const attemptSessionId = i === 0 ? sessionId : `${sessionId}-r${i}`;
+			let handle: any;
+
+			try {
+				const started = await startAgent(attemptSessionId, cwd, route);
+				handle = started.handle;
+				// 设定权限档位：sandbox/mode 决定文件与命令边界，
+				// approval/policy 决定越界时是否转邮件问人。
+				applyPermissionMode(handle.agent?.session, data.permission_mode);
+			} catch (e: any) {
+				// create/resume 本身很少失败（create 不校验模型），
+				// 但 cwd 不符、日志 replay 不过之类仍会抛
+				failures.push({ ...(route ?? {}), error: e?.message || String(e) });
+				console.error(
+					`[dsh-mail-bridge] 建会话失败 ${label}: ${e?.message || e}`,
+				);
+				continue;
+			}
+
+			// 先建映射再 followup：turn 可能在 followup 返回前就产出事件，
+			// 而 agent/status 的处理要靠这些映射找到回信地址。
+			if (mailSessionID) {
+				sessionMap.set(mailSessionID, {
+					dshSessionId: attemptSessionId,
+					directory: cwd,
+				});
+				reverseMap.set(attemptSessionId, mailSessionID);
+				mailDrivenSessions.add(attemptSessionId);
+				mailContexts.set(mailSessionID, {
+					replyTo: data.from_name || "",
+					subject: data.subject || "",
+					mailID: data.mail_id || "",
+					fromHuman: data.from_human === true,
+					inReplyTo: data.in_reply_to || "",
+				});
+			}
+
+			// 把会话挂进工作区注册表 —— 这是让 DSH GUI 把它从「未分组」挪进对应项目
+			// 的唯一路径。不挂的后果：会话永远落在 Ungrouped，人类在侧栏看不到它
+			// 与项目的从属关系，也无法用 DSH 的工作区级操作（批量归档、重命名等）。
+			//
+			// **cwd 必须取自会话 header，不能用上面那个 `cwd` 变量。**
+			//
+			// 上一版就错在这里：那个变量是 `resolveWorkspaceCwd` 的结果，可能是**兜底值**
+			// （`~/.dsh/mail-sessions/mail-<uuid>`）；而 resume 路径下会话的真实 cwd 取自
+			// 持久化的 header，两者不一致时 `attachSession` 的校验直接拒绝：
+			//
+			//   cannot attach session 'mail-f3d824ce…' to workspace
+			//   '/root/.dsh/mail-sessions/mail-f3d824ce…': its cwd resolves to '/home/program/llmsproxy'
+			//
+			// 更糟的是 `wr.create()` 已经先执行了 —— 于是每封邮件都往注册表里
+			// 塞一条永远为空的垃圾 workspace。先读 header 再注册就不会有这个问题。
+			//
+			// 失败不可怕：会话本身已经能用了，只是 GUI 分组不对。
+			if (handle) {
+				try {
+					// 真实 cwd：create 路径下就是上面传的 meta.cwd，
+					// resume 路径下是持久化 header 里那个。两种情形都从 session 读。
+					const actualCwd = String(handle.agent?.session?.header?.cwd ?? "");
+					const wr: any = (ctx as any).get?.("workspaceRegistry");
+					if (actualCwd && wr?.create) {
+						const ws = await wr.create(
+							actualCwd,
+							actualCwd.split("/").pop() || actualCwd,
+						);
+						if (ws?.attachSession) {
+							await ws.attachSession(attemptSessionId as any);
+						}
+					}
+				} catch (e: any) {
+					// 工作区注册失败不影响会话功能：只有 GUI 分组会受影响。
+					// 日志用 console.error 才进 journalctl（ctx.logger 不进）。
+					console.error(
+						`[dsh-mail-bridge] 工作区注册失败（不影响功能）: ${e?.message || e}`,
+					);
+				}
+			}
+
+			const watching = awaitFirstTurn(handle.agent);
+			handle.agent.followup(userMessage(promptText));
+			const outcome = await watching;
+
+			if (outcome.ok) {
+				if (failures.length > 0) {
+					console.error(
+						`[dsh-mail-bridge] ${label} 成功（前 ${failures.length} 个失败）`,
+					);
+				}
+				return { sessionID: attemptSessionId, reused: false };
+			}
+
+			failures.push({ ...(route ?? {}), error: outcome.error });
+			console.error(`[dsh-mail-bridge] 模型 ${label} 失败: ${outcome.error}`);
+			// 拆掉这一路的 agent 与映射，否则它会占着会话 id，
+			// 而 agent/status 还会为这个死会话触发一次自动转发
+			reverseMap.delete(attemptSessionId);
+			mailDrivenSessions.delete(attemptSessionId);
+			try {
+				await handle.dispose();
+			} catch {
+				// dispose 失败不影响换下一个模型
+			}
+		}
+		if (mailSessionID) sessionMap.delete(mailSessionID);
+
+		// 全部失败：把原因作为邮件回给发件人。走免配额通道 ——
+		// 这是插件的故障报告，不是模型的自主发信。
+		if (kind === "mail" && data.from_name) {
+			try {
+				await client.post("/mail/send", {
+					to: data.from_name,
+					subject: `处理失败: ${data.subject || "(无主题)"}`,
+					body: renderFailureReport(failures, data.subject),
+					reply_to: data.mail_id || "",
+					relay: "summary",
+					relay_key: clampRelayKey(
+						`model-failure:${data.mail_id || sessionId}`,
+					),
+				});
+				ctx.logger.info(
+					`[dsh-mail-bridge] 已回报模型调用失败给 ${data.from_name}`,
+				);
+			} catch (e: any) {
+				ctx.logger.error(
+					`[dsh-mail-bridge] 失败回报也发不出去: ${e?.message || e}`,
+				);
+			}
+		}
+		throw new Error(
+			`划定范围内的 ${failures.length} 个模型全部失败：` +
+				failures.map((f) => f.error).join(" | "),
+		);
+	}
+
+	// ─── SSE 监听 ───
+	//
+	// 共用客户端（lib/sse-client.js）：跨 TCP 分片保帧状态 + Last-Event-ID 断点续传。
+	// 之前手写的解析把 evt/data 当 read() 的局部变量，一帧被切在两个 chunk 就整帧
+	// 静默丢弃（new_mail / permission_decision / session_update 都可能丢）；也不带
+	// Last-Event-ID，断线期间的事件回放不出来。
+
+	let sseClient: { stop: () => void } | null = null;
+
+	function startSSE(onEvent: (type: string, data: any) => void) {
+		sseClient?.stop?.();
+		sseClient = createSSEClient({
+			authHeaders: () => client.authHeaders(),
+			baseURL: GW.replace(/\/+$/, ""),
+			path: "/api/v1/events/stream",
+			onEvent,
+			log: (msg: string) => console.error(`[dsh-mail-bridge] ${msg}`),
+		});
+		return sseClient;
+	}
+
+	// ─── 注册模型工具 ───
+
+	ctx.effect(() => {
+		// send_mail
+		ctx.tools.register(
+			defineTool({
+				name: "send_mail",
+				description:
+					"发送邮件。三维地址 name@path.session：省略 session 投递到默认会话，.new 强制新建，.具体别名 必须已存在。回复来信请传 reply_to。",
+				parameters: {
+					to: { type: "string", required: true, description: "收件人三维地址" },
+					subject: { type: "string", required: true, description: "邮件主题" },
+					body: {
+						type: "string",
+						required: true,
+						description: "邮件正文（Markdown）",
+					},
+					cc: { type: "string", description: "抄送，逗号分隔多个三维地址" },
+					reply_to: {
+						type: "string",
+						description: "回复某封邮件时传其 mail_id",
+					},
+					session_alias: { type: "string", description: "给新会话命名" },
+					attachment_ids: {
+						type: "array",
+						items: { type: "string" },
+						description: "附件 ID 列表",
+					},
+					propose_alias: {
+						type: "string",
+						description:
+							"建议把当前会话改名成这个别名（例如摸清问题后从「排查登录问题」改成 fix-session-cookie-leak）。这只是建议：别名是人的寻址入口，实际改名由用户在界面上确认。不可含 . / @ 空白，不可为 new",
+					},
+					propose_reason: {
+						type: "string",
+						description: "改名理由，一句话，展示给用户看",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any, toolCtx: any): Promise<string> {
+					// 改名提议以 HTML 注释形式附在正文末尾，由网关解析后剥离。
+					// 拼接收在 lib/rename-proposal.js（三平台共用）：标记格式是服务端正则的
+					// 镜像，各写一遍的话少个空格就静默失效 —— 邮件照常发出，提议凭空消失。
+					const { body, proposed } = appendRenameProposal(
+						args.body,
+						args.propose_alias,
+						args.propose_reason,
+					);
+					const result = await client.post("/mail/send", {
+						to: args.to,
+						subject: args.subject,
+						body,
+						cc: args.cc || "",
+						reply_to: args.reply_to || "",
+						session_alias: args.session_alias || "",
+						attachment_ids: args.attachment_ids || [],
+						from_session_id: toolCtx?.sessionID || "",
+					});
+					noteExplicitSend(toolCtx?.sessionID, args.to, args.reply_to);
+					const budget =
+						typeof result.budget_remaining === "number"
+							? ` 本任务剩余 ${result.budget_remaining}/${result.budget_max} 个来回。`
+							: "";
+					// 别名取服务端回的 rename_proposed（它跑过 normalizeAlias），
+					// 回显本地值会让模型记住一个不存在的名字，之后拿它寻址就 404
+					const note = renameProposalNote(
+						result.rename_proposed,
+						args.propose_alias,
+						proposed,
+					);
+					return (
+						`邮件已发送（ID: ${result.mail_id}）${budget}` +
+						(note ? `\n${note}` : "")
+					);
+				},
+			}),
+		);
+
+		// read_inbox
+		ctx.tools.register(
+			defineTool({
+				name: "read_inbox",
+				description:
+					"查阅收件箱中的邮件。收到新邮件通知后应立即调用此工具。每封含 mail_id、发件人、主题、正文与附件清单（带 attachment_id）。",
+				parameters: {
+					status: {
+						type: "string",
+						description: "过滤条件 unread|all，默认 unread",
+					},
+					limit: { type: "number", description: "返回数量，默认 5" },
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					const status = args.status || DEFAULT_INBOX_STATUS;
+					const { mails } = await client.get(
+						`/mail/inbox?status=${status}&limit=${args.limit || DEFAULT_INBOX_LIMIT}`,
+					);
+
+					// 渲染与已读策略放 lib/inbox-format.js：它们与平台 SDK 无关，
+					// 各平台插件必须一致（见该文件里每条规则对应的错误行为）。
+					//
+					// 传 AGENT_NAME 才能判定「我是收件人还是抄送方」并给出可投递地址。
+					const listed = renderInbox(mails, 200, AGENT_NAME);
+
+					// 读过就标掉，否则每次拉收件箱都重复捞同一批，
+					// 处理过的和新来的混在一起，模型分不清哪封该回。
+					const ids = idsToMarkRead(args.status, mails);
+					if (ids.length) {
+						// 标记失败不该让 read_inbox 失败：正文已经取到了，
+						// 代价只是下次重复看到，比丢掉这次读取轻。
+						client
+							.post("/mail/read", { mail_ids: ids })
+							.catch((e: any) =>
+								ctx.logger.error(
+									`[dsh-mail-bridge] 标记已读失败: ${e?.message || e}`,
+								),
+							);
+					}
+					return listed;
+				},
+			}),
+		);
+
+		// upload_attachment
+		ctx.tools.register(
+			defineTool({
+				name: "upload_attachment",
+				description:
+					"上传本地文件作为邮件附件，返回 attachment_id。" +
+					"拿到 id 后必须在 send_mail 的 attachment_ids 里带上，附件才会随邮件发出。" +
+					"未随邮件发出的附件 24 小时后自动清理。",
+				parameters: {
+					file_path: {
+						type: "string",
+						required: true,
+						description: "要上传的本地文件绝对路径",
+					},
+					filename: {
+						type: "string",
+						description: "自定义展示文件名，默认取路径的最后一段",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					// 先 stat 再读：目录和不存在的路径都要给出能行动的错误。
+					// 直接 readFile 的话，目录抛的 EISDIR 只会让模型重试同一个路径。
+					let st;
+					try {
+						st = await stat(args.file_path);
+					} catch {
+						return `文件不存在或不可读: ${args.file_path}`;
+					}
+					if (!st.isFile()) return `不是普通文件: ${args.file_path}`;
+
+					const data = await readFile(args.file_path);
+					const filename =
+						args.filename || args.file_path.split("/").pop() || "file";
+					// **必须发真正的 multipart。**
+					//
+					// 早先这里发的是 `Content-Type: application/octet-stream` 加一个
+					// `X-Filename` 头，而服务端走 `ParseMultipartForm` + `FormFile("file")` ——
+					// 于是 **这个工具从来没成功过一次**，每次都回「解析 multipart 失败」。
+					// 模型甚至把它当成了文件存在性探针（存在→报 multipart 错、
+					// 不存在→ENOENT），那是对症状的准确利用，但不是它应该做的事。
+					//
+					// 不设 Content-Type：交给 FormData 自己带 boundary，手写的一定对不上。
+					const form = new FormData();
+					form.append("file", new Blob([data]), filename);
+					const res = await fetch(`${client.baseURL}/api/v1/attachments`, {
+						method: "POST",
+						headers: client.authHeaders(),
+						body: form,
+					});
+					const json = (await res.json()) as any;
+					if (!res.ok) throw new Error(json?.error || `HTTP ${res.status}`);
+					const a = json.attachment;
+					return (
+						`已上传 ${a.filename}（${formatSize(a.size_bytes)}）。attachment_id: ${a.attachment_id}\n` +
+						`在 send_mail 的 attachment_ids 里带上这个 id 才会随邮件发出。`
+					);
+				},
+			}),
+		);
+
+		// download_attachment
+		ctx.tools.register(
+			defineTool({
+				name: "download_attachment",
+				description:
+					"下载邮件附件到本地文件。attachment_id 从 read_inbox 的附件清单里取。",
+				parameters: {
+					attachment_id: {
+						type: "string",
+						required: true,
+						description: "附件 ID",
+					},
+					save_path: {
+						type: "string",
+						required: true,
+						description: "保存到的本地绝对路径",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					const res = await fetch(
+						`${client.baseURL}/api/v1/attachments/${args.attachment_id}`,
+						{
+							headers: client.authHeaders(),
+						},
+					);
+					if (!res.ok) throw new Error(`下载失败: HTTP ${res.status}`);
+					const buf = Buffer.from(await res.arrayBuffer());
+					// 父目录不存在时先建：模型经常写 ./downloads/x.pdf 这类还不存在的路径，
+					// 不建的话 writeFile 抛 ENOENT，而那个错误看起来像「附件不存在」。
+					await mkdir(dirname(args.save_path), { recursive: true });
+					await writeFile(args.save_path, buf);
+					return `已保存到 ${args.save_path}（${formatSize(buf.length)}）`;
+				},
+			}),
+		);
+
+		// ─── 寻址发现工具（读 Agent 侧只读端点）───
+		//
+		// 在这一组之前，send_mail 的 to 是个只能靠记忆拼写的自由文本字段，
+		// 而拼错不报错：生产上本插件猜了 `opencode@/home`，投递成功，
+		// 但那不是 opencode 的工作目录，静默变成了新会话的 workspace。
+
+		ctx.tools.register(
+			defineTool({
+				name: "suggest_address",
+				description:
+					"查询可用的收件人地址，用于精准发信。不带参数给候选收件人名；带 name 给它可用的工作目录；" +
+					"name+path 都带则给该目录下可续谈的会话与现成地址。**发信前应先用它确认地址**，" +
+					"不要凭记忆拼写 —— 拼错不会报错，只会投到别的会话。",
+				parameters: {
+					name: {
+						type: "string",
+						description: "收件人名；留空则列出所有候选收件人",
+					},
+					path: {
+						type: "string",
+						description: "工作目录；与 name 同时给出才列会话",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					const name = String(args.name || "").trim();
+					const path = String(args.path || "").trim();
+					const qs = new URLSearchParams();
+					if (name) qs.set("name", name);
+					if (path) qs.set("path", path);
+					const data = await client.get(
+						`/agent/contacts/suggest?${qs.toString()}`,
+					);
+					// 按服务端回的 kind 分派而不是按本地参数：省略与传空串在服务端
+					// 是同一个意思，但「哪一段该渲染成什么」只有服务端知道。
+					switch (data?.kind) {
+						case "name":
+							return renderNameSuggestions(data.suggestions);
+						case "path":
+							return renderPathSuggestions(data.suggestions, name);
+						default:
+							return renderSessionSuggestions(data, name, path);
+					}
+				},
+			}),
+		);
+
+		ctx.tools.register(
+			defineTool({
+				name: "list_contacts",
+				description:
+					"列出自己参与过的全部会话及各自的可投递地址、未读数、剩余往返预算。" +
+					"用于回答「我还有什么没处理」与「上次跟某人聊的那条线索地址是什么」。",
+				parameters: {
+					limit: { type: "number", description: "最多列出多少条，默认 20" },
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					const data = await client.get("/agent/contacts");
+					return renderContacts(data, args.limit || 20);
+				},
+			}),
+		);
+
+		ctx.tools.register(
+			defineTool({
+				name: "session_participants",
+				description:
+					"列出某条会话的全部参与方（发件人/收件人/抄送方）及各自的可投递地址，" +
+					"并标出谁还没回应。**要回给抄收方或向第三方转达时先用它拿地址**。",
+				parameters: {
+					session_id: {
+						type: "string",
+						required: true,
+						description: "会话 ID",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					const data = await client.get(
+						`/agent/sessions/${args.session_id}/participants`,
+					);
+					return renderParticipants(data);
+				},
+			}),
+		);
+
+		ctx.tools.register(
+			defineTool({
+				name: "read_thread",
+				description:
+					"查看一封邮件所在线索的完整往来（谁回了谁、谁还没回）。多方抄送协作时" +
+					"用它确认别人已经说了什么，避免重复提问或重复汇报。",
+				parameters: {
+					mail_id: {
+						type: "string",
+						required: true,
+						description: "线索中任一封邮件的 ID",
+					},
+					offset: {
+						type: "number",
+						description: "分页偏移，续取时传上次返回的 next_offset",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					const qs = args.offset ? `?offset=${args.offset}` : "";
+					const data = await client.get(
+						`/agent/mail/${args.mail_id}/thread${qs}`,
+					);
+					return renderThread(data, AGENT_NAME);
+				},
+			}),
+		);
+
+		ctx.tools.register(
+			defineTool({
+				name: "read_mail",
+				description:
+					"读一封邮件的完整内容，含收件人、抄送清单、附件与每个参与方的可投递地址。" +
+					"收件箱只给摘要；要回给抄收方就得先看清这封信发给了谁。",
+				parameters: {
+					mail_id: { type: "string", required: true, description: "邮件 ID" },
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					const data = await client.get(`/agent/mail/${args.mail_id}`);
+					const m = data?.mail || {};
+					const lines = [
+						`发件人: ${m.from_name || "?"}`,
+						`收件人: ${m.to_name || "?"}${m.to_workspace ? "@" + m.to_workspace : ""}`,
+						`主题: ${m.subject || "(无主题)"}`,
+						`会话: #${data.session_alias || "未命名"}（session_id: ${m.session_id || "?"}）`,
+					];
+					if (Array.isArray(m.cc_list) && m.cc_list.length) {
+						lines.push(
+							`抄送: ${m.cc_list.map((c: any) => c?.raw || c?.name).join("、")}`,
+						);
+					}
+					if (Array.isArray(m.attachments) && m.attachments.length) {
+						lines.push(
+							`附件: ${m.attachments
+								.map(
+									(a: any) =>
+										`${a.filename}（${formatSize(a.size_bytes)}, id=${a.attachment_id}）`,
+								)
+								.join("、")}`,
+						);
+					}
+					lines.push("", m.body || "(空正文)", "");
+					if (Array.isArray(data.participants) && data.participants.length) {
+						lines.push(
+							"可投递地址: " +
+								data.participants
+									.filter((p: any) => p.address && p.name !== AGENT_NAME)
+									.map((p: any) => `${p.address}（${p.role}）`)
+									.join("、"),
+						);
+					}
+					if (data.reply_address) {
+						lines.push(
+							`回信给发件人用 ${data.reply_address}，或传 reply_to=${m.mail_id}。`,
+						);
+					}
+					return lines.join("\n");
+				},
+			}),
+		);
+
+		// forward_mail —— 转发给新收件人。
+		//
+		// 之前 DSH 侧缺这个工具（opencode 侧一直有），于是本平台上「把这封信
+		// 转给某人」只能退化成 send_mail 重抄一遍正文 —— 丢掉附件、丢掉
+		// parent_mail_id，对话树上也看不出这条新线索从何而来。
+		ctx.tools.register(
+			defineTool({
+				name: "forward_mail",
+				description:
+					"转发一封邮件给新的收件人（自动引用原文与附件）。与回复不同：回复落回原会话，" +
+					"转发按目标地址另行定位会话（它是一条新线索）。只能转发自己参与过的邮件。",
+				parameters: {
+					mail_id: {
+						type: "string",
+						required: true,
+						description: "要转发的邮件 ID",
+					},
+					to: {
+						type: "string",
+						required: true,
+						description: "新收件人的三维地址（先用 suggest_address 确认）",
+					},
+					comment: {
+						type: "string",
+						description: "转发说明，置于引用原文之前",
+					},
+					cc: { type: "string", description: "抄送，逗号分隔多个三维地址" },
+					subject: {
+						type: "string",
+						description: "自定义主题；留空则自动加 Fwd: 前缀",
+					},
+					session_alias: {
+						type: "string",
+						description: "仅当目标地址以 .new 结尾时生效：给新会话命名",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any, toolCtx: any): Promise<string> {
+					const result = await client.post(`/mail/${args.mail_id}/forward`, {
+						to: args.to,
+						comment: args.comment || "",
+						cc: args.cc || "",
+						subject: args.subject || "",
+						session_alias: args.session_alias || "",
+					});
+					// 转发也是一次「模型亲手发信」，要计入 explicitSends，
+					// 否则本轮结束时自动转发会再把同一段话发一遍。
+					noteExplicitSend(toolCtx?.sessionID, args.to, "");
+					return `已转发。新 Mail ID: ${result.mail_id}，Session: ${result.session_id}`;
+				},
+			}),
+		);
+
+		// connect_to_server —— 连接自愈。
+		//
+		// 之前只有 opencode 侧有这个工具。后果是：Gateway 换了地址、或密钥需要
+		// 重新登记时，opencode 里的模型能自己修好，而 DSH 里的模型只能干等
+		// systemd 环境变量被人改 —— 同一类能力在不同平台上时有时无，
+		// 等于让人记住哪个平台能自己修。
+		//
+		// 失败时**把需要登记的密钥全文打出来**：密钥未登记是最常见的失败，
+		// 不给值的话要多走一轮「密钥无效 → 去哪拿 → 让管理员登记」。
+		ctx.tools.register(
+			defineTool({
+				name: "connect_to_server",
+				description:
+					"连接到 AgentMail Gateway：登记本机密钥并完成注册。首次安装或换了 Gateway 地址时调用。" +
+					"密钥若未在后台登记过，此处会返回需要登记的密钥全文。",
+				parameters: {
+					gateway_url: {
+						type: "string",
+						description:
+							"Gateway 地址，如 https://mail.example.com；省略则用当前配置",
+					},
+					key_token: {
+						type: "string",
+						description:
+							"管理员签发的 Agent 密钥；省略则用本地密钥（不存在时自动生成）",
+					},
+				},
+				output: {
+					schema: { type: "string" },
+					render: (_args: any, value: string) => [
+						{ type: "text", text: value },
+					],
+				},
+				async execute(args: any): Promise<string> {
+					let key = client.agentKey;
+					if (args.key_token) {
+						key = String(args.key_token).trim();
+						// 管理员给的密钥落盘，重启后仍然可用
+						saveLocalKey(key);
+					} else if (!key) {
+						key = generateLocalKey();
+					}
+
+					const url = String(args.gateway_url || client.baseURL).replace(
+						/\/+$/,
+						"",
+					);
+
+					const res = await fetch(`${url}/api/v1/agent/register`, {
+						method: "POST",
+						headers: {
+							"Content-Type": "application/json",
+							Authorization: `Bearer ${key}`,
+						},
+						body: JSON.stringify({
+							name: AGENT_NAME,
+							workspaces: [],
+							platform: "dsh",
+						}),
+					});
+					const data = (await res.json().catch(() => ({}))) as any;
+
+					if (!res.ok) {
+						return [
+							`连接失败（HTTP ${res.status}）：${data?.error || "未知错误"}`,
+							``,
+							`若提示密钥无效，请让管理员在 AgentMail 后台「Agent 密钥」中登记：`,
+							key,
+							``,
+							`密钥文件：${KEY_FILE}`,
+						].join("\n");
+					}
+
+					// 成功后把新坐标写回客户端，当场生效（不用等重启）
+					client.baseURL = url;
+					client.agentKey = key;
+					return `已连接 ${url}，注册为 ${data?.agent_name || AGENT_NAME}。`;
+				},
+			}),
+		);
+
+		return () => {
+			for (const n of [
+				"send_mail",
+				"read_inbox",
+				"read_mail",
+				"forward_mail",
+				"upload_attachment",
+				"download_attachment",
+				"suggest_address",
+				"list_contacts",
+				"session_participants",
+				"read_thread",
+				"connect_to_server",
+			]) {
+				try {
+					ctx.tools.unregister(n);
+				} catch {
+					// 拆插件时重复注销（已经卸载 / 未注册过）不影响 teardown，忽略即可
+				}
+			}
+		};
+	}, "dsh-mail-bridge.tools");
+
+	// ─── turn 完成后自动转发回复 ───
+	//
+	// 与 opencode-mail-bridge 的 session.idle 同一职责：模型把话说完了，
+	// 插件把它最后那段话搬到邮件里 —— 不该让模型自己记得调 send_mail。
+	ctx.on("agent/status", async (payload: any) => {
+		if (payload?.status !== "idle") return;
+		const agent = payload.agent;
+		if (!agent?.id) return;
+		const mailSessionID = reverseMap.get(String(agent.id));
+		if (!mailSessionID) return;
+		const mctx = mailContexts.get(mailSessionID);
+
+		// **只给人类来信自动转发**（见 lib/relay-policy.js）。
+		//
+		// 对方是 Agent 时它那边的插件也会自动回一封，于是两个模型都以为「我只要
+		// 把话说完就行」，实际在持续互相唤醒 —— 生产实测 pi 与 dsh 客套 6 轮直到
+		// 撞上连续 relay 跳数上限。日志走 console.error：ctx.logger 不进 journalctl，
+		// 而「本轮为何没有回信」必须能查到。
+		const policy = autoRelayDecision({
+			fromHuman: mctx?.fromHuman === true,
+			replyTo: mctx?.replyTo,
+		});
+		if (!policy.relay) {
+			console.error(`[dsh-mail-bridge] 本轮不自动转发：${policy.reason}`);
+			return;
+		}
+		// policy.relay 为真已经蕴含 mctx?.replyTo 非空（autoRelayDecision 的第一道判定），
+		// 但 TS 推不出那层关系 —— 显式窄一下，而不是给后面每处加非空断言。
+		if (!mctx) return;
+
+		// 取最后一条 assistant 消息的文本
+		const events = agent.session?.events ?? [];
+		const lastText = lastAssistantText(events);
+		if (!lastText) {
+			// 模型 idle 但没有任何 assistant 文本：空回复/被中断在文本前。
+			// 此前静默返回 —— 发件人等不到任何回复（缺的是 B-6 的「模型全部失败」
+			// 同款兜底，只是这次没有失败可报却也没有产出）。给发件人一封失败通知。
+			// 只给人类来信发：Agent 之间不自动转发（与上面同一判据）。
+			try {
+				await client.post("/mail/send", {
+					to: mctx.replyTo,
+					subject: `处理失败: ${mctx.subject || "(无主题)"}`,
+					body: [
+						`这封邮件（主题：${mctx.subject || "(无主题)"}）的处理轮次已结束，但没有产出任何回复文本。`,
+						"",
+						"可能原因：模型空响应、输出被中断、或工具调用异常耗尽轮次。",
+						"请检查后重试。",
+					].join("\n"),
+					reply_to: mctx.mailID || "",
+					relay: "summary",
+					relay_key: clampRelayKey(`empty-reply:${mailSessionID}`),
+				});
+				console.error(`[dsh-mail-bridge] 已发空回复失败通知给 ${mctx.replyTo}`);
+			} catch (e: any) {
+				console.error(
+					`[dsh-mail-bridge] 空回复失败通知也发不出去: ${e?.message || e}`,
+				);
+			}
+			return;
+		}
+
+		// 本轮模型已亲手回过这条线索 → 不再自动转发（与 opencode 侧同一取舍）
+		if (
+			shouldSkipAutoRelay(
+				explicitSends.get(String(agent.id)),
+				mctx.replyTo,
+				mctx.mailID,
+			)
+		) {
+			explicitSends.delete(String(agent.id));
+			return;
+		}
+		// 同一条消息只转一次
+		if (relayedSummaries.get(String(agent.id)) === lastText) return;
+
+		try {
+			await client.post("/mail/send", {
+				to: mctx.replyTo,
+				subject: replySubject(mctx.subject),
+				body: lastText,
+				reply_to: mctx.mailID || "",
+				// relay + relay_key：走免配额通道（harness 的搬运不该收费）
+				relay: "summary",
+				relay_key: clampRelayKey(`${agent.id}:${events.length}`),
+			});
+			relayedSummaries.set(String(agent.id), lastText);
+			explicitSends.delete(String(agent.id));
+			ctx.logger.info(
+				`[dsh-mail-bridge] 总结已回信 ${mctx.replyTo}（不计配额）`,
+			);
+		} catch (e: any) {
+			ctx.logger.error(`[dsh-mail-bridge] 转发回复失败: ${e?.message || e}`);
+		}
+
+		// 会话命名回写：DSH 首轮结束后由模型生成摘要标题，把它同步回 AgentMail。
+		// 与 opencode 侧同一决定：不另造一套命名，平台叫什么这边就叫什么。
+		//
+		// DSH 没有 opencode 那样的 slug，别名由标题派生（slugFromTitle 会去掉
+		// `.` `@` `/` 这些寻址分隔符 —— 留在别名里会让它自己被解析器切开）。
+		// 别名与标题一起发：服务端撞名时自动追 -2/-3 后缀，并尊重人工改过的别名。
+		const title = modelTitle(events);
+		if (title && syncedTitles.get(String(agent.id)) !== title) {
+			syncedTitles.set(String(agent.id), title);
+			const alias = slugFromTitle(title);
+			try {
+				await client.post(
+					`/sessions/${mailSessionID}/sync`,
+					alias ? { title, alias } : { title },
+				);
+				ctx.logger.info(
+					`[dsh-mail-bridge] 会话命名已同步: title=${title}${alias ? ` alias=${alias}` : ""}`,
+				);
+			} catch (e: any) {
+				ctx.logger.error(`[dsh-mail-bridge] 命名同步失败: ${e?.message || e}`);
+			}
+		}
+	});
+
+	// ─── 平台原生权限询问 → 转成邮件问人 ───
+	//
+	// 这是 harness 的职责，不该让模型自己调一个 request_permission 工具：
+	// 模型可能忘了调，也可能在不需要时乱调，而真正被 DSH 拦下的那次询问反而没人看见。
+	//
+	// 与 opencode 的差异：opencode 的 permission.ask 是同步钩子，卡在里面会把整个
+	// 请求挂住，所以那边只能“转出去就返回 ask”；而 DSH 的 approval/request 是
+	// **异步 waterfall**，返回 Promise<ApprovalOutcome> 就是它要的，因此可以真的等人。
+	ctx.on("approval/request", async (req: any, next: () => Promise<string>) => {
+		const agentId = String(req?.agent?.id ?? "");
+		if (!mailDrivenSessions.has(agentId)) return next(); // 非邮件驱动的会话不接管
+		const mailSessionID = reverseMap.get(agentId);
+		if (!mailSessionID) return next();
+
+		// DSH 不给询问发 id，用 (会话, 工具, callId) 做幂等键。
+		// clampRelayKey 收尾：callId 的长度由上游模型决定，pi 侧实测过带思考签名的
+		// 13601 字节 id，超服务端 160 字节列宽直接 400。
+		const relayKey = clampRelayKey(
+			`${agentId}:${req.toolName}:${req.callId ?? "nocall"}`,
+		);
+		const mctx = mailContexts.get(mailSessionID);
+
+		try {
+			// **不传 `to`**：决策人由服务端定（会话 owner → 线索里最近的人类 →
+			// 无人可问则 409）。插件若把来信人当决策人，Agent 之间转派任务时
+			// （A 把活分给 B）权限邮件会发给 Agent 自己 —— Agent 不可能在界面上点
+			// 「同意」，于是下面那个 await 永不 resolve，会话无声挂死。
+			await client.post("/permission/request", {
+				question: `请求执行 ${req.toolName}`,
+				options: ["同意", "拒绝"],
+				context: [
+					`工具：${req.toolName}`,
+					req.callId ? `调用 ID：${req.callId}` : "",
+					req.reason ? `理由：${req.reason}` : "",
+					// 决策人未必是这条会话的参与者（Agent 转派出来的会话，人从没见过它），
+					// 只给工具名无从判断，得说明这活是谁派的、为的什么事（B-8.4）。
+					mctx?.subject ? `触发任务：${mctx.subject}` : "",
+					mctx?.replyTo ? `任务来自：${mctx.replyTo}` : "",
+				]
+					.filter(Boolean)
+					.join("\n"),
+				session_id: mailSessionID,
+				relay_key: relayKey,
+			});
+		} catch (e: any) {
+			// 409 = 服务端已判定这条任务链上没有人类，永远不会有人来点头。
+			//
+			// 不能 `return next()`：下一个 answerer 是本地 UI，而邮件驱动的会话
+			// 根本没有 UI，waterfall 跑到尾以后依旧无人应答 —— 这正是生产事故
+			// 的形状：pi 把任务派给自己的另一条会话，那条要跑 bash，会话永久挂死。
+			//
+			// 直接 denied 并把服务端的建议原文写进日志：模型从工具报错里看到
+			// 拒绝后会自己换方式，而挂死时它连重试的机会都没有。
+			if (e?.status === 409) {
+				const hint = [e?.body?.error, e?.body?.detail, e?.body?.suggestion]
+					.filter(Boolean)
+					.join(" ");
+				console.error(
+					`[dsh-mail-bridge] 权限询问无人可投，当场拒绝 ${relayKey}：${hint}`,
+				);
+				// 把真正的原因存起来，post-execute 会用它换掉 dsh-tools 写死的
+				// 「the user rejected tool X」—— 没有任何用户拒绝过它。
+				noteDenial(
+					agentId,
+					req.callId,
+					[
+						e?.body?.error || `权限询问无法送达：这条任务链上没有人类用户`,
+						e?.body?.detail || "",
+						e?.body?.suggestion || "",
+					]
+						.filter(Boolean)
+						.join("\n"),
+				);
+				// 用 'rejected' 而不是 'denied'：DSH 的 ApprovalOutcome 只认
+				// allowed-once / rejected / cancelled / unavailable，写错了它不报错
+				// 而是归一化成 'unavailable'。
+				return "rejected";
+			}
+
+			// 其余 4xx（400 / 401 / 403 / 404 / 422…）同样永远不会因重试成功，
+			// 不能 `return next()` —— 下一个 answerer 是本地 UI，而邮件驱动的会话
+			// 没有 UI，waterfall 跑到尾仍旧无人应答。
+			// pi 侧实测：relay_key 过长报 400 被当暂时失败让位，
+			// 那条 bash 在无人批准的情况下执行了 —— fail closed 才安全。
+			if (isPermanentFailure(e)) {
+				const hint = [e?.body?.error, e?.body?.detail, e?.body?.suggestion]
+					.filter(Boolean)
+					.join(" ");
+				console.error(
+					`[dsh-mail-bridge] 权限询问遇到永久失败（HTTP ${e?.status}），当场拒绝 ${relayKey}：${hint || e?.message || ""}`,
+				);
+				noteDenial(
+					agentId,
+					req.callId,
+					[
+						`无法把 ${req.toolName} 的授权请求送达给人类（HTTP ${e?.status}）：${e?.body?.error || e?.message || "请求被服务端拒绝"}`,
+						e?.body?.detail || "",
+						e?.body?.suggestion ||
+							"这是一个不会因重试而改变的失败。请改用不需要授权的方式完成，或在回信里说明需要人工执行哪一步。",
+					]
+						.filter(Boolean)
+						.join("\n"),
+				);
+				return "rejected";
+			}
+
+			// 暂时失败（5xx / 408 / 429 / 网络抖动）交给下一个 answerer（本地 UI）。
+			console.error(
+				`[dsh-mail-bridge] 权限询问转发暂时失败: ${e?.message || e}`,
+			);
+			return next();
+		}
+
+		console.error(`[dsh-mail-bridge] 权限询问已转邮件 ${relayKey}`);
+
+		// 等人类决策；DSH 撤销询问（signal abort）时结算为 cancelled。
+		return new Promise<string>((resolve) => {
+			pendingApprovals.set(relayKey, { resolve, sessionId: agentId });
+			req.signal?.addEventListener(
+				"abort",
+				() => {
+					if (pendingApprovals.delete(relayKey)) resolve("cancelled");
+				},
+				{ once: true },
+			);
+		});
+	});
+
+	// ─── 模型主动提问（ask_user_question）→ 转成邮件问人 ───
+	//
+	// 这是**第二个**人机交互 seam，与上面的 approval/request 完全独立：
+	//   - approval/request：危险工具被 DSH 拦下，人批准/拒绝**执行**
+	//   - ask_user_question：模型自己需要确认/选择/补充信息，人**回答问题**
+	//
+	// 原来只桥接了前者。邮件驱动的会话没有本地 UI，而 ask() 的 provider 是
+	// DSH host 注册的本地 UI 实现 —— 在那里等人点选，人永远看不到，
+	// promise 永不 resolve，那一轮工具调用**永久挂死**。
+	//
+	// 为什么拦 `tools/execute` 而不抢注全局 provider：
+	// `ctx.userQuestions.registerProvider` 只允许一个活动 provider（第二个抛
+	// DUPLICATE_PROVIDER），而 DSH host 已经注册了本地 UI 那个；抢注会让平台
+	// 自己的界面失效。around-dispatch 只对**邮件驱动**的会话接管，其余原样交给
+	// 下一个 wrapper / 平台 UI。
+	ctx.on("tools/execute", async (exec: any, next: () => Promise<any>) => {
+		if (exec?.name !== "ask_user_question") return next();
+		const agentId = String(exec?.agent?.id ?? "");
+		if (!agentId || !mailDrivenSessions.has(agentId)) return next();
+		const mailSessionID = reverseMap.get(agentId);
+		if (!mailSessionID) return next();
+
+		const rawQuestions: any[] = Array.isArray(exec?.arguments?.questions)
+			? exec.arguments.questions
+			: [];
+		const relayKey = clampRelayKey(
+			`${agentId}:ask:${exec?.callId ?? "nocall"}`,
+		);
+
+		let flat: {
+			question: string;
+			options: string[];
+			context: string;
+			multiSelect: boolean;
+		};
+		try {
+			flat = flattenQuestions(rawQuestions);
+		} catch (e: any) {
+			// 问题本身不合法（空列表）→ 当场把错误交回模型，不要挂死
+			throw new Error(`ask_user_question 参数不合法：${e?.message || e}`);
+		}
+
+		const mctx = mailContexts.get(mailSessionID);
+		try {
+			await client.post("/permission/request", {
+				question: flat.question,
+				options: flat.options,
+				context: [
+					flat.context,
+					mctx?.subject ? `触发任务：${mctx.subject}` : "",
+					mctx?.replyTo ? `任务来自：${mctx.replyTo}` : "",
+				]
+					.filter(Boolean)
+					.join("\n"),
+				session_id: mailSessionID,
+				relay_key: relayKey,
+				kind: "question",
+				multi_select: flat.multiSelect,
+			});
+		} catch (e: any) {
+			// 与 approval 同一条纪律：不会因重试成功的失败必须**当场报错**，
+			// 不能 `return next()` —— 下一个 answerer 是本地 UI，而邮件驱动的会话
+			// 根本没有 UI，waterfall 跑到尾依旧无人应答 = 挂死。
+			const hint = [e?.body?.error, e?.body?.detail, e?.body?.suggestion]
+				.filter(Boolean)
+				.join(" ");
+			console.error(
+				`[dsh-mail-bridge] 主动提问转发失败（HTTP ${e?.status ?? "?"}）：${hint || e?.message || e}`,
+			);
+			throw new Error(
+				`无法把问题送达给人类（HTTP ${e?.status ?? "?"}）${hint ? `：${hint}` : ""}。` +
+					`请改用不需要人工确认的方式继续，或在最终回复里说明需要人回答什么。`,
+			);
+		}
+
+		console.error(
+			`[dsh-mail-bridge] 主动提问已转邮件 ${relayKey}（kind=question）`,
+		);
+
+		// 等人类回答；DSH 撤销（signal abort）时以错误结算，不装作答过了。
+		const answers = await new Promise<any>((resolve, reject) => {
+			pendingQuestions.set(relayKey, {
+				resolve,
+				reject,
+				questions: rawQuestions,
+				sessionId: agentId,
+			});
+			exec.signal?.addEventListener(
+				"abort",
+				() => {
+					if (pendingQuestions.delete(relayKey)) {
+						reject(new Error("ask_user_question 被取消（人类尚未回答）"));
+					}
+				},
+				{ once: true },
+			);
+		});
+
+		// around-wrapper 返回的 canonical value 就是工具的输出（见 dsh-tools
+		// normalizeDispatchResult：非错误结果取 .value 交给 output.schema 校验）。
+		return { isError: false, value: answers } as any;
+	});
+
+	// 把插件主动拒绝的真正原因递给模型。
+	//
+	// DSH 将 approval/request 的 'rejected' 翻译成写死的
+	// `the user rejected tool "X"`（dsh-tools/lib/index.js）—— 而当插件因为
+	// 「没人可问」或「转发遇 4xx」主动拒绝时，**没有任何用户拒绝过它**。
+	// 模型看到一句不存在的拒绝，只会以为人不同意，不会去换一条路；
+	// 服务端给的 suggestion（换不需要权限的方式 / 在回信里请上游转达）则只进了日志。
+	//
+	// 门禁拒绝的调用也会进 post-execute（pre-execute 的 deny 走
+	// `{kind:"post-result"}` → finalizeScheduledExecution → postExecute），
+	// 而 `{kind:'block', feedback}` 能换掉模型看到的内容 —— 这是 DSH 上
+	// 唯一能把真实原因送到模型眼前的口子。
+	//
+	// pi（`{block:true, reason}`）与 opencode（`output.reason`）的 reason 直达模型，
+	// 不需要这道绕行。
+	ctx.on(
+		"tools/post-execute",
+		async (exec: any, result: any, next: () => Promise<any>) => {
+			const agentId = String(exec?.agent?.id ?? "");
+			if (!agentId || !mailDrivenSessions.has(agentId)) return next();
+			// 只管失败的结果：成功的调用不可能是被我们拒绝的那一次。
+			if (!result?.isError) return next();
+
+			const reason = takeDenial(agentId, exec?.callId);
+			if (!reason) return next();
+
+			console.error(`[dsh-mail-bridge] 已把拒绝原因递给模型（${exec?.name}）`);
+			return {
+				kind: "block",
+				feedback: [
+					{
+						type: "text",
+						text: `无法执行 ${exec?.name}：${reason}`,
+					},
+				],
+			};
+		},
+	);
+
+	/** 人类决策回来：先看是不是在等的那个问题/approval，否则当普通通知投给会话。 */
+	function handlePermissionDecision(data: any): void {
+		const relayKey = String(data?.relay_key ?? "");
+
+		// 主动提问的回答与权限审批的结构不同（answers[] vs ApprovalOutcome），
+		// 必须分开结算。用 relay_key 查而不是信 data.kind：键本身已经唯一。
+		const pendingQ = relayKey ? pendingQuestions.get(relayKey) : undefined;
+		if (pendingQ) {
+			pendingQuestions.delete(relayKey);
+			const decision = String(data?.decision ?? "");
+			const note = data?.note;
+			if (isBlankAnswer(pendingQ.questions, decision, note)) {
+				// 空回答不能当作「答了」：模型会拿到一个什么都没说的结果继续跑。
+				pendingQ.reject(
+					new Error("人类提交了空回答；请重新提问或改用不需要回答的方式继续。"),
+				);
+				console.error(
+					`[dsh-mail-bridge] 主动提问 ${relayKey} 收到空回答，已拒绝`,
+				);
+				return;
+			}
+			try {
+				pendingQ.resolve(
+					answersFromDecision(pendingQ.questions, decision, note),
+				);
+				console.error(`[dsh-mail-bridge] 主动提问 ${relayKey} 已回答`);
+			} catch (e: any) {
+				pendingQ.reject(new Error(`回答解析失败：${e?.message || e}`));
+			}
+			return;
+		}
+
+		const pending = relayKey ? pendingApprovals.get(relayKey) : undefined;
+		if (pending) {
+			pendingApprovals.delete(relayKey);
+			// AgentMail 的选项文本 → DSH 的 ApprovalOutcome。
+			// 只有“同意”才放行，其余（包括认不出的选项）一律 fail closed。
+			//
+			// **DSH 不提供「一直同意」**：它的 ApprovalOutcome 只有
+			// allowed-once / rejected / cancelled / unavailable，没有 always 语义
+			// （见 @deepseek-ai/dsh-user-approval 的类型定义）。桥自己记免批的话，
+			// DSH 侧仍会每次调 approval/request，而桥直接答 allowed-once ——
+			// 那等于用插件内存覆盖平台的审批策略，且这份策略没人能审计。
+			// 因此这里的选项只有两个（见上面的 options），isApproval 就够用。
+			const decision = String(data?.decision ?? "");
+			const outcome = isApproval(decision) ? "allowed-once" : "rejected";
+			pending.resolve(outcome);
+			ctx.logger.info(`[dsh-mail-bridge] 权限决策 ${relayKey} -> ${outcome}`);
+			return;
+		}
+		// 没在等（插件重启后丢了 pendingApprovals，或历史数据）→ 当一封通知投进会话。
+		deliverMail(data, "permission").catch((e: any) =>
+			ctx.logger.error(
+				`[dsh-mail-bridge] 权限决策投递失败: ${e?.message || e}`,
+			),
+		);
+	}
+
+	// ─── 启动 SSE（与 opencode-mail-bridge 相同的事件处理）───
+
+	ctx.effect(() => {
+		startSSE((type, data) => {
+			switch (type) {
+				case "new_mail":
+					if (data?.mail_id) deliveredMails.add(data.mail_id);
+					deliverMail(data, "mail")
+						.then(({ sessionID, reused }) => {
+							console.error(
+								`[dsh-mail-bridge] ${type} -> ${reused ? "续谈" : "新会话"} ${sessionID}`,
+							);
+						})
+						.catch((e: any) => {
+							// console.error 而不是 ctx.logger：DSH 的 logger 不进 journalctl，
+							// 而投递失败是「发件人等不到回信」的唯一线索。
+							console.error(
+								`[dsh-mail-bridge] ${type} 处理失败（mail ${data?.mail_id || "?"}）: ${e?.message || e}`,
+							);
+						});
+					break;
+				case "permission_decision":
+					handlePermissionDecision(data);
+					break;
+				case "session_update": {
+					// 人类在 WebUI 切换权限档位后，DSH 运行时必须立刻更新 sandbox/mode +
+					// approval/policy，否则模型仍按旧档位执行。
+					const sid = String(data?.session_id || "");
+					const pm = String(data?.permission_mode || "");
+					if (!sid || !pm) break;
+					const found = findLiveDshSession(sid);
+					if (!found) {
+						// 会话不在运行（插件重启后尚未收到新邮件、或从未投过）。
+						// 无需处理：下次投递时 deliverMail 会按邮件里带的 permission_mode
+						// 重新 applyPermissionMode，档位不会丢。
+						break;
+					}
+					applyPermissionMode(found.agent?.session, pm);
+					console.error(
+						`[dsh-mail-bridge] session_update ${sid} -> 权限档位 ${pm}（会话 ${found.id}）`,
+					);
+					break;
+				}
+				case "session_archived":
+					// 会话归档 = 那条会话再也不会收信，映射可以确定性地清掉（不必等上限淘汰）。
+					forgetSession(String(data?.session_id || ""));
+					break;
+			}
+		});
+		return () => {
+			sseClient?.stop?.();
+			sseClient = null;
+			// 拆插件时没人再能回答待决询问，一律 fail closed，
+			// 否则 DSH 侧那些 await 永远不会返回。
+			for (const [key, pending] of pendingApprovals) {
+				pending.resolve("unavailable");
+				pendingApprovals.delete(key);
+			}
+			// 主动提问没有「unavailable」这种返回值，只能以错误结算。
+			for (const [key, pending] of pendingQuestions) {
+				pending.reject(new Error("邮件桥已卸载，无法再接收回答"));
+				pendingQuestions.delete(key);
+			}
+		};
+	}, "dsh-mail-bridge.sse");
 }
diff --git a/plugins/dsh-mail-bridge/test/mail-session-id.test.mjs b/plugins/dsh-mail-bridge/test/mail-session-id.test.mjs
index 148083a..78a6a48 100644
--- a/plugins/dsh-mail-bridge/test/mail-session-id.test.mjs
+++ b/plugins/dsh-mail-bridge/test/mail-session-id.test.mjs
@@ -6,59 +6,69 @@
  * 运行时仍按旧档位执行 —— 人以为自己收紧了权限。
  */
 
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
+import { test } from "node:test";
+import assert from "node:assert/strict";
 
 import {
-  dshSessionIdForMail,
-  matchesMailSession,
-  pickMailSession,
-} from '../lib/mail-session-id.js';
+	dshSessionIdForMail,
+	matchesMailSession,
+	pickMailSession,
+} from "../lib/mail-session-id.js";
 
-test('首次尝试的 id 是 mail-<邮件会话 id>', () => {
-  assert.equal(dshSessionIdForMail('abc-123'), 'mail-abc-123');
+test("首次尝试的 id 是 mail-<邮件会话 id>", () => {
+	assert.equal(dshSessionIdForMail("abc-123"), "mail-abc-123");
 });
 
-test('匹配首次尝试的 id', () => {
-  assert.equal(matchesMailSession('mail-abc', 'abc'), true);
+test("匹配首次尝试的 id", () => {
+	assert.equal(matchesMailSession("mail-abc", "abc"), true);
 });
 
-test('匹配模型降级重试的 -r<i>', () => {
-  assert.equal(matchesMailSession('mail-abc-r1', 'abc'), true);
-  assert.equal(matchesMailSession('mail-abc-r12', 'abc'), true);
+test("匹配模型降级重试的 -r<i>", () => {
+	assert.equal(matchesMailSession("mail-abc-r1", "abc"), true);
+	assert.equal(matchesMailSession("mail-abc-r12", "abc"), true);
 });
 
-test('不匹配别的会话（前缀相同也不行）', () => {
-  assert.equal(matchesMailSession('mail-abcdef', 'abc'), false, 'mail-abc 的前缀不能吃掉 mail-abcdef');
-  assert.equal(matchesMailSession('mail-abd', 'abc'), false);
-  assert.equal(matchesMailSession('other-abc', 'abc'), false);
-  assert.equal(matchesMailSession('', 'abc'), false);
+test("不匹配别的会话（前缀相同也不行）", () => {
+	assert.equal(
+		matchesMailSession("mail-abcdef", "abc"),
+		false,
+		"mail-abc 的前缀不能吃掉 mail-abcdef",
+	);
+	assert.equal(matchesMailSession("mail-abd", "abc"), false);
+	assert.equal(matchesMailSession("other-abc", "abc"), false);
+	assert.equal(matchesMailSession("", "abc"), false);
 });
 
-test('不匹配非数字后缀（避免误吞其它会话）', () => {
-  assert.equal(matchesMailSession('mail-abc-rx', 'abc'), false);
-  assert.equal(matchesMailSession('mail-abc-r', 'abc'), false);
-  assert.equal(matchesMailSession('mail-abc-retry', 'abc'), false);
+test("不匹配非数字后缀（避免误吞其它会话）", () => {
+	assert.equal(matchesMailSession("mail-abc-rx", "abc"), false);
+	assert.equal(matchesMailSession("mail-abc-r", "abc"), false);
+	assert.equal(matchesMailSession("mail-abc-retry", "abc"), false);
 });
 
-test('pickMailSession 优先首次尝试，而不是数组顺序', () => {
-  // 数组顺序可能来自 ctx.agents.list()，与尝试顺序无关
-  assert.equal(pickMailSession(['mail-abc-r2', 'mail-abc-r1', 'mail-abc'], 'abc'), 'mail-abc');
+test("pickMailSession 优先首次尝试，而不是数组顺序", () => {
+	// 数组顺序可能来自 ctx.agents.list()，与尝试顺序无关
+	assert.equal(
+		pickMailSession(["mail-abc-r2", "mail-abc-r1", "mail-abc"], "abc"),
+		"mail-abc",
+	);
 });
 
-test('pickMailSession 没有首次尝试时取序号最小的重试', () => {
-  assert.equal(pickMailSession(['mail-abc-r3', 'mail-abc-r1', 'mail-abc-r2'], 'abc'), 'mail-abc-r1');
+test("pickMailSession 没有首次尝试时取序号最小的重试", () => {
+	assert.equal(
+		pickMailSession(["mail-abc-r3", "mail-abc-r1", "mail-abc-r2"], "abc"),
+		"mail-abc-r1",
+	);
 });
 
-test('pickMailSession 找不到时返回 undefined（调用方据此跳过）', () => {
-  assert.equal(pickMailSession(['other-1', 'mail-def'], 'abc'), undefined);
-  assert.equal(pickMailSession([], 'abc'), undefined);
-  assert.equal(pickMailSession(undefined, 'abc'), undefined);
+test("pickMailSession 找不到时返回 undefined（调用方据此跳过）", () => {
+	assert.equal(pickMailSession(["other-1", "mail-def"], "abc"), undefined);
+	assert.equal(pickMailSession([], "abc"), undefined);
+	assert.equal(pickMailSession(undefined, "abc"), undefined);
 });
 
-test('接管的平台会话推不出 id：不能被误判成邮件会话', () => {
-  // 平台自己生成的 id（如 DSH 界面里开的会话）与邮件会话无关，
-  // 匹配函数必须说「不是」，否则会给错误的会话改档位。
-  assert.equal(matchesMailSession('session-7f3a91', 'abc'), false);
-  assert.equal(pickMailSession(['session-7f3a91'], 'abc'), undefined);
+test("接管的平台会话推不出 id：不能被误判成邮件会话", () => {
+	// 平台自己生成的 id（如 DSH 界面里开的会话）与邮件会话无关，
+	// 匹配函数必须说「不是」，否则会给错误的会话改档位。
+	assert.equal(matchesMailSession("session-7f3a91", "abc"), false);
+	assert.equal(pickMailSession(["session-7f3a91"], "abc"), undefined);
 });
diff --git a/plugins/dsh-mail-bridge/test/sse-client.test.mjs b/plugins/dsh-mail-bridge/test/sse-client.test.mjs
index 0ee5781..05095a0 100644
--- a/plugins/dsh-mail-bridge/test/sse-client.test.mjs
+++ b/plugins/dsh-mail-bridge/test/sse-client.test.mjs
@@ -9,121 +9,132 @@
  * 生产上表现为「新邮件偶尔收不到」「权限决策点了没反应」，且日志里一个字都没有。
  */
 
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
+import { test } from "node:test";
+import assert from "node:assert/strict";
 
-import { createFrameParser } from '../lib/sse-client.js';
+import { createFrameParser } from "../lib/sse-client.js";
 
 /** JSON.parse 的测试包装：解析失败让断言带原文失败，而不是抛未捕获异常。 */
 function parse(s) {
-  try {
-    return JSON.parse(s);
-  } catch (e) {
-    assert.fail(`不是合法 JSON: ${s}（${e.message}）`);
-  }
+	try {
+		return JSON.parse(s);
+	} catch (e) {
+		assert.fail(`不是合法 JSON: ${s}（${e.message}）`);
+	}
 }
 
-test('完整帧一次喂入：正常解析', () => {
-  const p = createFrameParser();
-  const events = p.push('id: 7\nevent: new_mail\ndata: {"mail_id":"m1"}\n\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
-  assert.deepEqual(parse(events[0].data), { mail_id: 'm1' });
-  assert.equal(events[0].id, '7');
-  assert.equal(p.lastEventId(), '7');
+test("完整帧一次喂入：正常解析", () => {
+	const p = createFrameParser();
+	const events = p.push('id: 7\nevent: new_mail\ndata: {"mail_id":"m1"}\n\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
+	assert.deepEqual(parse(events[0].data), { mail_id: "m1" });
+	assert.equal(events[0].id, "7");
+	assert.equal(p.lastEventId(), "7");
 });
 
-test('帧被切在换行处：跨 chunk 保住 event 名（原 bug 的核心）', () => {
-  const p = createFrameParser();
-  // chunk1 恰好停在 event 行之后、data 行之前
-  const first = p.push('id: 12\nevent: content_delta\n');
-  assert.deepEqual(first, [], '半帧不该派发');
+test("帧被切在换行处：跨 chunk 保住 event 名（原 bug 的核心）", () => {
+	const p = createFrameParser();
+	// chunk1 恰好停在 event 行之后、data 行之前
+	const first = p.push("id: 12\nevent: content_delta\n");
+	assert.deepEqual(first, [], "半帧不该派发");
 
-  const second = p.push('data: {"x":1}\n\n');
-  assert.equal(second.length, 1, '跨 chunk 的半帧必须被拼回完整事件，而不是丢弃');
-  assert.equal(second[0].event, 'content_delta');
-  assert.equal(p.lastEventId(), '12');
+	const second = p.push('data: {"x":1}\n\n');
+	assert.equal(
+		second.length,
+		1,
+		"跨 chunk 的半帧必须被拼回完整事件，而不是丢弃",
+	);
+	assert.equal(second[0].event, "content_delta");
+	assert.equal(p.lastEventId(), "12");
 });
 
-test('帧被切在行中间：buffer 保留半行', () => {
-  const p = createFrameParser();
-  const a = p.push('event: new_ma');
-  assert.deepEqual(a, []);
-  const b = p.push('il\ndata: {"mail_id":"m9"}\n\n');
-  assert.equal(b.length, 1);
-  assert.equal(b[0].event, 'new_mail');
+test("帧被切在行中间：buffer 保留半行", () => {
+	const p = createFrameParser();
+	const a = p.push("event: new_ma");
+	assert.deepEqual(a, []);
+	const b = p.push('il\ndata: {"mail_id":"m9"}\n\n');
+	assert.equal(b.length, 1);
+	assert.equal(b[0].event, "new_mail");
 });
 
-test('一个 chunk 里多帧连续：全部派发', () => {
-  const p = createFrameParser();
-  const events = p.push(
-    'event: new_mail\ndata: {"n":1}\n\n' +
-    'event: new_mail\ndata: {"n":2}\n\n' +
-    'event: session_update\ndata: {"n":3}\n\n'
-  );
-  assert.equal(events.length, 3);
-  assert.deepEqual(events.map((e) => e.event), ['new_mail', 'new_mail', 'session_update']);
+test("一个 chunk 里多帧连续：全部派发", () => {
+	const p = createFrameParser();
+	const events = p.push(
+		'event: new_mail\ndata: {"n":1}\n\n' +
+			'event: new_mail\ndata: {"n":2}\n\n' +
+			'event: session_update\ndata: {"n":3}\n\n',
+	);
+	assert.equal(events.length, 3);
+	assert.deepEqual(
+		events.map((e) => e.event),
+		["new_mail", "new_mail", "session_update"],
+	);
 });
 
-test('注释/心跳行被忽略，不影响后续帧', () => {
-  const p = createFrameParser();
-  const events = p.push(': heartbeat\n\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
+test("注释/心跳行被忽略，不影响后续帧", () => {
+	const p = createFrameParser();
+	const events = p.push(': heartbeat\n\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
 });
 
-test('多行 data 用换行拼接', () => {
-  const p = createFrameParser();
-  const events = p.push('event: x\ndata: line1\ndata: line2\n\n');
-  assert.equal(events[0].data, 'line1\nline2');
+test("多行 data 用换行拼接", () => {
+	const p = createFrameParser();
+	const events = p.push("event: x\ndata: line1\ndata: line2\n\n");
+	assert.equal(events[0].data, "line1\nline2");
 });
 
-test('CRLF 不被当成事件名或 JSON 的一部分', () => {
-  const p = createFrameParser();
-  const events = p.push('id: 3\r\nevent: new_mail\r\ndata: {"n":1}\r\n\r\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
-  assert.equal(events[0].id, '3');
-  assert.deepEqual(parse(events[0].data), { n: 1 });
+test("CRLF 不被当成事件名或 JSON 的一部分", () => {
+	const p = createFrameParser();
+	const events = p.push('id: 3\r\nevent: new_mail\r\ndata: {"n":1}\r\n\r\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
+	assert.equal(events[0].id, "3");
+	assert.deepEqual(parse(events[0].data), { n: 1 });
 });
 
-test('事件 id 只向前推进：重放旧 id 不回退断点', () => {
-  const p = createFrameParser();
-  p.push('id: 10\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '10');
-  // 服务端重放一条更早的事件：断点不该退回 5，否则下次重连会重复回放 6..10
-  p.push('id: 5\nevent: new_mail\ndata: {"n":0}\n\n');
-  assert.equal(p.lastEventId(), '5', '解析器如实记录当前 id（是否回退由使用方决定）');
+test("事件 id 只向前推进：重放旧 id 不回退断点", () => {
+	const p = createFrameParser();
+	p.push('id: 10\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "10");
+	// 服务端重放一条更早的事件：断点不该退回 5，否则下次重连会重复回放 6..10
+	p.push('id: 5\nevent: new_mail\ndata: {"n":0}\n\n');
+	assert.equal(
+		p.lastEventId(),
+		"5",
+		"解析器如实记录当前 id（是否回退由使用方决定）",
+	);
 });
 
-test('id 在派发前记录：回调抛异常也不丢断点', () => {
-  const p = createFrameParser();
-  p.push('id: 42\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '42');
+test("id 在派发前记录：回调抛异常也不丢断点", () => {
+	const p = createFrameParser();
+	p.push('id: 42\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "42");
 });
 
-test('只有 data 没有 event 不派发（避免把心跳数据当事件）', () => {
-  const p = createFrameParser();
-  const events = p.push('data: {"orphan":true}\n\n');
-  assert.deepEqual(events, []);
+test("只有 data 没有 event 不派发（避免把心跳数据当事件）", () => {
+	const p = createFrameParser();
+	const events = p.push('data: {"orphan":true}\n\n');
+	assert.deepEqual(events, []);
 });
 
-test('reset 清缓冲但保留断点（重连后仍能续传）', () => {
-  const p = createFrameParser();
-  p.push('id: 99\nevent: a\ndata: {"n":1}\n\n');
-  p.push('event: partial');   // 半帧
-  p.reset();
-  assert.equal(p.lastEventId(), '99', '断点必须保留，否则重连从头回放');
-  // reset 后半帧不该复活
-  const after = p.push('data: {"n":2}\n\n');
-  assert.deepEqual(after, []);
+test("reset 清缓冲但保留断点（重连后仍能续传）", () => {
+	const p = createFrameParser();
+	p.push('id: 99\nevent: a\ndata: {"n":1}\n\n');
+	p.push("event: partial"); // 半帧
+	p.reset();
+	assert.equal(p.lastEventId(), "99", "断点必须保留，否则重连从头回放");
+	// reset 后半帧不该复活
+	const after = p.push('data: {"n":2}\n\n');
+	assert.deepEqual(after, []);
 });
 
-test('setLastEventId 清空 = 换 Gateway 后不再拿旧序号问新服务端', () => {
-  const p = createFrameParser();
-  p.push('id: 123\nevent: a\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '123');
-  // connect_to_server 换了坐标：旧序号属于旧 Gateway 的环形缓冲，必须丢掉
-  p.setLastEventId('');
-  assert.equal(p.lastEventId(), '', '首次连接不得携带 Last-Event-ID');
+test("setLastEventId 清空 = 换 Gateway 后不再拿旧序号问新服务端", () => {
+	const p = createFrameParser();
+	p.push('id: 123\nevent: a\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "123");
+	// connect_to_server 换了坐标：旧序号属于旧 Gateway 的环形缓冲，必须丢掉
+	p.setLastEventId("");
+	assert.equal(p.lastEventId(), "", "首次连接不得携带 Last-Event-ID");
 });
diff --git a/plugins/opencode-mail-bridge/index.js b/plugins/opencode-mail-bridge/index.js
index 0e7574e..dfe3a6e 100644
--- a/plugins/opencode-mail-bridge/index.js
+++ b/plugins/opencode-mail-bridge/index.js
@@ -1,5 +1,11 @@
 import { z } from "zod";
-import { readFileSync, writeFileSync, mkdirSync, existsSync, statSync } from "node:fs";
+import {
+	readFileSync,
+	writeFileSync,
+	mkdirSync,
+	existsSync,
+	statSync,
+} from "node:fs";
 import { randomBytes } from "node:crypto";
 import { homedir } from "node:os";
 import { join, dirname, basename } from "node:path";
@@ -9,42 +15,59 @@ import { snapshotOpencodeSessions } from "./lib/session-snapshot.js";
 import { resolveWorkspaceCwd } from "./lib/workspace.js";
 import { selectCatchup } from "./lib/catchup.js";
 import {
-  snapshotOpencodeModels,
-  modelAttemptOrder,
-  renderFailureReport,
+	snapshotOpencodeModels,
+	modelAttemptOrder,
+	renderFailureReport,
 } from "./lib/model-scope.js";
 import {
-  renderInbox,
-  idsToMarkRead,
-  formatSize,
-  DEFAULT_INBOX_STATUS,
-  DEFAULT_INBOX_LIMIT,
+	renderInbox,
+	idsToMarkRead,
+	formatSize,
+	DEFAULT_INBOX_STATUS,
+	DEFAULT_INBOX_LIMIT,
 } from "./lib/inbox-format.js";
 import {
-  renderNameSuggestions,
-  renderPathSuggestions,
-  renderSessionSuggestions,
-  renderParticipants,
-  renderContacts,
-  renderThread,
+	renderNameSuggestions,
+	renderPathSuggestions,
+	renderSessionSuggestions,
+	renderParticipants,
+	renderContacts,
+	renderThread,
 } from "./lib/discovery.js";
 import {
-  explicitSends,
-  noteExplicitSend,
-  shouldSkipAutoRelay,
+	explicitSends,
+	noteExplicitSend,
+	shouldSkipAutoRelay,
 } from "./lib/relay-dedup.js";
 import { adoptedSessionID, adoptMissingMessage } from "./lib/adopt.js";
-import { autoRelayDecision, replyInstruction, inboundHeadline } from "./lib/relay-policy.js";
+import {
+	autoRelayDecision,
+	replyInstruction,
+	inboundHeadline,
+} from "./lib/relay-policy.js";
 import { clampRelayKey, isPermanentFailure } from "./lib/relay-key.js";
-import { BoundedMap, BoundedSet, MAX_TRACKED_MAILS, MAX_TRACKED_SESSIONS } from "./lib/bounded.js";
-import { appendRenameProposal, renameProposalNote } from "./lib/rename-proposal.js";
+import {
+	BoundedMap,
+	BoundedSet,
+	MAX_TRACKED_MAILS,
+	MAX_TRACKED_SESSIONS,
+} from "./lib/bounded.js";
+import {
+	appendRenameProposal,
+	renameProposalNote,
+} from "./lib/rename-proposal.js";
 import { createSSEClient } from "./lib/sse-client.js";
 // opencode 原生支持三态权限，免批由它自己记（response:"always"），
 // 所以这里只借用决策文本的判定，不需要 createGrantStore。
 import { isAlwaysDecision, isApproval } from "./lib/permission-grants.js";
-import { opencodePermissions, normalizeMode, modeBriefing } from "./lib/permission-mode.js";
+import {
+	opencodePermissions,
+	normalizeMode,
+	modeBriefing,
+} from "./lib/permission-mode.js";
 
-const GATEWAY_URL = process.env.AGENTMAIL_GATEWAY_URL || "http://127.0.0.1:8180";
+const GATEWAY_URL =
+	process.env.AGENTMAIL_GATEWAY_URL || "http://127.0.0.1:8180";
 const AGENT_NAME = process.env.AGENTMAIL_AGENT_NAME || "opencode";
 // 收到邮件后自动开会话处理时使用的模型
 const REPLY_PROVIDER = process.env.AGENTMAIL_REPLY_PROVIDER || "llmsproxy";
@@ -57,7 +80,8 @@ const REPLY_MODEL = process.env.AGENTMAIL_REPLY_MODEL || "AUTO";
 //   2. ~/.agentmail/agent.key（首次安装时本地生成并落盘）
 // 没有密钥时退回旧的 name/secret 方式，保证老配置不被这次改动打断。
 
-const CONFIG_DIR = process.env.AGENTMAIL_CONFIG_DIR || join(homedir(), ".agentmail");
+const CONFIG_DIR =
+	process.env.AGENTMAIL_CONFIG_DIR || join(homedir(), ".agentmail");
 const KEY_FILE = join(CONFIG_DIR, "agent.key");
 const CONFIG_FILE = join(CONFIG_DIR, "config.json");
 
@@ -65,46 +89,62 @@ const AGENT_SECRET = process.env.AGENTMAIL_AGENT_SECRET || "";
 
 /** 读取本地密钥文件；不存在或损坏时返回 null。 */
 function readLocalKey() {
-  try {
-    if (!existsSync(KEY_FILE)) return null;
-    const raw = JSON.parse(readFileSync(KEY_FILE, "utf8"));
-    return typeof raw?.key_token === "string" && raw.key_token ? raw.key_token : null;
-  } catch {
-    return null;
-  }
+	try {
+		if (!existsSync(KEY_FILE)) return null;
+		const raw = JSON.parse(readFileSync(KEY_FILE, "utf8"));
+		return typeof raw?.key_token === "string" && raw.key_token
+			? raw.key_token
+			: null;
+	} catch {
+		return null;
+	}
 }
 
 /** 首次安装时本地生成密钥并落盘（0600）。 */
 function generateLocalKey() {
-  const token = randomBytes(32).toString("hex");
-  mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-  writeFileSync(
-    KEY_FILE,
-    JSON.stringify({ key_token: token, created_at: new Date().toISOString() }, null, 2),
-    { mode: 0o600 }
-  );
-  console.error(`[mail-bridge] 已在 ${KEY_FILE} 生成本地密钥。`);
-  console.error(`[mail-bridge] 该密钥需管理员在 AgentMail 后台登记后才能接入：`);
-  console.error(`[mail-bridge]   ${token}`);
-  return token;
+	const token = randomBytes(32).toString("hex");
+	mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+	writeFileSync(
+		KEY_FILE,
+		JSON.stringify(
+			{ key_token: token, created_at: new Date().toISOString() },
+			null,
+			2,
+		),
+		{ mode: 0o600 },
+	);
+	console.error(`[mail-bridge] 已在 ${KEY_FILE} 生成本地密钥。`);
+	console.error(
+		`[mail-bridge] 该密钥需管理员在 AgentMail 后台登记后才能接入：`,
+	);
+	console.error(`[mail-bridge]   ${token}`);
+	return token;
 }
 
 /** 把 gateway 地址与密钥记到 config.json，便于换机时人工核对。 */
 function saveConfig(extra) {
-  try {
-    mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-    let cur = {};
-    if (existsSync(CONFIG_FILE)) {
-      try { cur = JSON.parse(readFileSync(CONFIG_FILE, "utf8")); } catch { /* 损坏就重写 */ }
-    }
-    writeFileSync(
-      CONFIG_FILE,
-      JSON.stringify({ ...cur, gateway_url: GATEWAY_URL, agent_name: AGENT_NAME, ...extra }, null, 2),
-      { mode: 0o600 }
-    );
-  } catch (e) {
-    console.error("[mail-bridge] 写 config.json 失败:", e?.message || e);
-  }
+	try {
+		mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+		let cur = {};
+		if (existsSync(CONFIG_FILE)) {
+			try {
+				cur = JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
+			} catch {
+				/* 损坏就重写 */
+			}
+		}
+		writeFileSync(
+			CONFIG_FILE,
+			JSON.stringify(
+				{ ...cur, gateway_url: GATEWAY_URL, agent_name: AGENT_NAME, ...extra },
+				null,
+				2,
+			),
+			{ mode: 0o600 },
+		);
+	} catch (e) {
+		console.error("[mail-bridge] 写 config.json 失败:", e?.message || e);
+	}
 }
 
 // 当前生效的密钥：环境变量 > 本地文件 > 无（退回 name/secret）
@@ -112,238 +152,287 @@ let AGENT_KEY = process.env.AGENTMAIL_AGENT_KEY || readLocalKey() || "";
 
 /** 认证头：有密钥走 Bearer，否则退回 name/secret。 */
 function authHeaders() {
-  if (AGENT_KEY) {
-    return { Authorization: `Bearer ${AGENT_KEY}`, "X-Agent-Name": AGENT_NAME };
-  }
-  return { "X-Agent-Name": AGENT_NAME, "X-Agent-Secret": AGENT_SECRET };
+	if (AGENT_KEY) {
+		return { Authorization: `Bearer ${AGENT_KEY}`, "X-Agent-Name": AGENT_NAME };
+	}
+	return { "X-Agent-Name": AGENT_NAME, "X-Agent-Secret": AGENT_SECRET };
 }
 
 // ─── HTTP ───
 
 async function apiGet(path) {
-  const res = await fetch(`${GATEWAY_URL}/api/v1${path}`, { headers: authHeaders() });
-  if (!res.ok) throw new Error(`GET ${path} failed: ${res.status}`);
-  return res.json();
+	const res = await fetch(`${GATEWAY_URL}/api/v1${path}`, {
+		headers: authHeaders(),
+	});
+	if (!res.ok) throw new Error(`GET ${path} failed: ${res.status}`);
+	return res.json();
 }
 
 async function apiPost(path, body) {
-  const res = await fetch(`${GATEWAY_URL}/api/v1${path}`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json", ...authHeaders() },
-    body: JSON.stringify(body),
-  });
-  const data = await res.json().catch(() => ({}));
-  if (!res.ok) {
-    // 把状态码与响应体挂在 error 上：调用方需要区分「暂时失败」与
-    // 「永远不会成功」。具体例子：权限询问碰到 409（任务链上没有人类）
-    // 必须当场 deny，而 502 应该保持 ask 等重试 —— 只看 message 字符串
-    // 分不出这两种，于是两种都会被当成后者，而前者会永久挂住会话。
-    const err = new Error(data.error || `POST ${path} failed: ${res.status}`);
-    err.status = res.status;
-    err.body = data;
-    throw err;
-  }
-  return data;
+	const res = await fetch(`${GATEWAY_URL}/api/v1${path}`, {
+		method: "POST",
+		headers: { "Content-Type": "application/json", ...authHeaders() },
+		body: JSON.stringify(body),
+	});
+	const data = await res.json().catch(() => ({}));
+	if (!res.ok) {
+		// 把状态码与响应体挂在 error 上：调用方需要区分「暂时失败」与
+		// 「永远不会成功」。具体例子：权限询问碰到 409（任务链上没有人类）
+		// 必须当场 deny，而 502 应该保持 ask 等重试 —— 只看 message 字符串
+		// 分不出这两种，于是两种都会被当成后者，而前者会永久挂住会话。
+		const err = new Error(data.error || `POST ${path} failed: ${res.status}`);
+		err.status = res.status;
+		err.body = data;
+		throw err;
+	}
+	return data;
 }
 
 // 把 opencode 侧的会话标题/slug 回写到 AgentMail。
 // opencode 会在首轮对话后由模型生成会话标题，并配一个短 slug（如 jolly-cactus）——
 // 不在 AgentMail 侧另造一套命名，平台那边叫什么，这边的 session_alias 就叫什么。
 async function syncSessionNaming(mailSessionID, { alias, title }) {
-  if (!mailSessionID) return null;
-  if (!alias && !title) return null;
-  try {
-    const res = await apiPost(`/sessions/${mailSessionID}/sync`, {
-      alias: alias || "",
-      title: title || "",
-    });
-    return res;
-  } catch (e) {
-    // 同步是后台润色，失败不该影响邮件主流程，但必须留痕
-    console.error("[mail-bridge] 会话命名同步失败:", e?.message || e);
-    return null;
-  }
+	if (!mailSessionID) return null;
+	if (!alias && !title) return null;
+	try {
+		const res = await apiPost(`/sessions/${mailSessionID}/sync`, {
+			alias: alias || "",
+			title: title || "",
+		});
+		return res;
+	} catch (e) {
+		// 同步是后台润色，失败不该影响邮件主流程，但必须留痕
+		console.error("[mail-bridge] 会话命名同步失败:", e?.message || e);
+		return null;
+	}
 }
 
 // ─── Tools（直接用 zod 定义，不依赖 @opencode-ai/plugin） ───
 
 const sendMailTool = {
-  description: "发送邮件。三维地址 name@path.session：省略 session 投递到默认会话，.new 强制新建会话，.具体别名 必须是已存在的会话（否则无法送达）。回复来信请传 reply_to。",
-  args: {
-    to: z.string().describe("收件人：name / name@path（默认会话）/ name@path.new（新建）/ name@path.别名（已有会话）"),
-    subject: z.string().describe("邮件主题"),
-    body: z.string().describe("邮件正文（Markdown）"),
-    cc: z.string().optional().describe("抄送，逗号分隔多个三维地址"),
-    reply_to: z.string().optional().describe("回复某封邮件时传其 mail_id，回信会落回同一会话"),
-    session_alias: z.string().optional().describe("仅在用 .new 新建会话时生效：给新会话命名，之后可用 name@path.<别名> 续谈。别名全局唯一，不可含 . / @ 空白，不可为 new"),
-    attachment_ids: z.array(z.string()).optional().describe("附件 ID 列表，先用 upload_attachment 上传取得"),
-    propose_alias: z.string()
-      .optional()
-      .describe(
-        "建议把当前会话改名成这个别名（例如摸清问题后从 witty-planet 改成 fix-login-leak）。" +
-        "这只是建议：别名是人的寻址入口，实际改名由用户在界面上确认。不可含 . / @ 空白，不可为 new"
-      ),
-    propose_reason: z.string().optional().describe("改名理由，一句话，展示给用户看"),
-  },
-  // context 带 sessionID：用它记下「模型这一轮亲手发过信」，
-  // 让 session.idle 的自动转发让位，避免同一件事发两封。
-  async execute(args, context) {
-    // 改名建议以 HTML 注释形式附在正文末尾，由网关解析后剥离。
-    // 标记格式是服务端正则的镜像，因此拼接收在 lib/rename-proposal.js
-    // （三平台共用）—— 各写一遍的话少个空格就静默失效：邮件照常发出，
-    // 提议凭空消失，而模型以为自己提过了。
-    const { body, proposed } = appendRenameProposal(
-      args.body, args.propose_alias, args.propose_reason);
+	description:
+		"发送邮件。三维地址 name@path.session：省略 session 投递到默认会话，.new 强制新建会话，.具体别名 必须是已存在的会话（否则无法送达）。回复来信请传 reply_to。",
+	args: {
+		to: z
+			.string()
+			.describe(
+				"收件人：name / name@path（默认会话）/ name@path.new（新建）/ name@path.别名（已有会话）",
+			),
+		subject: z.string().describe("邮件主题"),
+		body: z.string().describe("邮件正文（Markdown）"),
+		cc: z.string().optional().describe("抄送，逗号分隔多个三维地址"),
+		reply_to: z
+			.string()
+			.optional()
+			.describe("回复某封邮件时传其 mail_id，回信会落回同一会话"),
+		session_alias: z
+			.string()
+			.optional()
+			.describe(
+				"仅在用 .new 新建会话时生效：给新会话命名，之后可用 name@path.<别名> 续谈。别名全局唯一，不可含 . / @ 空白，不可为 new",
+			),
+		attachment_ids: z
+			.array(z.string())
+			.optional()
+			.describe("附件 ID 列表，先用 upload_attachment 上传取得"),
+		propose_alias: z
+			.string()
+			.optional()
+			.describe(
+				"建议把当前会话改名成这个别名（例如摸清问题后从 witty-planet 改成 fix-login-leak）。" +
+					"这只是建议：别名是人的寻址入口，实际改名由用户在界面上确认。不可含 . / @ 空白，不可为 new",
+			),
+		propose_reason: z
+			.string()
+			.optional()
+			.describe("改名理由，一句话，展示给用户看"),
+	},
+	// context 带 sessionID：用它记下「模型这一轮亲手发过信」，
+	// 让 session.idle 的自动转发让位，避免同一件事发两封。
+	async execute(args, context) {
+		// 改名建议以 HTML 注释形式附在正文末尾，由网关解析后剥离。
+		// 标记格式是服务端正则的镜像，因此拼接收在 lib/rename-proposal.js
+		// （三平台共用）—— 各写一遍的话少个空格就静默失效：邮件照常发出，
+		// 提议凭空消失，而模型以为自己提过了。
+		const { body, proposed } = appendRenameProposal(
+			args.body,
+			args.propose_alias,
+			args.propose_reason,
+		);
 
-    const result = await apiPost("/mail/send", {
-      to: args.to,
-      subject: args.subject,
-      body,
-      cc: args.cc || "",
-      reply_to: args.reply_to || "",
-      session_alias: args.session_alias || "",
-      attachment_ids: args.attachment_ids || [],
-      from_session_id: context?.sessionID || "",
-    });
+		const result = await apiPost("/mail/send", {
+			to: args.to,
+			subject: args.subject,
+			body,
+			cc: args.cc || "",
+			reply_to: args.reply_to || "",
+			session_alias: args.session_alias || "",
+			attachment_ids: args.attachment_ids || [],
+			from_session_id: context?.sessionID || "",
+		});
 
-    // 发成功后才记：失败的调用不该压掉自动转发 ——
-    // 那种情况下模型的结论还没送出去，自动转发正是兜底
-    noteExplicitSend(context?.sessionID, args.to, args.reply_to);
-    const alias = result.session_alias
-      ? `，会话别名 ${result.session_alias}（续谈可用 ${args.to.split(".")[0]}.${result.session_alias}）`
-      : "";
-    // 本任务的剩余往返必须回给模型：不然它只能撞到 403 才知道额度用完。
-    // 注意这是【这条线索】的预算，不是 Agent 的终身额度 ——
-    // 换一个任务就是另一份预算。
-    const budget =
-      typeof result.budget_remaining === "number"
-        ? `\n本任务剩余 ${result.budget_remaining}/${result.budget_max} 个来回。` +
-          (result.budget_remaining <= 1
-            ? "预算即将用尽，请尽快给出结论；自动转发的总结不占预算。"
-            : "")
-        : "";
-    // 别名取服务端回的 rename_proposed：它跑过 normalizeAlias，
-    // 回显本地值会让模型记住一个不存在的名字
-    const note = renameProposalNote(result.rename_proposed, args.propose_alias, proposed);
-    return `已发送。Mail ID: ${result.mail_id}，Session: ${result.session_id}${alias}${budget}` +
-      (note ? `\n${note}` : "");
-  },
+		// 发成功后才记：失败的调用不该压掉自动转发 ——
+		// 那种情况下模型的结论还没送出去，自动转发正是兜底
+		noteExplicitSend(context?.sessionID, args.to, args.reply_to);
+		const alias = result.session_alias
+			? `，会话别名 ${result.session_alias}（续谈可用 ${args.to.split(".")[0]}.${result.session_alias}）`
+			: "";
+		// 本任务的剩余往返必须回给模型：不然它只能撞到 403 才知道额度用完。
+		// 注意这是【这条线索】的预算，不是 Agent 的终身额度 ——
+		// 换一个任务就是另一份预算。
+		const budget =
+			typeof result.budget_remaining === "number"
+				? `\n本任务剩余 ${result.budget_remaining}/${result.budget_max} 个来回。` +
+					(result.budget_remaining <= 1
+						? "预算即将用尽，请尽快给出结论；自动转发的总结不占预算。"
+						: "")
+				: "";
+		// 别名取服务端回的 rename_proposed：它跑过 normalizeAlias，
+		// 回显本地值会让模型记住一个不存在的名字
+		const note = renameProposalNote(
+			result.rename_proposed,
+			args.propose_alias,
+			proposed,
+		);
+		return (
+			`已发送。Mail ID: ${result.mail_id}，Session: ${result.session_id}${alias}${budget}` +
+			(note ? `\n${note}` : "")
+		);
+	},
 };
 
 const forwardMailTool = {
-  description:
-    "转发一封邮件给新的收件人（引用原文）。与回复不同：回复落回原会话，转发按目标地址另行定位会话。" +
-    "只能转发自己参与过的邮件。",
-  args: {
-    mail_id: z.string().describe("要转发的邮件 ID（从 read_inbox 获得）"),
-    to: z.string().describe("新收件人的三维地址"),
-    comment: z.string().optional().describe("转发说明，置于引用原文之前"),
-    cc: z.string().optional().describe("抄送，逗号分隔多个三维地址"),
-    subject: z.string().optional().describe("自定义主题；留空则自动加 Fwd: 前缀"),
-    session_alias: z.string().optional().describe("仅在目标地址以 .new 结尾时生效：给新会话命名"),
-  },
-  async execute(args) {
-    const result = await apiPost(`/mail/${args.mail_id}/forward`, {
-      to: args.to,
-      comment: args.comment || "",
-      cc: args.cc || "",
-      subject: args.subject || "",
-      session_alias: args.session_alias || "",
-    });
-    return `已转发。新 Mail ID: ${result.mail_id}，Session: ${result.session_id}`;
-  },
+	description:
+		"转发一封邮件给新的收件人（引用原文）。与回复不同：回复落回原会话，转发按目标地址另行定位会话。" +
+		"只能转发自己参与过的邮件。",
+	args: {
+		mail_id: z.string().describe("要转发的邮件 ID（从 read_inbox 获得）"),
+		to: z.string().describe("新收件人的三维地址"),
+		comment: z.string().optional().describe("转发说明，置于引用原文之前"),
+		cc: z.string().optional().describe("抄送，逗号分隔多个三维地址"),
+		subject: z
+			.string()
+			.optional()
+			.describe("自定义主题；留空则自动加 Fwd: 前缀"),
+		session_alias: z
+			.string()
+			.optional()
+			.describe("仅在目标地址以 .new 结尾时生效：给新会话命名"),
+	},
+	async execute(args) {
+		const result = await apiPost(`/mail/${args.mail_id}/forward`, {
+			to: args.to,
+			comment: args.comment || "",
+			cc: args.cc || "",
+			subject: args.subject || "",
+			session_alias: args.session_alias || "",
+		});
+		return `已转发。新 Mail ID: ${result.mail_id}，Session: ${result.session_id}`;
+	},
 };
 
 const readInboxTool = {
-  description: "查阅收件箱中的邮件。收到新邮件通知后应立即调用此工具。",
-  args: {
-    filter: z.enum(["unread", "all"]).optional().describe("过滤条件，默认 unread"),
-    limit: z.number().optional().describe("返回数量，默认 5"),
-  },
-  async execute(args) {
-    const filter = args.filter || DEFAULT_INBOX_STATUS;
-    const limit = args.limit || DEFAULT_INBOX_LIMIT;
-    const data = await apiGet(`/mail/inbox?status=${filter}&limit=${limit}`);
+	description: "查阅收件箱中的邮件。收到新邮件通知后应立即调用此工具。",
+	args: {
+		filter: z
+			.enum(["unread", "all"])
+			.optional()
+			.describe("过滤条件，默认 unread"),
+		limit: z.number().optional().describe("返回数量，默认 5"),
+	},
+	async execute(args) {
+		const filter = args.filter || DEFAULT_INBOX_STATUS;
+		const limit = args.limit || DEFAULT_INBOX_LIMIT;
+		const data = await apiGet(`/mail/inbox?status=${filter}&limit=${limit}`);
 
-    // 渲染与已读策略放 lib/inbox-format.js：它们与平台 SDK 无关，
-    // 各平台插件必须一致（见该文件里每条规则对应的错误行为）。
-    //
-    // 传 AGENT_NAME 是为了让渲染能判定「我是收件人还是抄送方」并给出
-    // 可投递地址 —— 不传的话模型只能从抄送行里抄一个 `.new`，而那是
-    // 一次性的，回过去只会再建一条平行会话。
-    const listed = renderInbox(data.mails, 200, AGENT_NAME);
+		// 渲染与已读策略放 lib/inbox-format.js：它们与平台 SDK 无关，
+		// 各平台插件必须一致（见该文件里每条规则对应的错误行为）。
+		//
+		// 传 AGENT_NAME 是为了让渲染能判定「我是收件人还是抄送方」并给出
+		// 可投递地址 —— 不传的话模型只能从抄送行里抄一个 `.new`，而那是
+		// 一次性的，回过去只会再建一条平行会话。
+		const listed = renderInbox(data.mails, 200, AGENT_NAME);
 
-    const ids = idsToMarkRead(args.filter, data.mails);
-    if (ids.length) {
-      // 标记失败不该让 read_inbox 失败 —— 正文已经取到了，
-      // 代价只是下次会重复看到，比丢掉这次读取轻。
-      apiPost("/mail/read", { mail_ids: ids }).catch(e =>
-        console.error("[mail-bridge] 标记已读失败:", e?.message || e)
-      );
-    }
-    return listed;
-  },
+		const ids = idsToMarkRead(args.filter, data.mails);
+		if (ids.length) {
+			// 标记失败不该让 read_inbox 失败 —— 正文已经取到了，
+			// 代价只是下次会重复看到，比丢掉这次读取轻。
+			apiPost("/mail/read", { mail_ids: ids }).catch((e) =>
+				console.error("[mail-bridge] 标记已读失败:", e?.message || e),
+			);
+		}
+		return listed;
+	},
 };
 
 const uploadAttachmentTool = {
-  description:
-    "上传本地文件作为邮件附件，返回 attachment_id。" +
-    "拿到 id 后在 send_mail 的 attachment_ids 里带上，附件才会随邮件发出。" +
-    "未随邮件发出的附件 24 小时后自动清理。",
-  args: {
-    path: z.string().describe("要上传的本地文件绝对路径"),
-    filename: z.string().optional().describe("自定义展示文件名，默认取路径的最后一段"),
-  },
-  async execute(args) {
-    const filePath = args.path;
-    let stat;
-    try {
-      stat = statSync(filePath);
-    } catch {
-      return `文件不存在或不可读: ${filePath}`;
-    }
-    if (!stat.isFile()) return `不是普通文件: ${filePath}`;
+	description:
+		"上传本地文件作为邮件附件，返回 attachment_id。" +
+		"拿到 id 后在 send_mail 的 attachment_ids 里带上，附件才会随邮件发出。" +
+		"未随邮件发出的附件 24 小时后自动清理。",
+	args: {
+		path: z.string().describe("要上传的本地文件绝对路径"),
+		filename: z
+			.string()
+			.optional()
+			.describe("自定义展示文件名，默认取路径的最后一段"),
+	},
+	async execute(args) {
+		const filePath = args.path;
+		let stat;
+		try {
+			stat = statSync(filePath);
+		} catch {
+			return `文件不存在或不可读: ${filePath}`;
+		}
+		if (!stat.isFile()) return `不是普通文件: ${filePath}`;
 
-    const name = args.filename || basename(filePath);
-    // Node 的 Blob 需要完整读入内存。附件上限 25MB，一次性读入可接受；
-    // 若将来放宽上限，这里要换成流式 multipart。
-    const buf = readFileSync(filePath);
-    const form = new FormData();
-    form.append("file", new Blob([buf]), name);
+		const name = args.filename || basename(filePath);
+		// Node 的 Blob 需要完整读入内存。附件上限 25MB，一次性读入可接受；
+		// 若将来放宽上限，这里要换成流式 multipart。
+		const buf = readFileSync(filePath);
+		const form = new FormData();
+		form.append("file", new Blob([buf]), name);
 
-    const res = await fetch(`${GATEWAY_URL}/api/v1/attachments`, {
-      method: "POST",
-      headers: authHeaders(), // 不设 Content-Type，交给 FormData 自己带 boundary
-      body: form,
-    });
-    const data = await res.json().catch(() => ({}));
-    if (!res.ok) throw new Error(data.error || `上传失败: ${res.status}`);
+		const res = await fetch(`${GATEWAY_URL}/api/v1/attachments`, {
+			method: "POST",
+			headers: authHeaders(), // 不设 Content-Type，交给 FormData 自己带 boundary
+			body: form,
+		});
+		const data = await res.json().catch(() => ({}));
+		if (!res.ok) throw new Error(data.error || `上传失败: ${res.status}`);
 
-    const a = data.attachment;
-    return `已上传 ${a.filename}（${formatSize(a.size_bytes)}）。attachment_id: ${a.attachment_id}\n` +
-      `在 send_mail 的 attachment_ids 里带上这个 id 才会随邮件发出。`;
-  },
+		const a = data.attachment;
+		return (
+			`已上传 ${a.filename}（${formatSize(a.size_bytes)}）。attachment_id: ${a.attachment_id}\n` +
+			`在 send_mail 的 attachment_ids 里带上这个 id 才会随邮件发出。`
+		);
+	},
 };
 
 const downloadAttachmentTool = {
-  description: "下载邮件附件到本地文件。attachment_id 从 read_inbox 的附件清单里取。",
-  args: {
-    attachment_id: z.string().describe("附件 ID"),
-    save_to: z.string().describe("保存到的本地绝对路径"),
-  },
-  async execute(args) {
-    const res = await fetch(`${GATEWAY_URL}/api/v1/attachments/${args.attachment_id}`, {
-      headers: authHeaders(),
-    });
-    if (!res.ok) {
-      const data = await res.json().catch(() => ({}));
-      throw new Error(data.error || `下载失败: ${res.status}`);
-    }
-    const buf = Buffer.from(await res.arrayBuffer());
-    mkdirSync(dirname(args.save_to), { recursive: true });
-    writeFileSync(args.save_to, buf);
-    return `已保存到 ${args.save_to}（${formatSize(buf.length)}）`;
-  },
+	description:
+		"下载邮件附件到本地文件。attachment_id 从 read_inbox 的附件清单里取。",
+	args: {
+		attachment_id: z.string().describe("附件 ID"),
+		save_to: z.string().describe("保存到的本地绝对路径"),
+	},
+	async execute(args) {
+		const res = await fetch(
+			`${GATEWAY_URL}/api/v1/attachments/${args.attachment_id}`,
+			{
+				headers: authHeaders(),
+			},
+		);
+		if (!res.ok) {
+			const data = await res.json().catch(() => ({}));
+			throw new Error(data.error || `下载失败: ${res.status}`);
+		}
+		const buf = Buffer.from(await res.arrayBuffer());
+		mkdirSync(dirname(args.save_to), { recursive: true });
+		writeFileSync(args.save_to, buf);
+		return `已保存到 ${args.save_to}（${formatSize(buf.length)}）`;
+	},
 };
 
 // ─── 寻址发现工具（读 Agent 侧只读端点）───
@@ -356,118 +445,132 @@ const downloadAttachmentTool = {
 // 渲染逻辑在 lib/discovery.js（与平台 SDK 无关，三平台共用）。
 
 const suggestAddressTool = {
-  description:
-    "查询可用的收件人地址，用于精准发信。分三段逐步查：不带参数给候选收件人名；" +
-    "带 name 给它可用的工作目录；name+path 都带则给该目录下可续谈的会话别名与现成地址。" +
-    "**发信前应先用它确认地址**，不要凭记忆拼写 —— 拼错不会报错，只会投到别的会话。",
-  args: {
-    name: z.string().optional().describe("收件人名；留空则列出所有候选收件人"),
-    path: z.string().optional().describe("工作目录；与 name 同时给出才列会话"),
-  },
-  async execute(args) {
-    const name = (args.name || "").trim();
-    const path = (args.path || "").trim();
-    const qs = new URLSearchParams();
-    if (name) qs.set("name", name);
-    if (path) qs.set("path", path);
-    const data = await apiGet(`/agent/contacts/suggest?${qs.toString()}`);
+	description:
+		"查询可用的收件人地址，用于精准发信。分三段逐步查：不带参数给候选收件人名；" +
+		"带 name 给它可用的工作目录；name+path 都带则给该目录下可续谈的会话别名与现成地址。" +
+		"**发信前应先用它确认地址**，不要凭记忆拼写 —— 拼错不会报错，只会投到别的会话。",
+	args: {
+		name: z.string().optional().describe("收件人名；留空则列出所有候选收件人"),
+		path: z.string().optional().describe("工作目录；与 name 同时给出才列会话"),
+	},
+	async execute(args) {
+		const name = (args.name || "").trim();
+		const path = (args.path || "").trim();
+		const qs = new URLSearchParams();
+		if (name) qs.set("name", name);
+		if (path) qs.set("path", path);
+		const data = await apiGet(`/agent/contacts/suggest?${qs.toString()}`);
 
-    // 按服务端回的 kind 分派，而不是按本地参数判断：省略 path 与传空串在
-    // 服务端是同一个意思，但「哪一段该渲染成什么」只有服务端知道。
-    switch (data?.kind) {
-      case "name":
-        return renderNameSuggestions(data.suggestions);
-      case "path":
-        return renderPathSuggestions(data.suggestions, name);
-      default:
-        return renderSessionSuggestions(data, name, path);
-    }
-  },
+		// 按服务端回的 kind 分派，而不是按本地参数判断：省略 path 与传空串在
+		// 服务端是同一个意思，但「哪一段该渲染成什么」只有服务端知道。
+		switch (data?.kind) {
+			case "name":
+				return renderNameSuggestions(data.suggestions);
+			case "path":
+				return renderPathSuggestions(data.suggestions, name);
+			default:
+				return renderSessionSuggestions(data, name, path);
+		}
+	},
 };
 
 const listContactsTool = {
-  description:
-    "列出自己参与过的全部会话及各自的可投递地址、未读数、剩余往返预算。" +
-    "用于回答「我还有什么没处理」以及「上次跟某人聊的那条线索地址是什么」。",
-  args: {
-    limit: z.number().optional().describe("最多列出多少条，默认 20"),
-  },
-  async execute(args) {
-    const data = await apiGet("/agent/contacts");
-    return renderContacts(data, args.limit || 20);
-  },
+	description:
+		"列出自己参与过的全部会话及各自的可投递地址、未读数、剩余往返预算。" +
+		"用于回答「我还有什么没处理」以及「上次跟某人聊的那条线索地址是什么」。",
+	args: {
+		limit: z.number().optional().describe("最多列出多少条，默认 20"),
+	},
+	async execute(args) {
+		const data = await apiGet("/agent/contacts");
+		return renderContacts(data, args.limit || 20);
+	},
 };
 
 const sessionParticipantsTool = {
-  description:
-    "列出某条会话的全部参与方（发件人/收件人/抄送方）及各自的可投递地址，" +
-    "并标出谁还没回应。**要回给抄收方或向第三方转达时先用它拿地址**。",
-  args: {
-    session_id: z.string().describe("会话 ID（read_inbox 未直接给出时可从 read_thread 或新邮件通知取得）"),
-  },
-  async execute(args) {
-    const data = await apiGet(`/agent/sessions/${args.session_id}/participants`);
-    return renderParticipants(data);
-  },
+	description:
+		"列出某条会话的全部参与方（发件人/收件人/抄送方）及各自的可投递地址，" +
+		"并标出谁还没回应。**要回给抄收方或向第三方转达时先用它拿地址**。",
+	args: {
+		session_id: z
+			.string()
+			.describe(
+				"会话 ID（read_inbox 未直接给出时可从 read_thread 或新邮件通知取得）",
+			),
+	},
+	async execute(args) {
+		const data = await apiGet(
+			`/agent/sessions/${args.session_id}/participants`,
+		);
+		return renderParticipants(data);
+	},
 };
 
 const readThreadTool = {
-  description:
-    "查看一封邮件所在线索的完整往来（谁回了谁、谁还没回）。多方抄送协作时" +
-    "用它确认别人已经说了什么，避免重复提问或重复汇报。",
-  args: {
-    mail_id: z.string().describe("线索中任一封邮件的 ID"),
-    offset: z.number().optional().describe("分页偏移，续取时传上次返回的 next_offset"),
-  },
-  async execute(args) {
-    const qs = args.offset ? `?offset=${args.offset}` : "";
-    const data = await apiGet(`/agent/mail/${args.mail_id}/thread${qs}`);
-    return renderThread(data, AGENT_NAME);
-  },
+	description:
+		"查看一封邮件所在线索的完整往来（谁回了谁、谁还没回）。多方抄送协作时" +
+		"用它确认别人已经说了什么，避免重复提问或重复汇报。",
+	args: {
+		mail_id: z.string().describe("线索中任一封邮件的 ID"),
+		offset: z
+			.number()
+			.optional()
+			.describe("分页偏移，续取时传上次返回的 next_offset"),
+	},
+	async execute(args) {
+		const qs = args.offset ? `?offset=${args.offset}` : "";
+		const data = await apiGet(`/agent/mail/${args.mail_id}/thread${qs}`);
+		return renderThread(data, AGENT_NAME);
+	},
 };
 
 const readMailTool = {
-  description:
-    "读一封邮件的完整内容，含收件人、抄送清单、附件与每个参与方的可投递地址。" +
-    "收件箱只给摘要；要回给抄收方就得先看清这封信发给了谁。",
-  args: {
-    mail_id: z.string().describe("邮件 ID"),
-  },
-  async execute(args) {
-    const data = await apiGet(`/agent/mail/${args.mail_id}`);
-    const m = data?.mail || {};
-    const lines = [
-      `发件人: ${m.from_name || "?"}`,
-      `收件人: ${m.to_name || "?"}${m.to_workspace ? "@" + m.to_workspace : ""}`,
-      `主题: ${m.subject || "(无主题)"}`,
-      `会话: #${data.session_alias || "未命名"}（session_id: ${m.session_id || "?"}）`,
-    ];
-    if (Array.isArray(m.cc_list) && m.cc_list.length) {
-      lines.push(`抄送: ${m.cc_list.map(c => c?.raw || c?.name).join("、")}`);
-    }
-    if (Array.isArray(m.attachments) && m.attachments.length) {
-      lines.push(
-        `附件: ${m.attachments
-          .map(a => `${a.filename}（${formatSize(a.size_bytes)}, id=${a.attachment_id}）`)
-          .join("、")}`
-      );
-    }
-    lines.push("", m.body || "(空正文)", "");
-    // 参与方地址由服务端拼好（session 位已是真实别名，不是 .new）
-    if (Array.isArray(data.participants) && data.participants.length) {
-      lines.push(
-        "可投递地址: " +
-          data.participants
-            .filter(p => p.address && p.name !== AGENT_NAME)
-            .map(p => `${p.address}（${p.role}）`)
-            .join("、")
-      );
-    }
-    if (data.reply_address) {
-      lines.push(`回信给发件人用 ${data.reply_address}，或传 reply_to=${m.mail_id}。`);
-    }
-    return lines.join("\n");
-  },
+	description:
+		"读一封邮件的完整内容，含收件人、抄送清单、附件与每个参与方的可投递地址。" +
+		"收件箱只给摘要；要回给抄收方就得先看清这封信发给了谁。",
+	args: {
+		mail_id: z.string().describe("邮件 ID"),
+	},
+	async execute(args) {
+		const data = await apiGet(`/agent/mail/${args.mail_id}`);
+		const m = data?.mail || {};
+		const lines = [
+			`发件人: ${m.from_name || "?"}`,
+			`收件人: ${m.to_name || "?"}${m.to_workspace ? "@" + m.to_workspace : ""}`,
+			`主题: ${m.subject || "(无主题)"}`,
+			`会话: #${data.session_alias || "未命名"}（session_id: ${m.session_id || "?"}）`,
+		];
+		if (Array.isArray(m.cc_list) && m.cc_list.length) {
+			lines.push(`抄送: ${m.cc_list.map((c) => c?.raw || c?.name).join("、")}`);
+		}
+		if (Array.isArray(m.attachments) && m.attachments.length) {
+			lines.push(
+				`附件: ${m.attachments
+					.map(
+						(a) =>
+							`${a.filename}（${formatSize(a.size_bytes)}, id=${a.attachment_id}）`,
+					)
+					.join("、")}`,
+			);
+		}
+		lines.push("", m.body || "(空正文)", "");
+		// 参与方地址由服务端拼好（session 位已是真实别名，不是 .new）
+		if (Array.isArray(data.participants) && data.participants.length) {
+			lines.push(
+				"可投递地址: " +
+					data.participants
+						.filter((p) => p.address && p.name !== AGENT_NAME)
+						.map((p) => `${p.address}（${p.role}）`)
+						.join("、"),
+			);
+		}
+		if (data.reply_address) {
+			lines.push(
+				`回信给发件人用 ${data.reply_address}，或传 reply_to=${m.mail_id}。`,
+			);
+		}
+		return lines.join("\n");
+	},
 };
 
 // 平台原生权限询问 → 邮件。
@@ -485,59 +588,78 @@ const readMailTool = {
 // Agent 不可能在界面上点「同意」，服务端的用户推送也投进一个不存在的通道，
 // 那条会话于是无声挂死（pi 侧真实发生过）。
 async function relayPermission({ question, options, context, relayKey }) {
-  return apiPost("/permission/request", {
-    question,
-    options: options && options.length ? options : ["同意", "拒绝"],
-    context: context || "",
-    relay_key: relayKey || "",
-  });
+	return apiPost("/permission/request", {
+		question,
+		options: options && options.length ? options : ["同意", "拒绝"],
+		context: context || "",
+		relay_key: relayKey || "",
+	});
 }
 
 const connectToServerTool = {
-  description:
-    "连接到 AgentMail Gateway：登记本机密钥并完成注册。首次安装或换了 Gateway 地址时调用。" +
-    "密钥若未在后台登记过，此处会返回需要登记的密钥全文。",
-  args: {
-    gateway_url: z.string().optional().describe("Gateway 地址，如 https://mail.example.com；省略则用当前配置"),
-    key_token: z.string().optional().describe("管理员签发的 Agent 密钥；省略则用本地密钥（不存在时自动生成）"),
-  },
-  async execute(args) {
-    if (args.key_token) {
-      AGENT_KEY = args.key_token.trim();
-      // 管理员给的密钥落盘，重启后仍然可用
-      mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-      writeFileSync(
-        KEY_FILE,
-        JSON.stringify({ key_token: AGENT_KEY, created_at: new Date().toISOString() }, null, 2),
-        { mode: 0o600 }
-      );
-    } else if (!AGENT_KEY) {
-      AGENT_KEY = generateLocalKey();
-    }
+	description:
+		"连接到 AgentMail Gateway：登记本机密钥并完成注册。首次安装或换了 Gateway 地址时调用。" +
+		"密钥若未在后台登记过，此处会返回需要登记的密钥全文。",
+	args: {
+		gateway_url: z
+			.string()
+			.optional()
+			.describe("Gateway 地址，如 https://mail.example.com；省略则用当前配置"),
+		key_token: z
+			.string()
+			.optional()
+			.describe(
+				"管理员签发的 Agent 密钥；省略则用本地密钥（不存在时自动生成）",
+			),
+	},
+	async execute(args) {
+		if (args.key_token) {
+			AGENT_KEY = args.key_token.trim();
+			// 管理员给的密钥落盘，重启后仍然可用
+			mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+			writeFileSync(
+				KEY_FILE,
+				JSON.stringify(
+					{ key_token: AGENT_KEY, created_at: new Date().toISOString() },
+					null,
+					2,
+				),
+				{ mode: 0o600 },
+			);
+		} else if (!AGENT_KEY) {
+			AGENT_KEY = generateLocalKey();
+		}
 
-    const url = (args.gateway_url || GATEWAY_URL).replace(/\/+$/, "");
-    const res = await fetch(`${url}/api/v1/agent/register`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${AGENT_KEY}` },
-      body: JSON.stringify({ name: AGENT_NAME, workspaces: [], platform: "opencode" }),
-    });
-    const data = await res.json().catch(() => ({}));
+		const url = (args.gateway_url || GATEWAY_URL).replace(/\/+$/, "");
+		const res = await fetch(`${url}/api/v1/agent/register`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${AGENT_KEY}`,
+			},
+			body: JSON.stringify({
+				name: AGENT_NAME,
+				workspaces: [],
+				platform: "opencode",
+			}),
+		});
+		const data = await res.json().catch(() => ({}));
 
-    if (!res.ok) {
-      // 密钥没登记是最常见的失败，直接把要登记的值给出来，省一轮来回
-      return [
-        `连接失败（HTTP ${res.status}）：${data.error || "未知错误"}`,
-        ``,
-        `若提示密钥无效，请让管理员在 AgentMail 后台「Agent 密钥」中登记：`,
-        AGENT_KEY,
-        ``,
-        `密钥文件：${KEY_FILE}`,
-      ].join("\n");
-    }
+		if (!res.ok) {
+			// 密钥没登记是最常见的失败，直接把要登记的值给出来，省一轮来回
+			return [
+				`连接失败（HTTP ${res.status}）：${data.error || "未知错误"}`,
+				``,
+				`若提示密钥无效，请让管理员在 AgentMail 后台「Agent 密钥」中登记：`,
+				AGENT_KEY,
+				``,
+				`密钥文件：${KEY_FILE}`,
+			].join("\n");
+		}
 
-    saveConfig({ gateway_url: url, registered_at: new Date().toISOString() });
-    return `已连接 ${url}，注册为 ${data.agent_name || AGENT_NAME}。`;
-  },
+		saveConfig({ gateway_url: url, registered_at: new Date().toISOString() });
+		return `已连接 ${url}，注册为 ${data.agent_name || AGENT_NAME}。`;
+	},
 };
 
 // ─── SSE ───
@@ -548,15 +670,15 @@ const connectToServerTool = {
 let sseClientRef = null;
 
 function startSSE(onEvent) {
-  sseClientRef?.stop?.();
-  sseClientRef = createSSEClient({
-    authHeaders,
-    baseURL: GATEWAY_URL.replace(/\/+$/, ""),
-    path: "/api/v1/events/stream",
-    onEvent,
-    log: (msg) => console.error("[mail-bridge]", msg),
-  });
-  return sseClientRef;
+	sseClientRef?.stop?.();
+	sseClientRef = createSSEClient({
+		authHeaders,
+		baseURL: GATEWAY_URL.replace(/\/+$/, ""),
+		path: "/api/v1/events/stream",
+		onEvent,
+		log: (msg) => console.error("[mail-bridge]", msg),
+	});
+	return sseClientRef;
 }
 
 // ─── Plugin ───
@@ -602,88 +724,96 @@ const mailDrivenSessions = new BoundedSet(MAX_TRACKED_SESSIONS); // opencode ses
 let allowedModels = [];
 
 async function resolveSessionForMail(client, directory, data, kind) {
-  const mailSessionID = data.session_id;
-  const bound = mailSessionID ? sessionMap.get(mailSessionID) : undefined;
-  if (bound) return { sessionID: bound, reused: true };
+	const mailSessionID = data.session_id;
+	const bound = mailSessionID ? sessionMap.get(mailSessionID) : undefined;
+	if (bound) return { sessionID: bound, reused: true };
 
-  // 服务端说这条邮件会话**接管了平台上已经存在的那条会话**（人在 TUI 里开的
-  // 那种）—— 投进它而不是新建。
-  //
-  // TUI 与邮箱是同一个 Agent 的两个入口，不是两套隔离的世界：人在界面上聊了
-  // 一半想转到邮件继续，或者想把一封邮件投进正在谈的那条会话。补全早就把平台
-  // 会话列为候选，这一跳补上投递侧。
-  //
-  // 新建会让人在 TUI 里看不到这封邮件带来的对话，而那正是接管的目的。
-  //
-  // opencode 上这件事最省力：会话由服务端持有（单一写者），promptAsync 本来
-  // 就是「给这个 session id 发一轮」，不区分谁建的。**不需要**校验它是否活着。
-  const adoptedID = adoptedSessionID(data);
-  if (adoptedID) {
-    // 平台侧那条会话可能已经被人删了（镜像是快照，可以过期）。
-    // 校验一次：直接 prompt 一个不存在的 id 会得到一个语焉不详的 HTTP 错误，
-    // 而这里能给出「它没了，去 .new」这种可操作的话。
-    let ok = false;
-    try {
-      const got = await client.session.get({ path: { id: adoptedID } });
-      ok = Boolean((got?.data ?? got)?.id);
-    } catch {
-      ok = false;
-    }
-    if (!ok) throw new Error(adoptMissingMessage(adoptedID, "可能已在界面上删除"));
-    if (mailSessionID) {
-      sessionMap.set(mailSessionID, adoptedID);
-      reverseMap.set(adoptedID, mailSessionID);
-      // 标记为邮件驱动：接管之后这条会话**开始**参与邮件往来，
-      // 轮次结束要把总结转回发件人。不标记的话邮件投进去了却永远没有回音。
-      mailDrivenSessions.add(adoptedID);
-    }
-    console.error(`[mail-bridge] 接管平台会话 ${adoptedID}（邮件会话 ${mailSessionID}）`);
-    return { sessionID: adoptedID, reused: true, adopted: true };
-  }
+	// 服务端说这条邮件会话**接管了平台上已经存在的那条会话**（人在 TUI 里开的
+	// 那种）—— 投进它而不是新建。
+	//
+	// TUI 与邮箱是同一个 Agent 的两个入口，不是两套隔离的世界：人在界面上聊了
+	// 一半想转到邮件继续，或者想把一封邮件投进正在谈的那条会话。补全早就把平台
+	// 会话列为候选，这一跳补上投递侧。
+	//
+	// 新建会让人在 TUI 里看不到这封邮件带来的对话，而那正是接管的目的。
+	//
+	// opencode 上这件事最省力：会话由服务端持有（单一写者），promptAsync 本来
+	// 就是「给这个 session id 发一轮」，不区分谁建的。**不需要**校验它是否活着。
+	const adoptedID = adoptedSessionID(data);
+	if (adoptedID) {
+		// 平台侧那条会话可能已经被人删了（镜像是快照，可以过期）。
+		// 校验一次：直接 prompt 一个不存在的 id 会得到一个语焉不详的 HTTP 错误，
+		// 而这里能给出「它没了，去 .new」这种可操作的话。
+		let ok = false;
+		try {
+			const got = await client.session.get({ path: { id: adoptedID } });
+			ok = Boolean((got?.data ?? got)?.id);
+		} catch {
+			ok = false;
+		}
+		if (!ok)
+			throw new Error(adoptMissingMessage(adoptedID, "可能已在界面上删除"));
+		if (mailSessionID) {
+			sessionMap.set(mailSessionID, adoptedID);
+			reverseMap.set(adoptedID, mailSessionID);
+			// 标记为邮件驱动：接管之后这条会话**开始**参与邮件往来，
+			// 轮次结束要把总结转回发件人。不标记的话邮件投进去了却永远没有回音。
+			mailDrivenSessions.add(adoptedID);
+		}
+		console.error(
+			`[mail-bridge] 接管平台会话 ${adoptedID}（邮件会话 ${mailSessionID}）`,
+		);
+		return { sessionID: adoptedID, reused: true, adopted: true };
+	}
 
-  // 工作目录取**寻址里的 path 位**，而不是插件启动时那个固定的 directory。
-  //
-  // 三维地址 name@path.session 的 path 就是「希望它在哪儿干活」。用固定的
-  // directory 会让所有邮件会话都挤在同一个目录里，与地址写的完全无关；
-  // 而 opencode 按 directory 归属项目，写错了会话就归到别的项目下。
-  //
-  // 校验逻辑与 DSH 侧共用（lib/workspace.js）：目录不存在时不创建、
-  // 拒绝相对路径。opencode 的兜底是插件启动时的 directory。
-  const { cwd: wantDir, grouped } = resolveWorkspaceCwd(data.to_workspace, directory);
-  if (!grouped && data.to_workspace) {
-    console.error(
-      `[mail-bridge] 工作目录 ${data.to_workspace} 不可用，回退到 ${wantDir || "(平台默认)"}`);
-  }
+	// 工作目录取**寻址里的 path 位**，而不是插件启动时那个固定的 directory。
+	//
+	// 三维地址 name@path.session 的 path 就是「希望它在哪儿干活」。用固定的
+	// directory 会让所有邮件会话都挤在同一个目录里，与地址写的完全无关；
+	// 而 opencode 按 directory 归属项目，写错了会话就归到别的项目下。
+	//
+	// 校验逻辑与 DSH 侧共用（lib/workspace.js）：目录不存在时不创建、
+	// 拒绝相对路径。opencode 的兜底是插件启动时的 directory。
+	const { cwd: wantDir, grouped } = resolveWorkspaceCwd(
+		data.to_workspace,
+		directory,
+	);
+	if (!grouped && data.to_workspace) {
+		console.error(
+			`[mail-bridge] 工作目录 ${data.to_workspace} 不可用，回退到 ${wantDir || "(平台默认)"}`,
+		);
+	}
 
-  // 故意不传 title：opencode 只在标题缺省时才让模型按首轮对话生成摘要标题，
-  // 传了占位标题就等于掐掉平台自己的命名机制。标题稍后由 session.updated 事件回写。
-  let created;
-  try {
-    created = await client.session.create({
-      query: wantDir ? { directory: wantDir } : undefined,
-    });
-  } catch (e) {
-    console.error(`[mail-bridge] session.create 失败: ${e?.message || e}`);
-    throw e;
-  }
-  const session = created?.data ?? created;
-  const sessionID = session?.id;
-  if (!sessionID) throw new Error("session.create 未返回 id");
+	// 故意不传 title：opencode 只在标题缺省时才让模型按首轮对话生成摘要标题，
+	// 传了占位标题就等于掐掉平台自己的命名机制。标题稍后由 session.updated 事件回写。
+	let created;
+	try {
+		created = await client.session.create({
+			query: wantDir ? { directory: wantDir } : undefined,
+		});
+	} catch (e) {
+		console.error(`[mail-bridge] session.create 失败: ${e?.message || e}`);
+		throw e;
+	}
+	const session = created?.data ?? created;
+	const sessionID = session?.id;
+	if (!sessionID) throw new Error("session.create 未返回 id");
 
-  if (mailSessionID) {
-    sessionMap.set(mailSessionID, sessionID);
-    reverseMap.set(sessionID, mailSessionID);
-    mailDrivenSessions.add(sessionID);
+	if (mailSessionID) {
+		sessionMap.set(mailSessionID, sessionID);
+		reverseMap.set(sessionID, mailSessionID);
+		mailDrivenSessions.add(sessionID);
 
-    // slug 在创建时就有（如 nimble-lagoon），立即作为寻址别名回写；
-    // 标题要等模型生成，走 session.updated 事件。
-    if (session.slug) {
-      syncSessionNaming(mailSessionID, { alias: session.slug }).then((res) => {
-        if (res?.alias) console.error(`[mail-bridge] 别名同步 ${sessionID} -> ${res.alias}`);
-      });
-    }
-  }
-  return { sessionID, reused: false };
+		// slug 在创建时就有（如 nimble-lagoon），立即作为寻址别名回写；
+		// 标题要等模型生成，走 session.updated 事件。
+		if (session.slug) {
+			syncSessionNaming(mailSessionID, { alias: session.slug }).then((res) => {
+				if (res?.alias)
+					console.error(`[mail-bridge] 别名同步 ${sessionID} -> ${res.alias}`);
+			});
+		}
+	}
+	return { sessionID, reused: false };
 }
 
 // 把本轮的最终总结转成邮件发回给对方。
@@ -696,109 +826,115 @@ async function resolveSessionForMail(client, directory, data, kind) {
 // 此刻的最后一条 assistant 消息就是本轮结论。
 // 不用 message.updated：那会在流式生成过程中反复触发，转出去的是半截话。
 async function relaySummary(client, directory, sessionID) {
-  const mailSessionID = reverseMap.get(sessionID);
-  if (!mailSessionID) return null;              // 不是邮件驱动的会话，不碰
-  if (!mailDrivenSessions.has(sessionID)) return null;
+	const mailSessionID = reverseMap.get(sessionID);
+	if (!mailSessionID) return null; // 不是邮件驱动的会话，不碰
+	if (!mailDrivenSessions.has(sessionID)) return null;
 
-  // 回信地址：这轮是谁发起的就回给谁。取该会话最近一封来信的发件人。
-  const ctx = mailContexts.get(mailSessionID);
+	// 回信地址：这轮是谁发起的就回给谁。取该会话最近一封来信的发件人。
+	const ctx = mailContexts.get(mailSessionID);
 
-  // **只给人类来信自动转发**（见 lib/relay-policy.js）。
-  //
-  // 对方是 Agent 时它那边的插件也会自动回一封，于是两个模型都以为「我只要
-  // 把话说完就行」，实际在持续互相唤醒 —— 生产实测 pi 与 dsh 客套 6 轮直到
-  // 撞上连续 relay 跳数上限。放在取消息列表**之前**判：少一次网关往返。
-  const policy = autoRelayDecision({
-    fromHuman: ctx?.fromHuman === true,
-    replyTo: ctx?.replyTo,
-  });
-  if (!policy.relay) {
-    console.error(`[mail-bridge] 本轮不自动转发：${policy.reason}`);
-    return null;
-  }
+	// **只给人类来信自动转发**（见 lib/relay-policy.js）。
+	//
+	// 对方是 Agent 时它那边的插件也会自动回一封，于是两个模型都以为「我只要
+	// 把话说完就行」，实际在持续互相唤醒 —— 生产实测 pi 与 dsh 客套 6 轮直到
+	// 撞上连续 relay 跳数上限。放在取消息列表**之前**判：少一次网关往返。
+	const policy = autoRelayDecision({
+		fromHuman: ctx?.fromHuman === true,
+		replyTo: ctx?.replyTo,
+	});
+	if (!policy.relay) {
+		console.error(`[mail-bridge] 本轮不自动转发：${policy.reason}`);
+		return null;
+	}
 
-  // 取最后一条 assistant 文本消息
-  const listed = await client.session.messages({
-    path: { id: sessionID },
-    query: directory ? { directory } : undefined,
-  });
-  const msgs = listed?.data ?? listed ?? [];
-  let last = null;
-  for (let i = msgs.length - 1; i >= 0; i--) {
-    const m = msgs[i];
-    if (m?.info?.role !== "assistant") continue;
-    // 未完成的消息（还在生成/被中断）不转：转出去是半截话
-    if (!m.info.time?.completed) continue;
-    const text = (m.parts || [])
-      .filter(p => p.type === "text" && !p.synthetic && !p.ignored && p.text)
-      .map(p => p.text)
-      .join("\n")
-      .trim();
-    if (text) { last = { id: m.info.id, text }; }
-    break;
-  }
-  if (!last) {
-    // 模型 idle 但没有任何完成的 assistant 文本：空回复或被中断在文本前。
-    // 此前静默返回 —— 发件人等不到任何回复（B-6 的缺口：跳过了
-    // 「模型全部失败」那条兜底，因为没有失败可报，却也没有产出）。
-    // 给发件人一封失败通知，让他知道这封已经处理过了但没结果。
-    try {
-      await apiPost("/mail/send", {
-        to: ctx?.replyTo || "",
-        subject: `处理失败: ${ctx?.subject || "(无主题)"}`,
-        body: [
-          `这封邮件（主题：${ctx?.subject || "(无主题)"}）的处理轮次已结束，但没有产出任何回复文本。`,
-          "",
-          "可能原因：模型空响应、输出被中断、或工具调用异常耗尽轮次。",
-          "请检查后重试。",
-        ].join("\n"),
-        reply_to: ctx?.mailID || "",
-        relay: "summary",
-        relay_key: clampRelayKey(`empty-reply:${mailSessionID || sessionID}`),
-      });
-      console.error(`[mail-bridge] 已发空回复失败通知给 ${ctx?.replyTo || ""}`);
-    } catch (e) {
-      // 失败通知也发不出去就静默：这次至少试过了
-      console.error("[mail-bridge] 空回复失败通知也发不出去:", e?.message || e);
-    }
-    return null;
-  }
+	// 取最后一条 assistant 文本消息
+	const listed = await client.session.messages({
+		path: { id: sessionID },
+		query: directory ? { directory } : undefined,
+	});
+	const msgs = listed?.data ?? listed ?? [];
+	let last = null;
+	for (let i = msgs.length - 1; i >= 0; i--) {
+		const m = msgs[i];
+		if (m?.info?.role !== "assistant") continue;
+		// 未完成的消息（还在生成/被中断）不转：转出去是半截话
+		if (!m.info.time?.completed) continue;
+		const text = (m.parts || [])
+			.filter((p) => p.type === "text" && !p.synthetic && !p.ignored && p.text)
+			.map((p) => p.text)
+			.join("\n")
+			.trim();
+		if (text) {
+			last = { id: m.info.id, text };
+		}
+		break;
+	}
+	if (!last) {
+		// 模型 idle 但没有任何完成的 assistant 文本：空回复或被中断在文本前。
+		// 此前静默返回 —— 发件人等不到任何回复（B-6 的缺口：跳过了
+		// 「模型全部失败」那条兜底，因为没有失败可报，却也没有产出）。
+		// 给发件人一封失败通知，让他知道这封已经处理过了但没结果。
+		try {
+			await apiPost("/mail/send", {
+				to: ctx?.replyTo || "",
+				subject: `处理失败: ${ctx?.subject || "(无主题)"}`,
+				body: [
+					`这封邮件（主题：${ctx?.subject || "(无主题)"}）的处理轮次已结束，但没有产出任何回复文本。`,
+					"",
+					"可能原因：模型空响应、输出被中断、或工具调用异常耗尽轮次。",
+					"请检查后重试。",
+				].join("\n"),
+				reply_to: ctx?.mailID || "",
+				relay: "summary",
+				relay_key: clampRelayKey(`empty-reply:${mailSessionID || sessionID}`),
+			});
+			console.error(`[mail-bridge] 已发空回复失败通知给 ${ctx?.replyTo || ""}`);
+		} catch (e) {
+			// 失败通知也发不出去就静默：这次至少试过了
+			console.error("[mail-bridge] 空回复失败通知也发不出去:", e?.message || e);
+		}
+		return null;
+	}
 
-  // 本地去重（服务端另有 relay_key 幂等兜底，这里只是少打一次网关）
-  if (relayedSummaries.get(sessionID) === last.id) return null;
+	// 本地去重（服务端另有 relay_key 幂等兜底，这里只是少打一次网关）
+	if (relayedSummaries.get(sessionID) === last.id) return null;
 
-  // 模型这一轮已经亲手回过这条线索 → 不再自动转发。
-  //
-  // 否则收件箱里会出现两封说同一件事的邮件（生产实测：311 字节与 342 字节各一封，
-  // 其中带附件的那封才是模型真正想发的）。判定看两点：
-  //   - 收件人同名：它已经跟这个人说过了
-  //   - reply_to 相同：它已经回过这封信了
-  // relay_key 的幂等管不了这个 —— 那个键保证「同一条消息不转两次」，
-  // 而这里是「模型已经自己发过了」。
-  if (shouldSkipAutoRelay(explicitSends.get(sessionID), ctx.replyTo, ctx.mailID)) {
-    explicitSends.delete(sessionID);
-    relayedSummaries.set(sessionID, last.id); // 记下这条已「处理」，别下次 idle 又转
-    console.error(`[mail-bridge] 本轮模型已主动回信 ${ctx.replyTo}，跳过自动转发`);
-    return null;
-  }
+	// 模型这一轮已经亲手回过这条线索 → 不再自动转发。
+	//
+	// 否则收件箱里会出现两封说同一件事的邮件（生产实测：311 字节与 342 字节各一封，
+	// 其中带附件的那封才是模型真正想发的）。判定看两点：
+	//   - 收件人同名：它已经跟这个人说过了
+	//   - reply_to 相同：它已经回过这封信了
+	// relay_key 的幂等管不了这个 —— 那个键保证「同一条消息不转两次」，
+	// 而这里是「模型已经自己发过了」。
+	if (
+		shouldSkipAutoRelay(explicitSends.get(sessionID), ctx.replyTo, ctx.mailID)
+	) {
+		explicitSends.delete(sessionID);
+		relayedSummaries.set(sessionID, last.id); // 记下这条已「处理」，别下次 idle 又转
+		console.error(
+			`[mail-bridge] 本轮模型已主动回信 ${ctx.replyTo}，跳过自动转发`,
+		);
+		return null;
+	}
 
-  const res = await apiPost("/mail/send", {
-    to: ctx.replyTo,
-    subject: ctx.subject ? `Re: ${stripRe(ctx.subject)}` : "本轮工作总结",
-    body: last.text,
-    reply_to: ctx.mailID || "",
-    // relay + relay_key：走免配额通道，并以 assistant message id 保证只转一次
-    relay: "summary",
-    relay_key: clampRelayKey(last.id),
-  });
-  relayedSummaries.set(sessionID, last.id);
-  explicitSends.delete(sessionID); // 一轮结束，窗口关闭
-  return res;
+	const res = await apiPost("/mail/send", {
+		to: ctx.replyTo,
+		subject: ctx.subject ? `Re: ${stripRe(ctx.subject)}` : "本轮工作总结",
+		body: last.text,
+		reply_to: ctx.mailID || "",
+		// relay + relay_key：走免配额通道，并以 assistant message id 保证只转一次
+		relay: "summary",
+		relay_key: clampRelayKey(last.id),
+	});
+	relayedSummaries.set(sessionID, last.id);
+	explicitSends.delete(sessionID); // 一轮结束，窗口关闭
+	return res;
 }
 
 /** 去掉已有的 Re: 前缀，避免 Re: Re: Re: 叠加。 */
 function stripRe(subject) {
-  return String(subject).replace(/^(\s*Re:\s*)+/i, "");
+	return String(subject).replace(/^(\s*Re:\s*)+/i, "");
 }
 
 // 每个 AgentMail 会话最近一封来信的上下文，用于决定总结回给谁。
@@ -817,16 +953,16 @@ const mailContexts = new BoundedMap(MAX_TRACKED_SESSIONS); // agentmail session_
  * @param {string} mailSessionID
  */
 function forgetSession(mailSessionID) {
-  if (!mailSessionID) return;
-  // peek 而不是 get：这是清理路径，不该把即将删掉的条目刷成「最近活跃」。
-  const opencodeID = sessionMap.peek(mailSessionID);
-  mailContexts.delete(mailSessionID);
-  sessionMap.delete(mailSessionID);
-  if (!opencodeID) return;
-  reverseMap.delete(opencodeID);
-  mailDrivenSessions.delete(opencodeID);
-  relayedSummaries.delete(opencodeID);
-  syncedTitles.delete(opencodeID);
+	if (!mailSessionID) return;
+	// peek 而不是 get：这是清理路径，不该把即将删掉的条目刷成「最近活跃」。
+	const opencodeID = sessionMap.peek(mailSessionID);
+	mailContexts.delete(mailSessionID);
+	sessionMap.delete(mailSessionID);
+	if (!opencodeID) return;
+	reverseMap.delete(opencodeID);
+	mailDrivenSessions.delete(opencodeID);
+	relayedSummaries.delete(opencodeID);
+	syncedTitles.delete(opencodeID);
 }
 
 // relaySummary 需要 client/directory，而 event 钩子拿不到它们
@@ -843,161 +979,180 @@ let relaySummaryRef = async () => null;
 // relay_key（= opencode 的 permission.id）由服务端随决策事件回传，
 // 所以插件重启丢了 pendingPermissions 也能续上 —— 这个映射不能只存在内存里。
 async function replyPermission(client, directory, data) {
-  const permID = data.relay_key || "";
-  if (!permID) {
-    // 没有上游 id 说明这条权限请求不是插件转发的（例如模型直接调过老的
-    // request_permission，或历史数据）。此时没有可回复的 opencode permission，
-    // 只能把结论作为一段话送进会话。
-    return deliverMail(client, directory, data, "permission");
-  }
+	const permID = data.relay_key || "";
+	if (!permID) {
+		// 没有上游 id 说明这条权限请求不是插件转发的（例如模型直接调过老的
+		// request_permission，或历史数据）。此时没有可回复的 opencode permission，
+		// 只能把结论作为一段话送进会话。
+		return deliverMail(client, directory, data, "permission");
+	}
 
-  const pending = pendingPermissions.get(permID);
-  const sessionID = pending?.sessionID || sessionMap.get(data.session_id || "");
-  if (!sessionID) {
-    console.error(`[mail-bridge] 权限 ${permID} 找不到对应会话，跳过`);
-    return null;
-  }
+	const pending = pendingPermissions.get(permID);
+	const sessionID = pending?.sessionID || sessionMap.get(data.session_id || "");
+	if (!sessionID) {
+		console.error(`[mail-bridge] 权限 ${permID} 找不到对应会话，跳过`);
+		return null;
+	}
 
-  const decision = String(data.decision || "");
-  // 三态映射，且**认不出的一律 reject**（fail closed，N-9）。
-  //
-  // 这里原先是 `... : "once"` —— 兜底落在放行一侧。那意味着任何意外文本
-  // （空串、历史数据里的旧选项、将来服务端新增的选项）都会放行一次
-  // 没人批准的危险操作。判断顺序也重要：always 必须先判，因为 isApproval
-  // 对「一直同意」同样为真。
-  const response = isAlwaysDecision(decision) ? "always"
-    : isApproval(decision) ? "once"
-    : "reject";
+	const decision = String(data.decision || "");
+	// 三态映射，且**认不出的一律 reject**（fail closed，N-9）。
+	//
+	// 这里原先是 `... : "once"` —— 兜底落在放行一侧。那意味着任何意外文本
+	// （空串、历史数据里的旧选项、将来服务端新增的选项）都会放行一次
+	// 没人批准的危险操作。判断顺序也重要：always 必须先判，因为 isApproval
+	// 对「一直同意」同样为真。
+	const response = isAlwaysDecision(decision)
+		? "always"
+		: isApproval(decision)
+			? "once"
+			: "reject";
 
-  await client.postSessionIdPermissionsPermissionId({
-    path: { id: sessionID, permissionID: permID },
-    query: directory ? { directory } : undefined,
-    body: { response },
-  });
-  pendingPermissions.delete(permID);
-  console.error(`[mail-bridge] 权限 ${permID} -> ${response}（决策人 ${data.decided_by || "?"}）`);
-  return { sessionID };
+	await client.postSessionIdPermissionsPermissionId({
+		path: { id: sessionID, permissionID: permID },
+		query: directory ? { directory } : undefined,
+		body: { response },
+	});
+	pendingPermissions.delete(permID);
+	console.error(
+		`[mail-bridge] 权限 ${permID} -> ${response}（决策人 ${data.decided_by || "?"}）`,
+	);
+	return { sessionID };
 }
 
 // 把一封来信投递给对应的 opencode 会话（已绑定则续谈，未绑定则新开）。
 async function deliverMail(client, directory, data, kind) {
-  const { sessionID, reused } = await resolveSessionForMail(client, directory, data, kind);
+	const { sessionID, reused } = await resolveSessionForMail(
+		client,
+		directory,
+		data,
+		kind,
+	);
 
-  // 新一轮开始：清掉上一轮「模型主动发过信」的记录。
-  // 不清的话，上一轮亲手回过信会永久压掉这个会话之后所有的自动转发。
-  explicitSends.delete(sessionID);
+	// 新一轮开始：清掉上一轮「模型主动发过信」的记录。
+	// 不清的话，上一轮亲手回过信会永久压掉这个会话之后所有的自动转发。
+	explicitSends.delete(sessionID);
 
-  // 回信上下文：idle 时 relaySummary 靠它决定收件人与 reply_to。
-  // 一个会话里可能来过多封信，只保留最近那封 —— 回信要落回最新的线索。
-  //
-  // 多记两个服务端信号：
-  //   fromHuman  —— 只有人类来信才自动转发（见 lib/relay-policy.js）
-  //   inReplyTo  —— 这封是不是对本方某封信的回复
-  // 不存进上下文的话，relaySummary 那一刻拿不到它们（那个函数只有 sessionID）。
-  if (kind === "mail" && data.session_id) {
-    mailContexts.set(data.session_id, {
-      replyTo: data.from_name || "",
-      subject: data.subject || "",
-      mailID: data.mail_id || "",
-      fromHuman: data.from_human === true,
-      inReplyTo: data.in_reply_to || "",
-    });
-  }
+	// 回信上下文：idle 时 relaySummary 靠它决定收件人与 reply_to。
+	// 一个会话里可能来过多封信，只保留最近那封 —— 回信要落回最新的线索。
+	//
+	// 多记两个服务端信号：
+	//   fromHuman  —— 只有人类来信才自动转发（见 lib/relay-policy.js）
+	//   inReplyTo  —— 这封是不是对本方某封信的回复
+	// 不存进上下文的话，relaySummary 那一刻拿不到它们（那个函数只有 sessionID）。
+	if (kind === "mail" && data.session_id) {
+		mailContexts.set(data.session_id, {
+			replyTo: data.from_name || "",
+			subject: data.subject || "",
+			mailID: data.mail_id || "",
+			fromHuman: data.from_human === true,
+			inReplyTo: data.in_reply_to || "",
+		});
+	}
 
-  const fromHuman = data.from_human === true;
-  // opencode 1.18+ 不支持 session.create permission 参数，
-  // 只能在提示词里告知模型档位约束（advisory 路径）。
-  const permBriefing = modeBriefing({ mode: normalizeMode(data.permission_mode), enforcement: 'advisory', workspace: directory || '' });
-  const text = kind === "permission"
-    ? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || "用户"}）。请据此继续后续工作。`
-    : [
-        inboundHeadline({
-          inReplyTo: data.in_reply_to,
-          fromHuman,
-          catchup: data.catchup,
-          reused,
-        }),
-        ``,
-        `发件人：${data.from_name || "unknown"}`,
-        `主题：${data.subject || "(无主题)"}`,
-        `邮件 ID：${data.mail_id || "unknown"}`,
-        ...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
-        `身份：你是 ${AGENT_NAME}`,
-        ...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
-        ``,
-        `请先调用 read_inbox 读取完整正文（附带附件清单，如有附件可用 download_attachment 取回），然后处理其中的请求。`,
-        ``,
-        ...replyInstruction({ fromHuman, replyAddress: data.reply_address }),
-        ``,
-        permBriefing,
-      ].join("\n");
+	const fromHuman = data.from_human === true;
+	// opencode 1.18+ 不支持 session.create permission 参数，
+	// 只能在提示词里告知模型档位约束（advisory 路径）。
+	const permBriefing = modeBriefing({
+		mode: normalizeMode(data.permission_mode),
+		enforcement: "advisory",
+		workspace: directory || "",
+	});
+	const text =
+		kind === "permission"
+			? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || "用户"}）。请据此继续后续工作。`
+			: [
+					inboundHeadline({
+						inReplyTo: data.in_reply_to,
+						fromHuman,
+						catchup: data.catchup,
+						reused,
+					}),
+					``,
+					`发件人：${data.from_name || "unknown"}`,
+					`主题：${data.subject || "(无主题)"}`,
+					`邮件 ID：${data.mail_id || "unknown"}`,
+					...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
+					`身份：你是 ${AGENT_NAME}`,
+					...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
+					``,
+					`请先调用 read_inbox 读取完整正文（附带附件清单，如有附件可用 download_attachment 取回），然后处理其中的请求。`,
+					``,
+					...replyInstruction({ fromHuman, replyAddress: data.reply_address }),
+					``,
+					permBriefing,
+				].join("\n");
 
-  // 按管理员划定的范围逐个尝试，全部失败才回一封说明失败原因的邮件。
-  //
-  // 必须发那封信：模型一次都没跑起来时会话里没有任何 assistant 消息，
-  // 自动转发因此什么也不会发 —— 发件人只会看到邮件发出去后再无音讯。
-  //
-  // **promptAsync 返回不代表模型跑起来了**（名字里的 Async 就是这个意思）：
-  // 无效 provider 的失败通过 `session.error` 事件到达，而不是它的 reject。
-  // 因此只包 try/catch 的话第二个模型永远不会被试到 —— 用 awaitFirstTurn 等结论。
-  const attempts = modelAttemptOrder(allowedModels, {
-    provider: REPLY_PROVIDER,
-    model: REPLY_MODEL,
-  });
-  const failures = [];
+	// 按管理员划定的范围逐个尝试，全部失败才回一封说明失败原因的邮件。
+	//
+	// 必须发那封信：模型一次都没跑起来时会话里没有任何 assistant 消息，
+	// 自动转发因此什么也不会发 —— 发件人只会看到邮件发出去后再无音讯。
+	//
+	// **promptAsync 返回不代表模型跑起来了**（名字里的 Async 就是这个意思）：
+	// 无效 provider 的失败通过 `session.error` 事件到达，而不是它的 reject。
+	// 因此只包 try/catch 的话第二个模型永远不会被试到 —— 用 awaitFirstTurn 等结论。
+	const attempts = modelAttemptOrder(allowedModels, {
+		provider: REPLY_PROVIDER,
+		model: REPLY_MODEL,
+	});
+	const failures = [];
 
-  for (const route of attempts) {
-    const label = route ? `${route.provider}/${route.model}` : "(平台默认)";
-    const watching = awaitFirstTurn(sessionID);
-    try {
-      await client.session.promptAsync({
-        path: { id: sessionID },
-        query: directory ? { directory } : undefined,
-        body: {
-          // route 为 undefined 表示不指定模型，交给平台自己选
-          ...(route ? { model: { providerID: route.provider, modelID: route.model } } : {}),
-          parts: [{ type: "text", text }],
-        },
-      });
-    } catch (e) {
-      // 同步就被拒（参数非法、会话不存在等）
-      watching.cancel();
-      failures.push({ ...(route ?? {}), error: e?.message || String(e) });
-      console.error(`[mail-bridge] 模型 ${label} 提交失败:`, e?.message || e);
-      continue;
-    }
+	for (const route of attempts) {
+		const label = route ? `${route.provider}/${route.model}` : "(平台默认)";
+		const watching = awaitFirstTurn(sessionID);
+		try {
+			await client.session.promptAsync({
+				path: { id: sessionID },
+				query: directory ? { directory } : undefined,
+				body: {
+					// route 为 undefined 表示不指定模型，交给平台自己选
+					...(route
+						? { model: { providerID: route.provider, modelID: route.model } }
+						: {}),
+					parts: [{ type: "text", text }],
+				},
+			});
+		} catch (e) {
+			// 同步就被拒（参数非法、会话不存在等）
+			watching.cancel();
+			failures.push({ ...(route ?? {}), error: e?.message || String(e) });
+			console.error(`[mail-bridge] 模型 ${label} 提交失败:`, e?.message || e);
+			continue;
+		}
 
-    const outcome = await watching.result;
-    if (outcome.ok) {
-      if (failures.length > 0) {
-        console.error(`[mail-bridge] ${label} 成功（前 ${failures.length} 个失败）`);
-      }
-      return { sessionID, reused };
-    }
-    failures.push({ ...(route ?? {}), error: outcome.error });
-    console.error(`[mail-bridge] 模型 ${label} 失败:`, outcome.error);
-  }
+		const outcome = await watching.result;
+		if (outcome.ok) {
+			if (failures.length > 0) {
+				console.error(
+					`[mail-bridge] ${label} 成功（前 ${failures.length} 个失败）`,
+				);
+			}
+			return { sessionID, reused };
+		}
+		failures.push({ ...(route ?? {}), error: outcome.error });
+		console.error(`[mail-bridge] 模型 ${label} 失败:`, outcome.error);
+	}
 
-  // 全部失败：把原因作为邮件回给发件人。走免配额通道 ——
-  // 这是插件的故障报告，不是模型的自主发信。
-  if (kind === "mail" && data.from_name) {
-    try {
-      await apiPost("/mail/send", {
-        to: data.from_name,
-        subject: `处理失败: ${data.subject || "(无主题)"}`,
-        body: renderFailureReport(failures, data.subject),
-        reply_to: data.mail_id || "",
-        relay: "summary",
-        relay_key: clampRelayKey(`model-failure:${data.mail_id || sessionID}`),
-      });
-      console.error(`[mail-bridge] 已回报模型调用失败给 ${data.from_name}`);
-    } catch (e) {
-      console.error("[mail-bridge] 失败回报也发不出去:", e?.message || e);
-    }
-  }
-  throw new Error(
-    `划定范围内的 ${failures.length} 个模型全部失败：` +
-    failures.map(f => f.error).join(" | "));
+	// 全部失败：把原因作为邮件回给发件人。走免配额通道 ——
+	// 这是插件的故障报告，不是模型的自主发信。
+	if (kind === "mail" && data.from_name) {
+		try {
+			await apiPost("/mail/send", {
+				to: data.from_name,
+				subject: `处理失败: ${data.subject || "(无主题)"}`,
+				body: renderFailureReport(failures, data.subject),
+				reply_to: data.mail_id || "",
+				relay: "summary",
+				relay_key: clampRelayKey(`model-failure:${data.mail_id || sessionID}`),
+			});
+			console.error(`[mail-bridge] 已回报模型调用失败给 ${data.from_name}`);
+		} catch (e) {
+			console.error("[mail-bridge] 失败回报也发不出去:", e?.message || e);
+		}
+	}
+	throw new Error(
+		`划定范围内的 ${failures.length} 个模型全部失败：` +
+			failures.map((f) => f.error).join(" | "),
+	);
 }
 
 // ─── 首轮结果观察 ───
@@ -1017,364 +1172,400 @@ const turnWatchers = new Map(); // sessionID -> { resolve, timer }
  * @param {number} timeoutMs 判定窗口
  */
 function awaitFirstTurn(sessionID, timeoutMs = 60000) {
-  let settle;
-  const result = new Promise(res => { settle = res; });
-  const finish = (r) => {
-    const w = turnWatchers.get(sessionID);
-    if (!w) return;
-    clearTimeout(w.timer);
-    turnWatchers.delete(sessionID);
-    w.resolve(r);
-  };
-  const timer = setTimeout(() => finish({ ok: true }), timeoutMs);
-  turnWatchers.set(sessionID, { resolve: settle, timer });
-  return {
-    result,
-    cancel: () => finish({ ok: true }),
-  };
+	let settle;
+	const result = new Promise((res) => {
+		settle = res;
+	});
+	const finish = (r) => {
+		const w = turnWatchers.get(sessionID);
+		if (!w) return;
+		clearTimeout(w.timer);
+		turnWatchers.delete(sessionID);
+		w.resolve(r);
+	};
+	const timer = setTimeout(() => finish({ ok: true }), timeoutMs);
+	turnWatchers.set(sessionID, { resolve: settle, timer });
+	return {
+		result,
+		cancel: () => finish({ ok: true }),
+	};
 }
 
 /** event 钩子调用：这个会话的首轮有结论了。 */
 function settleFirstTurn(sessionID, outcome) {
-  const w = turnWatchers.get(sessionID);
-  if (!w) return false;
-  clearTimeout(w.timer);
-  turnWatchers.delete(sessionID);
-  w.resolve(outcome);
-  return true;
+	const w = turnWatchers.get(sessionID);
+	if (!w) return false;
+	clearTimeout(w.timer);
+	turnWatchers.delete(sessionID);
+	w.resolve(outcome);
+	return true;
 }
 
 export default async function mailBridge(input) {
-  const { client, directory } = input;
+	const { client, directory } = input;
 
-  // 注册 Agent。无密钥也无 secret 时先本地生成一把密钥，
-  // 等管理员在后台登记后即可接入（无需重装插件）。
-  if (!AGENT_KEY && !AGENT_SECRET) {
-    AGENT_KEY = generateLocalKey();
-  }
-  try {
-    await apiPost("/agent/register", {
-      name: AGENT_NAME,
-      secret: AGENT_KEY ? "" : AGENT_SECRET,
-      workspaces: [],
-      platform: "opencode",
-    });
-    saveConfig({ registered_at: new Date().toISOString() });
-    console.error(
-      `[mail-bridge] 已接入 ${GATEWAY_URL}，身份 ${AGENT_NAME}` +
-        `（${AGENT_KEY ? "密钥认证" : "name/secret 认证"}）。`
-    );
-  } catch (e) {
-    // 密钥未登记时这里会报「密钥无效」——必须说清楚该做什么，
-    // 否则用户只看到一句 401 不知道要拿密钥去后台登记。
-    console.error("[mail-bridge] 注册失败:", e?.message);
-    if (AGENT_KEY) {
-      console.error(`[mail-bridge] 若提示密钥无效，请让管理员在 AgentMail 后台登记这把密钥（见 ${KEY_FILE}）。`);
-    }
-  }
+	// 注册 Agent。无密钥也无 secret 时先本地生成一把密钥，
+	// 等管理员在后台登记后即可接入（无需重装插件）。
+	if (!AGENT_KEY && !AGENT_SECRET) {
+		AGENT_KEY = generateLocalKey();
+	}
+	try {
+		await apiPost("/agent/register", {
+			name: AGENT_NAME,
+			secret: AGENT_KEY ? "" : AGENT_SECRET,
+			workspaces: [],
+			platform: "opencode",
+		});
+		saveConfig({ registered_at: new Date().toISOString() });
+		console.error(
+			`[mail-bridge] 已接入 ${GATEWAY_URL}，身份 ${AGENT_NAME}` +
+				`（${AGENT_KEY ? "密钥认证" : "name/secret 认证"}）。`,
+		);
+	} catch (e) {
+		// 密钥未登记时这里会报「密钥无效」——必须说清楚该做什么，
+		// 否则用户只看到一句 401 不知道要拿密钥去后台登记。
+		console.error("[mail-bridge] 注册失败:", e?.message);
+		if (AGENT_KEY) {
+			console.error(
+				`[mail-bridge] 若提示密钥无效，请让管理员在 AgentMail 后台登记这把密钥（见 ${KEY_FILE}）。`,
+			);
+		}
+	}
 
-  // event 钩子里拿不到 client/directory（它们只在插件初始化时给），
-  // 所以用一个闭包把 relaySummary 需要的两个参数固定下来。
-  relaySummaryRef = (sid) => relaySummary(client, directory, sid);
+	// event 钩子里拿不到 client/directory（它们只在插件初始化时给），
+	// 所以用一个闭包把 relaySummary 需要的两个参数固定下来。
+	relaySummaryRef = (sid) => relaySummary(client, directory, sid);
 
-  // 心跳。保活、取待处理邮件数，并上报平台侧的会话快照。
-  //
-  // 额度属于具体任务（会话），不属于 Agent，所以这里没有「剩余额度」可报。
-  // 剩余往返随每次发信响应的 budget_remaining 回传，在那里才有意义。
-  //
-  // 会话快照解决的是「工作区下的历史会话在补全里选不到」：Gateway 只看得见
-  // 邮件驱动的那部分，人直接在 opencode 界面上开的会话它一无所知。
-  // 让插件上报而不是让 Gateway 反向拉取 —— 当前架构是单向的，
-  // 反向拉取需要 Gateway 保存各平台的地址与凭证。
-  async function reportSessions() {
-    try {
-      const listed = await client.session.list({
-        query: directory ? { directory } : undefined,
-      });
-      const sessions = listed?.data ?? listed ?? [];
-      return snapshotOpencodeSessions(sessions, (id) => mailDrivenSessions.has(id));
-    } catch (e) {
-      // 拉不到列表就**省略**该字段，而不是传空数组：
-      // 空数组的语义是「平台侧确实一条会话都没有」，会把服务端的镜像抹掉。
-      console.error("[mail-bridge] 会话列表读取失败:", e?.message || e);
-      return undefined;
-    }
-  }
+	// 心跳。保活、取待处理邮件数，并上报平台侧的会话快照。
+	//
+	// 额度属于具体任务（会话），不属于 Agent，所以这里没有「剩余额度」可报。
+	// 剩余往返随每次发信响应的 budget_remaining 回传，在那里才有意义。
+	//
+	// 会话快照解决的是「工作区下的历史会话在补全里选不到」：Gateway 只看得见
+	// 邮件驱动的那部分，人直接在 opencode 界面上开的会话它一无所知。
+	// 让插件上报而不是让 Gateway 反向拉取 —— 当前架构是单向的，
+	// 反向拉取需要 Gateway 保存各平台的地址与凭证。
+	async function reportSessions() {
+		try {
+			const listed = await client.session.list({
+				query: directory ? { directory } : undefined,
+			});
+			const sessions = listed?.data ?? listed ?? [];
+			return snapshotOpencodeSessions(sessions, (id) =>
+				mailDrivenSessions.has(id),
+			);
+		} catch (e) {
+			// 拉不到列表就**省略**该字段，而不是传空数组：
+			// 空数组的语义是「平台侧确实一条会话都没有」，会把服务端的镜像抹掉。
+			console.error("[mail-bridge] 会话列表读取失败:", e?.message || e);
+			return undefined;
+		}
+	}
 
-  // 模型目录：随心跳上报，让配置页看到的清单跟着平台的实际状态走。
-  //
-  // 只在注册时报一次的话目录会静静变陈（换 provider 配置、上游上下线、
-  // 换 API key 都会让它失准），管理员会选中一个平台其实调不到的模型，
-  // 而失败要到真发邮件时才暴露。
-  async function reportModels() {
-    try {
-      const cfg = await client.config.providers();
-      return snapshotOpencodeModels(cfg?.data ?? cfg);
-    } catch (e) {
-      // 拉不到就**省略**该字段，而不是传空数组：
-      // 空数组的语义是「平台确实一个模型都拿不到」，会把配置页清成空白。
-      console.error("[mail-bridge] 模型目录读取失败:", e?.message || e);
-      return undefined;
-    }
-  }
+	// 模型目录：随心跳上报，让配置页看到的清单跟着平台的实际状态走。
+	//
+	// 只在注册时报一次的话目录会静静变陈（换 provider 配置、上游上下线、
+	// 换 API key 都会让它失准），管理员会选中一个平台其实调不到的模型，
+	// 而失败要到真发邮件时才暴露。
+	async function reportModels() {
+		try {
+			const cfg = await client.config.providers();
+			return snapshotOpencodeModels(cfg?.data ?? cfg);
+		} catch (e) {
+			// 拉不到就**省略**该字段，而不是传空数组：
+			// 空数组的语义是「平台确实一个模型都拿不到」，会把配置页清成空白。
+			console.error("[mail-bridge] 模型目录读取失败:", e?.message || e);
+			return undefined;
+		}
+	}
 
-  // 已经投过的 mail_id。心跳与 SSE 建连之间有个窗口：那期间到的邮件
-  // 既在 pending_mails 里、也会被 SSE 推一次 —— 不去重就会投两遍。
-  //
-  // 有界：插件跟着 opencode serve 一起长期活着，这里会攒下每一封处理过的
-  // 邮件 id 而永远没有出口。淘汰是安全的 —— 它防的两种重复都发生在秒到分钟级。
-  const deliveredMails = new BoundedSet(MAX_TRACKED_MAILS);
+	// 已经投过的 mail_id。心跳与 SSE 建连之间有个窗口：那期间到的邮件
+	// 既在 pending_mails 里、也会被 SSE 推一次 —— 不去重就会投两遍。
+	//
+	// 有界：插件跟着 opencode serve 一起长期活着，这里会攒下每一封处理过的
+	// 邮件 id 而永远没有出口。淘汰是安全的 —— 它防的两种重复都发生在秒到分钟级。
+	const deliveredMails = new BoundedSet(MAX_TRACKED_MAILS);
 
-  /**
-   * 补投离线期间积压的未读邮件。
-   *
-   * SSE 只推连上之后的事件，插件重启前发来的邮件不会再推一次。
-   * 不补的话那封邮件永远躺在收件箱里，而发件人以为 Agent 收到了。
-   */
-  async function catchUp(pending) {
-    if (!pending) return;
-    try {
-      const box = await apiGet("/mail/inbox?status=unread&limit=20");
-      const tasks = selectCatchup(box?.mails ?? box, deliveredMails);
-      if (tasks.length === 0) return;
-      console.error(`[mail-bridge] 补投 ${tasks.length} 封离线期间的邮件（共 ${pending} 封未读）`);
-      // 串行：每封都要起一轮模型，并发放出去等于对上游打 N 个并发请求
-      for (const ev of tasks) {
-        // 逐封再查一次：拉收件箱和逐封投递之间 SSE 可能已经投过其中某封
-        // （selectCatchup 只在拉完那一刻去过重）
-        if (deliveredMails.has(ev.mail_id)) continue;
-        deliveredMails.add(ev.mail_id);
-        try {
-          await deliverMail(client, directory, ev, "mail");
-        } catch (e) {
-          console.error(`[mail-bridge] 补投 ${ev.mail_id} 失败:`, e?.message || e);
-        }
-      }
-    } catch (e) {
-      console.error("[mail-bridge] 补投失败:", e?.message || e);
-    }
-  }
+	/**
+	 * 补投离线期间积压的未读邮件。
+	 *
+	 * SSE 只推连上之后的事件，插件重启前发来的邮件不会再推一次。
+	 * 不补的话那封邮件永远躺在收件箱里，而发件人以为 Agent 收到了。
+	 */
+	async function catchUp(pending) {
+		if (!pending) return;
+		try {
+			const box = await apiGet("/mail/inbox?status=unread&limit=20");
+			const tasks = selectCatchup(box?.mails ?? box, deliveredMails);
+			if (tasks.length === 0) return;
+			console.error(
+				`[mail-bridge] 补投 ${tasks.length} 封离线期间的邮件（共 ${pending} 封未读）`,
+			);
+			// 串行：每封都要起一轮模型，并发放出去等于对上游打 N 个并发请求
+			for (const ev of tasks) {
+				// 逐封再查一次：拉收件箱和逐封投递之间 SSE 可能已经投过其中某封
+				// （selectCatchup 只在拉完那一刻去过重）
+				if (deliveredMails.has(ev.mail_id)) continue;
+				deliveredMails.add(ev.mail_id);
+				try {
+					await deliverMail(client, directory, ev, "mail");
+				} catch (e) {
+					console.error(
+						`[mail-bridge] 补投 ${ev.mail_id} 失败:`,
+						e?.message || e,
+					);
+				}
+			}
+		} catch (e) {
+			console.error("[mail-bridge] 补投失败:", e?.message || e);
+		}
+	}
 
-  let caughtUp = false;
+	let caughtUp = false;
 
-  const beat = async () => {
-    const [platform_sessions, models] = await Promise.all([
-      reportSessions(),
-      reportModels(),
-    ]);
-    const body = {};
-    // opencode 1.18+ 的 session.create 不支持 permission 参数，
-    // 权限只能通过提示词告知模型（advisory）。
-    body.mode_enforcement = 'advisory';
-    if (platform_sessions) body.platform_sessions = platform_sessions;
-    if (models) body.models = models;
-    try {
-      const res = await apiPost("/agent/heartbeat", body);
-      // 生效的模型范围随心跳响应回传：管理员在配置页改了范围后，
-      // 插件最多一个周期（30 秒）就能看到新值，不需要重启。
-      if (Array.isArray(res?.allowed_models)) allowedModels = res.allowed_models;
-      // 只在首个成功的心跳后补投一次：之后的积压都由 SSE 覆盖，
-      // 每轮心跳都补的话会把「模型正在处理中、尚未标已读」的邮件重复投递。
-      if (!caughtUp) {
-        caughtUp = true;
-        await catchUp(res?.pending_mails);
-      }
-    } catch {
-      // 心跳失败不报错：网络抖动很常见，下一轮会补上。
-      // 真的持续连不上时 Gateway 会把它判成离线，那才是可见的信号。
-    }
-  };
-  beat();
-  const heartbeat = setInterval(beat, 30000);
+	const beat = async () => {
+		const [platform_sessions, models] = await Promise.all([
+			reportSessions(),
+			reportModels(),
+		]);
+		const body = {};
+		// opencode 1.18+ 的 session.create 不支持 permission 参数，
+		// 权限只能通过提示词告知模型（advisory）。
+		body.mode_enforcement = "advisory";
+		if (platform_sessions) body.platform_sessions = platform_sessions;
+		if (models) body.models = models;
+		try {
+			const res = await apiPost("/agent/heartbeat", body);
+			// 生效的模型范围随心跳响应回传：管理员在配置页改了范围后，
+			// 插件最多一个周期（30 秒）就能看到新值，不需要重启。
+			if (Array.isArray(res?.allowed_models))
+				allowedModels = res.allowed_models;
+			// 只在首个成功的心跳后补投一次：之后的积压都由 SSE 覆盖，
+			// 每轮心跳都补的话会把「模型正在处理中、尚未标已读」的邮件重复投递。
+			if (!caughtUp) {
+				caughtUp = true;
+				await catchUp(res?.pending_mails);
+			}
+		} catch {
+			// 心跳失败不报错：网络抖动很常见，下一轮会补上。
+			// 真的持续连不上时 Gateway 会把它判成离线，那才是可见的信号。
+		}
+	};
+	beat();
+	const heartbeat = setInterval(beat, 30000);
 
-  startSSE((type, data) => {
-    // 人类决策了一条权限请求 → 回复 opencode 的原生 permission，让它自己恢复执行。
-    // 这条路径不走 deliverMail：opencode 的权限机制会在收到回复后继续原来的工具调用，
-    // 再往会话里塞一段「你的请求已批准」的文字只会干扰它。
-    if (type === "permission_decision") {
-      replyPermission(client, directory, data).catch((e) => {
-        console.error("[mail-bridge] 权限决策回传失败:", e?.message || e);
-      });
-      return;
-    }
+	startSSE((type, data) => {
+		// 人类决策了一条权限请求 → 回复 opencode 的原生 permission，让它自己恢复执行。
+		// 这条路径不走 deliverMail：opencode 的权限机制会在收到回复后继续原来的工具调用，
+		// 再往会话里塞一段「你的请求已批准」的文字只会干扰它。
+		if (type === "permission_decision") {
+			replyPermission(client, directory, data).catch((e) => {
+				console.error("[mail-bridge] 权限决策回传失败:", e?.message || e);
+			});
+			return;
+		}
 
-    if (type === "session_archived") {
-      // 会话归档 = 那条会话再也不会收信，映射可以确定性地清掉（不必等上限淘汰）。
-      forgetSession(data?.session_id || "");
-      return;
-    }
+		if (type === "session_archived") {
+			// 会话归档 = 那条会话再也不会收信，映射可以确定性地清掉（不必等上限淘汰）。
+			forgetSession(data?.session_id || "");
+			return;
+		}
 
-    if (type !== "new_mail") return;
-    if (data?.mail_id) deliveredMails.add(data.mail_id);
-    deliverMail(client, directory, data, "mail")
-      .then(({ sessionID, reused }) => {
-        console.error(`[mail-bridge] ${type} -> ${reused ? "续谈" : "新会话"} ${sessionID}`);
-      })
-      .catch((e) => {
-        // 失败必须可见，否则邮件会静默丢失
-        console.error(`[mail-bridge] ${type} 处理失败:`, e?.message || e);
-      });
-  });
+		if (type !== "new_mail") return;
+		if (data?.mail_id) deliveredMails.add(data.mail_id);
+		deliverMail(client, directory, data, "mail")
+			.then(({ sessionID, reused }) => {
+				console.error(
+					`[mail-bridge] ${type} -> ${reused ? "续谈" : "新会话"} ${sessionID}`,
+				);
+			})
+			.catch((e) => {
+				// 失败必须可见，否则邮件会静默丢失
+				console.error(`[mail-bridge] ${type} 处理失败:`, e?.message || e);
+			});
+	});
 
-  process.on("SIGINT", () => {
-    clearInterval(heartbeat);
-    if (sseClientRef) sseClientRef.stop();
-  });
+	process.on("SIGINT", () => {
+		clearInterval(heartbeat);
+		if (sseClientRef) sseClientRef.stop();
+	});
 
-  return {
-    // 平台原生的权限询问 → 转成邮件问人。
-    //
-    // 这是 harness 的职责，不该让模型自己调一个 request_permission 工具：
-    // 模型可能忘了调，也可能在不需要时乱调，而真正被 opencode 拦下的那次询问反而没人看见。
-    //
-    // 钩子里只**记下**待决策项并转出邮件，status 保持 "ask" —— 不在这里阻塞等人回复：
-    // permission.ask 是同步钩子，卡在这里会把整个 opencode 请求挂住。
-    // 人类决策通过 SSE 回来后，再用 SDK 回复这条 permission。
-    async "permission.ask"(input, output) {
-      if (!mailDrivenSessions.has(input.sessionID)) return; // 非邮件驱动的会话不接管
-      const mailSessionID = reverseMap.get(input.sessionID);
-      if (!mailSessionID) return;
+	return {
+		// 平台原生的权限询问 → 转成邮件问人。
+		//
+		// 这是 harness 的职责，不该让模型自己调一个 request_permission 工具：
+		// 模型可能忘了调，也可能在不需要时乱调，而真正被 opencode 拦下的那次询问反而没人看见。
+		//
+		// 钩子里只**记下**待决策项并转出邮件，status 保持 "ask" —— 不在这里阻塞等人回复：
+		// permission.ask 是同步钩子，卡在这里会把整个 opencode 请求挂住。
+		// 人类决策通过 SSE 回来后，再用 SDK 回复这条 permission。
+		async "permission.ask"(input, output) {
+			if (!mailDrivenSessions.has(input.sessionID)) return; // 非邮件驱动的会话不接管
+			const mailSessionID = reverseMap.get(input.sessionID);
+			if (!mailSessionID) return;
 
-      pendingPermissions.set(input.id, {
-        sessionID: input.sessionID,
-        callID: input.callID || "",
-      });
+			pendingPermissions.set(input.id, {
+				sessionID: input.sessionID,
+				callID: input.callID || "",
+			});
 
-      try {
-        // opencode 的权限语义是三态，映射成人类看得懂的选项：
-        // 「同意」= once（仅这次），「一直同意」= always（后续同类不再问），「拒绝」= reject
-        await relayPermission({
-          question: input.title || `请求执行 ${input.type}`,
-          options: ["同意", "一直同意", "拒绝"],
-          context: [
-            `类型：${input.type}`,
-            input.pattern ? `目标：${Array.isArray(input.pattern) ? input.pattern.join(", ") : input.pattern}` : "",
-            Object.keys(input.metadata || {}).length
-              ? "\n```json\n" + JSON.stringify(input.metadata, null, 2) + "\n```"
-              : "",
-          ].filter(Boolean).join("\n"),
-          relayKey: clampRelayKey(input.id),
-        });
-        console.error(`[mail-bridge] 权限询问已转邮件 ${input.id}（${input.type}）`);
-      } catch (e) {
-        pendingPermissions.delete(input.id);
+			try {
+				// opencode 的权限语义是三态，映射成人类看得懂的选项：
+				// 「同意」= once（仅这次），「一直同意」= always（后续同类不再问），「拒绝」= reject
+				await relayPermission({
+					question: input.title || `请求执行 ${input.type}`,
+					options: ["同意", "一直同意", "拒绝"],
+					context: [
+						`类型：${input.type}`,
+						input.pattern
+							? `目标：${Array.isArray(input.pattern) ? input.pattern.join(", ") : input.pattern}`
+							: "",
+						Object.keys(input.metadata || {}).length
+							? "\n```json\n" +
+								JSON.stringify(input.metadata, null, 2) +
+								"\n```"
+							: "",
+					]
+						.filter(Boolean)
+						.join("\n"),
+					relayKey: clampRelayKey(input.id),
+				});
+				console.error(
+					`[mail-bridge] 权限询问已转邮件 ${input.id}（${input.type}）`,
+				);
+			} catch (e) {
+				pendingPermissions.delete(input.id);
 
-        // 4xx = 请求本身被服务端拒绝，重试一万次也是同一个结果。
-        //
-        // 必须当场 deny：保持 "ask" 等于把会话交给本地 TUI 弹窗，
-        // 而邮件驱动的会话根本没有 TUI —— 模型会永久挂在那里。
-        //
-        // 两个真实事故都是这个形状：
-        //   409：pi 把任务派给自己另一条会话，那条要跑 bash，
-        //       权限邮件无人可投，整条线索卡死
-        //   400：relay_key 超长（extended thinking 把思考签名拼进了 toolCallId），
-        //       被当暂时失败让位 → 那条命令无人批准就执行了
-        //
-        // deny 的同时把原因带给模型（opencode 把 reason 作为工具报错回去），
-        // 它才知道下一步该换什么做法。
-        if (isPermanentFailure(e)) {
-          const b = e?.body || {};
-          console.error(
-            `[mail-bridge] 权限询问遇到永久失败（HTTP ${e?.status}），当场拒绝 ${input.id}：${b.error || e?.message || ""}`,
-          );
-          output.status = "deny";
-          output.reason = [
-            b.error || `无法把授权请求送达给人类（HTTP ${e?.status}）`,
-            b.detail || "",
-            b.suggestion || "这是一个不会因重试而改变的失败。请改用不需要授权的方式完成，或在回信里说明需要人工执行哪一步。",
-          ].filter(Boolean).join("\n");
-          return;
-        }
+				// 4xx = 请求本身被服务端拒绝，重试一万次也是同一个结果。
+				//
+				// 必须当场 deny：保持 "ask" 等于把会话交给本地 TUI 弹窗，
+				// 而邮件驱动的会话根本没有 TUI —— 模型会永久挂在那里。
+				//
+				// 两个真实事故都是这个形状：
+				//   409：pi 把任务派给自己另一条会话，那条要跑 bash，
+				//       权限邮件无人可投，整条线索卡死
+				//   400：relay_key 超长（extended thinking 把思考签名拼进了 toolCallId），
+				//       被当暂时失败让位 → 那条命令无人批准就执行了
+				//
+				// deny 的同时把原因带给模型（opencode 把 reason 作为工具报错回去），
+				// 它才知道下一步该换什么做法。
+				if (isPermanentFailure(e)) {
+					const b = e?.body || {};
+					console.error(
+						`[mail-bridge] 权限询问遇到永久失败（HTTP ${e?.status}），当场拒绝 ${input.id}：${b.error || e?.message || ""}`,
+					);
+					output.status = "deny";
+					output.reason = [
+						b.error || `无法把授权请求送达给人类（HTTP ${e?.status}）`,
+						b.detail || "",
+						b.suggestion ||
+							"这是一个不会因重试而改变的失败。请改用不需要授权的方式完成，或在回信里说明需要人工执行哪一步。",
+					]
+						.filter(Boolean)
+						.join("\n");
+					return;
+				}
 
-        // 暂时失败（5xx / 408 / 429 / 网络拖动）保持 ask：那些真的可能下一次就好，
-        // 人也仍可能在本地看到弹窗，不该把一次抖动当成永久拒绝。
-        console.error("[mail-bridge] 权限询问转发暂时失败（保持 ask）:", e?.message || e);
-        return;
-      }
-      output.status = "ask";
-    },
+				// 暂时失败（5xx / 408 / 429 / 网络拖动）保持 ask：那些真的可能下一次就好，
+				// 人也仍可能在本地看到弹窗，不该把一次抖动当成永久拒绝。
+				console.error(
+					"[mail-bridge] 权限询问转发暂时失败（保持 ask）:",
+					e?.message || e,
+				);
+				return;
+			}
+			output.status = "ask";
+		},
 
-    async event({ event }) {
-      // 1) opencode 生成/更新会话标题时，把标题与 slug 回写成 AgentMail 的会话命名。
-      //    首轮对话结束后 opencode 才由模型定标题，所以只能靠事件而非创建时刻拿到。
-      if (event?.type === "session.updated") {
-        const info = event.properties?.info;
-        if (!info?.id) return;
+		async event({ event }) {
+			// 1) opencode 生成/更新会话标题时，把标题与 slug 回写成 AgentMail 的会话命名。
+			//    首轮对话结束后 opencode 才由模型定标题，所以只能靠事件而非创建时刻拿到。
+			if (event?.type === "session.updated") {
+				const info = event.properties?.info;
+				if (!info?.id) return;
 
-        const mailSessionID = reverseMap.get(info.id);
-        if (!mailSessionID) return; // 不是邮件驱动的会话，不碰
+				const mailSessionID = reverseMap.get(info.id);
+				if (!mailSessionID) return; // 不是邮件驱动的会话，不碰
 
-        // "New session - <时间>" 是 opencode 的占位标题，等模型生成真摘要再回写
-        const title = typeof info.title === "string" ? info.title : "";
-        if (!title || title.startsWith("New session")) return;
+				// "New session - <时间>" 是 opencode 的占位标题，等模型生成真摘要再回写
+				const title = typeof info.title === "string" ? info.title : "";
+				if (!title || title.startsWith("New session")) return;
 
-        // 同一标题只回写一次，避免 session.updated 高频触发时反复打网关
-        if (syncedTitles.get(info.id) === title) return;
-        syncedTitles.set(info.id, title);
+				// 同一标题只回写一次，避免 session.updated 高频触发时反复打网关
+				if (syncedTitles.get(info.id) === title) return;
+				syncedTitles.set(info.id, title);
 
-        const res = await syncSessionNaming(mailSessionID, { alias: info.slug || "", title });
-        if (res) {
-          console.error(`[mail-bridge] 会话命名同步 ${info.id} -> alias=${res.alias || "-"} title=${res.title || "-"}`);
-        }
-        return;
-      }
+				const res = await syncSessionNaming(mailSessionID, {
+					alias: info.slug || "",
+					title,
+				});
+				if (res) {
+					console.error(
+						`[mail-bridge] 会话命名同步 ${info.id} -> alias=${res.alias || "-"} title=${res.title || "-"}`,
+					);
+				}
+				return;
+			}
 
-      // 2) 一轮跑完 → 把最后那段话作为回信转出去（不消耗配额）。
-      //    用 session.idle 而不是 message.updated：后者在流式生成中反复触发，
-      //    转出去的会是半截话。
-      // 1.5) 模型调用出错 → 唤醒等待者，让 deliverMail 换下一个模型。
-      //      promptAsync 已经返回过了，失败只能从这里得知。
-      if (event?.type === "session.error") {
-        const sid = event.properties?.sessionID;
-        const err = event.properties?.error;
-        const msg = err?.data?.message || err?.name || JSON.stringify(err ?? {});
-        if (sid && settleFirstTurn(sid, { ok: false, error: msg })) {
-          return; // 正在降级尝试中，不当作一次普通故障
-        }
-        if (sid && mailDrivenSessions.has(sid)) {
-          console.error(`[mail-bridge] 会话 ${sid} 出错:`, msg);
-        }
-        return;
-      }
+			// 2) 一轮跑完 → 把最后那段话作为回信转出去（不消耗配额）。
+			//    用 session.idle 而不是 message.updated：后者在流式生成中反复触发，
+			//    转出去的会是半截话。
+			// 1.5) 模型调用出错 → 唤醒等待者，让 deliverMail 换下一个模型。
+			//      promptAsync 已经返回过了，失败只能从这里得知。
+			if (event?.type === "session.error") {
+				const sid = event.properties?.sessionID;
+				const err = event.properties?.error;
+				const msg =
+					err?.data?.message || err?.name || JSON.stringify(err ?? {});
+				if (sid && settleFirstTurn(sid, { ok: false, error: msg })) {
+					return; // 正在降级尝试中，不当作一次普通故障
+				}
+				if (sid && mailDrivenSessions.has(sid)) {
+					console.error(`[mail-bridge] 会话 ${sid} 出错:`, msg);
+				}
+				return;
+			}
 
-      if (event?.type === "session.idle") {
-        const sid = event.properties?.sessionID;
-        // 首轮跑到 idle = 这一路走通了（哪怕没产出文本）
-        if (sid) settleFirstTurn(sid, { ok: true });
-        if (!sid || !mailDrivenSessions.has(sid)) return;
-        try {
-          const res = await relaySummaryRef(sid);
-          if (res?.mail_id) {
-            console.error(`[mail-bridge] 总结已回信 ${res.mail_id}（不计配额）`);
-          }
-        } catch (e) {
-          console.error("[mail-bridge] 总结回信失败:", e?.message || e);
-        }
-        return;
-      }
+			if (event?.type === "session.idle") {
+				const sid = event.properties?.sessionID;
+				// 首轮跑到 idle = 这一路走通了（哪怕没产出文本）
+				if (sid) settleFirstTurn(sid, { ok: true });
+				if (!sid || !mailDrivenSessions.has(sid)) return;
+				try {
+					const res = await relaySummaryRef(sid);
+					if (res?.mail_id) {
+						console.error(
+							`[mail-bridge] 总结已回信 ${res.mail_id}（不计配额）`,
+						);
+					}
+				} catch (e) {
+					console.error("[mail-bridge] 总结回信失败:", e?.message || e);
+				}
+				return;
+			}
 
-      // 3) 权限被本地机制（TUI）处理掉时，清掉待决策记录，
-      //    免得之后邮件决策回来又去回复一条已经结案的 permission。
-      if (event?.type === "permission.replied") {
-        const pid = event.properties?.permissionID;
-        if (pid) pendingPermissions.delete(pid);
-        return;
-      }
-    },
+			// 3) 权限被本地机制（TUI）处理掉时，清掉待决策记录，
+			//    免得之后邮件决策回来又去回复一条已经结案的 permission。
+			if (event?.type === "permission.replied") {
+				const pid = event.properties?.permissionID;
+				if (pid) pendingPermissions.delete(pid);
+				return;
+			}
+		},
 
-    tool: {
-      send_mail: sendMailTool,
-      read_inbox: readInboxTool,
-      read_mail: readMailTool,
-      forward_mail: forwardMailTool,
-      upload_attachment: uploadAttachmentTool,
-      download_attachment: downloadAttachmentTool,
-      connect_to_server: connectToServerTool,
-      // 寻址发现：让模型选地址而不是拼地址
-      suggest_address: suggestAddressTool,
-      list_contacts: listContactsTool,
-      session_participants: sessionParticipantsTool,
-      read_thread: readThreadTool,
-    },
-  };
+		tool: {
+			send_mail: sendMailTool,
+			read_inbox: readInboxTool,
+			read_mail: readMailTool,
+			forward_mail: forwardMailTool,
+			upload_attachment: uploadAttachmentTool,
+			download_attachment: downloadAttachmentTool,
+			connect_to_server: connectToServerTool,
+			// 寻址发现：让模型选地址而不是拼地址
+			suggest_address: suggestAddressTool,
+			list_contacts: listContactsTool,
+			session_participants: sessionParticipantsTool,
+			read_thread: readThreadTool,
+		},
+	};
 }
diff --git a/plugins/opencode-mail-bridge/lib/sse-client.js b/plugins/opencode-mail-bridge/lib/sse-client.js
index 68efdfc..de46b2b 100644
--- a/plugins/opencode-mail-bridge/lib/sse-client.js
+++ b/plugins/opencode-mail-bridge/lib/sse-client.js
@@ -34,59 +34,61 @@
  *            setLastEventId: (id: string) => void}}
  */
 export function createFrameParser() {
-  let buffer = '';
-  let lastEventId = '';
-  let curEvent = '';
-  let curData = '';
-  let curId = '';
+	let buffer = "";
+	let lastEventId = "";
+	let curEvent = "";
+	let curData = "";
+	let curId = "";
 
-  function push(chunk) {
-    buffer += chunk;
-    const events = [];
-    const lines = buffer.split('\n');
-    // 最后一段可能是被切断的半行，留到下一个 chunk
-    buffer = lines.pop() ?? '';
+	function push(chunk) {
+		buffer += chunk;
+		const events = [];
+		const lines = buffer.split("\n");
+		// 最后一段可能是被切断的半行，留到下一个 chunk
+		buffer = lines.pop() ?? "";
 
-    for (let line of lines) {
-      if (line.length > 0 && line.charAt(line.length - 1) === '\r') {
-        line = line.slice(0, -1);
-      }
-      if (line.startsWith(':')) continue;
+		for (let line of lines) {
+			if (line.length > 0 && line.charAt(line.length - 1) === "\r") {
+				line = line.slice(0, -1);
+			}
+			if (line.startsWith(":")) continue;
 
-      if (line.startsWith('id:')) {
-        curId = line.slice(3).trim();
-      } else if (line.startsWith('event:')) {
-        curEvent = line.slice(6).trim();
-      } else if (line.startsWith('data:')) {
-        let value = line.slice(5);
-        if (value.startsWith(' ')) value = value.slice(1);
-        curData = curData.length > 0 ? `${curData}\n${value}` : value;
-      } else if (line === '') {
-        if (curEvent.length > 0 && curData.length > 0) {
-          if (curId.length > 0) lastEventId = curId;
-          events.push({ event: curEvent, data: curData, id: curId });
-        }
-        curEvent = '';
-        curData = '';
-        curId = '';
-      }
-    }
-    return events;
-  }
+			if (line.startsWith("id:")) {
+				curId = line.slice(3).trim();
+			} else if (line.startsWith("event:")) {
+				curEvent = line.slice(6).trim();
+			} else if (line.startsWith("data:")) {
+				let value = line.slice(5);
+				if (value.startsWith(" ")) value = value.slice(1);
+				curData = curData.length > 0 ? `${curData}\n${value}` : value;
+			} else if (line === "") {
+				if (curEvent.length > 0 && curData.length > 0) {
+					if (curId.length > 0) lastEventId = curId;
+					events.push({ event: curEvent, data: curData, id: curId });
+				}
+				curEvent = "";
+				curData = "";
+				curId = "";
+			}
+		}
+		return events;
+	}
 
-  function reset() {
-    buffer = '';
-    curEvent = '';
-    curData = '';
-    curId = '';
-  }
+	function reset() {
+		buffer = "";
+		curEvent = "";
+		curData = "";
+		curId = "";
+	}
 
-  return {
-    push,
-    reset,
-    lastEventId: () => lastEventId,
-    setLastEventId: (id) => { lastEventId = id || ''; },
-  };
+	return {
+		push,
+		reset,
+		lastEventId: () => lastEventId,
+		setLastEventId: (id) => {
+			lastEventId = id || "";
+		},
+	};
 }
 
 /**
@@ -98,82 +100,93 @@ export function createFrameParser() {
  * @param {(msg: string) => void} [deps.log]              日志回调（默认 console.error）
  * @returns {{stop: () => void}} stop() 终止重连与在途请求
  */
-export function createSSEClient({ authHeaders, baseURL, path, onEvent, log = console.error }) {
-  const controller = new AbortController();
-  const parser = createFrameParser();
+export function createSSEClient({
+	authHeaders,
+	baseURL,
+	path,
+	onEvent,
+	log = console.error,
+}) {
+	const controller = new AbortController();
+	const parser = createFrameParser();
 
-  function stop() {
-    controller.abort();
-  }
+	function stop() {
+		controller.abort();
+	}
 
-  function reconnect(delay) {
-    if (controller.signal.aborted) return;
-    setTimeout(() => connect(), delay);
-  }
+	function reconnect(delay) {
+		if (controller.signal.aborted) return;
+		setTimeout(() => connect(), delay);
+	}
 
-  function connect() {
-    if (controller.signal.aborted) return;
+	function connect() {
+		if (controller.signal.aborted) return;
 
-    const headers = { ...authHeaders(), Accept: 'text/event-stream' };
-    // 只有 lastEventId 非空（= 已经收过事件）时才是重连：首次连接不带，
-    // 否则服务端会把环形缓冲里的旧事件全回放一遍，插件重启后重复处理一批已处理的邮件。
-    const lastEventID = parser.lastEventId();
-    if (lastEventID) {
-      headers['Last-Event-ID'] = lastEventID;
-      log(`SSE 重连，从事件 ${lastEventID} 之后续传`);
-    }
+		const headers = { ...authHeaders(), Accept: "text/event-stream" };
+		// 只有 lastEventId 非空（= 已经收过事件）时才是重连：首次连接不带，
+		// 否则服务端会把环形缓冲里的旧事件全回放一遍，插件重启后重复处理一批已处理的邮件。
+		const lastEventID = parser.lastEventId();
+		if (lastEventID) {
+			headers["Last-Event-ID"] = lastEventID;
+			log(`SSE 重连，从事件 ${lastEventID} 之后续传`);
+		}
 
-    fetch(`${baseURL}${path}`, { headers, signal: controller.signal })
-      .then((res) => {
-        if (!res.ok || !res.body) {
-          log(`SSE 建连失败: HTTP ${res.status}`);
-          return reconnect(5000);
-        }
-        const reader = res.body.getReader();
-        const decoder = new TextDecoder();
+		fetch(`${baseURL}${path}`, { headers, signal: controller.signal })
+			.then((res) => {
+				if (!res.ok || !res.body) {
+					log(`SSE 建连失败: HTTP ${res.status}`);
+					return reconnect(5000);
+				}
+				const reader = res.body.getReader();
+				const decoder = new TextDecoder();
 
-        function read() {
-          reader.read().then(({ done, value }) => {
-            if (done) {
-              parser.reset();
-              return reconnect(3000);
-            }
-            for (const ev of parser.push(decoder.decode(value, { stream: true }))) {
-              try {
-                onEvent(ev.event, JSON.parse(ev.data));
-              } catch (e) {
-                log(`SSE 事件处理失败: ${e?.message || e}`);
-              }
-            }
-            read();
-          }).catch((e) => {
-            if (controller.signal.aborted) return;
-            log(`SSE 读取中断: ${e?.message || e}`);
-            parser.reset();
-            reconnect(5000);
-          });
-        }
-        read();
-      })
-      .catch((e) => {
-        if (controller.signal.aborted) return;
-        log(`SSE 连接错误: ${e?.message || e}`);
-        parser.reset();
-        reconnect(5000);
-      });
-  }
+				function read() {
+					reader
+						.read()
+						.then(({ done, value }) => {
+							if (done) {
+								parser.reset();
+								return reconnect(3000);
+							}
+							for (const ev of parser.push(
+								decoder.decode(value, { stream: true }),
+							)) {
+								try {
+									onEvent(ev.event, JSON.parse(ev.data));
+								} catch (e) {
+									log(`SSE 事件处理失败: ${e?.message || e}`);
+								}
+							}
+							read();
+						})
+						.catch((e) => {
+							if (controller.signal.aborted) return;
+							log(`SSE 读取中断: ${e?.message || e}`);
+							parser.reset();
+							reconnect(5000);
+						});
+				}
+				read();
+			})
+			.catch((e) => {
+				if (controller.signal.aborted) return;
+				log(`SSE 连接错误: ${e?.message || e}`);
+				parser.reset();
+				reconnect(5000);
+			});
+	}
 
-  connect();
+	connect();
 
-  return {
-    stop,
-    /**
-     * 清掉断点（不终止连接）。
-     *
-     * 换 Gateway 地址时必须调：lastEventID 是**旧** Gateway 环形缓冲里的序号，
-     * 拿去问新 Gateway 会命中一段完全无关的历史（或直接被拒），
-     * 得到的事件属于别人的会话。
-     */
-    reset: () => parser.setLastEventId(''),
-  };
+	return {
+		stop,
+		/**
+		 * 清掉断点（不终止连接）。
+		 *
+		 * 换 Gateway 地址时必须调：lastEventID 是**旧** Gateway 环形缓冲里的序号，
+		 * 拿去问新 Gateway 会命中一段完全无关的历史（或直接被拒），
+		 * 得到的事件属于别人的会话。
+		 */
+		reset: () => parser.setLastEventId(""),
+	};
 }
diff --git a/plugins/opencode-mail-bridge/lib/user-question.js b/plugins/opencode-mail-bridge/lib/user-question.js
index f9ebfd5..810ef3e 100644
--- a/plugins/opencode-mail-bridge/lib/user-question.js
+++ b/plugins/opencode-mail-bridge/lib/user-question.js
@@ -32,23 +32,25 @@
 
 /** 问题是否带可选项。 */
 export function hasOptions(question) {
-  return Array.isArray(question?.options) && question.options.length > 0;
+	return Array.isArray(question?.options) && question.options.length > 0;
 }
 
 /** 一个 DSH 问题的可选项 label 列表（保序）。 */
 export function optionLabels(question) {
-  if (!hasOptions(question)) return [];
-  return question.options
-    .map((o) => (typeof o === 'string' ? o : o?.label))
-    .filter((l) => typeof l === 'string' && l.length > 0);
+	if (!hasOptions(question)) return [];
+	return question.options
+		.map((o) => (typeof o === "string" ? o : o?.label))
+		.filter((l) => typeof l === "string" && l.length > 0);
 }
 
 /** 一个问题的展示标题：header 有就用它做前缀，否则只用 question。 */
 export function questionTitle(question) {
-  const header = typeof question?.header === 'string' ? question.header.trim() : '';
-  const text = typeof question?.question === 'string' ? question.question.trim() : '';
-  if (header && text) return `${header}: ${text}`;
-  return header || text || '(未提供问题)';
+	const header =
+		typeof question?.header === "string" ? question.header.trim() : "";
+	const text =
+		typeof question?.question === "string" ? question.question.trim() : "";
+	if (header && text) return `${header}: ${text}`;
+	return header || text || "(未提供问题)";
 }
 
 /**
@@ -58,51 +60,56 @@ export function questionTitle(question) {
  * @returns {{ question: string, options: string[], context: string, multiSelect: boolean }}
  */
 export function flattenQuestions(questions) {
-  const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
-  if (list.length === 0) {
-    throw new Error('ask_user_question 至少需要一个 question');
-  }
+	const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
+	if (list.length === 0) {
+		throw new Error("ask_user_question 至少需要一个 question");
+	}
 
-  const lines = [];
-  const options = [];
-  const seen = new Set();
-  let anyMulti = false;
+	const lines = [];
+	const options = [];
+	const seen = new Set();
+	let anyMulti = false;
 
-  list.forEach((q, i) => {
-    const title = questionTitle(q);
-    lines.push(`${i + 1}. ${title}`);
-    const detail = typeof q?.detail === 'string' ? q.detail.trim() : '';
-    if (detail) lines.push(`   ${detail}`);
+	list.forEach((q, i) => {
+		const title = questionTitle(q);
+		lines.push(`${i + 1}. ${title}`);
+		const detail = typeof q?.detail === "string" ? q.detail.trim() : "";
+		if (detail) lines.push(`   ${detail}`);
 
-    const labels = optionLabels(q);
-    if (labels.length > 0) {
-      lines.push(`   可选项：${labels.join(' / ')}${q.multiSelect ? '（可多选）' : ''}`);
-      for (const label of labels) {
-        if (!seen.has(label)) {
-          seen.add(label);
-          options.push(label);
-        }
-      }
-    } else {
-      lines.push('   （请直接填写回答）');
-    }
-    if (q?.multiSelect === true) anyMulti = true;
-  });
+		const labels = optionLabels(q);
+		if (labels.length > 0) {
+			lines.push(
+				`   可选项：${labels.join(" / ")}${q.multiSelect ? "（可多选）" : ""}`,
+			);
+			for (const label of labels) {
+				if (!seen.has(label)) {
+					seen.add(label);
+					options.push(label);
+				}
+			}
+		} else {
+			lines.push("   （请直接填写回答）");
+		}
+		if (q?.multiSelect === true) anyMulti = true;
+	});
 
-  // 多问题时必须允许多选：不同问题的选项要能一起勾选。
-  const multiSelect = list.length > 1 ? options.length > 0 : anyMulti;
+	// 多问题时必须允许多选：不同问题的选项要能一起勾选。
+	const multiSelect = list.length > 1 ? options.length > 0 : anyMulti;
 
-  const question = list.length === 1 ? questionTitle(list[0]) : `${list.length} 个问题待回答`;
-  const context = [
-    list.length === 1 ? '' : '模型提出了多个问题，请在「回复」里一并回答：',
-    ...lines,
-    '',
-    options.length > 0
-      ? '可直接勾选下方的选项；补充说明写在备注里。'
-      : '这题没有预设选项，请把回答写在备注里。',
-  ].filter((l) => l !== '').join('\n');
+	const question =
+		list.length === 1 ? questionTitle(list[0]) : `${list.length} 个问题待回答`;
+	const context = [
+		list.length === 1 ? "" : "模型提出了多个问题，请在「回复」里一并回答：",
+		...lines,
+		"",
+		options.length > 0
+			? "可直接勾选下方的选项；补充说明写在备注里。"
+			: "这题没有预设选项，请把回答写在备注里。",
+	]
+		.filter((l) => l !== "")
+		.join("\n");
 
-  return { question, options, context, multiSelect };
+	return { question, options, context, multiSelect };
 }
 
 /**
@@ -114,51 +121,55 @@ export function flattenQuestions(questions) {
  * @returns {{ answers: Array<{id: string, selected: string[], custom?: string}> }}
  */
 export function answersFromDecision(questions, decision, note) {
-  const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
-  const labels = String(decision || '')
-    .split('\n')
-    .map((s) => s.trim())
-    .filter(Boolean);
-  const custom = typeof note === 'string' ? note.trim() : '';
+	const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
+	const labels = String(decision || "")
+		.split("\n")
+		.map((s) => s.trim())
+		.filter(Boolean);
+	const custom = typeof note === "string" ? note.trim() : "";
 
-  // 单问题：忠实映射（选项 → selected，备注 → custom）。
-  if (list.length === 1) {
-    const q = list[0];
-    const id = String(q?.id ?? '0');
-    if (!hasOptions(q)) {
-      // 无选项题：人类把答案写在决策文本或备注里，都属于「自由文本回答」。
-      const text = custom || labels.join('\n');
-      return { answers: [{ id, selected: [], ...(text ? { custom: text } : {}) }] };
-    }
-    return {
-      answers: [{
-        id,
-        selected: labels,
-        ...(custom ? { custom } : {}),
-      }],
-    };
-  }
+	// 单问题：忠实映射（选项 → selected，备注 → custom）。
+	if (list.length === 1) {
+		const q = list[0];
+		const id = String(q?.id ?? "0");
+		if (!hasOptions(q)) {
+			// 无选项题：人类把答案写在决策文本或备注里，都属于「自由文本回答」。
+			const text = custom || labels.join("\n");
+			return {
+				answers: [{ id, selected: [], ...(text ? { custom: text } : {}) }],
+			};
+		}
+		return {
+			answers: [
+				{
+					id,
+					selected: labels,
+					...(custom ? { custom } : {}),
+				},
+			],
+		};
+	}
 
-  // 多问题：按 label 归属把选择分配给各自的问题；备注归给第一个问题。
-  let customUsed = false;
-  const answers = list.map((q, i) => {
-    const id = String(q?.id ?? String(i));
-    const labels_q = optionLabels(q);
-    const selected = labels.filter((l) => labels_q.includes(l));
-    let qCustom;
-    if (custom && !customUsed) {
-      qCustom = custom;
-      customUsed = true;
-    }
-    // 无选项题且人没写备注：退而把决策文本整段给它（否则它的答案永远是空的）。
-    if (qCustom === undefined && !hasOptions(q) && note === undefined) {
-      const text = labels.join('\n');
-      if (text) qCustom = text;
-    }
-    return { id, selected, ...(qCustom ? { custom: qCustom } : {}) };
-  });
+	// 多问题：按 label 归属把选择分配给各自的问题；备注归给第一个问题。
+	let customUsed = false;
+	const answers = list.map((q, i) => {
+		const id = String(q?.id ?? String(i));
+		const labels_q = optionLabels(q);
+		const selected = labels.filter((l) => labels_q.includes(l));
+		let qCustom;
+		if (custom && !customUsed) {
+			qCustom = custom;
+			customUsed = true;
+		}
+		// 无选项题且人没写备注：退而把决策文本整段给它（否则它的答案永远是空的）。
+		if (qCustom === undefined && !hasOptions(q) && note === undefined) {
+			const text = labels.join("\n");
+			if (text) qCustom = text;
+		}
+		return { id, selected, ...(qCustom ? { custom: qCustom } : {}) };
+	});
 
-  return { answers };
+	return { answers };
 }
 
 /**
@@ -167,10 +178,13 @@ export function answersFromDecision(questions, decision, note) {
  * 允许多选时空 selected 但有 custom 也算答了；两者都空才算没答。
  */
 export function isBlankAnswer(questions, decision, note) {
-  const labels = String(decision || '').split('\n').map((s) => s.trim()).filter(Boolean);
-  const custom = typeof note === 'string' ? note.trim() : '';
-  if (labels.length > 0 || custom) return false;
-  // 全部问题都没有选项、人也没写字 → 确实什么都没答
-  const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
-  return list.some((q) => hasOptions(q)) || list.length === 0;
+	const labels = String(decision || "")
+		.split("\n")
+		.map((s) => s.trim())
+		.filter(Boolean);
+	const custom = typeof note === "string" ? note.trim() : "";
+	if (labels.length > 0 || custom) return false;
+	// 全部问题都没有选项、人也没写字 → 确实什么都没答
+	const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
+	return list.some((q) => hasOptions(q)) || list.length === 0;
 }
diff --git a/plugins/opencode-mail-bridge/test/sse-client.test.mjs b/plugins/opencode-mail-bridge/test/sse-client.test.mjs
index 0ee5781..05095a0 100644
--- a/plugins/opencode-mail-bridge/test/sse-client.test.mjs
+++ b/plugins/opencode-mail-bridge/test/sse-client.test.mjs
@@ -9,121 +9,132 @@
  * 生产上表现为「新邮件偶尔收不到」「权限决策点了没反应」，且日志里一个字都没有。
  */
 
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
+import { test } from "node:test";
+import assert from "node:assert/strict";
 
-import { createFrameParser } from '../lib/sse-client.js';
+import { createFrameParser } from "../lib/sse-client.js";
 
 /** JSON.parse 的测试包装：解析失败让断言带原文失败，而不是抛未捕获异常。 */
 function parse(s) {
-  try {
-    return JSON.parse(s);
-  } catch (e) {
-    assert.fail(`不是合法 JSON: ${s}（${e.message}）`);
-  }
+	try {
+		return JSON.parse(s);
+	} catch (e) {
+		assert.fail(`不是合法 JSON: ${s}（${e.message}）`);
+	}
 }
 
-test('完整帧一次喂入：正常解析', () => {
-  const p = createFrameParser();
-  const events = p.push('id: 7\nevent: new_mail\ndata: {"mail_id":"m1"}\n\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
-  assert.deepEqual(parse(events[0].data), { mail_id: 'm1' });
-  assert.equal(events[0].id, '7');
-  assert.equal(p.lastEventId(), '7');
+test("完整帧一次喂入：正常解析", () => {
+	const p = createFrameParser();
+	const events = p.push('id: 7\nevent: new_mail\ndata: {"mail_id":"m1"}\n\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
+	assert.deepEqual(parse(events[0].data), { mail_id: "m1" });
+	assert.equal(events[0].id, "7");
+	assert.equal(p.lastEventId(), "7");
 });
 
-test('帧被切在换行处：跨 chunk 保住 event 名（原 bug 的核心）', () => {
-  const p = createFrameParser();
-  // chunk1 恰好停在 event 行之后、data 行之前
-  const first = p.push('id: 12\nevent: content_delta\n');
-  assert.deepEqual(first, [], '半帧不该派发');
+test("帧被切在换行处：跨 chunk 保住 event 名（原 bug 的核心）", () => {
+	const p = createFrameParser();
+	// chunk1 恰好停在 event 行之后、data 行之前
+	const first = p.push("id: 12\nevent: content_delta\n");
+	assert.deepEqual(first, [], "半帧不该派发");
 
-  const second = p.push('data: {"x":1}\n\n');
-  assert.equal(second.length, 1, '跨 chunk 的半帧必须被拼回完整事件，而不是丢弃');
-  assert.equal(second[0].event, 'content_delta');
-  assert.equal(p.lastEventId(), '12');
+	const second = p.push('data: {"x":1}\n\n');
+	assert.equal(
+		second.length,
+		1,
+		"跨 chunk 的半帧必须被拼回完整事件，而不是丢弃",
+	);
+	assert.equal(second[0].event, "content_delta");
+	assert.equal(p.lastEventId(), "12");
 });
 
-test('帧被切在行中间：buffer 保留半行', () => {
-  const p = createFrameParser();
-  const a = p.push('event: new_ma');
-  assert.deepEqual(a, []);
-  const b = p.push('il\ndata: {"mail_id":"m9"}\n\n');
-  assert.equal(b.length, 1);
-  assert.equal(b[0].event, 'new_mail');
+test("帧被切在行中间：buffer 保留半行", () => {
+	const p = createFrameParser();
+	const a = p.push("event: new_ma");
+	assert.deepEqual(a, []);
+	const b = p.push('il\ndata: {"mail_id":"m9"}\n\n');
+	assert.equal(b.length, 1);
+	assert.equal(b[0].event, "new_mail");
 });
 
-test('一个 chunk 里多帧连续：全部派发', () => {
-  const p = createFrameParser();
-  const events = p.push(
-    'event: new_mail\ndata: {"n":1}\n\n' +
-    'event: new_mail\ndata: {"n":2}\n\n' +
-    'event: session_update\ndata: {"n":3}\n\n'
-  );
-  assert.equal(events.length, 3);
-  assert.deepEqual(events.map((e) => e.event), ['new_mail', 'new_mail', 'session_update']);
+test("一个 chunk 里多帧连续：全部派发", () => {
+	const p = createFrameParser();
+	const events = p.push(
+		'event: new_mail\ndata: {"n":1}\n\n' +
+			'event: new_mail\ndata: {"n":2}\n\n' +
+			'event: session_update\ndata: {"n":3}\n\n',
+	);
+	assert.equal(events.length, 3);
+	assert.deepEqual(
+		events.map((e) => e.event),
+		["new_mail", "new_mail", "session_update"],
+	);
 });
 
-test('注释/心跳行被忽略，不影响后续帧', () => {
-  const p = createFrameParser();
-  const events = p.push(': heartbeat\n\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
+test("注释/心跳行被忽略，不影响后续帧", () => {
+	const p = createFrameParser();
+	const events = p.push(': heartbeat\n\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
 });
 
-test('多行 data 用换行拼接', () => {
-  const p = createFrameParser();
-  const events = p.push('event: x\ndata: line1\ndata: line2\n\n');
-  assert.equal(events[0].data, 'line1\nline2');
+test("多行 data 用换行拼接", () => {
+	const p = createFrameParser();
+	const events = p.push("event: x\ndata: line1\ndata: line2\n\n");
+	assert.equal(events[0].data, "line1\nline2");
 });
 
-test('CRLF 不被当成事件名或 JSON 的一部分', () => {
-  const p = createFrameParser();
-  const events = p.push('id: 3\r\nevent: new_mail\r\ndata: {"n":1}\r\n\r\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
-  assert.equal(events[0].id, '3');
-  assert.deepEqual(parse(events[0].data), { n: 1 });
+test("CRLF 不被当成事件名或 JSON 的一部分", () => {
+	const p = createFrameParser();
+	const events = p.push('id: 3\r\nevent: new_mail\r\ndata: {"n":1}\r\n\r\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
+	assert.equal(events[0].id, "3");
+	assert.deepEqual(parse(events[0].data), { n: 1 });
 });
 
-test('事件 id 只向前推进：重放旧 id 不回退断点', () => {
-  const p = createFrameParser();
-  p.push('id: 10\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '10');
-  // 服务端重放一条更早的事件：断点不该退回 5，否则下次重连会重复回放 6..10
-  p.push('id: 5\nevent: new_mail\ndata: {"n":0}\n\n');
-  assert.equal(p.lastEventId(), '5', '解析器如实记录当前 id（是否回退由使用方决定）');
+test("事件 id 只向前推进：重放旧 id 不回退断点", () => {
+	const p = createFrameParser();
+	p.push('id: 10\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "10");
+	// 服务端重放一条更早的事件：断点不该退回 5，否则下次重连会重复回放 6..10
+	p.push('id: 5\nevent: new_mail\ndata: {"n":0}\n\n');
+	assert.equal(
+		p.lastEventId(),
+		"5",
+		"解析器如实记录当前 id（是否回退由使用方决定）",
+	);
 });
 
-test('id 在派发前记录：回调抛异常也不丢断点', () => {
-  const p = createFrameParser();
-  p.push('id: 42\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '42');
+test("id 在派发前记录：回调抛异常也不丢断点", () => {
+	const p = createFrameParser();
+	p.push('id: 42\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "42");
 });
 
-test('只有 data 没有 event 不派发（避免把心跳数据当事件）', () => {
-  const p = createFrameParser();
-  const events = p.push('data: {"orphan":true}\n\n');
-  assert.deepEqual(events, []);
+test("只有 data 没有 event 不派发（避免把心跳数据当事件）", () => {
+	const p = createFrameParser();
+	const events = p.push('data: {"orphan":true}\n\n');
+	assert.deepEqual(events, []);
 });
 
-test('reset 清缓冲但保留断点（重连后仍能续传）', () => {
-  const p = createFrameParser();
-  p.push('id: 99\nevent: a\ndata: {"n":1}\n\n');
-  p.push('event: partial');   // 半帧
-  p.reset();
-  assert.equal(p.lastEventId(), '99', '断点必须保留，否则重连从头回放');
-  // reset 后半帧不该复活
-  const after = p.push('data: {"n":2}\n\n');
-  assert.deepEqual(after, []);
+test("reset 清缓冲但保留断点（重连后仍能续传）", () => {
+	const p = createFrameParser();
+	p.push('id: 99\nevent: a\ndata: {"n":1}\n\n');
+	p.push("event: partial"); // 半帧
+	p.reset();
+	assert.equal(p.lastEventId(), "99", "断点必须保留，否则重连从头回放");
+	// reset 后半帧不该复活
+	const after = p.push('data: {"n":2}\n\n');
+	assert.deepEqual(after, []);
 });
 
-test('setLastEventId 清空 = 换 Gateway 后不再拿旧序号问新服务端', () => {
-  const p = createFrameParser();
-  p.push('id: 123\nevent: a\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '123');
-  // connect_to_server 换了坐标：旧序号属于旧 Gateway 的环形缓冲，必须丢掉
-  p.setLastEventId('');
-  assert.equal(p.lastEventId(), '', '首次连接不得携带 Last-Event-ID');
+test("setLastEventId 清空 = 换 Gateway 后不再拿旧序号问新服务端", () => {
+	const p = createFrameParser();
+	p.push('id: 123\nevent: a\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "123");
+	// connect_to_server 换了坐标：旧序号属于旧 Gateway 的环形缓冲，必须丢掉
+	p.setLastEventId("");
+	assert.equal(p.lastEventId(), "", "首次连接不得携带 Last-Event-ID");
 });
diff --git a/plugins/opencode-mail-bridge/test/user-question.test.mjs b/plugins/opencode-mail-bridge/test/user-question.test.mjs
index bcfec38..b621d92 100644
--- a/plugins/opencode-mail-bridge/test/user-question.test.mjs
+++ b/plugins/opencode-mail-bridge/test/user-question.test.mjs
@@ -10,127 +10,179 @@
  *   - 空回答不能被当成「答了」
  */
 
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
+import { test } from "node:test";
+import assert from "node:assert/strict";
 
 import {
-  flattenQuestions,
-  answersFromDecision,
-  isBlankAnswer,
-  hasOptions,
-  optionLabels,
-  questionTitle,
-} from '../lib/user-question.js';
+	flattenQuestions,
+	answersFromDecision,
+	isBlankAnswer,
+	hasOptions,
+	optionLabels,
+	questionTitle,
+} from "../lib/user-question.js";
 
-test('单问题单选项：忠实映射问题与选项', () => {
-  const flat = flattenQuestions([{
-    id: 'q1',
-    question: '用哪种方案？',
-    header: '选择',
-    options: [{ label: '方案 A' }, { label: '方案 B' }],
-  }]);
-  assert.equal(flat.question, '选择: 用哪种方案？');
-  assert.deepEqual(flat.options, ['方案 A', '方案 B']);
-  assert.equal(flat.multiSelect, false);
+test("单问题单选项：忠实映射问题与选项", () => {
+	const flat = flattenQuestions([
+		{
+			id: "q1",
+			question: "用哪种方案？",
+			header: "选择",
+			options: [{ label: "方案 A" }, { label: "方案 B" }],
+		},
+	]);
+	assert.equal(flat.question, "选择: 用哪种方案？");
+	assert.deepEqual(flat.options, ["方案 A", "方案 B"]);
+	assert.equal(flat.multiSelect, false);
 });
 
-test('单问题多选：multiSelect 透传', () => {
-  const flat = flattenQuestions([{
-    id: 'q1',
-    question: '要哪些？',
-    options: [{ label: 'a' }, { label: 'b' }],
-    multiSelect: true,
-  }]);
-  assert.equal(flat.multiSelect, true);
+test("单问题多选：multiSelect 透传", () => {
+	const flat = flattenQuestions([
+		{
+			id: "q1",
+			question: "要哪些？",
+			options: [{ label: "a" }, { label: "b" }],
+			multiSelect: true,
+		},
+	]);
+	assert.equal(flat.multiSelect, true);
 });
 
-test('多问题：选项取并集且去重保序，multiSelect 置真', () => {
-  const flat = flattenQuestions([
-    { id: 'q1', question: '前端？', options: [{ label: 'React' }, { label: 'Vue' }] },
-    { id: 'q2', question: '后端？', options: [{ label: 'Vue' }, { label: 'Go' }] },
-  ]);
-  assert.deepEqual(flat.options, ['React', 'Vue', 'Go'], '重复 label 只出现一次');
-  assert.equal(flat.multiSelect, true, '多问题必须允许多选，否则无法同时回答两题');
-  assert.match(flat.context, /前端？/);
-  assert.match(flat.context, /后端？/);
+test("多问题：选项取并集且去重保序，multiSelect 置真", () => {
+	const flat = flattenQuestions([
+		{
+			id: "q1",
+			question: "前端？",
+			options: [{ label: "React" }, { label: "Vue" }],
+		},
+		{
+			id: "q2",
+			question: "后端？",
+			options: [{ label: "Vue" }, { label: "Go" }],
+		},
+	]);
+	assert.deepEqual(
+		flat.options,
+		["React", "Vue", "Go"],
+		"重复 label 只出现一次",
+	);
+	assert.equal(
+		flat.multiSelect,
+		true,
+		"多问题必须允许多选，否则无法同时回答两题",
+	);
+	assert.match(flat.context, /前端？/);
+	assert.match(flat.context, /后端？/);
 });
 
-test('无选项题：options 为空，正文提示直接填写', () => {
-  const flat = flattenQuestions([{ id: 'q1', question: '你的名字？' }]);
-  assert.deepEqual(flat.options, []);
-  assert.match(flat.context, /直接填写|没有预设选项/);
+test("无选项题：options 为空，正文提示直接填写", () => {
+	const flat = flattenQuestions([{ id: "q1", question: "你的名字？" }]);
+	assert.deepEqual(flat.options, []);
+	assert.match(flat.context, /直接填写|没有预设选项/);
 });
 
-test('空问题列表：抛错而不是造一封没有内容的信', () => {
-  assert.throws(() => flattenQuestions([]), /至少需要一个/);
-  assert.throws(() => flattenQuestions(undefined), /至少需要一个/);
+test("空问题列表：抛错而不是造一封没有内容的信", () => {
+	assert.throws(() => flattenQuestions([]), /至少需要一个/);
+	assert.throws(() => flattenQuestions(undefined), /至少需要一个/);
 });
 
-test('单问题回写：选项进 selected，备注进 custom', () => {
-  const qs = [{ id: 'q1', question: '选哪个', options: [{ label: 'A' }, { label: 'B' }] }];
-  const ans = answersFromDecision(qs, 'A', '再确认下');
-  assert.deepEqual(ans.answers, [{ id: 'q1', selected: ['A'], custom: '再确认下' }]);
+test("单问题回写：选项进 selected，备注进 custom", () => {
+	const qs = [
+		{ id: "q1", question: "选哪个", options: [{ label: "A" }, { label: "B" }] },
+	];
+	const ans = answersFromDecision(qs, "A", "再确认下");
+	assert.deepEqual(ans.answers, [
+		{ id: "q1", selected: ["A"], custom: "再确认下" },
+	]);
 });
 
-test('单问题多选回写：多行决策拆成多个 selected', () => {
-  const qs = [{ id: 'q1', question: '选哪些', options: [{ label: 'A' }, { label: 'B' }], multiSelect: true }];
-  const ans = answersFromDecision(qs, 'A\nB', '');
-  assert.deepEqual(ans.answers[0].selected, ['A', 'B']);
-  assert.equal(ans.answers[0].custom, undefined, '空备注不该变成空 custom');
+test("单问题多选回写：多行决策拆成多个 selected", () => {
+	const qs = [
+		{
+			id: "q1",
+			question: "选哪些",
+			options: [{ label: "A" }, { label: "B" }],
+			multiSelect: true,
+		},
+	];
+	const ans = answersFromDecision(qs, "A\nB", "");
+	assert.deepEqual(ans.answers[0].selected, ["A", "B"]);
+	assert.equal(ans.answers[0].custom, undefined, "空备注不该变成空 custom");
 });
 
-test('无选项题回写：答案进 custom，selected 为空', () => {
-  const qs = [{ id: 'q1', question: '名字？' }];
-  const ans = answersFromDecision(qs, '', '张三');
-  assert.deepEqual(ans.answers, [{ id: 'q1', selected: [], custom: '张三' }]);
+test("无选项题回写：答案进 custom，selected 为空", () => {
+	const qs = [{ id: "q1", question: "名字？" }];
+	const ans = answersFromDecision(qs, "", "张三");
+	assert.deepEqual(ans.answers, [{ id: "q1", selected: [], custom: "张三" }]);
 });
 
-test('无选项题只有决策文本时：文本进 custom（否则答案永远为空）', () => {
-  const qs = [{ id: 'q1', question: '名字？' }];
-  const ans = answersFromDecision(qs, '李四', undefined);
-  assert.deepEqual(ans.answers, [{ id: 'q1', selected: [], custom: '李四' }]);
+test("无选项题只有决策文本时：文本进 custom（否则答案永远为空）", () => {
+	const qs = [{ id: "q1", question: "名字？" }];
+	const ans = answersFromDecision(qs, "李四", undefined);
+	assert.deepEqual(ans.answers, [{ id: "q1", selected: [], custom: "李四" }]);
 });
 
-test('多问题回写：选择按 label 归属分配到各自的问题（不张冠李戴）', () => {
-  const qs = [
-    { id: 'q1', question: '前端？', options: [{ label: 'React' }, { label: 'Vue' }] },
-    { id: 'q2', question: '后端？', options: [{ label: 'Go' }, { label: 'Rust' }] },
-  ];
-  const ans = answersFromDecision(qs, 'Vue\nGo', '都行');
-  assert.deepEqual(ans.answers[0].selected, ['Vue'], 'q1 只拿前端的选择');
-  assert.deepEqual(ans.answers[1].selected, ['Go'], 'q2 只拿后端的选择');
-  assert.equal(ans.answers[0].custom, '都行', '备注归第一个问题');
-  assert.equal(ans.answers[1].custom, undefined, '备注不重复分发');
+test("多问题回写：选择按 label 归属分配到各自的问题（不张冠李戴）", () => {
+	const qs = [
+		{
+			id: "q1",
+			question: "前端？",
+			options: [{ label: "React" }, { label: "Vue" }],
+		},
+		{
+			id: "q2",
+			question: "后端？",
+			options: [{ label: "Go" }, { label: "Rust" }],
+		},
+	];
+	const ans = answersFromDecision(qs, "Vue\nGo", "都行");
+	assert.deepEqual(ans.answers[0].selected, ["Vue"], "q1 只拿前端的选择");
+	assert.deepEqual(ans.answers[1].selected, ["Go"], "q2 只拿后端的选择");
+	assert.equal(ans.answers[0].custom, "都行", "备注归第一个问题");
+	assert.equal(ans.answers[1].custom, undefined, "备注不重复分发");
 });
 
-test('多问题里认不出的 label：不匹配任何问题，不猜测放行', () => {
-  const qs = [
-    { id: 'q1', question: 'a', options: [{ label: 'X' }] },
-    { id: 'q2', question: 'b', options: [{ label: 'Y' }] },
-  ];
-  const ans = answersFromDecision(qs, 'Z', '');
-  assert.deepEqual(ans.answers[0].selected, [], '认不出的 label 不得被塞进任意问题');
-  assert.deepEqual(ans.answers[1].selected, []);
+test("多问题里认不出的 label：不匹配任何问题，不猜测放行", () => {
+	const qs = [
+		{ id: "q1", question: "a", options: [{ label: "X" }] },
+		{ id: "q2", question: "b", options: [{ label: "Y" }] },
+	];
+	const ans = answersFromDecision(qs, "Z", "");
+	assert.deepEqual(
+		ans.answers[0].selected,
+		[],
+		"认不出的 label 不得被塞进任意问题",
+	);
+	assert.deepEqual(ans.answers[1].selected, []);
 });
 
-test('answers 的 id 与问题一一对应', () => {
-  const qs = [{ id: 'alpha', question: 'a', options: [{ label: 'X' }] }, { id: 'beta', question: 'b' }];
-  const ans = answersFromDecision(qs, 'X', 'note');
-  assert.deepEqual(ans.answers.map((a) => a.id), ['alpha', 'beta']);
+test("answers 的 id 与问题一一对应", () => {
+	const qs = [
+		{ id: "alpha", question: "a", options: [{ label: "X" }] },
+		{ id: "beta", question: "b" },
+	];
+	const ans = answersFromDecision(qs, "X", "note");
+	assert.deepEqual(
+		ans.answers.map((a) => a.id),
+		["alpha", "beta"],
+	);
 });
 
-test('空回答判定：有选项的问题什么都没选 = 空', () => {
-  const qs = [{ id: 'q1', question: 'a', options: [{ label: 'X' }] }];
-  assert.equal(isBlankAnswer(qs, '', ''), true);
-  assert.equal(isBlankAnswer(qs, 'X', ''), false);
-  assert.equal(isBlankAnswer(qs, '', '自由文本'), false, '自由文本也算答了');
+test("空回答判定：有选项的问题什么都没选 = 空", () => {
+	const qs = [{ id: "q1", question: "a", options: [{ label: "X" }] }];
+	assert.equal(isBlankAnswer(qs, "", ""), true);
+	assert.equal(isBlankAnswer(qs, "X", ""), false);
+	assert.equal(isBlankAnswer(qs, "", "自由文本"), false, "自由文本也算答了");
 });
 
-test('hasOptions / optionLabels / questionTitle 的边界', () => {
-  assert.equal(hasOptions({}), false);
-  assert.equal(hasOptions({ options: [] }), false);
-  assert.equal(hasOptions({ options: [{ label: 'a' }] }), true);
-  assert.deepEqual(optionLabels({ options: ['a', { label: 'b' }, { description: 'x' }] }), ['a', 'b']);
-  assert.equal(questionTitle({ question: '只问一句' }), '只问一句');
-  assert.equal(questionTitle({}), '(未提供问题)');
+test("hasOptions / optionLabels / questionTitle 的边界", () => {
+	assert.equal(hasOptions({}), false);
+	assert.equal(hasOptions({ options: [] }), false);
+	assert.equal(hasOptions({ options: [{ label: "a" }] }), true);
+	assert.deepEqual(
+		optionLabels({ options: ["a", { label: "b" }, { description: "x" }] }),
+		["a", "b"],
+	);
+	assert.equal(questionTitle({ question: "只问一句" }), "只问一句");
+	assert.equal(questionTitle({}), "(未提供问题)");
 });
diff --git a/plugins/pi-mail-bridge/extension/index.ts b/plugins/pi-mail-bridge/extension/index.ts
new file mode 100644
index 0000000..06ebce7
--- /dev/null
+++ b/plugins/pi-mail-bridge/extension/index.ts
@@ -0,0 +1,187 @@
+/**
+ * pi 交互式会话的邮件工具扩展。
+ *
+ * # 与 src/index.mjs（常驻守护进程）的分工
+ *
+ *   - 守护进程负责**收信**：订阅 SSE、fork worker、跑模型、自动回信
+ *   - 本扩展只给**交互式 TUI 会话**装上同一套邮件工具
+ *
+ * 两者是同一条 AgentMail 身份（agent `pi`）的两个入口，与 DSH 的
+ * 「TUI + 邮箱是同一个 Agent」完全一致。人可以在 TUI 里直接收发邮件，
+ * 也可以在邮箱里给 pi 发信 —— 两边看到的是同一条会话流。
+ *
+ * # 为什么必须单独做这个扩展
+ *
+ * 守护进程用 `noExtensions: true` 起会话（见 src/session-pool.mjs），
+ * 所以它的邮件工具**不会**出现在人的交互式 pi 里。而平台的建设者与维护者
+ * 恰恰是在交互式 pi 里工作的：没有 send_mail / read_inbox，他既看不到
+ * 自己刚发出的那封信，也无法回信，只能绕到 curl + 密钥直连 Gateway ——
+ * 一个「邮件驱动」的平台，维护者自己收不到邮件。
+ *
+ * # 密钥从哪来
+ *
+ * 交互式 pi 的进程环境里通常**没有** AGENTMAIL_* 变量（守护进程的
+ * EnvironmentFile 只注入给它自己）。因此按以下顺序解析：
+ *
+ *   1. 进程环境（`AGENTMAIL_AGENT_KEY` / `AGENTMAIL_GATEWAY_URL` / `AGENTMAIL_AGENT_NAME`）
+ *   2. `AGENTMAIL_ENV_FILE`（默认 `/etc/agentmail/pi.env`）—— 部署时的权威来源，
+ *      与守护进程用的是同一把密钥，因此身份一致
+ *   3. `$AGENTMAIL_CONFIG_DIR/agent.key` 或 `~/.agentmail/agent.key`
+ *      （插件的历史约定；接受 `key` 与 `key_token` 两种字段名）
+ *
+ * 找不到密钥时**不注册任何工具**并明确告知 —— 挂上一组永远 401 的工具比没有更糟：
+ * 模型会以为自己能发信，人却只看到一串认证失败。
+ *
+ * # 为什么不注册 connect_to_server
+ *
+ * 那个工具会重写 Gateway 坐标并重新登记密钥。在交互式会话里调用它会**动到守护
+ * 进程的配置**（两者共用同一把密钥与同一个 Agent 名），而守护进程才是真正长期
+ * 持有 SSE 长连的一方。坐标变更属于部署动作，不该由一次 TUI 对话触发。
+ */
+
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+
+const DEFAULT_ENV_FILE = '/etc/agentmail/pi.env';
+const DEFAULT_GATEWAY = 'http://127.0.0.1:8180';
+
+/** 守护进程专用的生命周期工具：交互式会话里不注册（理由见文件头注释）。 */
+const EXCLUDED_TOOLS = new Set(['connect_to_server']);
+
+/**
+ * registerTool 期望的完整定义形状。
+ *
+ * 用 SDK 自己的类型取，而不是复制一份：SDK 升级时形状变化会在这里变成编译错误，
+ * 而不是运行时的静默错配。
+ */
+type MailTool = Parameters<ExtensionAPI['registerTool']>[0];
+
+/** 极简 .env 解析：只认 `KEY=value`，忽略注释与空行，不处理引号与转义。 */
+function parseEnvFile(path: string): Record<string, string> {
+  const out: Record<string, string> = {};
+  if (!existsSync(path)) return out;
+  let raw: string;
+  try {
+    raw = readFileSync(path, 'utf8');
+  } catch {
+    return out;
+  }
+  for (const line of raw.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eq = trimmed.indexOf('=');
+    if (eq <= 0) continue;
+    const key = trimmed.slice(0, eq).trim();
+    // 值里可能有 `=`（例如 base64），只切第一个
+    out[key] = trimmed.slice(eq + 1).trim();
+  }
+  return out;
+}
+
+/** 读插件约定的本地密钥文件，兼容 `key` 与 `key_token` 两种字段名。 */
+function readLocalKey(configDir?: string): string {
+  const candidates = [
+    join(configDir || join(homedir(), '.agentmail'), 'agent.key'),
+    join(homedir(), '.agentmail', 'agent.key'),
+  ];
+  for (const path of candidates) {
+    try {
+      if (!existsSync(path)) continue;
+      const raw = JSON.parse(readFileSync(path, 'utf8')) as
+        { key?: unknown; key_token?: unknown };
+      // 历史文件用的是 key_token（见部署实况），只认 `key` 会静默读不到。
+      const key = raw?.key ?? raw?.key_token;
+      if (typeof key === 'string' && key.trim()) return key.trim();
+    } catch {
+      // 读不了就试下一个
+    }
+  }
+  return '';
+}
+
+interface MailConfig {
+  url: string;
+  agentName: string;
+  agentKey: string;
+}
+
+/** @returns null 表示拿不到密钥（调用方据此不注册任何工具） */
+function resolveConfig(): MailConfig | null {
+  let url = process.env.AGENTMAIL_GATEWAY_URL || '';
+  let agentName = process.env.AGENTMAIL_AGENT_NAME || '';
+  let agentKey = process.env.AGENTMAIL_AGENT_KEY || '';
+
+  if (!agentKey) {
+    const envFile = process.env.AGENTMAIL_ENV_FILE || DEFAULT_ENV_FILE;
+    const parsed = parseEnvFile(envFile);
+    agentKey = parsed.AGENTMAIL_AGENT_KEY || '';
+    url = url || parsed.AGENTMAIL_GATEWAY_URL || '';
+    agentName = agentName || parsed.AGENTMAIL_AGENT_NAME || '';
+  }
+
+  if (!agentKey) agentKey = readLocalKey(process.env.AGENTMAIL_CONFIG_DIR);
+  if (!agentKey) return null;
+
+  return {
+    url: (url || DEFAULT_GATEWAY).replace(/\/+$/, ''),
+    agentName: agentName || 'pi',
+    agentKey,
+  };
+}
+
+export default async function (pi: ExtensionAPI): Promise<void> {
+  const cfg = resolveConfig();
+
+  // 动态 import 仓库里的 .mjs：它们没有 .d.ts（也不该造一份 —— 守护进程用同一份
+  // 对象经 customTools 注册，额外声明只会两边不同步），因此在边界上收窄成我们
+  // 真正依赖的最小形状。工具对象的 `parameters` 是普通 JSON Schema，而
+  // registerTool 的类型要求 TypeBox 的 TSchema；两者在运行期是同一套 JSON Schema
+  // 校验（守护进程已长期验证），差异只在静态类型上，故此处一次收窄并注明。
+  let registered = 0;
+  let notice = '';
+
+  if (!cfg) {
+    notice = 'pi-mail-bridge：未找到 AgentMail 密钥（AGENTMAIL_AGENT_KEY / '
+      + `${process.env.AGENTMAIL_ENV_FILE || DEFAULT_ENV_FILE} / ~/.agentmail/agent.key），`
+      + '邮件工具未注册。';
+  } else {
+    const gatewayMod = await import(new URL('../src/gateway.mjs', import.meta.url).href);
+    const toolsMod = await import(new URL('../src/tools.mjs', import.meta.url).href);
+    const GatewayClient = gatewayMod.GatewayClient as new (opts: {
+      url: string; agentName: string; agentKey: string; agentSecret: string;
+    }) => unknown;
+    const createMailTools = toolsMod.createMailTools as (opts: {
+      client: unknown; agentName: string; log: (msg: string) => void;
+    }) => MailTool[];
+
+    const tools = createMailTools({
+      client: new GatewayClient({
+        url: cfg.url,
+        agentName: cfg.agentName,
+        agentKey: cfg.agentKey,
+        agentSecret: '',
+      }),
+      agentName: cfg.agentName,
+      // 出错只进 stderr（不污染 TUI）；正常路径本身不吵闹。
+      log: (msg: string) => console.error(`[pi-mail-tools] ${msg}`),
+    });
+
+    for (const tool of tools) {
+      if (!tool?.name || EXCLUDED_TOOLS.has(tool.name)) continue;
+      pi.registerTool(tool);
+      registered += 1;
+    }
+  }
+
+  // 只在 session_start 里报：扩展工厂可能在「不会开会话」的调用里执行
+  // （例如 pi --list-models），那里没有 ctx，也没有界面可显示。
+  pi.on('session_start', async (_event, ctx) => {
+    if (notice) {
+      ctx.ui.notify(notice, 'warning');
+      return;
+    }
+    ctx.ui.setStatus('pi-mail', `邮件已接入（${cfg?.agentName}@${cfg?.url}，${registered} 个工具）`);
+  });
+}
diff --git a/plugins/pi-mail-bridge/src/gateway.mjs b/plugins/pi-mail-bridge/src/gateway.mjs
index 24b2155..72a8e84 100644
--- a/plugins/pi-mail-bridge/src/gateway.mjs
+++ b/plugins/pi-mail-bridge/src/gateway.mjs
@@ -5,16 +5,17 @@
  * 本文件只管认证头、密钥解析与坐标变更。
  */
 
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
-import { randomBytes } from 'node:crypto';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { homedir } from "node:os";
+import { join } from "node:path";
 
-import { createSSEClient } from '../lib/sse-client.js';
+import { createSSEClient } from "../lib/sse-client.js";
 
-const CONFIG_DIR = process.env.AGENTMAIL_CONFIG_DIR || join(homedir(), '.agentmail');
-export const KEY_FILE = join(CONFIG_DIR, 'agent.key');
-const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const CONFIG_DIR =
+	process.env.AGENTMAIL_CONFIG_DIR || join(homedir(), ".agentmail");
+export const KEY_FILE = join(CONFIG_DIR, "agent.key");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
 
 /**
  * 把管理员给的密钥落盘（0600）。
@@ -23,23 +24,29 @@ const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
  * 否则重启后又回到无法连接的状态 —— 而那正是这个工具要解决的问题。
  */
 export function saveLocalKey(token) {
-  mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-  writeFileSync(
-    KEY_FILE,
-    JSON.stringify({ key_token: token, created_at: new Date().toISOString() }, null, 2),
-    { mode: 0o600 },
-  );
+	mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+	writeFileSync(
+		KEY_FILE,
+		JSON.stringify(
+			{ key_token: token, created_at: new Date().toISOString() },
+			null,
+			2,
+		),
+		{ mode: 0o600 },
+	);
 }
 
 /** 读取本地密钥文件；不存在或损坏时返回 null。 */
 export function readLocalKey() {
-  try {
-    if (!existsSync(KEY_FILE)) return null;
-    const raw = JSON.parse(readFileSync(KEY_FILE, 'utf8'));
-    return typeof raw?.key_token === 'string' && raw.key_token ? raw.key_token : null;
-  } catch {
-    return null;
-  }
+	try {
+		if (!existsSync(KEY_FILE)) return null;
+		const raw = JSON.parse(readFileSync(KEY_FILE, "utf8"));
+		return typeof raw?.key_token === "string" && raw.key_token
+			? raw.key_token
+			: null;
+	} catch {
+		return null;
+	}
 }
 
 /**
@@ -49,164 +56,187 @@ export function readLocalKey() {
  * 走 console.error 而不是任何结构化日志 —— 它一定进 journalctl（契约 9.8）。
  */
 export function generateLocalKey(log = console.error) {
-  const token = randomBytes(32).toString('hex');
-  mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-  writeFileSync(
-    KEY_FILE,
-    JSON.stringify({ key_token: token, created_at: new Date().toISOString() }, null, 2),
-    { mode: 0o600 },
-  );
-  // 调用方传进来的 log 已经带 [pi-mail-bridge] 前缀，这里不再自己加
-  log(`已在 ${KEY_FILE} 生成本地密钥。`);
-  log(`该密钥需管理员在 AgentMail 后台登记后才能接入：`);
-  log(`  ${token}`);
-  return token;
+	const token = randomBytes(32).toString("hex");
+	mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+	writeFileSync(
+		KEY_FILE,
+		JSON.stringify(
+			{ key_token: token, created_at: new Date().toISOString() },
+			null,
+			2,
+		),
+		{ mode: 0o600 },
+	);
+	// 调用方传进来的 log 已经带 [pi-mail-bridge] 前缀，这里不再自己加
+	log(`已在 ${KEY_FILE} 生成本地密钥。`);
+	log(`该密钥需管理员在 AgentMail 后台登记后才能接入：`);
+	log(`  ${token}`);
+	return token;
 }
 
 /** 把 gateway 地址与身份记到 config.json，便于换机时人工核对。 */
 export function saveConfig(extra) {
-  try {
-    mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-    let cur = {};
-    if (existsSync(CONFIG_FILE)) {
-      try { cur = JSON.parse(readFileSync(CONFIG_FILE, 'utf8')); } catch { /* 损坏就重写 */ }
-    }
-    writeFileSync(CONFIG_FILE, JSON.stringify({ ...cur, ...extra }, null, 2), { mode: 0o600 });
-  } catch (e) {
-    console.error('[pi-mail-bridge] 写 config.json 失败:', e?.message || e);
-  }
+	try {
+		mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+		let cur = {};
+		if (existsSync(CONFIG_FILE)) {
+			try {
+				cur = JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
+			} catch {
+				/* 损坏就重写 */
+			}
+		}
+		writeFileSync(CONFIG_FILE, JSON.stringify({ ...cur, ...extra }, null, 2), {
+			mode: 0o600,
+		});
+	} catch (e) {
+		console.error("[pi-mail-bridge] 写 config.json 失败:", e?.message || e);
+	}
 }
 
 export class GatewayClient {
-  /**
-   * @param {{url: string, agentName: string, agentKey: string, agentSecret: string}} opts
-   */
-  constructor({ url, agentName, agentKey, agentSecret }) {
-    this.baseURL = String(url || 'http://127.0.0.1:8180').replace(/\/+$/, '');
-    this.agentName = agentName;
-    this.agentKey = agentKey || '';
-    this.agentSecret = agentSecret || '';
-    this.sseClient = null;
-  }
+	/**
+	 * @param {{url: string, agentName: string, agentKey: string, agentSecret: string}} opts
+	 */
+	constructor({ url, agentName, agentKey, agentSecret }) {
+		this.baseURL = String(url || "http://127.0.0.1:8180").replace(/\/+$/, "");
+		this.agentName = agentName;
+		this.agentKey = agentKey || "";
+		this.agentSecret = agentSecret || "";
+		this.sseClient = null;
+	}
 
-  /** 认证头：有密钥走 Bearer，否则退回 name/secret。 */
-  authHeaders() {
-    if (this.agentKey) {
-      return { Authorization: `Bearer ${this.agentKey}`, 'X-Agent-Name': this.agentName };
-    }
-    return { 'X-Agent-Name': this.agentName, 'X-Agent-Secret': this.agentSecret };
-  }
+	/** 认证头：有密钥走 Bearer，否则退回 name/secret。 */
+	authHeaders() {
+		if (this.agentKey) {
+			return {
+				Authorization: `Bearer ${this.agentKey}`,
+				"X-Agent-Name": this.agentName,
+			};
+		}
+		return {
+			"X-Agent-Name": this.agentName,
+			"X-Agent-Secret": this.agentSecret,
+		};
+	}
 
-  async get(path) {
-    const res = await fetch(`${this.baseURL}/api/v1${path}`, { headers: this.authHeaders() });
-    if (!res.ok) throw new Error(`GET ${path} 失败: HTTP ${res.status}`);
-    return res.json();
-  }
+	async get(path) {
+		const res = await fetch(`${this.baseURL}/api/v1${path}`, {
+			headers: this.authHeaders(),
+		});
+		if (!res.ok) throw new Error(`GET ${path} 失败: HTTP ${res.status}`);
+		return res.json();
+	}
 
-  async post(path, body) {
-    const res = await fetch(`${this.baseURL}/api/v1${path}`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json', ...this.authHeaders() },
-      body: JSON.stringify(body),
-    });
-    const data = await res.json().catch(() => ({}));
-    if (!res.ok) {
-      const err = new Error(data?.error || `POST ${path} 失败: HTTP ${res.status}`);
-      err.status = res.status;
-      // 响应体也带上：服务端对 409 会给 detail/suggestion，
-      // 那些文字要原文转给模型（它据此决定换什么做法）。
-      err.body = data;
-      throw err;
-    }
-    return data;
-  }
+	async post(path, body) {
+		const res = await fetch(`${this.baseURL}/api/v1${path}`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json", ...this.authHeaders() },
+			body: JSON.stringify(body),
+		});
+		const data = await res.json().catch(() => ({}));
+		if (!res.ok) {
+			const err = new Error(
+				data?.error || `POST ${path} 失败: HTTP ${res.status}`,
+			);
+			err.status = res.status;
+			// 响应体也带上：服务端对 409 会给 detail/suggestion，
+			// 那些文字要原文转给模型（它据此决定换什么做法）。
+			err.body = data;
+			throw err;
+		}
+		return data;
+	}
 
-  /** 注册。workspaces 传 []（B-1.2）—— 工作目录由每封邮件的 to_workspace 决定。 */
-  async register() {
-    return this.post('/agent/register', {
-      name: this.agentName,
-      secret: this.agentSecret || '',
-      workspaces: [],
-      platform: 'pi',
-    });
-  }
+	/** 注册。workspaces 传 []（B-1.2）—— 工作目录由每封邮件的 to_workspace 决定。 */
+	async register() {
+		return this.post("/agent/register", {
+			name: this.agentName,
+			secret: this.agentSecret || "",
+			workspaces: [],
+			platform: "pi",
+		});
+	}
 
-  /**
-   * 上传附件。
-   *
-   * 必须走 multipart 的 `file` 字段：服务端是 `r.FormFile("file")`，
-   * 且**不认 `X-Filename` 头**（grep 过 handler/attachments.go，没有这个分支）。
-   * 直接 POST 二进制体会得到 400「缺少 file 字段」。
-   *
-   * 不手动设 Content-Type：让 undici 按 FormData 自己生成 boundary。
-   */
-  async uploadFile(buf, filename) {
-    const form = new FormData();
-    form.append('file', new Blob([buf]), filename);
-    const res = await fetch(`${this.baseURL}/api/v1/attachments`, {
-      method: 'POST',
-      headers: this.authHeaders(),
-      body: form,
-    });
-    const data = await res.json().catch(() => ({}));
-    if (!res.ok) throw new Error(data?.error || `上传失败: HTTP ${res.status}`);
-    return data.attachment;
-  }
+	/**
+	 * 上传附件。
+	 *
+	 * 必须走 multipart 的 `file` 字段：服务端是 `r.FormFile("file")`，
+	 * 且**不认 `X-Filename` 头**（grep 过 handler/attachments.go，没有这个分支）。
+	 * 直接 POST 二进制体会得到 400「缺少 file 字段」。
+	 *
+	 * 不手动设 Content-Type：让 undici 按 FormData 自己生成 boundary。
+	 */
+	async uploadFile(buf, filename) {
+		const form = new FormData();
+		form.append("file", new Blob([buf]), filename);
+		const res = await fetch(`${this.baseURL}/api/v1/attachments`, {
+			method: "POST",
+			headers: this.authHeaders(),
+			body: form,
+		});
+		const data = await res.json().catch(() => ({}));
+		if (!res.ok) throw new Error(data?.error || `上传失败: HTTP ${res.status}`);
+		return data.attachment;
+	}
 
-  async downloadFile(attachmentID) {
-    const res = await fetch(`${this.baseURL}/api/v1/attachments/${attachmentID}`, {
-      headers: this.authHeaders(),
-    });
-    if (!res.ok) throw new Error(`下载失败: HTTP ${res.status}`);
-    return Buffer.from(await res.arrayBuffer());
-  }
+	async downloadFile(attachmentID) {
+		const res = await fetch(
+			`${this.baseURL}/api/v1/attachments/${attachmentID}`,
+			{
+				headers: this.authHeaders(),
+			},
+		);
+		if (!res.ok) throw new Error(`下载失败: HTTP ${res.status}`);
+		return Buffer.from(await res.arrayBuffer());
+	}
 
-  /**
-   * 建立 SSE 长连并自动重连。
-   *
-   * 实现委托给共用模块 `lib/sse-client.js`（三桥逐字节同源，由
-   * deploy/check-shared-libs.sh 校验）—— 那里把「跨 TCP 分片保帧状态」与
-   * 「Last-Event-ID 断点续传」两件事写对了一次，不必每个平台各抄一遍。
-   *
-   * 断线重连带 `Last-Event-ID`（D-7.2）：服务端有 per-agent 环形缓冲，
-   * 能把断连期间的事件回放出来 —— 否则那段时间的邮件只能等下次重启补拉。
-   * 首次连接**不带**（N-11）：那会让服务端把缓冲区里的旧事件全回放一遍。
-   */
-  startSSE(onEvent, log = console.error) {
-    this.sseClient?.stop?.();
-    this.sseClient = createSSEClient({
-      authHeaders: () => this.authHeaders(),
-      baseURL: this.baseURL,
-      path: '/api/v1/events/stream',
-      onEvent,
-      log,
-    });
-  }
+	/**
+	 * 建立 SSE 长连并自动重连。
+	 *
+	 * 实现委托给共用模块 `lib/sse-client.js`（三桥逐字节同源，由
+	 * deploy/check-shared-libs.sh 校验）—— 那里把「跨 TCP 分片保帧状态」与
+	 * 「Last-Event-ID 断点续传」两件事写对了一次，不必每个平台各抄一遍。
+	 *
+	 * 断线重连带 `Last-Event-ID`（D-7.2）：服务端有 per-agent 环形缓冲，
+	 * 能把断连期间的事件回放出来 —— 否则那段时间的邮件只能等下次重启补拉。
+	 * 首次连接**不带**（N-11）：那会让服务端把缓冲区里的旧事件全回放一遍。
+	 */
+	startSSE(onEvent, log = console.error) {
+		this.sseClient?.stop?.();
+		this.sseClient = createSSEClient({
+			authHeaders: () => this.authHeaders(),
+			baseURL: this.baseURL,
+			path: "/api/v1/events/stream",
+			onEvent,
+			log,
+		});
+	}
 
-  /**
-   * 换 Gateway 地址或换密钥。
-   *
-   * 守护进程不能靠重启来应用新配置 —— connect_to_server 是模型在**运行中**
-   * 调的，它期望调完就能收信。所以这里除了改字段还要重置断点：
-   * `lastEventID` 是**旧** Gateway 环形缓冲里的序号，拿去问新 Gateway 会
-   * 命中一段完全无关的历史（或直接被拒），得到的事件属于别人的会话。
-   *
-   * @returns {boolean} 是否真的变了（没变就不必重连 SSE，省一次断流）
-   */
-  reconfigure({ url, agentKey }) {
-    const nextURL = url ? String(url).replace(/\/+$/, '') : this.baseURL;
-    const nextKey = agentKey || this.agentKey;
-    const changed = nextURL !== this.baseURL || nextKey !== this.agentKey;
-    if (!changed) return false;
+	/**
+	 * 换 Gateway 地址或换密钥。
+	 *
+	 * 守护进程不能靠重启来应用新配置 —— connect_to_server 是模型在**运行中**
+	 * 调的，它期望调完就能收信。所以这里除了改字段还要重置断点：
+	 * `lastEventID` 是**旧** Gateway 环形缓冲里的序号，拿去问新 Gateway 会
+	 * 命中一段完全无关的历史（或直接被拒），得到的事件属于别人的会话。
+	 *
+	 * @returns {boolean} 是否真的变了（没变就不必重连 SSE，省一次断流）
+	 */
+	reconfigure({ url, agentKey }) {
+		const nextURL = url ? String(url).replace(/\/+$/, "") : this.baseURL;
+		const nextKey = agentKey || this.agentKey;
+		const changed = nextURL !== this.baseURL || nextKey !== this.agentKey;
+		if (!changed) return false;
 
-    if (nextURL !== this.baseURL) this.sseClient?.reset?.();
-    this.baseURL = nextURL;
-    this.agentKey = nextKey;
-    return true;
-  }
+		if (nextURL !== this.baseURL) this.sseClient?.reset?.();
+		this.baseURL = nextURL;
+		this.agentKey = nextKey;
+		return true;
+	}
 
-  stopSSE() {
-    this.sseClient?.stop?.();
-    this.sseClient = null;
-  }
+	stopSSE() {
+		this.sseClient?.stop?.();
+		this.sseClient = null;
+	}
 }
diff --git a/plugins/pi-mail-bridge/src/pool.mjs b/plugins/pi-mail-bridge/src/pool.mjs
index 015703f..6baf04e 100644
--- a/plugins/pi-mail-bridge/src/pool.mjs
+++ b/plugins/pi-mail-bridge/src/pool.mjs
@@ -56,12 +56,16 @@
  * 一处只增不减的结构。
  */
 
-import { fork } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
+import { fork } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
-import { BoundedMap, BoundedSet, MAX_TRACKED_SESSIONS } from '../lib/bounded.js';
+import {
+	BoundedMap,
+	BoundedSet,
+	MAX_TRACKED_SESSIONS,
+} from "../lib/bounded.js";
 
-const WORKER_PATH = fileURLToPath(new URL('./worker.mjs', import.meta.url));
+const WORKER_PATH = fileURLToPath(new URL("./worker.mjs", import.meta.url));
 
 /**
  * @param {object} deps
@@ -77,277 +81,328 @@ const WORKER_PATH = fileURLToPath(new URL('./worker.mjs', import.meta.url));
  *   让调度不变量（并发上限、同会话串行、硬超时）能在毫秒级验证。
  */
 export function createWorkerPool({
-  log, config, onReconfigure,
-  maxWorkers = 3, workerMaxMs = 600_000, maxAttempts = 3, workerPath = WORKER_PATH,
+	log,
+	config,
+	onReconfigure,
+	maxWorkers = 3,
+	workerMaxMs = 600_000,
+	maxAttempts = 3,
+	workerPath = WORKER_PATH,
 }) {
-  /** 正在跑的 worker：mailSessionKey -> {child, mailID, startedAt, timer} */
-  const running = new Map();
-  /** 等着派的活，先进先出。 */
-  const queue = [];
-  /** relay_key -> mailSessionKey，把决策路由回发起询问的那个 worker。 */
-  const permissionRoutes = new Map();
-  /**
-   * 跨 worker 存活的会话状态：mailSessionKey -> {sessionFile, cwd, piSessionId,
-   * grants:Set, lastSyncedName}。
-   *
-   * 这是 worker 一封一进程之后仍需在主进程留存的全部东西 —— 下一封邮件靠
-   * sessionFile 接着谈，靠 grants 不重复问已经「一直同意」过的工具。
-   */
-  const sessionState = new BoundedMap(MAX_TRACKED_SESSIONS);
-  /**
-   * 被模型降级换掉的旧 pi 会话 id。
-   *
-   * 仍要计入 mail_driven：它们已经参与过邮件往来，而磁盘上的会话文件
-   * 不会因为换模型而消失 —— 心跳快照仍会上报它们。
-   */
-  const retired = new BoundedSet(MAX_TRACKED_SESSIONS);
-  let stopped = false;
+	/** 正在跑的 worker：mailSessionKey -> {child, mailID, startedAt, timer} */
+	const running = new Map();
+	/** 等着派的活，先进先出。 */
+	const queue = [];
+	/** relay_key -> mailSessionKey，把决策路由回发起询问的那个 worker。 */
+	const permissionRoutes = new Map();
+	/**
+	 * 跨 worker 存活的会话状态：mailSessionKey -> {sessionFile, cwd, piSessionId,
+	 * grants:Set, lastSyncedName}。
+	 *
+	 * 这是 worker 一封一进程之后仍需在主进程留存的全部东西 —— 下一封邮件靠
+	 * sessionFile 接着谈，靠 grants 不重复问已经「一直同意」过的工具。
+	 */
+	const sessionState = new BoundedMap(MAX_TRACKED_SESSIONS);
+	/**
+	 * 被模型降级换掉的旧 pi 会话 id。
+	 *
+	 * 仍要计入 mail_driven：它们已经参与过邮件往来，而磁盘上的会话文件
+	 * 不会因为换模型而消失 —— 心跳快照仍会上报它们。
+	 */
+	const retired = new BoundedSet(MAX_TRACKED_SESSIONS);
+	let stopped = false;
 
-  /**
-   * 邮件会话 id 作为串行化的键。
-   *
-   * 没有 session_id 的事件（理论上不该有）退回 mail_id：那样每封各占一个
-   * worker，不会串行 —— 但它们本来也不属于同一条会话。
-   */
-  const keyOf = (data) => data?.session_id || `mail:${data?.mail_id || Math.random()}`;
+	/**
+	 * 邮件会话 id 作为串行化的键。
+	 *
+	 * 没有 session_id 的事件（理论上不该有）退回 mail_id：那样每封各占一个
+	 * worker，不会串行 —— 但它们本来也不属于同一条会话。
+	 */
+	const keyOf = (data) =>
+		data?.session_id || `mail:${data?.mail_id || Math.random()}`;
 
-  function submit(kind, data, attempt = 1) {
-    if (stopped) return;
-    queue.push({ kind, data, key: keyOf(data), attempt });
-    pump();
-  }
+	function submit(kind, data, attempt = 1) {
+		if (stopped) return;
+		queue.push({ kind, data, key: keyOf(data), attempt });
+		pump();
+	}
 
-  function pump() {
-    if (stopped) return;
-    for (let i = 0; i < queue.length; i++) {
-      const job = queue[i];
-      // 同一会话已有 worker 在跑 → 跳过它，看后面有没有别的会话可以先跑。
-      // 不能 break：那会让一条慢会话把所有别的会话都堵住（正是要修的病）。
-      if (running.has(job.key)) continue;
-      if (running.size >= maxWorkers) return;
-      queue.splice(i, 1);
-      i--;
-      spawn(job);
-    }
-  }
+	function pump() {
+		if (stopped) return;
+		for (let i = 0; i < queue.length; i++) {
+			const job = queue[i];
+			// 同一会话已有 worker 在跑 → 跳过它，看后面有没有别的会话可以先跑。
+			// 不能 break：那会让一条慢会话把所有别的会话都堵住（正是要修的病）。
+			if (running.has(job.key)) continue;
+			if (running.size >= maxWorkers) return;
+			queue.splice(i, 1);
+			i--;
+			spawn(job);
+		}
+	}
 
-  function spawn(job) {
-    const state = sessionState.get(job.key) || { grants: new Set(), lastSyncedName: '' };
-    const child = fork(workerPath, [], {
-      // stdio 继承：worker 里 pi SDK 自己打的东西直接进 journalctl。
-      // 'ipc' 必须显式列出，否则 process.send 不存在。
-      stdio: ['ignore', 'inherit', 'inherit', 'ipc'],
-    });
+	function spawn(job) {
+		const state = sessionState.get(job.key) || {
+			grants: new Set(),
+			lastSyncedName: "",
+		};
+		const child = fork(workerPath, [], {
+			// stdio 继承：worker 里 pi SDK 自己打的东西直接进 journalctl。
+			// 'ipc' 必须显式列出，否则 process.send 不存在。
+			stdio: ["ignore", "inherit", "inherit", "ipc"],
+		});
 
-    // 硬超时：worker 卡死（模型不返回、权限等不到决策而主进程也没收到事件）
-    // 时必须能回收，否则那条会话的后续邮件永远排队。
-    const timer = setTimeout(() => {
-      log(`worker ${child.pid} 处理 ${job.data?.mail_id} 超过 ${workerMaxMs / 1000}s，强杀`);
-      try { child.kill('SIGKILL'); } catch { /* 已经死了 */ }
-    }, workerMaxMs);
-    if (typeof timer.unref === 'function') timer.unref();
+		// 硬超时：worker 卡死（模型不返回、权限等不到决策而主进程也没收到事件）
+		// 时必须能回收，否则那条会话的后续邮件永远排队。
+		const timer = setTimeout(() => {
+			log(
+				`worker ${child.pid} 处理 ${job.data?.mail_id} 超过 ${workerMaxMs / 1000}s，强杀`,
+			);
+			try {
+				child.kill("SIGKILL");
+			} catch {
+				/* 已经死了 */
+			}
+		}, workerMaxMs);
+		if (typeof timer.unref === "function") timer.unref();
 
-    const entry = {
-      child, mailID: job.data?.mail_id || '', key: job.key,
-      startedAt: Date.now(), timer, settled: false,
-    };
-    running.set(job.key, entry);
+		const entry = {
+			child,
+			mailID: job.data?.mail_id || "",
+			key: job.key,
+			startedAt: Date.now(),
+			timer,
+			settled: false,
+		};
+		running.set(job.key, entry);
 
-    child.on('message', (msg) => onWorkerMessage(entry, msg));
+		child.on("message", (msg) => onWorkerMessage(entry, msg));
 
-    child.on('exit', (code, signal) => {
-      clearTimeout(timer);
-      running.delete(job.key);
-      for (const [rk, k] of permissionRoutes) if (k === job.key) permissionRoutes.delete(rk);
+		child.on("exit", (code, signal) => {
+			clearTimeout(timer);
+			running.delete(job.key);
+			for (const [rk, k] of permissionRoutes)
+				if (k === job.key) permissionRoutes.delete(rk);
 
-      // 没收到 `done` 就退出 = 这封邮件**从未处理完**。
-      //
-      // 这是生产上真实存在的静默丢信路径：worker 被 SIGKILL（硬超时）、
-      // OOM、或自己崩溃时，`done` 永远不会到达，主进程只看到 exit code。
-      // 原来这里只记一行日志就 pump() —— 发件人看到信发出去了，
-      // 而那条会话再也不会有人回。
-      //
-      // 重投而不是直接由主进程回信：worker 崩溃可能是内存/上游瞬时故障，
-      // 重启一个进程真能跑通。有界（maxAttempts）是因为「必定失败」的邮件
-      // 无界重投会变成永久活锁，而日志里只有一行看不出是同一封在原地打转。
-      if (!entry.settled && !stopped) {
-        const attempt = job.attempt || 1;
-        if (attempt < maxAttempts) {
-          const delay = attempt * 1000;
-          log(`worker ${child.pid}（mail ${entry.mailID}）未回报 done 就退出`
-            + `（code=${code} signal=${signal || '-'}），${delay / 1000}s 后`
-            + `第 ${attempt + 1}/${maxAttempts} 次重投`);
-          const retry = setTimeout(() => {
-            if (stopped) return;
-            queue.push({ ...job, attempt: attempt + 1 });
-            pump();
-          }, delay);
-          if (typeof retry.unref === 'function') retry.unref();
-          // 退避期间不 pump：否则同一会话会被立刻重投，退避形同虚设
-          return;
-        }
-        log(`worker ${child.pid}（mail ${entry.mailID}）重投 ${maxAttempts} 次仍未完成，放弃`
-          + `（code=${code} signal=${signal || '-'}）`);
-      } else if (code !== 0) {
-        log(`worker ${child.pid}（mail ${entry.mailID}）异常退出 code=${code} signal=${signal || '-'}`);
-      }
-      pump();
-    });
+			// 没收到 `done` 就退出 = 这封邮件**从未处理完**。
+			//
+			// 这是生产上真实存在的静默丢信路径：worker 被 SIGKILL（硬超时）、
+			// OOM、或自己崩溃时，`done` 永远不会到达，主进程只看到 exit code。
+			// 原来这里只记一行日志就 pump() —— 发件人看到信发出去了，
+			// 而那条会话再也不会有人回。
+			//
+			// 重投而不是直接由主进程回信：worker 崩溃可能是内存/上游瞬时故障，
+			// 重启一个进程真能跑通。有界（maxAttempts）是因为「必定失败」的邮件
+			// 无界重投会变成永久活锁，而日志里只有一行看不出是同一封在原地打转。
+			if (!entry.settled && !stopped) {
+				const attempt = job.attempt || 1;
+				if (attempt < maxAttempts) {
+					const delay = attempt * 1000;
+					log(
+						`worker ${child.pid}（mail ${entry.mailID}）未回报 done 就退出` +
+							`（code=${code} signal=${signal || "-"}），${delay / 1000}s 后` +
+							`第 ${attempt + 1}/${maxAttempts} 次重投`,
+					);
+					const retry = setTimeout(() => {
+						if (stopped) return;
+						queue.push({ ...job, attempt: attempt + 1 });
+						pump();
+					}, delay);
+					if (typeof retry.unref === "function") retry.unref();
+					// 退避期间不 pump：否则同一会话会被立刻重投，退避形同虚设
+					return;
+				}
+				log(
+					`worker ${child.pid}（mail ${entry.mailID}）重投 ${maxAttempts} 次仍未完成，放弃` +
+						`（code=${code} signal=${signal || "-"}）`,
+				);
+			} else if (code !== 0) {
+				log(
+					`worker ${child.pid}（mail ${entry.mailID}）异常退出 code=${code} signal=${signal || "-"}`,
+				);
+			}
+			pump();
+		});
 
-    child.on('error', (e) => log(`worker ${child.pid} 出错: ${e?.message || e}`));
+		child.on("error", (e) =>
+			log(`worker ${child.pid} 出错: ${e?.message || e}`),
+		);
 
-    // 等 worker 说 ready 再派活：fork 返回时子进程的 import 还没跑完，
-    // 此时 send 的消息会排在 IPC 队列里（能收到，但 ready 让顺序确定）。
-    child.once('message', function first(msg) {
-      if (msg?.type !== 'ready') return;
-      child.send({
-        type: 'job',
-        kind: job.kind,
-        data: job.data,
-        session: {
-          sessionFile: state.sessionFile || '',
-          cwd: state.cwd || '',
-        },
-        grants: [...state.grants],
-        lastSyncedName: state.lastSyncedName || '',
-        config: config(),
-      });
-    });
-  }
+		// 等 worker 说 ready 再派活：fork 返回时子进程的 import 还没跑完，
+		// 此时 send 的消息会排在 IPC 队列里（能收到，但 ready 让顺序确定）。
+		child.once("message", function first(msg) {
+			if (msg?.type !== "ready") return;
+			child.send({
+				type: "job",
+				kind: job.kind,
+				data: job.data,
+				session: {
+					sessionFile: state.sessionFile || "",
+					cwd: state.cwd || "",
+				},
+				grants: [...state.grants],
+				lastSyncedName: state.lastSyncedName || "",
+				config: config(),
+			});
+		});
+	}
 
-  function onWorkerMessage(entry, msg) {
-    const state = sessionState.get(entry.key) || { grants: new Set(), lastSyncedName: '' };
-    switch (msg?.type) {
-      case 'log':
-        log(`[w${entry.child.pid}] ${msg.line}`);
-        return;
-      case 'session_opened':
-        // 一条会话可能先后用过多个 pi 会话 id（模型降级会换会话）。
-        // 旧 id 仍计入 mail_driven，理由见 retired 的注释。
-        if (state.piSessionId && state.piSessionId !== msg.piSessionId) {
-          retired.add(state.piSessionId);
-        }
-        state.piSessionId = msg.piSessionId;
-        state.sessionFile = msg.sessionFile;
-        state.cwd = msg.cwd;
-        sessionState.set(entry.key, state);
-        return;
-      case 'permission_pending':
-        permissionRoutes.set(msg.relayKey, entry.key);
-        return;
-      case 'permission_grant':
-        // 「一直同意」必须跨 worker 活着：worker 一封一进程，不存的话下一封
-        // 邮件又问一遍，那个选项就是在骗人。
-        state.grants.add(msg.toolName);
-        sessionState.set(entry.key, state);
-        return;
-      case 'name_synced':
-        state.lastSyncedName = msg.signature;
-        sessionState.set(entry.key, state);
-        return;
-      case 'reconfigure':
-        onReconfigure?.(msg.url, msg.agentKey);
-        return;
-      case 'done':
-        // 标记「这封真的处理完了」：exit 处理器据此区分「正常收尾」
-        // 与「未回报就崩溃」（后者要重投）。
-        entry.settled = true;
-        if (!msg.ok) log(`投递 ${entry.mailID} 失败: ${msg.error}`);
-        return;
-      default:
-        return;
-    }
-  }
+	function onWorkerMessage(entry, msg) {
+		const state = sessionState.get(entry.key) || {
+			grants: new Set(),
+			lastSyncedName: "",
+		};
+		switch (msg?.type) {
+			case "log":
+				log(`[w${entry.child.pid}] ${msg.line}`);
+				return;
+			case "session_opened":
+				// 一条会话可能先后用过多个 pi 会话 id（模型降级会换会话）。
+				// 旧 id 仍计入 mail_driven，理由见 retired 的注释。
+				if (state.piSessionId && state.piSessionId !== msg.piSessionId) {
+					retired.add(state.piSessionId);
+				}
+				state.piSessionId = msg.piSessionId;
+				state.sessionFile = msg.sessionFile;
+				state.cwd = msg.cwd;
+				sessionState.set(entry.key, state);
+				return;
+			case "permission_pending":
+				permissionRoutes.set(msg.relayKey, entry.key);
+				return;
+			case "permission_grant":
+				// 「一直同意」必须跨 worker 活着：worker 一封一进程，不存的话下一封
+				// 邮件又问一遍，那个选项就是在骗人。
+				state.grants.add(msg.toolName);
+				sessionState.set(entry.key, state);
+				return;
+			case "name_synced":
+				state.lastSyncedName = msg.signature;
+				sessionState.set(entry.key, state);
+				return;
+			case "reconfigure":
+				onReconfigure?.(msg.url, msg.agentKey);
+				return;
+			case "done":
+				// 标记「这封真的处理完了」：exit 处理器据此区分「正常收尾」
+				// 与「未回报就崩溃」（后者要重投）。
+				entry.settled = true;
+				if (!msg.ok) log(`投递 ${entry.mailID} 失败: ${msg.error}`);
+				return;
+			default:
+				return;
+		}
+	}
 
-  /**
-   * 把权限决策路由到发起询问的那个 worker。
-   *
-   * @returns {boolean} 有没有找到对应的 worker。找不到说明那个 worker 已经退了
-   *   （桥重启、硬超时被杀、或者处理已经结束）—— 调用方据此走 B-4.2 的
-   *   降级路径（把决策当一封通知投进原会话）。
-   */
-  function routePermission(relayKey, decision) {
-    const key = permissionRoutes.get(relayKey);
-    if (!key) return false;
-    const entry = running.get(key);
-    if (!entry) {
-      permissionRoutes.delete(relayKey);
-      return false;
-    }
-    permissionRoutes.delete(relayKey);
-    entry.child.send({ type: 'permission_decision', relayKey, decision });
-    return true;
-  }
+	/**
+	 * 把权限决策路由到发起询问的那个 worker。
+	 *
+	 * @returns {boolean} 有没有找到对应的 worker。找不到说明那个 worker 已经退了
+	 *   （桥重启、硬超时被杀、或者处理已经结束）—— 调用方据此走 B-4.2 的
+	 *   降级路径（把决策当一封通知投进原会话）。
+	 */
+	function routePermission(relayKey, decision) {
+		const key = permissionRoutes.get(relayKey);
+		if (!key) return false;
+		const entry = running.get(key);
+		if (!entry) {
+			permissionRoutes.delete(relayKey);
+			return false;
+		}
+		permissionRoutes.delete(relayKey);
+		entry.child.send({ type: "permission_decision", relayKey, decision });
+		return true;
+	}
 
-  /** 这条邮件会话有 worker 在跑吗（B-4.2 判断降级路径用）。 */
-  const hasSession = (mailSessionID) => sessionState.has(mailSessionID);
+	/** 这条邮件会话有 worker 在跑吗（B-4.2 判断降级路径用）。 */
+	const hasSession = (mailSessionID) => sessionState.has(mailSessionID);
 
-  /**
-   * 忘掉一条已归档会话的全部状态。
-   *
-   * 归档是个**确定性的终点**：归档后那条会话不可寻址（别名 404），也不会再有
-   * 新邮件投进来。把它的 sessionState 留着只是占内存，而上限淘汰是「猜」——
-   * 能确切知道该删的时候就不该依赖猜。
-   *
-   * 正在跑的 worker **不杀**：归档不是中止指令，模型可能正在写文件；它自己跑完
-   * 就退，只是那一轮的回信会因为会话已归档而被服务端拦下。
-   *
-   * @param {string} mailSessionID
-   * @returns {boolean} 是否真的删掉了东西
-   */
-  function forget(mailSessionID) {
-    if (!mailSessionID) return false;
-    // peek 而不是 get：这是清理路径，不该把即将删掉的条目刷成「最近活跃」。
-    const state = sessionState.peek(mailSessionID);
-    // 已归档会话的 pi 会话 id 也不必再报 mail_driven：那个标记的用途是让人在
-    // 补全里看到「这条在跑邮件」，而已归档的会话不在补全候选里。
-    if (state?.piSessionId) retired.delete(state.piSessionId);
-    return sessionState.delete(mailSessionID);
-  }
+	/**
+	 * 忘掉一条已归档会话的全部状态。
+	 *
+	 * 归档是个**确定性的终点**：归档后那条会话不可寻址（别名 404），也不会再有
+	 * 新邮件投进来。把它的 sessionState 留着只是占内存，而上限淘汰是「猜」——
+	 * 能确切知道该删的时候就不该依赖猜。
+	 *
+	 * 正在跑的 worker **不杀**：归档不是中止指令，模型可能正在写文件；它自己跑完
+	 * 就退，只是那一轮的回信会因为会话已归档而被服务端拦下。
+	 *
+	 * @param {string} mailSessionID
+	 * @returns {boolean} 是否真的删掉了东西
+	 */
+	function forget(mailSessionID) {
+		if (!mailSessionID) return false;
+		// peek 而不是 get：这是清理路径，不该把即将删掉的条目刷成「最近活跃」。
+		const state = sessionState.peek(mailSessionID);
+		// 已归档会话的 pi 会话 id 也不必再报 mail_driven：那个标记的用途是让人在
+		// 补全里看到「这条在跑邮件」，而已归档的会话不在补全候选里。
+		if (state?.piSessionId) retired.delete(state.piSessionId);
+		return sessionState.delete(mailSessionID);
+	}
 
-  /**
-   * 邮件驱动过的 pi 会话 id，喂给心跳快照的 `mail_driven` 标记。
-   *
-   * 不随 worker 退出而清：worker 退了不代表那条会话不再参与邮件往来 ——
-   * 下一封邮件还会接着谈，而人在补全里需要看到它带着这个标记。
-   * 重启丢是已知取舍（契约第六节）；确定性的清理时机是归档（见 forget）。
-   *
-   * 返回普通 Set 而不是 BoundedSet：调用方只拿它做一轮 has 查询就丢，
-   * 没有长期持有，不需要上界。
-   */
-  const mailDrivenIDs = () => {
-    const out = new Set(retired);
-    for (const st of sessionState.values()) {
-      if (st.piSessionId) out.add(st.piSessionId);
-    }
-    return out;
-  };
+	/**
+	 * 邮件驱动过的 pi 会话 id，喂给心跳快照的 `mail_driven` 标记。
+	 *
+	 * 不随 worker 退出而清：worker 退了不代表那条会话不再参与邮件往来 ——
+	 * 下一封邮件还会接着谈，而人在补全里需要看到它带着这个标记。
+	 * 重启丢是已知取舍（契约第六节）；确定性的清理时机是归档（见 forget）。
+	 *
+	 * 返回普通 Set 而不是 BoundedSet：调用方只拿它做一轮 has 查询就丢，
+	 * 没有长期持有，不需要上界。
+	 */
+	const mailDrivenIDs = () => {
+		const out = new Set(retired);
+		for (const st of sessionState.values()) {
+			if (st.piSessionId) out.add(st.piSessionId);
+		}
+		return out;
+	};
 
-  function stop() {
-    stopped = true;
-    queue.length = 0;
-    for (const { child, timer } of running.values()) {
-      clearTimeout(timer);
-      // 先 shutdown 让 worker 把未决权限 fail closed（B-9.2），再给它一点
-      // 时间自己退。不直接 SIGKILL：那样 pi 侧的 await 不会返回，而 worker
-      // 里可能正握着会话文件。
-      try { child.send({ type: 'shutdown' }); } catch { /* 通道已断 */ }
-      setTimeout(() => { try { child.kill('SIGKILL'); } catch { /* 已经死了 */ } }, 2000).unref?.();
-    }
-  }
+	function stop() {
+		stopped = true;
+		queue.length = 0;
+		for (const { child, timer } of running.values()) {
+			clearTimeout(timer);
+			// 先 shutdown 让 worker 把未决权限 fail closed（B-9.2），再给它一点
+			// 时间自己退。不直接 SIGKILL：那样 pi 侧的 await 不会返回，而 worker
+			// 里可能正握着会话文件。
+			try {
+				child.send({ type: "shutdown" });
+			} catch {
+				/* 通道已断 */
+			}
+			setTimeout(() => {
+				try {
+					child.kill("SIGKILL");
+				} catch {
+					/* 已经死了 */
+				}
+			}, 2000).unref?.();
+		}
+	}
 
-  /** 观测用：现在跑着几个、排了几个。 */
-  const stats = () => ({
-    running: running.size,
-    queued: queue.length,
-    sessions: sessionState.size,
-    // 淘汰计数持续增长说明上限设得太小 —— 那意味着会话上下文在被白白丢掉，
-    // 而症状是「这条会话怎么突然不记得前面说过什么了」。
-    evictedSessions: sessionState.evicted,
-    workers: [...running.values()].map((e) => ({
-      pid: e.child.pid, mailID: e.mailID, ageMs: Date.now() - e.startedAt,
-    })),
-  });
+	/** 观测用：现在跑着几个、排了几个。 */
+	const stats = () => ({
+		running: running.size,
+		queued: queue.length,
+		sessions: sessionState.size,
+		// 淘汰计数持续增长说明上限设得太小 —— 那意味着会话上下文在被白白丢掉，
+		// 而症状是「这条会话怎么突然不记得前面说过什么了」。
+		evictedSessions: sessionState.evicted,
+		workers: [...running.values()].map((e) => ({
+			pid: e.child.pid,
+			mailID: e.mailID,
+			ageMs: Date.now() - e.startedAt,
+		})),
+	});
 
-  return { submit, routePermission, hasSession, forget, mailDrivenIDs, stop, stats };
+	return {
+		submit,
+		routePermission,
+		hasSession,
+		forget,
+		mailDrivenIDs,
+		stop,
+		stats,
+	};
 }
diff --git a/plugins/pi-mail-bridge/test/pool.test.mjs b/plugins/pi-mail-bridge/test/pool.test.mjs
index 932be4c..fe51e63 100644
--- a/plugins/pi-mail-bridge/test/pool.test.mjs
+++ b/plugins/pi-mail-bridge/test/pool.test.mjs
@@ -11,19 +11,21 @@
  * 而不是一个间接的计数（计数在字段被丢掉时依然会给出绿色）。
  */
 
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
 
 // ─── 桩 worker ───
 //
 // 落到临时目录而不是仓库里：它是测试脚手架，不该被 check-shared-libs 之类的
 // 一致性脚本看到，也不该让人误以为是第二个真 worker。
-const STUB_DIR = mkdtempSync(join(tmpdir(), 'pi-pool-test-'));
-const STUB = join(STUB_DIR, 'stub-worker.mjs');
-writeFileSync(STUB, `
+const STUB_DIR = mkdtempSync(join(tmpdir(), "pi-pool-test-"));
+const STUB = join(STUB_DIR, "stub-worker.mjs");
+writeFileSync(
+	STUB,
+	`
 process.on('message', (msg) => {
   if (msg?.type === 'job') {
     const hold = msg.data?.__hold ?? 30;
@@ -80,297 +82,379 @@ process.on('message', (msg) => {
   }
 });
 process.send({ type: 'ready' });
-`);
+`,
+);
 
-const { createWorkerPool } = await import('../src/pool.mjs');
+const { createWorkerPool } = await import("../src/pool.mjs");
 
 /** 建一个用桩 worker 的池。 */
 function makePool(opts = {}) {
-  const lines = [];
-  const pool = createWorkerPool({
-    log: (...a) => lines.push(a.join(' ')),
-    config: () => ({ turnTimeoutMs: 1000, ...(opts.config || {}) }),
-    onReconfigure: opts.onReconfigure || (() => {}),
-    maxWorkers: opts.maxWorkers ?? 2,
-    workerMaxMs: opts.workerMaxMs ?? 5000,
-    maxAttempts: opts.maxAttempts,
-    workerPath: opts.workerPath || STUB,
-  });
-  return { pool, lines };
+	const lines = [];
+	const pool = createWorkerPool({
+		log: (...a) => lines.push(a.join(" ")),
+		config: () => ({ turnTimeoutMs: 1000, ...(opts.config || {}) }),
+		onReconfigure: opts.onReconfigure || (() => {}),
+		maxWorkers: opts.maxWorkers ?? 2,
+		workerMaxMs: opts.workerMaxMs ?? 5000,
+		maxAttempts: opts.maxAttempts,
+		workerPath: opts.workerPath || STUB,
+	});
+	return { pool, lines };
 }
 
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 
 /** 轮询到条件成立或超时 —— 比固定 sleep 稳。 */
 async function until(fn, timeoutMs = 4000) {
-  const t0 = Date.now();
-  while (Date.now() - t0 < timeoutMs) {
-    if (fn()) return true;
-    await sleep(20);
-  }
-  return false;
+	const t0 = Date.now();
+	while (Date.now() - t0 < timeoutMs) {
+		if (fn()) return true;
+		await sleep(20);
+	}
+	return false;
 }
 
 /** 从日志行里取出桩 worker 回声的 job 载荷。 */
 function jobs(lines) {
-  const out = [];
-  for (const l of lines) {
-    const i = l.indexOf('JOB ');
-    if (i === -1) continue;
-    try { out.push(JSON.parse(l.slice(i + 4))); } catch { /* 不是完整一行 */ }
-  }
-  return out;
+	const out = [];
+	for (const l of lines) {
+		const i = l.indexOf("JOB ");
+		if (i === -1) continue;
+		try {
+			out.push(JSON.parse(l.slice(i + 4)));
+		} catch {
+			/* 不是完整一行 */
+		}
+	}
+	return out;
 }
 
 /** 某个 mailID 的心跳出现过几次。 */
-const ticks = (lines, id) => lines.filter((l) => l.includes(`TICK ${id}`)).length;
+const ticks = (lines, id) =>
+	lines.filter((l) => l.includes(`TICK ${id}`)).length;
 
-test('并发上限被遵守：第三条会话要等前面空出来', async () => {
-  const { pool } = makePool({ maxWorkers: 2 });
-  for (const id of ['a', 'b', 'c']) {
-    pool.submit('mail', { mail_id: id, session_id: `S-${id}`, __hold: 250 });
-  }
+test("并发上限被遵守：第三条会话要等前面空出来", async () => {
+	const { pool } = makePool({ maxWorkers: 2 });
+	for (const id of ["a", "b", "c"]) {
+		pool.submit("mail", { mail_id: id, session_id: `S-${id}`, __hold: 250 });
+	}
 
-  let peak = 0;
-  const t = setInterval(() => { peak = Math.max(peak, pool.stats().running); }, 15);
-  const sawQueue = await until(() => pool.stats().queued > 0, 1000);
-  await until(() => pool.stats().running === 0 && pool.stats().queued === 0);
-  clearInterval(t);
-  pool.stop();
+	let peak = 0;
+	const t = setInterval(() => {
+		peak = Math.max(peak, pool.stats().running);
+	}, 15);
+	const sawQueue = await until(() => pool.stats().queued > 0, 1000);
+	await until(() => pool.stats().running === 0 && pool.stats().queued === 0);
+	clearInterval(t);
+	pool.stop();
 
-  assert.ok(peak <= 2, `同时跑的 worker 峰值 ${peak}，不该超过 maxWorkers=2`);
-  assert.ok(sawQueue, '满载时第三封该进队列而不是被丢掉');
+	assert.ok(peak <= 2, `同时跑的 worker 峰值 ${peak}，不该超过 maxWorkers=2`);
+	assert.ok(sawQueue, "满载时第三封该进队列而不是被丢掉");
 });
 
-test('同一会话串行：两个 worker 的心跳不得重叠', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 3 });
-  pool.submit('mail', { mail_id: 'm1', session_id: 'SAME', __hold: 220 });
-  pool.submit('mail', { mail_id: 'm2', session_id: 'SAME', __hold: 60 });
+test("同一会话串行：两个 worker 的心跳不得重叠", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 3 });
+	pool.submit("mail", { mail_id: "m1", session_id: "SAME", __hold: 220 });
+	pool.submit("mail", { mail_id: "m2", session_id: "SAME", __hold: 60 });
 
-  // 判据一：任一时刻只有一个 worker 在跑。
-  let everTwo = false;
-  const t = setInterval(() => { if (pool.stats().running > 1) everTwo = true; }, 10);
-  await until(() => jobs(lines).length === 2 && pool.stats().running === 0, 5000);
-  clearInterval(t);
-  pool.stop();
+	// 判据一：任一时刻只有一个 worker 在跑。
+	let everTwo = false;
+	const t = setInterval(() => {
+		if (pool.stats().running > 1) everTwo = true;
+	}, 10);
+	await until(
+		() => jobs(lines).length === 2 && pool.stats().running === 0,
+		5000,
+	);
+	clearInterval(t);
+	pool.stop();
 
-  assert.equal(everTwo, false, '同一条会话不得有两个 worker 同时装载会话文件');
-  // 判据二：m2 一次心跳都没能在 m1 结束前发出 —— m1 的心跳数应当远多于 m2。
-  assert.ok(ticks(lines, 'm1') >= 3, `m1 该跑满 220ms，实际心跳 ${ticks(lines, 'm1')} 次`);
-  assert.equal(jobs(lines).length, 2, '两封都要被处理，不能因为串行而丢掉一封');
+	assert.equal(everTwo, false, "同一条会话不得有两个 worker 同时装载会话文件");
+	// 判据二：m2 一次心跳都没能在 m1 结束前发出 —— m1 的心跳数应当远多于 m2。
+	assert.ok(
+		ticks(lines, "m1") >= 3,
+		`m1 该跑满 220ms，实际心跳 ${ticks(lines, "m1")} 次`,
+	);
+	assert.equal(jobs(lines).length, 2, "两封都要被处理，不能因为串行而丢掉一封");
 });
 
-test('不同会话真并发：两个进程的心跳在同一段时间里交错', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 3 });
-  pool.submit('mail', { mail_id: 'p', session_id: 'S-P', __hold: 300 });
-  pool.submit('mail', { mail_id: 'q', session_id: 'S-Q', __hold: 300 });
+test("不同会话真并发：两个进程的心跳在同一段时间里交错", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 3 });
+	pool.submit("mail", { mail_id: "p", session_id: "S-P", __hold: 300 });
+	pool.submit("mail", { mail_id: "q", session_id: "S-Q", __hold: 300 });
 
-  const interleaved = await until(() => ticks(lines, 'p') >= 2 && ticks(lines, 'q') >= 2, 2500);
-  pool.stop();
-  assert.ok(interleaved,
-    `两条不同会话应当并发，实际 p=${ticks(lines, 'p')} q=${ticks(lines, 'q')} 次心跳`);
+	const interleaved = await until(
+		() => ticks(lines, "p") >= 2 && ticks(lines, "q") >= 2,
+		2500,
+	);
+	pool.stop();
+	assert.ok(
+		interleaved,
+		`两条不同会话应当并发，实际 p=${ticks(lines, "p")} q=${ticks(lines, "q")} 次心跳`,
+	);
 });
 
-test('sessionFile 与 cwd 跨 worker 传下去：第二封接着第一封的会话谈', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', { mail_id: 'first', session_id: 'KEEP', __hold: 30 });
-  await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
+test("sessionFile 与 cwd 跨 worker 传下去：第二封接着第一封的会话谈", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", { mail_id: "first", session_id: "KEEP", __hold: 30 });
+	await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
 
-  pool.submit('mail', { mail_id: 'second', session_id: 'KEEP', __hold: 30 });
-  await until(() => jobs(lines).length === 2 && pool.stats().running === 0);
-  pool.stop();
+	pool.submit("mail", { mail_id: "second", session_id: "KEEP", __hold: 30 });
+	await until(() => jobs(lines).length === 2 && pool.stats().running === 0);
+	pool.stop();
 
-  const [j1, j2] = jobs(lines);
-  assert.equal(j1.sessionFile, '', '第一封时还没有会话文件');
-  assert.equal(j2.sessionFile, '/tmp/f-first.jsonl',
-    '第二封必须带上第一封开出来的会话文件，否则每封邮件都从零开始、上下文全丢');
-  assert.equal(j2.cwd, '/tmp', 'cwd 也要传下去');
+	const [j1, j2] = jobs(lines);
+	assert.equal(j1.sessionFile, "", "第一封时还没有会话文件");
+	assert.equal(
+		j2.sessionFile,
+		"/tmp/f-first.jsonl",
+		"第二封必须带上第一封开出来的会话文件，否则每封邮件都从零开始、上下文全丢",
+	);
+	assert.equal(j2.cwd, "/tmp", "cwd 也要传下去");
 });
 
-test('「一直同意」与命名指纹跨 worker 存活', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', {
-    mail_id: 'g1', session_id: 'GRANT', __hold: 30,
-    __grant: 'bash', __name: 'platform:某名字|某名字',
-  });
-  await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
+test("「一直同意」与命名指纹跨 worker 存活", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", {
+		mail_id: "g1",
+		session_id: "GRANT",
+		__hold: 30,
+		__grant: "bash",
+		__name: "platform:某名字|某名字",
+	});
+	await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
 
-  pool.submit('mail', { mail_id: 'g2', session_id: 'GRANT', __hold: 30 });
-  await until(() => jobs(lines).length === 2 && pool.stats().running === 0);
-  pool.stop();
+	pool.submit("mail", { mail_id: "g2", session_id: "GRANT", __hold: 30 });
+	await until(() => jobs(lines).length === 2 && pool.stats().running === 0);
+	pool.stop();
 
-  const [j1, j2] = jobs(lines);
-  assert.deepEqual(j1.grants, [], '第一封时还没人点过「一直同意」');
-  assert.deepEqual(j2.grants, ['bash'],
-    '「一直同意」不跨 worker 存活的话，下一封邮件又问一遍 —— 那个选项就是在骗人');
-  assert.equal(j2.lastSyncedName, 'platform:某名字|某名字',
-    '命名指纹要传下去，否则每封邮件都重新 sync 一次');
+	const [j1, j2] = jobs(lines);
+	assert.deepEqual(j1.grants, [], "第一封时还没人点过「一直同意」");
+	assert.deepEqual(
+		j2.grants,
+		["bash"],
+		"「一直同意」不跨 worker 存活的话，下一封邮件又问一遍 —— 那个选项就是在骗人",
+	);
+	assert.equal(
+		j2.lastSyncedName,
+		"platform:某名字|某名字",
+		"命名指纹要传下去，否则每封邮件都重新 sync 一次",
+	);
 });
 
-test('config() 每次派活时重取：allowedModels 随心跳变，不能用快照', async () => {
-  let turnTimeoutMs = 111;
-  const { pool, lines } = makePool({ maxWorkers: 1, config: {} });
-  // makePool 的 config 是固定值，这里换成动态的
-  pool.stop();
+test("config() 每次派活时重取：allowedModels 随心跳变，不能用快照", async () => {
+	let turnTimeoutMs = 111;
+	const { pool, lines } = makePool({ maxWorkers: 1, config: {} });
+	// makePool 的 config 是固定值，这里换成动态的
+	pool.stop();
 
-  const lines2 = [];
-  const p2 = createWorkerPool({
-    log: (...a) => lines2.push(a.join(' ')),
-    config: () => ({ turnTimeoutMs }),
-    onReconfigure: () => {},
-    maxWorkers: 1,
-    workerMaxMs: 5000,
-    workerPath: STUB,
-  });
-  p2.submit('mail', { mail_id: 'c1', session_id: 'C1', __hold: 20 });
-  await until(() => jobs(lines2).length === 1 && p2.stats().running === 0);
-  turnTimeoutMs = 222;
-  p2.submit('mail', { mail_id: 'c2', session_id: 'C2', __hold: 20 });
-  await until(() => jobs(lines2).length === 2 && p2.stats().running === 0);
-  p2.stop();
+	const lines2 = [];
+	const p2 = createWorkerPool({
+		log: (...a) => lines2.push(a.join(" ")),
+		config: () => ({ turnTimeoutMs }),
+		onReconfigure: () => {},
+		maxWorkers: 1,
+		workerMaxMs: 5000,
+		workerPath: STUB,
+	});
+	p2.submit("mail", { mail_id: "c1", session_id: "C1", __hold: 20 });
+	await until(() => jobs(lines2).length === 1 && p2.stats().running === 0);
+	turnTimeoutMs = 222;
+	p2.submit("mail", { mail_id: "c2", session_id: "C2", __hold: 20 });
+	await until(() => jobs(lines2).length === 2 && p2.stats().running === 0);
+	p2.stop();
 
-  const [j1, j2] = jobs(lines2);
-  assert.equal(j1.turnTimeoutMs, 111);
-  assert.equal(j2.turnTimeoutMs, 222, 'config() 必须每次重取，否则 worker 用的是上一轮的模型范围');
-  assert.equal(lines.length >= 0, true);
+	const [j1, j2] = jobs(lines2);
+	assert.equal(j1.turnTimeoutMs, 111);
+	assert.equal(
+		j2.turnTimeoutMs,
+		222,
+		"config() 必须每次重取，否则 worker 用的是上一轮的模型范围",
+	);
+	assert.equal(lines.length >= 0, true);
 });
 
-test('硬超时回收卡死的 worker，且不堵住同会话后续邮件', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2, workerMaxMs: 400 });
-  pool.submit('mail', { mail_id: 'stuck', session_id: 'STUCK', __hold: -1 });
-  await until(() => pool.stats().running === 1, 1500);
+test("硬超时回收卡死的 worker，且不堵住同会话后续邮件", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2, workerMaxMs: 400 });
+	pool.submit("mail", { mail_id: "stuck", session_id: "STUCK", __hold: -1 });
+	await until(() => pool.stats().running === 1, 1500);
 
-  const freed = await until(() => pool.stats().running === 0, 3000);
-  assert.ok(freed, '卡死的 worker 必须被硬超时回收，否则那条会话的后续邮件永远排队');
-  assert.ok(lines.some((l) => l.includes('强杀')), `应记下强杀日志，实际:\n${lines.join('\n')}`);
+	const freed = await until(() => pool.stats().running === 0, 3000);
+	assert.ok(
+		freed,
+		"卡死的 worker 必须被硬超时回收，否则那条会话的后续邮件永远排队",
+	);
+	assert.ok(
+		lines.some((l) => l.includes("强杀")),
+		`应记下强杀日志，实际:\n${lines.join("\n")}`,
+	);
 
-  pool.submit('mail', { mail_id: 'after', session_id: 'STUCK', __hold: 30 });
-  const ran = await until(() => jobs(lines).some((j) => j.mailID === 'after'), 2000);
-  await until(() => pool.stats().running === 0);
-  pool.stop();
-  assert.ok(ran, '硬超时后同一会话的后续邮件必须能被处理');
+	pool.submit("mail", { mail_id: "after", session_id: "STUCK", __hold: 30 });
+	const ran = await until(
+		() => jobs(lines).some((j) => j.mailID === "after"),
+		2000,
+	);
+	await until(() => pool.stats().running === 0);
+	pool.stop();
+	assert.ok(ran, "硬超时后同一会话的后续邮件必须能被处理");
 });
 
-test('权限决策路由到发起询问的那个 worker', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', { mail_id: 'perm', session_id: 'PERM', __pending: 'rk-1' });
-  await until(() => pool.stats().running === 1, 1500);
-  await sleep(150);                              // 等 permission_pending 到主进程
+test("权限决策路由到发起询问的那个 worker", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", {
+		mail_id: "perm",
+		session_id: "PERM",
+		__pending: "rk-1",
+	});
+	await until(() => pool.stats().running === 1, 1500);
+	await sleep(150); // 等 permission_pending 到主进程
 
-  assert.equal(pool.routePermission('rk-1', '同意'), true, '应当路由成功');
-  await until(() => pool.stats().running === 0, 2000);
-  pool.stop();
+	assert.equal(pool.routePermission("rk-1", "同意"), true, "应当路由成功");
+	await until(() => pool.stats().running === 0, 2000);
+	pool.stop();
 
-  assert.ok(lines.some((l) => l.includes('DECISION rk-1=同意')),
-    `worker 应收到决策原文，实际:\n${lines.join('\n')}`);
+	assert.ok(
+		lines.some((l) => l.includes("DECISION rk-1=同意")),
+		`worker 应收到决策原文，实际:\n${lines.join("\n")}`,
+	);
 });
 
-test('决策发的是选项原文而不是归一化的 allow/deny', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', { mail_id: 'p2', session_id: 'P2', __pending: 'rk-2' });
-  await until(() => pool.stats().running === 1, 1500);
-  await sleep(150);
-  pool.routePermission('rk-2', '一直同意');
-  await until(() => pool.stats().running === 0, 2000);
-  pool.stop();
+test("决策发的是选项原文而不是归一化的 allow/deny", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", { mail_id: "p2", session_id: "P2", __pending: "rk-2" });
+	await until(() => pool.stats().running === 1, 1500);
+	await sleep(150);
+	pool.routePermission("rk-2", "一直同意");
+	await until(() => pool.stats().running === 0, 2000);
+	pool.stop();
 
-  // 「同意」与「一直同意」语义不同，归一化会让后者退化成单次授权
-  assert.ok(lines.some((l) => l.includes('DECISION rk-2=一直同意')),
-    `必须原文透传，实际:\n${lines.join('\n')}`);
+	// 「同意」与「一直同意」语义不同，归一化会让后者退化成单次授权
+	assert.ok(
+		lines.some((l) => l.includes("DECISION rk-2=一直同意")),
+		`必须原文透传，实际:\n${lines.join("\n")}`,
+	);
 });
 
-test('决策找不到 worker 时返回 false（调用方据此走 B-4.2 降级）', async () => {
-  const { pool } = makePool();
-  assert.equal(pool.routePermission('never-seen', '同意'), false);
-  pool.stop();
+test("决策找不到 worker 时返回 false（调用方据此走 B-4.2 降级）", async () => {
+	const { pool } = makePool();
+	assert.equal(pool.routePermission("never-seen", "同意"), false);
+	pool.stop();
 });
 
-test('worker 退出后它的权限路由被清掉，不会误投给下一个 worker', async () => {
-  const { pool } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', { mail_id: 'gone', session_id: 'GONE', __pending: 'rk-gone' });
-  await until(() => pool.stats().running === 1, 1500);
-  await sleep(150);
-  // 不给决策，直接停掉它
-  pool.stop();
-  await until(() => pool.stats().running === 0, 4000);
+test("worker 退出后它的权限路由被清掉，不会误投给下一个 worker", async () => {
+	const { pool } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", {
+		mail_id: "gone",
+		session_id: "GONE",
+		__pending: "rk-gone",
+	});
+	await until(() => pool.stats().running === 1, 1500);
+	await sleep(150);
+	// 不给决策，直接停掉它
+	pool.stop();
+	await until(() => pool.stats().running === 0, 4000);
 
-  assert.equal(pool.routePermission('rk-gone', '同意'), false,
-    'worker 已退出，路由必须返回 false 让调用方走降级路径');
+	assert.equal(
+		pool.routePermission("rk-gone", "同意"),
+		false,
+		"worker 已退出，路由必须返回 false 让调用方走降级路径",
+	);
 });
 
-test('mailDrivenIDs 报出所有跑过的 pi 会话，且不随 worker 退出而清', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', { mail_id: 'd1', session_id: 'D1', __hold: 30 });
-  pool.submit('mail', { mail_id: 'd2', session_id: 'D2', __hold: 30 });
-  await until(() => jobs(lines).length === 2 && pool.stats().running === 0);
-  pool.stop();
+test("mailDrivenIDs 报出所有跑过的 pi 会话，且不随 worker 退出而清", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", { mail_id: "d1", session_id: "D1", __hold: 30 });
+	pool.submit("mail", { mail_id: "d2", session_id: "D2", __hold: 30 });
+	await until(() => jobs(lines).length === 2 && pool.stats().running === 0);
+	pool.stop();
 
-  const ids = pool.mailDrivenIDs();
-  assert.ok(ids.has('pi-d1'), 'D1 的 pi 会话该被标记为邮件驱动');
-  assert.ok(ids.has('pi-d2'), 'D2 的 pi 会话该被标记为邮件驱动');
+	const ids = pool.mailDrivenIDs();
+	assert.ok(ids.has("pi-d1"), "D1 的 pi 会话该被标记为邮件驱动");
+	assert.ok(ids.has("pi-d2"), "D2 的 pi 会话该被标记为邮件驱动");
 });
 
-test('模型降级换掉的旧 pi 会话仍算邮件驱动', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', { mail_id: 'r', session_id: 'RETIRE', __hold: 40, __reopen: 'pi-new' });
-  await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
-  pool.stop();
+test("模型降级换掉的旧 pi 会话仍算邮件驱动", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", {
+		mail_id: "r",
+		session_id: "RETIRE",
+		__hold: 40,
+		__reopen: "pi-new",
+	});
+	await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
+	pool.stop();
 
-  const ids = pool.mailDrivenIDs();
-  assert.ok(ids.has('pi-new'), '新会话要在');
-  assert.ok(ids.has('pi-r'), '被换掉的旧会话也参与过邮件往来，磁盘上的文件还在，快照该报它');
+	const ids = pool.mailDrivenIDs();
+	assert.ok(ids.has("pi-new"), "新会话要在");
+	assert.ok(
+		ids.has("pi-r"),
+		"被换掉的旧会话也参与过邮件往来，磁盘上的文件还在，快照该报它",
+	);
 });
 
-test('hasSession 只对跑过的邮件会话为真', async () => {
-  const { pool } = makePool();
-  assert.equal(pool.hasSession('NOPE'), false);
-  pool.submit('mail', { mail_id: 'h1', session_id: 'HAS', __hold: 30 });
-  await until(() => pool.hasSession('HAS'), 2000);
-  await until(() => pool.stats().running === 0);
-  pool.stop();
-  assert.equal(pool.hasSession('HAS'), true, 'worker 退出后仍该记着这条会话');
+test("hasSession 只对跑过的邮件会话为真", async () => {
+	const { pool } = makePool();
+	assert.equal(pool.hasSession("NOPE"), false);
+	pool.submit("mail", { mail_id: "h1", session_id: "HAS", __hold: 30 });
+	await until(() => pool.hasSession("HAS"), 2000);
+	await until(() => pool.stats().running === 0);
+	pool.stop();
+	assert.equal(pool.hasSession("HAS"), true, "worker 退出后仍该记着这条会话");
 });
 
-test('kind 透传：权限通知走 permission 而不是 mail', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('permission', { mail_id: 'k1', session_id: 'K1', __hold: 20 });
-  await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
-  pool.stop();
-  assert.equal(jobs(lines)[0].kind, 'permission',
-    'kind 决定 worker 用哪套提示词，传错会让模型以为收到一封新邮件');
+test("kind 透传：权限通知走 permission 而不是 mail", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("permission", { mail_id: "k1", session_id: "K1", __hold: 20 });
+	await until(() => jobs(lines).length === 1 && pool.stats().running === 0);
+	pool.stop();
+	assert.equal(
+		jobs(lines)[0].kind,
+		"permission",
+		"kind 决定 worker 用哪套提示词，传错会让模型以为收到一封新邮件",
+	);
 });
 
-test('stop 之后不再派活', async () => {
-  const { pool } = makePool();
-  pool.stop();
-  pool.submit('mail', { mail_id: 'late', session_id: 'LATE', __hold: 30 });
-  await sleep(200);
-  assert.equal(pool.stats().running, 0, '关停后不该再起 worker');
-  assert.equal(pool.stats().queued, 0, '关停后队列应为空');
+test("stop 之后不再派活", async () => {
+	const { pool } = makePool();
+	pool.stop();
+	pool.submit("mail", { mail_id: "late", session_id: "LATE", __hold: 30 });
+	await sleep(200);
+	assert.equal(pool.stats().running, 0, "关停后不该再起 worker");
+	assert.equal(pool.stats().queued, 0, "关停后队列应为空");
 });
 
-test('stop 会先给 worker 发 shutdown（让它 fail closed）再杀', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 2 });
-  pool.submit('mail', { mail_id: 's1', session_id: 'S1', __hold: -1 });
-  await until(() => pool.stats().running === 1, 1500);
-  pool.stop();
-  const gotShutdown = await until(() => lines.some((l) => l.includes('SHUTDOWN')), 2000);
-  assert.ok(gotShutdown,
-    '必须先发 shutdown：直接 SIGKILL 会让 pi 侧那些等权限的 await 永不返回');
+test("stop 会先给 worker 发 shutdown（让它 fail closed）再杀", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 2 });
+	pool.submit("mail", { mail_id: "s1", session_id: "S1", __hold: -1 });
+	await until(() => pool.stats().running === 1, 1500);
+	pool.stop();
+	const gotShutdown = await until(
+		() => lines.some((l) => l.includes("SHUTDOWN")),
+		2000,
+	);
+	assert.ok(
+		gotShutdown,
+		"必须先发 shutdown：直接 SIGKILL 会让 pi 侧那些等权限的 await 永不返回",
+	);
 });
 
-test('没有 session_id 的事件各占一个 key，不会互相串行', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 3 });
-  pool.submit('mail', { mail_id: 'n1', __hold: 300 });
-  pool.submit('mail', { mail_id: 'n2', __hold: 300 });
-  const both = await until(() => ticks(lines, 'n1') >= 2 && ticks(lines, 'n2') >= 2, 2500);
-  pool.stop();
-  assert.ok(both, '无 session_id 的两封不属于同一条会话，应能并发');
+test("没有 session_id 的事件各占一个 key，不会互相串行", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 3 });
+	pool.submit("mail", { mail_id: "n1", __hold: 300 });
+	pool.submit("mail", { mail_id: "n2", __hold: 300 });
+	const both = await until(
+		() => ticks(lines, "n1") >= 2 && ticks(lines, "n2") >= 2,
+		2500,
+	);
+	pool.stop();
+	assert.ok(both, "无 session_id 的两封不属于同一条会话，应能并发");
 });
 
-test('reconfigure 上报被转达给主进程', async () => {
-  const STUB2 = join(STUB_DIR, 'stub-reconf.mjs');
-  writeFileSync(STUB2, `
+test("reconfigure 上报被转达给主进程", async () => {
+	const STUB2 = join(STUB_DIR, "stub-reconf.mjs");
+	writeFileSync(
+		STUB2,
+		`
 process.on('message', (msg) => {
   if (msg?.type === 'job') {
     process.send({ type: 'reconfigure', url: 'http://new:9999', agentKey: 'k2' });
@@ -379,42 +463,57 @@ process.on('message', (msg) => {
   }
 });
 process.send({ type: 'ready' });
-`);
-  let got = null;
-  const { pool } = makePool({
-    maxWorkers: 1,
-    workerPath: STUB2,
-    onReconfigure: (url, key) => { got = { url, key }; },
-  });
-  pool.submit('mail', { mail_id: 'r1', session_id: 'R1' });
-  await until(() => got !== null, 3000);
-  pool.stop();
-  assert.deepEqual(got, { url: 'http://new:9999', key: 'k2' },
-    'worker 里 connect_to_server 换的坐标必须回到主进程 —— worker 马上就退了，改在它自己身上等于没改');
+`,
+	);
+	let got = null;
+	const { pool } = makePool({
+		maxWorkers: 1,
+		workerPath: STUB2,
+		onReconfigure: (url, key) => {
+			got = { url, key };
+		},
+	});
+	pool.submit("mail", { mail_id: "r1", session_id: "R1" });
+	await until(() => got !== null, 3000);
+	pool.stop();
+	assert.deepEqual(
+		got,
+		{ url: "http://new:9999", key: "k2" },
+		"worker 里 connect_to_server 换的坐标必须回到主进程 —— worker 马上就退了，改在它自己身上等于没改",
+	);
 });
 
-test('worker 未回报 done 就退出：有界重投而不是静默丢信', async () => {
-  // maxAttempts=2：首次 + 一次重投，然后放弃。
-  // 这封邮件必定崩溃，重投就是在验证「有界」——不然它会变成永久活锁。
-  const { pool, lines } = makePool({ maxWorkers: 1, maxAttempts: 2 });
-  pool.submit('mail', { mail_id: 'crashy', session_id: 'CRASH', __crash: true });
+test("worker 未回报 done 就退出：有界重投而不是静默丢信", async () => {
+	// maxAttempts=2：首次 + 一次重投，然后放弃。
+	// 这封邮件必定崩溃，重投就是在验证「有界」——不然它会变成永久活锁。
+	const { pool, lines } = makePool({ maxWorkers: 1, maxAttempts: 2 });
+	pool.submit("mail", {
+		mail_id: "crashy",
+		session_id: "CRASH",
+		__crash: true,
+	});
 
-  const gaveUp = await until(() => lines.some((l) => l.includes('放弃')), 6000);
-  pool.stop();
+	const gaveUp = await until(() => lines.some((l) => l.includes("放弃")), 6000);
+	pool.stop();
 
-  assert.ok(gaveUp, `重投到上限后应记下「放弃」，实际:\n${lines.join('\n')}`);
-  assert.equal(jobs(lines).length, 2,
-    `应当尝试 2 次（首次 + 1 次重投），实际 ${jobs(lines).length} 次`);
-  assert.ok(lines.some((l) => l.includes('未回报 done 就退出')),
-    '必须明说是「未回报 done 就退出」——否则看到 exit code 会误以为是普通崩溃');
+	assert.ok(gaveUp, `重投到上限后应记下「放弃」，实际:\n${lines.join("\n")}`);
+	assert.equal(
+		jobs(lines).length,
+		2,
+		`应当尝试 2 次（首次 + 1 次重投），实际 ${jobs(lines).length} 次`,
+	);
+	assert.ok(
+		lines.some((l) => l.includes("未回报 done 就退出")),
+		"必须明说是「未回报 done 就退出」——否则看到 exit code 会误以为是普通崩溃",
+	);
 });
 
-test('重投上限之下不会无限重投（maxAttempts=1 就是不重投）', async () => {
-  const { pool, lines } = makePool({ maxWorkers: 1, maxAttempts: 1 });
-  pool.submit('mail', { mail_id: 'once', session_id: 'ONCE', __crash: true });
-  await until(() => lines.some((l) => l.includes('放弃')), 4000);
-  await sleep(300);   // 再等一会儿，确认没有额外重投
-  pool.stop();
+test("重投上限之下不会无限重投（maxAttempts=1 就是不重投）", async () => {
+	const { pool, lines } = makePool({ maxWorkers: 1, maxAttempts: 1 });
+	pool.submit("mail", { mail_id: "once", session_id: "ONCE", __crash: true });
+	await until(() => lines.some((l) => l.includes("放弃")), 4000);
+	await sleep(300); // 再等一会儿，确认没有额外重投
+	pool.stop();
 
-  assert.equal(jobs(lines).length, 1, 'maxAttempts=1 时只跑一次');
+	assert.equal(jobs(lines).length, 1, "maxAttempts=1 时只跑一次");
 });
diff --git a/plugins/pi-mail-bridge/test/sse-client.test.mjs b/plugins/pi-mail-bridge/test/sse-client.test.mjs
index 0ee5781..05095a0 100644
--- a/plugins/pi-mail-bridge/test/sse-client.test.mjs
+++ b/plugins/pi-mail-bridge/test/sse-client.test.mjs
@@ -9,121 +9,132 @@
  * 生产上表现为「新邮件偶尔收不到」「权限决策点了没反应」，且日志里一个字都没有。
  */
 
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
+import { test } from "node:test";
+import assert from "node:assert/strict";
 
-import { createFrameParser } from '../lib/sse-client.js';
+import { createFrameParser } from "../lib/sse-client.js";
 
 /** JSON.parse 的测试包装：解析失败让断言带原文失败，而不是抛未捕获异常。 */
 function parse(s) {
-  try {
-    return JSON.parse(s);
-  } catch (e) {
-    assert.fail(`不是合法 JSON: ${s}（${e.message}）`);
-  }
+	try {
+		return JSON.parse(s);
+	} catch (e) {
+		assert.fail(`不是合法 JSON: ${s}（${e.message}）`);
+	}
 }
 
-test('完整帧一次喂入：正常解析', () => {
-  const p = createFrameParser();
-  const events = p.push('id: 7\nevent: new_mail\ndata: {"mail_id":"m1"}\n\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
-  assert.deepEqual(parse(events[0].data), { mail_id: 'm1' });
-  assert.equal(events[0].id, '7');
-  assert.equal(p.lastEventId(), '7');
+test("完整帧一次喂入：正常解析", () => {
+	const p = createFrameParser();
+	const events = p.push('id: 7\nevent: new_mail\ndata: {"mail_id":"m1"}\n\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
+	assert.deepEqual(parse(events[0].data), { mail_id: "m1" });
+	assert.equal(events[0].id, "7");
+	assert.equal(p.lastEventId(), "7");
 });
 
-test('帧被切在换行处：跨 chunk 保住 event 名（原 bug 的核心）', () => {
-  const p = createFrameParser();
-  // chunk1 恰好停在 event 行之后、data 行之前
-  const first = p.push('id: 12\nevent: content_delta\n');
-  assert.deepEqual(first, [], '半帧不该派发');
+test("帧被切在换行处：跨 chunk 保住 event 名（原 bug 的核心）", () => {
+	const p = createFrameParser();
+	// chunk1 恰好停在 event 行之后、data 行之前
+	const first = p.push("id: 12\nevent: content_delta\n");
+	assert.deepEqual(first, [], "半帧不该派发");
 
-  const second = p.push('data: {"x":1}\n\n');
-  assert.equal(second.length, 1, '跨 chunk 的半帧必须被拼回完整事件，而不是丢弃');
-  assert.equal(second[0].event, 'content_delta');
-  assert.equal(p.lastEventId(), '12');
+	const second = p.push('data: {"x":1}\n\n');
+	assert.equal(
+		second.length,
+		1,
+		"跨 chunk 的半帧必须被拼回完整事件，而不是丢弃",
+	);
+	assert.equal(second[0].event, "content_delta");
+	assert.equal(p.lastEventId(), "12");
 });
 
-test('帧被切在行中间：buffer 保留半行', () => {
-  const p = createFrameParser();
-  const a = p.push('event: new_ma');
-  assert.deepEqual(a, []);
-  const b = p.push('il\ndata: {"mail_id":"m9"}\n\n');
-  assert.equal(b.length, 1);
-  assert.equal(b[0].event, 'new_mail');
+test("帧被切在行中间：buffer 保留半行", () => {
+	const p = createFrameParser();
+	const a = p.push("event: new_ma");
+	assert.deepEqual(a, []);
+	const b = p.push('il\ndata: {"mail_id":"m9"}\n\n');
+	assert.equal(b.length, 1);
+	assert.equal(b[0].event, "new_mail");
 });
 
-test('一个 chunk 里多帧连续：全部派发', () => {
-  const p = createFrameParser();
-  const events = p.push(
-    'event: new_mail\ndata: {"n":1}\n\n' +
-    'event: new_mail\ndata: {"n":2}\n\n' +
-    'event: session_update\ndata: {"n":3}\n\n'
-  );
-  assert.equal(events.length, 3);
-  assert.deepEqual(events.map((e) => e.event), ['new_mail', 'new_mail', 'session_update']);
+test("一个 chunk 里多帧连续：全部派发", () => {
+	const p = createFrameParser();
+	const events = p.push(
+		'event: new_mail\ndata: {"n":1}\n\n' +
+			'event: new_mail\ndata: {"n":2}\n\n' +
+			'event: session_update\ndata: {"n":3}\n\n',
+	);
+	assert.equal(events.length, 3);
+	assert.deepEqual(
+		events.map((e) => e.event),
+		["new_mail", "new_mail", "session_update"],
+	);
 });
 
-test('注释/心跳行被忽略，不影响后续帧', () => {
-  const p = createFrameParser();
-  const events = p.push(': heartbeat\n\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
+test("注释/心跳行被忽略，不影响后续帧", () => {
+	const p = createFrameParser();
+	const events = p.push(': heartbeat\n\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
 });
 
-test('多行 data 用换行拼接', () => {
-  const p = createFrameParser();
-  const events = p.push('event: x\ndata: line1\ndata: line2\n\n');
-  assert.equal(events[0].data, 'line1\nline2');
+test("多行 data 用换行拼接", () => {
+	const p = createFrameParser();
+	const events = p.push("event: x\ndata: line1\ndata: line2\n\n");
+	assert.equal(events[0].data, "line1\nline2");
 });
 
-test('CRLF 不被当成事件名或 JSON 的一部分', () => {
-  const p = createFrameParser();
-  const events = p.push('id: 3\r\nevent: new_mail\r\ndata: {"n":1}\r\n\r\n');
-  assert.equal(events.length, 1);
-  assert.equal(events[0].event, 'new_mail');
-  assert.equal(events[0].id, '3');
-  assert.deepEqual(parse(events[0].data), { n: 1 });
+test("CRLF 不被当成事件名或 JSON 的一部分", () => {
+	const p = createFrameParser();
+	const events = p.push('id: 3\r\nevent: new_mail\r\ndata: {"n":1}\r\n\r\n');
+	assert.equal(events.length, 1);
+	assert.equal(events[0].event, "new_mail");
+	assert.equal(events[0].id, "3");
+	assert.deepEqual(parse(events[0].data), { n: 1 });
 });
 
-test('事件 id 只向前推进：重放旧 id 不回退断点', () => {
-  const p = createFrameParser();
-  p.push('id: 10\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '10');
-  // 服务端重放一条更早的事件：断点不该退回 5，否则下次重连会重复回放 6..10
-  p.push('id: 5\nevent: new_mail\ndata: {"n":0}\n\n');
-  assert.equal(p.lastEventId(), '5', '解析器如实记录当前 id（是否回退由使用方决定）');
+test("事件 id 只向前推进：重放旧 id 不回退断点", () => {
+	const p = createFrameParser();
+	p.push('id: 10\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "10");
+	// 服务端重放一条更早的事件：断点不该退回 5，否则下次重连会重复回放 6..10
+	p.push('id: 5\nevent: new_mail\ndata: {"n":0}\n\n');
+	assert.equal(
+		p.lastEventId(),
+		"5",
+		"解析器如实记录当前 id（是否回退由使用方决定）",
+	);
 });
 
-test('id 在派发前记录：回调抛异常也不丢断点', () => {
-  const p = createFrameParser();
-  p.push('id: 42\nevent: new_mail\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '42');
+test("id 在派发前记录：回调抛异常也不丢断点", () => {
+	const p = createFrameParser();
+	p.push('id: 42\nevent: new_mail\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "42");
 });
 
-test('只有 data 没有 event 不派发（避免把心跳数据当事件）', () => {
-  const p = createFrameParser();
-  const events = p.push('data: {"orphan":true}\n\n');
-  assert.deepEqual(events, []);
+test("只有 data 没有 event 不派发（避免把心跳数据当事件）", () => {
+	const p = createFrameParser();
+	const events = p.push('data: {"orphan":true}\n\n');
+	assert.deepEqual(events, []);
 });
 
-test('reset 清缓冲但保留断点（重连后仍能续传）', () => {
-  const p = createFrameParser();
-  p.push('id: 99\nevent: a\ndata: {"n":1}\n\n');
-  p.push('event: partial');   // 半帧
-  p.reset();
-  assert.equal(p.lastEventId(), '99', '断点必须保留，否则重连从头回放');
-  // reset 后半帧不该复活
-  const after = p.push('data: {"n":2}\n\n');
-  assert.deepEqual(after, []);
+test("reset 清缓冲但保留断点（重连后仍能续传）", () => {
+	const p = createFrameParser();
+	p.push('id: 99\nevent: a\ndata: {"n":1}\n\n');
+	p.push("event: partial"); // 半帧
+	p.reset();
+	assert.equal(p.lastEventId(), "99", "断点必须保留，否则重连从头回放");
+	// reset 后半帧不该复活
+	const after = p.push('data: {"n":2}\n\n');
+	assert.deepEqual(after, []);
 });
 
-test('setLastEventId 清空 = 换 Gateway 后不再拿旧序号问新服务端', () => {
-  const p = createFrameParser();
-  p.push('id: 123\nevent: a\ndata: {"n":1}\n\n');
-  assert.equal(p.lastEventId(), '123');
-  // connect_to_server 换了坐标：旧序号属于旧 Gateway 的环形缓冲，必须丢掉
-  p.setLastEventId('');
-  assert.equal(p.lastEventId(), '', '首次连接不得携带 Last-Event-ID');
+test("setLastEventId 清空 = 换 Gateway 后不再拿旧序号问新服务端", () => {
+	const p = createFrameParser();
+	p.push('id: 123\nevent: a\ndata: {"n":1}\n\n');
+	assert.equal(p.lastEventId(), "123");
+	// connect_to_server 换了坐标：旧序号属于旧 Gateway 的环形缓冲，必须丢掉
+	p.setLastEventId("");
+	assert.equal(p.lastEventId(), "", "首次连接不得携带 Last-Event-ID");
 });
diff --git a/server/internal/handler/permission.go b/server/internal/handler/permission.go
index 35a59c2..b05c661 100644
--- a/server/internal/handler/permission.go
+++ b/server/internal/handler/permission.go
@@ -404,4 +404,3 @@ func contains(list []string, v string) bool {
 	}
 	return false
 }
-