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

mindroom/tools/github.py

@@ -0,0 +1,376 @@
+"""Tools registry for all available Agno tools.
+
+This module provides a centralized registry for all tools that can be used by agents.
+Tools are registered by string name and can be instantiated dynamically when loading agents.
+"""
+
+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.github import GithubTools
+
+
+@register_tool_with_metadata(
+    name="github",
+    display_name="GitHub",
+    description="Repository and issue management",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaGithub",
+    icon_color="text-gray-800",  # GitHub black
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="access_token",
+            label="Access Token",
+            type="password",
+            required=False,
+            placeholder="ghp_...",
+            description="GitHub personal access token (can also be set via GITHUB_ACCESS_TOKEN env var)",
+        ),
+        ConfigField(
+            name="base_url",
+            label="Base URL",
+            type="url",
+            required=False,
+            placeholder="https://api.github.com",
+            description="GitHub API base URL (for GitHub Enterprise)",
+        ),
+        # Repository operations
+        ConfigField(
+            name="search_repositories",
+            label="Search Repositories",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable searching for repositories",
+        ),
+        ConfigField(
+            name="list_repositories",
+            label="List Repositories",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable listing user/org repositories",
+        ),
+        ConfigField(
+            name="get_repository",
+            label="Get Repository",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting repository details",
+        ),
+        ConfigField(
+            name="create_repository",
+            label="Create Repository",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable creating new repositories",
+        ),
+        ConfigField(
+            name="delete_repository",
+            label="Delete Repository",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable deleting repositories",
+        ),
+        ConfigField(
+            name="get_repository_languages",
+            label="Get Repository Languages",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting repository language statistics",
+        ),
+        ConfigField(
+            name="get_repository_stars",
+            label="Get Repository Stars",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting repository star count",
+        ),
+        ConfigField(
+            name="get_repository_with_stats",
+            label="Get Repository with Stats",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting repository with detailed statistics",
+        ),
+        # Branch operations
+        ConfigField(
+            name="list_branches",
+            label="List Branches",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable listing repository branches",
+        ),
+        ConfigField(
+            name="create_branch",
+            label="Create Branch",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable creating new branches",
+        ),
+        ConfigField(
+            name="set_default_branch",
+            label="Set Default Branch",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable setting the default branch",
+        ),
+        ConfigField(
+            name="get_branch_content",
+            label="Get Branch Content",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting branch content",
+        ),
+        # Pull Request operations
+        ConfigField(
+            name="get_pull_request",
+            label="Get Pull Request",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting pull request details",
+        ),
+        ConfigField(
+            name="get_pull_request_changes",
+            label="Get Pull Request Changes",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting pull request file changes",
+        ),
+        ConfigField(
+            name="get_pull_request_count",
+            label="Get Pull Request Count",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting pull request count",
+        ),
+        ConfigField(
+            name="get_pull_requests",
+            label="Get Pull Requests",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable listing pull requests",
+        ),
+        ConfigField(
+            name="get_pull_request_comments",
+            label="Get Pull Request Comments",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting pull request comments",
+        ),
+        ConfigField(
+            name="create_pull_request_comment",
+            label="Create Pull Request Comment",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable creating pull request comments",
+        ),
+        ConfigField(
+            name="edit_pull_request_comment",
+            label="Edit Pull Request Comment",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable editing pull request comments",
+        ),
+        ConfigField(
+            name="get_pull_request_with_details",
+            label="Get Pull Request with Details",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting pull request with full details",
+        ),
+        ConfigField(
+            name="create_pull_request",
+            label="Create Pull Request",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable creating new pull requests",
+        ),
+        ConfigField(
+            name="create_review_request",
+            label="Create Review Request",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable requesting reviews on pull requests",
+        ),
+        # Issue operations
+        ConfigField(
+            name="create_issue",
+            label="Create Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable creating new issues",
+        ),
+        ConfigField(
+            name="list_issues",
+            label="List Issues",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable listing repository issues",
+        ),
+        ConfigField(
+            name="get_issue",
+            label="Get Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable getting issue details",
+        ),
+        ConfigField(
+            name="comment_on_issue",
+            label="Comment on Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable commenting on issues",
+        ),
+        ConfigField(
+            name="close_issue",
+            label="Close Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable closing issues",
+        ),
+        ConfigField(
+            name="reopen_issue",
+            label="Reopen Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable reopening closed issues",
+        ),
+        ConfigField(
+            name="assign_issue",
+            label="Assign Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable assigning issues to users",
+        ),
+        ConfigField(
+            name="label_issue",
+            label="Label Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable adding labels to issues",
+        ),
+        ConfigField(
+            name="list_issue_comments",
+            label="List Issue Comments",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable listing issue comments",
+        ),
+        ConfigField(
+            name="edit_issue",
+            label="Edit Issue",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable editing issue details",
+        ),
+        # File operations
+        ConfigField(
+            name="create_file",
+            label="Create File",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable creating new files in repositories",
+        ),
+        ConfigField(
+            name="get_file_content",
+            label="Get File Content",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable reading file content from repositories",
+        ),
+        ConfigField(
+            name="update_file",
+            label="Update File",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable updating files in repositories",
+        ),
+        ConfigField(
+            name="delete_file",
+            label="Delete File",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable deleting files from repositories",
+        ),
+        ConfigField(
+            name="get_directory_content",
+            label="Get Directory Content",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable listing directory contents",
+        ),
+        # Search operations
+        ConfigField(
+            name="search_code",
+            label="Search Code",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching code across repositories",
+        ),
+        ConfigField(
+            name="search_issues_and_prs",
+            label="Search Issues and PRs",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Enable searching issues and pull requests",
+        ),
+    ],
+    dependencies=["PyGithub"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/github",
+)
+def github_tools() -> type[GithubTools]:
+    """Return GitHub tools for repository management."""
+    from agno.tools.github import GithubTools
+
+    return GithubTools

mindroom/tools/gmail.py

@@ -0,0 +1,102 @@
+"""Gmail 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.gmail import GmailTools
+
+
+@register_tool_with_metadata(
+    name="gmail",
+    display_name="Gmail",
+    description="Read, search, and manage Gmail emails",
+    category=ToolCategory.EMAIL,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.SPECIAL,
+    auth_provider="google",  # Authentication provided by Google Services integration
+    icon="FaGoogle",
+    icon_color="text-red-500",
+    config_fields=[
+        ConfigField(
+            name="get_latest_emails",
+            label="Get Latest Emails",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow retrieving the latest emails",
+        ),
+        ConfigField(
+            name="get_emails_from_user",
+            label="Get Emails From User",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow retrieving emails from specific users",
+        ),
+        ConfigField(
+            name="get_unread_emails",
+            label="Get Unread Emails",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow retrieving unread emails",
+        ),
+        ConfigField(
+            name="get_starred_emails",
+            label="Get Starred Emails",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow retrieving starred emails",
+        ),
+        ConfigField(
+            name="search_emails",
+            label="Search Emails",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow searching through emails",
+        ),
+        ConfigField(
+            name="create_draft_email",
+            label="Create Draft Emails",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow creating draft emails",
+        ),
+        ConfigField(
+            name="send_email",
+            label="Send Emails",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow sending emails",
+        ),
+        ConfigField(
+            name="send_email_reply",
+            label="Send Email Replies",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Allow sending replies to emails",
+        ),
+    ],
+    dependencies=["google-api-python-client", "google-auth", "google-auth-oauthlib", "google-auth-httplib2"],
+    docs_url="https://docs.agno.com/tools/toolkits/social/gmail",
+)
+def gmail_tools() -> type[GmailTools]:
+    """Return Gmail tools for email management."""
+    from mindroom.custom_tools.gmail import GmailTools
+
+    return GmailTools

mindroom/tools/google_calendar.py

@@ -0,0 +1,55 @@
+"""Google Calendar 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_calendar import GoogleCalendarTools
+
+
+@register_tool_with_metadata(
+    name="google_calendar",
+    display_name="Google Calendar",
+    description="View and schedule meetings with Google Calendar",
+    category=ToolCategory.PRODUCTIVITY,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.SPECIAL,
+    auth_provider="google",  # Authentication provided by Google Services integration
+    icon="FaCalendarAlt",
+    icon_color="text-blue-600",  # Google Calendar blue
+    config_fields=[
+        ConfigField(
+            name="calendar_id",
+            label="Calendar ID",
+            type="text",
+            required=False,
+            default="primary",
+            placeholder="primary",
+            description="The Google Calendar ID to use (default: 'primary' for the user's main calendar)",
+        ),
+        ConfigField(
+            name="allow_update",
+            label="Allow Updates",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Allow the agent to create, update, and delete calendar events",
+        ),
+    ],
+    dependencies=["google-api-python-client", "google-auth", "google-auth-httplib2", "google-auth-oauthlib"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/googlecalendar",
+)
+def google_calendar_tools() -> type[GoogleCalendarTools]:
+    """Return Google Calendar tools for calendar management."""
+    from mindroom.custom_tools.google_calendar import GoogleCalendarTools
+
+    return GoogleCalendarTools

mindroom/tools/google_maps.py

@@ -0,0 +1,112 @@
+"""Google Maps 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.google_maps import GoogleMapTools
+
+
+@register_tool_with_metadata(
+    name="google_maps",
+    display_name="Google Maps",
+    description="Tools for interacting with Google Maps services including place search, directions, geocoding, and more",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="FaMapMarkedAlt",
+    icon_color="text-red-500",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="AIza...",
+            description="Google Maps API key (can also be set via GOOGLE_MAPS_API_KEY env var)",
+        ),
+        # Place search functionality
+        ConfigField(
+            name="search_places",
+            label="Search Places",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable places search functionality",
+        ),
+        # Directions functionality
+        ConfigField(
+            name="get_directions",
+            label="Get Directions",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable directions functionality",
+        ),
+        # Address validation functionality
+        ConfigField(
+            name="validate_address",
+            label="Validate Address",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable address validation functionality",
+        ),
+        # Geocoding functionality
+        ConfigField(
+            name="geocode_address",
+            label="Geocode Address",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable geocoding functionality",
+        ),
+        # Reverse geocoding functionality
+        ConfigField(
+            name="reverse_geocode",
+            label="Reverse Geocode",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable reverse geocoding functionality",
+        ),
+        # Distance matrix functionality
+        ConfigField(
+            name="get_distance_matrix",
+            label="Get Distance Matrix",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable distance matrix functionality",
+        ),
+        # Elevation functionality
+        ConfigField(
+            name="get_elevation",
+            label="Get Elevation",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable elevation functionality",
+        ),
+        # Timezone functionality
+        ConfigField(
+            name="get_timezone",
+            label="Get Timezone",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable timezone functionality",
+        ),
+    ],
+    dependencies=["googlemaps", "google-maps-places"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/google_maps",
+)
+def google_maps_tools() -> type[GoogleMapTools]:
+    """Return Google Maps tools for location services."""
+    from agno.tools.google_maps import GoogleMapTools
+
+    return GoogleMapTools