letta-client 1.0.0a2__py3-none-any.whl → 1.0.0a4__py3-none-any.whl

letta_client/agents/messages/client.py

@@ -64,6 +64,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
@@ -112,7 +113,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.list(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             before="before",
             after="after",
             limit=1,
@@ -160,6 +161,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
@@ -199,7 +201,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.create(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             messages=[
                 MessageCreate(
                     role="user",
@@ -239,8 +241,10 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         message_id : str
+            The ID of the message in the format 'message-<uuid4>'
 
         request : MessagesModifyRequest
 
@@ -261,8 +265,8 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.modify(
-            agent_id="agent_id",
-            message_id="message_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
+            message_id="message-123e4567-e89b-42d3-8456-426614174000",
             request=UpdateSystemMessage(
                 content="content",
             ),
@@ -295,6 +299,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
@@ -343,7 +348,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         response = client.agents.messages.create_stream(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             messages=[
                 MessageCreate(
                     role="user",
@@ -389,6 +394,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         run_ids : typing.Optional[typing.Sequence[str]]
             Optional list of run IDs to cancel
@@ -410,7 +416,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.cancel(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.cancel(agent_id, run_ids=run_ids, request_options=request_options)
@@ -514,6 +520,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
@@ -556,7 +563,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.create_async(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             messages=[
                 MessageCreate(
                     role="user",
@@ -596,6 +603,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         add_default_initial_messages : typing.Optional[bool]
             If true, adds the default initial messages after resetting.
@@ -617,7 +625,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.reset(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             add_default_initial_messages=True,
         )
         """
@@ -639,6 +647,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request : MessagesPreviewRequest
 
@@ -659,7 +668,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.preview(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             request=LettaRequest(
                 messages=[
                     MessageCreate(
@@ -689,6 +698,7 @@ class MessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         max_message_length : int
             Maximum number of messages to retain after summarization.
@@ -709,7 +719,7 @@ class MessagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.messages.summarize(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             max_message_length=1,
         )
         """
@@ -756,6 +766,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
@@ -809,7 +820,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.list(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 before="before",
                 after="after",
                 limit=1,
@@ -860,6 +871,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
@@ -904,7 +916,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.create(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 messages=[
                     MessageCreate(
                         role="user",
@@ -947,8 +959,10 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         message_id : str
+            The ID of the message in the format 'message-<uuid4>'
 
         request : MessagesModifyRequest
 
@@ -974,8 +988,8 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.modify(
-                agent_id="agent_id",
-                message_id="message_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
+                message_id="message-123e4567-e89b-42d3-8456-426614174000",
                 request=UpdateSystemMessage(
                     content="content",
                 ),
@@ -1013,6 +1027,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
@@ -1066,7 +1081,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             response = await client.agents.messages.create_stream(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 messages=[
                     MessageCreate(
                         role="user",
@@ -1116,6 +1131,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         run_ids : typing.Optional[typing.Sequence[str]]
             Optional list of run IDs to cancel
@@ -1142,7 +1158,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.cancel(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 
@@ -1257,6 +1273,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
@@ -1304,7 +1321,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.create_async(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 messages=[
                     MessageCreate(
                         role="user",
@@ -1347,6 +1364,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         add_default_initial_messages : typing.Optional[bool]
             If true, adds the default initial messages after resetting.
@@ -1373,7 +1391,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.reset(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 add_default_initial_messages=True,
             )
 
@@ -1398,6 +1416,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request : MessagesPreviewRequest
 
@@ -1423,7 +1442,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.preview(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 request=LettaRequest(
                     messages=[
                         MessageCreate(
@@ -1456,6 +1475,7 @@ class AsyncMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         max_message_length : int
             Maximum number of messages to retain after summarization.
@@ -1481,7 +1501,7 @@ class AsyncMessagesClient:
 
         async def main() -> None:
             await client.agents.messages.summarize(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 max_message_length=1,
             )
 

letta_client/agents/messages/raw_client.py

@@ -63,6 +63,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
@@ -165,6 +166,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
@@ -255,8 +257,10 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         message_id : str
+            The ID of the message in the format 'message-<uuid4>'
 
         request : MessagesModifyRequest
 
@@ -331,6 +335,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
@@ -452,6 +457,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         run_ids : typing.Optional[typing.Sequence[str]]
             Optional list of run IDs to cancel
@@ -622,6 +628,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
@@ -715,6 +722,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         add_default_initial_messages : typing.Optional[bool]
             If true, adds the default initial messages after resetting.
@@ -774,6 +782,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request : MessagesPreviewRequest
 
@@ -835,6 +844,7 @@ class RawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         max_message_length : int
             Maximum number of messages to retain after summarization.
@@ -900,6 +910,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         before : typing.Optional[str]
             Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
@@ -1002,6 +1013,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
@@ -1092,8 +1104,10 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         message_id : str
+            The ID of the message in the format 'message-<uuid4>'
 
         request : MessagesModifyRequest
 
@@ -1168,6 +1182,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
@@ -1289,6 +1304,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         run_ids : typing.Optional[typing.Sequence[str]]
             Optional list of run IDs to cancel
@@ -1459,6 +1475,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
@@ -1552,6 +1569,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         add_default_initial_messages : typing.Optional[bool]
             If true, adds the default initial messages after resetting.
@@ -1611,6 +1629,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request : MessagesPreviewRequest
 
@@ -1672,6 +1691,7 @@ class AsyncRawMessagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         max_message_length : int
             Maximum number of messages to retain after summarization.

letta_client/agents/passages/client.py

@@ -46,6 +46,7 @@ class PassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         after : typing.Optional[str]
             Unique ID of the memory to start the query range at.
@@ -79,7 +80,7 @@ class PassagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.passages.list(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             after="after",
             before="before",
             limit=1,
@@ -113,6 +114,7 @@ class PassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         text : str
             Text to write to archival memory.
@@ -140,7 +142,7 @@ class PassagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.passages.create(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             text="text",
         )
         """
@@ -171,6 +173,7 @@ class PassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         query : str
             String to search for using semantic similarity
@@ -209,7 +212,7 @@ class PassagesClient:
             token="YOUR_TOKEN",
         )
         client.agents.passages.search(
-            agent_id="agent_id",
+            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
             query="query",
             tag_match_mode="any",
             top_k=1,
@@ -244,6 +247,7 @@ class PassagesClient:
         agent_id : str
 
         memory_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -263,7 +267,7 @@ class PassagesClient:
         )
         client.agents.passages.delete(
             agent_id="agent_id",
-            memory_id="memory_id",
+            memory_id="agent-123e4567-e89b-42d3-8456-426614174000",
         )
         """
         _response = self._raw_client.delete(agent_id, memory_id, request_options=request_options)
@@ -333,6 +337,7 @@ class AsyncPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         after : typing.Optional[str]
             Unique ID of the memory to start the query range at.
@@ -371,7 +376,7 @@ class AsyncPassagesClient:
 
         async def main() -> None:
             await client.agents.passages.list(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 after="after",
                 before="before",
                 limit=1,
@@ -408,6 +413,7 @@ class AsyncPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         text : str
             Text to write to archival memory.
@@ -440,7 +446,7 @@ class AsyncPassagesClient:
 
         async def main() -> None:
             await client.agents.passages.create(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 text="text",
             )
 
@@ -474,6 +480,7 @@ class AsyncPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         query : str
             String to search for using semantic similarity
@@ -516,7 +523,7 @@ class AsyncPassagesClient:
 
         async def main() -> None:
             await client.agents.passages.search(
-                agent_id="agent_id",
+                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
                 query="query",
                 tag_match_mode="any",
                 top_k=1,
@@ -554,6 +561,7 @@ class AsyncPassagesClient:
         agent_id : str
 
         memory_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -578,7 +586,7 @@ class AsyncPassagesClient:
         async def main() -> None:
             await client.agents.passages.delete(
                 agent_id="agent_id",
-                memory_id="memory_id",
+                memory_id="agent-123e4567-e89b-42d3-8456-426614174000",
             )
 
 

letta_client/agents/passages/raw_client.py

@@ -42,6 +42,7 @@ class RawPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         after : typing.Optional[str]
             Unique ID of the memory to start the query range at.
@@ -119,6 +120,7 @@ class RawPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         text : str
             Text to write to archival memory.
@@ -199,6 +201,7 @@ class RawPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         query : str
             String to search for using semantic similarity
@@ -276,6 +279,7 @@ class RawPassagesClient:
         agent_id : str
 
         memory_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -370,6 +374,7 @@ class AsyncRawPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         after : typing.Optional[str]
             Unique ID of the memory to start the query range at.
@@ -447,6 +452,7 @@ class AsyncRawPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         text : str
             Text to write to archival memory.
@@ -527,6 +533,7 @@ class AsyncRawPassagesClient:
         Parameters
         ----------
         agent_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         query : str
             String to search for using semantic similarity
@@ -604,6 +611,7 @@ class AsyncRawPassagesClient:
         agent_id : str
 
         memory_id : str
+            The ID of the agent in the format 'agent-<uuid4>'
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.