feat: agent 邮件寻址能力全面补齐 + .new 别名替换

## 别名替换（让 .new 邮件可寻址）

repo/autoalias.go: AutoAliasFor + EnsureSessionAlias
- .new 建完会话立刻给别名（形如 dsh-重构导入路径）
- 名字与主题都要：只用主题跨 Agent 撞名，只用名字看不出聊什么
- sanitizeAliasPart 只留 unicode.IsLetter/IsDigit，其余折 -
- 撞名追加 -2/-3，全占用退 session-<uuid前8位>
- 不复用 SyncSessionAlias：那个假定已存在且跳过 manual
- 条件写入 WHERE alias IS NULL OR ''，并发安全
- resolveTarget 的 .new 与默认会话两条路径都调

notifyRecipients 加三个字段（每个收件方拿到自己那个地址的版本）：
- session_alias / reply_address / self_address
- 别名为空时退回省略 session 位，绝不写 new

FormatAddress(name,path,session) 空 path 也必须留 @ 与 .

## Agent 侧寻址发现（五个只读端点）

handler/agent_discovery.go:
- /agent/contacts + /agent/contacts/suggest（三段式补全）
- /agent/mail/{id} + /agent/mail/{id}/thread
- /agent/sessions/{id}/participants
- 不复用人类路由：scope 不同、审计需求不同
- 一律只读：归档/改名/权限决策仍只有人能做

repo/participants.go: SessionParticipants 逐封扫 from/to/cc
- Roles 用集合、MailCount 只数发信（0=还没开口的人）
- 发件人 path 不取 from_workspace（那列存的是 Agent 名）

repo.SuggestPaths 重写：mails.to_workspace（按 MAX(created_at) 倒序）
+ agents.workspaces 并集。原只读 workspaces，官方插件传 [] 永远空

## 共用模块（三插件逐字节相同）

lib/addressing.js: formatAddress/roleOf/replyAddressFor/selfAddressFor/participantsOfMail
lib/discovery.js: renderNameSuggestions/renderPathSuggestions/renderSessionSuggestions/
                  renderParticipants/renderContacts/renderThread

lib/inbox-format.js: renderMail 新增收件人/身份/可投递地址三段
  - selfName 参数（兼容旧调用不传的情况）

check-shared-libs.sh 纳入 addressing + discovery

## 插件侧

opencode: suggest_address + list_contacts + session_participants + read_thread + read_mail
dsh: 同上 + forward_mail（此前只有 opencode 有）+ upload_attachment 改真 multipart
pi: 同上（createMailTools 加 agentName 参数）

dsh: ctx.agents.create id collision 改为 readSession 探测后 resume
dsh: 关键路径日志改 console.error（ctx.logger 不进 journalctl）

## 测试

repo: autoalias_test.go 11 + participants_test.go 7 = 18 例
plugins: addressing.test 17 + discovery.test 23 + inbox-format.test 31 = 71 例
go test ./... + npm test（opencode 155 + dsh 173 + pi 199）全绿
端到端验证：admin 发 dsh@....new 抄送 opencode@....new
  → dsh 用 session_participants 取到地址 → send_mail 给 opencode
  → 地址取自工具返回值（.crisp-planet），未手工拼写

plugins/opencode-mail-bridge/test/session-snapshot.test.mjs

@@ -12,6 +12,8 @@ import assert from 'node:assert/strict';
 import {
   snapshotOpencodeSessions,
   snapshotDshSessions,
+  snapshotPiSessions,
+  isUnusableName,
   slugFromTitle,
   MAX_REPORTED,
 } from '../lib/session-snapshot.js';
@@ -226,3 +228,99 @@ test('不同标题不受去重影响', () => {
   ]);
   assert.equal(got.length, 2);
 });
+
+// ─── pi：名字来自会话文件的 session_info ───
+
+const piSession = (over = {}) => ({
+  id: '01a064cc-df57-7b2d-bebb-736776105485',
+  cwd: '/home/program/agentmail',
+  name: '重构导入路径',
+  messageCount: 6,
+  created: new Date(1788300000000),
+  modified: new Date(1788344476744),
+  ...over,
+});
+
+test('pi 快照取 cwd 与 session_info 名字', () => {
+  const [got] = snapshotPiSessions([piSession()]);
+  assert.equal(got.workspace, '/home/program/agentmail');
+  assert.equal(got.title, '重构导入路径');
+  assert.equal(got.slug, '重构导入路径');
+  assert.equal(got.platform_id, '01a064cc-df57-7b2d-bebb-736776105485');
+});
+
+test('不变量：pi 无名会话不上报', () => {
+  // pi 的列表在无名时显示首条消息，而邮件驱动会话的首条消息是桥自己拼的提示词
+  // （「你收到一封新邮件（AgentMail）…」）—— 拿它当别名毫无区分度，且条条撞名。
+  const got = snapshotPiSessions([
+    piSession({ id: 'named', name: '有名字' }),
+    piSession({ id: 'anon', name: undefined }),
+    piSession({ id: 'blank', name: '' }),
+  ]);
+  assert.deepEqual(got.map(s => s.platform_id), ['named']);
+});
+
+test('不变量：pi 老会话的空 cwd 照实上报', () => {
+  // SessionInfo 的注释写明老会话 cwd 是空串。拿桥自己的 cwd 冒充会让
+  // 那条会话在补全里挂到一个它其实不属于的工作区下。
+  const [got] = snapshotPiSessions([piSession({ cwd: '' })]);
+  assert.equal(got.workspace, '');
+});
+
+test('不变量：pi 的 updated_at 取 modified（文件 mtime）', () => {
+  const [got] = snapshotPiSessions([piSession()]);
+  assert.equal(got.updated_at, new Date(1788344476744).toISOString());
+});
+
+test('pi 快照按最近活跃排序并对撞名 slug 去重', () => {
+  const got = snapshotPiSessions([
+    piSession({ id: 'old', name: '同一个标题', modified: new Date(1000) }),
+    piSession({ id: 'new', name: '同一个标题', modified: new Date(9000) }),
+  ]);
+  assert.equal(got.length, 1);
+  assert.equal(got[0].platform_id, 'new');
+});
+
+test('pi 快照标记邮件驱动的会话', () => {
+  const got = snapshotPiSessions(
+    [piSession({ id: 'mail-one' }), piSession({ id: 'human', name: '人开的' })],
+    (id) => id === 'mail-one'
+  );
+  assert.equal(got.find(s => s.platform_id === 'mail-one').mail_driven, true);
+  assert.equal(got.find(s => s.platform_id === 'human').mail_driven, false);
+});
+
+// ─── isUnusableName：pi-web 标题生成器的思维链泄漏 ───
+
+test('不变量：思维链泄漏的标题判废', () => {
+  // 都是本机 ~/.pi/agent/sessions 里实测捞到的真实 session_info 名字。
+  // pi-web 的 cleanSessionName 只做「取首行 + 去引号 + 截 60 字符」，不防这个。
+  assert.equal(isUnusableName('The user is asking me to generate a title for a coding-agent'), true);
+  assert.equal(
+    isUnusableName('我们只需要生成标题，不包含其他内容。标题应反映请求内容：测试opencode的源。简短：Opencode源测试。或者更简'),
+    true
+  );
+});
+
+test('isUnusableName 放过正常标题', () => {
+  // 宁可漏判也不误判：错杀一个好名字会让那条会话失去可寻址的别名。
+  assert.equal(isUnusableName('查看Agent接入群聊'), false);
+  assert.equal(isUnusableName('你应该知道内网拓扑结构吧'), false);
+  assert.equal(isUnusableName('homeagent-gateway'), false);
+  assert.equal(isUnusableName('重构导入路径'), false);
+  assert.equal(isUnusableName('Fix flaky auth test'), false);
+});
+
+test('isUnusableName 判废空名字', () => {
+  assert.equal(isUnusableName(''), true);
+  assert.equal(isUnusableName('   '), true);
+  assert.equal(isUnusableName(undefined), true);
+});
+
+test('判废的名字不进快照', () => {
+  const got = snapshotPiSessions([
+    piSession({ id: 'leaked', name: 'The user is asking me to generate a title for a coding-agent' }),
+    piSession({ id: 'clean', name: '正常标题' }),
+  ]);
+  assert.deepEqual(got.map(s => s.platform_id), ['clean']);
+});