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），未手工拼写

gateway/internal/handler/mail.go

@@ -1,6 +1,7 @@
 package handler
 
 import (
+	"context"
 	"errors"
 	"fmt"
 	"net/http"
@@ -92,14 +93,32 @@ func resolveTarget(r *http.Request, addr models.Address, replyTo, fromAgent, sub
 		if err != nil {
 			// 建失败要把名额还回去：那次新建实际上没有发生
 			repo.ReleaseNewSession(r.Context(), byAgent)
+			return id, nil, err
 		}
-		return id, nil, err
+		// `.new` 是一次性动作：它建完会话就用完了，之后要再投进这条会话只能靠
+		// `name@path.<别名>`。未命名会话既查不到（FindNamedSessionFor 的
+		// `session_alias = $1` 对 NULL 不成立）也补全不出来，收件方与抄送方
+		// 除了回复那一封之外再也无法寻址到它 —— 再发一次 `.new` 只会建第三条会话。
+		// 因此这里立刻给一个别名，平台随后仍可用 SyncSessionAlias 改写它。
+		if aliasPtr == nil {
+			// 命名失败不该让发信失败：邮件本身能送达，代价只是这条会话暂时
+			// 只能用 reply_to 续谈，比整封退回轻。
+			_, _ = repo.EnsureSessionAlias(r.Context(), id, repo.AutoAliasFor(addr.Name, subject))
+		}
+		return id, nil, nil
 
 	case models.SessionDefault:
 		// 默认会话「从未通信则建立」也会产生新会话，但一个 name@path 只有一条，
 		// 不构成暴开的手段，因此不计入速率限制。
 		id, err := repo.FindOrCreateDefaultSession(r.Context(), addr.Name, addr.Path, fromAgent, subject)
-		return id, nil, err
+		if err != nil {
+			return id, nil, err
+		}
+		// 默认会话同样需要可寻址的别名：省略 session 位能投进来，但要**指名**
+		// 投进这一条（而不是「该 name@path 当前的默认会话」）仍然只能靠别名。
+		// 已有别名时 EnsureSessionAlias 直接返回，复用旧会话不会被改名。
+		_, _ = repo.EnsureSessionAlias(r.Context(), id, repo.AutoAliasFor(addr.Name, subject))
+		return id, nil, nil
 
 	default: // models.SessionNamed
 		id, err := repo.FindNamedSessionFor(r.Context(), addr.Name, addr.Path, addr.Session)
@@ -238,7 +257,7 @@ func SendMail(w http.ResponseWriter, r *http.Request) {
 		return
 	}
 
-	notifyRecipients(to, ccList, sessionID, mailID, agentName, req.Subject)
+	notifyRecipients(r.Context(), to, ccList, sessionID, mailID, agentName, req.Subject)
 
 	// 回传会话别名与本任务剩余往返，让发件方知道后续用什么地址续谈、还能发几封
 	resp := map[string]any{
@@ -273,8 +292,17 @@ func SendMail(w http.ResponseWriter, r *http.Request) {
 // 三维地址 name@path.session 的 path 就是工作目录，插件要靠它建会话。
 // 抄送给 opencode@/a 与主发给 dsh@/b 是两个不同的工作区，共用一份 payload
 // 会让抄送方在别人的目录里开会话。
-func notifyRecipients(to models.Address, cc []models.Address, sessionID, mailID uuid.UUID, from, subject string) {
-	payload := func(role, workspace string) map[string]interface{} {
+//
+// 同理，**每个收件方拿到的 reply_address 也是自己那个地址**，并且 session 位已经
+// 把 `new` 换成真实别名：`.new` 建完会话就失效了，把原文那个 `x@/p.new`
+// 送给参与方只会让它下一次又建一条新会话。
+func notifyRecipients(ctx context.Context, to models.Address, cc []models.Address, sessionID, mailID uuid.UUID, from, subject string) {
+	// 别名在此时已由 resolveTarget 保证存在（`.new` 与默认会话都过 EnsureSessionAlias）。
+	// 仍可能为空的情形：命名写入失败（已吐日志）。此时退回省略 session 位，
+	// 而不是把 "new" 写进去 —— 后者会让参与方反复建新会话。
+	alias := repo.SessionAliasOf(ctx, sessionID)
+
+	payload := func(role, workspace, forName string) map[string]interface{} {
 		return map[string]interface{}{
 			"mail_id":    mailID.String(),
 			"session_id": sessionID.String(),
@@ -286,6 +314,14 @@ func notifyRecipients(to models.Address, cc []models.Address, sessionID, mailID
 			// 不带这一项的后果：插件只能自己拼一个临时目录，于是每封邮件都落在
 			// 不同的空目录里，DSH / opencode 按 cwd 分组时全进「未分组」。
 			"to_workspace": workspace,
+			// session_alias 是这条会话今后的寻址名。没有它的话，收到 `.new`
+			// 邮件的一方只持有一个 send_mail 不接受的 session_id。
+			"session_alias": alias,
+			// reply_address 是「把回信发回这条会话」的现成地址。
+			// 插件不必自己拼（拼错了就是静默开新会话）。
+			"reply_address": models.FormatAddress(from, "", alias),
+			// self_address 是对方应当用来称呼自己的地址，供转发/报告时引用。
+			"self_address": models.FormatAddress(forName, workspace, alias),
 		}
 	}
 
@@ -297,7 +333,7 @@ func notifyRecipients(to models.Address, cc []models.Address, sessionID, mailID
 	// 参与方去重：收件人 + 所有抄送 + 发件人自己（刷新他的发件箱）
 	seen := map[string]bool{}
 
-	sse.Default.SendToRecipient(to.Name, "new_mail", payload("to", to.Path))
+	sse.Default.SendToRecipient(to.Name, "new_mail", payload("to", to.Path, to.Name))
 	sse.Default.SendToRecipient(to.Name, "session_update", update)
 	seen[to.Name] = true
 
@@ -306,7 +342,7 @@ func notifyRecipients(to models.Address, cc []models.Address, sessionID, mailID
 			continue
 		}
 		seen[c.Name] = true
-		sse.Default.SendToRecipient(c.Name, "new_mail", payload("cc", c.Path))
+		sse.Default.SendToRecipient(c.Name, "new_mail", payload("cc", c.Path, c.Name))
 		sse.Default.SendToRecipient(c.Name, "session_update", update)
 	}