feat: basics

owa_mcp/models.py

@@ -0,0 +1,116 @@
+"""Return type definitions for MCP tools.
+
+Uses TypedDict for lightweight structured return types without
+requiring Pydantic at the model layer.
+"""
+
+from typing import TypedDict
+
+
+class Email(TypedDict, total=False):
+  """An email message."""
+
+  subject: str
+  sender: str
+  sender_name: str
+  date: str
+  is_read: bool
+  has_attachments: bool
+  has_links: bool
+  item_id: str
+  size: int
+  is_meeting: bool
+  item_type: str
+  to: list[str]
+  cc: list[str]
+  body: str
+  body_type: str
+  attachments: list[dict]
+  # Meeting-specific fields
+  location: str
+  start: str
+  end: str
+  attendees_required: list[str]
+  attendees_optional: list[str]
+
+
+class CalendarEvent(TypedDict, total=False):
+  """A calendar event / meeting."""
+
+  subject: str
+  start: str
+  end: str
+  location: str
+  is_all_day: bool
+  is_cancelled: bool
+  is_meeting: bool
+  is_recurring: bool
+  organizer: str
+  organizer_email: str
+  my_response: str
+  item_id: str
+  body: str
+  attendees_required: list[str]
+  attendees_optional: list[str]
+
+
+class Person(TypedDict, total=False):
+  """A person from the Exchange directory."""
+
+  name: str
+  email: str
+  mailbox_type: str
+  first_name: str
+  last_name: str
+  job_title: str
+  department: str
+  company: str
+  office: str
+  alias: str
+  manager: str
+  manager_email: str
+  phones: dict[str, str]
+  address: str
+  direct_reports: list[dict[str, str]]
+
+
+class Folder(TypedDict, total=False):
+  """A mail folder."""
+
+  name: str
+  id: str
+  total_count: int
+  unread_count: int
+  child_folder_count: int
+
+
+class FreeSlot(TypedDict):
+  """A free time slot."""
+
+  date: str
+  start: str
+  end: str
+  duration_minutes: int
+
+
+class Availability(TypedDict, total=False):
+  """Availability data for a single attendee."""
+
+  email: str
+  busy_slots: int
+  free_slots: int
+  merged_freebusy: str
+
+
+class MeetingResult(TypedDict, total=False):
+  """Result of creating/updating a meeting."""
+
+  success: bool
+  subject: str
+  date: str
+  start_time: str
+  end_time: str
+  location: str
+  required_attendees: list[str]
+  optional_attendees: list[str]
+  error: str