Sanitize AgentMail message read arguments

[toanminhbui]

Problem

list_messages and search_messages from the AgentMail connection fail whenever Vee reads email:

• MCP error -32602: Invalid arguments for tool list_messages: expected: "date" received: "Invalid Date" path: ["before"] / ["after"]
• With explicit RFC 3339 dates, a generic upstream HTTP 400: Request validation failed.

get_inbox works, so auth/transport are healthy. Prompt-level fixes (PR #12) did not help because the empty strings originate from the model filling optional fields of the raw tool schema, and Eve/@ai-sdk/mcp pass model-emitted arguments to the MCP server verbatim — AgentMail then parses "" as a datetime.

Fix

Follow the established list_agentmail_inboxes pattern (authored tools calling the authenticated MCP connection directly), with argument sanitization at the boundary we control:

• Add sanitizeAgentMailArguments (agent/lib/agentmail-sanitize.ts) — recursively strips empty strings, empty arrays, and null/undefined while preserving meaningful falsy values (false, 0).
• Add authored wrapper tools list_agentmail_messages and search_agentmail_messages with clean typed input schemas (RFC 3339 datetimes, non-empty query) that sanitize arguments before callTool.
• Instructions now route reads/searches through the wrappers and ban the raw list_messages/search_messages; raw tools remain exposed but unused. get_thread stays as-is for full threads.
• Extract shared agentMailAuthOptions; update connection description and changelog.

Argument names/types were verified against AgentMail's canonical mcp-manifest.json.

Verification

• pnpm typecheck — pass
• pnpm test — 10/10 pass (6 new sanitizer tests + 4 existing)
• pnpm build — pass
• Live Slack test pending deployment; upstream report to AgentMail recommended regardless.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
vee	Ready	Preview	Aug 24, 2026 3:09pm