agy-pilot 0.1.0__py3-none-any.whl

agy_pilot/__init__.py

@@ -0,0 +1,3 @@
+"""agy-pilot: Headless Instant Messaging controller & remote bridge for Antigravity 2."""
+
+__version__ = "0.1.0"

agy_pilot/adapters/__init__.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from .base import BaseIMAdapter
+from .registry import get_adapter, register_adapter
+
+__all__ = ["BaseIMAdapter", "get_adapter", "register_adapter"]

agy_pilot/adapters/base.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from agy_pilot.config import Config
+    from agy_pilot.controller import Antigravity2Controller
+    from agy_pilot.storage import SessionStore
+
+
+class BaseIMAdapter(ABC):
+    """Abstract Base Class for Instant Messaging adapters/plugins (Telegram, Discord, Slack, etc.)."""
+
+    def __init__(
+        self,
+        config: Config,
+        controller: Antigravity2Controller,
+        store: SessionStore,
+    ) -> None:
+        self.config = config
+        self.controller = controller
+        self.store = store
+
+    @abstractmethod
+    async def start(self) -> None:
+        """Start listening for incoming messages or polling events."""
+        ...
+
+    @abstractmethod
+    async def stop(self) -> None:
+        """Gracefully shut down the adapter."""
+        ...

agy_pilot/adapters/registry.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Callable, Type
+
+from .base import BaseIMAdapter
+
+if TYPE_CHECKING:
+    from agy_pilot.config import Config
+    from agy_pilot.controller import Antigravity2Controller
+    from agy_pilot.storage import SessionStore
+
+AdapterFactory = Callable[
+    ["Config", "Antigravity2Controller", "SessionStore"],
+    BaseIMAdapter,
+]
+
+_ADAPTER_REGISTRY: dict[str, AdapterFactory] = {}
+
+
+def register_adapter(name: str, factory_or_cls: Type[BaseIMAdapter] | AdapterFactory) -> None:
+    """Register an IM adapter factory or class by name."""
+    _ADAPTER_REGISTRY[name.lower()] = factory_or_cls
+
+
+def get_adapter(
+    name: str,
+    config: Config,
+    controller: Antigravity2Controller,
+    store: SessionStore,
+) -> BaseIMAdapter:
+    """Retrieve and instantiate an IM adapter by name."""
+    normalized_name = name.lower()
+
+    # Lazy-register default built-in adapters if not already present
+    if normalized_name == "telegram" and "telegram" not in _ADAPTER_REGISTRY:
+        from .telegram import TelegramAdapter
+        register_adapter("telegram", TelegramAdapter)
+
+    factory = _ADAPTER_REGISTRY.get(normalized_name)
+    if not factory:
+        available = ", ".join(_ADAPTER_REGISTRY.keys()) or "telegram"
+        raise ValueError(
+            f"Unsupported IM adapter '{name}'. Available adapters: {available}"
+        )
+    return factory(config, controller, store)

agy_pilot/adapters/telegram/__init__.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+from .adapter import QueueItem, TelegramAdapter, TelegramBridge, split_message_chunks
+from .heartbeat import StatusHeartbeat
+from .keyboards import (
+    build_conversations_keyboard,
+    build_interaction_keyboard,
+    build_project_actions_keyboard,
+    build_projects_keyboard,
+    build_skill_detail_keyboard,
+    build_skills_keyboard,
+    format_switch_message_and_keyboard,
+)
+from .middleware import AuthMiddleware
+
+__all__ = [
+    "TelegramAdapter",
+    "TelegramBridge",
+    "QueueItem",
+    "split_message_chunks",
+    "StatusHeartbeat",
+    "AuthMiddleware",
+    "build_projects_keyboard",
+    "build_project_actions_keyboard",
+    "build_conversations_keyboard",
+    "build_skills_keyboard",
+    "build_skill_detail_keyboard",
+    "format_switch_message_and_keyboard",
+    "build_interaction_keyboard",
+]