Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
feat: add project id to step model (#3121)
cthomas87b23c8a29f8
diff --git a/alembic/versions/60ed28ee7138_add_project_id_to_step_model.py b/alembic/versions/60ed28ee7138_add_project_id_to_step_model.pynew file mode 100644index 000000000..a6e234445--- /dev/null+++ b/alembic/versions/60ed28ee7138_add_project_id_to_step_model.py@@ -0,0 +1,41 @@+"""add project id to step model++Revision ID: 60ed28ee7138+Revises: 46699adc71a7+Create Date: 2025-07-01 13:12:44.485233++"""++from typing import Sequence, Union++import sqlalchemy as sa++from alembic import op++# revision identifiers, used by Alembic.+revision: str = "60ed28ee7138"+down_revision: Union[str, None] = "46699adc71a7"+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.add_column("steps", sa.Column("project_id", sa.String(), nullable=True))+ op.execute(+ """+ UPDATE steps+ SET project_id = agents.project_id+ FROM agents+ WHERE steps.agent_id = agents.id+ AND steps.agent_id IS NOT NULL+ AND agents.project_id IS NOT NULL+ """+ )+ # ### end Alembic commands ###+++def downgrade() -> None:+ # ### commands auto generated by Alembic - please adjust! ###+ op.drop_column("steps", "project_id")+ # ### end Alembic commands ###diff --git a/letta/agent.py b/letta/agent.pyindex 90f5494fe..87b083c5e 100644--- a/letta/agent.py+++ b/letta/agent.py@@ -990,6 +990,7 @@ class Agent(BaseAgent):),job_id=job_id,step_id=step_id,+ project_id=self.agent_state.project_id,)for message in all_new_messages:message.step_id = step.iddiff --git a/letta/agents/letta_agent.py b/letta/agents/letta_agent.pyindex 721f915ab..d13546ca5 100644--- a/letta/agents/letta_agent.py+++ b/letta/agents/letta_agent.py@@ -1018,6 +1018,7 @@ class LettaAgent(BaseAgent):provider_id=None,job_id=run_id,step_id=step_id,+ project_id=agent_state.project_id,)tool_call_messages = create_letta_messages_from_llm_response(diff --git a/letta/orm/step.py b/letta/orm/step.pyindex 752c492e6..85d2afae8 100644--- a/letta/orm/step.py+++ b/letta/orm/step.py@@ -51,6 +51,9 @@ class Step(SqlalchemyBase):feedback: Mapped[Optional[str]] = mapped_column(None, nullable=True, doc="The feedback for this step. Must be either 'positive' or 'negative'.")+ project_id: Mapped[Optional[str]] = mapped_column(+ None, nullable=True, doc="The project that the agent that executed this step belongs to (cloud only)."+ )# Relationships (foreign keys)organization: Mapped[Optional["Organization"]] = relationship("Organization")diff --git a/letta/schemas/step.py b/letta/schemas/step.pyindex 398199b56..37153a569 100644--- a/letta/schemas/step.py+++ b/letta/schemas/step.py@@ -35,3 +35,4 @@ class Step(StepBase):feedback: Optional[Literal["positive", "negative"]] = Field(None, description="The feedback for this step. Must be either 'positive' or 'negative'.")+ project_id: Optional[str] = Field(None, description="The project that the agent that executed this step belongs to (cloud only).")diff --git a/letta/server/rest_api/routers/v1/steps.py b/letta/server/rest_api/routers/v1/steps.pyindex cdb401ede..07d513dd8 100644--- a/letta/server/rest_api/routers/v1/steps.py+++ b/letta/server/rest_api/routers/v1/steps.py@@ -26,8 +26,12 @@ async def list_steps(feedback: Optional[Literal["positive", "negative"]] = Query(None, description="Filter by feedback"),has_feedback: Optional[bool] = Query(None, description="Filter by whether steps have feedback (true) or not (false)"),tags: Optional[list[str]] = Query(None, description="Filter by tags"),+ project_id: Optional[str] = Query(None, description="Filter by the project ID that is associated with the step (cloud only)."),server: SyncServer = Depends(get_letta_server),actor_id: Optional[str] = Header(None, alias="user_id"),+ x_project: Optional[str] = Header(+ None, alias="X-Project", description="Filter by project slug to associate with the group (cloud only)."+ ), # Only handled by next js middleware):"""List steps with optional pagination and date filters.@@ -53,6 +57,7 @@ async def list_steps(feedback=feedback,has_feedback=has_feedback,tags=tags,+ project_id=project_id,)diff --git a/letta/services/step_manager.py b/letta/services/step_manager.pyindex 138071ea8..b95de67dd 100644--- a/letta/services/step_manager.py+++ b/letta/services/step_manager.py@@ -42,6 +42,7 @@ class StepManager:trace_ids: Optional[list[str]] = None,feedback: Optional[Literal["positive", "negative"]] = None,has_feedback: Optional[bool] = None,+ project_id: Optional[str] = None,) -> List[PydanticStep]:"""List all jobs with optional pagination and status filter."""async with db_registry.async_session() as session:@@ -54,6 +55,8 @@ class StepManager:filter_kwargs["trace_id"] = trace_idsif feedback:filter_kwargs["feedback"] = feedback+ if project_id:+ filter_kwargs["project_id"] = project_idsteps = await StepModel.list_async(db_session=session,before=before,@@ -82,6 +85,7 @@ class StepManager:provider_id: Optional[str] = None,job_id: Optional[str] = None,step_id: Optional[str] = None,+ project_id: Optional[str] = None,) -> PydanticStep:step_data = {"origin": None,@@ -100,6 +104,7 @@ class StepManager:"tags": [],"tid": None,"trace_id": get_trace_id(), # Get the current trace ID+ "project_id": project_id,}if step_id:step_data["id"] = step_id@@ -125,6 +130,7 @@ class StepManager:provider_id: Optional[str] = None,job_id: Optional[str] = None,step_id: Optional[str] = None,+ project_id: Optional[str] = None,) -> PydanticStep:step_data = {"origin": None,@@ -143,6 +149,7 @@ class StepManager:"tags": [],"tid": None,"trace_id": get_trace_id(), # Get the current trace ID+ "project_id": project_id,}if step_id:step_data["id"] = step_id@@ -280,6 +287,7 @@ class NoopStepManager(StepManager):provider_id: Optional[str] = None,job_id: Optional[str] = None,step_id: Optional[str] = None,+ project_id: Optional[str] = None,) -> PydanticStep:return@@ -298,5 +306,6 @@ class NoopStepManager(StepManager):provider_id: Optional[str] = None,job_id: Optional[str] = None,step_id: Optional[str] = None,+ project_id: Optional[str] = None,) -> PydanticStep:returndiff --git a/tests/test_managers.py b/tests/test_managers.pyindex cdd9c0a43..0503fa94f 100644--- a/tests/test_managers.py+++ b/tests/test_managers.py@@ -6160,6 +6160,7 @@ async def test_job_usage_stats_add_and_get(server: SyncServer, sarah_agent, defatotal_tokens=150,),actor=default_user,+ project_id=sarah_agent.project_id,)# Get usage statistics@@ -6213,6 +6214,7 @@ async def test_job_usage_stats_add_multiple(server: SyncServer, sarah_agent, deftotal_tokens=150,),actor=default_user,+ project_id=sarah_agent.project_id,)# Add second usage statistics entry@@ -6230,6 +6232,7 @@ async def test_job_usage_stats_add_multiple(server: SyncServer, sarah_agent, deftotal_tokens=300,),actor=default_user,+ project_id=sarah_agent.project_id,)# Get usage statistics (should return the latest entry)@@ -6291,6 +6294,7 @@ async def test_job_usage_stats_add_nonexistent_job(server: SyncServer, sarah_agetotal_tokens=150,),actor=default_user,+ project_id=sarah_agent.project_id,)