intentkit 0.5.0__py3-none-any.whl → 0.5.2__py3-none-any.whl

intentkit/skills/cryptocompare/schema.json

@@ -0,0 +1,168 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "CryptoCompare",
+  "description": "Integration with CryptoCompare API providing cryptocurrency market data, price information, and crypto news with rate limiting capabilities",
+  "x-icon": "https://ai.service.crestal.dev/skills/cryptocompare/cryptocompare.png",
+  "x-tags": [
+    "Blockchain",
+    "Finance"
+  ],
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "title": "Enabled",
+      "description": "Whether this skill is enabled",
+      "default": false
+    },
+    "states": {
+      "type": "object",
+      "properties": {
+        "fetch_news": {
+          "type": "string",
+          "title": "Fetch News",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "This tool fetches the latest cryptocurrency news articles for a specific token.\nYou can optionally specify a timestamp to get historical news, otherwise it uses the current time.\nReturns articles in English with details like title, body, source, and publish time.",
+          "default": "disabled"
+        },
+        "fetch_price": {
+          "type": "string",
+          "title": "Fetch Price",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Provides real-time cryptocurrency pricing with multi-exchange aggregation and historical comparisons",
+          "default": "disabled"
+        },
+        "fetch_trading_signals": {
+          "type": "string",
+          "title": "Fetch Trading Signals",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Generates technical analysis signals using indicators like RSI, MACD, and Bollinger Bands",
+          "default": "disabled"
+        },
+        "fetch_top_market_cap": {
+          "type": "string",
+          "title": "Fetch Top Market Cap",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Tracks top cryptocurrencies by market capitalization with sector breakdowns",
+          "default": "disabled"
+        },
+        "fetch_top_exchanges": {
+          "type": "string",
+          "title": "Fetch Top Exchanges",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Ranks cryptocurrency exchanges by liquidity and trading volume with market pair analysis",
+          "default": "disabled"
+        },
+        "fetch_top_volume": {
+          "type": "string",
+          "title": "Fetch Top Volume",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Analyzes 24h trading volume trends across exchanges and currency pairs",
+          "default": "disabled"
+        }
+      },
+      "description": "States for each CryptoCompare skill (disabled, public, or private)"
+    },
+    "api_key_provider": {
+      "type": "string",
+      "title": "API Key Provider",
+      "description": "Provider of the API key for AIXBT API service",
+      "enum": [
+        "agent_owner"
+      ],
+      "x-enum-title": [
+        "Owner Provided"
+      ],
+      "default": "agent_owner"
+    }
+  },
+  "required": [
+    "states",
+    "enabled"
+  ],
+  "if": {
+    "properties": {
+      "api_key_provider": {
+        "const": "agent_owner"
+      }
+    }
+  },
+  "then": {
+    "properties": {
+      "api_key": {
+        "type": "string",
+        "title": "CryptoCompare API Key",
+        "x-link": "[Get your API key](https://www.cryptocompare.com/cryptopian/api-keys)",
+        "x-sensitive": true,
+        "description": "CryptoCompare API key for authentication"
+      }
+    },
+    "if": {
+      "properties": {
+        "enabled": {
+          "const": true
+        }
+      }
+    },
+    "then": {
+      "required": [
+        "api_key"
+      ]
+    }
+  },
+  "additionalProperties": true
+}

intentkit/skills/cryptopanic/__init__.py

@@ -0,0 +1,108 @@
+"""CryptoPanic skill module for IntentKit.
+
+Loads and initializes skills for fetching crypto news and providing market insights using CryptoPanic API.
+"""
+
+import logging
+from typing import Dict, List, Optional, TypedDict
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.base import SkillConfig, SkillState
+
+from .base import CryptopanicBaseTool
+
+logger = logging.getLogger(__name__)
+
+# Cache for skill instances
+_skill_cache: Dict[str, CryptopanicBaseTool] = {}
+
+
+class SkillStates(TypedDict):
+    """Type definition for CryptoPanic skill states."""
+
+    fetch_crypto_news: SkillState
+    fetch_crypto_sentiment: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration schema for CryptoPanic skills."""
+
+    states: SkillStates
+    api_key: str
+
+
+async def get_skills(
+    config: Config,
+    is_private: bool,
+    store: SkillStoreABC,
+    **kwargs,
+) -> List[CryptopanicBaseTool]:
+    """Load CryptoPanic skills based on configuration.
+
+    Args:
+        config: Skill configuration with states and API key.
+        is_private: Whether the context is private (affects skill visibility).
+        store: Skill store for accessing other skills.
+        **kwargs: Additional keyword arguments.
+
+    Returns:
+        List of loaded CryptoPanic skill instances.
+    """
+    logger.info("Loading CryptoPanic skills")
+    available_skills = []
+
+    for skill_name, state in config["states"].items():
+        logger.debug("Checking skill: %s, state: %s", skill_name, state)
+        if state == "disabled":
+            continue
+        if state == "public" or (state == "private" and is_private):
+            available_skills.append(skill_name)
+
+    loaded_skills = []
+    for name in available_skills:
+        skill = get_cryptopanic_skill(name, store)
+        if skill:
+            logger.info("Successfully loaded skill: %s", name)
+            loaded_skills.append(skill)
+        else:
+            logger.warning("Failed to load skill: %s", name)
+
+    return loaded_skills
+
+
+def get_cryptopanic_skill(
+    name: str,
+    store: SkillStoreABC,
+) -> Optional[CryptopanicBaseTool]:
+    """Retrieve a CryptoPanic skill instance by name.
+
+    Args:
+        name: Name of the skill (e.g., 'fetch_crypto_news', 'fetch_crypto_sentiment').
+        store: Skill store for accessing other skills.
+
+    Returns:
+        CryptoPanic skill instance or None if not found or import fails.
+    """
+    if name in _skill_cache:
+        logger.debug("Retrieved cached skill: %s", name)
+        return _skill_cache[name]
+
+    try:
+        if name == "fetch_crypto_news":
+            from .fetch_crypto_news import FetchCryptoNews
+
+            _skill_cache[name] = FetchCryptoNews(skill_store=store)
+        elif name == "fetch_crypto_sentiment":
+            from .fetch_crypto_sentiment import FetchCryptoSentiment
+
+            _skill_cache[name] = FetchCryptoSentiment(skill_store=store)
+        else:
+            logger.warning("Unknown CryptoPanic skill: %s", name)
+            return None
+
+        logger.debug("Cached new skill instance: %s", name)
+        return _skill_cache[name]
+
+    except ImportError as e:
+        logger.error("Failed to import CryptoPanic skill %s: %s", name, e)
+        return None

intentkit/skills/cryptopanic/base.py

@@ -0,0 +1,51 @@
+"""Base module for CryptoPanic skills.
+
+Defines the base class and shared utilities for CryptoPanic skills.
+"""
+
+from typing import Type
+
+from langchain.tools.base import ToolException
+from pydantic import BaseModel, Field
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.base import IntentKitSkill, SkillContext
+
+base_url = "https://cryptopanic.com/api/v1/posts/"
+
+
+class CryptopanicBaseTool(IntentKitSkill):
+    """Base class for CryptoPanic skills.
+
+    Provides common functionality for interacting with the CryptoPanic API,
+    including API key retrieval and skill store access.
+    """
+
+    name: str = Field(description="Tool name")
+    description: str = Field(description="Tool description")
+    args_schema: Type[BaseModel]
+    skill_store: SkillStoreABC = Field(description="Skill store for data persistence")
+
+    def get_api_key(self, context: SkillContext) -> str:
+        """Retrieve the CryptoPanic API key from context.
+
+        Args:
+            context: Skill context containing configuration.
+
+        Returns:
+            API key string.
+
+        Raises:
+            ToolException: If the API key is not found.
+        """
+        api_key = context.config.get("api_key")
+        if not api_key:
+            raise ToolException(
+                "CryptoPanic API key not found in context.config['api_key']"
+            )
+        return api_key
+
+    @property
+    def category(self) -> str:
+        """Category of the skill."""
+        return "cryptopanic"

intentkit/skills/cryptopanic/fetch_crypto_news.py

@@ -0,0 +1,153 @@
+"""Skill to fetch the latest crypto market news from CryptoPanic API.
+
+Fetches all news posts for BTC or ETH, sorted by publication date (newest first).
+"""
+
+from typing import List, Type
+
+import httpx
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.cryptopanic.base import CryptopanicBaseTool
+
+SUPPORTED_CURRENCIES = ["BTC", "ETH"]
+BASE_URL = "https://cryptopanic.com/api/v1/posts/"
+
+
+class CryptopanicNewsInput(BaseModel):
+    """Input schema for fetching crypto news."""
+
+    query: str = Field(description="Query to specify currency (e.g., 'btc news')")
+    currency: str = Field(
+        default="BTC", description="Currency to fetch news for (BTC or ETH)"
+    )
+
+
+class NewsItem(BaseModel):
+    """Data model for a single news item."""
+
+    title: str = Field(description="News headline")
+    published_at: str = Field(description="Publication timestamp")
+    source: str = Field(description="News source domain")
+
+
+class CryptopanicNewsOutput(BaseModel):
+    """Output schema for fetching crypto news."""
+
+    currency: str = Field(description="Currency news was fetched for")
+    news_items: List[NewsItem] = Field(description="List of news items")
+    summary: str = Field(description="Summary of fetched news")
+
+
+class FetchCryptoNews(CryptopanicBaseTool):
+    """Skill to fetch the latest crypto market news from CryptoPanic API."""
+
+    name: str = "fetch_crypto_news"
+    description: str = (
+        "Fetches all crypto market news posts from CryptoPanic for BTC or ETH, "
+        "sorted by publication date (newest first). Defaults to BTC."
+    )
+    args_schema: Type[BaseModel] = CryptopanicNewsInput
+    skill_store: SkillStoreABC = Field(description="Skill store for data persistence")
+
+    async def fetch_news(
+        self,
+        currency: str,
+        api_key: str,
+    ) -> List[NewsItem]:
+        """Fetch the latest news for a specific currency from CryptoPanic API.
+
+        Args:
+            currency: Currency to fetch news for (BTC or ETH).
+            api_key: CryptoPanic API key.
+
+        Returns:
+            List of NewsItem objects, sorted by publication date (newest first).
+
+        Raises:
+            ToolException: If the API request fails or data is invalid.
+        """
+        from langchain.tools.base import ToolException
+
+        if currency not in SUPPORTED_CURRENCIES:
+            raise ToolException(f"Unsupported currency: {currency}")
+
+        params = {
+            "auth_token": api_key,
+            "public": "true",
+            "currencies": currency.upper(),
+            "sort": "-published_at",  # Sort by newest first
+        }
+
+        async with httpx.AsyncClient() as client:
+            try:
+                response = await client.get(BASE_URL, params=params, timeout=10)
+                response.raise_for_status()
+                data = response.json().get("results", [])
+                return [
+                    NewsItem(
+                        title=post["title"],
+                        published_at=post.get("published_at", "Unknown"),
+                        source=post.get("source", {}).get("domain", "CryptoPanic"),
+                    )
+                    for post in data
+                ]
+            except (httpx.RequestError, httpx.HTTPStatusError) as e:
+                raise ToolException(f"Error fetching news from CryptoPanic: {e}")
+
+    async def _arun(
+        self,
+        query: str = "",
+        currency: str = "BTC",
+        config: RunnableConfig = None,
+        **kwargs,
+    ) -> CryptopanicNewsOutput:
+        """Fetch the latest crypto news asynchronously.
+
+        Args:
+            query: Query to specify currency (e.g., 'btc news').
+            currency: Currency to fetch news for (defaults to BTC).
+            config: Runnable configuration.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            CryptopanicNewsOutput with news items and summary.
+
+        Raises:
+            ToolException: If the API key is missing or request fails.
+        """
+
+        currency = currency.upper() if currency else "BTC"
+        if currency not in SUPPORTED_CURRENCIES:
+            currency = "BTC"
+
+        context = self.context_from_config(config)
+        api_key = self.get_api_key(context)
+
+        news_items = await self.fetch_news(currency, api_key)
+
+        # Deduplicate news items by title
+        seen_titles = set()
+        unique_news_items = [
+            item
+            for item in news_items
+            if item.title not in seen_titles and not seen_titles.add(item.title)
+        ]
+
+        total_items = len(unique_news_items)
+        summary = (
+            f"Fetched {total_items} unique news posts for {currency}, sorted by recency."
+            if unique_news_items
+            else f"No news posts found for {currency}."
+        )
+
+        return CryptopanicNewsOutput(
+            currency=currency,
+            news_items=unique_news_items,
+            summary=summary,
+        )
+
+    def _run(self, question: str):
+        raise NotImplementedError("Use _arun for async execution")

intentkit/skills/cryptopanic/fetch_crypto_sentiment.py

@@ -0,0 +1,136 @@
+"""Skill to provide AI-driven insights on crypto market conditions using CryptoPanic news."""
+
+from typing import ClassVar, List, Type
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.cryptopanic.base import CryptopanicBaseTool
+
+SUPPORTED_CURRENCIES = ["BTC", "ETH"]
+
+
+class CryptopanicSentimentInput(BaseModel):
+    """Input schema for fetching crypto market insights."""
+
+    currency: str = Field(default="BTC", description="Currency to analyze (BTC or ETH)")
+
+
+class CryptopanicSentimentOutput(BaseModel):
+    """Output schema for crypto market insights."""
+
+    currency: str = Field(description="Currency analyzed")
+    total_posts: int = Field(description="Number of news items analyzed")
+    headlines: list[str] = Field(description="List of news headlines")
+    prompt: str = Field(description="Formatted prompt for LLM insights")
+    summary: str = Field(description="Summary of analysis process")
+
+
+class CryptopanicNewsOutput(BaseModel):
+    """Output schema for fetching crypto news (used internally)."""
+
+    currency: str = Field(description="Currency news was fetched for")
+    news_items: List[BaseModel] = Field(description="List of news items")
+    summary: str = Field(description="Summary of fetched news")
+
+
+class FetchCryptoSentiment(CryptopanicBaseTool):
+    """Skill to provide AI-driven insights on crypto market conditions using CryptoPanic news."""
+
+    name: str = "fetch_crypto_sentiment"
+    description: str = (
+        "Provides AI-driven insights on market conditions for BTC or ETH, including trends, "
+        "opportunities, risks, and outlook, based on news fetched from fetch_crypto_news "
+        "with all posts sorted by recency. Triggered by 'sentiment' or 'market state' queries. "
+        "Defaults to BTC."
+    )
+    args_schema: Type[BaseModel] = CryptopanicSentimentInput
+    skill_store: SkillStoreABC = Field(description="Skill store for data persistence")
+
+    INSIGHTS_PROMPT: ClassVar[str] = """
+CryptoPanic Headlines for {currency}:
+{headlines}
+
+Total Posts: {total_posts}
+Currency: {currency}
+
+Based on these headlines, provide AI-driven insights into the market conditions for {currency}. 
+Summarize key trends (e.g., price movements, adoption, network developments) inferred from the news. 
+Identify significant opportunities (e.g., growth potential) and risks (e.g., negative sentiment, competition). 
+Classify the overall market outlook as Bullish, Bearish and provide opinion on wether to buy, sell or hold.
+Conclude with a short-term outlook for {currency}. Provide a concise, professional analysis without headings.
+    """
+
+    async def _arun(
+        self,
+        currency: str = "BTC",
+        config: RunnableConfig = None,
+        **kwargs,
+    ) -> CryptopanicSentimentOutput:
+        """Generate AI-driven market insights asynchronously.
+
+        Args:
+            currency: Currency to analyze (defaults to BTC).
+            config: Runnable configuration.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            CryptopanicSentimentOutput with market insights.
+
+        Raises:
+            ToolException: If news fetching fails.
+        """
+        from langchain.tools.base import ToolException
+
+        from intentkit.skills.cryptopanic.fetch_crypto_news import (
+            FetchCryptoNews,
+        )  # Import here to avoid circular import
+
+        currency = currency.upper() if currency else "BTC"
+        if currency not in SUPPORTED_CURRENCIES:
+            currency = "BTC"
+
+        # Instantiate FetchCryptoNews
+        news_skill = FetchCryptoNews(skill_store=self.skill_store)
+
+        try:
+            news_output: CryptopanicNewsOutput = await news_skill._arun(
+                query=f"insights for {currency}",
+                currency=currency,
+                config=config,
+            )
+        except Exception as e:
+            raise ToolException(f"Failed to fetch news for analysis: {e}")
+
+        news_items = news_output.news_items
+        total_posts = len(news_items)
+
+        if total_posts == 0:
+            headlines = ["No recent news available"]
+            summary = f"No news found for {currency} to analyze."
+        else:
+            headlines = [item.title for item in news_items[:5]]  # Limit to 5
+            summary = f"Generated insights for {currency} based on {total_posts} news items sorted by recency."
+
+        # Format headlines as numbered list
+        formatted_headlines = "\n".join(
+            f"{i + 1}. {headline}" for i, headline in enumerate(headlines)
+        )
+
+        prompt = self.INSIGHTS_PROMPT.format(
+            total_posts=total_posts,
+            currency=currency,
+            headlines=formatted_headlines,
+        )
+
+        return CryptopanicSentimentOutput(
+            currency=currency,
+            total_posts=total_posts,
+            headlines=headlines,
+            prompt=prompt,
+            summary=summary,
+        )
+
+    def _run(self, question: str):
+        raise NotImplementedError("Use _arun for async execution")