feat(默认会话): 非邮件轮次用 /tmp 默认会话作合法 session_id —— 配套 15e4fe9 的收严
`15e4fe9` 让未声明 session_id 的读信一律 403，而 homeagent 的工具**全局可调** ⇒
对话里自主调 read_mail/read_thread 时 `currentSessionID` 为空 ⇒ 403。
不能因此让「非邮件轮次读信」这个能力消失（它是 10-01 那个 read_inbox 修复的
用户可见部分），所以给它一个合法声明。
## 关键约束：workspace 能回落 cwd，session_id 不能
`session_id` 是 AgentMail 会话的 UUID，进程 cwd 给不出它 ⇒ 只能问服务端。
落点选 `/tmp`：非邮件轮次没有真实工作目录，而 /tmp 是中性落点（不属于任何真实
项目，不会把项目邮件混进来），且满足 `UnreadWorkspaces` 的 `workspace LIKE '/%'`
（能被寻址补投）。
## 服务端：`GET /api/v1/agent/session/default`
**复用**已有的默认会话语义（`FindOrCreateDefaultSession`，8 个测试覆盖），
只把它开放成可查询形状 —— 不新造概念。
★ 第一版调 `FindOrCreateDefaultSessionCreated`，判据当场报**每次都新建**
（连问两次得到两个不同 UUID）。根因：那个函数的复用条件含
`EXISTS (SELECT 1 FROM mails …)`，空会话不满足 ⇒ 永远「没找到可复用」。
改「先查后建」仍不够。想深一层：**根本不该建** —— 非邮件轮次若 `name@/tmp`
一封都没通过，收件箱本来就该是空的，不需要一条 id 才能表达「空」。
⇒ 改成**纯只读**：没通信过就返回 `session_id: null`。
GET 有副作用是坏味道，它会被桥每轮调一次。
同时把匹配 SQL 抽成 `defaultSessionMatchSQL` 共享常量：`FindExisting` 与
`FindOrCreate` 必须给出**同一个**答案，否则「查到的默认会话」与「发信落进去的
会话」会静默分叉（各写一份 SQL 的话，改一边不会红）。
## 桥（homeagent）：effectiveSessionID = 信封 → 默认会话
⚠ 取值函数**不发请求**。我第一版把 HTTP 塞进 `effectiveSessionID`，
`&Plugin{}` 构造的测试当场 nil panic，且 scopeQuery 变成「拼 URL 时顺带发请求」。
IO 移到装配期 `register()` 里的 `ensureDefaultSession()`。
⚠ `client == nil` 时**不标记已问** —— 那不是「答案是空」而是「还没资格问」，
标了会永久缓存空值。而 register() 里就会调它，真的会在插件加载阶段崩。
## 判据
服务端 6 格（含★「不是万能钥匙」：拿默认会话 id 去读别人的会话仍须 403 ——
少了这格，这个端点就是「声明一个合法会话然后读遍全场」的后门）。
homeagent 6 格。
三个变异各红 1 格：退回旧的整体放弃 / 未就绪也标记 / 默认落点与服务端不一致。
## 未改：pi / dsh / opencode
实测它们的裸奔已停止（pi 自 Sep 26、opencode 自 Sep 28，`[agent-scope]` 日志归零），
`getMailSessionId` 由 worker 闭包注入且只有一处装配点。dsh 待单独核。
This commit is contained in:
@ -112,6 +112,80 @@ func canReadSession(w http.ResponseWriter, r *http.Request, agentName string, sc
|
||||
return false
|
||||
}
|
||||
|
||||
// GET /api/v1/agent/session/default —— 问出「我的默认会话是哪条」
|
||||
//
|
||||
// ★ 2026-10-02 新增。它是 `AgentMayReadSession` 收严后的**配套出口**：
|
||||
// 未声明 session_id 的读信请求现在一律 403，而桥在**非邮件驱动轮次**
|
||||
// （对话/自主调用）手里确实没有任何会话可声明 —— `session_id` 是 AgentMail
|
||||
// 会话的 UUID，进程 cwd 给不出它（这点与 workspace 不同，workspace 能回落到 cwd）。
|
||||
//
|
||||
// 所以这里把**已有的**默认会话语义开放成一个可查询入口：
|
||||
// `name@path` 省略 session 位时投递到的那条会话（`repo.FindOrCreateDefaultSession`）。
|
||||
// 那个函数早就在（8 个测试覆盖它），只是没有「只查询」的 HTTP 形状。
|
||||
//
|
||||
// # 为什么默认工作区是 /tmp
|
||||
//
|
||||
// 非邮件轮次没有真实工作目录可依（桥进程 cwd 是插件目录，不是用户项目）。
|
||||
// /tmp 是**明确的中性落点**：它不属于任何一个真实项目，
|
||||
// 所以落进去的会话不会在任何人的工作区里混进项目邮件，
|
||||
// 而 `UnreadWorkspaces` 要求 workspace 形如 `/%`（要能被寻址补投），/tmp 满足。
|
||||
//
|
||||
// # 安全边界：这个端点**不是**绕过 session 闸的万能钥匙
|
||||
//
|
||||
// 它只回答「你自己 `name@/tmp` 的默认会话是哪条」，不授予读任何会话的能力。
|
||||
// 拿到 UUID 后仍要过 `AgentMayReadSession`：读别的会话照样 403。
|
||||
// 换句话说：它把「非法」变成「合法但窄」—— 默认会话只装发给**你自己**的信。
|
||||
func AgentDefaultSession(w http.ResponseWriter, r *http.Request) {
|
||||
agentName := middleware.GetAgentName(r)
|
||||
if agentName == "" {
|
||||
Error(w, http.StatusUnauthorized, "Unauthorized")
|
||||
return
|
||||
}
|
||||
ws := strings.TrimSpace(r.URL.Query().Get("workspace"))
|
||||
if ws == "" {
|
||||
ws = DefaultFallbackWorkspace
|
||||
}
|
||||
if !strings.HasPrefix(ws, "/") {
|
||||
Error(w, http.StatusBadRequest, "workspace 必须是绝对路径，收到: "+ws)
|
||||
return
|
||||
}
|
||||
// 纯只读：没有就返回空，**不建会话**。
|
||||
//
|
||||
// 我第一版直接调 FindOrCreateDefaultSessionCreated，判据当场报它**每次都新建**
|
||||
//（连着两次问拿到两个不同 UUID）。改「先查后建」还不够 —— 已建的空会话仍不满足
|
||||
// 那个函数的复用条件（`EXISTS (SELECT 1 FROM mails …)`），于是下一次依然「没找到」。
|
||||
//
|
||||
// 而想深一层：**根本不该建**。非邮件轮次读信时，若 `name@/tmp` 一封都没通过，
|
||||
// 那个收件箱本来就应该是空的 —— 不需要一条会话 id 才能表达「空」。
|
||||
// 要让默认会话真的存在，只需要**往 /tmp 发一封信**，那是发信路径的事。
|
||||
//
|
||||
// GET 端点有副作用本身就是坏味道：它会被桥每轮调一次，
|
||||
// 预建会话等于让「问一次」在会话列表里留一条垃圾。
|
||||
id, err := repo.FindExistingDefaultSession(r.Context(), agentName, ws)
|
||||
if err != nil {
|
||||
Error(w, http.StatusInternalServerError, "Failed to resolve default session")
|
||||
return
|
||||
}
|
||||
// 没找到时返回 session_id=null（而不是 uuid.Nil 字符串）：
|
||||
// 桥看到 null 就知道「默认会话还不存在，收件箱按空处理」，
|
||||
// 而不是拿着一个不存在的 id 去声明、然后拿到一个莫名其妙的 403。
|
||||
var sid any
|
||||
self := ""
|
||||
if id != uuid.Nil {
|
||||
sid = id
|
||||
self = models.FormatAddress(agentName, ws, repo.SessionAliasOf(r.Context(), id))
|
||||
}
|
||||
JSON(w, http.StatusOK, map[string]any{
|
||||
"session_id": sid,
|
||||
"workspace": ws,
|
||||
"exists": id != uuid.Nil,
|
||||
"self_address": self,
|
||||
})
|
||||
}
|
||||
|
||||
// DefaultFallbackWorkspace 是非邮件轮次的默认落点（理由见 AgentDefaultSession）。
|
||||
const DefaultFallbackWorkspace = "/tmp"
|
||||
|
||||
// GET /api/v1/agent/contacts
|
||||
//
|
||||
// 本 Agent 参与过的会话，每条给出可直接投递的 `address`。
|
||||
|
||||
Reference in New Issue
Block a user