Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
chore: rename background to sleeptime (#1558)
cthomas79354a72ea7f
diff --git a/alembic/versions/90bb156e71df_rename_sleeptime_agent_frequency.py b/alembic/versions/90bb156e71df_rename_sleeptime_agent_frequency.pynew file mode 100644index 000000000..b80f183e6--- /dev/null+++ b/alembic/versions/90bb156e71df_rename_sleeptime_agent_frequency.py@@ -0,0 +1,29 @@+"""rename sleeptime_agent_frequency++Revision ID: 90bb156e71df+Revises: 6fe79c0525f2+Create Date: 2025-04-03 17:20:26.218596++"""++from typing import Sequence, Union++from alembic import op++# revision identifiers, used by Alembic.+revision: str = "90bb156e71df"+down_revision: Union[str, None] = "6fe79c0525f2"+branch_labels: Union[str, Sequence[str], None] = None+depends_on: Union[str, Sequence[str], None] = None+++def upgrade() -> None:+ # ### commands auto generated by Alembic - please adjust! ###+ op.alter_column("groups", "background_agents_frequency", new_column_name="sleeptime_agent_frequency")+ # ### end Alembic commands ###+++def downgrade() -> None:+ # ### commands auto generated by Alembic - please adjust! ###+ op.alter_column("groups", "sleeptime_agent_frequency", new_column_name="background_agents_frequency")+ # ### end Alembic commands ###diff --git a/letta/groups/helpers.py b/letta/groups/helpers.pyindex 8755e1907..a739c789d 100644--- a/letta/groups/helpers.py+++ b/letta/groups/helpers.py@@ -61,7 +61,7 @@ def load_multi_agent(agent_ids=group.agent_ids,description=group.description,)- case ManagerType.background:+ case ManagerType.sleeptime:if not agent_state.enable_sleeptime:return Agent(agent_state=agent_state,@@ -70,16 +70,16 @@ def load_multi_agent(mcp_clients=mcp_clients,)- from letta.groups.background_multi_agent import BackgroundMultiAgent+ from letta.groups.sleeptime_multi_agent import SleeptimeMultiAgent- return BackgroundMultiAgent(+ return SleeptimeMultiAgent(agent_state=agent_state,interface=interface,user=actor,group_id=group.id,agent_ids=group.agent_ids,description=group.description,- background_agents_frequency=group.background_agents_frequency,+ sleeptime_agent_frequency=group.sleeptime_agent_frequency,)case _:raise ValueError(f"Type {group.manager_type} is not supported.")diff --git a/letta/groups/background_multi_agent.py b/letta/groups/sleeptime_multi_agent.pysimilarity index 95%rename from letta/groups/background_multi_agent.pyrename to letta/groups/sleeptime_multi_agent.pyindex 64cba8691..4dc27ab70 100644--- a/letta/groups/background_multi_agent.py+++ b/letta/groups/sleeptime_multi_agent.py@@ -19,7 +19,7 @@ from letta.services.job_manager import JobManagerfrom letta.services.message_manager import MessageManager-class BackgroundMultiAgent(Agent):+class SleeptimeMultiAgent(Agent):def __init__(self,@@ -30,13 +30,13 @@ class BackgroundMultiAgent(Agent):group_id: str = "",agent_ids: List[str] = [],description: str = "",- background_agents_frequency: Optional[int] = None,+ sleeptime_agent_frequency: Optional[int] = None,):super().__init__(interface, agent_state, user)self.group_id = group_idself.agent_ids = agent_idsself.description = description- self.background_agents_frequency = background_agents_frequency+ self.sleeptime_agent_frequency = sleeptime_agent_frequencyself.group_manager = GroupManager()self.message_manager = MessageManager()self.job_manager = JobManager()@@ -118,7 +118,7 @@ class BackgroundMultiAgent(Agent):)prior_messages = []- if self.background_agents_frequency:+ if self.sleeptime_agent_frequency:try:prior_messages = self.message_manager.list_messages_for_agent(agent_id=self.agent_state.id,@@ -214,11 +214,11 @@ class BackgroundMultiAgent(Agent):)turns_counter = None- if self.background_agents_frequency is not None and self.background_agents_frequency > 0:+ if self.sleeptime_agent_frequency is not None and self.sleeptime_agent_frequency > 0:turns_counter = self.group_manager.bump_turns_counter(group_id=self.group_id, actor=self.user)- if self.background_agents_frequency is None or (- turns_counter is not None and turns_counter % self.background_agents_frequency == 0+ if self.sleeptime_agent_frequency is None or (+ turns_counter is not None and turns_counter % self.sleeptime_agent_frequency == 0):last_response_messages = [message for sublist in usage_stats.steps_messages for message in sublist]last_processed_message_id = self.group_manager.get_last_processed_message_id_and_update(diff --git a/letta/orm/group.py b/letta/orm/group.pyindex c77d33cb5..48c3b65be 100644--- a/letta/orm/group.py+++ b/letta/orm/group.py@@ -20,7 +20,7 @@ class Group(SqlalchemyBase, OrganizationMixin):manager_agent_id: Mapped[Optional[str]] = mapped_column(String, ForeignKey("agents.id", ondelete="RESTRICT"), nullable=True, doc="")termination_token: Mapped[Optional[str]] = mapped_column(nullable=True, doc="")max_turns: Mapped[Optional[int]] = mapped_column(nullable=True, doc="")- background_agents_frequency: Mapped[Optional[int]] = mapped_column(nullable=True, doc="")+ sleeptime_agent_frequency: Mapped[Optional[int]] = mapped_column(nullable=True, doc="")turns_counter: Mapped[Optional[int]] = mapped_column(nullable=True, doc="")last_processed_message_id: Mapped[Optional[str]] = mapped_column(nullable=True, doc="")diff --git a/letta/schemas/group.py b/letta/schemas/group.pyindex 669ebff42..e4dc80fb1 100644--- a/letta/schemas/group.py+++ b/letta/schemas/group.py@@ -10,7 +10,7 @@ class ManagerType(str, Enum):round_robin = "round_robin"supervisor = "supervisor"dynamic = "dynamic"- background = "background"+ sleeptime = "sleeptime"swarm = "swarm"@@ -28,7 +28,7 @@ class Group(GroupBase):manager_agent_id: Optional[str] = Field(None, description="")termination_token: Optional[str] = Field(None, description="")max_turns: Optional[int] = Field(None, description="")- background_agents_frequency: Optional[int] = Field(None, description="")+ sleeptime_agent_frequency: Optional[int] = Field(None, description="")turns_counter: Optional[int] = Field(None, description="")last_processed_message_id: Optional[str] = Field(None, description="")@@ -54,10 +54,10 @@ class DynamicManager(ManagerConfig):max_turns: Optional[int] = Field(None, description="")-class BackgroundManager(ManagerConfig):- manager_type: Literal[ManagerType.background] = Field(ManagerType.background, description="")+class SleeptimeManager(ManagerConfig):+ manager_type: Literal[ManagerType.sleeptime] = Field(ManagerType.sleeptime, description="")manager_agent_id: str = Field(..., description="")- background_agents_frequency: Optional[int] = Field(None, description="")+ sleeptime_agent_frequency: Optional[int] = Field(None, description="")# class SwarmGroup(ManagerConfig):@@ -65,7 +65,7 @@ class BackgroundManager(ManagerConfig):ManagerConfigUnion = Annotated[- Union[RoundRobinManager, SupervisorManager, DynamicManager, BackgroundManager],+ Union[RoundRobinManager, SupervisorManager, DynamicManager, SleeptimeManager],Field(discriminator="manager_type"),]diff --git a/letta/server/server.py b/letta/server/server.pyindex 83e6cd10e..2fc784963 100644--- a/letta/server/server.py+++ b/letta/server/server.py@@ -40,7 +40,7 @@ from letta.schemas.embedding_config import EmbeddingConfig# openai schemasfrom letta.schemas.enums import JobStatus, MessageStreamStatusfrom letta.schemas.environment_variables import SandboxEnvironmentVariableCreate-from letta.schemas.group import BackgroundManager, GroupCreate+from letta.schemas.group import GroupCreate, SleeptimeManagerfrom letta.schemas.job import Job, JobUpdatefrom letta.schemas.letta_message import LegacyLettaMessage, LettaMessage, ToolReturnMessagefrom letta.schemas.letta_message_content import TextContent@@ -782,7 +782,7 @@ class SyncServer(Server):group=GroupCreate(description="",agent_ids=[sleeptime_agent.id],- manager_config=BackgroundManager(+ manager_config=SleeptimeManager(manager_agent_id=main_agent.id,),),diff --git a/letta/services/agent_manager.py b/letta/services/agent_manager.pyindex 9a5d32d97..7d9f87be8 100644--- a/letta/services/agent_manager.py+++ b/letta/services/agent_manager.py@@ -498,7 +498,7 @@ class AgentManager:# Delete sleeptime agent and groupif agent.multi_agent_group:participant_agent_ids = agent.multi_agent_group.agent_ids- if agent.multi_agent_group.manager_type == ManagerType.background and len(participant_agent_ids) == 1:+ if agent.multi_agent_group.manager_type == ManagerType.sleeptime and len(participant_agent_ids) == 1:sleeptime_agent = AgentModel.read(db_session=session, identifier=participant_agent_ids[0], actor=actor)if sleeptime_agent.agent_type == AgentType.sleeptime_agent:sleeptime_agent_group = GroupModel.read(db_session=session, identifier=agent.multi_agent_group.id, actor=actor)diff --git a/letta/services/group_manager.py b/letta/services/group_manager.pyindex 623d0fa48..17d411e0d 100644--- a/letta/services/group_manager.py+++ b/letta/services/group_manager.py@@ -71,11 +71,11 @@ class GroupManager:case ManagerType.supervisor:new_group.manager_type = ManagerType.supervisornew_group.manager_agent_id = group.manager_config.manager_agent_id- case ManagerType.background:- new_group.manager_type = ManagerType.background+ case ManagerType.sleeptime:+ new_group.manager_type = ManagerType.sleeptimenew_group.manager_agent_id = group.manager_config.manager_agent_id- new_group.background_agents_frequency = group.manager_config.background_agents_frequency- if new_group.background_agents_frequency:+ new_group.sleeptime_agent_frequency = group.manager_config.sleeptime_agent_frequency+ if new_group.sleeptime_agent_frequency:new_group.turns_counter = 0case _:raise ValueError(f"Unsupported manager type: {group.manager_config.manager_type}")@@ -93,7 +93,7 @@ class GroupManager:with self.session_maker() as session:group = GroupModel.read(db_session=session, identifier=group_id, actor=actor)- background_agents_frequency = None+ sleeptime_agent_frequency = Nonemax_turns = Nonetermination_token = Nonemanager_agent_id = None@@ -109,16 +109,16 @@ class GroupManager:termination_token = group_update.manager_config.termination_tokencase ManagerType.supervisor:manager_agent_id = group_update.manager_config.manager_agent_id- case ManagerType.background:+ case ManagerType.sleeptime:manager_agent_id = group_update.manager_config.manager_agent_id- background_agents_frequency = group_update.manager_config.background_agents_frequency- if background_agents_frequency and group.turns_counter is None:+ sleeptime_agent_frequency = group_update.manager_config.sleeptime_agent_frequency+ if sleeptime_agent_frequency and group.turns_counter is None:group.turns_counter = 0case _:raise ValueError(f"Unsupported manager type: {group_update.manager_config.manager_type}")- if background_agents_frequency:- group.background_agents_frequency = background_agents_frequency+ if sleeptime_agent_frequency:+ group.sleeptime_agent_frequency = sleeptime_agent_frequencyif max_turns:group.max_turns = max_turnsif termination_token:@@ -198,7 +198,7 @@ class GroupManager:group = GroupModel.read(db_session=session, identifier=group_id, actor=actor)# Update turns counter- group.turns_counter = (group.turns_counter + 1) % group.background_agents_frequency+ group.turns_counter = (group.turns_counter + 1) % group.sleeptime_agent_frequencygroup.update(session, actor=actor)return group.turns_counterdiff --git a/tests/test_multi_agent.py b/tests/test_multi_agent.pyindex ec9f07f59..3e8cb2761 100644--- a/tests/test_multi_agent.py+++ b/tests/test_multi_agent.py@@ -10,12 +10,12 @@ from letta.schemas.agent import CreateAgentfrom letta.schemas.block import CreateBlockfrom letta.schemas.enums import JobStatusfrom letta.schemas.group import (- BackgroundManager,DynamicManager,GroupCreate,GroupUpdate,ManagerType,RoundRobinManager,+ SleeptimeManager,SupervisorManager,)from letta.schemas.message import MessageCreate@@ -441,7 +441,7 @@ async def test_dynamic_group_chat(server, actor, manager_agent, participant_agen@pytest.mark.asyncio-async def test_background_group_chat(server, actor):+async def test_sleeptime_group_chat(server, actor):# 0. Refresh base toolsserver.tool_manager.upsert_base_tools(actor=actor)@@ -472,16 +472,16 @@ async def test_background_group_chat(server, actor):group = server.group_manager.modify_group(group_id=main_agent.multi_agent_group.id,group_update=GroupUpdate(- manager_config=BackgroundManager(+ manager_config=SleeptimeManager(manager_agent_id=main_agent.id,- background_agents_frequency=2,+ sleeptime_agent_frequency=2,),),actor=actor,)- assert group.manager_type == ManagerType.background- assert group.background_agents_frequency == 2+ assert group.manager_type == ManagerType.sleeptime+ assert group.sleeptime_agent_frequency == 2assert len(group.agent_ids) == 1# 3. Verify shared blocks