用途:在 agent-native 框架中创建、编辑、管理并发送邮件草稿。每份草稿以 compose-{id} 为键存入 application_state 表,UI 通过轮询/查询失效自动刷新撰写面板,多份草稿以标签页形式并存。
主要能力:草稿字段包括 id、to、cc、bcc、subject、body、mode(compose/reply/forward)、replyToId、replyToThreadId;body 使用 Markdown,发送前转为 HTML。manage-draft 支持 create、update、delete、delete-all,会校验 id(/^[a-zA-Z0-9_-]{1,64}$/),create 时按 mail-settings 自动追加签名(幂等,且插入在引用内容之前),并返回可在真实 Mail 撰写界面打开该草稿的 deepLink。view-composer 或 listAppState("compose-") 可列出草稿。send-email 支持附件,附件须先经 /api/media/upload 上传,传服务端文件名、originalName、mimeType,不存 base64 或 data URL。
使用方式:先读取 pnpm action get-mail-settings 获取签名与写作风格;创建草稿用 pnpm action manage-draft --action=create --to=... --subject=... --body=...,更新用 --action=update --id=...,删除用 --action=delete --id=... 或 --action=delete-all。发送需用户明确意图,send-email 为 needsApproval: true,会暂停等待人工批准。
适用场景:撰写、回复、转发邮件,带附件发送,以及从 MCP 等外部宿主调用时返回 deepLink。
限制:未连接 Google 账号时发送走演示回退路径,只生成本地已发送记录,并非真实发出;开启 opens/clicks 跟踪会改写正文并记录 token,get-tracking 可读回统计;id 必须与键名后缀一致;UI 写入有 300ms 防抖;不要直接写 compose-{id} 状态,应优先用 manage-draft;不要使用原始 HTML 标签。其余收费、平台等信息暂未提供。