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

intentkit/skills/venice_audio/__init__.py

@@ -1,106 +1,98 @@
-import logging
-from typing import List, Literal, Optional, TypedDict
-
-from intentkit.abstracts.skill import SkillStoreABC
-from intentkit.skills.base import SkillConfig, SkillState
-from intentkit.skills.venice_audio.base import VeniceAudioBaseTool
-from intentkit.skills.venice_audio.venice_audio import VeniceAudioTool
-
-logger = logging.getLogger(__name__)
-
-
-_cache: dict[str, VeniceAudioBaseTool] = {}
-
-_SKILL_NAME_TO_CLASS_MAP = {
-    "text_to_speech": VeniceAudioTool,
-    # Add new mappings here: "skill_name": SkillClassName
-}
-
-
-class SkillStates(TypedDict):
-    text_to_speech: SkillState
-
-
-class Config(SkillConfig):
-    enabled: bool
-    voice_model: Literal["af_heart", "bm_lewis", "custom"]
-    states: SkillStates  # type: ignore
-    api_key_provider: Optional[Literal["agent_owner"]]
-
-    # conditionally required
-    api_key: Optional[str]
-    voice_model_custom: Optional[list[str]]
-
-    # optional
-    rate_limit_number: Optional[int]
-    rate_limit_minutes: Optional[int]
-
-
-async def get_skills(
-    config: "Config",
-    is_private: bool,
-    store: SkillStoreABC,
-    **_,  # Allow for extra arguments if the loader passes them
-) -> list[VeniceAudioBaseTool]:
-    """
-    Factory function to create and return Venice Audio skill tools.
-
-    Args:
-        config: The configuration dictionary for the Venice Audio skill.
-        skill_store: The skill store instance.
-        agent_id: The ID of the agent requesting the skills.
-
-    Returns:
-        A list of VeniceAudioBaseTool instances for the Venice Audio skill.
-    """
-    # Check if the entire category is disabled first
-    if not config.get("enabled", False):
-        return []
-
-    available_skills: List[VeniceAudioBaseTool] = []
-    skill_states = config.get("states", {})
-
-    # Iterate through all known skills defined in the map
-    for skill_name in _SKILL_NAME_TO_CLASS_MAP:
-        state = skill_states.get(
-            skill_name, "disabled"
-        )  # Default to disabled if not in config
-
-        if state == "disabled":
-            continue
-        elif state == "public" or (state == "private" and is_private):
-            # If enabled, get the skill instance using the factory function
-            skill_instance = get_venice_audio_skill(skill_name, store)
-            if skill_instance:
-                available_skills.append(skill_instance)
-            else:
-                # This case should ideally not happen if the map is correct
-                logger.warning(f"Could not instantiate known skill: {skill_name}")
-
-    return available_skills
-
-
-def get_venice_audio_skill(
-    name: str,
-    store: SkillStoreABC,
-) -> Optional[VeniceAudioBaseTool]:
-    """
-    Factory function to get a cached Venice Audio skill instance by name.
-
-    Args:
-        name: The name of voice model.
-        store: The skill store, passed to the skill constructor.
-
-    Returns:
-        The requested Venice Audio skill instance, or None if the name is unknown.
-    """
-
-    # Return from cache immediately if already exists
-    if name in _cache:
-        return _cache[name]
-
-    # Cache and return the newly created instance
-    _cache[name] = VeniceAudioTool(
-        skill_store=store,
-    )
-    return _cache[name]
+import logging
+from typing import Literal, TypedDict
+
+from intentkit.skills.base import SkillConfig, SkillState
+from intentkit.skills.venice_audio.base import VeniceAudioBaseTool
+from intentkit.skills.venice_audio.venice_audio import VeniceAudioTool
+
+logger = logging.getLogger(__name__)
+
+_cache: dict[str, VeniceAudioBaseTool] = {}
+
+_SKILL_NAME_TO_CLASS_MAP = {
+    "text_to_speech": VeniceAudioTool,
+    # Add new mappings here: "skill_name": SkillClassName
+}
+
+
+class SkillStates(TypedDict):
+    text_to_speech: SkillState
+
+
+class Config(SkillConfig):
+    enabled: bool
+    voice_model: Literal["af_heart", "bm_lewis", "custom"]
+    states: SkillStates  # type: ignore
+    api_key_provider: Literal["agent_owner"] | None
+
+    # conditionally required
+    api_key: str | None
+    voice_model_custom: list[str] | None
+
+    # optional
+    rate_limit_number: int | None
+    rate_limit_minutes: int | None
+
+
+async def get_skills(
+    config: "Config",
+    is_private: bool,
+    **_,  # Allow for extra arguments if the loader passes them
+) -> list[VeniceAudioBaseTool]:
+    """
+    Factory function to create and return Venice Audio skill tools.
+
+    Args:
+        config: The configuration dictionary for the Venice Audio skill.
+        agent_id: The ID of the agent requesting the skills.
+
+    Returns:
+        A list of VeniceAudioBaseTool instances for the Venice Audio skill.
+    """
+    # Check if the entire category is disabled first
+    if not config.get("enabled", False):
+        return []
+
+    available_skills: list[VeniceAudioBaseTool] = []
+    skill_states = config.get("states", {})
+
+    # Iterate through all known skills defined in the map
+    for skill_name in _SKILL_NAME_TO_CLASS_MAP:
+        state = skill_states.get(
+            skill_name, "disabled"
+        )  # Default to disabled if not in config
+
+        if state == "disabled":
+            continue
+        elif state == "public" or (state == "private" and is_private):
+            # If enabled, get the skill instance using the factory function
+            skill_instance = get_venice_audio_skill(skill_name)
+            if skill_instance:
+                available_skills.append(skill_instance)
+            else:
+                # This case should ideally not happen if the map is correct
+                logger.warning(f"Could not instantiate known skill: {skill_name}")
+
+    return available_skills
+
+
+def get_venice_audio_skill(
+    name: str,
+) -> VeniceAudioBaseTool | None:
+    """
+    Factory function to get a cached Venice Audio skill instance by name.
+
+    Args:
+        name: The name of voice model.
+
+    Returns:
+        The requested Venice Audio skill instance, or None if the name is unknown.
+    """
+
+    # Return from cache immediately if already exists
+    if name in _cache:
+        return _cache[name]
+
+    # Cache and return the newly created instance
+    _cache[name] = VeniceAudioTool()
+    return _cache[name]

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.
-    """
-
-    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.