MailUI4Agents

jianf/MailUI4Agents

Fork 0

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	2996f9af9c	fix(plugins): 409 时当场表态 + DSH 补投按会话串行 409 = 永远不会成功（没有人类可路由）。原来三个插件都在失败时让位给平台本地 UI —— 但邮件驱动的会话没有 TUI，让位之后 waterfall 跑到尾依旧无人应答，仍是无声挂死。 HTTP 客户端必须把 err.status 与 err.body 挂到 error 上：只看 message 字符串分不出「暂时失败（502，该重试）」与「永远不会成功（409）」，两种都会被当成前者，而前者会永久挂住会话。三平台表态方式不同但语义统一： - opencode: output.status = "deny" + output.reason 带服务端原文 - dsh: return 'rejected'（ApprovalOutcome 只认 allowed-once/rejected/ cancelled，写 'denied' 不报错而是被当未知值静默失效） - pi: return { block: true, reason } 其余失败（502 等）保持原行为，让位本地 UI。 --- DSH 补投并发（同一文件，故并入本次提交）生产日志：`补投 5 封（共 16 封未读）`，9 秒后三封失败 `message "undefined" is already pending`。串行 for...of 并未真正串行 —— awaitFirstTurn 在首个 token 就放行，turn 尚未结束下一封已 followup。新增 waitForTurnEnd（等 turn/end 而非首 chunk）与 sessionLocks/locked() 按会话串行化。live-agent 路径原来直接 followup 就返回，现在也进锁。 120s 超时兜底，模型完全无响应时不会把后续邮件永久卡住。权限场景下锁会持有到人类决策完 —— 这是正确行为：两封都需要授权时第二封排队，比同时弹两个授权请求更合理。顺带把 rename-proposal 纳入 check-shared-libs.sh 的同源校验。	2026-09-03 21:10:48 +08:00
JianFeeeee	f321380fa3	fix: relay 死循环防护 + DSH 工作区注册修复 + homeagent 工具集补齐 + 三插件 connect_to_server ## relay 死循环防护（两道防线） ### 主防线：免配额只给发往人类的 relay（handler/mail.go）原设计：relay 走免配额通道（harness 搬运不该算模型自主发信）。问题：收件方是另一个同样会自动转发的 Agent 时，整个回路里没有任何一处在计数——生产上跑出过 41 封（会话 f3d824ce），间隔从 15 分钟缩到 5 秒，且用了 37 封才烧掉 4/20 预算。改为：repo.IsHumanUser(to.Name) 判定。Agent→Agent 的 relay 照样扣预算。顺带修次序问题：原来是「先占幂等键再扣预算」，预算耗尽时幂等键已被占用，加了额度也无法重发。现在预算失败会 ReleaseRelay 还回去。 ### 兜底：hop_limit 列接通（repo/relayhops.go） schema 里早有 hop_limit INT DEFAULT 5，从未有代码读它。 CountTrailingRelayHops 从最新邮件往前扫，遇到第一封非 relay 邮件即停（中间有一封自主发信或人类插话就归零）。 5 测试：空会话 / 只数 relay / 自主发信打断归零 / 达到上限 / 按会话独立 ## DSH 工作区注册修复问题：上一轮加的 workspaceRegistry.create(cwd) 用了兜底值 cwd（来自 resolveWorkspaceCwd，可能是 ~/.dsh/mail-sessions/mail-<uuid>），而不是会话 header 里的真实 cwd。两者不一致时 attachSession 拒绝，且 create 已先执行，每封邮件都往注册表里塞一条空的垃圾 workspace。修复：读 handle.agent.session.header.cwd —— create 路径下是 meta.cwd， resume 路径下是持久化 header 里那个。 ## homeagent 插件：11 工具齐平 opencode tools.go 新增：read_mail / forward_mail / suggest_address / list_contacts / session_participants / read_thread / connect_to_server + handleConnectToServer（注册到 Gateway 前先用候选坐标试注册，成功才写回 p.gwURL/p.key，失败不破坏原配置）关键修：Plugin.name（插件名，homed 注册用）与 Plugin.agentName （AgentMail 身份，Gateway 密钥绑定用）是两个命名空间。它们混淆会导致 403：「该密钥已绑定到 Agent 'homeagent'，不能用于注册 'homeagent-mail-bridge'」。现已分开，并在 systemd drop-in 里显式设 AGENTMAIL_AGENT_NAME=homeagent。 ## 三插件补齐 connect_to_server 之前只有 opencode 有。后果：Gateway 换地址或密钥需要重新登记时， opencode 里的模型能自己修好，其他平台只能干等环境变量被人改。 DSH 版：从 GatewayClient 内部调 register()，成功后写回 client.baseURL 与 client.agentKey 当场生效。 pi 版：新导出 KEY_FILE / saveLocalKey（从 gateway.mjs），connect 工具直接用。 # 测试 relayhops_test.go 5 例 opencode 172 / dsh 188 / pi 214 全绿 check-shared-libs.sh 三方同源（rename-proposal 已纳入校验）	2026-09-03 15:01:52 +08:00

Author

SHA1

Message

Date

JianFeeeee

2996f9af9c

fix(plugins): 409 时当场表态 + DSH 补投按会话串行

**409 = 永远不会成功**（没有人类可路由）。原来三个插件都在失败时让位给
平台本地 UI —— 但邮件驱动的会话**没有 TUI**，让位之后 waterfall 跑到尾
依旧无人应答，仍是无声挂死。

HTTP 客户端必须把 err.status 与 err.body 挂到 error 上：只看 message
字符串分不出「暂时失败（502，该重试）」与「永远不会成功（409）」，
两种都会被当成前者，而前者会永久挂住会话。

三平台表态方式不同但语义统一：
- opencode: output.status = "deny" + output.reason 带服务端原文
- dsh: return 'rejected'（ApprovalOutcome 只认 allowed-once/rejected/
  cancelled，写 'denied' 不报错而是被当未知值静默失效）
- pi: return { block: true, reason }

其余失败（502 等）保持原行为，让位本地 UI。

---

**DSH 补投并发**（同一文件，故并入本次提交）

生产日志：`补投 5 封（共 16 封未读）`，9 秒后三封失败
`message "undefined" is already pending`。串行 for...of 并未真正串行 ——
awaitFirstTurn 在**首个 token** 就放行，turn 尚未结束下一封已 followup。

新增 waitForTurnEnd（等 turn/end 而非首 chunk）与 sessionLocks/locked()
按会话串行化。live-agent 路径原来直接 followup 就返回，现在也进锁。
120s 超时兜底，模型完全无响应时不会把后续邮件永久卡住。

权限场景下锁会持有到人类决策完 —— 这是正确行为：两封都需要授权时
第二封排队，比同时弹两个授权请求更合理。

顺带把 rename-proposal 纳入 check-shared-libs.sh 的同源校验。

2026-09-03 21:10:48 +08:00

JianFeeeee

f321380fa3

fix: relay 死循环防护 + DSH 工作区注册修复 + homeagent 工具集补齐 + 三插件 connect_to_server

## relay 死循环防护（两道防线）

### 主防线：免配额只给发往人类的 relay（handler/mail.go）

原设计：relay 走免配额通道（harness 搬运不该算模型自主发信）。
问题：收件方是另一个同样会自动转发的 Agent 时，整个回路里没有任何
一处在计数——生产上跑出过 41 封（会话 f3d824ce），间隔从 15 分钟
缩到 5 秒，且用了 37 封才烧掉 4/20 预算。

改为：repo.IsHumanUser(to.Name) 判定。Agent→Agent 的 relay 照样扣预算。

顺带修次序问题：原来是「先占幂等键再扣预算」，预算耗尽时幂等键
已被占用，加了额度也无法重发。现在预算失败会 ReleaseRelay 还回去。

### 兜底：hop_limit 列接通（repo/relayhops.go）

schema 里早有 hop_limit INT DEFAULT 5，从未有代码读它。
CountTrailingRelayHops 从最新邮件往前扫，遇到第一封非 relay
邮件即停（中间有一封自主发信或人类插话就归零）。

5 测试：空会话 / 只数 relay / 自主发信打断归零 / 达到上限 / 按会话独立

## DSH 工作区注册修复

问题：上一轮加的 workspaceRegistry.create(cwd) 用了兜底值 cwd（来自
resolveWorkspaceCwd，可能是 ~/.dsh/mail-sessions/mail-<uuid>），
而不是会话 header 里的真实 cwd。两者不一致时 attachSession 拒绝，
且 create 已先执行，每封邮件都往注册表里塞一条空的垃圾 workspace。

修复：读 handle.agent.session.header.cwd —— create 路径下是 meta.cwd，
resume 路径下是持久化 header 里那个。

## homeagent 插件：11 工具齐平 opencode

tools.go 新增：read_mail / forward_mail / suggest_address /
list_contacts / session_participants / read_thread / connect_to_server
+ handleConnectToServer（注册到 Gateway 前先用候选坐标试注册，
成功才写回 p.gwURL/p.key，失败不破坏原配置）

关键修：Plugin.name（插件名，homed 注册用）与 Plugin.agentName
（AgentMail 身份，Gateway 密钥绑定用）是两个命名空间。
它们混淆会导致 403：「该密钥已绑定到 Agent 'homeagent'，不能用于
注册 'homeagent-mail-bridge'」。现已分开，并在 systemd drop-in
里显式设 AGENTMAIL_AGENT_NAME=homeagent。

## 三插件补齐 connect_to_server

之前只有 opencode 有。后果：Gateway 换地址或密钥需要重新登记时，
opencode 里的模型能自己修好，其他平台只能干等环境变量被人改。

DSH 版：从 GatewayClient 内部调 register()，成功后写回 client.baseURL
与 client.agentKey 当场生效。

pi 版：新导出 KEY_FILE / saveLocalKey（从 gateway.mjs），connect
工具直接用。

# 测试

relayhops_test.go 5 例
opencode 172 / dsh 188 / pi 214 全绿
check-shared-libs.sh 三方同源（rename-proposal 已纳入校验）

2026-09-03 15:01:52 +08:00

2 Commits