@elizaos/python 2.0.0-alpha.10

package/elizaos/advanced_capabilities/actions/mute_room.py

@@ -0,0 +1,164 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import TYPE_CHECKING
+
+from elizaos.generated.spec_helpers import require_action_spec
+from elizaos.types import Action, ActionExample, ActionResult, Content
+
+if TYPE_CHECKING:
+    from elizaos.types import HandlerCallback, HandlerOptions, IAgentRuntime, Memory, State
+
+# Get text content from centralized specs
+_spec = require_action_spec("MUTE_ROOM")
+
+
+def _convert_spec_examples() -> list[list[ActionExample]]:
+    """Convert spec examples to ActionExample format."""
+    spec_examples = _spec.get("examples", [])
+    if not isinstance(spec_examples, list):
+        return []
+    result: list[list[ActionExample]] = []
+    for example in spec_examples:
+        if not isinstance(example, list):
+            continue
+        row: list[ActionExample] = []
+        for msg in example:
+            if not isinstance(msg, dict):
+                continue
+            content = msg.get("content", {})
+            text = ""
+            actions: list[str] | None = None
+            if isinstance(content, dict):
+                text_val = content.get("text", "")
+                text = str(text_val) if text_val else ""
+                actions_val = content.get("actions")
+                if isinstance(actions_val, list) and all(isinstance(a, str) for a in actions_val):
+                    actions = list(actions_val)
+            row.append(
+                ActionExample(
+                    name=str(msg.get("name", "")),
+                    content=Content(text=text, actions=actions),
+                )
+            )
+        if row:
+            result.append(row)
+    return result
+
+
+@dataclass
+class MuteRoomAction:
+    name: str = _spec["name"]
+    similes: list[str] = field(default_factory=lambda: list(_spec.get("similes", [])))
+    description: str = _spec["description"]
+
+    async def validate(
+        self, runtime: IAgentRuntime, message: Memory, _state: State | None = None
+    ) -> bool:
+        room_id = message.room_id
+        if not room_id:
+            return False
+
+        room = await runtime.get_room(room_id)
+        if room is None:
+            return False
+
+        world_id = room.world_id
+        if world_id:
+            world = await runtime.get_world(world_id)
+            if world and world.metadata:
+                muted_rooms = world.metadata.get("mutedRooms", [])
+                if str(room_id) in muted_rooms:
+                    return False
+
+        return True
+
+    async def handler(
+        self,
+        runtime: IAgentRuntime,
+        message: Memory,
+        state: State | None = None,
+        options: HandlerOptions | None = None,
+        callback: HandlerCallback | None = None,
+        responses: list[Memory] | None = None,
+    ) -> ActionResult:
+        room_id = message.room_id
+        if not room_id:
+            return ActionResult(
+                text="No room specified to mute",
+                values={"success": False, "error": "no_room_id"},
+                data={"actionName": "MUTE_ROOM"},
+                success=False,
+            )
+
+        room = await runtime.get_room(room_id)
+        if room is None:
+            return ActionResult(
+                text="Room not found",
+                values={"success": False, "error": "room_not_found"},
+                data={"actionName": "MUTE_ROOM"},
+                success=False,
+            )
+
+        room_name = str(room.name) if room.name else "Unknown Room"
+
+        world_id = room.world_id
+        if world_id:
+            world = await runtime.get_world(world_id)
+            if world and world.metadata:
+                muted_rooms = list(world.metadata.get("mutedRooms", []))
+                room_id_str = str(room_id)
+
+                if room_id_str not in muted_rooms:
+                    muted_rooms.append(room_id_str)
+                    world.metadata["mutedRooms"] = muted_rooms
+                    await runtime.update_world(world)
+
+        await runtime.create_memory(
+            content=Content(
+                text=f"Muted room: {room_name}",
+                actions=["MUTE_ROOM"],
+            ),
+            room_id=room_id,
+            entity_id=runtime.agent_id,
+            memory_type="action",
+            metadata={"type": "MUTE_ROOM", "roomName": room_name},
+        )
+
+        response_content = Content(
+            text=f"I have muted {room_name}. I won't respond to messages there.",
+            actions=["MUTE_ROOM"],
+        )
+
+        if callback:
+            await callback(response_content)
+
+        return ActionResult(
+            text=f"Muted room: {room_name}",
+            values={
+                "success": True,
+                "muted": True,
+                "roomId": str(room_id),
+                "roomName": room_name,
+            },
+            data={
+                "actionName": "MUTE_ROOM",
+                "roomId": str(room_id),
+                "roomName": room_name,
+            },
+            success=True,
+        )
+
+    @property
+    def examples(self) -> list[list[ActionExample]]:
+        return _convert_spec_examples()
+
+
+mute_room_action = Action(
+    name=MuteRoomAction.name,
+    similes=MuteRoomAction().similes,
+    description=MuteRoomAction.description,
+    validate=MuteRoomAction().validate,
+    handler=MuteRoomAction().handler,
+    examples=MuteRoomAction().examples,
+)

package/elizaos/advanced_capabilities/actions/remove_contact.py

@@ -0,0 +1,145 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import TYPE_CHECKING
+
+from elizaos.bootstrap.utils.xml import parse_key_value_xml
+from elizaos.generated.spec_helpers import require_action_spec
+from elizaos.prompts import REMOVE_CONTACT_TEMPLATE
+from elizaos.types import (
+    Action,
+    ActionExample,
+    ActionResult,
+    Content,
+    ModelType,
+)
+from elizaos.utils.spec_examples import convert_spec_examples
+
+if TYPE_CHECKING:
+    from elizaos.types import (
+        HandlerCallback,
+        HandlerOptions,
+        IAgentRuntime,
+        Memory,
+        State,
+    )
+
+# Get text content from centralized specs
+_spec = require_action_spec("REMOVE_CONTACT")
+
+
+def _convert_spec_examples() -> list[list[ActionExample]]:
+    """Convert spec examples to ActionExample format."""
+    return convert_spec_examples(_spec)
+
+
+@dataclass
+class RemoveContactAction:
+    name: str = _spec["name"]
+    similes: list[str] = field(default_factory=lambda: list(_spec.get("similes", [])))
+    description: str = _spec["description"]
+
+    async def validate(
+        self, runtime: IAgentRuntime, _message: Memory, _state: State | None = None
+    ) -> bool:
+        rolodex_service = runtime.get_service("rolodex")
+        return rolodex_service is not None
+
+    async def handler(
+        self,
+        runtime: IAgentRuntime,
+        message: Memory,
+        state: State | None = None,
+        options: HandlerOptions | None = None,
+        callback: HandlerCallback | None = None,
+        responses: list[Memory] | None = None,
+    ) -> ActionResult:
+        from elizaos.bootstrap.services.rolodex import RolodexService
+
+        rolodex_service = runtime.get_service("rolodex")
+        if not rolodex_service or not isinstance(rolodex_service, RolodexService):
+            return ActionResult(
+                text="Rolodex service not available",
+                success=False,
+                values={"error": True},
+                data={"error": "RolodexService not available"},
+            )
+
+        state = await runtime.compose_state(message, ["RECENT_MESSAGES", "ENTITIES"])
+
+        prompt = runtime.compose_prompt_from_state(
+            state=state,
+            template=REMOVE_CONTACT_TEMPLATE,
+        )
+
+        response = await runtime.use_model(ModelType.TEXT_SMALL, {"prompt": prompt})
+        parsed = parse_key_value_xml(response)
+
+        if not parsed or not parsed.get("contactName"):
+            return ActionResult(
+                text="Could not determine which contact to remove",
+                success=False,
+                values={"error": True},
+                data={"error": "No contact name provided"},
+            )
+
+        contact_name = str(parsed.get("contactName", ""))
+        confirmed = str(parsed.get("confirmed", "no")).lower() == "yes"
+
+        if not confirmed:
+            response_text = (
+                f'To remove {contact_name}, please confirm by saying "yes, remove {contact_name}".'
+            )
+            if callback:
+                await callback(Content(text=response_text, actions=["REMOVE_CONTACT"]))
+            return ActionResult(
+                text=response_text,
+                success=True,
+                values={"needsConfirmation": True},
+                data={"contactName": contact_name},
+            )
+
+        contacts = await rolodex_service.search_contacts(search_term=contact_name)
+
+        if not contacts:
+            return ActionResult(
+                text=f"Could not find a contact named '{contact_name}'",
+                success=False,
+                values={"error": True},
+                data={"error": "Contact not found"},
+            )
+
+        contact = contacts[0]
+        removed = await rolodex_service.remove_contact(contact.entity_id)
+
+        if removed:
+            response_text = f"I've removed {contact_name} from your contacts."
+            if callback:
+                await callback(Content(text=response_text, actions=["REMOVE_CONTACT"]))
+            return ActionResult(
+                text=response_text,
+                success=True,
+                values={"contactId": str(contact.entity_id)},
+                data={"success": True},
+            )
+        else:
+            return ActionResult(
+                text="Failed to remove contact",
+                success=False,
+                values={"error": True},
+                data={"error": "Remove operation failed"},
+            )
+
+    @property
+    def examples(self) -> list[list[ActionExample]]:
+        return _convert_spec_examples()
+
+
+remove_contact_action = Action(
+    name=RemoveContactAction.name,
+    similes=RemoveContactAction().similes,
+    description=RemoveContactAction.description,
+    validate=RemoveContactAction().validate,
+    handler=RemoveContactAction().handler,
+    examples=RemoveContactAction().examples,
+)

package/elizaos/advanced_capabilities/actions/roles.py

@@ -0,0 +1,207 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from enum import Enum
+from typing import TYPE_CHECKING
+from uuid import UUID
+
+from elizaos.bootstrap.utils.xml import parse_key_value_xml
+from elizaos.generated.spec_helpers import require_action_spec
+from elizaos.prompts import UPDATE_ROLE_TEMPLATE
+from elizaos.types import Action, ActionExample, ActionResult, Content, ModelType
+
+if TYPE_CHECKING:
+    from elizaos.types import HandlerCallback, HandlerOptions, IAgentRuntime, Memory, State
+
+# Get text content from centralized specs
+_spec = require_action_spec("UPDATE_ROLE")
+
+
+def _convert_spec_examples() -> list[list[ActionExample]]:
+    """Convert spec examples to ActionExample format."""
+    spec_examples = _spec.get("examples", [])
+    if not isinstance(spec_examples, list):
+        return []
+    result: list[list[ActionExample]] = []
+    for example in spec_examples:
+        if not isinstance(example, list):
+            continue
+        row: list[ActionExample] = []
+        for msg in example:
+            if not isinstance(msg, dict):
+                continue
+            content = msg.get("content", {})
+            text = ""
+            actions: list[str] | None = None
+            if isinstance(content, dict):
+                text_val = content.get("text", "")
+                text = str(text_val) if text_val else ""
+                actions_val = content.get("actions")
+                if isinstance(actions_val, list) and all(isinstance(a, str) for a in actions_val):
+                    actions = list(actions_val)
+            row.append(
+                ActionExample(
+                    name=str(msg.get("name", "")),
+                    content=Content(text=text, actions=actions),
+                )
+            )
+        if row:
+            result.append(row)
+    return result
+
+
+class Role(str, Enum):
+    OWNER = "OWNER"
+    ADMIN = "ADMIN"
+    MEMBER = "MEMBER"
+    GUEST = "GUEST"
+    NONE = "NONE"
+
+
+@dataclass
+class UpdateRoleAction:
+    name: str = _spec["name"]
+    similes: list[str] = field(default_factory=lambda: list(_spec.get("similes", [])))
+    description: str = _spec["description"]
+
+    async def validate(
+        self, runtime: IAgentRuntime, message: Memory, _state: State | None = None
+    ) -> bool:
+        room_id = message.room_id
+        if not room_id:
+            return False
+
+        room = await runtime.get_room(room_id)
+        if room is None or room.world_id is None:
+            return False
+
+        world = await runtime.get_world(room.world_id)
+        if world is None or world.metadata is None:
+            return False
+
+        roles = world.metadata.get("roles", {})
+        agent_role = roles.get(str(runtime.agent_id), Role.NONE.value)
+
+        return agent_role in (Role.OWNER.value, Role.ADMIN.value)
+
+    async def handler(
+        self,
+        runtime: IAgentRuntime,
+        message: Memory,
+        state: State | None = None,
+        options: HandlerOptions | None = None,
+        callback: HandlerCallback | None = None,
+        responses: list[Memory] | None = None,
+    ) -> ActionResult:
+        if state is None:
+            raise ValueError("State is required for UPDATE_ROLE action")
+
+        room_id = message.room_id
+        if not room_id:
+            return ActionResult(
+                text="No room context for role update",
+                values={"success": False, "error": "no_room_id"},
+                data={"actionName": "UPDATE_ROLE"},
+                success=False,
+            )
+
+        room = await runtime.get_room(room_id)
+        if room is None or room.world_id is None:
+            return ActionResult(
+                text="Room or world not found",
+                values={"success": False, "error": "room_not_found"},
+                data={"actionName": "UPDATE_ROLE"},
+                success=False,
+            )
+
+        world = await runtime.get_world(room.world_id)
+        if world is None or world.metadata is None:
+            return ActionResult(
+                text="World not found",
+                values={"success": False, "error": "world_not_found"},
+                data={"actionName": "UPDATE_ROLE"},
+                success=False,
+            )
+
+        state = await runtime.compose_state(
+            message, ["RECENT_MESSAGES", "ACTION_STATE", "WORLD_INFO"]
+        )
+
+        current_roles = world.metadata.get("roles", {})
+        roles_context = "\n".join(
+            f"- {entity_id}: {role}" for entity_id, role in current_roles.items()
+        )
+
+        template = (
+            runtime.character.templates.get("updateRoleTemplate")
+            if runtime.character.templates and "updateRoleTemplate" in runtime.character.templates
+            else UPDATE_ROLE_TEMPLATE
+        )
+        prompt = runtime.compose_prompt(state=state, template=template)
+        prompt = prompt.replace("{{roles}}", roles_context)
+
+        response_text = await runtime.use_model(ModelType.TEXT_LARGE, prompt=prompt)
+        parsed_xml = parse_key_value_xml(response_text)
+
+        if parsed_xml is None:
+            raise ValueError("Failed to parse XML response")
+
+        thought = str(parsed_xml.get("thought", ""))
+        entity_id_str = str(parsed_xml.get("entity_id", ""))
+        new_role_str = str(parsed_xml.get("new_role", "")).upper()
+
+        if not entity_id_str:
+            raise ValueError("No entity ID provided")
+
+        if new_role_str not in [r.value for r in Role]:
+            raise ValueError(f"Invalid role: {new_role_str}")
+
+        entity_id = UUID(entity_id_str)
+
+        roles = dict(world.metadata.get("roles", {}))
+        old_role = roles.get(str(entity_id), Role.NONE.value)
+        roles[str(entity_id)] = new_role_str
+        world.metadata["roles"] = roles
+
+        await runtime.update_world(world)
+
+        response_content = Content(
+            text=f"Updated role for {entity_id_str}: {old_role} -> {new_role_str}",
+            actions=["UPDATE_ROLE"],
+        )
+
+        if callback:
+            await callback(response_content)
+
+        return ActionResult(
+            text=f"Role updated: {entity_id_str} is now {new_role_str}",
+            values={
+                "success": True,
+                "roleUpdated": True,
+                "entityId": str(entity_id),
+                "oldRole": old_role,
+                "newRole": new_role_str,
+            },
+            data={
+                "actionName": "UPDATE_ROLE",
+                "entityId": str(entity_id),
+                "oldRole": old_role,
+                "newRole": new_role_str,
+                "thought": thought,
+            },
+            success=True,
+        )
+
+    @property
+    def examples(self) -> list[list[ActionExample]]:
+        return _convert_spec_examples()
+
+
+update_role_action = Action(
+    name=UpdateRoleAction.name,
+    similes=UpdateRoleAction().similes,
+    description=UpdateRoleAction.description,
+    validate=UpdateRoleAction().validate,
+    handler=UpdateRoleAction().handler,
+    examples=UpdateRoleAction().examples,
+)

package/elizaos/advanced_capabilities/actions/schedule_follow_up.py

@@ -0,0 +1,154 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import TYPE_CHECKING
+
+from elizaos.bootstrap.utils.xml import parse_key_value_xml
+from elizaos.generated.spec_helpers import require_action_spec
+from elizaos.prompts import SCHEDULE_FOLLOW_UP_TEMPLATE
+from elizaos.types import (
+    Action,
+    ActionExample,
+    ActionResult,
+    Content,
+    ModelType,
+)
+from elizaos.utils.spec_examples import convert_spec_examples
+
+if TYPE_CHECKING:
+    from elizaos.types import (
+        HandlerCallback,
+        HandlerOptions,
+        IAgentRuntime,
+        Memory,
+        State,
+    )
+
+# Get text content from centralized specs
+_spec = require_action_spec("SCHEDULE_FOLLOW_UP")
+
+
+def _convert_spec_examples() -> list[list[ActionExample]]:
+    """Convert spec examples to ActionExample format."""
+    return convert_spec_examples(_spec)
+
+
+@dataclass
+class ScheduleFollowUpAction:
+    name: str = _spec["name"]
+    similes: list[str] = field(default_factory=lambda: list(_spec.get("similes", [])))
+    description: str = _spec["description"]
+
+    async def validate(
+        self, runtime: IAgentRuntime, _message: Memory, _state: State | None = None
+    ) -> bool:
+        rolodex_service = runtime.get_service("rolodex")
+        follow_up_service = runtime.get_service("follow_up")
+        return rolodex_service is not None and follow_up_service is not None
+
+    async def handler(
+        self,
+        runtime: IAgentRuntime,
+        message: Memory,
+        state: State | None = None,
+        options: HandlerOptions | None = None,
+        callback: HandlerCallback | None = None,
+        responses: list[Memory] | None = None,
+    ) -> ActionResult:
+        from elizaos.bootstrap.services.follow_up import FollowUpService
+        from elizaos.bootstrap.services.rolodex import RolodexService
+
+        rolodex_service = runtime.get_service("rolodex")
+        follow_up_service = runtime.get_service("follow_up")
+
+        if not rolodex_service or not isinstance(rolodex_service, RolodexService):
+            return ActionResult(
+                text="Rolodex service not available",
+                success=False,
+                values={"error": True},
+                data={"error": "RolodexService not available"},
+            )
+
+        if not follow_up_service or not isinstance(follow_up_service, FollowUpService):
+            return ActionResult(
+                text="Follow-up service not available",
+                success=False,
+                values={"error": True},
+                data={"error": "FollowUpService not available"},
+            )
+
+        state = await runtime.compose_state(message, ["RECENT_MESSAGES", "ENTITIES"])
+        state.values["currentDateTime"] = datetime.utcnow().isoformat()
+
+        prompt = runtime.compose_prompt_from_state(
+            state=state,
+            template=SCHEDULE_FOLLOW_UP_TEMPLATE,
+        )
+
+        response = await runtime.use_model(ModelType.TEXT_SMALL, {"prompt": prompt})
+        parsed = parse_key_value_xml(response)
+
+        if not parsed or not parsed.get("contactName"):
+            return ActionResult(
+                text="Could not extract follow-up information",
+                success=False,
+                values={"error": True},
+                data={"error": "Failed to parse follow-up info"},
+            )
+
+        contact_name = str(parsed.get("contactName", ""))
+        scheduled_at_str = str(parsed.get("scheduledAt", ""))
+        reason = str(parsed.get("reason", "Follow-up"))
+        priority = str(parsed.get("priority", "medium"))
+        follow_up_message = str(parsed.get("message", ""))
+
+        scheduled_at = datetime.fromisoformat(scheduled_at_str.replace("Z", "+00:00"))
+
+        from uuid import UUID as StdUUID
+
+        entity_id = message.entity_id
+        entity_id_uuid = StdUUID(str(entity_id)) if entity_id else None
+        if entity_id_uuid:
+            await follow_up_service.schedule_follow_up(
+                entity_id=entity_id_uuid,
+                scheduled_at=scheduled_at,
+                reason=reason,
+                priority=priority,
+                message=follow_up_message,
+            )
+
+        response_text = f"I've scheduled a follow-up with {contact_name} for {scheduled_at.strftime('%B %d, %Y')}. Reason: {reason}"
+
+        if callback:
+            await callback(Content(text=response_text, actions=["SCHEDULE_FOLLOW_UP"]))
+
+        return ActionResult(
+            text=response_text,
+            success=True,
+            values={
+                "contactId": str(entity_id),
+                "scheduledAt": scheduled_at.isoformat(),
+            },
+            data={
+                "contactId": str(entity_id),
+                "contactName": contact_name,
+                "scheduledAt": scheduled_at.isoformat(),
+                "reason": reason,
+                "priority": priority,
+            },
+        )
+
+    @property
+    def examples(self) -> list[list[ActionExample]]:
+        return _convert_spec_examples()
+
+
+schedule_follow_up_action = Action(
+    name=ScheduleFollowUpAction.name,
+    similes=ScheduleFollowUpAction().similes,
+    description=ScheduleFollowUpAction.description,
+    validate=ScheduleFollowUpAction().validate,
+    handler=ScheduleFollowUpAction().handler,
+    examples=ScheduleFollowUpAction().examples,
+)