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

intentkit/skills/moralis/fetch_chain_portfolio.py

@@ -1,7 +1,6 @@
 """fetching wallet portfolio for a specific blockchain."""
 
 import logging
-from typing import List, Optional, Type
 
 from pydantic import BaseModel, Field
 
@@ -27,7 +26,7 @@ class ChainTokenBalance(BaseModel):
     contract_address: str = Field(..., description="Token contract address")
     symbol: str = Field(..., description="Token symbol")
     name: str = Field(..., description="Token name")
-    logo: Optional[str] = Field(None, description="Token logo URL")
+    logo: str | None = Field(None, description="Token logo URL")
     decimals: int = Field(..., description="Token decimals")
     balance: float = Field(..., description="Token balance")
     balance_raw: str = Field(..., description="Raw token balance")
@@ -38,12 +37,12 @@ class TokenApproval(BaseModel):
     """Model for token approval."""
 
     token_address: str = Field(..., description="Token contract address")
-    token_symbol: Optional[str] = Field(None, description="Token symbol")
-    token_name: Optional[str] = Field(None, description="Token name")
+    token_symbol: str | None = Field(None, description="Token symbol")
+    token_name: str | None = Field(None, description="Token name")
     spender: str = Field(..., description="Spender address (contract)")
-    spender_name: Optional[str] = Field(None, description="Spender name if known")
+    spender_name: str | None = Field(None, description="Spender name if known")
     allowance: str = Field(..., description="Raw approval amount")
-    allowance_formatted: Optional[float] = Field(
+    allowance_formatted: float | None = Field(
         None, description="Formatted approval amount"
     )
     unlimited: bool = Field(False, description="Whether the approval is unlimited")
@@ -55,17 +54,17 @@ class ChainPortfolioOutput(BaseModel):
     address: str = Field(..., description="Wallet address")
     chain_id: int = Field(..., description="Chain ID")
     chain_name: str = Field(..., description="Chain name")
-    native_token: Optional[ChainTokenBalance] = Field(
+    native_token: ChainTokenBalance | None = Field(
         None, description="Native token balance"
     )
-    tokens: List[ChainTokenBalance] = Field(
+    tokens: list[ChainTokenBalance] = Field(
         default_factory=list, description="List of token balances"
     )
     total_usd_value: float = Field(0.0, description="Total USD value on this chain")
-    approvals: Optional[List[TokenApproval]] = Field(
+    approvals: list[TokenApproval] | None = Field(
         None, description="Token approvals if requested"
     )
-    error: Optional[str] = Field(None, description="Error message if any")
+    error: str | None = Field(None, description="Error message if any")
 
 
 class FetchChainPortfolio(WalletBaseTool):
@@ -87,7 +86,7 @@ class FetchChainPortfolio(WalletBaseTool):
         "- Token approvals (optional)\n"
         "Use this tool whenever a user wants to see their holdings on a specific blockchain."
     )
-    args_schema: Type[BaseModel] = FetchChainPortfolioInput
+    args_schema: type[BaseModel] = FetchChainPortfolioInput
 
     async def _arun(
         self, address: str, chain_id: int, include_approvals: bool = False, **kwargs

intentkit/skills/moralis/fetch_nft_portfolio.py

@@ -2,7 +2,7 @@
 
 import json
 import logging
-from typing import Any, Dict, List, Optional, Type
+from typing import Any
 
 from pydantic import BaseModel, Field
 
@@ -16,7 +16,7 @@ class FetchNftPortfolioInput(BaseModel):
     """Input for FetchNftPortfolio tool."""
 
     address: str = Field(..., description="Wallet address")
-    chain_id: Optional[int] = Field(
+    chain_id: int | None = Field(
         None,
         description="Chain ID (if not specified, fetches from all supported chains)",
     )
@@ -26,7 +26,7 @@ class FetchNftPortfolioInput(BaseModel):
     solana_network: str = Field(
         default="mainnet", description="Solana network to use (mainnet or devnet)"
     )
-    limit: Optional[int] = Field(100, description="Maximum number of NFTs to return")
+    limit: int | None = Field(100, description="Maximum number of NFTs to return")
     normalize_metadata: bool = Field(
         True, description="Whether to normalize metadata across different standards"
     )
@@ -35,12 +35,12 @@ class FetchNftPortfolioInput(BaseModel):
 class NftMetadata(BaseModel):
     """Model for NFT metadata."""
 
-    name: Optional[str] = Field(None, description="NFT name")
-    description: Optional[str] = Field(None, description="NFT description")
-    image: Optional[str] = Field(None, description="NFT image URL")
-    animation_url: Optional[str] = Field(None, description="NFT animation URL")
-    attributes: Optional[List[Dict]] = Field(None, description="NFT attributes/traits")
-    external_url: Optional[str] = Field(None, description="External URL")
+    name: str | None = Field(None, description="NFT name")
+    description: str | None = Field(None, description="NFT description")
+    image: str | None = Field(None, description="NFT image URL")
+    animation_url: str | None = Field(None, description="NFT animation URL")
+    attributes: list[dict] | None = Field(None, description="NFT attributes/traits")
+    external_url: str | None = Field(None, description="External URL")
 
 
 class NftItem(BaseModel):
@@ -48,14 +48,14 @@ class NftItem(BaseModel):
 
     token_id: str = Field(..., description="NFT token ID")
     token_address: str = Field(..., description="NFT contract address")
-    contract_type: Optional[str] = Field(
+    contract_type: str | None = Field(
         None, description="NFT contract type (ERC721, ERC1155, etc.)"
     )
-    name: Optional[str] = Field(None, description="NFT name")
-    symbol: Optional[str] = Field(None, description="NFT symbol")
+    name: str | None = Field(None, description="NFT name")
+    symbol: str | None = Field(None, description="NFT symbol")
     owner_of: str = Field(..., description="Owner address")
-    metadata: Optional[NftMetadata] = Field(None, description="NFT metadata")
-    floor_price: Optional[float] = Field(None, description="Floor price if available")
+    metadata: NftMetadata | None = Field(None, description="NFT metadata")
+    floor_price: float | None = Field(None, description="Floor price if available")
     chain: str = Field("eth", description="Blockchain network")
 
 
@@ -63,13 +63,13 @@ class NftPortfolioOutput(BaseModel):
     """Output for FetchNftPortfolio tool."""
 
     address: str = Field(..., description="Wallet address")
-    nfts: List[NftItem] = Field(default_factory=list, description="List of NFT items")
+    nfts: list[NftItem] = Field(default_factory=list, description="List of NFT items")
     total_count: int = Field(0, description="Total count of NFTs")
-    chains: List[str] = Field(
+    chains: list[str] = Field(
         default_factory=list, description="Chains included in the response"
     )
-    cursor: Optional[str] = Field(None, description="Cursor for pagination")
-    error: Optional[str] = Field(None, description="Error message if any")
+    cursor: str | None = Field(None, description="Cursor for pagination")
+    error: str | None = Field(None, description="Error message if any")
 
 
 class FetchNftPortfolio(WalletBaseTool):
@@ -90,12 +90,12 @@ class FetchNftPortfolio(WalletBaseTool):
         "- Floor prices if available\n"
         "Use this tool whenever a user asks about their NFTs or digital collectibles."
     )
-    args_schema: Type[BaseModel] = FetchNftPortfolioInput
+    args_schema: type[BaseModel] = FetchNftPortfolioInput
 
     async def _arun(
         self,
         address: str,
-        chain_id: Optional[int] = None,
+        chain_id: int | None = None,
         include_solana: bool = False,
         solana_network: str = "mainnet",
         limit: int = 100,
@@ -156,7 +156,7 @@ class FetchNftPortfolio(WalletBaseTool):
         chain_id: int,
         limit: int,
         normalize_metadata: bool,
-        result: Dict[str, Any],
+        result: dict[str, Any],
     ) -> None:
         """Fetch NFTs from an EVM chain.
 
@@ -222,7 +222,7 @@ class FetchNftPortfolio(WalletBaseTool):
             result["nfts"].append(nft_item)
 
     async def _fetch_solana_nfts(
-        self, address: str, network: str, limit: int, result: Dict[str, Any]
+        self, address: str, network: str, limit: int, result: dict[str, Any]
     ) -> None:
         """Fetch NFTs from Solana.
 

intentkit/skills/moralis/fetch_solana_portfolio.py

@@ -1,7 +1,6 @@
 """fetching Solana wallet portfolio."""
 
 import logging
-from typing import Dict, List, Optional, Type
 
 from pydantic import BaseModel, Field
 
@@ -48,17 +47,17 @@ class SolanaTokenBalance(BaseModel):
     token_info: SolanaTokenInfo
     amount: float
     amount_raw: str
-    usd_value: Optional[float] = 0.0
+    usd_value: float | None = 0.0
 
 
 class SolanaNftInfo(BaseModel):
     """Model for Solana NFT information."""
 
     mint: str
-    name: Optional[str] = None
-    symbol: Optional[str] = None
+    name: str | None = None
+    symbol: str | None = None
     associated_token_address: str
-    metadata: Optional[Dict] = None
+    metadata: dict | None = None
 
 
 class SolanaPortfolioOutput(BaseModel):
@@ -67,12 +66,12 @@ class SolanaPortfolioOutput(BaseModel):
     address: str
     sol_balance: float
     sol_balance_lamports: int
-    sol_price_usd: Optional[float] = None
-    sol_value_usd: Optional[float] = None
-    tokens: List[SolanaTokenBalance] = []
-    nfts: List[SolanaNftInfo] = []
+    sol_price_usd: float | None = None
+    sol_value_usd: float | None = None
+    tokens: list[SolanaTokenBalance] = []
+    nfts: list[SolanaNftInfo] = []
     total_value_usd: float = 0.0
-    error: Optional[str] = None
+    error: str | None = None
 
 
 class FetchSolanaPortfolio(WalletBaseTool):
@@ -91,7 +90,7 @@ class FetchSolanaPortfolio(WalletBaseTool):
         "- USD values of assets\n"
         "Use this tool whenever the user asks specifically about Solana holdings."
     )
-    args_schema: Type[BaseModel] = SolanaPortfolioInput
+    args_schema: type[BaseModel] = SolanaPortfolioInput
 
     async def _arun(
         self,
@@ -136,7 +135,7 @@ class FetchSolanaPortfolio(WalletBaseTool):
         self,
         address: str,
         network: str,
-        sol_portfolio: Dict,
+        sol_portfolio: dict,
         include_nfts: bool,
         include_price_data: bool,
     ) -> SolanaPortfolioOutput:

intentkit/skills/moralis/fetch_wallet_portfolio.py

@@ -1,7 +1,6 @@
 """fetching a complete wallet portfolio (EVM + Solana)."""
 
 import logging
-from typing import Dict, List, Optional, Type
 
 from pydantic import BaseModel, Field
 
@@ -24,7 +23,7 @@ class FetchWalletPortfolioInput(BaseModel):
     address: str = Field(
         ..., description="Wallet address to analyze (Ethereum or Solana)"
     )
-    chains: Optional[List[int]] = Field(
+    chains: list[int] | None = Field(
         default=None,
         description="List of EVM chain IDs to check (default: all supported)",
     )
@@ -51,9 +50,9 @@ class PortfolioOutput(BaseModel):
 
     address: str
     total_net_worth: float
-    chains: Dict[str, float]
-    tokens: List[TokenBalance]
-    error: Optional[str] = None
+    chains: dict[str, float]
+    tokens: list[TokenBalance]
+    error: str | None = None
 
 
 class FetchWalletPortfolio(WalletBaseTool):
@@ -73,12 +72,12 @@ class FetchWalletPortfolio(WalletBaseTool):
         "Use this tool whenever the user asks about their crypto holdings, portfolio value, "
         "or wallet contents across multiple blockchains."
     )
-    args_schema: Type[BaseModel] = FetchWalletPortfolioInput
+    args_schema: type[BaseModel] = FetchWalletPortfolioInput
 
     async def _arun(
         self,
         address: str,
-        chains: Optional[List[int]] = None,
+        chains: list[int] | None = None,
         include_solana: bool = True,
         solana_network: str = "mainnet",
         **kwargs,
@@ -119,7 +118,7 @@ class FetchWalletPortfolio(WalletBaseTool):
             )
 
     async def _fetch_evm_portfolio(
-        self, address: str, chains: Optional[List[int]], portfolio: Dict
+        self, address: str, chains: list[int] | None, portfolio: dict
     ) -> None:
         """Fetch portfolio data for EVM chains.
 
@@ -165,7 +164,7 @@ class FetchWalletPortfolio(WalletBaseTool):
             )
 
     async def _fetch_solana_portfolio(
-        self, address: str, network: str, portfolio: Dict
+        self, address: str, network: str, portfolio: dict
     ) -> None:
         """Fetch portfolio data for Solana.
 

intentkit/skills/moralis/schema.json

@@ -152,5 +152,10 @@
       ]
     }
   },
-  "additionalProperties": true
-}
+  "additionalProperties": true,
+  "x-tags": [
+    "Analytics",
+    "Crypto",
+    "DeFi"
+  ]
+}

intentkit/skills/morpho/__init__.py

@@ -0,0 +1,52 @@
+"""Morpho AgentKit skills."""
+
+from typing import TypedDict
+
+from coinbase_agentkit import morpho_action_provider
+
+from intentkit.models.agent import Agent
+from intentkit.skills.base import (
+    SkillConfig,
+    SkillState,
+    action_to_structured_tool,
+    get_agentkit_actions,
+)
+from intentkit.skills.morpho.base import MorphoBaseTool
+
+
+class SkillStates(TypedDict):
+    MorphoActionProvider_deposit: SkillState
+    MorphoActionProvider_withdraw: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration for Morpho skills."""
+
+    states: SkillStates
+
+
+async def get_skills(
+    config: Config,
+    is_private: bool,
+    agent_id: str,
+    agent: Agent | None = None,
+    **_,
+) -> list[MorphoBaseTool]:
+    """Get all Morpho skills."""
+
+    available_skills: list[str] = []
+    for skill_name, state in config["states"].items():
+        if state == "disabled":
+            continue
+        if state == "public" or (state == "private" and is_private):
+            available_skills.append(skill_name)
+
+    actions = await get_agentkit_actions(
+        agent_id, [morpho_action_provider], agent=agent
+    )
+    tools: list[MorphoBaseTool] = []
+    for skill in available_skills:
+        for action in actions:
+            if action.name.endswith(skill):
+                tools.append(action_to_structured_tool(action))
+    return tools

intentkit/skills/morpho/base.py

@@ -0,0 +1,11 @@
+"""Morpho AgentKit skills base class."""
+
+from intentkit.skills.cdp.base import CDPBaseTool
+
+
+class MorphoBaseTool(CDPBaseTool):
+    """Base class for Morpho tools."""
+
+    @property
+    def category(self) -> str:
+        return "morpho"

intentkit/skills/morpho/morpho.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <defs>
+    <radialGradient id="morpho" cx="50%" cy="50%" r="70%">
+      <stop offset="0%" stop-color="#82f3ff" />
+      <stop offset="100%" stop-color="#006064" />
+    </radialGradient>
+  </defs>
+  <rect width="128" height="128" fill="#004d40" rx="16" />
+  <circle cx="64" cy="48" r="28" fill="url(#morpho)" />
+  <rect x="36" y="72" width="56" height="20" rx="10" fill="#26a69a" />
+  <text x="50%" y="84%" font-family="Arial,Helvetica,sans-serif" font-size="18" fill="#e0f2f1" font-weight="600" text-anchor="middle">Morpho</text>
+</svg>

intentkit/skills/morpho/schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Morpho",
+  "description": "Morpho lending actions via Coinbase AgentKit",
+  "x-icon": "https://ai.service.crestal.dev/skills/morpho/morpho.svg",
+  "x-tags": [
+    "DeFi"
+  ],
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "title": "Enabled",
+      "description": "Whether this skill is enabled",
+      "default": false
+    },
+    "states": {
+      "type": "object",
+      "properties": {
+        "MorphoActionProvider_deposit": {
+          "type": "string",
+          "title": "Deposit",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "State for MorphoActionProvider_deposit",
+          "default": "disabled"
+        },
+        "MorphoActionProvider_withdraw": {
+          "type": "string",
+          "title": "Withdraw",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "State for MorphoActionProvider_withdraw",
+          "default": "disabled"
+        }
+      },
+      "description": "States for each Morpho 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/nation/__init__.py

@@ -1,7 +1,6 @@
 import logging
-from typing import Optional, TypedDict
+from typing import TypedDict
 
-from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.base import SkillConfig, SkillState
 from intentkit.skills.nation.base import NationBaseTool
 from intentkit.skills.nation.nft_check import NftCheck
@@ -25,7 +24,6 @@ class Config(SkillConfig):
 async def get_skills(
     config: "Config",
     is_private: bool,
-    store: SkillStoreABC,
     **_,
 ) -> list[NationBaseTool]:
     """Get all nation skills."""
@@ -42,20 +40,17 @@ async def get_skills(
     return [
         skill
         for name in available_skills
-        if (skill := get_nation_skill(name, store)) is not None
+        if (skill := get_nation_skill(name)) is not None
     ]
 
 
 def get_nation_skill(
     name: str,
-    store: SkillStoreABC,
-) -> Optional[NationBaseTool]:
+) -> NationBaseTool | None:
     """Get a nation skill by name."""
     if name == "nft_check":
         if name not in _cache:
-            _cache[name] = NftCheck(
-                skill_store=store,
-            )
+            _cache[name] = NftCheck()
         return _cache[name]
     else:
         logger.error(f"Unknown Nation skill: {name}")

intentkit/skills/nation/base.py

@@ -1,8 +1,6 @@
-from typing import Type
-
 from pydantic import BaseModel, Field
 
-from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.config.config import config
 from intentkit.skills.base import IntentKitSkill
 
 default_nation_api_url = "http://backend-api"
@@ -13,17 +11,14 @@ class NationBaseTool(IntentKitSkill):
 
     name: str = Field(description="The name of the tool")
     description: str = Field(description="A description of what the tool does")
-    args_schema: Type[BaseModel]
-    skill_store: SkillStoreABC = Field(
-        description="The skill store for persisting data"
-    )
+    args_schema: type[BaseModel]
 
     def get_api_key(self) -> str:
-        return self.skill_store.get_system_config("nation_api_key")
+        return config.nation_api_key
 
     def get_base_url(self) -> str:
-        if self.skill_store.get_system_config("nation_api_url"):
-            return self.skill_store.get_system_config("nation_api_url")
+        if config.nation_api_url:
+            return config.nation_api_url
         return default_nation_api_url
 
     @property

intentkit/skills/nation/nft_check.py

@@ -1,5 +1,4 @@
 import logging
-from typing import Optional, Type
 
 import httpx
 from eth_utils import is_address
@@ -11,7 +10,7 @@ logger = logging.getLogger(__name__)
 
 
 class NftCheckInput(BaseModel):
-    nation_wallet_address: Optional[str] = Field(
+    nation_wallet_address: str | None = Field(
         default=None, description="Nation wallet address"
     )
 
@@ -19,9 +18,9 @@ class NftCheckInput(BaseModel):
 class NftCheck(NationBaseTool):
     name: str = "nft_check"
     description: str = "Check user nation pass NFTs stats in nation, including usage status and linked agents.By default, it will use the user_id as the wallet address. If you want to check other wallet address, please pass the nation_wallet_address parameter."
-    args_schema: Type[BaseModel] = NftCheckInput
+    args_schema: type[BaseModel] = NftCheckInput
 
-    async def _arun(self, nation_wallet_address: Optional[str] = None) -> str:
+    async def _arun(self, nation_wallet_address: str | None = None) -> str:
         """Implementation of the NFT Check tool.
 
         Args:

intentkit/skills/nation/schema.json

@@ -5,8 +5,9 @@
   "description": "Check nation NFT stats",
   "x-icon": "https://ai.service.crestal.dev/skills/nation/nation.png",
   "x-tags": [
-    "Nation",
-    "NFTChecker"
+    "Analytics",
+    "Crypto",
+    "NFT"
   ],
   "properties": {
     "enabled": {
@@ -55,4 +56,4 @@
     "enabled"
   ],
   "additionalProperties": true
-}
+}

intentkit/skills/onchain.py

@@ -0,0 +1,23 @@
+from cdp import EvmServerAccount
+from web3 import Web3
+
+from intentkit.clients import get_evm_account as fetch_evm_account
+from intentkit.clients.web3 import get_web3_client
+from intentkit.skills.base import IntentKitSkill
+
+
+class IntentKitOnChainSkill(IntentKitSkill):
+    """Shared helpers for on-chain enabled skills."""
+
+    def web3_client(self) -> Web3:
+        """Get a Web3 client for the active agent network."""
+        context = self.get_context()
+        agent = context.agent
+        network_id = agent.network_id
+        return get_web3_client(network_id)
+
+    async def get_evm_account(self) -> EvmServerAccount:
+        """Fetch the EVM account associated with the active agent."""
+        context = self.get_context()
+        agent = context.agent
+        return await fetch_evm_account(agent)