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

mindroom/tools/pubmed.py

@@ -0,0 +1,64 @@
+"""PubMed 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.pubmed import PubmedTools
+
+
+@register_tool_with_metadata(
+    name="pubmed",
+    display_name="PubMed",
+    description="Search and retrieve medical and life science literature from PubMed",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaStethoscope",
+    icon_color="text-blue-600",  # Medical blue
+    config_fields=[
+        # Configuration parameters
+        ConfigField(
+            name="email",
+            label="Email Address",
+            type="text",
+            required=False,
+            default="your_email@example.com",
+            placeholder="researcher@institution.edu",
+            description="Email address for NCBI API identification (required by NCBI guidelines)",
+        ),
+        ConfigField(
+            name="max_results",
+            label="Maximum Results",
+            type="number",
+            required=False,
+            default=None,
+            placeholder="10",
+            description="Default maximum number of search results to return (can be overridden per search)",
+        ),
+        ConfigField(
+            name="results_expanded",
+            label="Expanded Results",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Return comprehensive article metadata including keywords, MeSH terms, and full abstracts",
+        ),
+    ],
+    dependencies=["httpx"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/pubmed",
+)
+def pubmed_tools() -> type[PubmedTools]:
+    """Return PubMed tools for medical research and literature search."""
+    from agno.tools.pubmed import PubmedTools
+
+    return PubmedTools

mindroom/tools/python.py

@@ -0,0 +1,120 @@
+"""Python 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.python import PythonTools
+
+
+@register_tool_with_metadata(
+    name="python",
+    display_name="Python Tools",
+    description="Execute Python code, manage files, and install packages",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaPython",
+    icon_color="text-blue-500",
+    config_fields=[
+        # Base configuration
+        ConfigField(
+            name="base_dir",
+            label="Base Directory",
+            type="text",
+            required=False,
+            placeholder="/path/to/working/directory",
+            description="Base directory for file operations (defaults to current working directory)",
+        ),
+        # Execution environment
+        ConfigField(
+            name="safe_globals",
+            label="Safe Globals",
+            type="text",
+            required=False,
+            description="Custom global scope for code execution (advanced users only)",
+        ),
+        ConfigField(
+            name="safe_locals",
+            label="Safe Locals",
+            type="text",
+            required=False,
+            description="Custom local scope for code execution (advanced users only)",
+        ),
+        # Core functionality
+        ConfigField(
+            name="save_and_run",
+            label="Save and Run Files",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable saving Python code to files and executing them",
+        ),
+        ConfigField(
+            name="run_code",
+            label="Run Code",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable direct execution of Python code in memory",
+        ),
+        # File operations
+        ConfigField(
+            name="read_files",
+            label="Read Files",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable reading file contents",
+        ),
+        ConfigField(
+            name="list_files",
+            label="List Files",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable listing files in the base directory",
+        ),
+        ConfigField(
+            name="run_files",
+            label="Run Files",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable running existing Python files",
+        ),
+        # Package management
+        ConfigField(
+            name="pip_install",
+            label="Pip Install",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable installing packages using pip",
+        ),
+        ConfigField(
+            name="uv_pip_install",
+            label="UV Pip Install",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable installing packages using uv pip",
+        ),
+    ],
+    dependencies=["agno"],
+    docs_url="https://docs.agno.com/tools/toolkits/local/python",
+)
+def python_tools() -> type[PythonTools]:
+    """Return Python tools for code execution and file management."""
+    from agno.tools.python import PythonTools
+
+    return PythonTools

mindroom/tools/reddit.py

@@ -0,0 +1,155 @@
+"""Reddit 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.reddit import RedditTools
+
+
+@register_tool_with_metadata(
+    name="reddit",
+    display_name="Reddit",
+    description="Social media platform for browsing, posting, and interacting with Reddit communities",
+    category=ToolCategory.SOCIAL,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaReddit",
+    icon_color="text-orange-500",  # Reddit's signature orange color
+    config_fields=[
+        # Reddit instance parameter
+        ConfigField(
+            name="reddit_instance",
+            label="Reddit Instance",
+            type="text",
+            required=False,
+            default=None,
+            description="Pre-configured Reddit instance (optional, will create one if not provided)",
+        ),
+        # Authentication parameters
+        ConfigField(
+            name="client_id",
+            label="Client ID",
+            type="text",
+            required=False,
+            placeholder="your_client_id",
+            description="Reddit API client ID (can also be set via REDDIT_CLIENT_ID env var)",
+        ),
+        ConfigField(
+            name="client_secret",
+            label="Client Secret",
+            type="password",
+            required=False,
+            placeholder="your_client_secret",
+            description="Reddit API client secret (can also be set via REDDIT_CLIENT_SECRET env var)",
+        ),
+        ConfigField(
+            name="user_agent",
+            label="User Agent",
+            type="text",
+            required=False,
+            default="RedditTools v1.0",
+            placeholder="MyApp v1.0",
+            description="User agent string for API requests (can also be set via REDDIT_USER_AGENT env var)",
+        ),
+        ConfigField(
+            name="username",
+            label="Username",
+            type="text",
+            required=False,
+            placeholder="your_reddit_username",
+            description="Reddit username for authenticated actions (can also be set via REDDIT_USERNAME env var)",
+        ),
+        ConfigField(
+            name="password",
+            label="Password",
+            type="password",
+            required=False,
+            placeholder="your_reddit_password",
+            description="Reddit password for authenticated actions (can also be set via REDDIT_PASSWORD env var)",
+        ),
+        # Feature flags grouped by functionality
+        # User and community information
+        ConfigField(
+            name="get_user_info",
+            label="Get User Info",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable getting information about Reddit users",
+        ),
+        ConfigField(
+            name="get_top_posts",
+            label="Get Top Posts",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable getting top posts from subreddits",
+        ),
+        ConfigField(
+            name="get_subreddit_info",
+            label="Get Subreddit Info",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable getting information about subreddits",
+        ),
+        ConfigField(
+            name="get_trending_subreddits",
+            label="Get Trending Subreddits",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable getting currently trending subreddits",
+        ),
+        ConfigField(
+            name="get_subreddit_stats",
+            label="Get Subreddit Stats",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable getting statistics about subreddits",
+        ),
+        # Content creation and interaction
+        ConfigField(
+            name="create_post",
+            label="Create Post",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable creating new posts in subreddits",
+        ),
+        ConfigField(
+            name="reply_to_post",
+            label="Reply to Post",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable replying to existing posts",
+        ),
+        ConfigField(
+            name="reply_to_comment",
+            label="Reply to Comment",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable replying to existing comments",
+        ),
+    ],
+    dependencies=["praw"],
+    docs_url=None,
+)
+def reddit_tools() -> type[RedditTools]:
+    """Return Reddit tools for social media interaction."""
+    from agno.tools.reddit import RedditTools
+
+    return RedditTools

mindroom/tools/replicate.py

@@ -0,0 +1,56 @@
+"""Replicate 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.replicate import ReplicateTools
+
+
+@register_tool_with_metadata(
+    name="replicate",
+    display_name="Replicate",
+    description="Generate images and videos using AI models on the Replicate platform",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaVideo",
+    icon_color="text-purple-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="r8_...",
+            description="Replicate API token (can also be set via REPLICATE_API_TOKEN env var)",
+        ),
+        # Model configuration
+        ConfigField(
+            name="model",
+            label="Model",
+            type="text",
+            required=False,
+            default="minimax/video-01",
+            placeholder="minimax/video-01",
+            description="The Replicate model to use for media generation",
+        ),
+    ],
+    dependencies=["replicate"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/replicate",
+)
+def replicate_tools() -> type[ReplicateTools]:
+    """Return Replicate tools for AI media generation."""
+    from agno.tools.replicate import ReplicateTools
+
+    return ReplicateTools

mindroom/tools/resend.py

@@ -0,0 +1,55 @@
+"""Resend 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.resend import ResendTools
+
+
+@register_tool_with_metadata(
+    name="resend",
+    display_name="Resend",
+    description="Email delivery service for sending transactional emails",
+    category=ToolCategory.EMAIL,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="Mail",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="re_...",
+            description="Resend API key for authentication (can also be set via RESEND_API_KEY env var)",
+        ),
+        # Configuration
+        ConfigField(
+            name="from_email",
+            label="From Email",
+            type="text",
+            required=False,
+            placeholder="noreply@example.com",
+            description="Default sender email address for outgoing emails",
+        ),
+    ],
+    dependencies=["resend"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/resend",
+)
+def resend_tools() -> type[ResendTools]:
+    """Return Resend email tools for sending transactional emails."""
+    from agno.tools.resend import ResendTools
+
+    return ResendTools

mindroom/tools/scrapegraph.py

@@ -0,0 +1,87 @@
+"""ScrapeGraph 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.scrapegraph import ScrapeGraphTools
+
+
+@register_tool_with_metadata(
+    name="scrapegraph",
+    display_name="ScrapeGraph",
+    description="Extract structured data from webpages using AI and natural language prompts",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaGlobe",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="sgai_...",
+            description="ScrapeGraph API key for enhanced services (can also be set via SGAI_API_KEY env var)",
+        ),
+        # Tool features
+        ConfigField(
+            name="smartscraper",
+            label="Smart Scraper",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable AI-powered data extraction using natural language prompts",
+        ),
+        ConfigField(
+            name="markdownify",
+            label="Markdownify",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable webpage to markdown conversion",
+        ),
+        ConfigField(
+            name="crawl",
+            label="Crawl",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable website crawling and structured data extraction",
+        ),
+        ConfigField(
+            name="searchscraper",
+            label="Search Scraper",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable web search and information extraction",
+        ),
+        ConfigField(
+            name="agentic_crawler",
+            label="Agentic Crawler",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable automated browser actions and optional AI extraction",
+        ),
+    ],
+    dependencies=["scrapegraph-py"],
+    docs_url="https://docs.agno.com/tools/toolkits/web_scrape/scrapegraph",
+)
+def scrapegraph_tools() -> type[ScrapeGraphTools]:
+    """Return ScrapeGraph tools for web data extraction."""
+    from agno.tools.scrapegraph import ScrapeGraphTools
+
+    return ScrapeGraphTools

mindroom/tools/searxng.py

@@ -0,0 +1,120 @@
+"""Searxng 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.searxng import Searxng
+
+
+@register_tool_with_metadata(
+    name="searxng",
+    display_name="SearxNG",
+    description="Open source search engine for web, images, news, science, and specialized content",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.NONE,
+    icon="FaSearch",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Connection configuration
+        ConfigField(
+            name="host",
+            label="Host URL",
+            type="url",
+            required=True,
+            placeholder="http://localhost:8080",
+            description="The host for the SearxNG instance connection",
+        ),
+        ConfigField(
+            name="engines",
+            label="Search Engines",
+            type="text",
+            required=False,
+            default="",
+            placeholder="google,bing,duckduckgo",
+            description="Comma-separated list of search engines to use (leave empty for default)",
+        ),
+        ConfigField(
+            name="fixed_max_results",
+            label="Fixed Max Results",
+            type="number",
+            required=False,
+            placeholder="10",
+            description="Optional parameter to specify the fixed maximum number of results",
+        ),
+        # Content type enablement flags
+        ConfigField(
+            name="images",
+            label="Enable Image Search",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching for images",
+        ),
+        ConfigField(
+            name="it",
+            label="Enable IT Search",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching for IT-related content",
+        ),
+        ConfigField(
+            name="map",
+            label="Enable Map Search",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching for maps",
+        ),
+        ConfigField(
+            name="music",
+            label="Enable Music Search",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching for music",
+        ),
+        ConfigField(
+            name="news",
+            label="Enable News Search",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching for news",
+        ),
+        ConfigField(
+            name="science",
+            label="Enable Science Search",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching for science-related content",
+        ),
+        ConfigField(
+            name="videos",
+            label="Enable Video Search",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching for videos",
+        ),
+    ],
+    dependencies=[],  # httpx already included in main dependencies
+    docs_url="https://docs.agno.com/tools/toolkits/search/searxng",
+)
+def searxng_tools() -> type[Searxng]:
+    """Return SearxNG search tools for web, images, news, and specialized content search."""
+    from agno.tools.searxng import Searxng
+
+    return Searxng