Agent→Agent 不自动转发 + 提示词区分新活/回复/补投

## 设计规则：Agent 之间不自动转发

自动转发存在的理由是「人不该等模型记得调 send_mail」—— 收件方是人时这是
纯收益。**收件方是另一个 Agent 时这个理由不成立，而且有害**：双方的插件都
会自动回一封，于是两个模型都以为「我只要把话说完就行」，实际在持续互相唤醒。
生产实测 pi 与 dsh 客套 6 轮直到撞上连续 relay 跳数上限。

规则现在写死在共用模块 `lib/relay-policy.js`（三平台逐字节相同）：
- `autoRelayDecision` — 插件该不该替模型开口
- `replyInstruction` — 提示词怎么跟模型说（人类 vs Agent 各一套措辞）
- `inboundHeadline` — 进来的是新活、回复、还是补投

`from_human` 缺失时保守按 Agent 处理：宁可让模型多调一次 send_mail，
也不能承诺一个不会发生的自动回信让发件方白等。

## Gateway 侧：`in_reply_to` + `from_human`

- `notify.Mail` 新增 `ParentMailID`（非空 = 这是对收件方某封信的回复）
- `notify.Mail` 新增 `FromHuman`（走 `repo.IsHumanUser`）
- SSE payload 里叫 `in_reply_to` / `from_human`
- 四个调用点全部传入：handler/mail（转发后产出的邮件，parentMailID 从
  resolveTarget 取）、handler/me（同理）、handler/forward（传空串，
  因为对收件方而言那封原邮件不在它的线索里）、scheduler/calendar（传空串）
- `ListInbox` 的 SELECT 加 `EXISTS (SELECT 1 FROM users u WHERE u.username = m.from_name)`
  → `models.Mail.FromHuman`，让补拉路径也有这个信号

## 提示词分流

三种处境各一套标题：
- 新活（人类）：「你收到一封新邮件」+ 「回信不用你自己发：…」
- 新活（Agent）：「你收到一封新邮件（对方是一个 Agent）」+ 「插件不会替你
  回信。需要回复时你必须自己调 send_mail…请先判断是否真的需要回复」
- 回复到了：「你上一封信的回复到了。**这不是新任务**。」
- 补投：在标题里说明「离线期间积压」

## homeagent 特殊处理

Go 插件不能直接 `import('../lib/relay-policy.js')`，因此新增 `relay_policy.go`
（Go 对应物）+ `relay_policy_test.go`（11 例，逐条对齐 Node 侧判据）。
`sseLoop` / `catchUp` 两条路径都接上。

## `mailEvent` 命名类型

homeagent 的 SSE 事件解析 / handleNewMail / handlePermissionDecision 三处
原来各写一遍匿名 struct（字段列表几乎相同），加 `from_human` / `in_reply_to`
时漏改一处 → 编译报错但错误信息是两串几乎相同的字段列表，极难定位。
提成 `mailEvent` 命名类型：一处改、三处跟着走。

## 测试

- `lib/relay-policy.test.mjs`（Node）16 例：含「replyInstruction 与
  autoRelayDecision 不得互相矛盾」「Agent 来信的标题要点名且回复要明确反对」
- `relay_policy_test.go`（Go）11 例：逐条对齐 Node 侧
- `turn.test.mjs` +3 例：from_human 缺失时按 Agent 处理 / Agent 来信时改口 /
  回复到了说「不是新任务」；删掉两条旧的「必定自动转发」断言
- 共用脚本 `check-shared-libs.sh` +1 个文件（relay-policy）
- pi 288 / dsh 241 / opencode 217 / homeagent 14 / gateway 8 包全绿

plugins/pi-mail-bridge/src/turn.mjs

@@ -8,6 +8,8 @@
  * 校验），这里的东西是 pi 专属的（消息形状、stopReason 语义），不参与那个约束。
  */
 
+import { replyInstruction, inboundHeadline } from '../lib/relay-policy.js';
+
 /** 去掉已有的 Re: 前缀，避免 Re: Re: Re: 叠加。 */
 export function stripRe(subject) {
   return String(subject ?? '').replace(/^(\s*Re:\s*)+/i, '');
@@ -127,33 +129,41 @@ export function buildMailPrompt({ agentName, data, kind, reused }) {
     ].join('\n');
   }
 
-  const head = reused
-    ? '本会话收到一封新邮件（AgentMail 续谈）。'
-    : '你收到一封新邮件（AgentMail）。';
+  // 发件方是人还是 Agent，以及这封是不是回信 —— 两个信号都来自服务端。
+  // 旧版一律说「你收到一封新邮件」+「回信不用你自己发」，于是 Agent 之间
+  // 两边都以为插件会代它开口，把对方的一句「已收到」当成待办再处理一遍。
+  //
+  // `from_human` 缺失时保守当作「不是人」：宁可让模型多调一次 send_mail，
+  // 也不能对它承诺一个不会发生的自动回信 —— 后者让发件方白等。
+  const fromHuman = data?.from_human === true;
   const lines = [
-    head,
+    inboundHeadline({
+      inReplyTo: data?.in_reply_to,
+      fromHuman,
+      catchup: data?.catchup,
+      reused,
+    }),
     '',
     `发件人：${data?.from_name || 'unknown'}`,
     `主题：${data?.subject || '(无主题)'}`,
     `邮件 ID：${data?.mail_id || 'unknown'}`,
   ];
+  if (data?.in_reply_to) {
+    lines.push(`回的是你那封：${data.in_reply_to}`);
+  }
   if (!reused) lines.push(`身份：你是 ${agentName}`);
   // 服务端算好的回信地址（`new_mail` 的 reply_address）。带上它是因为模型
   // **确实会**自己发信 —— 尤其是要抄送第三方、或分多封交代不同的事时。
   // 让它自己拼三维地址的话，`.new` 会被拼进去，于是回信静默开出一条新会话，
   // 原来的线索里再无下文。
   if (data?.reply_address) {
-    lines.push(`回信地址：${data.reply_address}（如需自己发信，用这个地址）`);
-  }
-  if (data?.catchup) {
-    // 补投的邮件要说明，否则模型会以为这是刚到的、按「立即响应」的语气回
-    lines.push('说明：这是插件离线期间积压的邮件，现在补投给你。');
+    lines.push(`回信地址：${data.reply_address}`);
   }
   lines.push(
     '',
     '请先调用 read_inbox 读取完整正文（附带附件清单，如有附件可用 download_attachment 取回），',
     '然后处理其中的请求。',
-    '回信不用你自己发：把这一轮做完、把结论说出来就行，插件会把你最后那段话作为回信发出去。',
+    ...replyInstruction({ fromHuman, replyAddress: data?.reply_address }),
   );
   return lines.join('\n');
 }

plugins/pi-mail-bridge/src/worker.mjs

@@ -51,6 +51,7 @@ import { planNamingSync, planWriteBack } from './naming.mjs';
 import { resolveWorkspaceCwd, ensureCwd } from '../lib/workspace.js';
 import { modelAttemptOrder, renderFailureReport } from '../lib/model-scope.js';
 import { explicitSends, shouldSkipAutoRelay } from '../lib/relay-dedup.js';
+import { autoRelayDecision } from '../lib/relay-policy.js';
 import { adoptedSessionID, adoptMissingMessage } from '../lib/adopt.js';
 import { isApproval, isAlwaysDecision } from '../lib/permission-grants.js';
 
@@ -324,10 +325,23 @@ async function relaySummary(session, sessionManager, adopted) {
       .catch((e) => log(`命名同步失败: ${describeError(e)}`));
   }
 
+  // **只给人类来信自动转发**（详见 lib/relay-policy.js）。
+  //
+  // 对方是 Agent 时它那边的插件也会自动回一封，于是两个模型都以为
+  // 「我只要把话说完就行」，实际在持续互相唤醒 —— 生产实测 pi 与 dsh
+  // 客套 6 轮直到撞上 hop 上限。这一步在取文本之前判：早退比白做一轮清楚。
+  const policy = autoRelayDecision({
+    fromHuman: job.data?.from_human === true,
+    replyTo: mailContext.replyTo,
+  });
+  if (!policy.relay) {
+    log(`本轮不自动转发：${policy.reason}`);
+    return;
+  }
+
   // 只取 type==='text' 的块（B-5.1 / N-6）：thinking 是思考过程，不是结论。
   const text = lastAssistantText(session.messages);
   if (!text) return;                                   // 空文本不发空邮件（B-5.4）
-  if (!mailContext.replyTo) return;                    // 不知道回给谁
 
   // 幂等键用 pi 会话 id + 会话树叶子 id：两者都落盘，重放也是同一个键。
   const relayKey = relayKeyFor(piSessionId, sessionManager.getLeafId?.());