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

mindroom/tools/e2b.py

@@ -0,0 +1,121 @@
+"""E2B code execution 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.e2b import E2BTools
+
+
+@register_tool_with_metadata(
+    name="e2b",
+    display_name="E2B Code Execution",
+    description="Code execution sandbox environment with Python, file operations, and web server capabilities",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="Terminal",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="e2b_...",
+            description="E2B API key for authentication (can also be set via E2B_API_KEY env var)",
+        ),
+        # Configuration
+        ConfigField(
+            name="timeout",
+            label="Timeout",
+            type="number",
+            required=False,
+            default=300,
+            placeholder="300",
+            description="Timeout in seconds for the sandbox (default: 5 minutes)",
+        ),
+        # Code execution features
+        ConfigField(
+            name="run_code",
+            label="Run Code",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable running Python code in the sandbox",
+        ),
+        # File operations
+        ConfigField(
+            name="upload_file",
+            label="Upload File",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable uploading files to the sandbox",
+        ),
+        ConfigField(
+            name="download_result",
+            label="Download Result",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable downloading execution results (PNG images, charts, files)",
+        ),
+        # Filesystem operations
+        ConfigField(
+            name="filesystem",
+            label="Filesystem Operations",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable filesystem operations (list, read, write files and directories)",
+        ),
+        # Internet access
+        ConfigField(
+            name="internet_access",
+            label="Internet Access",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable internet access functions (public URLs, web servers)",
+        ),
+        # Sandbox management
+        ConfigField(
+            name="sandbox_management",
+            label="Sandbox Management",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable sandbox management functions (timeout, status, shutdown)",
+        ),
+        # Advanced configuration
+        ConfigField(
+            name="sandbox_options",
+            label="Sandbox Options",
+            type="text",
+            required=False,
+            placeholder='{"template": "python"}',
+            description="Additional options to pass to the Sandbox constructor (JSON format)",
+        ),
+        # Command execution
+        ConfigField(
+            name="command_execution",
+            label="Command Execution",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable shell command execution in the sandbox",
+        ),
+    ],
+    dependencies=["e2b_code_interpreter"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/e2b",
+)
+def e2b_tools() -> type[E2BTools]:
+    """Return E2B code execution tools for secure sandbox environments."""
+    from agno.tools.e2b import E2BTools
+
+    return E2BTools

mindroom/tools/eleven_labs.py

@@ -0,0 +1,77 @@
+"""Eleven Labs 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.eleven_labs import ElevenLabsTools
+
+
+@register_tool_with_metadata(
+    name="eleven_labs",
+    display_name="Eleven Labs",
+    description="Text-to-speech and sound effect generation using AI voices",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaVolumeUp",
+    icon_color="text-orange-500",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="sk-...",
+            description="Eleven Labs API key for authentication (can also be set via ELEVEN_LABS_API_KEY env var)",
+        ),
+        # Voice Configuration
+        ConfigField(
+            name="voice_id",
+            label="Voice ID",
+            type="text",
+            required=False,
+            default="JBFqnCBsd6RMkjVDRZzb",
+            placeholder="JBFqnCBsd6RMkjVDRZzb",
+            description="The voice ID to use for audio generation",
+        ),
+        ConfigField(
+            name="model_id",
+            label="Model ID",
+            type="text",
+            required=False,
+            default="eleven_multilingual_v2",
+            placeholder="eleven_multilingual_v2",
+            description="The model's ID to use for audio generation",
+        ),
+        # Output Configuration
+        ConfigField(
+            name="output_format",
+            label="Output Format",
+            type="text",
+            required=False,
+            default="mp3_44100_64",
+            placeholder="mp3_44100_64",
+            description="The output format for audio generation (e.g., mp3_44100_64, pcm_44100)",
+        ),
+        ConfigField(
+            name="target_directory",
+            label="Target Directory",
+            type="text",
+            required=False,
+            placeholder="audio_generations",
+            description="Directory to save generated audio files (optional)",
+        ),
+    ],
+    dependencies=["elevenlabs"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/eleven_labs",
+)
+def eleven_labs_tools() -> type[ElevenLabsTools]:
+    """Return Eleven Labs tools for text-to-speech and sound effect generation."""
+    from agno.tools.eleven_labs import ElevenLabsTools
+
+    return ElevenLabsTools

mindroom/tools/email.py

@@ -0,0 +1,74 @@
+"""Email 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.email import EmailTools
+
+
+@register_tool_with_metadata(
+    name="email",
+    display_name="Email",
+    description="Send emails via SMTP (Gmail)",
+    category=ToolCategory.EMAIL,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="Mail",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication/Connection parameters
+        ConfigField(
+            name="receiver_email",
+            label="Receiver Email",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="recipient@example.com",
+            description="Default recipient email address",
+        ),
+        ConfigField(
+            name="sender_name",
+            label="Sender Name",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="Your Name",
+            description="Name to display as the sender",
+        ),
+        ConfigField(
+            name="sender_email",
+            label="Sender Email",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="your.email@gmail.com",
+            description="Gmail address to send emails from",
+        ),
+        ConfigField(
+            name="sender_passkey",
+            label="Sender Password/App Password",
+            type="password",
+            required=False,
+            default=None,
+            placeholder="Gmail password or app-specific password",
+            description="Gmail password or app-specific password for authentication",
+        ),
+    ],
+    dependencies=[],  # Uses built-in smtplib
+    docs_url="https://docs.agno.com/tools/toolkits/social/email",
+)
+def email_tools() -> type[EmailTools]:
+    """Return email tools for sending messages via SMTP."""
+    from agno.tools.email import EmailTools
+
+    return EmailTools

mindroom/tools/exa.py

@@ -0,0 +1,246 @@
+"""Exa 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.exa import ExaTools
+
+
+@register_tool_with_metadata(
+    name="exa",
+    display_name="Exa",
+    description="Advanced AI-powered web search engine for research and content discovery",
+    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="exa_...",
+            description="Exa API key for authentication (can also be set via EXA_API_KEY env var)",
+        ),
+        # Tool functionality flags
+        ConfigField(
+            name="search",
+            label="Search",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable web search functionality",
+        ),
+        ConfigField(
+            name="get_contents",
+            label="Get Contents",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving detailed content from URLs",
+        ),
+        ConfigField(
+            name="find_similar",
+            label="Find Similar",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable finding similar pages to a given URL",
+        ),
+        ConfigField(
+            name="answer",
+            label="Answer",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable LLM-powered question answering with search results",
+        ),
+        ConfigField(
+            name="research",
+            label="Research",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable deep research functionality with structured output",
+        ),
+        # Content options
+        ConfigField(
+            name="text",
+            label="Text",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Retrieve text content from search results",
+        ),
+        ConfigField(
+            name="text_length_limit",
+            label="Text Length Limit",
+            type="number",
+            required=False,
+            default=1000,
+            description="Maximum length of text content per result",
+        ),
+        ConfigField(
+            name="highlights",
+            label="Highlights",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Include highlighted snippets in results",
+        ),
+        ConfigField(
+            name="summary",
+            label="Summary",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Include AI-generated summaries in results",
+        ),
+        # Search configuration
+        ConfigField(
+            name="num_results",
+            label="Number of Results",
+            type="number",
+            required=False,
+            placeholder="10",
+            description="Default number of search results to return (overrides individual searches if set)",
+        ),
+        ConfigField(
+            name="livecrawl",
+            label="Live Crawl",
+            type="text",
+            required=False,
+            default="always",
+            placeholder="always",
+            description="Live crawl setting for fresh content",
+        ),
+        # Date filtering
+        ConfigField(
+            name="start_crawl_date",
+            label="Start Crawl Date",
+            type="text",
+            required=False,
+            placeholder="2024-01-01",
+            description="Include results crawled on/after this date (YYYY-MM-DD format)",
+        ),
+        ConfigField(
+            name="end_crawl_date",
+            label="End Crawl Date",
+            type="text",
+            required=False,
+            placeholder="2024-12-31",
+            description="Include results crawled on/before this date (YYYY-MM-DD format)",
+        ),
+        ConfigField(
+            name="start_published_date",
+            label="Start Published Date",
+            type="text",
+            required=False,
+            placeholder="2024-01-01",
+            description="Include results published on/after this date (YYYY-MM-DD format)",
+        ),
+        ConfigField(
+            name="end_published_date",
+            label="End Published Date",
+            type="text",
+            required=False,
+            placeholder="2024-12-31",
+            description="Include results published on/before this date (YYYY-MM-DD format)",
+        ),
+        # Search enhancement
+        ConfigField(
+            name="use_autoprompt",
+            label="Use Autoprompt",
+            type="boolean",
+            required=False,
+            description="Enable autoprompt features to improve query understanding",
+        ),
+        ConfigField(
+            name="type",
+            label="Content Type",
+            type="text",
+            required=False,
+            placeholder="article",
+            description="Specify content type filter (e.g., article, blog, video)",
+        ),
+        ConfigField(
+            name="category",
+            label="Category",
+            type="text",
+            required=False,
+            placeholder="research paper",
+            description='Filter results by category. Options: "company", "research paper", "news", "pdf", "github", "tweet", "personal site", "linkedin profile", "financial report"',
+        ),
+        ConfigField(
+            name="include_domains",
+            label="Include Domains",
+            type="text",
+            required=False,
+            placeholder="example.com,google.com",
+            description="Comma-separated list of domains to restrict results to",
+        ),
+        ConfigField(
+            name="exclude_domains",
+            label="Exclude Domains",
+            type="text",
+            required=False,
+            placeholder="spam.com,ads.com",
+            description="Comma-separated list of domains to exclude from results",
+        ),
+        # Model settings
+        ConfigField(
+            name="model",
+            label="Search Model",
+            type="text",
+            required=False,
+            placeholder="exa",
+            description='The search model to use. Options: "exa" or "exa-pro"',
+        ),
+        ConfigField(
+            name="research_model",
+            label="Research Model",
+            type="text",
+            required=False,
+            default="exa-research",
+            placeholder="exa-research",
+            description='Model for research functionality. Options: "exa-research" or "exa-research-pro"',
+        ),
+        # System settings
+        ConfigField(
+            name="timeout",
+            label="Timeout",
+            type="number",
+            required=False,
+            default=30,
+            description="Maximum time in seconds to wait for API responses",
+        ),
+        ConfigField(
+            name="show_results",
+            label="Show Results",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Log search results for debugging purposes",
+        ),
+    ],
+    dependencies=["exa_py"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/exa",
+)
+def exa_tools() -> type[ExaTools]:
+    """Return Exa tools for AI-powered web search and research."""
+    from agno.tools.exa import ExaTools
+
+    return ExaTools

mindroom/tools/fal.py

@@ -0,0 +1,50 @@
+"""Fal 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.fal import FalTools
+
+
+@register_tool_with_metadata(
+    name="fal",
+    display_name="Fal",
+    description="AI model serving platform for media generation (images and videos)",
+    category=ToolCategory.DEVELOPMENT,  # others category maps to DEVELOPMENT
+    status=ToolStatus.REQUIRES_CONFIG,  # requires FAL_KEY API key
+    setup_type=SetupType.API_KEY,  # uses API key authentication
+    icon="FaRobot",  # AI/robot icon for AI model serving
+    icon_color="text-purple-600",  # Purple for AI/ML services
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="fal-***",
+            description="Fal API key for authentication (can also be set via FAL_KEY env var)",
+        ),
+        # Model configuration
+        ConfigField(
+            name="model",
+            label="Model",
+            type="text",
+            required=False,
+            default="fal-ai/hunyuan-video",
+            placeholder="fal-ai/hunyuan-video",
+            description="The model to use for media generation (default: fal-ai/hunyuan-video)",
+        ),
+    ],
+    dependencies=["fal-client"],  # From agno requirements
+    docs_url="https://docs.agno.com/tools/toolkits/others/fal",  # URL without .md extension
+)
+def fal_tools() -> type[FalTools]:
+    """Return Fal tools for AI model serving and media generation."""
+    from agno.tools.fal import FalTools
+
+    return FalTools

mindroom/tools/file.py

@@ -0,0 +1,80 @@
+"""File 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.file import FileTools
+
+
+@register_tool_with_metadata(
+    name="file",
+    display_name="File Tools",
+    description="Local file operations including read, write, list, and search",
+    category=ToolCategory.DEVELOPMENT,  # Local tool
+    status=ToolStatus.AVAILABLE,  # No config needed
+    setup_type=SetupType.NONE,  # No authentication required
+    icon="FaFolder",  # React icon name
+    icon_color="text-yellow-500",  # Tailwind color class
+    config_fields=[
+        # Base directory configuration
+        ConfigField(
+            name="base_dir",
+            label="Base Directory",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="/path/to/directory",
+            description="Base directory for file operations (defaults to current working directory)",
+        ),
+        # File operation controls
+        ConfigField(
+            name="save_files",
+            label="Save Files",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable file saving operations",
+        ),
+        ConfigField(
+            name="read_files",
+            label="Read Files",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable file reading operations",
+        ),
+        ConfigField(
+            name="list_files",
+            label="List Files",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable file listing operations",
+        ),
+        ConfigField(
+            name="search_files",
+            label="Search Files",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable file search operations with pattern matching",
+        ),
+    ],
+    dependencies=["agno"],  # From agno requirements
+    docs_url="https://docs.agno.com/tools/toolkits/local/file",
+)
+def file_tools() -> type[FileTools]:
+    """Return file tools for local file operations."""
+    from agno.tools.file import FileTools
+
+    return FileTools