added the new X tool to the docs (#415)

* added the new X tool to the docs

* revert X to it's true name, and fixed usage examples

* added formerly Twitter back

Author: torresmateo

pages/toolkits/social-communication/x.mdx

@@ -1,4 +1,4 @@
-# X (Twitter)
+# X (formerly Twitter)
 
 import ToolInfo from "@/components/ToolInfo";
 import Badges from "@/components/Badges";
@@ -9,205 +9,212 @@ import ToolFooter from "@/components/ToolFooter";
 <ToolInfo
   description="Enable agents to interact with X (formerly Twitter)."
   author="Arcade"
-  codeLink="https://github.com/ArcadeAI/arcade-ai/tree/main/toolkits/x"
-  authType="oauth2"
-  authProviderName="X"
-  versions={["0.1.0"]}
+  authType="OAuth2"
+  versions={["1.0.1"]}
 />
 
 <Badges repo="arcadeai/arcade_x" />
 
-The Arcade X (Twitter) toolkit provides a pre-built set of tools for interacting with X (formerly Twitter). These tools make it easy to build agents and AI apps that can:
+The Arcade X (formerly Twitter) toolkit provides a pre-built set of tools for interacting with X (formerly Twitter). These tools make it easy to build agents and AI apps that can:
 
 - Post tweets
+- Reply to tweets
+- Quote tweets
 - Delete tweets
 - Search for tweets by username
 - Search for tweets by keywords
 - Look up a user by username
 
 ## Available Tools
 
-These tools are currently available in the Arcade X toolkit.
-
 <TableOfContents
   headers={["Tool Name", "Description"]}
-  data={[
-    ["X.PostTweet", "Post a tweet to X (Twitter)."],
-    ["X.DeleteTweetById", "Delete a tweet on X (Twitter)."],
-    ["X.SearchRecentTweetsByUsername", "Search recent tweets by username."],
-    ["X.SearchRecentTweetsByKeywords", "Search recent tweets by keywords or phrases.",],
-    ["X.LookupSingleUserByUsername", "Look up a user on X (Twitter) by username.",],
-    ["X.LookupTweetById", "Look up a tweet by its ID",],
-  ]}
+  data={
+    [
+      ["X.LookupSingleUserByUsername", "Look up a user on X (Twitter) by their username."],
+      ["X.PostTweet", "Post a tweet to X (Twitter)."],
+      ["X.ReplyToTweet", "Reply to a tweet on X (Twitter)."],
+      ["X.DeleteTweetById", "Delete a tweet on X (Twitter)."],
+      ["X.SearchRecentTweetsByUsername", "Search for recent tweets (last 7 days) on X (Twitter) by username."],
+      ["X.SearchRecentTweetsByKeywords", "Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases."],
+      ["X.LookupTweetById", "Look up a tweet on X (Twitter) by tweet ID."],
+    ]
+  }
 />
 
 <Tip>
   If you need to perform an action that's not listed here, you can [get in touch
   with us](mailto:[email protected]) to request a new tool, or [create your
-  own tools](/home/build-tools/create-a-toolkit) with the [X auth
-  provider](/home/auth-providers/x#using-x-auth-in-custom-tools).
+  own tools](/home/build-tools/create-a-toolkit).
 </Tip>
 
+## X.LookupSingleUserByUsername
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool Directly",
+      content: {
+        Python: ["/examples/integrations/toolkits/x/lookup_single_user_by_username_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/x/lookup_single_user_by_username_example_call_tool.js"],
+      },
+    },
+  ]}
+/>
+
+Look up a user on X (Twitter) by their username.
+
+**Parameters**
+
+- **username** (`string`, required) The username of the X (Twitter) user to look up
+
+
 ## X.PostTweet
 
 <br />
 <TabbedCodeBlock
   tabs={[
     {
-      label: "Call the Tool with User Authorization",
+      label: "Call the Tool Directly",
       content: {
-        Python: [
-          "/examples/integrations/toolkits/x/post_tweet_example_call_tool.py",
-        ],
+        Python: ["/examples/integrations/toolkits/x/post_tweet_example_call_tool.py"],
         JavaScript: ["/examples/integrations/toolkits/x/post_tweet_example_call_tool.js"],
       },
-    }
+    },
   ]}
 />
 
 Post a tweet to X (Twitter).
 
 **Parameters**
 
-- **`tweet_text`** _(string, required)_ The text content of the tweet you want to post.
+- **tweet_text** (`string`, required) The text content of the tweet you want to post
+- **quote_tweet_id** (`string`, optional) The ID of the tweet you want to quote. Optional.
 
----
 
-## X.DeleteTweetById
+## X.ReplyToTweet
 
 <br />
 <TabbedCodeBlock
   tabs={[
     {
-      label: "Call the Tool with User Authorization",
+      label: "Call the Tool Directly",
       content: {
-        Python: [
-          "/examples/integrations/toolkits/x/delete_tweet_by_id_example_call_tool.py",
-        ],
-        JavaScript: ["/examples/integrations/toolkits/x/delete_tweet_by_id_example_call_tool.js"],
+        Python: ["/examples/integrations/toolkits/x/reply_to_tweet_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/x/reply_to_tweet_example_call_tool.js"],
       },
-    }
+    },
   ]}
 />
 
-Delete a tweet on X (Twitter).
+Reply to a tweet on X (Twitter).
 
 **Parameters**
 
-- **`tweet_id`** _(string, required)_ The ID of the tweet you want to delete.
+- **tweet_id** (`string`, required) The ID of the tweet you want to reply to
+- **tweet_text** (`string`, required) The text content of the tweet you want to post
+- **quote_tweet_id** (`string`, optional) The ID of the tweet you want to quote. Optional.
 
----
 
-## X.SearchRecentTweetsByUsername
+## X.DeleteTweetById
 
 <br />
 <TabbedCodeBlock
   tabs={[
     {
-      label: "Call the Tool with User Authorization",
+      label: "Call the Tool Directly",
       content: {
-        Python: [
-          "/examples/integrations/toolkits/x/search_recent_tweets_by_username_example_call_tool.py",
-        ],
-        JavaScript: ["/examples/integrations/toolkits/x/search_recent_tweets_by_username_example_call_tool.js"],
+        Python: ["/examples/integrations/toolkits/x/delete_tweet_by_id_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/x/delete_tweet_by_id_example_call_tool.js"],
       },
-    }
+    },
   ]}
 />
 
-Search for recent tweets (last 7 days) on X (Twitter) by username. Includes replies and reposts.
+Delete a tweet on X (Twitter).
 
 **Parameters**
 
-- **`username`** _(string, required)_ The username of the X (Twitter) user to look up.
-- **`max_results`** _(integer, optional, Defaults to 10)_ The maximum number of results to return. Cannot be less than 10.
-- **`next_token`** _(string, optional)_ The pagination token starting from which to return results.
+- **tweet_id** (`string`, required) The ID of the tweet you want to delete
 
----
 
-## X.SearchRecentTweetsByKeywords
+## X.SearchRecentTweetsByUsername
 
 <br />
 <TabbedCodeBlock
   tabs={[
     {
-      label: "Call the Tool with User Authorization",
+      label: "Call the Tool Directly",
       content: {
-        Python: [
-          "/examples/integrations/toolkits/x/search_recent_tweets_by_keywords_example_call_tool.py",
-        ],
-        JavaScript: ["/examples/integrations/toolkits/x/search_recent_tweets_by_keywords_example_call_tool.js"],
+        Python: ["/examples/integrations/toolkits/x/search_recent_tweets_by_username_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/x/search_recent_tweets_by_username_example_call_tool.js"],
       },
-    }
+    },
   ]}
 />
 
-Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases. Includes replies and reposts.
-
-_At least one of the following parameters must be provided: `keywords`, `phrases`._
+Search for recent tweets (last 7 days) on X (Twitter) by username.
 
 **Parameters**
 
-- **`keywords`** _(array of strings, optional)_ List of keywords that must be present in the tweet.
-- **`phrases`** _(array of strings, optional)_ List of phrases that must be present in the tweet.
-- **`max_results`** _(integer, optional, Defaults to 10)_ The maximum number of results to return. Cannot be less than 10.
+- **username** (`string`, required) The username of the X (Twitter) user to look up
+- **max_results** (`integer`, optional) The maximum number of results to return. Must be in range [1, 100] inclusive
+- **next_token** (`string`, optional) The pagination token starting from which to return results
 
----
 
-## X.LookupTweetById
+## X.SearchRecentTweetsByKeywords
 
 <br />
 <TabbedCodeBlock
   tabs={[
     {
-      label: "Call the Tool with User Authorization",
+      label: "Call the Tool Directly",
       content: {
-        Python: [
-          "/examples/integrations/toolkits/x/lookup_tweet_by_id_example_call_tool.py",
-        ],
-        JavaScript: ["/examples/integrations/toolkits/x/lookup_tweet_by_id_example_call_tool.js"],
+        Python: ["/examples/integrations/toolkits/x/search_recent_tweets_by_keywords_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/x/search_recent_tweets_by_keywords_example_call_tool.js"],
       },
-    }
+    },
   ]}
 />
 
-Look up a tweet on X (Twitter) by its ID.
+Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases.
 
 **Parameters**
 
-- **`tweet_id`** _(string, required)_ The ID of the tweet to look up.
+- **keywords** (`array[string]`, optional) List of keywords that must be present in the tweet
+- **phrases** (`array[string]`, optional) List of phrases that must be present in the tweet
+- **max_results** (`integer`, optional) The maximum number of results to return. Must be in range [1, 100] inclusive
+- **next_token** (`string`, optional) The pagination token starting from which to return results
 
----
 
-## X.LookupSingleUserByUsername
+## X.LookupTweetById
 
 <br />
 <TabbedCodeBlock
   tabs={[
     {
-      label: "Call the Tool with User Authorization",
+      label: "Call the Tool Directly",
       content: {
-        Python: [
-          "/examples/integrations/toolkits/x/lookup_single_user_by_username_example_call_tool.py",
-        ],
-        JavaScript: ["/examples/integrations/toolkits/x/lookup_single_user_by_username_example_call_tool.js"],
+        Python: ["/examples/integrations/toolkits/x/lookup_tweet_by_id_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/x/lookup_tweet_by_id_example_call_tool.js"],
       },
-    }
+    },
   ]}
 />
 
-Look up a user on X (Twitter) by their username.
+Look up a tweet on X (Twitter) by tweet ID.
 
 **Parameters**
 
-- **`username`** _(string, required)_ The username of the X (Twitter) user to look up.
+- **tweet_id** (`string`, required) The ID of the tweet you want to look up
 
-## Auth
 
-The Arcade X (Twitter) toolkit uses the [X auth provider](/home/auth-providers/x) to connect to users' X (formerly Twitter) accounts.
 
-With the hosted Arcade Engine, there's nothing to configure. Your users will see `Arcade` as the name of the application that's requesting permission.
 
-With a self-hosted installation of Arcade, you need to [configure the X auth provider](/home/auth-providers/x#configuring-x-auth) with your own X (formerly Twitter) app credentials.
+## Auth
+
+The Arcade X toolkit uses the [X auth provider](/home/auth-providers/x) to connect to users' X accounts. Please refer to the [X auth provider](/home/auth-providers/x) documentation to learn how to configure auth.
 
 <ToolFooter pipPackageName="arcade_x" />
+

public/examples/integrations/toolkits/x/delete_tweet_by_id_example_call_tool.js

@@ -6,26 +6,23 @@ const USER_ID = "{arcade_user_id}";
 const TOOL_NAME = "X.DeleteTweetById";
 
 // Start the authorization process
-const authResponse = await client.tools.authorize({
-    tool_name: TOOL_NAME,
-    user_id: USER_ID,
-});
+const authResponse = await client.tools.authorize({tool_name: TOOL_NAME});
 
 if (authResponse.status !== "completed") {
-    console.log(`Click this link to authorize: ${authResponse.url}`);
+  console.log(`Click this link to authorize: ${authResponse.url}`);
 }
 
 // Wait for the authorization to complete
 await client.auth.waitForCompletion(authResponse);
 
 const toolInput = {
-    tweet_id: "your_tweet_id_here" // Tweet IDs can be found in the response of other X tools, like SearchRecentTweetsByUsername
+  "tweet_id": "1234567890"
 };
 
 const response = await client.tools.execute({
-    tool_name: TOOL_NAME,
-    input: toolInput,
-    user_id: USER_ID,
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
 });
 
-console.log(response); 
+console.log(JSON.stringify(response.output.value, null, 2));

public/examples/integrations/toolkits/x/delete_tweet_by_id_example_call_tool.py

@@ -1,14 +1,12 @@
+import json
 from arcadepy import Arcade
 
 client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
 
 USER_ID = "{arcade_user_id}"
 TOOL_NAME = "X.DeleteTweetById"
 
-auth_response = client.tools.authorize(
-    tool_name=TOOL_NAME,
-    user_id=USER_ID,
-)
+auth_response = client.tools.authorize(tool_name=TOOL_NAME)
 
 if auth_response.status != "completed":
     print(f"Click this link to authorize: {auth_response.url}")
@@ -17,12 +15,12 @@
 client.auth.wait_for_completion(auth_response)
 
 tool_input = {
-    "tweet_id": "your_tweet_id_here"  # Tweet IDs can be found in the response of other X tools, like SearchRecentTweetsByUsername
+    'tweet_id': '1234567890'
 }
 
 response = client.tools.execute(
     tool_name=TOOL_NAME,
     input=tool_input,
     user_id=USER_ID,
 )
-print(response)
+print(json.dumps(response.output.value, indent=2))