intentkit 0.7.5.dev16__tar.gz → 0.7.5.dev17__tar.gz

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.7.5.dev16
+Version: 0.7.5.dev17
 Summary: Intent-based AI Agent Platform - Core Package
 Project-URL: Homepage, https://github.com/crestalnetwork/intentkit
 Project-URL: Repository, https://github.com/crestalnetwork/intentkit

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.7.5-dev16"
+__version__ = "0.7.5-dev17"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/models/agent.py

@@ -142,7 +142,7 @@ class AgentExample(BaseModel):
             description="Name of the example",
             max_length=50,
             json_schema_extra={
-                "x-group": "examples",
+                "x-placeholder": "Add a name for the example",
             },
         ),
     ]
@@ -152,7 +152,7 @@ class AgentExample(BaseModel):
             description="Description of the example",
             max_length=200,
             json_schema_extra={
-                "x-group": "examples",
+                "x-placeholder": "Add a short description for the example",
             },
         ),
     ]
@@ -162,7 +162,7 @@ class AgentExample(BaseModel):
             description="Example prompt",
             max_length=2000,
             json_schema_extra={
-                "x-group": "examples",
+                "x-placeholder": "The prompt will be sent to the agent",
             },
         ),
     ]
@@ -394,6 +394,21 @@ class AgentTable(Base, AgentUserInputColumns):
         nullable=True,
         comment="List of example interactions for the agent",
     )
+    public_extra = Column(
+        JSON().with_variant(JSONB(), "postgresql"),
+        nullable=True,
+        comment="Public extra data of the agent",
+    )
+    deployed_at = Column(
+        DateTime(timezone=True),
+        nullable=True,
+        comment="Timestamp when the agent was deployed",
+    )
+    public_info_updated_at = Column(
+        DateTime(timezone=True),
+        nullable=True,
+        comment="Timestamp when the agent public info was last updated",
+    )
 
     # auto timestamp
     created_at = Column(
@@ -881,6 +896,8 @@ class AgentUpdate(AgentUserInput):
             # update
             for key, value in self.model_dump(exclude_unset=True).items():
                 setattr(db_agent, key, value)
+            db_agent.version = self.hash()
+            db_agent.deployed_at = func.now()
             await db.commit()
             await db.refresh(db_agent)
             return Agent.model_validate(db_agent)
@@ -903,6 +920,7 @@ class AgentUpdate(AgentUserInput):
                 setattr(db_agent, key, value)
             # version
             db_agent.version = self.hash()
+            db_agent.deployed_at = func.now()
             await db.commit()
             await db.refresh(db_agent)
             return Agent.model_validate(db_agent)
@@ -964,6 +982,7 @@ class AgentCreate(AgentUpdate):
             try:
                 db_agent = AgentTable(**self.model_dump())
                 db_agent.version = self.hash()
+                db_agent.deployed_at = func.now()
                 db.add(db_agent)
                 await db.commit()
                 await db.refresh(db_agent)
@@ -991,7 +1010,6 @@ class AgentPublicInfo(BaseModel):
             default=None,
             description="Description of the agent, for public view, not contained in prompt",
             json_schema_extra={
-                "x-group": "basic",
                 "x-placeholder": "Introduce your agent",
             },
         ),
@@ -1002,7 +1020,6 @@ class AgentPublicInfo(BaseModel):
             default=None,
             description="Link of external website of the agent, if you have one",
             json_schema_extra={
-                "x-group": "basic",
                 "x-placeholder": "Enter agent external website url",
                 "format": "uri",
             },
@@ -1016,7 +1033,6 @@ class AgentPublicInfo(BaseModel):
             max_length=10,
             min_length=1,
             json_schema_extra={
-                "x-group": "basic",
                 "x-placeholder": "If one day, your agent has it's own token, what will it be?",
             },
         ),
@@ -1028,8 +1044,7 @@ class AgentPublicInfo(BaseModel):
             description="Token address of the agent",
             max_length=42,
             json_schema_extra={
-                "x-group": "internal",
-                "readOnly": True,
+                "x-placeholder": "The contract address of the agent token",
             },
         ),
     ]
@@ -1040,8 +1055,7 @@ class AgentPublicInfo(BaseModel):
             description="Pool of the agent token",
             max_length=42,
             json_schema_extra={
-                "x-group": "internal",
-                "readOnly": True,
+                "x-placeholder": "The contract address of the agent token pool",
             },
         ),
     ]
@@ -1052,7 +1066,7 @@ class AgentPublicInfo(BaseModel):
             description="Fee percentage of the agent",
             ge=Decimal("0.0"),
             json_schema_extra={
-                "x-group": "basic",
+                "x-placeholder": "Agent will charge service fee according to this ratio.",
             },
         ),
     ]
@@ -1063,7 +1077,7 @@ class AgentPublicInfo(BaseModel):
             description="Introduction of the example",
             max_length=2000,
             json_schema_extra={
-                "x-group": "examples",
+                "x-placeholder": "Add a short introduction in new chat",
             },
         ),
     ]
@@ -1074,11 +1088,51 @@ class AgentPublicInfo(BaseModel):
             description="List of example prompts for the agent",
             max_length=6,
             json_schema_extra={
-                "x-group": "examples",
                 "x-inline": True,
             },
         ),
     ]
+    public_extra: Annotated[
+        Optional[Dict[str, Any]],
+        PydanticField(
+            default=None,
+            description="Public extra data of the agent",
+        ),
+    ]
+
+    async def override(self, agent_id: str) -> "Agent":
+        """Override agent public info with all fields from this instance.
+
+        Args:
+            agent_id: The ID of the agent to override
+
+        Returns:
+            The updated Agent instance
+        """
+        async with get_session() as session:
+            # Get the agent from database
+            result = await session.execute(
+                select(AgentTable).where(AgentTable.id == agent_id)
+            )
+            db_agent = result.scalar_one_or_none()
+
+            if not db_agent:
+                raise IntentKitAPIError(404, "NotFound", f"Agent {agent_id} not found")
+
+            # Update public info fields
+            update_data = self.model_dump()
+            for key, value in update_data.items():
+                if hasattr(db_agent, key):
+                    setattr(db_agent, key, value)
+
+            # Update public_info_updated_at timestamp
+            db_agent.public_info_updated_at = func.now()
+
+            # Commit changes
+            await session.commit()
+            await session.refresh(db_agent)
+
+            return Agent.model_validate(db_agent)
 
 
 class Agent(AgentCreate, AgentPublicInfo):
@@ -1124,6 +1178,21 @@ class Agent(AgentCreate, AgentPublicInfo):
             description="Other helper data fields for query, come from agent and agent data"
         ),
     ]
+    deployed_at: Annotated[
+        Optional[datetime],
+        PydanticField(
+            default=None,
+            description="Timestamp when the agent was deployed",
+        ),
+    ]
+    public_info_updated_at: Annotated[
+        Optional[datetime],
+        PydanticField(
+            default=None,
+            description="Timestamp when the agent public info was last updated",
+        ),
+    ]
+
     # auto timestamp
     created_at: Annotated[
         datetime,

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "intentkit"
-version = "0.7.5-dev16"
+version = "0.7.5-dev17"
 description = "Intent-based AI Agent Platform - Core Package"
 authors = [{ name = "hyacinthus", email = "hyacinthus@gmail.com" }]
 requires-python = ">=3.12"

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/skills/lifi/__init__.py

@@ -1,5 +1,5 @@
 import logging
-from typing import List, Optional, TypedDict
+from typing import Any, List, Optional, TypedDict
 
 from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.base import SkillConfig, SkillState
@@ -32,10 +32,10 @@ async def get_skills(
     config: "Config",
     is_private: bool,
     store: SkillStoreABC,
-    **_,
+    **_: Any,
 ) -> list[LiFiBaseTool]:
     """Get all LiFi skills."""
-    available_skills = []
+    available_skills: list[str] = []
 
     # Log configuration
     logger.info(f"[LiFi_Skills] Initializing with config: {config}")
@@ -57,7 +57,7 @@ async def get_skills(
     logger.info(f"[LiFi_Skills] Available skills: {available_skills}")
 
     # Get each skill using the cached getter
-    skills = []
+    skills: list[LiFiBaseTool] = []
     for name in available_skills:
         try:
             skill = get_lifi_skill(name, store, config)

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/skills/lifi/token_execute.py

@@ -2,11 +2,12 @@ import asyncio
 from typing import Any, Dict, List, Optional, Type
 
 import httpx
+from coinbase_agentkit import CdpEvmWalletProvider
 from pydantic import BaseModel, Field
 from web3 import Web3
 
 from intentkit.abstracts.skill import SkillStoreABC
-from intentkit.clients import get_cdp_client
+from intentkit.clients import CdpClient, get_cdp_client
 from intentkit.skills.lifi.base import LiFiBaseTool
 from intentkit.skills.lifi.token_quote import TokenQuote
 from intentkit.skills.lifi.utils import (
@@ -69,7 +70,7 @@ class TokenExecute(LiFiBaseTool):
     default_slippage: float = 0.03
     allowed_chains: Optional[List[str]] = None
     max_execution_time: int = 300
-    quote_tool: TokenQuote = Field(default=None, exclude=True)
+    quote_tool: Optional[TokenQuote] = Field(default=None, exclude=True)
 
     def __init__(
         self,
@@ -77,7 +78,7 @@ class TokenExecute(LiFiBaseTool):
         default_slippage: float = 0.03,
         allowed_chains: Optional[List[str]] = None,
         max_execution_time: int = 300,
-    ):
+    ) -> None:
         """Initialize the TokenExecute skill with configuration options."""
         super().__init__(skill_store=skill_store)
         self.default_slippage = default_slippage
@@ -93,6 +94,8 @@ class TokenExecute(LiFiBaseTool):
 
     def _format_quote_result(self, data: Dict[str, Any]) -> str:
         """Format the quote result in a readable format."""
+        if self.quote_tool is None:
+            raise RuntimeError("Quote tool is not initialized")
         # Use the same formatting as token_quote
         return self.quote_tool._format_quote_result(data)
 
@@ -103,7 +106,7 @@ class TokenExecute(LiFiBaseTool):
         from_token: str,
         to_token: str,
         from_amount: str,
-        slippage: float = None,
+        slippage: Optional[float] = None,
         **kwargs,
     ) -> str:
         """Execute a token transfer."""
@@ -168,7 +171,9 @@ class TokenExecute(LiFiBaseTool):
 
                 # Step 3: Execute transaction
                 tx_hash = await self._execute_transfer_transaction(
-                    cdp_wallet_provider, quote_data
+                    cdp_wallet_provider,
+                    quote_data,
+                    from_address,
                 )
 
                 # Step 4: Monitor status and return result
@@ -180,10 +185,12 @@ class TokenExecute(LiFiBaseTool):
             self.logger.error("LiFi_Error: %s", str(e))
             return f"An unexpected error occurred: {str(e)}"
 
-    async def _get_cdp_wallet_provider(self, agent_id: str):
+    async def _get_cdp_wallet_provider(
+        self, agent_id: str
+    ) -> CdpEvmWalletProvider | str:
         """Get CDP wallet provider with error handling."""
         try:
-            cdp_client = await get_cdp_client(agent_id, self.skill_store)
+            cdp_client: CdpClient = await get_cdp_client(agent_id, self.skill_store)
             if not cdp_client:
                 return "CDP client not available. Please ensure your agent has CDP wallet configuration."
 
@@ -207,7 +214,7 @@ class TokenExecute(LiFiBaseTool):
         from_amount: str,
         slippage: float,
         from_address: str,
-    ) -> Dict[str, Any]:
+    ) -> Dict[str, Any] | str:
         """Get quote from LiFi API."""
         api_params = build_quote_params(
             from_chain,
@@ -249,7 +256,7 @@ class TokenExecute(LiFiBaseTool):
         return data
 
     async def _handle_token_approval(
-        self, wallet_provider, quote_data: Dict[str, Any]
+        self, wallet_provider: CdpEvmWalletProvider, quote_data: Dict[str, Any]
     ) -> Optional[str]:
         """Handle ERC20 token approval if needed."""
         estimate = quote_data.get("estimate", {})
@@ -273,13 +280,18 @@ class TokenExecute(LiFiBaseTool):
             raise Exception(f"Failed to approve token: {str(e)}")
 
     async def _execute_transfer_transaction(
-        self, wallet_provider, quote_data: Dict[str, Any]
+        self,
+        wallet_provider: CdpEvmWalletProvider,
+        quote_data: Dict[str, Any],
+        from_address: str,
     ) -> str:
         """Execute the main transfer transaction."""
         transaction_request = quote_data.get("transactionRequest")
 
         try:
-            tx_params = prepare_transaction_params(transaction_request)
+            tx_params = prepare_transaction_params(
+                transaction_request, wallet_address=from_address
+            )
             self.logger.info(
                 f"Sending transaction to {tx_params['to']} with value {tx_params['value']}"
             )
@@ -407,7 +419,7 @@ class TokenExecute(LiFiBaseTool):
 
     async def _check_and_set_allowance(
         self,
-        wallet_provider,
+        wallet_provider: CdpEvmWalletProvider,
         token_address: str,
         approval_address: str,
         amount: str,

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/skills/lifi/token_quote.py

@@ -65,7 +65,7 @@ class TokenQuote(LiFiBaseTool):
         skill_store: SkillStoreABC,
         default_slippage: float = 0.03,
         allowed_chains: Optional[List[str]] = None,
-    ):
+    ) -> None:
         """Initialize the TokenQuote skill with configuration options."""
         super().__init__(skill_store=skill_store)
         self.default_slippage = default_slippage
@@ -78,7 +78,7 @@ class TokenQuote(LiFiBaseTool):
         from_token: str,
         to_token: str,
         from_amount: str,
-        slippage: float = None,
+        slippage: Optional[float] = None,
         **kwargs,
     ) -> str:
         """Get a quote for token transfer."""

{intentkit-0.7.5.dev16 → intentkit-0.7.5.dev17}/skills/lifi/utils.py

@@ -4,6 +4,7 @@ LiFi Skills Utilities
 Common utilities and helper functions for LiFi token transfer skills.
 """
 
+from decimal import ROUND_DOWN, Decimal, InvalidOperation
 from typing import Any, Dict, List, Optional, Tuple
 
 import httpx
@@ -179,7 +180,7 @@ def handle_api_response(
     from_chain: str,
     to_token: str,
     to_chain: str,
-) -> Tuple[Optional[Dict], Optional[str]]:
+) -> Tuple[Optional[Dict[str, Any]], Optional[str]]:
     """
     Handle LiFi API response and return data or error message.
 
@@ -293,17 +294,20 @@ def convert_chain_to_id(chain: str) -> int:
 
 
 def convert_amount_to_wei(amount: str, token_symbol: str = "ETH") -> str:
-    """
-    Convert human-readable amount to wei format for LiFi API.
+    """Convert a token amount into the smallest denomination expected by LiFi."""
 
-    Args:
-        amount: Amount in human readable format (e.g., "0.0015")
-        token_symbol: Token symbol to determine decimals
+    if amount is None:
+        raise ValueError("Amount is required")
+
+    normalized_amount = amount.strip()
+    if not normalized_amount:
+        raise ValueError("Amount cannot be empty")
+
+    # If the user already provided an integer amount without a decimal point,
+    # assume it is already in the token's smallest denomination.
+    if normalized_amount.isdigit():
+        return normalized_amount
 
-    Returns:
-        Amount in wei format as string
-    """
-    # Default decimals for common tokens
     token_decimals = {
         "ETH": 18,
         "USDC": 6,
@@ -318,13 +322,16 @@ def convert_amount_to_wei(amount: str, token_symbol: str = "ETH") -> str:
     decimals = token_decimals.get(token_symbol.upper(), 18)
 
     try:
-        # Convert string to float, then to wei
-        amount_float = float(amount)
-        amount_wei = int(amount_float * (10**decimals))
-        return str(amount_wei)
-    except (ValueError, TypeError):
-        # If conversion fails, return original amount
-        return amount
+        decimal_amount = Decimal(normalized_amount)
+        scaled_amount = (decimal_amount * (Decimal(10) ** decimals)).quantize(
+            Decimal("1"),
+            rounding=ROUND_DOWN,
+        )
+        return str(int(scaled_amount))
+    except (InvalidOperation, ValueError, TypeError):
+        # If conversion fails, fall back to the original value to avoid
+        # accidentally submitting an incorrect amount.
+        return normalized_amount
 
 
 def build_quote_params(
@@ -350,15 +357,12 @@ def build_quote_params(
     Raises:
         ValueError: If chain identifiers are not recognized
     """
-    # Convert amount to wei format for API
-    wei_amount = convert_amount_to_wei(from_amount, from_token)
-
     return {
         "fromChain": convert_chain_to_id(from_chain),
         "toChain": convert_chain_to_id(to_chain),
         "fromToken": from_token,
         "toToken": to_token,
-        "fromAmount": wei_amount,
+        "fromAmount": convert_amount_to_wei(from_amount, from_token),
         "fromAddress": from_address or DUMMY_ADDRESS,
         "slippage": slippage,
     }
@@ -381,36 +385,85 @@ def is_native_token(token_address: str) -> bool:
     )
 
 
-def prepare_transaction_params(transaction_request: Dict[str, Any]) -> Dict[str, Any]:
-    """
-    Prepare transaction parameters for CDP wallet provider.
+def _convert_hex_or_decimal(value: Any) -> Optional[int]:
+    """Convert LiFi transaction numeric values into integers."""
 
-    Args:
-        transaction_request: Transaction request from LiFi API
+    if value is None:
+        return None
 
-    Returns:
-        Formatted transaction parameters
+    if isinstance(value, int):
+        return value
+
+    if isinstance(value, str):
+        stripped = value.strip()
+        if not stripped:
+            return None
+        if stripped.startswith("0x"):
+            return int(stripped, 16)
+        try:
+            return int(Decimal(stripped))
+        except (InvalidOperation, ValueError):
+            return None
+
+    return None
+
+
+def prepare_transaction_params(
+    transaction_request: Dict[str, Any],
+    wallet_address: Optional[str] = None,
+) -> Dict[str, Any]:
+    """Prepare transaction parameters for the CDP wallet provider."""
 
-    Raises:
-        Exception: If required parameters are missing
-    """
     to_address = transaction_request.get("to")
-    value = transaction_request.get("value", "0")
+    value = transaction_request.get("value", "0x0")
     data = transaction_request.get("data", "0x")
 
     if not to_address:
-        raise Exception("No destination address in transaction request")
+        raise Exception("Transaction request is missing destination address")
 
-    # Convert value to integer if it's a string
-    if isinstance(value, str):
-        value = int(value, 16) if value.startswith("0x") else int(value)
-
-    return {
+    tx_params: Dict[str, Any] = {
         "to": Web3.to_checksum_address(to_address),
-        "value": value,
         "data": data,
     }
 
+    int_value = _convert_hex_or_decimal(value)
+    if int_value is not None:
+        tx_params["value"] = int_value
+
+    chain_id = _convert_hex_or_decimal(transaction_request.get("chainId"))
+    if chain_id is not None:
+        tx_params["chainId"] = chain_id
+
+    gas_limit = _convert_hex_or_decimal(
+        transaction_request.get("gasLimit") or transaction_request.get("gas")
+    )
+    if gas_limit is not None:
+        tx_params["gas"] = gas_limit
+
+    gas_price = _convert_hex_or_decimal(transaction_request.get("gasPrice"))
+    if gas_price is not None:
+        tx_params["gasPrice"] = gas_price
+
+    max_fee_per_gas = _convert_hex_or_decimal(transaction_request.get("maxFeePerGas"))
+    if max_fee_per_gas is not None:
+        tx_params["maxFeePerGas"] = max_fee_per_gas
+
+    max_priority_fee_per_gas = _convert_hex_or_decimal(
+        transaction_request.get("maxPriorityFeePerGas")
+    )
+    if max_priority_fee_per_gas is not None:
+        tx_params["maxPriorityFeePerGas"] = max_priority_fee_per_gas
+
+    nonce = _convert_hex_or_decimal(transaction_request.get("nonce"))
+    if nonce is not None:
+        tx_params["nonce"] = nonce
+
+    from_address = transaction_request.get("from") or wallet_address
+    if from_address:
+        tx_params["from"] = Web3.to_checksum_address(from_address)
+
+    return tx_params
+
 
 def format_quote_basic_info(data: Dict[str, Any]) -> Dict[str, Any]:
     """
@@ -464,7 +517,7 @@ def format_fees_and_gas(data: Dict[str, Any]) -> Tuple[str, str]:
 
     # Extract gas and fee costs
     gas_costs = estimate.get("gasCosts", [])
-    fee_costs = []
+    fee_costs: List[Dict[str, Any]] = []
 
     # Collect fee information from included steps
     for step in data.get("includedSteps", []):
@@ -476,7 +529,7 @@ def format_fees_and_gas(data: Dict[str, Any]) -> Tuple[str, str]:
     fees_text = ""
     if fee_costs:
         fees_text = "**Fees:**\n"
-        total_fee_usd = 0
+        total_fee_usd = 0.0
         for fee in fee_costs:
             fee_name = fee.get("name", "Unknown fee")
             fee_amount = fee.get("amount", "0")
@@ -508,7 +561,7 @@ def format_fees_and_gas(data: Dict[str, Any]) -> Tuple[str, str]:
     gas_text = ""
     if gas_costs:
         gas_text = "**Gas Cost:**\n"
-        total_gas_usd = 0
+        total_gas_usd = 0.0
         for gas in gas_costs:
             gas_amount = gas.get("amount", "0")
             gas_token = gas.get("token", {}).get("symbol", "ETH")
@@ -628,7 +681,7 @@ def get_explorer_url(chain_id: int, tx_hash: str) -> str:
 
 
 def format_transaction_result(
-    tx_hash: str, chain_id: int, token_info: dict = None
+    tx_hash: str, chain_id: int, token_info: Optional[Dict[str, str]] = None
 ) -> str:
     """
     Format transaction result with explorer link.