intentkit 0.17.6__tar.gz → 0.17.8__tar.gz

{intentkit-0.17.6 → intentkit-0.17.8}/.gitignore

@@ -171,6 +171,7 @@ cython_debug/
 .cursor
 .zed
 CLAUDE.local.md
+.obsidian
 
 # web3
 wallet_data.txt

{intentkit-0.17.6 → intentkit-0.17.8}/PKG-INFO

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

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

intentkit-0.17.8/intentkit/clients/moralis.py

@@ -0,0 +1,57 @@
+"""Moralis API client for wallet valuation."""
+
+import logging
+
+import httpx
+
+from intentkit.config.config import config
+from intentkit.skills.portfolio.constants import MORALIS_API_BASE_URL
+
+logger = logging.getLogger(__name__)
+
+# Chains to check for wallet net worth
+_VALUATION_CHAINS = ["eth", "base", "arbitrum", "bsc"]
+
+_http_client: httpx.AsyncClient | None = None
+
+
+def _get_http_client() -> httpx.AsyncClient:
+    global _http_client
+    if _http_client is None:
+        _http_client = httpx.AsyncClient(timeout=15)
+    return _http_client
+
+
+async def get_wallet_net_worth(address: str) -> float:
+    """Get total USD net worth for a wallet address via Moralis API.
+
+    Checks Ethereum, Base, Arbitrum, and BNB chains.
+
+    Args:
+        address: The wallet address to check.
+
+    Returns:
+        Total net worth in USD, or 0.0 on any error.
+    """
+    api_key = config.moralis_api_key
+    if not api_key:
+        logger.warning("Moralis API key not configured, returning 0.0")
+        return 0.0
+
+    url = f"{MORALIS_API_BASE_URL}/wallets/{address}/net-worth"
+    headers = {"accept": "application/json", "X-API-Key": api_key}
+    params = {
+        "exclude_spam": "true",
+        "exclude_unverified_contracts": "true",
+        "chains": _VALUATION_CHAINS,
+    }
+
+    try:
+        client = _get_http_client()
+        resp = await client.get(url, headers=headers, params=params)
+        resp.raise_for_status()
+        data = resp.json()
+        return float(data.get("total_networth_usd", 0.0))
+    except Exception as e:
+        logger.warning("Failed to get wallet net worth for %s: %s", address, e)
+        return 0.0

intentkit-0.17.8/intentkit/clients/supabase.py

@@ -0,0 +1,121 @@
+"""Supabase Admin API client for identity management."""
+
+import logging
+from typing import Any
+
+import httpx
+
+from intentkit.config.config import config
+
+logger = logging.getLogger(__name__)
+
+_http_client: httpx.AsyncClient | None = None
+
+
+def _get_http_client() -> httpx.AsyncClient:
+    global _http_client
+    if _http_client is None:
+        _http_client = httpx.AsyncClient(timeout=10)
+    return _http_client
+
+
+def _get_headers() -> dict[str, str]:
+    """Build auth headers for Supabase Admin API."""
+    key = config.supabase_service_role_key or ""
+    return {
+        "apikey": key,
+        "Authorization": f"Bearer {key}",
+    }
+
+
+async def get_user_identities(user_id: str) -> list[dict[str, Any]]:
+    """Fetch user identities from Supabase Admin API.
+
+    Args:
+        user_id: The Supabase user UUID.
+
+    Returns:
+        List of identity dicts, or empty list on error.
+    """
+    supabase_url = config.supabase_url
+    service_role_key = config.supabase_service_role_key
+    if not supabase_url or not service_role_key:
+        logger.warning("Supabase not configured, cannot fetch identities")
+        return []
+
+    url = f"{supabase_url}/auth/v1/admin/users/{user_id}"
+    try:
+        client = _get_http_client()
+        resp = await client.get(url, headers=_get_headers())
+        resp.raise_for_status()
+        data = resp.json()
+        return data.get("identities") or []
+    except Exception as e:
+        logger.error("Failed to fetch identities for user %s: %s", user_id, e)
+        return []
+
+
+async def unlink_identity(user_id: str, identity_id: str) -> bool:
+    """Unlink an identity from a Supabase user.
+
+    Args:
+        user_id: The Supabase user UUID.
+        identity_id: The identity UUID to unlink.
+
+    Returns:
+        True on success, False on failure.
+    """
+    supabase_url = config.supabase_url
+    service_role_key = config.supabase_service_role_key
+    if not supabase_url or not service_role_key:
+        logger.warning("Supabase not configured, cannot unlink identity")
+        return False
+
+    url = f"{supabase_url}/auth/v1/admin/users/{user_id}/identities/{identity_id}"
+    try:
+        client = _get_http_client()
+        resp = await client.delete(url, headers=_get_headers())
+        resp.raise_for_status()
+        return True
+    except Exception as e:
+        logger.error(
+            "Failed to unlink identity %s for user %s: %s",
+            identity_id,
+            user_id,
+            e,
+        )
+        return False
+
+
+def parse_linked_providers(
+    identities: list[dict[str, Any]],
+) -> dict[str, dict[str, Any]]:
+    """Extract linked providers from Supabase identity list.
+
+    Args:
+        identities: Raw identity list from Supabase Admin API.
+
+    Returns:
+        Dict with provider keys: {"google": {...}, "evm": {...}}.
+        Each value contains relevant fields and identity_id for unlinking.
+    """
+    result: dict[str, dict[str, Any]] = {}
+    for identity in identities:
+        provider = identity.get("provider")
+        identity_data = identity.get("identity_data") or {}
+
+        if provider == "google":
+            result["google"] = {
+                "email": identity_data.get("email"),
+                "identity_id": identity.get("id"),
+                "linked": True,
+            }
+        elif provider == "web3":
+            chain = identity_data.get("chain")
+            if chain == "ethereum":
+                result["evm"] = {
+                    "address": identity_data.get("address"),
+                    "identity_id": identity.get("id"),
+                    "linked": True,
+                }
+    return result

{intentkit-0.17.6 → intentkit-0.17.8}/intentkit/core/account_checking.py

@@ -290,7 +290,7 @@ async def check_transaction_balance() -> list[AccountCheckingResult]:
     last_id = ""  # Starting ID for pagination (empty string comes before all valid IDs)
 
     # Time window for events (last 3 days for performance)
-    three_days_ago = datetime.now(UTC) - timedelta(hours=4)
+    recent_cutoff = datetime.now(UTC) - timedelta(hours=4)
 
     while True:
         # Create a new session for each batch to prevent timeouts
@@ -298,7 +298,7 @@ async def check_transaction_balance() -> list[AccountCheckingResult]:
             # Get events in batches using ID-based pagination
             query = (
                 select(CreditEventTable)
-                .where(CreditEventTable.created_at >= three_days_ago)
+                .where(CreditEventTable.created_at >= recent_cutoff)
                 .where(
                     CreditEventTable.id > last_id
                 )  # Key change: ID-based pagination with string comparison
@@ -633,6 +633,85 @@ async def check_transaction_total_balance() -> list[AccountCheckingResult]:
     return [result]
 
 
+def _format_failed_check_details(
+    check_name: str, failed_results: list[AccountCheckingResult], max_items: int = 5
+) -> str:
+    """Format failure details for a specific check type.
+
+    Args:
+        check_name: The check type name
+        failed_results: List of failed AccountCheckingResult
+        max_items: Maximum number of items to include in details
+
+    Returns:
+        Formatted detail string
+    """
+    if not failed_results:
+        return ""
+
+    lines: list[str] = []
+    shown = failed_results[:max_items]
+
+    if check_name == "transaction_balance":
+        lines.append(f"First {len(shown)} of {len(failed_results)} imbalanced events:")
+        for i, r in enumerate(shown, 1):
+            d = r.details
+            lines.append(
+                f"{i}. Event {d.get('event_id')} ({d.get('event_type')}): "
+                f"credit={d.get('credit_sum')}, debit={d.get('debit_sum')}, "
+                f"diff={d.get('difference')}"
+            )
+
+    elif check_name == "orphaned_transactions":
+        orphaned = shown[0].details.get("orphaned_transactions", [])[:max_items]
+        count = shown[0].details.get("orphaned_count", 0)
+        lines.append(f"First {len(orphaned)} of {count} orphaned transactions:")
+        for i, tx in enumerate(orphaned, 1):
+            lines.append(
+                f"{i}. TX {tx.get('id')} (event={tx.get('event_id')}, "
+                f"type={tx.get('tx_type')}, {tx.get('credit_debit')}, "
+                f"amount={tx.get('change_amount')})"
+            )
+
+    elif check_name == "orphaned_events":
+        orphaned = shown[0].details.get("orphaned_events", [])[:max_items]
+        count = shown[0].details.get("orphaned_count", 0)
+        lines.append(f"First {len(orphaned)} of {count} orphaned events:")
+        for i, ev in enumerate(orphaned, 1):
+            lines.append(
+                f"{i}. Event {ev.get('event_id')} ({ev.get('event_type')}): "
+                f"account={ev.get('account_id')}, amount={ev.get('total_amount')}, "
+                f"type={ev.get('credit_type')}, at={ev.get('created_at')}"
+            )
+
+    elif check_name == "total_credit_balance":
+        d = shown[0].details
+        lines.append(
+            f"Grand total: {d.get('grand_total')} "
+            f"(free={d.get('total_free_credits')}, "
+            f"reward={d.get('total_reward_credits')}, "
+            f"permanent={d.get('total_permanent_credits')})"
+        )
+
+    elif check_name == "transaction_total_balance":
+        d = shown[0].details
+        lines.append(
+            f"Credits: {d.get('total_credits')}, "
+            f"Debits: {d.get('total_debits')}, "
+            f"Difference: {d.get('difference')}"
+        )
+
+    else:
+        # Generic fallback
+        for i, r in enumerate(shown, 1):
+            lines.append(f"{i}. {r.details}")
+
+    if len(failed_results) > max_items:
+        lines.append(f"... and {len(failed_results) - max_items} more")
+
+    return "\n".join(lines)
+
+
 async def run_quick_checks() -> dict[str, list[AccountCheckingResult]]:
     """Run quick account checking procedures and return results.
 
@@ -713,6 +792,23 @@ async def run_quick_checks() -> dict[str, list[AccountCheckingResult]]:
             }
         )
 
+    # Add failure details for each failed check type
+    if not all_passed:
+        for check_name, check_results in results.items():
+            failed_results = [r for r in check_results if not r.status]
+            if not failed_results:
+                continue
+
+            details_text = _format_failed_check_details(check_name, failed_results)
+            if details_text:
+                attachments.append(
+                    {
+                        "color": "warning",
+                        "title": f"{check_name.replace('_', ' ').title()} Details",
+                        "text": details_text,
+                    }
+                )
+
     # Send the message
     send_alert(
         message=f"{notify}Quick Account Checking Results", attachments=attachments
@@ -761,8 +857,6 @@ async def run_slow_checks() -> dict[str, list[AccountCheckingResult]]:
             failed_count,
         )
 
-    # Send summary to Slack
-
     # Create a summary message with color based on status
     total_checks = sum(len(check_results) for check_results in results.values())
 

{intentkit-0.17.6 → intentkit-0.17.8}/intentkit/core/credit/__init__.py

@@ -34,7 +34,7 @@ from .list_events import (
     fetch_credit_event_by_id,
     fetch_credit_event_by_upstream_tx_id,
     list_credit_events,
-    list_credit_events_by_user,
+    list_credit_events_by_team,
     list_fee_events_by_agent,
 )
 from .recharge import recharge
@@ -72,7 +72,7 @@ __all__ = [
     "fetch_credit_event_by_id",
     "fetch_credit_event_by_upstream_tx_id",
     "list_credit_events",
-    "list_credit_events_by_user",
+    "list_credit_events_by_team",
     "list_fee_events_by_agent",
     "recharge",
     "refill_all_free_credits",

{intentkit-0.17.6 → intentkit-0.17.8}/intentkit/core/credit/adjustment.py

@@ -26,25 +26,25 @@ logger = logging.getLogger(__name__)
 
 async def adjustment(
     session: AsyncSession,
-    user_id: str,
+    team_id: str,
     credit_type: CreditType,
     amount: Decimal,
     upstream_tx_id: str,
     note: str,
 ) -> CreditAccount:
     """
-    Adjust a user account's credits (can be positive or negative).
+    Adjust a team account's credits (can be positive or negative).
 
     Args:
         session: Async session to use for database operations
-        user_id: ID of the user to adjust
+        team_id: ID of the team to adjust
         credit_type: Type of credit to adjust (FREE, REWARD, or PERMANENT)
         amount: Amount to adjust (positive for increase, negative for decrease)
         upstream_tx_id: ID of the upstream transaction
         note: Required explanation for the adjustment
 
     Returns:
-        Updated user credit account
+        Updated team credit account
     """
     # Check for idempotency - prevent duplicate transactions
     await CreditEvent.check_upstream_tx_id_exists(
@@ -61,29 +61,26 @@ async def adjustment(
     is_income = amount > Decimal("0")
     abs_amount = abs(amount)
     direction = Direction.INCOME if is_income else Direction.EXPENSE
-    credit_debit_user = CreditDebit.CREDIT if is_income else CreditDebit.DEBIT
+    credit_debit_team = CreditDebit.CREDIT if is_income else CreditDebit.DEBIT
     credit_debit_platform = CreditDebit.DEBIT if is_income else CreditDebit.CREDIT
 
     # 1. Create credit event record first to get event_id
     event_id = str(XID())
 
-    # 2. Update user account
+    # 2. Update team account
     if is_income:
-        user_account = await CreditAccount.income_in_session(
+        team_account = await CreditAccount.income_in_session(
             session=session,
-            owner_type=OwnerType.USER,
-            owner_id=user_id,
+            owner_type=OwnerType.TEAM,
+            owner_id=team_id,
             amount_details={credit_type: abs_amount},
             event_id=event_id,
         )
     else:
-        # Deduct the credits using deduction_in_session
-        # For adjustment, we don't check if the user has enough credits
-        # It can be positive or negative
-        user_account = await CreditAccount.deduction_in_session(
+        team_account = await CreditAccount.deduction_in_session(
             session=session,
-            owner_type=OwnerType.USER,
-            owner_id=user_id,
+            owner_type=OwnerType.TEAM,
+            owner_id=team_id,
             credit_type=credit_type,
             amount=abs_amount,
             event_id=event_id,
@@ -124,17 +121,17 @@ async def adjustment(
     event = CreditEventTable(
         id=event_id,
         event_type=EventType.ADJUSTMENT,
-        user_id=user_id,
+        team_id=team_id,
         upstream_type=UpstreamType.API,
         upstream_tx_id=upstream_tx_id,
         direction=direction,
-        account_id=user_account.id,
+        account_id=team_account.id,
         total_amount=abs_amount,
         credit_type=credit_type,
         credit_types=[credit_type],
-        balance_after=user_account.credits
-        + user_account.free_credits
-        + user_account.reward_credits,
+        balance_after=team_account.credits
+        + team_account.free_credits
+        + team_account.reward_credits,
         base_amount=abs_amount,
         base_original_amount=abs_amount,
         base_free_amount=free_amount,
@@ -150,20 +147,20 @@ async def adjustment(
     await session.flush()
 
     # 4. Create credit transaction records
-    # 4.1 User account transaction
-    user_tx = CreditTransactionTable(
+    # 4.1 Team account transaction
+    team_tx = CreditTransactionTable(
         id=str(XID()),
-        account_id=user_account.id,
+        account_id=team_account.id,
         event_id=event_id,
         tx_type=TransactionType.ADJUSTMENT,
-        credit_debit=credit_debit_user,
+        credit_debit=credit_debit_team,
         change_amount=abs_amount,
         credit_type=credit_type,
         free_amount=free_amount,
         reward_amount=reward_amount,
         permanent_amount=permanent_amount,
     )
-    session.add(user_tx)
+    session.add(team_tx)
 
     # 4.2 Platform adjustment account transaction
     platform_tx = CreditTransactionTable(
@@ -183,4 +180,4 @@ async def adjustment(
     # Commit all changes
     await session.commit()
 
-    return user_account
+    return team_account