arcade-x 0.1.16__py3-none-any.whl → 1.1.0__py3-none-any.whl

arcade_x/tools/tweets.py

@@ -14,12 +14,22 @@ from arcade_x.tools.utils import (
     get_tweet_url,
     parse_search_recent_tweets_response,
     remove_none_values,
+    validate_tweet_id,
 )
 
 # Manage Tweets Tools. See developer docs for additional available parameters:
 # https://developer.x.com/en/docs/x-api/tweets/manage-tweets/api-reference
 
 
+async def _post_tweet(context: ToolContext, payload: dict) -> str:
+    headers = get_headers_with_token(context)
+    async with httpx.AsyncClient() as client:
+        response = await client.post(TWEETS_URL, headers=headers, json=payload, timeout=10)
+        response.raise_for_status()
+    tweet_id = response.json()["data"]["id"]
+    return f"Tweet with id {tweet_id} posted successfully. URL: {get_tweet_url(tweet_id)}"
+
+
 @tool(
     requires_auth=X(
         scopes=["tweet.read", "tweet.write", "users.read"],
@@ -28,18 +38,59 @@ from arcade_x.tools.utils import (
 async def post_tweet(
     context: ToolContext,
     tweet_text: Annotated[str, "The text content of the tweet you want to post"],
+    quote_tweet_id: Annotated[
+        str | None,
+        "The ID of the tweet you want to quote."
+        " It must be a valid integer as a string. Optional.",
+    ] = None,
 ) -> Annotated[str, "Success string and the URL of the tweet"]:
-    """Post a tweet to X (Twitter)."""
+    """Post a tweet to X (Twitter).
 
-    headers = get_headers_with_token(context)
+    IMPORTANT NOTE:
+    Use this tool ONLY when posting a tweet that is not a reply.
+    If you need to reply to a tweet, use the ReplyToTweet tool instead.
+    If you need to quote a tweet, you must include the quote_tweet_id parameter."""
     payload = {"text": tweet_text}
+    if quote_tweet_id:
+        validate_tweet_id(quote_tweet_id)
+        payload["quote_tweet_id"] = quote_tweet_id
+    return await _post_tweet(context, payload)
 
-    async with httpx.AsyncClient() as client:
-        response = await client.post(TWEETS_URL, headers=headers, json=payload, timeout=10)
-        response.raise_for_status()
 
-    tweet_id = response.json()["data"]["id"]
-    return f"Tweet with id {tweet_id} posted successfully. URL: {get_tweet_url(tweet_id)}"
+@tool(
+    requires_auth=X(
+        scopes=["tweet.read", "tweet.write", "users.read"],
+    )
+)
+async def reply_to_tweet(
+    context: ToolContext,
+    tweet_id: Annotated[
+        str, "The ID of the tweet you want to reply to. It must be a valid integer as a string."
+    ],
+    tweet_text: Annotated[str, "The text content of the tweet you want to post"],
+    quote_tweet_id: Annotated[
+        str | None,
+        "The ID of the tweet you want to quote. It must be a valid integer as a string. Optional.",
+    ] = None,
+) -> Annotated[str, "Success string and the URL of the tweet"]:
+    """Reply to a tweet on X (Twitter).
+
+    IMPORTANT NOTE:
+    Use this tool ONLY when replying to a tweet directly.
+    If you need to post a tweet that is not a reply, use the PostTweet tool instead.
+    If you need to quote a tweet on your reply, you must include the quote_tweet_id parameter.
+    """
+
+    payload = {
+        "text": tweet_text,
+        "reply": {
+            "in_reply_to_tweet_id": tweet_id,
+        },
+    }
+    if quote_tweet_id:
+        validate_tweet_id(quote_tweet_id)
+        payload["quote_tweet_id"] = quote_tweet_id
+    return await _post_tweet(context, payload)
 
 
 @tool(requires_auth=X(scopes=["tweet.read", "tweet.write", "users.read"]))
@@ -49,6 +100,7 @@ async def delete_tweet_by_id(
 ) -> Annotated[str, "Success string confirming the tweet deletion"]:
     """Delete a tweet on X (Twitter)."""
 
+    validate_tweet_id(tweet_id)
     headers = get_headers_with_token(context)
     url = f"{TWEETS_URL}/{tweet_id}"
 
@@ -185,6 +237,7 @@ async def lookup_tweet_by_id(
 ) -> Annotated[dict[str, Any], "Dictionary containing the tweet data"]:
     """Look up a tweet on X (Twitter) by tweet ID."""
 
+    validate_tweet_id(tweet_id)
     headers = get_headers_with_token(context)
     params = {
         "expansions": "author_id",

arcade_x/tools/utils.py

@@ -161,3 +161,14 @@ def expand_attached_media(params: dict) -> dict:
         "public_metrics",
     ])
     return params
+
+
+def validate_tweet_id(tweet_id: str) -> None:
+    """
+    Validate a tweet ID.
+    """
+    if not tweet_id.isdigit():
+        raise ToolExecutionError(
+            "Invalid tweet ID",
+            developer_message="Tweet ID must be a valid integer",
+        )

{arcade_x-0.1.16.dist-info → arcade_x-1.1.0.dist-info}/METADATA

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: arcade_x
-Version: 0.1.16
+Version: 1.1.0
 Summary: Arcade.dev LLM tools for X (Twitter)
 Author-email: Arcade <dev@arcade.dev>
+License: Proprietary - Arcade Software License Agreement v1.0
 License-File: LICENSE
 Requires-Python: >=3.10
 Requires-Dist: arcade-tdk<3.0.0,>=2.0.0

arcade_x-1.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+arcade_x/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+arcade_x/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+arcade_x/tools/constants.py,sha256=d-OJK5Qx05JRUcpK5G1DcYB91wT37hFSzGmIYfwlEtA,42
+arcade_x/tools/tweets.py,sha256=xfg31_Jh7sUuBfFjRIY_TwbUFCcYbm_xyUE_s35HB-8,9416
+arcade_x/tools/users.py,sha256=gopYKTBOwbZAeVdL_T3vwkepbpv1bdPbqcU_2oPC3SY,2132
+arcade_x/tools/utils.py,sha256=lR_shws08LWQD-4XU9r3xYmasZ2j2i-cUaCCDnuN8UE,5723
+arcade_x-1.1.0.dist-info/METADATA,sha256=4NOmlu-_kCLdy_KjDZAGkX3DFjaBZsLHsNmmYvtjkFY,896
+arcade_x-1.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+arcade_x-1.1.0.dist-info/licenses/LICENSE,sha256=ixeE7aL9b2B-_ZYHTY1vQcJB4NufKeo-LWwKNObGDN0,1960
+arcade_x-1.1.0.dist-info/RECORD,,

arcade_x-1.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,35 @@
+# The Arcade Software License Agreement
+
+- Version 1.0
+- Effective Date: July 24, 2025
+
+---
+
+This software and associated documentation (collectively, the “Software”) are the intellectual property of Arcade Technologies, Inc. (“Arcade”). All rights are reserved.
+
+1. License Grant
+
+No license or other rights are granted to any party under this Agreement, whether by implication, estoppel, or otherwise. This Software is proprietary and confidential. Use, reproduction, modification, distribution, display, or creation of derivative works based on the Software is strictly prohibited without the prior written consent of Arcade.
+
+2. Commercial Use Only
+
+Any use of this Software requires a commercial license agreement with Arcade. You may not use any part of the Software for any purpose—including but not limited to evaluation, testing, or internal use—without first obtaining explicit written permission and entering into a commercial licensing arrangement.
+
+To inquire about licensing terms, contact Arcade at:
+🔗 www.arcade.dev
+
+3. No Open Source Rights
+
+This Software is not licensed under an open-source license. No part of it may be incorporated into open-source or publicly available projects under any open-source terms or licenses.
+
+4. Ownership
+
+Arcade retains all right, title, and interest in and to the Software, including all intellectual property rights therein. No ownership or license rights are transferred under this Agreement.
+
+5. Disclaimer of Warranty
+
+The Software is provided “as is” without warranty of any kind. Arcade disclaims all warranties, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and noninfringement.
+
+6. Limitation of Liability
+
+In no event shall Arcade be liable for any damages arising out of or in connection with the use or performance of the Software, whether in an action of contract, tort (including negligence), or otherwise.

arcade_x-0.1.16.dist-info/RECORD

@@ -1,10 +0,0 @@
-arcade_x/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-arcade_x/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-arcade_x/tools/constants.py,sha256=d-OJK5Qx05JRUcpK5G1DcYB91wT37hFSzGmIYfwlEtA,42
-arcade_x/tools/tweets.py,sha256=S1Psv-gFePz-8ibnp7rY-GCdogkAm-hJQZpHf7hUusk,7498
-arcade_x/tools/users.py,sha256=gopYKTBOwbZAeVdL_T3vwkepbpv1bdPbqcU_2oPC3SY,2132
-arcade_x/tools/utils.py,sha256=wxPdp3JDG-gEDM7XUNiZSgL61isVE3SRqaLiwYP-K40,5461
-arcade_x-0.1.16.dist-info/METADATA,sha256=7ox9l5R61ZAaxf46r2Bwib5vxmr1OrWB19LSldl_k2Q,835
-arcade_x-0.1.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-arcade_x-0.1.16.dist-info/licenses/LICENSE,sha256=f4Q0XUZJ2MqZBO1XsqqHhuZfSs2ar1cZEJ45150zERo,1067
-arcade_x-0.1.16.dist-info/RECORD,,

arcade_x-0.1.16.dist-info/licenses/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025, Arcade AI
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.