intentkit 0.8.34__tar.gz → 0.8.34.dev3__tar.gz

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/PKG-INFO

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

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

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/config/config.py

@@ -7,6 +7,7 @@ from dotenv import load_dotenv
 
 from intentkit.utils.chain import ChainProvider, QuicknodeChainProvider
 from intentkit.utils.logging import setup_logging
+from intentkit.utils.s3 import init_s3
 from intentkit.utils.slack_alert import init_slack
 
 SecretsMap = dict[str, str | int]
@@ -70,16 +71,9 @@ class Config:
         self.redis_host: str | None = self.load("REDIS_HOST")
         self.redis_port: int = self.load_int("REDIS_PORT", 6379)
         self.redis_db: int = self.load_int("REDIS_DB", 0)
-        # AWS S3
+        # AWS
         self.aws_s3_bucket: str | None = self.load("AWS_S3_BUCKET")
         self.aws_s3_cdn_url: str | None = self.load("AWS_S3_CDN_URL")
-        # If using custom S3 endpoint
-        self.aws_s3_endpoint_url: str | None = self.load("AWS_S3_ENDPOINT_URL")
-        self.aws_s3_region_name: str | None = self.load("AWS_S3_REGION_NAME")
-        self.aws_s3_access_key_id: str | None = self.load("AWS_S3_ACCESS_KEY_ID")
-        self.aws_s3_secret_access_key: str | None = self.load(
-            "AWS_S3_SECRET_ACCESS_KEY"
-        )
         # Internal API
         self.internal_base_url: str = self.load(
             "INTERNAL_BASE_URL", "http://intent-api"
@@ -95,6 +89,7 @@ class Config:
         self.debug_password: str | None = self.load("DEBUG_PASSWORD")
         # Payment
         self.payment_enabled: bool = self.load("PAYMENT_ENABLED", "false") == "true"
+        self.x402_fee_address: str | None = self.load("X402_FEE_ADDRESS")
         # Open API for agent
         self.open_api_base_url: str = self.load(
             "OPEN_API_BASE_URL", "http://localhost:8000"
@@ -188,6 +183,9 @@ class Config:
         # If the slack alert token exists, init it
         if self.slack_alert_token and self.slack_alert_channel:
             init_slack(self.slack_alert_token, self.slack_alert_channel)
+        # If the AWS S3 bucket and CDN URL exist, init it
+        if self.aws_s3_bucket and self.aws_s3_cdn_url:
+            init_s3(self.aws_s3_bucket, self.aws_s3_cdn_url, self.env)
 
     @overload
     def load(self, key: str) -> str | None: ...  # noqa: F811

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/core/chat.py

@@ -6,7 +6,9 @@ including clearing thread history using LangGraph's checkpointer.
 
 import logging
 
-from intentkit.models.db import get_checkpointer
+from langgraph.checkpoint.postgres.shallow import AsyncShallowPostgresSaver
+
+from intentkit.models.db import get_connection_pool
 from intentkit.utils.error import IntentKitAPIError
 
 logger = logging.getLogger(__name__)
@@ -34,7 +36,8 @@ async def clear_thread_memory(agent_id: str, chat_id: str) -> bool:
         thread_id = f"{agent_id}-{chat_id}"
 
         # Get the LangGraph checkpointer instance
-        checkpointer = get_checkpointer()
+        pool = get_connection_pool()
+        checkpointer = AsyncShallowPostgresSaver(pool)
 
         # Use the official LangGraph method to delete all thread content
         await checkpointer.adelete_thread(thread_id)

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/core/engine.py

@@ -27,6 +27,7 @@ from langchain_core.messages import (
 )
 from langchain_core.tools import BaseTool
 from langgraph.checkpoint.memory import InMemorySaver
+from langgraph.checkpoint.postgres.shallow import AsyncShallowPostgresSaver
 from langgraph.errors import GraphRecursionError
 from langgraph.graph.state import CompiledStateGraph
 from sqlalchemy import func, update
@@ -54,10 +55,7 @@ from intentkit.models.chat import (
     ChatMessageSkillCall,
 )
 from intentkit.models.credit import CreditAccount, OwnerType
-from intentkit.models.db import (
-    get_checkpointer,
-    get_session,
-)
+from intentkit.models.db import get_connection_pool, get_session
 from intentkit.models.llm import LLMModelInfo, create_llm_model
 from intentkit.models.skill import AgentSkillData, ChatSkillData, Skill
 from intentkit.models.user import User
@@ -126,9 +124,10 @@ async def build_agent(
 
     # ==== Store buffered conversation history in memory.
     try:
-        checkpointer = get_checkpointer()
+        pool = get_connection_pool()
+        memory = AsyncShallowPostgresSaver(pool)
     except RuntimeError:
-        checkpointer = InMemorySaver()
+        memory = InMemorySaver()
 
     # ==== Load skills
     tools: list[BaseTool | dict] = []
@@ -199,7 +198,7 @@ async def build_agent(
         middleware=middleware,
         state_schema=AgentState,
         context_schema=AgentContext,
-        checkpointer=checkpointer,
+        checkpointer=memory,
         debug=config.debug_checkpoint,
         name=agent.id,
     )
@@ -374,7 +373,6 @@ async def stream_agent_raw(
         payer = user_message.user_id
         if user_message.author_type in [
             AuthorType.TELEGRAM,
-            AuthorType.DISCORD,
             AuthorType.TWITTER,
             AuthorType.API,
             AuthorType.X402,

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/core/scheduler.py

@@ -13,7 +13,6 @@ from intentkit.core.agent import (
     update_agents_account_snapshot,
     update_agents_statistics,
 )
-from intentkit.core.cleanup import cleanup_checkpoints
 from intentkit.core.credit import refill_all_free_credits
 from intentkit.models.agent_data import AgentQuota
 
@@ -141,16 +140,4 @@ def create_scheduler(
         replace_existing=True,
     )
 
-    # Cleanup old checkpoints daily at UTC 2:20
-    # Cleanup old checkpoints daily at UTC 2:20
-
-    scheduler.add_job(
-        cleanup_checkpoints,
-        trigger=CronTrigger(hour=2, minute=20, timezone="UTC"),
-        id="cleanup_checkpoints",
-        name="Cleanup old checkpoints",
-        kwargs={"days": 90, "dry_run": False},
-        replace_existing=True,
-    )
-
     return scheduler

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/models/db.py

@@ -13,7 +13,6 @@ from intentkit.models.db_mig import safe_migrate
 
 engine: AsyncEngine | None = None
 _connection_pool: AsyncConnectionPool | None = None
-_checkpointer: AsyncShallowPostgresSaver | None = None
 
 
 async def check_connection(conn):
@@ -52,7 +51,7 @@ async def init_db(
         auto_migrate: Whether to run migrations automatically (default: True)
         pool_size: Database connection pool size (default: 3)
     """
-    global engine, _connection_pool, _checkpointer
+    global engine, _connection_pool
     # Initialize psycopg pool and AsyncShallowPostgresSaver if not already initialized
     if _connection_pool is None:
         if host:
@@ -71,7 +70,6 @@ async def init_db(
                 max_lifetime=3600,  # 1 hour
             )
             _connection_pool = pool
-            _checkpointer = AsyncShallowPostgresSaver(pool)
             if auto_migrate:
                 # Migrate can not use pool, so we start from scratch
                 async with AsyncShallowPostgresSaver.from_conn_string(
@@ -152,14 +150,3 @@ def get_connection_pool() -> AsyncConnectionPool:
     if _connection_pool is None:
         raise RuntimeError("Database pool not initialized. Call init_db first.")
     return _connection_pool
-
-
-def get_checkpointer() -> AsyncShallowPostgresSaver:
-    """Get the AsyncShallowPostgresSaver instance.
-
-    Returns:
-        AsyncShallowPostgresSaver: The AsyncShallowPostgresSaver instance
-    """
-    if _checkpointer is None:
-        raise RuntimeError("Database checkpointer not initialized. Call init_db first.")
-    return _checkpointer

intentkit-0.8.34.dev3/intentkit/models/db_mig.py

@@ -0,0 +1,103 @@
+"""Database migration utilities."""
+
+import logging
+from collections.abc import Callable
+
+from sqlalchemy import Column, MetaData, inspect, text
+
+from intentkit.models.base import Base
+
+logger = logging.getLogger(__name__)
+
+
+async def add_column_if_not_exists(
+    conn, dialect, table_name: str, column: Column
+) -> None:
+    """Add a column to a table if it doesn't exist.
+
+    Args:
+        conn: SQLAlchemy conn
+        table_name: Name of the table
+        column: Column to add
+    """
+
+    # Use run_sync to perform inspection on the connection
+    def _get_columns(connection):
+        inspector = inspect(connection)
+        return [c["name"] for c in inspector.get_columns(table_name)]
+
+    columns = await conn.run_sync(_get_columns)
+
+    if column.name not in columns:
+        # Build column definition
+        column_def = f"{column.name} {column.type.compile(dialect)}"
+
+        # Add DEFAULT if specified
+        if column.default is not None:
+            if hasattr(column.default, "arg"):
+                default_value = column.default.arg
+                if not isinstance(default_value, Callable):
+                    if isinstance(default_value, bool):
+                        default_value = str(default_value).lower()
+                    elif isinstance(default_value, str):
+                        default_value = f"'{default_value}'"
+                    elif isinstance(default_value, list | dict):
+                        default_value = "'{}'"
+                    column_def += f" DEFAULT {default_value}"
+
+        # Execute ALTER TABLE
+        await conn.execute(text(f"ALTER TABLE {table_name} ADD COLUMN {column_def}"))
+        logger.info(f"Added column {column.name} to table {table_name}")
+
+
+async def update_table_schema(conn, dialect, model_cls) -> None:
+    """Update table schema by adding missing columns from the model.
+
+    Args:
+        conn: SQLAlchemy conn
+        dialect: SQLAlchemy dialect
+        model_cls: SQLAlchemy model class to check for new columns
+    """
+    if not hasattr(model_cls, "__table__"):
+        return
+
+    table_name = model_cls.__tablename__
+    for name, column in model_cls.__table__.columns.items():
+        if name != "id":  # Skip primary key
+            await add_column_if_not_exists(conn, dialect, table_name, column)
+
+
+async def safe_migrate(engine) -> None:
+    """Safely migrate all SQLAlchemy models by adding new columns.
+
+    Args:
+        engine: SQLAlchemy engine
+    """
+    logger.info("Starting database schema migration")
+    dialect = engine.dialect
+
+    async with engine.begin() as conn:
+        try:
+            # Create tables if they don't exist
+            await conn.run_sync(Base.metadata.create_all)
+
+            # Get existing table metadata
+            metadata = MetaData()
+            await conn.run_sync(metadata.reflect)
+
+            # Update schema for all model classes
+            for mapper in Base.registry.mappers:
+                model_cls = mapper.class_
+                if hasattr(model_cls, "__tablename__"):
+                    table_name = model_cls.__tablename__
+                    if table_name in metadata.tables:
+                        # We need a sync wrapper for the async update_table_schema
+                        async def update_table_wrapper():
+                            await update_table_schema(conn, dialect, model_cls)
+
+                        await update_table_wrapper()
+        except Exception as e:
+            logger.error(f"Error updating database schema: {str(e)}")
+            raise
+
+    logger.info("Database schema updated successfully")

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/models/skills.csv

@@ -167,6 +167,7 @@ firecrawl,firecrawl_clear_indexed_content,firecrawl_clear_indexed_content,TRUE,1
 xmtp,xmtp_transfer,xmtp_transfer,TRUE,1,5,5,,,0x445750026A4a1906b61302442E085f9cbAfe206a
 xmtp,xmtp_swap,xmtp_swap,TRUE,1,5,5,,,0x445750026A4a1906b61302442E085f9cbAfe206a
 xmtp,xmtp_get_swap_price,xmtp_get_swap_price,TRUE,1,5,5,,,0x445750026A4a1906b61302442E085f9cbAfe206a
+x402,x402_ask_agent,x402_ask_agent,TRUE,1,1,1,,,0x445750026A4a1906b61302442E085f9cbAfe206a
 x402,x402_http_request,x402_http_request,TRUE,1,1,1,,,0x445750026A4a1906b61302442E085f9cbAfe206a
 casino,deck_shuffle,casino_deck_shuffle,true,1,5,5,,,0x3cdd051eec909f94965f9c1c657f5b70a172b2c0
 casino,deck_draw,casino_deck_draw,true,1,5,5,,,0x3cdd051eec909f94965f9c1c657f5b70a172b2c0

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/heurist/image_generation_animagine_xl.py

@@ -4,9 +4,9 @@ import httpx
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.config.config import config
 from intentkit.skills.heurist.base import HeuristBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 
@@ -77,6 +77,7 @@ class ImageGenerationAnimagineXL(HeuristBaseTool):
         """
         context = self.get_context()
         skill_config = context.agent.skill_config(self.category)
+        skill_config = skill_config
 
         # Get the Heurist API key from configuration
         if "api_key" in skill_config and skill_config["api_key"]:

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/heurist/image_generation_arthemy_comics.py

@@ -4,9 +4,9 @@ import httpx
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.config.config import config
 from intentkit.skills.heurist.base import HeuristBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 
@@ -76,6 +76,7 @@ class ImageGenerationArthemyComics(HeuristBaseTool):
         """
         context = self.get_context()
         skill_config = context.agent.skill_config(self.category)
+        skill_config = skill_config
 
         # Get the Heurist API key from configuration
         if "api_key" in skill_config and skill_config["api_key"]:

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/heurist/image_generation_arthemy_real.py

@@ -4,9 +4,9 @@ import httpx
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.config.config import config
 from intentkit.skills.heurist.base import HeuristBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 
@@ -76,6 +76,7 @@ class ImageGenerationArthemyReal(HeuristBaseTool):
         """
         context = self.get_context()
         skill_config = context.agent.skill_config(self.category)
+        skill_config = skill_config
 
         # Get the Heurist API key from configuration
         if "api_key" in skill_config and skill_config["api_key"]:

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/heurist/image_generation_braindance.py

@@ -4,9 +4,9 @@ import httpx
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.config.config import config
 from intentkit.skills.heurist.base import HeuristBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 
@@ -76,6 +76,7 @@ class ImageGenerationBrainDance(HeuristBaseTool):
         """
         context = self.get_context()
         skill_config = context.agent.skill_config(self.category)
+        skill_config = skill_config
 
         # Get the Heurist API key from configuration
         if "api_key" in skill_config and skill_config["api_key"]:

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/heurist/image_generation_cyber_realistic_xl.py

@@ -4,9 +4,9 @@ import httpx
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.config.config import config
 from intentkit.skills.heurist.base import HeuristBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 
@@ -76,6 +76,7 @@ class ImageGenerationCyberRealisticXL(HeuristBaseTool):
         """
         context = self.get_context()
         skill_config = context.agent.skill_config(self.category)
+        skill_config = skill_config
 
         # Get the Heurist API key from configuration
         if "api_key" in skill_config and skill_config["api_key"]:

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/heurist/image_generation_flux_1_dev.py

@@ -4,9 +4,9 @@ import httpx
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.config.config import config
 from intentkit.skills.heurist.base import HeuristBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 
@@ -76,6 +76,7 @@ class ImageGenerationFlux1Dev(HeuristBaseTool):
         """
         context = self.get_context()
         skill_config = context.agent.skill_config(self.category)
+        skill_config = skill_config
 
         # Get the Heurist API key from configuration
         if "api_key" in skill_config and skill_config["api_key"]:

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/heurist/image_generation_sdxl.py

@@ -4,9 +4,9 @@ import httpx
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.config.config import config
 from intentkit.skills.heurist.base import HeuristBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 
@@ -76,6 +76,7 @@ class ImageGenerationSDXL(HeuristBaseTool):
         """
         context = self.get_context()
         skill_config = context.agent.skill_config(self.category)
+        skill_config = skill_config
 
         # Get the Heurist API key from configuration
         if "api_key" in skill_config and skill_config["api_key"]:

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/openai/dalle_image_generation.py

@@ -6,8 +6,8 @@ import openai
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image
 from intentkit.skills.openai.base import OpenAIBaseTool
+from intentkit.utils.s3 import store_image
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/openai/gpt_avatar_generator.py

@@ -7,8 +7,8 @@ import openai
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image_bytes
 from intentkit.skills.openai.base import OpenAIBaseTool
+from intentkit.utils.s3 import store_image_bytes
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/openai/gpt_image_generation.py

@@ -8,8 +8,8 @@ import openai
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image_bytes
 from intentkit.skills.openai.base import OpenAIBaseTool
+from intentkit.utils.s3 import store_image_bytes
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/openai/gpt_image_mini_generator.py

@@ -8,9 +8,9 @@ import openai
 from epyxid import XID
 from pydantic import BaseModel
 
-from intentkit.clients.s3 import store_image_bytes
 from intentkit.skills.openai.base import OpenAIBaseTool
 from intentkit.skills.openai.gpt_image_generation import GPTImageGenerationInput
+from intentkit.utils.s3 import store_image_bytes
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/openai/gpt_image_to_image.py

@@ -10,8 +10,8 @@ import openai
 from epyxid import XID
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image_bytes
 from intentkit.skills.openai.base import OpenAIBaseTool
+from intentkit.utils.s3 import store_image_bytes
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/venice_audio/venice_audio.py

@@ -6,9 +6,9 @@ from typing import Any
 import httpx
 from pydantic import BaseModel
 
-from intentkit.clients.s3 import store_file
 from intentkit.skills.venice_audio.base import VeniceAudioBaseTool
 from intentkit.skills.venice_audio.input import AllowedAudioFormat, VeniceAudioInput
+from intentkit.utils.s3 import store_file
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/venice_image/api.py

@@ -12,7 +12,7 @@ from typing import Any
 
 import httpx
 
-from intentkit.clients.s3 import store_image_bytes
+from intentkit.utils.s3 import store_image_bytes
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/venice_image/image_generation/image_generation_base.py

@@ -5,14 +5,13 @@ from typing import Any, Literal
 
 from pydantic import BaseModel, Field
 
-from intentkit.clients.s3 import store_image_bytes
-
 # Import the generic base
 from intentkit.skills.base import ToolException
 from intentkit.skills.venice_image.base import VeniceImageBaseTool
 from intentkit.skills.venice_image.image_generation.image_generation_input import (
     VeniceImageGenerationInput,
 )
+from intentkit.utils.s3 import store_image_bytes
 
 logger = logging.getLogger(__name__)
 

{intentkit-0.8.34 → intentkit-0.8.34.dev3}/intentkit/skills/x402/__init__.py

@@ -4,6 +4,7 @@ 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
 
@@ -13,6 +14,7 @@ _cache: dict[str, X402BaseSkill] = {}
 
 
 class SkillStates(TypedDict):
+    x402_ask_agent: SkillState
     x402_http_request: SkillState
 
 
@@ -23,6 +25,7 @@ class Config(SkillConfig):
 
 
 _SKILL_BUILDERS: dict[str, type[X402BaseSkill]] = {
+    "x402_ask_agent": X402AskAgent,
     "x402_http_request": X402HttpRequest,
 }
 

intentkit-0.8.34.dev3/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