intentkit 0.7.5.dev3__py3-none-any.whl → 0.8.34.dev7__py3-none-any.whl

intentkit/MANIFEST.in

@@ -0,0 +1,14 @@
+include README.md
+include LICENSE
+recursive-include abstracts *.py
+recursive-include clients *.py
+recursive-include config *.py
+recursive-include core *.py
+recursive-include models *.py *.json
+recursive-include skills *.py *.toml *.md
+recursive-include utils *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.pyc
+recursive-exclude * *.pyo
+recursive-exclude * .DS_Store
+recursive-exclude * .ruff_cache

intentkit/README.md

@@ -0,0 +1,88 @@
+# IntentKit
+
+IntentKit is a powerful intent-based AI agent platform that enables developers to build sophisticated AI agents with blockchain and cryptocurrency capabilities.
+
+## Features
+
+- **Intent-based Architecture**: Build agents that understand and execute user intents
+- **Blockchain Integration**: Native support for multiple blockchain networks
+- **Cryptocurrency Operations**: Built-in tools for DeFi, trading, and token operations
+- **Extensible Skills System**: Modular skill system with 30+ pre-built skills
+- **Multi-platform Support**: Telegram, Twitter, Slack, and API integrations
+- **Advanced AI Capabilities**: Powered by LangChain and LangGraph
+
+## Installation
+
+```bash
+pip install intentkit
+```
+
+## Development
+
+To build the package locally:
+
+```bash
+# Build both source and wheel distributions
+uv build
+
+# Build only wheel
+uv build --wheel
+
+# Build only source distribution
+uv build --sdist
+```
+
+To publish to PyPI:
+
+```bash
+# Build and publish to PyPI
+uv build
+uv publish
+
+# Publish to Test PyPI
+uv publish --publish-url https://test.pypi.org/legacy/
+```
+
+> **Note**: This package uses `hatchling` as the build backend with `uv` for dependency management and publishing.
+
+## Quick Start
+
+```python
+from intentkit.core.agent import Agent
+from intentkit.config.config import Config
+
+# Initialize configuration
+config = Config()
+
+# Create an agent
+agent = Agent(config=config)
+
+# Your agent is ready to use!
+```
+
+## Skills
+
+IntentKit comes with 30+ pre-built skills including:
+
+- **DeFi**: Uniswap, 1inch, Enso, LiFi
+- **Data**: DexScreener, CoinGecko, DefiLlama, CryptoCompare
+- **Social**: Twitter, Telegram, Slack
+- **Blockchain**: CDP, Moralis, various wallet integrations
+- **AI**: OpenAI, Heurist, Venice AI
+- **And many more...**
+
+## Documentation
+
+For detailed documentation, examples, and guides, visit our [documentation](https://github.com/crestal-network/intentkit/tree/main/docs).
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://github.com/crestal-network/intentkit/blob/main/CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+For support, please open an issue on our [GitHub repository](https://github.com/crestal-network/intentkit/issues).

intentkit/__init__.py

@@ -3,15 +3,17 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.7.5-dev3"
-__author__ = "hyacinthus"
-__email__ = "hyacinthus@gmail.com"
+__version__ = "0.8.34-dev7"
+__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/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/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/abstracts/graph.py

@@ -1,8 +1,8 @@
-import asyncio
+from collections.abc import Callable
 from enum import Enum
-from typing import Any, Dict, NotRequired, Optional
+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
@@ -24,18 +24,25 @@ class AgentState(BaseAgentState):
 
     context: dict[str, Any]
     error: NotRequired[AgentError]
-    __extra__: NotRequired[Dict[str, Any]]
+    __extra__: NotRequired[dict[str, Any]]
 
 
 class AgentContext(BaseModel):
     agent_id: str
+    get_agent: Callable[[], Agent]
     chat_id: str
-    user_id: Optional[str] = None
-    app_id: Optional[str] = None
+    user_id: str | None = None
+    app_id: str | None = None
     entrypoint: AuthorType
     is_private: bool
-    payer: Optional[str] = None
+    search: bool = False
+    thinking: bool = False
+    payer: str | None = None
 
     @property
     def agent(self) -> Agent:
-        return asyncio.run(Agent.get(self.agent_id))
+        return self.get_agent()
+
+    @property
+    def thread_id(self) -> str:
+        return f"{self.agent_id}-{self.chat_id}"

intentkit/abstracts/skill.py

@@ -1,7 +1,7 @@
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional
+from typing import Any
 
-from intentkit.models.agent import Agent, AgentAutonomous
+from intentkit.models.agent import Agent
 from intentkit.models.agent_data import AgentData, AgentQuota
 
 
@@ -20,7 +20,7 @@ class SkillStoreABC(ABC):
 
     @staticmethod
     @abstractmethod
-    async def get_agent_config(agent_id: str) -> Optional[Agent]:
+    async def get_agent_config(agent_id: str) -> Agent | None:
         """Get agent configuration.
 
         Returns:
@@ -30,7 +30,7 @@ class SkillStoreABC(ABC):
 
     @staticmethod
     @abstractmethod
-    async def get_agent_data(agent_id: str) -> Optional[AgentData]:
+    async def get_agent_data(agent_id: str) -> AgentData | None:
         """Get additional agent data.
 
         Returns:
@@ -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) -> None:
         """Update agent data.
 
         Args:
@@ -51,148 +51,10 @@ class SkillStoreABC(ABC):
 
     @staticmethod
     @abstractmethod
-    async def get_agent_quota(agent_id: str) -> Optional[AgentQuota]:
+    async def get_agent_quota(agent_id: str) -> AgentQuota | None:
         """Get agent quota information.
 
         Returns:
             Agent quota if found, None otherwise
         """
         pass
-
-    @staticmethod
-    @abstractmethod
-    async def get_agent_skill_data(
-        agent_id: str, skill: str, key: str
-    ) -> Optional[Dict[str, Any]]:
-        """Get skill data for an agent.
-
-        Args:
-            agent_id: ID of the agent
-            skill: Name of the skill
-            key: Data key
-
-        Returns:
-            Dictionary containing the skill data if found, None otherwise
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def save_agent_skill_data(
-        agent_id: str, skill: str, key: str, data: Dict[str, Any]
-    ) -> None:
-        """Save or update skill data for an agent.
-
-        Args:
-            agent_id: ID of the agent
-            skill: Name of the skill
-            key: Data key
-            data: JSON data to store
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def delete_agent_skill_data(agent_id: str, skill: str, key: str) -> None:
-        """Delete skill data for an agent.
-
-        Args:
-            agent_id: ID of the agent
-            skill: Name of the skill
-            key: Data key
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def get_thread_skill_data(
-        thread_id: str, skill: str, key: str
-    ) -> Optional[Dict[str, Any]]:
-        """Get skill data for a thread.
-
-        Args:
-            thread_id: ID of the thread
-            skill: Name of the skill
-            key: Data key
-
-        Returns:
-            Dictionary containing the skill data if found, None otherwise
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def save_thread_skill_data(
-        thread_id: str,
-        agent_id: str,
-        skill: str,
-        key: str,
-        data: Dict[str, Any],
-    ) -> None:
-        """Save or update skill data for a thread.
-
-        Args:
-            thread_id: ID of the thread
-            agent_id: ID of the agent that owns this thread
-            skill: Name of the skill
-            key: Data key
-            data: JSON data to store
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def list_autonomous_tasks(agent_id: str) -> List[AgentAutonomous]:
-        """List all autonomous tasks for an agent.
-
-        Args:
-            agent_id: ID of the agent
-
-        Returns:
-            List[AgentAutonomous]: List of autonomous task configurations
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def add_autonomous_task(
-        agent_id: str, task: AgentAutonomous
-    ) -> AgentAutonomous:
-        """Add a new autonomous task to an agent.
-
-        Args:
-            agent_id: ID of the agent
-            task: Autonomous task configuration
-
-        Returns:
-            AgentAutonomous: The created task
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def delete_autonomous_task(agent_id: str, task_id: str) -> None:
-        """Delete an autonomous task from an agent.
-
-        Args:
-            agent_id: ID of the agent
-            task_id: ID of the task to delete
-        """
-        pass
-
-    @staticmethod
-    @abstractmethod
-    async def update_autonomous_task(
-        agent_id: str, task_id: str, task_updates: dict
-    ) -> AgentAutonomous:
-        """Update an autonomous task for an agent.
-
-        Args:
-            agent_id: ID of the agent
-            task_id: ID of the task to update
-            task_updates: Dictionary containing fields to update
-
-        Returns:
-            AgentAutonomous: The updated task
-        """
-        pass

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/clients/__init__.py

@@ -1,4 +1,9 @@
-from intentkit.clients.cdp import CdpClient, get_cdp_client
+from intentkit.clients.cdp import (
+    get_cdp_client,
+    get_cdp_network,
+    get_evm_account,
+    get_wallet_provider,
+)
 from intentkit.clients.twitter import (
     TwitterClient,
     TwitterClientConfig,
@@ -10,7 +15,9 @@ __all__ = [
     "TwitterClient",
     "TwitterClientConfig",
     "get_twitter_client",
-    "CdpClient",
+    "get_evm_account",
     "get_cdp_client",
+    "get_wallet_provider",
+    "get_cdp_network",
     "get_web3_client",
 ]