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

intentkit/skills/cryptopanic/schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "CryptoPanic",
+  "description": "CryptoPanic is a news aggregator platform indicating impact on price and market for traders and cryptocurrency enthusiasts.",
+  "x-icon": "https://ai.service.crestal.dev/skills/cryptopanic/cryptopanic.png",
+  "x-tags": [
+    "Data"
+  ],
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "title": "Enabled",
+      "description": "Whether this skill is enabled",
+      "default": false
+    },
+    "states": {
+      "type": "object",
+      "properties": {
+        "fetch_crypto_sentiment": {
+          "type": "string",
+          "title": "Fetch Crypto Sentiment",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "default": "disabled",
+          "description": "Fetches recent CryptoPanic posts and defines market sentiment via LLM analysis."
+        },
+        "fetch_crypto_news": {
+          "type": "string",
+          "title": "Fetch Crypto News",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "default": "disabled",
+          "description": "Fetches latest crypto market news from CryptoPanic across all filters."
+        }
+      },
+      "description": "States for each CryptoPanic 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": "CryptoPanic API Key",
+        "x-link": "[Get your API key](https://cryptopanic.com/developers/api/keys)",
+        "x-sensitive": true,
+        "description": "API key for accessing CryptoPanic API"
+      }
+    },
+    "if": {
+      "properties": {
+        "enabled": {
+          "const": true
+        }
+      }
+    },
+    "then": {
+      "required": [
+        "api_key"
+      ]
+    }
+  },
+  "additionalProperties": true
+}

intentkit/skills/dapplooker/README.md

@@ -0,0 +1,92 @@
+# DappLooker Skill
+
+This skill provides access to the DappLooker API for retrieving comprehensive data and analytics for AI agent tokens.
+
+## Features
+
+The DappLooker skill allows your agent to:
+
+- Retrieve detailed AI agent token market data using token tickers or contract addresses
+- Get real-time price information, market cap, and volume
+- Access technical indicators like support/resistance levels and RSI
+- View token holder insights including distribution and concentration metrics
+- Monitor smart money movements and developer wallet activity
+- Check supply information and token fundamentals
+
+## Key Data Points Available
+
+According to the [DappLooker documentation](https://docs.dapplooker.com/data-apis-for-ai/overview), the API provides:
+
+### Token & Market Data
+- **Token Metrics**: Price, volume, market cap, and liquidity
+- **Technical Indicators**: Support/resistance levels, RSI, SMA, and more
+- **Circulating & Burned Supply**: Information about inflation, scarcity, and value impact
+
+### Agent-Level Intelligence
+- **Agent Mindshare**: Measures visibility and traction across the ecosystem
+- **Confidence Score**: Evaluates project credibility, contract safety, and risks
+- **Historical Context**: Deployment details, contract origin, and dev history
+
+### Smart Money & Whale Flows
+- **Smart Netflows**: Token movements among top wallets (inflows vs. outflows)
+- **Whale Concentration**: Wallet clustering and impact analysis
+- **Top Holder Map**: Visual bubble distribution for wallet-wise token dominance
+
+### Holder Wallets Activity
+- **Wallets Tracking**: Number of linked wallets per protocol & holdings
+- **Token Holder Insights**: Token holder behavior, first 100 buyers data, including snipers
+- **Wallet Funding & Txns**: Inflow/outflow monitoring of developer-related transactions
+
+### Risk Management Analysis
+- **Rug Scanner**: Flags potential risks with agents investment
+- **Project Health Alerts**: Alerts for centralized token ownership and other risks
+
+## Important Note
+
+**This skill is specifically designed for AI agent tokens.** It may not return data for general cryptocurrencies like BTC, ETH, SOL, etc. DappLooker specializes in providing detailed analytics for AI-focused crypto projects.
+
+## Configuration
+
+To use this skill, you'll need to:
+
+1. Enable the skill in your agent configuration
+2. Obtain a DappLooker API key from [DappLooker](https://docs.dapplooker.com/dapplooker-ai/ai-apis)
+3. Configure the skill in your agent settings
+
+### Agent Configuration
+
+```yaml
+skills:
+  dapplooker:
+    enabled: true
+    api_key: "your_dapplooker_api_key"  # Optional if using environment variable
+    states:
+      dapplooker_token_data: public  # or "private" for agent owner only
+```
+
+### Environment Variable
+
+You can also set the DappLooker API key as an environment variable:
+
+```
+DAPPLOOKER_API_KEY=your_dapplooker_api_key
+```
+
+The skill will first check the agent configuration for the API key, and if not found, it will use the environment variable.
+
+## Usage
+
+Your agent can now access AI agent token data by using the `dapplooker_token_data` skill:
+
+- Query by token ticker (e.g., "aixbt,vader") 
+- Query by contract address (e.g., "0x4F9Fd6Be4a90f2620860d680c0d4d5Fb53d1A825")
+- Specify blockchain network (default is "base")
+
+## Example
+
+A user might ask:
+"What's the current price and market metrics for AIXBT token on Base?"
+
+The agent would use the DappLooker skill to retrieve and present this information in a structured format.
+
+If a user asks about non-AI agent tokens like Bitcoin or Ethereum, the skill will inform them that DappLooker specializes in AI agent tokens and suggest querying for AI-focused projects instead. 

intentkit/skills/dapplooker/__init__.py

@@ -0,0 +1,83 @@
+"""DappLooker skills for crypto market data and analytics."""
+
+import logging
+from typing import NotRequired, TypedDict
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.base import SkillConfig, SkillState
+from intentkit.skills.dapplooker.base import DappLookerBaseTool
+from intentkit.skills.dapplooker.dapplooker_token_data import DappLookerTokenData
+
+# Cache skills at the system level, because they are stateless
+_cache: dict[str, DappLookerBaseTool] = {}
+
+logger = logging.getLogger(__name__)
+
+
+class SkillStates(TypedDict):
+    dapplooker_token_data: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration for DappLooker skills."""
+
+    states: SkillStates
+    api_key: NotRequired[str]
+
+
+async def get_skills(
+    config: "Config",
+    is_private: bool,
+    store: SkillStoreABC,
+    **_,
+) -> list[DappLookerBaseTool]:
+    """Get all DappLooker skills.
+
+    Args:
+        config: The configuration for DappLooker skills.
+        is_private: Whether to include private skills.
+        store: The skill store for persisting data.
+
+    Returns:
+        A list of DappLooker skills.
+    """
+    available_skills = []
+
+    # Include skills based on their state
+    for skill_name, state in config["states"].items():
+        if state == "disabled":
+            continue
+        elif state == "public" or (state == "private" and is_private):
+            available_skills.append(skill_name)
+
+    # Get each skill using the cached getter
+    result = []
+    for name in available_skills:
+        skill = get_dapplooker_skill(name, store)
+        if skill:
+            result.append(skill)
+    return result
+
+
+def get_dapplooker_skill(
+    name: str,
+    store: SkillStoreABC,
+) -> DappLookerBaseTool:
+    """Get a DappLooker skill by name.
+
+    Args:
+        name: The name of the skill to get
+        store: The skill store for persisting data
+
+    Returns:
+        The requested DappLooker skill
+    """
+    if name == "dapplooker_token_data":
+        if name not in _cache:
+            _cache[name] = DappLookerTokenData(
+                skill_store=store,
+            )
+        return _cache[name]
+    else:
+        logger.warning(f"Unknown DappLooker skill: {name}")
+        return None

intentkit/skills/dapplooker/base.py

@@ -0,0 +1,26 @@
+from typing import Optional, Type
+
+from pydantic import BaseModel, Field
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.base import IntentKitSkill, SkillContext
+
+
+class DappLookerBaseTool(IntentKitSkill):
+    """Base class for DappLooker tools."""
+
+    name: str = Field(description="The name of the tool")
+    description: str = Field(description="A description of what the tool does")
+    args_schema: Type[BaseModel]
+    skill_store: SkillStoreABC = Field(
+        description="The skill store for persisting data"
+    )
+
+    def get_api_key(self, context: SkillContext) -> Optional[str]:
+        if "api_key" in context.config and context.config["api_key"]:
+            return context.config["api_key"]
+        return self.skill_store.get_system_config("dapplooker_api_key")
+
+    @property
+    def category(self) -> str:
+        return "dapplooker"