/** * 「模型这一轮自己发了信」的记录 —— MCP 服务器写,驱动读。 * * # 为什么不能直接用共用的 relay-dedup * * `lib/relay-dedup.js` 的记录活在**进程内**(一个 BoundedMap)。在 pi 桥那里 * 工具与转发在同一个进程里,这没问题;但在 ZCode 这里,工具跑在 ZCode 派生出来的 * **MCP 服务器进程**里,而转发决定由**驱动进程**做 —— 两个进程,内存不共享。 * * 不修这个的后果是线上实测过的:模型自己带着附件发了一封,驱动又把它的收尾话 * 转了一遍,收件箱里出现两封说同一件事的邮件(311 与 342 字节), * 而其中带附件的那封才是模型真正想发的。 * * 所以这里只做一件事:把记录落成 JSONL,让驱动能把「本轮发过什么」重建成 * 共用判据要的形状(`{names:Set, replyTos:Set}`),判定仍然交给 * `shouldSkipAutoRelay` —— 判据不能各平台自己写一份。 * * # 位置必须两端一致 * * 驱动起 ZCode 时把自己的环境传下去,ZCode 再起 MCP 服务器时继承同一份, * 于是两边解析出同一个路径。解析顺序见 `explicitSendsFile`: * 与授权表的 `grantsFilePath` 同构(都优先 AGENTMAIL_CONFIG_DIR)。 */ import { readFileSync, writeFileSync, renameSync, mkdirSync } from 'node:fs'; import { dirname, join } from 'node:path'; import { homedir } from 'node:os'; import { addrName } from './relay-dedup.js'; /** 超过这个条数就重写文件,只留最近的。记录本身是「本轮」级别的,留太多没意义。 */ const MAX_LINES = 500; export function explicitSendsFile(env = process.env) { if (env.AGENTMAIL_ZCODE_SENDS_FILE) return env.AGENTMAIL_ZCODE_SENDS_FILE; if (env.AGENTMAIL_CONFIG_DIR) return join(env.AGENTMAIL_CONFIG_DIR, 'explicit-sends.jsonl'); if (env.ZCODE_PLUGIN_DATA) return join(env.ZCODE_PLUGIN_DATA, 'explicit-sends.jsonl'); return join(homedir(), '.agentmail-zcode', 'explicit-sends.jsonl'); } /** * 记一条「模型自己发的信」。 * * 失败**不能**让 send_mail 失败:信已经发出去了。最坏后果是驱动多转一封总结, * 而服务端的 relay_key 幂等还会兜一层。 */ export function noteExplicitSendFile(file, { sessionId, to, replyTo, ts } = {}) { if (!sessionId || !to) return false; const line = JSON.stringify({ session_id: String(sessionId), to: String(to), reply_to: replyTo ? String(replyTo) : '', ts: Number.isFinite(ts) ? ts : Date.now() }); try { mkdirSync(dirname(file), { recursive: true }); let lines = []; try { lines = readFileSync(file, 'utf8').split('\n').filter(Boolean); } catch { lines = []; } lines.push(line); // 有界:这个文件活到桥重启为止,条目会一直累积(见文件头注释)。 if (lines.length > MAX_LINES) lines = lines.slice(-MAX_LINES); // 原子替换:驱动可能正在读,半截 JSON 会被跳过(无害,但会让去重偶尔失灵)。 const tmp = `${file}.tmp-${process.pid}`; writeFileSync(tmp, `${lines.join('\n')}\n`, 'utf8'); renameSync(tmp, file); return true; } catch { return false; } } /** * 读回某条会话在 `since` 之后的主动发信记录。 * * @param {string} file * @param {{sessionId: string, since?: number}} opts * @returns {{names: Set, replyTos: Set}} 直接可交给 shouldSkipAutoRelay */ export function readExplicitSends(file, { sessionId, since = 0 } = {}) { const out = { names: new Set(), replyTos: new Set() }; if (!sessionId) return out; let raw; try { raw = readFileSync(file, 'utf8'); } catch { return out; } for (const line of raw.split('\n')) { const t = line.trim(); if (!t) continue; let rec; try { rec = JSON.parse(t); } catch { continue; // 写了一半的行:跳过 } if (rec?.session_id !== String(sessionId)) continue; if (since && Number(rec.ts) < since) continue; const name = addrName(rec.to); if (name) out.names.add(name); if (rec.reply_to) out.replyTos.add(String(rec.reply_to)); } return out; }