intentkit 0.8.16.dev1__py3-none-any.whl → 0.8.17.dev2__py3-none-any.whl

intentkit/skills/web_scraper/website_indexer.py

@@ -1,5 +1,4 @@
 import logging
-from typing import List, Type
 from urllib.parse import urljoin, urlparse
 
 import httpx
@@ -44,11 +43,11 @@ class WebsiteIndexerInput(BaseModel):
         ge=0,
         le=1000,
     )
-    include_patterns: List[str] = Field(
+    include_patterns: list[str] = Field(
         description="URL patterns to include (e.g., ['/blog/', '/docs/']). If empty, all URLs are included",
         default=[],
     )
-    exclude_patterns: List[str] = Field(
+    exclude_patterns: list[str] = Field(
         description="URL patterns to exclude (e.g., ['/admin/', '/private/'])",
         default=[],
     )
@@ -68,7 +67,7 @@ class WebsiteIndexer(WebScraperBaseTool):
         "This tool finds sitemaps from robots.txt, parses the XML content to extract URLs, "
         "and then uses the reliable scrape_and_index functionality for content indexing."
     )
-    args_schema: Type[BaseModel] = WebsiteIndexerInput
+    args_schema: type[BaseModel] = WebsiteIndexerInput
 
     def _normalize_url(self, url: str) -> str:
         """Normalize URL by ensuring it has a proper scheme."""
@@ -106,7 +105,7 @@ class WebsiteIndexer(WebScraperBaseTool):
 
     def _extract_sitemaps_from_robots(
         self, robots_content: str, base_url: str
-    ) -> List[str]:
+    ) -> list[str]:
         """Extract sitemap URLs from robots.txt content."""
         sitemaps = []
 
@@ -121,7 +120,7 @@ class WebsiteIndexer(WebScraperBaseTool):
 
         return sitemaps
 
-    def _get_common_sitemap_patterns(self, base_url: str) -> List[str]:
+    def _get_common_sitemap_patterns(self, base_url: str) -> list[str]:
         """Generate common sitemap URL patterns."""
         return [
             urljoin(base_url, "/sitemap.xml"),
@@ -157,7 +156,7 @@ class WebsiteIndexer(WebScraperBaseTool):
                 logger.warning(f"Could not fetch sitemap from {sitemap_url}: {e}")
         return ""
 
-    async def _get_all_sitemap_content(self, base_url: str) -> tuple[str, List[str]]:
+    async def _get_all_sitemap_content(self, base_url: str) -> tuple[str, list[str]]:
         """Get all sitemap content for AI analysis."""
         all_content = []
         found_sitemaps = []
@@ -200,7 +199,7 @@ class WebsiteIndexer(WebScraperBaseTool):
         return combined_xml, found_sitemaps
 
     def _create_ai_extraction_prompt(
-        self, sitemap_xml: str, include_patterns: List[str], exclude_patterns: List[str]
+        self, sitemap_xml: str, include_patterns: list[str], exclude_patterns: list[str]
     ) -> str:
         """Create a prompt for AI to extract URLs from sitemap XML."""
         filter_instructions = ""
@@ -225,7 +224,7 @@ INSTRUCTIONS:
 
 Extract the URLs now:"""
 
-    def _parse_ai_response(self, ai_response: str) -> List[str]:
+    def _parse_ai_response(self, ai_response: str) -> list[str]:
         """Parse AI response to extract clean URLs."""
         urls = []
 
@@ -281,8 +280,8 @@ Extract the URLs now:"""
         max_urls: int = 50,
         chunk_size: int = DEFAULT_CHUNK_SIZE,
         chunk_overlap: int = DEFAULT_CHUNK_OVERLAP,
-        include_patterns: List[str] = None,
-        exclude_patterns: List[str] = None,
+        include_patterns: list[str] = None,
+        exclude_patterns: list[str] = None,
         **kwargs,
     ) -> str:
         """Discover website sitemaps, extract URLs with AI, and delegate to scrape_and_index."""

intentkit/skills/weth/__init__.py

@@ -1,9 +1,10 @@
 """WETH AgentKit skills."""
 
-from typing import TYPE_CHECKING, Optional, TypedDict
+from typing import TypedDict
 
 from coinbase_agentkit import weth_action_provider
 
+from intentkit.models.agent import Agent
 from intentkit.skills.base import (
     SkillConfig,
     SkillState,
@@ -12,9 +13,6 @@ from intentkit.skills.base import (
 )
 from intentkit.skills.weth.base import WethBaseTool
 
-if TYPE_CHECKING:
-    from intentkit.models.agent import Agent
-
 
 class SkillStates(TypedDict):
     WethActionProvider_wrap_eth: SkillState
@@ -27,10 +25,10 @@ class Config(SkillConfig):
 
 
 async def get_skills(
-    config: "Config",
+    config: Config,
     is_private: bool,
     agent_id: str,
-    agent: Optional["Agent"] = None,
+    agent: Agent | None = None,
     **_,
 ) -> list[WethBaseTool]:
     """Get all WETH skills."""

intentkit/skills/wow/__init__.py

@@ -1,9 +1,10 @@
 """WOW AgentKit skills."""
 
-from typing import TYPE_CHECKING, Optional, TypedDict
+from typing import TypedDict
 
 from coinbase_agentkit import wow_action_provider
 
+from intentkit.models.agent import Agent
 from intentkit.skills.base import (
     SkillConfig,
     SkillState,
@@ -12,9 +13,6 @@ from intentkit.skills.base import (
 )
 from intentkit.skills.wow.base import WowBaseTool
 
-if TYPE_CHECKING:
-    from intentkit.models.agent import Agent
-
 
 class SkillStates(TypedDict):
     WowActionProvider_buy_token: SkillState
@@ -29,10 +27,10 @@ class Config(SkillConfig):
 
 
 async def get_skills(
-    config: "Config",
+    config: Config,
     is_private: bool,
     agent_id: str,
-    agent: Optional["Agent"] = None,
+    agent: Agent | None = None,
     **_,
 ) -> list[WowBaseTool]:
     """Get all WOW skills."""

intentkit/skills/x402/__init__.py

@@ -6,6 +6,7 @@ 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__)
 
@@ -14,6 +15,7 @@ _cache: dict[str, X402BaseSkill] = {}
 
 class SkillStates(TypedDict):
     x402_ask_agent: SkillState
+    x402_http_request: SkillState
 
 
 class Config(SkillConfig):
@@ -22,6 +24,12 @@ class Config(SkillConfig):
     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,
@@ -44,10 +52,10 @@ async def get_skills(
 
 
 def _get_skill(name: str) -> X402BaseSkill | None:
-    if name == "x402_ask_agent":
+    builder = _SKILL_BUILDERS.get(name)
+    if builder:
         if name not in _cache:
-            _cache[name] = X402AskAgent()
+            _cache[name] = builder()
         return _cache[name]
-
     logger.warning("Unknown x402 skill requested: %s", name)
     return None

intentkit/skills/x402/ask_agent.py

@@ -1,15 +1,9 @@
 import logging
-import threading
-from typing import Any, Dict, Optional, Type
+from typing import Any
 
-from coinbase_agentkit.wallet_providers.evm_wallet_provider import (
-    EvmWalletSigner as CoinbaseEvmWalletSigner,
-)
 from langchain_core.tools import ToolException
 from pydantic import BaseModel, Field
-from x402.clients.httpx import x402HttpxClient
 
-from intentkit.clients import get_wallet_provider
 from intentkit.config.config import config
 from intentkit.models.chat import AuthorType
 from intentkit.skills.x402.base import X402BaseSkill
@@ -22,10 +16,10 @@ class AskAgentInput(BaseModel):
 
     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: Optional[bool] = Field(
+    search_mode: bool | None = Field(
         default=None, description="Enable search mode when interacting with the agent."
     )
-    super_mode: Optional[bool] = Field(
+    super_mode: bool | None = Field(
         default=None, description="Enable super mode when interacting with the agent."
     )
 
@@ -37,26 +31,22 @@ class X402AskAgent(X402BaseSkill):
     description: str = (
         "Call another agent through the x402 API and return the final agent message."
     )
-    args_schema: Type[BaseModel] = AskAgentInput
+    args_schema: type[BaseModel] = AskAgentInput
 
     async def _arun(
         self,
         agent_id: str,
         message: str,
-        search_mode: Optional[bool] = None,
-        super_mode: Optional[bool] = None,
+        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 ValueError("X402 API base URL is not configured.")
-
-            # Use wallet provider signer to satisfy eth_account.BaseAccount interface requirements
-            context = self.get_context()
-            wallet_provider = await get_wallet_provider(context.agent)
-            account = ThreadSafeEvmWalletSigner(wallet_provider)
-
-            payload: Dict[str, Any] = {
+                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",
@@ -66,12 +56,8 @@ class X402AskAgent(X402BaseSkill):
             if super_mode is not None:
                 payload["super_mode"] = super_mode
 
-            async with x402HttpxClient(
-                account=account,
-                base_url=base_url,
-                timeout=20.0,
-            ) as client:
-                response = await client.post("/x402", json=payload)
+            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:
@@ -110,55 +96,3 @@ class X402AskAgent(X402BaseSkill):
         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
-
-
-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 _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: Optional[Dict[str, Any]] = None,
-        message_types: Optional[Dict[str, Any]] = None,
-        message_data: Optional[Dict[str, Any]] = None,
-        full_message: Optional[Dict[str, Any]] = 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/base.py

@@ -1,5 +1,19 @@
+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."""
@@ -7,3 +21,79 @@ class X402BaseSkill(IntentKitOnChainSkill):
     @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

@@ -4,10 +4,7 @@
   "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"
-  ],
+  "x-tags": ["Communication", "Infrastructure"],
   "properties": {
     "enabled": {
       "type": "boolean",
@@ -21,11 +18,7 @@
         "x402_ask_agent": {
           "type": "string",
           "title": "Ask Agent",
-          "enum": [
-            "disabled",
-            "public",
-            "private"
-          ],
+          "enum": ["disabled", "public", "private"],
           "x-enum-title": [
             "Disabled",
             "Agent Owner + All Users",
@@ -33,8 +26,20 @@
           ],
           "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/base.py

@@ -1,4 +1,4 @@
-from typing import Dict, Literal
+from typing import Literal
 
 from intentkit.skills.onchain import IntentKitOnChainSkill
 
@@ -10,7 +10,7 @@ class XmtpBaseTool(IntentKitOnChainSkill):
     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(IntentKitOnChainSkill):
     }
 
     # 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,4 +1,4 @@
-from typing import Literal, Type
+from typing import Literal
 
 from langchain_core.tools.base import ToolException
 from pydantic import BaseModel, Field
@@ -24,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,

intentkit/skills/xmtp/swap.py

@@ -1,5 +1,3 @@
-from typing import List, Tuple, Type
-
 from pydantic import BaseModel, Field
 
 from intentkit.clients.cdp import get_cdp_client
@@ -42,7 +40,7 @@ class XmtpSwap(XmtpBaseTool):
         "Returns a wallet_sendCalls payload that can include an optional approval call and the swap call. "
         "Supports Ethereum, Base, Arbitrum, and Optimism mainnet networks."
     )
-    args_schema: Type[BaseModel] = SwapInput
+    args_schema: type[BaseModel] = SwapInput
 
     async def _arun(
         self,
@@ -51,7 +49,7 @@ class XmtpSwap(XmtpBaseTool):
         to_token: str,
         from_amount: str,
         slippage_bps: int = 100,
-    ) -> Tuple[str, List[ChatMessageAttachment]]:
+    ) -> tuple[str, list[ChatMessageAttachment]]:
         # Input validation
         if (
             not from_address