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

intentkit/skills/venice_audio/base.py

@@ -1,121 +1,117 @@
-import logging
-from typing import Dict, List, Optional, Tuple, Type
-
-from langchain.tools.base import ToolException
-from pydantic import BaseModel, Field
-
-from intentkit.abstracts.skill import SkillStoreABC
-from intentkit.skills.base import IntentKitSkill
-
-logger = logging.getLogger(__name__)
-
-
-class VeniceAudioBaseTool(IntentKitSkill):
-    """Base class for Venice Audio tools."""
-
-    name: str = Field(default="venice_base_tool", description="The name of the tool")
-    description: str = Field(description="A description of what the tool does")
-    args_schema: Type[BaseModel]  # type: ignore
-    skill_store: SkillStoreABC = Field(
-        description="The skill store for persisting data"
-    )
-
-    @property
-    def category(self) -> str:
-        return "venice_audio"
-
-    def validate_voice_model(
-        self, context, voice_model: str
-    ) -> Tuple[bool, Optional[Dict[str, object]]]:
-        config = context.config
-
-        selected_model = config.get("voice_model")
-        custom_models = config.get("voice_model_custom", [])
-
-        allowed_voice_models: List[str] = []
-
-        if selected_model == "custom":
-            allowed_voice_models = custom_models or []
-        else:
-            allowed_voice_models = [selected_model] if selected_model else []
-
-        if voice_model not in allowed_voice_models:
-            return False, {
-                "error": f'"{voice_model}" is not allowed',
-                "allowed": allowed_voice_models,
-                "suggestion": "please try again with allowed voice model",
-            }
-
-        return True, None
-
-    def get_api_key(self) -> str:
-        """
-        Retrieves the Venice AI API key based on the api_key_provider setting.
-
-        Returns:
-            The API key if found.
-
-        Raises:
-            ToolException: If the API key is not found or provider is invalid.
-        """
-        try:
-            context = self.get_context()
-            skill_config = context.agent.skill_config(self.category)
-            api_key_provider = skill_config.get("api_key_provider")
-            if api_key_provider == "agent_owner":
-                agent_api_key = skill_config.get("api_key")
-                if agent_api_key:
-                    logger.debug(
-                        f"Using agent-specific Venice API key for skill {self.name} in category {self.category}"
-                    )
-                    return agent_api_key
-                raise ToolException(
-                    f"No agent-owned Venice API key found for skill '{self.name}' in category '{self.category}'."
-                )
-
-            elif api_key_provider == "platform":
-                system_api_key = self.skill_store.get_system_config("venice_api_key")
-                if system_api_key:
-                    logger.debug(
-                        f"Using system Venice API key for skill {self.name} in category {self.category}"
-                    )
-                    return system_api_key
-                raise ToolException(
-                    f"No platform-hosted Venice API key found for skill '{self.name}' in category '{self.category}'."
-                )
-
-            else:
-                raise ToolException(
-                    f"Invalid API key provider '{api_key_provider}' for skill '{self.name}'"
-                )
-
-        except Exception as e:
-            raise ToolException(f"Failed to retrieve Venice API key: {str(e)}") from e
-
-    async def apply_rate_limit(self, context) -> None:
-        """
-        Applies rate limiting ONLY if specified in the agent's config ('skill_config').
-        Checks for 'rate_limit_number' and 'rate_limit_minutes'.
-        If not configured, NO rate limiting is applied.
-        Raises ConnectionAbortedError if the configured limit is exceeded.
-        """
-        skill_config = context.agent.skill_config(self.category)
-        user_id = context.agent.id
-
-        # Get agent-specific limits safely
-        limit_num = skill_config.get("rate_limit_number")
-        limit_min = skill_config.get("rate_limit_minutes")
-
-        # Apply limit ONLY if both values are present and valid (truthy check handles None and 0)
-        if limit_num and limit_min:
-            limit_source = "Agent"
-            logger.debug(
-                f"Applying {limit_source} rate limit ({limit_num}/{limit_min} min) for user {user_id} on {self.name}"
-            )
-            if user_id:
-                await self.user_rate_limit_by_category(user_id, limit_num, limit_min)
-        else:
-            # No valid agent configuration found, so do nothing.
-            logger.debug(
-                f"No agent rate limits configured for category '{self.category}'. Skipping rate limit for user {user_id}."
-            )
+import logging
+
+from langchain_core.tools.base import ToolException
+from pydantic import BaseModel, Field
+
+from intentkit.config.config import config
+from intentkit.skills.base import IntentKitSkill
+
+logger = logging.getLogger(__name__)
+
+
+class VeniceAudioBaseTool(IntentKitSkill):
+    """Base class for Venice Audio tools."""
+
+    name: str = Field(default="venice_base_tool", description="The name of the tool")
+    description: str = Field(description="A description of what the tool does")
+    args_schema: type[BaseModel]  # type: ignore
+
+    @property
+    def category(self) -> str:
+        return "venice_audio"
+
+    def validate_voice_model(
+        self, context, voice_model: str
+    ) -> tuple[bool, dict[str, object] | None]:
+        config = context.config
+
+        selected_model = config.get("voice_model")
+        custom_models = config.get("voice_model_custom", [])
+
+        allowed_voice_models: list[str] = []
+
+        if selected_model == "custom":
+            allowed_voice_models = custom_models or []
+        else:
+            allowed_voice_models = [selected_model] if selected_model else []
+
+        if voice_model not in allowed_voice_models:
+            return False, {
+                "error": f'"{voice_model}" is not allowed',
+                "allowed": allowed_voice_models,
+                "suggestion": "please try again with allowed voice model",
+            }
+
+        return True, None
+
+    def get_api_key(self) -> str:
+        """
+        Retrieves the Venice AI API key based on the api_key_provider setting.
+
+        Returns:
+            The API key if found.
+
+        Raises:
+            ToolException: If the API key is not found or provider is invalid.
+        """
+        try:
+            context = self.get_context()
+            skill_config = context.agent.skill_config(self.category)
+            api_key_provider = skill_config.get("api_key_provider")
+            if api_key_provider == "agent_owner":
+                agent_api_key = skill_config.get("api_key")
+                if agent_api_key:
+                    logger.debug(
+                        f"Using agent-specific Venice API key for skill {self.name} in category {self.category}"
+                    )
+                    return agent_api_key
+                raise ToolException(
+                    f"No agent-owned Venice API key found for skill '{self.name}' in category '{self.category}'."
+                )
+
+            elif api_key_provider == "platform":
+                system_api_key = config.venice_api_key
+                if system_api_key:
+                    logger.debug(
+                        f"Using system Venice API key for skill {self.name} in category {self.category}"
+                    )
+                    return system_api_key
+                raise ToolException(
+                    f"No platform-hosted Venice API key found for skill '{self.name}' in category '{self.category}'."
+                )
+
+            else:
+                raise ToolException(
+                    f"Invalid API key provider '{api_key_provider}' for skill '{self.name}'"
+                )
+
+        except Exception as e:
+            raise ToolException(f"Failed to retrieve Venice API key: {str(e)}") from e
+
+    async def apply_rate_limit(self, context) -> None:
+        """
+        Applies rate limiting ONLY if specified in the agent's config ('skill_config').
+        Checks for 'rate_limit_number' and 'rate_limit_minutes'.
+        If not configured, NO rate limiting is applied.
+        Raises ConnectionAbortedError if the configured limit is exceeded.
+        """
+        skill_config = context.agent.skill_config(self.category)
+        user_id = context.agent.id
+
+        # Get agent-specific limits safely
+        limit_num = skill_config.get("rate_limit_number")
+        limit_min = skill_config.get("rate_limit_minutes")
+
+        # Apply limit ONLY if both values are present and valid (truthy check handles None and 0)
+        if limit_num and limit_min:
+            limit_source = "Agent"
+            logger.debug(
+                f"Applying {limit_source} rate limit ({limit_num}/{limit_min} min) for user {user_id} on {self.name}"
+            )
+            if user_id:
+                await self.user_rate_limit_by_category(limit_num, limit_min * 60)
+        else:
+            # No valid agent configuration found, so do nothing.
+            logger.debug(
+                f"No agent rate limits configured for category '{self.category}'. Skipping rate limit for user {user_id}."
+            )

intentkit/skills/venice_audio/input.py

@@ -1,41 +1,41 @@
-from typing import Literal, Optional
-
-from pydantic import BaseModel, Field
-
-# Define the allowed format literals based on the API documentation
-AllowedAudioFormat = Literal["mp3", "opus", "aac", "flac", "wav", "pcm"]
-
-
-class VeniceAudioInput(BaseModel):
-    """
-    Input schema for Venice AI Text-to-Speech (/audio/speech endpoint).
-    Defines parameters controllable by the user when invoking the tool.
-    """
-
-    voice_input: str = Field(
-        ...,  # Ellipsis (...) indicates this field is required
-        description="The text to generate audio for. Maximum length is 4096 characters.",
-        min_length=1,  # As per API docs: Required string length: 1
-        max_length=4096,  # As per API docs: The maximum length is 4096 characters.
-    )
-
-    voice_model: str = Field(
-        description="voice model to used to generate voice from text_to_speech tool."
-    )
-
-    speed: Optional[float] = Field(
-        default=1.0,  # As per API docs: default: 1 (using float for consistency)
-        description="The speed of the generated audio. 1.0 is normal speed. Allowed range: 0.25 to 4.0.",
-        ge=0.25,  # As per API docs: Required range: 0.25 <= x
-        le=4.0,  # As per API docs: Required range: x <= 4
-    )
-
-    response_format: Optional[AllowedAudioFormat] = Field(
-        default="mp3",  # As per API docs: default: mp3
-        description="The desired audio format for the output file.",
-    )
-
-    # --- Note on other API parameters ---
-    # 'model': Currently hardcoded to 'tts-kokoro' in VeniceAudioBaseTool._arun. Could be added here if needed.
-    # 'voice': Handled by the 'voice_model' attribute of the specific VeniceAudioBaseTool instance. Not typically set via input schema.
-    # 'streaming': Currently hardcoded to False in VeniceAudioBaseTool._arun. Could be added here if streaming support is implemented.
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+# Define the allowed format literals based on the API documentation
+AllowedAudioFormat = Literal["mp3", "opus", "aac", "flac", "wav", "pcm"]
+
+
+class VeniceAudioInput(BaseModel):
+    """
+    Input schema for Venice AI Text-to-Speech (/audio/speech endpoint).
+    Defines parameters controllable by the user when invoking the tool.
+    """
+
+    voice_input: str = Field(
+        ...,  # Ellipsis (...) indicates this field is required
+        description="The text to generate audio for. Maximum length is 4096 characters.",
+        min_length=1,  # As per API docs: Required string length: 1
+        max_length=4096,  # As per API docs: The maximum length is 4096 characters.
+    )
+
+    voice_model: str = Field(
+        description="voice model to used to generate voice from text_to_speech tool."
+    )
+
+    speed: float | None = Field(
+        default=1.0,  # As per API docs: default: 1 (using float for consistency)
+        description="The speed of the generated audio. 1.0 is normal speed. Allowed range: 0.25 to 4.0.",
+        ge=0.25,  # As per API docs: Required range: 0.25 <= x
+        le=4.0,  # As per API docs: Required range: x <= 4
+    )
+
+    response_format: AllowedAudioFormat | None = Field(
+        default="mp3",  # As per API docs: default: mp3
+        description="The desired audio format for the output file.",
+    )
+
+    # --- Note on other API parameters ---
+    # 'model': Currently hardcoded to 'tts-kokoro' in VeniceAudioBaseTool._arun. Could be added here if needed.
+    # 'voice': Handled by the 'voice_model' attribute of the specific VeniceAudioBaseTool instance. Not typically set via input schema.
+    # 'streaming': Currently hardcoded to False in VeniceAudioBaseTool._arun. Could be added here if streaming support is implemented.

intentkit/skills/venice_audio/venice_audio.py

@@ -1,12 +1,11 @@
 import hashlib
 import json
 import logging
-from typing import Any, Dict, Optional, Type
+from typing import Any
 
 import httpx
-from pydantic import BaseModel, Field
+from pydantic import BaseModel
 
-from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.venice_audio.base import VeniceAudioBaseTool
 from intentkit.skills.venice_audio.input import AllowedAudioFormat, VeniceAudioInput
 from intentkit.utils.s3 import store_file
@@ -33,19 +32,16 @@ class VeniceAudioTool(VeniceAudioBaseTool):
         "Requires input text. Optional parameters include speed (0.25-4.0, default 1.0) "
         "and audio format (mp3, opus, aac, flac, wav, pcm, default mp3)."
     )
-    args_schema: Type[BaseModel] = VeniceAudioInput
-    skill_store: SkillStoreABC = Field(
-        description="The skill store instance for accessing system/agent configurations and persisting data."
-    )
+    args_schema: type[BaseModel] = VeniceAudioInput
 
     async def _arun(
         self,
         voice_input: str,
         voice_model: str,
-        speed: Optional[float] = 1.0,
-        response_format: Optional[AllowedAudioFormat] = "mp3",
+        speed: float | None = 1.0,
+        response_format: AllowedAudioFormat | None = "mp3",
         **kwargs,  # type: ignore
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         """
         Generates audio using the configured voice model via Venice AI TTS /audio/speech endpoint.
         Stores the resulting audio using the generic S3 helper.
@@ -96,7 +92,7 @@ class VeniceAudioTool(VeniceAudioBaseTool):
             await self.apply_rate_limit(context)
 
             # --- Prepare API Call ---
-            payload: Dict[str, Any] = {
+            payload: dict[str, Any] = {
                 "model": tts_model_id,
                 "input": voice_input,
                 "voice": voice_model,