mindroom 0.0.0__py3-none-any.whl → 0.1.0__py3-none-any.whl

mindroom/tools/serpapi.py

@@ -0,0 +1,55 @@
+"""SerpApi tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.serpapi import SerpApiTools
+
+
+@register_tool_with_metadata(
+    name="serpapi",
+    display_name="SerpApi",
+    description="Google and YouTube search using SerpApi",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaGoogle",
+    icon_color="text-blue-500",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="YOUR_SERPAPI_KEY",
+            description="SerpApi API key for authentication (can also be set via SERP_API_KEY env var)",
+        ),
+        # Search features
+        ConfigField(
+            name="search_youtube",
+            label="Search YouTube",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable YouTube search functionality",
+        ),
+    ],
+    dependencies=["google-search-results"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/serpapi",
+)
+def serpapi_tools() -> type[SerpApiTools]:
+    """Return SerpApi tools for Google and YouTube search."""
+    from agno.tools.serpapi import SerpApiTools
+
+    return SerpApiTools

mindroom/tools/serper.py

@@ -0,0 +1,81 @@
+"""Serper tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.serper import SerperTools
+
+
+@register_tool_with_metadata(
+    name="serper",
+    display_name="Serper",
+    description="Search Google, news, academic papers, and scrape webpages using Serper API",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaSearch",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="your-serper-api-key",
+            description="Serper API key for authentication (can also be set via SERPER_API_KEY env var)",
+        ),
+        # Search configuration
+        ConfigField(
+            name="location",
+            label="Location",
+            type="text",
+            required=False,
+            default="us",
+            placeholder="us",
+            description="Google location code for search results (e.g., 'us', 'uk', 'ca')",
+        ),
+        ConfigField(
+            name="language",
+            label="Language",
+            type="text",
+            required=False,
+            default="en",
+            placeholder="en",
+            description="Language code for search results (e.g., 'en', 'es', 'fr')",
+        ),
+        ConfigField(
+            name="num_results",
+            label="Number of Results",
+            type="number",
+            required=False,
+            default=10,
+            description="Default number of search results to retrieve",
+        ),
+        ConfigField(
+            name="date_range",
+            label="Date Range",
+            type="text",
+            required=False,
+            placeholder="d",
+            description="Default date range filter for searches (e.g., 'd' for day, 'w' for week, 'm' for month)",
+        ),
+    ],
+    dependencies=["requests"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/serper",
+)
+def serper_tools() -> type[SerperTools]:
+    """Return Serper tools for Google search, news, academic papers, and web scraping."""
+    from agno.tools.serper import SerperTools
+
+    return SerperTools

mindroom/tools/shell.py

@@ -0,0 +1,46 @@
+"""Shell tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.shell import ShellTools
+
+
+@register_tool_with_metadata(
+    name="shell",
+    display_name="Shell Commands",
+    description="Execute shell commands and scripts",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="Terminal",
+    icon_color="text-green-500",
+    config_fields=[
+        ConfigField(
+            name="base_dir",
+            label="Base Directory",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="/path/to/working/directory",
+            description="Base directory for command execution (defaults to current directory)",
+        ),
+    ],
+    dependencies=[],
+    docs_url="https://docs.agno.com/tools/toolkits/local/shell",
+)
+def shell_tools() -> type[ShellTools]:
+    """Return shell tools for command execution."""
+    from agno.tools.shell import ShellTools
+
+    return ShellTools

mindroom/tools/slack.py

@@ -0,0 +1,80 @@
+"""Slack tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.slack import SlackTools
+
+
+@register_tool_with_metadata(
+    name="slack",
+    display_name="Slack",
+    description="Send messages and manage channels",
+    category=ToolCategory.COMMUNICATION,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaSlack",
+    icon_color="text-purple-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="token",
+            label="Slack Token",
+            type="password",
+            required=False,
+            placeholder="xoxb-...",
+            description="Slack bot token (can also be set via SLACK_TOKEN env var)",
+        ),
+        # Message operations
+        ConfigField(
+            name="send_message",
+            label="Send Message",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable sending messages to channels",
+        ),
+        ConfigField(
+            name="send_message_thread",
+            label="Send Message Thread",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable sending threaded messages",
+        ),
+        # Channel operations
+        ConfigField(
+            name="list_channels",
+            label="List Channels",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable listing workspace channels",
+        ),
+        ConfigField(
+            name="get_channel_history",
+            label="Get Channel History",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving channel message history",
+        ),
+    ],
+    dependencies=["slack-sdk"],
+    docs_url="https://docs.agno.com/tools/toolkits/social/slack",
+)
+def slack_tools() -> type[SlackTools]:
+    """Return Slack tools for messaging and channel management."""
+    from agno.tools.slack import SlackTools
+
+    return SlackTools

mindroom/tools/sleep.py

@@ -0,0 +1,38 @@
+"""Sleep tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.sleep import SleepTools
+
+
+@register_tool_with_metadata(
+    name="sleep",
+    display_name="Sleep",
+    description="Sleep utility for introducing delays and pauses in execution",
+    category=ToolCategory.DEVELOPMENT,  # Local utility tool
+    status=ToolStatus.AVAILABLE,  # No config needed
+    setup_type=SetupType.NONE,  # No authentication required
+    icon="Clock",  # React icon name
+    icon_color="text-purple-500",  # Tailwind color class
+    config_fields=[
+        # SleepTools has no explicit parameters, only **kwargs
+        # The tool inherits all base Toolkit configuration through **kwargs
+    ],
+    dependencies=["agno"],  # From agno requirements
+    docs_url="https://docs.agno.com/tools/toolkits/local/sleep",
+)
+def sleep_tools() -> type[SleepTools]:
+    """Return sleep tools for introducing delays and pauses in execution."""
+    from agno.tools.sleep import SleepTools
+
+    return SleepTools

mindroom/tools/spider.py

@@ -0,0 +1,62 @@
+"""Spider tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.spider import SpiderTools
+
+
+@register_tool_with_metadata(
+    name="spider",
+    display_name="Spider",
+    description="Web scraper and crawler that returns LLM-ready data",
+    category=ToolCategory.RESEARCH,  # Based on web_scrape category in docs
+    status=ToolStatus.AVAILABLE,  # API key handled via SPIDER_API_KEY env var
+    setup_type=SetupType.NONE,
+    icon="FaSpider",
+    icon_color="text-red-600",  # Spider red color
+    config_fields=[
+        ConfigField(
+            name="max_results",
+            label="Maximum Results",
+            type="number",
+            required=False,
+            placeholder="5",
+            description="The maximum number of search results to return",
+        ),
+        ConfigField(
+            name="url",
+            label="Default URL",
+            type="url",
+            required=False,
+            placeholder="https://example.com",
+            description="The default URL to be scraped or crawled",
+        ),
+        ConfigField(
+            name="optional_params",
+            label="Optional Parameters",
+            type="text",
+            required=False,
+            placeholder='{"return_format": "markdown"}',
+            description="Additional optional parameters as JSON object for Spider API calls",
+        ),
+    ],
+    dependencies=["spider-client"],
+    docs_url="https://docs.agno.com/tools/toolkits/web_scrape/spider",
+    helper_text="Get your API key from the [Spider dashboard](https://spider.cloud)",
+)
+def spider_tools() -> type[SpiderTools]:
+    """Return Spider tools for web scraping and crawling."""
+    from agno.tools.spider import SpiderTools
+
+    return SpiderTools

mindroom/tools/sql.py

@@ -0,0 +1,138 @@
+"""SQL tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.sql import SQLTools
+
+
+@register_tool_with_metadata(
+    name="sql",
+    display_name="SQL Tools",
+    description="Database query and management tools for SQL databases",
+    category=ToolCategory.PRODUCTIVITY,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.SPECIAL,
+    icon="Database",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Database Connection - Primary method: Database URL
+        ConfigField(
+            name="db_url",
+            label="Database URL",
+            type="url",
+            required=False,
+            placeholder="postgresql://user:password@host:port/database",
+            description="Complete database connection URL (can also be set via DB_URL env var)",
+        ),
+        # Advanced: Pre-configured database engine
+        ConfigField(
+            name="db_engine",
+            label="Database Engine",
+            type="text",
+            required=False,
+            placeholder="Advanced: Pre-configured SQLAlchemy Engine object",
+            description="Pre-configured SQLAlchemy Engine instance (for advanced users)",
+        ),
+        # Alternative connection parameters
+        ConfigField(
+            name="user",
+            label="Username",
+            type="text",
+            required=False,
+            placeholder="database_user",
+            description="Database username (alternative to db_url)",
+        ),
+        ConfigField(
+            name="password",
+            label="Password",
+            type="password",
+            required=False,
+            placeholder="database_password",
+            description="Database password (alternative to db_url)",
+        ),
+        ConfigField(
+            name="host",
+            label="Host",
+            type="url",
+            required=False,
+            placeholder="localhost",
+            description="Database host (alternative to db_url)",
+        ),
+        ConfigField(
+            name="port",
+            label="Port",
+            type="number",
+            required=False,
+            placeholder="5432",
+            description="Database port (alternative to db_url)",
+        ),
+        ConfigField(
+            name="schema",
+            label="Schema/Database",
+            type="text",
+            required=False,
+            placeholder="mydb",
+            description="Database schema or database name",
+        ),
+        ConfigField(
+            name="dialect",
+            label="Database Dialect",
+            type="text",
+            required=False,
+            placeholder="postgresql",
+            description="Database dialect (postgresql, mysql, sqlite, etc.)",
+        ),
+        # Table configuration
+        ConfigField(
+            name="tables",
+            label="Tables Configuration",
+            type="text",
+            required=False,
+            placeholder='{"users": {...}, "orders": {...}}',
+            description="JSON configuration of specific tables to access (optional)",
+        ),
+        # SQL Operation Controls
+        ConfigField(
+            name="list_tables",
+            label="List Tables",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable listing database tables",
+        ),
+        ConfigField(
+            name="describe_table",
+            label="Describe Table",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable describing table schemas",
+        ),
+        ConfigField(
+            name="run_sql_query",
+            label="Run SQL Query",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable executing SQL queries",
+        ),
+    ],
+    dependencies=["sqlalchemy"],
+    docs_url="https://docs.agno.com/tools/toolkits/database/sql",
+)
+def sql_tools() -> type[SQLTools]:
+    """Return SQL tools for database operations."""
+    from agno.tools.sql import SQLTools
+
+    return SQLTools

mindroom/tools/tavily.py

@@ -0,0 +1,104 @@
+"""Tavily tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.tavily import TavilyTools
+
+
+@register_tool_with_metadata(
+    name="tavily",
+    display_name="Tavily",
+    description="Real-time web search API for retrieving current information",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaSearch",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="tvly-...",
+            description="Tavily API key for web search access (can also be set via TAVILY_API_KEY env var)",
+        ),
+        # Feature flags
+        ConfigField(
+            name="search",
+            label="Enable Search",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable web search functionality",
+        ),
+        ConfigField(
+            name="use_search_context",
+            label="Use Search Context",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Use search context method instead of regular search",
+        ),
+        # Search configuration
+        ConfigField(
+            name="max_tokens",
+            label="Max Tokens",
+            type="number",
+            required=False,
+            default=6000,
+            description="Maximum number of tokens to return in search results",
+        ),
+        ConfigField(
+            name="include_answer",
+            label="Include Answer",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Include AI-generated answer summary in search results",
+        ),
+        ConfigField(
+            name="search_depth",
+            label="Search Depth",
+            type="select",
+            required=False,
+            default="advanced",
+            options=[
+                {"label": "Basic", "value": "basic"},
+                {"label": "Advanced", "value": "advanced"},
+            ],
+            description="Search depth level for query processing",
+        ),
+        ConfigField(
+            name="format",
+            label="Output Format",
+            type="select",
+            required=False,
+            default="markdown",
+            options=[
+                {"label": "JSON", "value": "json"},
+                {"label": "Markdown", "value": "markdown"},
+            ],
+            description="Format for search result output",
+        ),
+    ],
+    dependencies=["tavily-python"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/tavily",
+)
+def tavily_tools() -> type[TavilyTools]:
+    """Return Tavily tools for real-time web search."""
+    from agno.tools.tavily import TavilyTools
+
+    return TavilyTools

mindroom/tools/telegram.py

@@ -0,0 +1,54 @@
+"""Telegram tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.telegram import TelegramTools
+
+
+@register_tool_with_metadata(
+    name="telegram",
+    display_name="Telegram",
+    description="Send messages via Telegram bot",
+    category=ToolCategory.COMMUNICATION,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaTelegram",
+    icon_color="text-blue-500",  # Telegram blue
+    config_fields=[
+        # Authentication/Connection parameters
+        ConfigField(
+            name="chat_id",
+            label="Chat ID",
+            type="text",
+            required=True,
+            placeholder="123456789 or @username",
+            description="The chat ID or username to send messages to",
+        ),
+        ConfigField(
+            name="token",
+            label="Bot Token",
+            type="password",
+            required=False,
+            placeholder="1234567890:ABCdefGHijKlmnOPqrSTuvwXYZ",
+            description="Telegram bot token (can also be set via TELEGRAM_TOKEN env var)",
+        ),
+    ],
+    dependencies=["httpx"],
+    docs_url="https://core.telegram.org/bots/api",
+)
+def telegram_tools() -> type[TelegramTools]:
+    """Return Telegram tools for sending messages."""
+    from agno.tools.telegram import TelegramTools
+
+    return TelegramTools