intentkit 0.6.7.dev7__py3-none-any.whl → 0.6.7.dev8__py3-none-any.whl

intentkit/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.6.7-dev7"
+__version__ = "0.6.7-dev8"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

intentkit/skills/elfa/README.md

@@ -1,6 +1,12 @@
 # Elfa Skills - Social Media Intelligence
 
-Integration with [Elfa AI API](https://api.elfa.ai) providing real-time social media data analysis and processing capabilities for crypto and stock market sentiment tracking.
+Integration with [Elfa AI API v2](https://api.elfa.ai/v2) providing real-time social media data analysis and processing capabilities for crypto and stock market sentiment tracking.
+
+**Important: V2 API Changes**
+- **No Raw Content**: V2 API removes raw tweet content for platform compliance
+- **Sanitized Data**: Returns engagement metrics, timestamps, and account metadata only
+- **New Endpoints**: Updated endpoints with consistent response format
+- **Enhanced Pagination**: Different pagination patterns for search vs aggregation endpoints
 
 ## Setup
 
@@ -15,86 +21,132 @@ ELFA_API_KEY=your_elfa_api_key_here
 
 Ranks the most discussed tokens based on smart mentions count for a given period, updated every 5 minutes.
 
+**Endpoint**: `v2/aggregations/trending-tokens` - Direct Migration
+
 **Example Prompts:**
 ```
 "What are the trending crypto tokens in the last 24 hours?"
-"Show me the most discussed tokens today with at least 10 mentions"
-"Get trending tokens for the past week"
-"Which tokens are gaining attention on social media?"
+"Get trending tokens with minimum 50 mentions in the past week"
 ```
 
 **Parameters:**
-- `timeWindow`: "1h", "24h", "7d" (default: "24h")
+- `timeWindow`: "30m", "1h", "4h", "24h", "7d", "30d" (default: "7d")
+- `page`: Page number for pagination (default: 1)
+- `pageSize`: Number of items per page (default: 50)
 - `minMentions`: Minimum mentions required (default: 5)
 
+**V2 Changes:**
+- Same functionality and parameters
+- Enhanced response format with metadata
+- Uses page+pageSize pagination for aggregations
+
 ---
 
 ### 2. Get Top Mentions (`get_top_mentions`)
 
 Queries tweets mentioning a specific stock/crypto ticker, ranked by view count for market sentiment analysis.
 
+**Endpoint**: `v2/data/top-mentions` - Breaking Changes
+
 **Example Prompts:**
 ```
 "Get the top mentions for Bitcoin in the last 24 hours"
-"Show me the most viewed tweets about $ETH today"
-"What are people saying about TSLA stock on Twitter?"
-"Find viral tweets mentioning $SOL with account details"
+"Show me engagement metrics for tweets about $ETH today"
 ```
 
 **Parameters:**
-- `ticker`: Stock/crypto symbol (e.g., "BTC", "$ETH", "AAPL")
-- `timeWindow`: "24h", "7d" (default: "24h") 
-- `includeAccountDetails`: Include account info (default: false)
+- `ticker`: Stock/crypto symbol (e.g., "BTC", "$ETH", "AAPL") - required
+- `timeWindow`: "1h", "24h", "7d" (default: "1h")
+- `page`: Page number for pagination (default: 1)
+- `pageSize`: Number of items per page (default: 10)
+
+**V2 Changes:**
+- **Removed**: Raw tweet content/text
+- **Removed**: `includeAccountDetails` parameter (always included)
+- **Preserved**: Engagement metrics (view_count, like_count, etc.)
+- **Preserved**: Account information and verification status
+- **Enhanced**: Account tags (e.g., "smart" accounts)
 
 ---
 
 ### 3. Search Mentions (`search_mentions`)
 
-Searches tweets mentioning up to 5 keywords. Can access 30 days of recent data (updated every 5 minutes) or 6 months of historical data.
-
-**Example Prompts:**
-```
-"Search for tweets mentioning 'DeFi, NFT, blockchain'"
-"Find recent mentions of 'AI, artificial intelligence, machine learning'"
-"Search historical tweets about 'bitcoin, cryptocurrency' from last month"
-"Look for discussions about 'climate change, renewable energy'"
-```
-
-**Parameters:**
-- `keywords`: Up to 5 keywords (comma-separated, phrases accepted)
-- `from_`: Start timestamp (default: 24 hours ago)
-- `to`: End timestamp (default: yesterday)
-
----
-
-### 4. Get Mentions (`get_mentions`)
+Searches tweets mentioning up to 5 keywords or from specific accounts with sanitized engagement data.
 
-Retrieves hourly-updated tweets from "smart accounts" (influential accounts) that have received at least 10 interactions.
+**Endpoint**: `v2/data/keyword-mentions` - Breaking Changes
 
 **Example Prompts:**
 ```
-"Get the latest mentions from smart accounts"
-"Show me recent tweets from influential crypto accounts"
-"What are the smart accounts talking about?"
-"Get the latest buzz from verified influencers"
+"Search for engagement metrics of tweets mentioning 'DeFi, NFT, blockchain'"
+"Find tweets from account 'elonmusk' about cryptocurrency"
 ```
 
-**Parameters:** None (uses default limits)
+**Parameters:**
+- `keywords`: Up to 5 keywords (comma-separated, phrases accepted) - optional if accountName provided
+- `accountName`: Account username to filter by - optional if keywords provided  
+- `timeWindow`: Time window for search (default: "7d")
+- `limit`: Number of results to return, max 30 (default: 20)
+- `searchType`: Type of search - "and" or "or" (default: "or")
+- `cursor`: Cursor for pagination (optional)
+
+**V2 Changes:**
+- **Removed**: Raw tweet content/text
+- **Preserved**: Engagement metrics and sentiment analysis
+- **Enhanced**: Account filtering with `accountName` parameter
+- **Updated**: Uses limit+cursor pagination for search
+- **Added**: Account tags and metadata
 
 ---
 
-### 5. Get Smart Stats (`get_smart_stats`)
+### 4. Get Smart Stats (`get_smart_stats`)
 
 Retrieves key social media metrics for a specific username including engagement ratios and smart following count.
 
+**Endpoint**: `v2/account/smart-stats` - Direct Migration
+
 **Example Prompts:**
 ```
 "Get smart stats for @elonmusk"
 "Analyze the social metrics for username 'VitalikButerin'"
-"Show me engagement stats for @cz_binance"
-"What are the social media metrics for @jack?"
 ```
 
 **Parameters:**
-- `username`: Twitter username (with or without @)
+- `username`: Twitter username (with or without @) - required
+
+**V2 Changes:**
+- Same functionality and parameters
+- Consistent response format with metadata
+
+## V2 Response Format
+
+All V2 endpoints return a consistent format:
+
+```json
+{
+  "success": boolean,
+  "data": [...], // Array or object with actual data
+  "metadata": {  // Pagination and additional info
+    "total": number,
+    "page": number,
+    "pageSize": number,
+    "cursor": "string" // For search endpoints
+  }
+}
+```
+
+## Migration Notes
+
+### What's Removed in V2:
+- Raw tweet content/text (compliance requirement)
+- Direct access to tweet body/message content
+- `includeAccountDetails` parameter (always included)
+- **Deprecated**: `get_mentions` skill (no v2 equivalent)
+
+### What's Preserved:
+- Engagement metrics (likes, views, reposts, replies)
+- Account information and verification status
+- Timestamps and metadata
+- Sentiment analysis
+- Core functionality for trend analysis
+
 

intentkit/skills/elfa/__init__.py

@@ -7,7 +7,6 @@ from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.base import SkillConfig, SkillState
 from intentkit.skills.elfa.base import ElfaBaseTool
 from intentkit.skills.elfa.mention import (
-    ElfaGetMentions,
     ElfaGetTopMentions,
     ElfaSearchMentions,
 )
@@ -21,7 +20,6 @@ logger = logging.getLogger(__name__)
 
 
 class SkillStates(TypedDict):
-    get_mentions: SkillState
     get_top_mentions: SkillState
     search_mentions: SkillState
     get_trending_tokens: SkillState
@@ -83,14 +81,7 @@ def get_elfa_skill(
         The requested Elfa skill
     """
 
-    if name == "get_mentions":
-        if name not in _cache:
-            _cache[name] = ElfaGetMentions(
-                skill_store=store,
-            )
-        return _cache[name]
-
-    elif name == "get_top_mentions":
+    if name == "get_top_mentions":
         if name not in _cache:
             _cache[name] = ElfaGetTopMentions(
                 skill_store=store,

intentkit/skills/elfa/base.py

@@ -5,7 +5,7 @@ from pydantic import BaseModel, Field
 from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.base import IntentKitSkill, SkillContext
 
-base_url = "https://api.elfa.ai"
+base_url = "https://api.elfa.ai/v2"
 
 
 class ElfaBaseTool(IntentKitSkill):