intentkit 0.8.17.dev2__tar.gz → 0.8.49__tar.gz

{intentkit-0.8.17.dev2 → intentkit-0.8.49}/.gitignore

@@ -17,7 +17,7 @@ dist/
 downloads/
 eggs/
 .eggs/
-lib/
+/lib/
 lib64/
 parts/
 sdist/
@@ -169,6 +169,7 @@ cython_debug/
 .idea
 .vscode
 .cursor
+.zed
 
 # web3
 wallet_data.txt

intentkit-0.8.49/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.8.17.dev2 → intentkit-0.8.49}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.8.17.dev2
+Version: 0.8.49
 Summary: Intent-based AI Agent Platform - Core Package
 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>
+Author-email: Ruihua <ruihua@crestal.network>
 License: MIT License
         
         Copyright (c) 2024 Crestal Network
@@ -48,6 +48,7 @@ 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-abi>=5.0.0
 Requires-Dist: eth-keys>=0.4.0
 Requires-Dist: eth-utils>=2.1.0
 Requires-Dist: fastapi>=0.115.8
@@ -57,6 +58,7 @@ 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-google-genai>=3.2.0
 Requires-Dist: langchain-mcp-adapters>=0.0.11
 Requires-Dist: langchain-openai>=0.3.8
 Requires-Dist: langchain-text-splitters>=0.3.8
@@ -66,17 +68,16 @@ Requires-Dist: langgraph-checkpoint-postgres>=2.0.16
 Requires-Dist: langgraph-checkpoint>=2.0.18
 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.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.8.17.dev2 → intentkit-0.8.49/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.8.17.dev2 → intentkit-0.8.49/intentkit}/__init__.py

@@ -3,15 +3,17 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.8.17-dev2"
-__author__ = "hyacinthus"
-__email__ = "hyacinthus@gmail.com"
+__version__ = "0.8.49"
+__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.8.17.dev2 → intentkit-0.8.49/intentkit}/abstracts/agent.py

@@ -1,4 +1,5 @@
 from abc import ABC, abstractmethod
+from typing import Any
 
 from intentkit.models.agent import Agent
 from intentkit.models.agent_data import AgentData, AgentQuota
@@ -41,7 +42,7 @@ class AgentStoreABC(ABC):
         pass
 
     @abstractmethod
-    async def set_data(self, data: dict) -> None:
+    async def set_data(self, data: dict[str, Any]) -> None:
         """Update agent data.
 
         Args:

{intentkit-0.8.17.dev2 → intentkit-0.8.49/intentkit}/abstracts/graph.py

@@ -2,7 +2,7 @@ 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 langchain.agents import AgentState as BaseAgentState
 from pydantic import BaseModel
 
 from intentkit.models.agent import Agent
@@ -19,7 +19,7 @@ class AgentError(str, Enum):
 # 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):
+class AgentState(BaseAgentState[Any]):
     """The state of the agent."""
 
     context: dict[str, Any]

{intentkit-0.8.17.dev2 → intentkit-0.8.49/intentkit}/abstracts/skill.py

@@ -40,7 +40,7 @@ class SkillStoreABC(ABC):
 
     @staticmethod
     @abstractmethod
-    async def set_agent_data(agent_id: str, data: dict) -> None:
+    async def set_agent_data(agent_id: str, data: dict[str, Any]) -> None:
         """Update agent data.
 
         Args:

intentkit-0.8.49/intentkit/abstracts/wallet.py

@@ -0,0 +1,161 @@
+"""
+Unified wallet abstractions for on-chain skills.
+
+This module defines abstract interfaces for wallet providers and signers,
+allowing skills to work with different wallet implementations (CDP, Privy, etc.)
+without knowing the specific implementation details.
+"""
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class UnifiedWalletProvider(ABC):
+    """
+    Abstract interface for wallet providers.
+
+    This interface defines the common operations that any wallet provider
+    (CDP, Privy/Safe, etc.) must implement to be used by on-chain skills.
+    """
+
+    @abstractmethod
+    def get_address(self) -> str:
+        """
+        Get the wallet's public address (synchronous).
+
+        Returns:
+            The wallet address as a checksummed hex string.
+        """
+        pass
+
+    @abstractmethod
+    async def get_address_async(self) -> str:
+        """
+        Get the wallet's public address (asynchronous).
+
+        Returns:
+            The wallet address as a checksummed hex string.
+        """
+        pass
+
+    @abstractmethod
+    async def get_balance(self, chain_id: int | None = None) -> int:
+        """
+        Get native token balance in wei.
+
+        Args:
+            chain_id: Optional chain ID, uses default if not specified.
+
+        Returns:
+            Balance in wei as an integer.
+        """
+        pass
+
+    @abstractmethod
+    async def execute_transaction(
+        self,
+        to: str,
+        value: int = 0,
+        data: bytes = b"",
+        chain_id: int | None = None,
+    ) -> dict[str, Any]:
+        """
+        Execute a transaction.
+
+        Args:
+            to: Destination address.
+            value: Amount of native token to send (in wei).
+            data: Transaction calldata.
+            chain_id: Optional chain ID (uses default if not specified).
+
+        Returns:
+            Dict with 'success' (bool), 'tx_hash' (str), and optional 'error' (str).
+        """
+        pass
+
+
+class UnifiedWalletSigner(ABC):
+    """
+    Abstract interface for EVM signers.
+
+    This interface is compatible with eth_account's signing interfaces,
+    allowing it to be used with libraries like x402 that expect standard
+    EVM signers.
+    """
+
+    @property
+    @abstractmethod
+    def address(self) -> str:
+        """
+        The wallet address used for signing.
+
+        Note: For Privy, this is the EOA address (not the Safe address),
+        as signatures must come from the actual signer.
+        """
+        pass
+
+    @abstractmethod
+    def sign_message(self, signable_message: Any) -> Any:
+        """
+        Sign a message (EIP-191 personal_sign).
+
+        Args:
+            signable_message: The message to sign, typically an
+                eth_account.messages.SignableMessage.
+
+        Returns:
+            The signature, typically as an eth_account SignedMessage or
+            compatible object.
+        """
+        pass
+
+    @abstractmethod
+    def sign_transaction(self, transaction_dict: dict[str, Any]) -> Any:
+        """
+        Sign a transaction.
+
+        Args:
+            transaction_dict: The transaction dictionary to sign.
+
+        Returns:
+            The signed transaction.
+        """
+        pass
+
+    @abstractmethod
+    def sign_typed_data(
+        self,
+        domain_data: dict[str, Any] | None = None,
+        message_types: dict[str, Any] | None = None,
+        message_data: dict[str, Any] | None = None,
+        full_message: dict[str, Any] | None = None,
+    ) -> Any:
+        """
+        Sign typed data (EIP-712).
+
+        Args:
+            domain_data: The EIP-712 domain data.
+            message_types: The type definitions.
+            message_data: The message data to sign.
+            full_message: Alternative: the complete typed data structure.
+
+        Returns:
+            The signature.
+        """
+        pass
+
+    @abstractmethod
+    def unsafe_sign_hash(self, message_hash: Any) -> Any:
+        """
+        Sign a raw hash directly (unsafe, use with caution).
+
+        This method signs a hash without any prefix or encoding.
+        It should only be used when you know exactly what you're signing.
+
+        Args:
+            message_hash: The 32-byte hash to sign.
+
+        Returns:
+            The signature.
+        """
+        pass

intentkit-0.8.49/intentkit/clients/__init__.py

@@ -0,0 +1,204 @@
+"""
+IntentKit clients module.
+
+This module provides unified access to various client implementations,
+including wallet providers that support both CDP and Privy backends.
+"""
+
+import json
+import logging
+from typing import TYPE_CHECKING, Any, Union
+
+from intentkit.clients.cdp import (
+    get_cdp_client,
+    get_cdp_network,
+    get_evm_account,
+)
+from intentkit.clients.cdp import (
+    get_wallet_provider as get_cdp_wallet_provider,
+)
+from intentkit.clients.twitter import (
+    TwitterClient,
+    TwitterClientConfig,
+    get_twitter_client,
+)
+from intentkit.clients.web3 import get_web3_client
+from intentkit.utils.error import IntentKitAPIError
+
+if TYPE_CHECKING:
+    from coinbase_agentkit import CdpEvmWalletProvider
+
+    from intentkit.clients.privy import SafeWalletProvider
+    from intentkit.models.agent import Agent
+
+logger = logging.getLogger(__name__)
+
+# Type alias for unified wallet provider
+WalletProviderType = Union["CdpEvmWalletProvider", "SafeWalletProvider"]
+WalletSignerType = Any  # Can be ThreadSafeEvmWalletSigner or PrivyWalletSigner
+
+
+async def get_wallet_provider(agent: "Agent") -> WalletProviderType:
+    """
+    Get wallet provider based on agent's wallet_provider setting.
+
+    This function automatically selects the appropriate wallet provider
+    implementation based on the agent's configuration.
+
+    Args:
+        agent: The agent to get the wallet provider for.
+
+    Returns:
+        CdpEvmWalletProvider for CDP agents.
+        SafeWalletProvider for Privy agents.
+
+    Raises:
+        IntentKitAPIError: If the wallet provider is not supported or not configured.
+    """
+    if agent.wallet_provider == "cdp":
+        return await get_cdp_wallet_provider(agent)
+
+    elif agent.wallet_provider == "privy":
+        from intentkit.clients.privy import get_wallet_provider as get_privy_provider
+        from intentkit.models.agent_data import AgentData
+
+        agent_data = await AgentData.get(agent.id)
+        if not agent_data.privy_wallet_data:
+            raise IntentKitAPIError(
+                400,
+                "PrivyWalletNotInitialized",
+                "Privy wallet has not been initialized for this agent. "
+                "Please ensure the agent was created with wallet_provider='privy'.",
+            )
+
+        try:
+            privy_data = json.loads(agent_data.privy_wallet_data)
+        except json.JSONDecodeError as e:
+            raise IntentKitAPIError(
+                500,
+                "PrivyWalletDataCorrupted",
+                f"Failed to parse Privy wallet data: {e}",
+            ) from e
+
+        return get_privy_provider(privy_data)
+
+    elif agent.wallet_provider == "readonly":
+        raise IntentKitAPIError(
+            400,
+            "ReadonlyWalletNotSupported",
+            "Readonly wallets cannot perform on-chain operations that require signing.",
+        )
+
+    elif agent.wallet_provider == "none" or agent.wallet_provider is None:
+        raise IntentKitAPIError(
+            400,
+            "NoWalletConfigured",
+            "This agent does not have a wallet configured. "
+            "Please set wallet_provider to 'cdp' or 'privy' in the agent configuration.",
+        )
+
+    else:
+        raise IntentKitAPIError(
+            400,
+            "UnsupportedWalletProvider",
+            f"Wallet provider '{agent.wallet_provider}' is not supported for on-chain operations. "
+            "Supported providers are: 'cdp', 'privy'.",
+        )
+
+
+async def get_wallet_signer(agent: "Agent") -> WalletSignerType:
+    """
+    Get EVM signer based on agent's wallet_provider setting.
+
+    This function returns a signer compatible with eth_account interfaces,
+    suitable for use with libraries like x402 that require signing capabilities.
+
+    Args:
+        agent: The agent to get the wallet signer for.
+
+    Returns:
+        A signer object with sign_message, sign_typed_data, and unsafe_sign_hash methods.
+        - For CDP: ThreadSafeEvmWalletSigner wrapping CdpEvmWalletProvider
+        - For Privy: PrivyWalletSigner
+
+    Raises:
+        IntentKitAPIError: If the wallet provider is not supported or not configured.
+    """
+    if agent.wallet_provider == "cdp":
+        # Import here to avoid circular imports
+        from intentkit.clients.cdp import get_wallet_provider as get_cdp_provider
+
+        provider = await get_cdp_provider(agent)
+
+        # Create thread-safe signer wrapper
+        from intentkit.clients.signer import ThreadSafeEvmWalletSigner
+
+        return ThreadSafeEvmWalletSigner(provider)
+
+    elif agent.wallet_provider == "privy":
+        from intentkit.clients.privy import get_wallet_signer as get_privy_signer
+        from intentkit.models.agent_data import AgentData
+
+        agent_data = await AgentData.get(agent.id)
+        if not agent_data.privy_wallet_data:
+            raise IntentKitAPIError(
+                400,
+                "PrivyWalletNotInitialized",
+                "Privy wallet has not been initialized for this agent. "
+                "Please ensure the agent was created with wallet_provider='privy'.",
+            )
+
+        try:
+            privy_data = json.loads(agent_data.privy_wallet_data)
+        except json.JSONDecodeError as e:
+            raise IntentKitAPIError(
+                500,
+                "PrivyWalletDataCorrupted",
+                f"Failed to parse Privy wallet data: {e}",
+            ) from e
+
+        return get_privy_signer(privy_data)
+
+    elif agent.wallet_provider == "readonly":
+        raise IntentKitAPIError(
+            400,
+            "ReadonlyWalletNotSupported",
+            "Readonly wallets cannot perform signing operations.",
+        )
+
+    elif agent.wallet_provider == "none" or agent.wallet_provider is None:
+        raise IntentKitAPIError(
+            400,
+            "NoWalletConfigured",
+            "This agent does not have a wallet configured. "
+            "Please set wallet_provider to 'cdp' or 'privy' in the agent configuration.",
+        )
+
+    else:
+        raise IntentKitAPIError(
+            400,
+            "UnsupportedWalletProvider",
+            f"Wallet provider '{agent.wallet_provider}' is not supported for signing. "
+            "Supported providers are: 'cdp', 'privy'.",
+        )
+
+
+# Legacy alias for backwards compatibility
+# This now routes to the unified function
+get_cdp_wallet_provider_legacy = get_cdp_wallet_provider
+
+__all__ = [
+    # Twitter client
+    "TwitterClient",
+    "TwitterClientConfig",
+    "get_twitter_client",
+    # CDP specific (for backwards compatibility)
+    "get_evm_account",
+    "get_cdp_client",
+    "get_cdp_network",
+    # Web3
+    "get_web3_client",
+    # Unified wallet functions (recommended)
+    "get_wallet_provider",
+    "get_wallet_signer",
+]

{intentkit-0.8.17.dev2 → intentkit-0.8.49/intentkit}/clients/cdp.py

@@ -83,6 +83,33 @@ async def get_evm_account(agent: Agent) -> EvmServerAccount:
     return account
 
 
+def get_cdp_network(agent: Agent) -> str:
+    if not agent.network_id:
+        raise IntentKitAPIError(
+            400,
+            "BadNetworkID",
+            "Your agent network ID is not set. Please set it in the agent config.",
+        )
+    mapping = {
+        "ethereum-mainnet": "ethereum",
+        "base-mainnet": "base",
+        "arbitrum-mainnet": "arbitrum",
+        "optimism-mainnet": "optimism",
+        "polygon-mainnet": "polygon",
+        "base-sepolia": "base-sepolia",
+    }
+    if agent.network_id == "solana":
+        raise IntentKitAPIError(
+            400, "BadNetworkID", "Solana is not supported by CDP EVM."
+        )
+    cdp_network = mapping.get(agent.network_id)
+    if not cdp_network:
+        raise IntentKitAPIError(
+            400, "BadNetworkID", f"Unsupported network ID: {agent.network_id}"
+        )
+    return cdp_network
+
+
 async def get_wallet_provider(agent: Agent) -> CdpEvmWalletProvider:
     _assert_cdp_wallet_provider(agent)
     if not agent.network_id: