arcade-x 1.0.0__py3-none-any.whl → 1.1.1__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-1.0.0.dist-info → arcade_x-1.1.1.dist-info}/METADATA

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: arcade_x
-Version: 1.0.0
+Version: 1.1.1
 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
+Requires-Dist: arcade-tdk<4.0.0,>=3.0.0
 Requires-Dist: httpx<1.0.0,>=0.27.2
 Provides-Extra: dev
-Requires-Dist: arcade-ai[evals]<3.0.0,>=2.0.0; extra == 'dev'
-Requires-Dist: arcade-serve<3.0.0,>=2.0.0; extra == 'dev'
+Requires-Dist: arcade-mcp[evals]<2.0.0,>=1.1.0; extra == 'dev'
+Requires-Dist: arcade-serve<4.0.0,>=3.0.0; extra == 'dev'
 Requires-Dist: mypy<1.6.0,>=1.5.1; extra == 'dev'
 Requires-Dist: pre-commit<3.5.0,>=3.4.0; extra == 'dev'
 Requires-Dist: pytest-asyncio<0.25.0,>=0.24.0; extra == 'dev'

arcade_x-1.1.1.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.1.dist-info/METADATA,sha256=Sy3KedtCp4On90A6gekRMTaOoeSp3G7wvLXxj9UlR4Y,897
+arcade_x-1.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+arcade_x-1.1.1.dist-info/licenses/LICENSE,sha256=ixeE7aL9b2B-_ZYHTY1vQcJB4NufKeo-LWwKNObGDN0,1960
+arcade_x-1.1.1.dist-info/RECORD,,

arcade_x-1.0.0.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-1.0.0.dist-info/METADATA,sha256=0_sk7qdtG0g4jZ_BYI5ewed2hVDwCA2VcqLCRnBzEoA,896
-arcade_x-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-arcade_x-1.0.0.dist-info/licenses/LICENSE,sha256=ixeE7aL9b2B-_ZYHTY1vQcJB4NufKeo-LWwKNObGDN0,1960
-arcade_x-1.0.0.dist-info/RECORD,,