intentkit 0.6.9__tar.gz → 0.8.22__tar.gz

{intentkit-0.6.9 → intentkit-0.8.22}/.gitignore

@@ -168,9 +168,7 @@ cython_debug/
 # IDE
 .idea
 .vscode
-.trae
 .cursor
-.windsurfrules
 
 # web3
 wallet_data.txt
@@ -178,4 +176,3 @@ wallet_data.txt
 # export/import data
 *.response
 scripts/*.yaml
-skills.csv

intentkit-0.8.22/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Crestal Network
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{intentkit-0.6.9 → intentkit-0.8.22}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.6.9
+Version: 0.8.22
 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
-Author-email: hyacinthus <hyacinthus@gmail.com>
+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: Ruihua <ruihua@crestal.network>
 License: MIT License
         
         Copyright (c) 2024 Crestal Network
@@ -34,20 +34,18 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.12
+Requires-Python: ==3.13.*
 Requires-Dist: aiohttp>=3.11.16
 Requires-Dist: aiosqlite>=0.21.0
 Requires-Dist: asyncpg>=0.30.0
 Requires-Dist: aws-secretsmanager-caching>=1.1.3
-Requires-Dist: bip32>=2.0.0
 Requires-Dist: boto3<2.0.0,>=1.37.23
 Requires-Dist: botocore>=1.35.97
-Requires-Dist: cdp-sdk>=1.22.0
-Requires-Dist: coinbase-agentkit-langchain>=0.5.0
-Requires-Dist: coinbase-agentkit<0.7.0,>=0.6.0
+Requires-Dist: cdp-sdk>=1.31.1
+Requires-Dist: coinbase-agentkit>=0.7.2
 Requires-Dist: cron-validator<2.0.0,>=1.0.8
 Requires-Dist: epyxid>=0.3.3
 Requires-Dist: eth-keys>=0.4.0
@@ -55,28 +53,30 @@ Requires-Dist: eth-utils>=2.1.0
 Requires-Dist: fastapi>=0.115.8
 Requires-Dist: filetype<2.0.0,>=1.2.0
 Requires-Dist: httpx>=0.28.1
+Requires-Dist: jsonref>=1.1.0
 Requires-Dist: langchain-community>=0.3.19
 Requires-Dist: langchain-core>=0.3.43
+Requires-Dist: langchain-deepseek>=0.1.4
 Requires-Dist: langchain-mcp-adapters>=0.0.11
 Requires-Dist: langchain-openai>=0.3.8
 Requires-Dist: langchain-text-splitters>=0.3.8
 Requires-Dist: langchain-xai>=0.2.1
-Requires-Dist: langchain<0.4.0,>=0.3.25
-Requires-Dist: langgraph-checkpoint-postgres<2.0.23,>=2.0.16
+Requires-Dist: langchain>=0.3.25
+Requires-Dist: langgraph-checkpoint-postgres>=2.0.16
 Requires-Dist: langgraph-checkpoint>=2.0.18
-Requires-Dist: langgraph-prebuilt<0.6.0,>=0.5.1
-Requires-Dist: langgraph<0.6.0,>=0.5.1
+Requires-Dist: langgraph-prebuilt>=0.6.1
+Requires-Dist: langgraph>=0.6.1
 Requires-Dist: langmem>=0.0.27
 Requires-Dist: mypy-boto3-s3<2.0.0,>=1.37.24
 Requires-Dist: openai>=1.59.6
-Requires-Dist: pillow<12.0.0,>=11.1.0
+Requires-Dist: pillow<13.0.0,>=11.1.0
 Requires-Dist: psycopg-pool>=3.2.4
 Requires-Dist: psycopg>=3.2.9
-Requires-Dist: pydantic<2.11.0,>=2.10.6
+Requires-Dist: pydantic>=2.10.6
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: pytz>=2025.1
 Requires-Dist: pyyaml>=6.0.2
-Requires-Dist: redis<7.0.0,>=5.2.1
+Requires-Dist: redis<8.0.0,>=5.2.1
 Requires-Dist: requests-oauthlib>=2.0.0
 Requires-Dist: requests>=2.32.3
 Requires-Dist: slack-sdk>=3.34.0

{intentkit-0.6.9 → intentkit-0.8.22/intentkit}/MANIFEST.in

@@ -1,6 +1,5 @@
 include README.md
 include LICENSE
-include pyproject.toml
 recursive-include abstracts *.py
 recursive-include clients *.py
 recursive-include config *.py
@@ -12,4 +11,4 @@ recursive-exclude * __pycache__
 recursive-exclude * *.pyc
 recursive-exclude * *.pyo
 recursive-exclude * .DS_Store
-recursive-exclude * .ruff_cache
+recursive-exclude * .ruff_cache

{intentkit-0.6.9 → intentkit-0.8.22/intentkit}/__init__.py

@@ -3,15 +3,17 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.6.9"
-__author__ = "hyacinthus"
-__email__ = "hyacinthus@gmail.com"
+__version__ = "0.8.22"
+__author__ = "Ruihua"
+__email__ = "ruihua@crestal.network"
 
 # Core components
 # Abstract base classes
-from .core.engine import create_agent, stream_agent
+from .core.engine import build_agent, create_agent, stream_agent, stream_agent_raw
 
 __all__ = [
     "create_agent",
     "stream_agent",
+    "build_agent",
+    "stream_agent_raw",
 ]

{intentkit-0.6.9 → intentkit-0.8.22/intentkit}/abstracts/agent.py

@@ -1,5 +1,4 @@
 from abc import ABC, abstractmethod
-from typing import Dict, Optional
 
 from intentkit.models.agent import Agent
 from intentkit.models.agent_data import AgentData, AgentQuota
@@ -24,7 +23,7 @@ class AgentStoreABC(ABC):
         self.agent_id = agent_id
 
     @abstractmethod
-    async def get_config(self) -> Optional[Agent]:
+    async def get_config(self) -> Agent | None:
         """Get agent configuration.
 
         Returns:
@@ -33,7 +32,7 @@ class AgentStoreABC(ABC):
         pass
 
     @abstractmethod
-    async def get_data(self) -> Optional[AgentData]:
+    async def get_data(self) -> AgentData | None:
         """Get additional agent data.
 
         Returns:
@@ -42,7 +41,7 @@ class AgentStoreABC(ABC):
         pass
 
     @abstractmethod
-    async def set_data(self, data: Dict) -> None:
+    async def set_data(self, data: dict) -> None:
         """Update agent data.
 
         Args:
@@ -51,7 +50,7 @@ class AgentStoreABC(ABC):
         pass
 
     @abstractmethod
-    async def get_quota(self) -> Optional[AgentQuota]:
+    async def get_quota(self) -> AgentQuota | None:
         """Get agent quota information.
 
         Returns:

{intentkit-0.6.9 → intentkit-0.8.22/intentkit}/abstracts/engine.py

@@ -1,4 +1,4 @@
-from typing import Callable, List
+from collections.abc import Callable
 
 from pydantic import BaseModel
 
@@ -12,19 +12,19 @@ class AgentMessageInput(BaseModel):
 
     Attributes:
         text (str): The main text content of the message or query
-        images (List[str]): List of image references/URLs to be processed by the agent.
+        images (list[str]): List of image references/URLs to be processed by the agent.
                            Empty list if no images are provided.
     """
 
     text: str  # required
     """The main text content or query to be processed by the agent"""
 
-    images: List[str] = []  # optional, defaults to empty list
+    images: list[str] = []  # optional, defaults to empty list
     """List of image references or URLs for multimodal processing"""
 
 
 # Define a type hint for the callback that takes three strings and returns a list of strings
-AgentExecutionCallback = Callable[[str, AgentMessageInput, str], List[str]]
+AgentExecutionCallback = Callable[[str, AgentMessageInput, str], list[str]]
 """Callback function type for agent execution.
 
 Args:
@@ -33,6 +33,6 @@ Args:
     thread_id (str): The thread ID for tracking the conversation context
 
 Returns:
-    List[str]: A list of formatted response lines from the agent execution. Each line
+    list[str]: A list of formatted response lines from the agent execution. Each line
         typically contains input/output markers, agent responses, and timing information.
 """

intentkit-0.8.22/intentkit/abstracts/graph.py

@@ -0,0 +1,48 @@
+from collections.abc import Callable
+from enum import Enum
+from typing import Any, NotRequired
+
+from langgraph.prebuilt.chat_agent_executor import AgentState as BaseAgentState
+from pydantic import BaseModel
+
+from intentkit.models.agent import Agent
+from intentkit.models.chat import AuthorType
+
+
+class AgentError(str, Enum):
+    """The error types that can be raised by the agent."""
+
+    INSUFFICIENT_CREDITS = "insufficient_credits"
+
+
+# We create the AgentState that we will pass around
+# This simply involves a list of messages
+# We want steps to return messages to append to the list
+# So we annotate the messages attribute with operator.add
+class AgentState(BaseAgentState):
+    """The state of the agent."""
+
+    context: dict[str, Any]
+    error: NotRequired[AgentError]
+    __extra__: NotRequired[dict[str, Any]]
+
+
+class AgentContext(BaseModel):
+    agent_id: str
+    get_agent: Callable[[], Agent]
+    chat_id: str
+    user_id: str | None = None
+    app_id: str | None = None
+    entrypoint: AuthorType
+    is_private: bool
+    search: bool = False
+    thinking: bool = False
+    payer: str | None = None
+
+    @property
+    def agent(self) -> Agent:
+        return self.get_agent()
+
+    @property
+    def thread_id(self) -> str:
+        return f"{self.agent_id}-{self.chat_id}"

intentkit-0.8.22/intentkit/abstracts/skill.py

@@ -0,0 +1,60 @@
+from abc import ABC, abstractmethod
+from typing import Any
+
+from intentkit.models.agent import Agent
+from intentkit.models.agent_data import AgentData, AgentQuota
+
+
+class SkillStoreABC(ABC):
+    """Abstract base class for skill data storage operations.
+
+    This class defines the interface for interacting with skill-related data
+    for both agents and threads.
+    """
+
+    @staticmethod
+    @abstractmethod
+    def get_system_config(key: str) -> Any:
+        """Get system configuration value by key."""
+        pass
+
+    @staticmethod
+    @abstractmethod
+    async def get_agent_config(agent_id: str) -> Agent | None:
+        """Get agent configuration.
+
+        Returns:
+            Agent configuration if found, None otherwise
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    async def get_agent_data(agent_id: str) -> AgentData | None:
+        """Get additional agent data.
+
+        Returns:
+            Agent data if found, None otherwise
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    async def set_agent_data(agent_id: str, data: dict) -> None:
+        """Update agent data.
+
+        Args:
+            agent_id: ID of the agent
+            data: Dictionary containing fields to update
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    async def get_agent_quota(agent_id: str) -> AgentQuota | None:
+        """Get agent quota information.
+
+        Returns:
+            Agent quota if found, None otherwise
+        """
+        pass

{intentkit-0.6.9 → intentkit-0.8.22/intentkit}/abstracts/twitter.py

@@ -1,5 +1,4 @@
 from abc import ABC, abstractmethod
-from typing import Optional
 
 from tweepy.asynchronous import AsyncClient
 
@@ -15,7 +14,7 @@ class TwitterABC(ABC):
     use_key = False
 
     @abstractmethod
-    async def get_client(self) -> Optional[AsyncClient]:
+    async def get_client(self) -> AsyncClient | None:
         """Get a configured Tweepy client.
 
         Returns:
@@ -25,7 +24,7 @@ class TwitterABC(ABC):
 
     @property
     @abstractmethod
-    def self_id(self) -> Optional[str]:
+    def self_id(self) -> str | None:
         """Get the Twitter user ID.
 
         Returns:
@@ -35,7 +34,7 @@ class TwitterABC(ABC):
 
     @property
     @abstractmethod
-    def self_username(self) -> Optional[str]:
+    def self_username(self) -> str | None:
         """Get the Twitter username.
 
         Returns:
@@ -45,7 +44,7 @@ class TwitterABC(ABC):
 
     @property
     @abstractmethod
-    def self_name(self) -> Optional[str]:
+    def self_name(self) -> str | None:
         """Get the Twitter display name.
 
         Returns:

{intentkit-0.6.9 → intentkit-0.8.22/intentkit}/clients/__init__.py

@@ -1,14 +1,17 @@
-from intentkit.clients.cdp import CdpClient, get_cdp_client
+from intentkit.clients.cdp import get_cdp_client, get_evm_account, get_wallet_provider
 from intentkit.clients.twitter import (
     TwitterClient,
     TwitterClientConfig,
     get_twitter_client,
 )
+from intentkit.clients.web3 import get_web3_client
 
 __all__ = [
     "TwitterClient",
     "TwitterClientConfig",
     "get_twitter_client",
-    "CdpClient",
+    "get_evm_account",
     "get_cdp_client",
+    "get_wallet_provider",
+    "get_web3_client",
 ]

intentkit-0.8.22/intentkit/clients/cdp.py

@@ -0,0 +1,128 @@
+import asyncio
+import logging
+
+from cdp import CdpClient, EvmServerAccount  # noqa: E402
+from coinbase_agentkit import (  # noqa: E402
+    CdpEvmWalletProvider,
+    CdpEvmWalletProviderConfig,
+)
+
+from intentkit.config.config import config
+from intentkit.models.agent import Agent, AgentTable  # noqa: E402
+from intentkit.models.agent_data import AgentData
+from intentkit.models.db import get_session
+from intentkit.utils.error import IntentKitAPIError  # noqa: E402
+
+_wallet_providers: dict[str, tuple[str, str, CdpEvmWalletProvider]] = {}
+_cdp_client: CdpClient | None = None
+
+logger = logging.getLogger(__name__)
+
+
+def get_cdp_client() -> CdpClient:
+    global _cdp_client
+    if _cdp_client:
+        return _cdp_client
+
+    # Get credentials from global configuration
+    api_key_id = config.cdp_api_key_id
+    api_key_secret = config.cdp_api_key_secret
+    wallet_secret = config.cdp_wallet_secret
+
+    _cdp_client = CdpClient(
+        api_key_id=api_key_id,
+        api_key_secret=api_key_secret,
+        wallet_secret=wallet_secret,
+    )
+    return _cdp_client
+
+
+def _assert_cdp_wallet_provider(agent: Agent) -> None:
+    if agent.wallet_provider != "cdp":
+        raise IntentKitAPIError(
+            400,
+            "BadWalletProvider",
+            "Your agent wallet provider is not cdp but you selected a skill that requires a cdp wallet.",
+        )
+
+
+async def _ensure_evm_account(
+    agent: Agent, agent_data: AgentData | None = None
+) -> tuple[EvmServerAccount, AgentData]:
+    cdp_client = get_cdp_client()
+    agent_data = agent_data or await AgentData.get(agent.id)
+    address = agent_data.evm_wallet_address
+    account: EvmServerAccount | None = None
+
+    if not address:
+        logger.info("Creating new wallet...")
+        account = await cdp_client.evm.create_account(
+            name=agent.id,
+        )
+        address = account.address
+        logger.info("Created new wallet: %s", address)
+
+    agent_data.evm_wallet_address = address
+    await agent_data.save()
+    if not agent.slug:
+        async with get_session() as db:
+            db_agent = await db.get(AgentTable, agent.id)
+            if db_agent and not db_agent.slug:
+                db_agent.slug = agent_data.evm_wallet_address
+                await db.commit()
+
+    if account is None:
+        account = await cdp_client.evm.get_account(address=address)
+
+    return account, agent_data
+
+
+async def get_evm_account(agent: Agent) -> EvmServerAccount:
+    _assert_cdp_wallet_provider(agent)
+    account, _ = await _ensure_evm_account(agent)
+    return account
+
+
+async def get_wallet_provider(agent: Agent) -> CdpEvmWalletProvider:
+    _assert_cdp_wallet_provider(agent)
+    if not agent.network_id:
+        raise IntentKitAPIError(
+            400,
+            "BadNetworkID",
+            "Your agent network ID is not set. Please set it in the agent config.",
+        )
+
+    agent_data = await AgentData.get(agent.id)
+    address = agent_data.evm_wallet_address
+
+    cache_entry = _wallet_providers.get(agent.id)
+    if cache_entry:
+        cached_network_id, cached_address, provider = cache_entry
+        if cached_network_id == agent.network_id:
+            if not address:
+                address = cached_address or provider.get_address()
+            if cached_address == address:
+                return provider
+
+    account, agent_data = await _ensure_evm_account(agent, agent_data)
+    address = account.address
+
+    # Get credentials from global config
+    api_key_id = config.cdp_api_key_id
+    api_key_secret = config.cdp_api_key_secret
+    wallet_secret = config.cdp_wallet_secret
+
+    network_id = agent.network_id
+
+    wallet_provider_config = CdpEvmWalletProviderConfig(
+        api_key_id=api_key_id,
+        api_key_secret=api_key_secret,
+        network_id=network_id,
+        address=address,
+        wallet_secret=wallet_secret,
+    )
+    wallet_provider = await asyncio.to_thread(
+        CdpEvmWalletProvider, wallet_provider_config
+    )
+    _wallet_providers[agent.id] = (network_id, address, wallet_provider)
+    return wallet_provider