intentkit 0.6.20.dev1__tar.gz → 0.6.21__tar.gz

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.6.20.dev1
+Version: 0.6.21
 Summary: Intent-based AI Agent Platform - Core Package
-Project-URL: Homepage, https://github.com/crestal-network/intentkit
-Project-URL: Repository, https://github.com/crestal-network/intentkit
-Project-URL: Documentation, https://github.com/crestal-network/intentkit/tree/main/docs
-Project-URL: Bug Tracker, https://github.com/crestal-network/intentkit/issues
+Project-URL: Homepage, https://github.com/crestalnetwork/intentkit
+Project-URL: Repository, https://github.com/crestalnetwork/intentkit
+Project-URL: Documentation, https://github.com/crestalnetwork/intentkit/tree/main/docs
+Project-URL: Bug Tracker, https://github.com/crestalnetwork/intentkit/issues
 Author-email: hyacinthus <hyacinthus@gmail.com>
 License: MIT License
         

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.6.20-dev.1"
+__version__ = "0.6.21"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/clients/__init__.py

@@ -4,6 +4,7 @@ from intentkit.clients.twitter import (
     TwitterClientConfig,
     get_twitter_client,
 )
+from intentkit.clients.web3 import get_web3_client
 
 __all__ = [
     "TwitterClient",
@@ -11,4 +12,5 @@ __all__ = [
     "get_twitter_client",
     "CdpClient",
     "get_cdp_client",
+    "get_web3_client",
 ]

intentkit-0.6.21/clients/web3.py

@@ -0,0 +1,32 @@
+from typing import Dict
+
+from web3 import Web3
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.utils.chain import ChainProvider
+
+# Global cache for Web3 clients by network_id
+_web3_client_cache: Dict[str, Web3] = {}
+
+
+def get_web3_client(network_id: str, skill_store: SkillStoreABC) -> Web3:
+    """Get a Web3 client for the specified network.
+
+    Args:
+        network_id: The network ID to get the Web3 client for
+        skill_store: The skill store to get system configuration from
+
+    Returns:
+        Web3: A Web3 client instance for the specified network
+    """
+    # Check global cache first
+    if network_id in _web3_client_cache:
+        return _web3_client_cache[network_id]
+
+    # Create new Web3 client and cache it
+    chain_provider: ChainProvider = skill_store.get_system_config("chain_provider")
+    chain = chain_provider.get_chain_config(network_id)
+    web3_client = Web3(Web3.HTTPProvider(chain.rpc_url))
+    _web3_client_cache[network_id] = web3_client
+
+    return web3_client

intentkit-0.6.21/core/chat.py

@@ -0,0 +1,51 @@
+"""Chat memory management utilities.
+
+This module provides functions for managing chat thread memory,
+including clearing thread history using LangGraph's checkpointer.
+"""
+
+import logging
+
+from intentkit.models.db import get_langgraph_checkpointer
+from intentkit.utils.error import IntentKitAPIError
+
+logger = logging.getLogger(__name__)
+
+
+async def clear_thread_memory(agent_id: str, chat_id: str) -> bool:
+    """Clear all memory content for a specific thread.
+
+    This function uses LangGraph's official checkpointer.delete_thread() method
+    to permanently remove all stored checkpoints and conversation history
+    associated with the specified thread.
+
+    Args:
+        agent_id (str): The agent identifier
+        chat_id (str): The chat identifier
+
+    Returns:
+        bool: True if the thread memory was successfully cleared
+
+    Raises:
+        IntentKitAPIError: If there's an error clearing the thread memory
+    """
+    try:
+        # Construct thread_id by combining agent_id and chat_id
+        thread_id = f"{agent_id}_{chat_id}"
+
+        # Get the LangGraph checkpointer instance
+        checkpointer = get_langgraph_checkpointer()
+
+        # Use the official LangGraph method to delete all thread content
+        await checkpointer.delete_thread(thread_id)
+
+        logger.info(f"Successfully cleared thread memory for thread_id: {thread_id}")
+        return True
+
+    except Exception as e:
+        logger.error(
+            f"Failed to clear thread memory for agent_id: {agent_id}, chat_id: {chat_id}. Error: {str(e)}"
+        )
+        raise IntentKitAPIError(
+            500, "ThreadMemoryClearError", f"Failed to clear thread memory: {str(e)}"
+        )

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/models/agent_schema.json

@@ -67,31 +67,6 @@
       "x-group": "basic",
       "x-placeholder": "Enter agent name"
     },
-    "ticker": {
-      "title": "Ticker",
-      "type": "string",
-      "description": "Ticker symbol of the agent",
-      "maxLength": 10,
-      "minLength": 1,
-      "x-group": "internal",
-      "x-placeholder": "Enter agent ticker"
-    },
-    "token_address": {
-      "title": "Token Address",
-      "type": "string",
-      "description": "Token address of the agent",
-      "maxLength": 42,
-      "readOnly": true,
-      "x-group": "internal"
-    },
-    "token_pool": {
-      "title": "Token Pool",
-      "type": "string",
-      "description": "Pool of the agent token",
-      "maxLength": 42,
-      "readOnly": true,
-      "x-group": "internal"
-    },
     "mode": {
       "title": "Usage Type",
       "type": "string",
@@ -700,6 +675,29 @@
         "optimism-sepolia"
       ],
       "x-group": "onchain"
+    },
+    "ticker": {
+      "title": "Ticker",
+      "type": "string",
+      "description": "Ticker symbol of the agent",
+      "maxLength": 10,
+      "minLength": 1,
+      "x-group": "onchain",
+      "x-placeholder": "Enter agent ticker"
+    },
+    "token_address": {
+      "title": "Token Address",
+      "type": "string",
+      "description": "Token address of the agent, if it already has one",
+      "maxLength": 42,
+      "x-group": "onchain"
+    },
+    "token_pool": {
+      "title": "Token Pool",
+      "type": "string",
+      "description": "Pool of the agent token, if it has one",
+      "maxLength": 42,
+      "x-group": "onchain"
     }
   },
   "if": {

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "intentkit"
-version = "0.6.20-dev.1"
+version = "0.6.21"
 description = "Intent-based AI Agent Platform - Core Package"
 authors = [{ name = "hyacinthus", email = "hyacinthus@gmail.com" }]
 requires-python = ">=3.12"
@@ -71,10 +71,10 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/crestal-network/intentkit"
-Repository = "https://github.com/crestal-network/intentkit"
-Documentation = "https://github.com/crestal-network/intentkit/tree/main/docs"
-"Bug Tracker" = "https://github.com/crestal-network/intentkit/issues"
+Homepage = "https://github.com/crestalnetwork/intentkit"
+Repository = "https://github.com/crestalnetwork/intentkit"
+Documentation = "https://github.com/crestalnetwork/intentkit/tree/main/docs"
+"Bug Tracker" = "https://github.com/crestalnetwork/intentkit/issues"
 
 [dependency-groups]
 dev = [

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/base.py

@@ -1,4 +1,3 @@
-import asyncio
 import logging
 from typing import Any, Callable, Dict, Literal, NotRequired, Optional, TypedDict, Union
 
@@ -6,15 +5,15 @@ from langchain_core.tools import BaseTool
 from langchain_core.tools.base import ToolException
 from langgraph.runtime import get_runtime
 from pydantic import (
-    BaseModel,
     ValidationError,
 )
 from pydantic.v1 import ValidationError as ValidationErrorV1
 from redis.exceptions import RedisError
+from web3 import Web3
 
 from intentkit.abstracts.graph import AgentContext
 from intentkit.abstracts.skill import SkillStoreABC
-from intentkit.models.agent import Agent
+from intentkit.clients.web3 import get_web3_client
 from intentkit.models.redis import get_redis
 from intentkit.utils.error import RateLimitExceeded
 
@@ -32,36 +31,6 @@ class SkillConfig(TypedDict):
     __extra__: NotRequired[Dict[str, Any]]
 
 
-class SkillContext(BaseModel):
-    skill_category: str
-    agent_id: str
-    user_id: Optional[str] = None
-    chat_id: Optional[str] = None
-    app_id: Optional[str] = None
-    entrypoint: Literal["web", "twitter", "telegram", "trigger", "api"]
-    is_private: bool
-    payer: Optional[str] = None
-    _agent: Optional[Agent] = None
-
-    @property
-    def agent(self) -> Agent:
-        if self._agent is None:
-            self._agent = asyncio.run(Agent.get(self.agent_id))
-        return self._agent
-
-    @property
-    def config(self) -> Dict[str, Any]:
-        agent = self.agent
-        config = None
-        if agent.skills:
-            config = agent.skills.get(self.skill_category)
-        if not config:
-            raise ValueError(
-                f"Skill {self.skill_category} not found in agent {self.agent_id}"
-            )
-        return config
-
-
 class IntentKitSkill(BaseTool):
     """Abstract base class for IntentKit skills.
     Will have predefined abilities.
@@ -185,3 +154,11 @@ class IntentKitSkill(BaseTool):
         if runtime.context is None or not isinstance(runtime.context, AgentContext):
             raise ValueError("No AgentContext found")
         return runtime.context
+
+    def web3_client(self) -> Web3:
+        """Get a Web3 client for the skill."""
+        context = self.get_context()
+        agent = context.agent
+        network_id = agent.network_id
+
+        return get_web3_client(network_id, self.skill_store)

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/defillama/base.py

@@ -5,8 +5,9 @@ from typing import Type
 
 from pydantic import BaseModel, Field
 
+from intentkit.abstracts.graph import AgentContext
 from intentkit.abstracts.skill import SkillStoreABC
-from intentkit.skills.base import IntentKitSkill, SkillContext
+from intentkit.skills.base import IntentKitSkill
 from intentkit.skills.defillama.config.chains import (
     get_chain_from_alias,
 )
@@ -39,7 +40,7 @@ class DefiLlamaBaseTool(IntentKitSkill):
         return "defillama"
 
     async def check_rate_limit(
-        self, context: SkillContext, max_requests: int = 30, interval: int = 5
+        self, context: AgentContext, max_requests: int = 30, interval: int = 5
     ) -> tuple[bool, str | None]:
         """Check if the rate limit has been exceeded.
 

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/supabase/base.py

@@ -3,8 +3,9 @@ from typing import Type
 from langchain_core.tools import ToolException
 from pydantic import BaseModel, Field
 
+from intentkit.abstracts.graph import AgentContext
 from intentkit.abstracts.skill import SkillStoreABC
-from intentkit.skills.base import IntentKitSkill, SkillContext
+from intentkit.skills.base import IntentKitSkill
 
 
 class SupabaseBaseTool(IntentKitSkill):
@@ -21,9 +22,7 @@ class SupabaseBaseTool(IntentKitSkill):
     def category(self) -> str:
         return "supabase"
 
-    def get_supabase_config(
-        self, config: dict, context: SkillContext
-    ) -> tuple[str, str]:
+    def get_supabase_config(self, context: AgentContext) -> tuple[str, str]:
         """Get Supabase URL and key from config.
 
         Args:
@@ -36,6 +35,7 @@ class SupabaseBaseTool(IntentKitSkill):
         Raises:
             ValueError: If required config is missing
         """
+        config = context.agent.skill_config(self.category)
         supabase_url = config.get("supabase_url")
 
         # Use public_key for public operations if available, otherwise fall back to supabase_key
@@ -52,7 +52,7 @@ class SupabaseBaseTool(IntentKitSkill):
 
         return supabase_url, supabase_key
 
-    def validate_table_access(self, table: str, context: SkillContext) -> None:
+    def validate_table_access(self, table: str, context: AgentContext) -> None:
         """Validate if the table can be accessed for write operations in public mode.
 
         Args:
@@ -66,8 +66,10 @@ class SupabaseBaseTool(IntentKitSkill):
         if context.is_private:
             return
 
+        config = context.agent.skill_config(self.category)
+
         # In public mode, check if table is in allowed list
-        public_write_tables = context.config.get("public_write_tables", "")
+        public_write_tables = config.get("public_write_tables", "")
         if not public_write_tables:
             return
 

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/supabase/delete_data.py

@@ -45,12 +45,11 @@ class SupabaseDeleteData(SupabaseBaseTool):
     ):
         try:
             context = self.get_context()
-            skill_config = context.agent.skill_config(self.category)
 
             # Validate table access for public mode
             self.validate_table_access(table, context)
 
-            supabase_url, supabase_key = self.get_supabase_config(skill_config, context)
+            supabase_url, supabase_key = self.get_supabase_config(context)
 
             # Create Supabase client
             supabase: Client = create_client(supabase_url, supabase_key)

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/supabase/fetch_data.py

@@ -60,8 +60,7 @@ class SupabaseFetchData(SupabaseBaseTool):
     ):
         try:
             context = self.get_context()
-            skill_config = context.agent.skill_config(self.category)
-            supabase_url, supabase_key = self.get_supabase_config(skill_config, context)
+            supabase_url, supabase_key = self.get_supabase_config(context)
 
             # Create Supabase client
             supabase: Client = create_client(supabase_url, supabase_key)

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/supabase/insert_data.py

@@ -45,12 +45,11 @@ class SupabaseInsertData(SupabaseBaseTool):
     ):
         try:
             context = self.get_context()
-            skill_config = context.agent.skill_config(self.category)
 
             # Validate table access for public mode
             self.validate_table_access(table, context)
 
-            supabase_url, supabase_key = self.get_supabase_config(skill_config, context)
+            supabase_url, supabase_key = self.get_supabase_config(context)
 
             # Create Supabase client
             supabase: Client = create_client(supabase_url, supabase_key)

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/supabase/invoke_function.py

@@ -44,8 +44,7 @@ class SupabaseInvokeFunction(SupabaseBaseTool):
     ):
         try:
             context = self.get_context()
-            skill_config = context.agent.skill_config(self.category)
-            supabase_url, supabase_key = self.get_supabase_config(skill_config, context)
+            supabase_url, supabase_key = self.get_supabase_config(context)
 
             # Create Supabase client
             supabase: Client = create_client(supabase_url, supabase_key)

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/supabase/update_data.py

@@ -48,12 +48,11 @@ class SupabaseUpdateData(SupabaseBaseTool):
     ):
         try:
             context = self.get_context()
-            skill_config = context.agent.skill_config(self.category)
 
             # Validate table access for public mode
             self.validate_table_access(table, context)
 
-            supabase_url, supabase_key = self.get_supabase_config(skill_config, context)
+            supabase_url, supabase_key = self.get_supabase_config(context)
 
             # Create Supabase client
             supabase: Client = create_client(supabase_url, supabase_key)

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/supabase/upsert_data.py

@@ -50,12 +50,11 @@ class SupabaseUpsertData(SupabaseBaseTool):
     ):
         try:
             context = self.get_context()
-            skill_config = context.agent.skill_config(self.category)
 
             # Validate table access for public mode
             self.validate_table_access(table, context)
 
-            supabase_url, supabase_key = self.get_supabase_config(skill_config, context)
+            supabase_url, supabase_key = self.get_supabase_config(context)
 
             # Create Supabase client
             supabase: Client = create_client(supabase_url, supabase_key)

{intentkit-0.6.20.dev1 → intentkit-0.6.21}/skills/xmtp/transfer.py

@@ -1,6 +1,7 @@
 from typing import List, Optional, Tuple, Type
 
 from pydantic import BaseModel, Field
+from web3.exceptions import ContractLogicError
 
 from intentkit.models.chat import ChatMessageAttachment, ChatMessageAttachmentType
 from intentkit.skills.xmtp.base import XmtpBaseTool
@@ -14,9 +15,6 @@ class TransferInput(BaseModel):
     amount: str = Field(
         description="The amount to transfer (as string to handle large numbers)"
     )
-    decimals: int = Field(
-        description="Number of decimal places for the token (18 for ETH, varies for ERC20 tokens)"
-    )
     currency: str = Field(description="Currency symbol (e.g., 'ETH', 'USDC', 'DAI')")
     token_contract_address: Optional[str] = Field(
         default=None,
@@ -44,7 +42,6 @@ class XmtpTransfer(XmtpBaseTool):
         from_address: str,
         to_address: str,
         amount: str,
-        decimals: int,
         currency: str,
         token_contract_address: Optional[str],
     ) -> Tuple[str, List[ChatMessageAttachment]]:
@@ -54,10 +51,8 @@ class XmtpTransfer(XmtpBaseTool):
             from_address: The sender address
             to_address: The recipient address
             amount: Amount to transfer
-            decimals: Token decimals
             currency: Currency symbol
             token_contract_address: Token contract address (None for ETH)
-            config: LangChain runnable config
 
         Returns:
             Tuple of (content_message, list_of_attachments)
@@ -80,6 +75,65 @@ class XmtpTransfer(XmtpBaseTool):
 
         chain_id_hex = chain_id_hex_by_network[agent.network_id]
 
+        # Validate token contract and get decimals
+        if token_contract_address:
+            # Validate ERC20 contract and get token info
+            web3 = self.web3_client()
+
+            # ERC20 ABI for symbol() and decimals() functions
+            erc20_abi = [
+                {
+                    "constant": True,
+                    "inputs": [],
+                    "name": "symbol",
+                    "outputs": [{"name": "", "type": "string"}],
+                    "type": "function",
+                },
+                {
+                    "constant": True,
+                    "inputs": [],
+                    "name": "decimals",
+                    "outputs": [{"name": "", "type": "uint8"}],
+                    "type": "function",
+                },
+            ]
+
+            try:
+                # Create contract instance
+                contract = web3.eth.contract(
+                    address=web3.to_checksum_address(token_contract_address),
+                    abi=erc20_abi,
+                )
+
+                # Get token symbol and decimals
+                token_symbol = contract.functions.symbol().call()
+                decimals = contract.functions.decimals().call()
+
+                # Validate symbol matches currency (case insensitive)
+                if token_symbol.upper() != currency.upper():
+                    raise ValueError(
+                        f"Token symbol mismatch: contract symbol is '{token_symbol}', "
+                        f"but currency parameter is '{currency}'"
+                    )
+
+            except ContractLogicError:
+                raise ValueError(
+                    f"Invalid ERC20 contract address: {token_contract_address}. "
+                    "The address does not point to a valid ERC20 token contract."
+                )
+            except Exception as e:
+                raise ValueError(
+                    f"Failed to validate ERC20 contract {token_contract_address}: {str(e)}"
+                )
+        else:
+            # For ETH transfers, use 18 decimals
+            decimals = 18
+            # Validate currency is ETH for native transfers
+            if currency.upper() != "ETH":
+                raise ValueError(
+                    f"For native transfers, currency must be 'ETH', got '{currency}'"
+                )
+
         # Calculate amount in smallest unit (wei for ETH, token units for ERC20)
         amount_int = int(float(amount) * (10**decimals))