intentkit 0.6.13.dev2__py3-none-any.whl → 0.8.17__py3-none-any.whl

intentkit/skills/wow/schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "WOW",
+  "description": "WOW social token actions via Coinbase AgentKit",
+  "x-icon": "https://ai.service.crestal.dev/skills/wow/wow.svg",
+  "x-tags": [
+    "Crypto"
+  ],
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "title": "Enabled",
+      "description": "Whether this skill is enabled",
+      "default": false
+    },
+    "states": {
+      "type": "object",
+      "properties": {
+        "WowActionProvider_buy_token": {
+          "type": "string",
+          "title": "Buy Token",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "State for WowActionProvider_buy_token",
+          "default": "disabled"
+        },
+        "WowActionProvider_create_token": {
+          "type": "string",
+          "title": "Create Token",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "State for WowActionProvider_create_token",
+          "default": "disabled"
+        },
+        "WowActionProvider_sell_token": {
+          "type": "string",
+          "title": "Sell Token",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "State for WowActionProvider_sell_token",
+          "default": "disabled"
+        }
+      },
+      "description": "States for each WOW skill (disabled, public, or private)"
+    },
+    "api_key_provider": {
+      "type": "string",
+      "title": "API Key Provider",
+      "description": "Who provides the API key",
+      "enum": [
+        "platform"
+      ],
+      "x-enum-title": [
+        "Nation Hosted"
+      ],
+      "default": "platform"
+    }
+  },
+  "required": [
+    "states",
+    "enabled"
+  ],
+  "additionalProperties": true
+}

intentkit/skills/wow/wow.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <rect width="128" height="128" fill="#0f766e" rx="16" />
+  <text x="50%" y="50%" font-family="Arial,Helvetica,sans-serif" font-size="48" fill="#ecfeff" font-weight="700" text-anchor="middle">WOW</text>
+  <circle cx="32" cy="96" r="12" fill="#5eead4" />
+  <circle cx="64" cy="96" r="12" fill="#34d399" />
+  <circle cx="96" cy="96" r="12" fill="#22c55e" />
+</svg>

intentkit/skills/x402/__init__.py

@@ -0,0 +1,61 @@
+"""x402 skill category."""
+
+import logging
+from typing import TypedDict
+
+from intentkit.skills.base import SkillConfig, SkillState
+from intentkit.skills.x402.ask_agent import X402AskAgent
+from intentkit.skills.x402.base import X402BaseSkill
+from intentkit.skills.x402.http_request import X402HttpRequest
+
+logger = logging.getLogger(__name__)
+
+_cache: dict[str, X402BaseSkill] = {}
+
+
+class SkillStates(TypedDict):
+    x402_ask_agent: SkillState
+    x402_http_request: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration for x402 skills."""
+
+    states: SkillStates
+
+
+_SKILL_BUILDERS: dict[str, type[X402BaseSkill]] = {
+    "x402_ask_agent": X402AskAgent,
+    "x402_http_request": X402HttpRequest,
+}
+
+
+async def get_skills(
+    config: "Config",
+    is_private: bool,
+    **_,
+) -> list[X402BaseSkill]:
+    """Return enabled x402 skills for the agent."""
+    enabled_skills = []
+    for skill_name, state in config["states"].items():
+        if state == "disabled":
+            continue
+        if state == "public" or (state == "private" and is_private):
+            enabled_skills.append(skill_name)
+
+    result: list[X402BaseSkill] = []
+    for name in enabled_skills:
+        skill = _get_skill(name)
+        if skill:
+            result.append(skill)
+    return result
+
+
+def _get_skill(name: str) -> X402BaseSkill | None:
+    builder = _SKILL_BUILDERS.get(name)
+    if builder:
+        if name not in _cache:
+            _cache[name] = builder()
+        return _cache[name]
+    logger.warning("Unknown x402 skill requested: %s", name)
+    return None

intentkit/skills/x402/ask_agent.py

@@ -0,0 +1,98 @@
+import logging
+from typing import Any
+
+from langchain_core.tools import ToolException
+from pydantic import BaseModel, Field
+
+from intentkit.config.config import config
+from intentkit.models.chat import AuthorType
+from intentkit.skills.x402.base import X402BaseSkill
+
+logger = logging.getLogger(__name__)
+
+
+class AskAgentInput(BaseModel):
+    """Arguments for the x402 ask agent skill."""
+
+    agent_id: str = Field(description="ID or slug of the agent to query.")
+    message: str = Field(description="Message to send to the target agent.")
+    search_mode: bool | None = Field(
+        default=None, description="Enable search mode when interacting with the agent."
+    )
+    super_mode: bool | None = Field(
+        default=None, description="Enable super mode when interacting with the agent."
+    )
+
+
+class X402AskAgent(X402BaseSkill):
+    """Skill that queries another agent via the x402 API."""
+
+    name: str = "x402_ask_agent"
+    description: str = (
+        "Call another agent through the x402 API and return the final agent message."
+    )
+    args_schema: type[BaseModel] = AskAgentInput
+
+    async def _arun(
+        self,
+        agent_id: str,
+        message: str,
+        search_mode: bool | None = None,
+        super_mode: bool | None = None,
+    ) -> str:
+        try:
+            # Use wallet provider signer to satisfy eth_account.BaseAccount interface requirements
+            base_url = (config.open_api_base_url or "").rstrip("/")
+            if not base_url:
+                raise ToolException("X402 API base URL is not configured.")
+            target_url = f"{base_url}/x402"
+            payload: dict[str, Any] = {
+                "agent_id": agent_id,
+                "message": message,
+                "app_id": "skill",
+            }
+            if search_mode is not None:
+                payload["search_mode"] = search_mode
+            if super_mode is not None:
+                payload["super_mode"] = super_mode
+
+            async with self.http_client(timeout=20.0) as client:
+                response = await client.post(target_url, json=payload)
+                try:
+                    response.raise_for_status()
+                except Exception as e:
+                    error_body = ""
+                    try:
+                        error_body = response.text
+                    except Exception:
+                        error_body = "Unable to read response body"
+                    logger.error(
+                        f"HTTP request failed with status {response.status_code}: {error_body}"
+                    )
+                    raise ToolException(
+                        f"HTTP request failed with status {response.status_code}: {error_body}"
+                    ) from e
+                messages = response.json()
+            if not isinstance(messages, list) or not messages:
+                raise ValueError("Agent returned an empty response.")
+
+            last_message = messages[-1]
+            if not isinstance(last_message, dict):
+                raise ValueError("Agent response format is invalid.")
+
+            author_type = last_message.get("author_type")
+            content = last_message.get("message")
+
+            if author_type == AuthorType.SYSTEM.value:
+                raise ToolException(content or "Agent returned a system message.")
+
+            if not content:
+                raise ToolException("Agent response did not include message text.")
+
+            return str(content)
+        except ToolException:
+            # Re-raise ToolException as-is
+            raise
+        except Exception as e:
+            logger.error(f"Unexpected error in x402_ask_agent: {str(e)}")
+            raise ToolException(f"Unexpected error occurred: {str(e)}") from e

intentkit/skills/x402/base.py

@@ -0,0 +1,99 @@
+import logging
+import threading
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
+from typing import Any
+
+from coinbase_agentkit.wallet_providers.evm_wallet_provider import (
+    EvmWalletSigner as CoinbaseEvmWalletSigner,
+)
+from x402.clients.httpx import x402HttpxClient
+
+from intentkit.clients import get_wallet_provider
+from intentkit.skills.onchain import IntentKitOnChainSkill
+
+logger = logging.getLogger(__name__)
+
+
+class X402BaseSkill(IntentKitOnChainSkill):
+    """Base class for x402 skills."""
+
+    @property
+    def category(self) -> str:
+        return "x402"
+
+    async def _get_signer(self) -> "ThreadSafeEvmWalletSigner":
+        context = self.get_context()
+        wallet_provider = await get_wallet_provider(context.agent)
+        return ThreadSafeEvmWalletSigner(wallet_provider)
+
+    @asynccontextmanager
+    async def http_client(
+        self,
+        timeout: float = 30.0,
+    ) -> AsyncIterator[x402HttpxClient]:
+        account = await self._get_signer()
+        try:
+            async with x402HttpxClient(
+                account=account,
+                timeout=timeout,
+            ) as client:
+                yield client
+        except Exception:
+            logger.exception("Failed to create x402 HTTP client")
+            raise
+
+
+class ThreadSafeEvmWalletSigner(CoinbaseEvmWalletSigner):
+    """EVM wallet signer that avoids nested event loop errors.
+
+    Coinbase's signer runs async wallet calls in the current thread. When invoked
+    inside an active asyncio loop (as happens in async skills), it trips over the
+    loop already running. We hop work to a background thread so the provider can
+    spin up its own loop safely.
+    """
+
+    def __init__(self, wallet_provider: Any):
+        super().__init__(wallet_provider=wallet_provider)
+
+    def _run_in_thread(self, func: Any, *args: Any, **kwargs: Any) -> Any:
+        result: list[Any] = []
+        error: list[BaseException] = []
+
+        def _target() -> None:
+            try:
+                result.append(func(*args, **kwargs))
+            except BaseException as exc:  # pragma: no cover - bubble up original error
+                error.append(exc)
+
+        thread = threading.Thread(target=_target, daemon=True)
+        thread.start()
+        thread.join()
+
+        if error:
+            raise error[0]
+        return result[0] if result else None
+
+    def unsafe_sign_hash(self, message_hash: Any) -> Any:
+        return self._run_in_thread(super().unsafe_sign_hash, message_hash)
+
+    def sign_message(self, signable_message: Any) -> Any:
+        return self._run_in_thread(super().sign_message, signable_message)
+
+    def sign_transaction(self, transaction_dict: Any) -> Any:
+        return self._run_in_thread(super().sign_transaction, transaction_dict)
+
+    def sign_typed_data(
+        self,
+        domain_data: Any | None = None,
+        message_types: Any | None = None,
+        message_data: Any | None = None,
+        full_message: Any | None = None,
+    ) -> Any:
+        return self._run_in_thread(
+            super().sign_typed_data,
+            domain_data=domain_data,
+            message_types=message_types,
+            message_data=message_data,
+            full_message=full_message,
+        )

intentkit/skills/x402/http_request.py

@@ -0,0 +1,117 @@
+import logging
+from typing import Any
+from urllib.parse import urlparse
+
+import httpx
+from langchain_core.tools import ToolException
+from pydantic import BaseModel, Field
+
+from intentkit.skills.x402.base import X402BaseSkill
+
+logger = logging.getLogger(__name__)
+
+
+class X402HttpRequestInput(BaseModel):
+    """Arguments for a generic x402 HTTP request."""
+
+    method: str = Field(description="HTTP method to use. Supported values: GET, POST.")
+    url: str = Field(
+        description="Absolute URL for the request (must include scheme and host)."
+    )
+    headers: dict[str, str] | None = Field(
+        default=None,
+        description="Optional headers to include in the request.",
+    )
+    params: dict[str, Any] | None = Field(
+        default=None,
+        description="Optional query parameters to include in the request.",
+    )
+    data: dict[str, Any] | str | None = Field(
+        default=None,
+        description=(
+            "Optional request body. Dictionaries are sent as JSON; strings are sent as raw data. "
+            "Only supported for POST requests."
+        ),
+    )
+    timeout: float | None = Field(
+        default=30.0,
+        description="Request timeout in seconds.",
+    )
+
+
+class X402HttpRequest(X402BaseSkill):
+    """Skill that performs signed HTTP requests via the x402 client."""
+
+    name: str = "x402_http_request"
+    description: str = (
+        "Send an HTTP GET or POST request using the x402 payment protocol. "
+        "Provide the method, absolute URL, optional headers, query parameters, and request body. "
+        "Returns the response status and body text."
+    )
+    args_schema: type[BaseModel] = X402HttpRequestInput
+
+    async def _arun(
+        self,
+        method: str,
+        url: str,
+        headers: dict[str, str] | None = None,
+        params: dict[str, Any] | None = None,
+        data: dict[str, Any] | str | None = None,
+        timeout: float = 30.0,
+        **_: Any,
+    ) -> str:
+        method_upper = method.upper()
+        if method_upper not in {"GET", "POST"}:
+            raise ToolException(
+                f"Unsupported HTTP method '{method}'. Only GET and POST are allowed."
+            )
+
+        parsed = urlparse(url)
+        if not (parsed.scheme and parsed.netloc):
+            raise ToolException("URL must include scheme and host (absolute URL).")
+
+        request_headers = dict(headers or {})
+        request_kwargs: dict[str, Any] = {
+            "url": url,
+            "headers": request_headers or None,
+            "params": params,
+            "timeout": timeout,
+        }
+
+        if method_upper == "POST":
+            if isinstance(data, dict):
+                header_keys = {key.lower() for key in request_headers}
+                if "content-type" not in header_keys:
+                    request_headers["Content-Type"] = "application/json"
+                request_kwargs["json"] = data
+            elif isinstance(data, str):
+                request_kwargs["content"] = data
+            elif data is not None:
+                raise ToolException(
+                    "POST body must be either a JSON-serializable object or a string."
+                )
+        elif data is not None:
+            raise ToolException("Request body is only supported for POST requests.")
+
+        try:
+            async with self.http_client(timeout=timeout) as client:
+                response = await client.request(method_upper, **request_kwargs)
+                response.raise_for_status()
+                return f"Status: {response.status_code}\nContent: {response.text}"
+        except ValueError as exc:
+            raise ToolException(str(exc)) from exc
+        except httpx.TimeoutException as exc:
+            raise ToolException(
+                f"Request to {url} timed out after {timeout} seconds"
+            ) from exc
+        except httpx.HTTPStatusError as exc:
+            raise ToolException(
+                f"HTTP {exc.response.status_code} - {exc.response.text}"
+            ) from exc
+        except httpx.RequestError as exc:
+            raise ToolException(f"Failed to connect to {url} - {str(exc)}") from exc
+        except ToolException:
+            raise
+        except Exception as exc:
+            logger.error("Unexpected error in x402_http_request", exc_info=exc)
+            raise ToolException(f"Unexpected error occurred - {str(exc)}") from exc

intentkit/skills/x402/schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "x402",
+  "description": "Interact with other IntentKit agents through the x402 payment protocol.",
+  "x-icon": "https://ai.service.crestal.dev/skills/x402/x402.webp",
+  "x-tags": ["Communication", "Infrastructure"],
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "title": "Enabled",
+      "description": "Whether this skill category is enabled.",
+      "default": false
+    },
+    "states": {
+      "type": "object",
+      "properties": {
+        "x402_ask_agent": {
+          "type": "string",
+          "title": "Ask Agent",
+          "enum": ["disabled", "public", "private"],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Send a message to another IntentKit agent via the x402 API and return the final agent response.",
+          "default": "disabled"
+        },
+        "x402_http_request": {
+          "type": "string",
+          "title": "HTTP Request",
+          "enum": ["disabled", "public", "private"],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Perform a signed HTTP GET or POST request via the x402 payment protocol.",
+          "default": "disabled"
+        }
+      }
+    }
+  }
+}

intentkit/skills/xmtp/__init__.py

@@ -3,7 +3,6 @@
 import logging
 from typing import TypedDict
 
-from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.base import SkillConfig, SkillState
 from intentkit.skills.xmtp.base import XmtpBaseTool
 from intentkit.skills.xmtp.price import XmtpGetSwapPrice
@@ -31,7 +30,6 @@ class Config(SkillConfig):
 async def get_skills(
     config: "Config",
     is_private: bool,
-    store: SkillStoreABC,
     **_,
 ) -> list[XmtpBaseTool]:
     """Get all XMTP skills.
@@ -39,7 +37,6 @@ async def get_skills(
     Args:
         config: The configuration for XMTP skills.
         is_private: Whether to include private skills.
-        store: The skill store for persisting data.
 
     Returns:
         A list of XMTP skills.
@@ -56,7 +53,7 @@ async def get_skills(
     # Get each skill using the cached getter
     result = []
     for name in available_skills:
-        skill = get_xmtp_skill(name, store)
+        skill = get_xmtp_skill(name)
         if skill:
             result.append(skill)
     return result
@@ -64,34 +61,26 @@ async def get_skills(
 
 def get_xmtp_skill(
     name: str,
-    store: SkillStoreABC,
 ) -> XmtpBaseTool:
     """Get an XMTP skill by name.
 
     Args:
         name: The name of the skill to get
-        store: The skill store for persisting data
 
     Returns:
         The requested XMTP skill
     """
     if name == "xmtp_transfer":
         if name not in _cache:
-            _cache[name] = XmtpTransfer(
-                skill_store=store,
-            )
+            _cache[name] = XmtpTransfer()
         return _cache[name]
     elif name == "xmtp_swap":
         if name not in _cache:
-            _cache[name] = XmtpSwap(
-                skill_store=store,
-            )
+            _cache[name] = XmtpSwap()
         return _cache[name]
     elif name == "xmtp_get_swap_price":
         if name not in _cache:
-            _cache[name] = XmtpGetSwapPrice(
-                skill_store=store,
-            )
+            _cache[name] = XmtpGetSwapPrice()
         return _cache[name]
     else:
         logger.warning(f"Unknown XMTP skill: {name}")

intentkit/skills/xmtp/base.py

@@ -1,15 +1,74 @@
 from typing import Literal
 
-from intentkit.skills.base import IntentKitSkill
+from intentkit.skills.onchain import IntentKitOnChainSkill
 
 
-class XmtpBaseTool(IntentKitSkill):
+class XmtpBaseTool(IntentKitOnChainSkill):
     """Base class for XMTP-related skills."""
 
     # Set response format to content_and_artifact for returning tuple
     response_format: Literal["content", "content_and_artifact"] = "content_and_artifact"
 
+    # ChainId mapping for XMTP wallet_sendCalls (mainnet only)
+    CHAIN_ID_HEX_BY_NETWORK: dict[str, str] = {
+        "ethereum-mainnet": "0x1",  # 1
+        "base-mainnet": "0x2105",  # 8453
+        "arbitrum-mainnet": "0xA4B1",  # 42161
+        "optimism-mainnet": "0xA",  # 10
+    }
+
+    # CDP network mapping for swap quote API (mainnet only)
+    NETWORK_FOR_CDP_MAPPING: dict[str, str] = {
+        "ethereum-mainnet": "ethereum",
+        "base-mainnet": "base",
+        "arbitrum-mainnet": "arbitrum",
+        "optimism-mainnet": "optimism",
+    }
+
     @property
     def category(self) -> str:
         """Return the skill category."""
         return "xmtp"
+
+    def validate_network_and_get_chain_id(
+        self, network_id: str, skill_name: str
+    ) -> str:
+        """Validate network and return chain ID hex.
+
+        Args:
+            network_id: The network ID to validate
+            skill_name: The name of the skill for error messages
+
+        Returns:
+            The hex chain ID for the network
+
+        Raises:
+            ValueError: If the network is not supported
+        """
+        if network_id not in self.CHAIN_ID_HEX_BY_NETWORK:
+            supported_networks = ", ".join(self.CHAIN_ID_HEX_BY_NETWORK.keys())
+            raise ValueError(
+                f"XMTP {skill_name} supports the following networks: {supported_networks}. "
+                f"Current agent network: {network_id}"
+            )
+        return self.CHAIN_ID_HEX_BY_NETWORK[network_id]
+
+    def get_cdp_network(self, network_id: str) -> str:
+        """Get CDP network name for the given network ID.
+
+        Args:
+            network_id: The network ID
+
+        Returns:
+            The CDP network name
+
+        Raises:
+            ValueError: If the network is not supported for CDP
+        """
+        if network_id not in self.NETWORK_FOR_CDP_MAPPING:
+            supported_networks = ", ".join(self.NETWORK_FOR_CDP_MAPPING.keys())
+            raise ValueError(
+                f"CDP swap does not support network: {network_id}. "
+                f"Supported networks: {supported_networks}"
+            )
+        return self.NETWORK_FOR_CDP_MAPPING[network_id]