fireflies-api 0.5.0

package/dist/types-C_XxdRd1.d.cts

@@ -0,0 +1,1546 @@
+import { T as Transcript, b as ActionItem, l as Summary } from './action-items-CC9yUxHY.cjs';
+
+/**
+ * Meeting state for active meetings.
+ */
+type MeetingState = 'active' | 'paused';
+/**
+ * Privacy setting for meetings.
+ */
+type MeetingPrivacy = 'public' | 'team' | 'private';
+/**
+ * Active meeting in progress.
+ */
+interface ActiveMeeting {
+    id: string;
+    title: string;
+    organizer_email: string;
+    meeting_link?: string;
+    start_time?: string;
+    end_time?: string;
+    privacy?: MeetingPrivacy;
+    state: MeetingState;
+}
+
+/**
+ * Scope for transcript search queries.
+ */
+type TranscriptsQueryScope = 'title' | 'sentences' | 'all';
+/**
+ * Parameters for listing transcripts.
+ */
+interface TranscriptsListParams {
+    /**
+     * Search keyword. Searches title and/or content based on scope.
+     * This is the recommended search parameter (replaces title).
+     */
+    keyword?: string;
+    /**
+     * Where to search for the keyword.
+     * - 'title': Search only in titles
+     * - 'sentences': Search only in transcript content
+     * - 'all': Search in both title and content
+     * @default 'all'
+     */
+    scope?: TranscriptsQueryScope;
+    /**
+     * Filter by organizer emails (array).
+     * Use this instead of the deprecated organizer_email.
+     */
+    organizers?: string[];
+    /**
+     * Filter by participant emails (array).
+     * Use this instead of the deprecated participant_email.
+     */
+    participants?: string[];
+    /**
+     * Filter by specific user ID.
+     */
+    user_id?: string;
+    /**
+     * Only return transcripts owned by the authenticated user.
+     */
+    mine?: boolean;
+    /**
+     * Filter by channel ID (v2.11.0+).
+     */
+    channel_id?: string;
+    /**
+     * Start of date range (ISO 8601 string).
+     * Returns transcripts from this date onwards.
+     */
+    fromDate?: string;
+    /**
+     * End of date range (ISO 8601 string).
+     * Returns transcripts up to this date.
+     */
+    toDate?: string;
+    /**
+     * Maximum number of transcripts to return.
+     * @default 50
+     * @max 50
+     */
+    limit?: number;
+    /**
+     * Number of transcripts to skip (for pagination).
+     * @default 0
+     */
+    skip?: number;
+    /**
+     * Search by title only.
+     * @deprecated Use keyword with scope='title' instead.
+     */
+    title?: string;
+    /**
+     * Filter by host email.
+     * @deprecated Use organizers instead.
+     */
+    host_email?: string;
+    /**
+     * Filter by organizer email (single).
+     * @deprecated Use organizers array instead.
+     */
+    organizer_email?: string;
+    /**
+     * Filter by participant email (single).
+     * @deprecated Use participants array instead.
+     */
+    participant_email?: string;
+    /**
+     * Filter by date (Unix timestamp).
+     * @deprecated Use fromDate and toDate instead.
+     */
+    date?: number;
+}
+/**
+ * Parameters for transcript insights analysis.
+ * Combines filtering options (for fetching) with analysis options.
+ */
+interface TranscriptsInsightsParams {
+    /** Start of date range (ISO 8601 string) */
+    fromDate?: string;
+    /** End of date range (ISO 8601 string) */
+    toDate?: string;
+    /** Only analyze transcripts owned by the authenticated user */
+    mine?: boolean;
+    /** Filter by organizer emails */
+    organizers?: string[];
+    /** Filter by participant emails */
+    participants?: string[];
+    /** Filter by specific user ID */
+    user_id?: string;
+    /** Filter by channel ID */
+    channel_id?: string;
+    /** Maximum number of transcripts to analyze (default: no limit) */
+    limit?: number;
+    /**
+     * Only include meetings with external participants.
+     * External means participants whose email domain differs from the current user's domain.
+     * When true, fetches the current user's email to determine the internal domain.
+     */
+    external?: boolean;
+    /**
+     * Only include stats for these speakers.
+     * Speaker names must match exactly (case-sensitive).
+     */
+    speakers?: string[];
+    /**
+     * Group results by time period.
+     * - 'day': Group by calendar day
+     * - 'week': Group by ISO week
+     * - 'month': Group by month
+     */
+    groupBy?: 'day' | 'week' | 'month';
+    /** Number of top speakers to include (default: 10) */
+    topSpeakersCount?: number;
+    /** Number of top participants to include (default: 10) */
+    topParticipantsCount?: number;
+}
+/**
+ * Parameters for getting a single transcript.
+ */
+interface TranscriptGetParams {
+    /**
+     * Include the full sentences array.
+     * Set to false for faster response when you only need metadata.
+     * @default true
+     */
+    includeSentences?: boolean;
+    /**
+     * Include the summary object.
+     * @default true
+     */
+    includeSummary?: boolean;
+}
+/**
+ * Parameters for listing bites.
+ */
+interface BitesListParams {
+    /** Filter by transcript ID */
+    transcript_id?: string;
+    /** Only my bites */
+    mine?: boolean;
+    /** All team bites */
+    my_team?: boolean;
+    /** Max results (max 50) */
+    limit?: number;
+    /** Pagination offset */
+    skip?: number;
+}
+/**
+ * Parameters for creating a bite.
+ */
+interface CreateBiteParams {
+    /** Transcript ID */
+    transcript_id: string;
+    /** Start time in seconds */
+    start_time: number;
+    /** End time in seconds */
+    end_time: number;
+    /** Bite name (max 256 chars) */
+    name?: string;
+    /** Media type: 'video' or 'audio' */
+    media_type?: 'video' | 'audio';
+    /** Summary (max 500 chars) */
+    summary?: string;
+    /** Privacy settings */
+    privacies?: Array<'public' | 'team' | 'participants'>;
+}
+/**
+ * Parameters for listing active meetings.
+ */
+interface ActiveMeetingsParams {
+    /** Filter by user email (admin only for other users) */
+    email?: string;
+    /** Filter by state */
+    states?: MeetingState[];
+}
+/**
+ * Parameters for adding a bot to a meeting.
+ */
+interface AddBotParams {
+    /** Meeting URL (Zoom, Google Meet, etc.) */
+    meeting_link: string;
+    /** Meeting title (max 256 chars) */
+    title?: string;
+    /** Meeting password (max 32 chars) */
+    password?: string;
+    /** Duration in minutes (15-120, default 60) */
+    duration?: number;
+    /** Language code */
+    language?: string;
+}
+/**
+ * Attendee for audio upload.
+ */
+interface UploadAudioAttendee {
+    displayName?: string;
+    email?: string;
+    phoneNumber?: string;
+}
+/**
+ * Parameters for uploading audio for transcription.
+ */
+interface UploadAudioParams {
+    /** Public URL of audio/video file */
+    url: string;
+    /** Title for the transcript (max 256 chars) */
+    title?: string;
+    /** Webhook URL for completion notification */
+    webhook?: string;
+    /** Language code */
+    custom_language?: string;
+    /** Save video if applicable */
+    save_video?: boolean;
+    /** Meeting attendees */
+    attendees?: UploadAudioAttendee[];
+    /** Custom reference ID (max 128 chars) */
+    client_reference_id?: string;
+    /** Allow files < 50kb */
+    bypass_size_check?: boolean;
+}
+/**
+ * Parameters for listing AI App outputs.
+ */
+interface AIAppsListParams {
+    /** Filter by app ID */
+    app_id?: string;
+    /** Filter by transcript ID */
+    transcript_id?: string;
+    /** Max results (max 10) */
+    limit?: number;
+    /** Pagination offset */
+    skip?: number;
+}
+
+/**
+ * Configuration options for the Fireflies client.
+ */
+interface FirefliesConfig {
+    /**
+     * Your Fireflies API key.
+     * Get one from: https://app.fireflies.ai/integrations/custom/fireflies
+     */
+    apiKey: string;
+    /**
+     * Base URL for the GraphQL API.
+     * @default 'https://api.fireflies.ai/graphql'
+     */
+    baseUrl?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Retry configuration for transient failures.
+     */
+    retry?: RetryConfig;
+    /**
+     * Rate limit tracking and throttling configuration.
+     * Optional - if not provided, rate limit headers are not tracked.
+     */
+    rateLimit?: RateLimitConfig;
+}
+/**
+ * Configuration for retry behavior on transient failures.
+ */
+interface RetryConfig {
+    /**
+     * Maximum number of retry attempts.
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay between retries in milliseconds.
+     * @default 1000
+     */
+    baseDelay?: number;
+    /**
+     * Maximum delay between retries in milliseconds.
+     * @default 30000
+     */
+    maxDelay?: number;
+}
+/**
+ * Current rate limit state from API responses.
+ */
+interface RateLimitState {
+    /**
+     * Remaining requests in current window (from x-ratelimit-remaining-api header).
+     * Undefined if header was not present in the last response.
+     */
+    remaining?: number;
+    /**
+     * Maximum requests allowed in current window (from x-ratelimit-limit-api header).
+     * Undefined if header was not present in the last response.
+     */
+    limit?: number;
+    /**
+     * Seconds until the rate limit window resets (from x-ratelimit-reset-api header).
+     * Undefined if header was not present in the last response.
+     */
+    resetInSeconds?: number;
+    /**
+     * Timestamp (ms since epoch) when this state was last updated.
+     */
+    updatedAt: number;
+}
+/**
+ * Configuration for adaptive throttling behavior.
+ * When enabled, requests are proactively delayed when approaching rate limits.
+ */
+interface ThrottleConfig {
+    /**
+     * Enable adaptive throttling.
+     * Must be explicitly set to true to enable.
+     */
+    enabled: boolean;
+    /**
+     * Start throttling when remaining requests falls below this threshold.
+     * @default 20
+     */
+    startThreshold?: number;
+    /**
+     * Minimum delay between requests in milliseconds.
+     * @default 100
+     */
+    minDelay?: number;
+    /**
+     * Maximum delay when nearly exhausted in milliseconds.
+     * @default 2000
+     */
+    maxDelay?: number;
+}
+/**
+ * Configuration for rate limit tracking and callbacks.
+ */
+interface RateLimitConfig {
+    /**
+     * Called after each request with the updated rate limit state.
+     */
+    onUpdate?: (state: RateLimitState) => void;
+    /**
+     * Called when remaining requests falls below the warning threshold.
+     */
+    onWarning?: (state: RateLimitState) => void;
+    /**
+     * Called when a 429 rate limit error is received.
+     * @param state - Current rate limit state
+     * @param retryAfter - Seconds to wait before retrying (if provided by server)
+     */
+    onRateLimited?: (state: RateLimitState, retryAfter?: number) => void;
+    /**
+     * Warning threshold for remaining requests.
+     * When remaining falls below this, onWarning is called.
+     * @default 10
+     */
+    warningThreshold?: number;
+    /**
+     * Optional adaptive throttling configuration.
+     * Disabled by default.
+     */
+    throttle?: ThrottleConfig;
+}
+
+/**
+ * Result from audio upload.
+ */
+interface UploadAudioResult {
+    success: boolean;
+    title: string;
+    message: string;
+}
+/**
+ * API for audio operations.
+ */
+interface AudioAPI {
+    /**
+     * Upload audio/video file for transcription.
+     *
+     * @param params - Upload parameters
+     * @returns Upload result
+     */
+    upload(params: UploadAudioParams): Promise<UploadAudioResult>;
+}
+
+/**
+ * API for transcript mutations.
+ */
+interface TranscriptsMutationsAPI {
+    /**
+     * Delete a transcript.
+     *
+     * Rate limit: 10/min
+     *
+     * @param id - Transcript ID to delete
+     * @returns Deleted transcript (partial fields)
+     */
+    delete(id: string): Promise<Transcript>;
+}
+
+/**
+ * User role in Fireflies.
+ */
+type UserRole = 'admin' | 'user';
+/**
+ * User group member.
+ */
+interface UserGroupMember {
+    user_id: string;
+    email: string;
+}
+/**
+ * User group.
+ */
+interface UserGroup {
+    id: string;
+    name: string;
+    handle: string;
+    members: UserGroupMember[];
+}
+/**
+ * Full user profile.
+ */
+interface UserProfile {
+    /** User ID */
+    user_id: string;
+    /** Also returned as 'id' by setUserRole mutation */
+    id?: string;
+    /** User's email address */
+    email: string;
+    /** User's display name */
+    name: string;
+    /** Role (returned by setUserRole) */
+    role?: UserRole;
+    /** Number of transcripts */
+    num_transcripts?: number;
+    /** Recent meeting timestamp */
+    recent_meeting?: string;
+    /** Recent transcript ID */
+    recent_transcript?: string;
+    /** Minutes consumed */
+    minutes_consumed?: number;
+    /** Whether user is admin */
+    is_admin?: boolean;
+    /** Connected integrations */
+    integrations?: string[] | null;
+    /** User groups */
+    user_groups?: UserGroup[];
+}
+
+/**
+ * API for user mutations.
+ */
+interface UsersMutationsAPI {
+    /**
+     * Set user role (admin or user).
+     *
+     * @param userId - User ID to update
+     * @param role - New role
+     * @returns Updated user (partial fields)
+     */
+    setRole(userId: string, role: UserRole): Promise<UserProfile>;
+}
+
+/**
+ * AI App output for a transcript.
+ */
+interface AIApp {
+    transcript_id: string;
+    user_id: string;
+    app_id: string;
+    created_at: string;
+    title: string;
+    prompt: string;
+    response: string;
+}
+
+/**
+ * API for AI Apps operations.
+ */
+interface AIAppsAPI {
+    /**
+     * List AI App outputs.
+     *
+     * @param params - Optional filter and pagination parameters
+     * @returns Array of AI App outputs
+     */
+    list(params?: AIAppsListParams): Promise<AIApp[]>;
+    /**
+     * Iterate through all AI App outputs matching the filter.
+     * Automatically handles pagination.
+     *
+     * @param params - Filter options (skip and limit are ignored)
+     * @returns Async iterable of AI App outputs
+     */
+    listAll(params?: Omit<AIAppsListParams, 'skip' | 'limit'>): AsyncIterable<AIApp>;
+}
+
+/**
+ * Caption entry in a bite.
+ */
+interface BiteCaption {
+    index: number;
+    text: string;
+    start_time: number;
+    end_time: number;
+    speaker_id: string;
+    speaker_name: string;
+}
+/**
+ * Media source for a bite.
+ */
+interface BiteSource {
+    src: string;
+    type: string;
+}
+/**
+ * User info in bite.
+ */
+interface BiteUser {
+    id: string;
+    name: string;
+    first_name: string;
+    last_name: string;
+    picture?: string;
+}
+/**
+ * Creation source info.
+ */
+interface BiteCreatedFrom {
+    id: string;
+    name: string;
+    type: string;
+    description?: string;
+    duration?: number;
+}
+/**
+ * Soundbite/clip from a transcript.
+ */
+interface Bite {
+    id: string;
+    transcript_id: string;
+    user_id: string;
+    name: string;
+    status: string;
+    summary?: string;
+    summary_status?: string;
+    media_type: string;
+    start_time: number;
+    end_time: number;
+    created_at: string;
+    thumbnail?: string;
+    preview?: string;
+    captions: BiteCaption[];
+    sources: BiteSource[];
+    user?: BiteUser;
+    created_from?: BiteCreatedFrom;
+    privacies?: string[];
+}
+
+/**
+ * API for bite (soundbite/clip) operations.
+ */
+interface BitesAPI {
+    /**
+     * Get a single bite by ID.
+     *
+     * @param id - Bite ID
+     * @returns Bite details
+     */
+    get(id: string): Promise<Bite>;
+    /**
+     * List bites with filtering.
+     *
+     * @param params - Filter and pagination options
+     * @returns Array of bites (max 50 per call)
+     */
+    list(params: BitesListParams): Promise<Bite[]>;
+    /**
+     * Iterate through all bites matching the filter.
+     * Automatically handles pagination.
+     *
+     * @param params - Filter options (skip and limit are ignored)
+     * @returns Async iterable of bites
+     */
+    listAll(params: Omit<BitesListParams, 'skip' | 'limit'>): AsyncIterable<Bite>;
+    /**
+     * Create a new bite from a transcript.
+     *
+     * @param params - Bite creation parameters
+     * @returns Created bite (partial fields)
+     */
+    create(params: CreateBiteParams): Promise<Bite>;
+}
+
+/**
+ * API for meeting operations.
+ */
+interface MeetingsAPI {
+    /**
+     * List active meetings in progress.
+     *
+     * @param params - Optional filter parameters
+     * @returns Array of active meetings
+     */
+    active(params?: ActiveMeetingsParams): Promise<ActiveMeeting[]>;
+    /**
+     * Add Fireflies bot to a live meeting.
+     *
+     * @param params - Meeting parameters
+     * @returns Success result
+     */
+    addBot(params: AddBotParams): Promise<{
+        success: boolean;
+    }>;
+}
+
+/**
+ * Style for formatting action items in Markdown.
+ */
+type ActionItemStyle = 'checkbox' | 'bullet' | 'numbered';
+/**
+ * How to group action items in output.
+ */
+type ActionItemGrouping = 'none' | 'assignee' | 'transcript' | 'date';
+/**
+ * Preset formatting styles for different tools.
+ */
+type ActionItemPreset = 'default' | 'notion' | 'obsidian' | 'github';
+/**
+ * Options for formatting action items as Markdown.
+ */
+interface ActionItemsMarkdownOptions {
+    /** List item style: checkbox (- [ ]), bullet (-), or numbered (1.) */
+    style?: ActionItemStyle;
+    /** Group items by: none, assignee, transcript, or date */
+    groupBy?: ActionItemGrouping;
+    /** Show assignee inline (e.g., @Alice) */
+    includeAssignee?: boolean;
+    /** Show due date inline (e.g., due: Friday) */
+    includeDueDate?: boolean;
+    /** Show meeting title for each item */
+    includeMeetingTitle?: boolean;
+    /** Include summary statistics at the top */
+    includeSummary?: boolean;
+    /** Formatting preset for specific tools */
+    preset?: ActionItemPreset;
+}
+/**
+ * Options for filtering action items.
+ */
+interface ActionItemsFilterOptions {
+    /** Filter to items assigned to these people (case-insensitive) */
+    assignees?: string[];
+    /** Only include items with an assignee */
+    assignedOnly?: boolean;
+    /** Only include items with a due date */
+    datedOnly?: boolean;
+}
+/**
+ * An action item with metadata from its source transcript.
+ */
+interface AggregatedActionItem extends ActionItem {
+    /** ID of the source transcript */
+    transcriptId: string;
+    /** Title of the source transcript */
+    transcriptTitle: string;
+    /** Date string of the source transcript (YYYY-MM-DD format or similar) */
+    transcriptDate: string;
+}
+/**
+ * Result of aggregating action items across multiple transcripts.
+ */
+interface AggregatedActionItemsResult {
+    /** All aggregated action items */
+    items: AggregatedActionItem[];
+    /** Total count of action items */
+    totalItems: number;
+    /** Number of transcripts processed */
+    transcriptsProcessed: number;
+    /** Number of transcripts that had action items */
+    transcriptsWithItems: number;
+    /** Count of items with assignees */
+    assignedItems: number;
+    /** Count of items with due dates */
+    datedItems: number;
+    /** Unique assignees found across all items */
+    assignees: string[];
+    /** Date range of source transcripts */
+    dateRange: {
+        earliest: string;
+        latest: string;
+    };
+}
+/**
+ * Parameters for exporting action items via SDK.
+ */
+interface ExportActionItemsParams {
+    /** Start date for transcript filter (ISO 8601) */
+    fromDate?: string;
+    /** End date for transcript filter (ISO 8601) */
+    toDate?: string;
+    /** Only transcripts owned by authenticated user */
+    mine?: boolean;
+    /** Filter by organizer emails */
+    organizers?: string[];
+    /** Filter by participant emails */
+    participants?: string[];
+    /** Maximum transcripts to process */
+    limit?: number;
+    /** Filter options for action items themselves */
+    filterOptions?: ActionItemsFilterOptions;
+}
+
+/**
+ * Options for the analyzeMeetings helper function.
+ */
+interface MeetingInsightsOptions {
+    /**
+     * Only include stats for these speakers.
+     * Speaker names must match exactly (case-sensitive).
+     */
+    speakers?: string[];
+    /**
+     * Group results by time period.
+     * - 'day': Group by calendar day (YYYY-MM-DD)
+     * - 'week': Group by ISO week (YYYY-Www)
+     * - 'month': Group by month (YYYY-MM)
+     */
+    groupBy?: 'day' | 'week' | 'month';
+    /**
+     * Number of top speakers to include in results.
+     * @default 10
+     */
+    topSpeakersCount?: number;
+    /**
+     * Number of top participants to include in results.
+     * @default 10
+     */
+    topParticipantsCount?: number;
+}
+/**
+ * Aggregate meeting statistics across multiple transcripts.
+ */
+interface MeetingInsights {
+    /** Total number of meetings analyzed */
+    totalMeetings: number;
+    /** Sum of all meeting durations in minutes */
+    totalDurationMinutes: number;
+    /** Average meeting duration in minutes */
+    averageDurationMinutes: number;
+    /** Meeting distribution by day of week */
+    byDayOfWeek: DayOfWeekStats;
+    /** Meeting distribution by time period (if groupBy specified) */
+    byTimeGroup?: TimeGroupStats[];
+    /** Number of unique participants across all meetings */
+    totalUniqueParticipants: number;
+    /** Average number of participants per meeting */
+    averageParticipantsPerMeeting: number;
+    /** Top participants by meeting count */
+    topParticipants: ParticipantStats[];
+    /** Number of unique speakers across all meetings */
+    totalUniqueSpeakers: number;
+    /** Top speakers by talk time */
+    topSpeakers: SpeakerInsightStats[];
+    /** ISO date of the earliest meeting */
+    earliestMeeting: string;
+    /** ISO date of the latest meeting */
+    latestMeeting: string;
+}
+/**
+ * Meeting statistics grouped by day of week.
+ */
+interface DayOfWeekStats {
+    monday: DayStats;
+    tuesday: DayStats;
+    wednesday: DayStats;
+    thursday: DayStats;
+    friday: DayStats;
+    saturday: DayStats;
+    sunday: DayStats;
+}
+/**
+ * Statistics for a single day of week.
+ */
+interface DayStats {
+    /** Number of meetings on this day */
+    count: number;
+    /** Total duration of meetings on this day in minutes */
+    totalMinutes: number;
+}
+/**
+ * Meeting statistics grouped by time period.
+ */
+interface TimeGroupStats {
+    /**
+     * Period identifier:
+     * - For 'day': "YYYY-MM-DD" (e.g., "2024-01-15")
+     * - For 'week': "YYYY-Www" (e.g., "2024-W03")
+     * - For 'month': "YYYY-MM" (e.g., "2024-01")
+     */
+    period: string;
+    /** Number of meetings in this period */
+    count: number;
+    /** Total duration of meetings in this period in minutes */
+    totalMinutes: number;
+    /** Average meeting duration in this period in minutes */
+    averageMinutes: number;
+}
+/**
+ * Statistics for a single participant.
+ */
+interface ParticipantStats {
+    /** Participant email address */
+    email: string;
+    /** Number of meetings this participant attended */
+    meetingCount: number;
+    /** Total time spent in meetings in minutes */
+    totalMinutes: number;
+}
+/**
+ * Statistics for a single speaker.
+ */
+interface SpeakerInsightStats {
+    /** Speaker name from transcript */
+    name: string;
+    /** Number of meetings where this speaker spoke */
+    meetingCount: number;
+    /** Total talk time in seconds */
+    totalTalkTimeSeconds: number;
+    /** Average talk time per meeting in seconds */
+    averageTalkTimeSeconds: number;
+}
+
+/**
+ * Search-related types for searching across transcript content.
+ */
+/**
+ * Options for searching transcripts.
+ */
+interface SearchParams {
+    /**
+     * Whether to match case when searching.
+     * @default false
+     */
+    caseSensitive?: boolean;
+    /**
+     * Where to search: 'title' searches transcript titles only,
+     * 'sentences' searches transcript content, 'all' searches both.
+     * @default 'sentences'
+     */
+    scope?: 'title' | 'sentences' | 'all';
+    /**
+     * Filter results to only include sentences from these speakers.
+     * Case-insensitive matching.
+     */
+    speakers?: string[];
+    /**
+     * Only include sentences marked as questions by AI.
+     */
+    filterQuestions?: boolean;
+    /**
+     * Only include sentences marked as tasks/action items by AI.
+     */
+    filterTasks?: boolean;
+    /**
+     * Number of sentences to include before and after each match.
+     * @default 1
+     */
+    contextLines?: number;
+    /**
+     * Filter transcripts from this date (ISO 8601 format).
+     */
+    fromDate?: string;
+    /**
+     * Filter transcripts to this date (ISO 8601 format).
+     */
+    toDate?: string;
+    /**
+     * Only include transcripts owned by the authenticated user.
+     */
+    mine?: boolean;
+    /**
+     * Filter by organizer email addresses.
+     */
+    organizers?: string[];
+    /**
+     * Filter by participant email addresses.
+     */
+    participants?: string[];
+    /**
+     * Filter by user ID.
+     */
+    user_id?: string;
+    /**
+     * Filter by channel ID.
+     */
+    channel_id?: string;
+    /**
+     * Maximum number of transcripts to search.
+     * If not specified, searches all matching transcripts.
+     */
+    limit?: number;
+}
+/**
+ * Options for the pure searchTranscript helper function.
+ */
+interface SearchTranscriptOptions {
+    /**
+     * The search query string.
+     */
+    query: string;
+    /**
+     * Whether to match case when searching.
+     * @default false
+     */
+    caseSensitive?: boolean;
+    /**
+     * Filter results to only include sentences from these speakers.
+     * Case-insensitive matching.
+     */
+    speakers?: string[];
+    /**
+     * Only include sentences marked as questions by AI.
+     */
+    filterQuestions?: boolean;
+    /**
+     * Only include sentences marked as tasks/action items by AI.
+     */
+    filterTasks?: boolean;
+    /**
+     * Number of sentences to include before and after each match.
+     * @default 1
+     */
+    contextLines?: number;
+}
+/**
+ * A single matched sentence with context from a transcript search.
+ */
+interface SearchMatch {
+    /**
+     * ID of the transcript containing the match.
+     */
+    transcriptId: string;
+    /**
+     * Title of the transcript containing the match.
+     */
+    transcriptTitle: string;
+    /**
+     * Date of the transcript (ISO 8601 format).
+     */
+    transcriptDate: string;
+    /**
+     * URL to view the transcript on Fireflies.ai.
+     */
+    transcriptUrl: string;
+    /**
+     * The matched sentence details.
+     */
+    sentence: {
+        /**
+         * Index of the sentence in the transcript (0-based).
+         */
+        index: number;
+        /**
+         * Text content of the sentence.
+         */
+        text: string;
+        /**
+         * Name of the speaker.
+         */
+        speakerName: string;
+        /**
+         * Start time in seconds.
+         */
+        startTime: number;
+        /**
+         * End time in seconds.
+         */
+        endTime: number;
+        /**
+         * Whether the AI marked this sentence as a question.
+         */
+        isQuestion: boolean;
+        /**
+         * Whether the AI marked this sentence as a task/action item.
+         */
+        isTask: boolean;
+    };
+    /**
+     * Context sentences before and after the match.
+     */
+    context: {
+        /**
+         * Sentences appearing before the match.
+         */
+        before: Array<{
+            speakerName: string;
+            text: string;
+        }>;
+        /**
+         * Sentences appearing after the match.
+         */
+        after: Array<{
+            speakerName: string;
+            text: string;
+        }>;
+    };
+}
+/**
+ * Results from a transcript search operation.
+ */
+interface SearchResults {
+    /**
+     * The original search query.
+     */
+    query: string;
+    /**
+     * The search options that were used.
+     */
+    options: SearchParams;
+    /**
+     * Total number of matching sentences found.
+     */
+    totalMatches: number;
+    /**
+     * Number of transcripts that were searched.
+     */
+    transcriptsSearched: number;
+    /**
+     * Number of transcripts that had at least one match.
+     */
+    transcriptsWithMatches: number;
+    /**
+     * All matching sentences with context.
+     */
+    matches: SearchMatch[];
+}
+
+/**
+ * API for transcript operations.
+ */
+interface TranscriptsAPI {
+    /**
+     * Get a single transcript by ID.
+     *
+     * @param id - Transcript ID
+     * @param params - Optional parameters to exclude heavy fields
+     * @returns Transcript (fields depend on params)
+     * @throws NotFoundError if transcript doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // Full transcript with all fields
+     * const full = await client.transcripts.get('id');
+     *
+     * // Metadata only (faster, smaller response)
+     * const meta = await client.transcripts.get('id', {
+     *   includeSentences: false,
+     *   includeSummary: false,
+     * });
+     * ```
+     */
+    get(id: string, params?: TranscriptGetParams): Promise<Transcript>;
+    /**
+     * List transcripts with optional filtering.
+     *
+     * @param params - Filter and pagination options
+     * @returns Array of transcripts (max 50 per call)
+     */
+    list(params?: TranscriptsListParams): Promise<Transcript[]>;
+    /**
+     * Get just the summary for a transcript.
+     * Lighter weight than fetching the full transcript.
+     *
+     * @param id - Transcript ID
+     * @returns Summary object
+     */
+    getSummary(id: string): Promise<Summary | null>;
+    /**
+     * Iterate through all transcripts matching the filter.
+     * Automatically handles pagination.
+     *
+     * @param params - Filter options (skip and limit are ignored)
+     * @returns Async iterable of transcripts
+     *
+     * @example
+     * ```typescript
+     * for await (const transcript of client.transcripts.listAll({ mine: true })) {
+     *   console.log(transcript.title);
+     * }
+     * ```
+     */
+    listAll(params?: Omit<TranscriptsListParams, 'skip' | 'limit'>): AsyncIterable<Transcript>;
+    /**
+     * Search across transcripts for matching sentences.
+     *
+     * This method first queries for transcripts matching the keyword,
+     * then fetches each transcript with sentences and searches locally
+     * for detailed matches with speaker filtering, question/task filtering,
+     * and context extraction.
+     *
+     * @param query - The search query string
+     * @param params - Search options including filters and context settings
+     * @returns Search results with matches grouped by transcript
+     *
+     * @example
+     * ```typescript
+     * const results = await client.transcripts.search('budget', {
+     *   speakers: ['Alice'],
+     *   filterQuestions: true,
+     *   fromDate: '2024-01-01',
+     *   contextLines: 2,
+     * });
+     *
+     * console.log(`Found ${results.totalMatches} matches`);
+     * for (const match of results.matches) {
+     *   console.log(`${match.sentence.speakerName}: ${match.sentence.text}`);
+     * }
+     * ```
+     */
+    search(query: string, params?: SearchParams): Promise<SearchResults>;
+    /**
+     * Compute aggregate meeting insights across transcripts.
+     *
+     * Fetches transcripts matching the filter criteria and computes
+     * aggregate statistics including duration totals, day of week
+     * distribution, participant counts, and speaker talk times.
+     *
+     * @param params - Filtering and analysis options
+     * @returns Aggregate meeting insights
+     *
+     * @example
+     * ```typescript
+     * const insights = await client.transcripts.insights({
+     *   fromDate: '2024-01-01',
+     *   toDate: '2024-01-31',
+     *   mine: true,
+     *   groupBy: 'week',
+     * });
+     *
+     * console.log(`${insights.totalMeetings} meetings`);
+     * console.log(`${insights.totalDurationMinutes} total minutes`);
+     * console.log(`Busiest day: ${getBusiestDay(insights.byDayOfWeek)}`);
+     * ```
+     */
+    insights(params?: TranscriptsInsightsParams): Promise<MeetingInsights>;
+    /**
+     * Export action items from multiple transcripts.
+     *
+     * Fetches transcripts matching the filter criteria, extracts action
+     * items from each, and aggregates them with source metadata.
+     *
+     * @param params - Filtering options for transcripts and action items
+     * @returns Aggregated action items with statistics
+     *
+     * @example
+     * ```typescript
+     * const result = await client.transcripts.exportActionItems({
+     *   fromDate: '2024-01-01',
+     *   mine: true,
+     *   filterOptions: { assignedOnly: true },
+     * });
+     *
+     * console.log(`${result.totalItems} action items from ${result.transcriptsProcessed} meetings`);
+     * for (const item of result.items) {
+     *   console.log(`${item.text} (${item.transcriptTitle})`);
+     * }
+     * ```
+     */
+    exportActionItems(params?: ExportActionItemsParams): Promise<AggregatedActionItemsResult>;
+}
+
+/**
+ * API for user operations.
+ */
+interface UsersAPI {
+    /**
+     * Get current user (API key owner).
+     *
+     * @returns Current user profile
+     */
+    me(): Promise<UserProfile>;
+    /**
+     * Get user by ID.
+     *
+     * @param id - User ID
+     * @returns User profile
+     */
+    get(id: string): Promise<UserProfile>;
+    /**
+     * List all team users.
+     *
+     * @returns Array of user profiles
+     */
+    list(): Promise<UserProfile[]>;
+}
+
+/**
+ * A single transcription chunk from the realtime stream.
+ *
+ * Chunks are sent progressively as speech is transcribed.
+ * The same chunk_id will be sent multiple times with updated text.
+ * Use `isFinal` to determine if a chunk is complete.
+ */
+interface TranscriptionChunk {
+    /** Unique identifier - same ID means this is an update to a previous chunk */
+    chunk_id: string;
+    /** Name of the speaker */
+    speaker_name: string;
+    /** Transcribed text (grows as more words are recognized) */
+    text: string;
+    /** Start time in seconds */
+    start_time: number;
+    /** End time in seconds */
+    end_time: number;
+    /** True if this is the final version of the chunk (next chunk_id has appeared) */
+    isFinal: boolean;
+}
+/**
+ * Realtime connection configuration.
+ */
+interface RealtimeConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Transcript/meeting ID to stream */
+    transcriptId: string;
+    /** WebSocket base URL (default: wss://api.fireflies.ai) */
+    wsUrl?: string;
+    /** Socket.IO path (default: /ws/realtime) */
+    wsPath?: string;
+    /** Connection timeout in ms (default: 20000) */
+    timeout?: number;
+    /** Chunk inactivity timeout in ms - reconnect if no chunks for this long (default: 20000) */
+    chunkTimeout?: number;
+    /** Auto-reconnect on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Max reconnection attempts (default: 10) */
+    maxReconnectAttempts?: number;
+    /** Base delay between reconnects in ms (default: 5000) */
+    reconnectDelay?: number;
+    /** Max delay between reconnects in ms (default: 60000) */
+    maxReconnectDelay?: number;
+}
+/**
+ * Events emitted by RealtimeStream.
+ */
+interface RealtimeEvents {
+    /** Connection established */
+    connected: () => void;
+    /** Transcription chunk received */
+    chunk: (chunk: TranscriptionChunk) => void;
+    /** Connection closed */
+    disconnected: (reason: string) => void;
+    /** Error occurred */
+    error: (error: Error) => void;
+    /** Reconnecting after disconnect */
+    reconnecting: (attempt: number) => void;
+}
+
+type EventHandler<K extends keyof RealtimeEvents> = RealtimeEvents[K];
+/**
+ * Realtime transcription stream.
+ *
+ * Chunks are emitted progressively as speech is transcribed. The same chunk_id
+ * will be emitted multiple times with updated text. Use `chunk.isFinal` to
+ * determine if a chunk is complete (the next chunk_id has appeared).
+ *
+ * @example Event-based (all updates)
+ * ```typescript
+ * stream.on('chunk', (chunk) => {
+ *   // Updates display in real-time
+ *   updateDisplay(chunk.chunk_id, chunk.text);
+ * });
+ * ```
+ *
+ * @example Event-based (final chunks only)
+ * ```typescript
+ * stream.on('chunk', (chunk) => {
+ *   if (chunk.isFinal) {
+ *     console.log(`[${chunk.speaker_name}]: ${chunk.text}`);
+ *   }
+ * });
+ * ```
+ *
+ * @example Async iterator
+ * ```typescript
+ * for await (const chunk of stream) {
+ *   console.log(`[${chunk.speaker_name}]: ${chunk.text}`);
+ * }
+ * ```
+ */
+declare class RealtimeStream implements AsyncIterable<TranscriptionChunk> {
+    private connection;
+    private listeners;
+    private buffer;
+    private waiters;
+    private closed;
+    private lastChunkId;
+    private lastChunk;
+    constructor(config: RealtimeConfig);
+    /**
+     * Connect to the realtime stream.
+     * @throws AuthenticationError if authentication fails
+     * @throws ConnectionError if connection fails
+     * @throws TimeoutError if connection times out
+     */
+    connect(): Promise<void>;
+    private setupHandlers;
+    /**
+     * Register an event listener.
+     * @param event - Event name
+     * @param handler - Event handler
+     */
+    on<K extends keyof RealtimeEvents>(event: K, handler: EventHandler<K>): this;
+    /**
+     * Remove an event listener.
+     * @param event - Event name
+     * @param handler - Event handler to remove
+     */
+    off<K extends keyof RealtimeEvents>(event: K, handler: EventHandler<K>): this;
+    /**
+     * Emit a chunk to both event listeners and async iterator buffer.
+     * Used for final chunks that should be yielded by the iterator.
+     */
+    private emitChunk;
+    private emit;
+    /**
+     * AsyncIterable implementation for `for await` loops.
+     */
+    [Symbol.asyncIterator](): AsyncIterator<TranscriptionChunk>;
+    /**
+     * Close the stream and disconnect.
+     */
+    close(): void;
+    /**
+     * Whether the stream is currently connected.
+     */
+    get connected(): boolean;
+}
+
+/**
+ * API for realtime transcription streaming.
+ */
+interface RealtimeAPI {
+    /**
+     * Connect to a live transcription stream.
+     *
+     * @param transcriptId - The meeting/transcript ID to stream
+     * @returns Connected RealtimeStream
+     *
+     * @example Event-based
+     * ```typescript
+     * const stream = await client.realtime.connect('meeting-123');
+     * stream.on('chunk', (chunk) => {
+     *   console.log(`[${chunk.speaker_name}]: ${chunk.text}`);
+     * });
+     * ```
+     */
+    connect(transcriptId: string): Promise<RealtimeStream>;
+    /**
+     * Stream transcription chunks as an async iterable.
+     * Handles connection automatically.
+     *
+     * @param transcriptId - The meeting/transcript ID to stream
+     * @returns AsyncIterable of transcription chunks
+     *
+     * @example
+     * ```typescript
+     * for await (const chunk of client.realtime.stream('meeting-123')) {
+     *   console.log(`[${chunk.speaker_name}]: ${chunk.text}`);
+     * }
+     * ```
+     */
+    stream(transcriptId: string): AsyncIterable<TranscriptionChunk>;
+}
+
+/**
+ * Main client for the Fireflies API.
+ *
+ * @example
+ * ```typescript
+ * import { FirefliesClient } from 'fireflies-api';
+ *
+ * const client = new FirefliesClient({
+ *   apiKey: process.env.FIREFLIES_API_KEY!,
+ * });
+ *
+ * // List recent transcripts
+ * const transcripts = await client.transcripts.list({ limit: 10 });
+ *
+ * // Get a specific transcript
+ * const transcript = await client.transcripts.get('transcript-id');
+ *
+ * // Get current user
+ * const me = await client.users.me();
+ *
+ * // List team members
+ * const team = await client.users.list();
+ *
+ * // List bites
+ * const bites = await client.bites.list({ mine: true });
+ *
+ * // Check active meetings
+ * const meetings = await client.meetings.active();
+ *
+ * // List AI App outputs
+ * const apps = await client.aiApps.list({ transcript_id: 'abc123' });
+ * ```
+ */
+declare class FirefliesClient {
+    private readonly graphql;
+    /**
+     * Transcript operations: list, get, search, delete.
+     */
+    readonly transcripts: TranscriptsAPI & TranscriptsMutationsAPI;
+    /**
+     * User operations: me, get, list, setRole.
+     */
+    readonly users: UsersAPI & UsersMutationsAPI;
+    /**
+     * Bite operations: get, list, create.
+     */
+    readonly bites: BitesAPI;
+    /**
+     * Meeting operations: active meetings, add bot.
+     */
+    readonly meetings: MeetingsAPI;
+    /**
+     * Audio operations: upload audio for transcription.
+     */
+    readonly audio: AudioAPI;
+    /**
+     * AI Apps operations: list outputs.
+     */
+    readonly aiApps: AIAppsAPI;
+    /**
+     * Realtime transcription streaming.
+     */
+    readonly realtime: RealtimeAPI;
+    /**
+     * Create a new Fireflies client.
+     *
+     * @param config - Client configuration
+     * @throws FirefliesError if API key is missing
+     */
+    constructor(config: FirefliesConfig);
+    /**
+     * Get the current rate limit state.
+     * Returns undefined if rate limit tracking is not configured.
+     *
+     * @example
+     * ```typescript
+     * const client = new FirefliesClient({
+     *   apiKey: '...',
+     *   rateLimit: { warningThreshold: 10 }
+     * });
+     *
+     * await client.users.me();
+     * console.log(client.rateLimits);
+     * // { remaining: 59, limit: 60, resetInSeconds: 60, updatedAt: 1706299500000 }
+     * ```
+     */
+    get rateLimits(): RateLimitState | undefined;
+}
+
+/**
+ * Webhook event types supported by Fireflies.
+ * Currently only "Transcription completed" is available.
+ */
+type WebhookEventType = 'Transcription completed';
+/**
+ * Webhook payload received from Fireflies.
+ * Sent when configured webhook events occur.
+ */
+interface WebhookPayload {
+    /** Meeting/transcript ID */
+    meetingId: string;
+    /** The event that triggered this webhook */
+    eventType: WebhookEventType;
+    /** Custom reference ID set during upload (optional) */
+    clientReferenceId?: string;
+}
+/**
+ * Options for verifying a webhook signature.
+ */
+interface VerifyOptions {
+    /** Raw request body (string) or parsed payload (object) */
+    payload: string | object;
+    /** x-hub-signature header value */
+    signature: string;
+    /** Your webhook secret (16-32 characters) */
+    secret: string;
+}
+/**
+ * Options for parsing a webhook payload with optional verification.
+ */
+interface ParseOptions {
+    /** x-hub-signature header value for verification */
+    signature?: string;
+    /** Your webhook secret for verification */
+    secret?: string;
+}
+
+export { type TranscriptsAPI as $, type ActionItemsFilterOptions as A, type Bite as B, type CreateBiteParams as C, type DayOfWeekStats as D, type ExportActionItemsParams as E, FirefliesClient as F, type MeetingsAPI as G, type ParticipantStats as H, type RateLimitState as I, type RealtimeAPI as J, type RealtimeConfig as K, type RealtimeEvents as L, type MeetingInsightsOptions as M, RealtimeStream as N, type RetryConfig as O, type ParseOptions as P, type SearchParams as Q, type RateLimitConfig as R, type SearchTranscriptOptions as S, type TranscriptionChunk as T, type SearchResults as U, type VerifyOptions as V, type WebhookPayload as W, type SpeakerInsightStats as X, type ThrottleConfig as Y, type TimeGroupStats as Z, type TranscriptGetParams as _, type AggregatedActionItemsResult as a, type TranscriptsInsightsParams as a0, type TranscriptsMutationsAPI as a1, type TranscriptsQueryScope as a2, type UploadAudioAttendee as a3, type UploadAudioParams as a4, type UserGroup as a5, type UserGroupMember as a6, type UserProfile as a7, type UserRole as a8, type UsersAPI as a9, type UsersMutationsAPI as aa, type WebhookEventType as ab, type ActionItemsMarkdownOptions as b, type MeetingInsights as c, type TranscriptsListParams as d, type SearchMatch as e, type AIApp as f, type AIAppsAPI as g, type AIAppsListParams as h, type ActionItemGrouping as i, type ActionItemPreset as j, type ActionItemStyle as k, type ActiveMeeting as l, type ActiveMeetingsParams as m, type AddBotParams as n, type AggregatedActionItem as o, type AudioAPI as p, type BiteCaption as q, type BiteCreatedFrom as r, type BiteSource as s, type BiteUser as t, type BitesAPI as u, type BitesListParams as v, type DayStats as w, type FirefliesConfig as x, type MeetingPrivacy as y, type MeetingState as z };