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

mindroom/tools/todoist.py

@@ -0,0 +1,103 @@
+"""Todoist 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.todoist import TodoistTools
+
+
+@register_tool_with_metadata(
+    name="todoist",
+    display_name="Todoist",
+    description="Task management with Todoist - create, update, delete, and organize tasks and projects",
+    category=ToolCategory.PRODUCTIVITY,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaTasks",
+    icon_color="text-red-500",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_token",
+            label="API Token",
+            type="password",
+            required=False,
+            placeholder="your_api_token",
+            description="Todoist API token (can also be set via TODOIST_API_TOKEN env var). Get from https://app.todoist.com/app/settings/integrations/developer",
+        ),
+        # Task operations
+        ConfigField(
+            name="create_task",
+            label="Create Task",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable creating new tasks in Todoist",
+        ),
+        ConfigField(
+            name="get_task",
+            label="Get Task",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable fetching specific tasks by ID",
+        ),
+        ConfigField(
+            name="update_task",
+            label="Update Task",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable updating existing tasks with new properties",
+        ),
+        ConfigField(
+            name="close_task",
+            label="Close Task",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable marking tasks as completed",
+        ),
+        ConfigField(
+            name="delete_task",
+            label="Delete Task",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable deleting tasks from Todoist",
+        ),
+        ConfigField(
+            name="get_active_tasks",
+            label="Get Active Tasks",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving all active (non-completed) tasks",
+        ),
+        ConfigField(
+            name="get_projects",
+            label="Get Projects",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving all projects in Todoist",
+        ),
+    ],
+    dependencies=["todoist-api-python"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/todoist",
+)
+def todoist_tools() -> type[TodoistTools]:
+    """Return Todoist tools for task management."""
+    from agno.tools.todoist import TodoistTools
+
+    return TodoistTools

mindroom/tools/trello.py

@@ -0,0 +1,121 @@
+"""Trello 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.trello import TrelloTools
+
+
+@register_tool_with_metadata(
+    name="trello",
+    display_name="Trello",
+    description="Project board management with Trello API integration",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="SiTrello",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="your_trello_api_key",
+            description="Trello API key (can also be set via TRELLO_API_KEY env var)",
+        ),
+        ConfigField(
+            name="api_secret",
+            label="API Secret",
+            type="password",
+            required=False,
+            placeholder="your_trello_api_secret",
+            description="Trello API secret (can also be set via TRELLO_API_SECRET env var)",
+        ),
+        ConfigField(
+            name="token",
+            label="Token",
+            type="password",
+            required=False,
+            placeholder="your_trello_token",
+            description="Trello token (can also be set via TRELLO_TOKEN env var)",
+        ),
+        # Card operations
+        ConfigField(
+            name="create_card",
+            label="Create Card",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable creating new cards in boards and lists",
+        ),
+        ConfigField(
+            name="move_card",
+            label="Move Card",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable moving cards between lists",
+        ),
+        ConfigField(
+            name="get_cards",
+            label="Get Cards",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving all cards from a list",
+        ),
+        # Board operations
+        ConfigField(
+            name="create_board",
+            label="Create Board",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable creating new Trello boards",
+        ),
+        ConfigField(
+            name="list_boards",
+            label="List Boards",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable listing all accessible Trello boards",
+        ),
+        ConfigField(
+            name="get_board_lists",
+            label="Get Board Lists",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving all lists on a board",
+        ),
+        # List operations
+        ConfigField(
+            name="create_list",
+            label="Create List",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable creating new lists on boards",
+        ),
+    ],
+    dependencies=["py-trello"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/trello",
+)
+def trello_tools() -> type[TrelloTools]:
+    """Return Trello tools for project board management."""
+    from agno.tools.trello import TrelloTools
+
+    return TrelloTools

mindroom/tools/twilio.py

@@ -0,0 +1,97 @@
+"""Twilio 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.twilio import TwilioTools
+
+
+@register_tool_with_metadata(
+    name="twilio",
+    display_name="Twilio",
+    description="SMS messaging and voice communication platform",
+    category=ToolCategory.COMMUNICATION,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaPhone",
+    icon_color="text-red-600",  # Twilio red
+    config_fields=[
+        # Authentication - Account credentials
+        ConfigField(
+            name="account_sid",
+            label="Account SID",
+            type="text",
+            required=False,
+            placeholder="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            description="Twilio Account SID (can also be set via TWILIO_ACCOUNT_SID env var)",
+        ),
+        ConfigField(
+            name="auth_token",
+            label="Auth Token",
+            type="password",
+            required=False,
+            placeholder="your_auth_token_here",
+            description="Twilio Auth Token for basic authentication (can also be set via TWILIO_AUTH_TOKEN env var)",
+        ),
+        # Alternative API Key authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="SKxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            description="Twilio API Key for key-based authentication (can also be set via TWILIO_API_KEY env var)",
+        ),
+        ConfigField(
+            name="api_secret",
+            label="API Secret",
+            type="password",
+            required=False,
+            placeholder="your_api_secret_here",
+            description="Twilio API Secret for key-based authentication (can also be set via TWILIO_API_SECRET env var)",
+        ),
+        # Connection configuration
+        ConfigField(
+            name="region",
+            label="Region",
+            type="text",
+            required=False,
+            placeholder="au1",
+            description="Optional Twilio region (e.g. 'au1' for Australia) (can also be set via TWILIO_REGION env var)",
+        ),
+        ConfigField(
+            name="edge",
+            label="Edge Location",
+            type="text",
+            required=False,
+            placeholder="sydney",
+            description="Optional Twilio edge location (e.g. 'sydney') (can also be set via TWILIO_EDGE env var)",
+        ),
+        # Feature configuration
+        ConfigField(
+            name="debug",
+            label="Debug Mode",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable debug logging for Twilio HTTP client",
+        ),
+    ],
+    dependencies=["twilio"],
+    docs_url="https://docs.agno.com/tools/toolkits/social/twilio",
+)
+def twilio_tools() -> type[TwilioTools]:
+    """Return Twilio tools for SMS messaging and voice communication."""
+    from agno.tools.twilio import TwilioTools
+
+    return TwilioTools

mindroom/tools/web_browser_tools.py

@@ -0,0 +1,37 @@
+"""Web Browser Tools 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.webbrowser import WebBrowserTools
+
+
+@register_tool_with_metadata(
+    name="web_browser_tools",
+    display_name="Web Browser Tools",
+    description="Open URLs in web browser tabs or windows",
+    category=ToolCategory.DEVELOPMENT,  # From docs URL: /tools/toolkits/others/
+    status=ToolStatus.AVAILABLE,  # No configuration required
+    setup_type=SetupType.NONE,  # No authentication needed
+    icon="FaGlobe",
+    icon_color="text-blue-600",  # Web browser blue
+    config_fields=[
+        # No configuration parameters - WebBrowserTools.__init__() takes no arguments
+    ],
+    dependencies=[],  # Uses standard library webbrowser module
+    docs_url="https://docs.agno.com/tools/toolkits/others/web-browser",
+)
+def web_browser_tools() -> type[WebBrowserTools]:
+    """Return Web Browser Tools for opening URLs."""
+    from agno.tools.webbrowser import WebBrowserTools
+
+    return WebBrowserTools

mindroom/tools/webex.py

@@ -0,0 +1,63 @@
+"""Webex 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.webex import WebexTools
+
+
+@register_tool_with_metadata(
+    name="webex",
+    display_name="Webex",
+    description="Video conferencing and messaging platform for teams",
+    category=ToolCategory.COMMUNICATION,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaVideo",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="access_token",
+            label="Access Token",
+            type="password",
+            required=False,
+            placeholder="Bearer token from Webex Developer Portal",
+            description="Webex access token for authentication (can also be set via WEBEX_ACCESS_TOKEN env var)",
+        ),
+        # Feature flags
+        ConfigField(
+            name="send_message",
+            label="Send Message",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable sending messages to Webex spaces/rooms",
+        ),
+        ConfigField(
+            name="list_rooms",
+            label="List Rooms",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable listing Webex spaces/rooms",
+        ),
+    ],
+    dependencies=["webexpythonsdk"],
+    docs_url="https://docs.agno.com/tools/toolkits/social/webex",
+)
+def webex_tools() -> type[WebexTools]:
+    """Return Webex tools for video conferencing and messaging."""
+    from agno.tools.webex import WebexTools
+
+    return WebexTools

mindroom/tools/website.py

@@ -0,0 +1,45 @@
+"""Website tools 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.website import WebsiteTools
+
+
+@register_tool_with_metadata(
+    name="website",
+    display_name="Website Tools",
+    description="Web scraping and content extraction from websites",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaGlobe",
+    icon_color="text-blue-600",
+    config_fields=[
+        ConfigField(
+            name="knowledge_base",
+            label="Knowledge Base",
+            type="text",
+            required=False,
+            default=None,
+            description="Advanced: Optional knowledge base instance for storing website content (WebsiteKnowledgeBase or CombinedKnowledgeBase)",
+        ),
+    ],
+    dependencies=["httpx", "beautifulsoup4"],
+    docs_url="https://docs.agno.com/tools/toolkits/web_scrape/website",
+)
+def website_tools() -> type[WebsiteTools]:
+    """Return website tools for web scraping and content extraction."""
+    from agno.tools.website import WebsiteTools
+
+    return WebsiteTools

mindroom/tools/whatsapp.py

@@ -0,0 +1,81 @@
+"""WhatsApp 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.whatsapp import WhatsAppTools
+
+
+@register_tool_with_metadata(
+    name="whatsapp",
+    display_name="WhatsApp Business",
+    description="Send text and template messages via WhatsApp Business API",
+    category=ToolCategory.COMMUNICATION,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaWhatsapp",
+    icon_color="text-green-500",
+    config_fields=[
+        # Authentication/Connection parameters first
+        ConfigField(
+            name="access_token",
+            label="Access Token",
+            type="password",
+            required=False,
+            placeholder="EAAxxxxxxx...",
+            description="WhatsApp Business API access token (can also be set via WHATSAPP_ACCESS_TOKEN env var)",
+        ),
+        ConfigField(
+            name="phone_number_id",
+            label="Phone Number ID",
+            type="text",
+            required=False,
+            placeholder="1234567890123456",
+            description="WhatsApp Business Account phone number ID (can also be set via WHATSAPP_PHONE_NUMBER_ID env var)",
+        ),
+        ConfigField(
+            name="version",
+            label="API Version",
+            type="text",
+            required=False,
+            default="v22.0",
+            placeholder="v22.0",
+            description="WhatsApp API version to use",
+        ),
+        ConfigField(
+            name="recipient_waid",
+            label="Default Recipient WhatsApp ID",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="+1234567890",
+            description="Default recipient WhatsApp ID or phone number (optional, can also be set via WHATSAPP_RECIPIENT_WAID env var)",
+        ),
+        # Feature flags/boolean parameters
+        ConfigField(
+            name="async_mode",
+            label="Async Mode",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable asynchronous message sending",
+        ),
+    ],
+    dependencies=["httpx"],
+    docs_url="https://docs.agno.com/tools/toolkits/social/whatsapp",
+)
+def whatsapp_tools() -> type[WhatsAppTools]:
+    """Return WhatsApp Business API tools for messaging."""
+    from agno.tools.whatsapp import WhatsAppTools
+
+    return WhatsAppTools

mindroom/tools/wikipedia.py

@@ -0,0 +1,45 @@
+"""Wikipedia 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.wikipedia import WikipediaTools
+
+
+@register_tool_with_metadata(
+    name="wikipedia",
+    display_name="Wikipedia",
+    description="Search and retrieve information from Wikipedia",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaWikipediaW",
+    icon_color="text-gray-700",
+    config_fields=[
+        ConfigField(
+            name="knowledge_base",
+            label="Knowledge Base",
+            type="text",
+            required=False,
+            default=None,
+            description="Optional WikipediaKnowledgeBase instance for advanced usage (typically left empty)",
+        ),
+    ],
+    dependencies=["wikipedia"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/wikipedia",
+)
+def wikipedia_tools() -> type[WikipediaTools]:
+    """Return Wikipedia tools for searching and retrieving information."""
+    from agno.tools.wikipedia import WikipediaTools
+
+    return WikipediaTools

mindroom/tools/x.py

@@ -0,0 +1,97 @@
+"""X (Twitter) 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.x import XTools
+
+
+@register_tool_with_metadata(
+    name="x",
+    display_name="X (Twitter)",
+    description="Post tweets, send DMs, and search Twitter/X content",
+    category=ToolCategory.SOCIAL,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaTwitter",
+    icon_color="text-blue-400",
+    config_fields=[
+        # Authentication/Connection parameters first
+        ConfigField(
+            name="bearer_token",
+            label="Bearer Token",
+            type="password",
+            required=False,
+            placeholder="AAA...",
+            description="Twitter API Bearer token (can also be set via X_BEARER_TOKEN env var)",
+        ),
+        ConfigField(
+            name="consumer_key",
+            label="Consumer Key",
+            type="password",
+            required=False,
+            placeholder="consumer_key...",
+            description="Twitter API consumer key (can also be set via X_CONSUMER_KEY env var)",
+        ),
+        ConfigField(
+            name="consumer_secret",
+            label="Consumer Secret",
+            type="password",
+            required=False,
+            placeholder="consumer_secret...",
+            description="Twitter API consumer secret (can also be set via X_CONSUMER_SECRET env var)",
+        ),
+        ConfigField(
+            name="access_token",
+            label="Access Token",
+            type="password",
+            required=False,
+            placeholder="access_token...",
+            description="Twitter API access token (can also be set via X_ACCESS_TOKEN env var)",
+        ),
+        ConfigField(
+            name="access_token_secret",
+            label="Access Token Secret",
+            type="password",
+            required=False,
+            placeholder="access_token_secret...",
+            description="Twitter API access token secret (can also be set via X_ACCESS_TOKEN_SECRET env var)",
+        ),
+        # Feature flags/boolean parameters grouped by functionality
+        # Search and content features
+        ConfigField(
+            name="include_post_metrics",
+            label="Include Post Metrics",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable including post metrics (likes, retweets, etc.) in search results",
+        ),
+        # API behavior settings
+        ConfigField(
+            name="wait_on_rate_limit",
+            label="Wait on Rate Limit",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable waiting when rate limit is reached instead of failing",
+        ),
+    ],
+    dependencies=["tweepy"],
+    docs_url="https://docs.agno.com/tools/toolkits/social/x",
+)
+def x_tools() -> type[XTools]:
+    """Return X (Twitter) tools for posting tweets and social media interaction."""
+    from agno.tools.x import XTools
+
+    return XTools