四个各自独立的生产缺陷,共同的根源都是「本该属于会话的属性没有存在会话上」。 ## 1. dsh 指定工作目录完全失效(所有会话落进「未分组」) 插件建会话时用的 cwd 是自己拼的 `~/.dsh/mail-sessions/mail-<uuid>` —— 每封邮件一个全新的空目录。DSH 与 opencode 都按 cwd 给会话分组,于是所有 邮件会话既不属于任何项目、彼此也不同组。 而 Gateway 从来没把地址里的 path 位发给插件:`notifyRecipients` 的 payload 只有 mail_id/session_id/from_name/subject,`to_workspace` 虽然入库了却不在 SSE 事件里,插件即使想用也拿不到。 - SSE `new_mail` 事件加 `to_workspace`。**每个收件方拿到自己那个地址的 path**, 不是主收件人的 —— 抄送给 opencode@/a 与主发给 dsh@/b 是两个工作区 - 两个插件的 cwd 都改为取寻址的 path 位;不存在的目录**不创建**而是回退到 兜底目录(一个笔误不该在磁盘上落下真目录,Agent 会在里面一无所获地干活) - 拒绝相对路径:cwd 的相对基准是 harness 进程的启动目录,systemd 下通常是 `/` ## 2. 会话别名列不出工作区下的历史会话(无法选择) workspace 只存在于 `mails.to_workspace` 上,「这个工作区下有哪些会话」必须 JOIN mails 再从收发双方的 workspace 里猜。而 Agent 回信时 from_workspace 填的是 **Agent 名**而不是路径,旧条件 `to_workspace = $p OR from_workspace = $p` 在只剩 Agent 回信可匹配时两边都对不上。 - `sessions.workspace` 新列,`CreateSession` 从地址的 path 位带入 - `SuggestSessionCandidates` 取代 `SuggestSessionsFor`:以会话自己的 workspace 为权威,历史会话(该列为空)回退到 mails 反推 —— 升级后老会话不该消失 - `FindOrCreateDefaultSession` 同步改用会话的 workspace ## 3. 平台侧会话在补全里根本不存在 人直接在 opencode/DSH 界面上开的会话,Gateway 一无所知。 新增 `agent_platform_sessions` 镜像表,插件在心跳里上报快照。 **上报而非 Gateway 反向拉取**:当前架构是单向的(Agent 持密钥主动连 Gateway, Gateway 从不外呼),反向拉取需要它保存各平台的地址与凭证,那是另一套信任模型。 - 与 sessions 表分开存:镜像里是别人家的会话,id 属于平台的 id 空间,没有 本侧的 owner/预算/邮件。混进 sessions 会让每一处「按会话鉴权」都要先判断 这条到底是不是真的本侧会话 - **整表替换而非增量合并**:平台侧删掉的会话必须从候选里消失 —— session 位是 三态语义,指向不存在的会话直接 404 - **nil 与空数组语义不同**:插件拉不到列表时省略该字段(保留镜像), 而不是传空数组把镜像抹掉 - **subagent 子会话不上报**:实测 DSH 的 list 里混着 49 条子会话,标题就是 派活的提示词前缀(九条都叫 "You are auditing ONE file"),slug 全撞名; 它们是父 agent 内部的工作单元,人往里发邮件毫无意义 - **slug 撞名只留最近那条**:服务端只能取其中一条,上报同名项只会让补全里 出现几个点哪个都不确定的候选 - DSH 插件此前**完全没有心跳** —— Gateway 靠 last_seen 判在线,一直靠注册撑着 补全候选带标题与来源:`suggestions` 保留纯字符串数组(不打破已部署的前端与 第三方客户端),新增同序的 `candidates`。过滤时标题也参与匹配 —— 人记得的是 「缓存选型」而不是 brisk-harbor 这种随机短名。 ## 4. 对话树看不见抄送与转发产生的分支 旧实现从锚点分「祖先链 + 子树」两路展开,而**兄弟节点既不是锚点的祖先也不是 它的子孙**:一封抄送给两个 Agent 的邮件收到两个回复,从其中一个看树永远看不到 另一个;挂在原件上的转发分支同理。 改为先 `ThreadRootOf` 上溯到线索根,再从根整树 BFS。只剩一个加载方向, 因此不再需要滚动位置补偿。前端补上抄送人列表与转发标记 —— 树上两个兄弟节点 为什么并列,唯一的解释就是父邮件抄送给了两个人。 ## 5. DSH 插件(Phase 7.7) 卡了一下午的 `Cannot read properties of undefined (reading 'kind')` 根因是 `followup()` 的参数形状:DSH 要完整的 UserMessage(content + source), 而我照抄了 opencode 的 parts 数组。错误抛在 agent-loop 内部,不指向调用点。 - `agent/status` → idle 时自动转发最后一条 assistant 消息(对应 opencode 的 session.idle),复用 relay-dedup 让位于模型的主动回信,走免配额通道 - `approval/request` 权限询问转邮件问人。与 opencode 的差异:那边的 permission.ask 是同步钩子只能立即返回 ask,DSH 这边是异步 waterfall, 可以真的等人 —— 拆插件时未决询问一律 fail closed,否则 await 永不返回 - 会话别名由模型标题派生(保留中文,去掉 `.` `@` `/` 等寻址分隔符 —— 留在别名里会让它自己被解析器切开) - 逻辑放 lib/ 下的纯函数并加测试:三类约定都是「错了不当场报错、只在深处 炸一个无关错误」 ## 其他 - `deploy/reset-demo.sh`:清空演示邮件数据,保留账号与密钥。备份用 `.backup` 而非 cp(WAL 下 cp 拿到的是缺尾巴的库);手工按依赖顺序删(SQLite 的 foreign_keys 默认关,声明了 REFERENCES 也不级联);只在目标是默认库时才碰 systemd(演练时误停过一次生产服务) - 插件 dist/ 不进版本库,install.sh 负责构建 - `permission_decision` 事件补 session_id:插件重启丢了待决映射时要靠它定位会话
145 lines
4.0 KiB
Go
145 lines
4.0 KiB
Go
package repo
|
||
|
||
import (
|
||
"context"
|
||
"testing"
|
||
|
||
"github.com/agentmail/gateway/internal/db"
|
||
"github.com/google/uuid"
|
||
)
|
||
|
||
// seedMailTo 造一封给 recipient 的未读邮件,可选带抄送。
|
||
func seedMailTo(t *testing.T, recipient string, cc string) uuid.UUID {
|
||
t.Helper()
|
||
ctx := context.Background()
|
||
sid, err := CreateSession(ctx, nil, "sender", "t", "")
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
ccJSON := "[]"
|
||
if cc != "" {
|
||
ccJSON = `[{"name":"` + cc + `","path":"","session":"","raw":"` + cc + `"}]`
|
||
}
|
||
var id uuid.UUID
|
||
err = db.DB.QueryRowContext(ctx,
|
||
`INSERT INTO mails (session_id, from_name, to_name, subject, body, cc_list)
|
||
VALUES ($1, 'sender', $2, 's', 'b', $3) RETURNING mail_id`,
|
||
sid, recipient, ccJSON).Scan(&id)
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
return id
|
||
}
|
||
|
||
func statusOf(t *testing.T, id uuid.UUID) string {
|
||
t.Helper()
|
||
var s string
|
||
if err := db.DB.QueryRowContext(context.Background(),
|
||
`SELECT status FROM mails WHERE mail_id = $1`, id).Scan(&s); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
return s
|
||
}
|
||
|
||
func TestMarkMailsReadForOnlyOwnMail(t *testing.T) {
|
||
setupTestDB(t)
|
||
ctx := context.Background()
|
||
|
||
mine := seedMailTo(t, "bot", "")
|
||
others := seedMailTo(t, "other", "")
|
||
|
||
// 一次请求里混着别人的邮件:自己的标掉,别人的动不了。
|
||
// 鉴权写在 UPDATE 的 WHERE 里,所以这不是「先查后拒」而是根本改不动。
|
||
n, err := MarkMailsReadFor(ctx, "bot", []uuid.UUID{mine, others})
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if n != 1 {
|
||
t.Fatalf("影响行数 = %d,期望 1(只有自己那封)", n)
|
||
}
|
||
if statusOf(t, mine) != "read" {
|
||
t.Fatal("自己的邮件没被标记")
|
||
}
|
||
if statusOf(t, others) != "unread" {
|
||
t.Fatal("别人的邮件被标记了 —— 鉴权失效")
|
||
}
|
||
}
|
||
|
||
// 重复标记是幂等的:Agent 通常把上一轮列出的 id 原样传回来,
|
||
// 其中混着已读的不该算错误
|
||
func TestMarkMailsReadForIsIdempotent(t *testing.T) {
|
||
setupTestDB(t)
|
||
ctx := context.Background()
|
||
id := seedMailTo(t, "bot", "")
|
||
|
||
if n, _ := MarkMailsReadFor(ctx, "bot", []uuid.UUID{id}); n != 1 {
|
||
t.Fatalf("首次应标掉 1 封,实际 %d", n)
|
||
}
|
||
n, err := MarkMailsReadFor(ctx, "bot", []uuid.UUID{id})
|
||
if err != nil {
|
||
t.Fatalf("重复标记不该报错: %v", err)
|
||
}
|
||
if n != 0 {
|
||
t.Fatalf("重复标记影响行数 = %d,期望 0", n)
|
||
}
|
||
}
|
||
|
||
// 被抄送的邮件也在收件箱里,也该能标掉
|
||
func TestMarkMailsReadForCoversCC(t *testing.T) {
|
||
setupTestDB(t)
|
||
ctx := context.Background()
|
||
id := seedMailTo(t, "other", "bot") // 主收件人是 other,bot 被抄送
|
||
|
||
n, err := MarkMailsReadFor(ctx, "bot", []uuid.UUID{id})
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if n != 1 {
|
||
t.Fatalf("被抄送的邮件应可标记,影响行数 = %d", n)
|
||
}
|
||
}
|
||
|
||
func TestMarkMailsReadForEmptyList(t *testing.T) {
|
||
setupTestDB(t)
|
||
// 空列表直接返回,不该拼出 `IN ()` 这种非法 SQL
|
||
n, err := MarkMailsReadFor(context.Background(), "bot", nil)
|
||
if err != nil {
|
||
t.Fatalf("空列表不该报错: %v", err)
|
||
}
|
||
if n != 0 {
|
||
t.Fatalf("空列表影响行数 = %d", n)
|
||
}
|
||
}
|
||
|
||
func TestMarkAllInboxReadForSkipsArchivedAndOthers(t *testing.T) {
|
||
setupTestDB(t)
|
||
ctx := context.Background()
|
||
|
||
a := seedMailTo(t, "bot", "")
|
||
b := seedMailTo(t, "bot", "")
|
||
others := seedMailTo(t, "other", "")
|
||
|
||
// 把 b 所在会话归档:那封在收件箱里根本看不到,
|
||
// 标掉它只会让「标记了 N 封」与用户看到的对不上
|
||
var sid uuid.UUID
|
||
db.DB.QueryRowContext(ctx, `SELECT session_id FROM mails WHERE mail_id = $1`, b).Scan(&sid)
|
||
db.DB.ExecContext(ctx, `UPDATE sessions SET status = 'archived' WHERE session_id = $1`, sid)
|
||
|
||
n, err := MarkAllInboxReadFor(ctx, "bot")
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if n != 1 {
|
||
t.Fatalf("影响行数 = %d,期望 1(排除归档会话)", n)
|
||
}
|
||
if statusOf(t, a) != "read" {
|
||
t.Fatal("活跃会话里的未读没被标掉")
|
||
}
|
||
if statusOf(t, b) != "unread" {
|
||
t.Fatal("归档会话里的邮件被标掉了")
|
||
}
|
||
if statusOf(t, others) != "unread" {
|
||
t.Fatal("别人的邮件被标掉了")
|
||
}
|
||
}
|