统一查找邮件并返回类型安全的稳定引用。

普通邮件返回 message_ref；草稿返回 draft_ref，不会同时伪装成可回复的消息。 无过滤条件时列出 inbox/sentitems 中最近邮件；姓名拼音或完整邮箱由 Server 解析和消歧。需要用户选择时返回 resume_token，由 continue_action 恢复。

读取邮件或草稿的正文、收发件人和附件元数据。

message_ref 与 draft_ref 必须且只能提供一个；不接受底层 Exchange ItemId。

使用姓名拼音或完整邮箱解析人员，并结合历史邮件消歧。

裸拼音会收集所有已配置公司域名下、邮箱 local-part 以该拼音开头的候选； 不会优先选择无数字后缀的邮箱。多个候选中若只有一个存在历史来往才自动选择。

新建、回复、Reply All 或转发邮件草稿，绝不发送。

compose 需要 subject/to_queries；其他模式需要 source_message_ref。reply 和 reply_all 不接受收件人；forward 需要 to_queries。reply/forward 创建后如需 改主题或加附件，继续调用 edit_mail_draft。

修改邮件草稿并可追加允许目录中的本地附件，绝不发送。

所有附件会在第一次 Exchange 写入前完成路径和大小校验。draft_ref 只能是 邮件草稿引用；会议必须使用 save_meeting。

恢复人员/邮件/时间确认，或提交 weekly_report 周报修改。

周报 selections 仅支持 changes 和可选 subject；changes 每项使用 weekly_report 返回的短 id/text，例如 {"id":"s3","text":"完成接口联调"}。weekly_report 返回的 subject 已是 Server 自动顺延后的默认草稿主题；通常无需再次提交 subject。

处理“周报”请求的唯一 Agent 入口。

request 是“本次要写入新周报的最终修改需求”。它既可以直接来自用户，也可以是 Agent 在调用本工具之前通过 search_mail/read_mail 读取其他人的周报或相关邮件后，先用 LLM 总结 得到的自然语言输入。若用户要求“总结 A、B 发给我的周报并生成我的周报”，应先完成邮件 搜索、读取和总结，再把总结结果作为 request 调用 weekly_report；不要把“去搜索并总结 A、B” 这类元指令原样作为 request。weekly_report 本身只处理自己的周报模板，不负责搜索他人的邮件。

返回紧凑 JSON：resume_token、mode、subject、request、instructions、最新模板的 slots， 以及前两周 history。slots.id 是本次上下文局部短 ID（s1、s2...），必须原样 使用，不得猜测或自行构造；loc 是压缩后的模板结构上下文，只用于理解版面和语义， 不参与真正写入定位。

生成下一周内容时，必须先语义拆解 request，再进行 slot routing。slot.loc 是原周报的显式 结构路径，每个路径文本后面的括号都会标明该文本在表格中的位置/层级身份，例如： 周报（纵向表头） = nl2sql项目（横向表头） > 项目进展（二级纵向表头）。= 表示一级 纵向表头与一级横向表头在当前内容位置交叉，> 表示继续进入更具体的下一级表头，越靠右 越具体。路由时主要理解括号前的真实表头文字，括号里的纵向/横向/二级等位置用于理解层级 和消歧；slot.text 是该路径末端当前承载的实际内容。不能因为某个 slot 文本关键词看起来最 相似，就把整段 request 放入该 slot。一段输入可以修改多个 slot；属于不同 loc 的事实必须 分别更新；只有确认属于同一 loc 的多条事实才合并后改写。用户本次事实 优先于历史；只提交确实需要变化的槽位；聊天性、情绪性或与正式周报无关的信息可以 忽略；无法可靠确定归属时不要猜测或修改无关 slot。 将口语化事实改写为简洁、正式、客观的周报文本；延续历史中的正式项目名和 技术术语，不得虚构事实。必须检查正文中所有周期性日期/周次并顺延。Server 会自动把可识别的 Subject 日期/周次顺延一周；返回的 subject 已是默认草稿主题。 然后调用 continue_action(resume_token=..., selections={"changes":[{"id":"s1","text":"..."}]})。 仅当用户明确要求不同主题时才传 selections.subject 覆盖默认值。本地参数错误时修正后复用同一 token；只有明确 context_stale、token 过期/已使用/被取代时才重新调用 weekly_report。

本工具不创建草稿，也绝不向 Agent 暴露 HTML。Server 会在 continue_action 阶段自动决定 Reply All 或新建草稿。

按时间范围列出日程，或按 calendar_ref 读取一个日历项目。

读取单项时只提供 calendar_ref；列出日程时同时提供 start/end。

解析参会人并查找共同空闲时间。

人员查询只接受姓名拼音或完整邮箱。默认把当前用户作为 Organizer， 同时尊重 Exchange 返回的个人工作时间；缺失时使用本地日历偏好。

创建或修改会议并始终保持未发送状态。

没有 calendar_ref 时创建：需要 attendee_queries、subject、body_html，以及 确定的 start/end；如需查找候选时间，先调用 find_meeting_times。提供 calendar_ref 时更新现有未发送会议；attendee_queries 此时只接受完整邮箱。 发送邀请必须另行调用 send_meeting_invitation。

发送一个已保存但尚未发送的会议邀请。

只有显式设置 confirm_send=true 才会发送；已发送或已取消的会议会被拒绝， 避免重复邀请。必须使用 save_meeting/read_calendar 返回的 calendar_ref。