Gmail Operation Pydantic Schemas (gmail/schemas.py)

Provides Pydantic models to validate Gmail API operations like sending, replying, or forwarding emails. Use this to ensure agent-generated email requests conform to API requirements.

# Source: https://github.com/nexi-lab/nexus | License: Apache-2.0 | Copyright You must retain, in the Source form of any Derivative Works
# Provided via justclaw.it.com; keep this notice with the code.
"""Pydantic schemas for Gmail operations.

These schemas validate the YAML content that agents write to send emails,
reply to threads, or forward messages.

Based on:
- Gmail API v1: https://developers.google.com/gmail/api/reference/rest
- MCP Server patterns: https://github.com/anthropics/anthropic-cookbook
- RFC 2822 email format

Example email composition:
    ```yaml
    # agent_intent: User requested to send a project update to the team
    to:
      - alice@example.com
      - bob@example.com
    subject: Weekly Project Update
    body: |
      Hi team,

      Here's the weekly update 

... (truncated -- full source via MCP)