Initial commit: add .gitignore and README

fusionagi/agents/base_agent.py

@@ -0,0 +1,29 @@
+"""Base agent interface: identity, role, objective, memory/tool scope, handle_message."""
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+from fusionagi.schemas.messages import AgentMessageEnvelope
+
+
+class BaseAgent(ABC):
+    """Abstract base agent: identity, role, objective, memory access, tool permissions."""
+
+    def __init__(
+        self,
+        identity: str,
+        role: str,
+        objective: str,
+        memory_access: bool | str = True,
+        tool_permissions: list[str] | str | None = None,
+    ) -> None:
+        self.identity = identity
+        self.role = role
+        self.objective = objective
+        self.memory_access = memory_access
+        self.tool_permissions = tool_permissions if tool_permissions is not None else []
+
+    @abstractmethod
+    def handle_message(self, envelope: AgentMessageEnvelope) -> AgentMessageEnvelope | None:
+        """Process an incoming message; return response envelope or None."""
+        ...