feat(core): add conversation archive fields and filtering

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 126
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-c9d5c27d12c9054a602aa3e7fee4c292582dce393231776e010a76c54b2d5600.yml
-openapi_spec_hash: 8b150cdf0e4de6c89848f24f6d15e6c3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-2fcabe48fcd0f7ea8bb7af9870483b1369331f0fc345e085d607ff3cbd31b44b.yml
+openapi_spec_hash: af474c9c636bde8224321911d2272d09
 config_hash: f2ff70633d052a11601ad82a5afcfaec

src/letta_client/resources/conversations/conversations.py

@@ -167,6 +167,7 @@ def update(
         self,
         conversation_id: str,
         *,
+        archived: Optional[bool] | Omit = omit,
         last_message_at: Union[str, datetime, None] | Omit = omit,
         model: Optional[str] | Omit = omit,
         model_settings: Optional[conversation_update_params.ModelSettings] | Omit = omit,
@@ -184,6 +185,8 @@ def update(
         Args:
           conversation_id: The ID of the conv in the format 'conv-<uuid4>'
 
+          archived: Whether the conversation is archived.
+
           last_message_at: Timestamp of the most recent message request sent to this conversation.
 
           model:
@@ -208,6 +211,7 @@ def update(
             path_template("/v1/conversations/{conversation_id}", conversation_id=conversation_id),
             body=maybe_transform(
                 {
+                    "archived": archived,
                     "last_message_at": last_message_at,
                     "model": model,
                     "model_settings": model_settings,
@@ -226,6 +230,7 @@ def list(
         *,
         after: Optional[str] | Omit = omit,
         agent_id: Optional[str] | Omit = omit,
+        archive_status: Literal["unarchived", "archived", "all"] | Omit = omit,
         limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         order_by: Literal["created_at", "last_run_completion", "last_message_at"] | Omit = omit,
@@ -247,6 +252,9 @@ def list(
           agent_id: The agent ID to list conversations for (optional - returns all conversations if
               not provided)
 
+          archive_status: Whether to return unarchived conversations only, archived conversations only, or
+              all conversations
+
           limit: Maximum number of conversations to return
 
           order: Sort order for conversations. 'asc' for oldest first, 'desc' for newest first
@@ -274,6 +282,7 @@ def list(
                     {
                         "after": after,
                         "agent_id": agent_id,
+                        "archive_status": archive_status,
                         "limit": limit,
                         "order": order,
                         "order_by": order_by,
@@ -621,6 +630,7 @@ async def update(
         self,
         conversation_id: str,
         *,
+        archived: Optional[bool] | Omit = omit,
         last_message_at: Union[str, datetime, None] | Omit = omit,
         model: Optional[str] | Omit = omit,
         model_settings: Optional[conversation_update_params.ModelSettings] | Omit = omit,
@@ -638,6 +648,8 @@ async def update(
         Args:
           conversation_id: The ID of the conv in the format 'conv-<uuid4>'
 
+          archived: Whether the conversation is archived.
+
           last_message_at: Timestamp of the most recent message request sent to this conversation.
 
           model:
@@ -662,6 +674,7 @@ async def update(
             path_template("/v1/conversations/{conversation_id}", conversation_id=conversation_id),
             body=await async_maybe_transform(
                 {
+                    "archived": archived,
                     "last_message_at": last_message_at,
                     "model": model,
                     "model_settings": model_settings,
@@ -680,6 +693,7 @@ async def list(
         *,
         after: Optional[str] | Omit = omit,
         agent_id: Optional[str] | Omit = omit,
+        archive_status: Literal["unarchived", "archived", "all"] | Omit = omit,
         limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         order_by: Literal["created_at", "last_run_completion", "last_message_at"] | Omit = omit,
@@ -701,6 +715,9 @@ async def list(
           agent_id: The agent ID to list conversations for (optional - returns all conversations if
               not provided)
 
+          archive_status: Whether to return unarchived conversations only, archived conversations only, or
+              all conversations
+
           limit: Maximum number of conversations to return
 
           order: Sort order for conversations. 'asc' for oldest first, 'desc' for newest first
@@ -728,6 +745,7 @@ async def list(
                     {
                         "after": after,
                         "agent_id": agent_id,
+                        "archive_status": archive_status,
                         "limit": limit,
                         "order": order,
                         "order_by": order_by,

src/letta_client/types/conversation.py

@@ -222,6 +222,12 @@ class Conversation(BaseModel):
     agent_id: str
     """The ID of the agent this conversation belongs to."""
 
+    archived: Optional[bool] = None
+    """Whether the conversation is archived."""
+
+    archived_at: Optional[datetime] = None
+    """Timestamp of when the conversation was archived."""
+
     created_at: Optional[datetime] = None
     """The timestamp when the object was created."""
 

src/letta_client/types/conversation_list_params.py

@@ -18,6 +18,12 @@ class ConversationListParams(TypedDict, total=False):
     not provided)
     """
 
+    archive_status: Literal["unarchived", "archived", "all"]
+    """
+    Whether to return unarchived conversations only, archived conversations only, or
+    all conversations
+    """
+
     limit: int
     """Maximum number of conversations to return"""
 

src/letta_client/types/conversation_update_params.py

@@ -39,6 +39,9 @@
 
 
 class ConversationUpdateParams(TypedDict, total=False):
+    archived: Optional[bool]
+    """Whether the conversation is archived."""
+
     last_message_at: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
     """Timestamp of the most recent message request sent to this conversation."""
 

tests/api_resources/test_conversations.py

@@ -131,6 +131,7 @@ def test_method_update(self, client: Letta) -> None:
     def test_method_update_with_all_params(self, client: Letta) -> None:
         conversation = client.conversations.update(
             conversation_id="conv-123e4567-e89b-42d3-8456-426614174000",
+            archived=True,
             last_message_at=parse_datetime("2019-12-27T18:11:19.117Z"),
             model="model",
             model_settings={
@@ -192,6 +193,7 @@ def test_method_list_with_all_params(self, client: Letta) -> None:
         conversation = client.conversations.list(
             after="after",
             agent_id="agent_id",
+            archive_status="unarchived",
             limit=0,
             order="asc",
             order_by="created_at",
@@ -549,6 +551,7 @@ async def test_method_update(self, async_client: AsyncLetta) -> None:
     async def test_method_update_with_all_params(self, async_client: AsyncLetta) -> None:
         conversation = await async_client.conversations.update(
             conversation_id="conv-123e4567-e89b-42d3-8456-426614174000",
+            archived=True,
             last_message_at=parse_datetime("2019-12-27T18:11:19.117Z"),
             model="model",
             model_settings={
@@ -610,6 +613,7 @@ async def test_method_list_with_all_params(self, async_client: AsyncLetta) -> No
         conversation = await async_client.conversations.list(
             after="after",
             agent_id="agent_id",
+            archive_status="unarchived",
             limit=0,
             order="asc",
             order_by="created_at",