Google Calendar and Meet MCP Server

/**
 * TypeScript definitions for Google Meet MCP Server v2.0
 * These interfaces provide type definitions for Google Calendar API v3 and Google Meet API v2
 */

// ========== GOOGLE CALENDAR API v3 TYPES ==========

export interface CalendarEvent {
  id: string;
  summary: string;
  description?: string;
  location?: string;
  start_time: string;
  end_time: string;
  time_zone: string;
  attendees: Array<{
    email: string;
    response_status: string;
  }>;
  creator?: string;
  organizer?: string;
  created: string;
  updated: string;
  has_meet_conference: boolean;
  meet_link?: string;
  guest_can_invite_others?: boolean;
  guest_can_modify?: boolean;
  guest_can_see_other_guests?: boolean;
}

export interface CreateCalendarEventParams {
  summary: string;
  start_time: string;
  end_time: string;
  description?: string;
  location?: string;
  time_zone?: string;
  attendees?: string[];
  create_meet_conference?: boolean;
  guest_can_invite_others?: boolean;
  guest_can_modify?: boolean;
  guest_can_see_other_guests?: boolean;
}

export interface UpdateCalendarEventParams {
  event_id: string;
  summary?: string;
  description?: string;
  location?: string;
  start_time?: string;
  end_time?: string;
  time_zone?: string;
  attendees?: string[];
  guest_can_invite_others?: boolean;
  guest_can_modify?: boolean;
  guest_can_see_other_guests?: boolean;
}

// ========== GOOGLE MEET API v2 TYPES (GA) ==========

export interface Space {
  name: string; // "spaces/{space_id}"
  meetingUri?: string; // "https://meet.google.com/{meeting_code}"
  meetingCode?: string;
  config?: SpaceConfig;
  activeConference?: {
    conferenceRecord: string; // "conferenceRecords/{conference_record}"
  };
}

export interface SpaceConfig {
  accessType?: "OPEN" | "TRUSTED" | "RESTRICTED";
  entryPointAccess?: "ALL" | "CREATOR_APP_ONLY";
  moderation?: "OFF" | "ON";
  moderationRestrictions?: {
    chatRestriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
    reactionRestriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
    presentRestriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
    defaultJoinAsViewerType?: "ON" | "OFF";
  };
  attendanceReportGenerationType?: "GENERATE_REPORT" | "DO_NOT_GENERATE";
  artifactConfig?: {
    recordingConfig?: {
      autoRecordingGeneration: "ON" | "OFF";
    };
    transcriptionConfig?: {
      autoTranscriptionGeneration: "ON" | "OFF";
    };
    smartNotesConfig?: {
      autoSmartNotesGeneration: "ON" | "OFF";
    };
  };
}

export interface ConferenceRecord {
  name: string; // "conferenceRecords/{conference_record}"
  startTime: string;
  endTime: string;
  expireTime: string;
  space: string; // "spaces/{space_id}"
}

export interface Recording {
  name: string; // "conferenceRecords/{conference_record}/recordings/{recording}"
  driveDestination?: {
    file: string;
    exportUri: string;
  };
  state: RecordingState;
  startTime: string;
  endTime: string;
}

export interface Transcript {
  name: string; // "conferenceRecords/{conference_record}/transcripts/{transcript}"
  docsDestination?: {
    document: string;
    exportUri: string;
  };
  state: TranscriptState;
  startTime: string;
  endTime: string;
}

export interface TranscriptEntry {
  name: string; // "conferenceRecords/{conference_record}/transcripts/{transcript}/entries/{entry}"
  participant: string; // "conferenceRecords/{conference_record}/participants/{participant}"
  text: string;
  languageCode: string;
  startTime: string;
  endTime: string;
}


// ========== MCP TOOL PARAMETERS ==========

export interface CreateSpaceParams {
  access_type?: "OPEN" | "TRUSTED" | "RESTRICTED";
  entry_point_access?: "ALL" | "CREATOR_APP_ONLY";
  enable_recording?: boolean;
  enable_transcription?: boolean;
  enable_smart_notes?: boolean;
  attendance_report?: boolean;
  moderation_mode?: "ON" | "OFF";
  chat_restriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
  reaction_restriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
  present_restriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
  default_join_as_viewer?: boolean;
}


// ========== LEGACY TYPES (for backward compatibility) ==========

export interface Meeting {
  id: string;
  summary: string;
  description: string;
  meet_link: string;
  recording_enabled: boolean;
  start_time: string;
  end_time: string;
  attendees: Array<{
    email: string;
    response_status: string;
  }>;
  creator?: string;
  organizer?: string;
  created: string;
  updated: string;
}

export interface CreateMeetingOptions {
  coHosts?: string[];
  enableTranscription?: boolean;
  enableSmartNotes?: boolean;
  attendanceReport?: boolean;
  spaceConfig?: {
    moderation_mode?: "ON" | "OFF";
    chat_restriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
    present_restriction?: "HOSTS_ONLY" | "NO_RESTRICTION";
    default_join_as_viewer?: boolean;
  };
  guestPermissions?: {
    canInviteOthers?: boolean;
    canModify?: boolean;
    canSeeOtherGuests?: boolean;
  };
}

// ========== MCP TYPES ==========

export interface MCPToolSchema {
  name: string;
  description: string;
  inputSchema: {
    type: "object";
    properties: Record<string, any>;
    required: string[];
  };
}

// ========== ENUM TYPES ==========

export type AccessType = "OPEN" | "TRUSTED" | "RESTRICTED";
export type EntryPointAccess = "ALL" | "CREATOR_APP_ONLY";
export type Moderation = "OFF" | "ON";
export type RestrictionType = "HOSTS_ONLY" | "NO_RESTRICTION";
export type DefaultJoinAsViewerType = "ON" | "OFF";
export type AttendanceReportGenerationType = "GENERATE_REPORT" | "DO_NOT_GENERATE";
export type AutoGenerationType = "ON" | "OFF";
export type MemberRole = "HOST" | "COHOST" | "MEMBER" | "VIEWER";
export type RecordingState = "STARTED" | "ENDED" | "FILE_GENERATED";
export type TranscriptState = "STARTED" | "ENDED" | "FILE_GENERATED";

// ========== OAUTH SCOPES ==========

export type GoogleMeetScope = 
  | "https://www.googleapis.com/auth/calendar"
  | "https://www.googleapis.com/auth/meetings.space.created"
  | "https://www.googleapis.com/auth/meetings.space.readonly"
  | "https://www.googleapis.com/auth/meetings.space.settings"
  | "https://www.googleapis.com/auth/drive.readonly";

// ========== API RESPONSE TYPES ==========

export interface GoogleAPIResponse<T> {
  data: T;
  status: number;
  statusText: string;
}

export interface ListResponse<T> {
  items?: T[];
  nextPageToken?: string;
}