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

intentkit/skills/carv/onchain_query.py

@@ -1,6 +1,6 @@
 import logging
 from decimal import Decimal, InvalidOperation
-from typing import Any, Dict, Literal, Type
+from typing import Any, Literal
 
 from pydantic import BaseModel, Field
 
@@ -58,14 +58,14 @@ class OnchainQueryTool(CarvBaseTool):
         "- ETH values are denominated in 18 decimals—consider 10^18 when interpreting amounts.\n"
         "- Never fabricate or infer data beyond what the tool provides."
     )
-    args_schema: Type[BaseModel] = CarvInput
+    args_schema: type[BaseModel] = CarvInput
 
     async def _arun(
         self,
         question: str,
         chain: str,  # type: ignore
         **kwargs: Any,
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         """
         Queries the CARV SQL Query API and returns the response.
         """
@@ -104,7 +104,7 @@ class OnchainQueryTool(CarvBaseTool):
             }
 
 
-def _normalize_unit(response_data: Dict[str, Any], chain: str) -> None:
+def _normalize_unit(response_data: dict[str, Any], chain: str) -> None:
     """
     Normalizes the 'value' field in on-chain response data to a human-readable format.
     Adds the corresponding token ticker after the value.

intentkit/skills/carv/schema.json

@@ -1,137 +1,134 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "title": "CARV",
-    "description": "Configuration for the CARV skill.",
-    "type": "object",
-    "x-icon": "https://ai.service.crestal.dev/skills/carv/carv.webp",
-    "x-tags": [
-        "AI",
-        "Data",
-        "Information",
-        "Analytics",
-        "Market Data"
-    ],
-    "properties": {
-        "enabled": {
-            "type": "boolean",
-            "description": "Enable or disable the CARV skill.",
-            "default": false
-        },
-        "states": {
-            "type": "object",
-            "title": "Skill States",
-            "description": "Enable/disable specific tools for CARV",
-            "properties": {
-                "onchain_query": {
-                    "type": "string",
-                    "title": "On-Chain Query",
-                    "enum": [
-                        "disabled",
-                        "public",
-                        "private"
-                    ],
-                    "x-enum-title": [
-                        "Disabled",
-                        "Agent Owner + All Users",
-                        "Agent Owner Only"
-                    ],
-                    "description": "allows you to use the nature language to query the on-chain data. Behind the scean, CARV will use LLM model to interpreate the nature language input and convert into the sql query based on the above schemas",
-                    "default": "public"
-                },
-                "token_info_and_price": {
-                    "type": "string",
-                    "title": "Token Information and Price",
-                    "enum": [
-                        "disabled",
-                        "public",
-                        "private"
-                    ],
-                    "x-enum-title": [
-                        "Disabled",
-                        "Agent Owner + All Users",
-                        "Agent Owner Only"
-                    ],
-                    "description": "Fetches detailed information and current USD price of a cryptocurrency token from CARV API using its ticker symbol (e.g., 'eth', 'btc'), returning metadata like name, symbol, platform, categories, and contract addresses, useful for understanding its identity, ecosystem, market value, and for obtaining comprehensive token data with live pricing.",
-                    "default": "public"
-                },
-                "fetch_news": {
-                    "type": "string",
-                    "title": "Fetch News",
-                    "enum": [
-                        "disabled",
-                        "public",
-                        "private"
-                    ],
-                    "x-enum-title": [
-                        "Disabled",
-                        "Agent Owner + All Users",
-                        "Agent Owner Only"
-                    ],
-                    "description": "retrieves a list of recent news items, each including a title, URL, and a short description",
-                    "default": "disabled"
-                }
-            }
-        },
-        "api_key_provider": {
-            "type": "string",
-            "title": "API Key Provider",
-            "description": "Provider of the API key",
-            "enum": [
-                "agent_owner",
-                "platform"
-            ],
-            "x-enum-title": [
-                "Owner Provided",
-                "Nation Hosted"
-            ],
-            "default": "platform"
-        }
-    },
-    "required": [
-        "enabled",
-        "states"
-    ],
-    "if": {
-        "allOf": [
-            {
-                "properties": {
-                    "enabled": {
-                        "const": true
-                    }
-                }
-            },
-            {
-                "properties": {
-                    "api_key_provider": {
-                        "const": "agent_owner"
-                    }
-                }
-            }
-        ]
-    },
-    "then": {
-        "properties": {
-            "api_key": {
-                "type": "string",
-                "title": "CARV API Key",
-                "x-link": "[Get your API key](https://docs.carv.io/d.a.t.a.-ai-framework/api-documentation#authentication)",
-                "x-sensitive": true,
-                "description": "API Key for authenticating with the CARV API."
-            },
-            "rate_limit_number": {
-                "type": "integer",
-                "title": "Rate Limit Number",
-                "description": "Number of requests allowed per time window."
-            },
-            "rate_limit_minutes": {
-                "type": "integer",
-                "title": "Rate Limit Minutes",
-                "description": "Time window in minutes for rate limiting."
-            }
-        },
-        "required": [
-            "api_key"
-        ]
-    },
-    "additionalProperties": true
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "CARV",
+  "description": "Configuration for the CARV skill.",
+  "type": "object",
+  "x-icon": "https://ai.service.crestal.dev/skills/carv/carv.webp",
+  "x-tags": [
+    "Analytics",
+    "Crypto"
+  ],
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "description": "Enable or disable the CARV skill.",
+      "default": false
+    },
+    "states": {
+      "type": "object",
+      "title": "Skill States",
+      "description": "Enable/disable specific tools for CARV",
+      "properties": {
+        "onchain_query": {
+          "type": "string",
+          "title": "On-Chain Query",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "allows you to use the nature language to query the on-chain data. Behind the scean, CARV will use LLM model to interpreate the nature language input and convert into the sql query based on the above schemas",
+          "default": "public"
+        },
+        "token_info_and_price": {
+          "type": "string",
+          "title": "Token Information and Price",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "Fetches detailed information and current USD price of a cryptocurrency token from CARV API using its ticker symbol (e.g., 'eth', 'btc'), returning metadata like name, symbol, platform, categories, and contract addresses, useful for understanding its identity, ecosystem, market value, and for obtaining comprehensive token data with live pricing.",
+          "default": "public"
+        },
+        "fetch_news": {
+          "type": "string",
+          "title": "Fetch News",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "retrieves a list of recent news items, each including a title, URL, and a short description",
+          "default": "disabled"
+        }
+      }
+    },
+    "api_key_provider": {
+      "type": "string",
+      "title": "API Key Provider",
+      "description": "Provider of the API key",
+      "enum": [
+        "agent_owner",
+        "platform"
+      ],
+      "x-enum-title": [
+        "Owner Provided",
+        "Nation Hosted"
+      ],
+      "default": "platform"
+    }
+  },
+  "required": [
+    "enabled",
+    "states"
+  ],
+  "if": {
+    "allOf": [
+      {
+        "properties": {
+          "enabled": {
+            "const": true
+          }
+        }
+      },
+      {
+        "properties": {
+          "api_key_provider": {
+            "const": "agent_owner"
+          }
+        }
+      }
+    ]
+  },
+  "then": {
+    "properties": {
+      "api_key": {
+        "type": "string",
+        "title": "CARV API Key",
+        "x-link": "[Get your API key](https://docs.carv.io/d.a.t.a.-ai-framework/api-documentation#authentication)",
+        "x-sensitive": true,
+        "description": "API Key for authenticating with the CARV API."
+      },
+      "rate_limit_number": {
+        "type": "integer",
+        "title": "Rate Limit Number",
+        "description": "Number of requests allowed per time window."
+      },
+      "rate_limit_minutes": {
+        "type": "integer",
+        "title": "Rate Limit Minutes",
+        "description": "Time window in minutes for rate limiting."
+      }
+    },
+    "required": [
+      "api_key"
+    ]
+  },
+  "additionalProperties": true
+}

intentkit/skills/carv/token_info_and_price.py

@@ -1,6 +1,6 @@
 import logging
 import re
-from typing import Any, Dict, Optional, Type
+from typing import Any
 
 from pydantic import BaseModel, Field
 
@@ -16,7 +16,7 @@ class TokenInfoAndPriceInput(BaseModel):
     token_name: str = Field(
         description="The token name (e.g ethereum, bitcoin, solana, ripple)"
     )
-    amount: Optional[float] = Field(
+    amount: float | None = Field(
         description="(optional) amount of token, fill this if user asking for how much x amount of specific token worth"
     )
 
@@ -38,15 +38,15 @@ class TokenInfoAndPriceTool(CarvBaseTool):
         "Useful for understanding a token's identity, ecosystem, and market value"
         "Use this tool when you need comprehensive token data and live pricing from CARV."
     )
-    args_schema: Type[BaseModel] = TokenInfoAndPriceInput
+    args_schema: type[BaseModel] = TokenInfoAndPriceInput
 
     async def _arun(
         self,
         ticker: str,
         token_name: str,
-        amount: Optional[float] = 1,  # type: ignore
+        amount: float | None = 1,  # type: ignore
         **kwargs: Any,
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         if not ticker:
             return {
                 "error": True,

intentkit/skills/casino/README.md

@@ -0,0 +1,254 @@
+# Casino Skills for IntentKit
+
+The Casino skills provide comprehensive gambling and gaming capabilities for AI agents, enabling interactive card games, dice games, and casino-style entertainment.
+
+## 🎯 Overview
+
+This skill set includes three main functions:
+- **Deck Shuffling**: Create and shuffle card decks with customizable options
+- **Card Drawing**: Draw cards with visual PNG/SVG images 
+- **Quantum Dice Rolling**: True random dice using quantum number generation
+
+## 🛠️ Available Skills
+
+### 1. `casino_deck_shuffle`
+Creates and shuffles new card decks with options for multiple decks and jokers.
+
+**Parameters:**
+- `deck_count` (int): Number of decks (1-6, default: 1)
+- `jokers_enabled` (bool): Include jokers (default: false)
+
+### 2. `casino_deck_draw` 
+Draws cards from the current deck with detailed information and images.
+
+**Parameters:**
+- `count` (int): Number of cards to draw (1-10, default: 1)
+
+### 3. `casino_dice_roll`
+Rolls quantum random dice with visual representation.
+
+**Parameters:**
+- `dice_count` (int): Number of dice to roll (1-10, default: 1)
+
+## 🎮 Game Examples
+
+### 🃏 Blackjack (21)
+
+**Setup:**
+```
+Agent: I'll set up a Blackjack game for you! Let me shuffle a fresh deck.
+[Calls casino_deck_shuffle with deck_count=1]
+```
+
+**Dealing Cards:**
+```
+Agent: Dealing your cards...
+[Calls casino_deck_draw with count=2 for player]
+[Calls casino_deck_draw with count=1 for dealer, 1 face down]
+
+Result: You have: King♠️ (image) + 7♥️ (image) = 17
+Dealer shows: Ace♣️ (image) + [hidden card]
+```
+
+**Player Actions:**
+```
+User: "Hit me"
+Agent: [Calls casino_deck_draw with count=1]
+Result: You drew 3♦️ (image). Total: 20
+
+User: "Stand"
+Agent: Revealing dealer's hidden card...
+[Calls casino_deck_draw for dealer's hidden card and additional cards as needed]
+```
+
+### 🎲 Craps
+
+**Come Out Roll:**
+```
+Agent: Welcome to the Craps table! Place your bets and let's roll!
+[Calls casino_dice_roll with dice_count=2]
+
+Result: 🎲 Rolled: ⚂ ⚃ (3 + 4 = 7) - WINNER! 
+The shooter made their point on the come out roll!
+```
+
+**Point Phase:**
+```
+Agent: Point is 6. Rolling again...
+[Calls casino_dice_roll with dice_count=2]
+
+Result: 🎲 Rolled: ⚁ ⚄ (2 + 5 = 7) - Seven out! 
+New shooter coming up.
+```
+
+### 🃏 Texas Hold'em Poker
+
+**Pre-flop:**
+```
+Agent: Dealing pocket cards...
+[Calls casino_deck_shuffle with deck_count=1]
+[Calls casino_deck_draw with count=2 for each player]
+
+Your cards: A♠️ (image) K♠️ (image) - Ace-King suited!
+```
+
+**The Flop:**
+```
+Agent: Dealing the flop...
+[Calls casino_deck_draw with count=3]
+
+Flop: A♦️ (image) K♣️ (image) 7♠️ (image)
+You have two pair - Aces and Kings!
+```
+
+**Turn and River:**
+```
+Agent: Turn card...
+[Calls casino_deck_draw with count=1]
+Turn: Q♠️ (image)
+
+River card...
+[Calls casino_deck_draw with count=1] 
+River: J♠️ (image)
+
+Final board: A♦️ K♣️ 7♠️ Q♠️ J♠️
+You have a straight! A-K-Q-J-10
+```
+
+### 🎯 Yahtzee
+
+**First Roll:**
+```
+Agent: Rolling all 5 dice for Yahtzee!
+[Calls casino_dice_roll with dice_count=5]
+
+Result: ⚀ ⚃ ⚃ ⚄ ⚅ (1, 4, 4, 5, 6)
+Which dice would you like to keep?
+```
+
+**Rerolls:**
+```
+User: "Keep the two 4s"
+Agent: Rerolling 3 dice...
+[Calls casino_dice_roll with dice_count=3]
+
+Result: ⚃ ⚃ ⚃ (4, 4, 4) - Combined with your kept dice: ⚃ ⚃ ⚃ ⚃ ⚃
+YAHTZEE! Five of a kind - 4s! 🎉
+```
+
+### 🎲 Liar's Dice
+
+**Round Start:**
+```
+Agent: Everyone roll your dice under the cup!
+[Each player calls casino_dice_roll with dice_count=5]
+
+Your dice (hidden): ⚁ ⚁ ⚂ ⚄ ⚅ (2, 2, 3, 5, 6)
+```
+
+**Bidding:**
+```
+User: "I bid three 2s"
+Agent: Player 2 bids four 3s...
+Player 3 calls "Liar!" on Player 2.
+
+Revealing all dice...
+[Shows all dice rolled by each player]
+Total 3s on table: 2 dice
+Player 2 bid four 3s but there were only 2. Player 2 loses a die!
+```
+
+### 🃏 War (Card Game)
+
+**Battle:**
+```
+Agent: Time for War! Each player draws one card.
+[Calls casino_deck_draw with count=1 for each player]
+
+You: Q♦️ (image) - Queen of Diamonds
+Opponent: 8♣️ (image) - Eight of Clubs
+
+Queen beats 8 - You win this round!
+```
+
+**War Declaration:**
+```
+Agent: Both players drew Kings! It's WAR! 
+[Calls casino_deck_draw with count=4 for each player - 3 face down, 1 face up]
+
+Your war card: A♠️ (image) - Ace of Spades
+Opponent's war card: 10♥️ (image) - Ten of Hearts
+
+Ace beats 10 - You win the entire war pile!
+```
+
+## 🎨 Visual Features
+
+### Card Images
+Each card comes with both PNG and SVG images:
+```json
+{
+  "value": "ACE",
+  "suit": "SPADES", 
+  "code": "AS",
+  "image": "https://deckofcardsapi.com/static/img/AS.png",
+  "svg_image": "https://deckofcardsapi.com/static/img/AS.svg"
+}
+```
+
+### Dice Visualization
+Dice results include emoji representation:
+- ⚀ (1) ⚁ (2) ⚂ (3) ⚃ (4) ⚄ (5) ⚅ (6)
+
+### Game State Persistence
+- Deck state maintained between draws
+- Remaining cards tracked automatically  
+- Each agent has independent game sessions
+
+## 🛡️ Built-in Features
+
+### Rate Limiting
+- **Deck Shuffle**: 20 requests/minute
+- **Card Draw**: 30 requests/minute  
+- **Dice Roll**: 15 requests/minute
+
+### Error Handling
+- Automatic deck creation if none exists
+- Graceful API failure handling
+- Input validation and sanitization
+
+### Quantum Randomness
+Dice rolling uses true quantum random number generation from QRandom.io for authentic unpredictability, complete with quantum signatures for verification.
+
+## 🚀 Getting Started
+
+1. Enable Casino skills in your agent configuration
+2. Set skill states (public/private/disabled) for each function
+3. Start gaming! The agent will automatically manage decks and game state
+
+## 🎪 Advanced Gaming Scenarios
+
+### Multi-Table Casino
+```
+Agent: Welcome to the Nation Casino! I'm managing 3 tables:
+- Table 1: Blackjack (6-deck shoe)
+- Table 2: Poker Tournament 
+- Table 3: Craps with side bets
+
+Which table interests you?
+```
+
+### Tournament Mode
+```
+Agent: Poker Tournament - Round 1 of 3
+Blinds: 50/100 chips
+[Manages multiple hands, tracks chip counts, advances rounds]
+```
+
+### Live Dealer Experience  
+```
+Agent: 🎭 Good evening! I'm your live dealer tonight.
+[Maintains casino atmosphere, explains rules, manages multiple players]
+```
+
+The Casino skills transform your AI agent into a comprehensive gaming companion capable of hosting authentic casino experiences with visual cards, quantum dice, and persistent game management! 🎰🎲🃏