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/agents.go

@@ -1,11 +1,15 @@
 package handler
 
 import (
+	"database/sql"
+	"errors"
 	"net/http"
+	"strings"
 
 	"github.com/agentmail/gateway/internal/middleware"
 	"github.com/agentmail/gateway/internal/models"
 	"github.com/agentmail/gateway/internal/repo"
+	"github.com/go-chi/chi/v5"
 )
 
 // ---------- Agent ----------
@@ -106,6 +110,14 @@ func RegisterAgent(w http.ResponseWriter, r *http.Request) {
 	}
 
 	if err := repo.CreateOrUpdateAgent(r.Context(), req.Name, secret, req.Platform, req.Workspaces); err != nil {
+		// 已停用的 Agent 不得靠重新注册复活。回 403 而不是 500：
+		// 这是一个明确的策略拒绝，插件应当停止重试并把原因打出来。
+		if errors.Is(err, repo.ErrAgentDisabled) {
+			Error(w, http.StatusForbidden,
+				"Agent \""+req.Name+"\" 已被管理员停用，无法注册。"+
+					"如需重新启用，请在管理页「默认预算」里恢复它。")
+			return
+		}
 		Error(w, http.StatusInternalServerError, "Failed to register agent")
 		return
 	}
@@ -208,3 +220,57 @@ func ListAgents(w http.ResponseWriter, r *http.Request) {
 		"agents": emptySlice(agents),
 	})
 }
+
+// ---------- 停用 / 恢复 ----------
+
+type setAgentStatusRequest struct {
+	// Disabled true = 停用，false = 恢复
+	Disabled bool `json:"disabled"`
+}
+
+// PUT /api/v1/admin/agents/{name}/status —— 停用或恢复一个 Agent
+//
+// 停用是可逆的「归档」，不是删除：
+//   - 邮件、会话、权限记录、转发幂等键全部保留（往来里有一半是人自己写的）
+//   - 从地址补全、GET /agents、可授权范围里消失
+//   - 全部密钥被撤销，插件拿不到新任务也发不出信
+//   - 重新注册会被拒（否则插件下次启动就把它复活了）
+//
+// 不提供彻底删除：Agent 名与人类用户名共用命名空间，删掉之后历史邮件的
+// from_name 指向一个不存在的名字，此时有人注册同名 Agent（或人类账号），
+// 那些旧邮件会看起来像是他发的。
+func AdminSetAgentStatus(w http.ResponseWriter, r *http.Request) {
+	name := strings.TrimSpace(chi.URLParam(r, "name"))
+	if name == "" {
+		Error(w, http.StatusBadRequest, "Missing agent name")
+		return
+	}
+
+	var req setAgentStatusRequest
+	if !DecodeBody(w, r, &req) {
+		return
+	}
+
+	revoked, err := repo.SetAgentDisabled(r.Context(), name, req.Disabled)
+	if errors.Is(err, sql.ErrNoRows) {
+		Error(w, http.StatusNotFound, "Agent 不存在: "+name)
+		return
+	}
+	if err != nil {
+		Error(w, http.StatusInternalServerError, "Failed to update agent status")
+		return
+	}
+
+	resp := map[string]any{
+		"agent_name": name,
+		"disabled":   req.Disabled,
+	}
+	if req.Disabled {
+		resp["keys_revoked"] = revoked
+		resp["detail"] = "已停用。邮件与会话保留；该 Agent 的密钥已全部撤销，" +
+			"恢复后需要重新签发。"
+	} else {
+		resp["detail"] = "已恢复为离线状态。需要重新签发密钥，插件连上后自动转为在线。"
+	}
+	JSON(w, http.StatusOK, resp)
+}