intentkit 0.6.7.dev6__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-dev6"
+__version__ = "0.6.7-dev8"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

intentkit/abstracts/skill.py

@@ -179,3 +179,20 @@ class SkillStoreABC(ABC):
             task_id: ID of the task to delete
         """
         pass
+
+    @staticmethod
+    @abstractmethod
+    async def update_autonomous_task(
+        agent_id: str, task_id: str, task_updates: dict
+    ) -> AgentAutonomous:
+        """Update an autonomous task for an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task_id: ID of the task to update
+            task_updates: Dictionary containing fields to update
+
+        Returns:
+            AgentAutonomous: The updated task
+        """
+        pass

intentkit/core/agent.py

@@ -396,3 +396,69 @@ async def delete_autonomous_task(agent_id: str, task_id: str) -> None:
         await session.commit()
 
     logger.info(f"Deleted autonomous task {task_id} from agent {agent_id}")
+
+
+async def update_autonomous_task(
+    agent_id: str, task_id: str, task_updates: dict
+) -> AgentAutonomous:
+    """
+    Update an autonomous task for an agent.
+
+    Args:
+        agent_id: ID of the agent
+        task_id: ID of the task to update
+        task_updates: Dictionary containing fields to update
+
+    Returns:
+        AgentAutonomous: The updated task
+
+    Raises:
+        IntentKitAPIError: If agent is not found or task is not found
+    """
+    agent = await Agent.get(agent_id)
+    if not agent:
+        raise IntentKitAPIError(
+            400, "AgentNotFound", f"Agent with ID {agent_id} does not exist."
+        )
+
+    # Get current autonomous tasks
+    current_tasks: List[AgentAutonomous] = agent.autonomous or []
+
+    # Find and update the task
+    task_found = False
+    updated_tasks: List[AgentAutonomous] = []
+    updated_task = None
+
+    for task_data in current_tasks:
+        if task_data.id == task_id:
+            task_found = True
+            # Create a dictionary with current task data
+            task_dict = task_data.model_dump()
+            # Update with provided fields
+            task_dict.update(task_updates)
+            # Create new AgentAutonomous instance
+            updated_task = AgentAutonomous.model_validate(task_dict)
+            updated_tasks.append(updated_task)
+        else:
+            updated_tasks.append(task_data)
+
+    if not task_found:
+        raise IntentKitAPIError(
+            404, "TaskNotFound", f"Autonomous task with ID {task_id} not found."
+        )
+
+    # Convert all AgentAutonomous objects to dictionaries for JSON serialization
+    serializable_tasks = [task_item.model_dump() for task_item in updated_tasks]
+
+    # Update the agent in the database
+    async with get_session() as session:
+        update_stmt = (
+            update(AgentTable)
+            .where(AgentTable.id == agent_id)
+            .values(autonomous=serializable_tasks)
+        )
+        await session.execute(update_stmt)
+        await session.commit()
+
+    logger.info(f"Updated autonomous task {task_id} for agent {agent_id}")
+    return updated_task

intentkit/core/skill.py

@@ -11,6 +11,9 @@ from intentkit.core.agent import (
 from intentkit.core.agent import (
     list_autonomous_tasks as _list_autonomous_tasks,
 )
+from intentkit.core.agent import (
+    update_autonomous_task as _update_autonomous_task,
+)
 from intentkit.models.agent import Agent, AgentAutonomous
 from intentkit.models.agent_data import AgentData, AgentQuota
 from intentkit.models.skill import (
@@ -177,5 +180,21 @@ class SkillStore(SkillStoreABC):
         """
         await _delete_autonomous_task(agent_id, task_id)
 
+    @staticmethod
+    async def update_autonomous_task(
+        agent_id: str, task_id: str, task_updates: dict
+    ) -> AgentAutonomous:
+        """Update an autonomous task for an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task_id: ID of the task to update
+            task_updates: Dictionary containing fields to update
+
+        Returns:
+            AgentAutonomous: The updated task
+        """
+        return await _update_autonomous_task(agent_id, task_id, task_updates)
+
 
 skill_store = SkillStore()

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):