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

mindroom/tools/cartesia.py

@@ -0,0 +1,84 @@
+"""Cartesia 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.cartesia import CartesiaTools
+
+
+@register_tool_with_metadata(
+    name="cartesia",
+    display_name="Cartesia",
+    description="Voice AI services including text-to-speech and voice localization",
+    category=ToolCategory.DEVELOPMENT,  # others/ → DEVELOPMENT according to mapping
+    status=ToolStatus.REQUIRES_CONFIG,  # requires API key
+    setup_type=SetupType.API_KEY,  # API key authentication
+    icon="VolumeX",  # Voice/sound related icon
+    icon_color="text-purple-500",  # Purple for voice AI
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="your_api_key_here",
+            description="Cartesia API key for authentication (can also be set via CARTESIA_API_KEY env var)",
+        ),
+        # Model configuration
+        ConfigField(
+            name="model_id",
+            label="Model ID",
+            type="text",
+            required=False,
+            default="sonic-2",
+            placeholder="sonic-2",
+            description="The model ID to use for text-to-speech",
+        ),
+        ConfigField(
+            name="default_voice_id",
+            label="Default Voice ID",
+            type="text",
+            required=False,
+            default="78ab82d5-25be-4f7d-82b3-7ad64e5b85b2",
+            placeholder="78ab82d5-25be-4f7d-82b3-7ad64e5b85b2",
+            description="The default voice ID to use for text-to-speech and localization",
+        ),
+        # Feature flags
+        ConfigField(
+            name="text_to_speech_enabled",
+            label="Text to Speech Enabled",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable text-to-speech functionality",
+        ),
+        ConfigField(
+            name="list_voices_enabled",
+            label="List Voices Enabled",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable listing available voices functionality",
+        ),
+        ConfigField(
+            name="voice_localize_enabled",
+            label="Voice Localize Enabled",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable voice localization functionality",
+        ),
+    ],
+    dependencies=["cartesia"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/cartesia",
+)
+def cartesia_tools() -> type[CartesiaTools]:
+    """Return Cartesia tools for voice AI services."""
+    from agno.tools.cartesia import CartesiaTools
+
+    return CartesiaTools

mindroom/tools/composio.py

@@ -0,0 +1,166 @@
+"""Composio 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 composio_agno import ComposioToolSet  # type: ignore[import-untyped]
+
+
+@register_tool_with_metadata(
+    name="composio",
+    display_name="Composio",
+    description="Access 1000+ integrations including Gmail, Salesforce, GitHub, and more",
+    category=ToolCategory.INTEGRATIONS,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaConnectdevelop",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication/Connection parameters first
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="comp_...",
+            description="Composio API key (can also be set via COMPOSIO_API_KEY env var)",
+        ),
+        ConfigField(
+            name="base_url",
+            label="Base URL",
+            type="url",
+            required=False,
+            description="Base URL for Composio API (leave empty for default)",
+        ),
+        ConfigField(
+            name="entity_id",
+            label="Entity ID",
+            type="text",
+            required=False,
+            default="default",
+            placeholder="default",
+            description="Entity identifier for Composio workspace",
+        ),
+        # Workspace Configuration
+        ConfigField(
+            name="workspace_id",
+            label="Workspace ID",
+            type="text",
+            required=False,
+            placeholder="workspace_123",
+            description="Workspace identifier for organizing tools and data",
+        ),
+        ConfigField(
+            name="workspace_config",
+            label="Workspace Config",
+            type="text",
+            required=False,
+            placeholder='{"type": "local"}',
+            description="JSON configuration for workspace settings",
+        ),
+        # Connection Configuration
+        ConfigField(
+            name="connected_account_ids",
+            label="Connected Account IDs",
+            type="text",
+            required=False,
+            placeholder='{"github": "account_123"}',
+            description="JSON mapping of app names to connected account IDs",
+        ),
+        # Advanced Configuration
+        ConfigField(
+            name="metadata",
+            label="Metadata",
+            type="text",
+            required=False,
+            placeholder='{"key": "value"}',
+            description="JSON metadata for tools and actions configuration",
+        ),
+        ConfigField(
+            name="processors",
+            label="Processors",
+            type="text",
+            required=False,
+            description="Custom processors configuration (JSON format)",
+        ),
+        ConfigField(
+            name="output_dir",
+            label="Output Directory",
+            type="text",
+            required=False,
+            placeholder="/path/to/output",
+            description="Directory path for output files",
+        ),
+        ConfigField(
+            name="lockfile",
+            label="Lock File Path",
+            type="text",
+            required=False,
+            placeholder="/path/to/lockfile",
+            description="Path to lock file for concurrency control",
+        ),
+        # Numerical Configuration
+        ConfigField(
+            name="max_retries",
+            label="Max Retries",
+            type="number",
+            required=False,
+            default=3,
+            description="Maximum number of retries for failed operations",
+        ),
+        ConfigField(
+            name="verbosity_level",
+            label="Verbosity Level",
+            type="number",
+            required=False,
+            placeholder="1",
+            description="Logging verbosity level (0-3, higher = more verbose)",
+        ),
+        # Feature Flags
+        ConfigField(
+            name="output_in_file",
+            label="Output in File",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable file-based output for operations",
+        ),
+        ConfigField(
+            name="allow_tracing",
+            label="Allow Tracing",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable operation tracing for debugging",
+        ),
+        ConfigField(
+            name="lock",
+            label="Enable Locking",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable file locking for concurrent operations",
+        ),
+        # Logging Configuration
+        ConfigField(
+            name="logging_level",
+            label="Logging Level",
+            type="text",
+            required=False,
+            default="INFO",
+            placeholder="INFO",
+            description="Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)",
+        ),
+    ],
+    dependencies=["composio-agno"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/composio",
+)
+def composio_tools() -> type[ComposioToolSet]:
+    """Return Composio tools for accessing 1000+ integrations."""
+    from composio_agno import ComposioToolSet
+
+    return ComposioToolSet  # type: ignore[no-any-return]

mindroom/tools/config_manager.py

@@ -0,0 +1,44 @@
+"""Config Manager 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.config_manager import ConfigManagerTools
+
+
+@register_tool_with_metadata(
+    name="config_manager",
+    display_name="Config Manager",
+    description="Build and manage MindRoom agents with expert knowledge of the system",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="Settings",
+    icon_color="text-purple-500",
+    config_fields=[
+        ConfigField(
+            name="config_path",
+            label="Configuration Path",
+            type="text",
+            required=False,
+            description="Path to the configuration file (uses default if not specified)",
+        ),
+    ],
+    dependencies=["agno", "pydantic", "yaml"],
+    docs_url="https://github.com/mindroom-ai/mindroom",
+)
+def config_manager_tools() -> type[ConfigManagerTools]:
+    """Return config manager tools for agent building."""
+    from mindroom.custom_tools.config_manager import ConfigManagerTools
+
+    return ConfigManagerTools

mindroom/tools/confluence.py

@@ -0,0 +1,73 @@
+"""Confluence 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.confluence import ConfluenceTools
+
+
+@register_tool_with_metadata(
+    name="confluence",
+    display_name="Confluence",
+    description="Atlassian wiki platform for retrieving, creating, and updating pages",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaConfluence",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Authentication/Connection parameters
+        ConfigField(
+            name="url",
+            label="Confluence URL",
+            type="url",
+            required=False,
+            placeholder="https://your-confluence-instance.atlassian.net",
+            description="Confluence instance URL (can also be set via CONFLUENCE_URL env var)",
+        ),
+        ConfigField(
+            name="username",
+            label="Username",
+            type="text",
+            required=False,
+            placeholder="your-username",
+            description="Confluence username (can also be set via CONFLUENCE_USERNAME env var)",
+        ),
+        ConfigField(
+            name="password",
+            label="Password",
+            type="password",
+            required=False,
+            placeholder="your-password",
+            description="Confluence password (can also be set via CONFLUENCE_PASSWORD env var)",
+        ),
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="your-api-key",
+            description="Confluence API key - alternative to password (can also be set via CONFLUENCE_API_KEY env var)",
+        ),
+        # Configuration options
+        ConfigField(
+            name="verify_ssl",
+            label="Verify SSL",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Whether to verify SSL certificates when connecting to Confluence",
+        ),
+    ],
+    dependencies=["atlassian-python-api"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/confluence",
+)
+def confluence_tools() -> type[ConfluenceTools]:
+    """Return Confluence tools for wiki management."""
+    from agno.tools.confluence import ConfluenceTools
+
+    return ConfluenceTools

mindroom/tools/crawl4ai.py

@@ -0,0 +1,101 @@
+"""Crawl4AI 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.crawl4ai import Crawl4aiTools
+
+
+@register_tool_with_metadata(
+    name="crawl4ai",
+    display_name="Crawl4AI",
+    description="Web crawling and scraping using the Crawl4ai library",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaSpider",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Content extraction settings
+        ConfigField(
+            name="max_length",
+            label="Max Length",
+            type="number",
+            required=False,
+            default=5000,
+            placeholder="5000",
+            description="Maximum length of the text from the webpage to be returned",
+        ),
+        ConfigField(
+            name="timeout",
+            label="Timeout",
+            type="number",
+            required=False,
+            default=60,
+            placeholder="60",
+            description="Timeout in seconds for page loading",
+        ),
+        # Content filtering settings
+        ConfigField(
+            name="use_pruning",
+            label="Use Pruning",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable content pruning to remove low-quality content",
+        ),
+        ConfigField(
+            name="pruning_threshold",
+            label="Pruning Threshold",
+            type="number",
+            required=False,
+            default=0.48,
+            placeholder="0.48",
+            description="Threshold for content pruning (0.0 to 1.0)",
+        ),
+        ConfigField(
+            name="bm25_threshold",
+            label="BM25 Threshold",
+            type="number",
+            required=False,
+            default=1.0,
+            placeholder="1.0",
+            description="Threshold for BM25 content filtering when using search queries",
+        ),
+        # Browser settings
+        ConfigField(
+            name="headless",
+            label="Headless Mode",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Run browser in headless mode (no GUI)",
+        ),
+        ConfigField(
+            name="wait_until",
+            label="Wait Until",
+            type="text",
+            required=False,
+            default="domcontentloaded",
+            placeholder="domcontentloaded",
+            description="Browser event to wait for before extracting content (domcontentloaded, load, networkidle)",
+        ),
+    ],
+    dependencies=["crawl4ai"],
+    docs_url="https://docs.agno.com/tools/toolkits/web_scrape/crawl4ai",
+)
+def crawl4ai_tools() -> type[Crawl4aiTools]:
+    """Return Crawl4AI tools for web crawling and scraping."""
+    from agno.tools.crawl4ai import Crawl4aiTools
+
+    return Crawl4aiTools

mindroom/tools/csv.py

@@ -0,0 +1,104 @@
+"""CSV toolkit 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.csv_toolkit import CsvTools
+
+
+@register_tool_with_metadata(
+    name="csv",
+    display_name="CSV Toolkit",
+    description="CSV file analysis and querying with SQL support",
+    category=ToolCategory.PRODUCTIVITY,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaFileCsv",
+    icon_color="text-green-600",
+    config_fields=[
+        # File configuration
+        ConfigField(
+            name="csvs",
+            label="CSV Files",
+            type="text",
+            required=False,
+            placeholder="/path/to/file1.csv,/path/to/file2.csv",
+            description="List of CSV file paths to work with (comma-separated)",
+        ),
+        ConfigField(
+            name="row_limit",
+            label="Row Limit",
+            type="number",
+            required=False,
+            placeholder="1000",
+            description="Maximum number of rows to read from CSV files",
+        ),
+        # Feature toggles
+        ConfigField(
+            name="read_csvs",
+            label="Read CSVs",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable reading CSV file contents",
+        ),
+        ConfigField(
+            name="list_csvs",
+            label="List CSVs",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable listing available CSV files",
+        ),
+        ConfigField(
+            name="query_csvs",
+            label="Query CSVs",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable SQL querying of CSV files (requires DuckDB)",
+        ),
+        ConfigField(
+            name="read_column_names",
+            label="Read Column Names",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable reading column names from CSV files",
+        ),
+        # DuckDB configuration
+        ConfigField(
+            name="duckdb_connection",
+            label="DuckDB Connection",
+            type="text",
+            required=False,
+            placeholder="Auto-created if not provided",
+            description="Existing DuckDB connection object (advanced usage)",
+        ),
+        ConfigField(
+            name="duckdb_kwargs",
+            label="DuckDB Arguments",
+            type="text",
+            required=False,
+            placeholder='{"memory_limit": "1GB"}',
+            description="Additional arguments for DuckDB connection (JSON format)",
+        ),
+    ],
+    dependencies=["duckdb"],
+    docs_url="https://docs.agno.com/tools/toolkits/database/csv",
+)
+def csv_tools() -> type[CsvTools]:
+    """Return CSV toolkit for data analysis and querying."""
+    from agno.tools.csv_toolkit import CsvTools
+
+    return CsvTools

mindroom/tools/custom_api.py

@@ -0,0 +1,106 @@
+"""Custom API 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.api import CustomApiTools
+
+
+@register_tool_with_metadata(
+    name="custom_api",
+    display_name="Custom API",
+    description="Make HTTP requests to any external API with customizable authentication and parameters",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="Globe",
+    icon_color="text-blue-500",
+    config_fields=[
+        # Connection parameters
+        ConfigField(
+            name="base_url",
+            label="Base URL",
+            type="url",
+            required=False,
+            default=None,
+            placeholder="https://api.example.com",
+            description="Base URL for API calls. If not provided, full URLs must be specified in endpoints",
+        ),
+        # Authentication parameters
+        ConfigField(
+            name="username",
+            label="Username",
+            type="text",
+            required=False,
+            default=None,
+            placeholder="username",
+            description="Username for basic authentication",
+        ),
+        ConfigField(
+            name="password",
+            label="Password",
+            type="password",
+            required=False,
+            default=None,
+            placeholder="password",
+            description="Password for basic authentication",
+        ),
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            default=None,
+            placeholder="sk-...",
+            description="API key for bearer token authentication",
+        ),
+        # Headers configuration
+        ConfigField(
+            name="headers",
+            label="Default Headers",
+            type="text",
+            required=False,
+            default=None,
+            placeholder='{"Content-Type": "application/json"}',
+            description="Default headers to include in requests (JSON format)",
+        ),
+        # Configuration parameters
+        ConfigField(
+            name="verify_ssl",
+            label="Verify SSL",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Whether to verify SSL certificates for HTTPS requests",
+        ),
+        ConfigField(
+            name="timeout",
+            label="Timeout",
+            type="number",
+            required=False,
+            default=30,
+            placeholder="30",
+            description="Request timeout in seconds",
+        ),
+        # Feature flags
+        ConfigField(
+            name="make_request",
+            label="Enable Make Request",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Whether to register the make_request function",
+        ),
+    ],
+    dependencies=["requests"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/custom_api",
+)
+def custom_api_tools() -> type[CustomApiTools]:
+    """Return Custom API tools for making HTTP requests to external APIs."""
+    from agno.tools.api import CustomApiTools
+
+    return CustomApiTools