intentkit 0.7.5.dev3__py3-none-any.whl → 0.8.34.dev7__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,58 @@
+"""x402 skill category."""
+
+import logging
+from typing import TypedDict
+
+from intentkit.skills.base import SkillConfig, SkillState
+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_http_request: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration for x402 skills."""
+
+    states: SkillStates
+
+
+_SKILL_BUILDERS: dict[str, type[X402BaseSkill]] = {
+    "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/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,40 @@
+{
+  "$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_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,16 +1,16 @@
-from typing import Dict, Literal
+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] = {
+    CHAIN_ID_HEX_BY_NETWORK: dict[str, str] = {
         "ethereum-mainnet": "0x1",  # 1
         "base-mainnet": "0x2105",  # 8453
         "arbitrum-mainnet": "0xA4B1",  # 42161
@@ -18,7 +18,7 @@ class XmtpBaseTool(IntentKitSkill):
     }
 
     # CDP network mapping for swap quote API (mainnet only)
-    NETWORK_FOR_CDP_MAPPING: Dict[str, str] = {
+    NETWORK_FOR_CDP_MAPPING: dict[str, str] = {
         "ethereum-mainnet": "ethereum",
         "base-mainnet": "base",
         "arbitrum-mainnet": "arbitrum",

intentkit/skills/xmtp/price.py

@@ -1,8 +1,9 @@
-from typing import Literal, Type
+from typing import Literal
 
+from langchain_core.tools.base import ToolException
 from pydantic import BaseModel, Field
 
-from intentkit.clients.cdp import get_origin_cdp_client
+from intentkit.clients.cdp import get_cdp_client
 from intentkit.skills.xmtp.base import XmtpBaseTool
 
 
@@ -23,7 +24,7 @@ class XmtpGetSwapPrice(XmtpBaseTool):
     name: str = "xmtp_get_swap_price"
     description: str = "Get an indicative swap price/quote for token pair and amount on Ethereum, Base, Arbitrum, and Optimism mainnet networks using CDP."
     response_format: Literal["content", "content_and_artifact"] = "content"
-    args_schema: Type[BaseModel] = SwapPriceInput
+    args_schema: type[BaseModel] = SwapPriceInput
 
     async def _arun(
         self,
@@ -43,14 +44,14 @@ class XmtpGetSwapPrice(XmtpBaseTool):
             "optimism-mainnet",
         ]
         if agent.network_id not in supported_networks:
-            raise ValueError(
+            raise ToolException(
                 f"Swap price only supported on {', '.join(supported_networks)}. Current: {agent.network_id}"
             )
 
         network_for_cdp = self.get_cdp_network(agent.network_id)
 
-        cdp_client = get_origin_cdp_client(self.skill_store)
-        # Note: Don't use async with context manager as get_origin_cdp_client returns a managed global client
+        cdp_client = get_cdp_client()
+        # Note: Don't use async with context manager as get_cdp_client returns a managed global client
         price = await cdp_client.evm.get_swap_price(
             from_token=from_token,
             to_token=to_token,