@letta-ai/letta-react 0.0.9 → 0.1.1

package/src/schemas/lettaUserMessageContentUnion.json

@@ -0,0 +1,31 @@
+{
+  "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"] } }
+}

package/src/schemas/localSandboxConfig.json

@@ -0,0 +1,48 @@
+{
+  "properties": {
+    "sandbox_dir": {
+      "anyOf": [{ "type": "string" }, { "type": "null" }],
+      "title": "Sandbox Dir",
+      "description": "Directory for the sandbox environment."
+    },
+    "use_venv": {
+      "type": "boolean",
+      "title": "Use Venv",
+      "description": "Whether or not to use the venv, or run directly in the same run loop.",
+      "default": false
+    },
+    "venv_name": {
+      "type": "string",
+      "title": "Venv Name",
+      "description": "The name for the venv in the sandbox directory. We first search for an existing venv with this name, otherwise, we make it from the requirements.txt.",
+      "default": "venv"
+    },
+    "pip_requirements": {
+      "items": {
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "title": "Name",
+            "description": "Name of the pip package."
+          },
+          "version": {
+            "anyOf": [{ "type": "string" }, { "type": "null" }],
+            "title": "Version",
+            "description": "Optional version of the package, following semantic versioning."
+          }
+        },
+        "type": "object",
+        "required": ["name"],
+        "title": "PipRequirement",
+        "x-readme-ref-name": "PipRequirement"
+      },
+      "type": "array",
+      "title": "Pip Requirements",
+      "description": "List of pip packages to install with mandatory name and optional version following semantic versioning. This only is considered when use_venv is True."
+    }
+  },
+  "type": "object",
+  "title": "LocalSandboxConfig",
+  "x-readme-ref-name": "LocalSandboxConfig"
+}

package/src/schemas/managerType.json

@@ -0,0 +1,6 @@
+{
+  "type": "string",
+  "enum": ["round_robin", "supervisor", "dynamic", "sleeptime", "swarm"],
+  "title": "ManagerType",
+  "x-readme-ref-name": "ManagerType"
+}

package/src/schemas/maxCountPerStepToolRule.json

@@ -0,0 +1,26 @@
+{
+  "properties": {
+    "tool_name": {
+      "type": "string",
+      "title": "Tool Name",
+      "description": "The name of the tool. Must exist in the database for the user's organization."
+    },
+    "type": {
+      "type": "string",
+      "const": "max_count_per_step",
+      "title": "Type",
+      "default": "max_count_per_step"
+    },
+    "max_count_limit": {
+      "type": "integer",
+      "title": "Max Count Limit",
+      "description": "The max limit for the total number of times this tool can be invoked in a single step."
+    }
+  },
+  "additionalProperties": false,
+  "type": "object",
+  "required": ["tool_name", "max_count_limit"],
+  "title": "MaxCountPerStepToolRule",
+  "description": "Represents a tool rule configuration which constrains the total number of times this tool can be invoked in a single step.",
+  "x-readme-ref-name": "MaxCountPerStepToolRule"
+}

package/src/schemas/maxCountPerStepToolRuleSchema.json

@@ -0,0 +1,11 @@
+{
+  "properties": {
+    "tool_name": { "type": "string", "title": "Tool Name" },
+    "type": { "type": "string", "title": "Type" },
+    "max_count_limit": { "type": "integer", "title": "Max Count Limit" }
+  },
+  "type": "object",
+  "required": ["tool_name", "type", "max_count_limit"],
+  "title": "MaxCountPerStepToolRuleSchema",
+  "x-readme-ref-name": "MaxCountPerStepToolRuleSchema"
+}

package/src/schemas/memory.json

@@ -0,0 +1,87 @@
+{
+  "properties": {
+    "blocks": {
+      "items": {
+        "properties": {
+          "value": {
+            "type": "string",
+            "title": "Value",
+            "description": "Value of the block."
+          },
+          "limit": {
+            "type": "integer",
+            "title": "Limit",
+            "description": "Character limit of the block.",
+            "default": 5000
+          },
+          "name": {
+            "anyOf": [{ "type": "string" }, { "type": "null" }],
+            "title": "Name",
+            "description": "Name of the block if it is a template."
+          },
+          "is_template": {
+            "type": "boolean",
+            "title": "Is Template",
+            "description": "Whether the block is a template (e.g. saved human/persona options).",
+            "default": false
+          },
+          "label": {
+            "anyOf": [{ "type": "string" }, { "type": "null" }],
+            "title": "Label",
+            "description": "Label of the block (e.g. 'human', 'persona') in the context window."
+          },
+          "description": {
+            "anyOf": [{ "type": "string" }, { "type": "null" }],
+            "title": "Description",
+            "description": "Description of the block."
+          },
+          "metadata": {
+            "anyOf": [
+              { "additionalProperties": true, "type": "object" },
+              { "type": "null" }
+            ],
+            "title": "Metadata",
+            "description": "Metadata of the block.",
+            "default": {}
+          },
+          "id": {
+            "type": "string",
+            "pattern": "^block-[a-fA-F0-9]{8}",
+            "title": "Id",
+            "description": "The human-friendly ID of the Block",
+            "examples": ["block-123e4567-e89b-12d3-a456-426614174000"]
+          },
+          "created_by_id": {
+            "anyOf": [{ "type": "string" }, { "type": "null" }],
+            "title": "Created By Id",
+            "description": "The id of the user that made this Block."
+          },
+          "last_updated_by_id": {
+            "anyOf": [{ "type": "string" }, { "type": "null" }],
+            "title": "Last Updated By Id",
+            "description": "The id of the user that last updated this Block."
+          }
+        },
+        "type": "object",
+        "required": ["value"],
+        "title": "Block",
+        "description": "A Block represents a reserved section of the LLM's context window which is editable. `Block` objects contained in the `Memory` object, which is able to edit the Block values.\n\nParameters:\n    label (str): The label of the block (e.g. 'human', 'persona'). This defines a category for the block.\n    value (str): The value of the block. This is the string that is represented in the context window.\n    limit (int): The character limit of the block.\n    is_template (bool): Whether the block is a template (e.g. saved human/persona options). Non-template blocks are not stored in the database and are ephemeral, while templated blocks are stored in the database.\n    label (str): The label of the block (e.g. 'human', 'persona'). This defines a category for the block.\n    template_name (str): The name of the block template (if it is a template).\n    description (str): Description of the block.\n    metadata (Dict): Metadata of the block.\n    user_id (str): The unique identifier of the user associated with the block.",
+        "x-readme-ref-name": "Block"
+      },
+      "type": "array",
+      "title": "Blocks",
+      "description": "Memory blocks contained in the agent's in-context memory"
+    },
+    "prompt_template": {
+      "type": "string",
+      "title": "Prompt Template",
+      "description": "Jinja2 template for compiling memory blocks into a prompt string",
+      "default": "{% for block in blocks %}<{{ block.label }} characters=\"{{ block.value|length }}/{{ block.limit }}\">\n{{ block.value }}\n</{{ block.label }}>{% if not loop.last %}\n{% endif %}{% endfor %}"
+    }
+  },
+  "type": "object",
+  "required": ["blocks"],
+  "title": "Memory",
+  "description": "Represents the in-context memory (i.e. Core memory) of the agent. This includes both the `Block` objects (labelled by sections), as well as tools to edit the blocks.",
+  "x-readme-ref-name": "Memory"
+}

package/src/schemas/message.json

@@ -0,0 +1,336 @@
+{
+  "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"
+}