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

mindroom/tools/google_sheets.py

@@ -0,0 +1,86 @@
+"""Google Sheets 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 mindroom.custom_tools.google_sheets import GoogleSheetsTools
+
+
+@register_tool_with_metadata(
+    name="google_sheets",
+    display_name="Google Sheets",
+    description="Read, create, update, and duplicate Google Sheets spreadsheets",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.SPECIAL,
+    auth_provider="google",  # Authentication provided by Google Services integration
+    icon="FaGoogle",
+    icon_color="text-green-600",
+    config_fields=[
+        ConfigField(
+            name="spreadsheet_id",
+            label="Spreadsheet ID",
+            type="text",
+            required=False,
+            placeholder="Leave empty to work with multiple spreadsheets",
+            description="The ID of the Google Spreadsheet to work with. If not specified, you can work with multiple spreadsheets.",
+        ),
+        ConfigField(
+            name="spreadsheet_range",
+            label="Default Range",
+            type="text",
+            required=False,
+            placeholder="e.g., Sheet1!A1:Z100",
+            description="Default range to use for operations (optional)",
+        ),
+        ConfigField(
+            name="read",
+            label="Enable Read Operations",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow reading data from spreadsheets",
+        ),
+        ConfigField(
+            name="create",
+            label="Enable Create Operations",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Allow creating new spreadsheets",
+        ),
+        ConfigField(
+            name="update",
+            label="Enable Update Operations",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Allow updating existing spreadsheets",
+        ),
+        ConfigField(
+            name="duplicate",
+            label="Enable Duplicate Operations",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Allow duplicating spreadsheets",
+        ),
+    ],
+    dependencies=["google-api-python-client", "google-auth-httplib2", "google-auth-oauthlib"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/google_sheets",
+)
+def google_sheets_tools() -> type[GoogleSheetsTools]:
+    """Return Google Sheets tools for spreadsheet integration."""
+    from mindroom.custom_tools.google_sheets import GoogleSheetsTools
+
+    return GoogleSheetsTools

mindroom/tools/googlesearch.py

@@ -0,0 +1,83 @@
+"""Google Search 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.googlesearch import GoogleSearchTools
+
+
+@register_tool_with_metadata(
+    name="googlesearch",
+    display_name="Google Search",
+    description="Search Google for web results using Python library",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaGoogle",
+    icon_color="text-blue-500",
+    config_fields=[
+        # Search configuration
+        ConfigField(
+            name="fixed_max_results",
+            label="Fixed Max Results",
+            type="number",
+            required=False,
+            default=None,
+            placeholder="10",
+            description="Fixed number of maximum search results to return (overrides per-query max_results)",
+        ),
+        ConfigField(
+            name="fixed_language",
+            label="Fixed Language",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="en",
+            description="Fixed language for search results (overrides per-query language setting)",
+        ),
+        ConfigField(
+            name="proxy",
+            label="Proxy",
+            type="url",
+            required=False,
+            default=None,
+            placeholder="http://proxy.example.com:8080",
+            description="Proxy server for search requests",
+        ),
+        ConfigField(
+            name="timeout",
+            label="Request Timeout",
+            type="number",
+            required=False,
+            default=10,
+            placeholder="10",
+            description="Timeout for search requests in seconds",
+        ),
+        ConfigField(
+            name="headers",
+            label="Custom Headers",
+            type="text",
+            required=False,
+            default=None,
+            placeholder='{"User-Agent": "Custom Agent"}',
+            description="Custom headers for search requests (JSON format)",
+        ),
+    ],
+    dependencies=["googlesearch-python", "pycountry"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/googlesearch",
+)
+def googlesearch_tools() -> type[GoogleSearchTools]:
+    """Return Google Search tools for web search."""
+    from agno.tools.googlesearch import GoogleSearchTools
+
+    return GoogleSearchTools

mindroom/tools/groq.py

@@ -0,0 +1,77 @@
+"""Groq 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.models.groq import GroqTools
+
+
+@register_tool_with_metadata(
+    name="groq",
+    display_name="Groq",
+    description="Fast AI inference for audio transcription, translation, and text-to-speech",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="TbBrain",
+    icon_color="text-orange-500",  # Groq brand orange
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="gsk_...",
+            description="Groq API key for authentication (can also be set via GROQ_API_KEY env var)",
+        ),
+        # Model Configuration
+        ConfigField(
+            name="transcription_model",
+            label="Transcription Model",
+            type="text",
+            required=False,
+            default="whisper-large-v3",
+            placeholder="whisper-large-v3",
+            description="Whisper model to use for audio transcription",
+        ),
+        ConfigField(
+            name="translation_model",
+            label="Translation Model",
+            type="text",
+            required=False,
+            default="whisper-large-v3",
+            placeholder="whisper-large-v3",
+            description="Whisper model to use for audio translation to English",
+        ),
+        ConfigField(
+            name="tts_model",
+            label="Text-to-Speech Model",
+            type="text",
+            required=False,
+            default="playai-tts",
+            placeholder="playai-tts",
+            description="Model to use for text-to-speech generation",
+        ),
+        ConfigField(
+            name="tts_voice",
+            label="TTS Voice",
+            type="text",
+            required=False,
+            default="Chip-PlayAI",
+            placeholder="Chip-PlayAI",
+            description="Voice to use for text-to-speech generation",
+        ),
+    ],
+    dependencies=["groq"],
+    docs_url="https://docs.agno.com/tools/toolkits/models/groq",
+)
+def groq_tools() -> type[GroqTools]:
+    """Return Groq AI tools for fast audio transcription, translation, and text-to-speech."""
+    from agno.tools.models.groq import GroqTools
+
+    return GroqTools

mindroom/tools/hackernews.py

@@ -0,0 +1,54 @@
+"""Hacker News 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.hackernews import HackerNewsTools
+
+
+@register_tool_with_metadata(
+    name="hackernews",
+    display_name="Hacker News",
+    description="Get top stories and user details from Hacker News",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaHackerNews",
+    icon_color="text-orange-600",  # Hacker News orange
+    config_fields=[
+        # Feature flags
+        ConfigField(
+            name="get_top_stories",
+            label="Get Top Stories",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable getting top stories from Hacker News",
+        ),
+        ConfigField(
+            name="get_user_details",
+            label="Get User Details",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable getting user details from Hacker News",
+        ),
+    ],
+    dependencies=["httpx"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/hackernews",
+)
+def hackernews_tools() -> type[HackerNewsTools]:
+    """Return Hacker News tools for getting stories and user details."""
+    from agno.tools.hackernews import HackerNewsTools
+
+    return HackerNewsTools

mindroom/tools/jina.py

@@ -0,0 +1,108 @@
+"""Jina Reader 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.jina import JinaReaderTools
+
+
+@register_tool_with_metadata(
+    name="jina",
+    display_name="Jina Reader",
+    description="Web content reading and search using Jina AI Reader API",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaGlobe",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication/Connection parameters first
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="jina_...",
+            description="API key for Jina Reader (can also be set via JINA_API_KEY env var)",
+        ),
+        ConfigField(
+            name="base_url",
+            label="Base URL",
+            type="url",
+            required=False,
+            default="https://r.jina.ai/",
+            placeholder="https://r.jina.ai/",
+            description="Base URL for Jina Reader API",
+        ),
+        ConfigField(
+            name="search_url",
+            label="Search URL",
+            type="url",
+            required=False,
+            default="https://s.jina.ai/",
+            placeholder="https://s.jina.ai/",
+            description="Search URL for Jina Reader API",
+        ),
+        # Configuration parameters
+        ConfigField(
+            name="max_content_length",
+            label="Max Content Length",
+            type="number",
+            required=False,
+            default=10000,
+            description="Maximum content length in characters",
+        ),
+        ConfigField(
+            name="timeout",
+            label="Timeout",
+            type="number",
+            required=False,
+            placeholder="30",
+            description="Timeout for Jina Reader API requests in seconds",
+        ),
+        # Feature flags grouped by functionality
+        # URL Reading Features
+        ConfigField(
+            name="read_url",
+            label="Read URL",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable URL reading functionality",
+        ),
+        # Search Features
+        ConfigField(
+            name="search_query",
+            label="Search Query",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable web search functionality",
+        ),
+        ConfigField(
+            name="search_query_content",
+            label="Search Query Content",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Include full URL content in search results",
+        ),
+    ],
+    dependencies=["httpx", "pydantic"],
+    docs_url="https://docs.agno.com/tools/toolkits/web_scrape/jina_reader",
+)
+def jina_tools() -> type[JinaReaderTools]:
+    """Return Jina Reader tools for web content reading and search."""
+    from agno.tools.jina import JinaReaderTools
+
+    return JinaReaderTools

mindroom/tools/jira.py

@@ -0,0 +1,70 @@
+"""Jira 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.jira import JiraTools
+
+
+@register_tool_with_metadata(
+    name="jira",
+    display_name="Jira",
+    description="Issue tracking and project management",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaTicketAlt",
+    icon_color="text-blue-600",  # Jira blue
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="server_url",
+            label="Server URL",
+            type="url",
+            required=True,
+            placeholder="https://your-domain.atlassian.net",
+            description="The URL of the JIRA server (can also be set via JIRA_SERVER_URL env var)",
+        ),
+        ConfigField(
+            name="username",
+            label="Username",
+            type="text",
+            required=False,
+            placeholder="your.email@company.com",
+            description="The JIRA username for authentication (can also be set via JIRA_USERNAME env var)",
+        ),
+        ConfigField(
+            name="password",
+            label="Password",
+            type="password",
+            required=False,
+            placeholder="your-password",
+            description="The JIRA password for authentication (can also be set via JIRA_PASSWORD env var)",
+        ),
+        ConfigField(
+            name="token",
+            label="API Token",
+            type="password",
+            required=False,
+            placeholder="your-api-token",
+            description="The JIRA API token for authentication (can also be set via JIRA_TOKEN env var)",
+        ),
+    ],
+    dependencies=["jira"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/jira",
+)
+def jira_tools() -> type[JiraTools]:
+    """Return Jira tools for issue tracking and project management."""
+    from agno.tools.jira import JiraTools
+
+    return JiraTools

mindroom/tools/linear.py

@@ -0,0 +1,103 @@
+"""Linear 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.linear import LinearTools
+
+
+@register_tool_with_metadata(
+    name="linear",
+    display_name="Linear",
+    description="Issue tracking and project management",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaLinear",
+    icon_color="text-purple-600",
+    config_fields=[
+        # User operations
+        ConfigField(
+            name="get_user_details",
+            label="Get User Details",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable fetching authenticated user details",
+        ),
+        ConfigField(
+            name="get_teams_details",
+            label="Get Teams Details",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable fetching team details for the authenticated user",
+        ),
+        # Issue operations
+        ConfigField(
+            name="get_issue_details",
+            label="Get Issue Details",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving details of specific issues by ID",
+        ),
+        ConfigField(
+            name="create_issue",
+            label="Create Issue",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable creating new issues within teams and projects",
+        ),
+        ConfigField(
+            name="update_issue",
+            label="Update Issue",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable updating issue titles and states",
+        ),
+        ConfigField(
+            name="get_user_assigned_issues",
+            label="Get User Assigned Issues",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving issues assigned to specific users",
+        ),
+        ConfigField(
+            name="get_workflow_issues",
+            label="Get Workflow Issues",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving issues within specific workflow states",
+        ),
+        ConfigField(
+            name="get_high_priority_issues",
+            label="Get High Priority Issues",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable retrieving issues with high priority (priority <= 2)",
+        ),
+    ],
+    dependencies=["requests"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/linear",
+)
+def linear_tools() -> type[LinearTools]:
+    """Return Linear tools for issue tracking and project management."""
+    from agno.tools.linear import LinearTools
+
+    return LinearTools

mindroom/tools/linkup.py

@@ -0,0 +1,65 @@
+"""Linkup 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.linkup import LinkupTools
+
+
+@register_tool_with_metadata(
+    name="linkup",
+    display_name="Linkup",
+    description="Web search using Linkup API for real-time 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="linkup_...",
+            description="Linkup API key for authentication (can also be set via LINKUP_API_KEY env var)",
+        ),
+        # Search configuration
+        ConfigField(
+            name="depth",
+            label="Search Depth",
+            type="text",
+            required=False,
+            default="standard",
+            placeholder="standard",
+            description="Depth of the search. Use 'standard' for fast and affordable web search or 'deep' for comprehensive, in-depth web search",
+        ),
+        ConfigField(
+            name="output_type",
+            label="Output Type",
+            type="text",
+            required=False,
+            default="searchResults",
+            placeholder="searchResults",
+            description="Type of output. 'sourcedAnswer' provides a comprehensive natural language answer with citations, 'searchResults' returns raw search context data",
+        ),
+    ],
+    dependencies=["linkup-sdk"],
+    docs_url="https://docs.agno.com/tools/toolkits/search/linkup",
+)
+def linkup_tools() -> type[LinkupTools]:
+    """Return Linkup tools for web search."""
+    from agno.tools.linkup import LinkupTools
+
+    return LinkupTools