intentkit 0.17.7__tar.gz → 0.17.8__tar.gz

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.17.7
+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.7 → 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.7"
+__version__ = "0.17.8"
 __author__ = "Ruihua"
 __email__ = "ruihua@crestal.network"
 

{intentkit-0.17.7 → 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.7 → intentkit-0.17.8}/intentkit/utils/alert.py

@@ -6,10 +6,11 @@ Based on configuration, it routes messages to either Telegram or Slack.
 If neither is configured, messages are logged instead.
 """
 
+import html as html_mod
 import logging
 from collections.abc import Sequence
 from enum import Enum
-from typing import Any
+from typing import Any, Literal
 
 logger = logging.getLogger(__name__)
 
@@ -122,23 +123,79 @@ def _format_telegram_message(
     message: str,
     blocks: Sequence[dict[str, Any]] | None = None,
     attachments: Sequence[dict[str, Any]] | None = None,
-) -> str:
+) -> tuple[str, Literal["HTML", "Markdown", "MarkdownV2"] | None]:
     """
-    Format alert content for Telegram by converting blocks and attachments to text.
+    Format alert content for Telegram by converting Slack-style blocks and attachments.
+
+    Returns:
+        A tuple of (formatted_message, parse_mode).
+        parse_mode is "HTML" when attachments/blocks are present, None otherwise.
     """
-    lines: list[str] = [message]
+    # Convert Slack-specific syntax in the message
+    # <!channel> is Slack's @channel mention
+    message = message.replace("<!channel>", "").strip()
 
-    if blocks:
-        lines.append("")
-        lines.append("Blocks:")
-        lines.extend([str(block) for block in blocks])
+    if not blocks and not attachments:
+        return message, None
+
+    # Use HTML formatting for structured content
+    lines: list[str] = [f"<b>{html_mod.escape(message)}</b>"]
 
     if attachments:
-        lines.append("")
-        lines.append("Attachments:")
-        lines.extend([str(attachment) for attachment in attachments])
+        for attachment in attachments:
+            lines.append("")
+
+            # Color indicator
+            color = attachment.get("color", "")
+            color_emoji = {"good": "🟢", "danger": "🔴", "warning": "🟡"}.get(
+                color, "⚪"
+            )
+
+            # Title
+            title = attachment.get("title")
+            if title:
+                lines.append(f"{color_emoji} <b>{html_mod.escape(str(title))}</b>")
+
+            # Text body
+            text = attachment.get("text")
+            if text:
+                lines.append(html_mod.escape(str(text)))
+
+            # Fields (key-value pairs)
+            fields = attachment.get("fields")
+            if fields:
+                for field in fields:
+                    field_title = field.get("title", "")
+                    field_value = field.get("value", "")
+                    lines.append(
+                        f"• <b>{html_mod.escape(str(field_title))}</b>: {html_mod.escape(str(field_value))}"
+                    )
 
-    return "\n".join(lines).strip()
+    if blocks:
+        lines.append("")
+        for block in blocks:
+            # Best-effort: extract text from common Slack block types
+            block_type = block.get("type", "")
+            if block_type == "section":
+                block_text = block.get("text", {})
+                if isinstance(block_text, dict):
+                    lines.append(html_mod.escape(block_text.get("text", str(block))))
+                else:
+                    lines.append(html_mod.escape(str(block_text)))
+            elif block_type == "header":
+                header_text = block.get("text", {})
+                if isinstance(header_text, dict):
+                    lines.append(
+                        f"<b>{html_mod.escape(header_text.get('text', ''))}</b>"
+                    )
+                else:
+                    lines.append(f"<b>{html_mod.escape(str(header_text))}</b>")
+            elif block_type == "divider":
+                lines.append("───────────")
+            else:
+                lines.append(html_mod.escape(str(block)))
+
+    return "\n".join(lines).strip(), "HTML"
 
 
 def send_alert(
@@ -166,12 +223,12 @@ def send_alert(
     if _alert_type == AlertType.TELEGRAM:
         from intentkit.utils.telegram_alert import send_telegram_message
 
-        telegram_message = _format_telegram_message(
+        telegram_message, parse_mode = _format_telegram_message(
             message=message,
             blocks=blocks,
             attachments=attachments,
         )
-        send_telegram_message(telegram_message)
+        send_telegram_message(telegram_message, parse_mode=parse_mode)
 
     elif _alert_type == AlertType.SLACK:
         from intentkit.utils.slack_alert import send_slack_message

{intentkit-0.17.7 → intentkit-0.17.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "intentkit"
-version = "0.17.7"
+version = "0.17.8"
 description = "Intent-based AI Agent Platform - Core Package"
 authors = [
     { name = "Ruihua", email = "ruihua@crestal.network" },