@letta-ai/letta-react 0.1.0 → 0.1.1

package/src/schemas/lettaResponse.json

@@ -1 +1,860 @@
-{"properties":{"messages":{"items":{"oneOf":[{"properties":{"id":{"type":"string","title":"Id"},"date":{"type":"string","format":"date-time","title":"Date"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid"},"message_type":{"type":"string","const":"system_message","title":"Message Type","default":"system_message","enum":["system_message"]},"content":{"type":"string","title":"Content","description":"The message content sent by the system"}},"type":"object","required":["id","date","content","message_type"],"title":"SystemMessage","description":"A message generated by the system. Never streamed back on a response, only used for cursor pagination.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    content (str): The message content sent by the system","x-readme-ref-name":"SystemMessage"},{"properties":{"id":{"type":"string","title":"Id"},"date":{"type":"string","format":"date-time","title":"Date"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid"},"message_type":{"type":"string","const":"user_message","title":"Message Type","default":"user_message","enum":["user_message"]},"content":{"anyOf":[{"items":{"oneOf":[{"properties":{"type":{"type":"string","const":"text","title":"Type","description":"The type of the message.","default":"text","enum":["text"]},"text":{"type":"string","title":"Text","description":"The text content of the message."}},"type":"object","required":["text","type","type","type"],"title":"TextContent","x-readme-ref-name":"TextContent"}],"discriminator":{"propertyName":"type","mapping":{"text":"#/components/schemas/TextContent"}},"x-readme-ref-name":"LettaUserMessageContentUnion","properties":{"type":{"enum":["text"]}}},"type":"array"},{"type":"string"}],"title":"Content","description":"The message content sent by the user (can be a string or an array of multi-modal content parts)"}},"type":"object","required":["id","date","content","message_type"],"title":"UserMessage","description":"A message sent by the user. Never streamed back on a response, only used for cursor pagination.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    content (Union[str, List[LettaUserMessageContentUnion]]): The message content sent by the user (can be a string or an array of multi-modal content parts)","x-readme-ref-name":"UserMessage"},{"properties":{"id":{"type":"string","title":"Id"},"date":{"type":"string","format":"date-time","title":"Date"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid"},"message_type":{"type":"string","const":"reasoning_message","title":"Message Type","default":"reasoning_message","enum":["reasoning_message"]},"source":{"type":"string","enum":["reasoner_model","non_reasoner_model"],"title":"Source","default":"non_reasoner_model"},"reasoning":{"type":"string","title":"Reasoning"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"}},"type":"object","required":["id","date","reasoning","message_type"],"title":"ReasoningMessage","description":"Representation of an agent's internal reasoning.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    source (Literal[\"reasoner_model\", \"non_reasoner_model\"]): Whether the reasoning\n        content was generated natively by a reasoner model or derived via prompting\n    reasoning (str): The internal reasoning of the agent\n    signature (Optional[str]): The model-generated signature of the reasoning step","x-readme-ref-name":"ReasoningMessage"},{"properties":{"id":{"type":"string","title":"Id"},"date":{"type":"string","format":"date-time","title":"Date"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid"},"message_type":{"type":"string","const":"hidden_reasoning_message","title":"Message Type","default":"hidden_reasoning_message","enum":["hidden_reasoning_message"]},"state":{"type":"string","enum":["redacted","omitted"],"title":"State"},"hidden_reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hidden Reasoning"}},"type":"object","required":["id","date","state","message_type"],"title":"HiddenReasoningMessage","description":"Representation of an agent's internal reasoning where reasoning content\nhas been hidden from the response.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    state (Literal[\"redacted\", \"omitted\"]): Whether the reasoning\n        content was redacted by the provider or simply omitted by the API\n    hidden_reasoning (Optional[str]): The internal reasoning of the agent","x-readme-ref-name":"HiddenReasoningMessage"},{"properties":{"id":{"type":"string","title":"Id"},"date":{"type":"string","format":"date-time","title":"Date"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid"},"message_type":{"type":"string","const":"tool_call_message","title":"Message Type","default":"tool_call_message","enum":["tool_call_message"]},"tool_call":{"anyOf":[{"properties":{"name":{"type":"string","title":"Name"},"arguments":{"type":"string","title":"Arguments"},"tool_call_id":{"type":"string","title":"Tool Call Id"}},"type":"object","required":["name","arguments","tool_call_id"],"title":"ToolCall","x-readme-ref-name":"ToolCall"},{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"arguments":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Arguments"},"tool_call_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Call Id"}},"type":"object","title":"ToolCallDelta","x-readme-ref-name":"ToolCallDelta"}],"title":"Tool Call"}},"type":"object","required":["id","date","tool_call","message_type"],"title":"ToolCallMessage","description":"A message representing a request to call a tool (generated by the LLM to trigger tool execution).\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    tool_call (Union[ToolCall, ToolCallDelta]): The tool call","x-readme-ref-name":"ToolCallMessage"},{"properties":{"id":{"type":"string","title":"Id"},"date":{"type":"string","format":"date-time","title":"Date"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid"},"message_type":{"type":"string","const":"tool_return_message","title":"Message Type","default":"tool_return_message","enum":["tool_return_message"]},"tool_return":{"type":"string","title":"Tool Return"},"status":{"type":"string","enum":["success","error"],"title":"Status"},"tool_call_id":{"type":"string","title":"Tool Call Id"},"stdout":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stdout"},"stderr":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stderr"}},"type":"object","required":["id","date","tool_return","status","tool_call_id","message_type"],"title":"ToolReturnMessage","description":"A message representing the return value of a tool call (generated by Letta executing the requested tool).\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    tool_return (str): The return value of the tool\n    status (Literal[\"success\", \"error\"]): The status of the tool call\n    tool_call_id (str): A unique identifier for the tool call that generated this message\n    stdout (Optional[List(str)]): Captured stdout (e.g. prints, logs) from the tool invocation\n    stderr (Optional[List(str)]): Captured stderr from the tool invocation","x-readme-ref-name":"ToolReturnMessage"},{"properties":{"id":{"type":"string","title":"Id"},"date":{"type":"string","format":"date-time","title":"Date"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid"},"message_type":{"type":"string","const":"assistant_message","title":"Message Type","default":"assistant_message","enum":["assistant_message"]},"content":{"anyOf":[{"items":{"oneOf":[{"properties":{"type":{"type":"string","const":"text","title":"Type","description":"The type of the message.","default":"text","enum":["text"]},"text":{"type":"string","title":"Text","description":"The text content of the message."}},"type":"object","required":["text","type","type","type"],"title":"TextContent","x-readme-ref-name":"TextContent"}],"discriminator":{"propertyName":"type","mapping":{"text":"#/components/schemas/TextContent"}},"x-readme-ref-name":"LettaAssistantMessageContentUnion","properties":{"type":{"enum":["text"]}}},"type":"array"},{"type":"string"}],"title":"Content","description":"The message content sent by the agent (can be a string or an array of content parts)"}},"type":"object","required":["id","date","content","message_type"],"title":"AssistantMessage","description":"A message sent by the LLM in response to user input. Used in the LLM context.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    content (Union[str, List[LettaAssistantMessageContentUnion]]): The message content sent by the agent (can be a string or an array of content parts)","x-readme-ref-name":"AssistantMessage"}],"discriminator":{"propertyName":"message_type","mapping":{"system_message":"#/components/schemas/SystemMessage","user_message":"#/components/schemas/UserMessage","reasoning_message":"#/components/schemas/ReasoningMessage","hidden_reasoning_message":"#/components/schemas/HiddenReasoningMessage","tool_call_message":"#/components/schemas/ToolCallMessage","tool_return_message":"#/components/schemas/ToolReturnMessage","assistant_message":"#/components/schemas/AssistantMessage"}},"x-readme-ref-name":"LettaMessageUnion","properties":{"message_type":{"enum":["system_message","user_message","reasoning_message","hidden_reasoning_message","tool_call_message","tool_return_message","assistant_message"]}}},"type":"array","title":"Messages","description":"The messages returned by the agent."},"usage":{"description":"The usage statistics of the agent.","properties":{"message_type":{"type":"string","const":"usage_statistics","title":"Message Type","default":"usage_statistics"},"completion_tokens":{"type":"integer","title":"Completion Tokens","description":"The number of tokens generated by the agent.","default":0},"prompt_tokens":{"type":"integer","title":"Prompt Tokens","description":"The number of tokens in the prompt.","default":0},"total_tokens":{"type":"integer","title":"Total Tokens","description":"The total number of tokens processed by the agent.","default":0},"step_count":{"type":"integer","title":"Step Count","description":"The number of steps taken by the agent.","default":0},"steps_messages":{"anyOf":[{"items":{"items":{"properties":{"created_by_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By Id","description":"The id of the user that made this object."},"last_updated_by_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Updated By Id","description":"The id of the user that made this object."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"The timestamp when the object was created."},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"The timestamp when the object was last updated."},"id":{"type":"string","pattern":"^message-[a-fA-F0-9]{8}","title":"Id","description":"The human-friendly ID of the Message","examples":["message-123e4567-e89b-12d3-a456-426614174000"]},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"The unique identifier of the agent."},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"The model used to make the function call."},"role":{"description":"The role of the participant.","type":"string","enum":["assistant","user","tool","function","system"],"title":"MessageRole","x-readme-ref-name":"MessageRole"},"content":{"anyOf":[{"items":{"oneOf":[{"properties":{"type":{"type":"string","const":"text","title":"Type","description":"The type of the message.","default":"text","enum":["text"]},"text":{"type":"string","title":"Text","description":"The text content of the message."}},"type":"object","required":["text","type","type","type"],"title":"TextContent","x-readme-ref-name":"TextContent"},{"properties":{"type":{"type":"string","const":"tool_call","title":"Type","description":"Indicates this content represents a tool call event.","default":"tool_call","enum":["tool_call","tool_return"]},"id":{"type":"string","title":"Id","description":"A unique identifier for this specific tool call instance."},"name":{"type":"string","title":"Name","description":"The name of the tool being called."},"input":{"additionalProperties":true,"type":"object","title":"Input","description":"The parameters being passed to the tool, structured as a dictionary of parameter names to values."}},"type":"object","required":["id","name","input","type","type"],"title":"ToolCallContent","x-readme-ref-name":"ToolCallContent"},{"properties":{"type":{"type":"string","const":"tool_return","title":"Type","description":"Indicates this content represents a tool return event.","default":"tool_return"},"tool_call_id":{"type":"string","title":"Tool Call Id","description":"References the ID of the ToolCallContent that initiated this tool call."},"content":{"type":"string","title":"Content","description":"The content returned by the tool execution."},"is_error":{"type":"boolean","title":"Is Error","description":"Indicates whether the tool execution resulted in an error."}},"type":"object","required":["tool_call_id","content","is_error"],"title":"ToolReturnContent","x-readme-ref-name":"ToolReturnContent"},{"properties":{"type":{"type":"string","const":"reasoning","title":"Type","description":"Indicates this is a reasoning/intermediate step.","default":"reasoning","enum":["reasoning"]},"is_native":{"type":"boolean","title":"Is Native","description":"Whether the reasoning content was generated by a reasoner model that processed this step."},"reasoning":{"type":"string","title":"Reasoning","description":"The intermediate reasoning or thought process content."},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature","description":"A unique identifier for this reasoning step."}},"type":"object","required":["is_native","reasoning","type"],"title":"ReasoningContent","x-readme-ref-name":"ReasoningContent"},{"properties":{"type":{"type":"string","const":"redacted_reasoning","title":"Type","description":"Indicates this is a redacted thinking step.","default":"redacted_reasoning","enum":["redacted_reasoning"]},"data":{"type":"string","title":"Data","description":"The redacted or filtered intermediate reasoning content."}},"type":"object","required":["data","type"],"title":"RedactedReasoningContent","x-readme-ref-name":"RedactedReasoningContent"},{"properties":{"type":{"type":"string","const":"omitted_reasoning","title":"Type","description":"Indicates this is an omitted reasoning step.","default":"omitted_reasoning","enum":["omitted_reasoning"]},"tokens":{"type":"integer","title":"Tokens","description":"The reasoning token count for intermediate reasoning content."}},"type":"object","required":["tokens","type"],"title":"OmittedReasoningContent","x-readme-ref-name":"OmittedReasoningContent"}],"discriminator":{"propertyName":"type","mapping":{"omitted_reasoning":"#/components/schemas/OmittedReasoningContent","reasoning":"#/components/schemas/ReasoningContent","redacted_reasoning":"#/components/schemas/RedactedReasoningContent","text":"#/components/schemas/TextContent","tool_call":"#/components/schemas/ToolCallContent","tool_return":"#/components/schemas/ToolReturnContent"}}},"type":"array"},{"type":"null"}],"title":"Content","description":"The content of the message."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"For role user/assistant: the (optional) name of the participant. For role tool/function: the name of the function called."},"tool_calls":{"anyOf":[{"items":{"properties":{"id":{"type":"string","title":"Id"},"function":{"properties":{"arguments":{"type":"string","title":"Arguments"},"name":{"type":"string","title":"Name"}},"additionalProperties":true,"type":"object","required":["arguments","name"],"title":"Function","x-readme-ref-name":"Function-Output"},"type":{"type":"string","const":"function","title":"Type"}},"additionalProperties":true,"type":"object","required":["id","function","type"],"title":"ChatCompletionMessageToolCall","x-readme-ref-name":"ChatCompletionMessageToolCall"},"type":"array"},{"type":"null"}],"title":"Tool Calls","description":"The list of tool calls requested. Only applicable for role assistant."},"tool_call_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Call Id","description":"The ID of the tool call. Only applicable for role tool."},"step_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Id","description":"The id of the step that this message was created in."},"otid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otid","description":"The offline threading id associated with this message"},"tool_returns":{"anyOf":[{"items":{"properties":{"status":{"type":"string","enum":["success","error"],"title":"Status","description":"The status of the tool call"},"stdout":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stdout","description":"Captured stdout (e.g. prints, logs) from the tool invocation"},"stderr":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stderr","description":"Captured stderr from the tool invocation"}},"type":"object","required":["status"],"title":"ToolReturn","x-readme-ref-name":"ToolReturn"},"type":"array"},{"type":"null"}],"title":"Tool Returns","description":"Tool execution return information for prior tool calls"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id","description":"The multi-agent group that the message was sent in"}},"additionalProperties":false,"type":"object","required":["role"],"title":"Message","description":"Letta's internal representation of a message. Includes methods to convert to/from LLM provider formats.\n\nAttributes:\n    id (str): The unique identifier of the message.\n    role (MessageRole): The role of the participant.\n    text (str): The text of the message.\n    user_id (str): The unique identifier of the user.\n    agent_id (str): The unique identifier of the agent.\n    model (str): The model used to make the function call.\n    name (str): The name of the participant.\n    created_at (datetime): The time the message was created.\n    tool_calls (List[OpenAIToolCall,]): The list of tool calls requested.\n    tool_call_id (str): The id of the tool call.","x-readme-ref-name":"Message"},"type":"array"},"type":"array"},{"type":"null"}],"title":"Steps Messages","description":"The messages generated per step"},"run_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Run Ids","description":"The background task run IDs associated with the agent interaction"}},"type":"object","title":"LettaUsageStatistics","x-readme-ref-name":"LettaUsageStatistics"}},"type":"object","required":["messages","usage"],"title":"LettaResponse","description":"Response object from an agent interaction, consisting of the new messages generated by the agent and usage statistics.\nThe type of the returned messages can be either `Message` or `LettaMessage`, depending on what was specified in the request.\n\nAttributes:\n    messages (List[Union[Message, LettaMessage]]): The messages returned by the agent.\n    usage (LettaUsageStatistics): The usage statistics","x-readme-ref-name":"LettaResponse"}
+{
+  "properties": {
+    "messages": {
+      "items": {
+        "oneOf": [
+          {
+            "properties": {
+              "id": { "type": "string", "title": "Id" },
+              "date": {
+                "type": "string",
+                "format": "date-time",
+                "title": "Date"
+              },
+              "name": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Name"
+              },
+              "otid": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Otid"
+              },
+              "message_type": {
+                "type": "string",
+                "const": "system_message",
+                "title": "Message Type",
+                "default": "system_message",
+                "enum": ["system_message"]
+              },
+              "content": {
+                "type": "string",
+                "title": "Content",
+                "description": "The message content sent by the system"
+              }
+            },
+            "type": "object",
+            "required": ["id", "date", "content", "message_type"],
+            "title": "SystemMessage",
+            "description": "A message generated by the system. Never streamed back on a response, only used for cursor pagination.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    content (str): The message content sent by the system",
+            "x-readme-ref-name": "SystemMessage"
+          },
+          {
+            "properties": {
+              "id": { "type": "string", "title": "Id" },
+              "date": {
+                "type": "string",
+                "format": "date-time",
+                "title": "Date"
+              },
+              "name": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Name"
+              },
+              "otid": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Otid"
+              },
+              "message_type": {
+                "type": "string",
+                "const": "user_message",
+                "title": "Message Type",
+                "default": "user_message",
+                "enum": ["user_message"]
+              },
+              "content": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "oneOf": [
+                        {
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "text",
+                              "title": "Type",
+                              "description": "The type of the message.",
+                              "default": "text",
+                              "enum": ["text"]
+                            },
+                            "text": {
+                              "type": "string",
+                              "title": "Text",
+                              "description": "The text content of the message."
+                            }
+                          },
+                          "type": "object",
+                          "required": ["text", "type", "type", "type"],
+                          "title": "TextContent",
+                          "x-readme-ref-name": "TextContent"
+                        }
+                      ],
+                      "discriminator": {
+                        "propertyName": "type",
+                        "mapping": {
+                          "text": "#/components/schemas/TextContent"
+                        }
+                      },
+                      "x-readme-ref-name": "LettaUserMessageContentUnion",
+                      "properties": { "type": { "enum": ["text"] } }
+                    },
+                    "type": "array"
+                  },
+                  { "type": "string" }
+                ],
+                "title": "Content",
+                "description": "The message content sent by the user (can be a string or an array of multi-modal content parts)"
+              }
+            },
+            "type": "object",
+            "required": ["id", "date", "content", "message_type"],
+            "title": "UserMessage",
+            "description": "A message sent by the user. Never streamed back on a response, only used for cursor pagination.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    content (Union[str, List[LettaUserMessageContentUnion]]): The message content sent by the user (can be a string or an array of multi-modal content parts)",
+            "x-readme-ref-name": "UserMessage"
+          },
+          {
+            "properties": {
+              "id": { "type": "string", "title": "Id" },
+              "date": {
+                "type": "string",
+                "format": "date-time",
+                "title": "Date"
+              },
+              "name": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Name"
+              },
+              "otid": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Otid"
+              },
+              "message_type": {
+                "type": "string",
+                "const": "reasoning_message",
+                "title": "Message Type",
+                "default": "reasoning_message",
+                "enum": ["reasoning_message"]
+              },
+              "source": {
+                "type": "string",
+                "enum": ["reasoner_model", "non_reasoner_model"],
+                "title": "Source",
+                "default": "non_reasoner_model"
+              },
+              "reasoning": { "type": "string", "title": "Reasoning" },
+              "signature": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Signature"
+              }
+            },
+            "type": "object",
+            "required": ["id", "date", "reasoning", "message_type"],
+            "title": "ReasoningMessage",
+            "description": "Representation of an agent's internal reasoning.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    source (Literal[\"reasoner_model\", \"non_reasoner_model\"]): Whether the reasoning\n        content was generated natively by a reasoner model or derived via prompting\n    reasoning (str): The internal reasoning of the agent\n    signature (Optional[str]): The model-generated signature of the reasoning step",
+            "x-readme-ref-name": "ReasoningMessage"
+          },
+          {
+            "properties": {
+              "id": { "type": "string", "title": "Id" },
+              "date": {
+                "type": "string",
+                "format": "date-time",
+                "title": "Date"
+              },
+              "name": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Name"
+              },
+              "otid": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Otid"
+              },
+              "message_type": {
+                "type": "string",
+                "const": "hidden_reasoning_message",
+                "title": "Message Type",
+                "default": "hidden_reasoning_message",
+                "enum": ["hidden_reasoning_message"]
+              },
+              "state": {
+                "type": "string",
+                "enum": ["redacted", "omitted"],
+                "title": "State"
+              },
+              "hidden_reasoning": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Hidden Reasoning"
+              }
+            },
+            "type": "object",
+            "required": ["id", "date", "state", "message_type"],
+            "title": "HiddenReasoningMessage",
+            "description": "Representation of an agent's internal reasoning where reasoning content\nhas been hidden from the response.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    state (Literal[\"redacted\", \"omitted\"]): Whether the reasoning\n        content was redacted by the provider or simply omitted by the API\n    hidden_reasoning (Optional[str]): The internal reasoning of the agent",
+            "x-readme-ref-name": "HiddenReasoningMessage"
+          },
+          {
+            "properties": {
+              "id": { "type": "string", "title": "Id" },
+              "date": {
+                "type": "string",
+                "format": "date-time",
+                "title": "Date"
+              },
+              "name": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Name"
+              },
+              "otid": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Otid"
+              },
+              "message_type": {
+                "type": "string",
+                "const": "tool_call_message",
+                "title": "Message Type",
+                "default": "tool_call_message",
+                "enum": ["tool_call_message"]
+              },
+              "tool_call": {
+                "anyOf": [
+                  {
+                    "properties": {
+                      "name": { "type": "string", "title": "Name" },
+                      "arguments": { "type": "string", "title": "Arguments" },
+                      "tool_call_id": {
+                        "type": "string",
+                        "title": "Tool Call Id"
+                      }
+                    },
+                    "type": "object",
+                    "required": ["name", "arguments", "tool_call_id"],
+                    "title": "ToolCall",
+                    "x-readme-ref-name": "ToolCall"
+                  },
+                  {
+                    "properties": {
+                      "name": {
+                        "anyOf": [{ "type": "string" }, { "type": "null" }],
+                        "title": "Name"
+                      },
+                      "arguments": {
+                        "anyOf": [{ "type": "string" }, { "type": "null" }],
+                        "title": "Arguments"
+                      },
+                      "tool_call_id": {
+                        "anyOf": [{ "type": "string" }, { "type": "null" }],
+                        "title": "Tool Call Id"
+                      }
+                    },
+                    "type": "object",
+                    "title": "ToolCallDelta",
+                    "x-readme-ref-name": "ToolCallDelta"
+                  }
+                ],
+                "title": "Tool Call"
+              }
+            },
+            "type": "object",
+            "required": ["id", "date", "tool_call", "message_type"],
+            "title": "ToolCallMessage",
+            "description": "A message representing a request to call a tool (generated by the LLM to trigger tool execution).\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    tool_call (Union[ToolCall, ToolCallDelta]): The tool call",
+            "x-readme-ref-name": "ToolCallMessage"
+          },
+          {
+            "properties": {
+              "id": { "type": "string", "title": "Id" },
+              "date": {
+                "type": "string",
+                "format": "date-time",
+                "title": "Date"
+              },
+              "name": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Name"
+              },
+              "otid": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Otid"
+              },
+              "message_type": {
+                "type": "string",
+                "const": "tool_return_message",
+                "title": "Message Type",
+                "default": "tool_return_message",
+                "enum": ["tool_return_message"]
+              },
+              "tool_return": { "type": "string", "title": "Tool Return" },
+              "status": {
+                "type": "string",
+                "enum": ["success", "error"],
+                "title": "Status"
+              },
+              "tool_call_id": { "type": "string", "title": "Tool Call Id" },
+              "stdout": {
+                "anyOf": [
+                  { "items": { "type": "string" }, "type": "array" },
+                  { "type": "null" }
+                ],
+                "title": "Stdout"
+              },
+              "stderr": {
+                "anyOf": [
+                  { "items": { "type": "string" }, "type": "array" },
+                  { "type": "null" }
+                ],
+                "title": "Stderr"
+              }
+            },
+            "type": "object",
+            "required": [
+              "id",
+              "date",
+              "tool_return",
+              "status",
+              "tool_call_id",
+              "message_type"
+            ],
+            "title": "ToolReturnMessage",
+            "description": "A message representing the return value of a tool call (generated by Letta executing the requested tool).\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    tool_return (str): The return value of the tool\n    status (Literal[\"success\", \"error\"]): The status of the tool call\n    tool_call_id (str): A unique identifier for the tool call that generated this message\n    stdout (Optional[List(str)]): Captured stdout (e.g. prints, logs) from the tool invocation\n    stderr (Optional[List(str)]): Captured stderr from the tool invocation",
+            "x-readme-ref-name": "ToolReturnMessage"
+          },
+          {
+            "properties": {
+              "id": { "type": "string", "title": "Id" },
+              "date": {
+                "type": "string",
+                "format": "date-time",
+                "title": "Date"
+              },
+              "name": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Name"
+              },
+              "otid": {
+                "anyOf": [{ "type": "string" }, { "type": "null" }],
+                "title": "Otid"
+              },
+              "message_type": {
+                "type": "string",
+                "const": "assistant_message",
+                "title": "Message Type",
+                "default": "assistant_message",
+                "enum": ["assistant_message"]
+              },
+              "content": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "oneOf": [
+                        {
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "text",
+                              "title": "Type",
+                              "description": "The type of the message.",
+                              "default": "text",
+                              "enum": ["text"]
+                            },
+                            "text": {
+                              "type": "string",
+                              "title": "Text",
+                              "description": "The text content of the message."
+                            }
+                          },
+                          "type": "object",
+                          "required": ["text", "type", "type", "type"],
+                          "title": "TextContent",
+                          "x-readme-ref-name": "TextContent"
+                        }
+                      ],
+                      "discriminator": {
+                        "propertyName": "type",
+                        "mapping": {
+                          "text": "#/components/schemas/TextContent"
+                        }
+                      },
+                      "x-readme-ref-name": "LettaAssistantMessageContentUnion",
+                      "properties": { "type": { "enum": ["text"] } }
+                    },
+                    "type": "array"
+                  },
+                  { "type": "string" }
+                ],
+                "title": "Content",
+                "description": "The message content sent by the agent (can be a string or an array of content parts)"
+              }
+            },
+            "type": "object",
+            "required": ["id", "date", "content", "message_type"],
+            "title": "AssistantMessage",
+            "description": "A message sent by the LLM in response to user input. Used in the LLM context.\n\nArgs:\n    id (str): The ID of the message\n    date (datetime): The date the message was created in ISO format\n    name (Optional[str]): The name of the sender of the message\n    content (Union[str, List[LettaAssistantMessageContentUnion]]): The message content sent by the agent (can be a string or an array of content parts)",
+            "x-readme-ref-name": "AssistantMessage"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "message_type",
+          "mapping": {
+            "system_message": "#/components/schemas/SystemMessage",
+            "user_message": "#/components/schemas/UserMessage",
+            "reasoning_message": "#/components/schemas/ReasoningMessage",
+            "hidden_reasoning_message": "#/components/schemas/HiddenReasoningMessage",
+            "tool_call_message": "#/components/schemas/ToolCallMessage",
+            "tool_return_message": "#/components/schemas/ToolReturnMessage",
+            "assistant_message": "#/components/schemas/AssistantMessage"
+          }
+        },
+        "x-readme-ref-name": "LettaMessageUnion",
+        "properties": {
+          "message_type": {
+            "enum": [
+              "system_message",
+              "user_message",
+              "reasoning_message",
+              "hidden_reasoning_message",
+              "tool_call_message",
+              "tool_return_message",
+              "assistant_message"
+            ]
+          }
+        }
+      },
+      "type": "array",
+      "title": "Messages",
+      "description": "The messages returned by the agent."
+    },
+    "usage": {
+      "description": "The usage statistics of the agent.",
+      "properties": {
+        "message_type": {
+          "type": "string",
+          "const": "usage_statistics",
+          "title": "Message Type",
+          "default": "usage_statistics"
+        },
+        "completion_tokens": {
+          "type": "integer",
+          "title": "Completion Tokens",
+          "description": "The number of tokens generated by the agent.",
+          "default": 0
+        },
+        "prompt_tokens": {
+          "type": "integer",
+          "title": "Prompt Tokens",
+          "description": "The number of tokens in the prompt.",
+          "default": 0
+        },
+        "total_tokens": {
+          "type": "integer",
+          "title": "Total Tokens",
+          "description": "The total number of tokens processed by the agent.",
+          "default": 0
+        },
+        "step_count": {
+          "type": "integer",
+          "title": "Step Count",
+          "description": "The number of steps taken by the agent.",
+          "default": 0
+        },
+        "steps_messages": {
+          "anyOf": [
+            {
+              "items": {
+                "items": {
+                  "properties": {
+                    "created_by_id": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Created By Id",
+                      "description": "The id of the user that made this object."
+                    },
+                    "last_updated_by_id": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Last Updated By Id",
+                      "description": "The id of the user that made this object."
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "title": "Created At",
+                      "description": "The timestamp when the object was created."
+                    },
+                    "updated_at": {
+                      "anyOf": [
+                        { "type": "string", "format": "date-time" },
+                        { "type": "null" }
+                      ],
+                      "title": "Updated At",
+                      "description": "The timestamp when the object was last updated."
+                    },
+                    "id": {
+                      "type": "string",
+                      "pattern": "^message-[a-fA-F0-9]{8}",
+                      "title": "Id",
+                      "description": "The human-friendly ID of the Message",
+                      "examples": [
+                        "message-123e4567-e89b-12d3-a456-426614174000"
+                      ]
+                    },
+                    "agent_id": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Agent Id",
+                      "description": "The unique identifier of the agent."
+                    },
+                    "model": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Model",
+                      "description": "The model used to make the function call."
+                    },
+                    "role": {
+                      "description": "The role of the participant.",
+                      "type": "string",
+                      "enum": [
+                        "assistant",
+                        "user",
+                        "tool",
+                        "function",
+                        "system"
+                      ],
+                      "title": "MessageRole",
+                      "x-readme-ref-name": "MessageRole"
+                    },
+                    "content": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "oneOf": [
+                              {
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "text",
+                                    "title": "Type",
+                                    "description": "The type of the message.",
+                                    "default": "text",
+                                    "enum": ["text"]
+                                  },
+                                  "text": {
+                                    "type": "string",
+                                    "title": "Text",
+                                    "description": "The text content of the message."
+                                  }
+                                },
+                                "type": "object",
+                                "required": ["text", "type", "type", "type"],
+                                "title": "TextContent",
+                                "x-readme-ref-name": "TextContent"
+                              },
+                              {
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "tool_call",
+                                    "title": "Type",
+                                    "description": "Indicates this content represents a tool call event.",
+                                    "default": "tool_call",
+                                    "enum": ["tool_call", "tool_return"]
+                                  },
+                                  "id": {
+                                    "type": "string",
+                                    "title": "Id",
+                                    "description": "A unique identifier for this specific tool call instance."
+                                  },
+                                  "name": {
+                                    "type": "string",
+                                    "title": "Name",
+                                    "description": "The name of the tool being called."
+                                  },
+                                  "input": {
+                                    "additionalProperties": true,
+                                    "type": "object",
+                                    "title": "Input",
+                                    "description": "The parameters being passed to the tool, structured as a dictionary of parameter names to values."
+                                  }
+                                },
+                                "type": "object",
+                                "required": [
+                                  "id",
+                                  "name",
+                                  "input",
+                                  "type",
+                                  "type"
+                                ],
+                                "title": "ToolCallContent",
+                                "x-readme-ref-name": "ToolCallContent"
+                              },
+                              {
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "tool_return",
+                                    "title": "Type",
+                                    "description": "Indicates this content represents a tool return event.",
+                                    "default": "tool_return"
+                                  },
+                                  "tool_call_id": {
+                                    "type": "string",
+                                    "title": "Tool Call Id",
+                                    "description": "References the ID of the ToolCallContent that initiated this tool call."
+                                  },
+                                  "content": {
+                                    "type": "string",
+                                    "title": "Content",
+                                    "description": "The content returned by the tool execution."
+                                  },
+                                  "is_error": {
+                                    "type": "boolean",
+                                    "title": "Is Error",
+                                    "description": "Indicates whether the tool execution resulted in an error."
+                                  }
+                                },
+                                "type": "object",
+                                "required": [
+                                  "tool_call_id",
+                                  "content",
+                                  "is_error"
+                                ],
+                                "title": "ToolReturnContent",
+                                "x-readme-ref-name": "ToolReturnContent"
+                              },
+                              {
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "reasoning",
+                                    "title": "Type",
+                                    "description": "Indicates this is a reasoning/intermediate step.",
+                                    "default": "reasoning",
+                                    "enum": ["reasoning"]
+                                  },
+                                  "is_native": {
+                                    "type": "boolean",
+                                    "title": "Is Native",
+                                    "description": "Whether the reasoning content was generated by a reasoner model that processed this step."
+                                  },
+                                  "reasoning": {
+                                    "type": "string",
+                                    "title": "Reasoning",
+                                    "description": "The intermediate reasoning or thought process content."
+                                  },
+                                  "signature": {
+                                    "anyOf": [
+                                      { "type": "string" },
+                                      { "type": "null" }
+                                    ],
+                                    "title": "Signature",
+                                    "description": "A unique identifier for this reasoning step."
+                                  }
+                                },
+                                "type": "object",
+                                "required": ["is_native", "reasoning", "type"],
+                                "title": "ReasoningContent",
+                                "x-readme-ref-name": "ReasoningContent"
+                              },
+                              {
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "redacted_reasoning",
+                                    "title": "Type",
+                                    "description": "Indicates this is a redacted thinking step.",
+                                    "default": "redacted_reasoning",
+                                    "enum": ["redacted_reasoning"]
+                                  },
+                                  "data": {
+                                    "type": "string",
+                                    "title": "Data",
+                                    "description": "The redacted or filtered intermediate reasoning content."
+                                  }
+                                },
+                                "type": "object",
+                                "required": ["data", "type"],
+                                "title": "RedactedReasoningContent",
+                                "x-readme-ref-name": "RedactedReasoningContent"
+                              },
+                              {
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "omitted_reasoning",
+                                    "title": "Type",
+                                    "description": "Indicates this is an omitted reasoning step.",
+                                    "default": "omitted_reasoning",
+                                    "enum": ["omitted_reasoning"]
+                                  },
+                                  "tokens": {
+                                    "type": "integer",
+                                    "title": "Tokens",
+                                    "description": "The reasoning token count for intermediate reasoning content."
+                                  }
+                                },
+                                "type": "object",
+                                "required": ["tokens", "type"],
+                                "title": "OmittedReasoningContent",
+                                "x-readme-ref-name": "OmittedReasoningContent"
+                              }
+                            ],
+                            "discriminator": {
+                              "propertyName": "type",
+                              "mapping": {
+                                "omitted_reasoning": "#/components/schemas/OmittedReasoningContent",
+                                "reasoning": "#/components/schemas/ReasoningContent",
+                                "redacted_reasoning": "#/components/schemas/RedactedReasoningContent",
+                                "text": "#/components/schemas/TextContent",
+                                "tool_call": "#/components/schemas/ToolCallContent",
+                                "tool_return": "#/components/schemas/ToolReturnContent"
+                              }
+                            }
+                          },
+                          "type": "array"
+                        },
+                        { "type": "null" }
+                      ],
+                      "title": "Content",
+                      "description": "The content of the message."
+                    },
+                    "name": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Name",
+                      "description": "For role user/assistant: the (optional) name of the participant. For role tool/function: the name of the function called."
+                    },
+                    "tool_calls": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "properties": {
+                              "id": { "type": "string", "title": "Id" },
+                              "function": {
+                                "properties": {
+                                  "arguments": {
+                                    "type": "string",
+                                    "title": "Arguments"
+                                  },
+                                  "name": { "type": "string", "title": "Name" }
+                                },
+                                "additionalProperties": true,
+                                "type": "object",
+                                "required": ["arguments", "name"],
+                                "title": "Function",
+                                "x-readme-ref-name": "Function-Output"
+                              },
+                              "type": {
+                                "type": "string",
+                                "const": "function",
+                                "title": "Type"
+                              }
+                            },
+                            "additionalProperties": true,
+                            "type": "object",
+                            "required": ["id", "function", "type"],
+                            "title": "ChatCompletionMessageToolCall",
+                            "x-readme-ref-name": "ChatCompletionMessageToolCall"
+                          },
+                          "type": "array"
+                        },
+                        { "type": "null" }
+                      ],
+                      "title": "Tool Calls",
+                      "description": "The list of tool calls requested. Only applicable for role assistant."
+                    },
+                    "tool_call_id": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Tool Call Id",
+                      "description": "The ID of the tool call. Only applicable for role tool."
+                    },
+                    "step_id": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Step Id",
+                      "description": "The id of the step that this message was created in."
+                    },
+                    "otid": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Otid",
+                      "description": "The offline threading id associated with this message"
+                    },
+                    "tool_returns": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "properties": {
+                              "status": {
+                                "type": "string",
+                                "enum": ["success", "error"],
+                                "title": "Status",
+                                "description": "The status of the tool call"
+                              },
+                              "stdout": {
+                                "anyOf": [
+                                  {
+                                    "items": { "type": "string" },
+                                    "type": "array"
+                                  },
+                                  { "type": "null" }
+                                ],
+                                "title": "Stdout",
+                                "description": "Captured stdout (e.g. prints, logs) from the tool invocation"
+                              },
+                              "stderr": {
+                                "anyOf": [
+                                  {
+                                    "items": { "type": "string" },
+                                    "type": "array"
+                                  },
+                                  { "type": "null" }
+                                ],
+                                "title": "Stderr",
+                                "description": "Captured stderr from the tool invocation"
+                              }
+                            },
+                            "type": "object",
+                            "required": ["status"],
+                            "title": "ToolReturn",
+                            "x-readme-ref-name": "ToolReturn"
+                          },
+                          "type": "array"
+                        },
+                        { "type": "null" }
+                      ],
+                      "title": "Tool Returns",
+                      "description": "Tool execution return information for prior tool calls"
+                    },
+                    "group_id": {
+                      "anyOf": [{ "type": "string" }, { "type": "null" }],
+                      "title": "Group Id",
+                      "description": "The multi-agent group that the message was sent in"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": ["role"],
+                  "title": "Message",
+                  "description": "Letta's internal representation of a message. Includes methods to convert to/from LLM provider formats.\n\nAttributes:\n    id (str): The unique identifier of the message.\n    role (MessageRole): The role of the participant.\n    text (str): The text of the message.\n    user_id (str): The unique identifier of the user.\n    agent_id (str): The unique identifier of the agent.\n    model (str): The model used to make the function call.\n    name (str): The name of the participant.\n    created_at (datetime): The time the message was created.\n    tool_calls (List[OpenAIToolCall,]): The list of tool calls requested.\n    tool_call_id (str): The id of the tool call.",
+                  "x-readme-ref-name": "Message"
+                },
+                "type": "array"
+              },
+              "type": "array"
+            },
+            { "type": "null" }
+          ],
+          "title": "Steps Messages",
+          "description": "The messages generated per step"
+        },
+        "run_ids": {
+          "anyOf": [
+            { "items": { "type": "string" }, "type": "array" },
+            { "type": "null" }
+          ],
+          "title": "Run Ids",
+          "description": "The background task run IDs associated with the agent interaction"
+        }
+      },
+      "type": "object",
+      "title": "LettaUsageStatistics",
+      "x-readme-ref-name": "LettaUsageStatistics"
+    }
+  },
+  "type": "object",
+  "required": ["messages", "usage"],
+  "title": "LettaResponse",
+  "description": "Response object from an agent interaction, consisting of the new messages generated by the agent and usage statistics.\nThe type of the returned messages can be either `Message` or `LettaMessage`, depending on what was specified in the request.\n\nAttributes:\n    messages (List[Union[Message, LettaMessage]]): The messages returned by the agent.\n    usage (LettaUsageStatistics): The usage statistics",
+  "x-readme-ref-name": "LettaResponse"
+}