Calendar Management

# Natural language examples
"Add a meeting with John next Tuesday at 2pm"
"Schedule a dentist appointment tomorrow at 10am"
"Create an event called 'Team Sync' on Friday at 3pm for 1 hour"

"Show me my calendar for today"
"What meetings do I have this week?"
"List my events for next Monday"

{
  "success": true,
  "message": "Found 5 event(s).",
  "events": [
    {
      "id": "event_abc123",
      "title": "Team Meeting",
      "start": "2026-03-10T14:00:00",
      "end": "2026-03-10T15:00:00",
      "description": "Weekly sync"
    }
  ]
}

"Find my dentist appointment"
"Search for events with 'project' in the title"
"When is my meeting with Sarah?"

"Move my 2pm meeting to 3pm"
"Change the dentist appointment title to 'Dental Checkup'"
"Update the project meeting description"

"Delete my dentist appointment"
"Cancel the meeting on Friday"
"Remove the 3pm event"

from agent.date_utils import parse_duration, calculate_end_time

# Parse duration strings
parse_duration("1 hour")     # timedelta(hours=1)
parse_duration("30 minutes") # timedelta(minutes=30)
parse_duration("2h")         # timedelta(hours=2)
parse_duration("1.5 hours")  # timedelta(hours=1.5)

# Calculate end time
calculate_end_time(
    start_time="2026-03-10T14:00:00",
    duration="1 hour"
)  # Returns "2026-03-10T15:00:00"

class CalendarService:
    def __init__(self, service):
        """Initialize with authenticated Google Calendar service."""
        self.service = service
        self.primary_calendar_id = "primary"

"Add lunch with Sarah tomorrow at noon"
# Automatically:
# - Parses "tomorrow at noon" to ISO datetime
# - Sets 1-hour duration (12:00 PM - 1:00 PM)
# - Creates event on primary calendar

"What's on my calendar this week?"
# Lists all events from today through end of week
# Ordered by start time
# Shows title, time, and description

User: "Find my dentist appointment"
Agent: "Found event 'Dentist' on March 15 at 10am"
User: "Move it to March 16 at 2pm"
Agent: "Event updated successfully"

try:
    result = calendar_service.add_event(
        title="Meeting",
        start_time="invalid_date",
        end_time="invalid_date"
    )
except HttpError as error:
    return {
        "success": False,
        "message": f"Failed to create event: {error}",
        "error": str(error)
    }