@elizaos/plugin-twitter 1.0.8 → 1.0.13

package/dist/index.d.ts

@@ -1,7 +1,41 @@
-import { IAgentRuntime, Memory, State, ChannelType, Plugin as Plugin$1, Service, UUID } from '@elizaos/core';
-import { Cookie } from 'tough-cookie';
-import { PollV2, TTweetv2Expansion, TTweetv2TweetField, TTweetv2PollField, TTweetv2MediaField, TTweetv2UserField, TTweetv2PlaceField } from 'twitter-api-v2';
-import { EventEmitter } from 'node:events';
+import { IAgentRuntime, Memory, State, ChannelType, Plugin, Service, UUID } from '@elizaos/core';
+import * as twitter_api_v2 from 'twitter-api-v2';
+import { TwitterApi, PollV2, TTweetv2Expansion, TTweetv2TweetField, TTweetv2PollField, TTweetv2MediaField, TTweetv2UserField, TTweetv2PlaceField } from 'twitter-api-v2';
+
+/**
+ * Twitter API v2 authentication using developer credentials
+ */
+declare class TwitterAuth {
+    private appKey;
+    private appSecret;
+    private accessToken;
+    private accessSecret;
+    private v2Client;
+    private authenticated;
+    private profile?;
+    constructor(appKey: string, appSecret: string, accessToken: string, accessSecret: string);
+    private initializeClient;
+    /**
+     * Get the Twitter API v2 client
+     */
+    getV2Client(): TwitterApi;
+    /**
+     * Check if authenticated
+     */
+    isLoggedIn(): Promise<boolean>;
+    /**
+     * Get current user profile
+     */
+    me(): Promise<Profile | undefined>;
+    /**
+     * Logout (clear credentials)
+     */
+    logout(): Promise<void>;
+    /**
+     * For compatibility - always returns true since we use API keys
+     */
+    hasToken(): boolean;
+}
 
 /**
  * Represents an array type for parameters used in the fetch function,
@@ -99,191 +133,29 @@ interface Profile {
 }
 
 /**
- * Interface representing a GrokMessage object.
- * @interface
- * @property {string} role - The role of the message, can be either "user" or "assistant".
- * @property {string} content - The content of the message.
- */
-interface GrokMessage {
-    role: "user" | "assistant";
-    content: string;
-}
-/**
- * Interface for specifying options when using GrokChat.
- * @typedef {Object} GrokChatOptions
- * @property {GrokMessage[]} messages - Array of GrokMessage objects
- * @property {string} [conversationId] - Optional ID for the conversation. Will create new if not provided
- * @property {boolean} [returnSearchResults] - Flag to indicate whether to return search results
- * @property {boolean} [returnCitations] - Flag to indicate whether to return citations
- */
-interface GrokChatOptions {
-    messages: GrokMessage[];
-    conversationId?: string;
-    returnSearchResults?: boolean;
-    returnCitations?: boolean;
-}
-/**
- * Interface representing a Grok rate limit response.
- * @typedef { Object } GrokRateLimit
- * @property { boolean } isRateLimited - Flag indicating if the rate limit is in effect.
- * @property { string } message - The message associated with the rate limit.
- * @property { Object } upsellInfo - Object containing additional information about the rate limit (optional).
- * @property { string } upsellInfo.usageLimit - The usage limit imposed by the rate limit.
- * @property { string } upsellInfo.quotaDuration - The duration of the quota for the rate limit.
- * @property { string } upsellInfo.title - The title related to the rate limit.
- * @property { string } upsellInfo.message - Additional message related to the rate limit.
- */
-interface GrokRateLimit {
-    isRateLimited: boolean;
-    message: string;
-    upsellInfo?: {
-        usageLimit: string;
-        quotaDuration: string;
-        title: string;
-        message: string;
-    };
-}
-/**
- * Interface for the response from the GrokChat API.
- * @typedef {object} GrokChatResponse
- * @property {string} conversationId - The ID of the conversation.
- * @property {string} message - The message content.
- * @property {Array<GrokMessage>} messages - An array of GrokMessage objects.
- * @property {Array<any>} [webResults] - Optional array of web results.
- * @property {object} [metadata] - Optional metadata object.
- * @property {object} [rateLimit] - Optional rate limit information.
- */
-interface GrokChatResponse {
-    conversationId: string;
-    message: string;
-    messages: GrokMessage[];
-    webResults?: any[];
-    metadata?: any;
-    rateLimit?: GrokRateLimit;
-}
-
-/**
- * Represents a direct message object.
- * @typedef {Object} DirectMessage
- * @property {string} id - The unique identifier of the direct message.
- * @property {string} text - The text content of the direct message.
- * @property {string} senderId - The unique identifier of the sender of the direct message.
- * @property {string} recipientId - The unique identifier of the recipient of the direct message.
- * @property {string} createdAt - The timestamp when the direct message was created.
- * @property {string[]} [mediaUrls] - An optional array of URLs for any media included in the direct message.
- * @property {string} [senderScreenName] - The screen name of the sender of the direct message.
- * @property {string} [recipientScreenName] - The screen name of the recipient of the direct message.
- */
-interface DirectMessage {
-    id: string;
-    text: string;
-    senderId: string;
-    recipientId: string;
-    createdAt: string;
-    mediaUrls?: string[];
-    senderScreenName?: string;
-    recipientScreenName?: string;
-}
-/**
- * Represents a direct message conversation.
- * @typedef {Object} DirectMessageConversation
- * @property {string} conversationId - The ID of the conversation.
- * @property {DirectMessage[]} messages - An array of DirectMessage objects representing the messages in the conversation.
- * @property {Object[]} participants - An array of participant objects with IDs and screen names.
- * @property {string} participants.id - The ID of the participant.
- * @property {string} participants.screenName - The screen name of the participant.
- */
-interface DirectMessageConversation {
-    conversationId: string;
-    messages: DirectMessage[];
-    participants: {
-        id: string;
-        screenName: string;
-    }[];
-}
-/**
- * Interface representing the response of direct messages.
- * @typedef {Object} DirectMessagesResponse
- * @property {DirectMessageConversation[]} conversations - Array of direct message conversations.
- * @property {TwitterUser[]} users - Array of Twitter users.
- * @property {string} [cursor] - Optional cursor for pagination.
- * @property {string} [lastSeenEventId] - Optional ID of the last seen event.
- * @property {string} [trustedLastSeenEventId] - Optional ID of the last seen trusted event.
- * @property {string} [untrustedLastSeenEventId] - Optional ID of the last seen untrusted event.
- * @property {Object} [inboxTimelines] - Optional object containing trusted and untrusted inbox timelines.
- * @property {Object} [inboxTimelines.trusted] - Object containing status and optional minimum entry ID for trusted inbox timeline.
- * @property {string} inboxTimelines.trusted.status - Status of the trusted inbox timeline.
- * @property {string} [inboxTimelines.trusted.minEntryId] - Optional minimum entry ID for the trusted inbox timeline.
- * @property {Object} [inboxTimelines.untrusted] - Object containing status and optional minimum entry ID for untrusted inbox timeline.
- * @property {string} inboxTimelines.untrusted.status - Status of the untrusted inbox timeline.
- * @property {string} [inboxTimelines.untrusted.minEntryId] - Optional minimum entry ID for the untrusted inbox timeline.
- * @property {string} userId - ID of the user.
+ * A paginated tweets API response. The `next` field can be used to fetch the next page of results,
+ * and the `previous` can be used to fetch the previous results (or results created after the
+ * initial request)
  */
-interface DirectMessagesResponse {
-    conversations: DirectMessageConversation[];
-    users: TwitterUser[];
-    cursor?: string;
-    lastSeenEventId?: string;
-    trustedLastSeenEventId?: string;
-    untrustedLastSeenEventId?: string;
-    inboxTimelines?: {
-        trusted?: {
-            status: string;
-            minEntryId?: string;
-        };
-        untrusted?: {
-            status: string;
-            minEntryId?: string;
-        };
-    };
-    userId: string;
-}
 /**
- * Interface representing a Twitter user.
- * @property {string} id - The unique identifier of the user.
- * @property {string} screenName - The user's screen name.
- * @property {string} name - The user's full name.
- * @property {string} profileImageUrl - The URL of the user's profile image.
- * @property {string} [description] - The user's profile description.
- * @property {boolean} [verified] - Whether the user is a verified account.
- * @property {boolean} [protected] - Whether the user has a protected account.
- * @property {number} [followersCount] - The number of followers the user has.
- * @property {number} [friendsCount] - The number of friends the user has.
+ * Interface representing the response from a query tweets request.
+ * @typedef {Object} QueryTweetsResponse
+ * @property {Tweet[]} tweets - An array of Tweet objects.
+ * @property {string} [next] - Optional. The token for fetching the next page of tweets.
+ * @property {string} [previous] - Optional. The token for fetching the previous page of tweets.
  */
-interface TwitterUser {
-    id: string;
-    screenName: string;
-    name: string;
-    profileImageUrl: string;
-    description?: string;
-    verified?: boolean;
-    protected?: boolean;
-    followersCount?: number;
-    friendsCount?: number;
+interface QueryTweetsResponse {
+    tweets: Tweet$1[];
+    next?: string;
+    previous?: string;
 }
 /**
- * Interface representing the response of sending a direct message.
- * @typedef {Object} SendDirectMessageResponse
- * @property {Array<{message: {id: string, time: string, affects_sort: boolean, conversation_id: string, message_data: {id: string, time: string, recipient_id: string, sender_id: string, text: string}}}>} entries - Array of message entries.
- * @property {Object.<string, TwitterUser>} users - Record of Twitter users.
+ * A paginated profiles API response. The `next` field can be used to fetch the next page of results.
  */
-interface SendDirectMessageResponse {
-    entries: {
-        message: {
-            id: string;
-            time: string;
-            affects_sort: boolean;
-            conversation_id: string;
-            message_data: {
-                id: string;
-                time: string;
-                recipient_id: string;
-                sender_id: string;
-                text: string;
-            };
-        };
-    }[];
-    users: Record<string, TwitterUser>;
+interface QueryProfilesResponse {
+    profiles: Profile[];
+    next?: string;
+    previous?: string;
 }
 
 /**
@@ -485,32 +357,6 @@ interface Retweeter {
 }
 type TweetQuery = Partial<Tweet$1> | ((tweet: Tweet$1) => boolean | Promise<boolean>);
 
-/**
- * A paginated tweets API response. The `next` field can be used to fetch the next page of results,
- * and the `previous` can be used to fetch the previous results (or results created after the
- * initial request)
- */
-/**
- * Interface representing the response from a query tweets request.
- * @typedef {Object} QueryTweetsResponse
- * @property {Tweet[]} tweets - An array of Tweet objects.
- * @property {string} [next] - Optional. The token for fetching the next page of tweets.
- * @property {string} [previous] - Optional. The token for fetching the previous page of tweets.
- */
-interface QueryTweetsResponse {
-    tweets: Tweet$1[];
-    next?: string;
-    previous?: string;
-}
-/**
- * A paginated profiles API response. The `next` field can be used to fetch the next page of results.
- */
-interface QueryProfilesResponse {
-    profiles: Profile[];
-    next?: string;
-    previous?: string;
-}
-
 /**
  * The categories that can be used in Twitter searches.
  */
@@ -526,202 +372,6 @@ declare enum SearchMode {
     Users = 4
 }
 
-/**
- * Represents a Community that can host Spaces.
- */
-/**
- * Represents a community entity.
- * @typedef {object} Community
- * @property {string} id - The ID of the community.
- * @property {string} name - The name of the community.
- * @property {string} rest_id - The ID of the associated restaurant.
- */
-interface Community {
-    id: string;
-    name: string;
-    rest_id: string;
-}
-/**
- * Represents a Subtopic within a Category.
- */
-interface Subtopic {
-    icon_url: string;
-    name: string;
-    topic_id: string;
-}
-/**
- * Represents the result details of a Creator.
- */
-interface CreatorResult {
-    __typename: string;
-    id: string;
-    rest_id: string;
-    affiliates_highlighted_label: Record<string, any>;
-    has_graduated_access: boolean;
-    is_blue_verified: boolean;
-    profile_image_shape: string;
-    legacy: {
-        following: boolean;
-        can_dm: boolean;
-        can_media_tag: boolean;
-        created_at: string;
-        default_profile: boolean;
-        default_profile_image: boolean;
-        description: string;
-        entities: {
-            description: {
-                urls: any[];
-            };
-        };
-        fast_followers_count: number;
-        favourites_count: number;
-        followers_count: number;
-        friends_count: number;
-        has_custom_timelines: boolean;
-        is_translator: boolean;
-        listed_count: number;
-        location: string;
-        media_count: number;
-        name: string;
-        needs_phone_verification: boolean;
-        normal_followers_count: number;
-        pinned_tweet_ids_str: string[];
-        possibly_sensitive: boolean;
-        profile_image_url_https: string;
-        profile_interstitial_type: string;
-        screen_name: string;
-        statuses_count: number;
-        translator_type: string;
-        verified: boolean;
-        want_retweets: boolean;
-        withheld_in_countries: string[];
-    };
-    tipjar_settings: Record<string, any>;
-}
-/**
- * Represents user results within an Admin.
- */
-interface UserResults {
-    rest_id: string;
-    result: {
-        __typename: string;
-        identity_profile_labels_highlighted_label: Record<string, any>;
-        is_blue_verified: boolean;
-        legacy: Record<string, any>;
-    };
-}
-/**
- * Represents an Admin participant in an Audio Space.
- */
-interface Admin {
-    periscope_user_id: string;
-    start: number;
-    twitter_screen_name: string;
-    display_name: string;
-    avatar_url: string;
-    is_verified: boolean;
-    is_muted_by_admin: boolean;
-    is_muted_by_guest: boolean;
-    user_results: UserResults;
-}
-/**
- * Represents Participants in an Audio Space.
- */
-interface Participants {
-    total: number;
-    admins: Admin[];
-    speakers: any[];
-    listeners: any[];
-}
-/**
- * Represents Metadata of an Audio Space.
- */
-interface Metadata {
-    rest_id: string;
-    state: string;
-    media_key: string;
-    created_at: number;
-    started_at: number;
-    ended_at: string;
-    updated_at: number;
-    content_type: string;
-    creator_results: {
-        result: CreatorResult;
-    };
-    conversation_controls: number;
-    disallow_join: boolean;
-    is_employee_only: boolean;
-    is_locked: boolean;
-    is_muted: boolean;
-    is_space_available_for_clipping: boolean;
-    is_space_available_for_replay: boolean;
-    narrow_cast_space_type: number;
-    no_incognito: boolean;
-    total_replay_watched: number;
-    total_live_listeners: number;
-    tweet_results: Record<string, any>;
-    max_guest_sessions: number;
-    max_admin_capacity: number;
-}
-/**
- * Represents Sharings within an Audio Space.
- */
-interface Sharings {
-    items: any[];
-    slice_info: Record<string, any>;
-}
-/**
- * Represents an Audio Space.
- */
-interface AudioSpace {
-    metadata: Metadata;
-    is_subscribed: boolean;
-    participants: Participants;
-    sharings: Sharings;
-}
-interface LiveVideoSource {
-    location: string;
-    noRedirectPlaybackUrl: string;
-    status: string;
-    streamType: string;
-}
-interface LiveVideoStreamStatus {
-    source: LiveVideoSource;
-    sessionId: string;
-    chatToken: string;
-    lifecycleToken: string;
-    shareUrl: string;
-    chatPermissionType: string;
-}
-interface LoginTwitterTokenResponse {
-    cookie: string;
-    user: {
-        class_name: string;
-        id: string;
-        created_at: string;
-        is_beta_user: boolean;
-        is_employee: boolean;
-        is_twitter_verified: boolean;
-        verified_type: number;
-        is_bluebird_user: boolean;
-        twitter_screen_name: string;
-        username: string;
-        display_name: string;
-        description: string;
-        profile_image_urls: {
-            url: string;
-            ssl_url: string;
-            width: number;
-            height: number;
-        }[];
-        twitter_id: string;
-        initials: string;
-        n_followers: number;
-        n_following: number;
-    };
-    type: string;
-}
-
 /**
  * An alternative fetch function to use instead of the default fetch function. This may be useful
  * in nonstandard runtime environments, such as edge workers.
@@ -744,26 +394,17 @@ interface ClientOptions {
     transform: Partial<FetchTransformOptions>;
 }
 /**
- * An interface to Twitter's undocumented API.
+ * An interface to Twitter's API v2.
  * - Reusing Client objects is recommended to minimize the time spent authenticating unnecessarily.
  */
 declare class Client {
     private readonly options?;
-    private auth;
-    private authTrends;
-    private token;
+    private auth?;
     /**
      * Creates a new Client object.
-     * - Clients maintain their own guest tokens for Twitter's internal API.
      * - Reusing Client objects is recommended to minimize the time spent authenticating unnecessarily.
      */
     constructor(options?: Partial<ClientOptions>);
-    /**
-     * Initializes auth properties using a guest token.
-     * Used when creating a new instance of this class, and when logging out.
-     * @internal
-     */
-    private useGuestAuth;
     /**
      * Fetches a Twitter profile.
      * @param username The Twitter username of the profile to fetch, without an `@` at the beginning.
@@ -902,11 +543,19 @@ declare class Client {
     sendTweet(text: string, replyToTweetId?: string, mediaData?: {
         data: Buffer;
         mediaType: string;
-    }[], hideLinkPreview?: boolean): Promise<Response>;
+    }[], hideLinkPreview?: boolean): Promise<{
+        ok: boolean;
+        json: () => Promise<twitter_api_v2.TweetV2PostTweetResult>;
+        data: twitter_api_v2.TweetV2PostTweetResult;
+    }>;
     sendNoteTweet(text: string, replyToTweetId?: string, mediaData?: {
         data: Buffer;
         mediaType: string;
-    }[]): Promise<any>;
+    }[]): Promise<{
+        ok: boolean;
+        json: () => Promise<twitter_api_v2.TweetV2PostTweetResult>;
+        data: twitter_api_v2.TweetV2PostTweetResult;
+    }>;
     /**
      * Send a long tweet (Note Tweet)
      * @param text The text of the tweet
@@ -917,7 +566,11 @@ declare class Client {
     sendLongTweet(text: string, replyToTweetId?: string, mediaData?: {
         data: Buffer;
         mediaType: string;
-    }[]): Promise<Response>;
+    }[]): Promise<{
+        ok: boolean;
+        json: () => Promise<twitter_api_v2.TweetV2PostTweetResult>;
+        data: twitter_api_v2.TweetV2PostTweetResult;
+    }>;
     /**
      * Send a tweet
      * @param text The text of the tweet
@@ -1034,10 +687,20 @@ declare class Client {
         placeFields?: TTweetv2PlaceField[];
     }): Promise<Tweet$1[]>;
     /**
-     * Returns if the client has a guest token. The token may not be valid.
-     * @returns `true` if the client has a guest token; otherwise `false`.
+     * Updates the authentication state for the client.
+     * @param auth The new authentication.
+     */
+    updateAuth(auth: TwitterAuth): void;
+    /**
+     * Get current authentication credentials
+     * @returns {TwitterAuth | null} Current authentication or null if not authenticated
+     */
+    getAuth(): TwitterAuth | null;
+    /**
+     * Check if client is properly authenticated with Twitter API v2 credentials
+     * @returns {boolean} True if authenticated
      */
-    hasGuestToken(): boolean;
+    isAuthenticated(): boolean;
     /**
      * Returns if the client is logged in as a real user.
      * @returns `true` if the client is logged in with a real user account; otherwise `false`.
@@ -1049,32 +712,18 @@ declare class Client {
      */
     me(): Promise<Profile | undefined>;
     /**
-     * Login to Twitter as a real Twitter account. This enables running
-     * searches.
-     * @param username The username of the Twitter account to login with.
-     * @param password The password of the Twitter account to login with.
-     * @param email The email to log in with, if you have email confirmation enabled.
-     * @param twoFactorSecret The secret to generate two factor authentication tokens with, if you have two factor authentication enabled.
+     * Login to Twitter using API v2 credentials only.
+     * @param appKey The API key
+     * @param appSecret The API secret key
+     * @param accessToken The access token
+     * @param accessSecret The access token secret
      */
     login(username: string, password: string, email?: string, twoFactorSecret?: string, appKey?: string, appSecret?: string, accessToken?: string, accessSecret?: string): Promise<void>;
     /**
      * Log out of Twitter.
+     * Note: With API v2, logout is not applicable as we use API credentials.
      */
     logout(): Promise<void>;
-    /**
-     * Retrieves all cookies for the current session.
-     * @returns All cookies for the current session.
-     */
-    getCookies(): Promise<Cookie[]>;
-    /**
-     * Set cookies for the current session.
-     * @param cookies The cookies to set for the current session.
-     */
-    setCookies(cookies: (string | Cookie)[]): Promise<void>;
-    /**
-     * Clear all cookies for the current session.
-     */
-    clearCookies(): Promise<void>;
     /**
      * Sets the optional cookie to be used in requests.
      * @param _cookie The cookie to be used in requests.
@@ -1101,13 +750,17 @@ declare class Client {
             data: Buffer;
             mediaType: string;
         }[];
-    }): Promise<Response>;
+    }): Promise<{
+        ok: boolean;
+        json: () => Promise<twitter_api_v2.TweetV2PostTweetResult>;
+        data: twitter_api_v2.TweetV2PostTweetResult;
+    }>;
     /**
      * Delete a tweet with the given ID.
      * @param tweetId The ID of the tweet to delete.
      * @returns A promise that resolves when the tweet is deleted.
      */
-    deleteTweet(tweetId: string): Promise<Response>;
+    deleteTweet(tweetId: string): Promise<any>;
     /**
      * Likes a tweet with the given tweet ID.
      * @param tweetId The ID of the tweet to like.
@@ -1128,86 +781,28 @@ declare class Client {
     followUser(userName: string): Promise<void>;
     /**
      * Fetches direct message conversations
-     * @param count Number of conversations to fetch (default: 50)
-     * @param cursor Pagination cursor for fetching more conversations
-     * @returns Array of DM conversations and other details
+     * Note: This functionality requires additional permissions and is not implemented in the current Twitter API v2 wrapper
+     * @param userId User ID
+     * @param cursor Pagination cursor
+     * @returns Array of DM conversations
      */
-    getDirectMessageConversations(userId: string, cursor?: string): Promise<DirectMessagesResponse>;
+    getDirectMessageConversations(userId: string, cursor?: string): Promise<any>;
     /**
      * Sends a direct message to a user.
-     * @param conversationId The ID of the conversation to send the message to.
-     * @param text The text of the message to send.
-     * @returns The response from the Twitter API.
+     * Note: This functionality requires additional permissions and is not implemented in the current Twitter API v2 wrapper
+     * @param conversationId The ID of the conversation
+     * @param text The text of the message
+     * @returns The response from the Twitter API
      */
-    sendDirectMessage(conversationId: string, text: string): Promise<SendDirectMessageResponse>;
+    sendDirectMessage(conversationId: string, text: string): Promise<any>;
     private getAuthOptions;
     private handleResponse;
-    /**
-     * Retrieves the details of an Audio Space by its ID.
-     * @param id The ID of the Audio Space.
-     * @returns The details of the Audio Space.
-     */
-    getAudioSpaceById(id: string): Promise<AudioSpace>;
-    /**
-     * Retrieves available space topics.
-     * @returns An array of space topics.
-     */
-    browseSpaceTopics(): Promise<Subtopic[]>;
-    /**
-     * Retrieves available communities.
-     * @returns An array of communities.
-     */
-    communitySelectQuery(): Promise<Community[]>;
-    /**
-     * Retrieves the status of an Audio Space stream by its media key.
-     * @param mediaKey The media key of the Audio Space.
-     * @returns The status of the Audio Space stream.
-     */
-    getAudioSpaceStreamStatus(mediaKey: string): Promise<LiveVideoStreamStatus>;
-    /**
-     * Retrieves the status of an Audio Space by its ID.
-     * This method internally fetches the Audio Space to obtain the media key,
-     * then retrieves the stream status using the media key.
-     * @param audioSpaceId The ID of the Audio Space.
-     * @returns The status of the Audio Space stream.
-     */
-    getAudioSpaceStatus(audioSpaceId: string): Promise<LiveVideoStreamStatus>;
-    /**
-     * Authenticates Periscope to obtain a token.
-     * @returns The Periscope authentication token.
-     */
-    authenticatePeriscope(): Promise<string>;
-    /**
-     * Logs in to Twitter via Proxsee using the Periscope JWT.
-     * @param jwt The JWT obtained from AuthenticatePeriscope.
-     * @returns The response containing the cookie and user information.
-     */
-    loginTwitterToken(jwt: string): Promise<LoginTwitterTokenResponse>;
-    /**
-     * Orchestrates the flow: get token -> login -> return Periscope cookie
-     */
-    getPeriscopeCookie(): Promise<string>;
     /**
      * Fetches a article (long form tweet) by its ID.
      * @param id The ID of the article to fetch. In the format of (http://x.com/i/article/id)
      * @returns The {@link TimelineArticle} object, or `null` if it couldn't be fetched.
      */
     getArticle(id: string): Promise<TimelineArticle | null>;
-    /**
-     * Creates a new conversation with Grok.
-     * @returns A promise that resolves to the conversation ID string.
-     */
-    createGrokConversation(): Promise<string>;
-    /**
-     * Interact with Grok in a chat-like manner.
-     * @param options The options for the Grok chat interaction.
-     * @param {GrokMessage[]} options.messages - Array of messages in the conversation.
-     * @param {string} [options.conversationId] - Optional ID of an existing conversation.
-     * @param {boolean} [options.returnSearchResults] - Whether to return search results.
-     * @param {boolean} [options.returnCitations] - Whether to return citations.
-     * @returns A promise that resolves to the Grok chat response.
-     */
-    grokChat(options: GrokChatOptions): Promise<GrokChatResponse>;
     /**
      * Retrieves all users who retweeted the given tweet.
      * @param tweetId The ID of the tweet.
@@ -1215,336 +810,21 @@ declare class Client {
      */
     getRetweetersOfTweet(tweetId: string): Promise<Retweeter[]>;
     /**
-     * Fetches all tweets quoting a given tweet ID by chaining requests
-     * until no more pages are available.
-     * @param quotedTweetId The tweet ID to find quotes of.
-     * @param maxTweetsPerPage Max tweets per page (default 20).
-     * @returns An array of all Tweet objects referencing the given tweet.
-     */
-    getAllQuotedTweets(quotedTweetId: string, maxTweetsPerPage?: number): Promise<Tweet$1[]>;
-}
-
-/**
- * Interface representing the configuration options for a space participant.
- * @typedef {object} SpaceParticipantConfig
- * @property {string} spaceId - The unique identifier for the space.
- * @property {boolean} [debug] - Optional flag for enabling debug mode.
- */
-interface SpaceParticipantConfig {
-    spaceId: string;
-    debug?: boolean;
-}
-/**
- * Manages joining an existing Space in listener mode,
- * and optionally becoming a speaker via WebRTC (Janus).
- */
-/**
- * Class representing a participant in a space.
- * @extends EventEmitter
- */
-declare class SpaceParticipant extends EventEmitter {
-    private readonly client;
-    private readonly spaceId;
-    private readonly debug;
-    private readonly logger;
-    private cookie?;
-    private authToken?;
-    private chatJwtToken?;
-    private chatToken?;
-    private chatClient?;
-    private lifecycleToken?;
-    private watchSession?;
-    private hlsUrl?;
-    private sessionUUID?;
-    private janusJwt?;
-    private webrtcGwUrl?;
-    private janusClient?;
-    private plugins;
-    constructor(client: Client, config: SpaceParticipantConfig);
-    /**
-     * Adds a plugin and calls its onAttach immediately.
-     * init() or onJanusReady() will be invoked later at the appropriate time.
-     */
-    use(plugin: Plugin, config?: Record<string, any>): this;
-    /**
-     * Joins the Space as a listener: obtains HLS, chat token, etc.
-     */
-    joinAsListener(): Promise<void>;
-    /**
-     * Returns the HLS URL if you want to consume the stream as a listener.
-     */
-    getHlsUrl(): string | undefined;
-    /**
-     * Submits a speaker request using /audiospace/request/submit.
-     * Returns the sessionUUID used to track approval.
-     */
-    requestSpeaker(): Promise<{
-        sessionUUID: string;
-    }>;
-    /**
-     * Cancels a previously submitted speaker request using /audiospace/request/cancel.
-     * This requires a valid sessionUUID from requestSpeaker() first.
-     */
-    cancelSpeakerRequest(): Promise<void>;
-    /**
-     * Once the host approves our speaker request, we perform Janus negotiation
-     * to become a speaker.
-     */
-    becomeSpeaker(): Promise<void>;
-    /**
-     * Removes self from the speaker role and transitions back to a listener.
-     */
-    removeFromSpeaker(): Promise<void>;
-    /**
-     * Leaves the Space gracefully:
-     * - Stop Janus if we were a speaker
-     * - Stop watching as a viewer
-     * - Disconnect chat
-     */
-    leaveSpace(): Promise<void>;
-    /**
-     * Pushes PCM audio frames if we're speaker; otherwise logs a warning.
+     * Fetches all quoted tweets for a given tweet ID, handling pagination automatically.
+     * @param tweetId The ID of the tweet to fetch quotes for.
+     * @param maxQuotes Maximum number of quotes to return (default: 100).
+     * @returns An array of all quoted tweets.
      */
-    pushAudio(samples: Int16Array, sampleRate: number): void;
+    fetchAllQuotedTweets(tweetId: string, maxQuotes?: number): Promise<Tweet$1[]>;
     /**
-     * Internal handler for incoming PCM frames from Janus, forwarded to plugin.onAudioData if present.
+     * Fetches quoted tweets for a given tweet ID.
+     * This method now uses a generator function internally but maintains backward compatibility.
+     * @param tweetId The ID of the tweet to fetch quotes for.
+     * @param maxQuotes Maximum number of quotes to return.
+     * @param cursor Optional cursor for pagination.
+     * @returns A promise that resolves to a QueryTweetsResponse containing tweets and the next cursor.
      */
-    private handleAudioData;
-    /**
-     * Sets up chat events: "occupancyUpdate", "newSpeakerAccepted", etc.
-     */
-    private setupChatEvents;
-    /**
-     * Mute self if we are speaker: calls /audiospace/muteSpeaker with our sessionUUID.
-     */
-    muteSelf(): Promise<void>;
-    /**
-     * Unmute self if we are speaker: calls /audiospace/unmuteSpeaker with our sessionUUID.
-     */
-    unmuteSelf(): Promise<void>;
-}
-
-/**
- * Basic PCM audio frame properties.
- */
-/**
- * Represents audio data with specified characteristics.
- * @typedef {Object} AudioData
- * @property {number} bitsPerSample - Bits per sample (e.g., 16).
- * @property {number} sampleRate - The sample rate in Hz (e.g., 48000 for 48kHz).
- * @property {number} channelCount - Number of channels (e.g., 1 for mono, 2 for stereo).
- * @property {number} numberOfFrames - Number of frames (samples per channel).
- * @property {Int16Array} samples - The raw PCM data for all channels (interleaved if stereo).
- */
-interface AudioData {
-    /**
-     * Bits per sample (e.g., 16).
-     */
-    bitsPerSample: number;
-    /**
-     * The sample rate in Hz (e.g., 48000 for 48kHz).
-     */
-    sampleRate: number;
-    /**
-     * Number of channels (e.g., 1 for mono, 2 for stereo).
-     */
-    channelCount: number;
-    /**
-     * Number of frames (samples per channel).
-     */
-    numberOfFrames: number;
-    /**
-     * The raw PCM data for all channels (interleaved if stereo).
-     */
-    samples: Int16Array;
-}
-/**
- * PCM audio data with an associated user ID, indicating which speaker produced it.
- */
-interface AudioDataWithUser extends AudioData {
-    /**
-     * The ID of the speaker or user who produced this audio frame.
-     */
-    userId: string;
-}
-/**
- * Response structure after creating a broadcast on Periscope/Twitter.
- */
-interface BroadcastCreated {
-    room_id: string;
-    credential: string;
-    stream_name: string;
-    webrtc_gw_url: string;
-    broadcast: {
-        user_id: string;
-        twitter_id: string;
-        media_key: string;
-    };
-    access_token: string;
-    endpoint: string;
-    share_url: string;
-    stream_url: string;
-}
-/**
- * Defines a plugin interface for both Space (broadcast host) and SpaceParticipant (listener/speaker).
- *
- * Lifecycle hooks:
- *  - onAttach(...) is called immediately after .use(plugin).
- *  - init(...) is called after the space or participant has joined in basic mode (listener + chat).
- *  - onJanusReady(...) is called if/when a JanusClient is created (i.e., speaker mode).
- *  - onAudioData(...) is called upon receiving raw PCM frames from a speaker.
- *  - cleanup(...) is called when the space/participant stops or the plugin is removed.
- */
-interface Plugin {
-    /**
-     * Called immediately when the plugin is added via .use(plugin).
-     * Usually used for initial references or minimal setup.
-     */
-    onAttach?(params: {
-        space: Space | SpaceParticipant;
-        pluginConfig?: Record<string, any>;
-    }): void;
-    /**
-     * Called once the space/participant has fully initialized basic features (chat, HLS, etc.).
-     * This is the ideal place to finalize setup for plugins that do not require Janus/speaker mode.
-     */
-    init?(params: {
-        space: Space | SpaceParticipant;
-        pluginConfig?: Record<string, any>;
-    }): void;
-    /**
-     * Called if/when a JanusClient becomes available (e.g., user becomes a speaker).
-     * Plugins that need direct Janus interactions can implement logic here.
-     */
-    onJanusReady?(janusClient: any): void;
-    /**
-     * Called whenever raw PCM audio frames arrive from a speaker.
-     * Useful for speech-to-text, analytics, or logging.
-     */
-    onAudioData?(data: AudioDataWithUser): void;
-    /**
-     * Cleanup lifecycle hook, invoked when the plugin is removed or the space/participant stops.
-     * Allows releasing resources, stopping timers, or closing file handles.
-     */
-    cleanup?(): void;
-}
-/**
- * Stores information about a speaker in a Space (host perspective).
- */
-interface SpeakerInfo {
-    userId: string;
-    sessionUUID: string;
-    janusParticipantId?: number;
-}
-interface SpaceConfig {
-    mode: 'BROADCAST' | 'LISTEN' | 'INTERACTIVE';
-    title?: string;
-    description?: string;
-    languages?: string[];
-    debug?: boolean;
-    record: boolean;
-}
-
-/**
- * Manages the creation of a new Space (broadcast host):
- * 1) Creates the broadcast on Periscope
- * 2) Sets up Janus WebRTC for audio
- * 3) Optionally creates a ChatClient for interactive mode
- * 4) Allows managing (approve/remove) speakers, pushing audio, etc.
- */
-/**
- * Represents a space that can be used for communication and collaboration.
- * Extends the EventEmitter class and contains properties for debugging, logging, Janus client, chat client, authentication token,
- * and broadcast information.
- */
-declare class Space extends EventEmitter {
-    private readonly client;
-    private readonly debug;
-    private readonly logger;
-    private janusClient?;
-    private chatClient?;
-    private authToken?;
-    private broadcastInfo?;
-    private isInitialized;
-    private plugins;
-    private speakers;
-    constructor(client: Client, options?: {
-        debug?: boolean;
-    });
-    /**
-     * Registers a plugin and calls its onAttach(...).
-     * init(...) will be invoked once initialization is complete.
-     */
-    use(plugin: Plugin, config?: Record<string, any>): this;
-    /**
-     * Main entry point to create and initialize the Space broadcast.
-     */
-    initialize(config: SpaceConfig): Promise<BroadcastCreated>;
-    /**
-     * Send an emoji reaction via chat, if interactive.
-     */
-    reactWithEmoji(emoji: string): void;
-    /**
-     * Internal method to wire up chat events if interactive.
-     */
-    private setupChatEvents;
-    /**
-     * Approves a speaker request on Twitter side, then calls Janus to subscribe their audio.
-     */
-    approveSpeaker(userId: string, sessionUUID: string): Promise<void>;
-    /**
-     * Approve request => calls /api/v1/audiospace/request/approve
-     */
-    private callApproveEndpoint;
-    /**
-     * Removes a speaker from the Twitter side, then unsubscribes in Janus if needed.
-     */
-    removeSpeaker(userId: string): Promise<void>;
-    /**
-     * Twitter's /api/v1/audiospace/stream/eject call
-     */
-    private callRemoveEndpoint;
-    /**
-     * Push PCM audio frames if you're the host. Usually you'd do this if you're capturing
-     * microphone input from the host side.
-     */
-    pushAudio(samples: Int16Array, sampleRate: number): void;
-    /**
-     * Handler for PCM from other speakers, forwarded to plugin.onAudioData
-     */
-    private handleAudioData;
-    /**
-     * Gracefully shut down this Space: destroy the Janus room, end the broadcast, etc.
-     */
-    finalizeSpace(): Promise<void>;
-    /**
-     * Calls /api/v1/audiospace/admin/endAudiospace on Twitter side.
-     */
-    private endAudiospace;
-    /**
-     * Retrieves an array of known speakers in this Space (by userId and sessionUUID).
-     */
-    getSpeakers(): SpeakerInfo[];
-    /**
-     * Mute the host (yourself). For the host, session_uuid = '' (empty).
-     */
-    muteHost(): Promise<void>;
-    /**
-     * Unmute the host (yourself).
-     */
-    unmuteHost(): Promise<void>;
-    /**
-     * Mute a specific speaker. We'll retrieve sessionUUID from our local map.
-     */
-    muteSpeaker(userId: string): Promise<void>;
-    /**
-     * Unmute a specific speaker. We'll retrieve sessionUUID from local map.
-     */
-    unmuteSpeaker(userId: string): Promise<void>;
-    /**
-     * Stop the broadcast entirely, performing finalizeSpace() plus plugin cleanup.
-     */
-    stop(): Promise<void>;
+    fetchQuotedTweetsPage(tweetId: string, maxQuotes?: number, cursor?: string): Promise<QueryTweetsResponse>;
 }
 
 /**
@@ -1657,116 +937,17 @@ declare class TwitterPostClient {
 }
 
 /**
- * Enum representing space activity options.
- *
- * @enum {string}
- * @readonly
- * @property {string} HOSTING - Indicates that the space is being used for hosting an event.
- * @property {string} PARTICIPATING - Indicates that the space is being used for participating in an event.
- * @property {string} IDLE - Indicates that the space is not currently being used.
- */
-declare enum SpaceActivity {
-    HOSTING = "hosting",
-    PARTICIPATING = "participating",
-    IDLE = "idle"
-}
-/**
- * An enum representing the activity role of a participant.
- * @enum {string}
- * @readonly
- * @property {string} LISTENER - Represents a participant who is a listener.
- * @property {string} SPEAKER - Represents a participant who is a speaker.
- * @property {string} PENDING - Represents a participant whose activity is pending.
- */
-declare enum ParticipantActivity {
-    LISTENER = "listener",
-    SPEAKER = "speaker",
-    PENDING = "pending"
-}
-/**
- * Main class: manage a Twitter Space with N speakers max, speaker queue, filler messages, etc.
- */
-/**
- * Represents a client for interacting with Twitter Spaces.
- * * @class
- * @property { IAgentRuntime } runtime - The agent runtime for the client.
- * @property { ClientBase } client - The base client for making requests.
- * @property { Client } twitterClient - The Twitter client for interacting with Twitter API.
- * @property {Space | undefined} currentSpace - The current Twitter Space the client is connected to (if any).
- * @property {string | undefined} spaceId - The ID of the Twitter Space the client is connected to (if any).
- * @property {number | undefined} startedAt - The timestamp when the client was started.
- * @property {NodeJS.Timeout | undefined} checkInterval - The interval for checking the status of the Twitter Space.
- * @property {number | undefined} lastSpaceEndedAt - The timestamp of when the last Twitter Space ended.
- */
-declare class TwitterSpaceClient {
-    private runtime;
-    private client;
-    private twitterClient;
-    private currentSpace?;
-    private spaceId?;
-    private startedAt?;
-    private checkInterval?;
-    private lastSpaceEndedAt?;
-    private sttTtsPlugin?;
-    spaceStatus: SpaceActivity;
-    private spaceParticipant;
-    participantStatus: ParticipantActivity;
-    /**
-     * We now store an array of active speakers, not just 1
-     */
-    private activeSpeakers;
-    private speakerQueue;
-    private decisionOptions;
-    constructor(client: ClientBase, runtime: IAgentRuntime);
-    /**
-     * Periodic check to launch or manage space
-     */
-    startPeriodicSpaceCheck(): Promise<void>;
-    stopPeriodicCheck(): void;
-    private shouldLaunchSpace;
-    private generateSpaceConfig;
-    startSpace(config: SpaceConfig): Promise<void>;
-    /**
-     * Periodic management: check durations, remove extras, maybe accept new from queue
-     */
-    private manageCurrentSpace;
-    /**
-     * If we have available slots, accept new speakers from the queue
-     */
-    private acceptSpeakersFromQueueIfNeeded;
-    private handleSpeakerRequest;
-    private acceptSpeaker;
-    private removeSpeaker;
-    /**
-     * If more than maxSpeakers are found, remove extras
-     * Also update activeSpeakers array
-     */
-    private kickExtraSpeakers;
-    stopSpace(): Promise<void>;
-    startParticipant(spaceId: string): Promise<string>;
-    manageParticipant(): Promise<void>;
-    stopParticipant(): Promise<void>;
-    /**
-     * waitForApproval waits until "newSpeakerAccepted" matches our sessionUUID,
-     * then calls becomeSpeaker() or rejects after a given timeout.
-     */
-    waitForApproval(participant: SpaceParticipant, sessionUUID: string, timeoutMs?: number): Promise<void>;
-}
-
-/**
- * Interface for a Twitter client.
- *
- * @property {ClientBase} client - The base client for making requests.
- * @property {TwitterPostClient} post - The client for posting on Twitter.
- * @property {TwitterInteractionClient} interaction - The client for interacting with tweets.
- * @property {TwitterSpaceClient} [space] - The client for managing Twitter spaces (optional).
- * @property {TwitterService} service - The service provider for Twitter API.
+ * @interface ITwitterClient
+ * Represents the main Twitter client interface for interacting with Twitter's API.
+ * @property {ClientBase} client - The base client for Twitter operations.
+ * @property {TwitterPostClient} post - The client for managing Twitter posts.
+ * @property {TwitterInteractionClient} interaction - The client for managing Twitter interactions.
+ * @property {TwitterService} service - The main Twitter service instance.
  */
 interface ITwitterClient {
     client: ClientBase;
     post: TwitterPostClient;
     interaction: TwitterInteractionClient;
-    space?: TwitterSpaceClient;
     service: TwitterService;
 }
 /**
@@ -1919,15 +1100,12 @@ declare class ClientBase {
     fetchHomeTimeline(count: number, following?: boolean): Promise<Tweet$1[]>;
     fetchSearchTweets(query: string, maxTweets: number, searchMode: SearchMode, cursor?: string): Promise<QueryTweetsResponse>;
     private populateTimeline;
-    setCookiesFromArray(cookiesArray: any[]): Promise<void>;
     saveRequestMessage(message: Memory, state: State): Promise<void>;
     loadLatestCheckedTweetId(): Promise<void>;
     cacheLatestCheckedTweetId(): Promise<void>;
     getCachedTimeline(): Promise<Tweet$1[] | undefined>;
     cacheTimeline(timeline: Tweet$1[]): Promise<void>;
     cacheMentions(mentions: Tweet$1[]): Promise<void>;
-    getCachedCookies(username: string): Promise<any[]>;
-    cacheCookies(username: string, cookies: any[]): Promise<void>;
     fetchProfile(username: string): Promise<TwitterProfile>;
     /**
      * Fetches recent interactions (likes, retweets, quotes) for the authenticated user's tweets
@@ -1995,7 +1173,6 @@ declare class TwitterClientInstance implements ITwitterClient {
     post: TwitterPostClient;
     interaction: TwitterInteractionClient;
     timeline?: TwitterTimelineClient;
-    space?: TwitterSpaceClient;
     service: TwitterService;
     constructor(runtime: IAgentRuntime, state: any);
 }
@@ -2019,6 +1196,6 @@ declare class TwitterService extends Service {
     stopAllClients(): Promise<void>;
     private getClientKey;
 }
-declare const twitterPlugin: Plugin$1;
+declare const twitterPlugin: Plugin;
 
 export { TwitterClientInstance, TwitterService, twitterPlugin as default };