1"""
2Twitter/X Extension — Read-only data via twitterapi.io
3 
4Provides 13 tools for Twitter/X data:
5- twitter_search_tweets: Advanced tweet search
6- twitter_get_tweets: Get tweets by ID
7- twitter_get_article: Get long-form article by tweet ID
8- twitter_tweet_thread_context: Get complete thread context
9- twitter_tweet_quote: Get quote tweets for a tweet
10- twitter_get_trends: Get trends
11- twitter_user_info: User profile lookup
12- twitter_user_tweets: User's recent tweets
13- twitter_user_followers: User's followers
14- twitter_user_followings: User's followings
15- twitter_tweet_replies: Replies to a tweet
16- twitter_tweet_retweeters: Users who retweeted
17- twitter_search_users: Search for users
18 
19Environment Variables:
20- TWITTER_API_KEY: API key for twitterapi.io (required)
21 
22Usage:
23    This extension is auto-loaded by the ExtensionLoader.
24"""
25 
26import logging
27from typing import List
28 
29logger = logging.getLogger(__name__)
30 
31 
32def register(api) -> List[str]:
33    """
34    Extension entry point — register all Twitter tools.
35 
36    Args:
37        api: ExtensionApi instance with registry and config
38 
39    Returns:
40        List of registered tool names
41    """
42    registered = []
43 
44    try:
45        from .tools import (
46            TwitterSearchTweetsTool,
47            TwitterGetTweetsTool,
48            TwitterGetArticleTool,
49            TwitterTweetThreadContextTool,
50            TwitterTweetQuoteTool,
51            TwitterGetTrendsTool,
52            TwitterUserInfoTool,
53            TwitterUserTweetsTool,
54            TwitterUserFollowersTool,
55            TwitterUserFollowingsTool,
56            TwitterTweetRepliesTool,
57            TwitterTweetRetweetersTool,
58            TwitterSearchUsersTool,
59        )
60 
61        api.register_tool(TwitterSearchTweetsTool())
62        api.register_tool(TwitterGetTweetsTool())
63        api.register_tool(TwitterGetArticleTool())
64        api.register_tool(TwitterTweetThreadContextTool())
65        api.register_tool(TwitterTweetQuoteTool())
66        api.register_tool(TwitterGetTrendsTool())
67        api.register_tool(TwitterUserInfoTool())
68        api.register_tool(TwitterUserTweetsTool())
69        api.register_tool(TwitterUserFollowersTool())
70        api.register_tool(TwitterUserFollowingsTool())
71        api.register_tool(TwitterTweetRepliesTool())
72        api.register_tool(TwitterTweetRetweetersTool())
73        api.register_tool(TwitterSearchUsersTool())
74 
75        registered = [
76            "twitter_search_tweets",
77            "twitter_get_tweets",
78            "twitter_get_article",
79            "twitter_tweet_thread_context",
80            "twitter_tweet_quote",
81            "twitter_get_trends",
82            "twitter_user_info",
83            "twitter_user_tweets",
84            "twitter_user_followers",
85            "twitter_user_followings",
86            "twitter_tweet_replies",
87            "twitter_tweet_retweeters",
88            "twitter_search_users",
89        ]
90 
91        logger.info(f"Registered Twitter tools ({len(registered)} tools)")
92    except Exception as e:
93        logger.warning(f"Failed to load Twitter tools: {e}")
94 
95    return registered
96 
97 
98# Extension metadata
99EXTENSION_INFO = {
100    "name": "twitter",
101    "version": "1.1.0",
102    "description": "Twitter/X data — search tweets, article, thread context, quote tweets, trends, users",
103    "tools": [
104        "twitter_search_tweets",
105        "twitter_get_tweets",
106        "twitter_get_article",
107        "twitter_tweet_thread_context",
108        "twitter_tweet_quote",
109        "twitter_get_trends",
110        "twitter_user_info",
111        "twitter_user_tweets",
112        "twitter_user_followers",
113        "twitter_user_followings",
114        "twitter_tweet_replies",
115        "twitter_tweet_retweeters",
116        "twitter_search_users",
117    ],
118    "env_vars": [
119        "TWITTER_API_KEY",
120    ],
121}
122