intentkit 0.17.45__tar.gz → 0.17.47__tar.gz

{intentkit-0.17.45 → intentkit-0.17.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.17.45
+Version: 0.17.47
 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.17.45 → intentkit-0.17.47}/intentkit/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.17.45"
+__version__ = "0.17.47"
 __author__ = "Ruihua"
 __email__ = "ruihua@crestal.network"
 

{intentkit-0.17.45 → intentkit-0.17.47}/intentkit/core/client.py

@@ -39,7 +39,7 @@ async def execute_agent(message: ChatMessageCreate) -> list[ChatMessage]:
         response = await client.post(
             url,
             json=message.model_dump(mode="json"),
-            timeout=300,
+            timeout=1800,
         )
     response.raise_for_status()
     json_data = response.json()

{intentkit-0.17.45 → intentkit-0.17.47}/intentkit/core/executor.py

@@ -17,8 +17,11 @@ from datetime import datetime, timedelta, timezone
 from typing import Any
 
 from langchain_core.tools import BaseTool
+from langchain_core.tools.base import ToolException
 from langgraph.checkpoint.memory import InMemorySaver
 from langgraph.graph.state import CompiledStateGraph
+from pydantic import ValidationError
+from pydantic.v1 import ValidationError as ValidationErrorV1
 
 from intentkit.abstracts.graph import AgentContext, AgentState
 from intentkit.config.config import config
@@ -49,6 +52,11 @@ _global_lock = asyncio.Lock()
 _EXECUTOR_CACHE_TTL = timedelta(hours=1)
 
 
+def _should_retry_tool_failure(exc: Exception) -> bool:
+    """Retry transient tool failures, but not user-facing tool/validation errors."""
+    return not isinstance(exc, (ToolException, ValidationError, ValidationErrorV1))
+
+
 async def build_executor(
     agent: Agent,
     agent_data: AgentData,
@@ -242,7 +250,7 @@ async def build_executor(
         DynamicPromptMiddleware(agent, agent_data),
         EmptyContentSafetyMiddleware(),
         StepTrackingMiddleware(),
-        ToolRetryMiddleware(),
+        ToolRetryMiddleware(retry_on=_should_retry_tool_failure),
         ModelRetryMiddleware(),
     ]
 

{intentkit-0.17.45 → intentkit-0.17.47}/intentkit/skills/x402/base.py

@@ -14,12 +14,14 @@ import httpx
 from eth_abi.abi import encode
 from eth_utils.address import to_checksum_address
 from eth_utils.crypto import keccak
+from web3.exceptions import TimeExhausted, Web3RPCError
 from x402.schemas import PaymentRequired, PaymentRequiredV1
 
 from intentkit.config.config import config
 from intentkit.models.agent_data import AgentData
 from intentkit.models.x402_order import X402Order, X402OrderCreate
 from intentkit.skills.onchain import IntentKitOnChainSkill
+from intentkit.utils.alert import send_alert
 from intentkit.wallets.privy import CHAIN_CONFIGS, PrivyClient, transfer_erc20_gasless
 
 logger = logging.getLogger(__name__)
@@ -122,6 +124,30 @@ def decode_payment_signature_header(
         return None
 
 
+def format_prefund_web3_error(exc: Exception) -> str | None:
+    """Convert known web3 prefund failures into user-facing tool errors."""
+    if isinstance(exc, TimeExhausted):
+        return (
+            "Safe wallet prefund transaction was not confirmed before timeout. "
+            "The funding transaction may still be pending on-chain; please check "
+            "the wallet status and try again."
+        )
+
+    if isinstance(exc, Web3RPCError):
+        error_payload = exc.args[0] if exc.args else None
+        if isinstance(error_payload, dict):
+            error_message = str(error_payload.get("message") or exc)
+        else:
+            error_message = str(exc)
+
+        if "insufficient funds for gas" in error_message.lower():
+            return "Safe wallet prefund is temporarily unavailable. Please try again later."
+
+        return f"Safe wallet prefund RPC error: {error_message}"
+
+    return None
+
+
 def normalize_payment_required_payload(
     payload: dict[str, Any], default_version: int = 1
 ) -> dict[str, Any]:
@@ -242,6 +268,63 @@ class X402BaseSkill(IntentKitOnChainSkill):
         self._validate_wallet_provider()
         return await self.get_wallet_signer()
 
+    def alert_prefund_paymaster_gas_shortage(
+        self,
+        *,
+        skill_name: str,
+        method: str,
+        url: str,
+        exc: Web3RPCError,
+    ) -> None:
+        """Alert admins when Safe wallet prefund fails due to paymaster gas shortage."""
+        error_message = str(exc)
+        if "insufficient funds for gas" not in error_message.lower():
+            return
+
+        try:
+            context = self.get_context()
+            agent = context.agent
+            agent_id = context.agent_id
+            network_id = agent.network_id if agent else None
+            wallet_provider = agent.wallet_provider if agent else None
+        except (AttributeError, ValueError):
+            agent_id = "unknown"
+            network_id = None
+            wallet_provider = None
+
+        try:
+            send_alert(
+                message="<!channel> X402 paymaster gas shortage detected",
+                attachments=[
+                    {
+                        "color": "danger",
+                        "title": "Safe wallet prefund failed due to paymaster gas shortage",
+                        "fields": [
+                            {"title": "Agent ID", "short": True, "value": agent_id},
+                            {"title": "Skill", "short": True, "value": skill_name},
+                            {"title": "Method", "short": True, "value": method},
+                            {
+                                "title": "Wallet Provider",
+                                "short": True,
+                                "value": wallet_provider or "unknown",
+                            },
+                            {
+                                "title": "Network",
+                                "short": True,
+                                "value": network_id or "unknown",
+                            },
+                            {"title": "URL", "value": url},
+                            {"title": "Error", "value": error_message},
+                        ],
+                    }
+                ],
+            )
+        except Exception:
+            logger.exception(
+                "Failed to send x402 paymaster gas shortage alert for agent %s",
+                agent_id,
+            )
+
     async def _get_payment_requirement(
         self,
         method: str,

{intentkit-0.17.45 → intentkit-0.17.47}/intentkit/skills/x402/http_request.py

@@ -7,8 +7,9 @@ import httpx
 from epyxid import XID
 from langchain_core.tools import ArgsSchema, ToolException
 from pydantic import BaseModel, Field
+from web3.exceptions import TimeExhausted, Web3RPCError
 
-from intentkit.skills.x402.base import X402BaseSkill
+from intentkit.skills.x402.base import X402BaseSkill, format_prefund_web3_error
 from intentkit.skills.x402.httpx_compat import PaymentError, X402HttpxCompatClient
 from intentkit.utils.error import IntentKitAPIError
 
@@ -135,6 +136,18 @@ class X402HttpRequest(X402BaseSkill):
             ) from exc
         except httpx.RequestError as exc:
             raise ToolException(f"Failed to connect to {url} - {str(exc)}") from exc
+        except (TimeExhausted, Web3RPCError) as exc:
+            if isinstance(exc, Web3RPCError):
+                self.alert_prefund_paymaster_gas_shortage(
+                    skill_name=self.name,
+                    method=method_upper,
+                    url=url,
+                    exc=exc,
+                )
+            error_message = format_prefund_web3_error(exc)
+            if error_message:
+                raise ToolException(error_message) from exc
+            raise ToolException(str(exc)) from exc
         except IntentKitAPIError as exc:
             raise ToolException(str(exc)) from exc
         except ToolException:

{intentkit-0.17.45 → intentkit-0.17.47}/intentkit/skills/x402/pay.py

@@ -13,8 +13,9 @@ import httpx
 from epyxid import XID
 from langchain_core.tools import ArgsSchema, ToolException
 from pydantic import BaseModel, Field
+from web3.exceptions import TimeExhausted, Web3RPCError
 
-from intentkit.skills.x402.base import X402BaseSkill
+from intentkit.skills.x402.base import X402BaseSkill, format_prefund_web3_error
 from intentkit.skills.x402.httpx_compat import PaymentError, X402HttpxCompatClient
 from intentkit.utils.error import IntentKitAPIError
 
@@ -166,6 +167,18 @@ class X402Pay(X402BaseSkill):
             raise ToolException(
                 f"Network error while connecting to {url} or RPC: {str(exc)}"
             ) from exc
+        except (TimeExhausted, Web3RPCError) as exc:
+            if isinstance(exc, Web3RPCError):
+                self.alert_prefund_paymaster_gas_shortage(
+                    skill_name=self.name,
+                    method=method_upper,
+                    url=url,
+                    exc=exc,
+                )
+            error_message = format_prefund_web3_error(exc)
+            if error_message:
+                raise ToolException(error_message) from exc
+            raise ToolException(str(exc)) from exc
         except IntentKitAPIError as exc:
             raise ToolException(str(exc)) from exc
         except ToolException:

{intentkit-0.17.45 → intentkit-0.17.47}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "intentkit"
-version = "0.17.45"
+version = "0.17.47"
 description = "Intent-based AI Agent Platform - Core Package"
 authors = [
     { name = "Ruihua", email = "ruihua@crestal.network" },